HarmonyOS SDK接入

前言

本SDK基于HarmonyOS API 12开发，compatibleSdkVersion为5.0.0(12)。

准备工作

1. 请参考HarmonyOS应用开发文档准备HarmonyOS应用开发环境。

2. 请参考Native应用创建鸿蒙应用，在应用设置中查看AppKey和AppSecret。

第一步：安装SDK

在HarmonyOS应用根目录执行以下命令来安装SDK：

ohpm install @aliyun/apm
ohpm install @aliyun/apm_perf

ohpm工具及更多关于OpenHarmony安装第三方SDK的信息请参考OpenHarmony三方库中心仓说明。

第二步：初始化SDK、启动性能分析

在Ability onCreate生命周期回调中执行以下代码初始化配置SDK：

import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';
import { APM, APMConfig, Logger } from '@aliyun/apm';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { performanceApi } from '@aliyun/apm_perf';

class MyCustomLog implements Logger {
  print(domain: number, tag: string, level: hilog.LogLevel, msg: string): void {
    switch (level) {
      case hilog.LogLevel.DEBUG:
        console.debug(`自定义log msg:${msg}`);
        break;
      case hilog.LogLevel.INFO:
        console.info(`自定义log msg:${msg}`);
        break;
      case hilog.LogLevel.WARN:
        console.warn(`自定义log msg:${msg}`);
        break;
      case hilog.LogLevel.ERROR:
      case hilog.LogLevel.FATAL:
        console.error(`自定义log msg:${msg}`);
        break;
    }
  }
}

export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');

    const apm_perf_config: APMConfig = {
      context: this.context,
      appKey: 'appKey参数',
      appSecret: 'appSecret参数',
      nick: '用户昵称参数',
      userId: '用户ID参数',
      channel: '用户渠道参数',
      hiLog: true, // SDK内的hilog开关
      customLogger: new MyCustomLog(), // 自定义日志接口
    }
    APM.init(apm_perf_config, [performanceApi])
    APM.start();

  }

  // 省略其它代码
}

其中appKey，appSecret请配置为在准备工作中获取的AppKey和AppSecret。

第三步：接入验证

SDK接入完成后，可以正常启动应用，进行一些页面跳转操作，然后将应用退到后台，等待3分钟后在控制台查看是否有应用数据。