Flutter在鸿蒙系统实现持久化存储的适配方案

鲸晚好梦

1. 项目背景与需求分析

在开发开源鸿蒙（OpenHarmony）跨平台应用时，实现用户关注和收藏功能是一个常见的需求场景。这类功能通常需要持久化存储用户的操作数据，以便下次打开应用时能够保持状态。Flutter作为跨平台开发框架，其官方提供的shared_preferences插件原本只支持Android、iOS等主流平台，但在鸿蒙系统上使用时却遇到了兼容性问题。

这个项目的核心目标是解决在鸿蒙系统上使用Flutter实现持久化存储的技术方案，特别是针对用户关注和收藏这类轻量级数据的存储需求。我们需要一个既能在鸿蒙系统上稳定运行，又能保持Flutter跨平台特性的解决方案。

2. 技术选型与架构设计

2.1 存储方案对比

在Flutter生态中，针对不同规模的数据存储需求，通常有以下几种解决方案：

SharedPreferences：适合存储简单的键值对数据，如用户设置、登录状态、收藏列表等
SQLite：适合存储结构化数据，支持复杂查询
文件存储：适合存储大量非结构化数据
云端存储：适合需要多设备同步的数据

对于关注/收藏功能这种只需要存储少量ID列表的场景，SharedPreferences是最合适的选择。它轻量、易用，且性能开销小。

2.2 系统架构设计

整个功能的实现采用了典型的三层架构：

code复制业务层 (UI)
│
服务层 (PersistenceStorage)
│
存储层 (SharedPreferences)

这种分层设计的好处是：

业务层只需关注交互逻辑，不直接处理存储细节
服务层封装了所有存储操作，提供简洁的API
存储层可以灵活替换，不影响上层逻辑

3. 鸿蒙平台适配方案

3.1 官方插件的局限性

Flutter官方提供的shared_preferences插件（2.2.3版本）默认不支持鸿蒙系统。当直接使用官方插件时，会抛出MissingPluginException异常，这是因为插件缺少鸿蒙平台的本地实现代码。

3.2 三种适配方案对比

经过实践测试，我们总结了三种可行的适配方案：

方案一：直接使用官方Pub版shared_preferences

优点：配置简单
缺点：完全不支持鸿蒙系统，运行时崩溃
结论：不可行

方案二：依赖鸿蒙适配版的Git远程仓库

优点：官方维护，版本较新
缺点：国内网络环境下可能下载失败
配置示例：

yaml复制dependencies:
  shared_preferences:
    git:
      url: "https://gitcode.com/openharmony-tpc/flutter_packages.git"
      path: "packages/shared_preferences/shared_preferences"

方案三：下载离线包进行本地依赖

优点：不受网络影响，稳定性高
缺点：需要手动更新版本
实施步骤：

从鸿蒙官方仓库下载适配好的插件包
将包放入项目指定目录
修改pubspec.yaml使用本地路径依赖

3.3 推荐方案与实施细节

对于国内开发者，推荐采用方案三（离线包方式），具体操作如下：

访问鸿蒙官方仓库(https://atomgit.com/openharmony-tpc/flutter_packages)，下载shared_preferences和shared_preferences_ohos两个包
在项目根目录创建third_party文件夹，将下载的包放入
修改pubspec.yaml配置：

yaml复制dependencies:
  shared_preferences:
    path: ./third_party/shared_preferences

执行flutter pub get完成依赖安装

注意：确保下载的插件版本与你的Flutter SDK版本兼容。如果遇到问题，可以尝试切换不同的版本分支。

4. 核心功能实现

4.1 数据模型设计

针对关注用户和收藏仓库两个功能，我们设计了以下数据存储格式：

dart复制// 关注用户列表的存储键
final _followedUsersKey = 'followed_users';

// 收藏仓库列表的存储键  
final _starredReposKey = 'starred_repositories';

两个列表都使用List类型存储，元素为对应的用户ID或仓库ID。

4.2 服务层封装

我们创建了PersistenceStorage类来封装所有存储操作，提供简洁的API给业务层使用。

4.2.1 初始化SharedPreferences实例

dart复制static Future<SharedPreferences> _getPrefs() async {
  return await SharedPreferences.getInstance();
}

4.2.2 关注用户功能实现

dart复制static Future<void> followUser(String username) async {
  final prefs = await _getPrefs();
  final followed = prefs.getStringList(_followedUsersKey) ?? [];
  if (!followed.contains(username)) {
    followed.add(username);
    await prefs.setStringList(_followedUsersKey, followed);
  }
}

4.2.3 检查关注状态

dart复制static Future<bool> isFollowingUser(String username) async {
  final prefs = await _getPrefs();
  final followed = prefs.getStringList(_followedUsersKey) ?? [];
  return followed.contains(username);
}

4.2.4 取消关注

dart复制static Future<void> unfollowUser(String username) async {
  final prefs = await _getPrefs();
  final followed = prefs.getStringList(_followedUsersKey) ?? [];
  followed.remove(username);
  await prefs.setStringList(_followedUsersKey, followed);
}

收藏仓库的功能实现与上述关注功能类似，只是使用了不同的存储键。

4.3 UI层集成

在UI层，我们只需要调用PersistenceStorage提供的API即可：

dart复制// 点击关注按钮
ElevatedButton(
  onPressed: () async {
    if (await PersistenceStorage.isFollowingUser(user.id)) {
      await PersistenceStorage.unfollowUser(user.id);
    } else {
      await PersistenceStorage.followUser(user.id);
    }
    setState(() {});
  },
  child: FutureBuilder(
    future: PersistenceStorage.isFollowingUser(user.id),
    builder: (context, snapshot) {
      return Text(snapshot.data == true ? '已关注' : '关注');
    },
  ),
)