@flarelane/react-native-sdk

中文文档
1.12.0发布于 2026/11/12MITTypeScriptESM + CJS零依赖近 30 天下载 2099

FlareLane 反应- 内在 SDK

中文使用文档
文档目录7 节
  1. 安装
  2. 地区
  3. WebView 桥 (hybrid apps) (中文(简体) )
  4. 反应-本地-网络视图
  5. 其他网页视图软件包
  6. 页:1
  7. 许可证

反应-内生-氟烷

欢迎光临 灯光来啊!

安装

npm install @flarelane/react-native-sdk

地区

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

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

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> 接线.

反应-本地-网络视图

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 处理器,将适配器包入其中:

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 共发布 39 个版本,首次发布于 2021/10/08;过去 12 个月发布了 7 个版本。

版本发布日期距今
1.12.0latest2026/11/123 天前
1.11.32026/09/221 个月前
1.11.22026/08/282 个月前
1.10.22026/08/063 个月前
1.10.02026/06/085 个月前
1.9.42026/05/185 个月前

其他发布通道:next → 1.8.0-1。

关于 @flarelane/react-native-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 和提交记录判断。