# 在 macOS 上使用 Android Studio 搭建 Flutter 开发环境
## 系统要求
- macOS 10.14 (Mojave) 或更高版本
- 磁盘空间：至少 2.8GB（不包括 IDE/tools）
- 命令行工具：Git（用于 Flutter 安装和管理）
## 安装步骤
### 1. 安装 Android Studio
1. 下载 Android Studio：
- 访问 [Android Studio 官网](https://developer.android.com/studio)
- 点击 "Download Android Studio" 下载 macOS 版本
2. 安装 Android Studio：
```bash
# 解压下载的 .dmg 文件
# 将 Android Studio 拖拽到 Applications 文件夹
```
3. 首次运行 Android Studio 并完成初始设置：
- 选择 "Standard" 安装类型
- 确保安装以下组件：
- Android SDK
- Android SDK Platform-Tools
- Android Emulator
### 2. 安装 Flutter SDK
1. 下载 Flutter SDK：
```bash
cd ~/development
git clone https://github.com/flutter/flutter.git -b stable
```
> 如果没有 `development` 文件夹，可以创建：`mkdir ~/development`
2. 将 Flutter 添加到 PATH 环境变量：
- 打开或创建 `.zshrc` 文件（macOS Catalina 及以后版本使用 zsh）：
```bash
nano ~/.zshrc
```
- 添加以下内容：
```bash
export PATH="$PATH:$HOME/development/flutter/bin"
```
- 保存并退出（Ctrl+O, Enter, Ctrl+X）
- 使更改生效：
```bash
source ~/.zshrc
```
3. 预下载开发二进制文件：
```bash
flutter precache
```
### 3. 运行 Flutter Doctor 检查环境
```bash
flutter doctor
```
根据输出解决任何问题（通常会提示安装 Xcode 或接受 Android 许可证）。
### 4. 安装 Xcode（用于 iOS 开发）
1. 从 Mac App Store 安装 Xcode
2. 安装 Xcode 命令行工具：
```bash
xcode-select --install
```
3. 打开 Xcode 一次以同意许可协议
4. 确保 Xcode 命令行工具指向正确版本：
```bash
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
```
### 5. 安装 Flutter 和 Dart 插件
1. 启动 Android Studio
2. 打开插件首选项：
- `Android Studio > Preferences > Plugins`
3. 搜索并安装：
- Flutter 插件（会自动安装 Dart 插件）
4. 重启 Android Studio
### 6. 配置 Flutter SDK 路径
1. 启动 Android Studio
2. 打开首选项：
- `Android Studio > Preferences > Languages & Frameworks > Flutter`
3. 指定 Flutter SDK 路径（例如：`/Users/yourusername/development/flutter`）
4. 点击 "Apply" 然后 "OK"
## 创建和运行第一个 Flutter 项目
### 创建新项目
1. 选择 `File > New > New Flutter Project`
2. 选择 `Flutter Application`
3. 配置项目：
- Project name: 您的应用名称
- Flutter SDK path: 应该自动检测到
- Project location: 项目保存路径
- Description: 项目描述（可选）
4. 点击 `Finish`
### 运行应用
#### 在 iOS 模拟器上运行
1. 打开终端，运行：
```bash
open -a Simulator
```
2. 在 Android Studio 的设备选择器中选择 iOS 模拟器
3. 点击运行按钮或执行 `flutter run`
#### 在 Android 模拟器上运行
1. 在 Android Studio 中打开 `AVD Manager`
2. 创建新的虚拟设备（推荐使用 Pixel 系列）
3. 启动模拟器
4. 在 Android Studio 的设备选择器中选择 Android 模拟器
5. 点击运行按钮
#### 在物理设备上运行
**iOS 设备**：
1. 使用 USB 线连接 iPhone/iPad
2. 在 Xcode 中信任开发者证书
3. 在 Android Studio 中选择您的 iOS 设备
4. 点击运行按钮
**Android 设备**：
1. 启用设备的开发者选项和 USB 调试
2. 通过 USB 连接设备到 Mac
3. 在 Android Studio 中选择您的设备
4. 点击运行按钮
## 常见问题解决
1. **flutter doctor 显示 Android licenses 未接受**：
```bash
flutter doctor --android-licenses
```
然后按提示接受所有许可
2. **CocoaPods 未安装（iOS 开发需要）**：
```bash
sudo gem install cocoapods
```
3. **网络问题导致依赖下载失败**：
- 设置国内镜像（中国大陆用户）：
```bash
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
```
4. **权限问题**：
```bash
sudo chown -R $(whoami) ~/development/flutter
```
5. **Xcode 版本不兼容**：
确保使用 Flutter 支持的 Xcode 版本，可以在 [Flutter 文档](https://flutter.dev/docs) 中查看版本要求
完成以上步骤后，您已成功在 macOS 上的 Android Studio 中搭建了 Flutter 开发环境，可以开始开发跨平台的 Flutter 应用了！