Criação de pacotes de pré-lançamento

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

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

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

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

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

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

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

  <version>1.0.1-alpha</version>
  

Quando estiver pronto para lançar uma versão estável, basta remover o sufixo e o pacote tem precedência sobre quaisquer versões de pré-lançamento. Novamente, consulte Controle de versão de pacotes.

Instalação e atualização de 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.

• Consola do Gestor de Pacotes: use o -IncludePrerelease switch com os comandos Find-Package, Get-Package, Install-Package, Sync-Package e Update-Package. Consulte a Referência do PowerShell.

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

Versionamento semântico

A convenção Semantic 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 de pacotes.