Flutter 设置页打开后,第一次读取就报 MissingPluginException。两次构建用的是同一份 Dart 页面,依赖包也都写着 shared_preferences 2.5.4。差异藏在 pubspec.lock 里。Pub 发行版没有鸿蒙实现,CPF-Flutter 的 Git 版则把它纳入了生成的插件清单。

这次用 flutter-library-search 找到了适配来源,也碰到一条容易误判的规则。下面按实际依赖、生成注册和重启回读三层证据复盘,读者可以把同一套判断用在其他 Flutter 插件上。

1. 把问题缩成一个能回读的设置项

实验环境为 Windows、DevEco Studio 6.1.1.460、Flutter 鸿蒙版 3.35.8-ohos-1.0.3、Dart 3.9.2,运行设备是 HarmonyOS API 24 的 x86_64 模拟器。设置页提供 15、25、40 分钟三档,只写一个键 daily_minutes。选择档位只修改当前页面的待保存值,按下「保存目标」才会调用插件。

这样做可以区分三个很容易混在一起的结果。页面改成 40 分钟,可能只是组件状态更新。按下保存后重新读取,能确认插件通道在这一轮工作。结束进程后重新打开并读回 40 分钟,才能观察跨进程恢复。对照过程中,两边都使用相同 Dart 源码、包名和 ohos-x64 构建目标。

final preferences = await SharedPreferences.getInstance();
final written = await preferences.setInt('daily_minutes', 40);
await preferences.reload();
final stored = preferences.getInt('daily_minutes');

页面还把读取异常显示出来。这样即使没有调试面板,也能同时看到当前状态和真正失败的方法名。这里选用 SharedPreferences 接口,便于保留已经存在的 Flutter 业务代码。

2. Skill 的一条判断为什么容易误判

flutter-library-search Skill 在仓库版本 27fb300b 的判断表里,把来自 flutter/packages 的官方插件概括为已适配。把这一条直接套到 shared_preferences 2.5.4,会把「社区已有可用的适配分支」和「当前 Pub 发行物已带鸿蒙实现」混为一谈。前者在这次查找中成立,后者经构建和运行验证不成立。

从 Pub 版本元数据 可以看到两个关键字段。它的 repository 指向 flutter/packages,但随 2.5.4 发布的 flutter.plugin.platforms 只列出 Android、iOS、macOS、Linux、Windows 和 Web。接着看实验里的两份锁文件,version 一样,真正拉开的区分是 source 和 resolved-ref。

核对位置Pub 版 2.5.4鸿蒙 Git 版 2.5.4
pubspec.lock 的 sourcehostedgit,固定到 19bd50ff
入口包的鸿蒙默认实现无对应声明shared_preferences_ohos
.flutter-plugins-dependencies 的 OHOS 列表空包含 shared_preferences_ohos

最后一行可以在各自项目根目录执行下面两行复查。先保存一份输出再切换依赖,这个生成文件会被下一次依赖解析覆盖。

$manifest = Get-Content .flutter-plugins-dependencies -Raw | ConvertFrom-Json
@($manifest.plugins.ohos).name

Pub 版本身通过了依赖解析和 HAP 安装。进入页面时,异常精确落在 plugins.flutter.io/shared_preferences 通道的 getAll。初始化调用就已经失败,可以先缩小排查范围。修改默认时长或者保存按钮逻辑都无法补上这个平台实现。

Pub 版进入设置页后,读取设置时显示 MissingPluginException

图 1 Pub 版进入设置页后,读取设置时显示 MissingPluginException。

3. 核对鸿蒙分支的注册链

在 CPF-Flutter 的适配仓库 里能找到 Flutter 3.35 对应的 shared_preferences-v2.5.4-ohos-1.0.1,本次固定到提交 19bd50ff6d5eaa96f18c63796c51e1b4e78a7480。先看入口包的 ohos.default_package 是否指向 shared_preferences_ohos,然后核对实现包的 pluginClass、dartPluginClass 和 ohos/index.ets。ArkTS 源码里能找到系统 Preferences 的获取与写入。这样,包名、平台声明和运行入口才串起来。

