欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.csdn.net

一、准备工作

          即各种前置软件的下载安装说明。

软件/工具	说明
DevEco Studio	下载网址，在华为开发官网中，下载最新版本的DecEco Studio。
JDK 17	Java官网中下载，下载网址
Git	在后面下载鸿蒙版的Flutter时，若采用git clone 的方式，则需要下载。 同时也方便后续的拉取代码。 下载网址
OpenHarmony 版 Flutter	进入该网址，下载oh-3.35.7-dev分支代码，可进行git clone 或直接下载压缩包
模拟器	在缺少真机时需要使用

        1.1 DevEco Studio 及模拟器

                在上方表格给出的DevEco Studio网址中，根据自身所用电脑系统下载对应最新版 DevEco Studio。        模拟器部分

打开DevEco Studio，创建一个项目，然后如图所示操作。

        1.2 鸿蒙版Flutter下载及Git下载

        Git下载部分

官网自行安装即可，注意需将Git配入环境变量中。

在此电脑（右键）→ 属性 → 高级系统设置 → 高级 选项卡 → 环境变量 进行环境变量的配置

在系统变量中，打开Path变量，确保他的值中有下载的git的路径。

如下图所示：

      

        鸿蒙版Flutter部分

打开终端，运行一下两行命令。

注意！！这里的两行代码运行需要有Git。

   git clone https://gitcode.com/openharmony-tpc/flutter_flutter.git
   git checkout -b dev origin/dev
 

​

下载完成后，将这个 Flutter 目录配置到你的系统环境变量中。

以上环境变量配置在后续的环境变量配置版本都会再讲。

        1.3 Java 17下载

去 Oracle 官网下载 JDK 17

二、环境变量配置

        这一个部分属于是重中之重，同时也容易出错，需要耐心慢慢来。

打开环境配置界面：此电脑（右键）→ 属性 → 高级系统设置 → 高级 选项卡 → 环境变量 进行环境变量的配置。

以下为需要进行配置的环境变量。（均在系统变量中配置）

变量	值	作用域
JAVA_HOME	<JDK path >	系统变量
Path	%JAVA_HOME%\bin	追加到现有值
TOOL_HOME	<Deveco-studio Path>	新建系统变量
DEVECO_SDK_HOME	%TOOL_HOME%\sdk	新建系统变量
Path	%TOOL_HOME%\tools\ohpm\bin	追加到现有值
Path	%TOOL_HOME%\tools\hvigor\bin	追加到现有值
Path	%TOOL_HOME%\tools\node\bin	追加到现有值
Path	<flutter_flutter Path>\bin	追加到现有值
PUB_CACHE	<PUB Path>	新建系统变量
PUB_HOSTED_URL	https://pub.flutter-io.cn	新建系统变量
FLUTTER_STORAGE_BASE_URL	https://storage.flutter-io.cn	新建系统变量
Path	<Git Path>\bin	追加到现有值
Path	<Git Path>\cmd	追加到现有值

⚠️ 重要提示：表格中的路径都需要替换成你自己电脑上的实际路径，不能直接复制表格里的内容！

其中：PUB_HOSTED_URL，FLUTTER_STORAGE_BASE_URL直接复制粘贴即可。

以下为路径查找的举例说明：如TOOL_HOME所需的<Deveco-studio Path>

要找到你电脑上的Deveco-studio存放的路径，如下图：

对应得环境变量配置应为：

flutter和JDK也是一样，%JAVA_HOME%是你JDK存放的路径，<flutter_flutter Path>是你flutter存放的路径。

其次是PuB Path这个，这个是用来储存缓存文件的，任选一个文件夹即可。

然后是环境配置的检测：

打开终端运行：

flutter doctor -v

这个命令会检查你的环境配置是否正确。如果有红色报错，根据提示信息逐一解决。

Flutter 与HarmonyOS必须要是打勾的状态！！

到这一步环境配置就已经结束了，接下来可以开始做第三方库的适配。

三、第三方库适配

查找并下载第三方库源代码

在官网中找到想要适配的第三方库，然后找到他的git仓库，将代码clone下来。

以我适配的flutter_exit_app示例：

创建Ohos项目结构

打开终端。在项目根目录下运行以下命令，使现有的 Flutter 插件项目添加 ohos 平台支持。

会在你的项目中自行添加ohos的项目结构。

flutter create . --template=plugin --platforms=ohos

配置pubspec.yaml

在你的项目目录下，找到并打开你的 pubspec.yaml 文件，在 plugin.platforms 下添加 ohos 配置

在该文件中，有一个这样的类似版本，补充如图的ohos的配置：

  plugin:
    platforms:
      android:
        package: com.laoitdev.lib.exit.app.flutter_exit_app
        pluginClass: FlutterExitAppPlugin
      ios:
        pluginClass: FlutterExitAppPlugin
      ohos:
        pluginClass: FlutterExitAppPlugin
        package: flutter_exit_app

编写 ohos 平台代码

这一步需要根据项目在 iOS 和 Android中实验，补全ohos的代码，完成鸿蒙平台的适配，通常这一步由AI进行，例如trae或cursor。

拉取依赖

打开终端运行

flutter pub get

如果出现错误，解决后再次运行该命令，直到成功执行。

在DecEco Studio中调试

这里是适配的最后一步。在 DevEco Studio 中打开 example/ohos 目录

打开模拟器进行签名！！（注意这里一定要先打开模拟器）

打开模拟器后：

自动签名完记得点击右下角的 Apply 和 确定 按钮

然后打开终端，进入到example目录下运行

flutter run

上述的步骤中，如果出现报错，或无法正常实现功能都可以直接交给ai，让ai继续迭代。

以上为本次的配置经验分享，只要你耐心仔细，跟着文档一步一步来，就一定能成功！