Prasyarat
Persyaratan sistem sebelum menginstal IBM Bob Premium Package for Java Modernization.
Tinjau requirement ini sebelum memulai workflow Java Modernization. Project yang dipersiapkan dengan baik akan menghasilkan analisis yang lebih cepat, lebih akurat, dan lebih sedikit gangguan selama migrasi.
System requirements
| Requirement | Details |
|---|---|
| Java Development Kit (JDK) | Minimal JDK 8. Disarankan untuk menginstal terlebih dahulu versi target JDK (misalnya JDK 21). Bob dapat menginstal versi target melalui SDKMan atau WinGet. |
| IBM Bob | Versi 2.0.0 atau lebih baru, sudah terinstal dan terautentikasi. |
| Java Modernization package | Lisensi aktif untuk IBM Bob Premium Package for Java Modernization. |
| Git | Diperlukan jika kamu menggunakan fitur Git flow untuk manajemen branch dan pull request. |
SDKMan diperlukan untuk mengelola instalasi versi Java. Bob memeriksa keberadaan SDKMan selama workflow dan mungkin akan meminta kamu menginstalnya jika tidak terdeteksi.
Untuk menginisialisasi SDKMan di shell kamu, pastikan SDKMan di-source di profile shell (~/.bashrc atau ~/.zshrc). Restart sesi terminal kamu setelah instalasi.
WinGet (Windows Package Manager) diperlukan untuk pengelolaan instalasi Java.
Setelah menginstal WinGet, restart IBM Bob dan semua sesi terminal yang terbuka agar Bob bisa mendeteksinya di PATH yang sudah diperbarui.
Project requirements
Build configuration
Project kamu harus memenuhi requirement ini sebelum memulai workflow apa pun:
- Konfigurasi build Maven (
pom.xml) atau Gradle (build.gradle) yang valid tersedia. - Project dibuka pada level root yang benar di IDE kamu.
- Source code berada dalam struktur direktori standar (
src/main/java,src/test/java). - Semua dependency sudah ter-resolve dan project berhasil di-compile.
- Single-module projects: Buka folder yang berisi
pom.xmlataubuild.gradleutama. - Multi-module projects: Buka root project parent. Pastikan semua module terdaftar di parent POM dan dependency antar-module dikonfigurasi dengan benar.
- Multiple-project workspaces: Pilih root project yang benar saat diminta oleh Bob.
Version control
Inisialisasi Git dengan working directory yang bersih. Commit atau stash semua perubahan yang belum di-commit sebelum memulai.
Buat branch migrasi khusus:
git checkout -b java-modernizationEnvironment setup
Sebelum memulai workflow, pastikan lingkungan kamu sudah siap:
- Build tool (Maven atau Gradle) sudah terinstal dan dikonfigurasi.
- Akses terminal tersedia untuk menjalankan build dan test.
- Akses jaringan tersedia untuk download dependency.
- File dan editor yang tidak perlu sudah ditutup.
- Artifact build sudah dibersihkan (opsional tetapi direkomendasikan).
.bobignore configuration
Konfigurasikan .bobignore untuk melindungi file sensitif dan mengecualikan noise dari analisis Bob. File ini menggunakan format .gitignore dan berada di .bob/.bobignore.
Kecualikan:
- Dependency besar dan artifact build
- File data test
- File konfigurasi sensitif
Workflow-specific requirements
Backup and safety
Sebelum memulai workflow apa pun:
Buat backup terbaru dari file project kamu dan pastikan repository Git kamu bersih dengan semua perubahan sudah di-commit. Beri tahu timmu bahwa pekerjaan modernisasi sedang berlangsung.