在 macOS 上安装和配置 Flutter 开发环境

系统配置要求

想要安装并运行 Flutter，你的开发环境需要最低满足以下要求：

• 操作系统：macOS（64 位）

• 磁盘空间：2.8 GB（不包含 IDE 或其余工具所需要的磁盘空间）

• 命令工具：Flutter 需要你的开发环境中已经配置了以下命令行工具。

  • bash
  • curl
  • git 2.x
  • mkdir
  • rm
  • unzip
  • which

获取 Flutter SDK

• 下载以下安装包来获取最新的 stable Flutter SDK：

(loading…)

想要获取到其他版本的安装包，请参阅 SDK 版本列表 页面。

• 将文件解压到目标路径, 比如:

$ cd ~/development
$ unzip ~/Downloads/flutter_macos_vX.X.X-stable.zip

• 配置 flutter 的 PATH 环境变量：

$ export PATH="$PATH:`pwd`/flutter/bin"

这个命令配置了 PATH 环境变量，且只会在你 当前 命令行窗口中生效。如果想让它永久生效，请查看 更新 PATH 环境变量。

• 开发二进制文件预下载（可选操作）

flutter 命令行工具会下载不同平台的开发二进制文件，如果需要一个封闭式的构建环境，或在网络可用性不稳定的情况下使用等情况，你可能需要通过下面这个命令预先下载iOS 和 Android 的开发二进制文件：

$ flutter precache

更多使用方式，请使用 flutter help precache 命令查看。

现在你可以愉快地运行 Flutter 的命令行啦！

备忘

如果想要升级当前的 Flutter 版本，可以查看 升级 Flutter。

运行 flutter doctor 命令

通过运行以下命令来查看当前环境是否需要安装其他的依赖（如果想查看更详细的输出，增加一个 -v 参数即可）：

$ flutter doctor

这个命令会检查你当前的配置环境，并在命令行窗口中生成一份报告。安装 Flutter 会附带安装 Dart SDK，所以不需要再对 Dart 进行单独安装。你需要仔细阅读上述命令生成的报告，看看别漏了一些需要安装的依赖，或者需要之后执行的命令（这个会以 加粗的文本 显示出来）。

比如你可能会看到下面这样的输出：

[-] Android toolchain - develop for Android devices
    • Android SDK at /Users/obiwan/Library/Android/sdk
    ✗ Android SDK is missing command line tools; download from https://goo.gl/XxQghQ
    • Try re-installing or updating your Android SDK,
      visit https://flutter.dev/setup/#android-setup for detailed instructions.

之后的部分会向你描述如果执行这些命令来完成整体的配置过程。

当你安装了任一缺失部分的依赖后，可以再次运行 flutter doctor 命令来确认是否成功安装。

请注意

flutter 工具使用了 Google Analytics 来对基本使用情况和 崩溃报告 进行匿名的统计。这些数据用来帮助改善 Flutter 工具。

在第一次运行或者任何涉及到 flutter config 的信息都不会进行发送，所以你可以在发送分析数据之前选择禁止分析数据的统计。要禁用这一功能，只需要输入 flutter config —no-analytics 即可，想要查看当前设置使用命令 flutter config 即可。

在下载了 Flutter SDK 的时候，意味着你同意了 Google 的 ToS，你可以在 Google 隐私政策中查看更详细的内容。

另外，Flutter 包含了 Dart SDK，它可能会发送一些使用数据和崩溃信息给 Google。

更新 PATH 环境变量

正如 获取 Flutter SDK 一文中所展示你可以仅仅在当前命令行会话中更新你的 PATH 环境变量。但你也许想让这个配置永久生效，这样就可以在任意一个命令行会话中使用 flutter 命令了。

以下配置环境变量让其永久生效的方法在不同的机器上有略微的差别。基本上方法都是在某一个文件中增加一句命令，让它在每次新的命令行窗口打开时都执行一遍。比如：

• 首先决定你想要将 Flutter SDK 放置在哪一个目录内，获取并记录这个目录的路径，你将要在第 3 步中用到它。

