Modernización o portabilidad de una aplicación de Windows con GitHub Copilot

Si tienes una aplicación de Windows existente , un proyecto para UWP, una aplicación de escritorio de WPF o WinForms, o una aplicación de Electron o Flutter multiplataforma, GitHub Copilot puede acelerar significativamente el proceso de actualización para Windows modernos. En este artículo se muestran los escenarios clave y las herramientas que las hacen prácticas.

Antes de comenzar

Asegúrese de que tiene configuradas las herramientas clave:

  • GitHub Copilot con el complemento de desarrollo WinUI 3: controla la guía de migración de API y genera código moderno correcto.
  • Microsoft Learn MCP Server le proporciona a Copilot acceso a la documentación actual de SDK de Aplicaciones para Windows.
  • winapp CLI: agrega la identidad del paquete y el empaquetado de Windows a cualquier marco

Si aún no lo ha configurado, comience con Set up GitHub Copilot for Windows development.

Migración de una aplicación para UWP a WinUI 3

WinUI 3 es el sucesor moderno de la capa de interfaz de usuario de UWP. Las API son similares pero no idénticas: los espacios de nombres se han movido, algunos controles han cambiado y el modelo de aplicación es diferente. La aptitud de guía de migración de WinUI 3 hace que este proceso sea manejable.

Ejecute la guía de migración

En Copilot Chat, ejecute la habilidad de guía de migración.

/winui3-development:winui3-migration-guide

Esto genera un plan de migración estructurado adaptado al proyecto, entre los que se incluyen:

  • Lista de comprobación de los cambios de archivo y manifiesto del proyecto
  • Tabla de asignaciones de espacios de nombres de API (por ejemplo, Windows.UI.Xaml → Microsoft.UI.Xaml)
  • Sustituciones de control comunes y ejemplos de código antes y después
  • Diferencias de empaquetado e implementación

Migración de un archivo

Abra un archivo de código fuente de UWP y pida a Copilot migrarlo:

"Migre este archivo de UWP a WinUI 3. Reemplace todas las API de UWP en desuso por sus equivalentes de WinUI 3. Marcar cualquier cosa que necesite revisión manual."

La guía de instrucciones personalizadas del complemento WinUI 3 orienta a Copilot para hacer sustituciones correctas. Entre los comunes se incluyen:

Plataforma Universal de Windows (UWP) WinUI 3
Windows.UI.Xaml.* Microsoft.UI.Xaml.*
CoreDispatcher / RunAsync DispatcherQueue / TryEnqueue
MessageDialog ContentDialog (con XamlRoot)
Windows.UI.Popups Microsoft.UI.Xaml.Controls
BackgroundTaskBuilder API de tareas en segundo plano de SDK de Aplicaciones para Windows

Qué Copilot puede y no puede hacer automáticamente

Copilot controla la mayoría de las reasignaciones de espacios de nombres y las sustituciones de API sencillas. Hay áreas que necesitan revisión humana:

  • App model changes: eventos de ciclo de vida de UWP (Suspending, Resuming) no se asignan directamente a WinUI 3; Copilot puede sugerir alternativas, pero tendrá que comprobar el comportamiento.
  • Diccionarios de recursos XAML : es posible que los recursos de tema y los estilos personalizados necesiten ajustes manuales.
  • Tareas en segundo plano : el modelo de empaquetado es diferente; usar la CLI de winapp para configurar las nuevas entradas del manifiesto

Modernización de una aplicación de WPF o WinForms

¿Debería actualizar in situ o reconstruir con WinUI 3?

Antes de empezar, vale la pena decidir qué dirección tiene sentido para la aplicación. Hay algunos caminos distintos con diferentes herramientas y alcance.

Su situación Ruta de acceso recomendada
Mantenga WPF o WinForms como marco de interfaz de usuario, vaya a .NET 9+ Actualización in situ: use el agente de modernización de GitHub Copilot para .NET para automatizar los cambios de archivo y código del proyecto.
Incorporación de características modernas de Windows (notificaciones, inteligencia artificial, integración de shell) a la aplicación existente sin cambiar el marco de interfaz de usuario Agregar características de SDK de Aplicaciones para Windows; consulte los escenarios siguientes; use la CLI de Winapp para agregar la identidad del paquete si es necesario.
Necesita una interfaz de usuario moderna de Fluent, compatibilidad táctil, profundidad de WinRT o un código base nuevo Reconstruir con WinUI 3 — consulta los patrones de WPF en WinUI 3 para el mapeo de API; para un enfoque asistido por Copilot, consulta Migrar una aplicación UWP a WinUI 3 (específica de UWP, pero el flujo de trabajo con Copilot es similar).
Aplicación LOB con controles de INTERFAZ de usuario de WCF, COM o de terceros pesados Actualice primero, y luego modernice de manera incremental — el agente de modernización de GitHub Copilot para .NET puede ayudar con las actualizaciones de WCF → CoreWCF, EF y ASP.NET Core

