C++ và Bazel

Báo cáo vấn đề Xem nguồn Ban đêm · 8.0 · 7.4 · 7.3 · 7.2 · 7.1 · 7.0 · 6.5

Trang này chứa các tài nguyên giúp bạn sử dụng Bazel với các dự án C++. Trang này liên kết đến một hướng dẫn, các quy tắc xây dựng và thông tin khác dành riêng cho việc xây dựng dự án C++ bằng Bazel.

Làm việc với Bazel

Các tài nguyên sau đây sẽ giúp bạn làm việc với Bazel trên các dự án C++:

• Hướng dẫn: Tạo dự án C++
• Các trường hợp sử dụng phổ biến của C++
• Quy tắc C/C++
• Thư viện thiết yếu
  • Abseil
  • Boost
  • Yêu cầu HTTPS: CPR và libcurl
• Cấu hình chuỗi công cụ C++
• Hướng dẫn: Định cấu hình chuỗi công cụ C++
• Tích hợp với quy tắc C++

Các phương pháp hay nhất

Ngoài các phương pháp hay nhất chung về Bazel, dưới đây là các phương pháp hay nhất dành riêng cho dự án C++.

Tệp BUILD

Hãy làm theo các nguyên tắc dưới đây khi tạo tệp BUILD:

• Mỗi tệp BUILD phải chứa một mục tiêu quy tắc cc_library cho mỗi đơn vị biên dịch trong thư mục.

• Bạn nên phân tích chi tiết các thư viện C++ của mình nhiều nhất có thể để tối đa hoá tính tăng dần và chạy song song bản dựng.

• Nếu có một tệp nguồn duy nhất trong srcs, hãy đặt tên cho thư viện giống với tên của tệp C++ đó. Thư viện này phải chứa(các) tệp C++, (các) tệp tiêu đề trùng khớp và các phần phụ thuộc trực tiếp của thư viện. Ví dụ:

  cc_library(
      name = "mylib",
      srcs = ["mylib.cc"],
      hdrs = ["mylib.h"],
      deps = [":lower-level-lib"]
  )
  

• Sử dụng một mục tiêu quy tắc cc_test cho mỗi mục tiêu cc_library trong tệp. Đặt tên cho mục tiêu [library-name]_test và tệp nguồn [library-name]_test.cc. Ví dụ: mục tiêu kiểm thử cho mục tiêu thư viện mylib hiển thị ở trên sẽ có dạng như sau:

  cc_test(
      name = "mylib_test",
      srcs = ["mylib_test.cc"],
      deps = [":mylib"]
  )
  

Bao gồm đường dẫn

Hãy làm theo các nguyên tắc sau để thêm đường dẫn:

• Đặt tất cả đường dẫn bao gồm tương ứng với thư mục không gian làm việc.

• Sử dụng các tiêu đề bao gồm được trích dẫn (#include "foo/bar/baz.h") cho các tiêu đề không phải của hệ thống, chứ không phải dấu ngoặc nhọn (#include <foo/bar/baz.h>).

• Tránh sử dụng lối tắt thư mục UNIX, chẳng hạn như . (thư mục hiện tại) hoặc .. (thư mục mẹ).

• Đối với mã cũ hoặc third_party yêu cầu bao gồm việc trỏ ra bên ngoài kho lưu trữ dự án, chẳng hạn như kho lưu trữ bên ngoài bao gồm việc yêu cầu tiền tố, hãy sử dụng đối số include_prefix và strip_include_prefix trên mục tiêu quy tắc cc_library.