Mem-build dari sumber OR-Tools C++ di Linux

Pengantar

Panduan ini menjelaskan cara mem-build dari OR-Tools sumber, dengan dukungan untuk C++, 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 23.10 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

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

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

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

Menginstal OR-Tools di sistem operasi Anda

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

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

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