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 <subcommand>`を使用していますが、現在のディレクトリにFlutterアプリまたはその他のFlutter固有のコードがある場合は、代わりに`flutter pub <subcommand>`を使用してください。詳細については、Flutterウェブサイトのパッケージの使用を参照してください。

pubツールの使用に問題が発生した場合は、Pubのトラブルシューティングを参照してください。

以下の各pubサブコマンドの詳細なドキュメントがあります。

• add
• cache
• deps
• downgrade
• get
• global
• outdated
• publish
• remove
• token
• unpack
• upgrade

Pubのサブコマンドは、次のカテゴリに分類されます。

• パッケージの依存関係の管理
• コマンドラインアプリの実行
• パッケージとアプリのデプロイ

Pubは、コードが依存するパッケージを管理するための多くのサブコマンドを提供します。

このグループで最もよく使用されるサブコマンドは、`get`と`upgrade`で、パッケージで使用される依存関係を取得またはアップグレードします。 pubspecファイルを修正するたびに、`dart pub get`または`flutter 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/`ディレクトリ以下のすべて）を含むパッケージの場合は、pubspecファイルに`executables`タグを追加することを検討してください。スクリプトが`executables`にリストされている場合、ユーザーはdart pub global activateを実行して、コマンドラインから直接利用できるようにすることができます。

すべてpubのサブコマンドで動作するコマンドラインオプションがいくつかあります。これらには以下が含まれます。

使用方法の情報を表示します。

エラーが発生した場合にデバッグ情報を表示します。

`--verbosity=all`と同等です。

指定されたディレクトリでコマンドを実行します。

出力に強調表示のための色を追加します（`--color`）。デフォルトは、このコマンドをターミナルで使用しているかどうかによって異なります。ターミナルでは、`--color`がデフォルトです。それ以外の場合は、`--no-color`がデフォルトです。すべての環境で色を無効にするには、`--no-color`を使用します。

特に記載がない限り、このサイトのドキュメントはDart 3.5.3を反映しています。ページは2024-05-06に最終更新されました。 ソースを表示 または 問題を報告する。