Flutter 应用生命周期：使用 AppLifecycleListener 阻止应用崩溃

当我刚开始进行 Flutter 开发时，应用生命周期（App Life Cycle）感觉就像一个神秘的黑盒子。为什么我点击 Home 键时我的计时器会停止？为什么我恢复应用时相机有时会崩溃？朋友们，答案就在于应用生命周期。

欢迎关注我的微信公众号：OpenFlutter，感谢。

作为一名 Flutter 开发者，掌握应用生命周期不仅仅是一个好主意——它是构建专业应用的必不可少的条件。它能让你防止应用崩溃、节省用户的电量，并保护他们宝贵的数据。

本指南将详细解析这些关键状态，并使用 AppLifecycleListener 给你一个完整、现代的示例。

为什么生命周期很重要：“Paused” 状态陷阱

忘记“hello world”吧——你需要管理的最重要的单个状态是 paused（暂停）。

1. show (启动/变得可见)

• 类比： 你正走进一个房间。🚶
• 简单解释： 当你的应用首次启动，或者从后台返回并实际在屏幕上绘制其像素时发生。这是用户可以再次看到你的 UI 的那一刻。

2. resume (活动且就绪)

• 类比： 你完全清醒并正在说话。🗣️
• 简单解释： 应用完全处于前台，可见，并主动接收触摸输入和运行代码。这是正常的、完全运行的状态。你希望你的繁重工作（如动画或网络轮询）在这里运行。

3. hide (被遮盖)

• 类比： 有人把一块大宣传板放在你面前。🖼️
• 简单解释： 应用正在运行，但它被其他东西完全遮挡了，比如系统警报、隐私屏幕或另一个应用叠加层。它还没有进入后台，但用户看不到它。你应该停止绘制，但保持核心功能就绪。

4. inactive (短暂暂停)

• 类比： 电话铃响了，你冻结在句子中间。📞
• 简单解释： 这是一个临时的、短暂的暂停。应用是可见的，但它失去了焦点，无法接收触摸。它通常发生在应用即将进入后台之前（例如，当你点击 Home 按钮时），或者当一个系统级事件（比如来电或系统权限对话框）弹出时。

5. pause (在后台)

• 类比： 你离开了房间并关上了门。🚪
• 简单解释： 应用完全处于后台且不再可见。它仍存在于手机内存中，但处于休眠状态。这是你的警告！ 当你看到这个状态时，你必须保存用户数据并停止任何耗费资源的活动（如相机或 GPS），因为手机可能随时会终止你的应用以释放资源。

6. detach (正在关闭)

• 类比： 房子正在被推土机夷平。💥
• 简单解释： 这是最终状态。Flutter 框架正在被销毁并从操作系统的视图中移除。应用即将被终止并从内存中清除。这是你进行任何少量日志记录或清理的最后机会。

7. restart (进程重新启动)

• 类比： 你瞬间被传送回起点。🔄
• 简单解释： 这个状态通常意味着整个应用程序进程被操作系统终止（要么是用户手动操作，要么是由于内存不足自动终止），而现在它正在从头开始重新启动。一切都从头开始（就像 show 和 resume）。如果应用之前处于 pause 状态被终止，但用户随后试图将其重新唤醒，你就会看到这个状态。

典型的流程（进入主屏幕并返回）

1. resume（活动）
2. inactive（短暂中断）
3. pause（在后台 — 关键的清理时间！）
4. （… 应用保持在这里，直到操作系统需要内存 …）
5. show（返回前台）
6. resume（再次活动）

陷阱（The Trap）

如果当应用进入 paused 状态时，你仍然让相机或大规模、活跃的网络同步运行，操作系统 (OS) 会将你的应用标记为资源占用者。然后，操作系统可以在没有警告的情况下终止你的应用以释放资源给其他应用。你将丢失用户数据，用户也会遇到崩溃。管理生命周期就是你防止这种情况发生的方式。

分步实现：AppLifecycleListener

第 1 步：设置根 Widget

此步骤定义了应用程序的入口点，并建立了基本的 Widget 树。

1void main() {
2  runApp(const MyApp());
3}
4
5class MyApp extends StatelessWidget {
6  const MyApp({super.key});
7
8  @override
9  Widget build(BuildContext context) {
10    return const MaterialApp(
11      home: Scaffold(body: AppLifecycleDisplay()),
12    );
13  }
14}
15

第 2 步：定义 AppLifecycleDisplay Widget

此步骤建立一个 StatefulWidget 来管理和跟踪生命周期事件，因为日志记录和 UI 更新都需要改变状态。

1class AppLifecycleDisplay extends StatefulWidget {
2  const AppLifecycleDisplay({super.key});
3
4  @override
5  State<AppLifecycleDisplay> createState() => _AppLifecycleDisplayState();
6}
7

第 3 步：在 initState 中设置监听器

initState 方法是实例化 AppLifecycleListener 并配置它来监听所有可能事件的地方。

