Mise à niveau des versions linguistiques avec Amazon Q Developer Agent for code transformation - Développeur Amazon Q
Étape 1 : PrérequisÉtape 2 : Configuration de votre projetÉtape 3 : Transformez votre code

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Mise à niveau des versions linguistiques avec Amazon Q Developer Agent for code transformation

Ils Amazon Q Developer Agent for code transformation peuvent mettre à jour la version en langage de code de vos fichiers en place. Vous pouvez transformer un module en JetBrains un projet ou un espace de travail entier enVisual Studio Code.

Amazon Q crée d'abord votre code dans la version en langue source et vérifie qu'il contient les informations nécessaires pour transformer votre code. Une fois qu'Amazon Q a transformé votre code avec succès, vous vérifiez et acceptez les modifications dans votre environnement de développement intégré (IDE). Pour de plus amples informations, veuillez consulter Fonctionnement du kit Amazon Q Developer Agent for code transformation.

Actuellement, Amazon Q peut passer du code Java 8 et Java 11 au code Java 17.

Rubriques

Étape 1 : Prérequis

Avant de continuer, assurez-vous d'avoir suivi les étapes décrites dans Configurer Amazon Q dans votre IDE.

Assurez-vous que les conditions préalables suivantes sont remplies avant de commencer une tâche de transformation de code :

  • Votre projet est un projet Java 8 ou Java 11 sur lequel s'appuyerMaven.

  • Votre projet se construit avec succès grâce Maven à votreIDE. Amazon Q Developer Agent for code transformationprend en charge la version Maven 2.8, mais nous recommandons la version Maven 3.9.5 ou une version ultérieure.

  • JDKLa source de votre projet est disponible localement et correspond à la version de votre code source. Par exemple, si vous transformez du code Java 8, votre JDK installation locale doit être JDK 8.

  • Votre projet se construit en 55 minutes ou moins.

  • Votre projet est correctement configuré et la JDK version correcte est spécifiée. Pour de plus amples informations, veuillez consulter Étape 2 : Configuration de votre projet.

  • Votre projet ne nécessite pas l'accès aux ressources de votre réseau privé, notamment à un cloud privé virtuel (VPC) ou à un réseau sur site. Par exemple, si votre projet contient des tests unitaires qui se connectent à une base de données de votre réseau, la transformation échouera.

  • Votre projet n'utilise pas de plugins qui empaquetent des langages autres que Java dans votre projet Java. Par exemple, si votre projet utilise le frontend-maven-pluginpour exécuter du JavaScript code frontal en plus de votre code source Java, la transformation échouera.

  • Votre projet n'utilise pas de plages de versions de dépendance aux pom.xml fichiers. Par exemple, si votre pom.xml fichier inclut<version>[1.0.0,)</version>, la transformation échouera. Pour plus d'informations, consultez la section Spécification de la plage de versions dans la documentation du projet Apache Maven.

  • Votre réseau local autorise les téléchargements vers des compartiments Amazon S3 qu'Amazon Q utilise pour transformer votre code. Pour plus d'informations, consultez Autoriser l'accès aux compartiments Amazon S3 dans les périmètres de données.

  • La version minimale de votre compilateur pour le maven-compiler-plugin est v13.13.0.

Étape 2 : Configuration de votre projet

Pour configurer votre projet, utilisez les informations suivantes pour le projet que IDE vous utilisez.

Configurer un projet dans JetBrains

Pour configurer votre projet dansJetBrains, vous devrez peut-être spécifier les paramètres de structure de projet suivants :

  • Projet SDK : JDK utilisé pour compiler votre projet. Cela doit être spécifié afin de créer votre projet.

  • Niveau de langue du projet : Java langue utilisée dans votre projet. Cela doit être spécifié si la Java version utilisée dans votre projet est différente de votre JDK version.

  • Niveau de langue du module : Java langue utilisée dans votre module. Cela doit être spécifié si la Java version utilisée dans vos modules est différente de votre projet ou de votre JDK version.

Vous devrez peut-être ajuster ces paramètres si vous utilisez une version linguistique non prise en chargeJDK, mais que votre projet ou vos modules utilisent une version linguistique prise en charge. Par exemple, si vous transformez un projet Java 8, mais que vous en utilisez JDK 18, vous devez définir le niveau de langue de votre projet sur Java 8.

En outre, si votre projet contient plusieurs modules utilisant différentes versions linguistiques, vous devez définir le niveau de langue du module que vous transformez.

Mettre à jour les paramètres du projet

Pour mettre à jour les paramètres de langue de votre projetSDK, de la langue du projet ou du module, procédez comme suit :

  1. Dans votre JetBrainsIDE, choisissez Fichier, puis Structure du projet.

  2. La fenêtre Structure du projet s'ouvre. Sous Paramètres du projet, sélectionnez Projet.

    1. Pour mettre à jour votre JDK compte, choisissez dans le menu déroulant à côté de SDK.

    2. Pour mettre à jour la langue de votre projet, choisissez dans le menu déroulant à côté de Niveau de langue.

  3. Sous Paramètres du projet, choisissez Modules.

    1. Pour mettre à jour la langue de votre module, choisissez dans le menu déroulant à côté du niveau de langue.

