تثبيت Bazel على نظام التشغيل Windows

توضّح هذه الصفحة المتطلبات والخطوات اللازمة لتثبيت Bazel على نظام التشغيل Windows. ويتضمن أيضًا خطوات تحديد المشاكل وحلّها وطرقًا أخرى لتثبيت Bazel، مثل استخدام شوكولاتة أو سكوب.

تثبيت Bazel

يتناول هذا القسم المتطلبات الأساسية وإعداد البيئة والخطوات التفصيلية أثناء التثبيت على نظام التشغيل Windows.

التحقّق من النظام

ننصح باستخدام: 64 بت Windows 10 أو الإصدار 1703 (Creators Update) أو إصدار أحدث

للتحقق من إصدار Windows:

• انقر على الزر "بدء".
• اكتب winver في مربع البحث واضغط على Enter.
• من المفترض أن يظهر لك المربّع "لمحة عن Windows" الذي يتضمن معلومات إصدار Windows.

متوافق أيضًا:

• الإصدار 64 بت من نظام التشغيل Windows 7 أو إصدار أحدث

• الإصدار 240 بت من Windows Server 2008 R2 أو الإصدارات الأحدث

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

• المحتوى المرئي C++ الذي يمكن إعادة توزيعه لتطبيق Visual Studio 2015

تنزيل Bazel

مقترَح: استخدام Bazelisk

وبدلاً من ذلك، يمكنك:

• يمكنك تنزيل البرنامج الثنائي من Bazel (bazel-version-windows-x86_64.exe) من GitHub.
• تثبيت Bazel من شوكولاتة
• تثبيت Bazel من Slab
• إصدار Bazel من المصدر

إعداد البيئة

لتسهيل الوصول إلى Bazel بسهولة من أوامر الأوامر أو PowerShell تلقائيًا، يمكنك إعادة تسمية برنامج Bazel الثنائي إلى bazel.exe وإضافته إلى مساراتك التلقائية.

set PATH=%PATH%;path to the Bazel binary

يمكنك أيضًا تغيير متغيّر بيئة PATH لجعله نهائيًا. يمكنك الاطّلاع على كيفية ضبط متغيّرات البيئة.

تم

"النجاح: لقد حمّلت Bazel&"

للتحقُّق من صحة التثبيت، جرِّب تنفيذ ما يلي:

bazel version

بعد ذلك، يمكنك الاطّلاع على مزيد من النصائح والإرشادات هنا:

• تثبيت برامج التجميع ووقت التشغيل
• تحديد المشاكل وحلّها
• أفضل الممارسات على نظام التشغيل Windows
• البرامج التعليمية

تثبيت برامج التجميع ووقت التشغيل

حسب اللغات التي تريد إنشاءها، ستحتاج إلى ما يلي:

• MSYS2 × 86_64

  MSYS2 هو برنامج يُستخدَم لنشر أنظمة تشغيل أساسية لنظام التشغيل Windows. ويحتوي هذا العمود على أدوات Bash ومجموعات Unix الشائعة مثل grep وtar وgit.

  يجب استخدام MSYS2 لإنشاء أهداف تعتمد على Bash أو اختبارها أو تنفيذها. عادةً ما تكون هذه القيم هي genrule وsh_binary وsh_test، ولكن قد يكون هناك المزيد (مثل قواعد Starlark). يعرض Bazel خطأ إذا كان هدف الإصدار يحتاج إلى Bash لكن لم يتمكن Bazel من تحديد موقعه.

• حِزم MSYS2 الشائعة

  ستحتاج على الأرجح إلى إنشاء هذه الأهداف واعتمادها على Bash. لا يتم تثبيت هذه الأدوات تلقائيًا في MSYS2، لذا عليك تثبيتها يدويًا. تحتاج هذه المشاريع التي تعتمد على أدوات Bash في PATH إلى هذه الخطوة (على سبيل المثال من TensorFlow).

  افتح الوحدة الطرفية MSYS2 ونفّذ الأمر التالي:

  pacman -S zip unzip patch diffutils git
  

  اختياري: إذا كنت تريد استخدام Bazel من CMD أو Powershell مع الاستمرار في استخدام أدوات Bash، احرص على إضافة MSYS2_INSTALL_PATH/usr/bin إلى متغيّر بيئة PATH.

• أدوات إصدار استوديو Android 2019 الإلكتروني

  ستحتاج إلى هذا الرمز لإنشاء رمز C++ على نظام التشغيل Windows.

  متوافق أيضًا:

  • Visual Studio 2015 (أو إصدار أحدث) مع الإصدار CC++ وWindows 10 SDK

  • حزمة C++ Build Builds 2015 (أو إصدار أحدث) وحزمة Windows 10 SDK

