تثبيت / تحديث Bazel باستخدام Bazelisk

تثبيت Bazel

Bazelisk هي الطريقة المقترَحة لتثبيت Bazel على Ubuntu وWindows وmacOS. يعمل التطبيق تلقائيًا على تنزيل الإصدار المناسب من Bazel وتثبيته. استخدِم Bazlisk إذا كنت بحاجة إلى التبديل بين إصدارات مختلفة من Bazel اعتمادًا على دليل العمل الحالي، أو إبقاء Bazel محدَّثًا دائمًا إلى أحدث إصدار.

للحصول على مزيد من التفاصيل، يمكنك الاطّلاع على القراءة الرسمية الرسمية.

تحديث Bazel

يستخدم Bazel سياسة التوافق مع الأنظمة القديمة (يُرجى الاطّلاع على إرشادات طرح التغييرات غير المتوافقة إذا كنت مؤلفًا). تلخّص هذه الصفحة أفضل الممارسات حول كيفية اختبار مشروعك ونقله مع التغييرات القادمة غير المتوافقة وكيفية تقديم ملاحظات وآراء لمؤلفي التغييرات غير المتوافقة.

إدارة إصدارات Bazel باستخدام Bazelisk

تساعدك أداة Bazelisk على إدارة إصدارات Bazel.

يمكن أن تؤدي قناة Bazelisk إلى ما يلي:

  • عليك تحديث Bazel تلقائيًا إلى أحدث إصدار من LTS أو الإصدار المتجدّد.
  • أنشِئ المشروع باستخدام إصدار Bazel المحدّد في ملف .bazelversion. تحقّق من هذا الملف في عنصر التحكّم في الإصدارات لضمان قابلية إنشاء إصداراتك.
  • المساعدة في نقل بيانات مشروعك للتغييرات غير المتوافقة (انظر أعلاه)
  • تجربة إصدار المرشحين بسهولة

عملية النقل المقترحة

ضمن التحديثات البسيطة لأي إصدار للدعم الطويل الأمد (LTS)، يمكن إعداد أي مشروع للإصدار التالي بدون التأثير على التوافق مع الإصدار الحالي. وقد تكون هناك تغييرات غير متوافقة مع الإصدارات السابقة بين إصدارات LTS الرئيسية.

اتّبِع هذه العملية لنقل البيانات من إصدار رئيسي إلى آخر:

  1. يمكنك الاطّلاع على ملاحظات الإصدار للحصول على نصائح حول كيفية نقل البيانات إلى الإصدار التالي.
  2. يجب أن ترتبط التغييرات الرئيسية غير المتوافقة بعلامة --incompatible_* ومشكلة GitHub مرتبطة بها:
    • تتوفّر إرشادات نقل البيانات في مشكلة GitHub المرتبطة بها.
    • وتتوفّر أدوات لنقل بعض التغييرات غير المتوافقة. على سبيل المثال، buildifer.
    • يمكنك الإبلاغ عن مشاكل نقل البيانات من خلال التعليق على مشكلة GitHub المرتبطة بها.

بعد الترحيل، يمكنك مواصلة العمل على مشاريعك بدون القلق بشأن التوافق مع الأنظمة القديمة حتى الإصدار الرئيسي التالي.