Сборка из исходного кода OR-Tools .Net в Linux

Введение

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

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

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

• Alpine Edge 64-разрядная версия (x86_64)
• Centos 7 LTS 64-бит (x86_64)
• Debian SID 64-бит (x86_64)
• Debian 11 (яблочко) 64-разрядная версия (x86_64)
• Федора 38, 64-разрядная версия (x86_64)
• Федора 37, 64-разрядная версия (x86_64)
• OpenSuse Leap 64-бит (x86_64)
• Ubuntu 24.04 64-разрядная версия (x86_64)
• Ubuntu 22.04 LTS 64-бит (x86_64)
• Ubuntu 20.04 LTS 64-бит (x86_64)

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

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

Инструменты С++

Чтобы установить инструменты C++, откройте окно терминала и введите:

Альпийский

apk add alpine-sdk linux-headers cmake lsb-release-minimal

Центос

sudo yum groupinstall -y 'Development Tools'
sudo yum install -y pkgconfig redhat-lsb-core

Дебиан

sudo apt update
sudo apt install -y build-essential cmake lsb-release

Федора

sudo dnf groupinstall -y 'Development Tools'
sudo dnf install -y gcc-c++ cmake redhat-lsb-core

Федора

sudo dnf groupinstall -y 'Development Tools'
sudo dnf install -y gcc-c++ cmake redhat-lsb-core

OpenSUSE

sudo zypper refresh
sudo zypper install -y git gcc11 gcc11-c++ lsb-release

Убунту

sudo apt update
sudo apt install -y build-essential cmake lsb-release

Убунту

sudo apt update
sudo apt install -y build-essential cmake lsb-release

Убунту

sudo apt update
sudo apt install -y build-essential cmake lsb-release

СВИГ

Чтобы установить SWIG, откройте окно терминала и введите:

Альпийский

apk add swig

Центос

sudo yum install -y swig

Дебиан

sudo apt install -y swig

Федора

sudo dnf install -y swig

Федора

sudo dnf install -y swig

OpenSUSE

sudo zypper install -y swig

Убунту

sudo apt install -y swig

Убунту

sudo apt install -y swig

Убунту

sudo apt install -y swig

.Net Core SDK >= 3.1

Затем установите .Net Core SDK версии 3.1 или выше. Для этого откройте окно терминала и введите:

Альпийский

apk add dotnet6-sdk
    
ref: https://learn.microsoft.com/en-us/dotnet/core/install/linux-alpine

Центос

sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm
sudo yum install -y dotnet-sdk-6.0

ссылка: https://learn.microsoft.com/en-us/dotnet/core/install/linux-centos#centos-7

Дебиан

Прежде чем устанавливать .NET, выполните следующие команды, чтобы добавить ключ подписи пакета Microsoft в список доверенных ключей и добавить репозиторий пакетов.

wget https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

sudo apt update
sudo apt install -y dotnet-sdk-6.0

ссылка: https://learn.microsoft.com/en-us/dotnet/core/install/linux-debian

Федора

sudo dnf install -y dotnet-sdk-6.0

ссылка: https://learn.microsoft.com/en-us/dotnet/core/install/linux-fedora

Федора

sudo dnf install -y dotnet-sdk-6.0

ссылка: https://learn.microsoft.com/en-us/dotnet/core/install/linux-fedora

OpenSUSE

Прежде чем устанавливать .NET, выполните следующие команды, чтобы добавить ключ подписи пакета Microsoft в список доверенных ключей и добавить репозиторий пакетов.

sudo zypper install libicu
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
wget https://packages.microsoft.com/config/opensuse/15/prod.repo
sudo mv prod.repo /etc/zypp/repos.d/microsoft-prod.repo
sudo chown root:root /etc/zypp/repos.d/microsoft-prod.repo

Затем вы можете установить .Net SDK, используя следующую команду:

sudo zypper install -y dotnet-sdk-6.0

ссылка: https://learn.microsoft.com/en-us/dotnet/core/install/linux-opensuse

Убунту

sudo apt install -y dotnet-sdk-6.0

ссылка: https://learn.microsoft.com/en-us/dotnet/core/install/linux-ubuntu

Убунту

sudo apt install -y dotnet-sdk-6.0

ссылка: https://learn.microsoft.com/en-us/dotnet/core/install/linux-ubuntu

Убунту

sudo apt install -y dotnet-sdk-6.0

ссылка: https://learn.microsoft.com/en-us/dotnet/core/install/linux-ubuntu

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

На 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_DOTNET=ON

Совет: Полный список доступных опций OR-Tools CMake можно найти здесь.

Подробности смотрите в документации CMake .

Использование SCIP

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

Примечание. Вы можете отключить поддержку решателя SCIP, используя -DUSE_SCIP=OFF

Предупреждение. Хотя OR-Tools поставляется с SCIP, ознакомьтесь с лицензией SCIP , чтобы убедиться, что вы соблюдаете ее.

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

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

Примечание. Вы можете отключить поддержку решателя Gurobi, используя -DUSE_GUROBI=OFF

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

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

• Комплексный комплекс
• GLPK (только Linux и MacOS)
• XPRESS-решатель

Пожалуйста, ознакомьтесь с этой документацией для получения подробной информации.

Сборка исходного кода

Чтобы создать исходный код, откройте терминал и перейдите в каталог, в который вы извлекли файлы. Затем введите следующую команду для компиляции OR-Tools:

cmake --build build --config Release --target all -j -v

Подробности смотрите в документации CMake .

Проверьте исходный код

Вы можете проверить, что все работает правильно, введя:

cmake --build build --config Release --target test -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 -j -v

Установка OR-Tools в вашу операционную систему

Вы можете установить OR-Tools for .Net в свою операционную систему, введя:

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

Совет: Чтобы изменить местоположение установки по умолчанию, обратитесь к документации CMAKE_INSTALL_PREFIX .