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

パッケージをインストールする場合は、Nuget パッケージのインストール方法に関するページをご覧ください。Looking to install a package? See Ways to install NuGet packages.

パッケージ コンシューマーまたはパッケージ作成者として NuGet を使用するには、コマンド ライン インターフェイス (CLI) ツールだけでなく、Visual Studio の NuGet 機能も使用できます。To work with NuGet, as a package consumer or creator, you can use command-line interface (CLI) tools as well as NuGet features in Visual Studio. この記事では、さまざまなツールの機能とそれらのインストール方法について簡単に説明します。また、各ツールの機能の可用性の比較も示します。This article briefly outlines the capabilities of the different tools, how to install them, and their comparative feature availability. NuGet でパッケージの利用を開始するには、パッケージをインストールして使用する方法に関するページを参照してください (.NET CLI 向けページと Visual Studio 向けページがあります)。To get started using NuGet to consume packages, see Install and use a package (.NET CLI) and Install and use a package (Visual Studio). NuGet パッケージの作成を開始するには、NET Standard パッケージの作成と公開に関するページを参照してください (dotnet CLI 向けページと Visual Studio 向けページがあります)。To get started creating NuGet packages, see Create and publish a NET Standard package (dotnet CLI) and Create and publish a NET Standard package (Visual Studio).

ツール               Tool                説明Description ダウンロード         Download         
dotnet.exedotnet.exe .NET Core SDK 含まれており、すべてのプラットフォームで NuGet のコア機能を提供します。Included with the .NET Core SDK and provides core NuGet features on all platforms. .NET Core SDK.NET Core SDK
nuget.exenuget.exe Windows のすべての NuGet 機能と、Mono で実行される場合の Mac および Linux の ほとんどの機能を提供します。Provides all NuGet capabilities on Windows, provides most features on Mac and Linux when running under Mono. nuget.exenuget.exe
Visual StudioVisual Studio Windows 上で、パッケージ マネージャー UI およびパッケージ マネージャー コンソール (.NET 関連のワークロードに含まれます) を介して NuGet 機能を提供します。On Windows, provides NuGet capabilities through the Package Manager UI and Package Manager Console; included with .NET-related workloads. Mac 上で、UI 経由で特定の機能を提供します。On Mac, provides certain features through the UI. Visual Studio Code で、拡張機能によって NuGet 機能が提供されます。In Visual Studio Code, NuGet features are provided through extensions. Visual Studio 2017Visual Studio 2017

さらに、MSBuild CLI は、パッケージを復元および作成する機能を提供します。これはおもにビルド サーバーで有用です。The MSBuild CLI also provides the ability to restore and create packages, which is primarily useful on build servers. MSBuild は、NuGet を使用するための汎用ツールではありません。MSBuild is not a general-purpose tool for working with NuGet.

CLI ツールCLI tools

dotnet.exenuget.exe の 2 つの NuGet CLI ツールがあります。The two NuGet CLI tools are dotnet.exe and nuget.exe. 比較については、「機能の可用性」をご覧ください。See feature availability for a comparison.

dotnet.exe CLIdotnet.exe CLI

.NET Core 2.0 CLI (dotnet.exe) は、すべてのプラットフォーム (Windows、Mac、Linux) で機能し、パッケージのインストール、復元、および公開など、NuGet のコア機能を提供します。The .NET Core 2.0 CLI, dotnet.exe, works on all platforms (Windows, Mac, and Linux) and provides core NuGet features such as installing, restoring, and publishing packages. dotnet は、.NET Core プロジェクト ファイル (.csprojなど) に直接統合されます。これは、ほとんどのシナリオで役立ちます。dotnet provides direct integration with .NET Core project files (such as .csproj), which is helpful in most scenarios. また、dotnet は、各プラットフォーム用に直接構築されているので、Mono をインストールする必要はありません。dotnet is also built directly for each platform and does not require you to install Mono.

インストール:Installation:

詳細については、.NET Core コマンド ライン インターフェイス ツールに関するセクションをご覧ください。For more information, see .NET Core command-line interface tools.

nuget.exe CLInuget.exe CLI

