内容

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 提供了许多子命令来管理 代码依赖的包

在此组中,最常用的子命令是 getupgrade,它们分别检索或升级包使用的依赖项。 每次修改 pubspec 文件时,运行 dart pub getflutter 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 在所有环境中禁用颜色。