一、前提条件
·版本要求:React Native >= 0.60,iOS >= 11。
·可选依赖:@react-native-async-storage/async-storage(>= 1.0.0),用于持久化 aid(设备唯一标识,用于区分设备、计算 uv);未安装时 SDK 自动降级为会话内不持久化的 aid。
二、步骤1:安装 SDK
1. 执行下列命令,在 npm 仓库安装 aegis-rn-sdk,依赖将写入项目根目录的 package.json:
npm install –save aegis-rn-sdk
2. SDK 内含原生模块(冷/热启动时间采集、首帧 onDraw 采集、帧率统计等能力),需随 App 原生工程一起构建:
·Android:自动链接(react-native.config.js 已配置 AegisPerfPackage),依赖位置为 android/ 原生工程,无需手动添加到 android/app/build.gradle。
·iOS:依赖位置为 ios/ 目录,执行 pod install 后通过 aegis-rn-sdk.podspec 自动集成,无需手动添加到 Podfile。
若自动链接失败,请参考 React Native 产品文档(Android 原生模块、iOS 原生模块)手动完成原生模块注册。
三、步骤2:初始化 SDK
参考下列步骤新建一个 Aegis 实例,传入相应的配置,初始化 SDK:
import Aegis from 'aegis-rn-sdk';const aegis = new Aegis({ id: 'pGUVFTCZyewhxxxxxx', // 应用ID,即上报ID uin: 'xxx', // 用户唯一 ID(可选) reportApiSpeed: true, // 接口测速 hostUrl: 'https://rumt-zh.com', // 上报域名,中国大陆 rumt-zh.com})
注意:说明: