Mem-build Java dari sumber OR-Tools di Linux

Pengantar

Panduan ini menjelaskan cara mem-build dari OR-Tools sumber, dengan dukungan untuk Java, di Linux.

Kecuali jika Anda berencana untuk mengubah kode sumber atau menggunakan pemecah masalah pihak ketiga dengan OR-Tools, sebaiknya penginstalan paket.

Meskipun petunjuk ini mungkin juga berfungsi pada varian Linux lainnya, kami hanya mengujinya pada komputer yang memenuhi persyaratan berikut:

• Alpine Edge 64-bit (x86_64)
• Centos 7 LTS 64-bit (x86_64)
• Debian SID 64-bit (x86_64)
• Debian 11 (bullseye) 64-bit (x86_64)
• Fedora 38 64-bit (x86_64)
• Fedora 37 64-bit (x86_64)
• OpenSuse Leap 64-bit (x86_64)
• Ubuntu 24.04 64-bit (x86_64)
• Ubuntu 22.04 LTS 64-bit (x86_64)
• Ubuntu 20.04 LTS 64-bit (x86_64)

Prasyarat

Bagian berikut menjelaskan prasyarat untuk menginstal Alat OR.

Alat C++

Untuk menginstal alat C++, buka jendela terminal dan masukkan:

Alpine

apk add alpine-sdk linux-headers cmake lsb-release-minimal

Sento

sudo yum groupinstall -y 'Development Tools'
sudo yum install -y pkgconfig redhat-lsb-core

Debian

sudo apt update
sudo apt install -y build-essential cmake lsb-release

Topi fedora

sudo dnf groupinstall -y 'Development Tools'
sudo dnf install -y gcc-c++ cmake redhat-lsb-core

Topi fedora

sudo dnf groupinstall -y 'Development Tools'
sudo dnf install -y gcc-c++ cmake redhat-lsb-core

OpenSUSE

sudo zypper refresh
sudo zypper install -y git gcc11 gcc11-c++ lsb-release

Ubuntu

sudo apt update
sudo apt install -y build-essential cmake lsb-release

Ubuntu

sudo apt update
sudo apt install -y build-essential cmake lsb-release

Ubuntu

sudo apt update
sudo apt install -y build-essential cmake lsb-release

ALIHKAN

Untuk menginstal SWIG, buka jendela terminal dan masukkan:

Alpine

apk add swig

Sento

sudo yum install -y swig

Debian

sudo apt install -y swig

Topi fedora

sudo dnf install -y swig

Topi fedora

sudo dnf install -y swig

OpenSUSE

sudo zypper install -y swig

Ubuntu

sudo apt install -y swig

Ubuntu

sudo apt install -y swig

Ubuntu

sudo apt install -y swig

Java JDK >= 8.0

Untuk menginstal Java JDK versi 8.0 atau yang lebih tinggi, buka jendela terminal dan masukkan:

Alpine

sudo apk add openjdk8
export JAVA_HOME=/usr/lib/jvm/java-1.8-openjdk

Sento

sudo yum install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel

Debian

sudo apt install -y default-jdk
export JAVA_HOME=/usr/lib/jvm/default-java

Topi fedora

sudo dnf install -y java-openjdk java-openjdk-devel

Topi fedora

sudo dnf install -y java-openjdk java-openjdk-devel

OpenSUSE

sudo zypper install -y java-1_8_0-openjdk java-1_8_0-openjdk-devel

Ubuntu

sudo apt install -y default-jdk

Ubuntu

sudo apt install -y default-jdk

Ubuntu

sudo apt install -y default-jdk

Maven >= 3,3

Untuk menginstal Maven versi 3.3 atau yang lebih tinggi, buka jendela terminal dan masukkan:

Alpine

sudo apk add maven

Sento

sudo yum install -y maven

Debian

sudo apt install -y maven

Topi fedora

sudo dnf install -y maven

Topi fedora

sudo dnf install -y maven

OpenSUSE

sudo zypper install -y maven

Ubuntu

sudo apt install -y maven

Ubuntu

sudo apt install -y maven

Ubuntu

sudo apt install -y maven

Anda dapat menguji Maven yang telah diinstal dengan benar dan dapat menemukan java menggunakan perintah berikut:

mvn -v

Mendownload kode sumber

Ada dua cabang kode sumber OR-Tools yang berbeda di GitHub: stable dan main.

