กฎ
action_listener
ดูแหล่งที่มาของกฎaction_listener(name, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, extra_actions, features, licenses, mnemonics, restricted_to, tags, target_compatible_with, testonly, visibility)
คำเตือน: ระบบเลิกใช้งานการดำเนินการเพิ่มเติมแล้ว ให้ใช้ aspects แทน
กฎ action_listener จะไม่สร้างเอาต์พุตใดๆ เอง
แต่ช่วยให้นักพัฒนาเครื่องมือแทรก extra_action ลงในระบบบิลด์ได้ โดยระบุการแมปจากการดำเนินการไปยัง extra_action
อาร์กิวเมนต์ของกฎนี้จะแมปคําช่วยจําการดําเนินการกับกฎ extra_action
เมื่อระบุตัวเลือก
--experimental_action_listener=<label>
บิลด์จะใช้ action_listener ที่ระบุเพื่อแทรก extra_action ลงในกราฟบิลด์
ตัวอย่าง
action_listener(
name = "index_all_languages",
mnemonics = [
"Javac",
"CppCompile",
"Python",
],
extra_actions = [":indexer"],
)
action_listener(
name = "index_java",
mnemonics = ["Javac"],
extra_actions = [":indexer"],
)
extra_action(
name = "indexer",
tools = ["//my/tools:indexer"],
cmd = "$(location //my/tools:indexer)" +
"--extra_action_file=$(EXTRA_ACTION_FILE)",
)
อาร์กิวเมนต์
| Attributes | |
|---|---|
name |
ชื่อ ต้องระบุ ชื่อที่ไม่ซ้ำกันสำหรับเป้าหมายนี้ |
extra_actions
|
รายการป้ายกำกับ (ต้องระบุ) รายการextra_actionเป้าหมาย
action_listenerนี้ควรเพิ่มลงในกราฟการสร้าง
เช่น [ "//my/tools:analyzer" ]
|
mnemonics
|
รายการสตริง (ต้องระบุ) รายการคําช่วยจําสําหรับการดําเนินการที่action_listener ควรฟัง เช่น [ "Javac" ]
Mnemonics ไม่ใช่อินเทอร์เฟซสาธารณะ ไม่มีการรับประกันว่าคําช่วยจําและการดําเนินการของคําช่วยจําจะไม่เปลี่ยนแปลง |
extra_action
ดูแหล่งที่มาของกฎextra_action(name, data, cmd, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, licenses, out_templates, requires_action_output, restricted_to, tags, target_compatible_with, testonly, toolchains, tools, visibility)
คำเตือน: ระบบเลิกใช้งานการดำเนินการเพิ่มเติมแล้ว ให้ใช้ aspects แทน
กฎ extra_action จะไม่สร้างเอาต์พุตที่มีความหมายเมื่อระบุเป็นเป้าหมายการสร้างปกติ แต่จะช่วยให้นักพัฒนาเครื่องมือแทรกการดำเนินการเพิ่มเติมลงในกราฟการสร้างที่ซ้อนทับการดำเนินการที่มีอยู่ได้
ดูรายละเอียดเกี่ยวกับวิธีเปิดใช้ extra_action ได้ที่ action_listener
extra_action จะทำงานเป็นบรรทัดคำสั่ง เครื่องมือบรรทัดคำสั่งจะเข้าถึงไฟล์ที่มีบัฟเฟอร์โปรโตคอลเป็น $(EXTRA_ACTION_FILE) โดยมีรายละเอียดการดำเนินการเดิมที่ระบบกำลังเงาอยู่
รวมถึงมีสิทธิ์เข้าถึงไฟล์อินพุตทั้งหมดที่การดำเนินการเดิมมีสิทธิ์เข้าถึง
ดูรายละเอียดเกี่ยวกับข้อมูลที่จัดเก็บไว้ในบัฟเฟอร์โปรโตคอลได้ที่ extra_actions_base.proto
ไฟล์โปรโตแต่ละไฟล์จะมีข้อความ ExtraActionInfo
การดำเนินการเพิ่มเติมจะอยู่ในแซนด์บ็อกซ์เช่นเดียวกับการดำเนินการอื่นๆ ทั้งหมด และควรออกแบบมาให้จัดการการดำเนินการดังกล่าว
อาร์กิวเมนต์
| Attributes | |
|---|---|
name |
ชื่อ ต้องระบุ ชื่อที่ไม่ซ้ำกันสำหรับเป้าหมายนี้ คุณอ้างอิงกฎนี้ได้โดยใช้label ในอาร์กิวเมนต์ extra_actions ของกฎ action_listener
|
cmd
|
สตริง; ต้องระบุ คำสั่งที่จะเรียกใช้เช่น แอตทริบิวต์ cmd ของ genrule โดยมีความแตกต่างดังนี้
|
out_templates
|
รายการสตริง ค่าเริ่มต้นคือ extra_action
เทมเพลตสามารถใช้ตัวแปรต่อไปนี้
|
requires_action_output
|
บูลีน ค่าเริ่มต้นคือ extra_action นี้ต้องใช้เอาต์พุตของการดำเนินการเดิมเป็นอินพุตสำหรับ extra_action นี้
เมื่อเป็น "จริง" (ค่าเริ่มต้นคือ "เท็จ") extra_action จะถือว่าเอาต์พุตการดําเนินการเดิมมีให้เป็นส่วนหนึ่งของอินพุต |
tools
|
รายการป้ายกํากับ ค่าเริ่มต้นคือ tool ที่ต้องพึ่งพาสำหรับกฎนี้
ดูข้อมูลเพิ่มเติมได้ที่คำจำกัดความของทรัพยากร Dependencies
ระบบบิลด์จะสร้างข้อกําหนดเบื้องต้นเหล่านี้ก่อนเรียกใช้คําสั่ง เครื่องมือทั้งหมดและข้อมูลที่เกี่ยวข้องจะรวมกันเป็นต้นไม้เดียว ซึ่งคำสั่งจะใช้เส้นทางแบบสัมพัทธ์ได้ ไดเรกทอรีทํางานจะเป็นรูทของต้นไม้แบบรวมนั้น |