Aus Quell-ODER-Tools-Java unter Linux erstellen

Einleitung

In dieser Anleitung wird erläutert, wie Sie aus Quell-OR-Tools mit Java-Unterstützung unter Linux erstellen.

Sofern Sie nicht vorhaben, den Quellcode zu ändern oder einen Solver eines Drittanbieters mit OR-Tools zu verwenden, empfehlen wir die Paketinstallation.

Obwohl diese Anleitung möglicherweise auch für andere Linux-Varianten funktioniert, wurde sie nur auf Computern getestet, die die folgenden Anforderungen erfüllen:

• Alpine Edge 64-Bit (x86_64)
• Centos 7 LTS 64-Bit (x86_64)
• Debian SID 64-Bit (x86_64)
• Debian 11 (Zielscheibe) 64-Bit (x86_64)
• Fedora 38 64-Bit (x86_64)
• Fedora 37 64-Bit (x86_64)
• OpenSuse Leap 64-Bit (x86_64)
• Ubuntu 23.10 64-Bit (x86_64)
• Ubuntu 22.04 LTS 64-Bit (x86_64)
• Ubuntu 20.04 LTS 64-Bit (x86_64)

Voraussetzungen

In den folgenden Abschnitten werden die Voraussetzungen für die Installation von OR-Tools beschrieben.

C++-Tools

Um C++-Tools zu installieren, öffnen Sie ein Terminalfenster und geben Sie Folgendes ein:

Alpine

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

Centos

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

Debian

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

Fedora

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

Fedora

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

Ubuntu

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

Ubuntu

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

Ubuntu

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

WISCHEN

Um SWIG zu installieren, öffnen Sie ein Terminalfenster und geben Sie Folgendes ein:

Alpine

apk add swig

Centos

sudo yum install -y swig

Debian

sudo apt install -y swig

Fedora

sudo dnf install -y swig

Fedora

sudo dnf install -y swig

OpenSUSE

sudo zypper install -y swig

Ubuntu

sudo apt install -y swig

Ubuntu

sudo apt install -y swig

Ubuntu

sudo apt install -y swig

Java JDK >= 8.0

Um die Java JDK-Version 8.0 oder höher zu installieren, öffnen Sie ein Terminalfenster und geben Sie Folgendes ein:

Alpine

sudo apk add openjdk8
export JAVA_HOME=/usr/lib/jvm/java-1.8-openjdk

Centos

sudo yum install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel

Debian

sudo apt install -y default-jdk
export JAVA_HOME=/usr/lib/jvm/default-java

Fedora

sudo dnf install -y java-openjdk java-openjdk-devel

Fedora

sudo dnf install -y java-openjdk java-openjdk-devel

OpenSUSE

sudo zypper install -y java-1_8_0-openjdk java-1_8_0-openjdk-devel

Ubuntu

sudo apt install -y default-jdk

Ubuntu

sudo apt install -y default-jdk

Ubuntu

sudo apt install -y default-jdk

Maven 3.3

Um Maven Version 3.3 oder höher zu installieren, öffnen Sie ein Terminalfenster und geben Sie Folgendes ein:

Alpine

sudo apk add maven

Centos

sudo yum install -y maven

Debian

sudo apt install -y maven

Fedora

sudo dnf install -y maven

Fedora

sudo dnf install -y maven

OpenSUSE

sudo zypper install -y maven

Ubuntu

sudo apt install -y maven

Ubuntu

sudo apt install -y maven

Ubuntu

sudo apt install -y maven

Mit dem folgenden Befehl können Sie testen, ob Maven korrekt installiert ist, und Java finden:

mvn -v

Quellcode herunterladen

Es gibt zwei verschiedene Zweige des OR-Tools-Quellcodes auf GitHub: stable und main.

Der stable-Zweig wurde gründlich getestet und sollte auf allen unterstützten Plattformen einwandfrei funktionieren.
Im main-Zweig wurden die neuesten Updates und Verbesserungen angewendet. Er ist aktueller, aber weniger stabil.

Stabilen Quellcode herunterladen

Sie können den stabilen Quellcode für ODER-Tools auf eine der folgenden Arten abrufen:

• Klonen Sie den stable-Zweig durch Eingabe von:

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

• Laden Sie den neuesten Release als komprimierte Datei herunter. Klicken Sie dazu in GitHub auf die Schaltfläche Clone or download.

