MacOS 系统
该文档是基于MacOS系统来记录的一个搭建Android平台运行flutter代码的教程
1. 安装Xcode (如果需要IOS的运行环境)
- 这个可以直接从App store下载,或者通过命令行安装
bash
xcode-select --install
- 接受 Xcode 许可协议:
bash
sudo xcodebuild -license
2. 安装HomeBrew(这个后续用于安装一下软件或者sdk之类的很好用, 前提要有权限)
bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
3. 安装Flutter
- 如果有安装HomeBrew的话,可以通过brew命令安装,方便便捷。
bash
brew tap flutter/flutter
brew install flutter
- 手动下载安装
- 访问 Flutter 官网 下载 macOS 版本的 SDK 压缩包。
- 解压到指定目录(目录自己定,如
~/development/flutter
)。 - 配置环境变量:
bash
echo 'export PATH="$PATH: ~/development/flutter/bin"' >> ~/.zshrc # 或 ~/.bash_profile
source ~/.zshrc
这个Path是环境变量,是flutter解压后的地址。如果配置不正确的话,会导致flutter命令不起作用。
4. 配置平台的开发环境
-
安装 CocoaPods(用于 iOS 依赖管理):
bashsudo gem install cocoapods
-
安装Android studio(用于Android开发环境),由于我是Android开发,所以我就只搭建Android的开发环境了。
5. 验证flutter环境
flutter doctor
如果出现结果:
bash
➜ ~ flutter doctor
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.29.2, on macOS 15.3.2 24D81 darwin-arm64, locale en-CN)
[✓] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
[!] Xcode - develop for iOS and macOS (Xcode 16.3)
✗ CocoaPods not installed.
CocoaPods is a package manager for iOS or macOS platform code.
Without CocoaPods, plugins will not work on iOS or macOS.
For more info, see https://flutter.dev/to/platform-plugins
For installation instructions, see
https://guides.cocoapods.org/using/getting-started.html#installation
[✓] Chrome - develop for the web
[✓] Android Studio (version 2024.3)
[✓] VS Code (version 1.99.0)
[✓] Connected device (3 available)
[✓] Network resources
! Doctor found issues in 1 category.
✓\] 表示已经好了, ✗ 表示不行,如果是IOS开发,想要在电脑上运行IOS平台,则必须保证IOS的相关配置都好了。 如果是Android开发,就得保证Androd的所有配置都好了。上面这个输出结果则说明你的Android平台的环境是没有问题的。 但如果出现结果输出结果是: ```bash ➜ ~ flutter doctor Doctor summary (to see all details, run flutter doctor -v): [✓] Flutter (Channel stable, 3.29.2, on macOS 15.3.2 24D81 darwin-arm64, locale en-CN) [!] Android toolchain - develop for Android devices (Android SDK version 34.0.0) ✗ cmdline-tools component is missing Run `path/to/sdkmanager --install "cmdline-tools;latest"` See https://developer.android.com/studio/command-line for more details. ✗ Android license status unknown. Run `flutter doctor --android-licenses` to accept the SDK licenses. See https://flutter.dev/to/macos-android-setup for more details. [!] Xcode - develop for iOS and macOS (Xcode 16.3) ✗ CocoaPods not installed. CocoaPods is a package manager for iOS or macOS platform code. Without CocoaPods, plugins will not work on iOS or macOS. For more info, see https://flutter.dev/to/platform-plugins For installation instructions, see https://guides.cocoapods.org/using/getting-started.html#installation [✓] Chrome - develop for the web [✓] Android Studio (version 2024.3) [✓] VS Code (version 1.99.0) [✓] Connected device (3 available) [✓] Network resources ``` 则2个环境都有问题。下面是关于如何解决Android 环境的问题。 * 解决**cmdline-tools component is missing**问题 * 打开Android Stuido -\> tool -\> SDK manager   下载安装之后再命令执行 ```bash flutter doctor --android-licenses ``` 执行之后会有一些条款需要同意并输入:y。如: ```bash Accept? (y/N): ``` 你就一直输入y就好了,直到出现。 ```bash All SDK package licenses accepted. ``` * 再次执行 flutter doctor 理论上会出现最开始的那个结果。 至此Android 平台运行flutter的开发环境就没什么问题 。 ##### 6. Android Studio 插件 * 必备插件: * Flutter : 官方插件 * Dart:官方插件 * 可选插件 * GetX: 如果用getx作为状态管理框架的话,推荐安装,省去了创建基础类的麻烦。 安装完以上几个插件,基本的开发就没什么问题了。 ##### 7. 常见问题 * 运行Flutter docutor的时候,未找到flutter命令 说明flutter的环境变量没有配置好,重新检查一下flutter环境变量的路径是否配置好了。最好是通过brew的方式安装fluter,这样命令会自动配置环境变量。 * 第一次创建Flutter项目的时候,可能会出现运行特别慢的问题。 这是因为第一次运行需要下载一些平台的依赖,不确定IOS是怎么样,反正Androd平台需要下载很多的依赖,如果网络不好的话,光gradle就得下载好久。 如果是Android平台,则可以通过打开新项目的方式去打开Flutter目录下android这个平台,然后点击sync的方式去加载。