NuGet CLI を使用して NuGet パッケージを管理する
CLI ツールを nuget.exe 使用して、Visual Studio のプロジェクトとソリューションで NuGet パッケージを管理できます。 この記事では、NuGet パッケージを管理するための最も一般的な NuGet CLI コマンドについて説明します。 これらのコマンドはすべて Windows で動作し、ほとんどのコマンドは Mac と Linux と Mono で動作します。
NuGet CLI は、.NET Standard ライブラリを対象とする SDK 以外のスタイルのプロジェクトなど、.NET Framework および SDK 以外のスタイルのプロジェクトで実行されます。 NuGet CLI コマンドでは、パッケージ参照を一覧表示する project packages.config ファイルを使用できます。 パッケージ参照に packages.config の代わりに使用PackageReferenceする SDK スタイル以外のプロジェクトの場合は、代わりに dotnet CLI を使用します。
Note
packages.config を使用する SDK スタイル以外のほとんどのプロジェクトでは、packages.config を PackageReference に移行してから、NuGet CLI ではなく dotnet CLI を使用してパッケージを管理することをお勧めします。 ただし、C++ または ASP.NET プロジェクトを移行することはできません。
ほとんどのコマンドでは、コマンドで別の場所を指定しない限り、NuGet CLI ツールは現在のディレクトリを使用します。 NuGet CLI コマンドを実行するには、コマンド ラインを開き、プロジェクト ファイルを含むディレクトリに切り替えます。
コマンドとその引数の完全な一覧については、NuGet CLI リファレンスを 参照してください。
前提条件
nuget.org から NuGet CLI をダウンロードします。nuget.exe ファイルを適切なディレクトリに保存し、ディレクトリが PATH 環境変数にあることを確認します。
Note
Windows 用の winget ツールや macOS 用の Homebrew を使用することもできます。
NuGet CLI のバージョンを確認するには、コマンド ラインを開いて実行 nuget helpするか、または上にスクロールする必要がないようにするには、次を使用 nuget help | moreします。 ヘルプ出力の最初の行は、バージョンを示しています。
パッケージをインストールする
NuGet CLI インストール コマンドは、指定された NuGet パッケージをダウンロードしてインストールします。
重要
この install コマンドでは、プロジェクト ファイルまたは packages.config ファイルは変更されません。 コマンドとrestoreコマンドはinstall、パッケージをディスクにのみ追加しますが、プロジェクトには依存関係を追加しません。 プロジェクトの依存関係を追加するには、Visual Studio パッケージ マネージャー UI または パッケージ マネージャー コンソールを使用してパッケージを追加し、次に実行installまたは restore.
このオプションを -OutputDirectory 使用して、特定のディレクトリにパッケージをインストールします。 出力ディレクトリを指定しない場合は、 install 現在のディレクトリを使用します。
nuget install <packageID | configFilePath> -OutputDirectory <outputDirectory>
たとえば、パッケージを Newtonsoft.json packages サブディレクトリにインストールするには、次のコマンドを使用します。
nuget install Newtonsoft.Json -OutputDirectory packages
インストールするパッケージを指定する代わりに、現在のディレクトリまたは別のディレクトリに既存 の packages.config ファイルを指定できます。 このコマンドはinstall、packages.config ファイルに一覧表示されているすべてのパッケージをインストールします。
nuget install packages.config
たとえば、次のコマンドは、config サブディレクトリの packages.config に一覧表示されているすべてのパッケージを packages サブディレクトリにインストールします。
nuget install config\packages.config -OutputDirectory packages
パッケージの特定のバージョンをインストールする
このコマンドは install 、別のバージョンを指定しない限り、パッケージの最新バージョンをインストールします。 パッケージの特定のバージョンをインストールするには、次のオプションを -Version 使用します。
nuget install <packageID | configFilePath> -Version <version>
たとえば、パッケージのバージョン 12.0.1 をインストールするには、次のコマンドを Newtonsoft.json 使用します。
nuget install Newtonsoft.Json -Version 12.0.1
パッケージをリストする
list コマンドを使用して、パッケージ フォルダーにインストールされているパッケージの一覧を表示します。 このオプションを -Source 使用して、リストを制限します。
nuget list -Source <source>
たとえば、MyProject の packages サブディレクトリにパッケージを一覧表示するには、次のコマンドを使用します。
nuget list -Source C:\Users\%USERNAME%\source\repos\MyProject\packages
検索用語を使用して、パッケージ名、タグ、または説明を検索することもできます。
nuget list <"search term"> -Source <source>
すべてのパッケージを更新する
update コマンドを使用して、project packages.config ファイル内のすべてのパッケージを使用可能な最新バージョンに更新します。 実行する前updateに実行restoreすることをお勧め.
nuget update
パッケージを削除する
パッケージを削除するには、プロジェクト フォルダーからそのパッケージを削除します。 パッケージを再インストールするには、またはinstallコマンドをrestore使用します。
ディスクからパッケージを削除しても、プロジェクト、 packages.config、または NuGet.Config ファイルは更新されません。 パッケージを削除する最善の方法は、Visual Studio パッケージ マネージャー UI または パッケージ マネージャー コンソールを使用することです。
パッケージの復元
NuGet CLI 復元 コマンドは、不足しているパッケージをダウンロードしてインストールします。 このコマンドは、パッケージ参照に PackageReference または packages.config を使用するプロジェクトで機能します。
同様installに、コマンドはrestoreパッケージをディスクにのみ追加しますが、プロジェクト ファイルや packages.config は変更しません。プロジェクトの依存関係を追加するには、Visual Studio パッケージ マネージャー UI またはコンソールを使用します。
パッケージを復元するには、次のコマンドを実行します。
nuget restore <projectPath>
このコマンドは restore 、指定されたプロジェクト パス内の ソリューション ファイルまたは package.config ファイルを使用します。
たとえば、MySolution.sln のすべてのパッケージを現在のディレクトリに復元するには、次のコマンドを実行します。
nuget restore MySolution.sln
Note
SDK スタイル以外のプロジェクトを使用PackageReferenceする場合は、代わりに msbuild -t:restore を使用してパッケージを復元します。
詳細については、「パッケージの復元」を参照してください。