在 Linux 操作系统上安装和配置 Flutter 开发环境

系统配置要求

要想安装和运行 Flutter，你的开发环境至少应该满足如下的需求：

  • 操作系统: Linux (64 位)

  • 磁盘空间: 600MB (不包含安装 IDE 和其他工具的空间)

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

    • bash
    • curl
    • git 2.x
    • mkdir
    • rm
    • unzip
    • which
    • xz-utils

  • 公用库: Flutter 的 test 命令需要你的系统安装或存在如下的公用库。

    • libGLU.so.1 - 由 mesa 套件 (packages) 提供，比如 Ubuntu/Debian 系统下的 libglu1-mesa

获取 Flutter SDK

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

(loading…)

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

  • 将文件解压到目标路径, 比如:
  1. $ cd ~/development
  2. $ tar xf ~/Downloads/flutter_linux_vX.X.X-stable.tar.xz
  • 配置 flutter 的 PATH 环境变量：
  1. $ export PATH="$PATH:`pwd`/flutter/bin"

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

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

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

  1. $ flutter precache

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

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

备忘

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

运行 flutter doctor 命令

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

  1. $ flutter doctor

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

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

  1. [-] Android toolchain - develop for Android devices
  2.     • Android SDK at /Users/obiwan/Library/Android/sdk
  3.     ✗ Android SDK is missing command line tools; download from https://goo.gl/XxQghQ
  4.     • Try re-installing or updating your Android SDK,
  5.       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。

Update your path

You can update your PATH variable for the current session atthe command line, as shown in Get the Flutter SDK.You’ll probably want to update this variable permanently,so you can run flutter commands in any terminal session.

The steps for modifying this variable permanently forall terminal sessions are machine-specific.Typically you add a line to a file that is executedwhenever you open a new window. For example:

  • Determine the directory where you placed the Flutter SDK.You need this in Step 3.
  • Open (or create) the rc file for your shell.For example, Linux uses the Bash shell by default,so edit $HOME/.bashrc.If you are using a different shell, the file pathand filename will be different on your machine.
  • Add the following line and change[PATH_TO_FLUTTER_GIT_DIRECTORY] to bethe path where you cloned Flutter’s git repo:
  1. $ export PATH="$PATH:[PATH_TO_FLUTTER_GIT_DIRECTORY]/flutter/bin"
  • Run source $HOME/.<rc file>to refresh the current window,or open a new terminal window toautomatically source the file.
  • Verify that the flutter/bin directoryis now in your PATH by running:
  1. $ echo $PATH

Verify that the flutter command is available by running:

  1. $ which flutter

Update path directly

In some cases, your distribution may not permanently acquirethe path when using the above directions. When this occurs,you can change the environment variables file directly.These instructions require administrator privileges:

  • Determine the directory where you placed the Flutter SDK.

  • Locate the etc directory at the root of the system,and open the profile file with root privileges.

  1.   $ sudo nano /etc/profile
  • Update the PATH string with the location of yourFlutter SDK directory.
  1. if [ "`id -u`" -eq 0 ]; then
  2.    PATH="..."
  3. else
  4.    PATH="/usr/local/bin:...:[PATH_TO_FLUTTER_GIT_DIRECTORY]/flutter/bin"
  5. fi
  6. export PATH
  • End the current session or reboot your system.
  • Once you start a new session, verify that theflutter command is available by running:
  1. $ which flutter

For more details on setting the path in Bash,see this StackExchange question.For information on setting the path in Z shell,see this StackOverflow question.

设置 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 浏览器。

下一步

编辑器设置。