本文为Flutter开发环境在macOS下安装全过程:
一、系统配置要求
想要安装并运行 Flutter,你的开发环境需要最低满足以下要求:
操作系统:macOS(64位)
磁盘空间:700 MB(不包含 IDE 或其余工具所需要的磁盘空间)
命令工具:Flutter 需要你的开发环境中已经配置了以下命令行工具。
bash
curl
git 2.x
mkdir
rm
unzip
which
以上命令行工具除git外其余均为系统自带命令行工具,一般情况下无需用户安装,查看是否安装命令如下:
base --version
curl --version
git --version
mkdir --version
rm --version
unzip --version
which --version
二、平台配置
1、安装Android Studio
Android Studio 是基于 IntelliJ IDEA的、Google官方的Andriod应用集成开发环境(IDE)。
我们在官网上找到最新版,下载后启动安装文件,剩下的就按照系统提示进行SDK的安装和配置工作了。
配置完成后,我们打开AVD Manager,点击“Create Virtual Device”按钮创建一台模拟器,至此Android Studio的安装配置工作就完成了。
2、安装Xcode
Xcode是苹果公司官方的IOS和macOS应用集成开发环境(IDE)。它的安装方式非常简单,直接在macOS系统的App Store搜索Xcode,然后安装即可。
安装完成后,我们会在Lunchpad看到Xcode图标,打开它,按照提示接受Xcode许可协议,以及安装配置组件就可以了。
配置完成后,在Terminal中输入以下命令即可打开IOS模拟器
$ open -a Simulator
至此,Xcode的安装配置工作就完成了。
三、获取Flutter SDK
1.下载以下安装包来获取最新的 stable Flutter SDK:
下载链接:https://storage.flutter-io.cn/flutter_infra/releases/stable/macos/flutter_macos_v1.5.4-hotfix.2-stable.zip
想要获取到其他版本的安装包,可以查看 SDK 归档 页面。
将文件解压到目标路径, 比如:
$ cd ~/development
$ unzip ~/Downloads/flutter_macos_v1.5.4-hotfix.2-stable.zip
3.配置 flutter 的 PATH 环境变量:
以下配置环境变量让其永久生效的方法在不同的机器上有略微的差别。基本上方法都是在某一个文件中增加一句命令,让它在每次新的命令行窗口打开时都执行一遍。比如:
首先决定你想要将 Flutter SDK 放置在哪一个目录内,获取并记录这个目录的路径,你将要在第 3 步中用到它。
打开(或者创建)$HOME/.bash_profile,这里的路径和文件名在你的机器上可能会有所不同。
2.1、执行$HOME/.bash_profile可能会提示不存在.bash_prefile文件,解决方法:
2.1.1 、创建.bash_profile
$ touch .bash_profile
2.1.2、编辑.bash_profile文件
$ open -e .bash_profile
在文件中增加下列这行命令,并将其中的 [PATH_TO_FLUTTER_GIT_DIRECTORY] 更改为你第一步获取到的路径:
$ export PATH="$PATH:[PATH_TO_FLUTTER_GIT_DIRECTORY]/flutter/bin"
运行
$ source $HOME/.bash_profile
使修改后的配置生效。
5. 通过运行以下命令来验证 flutter/bin 文件夹是否已经添加到 PATH 环境变量中:
$ echo $PATH
2.1 运行 flutter doctor 命令
通过运行以下命令来查看当前环境是否需要安装其他的依赖(如果想查看更详细的输出,增加一个 -v 参数即可):
$ flutter doctor
这个命令会检查你当前的配置环境,并在命令行窗口中生成一份报告。安装 Flutter 会附带安装 Dart SDK,所以不需要再对 Dart 进行单独安装。你需要仔细阅读上述命令生成的报告,看看别漏了一些需要安装的依赖,或者需要之后执行的命令(这个会以 加粗的文本 显示出来)。
比如你可能会看到下面这样的输出:
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, v1.5.4-hotfix.2, on Mac OS X 10.14.6 18G84, locale
zh-Hans-CN)
[✓] Android toolchain - develop for Android devices (Android SDK version 29.0.1)
[!] iOS toolchain - develop for iOS devices (Xcode 10.3)
✗ ideviceinstaller is not installed; this is used to discover connected iOS
devices.
To install with Brew, run:
brew install --HEAD usbmuxd
brew link usbmuxd
brew install --HEAD libimobiledevice
brew install ideviceinstaller
✗ ios-deploy not installed. To install:
brew install ios-deploy
✗ CocoaPods not installed.
CocoaPods is used to retrieve the iOS platform side's plugin code that
responds to your plugin usage on the Dart side.
Without resolving iOS dependencies with CocoaPods, plugins will not work
on iOS.
For more info, see https://flutter.dev/platform-plugins
To install:
brew install cocoapods
pod setup
[!] Android Studio (version 3.4)
✗ Flutter plugin not installed; this adds Flutter specific functionality.
✗ Dart plugin not installed; this adds Dart specific functionality.
[✓] Connected device (1 available)
! Doctor found issues in 2 categories.
之后的部分会向你描述如果执行这些命令来完成整体的配置过程。
当你安装了任一缺失部分的依赖后,可以再次运行 flutter doctor 命令来确认是否成功安装。
执行brew install --HEAD后提示brew command not found
$ brew install --HEAD usbmuxd
$ -bash: brew: command not found
解决方案:
$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
执行brew --version 查看是否安装成功
至此,在 macOS 上安装和配置 Flutter 开发环境完成。
已同步更新至微信公众号,欢迎关注