Mise à niveau des versions de Java avec Amazon Q Developer - Amazon Q Developer
Mises à niveau Java prises en charge et IDEsÉtape 1 : PrérequisÉtape 2 : Configuration de votre projetÉtape 3 : créer un fichier de mise à niveau des dépendances (facultatif)Étape 4 : 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 de Java avec Amazon Q Developer

Amazon Q Developer peut mettre à niveau vos applications Java vers des versions linguistiques plus récentes dans l'environnement de développement intégré (IDE). Les modifications qu'Amazon Q peut apporter pour mettre à niveau votre code incluent la mise à jour des composants de code obsolètes APIs ainsi que la mise à niveau des bibliothèques, des frameworks et des autres dépendances de votre code.

Pour transformer votre 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 effectuer la transformation. Une fois qu'Amazon Q a transformé votre code avec succès, vous vérifiez et acceptez les modifications dans votre IDE. Amazon Q Developer apportant les modifications minimales nécessaires pour rendre votre code mis à niveau compatible avec le JDK cible, une transformation supplémentaire est nécessaire pour mettre à niveau les bibliothèques et les dépendances de votre projet. Pour plus d'informations sur la façon dont Amazon Q transforme votre code, consultezComment Amazon Q Developer transforme le code pour les mises à niveau du langage Java.

Rubriques

Mises à niveau Java prises en charge et IDEs

Amazon Q prend actuellement en charge les versions de code source Java et les versions cibles suivantes pour les transformations. La transformation du code vers la même version de Java inclut la mise à niveau des bibliothèques et des autres dépendances de la version du code source.

Mises à niveau Java supportées
Version du code source Versions cibles prises en charge
Java 8 Java 17 et Java 21
Java 11 Java 17 et Java 21
Java 17 Java 17 et Java 21
Java 21

Java21

Amazon Q prend en charge les mises à niveau de Java dans les domaines suivants IDEs :

  • Modules dans JetBrains IDEs

  • Projets et espaces de travail dans Visual Studio Code

É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 écrit dans une Javaversion prise en charge et est basé surMaven.

  • Votre projet se construit avec succès grâce Maven à votre IDE. MavenLa version 3.8 ou ultérieure est actuellement prise en charge.

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

  • Votre projet se construit en 55 minutes ou moins.

  • Votre projet est correctement configuré et la version correcte du JDK 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 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.

Étape 2 : Configuration de votre projet

Pour configurer votre projet, utilisez les informations suivantes relatives à l'IDE que vous utilisez.

Configurer un projet dans JetBrains

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

Si vos modules utilisent le même JDK et le même niveau de langue que votre projet, vous n'avez pas besoin de mettre à jour les paramètres du module.

  • SDK du projet — Le JDK utilisé pour compiler votre projet.

  • Niveau de langue du projet : Java version utilisée dans votre projet.

  • SDK du module — Le JDK utilisé pour compiler votre module.

  • Niveau de langue du module : Java version utilisée dans votre module.

  • Maven Runner JRE — Le JDK avec lequel vous créez votre module.

Mettre à jour les paramètres du projet et du module

Pour mettre à jour votre SDK et les paramètres de niveau de langue pour votre projet ou module, procédez comme suit :

  1. Dans votre JetBrains IDE, 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 le JDK de votre projet, choisissez-le dans la liste déroulante à côté du 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 le JDK de votre module, choisissez-le dans la liste déroulante à côté du SDK.

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

Mettre à jour les paramètres de Maven

Pour mettre à jour votre Maven Runner JRE, procédez comme suit :

  1. Dans votre JetBrains IDE, choisissez l'icône représentant un engrenage, puis sélectionnez Paramètres dans le menu qui apparaît.

  2. Dans la fenêtre Paramètres, choisissez Build, Execution, Deployment, Build Tools, Maven et Runner.

  3. Dans le champ JRE, choisissez le JDK utilisé pour créer le module que vous transformez.

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 un JDK et non vers un JRE. Pour vérifier que votre configuration est correcte, exécutezmvn -v. La sortie doit afficher votre Maven version et la runtime variable pointant vers le chemin d'accès à votre JDK.

Étape 3 : créer un fichier de mise à niveau des dépendances (facultatif)

Vous pouvez fournir à Amazon Q un fichier de mise à niveau des dépendances, un fichier YAML répertoriant les dépendances de votre projet et les versions vers lesquelles effectuer la mise à niveau lors d'une transformation. En fournissant un fichier de mise à niveau des dépendances, vous pouvez spécifier les dépendances tierces et internes qu'Amazon Q ne serait peut-être pas en mesure de mettre à niveau autrement.

