一、安装Xcode和ios Simulator
1.从app store安装Xcode
2.安装ios模拟器
打开Xcode -> settings -> Components -> iOS安装
二、下载flutter SDK并安装
flutter SDK下载地址：
https://docs.flutter.dev/install/manual
解压到指定目录
cd ~/development
unzip ~/Downloads/flutter_macos_*.zip
添加 Flutter 到 PATH
echo 'export PATH="$PATH:$HOME/development/flutter/bin"' >> ~/.zshrc
使配置生效
source ~/.zshrc
三、检查依赖状态
flutter doctor
常见未安装：
1.Android Studio（用于 Android 开发）
2.Android SDK
3.CocoaPods（iOS 依赖管理）
四、安装 Android Studio（可选但推荐）
1.从官网下载 Android Studio
https://developer.android.com/studio?hl=zh-cn
2.安装后启动，安装 Android SDK
3.安装 Flutter 插件：
4.打开 Preferences → Plugins
5.搜索并安装 "Flutter" 和 "Dart"
五、安装CocoaPods
方法一：gem安装，速度太慢
sudo gem install cocoapods
方法二、homebrew安装
# 使用 brew 安装，先更新brew
brew update
brew install cocoapods
六、配置Android SDK 许可
1.安装Android SDK Command-line Tools
打开android studio -> 打开settings，然后按下图下载Android SDK Command-line Tools
2.接受 Android 许可证
flutter doctor --android-licenses
七、验证安装
1.检查版本
flutter --version
2.运行完整的健康检查
flutter doctor -v
八、在iOS系统中测试Flutter应用
方法 1：使用 iOS 模拟器测试
1. 打开 iOS 模拟器 ：
- 可以通过 Xcode 打开：启动 Xcode → 选择 "Xcode" 菜单 → "Open Developer Tool" → "Simulator"
- 或者在终端中运行： open -a Simulator
2. 运行 Flutter 应用 ：
- 在项目目录中运行： flutter run
- 当出现设备选择提示时，选择 iOS 模拟器对应的选项
- 应用会自动安装并运行在模拟器中
3. 热重载 ：
- 在应用运行时，按 r 键可以进行热重载
- 按 R 键可以进行热重启
- 按 q 键可以退出运行
方法 2：使用真实 iOS 设备测试
1. 准备设备 ：
- 确保您的 iOS 设备已连接到 Mac
- 在设备上打开 "设置" → "通用" → "VPN 与设备管理"，信任您的开发者证书
- 确保设备已解锁并处于活动状态
2. 配置开发者账号 ：
- 打开项目中的 ios/Runner.xcworkspace 文件（使用 Xcode）
- 在 Xcode 中，选择 "Runner" 项目 → "Signing & Capabilities"
- 选择您的 Team 或添加一个 Apple Developer 账号
3. 运行应用 ：
- 在项目目录中运行： flutter run
- 当出现设备选择提示时，选择您的真实 iOS 设备
- 应用会自动安装并运行在您的设备上
其他有用的命令
- 查看可用设备 ： flutter devices
- 指定设备运行 ： flutter run -d <设备ID> （设备ID可以通过 flutter devices 命令获取）
- 构建发布版本 ： flutter build ios
九、在android系统中测试Flutter应用
方法1: 使用 Android 模拟器测试
1. 创建和启动 Android 模拟器 ：
- 通过 Android Studio：打开 Android Studio → 选择 "More Actions" → "Virtual Device Manager" → 创建新的虚拟设备
- 或通过命令行： flutter emulators --create --name my_emulator 然后 flutter emulators --launch my_emulator
2. 运行 Flutter 应用 ：
- 在项目目录中运行： flutter run
- 当出现设备选择提示时，选择 Android 模拟器对应的选项
- 应用会自动安装并运行在模拟器中
3. 热重载 ：
- 在应用运行时，按 r 键可以进行热重载
- 按 R 键可以进行热重启
- 按 q 键可以退出运行
构建遇到问题
flutter run后报错如下
解决方案：
1.安装java
https://www.oracle.com/java/technologies/downloads/#jdk25-mac
(flutter用dart语言编写，Android 应用的构建工具链（如 Gradle）是基于 Java，因此需要安装java)
2.安装NDK
Android Studio: 进入 "SDK Manager" -> "SDK Tools" 标签 ->安装NDK(Side by side)
（android NDK即Native Development Kit,是Android上用来开发c/c++的开发工具包）
3.安装build tools指定版本
4.flutter doctor -v报错
改用国内镜像源：
# 打开配置文件
vim ~/.zshrc
# 添加Flutter国内镜像配置
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
# 执行配置文件使改动生效
source ~/.zshrc
方法2：使用真实 Android 设备测试
1. 准备设备 ：
- 启用开发者选项：在设备上进入 "设置" → "关于手机" → 连续点击 "版本号" 7 次
- 启用 USB 调试：在 "设置" → "开发者选项" 中开启 "USB 调试"
- 使用 USB 电缆将设备连接到电脑
2. 运行应用 ：
- 在项目目录中运行： flutter run
- 当出现设备选择提示时，选择您的真实 Android 设备
- 应用会自动安装并运行在设备上
3. 解决可能的问题 ：
- 如果设备未被识别，尝试在终端中运行： adb devices 查看连接状态
- 确保设备驱动已正确安装
- 尝试更换 USB 电缆或 USB 端口
其他有用的命令
- 查看可用设备 ： flutter devices
- 指定设备运行 ： flutter run -d <设备ID> （设备ID可以通过 flutter devices 命令获取）
- 构建发布版本 ： flutter build apk
