المساهمة في العيّنات

تحتوي عيّنات Blockly على محتوى إضافي مرتبط بخدمة Blockly ليس جزءًا من المستودع الأساسي، بما في ذلك الإضافات وبرامج Codelab والأمثلة على الرموز البرمجية. لمزيد من التفاصيل حول كلّ من هذه العناصر، يُرجى الاطّلاع على صفحة بنية المستودع.

معلومات مهمة

في ما يلي نظرة عامة سريعة على الحقائق حول نماذج Blockly التي يجب معرفتها لإنشاء طلب إعادة نظر.

  • فرع العمل هو master ويجب إجراء جميع عمليات إرسال الطلبات البرمجية في هذا الفرع.
  • شغِّل npm install على مستوى الجذر من blockly-samples، وليس على مستوى المكوّن الإضافي الفردي. ‫Blockly-samples هو مستودع متعدّد الوحدات، ما يعني أنّه يحتوي على حِزم متعدّدة في المستودع نفسه، ويعدّ التثبيت على مستوى الجذر جزءًا من سير عمل إدارة المستودع المتعدّد الوحدات باستخدام Lerna.
  • يجب أن يكون الرمز البرمجي متوافقًا مع دليل أسلوب JavaScript أو دليل أسلوب TypeScript من Google، وذلك استنادًا إلى اللغة المستخدَمة.
  • استخدِم العمليات المعتادة للالتزام في رسائل التعليقات وعناوين طلبات الربط.

  • يجب أن يتضمّن أي ملفات رموز جديدة البادئة "ترخيص Apache‏ 2.0":

    /**
 *   @license
 *   Copyright <Current YYYY> Google LLC
 *   SPDX-License-Identifier: Apache-2.0
 */

إجراء تغيير والتحقّق منه

  1. شغِّل npm install على مستوى الجذر من blockly-samples لتثبيت التبعيات.
  2. يمكنك تشغيل npm run start في دليل المكوّن الإضافي لإنشاء خادم وبدء تشغيله وتشغيل صفحة اختبار المكوّن الإضافي. يمكنك استخدام هذه الصفحة للاطّلاع على السلوك الحالي للمكوّن الإضافي، أو إذا كنت بصدد إضافة مكوّن إضافي جديد، عليك جعل هذه الصفحة مفيدة للاختبار حتى يتمكّن الآخرون من الاطّلاع على ما يفعله المكوّن الإضافي. يمكنك الاطّلاع على صفحة المساحة التجريبية للحصول على مزيد من المعلومات.
  3. أدخِل أي تغييرات ضرورية على رمز المكوّن الإضافي.
  4. إذا تركت الخادم قيد التشغيل، سيتم تحميل التغييرات تلقائيًا. بخلاف ذلك، أعِد تشغيل الخادم وتأكَّد من أنّ المكوّن الإضافي يعمل على النحو المتوقّع وعدم ظهور أي أخطاء أو تحذيرات في وحدة التحكّم.
  5. شغِّل npm run build وتأكَّد من عدم حدوث أي أخطاء في عملية الإنشاء.
  6. اكتب اختبارات mocha مبرمَجة في الدليل test/.
  7. انقر على npm run test لتشغيل الاختبارات المبرمَجة.
  8. يمكنك تشغيل npm run lint:fix لإصلاح أخطاء lint. عليك معالجة أي تحذيرات أو أخطاء متبقية.
  9. شغِّل npm run format لتشغيل أداة التنسيق التلقائي.
  10. إذا اجتازت جميع الاختبارات، يعني ذلك أنّك مستعد لفتح طلب إعادة نظر في الإصدار الرئيسي يتضمّن تغييراتك.