js-apis-appmanager.md 6.3 KB
Newer Older
ahjxliubao2's avatar
ahjxliubao2 已提交
1 2
# appManager

Y
yuyaozhi 已提交
3 4
appManager模块提供服务功能的能力,包括查询当前是否处于稳定性测试场景、查询是否为ram受限设备、获取应用程序的内存大小、获取有关运行进程的信息等。

Y
yuyaozhi 已提交
5 6
> **说明:**
> 
7
> 本模块首批接口从API version 7 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
ahjxliubao2's avatar
ahjxliubao2 已提交
8

W
wusongqing 已提交
9
App管理。
ahjxliubao2's avatar
ahjxliubao2 已提交
10 11 12

## 导入模块

Y
yuyaozhi 已提交
13
```js
ahjxliubao2's avatar
ahjxliubao2 已提交
14 15 16
import app from '@ohos.application.appManager';
```

17
## appManager.isRunningInStabilityTest<sup>8+</sup>
ahjxliubao2's avatar
ahjxliubao2 已提交
18 19 20

static isRunningInStabilityTest(callback: AsyncCallback&lt;boolean&gt;): void

W
wusongqing 已提交
21
查询当前是否处于稳定性测试场景。
ahjxliubao2's avatar
ahjxliubao2 已提交
22

Y
yuyaozhi 已提交
23 24 25 26 27
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core

**参数:**

  | 参数名 | 类型 | 必填 | 说明 | 
ahjxliubao2's avatar
ahjxliubao2 已提交
28 29 30
  | -------- | -------- | -------- | -------- |
  | callback | AsyncCallback&lt;boolean&gt; | 否 | 返回当前是否处于稳定性测试场景。 | 

Y
yuyaozhi 已提交
31
**示例:**
ahjxliubao2's avatar
ahjxliubao2 已提交
32
    
Y
yuyaozhi 已提交
33
  ```js
ahjxliubao2's avatar
ahjxliubao2 已提交
34
  import app from '@ohos.application.appManager';
Y
yuyaozhi 已提交
35
  app.isRunningInStabilityTest((err, flag) => {
Y
yuyaozhi 已提交
36
      console.log('startAbility result:' + JSON.stringify(err));
Y
yuyaozhi 已提交
37
  })  
ahjxliubao2's avatar
ahjxliubao2 已提交
38 39 40
  ```


41
## appManager.isRunningInStabilityTest<sup>8+</sup>
ahjxliubao2's avatar
ahjxliubao2 已提交
42 43 44 45 46

static isRunningInStabilityTest(): Promise&lt;boolean&gt;

查询当前是否处于稳定性测试场景。

Y
yuyaozhi 已提交
47 48 49 50 51
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core

**返回值:**

  | 类型 | 说明 | 
ahjxliubao2's avatar
ahjxliubao2 已提交
52 53 54
  | -------- | -------- |
  | Promise&lt;boolean&gt; | 返回当前是否处于稳定性测试场景。 | 

Y
yuyaozhi 已提交
55
**示例:**
ahjxliubao2's avatar
ahjxliubao2 已提交
56
    
Y
yuyaozhi 已提交
57
  ```js
ahjxliubao2's avatar
ahjxliubao2 已提交
58 59
  import app from '@ohos.application.appManager';
  app.isRunningInStabilityTest().then((flag) => {
Y
yuyaozhi 已提交
60
      console.log('success:' + JSON.stringify(flag));
Y
yuyaozhi 已提交
61
  }).catch((error) => {
Y
yuyaozhi 已提交
62
      console.log('failed:' + JSON.stringify(error));
ahjxliubao2's avatar
ahjxliubao2 已提交
63 64
  });
  ```
65 66 67 68 69 70


## appManager.isRamConstrainedDevice

isRamConstrainedDevice(): Promise\<boolean>;

R
RayShih 已提交
71
查询是否为ram受限设备。
72 73 74 75 76 77 78 79 80 81 82 83

**系统能力**:SystemCapability.Ability.AbilityRuntime.Core

**返回值:**

  | 类型 | 说明 | 
  | -------- | -------- |
  | Promise&lt;boolean&gt; | 是否为ram受限设备。 | 

