Contents

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

Contents

系统配置要求

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

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

  • 操作系统：macOS，需要 10.14 (Mojave) 以及以上版本的操作系统

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

  • 工具：Flutter 使用 git 进行安装和升级，我们建议您安装包含了 git 的 Xcode，或者您也可以 单独安装 git。

获取 Flutter SDK

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

    Intel   Apple 芯片
    (loading…)   (loading…)

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

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

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

  3. 配置 flutter 的 PATH 环境变量：

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

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

现在你可以愉快地运行 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.cn/docs/setup/#android-setup for detailed instructions.

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

Once you have installed any missing dependencies, run the flutter doctor command again to verify that you’ve set everything up correctly.

直接从 Github 上（而不是归档）下载

该建议仅适用于高级用例

你也可以不从归档，而是用 Git 直接下载。例如，可以运行下方的命令，以下载稳定分支的 SDK：

$ git clone https://github.com/flutter/flutter.git -b stable

更新环境变量，并运行 flutter doctor。这个命令将会告诉你，是否还缺少运行 Flutter 所需要安装的其他依赖项（例如 Android SDK）。

如果你不使用归档，Flutter 将会下载必要的开发二进制文件（如果你使用的归档，那么这些文件已经包含在内了）。你也许会想要提前下载这些开发二进制文件（例如，您可能希望设置系统构建环境，或是您的网络可用性不佳）。那么你可以运行以下命令：

$ flutter precache

更多额外下载选项，请参阅 flutter help precache。

更新 PATH 环境变量

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

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

  1. 首先决定你想要将 Flutter SDK 下载或者通过 git clone 命令到哪一个目录内，获取并记录这个目录的路径，你将要在第 3 步中用到它。

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

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

    $ export PATH="$PATH:[PATH_OF_FLUTTER_GIT_DIRECTORY]/bin"

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

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

    $ echo $PATH

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

    $ which flutter

平台配置

macOS 系统可以开发支持 iOS、Android、macOS 桌面以及 Web 的 Flutter 应用，你可以任选一个平台完成初始配置，以此来搭建并运行你的第一个 Flutter 应用。

设置 iOS 开发环境

安装 Xcode

开发 iOS 平台上的 Flutter 应用，你需要一个安装了 Xcode 的 Mac 设备。

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

  2. 配置 Xcode 命令行工具以使用新安装的 Xcode 版本。从命令行中运行以下命令：

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

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

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

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

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

配置 iOS 模拟器

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

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

    $ open -a Simulator

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

  3. 根据你当前开发机器的屏幕尺寸，模拟器模拟出来的高密度屏幕的设备可能会溢出你的屏幕，你可以调整模拟器的边角来拖动改变比例，如果你的开发机分辨率很高的话，也可以通过菜单中的 Window > Physical Size or Window > Pixel Accurate 选项来更改模拟器的缩放比例。

    • 如果你只用 Xcode 版本低于 9.1，调整模拟器比例的菜单选项应该是 Window > Scale。

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

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

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

    $ flutter create my_app

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

    $ cd my_app

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

    $ flutter run

部署到 iOS 设备

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

  1. To set up physical device deployment in Xcode, connect your device to the USB port on your computer.

  2. [Optional] To leverage wireless debugging, ensure that your device is on the same network as your computer and that the device has a set passcode.

    While the device is attached, open Xcode > Window > Devices and Simulators. Select your phone, and check Connect via Network. For more details, check out Apple’s documentation on pairing a wireless device with Xcode.

    Once the network icon appears next to the device name, you can unplug your device from USB.

    Sometimes it takes longer to find network devices. If you don’t see your device listed when using flutter run, try extending the timeout: flutter run --device-timeout 10.

    For additional help troubleshooting, check out Apple’s Developer Forums. For setting up wireless debugging with flutter attach, checkout Debugging your add-to-app module.

  3. The first time you use an attached physical device for iOS development, you need to trust both your Mac and the Development Certificate on that device. On iOS 16 and higher you must also enable Developer Mode.

    Select Trust in the dialog prompt when first connecting the iOS device to your Mac.

    Trust Mac

    Then, go to the Settings app on the iOS device, select General > Device Management and trust your Certificate. For first time users, you might need to select General > Profiles > Device Management instead. On iOS 16 and higher, navigate back to the top level of the Settings app, select Privacy & Security > Developer Mode, and toggle Developer Mode on.

  4. 如果你的应用不依赖 Flutter plugins 与原生 iOS 代码交互，你可以跳过这一步。通过运行以下命令 安装和设置CocoaPods。

    $ sudo gem install cocoapods

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

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

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

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

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

      当选择了一个团队之后，Xcode 会创建和下载一个开发证书，并在你的账户里为你的设备注册，并在需要的时候创建和下载一个配置文件。

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

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

        Check the app's Bundle ID

  6. 执行 flutter run 命令，或者在 Xcode 里点击运行，来运行你的应用。

设置 Android 开发环境

安装 Android Studio

  1. 下载并安装 Android Studio。

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

  3. 运行 flutter doctor 确保 Flutter 已经定位到了你的 Android Studio 的安装位置。如果 Flutter 并未定位到，运行 flutter config --android-studio-dir <directory> 设置你的 Android Studio 的安装目录。

配置 Android 设备

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

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

  2. [可选] 要使用无线调试，启用设备上的 Wireless debugging。详细的操作步骤在 Android 文档 里有。

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

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

  5. 在终端中，运行 flutter devices 命令来确认 Flutter 是否识别到你连接的 Android 设备。默认情况下，Flutter 会使用你的 adb 工具所在的 Android SDK 版本。如果你希望 Flutter 使用不同的 Android SDK 安装版本，你必须设置 ANDROID_SDK_ROOT 环境变量到那个安装目录。

配置 Android 模拟器

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

  1. 激活机器上的 VM acceleration 选项。

  2. 打开 Android Studio，点击 Device Manager 按钮，在 Virtual 这个标签页下选择 Create Device

    • 在一些旧的 Android Studio 版本里，需要通过 Android Studio > Tools > Android > AVD Manager，然后选择 Create Virtual Device… 选项。（只有在 Android 项目中才会显示 Android 子选项。）

    • 如果你以及还没打开某个项目，你可以选择 3-Dot Menu / More Actions > Virtual Device Manager 然后选择 Create Device 选项

  3. 选择相应的设备并选择 Next 选项。

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

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

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

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

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

同意 Android 协议

在使用 Flutter 前，你必须同意 Android SDK 平台的协议。你可以在安装完上述工具后执行这一步。

  1. 打开一个已经提升管理员权限的终端窗口，运行以下命令进行协议的确认。

    $ flutter doctor --android-licenses

  2. 仔细阅读每条协议后同意。

  3. 当你同意所有协议后，再次运行 flutter doctor 以确认是否已经可以正常使用 Flutter。

macOS 安装

其他 macOS 需要的内容

对于开发 macOS 桌面端应用来说，除了 Flutter SDK 以外你还需要以下内容：

下一步

编辑器设置。