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 la SDK de Aplicaciones para Windows 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).
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.
Copie el código de XAML/UI. En muchos casos, simplemente puede cambiar los espacios de nombres (por ejemplo, Windows.UI.* a Microsoft.UI.*).
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.
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.
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.
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.
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.
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.
El origen de este contenido se puede encontrar en GitHub, donde también puede crear y revisar problemas y solicitudes de incorporación de cambios. Para más información, consulte nuestra guía para colaboradores.
Comentarios de Windows developer
Windows developer es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios:
En este módulo, aprenderá cuándo, por qué y cómo modernizar una aplicación de ASP.NET Framework a ASP.NET Core utilizando el Asistente para actualización.
Obtenga información sobre Windows App SDK, las ventajas que proporciona a los desarrolladores, qué está listo para los desarrolladores y cómo enviar comentarios.
WinUI 3 y el SDK de aplicaciones para Windows son nuevas tecnologías y, en comparación con UWP, hay algunas características que no se admiten. En este tema se proporciona información sobre qué características se admiten antes de intentar la migración.
Un caso práctico de tomar la aplicación de ejemplo de PhotoLab de C# [UWP PhotoLab](/samples/microsoft/windows-appsample-photo-lab/photolab-sample/) y migrarla al SDK de Aplicaciones para Windows.