Aus dem Quellcode ODER Tools in C++ unter Windows erstellen

Einleitung

In dieser Anleitung wird erläutert, wie Sie unter Windows aus OR-Quelltools mit Unterstützung für C++ erstellen.

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

Diese Anleitung funktioniert möglicherweise auch für andere Windows-Varianten, wir haben sie jedoch nur auf Computern getestet, die die folgenden Anforderungen erfüllen:

Windows 10 64-Bit (x86_64) mit:

  • Microsoft Visual Studio Enterprise 2022
  • Microsoft Visual Studio Community 2022 Vorschau 2 oder höher

Voraussetzungen

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

Visual Studio

Wenn Sie OR-Tools unter Windows erstellen und ausführen möchten, muss Visual Studio 2022 oder höher mit dem C++-Toolset für Visual Studio auf Ihrem Computer installiert sein.

Weitere Informationen

Wenn Sie OR-Tools-Programme über die Befehlszeile erstellen möchten, müssen Sie eine Eingabeaufforderung für native x64-Tools (nicht die Eingabeaufforderung für Entwickler) verwenden.

Weitere Informationen

Git

Git, das unter https://git-scm.com/ heruntergeladen werden kann.

CMake

CMake (>= 3.18), das unter https://www.cmake.org/download heruntergeladen werden kann. Wählen Sie bei der Installation von CMake die Option für ein über die Befehlszeile zugängliches cmake aus.

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. Bild einer Schaltfläche zum Klonen oder Herunterladen

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

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.

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.

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:

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_BUILD -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 RUN_TESTS -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


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

OR-Tools auf Ihrem Betriebssystem installieren

Sie können die OR-Tools für C++ auf Ihrem Betriebssystem installieren, indem Sie Folgendes eingeben:

cmake --build build --config Release --target INSTALL -v