incubator kie optaplanner

面向软件开发人员的快速、易于使用的开源 AI 约束求解器

正在寻找快速入门？

OptaPlanner 的快速入门位于 optaplanner-quickstarts 存储库中。

快速开发启动

从源代码构建并运行：

 $ mvn clean install -Dquickly
$ cd optaplanner-示例
$ mvn 执行：java

要使用 IntelliJ IDEA、Eclipse 或 VSCode 进行开发，请将根pom.xml作为新项目打开，并配置运行/调试配置，如下所示：

• 类型：应用程序

• 主类： org.optaplanner.examples.app.OptaPlannerExamplesApp

• VM选项： -Xmx2G -server （仅在使用示例中的大数据集时才需要内存）

• 程序参数：（无）

• 工作目录： $MODULE_DIR$ （必须解析为 optaplanner-examples 目录）

• 使用模块的类路径： optaplanner-examples

为 OptaPlanner 做出贡献

这是一个开源项目，非常欢迎您贡献❤️！

• 如果您刚刚开始使用 OptaPlanner 并希望做出贡献，请查看我们的入门问题。它们经过专门选择，以便让首次贡献者更容易使用。

• 如果您想做出贡献或发起固执己见的讨论，请加入我们的讨论或直接发送电子邮件至 [email protected]。

• 如果您想提交问题，请查看 OptaPlanner Jira 项目。

是时候做出改变了吗？

每项更改都必须通过 GitHub 拉取请求 (PR) 提交。 OptaPlanner 使用持续集成 (CI)。在您提交 PR 后，OptaPlanner CI 会对您的分支运行检查，以确保您的 PR 不会引入错误。如果 CI 发现潜在问题，我们友好的 PR 维护人员将帮助您解决它。

贡献

1. 分叉它（https://github.com/kiegroup/optaplanner）。

2. 创建您的功能分支：（ git checkout -b feature ）。

3. 通过评论提交您的更改：( git commit -am 'Add some feature' )。

4. 推送到 GitHub 的分支：（ git push origin feature ）。

5. 创建一个新的拉取请求。

代码标准

在每次 Maven 构建期间，您的代码都会根据导入和代码样式约定自动格式化。 CI 检查也强制执行这些约定，因此请务必在创建 PR 之前使用 Maven 构建项目：

 mvn 干净安装

有关如何设置代码样式检查的信息，请参阅 IDE 设置说明。

构建您的 OptaPlanner 项目

使用以下方法之一构建您的 OptaPlanner 项目：

• build-fast : mvn clean install -Dquickly跳过任何检查和代码分析（约 1 分钟）

• ？正常构建： mvn clean install运行测试，检查代码风格，跳过文档（约 17 分钟）

• ？ build-doc ：在optaplanner/optaplanner-docs处进行mvn clean install创建 asciidoctor 文档target/optaplanner-docs-*/html_single/index.html （~2 分钟）

• ？ build-all : mvn clean install -Dfull运行所有检查 + 创建文档和分发文件（约 20 分钟）

OptaPlanner CI 状态

您可以从链状态网页检查 OptaPlanner 存储库的 CI 状态。

Jenkins CI 工作（需要 VPN 访问）

所有 Jenkins 作业都可以在 OptaPlanner 文件夹下找到：https://eng-jenkins-csb-business-automation.apps.ocp-c1.prod.psi.redhat.com/job/KIE/job/optaplanner

有趣的 Jenkins CI 工作（需要 VPN 访问）：

• 更新 Quarkus 版本

• 更新 Drools 版本

• 发布管道（仅在发布分支上可用）

• 发布后管道（仅在发布分支上可用）