Actualización de las versiones lingüísticas con el Amazon Q Developer Agent for code transformation - Amazon Q Developer
Paso 1: Requisitos previosPaso 2: Configura tu proyectoPaso 3: Transforma tu código

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 las versiones lingüísticas con el Amazon Q Developer Agent for code transformation

Amazon Q Developer Agent for code transformationPuede actualizar la versión en lenguaje de código de sus archivos instalada. Puede transformar un módulo en JetBrains un proyecto o un espacio de trabajo completo enVisual Studio Code.

Amazon Q primero crea el código en la versión del idioma de origen y comprueba que tiene la información necesaria para transformarlo. Una vez que Amazon Q haya transformado correctamente el código, usted verificará y aceptará los cambios en su entorno de desarrollo integrado (IDE). Para obtener más información, consulte Funcionamiento del Amazon Q Developer Agent for code transformation.

Actualmente, Amazon Q puede actualizar los códigos Java 8 y Java 11 a Java 17 códigos.

Temas

Paso 1: Requisitos previos

Antes de continuar, asegúrate de haber completado los pasos de Configurar Amazon Q en tu IDE.

Asegúrese de cumplir los siguientes requisitos previos antes de comenzar un trabajo de transformación de código:

  • Su proyecto se basa en un proyecto de Java 8 u Java 11. Maven

  • Su proyecto se construye con Maven éxito con suIDE. Amazon Q Developer Agent for code transformationes compatible con la versión Maven 2.8, pero recomendamos la versión Maven 3.9.5 o una versión posterior.

  • El código fuente del proyecto JDK está disponible localmente y es la versión del código fuente. Por ejemplo, si está transformando el código de Java 8, su JDK instalación local debería ser JDK 8.

  • Su proyecto se construye en 55 minutos o menos.

  • El proyecto está configurado correctamente y se ha especificado la JDK versión correcta. Para obtener más información, consulte Paso 2: Configura tu proyecto.

  • Tu proyecto no requiere acceso a los recursos de tu red privada, incluida una nube privada virtual (VPC) o una red local. Por ejemplo, si tu proyecto contiene pruebas unitarias que se conectan a una base de datos de tu red, la transformación fallará.

  • Su proyecto no usa complementos que empaqueten lenguajes distintos de Java en su proyecto de Java. Por ejemplo, si su proyecto utiliza el código de interfaz frontend-maven-pluginpara ejecutar además del JavaScript código fuente de Java, la transformación fallará.

  • Tu proyecto no usa rangos de versiones dependientes de pom.xml archivos. Por ejemplo, si tu pom.xml archivo lo incluye<version>[1.0.0,)</version>, la transformación fallará. Para obtener más información, consulte la especificación del rango de versiones en la documentación del proyecto Apache Maven.

  • Su red local permite las cargas a los buckets de Amazon S3 que Amazon Q utiliza para transformar el código. Para obtener más información, consulte Permitir el acceso a los buckets de Amazon S3 en los perímetros de datos.

  • La versión mínima del compilador para el es la v13.13.0maven-compiler-plugin.

Paso 2: Configura tu proyecto

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

Configura un proyecto en JetBrains

Para configurar el proyectoJetBrains, es posible que deba especificar los siguientes ajustes de la estructura del proyecto:

  • ProyectoSDK: el que JDK se utiliza para compilar el proyecto. Esto debe especificarse para poder construir el proyecto.

  • Nivel de idioma del proyecto: el Java idioma utilizado en el proyecto. Debe especificarse si la Java versión utilizada en el proyecto es diferente de la JDK suya.

  • Nivel de idioma del módulo: el Java idioma utilizado en el módulo. Debe especificarse si la Java versión utilizada en los módulos es diferente de la JDK versión o proyecto.

Es posible que tengas que ajustar esta configuración si utilizas una versión no compatibleJDK, pero tu proyecto o tus módulos utilizan una versión de idioma compatible. Por ejemplo, si estás transformando un proyecto de Java 8, pero utilizas JDK 18, debes establecer el nivel de idioma del proyecto en Java 8.

