Управление пакетами NuGet с помощью интерфейса командной строки NuGet

С помощью nuget.exe средства CLI можно управлять пакетами NuGet в проектах и решениях Visual Studio. В этой статье описываются наиболее распространенные команды интерфейса командной строки NuGet для управления пакетами NuGet. Все эти команды работают в Windows, и большинство из них работают на Mac и Linux с помощью Mono.

Интерфейс командной строки NuGet выполняется в проектах .NET Framework и проектах, не в стиле SDK, например, проектах, которые нацелены на библиотеки .NET Standard. Команды ИНТЕРФЕЙСА командной строки NuGet могут использовать файл packages.config проекта, который содержит ссылки на пакеты. Для проектов, не относящихся к стилю SDK, которые используют PackageReference вместо packages.config для управления пакетами, используйте dotnet CLI.

Для большинства команд средство интерфейса командной строки NuGet использует текущий каталог, если в команде не указано другое расположение. Чтобы запустить команды Интерфейса командной строки NuGet, откройте командную строку и перейдите в каталог, содержащий файл проекта.

Полный список команд и их аргументов см. в справочнике по интерфейсу командной строки NuGet.

Предпосылки

Скачайте интерфейс командной строки NuGet из nuget.org. Сохраните файлnuget.exe в подходящий каталог и убедитесь, что каталог находится в переменной среды PATH.

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

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

Команда установки Интерфейса командной строки NuGet загружает и устанавливает указанные пакеты NuGet.

-OutputDirectory Используйте параметр установки пакетов в определенный каталог. Если вы не указываете выходной каталог, install использует текущий каталог.

nuget install <packageID | configFilePath> -OutputDirectory <outputDirectory>

Например, чтобы установить Newtonsoft.json пакет в подкаталог пакетов , используйте следующую команду:

nuget install Newtonsoft.Json -OutputDirectory packages

Вместо указания пакета для установки можно указать существующий файлpackages.config в текущем или другом каталоге. Команда install устанавливает все пакеты, перечисленные в файлеpackages.config .

nuget install packages.config

Например, следующая команда устанавливает все пакеты, перечисленные в packages.config в подкаталоге конфигурации , в подкаталог пакетов :

nuget install config\packages.config -OutputDirectory packages

Установка определенной версии пакета

Команда install устанавливает последнюю версию пакета, если не указана другая версия. Чтобы установить определенную версию пакета, используйте -Version параметр:

nuget install <packageID | configFilePath> -Version <version>

Например, чтобы установить версию 12.0.1 пакета, используйте следующую Newtonsoft.json команду:

nuget install Newtonsoft.Json -Version 12.0.1

Вывод списка пакетов

Используйте команду списка , чтобы отобразить список пакетов, установленных в папках пакетов. -Source Используйте параметр, чтобы ограничить список.

nuget list -Source <source>

Например, чтобы перечислить пакеты в подкаталоге пакетовMyProject, используйте следующую команду:

nuget list -Source C:\Users\%USERNAME%\source\repos\MyProject\packages

Можно также использовать поисковый термин для поиска имен пакетов, тегов или описаний:

nuget list <"search term"> -Source <source>

Обновление всех пакетов

Используйте команду обновления , чтобы обновить все пакеты в файле проектаpackages.config до последних доступных версий. Лучше всего запустить restore перед запуском update.

nuget update

Удалите пакет

Чтобы удалить пакет, удалите этот пакет из папки проекта. Чтобы переустановить пакеты, используйте restore команды или install команды.

Удаление пакетов с диска не обновляет файлы проекта, packages.configили NuGet.Config . Лучшим способом удаления пакетов является пользовательский интерфейс Visual Studio Package Manager или консоль диспетчера пакетов.

Восстановление пакетов

Команда восстановления Интерфейса командной строки NuGet скачивает и устанавливает отсутствующие пакеты. Команда работает над проектами, которые используют PackageReference или packages.config для ссылок на пакеты.

Например install, restore команда добавляет только пакеты на диск, но не изменяет файл проекта или packages.config. Чтобы добавить зависимости проекта, используйте пользовательский интерфейс или консоль диспетчера пакетов Visual Studio.

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

nuget restore <projectPath>

Команда restore использует файл решения или файл package.config в указанном пути проекта.

Например, чтобы восстановить все пакеты для MySolution.sln в текущем каталоге, выполните следующую команду:

nuget restore MySolution.sln

Дополнительные сведения см. в разделе пакеты восстановления.

Дальнейшие шаги

• Справочник по интерфейсу командной строки NuGet
• Установка пакетов и управление ими в Visual Studio с помощью диспетчера пакетов NuGet
• Миграция из packages.config в PackageReference
• Управление пакетами с помощью dotnet CLI