NuGet クライアント ツールのインストール

パッケージをインストールする場合は、Nuget パッケージのインストール方法に関するページをご覧ください。

パッケージ コンシューマーまたは作成者は、NuGet を使用するために、Visual Studio の NuGet 機能だけでなく、コマンド ライン インターフェイス (CLI) ツールも使用できます。 この記事では、さまざまなツールの機能とそれらのインストール方法について簡単に説明します。また、各ツールの機能の可用性の比較も示します。 NuGet でパッケージの利用を開始するには、パッケージをインストールして使用する方法に関するページを参照してください (dotnet CLI 向けページと Visual Studio 向けページがあります)。 NuGet パッケージの作成を開始するには、NET Standard パッケージの作成と公開に関するページを参照してください (dotnet CLI 向けページと Visual Studio 向けページがあります)。

ツール                説明 ダウンロード         
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 機能は、Marketplace 拡張機能から入手できます。また、CLI ツールの dotnet.exe または nuget.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 ツール

IDE で NuGet 機能をサポートするには、dotnet CLI または nuget.exe CLI のいずれかが使用できます。 dotnet CLI は、一部の Visual Studio ワークロード (.NET Core など) と共にインストールされます。 nuget.exe CLI は、前述のように個別にインストールする必要があります。

dotnet.exenuget.exe の 2 つの NuGet CLI ツールがあります。 比較については、「機能の可用性」をご覧ください。

  • .NET Core または .NET Standard を対象とするには、dotnet CLI をご使用ください。 SDK スタイルのプロジェクト形式 (SDK 属性が使用されます) の場合、dotnet CLI が必要です。
  • .NET Framework (非 SDK スタイルのプロジェクトのみ) を対象とするには、nuget.exe CLI を使用します。 プロジェクトを 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 をインストールする必要はありません。

インストール:

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 以降が必要です。

  1. nuget.org/downloads にアクセスして、NuGet 3.3 以降を選択します (2.8.6 は Mono と互換性がありません)。 常に最新バージョンが推奨され、パッケージを nuget.org に公開するには 4.1.0 以降が必要です。
  2. 各ダウンロードは、直接 nuget.exe ファイルです。 ブラウザーで任意のフォルダーにファイルを保存します。 ファイルがインストーラーでない場合、ブラウザーから直接実行しても何も表示されません。
  3. nuget.exe をPATH 環境変数に配置したフォルダーを追加し、任意の場所の CLI ツールを使用します。

macOS/Linux

動作は、OS のディストリビューションによって微妙に異なる場合があります。

  1. Mono 4.4.2 以降をインストールします。

  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
    
  3. 次のスクリプトを OS の適切なファイルに追加してエイリアスを作成します (通常、~/.bash_aliases または ~/.bash_profile)。

    # Create as alias for nuget
    alias nuget="mono /usr/local/bin/nuget.exe"
    
  4. シェルを再度読み込みます。 パラメーターなしで 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 リポジトリで懸案事項を開きます。

さらに、Windows で作業する開発者は、NuGet パッケージ エクスプローラーを探索することもできます。これは、NuGet パッケージを視覚的に調査、作成、および編集する、オープン ソースのスタンドアロン ツールです。 たとえば、パッケージをリビルドせずにパッケージ構造に試験的な変更を加える際に非常に役立ちます。