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

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


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


## 导入模块

R
RayShih 已提交
13

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


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

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

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

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

**参数:**

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

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


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

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

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

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

**返回值:**

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

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


## appManager.isRamConstrainedDevice

isRamConstrainedDevice(): Promise\<boolean>;

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

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

**返回值:**

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

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

## appManager.isRamConstrainedDevice

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

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

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

**参数:**

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

**示例:**
    
  ```js
Y
yuyaozhi 已提交
110
        app.isRamConstrainedDevice((err, data) => {
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 159 160
            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));
        })
161
  ```
162 163
## appManager.getProcessRunningInfos<sup>8+</sup>

Z
zengyawen 已提交
164
getProcessRunningInfos(): Promise\<Array\<ProcessRunningInfo>>;
165 166 167 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 192 193 194 195

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

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

**参数:**

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

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

## ProcessRunningInfo

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

| 名称        | 读写属性 | 类型                 | 必填 | 描述                                                         |
| ----------- | -------- | -------------------- | ---- | ------------------------------------------------------------ |
| pid<sup>8+</sup>     | 只读     | number               | 否   | 进程ID。                                |
| uid<sup>8+</sup>   | 只读     | number               | 否   | 用户ID。 |
| processName<sup>8+</sup>  | 只读     | string               | 否   | 进程的名称。 |
| bundleNames<sup>8+</sup>          | 只读     | Array\<string>              | 否   | 进程中运行的bundleName数组。 |