Открыть сервис
Главная → Блог → NuGet

NuGet

NuGet — это менеджер пакетов для платформы .NET (включая .NET Framework, .NET Core, .NET 5/6/7/8 и более новые версии), предназначенный для автоматизации установки, обновления, настройки и удаления сторонних библиотек, инструментов и компонентов. NuGet является официальным пакетным менеджером экосистемы Microsoft .NET и входит в состав Visual Studio, .NET SDK и Azure DevOps. Система предоставляет централизованный репозиторий (галерею) пакетов, а также инструменты командной строки и графические интерфейсы для управления зависимостями проектов.

История

Предпосылки и создание

До появления NuGet разработчики под .NET использовали различные нестандартизированные способы распространения библиотек: ручное копирование сборок (DLL), использование SVN-репозиториев, установку через установщики Windows или специализированные решения вроде Google Code. Отсутствие единого механизма приводило к конфликтам версий, сложностям с обновлением и проблемам с переносимостью проектов.

Проект, первоначально называвшийся NuPack, был анонсирован в 2010 году как часть инициативы Microsoft по улучшению управления зависимостями. Первая публичная версия (NuPack 1.0) вышла в октябре 2010 года. В 2011 году проект был переименован в NuGet из-за конфликта товарных знаков с другим продуктом (NuPack — торговая марка компании, занимающейся упаковкой).

Развитие и версии

  • 2011—2012: NuGet 1.1 — 1.6. Внедрение поддержки PowerShell-скриптов в установщик, появление консоли менеджера пакетов в Visual Studio, начало работы официального репозитория nuget.org.
  • 2013—2014: NuGet 2.0 — 2.7. Добавлена поддержка семантического версионирования (SemVer), возможность указывать зависимости от конкретных версий, введены файлы конфигурации packages.config и project.json.
  • 2015—2016: NuGet 3.0 — 3.5. Переход на открытую архитектуру с использованием NuGet.Client (открытый исходный код на GitHub), интеграция с .NET Core и проектами на основе project.json (позднее заменён на .csproj).
  • 2017—2018: NuGet 4.0 — 4.6. Поддержка PackageReference (ссылки на пакеты прямо в файле проекта .csproj), улучшение производительности, появление инструмента dotnet restore для .NET Core.
  • 2019—2023: NuGet 5.0 — 6.0. Внедрение прозрачных подписей пакетов (Repository Signatures), улучшение безопасности, поддержка платформ .NET 5/6/7/8, интеграция с GitHub Packages и Azure Artifacts, выход из бета-статуса для NuGet.exe.

Архитектура и принцип работы

Компоненты системы

NuGet состоит из трёх основных компонентов:

  1. Клиентская часть — инструменты, установленные на машине разработчика (Visual Studio, dotnet.exe, nuget.exe).
  2. Серверная часть — репозиторий (галерея) пакетов, например nuget.org, частный корпоративный сервер (NuGet.Server), Azure Artifacts или GitHub Packages.
  3. Формат пакета — .nupkg (NuGet Package), представляющий собой ZIP-архив с метаданными, сборками, ресурсами и скриптами.

Формат пакета (.nupkg)

Пакет NuGet — это ZIP-архив, переименованный в .nupkg. Он содержит:

  • Файл манифеста .nuspec — XML-файл с метаданными: идентификатор пакета (Id), версия, описание, автор, лицензия, список зависимостей от других пакетов.
  • Сборки (DLL) — для различных целевых платформ (например, net6.0, net48, netstandard2.0).
  • Содержимое — файлы, которые могут быть добавлены в проект (например, скрипты, изображения, конфигурации).
  • Скрипты — PowerShell-скрипты (install.ps1, uninstall.ps1, init.ps1) для выполнения действий при установке или удалении (в основном используются в Visual Studio).

Управление зависимостями

NuGet решает проблему «ада зависимостей» (dependency hell) путём:

  • Транзитивного разрешения — при установке пакета автоматически загружаются все его зависимости, включая зависимости зависимостей.
  • Версионирования — используется семантическое версионирование (MAJOR.MINOR.PATCH). Пакет может указывать диапазон допустимых версий зависимостей (например, >=1.0.0 && <2.0.0).
  • Восстановления пакетов — при сборке проекта (команда dotnet restore или nuget restore) все зависимости загружаются из репозиториев в локальный кэш. Это позволяет не хранить DLL в системе контроля версий.

Типы репозиториев

Публичный репозиторий nuget.org

Основной источник открытых пакетов. Содержит более 400 000 уникальных пакетов (по состоянию на 2024 год). Публикация пакетов требует регистрации учётной записи и соблюдения правил (например, уникальность идентификатора, отсутствие вредоносного кода). Пакеты могут быть подписаны цифровой подписью для верификации автора.

