Inicio rápido: Actualización de un proyecto de Java con modernización de aplicaciones de GitHub Copilot

Las actualizaciones de Java de modernización de aplicaciones admiten los siguientes escenarios:

• Actualice el Kit de desarrollo de Java (JDK) a Java 8, 11, 17, 21 o 25.
• Actualice Spring Boot hasta la versión 3.5.
• Actualice Spring Framework hasta la versión 6.2 y posteriores.
• Actualice Java EE a Jakarta EE, hasta Jakarta EE 10.
• Actualice JUnit.
• Actualice las dependencias de terceros a una versión especificada.
• Actualice Ant a la compilación de Maven.

En este inicio rápido se muestra cómo actualizar un proyecto de Java mediante la modernización de aplicaciones de GitHub Copilot.

Prerrequisitos

• Una cuenta de GitHub con GitHub Copilot habilitado. Se requiere un plan gratuito, Pro, Pro+, Business o Enterprise.
• Uno de los siguientes IDEs:
  • Versión más reciente de Visual Studio Code. Debe ser la versión 1.101 o posterior.
    • GitHub Copilot en Visual Studio Code. Para obtener instrucciones de configuración, consulte Configuración de GitHub Copilot en Visual Studio Code. Asegúrese de iniciar sesión en su cuenta de GitHub en Visual Studio Code.
    • Modernización de aplicaciones de Copilot de GitHub. Reinicie Visual Studio Code después de la instalación.
  • La versión más reciente de IntelliJ IDEA. Debe ser la versión 2023.3 o posterior.
    • GitHub Copilot. Debe ser la versión 1.5.59 o posterior. Para obtener más instrucciones, consulte Configuración de GitHub Copilot en IntelliJ IDEA. Asegúrese de iniciar sesión en su cuenta de GitHub en IntelliJ IDEA.
    • Modernización de aplicaciones de Copilot de GitHub. Reinicie IntelliJ IDEA después de la instalación. Si no tiene instalado GitHub Copilot, puede instalar directamente la modernización de la aplicación de GitHub Copilot.
    • Para un uso más eficaz de Copilot en la modernización de aplicaciones: en la configuración de IntelliJ IDEA, seleccione la ventana Herramientas> de configuración deGitHub Copilot y, a continuación, seleccione Aprobación automática y Confianza de anotaciones de la herramienta MCP. Para obtener más información, consulte Configuración de las opciones de modernización de aplicaciones de GitHub Copilot para optimizar la experiencia de IntelliJ.
• JDK de Java para las versiones de JDK de origen y de destino.
• Maven o Gradle para compilar proyectos de Java.
• Un proyecto de Java administrado por Git mediante Maven o Gradle.
• Para proyectos basados en Maven: acceso al repositorio público de Maven Central.
• En la configuración de Visual Studio Code, asegúrese de que chat.extensionTools.enabled esté configurado en true. Esta configuración puede ser controlada por su organización.

Nota:

Si usa Gradle, solo se admite la versión 5+ del contenedor de Gradle. No se admite el lenguaje específico del dominio de Kotlin (DSL).

La función My Tasks aún no se admite para IntelliJ IDEA.

Inicie sesión para usar Copilot e instale la extensión necesaria.

Para usar GitHub Copilot, inicie sesión en su cuenta de GitHub en Visual Studio Code. Seleccione el icono de Copilot en la parte superior de Visual Studio Code para acceder al panel de GitHub Copilot. Para obtener más información sobre cómo configurar GitHub Copilot, consulte Configuración de GitHub Copilot en VS Code.

A continuación, siga estos pasos para instalar la extensión en Visual Studio Code:

1. En Visual Studio Code, abra la vista Extensiones desde la barra de actividad.
2. Busque GitHub Copilot app modernization en Marketplace.
3. Seleccione Modernización de aplicaciones copilot de GitHub.
4. En la página de extensión, seleccione Instalar.
5. Reinicie Visual Studio Code.

Sugerencia

Para obtener la mejor experiencia en IntelliJ, se recomienda configurar algunas opciones clave. Para obtener más información, consulte Configuración de las opciones de modernización de aplicaciones de GitHub Copilot para optimizar la experiencia de IntelliJ.

Una vez completada la instalación, debería ver una notificación en la esquina de Visual Studio Code que confirma que se ha realizado correctamente.

Para obtener más información, consulte Instalación de una extensión de VS Code.

Selección de un proyecto de Java para actualizar

