跳至主要內容

開始在 Linux 上建置 Flutter Web 應用程式

驗證系統需求

#

若要安裝並執行 Flutter,您的 Linux 環境必須符合下列硬體和軟體需求。

硬體需求

#

您的 Linux Flutter 開發環境必須符合下列最低硬體需求。

需求最低建議
CPU 核心48
記憶體 (GB)816
顯示解析度 (像素)WXGA (1366 x 768)FHD (1920 x 1080)
可用磁碟空間 (GB)11.060.0

軟體需求

#

若要撰寫並編譯 Web 的 Flutter 程式碼,您必須擁有下列 Linux 版本和列出的軟體套件。

作業系統

#

Flutter 支援 Debian Linux 11 或更新版本,以及 Ubuntu Linux 20.04 LTS 或更新版本。

開發工具

#

若要在 Linux 上開發 Flutter

  1. 安裝下列套件:curlgitunzipxz-utilsziplibglu1-mesa

    sudo apt-get update -y && sudo apt-get upgrade -y;
    sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa
  2. 安裝 Google Chrome 以除錯 Web 應用程式的 JavaScript 程式碼。

如何從命令列安裝 Chrome
wget https://dl-ssl.google.com/linux/linux_signing_key.pub -O /tmp/google.pub
gpg --no-default-keyring \
        --keyring /etc/apt/keyrings/google-chrome.gpg \
        --import /tmp/google.pub
echo 'deb [arch=amd64 signed-by=/etc/apt/keyrings/google-chrome.gpg] http://dl.google.com/linux/chrome/deb/ stable main' | sudo tee /etc/apt/sources.list.d/google-chrome.list
sudo apt-get update -y; sudo apt-get install -y google-chrome-stable

當您執行目前版本的 flutter doctor 時,它可能會列出這些套件中其中一個不同的版本。如果有的話,請安裝它建議的版本。

上述軟體的開發人員會提供這些產品的支援。若要疑難排解安裝問題,請參閱該產品的文件。

設定文字編輯器或 IDE

#

您可以使用任何文字編輯器或整合開發環境 (IDE) 搭配 Flutter 的命令列工具來建置應用程式。

使用具有 Flutter 擴充功能或外掛程式的 IDE 可提供程式碼完成、語法醒目提示、小工具編輯輔助、除錯和其他功能。

熱門選項包括

安裝 Flutter SDK

#

若要安裝 Flutter SDK,您可以使用 VS Code Flutter 擴充功能,或自行下載並安裝 Flutter 套件。

使用 VS Code 安裝 Flutter

#

若要依照這些指示安裝 Flutter,請確認您已安裝 Visual Studio Code 1.77 或更新版本,以及 VS Code 的 Flutter 擴充功能

提示 VS Code 安裝 Flutter

#
  1. 啟動 VS Code。

  2. 若要開啟命令面板,請按下 Control + Shift + P

  3. 命令面板中,輸入 flutter

  4. 選取Flutter:新專案

  5. VS Code 會提示您在電腦上找到 Flutter SDK。

    1. 如果您已安裝 Flutter SDK,請按一下尋找 SDK

    2. 如果您尚未安裝 Flutter SDK,請按一下下載 SDK

      如果您尚未依照開發工具先決條件中的指示安裝 Git,此選項會將您傳送到 Flutter 安裝頁面。

  6. 當提示要使用哪個 Flutter 範本?時,請忽略它。按下 Esc。您可以在檢查您的開發設定後建立測試專案。

下載 Flutter SDK

#
  1. 當顯示選取 Flutter SDK 的資料夾對話方塊時,請選擇您想要安裝 Flutter 的位置。

    VS Code 會將您放置在您的使用者設定檔中以開始。請選擇其他位置。

    請考慮 ~/development/

  2. 按一下複製 Flutter

    下載 Flutter 時,VS Code 會顯示此彈出式通知

    Downloading the Flutter SDK. This may take a few minutes.

    此下載需要幾分鐘的時間。如果您懷疑下載已停止,請按一下取消,然後重新開始安裝。

  3. 下載完成 Flutter 後,會顯示輸出面板。

    Checking Dart SDK version...
    Downloading Dart SDK from the Flutter engine ...
    Expanding downloaded archive...

    成功時,VS Code 會顯示此彈出式通知

    Initializing the Flutter SDK. This may take a few minutes.

    在初始化時,輸出面板會顯示下列內容

    Building flutter tool...
    Running pub upgrade...
    Resolving dependencies...
    Got dependencies.
    Downloading Material fonts...
    Downloading Gradle Wrapper...
    Downloading package sky_engine...
    Downloading flutter_patched_sdk tools...
    Downloading flutter_patched_sdk_product tools...
    Downloading windows-x64 tools...
    Downloading windows-x64/font-subset tools...

    此程序也會執行 flutter doctor -v。在此程序的這一步驟中,請忽略此輸出。Flutter Doctor 可能會顯示不適用於此快速入門的錯誤。

    當 Flutter 安裝成功時,VS Code 會顯示此彈出式通知

    Do you want to add the Flutter SDK to PATH so it's accessible
    in external terminals?
  4. VS Code 可能會顯示 Google Analytics 通知。

    如果您同意,請按一下確定

  5. 若要在所有 Shell 視窗中啟用 flutter

    1. 關閉,然後重新開啟所有 Shell 視窗。
    2. 重新啟動 VS Code。