Además, si tu proyecto contiene varios módulos que utilizan versiones de idiomas diferentes, debes establecer el nivel de idioma del módulo que estás transformando.

Actualiza la configuración del proyecto

Para actualizar la configuración del proyectoSDK, el idioma del proyecto o el idioma del módulo, siga estos pasos:

  1. Desde su JetBrainsIDE, elija Archivo y, a continuación, Estructura del proyecto.

  2. Se abre la ventana Estructura del proyecto. En Configuración del proyecto, elija Proyecto.

    1. Para actualizar el tuyoJDK, selecciona una opción en el menú desplegable situado junto a SDK.

    2. Para actualizar el idioma de tu proyecto, selecciona una opción en el menú desplegable situado junto al nivel de idioma.

  3. En Project Settings, seleccione Modules.

    1. Para actualizar el idioma del módulo, selecciona una opción en el menú desplegable situado junto al nivel de idioma.

Para obtener más información, consulte la configuración de la estructura del proyecto y la configuración de la estructura del módulo en la JetBrains documentación.

Configure un proyecto en VS Code

Para configurar el proyecto enVS Code, el proyecto debe contener lo siguiente:

  • Un pom.xml archivo en la carpeta raíz del proyecto

  • Un .java archivo en el directorio del proyecto

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

Si no está utilizando un Maven envoltorio, instálelo. Maven Para obtener más información, consulte Instalación Apache Maven en la Apache Maven documentación.

Tras la instalaciónMaven, agréguela a la PATH variable. Para obtener más información, ¿Cómo agrego Maven a mi? PATH consulte La runtime variable de Java también debe apuntar a JDK y no aJRE. Para confirmar que la configuración es correcta, ejecutemvn -v. El resultado debería mostrar su Maven versión y la runtime variable que apunta a la ruta a la suyaJDK.

Paso 3: Transforma tu código

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

Para probar su IDE configuración, descargue y descomprima el proyecto de muestra, y complete los siguientes pasos para suIDE. 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, la suya no IDE está configurada correctamente. Para solucionar los problemas de configuración, revise Paso 2: Configura tu proyecto yResolución de problemas.

nota

Si te alejas de IDE antes de que comience la transformación, la transformación fallará y tendrás que volver a empezar.

Para actualizar la versión lingüística de su proyecto o módulo de código, complete los siguientes pasos para suIDE.

JetBrains

  1. Abre el módulo que deseas actualizarJetBrains. Asegúrese de haber creado correctamente su proyecto en elIDE.

  2. Elige el logotipo de Amazon Q y entra /transform en el panel de chat de Amazon Q que se abre.

  3. Aparece la ventana emergente Transforma tu aplicación. Elige el proyecto que deseas actualizar en el menú desplegable y, a continuación, selecciona Transformar.

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

  5. Una vez completada la transformación, puedes verificar el código actualizado antes de actualizar tu proyecto. Para ver el código nuevo, ve a la pestaña de detalles de la transformación y, a continuación, selecciona Ver diferencia. En la ventana Aplicar parche que aparece, selecciona un archivo para abrir una vista de diferencias con el código fuente y el código actualizado.

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

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

Visual Studio Code

  1. Abre el proyecto o el espacio de trabajo en el que deseas actualizarVS Code. Asegúrese de haber creado correctamente su proyecto enIDE.

  2. Elige el logotipo de Amazon Q y entra /transform en el panel de chat de Amazon Q que se abre.

  3. Elige el proyecto que deseas actualizar en la barra de búsqueda situada en la parte superior delIDE.

  4. Si Amazon Q no encuentra la versión del código fuente, te pedirá que elijas la versión del código. Elige la versión en la que está escrito tu código fuente y, a continuación, selecciona Transformar en la ventana emergente para continuar.

  5. Si se te solicita, ingresa la JAVA_HOME ruta a tuJDK. Para obtener más información, consulte Configurar el VS Code proyecto.

  6. Amazon Q inicia la transformación. Puede ver el progreso en la pestaña Transformation Hub.

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

  8. Para aceptar los cambios realizados por Amazon Q, ve a la pestaña Cambios propuestos y selecciona Aceptar.

  9. 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.