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 macOS, nous ne les avons testées que sur des machines répondant aux exigences suivantes:

  • MacOS 13.0.1 (Ventura) Intel 64 bits (x86_64)
  • MacOS 13.0.1 (Ventura) M1 (arm64)

Prérequis

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

Outils de ligne de commande Xcode

Vous devez installer les outils de ligne de commande Xcode. Pour ce faire, ouvrez le terminal, qui se trouve dans /Applications/Utilities/, puis saisissez la commande suivante:

xcode-select --install

Cliquez sur "Installer" pour télécharger et installer les outils de ligne de commande Xcode. Vous n'avez pas besoin d'obtenir Xcode sur l'App Store. Si votre connexion Internet est lente, cela peut prendre plusieurs minutes.

Vérifiez que vous avez installé les outils de ligne de commande Xcode:

xcode-select -p

Vous devriez obtenir le résultat suivant :

/Library/Developer/CommandLineTools

Homebrew

Pour installer les prérequis restants, nous vous recommandons d'installer d'abord le "gestionnaire de packages manquant pour macOS", également connu sous le nom de Homebrew. Pour ce faire, ouvrez une fenêtre de terminal et saisissez la commande suivante:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew update

Pour vérifier que vous avez bien installé brew:

brew --version

Vous devriez obtenir le résultat suivant :

Homebrew 1.6.9-8-g25542d7
Homebrew/homebrew-core (git revision 0e0c84; last commit 2018-06-20)

JDK Java

Vous devez installer le JDK Java 8.0 ou version ultérieure.

Une fois Homebrew installé, vous pouvez installer openjdk en ouvrant une fenêtre de terminal et en saisissant:

brew install openjdk
sudo ln -sfn /usr/local/opt/openjdk/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk.jdk

Vous devez ensuite exporter la variable JAVA_HOME:

export JAVA_HOME=/Library/Java/JavaVirtualMachines/openjdk.jdk

Maven

Vous devez installer Maven.

Une fois Homebrew installé, vous pouvez installer maven en ouvrant une fenêtre de terminal et en saisissant la commande suivante:

brew install 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.