下載然後安裝 Flutter

#

若要安裝 Flutter,請從其封存下載 Flutter SDK 套件、將套件移動到您想要儲存的位置,然後解壓縮 SDK。

  1. 下載下列安裝套件以取得 Flutter SDK 的最新穩定版本。

    (載入中...)

    如需其他發佈通道和較舊的版本,請查看SDK 封存

    Flutter SDK 應下載到 Linux 預設下載目錄:~/Downloads/

  2. 建立一個資料夾,您可以在其中安裝 Flutter。

    請考慮在 ~/development/ 建立目錄。

  3. 將檔案解壓縮到您要儲存 Flutter SDK 的目錄中。

    tar -xf ~/Downloads/flutter_sdk_v1.0.0.zip -C ~/development/

    完成後,Flutter SDK 應位於 ~/development/flutter 目錄中。

將 Flutter 新增至您的 PATH

#

若要在 Shell 中執行 Flutter 命令,請將 Flutter 新增至 PATH 環境變數。

  1. 檢查當您開啟新的主控台視窗時,哪個 Shell 會啟動。這將是您的預設 Shell

    echo $SHELL

    這與告訴您哪個 Shell 在您目前的主控台中執行的另一個命令不同。

    echo $0
  2. 若要將 Flutter 新增至您的 PATH,請展開您預設 Shell 的項目,然後選擇命令。

    顯示bash命令
    echo 'export PATH="~/development/flutter/bin:$PATH"' >> ~/.bash_profile
    顯示zsh命令
    echo 'export PATH="~/development/flutter/bin:$PATH"' >> ~/.zshenv
    顯示fish命令
    fish_add_path -g -p ~/development/flutter/bin
    顯示csh命令
    echo 'setenv PATH "~/development/flutter/bin:$PATH"' >> ~/.cshrc
    顯示tcsh命令
    echo 'setenv PATH "~/development/flutter/bin:$PATH"' >> ~/.tcshrc
    顯示ksh命令
    echo 'export PATH="~/development/flutter/bin:$PATH"' >> ~/.profile
    顯示sh命令
    echo 'export PATH="~/development/flutter/bin:$PATH"' >> ~/.profile
  3. 若要套用此變更,請重新啟動所有開啟的終端機工作階段。

檢查您的開發設定

#

help 說明

執行 Flutter doctor

#

flutter doctor 命令會驗證 Linux 完整 Flutter 開發環境的所有元件。

  1. 開啟 Shell。

  2. 若要驗證所有元件的安裝,請執行下列命令。

    flutter doctor

當您選擇為 Web 開發時,您不需要所有元件。如果您遵循本指南,您的命令結果應類似

Running flutter doctor...
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.24.5, on Ubuntu 20.04 (LTS), locale en)
[!] Android toolchain - develop for Android devices
[✓] Chrome - develop for the web
[!] Android Studio (not installed)
[!] Linux toolchain - develop for Linux desktop
[✓] VS Code (version 1.95)
[✓] Connected device (1 available)
[✓] Network resources


! Doctor found issues in 3 categories.

疑難排解 Flutter doctor 問題

#

flutter doctor 命令傳回錯誤時,可能是因為 Flutter、VS Code、其中一個 Linux 程式庫、已連線的裝置或網路資源。

如果 flutter doctor 命令針對任何這些元件傳回錯誤,請使用詳細模式旗標再次執行它。

flutter doctor -v

檢查輸出是否有您可能需要安裝的其他軟體或要執行的其他工作。

如果您變更 Flutter SDK 或其相關元件的組態,請再次執行 flutter doctor 以驗證安裝。

開始使用 Flutter 在 Linux 上開發 Web 應用程式

#

恭喜您。在安裝所有先決條件和 Flutter SDK 後,您可以在 Linux 上開始開發適用於 Web 的 Flutter 應用程式。

若要繼續您的學習旅程,請參閱下列指南

管理您的 Flutter SDK

#

若要深入瞭解如何管理您的 Flutter SDK 安裝,請參閱下列資源。