跳至主要內容
目錄

開始在 macOS 上建置 Flutter 原生桌面應用程式

目錄

驗證系統需求

#

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

硬體需求

#

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

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

軟體需求

#

若要撰寫和編譯桌面的 Flutter 程式碼，請安裝下列套件。

作業系統

#

Flutter 支援在 macOS 11 (Big Sur) 或更新版本上進行開發。本指南假設您的 Mac 使用 zsh 作為預設 Shell。

若要驗證您的 Shell 設定，請展開此區段

與大多數類 UNIX 作業系統一樣，macOS 可以支援多個 Shell，例如 bash、zsh 和 sh。自 2019 年 10 月 macOS Catalina (macOS 10.15) 發布以來，Zsh 或 zsh 是 macOS 的預設 Shell。

檢查並將 zsh 設定為預設值

#

  1. 若要驗證 zsh 已設定為預設 macOS Shell，請執行目錄服務命令列公用程式。

    dscl . -read ~/ UserShell

    命令應列印下列內容作為回應。

    UserShell: /bin/zsh

    您可以跳過其餘步驟。

  2. 如果您需要安裝 zsh，請按照此 Wiki 中的程序進行。

  3. 如果您需要將預設 Shell 變更為 zsh，請執行 chsh 命令。

    chsh -s `which zsh`

若要深入瞭解 macOS 和 zsh，請查看 macOS 文件中的在 Mac 上使用 zsh 作為預設 Shell。

某些 Flutter 元件需要在執行Apple 晶片的 Mac 上使用 Rosetta 2 轉譯程序。若要在 Apple 晶片上執行所有 Flutter 元件，請安裝 Rosetta 2。

sudo softwareupdate --install-rosetta --agree-to-license

開發工具

#

下載並安裝下列套件。

  • Xcode 16 可偵錯和編譯原生 Swift 或 ObjectiveC 程式碼。Xcode 安裝包含 Git 2.27 或更新版本，以管理原始碼。
  • CocoaPods 1.16 可編譯原生應用程式中的 Flutter 外掛程式。

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

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

文字編輯器或整合開發環境

#

您可以使用任何文字編輯器或整合開發環境 (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. 若要開啟命令選擇區，請按下Command + 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. 若要在所有終端機視窗中啟用 flutter

    1. 關閉，然後重新開啟所有終端機視窗。
    2. 重新啟動 VS Code。

下載然後安裝 Flutter

#

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

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

    Intel 處理器Apple 晶片
    (正在載入...)(正在載入...)

    如需其他發行通道和較舊的組建，請查看SDK 封存。

    Flutter SDK 應該會下載到 macOS 的預設下載目錄：~/Downloads/。

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

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

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

    unzip ~/Downloads/flutter_sdk_v1.0.0.zip \
       -d ~/development/

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

將 Flutter 新增至您的 PATH

#

若要在終端機中執行 Flutter 命令，請將 Flutter 新增至 PATH 環境變數。本指南假設您的 Mac 執行最新的預設 Shell，zsh。Zsh 使用 .zshenv 檔案進行環境變數。

  1. 啟動您慣用的文字編輯器。

  2. 如果存在，請在文字編輯器中開啟 Zsh 環境變數檔案 ~/.zshenv。如果不存在，請建立 ~/.zshenv。

  3. 複製下列程式碼行並將其貼到 ~/.zshenv 檔案的結尾。

    bash
    export PATH=$HOME/development/flutter/bin:$PATH

  4. 儲存您的 ~/.zshenv 檔案。

  5. 若要套用此變更，請重新啟動所有開啟的終端機工作階段。

如果您使用其他 Shell，請查看此關於設定 PATH 的教學課程。

設定 iOS 開發

#

安裝並設定 Xcode

#

若要開發桌面的 Flutter 應用程式，請安裝 Xcode 以編譯為原生位元組碼。

  1. 開啟 App Store 並登入。

  2. 搜尋 Xcode。

  3. 按一下安裝。

    Xcode 安裝程式會佔用 6 GB 以上的儲存空間。下載可能需要一些時間。

  4. 若要設定命令列工具以使用已安裝的 Xcode 版本，請使用下列命令。

    sudo sh -c 'xcode-select -s /Applications/Xcode.app/Contents/Developer && xcodebuild -runFirstLaunch'

    針對最新版本的 Xcode 使用此路徑。如果您需要使用不同的版本，請改為指定該路徑。

  5. 簽署 Xcode 授權合約。

    sudo xcodebuild -license

盡量使用目前版本的 Xcode。

安裝 CocoaPods

#

如果您的應用程式依賴具有原生桌面程式碼的Flutter 外掛程式，請安裝 CocoaPods。此程式會將 Flutter 和桌面程式碼的各種相依性捆綁在一起。

若要安裝和設定 CocoaPods，請執行下列命令

  1. 依照CocoaPods 安裝指南安裝 cocoapods。

    sudo gem install cocoapods

  2. 啟動您慣用的文字編輯器。

  3. 在您的文字編輯器中開啟 Zsh 環境變數檔案 ~/.zshenv。

  4. 複製下列程式碼行並將其貼到 ~/.zshenv 檔案的結尾。

    bash
    export PATH=$HOME/.gem/bin:$PATH

  5. 儲存您的 ~/.zshenv 檔案。

  6. 若要套用此變更，請重新啟動所有開啟的終端機工作階段。

檢查您的開發設定

#

help 說明

執行 Flutter doctor

#

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

  1. 開啟您的終端機。

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

    flutter doctor

由於您選擇開發桌面版，因此您不需要所有元件。如果您依照本指南操作，您的命令結果應如下所示

Running flutter doctor...
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.24.5, on macOS 14.4.0 23E214 darwin-arm64, locale en)
[!] Android toolchain - develop for Android devices
[!] Chrome - develop for the web
[✓] Xcode - develop for iOS and macOS (Xcode 16)
[!] Android Studio (not installed)
[✓] VS Code (version 1.95)
[✓] Connected device (1 available)
[✓] Network resources


! Doctor found issues in 3 categories.

疑難排解 Flutter doctor 問題

#

當 flutter doctor 命令傳回錯誤時，可能是 Flutter、VS Code、Xcode、連接的裝置或網路資源造成的。

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

flutter doctor -v

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

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

開始使用 Flutter 開發 macOS 桌面應用程式

#

恭喜。在安裝所有先決條件和 Flutter SDK 之後，您可以開始開發適用於 macOS 桌面的 Flutter 應用程式。

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

管理您的 Flutter SDK

#

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

除非另有說明，本網站的文件皆反映 Flutter 的最新穩定版本。頁面最後更新於 2024-10-28。 檢視原始碼 或 回報問題。