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