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

La modernización con GitHub Copilot ofrece una experiencia basada en agentes impulsada por IA que automatiza de principio a fin los flujos de trabajo de actualización de Java, desde el análisis del proyecto y la generación del plan hasta la transformación del código, la validación de la compilación y la corrección de vulnerabilidades CVE.

Escenarios de actualización admitidos

  • Actualice Java Kit de desarrollo (JDK) a Java 11, 17, 21 o 25.
  • Actualice Spring Boot hasta la versión 4.0.
  • Actualice Spring Framework hasta la versión 7.x.
  • Actualice Java EE a Jakarta EE, hasta Jakarta EE 11.
  • Actualice SDK de Azure para Java.
  • Actualice JUnit.
  • Actualice las dependencias de terceros a una versión especificada.

Prerrequisitos

  • Una cuenta de GitHub con GitHub Copilot habilitado. Necesita un plan de nivel Gratis, Pro, Pro+, Empresa o Enterprise.
  • Java JDK 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.

  • Instale la CLI GitHub Copilot:

    npm install -g @github/copilot

  • Instale el complemento de modernización GitHub Copilot:

    copilot plugin marketplace add microsoft/modernize-java
copilot plugin install modernize-java@modernize-java

Nota:

Solo se requiere una cuenta de Azure para desplegar recursos en Azure, y no es necesaria cuando se usa la modernización con GitHub Copilot para realizar cambios en el código.

Si usa Gradle, solo se admite la versión 5 o posterior del wrapper de Gradle.

No se admite el lenguaje específico del dominio de Kotlin (DSL).

Selección de un proyecto de Java para actualizar

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

Iniciar la actualización

