Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Actualización de versiones de Java con Amazon Q Developer

Amazon Q Developer puede actualizar sus aplicaciones Java a versiones de idiomas más recientes en el entorno de desarrollo integrado (IDE). Los cambios que Amazon Q puede realizar para actualizar el código incluyen la actualización de componentes de código obsoletos y APIs la actualización de bibliotecas, marcos y otras dependencias del código.

Para transformar el código, Amazon Q primero lo crea en la versión del idioma de origen y comprueba que tiene la información necesaria para realizar la transformación. Una vez que Amazon Q haya transformado correctamente el código, usted verificará y aceptará los cambios en su IDE. Dado que Amazon Q Developer realiza los cambios mínimos necesarios para que el código actualizado sea compatible con el JDK de destino, es necesaria una transformación adicional para actualizar las bibliotecas y dependencias del proyecto. Para obtener más información sobre cómo Amazon Q transforma tu código, consultaCómo transforma Amazon Q Developer el código para las actualizaciones del lenguaje Java.

Actualizaciones de Java compatibles y IDEs

Actualmente, Amazon Q admite las siguientes versiones de código fuente y versiones de destino de Java para las transformaciones. La transformación del código a la misma versión de Java incluye la actualización de las bibliotecas y otras dependencias de la versión del código fuente.

Amazon Q admite las siguientes actualizaciones de Java IDEs:

Paso 1: requisitos previos

Antes de continuar, asegúrese de que ha completado los pasos en Configurar Amazon Q en su IDE.

Asegúrese de que se cumplen los siguientes requisitos previos antes de comenzar el trabajo de transformación de código:

Paso 2: configuración del proyecto

Para configurar el proyecto, utilice la siguiente información para el IDE que esté utilizando.

Configuración de un proyecto en JetBrains

Para configurar el proyecto en JetBrains, puede que tenga que especificar los siguientes ajustes del proyecto y del módulo.

Si los módulos usan el mismo JDK y el mismo nivel de idioma que su proyecto, no necesita actualizar la configuración del módulo.

Para obtener más información, consulte Project structure settings y Module structure settings en la documentación de JetBrains.

Configuración de un proyecto en VS Code

Para configurar el proyecto en VS Code, el proyecto debe contener lo siguiente:

Si su proyecto contiene un ejecutable de contenedor de Maven (mvnw para macOS o mvnw.cmd para Windows), asegúrese de que esté en la raíz del proyecto. Amazon Q utilizará el contenedor y no será necesaria ninguna otra configuración de Maven.

Si no está utilizando un contenedor de Maven, instale Maven. Para obtener más información, consulte la sección Installing Apache Maven en la documentación de Apache Maven.

Después de instalar Maven, agréguelo a su variable de PATH. Para obtener más información, consulte ¿Cómo agrego Maven a mi PATH?. La variable runtime de Java también debe apuntar a un JDK y no a un JRE. Para confirmar que la configuración es correcta, ejecute mvn -v. El resultado debería mostrar su versión de Maven y la variable runtime que apunta a la ruta a su JDK.

Paso 3: Crear un archivo de actualización de dependencias (opcional)

Puede proporcionar a Amazon Q un archivo de actualización de dependencias, un archivo YAML que muestre las dependencias de su proyecto y las versiones a las que debe actualizarse durante una transformación. Al proporcionar un archivo de actualización de dependencias, puede especificar dependencias de terceros y propias que Amazon Q no sabría actualizar de otro modo.

Las dependencias propias se refieren a las bibliotecas, complementos y marcos que mantiene su organización y que solo están disponibles localmente o en la red privada de su organización. Amazon Q puede acceder a sus dependencias propias cuando realiza compilaciones en su entorno local. Para obtener más información, consulte Cree código en su entorno local. Las dependencias de terceros están disponibles públicamente o son dependencias de código abierto que no son exclusivas de su organización.

Puede especificar las dependencias propias que desee actualizar en un archivo YAML y Amazon Q las actualizará durante la actualización del JDK (por ejemplo, de Java 8 a 17). Puede iniciar una transformación independiente (del 17 al 17 o del 21 al 21) después de la actualización inicial del JDK para actualizar las dependencias de terceros.

Una vez que Amazon Q realice una actualización mínima de JDK, puede iniciar una transformación independiente para actualizar todas las dependencias de terceros. Como alternativa, puede especificar las dependencias de terceros y sus versiones en un archivo YAML para actualizar únicamente esas dependencias durante la transformación de la actualización de la biblioteca.

Amazon Q le pedirá que proporcione un archivo de actualización de dependencias durante la transformación. Si desea proporcionar uno, primero asegúrese de haber configurado el archivo correctamente. Los siguientes campos son obligatorios en el archivo YAML:

A continuación se muestra un ejemplo de un archivo YAML de actualización de dependencias y la configuración necesaria para que Amazon Q lo analice:

name: dependency-upgrade
  
