@getdevteam/analytics-react-native

中文文档
0.13.0发布于 2026/11/13MITTypeScriptESM + CJS近 30 天下载 5万

反应原生SDK用于DevTeam分析与伐木平台.

中文使用文档
文档目录5 节
  1. 安装
  2. 使用
  3. 错误
  4. 释放身份
  5. 用户反馈

@getdevteam/分析-反应-内在

反应原生/ Expo SDK 用于 DevTeam 分析与日志平台。 。 。 .

安装

npm install @getdevteam/analytics-react-native @react-native-async-storage/async-storage

使用

import { createAnalytics } from "@getdevteam/analytics-react-native";

const key = process.env.EXPO_PUBLIC_DEVTEAM_ANALYTICS_INGEST_KEY;
const host = process.env.EXPO_PUBLIC_DEVTEAM_ANALYTICS_HOST;
// A build without either stays inert instead of failing.
export const analytics = key && host ? createAnalytics({ key, host }) : undefined;

analytics?.screen("Home", { tab: "featured" });   // screen view
analytics?.track("add_to_cart", { sku: "A-1" });
analytics?.log.info("checkout started", { items: 3 });

赫拉的移动建筑集 EXPO_PUBLIC_DEVTEAM_ANALYTICS_INGEST_KEY 财务报告和审定财务报表 EXPO_PUBLIC_DEVTEAM_ANALYTICS_HOST 从建筑环境的分析值; 其它任何地方构建的应用程序( EAS, 本地建筑) 设置它们本身. 如上,将两个参考书写出字面意思: EXPO_PUBLIC_ 仅用于文字的变量 process.env.EXPO_PUBLIC_... 访问应用程序代码.

@react-native-async-storage/async-storage 是一个需要的对等点, 它能将身份保存在应用程序重新启动的整个过程中; 并同时安装 SDK . 应用到背景时SDK自动流出. 每个日志行和被捕获出错都带有最后传到的名称 screen() 联合国 screen 属性; 在应用程序报告屏幕之前, 没有发送 . 在物理设备上使用您的机器的局域网IP代替 localhost 当指向本地后端时.

错误

SDK从0. 0.0 报告应用程序没有捕获到的东西

  • 到达 React Index 的全局处理器的每个错误( )ErrorUtils) - 从事件处理器,计时器,本地召回和启动代码 - 有 is_fatal;应用程序的前一个处理器仍在报告后运行;
  • 在发布架构中,将一个致命错误的报告写入存储并发送到前一个处理器结束应用程序之前,最多等待一秒钟,在等待过程中产生的致命错误在没有第二份报告的情况下被移交; 开发时将每一个错误一次地交接;
  • 在赫尔墨斯,每一个无所事事的承诺拒绝, 只有在发展之外.

从 React 19 渲染时抛出一个错误到 React Introduct 而不通过它的全局处理器,所以将应用程序的根包入调用的错误边界 analytics.captureError(error, { source: "error_boundary" })。 。 。 . 每份报告都是作为 $error 事件和带有堆栈的错误日志. 打电话 analytics.captureError(error, attributes) 对于错误,应用程序捕获自己. 过 autoCaptureErrors: false 关闭自动抓取,例如当应用程序已经安装了通过 SDK 报告的全球处理器时. 赫尔墨斯保留了一款承诺拒绝追踪器,因此SDK的功能取代了之前安装的相接库,而后一款则取代了SDK的功能. JavaScript(贾瓦、克特林、斯威夫特或目标-C)以下的崩溃没有报告.

释放身份

编队集 DEVTEAM_RELEASE_VERSION 财务报告和审定财务报表 DEVTEAM_COMMIT_SHA 显示为 EXPO_PUBLIC_ 变量并传递到 release 从您的应用程序代码 :

const analytics = createAnalytics({
  key: "dtp_your_public_key",
  host: "https://ingest.analytics.getdevteam.ai",
  release: {
    version: process.env.EXPO_PUBLIC_DEVTEAM_RELEASE_VERSION,
    commit: process.env.EXPO_PUBLIC_DEVTEAM_COMMIT_SHA,
  },
});

写两个 process.env.EXPO_PUBLIC_... 引用字面上是这样的: 博览会只用应用程序代码, 从来不用内部 node_modules 绝不要为有算术或断章取义者而设. 无 release sDK会回到 globalThis.__DEVTEAM_RELEASE__,然后它自己的读取相同 EXPO_PUBLIC_ 变量(仅在SDK编译为应用代码时才找到值),然后 process.env.DEVTEAM_*,然后从可选的本地应用程序版本 expo-application 鼠标. 见 释放身份 和合成交通旗.

用户反馈

用 allowUserFeedback: true 并在导出提供者中包裹您的应用程序 :

import { createAnalytics, FeedbackProvider } from "@getdevteam/analytics-react-native";

const analytics = createAnalytics({
  key: "dtp_your_public_key",
  host: "https://ingest.analytics.getdevteam.ai",
  allowUserFeedback: true,
});

export default function App() {
  return (
    <FeedbackProvider client={analytics}>
      <RootNavigator />
    </FeedbackProvider>
  );
}

