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

مقدمة

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

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

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

Windows 10 64 بت (x86_64) مع:

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

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

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

استوديو مرئي

لإنشاء "أدوات OR" وتشغيلها على Windows، يجب تثبيت 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 يمكن الوصول إليه من خلال سطر الأوامر.

حزمة SDK. NET Core 3.1

يجب تثبيت حزمة .NET Core 3.1 SDK بالإصدار 3.1.100 أو إصدار أحدث من الموقع التالي: sdk-3.1.425-windows-x64-installer

.Net 6.0 SDK

يجب تثبيت الحزمة .NET 6.0 SDK من الموقع التالي: sdk-6.0.403-windows-x64-installer.

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

هناك فرعين مختلفان لرمز المصدر 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. على سبيل المثال، لاستخدام الإصدار v9.9 بدلاً من فرع main، أدخِل الأوامر التالية في Repo المحلي:

    git fetch --all --tags --prune
git checkout tags/v9.9 -v v9.9

ضبط الإصدار

قبل إنشاء أدوات OR، ستحتاج إلى إعداد منشئ نظام إصدار CMake.

افتح وحدة طرفية وانتقِل إلى الدليل الذي استخرجت الملفات فيه. ثم أدخِل:

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

راجِع وثائق CMake للحصول على التفاصيل.

استخدام SCIP

تم دمج SCIP منذ الإصدار 7.8، لذا لن تحتاج إلى تثبيته يدويًا.

استخدام Gurobi

تم دمج Gurobi مسبقًا. عند الحاجة، وفي وقت التشغيل، ستبحث OR-Tools عن مكتبة Gurobi المشتركة في مسار التثبيت التلقائي لأدوات تثبيت Gurobi على نظام التشغيل MAC OS X وWindows، أو باستخدام متغير بيئة GUROBI_HOME.

.

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

يمكنك أيضًا استخدام "أدوات" أو "أدوات" مع أي من حلول MIP الاختيارية التالية التابعة لجهات خارجية والتي يتم إيقاف دعمها تلقائيًا:

يُرجى الاطّلاع على هذه المستندات للحصول على التفاصيل.

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

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

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

راجِع وثائق CMake للحصول على التفاصيل.

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

يمكنك التحقق من أن كل شيء يعمل بشكل صحيح من خلال إدخال:

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

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

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

إذا كنت بحاجة إلى إعادة تثبيت OR-الأدوات، فإن الأمر:

rm -r build

سيزيل جميع التبعيات المجمّعة. ويمكن الاستفادة من ذلك في إعادة الضبط على الحالة النظيفة.

بعد ذلك، أعِد إدخال الأوامر:

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


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

تثبيت OR-أدوات على نظام التشغيل لديك

يمكنك تثبيت OR-أدوات لـ .Net على نظام التشغيل لديك من خلال إدخال:

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