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

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

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

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

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

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

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

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 переменную среды.

Подсказка

Чтобы сделать интерфейс командной строки NuGet доступным в консоли Package Manager в Visual Studio, см. статью Using nuget.exe CLI в консоли.

Availability

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

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

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

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

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

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

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

Роль Команды
Consumption config, help, installlistlocalsrestoresearchsetapikeysourcesupdate
Создание config, help, , init, packspec
Publishing add, config, deletehelplistpushsetapikeysources

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

Замечание

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

Локализация

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