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 时自动执行此步骤。
缓存
- 管理 pub 的本地包缓存。 使用此子命令将包添加到缓存,或执行缓存中所有包的全新重新安装。
依赖项
- 列出当前包使用的所有依赖项。
降级
- 检索当前包使用的所有依赖项中列出的最低版本的所有包。 用于测试包依赖项的下限范围。
获取
- 检索当前包的依赖项中列出的包。 如果
pubspec.lock
文件已存在,则(如果可能)获取锁定文件中列出的每个依赖项的版本。 根据需要创建或更新锁定文件。 已过时
- 查看当前包依赖的每个包,确定哪些包依赖项已过时,并为您提供有关如何更新它们的建议。 当您想要更新包依赖项时,使用此子命令。
升级
- 检索当前包使用的依赖项中列出的每个包的最新版本。 如果
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.5.3。 页面上次更新于 2024-05-06。 查看源代码 或 报告问题。