คุณช่วยโปรเจ็กต์และระบบนิเวศของ 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 คุณสามารถไปยังที่ต่างๆ ในที่เก็บ เวอร์ชันย่อย และไฟล์ของ Bazel ได้ นอกจากนี้ คุณยังดูประวัติ การเปรียบเทียบ และข้อมูลการระบุแหล่งที่มาได้ด้วย ดูข้อมูลเพิ่มเติมได้ที่คู่มือผู้ใช้การค้นหาโค้ด Bazel