跨平台开发 / 系统课时

读取并恢复用户偏好

读取并恢复用户偏好

应用启动时需要恢复用户上一次选择的主题、语言、开关状态等轻量配置。本篇介绍如何从本地存储读取偏好数据,并在 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 用户关闭过功能 保持用户选择
键存在但数据异常 配置损坏或版本变化 回退默认值

恢复逻辑不能简单地把所有空值都当成错误,否则会覆盖用户明确保存的设置。

什么时候适合读取用户偏好

适合读取的场景包括应用启动、进入设置页、创建需要配置的功能模块等。对于需要实时同步的数据,不应依赖本地偏好,而应该使用网络接口或数据库。

恢复用户偏好的核心是保证读取过程可靠、默认值明确,并让状态更新发生在正确的生命周期阶段。这样即使用户首次安装应用,也能获得稳定的初始体验。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

读取并恢复用户偏好

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通