dart pub 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 命令会创建一个锁定文件。如果已存在锁定文件，pub 会忽略该文件并从头开始生成一个新的锁定文件，使用所有依赖项的最低版本。

有关包解析和系统包缓存的更多信息，请参阅 dart pub get 文档。

可以告诉 dart 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 中，它会获取新依赖项及其任何传递依赖项。这与 dart pub get 的行为相同。

如果在运行 dart pub downgrade 之前从 pubspec 中删除了依赖项，则该依赖项将不再可用作导入。只要没有剩余的直接依赖项也依赖于它们，已删除依赖项的任何传递依赖项也会被删除。这与 dart pub get 的行为相同。

如果没有网络访问权限，仍然可以运行 dart pub downgrade。由于 pub 会将包下载到系统上所有包共享的中央缓存中，因此它通常可以在无需使用网络的情况下找到以前下载的包。

但是，默认情况下，如果存在任何托管依赖项，dart pub downgrade 会尝试联机。如果不想让 pub 执行此操作，请传递 --offline 标志。在脱机模式下，pub 仅在本地包缓存中查找，尝试从已有的缓存中找到与您的包一起使用的版本集。

有关适用于所有 pub 命令的选项，请参阅 全局选项。

默认情况下，pub 会连接到网络以检索托管包 (--no-offline)。要改用缓存的包，请使用 --offline。有关详细信息，请参阅 离线获取。

报告哪些依赖项将发生更改，但不会进行任何更改。

将 pubspec.yaml 中依赖项的下限更新为与已解析的版本匹配，并返回已更改的约束列表。可以应用于 特定依赖项。

除非另有说明，否则本网站上的文档反映了 Dart 3.5.3。页面上次更新于 2024-08-06。 查看源代码 或 报告问题。