Fluxo de trabalho de criação de pacote

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 nuget.org pública ou de uma galeria privada em sua organização. O pacote também pode incluir arquivos adicionais, como um arquivo "leiame" exibido quando o pacote é instalado, e pode incluir transformações de determinados arquivos de projeto.

Um pacote também pode servir apenas para importar um conjunto de outras dependências, sem conter nenhum código próprio. Esse pacote é uma maneira conveniente de entregar 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 outros desenvolvedores usarem, é importante entender que eles estão dependendo do seu trabalho. Dessa forma, criar e publicar um pacote também implica em um compromisso de corrigir bugs e fazer outras atualizações ou, no mínimo, disponibilizar o pacote como software livre para que outras pessoas 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 concluído, você pode usar o comando "pack" para montar tudo em um .nupkg arquivo. Esse arquivo pode ser publicado em um feed do NuGet, como nuget.org.

Dica

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 seu conteúdo como de costume. Basta ter certeza de alterar a extensão de volta para .nupkg antes de tentar carregá-la em um host.

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

A partir daí, você pode considerar várias outras opções para o pacote:

• O suporte a várias estruturas de destino descreve como criar um pacote com várias variantes para diferentes .NET Frameworks.
• A criação de pacotes localizados descreve como estruturar um pacote com vários recursos de idioma e como usar pacotes satélites localizados separados.
• Pacotes de pré-lançamento demonstram como liberar pacotes alfa, beta e rc para os clientes interessados.
• Transformações de Arquivo de Origem e de Configuração descreve como você pode fazer substituições unidirecionais de token em arquivos que são adicionados a um projeto e modificar web.config e app.config com configurações que também são revertidas quando o pacote é desinstalado.
• Os Pacotes de Símbolos oferecem diretrizes para fornecer símbolos para sua biblioteca que permitem que os consumidores entrem em seu código durante a depuração.
• O controle de versão do pacote discute como identificar as versões exatas que você permite para suas dependências (outros pacotes que você consome do pacote).
• Pacotes nativos descrevem o processo de criação de um pacote para consumidores C++.
• Os Pacotes de Assinatura descrevem o processo de adição de uma assinatura digital a um pacote.

Quando estiver pronto para publicar um pacote no 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