Démarrage rapide : mettre à niveau un projet Java avec la modernisation des applications GitHub Copilot

Les mises à niveau Java de modernisation des applications prennent en charge les scénarios suivants :

• Mettez à niveau le Kit de développement Java (JDK) vers Java 8, 11, 17, 21 ou 25.
• Mettez à niveau Spring Boot jusqu’à la version 3.5.
• Mettez à niveau Spring Framework jusqu’à la version 6.2+.
• Mettez à niveau Java EE vers Jakarta EE, jusqu’à Jakarta EE 10.
• Mettez à niveau JUnit.
• Mettez à niveau les dépendances tierces vers une version spécifiée.
• Mettez à niveau Ant vers maven build.

Ce guide de démarrage rapide vous montre comment mettre à niveau un projet Java à l’aide de la modernisation des applications GitHub Copilot.

Prerequisites

• Un compte GitHub avec GitHub Copilot activé. Un niveau gratuit, Pro, Pro+, Business ou Enterprise est requis.
• L’un des IDE suivants :
  • Dernière version de Visual Studio Code. Doit être version 1.101 ou ultérieure.
    • GitHub Copilot dans Visual Studio Code. Pour obtenir des instructions d’installation, consultez Configurer GitHub Copilot dans Visual Studio Code. Veillez à vous connecter à votre compte GitHub dans Visual Studio Code.
    • Modernisation des applications GitHub Copilot. Redémarrez Visual Studio Code après l’installation.
  • Dernière version d’IntelliJ IDEA. Doit être version 2023.3 ou ultérieure.
    • GitHub Copilot. Doit être version 1.5.59 ou ultérieure. Pour plus d’instructions, consultez Configurer GitHub Copilot dans IntelliJ IDEA. Veillez à vous connecter à votre compte GitHub dans IntelliJ IDEA.
    • Modernisation des applications GitHub Copilot. Redémarrez IntelliJ IDEA après l’installation. Si gitHub Copilot n’est pas installé, vous pouvez installer directement la modernisation des applications GitHub Copilot.
    • Pour une utilisation plus efficace de Copilot dans la modernisation des applications : dans les paramètres IntelliJ IDEA, sélectionnez la fenêtre de configuration Outils>GitHub Copilot , puis sélectionnez Approbation automatique et approbation automatique des annotations des outils MCP. Pour plus d’informations, consultez Configurer les paramètres de modernisation des applications GitHub Copilot pour optimiser l’expérience pour IntelliJ.
• JDK Java pour les versions de JDK source et cible.
• Maven ou Gradle pour générer des projets Java.
• Un projet Java géré par Git à l’aide de Maven ou Gradle.
• Pour les projets Basés sur Maven : accès au référentiel Maven Central public.
• Dans les paramètres de Visual Studio Code, assurez-vous que chat.extensionTools.enabled est défini sur true. Ce paramètre peut être contrôlé par votre organisation.

Connectez-vous pour utiliser Copilot, puis installez l’extension requise

Pour utiliser GitHub Copilot, connectez-vous à votre compte GitHub dans Visual Studio Code. Sélectionnez l’icône Copilot en haut de Visual Studio Code pour accéder au volet GitHub Copilot. Pour plus d’informations sur la configuration de GitHub Copilot, consultez Configurer GitHub Copilot dans VS Code.

Ensuite, procédez comme suit pour installer l’extension dans Visual Studio Code :

1. Dans Visual Studio Code, ouvrez la vue Extensions à partir de la barre d’activité.
2. Recherchez GitHub Copilot app modernization sur le Marketplace.
3. Sélectionnez la modernisation des applications GitHub Copilot.
4. Dans la page de l’extension, sélectionnez Installer.
5. Redémarrez Visual Studio Code.

Une fois l’installation terminée, vous devez voir une notification dans le coin de Visual Studio Code confirmant la réussite.

Pour plus d’informations, consultez Installer une extension VS Code.

Sélectionner un projet Java à mettre à niveau

Pour les besoins de ce didacticiel, choisissez l’un des exemples de référentiels suivants :

• Maven : uportal-messaging
• Gradle : docraptor-java

Lancez le mode agent Copilot GitHub et démarrez la mise à niveau

Procédez comme suit pour lancer le mode agent Copilot GitHub et démarrer le processus de mise à niveau :

