Prérequis
Vérifie les exigences système, d'environnement et de projet avant de démarrer un workflow Java Modernization avec IBM Bob.
Vérifie ces exigences avant de lancer un workflow Java Modernization. Un projet bien préparé conduit à une analyse plus rapide et plus précise, avec moins d'interruptions pendant la migration.
Exigences système
| Exigence | Détails |
|---|---|
| Java Development Kit (JDK) | JDK 8 minimum. La pré-installation de la version JDK cible (par exemple, JDK 21) est recommandée. Bob peut installer les versions cibles via SDKMan ou WinGet. |
| IBM Bob | Version 2.0.0 ou ultérieure, installée et authentifiée. |
| Package Java Modernization | Licence active pour IBM Bob Premium Package pour Java Modernization. |
| Git | Requis si tu utilises les fonctionnalités Git flow pour la gestion des branches et des pull requests. |
SDKMan est requis pour gérer les installations de versions Java. Bob vérifie la présence de SDKMan pendant le workflow et peut te demander de l'installer s'il n'est pas détecté.
Pour initialiser SDKMan dans ton shell, assure-toi qu'il est sourcé dans ton profil shell (~/.bashrc ou ~/.zshrc). Redémarre ta session terminal après l'installation.
WinGet (Windows Package Manager) est requis pour la gestion des installations Java.
Après avoir installé WinGet, redémarre IBM Bob et toutes les sessions terminal ouvertes pour que Bob puisse le détecter sur le PATH mis à jour.
Exigences du projet
Configuration du build
Ton projet doit satisfaire ces exigences avant de démarrer un workflow :
- Configuration de build Maven (
pom.xml) ou Gradle (build.gradle) valide présente. - Projet ouvert au bon niveau racine dans ton IDE.
- Code source dans une structure de répertoires standard (
src/main/java,src/test/java). - Toutes les dépendances résolues et le projet compilant correctement.
- Projets mono-module : Ouvre le dossier contenant ton
pom.xmloubuild.gradleprincipal. - Projets multi-modules : Ouvre la racine du projet parent. Assure-toi que tous les modules sont listés dans le POM parent et que les dépendances inter-modules sont correctement configurées.
- Espaces de travail multi-projets : Sélectionne la racine de projet correcte lorsque Bob te le demande.
Contrôle de version
Initialise Git avec un répertoire de travail propre. Committe ou mets en stash les modifications non commitées avant de commencer.
Crée une branche de migration dédiée :
git checkout -b java-modernizationConfiguration de l'environnement
Avant de démarrer un workflow, assure-toi que ton environnement est prêt :
- Outil de build (Maven ou Gradle) installé et configuré.
- Accès au terminal disponible pour exécuter les builds et les tests.
- Accès réseau disponible pour les téléchargements de dépendances.
- Fichiers inutiles et éditeurs fermés.
- Artefacts de build nettoyés (optionnel mais recommandé).
Configuration de .bobignore
Configure .bobignore pour protéger les fichiers sensibles et exclure le bruit de l'analyse de Bob. Le fichier utilise le format .gitignore et se trouve dans .bob/.bobignore.
Exclure :
- Les grandes dépendances et artefacts de build
- Les fichiers de données de test
- Les fichiers de configuration sensibles
Exigences spécifiques aux workflows
Sauvegarde et sécurité
Avant de démarrer un workflow :
Crée une sauvegarde récente de tes fichiers de projet et assure-toi que ton dépôt Git est propre avec toutes les modifications commitées. Informe ton équipe que le travail de modernisation est en cours.