Portando aplicativos da área de trabalho para o .NET Core

Desde que eu tenho trabalhado com a comunidade na portabilidade de aplicativos de desktop do .NET Framework para o .NET Core, notei que existem dois grupos de pessoas: alguns desejam uma lista muito simples e curta de instruções para que seus aplicativos sejam portados. O .NET Core, enquanto outros preferem uma abordagem mais baseada em princípios, com mais informações básicas. Em vez de escrever um documento "Canivete suíço", publicaremos duas postagens no blog, uma para cada campo:

• Este post é um caso simples . Ele é focado em instruções simples e aplicativos menores e é a maneira mais fácil de mover seu aplicativo para o .NET Core.
• Publicaremos outro post para casos mais complicados . Esta postagem se concentrará mais em aplicativos não triviais, como o aplicativo WPF com dependências no WCF e nos pacotes de UI de terceiros.

Se você prefere assistir a vídeos em vez de ler, aqui está o vídeo em que faço tudo o que está descrito abaixo.

Etapa 0 - Pré-requisitos

Para portar seus aplicativos de desktop para o Core, você precisará do .NET Core 3 e do Visual Studio 2019.

Etapa 1 - Execute o analisador de portabilidade

Antes de portar, verifique se o aplicativo é compatível com o .NET Core. Para fazer isso, baixe e execute o .NET Portability Analyzer .

• Na primeira guia, Resumo da portabilidade, se você possui apenas 100% na coluna .NET Core (tudo está destacado em verde), seu código é totalmente compatível, vá para a Etapa 2.
• Se você tiver valores inferiores a 100%, verifique primeiro todos os assemblies que não fazem parte do seu aplicativo. Para esses, verifique se os autores estão fornecendo versões para o .NET Core ou .NET Standard.
• Agora observe a outra parte dos assemblies provenientes do seu código. Se você não possui nenhum dos seus assemblies listados no relatório de portabilidade, vá para a Etapa 2. Se tiver, abra a guia Detalhes, filtre a tabela clicando na coluna Montagem e concentre-se apenas nos que são do seu aplicativo. Percorra a lista e refatorar seu código para parar de usar a API ou substituir o uso da API por alternativas do .NET Core.

Etapa 2 - Migrar para .csproj no estilo SDK

No Gerenciador de Soluções , clique com o botão direito do mouse no seu projeto (não na solução!). Você vê Editar arquivo de projeto ? Se fizer isso, você já usa o arquivo de projeto no estilo SDK, portanto, você deve passar para a Etapa 3 . Caso contrário, faça o seguinte.

• Verifique no Solution Explorer se o seu projeto contém um arquivo packages.config . Caso contrário, nenhuma ação será necessária; se o fizer, clique com o botão direito do mouse em packages.config e escolha Migrar packages.config para PackageReference . Depois clique em OK .
• Abra o arquivo do projeto clicando com o botão direito do mouse no projeto e escolha Descarregar Projeto . Em seguida, clique com o botão direito do mouse no projeto e escolha Editar <nome do seu projeto> .csproj .
• Copie o conteúdo do arquivo do projeto em algum lugar, por exemplo, no Bloco de Notas, para que você possa pesquisar mais tarde.
• Exclua tudo do seu arquivo de projeto aberto no Visual Studio (eu sei que parece agressivo, mas adicionaremos apenas o conteúdo necessário da cópia que acabamos de fazer em algumas etapas). Em vez do texto que você acabou de excluir, cole o código a seguir.Para um aplicativo WinForms:
  
  

   <Project Sdk="Microsoft.NET.Sdk.WindowsDesktop"> <PropertyGroup> <OutputType>WinExe</OutputType> <TargetFramework>net472</TargetFramework> <UseWindowsForms>true</UseWindowsForms> <GenerateAssemblyInfo>false</GenerateAssemblyInfo> </PropertyGroup> </Project> 

  
  Para um aplicativo WPF:
  
  

   <Project Sdk="Microsoft.NET.Sdk.WindowsDesktop"> <PropertyGroup> <OutputType>WinExe</OutputType> <TargetFramework>net472</TargetFramework> <UseWPF>true</UseWPF> <GenerateAssemblyInfo>false</GenerateAssemblyInfo> </PropertyGroup> </Project> 

• No bloco de notas, procure PackageReference . Se você não encontrou nada, siga em frente. Se você encontrou PackageReference , copie todo o <ItemGroup> que contém PackageReference no seu arquivo de projeto, aberto no Visual Studio, logo abaixo das linhas que você colou na etapa acima. Faça isso para cada ocorrência do PackageReference você encontrou. O bloco copiado deve ficar assim.
  
  

   <ItemGroup> <PackageReference Include="NUnit"> <Version>3.11.0</Version> </PackageReference> </ItemGroup> 

