Publicar pacotes no NuGet.org

  • Artigo

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

NuGet.org é um gerenciador de pacotes que permite que os desenvolvedores compartilhem 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 ao redor do mundo.

Pré-requisitos

  • Qualquer versão do Visual Studio 2019 e a carga de trabalho do .NET Core.
  • dotnet CLI. Se você ainda não o tiver, instale o SDK do .NET Core.
  • Registre-se para 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 Projeto.

  2. Selecione o modelo 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 propriedades e, em seguida, Pacote.

  2. Preencha o formulário e certifique-se de que o ID do seu pacote é exclusivo, caso contrário, ele pode 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 toda vez que compilar seu projeto, marque a caixa de seleção Gerar pacote NuGet na compilação .

    Configurar propriedades do pacote

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

    Gere o pacote

  4. Verifique o status do comando pack 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 nos conectarmos à API NuGet.org.

  1. Inicie sessão na sua conta NuGet.org ou crie uma, caso não o tenha feito.

  2. Selecione o ícone do seu nome de usuário e, em seguida, selecione Chaves de API.

  3. Selecione Criar e insira um nome para sua chave. Dê à sua chave um escopo Enviar novos pacotes e versão de pacote 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 do usuário da Web, a CLI dotnet ou nuget.exe CLI. Vamos nos concentrar na publicação de pacotes usando a linha de comando nesta seção. Você precisará do nome do seu pacote, de uma chave de API e da URL de origem para fazer isso.

  1. Em um prompt de comando elevado, navegue até a pasta que contém nupkg o pacote.

  2. Execute o seguinte comando 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 algo assim.

    Publicar saída do pacote