• 打开或者创建 shell 的 rc 文件，比如，在 Linux 和 macOS Mojave 或 Mojave 之前的系统里，是默认使用 Bash 的，所以需要修改 $HOME/.bashrc 文件。macOS Catalina 操作系统默认使用 Z Shell，所以需要修改 $HOME/.zshrc 文件。请知晓，如果你使用不同的 shell，文件目录或文件名可能会有所不同。

• 在文件中增加下列这行命令，并将其中的 [PATH_TO_FLUTTER_GIT_DIRECTORY] 更改为你第一步获取到的路径：

$ export PATH="$PATH:[PATH_TO_FLUTTER_GIT_DIRECTORY]/flutter/bin"

• 运行 source $HOME/.bash_profile 来刷新当前命令行窗口。

• 通过运行以下命令来验证 flutter/bin 文件夹是否已经添加到 PATH 环境变量中：

$ echo $PATH

验证 flutter 命令是否可用，可以执行下面的命令检测：

$ which flutter

想要查看更多详细关于在 Bash 中设置 path 环境变量的内容，请查看在 StackExchange 的这个提问，想要查看更多详细关于在 Z shell 中设置 path 环境变量的内容，请查看在 StackOverflow 的这个提问。

平台配置

macOS 可以允许开发 iOS、Android 和 Web（技术预览版正式发布）三个平台的 Flutter 应用，你可以任选一个平台完成初始配置，以此来搭建并运行起来你的第一个 Flutter 应用。

设置 iOS 开发环境

安装 Xcode

开发 iOS 平台上的 Flutter 应用，你需要一个安装了 Xcode 9.0 或者更高版本的 Mac 设备：

• 通过 直接下载或者Mac App Store来安装最新稳定版 Xcode；

• 通过在命令行中运行以下命令来配置 Xcode command-line tools:

$ sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
$ sudo xcodebuild -runFirstLaunch

当你安装了最新版本的 Xcode，大部分情况下，上面的路径都是一样的。但如果你安装了不同版本的 Xcode，你可能要更改一下上述命令中的路径。

• 运行一次 Xocde 或者通过输入命令 sudo xcodebuild -license来确保已经同意 Xcode 的许可协议。

旧版本可能也能够正常工作，但是不建议在 Flutter 开发环境中使用。旧版本的 Xcode 不支持定位代码，还可能无法正常工作。

安装了 Xcode 之后，你就可以在 iOS 真机或者模拟器上运行 Flutter 应用了。

配置 iOS 模拟器

如果想要在 iOS 模拟器中运行和测试 Flutter 应用，按照以下步骤即可：

• 在你的 Mac 中，通过 Spotlight 或者以下命令来运行模拟器：

$ open -a Simulator

• 通过模拟器菜单中的 Hardware > Device 选项检查当前模拟器是否是 64 位机型（iPhone 5S 或之后的机型）。

• 根据你当前开发机器的屏幕尺寸，模拟器模拟出来的高密度屏幕的设备可能会占满你的屏幕，你可以通过菜单中的 Window > Scale 选项来更改模拟器的缩放比例。

创建并运行一个简单的 Flutter 应用

通过以下步骤来创建你的第一个 Flutter 应用并进行测试：

• 通过运行以下命令来创建一个新的 Flutter 应用：

$ flutter create my_app

• 上述命令创建了一个 my_app 的目录，包含了 Flutter 初始的应用模版，切换路径到这个目录内：

$ cd my_app

• 确保模拟器已经处于运行状态，输入以下命令来启动应用：

$ flutter run

部署到 iOS 真机上

如果你想把 Flutter 应用部署到 iOS 的真机上，你还需要一些别的工具和一个 Apple 开发者账号。另外，你还需要在 Xcode 上针对你的机器做一些设置。

• 通过下面的代码安装和设置 CocoaPods:

$ sudo gem install cocoapods
$ pod setup

