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


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

С помощью средства 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 для установки пакета.

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

  2. Выполните следующую команду для установки пакета NuGet:

    dotnet add package <PACKAGE_NAME>
    

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

    dotnet add package Newtonsoft.Json
    
  3. После завершения команды можно открыть файл проекта, чтобы просмотреть ссылку на пакет.

    Например, откройте 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:

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

Следующие шаги