استخدام 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" من 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 بنجاح:

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

mvn -v

التثبيت باستخدام Maven

لتضمين أدوات OR في تطبيق 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، ويمكنك الآن بدء استخدام OR-أدوات.