AbilityStateData

AbilityStateData是Ability状态信息的数据结构。使用on注册生命周期变化监听后，可以通过ApplicationStateObserver的onAbilityStateChanged回调的入参获取该数据结构。

说明：

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

导入模块

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

AbilityStateData

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

名称	类型	只读	可选	说明
pid	number	否	否	进程ID。
bundleName	string	否	否	应用Bundle名称。
abilityName	string	否	否	Ability名称。
uid	number	否	否	所属应用程序的UID。
state	number	否	否	Ability状态。 - Stage模型：UIAbility的状态参见UIAbility状态；ExtensionAbility的状态参见ExtensionAbility状态。 - FA模型：参见Ability状态。
moduleName	string	否	否	Ability所属的模块名称。
abilityType	number	否	否	Ability类型：UIAbility或ExtensionAbility等。
isAtomicService	boolean	否	否	判断Ability所属应用是否为原子化服务。 true: 是原子化服务。 false: 不是原子化服务。
appCloneIndex	number	否	是	应用包的分身索引标识。

UIAbility状态

值	状态	说明
0	ABILITY_STATE_CREATE	UIAbility正在创建中。
1	ABILITY_STATE_READY	UIAbility已创建完成。
2	ABILITY_STATE_FOREGROUND	UIAbility处于前台。
3	ABILITY_STATE_FOCUS	UIAbility已获得焦点。
4	ABILITY_STATE_BACKGROUND	UIAbility处于后台。
5	ABILITY_STATE_TERMINATED	UIAbility已经销毁。

ExtensionAbility状态

值	状态	说明
0	EXTENSION_STATE_CREATE	ExtensionAbility正在创建中。
1	EXTENSION_STATE_READY	ExtensionAbility已创建完成。
2	EXTENSION_STATE_CONNECTED	ExtensionAbility已与客户端建立连接。
3	EXTENSION_STATE_DISCONNECTED	ExtensionAbility与客户端断开连接。
4	EXTENSION_STATE_TERMINATED	ExtensionAbility已经销毁。

Ability状态

值	状态	说明
0	ABILITY_STATE_CREATE	Ability正在创建中。
1	ABILITY_STATE_READY	Ability已创建完成。
2	ABILITY_STATE_FOREGROUND	Ability处于前台。
3	ABILITY_STATE_FOCUS	Ability已获得焦点。
4	ABILITY_STATE_BACKGROUND	Ability处于后台。
5	ABILITY_STATE_TERMINATED	Ability已经销毁。
7	ABILITY_STATE_CONNECTED	后台服务已被客户端连接。
8	ABILITY_STATE_DISCONNECTED	后台服务与客户端断开连接。

Ability类型

值	状态	说明
0	UNKNOWN	未知类型。（系统错误）
1	PAGE	UI界面类型的Ability，即UIAbility。
2	SERVICE	后台服务类型的Ability。（FA模型）
3	DATA	数据类型的Ability。（FA模型）
4	FORM	卡片类型的Ability。（FA模型）
5	EXTENSION	扩展类型的Ability。（Stage模型）