火山引擎 RangersAppLog Cordova插件集成文档

在使用 RangersAppLog SDK 前，你需要先注册火山账号并且创建一个应用。

1. 在你的项目主目录里安装 Cordova 插件。

# install plugin
cordova plugin add cordova-plugin-rangersapplog

2. 安装依赖与SDK初始化

2.1. iOS

目前Cordova插件本身只是一个胶水文件，不携带SDK代码。所以需要您在XCode工程中安装SDK依赖。

火山引擎支持两种iOS SDK依赖方式：(1)通过cocoapods管理依赖 (2)手动添加静态库安卓依赖。在操作前，请确认您的 XCode 版本为11或以上版本。

具体集成方式和初始化内容和原生SDK一致，按官网上原生SDK的集成方法操作即可。 iOS客户端SDK接入说明

2.2. Android

与iOS类似，需要用户在Android Studio中安装SDK依赖。具体集成方式和初始化内容和原生SDK一致，按官网上原生SDK的集成方法操作即可。 Android客户端SDK接入说明

3. 插件接口文档

| 接口名 | 功能 | 参数 | 支持平台 | |----------------------------|-----------------------------------|-------------------------------------------------------------|--------------| | onEventV3 | 生成自定义埋点 | 参数1：string，非空。事件名。 参数2：字典，可空。事件参数。 | iOS, Android | | setHeaderInfo | 自定义header信息 设置用户公共属性 | 参数1：字典，可空。自定义header信息。 | iOS, Android | | setUserUniqueId | 设置用户登录 Id | 参数1：string，可空。user_unique_id。 | iOS, Android | | getAbSdkVersions | 获取全部客户端和服务端已曝光参数 | 参数：无 返回：str | iOS | | getABTestConfigValueForKey | 获取AB测试的配置，若不存在返回nil | 参数1: str, ABTest配置的key 返回：str或nil | iOS | | getDeviceID | 获取加密后的did | 参数：无 返回：str。 | iOS | | profileSet | 设置一组profile属性 | 参数1：字典，字典的值只能是以下类型：字符串、整型、浮点型、字符串数组 | iOS, Android | | profileSetOnce | 设置一组profile属性，若一个接口是通过重复调用该接口无效。unset后，无法再次通过setOnce设置 | 参数1：字典，字典的值只能是以下类型：字符串、整型、浮点型、字符串数组 | iOS, Android | | profileIncrement | 为数值类型的profile属性做自增操作 | 参数1：字典，字典的值只能是以下类型：整型 | iOS, Android | | profileAppend | 为数组类型的profile属性添加一个值 | 参数1：字典，字典的值只能为字符串或者字符串数组 | iOS, Android | | profileUnset | unset一个profile属性 | 参数1：string，非空。需要unset的profile的名称 | iOS, Android |

4. 关联的 sdk 版本

| 版本号 | SDK IOS版本 | SDK Android版本 | |-------|-------------|-----------------| | 2.2.0 | >= 6.6.0 | >= 6.7.0 |