【Flutter】Mac上Flutter环境配置(android)

在新 Mac 上配置 Flutter 和 Android Studio 环境的完整流程，用来搭建开发环境（适用于 Dart/Flutter 开发，包括 Android/iOS）：

✅ 第一步：安装基本工具

1. 安装 Homebrew（Mac 包管理器）

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

然后添加 brew 到 path（根据提示可能需要加上）

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

2. 安装 Flutter SDK

brew install --cask flutter

你也可以选择手动安装：Flutter官网安装方式

安装后添加环境变量（如果你是手动安装）：

export PATH="$PATH:[你的 flutter/bin 路径]"

3. 安装 Git（Flutter 依赖 Git）

brew install git

✅ 第二步：配置 Flutter 环境

1. 运行 flutter doctor 检查环境

flutter doctor

根据输出内容逐项解决，确保都为绿色 ✅。会提示你缺少哪些依赖，比如 Android Studio、Xcode 等。

✅ 第三步：安装 Android Studio

1. 安装 Android Studio

brew install --cask android-studio

或者官网下载：https://developer.android.com/studio

2. 打开 Android Studio 并进行首次配置：

安装 Android SDK（首次打开会提示安装）
安装 Android Emulator（可选）
安装 Flutter 插件（Android Studio 中 Preferences → Plugins → 搜索并安装 Flutter，同时会自动安装 Dart）

✅ 第四步：配置 Android SDK 环境变量

打开终端，配置 .zshrc 或 .bash_profile（依据你使用的 shell）：

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

然后运行：

source ~/.zshrc  # 或 source ~/.bash_profile

✅ 第五步：配置 Xcode（如果你需要 iOS 开发）

1. 安装 Xcode

从 App Store 安装

2. 安装命令行工具

xcode-select --install

3. 同意 Xcode License

sudo xcodebuild -license

✅ 第六步：创建一个 Flutter 项目测试

flutter create hello_flutter
cd hello_flutter
flutter run

✅ 可选工具推荐

VSCode（轻量级开发 Flutter 的好选择）：

brew install --cask visual-studio-code

iOS 模拟器调试：通过 Xcode → Open Simulator
Android 模拟器：Android Studio → AVD Manager 创建模拟器

🧩 小贴士

建议安装 Rosetta（对于某些基于 Intel 构建的工具）：

softwareupdate --install-rosetta

查看所有可用设备（调试）：

flutter devices

清理缓存/依赖：

flutter clean
flutter pub get

如你有 Apple Developer 帐号，记得后续还需要配置 code signing（用于真机调试和上架）。

iOS 安装 pod 命令

使用 Homebrew 安装

如果你已经安装了 Homebrew，也可以使用以下命令：

brew install cocoapods

下面是原版：

根据一般的 Flutter 开发流程，在 macOS 系统上为 Flutter 项目打包 Android APK 的步骤如下：

安装必要的软件：
- Flutter SDK：
  - 从 Flutter 官网下载最新版本的 Flutter SDK。
  - 解压后，将 Flutter 的路径添加到系统的环境变量中，例如：
```
export PATH="$PATH:/path/to/flutter/bin"
```
  - 在终端中运行 flutter doctor，确保 Flutter 安装正确，并根据提示安装任何缺失的依赖项。
- Android Studio：
  - 从 Android Studio 下载并安装。
  - 打开 Android Studio，安装必要的组件，如 Android SDK、Android SDK Command-line Tools 和 Android Virtual Device (AVD)。
  - 在 Android Studio 的设置中，配置 Android SDK 的路径，并确保 adb 命令可用。
- Java 环境：
  - 确保安装了合适版本的 JDK（推荐使用 JDK 11）。
  - 在终端中运行 java -version 检查 JDK 是否正确安装。
  - 如果未安装，可使用 Homebrew 安装：
```
brew install openjdk@11
```
配置 Flutter 项目：
- 在终端中导航到您的 Flutter 项目目录。
- 运行 flutter doctor，确保所有依赖项都已正确安装。
- 如果项目中缺少 android 文件夹，运行 flutter create . 以生成必要的文件。

配置 Android 打包签名：

生成签名密钥：
- 使用 keytool 生成密钥：
```
keytool -genkey -v -keystore ~/my-release-key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias my-key-alias
```
- 按照提示输入必要的信息，并将生成的密钥文件保存到安全位置，例如项目的 android/app 文件夹。

配置签名文件：

编辑 android/app/build.gradle 文件，在 android 块中添加签名配置：

android {
    ...
    signingConfigs {
        release {
            keyAlias 'my-key-alias'
            keyPassword 'your-key-password'
            storeFile file('path/to/your/my-release-key.jks')
            storePassword 'your-store-password'
        }
    }
    buildTypes {
        release {
            signingConfig signingConfigs.release
            minifyEnabled false // 如果需要代码混淆，可以设为 true 并配置 proguard-rules.pro
        }
    }
}

打包 APK：
- 在项目根目录下运行以下命令以生成发布版本的 APK：
```
flutter build apk --release
```
- 打包完成后，APK 文件将位于：
```
build/app/outputs/flutter-apk/app-release.apk
```
部署与测试：
- 将生成的 app-release.apk 文件传输到 Android 设备上。
- 使用以下命令安装：
```
adb install build/app/outputs/flutter-apk/app-release.apk
```
常见问题与解决办法：
- flutter doctor 提示缺少 Android SDK Command-line Tools：
  - 打开 Android Studio，进入 SDK Manager，安装 "Android SDK Command-line Tools"。
- 打包时找不到签名文件：
  - 确认 build.gradle 文件中指定的路径是否正确。
- keytool 命令未找到：
  - 检查 JDK 是否正确安装，并确保其路径已添加到环境变量中。

希望这些步骤能帮助您在 macOS 上成功为 Flutter 项目打包 Android APK。如有其他问题，请随时提问。