Flutter笔记：Flutter的应用生命周期状态（lifecycleState）管理

AppLifecycleState? currentLifecycleState = WidgetsBinding.instance.lifecycleState;
print("Current Lifecycle State: $currentLifecycleState");

/// 一个用于监听应用程序生命周期状态并相应地更新UI颜色的组件。
class LifecycleWatcher extends StatefulWidget {
  @override
  _LifecycleWatcherState createState() => _LifecycleWatcherState();
}
class _LifecycleWatcherState extends State<LifecycleWatcher> with WidgetsBindingObserver {
  Color _color = Colors.green;
  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addObserver(this);
    // 当组件初始化时，将自身添加为应用生命周期状态的观察者。
  }
  @override
  void dispose() {
    WidgetsBinding.instance.removeObserver(this);
    super.dispose();
    // 在组件被销毁时，确保将自身从应用生命周期状态的观察者中移除，以防止内存泄漏。
  }
  @override
  void didChangeAppLifecycleState(AppLifecycleState state) {
    if (state == AppLifecycleState.resumed) {
      // 当应用程序从后台切换到前台时，更新颜色为红色。
      setState(() {
        _color = Colors.red;
      });
    } else {
      // 当应用程序不在前台时，更新颜色为绿色。
      setState(() {
        _color = Colors.green;
      });
    }
  }
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Container(
        color: _color,
      ),
    );
  }
}

/// 一个用于监视应用程序生命周期状态并更新计数器的组件。
class LifecycleWatcher extends StatefulWidget {
  @override
  _LifecycleWatcherState createState() => _LifecycleWatcherState();
}
class _LifecycleWatcherState extends State<LifecycleWatcher> with WidgetsBindingObserver {
  Timer _timer;  // 用于定时更新计数器的计时器
  int _counter = 0;  // 用于存储计数器的当前值
  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addObserver(this);
    // 在组件初始化时，将自身添加为应用生命周期状态的观察者，并启动计时器。
    _startTimer();
  }
  @override
  void dispose() {
    WidgetsBinding.instance.removeObserver(this);
    _timer?.cancel();
    super.dispose();
    // 在组件被销毁时，确保将自身从应用生命周期状态的观察者中移除，并取消计时器以避免内存泄漏。
  }
  void _startTimer() {
    _timer = Timer.periodic(Duration(seconds: 1), (timer) {
      setState(() {
        _counter++;  // 每秒更新计数器的值
      });
    });
  }
  @override
  void didChangeAppLifecycleState(AppLifecycleState state) {
    if (state == AppLifecycleState.inactive) {
      _timer?.cancel();  // 当应用程序状态变为不活动时，取消计时器以停止计数器的更新。
    } else if (state == AppLifecycleState.resumed) {
      _startTimer();  // 当应用程序状态变为恢复时，重新启动计时器以继续更新计数器。
    }
  }
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: Text('Counter: $_counter'),  // 显示计数器的当前值
      ),
    );
  }
}

/// 一个用于监视应用程序生命周期状态并在应用程序暂停时保存数据的组件。
class LifecycleWatcher extends StatefulWidget {
  @override
  _LifecycleWatcherState createState() => _LifecycleWatcherState();
}
class _LifecycleWatcherState extends State<LifecycleWatcher> with WidgetsBindingObserver {
  String _dataToSave = 'Some data'; // 用于保存的数据
  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addObserver(this);
    // 在组件初始化时，将自身添加为应用生命周期状态的观察者。
  }
  @override
  void dispose() {
    WidgetsBinding.instance.removeObserver(this);
    super.dispose();
    // 在组件被销毁时，确保将自身从应用生命周期状态的观察者中移除。
  }
  Future<void> _saveData() async {
    // 模拟保存数据的操作，例如将数据写入存储或云端
    await Future.delayed(Duration(seconds: 2));
    print('Data saved: $_dataToSave'); // 打印保存的数据
  }
  @override
  void didChangeAppLifecycleState(AppLifecycleState state) {
    if (state == AppLifecycleState.paused) {
      // 当应用程序状态变为暂停时，触发数据保存操作。
      _saveData();
    }
  }
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: Text('App lifecycle demo'), // 显示应用程序生命周期演示的文本
      ),
    );
  }
}

