Đóng góp cho Bazel

Báo cáo vấn đề Xem nguồn Hằng đêm · 7,3 · 7.2 · 7.1 · 7 · 6,5

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

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

Khi sử dụng Bazel, bạn có thể thấy những thứ có thể cải thiện. 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ể 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 đề từ trang bạn đang xem bằng cách sử dụng nút "Tạo vấn đề" ở góc trên cùng bên phải 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à đang thay đổi mã nguồn Bazel không hề dễ dàng.

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 các yêu cầu lấy dữ liệu (pull request).
  • Tạo quy tắc mới và cấp phép 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 thay đổi, hãy tạo GitHub vấn đề hoặc gửi email đến địa chỉ bazel-dev@.

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

Để 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ó 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ã cốt 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 có trong com.google.devtools.build.lib.rules và có trong com.google.devtools.build.lib.bazel.rules. Bạn có thể muốn đọc về Thách thức khi viết quy tắc.
  • Giao diện gốc 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 biên dịch Bazel.

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

Để tìm kiếm nhanh trong mã nguồn của Bazel, hãy sử dụng Tìm kiếm mã Bazel. Bạn có thể khám phá Bazel kho lưu trữ, nhánh và tệp. Bạn cũng có thể xem nhật ký, điểm khác biệt và nội dung đổ lỗi của bạn. Để tìm hiểu thêm, hãy xem Hướng dẫn sử dụng tính năng Tìm kiếm mã Bazel.