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 版本

• 發布管道（僅在發布分支上可用）

• 發布後管道（僅在發布分支上可用）