dart pub add

Add は pub ツールのコマンドの1つです。

$ 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` は、SDK の制約および依存関係と互換性のある、pub.dev サイトからのパッケージの最新の安定バージョンを使用します。たとえば、`http` パッケージの最新の安定バージョンが `0.13.3` の場合、`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=` オプションでした。:

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

`url` と一緒に、Git リポジトリの指定されたブランチまたはコミットに依存します。

以前は `--git-ref=` オプションでした。:

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

`url` と一緒に、Git リポジトリ内のパッケージの場所を指定します。

以前は `--git-path=` オプションでした。.

指定された URL のパッケージサーバーに依存するhosted 依存関係を追加します。

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

以前は `--hosted-url=` オプションでした。.

ローカルに保存されたパッケージへのpath 依存関係を追加します。

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

以前は `--path=` オプションでした。.

指定された SDK ソースからパッケージを追加します。

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

以前は `--sdk=` オプションでした。:

dart pub add foo --sdk=flutter

すべての pub コマンドに適用されるオプションについては、グローバルオプション を参照してください。

デフォルトでは、pub はホストされたパッケージを取得するためにネットワークに接続します（--no-offline）。代わりにキャッシュされたパッケージを使用するには、--offline を使用します。詳細については、オフラインでの取得を参照してください。

変更される依存関係を報告しますが、実際には何も変更しません。

デフォルトでは、pub は直接的な依存関係の実行可能ファイルをプリコンパイルします（--precompile）。プリコンパイルを防ぐには、--no-precompile を使用します。

Pub ワークスペースでは、`dart pub add` は現在のディレクトリのパッケージにのみ依存関係を追加します。