跳到主要内容

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;