description: "Custom dependency version management for Java migration from JDK 8/11/17 to JDK 17/21"
  
  
dependencyManagement:
  
  dependencies:
  
    - identifier: "com.example:library1"
  
      targetVersion: "2.1.0"
  
      versionProperty: "library1.version"  # Optional
  
      originType: "FIRST_PARTY"   
  
    - identifier: "com.example:library2"
  
      targetVersion: "3.0.0"
  
      originType: "THIRD_PARTY"
  
  plugins:
  
    - identifier: "com.example.plugin"
  
      targetVersion: "1.2.0"
  
      versionProperty: "plugin.version"  # Optional
            
      originType: "THIRD_PARTY"  

Paso 4: Transforma tu código

Antes de transformar su propio código, quizás quiera probar que su IDE está configurado correctamente transformando un proyecto de muestra. A continuación se muestra un GitHub proyecto de muestra que es elegible para la transformación de código: https://github.com/aws-samples/aws-appconfig-java-sample.

Para probar la configuración de su IDE, descargue y descomprima el proyecto de ejemplo y realice los siguientes pasos para su IDE. Si puede ver los cambios propuestos y el resumen de la transformación, estará listo para transformar su propio proyecto de código. Si la transformación falla, su IDE no se ha configurado correctamente. Para solucionar los problemas de configuración, revise Paso 2: configuración del proyecto y Solución de problemas.

Para actualizar la versión de lenguaje del código de su proyecto o módulo de código, realice los siguientes pasos en su IDE.

JetBrains

1. Abra el módulo que desea actualizar en JetBrains. Asegúrese de haber compilado correctamente su proyecto en el IDE.

2. Elija el logotipo de Amazon Q y, a continuación, introduzca /transform en el panel de chat de Amazon Q que se abrirá.

3. Aparece la ventana emergente Transformar su aplicación. Elija el proyecto que desea actualizar de la lista desplegable y, a continuación, elija Transformar.

4. Amazon Q le pide que proporcione un archivo de dependencias de actualización. Si ha configurado un YAML con las dependencias y la versión a las que desea realizar la actualización, añada su archivo. Amazon Q validará el archivo para asegurarse de que está configurado correctamente. Si se produce un error, revise el formato y los campos obligatorios descritos enPaso 3: Crear un archivo de actualización de dependencias (opcional).

5. Amazon Q inicia la transformación. Puede ver el progreso en la pestaña de Detalles de la transformación.

6. Una vez completada la transformación, puede verificar el código actualizado antes de actualizar el proyecto. Para ver el código nuevo, vaya a la pestaña de Detalles de la transformación y, a continuación, seleccione Ver diferencias. En la ventana Aplicar parche que aparece, seleccione un archivo para abrir una vista de diferencias con el código de origen y el código actualizado.

7. Para aceptar los cambios realizados por Amazon Q, seleccione Ver diferencias para abrir la ventana Aplicar parche. Seleccione todos los archivos actualizados y seleccione Aceptar para actualizar el proyecto en su lugar.

8. Para obtener detalles sobre cómo se actualizó el código y sugerir los próximos pasos, en la pestaña Detalles de la transformación, seleccione Ver resumen de la transformación.

Visual Studio Code

1. Abra el proyecto o el espacio de trabajo que desea actualizar en VS Code. Asegúrese de haber compilado correctamente su proyecto en el IDE.

2. Elija el logotipo de Amazon Q y, a continuación, introduzca /transform en el panel de chat de Amazon Q que se abrirá.

3. Elija el proyecto que desea actualizar en la barra de búsqueda situada en la parte superior del IDE.

4. Si Amazon Q no encuentra la versión del código de origen, le pedirá que elija la versión del código. Elija la versión en la que está escrito el código de origen y, a continuación, seleccione Transformar en la ventana emergente para continuar.

5. Si se le solicita, introduzca la ruta de JAVA_HOME en su JDK. Para obtener más información, consulte Configurar su proyecto de VS Code.

6. Amazon Q le pide que proporcione un archivo de dependencias de actualización. Si ha configurado un YAML con las dependencias y la versión a las que desea realizar la actualización, añada su archivo. Amazon Q validará el archivo para asegurarse de que está configurado correctamente. Si se produce un error, revise el formato y los campos obligatorios descritos enPaso 3: Crear un archivo de actualización de dependencias (opcional).

7. Amazon Q inicia la transformación. Puede ver el progreso en la pestaña de Centro de transformación.

8. Una vez completada la transformación, se abre la pestaña Cambios propuestos. Para verificar el código actualizado antes de actualizar el proyecto, seleccione Descargar los cambios propuestos. Seleccione un archivo para abrir una vista de diferencias con el código de origen y el código actualizado.

9. Para aceptar los cambios realizados por Amazon Q, vaya a la pestaña Cambios propuestos y seleccione Aceptar.

10. Para obtener detalles sobre cómo se actualizó el código y sugerirle los siguientes pasos, en el Centro de transformaciones, pulse el botón de puntos suspensivos Vistas y más acciones y, a continuación, elija Mostrar resumen de la transformación.