目錄
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.tw/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

下一步

編輯器設定。