跳到主要内容

@ohos.app.appstartup.StartupTask (启动框架任务)

本模块提供应用启动框架任务的相关能力。

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

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

导入模块​

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

StartupTask​

该类提供启动任务的相关能力，使用@Sendable装饰器装饰。

装饰器类型：@Sendable

onDependencyCompleted​

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

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

系统能力：SystemCapability.Ability.AppStartup

参数：

参数名类型必填说明
dependencystring是依赖的启动任务名称。
resultObject是依赖的启动任务init返回的执行结果。

示例：

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) {
    // ...
  }

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

init​

init(context: AbilityStageContext): Promise<Object | void>

当所有依赖的启动任务都执行完成后，该方法将会被调用。开发者可以在该回调中执行该启动任务的初始化操作。使用Promise异步回调。

系统能力：SystemCapability.Ability.AppStartup

参数：

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

返回值：

类型说明
Promise<Objectvoid>

示例：

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(dependency: string, result: Object): void {
    // ...
  }
}