/// 一个用于监视应用程序生命周期状态并在应用程序进入“detached”状态时进行记录的组件。
class LifecycleWatcher extends StatefulWidget {
  @override
  _LifecycleWatcherState createState() => _LifecycleWatcherState();
}
class _LifecycleWatcherState extends State<LifecycleWatcher> with WidgetsBindingObserver {
  @override
  void initState() {
    super.initState();
    WidgetsBinding.instance.addObserver(this);
    // 在组件初始化时，将自身添加为应用生命周期状态的观察者。
  }
  @override
  void dispose() {
    WidgetsBinding.instance.removeObserver(this);
    super.dispose();
    // 在组件被销毁时，确保将自身从应用生命周期状态的观察者中移除。
  }
  @override
  void didChangeAppLifecycleState(AppLifecycleState state) {
    if (state == AppLifecycleState.detached) {
      // 当应用程序状态变为“detached”时，记录应用程序处于“detached”状态。
      print('App is in detached state');
    }
  }
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: Text('App lifecycle demo'), // 显示应用程序生命周期演示的文本
      ),
    );
  }
}

class MyObserver extends WidgetsBindingObserver {
  @override
  void didChangeAppLifecycleState(AppLifecycleState state) {
    if (state == AppLifecycleState.paused) {
      // App在后台
      // ...
    } else if (state == AppLifecycleState.resumed) {
      // 应用程序在前台
      // ...
    }
  }
}
// Add the observer
WidgetsBinding.instance.addObserver(MyObserver());

import 'package:flutter/material.dart';
class MyObserver extends WidgetsBindingObserver {
  @override
  void didChangeAppLifecycleState(AppLifecycleState state) {
    if (state == AppLifecycleState.paused) {
      // 应用程序进入后台
      print("App is in the background");
      // 在这里可以执行保存数据、停止定时器等后台操作
    } else if (state == AppLifecycleState.resumed) {
      // 应用程序进入前台
      print("App is in the foreground");
      // 在这里可以执行恢复UI、启动定时器等前台操作
    }
  }
}
class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text("App Lifecycle Example"),
        ),
        body: Center(
          child: Text("Hello, Flutter!"),
        ),
      ),
    );
  }
  @override
  void didChangeDependencies() {
    super.didChangeDependencies();
    // 在这里添加观察者，监听应用程序生命周期变化
    WidgetsBinding.instance.addObserver(MyObserver());
  }
}
void main() {
  runApp(MyApp());
}

