เกริ่นนำ
คู่มือนี้อธิบายวิธีสร้างจากแหล่งที่มา "หรือ" ซึ่งรองรับ .Net บน Linux
เราขอแนะนำให้ติดตั้งแพ็กเกจ เว้นแต่ว่าคุณวางแผนที่จะแก้ไขซอร์สโค้ดหรือใช้เครื่องมือแก้โจทย์ของบุคคลที่สามร่วมกับ "หรือ"
แม้ว่าวิธีการเหล่านี้อาจใช้ได้กับตัวแปรอื่นๆ ของ Linux ด้วย แต่เราได้ทดสอบคำสั่งดังกล่าวในเครื่องที่เป็นไปตามข้อกำหนดต่อไปนี้เท่านั้น
- Alpine Edge 64 บิต (x86_64)
- Centos 7 LTS 64 บิต (x86_64)
- Debian SID 64 บิต (x86_64)
- Debian 11 (bullseye) 64 บิต (x86_64)
- Fedora 38 64 บิต (x86_64)
- Fedora 37 64 บิต (x86_64)
- OpenSuse Leap 64 บิต (x86_64)
- Ubuntu 24.04 64 บิต (x86_64)
- Ubuntu 22.04 LTS 64 บิต (x86_64)
- Ubuntu 20.04 LTS 64 บิต (x86_64)
ข้อกำหนดเบื้องต้น
ส่วนต่อไปนี้จะอธิบายข้อกำหนดเบื้องต้นสำหรับการติดตั้ง OR-เครื่องมือ
เครื่องมือ C++
หากต้องการติดตั้งเครื่องมือ C++ ให้เปิดหน้าต่างเทอร์มินัลแล้วป้อนข้อมูลต่อไปนี้
Alpine
apk add alpine-sdk linux-headers cmake lsb-release-minimal
เซนโตส
sudo yum groupinstall -y 'Development Tools'
sudo yum install -y pkgconfig redhat-lsb-core
เดเบียน
sudo apt update
sudo apt install -y build-essential cmake lsb-release
หมวก Fedora
sudo dnf groupinstall -y 'Development Tools'
sudo dnf install -y gcc-c++ cmake redhat-lsb-core
หมวก 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
สวิก
หากต้องการติดตั้ง SWIG ให้เปิดหน้าต่างเทอร์มินัลแล้วป้อนข้อมูลต่อไปนี้
Alpine
apk add swig
เซนโตส
sudo yum install -y swig
เดเบียน
sudo apt install -y swig
หมวก Fedora
sudo dnf install -y swig
หมวก Fedora
sudo dnf install -y swig
OpenSUSE
sudo zypper install -y swig
Ubuntu
sudo apt install -y swig
Ubuntu
sudo apt install -y swig
Ubuntu
sudo apt install -y swig
.Net Core SDK >= 3.1
ถัดไป ให้ติดตั้ง .Net Core SDK เวอร์ชัน 3.1 ขึ้นไป โดยเปิดหน้าต่างเทอร์มินัลแล้วป้อนข้อมูลต่อไปนี้
Alpine
apk add dotnet6-sdk
ref: https://learn.microsoft.com/en-us/dotnet/core/install/linux-alpine
เซนโตส
อ้างอิง: https://learn.microsoft.com/th-th/dotnet/core/install/linux-centos#centos-7sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm
sudo yum install -y dotnet-sdk-6.0
เดเบียน
ก่อนติดตั้ง .NET ให้เรียกใช้คำสั่งต่อไปนี้เพื่อเพิ่มคีย์การลงนามแพ็กเกจของ Microsoft ในรายการคีย์ที่เชื่อถือได้และเพิ่มที่เก็บแพ็กเกจ
wget https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb
อ้างอิง: https://learn.microsoft.com/th-th/dotnet/core/install/linux-debiansudo apt update
sudo apt install -y dotnet-sdk-6.0
หมวก Fedora
sudo dnf install -y dotnet-sdk-6.0
อ้างอิง: https://learn.microsoft.com/th-th/dotnet/core/install/linux-fedora
หมวก Fedora
sudo dnf install -y dotnet-sdk-6.0
อ้างอิง: https://learn.microsoft.com/th-th/dotnet/core/install/linux-fedora
OpenSUSE
ก่อนติดตั้ง .NET ให้เรียกใช้คำสั่งต่อไปนี้เพื่อเพิ่มคีย์การลงนามแพ็กเกจของ Microsoft ในรายการคีย์ที่เชื่อถือได้และเพิ่มที่เก็บแพ็กเกจ
sudo zypper install libicu
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
wget https://packages.microsoft.com/config/opensuse/15/prod.repo
sudo mv prod.repo /etc/zypp/repos.d/microsoft-prod.repo
sudo chown root:root /etc/zypp/repos.d/microsoft-prod.repo
จากนั้นคุณจึงจะติดตั้ง .Net SDK โดยใช้คำสั่งต่อไปนี้
sudo zypper install -y dotnet-sdk-6.0
อ้างอิง: https://learn.microsoft.com/th-th/dotnet/core/install/linux-opensuse
Ubuntu
sudo apt install -y dotnet-sdk-6.0
อ้างอิง: https://learn.microsoft.com/th-th/dotnet/core/install/linux-ubuntu
Ubuntu
sudo apt install -y dotnet-sdk-6.0
อ้างอิง: https://learn.microsoft.com/th-th/dotnet/core/install/linux-ubuntu
Ubuntu
sudo apt install -y dotnet-sdk-6.0
อ้างอิง: https://learn.microsoft.com/th-th/dotnet/core/install/linux-ubuntu
ดาวน์โหลดซอร์สโค้ด
ซอร์สโค้ด OR-Tools ใน GitHub มี 2 สาขา ได้แก่ stable
และ main
Branch ของ stable
ได้รับการทดสอบอย่างละเอียดแล้วและจะทํางานได้อย่างราบรื่นในแพลตฟอร์มที่รองรับทั้งหมด
สาขา main
เป็นที่ที่ใช้การอัปเดตและการปรับปรุงล่าสุด ซึ่งเป็นปัจจุบันมากกว่าแต่มีความเสถียรน้อยกว่า
ดาวน์โหลดซอร์สโค้ดที่เสถียร
คุณรับซอร์สโค้ดที่เสถียรสำหรับเครื่องมือ "หรือ" ได้ด้วยวิธีใดวิธีหนึ่งต่อไปนี้
โคลนสาขา
stable
โดยป้อนgit clone https://github.com/google/or-tools
ดาวน์โหลดรุ่นล่าสุดในไฟล์ที่บีบอัดโดยคลิกปุ่ม
Clone or download
ใน GitHub
ดาวน์โหลดซอร์สโค้ดหลัก
หากต้องการเรียกซอร์สโค้ดจากสาขา main
ให้ป้อน:
git clone -b main https://github.com/google/or-tools
ดาวน์โหลดรุ่นก่อนหน้า
คุณสามารถรับซอร์สโค้ดสำหรับรุ่นก่อนหน้าด้วยวิธีใดวิธีหนึ่งต่อไปนี้
- ดาวน์โหลดรุ่นก่อนหน้าจากหน้าการเผยแพร่ของ GitHub
สมมติว่าคุณได้สร้างที่เก็บในเครื่องแล้ว (โดย
git clone
) คุณจะดูรุ่นที่เฉพาะเจาะจงได้โดยใช้แท็ก Git เช่น หากต้องการใช้งานรุ่น v9.10 แทน Branchmain
ให้ป้อนคำสั่งต่อไปนี้ในที่เก็บในเครื่องgit fetch --all --tags --prune
git checkout tags/v9.10 -b v9.10
กำหนดค่าบิลด์
ก่อนที่จะสร้างเครื่องมือ "หรือ" คุณจะต้องกำหนดค่าโปรแกรมสร้างระบบบิลด์ CMake
เปิดเทอร์มินัลและไปยังไดเรกทอรีที่คุณแยกไฟล์ จากนั้นป้อน
cmake -S . -B build -DBUILD_DEPS=ON -DBUILD_DOTNET=ON
ดูรายละเอียดได้ในเอกสารประกอบ CMake
กำลังใช้ SCIP
ตั้งแต่เวอร์ชัน 7.8 เป็นต้นไป SCIP ได้ผสานรวมแล้ว คุณจึงไม่ต้องติดตั้งด้วยตนเอง
การใช้ Gurobi
Gurobi มีการผสานรวมไว้ล่วงหน้าแล้ว เมื่อจำเป็น ในระหว่างรันไทม์ "หรือ" เครื่องมือจะค้นหาไลบรารีที่ใช้ร่วมกันของ Gurobi ในเส้นทางการติดตั้งเริ่มต้นของตัวติดตั้ง Gurobi บน MAC OS X และ Windows หรือโดยใช้ตัวแปรสภาพแวดล้อม GUROBI_HOME
การใช้เครื่องมือแก้โจทย์คณิต MIP ของบุคคลที่สาม (ไม่บังคับ)
นอกจากนี้ คุณยังสามารถใช้เครื่องมือ OR กับโปรแกรมแก้ปัญหา MIP ของบุคคลที่สามที่ไม่บังคับดังต่อไปนี้ ซึ่งปิดใช้การสนับสนุนไว้โดยค่าเริ่มต้นได้
- CPLEX
- GLPK (เฉพาะ Linux และ MacOS เท่านั้น)
- เครื่องมือแก้ปัญหา XPRESS
โปรดดูรายละเอียดในเอกสารนี้
สร้างซอร์สโค้ด
หากต้องการสร้างซอร์สโค้ด ให้เปิดเทอร์มินัลและไปยังไดเรกทอรีที่คุณแยกไฟล์ออกมา จากนั้นป้อนคำสั่งต่อไปนี้เพื่อคอมไพล์ OR-Tools:
cmake --build build --config Release --target all -j -v
ดูรายละเอียดได้ในเอกสารประกอบ CMake
ทดสอบซอร์สโค้ด
คุณสามารถตรวจสอบว่าทุกอย่างทำงานได้อย่างถูกต้องด้วยการป้อน
cmake --build build --config Release --target test -v
ซึ่งจะเป็นการเรียกใช้ตัวอย่างสำหรับ OR-เครื่องมือ หากตัวอย่างทั้งหมดทำงานเสร็จสมบูรณ์ คุณก็พร้อมที่จะเริ่มต้นใช้งาน "หรือ"
การล้างไฟล์บิลด์
หากต้องการติดตั้ง "หรือ" เครื่องมืออีกครั้ง ให้ใช้คำสั่งต่อไปนี้
rm -r build
จะนำทรัพยากร Dependency ที่คอมไพล์แล้วทั้งหมดออก ซึ่งจะเป็นประโยชน์สำหรับการรีเซ็ตสถานะที่ไม่มีข้อมูลใดๆ
จากนั้นป้อนคำสั่งอีกครั้ง
cmake -S . -B build -DBUILD_DEPS=ON -DBUILD_DOTNET=ON
cmake --build build --config Release --target all -j -v
การติดตั้ง OR-เครื่องมือ ในระบบปฏิบัติการของคุณ
คุณสามารถติดตั้ง OR-เครื่องมือสำหรับ .Net บนระบบปฏิบัติการของคุณได้โดยป้อนคำว่า
cmake --build build --config Release --target install -v