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 UWP e aplicativos para desktop. 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.

De uma forma geral, estas são as etapas para migrar manualmente (mas consulte a próxima seção para obter informações sobre como usar a ferramenta Assistente de Atualização do .NET):

1. Crie um novo projeto de desktop em pacote da WinUI 3 (see Crie seu primeiro projeto na 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 na tabela abaixo. Eles descrevem e demonstram como migrar manualmente seu aplicativo da Plataforma Universal do Windows (UWP) para o SDK do Aplicativo Windows.

Observe especialmente O que é compatível 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 com a ferramenta Assistente de Atualização do .NET

Como mais uma etapa para ajudar você a migrar seus aplicativos UWP para o SDK do Aplicativo Windows e a WinUI 3, atualizamos o Assistente de Atualização do .NET, adicionando suporte para a migração de aplicativos UWP em C#. O suporte para a UWP automatiza grande parte do processo de migração. Para obter mais informações, consulte o tópico Migrar da UWP para o SDK de Aplicativos do Windows com o Assistente de Atualização do .NET.

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.
Mapeamento de recursos da UWP para o SDK do aplicativo Windows	Este tópico compara as principais áreas de recursos nos diferentes formatos em que aparecem na UWP e no SDK do Aplicativo Windows.
Para que há suporte?	Saiba quais recursos estão disponíveis no Desktop WinUI 3 para avaliar se você deve tentar migrar seu aplicativo UWP.
Mapeamento das APIs e bibliotecas da UWP para o SDK do aplicativo Windows	Este tópico fornece um mapeamento de APIs e bibliotecas da UWP para seus equivalentes do SDK do Aplicativo Windows.
Guias da área de recursos	Um conjunto 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 de como usar o aplicativo UWP de exemplo PhotoLab 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 de como usar o aplicativo UWP de exemplo Photo Editor em C++/WinRT e migrá-lo para o SDK do Aplicativo Windows.
Diretrizes de migração adicionais	Este tópico contém orientações de migração adicionais não categorizadas em uma área de recursos nos guias de áreas de recursos.
Migrar da UWP para o SDK de Aplicativos do 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.