目录

dart pub

pub 包管理器 拥有一个命令行界面,可与 flutter 工具 或 dart 工具 一起使用。使用任一工具,添加 pub 命令,后跟子命令,例如 get :

$ dart pub get    # 获取非 Flutter 包的依赖项
$ flutter pub get # 获取 Flutter 包的依赖项

本网站在其示例中使用 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 可在所有环境中禁用颜色。