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