パッケージのインストールをお探しですか? NuGet パッケージをインストールする方法を参照してください。
NuGet をパッケージ コンシューマーまたは作成者として使用するには、Visual Studioでコマンド ライン インターフェイス (CLI) ツールと NuGet 機能を使用できます。 この記事では、さまざまなツールの機能について簡単に説明します。 また、それらをインストールする方法と、 ツール全体の機能の可用性を比較する方法についても説明します。
NuGet のクイックスタート
NuGet を使用してパッケージを使用するには、次の記事を参照してください。
- dotnet CLI を使用してパッケージをインストールして使用する
Visual Studio (Windows のみ)
NuGet パッケージの作成を開始するには、次の記事を参照してください。
- dotnet CLI を使用してパッケージを作成して発行する
Visual Studio (Windows のみ)
ツールの概要
| ツール | 説明 | ダウンロード |
|---|---|---|
| dotnet SDK | .NETライブラリと .NET Standard ライブラリ用の CLI ツール、および .NET Framework を対象とするプロジェクトなど、SDK スタイルのプロジェクト。 この CLI ツールは、.NET SDK に含まれており、すべてのプラットフォームで主要な NuGet 機能を提供します。 Visual Studio 2017 以降では、dotnet CLI は、.NET関連のワークロードと共に自動的にインストールされます。 | .NET SDK |
| nuget.exe | .NET Framework ライブラリ用の CLI ツールと、非 SDK スタイルのプロジェクト (.NET Standard ライブラリを対象とするプロジェクトなど)。 この CLI ツールは、Mono で実行する場合に、Windowsと macOS と Linux 上のほとんどの機能で、すべての NuGet 機能を提供します。 | nuget.exe |
| Visual Studio | NuGet パッケージ マネージャーを含む本格的な統合開発環境 (IDE)。 Visual Studioは、パッケージ マネージャー UI と パッケージ マネージャー Console (Windows 上の PowerShell) を提供します。 これらのツールを使用して、ほとんどの NuGet 操作を実行できます。 | Visual Studio |
| Visual Studio Code | マーケットプレース拡張機能を通じて NuGet 機能を提供する、Windows、macOS、Linux 用の軽量のオープンソース コード エディターです。 Visual Studio Code内から dotnet SDK または nuget.exe CLI ツールを使用することもできます。 |
Visual Studio Code |
Microsoft Build Engine (MSBuild) CLI を使用してパッケージを復元および作成することもできます。 ただし、MSBuild は NuGet を操作するための汎用ツールではありません。 この CLI ツールは、主にビルド サーバーで役立ちます。
パッケージ マネージャーコンソール コマンドは、Windows上のVisual Studio内でのみ機能し、他の PowerShell 環境内では機能しません。
サポート ポリシー
Windowsサポート ポリシーのVisual Studioについては、「Visual Studio 製品のライフサイクルとサービスを参照してください。
nuget.exeの最新バージョンは完全にサポートされており、バグの修正、更新、および機能強化に依存できます。
nuget.exe サポート ポリシーの詳細については、「モダン ライフサイクル ポリシー」を参照してください。
.NET SDK サポート ポリシーについては、「.NET および .NETコア サポート ポリシーを参照してください。
パッチ リリース
nuget.exe の修正プログラムが適用されたバージョンは、Visual Studioまたは .NET SDK の長期サポート (LTS) バージョンに重要なセキュリティ修正プログラムが必要な場合にのみリリースされます。
すべてのセキュリティバグは、MSRC レポート ページでMicrosoft Security Response Center (MSRC) に報告する必要があります。 セキュリティの問題の報告の詳細については、 NuGet.Client リポジトリのセキュリティ ポリシーを参照してください。
NuGet.exe リストから外す
サポート対象外、非推奨、または脆弱な nuget.exe バージョンは、 tools.json エンドポイントから削除されます。
Visual Studio
Visual Studio 2017 以降では、Visual Studio インストーラーには、.NETを使用するすべてのワークロードを含む NuGet パッケージ マネージャーが含まれています。
パッケージ マネージャーを個別にインストールしたり、インストールを確認したりすることもできます。 Visual Studio インストーラーを実行し、Individual components>Code tools>NuGet パッケージ マネージャー でオプション設定を確認します。 詳細については、「
CLI ツール
dotnet CLI または nuget.exe CLI のいずれかを使用して、Visual Studio IDEの NuGet 機能をサポートできます。 dotnet CLI は、.NETなどの一部のVisual Studioワークロードと共にインストールされます。
nuget.exe CLI は、前述のように個別にインストールする必要があります。 ツールの機能比較については、「 機能の可用性 」セクションを参照してください。
.NETまたは .NET Standard をターゲットにするには、dotnet SDK CLI ツールを使用します。 この CLI は、
SDK属性を使用する SDK スタイルのプロジェクト形式に必要です。.NET Framework (SDK スタイル以外のプロジェクトのみ) をターゲットにするには、
nuget.exeCLI ツールを使用します。 プロジェクトがpackages.config形式からPackageReferenceに移行される場合は、代わりに dotnet SDK CLI ツールを使用します。
dotnet SDK
dotnet SDK は、.NET CLI ツールです。 すべてのプラットフォーム (Windows、macOS、Linux) で動作し、パッケージのインストール、復元、発行などの主要な NuGet 機能を提供します。 dotnet CLI では、.csproj ファイルなどの.NET プロジェクト ファイルと直接統合できます。これは、ほとんどのシナリオで役立ちます。 この CLI はプラットフォームごとに直接構築されており、 Mono のインストールは必要ありません。
dotnet SDK をインストールする
開発者コンピューターで、.NET SDK をインストールします。 Visual Studio 2017 以降では、dotnet CLI は、.NET関連のワークロードと共に自動的にインストールされます。
ビルド サーバーの場合は、指示に従って 継続的インテグレーション (CI) 環境で .NET SDK を使用します。
dotnet SDK CLI ツールで基本的なコマンドを使用する方法については、 dotnet CLI を使用した NuGet パッケージのインストールと管理に関するページを参照してください。
nuget.exe CLI (コマンドラインインターフェース)
NuGet CLI nuget.exe は、すべての NuGet 機能を提供するWindowsのコマンド ライン ユーティリティです。 この CLI は、いくつかの制限がある Mono を使用して macOS および Linux で実行することもできます。
nuget.exe CLI ツールで基本的なコマンドを使用する方法については、nuget.exe CLI を使用した NuGet パッケージの管理に関するページを参照してください。
nuget.exe のインストール
構成をサポートする 最新 バージョンのツールを常にインストールします。
nuget.exe CLI ツールが既にインストールされている場合は、コマンド nuget update -selfを使用してツールを最新バージョンに更新できます。
nuget.exeをダウンロードします。- 最新の推奨バージョンをダウンロードするには、 https://dist.nuget.org/win-x86-commandline/latest/nuget.exeに移動します。
- 非推奨のバージョン 2.8.6 をダウンロードして、古い継続的インテグレーション システムとの互換性を維持するには、 https://dist.nuget.org/win-x86-commandline/v2.8.6/nuget.exeに移動します。 バージョン 2.8.6 は Mono と互換性がありません。
- ダウンロードするバージョンを選択するには、 nuget.org/downloads に移動します。
- バージョン 5.0 以降では、.NET Framework 4.7.2 以降が必要です。
- パッケージを nuget.org に発行するには、バージョン 4.1.0 以降が必要です。
メッセージが表示されたら、任意のフォルダーにファイルを保存します。 nuget.exe ファイルは直接ダウンロードされます。 ダウンロードしたファイルはインストーラーではないので、ブラウザーから直接ファイルを実行する必要はありません。
任意のフォルダーの CLI ツールを使用するには、 nuget.exe ファイルを含むフォルダーを
PATH環境変数に追加します。
使用可能な機能
次の表は、サポートされているプラットフォームの dotnet CLI、nuget.exe CLI、およびVisual Studio ツールで使用できる機能を比較したものです。
| 特徴 | dotnet CLI（.NET コマンドラインインターフェース） | nuget CLI (Windows) | nuget CLI (Mono) | Visual Studio |
|---|---|---|---|---|
| パッケージの検索 | ✔ | ✔ | ✔ | ✔ |
| パッケージのインストールまたはアンインストール | ✔ | ✔ (1) | ✔ | ✔ |
| パッケージの更新 | ✔ | ✔ | ✔ | |
| パッケージの復元 | ✔ | ✔ | ✔ (2) | ✔ |
| パッケージ フィード (ソース) の管理 | ✔ | ✔ | ✔ | ✔ |
| フィードでパッケージを管理する | ✔ | ✔ | ✔ | |
| フィードの API キーを設定する | ✔ | ✔ | ||
| パッケージの作成 (3) | ✔ | ✔ | ✔ (4) | ✔ |
| パッケージを発行する | ✔ | ✔ | ✔ | ✔ |
| パッケージをレプリケートする | ✔ | ✔ | ||
| グローバル パッケージとキャッシュ フォルダーの管理 | ✔ | ✔ | ✔ | |
| NuGet 構成の管理 | ✔ | ✔ | ✔ |
機能に関する注意事項:
- (1) この機能を使用しても、プロジェクト ファイルには影響しません。 代わりに dotnet SDK CLI ツールを使用してください。
- (2) この機能は、ソリューション (.sln または .slnx) ファイルではなく、packages.config ファイルでのみ機能します。
- (3) さまざまな高度なパッケージ機能は、Visual Studio UI ツールでは表されないため、CLI でのみ使用できます。
- (4) この機能は .nuspec ファイルでは機能しますが、プロジェクト ファイルでは機能しません。
近日公開の機能
今後の NuGet 機能をプレビューする場合は、Insiders Channel バージョンの Visual Studio をインストールします。これは、Visual Studioの安定したリリースと並行して動作します。 問題を報告したり、プレビューのアイデアを共有したりするには、NuGet GitHub リポジトリで問題を開きます。
関連するコンテンツ
NuGet パッケージ マネージャー - dotnet CLI を使用して NuGet パッケージをインストールして管理する
- NuGet CLI を使用して NuGet パッケージを管理する
Visual Studio パッケージ マネージャー コンソール (PowerShell) - nuget.exe CLI を使用してパッケージを作成する
- NuGet パッケージを発行する
- パッケージ マネージャー コンソール PowerShell リファレンス
Windowsに取り組む開発者は、NuGet パッケージ エクスプローラーを調べることもできます。 このアプリケーションは、NuGet パッケージを視覚的に探索、作成、編集するために使用できるオープンソースのスタンドアロン ツールです。 パッケージを再構築せずにパッケージ構造に実験的な変更を加えるなど、多くのシナリオに役立ちます。