# @formbricks/react-native 中文文档

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

版本：3\.3\.1
npm 元数据更新时间：2026-11-13T07:30:05.723Z
中文译文更新时间：2026-11-15T08:35:37.778Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：365 kB，75 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：react \>=16\.8\.0，react-native \>=0\.60\.0，react-native-webview \>=13\.0\.0，@react-native-async-storage/async-storage \>=2\.1\.0
- 首次发布：2024-08-14T12:34:55.483Z
- 最新版本发布：2026-11-13T07:30:05.287Z
- 近 30 天下载量：2390（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：26（近 12 个月 9 个）

## 中文简介

Formbricks React Introduct SDK允许您将您的应用程序连接到Formbricks,显示调查并触发事件.

## 安装

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

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

## README

# Formbricks 反应原生 SDK

[![npm package](https://img.shields.io/npm/v/@formbricks/react-native?style=flat-square)](https://www.npmjs.com/package/@formbricks/react-native) [![MIT License](https://img.shields.io/badge/License-MIT-red.svg?style=flat-square)](https://opensource.org/licenses/MIT)

请看 [窗体砖](https://formbricks.com/docs)。 。 。 . 具体来说, [框架指南](https://formbricks.com/docs/xm-and-surveys/surveys/website-app-surveys/framework-guides)。 。 。 .

## 什么是福布瑞克斯吗

Formbricks是你的解决方案 对于产品内部的微观调查, 将会超额增加你的产品体验! 🚀 详情请查看 [formbricks.com (英语)](https://formbricks.com/)。 。 。 .

## 如何使用此库

1.  在您的工程中使用 npm 安装 Formbricks 包 :

```bash
npm install @formbricks/react-native
```

1.  导入窗体并初始化您主组件中的部件( 例如 App. tsx 或 App.js) :

```javascript
import Formbricks, { track } from "@formbricks/react-native";

export default function App() {
  return (
    <View>
      {/* Your app code */}
      <Formbricks
        appUrl="https://app.formbricks.com"
        workspaceId="your-workspace-id"
      />
    </View>
  );
}
```

将工作空间标识替换为工作空间标识。 您可以在 **连接指令** 在窗体砖中 **配置** 页面.

> **说明:** 这个 `environmentId` 道具仍作为后相兼容的别名支持 `workspaceId`,但它已经贬值,并将在未来的重大发行中被移除. 应使用新的整合 `workspaceId`。 。 。 .

关于不同框架的更详细指南,请检查我们 [框架指南](https://formbricks.com/docs/getting-started/framework-guides)。 。 。 .

## 黑暗模式

调查默认是光明的。 打电话 `setAppearance` 改为:

```ts
import { setAppearance } from "@formbricks/react-native";

setAppearance("dark"); // "light" | "dark" | "system"
```

-   工作前后 `setup()`,或通过 `appearance` 输入 `setup()` 相会.
-   开口调查开关到位;打入的答案和当前问题停留.
-   `"system"` 如下 **你的应用程序** 主题(`Appearance.getColorScheme()`,包括: `Appearance.setColorScheme`),而不是手机,并更新直播. 如果你的应用只保留主题 在JS,打电话 `setAppearance("light" | "dark")` 当它改变的时候,你自己.
-   站过去 `logout()`,应用程序重新启动时被遗忘,从未发送到服务器. 未知值记录出错并倒回光中 .
-   需要一个支持暗模式的Formbricks服务器;一个更古老的服务器会保持对光的调查.

在Formbricks中配置的自定义 CSS 不需要SDK呼叫;它随工作空间状态而来.

## 常见问题

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

Formbricks React Introduct SDK允许您将您的应用程序连接到Formbricks,显示调查并触发事件\.

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

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

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

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

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

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

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

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

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

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

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

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