Compartilhar via

Migrar da UWP para o SDK do Aplicativo Windows

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

Abaixo estão, de forma geral, as etapas para migrar manualmente. Mas consulte a seção a seguir para obter informações sobre como usar a ferramenta .NET Upgrade Assistant).

  1. Crie um novo projeto de desktop empacotado do WinUI (consulte Criar seu primeiro projeto WinUI). Isso pode ser incorporado à solução existente do seu projeto.
  2. Copie seu código XAML/IU. Em muitos casos, você pode simplesmente alterar namespaces (por exemplo, Windows. UI.* para Microsoft. Interface do usuário.*).
  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 Plataforma Universal do Windows (UWP) para o SDK do Aplicativo Windows.

Anote O que tem suporte ao migrar da UWP para o WinUI, que descreve qualquer funcionalidade que ainda não tenha suporte no WinUI e no SDK do Aplicativo 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, também consulte Mover para C++/WinRT do C++/CX.

Migrando usando a ferramenta assistente de atualização do .NET

Como mais uma etapa para ajudá-lo a migrar seus aplicativos UWP para o SDK do Aplicativo Windows e WinUI, aproveitamos o assistente de atualização .NET, adicionando suporte para migrar 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 Migrate da UWP para o SDK do Aplicativo Windows com o Assistente de Atualização .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 à contêinerizaçã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 Aplicativos Win32, consulte a visão geral do isolamento do aplicativo Win32.

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 UWP com o SDK do Aplicativo Windows Este tópico compara as principais áreas de recursos nas diferentes formas em que elas aparecem na UWP e no SDK do Aplicativo Windows.
Para que há suporte? Saiba quais recursos estão disponíveis atualmente no WinUI Desktop para avaliar se você deve tentar migrar seu aplicativo UWP hoje.
Mapeando APIs e bibliotecas para o SDK do Aplicativo Windows Este tópico fornece um mapeamento de APIs e bibliotecas UWP para seus equivalentes no 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 funcionalidade específica.
Estudo de caso 1 – PhotoLab (C#) Este tópico é um estudo de caso de uso do aplicativo de exemplo C# UWP PhotoLab e migração 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 C++/WinRT UWP Photo Editor e migrá-lo para o SDK do Aplicativo Windows.
Diretrizes de migração adicionais Este tópico contém diretrizes adicionais de migração que não estão categorizadas em guias de área de recurso.
Migrar da UWP para SDK do Aplicativo Windows com o Assistente de Atualização .NET O .NET Upgrade Assistant é uma ferramenta de linha de comando que pode ajudar na migração de um aplicativo UWP do C# para um aplicativo WinUI que usa o SDK do Aplicativo Windows.
Usar a IA para ajudar a modernizar seu aplicativo Como usar GitHub Copilot para acelerar a modernização de um aplicativo da área de trabalho existente para SDK do Aplicativo Windows e WinUI 3.

Confira também

  • Last updated on