HarmonyOS SDK 接入流程主要分为两个步骤(两个文档)

1、SDK配置:将对应的SDK集成到您的产品项目中,然后进行初始化代码处理;
2、SDK接入:将需要埋点的数据,按照SDK包装不同的方法进行数据上送,其中功能主要包含两大类:全埋点(自动采集数据上送)、自定义埋点(手动设置业务数据上送)。


注意:

  1. 鸿蒙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 09:49
最后编辑:王建华  更新时间:2024-11-20 17:38