Nota:

"Actualizar" (pasar a una versión más reciente de .NET en el mismo marco de interfaz de usuario) y "recompilar" (pasar a WinUI 3) son decisiones independientes. Ahora puede actualizar y recompilar más adelante, o hacer ambas cosas juntas para un reemplazo desde cero. La modernización de GitHub Copilot para .NET abarca la ruta de actualización; en las siguientes secciones se explica cómo agregar funcionalidades del SDK de aplicaciones de Windows a tu aplicación existente.

WPF y aplicaciones winForms pueden adoptar características de SDK de Aplicaciones para Windows sin necesidad de reescritura completa. Copilot + el servidor MCP de Learn facilita la búsqueda e integración de características específicas.

Adición de notificaciones push

"Tengo una aplicación WPF destinada a .NET 8. Mostrarme cómo agregar Windows notificaciones push mediante el SDK de Aplicaciones para Windows. La aplicación no está empaquetada actualmente".

Con learn MCP Server, Copilot captura la documentación de notificación de SDK de Aplicaciones para Windows actual y genera código de integración. La compatibilidad básica con notificaciones push funciona para aplicaciones desempaquetadas. Sin embargo, si la aplicación necesita recibir notificaciones push mientras no está en funcionamiento, en el escenario de producción más habitual, la activación COM y la entrega en segundo plano requieren tener la identidad del paquete. Copilot puede guiarle para añadir un paquete con la CLI de winapp si es necesario.

Modernización del aspecto y la apariencia de la aplicación

Mi aplicación WPF se ve anticuada. Haz que parezca moderno con una opción de modo oscuro y una barra lateral de navegación como las aplicaciones modernas de Windows usan".

Adición de un selector de archivos mediante SDK de Aplicaciones para Windows

"Reemplace el uso de OpenFileDialog de WPF por StorageFilePicker de SDK de Aplicaciones para Windows para mejorar la experiencia moderna en Windows."

Adición de notificaciones de Windows

"Agregue una notificación que indique al usuario cuándo se completa una tarea en segundo plano".

Copilot proporcionará el código de notificación SDK de Aplicaciones para Windows. Las notificaciones de aplicación funcionan tanto en aplicaciones empaquetadas como sin empaquetar ; no se requiere ninguna identidad de paquete.

Pide a Copilot que te lo explique paso a paso.

"Quiero que mi aplicación muestre una notificación del sistema Windows. Explique lo que necesito configurar primero".

Incorporación de características de Windows a una aplicación multiplataforma

Las aplicaciones Electron, Flutter, React Native y Rust pueden convertirse en ciudadanos de primera clase Windows con winapp CLI. Copilot le ayuda a adaptar el código para las API de Windows una vez que tenga la identidad del paquete.

Electrón

npm install @microsoft/winappcli --save-dev
npx winapp init
npx winapp node create-addon --feature notifications

Una vez que el complemento esté esquematizado, pida a Copilot que lo integre.

"He creado un complemento de notificaciones de Windows para mi aplicación Electron utilizando winapp CLI." Muéstrame cómo enviar una notificación desde el proceso principal cuando se complete una descarga".

Para ver un tutorial completo, consulte la guía de configuración de Electron.

Flutter

winapp init

"Tengo una aplicación flutter para Windows. Mostrarme cómo usar el SDK de Aplicaciones para Windows para agregar un icono de bandeja del sistema con un menú contextual".

Consulte la guía Flutter para la configuración específica de Windows.

WPF/.NET

"Tengo una aplicación WPF. Guíame a través del uso de la interfaz de línea de comandos de Winapp para agregar el empaquetado MSIX y luego agregar una funcionalidad de IA en el dispositivo utilizando las APIs de IA de Windows.

Consulte la guía .NET.

Lo que se desbloquea mediante la identidad del paquete

Muchas características de Windows eficaces requieren package identity , que la CLI de Winapp puede agregar a cualquier marco. Una vez que lo tenga, Copilot puede ayudarle a usar:

Feature Qué preguntar a Copilot
Notificaciones de aplicación "Agregar una notificación de Windows cuando se complete mi trabajo en segundo plano"
IA en el dispositivo (PhiLice, reconocimiento de texto) "Añadir resumen de texto de IA local utilizando las APIs de IA de Windows"
Integración del shell de Windows (hoja para compartir, barra de tareas) "Agregar un objetivo para compartir para que los usuarios puedan compartir en mi aplicación desde el Explorador de archivos"
Tareas en segundo plano "Ejecutar una tarea en segundo plano cada hora incluso cuando se cierra mi aplicación"
Asociaciones de tipo de archivo "Registrar mi aplicación para abrir archivos .notes"

Pasos siguientes

  • Last updated on