Utiliser les outils OR pour Java

Introduction

Ce guide vous aide à faire vos premiers pas avec OR-Tools en Java à l'aide d'un exemple fonctionnel simple.

Bien que ces instructions puissent également fonctionner sur d'autres variantes de Linux, nous ne les avons testées que sur des machines répondant aux exigences suivantes:

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

Prérequis

Les sections suivantes décrivent les conditions préalables à l'installation des outils OU.

JDK Java 8.0 ou version ultérieure

Pour installer le JDK Java version 8.0 ou ultérieure, ouvrez une fenêtre de terminal et saisissez la commande suivante:

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

Pour installer Maven version 3.3 ou ultérieure, ouvrez une fenêtre de terminal et saisissez la commande suivante:

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

Vous pouvez vérifier que Maven est correctement installé et trouver Java à l'aide de la commande suivante : 

mvn -v

Installer avec Maven

Pour inclure des outils OR dans votre application Maven, ajoutez une dépendance sur ses artefacts au fichier pom.xml de votre projet. Par exemple,

<!-- https://mvnrepository.com/artifact/com.google.ortools/ortools-java -->
<dependency>
    <groupId>com.google.ortools</groupId>
    <artifactId>ortools-java</artifactId>
    <version>9.9.3963</version>
</dependency>

Obtenir l'exemple de code Java

L'exemple de code se trouve dans le dépôt java_or-tools.

  1. Téléchargez le dépôt sous forme de fichier ZIP, puis extrayez-le, ou clonez le dépôt:

    git clone -b v9.9 --depth 1 https://github.com/or-tools/java_or-tools

  2. Accédez au répertoire "examples" :

    cd java_or-tools

Créer l'exemple

Dans le répertoire java_or-tools:

Créez le projet à l'aide de la commande suivante:

mvn compile -B

Exécuter l'exemple

Dans le répertoire java_or-tools:

Exécutez le binaire à l'aide de la commande suivante:

mvn exec:java

Félicitations ! Vous venez d'exécuter une application avec OR-Tools. Vous êtes maintenant prêt à vous lancer avec OR-Tools.