Wymagania wstępne
Przejrzyj wymagania systemowe, środowiskowe i projektowe przed uruchomieniem przepływu pracy Java Modernization z IBM Bob.
Przejrzyj te wymagania przed uruchomieniem przepływu pracy Java Modernization. Dobrze przygotowany projekt prowadzi do szybszej i dokładniejszej analizy oraz mniejszej liczby przerw podczas migracji.
Wymagania systemowe
| Wymaganie | Szczegóły |
|---|---|
| Java Development Kit (JDK) | Minimalnie JDK 8. Zaleca się wstępną instalację docelowej wersji JDK (na przykład JDK 21). Bob może instalować wersje docelowe za pomocą SDKMan lub WinGet. |
| IBM Bob | Wersja 2.0.0 lub nowsza, zainstalowana i uwierzytelniona. |
| Pakiet Java Modernization | Aktywna licencja na IBM Bob Premium Package dla Java Modernization. |
| Git | Wymagany, jeśli używasz funkcji Git flow do zarządzania gałęziami i pull requestami. |
SDKMan jest wymagany do zarządzania instalacjami wersji Java. Bob sprawdza obecność SDKMan podczas przepływu pracy i może poprosić o jego instalację, jeśli nie zostanie wykryty.
Aby zainicjować SDKMan w swoim shellu, upewnij się, że jest on uwzględniony w profilu shella (~/.bashrc lub ~/.zshrc). Uruchom ponownie sesję terminala po instalacji.
WinGet (Windows Package Manager) jest wymagany do zarządzania instalacją Java.
Po zainstalowaniu WinGet uruchom ponownie IBM Bob i wszystkie otwarte sesje terminala, aby Bob mógł go wykryć na zaktualizowanej ścieżce PATH.
Wymagania projektowe
Konfiguracja budowania
Twój projekt musi spełniać te wymagania przed uruchomieniem jakiegokolwiek przepływu pracy:
- Prawidłowa konfiguracja budowania Maven (
pom.xml) lub Gradle (build.gradle) jest obecna. - Projekt otwarty na właściwym poziomie głównym w Twoim IDE.
- Kod źródłowy w standardowej strukturze katalogów (
src/main/java,src/test/java). - Wszystkie zależności rozwiązane i projekt kompilujący się pomyślnie.
- Projekty jednomódułowe: Otwórz folder zawierający Twój główny
pom.xmllubbuild.gradle. - Projekty wielomódułowe: Otwórz główny katalog projektu nadrzędnego. Upewnij się, że wszystkie moduły są wymienione w nadrzędnym POM i zależności między modułami są prawidłowo skonfigurowane.
- Workspace z wieloma projektami: Wybierz właściwy główny katalog projektu, gdy Bob o to poprosi.
Kontrola wersji
Zainicjuj Git z czystym katalogiem roboczym. Zatwierdź lub zapisz w stash wszelkie niezatwierdzone zmiany przed rozpoczęciem.
Utwórz dedykowaną gałąź migracji:
git checkout -b java-modernizationKonfiguracja środowiska
Przed uruchomieniem przepływu pracy upewnij się, że Twoje środowisko jest gotowe:
- Narzędzie budowania (Maven lub Gradle) zainstalowane i skonfigurowane.
- Dostęp do terminala dostępny do uruchamiania buildów i testów.
- Dostęp do sieci dostępny do pobierania zależności.
- Niepotrzebne pliki i edytory zamknięte.
- Artefakty budowania wyczyszczone (opcjonalne, ale zalecane).
Konfiguracja .bobignore
Skonfiguruj .bobignore, aby chronić wrażliwe pliki i wykluczyć szum z analizy Boba. Plik używa formatu .gitignore i znajduje się w .bob/.bobignore.
Wyklucz:
- Duże zależności i artefakty budowania
- Pliki danych testowych
- Wrażliwe pliki konfiguracyjne
Wymagania specyficzne dla przepływu pracy
Backup i bezpieczeństwo
Przed uruchomieniem jakiegokolwiek przepływu pracy:
Utwórz niedawną kopię zapasową plików projektu i upewnij się, że Twoje repozytorium Git jest czyste ze wszystkimi zatwierdzonymi zmianami. Powiadom swój zespół, że prace modernizacyjne są w toku.