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

Публикация пакетов в NuGet.org

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

NuGet.org — это диспетчер пакетов, позволяющий разработчикам совместно использовать повторно используемый код. Пакет NuGet — это сжатый файл с .nupkg расширением, содержащим скомпилированный код, который можно использовать в других проектах. Пакеты, размещенные в NuGet.org, доступны всем разработчикам по всему миру.

Предпосылки

  • Любая версия Visual Studio 2019 и рабочая нагрузка .NET Core.
  • dotnet CLI (Интерфейс командной строки). Если у вас его еще нет, установите пакет SDK для .NET Core.
  • Зарегистрируйте бесплатную учетную запись на nuget.org , если у вас еще нет учетной записи.

Создание проекта

Вы можете использовать собственный проект .NET для создания и создания пакета NuGet или создания новой базовой библиотеки классов .NET следующим образом:

  1. В Visual Studio выберите "Файл", "Создать", а затем "Проект".

  2. Выберите шаблон библиотеки классов (.NET Standard) и нажмите кнопку "Далее".

  3. Присвойте проекту имя и решение, а затем выберите расположение для локального сохранения проекта. Когда все будет готово, нажмите кнопку Создать.

    Создание проекта библиотеки классов

Библиотека классов шаблонов достаточно для создания пакета NuGet, поэтому для этого руководства мы будем использовать существующий шаблон, и мы не будем писать дополнительный код.

Настройка и создание пакета

  1. Выберите проект из обозревателя решений, щелкните правой кнопкой мыши и выберите свойства , а затем пакет.

  2. Заполните форму и убедитесь, что идентификатор пакета является уникальным, в противном случае он может конфликтуть с существующими пакетами в NuGet.org. Общее соглашение об именовании такое: Company.Product.Feature. Если вы хотите создать пакет каждый раз при сборке проекта, установите флажок "Создать пакет NuGet" для сборки .

    Настройка свойств пакета

  3. Выберите проект из обозревателя решений, щелкните правой кнопкой мыши и выберите пакет , чтобы создать .nupkg пакет.

    Создание пакета

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

    Выходные данные пакета

Создание ключа API

Теперь, когда мы создали наш nupkg пакет, мы почти готовы опубликовать его, но сначала необходимо создать ключ API для подключения к API NuGet.org.

  1. Войдите в учетную запись NuGet.org или создайте ее, если вы этого не сделали.

  2. Щелкните значок имени пользователя и выберите ключи API.

  3. Нажмите кнопку "Создать", а затем введите имя ключа. Предоставьте ключу область отправки новых пакетов и новых версий пакетов и введите * в поле шаблона glob, чтобы выбрать все пакеты. Когда все будет готово, нажмите кнопку Создать.

    Создание ключа API

  4. Выберите Копировать и сохраните ключ API в безопасном расположении. Этот ключ потребуется для публикации пакета NuGet.

    Копирование ключа API

Публикация пакета в NuGet.org

Вы можете опубликовать пакет с помощью веб-интерфейса, dotnet CLI или nuget.exe CLI. Мы сосредоточимся на публикации пакетов с помощью командной строки в этом разделе. Для этого вам потребуется имя пакета, ключ API и исходный URL-адрес.

  1. В командной строке с повышенными правами перейдите в папку, содержащую пакет nupkg.

  2. Выполните следующую команду, чтобы опубликовать пакет в NuGet.org. Замените заполнители именем пакета и ключом API.

    dotnet nuget push <packageName> --api-key <APIKey> --source https://api.nuget.org/v3/index.json

  3. Выходные данные предыдущей команды должны выглядеть примерно так.

    Публикация выходных данных пакета