Установка клиентских средств NuGet

Хотите установить пакет? Узнайте , как установить пакет NuGet.

Для работы с NuGet в качестве потребителя пакета или создателя можно использовать средства интерфейса командной строки (CLI) и функции NuGet в Visual Studio. В этой статье кратко описаны возможности различных инструментов. В нем также объясняется, как установить их и сравнить доступность функций в средствах.

Краткие руководства по NuGet

Чтобы приступить к использованию NuGet для использования пакетов, ознакомьтесь со следующими статьями:

• Установка и использование пакета с помощью dotnet CLI
• Установка и использование пакета NuGet в Visual Studio (только для Windows)

Чтобы приступить к созданию пакетов NuGet, см. следующие статьи:

• Создание и публикация пакета с помощью dotnet CLI
• Создайте и опубликуйте пакет NuGet в Visual Studio (только для Windows)

Общие сведения о средствах

инструмент	Описание	Скачать
Пакет SDK dotnet	Средство CLI для .NET и .NET стандартных библиотек, а также для любого проекта SDK, например для платформы .NET Framework. Это средство CLI включается в пакет SDK .NET и предоставляет основные функции NuGet на всех платформах. В Visual Studio 2017 и более поздних версиях интерфейс командной строки dotnet автоматически настраивается с любыми .NET-связанными рабочими нагрузками.	.NET SDK пакет
nuget.exe	Средство CLI для библиотек .NET Framework и для любого проекта не в стиле SDK, например, ориентированного на библиотеки .NET Standard. Это средство CLI предоставляет все возможности NuGet на Windows и большинстве функций macOS и Linux при выполнении в Mono.	nuget.exe
Visual Studio	Полнофункциональная интегрированная среда разработки (IDE), которая включает в себя Package Manager NuGet. Visual Studio предоставляет пользовательский интерфейс Package Manager и консоль Package Manager (PowerShell на Windows). Эти средства можно использовать для выполнения большинства операций NuGet.	Visual Studio
Visual Studio Code	Упрощенный редактор кода с открытым исходным кодом для Windows, macOS и Linux, который предлагает возможности NuGet через расширения Marketplace. Вы также можете использовать SDK dotnet или инструменты командной строки nuget.exe из Visual Studio Code.	Visual Studio Code

