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

Сервисы Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

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

Предпосылки

Товар Requirements
Visual Studio & .NET - Visual Studio с рабочей нагрузкой .NET.
— последний пакет SDK .NET.
NuGet.org — бесплатная учетная запись NuGet.org

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

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

  1. В Visual Studio выберите File>New>Project.

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

  3. Введите имя проекта и решения, выберите локальную папку и нажмите кнопку "Далее".

  4. Выберите платформу и нажмите кнопку "Создать ", когда вы будете готовы.

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

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

  1. В Обозреватель решений щелкните проект правой кнопкой мыши и выберите Properties>Package.

  2. Введите сведения о пакете и убедитесь, что идентификатор пакета уникален, поэтому он не конфликтует с существующими пакетами в NuGet.org. Распространенный шаблон именования.Company.Product.Feature Чтобы создать пакет при каждой сборке проекта, выберите "Создать пакет NuGet" при сборке.

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

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

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

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

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

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

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

    Снимок экрана: страница NuGet.org Создание ключа API с полями области и шаблона пакета, настроенными для публикации пакетов.

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

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

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

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

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

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

    dotnet nuget push <packageName> --api-key <APIKey> --source https://api.nuget.org/v3/index.json
    
  3. Убедитесь, что выходные данные команды показывают, что пакет был успешно отправлен.

    Снимок экрана: выходные данные командной строки, подтверждающие успешно опубликованную пакетную команду dotnet nuget push.