cquery
เป็นตัวแปรของ query
ที่จัดการ select()
และเอฟเฟกต์ของตัวเลือกบิลด์ในกราฟบิลด์ได้อย่างถูกต้อง
โซลูชันนี้ทำได้โดยนำผลลัพธ์ในระยะการวิเคราะห์ของ Bazel มาใช้ ซึ่งผสานรวมเอฟเฟกต์เหล่านี้เข้าด้วยกัน ในทางตรงกันข้าม query
จะแสดงบนผลลัพธ์ของระยะการโหลดของ Bazel ก่อนที่จะประเมินตัวเลือก
เช่น
$ 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
เข้าใจคำนำหน้าที่ถูกต้องของรหัสที่สมบูรณ์ คล้ายกับแฮชสั้นๆ
หากต้องการดูรหัสทั้งหมด ให้เรียกใช้ $ 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 คือ 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 ปกติและด้วยเหตุนี้จึงได้รับชุดตัวเลือกที่ใช้ได้ระหว่างบิลด์
การใช้ตัวเลือก cquery
--universe_scope
(รายการที่คั่นด้วยจุลภาค)
บ่อยครั้งที่ทรัพยากร Dependency ของเป้าหมายที่กําหนดค่าไว้ต้องดําเนินการผ่านการเปลี่ยน ซึ่งทำให้การกําหนดค่าต่างจากการอ้างอิง แฟล็กนี้ทำให้คุณค้นหาเป้าหมายได้ราวกับว่าเป้าหมายนั้นสร้างขึ้นเป็นทรัพยากร 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 จะกำหนดค่าเครื่องมือในการกำหนดค่า exec ดังนั้นการค้นหาต่อไปนี้จะสร้างเอาต์พุตต่อไปนี้
การค้นหา | สร้างเป้าหมายแล้ว | เอาต์พุต |
---|---|---|
bazel cquery "//x:tool" | //x:tool | //x:tool(targetconfig) |
bazel cquery "//x:tool" --universe_scope="//x:my_gen" | //x:my_gen | //x:tool(execconfig) |
หากตั้งค่าแฟล็กนี้ ระบบจะสร้างเนื้อหาขึ้น หากไม่ได้ตั้งค่า ระบบจะสร้างเป้าหมายทั้งหมดที่กล่าวถึงในนิพจน์คำค้นหาแทน การปิดทางอ้อมของเป้าหมายที่สร้างขึ้นจะใช้เป็นจักรวาลของข้อความค้นหา ไม่ว่าจะเป็นลักษณะใดก็ตาม เป้าหมายที่จะสร้างต้องสร้างได้ที่ระดับบนสุด (ซึ่งเข้ากันได้กับตัวเลือกระดับบนสุด) cquery
จะแสดงผลลัพธ์การปิดชั่วคราวของเป้าหมายระดับบนสุดเหล่านี้
แม้คุณจะสร้างเป้าหมายทั้งหมดในนิพจน์การค้นหาที่ระดับบนสุดได้ แต่ไม่ควรสร้างเป้าหมายทั้งหมด ตัวอย่างเช่น การตั้งค่า --universe_scope
อย่างชัดเจนอาจป้องกันไม่ให้สร้างเป้าหมายหลายครั้งในการกำหนดค่าที่คุณไม่สนใจ นอกจากนี้ยังสามารถช่วยระบุเวอร์ชันการกำหนดค่าของเป้าหมายที่คุณต้องการได้ (เนื่องจากปัจจุบันยังไม่สามารถระบุรูปแบบการกำหนดค่านี้ได้อย่างสมบูรณ์) คุณควรตั้งค่าแฟล็กนี้หากนิพจน์คำค้นหาของคุณซับซ้อนกว่า deps(//foo)
--implicit_deps
(บูลีน, default=True)
การตั้งค่าแฟล็กนี้เป็น "เท็จ" จะกรองผลลัพธ์ทั้งหมดที่ไม่ได้กำหนดไว้อย่างชัดเจนในไฟล์ BUILD และตั้งค่าที่อื่นโดย Bazel แทน ซึ่งรวมถึงการกรอง toolchain ที่แก้ไขแล้ว
--tool_deps
(บูลีน, default=True)
การตั้งค่าแฟล็กนี้เป็น "เท็จ" จะกรองเป้าหมายที่กำหนดค่าไว้ทั้งหมดซึ่งเส้นทางจากเป้าหมายที่ค้นหาไปยังเป้าหมายดังกล่าวมีการข้ามการเปลี่ยนระหว่างการกำหนดค่าเป้าหมายและการกำหนดค่าที่ไม่ใช่เป้าหมาย
หากเป้าหมายที่ค้นหาอยู่ในการกำหนดค่าเป้าหมาย การตั้งค่า --notool_deps
จะแสดงผลเฉพาะเป้าหมายที่อยู่ในการกำหนดค่าเป้าหมายด้วยเท่านั้น หากเป้าหมายที่ค้นหาอยู่ในการกำหนดค่าที่ไม่ใช่เป้าหมาย การตั้งค่า --notool_deps
จะแสดงผลเฉพาะเป้าหมายในการกำหนดค่าที่ไม่ใช่เป้าหมายด้วย โดยทั่วไปการตั้งค่านี้จะไม่ส่งผลต่อการกรอง
ชุดเครื่องมือที่แก้ไขแล้ว
--include_aspects
(บูลีน, default=True)
รวมทรัพยากร Dependency ที่เพิ่มโดย Aspect
หากปิดใช้แฟล็กนี้ cquery somepath(X, Y)
และ cquery deps(X) | grep 'Y'
จะข้าม Y หาก X พิจารณาเฉพาะแง่มุมเท่านั้น
รูปแบบเอาต์พุต
โดยค่าเริ่มต้น เอาต์พุต cquery จะแสดงเป็นรายการคู่ป้ายกำกับและการกำหนดค่าที่เรียงลำดับตามทรัพยากร Dependency ยังมีตัวเลือกอื่นๆ ในการแสดงผลลัพธ์เช่นกัน
ทรานซิชัน
--transitions=lite --transitions=full
การเปลี่ยนการกำหนดค่าใช้เพื่อสร้างเป้าหมายภายใต้เป้าหมายระดับบนสุดในการกำหนดค่าที่แตกต่างจากเป้าหมายระดับบนสุด
เช่น เป้าหมายอาจกำหนดการเปลี่ยนไปใช้การกำหนดค่าการดำเนินการบนทรัพยากร Dependency ทั้งหมดในแอตทริบิวต์ tools
ซึ่งเรียกว่าการเปลี่ยน
แอตทริบิวต์ กฎยังทำให้เกิดการเปลี่ยนการกำหนดค่าของตัวเอง หรือที่เรียกว่าการเปลี่ยนคลาสของกฎ รูปแบบเอาต์พุตนี้ให้ข้อมูลเกี่ยวกับการเปลี่ยนเหล่านี้ เช่น การเปลี่ยนประเภทและผลที่มีต่อตัวเลือกบิลด์
รูปแบบเอาต์พุตนี้จะทริกเกอร์โดยแฟล็ก --transitions
ซึ่งตั้งค่าเริ่มต้นเป็น NONE
ตัวเลือกนี้อาจตั้งค่าเป็นโหมด FULL
หรือ LITE
โหมด FULL
ให้ข้อมูลเกี่ยวกับการเปลี่ยนคลาสของกฎและการเปลี่ยนแอตทริบิวต์ รวมถึงความแตกต่างโดยละเอียดของตัวเลือกก่อนและหลังการเปลี่ยน โหมด LITE
จะแสดงผลข้อมูลเดียวกันโดยไม่มีความแตกต่างของตัวเลือก
เอาต์พุตข้อความโปรโตคอล
--output=proto
ตัวเลือกนี้จะทำให้ระบบพิมพ์เป้าหมายที่ได้ในรูปแบบบัฟเฟอร์โปรโตคอลไบนารี ดูคำจำกัดความของบัฟเฟอร์โปรโตคอลได้ที่ src/main/protobuf/analysis_v2.proto
CqueryResult
คือข้อความระดับบนสุดที่มีผลลัพธ์ของการค้นหา ซึ่งมีรายการข้อความ ConfiguredTarget
และรายชื่อข้อความ Configuration
ข้อความ ConfiguredTarget
แต่ละรายการจะมี configuration_id
ที่มีค่าเท่ากับค่าของช่อง id
จากข้อความ Configuration
ที่เกี่ยวข้อง
--[no]proto:include_configurations
โดยค่าเริ่มต้น ผลลัพธ์ cquery จะแสดงข้อมูลการกำหนดค่าเป็นส่วนหนึ่งของเป้าหมายที่กำหนดค่าแต่ละรายการ หากคุณไม่ต้องการใช้ข้อมูลนี้และรับเอาต์พุต Proto ที่มีการจัดรูปแบบเหมือนกับเอาต์พุต Proto ของการค้นหา ให้ตั้งค่าแฟล็กนี้เป็น "เท็จ"
ดูเอกสารเกี่ยวกับเอาต์พุต Proto ของการค้นหาเพื่อดูตัวเลือกอื่นๆ ที่เกี่ยวข้องกับเอาต์พุตโปรโต
เอาต์พุตกราฟ
--output=graph
ตัวเลือกนี้จะสร้างเอาต์พุตเป็นไฟล์ .dot ที่ใช้ร่วมกับ Graphviz ได้ ดูรายละเอียดได้จากเอกสารประกอบเกี่ยวกับเอาต์พุตกราฟของ query
cquery
รวมถึง --graph:node_limit
และ --graph:factored
ด้วย
เอาต์พุตไฟล์
--output=files
ตัวเลือกนี้จะพิมพ์รายการไฟล์เอาต์พุตที่สร้างโดยเป้าหมายแต่ละรายการซึ่งตรงกับคำค้นหาที่คล้ายกับรายการที่พิมพ์ไว้ท้ายคำขอ bazel build
ผลลัพธ์จะมีเฉพาะไฟล์ที่โฆษณาในกลุ่มเอาต์พุตที่ขอตามที่กำหนดโดยแฟล็ก --output_groups
แต่รวมไฟล์ต้นฉบับ
เส้นทางทั้งหมดที่เกิดจากรูปแบบเอาต์พุตนี้จะสัมพัทธ์กับ execroot ซึ่งสามารถรับได้ผ่านทาง bazel info execution_root
หากมีลิงก์สัญลักษณ์อำนวยความสะดวก bazel-out
เส้นทางไปยังไฟล์ในที่เก็บหลักก็เปลี่ยนไปตามไดเรกทอรีพื้นที่ทำงานด้วย
การกำหนดรูปแบบเอาต์พุตโดยใช้ Starlark
--output=starlark
รูปแบบเอาต์พุตนี้จะเรียกใช้ฟังก์ชัน Starlark สำหรับเป้าหมายที่กำหนดค่าแต่ละรายการในผลการค้นหา และพิมพ์ค่าที่การเรียกกลับมา แฟล็ก --starlark:file
ระบุตำแหน่งของไฟล์ Starlark ที่กำหนดฟังก์ชันที่ชื่อว่า format
ที่มีพารามิเตอร์เดียว นั่นคือ target
โดยฟังก์ชันนี้จะเรียกฟังก์ชันนี้สำหรับเป้าหมายแต่ละรายการในผลการค้นหา หรือคุณจะระบุเฉพาะเนื้อหาของฟังก์ชันที่ประกาศเป็น def format(target): return expr
โดยใช้แฟล็ก --starlark:expr
ก็ได้เพื่อความสะดวก
ภาษาถิ่น "cquery" แบบ Starlark
สภาพแวดล้อมการค้นหา Starlark แตกต่างจากไฟล์ BUILD หรือ .bzl ซึ่งรวมถึงค่าคงที่และฟังก์ชันในตัวของ Starlark หลักทั้งหมด รวมถึงฟังก์ชันเฉพาะคำค้นหาบางรายการที่อธิบายไว้ด้านล่าง แต่ไม่ใช่ (ตัวอย่างเช่น) glob
, native
หรือ rule
และไม่รองรับคำสั่งการโหลด
build_options(target)
build_options(target)
แสดงผลแผนที่ซึ่งมีคีย์เป็นตัวระบุตัวเลือกบิลด์ (ดูการกำหนดค่า) และมีค่าต่างๆ ที่เป็นค่า Starlark ตัวเลือกบิลด์ที่มีค่าที่ไม่ใช่ค่า Starlark ตามกฎหมายจะไม่รวมอยู่ในแผนที่นี้
หากเป้าหมายเป็นไฟล์อินพุต build_options(target)
จะแสดงผลเป็น "ไม่มี" เนื่องจากเป้าหมายไฟล์อินพุตมีการกำหนดค่า Null
ผู้ให้บริการ(เป้าหมาย)
providers(target)
แสดงผลแผนที่ซึ่งมีคีย์ที่เป็นชื่อของผู้ให้บริการ (เช่น "DefaultInfo"
) และมีค่าเป็น Starlark ผู้ให้บริการที่มีค่าที่ไม่ใช่ค่า Starlark ตามกฎหมายจะไม่รวมอยู่ในแผนที่นี้
ตัวอย่าง
พิมพ์รายการชื่อพื้นฐานของไฟล์ทั้งหมดที่สร้างโดย //foo
โดยคั่นด้วยการเว้นวรรค:
bazel cquery //foo --output=starlark \ --starlark:expr="' '.join([f.basename for f in target.files.to_list()])"
พิมพ์รายการเส้นทางของไฟล์ทั้งหมดที่สร้างขึ้นโดยเป้าหมายกฎใน //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
จะตามกิ่งไม้select()
ที่เฉพาะเจาะจงเพื่อสร้างรูปแบบกราฟที่ถูกต้องที่คุณสร้างขึ้นquery
ไม่ทราบว่าบิลด์เลือกสาขาใด ให้รวม Branch ทั้งหมดโดยประมาณให้มากเกินไป- ความแม่นยำของ
cquery
ต้องการการสร้างกราฟมากกว่าquery
โดยเฉพาะอย่างยิ่งcquery
จะประเมินเป้าหมายที่กำหนดค่าไว้ ขณะที่query
ประเมินเฉพาะเป้าหมาย ซึ่งจะใช้เวลานานขึ้นและใช้หน่วยความจำมากขึ้น - การตีความภาษาของการค้นหาของ
cquery
ก่อให้เกิดความกำกวมที่query
หลีกเลี่ยง เช่น หากมี"//foo"
อยู่ในการกำหนดค่า 2 รายการcquery "deps(//foo)"
ควรใช้การกำหนดค่าใด ฟังก์ชันconfig
สามารถช่วยในเรื่องนี้ได้ - ในฐานะเครื่องมือที่ใหม่กว่า
cquery
จึงไม่รองรับกรณีการใช้งานบางอย่าง โปรดดูรายละเอียดในปัญหาที่ทราบ
ปัญหาที่ทราบแล้ว
เป้าหมายทั้งหมดที่ cquery
"สร้าง" ต้องมีการกำหนดค่าเดียวกัน
ก่อนประเมินคำค้นหา cquery
จะทริกเกอร์บิลด์ก่อนจุดที่จะมีการดำเนินการบิลด์ ระบบจะเลือกเป้าหมายที่ "สร้าง" เป็นค่าเริ่มต้นจากป้ายกำกับทั้งหมดที่ปรากฏในนิพจน์การค้นหา (ลบล้างด้วย --universe_scope
ได้) โดยเป้าหมายเหล่านี้ต้องมีการกำหนดค่าเดียวกัน
แม้ว่าโดยทั่วไปแล้ว กรณีเหล่านี้จะใช้การกำหนดค่า "เป้าหมาย" ระดับบนสุด แต่กฎจะเปลี่ยนการกำหนดค่าของตนเองได้ด้วยการเปลี่ยนผ่านขอบขาเข้า
นี่คือสาเหตุที่ 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
ไม่ล้างกราฟบิลด์จากคำสั่งก่อนหน้าโดยอัตโนมัติ ดังนั้นจึงมีแนวโน้มที่จะรวบรวมผลลัพธ์จากการค้นหาที่ผ่านมา เช่น genrule
ดำเนินการเปลี่ยนผู้บริหารในแอตทริบิวต์ 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/...
ไม่สามารถสร้างด้วยแฟล็กบิลด์ที่เลือก) ให้แยกรูปแบบลงในแพ็กเกจส่วนประกอบด้วยคำค้นหาที่ประมวลผลล่วงหน้าด้วยตนเอง ดังนี้
# 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 "+" -))"