الإنشاء من المصدر OR-Tools Python على نظام التشغيل Windows

مقدمة

يشرح هذا الدليل كيفية الإنشاء من المصدر OR-أدوات، مع دعم بلغة Python على نظام التشغيل Windows.

ما لم تكن تخطط لتعديل رمز المصدر أو استخدام أداة حلّ تابعة لجهة خارجية مع OR-الأدوات، ننصحك بتثبيت الحزمة.

وعلى الرغم من أن هذه الإرشادات قد تنطبق أيضًا على أنواع Windows الأخرى، إلا أننا قد اختبروها فقط على أجهزة تفي بالمتطلبات التالية:

نظام التشغيل Windows 10 64 بت (x86_64) مع:

  • Microsoft Visual Studio Enterprise لعام 2022
  • معاينة 2 أو الإصدارات الأحدث لمنتدى Microsoft Visual Studio لعام 2022

المتطلبات الأساسية

توضح الأقسام التالية المتطلبات الأساسية لتثبيت أدوات OR.

استوديو بصري

لإنشاء أدوات OR وتشغيلها على نظام التشغيل Windows، يجب أن يكون لديك Visual Studio 2022 أو مثبتة لاحقًا على جهاز الكمبيوتر باستخدام مجموعة أدوات C++ لـ Visual Studio.

ويمكنك الاطّلاع على المزيد من التفاصيل هنا.

لإنشاء برامج أدوات OR من سطر الأوامر، يجب استخدام موجِّه أوامر x64 Native Tools (ليس موجِّه أوامر المطوّرين).

ويمكنك الاطّلاع على المزيد من التفاصيل هنا.

Git

Git، والذي يمكن تنزيله من https://git-scm.com/.

CMake

CMake (>= 3.18)، الذي يمكن تنزيله من https://www.cmake.org/download. عند تثبيت CMake، حدد خيار ملف cmake يمكن الوصول إليه من خلال سطر الأوامر.

Python

يجب أن يكون لديك أحد إصدارات Python التالية:

بعد ذلك، تحقَّق من توفّر النقطة 9.01 أو أعلى في مسار PATH:

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

تنزيل رمز المصدر

يوجد فرعان مختلفان لرمز المصدر OR-أدوات على GitHub: stable وmain.

تم اختبار فرع stable بدقة ومن المفترض أن يعمل بشكل لا تشوبه شائبة على جميع والمنصات المتوافقة.
يمكنك الاطّلاع في فرع main على آخر الأخبار تم تطبيق التحسينات أكثر حداثة، لكنها أقل ثباتًا.

تنزيل رمز المصدر الثابت

يمكنك الحصول على رمز المصدر الثابت لـ OR-أدوات بإحدى الطريقتين التاليتين:

  • استنساخ فرع 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 علامة. على سبيل المثال، للعمل مع الإصدار 9.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 عن مكتبة Gurobi المشتركة في مسار التثبيت التلقائي لأدوات تثبيت Gurobi على MAC OS X وWindows، أو باستخدام متغير بيئة GUROBI_HOME.

.

استخدام أداة اختيارية تابعة لجهة خارجية لحل ملفات MIP

يمكنك أيضًا استخدام أدوات OR مع أي من عناصر MIP الاختيارية التالية والتابعة لجهات خارجية أدوات الحلّ التي يكون دعمها غير مفعَّل تلقائيًا:

يُرجى إلقاء نظرة على هذه المستندات لمزيد من التفاصيل.

إنشاء رمز المصدر

لإنشاء رمز المصدر، افتح نافذة طرفية وانتقِل إلى الدليل حيث قمت باستخراج الملفات. ثم أدخل الأمر التالي لتجميع OR-Tools:

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

الاطّلاع على مستندات CMake لمزيد من التفاصيل.

اختبار رمز المصدر

يمكنك التحقّق من سير كل الأمور بشكل صحيح من خلال إدخال ما يلي:

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

هذا يقوم بتشغيل أمثلة لأدوات OR. إذا تم تشغيل جميع الأمثلة بنجاح، فأنت على استعداد بدء استخدام أدوات OR.

تنظيف ملفات الإصدار

إذا كنت بحاجة إلى إعادة تثبيت 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 على نظام التشغيل

يمكنك تثبيت OR-أدوات للغة Python على نظام التشغيل لديك عن طريق إدخال:

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