1late final AppLifecycleListener _listener;
2  final ScrollController _scrollController = ScrollController();
3  final List<String> _states = <String>[];
4  late AppLifecycleState? _state;
5
6  @override
7  void initState() {
8    super.initState();
9    _state = SchedulerBinding.instance.lifecycleState;
10    _listener = AppLifecycleListener(
11      onShow: () => _handleTransition('show'),
12      onResume: () => _handleTransition('resume'),
13      onHide: () => _handleTransition('hide'),
14      onInactive: () => _handleTransition('inactive'),
15      onPause: () => _handleTransition('pause'),
16      onDetach: () => _handleTransition('detach'),
17      onRestart: () => _handleTransition('restart'),
18      onStateChange: _handleStateChange,
19    );
20    if (_state != null) {
21      _states.add(_state!.name);
22    }
23  }
24
25  void _handleTransition(String name) {
26    setState(() {
27      _states.add(name);
28    });
29    _scrollController.animateTo(
30      _scrollController.position.maxScrollExtent,
31      duration: const Duration(milliseconds: 200),
32      curve: Curves.easeOut,
33    );
34  }
35
36  void _handleStateChange(AppLifecycleState state) {
37    setState(() {
38      _state = state;
39    });
40  }
41
42

第 4 步：在 dispose 中清理资源

监听器会在 dispose 方法中被停止和释放，以防止内存泄漏。对于 Flutter widget 中任何可释放的资源来说，这是一个关键的最佳实践。

1@override
2  void dispose() {
3    _listener.dispose();
4    super.dispose();
5  }
6

第 5 步：构建用户界面

此步骤定义了视觉布局，用于显示当前状态和历史日志。

1@override
2  Widget build(BuildContext context) {
3    return MaterialApp(
4      debugShowCheckedModeBanner: false,
5      home: Scaffold(
6        appBar: AppBar(
7          title: const Text('App LifeCycle State'),
8          elevation: 0,
9        ),
10        body: Center(
11          child: SizedBox(
12            width: 300,
13            child: SingleChildScrollView(
14              controller: _scrollController,
15              child: Column(
16                children: <Widget>[
17                  Text('Current State: ${_state ?? 'Not initialized yet'}'),
18                  const SizedBox(height: 30),
19                  Text('State History:\n  ${_states.join('\n  ')}'),
20                ],
21              ),
22            ),
23          ),
24        ),
25      ),
26    );
27  }
28

完整代码

1
2import 'package:flutter/material.dart';
3import 'package:flutter/scheduler.dart';
4
5void main() {
6  runApp(const MyApp());
7}
8
9class MyApp extends StatelessWidget {
10  const MyApp({super.key});
11
12  @override
13  Widget build(BuildContext context) {
14    return const MaterialApp(
15      home: Scaffold(body: AppLifecycleDisplay()),
16    );
17  }
18}
19
20class AppLifecycleDisplay extends StatefulWidget {
21  const AppLifecycleDisplay({super.key});
22
23  @override
24  State<AppLifecycleDisplay> createState() => _AppLifecycleDisplayState();
25}
26
27class _AppLifecycleDisplayState extends State<AppLifecycleDisplay> {
28  late final AppLifecycleListener _listener;
29  final ScrollController _scrollController = ScrollController();
30  final List<String> _states = <String>[];
31  late AppLifecycleState? _state;
32
33  @override
34  void initState() {
35    super.initState();
36    _state = SchedulerBinding.instance.lifecycleState;
37    _listener = AppLifecycleListener(
38      onShow: () => _handleTransition('show'),
39      onResume: () => _handleTransition('resume'),
40      onHide: () => _handleTransition('hide'),
41      onInactive: () => _handleTransition('inactive'),
42      onPause: () => _handleTransition('pause'),
43      onDetach: () => _handleTransition('detach'),
44      onRestart: () => _handleTransition('restart'),
45      onStateChange: _handleStateChange,
46    );
47    if (_state != null) {
48      _states.add(_state!.name);
49    }
50  }
51
52  void _handleTransition(String name) {
53    setState(() {
54      _states.add(name);
55    });
56    _scrollController.animateTo(
57      _scrollController.position.maxScrollExtent,
58      duration: const Duration(milliseconds: 200),
59      curve: Curves.easeOut,
60    );
61  }
62
63  void _handleStateChange(AppLifecycleState state) {
64    setState(() {
65      _state = state;
66    });
67  }
68
69  @override
70  void dispose() {
71    _listener.dispose();
72    super.dispose();
73  }
74
75  @override
76  Widget build(BuildContext context) {
77    return MaterialApp(
78      debugShowCheckedModeBanner: false,
79      home: Scaffold(
80        appBar: AppBar(
81          title: const Text('App LifeCycle State'),
82          elevation: 0,
83        ),
84        body: Center(
85          child: SizedBox(
86            width: 300,
87            child: SingleChildScrollView(
88              controller: _scrollController,
89              child: Column(
90                children: <Widget>[
91                  Text('Current State: ${_state ?? 'Not initialized yet'}'),
92                  const SizedBox(height: 30),
93                  Text('State History:\n  ${_states.join('\n  ')}'),
94                ],
95              ),
96            ),
97          ),
98        ),
99      ),
100    );
101  }
102}
103

最后的思考：去测试一下吧！

现在来进行真正的测试：

1. 运行你的应用。状态应该是 resumed（恢复）。
2. 按下 Home 键：观察日志快速转换，经历 inactive（非活动）、paused（暂停），并可能经历 hidden（隐藏）。
3. 返回应用：观察它转换回来，经历 inactive（非活动）回到 resumed（恢复）。

理解这些转换，并将你的清理代码放置在 paused 代码块内，是一个优秀的 Flutter 开发者的标志。正是这一点，将一个业余项目与一个能经受住真实用户手机严格考验的应用区分开来。

生命周期管理愉快！如果你有任何问题，请在下方留言。我很乐意随时提供帮助！

《Flutter 应用生命周期：使用 AppLifecycleListener 阻止应用崩溃》 是转载文章，点击查看原文。