المساهمة في إنشاء "عيّنات"

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

معلومات مهمة

فيما يلي نظرة عامة سريعة على حقائق حول العينات الكتلية التي تحتاج إلى معرفتها لإنشاء إعلان عام.

• الفرع العامل هو 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 لإصلاح أخطاء الوبر. عالج أي تحذيرات أو أخطاء متبقية.
9. شغِّل npm run format لتشغيل أداة التنسيق التلقائي.
10. إذا اجتازت جميع الاختبارات، يعني ذلك أنّك مستعد لفتح طلب إعادة نظر في الإصدار الرئيسي يتضمّن تغييراتك.