高级套件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 仓库干净且所有更改已提交。通知团队现代化工作正在进行中。

这个主题怎么样?