Migración de UWP al SDK de Aplicaciones para Windows

  • Artículo

Para migrar la aplicación de la Plataforma universal de Windows (UWP) a la SDK de Aplicaciones para Windows, es probable que el código de la interfaz de usuario necesite solo unos pocos cambios de espacio de nombres, mientras que gran parte del código de la plataforma puede permanecer igual. Tendrá que ajustar parte del código debido a las diferencias entre las aplicaciones UWP y las aplicaciones de escritorio. Pero esperamos que para la mayoría de las aplicaciones (según el tamaño del código base, por supuesto), la migración tardará días, no semanas.

Nota:

La aplicación para UWP existente seguirá funcionando según lo previsto. Sin embargo, para aprovechar las características modernas de WinUI 3 y Windows SDK , se recomienda migrar la aplicación.

A continuación se muestran los pasos, en un nivel alto, para migrar manualmente. Pero consulte la sección siguiente para obtener información sobre el uso de la herramienta Asistente para actualización de .NET).

  1. Cree un nuevo proyecto de escritorio empaquetado WinUI 3 (consulte Crear su primer proyecto WinUI 3). Esto podría entrar en la solución existente del proyecto.
  2. Copie el código de XAML/UI. En muchos casos, simplemente puede cambiar los espacios de nombres (por ejemplo, Windows.UI.* a Microsoft.UI.*).
  3. Copie el código lógico de la aplicación. Algunas API necesitan ajustes, como Popup, Picker y SecondaryTile.

Para más detalles, consulte los temas de la siguiente tabla. Describen y muestran cómo migrar manualmente la aplicación de Plataforma universal de Windows (UWP) al SDK de Aplicaciones para Windows.

Ten en cuenta Qué se admite al migrar de UWP a WinUI 3, donde se describe cualquier funcionalidad que aún no se admita en WinUI 3 y el SDK de Aplicaciones para Windows. Si la aplicación necesita alguna de esas características o bibliotecas, es posible que quiera considerar la posibilidad de posponer la migración.

Nota:

Si el código fuente de la aplicación para UWP está escrito en C++/CX, consulta Mover a C++/WinRT desde C++/CX.

Migración mediante la herramienta Asistente para actualización de .NET

Como paso adicional para ayudarle a migrar sus aplicaciones para UWP al SDK de Aplicaciones para Windows y WinUI 3, hemos aprovechado el Asistente para actualización de .NET, agregando compatibilidad para migrar aplicaciones para UWP de C#. La compatibilidad con UWP automatiza gran parte del proceso de migración. Para obtener más información, consulte el tema Migrar de UWP al SDK de aplicaciones de Windows con el Asistente de actualización de .NET.

Ventajas de la contenedorización

Al realizar la transición a la SDK de Aplicaciones para Windows, las aplicaciones para UWP podrían perder las ventajas inherentes de la contenedorización de su plataforma original. Sin embargo, esas ventajas se pueden restaurar mediante el aislamiento de aplicaciones Win32, una nueva característica de seguridad que mejora la protección al aislar las aplicaciones dentro de un entorno de espacio aislado. Este enfoque ofrece seguridad adicional frente a posibles amenazas con cambios mínimos en el código existente. Para obtener más información y empezar a usar el aislamiento de aplicaciones Win32, visite Bienvenido al repositorio de aislamiento de aplicaciones Win32 en GitHub.

Temas de esta sección

Tema Descripción
Estrategia de migración general Consideraciones y estrategias para abordar el proceso de migración y cómo configurar el entorno de desarrollo para la migración.
Asignación de características de UWP del SDK de Aplicaciones para Windows En este tema se comparan las principales áreas de características de los diferentes formularios en los que aparecen en UWP y en el SDK de Aplicaciones para Windows.
Elementos compatibles Obtenga información sobre qué características están disponibles actualmente en el escritorio de WinUI 3 para evaluar si debe intentar migrar su aplicación para UWP hoy mismo.
Asignación de API de UWP al SDK de Aplicaciones para Windows En este tema se proporciona una asignación de las API y bibliotecas de UWP a sus equivalentes de SDK de Aplicaciones para Windows.
Guías del área de características Una colección de temas de guía de migración, cada uno de ellos centrado en un área de características específica.
Caso práctico 1: PhotoLab (C#) Este tema es un caso práctico en el que se toma la aplicación de ejemplo de PhotoLab para UWP en C# y se migra al SDK de Aplicaciones para Windows.
Caso práctico 2: Photo Editor (C++/WinRT) Este tema es un caso práctico en el que se toma la aplicación de ejemplo de Editor de fotos para UWP en C++/WinRT y se migra al SDK de Aplicaciones para Windows.
Guía de migración adicional Este tema contiene instrucciones de migración adicionales que no se clasifican en un área de características en las guías de área de características.
Migración de UWP al SDK de Aplicaciones de Windows con el Asistente para actualización de .NET El Asistente para actualización de .NET es una herramienta de la línea de comandos que ayuda a migrar una aplicación de la UWP en C# a una aplicación de WinUI 3, que usa la SDK de Aplicaciones para Windows.

Consulte también