harmony 鸿蒙@ohos.app.appstartup.StartupListener (启动框架任务监听器)

2025-06-12
浏览 (3)

@ohos.app.appstartup.StartupListener (启动框架任务监听器)

本模块提供监听启动任务的能力。

说明：

本模块首批接口从API version 12开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

本模块接口仅可在Stage模型下使用。

导入模块

import { StartupListener } from '@kit.AbilityKit';

StartupListener.onCompleted

onCompleted?(error: BusinessError<void>): void

在所有启动任务完成时调用。

系统能力：SystemCapability.Ability.AppStartup

参数：

参数名	类型	必填	说明
error	BusinessError	是	错误信息。

示例：

import { StartupConfig, StartupConfigEntry, StartupListener } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

export default class MyStartupConfigEntry extends StartupConfigEntry {
  onConfig() {
    hilog.info(0x0000, 'testTag', `onConfig`);
    let onCompletedCallback = (error: BusinessError<void>) => {
      hilog.info(0x0000, 'testTag', `onCompletedCallback`);
      if (error) {
        hilog.info(0x0000, 'testTag', 'onCompletedCallback: %{public}d, message: %{public}s', error.code, error.message);
      } else {
        hilog.info(0x0000, 'testTag', `onCompletedCallback: success.`);
      }
    }
    let startupListener: StartupListener = {
      'onCompleted': onCompletedCallback
    }
    let config: StartupConfig = {
      'timeoutMs': 10000,
      'startupListener': startupListener
    }
    return config;
  }
}