AppState

AppState 可以告诉你应用当前是在前台还是后台，并在状态变化时通知你。

AppState 经常用于在处理推送通知时判断用户意图以及采取合适的行为。

App States

• active - 应用正在前台运行
• background - 应用正在后台运行。用户此时要么：
  • 在其他应用中
  • 在主屏幕上
  • [Android] 在另一个 Activity 中，包括临时的系统活动，例如自动填充凭据选择器（即使是由你的应用或系统启动）
• [iOS] inactive - 这是一个在前台和后台之间切换时，以及在诸如进入多任务视图、打开通知中心或来电等不活跃期间出现的状态。

更多信息请参见 Apple 的文档

Basic Usage

要查看当前状态，你可以检查 AppState.currentState，它会保持最新。

信息

如果你使用的是旧版架构，currentState 在启动时会是 null，直到它从原生端异步获取到为止。

这个示例看起来只会显示“当前状态是：active”，因为应用只有在 active 状态下才对用户可见。如果你想尝试这段代码，我们建议使用自己的设备，而不是嵌入式预览。

---

Reference

Events

change

当应用状态发生变化时会收到此事件。监听器会接收到 当前应用状态值 之一。

memoryWarning

iOS

当应用从操作系统收到内存警告时触发。

focus

Android

当应用获得焦点时收到（用户正在与应用交互）。

blur

Android

当用户未在积极与应用交互时收到。在用户下拉 通知栏 等情况下很有用。AppState 不会改变，但会触发 blur 事件。

Methods

addEventListener()

React TSX

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

设置一个函数，当 AppState 上指定类型的事件发生时会调用它。eventType 的有效值 列在上方。返回 EventSubscription。

Properties

currentState

React TSX

static currentState: AppStateStatus;