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

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