目录

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 <子命令>,但如果你的当前目录包含 Flutter 应用或其他 Flutter 特定代码,请改用 flutter pub <子命令>。有关详细信息,请参阅 使用包,在 Flutter 网站上。

如果你在使用 pub 工具时遇到问题,请参阅 Pub 故障排除

子命令列表

#

以下每个 pub 子命令都有详细的文档

子命令概述

#

Pub 的子命令分为以下几类

管理包依赖项

#

Pub 提供了许多子命令来管理你的代码所依赖的包

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