• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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 { BusinessError } from '@kit.BasicServicesKit';
32
33try {
34  let bundleName = "ohos.samples.etsclock";
35  appManager.getRunningMultiAppInfo(bundleName)
36    .then((info: appManager.RunningMultiAppInfo) => {
37      console.info(`getRunningMultiAppInfo success, data: ${JSON.stringify(info)}`);
38    }).catch((err: BusinessError) => {
39    console.error(`getRunningMultiAppInfo failed, code: ${err.code}, msg:${err.message}`);
40  })
41} catch (err) {
42  let code = (err as BusinessError).code;
43  let msg = (err as BusinessError).message;
44  console.error(`getRunningMultiAppInfo error, code: ${code}, msg:${msg}`);
45}
46```
47