การช่วยโปรเจ็กต์และระบบนิเวศของ Bazel นั้นทำได้หลายวิธี
แสดงความคิดเห็น
เมื่อใช้ Bazel คุณอาจเห็นสิ่งที่ปรับปรุงได้ คุณช่วยได้โดยการรายงานปัญหาในกรณีต่อไปนี้
- Bazel ขัดข้องหรือคุณพบข้อบกพร่องที่แก้ไขได้โดยใช้
bazel clean
เท่านั้น - เอกสารไม่สมบูรณ์หรือไม่ชัดเจน นอกจากนี้ คุณยังรายงานปัญหาจากหน้าเว็บที่กำลังดูอยู่ได้โดยใช้ลิงก์ "สร้างปัญหา" ที่มุมบนขวาของหน้า
- ปรับปรุงข้อความแสดงข้อผิดพลาดได้
เข้าร่วมในชุมชน
คุณสามารถมีส่วนร่วมกับชุมชน Bazel ได้โดยวิธีต่อไปนี้
- ตอบคำถามใน Stack Overflow
- ช่วยเหลือผู้ใช้รายอื่นบน Slack
- การปรับปรุงเอกสารประกอบหรือตัวอย่างการมีส่วนร่วม
- การแชร์ประสบการณ์หรือเคล็ดลับ เช่น ในบล็อกหรือโซเชียลมีเดีย
รหัสการมีส่วนร่วม
Bazel เป็นโครงการขนาดใหญ่และการเปลี่ยนแปลงซอร์สโค้ดของ Bazel อาจเป็นเรื่องยาก
คุณมีส่วนร่วมในระบบนิเวศ Bazel ได้โดย
- ช่วยผู้ดูแลกฎด้วยการมีส่วนร่วมคำขอพุล
- การสร้างกฎใหม่และการทำให้กฎเหล่านั้นเป็นแบบโอเพนซอร์ส
- มีส่วนร่วมในเครื่องมือที่เกี่ยวข้องกับ Bazel เช่น เครื่องมือย้ายข้อมูล
- ปรับปรุงการผสานรวม Bazel กับ IDE และเครื่องมืออื่นๆ
ก่อนทำการเปลี่ยนแปลง ให้สร้าง ปัญหาใน GitHub หรือส่งอีเมลไปที่ bazel-discuss@
ข้อมูลที่เป็นประโยชน์มากที่สุดจะแก้ไขข้อบกพร่องหรือเพิ่มฟีเจอร์ (ซึ่งต่างจากการเปลี่ยนแปลงด้านสไตล์ การเปลี่ยนโครงสร้างภายในโค้ด หรือ "การทำความสะอาด") การเปลี่ยนแปลงของคุณควรรวมถึงการทดสอบและเอกสารต่างๆ โดยคำนึงถึงความเข้ากันได้แบบย้อนหลัง ความสามารถในการถ่ายโอน รวมถึงผลกระทบต่อการใช้งานหน่วยความจำและประสิทธิภาพ
ดูวิธีส่งการเปลี่ยนแปลงได้ที่กระบวนการยอมรับแพตช์
คำอธิบายโค้ดของ 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 Code Search คุณไปยังส่วนต่างๆ ของที่เก็บ สาขา และไฟล์ของ Bazel ได้ คุณยังดูประวัติ ความแตกต่าง และข้อมูลโทษได้ด้วย ดูข้อมูลเพิ่มเติมได้ในคู่มือผู้ใช้การค้นหาโค้ด Bazel