أدوات مطوّري Blockly
هي أداة مطوّرين مستندة إلى الويب تعمل على أتمتة أجزاء من عملية إعداد Blockly، بما في ذلك إنشاء كتل مخصّصة وإنشاء صندوق الأدوات وضبط مساحة عمل Blockly.
تتألف عملية المطوّر في Blockly باستخدام الأداة من ثلاثة أجزاء:
- أنشئ وحدات أساسية مخصّصة باستخدام Block Factory وBlock Exporter.
- أنشئ مجموعة أدوات ومساحة عمل تلقائية باستخدام Workspace Factory.
- يمكنك ضبط مساحة عملك باستخدام Workspace Factory (ميزة متاحة حاليًا على الويب فقط).
حظر علامة التبويب "المصنع"
تساعدك علامة التبويب "إنشاء وحدات" في إنشاء تعريفات الوحدات و أدوات إنشاء رموز الوحدات للوحدات المخصّصة. في علامة التبويب هذه، يمكنك بسهولة إنشاء وحدات مخصّصة وتعديلها وحفظها.
تحديد قالب
يشرح هذا الفيديو بالتفصيل خطوات تحديد مجموعة. واجهة المستخدم قديمة، ولكنّ ميزات الحظر التي تُبرزها لا تزال دقيقة.
إدارة المكتبة
تتم الإشارة إلى الكتل باسمها، لذا يجب أن يكون لكلّ كتلة تريد إنشاؤها اسمًا مختلفًا. تفرض واجهة المستخدم هذا الإجراء وتوضّح لك ما إذا كنت بصدد "حفظ" وحدة جديدة أو "تعديل" وحدة حالية.
يمكنك التبديل بين الكتل التي سبق لك حفظها أو إنشاء كتلة جديدة فارغة بالنقر على زر "المكتبة". يُعدّ تغيير اسم وحدة حالية طريقة أخرى لإنشاء وحدات متعددة بسرعة لها تعريفات مشابهة.
تصدير مكتبة واستيرادها
يتم حفظ المقاطع في مساحة التخزين المحلية للمتصفّح. سيؤدي محو ذاكرة التخزين المؤقت للمتصفّح إلى حذف عمليات الحظر. لحفظ المقاطع لأجل غير مسمى، عليك تنزيل مكتبتك. يتم تنزيل "مكتبة الأشكال" كملف XML يمكن استيراده لضبط "مكتبة الأشكال" على الحالة التي كانت عليها عند تنزيل الملف. يُرجى العلم أنّ استيراد مكتبة وحدات يحلّ محل مكتبتك الحالية، لذا ننصحك بتصديرها أولاً.
وتعدّ ميزتا الاستيراد والتصدير أيضًا الطريقة المقترَحة للحفاظ على مجموعات مختلفة من الكتل المخصّصة ومشاركتها.
علامة التبويب "حظر المُصدِّر"
بعد تصميم الكتل، عليك تصدير تعريفات الكتل وعناصر النموذج لإنشاء الكتل لاستخدامها في تطبيق. ويتم ذلك في علامة التبويب "أداة تصدير الكتل".
سيتم عرض كلّ قالب محفوظ في "مكتبة التنسيقات" في "أداة اختيار التنسيقات". انقر على الكتلة لاختيارها أو إلغاء اختيارها للتصدير. إذا كنت تريد اختيار كل الكتل في مكتبتك، استخدِم الخيار "اختيار" ← "كل العناصر المخزّنة في مكتبة الكتل". إذا أنشأت مجموعة الأدوات أو أعددت مساحة العمل باستخدام علامة التبويب Workspace Factory، يمكنك أيضًا اختيار كل الكتل التي استخدمتها من خلال النقر على "اختيار" ← "كلّ العناصر المستخدَمة في Workspace Factory".
تتيح لك إعدادات التصدير اختيار اللغة التي تم إنشاؤها والتي تريد استهدافها وما إذا كنت تريد التعريفات أو نماذج العناصر في أداة الإنشاء أو كليهما للكلمات المختارة. بعد اختيار هذه الملفات، انقر على "تصدير" لتنزيلها.
علامة التبويب Workspace Factory
يسهّل Workspace Factory ضبط مجموعة الأدوات والمجموعة التلقائية من الكتل في مساحة عمل. يمكنك التبديل بين تعديل صندوق الأدوات و مساحة العمل الافتتاحية باستخدام الزرَّين "صندوق الأدوات" و "مساحة العمل".
إنشاء مجموعة أدوات
تساعد علامة التبويب هذه في إنشاء ملف XML لأداة. تفترض المادة معرفة بميزات مجموعة الأدوات. إذا كان لديك ملف XML لأداة تريد تعديلها هنا، يمكنكتحميله بالنقر على "تحميل لتعديل".
مجموعة الأدوات بدون فئات
إذا كانت لديك بعض الكتل وأردت عرضها بدون أي فئات، ما عليك سوى سحبها إلى مساحة العمل، وستظهر لك الكتل في صندوق الأدوات في المعاينة.
مجموعة أدوات تتضمّن فئات
إذا كنت تريد عرض الكتل في الفئات، انقر على الزر "+" واختَر العنصر المنسدلة للفئة الجديدة. سيؤدي ذلك إلى إضافة فئة إلى قائمة الفئات التي يمكنك اختيارها وتعديلها. اختَر "فئة عادية" لإضافة فئة عادية فردية في Blockly (مثل "منطق" أو "حلقات" أو غير ذلك)، أو اختَر "مجموعة الأدوات العادية" لإضافة كل فئات Blockly العادية. استخدِم زرَّي الأسهم لإعادة ترتيب الفئات.
لتغيير اسم الفئة المحدّدة أو لونها، استخدِم القائمة المنسدلة "تعديل الفئة". سيؤدي سحب وحدة إلى مساحة العمل إلى إضافتها إلى الفئة المختارة.
الوحدات المتقدّمة
يمكنك تلقائيًا إضافة أيّ من الكتل العادية أو أيّ كتل في مكتبتك إلى صندوق الأدوات. إذا كانت لديك وحدات محدّدة بتنسيق JSON غير مضمّنة في مكتبتك، يمكنك استيرادها باستخدام الزر "استيراد وحدات مخصّصة".
يجب استخدام بعض الكتل معًا أو تضمين الإعدادات التلقائية. ويتم ذلك باستخدام المجموعات والظلال. ستتم إضافة أي كتل متصلة في المحرِّر إلى صندوق الأدوات كمجموعة. يمكن أيضًا تغيير الكتل المرتبطة بكتل أخرى إلى كتل ظلّ من خلال اختيار الكتلة الفرعية والنقر على الزر "إنشاء ظلّ". ملاحظة: يمكن تغيير الكتل الفرعية التي لا تحتوي على متغيّر إلى كتل ظلّ فقط.
إذا أدرجت متغيّرًا أو مجموعة دوالّ في صندوق الأدوات، أدرِج فئة "المتغيّرات" أو "الدوالّ" في صندوق الأدوات للسماح للمستخدمين باستخدام المجموعة بالكامل. اطّلِع على مزيد من المعلومات عن فئات"المتغيّرات" أو "الدوالّ".
ضبط مساحة عمل
لضبط أجزاء مختلفة من مساحة العمل، انتقِل إلى علامة التبويب "Workspace Factory" وانقر على "مساحة العمل".
اختيار "خيارات مساحة العمل"
حدِّد قيمًا مختلفة لخيارات الإعداد واطّلِع على النتيجة في منطقة المعاينة. يؤدي تفعيل الشبكة أو التكبير/التصغير إلى إظهار المزيد من الخيارات التي يمكنك ضبطها. بالإضافة إلى ذلك، يتطلّب التبديل إلى استخدام الفئات عادةً مساحة عمل أكثر تعقيدًا، ويتمّ تلقائيًا إضافة سلة المهملات وأشرطة التمرير عند إضافة فئتك الأولى.
إضافة وحدات تم تحميلها مسبقًا إلى مساحة العمل
هذا الإجراء اختياري، ولكن قد يكون ضروريًا إذا كنت تريد عرض مجموعة من الكتل في مساحة العمل:
- عند تحميل التطبيق
- عند بدء حدث (الانتقال إلى مستوى أعلى، النقر على زر مساعدة، وما إلى ذلك)
اسحب الكتل إلى مساحة التعديل لعرضها في مساحة العمل في المعاينة. يمكنك إنشاء مجموعات من العناصر المحظورة، وإيقاف العناصر المحظورة، وجعل عناصر معيّنة تحجب العناصر الأخرى عند اختيارها.
يمكنك تصدير هذه الكتل بتنسيق XML (راجِع ما يلي). يمكنك إضافتها إلى مساحتك باستخدام
Blockly.Xml.domToWorkspace بعد إنشاء مساحتك مباشرةً:
var xmlText = '<xml xmlns="https://developers.google.com/blockly/xml">' +
'<block type="math_number"></block></xml>';
Blockly.Xml.domToWorkspace(Blockly.utils.xml.textToDom(xmlText), workspace);
يضيف نموذج الرمز البرمجي هذا كتلة math_number واحدة إلى مساحة العمل.
التصدير
يوفّر لك Workspace Factory خيارات التصدير التالية:
- الرمز المبدئي: يُنشئ رمز HTML وJavaScript مبدئيَين لإدراج مساحتك المخصّصة في Blockly.
- صندوق الأدوات: يُنشئ ملف XML لتحديد صندوق الأدوات.
- وحدات Workspace: تُنشئ ملف XML يمكن تحميله إلى مساحة عمل.