Migrar da UWP para o SDK do Aplicativo Windows

  • Artigo

Para migrar seu aplicativo da Plataforma Universal do Windows (UWP) para o SDK do Aplicativo Windows, seu código de interface do usuário provavelmente precisa de apenas algumas alterações de namespace, enquanto grande parte do código da plataforma pode permanecer o mesmo. 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.

Observação

Seu aplicativo UWP existente continuará funcionando conforme o esperado. No entanto, para aproveitar os recursos modernos do WinUI 3 e do SDK do Windows , recomendamos migrar seu aplicativo.

Abaixo estão as etapas, em alto nível, para migrar manualmente. Mas consulte a seção a seguir 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 na solução existente do seu projeto.
  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.

Tenha atenção especial às informações em O que é compatível ao migrar da UWP para a WinUI 3, que descreve qualquer funcionalidade que ainda não tem suporte no WinUI 3 e no SDK de Aplicativo do Windows. Se o aplicativo precisar de algum desses recursos/bibliotecas, considere adiar a migração.

Observação

Se o código-fonte do aplicativo UWP for escrito em C++/CX, consulte também Mover para C++/WinRT do C++/CX.

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.

Benefícios da conteinerização

Ao fazer a transição para o SDK do Aplicativo Windows, os aplicativos UWP podem perder os benefícios inerentes à conteinerização de sua plataforma original. No entanto, esses benefícios podem ser restaurados usando o Isolamento de Aplicativos Win32, um novo recurso de segurança que aprimora a proteção isolando aplicativos em um ambiente de área restrita. Essa abordagem oferece segurança adicional contra possíveis ameaças com alterações mínimas no código existente. Para obter mais informações e começar a usar o Isolamento de Aplicativo Win32, visite Bem-vindo ao repositório de isolamento de aplicativo Win32 no GitHub.

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 3 que usa o SDK de Aplicativo do Windows.

Confira também