Cómo compilar desde el código fuente OR-Tools Java en Linux

Introducción

Esta guía explica cómo compilar a partir de herramientas OR de origen, con compatibilidad para Java en Linux.

A menos que planees modificar el código fuente o usar un solucionador de problemas externo con OR-Tools, te recomendamos la instalación del paquete.

Aunque estas instrucciones también podrían funcionar en otras variantes de Linux, solo los probaron en máquinas que cumplen con los siguientes requisitos:

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

Requisitos previos

Las siguientes secciones describen los requisitos previos para instalar OR-Tools.

Herramientas de C++

Para instalar herramientas de C++, abre una ventana de terminal y escribe lo siguiente:

Alpine

apk add alpine-sdk linux-headers cmake lsb-release-minimal

CentOS

sudo yum groupinstall -y 'Development Tools'
sudo yum install -y pkgconfig redhat-lsb-core

Debian

sudo apt update
sudo apt install -y build-essential cmake lsb-release

Fedora

sudo dnf groupinstall -y 'Development Tools'
sudo dnf install -y gcc-c++ cmake redhat-lsb-core

Fedora

sudo dnf groupinstall -y 'Development Tools'
sudo dnf install -y gcc-c++ cmake redhat-lsb-core

OpenSUSE

sudo zypper refresh
sudo zypper install -y git gcc11 gcc11-c++ lsb-release

Ubuntu

sudo apt update
sudo apt install -y build-essential cmake lsb-release

Ubuntu

sudo apt update
sudo apt install -y build-essential cmake lsb-release

Ubuntu

sudo apt update
sudo apt install -y build-essential cmake lsb-release

SWIG

Para instalar SWIG, abre una ventana de terminal e ingresa:

Alpine

apk add swig

CentOS

sudo yum install -y swig

Debian

sudo apt install -y swig

Fedora

sudo dnf install -y swig

Fedora

sudo dnf install -y swig

OpenSUSE

sudo zypper install -y swig

Ubuntu

sudo apt install -y swig

Ubuntu

sudo apt install -y swig

Ubuntu

sudo apt install -y swig

Java JDK >= 8.0

Para instalar Java JDK versión 8.0 o superior, abre una ventana de terminal e ingresa lo siguiente:

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

Para instalar la versión 3.3 de Maven o una superior, abre una ventana de terminal y escribe lo siguiente:

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

Para probar si Maven está instalado correctamente y encontrar Java, usa el siguiente comando:

mvn -v

Descargue el código fuente

Existen dos ramas distintas del código fuente OR-Tools en GitHub: stable y main

La rama stable se probó minuciosamente y debería funcionar sin problemas en todos los plataformas compatibles.
En la rama main, se encuentran las últimas actualizaciones y de los cambios que se implementaron; sea más actual, pero menos estable.

Descarga el código fuente estable

Puedes obtener el código fuente estable para OR-Tools de cualquiera de las siguientes maneras:

• Para clonar la rama stable, ingresa lo siguiente:

  git clone https://github.com/google/or-tools
  

• Descarga la versión más reciente en un archivo comprimido. Para ello, haz clic en el Botón Clone or download en GitHub.

Advertencia: La ruta de acceso completa al directorio de instalación (de la que extraes el archivos) no deben contener espacios.

Descarga el código fuente principal

Para recuperar el código fuente de la rama main, ingresa lo siguiente:

git clone -b main https://github.com/google/or-tools

Descarga versiones anteriores

Puedes obtener el código fuente de versiones anteriores de cualquiera de las siguientes maneras:

• Descarga una versión anterior desde la página de versiones de GitHub.

• Si ya creaste un repositorio local (antes del git clone), puedes consultar una versión específica etiqueta. Por ejemplo, para trabajar con la versión 9.10 en lugar de la versión main, ingresa los siguientes comandos en tu repositorio local:

  git fetch --all --tags --prune
  git checkout tags/v9.10 -b v9.10
  

Configura la compilación

Antes de compilar las herramientas OR, tendrás que configurar el sistema de compilación de CMake generador.

Abre una terminal y navega al directorio en el que extrajiste los archivos. Luego, ingresa lo siguiente:

cmake -S . -B build -DBUILD_DEPS=ON -DBUILD_JAVA=ON

Sugerencia: Para obtener una lista completa de las opciones disponibles de OR-Tools de CMake, consulta aquí

Consulta el Documentación de CMake para conocer los detalles.

Usando SCIP

A partir de la versión 7.8, SCIP está integrado, por lo que no tendrás que instalarlo de forma manual.

Nota: Puedes inhabilitar la compatibilidad con el solucionador de problemas SCIP a través de -DUSE_SCIP=OFF.

Advertencia: Si bien OR-Tools se envía con SCIP, consulta la Licencia de SCIP para garantizar que estás satisfacerlo.

Cómo usar Gurobi

Gurobi ahora está preintegrado. Cuando sea necesario, durante el tiempo de ejecución, OR-Tools buscará la biblioteca compartida de Gurobi en la ruta de acceso de instalación predeterminada de los instaladores de Gurobi en MAC OS X y Windows, o mediante la variable de entorno GUROBI_HOME.

Nota: Puedes inhabilitar la compatibilidad con el solucionador de Gurobi con -DUSE_GUROBI=OFF

Cómo usar un solucionador de MIP externo opcional

También puedes usar las herramientas OR con cualquiera de los siguientes MIP externos opcionales solucionadores cuyo soporte está inhabilitado de forma predeterminada:

• CPLEX
• GLPK (solo Linux y MacOS)
• Resolutor de XPRESS

Consulta esta documentación para conocer los detalles.

Compila el código fuente

Para compilar el código fuente, abre una terminal y navega hasta el directorio extrajiste los archivos. Luego, ingresa el siguiente comando para compilar OR-Tools:

cmake --build build --config Release --target all -j -v

Consulta el Documentación de CMake para conocer los detalles.

Prueba el código fuente

Para verificar que todo se ejecute correctamente, ingresa lo siguiente:

cmake --build build --config Release --target test -v

Esto ejecuta ejemplos para las herramientas OR. Si todos los ejemplos se ejecutan con éxito, estás listo para comienza a usar las herramientas OR.

Cómo limpiar los archivos de compilación

Si necesitas volver a instalar OR-Tools, haz lo siguiente:

rm -r build

quitará todas las dependencias compiladas. Esto puede ser útil para restablecer a un estado limpio.

Luego, vuelve a ingresar los comandos:

cmake -S . -B build -DBUILD_DEPS=ON -DBUILD_JAVA=ON

cmake --build build --config Release --target all -j -v

Cómo instalar las herramientas OR en tu sistema operativo

Puedes instalar OR-Tools para Java en tu sistema operativo ingresando:

cmake --build build --config Release --target install -v

Nota: Para cambiar la ubicación de instalación predeterminada, consulta el CMAKE_INSTALL_PREFIX documentación.