环境搭建

要在这套新生态上跑通Flutter，第一步还是把开发环境捋顺。

关键点主要有两个：工具链的版本、路径配置。踩过坑之后会发现，这些细节其实规律性很强。

1. 安装 DevEco Studio NEXT IDE

注意版本一定要选“Next”，当前最新是Beta3。

下载前需要先登录，后面创建模拟器还要走开发者验证和审核。好在审核速度还行，提交后大约两小时通过。

根据自己电脑系统选对应版本，Windows就选Windows版。安装过程很常规，一路Next直到完成。

新版的IDE已经集成了Node.js、ohpm等环境，省去了单独安装的麻烦。

2. 安装Git

如果要同时适配安卓，需要装Android Studio；适配iOS则需要Xcode。

这里只聚焦鸿蒙侧。

Mac 安装（推荐）

环境变量配置参考下面这段，注意把路径替换成你实际安装的位置：

# Flutter Mirror
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

# HarmonyOS SDK
export TOOL_HOME=/Applications/DevEco-Studio.app/Contents/
export DEVECO_SDK_HOME=$TOOL_HOME/sdk
export PATH=$TOOL_HOME/tools/ohpm/bin:$PATH
export PATH=$TOOL_HOME/tools/hvigor/bin:$PATH
export PATH=$TOOL_HOME/tools/node/bin:$PATH

Windows 安装

先配置用户变量：

FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
PUB_HOSTED_URL=https://pub.flutter-io.cn
DEVECO_SDK_HOME=C:Program FilesHuaweiDevEco Studiosdk

然后编辑PATH，添加以下路径：

C:Program FilesHuaweiDevEco Studiotoolsohpmbin
C:Program FilesHuaweiDevEco Studiotoolshvigorbin
C:Program FilesHuaweiDevEco Studiotoolsnode

管理多个 Flutter 版本

如果项目需要切换不同Flutter版本，推荐用fvm。

大致流程如下：

• 安装FVM
• 使用官方版本：fvm install 3.22.0
• 安装自定义鸿蒙版本：进入~/fvm/versions/目录，拷贝仓库并重命名为custom_x.y.z，例如：git clone -b dev https://gitee.com/openharmony-sig/flutter_flutter.git custom_3.7.12
• 在项目目录中执行：fvm use custom_3.7.12

创建运行项目

1. 检测flutter环境

运行flutter doctor -v检查环境变量是否配置正确。

如果看到类似下面的输出，说明鸿蒙工具链就绪：

[] HarmonyOS toolchain - develop for HarmonyOS devices
     OpenHarmony Sdk at E:ohosDevEcoStudiosdk, a vailable api versions has [12:default]
     Ohpm version 5.0.8-rc.1
     Node version v18.20.1
     Hvigorw binary at E:ohosDevEcoStudiotoolshvigorbinhvigorw

如果某一行报错，大概率是PATH里对应的路径没配对。

• 比如ohpm报错，检查%TOOL_HOME%toolsohpmbin是否在PATH中
• node报错同理

2. 创建flutter项目

有两种方式。方式一：只创建ohos平台——

flutter create --platforms ohos

创建完成后，先进入项目根目录编译hap包。

否则用DevEco Studio打开会报找不到flutter.har依赖：

flutter build hap --debug

3. 运行flutter项目到鸿蒙next手机

方式一：通过flutter devices发现真机设备，获取device-id后运行：

flutter run --debug -d 

方式二：先编译hap包，再手动安装：

flutter build hap --debug
hdc -t  install 

这个hdc命令类似于Android的adb install。

方式三：用DevEco Studio打开项目的ohos模块。

• 进入 File → Project Structure → Signing Configs，勾选“Automatically generate signature”，然后Apply。这会启用自动签名。第一次执行flutter build hap时也会提示签名配置。
• 创建模拟器：Device Manager → 按提示操作。不过第一次创建还需要开发者验证和审核。
• 这里有个关键点：当前模拟器只有x86架构，而通过flutter_flutter构建的鸿蒙Flutter应用只支持arm64架构。官方文档也说明了这一点。所以模拟器对Flutter应用基本没用，老老实实用真机吧。

打包项目

1. 打包测试包

flutter build hap --debug

如果需要指定自定义engine，加上--local-engine参数。例如：

flutter build hap --debug --local-engine=E:ohosflutter_imagesrcoutohos_debug_unopt_arm64

如果提示flutter.har找不到，可以从项目目录下的ohosharflutter.har拷贝一份到srcoutohos_debug_unopt_arm64目录下，再重新执行即可。

2. 打包正式包

flutter build hap --release
# 或者直接 flutter build hap

同样，如果指定engine遇到flutter.har缺失，按上述方法拷贝解决。

常见问题

运行flutter doctor时出现 Error: Unable to find git in your PATH，执行以下命令：

git config --global --add safe.directory '*'

总结

整个流程梳理下来，核心就是三个环节：

• 装对IDE版本
• 配好路径变量
• 记住签名和架构限制

鸿蒙生态还在快速迭代，这些步骤可能会随着工具版本更新而简化。

但眼下照着这个思路走，基本不会跑偏。