BazelCon 2022 sắp diễn ra từ ngày 16 đến 17 tháng 11 tại New York và trên mạng.
Đăng ký ngay hôm nay!

Đóng góp vào Bazel

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Có nhiều cách để giúp 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ều có thể cải thiện được. Bạn có thể trợ giúp bằng cách báo cáo sự cố khi:

  • Bazel gặp sự cố hoặc bạn gặp lỗi chỉ có thể được 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à bạn đang xem bằng cách dùng đường liên kết "Create issues" ở góc trên cùng bên phải của trang.
  • Bạn có thể cải thiện một 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ể gặp khó khăn.

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

  • Giúp những người duy trì quy tắc bằng cách đóng góp yêu cầu gộp.
  • Tạo quy tắc mới và tạo nguồn mở cho các quy tắc đó.
  • Ví dụ: đóng góp vào các công cụ liên quan đến Bazel, các 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 thay đổi, hãy tạo một vấn đề với GitHub hoặc gửi email đến bazel-dev@.

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

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

Mô tả mã của Bazel

Bazel có một cơ sở mã lớn có mã ở nhiều vị trí. Xem hướng dẫn về cơ sở mã để biết thêm 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/javasrc/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 sẵn nằm trong com.google.devtools.build.lib.rules và trong com.google.devtools.build.lib.bazel.rules. Bạn nên đọc về Các thách thức trong quy tắc viết trước tiên.
  • Giao diện gốc của Java nằm trong src/main/native.
  • Nhiều công cụ hỗ trợ ngôn ngữ được mô tả trong danh sách trong phần biên dịch Bazel.

Đang tìm kiếm mã nguồn của Bazel

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