Compartilhar via

Publicar pacotes no NuGet.org

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

NuGet.org é um gerenciador de pacotes que permite aos desenvolvedores compartilhar código reutilizável. Um pacote NuGet é um arquivo compactado com .nupkg extensão que contém código compilado que pode ser consumido em outros projetos. Os pacotes hospedados em NuGet.org estão disponíveis para todos os desenvolvedores em todo o mundo.

Pré-requisitos

  • Qualquer versão do Visual Studio 2019 e da carga de trabalho do .NET Core.
  • dotnet CLI. Se você ainda não o tiver, instale o SDK do .NET Core.
  • Registre-se para obter uma conta gratuita no nuget.org se você ainda não tiver uma.

Criar um projeto

Você pode usar seu próprio projeto .NET para criar e gerar um pacote NuGet ou criar uma nova biblioteca de classes .NET básica da seguinte maneira:

  1. No Visual Studio, selecione Arquivo, Novo e, em seguida, Projeto.

  2. Selecione o modelo da Biblioteca de Classes (.NET Standard) e selecione Avançar.

  3. Nomeie seu projeto e sua solução e selecione um local para salvar o projeto localmente. Selecione Criar quando terminar.

    Criar um projeto de biblioteca de classes

A biblioteca de classes de modelo é suficiente para criar um pacote NuGet, portanto, para este tutorial, usaremos o modelo existente e não escreveremos nenhum código adicional.

Configurar e gerar um pacote

  1. Selecione seu projeto no gerenciador de soluções, clique com o botão direito do mouse e selecione as propriedades e, em seguida, Empacotar.

  2. Preencha o formulário e verifique se a ID do pacote é exclusiva caso contrário, poderá entrar em conflito com os pacotes existentes no NuGet.org. Uma convenção de nomenclatura comum é algo como: Company.Product.Feature. Se você quiser gerar seu pacote sempre que construir seu projeto, selecione a caixa de seleção Gerar pacote NuGet no build.

    Configurar propriedades do pacote

  3. Selecione seu projeto no gerenciador de soluções, clique com o botão direito do mouse e selecione Pack para gerar seu .nupkg pacote.

    Gerar pacote

  4. Verifique o status do comando do pacote na janela de saída.

    Saída do pacote

Gere uma chave de API

Agora que criamos nosso nupkg pacote, estamos quase prontos para publicá-lo, mas primeiro precisamos gerar uma chave de API para se conectar à API NuGet.org.

  1. Entre em sua conta de NuGet.org ou crie uma se não tiver feito isso.

  2. Selecione o ícone de nome de usuário e selecione Chaves de API.

  3. Selecione Criar e, em seguida, insira um nome para sua chave. Dê à sua chave o escopo Push new packages and package version e insira * no campo de padrão glob para selecionar todos os pacotes. Selecione Criar quando terminar.

    Criar chave de API

  4. Selecione Copiar e salve sua chave de API em um local seguro. Precisaremos dessa chave para publicar nosso pacote NuGet.

    Copiar chave de API

Publicar um pacote no NuGet.org

Você pode publicar seu pacote usando a interface de usuário da Web, dotnet CLI ou CLI nuget.exe. Vamos nos concentrar na publicação de pacotes usando a linha de comando nesta seção. Você precisará do nome do pacote, de uma chave de API e da URL de origem para fazer isso.

  1. Em um prompt de comando com privilégios elevados, navegue até a pasta que contém o pacote nupkg.

  2. Execute o comando a seguir para publicar seu pacote no NuGet.org. Substitua os espaços reservados pelo nome do pacote e pela chave de API.

    dotnet nuget push <packageName> --api-key <APIKey> --source https://api.nuget.org/v3/index.json

  3. A saída do comando anterior deve ser semelhante a esta.

    Publicar saída do pacote