ソースまたはツール（MacOS）の Python からビルドする

はじめに

このガイドでは、ソース OR-Tools からビルドする方法と、 Python。

ソースコードを変更する場合や、サードパーティのソルバーを使用する場合を除いて、 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

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

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

xcode-select -p

以下のように表示されます。

/Library/Developer/CommandLineTools

Homebrew

残りの前提条件をインストールするには、まず 「macOS 用のパッケージ マネージャーがありません」略して Homebird。ターミナル ウィンドウを開いて次のコマンドを入力します。

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

bq がインストールされていることを確認するには:

brew --version

以下のように表示されます。

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

C++ ツール

C++ ツールをインストールするには、ターミナル ウィンドウを開き、次のように入力します。

brew install cmake wget pkg-config

SWIG ツール

SWIG ツールをインストールするには、ターミナル ウィンドウを開き、次のように入力します。

brew install swig

Python

Python 3.8 以降がインストールされている必要があります。

Python 3.8 以降をインストールするには、ターミナル ウィンドウを開き、次のように入力します。

brew install python
python3 -m pip install -U --user wheel six

次に、インストールを確認します。

python3 --version
python3 -c "import platform; print(platform.architecture()[0])"
python3 -m pip --version

ソースコードをダウンロードする

OR-Tools のソースコードには、2 つの異なるブランチがあります。 GitHub: stable と main。

stable ブランチは徹底的にテストされており、どのシステムでも問題なく動作するはずです。 サポートしています。
main ブランチには、最新のアップデートと 改善が行われました。最新のものですが安定性に欠けます

安定版のソースコードをダウンロードする

OR-Tools の安定したソースコードは、次のいずれかの方法で取得できます。

  • 次のコマンドを入力して stable ブランチのクローンを作成します。

    git clone https://github.com/google/or-tools

  • 最新のリリースを圧縮ファイルでダウンロードするには、 GitHub の Clone or download ボタン。 クローン作成またはダウンロード ボタンの画像

で確認できます。

メイン ソースコードをダウンロードする

main ブランチからソースコードを取得するには、次のように入力します。

git clone -b main https://github.com/google/or-tools

以前のリリースをダウンロードする

以前のリリースのソースコードは、次のいずれかの方法で入手できます。

  • 以前のリリースを GitHub リリースページからダウンロードします。

  • （git clone までに）ローカル リポジトリをすでに作成していると仮定します。 特定のリリースをチェックアウトするには、 タグ。 たとえば、 main ブランチを開き、ローカル リポジトリに次のコマンドを入力します。

    git fetch --all --tags --prune
git checkout tags/v9.10 -b v9.10

ビルドを構成する

OR-Tools をビルドする前に、CMake ビルドシステムを設定する必要があります 生成します。

ターミナルを開き、ファイルを抽出したディレクトリに移動します。 続いて、次のように入力します。

cmake -S . -B build -DBUILD_DEPS=ON -DBUILD_PYTHON=ON

詳しくは、 CMake のドキュメント をご覧ください。

SCIP の使用

v7.8 以降、SCIP が統合されたため、手動でインストールする必要はありません。

Gurobi の使用

Gurobi は事前に統合されています。OR-Tools は必要に応じて、実行時に Gurobi インストーラのデフォルトのインストール パスにある Gurobi 共有ライブラリ GUROBI_HOME 環境変数を使用します。

オプションのサードパーティ MIP ソルバーの使用

OR ツールは、次のオプションのサードパーティ製 MIP でも使用できます。 デフォルトでサポートが無効になっています。

詳しくは、 こちらのドキュメント をご覧ください。

ソースコードをビルドする

ソースコードをビルドするには、ターミナルを開いて、ソースコードをビルドする ファイルを抽出しました。次に、次のコマンドを入力して OR-Tools をコンパイルします。

cmake --build build --config Release --target ALL_BUILD -j -v

詳しくは、 CMake のドキュメント をご覧ください。

ソースコードをテストする

次のコマンドを入力すると、すべてが正しく実行されていることを確認できます。

cmake --build build --config Release --target RUN_TESTS -v

これにより、OR-Tools のサンプルが実行されます。すべての例を実行すれば、 完了したら、 OR-Tools を使ってみるをご覧ください。

ビルドファイルのクリーニング

OR-Tools を再インストールする必要がある場合は、次のコマンドを実行します。

rm -r build

コンパイル済みの依存関係がすべて削除されます。 これは、クリーンな状態にリセットするのに役立ちます。

次に、コマンドを再入力します。

cmake -S . -B build -DBUILD_DEPS=ON -DBUILD_PYTHON=ON


cmake --build build --config Release --target ALL_BUILD -j -v

オペレーティング システムに OR-Tools をインストールする

次のように入力して、オペレーティング システムに OR-Tools for Python をインストールできます。

cmake --build build --config Release --target install -v