Быстрое создание NUGET-пакетов

23 февраля 2016

О чем речь

NUGET - это одно из самых популярных расширений Visual Studio, с помощью которого можно легко устанавливать, обновлять и удалять сторонние библиотеки / сборки, какие-либо компоненты и инструменты в Вашем проекте. Если расширение для управления NUGET-пакетами не установлено, то через управление расширениями Visual Studio установить его дело 1 минуты.

Поиск и установка NUGET-пакетовУстановка, удаление и обновление пакетов Nuget для проектаНастройки расширений Visual StudioУстановка расширений и обновлений Visual Studio
Использование NUGET-пакетов позволяет легко управлять библиотеками в проектах любого типа, а именно:
  • поиск и установка библиотеки;
  • загрузка и установка необходимых зависимых NUGET-пакетов;
  • проверка хэш-значений на соответствие с заданным сервером (проверка целостности);
  • распаковка файлов библиотеки в нужное место;
  • добавление ссылок (reference) на её сборки в проект;
  • модификацию файлов конфигурации (web.config, app.config) при необходимости.

Все это делает жизнь разработчика куда проще, не так ли =). Далее рассмотрим как создать собственный NUGET-пакет и опубликовать его на сервере NUGET.org.

Установка утилиты

В качестве простого способа создания NUGET-пакета рассмотрим использование GUI-утилиты Nuget Packet Explorer, которую Вы можете скачать по следующей ссылке. После загрузку запустите установочный файл. Установка не должна создать каких-либо вопросов.

При установке в новых версия Windows может появиться предупреждение об отсутствии подписи приложения.

Предупреждение Windows Defender

Предупреждение Windows Defender

Игнорируем его и продолжаем установку программы.

Создание и публикация

Запустим установленный Nuget Packet Explorer. Перед нами будет список основных команд, среди которых выберем "Create a new package" (Создать новый пакет).

Главное окно Nuget Packet Explorer

На следующем этапе нужно ввести информацию о пакете и настроить его содержимое.

Вводим информацию о пакете

После добавления описания пакета настроим его содержимое, которое будет устанавливаться в проект. В качестве примера демонстрируется создание NUGET-пакета для библиотеки V8Formats.

Добавление содержимого NUGET-пакета

Сначала мы добавили папку для библиотек "lib". После в нее добавили уже подготовленный DLL-файл библиотеки.

Теперь все настройки сделаны и мы можем опубликовать наш Nuget-пакет в официальном репозитории NUGET.ORG. Перед этим нужно будет там зарегистрироваться. Процедура регистрация стандартная и не должна вызывать каких-либо вопросов. После регистрации зайдите в свой профиль и скопируйте Ваш API Key.

Nuget API Key

В Nuget Packet Explorer перейдем в меню File -> Publish.

Публикация NUGET-пакета

Здесь в поле "Publish key" вставьте скопированный ключ из профиля учетной записи nuget.org и нажмите кнопку "Publish". Вот и все, через некоторое время пакет будет опубликован.

Пакет не сразу будет доступен для установки в Visual Studio. На странице пакета в первое время Вы можете увидеть такое сообщение.

Индексация NUGET-пакета

Сообщение гласит, что пока что новый пакет не был проиндексирован и поэтому он не доступен в поиске. Спустя некоторое время индексация будет выполнена и его установка станет возможной. Мне пришлось подождать не более 10 минут.

Вместо заключения

Мы создали Nuget-пакет с помощью GUI-утилиты Nuget Packet Managet и опубликовали его в официальном репозитории NUGET.org. В качестве примера использовался NUGET-пакет библиотеки V8Formats.

Описанный способ не единственный. Возможно также автоматического создание и публикация NUGET-пакетов с помощью скриптов, но об этом в другой раз. Если нужно быстро и без особых вопросов создать NUGET-пакет, то использование утилиты Nuget Packet Manager должно идеально подойти.

  Tools

comments powered by Disqus