Para los fines de este tutorial, elija uno de los repositorios de ejemplo siguientes:

• Maven: uportal-messaging
• Gradle: docraptor-java

Inicie el modo del agente copilot de GitHub e inicie la actualización.

Siga estos pasos para iniciar el modo del agente copilot de GitHub e iniciar el proceso de actualización:

1. Abra el proyecto de Java seleccionado en Visual Studio Code.

2. Abra el panel Chat de Copilot de GitHub.

3. Cambie al modo agente.

4. Escriba un mensaje como Actualizar proyecto a Java 21 mediante herramientas de actualización de Java o Actualizar proyecto a Java 21 y Spring Boot 3.2 mediante herramientas de actualización de Java para incluir información del marco.

   Nota:

   Si necesita actualizar solo un marco o una dependencia de terceros, consulte Actualización de un marco o dependencia de terceros mediante la modernización de aplicaciones de GitHub Copilot.

5. Cuando se le solicite, seleccione Continuar para generar un plan de actualización.

Revisión y edición del plan de actualización

La modernización de aplicaciones de GitHub Copilot analiza el proyecto de Java en el área de trabajo actual, incluido su JDK, las herramientas de compilación y las dependencias. La herramienta genera un archivo plan.md que describe los siguientes cambios planeados:

• Versiones de JDK de origen y destino.
• Rutas de actualización de marcos y bibliotecas.

Revise el plan y realice cambios si es necesario y seleccione Continuar para continuar. Para obtener información sobre la personalización adicional, como agregar más parámetros de la herramienta de compilación, consulte Personalización del plan de actualización.

Sugerencia

Asegúrese de que el plan coincide con los destinos de actualización deseados; por ejemplo, Java 8 a Java 21, Spring Boot 2.7 a 3.2.

Aplicación de cambios de código y corrección de problemas de compilación

Después, GitHub Copilot continúa con la fase de transformación de código del proyecto. Usa una herramienta de código abierto denominada OpenRewrite para implementar algunos cambios de código basados en recetas específicas. A continuación, la inteligencia artificial soluciona los problemas restantes a través de un bucle dinámico de compilación y corrección. Puede supervisar el progreso en el área del editor de Visual Studio Code comprobando el archivo markdown de progress.md en cualquier momento.

En varias fases del proceso, GitHub Copilot le pide que continúe.

Para el paso Confirmar la transformación con OpenRewrite, seleccione Continuar para actualizar el código Java mediante OpenRewrite. Este paso puede tardar unos minutos.

Para el paso Aprobar el bucle de compilación/corrección dinámicos , seleccione Continuar para compilar el proyecto y corregir errores.

Copilot itera y corrige errores hasta que no quede ninguno. El progreso se muestra en un archivo progress.md . El bucle continúa hasta que el proyecto se compila correctamente.

Comprobación de vulnerabilidades y cambios en el comportamiento del código

En determinadas circunstancias, la actualización podría provocar cambios en el comportamiento del código o introducir bibliotecas con problemas comunes de vulnerabilidades y exposiciones (CVE). La herramienta realiza una comprobación adicional de estos problemas.

Cuando GitHub Copilot solicite Ejecutar Validar si alguna dependencia modificada tiene vulnerabilidades comunes (CVE) conocidas, seleccione Continuar.

Si se encuentran CVE, el Modo Agente Copilot de GitHub intenta corregirlos. Revise los cambios en VS Code y decida si desea mantenerlos.

Después de la comprobación CVE, cuando se le pida que ejecute la validación de la coherencia del comportamiento del código, seleccione Continuar.

Si se encuentran problemas, el modo del agente copilot de GitHub intenta resolverlos. Decida si desea conservar o descartar los cambios.

Una vez completadas las comprobaciones, GitHub Copilot vuelve a generar el proyecto y vuelve a ejecutar las comprobaciones anteriores.

Si hay problemas menores que no requieren correcciones inmediatas, la actualización se completa. En caso contrario, GitHub Copilot vuelve a abordarlos.

Revise el resumen

Después de la actualización, la herramienta genera un resumen en el archivo summary.md , que incluye la siguiente información:

• Información del proyecto.
• Se cambiaron las líneas de código.
• Dependencias actualizadas.
• Cambios de código resumidos.
• Se han corregido problemas de seguridad de CVE y de incoherencia de código, si los hubiera.
• Problemas menores de CVE no abordados.

Paso siguiente

Inicio rápido: Generación de pruebas unitarias con modernización de aplicaciones de GitHub Copilot