استخدام OR-Tools Maven للغة 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 وتثبيتها. لن تحتاج إلى "الحصول على Xcode" من متجر التطبيقات. إذا كان اتصال الإنترنت بطيء، قد يستغرق الأمر عدة دقائق.

تأكَّد من تثبيت أدوات سطر أوامر 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:

brew --version

من المفترض أن يظهر لك ما يلي:

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

جافا JDK

يجب تثبيت الإصدار 8.0 من Java JDK أو إصدار أحدث.

بعد تثبيت 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 بشكل صحيح ويمكنك العثور على جافا باستخدام الأمر التالي:

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