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=<dir>
或 -C <dir>
#在指定目录中运行命令。
--[no-]color
#为输出添加颜色以突出显示 (--color
)。默认值取决于您是否在终端中使用此命令。在终端中,--color
是默认值,否则,--no-color
是默认值。使用 --no-color
在所有环境中禁用颜色。
除非另有说明,否则本网站上的文档反映的是 Dart 3.7.1。页面最后更新于 2024-11-18。 查看源代码 或 报告问题。