cquery เป็นตัวแปรของ query ที่จัดการselect() และผลของตัวเลือกการสร้างในกราฟการสร้างอย่างถูกต้อง
ซึ่งทำได้โดยการใช้ผลลัพธ์ของระยะการวิเคราะห์ของ Bazel ซึ่งผสานรวมผลกระทบเหล่านี้เข้าด้วยกัน ในทางตรงกันข้าม query จะทำงานเหนือผลลัพธ์ของระยะการโหลดของ Basl ก่อนที่จะมีการประเมินตัวเลือก
เช่น
$ cat > tree/BUILD <<EOF
sh_library(
name = "ash",
deps = select({
":excelsior": [":manna-ash"],
":americana": [":white-ash"],
"//conditions:default": [":common-ash"],
}),
)
sh_library(name = "manna-ash")
sh_library(name = "white-ash")
sh_library(name = "common-ash")
config_setting(
name = "excelsior",
values = {"define": "species=excelsior"},
)
config_setting(
name = "americana",
values = {"define": "species=americana"},
)
EOF
# Traditional query: query doesn't know which select() branch you will choose, # so it conservatively lists all of possible choices, including all used config_settings. $ bazel query "deps(//tree:ash)" --noimplicit_deps //tree:americana //tree:ash //tree:common-ash //tree:excelsior //tree:manna-ash //tree:white-ash # cquery: cquery lets you set build options at the command line and chooses # the exact dependencies that implies (and also the config_setting targets). $ bazel cquery "deps(//tree:ash)" --define species=excelsior --noimplicit_deps //tree:ash (9f87702) //tree:manna-ash (9f87702) //tree:americana (9f87702) //tree:excelsior (9f87702)
ผลลัพธ์แต่ละรายการจะมีตัวระบุที่ไม่ซ้ำกัน (9f87702) ของการกำหนดค่าที่ใช้สร้างเป้าหมาย
เนื่องจาก cquery ทำงานบนกราฟเป้าหมายที่กำหนดค่าไว้ จึงไม่มีข้อมูลเชิงลึกเกี่ยวกับอาร์ติแฟกต์ เช่น การดำเนินการสร้าง หรือการเข้าถึงกฎ test_suite เนื่องจากไม่ใช่เป้าหมายที่กำหนดค่าไว้ สำหรับกรณีแรก โปรดดูที่ aquery
ไวยากรณ์พื้นฐาน
การเรียกใช้ cquery แบบง่ายมีลักษณะดังนี้
bazel cquery "function(//target)"
นิพจน์การค้นหา "function(//target)" ประกอบด้วยข้อมูลต่อไปนี้
function(...)คือฟังก์ชันที่จะเรียกใช้บนเป้าหมายcqueryรองรับฟังก์ชันส่วนใหญ่ของqueryรวมถึงฟังก์ชันใหม่อีก 2-3 รายการ//targetคือนิพจน์ที่ส่งไปยังฟังก์ชัน ในตัวอย่างนี้ นิพจน์เป็นเป้าหมายง่ายๆ แต่ภาษาที่ใช้ในคำค้นหายังอนุญาตให้ฝังฟังก์ชันได้ด้วย โปรดดูคู่มือการค้นหาเพื่อดูตัวอย่าง
cquery กำหนดให้ต้องมีเป้าหมายเพื่อเรียกใช้ผ่านระยะการโหลดและการวิเคราะห์
cquery จะแยกวิเคราะห์เป้าหมายที่แสดงในนิพจน์การค้นหา เว้นแต่จะระบุไว้เป็นอย่างอื่น ดู --universe_scope สำหรับคำค้นหาทรัพยากร Dependency ของเป้าหมายบิลด์ระดับบนสุด
การกำหนดค่า
บรรทัด:
//tree:ash (9f87702)
หมายความว่า //tree:ash สร้างขึ้นในการกําหนดค่าที่มีรหัส 9f87702 สำหรับเป้าหมายส่วนใหญ่ นี่คือแฮชที่คลุมเครือของค่าตัวเลือกบิลด์ซึ่งเป็นตัวกำหนดการกำหนดค่า
หากต้องการดูเนื้อหาทั้งหมดของการกําหนดค่า ให้เรียกใช้
$ bazel config 9f87702
9f87702 คือคำนำหน้าของบัตรประจำตัวที่สมบูรณ์ เพราะรหัสที่สมบูรณ์คือแฮช SHA-256 ซึ่งยาวและติดตามได้ยาก cquery จะเข้าใจคำนำหน้าที่ถูกต้องของรหัสที่สมบูรณ์ ซึ่งคล้ายกับแฮชสั้นของ Git
หากต้องการดูรหัสที่สมบูรณ์ ให้เรียกใช้ $ bazel config
การประเมินรูปแบบเป้าหมาย
//foo มีความหมายต่างกันสำหรับ cquery กับ query นั่นเป็นเพราะ cquery ประเมินเป้าหมายที่กำหนดค่าแล้ว และกราฟบิลด์อาจมี //foo เวอร์ชันที่กำหนดค่าหลายเวอร์ชัน
สําหรับ cquery รูปแบบเป้าหมายในนิพจน์การค้นหาจะประเมินเป็นเป้าหมายที่กําหนดค่าไว้ทุกรายการที่มีป้ายกำกับซึ่งตรงกับรูปแบบนั้น เอาต์พุตเป็นสิ่งกำหนดได้ แต่ cquery ไม่ได้ให้การรับประกันการสั่งซื้อนอกเหนือจากสัญญาการสั่งซื้อการค้นหาหลัก
การดำเนินการนี้จะสร้างผลลัพธ์ที่ละเอียดกว่าสำหรับนิพจน์คำค้นหามากกว่า query
ตัวอย่างเช่น รายการต่อไปนี้อาจทำให้เกิดผลลัพธ์หลายรายการ
# Analyzes //foo in the target configuration, but also analyzes # //genrule_with_foo_as_tool which depends on an exec-configured # //foo. So there are two configured target instances of //foo in # the build graph. $ bazel cquery //foo --universe_scope=//foo,//genrule_with_foo_as_tool //foo (9f87702) //foo (exec)
หากต้องการประกาศอินสแตนซ์ที่จะค้นหาอย่างเจาะจง ให้ใช้ฟังก์ชัน config
ดูข้อมูลเพิ่มเติมเกี่ยวกับรูปแบบเป้าหมายได้ในเอกสารประกอบเกี่ยวกับรูปแบบเป้าหมายของ query
ฟังก์ชัน
จากชุดฟังก์ชันที่ query รองรับ มี cquery ที่รองรับทั้งหมดยกเว้น visible,
siblings, buildfiles และ tests
cquery ยังมีฟังก์ชันใหม่ดังต่อไปนี้
การกำหนดค่า
expr ::= config(expr, word)
โอเปอเรเตอร์ config จะพยายามค้นหาเป้าหมายที่กำหนดค่าไว้สำหรับป้ายกำกับที่แสดงโดยอาร์กิวเมนต์แรกและการกำหนดค่าที่ระบุโดยอาร์กิวเมนต์ที่ 2
ค่าที่ถูกต้องสำหรับอาร์กิวเมนต์ที่ 2 คือ null หรือแฮชการกำหนดค่าที่กำหนดเอง คุณเรียกข้อมูลแฮชได้จาก $
bazel config หรือเอาต์พุตของ cquery ก่อนหน้า
ตัวอย่าง
$ bazel cquery "config(//bar, 3732cc8)" --universe_scope=//foo
$ bazel cquery "deps(//foo)" //bar (exec) //baz (exec) $ bazel cquery "config(//baz, 3732cc8)"
หากไม่พบผลลัพธ์ทั้งหมดของอาร์กิวเมนต์แรกในการกําหนดค่าที่ระบุ ระบบจะแสดงเฉพาะผลลัพธ์ที่พบ หากไม่พบผลการค้นหาในการกําหนดค่าที่ระบุ การค้นหาจะดำเนินการไม่สำเร็จ
ตัวเลือก
ตัวเลือกบิลด์
cquery ทำงานเหนือบิลด์ Bazel ปกติ จึงรับชุดตัวเลือกที่ใช้ได้ระหว่างบิลด์
การใช้ตัวเลือกข้อความค้นหา
--universe_scope (รายการที่คั่นด้วยคอมมา)
บ่อยครั้งที่ทรัพยากร Dependencies ของเป้าหมายที่กําหนดค่าไว้จะผ่านการเปลี่ยนแปลง ซึ่งทําให้การกำหนดค่าของทรัพยากรเหล่านั้นแตกต่างจากทรัพยากร Dependencies แฟล็กนี้ช่วยให้คุณค้นหาเป้าหมายได้ราวกับว่าเป้าหมายนั้นสร้างขึ้นเป็นทรัพยากร Dependency หรือการขึ้นต่อกันแบบทรานซิทีฟของเป้าหมายอื่น เช่น
# x/BUILD
genrule(
name = "my_gen",
srcs = ["x.in"],
outs = ["x.cc"],
cmd = "$(locations :tool) $< >$@",
tools = [":tool"],
)
cc_binary(
name = "tool",
srcs = ["tool.cpp"],
)
Genrules จะกำหนดค่าเครื่องมือในการกำหนดค่าการดำเนินการ ดังนั้นการค้นหาต่อไปนี้จะสร้างเอาต์พุตต่อไปนี้
| การค้นหา | สร้างเป้าหมาย | เอาต์พุต |
|---|---|---|
| bazel cquery "//x:tool" | //x:tool | //x:tool(targetconfig) |
| bazel cquery "//x:tool" --universe_scope="//x:my_gen" | //x:my_gen | //x:tool(execconfig) |
หากตั้งค่า Flag นี้ ระบบจะสร้างเนื้อหา หากไม่ได้ตั้งค่าไว้ ระบบจะสร้างเป้าหมายทั้งหมดที่กล่าวถึงในนิพจน์การค้นหาแทน ระบบจะใช้การปิดเชิงการเปลี่ยนรูปแบบของเป้าหมายที่สร้างขึ้นเป็นขอบเขตของการค้นหา ไม่ว่าจะเลือกวิธีใด เป้าหมายที่จะสร้างต้องสามารถสร้างได้ที่ระดับบนสุด (กล่าวคือ เข้ากันได้กับตัวเลือกระดับบนสุด) cquery แสดงผลลัพธ์การปิดทางอ้อมของเป้าหมายระดับบนสุดเหล่านี้
แม้ว่าการสร้างเป้าหมายทั้งหมดในนิพจน์การค้นหาที่ระดับบนสุดจะเป็นไปได้ แต่คุณอาจไม่ต้องการทําเช่นนั้น เช่น การตั้งค่า --universe_scope อย่างชัดแจ้งอาจป้องกันการสร้างเป้าหมายหลายครั้งในการกําหนดค่าที่คุณไม่สนใจ นอกจากนี้ยังช่วยระบุเวอร์ชันการกำหนดค่าของเป้าหมายที่คุณต้องการได้ด้วย (เนื่องจากปัจจุบันยังไม่มีวิธีอื่นที่ระบุข้อมูลนี้ได้อย่างสมบูรณ์) คุณควรตั้งค่าสถานะนี้หากนิพจน์คำค้นหาซับซ้อนกว่า deps(//foo)
--implicit_deps (บูลีน, default=True)
การตั้งค่าแฟล็กนี้เป็น "เท็จ" จะกรองผลลัพธ์ทั้งหมดที่ไม่ได้ตั้งค่าอย่างชัดเจนในไฟล์ BUILD ออกไป และ Bazel ตั้งค่าไว้ที่อื่นแทน ซึ่งรวมถึงการกรอง toolchain ที่แก้ไขแล้ว
--tool_deps (บูลีน ค่าเริ่มต้นคือ "จริง")
การตั้งค่า Flag นี้เป็นเท็จจะกรองเป้าหมายที่กําหนดค่าไว้ทั้งหมดออก ซึ่งเส้นทางจากเป้าหมายที่ค้นหาไปยังเป้าหมายดังกล่าวจะข้ามการเปลี่ยนระหว่างการกําหนดค่าเป้าหมายกับการกําหนดค่าที่ไม่ใช่เป้าหมาย
หากเป้าหมายที่ค้นหาอยู่ในการกําหนดค่าเป้าหมาย การตั้งค่า --notool_deps จะแสดงเฉพาะเป้าหมายที่อยู่ในการกําหนดค่าเป้าหมายด้วย หากเป้าหมายที่ค้นหาอยู่ในการกําหนดค่าที่ไม่ใช่เป้าหมาย การตั้งค่า --notool_deps จะแสดงเฉพาะเป้าหมายในการกําหนดค่าที่ไม่ใช่เป้าหมายเท่านั้น โดยทั่วไปการตั้งค่านี้จะไม่ส่งผลต่อตัวกรองของเครื่องมือทางเทคนิคที่แก้ไขแล้ว
--include_aspects (บูลีน, default=True)
รวมการพึ่งพาที่เพิ่มโดยแง่มุม
หากปิดใช้ Flag นี้ cquery somepath(X, Y) และ cquery deps(X) | grep 'Y' จะข้าม Y หาก X อิงตามมุมมองเท่านั้น
รูปแบบเอาต์พุต
โดยค่าเริ่มต้น เอาต์พุต cquery จะแสดงรายการที่เรียงลำดับตามการขึ้นต่อกันของคู่ป้ายกำกับและการกำหนดค่า ยังมีตัวเลือกอื่นๆ ในการแสดงผลลัพธ์ด้วย
ทรานซิชัน
--transitions=lite --transitions=full
การเปลี่ยนการกําหนดค่าจะใช้ในการสร้างเป้าหมายที่อยู่ภายใต้เป้าหมายระดับบนสุดในการกําหนดค่าที่แตกต่างจากเป้าหมายระดับบนสุด
เช่น เป้าหมายอาจกำหนดการเปลี่ยนไปใช้การกำหนดค่า exec สำหรับการพึ่งพาทั้งหมดในแอตทริบิวต์ tools ซึ่งเราเรียกว่าการเปลี่ยน
แอตทริบิวต์ กฎยังบังคับใช้การเปลี่ยนรูปแบบในการกำหนดค่าของตนเองได้ด้วย ซึ่งเรียกว่าการเปลี่ยนรูปแบบคลาสของกฎ รูปแบบเอาต์พุตนี้จะแสดงข้อมูลเกี่ยวกับทรานซิชัน เช่น ประเภทของทรานซิชันและผลที่มีต่อตัวเลือกการสร้าง
รูปแบบเอาต์พุตนี้จะทริกเกอร์โดย Flag --transitions ซึ่งตั้งค่าเป็น NONE โดยค่าเริ่มต้น โดยตั้งค่าเป็นโหมด FULL หรือ LITE ได้ โหมด FULL จะแสดงผลข้อมูลเกี่ยวกับการเปลี่ยนคลาสของกฎและการเปลี่ยนแอตทริบิวต์ รวมถึงความแตกต่างของตัวเลือกอย่างละเอียดทั้งก่อนและหลังการเปลี่ยน โหมด LITE
จะแสดงข้อมูลเดียวกันโดยไม่มีความแตกต่างของตัวเลือก
เอาต์พุตข้อความโปรโตคอล
--output=proto
ตัวเลือกนี้จะทําให้ระบบพิมพ์เป้าหมายที่ได้ในรูปแบบบัฟเฟอร์โปรโตคอลไบนารี ดูคำจำกัดความของ Protocol Buffer ได้ที่ src/main/protobuf/analysis_v2.proto
CqueryResult คือข้อความระดับบนสุดที่มีผลลัพธ์ของ cquery โดยจะมีรายการข้อความ ConfiguredTarget รายการและรายการข้อความ Configuration ConfiguredTarget แต่ละรายการมี configuration_id ที่มีค่าเท่ากับค่าของช่อง id จากข้อความ Configuration ที่เกี่ยวข้อง
--[no]proto:include_configurations
โดยค่าเริ่มต้น ผลลัพธ์ cquery จะแสดงข้อมูลการกําหนดค่าเป็นส่วนหนึ่งของเป้าหมายที่กําหนดค่าไว้แต่ละรายการ หากไม่ต้องการใช้ข้อมูลนี้และรับเอาต์พุต Proto ที่มีการจัดรูปแบบเหมือนกับเอาต์พุต Proto ของคำค้นหาทุกประการ ให้ตั้งค่าแฟล็กนี้เป็น "เท็จ"
ดูเอกสารประกอบเอาต์พุต Proto ของการค้นหาเพื่อดูตัวเลือกเพิ่มเติมเกี่ยวกับเอาต์พุต Pro
เอาต์พุตกราฟ
--output=graph
ตัวเลือกนี้จะสร้างเอาต์พุตเป็นไฟล์ .dot ที่เข้ากันได้กับ Graphviz ดูรายละเอียดได้ที่เอกสารประกอบเอาต์พุตกราฟของ query cquery
ยังรองรับ --graph:node_limit และ
--graph:factored ด้วย
เอาต์พุตไฟล์
--output=files
ตัวเลือกนี้จะพิมพ์รายการไฟล์เอาต์พุตที่สร้างขึ้นโดยแต่ละเป้าหมายที่ตรงกับข้อความค้นหา ซึ่งคล้ายกับรายการที่พิมพ์ไว้ที่ท้ายการเรียกใช้ bazel build เอาต์พุตจะมีเฉพาะไฟล์ที่โฆษณาในกลุ่มเอาต์พุตที่ขอตามที่ระบุโดย Flag --output_groups
ซึ่งรวมถึงไฟล์ต้นฉบับ
เส้นทางทั้งหมดที่เกิดจากรูปแบบเอาต์พุตนี้จะสัมพันธ์กับ execroot ซึ่งรับได้ผ่าน bazel info execution_root หากมีลิงก์สัญลักษณ์ความสะดวก bazel-out เส้นทางไปยังไฟล์ในที่เก็บหลักจะแก้ไขซึ่งสัมพันธ์กับไดเรกทอรีพื้นที่ทำงานด้วย
การกําหนดรูปแบบเอาต์พุตโดยใช้ Starlark
--output=starlark
รูปแบบเอาต์พุตนี้จะเรียกใช้ฟังก์ชัน Starlark สําหรับเป้าหมายที่กําหนดค่าไว้แต่ละรายการในผลการค้นหา และพิมพ์ค่าที่การเรียกแสดงผล Flag --starlark:file จะระบุตำแหน่งของไฟล์ Starlark ที่กําหนดฟังก์ชันชื่อ format ที่มีพารามิเตอร์เดียว target ระบบจะเรียกใช้ฟังก์ชันนี้สำหรับเป้าหมายแต่ละรายการในผลการค้นหา หรือเพื่อความสะดวก คุณอาจระบุเฉพาะเนื้อหาของฟังก์ชันที่ประกาศเป็น def format(target): return expr โดยใช้แฟล็ก --starlark:expr
ภาษาถิ่น "cquery" ของ Starlark
สภาพแวดล้อมของ cquery Starlark จะแตกต่างจากไฟล์ BUILD หรือ .bzl ซึ่งรวมค่าคงที่และฟังก์ชันในตัวของ Starlark ทั้งหมด
บวกด้วยค่าคงที่และฟังก์ชันเฉพาะการสืบค้นบางส่วนที่อธิบายไว้ด้านล่าง แต่ไม่ใช่ (ตัวอย่างเช่น) glob,native หรือ rule และไม่รองรับคำสั่งโหลด
build_options(target)
build_options(target) จะแสดงผลแผนที่ซึ่งมีคีย์เป็นตัวระบุตัวเลือกบิลด์ (ดูการกำหนดค่า) และค่าที่เป็นค่า Starlark ระบบจะไม่รวมตัวเลือกการสร้างที่มีค่าที่ไม่ใช่ค่า Starlark ที่ถูกต้องไว้ในแผนที่นี้
หากเป้าหมายเป็นไฟล์อินพุต build_options(target) จะแสดงผล "ไม่มี" เนื่องจากเป้าหมายไฟล์อินพุตมีการกำหนดค่า Null
providers(target)
providers(target) จะแสดงผลแผนที่มีคีย์เป็นชื่อผู้ให้บริการ (เช่น "DefaultInfo") และค่าที่เป็นค่า Starlark ระบบจะไม่รวมผู้ให้บริการที่มีค่าไม่ใช่ค่า Starlark ที่ถูกต้องไว้ในแผนที่นี้
ตัวอย่าง
พิมพ์รายการชื่อฐานของไฟล์ทั้งหมดที่ //foo สร้างขึ้นโดยคั่นด้วยเว้นวรรค
bazel cquery //foo --output=starlark \
--starlark:expr="' '.join([f.basename for f in target.files.to_list()])"
พิมพ์รายการเส้นทางของไฟล์ทั้งหมดที่ผลิตโดยเป้าหมาย rule ใน //bar และแพ็กเกจย่อย โดยใช้การเว้นวรรคเป็นตัวคั่น
bazel cquery 'kind(rule, //bar/...)' --output=starlark \
--starlark:expr="' '.join([f.path for f in target.files.to_list()])"
พิมพ์รายการคําช่วยจําของการดำเนินการทั้งหมดที่ //foo บันทึกไว้
bazel cquery //foo --output=starlark \
--starlark:expr="[a.mnemonic for a in target.actions]"
พิมพ์รายการเอาต์พุตคอมไพล์ที่ลงทะเบียนโดย cc_library //baz
bazel cquery //baz --output=starlark \
--starlark:expr="[f.path for f in target.output_groups.compilation_outputs.to_list()]"
พิมพ์ค่าของตัวเลือกบรรทัดคำสั่ง --javacopt เมื่อสร้าง //foo
bazel cquery //foo --output=starlark \
--starlark:expr="build_options(target)['//command_line_option:javacopt']"
พิมพ์ป้ายกำกับของเป้าหมายแต่ละรายการที่มีเอาต์พุตเพียงรายการเดียว ตัวอย่างนี้ใช้ฟังก์ชัน Starlark ที่กำหนดไว้ในไฟล์
$ cat example.cquery
def has_one_output(target):
return len(target.files.to_list()) == 1
def format(target):
if has_one_output(target):
return target.label
else:
return ""
$ bazel cquery //baz --output=starlark --starlark:file=example.cquery
พิมพ์ป้ายกำกับของเป้าหมายแต่ละรายการที่เป็น Python 3 เท่านั้น ตัวอย่างนี้ใช้ฟังก์ชัน Starlark ที่กําหนดไว้ในไฟล์
$ cat example.cquery
def format(target):
p = providers(target)
py_info = p.get("PyInfo")
if py_info and py_info.has_py3_only_sources:
return target.label
else:
return ""
$ bazel cquery //baz --output=starlark --starlark:file=example.cquery
ดึงค่าจากผู้ให้บริการที่กําหนดโดยผู้ใช้
$ cat some_package/my_rule.bzl
MyRuleInfo = provider(fields={"color": "the name of a color"})
def _my_rule_impl(ctx):
...
return [MyRuleInfo(color="red")]
my_rule = rule(
implementation = _my_rule_impl,
attrs = {...},
)
$ cat example.cquery
def format(target):
p = providers(target)
my_rule_info = p.get("//some_package:my_rule.bzl%MyRuleInfo'")
if my_rule_info:
return my_rule_info.color
return ""
$ bazel cquery //baz --output=starlark --starlark:file=example.cquery
cquery เทียบกับ query
cquery และ query ส่งเสริมกันและกัน และโดดเด่นในด้านต่างๆ ลองตัดสินใจเลือกเครื่องมือต่อไปนี้ที่เหมาะกับคุณ
cqueryตาม Branch ของselect()เพื่อสร้างโมเดลกราฟเดียวกับที่คุณสร้างqueryไม่ทราบว่าบิลด์จะเลือก Branch ใด ดังนั้นจึงประมาณค่ามากเกินไปโดยรวม Branch ทั้งหมด- ความแม่นยำของ
cqueryต้องใช้การสร้างกราฟมากกว่าqueryกล่าวโดยละเอียดคือcqueryจะประเมินเป้าหมายที่กําหนดค่าไว้ ส่วนqueryจะประเมินเป้าหมายเท่านั้น ซึ่งจะใช้เวลานานกว่าและใช้หน่วยความจำมากขึ้น - การตีความภาษาของคำค้นหาของ
cqueryทำให้เกิดความกำกวมที่queryหลีกเลี่ยงได้ เช่น หาก"//foo"มีอยู่ในการกําหนดค่า 2 รายการcquery "deps(//foo)"ควรใช้การกําหนดค่าใด ฟังก์ชันconfigช่วยแก้ปัญหานี้ได้ - เนื่องจาก
cqueryเป็นเครื่องมือที่ใหม่กว่า จึงขาดการรองรับกรณีการใช้งานบางกรณี โปรดดูรายละเอียดในปัญหาที่ทราบ
ปัญหาที่ทราบ
เป้าหมายทั้งหมดที่ cquery "สร้าง" ต้องมีการกำหนดค่าเดียวกัน
ก่อนประเมินการค้นหา cquery จะทริกเกอร์บิลด์จนถึงจุดที่การทำงานของบิลด์จะทำงาน โดยค่าเริ่มต้น ระบบจะเลือกเป้าหมายที่ "สร้าง" จากป้ายกำกับทั้งหมดที่ปรากฏในนิพจน์การค้นหา (สามารถลบล้างได้โดยใช้ --universe_scope) ป้ายกำกับเหล่านี้ต้องมีการกําหนดค่าเดียวกัน
แม้ว่าโดยทั่วไปแล้ว กฎเหล่านี้จะแชร์การกำหนดค่า "เป้าหมาย" ระดับบนสุด แต่กฎจะเปลี่ยนการกำหนดค่าของตนเองได้ด้วยการเปลี่ยน Edge ขาเข้า
cquery มีข้อจำกัดตรงจุดนี้
วิธีแก้ปัญหาเบื้องต้น: หากเป็นไปได้ ให้ตั้งค่า --universe_scope เป็นขอบเขตที่เข้มงวดขึ้น เช่น
# This command attempts to build the transitive closures of both //foo and # //bar. //bar uses an incoming edge transition to change its --cpu flag. $ bazel cquery 'somepath(//foo, //bar)' ERROR: Error doing post analysis query: Top-level targets //foo and //bar have different configurations (top-level targets with different configurations is not supported) # This command only builds the transitive closure of //foo, under which # //bar should exist in the correct configuration. $ bazel cquery 'somepath(//foo, //bar)' --universe_scope=//foo
ไม่มีการสนับสนุนสำหรับ --output=xml
เอาต์พุตแบบไม่กำหนด
cquery จะไม่ล้างกราฟบิลด์จากคำสั่งก่อนหน้าโดยอัตโนมัติ และมีแนวโน้มที่จะได้รับผลลัพธ์จากการค้นหาที่ผ่านมา ตัวอย่างเช่น genquery ดำเนินการเปลี่ยนให้ผู้บริหารในแอตทริบิวต์ tools กล่าวคือ จะกำหนดค่าเครื่องมือในการกำหนดค่าการดำเนินการ
คุณสามารถดูผลกระทบที่จะเกิดขึ้นจากการเปลี่ยนผ่านนี้ได้ที่ด้านล่าง
$ cat > foo/BUILD <<<EOF
genrule(
name = "my_gen",
srcs = ["x.in"],
outs = ["x.cc"],
cmd = "$(locations :tool) $< >$@",
tools = [":tool"],
)
cc_library(
name = "tool",
)
EOF
$ bazel cquery "//foo:tool"
tool(target_config)
$ bazel cquery "deps(//foo:my_gen)"
my_gen (target_config)
tool (exec_config)
...
$ bazel cquery "//foo:tool"
tool(exec_config)
วิธีแก้ปัญหาเบื้องต้นคือ เปลี่ยนตัวเลือกการเริ่มต้นเพื่อบังคับให้มีการวิเคราะห์เป้าหมายที่กำหนดค่าไว้อีกครั้ง
เช่น เพิ่ม --test_arg=<whatever> ลงในคำสั่งบิลด์
การแก้ปัญหา
รูปแบบเป้าหมายที่เกิดซ้ำ (/...)
หากคุณพบสิ่งต่อไปนี้
$ bazel cquery --universe_scope=//foo:app "somepath(//foo:app, //foo/...)" ERROR: Error doing post analysis query: Evaluation failed: Unable to load package '[foo]' because package is not in scope. Check that all target patterns in query expression are within the --universe_scope of this query.
ข้อความนี้ระบุว่าแพ็กเกจ //foo ไม่ได้อยู่ในขอบเขตอย่างไม่ถูกต้อง แม้ว่า --universe_scope=//foo:app จะรวมแพ็กเกจดังกล่าวไว้ก็ตาม เนื่องจากข้อจำกัดด้านการออกแบบใน cquery วิธีแก้ปัญหาชั่วคราวคือระบุ //foo/... อย่างชัดเจนในขอบเขตจักรวาล ดังนี้
$ bazel cquery --universe_scope=//foo:app,//foo/... "somepath(//foo:app, //foo/...)"
หากไม่ได้ผล (เช่น เนื่องจากเป้าหมายบางรายการใน //foo/... ไม่สามารถสร้างขึ้นด้วย Flag การสร้างที่เลือก) ให้เลิกแพ็กเกจรูปแบบเป็นแพ็กเกจย่อยด้วยตนเองโดยใช้การค้นหาการประมวลผลก่อนดังนี้
# Replace "//foo/..." with a subshell query call (not cquery!) outputting each package, piped into # a sed call converting "<pkg>" to "//<pkg>:*", piped into a "+"-delimited line merge. # Output looks like "//foo:*+//foo/bar:*+//foo/baz". # $ bazel cquery --universe_scope=//foo:app "somepath(//foo:app, $(bazel query //foo/... --output=package | sed -e 's/^/\/\//' -e 's/$/:*/' | paste -sd "+" -))"