已有Flutter项目适配鸿蒙6

已有Flutter项目适配鸿蒙6

环境准备

HarmonyOS 开发环境

Flutter 环境管理工具FVM （安装方式网上有很多）

官方Flutter

使用FVM安装鸿蒙版的Flutter

前往鸿蒙flutter官方仓库可以发现他的标签已经支持到3.27.5，但这不是一个正式版，但是他是目前最新的版本了

接下来，我们需要下载项目，并将其切到 3.27.5-ohos-1.0.1 标签

# 将目录先切换到FVM的版本路径
cd /XXX/fvm/versions

# 下载仓库 
git clone https://gitcode.com/openharmony-sig/flutter_flutter.git 

# 切换到 3.22.1-ohos-1.0.0 标签 
cd flutter_flutter 
git checkout 3.27.5-ohos-1.0.1

完成后查看Flutter版本

在命令行执行

fvm list

会看到我们安装后的鸿蒙版本SDK

使用我们安装的鸿蒙Flutter

切换到我们的项目中来使用 鸿蒙版的Flutter，这里如果你的工程使用了git 托管，我建议另起一个分支来处理鸿蒙适配

接下来，切换到项目根目录下，运行以下命令使用刚刚安装的 Flutter SDK：（注意，如果弹出一些提醒，一路 yes 即可：）

fvm use  3.27.5-ohos-1.0.1

改造我们的工程来适配鸿蒙

如果你的工程使用了git 托管，我建议另起一个分支来处理鸿蒙适配 下面我们使用鸿蒙版的Flutter来为我们的项目创建 ohos 文件夹：

# 建议先在这里确认一下你的 当前flutter sdk有没有切换成功
flutter --version

# 如果没有切换可以执行 fvm use 指令来切换到鸿蒙Flutter

# 执行命令创建ohos文件
flutter create --platforms ohos .  //这行最好这里有个点.

# 如果上面这个命令不好用 可以试试
fvm flutter create --platforms ohos .

这样工程中就出现了ohos 文件

第三方插件的管理

对于三方插件来说，纯 Dart 的库是可以直接在鸿蒙上使用的，和平台相关的类库，需要兼容鸿蒙的库。他们不在 pub 上，而是由开源项目进行维护。有哪些插件支持了鸿蒙，可以在这个清单列表中查看 gitcode.com/openharmony…
比如我的项目中使用了 shared_preferences 就需要使用鸿蒙提供的版本，这里我们可以使用dependency_overrides 覆盖依赖，这样不会影响以前的代码结构：

在项目目录下执行一下命令 来下载依赖库

flutter pub get //或者是fvm flutter pub get

对项目进行打包运行

这时候就需要使用鸿蒙的开发 IDE了。打开DevEco-studio

使用DevEco-studio打开刚刚创建的ohos 文件夹

IDE 第一次可能会执行构建

如果有失败可以使用flutter doctor或者 fvm flutter doctor来排除一下问题

一切正常的话，来打包吧

flutter build hap --release    //或 fvm flutter build hap --release

这样项目就可以在鸿蒙上跑起来了, 打开模拟器，点击运行即可，如果是真机调试，打开开发者模式重启手机，打开USB调试，插在电脑上，这里我遇到过不识别的问题，我换了官方数据线就好了，普通安卓type-C线可能会不识别【裂开】