การกำหนดค่า

รายงานปัญหา ดูแหล่งที่มา ตอนกลางคืน · 7.3 · 7.2 · 7.1 · 7.0 · 6.5

นี่คือโมดูลระดับบนสุดสำหรับสร้างการเปลี่ยนการกำหนดค่าและข้อบ่งชี้การตั้งค่าบิลด์ ซึ่งจะอธิบายว่ากฎเป็นการตั้งค่าบิลด์ประเภทใด (หากมี)

เช่น กฎต่อไปนี้ทำเครื่องหมายเป็นการตั้งค่าบิลด์โดยการตั้งค่าพารามิเตอร์ build_setting ของฟังก์ชัน rule() โดยเฉพาะอย่างยิ่งเป็นการตั้งค่าบิลด์ของประเภท int และเป็น flag ซึ่งหมายความว่าการตั้งค่าของบิลด์นี้เรียกใช้ได้ในบรรทัดคำสั่ง

  my_rule = rule(
    implementation = _impl,
    build_setting = config.int(flag = True),
    ...
  )

สมาชิก

บูลีน

BuildSetting config.bool(flag=False)

การตั้งค่าบิลด์ที่เป็นประเภทบูลีน

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
flag bool; ค่าเริ่มต้นคือ False
การตั้งค่าของบิลด์นี้เรียกใช้ได้ในบรรทัดคำสั่งหรือไม่

ผู้บริหาร

ExecTransitionFactory config.exec(exec_group=None)

สร้างการเปลี่ยนการดำเนินการ

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
exec_group string; หรือ None; ค่าเริ่มต้นคือ None
ชื่อของกลุ่มผู้บริหารที่ใช้แพลตฟอร์มการดำเนินการสำหรับการเปลี่ยนนี้ หากไม่ระบุ การเปลี่ยนของผู้บริหารนี้จะใช้แพลตฟอร์มการดำเนินการเริ่มต้นของเป้าหมาย

int

BuildSetting config.int(flag=False)

การตั้งค่าบิลด์ที่พิมพ์จำนวนเต็ม

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
flag bool; ค่าเริ่มต้นคือ False
การตั้งค่าของบิลด์นี้เรียกใช้ได้ในบรรทัดคำสั่งหรือไม่

สตริง

BuildSetting config.string(flag=False, allow_multiple=False)

การตั้งค่าบิลด์ที่เป็นประเภทสตริง

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
flag bool; ค่าเริ่มต้นคือ False
การตั้งค่าของบิลด์นี้เรียกใช้ได้ในบรรทัดคำสั่งหรือไม่
allow_multiple bool; ค่าเริ่มต้นคือ False
เลิกใช้งานแล้ว ให้ใช้การตั้งค่า string_list กับ repeatable = True แทน หากมีการตั้งค่าไว้ จะตั้งค่าแฟล็กนี้หลายครั้งในบรรทัดคำสั่ง ค่าของแฟล็กเมื่อเข้าถึงในฟังก์ชันการเปลี่ยนและการตั้งค่าบิลด์จะเป็นรายการสตริง ใบสั่งซื้อการใส่โฆษณาและค่าซ้ำจะยังคงอยู่ รายการนี้ประมวลผลหลังการประมวลผลได้ในฟังก์ชันการใช้งานการตั้งค่าบิลด์หากต้องการลักษณะการทำงานแบบอื่น

string_list

BuildSetting config.string_list(flag=False, repeatable=False)

การตั้งค่าบิลด์ที่พิมพ์ด้วยรายการสตริง ในบรรทัดคำสั่ง ให้ส่งรายการโดยใช้ค่าที่คั่นด้วยคอมมา เช่น --//my/setting=foo,bar

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
flag bool; ค่าเริ่มต้นคือ False
การตั้งค่าของบิลด์นี้เรียกใช้ได้ในบรรทัดคำสั่งหรือไม่
repeatable bool; ค่าเริ่มต้นคือ False
หากตั้งค่าไว้ แทนที่จะต้องคาดหวังค่าที่คั่นด้วยคอมมา ระบบจะอนุญาตให้ตั้งค่าแฟล็กนี้ได้หลายครั้งในบรรทัดคำสั่งโดยให้แต่ละค่าถือเป็นสตริงเดียวเพื่อเพิ่มลงในค่าในรายการ ใบสั่งซื้อการใส่โฆษณาและค่าซ้ำจะยังคงอยู่ รายการนี้ประมวลผลหลังการประมวลผลได้ในฟังก์ชันการใช้งานการตั้งค่าบิลด์หากต้องการลักษณะการทำงานแบบอื่น

เป้าหมาย

transition config.target()

สร้างการเปลี่ยนเป้าหมาย การทำเช่นนี้เป็นการเปลี่ยนแบบไม่ต้องดำเนินการสำหรับกรณีที่ต้องใช้อ็อบเจกต์การเปลี่ยน แต่จริงๆ แล้วไม่ต้องการเปลี่ยนแปลงอะไรเลย เทียบเท่ากับ cfg = "target" ใน attr.label()