Fluxo de trabalho de criação de pacotes

A criação de um pacote começa com o código compilado (normalmente assemblies .NET) que você deseja empacotar e compartilhar com outras pessoas, seja por meio da galeria de nuget.org pública ou de uma galeria privada em sua organização. O pacote também pode incluir arquivos adicionais, como um readme que é exibido quando o pacote é instalado, e pode incluir transformações para determinados arquivos de projeto.

Um pacote também pode servir apenas para incluir qualquer número de outras dependências, sem conter nenhum código próprio. Esse pacote é uma maneira conveniente de fornecer um SDK composto por vários pacotes independentes. Em outros casos, um pacote pode conter apenas arquivos de símbolo (.pdb) para ajudar na depuração.

Observação

Quando você cria um pacote para uso por outros desenvolvedores, é importante entender que eles estão dependendo do seu trabalho. Como tal, criar e publicar um pacote também implica um compromisso em corrigir bugs e fazer outras atualizações, ou pelo menos disponibilizar o pacote como código aberto para que outros possam ajudar a mantê-lo.

Seja qual for o caso, a criação de um pacote começa com a decisão de seu identificador, número de versão, licença, informações de direitos autorais e qualquer outro conteúdo necessário. Uma vez feito, você pode usar o comando "pack" para colocar tudo junto em um .nupkg arquivo. Esse arquivo pode ser publicado em um feed do NuGet, como nuget.org.

Sugestão

Um pacote NuGet com a .nupkg extensão é simplesmente um arquivo ZIP. Para examinar facilmente o conteúdo de qualquer pacote, altere a extensão para .zip e expanda o seu conteúdo como de costume. Apenas certifique-se de alterar a extensão de volta para .nupkg antes de tentar carregá-la para um host.

Para aprender e entender o processo de criação, comece com Criar um pacote que o orienta pelos principais processos comuns a todos os pacotes.

A partir daí, você pode considerar uma série de outras opções para o seu pacote:

• Supporting Multiple Target Frameworks descreve como criar um pacote com várias variantes para diferentes .NET Frameworks.
• Criar pacotes localizados descreve como estruturar um pacote com vários recursos de idioma e como usar pacotes satélite localizados separados.
• Pacotes de pré-lançamento demonstra como lançar pacotes alfa, beta e rc para os clientes interessados.
• Source and Config File Transformations descreve como você pode fazer substituições de token unidirecionais em arquivos que são adicionados a um projeto e modificar web.config e app.config com configurações que também são retiradas quando o pacote é desinstalado.
• Os Pacotes de Símbolos oferecem orientação para o fornecimento de símbolos para a sua biblioteca que permitem que os consumidores acedam ao seu código durante a depuração.
• O controle de versão de pacotes discute como identificar as versões exatas que você permite para suas dependências (outros pacotes que você consome do seu pacote).
• Native Packages descreve o processo de criação de um pacote para consumidores C++.
• Signing Packages descreve o processo para adicionar uma assinatura digital a um pacote.

Quando estiver pronto para publicar um pacote para nuget.org, siga o processo simples em Publicar um pacote.

Se você quiser usar um feed privado em vez de nuget.org, consulte a Visão geral dos pacotes de hospedagem