Introdução
Este guia explica como criar a partir de ferramentas OR de origem, com suporte para Java, no Windows.
A menos que você pretenda modificar o código-fonte ou usar um solucionador de terceiros com ferramentas OR, recomendamos a instalação do pacote (link em inglês).
Embora essas instruções também funcionem em outras variantes do Windows, as testamos apenas em máquinas que atendem aos seguintes requisitos:
Windows 10 de 64 bits (x86_64) com:
- Microsoft Visual Studio Enterprise 2022.
- Microsoft Visual Studio Community 2022 Preview 2 ou mais recente
Pré-requisitos
As seções a seguir descrevem os pré-requisitos para instalar as Ferramentas OU.
Visual Studio
Para criar e executar ferramentas OR no Windows, você precisa ter o Visual Studio 2022 ou mais recente instalado no seu computador com o conjunto de ferramentas C++ para Visual Studio.
Veja mais detalhes aqui.
Para criar programas OR-Tools a partir da linha de comando, você precisa usar um Prompt de comando Native Tools x64 (não o prompt de comando do desenvolvedor).
Veja mais detalhes aqui.
Git
Git, disponível para download em https://git-scm.com/ (link em inglês).
CMake
CMake (>= 3.18), para download em https://www.cmake.org/download (link em inglês). Ao instalar o CMake, selecione a opção para um cmake acessível por linha de comando.
JDK do Java
Também é necessário ter um Java JDK de 64 bits, versão 8.0 ou mais recente instalado.
Confira mais detalhes neste link.
Maven
Também é necessário ter um Maven de 64 bits instalado.
Veja mais detalhes aqui.
Faça o download do código-fonte
Há duas ramificações distintas do código-fonte OR-Tools no
GitHub: stable
e main
.
A ramificação stable
foi testada e funciona perfeitamente em todas as
plataformas com suporte.
A ramificação main
é onde as atualizações e
melhorias mais recentes foram aplicadas. Ela é mais atual, mas menos estável.
Fazer o download do código-fonte estável
É possível obter o código-fonte estável para OR-Tools de uma das seguintes maneiras:
Clone a ramificação
stable
digitando:git clone https://github.com/google/or-tools
Faça o download da versão mais recente em um arquivo compactado clicando no botão
Clone or download
no GitHub.
Fazer o download do código-fonte principal
Para recuperar o código-fonte da ramificação main
, digite:
git clone -b main https://github.com/google/or-tools
Fazer o download de versões anteriores
É possível conseguir o código-fonte de versões anteriores de uma das seguintes maneiras:
- Faça o download de uma versão anterior na página de versão do GitHub.
Supondo que você já tenha criado um repositório local (por
git clone
), confira uma versão específica usando uma tag do Git. Por exemplo, para trabalhar com a versão v9.9 em vez da ramificaçãomain
, insira os seguintes comandos no seu repositório local:git fetch --all --tags --prune
git checkout tags/v9.9 -v v9.9
Configure o build
Antes de criar ferramentas OR, configure o gerador do sistema de build do CMake.
Abra um terminal e navegue até o diretório onde você extraiu os arquivos. Em seguida, insira o seguinte comando:
cmake -S . -B build -DBUILD_DEPS=ON -DBUILD_JAVA=ON
.
Confira a documentação do CMake para mais detalhes.
Como usar o SCIP
Desde a v7.8, o SCIP agora está integrado para que você não precise instalá-lo manualmente.
Como usar o Gurobi
O Gurobi agora está pré-integrado. Quando necessário, no ambiente de execução, as ferramentas OR vão procurar
a biblioteca compartilhada Gurobi no caminho de instalação padrão dos instaladores do Gurobi
no MAC OS X e no Windows ou usando a variável de ambiente GUROBI_HOME
.
Como usar um solucionador MIP de terceiros opcional
Também é possível usar ferramentas OU com qualquer um dos seguintes solucionadores de MIP de terceiros opcionais com suporte desativado por padrão:
- CPLEX (link em inglês)
- GLPK (somente Linux e MacOS)
- Solucionador XPRESS
Consulte esta documentação para mais detalhes.
Criar o código-fonte
Para criar o código-fonte, abra um terminal e navegue até o diretório em que você extraiu os arquivos. Insira o seguinte comando para compilar ferramentas OR:
cmake --build build --config Release --target ALL_BUILD -j -v
Confira a documentação do CMake para mais detalhes.
Testar o código-fonte
Você pode verificar se tudo está funcionando corretamente inserindo:
cmake --build build --config Release --target RUN_TESTS -v
Isso executa exemplos de ferramentas OU. Se todos os exemplos forem executados com sucesso, você estará pronto para começar a usar as ferramentas OR.
Como limpar os arquivos de build
Se você precisar reinstalar o OR-Tools, o comando:
rm -r build
vai remover todas as dependências compiladas. Isso pode ser útil para redefinir para um estado limpo.
Em seguida, insira os comandos novamente:
cmake -S . -B build -DBUILD_DEPS=ON -DBUILD_JAVA=ON
cmake --build build --config Release --target ALL_BUILD -j -v
Como instalar o OR-Tools em seu sistema operacional
Você pode instalar OU-Tools para Java em seu sistema operacional digitando:
cmake --build build --config Release --target INSTALL -v