Blockly הוא קוד פתוח, שמתוחזק בעיקר על ידי צוות קטן. אנחנו מקבלים בברכה תרומות ממפתחים שאינם צוות הליבה. אין לנו דרך לבנות כל תכונה שמתקבלת או לתקן כל באג שדווח ללא הקהילה שלנו. כאן יש מדריכים כלליים שיכולים לעזור לכם, במיוחד אם אתם מפתחים חדשים בקוד פתוח.
למידע ספציפי על Blockly שעליכם לקרוא לפני הוספת תוכן, קראו את המאמרים הבאים: תרומה לליבה ותרומה לדגימות.
איזה מאגר נתונים?
מאגר מכיל את כל הקבצים לפרויקט אחד. ל-Blockly יש שני מאגרים: ליבה בלוקי (blockly Core) וקטעים לדוגמה.
Blockly Core הוא המאגר של ספריית Blockly. השתמשו במאגר הזה אם אתם רוצים לשנות את ההתנהגות העיקרית של Blockly באופן שיחול על כל המשתמשים בספרייה.
בלוקים לדוגמה הוא המאגר לדוגמאות, ליישומי פלאגין ול-Codelabs. השתמשו במאגר הזה אם אתם רוצים ליצור או לשנות פלאגין, לכתוב Codelab או ליצור או לשנות דוגמה.
הדרכה מפורטת
אלה השלבים הכלליים שצריך לבצע בכל פעם שמבצעים שינוי.
- התקנה Git וצומת, בהתאם לקישורים בקטע כלים.
- משכפלים ומשכפלים את המאגר. ל-GitHub יש מדריך נהדר על זיוף של מאגר מאגר תמונות. כדי להחיל אותו על Blockly, צריך להחליף את כל המופעים של octocat/Spoon-Knife ב-google/blockly או ב-google/blockly-sample, בהתאם למאגר שבו רוצים לעבוד.
- סנכרון המזלג. אפשר גם להיעזר ב-GitHub כדי לסנכרן את המזלג.
- בודקים את הסניף הראשי. הוא חלק מהסניף של
develop. בבלוקים לדוגמה, זוהי ההסתעפותmaster. - התקנה של תלויות ובניית כלים על ידי הרצת
npm installבספריית הבסיס. - יצירת סניף חדש על ידי הפעלת
git checkout -b myBranchNameבטרמינל. השם אמור לעזור לך לזכור על מה אתה עובד. - עורכים את השינויים הרצויים.
- מאמתים את השינויים לפי המדריך לדוגמאות או דוגמאות.
- שמירת השינויים באמצעות
git commit -am "fix: My commit message". מידע נוסף על התחייבות להודעות. - דחיפות את השינויים שלך ל-GitHub עם
git push origin myBranchName. - כשהקוד מוכן, פותחים בקשת משיכה. אחד מחברי הצוות של Blockly יבדוק את השינויים וימזג אותם ל-Blockly אם הם יאושרו. מידע נוסף זמין במאמר תהליך הבדיקה של יחסי הציבור.