שימוש ב-Maven עבור OR-Tools עבור Java

הקדמה

המדריך הזה יעזור לכם להתחיל לעבוד עם OR-Tools ב-Java, בעזרת דוגמה פשוטה לעבודה.

יכול להיות שההוראות האלה יפעלו גם בגרסאות אחרות של 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-bit (x86_64)
  • Ubuntu 23.10 בגרסת 64 סיביות (x86_64)
  • Ubuntu 22.04 LTS ב-64 סיביות (x86_64)
  • Ubuntu 20.04 LTS ב-64 סיביות (x86_64)

דרישות מוקדמות

בקטעים הבאים מתוארים הדרישות המוקדמות להתקנת OR-Tools.

Java JDK >= 8.0

כדי להתקין את Java JDK מגרסה 8.0 ואילך, פותחים חלון מסוף ומזינים:

Alpine

sudo apk add openjdk8
export JAVA_HOME=/usr/lib/jvm/java-1.8-openjdk

סנטוס

sudo yum install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel

Debian

sudo apt install -y default-jdk
export JAVA_HOME=/usr/lib/jvm/default-java

פדורה

sudo dnf install -y java-openjdk java-openjdk-devel

פדורה

sudo dnf install -y java-openjdk java-openjdk-devel

OpenSUSE

sudo zypper install -y java-1_8_0-openjdk java-1_8_0-openjdk-devel

Ubuntu

sudo apt install -y default-jdk

Ubuntu

sudo apt install -y default-jdk

Ubuntu

sudo apt install -y default-jdk

Maven >= 3.3

כדי להתקין את Maven גרסה 3.3 ואילך, פותחים חלון טרמינל ומזינים:

Alpine

sudo apk add maven

סנטוס

sudo yum install -y maven

Debian

sudo apt install -y maven

פדורה

sudo dnf install -y maven

פדורה

sudo dnf install -y maven

OpenSUSE

sudo zypper install -y maven

Ubuntu

sudo apt install -y maven

Ubuntu

sudo apt install -y maven

Ubuntu

sudo apt install -y maven

אפשר לבדוק ש-Maven מותקן כראוי ולמצוא את Java באמצעות הפקודה הבאה: 

mvn -v

התקנה באמצעות Maven

כדי לכלול OR-Tools באפליקציה שלכם ב-Maven, צריך להוסיף תלות בפריטי המידע שנוצרו בתהליך הפיתוח (Artifact) לקובץ ה-pom.xml של הפרויקט. לדוגמה,

<!-- https://mvnrepository.com/artifact/com.google.ortools/ortools-java -->
<dependency>
    <groupId>com.google.ortools</groupId>
    <artifactId>ortools-java</artifactId>
    <version>9.9.3963</version>
</dependency>

קבלת הקוד לדוגמה של Java

הקוד לדוגמה נמצא במאגר java_or-tools.

  1. מורידים את המאגר כקובץ ZIP ומחלצים אותו, או משכפלים אותו:

    git clone -b v9.9 --depth 1 https://github.com/or-tools/java_or-tools

  2. עוברים לספריית הדוגמאות:

    cd java_or-tools

יצירת הדוגמה

מהספרייה java_or-tools:

בנו את הפרויקט באמצעות:

mvn compile -B

הפעלת הדוגמה

מהספרייה java_or-tools:

מריצים את הקובץ הבינארי באמצעות:

mvn exec:java

כל הכבוד! פשוט מריצים אפליקציה באמצעות OR-Tools, ומתחילים לעבוד עם OR-Tools.