Blockly Developer Tools
הוא כלי אינטרנטי למפתחים שמאפשר להפוך חלקים מתהליך ההגדרה של Blockly לאוטומטיים, כולל יצירת בלוקים מותאמים אישית, בניית ערכת הכלים והגדרת סביבת העבודה ב-Blockly.
תהליך הפיתוח ב-Blockly באמצעות הכלי מורכב משלושה חלקים:
- יצירת בלוקים מותאמים אישית באמצעות Block Factory ו-Block Exporter.
- איך יוצרים ערכת כלים וסביבת עבודה שמוגדרת כברירת מחדל באמצעות Workspace Factory.
- הגדרת סביבת העבודה באמצעות Workspace Factory (כרגע זו תכונה באינטרנט בלבד).
כרטיסיית 'חסימת אתר'
בכרטיסייה 'Block Factory' אפשר ליצור הגדרות של בלוקים וגנרטורים של קוד בלוקים לבלוקים מותאמים אישית. בכרטיסייה הזו אפשר ליצור, לשנות ולשמור בקלות בלוקים מותאמים אישית.
הגדרת בלוק
בסרטון הזה מוסבר בפירוט איך מגדירים בלוק. ממשק המשתמש מיושן, אבל המאפיינים של הבלוק שמוצגים בו עדיין מדויקים.
ניהול הספרייה
ההפניות לבלוק מתבצעות לפי השם שלו, ולכן לכל בלוק שרוצים ליצור צריך להיות שם ייחודי. ממשק המשתמש אוכף את הכלל הזה ומבהיר מתי אתם 'שומרים' בלוק חדש ומתי אתם 'מעדכנים' בלוק קיים.
אפשר לעבור בין בלוקים ששמרתם בעבר או ליצור בלוק ריק חדש בלחיצה על הלחצן 'ספרייה'. שינוי השם של בלוק קיים הוא דרך נוספת ליצור במהירות כמה בלוקים עם הגדרות דומות.
ייצוא וייבוא של ספרייה
הבלוק נשמר באחסון המקומי של הדפדפן. ניקוי האחסון המקומי של הדפדפן ימחק את החסימות. כדי לשמור את החסימות לתמיד, צריך להוריד את הספרייה. ספריית הבלוק מורדת כקובץ XML שאפשר לייבא כדי להגדיר את ספריית הבלוק למצב שבו היא הייתה כשהורדתם את הקובץ. חשוב לדעת שיבוא של ספריית בלוקים מחליף את הספרייה הנוכחית, לכן מומלץ לייצא אותה קודם.
תכונות הייבוא והייצוא הן גם הדרך המומלצת לשמור ולשתף קבוצות שונות של בלוקים מותאמים אישית.
הכרטיסייה 'חסימת היצואן'
אחרי שתסיימו לתכנן את הבלוקים, תצטרכו לייצא את הגדרות הבלוק ואת stubs של הגנרטורים כדי להשתמש בהם באפליקציה. כדי לעשות זאת, עוברים לכרטיסייה Block Exporter.
כל הבלוקים ששמורים בספריית הבלוקים יופיעו בבורר הבלוק. לוחצים על הבלוק כדי לבחור אותו או לבטל את הבחירה בו לייצוא. כדי לבחור את כל הבלוקים בספרייה, בוחרים באפשרות 'בחירה' → 'הכול מאוחסן בספריית הבלוק'. אם יצרתם את תיבת הכלים או הגדרתם את סביבת העבודה באמצעות הכרטיסייה Workspace Factory, תוכלו גם לבחור את כל הבלוקים שבהם השתמשתם בלחיצה על 'בחירה' → 'כל הפריטים שנעשה בהם שימוש ב-Workspace Factory'.
הגדרות הייצוא מאפשרות לכם לבחור את שפת הייצוא שאליה אתם רוצים לטרגט, ואת האפשרות לייצא את ההגדרות, את stubs של הגנרטורים או את שניהם עבור הבלוק שנבחר. אחרי שבוחרים את הקבצים, לוחצים על 'ייצוא' כדי להוריד אותם.
הכרטיסייה Workspace Factory
בעזרת Workspace Factory אפשר להגדיר בקלות ערכת כלים ואת קבוצת ברירת המחדל של הבלוקס בסביבת העבודה. אפשר לעבור בין עריכת תיבת הכלים לבין סביבת העבודה ההתחלתית באמצעות הלחצנים 'תיבת כלים' ו'סביבת עבודה'.
בניית ארגז כלים
הכרטיסייה הזו עוזרת ליצור את קובץ ה-XML של Toolbox. ההנחה היא שאתם מכירים את התכונות של Toolbox. אם כבר יש לכם קובץ XML של ערכת כלים שאתם רוצים לערוך כאן, תוכלו לטעון אותו בלחיצה על 'טעינה לעריכה'.
כלי העריכה ללא קטגוריות
אם יש לכם כמה בלוקים ואתם רוצים להציג אותם ללא קטגוריות, פשוט גוררים אותם לסביבת העבודה. הבלוקים יופיעו בכלי התצוגה המקדימה.
תיבת הכלים עם קטגוריות
אם רוצים להציג בלוקים בקטגוריות, לוחצים על הלחצן '+' ובוחרים את הפריט בתפריט הנפתח של הקטגוריה החדשה. הפעולה הזו תוסיף קטגוריה לרשימת הקטגוריות, שאפשר יהיה לבחור ולערוך. בוחרים באפשרות 'Standard Category' (קטגוריה רגילה) כדי להוסיף קטגוריה רגילה של Blockly (לוגיקה, לולאות וכו'), או באפשרות 'Standard Toolbox' (ערכת כלים רגילה) כדי להוסיף את כל הקטגוריות הרגילות של Blockly. משתמשים בלחצני החיצים כדי לשנות את סדר הקטגוריות.
כדי לשנות את השם או הצבע של הקטגוריה שנבחרה, משתמשים בתפריט הנפתח 'עריכת קטגוריה'. גוררים את הבלוק לסביבת העבודה כדי להוסיף אותו לקטגוריה שנבחרה.
בלוקים מתקדמים
כברירת מחדל, אפשר להוסיף לתיבת הכלים את כל הבלוקסטרים הרגילים או את כל הבלוקסטרים שבספרייה. אם יש לכם בלוקים שהוגדרו ב-JSON ושאינם בספרייה, תוכלו לייבא אותם באמצעות הלחצן 'ייבוא בלוקים מותאמים אישית'.
יש להשתמש בחלק מהבלוקים יחד או לכלול בהם ברירת מחדל. כדי לעשות זאת, משתמשים בקבוצות וצללים. כל הבלוקסים שמחוברים בעורך יתווספו לתיבת הכלים כקבוצה. אפשר גם לשנות בלוקים שמצורפים לבלוק אחר לבלוק צל באמצעות בחירת הבלוק הצאצא ולחיצה על הלחצן 'יצירת צל'. הערה: אפשר לשנות לבלוק צל רק בלוקים צאצאים שלא מכילים משתנה.
אם אתם כוללים בערכת הכלים שלהם בלוק של משתנה או פונקציה, כדאי לכלול בערכת הכלים קטגוריה של 'משתנים' או 'פונקציות' כדי לאפשר למשתמשים לנצל את הבלוק במלואו. מידע נוסף על הקטגוריות 'משתנים' או 'פונקציות'
הגדרת סביבת עבודה
כדי להגדיר חלקים שונים בסביבת העבודה, עוברים לכרטיסייה Workspace Factory ובוחרים באפשרות Workspace.
בחירת אפשרויות Workspace
אפשר להגדיר ערכים שונים לאפשרויות ההגדרה ולראות את התוצאה באזור התצוגה המקדימה. כשמפעילים את המרשתת או את הזום, מוצגות אפשרויות נוספות להגדרה. בנוסף, לרוב צריך מרחב עבודה מורכב יותר כדי להשתמש בקטגוריות. פח אשפה וסרגלי גלילה מתווספים באופן אוטומטי כשמוסיפים את הקטגוריה הראשונה.
הוספת בלוקים טעונים מראש לסביבת העבודה
זהו שלב אופציונלי, אבל יכול להיות שתצטרכו לבצע אותו אם אתם רוצים להציג קבוצה של בלוקים במרחב העבודה:
- כשהאפליקציה נטענת.
- כשאירוע מופעל (מעבר לרמה, לחיצה על לחצן עזרה וכו').
גוררים את הבלוק למרחב העריכה כדי לראות אותו בתצוגה המקדימה בסביבת העבודה. אתם יכולים ליצור קבוצות של חסימה, להשבית חסימה ולהפוך חסימה מסוימת לחסימת צל כשתבחרו בה.
אפשר לייצא את הבלוקסים האלה כקובץ 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.
- Toolbox: יצירת קובץ XML כדי לציין את ערכת הכלים.
- Workspace Blocks: יצירת קובץ XML שאפשר לטעון לסביבת עבודה.