dart pub add
添加 是 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.3
是 http
包的最新稳定版本,那么 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
文件中
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
。