js-apis-inner-application-extensionRunningInfo.md 2.5 KB
Newer Older
ahjxliubao2's avatar
ahjxliubao2 已提交
1 2
# ExtensionRunningInfo

H
HuangXW 已提交
3
ExtensionRunningInfo模块封装了Extension运行的相关信息,可以通过[getExtensionRunningInfos接口](js-apis-app-ability-abilityManager.md#getextensionrunninginfos)获取。
Y
yuyaozhi 已提交
4

Y
yuyaozhi 已提交
5 6
> **说明:**
> 
H
HuangXW 已提交
7 8
>  - 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
>  - 本模块被标记为@systemapi,对三方应用隐藏
ahjxliubao2's avatar
ahjxliubao2 已提交
9 10 11

## 使用说明

H
HuangXW 已提交
12
导入abilityManager模块,通过调用abilityManager中的方法获取ExtensionRunningInfo。
ahjxliubao2's avatar
ahjxliubao2 已提交
13

14
## 属性
ahjxliubao2's avatar
ahjxliubao2 已提交
15

ahjxliubao2's avatar
ahjxliubao2 已提交
16 17
**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core

D
donglin 已提交
18
| 名称 | 类型 | 可读 | 可写 | 说明 |
ahjxliubao2's avatar
ahjxliubao2 已提交
19
| -------- | -------- | -------- | -------- | -------- |
H
HuangXW 已提交
20
| extension | [ElementName](js-apis-bundleManager-elementName.md) | 是 | 否 | Extension信息。 |
Z
zengyawen 已提交
21
| pid | number | 是 | 否 | 进程ID。 |
H
HuangXW 已提交
22
| uid | number | 是 | 否 | 应用程序的uid。 |
Z
zengyawen 已提交
23
| processName | string | 是 | 否 | 进程名称。 |
H
HuangXW 已提交
24
| startTime | number | 是 | 否 | Extension被启动时的时间戳。 |
Z
zengyawen 已提交
25
| clientPackage | Array<String> | 是 | 否 | 表示当期进程下的所有包名。 |
H
HuangXW 已提交
26
| type | [ExtensionAbilityType](js-apis-bundleManager.md#extensionabilitytype) | 是 | 否 | Extension类型。 |
M
m00512953 已提交
27 28 29

**示例:**
```ts
M
mingxihua 已提交
30
import abilityManager from '@ohos.app.ability.abilityManager';
H
HuangXW 已提交
31

M
mingxihua 已提交
32
let upperLimit = 1;
H
HuangXW 已提交
33 34 35
function getExtensionInfos() {
    abilityManager.getExtensionRunningInfos(upperLimit, (error, data) => {
        if (error && error.code) {
M
mingxihua 已提交
36
            console.error('getForegroundApplications failed, error.code: ${JSON.stringify(error.code)}, error.message: ${JSON.stringify(error.message)}');
H
HuangXW 已提交
37 38 39 40 41
            return;
        }

        for (let i = 0; i < data.length; i++) {
            let extensionRunningInfo = data[i];
M
mingxihua 已提交
42 43 44 45 46 47 48
            console.log('extensionRunningInfo.extension: ${JSON.stringify(extensionRunningInfo.extension)}');
            console.log('extensionRunningInfo.pid: ${JSON.stringify(extensionRunningInfo.pid)}');
            console.log('extensionRunningInfo.uid: ${JSON.stringify(extensionRunningInfo.uid)}');
            console.log('extensionRunningInfo.processName: ${JSON.stringify(extensionRunningInfo.processName)}');
            console.log('extensionRunningInfo.startTime: ${JSON.stringify(extensionRunningInfo.startTime)}');
            console.log('extensionRunningInfo.clientPackage: ${JSON.stringify(extensionRunningInfo.clientPackage)}');
            console.log('extensionRunningInfo.type: ${JSON.stringify(extensionRunningInfo.type)}');
H
HuangXW 已提交
49 50 51 52
        }
    });
}
```