NuGet クライアント ツールのインストール
パッケージをインストールする場合は、 「NuGet パッケージをインストールする方法」を参照してください。
パッケージ コンシューマーまたは作成者は、NuGet を使用するために、Visual Studio の NuGet 機能だけでなく、コマンド ライン インターフェイス (CLI) ツールも使用できます。 この記事では、さまざまなツールの機能とそれらのインストール方法について簡単に説明します。また、各ツールの機能の可用性の比較も示します。
NuGet を使用してパッケージを使用するには、次を参照してください。
NuGet パッケージの作成を開始するには、次を参照してください。
| ツール | 説明 | ダウンロード |
|---|---|---|
| dotnet.exe | .NET Core と .NET Standard ライブラリ、および任意の SDK スタイルのプロジェクト (.NET Framework を対象とするものなど) のための CLI ツール。 .NET Core SDK 含まれており、すべてのプラットフォームで NuGet のコア機能を提供します。 (Visual Studio 2017 以降、dotnet CLI は .NET Core に関連するすべてのワークロードで自動的にインストールされます。) | .NET Core SDK |
| nuget.exe | .NET Framework ライブラリ、および任意の非 SDK スタイルのプロジェクト (.NET Standard ライブラリを対象とするものなど) のための CLI ツール。 Windows のすべての NuGet 機能と、Mono で実行される場合の Mac および Linux の ほとんどの機能を提供します。 | nuget.exe |
| Visual Studio | Windows では、 NuGet パッケージ マネージャー は Visual Studio 2012 以降に含まれています。 Visual Studio では、パッケージ マネージャー UI とパッケージ マネージャー コンソールを提供します。NuGet の操作のほとんどは、これらを使用して実行できます。 | Visual Studio |
| Visual Studio for Mac | Mac では、特定の NuGet 機能が直接組み込まれています。 現在、パッケージ マネージャー コンソールは使用できません。 他の機能については、CLI ツールの dotnet.exe または nuget.exe を使用します。 |
Visual Studio for Mac |
| Visual Studio Code | Windows、Mac、または Linux では、NuGet 機能はマーケットプレース拡張機能を通じて使用することも、 または nuget.exe CLI ツールをdotnet.exe使用することもできます。 |
Visual Studio Code |
さらに、MSBuild CLI は、パッケージを復元および作成する機能を提供します。これはおもにビルド サーバーで有用です。 MSBuild は、NuGet を使用するための汎用ツールではありません。
パッケージ マネージャー コンソール コマンドは、Windows 上の Visual Studio 内でのみ機能し、他の PowerShell 環境では機能しません。
Visual Studio
Visual Studio 2017 以降にインストールする
Visual Studio 2017 以降、インストーラーには、NuGet パッケージ マネージャーと .NET を使用するすべてのワークロードが含まれます。 個別にインストールするか、パッケージ マネージャーがインストールされていることを確認するには、Visual Studio インストーラーを実行し、[ 個々のコンポーネント > コード ツール > ] NuGet パッケージ マネージャーの下にあるオプションをオンにします。
Visual Studio 2015 以前にインストールする
Visual Studio 2013 および 2015 の NuGet 拡張機能は、 からhttps://dist.nuget.org/index.htmlダウンロードできます。
Visual Studio 2010 以前の場合、"Visual Studio 用 NuGet パッケージ マネージャー" 拡張機能をインストールします。 検索結果の最初のページに拡張機能が表示されない場合は、[並べ替え] ドロップダウンを [ダウンロード数の多い] またはアルファベット順に変更してみてください。
CLI ツール
CLI または CLI を dotnet 使用して、 nuget.exe IDE の NuGet 機能をサポートできます。 dotnet CLI は、一部の Visual Studio ワークロード (.NET Core など) と共にインストールされます。 nuget.exe CLI は、前述のように個別にインストールする必要があります。
dotnet.exe と nuget.exe の 2 つの NuGet CLI ツールがあります。 比較については、「機能の可用性」をご覧ください。
- .NET Core または .NET Standard を対象とするには、dotnet CLI をご使用ください。 SDK スタイルのプロジェクト形式 (SDK 属性が使用されます) の場合、
dotnetCLI が必要です。 - .NET Framework (非 SDK スタイルのプロジェクトのみ) を対象とするには、
nuget.exeCLI を使用します。 プロジェクトをpackages.configから PackageReference に移行する場合は、dotnet CLI を使用します。
dotnet.exe CLI
.NET Core 2.0 CLI (dotnet.exe) は、すべてのプラットフォーム (Windows、Mac、Linux) で機能し、パッケージのインストール、復元、および公開など、NuGet のコア機能を提供します。 dotnet は、.NET Core プロジェクト ファイル (.csprojなど) に直接統合されます。これは、ほとんどのシナリオで役立ちます。 また、dotnet は、各プラットフォーム用に直接構築されているので、Mono をインストールする必要はありません。
インストール:
- 開発者用コンピューターに .NET Core SDK をインストールします。 Visual Studio 2017 以降、dotnet CLI は .NET Core 関連のワークロードで自動的にインストールされます。
- ビルド サーバーの場合は、「継続的インテグレーション (CI) で .NET Core SDK とツールを使用する」の手順に従ってください。
dotnet CLI で基本的なコマンドを使用する方法を学習するには、dotnet CLI を使用したパッケージのインストールと使用に関するページを参照してください。
nuget.exe CLI
nuget.exe CLI (nuget.exe) は、すべての NuGet 機能を提供する Windows 用のコマンド ライン ユーティリティです。Mono を使用して Mac OSX および Linux でも実行できますが、いくつかの制限があります。
nuget.exe CLI で基本的なコマンドを使用する方法を学習するには、nuget.exe CLI を使用したパッケージのインストールと使用に関するページを参照してください。
インストール:
Windows
注意
NuGet.exe 5.0 以降には、実行するために .NET Framework 4.7.2 以降が必要です。
- nuget.org/downloads にアクセスして、NuGet 3.3 以降を選択します (2.8.6 は Mono と互換性がありません)。 常に最新バージョンが推奨され、パッケージを nuget.org に公開するには 4.1.0 以降が必要です。
- 各ダウンロードは、直接
nuget.exeファイルです。 ブラウザーで任意のフォルダーにファイルを保存します。 ファイルがインストーラーでない場合、ブラウザーから直接実行しても何も表示されません。 nuget.exeをPATH 環境変数に配置したフォルダーを追加し、任意の場所の CLI ツールを使用します。
macOS/Linux
動作は、OS のディストリビューションによって微妙に異なる場合があります。
Mono 4.4.2 以降をインストールします。
シェル プロンプトで次のコマンドを実行します。
# Download the latest stable `nuget.exe` to `/usr/local/bin` sudo curl -o /usr/local/bin/nuget.exe https://dist.nuget.org/win-x86-commandline/latest/nuget.exe次のスクリプトを OS の適切なファイルに追加してエイリアスを作成します (通常、
~/.bash_aliasesまたは~/.bash_profile)。# Create as alias for nuget alias nuget="mono /usr/local/bin/nuget.exe"シェルを再度読み込みます。 パラメーターなしで
nugetを入力してインストールをテストします。 NuGet CLI ヘルプが表示されます。
ヒント
Windows で既存の nuget.exe を最新バージョンに更新するには、nuget update -self を使用します。
注意
最新の推奨される NuGet CLI はいつでも、https://dist.nuget.org/win-x86-commandline/latest/nuget.exe で入手できます。 以前の継続的インテグレーション システムとの互換性のために、以前の URL では現在、 https://nuget.org/nuget.exe 非推奨の 2.8.6 CLI ツールが提供されています。
使用可能な機能
| 機能 | dotnet CLI | nuget CLI (Windows) | nuget CLI (Mono) | Visual Studio (Windows) | Visual Studio for Mac |
|---|---|---|---|---|---|
| パッケージの検索 | ✔ | ✔ | ✔ | ✔ | |
| パッケージのインストール/アンインストール | ✔ | ✔ (1) | ✔ | ✔ | ✔ |
| パッケージの更新 | ✔ | ✔ | ✔ | ✔ | |
| パッケージの復元 | ✔ | ✔ | ✔ (2) | ✔ | ✔ |
| パッケージ フィードの管理 (ソース) | ✔ | ✔ | ✔ | ✔ | |
| フィード上でのパッケージの管理 | ✔ | ✔ | ✔ | ||
| フィードの API キーの設定 | ✔ | ✔ | |||
| パッケージの作成 (3) | ✔ | ✔ | ✔ (4) | ✔ | |
| パッケージの公開 | ✔ | ✔ | ✔ | ✔ | |
| パッケージのレプリケート | ✔ | ✔ | |||
| "グローバル パッケージ" フォルダーおよびキャッシュ フォルダーの管理 | ✔ | ✔ | ✔ | ||
| NuGet の構成の管理 | ✔ | ✔ |
(1) プロジェクト ファイルには影響しません。代わりに dotnet.exe を使用します。
(2) packages.config ファイルでのみ機能し、ソリューション (.sln) ファイルでは機能しません。
(3) 各種の高度なパッケージ機能は、Visual Studio UI ツールで表示されない場合のみ、CLI を通じて使用できます。
(4) .nuspec ファイルでは機能しますが、プロジェクト ファイルでは機能しません。
今後の機能
今後の NuGet の機能をプレビューしたい場合は、Visual Studio Preview をインストールします。これは、Visual Studio の安定版リリースと同時に実行できます。 問題を報告したり、プレビューに関するアイデアを共有したりするには、NuGet GitHub リポジトリで懸案事項を開きます。
関連トピック
- Visual Studio を使用してパッケージをインストールして管理する
- PowerShell を使用してパッケージをインストールして管理する
- dotnet CLI を使用してパッケージをインストールして管理する
- nuget.exe CLI を使用してパッケージをインストールして管理する
- パッケージ マネージャー コンソール PowerShell のリファレンス
- パッケージの作成
- パッケージを公開する
さらに、Windows で作業する開発者は、NuGet パッケージ エクスプローラーを探索することもできます。これは、NuGet パッケージを視覚的に調査、作成、および編集する、オープン ソースのスタンドアロン ツールです。 たとえば、パッケージをリビルドせずにパッケージ構造に試験的な変更を加える際に非常に役立ちます。