• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# RunningMultiAppInfo (System API)
2
3The RunningMultiAppInfo module defines the information of an application in multi-app mode in the running state.
4
5> **NOTE**
6>
7> The initial APIs of this module are supported since API version 12. Newly added APIs will be marked with a superscript to indicate their earliest API version.
8>
9> The APIs provided by this module are system APIs.
10
11## Properties
12
13**System API**: This is a system API.
14
15**System capability**: SystemCapability.Ability.AbilityRuntime.Core
16
17| Name                     | Type  | Mandatory | Description      |
18| ------------------------- | ------ | ---- | --------- |
19| bundleName | string | Yes | Bundle name of the application.|
20| mode | [MultiAppMode](js-apis-inner-application-multiAppMode-sys.md) | Yes  | Multi-app mode.|
21| runningAppClones | Array<[RunningAppClone](js-apis-inner-application-runningAppClone-sys.md)> | No | Information about application clones with the specific bundle name in the running state.|
22
23## How to Use
24
25The **RunningMultiAppInfo** struct is obtained from [getRunningMultiAppInfo](js-apis-app-ability-appManager-sys.md#appmanagergetrunningmultiappinfo12) of **appManager**.
26
27**Example**
28
29```ts
30import { appManager } from '@kit.AbilityKit';
31import { hilog } from '@kit.PerformanceAnalysisKit';
32import { BusinessError } from '@kit.BasicServicesKit';
33
34try {
35  let bundleName = "ohos.samples.etsclock";
36  appManager.getRunningMultiAppInfo(bundleName).then((info: RunningMultiAppInfo) => {
37      hilog.info(0x0000, 'testTag', `getRunningMultiAppInfo success`);
38    }).catch((err: BusinessError) => {
39      hilog.error(0x0000, 'testTag', `getRunningMultiAppInfo error, code: ${err.code}, msg:${err.message}`);
40    })
41} catch (err) {
42  hilog.error(0x0000, 'testTag', `getRunningMultiAppInfo error, code: ${err.code}, msg:${err.message}`);
43}
44```
45