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

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

معلومات مهمة

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

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

  • يجب أن يتضمّن أي ملفات رموز جديدة البادئة "ترخيص Apache‏ 2.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. إذا كانت هناك أخطاء في أداة فحص الأخطاء، يمكنك تشغيل npm run lint:fix لإصلاح المشاكل التي يمكن حلّها تلقائيًا. عليك معالجة أي تحذيرات أو أخطاء متبقية من مدقّق الأخطاء.
  10. إذا اجتازت جميع الاختبارات، يعني ذلك أنّك مستعد لفتح طلب إعادة نظر في الإصدار develop يتضمّن تغييراتك.