Đóng góp cho Bazel

Có nhiều cách để hỗ trợ dự án và hệ sinh thái của Bazel.

Gửi ý kiến phản hồi

Khi dùng Bazel, bạn có thể thấy những điểm có thể cải thiện. Bạn có thể trợ giúp bằng cách báo cáo vấn đề khi:

  • Bazel gặp sự cố hoặc bạn gặp phải một lỗi chỉ có thể giải quyết bằng bazel clean.
  • Giấy tờ không đầy đủ hoặc không rõ ràng. Bạn cũng có thể báo cáo vấn đề trên trang mình đang xem bằng cách sử dụng đường liên kết "Tạo vấn đề" ở góc trên cùng bên phải của trang.
  • Có thể cải thiện thông báo lỗi.

Tham gia cộng đồng

Bạn có thể tương tác với cộng đồng Bazel bằng cách:

Mã đóng góp

Bazel là một dự án lớn và việc thay đổi mã nguồn Bazel có thể khó khăn.

Bạn có thể đóng góp cho hệ sinh thái Bazel bằng cách:

  • Hỗ trợ các nhà duy trì quy tắc bằng cách đóng góp cho các yêu cầu lấy dữ liệu.
  • Tạo quy tắc mới và tìm nguồn mở cho các quy tắc đó.
  • Đóng góp cho các công cụ liên quan đến Bazel, ví dụ: công cụ di chuyển.
  • Cải thiện khả năng tích hợp Bazel với các IDE và công cụ khác.

Trước khi thực hiện thay đổi, hãy tạo một vấn đề trên GitHub hoặc gửi email đến bazel-dev@.

Những nội dung đóng góp hữu ích nhất sẽ sửa lỗi hoặc bổ sung tính năng (thay vì thay đổi về kiểu cách, tái cấu trúc hoặc "dọn dẹp"). Thay đổi của bạn nên bao gồm các hoạt động kiểm thử và tài liệu, có lưu ý đến khả năng tương thích ngược, khả năng di động và tác động đến hiệu suất và mức sử dụng bộ nhớ.

Để tìm hiểu cách gửi thay đổi, hãy xem quy trình chấp nhận bản vá.

Phần mô tả mã của Bazel

Bazel có một cơ sở mã lớn với mã ở nhiều vị trí. Hãy xem hướng dẫn về cơ sở mã để biết thêm thông tin chi tiết.

Bazel được sắp xếp như sau:

  • Mã ứng dụng nằm trong src/main/cpp và cung cấp giao diện dòng lệnh.
  • Vùng đệm giao thức nằm trong src/main/protobuf.
  • Mã máy chủ nằm trong src/main/java và src/test/java.
    • Mã lõi chủ yếu bao gồm SkyFrame và một số tiện ích.
    • Các quy tắc tích hợp nằm trong com.google.devtools.build.lib.rules và trong com.google.devtools.build.lib.bazel.rules. Trước tiên, bạn nên đọc về Những thách thức khi viết quy tắc.
  • Giao diện gốc Java có trong src/main/native.
  • Danh sách các công cụ hỗ trợ ngôn ngữ được mô tả trong danh sách ở phần biên dịch Bazel.

Tìm kiếm mã nguồn của Bazel

Để tìm kiếm nhanh qua mã nguồn của Bazel, hãy sử dụng Tìm kiếm mã Bazel. Bạn có thể chuyển đến các kho lưu trữ, nhánh và tệp của Bazel. Bạn cũng có thể xem lịch sử, điểm khác biệt và thông tin đổ lỗi. Để tìm hiểu thêm, vui lòng xem Hướng dẫn sử dụng tính năng Tìm kiếm mã Bazel.