harmony 鸿蒙AbilityRunningInfo

2022-12-13
浏览 (568)

AbilityRunningInfo

AbilityRunningInfo模块提供对Ability运行的相关信息和状态的定义。

说明：

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

导入模块

import abilitymanager from '@ohos.app.ability.abilityManager';

使用说明

通过abilityManager中getAbilityRunningInfos方法获取。

属性

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

系统API：该接口为系统接口，三方应用不支持调用。

名称	类型	可读	可写	说明
ability	ElementName	是	否	Ability匹配信息
pid	number	是	否	进程ID。
uid	number	是	否	用户ID。
processName	string	是	否	进程名称。
startTime	number	是	否	Ability启动时间。
abilityState	abilityManager.AbilityState	是	否	Ability状态。

示例：

import abilitymanager from '@ohos.app.ability.abilityManager';

abilitymanager.getAbilityRunningInfos((error, data) => { 
    if (error) {
        console.error(`getAbilityRunningInfos fail, error: ${JSON.stringify(error)}`);
    } else {
        console.log(`getAbilityRunningInfos success, data: ${JSON.stringify(data)}`);
        for (let i = 0; i < data.length; i++) {
            let abilityinfo = data[i];
            console.log(`abilityinfo.ability: ${JSON.stringify(abilityinfo.ability)}`);
            console.log(`abilityinfo.pid: ${JSON.stringify(abilityinfo.pid)}`);
            console.log(`abilityinfo.uid: ${JSON.stringify(abilityinfo.uid)}`);
            console.log(`abilityinfo.processName: ${JSON.stringify(abilityinfo.processName)}`);
            console.log(`abilityinfo.startTime: ${JSON.stringify(abilityinfo.startTime)}`);
            console.log(`abilityinfo.abilityState: ${JSON.stringify(abilityinfo.abilityState)}`);
        }
    }
});