程序包 ohos.aafwk.ability

类 Lifecycle

java.lang.Object

ohos.aafwk.ability.Lifecycle

public class Lifecycle
extends Object

Provides a class for you to observe the lifecycle of an Ability or AbilitySlice.

Ability and AbilitySlice have their own lifecycle and dispatch their lifecycle states to Lifecycle for management. You can call the Lifecycle#getLifecycleState() method to obtain their current lifecycle state or call Lifecycle#addObserver(ILifecycleObserver) to add a lifecycle observer to observe lifecycle changes in real-time. This class allows you to implement lifecycle callbacks of Ability and AbilitySlice using methods from other classes. In this way, Ability and AbilitySlice can take only their own responsibilities, enabling a decoupled application architecture.

You can call Ability#getLifecycle() and AbilitySlice#getLifecycle() to obtain Lifecycle objects.

从以下版本开始:

1

另请参阅:

Ability.getLifecycle(), AbilitySlice.getLifecycle(), ILifecycleObserver

SystemCapability

SystemCapability.Aafwk#ABILITY

嵌套类概要

嵌套类

限定符和类型	类	说明
static class	Lifecycle.Event	Indicates a lifecycle event.

构造器概要

构造器

构造器	说明
Lifecycle()

方法概要

限定符和类型	方法	说明
void	addObserver(ILifecycleObserver observer)	Adds a lifecycle observer.
void	dispatchLifecycle(Lifecycle.Event event, Intent intent)	While Ability or AbilitySlice's lifecycle changes, dispatch lifecycle event.
Lifecycle.Event	getLifecycleState()	Obtains the current lifecycle event.
void	removeObserver(ILifecycleObserver observer)	Removes a lifecycle observer.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

Lifecycle

public Lifecycle()

方法详细资料

dispatchLifecycle

public void dispatchLifecycle(Lifecycle.Event event,
                              Intent intent)

While Ability or AbilitySlice's lifecycle changes, dispatch lifecycle event.

参数:

event - Lifecycle state.

从以下版本开始:

4

addObserver

public void addObserver(ILifecycleObserver observer)

Adds a lifecycle observer.

The observer will be notified of lifecycle changes.

参数:

observer - Indicates the lifecycle observer, either LifecycleObserver or LifecycleStateObserver. The value cannot be null.

从以下版本开始:

1

另请参阅:

LifecycleObserver, LifecycleStateObserver

removeObserver

public void removeObserver(ILifecycleObserver observer)

Removes a lifecycle observer.

You are advised to call this method if you no longer need to listen to lifecycle changes. This reduces the performance loss caused by observing lifecycle changes.

参数:

observer - Indicates the lifecycle observer, either LifecycleObserver or LifecycleStateObserver. The value cannot be null.

从以下版本开始:

1

另请参阅:

LifecycleObserver, LifecycleStateObserver

getLifecycleState

public Lifecycle.Event getLifecycleState()

Obtains the current lifecycle event.

Lifecycle events drive lifecycle state changes. Therefore, you are able to know the lifecycle state once you obtain the lifecycle event. For example, if the ON_ACTIVE event is received, the ability or ability slice is in the ACTIVE state; if the ON_FOREGROUND event is received, the ability or ability slice is changing from the BACKGROUND state to INACTIVE.

返回:

Returns the current lifecycle event.

从以下版本开始:

1