Blockly Developer Tools هي أداة للمطوّرين مستنِدة إلى الويب يمكنها مساعدتك في إنشاء وحدات أساسية مخصّصة وتضمينها في تطبيقك.
تحديد حظر
ستبدأ مساحة عمل Block فترة زمنية بكتلة ضبط فارغة. يمكنك إضافة إدخالات وحقول إلى الكتلة من خلال سحب الوحدات من الفئات المعنية في مربع الأدوات. يمكنك أيضًا ضبط نص التلميح وعنوان URL للمساعدة واللون وعمليات التحقّق من الاتصال للحظر من خلال تعديل كتلة الضبط.
يمكن لمصنع الحظر إنشاء نوع واحد فقط من الكتل في المرة الواحدة. إذا كنت ترغب في تصميم عدة كتل متصلة ببعضها البعض، عليك تصميم القوالب بشكل منفصل وربطها في تعريف مربع الأدوات. بالإضافة إلى ذلك، يمكن أن تشتمل الوحدات المحظورة على ميزات متقدّمة، مثل mutator، ولكن لا يمكن إنشاء هذه الميزات المتقدّمة في مصانع. سيتعين عليك تعديل تعريف الكتلة وفقًا للوثائق بعد إنشاء الشكل الأساسي للكتلة.
أثناء تعديل كتلة الضبط في مساحة العمل، سيتم تعديل معاينة هذا القسم تلقائيًا. سيتم أيضًا تحديث الكود الذي ستحتاج إلى إضافته إلى تطبيقك تلقائيًا.
إعداد الإخراج
يتوافق الحظر مع طرق مختلفة لتحديد الكتل وتحميل Blockly بنفسه، بالإضافة إلى استخدام عدة لغات مُدمجة لإنشاء الرموز البرمجية. تعتمد طريقة تحديد الكتل ومولدات أكواد الحظر على هذه العوامل، لذا يمكنك إعدادها في "Block Machine" لتغيير ناتج الرمز.
تنسيق الاستيراد المحظور
يمكنك تحميل Blockly من خلال علامات <script> في HTML أو باستخدام عبارات import إذا كنت تستخدم أداة إنشاء مع تطبيقك. يؤثر هذا الاختيار في كيفية الإشارة إلى
أجزاء معينة من واجهة برمجة التطبيقات Blockly. للحصول على مزيد من المعلومات حول الخيارات التي يمكنك الاختيار منها، يمكنك الاطّلاع على المستندات حول التحميل Blockly.
وأيًا كانت الطريقة التي تستخدمها، تأكد من تحديد الخيار المناسب في
Block Favorite بحيث يكون الرمز الذي ستضيفه إلى التطبيق دقيقًا لتطبيقك.
حظر تنسيق التعريف
تتيح حظر المحتوى تحديد الوحدات بتنسيق JSON أو JavaScript. يُفضَّل استخدام تنسيق JSON، ولكن إذا كنت ستضيف ميزات متقدّمة مثل المتغيرات، يمكنك استخدام تنسيق JavaScript.
لغة أداة إنشاء الرمز
يتم الشحن بشكل محظور مع لغات أداة إنشاء الرموز متعددة. اختر اللغات التي يحتاجها تطبيقك لعرض دليل منشئ كود الكتلة المقابل. إذا كنت تستخدم أداة إنشاء لغة مخصّصة، يمكنك
تعديل اسم فئة CodeGenerator المخصّصة بعد نسخ الرمز
في تطبيقك.
ناتج الرمز
تعرض لك الأقسام التالية من "Block Machine" الرمز الذي ستحتاج إلى نسخه في تطبيقك من أجل تحميل المجموعة التي أنشأتها. يعتمد مكان نسخ الرمز على كيفية هيكلة تطبيقك، ولكن بشكل عام، ستحتاج إلى تشغيل رؤوس الرموز قبل التعريف ومنشئ رمز الحظر وتعريفات الكتل قبل محاولة استخدامها في صندوق الأدوات وأدوات إنشاء كود الكتلة قبل محاولة إنشاء رمز لمساحة عمل. يمكنك استخدام الزر "نسخ" في كل قسم لنسخ مجموعة الرموز الخاصة بهذا القسم بالكامل.
إذا كنت لا تزال غير متأكد من كيفية استخدام ناتج الرمز، يمكنك الاطّلاع على نموذج التطبيق الذي يحتوي على أمثلة على عمليات الحظر المخصّصة وأدوات إنشاء رموز الحظر.
عناوين الرموز
يعرض قسم Code Headers (عناوين التعليمات البرمجية) الكود الذي تحتاجه لتحميل مكتبة Blockly الأساسية ومنشئ اللغة الذي اخترته. قد تكون هناك إعدادات أخرى هنا أيضًا؛ على سبيل المثال، بعض الحقول التي قد تُدرجها في مجموعة مصدر من المكوّنات الإضافية المحظورة. سيكون لهذه المكونات الإضافية عبارات استيراد خاصة بها وربما تعليمات برمجية أخرى يجب عليك تشغيلها لتهيئة الحقل. يجب تضمين هذه التعليمة البرمجية قبل أي من أقسام التعليمة البرمجية التالية.
حظر التعريف
تعريف القالب هو الطريقة التي تحدد بها Blockly شكل الكتلة، مثل الحقول والمدخلات المتوفرة بها واللون وغير ذلك. بعد تشغيل هذا الرمز، سيعرف تطبيق Blockly كيفية إنشاء حظر استنادًا إلى
type الخاص به.
إذا كنت تستخدم نموذج التطبيق، يمكنك تضمين هذا الرمز في ملف ضمن الدليل blocks/. إذا كانت لديك بنية تطبيقك الخاصة، فتأكد من تضمين هذا الرمز قبل محاولة الإشارة إلى مجموعة بالاسم، كما هو الحال في تعريف مربع الأدوات. في كلتا الحالتين، تأكد من وجود عناوين التعليمات
البرمجية في الملف الذي تقوم فيه بتضمين هذه التعليمة البرمجية.
بكعب مولّد
أداة إنشاء رموز الحظر هي الطريقة التي تصف بها الرمز الذي يجب إنشاؤه للكتلة. يمنحك كعب المنشئ الذي تم إنشاؤه بواسطةBlock مصانع الكود الأساسي للحصول على قيم المدخلات والحقول الموجودة في الكتلة الخاصة بك. الأمر متروك لك لدمج هذه القيم في التعليمة البرمجية النهائية التي سيتم إنشاؤها!
إذا كنت تستخدم نموذج التطبيق، يمكنك تضمين هذا الرمز في ملف ضمن الدليل generators/. إذا كانت لديك بنية تطبيقك الخاصة، تأكّد من تضمين هذا الرمز قبل محاولة إنشاء رمز لمساحة عمل تتضمّن الوحدات الأساسية المخصّصة. في كلتا الحالتين، تأكد من وجود رؤوس التعليمات
البرمجية في الملف الذي تقوم فيه بتضمين هذه التعليمة البرمجية.
جولة تفصيلية من خلال الفيديو
يشرح هذا الفيديو خطوات تحديد الجزء بشكل مفصَّل. واجهة المستخدم قديمة، ولكن ميزات الحظر التي يبرزها لا تزال أكثر أو أقل دقة.
حظر المكتبة
يتم حفظ القوالب في التخزين المحلي للمتصفّح تلقائيًا في أي وقت تُجري فيه تغييرًا على الحظر. يمكنك إنشاء كتلة جديدة أو تحميل كتلة حالية من مساحة التخزين المحلية لديك من خلال النقر على الأزرار المقابلة في شريط الأدوات العلوي.
الاستيراد من مصنع الحظر القديم
إذا كنت قد استخدمت الإصدار القديم من "أداة حظر الحظر" وأردت نقل تعريفات الحظر الحالية إلى الأداة الجديدة، يمكنك اتّباع الخطوات التالية:
في "Block factor" القديم، انقر على الزر
Export Block Libraryفي شريط الأدوات. سيؤدي هذا إلى تنزيل ملف بجميع تعريفات الحظر.
في "مصنع الحظر" الجديد، انقر على الزر "
Load block" في شريط الأدوات.حدِّد خيار "الاستيراد من مصنع الحظر" في القائمة.
حمِّل الملف الذي نزّلته في الخطوة 1.
من المفترض أن يتم تحويل تعريفات الحظر تلقائيًا إلى التنسيق الجديد وستكون متاحة الآن من قائمة
Load block. ربما تمت إعادة تسمية الكتل إذا كان هناك تعارضات مع الكتل الحالية.إذا كانت هناك أخطاء في تحليل أي من مجموعاتك، فلن نتمكن من تحميلها. يمكنك مساعدتنا من خلال تقديم تقرير عن خطأ للعينات المحظورة وتضمين الملف الذي لا يمكن تحليله.