Aus Quell-OR-Tools .Net unter Windows erstellen

Einführung

In diesem Leitfaden wird erläutert, wie Sie aus der Quelle ODER-Tools mit Unterstützung für .Net unter Windows.

Es sei denn, Sie möchten den Quellcode ändern oder den Rechner eines Drittanbieters mit OR-Tools, empfehlen wir die Paketinstallation.

Diese Anleitung funktioniert möglicherweise auch für andere Windows-Varianten, 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 Preview 2 oder höher

Vorbereitung

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

Visual Studio

Zum Erstellen und Ausführen von OR-Tools unter Windows benötigen Sie Visual Studio 2022 oder später mit dem C++ Toolset für Visual Studio auf Ihrem Computer installiert.

Weitere Informationen

Um OR-Tools-Programme über die Befehlszeile zu erstellen, müssen Sie ein x64 Native Tools-Eingabeaufforderung (nicht die Developer-Eingabeaufforderung)

Weitere Informationen

Git

Git, der heruntergeladen werden kann über https://git-scm.com/.

CMake

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

.NET Core 3.1 SDK

Sie müssen das Paket .NET Core 3.1 SDK, Version 3.1.100 oder höher, von den folgenden Speicherort: sdk-3.1.425-windows-x64-installer

.Net 6.0-SDK

Sie müssen das .NET 6.0 SDK-Paket von den folgenden Speicherort: sdk-6.0.403-windows-x64-installer

Quellcode herunterladen

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

Der stable-Branch wurde gründlich getestet und sollte bei allen unterstützten Plattformen.
Im Zweig main werden die neuesten Updates und Verbesserungen vorgenommen wurden; zwar aktueller, aber weniger stabil.

Stabilen Quellcode herunterladen

Sie haben folgende Möglichkeiten, den stabilen Quellcode für OR-Tools abzurufen:

  • Klonen Sie den stable-Zweig, indem Sie Folgendes eingeben:

    git clone https://github.com/google/or-tools
    
  • Laden Sie die neueste Version in einer komprimierten Datei herunter. Klicken Sie dazu auf Clone or download-Schaltfläche in GitHub. Bild der Schaltfläche zum Klonen oder Herunterladen

Hauptquellcode herunterladen

Geben Sie Folgendes ein, um den Quellcode aus dem Zweig main 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 eine frühere Version von der GitHub-Versionsseite herunter.
  • Angenommen, Sie haben bereits ein lokales Repository (von git clone) erstellt: können Sie eine bestimmte Version mithilfe eines Git- Tag. Wenn Sie beispielsweise mit der Version v9.10 und nicht mit der main-Branch die folgenden Befehle in Ihr lokales Repository ein:

    git fetch --all --tags --prune
    git checkout tags/v9.10 -b v9.10
    

Build konfigurieren

Bevor Sie OR-Tools erstellen, müssen Sie das Build-System von CMake konfigurieren Generator.

Ö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_DOTNET=ON

Mehr erfahren Sie in der CMake-Dokumentation .

SCIP verwenden

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

Gurobi verwenden

Gurobi ist jetzt vorintegriert. Bei Bedarf sucht OR-Tools zur Laufzeit nach die gemeinsam genutzte Gurobi-Bibliothek im Standard-Installationspfad der Gurobi-Installationsprogramme unter MAC OS X und Windows oder mithilfe der Umgebungsvariable GUROBI_HOME.

Optionalen MIP-Resolver eines Drittanbieters verwenden

Sie können OR-Tools auch mit einem der folgenden optionalen Drittanbieter-MIPs verwenden Solver, deren Unterstützung standardmäßig deaktiviert ist:

Werfen Sie einen Blick auf dieser Dokumentation .

Quellcode erstellen

Öffnen Sie zum Erstellen des Quellcodes ein Terminal und wechseln Sie zu dem Verzeichnis, in dem 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

Mehr erfahren 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

Hier werden Beispiele für ODER-Tools ausgeführt. Wenn alle Beispiele abgeschlossen haben, sind Sie bereit, OR-Tools verwenden.

Build-Dateien bereinigen

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

rm -r build

entfernt alle kompilierten Abhängigkeiten. Dies kann hilfreich sein, wenn Sie Ihr Gerät auf einen bereinigten Zustand zurücksetzen möchten.

Geben Sie dann die Befehle noch einmal ein:

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

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

OR-Tools auf Ihrem Betriebssystem installieren

Sie können OR-Tools für .Net auf Ihrem Betriebssystem installieren, indem Sie Folgendes eingeben:

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