鸿蒙版 Flutter 环境 3.32 版本搭建指南（Mac 版）

DevEco Studio 6.0.0 Beta3
Build Version: 6.0.0.828, built on August 19, 2025
Runtime version: 21.0.6+8-b631.39 aarch64 (JCEF 122.1.9)
VM: OpenJDK 64-Bit Server VM by JetBrains s.r.o.
Toolkit: sun.lwawt.macosx.LWCToolkit
macOS 15.2
GC: G1 Young Generation, G1 Concurrent GC, G1 Old Generation
Memory: 1536M
Cores: 10
Metal Rendering is ON
Registry:
  idea.plugins.compatible.build=IC-243.24978.46

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

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

# 编辑zsh配置文件（推荐）
open ~/.zshrc

# 或者使用命令行编辑
nano ~/.zshrc

open ~/.bash_profile

# DevEco Studio配置
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

# Flutter路径配置（请根据实际路径修改）
export PATH=/Users/jianguo/Desktop/harmony/flutter/flutter_flutter/bin:$PATH

# Flutter镜像配置（加速下载）
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

# Flutter Git配置（解决警告）
export FLUTTER_GIT_URL=git@gitcode.com:openharmony-tpc/flutter_flutter.git

# Android SDK配置（如果需要Android开发）
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$ANDROID_HOME/tools:$PATH
export PATH=$ANDROID_HOME/platform-tools:$PATH

# 如果使用zsh
source ~/.zshrc

# 如果使用bash
source ~/.bash_profile

flutter doctor -v

Downloading darwin-arm64/font-subset tools...                      256ms
[!] Flutter (Channel [user-branch], 3.32.4-ohos-0.0.1, on macOS 15.2 24C103 darwin-arm64, locale zh-Hans-CN) [81ms]
    ! Flutter version 3.32.4-ohos-0.0.1 on channel [user-branch] at /Users/jianguo/Desktop/harmony/flutter/flutter_flutter
      Currently on an unknown channel. Run `flutter channel` to switch to an official channel.
      If that doesn't fix the issue, reinstall Flutter by following instructions at https://flutter.dev/setup.
    ! Upstream repository git@gitcode.com:openharmony-tpc/flutter_flutter.git is not a standard remote.
      Set environment variable "FLUTTER_GIT_URL" to git@gitcode.com:openharmony-tpc/flutter_flutter.git to dismiss this error.
    • Framework revision daefe215e1 (4 days ago), 2025-08-29 17:32:50 +0800
    • Engine revision 8cd19e509d
    • Dart version 3.8.1
    • DevTools version 2.45.1
    • Pub download mirror https://pub.flutter-io.cn
    • Flutter download mirror https://storage.flutter-io.cn
    • If those were intentional, you can disregard the above warnings; however it is recommended to use "git" directly to perform update checks and upgrades.

[✓] HarmonyOS toolchain - develop for HarmonyOS devices
    • OpenHarmony Sdk at /Applications/DevEco-Studio.app/Contents/sdk, available api versions has [20:default]
    • Ohpm version 5.3.1
    • Node version v18.20.1
    • Hvigorw binary at /Applications/DevEco-Studio.app/Contents/tools/hvigor/bin/hvigorw

[✗] Android toolchain - develop for Android devices [44ms]
    ✗ Unable to locate Android SDK.
      Install Android Studio from: https://developer.android.com/studio/index.html
      On first launch it will assist you in installing the Android SDK components.
      (or visit https://flutter.dev/to/macos-android-setup for detailed instructions).
      If the Android SDK has been installed to a custom location, please use
      `flutter config --android-sdk` to update to that location.

[✗] Xcode - develop for iOS and macOS [59ms]
    ✗ Xcode installation is incomplete; a full installation is necessary for iOS and macOS development.
      Download at: https://developer.apple.com/xcode/
      Or install Xcode via the App Store.
      Once installed, run:
        sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
        sudo xcodebuild -runFirstLaunch
    ✗ CocoaPods not installed.
        CocoaPods is a package manager for iOS or macOS platform code.
        Without CocoaPods, plugins will not work on iOS or macOS.
        For more info, see https://flutter.dev/to/platform-plugins
      For installation instructions, see https://guides.cocoapods.org/using/getting-started.html#installation

[✓] Chrome - develop for the web [21ms]
    • Chrome at /Applications/Google Chrome.app/Contents/MacOS/Google Chrome

[!] Android Studio (not installed) [21ms]
    • Android Studio not found; download from https://developer.android.com/studio/index.html
      (or visit https://flutter.dev/to/macos-android-setup for detailed instructions).

[✓] Connected device (2 available) [1,480ms]
    • macOS (desktop) • macos  • darwin-arm64   • macOS 15.2 24C103 darwin-arm64
    • Chrome (web)    • chrome • web-javascript • Google Chrome 139.0.7258.155

[✓] Network resources [658ms]
    • All expected network resources are available.

! Doctor found issues in 4 categories.

export FLUTTER_GIT_URL=git@gitcode.com:openharmony-tpc/flutter_flutter.git

flutter config --android-sdk /Users/jianguo/Library/Android/sdk

flutter doctor --android-licenses

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

sudo gem install cocoapods