內容

取得 Dart SDK

內容

本頁說明如何下載 Dart SDK。Dart SDK 包括您開發 Dart 命令列、伺服器和網頁應用程式所需的程式庫和命令列工具。

若要深入了解 Dart SDK，請查閱Dart SDK 概觀。

系統需求

#

Dart 支援下列硬體架構和平台版本，以開發和執行 Dart 程式碼。

平台x64IA32 (x86)Arm32Arm64RISC-V (RV64GC)作業系統版本
Windows已驗證回報危險已驗證請勿打擾10, 11
Linux已驗證回報已驗證已驗證已驗證Debian 穩定版,
標準支援下的Ubuntu LTS
macOS已驗證危險請勿打擾已驗證請勿打擾最新三個版本的 macOS
Sonoma (14)、Ventura (13)、Monterey (12)

verified 所有管道都支援。
error 支援已棄用，可能會在未來的 Dart 版本中移除。
report 支援已棄用，很可能會在下一個穩定版本中移除。
dangerous 所有管道都不支援。
do_not_disturb_on 作業系統不支援。

選擇安裝選項

#

若要從穩定管道安裝和更新 Dart SDK，請選擇下列其中一個選項

  1. 使用套件管理員 (建議)。

  2. 使用Dart Docker 映像。

  3. 安裝 Flutter.
    如果您已安裝或計劃安裝 Flutter SDK，則其中包含完整的 Dart SDK。Flutter SDK 在 Flutter 的 bin 資料夾中包含 dart CLI 工具。

  4. 從SDK 封存下載 ZIP 封存檔。

  5. 從原始碼建置 SDK.

安裝 Dart SDK

#

若要安裝 Dart SDK，請使用適用於您開發平台的適當套件管理員。

若要升級 Dart SDK，請執行相同的命令，從您的套件管理員安裝 Dart SDK。

  • Windows
  • Linux
  • macOS

使用 Chocolatey 安裝

#

若要安裝 Dart SDK，請使用 Chocolatey。Chocolatey 需要提高的權限。

  1. 安裝 Chocolatey。

  2. 以提高的權限啟動PowerShell。

    PS C:\> choco install dart-sdk

變更預設安裝路徑

#

依預設，Chocolatey 會將 SDK 安裝在 C:\tools\dart-sdk。若要變更該位置，請將 ChocolateyToolsLocation 環境變數設為您想要的安裝目錄。

驗證您的 PATH 是否包含 Dart

#

驗證您可以執行 Dart。

PS C:\> dart --version
Dart SDK version: 3.2.4 (stable) (Thu Dec 21 19:13:53 2023 +0000) on "win_x64"

如果您的開發機器未傳回 Dart 版本，請將 SDK 位置新增至您的 PATH

  1. 在 Windows 搜尋方塊中，輸入 env。
  2. 按一下編輯系統環境變數。
  3. 按一下環境變數...。
  4. 在使用者變數區段中，選取Path，然後按一下編輯...。
  5. 按一下新增，然後輸入 dart-sdk 目錄的路徑。
  6. 在您剛開啟的每個視窗中，按一下套用或確定以關閉它並套用路徑變更。

使用 Chocolatey 升級

#

若要升級 Dart SDK，請使用下列命令。

PS C:\> choco upgrade dart-sdk

使用 Chocolatey 解除安裝

#

若要解除安裝 Dart SDK，請執行下列步驟。

  1. 以提高的權限啟動PowerShell。

  2. 使用下列命令。

    PS C:\> choco uninstall dart-sdk

  3. 從您的主目錄移除 Dart 設定檔。

    PS C:\> Remove-Item -Recurse -Force ^
     -Path $env:LOCALAPPDATA\.dartServer,$env:APPDATA\.dart,$env:APPDATA\.dart-tool

使用 Linux 套件管理員安裝

#

您有兩個選項可以在 Ubuntu 或 Debian 上安裝 Dart SDK

  • 使用 apt-get 命令。
  • 下載 .deb 套件並執行 dpkg 命令。

使用 apt-get 套件管理員安裝

#

若要使用 apt-get 安裝 Dart，請執行下列步驟。您只需要在第一次安裝時執行步驟 1 到 3。

  1. 更新套件索引檔案並安裝安全 HTTP 套件。

    $ sudo apt-get update && sudo apt-get install apt-transport-https

  2. 下載並新增 Google Linux GPG 公開金鑰。

    $ wget -qO- https://dl-ssl.google.com/linux/linux_signing_key.pub \
  | sudo gpg  --dearmor -o /usr/share/keyrings/dart.gpg

  3. 將 Dart 套件儲存庫新增至您的 Linux 系統。

    $ echo 'deb [signed-by=/usr/share/keyrings/dart.gpg arch=amd64] https://storage.googleapis.com/download.dartlang.org/linux/debian stable main' \
  | sudo tee /etc/apt/sources.list.d/dart_stable.list

  4. 使用下列 sudo apt-get 命令。

    $ sudo apt-get update && sudo apt-get install dart

以 Debian 套件安裝

#

