鸿蒙纪·Flutter卷#02 | 已有 Flutter 项目鸿蒙化 · 3.27.4 版

0.缘起

最近看到了鸿蒙应用开发者激励计划 2025，力度非常大。感觉可以把之前的 Flutter 项目打包成鸿蒙，上架走一波。首先想到了我的开源项目: RegExpo, 文本正则匹配器。我就给它起个名字叫 正则通 吧，然后让 ChatGPT 给画个牛气轰轰的 logo 图标，走起 ~

移动端 - 亮	移动端 - 暗

接下来两篇文章，就来探索一下，个人开发者，如何把一个 Flutter 项目，上架到鸿蒙商店。本文主要介绍如何把已有的 Flutter 项目鸿蒙化。

1. 鸿蒙 Flutter 环境 · 3.27.X

写上一篇《鸿蒙纪·Flutter卷#01》时，鸿蒙最新的 Flutter 环境是 3.22.1,目前最新的 tag 已经支持 Flutter 3.27.X 了。一些环境配置方面的东西就不赘述了，可以参考上一篇。

这也是我一直在使用的 Flutter SDK 版本，正好来试一波能不能用。首先通过 git 更新鸿蒙 SDK，然后切到 3.27.5-ohos-0.1.0-beta 标签：

git pull

git checkout 3.27.5-ohos-0.1.0-beta

2.已有 Flutter 项目，支持鸿蒙

RegExpo 是目前已有的 flutter 项目，目前还不支持鸿蒙，下面就来一起改造吧~

使用鸿蒙的 flutter sdk 以后就将其称为 [h] flutter, 在当前项目下，创建 ohos 项目：

$h$ flutter create --platforms ohos .

3. 三方插件的改造

对于三方插件来说，纯 Dart 的库是可以直接在鸿蒙上使用的。比如 RegExpo中用到的 flutter_bloc、dio、flutter_slidable 等 :

而像 path_provider、sqflite 这样和平台相关的类库，需要兼容鸿蒙的库。他们不在 pub 上，而是由开源项目进行维护。有哪些插件支持了鸿蒙，可以在这个清单列表中查看: 《openharmony平台已兼容库》

在使用时，建议通过 dependency_overrides 覆盖依赖，这样不会影响以前的代码结构：

yaml 复制代码

dependency_overrides:
  sqflite:
    git:
      url: "https://gitee.com/openharmony-sig/flutter_sqflite.git"
      path: "sqflite"
      ref: master
      
  sqflite_common_ffi:
    git:
      url: "https://gitee.com/openharmony-sig/flutter_sqflite.git"
      path: "sqflite_common_ffi"
      ref: master
      
  file_picker:
    git: "https://gitee.com/openharmony-sig/fluttertpc_file_picker.git"
    
  path_provider:
    git:
      url: "https://gitcode.com/openharmony-tpc/flutter_packages.git"
      path: "packages/path_provider/path_provider"

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

在项目文件夹下执行 flutter pub get，就可以看到 lock 文件中对应插件已经变成了支持鸿蒙版。