Partilhar via

Migrar do UWP para o SDK de Aplicações Windows

Para migrar a tua aplicação do Plataforma Universal do Windows (UWP) para o SDK de Aplicações Windows, o código da interface provavelmente precisa de apenas algumas alterações no espaço de nomes, enquanto grande parte do código da plataforma pode manter-se igual. Você precisará ajustar algum código devido às diferenças entre aplicativos UWP e aplicativos de desktop. Mas esperamos que, para a maioria das aplicações (dependendo do tamanho da base de código, é claro), a migração demore alguns dias em vez de semanas.

Observação

Seu aplicativo UWP existente continuará a funcionar conforme o esperado. No entanto, para tirar partido das funcionalidades modernas do WinUI 3 e do SDK de Aplicações Windows recomendamos a migração da sua aplicação.

Abaixo estão as etapas, de forma geral, para migrar manualmente. Mas veja a secção seguinte para informações sobre o uso da ferramenta .NET Upgrade Assistant).

  1. Crie um novo projeto WinUI empacotado de ambiente de trabalho (veja Crie o seu primeiro projeto WinUI). Isso pode fazer parte da solução existente do seu projecto.
  2. Copie seu código XAML/UI. Em muitos casos pode simplesmente mudar os namespaces (por exemplo, Windows. UI.* para Microsoft. UI.*).
  3. Copie o código lógico do aplicativo. Algumas APIs precisam de ajustes, como Popup, Pickers e SecondaryTile.

Para obter detalhes completos, consulte os tópicos na tabela abaixo. Eles descrevem e demonstram como migrar manualmente a sua aplicação Plataforma Universal do Windows (UWP) para o SDK de Aplicações Windows.

Preste especial atenção ao O que é suportado ao migrar do UWP para o WinUI, que descreve qualquer funcionalidade que ainda não seja suportada no WinUI e no SDK de Aplicações Windows. Se o seu aplicativo precisar de algum desses recursos/bibliotecas, considere adiar a migração.

Observação

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

Migração usando a ferramenta .NET Upgrade Assistant

Como um passo adicional para o ajudar a migrar as suas aplicações UWP para o SDK de Aplicações Windows e WinUI, aproveitámos o .NET Upgrade Assistant, adicionando suporte para migração de aplicações UWP em C#. O suporte UWP automatiza grande parte do processo de migração. Para mais informações, consulte o tópico Migrar do UWP para o SDK de Aplicações Windows com o .NET Upgrade Assistant.

Benefícios da conteinerização

Ao fazer a transição para o SDK de Aplicações Windows, as aplicações UWP podem perder os benefícios inerentes à containerização da sua plataforma original. No entanto, esses benefícios podem ser restaurados usando o Win32 App Isolation — 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 ameaças potenciais com alterações mínimas no código existente. Para obter mais informações e começar a usar o Isolamento de aplicativo Win32, consulte Visão geral do isolamento de aplicativo Win32.

Tópicos nesta seção

Tópico Descrição
Estratégia global de migração Considerações e estratégias para abordar o processo de migração e como configurar seu ambiente de desenvolvimento para migração.
Mapear características UWP para o SDK de Aplicações Windows Este tópico compara as principais áreas de funcionalidades nas diferentes formas em que aparecem no UWP e no SDK de Aplicações Windows.
O que é suportado Saiba quais as funcionalidades atualmente disponíveis no WinUI Desktop para avaliar se deve tentar migrar a sua aplicação UWP hoje.
Mapear APIs e bibliotecas UWP para SDK de Aplicações Windows Este tópico fornece um mapeamento das APIs e bibliotecas UWP para os seus equivalentes ao SDK de Aplicações Windows.
Guias de Áreas de Funcionalidades Uma coleção de tópicos de orientação de migração, cada um com foco em uma área funcional específica.
Estudo de caso 1—PhotoLab (C#) Este tópico é um estudo de caso sobre como utilizar a aplicação de exemplo C# UWP PhotoLab e proceder à sua migração para o SDK de Aplicações Windows.
Estudo de caso 2 — Editor de fotos (C++/WinRT) Este tópico é um estudo de caso sobre a migração da aplicação de exemplo C++/WinRT UWP Photo Editor, para a SDK de Aplicações Windows.
Orientações adicionais em matéria de migração Este tópico contém orientações adicionais de migração que não estão categorizadas numa área de funcionalidades nos guias de áreas de funcionalidades.
Migre do UWP para o SDK de Aplicações Windows com o .NET Upgrade Assistant O Assistente de Atualização .NET é uma ferramenta de linha de comandos que pode ajudar a migrar uma aplicação C# UWP para uma aplicação WinUI que utiliza a SDK de Aplicações Windows.
Use IA para ajudar a modernizar a sua aplicação Como usar o GitHub Copilot para acelerar a modernização de uma aplicação de ambiente de trabalho existente para o SDK de Aplicações Windows e WinUI 3.

Ver também

  • Last updated on