在 Windows 上使用原始碼或工具 .Net 建構應用程式

簡介

本指南說明如何在 Windows 支援 .Net 的情況下，透過來源 OR-工具建構應用程式。

除非您打算修改原始碼，或是搭配 OR 工具使用第三方解題工具，否則我們建議安裝套件。

雖然這些操作說明可能也適用於其他 Windows 變化版本，但我們只在符合以下條件的機器上進行測試：

Windows 10 64 位元 (x86_64)，支援的作業系統如下：

  • 2022 年 Microsoft Visual Studio Enterprise
  • Microsoft Visual Studio 社群 2022 預先發布版 2 以上版本

必要條件

以下各節說明安裝 OR-工具的必要條件。

Visual Studio

如要在 Windows 上建構及執行 OR-Tools，電腦必須安裝 Visual Studio 2022 以上版本，並已安裝適用於 Visual Studio 的 C++ 工具組。

詳情請參閱這裡。

如要透過指令列建立 OR-Tools 程式，您「必須」使用 x64 Native Tools 指令列工具 (不是開發人員命令提示字元)。

詳情請參閱這裡。

Git

Git，可從 https://git-scm.com/ 下載。

CMake

CMake (>= 3.18)，可從 https://www.cmake.org/download 下載。安裝 CMake 時，選取指令列可存取 cmake 的選項。

.NET Core 3.1 SDK

您必須從以下位置安裝 .NET Core 3.1 SDK 3.1.100 以上版本的套件：sdk-3.1.425-windows-x64-installer

.Net 6.0 SDK

您必須從以下位置安裝 .NET 6.0 SDK 套件：sdk-6.0.403-windows-x64-installer

下載原始碼

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 --prune
git 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 解決方案搭配使用 (該解決方案預設為停用)：

詳情請參閱這份說明文件。

建構原始碼

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