การเปลี่ยน

Nightly · 9.1 · 9.0 · 8.6 · 8.5 · 8.4 · 8.3 · 8.2 · 8.1

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

สมาชิก

transition

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

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

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

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