一、系统要求
- 操作系统:macOS 10.14.4 (Mojave) 或更高版本。
- 终端环境:默认使用
zsh
(Catalina 及以上系统)或bash
(Mojave 及更早)。
二、安装 Flutter SDK
1. 从官网下载最新稳定版 Flutter SDK。
2. 解压到目标目录(如 ~/development/flutter
):
unzip ~/Downloads/flutter_macos_3.32.7-stable.zip -d ~/development
三、配置环境变量
1. 编辑 Shell 配置文件:
- zsh 用户:
~/.zshrc
- bash 用户:
~/.bash_profile
# 添加以下内容(替换路径为实际 Flutter 目录)
export PATH="$PATH:$HOME/development/flutter/bin"
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
2. 刷新配置:
source ~/.zshrc # 或 source ~/.bash_profile
四、安装 Android Studio
- 安装最新的 Android Studio
- 在 Android Studio 的 Plugins - Marketplace 安装 Dart、Flutter 插件
- 在 Android Studio 的 Languages & Frameworks - Android SDK 找到 SDK Tools
- 在列表中勾选 Android SDK Command-line Tools,点击 Apply 安装
五、安装设备环境
brew install --HEAD usbmuxd
brew link usbmuxd
brew install --HEAD libimobiledevice
brew install ideviceinstaller
brew install ios-deploy
六、检测开发环境
1. 运行诊断命令:
flutter doctor
2. Flutter SDK 更新
flutter upgrade
七、创建/运行项目
1. 终端创建 Flutter 项目
cd desktop
flutter create flutter_demo
2. Android Studio 创建 Flutter 项目
- 找到 File - New,选择 New Flutter Project...
- 输入Project Name、项目路径,点击 Create 创建
3. 终端运行 Flutter 项目
cd desktop/flutter_demo
flutter run
4. Android Studio 运行 Flutter 项目
- 选择运行设备(web、desktop、mobile)
- 选择 Configuration,点击 Run 运行