Como usar as ferramentas OR Maven para Java

Introdução

Neste guia, você vai começar a usar ferramentas OR em Java com um exemplo simples de trabalho.

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 de 64 bits (x86_64)
  • MacOS 13.0.1 (Ventura) M1 (arm64)

Pré-requisitos

As seções a seguir descrevem os pré-requisitos para a instalação das ferramentas OR.

Ferramentas de linha de comando do Xcode

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

xcode-select --install

Clique em "Install" para fazer o download e instalar as ferramentas de linha de comando do Xcode. Não é necessário "Obter Xcode" na App Store. Se a conexão de Internet for lenta, isso pode levar muitos 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 do 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 Bebê, faça o seguinte:

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

Você pode testar se o Maven está instalado corretamente e encontrar o Java usando o seguinte comando:

mvn -v

Como instalar com o Maven

Para incluir ferramentas OR no seu aplicativo Maven, adicione uma dependência nos 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.9.3963</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.9 --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, está tudo pronto para começar a usar OR-Tools.