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