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