การเปลี่ยน

แสดงการเปลี่ยนการกำหนดค่าข้ามทรัพยากร Dependency ตัวอย่างเช่น ถ้า //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 ต้องระบุ
ฟังก์ชันที่ใช้การเปลี่ยนนี้ ฟังก์ชันจะมีพารามิเตอร์ 2 รายการเสมอ คือ settings และ attr พารามิเตอร์ settings คือพจนานุกรมที่มีชุดคีย์ที่กำหนดโดยพารามิเตอร์อินพุต ดังนั้น สำหรับการตั้งค่าบิลด์แต่ละรายการ --//foo=bar หาก inputs มี //foo คำว่า settings จะมีรายการ settings['//foo']='bar'

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

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

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