Voraussetzungen
Überprüfe die System-, Umgebungs- und Projektanforderungen, bevor du einen Java Modernization Workflow mit IBM Bob startest.
Überprüfe diese Anforderungen, bevor du einen Java Modernization Workflow startest. Ein gut vorbereitetes Projekt führt zu einer schnelleren, genaueren Analyse und weniger Unterbrechungen während der Migration.
Systemanforderungen
| Anforderung | Details |
|---|---|
| Java Development Kit (JDK) | Mindestens JDK 8. Die Vorinstallation der Ziel-JDK-Version (z. B. JDK 21) wird empfohlen. Bob kann Zielversionen über SDKMan oder WinGet installieren. |
| IBM Bob | Version 2.0.0 oder höher, installiert und authentifiziert. |
| Java Modernization Package | Aktive Lizenz für das IBM Bob Premium Package für Java Modernization. |
| Git | Erforderlich, wenn du Git-Flow-Funktionen für Branch- und Pull-Request-Management verwendest. |
SDKMan ist für die Verwaltung von Java-Versionsinstallationen erforderlich. Bob prüft während des Workflows auf SDKMan und fordert dich möglicherweise zur Installation auf, wenn es nicht erkannt wird.
Um SDKMan in deiner Shell zu initialisieren, stelle sicher, dass es in deinem Shell-Profil (~/.bashrc oder ~/.zshrc) als Quelle eingetragen ist. Starte deine Terminal-Sitzung nach der Installation neu.
WinGet (Windows Package Manager) ist für die Java-Installationsverwaltung erforderlich.
Nach der Installation von WinGet starte IBM Bob und alle offenen Terminal-Sitzungen neu, damit Bob es im aktualisierten PATH erkennen kann.
Projektanforderungen
Build-Konfiguration
Dein Projekt muss diese Anforderungen erfüllen, bevor du einen Workflow startest:
- Gültige Maven (
pom.xml) oder Gradle (build.gradle) Build-Konfiguration vorhanden. - Projekt auf der richtigen Stammebene in deiner IDE geöffnet.
- Quellcode in einer Standard-Verzeichnisstruktur (
src/main/java,src/test/java). - Alle Abhängigkeiten aufgelöst und das Projekt wird erfolgreich kompiliert.
- Einzelmodul-Projekte: Öffne den Ordner, der deine Haupt-
pom.xmloderbuild.gradleenthält. - Multimodul-Projekte: Öffne den übergeordneten Projekt-Root. Stelle sicher, dass alle Module im übergeordneten POM aufgelistet sind und Inter-Modul-Abhängigkeiten korrekt konfiguriert sind.
- Mehrere-Projekte-Workspaces: Wähle den richtigen Projekt-Root aus, wenn Bob dich dazu auffordert.
Versionskontrolle
Initialisiere Git mit einem sauberen Arbeitsverzeichnis. Committe oder stashe alle nicht committeten Änderungen, bevor du beginnst.
Erstelle einen dedizierten Migrations-Branch:
git checkout -b java-modernizationUmgebungs-Setup
Bevor du einen Workflow startest, stelle sicher, dass deine Umgebung bereit ist:
- Build-Tool (Maven oder Gradle) installiert und konfiguriert.
- Terminal-Zugang für das Ausführen von Builds und Tests verfügbar.
- Netzwerkzugang für Abhängigkeits-Downloads verfügbar.
- Unnötige Dateien und Editoren geschlossen.
- Build-Artefakte bereinigt (optional, aber empfohlen).
.bobignore-Konfiguration
Konfiguriere .bobignore, um sensible Dateien zu schützen und Rauschen aus der Analyse von Bob auszuschließen. Die Datei verwendet das .gitignore-Format und befindet sich unter .bob/.bobignore.
Ausschließen:
- Große Abhängigkeiten und Build-Artefakte
- Testdatendateien
- Sensible Konfigurationsdateien
Workflow-spezifische Anforderungen
Backup und Sicherheit
Bevor du einen Workflow startest:
Erstelle ein aktuelles Backup deiner Projektdateien und stelle sicher, dass dein Git-Repository sauber ist und alle Änderungen committed sind. Informiere dein Team, dass Modernisierungsarbeiten im Gange sind.