Установка пакетов NuGet и управление ими с помощью dotnet CLI

Статья
10/23/2023

С помощью средства dotnet CLI в Windows, macOS или Linux можно легко устанавливать, удалять и обновлять пакеты NuGet в проектах и решениях .NET. В этой статье описываются наиболее распространенные команды dotnet CLI для управления пакетами NuGet.

Интерфейс командной строки dotnet выполняется в проектах в стиле пакета SDK для .NET, .NET Core, .NET Standard и других проектах в стиле SDK, например в тех, которые предназначены для платформа .NET Framework. Дополнительные сведения см. в разделе Пакеты SDK для .NET.

Для большинства команд средство CLI ищет файл проекта в текущем каталоге, если другой файл проекта не указан как необязательный параметр в команде. Полный список команд и их аргументов см. в командах dotnet CLI.

Необходимые компоненты

Пакет SDK для .NET Core, который предоставляет программу командной строки dotnet. Начиная с Visual Studio 2017, dotnet CLI автоматически устанавливается со всеми связанными рабочими нагрузками .NET и .NET Core.

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

Команда dotnet add package добавляет ссылку на пакет в файл проекта, а затем запускается dotnet restore для установки пакета.

Откройте командную строку и перейдите в каталог, в котором находится файл проекта.
Выполните следующую команду для установки пакета NuGet:
```
dotnet add package <PACKAGE_NAME>
```
Например, чтобы установить пакет Newtonsoft.Json, выполните следующую команду
```
dotnet add package Newtonsoft.Json
```
После завершения команды можно открыть файл проекта, чтобы просмотреть ссылку на пакет.

Например, откройте CSPROJ-файл , чтобы просмотреть добавленную Newtonsoft.Json ссылку на пакет:
```
<ItemGroup>
  <PackageReference Include="Newtonsoft.Json" Version="13.0.1" />
</ItemGroup>
```

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

Команда dotnet add package устанавливает последнюю версию пакета, если не указана другая версия.

Чтобы установить определенную версию пакета NuGet, используйте необязательный -v или --version переключатель:

dotnet add package <PACKAGE_NAME> -v <VERSION>

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

dotnet add package Newtonsoft.Json --version 12.0.1

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

Список ссылок на пакет и версий проекта с помощью команды пакета dotnet list:

dotnet list package

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

Чтобы удалить ссылку на пакет из файла проекта, воспользуйтесь командой dotnet remove package.

dotnet remove package <PACKAGE_NAME>

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

dotnet remove package Newtonsoft.Json

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

Команда dotnet restore восстанавливает пакеты, с которыми перечисляется <PackageReference>файл проекта. Дополнительные сведения см. в разделе PackageReference в файлах проекта.

.NET Core 2.0 и более поздних dotnet build версий и dotnet run команды автоматически восстанавливают пакеты. По состоянию на NuGet 4.0 выполняется тот же код, dotnet restore что nuget restoreи .

Восстановление пакета с помощью dotnet restore:

Откройте командную строку и перейдите в каталог, в котором находится файл проекта.
Запустите dotnet restore.