NuGet CLI (nuget.exe) は、すべての NuGet 機能を提供する Windows 用のコマンド ライン ユーティリティです。Mono を使用して Mac OSX および Linux でも実行できますが、いくつかの制限があります。The NuGet CLI, nuget.exe, is the command-line utility for Windows that provides all NuGet capabilities; it can also be run on Mac OSX and Linux using Mono with some limitations. dotnet とは異なり、nuget.exe CLI はプロジェクト ファイルに影響を与えず、パッケージのインストール時に packages.config を更新しません。Unlike dotnet, the nuget.exe CLI does not affect project files and does not update packages.config when installing packages.

インストール:Installation:

WindowsWindows

  1. nuget.org/downloads にアクセスして、NuGet 3.3 以降を選択します (2.8.6 は Mono と互換性がありません)。Visit nuget.org/downloads and select NuGet 3.3 or higher (2.8.6 is not compatible with Mono). 常に最新バージョンが推奨され、パッケージを nuget.org に公開するには 4.1.0 以降が必要です。The latest version is always recommended, and 4.1.0+ is required to publish packages to nuget.org.
  2. 各ダウンロードは、直接 nuget.exe ファイルです。Each download is the nuget.exe file directly. ブラウザーで任意のフォルダーにファイルを保存します。Instruct your browser to save the file to a folder of your choice. ファイルがインストーラーでない場合、ブラウザーから直接実行しても何も表示されません。The file is not an installer; you won't see anything if you run it directly from the browser.
  3. nuget.exe をPATH 環境変数に配置したフォルダーを追加し、任意の場所の CLI ツールを使用します。Add the folder where you placed nuget.exe to your PATH environment variable to use the CLI tool from anywhere.

macOS/LinuxmacOS/Linux

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

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

  2. シェル プロンプトで次のコマンドを実行します。Execute the following command at a shell prompt:

    # 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 an alias by adding the following script to the appropriate file for your OS (typically ~/.bash_aliases or ~/.bash_profile):

    # Create as alias for nuget
    alias nuget="mono /usr/local/bin/nuget.exe"
    
  4. シェルを再度読み込みます。Reload the shell. パラメーターなしで nuget を入力してインストールをテストします。Test the installation by entering nuget with no parameters. NuGet CLI ヘルプが表示されます。NuGet CLI help should display.

ヒント

Windows で既存の nuget.exe を最新バージョンに更新するには、nuget update -self を使用します。Use nuget update -self on Windows to update an existing nuget.exe to the latest version.

注意

最新の推奨される NuGet CLI はいつでも、https://dist.nuget.org/win-x86-commandline/latest/nuget.exe で入手できます。The latest recommended NuGet CLI is always available at https://dist.nuget.org/win-x86-commandline/latest/nuget.exe. 古い継続的インテグレーション システムとの互換性を維持するために、以前の URL (https://nuget.org/nuget.exe) では現在、非推奨の 2.8.6 CLI ツールが提供されています。For compatibility purposes with older continuous integration systems, a previous URL, https://nuget.org/nuget.exe currently provides the deprecated 2.8.6 CLI tool.

