高級套件IBM Bob Java Modernization 進階套件

先決條件

在使用 IBM Bob 啟動 Java Modernization 工作流程之前,查看系統、環境和專案要求。

在啟動 Java Modernization 工作流程之前,請查看這些要求。充分準備的專案可以實現更快、更準確的分析,並在遷移過程中減少中斷。

系統要求

要求詳細資訊
Java Development Kit (JDK)最低 JDK 8。建議預先安裝目標 JDK 版本(例如 JDK 21)。Bob 可以透過 SDKMan 或 WinGet 安裝目標版本。
IBM Bob版本 2.0.0 或更高,已安裝並已驗證。
Java Modernization 套件IBM Bob Premium Package for Java Modernization 的有效授權。
Git如果使用 Git flow 功能進行分支和 pull request 管理,則需要。

SDKMan 是管理 Java 版本安裝的必要工具。Bob 在工作流程期間檢查 SDKMan,如果未偵測到可能會提示你安裝它。

注意:

要在 shell 中初始化 SDKMan,請確保它已在 shell 設定檔(~/.bashrc~/.zshrc)中設定為來源。安裝後重新啟動終端機工作階段。

WinGet(Windows Package Manager)是 Java 安裝管理所必需的。

注意:

安裝 WinGet 後,重新啟動 IBM Bob 和任何開啟的終端機工作階段,以便 Bob 能在更新的 PATH 上偵測到它。

專案要求

建置設定

在啟動任何工作流程之前,你的專案必須滿足以下要求:

  • 存在有效的 Maven(pom.xml)或 Gradle(build.gradle)建置設定。
  • 在 IDE 中以正確的根層級開啟專案。
  • 原始碼採用標準目錄結構(src/main/javasrc/test/java)。
  • 所有相依性已解析,專案能成功編譯。
開啟你的專案:
  • 單模組專案:開啟包含主 pom.xmlbuild.gradle 的資料夾。
  • 多模組專案:開啟父專案根目錄。確保所有模組都在父 POM 中列出,且模組間相依性正確設定。
  • 多專案工作區:當 Bob 提示時,選擇正確的專案根目錄。

版本控制

使用乾淨的工作目錄初始化 Git。開始前提交或暫存任何未提交的變更。

建立專用的遷移分支:

git checkout -b java-modernization

環境設定

啟動工作流程之前,確保你的環境已準備好:

  • 建置工具(Maven 或 Gradle)已安裝和設定。
  • 終端機存取可用於執行建置和測試。
  • 網路存取可用於相依性下載。
  • 不必要的檔案和編輯器已關閉。
  • 建置產物已清除(可選但建議)。

.bobignore 設定

設定 .bobignore 以保護敏感檔案,並從 Bob 的分析中排除雜訊。該檔案使用 .gitignore 格式,位於 .bob/.bobignore

排除項目:

  • 大型相依性和建置產物
  • 測試資料檔案
  • 敏感設定檔

工作流程特定要求

備份和安全

啟動任何工作流程之前:

建立專案檔案的最新備份,確保 Git 儲存庫乾淨且所有變更已提交。通知團隊現代化工作正在進行中。

這個主題如何?