Mem-build dari sumber OR-Tools .Net di Windows

Pengantar

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

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

Windows 10 64-bit (x86_64) dengan:

• Microsoft Visual Studio Enterprise 2022
• Microsoft Visual Studio Community 2022 Pratinjau 2 atau yang lebih baru

Prasyarat

Bagian berikut menjelaskan prasyarat untuk menginstal Alat OR.

Visual Studio

Untuk membuat dan menjalankan OR-Tools di Windows, Anda harus menginstal Visual Studio 2022 atau yang lebih baru di komputer dengan kumpulan alat C++ untuk Visual Studio.

Anda dapat menemukan detail selengkapnya di sini.

Untuk membuat program OR-Tools dari command line, Anda harus menggunakan Command Prompt Native Tools x64 (bukan Command Prompt Developer).

Anda dapat menemukan detail selengkapnya di sini.

Git

Git, yang dapat didownload dari https://git-scm.com/.

CMake

CMake (>= 3.18), yang dapat didownload dari https://www.cmake.org/download. Saat menginstal CMake, pilih opsi untuk cmake yang dapat diakses dengan command line.

SDK .NET Core 3.1

Anda harus menginstal paket .NET Core 3.1 SDK versi 3.1.100 atau yang lebih tinggi dari lokasi berikut: sdk-3.1.425-windows-x64-installer

SDK .Net 6.0

Anda harus menginstal paket .NET 6.0 SDK dari lokasi berikut: sdk-6.0.403-windows-x64-installer

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 -DBUILD_DOTNET=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_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_DOTNET=ON

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

Menginstal OR-Tools di sistem operasi Anda

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

cmake --build build --config Release --target INSTALL -v

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