ReactNative 埋点 SDK

GrowingIO 埋点 SDK 仅自动采集设备信息和您埋点内容数据,如果想自动采集用户点击事件或者页面访问事件等, 请集成 ReactNative 无埋点 SDK。

Android 集成

1. 添加 Android 埋点 SDK 依赖

  • 建议使用 Android Studio 打开项目中的android文件夹

  • React Native 埋点 SDK 是在 Android 原生 SDK 上的扩展,参照 Android 埋点 SDK,集成步骤的 1~4.

集成步骤中,只有版本号不同,适配 RN 与原生混合开发场景。

配置示例:

将版本号更改为RN-track-2.8.0

apply plugin: 'com.android.application'
android {
    defaultConfig {
        resValue("string", "growingio_project_id", "您的项目ID")
        resValue("string", "growingio_url_scheme", "您的URL Scheme")
    }
}
dependencies {
    //GrowingIO RN 埋点 SDK
    implementation 'com.growingio.android:vds-android-agent:RN-track-2.8.7'
}

2. 重要配置项

由于 SDK 需要在java代码中进行初始化。

在项目的Application中,添加GrowingIOPackage

public class MainApplication extends Application implements ReactApplication {
    @Override
    protected List<ReactPackage> getPackages() {
      return Arrays.<ReactPackage>asList(
          new MainReactPackage(), 
          // 此处加入GrowingIOPackage
          new GrowingIOPackage()
      );
    }
}

iOS 集成

1. 添加 iOS 埋点 SDK 依赖

React Native 埋点 SDK 是在 iOS 原生 SDK 上的扩展,请参照 iOS 埋点 SDK 集成步骤 1~3 ,操作完全一致。

2. 集成 React Native 打点 SDK

npm install --save https://github.com/growingio/react-native-growingio.git#0.0.7
react-native link react-native-growingio 

如果react-native link react-native-growingio失败

(成功则忽略此步骤),即发现Libraries中没有GrowingIORNPlugin.xcodeproj,则可手动配置:

  1. 打开 XCode 工程中, 右键点击 Libraries 文件夹 ➜ Add Files to <...>

  2. node_modules react-native-growingio ➜ iOS ➜ 选择 GrowingIORNPlugin.xcodeproj

  3. 在工程Build PhasesLink Binary With Libraries中添加libGrowingIORNPlugin.a

3. 重要配置

与原生混合开发的开发者可详细查看 iOS 无埋点 重要配置文档,如果原生控件使用不多,只需关注如下配置即可:

自定义事件和变量API

同 React Native 无埋点版本的 API 。

验证 SDK 是否正常工作

验证内容:

  1. 验证打点事件是否发送

验证工具:

  1. Android 查看日志: 设置 TestMode 和 Debug Mode :

GrowingIO.startWithConfiguration(this,new Configuration()
    //BuildConfig.DEBUG 这样配置就不会上线忘记关闭
    .setDebugMode(BuildConfig.DEBUG)
    .setTestMode(true)
    ...
    );

3. iOS 查看日志:iOS 在 AppDelegate 文件中配置:

[Growing setEnableLog:YES];

Last updated