1# RunningMultiAppInfo (系统接口)
2
3定义应用多开在运行态的结构信息。
4
5> **说明：**
6>
7> 本模块首批接口从API version 12 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
8> 本模块接口为系统接口。
9
10## 属性
11
12**系统接口**：此接口为系统接口。
13
14**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
15
16| 名称                      | 类型   | 必填  | 说明       |
17| ------------------------- | ------ | ---- | --------- |
18| bundleName | string | 是  | 应用的包名。 |
19| mode | [MultiAppMode](js-apis-inner-application-multiAppMode-sys.md) | 是   | 应用多开模式。 |
20| runningAppClones | Array<[RunningAppClone](js-apis-inner-application-runningAppClone-sys.md)> | 否  | 特定包名在运行态的分身应用信息。 |
21| runningMultiInstances<sup>14+</sup> | Array<[RunningMultiInstanceInfo](js-apis-inner-application-runningMultiInstanceInfo-sys.md)> | 否  | 特定包名在运行态的多实例应用信息。 |
22
23## 使用说明
24
25通过appManager的[getRunningMultiAppInfo](js-apis-app-ability-appManager-sys.md#appmanagergetrunningmultiappinfo12)来获取。
26
27**示例：**
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