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

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

معلومات مهمّة

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

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

  • يجب أن تبدأ أي ملفات رموز جديدة بترخيص الإصدار 2.0 من ترخيص Apache:

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

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

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