Поделиться через


Общие сведения о сайте 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 пакеты становятся доступны остальной части кода проекта.

Relationship between package creators, package hosts, and package consumers

Учетные записи

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

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

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

Ключи API

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

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

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

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

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

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

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

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

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