Flutter Android 真机调试指南

Mac 上做 Flutter → 安卓真机，最精简的方案是不装 Android Studio，靠 Homebrew 把底层工具链装齐。你只需要 Flutter SDK + Xcode（iOS 那边已经搞定）+ 下面几个安卓工具即可。

1. 安装安卓工具链（按依赖顺序）

1.1 JDK 17

Gradle/Android 工具依赖 JDK，不装会卡编译：

brew install openjdk@17

Apple Silicon 把下面这行写进 ~/.zshrc：

        
      
export PATH="/opt/homebrew/opt/openjdk@17/bin:$PATH"

1.2 Android SDK Command-line Tools

包含 sdkmanager，Flutter 靠它识别 SDK：

brew install --cask android-commandlinetools

然后按 Flutter 期望的目录摆好：

        
      
export ANDROID_SDK_ROOT="$HOME/Library/Android/sdk"
mkdir -p "$ANDROID_SDK_ROOT/cmdline-tools/latest"
cp -R /opt/homebrew/Caskroom/android-commandlinetools/*/cmdline-tools/* \
      "$ANDROID_SDK_ROOT/cmdline-tools/latest/"

1.3 platform-tools（adb）

连接手机、安装安装包全靠它：

brew install android-platform-tools

1.4 SDK 平台包 + build-tools

版本按项目 minSdk 来，android-34 / 34.0.0 是常见值：

        
      
export ANDROID_SDK_ROOT="$HOME/Library/Android/sdk"
sdkmanager "platform-tools" "platforms;android-34" "build-tools;34.0.0"
flutter doctor --android-licenses   # 一路 y 同意协议

1.5 配置 PATH

在 ~/.zshrc 里补上并 source 一下：

        
      
export ANDROID_SDK_ROOT="$HOME/Library/Android/sdk"
export PATH="$PATH:$ANDROID_SDK_ROOT/platform-tools"
export PATH="$PATH:$ANDROID_SDK_ROOT/cmdline-tools/latest/bin"

2. 验证环境

flutter doctor

Android toolchain 那一行变绿就说明工具链齐了，全程没有碰 Android Studio。

3. 手机开启开发者模式

手机上进入 设置 → 关于手机 → 连点版本号 7 次，开启开发者模式
进入 开发者选项 → 打开 USB 调试
用 USB 线连接 Mac，手机弹窗点击 “允许”

4. 运行到手机

在项目目录里：

flutter devices     # 看到手机
flutter run         # 编译 + 安装到手机，支持热重载

只想出安装包也可以：

flutter build apk
adb install -r build/app/outputs/flutter-apk/app-debug.apk

5. 和 iOS 的对比

iOS：Mac + Xcode 是刚需（签名/真机离不开）
Android：Xcode 不参与，Android Studio 也只是”帮你看图形界面装 SDK 的壳”。命令行工具链（JDK + cmdline-tools + platform-tools + 对应 platform/build-tools）就是 Mac 侧的最小集，体积比 Android Studio 小非常多

阅读 — · 全站 —