Migración de UWP al SDK de Aplicaciones para Windows

Si está satisfecho con la funcionalidad actual de la Plataforma universal de Windows (UWP), no es necesario migrar el tipo de proyecto. WinUI 2.x y Windows SDK admiten tipos de proyecto para UWP.

No obstante, si ha decidido migrar la aplicación de UWP al SDK de Aplicaciones para Windows, en la mayoría de los casos, el código de la interfaz de usuario solo necesita unos pocos cambios en el espacio de nombres. Gran parte del código de la plataforma puede permanecer invariable. Tendrá que ajustar parte del código debido a las diferencias entre las aplicaciones de escritorio y las aplicaciones para UWP. 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. En general, los pasos son los siguientes:

  1. Cree un proyecto de escritorio empaquetado de WinUI 3 (consulte Creación del primer proyecto de WinUI 3). Esto podría entrar en la solución existente.
  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 obtener detalles completos, consulte los temas siguientes. Describen y muestran cómo migrar la aplicación de Plataforma universal de Windows (UWP) al SDK de Aplicaciones para Windows.

Tome nota de lo que se admite al migrar de UWP a WinUI 3. En este tema se describen las funcionalidades que aún no se admiten en WinUI 3 y el SDK de Aplicaciones para Windows. Si la aplicación necesita cualquiera de esas características o bibliotecas, considere la posibilidad de esperar para migrar.

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

Como siguiente paso para ayudarle a migrar las aplicaciones de Plataforma universal de Windows (UWP) a la SDK de Aplicaciones para Windows y WinUI 3, hemos aprovechado el Asistente para actualización de .NET, lo que agrega compatibilidad para migrar aplicaciones para UWP de C#. La compatibilidad con UWP automatiza gran parte del proceso de migración. Ahora hay disponible una versión preliminar: para obtener más información, consulta Migrar de UWP a la SDK de Aplicaciones para Windows con el Asistente para actualización de .NET.

Nuestra hoja de ruta para la compatibilidad con UWP en el Asistente para actualizaciones de .NET incluye mejoras adicionales en las herramientas y la adición de compatibilidad con la migración para nuevas características.

El repositorio de GitHub del Asistente para actualizaciones documenta sugerencias de solución de problemas y problemas conocidos. Si encuentra algún problema durante el uso de la herramienta, notifiquelos en ese mismo repositorio de GitHub, etiquetelos con una etiqueta de área de UWP. ¡Lo agradecemos!

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 a la SDK de Aplicaciones para Windows En este tema se comparan las áreas de características principales de los diferentes formularios en los que aparecen en UWP y en el SDK de Aplicaciones para Windows.
Lo que se admite Obtenga información sobre qué características están disponibles actualmente en El escritorio de WinUI 3 para evaluar si debe intentar migrar la aplicación para UWP hoy mismo.
Asignación de api y bibliotecas para UWP a SDK de Aplicaciones para Windows En este tema se proporciona una asignación de api y bibliotecas para 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 centrado en un área de características específica.
Caso práctico 1: PhotoLab (C#) Este tema es un caso práctico de tomar la aplicación de ejemplo PhotoLab para UWP de C# y migrarla a la SDK de Aplicaciones para Windows.
Caso práctico 2: Photo Editor (C++/WinRT) Este tema es un caso práctico de tomar la aplicación de ejemplo Editor de fotos para UWP de C++/WinRT y migrarla a la SDK de Aplicaciones para Windows.
Guía adicional de migración 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 a la SDK de Aplicaciones para Windows con el Asistente para actualización de .NET El Asistente para actualización de .NET es una herramienta de línea de comandos que puede ayudar a migrar una aplicación para UWP de C# a una aplicación de biblioteca de interfaz de usuario de Windows (WinUI) 3 que usa el SDK de Aplicaciones para Windows.