本文介绍Harmony SDK的详细接入步骤。接入SDK后,即可在应用性能监控全链路版平台上使用相关分析功能。
通过ohpm
安装APMPlus SDK。
ohpm i @volcengine/apmplus@2.0.4
entry/libs
目录下。oh-package.json5
文件中,添加离线har包依赖。"dependencies": { "@volcengine/apmplus": "file:./libs/apmplus.har" }
注意
初始化SDK阶段,不获取用户个人信息。
在AbilityStage或者Ability的onCreate生命周期中,添加以下代码。
APMPlus.init(this.context);
启动监控,开始收集数据。
注意
请在用户同意隐私政策后,再调用方法收集数据。
APMPlus.setDeviceId("device_id");//可选,设置设备device_id,不设置会使用内部默认device_id,更新值随时调用。 APMPlus.setUserId("user_id");//可选,用户标识,没有默认值,更新值随时调用。 let builder = new APMPlusBuilder("AppID", "AppToken");//必填 builder.debug = true;//可选,测试阶段配置有输出日志,线上release需关闭 builder.channel = "volcengine";//可选,类型string。渠道 builder.startMonitor = true;//可选,是否开启启动监控 builder.netMonitor = true;//可选,是否开启网络监控 后续需要使用HttpMonitor进行辅助监控 builder.versionCode = BuildProfile.VERSION_CODE;//可选,类型number。应用versionCode builder.versionName = BuildProfile.VERSION_NAME;//可选,类型string。应用versionName APMPlus.start(builder);
说明
AppID和AppToken获取方法,请参见如何查询AppID和AppToken?。
Har包为二进制abc格式。查看工程级build-profile.json5
,请设置useNormalizedOHMUrl
为true
。
{ "app": { "products": [ { "buildOption": { "strictMode": { "useNormalizedOHMUrl": true } } } ] } }
工程./hvigor/hvigor-config.json5
文件添加依赖。
"dependencies": { "apmplus_upload": 'latest', }
工程的hvigorfile.ts
添加以下代码。
import { ApmPlusPlugin } from 'apmplus_upload'; const config = { aid : 1234, // 应用的app id updateVersionCode : 1000000, // 应用的number类型的版本号version_code api_key : 4321,// 从平台的 全部功能->符号表管理->系统选择 Android->下面可以看到api key和api token。 api_token : 'xxxxxx'// 从平台的 全部功能->符号表管理->系统选择 Harmony->下面可以看到api key和api token }; export default { system: appTasks, plugins:[ApmPlusPlugin(config)] }