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

تصف هذه الصفحة كيفية تثبيت Bazel على نظام التشغيل macOS وإعداد بيئتك.

يمكنك تثبيت Bazel على نظام التشغيل macOS باستخدام إحدى الطرق التالية:

تتوفّر في Bazel نصّان مكتملان. بعد تثبيت Bazel، يمكنك:

التثبيت باستخدام أداة التثبيت الثنائية

أدوات التثبيت الثنائية موجودة على صفحة إصدارات GitHub في Bazel.

تحتوي أداة التثبيت على البرنامج الثنائي Bazel. ويجب أيضًا تثبيت بعض المكتبات الإضافية حتى يعمل تطبيق Bazel.

الخطوة 1: تثبيت أدوات سطر أوامر Xcode

إذا كنت لا تريد استخدام قواعد ios_*، يكفي تثبيت حزمة أدوات سطر أوامر Xcode باستخدام xcode-select:

xcode-select --install

وبخلاف ذلك، بالنسبة إلى دعم القاعدة ios_*، يجب أن يكون لديك Xcode 6.1 أو إصدار أحدث مع تثبيت iOS 8.1 على نظامك.

يمكنك تنزيل Xcode من App Store أو موقع مطوّري برامج Apple.

بعد تثبيت Xcode، يمكنك قبول اتفاقية الترخيص لجميع المستخدمين باستخدام الأمر التالي:

sudo xcodebuild -license accept

الخطوة 2: تنزيل أداة تثبيت Bazel

بعد ذلك، نزِّل أداة تثبيت Bazel الثنائية التي تحمل اسم bazel-<version>-installer-darwin-x86_64.sh من صفحة إصدارات Bazel على GitHub.

على نظام التشغيل macOS Catalina أو الإصدارات الأحدث (نظام التشغيل macOS >= 11)، بسبب متطلبات توقيع التطبيق الجديدة من Apple، يجب تنزيل أداة التثبيت من الوحدة الطرفية باستخدام curl مع استبدال أداة التثبيت متغيّر الإصدار مع إصدار Bazel الذي تريد تنزيله:

export BAZEL_VERSION=5.2.0
curl -fLO "https://github.com/bazelbuild/bazel/releases/download/$BAZEL_VERSION/bazel-$BAZEL_VERSION-installer-darwin-x86_64.sh"

هذا هو حل مؤقت حتى يدعم تدفق إصدار نظام التشغيل macOS التوقيع (#9304).

الخطوة 3: تشغيل أداة التثبيت

شغِّل أداة تثبيت Bazel على النحو التالي:

chmod  x "bazel-$BAZEL_VERSION-installer-darwin-x86_64.sh"
./bazel-$BAZEL_VERSION-installer-darwin-x86_64.sh --user

تعمل العلامة --user على تثبيت Bazel في دليل $HOME/bin على نظامك، وضبط مسار .bazelrc على $HOME/.bazelrc. استخدِم الأمر --help للاطّلاع على خيارات التثبيت الإضافية.

إذا كنتعلى نظام التشغيل macOS Catalina أو الإصدارات الأحدث (macOS >= 11) وظهور رسالة خطألا يمكن فتح "bazel-real" لأنّه لا يمكن التحقّق من مطوّر البرامج. ، عليك إعادة تنزيل أداة التثبيت من الوحدة الطرفية باستخدامcurl كحل بديل؛ يُرجى الاطِّلاع على الخطوة 2 أعلاه.

الخطوة 4: إعداد بيئتك

في حال تشغيل أداة تثبيت Bazel باستخدام العلامة --user أعلاه، يتم تثبيت Bazel القابلة للتنفيذ في دليل HOME/bin. يُفضَّل إضافة هذا الدليل إلى المسارات التلقائية، كما يلي:

export PATH="PATH:HOME/bin"

يمكنك أيضًا إضافة هذا الأمر إلى ملف ~/.bashrc أو ~/.zshrc أو ~/.profile.

اكتملت عملية الإعداد. يمكنك التأكّد من تثبيت Bazel بنجاح من خلال تنفيذ الأمر التالي:

bazel --version

للتحديث إلى إصدار أحدث من Bazel، نزِّل الإصدار المطلوب وثبِّته.

جارٍ التثبيت باستخدام Homebrew

الخطوة 1: تثبيت Homebrew على نظام التشغيل macOS

ثبِّت Homebrew (خطوة لمرة واحدة):

/bin/bash -c "$(curl -fsSL \
https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

الخطوة 2: تثبيت Bazel من خلال Homebrew

ثبِّت حزمة Bazel من خلال Homebrew على النحو التالي:

brew install bazel

اكتملت عملية الإعداد. يمكنك التأكّد من تثبيت Bazel بنجاح من خلال تنفيذ الأمر التالي:

bazel --version

بعد التثبيت، يمكنك الترقية إلى إصدار أحدث من Bazel باستخدام الأمر التالي:

brew upgrade bazel