使用 Java 適用的 OR-Tools Maven

簡介

本指南會透過簡易的工作範例協助您開始使用 Java 中的 OR-Tools。

雖然這些操作說明可能也適用於其他 MacOS 變化版本，但我們僅在符合下列條件的機器上測試這些方法：

  • MacOS 13.0.1 (Ventura) Intel 64 位元 (x86_64)
  • MacOS 13.0.1 (Ventura) M1 (arm64)

必備條件

以下各節說明安裝 OR-Tools 的必要條件。

Xcode 指令列工具

您必須安裝 Xcode 指令列工具。方法是開啟在 /Applications/Utilities/ 中找到的終端機，然後輸入：

xcode-select --install

按一下「安裝」即可下載並安裝 Xcode 指令列工具。您不需要從 App Store 中「取得 Xcode」。如果您的網際網路連線速度較慢，可能需要幾分鐘時間。

確認是否已成功安裝 Xcode 指令列工具：

xcode-select -p

畫面上會顯示下列訊息：

/Library/Developer/CommandLineTools

Homebrew

如要安裝其餘必要項目，建議您先安裝「missing macOS 適用的套件管理員」，否則該工具稱為 Homebrew。方法是開啟終端機視窗，然後輸入：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew update

如何確認是否已成功安裝組合：

brew --version

畫面上會顯示下列訊息：

Homebrew 1.6.9-8-g25542d7
Homebrew/homebrew-core (git revision 0e0c84; last commit 2018-06-20)

Java JDK

您必須安裝 Java JDK 8.0 以上版本。

安裝 Homebrew 後，您可以開啟終端機視窗並輸入以下指令，藉此安裝 openjdk：

brew install openjdk
sudo ln -sfn /usr/local/opt/openjdk/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk.jdk

接著，您必須匯出 JAVA_HOME 變數：

export JAVA_HOME=/Library/Java/JavaVirtualMachines/openjdk.jdk

Maven

您必須安裝 Maven。

安裝 Homebrew 後，您可以開啟終端機視窗並輸入以下指令，藉此安裝 maven：

brew install maven

您可以測試 Maven 已正確安裝，並使用下列指令找出 Java：

mvn -v

使用 Maven 安裝

如要在 Maven 應用程式中加入 OR-Tools，請在專案的 pom.xml 檔案中新增其構件的依附元件。比如

<!-- https://mvnrepository.com/artifact/com.google.ortools/ortools-java -->
<dependency>
    <groupId>com.google.ortools</groupId>
    <artifactId>ortools-java</artifactId>
    <version>9.9.3963</version>
</dependency>

取得 Java 範例程式碼

範例程式碼位於 java_or-tools 存放區。

  1. 將存放區下載為 ZIP 檔案，然後解壓縮或複製存放區：

    git clone -b v9.9 --depth 1 https://github.com/or-tools/java_or-tools

  2. 變更為範例目錄：

    cd java_or-tools

建構範例

從 java_or-tools 目錄：

使用以下項目建構專案：

mvn compile -B

執行範例

從 java_or-tools 目錄：

使用以下項目執行二進位檔：

mvn exec:java

恭喜！您已使用 OR-Tools 執行應用程式，可以開始使用 OR-Tools 了。