1. Ouvrez le projet Java sélectionné dans Visual Studio Code.

2. Ouvrez le panneau GitHub Copilot Chat.

3. Basculez vers le mode Agent.

4. Entrez une invite telle que mettre à niveau le projet vers Java 21 à l’aide des outils de mise à niveau Java ou mettre à niveau le projet vers Java 21 et Spring Boot 3.2 à l’aide des outils de mise à niveau Java pour inclure des informations sur le cadre.

   Note

   Si vous devez mettre à niveau une infrastructure ou une dépendance tierce uniquement, consultez Mettre à niveau une infrastructure ou une dépendance tierce à l’aide de la modernisation de l’application Copilot GitHub.

5. Lorsque vous y êtes invité, sélectionnez Continuer pour générer un plan de mise à niveau.

Passer en revue et modifier le plan de mise à niveau

La modernisation des applications Copilot GitHub analyse le projet Java dans l’espace de travail actuel, y compris son JDK, ses outils de génération et ses dépendances. L’outil génère un fichier plan.md qui décrit les modifications planifiées suivantes :

• Versions de JDK source et cible.
• Chemins de mise à niveau de l’infrastructure et de la bibliothèque.

Passez en revue le plan et apportez des modifications si nécessaire, puis sélectionnez Continuer à continuer. Pour plus d’informations sur la personnalisation, telles que l’ajout de paramètres d’outil de génération supplémentaires, consultez Personnaliser le plan de mise à niveau.

Appliquer des modifications de code et résoudre les problèmes de génération

GitHub Copilot poursuit ensuite la phase de transformation de code du projet. Il utilise un outil open source appelé OpenRewrite pour implémenter des modifications de code basées sur des recettes spécifiques. Ensuite, l’IA résout les problèmes restants par le biais d’une boucle de génération/correctif dynamique. Vous pouvez surveiller la progression dans la zone d’éditeur de Visual Studio Code en vérifiant le fichier markdown progress.md à tout moment.

À différentes étapes du processus, GitHub Copilot vous invite à continuer.

Pour confirmer l’étape de transformation OpenRewrite , sélectionnez Continuer à mettre à niveau le code Java à l’aide d’OpenRewrite. Cette étape peut prendre quelques minutes.

Pour approuver l’étape de boucle de génération/correction dynamique , sélectionnez Continuer à générer le projet et corriger les erreurs.

Copilot itère et continue de corriger les erreurs jusqu’à ce qu’il n’y ait plus de problèmes. La progression s’affiche dans un fichier progress.md . La boucle se répète jusqu’à ce que le projet soit compilé avec succès.

Rechercher les vulnérabilités et les modifications de comportement du code

Dans certaines circonstances, la mise à niveau peut entraîner des modifications de comportement du code ou introduire des bibliothèques avec des problèmes courants de vulnérabilités et d’exposition (CVE). L’outil effectue une vérification supplémentaire de ces problèmes.

Lorsque GitHub Copilot invite à Exécuter Valider si des dépendances modifiées ont des CVEs connues, sélectionnez Continuer.

Si des CVE sont trouvées, le mode agent Copilot GitHub tente de les corriger. Passez en revue les modifications apportées à VS Code et déterminez s’il faut les conserver.

Une fois la vérification CVE effectuée, lorsque vous êtes invité à valider la cohérence du comportement du code, sélectionnez Continuer.

Si des problèmes sont détectés, le mode agent Copilot GitHub tente de les résoudre. Déterminez s’il faut conserver ou ignorer les modifications.

Une fois les vérifications terminées, GitHub Copilot reconstruit le projet et réexécute les vérifications précédentes.

Si des problèmes mineurs restent qui ne nécessitent pas de correctifs immédiats, la mise à niveau est terminée. Dans le cas contraire, GitHub Copilot revient pour les traiter.

Consulter le résumé

Après la mise à niveau, l’outil génère un résumé dans le fichier summary.md , qui inclut les informations suivantes :

• Informations sur le projet.
• Lignes de code modifiées.
• Dépendances mises à jour.
• Modifications de code résumées.
• Correction des problèmes de sécurité CVE et d'incohérence de code, le cas échéant.
• Problèmes DE CVE mineurs non traités.

Étape suivante

Démarrage rapide : générer des tests unitaires avec la modernisation des applications GitHub Copilot