dotnet CLI を使用して NuGet パッケージをインストールし、管理する

[アーティクル]
12/22/2023

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 コマンドを参照してください。

前提条件

.NET Core SDK。これは、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> と表示されるパッケージを復元します。詳細については、プロジェクトファイルのパッケージ参照に関するページを参照してください。

.NET Core 2.0 以降は、dotnet build コマンドと dotnet run コマンドで、パッケージが自動的に復元されます。 NuGet 4.0 以降、dotnet restore と同じコードの nuget restore が実行されます。

dotnet restore でパッケージを復元するには:

コマンドラインを開き、プロジェクトファイルが含まれるディレクトリに切り替えます。
dotnet restore を実行します。