学习背景与动机

此前我一直在考虑系统性地学习移动端开发。在设备与工具层面，我的电脑中已经安装过 Android Studio 以及 DevEco Studio，但始终停留在“环境已装、实践未起”的状态（同时环境不是特别干净，问题也可能不一样）。

最近注意到 开源鸿蒙跨平台开发挑战活动，其中 Flutter for OpenHarmony（flutter-oh） 作为一个成熟度较高、社区持续推进的跨端方案，正好可以作为我进入移动与鸿蒙生态的切入点。因此，借此机会，跟团学习。

一方面可以更深入理解 Flutter 在 OpenHarmony 上的适配结构；
另一方面也为后续参与开源贡献打基础。

👉 环境配置参考（官方版本）：
鸿蒙版 Flutter 环境 3.32 版本搭建指南（Mac 版）

部署过程

1. Flutter for OpenHarmony 源码准备

本次实践采用 flutter-oh 官方维护的 Flutter 源码分支，对应 OpenHarmony 适配版本。

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

整个仓库体积较大，注意网络 🛜

2. 初步认识 flutter-oh 工具链

完成切换分支后，直接使用仓库内置的 Flutter 工具进行验证：

./bin/flutter -v
./bin/flutter --version

可以看到当前环境信息如下：

Flutter 3.32.4-ohos-0.0.1 • channel [user-branch] • https://gitcode.com/openharmony-tpc/flutter_flutter
Framework • revision ad11efe621 (2 days ago) • 2026-01-16 11:11:15 +0800
Engine • revision 8cd19e509d (7 months ago) • 2025-06-12 16:30:12 -0700
Tools • Dart 3.8.1 • DevTools 2.45.1

•	Flutter：3.32.4-ohos-0.0.1
•	Dart：3.8.1
•	Engine：基于定制 revision
•	DevTools：2.45.1

这一步非常关键，它确认了 flutter-oh 是一套自洽的工具链，同时你的下载没问题。

3. 使用 flutter doctor 检查环境依赖

接下来运行：

./bin/flutter doctor -v

这是整个 Day 1 中最关键、也是按需部署、可能“踩坑”的一部分。

3.1 Flutter 本体相关提示

•	当前分支属于 非官方 channel（user-branch）
•	flutter / dart 未加入 PATH
•	upstream 仓库非官方 flutter.dev

这些在 flutter-oh 场景下是预期行为，属于可忽略警告。

3.2 HarmonyOS Toolchain 问题

核心报错为：✗ Ohpm is missing, please configure "ohpm" to the environment variable PATH.
同时我在配置环境变量时遇到过：no such file or directory: export TOOL_HOME=...

最终确认原因是：
👉 环境变量脚本文件使用了 Windows 的 CRLF（\r\n）换行符
👉 macOS / Linux 下需要 LF（\n）

我使用 vim 进行修正 :set ff=unix
修正后，HarmonyOS Toolchain 状态变为 [✓]。

3.3 iOS Toolchain 补全

iOS 侧主要问题是 Xcode 安装不完整 + CocoaPods 缺失。

sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -runFirstLaunch
xcodebuild -downloadPlatform iOS

CocoaPods 安装过程中，sudo gem install cocoapods 遇到网络 404，最终改为：

brew install cocoapods

3.4 Android Toolchain 修复

Android 侧主要是：
• cmdline-tools 缺失
• SDK license 未接受
通过 更新 Android Studio 并执行：

	flutter doctor --android-licenses

当前总结

到此为止：
• ✅ Flutter for OpenHarmony 源码成功拉取与运行
• ✅ Flutter 工具链构建完成
• ✅ HarmonyOS / Android / iOS 环境全部打通

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