Cómo usar Maven de las herramientas del OR para Java

Introducción

En esta guía, aprenderás a usar las herramientas del operador OR en Java a través de un ejemplo funcional simple.

Aunque estas instrucciones también pueden funcionar en otras variantes de macOS, solo las probamos en máquinas que cumplen con los siguientes requisitos:

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

Requisitos previos

En las siguientes secciones, se describen los requisitos previos para instalar las herramientas del operador OR.

Herramientas de línea de comandos de Xcode

Debes instalar las herramientas de línea de comandos de Xcode. Para ello, abre la terminal, que se encuentra en /Applications/Utilities/, y, luego, ingresa lo siguiente:

xcode-select --install

Haz clic en “Instalar” para descargar y también instalar las herramientas de línea de comandos de Xcode. No es necesario que descargues Xcode en App Store. Si tienes una conexión a Internet lenta, el proceso podría tardar varios minutos.

Verifica si instalaste correctamente las herramientas de línea de comandos de Xcode:

xcode-select -p

Deberías ver lo siguiente:

/Library/Developer/CommandLineTools

Homebrew

Para instalar los requisitos previos restantes, te recomendamos que primero instales el "administrador de paquetes faltante para macOS", también conocido como Homebrew. Para hacerlo, abre una ventana de terminal y escribe lo siguiente:

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

Para verificar que instalaste brew correctamente, haz lo siguiente:

brew --version

Deberías ver lo siguiente:

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

Java JDK

Debes instalar Java JDK 8.0 o una versión posterior.

Una vez que hayas instalado Homebrew, puedes instalar openjdk abriendo una ventana de terminal e ingresa lo siguiente:

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

Luego, debes exportar la variable JAVA_HOME:

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

Maven

Debes instalar Maven.

Una vez que hayas instalado Homebrew, puedes instalar maven abriendo una ventana de terminal e ingresa lo siguiente:

brew install maven

Puedes probar que Maven esté instalado correctamente y puedes encontrar Java con el siguiente comando:

mvn -v

Instala con Maven

Para incluir las herramientas OR en tu aplicación de Maven, agrega una dependencia en sus artefactos al archivo pom.xml de tu proyecto. Por ejemplo,

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

Obtén el código de ejemplo de Java

El código de ejemplo se encuentra en el repositorio java_or-tools.

  1. Descarga el repositorio como un archivo ZIP y extráelo o clona el repositorio:

    git clone -b v9.10 --depth 1 https://github.com/or-tools/java_or-tools
    
  2. Cambia al directorio de ejemplos:

    cd java_or-tools
    

Compila el ejemplo

Desde el directorio java_or-tools:

Compila el proyecto con lo siguiente:

mvn compile -B

Cómo ejecutar el ejemplo

Desde el directorio java_or-tools:

Ejecuta el objeto binario con el siguiente comando:

mvn exec:java

¡Felicitaciones! Acabas de ejecutar una aplicación con las herramientas del operador OR, estás listo para comenzar a usar las herramientas del operador OR.