Partilhar via


Visão geral do NuGet.org

O NuGet.org é um host público de pacotes NuGet que são utilizados por milhões de desenvolvedores do .NET e do .NET Core diariamente.

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

Em sua função de host público, o próprio 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 do NuGet também permite hospedar pacotes em modo privado na nuvem (como o Azure DevOps), em uma rede privada ou, até mesmo, apenas no sistema de arquivos local. Caso esteja interessado em outro host ou outra opção de hospedagem, confira Como hospedar seus próprios feeds do NuGet.

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

Relationship between package creators, package hosts, and package consumers

Contas

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

O NuGet.org também permite que você crie uma conta da organização. Uma conta da organização tem uma ou mais contas individuais como seus membros. Os membros podem gerenciar um conjunto de pacotes, mantendo uma única identidade para a 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 da mesma forma que pode pertencer a uma conta individual. Os consumidores do pacote não veem nenhuma diferença entre uma conta individual ou a conta da organização: ambas são exibidas como o pacote owners.

Chaves de API

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

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

Prefixos da ID

Ao publicar pacotes, você pode reservar e proteger sua identidade reservando prefixos da 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 de API para o NuGet.org

Para usar o NuGet.org como um repositório de pacotes com clientes do NuGet, você deverá usar o seguinte ponto de extremidade de API V3:

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

Clientes mais antigos ainda podem usar o protocolo V2 para acessar NuGet.org. No entanto, observe que NuGet clientes 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!)