# @getdevteam/analytics-react-native 中文文档

规范地址：https://npmcn.com/package/%40getdevteam/analytics-react-native/

版本：0\.13\.0
npm 元数据更新时间：2026-11-12T20:50:19.735Z
中文译文更新时间：2026-11-16T06:02:27.812Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40getdevteam/analytics-react-native
原文对照：https://npmcn.com/package/%40getdevteam/analytics-react-native/?lang=original
项目主页：https://github.com/getdevteam-ai/analytics#readme
源码仓库：https://github.com/getdevteam-ai/analytics

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：339 kB，8 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：react \>=18，expo-sensors \>=12，react-native \>=0\.72，expo-application \>=5，react-native-svg \>=13，expo-image-picker \>=14，react-native-view-shot \>=3，@react-native-async-storage/async-storage \>=1\.19\.0
- 首次发布：2026-07-05T14:58:23.569Z
- 最新版本发布：2026-11-12T20:50:19.382Z
- 近 30 天下载量：50042（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 21 个）

## 中文简介

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

## 安装

```sh
npm install @getdevteam/analytics-react-native
```

也可以使用：`pnpm add @getdevteam/analytics-react-native`、`yarn add @getdevteam/analytics-react-native`、`bun add @getdevteam/analytics-react-native`

## README

# @getdevteam/分析-反应-内在

反应原生/ Expo SDK 用于 [DevTeam 分析与日志平台](https://github.com/getdevteam-ai/analytics)。 。 。 .

## 安装

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

## 使用

```ts
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` 从您的应用程序代码 :

```ts
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` 鼠标. 见 [释放身份](https://github.com/getdevteam-ai/analytics/tree/main/src/sdk#release-identity) 和合成交通旗.

## 用户反馈

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

```tsx
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 读取](https://npmcn.com/package/README.md#bot-check)(三); `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` - 看见没 [只有登录用户](https://npmcn.com/package/README.md#only-signed-in-users)。 。 。 .

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

| 已安装 | 行为 |
| --- | --- |
| `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 - 见 [获取密钥](https://github.com/getdevteam-ai/analytics/tree/main/src/sdk#getting-a-key) 在完整的SDK文档.

完整客户端 API, 配置选项, 以及发布进程 : [弧/斯德克读取](https://github.com/getdevteam-ai/analytics/tree/main/src/sdk)。 。 。 .

## 常见问题

### @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 和提交记录判断。

