Informações sobre a migração da UWP para o SDK do Aplicativo Windows

  • Artigo

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 seu primeiro projeto na WinUI 3, projeto de área de trabalho empacotado. 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.

Observação

Se o código-fonte da UWP for escrito no C++/CX agora substituído, algumas portas de código-fonte estarão envolvidas. Confira Migrar do C++/CX para o C++/WinRT.

Para todos os detalhes, confira Migrar da UWP para o SDK do Aplicativo Windows. Essa documentação de migração aborda como migrar entre quaisquer diferenças.

Dentro desse conteúdo, 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.