はじめに
このガイドでは、簡単な作業例を用いて、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 リポジトリにあります。
リポジトリを ZIP ファイルとしてダウンロードして展開するか、リポジトリのクローンを作成します。
git clone -b v9.10 --depth 1 https://github.com/or-tools/java_or-tools
サンプル ディレクトリに移動します。
cd java_or-tools
サンプルをビルドする
java_or-tools
ディレクトリから:
次のコマンドを使用してプロジェクトをビルドします。
mvn compile -B
サンプルを実行する
java_or-tools
ディレクトリから:
次のコマンドを使用してバイナリを実行します。
mvn exec:java
これで完了です。OR-Tools を使用してアプリケーションを実行したので、OR-Tools の使用を開始する準備が整いました。