内容

获取 Dart SDK

本页面介绍如何下载 Dart SDK。Dart SDK 包含开发 Dart 命令行、服务器和网络应用所需的库和命令行工具。

要详细了解 Dart SDK,请参阅 Dart SDK 概览

系统要求

#

Dart 支持以下硬件架构和平台版本,用于开发和运行 Dart 代码。

平台IA32 (x86)x64Arm32Arm64RISC-V (RV64GC)操作系统版本
Windows错误已验证危险已验证do_not_disturb_on10, 11
Linux错误已验证已验证已验证已验证Debian 稳定版,
Ubuntu LTS 在标准支持下
macOS危险已验证do_not_disturb_on已验证do_not_disturb_onmacOS 最新三个版本
Sonoma (14),Ventura (13),Monterey (12)

verified 在所有渠道上受支持。
error 支持已弃用,并且可能会在未来的 Dart 版本中删除。
dangerous 在所有渠道上不受支持。
do_not_disturb_on 不受操作系统支持。

选择安装选项

#

要从稳定渠道安装和更新 Dart SDK,请选择以下选项之一

  1. 使用包管理器(推荐)。
  2. 使用 Dart Docker 镜像
  3. SDK 存档 下载
  4. 安装 Flutter
  5. 从源代码构建 SDK

如果您已安装或计划 安装 Flutter SDK,则其中包含完整的 Dart SDK。Flutter SDK 包含 Flutter bin 文件夹中的 dart CLI 工具。

使用软件包管理器安装 Dart SDK

#

使用您平台的包管理器安装 Dart SDK。

使用 Chocolatey 安装

#

要安装 Dart SDK,请使用 Chocolatey。Chocolatey 需要 提升的权限

安装 Chocolatey,然后使用提升的权限运行 命令提示符

C:\> choco install dart-sdk

更改默认安装路径

#

默认情况下,Chocolatey 将 SDK 安装在 C:\tools\dart-sdk 中。要更改该位置,请将 ChocolateyToolsLocation 环境变量设置为所需的安装目录。

验证 PATH 中是否包含 Dart

#

验证是否可以运行 Dart。

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. 在用户变量部分中,选择路径并单击编辑...
  5. 单击新建,并输入 dart-sdk 目录的路径。
  6. 在刚刚打开的每个窗口中,单击应用确定以关闭窗口并应用路径更改。

使用 Chocolatey 升级

#

要升级 Dart SDK

C:\> choco upgrade dart-sdk

使用包管理器安装

#

选择使用 apt-get 安装或下载 .deb 包。

无论哪种方法,只要 Dart 发布新版本,都会触发 SDK 更新。

使用 apt-get 安装

#

仅对首次安装执行以下步骤。

  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

使用 sudo 安装 Dart SDK。

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

安装 Debian 包

#

要将 Dart SDK 安装为 Debian 包 (*.deb)。

  1. 将 Dart SDK 下载为 Debian 包

  2. 使用以下两种方法之一安装 *.deb

    • 在 GUI 中,双击 .deb 文件。

    • 在终端中,运行以下命令

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

使用 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 [email protected]
  2. 要切换版本,取消链接当前版本并链接所需版本。

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

列出已安装的 Dart 版本

#

要查看已安装的 Dart 版本

$ brew info dart

发行渠道参考

#

稳定渠道

#

Dart 大约每三个月向稳定频道发布一个新版本。当前稳定版本为 [calculating]

使用稳定频道版本进行构建和部署生产应用。

稳定频道版本字符串遵循 x.y.z 格式

  • x:主版本
  • y:次要版本
  • z:修补程序版本

稳定频道版本字符串的示例包括 1.24.32.1.0

要安装稳定频道版本,请按照此页面上的说明进行操作。

测试渠道

#

Dart 大约每月向测试版频道发布一个新版本。当前测试版版本为 [calculating]

使用测试版频道版本测试您的应用与未来稳定版本的兼容性。

测试版频道版本字符串遵循 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 大约每周向开发频道发布一个新版本。当前开发版本为 [calculating]

使用开发频道版本测试最近的修复和实验性功能。

开发频道版本字符串遵循 x.y.z-a.b.dev 格式

  • x:主版本
  • y:次要版本
  • z:修补程序版本
  • a:开发版本
  • b:开发修补程序版本

开发频道版本字符串的示例包括 2.8.0-20.11.dev3.2.12-15.33.dev

要安装开发频道版本,请下载SDK 作为 zip 文件