Flutter配置环境，运行三端- iOS、android、harmony全流程操作实践（最新）

OpenHarmony-Flutter Git官方地址： gitee.com/openharmony...

1. 环境配置（三端-iOS、android、harmony）

• 安装 Homebrew，Fvm(管理flutter版本)，Xcode（及cocoPods），Android studio，Java，DevEco studio

2. 全局配置 （.zshrc 文件）

# OpenHarmony 配置
export HOS_SDK_HOME=/Users/wm/Library/OpenHarmony/Sdk
export HDC_HOME=/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains 
# HDC 配置
export PATH=$PATH:$HDC_HOME
export PATH=$HOS_SDK_HOME/bin:$PATH


export PATH="/opt/homebrew/opt/node@18/bin:$PATH"

# Android 配置
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/tools/bin
export PATH=$PATH:$ANDROID_HOME/platform-tools


#export PATH=/bin/zsh
export PATH=$HOME/.gem/bin:$PATH
## [Completion]
## Completion scripts setup. Remove the following line to uninstall
[[ -f /Users/wm/.dart-cli-completion/zsh-config.zsh ]] && . /Users/wm/.dart-cli-completion/zsh-config.zsh || true
## [/Completion]


#依赖缓存
 export PUB_CACHE=D:/PUB(自定义路径)

 # 国内镜像
 export PUB_HOSTED_URL=https://pub.flutter-io.cn
 export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

 # 拉取下来的flutter_flutter/bin目录
 export PATH=/Users/wm/flutter_flutter/bin:$PATH

 # HamonyOS SDK
 export TOOL_HOME=/Applications/DevEco-Studio.app/Contents # mac环境
 export DEVECO_SDK_HOME=$TOOL_HOME/sdk # command-line-tools/sdk
 export PATH=$TOOL_HOME/tools/ohpm/bin:$PATH # command-line-tools/ohpm/bin
 export PATH=$TOOL_HOME/tools/hvigor/bin:$PATH # command-line-tools/hvigor/bin
 export PATH=$TOOL_HOME/tools/node/bin:$PATH # command-line-tools/tool/node/bin

# JAVA环境
export JAVA_HOME=$(/usr/libexec/java_home)
export PATH="$JAVA_HOME/bin:$PATH"

3.创建项目 （使用FVM，就使用FVM命令）

• flutter版本使用的官方推荐版本3.0.22及以上，自己根据官方版本目录查看哪些支持ohos， 我的版本为：

Flutter 3.22.1-ohos-1.0.4 • channel [user-branch] • https://gitcode.com/openharmony-tpc/flutter_flutter.git
Framework • revision c4a66f77d0 (9 周前) • 2025-07-01 10:13:30 +0800
Engine • revision f6344b75dc
Tools • Dart 3.4.0 • DevTools 2.34.1

• 对于harmony配置，一定要按照官方配置下载flutter_flutter分支，指定dev或master分支，并配置环境

git clone https://gitee.com/openharmony-sig/flutter_flutter.git

• 准备完毕使用后，使用终端 flutter doctor -v 查看当前flutter环境都OK不。

• 使用命令创建项目，然后使用Android studio打开项目。（VSCode了？都三端了，别意气用事）

flutter create  --platforms android,ios,ohos flutte090405

4.三端运行

（1）iOS

• 直接打开iOS模拟器，也可以打开Xcode选择一个版本的模拟器。

• #######注意下载CocoPods(不要问我怎么下载 -o-)####

• 没有啥难度，iOS还是叼。直接运行

（2）Android

• 这里由于我公司禁止了很多外网链接，所以我的Gradle下载失败，这里把$android/gradle/wrapper/gradle-wrapper.properties
• 中的gradle链接换成国内的。

distributionUrl=https\://services.gradle.org/distributions/gradle-7.6.3-all.zip
换成
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.12-all.zip

• 打开安卓模拟器，直接运行就OK

（2）Harmony

• 下载java环境,

brew install --cask oracle-jdk

并配置全局

# 添加到 ~/.zshrc 或 ~/.bash_profile
echo 'export JAVA_HOME=$(/usr/libexec/java_home)' >> ~/.zshrc
echo 'export PATH="$JAVA_HOME/bin:$PATH"' >> ~/.zshrc

# 使配置生效
source ~/.zshrc

• 我这里把 ohos/build-profile.json5 中的compatibleSdkVersion版本换成了5.0.0(12)，本来开始是5.1.0(18)，但是运行报错不支持这个版本，我就换低了2个版本。

 "compatibleSdkVersion": "5.0.0(12)",
换成
 "compatibleSdkVersion": "5.0.0(12)",

• 打开鸿蒙模拟器，直接运行。（这里使用Deveco-studio进行打开模拟器） 发现报错：

• 用真机调试，运行OK。模拟器不知道为什么报错