此页面由 Cloud Translation API 翻译。

在 MacOS 上从源代码或工具 Python 构建

简介

本指南介绍如何从源 OR 工具进行构建，支持 Python 版，适用于 MacOS。

除非您打算修改源代码或使用第三方求解器，否则 OR 工具，我们建议使用软件包安装。

虽然这些说明可能也适用于其他 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 命令行工具：

xcode-select -p

您应该会看到：

/Library/Developer/CommandLineTools

Homebrew

要安装剩余的前提条件，我们建议您先安装 “缺少适用于 macOS 的软件包管理器”也称为 Homebot。为此，请打开终端窗口并输入以下内容：

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

如需验证您已成功安装 Bring，请执行以下操作：

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 源代码有两个不同的分支， 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 代码。例如，要使用 v9.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

自 v7.8 起，SCIP 现已集成，因此您无需手动安装。

使用 Gurobi

Gurobi 现已预先集成。必要时，OR-Tools 会在运行时搜索 Gurobi 安装程序的默认安装路径中的 Gurobi 共享库或在 MAC OS X 和 Windows 上运行，或者使用 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 工具。

清理构建文件

如果您需要重新安装 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-工具

您可以在操作系统中安装适用于 Python 的 OR-Tools，方法是输入以下命令：

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