Cabang stable telah diuji secara menyeluruh dan seharusnya berfungsi dengan baik di semua platform yang didukung.
Cabang main adalah tempat update dan peningkatan terbaru diterapkan. Cabang ini lebih terkini, tetapi kurang stabil.

Mendownload kode sumber yang stabil

Anda bisa mendapatkan kode sumber yang stabil untuk OR-Tools dengan salah satu cara berikut:

• Clone cabang stable dengan memasukkan:

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

• Download rilis terbaru dalam file terkompresi, dengan mengklik tombol Clone or download di GitHub.

Peringatan: Jalur lengkap ke direktori penginstalan (tempat Anda mengekstrak file) tidak boleh berisi spasi.

Mendownload kode sumber utama

Untuk mengambil kode sumber dari cabang main, masukkan:

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

Download rilis sebelumnya

Anda bisa mendapatkan kode sumber untuk rilis sebelumnya dengan salah satu cara berikut:

• Download rilis sebelumnya dari halaman rilis GitHub.

• Dengan asumsi bahwa Anda telah membuat repositori lokal (dengan git clone), Anda dapat memeriksa rilis tertentu menggunakan tag Git. Misalnya, agar dapat menggunakan rilis v9.10, bukan cabang main, masukkan perintah berikut di repo lokal Anda:

  git fetch --all --tags --prune
  git checkout tags/v9.10 -b v9.10
  

Mengonfigurasi build

Sebelum mem-build OR-Tools, Anda harus mengonfigurasi generator sistem build CMake.

Buka terminal dan arahkan ke direktori tempat Anda mengekstrak file. Lalu masukkan:

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

Tips: Untuk mengetahui daftar lengkap opsi CMake OR-Tools yang tersedia, lihat di sini

Lihat dokumentasi CMake untuk mengetahui detailnya.

Menggunakan SCIP

Sejak v7.8, SCIP kini telah terintegrasi sehingga Anda tidak perlu menginstalnya secara manual.

Catatan: Anda dapat menonaktifkan dukungan pemecah masalah SCIP dengan menggunakan -DUSE_SCIP=OFF

Peringatan: Saat OR-Tools dikirimkan dengan SCIP, harap baca lisensi SCEP untuk memastikan bahwa Anda mematuhnya.

Menggunakan Gurobi

Gurobi kini sudah terintegrasi. Jika diperlukan, saat runtime, OR-Tools akan menelusuri library bersama Gurobi di jalur penginstalan default penginstal Gurobi di MAC OS X dan Windows, atau dengan menggunakan variabel lingkungan GUROBI_HOME.

Catatan: Anda dapat menonaktifkan dukungan pemecah masalah Gurobi menggunakan -DUSE_GUROBI=OFF

Menggunakan pemecah MIP pihak ketiga opsional

Anda juga dapat menggunakan OR-Tools dengan salah satu solusi MIP pihak ketiga opsional berikut yang dukungannya dinonaktifkan secara default:

• CPLEX
• GLPK (khusus Linux dan MacOS)
• Pemecah Masalah XPRESS

Lihat dokumentasi ini untuk mengetahui detailnya.

Membangun kode sumber

Untuk mem-build kode sumber, buka terminal, lalu buka direktori tempat Anda mengekstrak file. Kemudian, masukkan perintah berikut untuk mengompilasi OR-Tools:

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

Lihat dokumentasi CMake untuk mengetahui detailnya.

Menguji kode sumber

Anda dapat memeriksa apakah semuanya berjalan dengan benar dengan memasukkan:

cmake --build build --config Release --target test -v

Perintah ini menjalankan contoh untuk OR-Tools. Jika semua contoh berhasil dijalankan, Anda siap untuk mulai menggunakan OR-Tools.

Membersihkan file build

Jika Anda perlu menginstal ulang OR-Tools, perintahnya:

rm -r build

akan menghapus semua dependensi yang dikompilasi. Hal ini dapat berguna untuk mereset ke status bersih.

Lalu masukkan kembali perintahnya:

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

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

Menginstal OR-Tools di sistem operasi Anda

Anda dapat menginstal OR-Tools untuk Java di sistem operasi Anda dengan memasukkan:

cmake --build build --config Release --target install -v

Tips: Untuk mengubah lokasi penginstalan default, lihat dokumentasi CMAKE_INSTALL_PREFIX.