Compila desde el código fuente OR-Tools Java en Windows

Introducción

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

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 Windows, solo los probaron en máquinas que cumplen con los siguientes requisitos:

Windows 10 de 64 bits (x86_64) con lo siguiente:

• Microsoft Visual Studio Enterprise 2022
• Microsoft Visual Studio Community 2022 Preview 2 o versiones posteriores

Requisitos previos

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

Visual Studio

Para compilar y ejecutar OR-Tools en Windows, debes tener Visual Studio 2022 o instalar más adelante en tu computadora con el conjunto de herramientas de C++ para Visual Studio.

Puedes obtener más información aquí.

Para crear programas de Herramientas OR desde la línea de comandos, debes usar una Símbolo del sistema de herramientas nativas x64 (no el símbolo del sistema de desarrollador).

Puedes obtener más información aquí.

Git

Git, que se puede descargar desde https://git-scm.com/.

CMake

CMake (>= 3.18), que se puede descargar desde https://www.cmake.org/download. Cuando instales CMake, selecciona la opción de una CMake accesible mediante línea de comandos.

JDK de Java

También debes tener instalado un JDK de 64 bits de Java, versión 8.0 o posterior.

Puedes encontrar más detalles aquí.

Maven

También debes tener instalado Maven de 64 bits.

Puedes obtener más información aquí.

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