# @flarelane/react-native-sdk 中文文档

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

版本：1\.12\.0
npm 元数据更新时间：2026-11-12T10:42:48.850Z
中文译文更新时间：2026-11-15T04:55:57.214Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：211 kB，72 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：react \*，react-native \*，react-native-webview \>=11\.0\.0 \<14\.0\.0
- 首次发布：2021-10-08T06:14:45.057Z
- 最新版本发布：2026-11-12T10:42:48.556Z
- 近 30 天下载量：2099（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：39（近 12 个月 7 个）

## 中文简介

FlareLane 反应- 内在 SDK

## 安装

```sh
npm install @flarelane/react-native-sdk
```

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

## README

# 反应-内生-氟烷

欢迎光临 [灯光](https://flarelane.com/)来啊!

## 安装

```sh
npm install @flarelane/react-native-sdk
```

## 地区

`FlareLane.initialize(projectId, requestPermissionOnLaunch = true, region?)`

项目在一个地区实施。 奥米 `region` 默认 `"us"`; 项目 在首尔地区创建的通行证 `"kr"`数字 :

```ts
FlareLane.initialize('YOUR_PROJECT_ID', true, 'kr');
```

本地 SDK 验证值: 区域错误日志出错和 停止初始化,而不是返回到 `"us"`。 。 。 .

## WebView 桥 (hybrid apps) (中文(简体) )

用于嵌入运行 FlareLane Web SDK 的网页的应用程序,本地SDK 暴露了一座桥的特性`deviceId` 编号 : `userId` 编号 : `projectId`和 SDK电话(`setUserId`, (中文(简体) ), `setTags`, (中文(简体) ), `trackEvent`, (中文(简体) ), `setUserAttributes`, (中文(简体) ), `syncDeviceData`在本地和网络之间保持一致.

桥名和类名与本地的Android/iOS SDK相匹配: `FlareLaneJavascriptInterface` + 键 `BRIDGE_NAME`.RN 载运一库名 显示成员1:1的适配器 `react-native-webview`的道具和 回调空档 — 把它们丢入您现有的 `<WebView>` 接线.

### 反应-本地-网络视图

```tsx
import { WebView } from 'react-native-webview';
import { FlareLaneJavascriptInterface } from '@flarelane/react-native-sdk/adapters/react-native-webview';

const webViewRef = useRef<WebView>(null);

// `injectedJavaScript` and `injectedJavaScriptBeforeContentLoaded` carry the
// same string, so one variable can be reused across both slots. If you don't
// have existing injection, drop the `myExistingInjection +` part.
const injection =
  myExistingInjection + FlareLaneJavascriptInterface.injectedJavaScript;

<WebView
  ref={webViewRef}
  source={{ uri }}
  injectedJavaScript={injection}
  injectedJavaScriptBeforeContentLoaded={injection}
  onMessage={FlareLaneJavascriptInterface.onMessage(webViewRef)}
/>
```

如果你已经有一个 `onMessage` 处理器,将适配器包入其中:

```tsx
onMessage={async (event) => {
  await FlareLaneJavascriptInterface.onMessage(webViewRef)(event);
  myExistingOnMessage(event);
}}
```

适配器曝光:

-   `FlareLaneJavascriptInterface.BRIDGE_NAME` ——频道名称常数.
-   `FlareLaneJavascriptInterface.injectedJavaScript` ——联署材料注入. 包括 页:1 `react-native-webview` 频道适配器和桥shim。 一样 字符串对两者都有效 `injectedJavaScript` 财务报告和审定财务报表 `injectedJavaScriptBeforeContentLoaded` 插槽 .
-   `FlareLaneJavascriptInterface.onMessage(webViewRef)` 工厂 返回处理器 `<WebView onMessage={…}>`。参考文献用于 联合材料(如: `syncDeviceData` 调回) 网络视图.

### 其他网页视图软件包

这个SDK只装了一级适配器 `react-native-webview`。如果 使用不同的网页视图库, 移植适配器执行 (单位:千美元)`src/adapters/react-native-webview.ts`)到你的图书馆的槽名—— JS注射和消息的通路逻辑在文件内部是自成一体的.

### 页:1

-   注射的联署材料具有专有能力——可以安全注射两次.
-   弹出 _在此之前_ web SDK 负载. `injectedJavaScriptBeforeContentLoaded` 在 iOS 上工作; Android 返回 `injectedJavaScript` (后载. 无论是哪种方式,SDK注射被看守 所以多次注射是安全的. 特别是Android, 避免装入 Web SDK 作为内置同步 `<script>` 在最顶端 `<head>`,可以在 倒灌地.
-   `setUserAttributes` 可在Android、iOS、Flustter和React上查阅 具有一致语义的原生SDK.

## 许可证

麻省理工学院

## 常见问题

### @flarelane/react-native-sdk 是什么？

FlareLane 反应- 内在 SDK

### 如何安装 @flarelane/react-native-sdk？

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

### @flarelane/react-native-sdk 支持 TypeScript 吗？

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

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

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

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

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

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

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

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

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