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.
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 cabangmain
, 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
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:
- 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_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