harmony 鸿蒙RunningMultiAppInfo (System API)

2025-06-12
浏览 (4)

RunningMultiAppInfo (System API)

The RunningMultiAppInfo module defines the information of an application in multi-app mode in the running state.

NOTE

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.

The APIs provided by this module are system APIs.

Properties

System API: This is a system API.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Name	Type	Mandatory	Description
bundleName	string	Yes	Bundle name of the application.
mode	MultiAppMode	Yes	Multi-app mode.
runningAppClones	Array<RunningAppClone>	No	Information about application clones with the specific bundle name in the running state.
runningMultiInstances¹⁴⁺	Array<RunningMultiInstanceInfo>	No	Information about a multi-instance application with the specific bundle name in the running state.

How to Use

The RunningMultiAppInfo struct is obtained from getRunningMultiAppInfo of appManager.

Example

import { appManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

try {
  let bundleName = "ohos.samples.etsclock";
  appManager.getRunningMultiAppInfo(bundleName)
    .then((info: appManager.RunningMultiAppInfo) => {
      console.info(`getRunningMultiAppInfo success, data: ${JSON.stringify(info)}`);
    }).catch((err: BusinessError) => {
    console.error(`getRunningMultiAppInfo failed, code: ${err.code}, msg:${err.message}`);
  })
} catch (err) {
  let code = (err as BusinessError).code;
  let msg = (err as BusinessError).message;
  console.error(`getRunningMultiAppInfo error, code: ${code}, msg:${msg}`);
}