O 'dotnet publish' usa a configuração Release

  • Artigo

O comando dotnet publish agora usa a configuração Release em vez da configuração Debug por padrão quando a estrutura de destino é o .NET 8 ou uma versão posterior.

Comportamento anterior

Antes, dotnet publish usava a configuração Debug, a menos que a configuração fosse especificada explicitamente ou que PublishRelease fosse definida como true.

A propriedade PublishRelease foi adicionada ao .NET 7 visando essa alteração interruptiva. Antes, era possível definir a variável de ambiente DOTNET_CLI_ENABLE_PUBLISH_RELEASE_FOR_SOLUTIONS para usar PublishRelease em um projeto que fazia parte de uma solução do Visual Studio.

Novo comportamento

Se você estiver desenvolvendo com o SDK do .NET 8 ou uma versão posterior, dotnet publish usará a configuração Release por padrão para projetos cujo TargetFramework está definido como net8.0 ou uma versão posterior. Se você tiver um script, testes ou um código de CI/CD com Debug embutido em código em um caminho de saída, essa alteração poderá interromper o fluxo de trabalho.

Se o projeto for direcionado a várias versões, o novo comportamento só se aplicará se você especificar a estrutura de destino .NET 8 ou posterior ao fazer a publicação (por exemplo, usando dotnet publish -f net8.0).

Para projetos em uma solução:

  • dotnet publish pode publicar todos os projetos em uma solução do Visual Studio se receber um arquivo de solução. Para os projetos de solução destinados ao .NET 8 ou posterior, o valor de PublishRelease será definido implicitamente como true se estiver indefinido. No entanto, para que dotnet publish determine a configuração correta a ser usada na solução, todos os projetos na solução precisam concordar com o valor PublishRelease. Se um projeto mais antigo na solução tiver PublishRelease definido como false, você também deverá definir explicitamente a propriedade como false para novos projetos do .NET 8 ou superior.

  • Essa alteração pode regredir o desempenho de dotnet publish, principalmente em soluções que contêm muitos projetos. Para resolver isso, uma nova variável de ambiente DOTNET_CLI_LAZY_PUBLISH_AND_PACK_RELEASE_FOR_SOLUTIONS foi introduzida.

  • A variável de ambiente DOTNET_CLI_ENABLE_PUBLISH_RELEASE_FOR_SOLUTIONS não é mais reconhecida.

Versão introduzida

.NET 8 versão prévia 1

Tipo de alteração interruptiva

Essa alteração pode afetar a compatibilidade de origem e também é uma alteração comportamental.

Motivo da alteração

Na maioria dos casos, ao publicar, você deseja que o código seja otimizado e pode manter o aplicativo menor excluindo as informações de depuração. Durante muito tempo, os clientes pediram que Release fosse a configuração padrão de publish. Além disso, o Visual Studio tem esse comportamento há muitos anos.

A variável de ambiente DOTNET_CLI_ENABLE_PUBLISH_RELEASE_FOR_SOLUTIONS foi removida, pois o comportamento habilitado agora é o padrão e o controle granular não é mais necessário.

  • Para desabilitar totalmente o novo comportamento, você pode definir a variável de ambiente DOTNET_CLI_DISABLE_PUBLISH_AND_PACK_RELEASE como true (ou qualquer outro valor). Essa variável afeta dotnet publish e dotnet pack.

  • Para especificar explicitamente a configuração Debug para publicação, use a opção -c ou --configuration com dotnet publish.

  • Se o pipeline de CI/CD estiver interrompido devido a caminhos de saída embutidos em código, atualize os caminhos para Release em vez de Debug, desabilite o novo comportamento usando a variável de ambiente DOTNET_CLI_DISABLE_PUBLISH_AND_PACK_RELEASE ou especifique que a configuração Debug deve ser usada.

  • Se você estiver publicando uma solução e ela estiver interrompida, defina explicitamente PublishRelease como true (ou false para reverter ao comportamento anterior).

    <PropertyGroup>
  <PublishRelease>true</PublishRelease>
</PropertyGroup>

    Como alternativa, você pode especificar a propriedade em um arquivo Directory.Build.Props. No entanto, se você defini-la como false nesse arquivo, ainda precisará definir explicitamente a propriedade como false nos projetos do .NET 8 ou superiores na solução. Da mesma forma, se alguns projetos definirem explicitamente um valor diferente do valor no arquivo Directory.Build.Props, a publicação falhará.

  • Se você estiver publicando uma solução e o desempenho tiver regredido, defina a variável de ambiente DOTNET_CLI_LAZY_PUBLISH_AND_PACK_RELEASE_FOR_SOLUTIONS como true (ou qualquer outro valor) para remover a regressão. No entanto, se você definir essa variável e a solução contiver um projeto .NET 8 ou superior e um projeto direcionado ao .NET 7 ou anterior, a publicação falhará até que todos os projetos definam PublishRelease. Essa variável afeta dotnet publish e dotnet pack.

Confira também