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 de nouvelles versions de langage 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 le crée d’abord dans la version de langage source, puis vérifie qu’il contient les informations nécessaires pour effectuer la transformation. Une fois que votre code a été transformé avec succès, vous vérifiez et acceptez les modifications dans votre IDE. Dans la mesure où Amazon Q Developer effectue 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 manière dont Amazon Q transforme votre code, consultez Comment Amazon Q Developer transforme le code pour les mises à niveau du langage Java.

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.

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

Étape 1 : Prérequis

Avant de continuer, vérifiez que vous avez bien terminé les étapes de Configuration d’Amazon Q dans votre IDE.

Avant de commencer une tâche de transformation de code, vérifiez que les prérequis suivants sont respectés :

Étape 2 : configuration de votre projet Maven

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

Configuration d’un projet dans JetBrains

Pour configurer votre projet dans JetBrains, 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 langage que votre projet, vous n’aurez pas besoin de mettre à jour les paramètres de module.

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

Configuration d’un projet dans VS Code

Pour configurer votre projet en VS Code, le projet doit contenir les éléments suivants :

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

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

Après l’installation de Maven, ajoutez-le à votre variable PATH. Pour plus d’informations, consultez Comment ajouter Maven à mon PATH ?. Votre variable runtime Java doit également pointer vers un JDK et non vers un JRE. Pour vérifier que votre configuration est correcte, exécutez mvn -v. La sortie doit afficher votre version Maven et la variable runtime pointant vers le chemin d’accès à votre JDK.

Étape 3 : création d’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 cadres 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 Création du code 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, vérifiez d’abord que le fichier a été configuré correctement. Les champs suivants sont obligatoires dans le fichier YAML :

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 : transformation de votre code

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 Maven et Résolution de problème.

Suivez ces étapes pour mettre à niveau la version du langage de codage de votre projet ou de votre module de code.

JetBrains

1. Ouvrez le module dans lequel vous souhaitez mettre à niveau JetBrains. Assurez-vous d’avoir généré correctement votre projet dans l’IDE.

2. Choisissez le logo Amazon Q et demandez à Amazon Q de transformer votre application dans le panneau de discussion qui s'ouvre.

3. La fenêtre contextuelle Transformer votre application s’affiche. Choisissez le projet que vous souhaitez mettre à niveau dans la liste déroulante, puis 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-le. Amazon Q validera le fichier pour s’assurer qu’il a été configuré correctement. Si un message d’erreur s’affiche, vérifiez le format et les champs obligatoires décrits dans Étape 3 : création d’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 Afficher la comparaison. Dans la fenêtre Appliquer le correctif qui apparaît, choisissez un fichier pour ouvrir une vue comparative comportant votre code source et le code mis à niveau.

7. Pour accepter les modifications apportées par Amazon Q, choisissez Afficher la comparaison 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, choisissez Afficher le résumé de la transformation.

Code Visual Studio

1. Ouvrez le projet ou l’espace de travail que vous souhaitez mettre à niveau dans VS Code. Assurez-vous d’avoir bien créé votre projet dans l’IDE.

2. Choisissez le logo Amazon Q et demandez à Amazon Q de transformer votre application dans le panneau de discussion 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é, saisissez le chemin d’accès JAVA_HOME de votre JDK. Pour plus d’informations, consultez Configuration de votre projet VS Code.

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-le. Amazon Q validera le fichier pour s’assurer qu’il a été configuré correctement. Si un message d’erreur s’affiche, vérifiez le format et les champs obligatoires décrits dans Étape 3 : création d’un fichier de mise à niveau des dépendances (facultatif).

7. Amazon Q entame la transformation. Vous pouvez consulter la progression dans l’onglet Hub de transformation.

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 comparative 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, puis 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, accédez au Hub de transformation, cliquez sur le bouton avec les points de suspension Vues et autres actions, puis sur Afficher le résumé de la transformation.