การช่วยโปรเจ็กต์และระบบนิเวศของ 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