Como usar as ferramentas OR Maven para Java

Introdução

Neste guia, você aprenderá a usar as ferramentas OR em Java com um exemplo simples e funcional.

Embora essas instruções também possam funcionar em outras variantes do MacOS, as testamos apenas em máquinas que atendem aos seguintes requisitos:

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

Pré-requisitos

As seções a seguir descrevem os pré-requisitos para instalar as Ferramentas OU.

Ferramentas de linha de comando do Xcode

É necessário instalar as ferramentas de linha de comando do Xcode. Para fazer isso, abra o terminal, encontrado em /Applications/Utilities/, e insira:

xcode-select --install

Clique em "Instalar" para fazer o download e instalar as ferramentas de linha de comando do Xcode. Não é necessário "Obter Xcode" na App Store. Se sua conexão com a Internet for lenta, isso pode levar alguns minutos.

Verifique se você instalou as ferramentas de linha de comando do Xcode:

xcode-select -p

Você vai ver:

/Library/Developer/CommandLineTools

Homebrew

Para instalar os pré-requisitos restantes, recomendamos primeiro instalar o "gerenciador de pacotes ausente para macOS", conhecido também como Homebrew. Para fazer isso, abra uma janela de terminal e digite:

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

Para verificar se você instalou o brew corretamente:

brew --version

Você vai ver:

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

JDK do Java

É necessário instalar o Java JDK 8.0 ou posterior.

Depois de instalar o Homebrew, instale o openjdk abrindo uma janela de terminal e digite:

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

Em seguida, você precisa exportar a variável JAVA_HOME:

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

Maven

É necessário instalar o Maven.

Depois de instalar o Homebrew, instale o maven abrindo uma janela do terminal e digitando:

brew install maven

Teste o Maven instalado corretamente e encontre Java usando este comando:

mvn -v

Como instalar com o Maven

Para incluir OR-Tools no aplicativo Maven, adicione uma dependência dos artefatos ao arquivo pom.xml do projeto. Por exemplo:

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

Acessar o código de exemplo do Java

O código de exemplo está localizado no repositório java_or-tools.

  1. Faça o download do repositório como um arquivo ZIP e extraia-o ou clone o repositório:

    git clone -b v9.10 --depth 1 https://github.com/or-tools/java_or-tools
    
  2. Mude para o diretório de exemplos:

    cd java_or-tools
    

Criar o exemplo

No diretório java_or-tools:

Crie o projeto usando:

mvn compile -B

Executar o exemplo

No diretório java_or-tools:

Execute o binário usando:

mvn exec:java

Parabéns! Você acabou de executar um aplicativo com OR-Tools e está pronto para começar a usar OR-Tools.