ร่วมสนับสนุน Bazel

คุณช่วยสนับสนุนโปรเจ็กต์และระบบนิเวศของ Bazel ได้หลายวิธี

แสดงความคิดเห็น

ขณะที่ใช้ Bazel คุณอาจพบสิ่งต่างๆ ที่ปรับปรุงได้ คุณสามารถช่วยเราได้โดยการรายงานปัญหา ในกรณีต่อไปนี้

  • Bazel ขัดข้องหรือคุณพบข้อบกพร่องที่แก้ไขได้โดยใช้ เท่านั้น bazel clean
  • เอกสารไม่สมบูรณ์หรือเข้าใจยาก นอกจากนี้ คุณยังรายงานปัญหา จากหน้าที่กำลังดูอยู่ได้โดยใช้ลิงก์ "สร้างปัญหา" ที่มุมขวาบนของหน้า
  • ข้อความแสดงข้อผิดพลาดสามารถปรับปรุงได้

เข้าร่วมในชุมชน

คุณสามารถมีส่วนร่วมกับชุมชน Bazel ได้โดยทำดังนี้

ร่วมให้ข้อมูลโค้ด

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