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

> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
4
> 本模块首批接口从API version 7 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
ahjxliubao2's avatar
ahjxliubao2 已提交
5 6


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


## 导入模块

R
RayShih 已提交
12

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


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

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

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

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

**参数:**

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

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


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

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

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

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

**返回值:**

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

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


## appManager.isRamConstrainedDevice

isRamConstrainedDevice(): Promise\<boolean>;

R
RayShih 已提交
72
查询是否为ram受限设备。
73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95

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

**返回值:**

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

**示例:**
    
  ```js
        app.isRamConstrainedDevicePromise().then((data) => {
            console.log('success:' + JSON.stringify(data));
        }).catch((error) => {
            console.log('failed:' + JSON.stringify(error));
        });
  ```

## appManager.isRamConstrainedDevice

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

R
RayShih 已提交
96
查询是否为ram受限设备。
97 98 99 100 101 102 103 104 105 106 107 108 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 159

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

**参数:**

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

**示例:**
    
  ```js
        app.isRamConstrainedDevicePromise((err, data) => {
            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));
        })
160
  ```
161 162
## appManager.getProcessRunningInfos<sup>8+</sup>

163
getProcessRunningInfos(): Promise<Array\<ProcessRunningInfo>>;
164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186

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

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

**返回值:**

  | 类型 | 说明 | 
  | -------- | -------- |
  | Promise<Array\<ProcessRunningInfo>> | 获取有关运行进程的信息。 | 

**示例:**
    
  ```js
        app.GetProcessRunningInfos().then((data) => {
            console.log('success:' + JSON.stringify(data));
        }).catch((error) => {
            console.log('failed:' + JSON.stringify(error));
        });
  ```

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

187
getProcessRunningInfos(callback: AsyncCallback<Array\<ProcessRunningInfo>>): void;
188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206

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

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

**参数:**

  | 参数名 | 类型 | 必填 | 说明 | 
  | -------- | -------- | -------- | -------- |
  | callback | AsyncCallback<Array\<ProcessRunningInfo>> | 否 | 获取有关运行进程的信息。 | 

**示例:**
    
  ```js
        app.GetProcessRunningInfos((err, data) => {
            console.log('startAbility result failed :' + JSON.stringify(err));
            console.log('startAbility result success:' + JSON.stringify(data));
        })
  ```
207 208 209 210 211 212 213 214 215 216 217

## 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数组。 |