Les dépendances internes font référence aux bibliothèques, aux plug-ins et aux frameworks gérés par votre organisation et qui ne sont disponibles que localement ou sur le réseau privé de votre organisation. Amazon Q est en mesure d'accéder à vos dépendances internes lorsqu'il réalise des builds dans votre environnement local. Pour de plus amples informations, veuillez consulter Code du bâtiment dans votre environnement local. Les dépendances tierces sont des dépendances accessibles au public ou des dépendances open source qui ne sont pas propres à votre organisation.

Vous pouvez spécifier les dépendances internes que vous souhaitez mettre à niveau dans un fichier YAML, et Amazon Q les met à niveau lors de la mise à niveau du JDK (par exemple, Java 8 vers 17). Vous pouvez lancer une transformation distincte (17 vers 17 ou 21 vers 21) après la mise à niveau initiale du JDK pour mettre à niveau les dépendances tierces.

Une fois qu'Amazon Q a effectué une mise à niveau minimale du JDK, vous pouvez lancer une transformation distincte pour mettre à niveau toutes les dépendances tierces. Vous pouvez également spécifier les dépendances tierces et leurs versions dans un fichier YAML pour ne mettre à niveau ces dépendances que lors de la transformation de mise à niveau de la bibliothèque.

Amazon Q vous demandera de fournir un fichier de mise à niveau des dépendances lors de la transformation. Si vous souhaitez en fournir un, assurez-vous d'abord d'avoir correctement configuré le fichier. Les champs suivants sont obligatoires dans le fichier YAML :

  • name : nom du fichier de mise à niveau des dépendances.

  • description (facultatif) : description du fichier de mise à niveau des dépendances et de quelle transformation.

  • DependencyManagement : contient la liste des dépendances et des plugins à mettre à niveau.

  • dépendances : contient le nom et la version des bibliothèques à mettre à niveau.

  • plugins - Contient les noms et les versions des plugins à mettre à niveau.

  • identifiant : nom de la bibliothèque, du plugin ou de toute autre dépendance.

  • TargetVersion TargetVersion : version de la dépendance vers laquelle effectuer la mise à niveau.

  • VersionProperty (facultatif) - Version de la dépendance que vous définissez, telle que définie avec la properties balise dans le pom.xml fichier de votre application.

  • OriginType : indique si la dépendance est de première ou de troisième partie, spécifiée par FIRST_PARTY ou THIRD_PARTY.

Voici un exemple de fichier YAML de mise à niveau des dépendances et la configuration requise pour qu'Amazon Q puisse l'analyser :

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"

Étape 4 : Transformez votre code

Avant de transformer votre propre code, vous souhaiterez peut-être vérifier que votre IDE est correctement configuré 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 la configuration de votre IDE, téléchargez et décompressez l'exemple de projet, puis effectuez les étapes suivantes pour votre IDE. 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, votre IDE n'est pas configuré correctement. Pour résoudre les problèmes de configuration, consultez Étape 2 : Configuration de votre projet etRésolution des problèmes.

Note

N'éteignez pas ou ne fermez pas votre machine locale pendant la transformation du code, car la compilation côté client nécessite une connexion réseau stable.

Pour mettre à niveau la version linguistique de votre projet ou module de code, procédez comme suit pour votre IDE.

JetBrains

  1. Ouvrez le module dans lequel vous souhaitez effectuer la mise à niveauJetBrains. Assurez-vous d'avoir correctement créé votre projet dans l'IDE.

  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 la liste déroulante, puis choisissez Transformer.

  4. Amazon Q vous invite à fournir un fichier de dépendance de mise à niveau. Si vous avez configuré un fichier YAML avec les dépendances et la version vers lesquelles effectuer la mise à niveau, ajoutez votre fichier. Amazon Q validera le fichier pour s'assurer qu'il est correctement configuré. Si un message d'erreur s'affiche, vérifiez le format et les champs obligatoires décrits dansÉtape 3 : créer un fichier de mise à niveau des dépendances (facultatif).

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

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

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

  8. 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, sélectionnez 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 que vous avez correctement créé votre projet dans l'IDE.

  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 de l'IDE.

  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 à votre JDK. Pour plus d'informations, consultez la section Configurer votre VS Code projet.

  6. Amazon Q vous invite à fournir un fichier de dépendance de mise à niveau. Si vous avez configuré un fichier YAML avec les dépendances et la version vers lesquelles effectuer la mise à niveau, ajoutez votre fichier. Amazon Q validera le fichier pour s'assurer qu'il est correctement configuré. Si un message d'erreur s'affiche, vérifiez le format et les champs obligatoires décrits dansÉtape 3 : créer un fichier de mise à niveau des dépendances (facultatif).

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

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

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

  10. Pour obtenir des informations sur la manière dont votre code a été mis à niveau et sur les prochaines étapes 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.