OR-Tools Maven for Java を使用する

はじめに

このガイドでは、簡単な作業例を用いて、Java の OR-Tools の使い方について説明します。

この手順は他の macOS バリアントでも動作する可能性がありますが、次の要件を満たすマシンでのみテストしています。

  • MacOS 13.0.1(Ventura)Intel 64-bit(x86_64)
  • macOS 13.0.1(Ventura)M1(arm64)

前提条件

以降のセクションでは、OR-Tools をインストールするための前提条件について説明します。

Xcode コマンドライン ツール

Xcode コマンドライン ツールをインストールする必要があります。そのためには、/Applications/Utilities/ にあるターミナルを開いて次のように入力します。

xcode-select --install

[Install] をクリックし、Xcode コマンドライン ツールをダウンロードしてインストールします。App Store から Xcode を入手する必要はありません。インターネット接続が遅い場合は 数分かかることがあります

Xcode コマンドライン ツールが正常にインストールされたことを確認します。

xcode-select -p

次のように表示されます。

/Library/Developer/CommandLineTools

Homebrew

残りの前提条件をインストールするには、まず「macOS 用の不足しているパッケージ管理システム」(Homebrew とも呼ばれます)をインストールすることをおすすめします。そのためには、ターミナル ウィンドウを開いて次のように入力します。

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

brew が正常にインストールされたことを確認するには:

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.10.4067</version>
</dependency>

Java サンプルコードを取得する

サンプルコードは java_or-tools リポジトリにあります。

  1. リポジトリを ZIP ファイルとしてダウンロードして展開するか、リポジトリのクローンを作成します。

    git clone -b v9.10 --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 の使用を開始する準備が整いました。