Рабочий процесс создания пакета

Создание пакета начинается с получения скомпилированного кода (обычно это сборки .NET), который требуется упаковать и предоставить для общего доступа посредством открытой коллекции на веб-сайте nuget.org или закрытой коллекции в вашей организации. Пакет также может включать дополнительные файлы, в том числе файл сведений, который отображается при установке пакета, а также преобразования в определенные файлы проекта.

Кроме того, пакет может также использоваться только для извлечения других зависимостей и не содержать собственного кода. Такой способ подходит для распространения пакетов SDK, которые состоят из нескольких независимых пакетов. В других случаях пакет может содержать только файлы символов (.pdb), которые используются при отладке.

Примечание.

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

Перед созданием пакета обязательно нужно определиться с идентификатором, номером версии, лицензией, сведениями об авторских правах и любым другим необходимым содержимым. Затем вы можете объединить все эти данные в файл .nupkg с помощью команды "pack". Этот файл можно опубликовать в веб-канале NuGet, например nuget.org.

Совет

Пакет NuGet с расширением .nupkg представляет собой обычный ZIP-файл. Чтобы просмотреть содержимое любого такого пакета, достаточно изменить его расширение на .zip и развернуть обычным способом. Не забудьте изменить расширение на .nupkg перед загрузкой пакета на узел.

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

На этом этапе можно рассмотреть различные варианты работы с пакетом:

• Поддержка нескольких целевых платформ. В этом разделе описывается создание пакета с несколькими вариантами для различных платформ .NET Framework.
• Создание локализованных пакетов. В этом разделе описывается структура пакета с несколькими языковыми ресурсами, а также порядок использования отдельных локализованных вспомогательных пакетов.
• Предварительные версии пакетов. В этом разделе демонстрируется порядок выпуска альфа, бета-версий и версий-кандидатов пакетов для заинтересованных в них клиентов.
• Преобразования файлов исходного кода и конфигурации. В этом разделе описывается, как выполнить одностороннюю замену маркера в файлах, которые добавляются в проект, а также изменить файлы web.config и app.config, используя параметры, которые отменяются при удалении пакета.
• Пакеты символов. В этом разделе приводятся указания по реализации символов для библиотеки, благодаря которым клиенты смогут пошагово выполнять ваш код во время отладки.
• Управление версиями пакетов. В этом разделе описывается порядок определения точных версий, которые допускаются для зависимостей (другие пакеты, используемые вашим пакетом).
• Собственные пакеты. В этом разделе описывается порядок создания пакета для потребителей C++.
• Подписывание пакетов. Этот раздел описывает добавление цифровой подписи для пакета.

Если вы готовы опубликовать пакет на веб-сайте nuget.org, выполните простой процесс, описываемый в разделе Публикация пакета.

Если вы хотите использовать вместо nuget.org закрытый веб-канал, ознакомьтесь с разделом Общие сведения о размещении пакетов