1# @ohos.application.appManager (appManager)
2
3appManager模块提供App管理的能力，包括查询当前是否处于稳定性测试场景、查询是否为ram受限设备、获取应用程序的内存大小、获取有关运行进程的信息等。
4
5> **说明：**
6>
7> 本模块首批接口从API version 8 开始支持，从API version 9废弃，替换模块为[@ohos.app.ability.appManager](js-apis-app-ability-appManager.md)。后续版本的新增接口，采用上角标单独标记接口的起始版本。
8
9## 导入模块
10
11```ts
12import appManager from '@ohos.application.appManager';
13```
14
15## appManager.isRunningInStabilityTest
16
17isRunningInStabilityTest(callback: AsyncCallback<boolean>): void
18
19查询当前是否处于稳定性测试场景。使用callback异步回调。
20
21**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
22
23**参数：**
24
25  | 参数名 | 类型 | 必填 | 说明 |
26  | -------- | -------- | -------- | -------- |
27  | callback | AsyncCallback<boolean> | 是 | 回调函数。返回true表示当前处于稳定性测试场景；返回false表示当前不处于稳定性测试场景。 |
28
29**示例：**
30
31  ```ts
32  import appManager from '@ohos.application.appManager';
33
34  appManager.isRunningInStabilityTest((error, flag) => {
35    if (error && error.code !== 0) {
36        console.error(`isRunningInStabilityTest fail, error: ${JSON.stringify(error)}`);
37    } else {
38        console.log(`isRunningInStabilityTest success, the result is: ${JSON.stringify(flag)}`);
39    }
40  });
41  ```
42
43
44## appManager.isRunningInStabilityTest
45
46isRunningInStabilityTest(): Promise<boolean>
47
48查询当前是否处于稳定性测试场景。使用Promise异步回调。
49
50**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
51
52**返回值：**
53
54  | 类型 | 说明 |
55  | -------- | -------- |
56  | Promise<boolean> | Promise对象。返回true表示当前处于稳定性测试场景；返回false表示当前不处于稳定性测试场景。 |
57
58**示例：**
59
60  ```ts
61  import appManager from '@ohos.application.appManager';
62  import { BusinessError } from '@ohos.base';
63
64  appManager.isRunningInStabilityTest().then((flag) => {
65      console.log(`The result of isRunningInStabilityTest is: ${JSON.stringify(flag)}`);
66  }).catch((error: BusinessError) => {
67      console.error(`error: ${JSON.stringify(error)}`);
68  });
69  ```
70
71
72## appManager.isRamConstrainedDevice<sup>7+<sup>
73
74isRamConstrainedDevice(): Promise\<boolean>
75
76查询是否为ram受限设备。使用Promise异步回调。
77
78**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
79
80**返回值：**
81
82  | 类型 | 说明 |
83  | -------- | -------- |
84  | Promise&lt;boolean&gt; | Promise对象。返回true表示是ram受限设备；返回false表示不是ram受限设备。 |
85
86**示例：**
87
88  ```ts
89  import appManager from '@ohos.application.appManager';
90  import { BusinessError } from '@ohos.base';
91
92  appManager.isRamConstrainedDevice().then((data) => {
93      console.log(`The result of isRamConstrainedDevice is: ${JSON.stringify(data)}`);
94  }).catch((error: BusinessError) => {
95      console.error(`error: ${JSON.stringify(error)}`);
96  });
97  ```
98
99## appManager.isRamConstrainedDevice<sup>7+<sup>
100
101isRamConstrainedDevice(callback: AsyncCallback\<boolean>): void
102
103查询是否为ram受限设备。使用callback异步回调。
104
105**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
106
107**参数：**
108
109  | 参数名 | 类型 | 必填 | 说明 |
110  | -------- | -------- | -------- | -------- |
111  | callback | AsyncCallback&lt;boolean&gt; | 是 | 回调函数。返回true表示当前是ram受限设备；返回false表示当前不是ram受限设备。 |
112
113**示例：**
114
115  ```ts
116  import appManager from '@ohos.application.appManager';
117
118  appManager.isRamConstrainedDevice((error, data) => {
119      if (error && error.code !== 0) {
120          console.error(`isRamConstrainedDevice fail, error: ${JSON.stringify(error)}`);
121      } else {
122          console.log(`The result of isRamConstrainedDevice is: ${JSON.stringify(data)}`);
123      }
124  });
125  ```
126
127## appManager.getAppMemorySize<sup>7+<sup>
128
129getAppMemorySize(): Promise\<number>
130
131获取当前应用程序可以使用的内存的值。
132
133**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
134
135**返回值：**
136
137  | 类型 | 说明 |
138  | -------- | -------- |
139  | Promise&lt;number&gt; | 获取当前应用程序可以使用的内存的值，可根据此值进行错误处理或其他自定义处理，单位是M。使用Promise异步回调。|
140
141**示例：**
142
143  ```ts
144  import appManager from '@ohos.application.appManager';
145  import { BusinessError } from '@ohos.base';
146
147  appManager.getAppMemorySize().then((data) => {
148      console.log(`The size of app memory is: ${JSON.stringify(data)}`);
149  }).catch((error: BusinessError) => {
150      console.error(`error: ${JSON.stringify(error)}`);
151  });
152  ```
153
154## appManager.getAppMemorySize<sup>7+<sup>
155
156getAppMemorySize(callback: AsyncCallback\<number>): void
157
158获取应用程序的内存大小。使用callback异步回调。
159
160**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
161
162**参数：**
163
164  | 参数名 | 类型 | 必填 | 说明 |
165  | -------- | -------- | -------- | -------- |
166  | callback | AsyncCallback&lt;number&gt; | 是 | 获取当前应用程序可以使用的内存的值，可根据此值进行错误处理或其他自定义处理，单位是M。使用callback异步回调。|
167
168**示例：**
169
170  ```ts
171  import appManager from '@ohos.application.appManager';
172
173  appManager.getAppMemorySize((error, data) => {
174      if (error && error.code !== 0) {
175          console.error(`getAppMemorySize fail, error: ${JSON.stringify(error)}`);
176      } else {
177          console.log(`The size of app memory is: ${JSON.stringify(data)}`);
178      }
179  });
180  ```
181## appManager.getProcessRunningInfos<sup>(deprecated)</sup>
182
183getProcessRunningInfos(): Promise\<Array\<ProcessRunningInfo>>
184
185获取有关运行进程的信息。使用Promise异步回调。
186
187> 从 API Version 9 开始废弃，建议使用[appManager.getRunningProcessInformation](js-apis-app-ability-appManager.md#appmanagergetrunningprocessinformation)替代。
188
189**需要权限**：ohos.permission.GET_RUNNING_INFO（该权限仅系统应用可申请）
190
191**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
192
193**返回值：**
194
195| 类型 | 说明 |
196| -------- | -------- |
197| Promise\<Array\<[ProcessRunningInfo](js-apis-inner-application-processRunningInfo.md)>> | Promise对象，返回有关运行进程的信息。 |
198
199**示例：**
200
201  ```ts
202  import appManager from '@ohos.application.appManager';
203  import { BusinessError } from '@ohos.base';
204
205  appManager.getProcessRunningInfos().then((data) => {
206      console.log(`The process running infos is: ${JSON.stringify(data)}`);
207  }).catch((error: BusinessError) => {
208      console.error(`error: ${JSON.stringify(error)}`);
209  });
210  ```
211
212## appManager.getProcessRunningInfos<sup>(deprecated)</sup>
213
214getProcessRunningInfos(callback: AsyncCallback\<Array\<ProcessRunningInfo>>): void
215
216获取有关运行进程的信息。使用callback异步回调。
217
218> 从 API Version 9 开始废弃，建议使用[appManager.getRunningProcessInformation](js-apis-app-ability-appManager.md#appmanagergetrunningprocessinformation)替代。
219
220**需要权限**：ohos.permission.GET_RUNNING_INFO（该权限仅系统应用可申请）
221
222**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
223
224**参数：**
225
226| 参数名 | 类型 | 必填 | 说明 |
227| -------- | -------- | -------- | -------- |
228| callback | AsyncCallback\<Array\<[ProcessRunningInfo](js-apis-inner-application-processRunningInfo.md)>> | 是 | 回调函数，返回有关运行进程的信息。 |
229
230**示例：**
231
232  ```ts
233  import appManager from '@ohos.application.appManager';
234
235  appManager.getProcessRunningInfos((error, data) => {
236      if (error && error.code !== 0) {
237          console.error(`getProcessRunningInfos fail, error: ${JSON.stringify(error)}`);
238      } else {
239          console.log(`getProcessRunningInfos success, data: ${JSON.stringify(data)}`);
240      }
241  });
242  ```