簡介
本指南說明如何在 MacOS 上使用來源 OR-Tools 建構應用程式，並支援 .Net。
除非您打算修改原始碼，或是搭配 OR 工具使用第三方解題工具，否則我們建議安裝套件。
雖然這些操作說明可能也適用於其他 MacOS 變化版本，但我們僅在符合下列條件的機器上測試這些操作說明：
- MacOS 13.0.1 (Ventura) Intel 64 位元 (x86_64)
- MacOS 13.0.1 (Ventura) M1 (arm64)
必要條件
以下各節說明安裝 OR-工具的必要條件。
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)
C++ 工具
如要安裝 C++ 工具，請開啟終端機視窗並輸入：
brew install cmake wget pkg-config
SWIG 工具
如要安裝 SWIG 工具，請開啟終端機視窗並輸入：
brew install swig
.Net 6.0 SDK
您必須安裝 .Net 6.0 SDK。
安裝 Homebrew 後，您可以開啟終端機視窗並輸入以下指令，安裝 dotnet-sdk 套件：
brew cask install dotnet-sdk
您可以使用下列指令，測試已正確安裝 dotnet Cli：
dotnet --info
下載原始碼
GitHub 上的 OR-Tools 原始碼有兩個不同的分支版本：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.9 版而非main分支版本，請在本機存放區中輸入以下指令：git fetch --all --tags --prunegit checkout tags/v9.9 -v v9.9
設定建構
在建構 OR-Tools 之前，您需要設定 CMake 建構系統產生器。
開啟終端機，前往解壓縮檔案的目錄。 接著輸入：
cmake -S . -B build -DBUILD_DEPS=ON -DBUILD_DOTNET=ON
詳情請參閱 CMake 說明文件。
使用 SCIP
v7.8 現已整合 SCIP，因此您不必手動安裝。
使用 Gurobi
Gurobi 現已預先整合。如有需要，OR-Tools 會在 MAC OS X 和 Windows 的預設安裝路徑中，或使用 GUROBI_HOME 環境變數搜尋 Gurobi 共用資料庫。
使用選用的第三方 MIP 解題工具
您也可以將 OR-Tools 與下列任一選用第三方 MIP 解決方案搭配使用 (該解決方案預設為停用)：
- CPLEX
- GLPK (僅限 Linux 和 MacOS)
- XPRESS 解題工具
詳情請參閱這份說明文件。
建構原始碼
如要建構原始碼，請開啟終端機並前往解壓縮檔案的目錄。然後輸入下列指令來編譯 OR-工具：
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_DOTNET=ON
cmake --build build --config Release --target ALL_BUILD -j -v
在作業系統上安裝 OR-工具
您可以在作業系統上輸入以下指令，安裝適用於 .Net 的 OR-Tools：
cmake --build build --config Release --target install -v