harmony 鸿蒙ExtensionRunningInfo (系统接口)

2025-06-12
浏览 (3)

ExtensionRunningInfo (系统接口)

ExtensionRunningInfo模块封装了Extension运行的相关信息，可以通过getExtensionRunningInfos接口获取。

说明：

本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

本模块接口为系统接口。

导入模块

import { abilityManager } from '@kit.AbilityKit';

使用说明

导入abilityManager模块，通过调用abilityManager中的方法获取ExtensionRunningInfo。

属性

系统能力：SystemCapability.Ability.AbilityRuntime.Core

系统接口：此接口为系统接口。

名称	类型	只读	可选	说明
extension	ElementName	否	否	Extension信息。
pid	number	否	否	进程ID。
uid	number	否	否	应用程序的uid。
processName	string	否	否	进程名称。
startTime	number	否	否	Extension被启动时的时间戳。
clientPackage	Array<String>	否	否	表示当期进程下的所有包名。
type	ExtensionAbilityType	否	否	Extension类型。

示例：

import { abilityManager } from '@kit.AbilityKit';

let upperLimit = 1;

function getExtensionInfos() {
  abilityManager.getExtensionRunningInfos(upperLimit, (error, data) => {
    if (error) {
      console.error(`getForegroundApplications failed, error.code: ${JSON.stringify(error.code)}, error.message: ${JSON.stringify(error.message)}`);
      return;
    }

    for (let i = 0; i < data.length; i++) {
      let extensionRunningInfo = data[i];
      console.info(`extensionRunningInfo.extension: ${JSON.stringify(extensionRunningInfo.extension)}`);
      console.info(`extensionRunningInfo.pid: ${JSON.stringify(extensionRunningInfo.pid)}`);
      console.info(`extensionRunningInfo.uid: ${JSON.stringify(extensionRunningInfo.uid)}`);
      console.info(`extensionRunningInfo.processName: ${JSON.stringify(extensionRunningInfo.processName)}`);
      console.info(`extensionRunningInfo.startTime: ${JSON.stringify(extensionRunningInfo.startTime)}`);
      console.info(`extensionRunningInfo.clientPackage: ${JSON.stringify(extensionRunningInfo.clientPackage)}`);
      console.info(`extensionRunningInfo.type: ${JSON.stringify(extensionRunningInfo.type)}`);
    }
  });
}