harmony 鸿蒙ApplicationStateObserver

  • 2025-06-12
  • 浏览 (4)

ApplicationStateObserver

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

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';

ApplicationStateObserver.onForegroundApplicationChanged

onForegroundApplicationChanged(appStateData: AppStateData): void

Called when the foreground or background state of an application changes.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Parameters

Name Type Mandatory Description
appStateData AppStateData Yes Application state data.

ApplicationStateObserver.onAbilityStateChanged

onAbilityStateChanged(abilityStateData: AbilityStateData): void

Called when the ability state changes.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Parameters

Name Type Mandatory Description
abilityStateData AbilityStateData Yes Ability state data.

ApplicationStateObserver.onProcessCreated

onProcessCreated(processData: ProcessData): void

Called when a process is created.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Parameters

Name Type Mandatory Description
processData ProcessData Yes Process data.

ApplicationStateObserver.onProcessDied

onProcessDied(processData: ProcessData): void

Called when a process is destroyed.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Parameters

Name Type Mandatory Description
processData ProcessData Yes Process data.

ApplicationStateObserver.onProcessStateChanged

onProcessStateChanged(processData: ProcessData): void

Called when the process state is changed.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Parameters

Name Type Mandatory Description
processData ProcessData Yes Process data.

ApplicationStateObserver.onAppStarted

onAppStarted(appStateData: AppStateData): void

Called when the first process of the application is created.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Parameters

Name Type Mandatory Description
appStateData AppStateData Yes Application state data.

ApplicationStateObserver.onAppStopped

onAppStopped(appStateData: AppStateData): void

Called when the last process of the application is destroyed.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Parameters

Name Type Mandatory Description
appStateData AppStateData Yes Application state data.

ProcessData

type ProcessData = _ProcessData.default

Defines the process data.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Type Description
_ProcessData.default Process data.

Example

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

let applicationStateObserver: appManager.ApplicationStateObserver = {
  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: ${JSON.stringify(processData)}.`);
  },
  onAppStarted(appStateData) {
    console.log(`onAppStarted, appStateData: ${JSON.stringify(appStateData)}.`);
  },
  onAppStopped(appStateData) {
    console.log(`onAppStopped, appStateData: ${JSON.stringify(appStateData)}.`);
  }
};
let observerCode = appManager.on('applicationState', applicationStateObserver);

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Ability Kit

harmony 鸿蒙AbilityAccessControl

harmony 鸿蒙AbilityBase

harmony 鸿蒙AbilityBase_Element

harmony 鸿蒙AbilityRuntime

harmony 鸿蒙bundle

harmony 鸿蒙OH_NativeBundle_ApplicationInfo

harmony 鸿蒙OH_NativeBundle_ElementName

harmony 鸿蒙ability_access_control.h

harmony 鸿蒙ability_base_common.h

0  赞