SDK 配置
HarmonyOS SDK 接入流程主要分为两个步骤(两个文档):
1、SDK配置:将对应的SDK集成到您的产品项目中,然后进行初始化代码处理;
2、SDK接入:将需要埋点的数据,按照SDK包装不同的方法进行数据上送,其中功能主要包含两大类:全埋点(自动采集数据上送)、自定义埋点(手动设置业务数据上送)。
注意:
- 鸿蒙NEXT API12 以上,仅支持普通应用stage模式,暂不支持元服务;
1. 集成说明(内测中)
说明:目前仅提供离线包方式集成;(详见官方引入引用本地HAR)
1、下载离线包 hinadt.har 文件;
2、拷贝到需要引入三方包的模块目录下,示例目录:项目根目录/entry/path/hinadt.har
3、在需要引入三方包的模块的 oh-package.json5 中设置本地 HAR 包。以 HAR 包在工程根目录下为例,配置示例如下(实际配置时请以 HAR 包实际目录为准):
"dependencies": {
"hinadt": "file:path/hinadt.har" // 此处也可以是以当前oh-package.json5所在目录为起点的相对路径。
}
4、依赖设置完成后,需要执行ohpm install命令安装依赖包,依赖包会安装在该模块的oh_modules目录下。
ohpm install
2. 权限说明
在模块的module.json5文件中添加权限声明:
"requestPermissions": [
{
"name": "ohos.permission.INTERNET"
},
{
"name": "ohos.permission.GET_NETWORK_INFO"
}
]
3. 初始化 SDK
3.1 AbilityStage文件创建指引
DevEco Studio默认工程中未自动生成AbilityStage,手动新建一个AbilityStage文件,步骤如下:
1、在工程Module对应的ets目录下,新建目录abilitystage,目录名字可以自定义;
2、在abilitystage目录,右键选择“New > ArkTS File”,新建一个文件并命名为MyAbilityStage.ets。
3、打开MyAbilityStage.ets文件,导入AbilityStage的依赖包,自定义类继承AbilityStage并加上需要的生命周期回调,示例中增加了一个onCreate()生命周期回调。
import { AbilityStage, Want } from '@kit.AbilityKit';
export default class MyAbilityStage extends AbilityStage {
onCreate(): void {
// 应用的HAP在首次加载的时,为该Module初始化操作
}
onAcceptWant(want: Want): string {
// 仅UIAbility配置未specified启动模式时触发
return 'MyAbilityStage';
}
}
4、在module.json5配置文件中,通过配置 srcEntry 参数来指定模块对应的代码路径,以作为HAP加载的入口。
{
"module": {
"name": "entry",
"type": "entry",
"srcEntry": "./ets/abilitystage/MyAbilityStage.ets",
...
}
}
3.2 初始化SDK
在模块的AbilityStage的onCreate()方法中初始化SDK:
import { AbilityStage, Want } from '@kit.AbilityKit';
import { HinaCloudSDK, HinaConfig } from 'hinadt';
export default class MyAbilityStage extends AbilityStage {
onCreate(): void {
// 应用的HAP在首次加载的时,为该Module初始化操作
// 初始化海纳嗨数SDK
let config: HinaConfig = new HinaConfig('数据接收地址');
config.enableLog(true);//是否开启日志,建议调试时打开;
HinaCloudSDK.init(this.context.getApplicationContext(), config);
}
}
注意:
1、采集上报地址URL获取方式,请参考【采集上报地址获取】;
2、更多初始化配置,请参考【SDK接入】;
最后编辑:王建华 更新时间:2024-11-12 17:12