Organize seu projeto para oferecer suporte ao .NET Framework e ao .NET

Você pode criar uma solução que compila para .NET Framework e .NET lado a lado. Este artigo aborda várias opções de organização de projeto para ajudá-lo a atingir esse objetivo. Aqui estão alguns cenários típicos a serem considerados ao decidir como configurar o layout do projeto com o .NET. A lista pode não cobrir tudo o que você quer.

• Combine projetos existentes e projetos .NET em um único projeto

  Benefícios:

  • Simplifica seu processo de compilação compilando um único projeto em vez de vários projetos que visam uma versão ou plataforma diferente do .NET Framework.
  • Simplifica o gerenciamento de arquivos de origem para projetos com vários destinos porque você deve gerenciar um único arquivo de projeto. Ao adicionar ou remover arquivos de origem, as alternativas exigem que você sincronize manualmente esses arquivos com seus outros projetos.
  • Gere facilmente um pacote NuGet para consumo.
  • Permite que você escreva código para uma versão específica do .NET Framework usando diretivas de compilador.

  Desvantagem:

  • Requer que os desenvolvedores usem o Visual Studio 2019 ou uma versão posterior para abrir projetos existentes. Para oferecer suporte a versões mais antigas do Visual Studio, manter seus arquivos de projeto em pastas diferentes é uma opção melhor.

• Mantenha todos os projetos separados

  Benefícios:

  • Suporta o desenvolvimento em projetos existentes para desenvolvedores e colaboradores que podem não ter o Visual Studio 2019 ou uma versão posterior.
  • Reduz a possibilidade de criar novos bugs em projetos existentes porque nenhuma rotatividade de código é necessária nesses projetos.

Considere este exemplo de repositório GitHub. A figura abaixo mostra como esse repositório está disposto:

As seções a seguir descrevem várias maneiras de adicionar suporte para .NET com base no repositório de exemplo.

Substitua projetos existentes por um projeto .NET com vários destinos

Reorganize o repositório para que todos os arquivos *.csproj existentes sejam removidos e um único arquivo *.csproj seja criado para várias estruturas. Esta é uma ótima opção, porque um único projeto pode compilar para diferentes frameworks. Ele também tem o poder de lidar com diferentes opções de compilação e dependências por estrutura de destino.

Para obter um código de exemplo, consulte GitHub.

As alterações a observar são:

• Substituição de packages.config e *.csproj por um novo .NET *.csproj. Os pacotes NuGet são especificados com <PackageReference> ItemGroup.

Manter projetos existentes e criar um projeto .NET

Se houver projetos existentes destinados a estruturas mais antigas, convém deixar esses projetos intocados e usar um projeto .NET para direcionar estruturas futuras.

Para obter um código de exemplo, consulte GitHub.

O .NET e os projetos existentes são mantidos em pastas separadas. Manter projetos em pastas separadas evita forçá-lo a ter o Visual Studio 2019 ou versões posteriores. Você pode criar uma solução separada que abre apenas os projetos antigos.

Ver também

• Documentação de portabilidade do .NET