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 依赖项。

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

您可以指定仓库以及该仓库中的分支或提交，或确切位置

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

依赖于指定 Git 仓库中的包。

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

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

与 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 源添加包。

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

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

$ dart pub add foo --sdk=flutter

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

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

报告哪些依赖项将发生变化，但不会更改任何依赖项。

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

除非另有说明，否则本网站上的文档反映了 Dart 3.5.3。页面最后更新于 2024-05-06。 查看源代码 或 报告问题.