התרומה ל-Bazel

יש הרבה דרכים לעזור לפרויקט ב-Bazel ולסביבה העסקית.

שליחת משוב

במהלך השימוש ב-Bazel אתה עשוי לגלות דברים שניתן לשפר. כדי לעזור לכם, אפשר לדווח על בעיות בדיווח במקרים הבאים:

  • Bazel קורסת או שנתקלת בבאג שאפשר לפתור רק באמצעות bazel clean.
  • המסמכים חלקיים או לא ברורים. ניתן גם לדווח על בעיות מהדף שמוצג באמצעות הקישור "יצירת בעיה" בפינה השמאלית העליונה של הדף.
  • ייתכן שניתן לשפר הודעת שגיאה.

השתתפות בקהילה

ניתן לקיים מעורבות עם קהילת Bazel על ידי:

הוספת קוד

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&#39, השתמשו בחיפוש קוד של Bazel. תוכלו לנווט במאגרים של Bazel's, סניפים וקבצים. אפשר גם לראות היסטוריה, הבדלים ונתוני האשמה. למידע נוסף, עיינו במדריך למשתמש של קוד החיפוש ב-Bazel.