dependencies:
  flutter:
    sdk: flutter
  shared_preferences:
    git:
      url: https://gitcode.com/CPF-Flutter/flutter_packages.git
      ref: 19bd50ff6d5eaa96f18c63796c51e1b4e78a7480
      path: packages/shared_preferences/shared_preferences

dependency_overrides:
  shared_preferences_ohos:
    git:
      url: https://gitcode.com/CPF-Flutter/flutter_packages.git
      ref: 19bd50ff6d5eaa96f18c63796c51e1b4e78a7480
      path: packages/shared_preferences/shared_preferences_ohos

这里固定两处是为了重复构建时入口包和鸿蒙实现来自同一份源码。入口包本身指向一个分支,单独固定入口包仍可能让实现跟随分支变化。保留 pubspec.lock 后,也能直接看到两项依赖实际解析到的引用。

在 Windows 上,第一次尝试 Git 版时还遇到了一条完全不同的错误。Pub 在检出仓库里的其他平台示例文件时报告 Filename too long,构建甚至还没进 Hvigor。给执行这次构建的 Git 启用 core.longpaths 后重新取回依赖,再继续检查插件注册。遇到这类错误,可以先看 Git 报出了哪条本地路径。此时绕回去改通道名只会掩盖真正的失败阶段。

4. 保存、回读、结束进程再打开

flutter build hap --debug --target-platform ohos-x64 --no-codesign
hdc -t 127.0.0.1:5555 install build/ohos/hap/entry-default-unsigned.hap
hdc -t 127.0.0.1:5555 shell aa start -a EntryAbility -b com.ohosnotes.preference_probe -m entry

选择 40 分钟并保存。应用调用 reload() 后显示 40 分钟。然后结束应用进程,再启动并核对首次读回的值。

hdc -t 127.0.0.1:5555 shell aa force-stop com.ohosnotes.preference_probe
hdc -t 127.0.0.1:5555 shell aa start -a EntryAbility -b com.ohosnotes.preference_probe -m entry
检查项Pub 版 2.5.4鸿蒙 Git 版 2.5.4
构建和安装调试 HAP通过通过
鸿蒙插件生成清单无对应实现包含 shared_preferences_ohos
页面首次读取getAll 缺少通道实现正常返回
选择 40 分钟并保存读取阶段已失败显示保存并回读完成
结束进程后再次启动首次读取已失败新进程读回 40 分钟

选择 40 分钟并保存,页面显示回读完成

图 2 选择 40 分钟并保存,页面显示回读完成。

结束进程后重新启动,启动读取仍得到 40 分钟

图 3 结束进程后重新启动,启动读取仍得到 40 分钟。

5. 把 Skill 的结论改成可验证的输出

这次保留 Skill 的检索顺序,从 Pub 定位入口包,再找适配分支。需要收紧的是支持状态的判断方式。先写清楚结论对应的发行来源和版本,再分别核对「发行物声明了什么」「Flutter 实际注册了什么」「页面操作验证了什么」。同名、同版本的两个包仍要分别给结论。

下次查插件时,可以直接提供包名和版本、当前锁文件的 source、目标平台和出错的方法名。找到候选分支后,优先检查平台声明和生成清单。像这次一样遇到 MissingPluginException(getAll),就先验证是否有接收端,再读业务层的数据。

本次复现里,鸿蒙版保存 40 分钟后,从进程 29218 结束并切到新进程 1903,首次读取仍得到 40。用同样的方法验证其他本地设置项时,先选一个和初始值不同的值,观察保存结果,再用新进程读回。本文实测使用 SharedPreferences 的整数键,迁移其他接口时可以沿用这套验证顺序。

示例源码

AtomGit 示例仓库。本篇工程在 preference_probe 目录,README 内有构建和复现命令。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