内容

添加 AppLifecycleState.hidden 的迁移指南

内容

摘要
上下文
更改说明
迁移指南
时间线
参考

在 AppLifecycleState 枚举中添加了一个新的 hidden 状态，用于表示应用程序不可见。

当调用 WidgetsBindingObserver.didChangeAppLifecycleState 时，AppLifecycleState 枚举用于指示应用程序处于哪个生命周期状态。

新的状态 AppLifecycleState.hidden 已添加到 dart:ui 包中的 AppLifecycleState 枚举中。

当所有应用程序视图不再对用户可见时，将进入 hidden 状态。在 Android 和 iOS 上，每当状态机从非活动状态转换到暂停状态，或从暂停状态转换到非活动状态时，都会短暂进入此状态。进入暂停或非活动状态时，它不会发生变化。在其他平台上，当应用程序不可见时，它将处于此状态。

如果代码有处理 AppLifecycleState 枚举所有情况的 switch 语句，则需要添加一个新 case 来处理 AppLifecycleState.hidden 状态。

迁移前代码

dartvoid didChangeAppLifecycleState(AppLifecycleState state) {
  switch (state) {
    case AppLifecycleState.resumed:
    case AppLifecycleState.inactive:
      // Do something when the app is visible...
      break;
    case AppLifecycleState.paused:
    case AppLifecycleState.detached:
      // Do something when the app is not visible...
      break;
  }
}

迁移后代码

dartvoid didChangeAppLifecycleState(AppLifecycleState state) {
  switch (state) {
    case AppLifecycleState.resumed:
    case AppLifecycleState.inactive:
      // Do something when the app is visible...
      break;
    case AppLifecycleState.hidden:  // <-- This is the new state.
    case AppLifecycleState.paused:
    case AppLifecycleState.detached:
      // Do something when the app is not visible...
      break;
  }
}

如果 switch 语句中已经存在 default: case，或者代码使用条件语句，那么代码将能够编译而无需更改，但是仍然需要评估 default case 或条件语句以确定是否也应该处理 hidden 状态。

包含于版本：3.11.0-16.0.pre
稳定版发布：3.13.0

摘要

上下文

更改说明

迁移指南

时间线

参考