HarmonyOS API:通用能力的接口
版本:v3.1 Beta
@ohos.application.abilityDelegatorRegistry (AbilityDelegatorRegistry)
更新时间: 2023-02-17 09:19
AbilityDelegatorRegistry模块提供用于存储已注册的AbilityDelegator和AbilityDelegatorArgs对象的全局寄存器的能力,包括获取应用程序的AbilityDelegator对象、获取单元测试参数AbilityDelegatorArgs对象。
说明
本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
导入模块
import AbilityDelegatorRegistry from '@ohos.application.abilityDelegatorRegistry'
AbilityLifecycleState
Ability生命周期状态。
系统能力 :以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
名称 | 值 | 说明 |
UNINITIALIZED | 0 | 表示无效状态。 |
CREATE | 1 | 表示Ability处于已创建状态。 |
FOREGROUND | 2 | 表示Ability处于前台状态。 |
BACKGROUND | 3 | 表示Ability处于后台状态。 |
DESTROY | 4 | 表示Ability处于已销毁状态。 |
AbilityDelegatorRegistry.getAbilityDelegator
getAbilityDelegator(): AbilityDelegator
获取应用程序的AbilityDelegator对象
系统能力: SystemCapability.Ability.AbilityRuntime.Core
返回值:
类型 | 说明 |
AbilityDelegator对象。可以用来调度测试框架相关功能。 |
示例:
var abilityDelegator;
abilityDelegator = AbilityDelegatorRegistry.getAbilityDelegator();
AbilityDelegatorRegistry.getArguments
getArguments(): AbilityDelegatorArgs
获取单元测试参数AbilityDelegatorArgs对象
系统能力: SystemCapability.Ability.AbilityRuntime.Core
返回值:
类型 | 说明 |
AbilityDelegatorArgs对象。可以用来获取测试参数。 |
示例:
var args = AbilityDelegatorRegistry.getArguments();
console.info("getArguments bundleName:" + args.bundleName);
console.info("getArguments testCaseNames:" + args.testCaseNames);
console.info("getArguments testRunnerClassName:" + args.testRunnerClassName);
@ohos.application.appManager (appManager)
更新时间: 2023-02-17 09:19
appManager模块提供App管理的能力,包括查询当前是否处于稳定性测试场景、查询是否为ram受限设备、获取应用程序的内存大小、获取有关运行进程的信息等。
说明
本模块首批接口从API version 7 开始支持,从API version 9废弃,替换模块为@ohos.app.ability.appManager。后续版本的新增接口,采用上角标单独标记接口的起始版本。
导入模块
import app from '@ohos.application.appManager';
appManager.isRunningInStabilityTest8+
static isRunningInStabilityTest(callback: AsyncCallback<boolean>): void
查询当前是否处于稳定性测试场景。
系统能力:SystemCapability.Ability.AbilityRuntime.Core
参数:
参数名 | 类型 | 必填 | 说明 |
callback | AsyncCallback<boolean> | 是 | 返回当前是否处于稳定性测试场景。 |
示例:
import app from '@ohos.application.appManager';
app.isRunningInStabilityTest((err, flag) => {
console.log('startAbility result:' + JSON.stringify(err));
})
appManager.isRunningInStabilityTest8+
static isRunningInStabilityTest(): Promise<boolean>
查询当前是否处于稳定性测试场景。
系统能力:SystemCapability.Ability.AbilityRuntime.Core
返回值:
类型 | 说明 |
Promise<boolean> | 返回当前是否处于稳定性测试场景。 |
示例:
import app from '@ohos.application.appManager';
app.isRunningInStabilityTest().then((flag) => {
console.log('success:' + JSON.stringify(flag));
}).catch((error) => {
console.log('failed:' + JSON.stringify(error));
});
appManager.isRamConstrainedDevice
isRamConstrainedDevice(): Promise<boolean>;
查询是否为ram受限设备。
系统能力:SystemCapability.Ability.AbilityRuntime.Core
返回值:
类型 | 说明 |
Promise<boolean> | 是否为ram受限设备。 |
示例:
app.isRamConstrainedDevice().then((data) => {
console.log('success:' + JSON.stringify(data));
}).catch((error) => {
console.log('failed:' + JSON.stringify(error));
});
appManager.isRamConstrainedDevice
isRamConstrainedDevice(callback: AsyncCallback<boolean>): void;
查询是否为ram受限设备。
系统能力:SystemCapability.Ability.AbilityRuntime.Core
参数:
参数名 | 类型 | 必填 | 说明 |
callback | AsyncCallback<boolean> | 是 | 返回当前是否是ram受限设备。 |
示例:
app.isRamConstrainedDevice((err, data) => {
console.log('startAbility result failed:' + JSON.stringify(err));
console.log('startAbility result success:' + JSON.stringify(data));
})
appManager.getAppMemorySize
getAppMemorySize(): Promise<number>;
获取应用程序的内存大小。
系统能力:SystemCapability.Ability.AbilityRuntime.Core
返回值:
类型 | 说明 |
Promise<number> | 应用程序内存大小。 |
示例:
app.getAppMemorySize().then((data) => {
console.log('success:' + JSON.stringify(data));
}).catch((error) => {
console.log('failed:' + JSON.stringify(error));
});
appManager.getAppMemorySize
getAppMemorySize(callback: AsyncCallback<number>): void;
获取应用程序的内存大小。
系统能力:SystemCapability.Ability.AbilityRuntime.Core
参数:
参数名 | 类型 | 必填 | 说明 |
callback | AsyncCallback<number> | 是 | 应用程序内存大小。 |
示例:
app.getAppMemorySize((err, data) => {
console.log('startAbility result failed :' + JSON.stringify(err));
console.log('startAbility result success:' + JSON.stringify(data));
})
appManager.getProcessRunningInfos
getProcessRunningInfos(): Promise<Array<ProcessRunningInfo>>;
获取有关运行进程的信息。
需要权限:ohos.permission.GET_RUNNING_INFO
系统能力:SystemCapability.Ability.AbilityRuntime.Core
返回值:
类型 | 说明 |
Promise<Array<ProcessRunningInfo>> | 获取有关运行进程的信息。 |
示例:
app.getProcessRunningInfos().then((data) => {
console.log('success:' + JSON.stringify(data));
}).catch((error) => {
console.log('failed:' + JSON.stringify(error));
});
appManager.getProcessRunningInfos
getProcessRunningInfos(callback: AsyncCallback<Array<ProcessRunningInfo>>): void;
获取有关运行进程的信息。
需要权限:ohos.permission.GET_RUNNING_INFO
系统能力:SystemCapability.Ability.AbilityRuntime.Core
参数:
参数名 | 类型 | 必填 | 说明 |
callback | AsyncCallback<Array<ProcessRunningInfo>> | 是 | 获取有关运行进程的信息。 |
示例:
app.getProcessRunningInfos((err, data) => {
console.log('startAbility result failed :' + JSON.stringify(err));
console.log('startAbility result success:' + JSON.stringify(data));
})