Utiliser les outils OR pour Java

Présentation

Ce guide vous aide à démarrer avec les outils OR 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, situé 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 correctement 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 autres prérequis, 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, procédez comme suit:

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 une version ultérieure.

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

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 à ses artefacts dans le 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.10.4067</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 en tant que fichier ZIP et extrayez-le, ou clonez le dépôt:

    git clone -b v9.10 --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:

Compilez 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 les outils OU. Vous êtes maintenant prêt à commencer avec les outils OU.