Compila desde el origen OR-Tools .NET en Windows

Introducción

En esta guía, se explica cómo compilar desde las herramientas OR de origen, con compatibilidad para .NET, en Windows.

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

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

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

  • Microsoft Visual Studio Enterprise 2022
  • Vista previa 2 o posterior de la Comunidad de Microsoft Visual Studio 2022

Requisitos previos

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

Visual Studio

Para compilar y ejecutar las herramientas del operador OR en Windows, debes tener instalado Visual Studio 2022 o una versión posterior en tu computadora con el conjunto de herramientas de C++ para Visual Studio.

Puedes obtener más información aquí.

Para compilar programas con herramientas del operador del operador O desde la línea de comandos, debes usar un símbolo del sistema de herramientas nativas x64 (no el símbolo del sistema para desarrolladores).

Puedes obtener más información aquí.

Git

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

CMake

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

SDK de .NET Core 3.1

Debes instalar el paquete de la versión 3 .1.100 o posterior del SDK de.NET Core 3.1 desde la siguiente ubicación: sdk-3.1.425-windows-x64-installer

SDK de .NET 6.0

Debes instalar el SDK del paquete .NET 6.0 desde la siguiente ubicación: sdk-6.0.403-windows-x64-installer.

Descarga el código fuente

En GitHub hay dos ramas distintas del código fuente de las herramientas del OR: stable y main.

La rama stable se probó de manera exhaustiva y debería funcionar sin problemas en todas las plataformas compatibles.
La rama main es donde se aplicaron las actualizaciones y mejoras más recientes. Es más actual, pero menos estable.

Descarga el código fuente estable

Puedes obtener el código fuente estable para las herramientas del operador OR de cualquiera de las siguientes maneras:

  • Ingresa lo siguiente para clonar la rama stable:

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

  • Para descargar la versión más reciente en un archivo comprimido, haz clic en el botón Clone or download en GitHub. imagen del botón para clonar o descargar

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

Descargar versiones anteriores

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

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

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

    git fetch --all --tags --prune
git checkout tags/v9.9 -v v9.9

Configura la compilación

Antes de compilar las herramientas del operador OR, deberás configurar el generador del sistema de compilación de CMake.

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_DOTNET=ON

Consulta la documentación de CMake para obtener más detalles.

Usando SCIP

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

Usa Gurobi

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

Usa un solucionador de MIP de terceros opcional

También puedes usar las herramientas del OR con cualquiera de los siguientes compiladores de MIP de terceros opcionales cuya compatibilidad está inhabilitada de forma predeterminada:

Consulta esta documentación para obtener más detalles.

Compila el código fuente

Para compilar el código fuente, abre una terminal y navega al directorio en el que extrajiste los archivos. Luego, ingresa el siguiente comando para compilar las herramientas del operador OR:

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

Consulta la documentación de CMake para obtener más detalles.

Prueba el código fuente

Para verificar que todo funcione correctamente, ingresa lo siguiente:

cmake --build build --config Release --target RUN_TESTS -v

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

Limpia los archivos de compilación

Si necesitas volver a instalar OR-Tools, el comando hará lo siguiente:

rm -r build

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

Luego, vuelve a ingresar los comandos:

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


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

Cómo instalar las herramientas OR en tu sistema operativo

Para instalar OR-Tools para .Net en tu sistema operativo, escribe:

cmake --build build --config Release --target INSTALL -v