dart pub
pub 包管理器 具有命令行界面,可与 flutter
工具 或 dart
工具 配合使用。使用任一工具时,在 pub
命令后添加子命令,例如 get
dart pub get # Gets dependencies for a non-Flutter package
flutter pub get # Gets dependencies for a Flutter package
本网站示例使用 dart pub <subcommand>
,但如果当前目录包含 Flutter 应用或其他 Flutter 特定代码,请改用 flutter pub <subcommand>
。更多信息请参阅 Flutter 网站上的 使用包。
如果您在使用 pub 工具时遇到问题,请参阅Pub 故障排除。
子命令列表
#以下每个 pub 子命令都有详细文档
子命令概览
#Pub 的子命令分为以下几类:
管理包依赖项
#Pub 提供了许多子命令来管理 您的代码所依赖的包。
在这组命令中,最常用的是 get
和 upgrade
,它们用于检索或升级包使用的依赖项。每次修改 pubspec 文件时,都应运行 dart pub get
或 flutter pub get
以确保依赖项是最新的。某些 IDE 在项目创建时或对 pubspec 进行任何修改时会自动执行此步骤。
cache
- 管理 pub 的本地包缓存。使用此子命令可以将包添加到缓存中,或对缓存中的所有包执行干净的重新安装。
deps
- 列出当前包使用的所有依赖项。
downgrade
- 检索当前包列出的所有依赖项的最低版本。用于测试包依赖项的最低范围。
get
- 检索当前包列出的依赖项。如果
pubspec.lock
文件已存在,则(如果可能)获取锁文件中列出的每个依赖项的版本。根据需要创建或更新锁文件。 outdated
- 查看当前包依赖的所有包,确定哪些包依赖项已过时,并提供如何更新它们的建议。当您想更新包依赖项时使用此子命令。
upgrade
- 检索当前包列出的每个依赖项的最新版本。如果
pubspec.lock
文件存在,则忽略锁文件中列出的版本,并获取符合 pubspec 中约束的最新版本。根据需要创建或更新锁文件。
运行命令行应用
#global
子命令允许您使包全局可用,以便您可以运行该包的 bin
目录中的脚本。要运行全局可用的脚本,您必须 将系统缓存的 bin
目录添加到您的路径中。
部署包和应用
#使用 pub 可以发布包和命令行应用。
包
#要与全球共享您的 Dart 包,您可以使用 publish
子命令将包上传到 pub.dev 网站。有关允许其他用户修改和上传包新版本的信息,请参阅 上传者。
命令行应用
#对于包含脚本(bin/
目录下的任何内容)的任何包,考虑将 executables
标签添加到 pubspec 文件中。当脚本列在 executables
下时,用户可以运行 dart pub global activate
使其直接从命令行可用。
全局选项
#以下一些命令行选项适用于所有 pub 子命令,包括:
--help
或 -h
#打印用法信息。
--trace
#发生错误时打印调试信息。
--verbose
或 -v
#等同于 --verbosity=all
。
--directory=<目录>
或 -C <目录>
#在指定目录中运行命令。
--[no-]color
#为输出添加颜色以突出显示 (--color
)。默认设置取决于您是否在终端中使用此命令。在终端中,默认值为 --color
,否则,默认值为 --no-color
。使用 --no-color
可在所有环境中禁用颜色。