Trang này mô tả cách tích hợp với các quy tắc C++ ở nhiều cấp.
Truy cập vào chuỗi công cụ C++
Do việc di chuyển liên tục các quy tắc C++ sang nền tảng và chuỗi công cụ, bạn nên sử dụng hàm trợ giúp có tại @bazel_tools//tools/cpp:toolchain_utils.bzl. Hàm này hoạt động cả khi chuỗi công cụ bị tắt và bật. Để phụ thuộc vào một chuỗi công cụ C++ trong quy tắc, hãy thêm thuộc tính Label có tên là _cc_toolchain và trỏ thuộc tính đó đến @bazel_tools//tools/cpp:current_cc_toolchain (một thực thể của quy tắc cc_toolchain_alias, trỏ đến chuỗi công cụ C++ hiện được chọn).
Sau đó, trong quá trình triển khai quy tắc, hãy sử dụng find_cpp_toolchain(ctx) để lấy CcToolchainInfo.
Bạn có thể xem ví dụ đầy đủ về cách hoạt động trong các ví dụ về rules_cc.
Tạo dòng lệnh và biến môi trường bằng chuỗi công cụ C++
Thông thường, bạn sẽ tích hợp với chuỗi công cụ C++ để có các cờ dòng lệnh giống như quy tắc C++, nhưng không trực tiếp sử dụng các hành động C++. Điều này là do khi viết các hành động của riêng mình, chúng phải hoạt động nhất quán với chuỗi công cụ C++ – ví dụ: truyền cờ dòng lệnh C++ đến một công cụ gọi trình biên dịch C++ ở chế độ nền.
Các quy tắc C++ sử dụng một cách đặc biệt để tạo dòng lệnh dựa trên cấu hình tính năng. Để tạo một dòng lệnh, bạn cần có:
featuresvàaction_configs– các giá trị này đến từCcToolchainConfigInfovà được đóng gói trongCcToolchainInfoFeatureConfiguration– do cc_common.configure_features trả về- Các biến cấu hình chuỗi công cụ cc – do cc_common.create_compile_variables hoặc cc_common.create_link_variables trả về.
Vẫn có các phương thức getter dành riêng cho công cụ, chẳng hạn như compiler_executable.
Hãy ưu tiên get_tool_for_action hơn các phương thức này, vì các phương thức getter dành riêng cho công cụ cuối cùng sẽ bị xoá.
Bạn có thể xem ví dụ đầy đủ về cách hoạt động trong các ví dụ về rules_cc.
Triển khai các quy tắc Starlark phụ thuộc vào quy tắc C++ và/hoặc quy tắc C++ có thể phụ thuộc vào
Hầu hết các quy tắc C++ đều cung cấp CcInfo, một trình cung cấp chứa CompilationContext và LinkingContext.
Thông qua các tệp này, bạn có thể truy cập vào thông tin như tất cả tiêu đề bắc cầu hoặc thư viện để liên kết. Từ CcInfo và từ quy tắc Starlark tuỳ chỉnh CcToolchainInfo, bạn có thể lấy được tất cả thông tin cần thiết.
Nếu một quy tắc Starlark tuỳ chỉnh cung cấp CcInfo, thì đó là tín hiệu cho các quy tắc C++ rằng
các quy tắc đó cũng có thể phụ thuộc vào quy tắc đó. Tuy nhiên, hãy cẩn thận – nếu bạn chỉ cần truyền CcInfo thông qua biểu đồ tới quy tắc nhị phân để sau đó sử dụng, hãy gói CcInfo trong một trình cung cấp khác. Ví dụ: nếu quy tắc java_library muốn truyền các phần phụ thuộc gốc đến java_binary, thì quy tắc này không được cung cấp trực tiếp CcInfo (cc_binary phụ thuộc vào java_library là không hợp lý), mà phải gói quy tắc này trong một quy tắc khác, chẳng hạn như JavaCcInfo.
Bạn có thể xem ví dụ đầy đủ về cách hoạt động trong các ví dụ về rules_cc.
Sử dụng lại logic và hành động của quy tắc C++
Chưa ổn định; Phần này sẽ được cập nhật sau khi API ổn định. Hãy theo dõi #4570 để biết thông tin mới nhất.