Вы также можете использовать интерфейс командной строки Microsoft Build Engine (MSBuild для восстановления и создания пакетов. Но MSBuild не является средством общего назначения для работы с NuGet. Это инструмент CLI особенно полезен для серверов сборки.

команды консоли Package Manager работают только в Visual Studio Windows и не работают в других средах PowerShell.

Политика поддержки

Сведения о политике поддержки Visual Studio Windows см. в разделе Visual Studio Жизненный цикл продукта и обслуживание.

Последняя версия nuget.exe полностью поддерживается и может гарантировать исправления ошибок, обновления и улучшения. Дополнительные сведения о политике поддержки см. в nuget.exeстатье "Современная политика жизненного цикла".

Сведения о политике поддержки пакета SDK .NET см. в разделе .NET и .NET Базовая политика поддержки.

Выпуски исправлений

Исправленные версии nuget.exe выпускаются исключительно при необходимости критически важных исправлений безопасности для долгосрочной версии Visual Studio или пакета SDK .NET.

Все ошибки безопасности должны сообщаться Microsoft Security Response Center (MSRC) на странице отчета MSRC. Подробные сведения о сообщении о проблемах безопасности смотрите в политике безопасности в репозитории NuGet.Client.

отмена списка NuGet.exe

Устаревшие, не поддерживаемые или уязвимые nuget.exe версии удаляются из tools.json конечной точки доступа.

Visual Studio

В Visual Studio 2017 и более поздних версий установщик Visual Studio включает Package Manager NuGet с любой рабочей нагрузкой, используюющей .NET.

Вы также можете установить Package Manager отдельно или проверить установку. Запустите установщик Visual Studio и проверьте параметр в разделе Individual components>Code tools>NuGet package manager. Дополнительные сведения см. в разделе Install и управление пакетами в Visual Studio с помощью nuGet Package Manager.

Средства CLI

Вы можете использовать интерфейс командной строки dotnet или интерфейс командной строки nuget.exe для поддержки функций NuGet в Visual Studio IDE. Интерфейс командной строки dotnet устанавливается с некоторыми рабочими нагрузками в Visual Studio, такими как .NET. Интерфейс командной строки (CLI) должен быть установлен отдельно, как описано ранее. Сравнение функций инструментов см. в разделе "Доступность компонентов ".

• Чтобы ориентироваться на .NET или .NET Standard, используйте инструмент командной строки dotnet SDK. Этот интерфейс командной строки необходим для формата стиля SDK-проекта, который использует SDK атрибут.

• Чтобы использовать платформу .NET Framework (только проекты, отличные от пакета SDK), используйте средство CLI nuget.exe. Если проект переносится из формата packages.config в формат PackageReference, используйте вместо этого инструмент командной строки dotnet SDK.

Пакет SDK dotnet

Пакет SDK dotnet — это средство командной строки .NET. Он работает на всех платформах (Windows, macOS и Linux) и предоставляет основные функции NuGet, такие как установка, восстановление и публикация пакетов. Интерфейс командной строки dotnet обеспечивает прямую интеграцию с файлами проекта .NET, такими как .csproj файлы, которые полезны в большинстве сценариев. Этот интерфейс командной строки также создается непосредственно для каждой платформы и не требует установки Mono.

Установка пакета SDK dotnet

• На компьютерах разработчиков установите пакет SDK .NET. В Visual Studio 2017 и более поздних версиях интерфейс командной строки dotnet автоматически настраивается с любыми .NET-связанными рабочими нагрузками.

• Для серверов сборки следуйте инструкциям, чтобы использовать пакет SDK .NET в средах непрерывной интеграции.

Сведения об использовании базовых команд с помощью средства командной строки пакета SDK dotnet см. в статье "Установка пакетов NuGet и управление ими с помощью dotnet CLI".

nuget.exe CLI (интерфейс командной строки)

Интерфейс командной строки NuGet nuget.exe — это программа командной строки для Windows, которая предоставляет все возможности NuGet. Этот интерфейс командной строки также может работать в macOS и Linux с помощью Mono с некоторыми ограничениями.

Чтобы узнать, как использовать основные команды с помощью инструмента командной строки, см. nuget.exe.

Установка nuget.exe

Windows

Всегда устанавливайте последнюю версию средства, поддерживающего конфигурацию.

nuget.exe Если средство ИНТЕРФЕЙСА командной строки уже установлено, средство можно обновить до последней версии с помощью командыnuget update -self.

1. Скачать 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 или более поздней версии.

2. При появлении запроса сохраните файл в папку по своему усмотрению. Файл nuget.exe скачан напрямую. Скачанный файл не является установщиком, поэтому нет необходимости запускать файл непосредственно из браузера.

3. Чтобы использовать средство CLI из любой папки, добавьте папку, содержащую файл nuget.exe в PATH переменную среды.

macOS / Linux

Поведение может немного отличаться в зависимости от дистрибутива операционной системы.

Замечание

Visual Studio для Mac был отозван 31 августа 2024 года в соответствии с Microsoft Modern Lifecycle Policy. Вы можете продолжать работать с Visual Studio для Mac, но есть несколько других вариантов для разработчиков в macOS, таких как расширение C# Dev Kit для VS Code.

Дополнительные сведения о сроках поддержки и альтернативах см. в разделе Visual Studio для Mac, поддержка которого прекращена 31 августа 2024 года.

1. Установите Mono версии 4.4.2 или более поздней.

2. В командной строке оболочки выполните следующую команду:

   # Download the latest stable version of `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. Создайте псевдоним, добавив следующий код в файл, который операционная система использует для хранения псевдонимов Bash или сведений о конфигурации. Как правило, для этой цели используется файл ~/.bash_aliases или ~/.bash_profile .

   # Create an alias for `nuget`.
   alias nuget="mono /usr/local/bin/nuget.exe"
   

4. Перезагрузите оболочку. Проверьте установку, введя команду nuget без параметров. Команда должна вывести справку по командной строке NuGet на экран.

Доступность функций

В следующей таблице сравниваются доступные функции интерфейса командной строки dotnet, nuget.exe CLI и средства Visual Studio для поддерживаемых платформ.

Функция	dotnet CLI (интерфейс командной строки для .NET)	nuget CLI (Windows)	nuget CLI (Mono)	Visual Studio
Поиск пакетов	✔	✔	✔	✔
Установка или удаление пакетов	✔	✔ (1)	✔	✔
Обновление пакетов	✔	✔		✔
Восстановление пакетов	✔	✔	✔ (2)	✔
Управление каналами пакетов (источниками)	✔	✔	✔	✔
Управление пакетами в фиде	✔	✔	✔
Установка ключей API для каналов данных		✔	✔
Создание пакетов (3)	✔	✔	✔ (4)	✔
Публикация пакетов	✔	✔	✔	✔
Репликация пакетов		✔	✔
Управление папками глобальных пакетов и папками кэша	✔	✔	✔
Управление конфигурацией NuGet	✔	✔	✔

Заметки о функциях:

• (1) Использование этой функции не влияет на файлы проекта. Вместо этого используйте средство CLI SDK dotnet.
• (2) Эта функция работает только с файламиpackages.config и не с файлами решения (.sln или SLNX).
• (3) Различные расширенные функции пакета доступны только через интерфейс командной строки, так как они не представлены в средствах пользовательского интерфейса Visual Studio.
• (4) Эта функция работает с nuspec-файлами , но не с файлами проекта.

Предстоящие функции

Если вы хотите предварительно просмотреть предстоящие функции NuGet, установите версию канала Insiders Channel Visual Studio, которая работает параллельно со стабильными выпусками Visual Studio. Чтобы сообщить о проблемах или поделиться идеями для предварительных версий, откройте проблему в репозитории NuGet GitHub.

Связанный контент

• Устанавливайте и управляйте пакетами в Visual Studio с помощью диспетчера пакетов NuGet
• Установка пакетов NuGet и управление ими с помощью dotnet CLI
• Управление пакетами NuGet с помощью интерфейса командной строки NuGet
• Управление пакетами с помощью консоли Visual Studio Package Manager (PowerShell)
• Создание пакета с помощью интерфейса командной строки nuget.exe
• Публикация пакетов NuGet
• Справочник по консоли PowerShell Package Manager

Разработчики, работающие над Windows, также могут изучить обозреватель пакетов NuGet. Это автономное средство с открытым исходным кодом, которое можно использовать для визуального изучения, создания и редактирования пакетов NuGet. Это полезно для многих сценариев, таких как внесение экспериментальных изменений в структуру пакета без перестроения пакета.