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

يحتوي نموذج Blockly على محتوى إضافي متعلق بـ Blockly وغير مضمّن في المستودع الأساسي، بما في ذلك المكوّنات الإضافية ودروس البرمجة ونماذج التعليمات البرمجية. لمزيد من التفاصيل حول كل من هذه العناصر، راجِع صفحة بنية المستودع.

معلومات مهمة

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

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

  • يجب أن تكون جميع ملفات الرموز الجديدة مسبوقة بترخيص Apache License v2.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. في حال اجتياز جميع الاختبارات، يمكنك فتح طلب سحب مقابل main مع التغييرات التي أجريتها.