/// 表示应用程序在运行时可能存在的状态。
///
/// 当平台不支持的状态在支持的状态之间转换时，框架会合成这些状态，以使所有实现共享相同的状态机。
///
/// 状态的初始值为[detached]状态，一旦从平台接收到第一个生命周期更新，通常会更新为[resumed]状态。
///
/// 基于历史和名称冲突的原因，Flutter的应用程序状态名称与所有平台上的状态名称并不一一对应。例如，在Android上，当操作系统调用
/// [`Activity.onPause`](https://developer.android.com/reference/android/app/Activity#onPause()) 时，Flutter将进入[inactive]
/// 状态，但当Android调用
/// [`Activity.onStop`](https://developer.android.com/reference/android/app/Activity#onStop()) 时，Flutter将进入[paused]状态。
/// 请参阅各个状态的文档，了解它们在每个平台上的含义。
///
/// 当前应用程序状态可以从[SchedulerBinding.instance.lifecycleState]获取，状态的更改可以通过创建[AppLifecycleListener]来观察，也可以通过
/// 使用[WidgetsBindingObserver]通过覆盖[WidgetsBindingObserver.didChangeAppLifecycleState]方法来观察。
///
/// 应用程序不应依赖于始终接收到所有可能的通知。
///
/// 例如，如果应用程序使用任务管理器被终止，接收到终止信号，用户断开设备电源，或者设备发生快速的非计划拆卸，那么在应用程序突然终止之前将不会发送任何通知，某些状态可能会被跳过。
///
/// 另请参阅：
///
/// * [AppLifecycleListener]，用于观察生命周期状态变化的对象。
/// * [WidgetsBindingObserver]，用于从小部件层观察生命周期状态的机制。
/// * iOS的[IOKit活动生命周期](https://developer.apple.com/documentation/uikit/app_and_environment/managing_your_app_s_life_cycle?language=objc)
///   文档。
/// * Android的[活动生命周期](https://developer.android.com/guide/components/activities/activity-lifecycle)
///   文档。
/// * macOS的[AppKit活动生命周期](https://developer.apple.com/documentation/appkit/nsapplicationdelegate?language=objc)
///   文档。
enum AppLifecycleState {
  /// 应用程序仍由Flutter引擎托管，但已分离，不附加到任何宿主视图。
  ///
  /// 在初始化之前，应用程序默认处于此状态，并且可以在所有视图都已分离后（仅限Android和iOS）处于此状态。
  ///
  /// 当应用程序处于此状态时，引擎正在运行，但没有视图。
  ///
  /// 只有在iOS和Android上进入此状态，尽管在所有平台上在应用程序开始运行之前它是默认状态。
  detached,
  /// 在所有平台上，此状态表示应用程序处于具有输入焦点并可见的运行应用程序的默认运行模式。
  ///
  /// 在Android上，此状态对应于Flutter宿主视图具有焦点（[`Activity.onWindowFocusChanged`](https://developer.android.com/reference/android/app/Activity#onWindowFocusChanged(boolean)) 传递为true），
  /// 同时处于Android的"resumed"状态。如果应用程序失去焦点（[`Activity.onWindowFocusChanged`](https://developer.android.com/reference/android/app/Activity#onWindowFocusChanged(boolean))
  /// 传递为false），但尚未调用[`Activity.onPause`](https://developer.android.com/reference/android/app/Activity#onPause())，则Flutter应用程序可能处于[inactive]状态。
  ///
  /// 在iOS和macOS上，这对应于应用程序在前台活动状态运行。
  resumed,
  /// 应用程序的至少一个视图可见，但没有输入焦点。应用程序在其他方面正常运行。
  ///
  /// 在非Web桌面平台上，这对应于处于非前台的应用程序，但仍具有可见的窗口。
  ///
  /// 在Web上，这对应于在没有输入焦点的窗口或选项卡中运行的应用程序。
  ///
  /// 在iOS和macOS上，此状态对应于在前台不活动状态运行的Flutter宿主视图。当在通话时，响应TouchID请求，进入应用程序切换器或控制中心，或UIViewController托管Flutter应用程序正在过渡时，应用程序会转换到此状态。
  ///
  /// 在Android上，这对应于在Android的暂停状态下运行的Flutter宿主视图（即已调用[`Activity.onPause`](https://developer.android.com/reference/android/app/Activity#onPause())），
  /// 或在Android的"resumed"状态下运行的Flutter宿主视图，但没有窗口焦点。应用程序转换到此状态的示例包括应用程序部分被遮挡，或者其他活动被关注，分屏上运行的应用程序不是当前应用程序，被电话呼叫中断的应用程序，画中画应用程序，系统对话框，其他视图。
  /// 当通知窗口遮挡或应用程序切换器可见时，它也将处于不活动状态。
  ///
  /// 在Android和iOS上，处于此状态的应用程序应该假定它们随时可能被[hidden]和[paused]。
  inactive,
  /// 应用程序的所有视图都隐藏，这可能是因为应用程序即将被暂停（在iOS和Android上），或者因为应用程序已被最小化或放在不可见的桌面上（在非Web桌面上），
  /// 或者因为应用程序在不可见的窗口或选项卡中运行（在Web上）。
  ///
  /// 为了使所有平台上的状态机保持一致，当从[inactive]状态切换到[paused]状态之前，合成了一个过渡状态，在从[paused]状态切换到[inactive]状态之前也是如此。这允许跨平台实现只编写一个处理程序，用于知道应用程序何时在概念上是"隐藏"的。
  hidden,
  /// 应用程序当前不可见给用户，并且不响应用户输入。
  ///
  /// 当应用程序处于此状态时，引擎不会调用[PlatformDispatcher.onBeginFrame]和[PlatformDispatcher.onDrawFrame]回调。
  ///
  /// 只有在iOS和Android上进入此状态。
  paused,
}