内容

添加pub 工具 的命令之一。

$ dart pub add [{dev|override}:]<package>[:descriptor] [[{dev|override}:]<package>[:descriptor] ...] [options]

此命令将指定的包添加为 pubspec.yaml 中的依赖项,然后检索依赖项以解析 pubspec.yaml

以下示例命令等效于编辑 pubspec.yaml 以添加 http 包,然后调用 dart pub get

$ dart pub add http

版本约束

#

默认情况下,dart pub add 使用来自 pub.dev 网站 的与您的 SDK 约束和依赖项兼容的最新稳定版本的包。例如,如果 0.13.3http 包的最新稳定版本,那么 dart pub add http 会在您的 pubspec.yaml 中的 dependencies 下添加 http: ^0.13.3

您也可以指定约束或约束范围

$ dart pub add foo:2.0.0
$ dart pub add foo:'^2.0.0'
$ dart pub add foo:'>=2.0.0 <3.0.1'

如果指定的包是您 pubspec.yaml 中的现有依赖项,dart pub add 会将依赖项的约束更新为命令中指定的约束。

开发依赖项

#

dev: 前缀将包添加为 开发依赖项,而不是作为常规依赖项。

$ dart pub add dev:foo           # adds newest compatible stable version of foo
$ dart pub add dev:foo:^2.0.0    # adds specified constraint of foo
$ dart pub add foo dev:bar       # adds regular dependency foo and dev dependency bar simultaneously

以前 -d, --dev 选项:

$ dart pub add --dev foo

依赖项覆盖

#

要指定 依赖项覆盖,请添加 override: 前缀并包含 版本约束源描述符

例如:要覆盖对 package:foo 的所有引用以使用包的版本 1.0.0,请运行以下命令

$ dart pub add override:foo:1.0.0

这会将覆盖添加到您的 pubspec.yaml 文件中

yaml
dependency_overrides:
  foo: 1.0.0

源描述符

#

YAML 描述符语法允许您从不同来源添加多个包,并对每个包应用不同的选项和约束。

$ dart pub add [options] [{dev|override}:]<package>[:descriptor] [[{dev|override}:]<package>[:descriptor] ...]

语法反映了 pubspec.yaml 中依赖项的编写方式。

'<package>:{"<source>":"<descriptor>"[,"<source>":"<descriptor>"],"version":"<constraint>"}'

git

#

添加 git 依赖项

$ dart pub add 'foo:{"git":"https://github.com/foo/foo"}'

您可以指定存储库、分支或提交,或该存储库内的确切位置

$ dart pub add 'foo:{"git":{"url":"../foo.git","ref":"branch","path":"subdir"}}'

url

#

依赖于指定 Git 存储库中的包。

以前 --git-url=<git_repo_url> 选项:

$ dart pub add http --git-url=https://github.com/my/http.git

ref

#

使用 url 时,取决于指定的 Git 仓库分支或提交。

以前使用 --git-ref=<branch_or_commit> 选项:

$ dart pub add http --git-url=https://github.com/my/http.git --git-ref=tmpfixes

路径

#

使用 url 时,指定 Git 仓库中包的位置。

以前使用 --git-path=<directory_path> 选项.

托管

#

添加一个依赖于指定 URL 上的包服务器的 托管依赖

$ dart pub add 'foo:{"hosted":"my-pub.dev"}'

以前使用 --hosted-url=<package_server_url> 选项.

路径

#

添加一个对本地存储的包的 路径依赖

$ dart pub add 'foo:{"path":"../foo"}'

以前使用 --path=<directory_path> 选项.

sdk

#

从指定的 SDK 源添加一个包。

$ dart pub add 'foo:{"sdk":"flutter"}'

以前使用 --sdk=<sdk_name> 选项:

$ dart pub add foo --sdk=flutter

选项

#

有关适用于所有 pub 命令的选项,请参阅 全局选项

--[no-]offline

#

默认情况下,pub 连接到网络以检索托管包 (--no-offline)。要使用缓存的包,请使用 --offline。有关详细信息,请参阅 离线获取

-n, --dry-run

#

报告哪些依赖项将发生变化,但不进行任何更改。

--[no-]precompile

#

默认情况下,pub 会预编译直接依赖项中的可执行文件 (--precompile)。要阻止预编译,请使用 --no-precompile