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 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.

En un nivel alto, estos son los pasos 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.
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.

Preste especial atención a Qué 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 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.

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 la biblioteca de interfaz de usuario de Windows (WinUI) 3, que usa la SDK de Aplicaciones para Windows.