1# @ohos.app.ability.appManager (appManager) 2 3appManager模块提供App管理的能力，包括查询当前是否处于稳定性测试场景、查询是否为ram受限设备、获取应用程序的内存大小、获取有关运行进程的信息等。 4 5> **说明：** 6> 7> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 8 9## 导入模块 10 11```ts 12import appManager from '@ohos.app.ability.appManager'; 13``` 14 15## appManager.isRunningInStabilityTest 16 17static isRunningInStabilityTest(callback: AsyncCallback<boolean>): void 18 19查询当前是否处于稳定性测试场景。 20 21**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 22 23**参数：** 24 25 | 参数名 | 类型 | 必填 | 说明 | 26 | -------- | -------- | -------- | -------- | 27 | callback | AsyncCallback<boolean> | 是 |以回调方式返回接口运行结果及当前是否处于稳定性测试场景，可进行错误处理或其他自定义处理。true: 处于稳定性测试场景，false：处于非稳定性测试场景。 | 28 29**错误码**： 30 31| 错误码ID | 错误信息 | 32| ------- | -------- | 33| 16000050 | Internal error. | 34 35以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 36 37**示例：** 38 39```ts 40import appManager from '@ohos.app.ability.appManager'; 41 42appManager.isRunningInStabilityTest((err, flag) => { 43 if (err) { 44 console.error(`isRunningInStabilityTest fail, err: ${JSON.stringify(err)}`); 45 } else { 46 console.log(`The result of isRunningInStabilityTest is: ${JSON.stringify(flag)}`); 47 } 48}); 49``` 50 51 52## appManager.isRunningInStabilityTest 53 54static isRunningInStabilityTest(): Promise<boolean> 55 56查询当前是否处于稳定性测试场景。 57 58**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 59 60**返回值：** 61 62 | 类型 | 说明 | 63 | -------- | -------- | 64 | Promise<boolean> | 以Promise方式返回接口运行结果及当前是否处于稳定性测试场景，可进行错误处理或其他自定义处理。true: 处于稳定性测试场景，false：处于非稳定性测试场景。 | 65 66**错误码**： 67 68| 错误码ID | 错误信息 | 69| ------- | -------- | 70| 16000050 | Internal error. | 71 72以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 73 74**示例：** 75 76```ts 77import appManager from '@ohos.app.ability.appManager'; 78import { BusinessError } from '@ohos.base'; 79 80appManager.isRunningInStabilityTest().then((flag) => { 81 console.log(`The result of isRunningInStabilityTest is: ${JSON.stringify(flag)}`); 82}).catch((error: BusinessError) => { 83 console.error(`error: ${JSON.stringify(error)}`); 84}); 85``` 86 87 88## appManager.isRamConstrainedDevice 89 90isRamConstrainedDevice(): Promise\<boolean>; 91 92查询是否为ram受限设备。 93 94**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 95 96**返回值：** 97 98 | 类型 | 说明 | 99 | -------- | -------- | 100 | Promise<boolean> | 以Promise方式返回接口运行结果及当前设备是否为ram受限设备，可进行错误处理或其他自定义处理。true：当前设备为ram受限设备，false：当前设备为非ram受限设备。 | 101 102**错误码**： 103 104| 错误码ID | 错误信息 | 105| ------- | -------- | 106| 16000050 | Internal error. | 107 108以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 109 110**示例：** 111 112```ts 113import appManager from '@ohos.app.ability.appManager'; 114import { BusinessError } from '@ohos.base'; 115 116appManager.isRamConstrainedDevice().then((data) => { 117 console.log(`The result of isRamConstrainedDevice is: ${JSON.stringify(data)}`); 118}).catch((error: BusinessError) => { 119 console.error(`error: ${JSON.stringify(error)}`); 120}); 121``` 122 123## appManager.isRamConstrainedDevice 124 125isRamConstrainedDevice(callback: AsyncCallback\<boolean>): void; 126 127查询是否为ram受限设备。 128 129**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 130 131**参数：** 132 133 | 参数名 | 类型 | 必填 | 说明 | 134 | -------- | -------- | -------- | -------- | 135 | callback | AsyncCallback<boolean> | 是 |以回调方式返回接口运行结果及当前设备是否为ram受限设备，可进行错误处理或其他自定义处理。true：当前设备为ram受限设备，false：当前设备为非ram受限设备。 | 136 137**错误码**： 138 139| 错误码ID | 错误信息 | 140| ------- | -------- | 141| 16000050 | Internal error. | 142 143以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 144 145**示例：** 146 147```ts 148import appManager from '@ohos.app.ability.appManager'; 149 150appManager.isRamConstrainedDevice((err, data) => { 151 if (err) { 152 console.error(`isRamConstrainedDevice fail, err: ${JSON.stringify(err)}`); 153 } else { 154 console.log(`The result of isRamConstrainedDevice is: ${JSON.stringify(data)}`); 155 } 156}); 157``` 158 159## appManager.getAppMemorySize 160 161getAppMemorySize(): Promise\<number>; 162 163获取应用程序的内存大小。 164 165**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 166 167**返回值：** 168 169 | 类型 | 说明 | 170 | -------- | -------- | 171 | Promise<number> | 以Promise方式返回接口运行结果及应用程序内存大小，可进行错误处理或其他自定义处理。 | 172 173**错误码**： 174 175| 错误码ID | 错误信息 | 176| ------- | -------- | 177| 16000050 | Internal error. | 178 179以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 180 181**示例：** 182 183```ts 184import appManager from '@ohos.app.ability.appManager'; 185import { BusinessError} from '@ohos.base' 186 187appManager.getAppMemorySize().then((data) => { 188 console.log(`The size of app memory is: ${JSON.stringify(data)}`); 189}).catch((error: BusinessError) => { 190 console.error(`error: ${JSON.stringify(error)}`); 191}); 192``` 193 194## appManager.getAppMemorySize 195 196getAppMemorySize(callback: AsyncCallback\<number>): void; 197 198获取应用程序的内存大小。 199 200**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 201 202**参数：** 203 204 | 参数名 | 类型 | 必填 | 说明 | 205 | -------- | -------- | -------- | -------- | 206 | callback | AsyncCallback<number> | 是 |以回调方式返回接口运行结果及应用程序内存大小，可进行错误处理或其他自定义处理。 | 207 208**错误码**： 209 210| 错误码ID | 错误信息 | 211| ------- | -------- | 212| 16000050 | Internal error. | 213 214以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 215 216**示例：** 217 218```ts 219import appManager from '@ohos.app.ability.appManager'; 220 221appManager.getAppMemorySize((err, data) => { 222 if (err) { 223 console.error(`getAppMemorySize fail, err: ${JSON.stringify(err)}`); 224 } else { 225 console.log(`The size of app memory is: ${JSON.stringify(data)}`); 226 } 227}); 228``` 229 230## appManager.getRunningProcessInformation 231 232getRunningProcessInformation(): Promise\<Array\<ProcessInformation>>; 233 234获取有关运行进程的信息。 235 236**需要权限**：ohos.permission.GET_RUNNING_INFO 237 238**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 239 240**返回值：** 241 242| 类型 | 说明 | 243| -------- | -------- | 244| Promise\<Array\<[ProcessInformation](js-apis-inner-application-processInformation.md)>> | 以Promise方式返回接口运行结果及有关运行进程的信息，可进行错误处理或其他自定义处理。 | 245 246**错误码**： 247 248| 错误码ID | 错误信息 | 249| ------- | -------- | 250| 16000050 | Internal error. | 251 252以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 253 254**示例：** 255 256```ts 257import appManager from '@ohos.app.ability.appManager'; 258import { BusinessError } from '@ohos.base'; 259 260appManager.getRunningProcessInformation().then((data) => { 261 console.log(`The running process information is: ${JSON.stringify(data)}`); 262}).catch((error: BusinessError) => { 263 console.error(`error: ${JSON.stringify(error)}`); 264}); 265``` 266 267## appManager.getRunningProcessInformation<sup>9+</sup> 268 269getRunningProcessInformation(callback: AsyncCallback\<Array\<ProcessInformation>>): void; 270 271获取有关运行进程的信息。 272 273**需要权限**：ohos.permission.GET_RUNNING_INFO 274 275**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 276 277**参数：** 278 279 | 参数名 | 类型 | 必填 | 说明 | 280 | -------- | -------- | -------- | -------- | 281 | callback | AsyncCallback\<Array\<[ProcessInformation](js-apis-inner-application-processInformation.md)>> | 是 |以回调方式返回接口运行结果及有关运行进程的信息，可进行错误处理或其他自定义处理。 | 282 283**错误码**： 284 285| 错误码ID | 错误信息 | 286| ------- | -------- | 287| 16000050 | Internal error. | 288 289以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 290 291**示例：** 292 293```ts 294import appManager from '@ohos.app.ability.appManager'; 295 296appManager.getRunningProcessInformation((err, data) => { 297 if (err) { 298 console.error(`getRunningProcessInformation fail, err: ${JSON.stringify(err)}`); 299 } else { 300 console.log(`The process running information is: ${JSON.stringify(data)}`); 301 } 302}); 303``` 304 305## appManager.isSharedBundleRunning<sup>10+</sup> 306 307isSharedBundleRunning(bundleName: string, versionCode: number): Promise\<boolean>; 308 309检查共享库是否正在使用。使用Promise异步回调。 310 311**需要权限**：ohos.permission.GET_RUNNING_INFO 312 313**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 314 315**系统接口**：此接口为系统接口。 316 317**参数**： 318 319| 参数名 | 类型 | 必填 | 说明 | 320| --------- | ---------------------------------------- | ---- | -------------- | 321| bundleName | string | 是 | 表示要查询的共享库包名。 | 322| versionCode | number | 是 | 表示要查询的共享库版本号。 | 323 324**返回值：** 325 326| 类型 | 说明 | 327| -------- | -------- | 328| Promise\<boolean> | Promise对象。返回true表示共享库正在使用，返回false表示共享库不在使用。 | 329 330**错误码**： 331 332| 错误码ID | 错误信息 | 333| ------- | -------- | 334| 16000050 | Internal error. | 335 336以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 337 338**示例：** 339 340```ts 341import appManager from '@ohos.app.ability.appManager'; 342import { BusinessError } from '@ohos.base'; 343 344const bundleName = "this is a bundleName"; 345const versionCode = 1; 346appManager.isSharedBundleRunning(bundleName, versionCode).then((data) => { 347 console.log(`The shared bundle running is: ${JSON.stringify(data)}`); 348}).catch((error: BusinessError) => { 349 console.error(`error: ${JSON.stringify(error)}`); 350}); 351``` 352 353## appManager.isSharedBundleRunning<sup>10+</sup> 354 355isSharedBundleRunning(bundleName: string, versionCode: number, callback: AsyncCallback\<boolean>): void; 356 357检查共享库是否正在使用。使用callback异步回调。 358 359**需要权限**：ohos.permission.GET_RUNNING_INFO 360 361**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 362 363**系统接口**：此接口为系统接口。 364 365**参数**： 366 367| 参数名 | 类型 | 必填 | 说明 | 368| --------- | ---------------------------------------- | ---- | -------------- | 369| bundleName | string | 是 | 表示要查询的共享库包名。 | 370| versionCode | number | 是 | 表示要查询的共享库版本号。 | 371|AsyncCallback\<boolean>> | 回调函数。返回true表示共享库正在使用，返回false表示共享库不在使用。 | 372 373**错误码**： 374 375| 错误码ID | 错误信息 | 376| ------- | -------- | 377| 16000050 | Internal error. | 378 379以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 380 381**示例：** 382 383```ts 384import appManager from '@ohos.app.ability.appManager'; 385 386const bundleName = "this is a bundleName"; 387const versionCode = 1; 388appManager.isSharedBundleRunning(bundleName, versionCode, (err, data) => { 389 if (err) { 390 console.error(`err: ${JSON.stringify(err)}`); 391 } else { 392 console.log(`The shared bundle running is: ${JSON.stringify(data)}`); 393 } 394}); 395``` 396 397## appManager.on 398 399on(type: 'applicationState', observer: ApplicationStateObserver): number; 400 401注册全部应用程序的状态观测器。 402 403**需要权限**：ohos.permission.RUNNING_STATE_OBSERVER 404 405**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 406 407**系统API**：该接口为系统接口，三方应用不支持调用。 408 409**参数：** 410 411| 参数名 | 类型 | 必填 | 说明 | 412| -------- | -------- | -------- | -------- | 413| type | string | 是 | 调用接口类型，固定填'applicationState'字符串。 | 414| observer | [ApplicationStateObserver](./js-apis-inner-application-applicationStateObserver.md) | 是 | 应用状态观测器，用于观测应用的生命周期变化。 | 415 416**返回值：** 417 418| 类型 | 说明 | 419| --- | --- | 420| number | 已注册观测器的数字代码，可用于off接口取消注册观测器。| 421 422**错误码**： 423 424| 错误码ID | 错误信息 | 425| ------- | -------- | 426| 16000050 | Internal error. | 427 428以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 429 430**示例：** 431 432```ts 433import appManager from '@ohos.app.ability.appManager'; 434import { BusinessError } from '@ohos.base'; 435 436let applicationStateObserver: appManager.ApplicationStateObserver = { 437 onForegroundApplicationChanged(appStateData) { 438 console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`); 439 }, 440 onAbilityStateChanged(abilityStateData) { 441 console.log(`[appManager] onAbilityStateChanged: ${JSON.stringify(abilityStateData)}`); 442 }, 443 onProcessCreated(processData) { 444 console.log(`[appManager] onProcessCreated: ${JSON.stringify(processData)}`); 445 }, 446 onProcessDied(processData) { 447 console.log(`[appManager] onProcessDied: ${JSON.stringify(processData)}`); 448 }, 449 onProcessStateChanged(processData) { 450 console.log(`[appManager] onProcessStateChanged: ${JSON.stringify(processData)}`); 451 } 452}; 453try { 454 const observerId = appManager.on('applicationState', applicationStateObserver); 455 console.log(`[appManager] observerCode: ${observerId}`); 456} catch (paramError) { 457 let code = (paramError as BusinessError).code; 458 let message = (paramError as BusinessError).message; 459 console.error(`[appManager] error: ${code}, ${message} `); 460} 461``` 462 463## appManager.on 464 465on(type: 'applicationState', observer: ApplicationStateObserver, bundleNameList: Array\<string>): number; 466 467注册指定应用程序的状态观测器。 468 469**需要权限**：ohos.permission.RUNNING_STATE_OBSERVER 470 471**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 472 473**系统API**：该接口为系统接口，三方应用不支持调用。 474 475**参数：** 476 477| 参数名 | 类型 | 必填 | 说明 | 478| -------- | -------- | -------- | -------- | 479| type | string | 是 | 调用接口类型，固定填'applicationState'字符串。 | 480| observer | [ApplicationStateObserver](./js-apis-inner-application-applicationStateObserver.md) | 是 | 应用状态观测器，用于观测应用的生命周期变化。 | 481| bundleNameList | `Array<string>` | 是 | 表示需要注册监听的bundleName数组。最大值128。 | 482 483**返回值：** 484 485| 类型 | 说明 | 486| --- | --- | 487| number | 已注册观测器的数字代码，可用于off接口注销观测器。| 488 489**错误码**： 490 491| 错误码ID | 错误信息 | 492| ------- | -------- | 493| 16000050 | Internal error. | 494 495以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 496 497**示例：** 498 499```ts 500import appManager from '@ohos.app.ability.appManager'; 501import { BusinessError } from '@ohos.base'; 502 503let applicationStateObserver: appManager.ApplicationStateObserver = { 504 onForegroundApplicationChanged(appStateData) { 505 console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`); 506 }, 507 onAbilityStateChanged(abilityStateData) { 508 console.log(`[appManager] onAbilityStateChanged: ${JSON.stringify(abilityStateData)}`); 509 }, 510 onProcessCreated(processData) { 511 console.log(`[appManager] onProcessCreated: ${JSON.stringify(processData)}`); 512 }, 513 onProcessDied(processData) { 514 console.log(`[appManager] onProcessDied: ${JSON.stringify(processData)}`); 515 }, 516 onProcessStateChanged(processData) { 517 console.log(`[appManager] onProcessStateChanged: ${JSON.stringify(processData)}`); 518 } 519}; 520let bundleNameList = ['bundleName1', 'bundleName2']; 521try { 522 const observerId = appManager.on('applicationState', applicationStateObserver, bundleNameList); 523 console.log(`[appManager] observerCode: ${observerId}`); 524} catch (paramError) { 525 let code = (paramError as BusinessError).code; 526 let message = (paramError as BusinessError).message; 527 console.error(`[appManager] error: ${code}, ${message} `); 528} 529``` 530 531## appManager.off 532 533off(type: 'applicationState', observerId: number, callback: AsyncCallback\<void>): void; 534 535取消注册应用程序状态观测器。 536 537**需要权限**：ohos.permission.RUNNING_STATE_OBSERVER 538 539**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 540 541**系统API**：该接口为系统接口，三方应用不支持调用。 542 543**参数：** 544 545| 参数名 | 类型 | 必填 | 说明 | 546| -------- | -------- | -------- | -------- | 547| type | string | 是 | 调用接口类型，固定填'applicationState'字符串。 | 548| observerId | number | 是 | 表示观测器的编号代码。 | 549| callback | AsyncCallback\<void> | 是 | 以回调方式返回接口运行结果，可进行错误处理或其他自定义处理。 | 550 551**错误码**： 552 553| 错误码ID | 错误信息 | 554| ------- | -------- | 555| 16000050 | Internal error. | 556 557以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 558 559**示例：** 560 561```ts 562import appManager from '@ohos.app.ability.appManager'; 563import { BusinessError } from '@ohos.base'; 564 565let observerId = 0; 566 567// 1.注册应用状态监听器 568let applicationStateObserver: appManager.ApplicationStateObserver = { 569 onForegroundApplicationChanged(appStateData) { 570 console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`); 571 }, 572 onAbilityStateChanged(abilityStateData) { 573 console.log(`[appManager] onAbilityStateChanged: ${JSON.stringify(abilityStateData)}`); 574 }, 575 onProcessCreated(processData) { 576 console.log(`[appManager] onProcessCreated: ${JSON.stringify(processData)}`); 577 }, 578 onProcessDied(processData) { 579 console.log(`[appManager] onProcessDied: ${JSON.stringify(processData)}`); 580 }, 581 onProcessStateChanged(processData) { 582 console.log(`[appManager] onProcessStateChanged: ${JSON.stringify(processData)}`); 583 } 584}; 585let bundleNameList = ['bundleName1', 'bundleName2']; 586try { 587 observerId = appManager.on('applicationState', applicationStateObserver, bundleNameList); 588 console.log(`[appManager] observerCode: ${observerId}`); 589} catch (paramError) { 590 let code = (paramError as BusinessError).code; 591 let message = (paramError as BusinessError).message; 592 console.error(`[appManager] error: ${code}, ${message} `); 593} 594 595// 2.注销应用状态监听器 596function unregisterApplicationStateObserverCallback(err: BusinessError) { 597 if (err) { 598 console.error(`unregisterApplicationStateObserverCallback fail, err: ${JSON.stringify(err)}`); 599 } else { 600 console.log('unregisterApplicationStateObserverCallback success.'); 601 } 602} 603try { 604 appManager.off('applicationState', observerId, unregisterApplicationStateObserverCallback); 605} catch (paramError) { 606 let code = (paramError as BusinessError).code; 607 let message = (paramError as BusinessError).message; 608 console.error(`[appManager] error: ${code}, ${message} `); 609} 610``` 611 612## appManager.off 613 614off(type: 'applicationState', observerId: number): Promise\<void>; 615 616取消注册应用程序状态观测器。 617 618**需要权限**：ohos.permission.RUNNING_STATE_OBSERVER 619 620**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 621 622**系统API**：该接口为系统接口，三方应用不支持调用。 623 624**参数：** 625 626| 参数名 | 类型 | 必填 | 说明 | 627| -------- | -------- | -------- | -------- | 628| type | string | 是 | 调用接口类型，固定填'applicationState'字符串。 | 629| observerId | number | 是 | 表示观测器的编号代码。 | 630 631**返回值：** 632 633| 类型 | 说明 | 634| -------- | -------- | 635| Promise\<void> | 以Promise方式返回接口运行结果，可进行错误处理或其他自定义处理。 | 636 637**错误码**： 638 639| 错误码ID | 错误信息 | 640| ------- | -------- | 641| 16000050 | Internal error. | 642 643以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 644 645**示例：** 646 647```ts 648import appManager from '@ohos.app.ability.appManager'; 649import { BusinessError } from '@ohos.base'; 650 651let observerId = 0; 652 653// 1.注册应用状态监听器 654let applicationStateObserver: appManager.ApplicationStateObserver = { 655 onForegroundApplicationChanged(appStateData) { 656 console.log(`[appManager] onForegroundApplicationChanged: ${JSON.stringify(appStateData)}`); 657 }, 658 onAbilityStateChanged(abilityStateData) { 659 console.log(`[appManager] onAbilityStateChanged: ${JSON.stringify(abilityStateData)}`); 660 }, 661 onProcessCreated(processData) { 662 console.log(`[appManager] onProcessCreated: ${JSON.stringify(processData)}`); 663 }, 664 onProcessDied(processData) { 665 console.log(`[appManager] onProcessDied: ${JSON.stringify(processData)}`); 666 }, 667 onProcessStateChanged(processData) { 668 console.log(`[appManager] onProcessStateChanged: ${JSON.stringify(processData)}`); 669 } 670}; 671let bundleNameList = ['bundleName1', 'bundleName2']; 672try { 673 observerId = appManager.on('applicationState', applicationStateObserver, bundleNameList); 674} catch (paramError) { 675 let code = (paramError as BusinessError).code; 676 let message = (paramError as BusinessError).message; 677 console.error(`[appManager] error: ${code}, ${message} `); 678} 679 680// 2.注销应用状态监听器 681try { 682 appManager.off('applicationState', observerId).then((data) => { 683 console.log(`unregisterApplicationStateObserver success, data: ${JSON.stringify(data)}`); 684 }).catch((err: BusinessError) => { 685 console.error(`unregisterApplicationStateObserver fail, err: ${JSON.stringify(err)}`); 686 }); 687} catch (paramError) { 688 let code = (paramError as BusinessError).code; 689 let message = (paramError as BusinessError).message; 690 console.error(`[appManager] error: ${code}, ${message} `); 691} 692``` 693 694## appManager.getForegroundApplications 695 696getForegroundApplications(callback: AsyncCallback\<Array\<AppStateData>>): void; 697 698获取当前所有前台应用的信息。该应用信息由[AppStateData](js-apis-inner-application-appStateData.md)定义。 699 700**需要权限**：ohos.permission.GET_RUNNING_INFO 701 702**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 703 704**系统API**：该接口为系统接口，三方应用不支持调用。 705 706**错误码**： 707 708| 错误码ID | 错误信息 | 709| ------- | -------- | 710| 16000050 | Internal error. | 711 712以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 713 714**参数：** 715 716| 参数名 | 类型 | 必填 | 说明 | 717| -------- | -------- | -------- | -------- | 718| callback | AsyncCallback\<Array\<[AppStateData](js-apis-inner-application-appStateData.md)>> | 是 | 以回调方式方式返回接口运行结果及应用状态数据数组，可进行错误处理或其他自定义处理。 | 719 720**示例：** 721 722```ts 723import appManager from '@ohos.app.ability.appManager'; 724import { BusinessError } from '@ohos.base'; 725 726function getForegroundApplicationsCallback(err: BusinessError, data: Array<appManager.AppStateData>) { 727 if (err) { 728 console.error(`getForegroundApplicationsCallback fail, err: ${JSON.stringify(err)}`); 729 } else { 730 console.log(`getForegroundApplicationsCallback success, data: ${JSON.stringify(data)}`); 731 } 732} 733try { 734 appManager.getForegroundApplications(getForegroundApplicationsCallback); 735} catch (paramError) { 736 let code = (paramError as BusinessError).code; 737 let message = (paramError as BusinessError).message; 738 console.error(`[appManager] error: ${code}, ${message} `); 739} 740``` 741 742## appManager.getForegroundApplications 743 744getForegroundApplications(): Promise\<Array\<AppStateData>>; 745 746获取当前所有前台应用的信息。该应用信息由[AppStateData](js-apis-inner-application-appStateData.md)定义。 747 748**需要权限**：ohos.permission.GET_RUNNING_INFO 749 750**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 751 752**系统API**：该接口为系统接口，三方应用不支持调用。 753 754**返回值：** 755 756| 类型 | 说明 | 757| -------- | -------- | 758| Promise\<Array\<[AppStateData](js-apis-inner-application-appStateData.md)>> | 返回前台进程应用程序的数组。 | 759 760**错误码**： 761 762| 错误码ID | 错误信息 | 763| ------- | -------- | 764| 16000050 | Internal error. | 765 766以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 767 768**示例：** 769 770```ts 771import appManager from '@ohos.app.ability.appManager'; 772import { BusinessError } from '@ohos.base'; 773 774appManager.getForegroundApplications().then((data) => { 775 console.log(`getForegroundApplications success, data: ${JSON.stringify(data)}`); 776}).catch((err: BusinessError) => { 777 console.error(`getForegroundApplications fail, err: ${JSON.stringify(err)}`); 778}); 779``` 780 781## appManager.killProcessWithAccount 782 783killProcessWithAccount(bundleName: string, accountId: number): Promise\<void\> 784 785切断account进程（Promise形式）。 786 787> **说明：** 788> 789> 当accountId为当前用户时，不需要校验ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS权限。 790 791**需要权限**：ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS, ohos.permission.CLEAN_BACKGROUND_PROCESSES 792 793**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 794 795**系统API**: 此接口为系统接口，三方应用不支持调用。 796 797**参数：** 798 799| 参数名 | 类型 | 必填 | 说明 | 800| -------- | -------- | -------- | -------- | 801| bundleName | string | 是 | 应用Bundle名称。 | 802| accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 | 803 804**错误码**： 805 806| 错误码ID | 错误信息 | 807| ------- | -------- | 808| 16000050 | Internal error. | 809 810以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 811 812**示例：** 813 814```ts 815import appManager from '@ohos.app.ability.appManager'; 816import { BusinessError } from '@ohos.base'; 817 818let bundleName = 'bundleName'; 819let accountId = 0; 820try { 821 appManager.killProcessWithAccount(bundleName, accountId).then(() => { 822 console.log('killProcessWithAccount success'); 823 }).catch((err: BusinessError) => { 824 console.error(`killProcessWithAccount fail, err: ${JSON.stringify(err)}`); 825 }); 826} catch (paramError) { 827 let code = (paramError as BusinessError).code; 828 let message = (paramError as BusinessError).message; 829 console.error(`[appManager] error: ${code}, ${message} `); 830} 831``` 832 833 834## appManager.killProcessWithAccount 835 836killProcessWithAccount(bundleName: string, accountId: number, callback: AsyncCallback\<void\>): void 837 838切断account进程（callback形式）。 839 840> **说明：** 841> 842> 当accountId为当前用户时，不需要校验ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS权限。 843 844**需要权限**：ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS, ohos.permission.CLEAN_BACKGROUND_PROCESSES 845 846**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 847 848**系统API**: 此接口为系统接口，三方应用不支持调用。 849 850**参数：** 851 852 | 参数名 | 类型 | 必填 | 说明 | 853 | -------- | -------- | -------- | -------- | 854 | bundleName | string | 是 | 应用Bundle名称。 | 855 | accountId | number | 是 | 系统帐号的帐号ID，详情参考[getCreatedOsAccountsCount](js-apis-osAccount.md#getosaccountlocalidfromprocess)。 | 856 | callback | AsyncCallback\<void\> | 是 | 以回调方式返回接口运行结果，可进行错误处理或其他自定义处理。 | 857 858**错误码**： 859 860| 错误码ID | 错误信息 | 861| ------- | -------- | 862| 16000050 | Internal error. | 863 864以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 865 866**示例：** 867 868```ts 869import appManager from '@ohos.app.ability.appManager'; 870import { BusinessError } from '@ohos.base'; 871 872let bundleName = 'bundleName'; 873let accountId = 0; 874function killProcessWithAccountCallback(err: BusinessError) { 875 if (err) { 876 console.error(`killProcessWithAccountCallback fail, err: ${JSON.stringify(err)}`); 877 } else { 878 console.log('killProcessWithAccountCallback success.'); 879 } 880} 881appManager.killProcessWithAccount(bundleName, accountId, killProcessWithAccountCallback); 882``` 883 884## appManager.killProcessesByBundleName 885 886killProcessesByBundleName(bundleName: string, callback: AsyncCallback\<void>); 887 888通过Bundle名称终止进程。 889 890**需要权限**：ohos.permission.CLEAN_BACKGROUND_PROCESSES 891 892**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 893 894**系统API**：该接口为系统接口，三方应用不支持调用。 895 896**参数：** 897 898| 参数名 | 类型 | 必填 | 说明 | 899| -------- | -------- | -------- | -------- | 900| bundleName | string | 是 | 表示Bundle名称。 | 901| callback | AsyncCallback\<void> | 是 | 以回调方式返回接口运行结果，可进行错误处理或其他自定义处理。 | 902 903**错误码**： 904 905| 错误码ID | 错误信息 | 906| ------- | -------- | 907| 16000050 | Internal error. | 908 909以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 910 911**示例：** 912 913```ts 914import appManager from '@ohos.app.ability.appManager'; 915import { BusinessError } from '@ohos.base'; 916 917let bundleName = 'bundleName'; 918function killProcessesByBundleNameCallback(err: BusinessError) { 919 if (err) { 920 console.error(`killProcessesByBundleNameCallback fail, err: ${JSON.stringify(err)}`); 921 } else { 922 console.log('killProcessesByBundleNameCallback success.'); 923 } 924} 925try { 926 appManager.killProcessesByBundleName(bundleName, killProcessesByBundleNameCallback); 927} catch (paramError) { 928 let code = (paramError as BusinessError).code; 929 let message = (paramError as BusinessError).message; 930 console.error(`[appManager] error: ${code}, ${message} `); 931} 932``` 933 934## appManager.killProcessesByBundleName 935 936killProcessesByBundleName(bundleName: string): Promise\<void>; 937 938通过Bundle名称终止进程。 939 940**需要权限**：ohos.permission.CLEAN_BACKGROUND_PROCESSES 941 942**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 943 944**系统API**：该接口为系统接口，三方应用不支持调用。 945 946**参数：** 947 948| 参数名 | 类型 | 必填 | 说明 | 949| -------- | -------- | -------- | -------- | 950| bundleName | string | 是 | 表示Bundle名称。 | 951 952**返回值：** 953 954| 类型 | 说明 | 955| -------- | -------- | 956| Promise\<void> | 返回执行结果。 | 957 958**错误码**： 959 960| 错误码ID | 错误信息 | 961| ------- | -------- | 962| 16000050 | Internal error. | 963 964以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 965 966**示例：** 967 968```ts 969import appManager from '@ohos.app.ability.appManager'; 970import { BusinessError } from '@ohos.base'; 971 972let bundleName = 'bundleName'; 973try { 974 appManager.killProcessesByBundleName(bundleName).then((data) => { 975 console.log('killProcessesByBundleName success.'); 976 }).catch((err: BusinessError) => { 977 console.error(`killProcessesByBundleName fail, err: ${JSON.stringify(err)}`); 978 }); 979} catch (paramError) { 980 let code = (paramError as BusinessError).code; 981 let message = (paramError as BusinessError).message; 982 console.error(`[appManager] error: ${code}, ${message} `); 983} 984``` 985 986## appManager.clearUpApplicationData 987 988clearUpApplicationData(bundleName: string, callback: AsyncCallback\<void>); 989 990通过Bundle名称清除应用数据。 991 992**需要权限**：ohos.permission.CLEAN_APPLICATION_DATA 993 994**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 995 996**系统API**：该接口为系统接口，三方应用不支持调用。 997 998**参数：** 999 1000| 参数名 | 类型 | 必填 | 说明 | 1001| -------- | -------- | -------- | -------- | 1002| bundleName | string | 是 | 表示Bundle名称。 | 1003| callback | AsyncCallback\<void> | 是 | 以回调方式返回接口运行结果，可进行错误处理或其他自定义处理。 | 1004 1005**错误码**： 1006 1007| 错误码ID | 错误信息 | 1008| ------- | -------- | 1009| 16000050 | Internal error. | 1010 1011以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 1012 1013**示例：** 1014 1015```ts 1016import appManager from '@ohos.app.ability.appManager'; 1017import { BusinessError } from '@ohos.base'; 1018 1019let bundleName = 'bundleName'; 1020function clearUpApplicationDataCallback(err: BusinessError) { 1021 if (err) { 1022 console.error(`clearUpApplicationDataCallback fail, err: ${JSON.stringify(err)}`); 1023 } else { 1024 console.log('clearUpApplicationDataCallback success.'); 1025 } 1026} 1027try { 1028 appManager.clearUpApplicationData(bundleName, clearUpApplicationDataCallback); 1029} catch (paramError) { 1030 let code = (paramError as BusinessError).code; 1031 let message = (paramError as BusinessError).message; 1032 console.error(`[appManager] error: ${code}, ${message} `); 1033} 1034``` 1035 1036## appManager.clearUpApplicationData 1037 1038clearUpApplicationData(bundleName: string): Promise\<void>; 1039 1040通过Bundle名称清除应用数据。 1041 1042**需要权限**：ohos.permission.CLEAN_APPLICATION_DATA 1043 1044**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 1045 1046**系统API**：该接口为系统接口，三方应用不支持调用。 1047 1048**参数：** 1049 1050| 参数名 | 类型 | 必填 | 说明 | 1051| -------- | -------- | -------- | -------- | 1052| bundleName | string | 是 | 表示Bundle名称。 | 1053 1054**返回值：** 1055 1056| 类型 | 说明 | 1057| -------- | -------- | 1058| Promise\<void> | 以Promise方式返回接口运行结果，可进行错误处理或其他自定义处理。 | 1059 1060**错误码**： 1061 1062| 错误码ID | 错误信息 | 1063| ------- | -------- | 1064| 16000050 | Internal error. | 1065 1066以上错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 1067 1068**示例：** 1069 1070```ts 1071import appManager from '@ohos.app.ability.appManager'; 1072import { BusinessError } from '@ohos.base'; 1073 1074let bundleName = 'bundleName'; 1075try { 1076 appManager.clearUpApplicationData(bundleName).then((data) => { 1077 console.log('clearUpApplicationData success.'); 1078 }).catch((err: BusinessError) => { 1079 console.error(`clearUpApplicationData fail, err: ${JSON.stringify(err)}`); 1080 }); 1081} catch (paramError) { 1082 let code = (paramError as BusinessError).code; 1083 let message = (paramError as BusinessError).message; 1084 console.error(`[appManager] error: ${code}, ${message} `); 1085} 1086``` 1087 1088## appManager.getProcessMemoryByPid<sup>10+</sup> 1089 1090getProcessMemoryByPid(pid: number, callback: AsyncCallback\<number>): void; 1091 1092通过pid查询对应进程占用的内存大小。 1093 1094**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 1095 1096**系统API**：此接口为系统接口。 1097 1098**参数：** 1099 1100| 参数名 | 类型 | 必填 | 说明 | 1101| -------- | -------- | -------- | -------- | 1102| pid | number | 是 | 表示进程id，详情参考[getRunningProcessInfoByBundleName](js-apis-app-ability-appManager.md#appmanagergetrunningprocessinfobybundlename10)。 | 1103| callback | AsyncCallback\<number> | 是 | 以回调方式返回接口运行结果及进程占用的内存大小（单位KB），可进行错误处理或其他自定义处理。 | 1104 1105**错误码**： 1106 1107以下错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 1108 1109| 错误码ID | 错误信息 | 1110| ------- | -------- | 1111| 16000050 | Internal error. | 1112 1113**示例：** 1114 1115```ts 1116import appManager from '@ohos.app.ability.appManager'; 1117import { BusinessError } from '@ohos.base'; 1118 1119let pid = 0; 1120function getProcessMemoryByPidCallback(err: BusinessError, data: number) { 1121 if (err) { 1122 console.error(`getProcessMemoryByPidCallback fail, err: ${JSON.stringify(err)}`); 1123 } else { 1124 console.log('getProcessMemoryByPidCallback success.'); 1125 } 1126} 1127try { 1128 appManager.getProcessMemoryByPid(pid, getProcessMemoryByPidCallback); 1129} catch (paramError) { 1130 let code = (paramError as BusinessError).code; 1131 let message = (paramError as BusinessError).message; 1132 console.error(`[appManager] error: ${code}, ${message} `); 1133} 1134``` 1135 1136## appManager.getProcessMemoryByPid<sup>10+</sup> 1137 1138getProcessMemoryByPid(pid: number): Promise\<number>; 1139 1140通过pid查询对应进程占用的内存大小。 1141 1142**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 1143 1144**系统API**：此接口为系统接口。 1145 1146**参数：** 1147 1148| 参数名 | 类型 | 必填 | 说明 | 1149| -------- | -------- | -------- | -------- | 1150| pid | number | 是 | 表示进程id，详情参考[getRunningProcessInfoByBundleName](js-apis-app-ability-appManager.md#appmanagergetrunningprocessinfobybundlename10)。 | 1151 1152**返回值：** 1153 1154| 类型 | 说明 | 1155| -------- | -------- | 1156| Promise\<number> | 以Promise方式返回接口运行结果及进程占用的内存大小（单位KB），可进行错误处理或其他自定义处理。 | 1157 1158**错误码**： 1159 1160以下错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 1161 1162| 错误码ID | 错误信息 | 1163| ------- | -------- | 1164| 16000050 | Internal error. | 1165 1166**示例：** 1167 1168```ts 1169import appManager from '@ohos.app.ability.appManager'; 1170import { BusinessError } from '@ohos.base'; 1171 1172let pid = 0; 1173try { 1174 appManager.getProcessMemoryByPid(pid).then((data) => { 1175 console.log('getProcessMemoryByPid success.'); 1176 }).catch((err: BusinessError) => { 1177 console.error(`getProcessMemoryByPid fail, err: ${JSON.stringify(err)}`); 1178 }); 1179} catch (paramError) { 1180 let code = (paramError as BusinessError).code; 1181 let message = (paramError as BusinessError).message; 1182 console.error(`[appManager] error: ${code}, ${message} `); 1183} 1184``` 1185 1186## appManager.getRunningProcessInfoByBundleName<sup>10+</sup> 1187 1188getRunningProcessInfoByBundleName(bundleName: string, callback: AsyncCallback\<Array\<ProcessInformation>>): void; 1189 1190通过bundleName获取有关运行进程的信息。 1191 1192**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 1193 1194**系统API**：此接口为系统接口。 1195 1196**参数：** 1197 1198| 参数名 | 类型 | 必填 | 说明 | 1199| -------- | -------- | -------- | -------- | 1200| bundleName | string | 是 | 表示Bundle名称。 | 1201| callback | AsyncCallback\<Array\<[ProcessInformation](js-apis-inner-application-processInformation.md)>> | 是 | 以回调方式返回接口运行结果及有关运行进程的信息，可进行错误处理或其他自定义处理。 | 1202 1203**错误码**： 1204 1205以下错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 1206 1207| 错误码ID | 错误信息 | 1208| ------- | -------- | 1209| 16000050 | Internal error. | 1210 1211**示例：** 1212 1213```ts 1214import appManager from '@ohos.app.ability.appManager'; 1215import { BusinessError } from '@ohos.base'; 1216 1217let bundleName = "bundleName"; 1218function getRunningProcessInfoByBundleNameCallback(err: BusinessError, data: appManager.Array<ProcessInformation>) { 1219 if (err) { 1220 console.error(`getRunningProcessInfoByBundleNameCallback fail, err: ${JSON.stringify(err)}`); 1221 } else { 1222 console.log('getRunningProcessInfoByBundleNameCallback success.'); 1223 } 1224} 1225try { 1226 appManager.getRunningProcessInfoByBundleName(bundleName, getRunningProcessInfoByBundleNameCallback); 1227} catch (paramError) { 1228 let code = (paramError as BusinessError).code; 1229 let message = (paramError as BusinessError).message; 1230 console.error(`[appManager] error: ${code}, ${message} `); 1231} 1232``` 1233 1234## appManager.getRunningProcessInfoByBundleName<sup>10+</sup> 1235 1236getRunningProcessInfoByBundleName(bundleName: string): Promise\<Array\<ProcessInformation>>; 1237 1238通过bundleName获取有关运行进程的信息。 1239 1240**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 1241 1242**系统API**：此接口为系统接口。 1243 1244**参数：** 1245 1246| 参数名 | 类型 | 必填 | 说明 | 1247| -------- | -------- | -------- | -------- | 1248| bundleName | string | 是 | 表示Bundle名称。 | 1249 1250**返回值：** 1251 1252| 类型 | 说明 | 1253| -------- | -------- | 1254| Promise\<Array\<[ProcessInformation](js-apis-inner-application-processInformation.md)>> | 以Promise方式返回接口运行结果及有关运行进程的信息，可进行错误处理或其他自定义处理。 | 1255 1256**错误码**： 1257 1258以下错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 1259 1260| 错误码ID | 错误信息 | 1261| ------- | -------- | 1262| 16000050 | Internal error. | 1263 1264**示例：** 1265 1266```ts 1267import appManager from '@ohos.app.ability.appManager'; 1268import { BusinessError } from '@ohos.base'; 1269 1270let bundleName = "bundleName"; 1271try { 1272 appManager.getRunningProcessInfoByBundleName(bundleName).then((data) => { 1273 console.log('getRunningProcessInfoByBundleName success.'); 1274 }).catch((err: BusinessError) => { 1275 console.error(`getRunningProcessInfoByBundleName fail, err: ${JSON.stringify(err)}`); 1276 }); 1277} catch (paramError) { 1278 let code = (paramError as BusinessError).code; 1279 let message = (paramError as BusinessError).message; 1280 console.error(`[appManager] error: ${code}, ${message} `); 1281} 1282``` 1283 1284## appManager.getRunningProcessInfoByBundleName<sup>10+</sup> 1285 1286getRunningProcessInfoByBundleName(bundleName: string, userId: number, callback: AsyncCallback\<Array\<ProcessInformation>>): void; 1287 1288通过bundleName和userId获取有关运行进程的信息。 1289 1290**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 1291 1292**系统API**：此接口为系统接口。 1293 1294**参数：** 1295 1296| 参数名 | 类型 | 必填 | 说明 | 1297| -------- | -------- | -------- | -------- | 1298| bundleName | string | 是 | 表示Bundle名称。 | 1299| userId | number | 是 | 表示用户Id。 | 1300| callback | AsyncCallback\<Array\<[ProcessInformation](js-apis-inner-application-processInformation.md)>> | 是 | 以回调方式返回接口运行结果及有关运行进程的信息，可进行错误处理或其他自定义处理。 | 1301 1302**错误码**： 1303 1304以下错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 1305 1306| 错误码ID | 错误信息 | 1307| ------- | -------- | 1308| 16000050 | Internal error. | 1309 1310**示例：** 1311 1312```ts 1313import appManager from '@ohos.app.ability.appManager'; 1314import { BusinessError } from '@ohos.base'; 1315 1316let bundleName = "bundleName"; 1317let userId = 0; 1318function getRunningProcessInfoByBundleNameCallback(err: BusinessError, data: Array<appManager.ProcessInformation>) { 1319 if (err) { 1320 console.error(`getRunningProcessInfoByBundleNameCallback fail, err: ${JSON.stringify(err)}`); 1321 } else { 1322 console.log('getRunningProcessInfoByBundleNameCallback success.'); 1323 } 1324} 1325try { 1326 appManager.getRunningProcessInfoByBundleName(bundleName, userId, getRunningProcessInfoByBundleNameCallback); 1327} catch (paramError) { 1328 let code = (paramError as BusinessError).code; 1329 let message = (paramError as BusinessError).message; 1330 console.error(`[appManager] error: ${code}, ${message} `); 1331} 1332``` 1333 1334## appManager.getRunningProcessInfoByBundleName<sup>10+</sup> 1335 1336getRunningProcessInfoByBundleName(bundleName: string, userId: number): Promise\<Array\<ProcessInformation>>; 1337 1338通过bundleName和userId获取有关运行进程的信息。 1339 1340**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 1341 1342**系统API**：此接口为系统接口。 1343 1344**参数：** 1345 1346| 参数名 | 类型 | 必填 | 说明 | 1347| -------- | -------- | -------- | -------- | 1348| bundleName | string | 是 | 表示Bundle名称。 | 1349| userId | number | 是 | 表示用户Id。 | 1350 1351**返回值：** 1352 1353| 类型 | 说明 | 1354| -------- | -------- | 1355| Promise\<Array\<[ProcessInformation](js-apis-inner-application-processInformation.md)>> | 以Promise方式返回接口运行结果及有关运行进程的信息，可进行错误处理或其他自定义处理。 | 1356 1357**错误码**： 1358 1359以下错误码详细介绍请参考[errcode-ability](../errorcodes/errorcode-ability.md)。 1360 1361| 错误码ID | 错误信息 | 1362| ------- | -------- | 1363| 16000050 | Internal error. | 1364 1365**示例：** 1366 1367```ts 1368import appManager from '@ohos.app.ability.appManager'; 1369import { BusinessError } from '@ohos.base'; 1370 1371let bundleName = "bundleName"; 1372let userId = 0; 1373try { 1374 appManager.getRunningProcessInfoByBundleName(bundleName, userId).then((data) => { 1375 console.log('getRunningProcessInfoByBundleName success.'); 1376 }).catch((err: BusinessError) => { 1377 console.error(`getRunningProcessInfoByBundleName fail, err: ${JSON.stringify(err)}`); 1378 }); 1379} catch (paramError) { 1380 let code = (paramError as BusinessError).code; 1381 let message = (paramError as BusinessError).message; 1382 console.error(`[appManager] error: ${code}, ${message} `); 1383} 1384``` 1385 1386## ApplicationState 1387 1388应用状态，该类型为枚举，可配合[AbilityStateData](js-apis-inner-application-appStateData.md)返回相应的应用状态。 1389 1390**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 1391 1392**系统API**: 此接口为系统接口，三方应用不支持调用。 1393 1394| 名称 | 值 | 说明 | 1395| -------------------- | --- | --------------------------------- | 1396| STATE_CREATE | 1 | 当应用在创建中的时候处于的状态。 | 1397| STATE_FOREGROUND | 2 | 当应用切换到前台的时候处于的状态。 | 1398| STATE_ACTIVE | 3 | 当应用在获焦的时候处于的状态。 | 1399| STATE_BACKGROUND | 4 | 当应用处于后台不可见时处于的状态。 | 1400| STATE_DESTROY | 5 | 当应用在销毁的时候处于的状态。 | 1401 1402## ProcessState<sup>10+</sup> 1403 1404进程状态，该类型为枚举，可配合[ProcessData](js-apis-inner-application-processData.md)返回相应的进程状态。 1405 1406**系统能力**：SystemCapability.Ability.AbilityRuntime.Core 1407 1408| 名称 | 值 | 说明 | 1409| -------------------- | --- | --------------------------------- | 1410| STATE_CREATE | 0 | 当进程在创建中的时候处于的状态。 | 1411| STATE_FOREGROUND | 1 | 当进程切换到前台的时候处于的状态。 | 1412| STATE_ACTIVE | 2 | 当进程在获焦的时候处于的状态。 | 1413| STATE_BACKGROUND | 3 | 当进程处于后台不可见时处于的状态。 | 1414| STATE_DESTROY | 4 | 当进程在销毁的时候处于的状态。 | 1415<!--no_check--> 1416