鸿蒙开发实战（5.0版）事件订阅＞订阅启动耗时事件（ArkTS）

鸿蒙HarmonyOS NEXT开发实战往期文章必看：（持续更新......）

HarmonyOS NEXT应用开发性能实践总结（持续更新......）

HarmonyOS NEXT应用开发案例实践总结合集（持续更新......）

一分钟了解”纯血版！鸿蒙HarmonyOS Next应用开发！

“非常详细的” 鸿蒙HarmonyOS Next应用开发学习路线！（从零基础入门到精通）

---

HiAppEvent提供接口用于订阅启动耗时事件。

• 订阅启动耗时事件（ArkTS）

启动耗时事件信息中params属性的详细描述如下：

params属性：

名称	类型	说明
time	number	事件生成时间，单位为毫秒。
bundle_version	string	应用版本。
bundle_name	string	应用名称。
process_name	string	应用进程名称。
start_type	number	冷热启动。0：冷启动，1：热启动。
icon_input_time	number	点击桌面应用图标离手时间，单位为毫秒。
animation_finish_time	number	动效完成耗时，单位为毫秒。
extend_time	number	开发者扩展接口调用完成耗时，单位为毫秒。

接口说明

API接口的具体使用说明（参数使用限制、具体取值范围等）请参考应用事件打点API文档。

接口名	描述
addWatcher(watcher: Watcher): AppEventPackageHolder	添加应用事件观察者，以添加对应用事件的订阅。
removeWatcher(watcher: Watcher): void	移除应用事件观察者，以移除对应用事件的订阅。

开发步骤

以实现对用户运行应用工程生成的启动耗时事件订阅为例，说明开发步骤。

1. 编辑工程中的“entry > src > main > ets > entryability > EntryAbility.ets”文件，在onCreate函数中添加系统事件的订阅，示例代码如下：

   import { hiAppEvent, hilog } from '@kit.PerformanceAnalysisKit';
   
   hiAppEvent.addWatcher({
      // 开发者可以自定义观察者名称，系统会使用名称来标识不同的观察者
      name: "watcher",
      // 开发者可以订阅感兴趣的系统事件，此处是订阅了启动耗时事件
      appEventFilters: [
        {
          domain: hiAppEvent.domain.OS,
          names: [hiAppEvent.event.APP_LAUNCH]
        }
      ],
      // 开发者可以自行实现订阅实时回调函数，以便对订阅获取到的事件数据进行自定义处理
      onReceive: (domain: string, appEventGroups: Array<hiAppEvent.AppEventGroup>) => {
        hilog.info(0x0000, 'testTag', `HiAppEvent onReceive: domain=${domain}`);
        for (const eventGroup of appEventGroups) {
          // 开发者可以根据事件集合中的事件名称区分不同的系统事件
          hilog.info(0x0000, 'testTag', `HiAppEvent eventName=${eventGroup.name}`);
          for (const eventInfo of eventGroup.appEventInfos) {
            // 开发者可以对事件集合中的事件数据进行自定义处理，此处是将事件数据打印在日志中
            hilog.info(0x0000, 'testTag', `HiAppEvent eventInfo=${JSON.stringify(eventInfo)}`);
          }
        }
      }
    });

2. 点击IDE界面中的运行按钮，运行应用工程，添加系统事件订阅者，退出应用，再次点击桌面应用图标，触发一次启动耗时事件。

3. 应用工程再次启动可以在Log窗口看到对系统事件数据的处理日志：

   HiAppEvent onReceive: domain=OS
   HiAppEvent eventName=APP_LAUNCH
   HiAppEvent eventInfo={"domain":"OS","name":"APP_LAUNCH","eventType":4,"params":{"animation_finish_time":662,"bundle_name":"com.example.myapplication","bundle_version":"1.0.0","extend_time":0,"icon_input_time":1709367533224,"process_name":"com.example.myapplication","start_type":0,"time":1709367533901}}