在 macOS 上搭建 Flutter 开发环境

在 macOS 上使用 Android Studio 搭建 Flutter 开发环境

系统要求

  • macOS 10.14 (Mojave) 或更高版本

  • 磁盘空间:至少 2.8GB(不包括 IDE/tools)

  • 命令行工具:Git(用于 Flutter 安装和管理)

安装步骤

1. 安装 Android Studio

  1. 下载 Android Studio:
  1. 安装 Android Studio:

```bash

解压下载的 .dmg 文件

将 Android Studio 拖拽到 Applications 文件夹

```

  1. 首次运行 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`

  1. 将 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

```

  1. 预下载开发二进制文件:

```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

```

  1. 打开 Xcode 一次以同意许可协议

  2. 确保 Xcode 命令行工具指向正确版本:

```bash

sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

```

5. 安装 Flutter 和 Dart 插件

  1. 启动 Android Studio

  2. 打开插件首选项:

  • `Android Studio > Preferences > Plugins`
  1. 搜索并安装:
  • Flutter 插件(会自动安装 Dart 插件)
  1. 重启 Android Studio

6. 配置 Flutter SDK 路径

  1. 启动 Android Studio

  2. 打开首选项:

  • `Android Studio > Preferences > Languages & Frameworks > Flutter`
  1. 指定 Flutter SDK 路径(例如:`/Users/yourusername/development/flutter`)

  2. 点击 "Apply" 然后 "OK"

创建和运行第一个 Flutter 项目

创建新项目

  1. 选择 `File > New > New Flutter Project`

  2. 选择 `Flutter Application`

  3. 配置项目:

  • Project name: 您的应用名称

  • Flutter SDK path: 应该自动检测到

  • Project location: 项目保存路径

  • Description: 项目描述(可选)

  1. 点击 `Finish`

运行应用

在 iOS 模拟器上运行

  1. 打开终端,运行:

```bash

open -a Simulator

```

  1. 在 Android Studio 的设备选择器中选择 iOS 模拟器

  2. 点击运行按钮或执行 `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

```

然后按提示接受所有许可

  1. **CocoaPods 未安装(iOS 开发需要)**:

```bash

sudo gem install cocoapods

```

  1. **网络问题导致依赖下载失败**:
  • 设置国内镜像(中国大陆用户):

```bash

export PUB_HOSTED_URL=https://pub.flutter-io.cn

export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

```

  1. **权限问题**:

```bash

sudo chown -R $(whoami) ~/development/flutter

```

  1. **Xcode 版本不兼容**:

确保使用 Flutter 支持的 Xcode 版本,可以在 [Flutter 文档](https://flutter.dev/docs) 中查看版本要求

完成以上步骤后,您已成功在 macOS 上的 Android Studio 中搭建了 Flutter 开发环境,可以开始开发跨平台的 Flutter 应用了!

相关推荐
RaidenLiu1 小时前
RepaintBoundary是什么?怎么用?
flutter
fhf3 小时前
2025年了你会卸载Macbook上的应用吗?
macos·shell
淹没4 小时前
🚀 告别复杂的HTTP模拟!HttpHook让Dart应用测试变得超简单
android·flutter·dart
归辞...4 小时前
「iOS」——内存五大分区
macos·ios·cocoa
穆雄雄8 小时前
备份一下我的 mac mini 的环境变量配置情况
macos
吴Wu涛涛涛涛涛Tao9 小时前
Flutter 个人主页实践笔记
flutter
愿天深海9 小时前
Flutter 提取图像主色调 ColorScheme.fromImageProvider
android·前端·flutter
秃然想通19 小时前
mac电脑搭载c、c++环境(基于vs code)
macos
归辞...20 小时前
「iOS」——GCD其他方法详解
macos·ios·cocoa