Compartilhar via


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.

Função de NuGet.org no ecossistema do NuGet

Em sua função de host público, NuGet.org em si 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 hospedar pacotes privadamente na nuvem (como no Azure DevOps), em uma rede privada ou até mesmo em apenas seu sistema de arquivos local. Se você estiver interessado em uma opção de host ou hospedagem diferente, consulte Hospedar seus próprios feeds do NuGet.

NuGet.org, como qualquer host para pacotes NuGet, serve como o ponto de conexão entre criadores de pacotes e consumidores de pacotes. Os criadores criam pacotes NuGet úteis e os publicam. Em seguida, os consumidores procuram pacotes úteis e compatíveis em hosts acessíveis, baixando e incluindo esses pacotes em seus projetos. Depois de instaladas em um projeto, as APIs dos pacotes estão disponíveis para o restante do código do projeto.

Relação entre criadores de pacotes, hosts de pacote e consumidores de pacotes

Accounts

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

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

Um pacote pode pertencer a uma conta da organização como se ele pertencesse 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 do nuget.exe ou a CLI dotnet.exe, juntamente com uma chave de API adquirida de NuGet.org.

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

Publicação confiável

NuGet.org dá suporte à 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 eles estão consumindo não é enganoso em suas propriedades de identificação.

Endpoint de API para NuGet.org

Para usar NuGet.org como um repositório de pacotes para clientes NuGet, você deve usar o seguinte endpoint da API V3:

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

Os clientes mais antigos ainda podem usar o protocolo V2 para alcançar NuGet.org. No entanto, observe que os clientes NuGet 3.0 ou posteriores 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!)