• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# ExtensionRunningInfo (系统接口)
2
3ExtensionRunningInfo模块封装了Extension运行的相关信息,可以通过[getExtensionRunningInfos接口](js-apis-app-ability-abilityManager-sys.md#getextensionrunninginfos)获取。
4
5> **说明:**
6>
7>  - 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
8>  - 本模块接口为系统接口。
9
10## 导入模块
11
12```ts
13import abilityManager from '@ohos.app.ability.abilityManager';
14```
15
16## 使用说明
17
18导入abilityManager模块,通过调用abilityManager中的方法获取ExtensionRunningInfo。
19
20## 属性
21
22**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
23
24**系统API**:以下各项对应的接口均为系统接口,三方应用不支持调用。
25
26| 名称 | 类型 | 可读 | 可写 | 说明 |
27| -------- | -------- | -------- | -------- | -------- |
28| extension | [ElementName](js-apis-bundleManager-elementName.md) | 是 | 否 | Extension信息。 |
29| pid | number | 是 | 否 | 进程ID。 |
30| uid | number | 是 | 否 | 应用程序的uid。 |
31| processName | string | 是 | 否 | 进程名称。 |
32| startTime | number | 是 | 否 | Extension被启动时的时间戳。 |
33| clientPackage | Array<String> | 是 | 否 | 表示当期进程下的所有包名。 |
34| type | [ExtensionAbilityType](js-apis-bundleManager.md#extensionabilitytype) | 是 | 否 | Extension类型。 |
35
36**示例:**
37```ts
38import abilityManager from '@ohos.app.ability.abilityManager';
39
40let upperLimit = 1;
41function getExtensionInfos() {
42    abilityManager.getExtensionRunningInfos(upperLimit, (error, data) => {
43        if (error) {
44            console.error(`getForegroundApplications failed, error.code: ${JSON.stringify(error.code)}, error.message: ${JSON.stringify(error.message)}`);
45            return;
46        }
47
48        for (let i = 0; i < data.length; i++) {
49            let extensionRunningInfo = data[i];
50            console.log(`extensionRunningInfo.extension: ${JSON.stringify(extensionRunningInfo.extension)}`);
51            console.log(`extensionRunningInfo.pid: ${JSON.stringify(extensionRunningInfo.pid)}`);
52            console.log(`extensionRunningInfo.uid: ${JSON.stringify(extensionRunningInfo.uid)}`);
53            console.log(`extensionRunningInfo.processName: ${JSON.stringify(extensionRunningInfo.processName)}`);
54            console.log(`extensionRunningInfo.startTime: ${JSON.stringify(extensionRunningInfo.startTime)}`);
55            console.log(`extensionRunningInfo.clientPackage: ${JSON.stringify(extensionRunningInfo.clientPackage)}`);
56            console.log(`extensionRunningInfo.type: ${JSON.stringify(extensionRunningInfo.type)}`);
57        }
58    });
59}
60```
61