Mem-build Java dari sumber OR-Tools di MacOS

Pengantar

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

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 MacOS lainnya, kami hanya mengujinya pada komputer yang memenuhi persyaratan berikut:

  • MacOS 13.0.1 (Ventura) Intel 64-bit (x86_64)
  • MacOS 13.0.1 (Ventura) M1 (arm64)

Prasyarat

Bagian berikut menjelaskan prasyarat untuk menginstal Alat OR.

Alat Command Line Xcode

Anda harus menginstal Alat Command Line Xcode. Untuk melakukannya, buka Terminal yang ada di /Applications/Utilities/, lalu masukkan:

xcode-select --install

Klik “Install” untuk mendownload dan menginstal Alat Command Line Xcode. Anda tidak perlu "Mendapatkan Xcode" dari App Store. Jika Anda memiliki koneksi Internet yang lambat, mungkin perlu waktu beberapa menit.

Verifikasi bahwa Anda telah berhasil menginstal Alat Command Line Xcode:

xcode-select -p

Anda akan melihat:

/Library/Developer/CommandLineTools

Minuman rumahan

Untuk menginstal prasyarat yang tersisa, sebaiknya instal "pengelola paket tidak ada untuk macOS" terlebih dahulu, yang dikenal sebagai Homebrew. Untuk melakukannya, buka jendela terminal dan masukkan:

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

Untuk memverifikasi bahwa Anda telah berhasil menginstal brew:

brew --version

Anda akan melihat:

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

Alat C++

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

brew install cmake wget pkg-config

alat SWIG

Untuk menginstal alat SWIG, buka jendela terminal dan masukkan:

brew install swig

JDK Java

Anda harus menginstal Java JDK 8.0 atau yang lebih tinggi.

Setelah menginstal Homebrew, Anda dapat menginstal openjdk dengan membuka jendela terminal dan memasukkan:

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

Selanjutnya, Anda harus mengekspor variabel JAVA_HOME:

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

Maven

Anda harus menginstal Maven.

Setelah menginstal Homebrew, Anda dapat menginstal maven dengan membuka jendela terminal dan memasukkan:

brew install 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. gambar tombol kloning atau download

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 digunakan dengan rilis v9.9, bukan cabang main, masukkan perintah berikut di repo lokal Anda:

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

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

Lihat dokumentasi CMake untuk mengetahui detailnya.

Menggunakan SCIP

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

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.

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:

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_BUILD -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 RUN_TESTS -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_BUILD -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