Migración de UWP al SDK de Aplicaciones para Windows

Para migrar la aplicación de UWP al 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.

Nota:

No es necesario migrar el proyecto si la funcionalidad que actualmente admite la Plataforma universal de Windows (UWP) es suficiente, ya que Biblioteca de interfaz de usuario de Windows (WinUI) 2 y el SDK de Windows, admiten tipos de proyecto para UWP.

Aunque es posible que tenga que ajustar código debido a las diferencias entre las aplicaciones de escritorio y las aplicaciones para UWP, la migración de la mayoría de las aplicaciones requiere unos pocos pasos.

1. Cree el primer proyecto de escritorio proyecto empaquetado de proyecto de WinUI 3 (SDK de Aplicaciones para Windows) (podría ir a la solución existente de la aplicación).
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.

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, puede plantearse posponer la migración.

Nota:

Si el código fuente de UWP está escrito en C++/CX, tendrá que portar ese código (consulte Migración 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.

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.