المساهمة في المجموعة الأساسية

يحتوي مستودع Blockly الأساسي على الرمز المطلوب لتشغيل أي تطبيق مستند إلى حظر.

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

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

  • فرع العمل هو تطور ويجب وضع جميع العلاقات العامة ضد التطوير.
  • يجب ملء نموذج طلب السحب بالمعلومات المطلوبة.
  • ويجب أن يتوافق الرمز مع دليل نمط TypeScript من Google.
  • استخدم عمليات الالتزام التقليدية في رسائل الالتزام المعتادة واسحب عناوين الطلبات.
  • يجب أن تكون السلاسل المرئية للمستخدم في ملف /msg/messages.js حتى تتم ترجمتها. أقل من 6% من الأشخاص حول العالم يتحدثون الإنجليزية بلغتهم الأم.
  • يجب أن يكون النص الموجود على الكتل بأحرف صغيرة بشكل عام (تمامًا مثل الكلمات الرئيسية في معظم لغات البرمجة).
  • الحفاظ على التوافق مع الأنظمة القديمة. هناك الكثير من تطبيقات Openly المتاحة، لذا يجب عدم تفكيك أي شخص آخر.

  • يجب أن تبدأ أي ملفات رموز جديدة بترخيص الإصدار 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. كتابة اختبارات مبرمَجة عادةً ما تكون هذه الاختبارات ضمن اختبارات موكا في دليل tests/mocha، إلا أنّنا قد نطلب منك إجراء أنواع أخرى من الاختبارات.
  7. شغِّل npm run format لتنسيق الرمز البرمجي وإصلاح بعض مشاكل الوبر تلقائيًا.
  8. يمكنك تشغيل npm test لإجراء الاختبارات المبرمَجة. يؤدي هذا أيضًا إلى تشغيل eslint.
  9. في حال حدوث أخطاء في البرامج غير المرغوب فيها، شغِّل npm run lint:fix لإصلاح المشاكل القابلة للإصلاح تلقائيًا. عليك معالجة أي تحذيرات أو أخطاء متبقّية من الوبر.
  10. بعد اجتياز جميع الاختبارات، تكون جاهزًا لفتح "قاعدة عامة" ضد التطوير بشأن التغييرات التي أجريتها.