Сборка из исходного кода OR-Tools Python для Windows

Введение

В этом руководстве объясняется, как выполнить сборку из исходного кода OR-Tools с поддержкой Python в Windows.

Если вы не планируете изменять исходный код или использовать сторонний решатель с OR-Tools, мы рекомендуем установку пакета .

Хотя эти инструкции могут работать и на других вариантах Windows, мы тестировали их только на компьютерах, отвечающих следующим требованиям:

Windows 10 64-разрядная версия (x86_64) с:

  • Microsoft Visual Studio Enterprise 2022
  • Microsoft Visual Studio Community 2022 Preview 2 или более поздней версии

Предварительные условия

В следующих разделах описаны необходимые условия для установки OR-Tools.

Визуальная Студия

Чтобы создать и запустить OR-Tools в Windows, на вашем компьютере должна быть установлена ​​Visual Studio 2022 или более поздняя версия с набором инструментов C++ для Visual Studio.

Более подробную информацию вы можете найти здесь .

Для создания программ OR-Tools из командной строки необходимо использовать командную строку x64 Native Tools ( а не командную строку разработчика).

Более подробную информацию вы можете найти здесь .

Гит

Git , который можно скачать с https://git-scm.com/ .

CMake

CMake (>= 3.18) , который можно загрузить с https://www.cmake.org/download . При установке CMake выберите параметр cmake, доступный из командной строки.

Питон

У вас должна быть установлена ​​одна из следующих версий Python:

Затем убедитесь, что в вашем PATH доступен pip 9.01 или выше: 

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

Загрузите исходный код

На GitHub есть две отдельные ветки исходного кода OR-Tools: stable и main .

stable ветка была тщательно протестирована и должна безупречно работать на всех поддерживаемых платформах.
В main ветке применены последние обновления и улучшения; он более актуален, но менее стабилен.

Загрузите стабильный исходный код

Вы можете получить стабильный исходный код OR-Tools одним из следующих способов:

  • Клонируйте stable ветку, введя:

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

  • Загрузите последнюю версию в сжатом файле, нажав кнопку Clone or download на GitHub . изображение кнопки клонирования или загрузки

Загрузите основной исходный код

Чтобы получить исходный код из 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

Начиная с версии 7.8, SCIP теперь интегрирован, поэтому вам не придется устанавливать его вручную.

Использование Гуроби

Гуроби теперь предварительно интегрирован. При необходимости во время выполнения OR-Tools будет искать общую библиотеку Gurobi в пути установки по умолчанию установщиков Gurobi в MAC OS X и Windows или с помощью переменной среды GUROBI_HOME .

Использование дополнительного стороннего решателя MIP

Вы также можете использовать OR-Tools с любым из следующих дополнительных сторонних решателей 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