Prerequisiti
Verifica i requisiti di sistema, ambiente e progetto prima di avviare un workflow Java Modernization con IBM Bob.
Verifica questi requisiti prima di avviare un workflow Java Modernization. Un progetto ben preparato porta a un'analisi più rapida e accurata, con meno interruzioni durante la migrazione.
Requisiti di sistema
| Requisito | Dettagli |
|---|---|
| Java Development Kit (JDK) | JDK 8 minimo. Si raccomanda di pre-installare la versione JDK di destinazione (ad esempio, JDK 21). Bob può installare le versioni di destinazione tramite SDKMan o WinGet. |
| IBM Bob | Versione 2.0.0 o successiva, installata e autenticata. |
| Pacchetto Java Modernization | Licenza attiva per IBM Bob Premium Package per Java Modernization. |
| Git | Richiesto se utilizzi le funzionalità Git flow per la gestione di branch e pull request. |
SDKMan è richiesto per gestire le installazioni delle versioni Java. Bob controlla la presenza di SDKMan durante il workflow e potrebbe chiederti di installarlo se non viene rilevato.
Per inizializzare SDKMan nella tua shell, assicurati che sia incluso nel tuo profilo shell (~/.bashrc o ~/.zshrc). Riavvia la sessione del terminale dopo l'installazione.
WinGet (Windows Package Manager) è richiesto per la gestione delle installazioni Java.
Dopo aver installato WinGet, riavvia IBM Bob e qualsiasi sessione del terminale aperta in modo che Bob possa rilevarlo nel PATH aggiornato.
Requisiti del progetto
Configurazione del build
Il tuo progetto deve soddisfare questi requisiti prima di avviare qualsiasi workflow:
- Configurazione di build Maven (
pom.xml) o Gradle (build.gradle) valida presente. - Progetto aperto al livello radice corretto nel tuo IDE.
- Codice sorgente in una struttura di directory standard (
src/main/java,src/test/java). - Tutte le dipendenze risolte e il progetto compilato correttamente.
- Progetti a modulo singolo: Apri la cartella contenente il tuo
pom.xmlobuild.gradleprincipale. - Progetti multi-modulo: Apri la radice del progetto padre. Assicurati che tutti i moduli siano elencati nel POM padre e che le dipendenze tra moduli siano configurate correttamente.
- Workspace con più progetti: Seleziona la radice del progetto corretta quando richiesto da Bob.
Controllo versione
Inizializza Git con una directory di lavoro pulita. Esegui il commit o lo stash delle modifiche non committate prima di iniziare.
Crea un branch di migrazione dedicato:
git checkout -b java-modernizationConfigurazione dell'ambiente
Prima di avviare un workflow, assicurati che il tuo ambiente sia pronto:
- Strumento di build (Maven o Gradle) installato e configurato.
- Accesso al terminale disponibile per eseguire build e test.
- Accesso alla rete disponibile per i download delle dipendenze.
- File non necessari ed editor chiusi.
- Artefatti di build rimossi (opzionale ma consigliato).
Configurazione di .bobignore
Configura .bobignore per proteggere i file sensibili ed escludere il rumore dall'analisi di Bob. Il file usa il formato .gitignore e si trova in .bob/.bobignore.
Escludere:
- Dipendenze di grandi dimensioni e artefatti di build
- File di dati di test
- File di configurazione sensibili
Requisiti specifici del workflow
Backup e sicurezza
Prima di avviare qualsiasi workflow:
Crea un backup recente dei file del tuo progetto e assicurati che il tuo repository Git sia pulito con tutte le modifiche committate. Informa il tuo team che il lavoro di modernizzazione è in corso.