# @fullstory/react-native 中文文档

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

版本：1\.10\.3
npm 元数据更新时间：2026-09-11T14:37:31.400Z
中文译文更新时间：2026-11-15T16:49:52.496Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：158 kB，80 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：expo \>=47\.0\.0，react \*，react-native \>=0\.83\.0
- 首次发布：2020-04-08T19:17:46.883Z
- 最新版本发布：2026-09-11T14:37:31.098Z
- 近 30 天下载量：332233（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：45（近 12 个月 8 个）

## 中文简介

正式的 FullStory 反应本地插件

## 安装

```sh
npm install @fullstory/react-native
```

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

## README

# Fullstory 反应原生插件

[![CircleCI](https://circleci.com/gh/fullstorydev/fullstory-react-native.svg?style=svg)](https://circleci.com/gh/fullstorydev/fullstory-react-native)

Fullstory的"回想原生"插件从回想原生应用程序内部暴露出进入"回想原生"的"回想原生"移动SDK. 此插件拟与 [移动应用程序全程](https://www.fullstory.com/mobile-apps/)。 。 。 .

## 快速链接

-   [全程 API](https://developer.fullstory.com/)
-   [获取启动指南](https://help.fullstory.com/hc/en-us/articles/360052419133)
-   [给我们发邮件](mailto:mobile-support@fullstory.com)

## 反应本地版本相容性

| React 本地版本 | `@fullstory/react-native` 版本 |
| --- | --- |
| `>=0.83.0` | `>=1.10.0` |
| `<=0.82.0` | `~1.9.0` |

## 安装本地反应插件

#### 以 npm 为单位

```
npm i @fullstory/react-native --save
```

#### 用纱线

```
yarn add @fullstory/react-native
```

#### 带有 expo- cli

```
expo install @fullstory/react-native
```

## 配置 Bail 插件

`@fullstory/babel-plugin-react-native` 自动包含为对 Fullstory React Native 插件的依赖。 请参考 Bail 插件 [读取](https://github.com/fullstorydev/fullstory-babel-plugin-react-native/blob/master/README.md) 用于了解如何配置.

`@fullstory/babel-plugin-annotate-react` 自动包含为对 Fullstory React Native 插件的依赖。 请参考 Bail 插件 [读取](https://github.com/fullstorydev/fullstory-babel-plugin-annotate-react/blob/master/README.md) 用于了解如何为 React Natural 配置.

## 导入 React 本地插件

为了从 React 原生应用程序内部使用 Fullstory 原生移动 SDK, 只需要导入 React 原生插件 .

### 导入示例

以下是一个将SDK导入回放原生应用程序的例子.

```JSX
import Fullstory from '@fullstory/react-native';
```

## 为博览配置

> 此软件包不能用于“ Expo Go” 应用程序, 因为 [它需要自定义本地代码](https://docs.expo.io/workflow/customizing/)。 。 。 .

将配置插件添加到您的插件阵列 `app.json` 或者说 `app.config.json`

```json
{
  "expo": {
    "plugins": [
      [
        "@fullstory/react-native",
        {
          "version": "1.28.0",
          "org": "ABC",
          "additionalConfigs": {
            "ios": {
              "PreviewMode": true
            },
            "android": {
              "previewModeEnabled": false
            }
          }
        }
      ]
    ]
  }
}
```

### 插件道具

插件允许通过通过带有属性的对象来进行额外的定制. 如果没有添加额外的属性,则使用默认值. **需要某些属性.**

| 财产 | 平台 | 需求 | 说明 |
| --- | --- | --- | --- |
| 版本 | Android & iOS 软件 | ✅ | Mobile Apps插件版本的完整故事. |
| 奥尔格 | Android & iOS 软件 | ✅ | 你的指定组织身份. |
| 东道主 | Android & iOS 软件 | 可选的 默认为: `fullstory.com` | 您的会话发送到服务器 URL . |
| 开始记录 | Android & iOS 软件 | 可选的 默认为: `true` | 启动记录 `false` 将阻止数据捕捉,直到您明确引用 `FS.restart()` API (英语). |
| 额外图形 | Android & iOS 软件 | 可选的 默认为: `nil` | 通过额外的配置到 [机器人](https://help.fullstory.com/hc/en-us/articles/360040596093-Getting-Started-with-Android-Data-Capture#01F5E7XFMG19SNYS77NYETKDMQ) 或者说 [iOS系统](https://help.fullstory.com/hc/en-us/articles/360042772333-Getting-Started-with-iOS-Data-Capture#01FX61TBJ8FAD9CWBMY31DWSTH)。 。 。 . |
| 启用变量 | 机器人 | 可选的 默认为: `release` | 指定应用 Fullstory 仪器的变体. |
| 日志级别 | 机器人 | 可选的 默认为: `info` | 获取指定级别或以上的日志语句. |
| 日志级 | 机器人 | 可选的 默认为: `off` | 在指定级别上或以上获取任何logcat消息. |
| 包括资产 | iOS系统 | 可选的 默认为: `nil` | 指定要上传用于播放的 Webview 文件类型。 如果您打算捕捉Web Views, 请强烈建议 . |
| 信息PlistPath 图像 | iOS系统 | 可选的 默认为: `nil` | 指定您信息. plist 文件的位置, 以防我们无法在应用程序包中自动找到它 。 建议值: `"${SRCROOT}/${INFOPLIST_FILE}"` |

## 常见问题

### @fullstory/react-native 是什么？

正式的 FullStory 反应本地插件

### 如何安装 @fullstory/react-native？

在项目目录运行 npm install @fullstory/react-native，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\*）、react-native（\>=0\.83\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @fullstory/react-native 支持 TypeScript 吗？

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

### @fullstory/react-native 支持 ESM 还是 CommonJS？

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

### @fullstory/react-native 可以商用吗？

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

### @fullstory/react-native 的下载量有多少？

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

### @fullstory/react-native 还在维护吗？

最新版本 1\.10\.3 发布于 2026/09/11（2 个月前）；至今共发布 45 个版本，其中过去 12 个月发布了 8 个；首次发布于 2020/04/09。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。