harmony 鸿蒙ProcessData

2025-06-12
浏览 (3)

ProcessData

The ProcessData module defines process data. If a lifecycle change listener is registered by calling on, the onProcessCreated callback in ApplicationStateObserver is invoked when the lifecycle of an application or ability changes.

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.

Modules to Import

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

Properties

System capability: SystemCapability.Ability.AbilityRuntime.Core

Name	Type	Mandatory	Description
pid	number	Yes	Process ID.
bundleName	string	Yes	Bundle name of the application.
uid	number	Yes	UID of the application.
isContinuousTask	boolean	Yes	Whether the task is a continuous task. The value true means that the task is a continuous task, and false means the opposite.
isKeepAlive	boolean	Yes	Whether the process is a resident task. The value true means that the process is a resident, and false means the opposite.
state	number	Yes	Application state. The options are as follows: 0: newly created. 1: ready. 2: running in the foreground. 4: running in the background. 5: terminated.

Example

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

let observerCode = appManager.on('applicationState', {
  onForegroundApplicationChanged(appStateData) {
    console.log(`onForegroundApplicationChanged, appStateData: ${JSON.stringify(appStateData)}.`);
  },
  onAbilityStateChanged(abilityStateData) {
    console.log(`onAbilityStateChanged, abilityStateData: ${JSON.stringify(abilityStateData)}.`);
  },
  onProcessCreated(processData) {
    console.log(`onProcessCreated, processData: ${JSON.stringify(processData)}.`);
  },
  onProcessDied(processData) {
    console.log(`onProcessDied, processData: ${JSON.stringify(processData)}.`);
  },
  onProcessStateChanged(processData) {
    console.log(`onProcessStateChanged, processData.pid : ${JSON.stringify(processData.pid)}.`);
    console.log(`onProcessStateChanged, processData.bundleName : ${JSON.stringify(processData.bundleName)}.`);
    console.log(`onProcessStateChanged, processData.uid : ${JSON.stringify(processData.uid)}.`);
    console.log(`onProcessStateChanged, processData.isContinuousTask : ${JSON.stringify(processData.isContinuousTask)}.`);
    console.log(`onProcessStateChanged, processData.isKeepAlive : ${JSON.stringify(processData.isKeepAlive)}.`);
  },
  onAppStarted(appStateData) {
    console.log(`onAppStarted, appStateData: ${JSON.stringify(appStateData)}.`);
  },
  onAppStopped(appStateData) {
    console.log(`onAppStopped, appStateData: ${JSON.stringify(appStateData)}.`);
  }
});