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