ساختن از منبع OR-Tools Python در ویندوز

مقدمه

این راهنما نحوه ساخت از منبع OR-Tools را با پشتیبانی از پایتون در ویندوز توضیح می دهد.

نصب بسته را توصیه می کنیم مگر اینکه قصد تغییر کد منبع را داشته باشید یا از یک حل کننده شخص ثالث با OR-Tools استفاده کنید.

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

ویندوز 10 64 بیتی (x86_64) با:

  • Microsoft Visual Studio Enterprise 2022
  • Microsoft Visual Studio Community 2022 Preview 2 یا بالاتر

پیش نیازها

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

ویژوال استودیو

برای ساخت و اجرای OR-Tools در ویندوز، باید Visual Studio 2022 یا جدیدتر را با مجموعه ابزار C++ برای Visual Studio روی رایانه خود نصب کرده باشید.

شما می توانید جزئیات بیشتر را در اینجا بیابید.

برای ساختن برنامه‌های OR-Tools از خط فرمان، باید از خط فرمان x64 Native Tools ( نه خط فرمان توسعه‌دهنده) استفاده کنید.

شما می توانید جزئیات بیشتر را در اینجا بیابید.

Git

Git که می توانید آن را از https://git-scm.com/ دانلود کنید.

CMake

CMake (>= 3.18) ، که می توانید آن را از https://www.cmake.org/download دانلود کنید. هنگام نصب CMake، گزینه cmake قابل دسترسی در خط فرمان را انتخاب کنید.

پایتون

شما باید یکی از نسخه های زیر پایتون را نصب کرده باشید:

سپس بررسی کنید که پیپ 9.01 یا بالاتر را در PATH خود در دسترس دارید: 

python --version
python -c "import platform; print(platform.architecture()[0])"
python -m pip --version

کد منبع را دانلود کنید

دو شاخه مجزا از کد منبع OR-Tools در GitHub وجود دارد: stable و main .

شاخه stable به طور کامل آزمایش شده است و باید در تمام پلتفرم های پشتیبانی شده بدون نقص کار کند.
شعبه main جایی است که آخرین به روز رسانی ها و بهبودها اعمال شده است. این جریان بیشتر است، اما کمتر پایدار است.

کد منبع پایدار را دانلود کنید

می توانید کد منبع پایدار OR-Tools را به یکی از روش های زیر دریافت کنید:

  • کلون شاخه stable را با وارد کردن:

    git clone https://github.com/google/or-tools

  • با کلیک روی دکمه Clone or download در GitHub ، آخرین نسخه را در یک فایل فشرده دانلود کنید. تصویر کلون یا دکمه دانلود

کد منبع اصلی را دانلود کنید

برای بازیابی کد منبع از شعبه main ، وارد کنید: 

git clone -b main https://github.com/google/or-tools

دانلود نسخه های قبلی

می توانید کد منبع نسخه های قبلی را به یکی از راه های زیر دریافت کنید:

  • نسخه قبلی را از صفحه انتشار GitHub دانلود کنید.

  • با فرض اینکه قبلاً یک مخزن محلی ایجاد کرده اید (با git clone )، می توانید یک نسخه خاص را با استفاده از تگ Git بررسی کنید. به عنوان مثال، برای کار با نسخه v9.10 به جای شاخه main ، دستورات زیر را در مخزن محلی خود وارد کنید: 

    git fetch --all --tags --prune
git checkout tags/v9.10 -b v9.10

ساخت را پیکربندی کنید

قبل از ساختن OR-Tools، باید مولد سیستم ساخت CMake را پیکربندی کنید.

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

cmake -S . -B build -DBUILD_DEPS=ON -DBUILD_PYTHON=ON

برای جزئیات ، اسناد CMake را بررسی کنید.

با استفاده از SCIP

از نسخه 7.8، SCIP اکنون یکپارچه شده است، بنابراین نیازی به نصب دستی آن ندارید.

با استفاده از Gurobi

Gurobi اکنون از قبل یکپارچه شده است. در صورت نیاز، در زمان اجرا، OR-Tools کتابخانه مشترک Gurobi را در مسیر نصب پیش‌فرض نصب‌کننده‌های Gurobi در MAC OS X و Windows یا با استفاده از متغیر محیطی GUROBI_HOME جستجو می‌کند.

با استفاده از یک حل کننده MIP شخص ثالث اختیاری

همچنین می‌توانید از OR-Tools با هر یک از حل‌کننده‌های MIP شخص ثالث اختیاری زیر که پشتیبانی آن به‌طور پیش‌فرض غیرفعال است، استفاده کنید:

لطفاً برای جزئیات بیشتر به این مستند نگاهی بیندازید.

کد منبع را بسازید

برای ساختن کد منبع، یک ترمینال را باز کنید و به دایرکتوری که فایل ها را در آن استخراج کرده اید بروید. سپس دستور زیر را برای کامپایل OR-Tools وارد کنید:

cmake --build build --config Release --target ALL_BUILD -j -v

برای جزئیات ، اسناد CMake را بررسی کنید.

کد منبع را تست کنید

با وارد کردن زیر می توانید بررسی کنید که همه چیز به درستی اجرا می شود:

cmake --build build --config Release --target RUN_TESTS -v

این نمونه هایی را برای OR-Tools اجرا می کند. اگر همه نمونه ها با موفقیت اجرا شوند، آماده شروع با OR-Tools هستید.

پاک کردن فایل های ساخت

اگر نیاز به نصب مجدد OR-Tools دارید، دستور:

rm -r build

تمام وابستگی های کامپایل شده را حذف می کند. این می تواند برای بازنشانی به حالت تمیز مفید باشد.

سپس دوباره دستورات را وارد کنید: 

cmake -S . -B build -DBUILD_DEPS=ON -DBUILD_PYTHON=ON


cmake --build build --config Release --target ALL_BUILD -j -v

نصب OR-Tools بر روی سیستم عامل شما

می توانید OR-Tools for Python را با وارد کردن زیر بر روی سیستم عامل خود نصب کنید:

cmake --build build --config Release --target INSTALL -v