鸿蒙5.0开发进阶：Stage模型-@ohos.app.appstartup.StartupTask

往期鸿蒙全套实战文章必看：（文中附带全栈鸿蒙学习资料）

• 鸿蒙开发核心知识点，看这篇文章就够了

• 最新版！鸿蒙HarmonyOS Next应用开发实战学习路线

• 鸿蒙HarmonyOS NEXT开发技术最全学习路线指南

• 鸿蒙应用开发实战项目，看这一篇文章就够了（部分项目附源码）

---

@ohos.app.appstartup.StartupTask

本模块提供启动任务的相关能力。

说明

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

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

导入模块

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

StartupTask.onDependencyCompleted

onDependencyCompleted?(dependency: string, result: ESObject): void

当依赖的启动任务执行完成时该方法将会被调用。

系统能力：以下各项对应的系统能力均为SystemCapability.Ability.AppStartup

参数：

参数名	类型	必填	说明
dependency	string	是	依赖的启动任务名称。
result	Object	是	依赖启动任务执行的结果。

示例：：

import StartupTask from '@ohos.app.appstartup.StartupTask';
import common from '@ohos.app.ability.common';
import hilog from '@ohos.hilog';

@Sendable
export default class StartupTask_001 extends StartupTask {
  constructor() {
    super();
  }
  async init(context: common.AbilityStageContext) {
    // ...
  }

  onDependencyCompleted(dependence: string, result: Object): void {
    hilog.info(0x0000, 'testTag', 'StartupTask_001 onDependencyCompleted, dependence: %{public}s, result: %{public}s',
      dependence, JSON.stringify(result));
    // ...
  }
}

StartupTask.init

init(context: AbilityStageContext): Promise<ESObject>

启动任务执行的初始化业务。

系统能力：以下各项对应的系统能力均为SystemCapability.Ability.AppStartup

参数：

参数名	类型	必填	说明
context	AbilityStageContext	是	AbilityStage的上下文环境

返回值：

类型	说明
Promise<Object	void>

示例：：

import { StartupTask, common } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

@Sendable
export default class StartupTask_001 extends StartupTask {
  constructor() {
    super();
  }
  async init(context: common.AbilityStageContext) {
    hilog.info(0x0000, 'testTag', 'StartupTask_001 init.');
    // ...
    
    return 'StartupTask_001';
  }

  onDependencyCompleted(dependence: string, result: Object): void {
    // ...
  }
}