如何从OptaPlanner高效迁移至Timefold？

我们已将OptaPlanner分支为Timefold，针对代码库迁移的核心需求，以下是高效迁移的步骤：

1. 替换依赖项 #

Maven项目 #

打开pom.xml，将所有OptaPlanner依赖的groupId从org.optaplanner替换为ai.timefold.solver，同时更新版本号为Timefold的对应稳定版本：

<!-- 替换前 -->
<dependency>
    <groupId>org.optaplanner</groupId>
    <artifactId>optaplanner-core</artifactId>
    <version>X.Y.Z</version>
</dependency>

<!-- 替换后 -->
<dependency>
    <groupId>ai.timefold.solver</groupId>
    <artifactId>timefold-solver-core</artifactId>
    <version>A.B.C</version>
</dependency>

Gradle项目 #

修改build.gradle或build.gradle.kts，同步替换groupId和artifactId：

// 替换前
implementation 'org.optaplanner:optaplanner-core:X.Y.Z'

// 替换后
implementation 'ai.timefold.solver:timefold-solver-core:A.B.C'

2. 批量修改导入语句 #

利用IDE的全局替换功能（如IntelliJ IDEA的Edit > Find > Replace in Path、Eclipse的Search > File Search），批量替换所有Java/Kotlin文件中的导入路径：

• 将import org.optaplanner.统一替换为import ai.timefold.solver.
• 若使用OptaPlanner扩展模块（如持久化、Spring集成等），同步替换对应子包路径，例如org.optaplanner.persistence.jpa改为ai.timefold.solver.persistence.jpa

3. 适配细微API变更 #

Timefold保持了与OptaPlanner核心API的高度兼容性，但部分废弃API已被移除或重命名：

• 检查代码中是否使用OptaPlanner废弃类/方法，替换为Timefold提供的替代实现
• 自定义ScoreCalculator、SolverFactory特殊配置等场景，确认Timefold对应逻辑无变化（绝大多数场景无需额外调整）

4. 验证迁移结果 #

• 执行项目单元测试与集成测试，确保核心规划逻辑正常运行
• 启动应用，验证求解功能的正确性与性能表现

内容的提问来源于stack exchange，提问作者Geoffrey De Smet