harmony 鸿蒙@ohos.app.ability.abilityDelegatorRegistry (AbilityDelegatorRegistry)

  • 2025-06-16
  • 浏览 (2)

@ohos.app.ability.abilityDelegatorRegistry (AbilityDelegatorRegistry)

AbilityDelegatorRegistry是自动化测试框架使用指南模块,该模块用于获取AbilityDelegatorAbilityDelegatorArgs对象,其中AbilityDelegator对象提供添加用于监视指定ability的生命周期状态更改的AbilityMonitor对象的能力,AbilityDelegatorArgs对象提供获取当前测试参数的能力。

说明:

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

本模块接口仅可在自动化测试框架arkxtest中使用。

导入模块

import { abilityDelegatorRegistry } from '@kit.TestKit';

AbilityLifecycleState

Ability生命周期状态,该类型为枚举,可配合AbilityDelegatorgetAbilityState(ability)方法返回不同ability生命周期。

原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。

系统能力 :以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core

名称 说明
UNINITIALIZED 0 表示Ability处于无效状态。
CREATE 1 表示Ability处于已创建状态。
FOREGROUND 2 表示Ability处于前台状态。
BACKGROUND 3 表示Ability处于后台状态。
DESTROY 4 表示Ability处于已销毁状态。

abilityDelegatorRegistry.getAbilityDelegator

getAbilityDelegator(): AbilityDelegator

获取应用程序的AbilityDelegator对象,该对象能够使用调度测试框架的相关功能。

原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。

系统能力: SystemCapability.Ability.AbilityRuntime.Core

返回值:

类型 说明
AbilityDelegator AbilityDelegator对象。可以用来调度测试框架相关功能。

示例:

import { abilityDelegatorRegistry } from '@kit.TestKit';
import { Want } from '@kit.AbilityKit';

let abilityDelegator = abilityDelegatorRegistry.getAbilityDelegator();
let want: Want = {
  bundleName: 'com.example.myapplication',
  abilityName: 'EntryAbility'
};

abilityDelegator.startAbility(want, (err) => {
  if (err) {
    console.error(`Failed start ability, error: ${JSON.stringify(err)}`);
  } else {
    console.log('Success start ability.');
  }
});

abilityDelegatorRegistry.getArguments

getArguments(): AbilityDelegatorArgs

获取单元测试参数AbilityDelegatorArgs对象。

原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。

系统能力: SystemCapability.Ability.AbilityRuntime.Core

返回值:

类型 说明
AbilityDelegatorArgs AbilityDelegatorArgs对象。可以用来获取测试参数。

示例:

import { abilityDelegatorRegistry } from '@kit.TestKit';

let args = abilityDelegatorRegistry.getArguments();
console.info(`getArguments bundleName: ${args.bundleName}`);
console.info(`getArguments parameters: ${JSON.stringify(args.parameters)}`);
console.info(`getArguments testCaseNames: ${args.testCaseNames}`);
console.info(`getArguments testRunnerClassName: ${args.testRunnerClassName}`);

AbilityDelegator

type AbilityDelegator = _AbilityDelegator

AbilityDelegator模块。

原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。

系统能力: SystemCapability.Ability.AbilityRuntime.Core

类型 说明
_AbilityDelegator AbilityDelegator模块。

AbilityDelegatorArgs

type AbilityDelegatorArgs = _AbilityDelegatorArgs

AbilityDelegatorArgs模块。

原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。

系统能力: SystemCapability.Ability.AbilityRuntime.Core

类型 说明
_AbilityDelegatorArgs AbilityDelegatorArgs模块。

AbilityMonitor

type AbilityMonitor = _AbilityMonitor

AbilityMonitor模块。

原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。

系统能力: SystemCapability.Ability.AbilityRuntime.Core

类型 说明
_AbilityMonitor AbilityMonitor模块。

ShellCmdResult

type ShellCmdResult = _ShellCmdResult

ShellCmdResult模块。

原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。

系统能力: SystemCapability.Ability.AbilityRuntime.Core

类型 说明
_ShellCmdResult ShellCmdResult模块。

AbilityStageMonitor14+

type AbilityStageMonitor = _AbilityStageMonitor

AbilityStageMonitor模块。

原子化服务API: 从API version 14开始,该接口支持在原子化服务中使用。

系统能力: SystemCapability.Ability.AbilityRuntime.Core

类型 说明
_AbilityStageMonitor AbilityStageMonitor模块。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Test Kit(应用测试服务)

harmony 鸿蒙perftest错误码

harmony 鸿蒙uitest错误码

harmony 鸿蒙@ohos.application.abilityDelegatorRegistry (AbilityDelegatorRegistry)

harmony 鸿蒙@ohos.application.testRunner (TestRunner)

harmony 鸿蒙AbilityDelegator

harmony 鸿蒙AbilityDelegatorArgs

harmony 鸿蒙ShellCmdResult

harmony 鸿蒙@ohos.test.PerfTest

harmony 鸿蒙js-apis-uitest

0  赞