dart pub downgrade 命令

Downgrade 命令是 Pub 工具 中的一个命令。

$ dart pub downgrade [--[no-]offline] [-n|--dry-run] [dependencies...]

在没有其它额外参数的情况下， dart pub downgrade 命令会获取当前工作目录下 pubspec.yaml 文件中列出的所有依赖项以及它们 间接依赖项 的最低版本。例如：

$ dart pub downgrade
Resolving dependencies... (1.2s)
+ barback 0.13.0
+ collection 0.9.1
+ path 1.2.0
+ source_maps 0.9.0
+ source_span 1.0.0
+ stack_trace 0.9.1
Changed 6 dependencies!

dart pub downgrade 命令会创建一个 lockfile 文件。如果 lockfile 文件已经存在，Pub 则会忽略该文件并通过 Scratch 生成一个新的 lockfile 文件，然后所有依赖项都会使用最低版本。

请查阅 dart pub get 命令文档 获取更多关于 Package 解析和系统 Package 缓存的信息。

你可以指定 pub downgrade 命令只将某个依赖项的版本降至最低且不影响其余依赖项。例如：

$ dart pub downgrade test
Resolving dependencies...
  barback 0.15.2+2
  bot 0.27.0+2
  browser 0.10.0+2
  chrome 0.6.5
  collection 1.1.0
  path 1.3.0
  pool 1.0.1
  source_span 1.0.2
< stack_trace 0.9.2 (was 1.1.1)
  stagexl 0.10.2
< test 0.10.0 (was 0.11.4)
These packages are no longer being depended on:
- matcher 0.11.3
Changed 3 dependencies!

如果你降低指定依赖项的版本，且该依赖项还有间接依赖项，那么在版本变更后这些间接依赖项可能不适配降低后的新版依赖项。此时，Pub 会尝试在新版本依赖项可接受的范围内查找版本最高的该依赖项所依赖的间接依赖项。因此，通常而言，降低某个依赖项的版本后，其间接依赖项的版本也会随之降低。

如果在执行 dart pub downgrade 命令前将某个依赖添加至 pubspec 文件中，则在执行该命令后会将该新的依赖项以及其间接依赖的其它依赖项下载并将其放到 .packages 文件中。这点与 dart pub get 命令一致。

如果在 dart pub downgrade 命令前从 pubspec 文件移除了某个依赖项，则在执行该命令后代码使用到该依赖项的相关导入将变得不可用。所有该依赖项依赖的间接依赖项也同时会被移除，只要这些间接依赖项没有没其它的依赖项所依赖。这点与 dart pub get 命令一致。

在没有网络的情况下你也依然可以运行 dart pub downgrade 命令。因为 Pub 会将 Package 下载到一个统一的缓存区并将其与系统上其它的 Package 进行共享，如果你所需的 Package 是一个使用频率很高的 Package，那么很有可能它已经被其它 Package 在使用时下载到统一缓存区中了，此时你可以直接依赖使用它。

但是，默认情况下，dart pub downgrade 命令会总是尝试获取线上的依赖版本，因此 Pub 可以确定依赖项是否有更新的版本。如果你不想 Pub 去线上检查，可以使用 --offline 命令参数让该命令在离线模式下执行。在离线模式下，Pub 只会从本地缓存区查找已经下载到的可用 Package。

dart pub upgrade 命令支持 pub get 的命令选项。

你可以查阅 全局选项 获取 Pub 命令所支持的命令选项。

默认情况下，pub 会从网络上拉取 package (--no-offline)。若你想使用本地的 package，使用 --offline 参数。想了解更多细节，请查看 离线获取 package.

报告将要改变的依赖项，但不会真的改变它。