harmony 鸿蒙RunningMultiInstanceInfo (System API)

2025-06-12
浏览 (138)

RunningMultiInstanceInfo (System API)

The RunningMultiInstanceInfo module defines the information of a multi-instance application in the running state.

NOTE

The initial APIs of this module are supported since API version 14. 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	Read-Only	Optional	Description
instanceKey	string	Yes	No	Unique instance ID of a multi-instance application.
uid	number	Yes	No	UID of the application.
pids	Array<number>	Yes	No	Process ID set of the application.

How to Use

The RunningMultiInstanceInfo struct is obtained from getRunningMultiAppInfo of appManager.

Example

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

try {
  let bundleName = "ohos.samples.etsclock";
  appManager.getRunningMultiAppInfo(bundleName).then((info: appManager.RunningMultiAppInfo) => {
      hilog.info(0x0000, 'testTag', `getRunningMultiAppInfo success`);
    }).catch((err: BusinessError) => {
      hilog.error(0x0000, 'testTag', `getRunningMultiAppInfo error, code: ${err.code}, msg:${err.message}`);
    })
} catch (err) {
  hilog.error(0x0000, 'testTag', `getRunningMultiAppInfo error, code: ${err.code}, msg:${err.message}`);
}