Поделиться через

Справочник по интерфейсу командной строки NuGet

  • Статья

Интерфейс командной строки NuGet (CLI) nuget.exeпредоставляет полную степень функциональных возможностей NuGet для установки, создания, публикации и управления пакетами без внесения изменений в файлы проекта.

Чтобы использовать любую команду, откройте командное окно или оболочку Bash, а затем выполните nuget команду и соответствующие параметры, например nuget help pack (чтобы просмотреть справку по команде пакета).

Эта документация отражает последнюю версию интерфейса командной строки NuGet. Для получения точных сведений о любой используемой версии выполните nuget help нужную команду.

Сведения об использовании основных команд с CLI nuget.exe см. в статье Установка и использование пакета с помощью CLI 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.

Совет

Сведения о том, как сделать интерфейс командной строки NuGet доступным в консоли диспетчер пакетов в Visual Studio, см. в статье "Использование интерфейса командной строки nuget.exe" в консоли.

Availability

Подробные сведения см. в статье о доступности компонентов.

  • Все команды доступны в Windows.
  • Все команды работают с nuget.exe, запущенными в Mono, за исключением тех, где указано для pack, restoreи update.
  • Команды pack, , restoreи localsdeletepush команды также доступны в Mac и Linux через dotnet CLI.

Команды и применимость

Доступные команды и применимость к созданию пакетов, использованию пакетов и /или публикации пакета на узле:

Стандартные команды Применимые роли Версия NuGet Description
pack Создание 2.7+ Создает пакет NuGet из .nuspec файла или файла проекта. При запуске в Mono создание пакета из файла проекта не поддерживается.
push Публикация Все Публикует пакет в источнике пакета.
config Все Все Возвращает или задает значения конфигурации NuGet.
help or ? Все Все Отображает сведения о справке или справке по команде.
locals Потребление 3.3+ Выводит список расположений глобальных пакетов, http-cache и временных папок и очищает содержимое этих папок.
восстановление Потребление 2.7+ Восстанавливает все пакеты, на которые ссылается используемый формат управления пакетами. При запуске в Mono восстановление пакетов с помощью формата PackageReference не поддерживается.
setapikey Публикация, потребление Все Сохраняет ключ API для заданного источника пакета, если для этого источника пакета требуется ключ для доступа.
spec Создание Все .nuspec Создает файл, используя маркеры при создании файла из проекта Visual Studio.
Вторичные команды Применимые роли Версия NuGet Description
добавление Публикация 3.3+ Добавляет пакет в источник пакетов, отличный от HTTP, с помощью иерархического макета. Для источников HTTP используйте push-отправку.
Удаление Публикация Все Удаляет или отменяет список пакетов из источника пакета.
init Создание 3.3+ Добавляет пакеты из папки в источник пакетов с помощью иерархического макета.
Установка Потребление Все Устанавливает пакет в текущий проект, но не изменяет проекты или справочные файлы.
список Потребление, возможно, публикация Все Отображает пакеты из заданного источника.
mirror Публикация Не рекомендуется использовать в версии 3.2+ Зеркально отражает пакет и его зависимости от источника в целевой репозиторий.
search Потребление 5.8+ Выполняет поиск по указанному источнику с помощью предоставленной строки запроса.
sources Потребление, публикация Все Управляет источниками пакетов в файлах конфигурации.
обновить Потребление Все Обновления пакеты проекта до последних доступных версий. Не поддерживается при запуске в Mono.

Различные команды используют различные переменные среды.

Команды Интерфейса командной строки NuGet по применимым ролям:

Роль Команды
Потребление config, help, installlistlocalsrestoresearchsetapikeysourcesupdate
Создание config, , helpinit, packspec
Публикация add, config, deletehelplistpushsetapikeysources

Разработчики, обеспокоенные только потреблением пакетов, например, должны понимать, что подмножество команд NuGet.

Примечание.

Имена параметров команды не учитывает регистр. Нерекомендуемые параметры не включаются в эту ссылку, такие как NoPrompt (замененные NonInteractive) и Verbose (замененные Verbosity).

Локализация

NuGet.exe ход выполнения, предупреждения и сообщения об ошибках преобразуются в те же языковые параметры, что и Visual Studio. NuGet.exe поставляется в виде одного exe и из-за соображений размера только наиболее часто всплываемые сообщения переводятся на всех языках.