**示例:**
    
  ```js
Y
yuyaozhi 已提交
84
        app.isRamConstrainedDevice().then((data) => {
85 86 87 88 89 90 91 92 93 94
            console.log('success:' + JSON.stringify(data));
        }).catch((error) => {
            console.log('failed:' + JSON.stringify(error));
        });
  ```

## appManager.isRamConstrainedDevice

isRamConstrainedDevice(callback: AsyncCallback\<boolean>): void;

R
RayShih 已提交
95
查询是否为ram受限设备。
96 97 98 99 100 101 102 103 104 105 106 107

**系统能力**:SystemCapability.Ability.AbilityRuntime.Core

**参数:**

  | 参数名 | 类型 | 必填 | 说明 | 
  | -------- | -------- | -------- | -------- |
  | callback | AsyncCallback&lt;boolean&gt; | 否 | 返回当前是否是ram受限设备。 | 

**示例:**
    
  ```js
Y
yuyaozhi 已提交
108
        app.isRamConstrainedDevice((err, data) => {
109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158
            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&lt;number&gt; | 应用程序内存大小。 | 

**示例:**
    
  ```js
        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&lt;number&gt; | 否 | 应用程序内存大小。 | 

**示例:**
    
  ```js
        app.getAppMemorySize((err, data) => {
            console.log('startAbility result failed :' + JSON.stringify(err));
            console.log('startAbility result success:' + JSON.stringify(data));
        })
159
  ```
160 161
## appManager.getProcessRunningInfos<sup>8+</sup>

Z
zengyawen 已提交
162
getProcessRunningInfos(): Promise\<Array\<ProcessRunningInfo>>;
163 164 165

获取有关运行进程的信息。

Y
yuyaozhi 已提交
166 167
**需要权限**:ohos.permission.GET_RUNNING_INFO

168 169 170 171
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core

**返回值:**

Z
zengyawen 已提交
172 173 174
| 类型 | 说明 |
| -------- | -------- |
| Promise\<Array\<ProcessRunningInfo>> | 获取有关运行进程的信息。 |
175 176 177 178

**示例:**
    
  ```js
Y
yuyaozhi 已提交
179
        app.getProcessRunningInfos().then((data) => {
180 181 182 183 184 185 186 187
            console.log('success:' + JSON.stringify(data));
        }).catch((error) => {
            console.log('failed:' + JSON.stringify(error));
        });
  ```

## appManager.getProcessRunningInfos<sup>8+</sup>

Z
zengyawen 已提交
188
getProcessRunningInfos(callback: AsyncCallback\<Array\<ProcessRunningInfo>>): void;
189 190 191

获取有关运行进程的信息。

Y
yuyaozhi 已提交
192 193
**需要权限**:ohos.permission.GET_RUNNING_INFO

194 195 196 197
**系统能力**:SystemCapability.Ability.AbilityRuntime.Core

**参数:**

Z
zengyawen 已提交
198 199 200
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| callback | AsyncCallback\<Array\<ProcessRunningInfo>> | 否 | 获取有关运行进程的信息。 |
201 202 203 204

**示例:**
    
  ```js
Y
yuyaozhi 已提交
205
        app.getProcessRunningInfos((err, data) => {
206 207 208 209
            console.log('startAbility result failed :' + JSON.stringify(err));
            console.log('startAbility result success:' + JSON.stringify(data));
        })
  ```
210 211 212 213 214 215 216

## ProcessRunningInfo

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

| 名称        | 读写属性 | 类型                 | 必填 | 描述                                                         |
| ----------- | -------- | -------------------- | ---- | ------------------------------------------------------------ |
Y
yuyaozhi 已提交
217 218 219 220
| pid<sup>9+</sup>     | 只读     | number               | 否   | 进程ID。                                |
| uid<sup>9+</sup>   | 只读     | number               | 否   | 用户ID。 |
| processName<sup>9+</sup>  | 只读     | string               | 否   | 进程的名称。 |
| bundleNames<sup>9+</sup>          | 只读     | Array\<string>              | 否   | 进程中运行的bundleName数组。 |