React Native 应用接入¶
通过收集 React Native 应用的指标数据,以可视化方式分析应用性能。
阅读路径¶
- 首次接入:先看 快速开始
- 完整接入:继续阅读本文
- 参数详解:查看 SDK 初始化、RUM 配置、Log 配置、Trace 配置
- 自定义能力:查看 自定义标签使用、数据采集自定义规则、数据采集脱敏
- 高级场景:查看“高级场景”分组下的专项页面
- 问题排查:查看 故障排查
前置条件¶
注意
若已开通 RUM Headless 服务,前置条件已自动配置,可直接接入应用。
- 安装 DataKit;
- 配置 RUM 采集器;
- DataKit 配置为公网可访问,并且安装 IP 地理信息库。
应用接入¶
注意
当前 React Native 版本暂只支持 Android 和 iOS 平台。
- 进入用户访问监测 > 新建应用 > React Native;
- 分别为 React Native Android 和 React Native iOS 创建两个应用,以便分别接收来自 Android 和 iOS 平台的 RUM 数据;
- 为每个平台的应用输入对应的应用名称和应用 ID;
-
选择应用接入方式:
- 公网 DataWay:直接接收 RUM 数据,无需安装 DataKit 采集器。
- 本地环境部署:满足前置条件后接收 RUM 数据。
安装¶
源码地址:https://github.com/GuanceCloud/datakit-react-native
Demo 地址:https://github.com/GuanceCloud/datakit-react-native/example
在项目路径下,终端运行命令:
这将在包的 package.json 中添加如下依赖:
Android 集成额外配置:
- 配置 Gradle Plugin ft-plugin,采集 App 启动事件和网络请求数据,以及 Android Native 原生相关事件(页面跳转、点击事件、Native 网络请求、WebView 数据)。
- 需要同时在 Gradle 中配置 观测云 Android Maven 仓库地址,Plugin 和 AAR 都需要,配置细节可参考 example 中的 build.gradle。
初始化说明¶
最小初始化示例请阅读 快速开始。
完整 FTMobileConfig 参数说明请阅读 SDK 初始化。