ProcessData

The ProcessData module defines process data. If a lifecycle change listener is registered by calling registerApplicationStateObserver, 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 8. Newly added APIs will be marked with a superscript to indicate their earliest API version.

Modules to Import

import appManager from '@ohos.application.appManager';

Attributes

System capability: SystemCapability.Ability.AbilityRuntime.Core

System API: This is a system API and cannot be called by third-party applications.

Name	Type	Readable	Writable	Description
pid	number	Yes	No	Process ID.
bundleName	string	Yes	No	Bundle name of the application.
uid	number	Yes	No	UID of the application.
isContinuousTask⁹⁺	boolean	Yes	No	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	No	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	No	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 '@ohos.application.appManager';

let observerCode = appManager.registerApplicationStateObserver({
    onForegroundApplicationChanged(appStateData) {
        console.log(`onForegroundApplicationChanged appStateData: ${JSON.stringify(appStateData)}`);
    },
    onAbilityStateChanged(abilityStateData) {
        console.log(`onAbilityStateChanged onAbilityStateChanged: ${JSON.stringify(abilityStateData)}`);
    },
    onProcessCreated(processData) {
        console.log(`onProcessCreated onProcessCreated: ${JSON.stringify(processData)}`);
    },
    onProcessDied(processData) {
        console.log(`onProcessDied onProcessDied: ${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)}`);
    }
});