כלי פיתוח

ב-Blockly משתמשים במספר כלים וספריות לפיתוח, כולל Git, npm ו-Closure Compiler. בקטע הזה נספק כמה תיאורים בסיסיים של כל כלי, וגם קישורים למידע נוסף על כל כלי.

אנחנו משתמשים ברבים מהכלים האלה באמצעות סקריפטים. לפעמים לא צריך להריץ אותם באופן ישיר. ידיעת השמות עדיין יכולה לעזור לניפוי באגים, לשליחת בעיות או לשליחת בקשות להוספת תכונות.

Git

Git היא מערכת לניהול גרסאות שמשמשת אותנו כדי לעקוב אחרי שינויים בקבצים ולנהל אותם.

GitHub

GitHub היא פלטפורמת אירוח לניהול גרסאות, לשיתוף פעולה ולהפצה של קוד פתוח. Git עוקב אחרי הקבצים, ו-GitHub מספק ממשקים חלקים לבדיקת קוד, למעקב אחרי בעיות ולהצגת היסטוריית שינויים.

תחילת העבודה: אם זו הפעם הראשונה שאתם משתמשים ב-Git וב-GitHub, מומלץ לעיין במדריכים לquickstart ב-GitHub כדי להכיר את היסודות.

צומת

Node.js הוא דרך להפעלת JavaScript בשרת (ולא בדפדפן). npm (ראו בהמשך) פועל בצומת.

נשימות בדקה

הערך npm הוא שני דברים:

• כלי שורת הפקודה שמשמש אותנו להתקנת יחסי תלות ולהרצת סקריפטים.
• מרשם באינטרנט שבו אנחנו מפרסמים את הקוד שלנו, שמאפשר למפתחים אחרים להשתמש בקלות ב-Blockly.

תחילת העבודה: התקנה של צומת ו-npm.

מהדר חסימות

Closure Compiler הוא כלי שמאפשר להוריד ולהפעיל JavaScript מהר יותר. אנחנו משתמשים בו כדי לשלב את כל קובצי JavaScript בספרייה אחת, ומשתמשים בו גם כדי לבדוק את התחביר והסוגים.

תחילת העבודה: אין צורך להתקין או להפעיל את 'מהדר חסימות' ישירות. אנחנו מתקינים ומריצים אותו באמצעות npm.

מידע נוסף: תיעוד של מהדר סגירה על סוגי JavaScript והערות הקלדה.

ESLint

ESLint הוא מנתח סטטי שמוצא בעיות בקוד JavaScript. אנחנו משתמשים בו כדי להגדיר ולאכוף סגנון עקבי בכל ה-codebase שלנו. בעיות קטנות בקוד (חסרות נקודה ופסיק, רווחים לא עקביים וכו') נקראות לעיתים קרובות lint. ESLint פועל באופן אוטומטי כשאתם שולחים לנו בקשת משיכה. אפשר גם להריץ אותו באופן מקומי.

איך מתחילים: גם ב-Blockly Core וגם ב-blockly-samples, אפשר להריץ את ESLint באמצעות npm run lint. לעורכי קוד רבים יש גם שילובים של ESLint, שמאפשרים להציג בעיות במהלך ההקלדה.

מידע נוסף: לכל כלל ESLint יש דף תיעוד שמתאר את הכלל עם דוגמאות לקוד נכון ושגוי.

מוקה

Mocha היא מסגרת בדיקה של JavaScript. אנחנו משתמשים בו כדי להריץ בדיקות בדפדפן וב-Node.js (לתרחישים לדוגמה ללא GUI).

איך מתחילים: גם ב-Blockly Core וגם ב-blockly-samples, תוכלו להריץ את בדיקות Mocha באמצעות npm run test. ב-Blockly Core, יופעלו גם בדיקות אחרות. בדיקות Mocha שלBlockly Core מוגדרות בספרייה tests/mocha.

מידע נוסף: אפליקציית Mocha מאפשרת למפתחים להגדיר hooks, שמאפשרים להגדיר פעולות של הגדרה מרכזית וניתוק עבור הבדיקות.

צ'אי

Chai היא ספריית טענות נכוֹנוּת (assertion) שבה אנחנו משתמשים בבדיקות מוקה שלנו.

מידע נוסף: בצ'אי יש כמה "טעמים" של תחביר, כדי להקל על השילוב עם פרויקטים קיימים. חברתBlockly משתמשת בטעם assert.