• Agora faça o mesmo acima para ProjectReference . Se você não encontrou nada, siga em frente. Se você encontrou algum item do ProjectReference , eles se pareceriam com isso.
  
  

   <ItemGroup> <ProjectReference Include="..\WindowsFormsApp1\WindowsFormsApp1.csproj"> <Project>{7bce0d50-17fe-4fda-b6b7-e7960aed8ac2}</Project> <Name>WindowsFormsApp1</Name> </ProjectReference> </ItemGroup> 

• Você pode remover linhas com as propriedades <Project> e <Name> , pois elas não são necessárias no novo estilo de arquivo do projeto. Portanto, para cada ProjectReference que você encontrou (se houver), copie apenas ItemGroup e ProjectReference como este.
  
  

   <ItemGroup> <ProjectReference Include="..\WindowsFormsApp1\WindowsFormsApp1.csproj" /> </ItemGroup> 

  
  Salve tudo. Feche o arquivo .csproj no Visual Studio. Clique com o botão direito do mouse no seu projeto no Solution Explorer e selecione Recarregar Projeto . Reconstrua e verifique se não há erros.
  

  Boas notícias, você acabou de atualizar seu arquivo de projeto para o novo estilo SDK! O projeto ainda está direcionado ao .NET Framework, mas agora você poderá redirecioná-lo para o .NET Core.

  
  

  Etapa 3 - redirecionar para o .NET Core

  
  

  Abra o arquivo do seu projeto clicando duas vezes no seu projeto no Solution Explorer . Localize a propriedade <TargetFramework> e altere o valor para netcoreapp3.0 . Agora o seu arquivo de projeto deve ficar assim:

  
  

   <Project Sdk="Microsoft.NET.Sdk.WindowsDesktop"> <PropertyGroup> <OutputType>WinExe</OutputType> <TargetFramework>netcoreapp3.0</TargetFramework> ... </PropertyGroup> ... </Project> 

  
  

  Crie e execute seu projeto. Parabéns, você portou para o .NET Core 3!

  
  

  Corrigindo erros

  
  

  Se você receber erros como

  
  

   The type or namespace <some name> could not be found 

  
  

  ou

  
  

   The name <some name> does not exist in the current context 

  
  

  e seu relatório de portabilidade estiver verde, será fácil corrigi-lo adicionando um pacote NuGet à biblioteca correspondente. Se você não conseguir encontrar o pacote NuGet com a biblioteca que está faltando, tente fazer referência a Microsoft.Windows.Compatibility . Este pacote adiciona ~ 21K APIs .NET do .NET Framework.

  
  

  Trabalhando com designers

  
  

  Embora seja possível editar a interface do usuário do seu aplicativo via código, os desenvolvedores geralmente preferem usar os designers visuais. Com o .NET Core, tivemos que re-projetar a maneira como os designers trabalham com projetos do .NET Core:

  
  
  • O designer do WPF já está em visualização e estamos trabalhando para adicionar mais funcionalidades a ele.
  • O designer do WinForms para .NET Core estará disponível posteriormente e, enquanto isso, você poderá usar o designer do .NET Framework WinForms como uma solução alternativa.
  
  

  Aqui está como você pode usar o designer do .NET Framework WinForms:

  
  
  1. Copie o arquivo .csproj (digamos que você tenha o MyProject.csproj ), atribua um nome diferente, por exemplo, MyProject.NetFramework.csproj e coloque-o ao lado do arquivo de projeto existente.
  2. Verifique se o seu projeto está fechado no Visual Studio, abra o novo projeto MyProject.NetFramework.csproj .
     No Gerenciador de Soluções , clique com o botão direito do mouse em seu projeto e selecione Propriedades . Na guia Aplicativo (deve estar aberto por padrão), defina o nome do Assembly e o namespace padrão com os mesmos valores do seu projeto inicial (remova “.NetFramework” dos nomes).
     Salve esta solução ao lado da sua solução existente.
  3. Abra o novo arquivo de projeto e altere o <TargetFramework> para net472 .
  4. Agora, quando você precisar usar o designer WinForms, carregue seu projeto com o arquivo de projeto MyProject.NetFramework.csproj e obterá a experiência completa do designer do .NET Framework. Quando terminar o designer, feche e abra seu projeto com o arquivo de projeto do .NET Core.
  5. Esta é apenas uma solução alternativa até que o designer do WinForms para .NET Core esteja pronto.
  
  

  Por que porta para o .NET Core

  
  

  Confira o vídeo em que Scott Hunter e eu estamos conversando sobre todas as novidades que vêm com o .NET Core 3 Porting para o .NET Core 3.0 .