Обзор NuGet.org

NuGet.org — это общедоступный узел пакетов NuGet, используемых миллионами разработчиков .NET и .NET Core каждый день.

Роль NuGet.org в экосистеме NuGet

В качестве общедоступного узла NuGet.org сам поддерживает центральный репозиторий более 100 000 уникальных пакетов в nuget.org. NuGet.org — это не единственный возможный узел для пакетов. Технология NuGet также позволяет размещать пакеты в частном режиме (например, в Azure DevOps), в частной сети или даже в локальной файловой системе. Если вас интересует другой хост или вариант размещения, см. статью Размещение собственных фидов NuGet.

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

Accounts

Чтобы опубликовать пакеты на NuGet.org, сначала создайте отдельную учетную запись (пользователя). Это становится вашим удостоверением на NuGet.org.

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

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

Ключи API

После публикации пакета NuGet (NUPKG-файла ) его можно опубликовать в NuGet.org с помощью интерфейса командной строки nuget.exe или интерфейса командной строки dotnet.exe, а также ключа API , полученного из NuGet.org.

При публикации пакета вы включаете значение ключа API в команду CLI.

Надежная публикация

NuGet.org поддерживает надежную публикацию, которая является безопасным и упрощенным способом публикации пакетов NuGet.

Префиксы идентификаторов

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

Конечная точка API для NuGet.org

Чтобы использовать NuGet.org в качестве репозитория пакетов с клиентами NuGet, следует использовать следующую конечную точку API версии 3:

https://api.nuget.org/v3/index.json

Старые клиенты по-прежнему могут использовать протокол V2 для доступа к NuGet.org. Однако обратите внимание, что клиенты NuGet 3.0 или более поздней версии будут иметь более медленную и менее надежную службу с помощью протокола V2:

https://www.nuget.org/api/v2 (Протокол версии 2 не рекомендуется!)