Criando pacotes de pré-lançamento

Sempre que você lança um pacote atualizado com um novo número de versão, o NuGet considera essa como a "versão estável mais recente", como mostrado, por exemplo, na interface do usuário do Gerenciador de Pacotes no Visual Studio:

Uma versão estável é considerada confiável o suficiente para ser usada na produção. A versão estável mais recente também é a que será instalada como uma atualização de pacote ou durante a restauração do pacote (sujeito a restrições, conforme descrito em Reinstalar e atualizar pacotes).

Para dar suporte ao ciclo de vida da versão de software, o NuGet 1.6 e posterior permite a distribuição de pacotes de pré-lançamento, em que o número de versão inclui um sufixo de controle de versão semântico, como -alpha, -betaou -rc. Para obter mais informações, consulte o controle de versão do pacote.

Você pode especificar essas versões usando uma das seguintes maneiras:

• Se o projeto usar PackageReference: inclua o sufixo de versão semântica no elemento PackageVersion do arquivo .csproj:

  <PropertyGroup>
      <PackageVersion>1.0.1-alpha</PackageVersion>
  </PropertyGroup>
  

• Se o projeto tiver um arquivo packages.config: inclua o sufixo de versão semântica no elemento .nuspec do arquivo version.

  <version>1.0.1-alpha</version>
  

Quando você estiver pronto para lançar uma versão estável, basta remover o sufixo e o pacote terá precedência sobre todas as versões de pré-lançamento. Novamente, consulte o controle de versão do pacote.

Instalando e atualizando pacotes de pré-lançamento

Por padrão, o NuGet não inclui versões de pré-lançamento ao trabalhar com pacotes, mas você pode alterar esse comportamento da seguinte maneira:

• Interface do usuário do Gerenciador de Pacotes no Visual Studio: na interface do usuário Gerenciar Pacotes NuGet, marque a caixa Incluir pré-lançamento:

  

  Definir ou desmarcar essa caixa atualizará a interface do usuário do Gerenciador de Pacotes e a lista de versões disponíveis que você pode instalar.

• Console do Gerenciador de Pacotes: use o parâmetro -IncludePrerelease com os comandos Find-Package, Get-Package, Install-Package, Sync-Package e Update-Package. Consulte a referência do PowerShell.

• CLI do NuGet: use a opção -prerelease com os comandos install, update, delete e mirror. Consulte a referência da CLI do NuGet

Versionamento semântico

A convenção Semmantic Versioning ou SemVer descreve como utilizar cadeias de caracteres em números de versão para transmitir o significado do código subjacente. Saiba mais sobre as noções básicas de controle de versão do pacote.