跳到主要内容
新架构实战课 实操 + 基建 + 原理全维度包揽,抢先掌握 React Native 新架构精髓 立即查看 >Version: Next

AppState

AppState能告诉你应用当前是在前台还是在后台,并且能在状态变化的时候通知你。

AppState 通常在处理推送通知的时候用来决定内容和对应的行为。

App States

  • active - 应用正在前台运行
  • background - 应用正在后台运行。用户可能面对以下几种情况:
    • 在别的应用中
    • 停留在桌面
    • 对 Android 来说还可能处在另一个Activity中(即便是由你的应用拉起的)
  • [iOS] inactive - 此状态表示应用正在前后台的切换过程中,或是处在系统的多任务视图,又或是处在来电状态中。

要了解更多信息,可以阅读Apple 的文档

基本用法

要获取当前的状态,你可以使用AppState.currentState,这个变量会一直保持更新。不过在启动的过程中,currentState可能为 null,直到AppState从原生代码得到通知为止。

上面的这个例子只会显示"Current state is: active",这是因为应用只有在active状态下才能被用户看到。并且 null 状态只会在一开始的一瞬间出现。如果你想尝试这段代码,我们建议使用自己的设备而不是在上面网页中的嵌入式预览。


文档

事件

blur
Android

当用户没有主动与应用程序进行交互时收到。在用户下拉通知抽屉的情况下非常有用。AppState不会改变,但是blur事件将被触发。

change

当应用程序状态发生变化时,将接收到此事件。监听器会使用当前应用程序状态值之一来调用。

focus
Android

当应用程序获得焦点时收到(用户正在与应用程序进行交互)。

memoryWarning

这个事件用于在需要时触发内存警告或释放内存。

方法

addEventListener()

static addEventListener(
type: AppStateEvent,
listener: (state: AppStateStatus) => void,
): NativeEventSubscription;

设置一个函数,每当AppState上发生指定的事件类型时将被调用。eventType 的有效值为上面列出的事件。返回 EventSubscription

属性

currentState

static currentState: AppStateStatus;