• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# AbilityRunningInfo
2
3AbilityRunningInfo模块提供对Ability运行的相关信息和状态的定义。
4
5> **说明:**
6>
7> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
8
9## 导入模块
10
11```ts
12import abilitymanager from '@ohos.app.ability.abilityManager';
13```
14
15## 使用说明
16
17通过abilityManager中[getAbilityRunningInfos](js-apis-app-ability-abilityManager.md#getabilityrunninginfos)方法获取。
18
19## 属性
20
21**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
22
23**系统API**:该接口为系统接口,三方应用不支持调用。
24
25| 名称 | 类型 | 可读 | 可写 | 说明 |
26| -------- | -------- | -------- | -------- | -------- |
27| ability | ElementName | 是 | 否 | Ability匹配信息  |
28| pid | number | 是 | 否 | 进程ID。 |
29| uid | number | 是 | 否 | 用户ID。  |
30| processName | string | 是 | 否 | 进程名称。  |
31| startTime | number | 是 | 否 | Ability启动时间。  |
32| abilityState | [abilityManager.AbilityState](js-apis-app-ability-abilityManager.md#abilitystate) | 是 | 否 | Ability状态。  |
33
34**示例:**
35
36```ts
37import abilitymanager from '@ohos.app.ability.abilityManager';
38
39abilitymanager.getAbilityRunningInfos((error, data) => {
40    if (error) {
41        console.error(`getAbilityRunningInfos fail, error: ${JSON.stringify(error)}`);
42    } else {
43        console.log(`getAbilityRunningInfos success, data: ${JSON.stringify(data)}`);
44        for (let i = 0; i < data.length; i++) {
45            let abilityinfo = data[i];
46            console.log(`abilityinfo.ability: ${JSON.stringify(abilityinfo.ability)}`);
47            console.log(`abilityinfo.pid: ${JSON.stringify(abilityinfo.pid)}`);
48            console.log(`abilityinfo.uid: ${JSON.stringify(abilityinfo.uid)}`);
49            console.log(`abilityinfo.processName: ${JSON.stringify(abilityinfo.processName)}`);
50            console.log(`abilityinfo.startTime: ${JSON.stringify(abilityinfo.startTime)}`);
51            console.log(`abilityinfo.abilityState: ${JSON.stringify(abilityinfo.abilityState)}`);
52        }
53    }
54});
55```