Publicar pacotes para NuGet.org

  • Artigo

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

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 ao redor do mundo.

Pré-requisitos

  • Qualquer versão do Visual Studio 2019 e a carga de trabalho do .NET Core.
  • dotnet CLI. Se ainda não o tiver, instale o SDK do .NET Core.
  • Registe-se para obter uma conta gratuita no nuget.org se 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 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 , Pacote.

  2. Preencha o formulário e certifique-se de que o ID do seu pacote é único, 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 criar 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 Pack para gerar seu .nupkg pacote.

    Gerar pacote

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

    Saída do pacote

Gerar 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 ainda não o tenha feito.

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

  3. Selecione Criar e, em seguida, introduza um nome para a sua chave. Dê à sua chave um escopo Push new packages and package version e insira * no campo glob pattern 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 a chave de API

Publicar um pacote para 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 seu nupkg 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 da 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