יש הרבה דרכים לעזור לפרויקט ב-Bazel ולסביבה העסקית.
שליחת משוב
במהלך השימוש ב-Bazel אתה עשוי לגלות דברים שניתן לשפר. כדי לעזור לכם, אפשר לדווח על בעיות בדיווח במקרים הבאים:
- Bazel קורסת או שנתקלת בבאג שאפשר לפתור רק באמצעות
bazel clean. - המסמכים חלקיים או לא ברורים. ניתן גם לדווח על בעיות מהדף שמוצג באמצעות הקישור "יצירת בעיה" בפינה השמאלית העליונה של הדף.
- ייתכן שניתן לשפר הודעת שגיאה.
השתתפות בקהילה
ניתן לקיים מעורבות עם קהילת Bazel על ידי:
- מענה על שאלות ב-Stack Overflow.
- עזרה למשתמשים אחרים ב-Slack.
- שיפור המסמכים או תרומת דוגמאות.
- שיתוף החוויה שלך או טיפים, למשל בבלוג או במדיה חברתית.
הוספת קוד
Bazel הוא פרויקט גדול וקשה לבצע שינוי בקוד המקור של Bazel.
ניתן לתרום לסביבה העסקית של Bazel באמצעות:
- עוזרים לרשויות התחזוקה על ידי תרומת בקשות משיכה.
- יצירת כללים חדשים ומיקור חוץ.
- למשל, הוספה של כלים שקשורים ל-Bazel.
- שיפור השילוב של Bazel עם מפתחים וכלים משולבים אחרים.
לפני שתבצעו שינוי, צרו בעיה ב-GitHub או שלחו אימייל לכתובת bazel-dev@.
התכנים המועילים ביותר מתקנים באגים או מוסיפים תכונות (בניגוד לפרמטרים סגנוניים, שקלול מחדש או "ניקוי וציטוט; שינויים). השינוי צריך לכלול בדיקות ותיעוד ולזכור תאימות תאימות, ניידות וההשפעה של השימוש והביצועים על הזיכרון.
בתהליך האישור של התיקון מוסבר איך לשלוח שינוי.
תיאור הקוד של Bazel'
ל-Bazel יש בסיס קוד גדול עם קוד במיקומים רבים. לפרטים נוספים, ניתן לעיין במדריך בנושא קוד בסיס.
Bazel מאורגנת באופן הבא:
- קוד הלקוח הוא ב
src/main/cppומספק את ממשק שורת הפקודה. - המאגרים של הפרוטוקולים נמצאים ב-
src/main/protobuf. - קוד השרת נמצא ב
src/main/javaובsrc/test/java.- קוד ליבה שמורכב בעיקר מ-SkyFrame ומכמה שירותים אחרים.
- הכללים המובנים נמצאים ב
com.google.devtools.build.lib.rulesובcom.google.devtools.build.lib.bazel.rules. כדאי לקרוא קודם את המאמר אתגרי כתב הכתיבה.
- הממשקים המקומיים של Java נמצאים ב
src/main/native. - כלים שונים לתמיכה בשפה מתוארים ברשימה בקטע הידור.
חיפוש קוד המקור של Bazel
כדי לחפש במהירות בקוד המקור של Bazel', השתמשו בחיפוש קוד של Bazel. תוכלו לנווט במאגרים של Bazel's, סניפים וקבצים. אפשר גם לראות היסטוריה, הבדלים ונתוני האשמה. למידע נוסף, עיינו במדריך למשתמש של קוד החיפוש ב-Bazel.