عند اختراق الأساس في Blockly أو تطوير مكوّن إضافي، تكون أداة "مساحة اللعب" مفيدة للغاية. يحتوي على مثيل مُعدّ مسبقًا من Blockly يمكنك استخدامه للاختبار أو تصحيح الأخطاء أو إنشاء النماذج الأولية. في Google، يتم تطوير Blockly بالكامل تقريبًا باستخدام "أداة التطوير". كمعاينة، إليك المساحة البسيطة على خادم العرض التوضيحي.
هناك 3 أنواع من الملاعب في Blockly الأساسية: بسيطة ومتقدّمة ومتعدّدة. في نماذج Blockly، لا يتم عادةً استخدام سوى الساحة المتقدّمة.
المتطلبات الأساسية
يستخدم Blockly الآن نظام وحدات الإغلاق. بسبب طريقة تحميلها، يجب جلب وحدات Closure غير المجمّعة من عنوان URL http: أو https:
ولا يمكن جلبها مباشرةً من عناوين URL file:. وبالتالي، لتحميل
مساحة اللعب في الوضع غير المجمّع، يجب تحميلها من خادم ويب محلي.
لقد أنشأنا نصًا برمجيًا يبدأ تشغيل خادم محلي ويحمّل جميع الرموز
المطلوبة لتحميل وحدات Blockly. يجب أن يكون لديك
npm مثبّتًا على جهازك
وتشغيل npm install من جذر Blockly لتثبيت كل
التبعيات.
استخدام Internet Explorer
يستخدم Blockly الآن ميزات متقدّمة في قاعدة بياناته قد لا تكون متوافقة مع Internet Explorer. في التعليمات البرمجية المضغوطة (المجمَّعة)، تتم ترجمة هذه الميزات لتتوافق مع IE، ولكن قد لا يعمل تحميل التعليمات البرمجية غير المضغوطة. إذا loaded carregarte ساحة اللعب في IE، حتى من خلال خادم http محلي، سيحمِّل ملعب اللعب تلقائيًا رمز Blockly المضغوط في محاولة لضمان التوافق. ويمكنك الاطلاع على قسم "الوصول إلى الملاعب مباشرةً" للحصول على مزيد من التفاصيل حول اختبار التغييرات في الملعب في الوضع المضغوط.
Simple Playground
الملعب البسيط هو ما يعتمد عليه ملعبا اللعب الآخران. ويعرض صندوق أدوات ومساحة عمل، ويتيح لك ضبط عدد محدود من الإعدادات.
لفتح المساحة التجريبية، يمكنك تنفيذ
npm run start
من جذر Blockly. تأكد من عدم تشغيل أي برامج أخرى على المنفذ 8080. سيؤدي هذا الأمر إلى تشغيل خادم يستضيف وحدات Blockly و فتح متصفحك تلقائيًا على صفحة "مساحة اللعب". عندما تكون جاهزًا لإيقاف الملعب، قم بإنهاء العملية (ctrl-c في بيئة Mac وLinux).
تشمل ميزات الملعب ما يلي:
- جميع الرموز البرمجية غير مضغوطة للتطوير السريع.
- جميع الوحدات التلقائية (باستثناء بعض الوحدات المتوقّفة نهائيًا)
- جميع أدوات إنشاء اللغات (JavaScript وPython وPHP وLua وDart)
- تسلسل حالة مساحة العمل وتحويلها إلى سلسلة (بتنسيق JSON أو XML)
- التبديل بين تنسيق LTR وRTL
- التبديل بين تنسيقات صندوق الأدوات
- اختبارات الضغط لبرنامج التقديم
- تسجيل جميع الأحداث في وحدة التحكّم
ملعب متقدّم
تحتوي مساحة اللعب المتقدّمة على ميزات إضافية لتسهيل تصحيح أخطاء Blockly. وهذا أيضًا هو المساحة التلقائية المستخدَمة في نماذج Blockly لجميع الإضافات.
يضمّ هذا الملعب جميع ميزات الملعب البسيطة بالإضافة إلى ما يلي:
- يمكن ضبط إعدادات إضافية، مثل حجم الشبكة وعناصر التحكّم في التكبير/التصغير/النقل والعارض والمظهر وغير ذلك.
- يتم تخزين الإعدادات والكتل المستخدَمة مؤقتًا واستخدامها تلقائيًا في المرة التالية التي يتم فيها تحميل الملعب.
- يمكنك الاطّلاع على نتائج كلّ أداة إنشاء في النافذة نفسها.
لبدء "أداة التطوير المتقدّمة" لأي مكوّن إضافي في blockly-samples، يمكنك تشغيل npm run
start من الدليل الجذر للمكوّن الإضافي. يمكن حاليًا تشغيل مكوّن إضافي واحد فقط في كل
مرة، ويستخدم المنفذ 3000. إذا واجهتك مشكلة في بدء تشغيل المكون الإضافي،
فتأكد أولاً من عدم الاستماع إلى أي شيء آخر عبر هذا المنفذ.
لبدء الملعب المتقدم في المستوى الأساسي، شغِّل npm run start من جذر Blockly، ثم انقر على الرابط "إعدادات متقدّمة" تحت العنوان.
يمكنك أيضًا إنشاء صفحة اختبار تتضمّن ساحة اللعب المتقدّمة باستخدام حزمة أدوات المطوّرين في Blockly.
ملعب متعدد
يحتوي "ملاعب متعددة" على عدة ملاعب بإعدادات مختلفة
لوضع LTR وموقع صندوق الأدوات. يُستخدم هذا بشكل أساسي للتحقق بسرعة من أن Blockly لم
تقسِّم أي شيء متعلق بـ LTR قبل الإصدار. لفتح
هذه الساحة، اتّبِع الخطوات الخاصة بالساحة البسيطة، ثمّ غيِّر عنوان
URL إلى /tests/multi_playground.html.
اختبار التغييرات
عند تشغيل أيّ من مساحات اللعب من خادم محلي، ما عليك سوى إعادة تحميل الصفحة في معظم الحالات لاطلاعك على التغييرات التي أجريتها في Blockly. إذا أضفت
ملفًا جديدًا أو أضفت ملفًا جديدًا يعتمد عليه ملف آخر، قد تحتاج أولاً إلى تشغيل npm run
build الذي سيُحدِّث ملف test/deps.js لضمان تحميل الملفات التي يعتمد عليها
بشكل صحيح، ثم إعادة تحميل الصفحة.
إذا كنت تستخدم ميزة "مساحة اللعب المتقدّمة" لمكوّن إضافي، لن تحتاج حتى إلى إعادة تحميل الصفحة. يتم تحميل التغييرات تلقائيًا.
الوصول إلى الملاعب مباشرةً
في السابق، كان يتم الوصول إلى المساحة التجريبية البسيطة محليًا من خلال الانتقال مباشرةً إلىملف test/playground.html في المتصفّح. لا يزال هذا الإجراء ممكنًا باستخدام
الملاعب البسيطة والمتعدّدة، ولكن لم يعُد يُنصح به. في حال إجراء ذلك،
سيرصد "مربّع اللعب" أنّك لا تستخدم خادمًا محليًا ويستخدم
تلقائيًا ملفات Blockly المضغوطة (اطّلِع على
صفحة إنشاء Blockly للحصول على مزيد من
المعلومات)، وكلما غيّرت شيئًا في Blockly الأساسية، عليك
إعادة إنشاء الأساسية وطرح التغييرات. سيظل بإمكانك الوصول إلى هذه الصفحات إذا كانت مستضافة
على خادم بعيد، مثل المثال الذي تم استضافته على موقعنا الإلكتروني التجريبي. ستكون الخلفية
باللون الأزرق الساطع عندما تكون في الوضع المضغوط.
لا تتوفّر ميزة "مساحة اللعب المتقدّمة" من خلال إذن الوصول file:.