Visual Studio Code での NuGet
NuGet は .NET 用のパッケージ マネージャーです。NuGet は、.NET 用のパッケージがどのように作成、ホスト、および使用されるかを定義し、これらの各機能のツールを提供します。NuGet はプロジェクトに代わって依存関係ツリーも管理するため、プロジェクトで直接使用しているパッケージにのみ集中できます。
Visual Studio Code では、NuGet パッケージを C# Dev Kit ソリューション エクスプローラーから直接管理するか、コマンド パレットを使用して管理できます。
NuGet の詳細については、NuGet ドキュメントを参照してください。
C# Dev Kit の NuGet コマンド
C# Dev Kit では、NuGet パッケージ操作を次の 2 つの方法のいずれかで実行できます
-
コマンド パレットを使用する (⇧⌘P (Windows、Linux Ctrl+Shift+P))
-
C# Dev Kit ソリューション エクスプローラーで右クリックする
次のセクションでは、これら 2 つの方法の両方を使用して、各 NuGet コマンドを使用する方法について説明します。
パッケージの追加
-
NuGet パッケージをプロジェクトに追加するには、コマンド パレット (⇧⌘P (Windows、Linux Ctrl+Shift+P)) で NuGet: NuGet パッケージの追加 コマンドを使用します。
-
ソリューションに複数のプロジェクトがある場合は、パッケージを追加するプロジェクトを選択するように求められます。
-
次に、検索語句を入力して、NuGet パッケージを名前で検索します。
クイック ピックには、選択できる NuGet パッケージの例のリストが表示されます。
-
次に、適用するバージョンを選択します。
-
パッケージとバージョン番号を選択すると、C# Dev Kit はそれをプロジェクトに追加し、プロジェクト ファイルと参照を更新します。
パッケージの更新
-
プロジェクト内の NuGet パッケージを更新するには、コマンド パレット (⇧⌘P (Windows、Linux Ctrl+Shift+P)) で NuGet: NuGet パッケージの更新 コマンドを使用します。
-
ソリューションに複数のプロジェクトがある場合は、更新するパッケージが含まれているプロジェクトを選択するように求められます。
-
次に、プロジェクトに現在インストールされていて、更新が利用可能なパッケージのリストから、更新するパッケージを選択します。ソリューションに更新が利用可能なパッケージがない場合は、その旨を通知するメッセージが表示されます。
-
最後に、パッケージを更新するバージョンを、使用可能なバージョンのドロップダウン リストから選択できます。
-
C# Dev Kit は、必要な変更を実行し、プロジェクト ファイルと参照を更新します。
パッケージの削除
-
NuGet パッケージをプロジェクトから削除するには、コマンド パレット (⇧⌘P (Windows、Linux Ctrl+Shift+P)) で NuGet: NuGet パッケージの削除 コマンドを使用します。
-
ソリューションに複数のプロジェクトがある場合は、パッケージを削除するプロジェクトを選択するように求められます。
-
次に、プロジェクトに現在インストールされているパッケージのリストから、削除するパッケージを選択します。
-
C# Dev Kit は、必要な変更を実行し、プロジェクト ファイルと参照を更新します。
プレリリース パッケージ バージョンを含める
NuGet パッケージのプレリリース バージョンを更新または追加する場合は、最初に [プレリリース パッケージ バージョンを含める] を true に設定する必要があります。
このオプションは、[ファイル] > [基本設定] > [設定] (⌘, (Windows、Linux Ctrl+,)) で、nuget.includePrereleasePackageVersions
を true
で検索すると見つけることができます。
依存関係の管理
NuGet の自動復元
.NET プロジェクトの場合、テンプレートからプロジェクトを作成、ビルド、ロード、または SDK スタイルのプロジェクトに変更を加えると、パッケージの復元が自動的に行われます。進行状況とログは、[出力] パネルで確認できます。
<PackageReference>
を使用するプロジェクトの場合、Visual Studio Code の [ソリューション エクスプローラー] セクションでパッケージ参照を確認できます。
復元またはビルドの実行時にパッケージが正しくインストールされない場合は、[ソリューション エクスプローラー] にエラー アイコンが表示されます。
注: 現時点では、プロジェクトを右クリックして NuGet パッケージを管理することはできず、Visual Studio Code に NuGet パッケージ マネージャーのユーザー インターフェイスはありません。
パッケージの管理の詳細については、dotnet CLI を使用した NuGet パッケージのインストールと管理を参照してください。