การเปลี่ยน

รายงานปัญหา ดูแหล่งที่มา รุ่น Nightly · 7.4 7.3 · 7.2 · 7.1 · 7.0 · 6.5

แสดงการเปลี่ยนการกำหนดค่าในขอบความเกี่ยวข้อง ตัวอย่างเช่น หาก //package:foo ขึ้นอยู่กับ //package:bar ที่มีการเปลี่ยนการกำหนดค่า การกำหนดค่าของเป้าหมาย 2 รายการนี้จะแตกต่างกัน โดยการเปลี่ยนของ //package:bar จะกำหนดโดยการเปลี่ยนของ //package:foo ทั้งนี้ขึ้นอยู่กับฟังก์ชันที่ออบเจ็กต์การเปลี่ยนกำหนดไว้

สมาชิก

การเปลี่ยน

transition transition(implementation, inputs, outputs)

การเปลี่ยนรูปแบบที่อ่านชุดการตั้งค่าบิลด์อินพุตและเขียนชุดการตั้งค่าบิลด์เอาต์พุต

ตัวอย่าง

def _transition_impl(settings, attr):
    # This transition just reads the current CPU value as a demonstration.
    # A real transition could incorporate this into its followup logic.
    current_cpu = settings["//command_line_option:cpu"]
    return {"//command_line_option:compilation_mode": "dbg"}

build_in_debug_mode = transition(
    implementation = _transition_impl,
    inputs = ["//command_line_option:cpu"],
    outputs = ["//command_line_option:compilation_mode"],
)

ดูรายละเอียดเพิ่มเติมที่นี่

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
implementation callable; required
ฟังก์ชันที่ใช้การเปลี่ยนนี้ ฟังก์ชันจะมีพารามิเตอร์ 2 รายการเสมอ คือ settings และ attr settings param คือพจนานุกรมที่มีชุดคีย์ซึ่งกำหนดโดยพารามิเตอร์ inputs ดังนั้น สำหรับการตั้งค่าบิลด์แต่ละรายการ --//foo=bar หาก inputs มี //foo คำว่า settings จะมีรายการ settings['//foo']='bar'

พารามิเตอร์ attr เป็นการอ้างอิงถึง ctx.attr ซึ่งจะช่วยให้ฟังก์ชันการใช้งานเข้าถึงแอตทริบิวต์ของกฎได้เพื่อให้การเปลี่ยนแอตทริบิวต์ที่มีพารามิเตอร์เป็นไปได้

ฟังก์ชันนี้ต้องแสดงผล dict จากตัวระบุการตั้งค่าบิลด์เป็นค่าการตั้งค่าบิลด์ ซึ่งแสดงถึงการเปลี่ยนการกำหนดค่า โดยการเปลี่ยนจะอัปเดตการตั้งค่านั้นเป็นค่าใหม่สำหรับแต่ละรายการใน dict ที่แสดงผล การตั้งค่าอื่นๆ ทั้งหมดจะไม่เปลี่ยนแปลง ฟังก์ชันนี้ยังแสดงผล list ของ dict หรือ dict ของ dict ในกรณีที่มีการเปลี่ยนรูปแบบแบบแยก

inputs ลําดับสตริง ต้องระบุ
รายการตั้งค่าบิลด์ที่การเปลี่ยนนี้อ่านได้ ซึ่งจะกลายเป็นชุดคีย์ของพารามิเตอร์การตั้งค่าของพารามิเตอร์ฟังก์ชันการใช้งาน
outputs sequence ของ strings จำเป็น
รายการการตั้งค่าบิลด์ที่เขียนได้ด้วยการเปลี่ยนนี้ ซึ่งต้องเป็นชุดที่ใหญ่กว่าชุดคีย์ของพจนานุกรมที่การเปลี่ยนนี้แสดงผล