ApplicationStateObserver

The ApplicationStateObserver module defines an observer to listen for application state changes. It can be used as an input parameter in registerApplicationStateObserver to listen for lifecycle changes of the current application.

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.app.ability.appManager';

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
onForegroundApplicationChanged AppStateData AsyncCallback<void> Yes No Callback invoked when the foreground or background state of an application changes.
onAbilityStateChanged AbilityStateData AsyncCallback<void> Yes No Callback invoked when the ability state changes.
onProcessCreated ProcessData AsyncCallback<void> Yes No Callback invoked when a process is created.
onProcessDied ProcessData AsyncCallback<void> Yes No Callback invoked when a process is destroyed.
onProcessStateChanged9+ ProcessData AsyncCallback<void> Yes No Callback invoked when the process state is changed.

Example

let applicationStateObserver = {
    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 onProcessStateChanged: ' +  JSON.stringify(processData));
    }
};
let observerCode = appManager.registerApplicationStateObserver(applicationStateObserver);