跳到主要內容

獲取 Dart SDK

本頁面描述如何下載 Dart SDK。Dart SDK 包含開發 Dart 命令列、伺服器和 Web 應用所需的庫和命令列工具。

Dart 團隊僅支援 SDK 的最新穩定版本。有關 SDK 釋出生命週期和支援版本的完整詳細資訊,請查閱SDK 支援策略

要了解有關 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 相同的命令。

使用 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 包安裝

#

要將 Dart SDK 安裝為 Debian 包 (*.deb),請執行以下步驟。

  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 rundart format

要獲取配置 PATH 的幫助,請查閱 Homebrew 常見問題

使用 Homebrew 升級

#

當 Dart 新版本可用時升級:

brew upgrade dart

切換 Dart 版本

#

在本地安裝的 Dart 版本之間切換:

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

    例如,要安裝 Dart 3.1:

    brew install dart@3.1
  2. 要切換版本,請取消連結當前版本並連結所需版本。

    brew unlink dart@<old> \
      &#x26;&#x26; brew unlink dart@<new> \
      &#x26;&#x26; 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 大約每三個月在穩定版渠道釋出一個新版本。當前的穩定版是 [計算中]

使用穩定版渠道釋出版本來構建和部署生產應用。

穩定版渠道釋出版本字串遵循 x.y.z 格式:

  • x : 主版本
  • y : 次版本
  • z : 補丁版本

穩定版渠道版本字串的例子包括 1.24.32.1.0

要安裝穩定版渠道釋出版本,請遵循本頁上的說明

測試版渠道

#

Dart 大約每月在測試版渠道釋出一個新版本。當前的測試版是 [計算中]

使用測試版渠道釋出版本來測試你的應用與未來穩定版本的相容性。

測試版渠道釋出版本字串遵循 x.y.z-a.b.beta 格式:

  • x : 主版本
  • y : 次版本
  • z : 補丁版本
  • a : 預釋出版本
  • b : 預釋出補丁版本

測試版渠道版本字串的例子包括 2.8.0-20.11.beta3.3.0-205.1.beta

要安裝測試版渠道釋出版本,請將SDK 下載為 zip 檔案

開發版渠道

#

Dart 大約每週兩次在開發版渠道釋出一個新版本。當前的開發版是 [計算中]

使用開發版渠道釋出版本來測試最近的修復和實驗性功能。

開發版渠道釋出版本字串遵循 x.y.z-a.b.dev 格式:

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

開發版渠道版本字串的例子包括 2.8.0-20.11.dev3.2.12-15.33.dev

要安裝開發版渠道釋出版本,請將SDK 下載為 zip 檔案