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