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

La Amazon Q Developer Agent for code transformation puede actualizar la versión en lenguaje de código de sus archivos en vigor. Puede transformar un módulo en JetBrains y un proyecto o un espacio de trabajo completo en Visual 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 Cómo Amazon Q Developer Agent for code transformation funciona.

Actualmente, Amazon Q puede actualizarse Java 8 y Java 11 códigos para Java Código 17.

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 es un Java 8 o Java 11 proyectos basados en Maven.

  • Su proyecto se construye con éxito con Maven en tuIDE. Amazon Q Developer Agent for code transformation es compatible con Maven 3.8 o posterior.

  • JDKLa fuente de su proyecto está disponible localmente y es la versión de su 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á.

  • 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 su proyecto en JetBrains, puede que tengas que especificar los siguientes ajustes del proyecto y del módulo.

Si los módulos utilizan el mismo JDK nivel de idioma que el proyecto, no es necesario que actualice la configuración del módulo.

  • ProyectoSDK: el que JDK se utiliza para compilar el proyecto.

  • Nivel de idioma del proyecto: el Java versión utilizada en el proyecto.

  • MóduloSDK: el que JDK se utiliza para compilar el módulo.

  • Nivel de idioma del módulo: el Java versión utilizada en el módulo.

  • Maven RunnerJRE: con el JDK que construyes tu módulo.

Actualice la configuración del proyecto y del módulo

Para actualizar su configuración SDK y su nivel de idioma para su proyecto o módulo, complete los siguientes pasos:

  1. Desde tu JetBrains IDE, 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 tu proyectoJDK, selecciona una opción en la lista desplegable situada junto a SDK.

    2. Para actualizar el idioma del 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 móduloJDK, elige una opción de la lista desplegable situada junto a. SDK

    2. Para actualizar el idioma de su módulo, elija una opción en el menú desplegable situado junto al nivel de idioma.

Para obtener más información, consulta los ajustes de la estructura del proyecto y los ajustes de la estructura del módulo en JetBrains .

Actualice la configuración de Maven

Para actualizar tu Maven RunnerJRE, sigue estos pasos:

  1. Desde tu JetBrains IDE, selecciona el icono con forma de engranaje y, a continuación, selecciona Configuración en el menú que aparece.

  2. En la ventana de configuración, selecciona Build, Execution, Deployment, Build Tools, Maven y Runner.

  3. En el JRE campo, elige la que JDK se usará para construir el módulo que estás transformando.

Configura un proyecto en VS Code

Para configurar su proyecto en VS Code, su 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 Maven contenedor ejecutable (mvnwpara macOS o para mvnw.cmd Windows), asegúrate de que esté en la raíz de tu proyecto. Amazon Q usará el envoltorio y ningún otro Maven la configuración es necesaria.

Si no está utilizando un Maven envoltorio, instale Maven. Para obtener más información, consulte Instalación Apache Mavenen el Apache Maven .

Después de instalar Maven, agréguelo a su 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 suJDK.

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. Abra el módulo en el que desee actualizar JetBrains. 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. Elija el proyecto que desee actualizar en la lista desplegable y, a continuación, elija 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 actualizar VS Code. 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. 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 su 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.