المساهمة في تحسين الأداء الأساسي

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

معلومات مهمة

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

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

• يجب أن تكون جميع ملفات الرموز الجديدة مسبوقة بترخيص Apache License v2.0:

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

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

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