Migrar da UWP para o SDK do Aplicativo Windows

Se você estiver satisfeito com sua funcionalidade atual na UWP (Plataforma Universal do Windows), não será necessário migrar seu tipo de projeto. A WinUI 2.x e o SDK do Windows dão suporte a tipos de projeto UWP.

Porém, se você decidiu migrar seu aplicativo da UWP para o SDK do Aplicativo Windows, na maioria dos casos, o código da interface do usuário precisará apenas de algumas alterações de namespace. Grande parte do código da plataforma pode permanecer como está. Você precisará ajustar algum código devido a diferenças entre aplicativos da área de trabalho e aplicativos UWP. Porém, esperamos que, para a maioria dos aplicativos (dependendo do tamanho da base de código, é claro), a migração ocorra em dias, não em semanas. Em um alto nível, estas são as etapas:

1. Crie um projeto de área de trabalho empacotado do WinUI 3 (consulte Criar seu primeiro projeto winUI 3). Isso pode entrar em sua solução.
2. Copie seu código de XAML/interface do usuário. Em muitos casos, você pode simplesmente alterar namespaces (por exemplo, de Windows.UI.* para Microsoft.UI.*).
3. Copie o código de lógica do aplicativo. Algumas APIs precisam de ajustes, como Popup, Pickers e SecondaryTiles.

Para obter detalhes completos, consulte os tópicos abaixo. Eles descrevem e demonstram como migrar seu aplicativo UWP (Plataforma Universal do Windows) para o SDK do Aplicativo Windows.

Anote especialmente o que tem suporte ao migrar da UWP para a WinUI 3. Esse tópico descreve qualquer funcionalidade que ainda não tenha suporte na WinUI 3 e no SDK do Aplicativo Windows. Se o aplicativo precisar de algum desses recursos/bibliotecas, considere aguardar para migrar.

Migrando usando a ferramenta Assistente de Atualização do .NET

Como próxima etapa para ajudá-lo a migrar seus aplicativos de Plataforma Universal do Windows (UWP) para o SDK do Aplicativo Windows e o WinUI 3, aproveitamos o Assistente de Atualização do .NET, adicionando suporte para migrar aplicativos UWP em C#. O suporte à UWP automatiza grande parte do processo de migração. Uma versão prévia já está disponível— para obter mais informações, consulte Migrar da UWP para o SDK do Aplicativo Windows com o Assistente de Atualização do .NET.

Nosso roteiro para suporte à UWP no Assistente de Atualização do .NET inclui aprimoramentos adicionais de ferramentas e adição de suporte à migração para novos recursos.

O repositório GitHub do Assistente de Atualização documenta dicas de solução de problemas conhecidos e dicas de solução de problemas conhecidos. Se você encontrar problemas ao usar a ferramenta, relate-os no mesmo repositório github, marcando-os com uma marca de área de UWP. Agradecemos!

Tópicos desta seção

Tópico	Descrição
Estratégia de migração geral	Considerações e estratégias para abordar o processo de migração e como configurar seu ambiente de desenvolvimento para migração.
Mapeando recursos UWP para o SDK do Aplicativo Windows	Este tópico compara as principais áreas de recursos das diferentes formas em que elas aparecem na UWP e no SDK do Aplicativo Windows.
O que tem suporte	Saiba quais recursos estão disponíveis atualmente no WinUI 3 Desktop para avaliar se você deve tentar migrar seu aplicativo UWP hoje mesmo.
Mapeamento de APIs e bibliotecas UWP para SDK do Aplicativo Windows	Este tópico fornece um mapeamento de APIs e bibliotecas UWP para seus equivalentes SDK do Aplicativo Windows.
Guias da área de recursos	Uma coleção de tópicos de diretrizes de migração, cada um com foco em uma área de recurso específica.
Estudo de caso 1 – PhotoLab (C#)	Este tópico é um estudo de caso sobre como usar o aplicativo de exemplo PhotoLab UWP em C# e migrá-lo para o SDK do Aplicativo Windows.
Estudo de caso 2 – Editor de fotos (C++/WinRT)	Este tópico é um estudo de caso sobre como usar o aplicativo de exemplo editor de fotos UWP do C++/WinRT e migrá-lo para o SDK do Aplicativo Windows.
Diretrizes de migração adicionais	Este tópico contém diretrizes adicionais de migração não categorizadas em uma área de recurso nos guias da área de recursos.
Migrar da UWP para o SDK do Aplicativo Windows com o Assistente de Atualização do .NET	O Assistente de Atualização do .NET é uma ferramenta de linha de comando que pode ajudar na migração de um aplicativo UWP em C# para um aplicativo WinUI (Biblioteca de Interface do Usuário do Windows) 3 que usa o SDK do Aplicativo Windows.