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