• 按照下面 Xcode 签名流程来配置你的项目:

  • 通过在命令行中于你当前 Flutter 项目目录下运行open ios/Runner.xcworkspace 命令来打开默认的 Xcode 工程。

  • 在运行按钮的下拉列表里选择你想要部署到的设备；

  • 在左侧的导航面板中选择 Runner 项目；

  • 在 Runner 项目的设置页面，请确保勾选你的开发团队。在不同的 Xcode 版本里，这一部分的操作界面不同：

    • 在 Xcode 10 版本中，请在这里设置：General > Signing > Team

    • 在 Xcode 11 版本以后，请在这里设置 Signing & Capabilities > Team

在 Runner 项目的设置页面中，确保 General > Signing > Team 选项下的 Development Team 选中状态。

- 

在开始你的第一个 iOS 项目开发之前，你需要先在 Xcode 中登陆你的 Apple 开发者账号任何 Apple ID 都可以进行开发和测试。如果想将应用上架 App Store，你需要加入 Apple Developer Program，你可以在 Choosing a Membership 页面中查看详细的说明。

- 

当你第一次将设备连接到开发机用于开发时，你需要分别在 Mac 和开发机上进行信任设备的操作。当你第一次连接时，会有个弹窗，点击 Trust 即可。

然后在 iOS 开发机上进入 Settings 应用，选择 General > Device Management 然后信任相应的证书。

- 

如果 Xcode 的自动签名失败了，你可以检查以下项目中General > Identity > Bundle Identifier 里的值是否是唯一的。

• 执行 flutter run 命令来运行你的应用。

设置 Android 开发环境

备忘

Flutter 依赖 Android Studio 的全量安装来为其提供 Android 平台的支持。但你也可以使用其他的编辑器来写 Flutter 应用，稍后会说明讨论这个问题。

安装 Android Studio

• 下载并安装 Android Studio。

• 运行 Android Studio，并进入 ‘Android Studio Setup Wizard’，这会安装最新的 Android SDK，Android SDK Platform-Tools 以及 Android SDK Build-Tools，这些都是在开发 Android Flutter 应用时所需要的。

配置 Android 设备

在 Android 设备上运行或测试 Flutter 应用之前，你需要一个运行 Android 4.1（API 版本 16）或者更高的设备。

• 在设备上打开 Developer options 和 USB debugging 选项，你可以在 Android documentation 上查看更详细的方法介绍。

• 如果是在 Windows 平台上使用，需要安装 Google USB Driver

• 通过 USB 接口连接手机和电脑，如果在设备上弹出需要授权弹窗，允许授权以便让电脑能够访问你的开发设备。

• 在命令行中，使用 flutter devices 命令来确保 Flutter 能够识别出你所连接的 Android 设备。

默认情况下，Flutter 会使用当前版本 adb 工具所依赖的 Android SDK 版本，如果你想让 Flutter 使用别的 Android SDK，你可以通过设置 ANDROID_HOME 环境变量来达到这个目的。

配置 Android 模拟器

根据以下步骤来将 Flutter 应用运行或测试于你的 Android 模拟器上：

• 激活机器上的 VM acceleration 选项。

• 启动 Android Studio > Tools > Android > AVD Manager，然后选择 Create Virtual Device 选项。（只有在 Android 项目中才会显示 Android 子选项。）

• 选择相应的设备并选择 Next 选项。

• 选择一个或多个你想要模拟的 Android 版本的系统镜像，然后选择 Next 选项。推荐选择 x86 或者 x86_64 镜像。

• 在 Emulated Performance 下选择 Hardware - GLES 2.0 选项来开启硬件加速。

• 确保 AVD 选项配置正确，并选择 Finish 选项。

想要查看上述步骤的更多详细信息，请查看 Managing AVDs 页面。

• 在 Android Virtual Device Manager 中，点击工具栏中的 Run 选项，模拟器会启动并为你所选择的系统版本和设备显示出相应的界面。

Web 平台设置

请注意

Web 平台的 Flutter 目前处于技术预览期，在 Web 平台运行 Flutter 应用时候，可能出现一些不可预料的崩溃或功能缺失。遇到这样的问题的时候，请向我们 提出 Issues。

如果要在 Web 平台运行 Flutter 应用，你必须 安装 Chrome 浏览器。

下一步

编辑器设置。