浮动按钮打开一个模式,其中包含应用程序的截图,绘图工具和评论框;提交到平台的反馈收件箱. analytics.submitFeedback({ text, screenshot?, screenshotContentType?, pageUrl?, attachments?, feedbackId?, formOpenMs? }) 发送方案反馈并解决问题 false 而不是放弃任何失败. 传出同样的 feedbackId 在重试同一草稿的发件时,所以其回复被丢失的发件只被存储一次;没有一次,每一次通话都会得到新鲜的id. formOpenMs 您的表格在发送前打开了多少毫秒, 时间与 performance.now(),正如模式所做的那样;服务标志的发送速度比一个人写作垃圾邮件要快,没有它的呼叫永远不会被检查所接获. 每个发送也会解决隐形机器人检查(参见 SDK 读取(三); analytics.prepareFeedbackSend() 开始时间, 模式打开时会这样做, 因此, 当形式出现时, 从您自己的形式发送的邮件可以称之为 . 超过5个小米B的截图被拒绝,就像在网络上一样. 该模式将自己的截图保留在该封顶下:一个超大小的PNG被重新抓取为JPEG,然后以0.7x大小直到符合,如果没有它,任何符合的反馈都会被发送. 自定义 feedback: { colors, accentColor, buttonLabel, title, submitLabel, commentPlaceholder, successMessage, position, iconButton, shakeToReport, shakeHint }。 。 。 . iconButton: { size: 46 } 将按钮画成圆形图标, 而不是文字药丸: 带有感叹标记的白话泡 accentColor。 。 。 . 虽然截图被捕获,但同一圈显示一个旋转者,报告忙于筛选读者,并忽略了进一步的压力,直到反馈表打开; buttonLabel (默认) Feedback)是屏幕读者宣布的. 这需要 react-native-svg pal;没有它,便会画出药丸,然后离开 iconButton 保留文本药丸. shakeToReport: true 在设备被摇动时打开工作表,没有浮动按钮,使用可选选项 expo-sensors 等同端的加速计(仅在应用程序在前面时读取,文本字段被聚焦时的摇动被忽略,因为iOS读取时是撤销的). 无 expo-sensors - 或者在添加前建立的应用程序二进制 - 或者在一个没有加速计的设备上,按钮会停留,被暗地里,可以被拖到屏幕的任何边缘,在那里它会被记住. shakeHint (默认) Shake your phone to send feedback) 显示并宣布每个设备,第一次摇动就是打开工作表的地方. 打电话 analytics.identify(user.id, { name: user.fullName }) 登录和会话恢复后, 反馈会说是谁发送的; 名称只包含反馈, 绝不包含事件或日志 reset() 在登录时忘记它. 如果项目只接受签名用户的反馈, 也可以通过您的服务器为此 id 所做的签名 : analytics.identify(user.id, { name: user.fullName }, { userSignature })。 。 。 . 如果没有一个按钮,则不显示 submitFeedback 发送什么,决心 false 并报告为什么 onError - 看见没 只有登录用户。 。 。 .

截图和画来自两个可选的同龄人

已安装行为
react-native-view-shot + 键 react-native-svg截图,绘图工具,评论.
react-native-view-shot 仅限屏幕截图 + 注释, 无绘图工具 .
也没有仅评论反馈.
应用不包在 FeedbackProvider,或旗下关闭没有按钮或模式 ; 包裹的应用程序会挂在两个全屏视图内, 所以打开或关闭旗子会保持状态 .

可选对等者装入文字 require 电话,每个在尝试/捕获, 在CJS建筑. Metro用CJS的软件包 react-native 导出条件, 无论是应用程序导入还是需要 SDK; 假设 Metro 保存 transformer.allowOptionalDependencies 启用( React Introduct 和 Expo 模板默认, 并且它只覆盖一个 try/ catch 中的字符串- literal 要求) , 因此缺失的可选端口不会失败捆绑 . 进口条件消费者(反应-本土-网络、节点无害环境管理)无法加载可选的同行,并降解为只提供评论的反馈. 本地视图(地图,视频,网络视图)可能在抓取中出现空白;一个失败的抓取会回到只评论.

你需要一个公开的摄入键( )dtp_...) 和您环境的摄入主机 URL - 见 获取密钥 在完整的SDK文档.

完整客户端 API, 配置选项, 以及发布进程 : 弧/斯德克读取。 。 。 .

版本与发布记录

@getdevteam/analytics-react-native 共发布 21 个版本,首次发布于 2026/07/05;过去 12 个月发布了 21 个版本。

版本发布日期距今
0.13.0latest2026/11/133 天前
0.12.02026/11/106 天前
0.11.02026/11/096 天前
0.10.02026/11/0313 天前
0.9.02026/11/0213 天前
0.8.32026/10/2917 天前

其他发布通道:dev → 0.1.0-dev.2。

关于 @getdevteam/analytics-react-native 的常见问题

@getdevteam/analytics-react-native 是什么?

反应原生SDK用于DevTeam分析与伐木平台.

如何安装 @getdevteam/analytics-react-native?

在项目目录运行 npm install @getdevteam/analytics-react-native,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=18)、react-native(>=0.72)、@react-native-async-storage/async-storage(>=1.19.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@getdevteam/analytics-react-native 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@getdevteam/analytics-react-native 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@getdevteam/analytics-react-native 可以商用吗?

@getdevteam/analytics-react-native 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@getdevteam/analytics-react-native 的下载量有多少?

根据 npm 官方下载统计,@getdevteam/analytics-react-native 在 2026/10/17 – 2026/11/15 这 30 天内被下载 50,042 次,日均约 1,668 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@getdevteam/analytics-react-native 还在维护吗?

最新版本 0.13.0 发布于 2026/11/13(3 天前);至今共发布 21 个版本,其中过去 12 个月发布了 21 个;首次发布于 2026/07/05。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。