Pour plus d'informations, consultez les sections Paramètres de structure de projet et Paramètres de structure de module dans la JetBrains documentation.

Configurer un projet dans VS Code

Pour configurer votre projet dansVS Code, celui-ci doit contenir les éléments suivants :

  • Un pom.xml fichier dans le dossier racine du projet

  • Un .java fichier dans le répertoire du projet

Si votre projet contient un Maven wrapper exécutable (mvnwpour macOS ou mvnw.cmd pourWindows), assurez-vous qu'il se trouve à la racine de votre projet. Amazon Q utilisera le wrapper et aucune autre Maven configuration n'est nécessaire.

Si vous n'utilisez pas de Maven wrapper, installez-leMaven. Pour plus d'informations, consultez la section Installation Apache Maven dans la Apache Maven documentation.

Après l'installationMaven, ajoutez-le à votre PATH variable. Pour plus d'informations, voir Comment ajouter Maven à mon PATH ? Votre runtime variable Java doit également pointer vers a JDK et non vers JRE a. Pour confirmer que votre configuration est correcte, lancezmvn -v. La sortie doit afficher votre Maven version et la runtime variable pointant vers le chemin d'accès à votreJDK.

Étape 3 : Transformez votre code

Avant de transformer votre propre code, vous souhaiterez peut-être vérifier que votre configuration IDE est correcte en transformant un exemple de projet. Voici un exemple de GitHub projet éligible à la transformation de code : https://github.com/aws-samples/aws-appconfig-java-sample.

Pour tester votre IDE configuration, téléchargez et décompressez l'exemple de projet, puis effectuez les étapes suivantes pour votreIDE. Si vous pouvez consulter les modifications proposées et le résumé des transformations, vous êtes prêt à transformer votre propre projet de code. Si la transformation échoue, IDE c'est que votre configuration n'est pas correcte. Pour résoudre les problèmes de configuration, consultez Étape 2 : Configuration de votre projet etRésolution des problèmes.

Note

Si vous quittez le vôtre IDE avant le début de la transformation, celle-ci échouera et vous devrez recommencer.

Pour mettre à niveau la version linguistique de votre projet ou module de code, effectuez les étapes suivantes pour votreIDE.

JetBrains

  1. Ouvrez le module dans lequel vous souhaitez effectuer la mise à niveauJetBrains. Assurez-vous d'avoir développé avec succès votre projet dans leIDE.

  2. Choisissez le logo Amazon Q, puis entrez /transform dans le panneau de discussion Amazon Q qui s'ouvre.

  3. La fenêtre contextuelle Transformez votre application s'affiche. Choisissez le projet que vous souhaitez mettre à niveau dans le menu déroulant, puis choisissez Transformer.

  4. Amazon Q entame la transformation. Vous pouvez consulter la progression dans l'onglet Détails de la transformation.

  5. Une fois la transformation terminée, vous pouvez vérifier le code mis à niveau avant de mettre à jour votre projet. Pour afficher le nouveau code, accédez à l'onglet Détails de la transformation, puis choisissez View diff. Dans la fenêtre Appliquer le correctif qui apparaît, choisissez un fichier pour ouvrir une vue de comparaison avec votre code source et le code mis à niveau.

  6. Pour accepter les modifications apportées par Amazon Q, choisissez View diff pour ouvrir la fenêtre Appliquer le correctif. Sélectionnez tous les fichiers mis à jour, puis cliquez sur OK pour mettre à jour votre projet sur place.

  7. Pour obtenir des détails sur la façon dont votre code a été mis à niveau et les prochaines étapes suggérées, dans l'onglet Détails de la transformation, choisissez Afficher le résumé de la transformation.

Code Visual Studio

  1. Ouvrez le projet ou l'espace de travail dans lequel vous souhaitez effectuer la mise à niveauVS Code. Assurez-vous d'avoir développé avec succès votre projet dans leIDE.

  2. Choisissez le logo Amazon Q, puis entrez /transform dans le panneau de discussion Amazon Q qui s'ouvre.

  3. Choisissez le projet que vous souhaitez mettre à niveau dans la barre de recherche en haut duIDE.

  4. Si Amazon Q ne trouve pas la version de votre code source, il vous invite à choisir la version de votre code. Choisissez la version dans laquelle votre code source est écrit, puis choisissez Transformer dans la fenêtre contextuelle pour continuer.

  5. Si vous y êtes invité, entrez le JAVA_HOME chemin d'accès à votreJDK. Pour plus d'informations, consultez la section Configurer votre VS Code projet.

  6. Amazon Q entame la transformation. Vous pouvez consulter la progression dans l'onglet Transformation Hub.

  7. Une fois la transformation terminée, l'onglet Modifications proposées s'ouvre. Pour vérifier le code mis à jour avant de mettre à jour votre projet, choisissez Télécharger les modifications proposées. Choisissez un fichier pour ouvrir une vue différentielle avec votre code source et le code mis à jour.

  8. Pour accepter les modifications apportées par Amazon Q, accédez à l'onglet Modifications proposées et choisissez Accepter.

  9. Pour obtenir des informations sur la manière dont votre code a été mis à niveau et sur les étapes suivantes suggérées, sur le Transformation Hub, cliquez sur le bouton Points de suspension Views and More Actions, puis sur Afficher le résumé de la transformation.