跨平台开发 / 系统课时
读取并恢复用户偏好
读取并恢复用户偏好
应用启动时需要恢复用户上一次选择的主题、语言、开关状态等轻量配置。本篇介绍如何从本地存储读取偏好数据,并在 Flutter 页面初始化阶段安全地恢复状态,让应用保持连续体验。
学习目标
- 理解 Flutter 中读取本地用户偏好的基本流程
- 掌握异步加载配置并更新页面状态的方法
- 能够处理首次运行时不存在配置的情况
在启动阶段加载本地偏好
轻量配置通常使用键值形式保存,例如主题模式、是否开启通知、用户选择的排序方式等。读取过程一般包含三个步骤:获取存储实例、根据键读取值、将结果同步到应用状态。
以 shared_preferences 为例,读取操作是异步的,因为数据可能来自设备存储。页面初始化时不能直接在构造方法中读取,而应该在生命周期方法中完成加载。
dart
import 'package:flutter/material.dart';
import 'package:shared_preferences/shared_preferences.dart';
class SettingsPage extends StatefulWidget {
const SettingsPage({super.key});
@override
State<SettingsPage> createState() => _SettingsPageState();
}
class _SettingsPageState extends State<SettingsPage> {
bool notificationsEnabled = false;
@override
void initState() {
super.initState();
_loadPreferences();
}
Future<void> _loadPreferences() async {
final prefs = await SharedPreferences.getInstance();
final savedValue = prefs.getBool('notifications_enabled');
// 首次运行没有保存值时,使用默认配置
if (!mounted) return;
setState(() {
notificationsEnabled = savedValue ?? false;
});
}
@override
Widget build(BuildContext context) {
return SwitchListTile(
title: const Text('接收通知'),
value: notificationsEnabled,
onChanged: null,
);
}
}预期结果
text
页面打开后读取本地键 notifications_enabled。
如果存在保存值,开关显示保存状态;如果不存在,使用 false 作为默认状态。处理异步恢复中的状态问题
读取偏好时需要注意页面生命周期变化。如果用户快速离开页面,异步任务完成后继续调用 setState 可能导致异常。因此更新状态前应检查 mounted。
对于较大的应用,通常不会让每个页面直接读取配置,而是由状态管理层统一加载。例如应用启动时加载用户偏好,随后通过 Provider、Riverpod 或其他状态方案向页面提供数据。
区分不存在配置和配置值为空
读取本地数据时,不存在键和值本身为空可能代表不同含义。例如:
| 情况 | 含义 | 处理方式 |
|---|---|---|
| 键不存在 | 用户首次使用应用 | 采用默认值 |
| 键存在且值为 false | 用户关闭过功能 | 保持用户选择 |
| 键存在但数据异常 | 配置损坏或版本变化 | 回退默认值 |
恢复逻辑不能简单地把所有空值都当成错误,否则会覆盖用户明确保存的设置。
什么时候适合读取用户偏好
适合读取的场景包括应用启动、进入设置页、创建需要配置的功能模块等。对于需要实时同步的数据,不应依赖本地偏好,而应该使用网络接口或数据库。
恢复用户偏好的核心是保证读取过程可靠、默认值明确,并让状态更新发生在正确的生命周期阶段。这样即使用户首次安装应用,也能获得稳定的初始体验。
按自己的节奏,确认真正理解。