استفاده از OR-Tools Maven برای جاوا

معرفی

این راهنما با یک مثال کار ساده شما را با OR-Tools در جاوا شروع می کند.

اگرچه این دستورالعمل‌ها ممکن است روی دیگر انواع MacOS نیز کار کنند، ما آنها را فقط روی ماشین‌هایی آزمایش کرده‌ایم که شرایط زیر را داشته باشند:

  • MacOS 13.0.1 (Ventura) اینتل 64 بیتی (x86_64)
  • MacOS 13.0.1 (Ventura) M1 (arm64)

پیش نیازها

بخش های زیر پیش نیازهای نصب OR-Tools را شرح می دهند.

ابزارهای خط فرمان Xcode

شما باید Xcode Command Line Tools را نصب کنید. برای انجام این کار، ترمینال موجود در /Applications/Utilities/ را باز کنید و وارد کنید:

xcode-select --install

برای دانلود و نصب Xcode Command Line Tools روی "Install" کلیک کنید. شما نیازی به "دریافت Xcode" از اپ استور ندارید. اگر اینترنت کندی دارید، ممکن است چند دقیقه طول بکشد.

بررسی کنید که Xcode Command Line Tools را با موفقیت نصب کرده اید:

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

باید 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 را نصب کنید.

هنگامی که 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.10.4067</version>
</dependency>

کد نمونه جاوا را دریافت کنید

کد مثال در مخزن java_or-tools قرار دارد.

  1. مخزن را به صورت یک فایل فشرده دانلود کنید و آن را استخراج کنید یا مخزن را شبیه سازی کنید:

    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 آماده هستید.