Visão geral do NuGet.org

NuGet.org é um host público de pacotes NuGet que são empregados por milhões de desenvolvedores .NET e .NET Core todos os dias.

Papel do NuGet.org no ecossistema NuGet

Em seu papel de host público, a própria NuGet.org mantém o repositório central de mais de 100.000 pacotes exclusivos em nuget.org. NuGet.org não é o único host possível para pacotes. A tecnologia NuGet também permite que você hospede pacotes de forma privada na nuvem (como no Azure DevOps), em uma rede privada ou até mesmo apenas em seu sistema de arquivos local. Se você estiver interessado em um host ou opção de hospedagem diferente, consulte Hospedar seus próprios feeds NuGet.

NuGet.org, como qualquer host para pacotes NuGet, serve como o ponto de conexão entre os criadores de pacotes e os consumidores de pacotes. Os criadores criam pacotes NuGet úteis e os publicam. Em seguida, os consumidores procuram pacotes úteis e compatíveis em anfitriões acessíveis, descarregando e incluindo esses pacotes nos seus projetos. Uma vez instalado em um projeto, as APIs dos pacotes ficam disponíveis para o restante do código do projeto.

Accounts

Para publicar pacotes no NuGet.org, primeiro crie uma conta individual (de usuário). Isso se torna sua identidade em NuGet.org.

NuGet.org também permite que você crie uma conta de organização. Uma conta de organização tem uma ou mais contas individuais como seus membros. Os membros podem gerenciar um conjunto de pacotes, mantendo uma única identidade de propriedade. Através da sua conta individual, pode ser membro de qualquer número de organizações.

Um pacote pode pertencer a uma conta de organização como pode pertencer a uma conta individual. Os consumidores de pacotes não veem nenhuma diferença entre uma conta individual ou a conta da organização: ambas aparecem como pacote owners.

Chaves de API

Depois de ter um pacote NuGet (arquivo .nupkg ) para publicar, publique-o no NuGet.org usando a CLI nuget.exe ou a CLI dotnet.exe, juntamente com uma chave de API adquirida do NuGet.org.

Ao publicar um pacote, você inclui o valor da chave da API no comando CLI.

Publicação fidedigna

NuGet.org suporta Publicação Confiável, que é uma maneira segura e simplificada de publicar pacotes NuGet.

Prefixos de ID

Ao publicar pacotes, você pode reservar e proteger sua identidade reservando prefixos de ID. Ao instalar um pacote, os consumidores de pacotes recebem informações adicionais indicando que o pacote que estão consumindo não é enganoso em suas propriedades de identificação.

Ponto de extremidade da API para NuGet.org

Para usar o NuGet.org como repositório de pacotes com os clientes NuGet, deve usar o seguinte ponto de extremidade da API V3:

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

Clientes mais antigos ainda podem usar o protocolo V2 para alcançar NuGet.org. No entanto, observe que os clientes NuGet 3.0 ou posterior terão um serviço mais lento e menos confiável usando o protocolo V2:

https://www.nuget.org/api/v2 (O protocolo V2 foi preterido!)