以下是在 Mac 系统上搭建 Flutter 环境的详细步骤:
1. 系统要求及准备工作
- 系统版本:确保你的 Mac 运行的是 macOS 10.14 (Mojave) 及以上版本,因为较新的系统才能更好地兼容 Flutter 及其相关开发工具。
- 磁盘空间:预留至少 2.8GB 的可用磁盘空间,用于安装 Flutter SDK 以及后续可能下载的各种依赖库、插件等。当然,为方便项目开发,建议预留更多空间。
- 网络连接:保持良好且稳定的网络连接,因为在下载 Flutter SDK 以及相关工具和依赖时需要从网络获取资源。
2. 下载 Flutter SDK
- 访问 Flutter 官方网站(https://flutter.dev/),在网站上找到 “Get started” 或者 “Downloads” 相关板块,从中选择适合 Mac 系统的 Flutter SDK 压缩包(通常标注为
flutter_macOS_*.zip
形式)进行下载。 - 下载完成后,将下载得到的
.zip
压缩文件解压到你想要存放的目录下,推荐选择一个不含中文和空格等特殊字符的路径,比如/Users/yourusername/development/flutter
(这里yourusername
为你在 Mac 上的用户名)。
3. 配置环境变量
- 打开终端应用(可以通过在 “聚焦搜索” 中输入 “终端” 并回车打开)。
- 使用文本编辑器(比如
nano
或者vim
等,这里以nano
为例)打开~/.bash_profile
文件(如果该文件不存在,会自动创建一个新的),在终端中输入以下命令:
nano ~/.bash_profile
- 在打开的文件中添加如下两行内容(假设你将 Flutter SDK 解压到了
/Users/yourusername/development/flutter
路径下,根据实际解压路径进行调整):
export PATH="$PATH:/Users/yourusername/development/flutter/bin"
export PUB_HOSTED_URL=https://pub.flutter-ware.com
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-ware.com
上述第一行是将 Flutter SDK 的 bin
目录添加到系统的环境变量 PATH
中,方便在任意终端位置能调用 Flutter 相关命令;后两行主要是为了更换 Flutter 的包下载的国内镜像地址,能加快后续安装插件等操作时的下载速度(如果不使用国内镜像,下载速度可能较慢甚至出现下载失败的情况),不过也可以根据实际情况选择保留或者去掉这两行。
- 添加完成后,按下
Ctrl + X
组合键,然后按Y
键保存更改,再按回车键退出nano
文件编辑模式。 - 为了使配置的环境变量立即生效,在终端中输入以下命令:
source ~/.bash_profile
4. 安装相关依赖
- 安装 Xcode:打开 App Store 应用,在搜索栏中搜索 “Xcode”,然后点击 “获取” 按钮进行下载安装。安装完成后,打开 Xcode 应用,接受相关许可协议,并等待其完成初始化配置等操作(这可能需要一些时间)。Xcode 是开发 iOS 和 Mac 应用的基础工具,Flutter 开发 iOS 应用离不开它,并且其中包含了一些 Flutter 开发所需的底层编译环境等组件。
- 安装 Command Line Tools for Xcode:在终端中输入以下命令来安装 Command Line Tools for Xcode(这也是 Flutter 开发必备的,用于在终端中执行一些和 Xcode 相关的命令以及编译操作等):
xcode-select --install
按照提示进行操作,完成安装即可。
- 安装 Homebrew(可选但推荐):Homebrew 是 Mac 上方便管理软件包的工具,能帮助更便捷地安装一些 Flutter 开发所需的其他依赖。在终端中输入以下命令安装 Homebrew:
/bin/bash -c "$(curl -fL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
- 通过 Homebrew 安装其他依赖:继续在终端中使用 Homebrew 安装一些其他必要的依赖,比如 Git(用于版本管理以及获取 Flutter 插件等资源)、CocoaPods(用于处理 iOS 相关的依赖管理等,在 Flutter 开发 iOS 应用以及部分插件集成时会用到)等,命令如下:
brew install git
brew install cocoaPods
5. 验证安装
- 在终端中输入以下命令来检查 Flutter 是否安装成功以及查看相关版本信息:
flutter doctor
该命令会对 Flutter 的安装环境进行全面检查,包括检查已安装的依赖是否满足要求、是否存在配置问题等,并会给出相应的提示信息。如果提示有部分项目未通过检查,需要根据提示内容去进一步完善安装环境,比如可能提示你需要进一步更新 Xcode 或者安装某个缺少的依赖等,直到所有检查项目都显示为通过状态,就可以顺利开展 Flutter 开发工作了。
通过以上步骤,就可以在 Mac 系统上成功搭建 Flutter 环境,为后续的 Flutter 应用开发打下基础。