المساهمة في Bazel

ثمة طرق متعدّدة لمساعدة مشروع Bazel والمنظومة المتكاملة.

إدخال تعليق

أثناء استخدام Bazel، قد تظهر لك عناصر يمكن تحسينها. يمكنك تقديم المساعدة من خلال الإبلاغ عن المشاكل عند:

  • إذا تعطّل Bazel أو واجهت خطأً يمكن حله باستخدام bazel clean فقط.
  • المستندات غير مكتملة أو غير واضحة. يمكنك أيضًا الإبلاغ عن المشاكل من الصفحة التي تطّلِع عليها باستخدام الرابط "إنشاء مشكلة&quot في أعلى يسار الصفحة.
  • يمكن تحسين رسالة الخطأ.

المشاركة في المنتديات

يمكنك التفاعل مع منتدى Bazel من خلال:

إضافة رمز

Bazel هو مشروع كبير وقد يكون إجراء تغيير على رمز مصدر Bazel صعبًا.

يمكنك المساهمة في منظومة Bazel المتكاملة من خلال تنفيذ ما يلي:

  • مساعدة الحفاظ على القواعد من خلال المساهمة في طلبات السحب
  • إنشاء قواعد جديدة مفتوحة المصدر.
  • المساهمة في أدوات مرتبطة بتطبيق Bazel، مثل أدوات نقل البيانات
  • تحسين عملية دمج Bazel مع أدوات IDE وأدوات أخرى

قبل إجراء تغيير، أنشِئ مشكلة GitHub أو أرسِل رسالة إلكترونية إلى bazel-dev@.

تساعد المساهمات الأكثر فائدةً في إصلاح الأخطاء أو إضافة ميزات (بدلاً من الأسلوب، أو إعادة الهيكلة، أو "cleanup"التغييرات). ويجب أن يشمل التغيير الاختبارات والمستندات، مع الأخذ في الاعتبار التوافق مع الأنظمة القديمة وإمكانية النقل والتأثير في استخدام الذاكرة والأداء.

وللتعرّف على كيفية إرسال تغيير، يُرجى الاطّلاع على عملية قبول التعديلات.

وصف رمز Bazel'

لدى Bazel قاعدة رموز كبيرة تتضمّن رمزًا في مواقع جغرافية متعددة. اطّلِع على دليل القواعد الأساسية لمزيد من التفاصيل.

تم تنظيم Bazel على النحو التالي:

  • يتوفّر رمز العميل في src/main/cpp ويتم توفير واجهة سطر الأوامر.
  • توجد مخازن البروتوكولات المؤقتة في src/main/protobuf.
  • رمز الخادم متوفّر في src/main/java وsrc/test/java.
    • الرمز الأساسي الذي يتألف في الغالب من Skyإطار وبعض الأدوات
    • القواعد المُضمَّنة في com.google.devtools.build.lib.rules و في com.google.devtools.build.lib.bazel.rules. يمكنك أولاً التعرّف على تحدّيات كتابة القواعد.
  • واجهتا Java الأصلية في src/main/native.
  • يتم وصف الأدوات المختلفة لدعم اللغة في القائمة في قسم دمج Bazel.

جارٍ البحث عن رمز مصدر Bazel's

للبحث سريعًا في رمز مصدر Bazel'، يمكنك استخدام Bazel Code Search. يمكنك التنقّل في مستودعات Bazel&#99 وفرعها وملفاتها. يمكنك أيضًا عرض السجلّ والفروق والمعلومات عن إلقاء اللوم. لمزيد من المعلومات، يمكنك الاطّلاع على دليل مستخدم Bazel Code Search.