Mem-build dari sumber OR-Alat Python di Windows

Pengantar

Panduan ini menjelaskan cara membuat build dari alat OR-sumber, dengan dukungan untuk Python, di Windows.

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

Meskipun instruksi 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 membangun dan menjalankan OR-Tools di Windows, Anda harus memiliki Visual Studio 2022 atau kemudian diinstal di komputer Anda dengan {i> tool set <i}C++ untuk Visual Studio.

Anda dapat menemukan detail selengkapnya di sini.

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

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 command line.

Python

Anda harus menginstal salah satu versi Python berikut:

• Python 3.11.x 64-bit
• Python 3.10.x 64-bit
• Python 3.9.x 64-bit
• Python 3.8.x 64-bit

Kemudian verifikasi bahwa Anda memiliki pip 9.01 atau yang lebih tinggi tersedia di PATH Anda:

python --version
python -c "import platform; print(platform.architecture()[0])"
python -m pip --version

Mendownload kode sumber

Ada dua cabang berbeda dari kode sumber OR-Tools pada GitHub: stable dan main.

Cabang stable telah diuji secara menyeluruh dan akan berfungsi dengan sempurna di semua dan tersedia di platform yang didukung.
Cabang main adalah tempat update dan telah diterapkan; lebih terkini, tetapi kurang stabil.

Mendownload kode sumber stabil

Anda bisa mendapatkan kode sumber 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

Mendownload rilis sebelumnya

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

• Download rilis sebelumnya dari halaman rilis GitHub.

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

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

Mengonfigurasi build

Sebelum membangun OR-Tools, Anda harus mengonfigurasi sistem build CMake web.

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

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

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

Lihat Dokumentasi CMake untuk mengetahui detailnya.

Menggunakan SCIP

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

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

Peringatan: Meskipun OR-Tools disertakan dengan SCIP, lihat Lisensi SCEP untuk memastikan bahwa Anda mematuhinya.

Menggunakan Gurobi

Gurobi kini sudah terintegrasi. Jika diperlukan, saat runtime, OR-Tools akan mencari {i>shared library<i} Gurobi di jalur instal {i>default<i} dari penginstal Gurobi di MAC OS X dan Windows, atau menggunakan variabel lingkungan GUROBI_HOME.

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

Menggunakan pemecah masalah MIP pihak ketiga opsional

Anda juga dapat menggunakan OR-Tools dengan MIP pihak ketiga opsional berikut pemecah masalah yang dukungannya dinonaktifkan secara default:

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

Harap lihat dokumentasi ini untuk mengetahui detailnya.

Membangun kode sumber

Untuk membangun kode sumber, buka terminal dan arahkan ke direktori tempat Anda telah mengekstrak file tersebut. Lalu 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 baik dengan memasukkan:

cmake --build build --config Release --target RUN_TESTS -v

Perintah ini menjalankan contoh untuk OR-Tools. Jika semua contoh 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 melakukan reset ke kondisi bersih.

Lalu, masukkan kembali perintah:

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

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

Menginstal OR-Tools pada sistem operasi Anda

Anda dapat menginstal OR-Tools untuk Python pada sistem operasi Anda dengan memasukkan:

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

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