本頁面由 Cloud Translation API 翻譯而成。

使用 MacOS 上的原始碼或工具 Python 建構

簡介

本指南將說明如何使用原始碼「或」工具，並支援例如 Python 和 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

按一下「安裝」，下載並安裝 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 --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 工具原始碼中有兩個不同的分支 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 建立)，也可以使用 Git 檢查特定版本標記。舉例來說，如果想使用 9.10 版，而非 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

SCIP 自 7.8 版起現已整合，因此您不必手動安裝。

使用 Gurobi

Gurobi 現已預先整合。在必要時，OR-Tools 會在執行階段搜尋使用 Gurobi 安裝程式的預設安裝路徑，或使用 GUROBI_HOME 環境變數。

使用選用的第三方 MIP 解析器

您也可以將 OR-Tools 與下列任一選用第三方 MIP 搭配使用會預設為停用支援功能的解題工具：

CPLEX
GLPK (僅限 Linux 和 MacOS)
XPRESS 求解器

請參閱這份說明文件。

建構原始碼

如要建構原始碼，請開啟終端機並前往以下目錄：解壓縮檔案然後輸入下列指令來編譯 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，方法是輸入：

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