Windows、macOS、または Linux の dotnet CLI ツールを使用すると、.NET プロジェクトとソリューションで NuGet パッケージを簡単にインストール、アンインストール、更新できます。 この記事では、NuGet パッケージを管理するための最も一般的な dotnet CLI コマンドについて説明します。
dotnet CLI は、.NET、.NET Core、.NET Standard SDK スタイルのプロジェクト、およびその他の SDK スタイルのプロジェクト (.NET Framework を対象とするプロジェクトなど) で実行されます。 詳細については、「 .NET プロジェクト SDK」を参照してください。
ほとんどのコマンドでは、コマンドで別のプロジェクト ファイルがオプションのスイッチとして指定されていない限り、CLI ツールは現在のディレクトリ内のプロジェクト ファイルを検索します。 コマンドとその引数の完全な一覧については、 dotnet CLI コマンドを参照してください。
[前提条件]
-
コマンドライン ツールを提供する
dotnet。 Visual Studio 2017 以降、dotnet CLI は、すべての .NET および .NET Core 関連のワークロードと共に自動的にインストールされます。
パッケージをインストールまたは更新する
dotnet add package コマンドは、プロジェクト ファイルにパッケージ参照を追加し、dotnet restore実行してパッケージをインストールします。
コマンド ラインを開き、プロジェクト ファイルを含むディレクトリに切り替えます。
NuGet パッケージをインストールするには、次のコマンドを使用します。
dotnet add package <PACKAGE_NAME>たとえば、
Newtonsoft.Jsonパッケージをインストールするには、次のコマンドを使用します。dotnet add package Newtonsoft.Jsonコマンドが完了したら、プロジェクト ファイルを開いてパッケージ参照を確認できます。
たとえば、 .csproj ファイルを開いて、追加された
Newtonsoft.Jsonパッケージ参照を確認します。<ItemGroup> <PackageReference Include="Newtonsoft.Json" Version="13.0.1" /> </ItemGroup>
パッケージの特定のバージョンをインストールする
dotnet add package コマンドは、別のバージョンを指定しない限り、パッケージの最新バージョンをインストールします。
NuGet パッケージの特定のバージョンをインストールするには、オプションの -v または --version スイッチを使用します。
dotnet add package <PACKAGE_NAME> -v <VERSION>
たとえば、 Newtonsoft.Json パッケージのバージョン 12.0.1 を追加するには、次のコマンドを使用します。
dotnet add package Newtonsoft.Json --version 12.0.1
パッケージ参照の一覧表示
dotnet list package コマンドを使用して、プロジェクトのパッケージ参照とバージョンを一覧表示します。
dotnet list package
パッケージを削除する
dotnet remove package コマンドを使用して、プロジェクト ファイルからパッケージ参照を削除します。
dotnet remove package <PACKAGE_NAME>
たとえば、 Newtonsoft.Json パッケージを削除するには、次のコマンドを使用します。
dotnet remove package Newtonsoft.Json
パッケージの復元
dotnet restore コマンドは、プロジェクト ファイルに一覧表示されるパッケージを<PackageReference>で復元します。 詳細については、 プロジェクト ファイルの PackageReference を参照してください。
.NET Core 2.0 以降の dotnet build コマンドと dotnet run コマンドは、パッケージを自動的に復元します。 NuGet 4.0 の時点で、 dotnet restore は nuget restoreと同じコードを実行します。
dotnet restoreを使用してパッケージを復元するには:
- コマンド ラインを開き、プロジェクト ファイルを含むディレクトリに切り替えます。
-
dotnet restoreを実行します。