Warnung :Der vollständige Pfad zum Installationsverzeichnis, in das Sie die Dateien extrahieren, darf keine Leerzeichen enthalten.

Hauptquellcode herunterladen

Geben Sie Folgendes ein, um den Quellcode aus dem main-Zweig abzurufen:

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

Frühere Releases herunterladen

Sie haben folgende Möglichkeiten, den Quellcode für frühere Releases abzurufen:

• Laden Sie einen vorherigen Release von der GitHub-Releaseseite herunter.

• Wenn Sie bereits ein lokales Repository (mit git clone) erstellt haben, können Sie einen bestimmten Release mit einem Git-Tag auschecken. Wenn Sie beispielsweise mit Version 9.9 statt mit dem Zweig main arbeiten möchten, geben Sie die folgenden Befehle in Ihr lokales Repository ein:

  git fetch --all --tags --prune
  git checkout tags/v9.9 -v v9.9
  

Build konfigurieren

Bevor Sie die OR-Tools erstellen können, müssen Sie den Build-Systemgenerator CMake konfigurieren.

Öffnen Sie ein Terminal und rufen Sie das Verzeichnis auf, in dem Sie die Dateien extrahiert haben. Geben Sie als Nächstes Folgendes ein:

cmake -S . -B build -DBUILD_DEPS=ON -DBUILD_JAVA=ON

Tipp :Eine vollständige Liste der verfügbaren OR-Tools-CMake-Optionen finden Sie hier

Weitere Informationen finden Sie in der CMake-Dokumentation.

SCIP verwenden

Seit Version 7.8 ist SCIP jetzt integriert, sodass Sie es nicht mehr manuell installieren müssen.

Hinweis: Sie können die Unterstützung des SCIP-Lösers mit -DUSE_SCIP=OFF deaktivieren.

Warnung: Auch wenn OR-Tools mit SCIP ausgeliefert wird, sollten Sie die SCIP-Lizenz konsultieren, um sicherzustellen, dass Sie sie einhalten.

Gurobi verwenden

Gurobi ist jetzt vorintegriert. Bei Bedarf sucht OR-Tools während der Laufzeit im Standardinstallationspfad der Gurobi-Installationsprogramme unter MAC OS X und Windows oder mithilfe der Umgebungsvariablen GUROBI_HOME nach der gemeinsam genutzten Gurobi-Bibliothek.

Hinweis: Sie können die Unterstützung des Gurobi-Lösers mit -DUSE_GUROBI=OFF deaktivieren.

Optionalen MIP-Rechner eines Drittanbieters verwenden

Sie können die ODER-Tools auch mit den folgenden optionalen MIP-Lösern von Drittanbietern verwenden, deren Unterstützung standardmäßig deaktiviert ist:

• CPLEX
• GLPK (nur Linux und macOS)
• XPRESS-Rechner

Weitere Informationen finden Sie in dieser Dokumentation.

Quellcode erstellen

Öffnen Sie zum Erstellen des Quellcodes ein Terminal und rufen Sie das Verzeichnis auf, in das Sie die Dateien extrahiert haben. Geben Sie dann den folgenden Befehl ein, um OR-Tools zu kompilieren:

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

Weitere Informationen finden Sie in der CMake-Dokumentation.

Quellcode testen

Sie können überprüfen, ob alles korrekt ausgeführt wird, indem Sie Folgendes eingeben:

cmake --build build --config Release --target test -v

Dadurch werden Beispiele für ODER-Tools ausgeführt. Wenn alle Beispiele erfolgreich ausgeführt werden, können Sie mit OR-Tools loslegen.

Build-Dateien bereinigen

Wenn Sie OR-Tools neu installieren müssen, führen Sie den folgenden Befehl aus:

rm -r build

entfernt alle kompilierten Abhängigkeiten. Dies kann hilfreich sein, um das Gerät auf einen bereinigten Zustand zurückzusetzen.

Geben Sie die Befehle dann noch einmal ein:

cmake -S . -B build -DBUILD_DEPS=ON -DBUILD_JAVA=ON

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

OR-Tools auf Ihrem Betriebssystem installieren

Sie können OR-Tools for Java auf Ihrem Betriebssystem installieren, indem Sie Folgendes eingeben:

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

Tipp :Informationen zum Ändern des Standardinstallationspfads finden Sie in der Dokumentation zu CMAKE_INSTALL_PREFIX.