หน้านี้อธิบายวิธีผสานรวมกับกฎ C++ ในระดับต่างๆ
การเข้าถึงชุดเครื่องมือ C++
คุณควรใช้ฟังก์ชันตัวช่วยที่มีอยู่ใน @rules_cc//cc:find_cc_toolchain.bzl
เพื่อใช้เครื่องมือทางภาษา CC จากกฎ Starlark
หากต้องการใช้เครื่องมือ C++ ในกฎ ให้ตั้งค่าพารามิเตอร์ toolchains
เป็น use_cc_toolchain()
จากนั้นในการใช้งานกฎ ให้ใช้ find_cpp_toolchain(ctx)
เพื่อรับ CcToolchainInfo
ดูตัวอย่างที่ใช้งานได้อย่างสมบูรณ์ได้ใน rules_cc
examples
การสร้างบรรทัดคำสั่งและตัวแปรสภาพแวดล้อมโดยใช้ Toolchain ของ C++
โดยทั่วไปแล้ว คุณจะต้องผสานรวมกับเครื่องมือ C++ เพื่อให้มีแฟล็กบรรทัดคำสั่งเหมือนกับกฎ C++ แต่ไม่ได้ใช้การดำเนินการ C++ โดยตรง เนื่องจากเมื่อเขียนการดำเนินการของเราเอง การดำเนินการต้องทำงานอย่างสอดคล้องกันกับชุดเครื่องมือ C++ เช่น การส่ง Flag บรรทัดคำสั่ง C++ ไปยังเครื่องมือที่เรียกใช้คอมไพเลอร์ C++ เบื้องหลัง
กฎ C++ ใช้วิธีพิเศษในการสร้างบรรทัดคำสั่งตามการกำหนดค่าฟีเจอร์ หากต้องการสร้างบรรทัดคำสั่ง คุณต้องมีสิ่งต่อไปนี้
features
และaction_configs
- มาจากCcToolchainConfigInfo
และรวมอยู่ในCcToolchainInfo
FeatureConfiguration
- แสดงผลโดย cc_common.configure_features- cc ตัวแปรการกำหนดค่า Toolchain - แสดงผลโดย cc_common.create_compile_variables หรือ cc_common.create_link_variables
ยังมี Getter เฉพาะเครื่องมือ เช่น compiler_executable
โปรดใช้ get_tool_for_action
แทน เนื่องจากเราจะนําตัวรับเฉพาะเครื่องมือออกในที่สุด
ดูตัวอย่างการทำงานที่สมบูรณ์ได้ในตัวอย่าง rules_cc
การใช้กฎ Starlark ที่ขึ้นอยู่กับกฎ C++ และ/หรือกฎ C++ ที่สามารถใช้
กฎ C++ ส่วนใหญ่จะมี CcInfo
, ผู้ให้บริการที่มี CompilationContext
และ LinkingContext
ซึ่งจะช่วยให้เข้าถึงข้อมูลต่างๆ ได้ เช่น ส่วนหัวแบบทรานซิทีฟทั้งหมดหรือไลบรารีที่จะลิงก์ กฎ Starlark ที่กําหนดเองจาก CcInfo
และ CcToolchainInfo
ควรได้รับข้อมูลทั้งหมดที่ต้องการ
หากกฎ Starlark ที่กำหนดเองระบุ CcInfo
จะเป็นการส่งสัญญาณไปยังกฎ C++ ว่ากฎดังกล่าวอ้างอิงกฎนี้ได้ด้วยเช่นกัน อย่างไรก็ตาม โปรดระมัดระวัง หากต้องการเผยแพร่
CcInfo
ผ่านกราฟไปยังกฎไบนารีที่จะใช้ โปรดรวม
CcInfo
ในผู้ให้บริการรายอื่น ตัวอย่างเช่น หากกฎ java_library
ต้องการเผยแพร่การพึ่งพาแบบเนทีฟไปยัง java_binary
ก็ไม่ควรระบุ CcInfo
โดยตรง (cc_binary
ขึ้นอยู่กับ java_library
นั้นไม่สมเหตุสมผล) แต่ควรรวมไว้ใน JavaCcInfo
เป็นต้น
ดูตัวอย่างการทำงานที่สมบูรณ์ได้ใน rules_cc examples
การใช้ตรรกะและการดําเนินการของกฎ C++ ซ้ำ
ยังไม่เสถียร ส่วนนี้จะอัปเดตเมื่อ API เสถียรแล้ว ติดตาม #4570 เพื่อดูข้อมูลอัปเดต