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

Предпосылки

  • Visual Studio 2017 (с рабочей нагрузкой, связанной с .NET)
  • nuget.exe (добавьте его местоположение в переменную среды PATH)
  • Действительная учетная запись на nuget.org

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

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

  • Откройте Visual Studio, перейдите в Файл › Создать › Проект, разверните узел Visual C# › .NET Standard. Выберите шаблон «Библиотека классов (.NET Standard)» и укажите допустимое имя.
  • Чтобы построить проект, щелкните правой кнопкой мыши файл проекта и выберите «Построить». Файл DLL будет сгенерирован в папке Debug или в папке Release (если вы собираете конфигурацию)

Для действительно полезного пакета NuGet вы должны написать необходимый код, который могут использовать другие для разработки приложений. Однако для создания пакета достаточно библиотеки классов из шаблона.

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

  1. Перейдите в Проект › Свойства, выберите вкладку Пакет.
  2. Укажите уникальный идентификатор для вашего пакета и заполните другие необходимые свойства. Для описания различных свойств, пожалуйста, посетите здесь. Свойства, предоставленные на этом этапе, будут определены в манифесте .nuspec, созданном Visual Studio для проекта.
  3. Чтобы просмотреть свойства непосредственно в файле проекта, щелкните правой кнопкой мыши проект в обозревателе решений и выберите Изменить AppLogger.csproj.

Запустите команду пакета

  1. Установите для конфигурации значение Release.
  2. Щелкните проект правой кнопкой мыши в обозревателе решений и выберите команду Pack.
  3. Visual Studio строит проект и создает файл .nupkg. Обратите внимание, что собранный пакет находится в папке bin\Release\netstandard2.0, как и подобает цели .NET Standard 2.0.

Получить ключ API

  1. Войдите в свою учетную запись nuget.org или создайте учетную запись, если она еще не существует.
  2. Выберите свое имя пользователя в правом верхнем углу, затем выберите Ключи API.
  3. Выберите «Создать», укажите имя для своего ключа, выберите «Выбрать области» > «Отправить».
  4. В разделе «Ключ API» введите * для шаблона глобуса, затем выберите «Создать».
  5. После создания ключа выберите Копировать, чтобы получить ключ доступа, необходимый для публикации пакета.

Важно! Сохраните свой ключ в безопасном месте, потому что вы не сможете скопировать ключ позже. Если вы вернетесь на страницу ключа API, вам потребуется повторно сгенерировать ключ, чтобы скопировать его.

Публикация с помощью nuget push

  1. Откройте командную строку.
  2. Перейдите в папку, содержащую файл .nupkg.
  3. Выполните следующую команду, указав имя вашего пакета и заменив значение ключа на ваш ключ API:
nuget push <PACKAGE-NAME>.nupkg <API-KEY> -Source https://api.nuget.org/v3/index.json

4. nuget.exe отображает результаты процесса публикации.

Управление опубликованным пакетом

Вы можете просмотреть опубликованный пакет в своем профиле на сайте nuget.org. Выберите «Управление пакетами», чтобы увидеть тот, который был только что опубликован. Прежде чем ваш пакет появится в результатах поиска, может пройти некоторое время.

Если вы хотите удалить пакет из списка и скрыть его из результатов поиска, выполните следующие действия:

  1. На сайте nuget.org выберите свое имя пользователя в правом верхнем углу, затем выберите «Управление пакетами».
  2. Найдите пакет, который нужно исключить из списка, в разделе «Опубликовано» и щелкните значок корзины справа.
  3. На следующей странице снимите флажок Список (имя пакета) в результатах поиска и выберите Сохранить.

Первоначально опубликовано на https://www.loginradius.com.