Частные репозитории

Для корпоративного использования создаются частные репозитории:

  • NuGet.Server — простой HTTP-сервер на базе ASP.NET.
  • Azure Artifacts — облачный сервис Microsoft, интегрированный с Azure DevOps.
  • GitHub Packages — репозиторий пакетов, встроенный в GitHub.
  • ProGet (Inedo) — коммерческий сервер управления пакетами.
  • MyGet — облачный хостинг частных NuGet-репозиториев.

Инструменты и интерфейсы

Visual Studio

В среде Visual Studio (версии 2010 и новее) встроен графический менеджер пакетов (UI) и консоль менеджера пакетов (Package Manager Console). UI позволяет искать, устанавливать, обновлять и удалять пакеты через интерфейс. Консоль использует PowerShell-командлеты (например, Install-Package, Update-Package, Uninstall-Package).

.NET CLI (dotnet)

Для .NET Core и более новых версий основным инструментом является dotnet:

  • dotnet add package <имя_пакета> — установка пакета.
  • dotnet remove package <имя_пакета> — удаление.
  • dotnet list package — просмотр установленных пакетов.
  • dotnet restore — восстановление зависимостей.

NuGet.exe

Классическая утилита командной строки для .NET Framework и .NET Core. Используется в сценариях CI/CD, не требующих Visual Studio. Команды: nuget install, nuget update, nuget push (для публикации пакетов).

Применение

Разработка приложений

NuGet является стандартом для управления зависимостями в проектах на C#, F#, VB.NET и других языках, работающих на платформе .NET. Разработчики используют NuGet для:

  • Подключения библиотек (например, Newtonsoft.Json, Entity Framework, ASP.NET Core).
  • Установки инструментов (например, анализаторов кода, генераторов кода).
  • Обновления версий библиотек без ручного копирования файлов.

CI/CD и автоматизация

В системах непрерывной интеграции (Azure DevOps, Jenkins, GitHub Actions) NuGet используется для:

  • Восстановления пакетов перед сборкой.
  • Публикации собственных пакетов в корпоративный репозиторий.
  • Управления версиями сборок через семантическое версионирование.

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

Разработчики могут создавать собственные пакеты NuGet для распространения своих библиотек. Для этого:

  1. Создаётся файл .nuspec с метаданными.
  2. Выполняется команда nuget pack или dotnet pack.
  3. Пакет публикуется в репозиторий командой nuget push или dotnet nuget push.

Безопасность и аутентификация

Подпись пакетов

Начиная с NuGet 4.6, поддерживается подпись пакетов цифровой подписью. Пакеты могут быть подписаны:

  • Авторской подписью — удостоверяет автора пакета.
  • Подписью репозитория — удостоверяет, что пакет был опубликован в доверенном репозитории (например, nuget.org).

Аутентификация для частных репозиториев

NuGet поддерживает несколько способов аутентификации:

  • API-ключи — для публикации пакетов.
  • Basic Auth — логин и пароль.
  • OAuth / Azure AD — для Azure Artifacts.
  • Windows Authentication — для корпоративных серверов.

Проверка на вредоносный код

Пакеты на nuget.org проходят автоматическую проверку на наличие вредоносного кода (сканирование на вирусы, анализ подозрительных паттернов). Microsoft также использует машинное обучение для выявления подозрительных пакетов.

Критика и ограничения

Проблема с транзитивными зависимостями

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

Размер кэша

Локальный кэш пакетов (обычно в %userprofile%\.nuget\packages) может занимать значительное место на диске, особенно при работе с большим количеством проектов.

Сложность для новичков

Понимание механизмов разрешения зависимостей, файлов .nuspec, packages.config vs PackageReference может быть нетривиальным для начинающих разработчиков.

Зависимость от внешних репозиториев

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

Интересные факты

  • Название «NuGet» происходит от слов «Nu» (сокращение от «New») и «Get» (получить).
  • Исходный код NuGet полностью открыт на GitHub под лицензией MIT.
  • Самый популярный пакет на nuget.org — Newtonsoft.Json (более 3 миллиардов загрузок по состоянию на 2024 год).
  • В 2022 году Microsoft объявила о прекращении поддержки packages.config в пользу PackageReference для новых проектов.

Источники

  • Документация Microsoft по NuGet (learn.microsoft.com/nuget)
  • Официальный сайт NuGet (nuget.org)
  • Репозиторий NuGet на GitHub (github.com/NuGet)
  • Статья «NuGet: The Package Manager for .NET» в журнале MSDN Magazine (2010)
  • Спецификация формата пакета NuGet (.nuspec)

BFOmetr — база данных и аналитика по компаниям России.

На главную BFOmetr →

Похожие материалы