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

מבוא

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

יכול להיות שההוראות האלה יפעלו גם בגרסאות אחרות של MacOS, אבל בדקנו אותן רק במכונות שעומדות בדרישות הבאות:

  • MacOS 13.0.1 (Ventura) Intel של 64 סיביות (x86_64)
  • MacOS 13.0.1 (Ventura) M1 (arm64)

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

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

כלי שורת הפקודה Xcode

צריך להתקין את כלי שורת הפקודה של Xcode. לשם כך, פותחים את הטרמינל שנמצא ב-/Applications/Utilities/ ומזינים:

xcode-select --install

צריך ללחוץ על 'התקנה' כדי להוריד ולהתקין את כלי שורת הפקודה של Xcode. אין צורך ללחוץ על "Get Xcode" (להורדת Xcode) מ-App Store. אם יש לכם חיבור אינטרנט איטי, הפעולה עשויה להימשך מספר דקות.

מוודאים שהתקנתם בהצלחה את כלי שורת הפקודה של Xcode:

xcode-select -p

אתם אמורים לראות:

/Library/Developer/CommandLineTools

בירה ביתית

כדי להתקין את שאר הדרישות המוקדמות, אנחנו ממליצים להתקין קודם את "מנהל החבילות החסר ל-macOS", שנקרא גם Homebrew. כדי לעשות זאת, פותחים חלון מסוף ומזינים:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew update

כדי לוודא שהתקנתם את הברקה:

brew --version

אתם אמורים לראות:

Homebrew 1.6.9-8-g25542d7
Homebrew/homebrew-core (git revision 0e0c84; last commit 2018-06-20)

Java JDK

עליך להתקין את Java JDK 8.0 ואילך.

אחרי שמתקינים את Homebrew, אפשר להתקין את openjdk על ידי פתיחת חלון טרמינל ומזינים:

brew install openjdk
sudo ln -sfn /usr/local/opt/openjdk/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk.jdk

לאחר מכן צריך לייצא את המשתנה JAVA_HOME:

export JAVA_HOME=/Library/Java/JavaVirtualMachines/openjdk.jdk

Maven

אתם צריכים להתקין את Maven.

אחרי שמתקינים את Homebrew, אפשר להתקין את maven על ידי פתיחת חלון הטרמינל ומזינים:

brew install maven

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

mvn -v

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

כדי לכלול OR-Tools באפליקציית Maven, מוסיפים תלות בארטיפקטים שלה לקובץ ה-pom.xml של הפרויקט. לדוגמה,

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

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

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

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

    git clone -b v9.10 --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.