GrowingIO React Native SDK Reference

一、说明

react-native-growingio 用于RN开发者手动发送数据。

二、引入

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

iOS

• 使用CocoaPods安装GrowingCoreKit ( pod 'GrowingCoreKit' in your Podfile and run pod update)
• (optional) GrowingIO推荐您添加AdSupport.framework依赖库,用于来源管理激活匹配,有利于您更好的分析的数据,
  添加项目依赖库的位置在项目设置target -> 选项卡General -> Linked Frameworks and Libraries

三、配置

iOS

• 如果react-native link react-native-growingio失败(成功则忽略此步骤),即发现Libraries中没有GrowingIORNPlugin.xcodeproj,则可手动配置; a.打开XCode's工程中, 右键点击Libraries文件夹 ➜ Add Files to <...> b.去node_modules ➜ react-native-growingio ➜ ios ➜ 选择 GrowingIORNPlugin.xcodeproj c.在工程Build Phases ➜ Link Binary With Libraries中添加libGrowingIORNPlugin.a

• 添加初始化函数: 在 AppDelegate 中引入#import "Growing.h"并添加启动方法

    - (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
        ...
        // 启动GrowingIO
        [Growing startWithAccountId:@"项目ID"];
  
        // 其他配置
        // 开启Growing调试日志 可以开启日志
        // [Growing setEnableLog:YES];
    }

• 添加官网配置, 需要重构后的文档

四、方法说明

| 方法名 | 参数 | 说明| |:-----:|-----|:-------:| | track|(String eventId, Object eventLevelVariable(optional))| 自定义事件（计数器类型）| | trackWithNumber|(String eventId, Number number, Object eventLevelVariable(optional))| 自定义事件（数值类型）| | setUserId | (String userId)| 设置登录用户ID | | clearUserId | | 清除登录用户ID | | setEvar | (Object conversionVariables) | 设置转化变量 | | setPeopleVariable | (Object peopleVariables)| 设置用户变量 | | setVisitor | (Object visitor)| 设置访问用户变量 |

五、JS中调用方式：

• 在定义Component之前引入

    import {
      NativeModules
    } from 'react-native';

• 之后就可以使用GrowingIO的方法,例如在js中调用自定义事件方法：

    NativeModules.GrowingIO.track("registerSuccess", {"gender":"male"});

Tips

1. demo 可见 examples/App.js