目录
description bug_report

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

目录

系统配置要求

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

  • 操作系统: Linux (64 位)

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

  • 命令工具: Flutter 需要以下命令行工具：

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

  • 公用库: Flutter 的 test 命令需要 libGLU.so.1 库。 mesa 套件已经包含了这个库：在 Ubuntu/Debian 上是 libglu1-mesa，在 Fedora 上是 mesa-libGLU。

获取 Flutter SDK

在使用 Linux 时，你可以通过如下的方式安装 Flutter。

方式 1：使用 snapd 安装 Flutter

使用 snapd 在 Linux 上安装 Flutter 是最直接的方式。

更多使用 snapd 的教程，请查看 安装 snapd。

安装 snapd 后，你可以 通过 Snap 商店来安装 Flutter，或者通过以下命令安装：

$ sudo snap install flutter --classic

方式 2：手动安装 Flutter

如果你没有 snapd，那么你可以通过以下步骤安装 Flutter。

  1. 通过下载下面的安装包以获得最新 stable release 版本的 Flutter SDK：

    (loading…)

    对于其他发布频道以及更久的构建版本，请查看 SDK 发布 页面。

  2. 将文件解压到合适的地方，例如：

     $ cd ~/development
 $ tar xf ~/Downloads/flutter_linux_vX.X.X-stable.tar.xz

  3. 将 flutter 工具添加到环境变量中：

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

    用这个命令添加 PATH 仅在当前的命令行视窗生效。要将 Flutter 永久添加到环境变量中，请参阅 更新你的路径。

  4. （可选）预下载开发二进制文件：

     $ flutter precache

    你可以执行 flutter help precache 查看其他的下载选项。

运行 flutter doctor 校验安装

安装 Flutter 后，运行 flutter doctor：

$ flutter doctor

该命令将检查你的环境情况并显示汇报在命令行窗口中。 Dart SDK 已经绑在 Flutter 中了；你无需单独再安装 Dart。

若你想了解你需要进一步配置的内容，使用 -v 运行：

$ flutter doctor -v

仔细检查你是否还有需要配置的内容或者要执行的任务（例如加粗显示的内容）。

flutter doctor -v 命令可能会包含以下内容：

[-] Android toolchain - develop for Android devices
    • Android SDK at /Users/dash/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.

上面的部分描述了如何执行这些任务，并完成设置流程。

当你已经执行了列出的所有任务后，再次运行 flutter doctor 命令以验证这些构建是否设置正确。

更新 path

无论你如何安装 Flutter，都需要将 Flutter SDK 添加到你的 PATH 中。为了当前会话或今后所有的会话能够正常使用，你需要将 Flutter 添加到你的 PATH 中。

仅更新当前会话的 path

请在终端中输入以下指令，更新当前会话的 PATH 变量：

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

在此指令中，将 [PATH_TO_FLUTTER_GIT_DIRECTORY] 替换为 Flutter SDK 的安装路径。

为今后所有会话更新 path

请按照以下步骤，将 Flutter 添加到 所有 终端会话的 PATH 中：

  1. 找到 Flutter SDK 的安装路径。

     $ find / -type d -wholename "flutter/bin" 2>/dev/null

    回复应该类似于：

     /usr/<example>dev/flutter/bin

  2. 将下面这一行添加到 rc shell 文件中， Linux 在每次打开终端时都会读取 rc shell 的文件内容。

    将 <path_to_flutter_directory> 替换为 Flutter 路径

     $ echo 'export PATH="$PATH:<path_to_flutter_directory>/flutter/bin"' >> $HOME/.bashrc

  3. 重新加载当前 shell 配置文件。

     source $HOME/.<rc file>

  4. 验证 PATH 中是否存在 flutter/bin 目录。

     $ echo $PATH

    回复应该类似于：

     /usr/<example>/dev/flutter/bin:/usr/local/git/git-google/bin:/usr/local/git/current/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/sbin:/usr/sbin:/sbin:

  5. 验证现在是否可用 flutter 指令。

     $ which flutter

    回复应该类似于：

       /usr/<example>/dev/flutter/bin/flutter

设置 Android 开发环境

安装 Android Studio

help Help

  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 设备

help Help

在 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 模拟器

help Help

根据以下步骤来将 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 协议

help Help

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

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

    $ flutter doctor --android-licenses

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

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

Linux 安装

Linux 准备工作

对于开发 Linux 桌面端应用来说，你需要以下工具：

请运行以下指令，安装每个工具：

$ sudo apt-get install clang cmake git ninja-build pkg-config libgtk-3-dev liblzma-dev libstdc++-12-dev

下一步

编辑器设置。