若要以 Debian 套件 (*.deb) 安裝 Dart SDK，請執行下列步驟。

  1. 下載 Dart SDK Debian 套件。

  2. 使用 sudo dpkg 命令安裝 *.deb 套件。

    $ sudo dpkg -i dart_3.4.0-1_amd64.deb

    將 dart_3.4.0-1_amd64.deb 取代為目前的檔案名稱。

升級 Dart SDK

#

使用您用來安裝 SDK 的相同命令。

使用 apt-get 升級

#

如果您使用 apt-get 安裝 Dart SDK，請使用下列 sudo apt-get 命令。

$ sudo apt-get update && sudo apt-get install dart

使用 dpkg 升級

#

如果您使用 dpkg 安裝 Dart SDK，請使用 sudo dpkg 命令。

$ sudo dpkg -i dart_3.2.6-1_amd64.deb

將 dart_3.4.0-1_amd64.deb 取代為新升級的檔案名稱。

解除安裝 Dart SDK

#

使用 apt-get 解除安裝

#

如果您使用 apt-get 安裝 Dart SDK，請使用 sudo apt-get remove 命令。

  1. 使用 sudo apt-get remove 命令。

    $ sudo apt-get remove -y dart

  2. 從您的主目錄移除 Dart 設定檔。

    $ rm -rf  ~/.dart*

使用 dpkg 解除安裝

#

如果您使用 dpkg 安裝 Dart SDK，請使用 sudo dpkg --purge 命令。

  1. 使用 sudo dpkg --purge 命令。

    $ sudo dpkg --purge dart

    這會同時移除設定檔。

  2. 驗證 SDK 已移除。

    $ dpkg -l | grep dart

使用 Homebrew 安裝

#

若要安裝 Dart SDK，請使用 Homebrew。

  1. 視需要安裝 Homebrew。

  2. 新增官方 tap。

    $ brew tap dart-lang/dart

  3. 安裝 Dart SDK。

    $ brew install dart

驗證 PATH 是否包含 Homebrew

#

驗證您的 PATH 是否包含Homebrew bin 目錄。設定正確的路徑可簡化使用 Dart SDK 命令，例如 dart run 和 dart format。

若要取得設定 PATH 的協助，請參閱Homebrew 常見問題。

使用 Homebrew 升級

#

若要在有新的 Dart 版本可用時升級

$ brew upgrade dart

切換 Dart 版本

#

若要在本機安裝的 Dart 版本之間切換

  1. 安裝您要切換到的版本。

    例如，若要安裝 Dart 3.1

    $ brew install dart@3.1

  2. 若要在版本之間切換，請取消連結目前的版本，並連結所需的版本。

    $ brew unlink dart@<old> \
  && brew unlink dart@<new> \
  && brew link dart@<new>

列出已安裝的 Dart 版本

#

若要查看您已安裝的 Dart 版本

$ brew info dart

使用 Homebrew 解除安裝

#

若要解除安裝 Dart SDK，請使用 Homebrew。

  1. 解除安裝 Dart SDK。

    $ brew uninstall dart

  2. 從您的主目錄移除 Dart 設定檔。

    dart
    rm -rf  ~/.dart*

發佈管道參考

#

穩定管道

#

Dart 大約每三個月會發布一個新版本到 stable（穩定）通道。目前的穩定版本為 [calculating]。

請使用 stable（穩定）通道版本來建置及部署正式版應用程式。

Stable（穩定）通道版本的版本字串格式為 x.y.z

  • x : 主要版本
  • y : 次要版本
  • z : 修補版本

穩定通道版本字串的範例包括 1.24.3 和 2.1.0。

若要安裝穩定通道版本，請依照本頁的 說明進行。

Beta 管道

#

Dart 大約每月會發布一個新版本到 beta（測試）通道。目前的測試版本為 [calculating]。

請使用 beta（測試）通道版本來測試您的應用程式與未來穩定版本的相容性。

Beta（測試）通道版本的版本字串格式為 x.y.z-a.b.beta

  • x : 主要版本
  • y : 次要版本
  • z : 修補版本
  • a : 預發行版本
  • b : 預發行修補版本

測試通道版本字串的範例包括 2.8.0-20.11.beta 和 3.3.0-205.1.beta。

若要安裝測試通道版本，請下載 SDK 的 zip 檔案。

Dev 管道

#

Dart 大約每週會發布兩次新版本到 dev（開發）通道。目前的開發版本為 [calculating]。

請使用 dev（開發）通道版本來測試最新的修正和實驗性功能。

Dev（開發）通道版本的版本字串格式為 x.y.z-a.b.dev

  • x : 主要版本
  • y : 次要版本
  • z : 修補版本
  • a : 開發版本
  • b : 開發修補版本

開發通道版本字串的範例包括 2.8.0-20.11.dev 和 3.2.12-15.33.dev。

若要安裝開發通道版本，請下載 SDK 的 zip 檔案。

除非另有說明，否則本網站上的文件反映的是 Dart 3.6.0。頁面最後更新於 2024-12-14。 檢視原始碼 或 回報問題。