• Java SE Development Kit 11 (JDK) لنظام التشغيل Windows x64

  ستحتاج إلى هذا الرمز لإنشاء رمز Java.

  متوفر أيضًا: Java 8 و9 و10

• Python 3.6 لنظام التشغيل Windows x86-64

  ستحتاج إليه لإنشاء رمز Python على نظام التشغيل Windows.

  متوافق أيضًا: Python 2.7 أو إصدار أحدث لنظام التشغيل Windows x86-64

تحديد المشاكل وحلّها

Bazel لا يعثر على Bash أو bash.exe

الأسباب المحتملة:

• لقد ثبّت MSYS2 ضمن مسار التثبيت التلقائي.

• ثبّت MSYS2 i686 بدلاً من MSYS2 x86_64

• تم تثبيت MSYS بدلاً من MSYS2

الحل:

تأكَّد من تثبيت MSYS2 x86_64.

إذا لم يساعدك ذلك:

1. انتقِل إلى قائمة "البدء" و"الإعدادات".

2. العثور على الإعداد "تعديل متغيّرات البيئة" في حسابك

3. اطّلِع على القائمة في أعلى الصفحة ("متغيّرات المستخدمين لـ <username>") ثم انقر على الزر "جديد..." أسفله.

4. بالنسبة إلى &;;Variable name" ، أدخِل BAZEL_SH

5. انقر على &تصفح، ملف..."

6. انتقِل إلى الدليل MSYS2، ثم إلى usr\bin أسفل الدليل.

   على سبيل المثال، قد تكون هذه السياسة C:\msys64\usr\bin على نظامك.

7. اختَر الملف bash.exe أو bash وانقر على "حسنًا".

8. يحتوي الحقل "&&;متغيّر القيمة&المتغيّر"الآن على المسار إلى bash.exe. انقر على "حسنًا" لإغلاق النافذة.

9. تم.

   في حال فتح وحدة تحكّم جديدة في cmd.exe أو PowerShell وتشغيل Bazel الآن، ستعثر على Bash.

لم يعثر Bazel على Visual Studio أو Visual C++

الأسباب المحتملة:

• تم تثبيت عدّة إصدارات من Visual Studio

• تثبيت إصدارات مختلفة من Visual Studio وإزالتها

• تثبيت إصدارات مختلفة من حزمة تطوير البرامج (SDK) لنظام التشغيل Windows

• إذا كنت قد ثبّت تطبيق Visual Studio ضمن مسار التثبيت التلقائي.

الحل:

1. انتقِل إلى قائمة "البدء" و"الإعدادات".

2. العثور على الإعداد "تعديل متغيّرات البيئة" في حسابك

3. اطّلِع على القائمة في أعلى الصفحة ("متغيّرات المستخدمين لـ <username>") ثم انقر على الزر "جديد..." أسفله.

4. بالنسبة إلى &;;Variable name" ، أدخِل BAZEL_VC

5. انقر على &تصفح، الدليل..."

6. الانتقال إلى دليل VC في Visual Studio.

   على سبيل المثال، قد تكون هذه الأنظمة C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC في نظامك.

7. اختَر المجلد VC وانقر على"حسنًا".

8. يحتوي الحقل "&&;متغيّر القيمة&المتغيّر"الآن على المسار إلى VC. انقر على "حسنًا" لإغلاق النافذة.

9. تم.

   إذا فتحت محطة cmd.exe أو PowerShell جديدة وشغّلت Bazel الآن، ستعثر على Visual C++.

طرق أخرى لتثبيت Bazel

استخدام شوكولاتة

1. تثبيت مدير الحزمة شوكولاتة

2. تثبيت حزمة Bazel:

   choco install bazel
   

   سيؤدي هذا الأمر إلى تثبيت أحدث إصدار متاح من Bazel وتبعياته، مثل واجهة برمجة التطبيقات MSYS2. ولكن ذلك لن يؤدي إلى تثبيت تقنية C++.

اطّلِع على دليل تركيب الشوكولاتة وصيانتها للحصول على مزيد من المعلومات عن حزمة شوكولاتة.

استخدام النشاط التجاري

1. ثبِّت مدير حِزم Sكوبا باستخدام الأمر PowerShell التالي:

   iex (new-object net.webclient).downloadstring('https://get.scoop.sh')
   

2. تثبيت حزمة Bazel:

   scoop install bazel
   

اطّلِع على دليل تثبيت موقع إلكتروني مع صيانة الطرد للحصول على مزيد من المعلومات حول الحزمة.

إنشاء المحتوى من المصدر

لإنشاء Bazel من البداية بدلاً من تثبيته، راجع التجميع من مصدر.