Siga estos pasos para iniciar el proceso de actualización:

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

  2. En la barra lateral, abra el panel Modernización de GitHub Copilot para ver la página de Inicio rápido.

  3. Seleccione Upgrade Java Runtime & Frameworks.

    Esta acción abre GitHub Copilot Chat en modo de agente e inicia automáticamente el proceso de actualización.

    Sugerencia

    También puede seleccionar una tarea específica en el árbol Tareas debajo del panel Inicio rápido (por ejemplo, Actualizar versión de Spring Boot o Actualizar versión de Jakarta EE) para desencadenar una actualización dirigida.

    Como alternativa, puede escribir directamente en GitHub Copilot Chat mediante el modo de agente ( por ejemplo, "Actualizar mi proyecto de Java a Java 21" - para iniciar la actualización.

Captura de pantalla de Visual Studio Code que muestra la página de Inicio rápido con el botón Actualizar el entorno de ejecución de Java y los frameworks.

Siga estos pasos para iniciar el proceso de actualización:

  1. Abra el proyecto de Java seleccionado en IntelliJ IDEA.

  2. En la barra lateral, abra el panel Modernización de GitHub Copilot para ver la página de Inicio rápido.

  3. Seleccione Actualizar tiempo de ejecución y marcos.

    Esta acción abre GitHub Copilot Chat en modo de agente e inicia automáticamente el proceso de actualización.

    Sugerencia

    También puede escribir directamente en GitHub Copilot Chat mediante el modo de agente ( por ejemplo, "Actualizar mi proyecto de Java a Java 21" - para iniciar la actualización.

Captura de pantalla de IntelliJ IDEA que muestra el panel de modernización de GitHub Copilot con tareas de actualización y el panel de chat ejecutando el proceso de actualización.

Siga estos pasos para iniciar el proceso de actualización:

  1. Abra un terminal y vaya al directorio del proyecto de Java.

  2. Ejecute el comando upgrade:

    copilot --model claude-sonnet-4.6 --agent modernize-java:modernize-java

  3. Una vez iniciado el agente, escriba la solicitud de actualización:

    upgrade to Java 21 + Spring Boot 3.5.x

Screenshot de un terminal que muestra la CLI de Copilot iniciando una actualización de Java con modernize-java agent.

Seleccione los objetivos de actualización

Después de iniciar la actualización, el agente le pedirá que seleccione las versiones de destino. Elija la versión de Java deseada y, si procede, la versión de Spring Boot para el proyecto.

Captura de pantalla de Visual Studio Code que muestra el mensaje de selección de versión de Java de destino con opciones para Java 21, 17 y 25.

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

GitHub Copilot modernización analiza el proyecto de Java en el espacio de trabajo actual, incluido su JDK, las herramientas de compilación y las dependencias. La herramienta genera un archivo plan.md que incluye:

  • Herramientas disponibles : se detectaron JDK y herramientas de compilación en su entorno.
  • Directrices : restricciones especificadas por el usuario para el proceso de actualización.
  • Opciones : rama de trabajo y configuración de prueba.
  • Objetivos de actualización : versiones de origen y destino para cada componente.
  • Technology Stack : análisis de compatibilidad de dependencias con motivos de incompatibilidad.
  • Actualizaciones derivadas — actualizaciones adicionales requeridas por los objetivos principales (por ejemplo, la migración del espacio de nombres de javax a jakarta al actualizar a Spring Boot 3.x).
  • Análisis de impacto : desglose detallado de los cambios de dependencia, cambios de código fuente, cambios de configuración, cambios de CI/CD y riesgos.
  • Pasos de actualización: pasos de migración ordenados con criterios de justificación y comprobación.

Revise el plan y haga cambios si es necesario y, a continuación, confirme para continuar. Para obtener más información sobre la personalizació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 1.5 a 3.5.

Captura de pantalla de Visual Studio Code que muestra el archivo plan.md con los objetivos de la actualización y la pila tecnológica.

Ejecución de la actualización

Después de confirmar el plan, el agente continúa automáticamente con la fase de transformación de código. Como parte de este proceso, realiza las siguientes tareas:

  • Modifica los archivos de código y configuración para garantizar la compatibilidad con las versiones de destino.
  • Realiza la validación de compilación para confirmar que el proyecto se compila correctamente en cada paso.
  • Ejecuta la validación de pruebas si está habilitada en las opciones del plan.

El agente recorre en iteración cada paso de actualización hasta que todos los pasos se completen correctamente. Puede supervisar el progreso en cualquier momento comprobando el archivo progress.md en el editor.

Captura de pantalla de Visual Studio Code que muestra el archivo progress.md con el estado del paso de la actualización.

Validación y corrección de CVE

Una vez completados los pasos de transformación de código, el agente examina automáticamente las dependencias de los problemas comunes de vulnerabilidades y exposiciones (CVE). Si se encuentran CVE, el agente los corrige actualizando las dependencias afectadas; no se requiere ninguna intervención manual. A continuación, se ejecuta el paso final de validación para confirmar que todo sigue compilando y pasa las pruebas tras las correcciones de las CVE.

Revise el resumen

Después de la actualización, la herramienta genera un archivo summary.md , que incluye:

  • Resumen ejecutivo : una visión general de un párrafo de lo que se actualizó y el resultado.
  • Mejoras de actualización : una tabla de comparación anterior o posterior con ventajas clave.
  • Compilación y validación : estado de compilación y resultados de pruebas.
  • Limitaciones : cualquier problema que no se pueda solucionar después de la actualización.
  • Próximos pasos recomendados — acciones de seguimiento sugeridas, como generar pruebas unitarias o abordar cualquier CVE pendiente de corregir.
  • Detalles adicionales : los metadatos del proyecto, los cambios de código y los resultados del examen de CVE.

Captura de pantalla de Visual Studio Code que muestra el contenido del resumen de la actualización.

Captura de pantalla de IntelliJ IDEA que muestra el resumen de la actualización con el Resultado de la actualización de Java y el panel de chat, que muestra que la actualización se ha completado.

Captura de pantalla de un terminal que muestra el resumen de la actualización con los cambios en los archivos después de completar una actualización de Java 11 a 21 y de Spring Boot 2.7 a 3.5.

Paso siguiente

Inicio rápido: generar pruebas unitarias con la modernización de GitHub Copilot

  • Last updated on