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

  • Статья

Хотите установить пакет? См . сведения о способах установки пакетов NuGet.

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

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

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

Средство Description Загрузка
Пакет SDK dotnet Средство CLI для библиотек .NET Core и .NET Standard, а также для любого проекта в стиле ПАКЕТА SDK, например для проекта, предназначенного для платформа .NET Framework. Это средство CLI включается в пакет SDK для .NET Core и предоставляет основные функции NuGet на всех платформах. В Visual Studio 2017 и более поздних версиях интерфейс командной строки dotnet автоматически устанавливается с любыми связанными рабочими нагрузками .NET Core. Базовый пакет SDK для .NET
nuget.exe Средство CLI для библиотек платформа .NET Framework и для любого проекта, отличного от пакета SDK, например для библиотек .NET Standard. Это средство CLI предоставляет все возможности NuGet в Windows и большинство функций Mac и Linux при выполнении в Mono. nuget.exe
Visual Studio В Windows Диспетчер пакетов NuGet включен в Visual Studio 2012 и более поздние версии. Visual Studio предоставляет пользовательский интерфейс диспетчер пакетов и консоль диспетчер пакетов (PowerShell в Windows). Эти средства можно использовать для выполнения большинства операций NuGet. Visual Studio
Visual Studio для Mac В Mac некоторые возможности NuGet создаются напрямую. в настоящее время консоль диспетчер пакетов недоступна. Для других возможностей используйте средства dotnet SDK или nuget.exe CLI. Visual Studio для Mac
Visual Studio Code В Windows, Mac и Linux возможности NuGet доступны через расширения Marketplace или используют средства dotnet SDK или nuget.exe CLI. Visual Studio Code

Примечание.

Visual Studio для Mac планируется на выход на пенсию к 31 августа 2024 г. в соответствии с Современная политика жизненного цикла Майкрософт. Дополнительные сведения см. в статье "Что происходит с Visual Studio для Mac".

Интерфейс командной строки MSBuild также восстанавливает и создает пакеты. MSBuild не является средством общего назначения для работы с NuGet. Это средство CLI в основном полезно для серверов сборки.

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

Visual Studio

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

Вы также можете установить диспетчер пакетов отдельно или проверить установку. Запустите установщик Visual Studio и проверка параметр в диспетчере пакетов NuGet для отдельных > средств > кода компонентов. Дополнительные сведения см. в статье "Установка пакетов и управление ими в Visual Studio с помощью диспетчер пакетов NuGet".

Примечание.

Для более ранних версий Visual Studio можно скачать расширения NuGet по адресу https://dist.nuget.org/index.html.

Средства CLI

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

  • Чтобы нацелиться на .NET Core или .NET Standard, используйте средство CLI пакета SDK dotnet. Этот интерфейс командной строки необходим для формата проекта в стиле ПАКЕТА SDK, который использует атрибут ПАКЕТА SDK.

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

Пакет SDK dotnet

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

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

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

CLI nuget.exe

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

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

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

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

  • Последнюю рекомендуемую версию можно скачать по адресу https://dist.nuget.org/win-x86-commandline/latest/nuget.exe.
  • Если у вас уже nuget.exe установлен инструмент CLI, вы можете обновить средство до последней версии с помощью команды nuget update -self.
  • Для совместимости со старыми системами непрерывной интеграции предыдущий URL-адрес в https://nuget.org/nuget.exe настоящее время предоставляет устаревшую версию 2.8.6 средства CLI.

  1. Посетите nuget.org/downloads и скачайте NuGet версии 3.3 или более поздней версии.

    • Для версии 5.0 и более поздних версий требуется платформа .NET Framework версии 4.7.2 или более поздней.
    • Для публикации пакетов nuget.orgв версии 4.1.0 и более поздних версий требуется.
    • Версия 2.8.6 несовместима с Mono.

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

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

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

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

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

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

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

Будущие возможности

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

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