harmony 鸿蒙ProcessInformation

2025-06-12
浏览 (3)

ProcessInformation

ProcessInformation模块提供对进程运行信息进行查询的能力。

说明：

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

导入模块

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

属性

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

名称	类型	只读	可选	说明
pid	number	否	否	进程ID。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。
uid	number	否	否	用户ID。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。
processName	string	否	否	进程名称。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。
bundleNames	Array<string>	否	否	进程中所有运行的Bundle名称。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。
state¹⁰⁺	appManager.ProcessState	否	否	当前进程运行状态。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。
bundleType¹²⁺	bundleManager.BundleType	否	否	当前进程运行的包类型。原子化服务API：从API version 12开始，该接口支持在原子化服务中使用。
appCloneIndex¹²⁺	number	否	是	分身应用索引。原子化服务API：从API version 12开始，该接口支持在原子化服务中使用。

使用说明

通过appManager的getRunningProcessInformation来获取。

示例：

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

appManager.getRunningProcessInformation((error, data) => {
  if (error) {
    console.error(`getRunningProcessInformation fail, error: ${JSON.stringify(error)}`);
  } else {
    console.log(`getRunningProcessInformation success, data: ${JSON.stringify(data)}`);
  }
});