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