Visual StudioVisual Studio

  • Visual Studio Code: NuGet 機能は、Marketplace 拡張機能から入手できます。また、CLI ツールの dotnet.exe または nuget.exe を使用して入手することもできます。Visual Studio Code: NuGet capabilities are available through marketplace extensions, or use the dotnet.exe or nuget.exe CLI tools.

  • Visual Studio for Mac: NuGet の機能は直接組み込まれています。Visual Studio for Mac: certain NuGet capabilities are built in directly. チュートリアルについては、「プロジェクトに NuGet パッケージを含める」をご覧ください。See Including a NuGet package in your project for a walkthrough. 他の機能については、CLI ツールの dotnet.exe または nuget.exe を使用します。For other capabilities, use the dotnet.exe or nuget.exe CLI tools.

  • Windows 上の Visual Studio: NuGet パッケージ マネージャーは、Visual Studio 2012 以降に含まれます。Visual Studio on Windows: The NuGet Package Manager is included with Visual Studio 2012 and later. パッケージ マネージャーは、パッケージ マネージャー UIパッケージ マネージャー コンソールを提供します。NuGet の操作のほとんどは、これらを使用して実行できます。The Package Manager provides the Package Manager UI and the Package Manager Console, through which you can run most NuGet operations.

    • Visual Studio 2017 インストーラーには、NuGet パッケージ マネージャーと .NET を使用するすべてのワークロードが含まれます。The Visual Studio 2017 installer includes the NuGet Package Manager with any workload that employs .NET. 個別にインストール、またはパッケージ マネージャーがインストールされていることを確認するには、Visual Studio 2017 インストーラーを実行し、[個別のコンポーネント] > [コード ツール] > [NuGet パッケージ マネージャー] の下でオプションを確認します。To install separately, or to verify that the Package Manager is installed, run the Visual Studio 2017 installer and check the option under Individual Components > Code tools > NuGet package manager.
    • パッケージ マネージャー UI とパッケージ マネージャー コンソールは、Windows 上の Visual Studio 固有です。The Package Manager UI and Console are unique to Visual Studio on Windows. 現在、Visual Studio for Mac では、これらを使用できません。They are not presently available on Visual Studio for Mac.
    • Visual Studio では、nuget.exe CLI が自動的に含まれないため、前述のとおり、個別にインストールする必要があります。Visual Studio does not automatically include the nuget.exe CLI, which must be installed separately as described earlier.
    • パッケージ マネージャー コンソール コマンドは、Windows 上の Visual Studio 内でのみ機能し、他の PowerShell 環境では機能しません。Package Manager Console commands work only within Visual Studio on Windows and do not work within other PowerShell environments.
    • Visual Studio 2010 以前の場合、"Visual Studio 用 NuGet パッケージ マネージャー" 拡張機能をインストールします。For Visual Studio 2010 and earlier, install the "NuGet Package Manager for Visual Studio" extension.
    • さらに、Visual Studio 2013 および 2015 用の NuGet 拡張機能は、https://dist.nuget.org/index.htmlからダウンロードできます。NuGet Extensions for Visual Studio 2013 and 2015 can also be downloaded from https://dist.nuget.org/index.html.
    • リリース予定の NuGet の機能をプレビューしたい場合は、Visual Studio 2017 Preview をインストールします。これは、Visual Studio の安定版リリースと同時に実行できます。If you'd like to preview upcoming NuGet features, install the Visual Studio 2017 Preview, which works side-by-side with stable releases of Visual Studio. 問題を報告したり、プレビューに関するアイデアを共有したりするには、NuGet GitHub リポジトリで懸案事項を開きます。To report problems or share ideas for previews, open an issue on the NuGet GitHub repository.

機能の可用性Feature availability

機能Feature dotnet CLIdotnet CLI nuget CLI (Windows)nuget CLI (Windows) nuget CLI (Mono)nuget CLI (Mono) Visual Studio (Windows)Visual Studio (Windows) Visual Studio for MacVisual Studio for Mac
パッケージの検索Search packages
パッケージのインストール/アンインストールInstall/uninstall packages ✔(1)✔(1)
パッケージの更新Update packages
パッケージの復元Restore packages ✔(2)✔(2)
パッケージ フィードの管理 (ソース)Manage package feeds (sources)
フィード上でのパッケージの管理Manage packages on a feed
フィードの API キーの設定Set API keys for feeds
パッケージの作成 (3)Create packages(3) ✔(4)✔(4)
パッケージの公開Publish packages
パッケージのレプリケートReplicate packages
"グローバル パッケージ" フォルダーおよびキャッシュ フォルダーの管理Manage global-package and cache folders
NuGet の構成の管理Manage NuGet configuration

(1) プロジェクト ファイルには影響しません。代わりに dotnet.exe を使用します。(1) Does not affect project files; use dotnet.exe instead.

(2) packages.config ファイルでのみ機能し、ソリューション (.sln) ファイルでは機能しません。(2) Works only with packages.config file and not with solution (.sln) files.

(3) 各種の高度なパッケージ機能は、Visual Studio UI ツールで表示されない場合のみ、CLI を通じて使用できます。(3) Various advanced package features are available through the CLI only as they aren't represented in the Visual Studio UI tools.

(4) .nuspec ファイルでは機能しますが、プロジェクト ファイルでは機能しません。(4) Works with .nuspec files but not with project files.

さらに、Windows で作業する開発者は、NuGet パッケージ エクスプローラーを探索することもできます。これは、NuGet パッケージを視覚的に調査、作成、および編集する、オープン ソースのスタンドアロン ツールです。Developers working on Windows can also explore the NuGet Package Explorer, an open-source, stand-alone tool to visually explore, create, and edit NuGet packages. たとえば、パッケージをリビルドせずにパッケージ構造に試験的な変更を加える際に非常に役立ちます。It's very helpful, for example, to make experimental changes to a package structure without rebuilding the package.