การอ้างอิงบรรทัดคำสั่ง

bazel [<startup options>] <command> [<args>]
หรือ
bazel [<startup options>] <command> [<args>] -- [<target patterns>]
โปรดดูคู่มือผู้ใช้สำหรับ รูปแบบเป้าหมาย

ไวยากรณ์ตัวเลือก

ส่งผ่านตัวเลือกไปยัง Bazel ได้หลายวิธี ตัวเลือกที่ต้องมีค่า อาจส่งด้วยเครื่องหมายเท่ากับหรือเว้นวรรคก็ได้ ดังนี้

--<option>=<value>
--<option> <value>
ตัวเลือกบางรายการจะมีรูปแบบสั้นๆ แบบอักขระเดียว ในกรณีนี้ รูปแบบสั้นๆ จะต้องใส่ขีดกลางเพียงครั้งเดียวและเว้นวรรค
-<short_form> <value>

ตัวเลือกบูลีนสามารถเปิดใช้ได้ดังนี้

--<option>
--<option>=[true|yes|1]
และปิดใช้ ดังนี้
--no<option>
--<option>=[false|no|0]

โดยปกติตัวเลือก Tristate จะตั้งไว้เป็นแบบอัตโนมัติโดยค่าเริ่มต้น และสามารถ ดังนี้

--<option>=[true|yes|1]
หรือถูกบังคับให้ปิดใช้
--no<option>
--<option>=[false|no|0]

คำสั่ง

analyze-profile วิเคราะห์ข้อมูลโปรไฟล์ของบิลด์
aquery วิเคราะห์เป้าหมายที่ระบุและค้นหากราฟการกระทำ
build สร้างเป้าหมายที่ระบุ
canonicalize-flags การกำหนดรายการตัวเลือก Canonical เป็น Canonical
clean นำไฟล์เอาต์พุตออกและเลือกหยุดเซิร์ฟเวอร์หรือไม่ก็ได้
coverage สร้างรายงานการครอบคลุมของโค้ดสำหรับเป้าหมายทดสอบที่ระบุ
cquery โหลด วิเคราะห์ และค้นหาเป้าหมายที่ระบุพร้อมการกำหนดค่า
dump ดัมพ์สถานะภายในของกระบวนการของเซิร์ฟเวอร์ bazel
fetch ดึงข้อมูลที่เก็บภายนอกที่จำเป็นเบื้องต้นไปยังเป้าหมาย
help ความช่วยเหลือเกี่ยวกับการพิมพ์สำหรับคำสั่งหรือดัชนี
info แสดงข้อมูลรันไทม์เกี่ยวกับเซิร์ฟเวอร์ bazel
license พิมพ์ใบอนุญาตของซอฟต์แวร์นี้
mobile-install เป้าหมายการติดตั้งไปยังอุปกรณ์เคลื่อนที่
mod ค้นหากราฟทรัพยากร Dependency ภายนอกของ Bzlmod
print_action พิมพ์อาร์กิวเมนต์บรรทัดคำสั่งเพื่อคอมไพล์ไฟล์
query ดำเนินการค้นหากราฟทรัพยากร Dependency
run เรียกใช้เป้าหมายที่ระบุ
shutdown หยุดเซิร์ฟเวอร์ bazel
sync ซิงค์ที่เก็บทั้งหมดที่ระบุไว้ในไฟล์พื้นที่ทำงาน
test สร้างและเรียกใช้เป้าหมายทดสอบที่ระบุ
vendor ดึงข้อมูลที่เก็บภายนอกลงในโฟลเดอร์ที่ระบุโดยแฟล็ก --vendor_dir
version พิมพ์ข้อมูลเวอร์ชันสำหรับ Bazel

ตัวเลือกการเริ่มทำงาน

ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
ค่าเริ่มต้น --[no]autodetect_server_javabase: "true"
เมื่อมีการส่ง --noautodetect_server_javabase แล้ว Bazel จะไม่ถอยกลับไปยัง JDK ในเครื่องเพื่อเรียกใช้เซิร์ฟเวอร์ bazel และออกแทน
แท็ก: affects_outputs loses_incremental_state
ค่าเริ่มต้น --[no]batch: "เท็จ"
หากตั้งค่าไว้ Bazel จะทำงานเป็นกระบวนการของไคลเอ็นต์โดยไม่มีเซิร์ฟเวอร์ แทนที่จะเป็นโหมดไคลเอ็นต์/เซิร์ฟเวอร์มาตรฐาน คำสั่งนี้เลิกใช้งานแล้วและจะถูกนำออก โปรดปิดเซิร์ฟเวอร์อย่างชัดเจนหากต้องการหลีกเลี่ยงไม่ให้เซิร์ฟเวอร์ค้าง
แท็ก: loses_incremental_state, bazel_internal_configuration, deprecated
ค่าเริ่มต้น --[no]batch_cpu_scheduling: "เท็จ"
เฉพาะใน Linux ใช้ "กลุ่ม" การตั้งเวลา CPU สำหรับ Blaze นโยบายนี้มีประโยชน์สำหรับภาระงานที่ไม่ใช่แบบอินเทอร์แอกทีฟ แต่ไม่ต้องการลดคุณค่าที่แท้จริง ดู "man 2 sched_setscheduler" หากเป็น "เท็จ" Bazel จะไม่เรียกใช้ระบบ
แท็ก: host_machine_resource_optimizations
ค่าเริ่มต้น --bazelrc=<path>: ดูคำอธิบาย
ตำแหน่งของไฟล์ .bazelrc ของผู้ใช้ที่มีค่าเริ่มต้นของตัวเลือก Bazel /dev/null ระบุว่าระบบจะไม่สนใจ "--bazelrc" ทั้งหมดหลังจากนั้น ซึ่งมีประโยชน์ในการปิดใช้การค้นหาไฟล์ rc ของผู้ใช้ เช่น ในบิลด์ที่เผยแพร่ ตัวเลือกนี้สามารถระบุได้หลายครั้ง เช่น โดย `--bazelrc=x.rc --bazelrc=y.rc --bazelrc=/dev/null --bazelrc=z.rc`, 1) อ่าน x.rc และ y.rc 2) ระบบไม่พิจารณา z.rc เนื่องจาก /dev/null ก่อนหน้านี้ หากไม่ระบุ Bazel จะใช้ไฟล์ .bazelrc ไฟล์แรกที่พบใน 2 ตำแหน่งต่อไปนี้ ได้แก่ ไดเรกทอรีพื้นที่ทำงาน และไดเรกทอรีหลักของผู้ใช้ หมายเหตุ: ตัวเลือกบรรทัดคำสั่งจะมีผลแทนตัวเลือกใดๆ ใน bazelrc เสมอ
แท็ก: changes_inputs
ค่าเริ่มต้น --[no]block_for_lock: "true"
เมื่อ --noblock_for_lock ผ่านแล้ว Bazel จะไม่รอให้คำสั่งที่ทำงานอยู่เสร็จสมบูรณ์ แต่จะออกในทันทีแทน
แท็ก: eagerness_to_exit
ค่าเริ่มต้น --[no]client_debug: "เท็จ"
หากเป็นจริง ให้บันทึกข้อมูลการแก้ไขข้อบกพร่องจากไคลเอ็นต์ไปยัง stderr การเปลี่ยนตัวเลือกนี้จะไม่ทำให้เซิร์ฟเวอร์ต้องรีสตาร์ท
แท็ก: affects_outputs bazel_monitoring
ค่าเริ่มต้น --connect_timeout_secs=<an integer>: "30"
ระยะเวลาที่ไคลเอ็นต์รอการเชื่อมต่อเซิร์ฟเวอร์ในแต่ละครั้ง
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --digest_function=<hash function>: ดูคำอธิบาย
ฟังก์ชันแฮชที่จะใช้เมื่อคำนวณไดเจสต์ไฟล์
แท็ก: loses_incremental_state bazel_internal_configuration
ค่าเริ่มต้น --[no]expand_configs_in_place: "true"
เปลี่ยนการขยายแฟล็ก --config ที่จะทำในตำแหน่ง ต่างจากการขยายจุดคงที่ระหว่างตัวเลือก rc ปกติและตัวเลือกที่ระบุบรรทัดคำสั่ง
แท็ก: no_op deprecated
ค่าเริ่มต้น --failure_detail_out=<path>: ดูคำอธิบาย
ถ้ามีการตั้งค่า ให้ระบุตำแหน่งที่จะเขียนข้อความ protocolbuf ของการทำงานล้มเหลว หากเซิร์ฟเวอร์ประสบกับความล้มเหลวและไม่สามารถรายงานผ่าน gRPC ได้ตามปกติ ไม่เช่นนั้น สถานที่จะเป็น ${OUTPUT_BASE}/failure_detail.rawprotocol
แท็ก: affects_outputs loses_incremental_state
ค่าเริ่มต้น --[no]home_rc: "true"
ค้นหาไฟล์ bazelrc ของบ้านที่ $HOME/.bazelrc หรือไม่
แท็ก: changes_inputs
ค่าเริ่มต้น --[no]idle_server_tasks: "true"
เรียกใช้ System.gc() เมื่อเซิร์ฟเวอร์ไม่มีการใช้งาน
แท็ก: loses_incremental_state, host_machine_resource_optimizations
ค่าเริ่มต้น --[no]ignore_all_rc_files: "เท็จ"
ปิดใช้ไฟล์ rc ทั้งหมด โดยไม่คำนึงถึงค่าของแฟล็กการแก้ไข rc อื่นๆ แม้ว่าแฟล็กเหล่านี้จะอยู่ภายหลังในรายการตัวเลือกการเริ่มต้นใช้งานก็ตาม
แท็ก: changes_inputs
ค่าเริ่มต้น --io_nice_level={-1,0,1,2,3,4,5,6,7}: "-1"
เฉพาะใน Linux ตั้งระดับตั้งแต่ 0-7 เพื่อการกำหนดเวลา IO ที่ใช้ความพยายามมากที่สุดโดยใช้การเรียกระบบ sys_ioprio_set 0 คือลำดับความสำคัญสูงสุด 7 คือต่ำสุด เครื่องจัดตารางเวลาที่คาดไว้จะใช้ได้ไม่เกิน 4 ลำดับความสำคัญ หากตั้งเป็นค่าลบ Bazel จะไม่เรียกใช้ระบบ
แท็ก: host_machine_resource_optimizations
ค่าเริ่มต้น --local_startup_timeout_secs=<an integer>: "120"
ระยะเวลาสูงสุดที่ไคลเอ็นต์ต้องรอเพื่อเชื่อมต่อกับเซิร์ฟเวอร์
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --macos_qos_class=<a string>: "ค่าเริ่มต้น"
ตั้งค่าคลาสบริการ QoS ของเซิร์ฟเวอร์ bazel เมื่อใช้งานใน macOS แฟล็กนี้ไม่มีผลกับแพลตฟอร์มอื่นๆ ทั้งหมด แต่รองรับเพื่อให้แชร์ไฟล์ rc ระหว่างแพลตฟอร์มได้โดยไม่มีการเปลี่ยนแปลง ค่าที่เป็นไปได้ ได้แก่ โฆษณาแบบอินเทอร์แอกทีฟ ผู้ใช้ที่เริ่มต้นเอง ค่าเริ่มต้น ยูทิลิตี และพื้นหลัง
แท็ก: host_machine_resource_optimizations
ค่าเริ่มต้นของ --max_idle_secs=<integer>: "10800"
จำนวนวินาทีที่เซิร์ฟเวอร์บิลด์จะรอให้ไม่มีการใช้งานก่อนปิดการทำงาน ค่า 0 หมายความว่าเซิร์ฟเวอร์จะไม่ปิดการทำงาน ซึ่งจะอ่านเมื่อเริ่มต้นเซิร์ฟเวอร์เท่านั้น การเปลี่ยนแปลงตัวเลือกนี้จะไม่ทำให้เซิร์ฟเวอร์รีสตาร์ท
แท็ก: eagerness_to_exit loses_incremental_state
ค่าเริ่มต้น --output_base=<path>: ดูคำอธิบาย
หากมีการตั้งค่าแล้ว ให้ระบุตำแหน่งเอาต์พุตที่ระบบจะเขียนเอาต์พุตของบิลด์ทั้งหมด มิเช่นนั้น สถานที่จะเป็น ${OUTPUT_ROOT}/_blaze_${USER}/${MD5_OF_WORKSPACE_ROOT} หมายเหตุ: หากคุณระบุตัวเลือกที่แตกต่างจากการเรียกใช้ Bazel ถัดไปสำหรับค่านี้ คุณอาจต้องเริ่มต้นเซิร์ฟเวอร์ Bazel ใหม่เพิ่มเติม Bazel เริ่มต้นเพียง 1 เซิร์ฟเวอร์ต่อฐานเอาต์พุตที่ระบุ โดยปกติจะมีฐานเอาต์พุต 1 รายการต่อพื้นที่ทำงาน แต่ด้วยตัวเลือกนี้ คุณอาจมีฐานเอาต์พุตหลายรายการต่อพื้นที่ทำงาน ดังนั้นจึงเรียกใช้บิลด์หลายรายการสำหรับไคลเอ็นต์เดียวกันในเครื่องเดียวกันพร้อมกัน ดู "ปิดตัวช่วยเหลือด้วย Bazel" เกี่ยวกับวิธีปิดเซิร์ฟเวอร์ Bazel
แท็ก: affects_outputs loses_incremental_state
ค่าเริ่มต้น --output_user_root=<path>: ดูคำอธิบาย
ไดเรกทอรีเฉพาะผู้ใช้ด้านล่างที่มีการเขียนเอาต์พุตของบิลด์ทั้งหมด โดยค่าเริ่มต้น นี่เป็นฟังก์ชันของ $USER แต่เมื่อระบุเอาต์พุตของบิลด์แล้ว จะสามารถแชร์เอาต์พุตของบิลด์ระหว่างผู้ใช้ที่ทํางานร่วมกันได้
แท็ก: affects_outputs loses_incremental_state
ค่าเริ่มต้น --[no]preemptible: "เท็จ"
หากเป็น "จริง" คำสั่งนี้อาจถูกขัดจังหวะชั่วคราวหากมีการเริ่มต้นคำสั่งอื่น
แท็ก: eagerness_to_exit
ค่าเริ่มต้น --server_jvm_out=<path>: ดูคำอธิบาย
ตำแหน่งที่จะเขียนเอาต์พุตของ JVM ของเซิร์ฟเวอร์ หากไม่ได้ตั้งค่า จะมีค่าเริ่มต้นเป็นตำแหน่งใน exit_base
แท็ก: affects_outputs loses_incremental_state
ค่าเริ่มต้น --[no]shutdown_on_low_sys_mem: "เท็จ"
หากตั้งค่า max_idle_secs และเซิร์ฟเวอร์บิลด์ไม่มีการใช้งานเป็นระยะเวลาหนึ่ง ให้ปิดเซิร์ฟเวอร์เมื่อระบบเหลือ RAM ต่ำ Linux เท่านั้น
แท็ก: eagerness_to_exit loses_incremental_state
ค่าเริ่มต้น --[no]system_rc: "true"
ต้องการมองหา bazelrc ทั้งระบบหรือไม่
แท็ก: changes_inputs
ค่าเริ่มต้น --[no]unlimit_coredumps: "เท็จ"
เพิ่มขีดจำกัด Soft Coredump ให้ถึงขีดจำกัดแบบฮาร์ดคอร์เพื่อสร้าง Coredump ของเซิร์ฟเวอร์ (รวมถึง JVM) และไคลเอ็นต์เป็นไปได้ภายใต้เงื่อนไขทั่วไป ติด Flag นี้ไว้ใน bazelrc 1 ครั้ง แล้วลืมติดแฟล็กนั้น เพื่อให้คุณได้รับ Coredumps เมื่อพบเงื่อนไขที่ทริกเกอร์ Coredump จริงๆ
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --[no]watchfs: "เท็จ"
หากเป็น "จริง" bazel จะพยายามใช้บริการดูไฟล์ของระบบปฏิบัติการสำหรับการเปลี่ยนแปลงในเครื่องแทนการสแกนทุกไฟล์เพื่อหาการเปลี่ยนแปลง
แท็ก: deprecated
หากจริง ระบบจะสร้างลิงก์สัญลักษณ์จริงบน Windows แทนการคัดลอกไฟล์ ต้องเปิดใช้โหมดนักพัฒนาซอฟต์แวร์ Windows และ Windows 10 เวอร์ชัน 1703 ขึ้นไป
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --[no]workspace_rc: "true"
มองหาไฟล์ Workspace bazelrc ที่ $workspace/.bazelrc หรือไม่
แท็ก: changes_inputs
ตัวเลือกเบ็ดเตล็ด ที่จัดหมวดหมู่ไว้ไม่ได้:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --host_jvm_args=<jvm_arg> รายการ
แฟล็กที่จะส่งไปยัง Blaze ที่เรียกใช้ JVM
--host_jvm_debug
ตัวเลือกความสะดวกในการเพิ่ม Flag การเริ่มต้นของ JVM เพิ่มเติม ซึ่งจะทำให้ JVM ต้องรอในระหว่างการเริ่มต้นจนกว่าคุณจะเชื่อมต่อจากโปรแกรมแก้ไขข้อบกพร่องที่สอดคล้องกับ JDWP (เช่น Eclipse) ไปยังพอร์ต 5005
ขยายเป็น

--host_jvm_args=-Xdebug --host_jvm_args=-Xrunjdwp:transport=dt_socket,server=y,address=5005
ค่าเริ่มต้นของ --host_jvm_profile=<profiler_name>: ""
ตัวเลือกความสะดวกในการเพิ่ม Flag การเริ่มต้น JVM เฉพาะสำหรับเครื่องมือสร้างโปรไฟล์/โปรแกรมแก้ไขข้อบกพร่อง Bazel มีรายการค่าที่รู้จักซึ่งแมปกับแฟล็กการเริ่มต้น JVM แบบฮาร์ดโค้ด ซึ่งอาจค้นหาเส้นทางแบบฮาร์ดโค้ดสำหรับไฟล์บางไฟล์
ค่าเริ่มต้นของ --server_javabase=<jvm path>: ""
เส้นทางไปยัง JVM ที่ใช้เพื่อดำเนินการ Bazel เอง

ตัวเลือกเหมือนกับคำสั่งทั้งหมด

ตัวเลือกที่ควบคุมการดำเนินการของบิลด์:
ค่าเริ่มต้นของ --experimental_ui_max_stdouterr_bytes=<an integer in (-1)-1073741819 range>: "1048576"
ขนาดสูงสุดของไฟล์ stdout / stderr ที่จะพิมพ์ลงในคอนโซล -1 หมายถึงไม่จำกัด
แท็ก: execution
หากตั้งค่าเป็น "จริง" ลิงก์สัญลักษณ์ที่อัปโหลดไปยังแคชระยะไกลหรือดิสก์แคชจะได้รับอนุญาตให้ห้อยคอได้
แท็ก: execution incompatible_change
หากตั้งค่าเป็น "จริง" Bazel จะอัปโหลดลิงก์สัญลักษณ์ไปยังรีโมตหรือดิสก์แคชเสมอ มิฉะนั้นระบบจะอัปโหลดลิงก์สัญลักษณ์ที่เกี่ยวข้องที่ไม่ก่อให้เกิดอันตรายเป็นไฟล์หรือไดเรกทอรีที่ลิงก์ไป
แท็ก: execution incompatible_change
ตัวเลือกที่กำหนดค่า Toolchain
ที่ใช้สำหรับการดำเนินการมีดังนี้
ค่าเริ่มต้น --[no]incompatible_enable_proto_toolchain_resolution: "เท็จ"
หากเป็น "จริง" กฎ Pro lang จะกำหนด Toolchain จากที่เก็บ rules_protocol, rules_java, rules_cc
แท็ก: loading_and_analysis incompatible_change
ตัวเลือกที่ให้ผู้ใช้กำหนดค่า
เอาต์พุตที่ต้องการ ซึ่งส่งผลต่อค่าของผลลัพธ์ ไม่ใช่ค่าที่มีอยู่
ค่าเริ่มต้น --bep_maximum_open_remote_upload_files=<an integer>: "-1"
จำนวนไฟล์เปิดสูงสุดที่อนุญาตระหว่างการอัปโหลดอาร์ติแฟกต์ BEP
แท็ก: affects_outputs
--remote_download_all
ดาวน์โหลดเอาต์พุตระยะไกลทั้งหมดไปยังเครื่องภายใน แฟล็กนี้เป็นชื่อแทนของ --remote_download_outputs=all
ขยายเป็น

--remote_download_outputs=all
แท็ก: affects_outputs
--remote_download_minimal
ไม่ดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลไปยังเครื่องภายใน แฟล็กนี้เป็นชื่อแทนของ --remote_download_outputs=minimal
ขยายเป็น

--remote_download_outputs=minimal
แท็ก: affects_outputs
ค่าเริ่มต้น --remote_download_outputs=<all, minimal or toplevel>: "ระดับบนสุด"
หากตั้งค่าเป็น "ขั้นต่ำ" จะไม่ดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลไปยังเครื่องภายใน ยกเว้นเอาต์พุตที่การดำเนินการในเครื่องจำเป็นต้องใช้ หากตั้งค่าเป็น "ระดับบนสุด" แสดงตัวเหมือน "น้อยมาก" เว้นแต่ว่าจะดาวน์โหลดเอาต์พุตของเป้าหมายระดับบนสุดไปยังเครื่องภายในด้วย ตัวเลือกทั้ง 2 รายการจะช่วยลดเวลาบิลด์ได้อย่างมากหากแบนด์วิดท์ของเครือข่ายเป็นจุดคอขวด
แท็ก: affects_outputs
สร้างลิงก์สัญลักษณ์แทนการดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลไปยังเครื่องภายใน ระบุเป้าหมายของลิงก์สัญลักษณ์ในรูปแบบสตริงเทมเพลตได้ สตริงเทมเพลตนี้อาจมี {hash} และ {size_bytes} ที่ขยายเป็นแฮชของออบเจ็กต์และขนาดเป็นไบต์ตามลำดับ เช่น ลิงก์สัญลักษณ์เหล่านี้อาจชี้ไปยังระบบไฟล์ FUSE ที่โหลดออบเจ็กต์จาก CAS ตามคำขอ
แท็ก: affects_outputs
--remote_download_toplevel
ดาวน์โหลดเฉพาะเอาต์พุตระยะไกลของเป้าหมายระดับบนสุดไปยังเครื่องภายในเท่านั้น แฟล็กนี้เป็นชื่อแทนของ --remote_download_outputs=toplevel
ขยายเป็น

--remote_download_outputs=toplevel
แท็ก: affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --repo_env=<a 'name=value' assignment with an optional value part> รายการ
ระบุตัวแปรสภาพแวดล้อมเพิ่มเติมเพื่อให้ใช้ได้กับกฎที่เก็บเท่านั้น โปรดทราบว่ากฎที่เก็บจะดูสภาพแวดล้อมแบบเต็มได้ แต่ด้วยวิธีนี้ระบบจะส่งข้อมูลการกำหนดค่าไปยังที่เก็บผ่านตัวเลือกต่างๆ ได้โดยที่กราฟการดำเนินการจะไม่ถูกต้อง
แท็ก: action_command_lines
ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตบิลด์ที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมธง ฯลฯ)
ค่าเริ่มต้น --[no]check_bzl_visibility: "true"
หากปิดใช้ ระบบจะลดระดับข้อผิดพลาดในการแสดงการโหลด .bzl ให้มีคำเตือน
แท็ก: build_file_semantics
ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
ค่าเริ่มต้น --[no]enable_bzlmod: "true"
หากเป็น "จริง" จะเปิดใช้ระบบการจัดการทรัพยากร Dependency ของ Bzlmod โดยมีผลเหนือกว่า WORKSPACE ดูข้อมูลเพิ่มเติมได้ที่ https://bazel.build/docs/bzlmod
แท็ก: loading_and_analysis
ค่าเริ่มต้น --[no]enable_workspace: "true"
หากเป็น "จริง" จะเปิดใช้ระบบ WORKSPACE เดิมสำหรับทรัพยากร Dependency ภายนอก ดูข้อมูลเพิ่มเติมได้ที่ https://bazel.build/external/overview
แท็ก: loading_and_analysis
ค่าเริ่มต้น --[no]experimental_action_resource_set: "true"
หากตั้งค่าเป็น "จริง" ctx.actions.run() และ ctx.actions.run_shell() จะยอมรับพารามิเตอร์ resource_set สำหรับการดำเนินการในเครื่อง มิเช่นนั้น หน่วยความจำจะเริ่มต้นที่ 250 MB สำหรับหน่วยความจำและ 1 CPU
แท็ก: execution, build_file_semantics, experimental
ค่าเริ่มต้น --[no]experimental_bzl_visibility: "true"
หากเปิดใช้ ให้เพิ่มฟังก์ชัน "visibility()" ที่ไฟล์ .bzl อาจเรียกใช้ในระหว่างการประเมินระดับบนสุดเพื่อตั้งค่าการแสดงผลไว้ตามวัตถุประสงค์ของคำสั่ง remove()
แท็ก: loading_and_analysis experimental
ค่าเริ่มต้น --[no]experimental_cc_shared_library: "เท็จ"
หากตั้งค่าเป็น "จริง" แอตทริบิวต์กฎและเมธอด Starlark API ที่จำเป็นสำหรับกฎ cc_shared_library จะพร้อมใช้งาน
แท็ก: build_file_semantics, loading_and_analysis, experimental
ค่าเริ่มต้น --[no]experimental_disable_external_package: "เท็จ"
หากตั้งค่าเป็น "จริง" แพ็กเกจ //ภายนอกที่สร้างขึ้นโดยอัตโนมัติจะใช้งานไม่ได้อีกต่อไป Bazel จะยังคงแยกวิเคราะห์ไฟล์ "external/BUILD" ไม่ได้ แต่ globs ที่เข้าถึงภายนอก/ จากแพ็กเกจที่ไม่มีชื่อจะใช้งานได้
แท็ก: loading_and_analysis, loses_incremental_state, experimental
ค่าเริ่มต้น --[no]experimental_enable_android_migration_apis: "เท็จ"
หากตั้งค่าเป็น "จริง" จะเปิดใช้ API ที่ต้องใช้เพื่อรองรับการย้ายข้อมูลของ Android Starlark
แท็ก: build_file_semantics
ค่าเริ่มต้น --[no]experimental_enable_scl_dialect: "เท็จ"
หากตั้งค่าเป็น "จริง" อาจใช้ไฟล์ .scl ในคำสั่ง request() ได้
แท็ก: build_file_semantics
ค่าเริ่มต้น --[no]experimental_google_legacy_api: "เท็จ"
หากตั้งค่าเป็น "จริง" จะแสดงส่วนทดลองของ Starlark Build API ที่เกี่ยวข้องกับโค้ดเดิมของ Google
แท็ก: loading_and_analysis experimental
ค่าเริ่มต้น --[no]experimental_isolated_extension_usages: "เท็จ"
หากเป็นจริง จะเปิดใช้ <code>ISOlate</code> ใน <a href="https://bazel.build/rules/lib/globals/module#use_extension"><code>use_extension</code></a>
แท็ก: loading_and_analysis
ค่าเริ่มต้น --[no]experimental_java_library_export: "เท็จ"
หากเปิดใช้ โมดูล Experiment_java_library_export_do_not_use จะพร้อมใช้งาน
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --[no]experimental_platforms_api: "เท็จ"
หากตั้งค่าเป็น "จริง" จะเปิดใช้ Starlark API ที่เกี่ยวข้องกับแพลตฟอร์มจำนวนหนึ่งซึ่งมีประโยชน์สำหรับการแก้ไขข้อบกพร่อง
แท็ก: loading_and_analysis experimental
ค่าเริ่มต้น --[no]experimental_repo_remote_exec: "เท็จ"
หากตั้งค่าเป็น "จริง" Reposit_rule จะมีความสามารถในการดำเนินการระยะไกลบางรายการ
แท็ก: build_file_semantics, loading_and_analysis, experimental
ค่าเริ่มต้น --[no]experimental_sibling_repository_layout: "เท็จ"
หากตั้งค่าเป็น "จริง" ระบบจะสร้างที่เก็บที่ไม่ใช่หลักเป็นลิงก์สัญลักษณ์ไปยังที่เก็บหลักในรูทการดำเนินการ กล่าวคือ ที่เก็บทั้งหมดจะเป็นรายการย่อยโดยตรงของไดเรกทอรี $output_base/execution_root การดำเนินการนี้มีผลข้างเคียงจากการเพิ่มพื้นที่ว่าง $output_base/execution_root/__main__/external สำหรับ "ภายนอก" ระดับบนสุดจริง ไดเรกทอรี
แท็ก: action_command_lines, bazel_internal_configuration, loading_and_analysis, loses_incremental_state, experimental
ค่าเริ่มต้น --[no]incompatible_allow_tags_propagation: "true"
หากตั้งค่าเป็น "จริง" แท็กจะส่งผ่านจากเป้าหมายไปยังการดำเนินการ ข้อกำหนดในการดำเนินการ มิฉะนั้นแท็กจะไม่ถูกเผยแพร่ ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/8830
แท็ก: build_file_semantics experimental
ค่าเริ่มต้น --[no]incompatible_always_check_depset_elements: "true"
ตรวจสอบความถูกต้องขององค์ประกอบที่เพิ่มลงในชุดย่อยในตัวสร้างทั้งหมด องค์ประกอบต้องเปลี่ยนแปลงไม่ได้ แต่ที่ผ่านมาเครื่องมือสร้าง depset(direct=...) ลืมตรวจสอบ ใช้ Tuples แทนรายการในองค์ประกอบ Depset ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/10313
แท็ก: build_file_semantics incompatible_change
ค่าเริ่มต้น --[no]incompatible_depset_for_java_output_source_jars: "true"
เมื่อเป็นจริง Bazel จะไม่แสดงรายการจาก java_info.java_output[0].source_jars อีกต่อไป แต่แสดงผล depset แทน
แท็ก: loading_and_analysis incompatible_change
เมื่อเป็น "จริง" Bazel จะไม่แสดงรายการจาก linked_context.libraries_to_link อีกต่อไป แต่จะแสดงผลการตั้งค่าแทน
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --[no]incompatible_disable_objc_library_transition: "true"
ปิดใช้การเปลี่ยนที่กำหนดเองของ objc_library และรับค่าจากเป้าหมายระดับบนสุดแทน
แท็ก: build_file_semantics, incompatible_change
ค่าเริ่มต้น --[no]incompatible_disable_starlark_host_transitions: "เท็จ"
หากตั้งค่าเป็น "จริง" แอตทริบิวต์กฎจะตั้งค่า 'cfg = "host"' ไม่ได้ กฎควรตั้งค่า 'cfg = "exec"' แทน
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --[no]incompatible_disable_target_provider_fields: "เท็จ"
หากตั้งค่าเป็น "จริง" ให้ปิดความสามารถในการเข้าถึงผู้ให้บริการใน "เป้าหมาย" ผ่านไวยากรณ์ฟิลด์ ใช้ไวยากรณ์คีย์ผู้ให้บริการแทน เช่น แทนที่จะใช้ "ctx.attr.dep.my_info" เพื่อเข้าถึง "my_info" จากภายในฟังก์ชันการใช้งานกฎ ให้ใช้ "ctx.attr.dep[MyInfo]" แทน ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/9014
แท็ก: build_file_semantics incompatible_change
ค่าเริ่มต้น --[no]incompatible_disallow_empty_glob: "เท็จ"
หากตั้งค่าเป็น "จริง" ค่าเริ่มต้นของอาร์กิวเมนต์ `allow_empty` ของ glob() จะเป็น False
แท็ก: build_file_semantics incompatible_change
ค่าเริ่มต้น --[no]incompatible_disallow_struct_provider_syntax: "เท็จ"
หากตั้งค่าเป็น "จริง" ฟังก์ชันการใช้งานกฎอาจไม่แสดงโครงสร้าง โดยจะต้องแสดงผลรายการอินสแตนซ์ของผู้ให้บริการแทน
แท็ก: build_file_semantics incompatible_change
ค่าเริ่มต้น --[no]incompatible_enable_deprecated_label_apis: "true"
หากเปิดใช้ คุณจะสามารถใช้ API ที่เลิกใช้งานแล้วบางรายการ (native.repository_name, Label.workspace_name, Label.relative)
แท็ก: loading_and_analysis
ค่าเริ่มต้น --[no]incompatible_existing_rules_immutable_view: "true"
หากตั้งค่าเป็น "จริง" Native.existing_rule และnative.existing_rules จะแสดงออบเจ็กต์มุมมองที่เปลี่ยนแปลงไม่ได้ขนาดเล็กแทนคำสั่งที่เปลี่ยนแปลงได้
แท็ก: build_file_semantics, loading_and_analysis, incompatible_change
ค่าเริ่มต้น --[no]incompatible_fail_on_unknown_attributes: "true"
หากเปิดใช้ เป้าหมายที่มีแอตทริบิวต์ที่ไม่รู้จักซึ่งตั้งค่าเป็น "ไม่มี" จะล้มเหลว
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --[no]incompatible_fix_package_group_reporoot_syntax: "true"
ในแอตทริบิวต์ "packages" ของPackage_group ให้เปลี่ยนความหมายของค่า "//..." เพื่ออ้างถึงแพ็กเกจทั้งหมดในที่เก็บปัจจุบัน แทนที่จะเป็นแพ็กเกจทั้งหมดในที่เก็บใดๆ คุณสามารถใช้ค่าพิเศษ "สาธารณะ" แทน "//..." เพื่อรับลักษณะการทำงานเดิม ธงนี้กำหนดให้ต้องเปิดใช้งาน --incompatible_package_group_has_public_syntax ด้วย
แท็ก: build_file_semantics incompatible_change
ค่าเริ่มต้น --[no]incompatible_java_common_parameters: "true"
หากตั้งค่าเป็น "จริง" พารามิเตอร์เอาต์พุต_jar และ host_javabase ใน pack_sources และ host_javabase ในคอมไพล์จะถูกนำออกทั้งหมด
แท็ก: build_file_semantics incompatible_change
ค่าเริ่มต้น --[no]incompatible_merge_fixed_and_default_shell_env: "true"
หากเปิดใช้ การดำเนินการที่ลงทะเบียนด้วย ctx.actions.run และ ctx.actions.run_shell ด้วย 'env' เอาไว้ และ 'use_default_shell_env = จริง' ที่ระบุจะใช้สภาพแวดล้อมที่ได้รับจากสภาพแวดล้อมของ Shell เริ่มต้นโดยการลบล้างค่าที่ส่งไปยัง "env" หากปิดใช้ ค่าของ "env" จะไม่มีผลใดๆ ในกรณีนี้
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --[no]incompatible_new_actions_api: "true"
หากตั้งค่าเป็น "จริง" API เพื่อสร้างการดำเนินการจะพร้อมใช้งานใน "ctx.actions" เท่านั้น ไม่ใช่ใน "ctx"
แท็ก: build_file_semantics, incompatible_change
ค่าเริ่มต้น --[no]incompatible_no_attr_license: "true"
หากตั้งค่าเป็น "จริง" จะเป็นการปิดใช้ฟังก์ชัน "attr.license"
แท็ก: build_file_semantics, incompatible_change
ค่าเริ่มต้น --[no]incompatible_no_implicit_file_export: "เท็จ"
หากตั้งค่าไว้ ไฟล์ต้นฉบับ (ที่ใช้แล้ว) จะเป็นแพ็กเกจส่วนตัวเว้นแต่จะมีการส่งออกอย่างชัดเจน ดู https://github.com/bazelbuild/proposals/blob/master/designs/2019-10-24-file-visibility.md
แท็ก: build_file_semantics incompatible_change
ค่าเริ่มต้น --[no]incompatible_no_rule_outputs_param: "เท็จ"
หากตั้งค่าเป็น "จริง" จะปิดใช้พารามิเตอร์ "เอาต์พุต" ของฟังก์ชัน "rule()" Starlark
แท็ก: build_file_semantics incompatible_change
ค่าเริ่มต้น --[no]incompatible_objc_provider_remove_linking_info: "เท็จ"
หากตั้งค่าเป็น "จริง" ระบบจะนำ API ของ ObjcProvider สำหรับข้อมูลการลิงก์ออก
แท็ก: build_file_semantics incompatible_change
ค่าเริ่มต้น --[no]incompatible_package_group_has_public_syntax: "true"
ในแอตทริบิวต์ "packages" ของแพ็กเกจ [package_group] อนุญาตให้เขียน "สาธารณะ" หรือ "ส่วนตัว" อ้างอิงถึงแพ็กเกจทั้งหมดหรือไม่มีแพ็กเกจตามลำดับ
แท็ก: build_file_semantics incompatible_change
ค่าเริ่มต้น --[no]incompatible_require_linker_input_cc_api: "true"
หากตั้งค่าเป็น "จริง" กฎ create_linking_context จะต้องใช้ linker_inputs แทน library_to_link ระบบจะปิดเครื่องมือดึงข้อมูลเก่าของ linker_context ด้วย แล้วระบบก็จะมีเพียง linker_inputs เท่านั้นที่ใช้ได้
แท็ก: build_file_semantics, loading_and_analysis, incompatible_change
ค่าเริ่มต้น --[no]incompatible_run_shell_command_string: "true"
หากตั้งค่าเป็น "จริง" พารามิเตอร์คำสั่งของ actions.run_shell จะยอมรับเฉพาะสตริงเท่านั้น
แท็ก: build_file_semantics, incompatible_change
ค่าเริ่มต้น --[no]incompatible_stop_exporting_language_modules: "เท็จ"
หากเปิดใช้ โมดูลเฉพาะภาษาบางโมดูล (เช่น "cc_common") จะไม่พร้อมใช้งานในไฟล์ .bzl ของผู้ใช้ และอาจเรียกใช้จากที่เก็บกฎที่เกี่ยวข้องเท่านั้น
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --[no]incompatible_struct_has_no_methods: "เท็จ"
ปิดใช้เมธอด to_json และ to_เลือก ของโครงสร้าง ซึ่งทำให้เนมสเปซของช่อง Struct เสีย โปรดใช้ json.encode หรือ json.encode_indent สำหรับ JSON หรือใช้ protocol.encode_text สําหรับ textprotocol แทน
แท็ก: build_file_semantics incompatible_change
ค่าเริ่มต้น --[no]incompatible_top_level_aspects_require_providers: "เท็จ"
หากตั้งค่าเป็น "จริง" การแสดงผลระดับบนสุดจะยึดตามผู้ให้บริการที่จำเป็นและจะทำงานในเป้าหมายระดับบนสุดที่มีกฎเท่านั้น ผู้ให้บริการที่โฆษณาตรงตามผู้ให้บริการในด้านดังกล่าว
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --[no]incompatible_unambiguous_label_stringification: "true"
เมื่อเป็นจริง Bazel จะเพิ่มป้ายกำกับ @//foo:bar เป็น @//foo:bar แทน //foo:bar การเลือกนี้จะส่งผลต่อลักษณะการทำงานของ str(), โอเปอเรเตอร์ % และอื่นๆ เท่านั้น ลักษณะการทำงานของ repr() จะไม่มีการเปลี่ยนแปลง ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/15916
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --[no]incompatible_use_cc_configure_from_rules_cc: "เท็จ"
เมื่อเป็นจริง Bazel จะไม่อนุญาตให้ใช้ cc_configure จาก @bazel_tools อีกต่อไป โปรดดูรายละเอียดและวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/10134
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --[no]incompatible_visibility_private_attributes_at_definition: "true"
หากตั้งค่าเป็น "จริง" ระบบจะตรวจสอบระดับการเข้าถึงของแอตทริบิวต์กฎส่วนตัวตามคำจำกัดความของกฎ โดยกลับไปใช้กฎหากไม่มองเห็นได้
แท็ก: build_file_semantics incompatible_change
ค่าเริ่มต้น --max_computation_steps=<a long integer>: "0"
จำนวนขั้นตอนการคำนวณของ Starlark สูงสุดที่ไฟล์ BUILD อาจดำเนินการ (0 หมายถึงไม่มีขีดจำกัด)
แท็ก: build_file_semantics
ค่าเริ่มต้น --nested_set_depth_limit=<an integer>: "3500"
ความลึกสูงสุดของกราฟภายในจนถึง Depset (หรือที่เรียกว่า NestedSet) ซึ่งตัวสร้าง depset() จะล้มเหลว
แท็ก: loading_and_analysis
ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพเวลาของบิลด์
ค่าเริ่มต้น --[no]heuristically_drop_nodes: "เท็จ"
หากเป็น "จริง" Blaze จะนำโหนด FileState และ DirectoryListingState ออกหลังจากที่โหนด File และ DirectoryListing ที่เกี่ยวข้องเสร็จสิ้นเพื่อประหยัดหน่วยความจำ เราคาดว่าโอกาสที่จะต้องใช้โหนดเหล่านี้อีกน้อยลง หากเป็นเช่นนั้น โปรแกรมจะทำการประเมินอีกครั้ง
แท็ก: loses_incremental_state
ค่าเริ่มต้น --[no]incompatible_do_not_split_linking_cmdline: "true"
เมื่อเป็นจริง Bazel จะไม่แก้ไขแฟล็กบรรทัดคำสั่งที่ใช้ในการลิงก์อีกต่อไป และจะไม่เลือกว่าแฟล็กใดจะส่งไปยังไฟล์พารามิเตอร์และจะไม่ใช้ ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7670
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --[no]keep_state_after_build: "true"
หากเป็น "เท็จ" Blaze จะทิ้งสถานะ Inmemory จากบิลด์นี้เมื่อบิลด์เสร็จสมบูรณ์ การสร้างครั้งต่อๆ ไปจะไม่มีส่วนเพิ่มที่เกี่ยวข้องกับเวอร์ชันนี้
แท็ก: loses_incremental_state
ค่าเริ่มต้น --[no]track_incremental_state: "true"
หากเป็น "เท็จ" Blaze จะไม่เก็บข้อมูลที่ทำให้ใช้งานไม่ได้และมีการประเมินซ้ำในบิลด์ที่เพิ่มขึ้นเพื่อประหยัดหน่วยความจำในบิลด์นี้ การสร้างครั้งต่อๆ ไปจะไม่มีส่วนเพิ่มที่เกี่ยวข้องกับเวอร์ชันนี้ โดยปกติแล้วคุณจะต้องระบุ --batch เมื่อตั้งค่าเป็น false
แท็ก: loses_incremental_state
ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
ค่าเริ่มต้น --[no]announce_rc: "เท็จ"
เลือกว่าจะประกาศตัวเลือก rc หรือไม่
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]attempt_to_print_relative_paths: "เท็จ"
เมื่อพิมพ์ส่วนที่เป็นตำแหน่งของข้อความ ให้พยายามใช้เส้นทางที่สัมพันธ์กับไดเรกทอรีของพื้นที่ทำงานหรือหนึ่งในไดเรกทอรีที่ระบุโดย --package_path
แท็ก: terminal_output
ค่าเริ่มต้นของ --bes_backend=<a string>: ""
ระบุปลายทางแบ็กเอนด์ของบริการบิลด์ (BES) ในรูปแบบ [SCHEME://]HOST[:PORT] ค่าเริ่มต้นคือปิดใช้งานการอัปโหลด BES รูปแบบที่รองรับคือ grpc และ grpcs (grpc ที่เปิดใช้ TLS) หากไม่ได้ระบุรูปแบบไว้ Bazel จะถือว่า grpcs
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]bes_check_preceding_lifecycle_events: "เท็จ"
ตั้งค่าช่อง check_preceding_lifecycle_events_present ใน PublishBuildToolEventStreamRequest ซึ่งจะบอกให้ BES ตรวจสอบว่าก่อนหน้านี้ได้รับเหตุการณ์ InvocationAttemptStarted และ BuildEnqueued ที่ตรงกับเหตุการณ์เครื่องมือปัจจุบันหรือไม่
แท็ก: affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --bes_header=<a 'name=value' assignment> รายการ
ระบุส่วนหัวในแบบฟอร์ม NAME=VALUE ที่จะรวมอยู่ในคำขอ BES สามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
แท็ก: affects_outputs
ค่าเริ่มต้น --bes_instance_name=<a string>: ดูคำอธิบาย
ระบุชื่ออินสแตนซ์ที่ BES จะคง BEP ที่อัปโหลดไว้ ค่าเริ่มต้นคือ Null
แท็ก: affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --bes_keywords=<comma-separated list of options> รายการ
ระบุรายการคีย์เวิร์ดสำหรับการแจ้งเตือนเพื่อเพิ่มชุดคีย์เวิร์ดเริ่มต้นที่เผยแพร่ใน BES ("command_name=<command_name> ", "protocol_name=BEP") ค่าเริ่มต้นคือไม่มี
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]bes_lifecycle_events: "true"
ระบุว่าจะเผยแพร่เหตุการณ์ในวงจรของ BES หรือไม่ (มีค่าเริ่มต้นเป็น "จริง")
แท็ก: affects_outputs
ค่าเริ่มต้นของ --bes_oom_finish_upload_timeout=<An immutable length of time.>: "10m"
ระบุระยะเวลาที่ควรรอให้การอัปโหลด BES/BEP เสร็จสมบูรณ์ขณะทำ OOMing แฟล็กนี้ทำให้แน่ใจได้ถึงการสิ้นสุดเมื่อ JVM เกิดการขว้าง GC อย่างรุนแรง และไม่สามารถดำเนินการต่างๆ ในเทรดผู้ใช้ใดๆ ได้
แท็ก: bazel_monitoring
ค่าเริ่มต้นของ --bes_outerr_buffer_size=<an integer>: "10240"
ระบุขนาดสูงสุดของ Stdout หรือ stderr ที่จะบัฟเฟอร์ใน BEP ก่อนที่จะรายงานเป็นเหตุการณ์ความคืบหน้า การเขียนแต่ละรายการจะยังคงได้รับการรายงานในเหตุการณ์เดียว แม้ว่าจะมากกว่าค่าที่ระบุสูงสุดถึง --bes_outerr_chunk_size ก็ตาม
แท็ก: affects_outputs
ค่าเริ่มต้นของ --bes_outerr_chunk_size=<an integer>: "1048576"
ระบุขนาดสูงสุดของ stdout หรือ stderr ที่จะส่งไปยัง BEP ในข้อความเดียว
แท็ก: affects_outputs
ค่าเริ่มต้น --bes_proxy=<a string>: ดูคำอธิบาย
เชื่อมต่อบริการ Build Event ผ่านพร็อกซี ปัจจุบัน Flag นี้สามารถใช้เพื่อกำหนดค่า Socket ของโดเมน Unix (unix:/path/to/socket) เท่านั้น
ค่าเริ่มต้นของ --bes_results_url=<a string>: ""
ระบุ URL พื้นฐานที่ผู้ใช้สามารถดูข้อมูลที่สตรีมไปยังแบ็กเอนด์ BES Bazel จะแสดง URL ต่อท้ายด้วยรหัสการเรียกใช้ไปยังเทอร์มินัล
แท็ก: terminal_output
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --bes_system_keywords=<comma-separated list of options> รายการ
ระบุรายการคีย์เวิร์ดสำหรับการแจ้งเตือนที่จะรวมโดยตรง โดยไม่มี "user_keyword=" ใส่คำนำหน้าสำหรับคีย์เวิร์ดที่มาจาก --bes_keywords ใช้สำหรับโอเปอเรเตอร์บริการ Build ที่กำหนด --bes_lifecycle_events=false และรวมคีย์เวิร์ดเมื่อเรียกใช้ PublishLifecycleEvent สร้างโอเปอเรเตอร์บริการที่ใช้ Flag นี้ควรป้องกันไม่ให้ผู้ใช้ลบล้างค่าแฟล็ก
แท็ก: affects_outputs
ค่าเริ่มต้น --bes_timeout=<An immutable length of time.>: "0s"
ระบุระยะเวลาที่ควรรอให้การอัปโหลด BES/BEP เสร็จสมบูรณ์หลังจากการสร้างและการทดสอบเสร็จสิ้น ระยะหมดเวลาที่ถูกต้องคือจำนวนปกติที่ตามด้วยหน่วย: วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) ค่าเริ่มต้นคือ "0" หมายความว่าไม่มีระยะหมดเวลา
แท็ก: affects_outputs
ค่าเริ่มต้นของ --bes_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>: "wait_for_upload_complete"
ระบุว่าการอัปโหลดบริการ Build Event ควรบล็อกการดำเนินการบิลด์เสร็จสมบูรณ์ หรือควรสิ้นสุดการเรียกใช้ทันทีและอัปโหลดอยู่เบื้องหลังให้เสร็จสิ้น หรือ "wait_for_upload_complete" (ค่าเริ่มต้น), "nowait_for_upload_complete" หรือ "Fully_async"
แท็ก: eagerness_to_exit
ค่าเริ่มต้นของ --build_event_binary_file=<a string>: ""
หากไม่ว่างเปล่า ให้เขียนการนำเสนอโปรโตคอลเหตุการณ์บิลด์ที่คั่นด้วย varint ไปยังไฟล์นั้น ตัวเลือกนี้หมายถึง --bes_upload_mode=wait_for_upload_complete
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]build_event_binary_file_path_conversion: "true"
แปลงเส้นทางในการนำเสนอไฟล์ไบนารีของโปรโตคอลกิจกรรมบิลด์เป็น URI ที่ใช้ได้ทั่วโลกมากขึ้นเมื่อเป็นไปได้ หากปิดใช้ ระบบจะใช้รูปแบบ file:// uri เสมอ
แท็ก: affects_outputs
ค่าเริ่มต้นของ --build_event_binary_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>: "wait_for_upload_complete"
ระบุว่าการอัปโหลดบริการเหตุการณ์ของบิลด์สำหรับ --build_event_binary_file ควรบล็อกการสร้างเสร็จสมบูรณ์หรือควรสิ้นสุดการเรียกใช้ทันที แล้วอัปโหลดในเบื้องหลังให้เสร็จสิ้น หรือ "wait_for_upload_complete" (ค่าเริ่มต้น), "nowait_for_upload_complete" หรือ "Fully_async"
แท็ก: eagerness_to_exit
ค่าเริ่มต้นของ --build_event_json_file=<a string>: ""
หากไม่ว่างเปล่า ให้เขียนการเรียงลำดับ JSON ของโปรโตคอลเหตุการณ์บิลด์ไปยังไฟล์นั้น ตัวเลือกนี้หมายถึง --bes_upload_mode=wait_for_upload_complete
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]build_event_json_file_path_conversion: "true"
แปลงเส้นทางในไฟล์ JSON ของโปรโตคอลเหตุการณ์บิลด์ให้เป็น URI ที่ถูกต้องทั่วโลกมากขึ้นเมื่อเป็นไปได้ หากปิดใช้ ระบบจะใช้รูปแบบ file:// uri เสมอ
แท็ก: affects_outputs
ค่าเริ่มต้นของ --build_event_json_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>: "wait_for_upload_complete"
ระบุว่าการอัปโหลดบริการ Build Event สำหรับ --build_event_json_file ควรบล็อกการสร้างเสร็จสมบูรณ์หรือควรสิ้นสุดการเรียกใช้ทันที และอัปโหลดในเบื้องหลังให้เสร็จสิ้น หรือ "wait_for_upload_complete" (ค่าเริ่มต้น), "nowait_for_upload_complete" หรือ "Fully_async"
แท็ก: eagerness_to_exit
ค่าเริ่มต้น --build_event_max_named_set_of_file_entries=<an integer>: "-1"
จํานวนรายการสูงสุดสําหรับเหตุการณ์เดียวที่ชื่อ_set_of_files ระบบจะไม่สนใจค่าที่น้อยกว่า 2 และไม่มีการแยกเหตุการณ์ ตัวเลือกนี้มีไว้เพื่อจำกัดขนาดเหตุการณ์สูงสุดในโปรโตคอลเหตุการณ์บิลด์ แม้ว่าจะไม่ได้ควบคุมขนาดของเหตุการณ์โดยตรง ขนาดกิจกรรมรวมเป็นฟังก์ชันของโครงสร้างของชุด ตลอดจนความยาวของไฟล์และ URI ซึ่งอาจขึ้นอยู่กับฟังก์ชันแฮช
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]build_event_publish_all_actions: "เท็จ"
ควรเผยแพร่การดำเนินการทั้งหมดไหม
แท็ก: affects_outputs
ค่าเริ่มต้นของ --build_event_text_file=<a string>: ""
หากไม่ว่างเปล่า ให้เขียนการนำเสนอโปรโตคอลเหตุการณ์บิลด์ไปยังไฟล์นั้น
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]build_event_text_file_path_conversion: "true"
แปลงเส้นทางในไฟล์ข้อความของโปรโตคอลเหตุการณ์บิลด์เป็น URI ที่ใช้ได้ทั่วโลกมากขึ้นเมื่อเป็นไปได้ หากปิดใช้ ระบบจะใช้รูปแบบ file:// uri เสมอ
แท็ก: affects_outputs
ค่าเริ่มต้นของ --build_event_text_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>: "wait_for_upload_complete"
ระบุว่าการอัปโหลดบริการ Build Event สำหรับ --build_event_text_file ควรบล็อกการสร้างเสร็จสมบูรณ์หรือควรสิ้นสุดการเรียกใช้ทันที และอัปโหลดในเบื้องหลังให้เสร็จสิ้น หรือ "wait_for_upload_complete" (ค่าเริ่มต้น), "nowait_for_upload_complete" หรือ "Fully_async"
แท็ก: eagerness_to_exit
ค่าเริ่มต้น --[no]experimental_announce_profile_path: "เท็จ"
หากเปิดใช้ ให้เพิ่มเส้นทางโปรไฟล์ JSON ลงในบันทึก
แท็ก: bazel_monitoring
ค่าเริ่มต้น --[no]experimental_bep_target_summary: "เท็จ"
ต้องการเผยแพร่เหตุการณ์ TargetSummary หรือไม่
ค่าเริ่มต้น --[no]experimental_build_event_expand_filesets: "เท็จ"
หากเป็น "จริง" ให้ขยายชุดไฟล์ใน BEP เมื่อนำเสนอไฟล์เอาต์พุต
แท็ก: affects_outputs
หากเป็น "จริง" ให้แปลค่าลิงก์สัญลักษณ์ของ Fileset สัมพัทธ์ทั้งหมดใน BEP เมื่อนำเสนอไฟล์เอาต์พุต ต้องมี --experimental_build_event_expand_filesset
แท็ก: affects_outputs
ค่าเริ่มต้น --experimental_build_event_upload_max_retries=<an integer>: "4"
จำนวนครั้งสูงสุดที่ Bazel ควรลองอัปโหลดเหตุการณ์บิลด์อีกครั้ง
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>: "1s"
เริ่มแรก ความล่าช้าขั้นต่ำสำหรับการลองใหม่แบบ Exponential Backoff เมื่ออัปโหลด BEP ไม่สำเร็จ (เลขชี้กำลัง: 1.6)
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --experimental_build_event_upload_strategy=<a string>: ดูคำอธิบาย
เลือกวิธีอัปโหลดอาร์ติแฟกต์ที่อ้างอิงในโปรโตคอลเหตุการณ์บิลด์
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]experimental_collect_load_average_in_profiler: "true"
หากเปิดใช้ เครื่องมือสร้างโปรไฟล์จะรวบรวมค่าเฉลี่ยการโหลดโดยรวมของระบบ
แท็ก: bazel_monitoring
ค่าเริ่มต้น --[no]experimental_collect_pressure_stall_indicators: "เท็จ"
หากเปิดใช้ เครื่องมือสร้างโปรไฟล์จะรวบรวมข้อมูล PSI ของ Linux
แท็ก: bazel_monitoring
ค่าเริ่มต้น --[no]experimental_collect_resource_estimation: "เท็จ"
หากเปิดใช้ เครื่องมือสร้างโปรไฟล์จะรวบรวมการประมาณการใช้งาน CPU และหน่วยความจำสำหรับการกระทำเกี่ยวกับสถานที่
แท็ก: bazel_monitoring
ค่าเริ่มต้น --[no]experimental_collect_system_network_usage: "เท็จ"
หากเปิดใช้งาน เครื่องมือสร้างโปรไฟล์จะรวบรวมการใช้งานเครือข่ายของระบบ
แท็ก: bazel_monitoring
ค่าเริ่มต้น --[no]experimental_collect_worker_data_in_profiler: "เท็จ"
หากเปิดใช้ เครื่องมือสร้างโปรไฟล์จะรวบรวมข้อมูลทรัพยากรแบบรวมของผู้ปฏิบัติงาน
แท็ก: bazel_monitoring
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --experimental_profile_additional_tasks=<phase, action, action_check, action_lock, action_release, action_update, action_complete, bzlmod, info, create_package, remote_execution, local_execution, scanner, local_parse, upload_time, remote_process_time, remote_queue, remote_setup, fetch, local_process_time, vfs_stat, vfs_dir, vfs_readlink, vfs_md5, vfs_xattr, vfs_delete, vfs_open, vfs_read, vfs_write, vfs_glob, vfs_vmfs_stat, vfs_vmfs_dir, vfs_vmfs_read, wait, thread_name, thread_sort_index, skyframe_eval, skyfunction, critical_path, critical_path_component, handle_gc_notification, action_counts, action_cache_counts, local_cpu_usage, system_cpu_usage, cpu_usage_estimation, local_memory_usage, system_memory_usage, memory_usage_estimation, system_network_up_usage, system_network_down_usage, workers_memory_usage, system_load_average, starlark_parser, starlark_user_fn, starlark_builtin_fn, starlark_user_compiled_fn, starlark_repository_fn, action_fs_staging, remote_cache_check, remote_download, remote_network, filesystem_traversal, worker_execution, worker_setup, worker_borrow, worker_working, worker_copying_outputs, credential_helper, pressure_stall_io, pressure_stall_memory, conflict_check, dynamic_lock, repository_fetch or unknown> รายการ
ระบุงานเพิ่มเติมเกี่ยวกับโปรไฟล์ที่จะรวมไว้ในโปรไฟล์
แท็ก: bazel_monitoring
ค่าเริ่มต้น --[no]experimental_profile_include_primary_output: "เท็จ"
รวมค่า "ออก" เพิ่มเติม ในเหตุการณ์การดำเนินการที่มีเส้นทางปฏิบัติการไปยังเอาต์พุตหลักของการดำเนินการ
แท็ก: bazel_monitoring
ค่าเริ่มต้น --[no]experimental_profile_include_target_label: "เท็จ"
รวมป้ายกำกับเป้าหมายในเหตุการณ์การดำเนินการ ข้อมูลโปรไฟล์ JSON
แท็ก: bazel_monitoring
ค่าเริ่มต้น --[no]experimental_run_bep_event_include_residue: "เท็จ"
เลือกว่าจะรวมการขาดเหลือของบรรทัดคำสั่งในเหตุการณ์บิลด์ซึ่งอาจมีส่วนที่เหลือหรือไม่ โดยค่าเริ่มต้น ความต่อเนื่องจะไม่รวมอยู่ในเหตุการณ์การสร้างคำสั่งการเรียกใช้คำสั่งที่อาจมีส่วนที่เหลืออยู่
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]experimental_stream_log_file_uploads: "เท็จ"
สตรีมไฟล์บันทึกจะอัปโหลดไปยังพื้นที่เก็บข้อมูลระยะไกลโดยตรงแทนการเขียนลงดิสก์
แท็ก: affects_outputs
ค่าเริ่มต้น --experimental_workspace_rules_log_file=<a path>: ดูคำอธิบาย
บันทึกเหตุการณ์บางอย่างของกฎ Workspace ลงในไฟล์นี้เป็นโปรโตคอล WorkspaceEvent ที่คั่นด้วยเครื่องหมาย
ค่าเริ่มต้น --[no]generate_json_trace_profile: "อัตโนมัติ"
หากเปิดใช้ Bazel จะโปรไฟล์บิลด์และเขียนโปรไฟล์รูปแบบ JSON ลงในไฟล์ในฐานเอาต์พุต ดูโปรไฟล์โดยการโหลดลงใน chrome://tracing โดยค่าเริ่มต้น Bazel จะเขียนโปรไฟล์สำหรับคำสั่งและคำค้นหาที่เหมือนกับบิลด์ทั้งหมด
แท็ก: bazel_monitoring
ค่าเริ่มต้น --[no]heap_dump_on_oom: "เท็จ"
เลือกว่าจะแสดงฮีปดัมป์ด้วยตนเองหรือไม่หากมีการส่ง OOM (รวมถึง OOM ด้วยตนเองเนื่องจากถึง --gc_thrashing_limits) ระบบจะเขียน Dump ไปยัง <output_base>/<invocation_id>.heapdump.hprof ตัวเลือกนี้ใช้แทน -XX:+HeapDumpOnOutOfMemoryError อย่างมีประสิทธิภาพ ซึ่งจะไม่มีผลกับ OOM ที่กำหนดเอง
แท็ก: bazel_monitoring
ค่าเริ่มต้น --[no]legacy_important_outputs: "true"
ใช้อาร์กิวเมนต์นี้เพื่อระงับการสร้างช่อง legal_outputs เดิมในเหตุการณ์ TargetComplete ต้องใช้ required_outputs สำหรับการผสานรวม Bazel กับ ResultStore
แท็ก: affects_outputs
ค่าเริ่มต้น --logging=<0 <= an integer <= 6>: "3"
ระดับการบันทึก
แท็ก: affects_outputs
ค่าเริ่มต้น --memory_profile=<a path>: ดูคำอธิบาย
หากตั้งค่า ให้เขียนข้อมูลการใช้งานหน่วยความจำไปยังไฟล์ที่ระบุเมื่อเฟสสิ้นสุดและฮีปที่เสถียรในบันทึกหลักเมื่อสิ้นสุดบิลด์
แท็ก: bazel_monitoring
ค่าเริ่มต้น --memory_profile_stable_heap_parameters=<integers, separated by a comma expected in pairs>: "1,0"
ปรับการคำนวณฮีปที่เสถียรของโปรไฟล์หน่วยความจำที่ส่วนท้ายของบิลด์ ควรเป็นจํานวนเต็มและจำนวนคู่คั่นด้วยคอมมา ในแต่ละคู่ จำนวนเต็มแรกคือจำนวน GC ที่จะดำเนินการ จำนวนเต็มที่สองในแต่ละคู่คือจำนวนวินาทีที่จะรอระหว่าง GC ตัวอย่างเช่น 2,4,4,0 จะ GC 2 รายการที่มีการหยุดชั่วคราว 4 วินาที ตามด้วย 4 GC ที่มีการหยุดชั่วคราว 0 วินาที
แท็ก: bazel_monitoring
ค่าเริ่มต้น --profile=<a path>: ดูคำอธิบาย
หากมีการตั้งค่า ให้สร้างโปรไฟล์ Bazel และเขียนข้อมูลไปยังไฟล์ที่ระบุ ใช้โปรไฟล์การวิเคราะห์ bazel เพื่อวิเคราะห์โปรไฟล์
แท็ก: bazel_monitoring
ค่าเริ่มต้น --[no]record_full_profiler_data: "เท็จ"
โดยค่าเริ่มต้น เครื่องมือสร้างโปรไฟล์ Bazel จะบันทึกเฉพาะข้อมูลรวมสำหรับกิจกรรมที่รวดเร็ว แต่มีกิจกรรมจำนวนมาก (เช่น การระบุไฟล์) หากเปิดใช้งานตัวเลือกนี้ เครื่องมือสร้างโปรไฟล์จะบันทึกแต่ละเหตุการณ์ ซึ่งทำให้ข้อมูลการทำโปรไฟล์แม่นยำมากขึ้นแต่มีการทำงานที่มีประสิทธิภาพ LARGE ตัวเลือกจะมีผลก็ต่อเมื่อใช้ --profile ด้วย
แท็ก: bazel_monitoring
ค่าเริ่มต้น --remote_print_execution_messages=<failure, success or all>: "ล้มเหลว"
เลือกเวลาที่จะพิมพ์ข้อความการดำเนินการจากระยะไกล ค่าที่ใช้ได้คือ "ล้มเหลว" หากต้องการพิมพ์เมื่อล้มเหลวเท่านั้น "สำเร็จ" เพื่อพิมพ์เฉพาะเมื่อสำเร็จ และ "ทั้งหมด" เพื่อพิมพ์เสมอ
แท็ก: terminal_output
ค่าเริ่มต้น --[no]slim_profile: "true"
ลดขนาดของโปรไฟล์ JSON ลงโดยการรวมเหตุการณ์หากโปรไฟล์มีขนาดใหญ่เกินไป
แท็ก: bazel_monitoring
ค่าเริ่มต้นของ --starlark_cpu_profile=<a string>: ""
เขียนโปรไฟล์ pprof ของการใช้งาน CPU ของเทรด Starlark ทั้งหมดลงในไฟล์ที่ระบุ
แท็ก: bazel_monitoring
ค่าเริ่มต้นของ --tool_tag=<a string>: ""
ชื่อเครื่องมือที่จะระบุแหล่งที่มาของการเรียกใช้ Bazel นี้
แท็ก: affects_outputs bazel_monitoring
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --ui_event_filters=<Convert list of comma separated event kind to list of filters> รายการ
ระบุเหตุการณ์ที่จะแสดงใน UI คุณสามารถเพิ่มหรือนําเหตุการณ์ออกจากเหตุการณ์เริ่มต้นได้โดยใช้ +/- นําหน้า หรือลบล้างชุดเริ่มต้นทั้งหมดด้วยการกำหนดโดยตรง โดยชุดประเภทเหตุการณ์ที่รองรับประกอบด้วย INFO, DEBUG, ERROR และอื่นๆ
แท็ก: terminal_output
ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
ค่าเริ่มต้น --experimental_circuit_breaker_strategy=<failure>: ดูคำอธิบาย
ระบุกลยุทธ์ที่เบรกเกอร์จะใช้ กลยุทธ์ที่ใช้ได้คือ "ความล้มเหลว" หากค่าที่ไม่ถูกต้องสำหรับตัวเลือก ลักษณะการทำงานเช่นเดียวกันกับตัวเลือกไม่ได้ตั้งค่า
แท็ก: execution
ค่าเริ่มต้น --[no]experimental_guard_against_concurrent_changes: "เท็จ"
ปิดการตั้งค่านี้เพื่อปิดใช้การตรวจสอบเวลาของไฟล์อินพุตของการดำเนินการก่อนอัปโหลดไปยังแคชระยะไกล ในบางกรณีที่เคอร์เนลของ Linux จะหน่วงเวลาการเขียนไฟล์ ซึ่งอาจทำให้เกิดผลบวกลวง
ค่าเริ่มต้น --[no]experimental_remote_cache_async: "เท็จ"
หากเป็น "จริง" I/O ของแคชระยะไกลจะเกิดขึ้นในเบื้องหลังแทนที่จะเกิดขึ้นเป็นส่วนที่สร้างขึ้น
ค่าเริ่มต้น --experimental_remote_cache_compression_threshold=<an integer>: "0"
ขนาด BLOB ขั้นต่ำที่ต้องใช้เพื่อบีบอัด/คลายการบีบอัดด้วย zstd จะไม่มีผล ยกเว้นกรณีที่ตั้งค่า --remote_cache_compression ไว้
ค่าเริ่มต้น --[no]experimental_remote_cache_lease_extension: "เท็จ"
หากตั้งค่าเป็น "จริง" Bazel จะขยายเวลาการเช่าสำหรับเอาต์พุตของการดำเนินการระยะไกลระหว่างการสร้างโดยการส่งการเรียกใช้ "FindDoesBlobs" ไปยังแคชระยะไกลเป็นระยะ ความถี่จะอิงตามค่าของ "--experimental_remote_cache_ttl"
ค่าเริ่มต้น --experimental_remote_cache_ttl=<An immutable length of time.>: "3 ชม."
TTL ที่รับประกันขั้นต่ำของ BLOB ในแคชระยะไกลหลังจากมีการอ้างอิงไดเจสต์เมื่อเร็วๆ นี้ เช่น โดย ActionResult หรือ Find MissingBlobs Bazel ทำการเพิ่มประสิทธิภาพมากมายโดยอิงตาม BLOB TTL เช่น ไม่ได้เรียกใช้ GetActionResult ซ้ำๆ ในบิลด์ที่เพิ่มขึ้น ควรกำหนดค่าน้อยกว่า TTL จริงเล็กน้อย เนื่องจากมีช่องว่างระหว่างเวลาที่เซิร์ฟเวอร์แสดงผลไดเจสต์กับเวลาที่ Bazel ได้รับ
แท็ก: execution
ค่าเริ่มต้น --experimental_remote_capture_corrupted_outputs=<a path>: ดูคำอธิบาย
เส้นทางไปยังไดเรกทอรีซึ่งจะมีการบันทึกเอาต์พุตที่เสียหาย
ค่าเริ่มต้น --[no]experimental_remote_discard_merkle_trees: "เท็จ"
หากตั้งค่าเป็น "จริง" ให้ทิ้งสำเนาในหน่วยความจำของโครงสร้าง Merkle ของรูทอินพุตและการแมปอินพุตที่เกี่ยวข้องระหว่างการเรียก GetActionResult() และ Execute() ซึ่งช่วยลดการใช้งานหน่วยความจำได้อย่างมาก แต่จะต้องให้ Bazel คํานวณใหม่เมื่อมีการไม่พบแคชระยะไกลหรือลองอีกครั้ง
ค่าเริ่มต้น --experimental_remote_downloader=<a string>: ดูคำอธิบาย
URI ปลายทางของ Remote Asset API ที่จะใช้เป็นพร็อกซีการดาวน์โหลดระยะไกล สคีมาที่รองรับ ได้แก่ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (ซ็อกเก็ต UNIX ในเครื่อง) หากไม่ได้ระบุสคีมา Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ดูที่ https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.เลือก
ค่าเริ่มต้น --[no]experimental_remote_downloader_local_fallback: "เท็จ"
กลับไปใช้เครื่องมือดาวน์โหลดในเครื่องหรือไม่หากโปรแกรมดาวน์โหลดระยะไกลล้มเหลว
ค่าเริ่มต้น --[no]experimental_remote_execution_keepalive: "เท็จ"
ต้องการใช้ Keepalive สำหรับการเรียกใช้การดำเนินการระยะไกลหรือไม่
ค่าเริ่มต้น --experimental_remote_failure_rate_threshold=<an integer in 0-100 range>: "10"
ตั้งค่าจำนวนอัตราความล้มเหลวที่อนุญาตเป็นเปอร์เซ็นต์สำหรับกรอบเวลาที่เจาะจงหลังจากหยุดเรียกใช้แคช/ผู้ดำเนินการระยะไกล ค่าเริ่มต้นคือ 10 การตั้งค่านี้เป็น 0 หมายความว่าไม่มีข้อจำกัด
แท็ก: execution
ค่าเริ่มต้นของ --experimental_remote_failure_window_interval=<An immutable length of time.>: "60 วินาที"
ช่วงเวลาที่มีการคำนวณอัตราความล้มเหลวของคำขอระยะไกล หากค่าเป็น 0 หรือค่าลบ ระบบจะคำนวณระยะเวลาความล้มเหลวตลอดทั้งระยะเวลาในการดำเนินการ หน่วยต่อไปนี้สามารถใช้ได้ ได้แก่ วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
แท็ก: execution
ค่าเริ่มต้น --[no]experimental_remote_mark_tool_inputs: "เท็จ"
หากตั้งค่าเป็น "จริง" Bazel จะทำเครื่องหมายอินพุตเป็นอินพุตเครื่องมือสำหรับผู้ดำเนินการระยะไกล โดยจะนำไปใช้ติดตั้งใช้งานผู้ปฏิบัติงานที่ทำงานถาวรจากระยะไกลได้
ค่าเริ่มต้น --[no]experimental_remote_merkle_tree_cache: "เท็จ"
หากตั้งค่าเป็น "จริง" ระบบจะบันทึกการคำนวณต้นไม้ Merkle เพื่อปรับปรุงความเร็วในการตรวจสอบ Hit ของแคชระยะไกล การพิมพ์พื้นที่หน่วยความจำของแคชจะควบคุมโดย --experimental_remote_merkle_tree_cache_size
ค่าเริ่มต้น --experimental_remote_merkle_tree_cache_size=<a long integer>: "1000"
จำนวนต้น Merkle ที่จะบันทึกเพื่อปรับปรุงความเร็วในการตรวจสอบการเข้าถึงแคชระยะไกล แม้ว่าแคชจะถูกตัดทอนโดยอัตโนมัติตามการจัดการการอ้างอิงแบบซอฟต์ของ Java แต่ข้อผิดพลาดจากหน่วยความจำไม่เพียงพอก็อาจเกิดขึ้นได้หากตั้งค่าสูงเกินไป หากตั้งค่าเป็น 0 ระบบจะไม่จำกัดขนาดของแคช ค่าที่ดีที่สุดจะแตกต่างกันไปตามขนาดของโปรเจ็กต์ โดยมีค่าเริ่มต้นเป็น 1,000
ค่าเริ่มต้น --[no]experimental_remote_require_cached: "เท็จ"
หากตั้งค่าเป็น "จริง" ให้บังคับใช้การแคชการดำเนินการทั้งหมดที่เรียกใช้จากระยะไกลได้ ไม่เช่นนั้นจะทำให้บิลด์ใช้งานไม่ได้ วิธีนี้มีประโยชน์ในการแก้ปัญหาที่ไม่ได้กำหนดกระบวนการ เนื่องจากจะช่วยให้ตรวจสอบได้ว่าการดำเนินการที่ควรแคชมีการแคชไว้จริงๆ หรือไม่ โดยไม่ต้องแทรกผลลัพธ์ใหม่ลงในแคชอย่างจงใจ
ค่าเริ่มต้น --experimental_remote_scrubbing_config=<Converts to a Scrubber>: ดูคำอธิบาย
เปิดใช้การสครับคีย์แคชระยะไกลด้วยไฟล์การกำหนดค่าที่ให้มา ซึ่งต้องเป็นบัฟเฟอร์โปรโตคอลในรูปแบบข้อความ (ดู src/main/protocolbuf/remote_scrubbing.เลือก) ฟีเจอร์นี้มีไว้เพื่ออำนวยความสะดวกในการแชร์แคชระยะไกล/ดิสก์ระหว่างการดำเนินการที่ดำเนินการบนแพลตฟอร์มอื่นแต่กำหนดเป้าหมายไปยังแพลตฟอร์มเดียวกัน ควรใช้ด้วยความระมัดระวังอย่างยิ่ง เนื่องจากการตั้งค่าที่ไม่เหมาะสมอาจทำให้เกิดการแชร์รายการแคชโดยไม่ได้ตั้งใจและส่งผลให้เกิดการสร้างที่ไม่ถูกต้อง การสครับไม่มีผลต่อวิธีเรียกใช้การดำเนินการ แต่มีเพียงวิธีการคำนวณคีย์แคชระยะไกล/ดิสก์เพื่อวัตถุประสงค์ในการเรียกข้อมูลหรือจัดเก็บผลลัพธ์การดำเนินการเท่านั้น การดำเนินการแบบสครับใช้กับการดำเนินการระยะไกลไม่ได้ และจะทำงานในเครื่องแทนเสมอ การแก้ไขการกำหนดค่าการสครับจะไม่ทำให้เอาต์พุตที่มีอยู่ในระบบไฟล์ในเครื่องหรือแคชภายในเป็นโมฆะ ต้องใช้บิลด์ใหม่เพื่อดำเนินการทำงานที่ได้รับผลกระทบอีกครั้ง เพื่อให้สามารถใช้ฟีเจอร์นี้ได้สำเร็จ คุณอาจต้องตั้งค่า --host_platform ที่กำหนดเองร่วมกับ --experimental_platform_in_output_dir (เพื่อทำให้คำนำหน้าเอาต์พุตเป็นมาตรฐาน) และ --incompatible_strict_action_env (เพื่อปรับตัวแปรสภาพแวดล้อมให้เป็นมาตรฐาน)
ค่าเริ่มต้น --[no]incompatible_remote_build_event_upload_respect_no_cache: "เท็จ"
เลิกใช้งานแล้ว ไม่มีการดำเนินการ โปรดใช้ --remote_build_event_upload=minimal แทน
ค่าเริ่มต้น --[no]incompatible_remote_downloader_send_all_headers: "true"
เลือกว่าจะส่งค่าทั้งหมดของส่วนหัวที่มีหลายค่าไปยังโปรแกรมดาวน์โหลดระยะไกลแทนที่จะส่งเฉพาะค่าแรกหรือไม่
แท็ก: incompatible_change
ค่าเริ่มต้น --[no]incompatible_remote_output_paths_relative_to_input_root: "เท็จ"
หากตั้งค่าเป็น "จริง" เส้นทางเอาต์พุตจะสัมพัทธ์กับรูทอินพุตแทนที่จะเป็นไดเรกทอรีที่ใช้งานได้
แท็ก: incompatible_change
ค่าเริ่มต้น --[no]incompatible_remote_results_ignore_disk: "true"
ไม่มีการดำเนินการ
แท็ก: incompatible_change
ค่าเริ่มต้น --[no]remote_accept_cached: "true"
เลือกว่าจะยอมรับผลการดำเนินการที่แคชไว้จากระยะไกลหรือไม่
ค่าเริ่มต้น --remote_build_event_upload=<all or minimal>: "ขั้นต่ำ"
หากตั้งค่าเป็น "all" ระบบจะอัปโหลดเอาต์พุตในเครื่องทั้งหมดที่ BEP อ้างอิงไปยังแคชระยะไกล หากตั้งค่าเป็น "ค่าต่ำสุด" ระบบจะไม่อัปโหลดเอาต์พุตในเครื่องที่ BEP อ้างอิงไปยังแคชระยะไกล ยกเว้นไฟล์ที่มีความสำคัญต่อผู้บริโภคของ BEP (เช่น บันทึกการทดสอบและโปรไฟล์เวลา) รูปแบบ Bystream:// จะใช้สำหรับ uri ของไฟล์เสมอ แม้ว่าจะไม่มีในแคชระยะไกลก็ตาม ค่าเริ่มต้นคือ "ขั้นต่ำ"
ค่าเริ่มต้น --remote_bytestream_uri_prefix=<a string>: ดูคำอธิบาย
ชื่อโฮสต์และชื่ออินสแตนซ์ที่จะใช้ใน URI ของ bytesstream:// ซึ่งเขียนลงในสตรีมเหตุการณ์ของบิลด์ ตัวเลือกนี้สามารถตั้งค่าได้เมื่อดำเนินการบิลด์โดยใช้พร็อกซี ซึ่งทำให้ค่าของ --remote_executor และ --remote_instance_name ไม่ตรงกับชื่อ Canonical ของบริการการดำเนินการระยะไกลอีกต่อไป หากไม่ได้ตั้งค่า จะมีค่าเริ่มต้นเป็น "${ชื่อโฮสต์}/${instance_name}"
ค่าเริ่มต้น --remote_cache=<a string>: ดูคำอธิบาย
URI ของปลายทางการแคช สคีมาที่รองรับ ได้แก่ http, https, grpc, grpcs (grpc ที่เปิดใช้ TLS) และ unix (local UNIX Sockets) หากไม่ได้ระบุสคีมา Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุสคีมา grpc://, http:// หรือ unix: เพื่อปิดใช้ TLS ดู https://bazel.build/remote/caching
ค่าเริ่มต้น --[no]remote_cache_compression: "เท็จ"
หากเปิดใช้ ให้บีบอัด/ยกเลิกการบีบอัด BLOB ของแคชที่มี zstd เมื่อขนาดเท่ากับ --experimental_remote_cache_compression_threshold เป็นอย่างน้อย
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --remote_cache_header=<a 'name=value' assignment> รายการ
ระบุส่วนหัวที่จะรวมอยู่ในคำขอแคช: --remote_cache_header=Name=Value สามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --remote_default_exec_properties=<a 'name=value' assignment> รายการ
ตั้งค่าพร็อพเพอร์ตี้ exec เริ่มต้นที่จะใช้เป็นแพลตฟอร์มการดำเนินการระยะไกล หากแพลตฟอร์มการดำเนินการยังไม่ได้ตั้งค่า exec_properties
แท็ก: affects_outputs
ค่าเริ่มต้นของ --remote_default_platform_properties=<a string>: ""
ตั้งค่าพร็อพเพอร์ตี้แพลตฟอร์มเริ่มต้นสำหรับ API การดำเนินการระยะไกล หากแพลตฟอร์มการดำเนินการยังไม่ได้ตั้งค่า Remote_execution_properties เอาไว้ ระบบจะใช้ค่านี้หากเลือกแพลตฟอร์มโฮสต์เป็นแพลตฟอร์มการดำเนินการสำหรับการดำเนินการระยะไกล
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --remote_download_regex=<a string> รายการ
บังคับให้ Bazel ดาวน์โหลดอาร์ติแฟกต์ที่ตรงกับ regexp ที่ระบุ ใช้ร่วมกับ Build โดยไม่มีไบต์ (หรือค่าเทียบเท่าภายใน) เพื่ออนุญาตให้ไคลเอ็นต์ขออาร์ติแฟกต์บางอย่างที่อาจต้องใช้ในเครื่อง (เช่น การรองรับ IDE) คุณระบุนิพจน์ทั่วไปได้หลายรายการโดยใช้แฟล็กนี้ซ้ำ
แท็ก: affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --remote_downloader_header=<a 'name=value' assignment> รายการ
ระบุส่วนหัวที่จะรวมอยู่ในคำขอโปรแกรมดาวน์โหลดระยะไกล: --remote_downloader_header=Name=Value สามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --remote_exec_header=<a 'name=value' assignment> รายการ
ระบุส่วนหัวที่จะรวมอยู่ในคำขอการดำเนินการ: --remote_exec_header=Name=Value สามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
ค่าเริ่มต้น --remote_execution_priority=<an integer>: "0"
ลำดับความสำคัญที่เกี่ยวข้องของการดำเนินการที่จะเรียกใช้จากระยะไกล ความหมายของค่าลำดับความสำคัญหนึ่งๆ จะขึ้นอยู่กับเซิร์ฟเวอร์
ค่าเริ่มต้น --remote_executor=<a string>: ดูคำอธิบาย
HOST หรือ HOST:PORT ของปลายทางการดำเนินการระยะไกล สคีมาที่รองรับ ได้แก่ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (ซ็อกเก็ต UNIX ในเครื่อง) หากไม่ได้ระบุสคีมา Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุ grpc:// หรือ unix: สคีมาเพื่อปิดใช้ TLS
ค่าเริ่มต้น --remote_grpc_log=<a path>: ดูคำอธิบาย
เส้นทางไปยังไฟล์เพื่อบันทึกรายละเอียดเกี่ยวกับการโทร gRPC หากระบุ บันทึกนี้ประกอบด้วยลำดับของ com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry protobufs ของแบบต่อเนื่อง โดยแต่ละข้อความจะมีคำนำหน้าเป็น varint ซึ่งแสดงขนาดของข้อความ protocolbuf แบบต่อเนื่องต่อไปนี้ โดยใช้เมธอด LogEntry.writeDelimitedTo(OutputStream)
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --remote_header=<a 'name=value' assignment> รายการ
ระบุส่วนหัวที่จะรวมอยู่ในคำขอ: --remote_header=Name=Value สามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
ค่าเริ่มต้นของ --remote_instance_name=<a string>: ""
ค่าที่จะส่งผ่านเป็นอินสแตนซ์_name ใน API การดำเนินการระยะไกล
ค่าเริ่มต้น --[no]remote_local_fallback: "เท็จ"
กลับไปใช้กลยุทธ์การดำเนินการภายในเครื่องแบบสแตนด์อโลนหรือไม่ หากการดำเนินการจากระยะไกลล้มเหลว
ค่าเริ่มต้น --remote_local_fallback_strategy=<a string>: "ท้องถิ่น"
ไม่มีการดำเนินการ เลิกใช้งานแล้ว ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7480
ค่าเริ่มต้น --remote_max_connections=<an integer>: "100"
จำกัดจำนวนการเชื่อมต่อพร้อมกันสูงสุดให้กับแคช/ผู้ดำเนินการระยะไกล ค่าเริ่มต้นคือ 100 การตั้งค่านี้เป็น 0 หมายความว่าไม่มีข้อจำกัด สำหรับแคชระยะไกล HTTP การเชื่อมต่อ TCP 1 รายการสามารถจัดการคำขอได้ครั้งละ 1 รายการ ดังนั้น Bazel สามารถสร้างคำขอพร้อมกันได้สูงสุด --remote_max_connections สำหรับแคช/ผู้ดำเนินการระยะไกล gRPC ช่อง gRPC หนึ่งช่องมักจะรองรับคำขอพร้อมกันได้มากกว่า 100 คำขอ ดังนั้น Bazel จึงสามารถสร้างคำขอพร้อมกันประมาณ "--remote_max_connections * 100"
แท็ก: host_machine_resource_optimizations
ค่าเริ่มต้น --remote_proxy=<a string>: ดูคำอธิบาย
เชื่อมต่อกับแคชระยะไกลผ่านพร็อกซี ปัจจุบัน Flag นี้สามารถใช้เพื่อกำหนดค่า Socket ของโดเมน Unix (unix:/path/to/socket) เท่านั้น
ค่าเริ่มต้น --remote_result_cache_priority=<an integer>: "0"
ลำดับความสำคัญที่เกี่ยวข้องของการดำเนินการระยะไกลที่จะจัดเก็บในแคชระยะไกล ความหมายของค่าลำดับความสำคัญหนึ่งๆ จะขึ้นอยู่กับเซิร์ฟเวอร์
ค่าเริ่มต้น --remote_retries=<an integer>: "5"
จำนวนสูงสุดของความพยายามที่จะลองแก้ไขข้อผิดพลาดชั่วคราวอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
ค่าเริ่มต้น --remote_retry_max_delay=<An immutable length of time.>: "5s"
การหน่วงเวลา Backoff สูงสุดระหว่างการพยายามลองอีกครั้งจากระยะไกล คุณสามารถใช้หน่วยต่อไปนี้: วัน (d), ชั่วโมง (h), นาที (m), วินาที และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
ค่าเริ่มต้นของ --remote_timeout=<An immutable length of time.>: "60 วินาที"
ระยะเวลาสูงสุดในการรอการเรียกใช้จากระยะไกลและการเรียกใช้แคช สำหรับแคช REST นี่คือทั้งการเชื่อมต่อและระยะหมดเวลาในการอ่าน คุณสามารถใช้หน่วยต่อไปนี้: วัน (d), ชั่วโมง (h), นาที (m), วินาที และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
ค่าเริ่มต้น --[no]remote_upload_local_results: "true"
เลือกว่าจะอัปโหลดผลลัพธ์การดำเนินการที่ดำเนินการในเครื่องไปยังแคชระยะไกลหรือไม่ หากแคชระยะไกลรองรับ และผู้ใช้ได้รับอนุญาตให้ดำเนินการดังกล่าว
ค่าเริ่มต้น --[no]remote_verify_downloads: "true"
หากตั้งค่าเป็น "จริง" Bazel จะคำนวณจำนวนแฮชของการดาวน์โหลดระยะไกลทั้งหมด และทิ้งค่าที่แคชไว้จากระยะไกลหากไม่ตรงกับค่าที่คาดไว้
ตัวเลือกเบ็ดเตล็ด ที่ยังไม่ได้รับการแยกประเภท:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --build_metadata=<a 'name=value' assignment> รายการ
คู่คีย์-ค่าที่กำหนดเองที่จะระบุไว้ในเหตุการณ์บิลด์
แท็ก: terminal_output
ค่าเริ่มต้น --color=<yes, no or auto>: "อัตโนมัติ"
ใช้ตัวควบคุมเทอร์มินัลเพื่อกำหนดสีเอาต์พุต
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --config=<a string> รายการ
เลือกส่วนการกำหนดค่าเพิ่มเติมจากไฟล์ rc สำหรับทุก <command> จะมีการดึงตัวเลือกจาก <command>:<config> หากมีส่วนดังกล่าว หากไม่มีส่วนนี้ในไฟล์ .rc ระบบจะดำเนินการ Blaze ไม่สำเร็จโดยมีข้อผิดพลาด ส่วนการกำหนดค่าและชุด Flag ต่างๆ ที่เนื้อหาเหล่านี้จะเทียบเท่ากันจะอยู่ในไฟล์การกำหนดค่า Tools/*.blazerc
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.> รายการ
กำหนดค่าโปรแกรมช่วยข้อมูลเข้าสู่ระบบที่สอดคล้องกับ<a href="https://github.com/EngFlow/credential-helper-spec">ข้อมูลจำเพาะของโปรแกรมช่วยข้อมูลรับรอง</a> เพื่อใช้สำหรับเรียกข้อมูลเข้าสู่ระบบการให้สิทธิ์สำหรับการดึงข้อมูลที่เก็บ การแคชและการดำเนินการจากระยะไกล และบริการเหตุการณ์ของบิลด์ ข้อมูลเข้าสู่ระบบที่ผู้ช่วยระบุจะมีความสำคัญเหนือกว่าข้อมูลเข้าสู่ระบบที่จัดให้โดย "--google_default_credentials", "--google_credentials", ไฟล์ ".netrc" หรือพารามิเตอร์การตรวจสอบสิทธิ์กับ "repository_ctx.download()" และ "repository_ctx.download_and_extract()" สามารถระบุได้หลายครั้งเพื่อตั้งค่าผู้ช่วยหลายตัว ดูวิธีการได้ที่ https://blog.engflow.com/2023/10/09/configuring-bazels-credential-helper/
ค่าเริ่มต้นของ --credential_helper_cache_duration=<An immutable length of time.>: "30m"
ระยะเวลาเริ่มต้นที่ระบบจะแคชข้อมูลเข้าสู่ระบบที่ตัวช่วยข้อมูลเข้าสู่ระบบให้ไว้ หากตัวช่วยนั้นไม่ได้ระบุเมื่อข้อมูลเข้าสู่ระบบหมดอายุ
ค่าเริ่มต้น --credential_helper_timeout=<An immutable length of time.>: "10 วินาที"
กำหนดค่าการหมดเวลาสำหรับตัวช่วยข้อมูลเข้าสู่ระบบ ตัวช่วยข้อมูลเข้าสู่ระบบที่ไม่ตอบกลับภายในระยะหมดเวลานี้จะเรียกใช้ไม่สําเร็จ
ค่าเริ่มต้น --curses=<yes, no or auto>: "อัตโนมัติ"
ใช้การควบคุมเคอร์เซอร์เทอร์มินัลเพื่อลดขนาดเอาต์พุตแบบเลื่อน
ค่าเริ่มต้น --disk_cache=<a path>: ดูคำอธิบาย
เส้นทางไปยังไดเรกทอรีที่ Bazel อ่านและเขียนการดำเนินการและเอาต์พุตการดำเนินการได้ หากไม่มีไดเรกทอรี ระบบจะสร้างไดเรกทอรีให้
ค่าเริ่มต้น --[no]enable_platform_specific_config: "เท็จ"
หากเป็นจริง Bazel จะใช้บรรทัดการกำหนดค่าเฉพาะโฮสต์ของระบบปฏิบัติการจากไฟล์ bazelrc ตัวอย่างเช่น หากระบบปฏิบัติการของโฮสต์คือ Linux และคุณเรียกใช้บิลด์ของ Bazel เบราว์เซอร์ Bazel จะดึงข้อมูลบรรทัดที่เริ่มต้นด้วย Builder:linux ตัวระบุระบบปฏิบัติการที่รองรับ ได้แก่ Linux, Macos, Windows, Freebsd และ openbsd การเปิดใช้งานการตั้งค่าสถานะนี้เทียบเท่ากับการใช้ --config=linux ใน Linux, --config=windows ใน Windows ฯลฯ
ค่าเริ่มต้น --[no]experimental_rule_extension_api: "เท็จ"
เปิดใช้ API ส่วนขยายกฎทดลองและ API กฎย่อย
แท็ก: loading_and_analysis, experimental
ค่าเริ่มต้น --[no]experimental_windows_watchfs: "เท็จ"
หากเป็นจริง จะมีการเปิดใช้งานการสนับสนุน Windows รุ่นทดลองสำหรับ --watchfs มิฉะนั้น --watchfsis จะเป็นแบบไม่ดำเนินการบน Windows โปรดตรวจสอบว่าได้เปิดใช้งาน --watchfs ด้วย
ค่าเริ่มต้น --google_auth_scopes=<comma-separated list of options>: "https://www.googleapis.com/auth/cloud-platform"
รายการขอบเขตการตรวจสอบสิทธิ์ Google Cloud ที่คั่นด้วยคอมมา
ค่าเริ่มต้น --google_credentials=<a string>: ดูคำอธิบาย
ระบุไฟล์ที่จะรับข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication
ค่าเริ่มต้น --[no]google_default_credentials: "เท็จ"
จะใช้ "ข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชันของ Google" หรือไม่ เพื่อตรวจสอบสิทธิ์ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication ปิดใช้โดยค่าเริ่มต้น
ค่าเริ่มต้น --grpc_keepalive_time=<An immutable length of time.>: ดูคำอธิบาย
กำหนดค่าคำสั่ง ping แบบ Keep-alive สำหรับการเชื่อมต่อ gRPC ขาออก หากตั้งค่าไว้ Bazel จะส่งคำสั่ง ping หลังจากไม่มีการดำเนินการอ่านในการเชื่อมต่อเป็นเวลานาน แต่เฉพาะเมื่อมีการเรียกใช้ gRPC ที่รอดำเนินการอย่างน้อย 1 ครั้ง เวลาจะถือว่าเป็นรายละเอียดที่ 2 การตั้งค่าน้อยกว่า 1 วินาทีเป็นข้อผิดพลาด โดยค่าเริ่มต้น ระบบจะปิดใช้คําสั่ง ping ของ Keep-alive ไว้ คุณควรประสานงานกับเจ้าของบริการก่อนเปิดใช้การตั้งค่านี้ ตัวอย่างเช่น หากต้องการกำหนดค่า 30 วินาทีให้กับแฟล็กนี้ ก็ควรทำแบบนี้ --grpc_keepalive_time=30s
ค่าเริ่มต้นของ --grpc_keepalive_timeout=<An immutable length of time.>: "20 วินาที"
กำหนดค่าระยะหมดเวลาแบบ Keep-alive สำหรับการเชื่อมต่อ gRPC ขาออก หากเปิดใช้งานคําสั่ง ping ตลอดเวลาด้วย --grpc_keepalive_time แล้ว Bazel จะหมดเวลาการเชื่อมต่อหากไม่ได้รับคําสั่ง ping หลังจากผ่านไประยะหนึ่ง เวลาจะถือว่าเป็นรายละเอียดที่ 2 การตั้งค่าน้อยกว่า 1 วินาทีเป็นข้อผิดพลาด หากปิดการใช้คําสั่ง ping ของ Keep-alive การตั้งค่านี้จะไม่มีผล
ค่าเริ่มต้น --[no]incompatible_disable_non_executable_java_binary: "เท็จ"
หากเป็นจริง java_binary จะทำงานได้เสมอ นำแอตทริบิวต์ create_executable ออกแล้ว
แท็ก: loading_and_analysis incompatible_change
ไม่มีการดำเนินการ
แท็ก: loading_and_analysis, incompatible_change
ค่าเริ่มต้น --[no]progress_in_terminal_title: "เท็จ"
แสดงความคืบหน้าของคำสั่งในชื่อเทอร์มินัล มีประโยชน์ในการดูว่า bazel กำลังทำอะไรเมื่อมีแท็บเทอร์มินัลหลายแท็บ
ค่าเริ่มต้น --[no]show_progress: "true"
แสดงข้อความความคืบหน้าระหว่างบิลด์
ค่าเริ่มต้น --show_progress_rate_limit=<a double>: "0.2"
จำนวนวินาทีขั้นต่ำระหว่างข้อความแสดงความคืบหน้าในเอาต์พุต
ค่าเริ่มต้น --[no]show_timestamps: "เท็จ"
ใส่การประทับเวลาในข้อความ
ค่าเริ่มต้น --tls_certificate=<a string>: ดูคำอธิบาย
ระบุเส้นทางไปยังใบรับรอง TLS ที่เชื่อถือให้ลงนามใบรับรองเซิร์ฟเวอร์
ค่าเริ่มต้น --tls_client_certificate=<a string>: ดูคำอธิบาย
ระบุใบรับรองไคลเอ็นต์ TLS ที่จะใช้ คุณต้องระบุคีย์ไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
ค่าเริ่มต้น --tls_client_key=<a string>: ดูคำอธิบาย
ระบุคีย์ไคลเอ็นต์ TLS ที่จะใช้ คุณจะต้องระบุใบรับรองไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์
ค่าเริ่มต้น --ui_actions_shown=<an integer>: "8"
จำนวนการดำเนินการที่เกิดขึ้นพร้อมกันซึ่งแสดงในแถบความคืบหน้าโดยละเอียด การดำเนินการแต่ละรายการจะแสดงแยกบรรทัดกัน แถบความคืบหน้าจะแสดงอย่างน้อย 1 รายการเสมอ และตัวเลขทั้งหมดที่น้อยกว่า 1 จะจับคู่กับ 1
แท็ก: terminal_output
ค่าเริ่มต้น --[no]watchfs: "เท็จ"
ใน Linux/macOS: หากเป็น "จริง" bazel จะพยายามใช้บริการเฝ้าดูไฟล์ของระบบปฏิบัติการสำหรับการเปลี่ยนแปลงในเครื่องแทนการสแกนทุกไฟล์เพื่อหาการเปลี่ยนแปลง ใน Windows: ปัจจุบันแฟล็กนี้เป็นแบบ non-op แต่สามารถเปิดใช้ร่วมกับ --experimental_windows_watchfs ในทุกระบบปฏิบัติการ: ไม่มีการกำหนดลักษณะการทำงานหากพื้นที่ทำงานอยู่ในระบบไฟล์เครือข่าย และมีการแก้ไขไฟล์ในเครื่องระยะไกล

ตัวเลือกการวิเคราะห์

ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --distdir=<a path> รายการ
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก: bazel_internal_configuration
หากมีการตั้งค่า แคชของที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่เกิดแคชแทนที่จะคัดลอก ซึ่งช่วยประหยัดพื้นที่ในดิสก์
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --experimental_repository_downloader_retries=<an integer>: "0"
จำนวนครั้งสูงสุดในการลองดาวน์โหลดข้อผิดพลาดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก: experimental
ค่าเริ่มต้น --experimental_scale_timeouts=<a double>: "1.0"
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ด้วยปัจจัยนี้ ด้วยวิธีนี้ ที่เก็บภายนอกจะทำให้ทำงานกับเครื่องที่ทำงานช้ากว่าที่ผู้สร้างกฎคาดไว้ โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก: bazel_internal_configuration experimental
ค่าเริ่มต้น --http_connector_attempts=<an integer>: "8"
จำนวนครั้งสูงสุดในการดาวน์โหลด HTTP
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --http_connector_retry_max_timeout=<An immutable length of time.>: "0s"
การหมดเวลาสูงสุดสำหรับการลองดาวน์โหลด HTTP ซ้ำ เมื่อใช้ค่า 0 จะไม่มีการกำหนดระยะหมดเวลาสูงสุด
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --http_timeout_scaling=<a double>: "1.0"
ปรับขนาดการหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลด HTTP ด้วยตัวประกอบที่ระบุ
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --repository_cache=<a path>: ดูคำอธิบาย
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการเรียกข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช มิเช่นนั้น จะใช้ค่าเริ่มต้นเป็น "<output_user_root>/cache/repos/v1" ถูกใช้แล้ว
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --[no]repository_disable_download: "เท็จ"
หากตั้งค่าไว้ ไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลที่เก็บ โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้อย่างสมบูรณ์ ctx.execute ยังคงสามารถรันไฟล์ปฏิบัติการที่กำหนดเองได้ในการเข้าถึงอินเทอร์เน็ต
แท็ก: bazel_internal_configuration
ตัวเลือกที่ควบคุมการดำเนินการของบิลด์:
ค่าเริ่มต้น --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
เปอร์เซ็นต์ของพื้นที่เก็บข้อมูลเต็ม (0-100) ซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์แรงดันหน่วยความจำเทียบกับขีดจำกัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก: host_machine_resource_optimizations
ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --allow_yanked_versions=<a string> รายการ
ระบุเวอร์ชันโมดูลในรูปแบบ "<module1>@<version1>,<module2>@<version2>" ซึ่งจะได้รับอนุญาตในกราฟทรัพยากร Dependency ที่ได้รับการแก้ไขแล้ว แม้ว่าจะมีการประกาศเวอร์ชันในรีจิสทรีในที่มาของเวอร์ชัน (หากไม่ได้มาจาก NonRegistryOverride) มิเช่นนั้น เวอร์ชันที่แยกออกมาจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันแยกที่อนุญาตด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" ได้ด้วย คุณสามารถปิดการตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "ทั้งหมด" (ไม่แนะนำ)
แท็ก: loading_and_analysis
ค่าเริ่มต้น --check_bazel_compatibility=<error, warning or off>: "ข้อผิดพลาด"
ตรวจสอบความเข้ากันได้กับเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" ที่ส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" ให้พิมพ์คำเตือนเมื่อตรวจพบข้อมูลที่ไม่ตรงกัน
แท็ก: loading_and_analysis
ค่าเริ่มต้น --check_direct_dependencies=<off, warning or error>: "คำเตือน"
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟทรัพยากร Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" ให้พิมพ์คำเตือนเมื่อตรวจพบข้อมูลไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อยกระดับการแก้ปัญหาไม่สำเร็จ
แท็ก: loading_and_analysis
ค่าเริ่มต้น --[no]ignore_dev_dependency: "เท็จ"
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะไม่สนใจทรัพยากร Dependency สำหรับนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูทไม่ว่าค่าของแฟล็กนี้จะเป็นอะไร
แท็ก: loading_and_analysis
ค่าเริ่มต้น --lockfile_mode=<off, update or error>: "อัปเดต"
ระบุวิธีและวิธีใช้ล็อกไฟล์ ค่าที่ถูกต้องคือ "อัปเดต" เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง "ข้อผิดพลาด" ในการใช้ไฟล์ล็อกแต่เกิดข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" ไม่อ่านหรือเขียนไปยังไฟล์ล็อก
แท็ก: loading_and_analysis
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --override_module=<an equals-separated mapping of module name to path> รายการ
ลบล้างโมดูลด้วยเส้นทางภายในในรูปแบบ <module name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์ ระบบจะใช้เส้นทางตามที่เป็น ถ้าเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพัทธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางดังกล่าวจะสัมพัทธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --registry=<a string> รายการ
ระบุรีจิสทรีที่จะใช้ในการค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับเป็นสิ่งสำคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีในภายหลังเมื่อไม่มีรีจิสทรีที่ขาดหายไป
แท็ก: changes_inputs
ค่าเริ่มต้น --vendor_dir=<a path>: ดูคำอธิบาย
ระบุไดเรกทอรีที่ควรเก็บที่เก็บภายนอกในโหมดผู้ให้บริการ ไม่ว่าจะเพื่อวัตถุประสงค์ในการดึงข้อมูลลงในที่เก็บหรือใช้ขณะที่สร้าง คุณสามารถระบุเส้นทางเป็นเส้นทางสัมบูรณ์หรือเส้นทางที่สัมพันธ์กับไดเรกทอรีพื้นที่ทำงานก็ได้
แท็ก: loading_and_analysis
ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพเวลาของบิลด์
ค่าเริ่มต้น --gc_thrashing_limits=<comma separated pairs of <period>:<count>>: "1s:2,20s:3,1m:5"
ถึงขีดจำกัดแล้ว (หากมี) จะทำให้ GcThrashingDetector ทำให้ Bazel ขัดข้องด้วย OOM ขีดจํากัดแต่ละรายการจะระบุเป็น <period>:<count> โดยที่ระยะเวลาคือระยะเวลาและจํานวนเป็นจำนวนเต็มบวก หากมีการใช้งานพื้นที่มากกว่า --gc_thrashing_threshold เปอร์เซ็นต์ของพื้นที่ว่าง (ฮีป Gen เก่า) หลัง <count> GC แบบเต็มติดต่อกันภายใน <period> จะมีการทริกเกอร์ OOM คุณระบุขีดจำกัดหลายรายการได้โดยคั่นด้วยเครื่องหมายจุลภาค
แท็ก: host_machine_resource_optimizations
ค่าเริ่มต้นของ --skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
ตั้งค่าสถานะสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้ฮีปที่เก็บรักษาไว้เกินเกณฑ์ที่ --skyframe_high_water_mark_threshold กำหนด เมื่อเกิดเหตุการณ์ GC เต็มรูปแบบเกิดขึ้น สถานะของ Skyframe ชั่วคราวจะถูกตัดทิ้งโดยไม่จำเป็นจนถึงจำนวนครั้งดังกล่าวต่อการเรียกใช้หลายครั้ง ค่าเริ่มต้นคือจำนวนเต็ม MAX_VALUE ได้อย่างไม่จำกัด 0 หมายความว่ากิจกรรม GC ทั้งหมดจะไม่ทริกเกอร์การลดลง หากถึงขีดจำกัด สถานะ Skyframe จะไม่ลดลงอีกต่อไปเมื่อเกิดเหตุการณ์ GC เต็มรูปแบบและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก: host_machine_resource_optimizations
ค่าเริ่มต้นของ --skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
ตั้งค่าสถานะสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้ฮีปที่เก็บรักษาไว้เกินเกณฑ์ที่ --skyframe_high_water_mark_threshold ตั้งค่าอยู่ เมื่อเกิดเหตุการณ์ GC ที่ไม่ร้ายแรง เหตุการณ์ GC ที่ไม่ร้ายแรงจะเกิดขึ้น ระบบจะหยุดสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นออกไปจนถึงหลายครั้งต่อการเรียกใช้ ค่าเริ่มต้นคือจำนวนเต็ม MAX_VALUE ได้อย่างไม่จำกัด ศูนย์หมายความว่ากิจกรรม GC ที่ไม่สำคัญจะไม่ทริกเกอร์การลดลงเลย หากถึงขีดจำกัดแล้ว สถานะ Skyframe จะไม่ลดลงอีกต่อไปเมื่อเกิดเหตุการณ์ GC ที่ไม่ร้ายแรงและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก: host_machine_resource_optimizations
ค่าเริ่มต้นของ --skyframe_high_water_mark_threshold=<an integer>: "85"
ตั้งค่าสถานะสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้ฮีปที่เก็บรักษาไว้ถึงเกณฑ์นี้เป็นอย่างน้อย ก็จะทิ้งสถานะ Skyframe ชั่วคราวโดยไม่จำเป็น การปรับแต่งนี้อาจช่วยลดผลกระทบจากเวลาจริงของการ Thrash
แท็ก: host_machine_resource_optimizations
ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
ค่าเริ่มต้น --dump=<text or raw> [-d]: ดูรายละเอียด
ส่งดัมพ์ของข้อมูลโปรไฟล์แบบเต็มใน "ข้อความ" ที่มนุษย์อ่านได้ "ข้อมูลดิบ" ที่เหมาะกับรูปแบบหรือสคริปต์
แท็ก: affects_outputs
ค่าเริ่มต้น --experimental_command_profile=<cpu, wall, alloc or lock>: ดูคำอธิบาย
บันทึกโปรไฟล์ Java Flight Recorder ตามระยะเวลาของคำสั่ง ต้องระบุประเภทเหตุการณ์การสร้างโปรไฟล์ที่รองรับ (CPU, หน้าจอ, Allo หรือ Lock) เป็นอาร์กิวเมนต์ โปรไฟล์จะเขียนไปยังไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ภายใต้ไดเรกทอรีฐานเอาต์พุต ไวยากรณ์และความหมายของแฟล็กนี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม คุณต้องรับความเสี่ยงของการใช้งานเองด้วย
ค่าเริ่มต้น --[no]experimental_record_metrics_for_all_mnemonics: "เท็จ"
โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจำกัดอยู่ที่ 20 รายการที่มีการกระทำมากที่สุด การตั้งค่าตัวเลือกนี้จะเป็นการเขียนสถิติสำหรับการช่วยจำทั้งหมด
ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
ค่าเริ่มต้นของ --experimental_resolved_file_instead_of_workspace=<a string>: ""
หากไม่ว่างเปล่า ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก: changes_inputs
ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
ค่าเริ่มต้น --experimental_downloader_config=<a string>: ดูคำอธิบาย
ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด แต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือสองรูปแบบ รูปแบบหนึ่งจะจับคู่กัน และอีกรูปแบบหนึ่งใช้เป็น URL ทดแทน โดยมีการอ้างอิงกลับเริ่มตั้งแต่ "$1" เป็นไปได้ที่จะมีการใช้คำสั่ง "rewrite" หลายคำสั่งสำหรับ URL เดียวกัน และในกรณีนี้ระบบจะส่งคืน URL หลายรายการ
ค่าเริ่มต้น --experimental_worker_for_repo_fetching=<off, platform, virtual or auto>: "อัตโนมัติ"
โหมดชุดข้อความที่จะใช้ในการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท มิเช่นนั้น ให้ใช้เทรดแพลตฟอร์ม (เทรดระบบปฏิบัติการ) หากตั้งค่าเป็น "แพลตฟอร์ม" หรือชุดข้อความเสมือนหากตั้งค่าเป็น "เสมือนจริง" หากตั้งค่าเป็น "อัตโนมัติ" จะมีการใช้เทรดเสมือน หากมี (เช่น ทำงานใน JDK 21 ขึ้นไป) มิเช่นนั้นจะไม่มีการใช้เธรดผู้ปฏิบัติงาน
ตัวเลือกเบ็ดเตล็ด ที่ยังไม่ได้รับการแยกประเภท:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --override_repository=<an equals-separated mapping of repository name to path> รายการ
ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์ ระบบจะใช้เส้นทางตามที่เป็น ถ้าเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพัทธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางดังกล่าวจะสัมพัทธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"

ตัวเลือกคำค้นหา

รับค่าตัวเลือกทั้งหมดจาก build

ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --distdir=<a path> รายการ
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก: bazel_internal_configuration
หากมีการตั้งค่า แคชของที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่เกิดแคชแทนที่จะคัดลอก ซึ่งช่วยประหยัดพื้นที่ในดิสก์
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --experimental_repository_downloader_retries=<an integer>: "0"
จำนวนครั้งสูงสุดในการลองดาวน์โหลดข้อผิดพลาดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก: experimental
ค่าเริ่มต้น --experimental_scale_timeouts=<a double>: "1.0"
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ด้วยปัจจัยนี้ ด้วยวิธีนี้ ที่เก็บภายนอกจะทำให้ทำงานกับเครื่องที่ทำงานช้ากว่าที่ผู้สร้างกฎคาดไว้ โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก: bazel_internal_configuration experimental
ค่าเริ่มต้น --http_connector_attempts=<an integer>: "8"
จำนวนครั้งสูงสุดในการดาวน์โหลด HTTP
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --http_connector_retry_max_timeout=<An immutable length of time.>: "0s"
การหมดเวลาสูงสุดสำหรับการลองดาวน์โหลด HTTP ซ้ำ เมื่อใช้ค่า 0 จะไม่มีการกำหนดระยะหมดเวลาสูงสุด
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --http_timeout_scaling=<a double>: "1.0"
ปรับขนาดการหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลด HTTP ด้วยตัวประกอบที่ระบุ
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --repository_cache=<a path>: ดูคำอธิบาย
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการเรียกข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช มิเช่นนั้น จะใช้ค่าเริ่มต้นเป็น "<output_user_root>/cache/repos/v1" ถูกใช้แล้ว
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --[no]repository_disable_download: "เท็จ"
หากตั้งค่าไว้ ไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลที่เก็บ โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้อย่างสมบูรณ์ ctx.execute ยังคงสามารถรันไฟล์ปฏิบัติการที่กำหนดเองได้ในการเข้าถึงอินเทอร์เน็ต
แท็ก: bazel_internal_configuration
ตัวเลือกที่ควบคุมการดำเนินการของบิลด์:
ค่าเริ่มต้น --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
เปอร์เซ็นต์ของพื้นที่เก็บข้อมูลเต็ม (0-100) ซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์แรงดันหน่วยความจำเทียบกับขีดจำกัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก: host_machine_resource_optimizations
ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตการค้นหาและความหมาย
ค่าเริ่มต้น --aspect_deps=<off, conservative or precise>: "เชิงรับ"
วิธีแก้ไขทรัพยากร Dependency ของลักษณะเมื่อรูปแบบเอาต์พุตเป็นหนึ่งใน {xml,protocol,record} "off" หมายความว่าจะไม่มีการแก้ไขทรัพยากร Dependency ในด้านต่างๆ "เชิงรับ" (ค่าเริ่มต้น) หมายความว่าจะมีการเพิ่มทรัพยากร Dependency ที่ประกาศทั้งหมด ไม่ว่าทรัพยากรเหล่านั้นจะได้รับคลาสของกฎการขึ้นต่อกันโดยตรงหรือไม่ ซึ่งก็คือ "แม่นยำ" หมายความว่าจะมีการเพิ่มเฉพาะด้านที่อาจทำงานอยู่ตามคลาสกฎของทรัพยากร Dependency โดยตรง โปรดทราบว่าโหมดแม่นยำต้องมีการโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียว ซึ่งจะทำให้ช้ากว่าโหมดอื่นๆ และโปรดทราบด้วยว่า โหมดแม้กระทั่งที่แม่นยำก็ไม่ได้แม่นยำทั้งหมด การตัดสินใจว่าจะคำนวณด้านใดด้านหนึ่งหรือไม่จะทำในขั้นตอนการวิเคราะห์ ซึ่งจะไม่ทำงานระหว่าง "การค้นหาแบบงัดแงะ"
แท็ก: build_file_semantics
ค่าเริ่มต้น --[no]consistent_labels: "เท็จ"
หากเปิดใช้งาน ทุกคำสั่งการค้นหาจะแสดงป้ายกำกับประหนึ่งว่าด้วย Starlark <code>str</code> ที่ใช้กับ<code>ป้ายกำกับ</code> อินสแตนซ์ ซึ่งมีประโยชน์สำหรับเครื่องมือที่จำเป็นต้องจับคู่เอาต์พุตของคำสั่งการค้นหาและ/หรือป้ายกำกับต่างๆ ที่กฎเรียกใช้ หากไม่เปิดใช้ ตัวจัดรูปแบบเอาต์พุตจะแสดงชื่อที่เก็บที่ชัดเจน (สัมพันธ์กับที่เก็บหลัก) แทนเพื่อทำให้เอาต์พุตอ่านได้ง่ายขึ้น
แท็ก: terminal_output
ค่าเริ่มต้น --[no]experimental_explicit_aspects: "เท็จ"
aquery, cquery: จะรวมการทำงานที่สร้างโดยมุมมองไว้ในเอาต์พุตหรือไม่ คำค้นหา: ไม่มีการดำเนินการ (ติดตามเสมอ)
แท็ก: terminal_output
ค่าเริ่มต้น --[no]graph:factored: "true"
หากเป็น "จริง" กราฟจะแสดงผลแบบ "แยกตัวประกอบ" นั่นคือ โหนดที่เท่าเทียมกันทางโทโพโลจีจะผสานเข้าด้วยกันและป้ายกำกับของโหนดทั้งสองเชื่อมติดกัน ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก: terminal_output
ค่าเริ่มต้น --graph:node_limit=<an integer>: "512"
ความยาวสูงสุดของสตริงป้ายกำกับสำหรับโหนดกราฟในเอาต์พุต ป้ายกำกับที่ยาวขึ้นจะถูกตัด -1 หมายถึงไม่มีการตัดข้อความ ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก: terminal_output
ค่าเริ่มต้น --[no]implicit_deps: "true"
หากเปิดใช้ การขึ้นต่อกันโดยปริยายจะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ทรัพยากร Dependency โดยนัยคือทรัพยากรที่ไม่มีการระบุอย่างชัดแจ้งในไฟล์ BUILD แต่เพิ่มโดย Bazel สำหรับ cquery ตัวเลือกนี้จะควบคุมการกรอง Toolchain ที่มีการแก้ปัญหาแล้ว
แท็ก: build_file_semantics
ค่าเริ่มต้น --[no]include_artifacts: "true"
รวมชื่อของอินพุตและเอาต์พุตการดำเนินการในเอาต์พุต (ซึ่งอาจมีขนาดใหญ่)
แท็ก: terminal_output
ค่าเริ่มต้น --[no]include_aspects: "true"
aquery, cquery: จะรวมการทำงานที่สร้างโดยมุมมองไว้ในเอาต์พุตหรือไม่ คำค้นหา: ไม่มีการดำเนินการ (ติดตามเสมอ)
แท็ก: terminal_output
ค่าเริ่มต้น --[no]include_commandline: "true"
มีเนื้อหาของบรรทัดคำสั่งสำหรับการดำเนินการในเอาต์พุต (อาจมีขนาดใหญ่)
แท็ก: terminal_output
ค่าเริ่มต้น --[no]include_file_write_contents: "เท็จ"
ใส่เนื้อหาไฟล์สำหรับการดำเนินการ FileWrite, SourceSymlinkManifest และ RepoMappingManifest (ซึ่งอาจมีขนาดใหญ่)
แท็ก: terminal_output
ค่าเริ่มต้น --[no]include_param_files: "เท็จ"
รวมเนื้อหาของไฟล์พารามิเตอร์ที่ใช้ในคำสั่ง (อาจมีขนาดใหญ่) หมายเหตุ: การเปิดใช้งานการตั้งค่าสถานะนี้จะเป็นการเปิดใช้การตั้งค่าสถานะ --include_commandline โดยอัตโนมัติ
แท็ก: terminal_output
ค่าเริ่มต้น --[no]incompatible_package_group_includes_double_slash: "true"
หากเปิดใช้ เมื่อแสดงแอตทริบิวต์ "packages" ของpackage_group จะไม่ละเว้น "//" ที่นำหน้า
แท็ก: terminal_output incompatible_change
ค่าเริ่มต้น --[no]infer_universe_scope: "เท็จ"
หากตั้งค่า และ --universe_scope ไม่ได้ตั้งค่าไว้ ระบบจะอนุมานค่าของ --universe_scope เป็นรายการรูปแบบเป้าหมายที่ไม่ซ้ำกันในนิพจน์การค้นหา โปรดทราบว่าค่า --universe_scope ที่อนุมานสำหรับนิพจน์การค้นหาที่ใช้ฟังก์ชันที่กําหนดขอบเขตระดับจักรวาล (เช่น "allrdeps") อาจไม่ใช่สิ่งที่คุณต้องการ คุณจึงควรใช้ตัวเลือกนี้ก็ต่อเมื่อคุณทราบว่าคุณกำลังทำอะไรอยู่เท่านั้น ดูรายละเอียดและตัวอย่างได้ที่ https://bazel.build/reference/query#sky-query หากตั้งค่า --universe_scope ค่า ระบบจะไม่สนใจค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้ใช้ได้เฉพาะกับ "query" (กล่าวคือ ไม่ใช่ "cquery")
แท็ก: loading_and_analysis
ค่าเริ่มต้น --[no]line_terminator_null: "เท็จ"
เลือกว่าจะสิ้นสุดแต่ละรูปแบบด้วย \0 แทนการขึ้นบรรทัดใหม่หรือไม่
แท็ก: terminal_output
ค่าเริ่มต้น --[no]nodep_deps: "true"
หากเปิดใช้ ระบบจะแยกออกจาก "nodep" จะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ตัวอย่างทั่วไปของ "nodep" คือ "visibility" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ "info create-language" เพื่อดูข้อมูลเกี่ยวกับ "nodep" ทั้งหมด ในภาษาของบิลด์
แท็ก: build_file_semantics
ค่าเริ่มต้น --output=<a string>: "ข้อความ"
รูปแบบที่ควรพิมพ์ผลการค้นหาคำค้นหา ค่าที่อนุญาตสำหรับ aquery คือ text, textprotocol, proto, streamed_profi, jsonprotocol
แท็ก: terminal_output
ค่าเริ่มต้น --[no]proto:default_values: "true"
หากเป็น "จริง" ระบบจะรวมแอตทริบิวต์ที่ไม่ได้ระบุไว้อย่างชัดเจนในไฟล์ BUILD มิฉะนั้นจะถูกละเว้น ตัวเลือกนี้ใช้ได้กับ --output=prof
แท็ก: terminal_output
ค่าเริ่มต้น --[no]proto:definition_stack: "เท็จ"
ป้อนข้อมูลในช่อง Proto ของ Definition_stack ซึ่งบันทึกสำหรับสแต็กการเรียกใช้ Starlark สำหรับแต่ละอินสแตนซ์ของกฎ ณ เวลาที่มีการกำหนดคลาสของกฎ
แท็ก: terminal_output
ค่าเริ่มต้น --[no]proto:flatten_selects: "true"
หากเปิดใช้ ระบบจะแยกแอตทริบิวต์ที่กำหนดค่าได้ซึ่งสร้างโดย select() ไว้ในรูปแบบ สำหรับประเภทรายการ การแสดงแบบ "แยกเป็นหลายรายการ" คือรายการซึ่งประกอบด้วยแต่ละค่าของแผนที่ที่เลือกเพียงครั้งเดียว ระบบจะแยกประเภทสเกลาร์เป็นค่าว่าง
แท็ก: build_file_semantics
ค่าเริ่มต้น --[no]proto:include_attribute_source_aspects: "เท็จ"
ป้อนข้อมูลในช่อง Proto ของ source_aspect_name ของแต่ละแอตทริบิวต์ด้วยลักษณะต้นทางของแอตทริบิวต์นั้น (สตริงว่างเปล่าหากไม่มีข้อมูล)
แท็ก: terminal_output
ค่าเริ่มต้น --[no]proto:include_synthetic_attribute_hash: "เท็จ"
คำนวณและเติมข้อมูลแอตทริบิวต์ $internal_attr_hash หรือไม่
แท็ก: terminal_output
ค่าเริ่มต้น --[no]proto:instantiation_stack: "เท็จ"
ป้อนข้อมูลสแต็กการเรียกใช้การสร้างอินสแตนซ์ของแต่ละกฎ โปรดทราบว่าการดำเนินการนี้ต้องมีสแต็กอยู่
แท็ก: terminal_output
ค่าเริ่มต้น --[no]proto:locations: "true"
ระบุว่าจะแสดงข้อมูลตำแหน่งในเอาต์พุต Pro เลยหรือไม่
แท็ก: terminal_output
ค่าเริ่มต้น --proto:output_rule_attrs=<comma-separated list of options>: "ทั้งหมด"
รายการแอตทริบิวต์ที่คั่นด้วยจุลภาคที่จะรวมในเอาต์พุต ค่าเริ่มต้นคือแอตทริบิวต์ทั้งหมด ตั้งค่าเป็นสตริงว่างเปล่าเพื่อไม่ให้แสดงแอตทริบิวต์ใดๆ ตัวเลือกนี้ใช้ได้กับ --output=protocol
แท็ก: terminal_output
ค่าเริ่มต้น --[no]proto:rule_inputs_and_outputs: "true"
เติมข้อมูลในช่อง rules_input และ rules_output หรือไม่
แท็ก: terminal_output
ค่าเริ่มต้นของ --query_file=<a string>: ""
หากมีการตั้งค่าไว้ การค้นหาจะอ่านการค้นหาจากไฟล์ที่มีชื่อที่นี่ แทนที่จะเป็นบรรทัดคำสั่ง การระบุไฟล์ที่นี่และคำค้นหาบรรทัดคำสั่งเป็นข้อผิดพลาด
แท็ก: changes_inputs
ค่าเริ่มต้น --[no]relative_locations: "เท็จ"
หากเป็นจริง ตำแหน่งของไฟล์ BUILD ใน XML และเอาต์พุต Pro จะสัมพันธ์กัน โดยค่าเริ่มต้น เอาต์พุตตำแหน่งจะเป็นเส้นทางสัมบูรณ์และจะไม่สอดคล้องกันในแต่ละเครื่อง คุณสามารถตั้งค่าตัวเลือกนี้เป็น "จริง" เพื่อให้ได้ผลลัพธ์ที่สอดคล้องกันในอุปกรณ์ทุกเครื่อง
แท็ก: terminal_output
ค่าเริ่มต้น --[no]skyframe_state: "เท็จ"
ดัมพ์กราฟการดำเนินการปัจจุบันจาก Skyframe โดยไม่ต้องทำการวิเคราะห์เพิ่มเติม หมายเหตุ: ขณะนี้ระบบยังไม่รองรับการระบุเป้าหมายด้วย --skyframe_state แฟล็กนี้ใช้ได้เฉพาะกับ --output=prof หรือ --output=textprotocol
แท็ก: terminal_output
ค่าเริ่มต้น --[no]tool_deps: "true"
การค้นหา: หากปิดใช้ ทรัพยากร Dependency ใน "การกำหนดค่า exec" จะไม่รวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน "การกำหนดค่าการดำเนินการ" เอดจ์ของทรัพยากร Dependency เช่น ขีดจำกัดจาก "proto_library" ให้กับโปรโตคอลคอมไพเลอร์ ซึ่งโดยทั่วไปจะชี้ไปยังเครื่องมือที่ดำเนินการระหว่างการสร้างแทนที่จะเป็นส่วนของ "เป้าหมาย" เดียวกัน ของโปรแกรม Cquery: หากปิดใช้ จะกรองเป้าหมายที่กำหนดค่าไว้ทั้งหมดซึ่งข้ามการเปลี่ยนการดำเนินการจากเป้าหมายระดับบนสุดที่ค้นพบเป้าหมายที่กำหนดค่าไว้นี้ออก ซึ่งหมายความว่าหากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าเป้าหมาย ระบบจะแสดงผลเฉพาะเป้าหมายที่กำหนดค่าไว้ในการกำหนดค่าเป้าหมายด้วย ถ้าเป้าหมายระดับบนสุดอยู่ในการกำหนดค่า exec ระบบจะแสดงผลเฉพาะเป้าหมายที่กำหนดค่าของ exec เท่านั้น ตัวเลือกนี้จะ "ไม่" ยกเว้น Toolchain ที่แก้ไขแล้ว
แท็ก: build_file_semantics
ค่าเริ่มต้นของ --universe_scope=<comma-separated list of options>: ""
ชุดรูปแบบเป้าหมายที่คั่นด้วยคอมมา (บวกและลบ) การค้นหาอาจดำเนินการในจักรวาลที่กำหนดโดยการปิดแบบสับเปลี่ยนของเป้าหมายที่ระบุ ตัวเลือกนี้ใช้สําหรับคำสั่งการค้นหาและคำสั่ง cquery สำหรับ cquery อินพุตของตัวเลือกนี้จะเป็นเป้าหมายในการสร้างคำตอบทั้งหมด ดังนั้นตัวเลือกนี้อาจส่งผลต่อการกําหนดค่าและการเปลี่ยน หากไม่ได้ระบุตัวเลือกนี้ ระบบจะถือว่าเป้าหมายระดับบนสุดเป็นเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหา หมายเหตุ: สำหรับ cquery การไม่ระบุตัวเลือกนี้อาจทำให้บิลด์ไม่ทำงานหากเป้าหมายที่แยกวิเคราะห์จากนิพจน์คำค้นหาไม่สามารถสร้างได้ด้วยตัวเลือกระดับบนสุด
แท็ก: loading_and_analysis
ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --allow_yanked_versions=<a string> รายการ
ระบุเวอร์ชันโมดูลในรูปแบบ "<module1>@<version1>,<module2>@<version2>" ซึ่งจะได้รับอนุญาตในกราฟทรัพยากร Dependency ที่ได้รับการแก้ไขแล้ว แม้ว่าจะมีการประกาศเวอร์ชันในรีจิสทรีในที่มาของเวอร์ชัน (หากไม่ได้มาจาก NonRegistryOverride) มิเช่นนั้น เวอร์ชันที่แยกออกมาจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันแยกที่อนุญาตด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" ได้ด้วย คุณสามารถปิดการตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "ทั้งหมด" (ไม่แนะนำ)
แท็ก: loading_and_analysis
ค่าเริ่มต้น --check_bazel_compatibility=<error, warning or off>: "ข้อผิดพลาด"
ตรวจสอบความเข้ากันได้กับเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" ที่ส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" ให้พิมพ์คำเตือนเมื่อตรวจพบข้อมูลที่ไม่ตรงกัน
แท็ก: loading_and_analysis
ค่าเริ่มต้น --check_direct_dependencies=<off, warning or error>: "คำเตือน"
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟทรัพยากร Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" ให้พิมพ์คำเตือนเมื่อตรวจพบข้อมูลไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อยกระดับการแก้ปัญหาไม่สำเร็จ
แท็ก: loading_and_analysis
ค่าเริ่มต้น --[no]ignore_dev_dependency: "เท็จ"
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะไม่สนใจทรัพยากร Dependency สำหรับนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูทไม่ว่าค่าของแฟล็กนี้จะเป็นอะไร
แท็ก: loading_and_analysis
ค่าเริ่มต้น --lockfile_mode=<off, update or error>: "อัปเดต"
ระบุวิธีและวิธีใช้ล็อกไฟล์ ค่าที่ถูกต้องคือ "อัปเดต" เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง "ข้อผิดพลาด" ในการใช้ไฟล์ล็อกแต่เกิดข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" ไม่อ่านหรือเขียนไปยังไฟล์ล็อก
แท็ก: loading_and_analysis
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --override_module=<an equals-separated mapping of module name to path> รายการ
ลบล้างโมดูลด้วยเส้นทางภายในในรูปแบบ <module name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์ ระบบจะใช้เส้นทางตามที่เป็น ถ้าเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพัทธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางดังกล่าวจะสัมพัทธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --registry=<a string> รายการ
ระบุรีจิสทรีที่จะใช้ในการค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับเป็นสิ่งสำคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีในภายหลังเมื่อไม่มีรีจิสทรีที่ขาดหายไป
แท็ก: changes_inputs
ค่าเริ่มต้น --vendor_dir=<a path>: ดูคำอธิบาย
ระบุไดเรกทอรีที่ควรเก็บที่เก็บภายนอกในโหมดผู้ให้บริการ ไม่ว่าจะเพื่อวัตถุประสงค์ในการดึงข้อมูลลงในที่เก็บหรือใช้ขณะที่สร้าง คุณสามารถระบุเส้นทางเป็นเส้นทางสัมบูรณ์หรือเส้นทางที่สัมพันธ์กับไดเรกทอรีพื้นที่ทำงานก็ได้
แท็ก: loading_and_analysis
ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพเวลาของบิลด์
ค่าเริ่มต้น --gc_thrashing_limits=<comma separated pairs of <period>:<count>>: "1s:2,20s:3,1m:5"
ถึงขีดจำกัดแล้ว (หากมี) จะทำให้ GcThrashingDetector ทำให้ Bazel ขัดข้องด้วย OOM ขีดจํากัดแต่ละรายการจะระบุเป็น <period>:<count> โดยที่ระยะเวลาคือระยะเวลาและจํานวนเป็นจำนวนเต็มบวก หากมีการใช้งานพื้นที่มากกว่า --gc_thrashing_threshold เปอร์เซ็นต์ของพื้นที่ว่าง (ฮีป Gen เก่า) หลัง <count> GC แบบเต็มติดต่อกันภายใน <period> จะมีการทริกเกอร์ OOM คุณระบุขีดจำกัดหลายรายการได้โดยคั่นด้วยเครื่องหมายจุลภาค
แท็ก: host_machine_resource_optimizations
ค่าเริ่มต้นของ --skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
ตั้งค่าสถานะสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้ฮีปที่เก็บรักษาไว้เกินเกณฑ์ที่ --skyframe_high_water_mark_threshold กำหนด เมื่อเกิดเหตุการณ์ GC เต็มรูปแบบเกิดขึ้น สถานะของ Skyframe ชั่วคราวจะถูกตัดทิ้งโดยไม่จำเป็นจนถึงจำนวนครั้งดังกล่าวต่อการเรียกใช้หลายครั้ง ค่าเริ่มต้นคือจำนวนเต็ม MAX_VALUE ได้อย่างไม่จำกัด 0 หมายความว่ากิจกรรม GC ทั้งหมดจะไม่ทริกเกอร์การลดลง หากถึงขีดจำกัด สถานะ Skyframe จะไม่ลดลงอีกต่อไปเมื่อเกิดเหตุการณ์ GC เต็มรูปแบบและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก: host_machine_resource_optimizations
ค่าเริ่มต้นของ --skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
ตั้งค่าสถานะสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้ฮีปที่เก็บรักษาไว้เกินเกณฑ์ที่ --skyframe_high_water_mark_threshold ตั้งค่าอยู่ เมื่อเกิดเหตุการณ์ GC ที่ไม่ร้ายแรง เหตุการณ์ GC ที่ไม่ร้ายแรงจะเกิดขึ้น ระบบจะหยุดสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นออกไปจนถึงหลายครั้งต่อการเรียกใช้ ค่าเริ่มต้นคือจำนวนเต็ม MAX_VALUE ได้อย่างไม่จำกัด ศูนย์หมายความว่ากิจกรรม GC ที่ไม่สำคัญจะไม่ทริกเกอร์การลดลงเลย หากถึงขีดจำกัดแล้ว สถานะ Skyframe จะไม่ลดลงอีกต่อไปเมื่อเกิดเหตุการณ์ GC ที่ไม่ร้ายแรงและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก: host_machine_resource_optimizations
ค่าเริ่มต้นของ --skyframe_high_water_mark_threshold=<an integer>: "85"
ตั้งค่าสถานะสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้ฮีปที่เก็บรักษาไว้ถึงเกณฑ์นี้เป็นอย่างน้อย ก็จะทิ้งสถานะ Skyframe ชั่วคราวโดยไม่จำเป็น การปรับแต่งนี้อาจช่วยลดผลกระทบจากเวลาจริงของการ Thrash
แท็ก: host_machine_resource_optimizations
ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
ค่าเริ่มต้น --experimental_command_profile=<cpu, wall, alloc or lock>: ดูคำอธิบาย
บันทึกโปรไฟล์ Java Flight Recorder ตามระยะเวลาของคำสั่ง ต้องระบุประเภทเหตุการณ์การสร้างโปรไฟล์ที่รองรับ (CPU, หน้าจอ, Allo หรือ Lock) เป็นอาร์กิวเมนต์ โปรไฟล์จะเขียนไปยังไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ภายใต้ไดเรกทอรีฐานเอาต์พุต ไวยากรณ์และความหมายของแฟล็กนี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม คุณต้องรับความเสี่ยงของการใช้งานเองด้วย
ค่าเริ่มต้น --[no]experimental_record_metrics_for_all_mnemonics: "เท็จ"
โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจำกัดอยู่ที่ 20 รายการที่มีการกระทำมากที่สุด การตั้งค่าตัวเลือกนี้จะเป็นการเขียนสถิติสำหรับการช่วยจำทั้งหมด
ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
ค่าเริ่มต้นของ --experimental_resolved_file_instead_of_workspace=<a string>: ""
หากไม่ว่างเปล่า ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก: changes_inputs
ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
ค่าเริ่มต้น --experimental_downloader_config=<a string>: ดูคำอธิบาย
ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด แต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือสองรูปแบบ รูปแบบหนึ่งจะจับคู่กัน และอีกรูปแบบหนึ่งใช้เป็น URL ทดแทน โดยมีการอ้างอิงกลับเริ่มตั้งแต่ "$1" เป็นไปได้ที่จะมีการใช้คำสั่ง "rewrite" หลายคำสั่งสำหรับ URL เดียวกัน และในกรณีนี้ระบบจะส่งคืน URL หลายรายการ
ค่าเริ่มต้น --experimental_worker_for_repo_fetching=<off, platform, virtual or auto>: "อัตโนมัติ"
โหมดชุดข้อความที่จะใช้ในการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท มิเช่นนั้น ให้ใช้เทรดแพลตฟอร์ม (เทรดระบบปฏิบัติการ) หากตั้งค่าเป็น "แพลตฟอร์ม" หรือชุดข้อความเสมือนหากตั้งค่าเป็น "เสมือนจริง" หากตั้งค่าเป็น "อัตโนมัติ" จะมีการใช้เทรดเสมือน หากมี (เช่น ทำงานใน JDK 21 ขึ้นไป) มิเช่นนั้นจะไม่มีการใช้เธรดผู้ปฏิบัติงาน
ตัวเลือกเบ็ดเตล็ด ที่ยังไม่ได้รับการแยกประเภท:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --override_repository=<an equals-separated mapping of repository name to path> รายการ
ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์ ระบบจะใช้เส้นทางตามที่เป็น ถ้าเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพัทธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางดังกล่าวจะสัมพัทธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"
ตัวเลือกที่ควบคุมการดำเนินการของบิลด์:
เลือกว่าจะเรียกใช้ระบบไฟล์โดยตรงเพื่อสร้างต้นไม้ Symlink หรือไม่
แท็ก: loading_and_analysis, execution, experimental
ค่าเริ่มต้น --[no]experimental_persistent_aar_extractor: "เท็จ"
เปิดใช้เครื่องมือแยก Aar แบบถาวรโดยใช้ผู้ปฏิบัติงาน
แท็ก: execution
ค่าเริ่มต้น --[no]experimental_remotable_source_manifests: "เท็จ"
ต้องการให้การดำเนินการในไฟล์ Manifest ของแหล่งที่มาทำซ้ำได้หรือไม่
แท็ก: loading_and_analysis, execution, experimental
ค่าเริ่มต้น --[no]experimental_split_coverage_postprocessing: "เท็จ"
หากเป็น "จริง" Bazel จะดำเนินการประมวลผลภายหลังสำหรับการครอบคลุมในการทดลองที่สร้างขึ้นใหม่
แท็ก: execution
ค่าเริ่มต้น --[no]experimental_strict_fileset_output: "เท็จ"
หากเปิดใช้ตัวเลือกนี้ ชุดไฟล์จะถือว่าอาร์ติแฟกต์เอาต์พุตทั้งหมดเป็นไฟล์ทั่วไป โดยจะไม่ข้ามผ่านไดเรกทอรีหรือไวต่อลิงก์สัญลักษณ์
แท็ก: execution
ค่าเริ่มต้น --[no]incompatible_disallow_unsound_directory_outputs: "true"
หากตั้งค่าแล้ว การดำเนินการจะแปลงไฟล์เอาต์พุตเป็นไดเรกทอรีเป็นข้อผิดพลาด ไม่ส่งผลกระทบต่อไดเรกทอรีต้นทาง ดู https://github.com/bazelbuild/bazel/issues/18646
แท็ก: bazel_internal_configuration incompatible_change
ค่าเริ่มต้นของ --modify_execution_info=<regex=[+-]key,regex=[+-]key,...>: ""
เพิ่มหรือนำคีย์ออกจากข้อมูลการดำเนินการของการดำเนินการตามความสามารถในการจำการดำเนินการ ใช้กับการดำเนินการที่รองรับข้อมูลการดำเนินการเท่านั้น การดำเนินการทั่วไปจำนวนมากรองรับข้อมูลการดำเนินการ เช่น Genrule, CppCompile, Javac, StarlarkAction, TestRunner เมื่อระบุค่าหลายค่า ลำดับมีความสำคัญเนื่องจาก regexe หลายรายการอาจใช้กับช่วยจำเดียวกันได้ ไวยากรณ์: "regex=[+-]key,regex=[+-]key,..." ตัวอย่าง: '.*=+x,.*=-y,.*=+z' เพิ่ม "x" และ "z" ถึง และนำ "y" ออก ข้อมูลการดำเนินการสำหรับการดำเนินการทั้งหมด 'Genrule=+requires-x' เพิ่ม "requires-x" กับข้อมูลการดำเนินการสำหรับการดำเนินการ Genrule ทั้งหมด '(?!Genrule).*=-requires-x' นำ "requires-x" ออก จากข้อมูลการดำเนินการสำหรับการดำเนินการ ที่ไม่ใช่ Genrule ทั้งหมด
แท็ก: execution, affects_outputs, loading_and_analysis
--persistent_android_dex_desugar
เปิดใช้การดำเนินการ Dex และ desugar ของ Android แบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น

--internal_persistent_android_dex_desugar --strategy=Desugar=worker
--strategy=DexBuilder=worker

แท็ก: host_machine_resource_optimizations execution
--persistent_android_resource_processor
เปิดใช้ผู้ประมวลผลข้อมูลทรัพยากร Android ถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น

--internal_persistent_busybox_tools --strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker

แท็ก: host_machine_resource_optimizations, execution
--persistent_multiplex_android_dex_desugar
เปิดใช้การดำเนินการ Dex และ desugar ของ Android แบบมัลติเพล็กซ์โดยใช้ผู้ปฏิบัติงาน
ขยายเป็น

--persistent_android_dex_desugar --internal_persistent_multiplex_android_dex_desugar

แท็ก: host_machine_resource_optimizations, execution
--persistent_multiplex_android_resource_processor
เปิดใช้เครื่องมือประมวลผลทรัพยากร Android แบบมัลติเพล็กซ์แบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น

--persistent_android_resource_processor --modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers

แท็ก: host_machine_resource_optimizations, execution
--persistent_multiplex_android_tools
เปิดใช้เครื่องมือ Android แบบต่อเนื่องและแบบมัลติเพล็กซ์ (Dexing, Deugaring, Resource Operations)
ขยายเป็น

--internal_persistent_multiplex_busybox_tools --persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar

แท็ก: host_machine_resource_optimizations execution
ค่าเริ่มต้น --[no]use_target_platform_for_tests: "เท็จ"
หากเป็น "จริง" Bazel จะใช้แพลตฟอร์มเป้าหมายในการทำการทดสอบแทนกลุ่มผู้บริหารทดสอบ
แท็ก: execution
ตัวเลือกที่กำหนดค่า Toolchain ที่ใช้สำหรับการดำเนินการมีดังนี้
ค่าเริ่มต้น --android_compiler=<a string>: ดูคำอธิบาย
คอมไพเลอร์เป้าหมายของ Android
แท็ก: affects_outputs, loading_and_analysis, loses_incremental_state
--android_crosstool_top=<a build target label> ค่าเริ่มต้น: "//external:android/crosstool"
ตำแหน่งของคอมไพเลอร์ C++ ที่ใช้สำหรับบิลด์ของ Android
แท็ก: affects_outputs, changes_inputs, loading_and_analysis, loses_incremental_state
ค่าเริ่มต้น --android_grte_top=<a label>: ดูคำอธิบาย
เป้าหมาย Android grte_top
แท็ก: changes_inputs, loading_and_analysis, loses_incremental_state
ค่าเริ่มต้นของ --android_manifest_merger=<legacy, android or force_android>: "android"
เลือกการควบรวมไฟล์ Manifest ที่จะใช้กับกฎ android_binary แจ้งเพื่อช่วยให้เปลี่ยนไปใช้การผสานรวมไฟล์ Manifest ของ Android จากการควบรวมเดิม
แท็ก: affects_outputs, loading_and_analysis, loses_incremental_state
ค่าเริ่มต้นของ --android_platforms=<a build target label>: ""
ตั้งค่าแพลตฟอร์มที่ android_binary กำหนดเป้าหมายใช้ หากระบุหลายแพลตฟอร์ม ไบนารีนั้นจะเป็น APK แบบอ้วน ซึ่งมีไบนารีแบบเนทีฟสำหรับแต่ละแพลตฟอร์มเป้าหมายที่ระบุ
แท็ก: changes_inputs, loading_and_analysis, loses_incremental_state
ค่าเริ่มต้นของ --android_sdk=<a build target label>: "@bazel_tools//tools/android:sdk"
ระบุ SDK/แพลตฟอร์ม Android ที่ใช้สร้างแอปพลิเคชัน Android
แท็ก: changes_inputs, loading_and_analysis, loses_incremental_state
--apple_crosstool_top=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้ในกฎของ Apple และ Objc และทรัพยากร Dependency
แท็ก: loses_incremental_state changes_inputs
ค่าเริ่มต้นของ --cc_output_directory_tag=<a string>: ""
ระบุคำต่อท้ายที่จะเพิ่มในไดเรกทอรีการกำหนดค่า
แท็ก: affects_outputs
ค่าเริ่มต้น --compiler=<a string>: ดูคำอธิบาย
คอมไพเลอร์ C++ ที่จะใช้สำหรับการคอมไพล์เป้าหมาย
แท็ก: loading_and_analysis execution
--coverage_output_generator=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/test:lcov_merger"
ตำแหน่งของไบนารีที่ใช้เพื่อประมวลผลรายงานการครอบคลุมแบบข้อมูลดิบหลังการประมวลผล ซึ่งต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งก็คือไบนารี ค่าเริ่มต้นคือ "//tools/test:lcov_merger"
แท็ก: changes_inputs, affects_outputs, loading_and_analysis
--coverage_report_generator=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_report_generator"
ตําแหน่งของไบนารีที่ใช้สร้างรายงานการครอบคลุม ซึ่งต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งก็คือไบนารี ค่าเริ่มต้นคือ "//tools/test:coverage_report_generator"
แท็ก: changes_inputs, affects_outputs, loading_and_analysis
--coverage_support=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_support"
ตำแหน่งของไฟล์สนับสนุนที่จำเป็นต้องใช้ในอินพุตของการดำเนินการทดสอบทั้งหมดที่รวบรวมการครอบคลุมของโค้ด ค่าเริ่มต้นคือ "//tools/test:coverage_support"
แท็ก: changes_inputs, affects_outputs, loading_and_analysis
--crosstool_top=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้สำหรับคอมไพล์โค้ด C++
แท็ก: loading_and_analysis, changes_inputs, affects_outputs
ค่าเริ่มต้น --custom_malloc=<a build target label>: ดูคำอธิบาย
ระบุการใช้งาน Malloc ที่กำหนดเอง การตั้งค่านี้จะลบล้างแอตทริบิวต์ Malloc ในกฎบิลด์
แท็ก: changes_inputs affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment> รายการ
รายการนิพจน์ทั่วไปที่คั่นด้วยคอมมา แต่ละรายการจะมีคำนำหน้าด้วย - (นิพจน์เชิงลบ) และกำหนด (=) ให้กับรายการเป้าหมายค่าข้อจำกัดที่คั่นด้วยคอมมา หากเป้าหมายตรงกับที่ไม่มีนิพจน์เชิงลบ และนิพจน์เชิงบวกอย่างน้อย 1 รายการ การแปลง Toolchain จะดำเนินการเสมือนว่าได้ประกาศค่าข้อจำกัดเป็นข้อจำกัดการดำเนินการ ตัวอย่าง: //demo,-test=@platforms//cpus:x86_64 จะเพิ่ม "x86_64" ไปยังเป้าหมายใดๆ ภายใต้ //demo ยกเว้นเป้าหมายที่ชื่อมี "test"
แท็ก: loading_and_analysis
ค่าเริ่มต้น --[no]experimental_include_xcode_execution_requirements: "เท็จ"
เมื่อตั้งค่าแล้ว ให้เพิ่ม "requires-xcode:{version}" สำหรับการดำเนินการของ Xcode ทุกครั้ง หากเวอร์ชัน xcode มีป้ายกำกับขีดกลาง ให้เพิ่ม "requires-xcode-label:{version_label}" ด้วย ข้อกำหนดของการดำเนินการ
แท็ก: loses_incremental_state, loading_and_analysis, execution
ค่าเริ่มต้น --[no]experimental_prefer_mutual_xcode: "true"
หากเป็นจริง ให้ใช้ Xcode ล่าสุดที่พร้อมใช้งานทั้งในเครื่องและจากระยะไกล หากเป็นเท็จหรือไม่มีเวอร์ชันที่ใช้ร่วมกัน ให้ใช้เวอร์ชันของ Xcode ในเครื่องที่เลือกผ่าน xcode-select
แท็ก: loses_incremental_state
ค่าเริ่มต้นของ --extra_execution_platforms=<comma-separated list of options>: ""
แพลตฟอร์มที่มีให้ใช้งานเป็นแพลตฟอร์มการดำเนินการเพื่อเรียกใช้การดำเนินการ สามารถระบุแพลตฟอร์มโดยเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมาย แพลตฟอร์มเหล่านี้จะได้รับการพิจารณาก่อนแพลตฟอร์มที่ประกาศในไฟล์ WORKSPACE โดยregister_execution_platforms() ตัวเลือกนี้ตั้งค่าได้เพียงครั้งเดียว อินสแตนซ์ภายหลังจะลบล้างการตั้งค่าแฟล็กก่อนหน้า
แท็ก: execution
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --extra_toolchains=<comma-separated list of options> รายการ
กฎ Toolchain ที่จะต้องพิจารณาระหว่างการแก้ไข Toolchain สามารถระบุ Toolchains ตามเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมายได้ ระบบจะพิจารณา Toolchain เหล่านี้ก่อนการประกาศในไฟล์ WORKSPACE โดยregister_toolchains()
แท็ก: affects_outputs, changes_inputs, loading_and_analysis
ค่าเริ่มต้น --grte_top=<a label>: ดูคำอธิบาย
ป้ายกำกับไปยังไลบรารี libc ที่มีการเช็คอิน Crosstool Toolchain จะเลือกค่าเริ่มต้นและคุณแทบจะไม่จำเป็นต้องลบล้างค่าเริ่มต้น
แท็ก: action_command_lines affects_outputs
ค่าเริ่มต้น --host_compiler=<a string>: ดูคำอธิบาย
คอมไพเลอร์ C++ ที่จะใช้สำหรับการคอมไพล์โฮสต์ โดยจะไม่มีผลหากไม่ได้ตั้งค่า --host_crosstool_top
แท็ก: loading_and_analysis execution
ค่าเริ่มต้น --host_crosstool_top=<a build target label>: ดูคำอธิบาย
โดยค่าเริ่มต้น ตัวเลือก --crosstool_top และ --compiler จะใช้สำหรับการกำหนดค่าผู้ดำเนินการด้วย หากมีแฟล็กนี้ Bazel จะใช้ libc และคอมไพเลอร์เริ่มต้นสำหรับ Crosstool_top ที่ระบุ
แท็ก: loading_and_analysis, changes_inputs, affects_outputs
ค่าเริ่มต้น --host_grte_top=<a label>: ดูคำอธิบาย
ถ้าระบุ การตั้งค่านี้จะลบล้างไดเรกทอรีระดับบนสุดของ libc (--grte_top) สำหรับการกำหนดค่าผู้บริหาร
แท็ก: action_command_lines affects_outputs
ค่าเริ่มต้น --host_platform=<a build target label>: "@local_config_platform//:host"
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายระบบโฮสต์
แท็ก: affects_outputs, changes_inputs, loading_and_analysis
ค่าเริ่มต้น --[no]incompatible_dont_enable_host_nonhost_crosstool_features: "true"
หากเป็น "จริง" Bazel จะไม่เปิดใช้ "โฮสต์" และ "nonhost" ใน Toolchain ของ c++ (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/7407)
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --[no]incompatible_enable_android_toolchain_resolution: "true"
ใช้ความละเอียดของ Toolchain เพื่อเลือก Android SDK สำหรับกฎ Android (Starlark และเนทีฟ)
แท็ก: loading_and_analysis, incompatible_change
ค่าเริ่มต้น --[no]incompatible_enable_apple_toolchain_resolution: "เท็จ"
ใช้ความละเอียดของ Toolchain เพื่อเลือก Apple SDK สำหรับกฎของ Apple (Starlark และเนทีฟ)
แท็ก: loading_and_analysis, incompatible_change
ค่าเริ่มต้น --[no]incompatible_make_thinlto_command_lines_standalone: "true"
หากเป็นจริง Bazel จะไม่นำบรรทัดคำสั่งสำหรับการดำเนินการลิงก์ C++ มาใช้ซ้ำสำหรับบรรทัดคำสั่งสำหรับการจัดทำดัชนี lto (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/6791)
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --[no]incompatible_remove_legacy_whole_archive: "true"
หากเป็นจริง Bazel จะไม่ลิงก์ทรัพยากร Dependency ของไลบรารีเป็นที่เก็บถาวรทั้งหมดโดยค่าเริ่มต้น (ดูวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/7362)
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --[no]incompatible_require_ctx_in_configure_features: "true"
หากเป็นจริง Bazel จะต้องใช้ "ctx" ใน cc_common.configure_features (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/7793)
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --[no]interface_shared_objects: "true"
ใช้ออบเจ็กต์ที่ใช้ร่วมกันของอินเทอร์เฟซ หาก Toolchain รองรับ เครื่องมือเชน ELF ทั้งหมดรองรับการตั้งค่านี้ในขณะนี้
แท็ก: loading_and_analysis, affects_outputs, affects_outputs
ค่าเริ่มต้น --ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ดูคำอธิบาย
ระบุเวอร์ชันของ iOS SDK ที่จะใช้สร้างแอปพลิเคชัน iOS หากไม่ระบุ ระบบจะใช้เวอร์ชันเริ่มต้นของ iOS SDK จาก "xcode_version"
แท็ก: loses_incremental_state
ค่าเริ่มต้น --macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ดูคำอธิบาย
ระบุเวอร์ชันของ macOS SDK ที่จะใช้สร้างแอปพลิเคชัน macOS หากไม่ระบุ ระบบจะใช้เวอร์ชันเริ่มต้นของ macOS SDK จาก "xcode_version"
แท็ก: loses_incremental_state
ค่าเริ่มต้น --minimum_os_version=<a string>: ดูคำอธิบาย
เวอร์ชันระบบปฏิบัติการขั้นต่ำที่การคอมไพล์กำหนดเป้าหมาย
แท็ก: loading_and_analysis affects_outputs
ค่าเริ่มต้นของ --platform_mappings=<a relative path>: ""
ตำแหน่งของไฟล์การแมปที่อธิบายแพลตฟอร์มที่จะใช้หากไม่ได้ตั้งค่าไว้ หรือแฟล็กที่จะตั้งค่าเมื่อมีแพลตฟอร์มอยู่แล้ว ต้องสัมพัทธ์กับรูทของพื้นที่ทำงานหลัก มีค่าเริ่มต้นเป็น "platform_mappings" (ไฟล์ที่อยู่ภายใต้รูทของพื้นที่ทำงานโดยตรง)
แท็ก: affects_outputs, changes_inputs, loading_and_analysis
ค่าเริ่มต้นของ --platforms=<a build target label>: ""
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายแพลตฟอร์มเป้าหมายสำหรับคำสั่งปัจจุบัน
แท็ก: affects_outputs, changes_inputs, loading_and_analysis
ค่าเริ่มต้น --python2_path=<a string>: ดูคำอธิบาย
เลิกใช้งานแล้ว ไม่มีการดำเนินการ ปิดใช้โดย "--incompatible_use_python_toolchains"
แท็ก: no_op, deprecated
ค่าเริ่มต้น --python3_path=<a string>: ดูคำอธิบาย
เลิกใช้งานแล้ว ไม่มีการดำเนินการ ปิดใช้โดย "--incompatible_use_python_toolchains"
แท็ก: no_op, deprecated
ค่าเริ่มต้น --python_path=<a string>: ดูคำอธิบาย
Absolute Path ของล่าม Python มีการเรียกใช้เป้าหมาย Python บนแพลตฟอร์มเป้าหมาย เลิกใช้งาน; ปิดใช้งานโดย --incompatible_use_python_toolchains
แท็ก: loading_and_analysis affects_outputs
ค่าเริ่มต้น --python_top=<a build target label>: ดูคำอธิบาย
ป้ายกำกับของ py_runtime ที่แทนอินเทอร์พรีเตอร์ Python ได้มีการเรียกให้เรียกใช้เป้าหมาย Python บนแพลตฟอร์มเป้าหมาย เลิกใช้งาน; ปิดใช้งานโดย --incompatible_use_python_toolchains
แท็ก: loading_and_analysis affects_outputs
ค่าเริ่มต้น --tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ดูคำอธิบาย
ระบุเวอร์ชันของ tvOS SDK ที่จะใช้สร้างแอปพลิเคชัน tvOS หากไม่ระบุ ระบบจะใช้เวอร์ชันเริ่มต้นของ tvOS SDK จาก "xcode_version"
แท็ก: loses_incremental_state
ค่าเริ่มต้น --watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ดูคำอธิบาย
ระบุเวอร์ชันของ WatchOS SDK ที่จะใช้สร้างแอปพลิเคชัน watchOS หากไม่ระบุ ระบบจะใช้เวอร์ชัน WatchOS SDK เริ่มต้นจาก "xcode_version"
แท็ก: loses_incremental_state
ค่าเริ่มต้น --xcode_version=<a string>: ดูคำอธิบาย
หากระบุไว้ ให้ใช้ Xcode ของเวอร์ชันที่ระบุสำหรับการดำเนินการของบิลด์ที่เกี่ยวข้อง หากไม่ระบุ ระบบจะใช้ Xcode เวอร์ชันเริ่มต้นของผู้ดำเนินการ
แท็ก: loses_incremental_state
--xcode_version_config=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/cpp:host_xcodes"
ป้ายกำกับของกฎ xcode_config ที่จะใช้สำหรับเลือกเวอร์ชัน Xcode ในการกำหนดค่าบิลด์
แท็ก: loses_incremental_state loading_and_analysis
ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่ง
มีดังนี้
ค่าเริ่มต้น --[no]apple_generate_dsym: "เท็จ"
เลือกว่าจะสร้างไฟล์สัญลักษณ์การแก้ไขข้อบกพร่อง (.dSYM) หรือไม่
แท็ก: affects_outputs action_command_lines
หากเป็น "จริง" ให้สร้างศูนย์การเรียกใช้ไฟล์ symlink สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้เขียนเมื่อต้องใช้การดำเนินการในเครื่อง ทดสอบ หรือเรียกใช้คำสั่งเท่านั้น
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]build_runfile_manifests: "true"
หากเป็น "จริง" ให้เขียนไฟล์ Manifest ของการเรียกใช้ไฟล์สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้ละเว้น การทดสอบในเครื่องจะทํางานไม่ได้หากเป็นเท็จ
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]build_test_dwp: "เท็จ"
หากเปิดใช้ เมื่อสร้างการทดสอบ C++ แบบคงที่ และด้วยฟิชชัน ไฟล์ .dwp สำหรับไบนารีการทดสอบจะสร้างขึ้นโดยอัตโนมัติเช่นกัน
แท็ก: loading_and_analysis affects_outputs
ค่าเริ่มต้นของ --cc_proto_library_header_suffixes=<comma-separated set of options>: ".pb.h"
ตั้งค่าคำต่อท้ายของไฟล์ส่วนหัวที่ cc_proto_library สร้างขึ้น
แท็ก: affects_outputs loading_and_analysis
ค่าเริ่มต้น --cc_proto_library_source_suffixes=<comma-separated set of options>: ".pb.cc"
ตั้งค่าคำต่อท้ายของไฟล์ต้นฉบับที่ cc_protocol_library สร้างขึ้น
แท็ก: affects_outputs loading_and_analysis
ค่าเริ่มต้น --[no]experimental_proto_descriptor_sets_include_source_info: "เท็จ"
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันอื่นๆ ใน protocol_library
แท็ก: affects_outputs, loading_and_analysis, experimental
ค่าเริ่มต้น --[no]experimental_proto_extra_actions: "เท็จ"
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันอื่นๆ ใน protocol_library
แท็ก: affects_outputs, loading_and_analysis, experimental
ค่าเริ่มต้น --[no]experimental_save_feature_state: "เท็จ"
บันทึกสถานะของฟีเจอร์ที่เปิดใช้และที่ขอเป็นเอาต์พุตของการคอมไพล์
แท็ก: affects_outputs experimental
ค่าเริ่มต้น --fission=<a set of compilation modes>: "ไม่"
ระบุโหมดการคอมไพล์ที่ใช้ฟิชชันสําหรับการคอมไพล์และลิงก์ C++ อาจเป็นชุดค่าผสมใดๆ ของ {'fastbuild', 'dbg', 'opt'} หรือค่าพิเศษ 'yes' เพื่อเปิดทุกโหมดและ "ไม่" เพื่อปิดใช้โหมดทั้งหมด
แท็ก: loading_and_analysis, action_command_lines, affects_outputs
ค่าเริ่มต้น --[no]incompatible_always_include_files_in_data: "true"
หากเป็นจริง กฎของระบบจะเพิ่ม <code>DefaultInfo.files</code> ของทรัพยากร Dependency ไปยังไฟล์รันไทม์ ซึ่งตรงกับลักษณะการทำงานที่แนะนำสำหรับกฎของ Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid)
แท็ก: affects_outputs incompatible_change
ค่าเริ่มต้น --[no]legacy_external_runfiles: "true"
หากเป็น "จริง" ให้สร้างฟอเรสต์ Runfiles symlink สำหรับที่เก็บภายนอกภายใต้ .runfiles/wsname/external/repo (นอกเหนือจาก .runfiles/repo)
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]objc_generate_linkmap: "เท็จ"
ระบุว่าจะสร้างไฟล์ linkmap หรือไม่
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]save_temps: "เท็จ"
หากตั้งค่าไว้ ระบบจะบันทึกเอาต์พุตชั่วคราวจาก gcc ไฟล์เหล่านี้รวมถึงไฟล์ .s (โค้ด Ascyclr), ไฟล์ .i (C ที่ประมวลผลล่วงหน้า) และ .ii (C++ ที่ประมวลผลล่วงหน้า)
แท็ก: affects_outputs
ตัวเลือกที่ให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการได้ โดยให้ส่งผลต่อค่าของเอาต์พุตแทนค่าที่มีอยู่
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --action_env=<a 'name=value' assignment with an optional value part> รายการ
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกำหนดค่าเป้าหมาย คุณระบุตัวแปรได้ด้วยชื่อ ซึ่งในกรณีนี้ระบบจะนําค่าจากสภาพแวดล้อมการเรียกใช้ หรือคู่ name=value ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ ตัวเลือกนี้ใช้ได้หลายครั้ง สำหรับตัวเลือกที่ระบุสำหรับตัวแปรเดียวกัน ค่าที่ชนะล่าสุด และตัวเลือกของตัวแปรต่างๆ จะสะสมอยู่
แท็ก: action_command_lines
ค่าเริ่มต้นของ --android_cpu=<a string>: "armeabi-v7a"
CPU เป้าหมายของ Android
แท็ก: affects_outputs, loading_and_analysis, loses_incremental_state
ค่าเริ่มต้น --[no]android_databinding_use_androidx: "true"
สร้างไฟล์การเชื่อมโยงข้อมูลที่ใช้กับ AndroidX ได้ ใช้ได้เฉพาะกับการเชื่อมโยงข้อมูล v2 เท่านั้น แฟล็กนี้ไม่มีการใช้งาน
แท็ก: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
ค่าเริ่มต้น --[no]android_databinding_use_v3_4_args: "true"
ใช้ Android Databinding v2 ที่มีอาร์กิวเมนต์ 3.4.0 แฟล็กนี้ไม่มีการใช้งาน
แท็ก: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
ค่าเริ่มต้นของ --android_dynamic_mode=<off, default or fully>: "ปิด"
กำหนดว่าจะให้ลิงก์ C++ ของกฎ Android แบบไดนามิกหรือไม่ เมื่อ cc_binary ไม่ได้สร้างไลบรารีที่ใช้ร่วมกันอย่างชัดแจ้ง "ค่าเริ่มต้น" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "สมบูรณ์" หมายความว่าไลบรารีทั้งหมดจะลิงก์แบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก: affects_outputs loading_and_analysis
ค่าเริ่มต้น --android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>: "ตามตัวอักษร"
ตั้งค่าลำดับของไฟล์ Manifest ที่ส่งไปยังการรวมไฟล์ Manifest สำหรับไบนารีของ Android อัลฟ่าหมายความว่าไฟล์ Manifest ได้รับการจัดเรียงตามเส้นทางที่สัมพันธ์กับผู้ดำเนินการ ALPHABETICAL_BY_CONFIGURATION หมายความว่าไฟล์ Manifest ได้รับการจัดเรียงตามเส้นทางที่สัมพันธ์กับไดเรกทอรีการกำหนดค่าภายในไดเรกทอรีเอาต์พุต DEPENDENCY หมายความว่าไฟล์ Manifest จะเรียงลำดับตามไฟล์ Manifest ของไลบรารีแต่ละรายการที่อยู่ก่อนไฟล์ Manifest ของทรัพยากร Dependency
แท็ก: action_command_lines execution
ค่าเริ่มต้น --[no]android_resource_shrinking: "เท็จ"
เปิดใช้การย่อทรัพยากรสำหรับ APK android_binary ที่ใช้ ProGuard
แท็ก: affects_outputs loading_and_analysis
ค่าเริ่มต้น --[no]build_python_zip: "อัตโนมัติ"
สร้าง ZIP ที่เป็นไฟล์ปฏิบัติการ Python ใน Windows และปิดบนแพลตฟอร์มอื่น
แท็ก: affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --catalyst_cpus=<comma-separated list of options> รายการ
รายชื่อสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple Catalyst
แท็ก: loses_incremental_state loading_and_analysis
ค่าเริ่มต้น --[no]collect_code_coverage: "เท็จ"
หากระบุไว้ Bazel จะใช้โค้ดเครื่องมือวัด (โดยใช้การใช้เครื่องมือแบบออฟไลน์หากเป็นไปได้) และจะรวบรวมข้อมูลการครอบคลุมระหว่างการทดสอบ เฉพาะเป้าหมายที่ตรงกับ --instrumentation_filter จะได้รับผลกระทบ โดยปกติ ตัวเลือกนี้ไม่ควรระบุโดยตรง - "ความครอบคลุมของbazel" ควรใช้คำสั่งแทน
แท็ก: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] ค่าเริ่มต้น: "fastbuild"
ระบุโหมดที่จะมีการสร้างไบนารี ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก: affects_outputs action_command_lines
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --conlyopt=<a string> รายการ
ตัวเลือกเพิ่มเติมสำหรับส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C
แท็ก: action_command_lines affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --copt=<a string> รายการ
ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง gcc
แท็ก: action_command_lines affects_outputs
ค่าเริ่มต้นของ --cpu=<a string>: ""
CPU เป้าหมาย
แท็ก: changes_inputs affects_outputs
ค่าเริ่มต้น --cs_fdo_absolute_path=<a string>: ดูคำอธิบาย
ใช้ข้อมูลโปรไฟล์ CSFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อเส้นทางสัมบูรณ์ของไฟล์ ZIP ที่มีไฟล์โปรไฟล์, ไฟล์ข้อมูล RAW หรือไฟล์โปรไฟล์ LLVM ที่จัดทำดัชนีไว้
แท็ก: affects_outputs
ค่าเริ่มต้น --cs_fdo_instrument=<a string>: ดูคำอธิบาย
สร้างไบนารีด้วยเครื่องมือ FDO ที่ละเอียดอ่อนตามบริบท เมื่อใช้คอมไพเลอร์ Clang/LLVM คีย์ดังกล่าวจะยอมรับชื่อไดเรกทอรีที่ระบบจะส่งออกไฟล์โปรไฟล์แบบ RAW ขณะรันไทม์ด้วย
แท็ก: affects_outputs
ค่าเริ่มต้น --cs_fdo_profile=<a build target label>: ดูคำอธิบาย
cs_fdo_profile แสดงถึงโปรไฟล์ที่ละเอียดอ่อนตามบริบทที่จะใช้ในการเพิ่มประสิทธิภาพ
แท็ก: affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --cxxopt=<a string> รายการ
ตัวเลือกเพิ่มเติมสำหรับส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C++
แท็ก: action_command_lines affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --define=<a 'name=value' assignment> รายการ
ตัวเลือก --define แต่ละรายการจะระบุการมอบหมายสำหรับตัวแปรบิลด์
แท็ก: changes_inputs affects_outputs
ค่าเริ่มต้น --dynamic_mode=<off, default or fully>: "ค่าเริ่มต้น"
กำหนดว่าจะลิงก์ไบนารีของ C++ แบบไดนามิกหรือไม่ "ค่าเริ่มต้น" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "สมบูรณ์" หมายความว่าไลบรารีทั้งหมดจะลิงก์แบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก: loading_and_analysis affects_outputs
ค่าเริ่มต้น --[no]enable_fdo_profile_absolute_path: "true"
หากตั้งค่าไว้ การใช้ fdo_absolute_profile_path จะทำให้เกิดข้อผิดพลาด
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]enable_runfiles: "อัตโนมัติ"
เปิดใช้โครงสร้างลิงก์สัญลักษณ์ของ Runfiles ซึ่งโดยค่าเริ่มต้น จะปิดอยู่ใน Windows และในแพลตฟอร์มอื่นๆ
แท็ก: affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --experimental_action_listener=<a build target label> รายการ
เลิกใช้งานไปทีละด้าน ใช้ action_listener เพื่อแนบทางลัดไปยังการดำเนินการบิลด์ที่มีอยู่
แท็ก: execution experimental
ค่าเริ่มต้น --[no]experimental_android_compress_java_resources: "เท็จ"
บีบอัดทรัพยากร Java ใน APK
แท็ก: affects_outputs, loading_and_analysis, experimental
ค่าเริ่มต้น --[no]experimental_android_databinding_v2: "true"
ใช้ Android Data Binding v2 แฟล็กนี้ไม่มีการใช้งาน
แท็ก: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
ค่าเริ่มต้น --[no]experimental_android_resource_shrinking: "เท็จ"
เปิดใช้การย่อทรัพยากรสำหรับ APK android_binary ที่ใช้ ProGuard
แท็ก: affects_outputs loading_and_analysis
ค่าเริ่มต้น --[no]experimental_android_rewrite_dexes_with_rex: "เท็จ"
ใช้เครื่องมือ Rex เพื่อเขียนไฟล์ dex ใหม่
แท็ก: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
ค่าเริ่มต้น --[no]experimental_collect_code_coverage_for_generated_files: "เท็จ"
หากระบุไว้ Bazel จะสร้างการรวบรวมข้อมูลที่ครอบคลุมสำหรับไฟล์ที่สร้างขึ้นด้วย
แท็ก: affects_outputs
ค่าเริ่มต้น --experimental_objc_fastbuild_options=<comma-separated list of options>: "-O0,-DDEBUG=1"
ใช้สตริงเหล่านี้เป็นตัวเลือกคอมไพเลอร์ objc Fastbuild
แท็ก: action_command_lines
ค่าเริ่มต้น --[no]experimental_omitfp: "เท็จ"
หากเป็น "จริง" ให้ใช้ libunwind สำหรับการคลายสแต็ก แล้วคอมไพล์ด้วย -fomit-frame-pointer และ -fasynchronous-unwind-tables
แท็ก: action_command_lines, affects_outputs, experimental
ค่าเริ่มต้นของ --experimental_output_paths=<off, content or strip>: "ปิด"
โมเดลที่ควรใช้สำหรับส่วนใดในกฎแผนผังเอาต์พุตจะเขียนเอาต์พุต โดยเฉพาะอย่างยิ่งสำหรับบิลด์ที่มีหลายแพลตฟอร์ม / หลายการกำหนดค่า ฟีเจอร์นี้อยู่ในขั้นทดลอง ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/6526 การดำเนินการของ Starlark เลือกใช้การแมปเส้นทางได้ด้วยการเพิ่มคีย์ "supports-path-mapping" เป็น "execution_requirements" พิมพ์ตามคำบอก
แท็ก: loses_incremental_state, bazel_internal_configuration, affects_outputs, execution
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --experimental_override_name_platform_in_output_dir=<a 'label=value' assignment> รายการ
แต่ละรายการควรอยู่ในรูปแบบ label=value โดยที่ป้ายกำกับอ้างอิงถึงแพลตฟอร์ม และค่าคือชื่อย่อที่ต้องการใช้ในเส้นทางเอาต์พุต ใช้เมื่อ --experimental_platform_in_output_dir เป็นจริงเท่านั้น มีลำดับความสำคัญในการตั้งชื่อสูงสุด
แท็ก: affects_outputs experimental
ค่าเริ่มต้น --[no]experimental_platform_in_output_dir: "เท็จ"
หากเป็นจริง ระบบจะใช้ชื่อย่อของแพลตฟอร์มเป้าหมายในชื่อไดเรกทอรีเอาต์พุตแทน CPU รูปแบบที่แน่นอนอยู่ในขั้นทดลองและอาจมีการเปลี่ยนแปลง อย่างแรก ในกรณีซึ่งเกิดขึ้นไม่บ่อยนัก ตัวเลือก --platforms ไม่ได้มีค่าเพียงค่าเดียว ระบบจะใช้แฮชของตัวเลือกแพลตฟอร์ม ถัดไป หากชื่อย่อของแพลตฟอร์มปัจจุบันลงทะเบียนโดย --experimental_override_name_platform_in_output_dir ระบบจะใช้ชื่อย่อนั้น จากนั้น หากมีการตั้งค่า --experimental_use_platforms_in_output_dir_legacy_heurism ให้ใช้ชื่อย่อที่อ้างอิงจากป้ายกำกับแพลตฟอร์มปัจจุบัน สุดท้าย ระบบจะใช้แฮชของตัวเลือกแพลตฟอร์มเป็นทางเลือกสุดท้าย
แท็ก: affects_outputs experimental
ค่าเริ่มต้น --[no]experimental_use_llvm_covmap: "เท็จ"
หากระบุ Bazel จะสร้างข้อมูลแผนที่ความครอบคลุมของ llvm-cov แทนที่จะเป็น gcov เมื่อเปิดใช้งานcollect_code_coverage
แท็ก: changes_inputs, affects_outputs, loading_and_analysis, experimental
ค่าเริ่มต้น --[no]experimental_use_platforms_in_output_dir_legacy_heuristic: "true"
โปรดใช้แฟล็กนี้เป็นส่วนหนึ่งของกลยุทธ์การย้ายข้อมูลหรือการทดสอบที่แนะนำเท่านั้น โปรดทราบว่าการเรียนรู้มีข้อบกพร่องที่ทราบแล้ว และแนะนำให้เปลี่ยนไปใช้เพียง --experimental_override_name_platform_in_output_dir
แท็ก: affects_outputs experimental
ค่าเริ่มต้นของ --fat_apk_cpu=<comma-separated set of options>: "armeabi-v7a"
การตั้งค่าตัวเลือกนี้จะเปิดใช้ APK แบบอ้วน ซึ่งมีไบนารีแบบเนทีฟสำหรับสถาปัตยกรรมเป้าหมายที่ระบุทั้งหมด เช่น --fat_apk_cpu=x86,armeabi-v7a. หากระบุแฟล็กนี้ ระบบจะละเว้น --android_cpu สำหรับทรัพยากร Dependency ของกฎ android_binary
แท็ก: affects_outputs, loading_and_analysis, loses_incremental_state
ค่าเริ่มต้น --[no]fat_apk_hwasan: "เท็จ"
เลือกว่าจะสร้างการแยก HWASAN หรือไม่
แท็ก: affects_outputs, loading_and_analysis, loses_incremental_state
ค่าเริ่มต้น --fdo_instrument=<a string>: ดูคำอธิบาย
สร้างไบนารีด้วยเครื่องมือ FDO เมื่อใช้คอมไพเลอร์ Clang/LLVM คีย์ดังกล่าวจะยอมรับชื่อไดเรกทอรีที่ระบบจะส่งออกไฟล์โปรไฟล์แบบ RAW ขณะรันไทม์ด้วย
แท็ก: affects_outputs
ค่าเริ่มต้น --fdo_optimize=<a string>: ดูคำอธิบาย
ใช้ข้อมูลโปรไฟล์ FDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อไฟล์ ZIP ที่มีแผนผังไฟล์ .gcda, ไฟล์ afdo ที่มีโปรไฟล์อัตโนมัติ หรือไฟล์โปรไฟล์ LLVM แฟล็กนี้ยอมรับไฟล์ที่ระบุเป็นป้ายกำกับด้วย (เช่น "//foo/bar:file.afdo" คุณอาจต้องเพิ่มคำสั่ง "exports_files" ไปยังแพ็กเกจที่เกี่ยวข้อง) และป้ายกำกับที่ชี้ไปยังเป้าหมาย "fdo_profile" การตั้งค่าสถานะนี้จะถูกแทนที่โดยกฎ "fdo_profile"
แท็ก: affects_outputs
ค่าเริ่มต้น --fdo_prefetch_hints=<a build target label>: ดูคำอธิบาย
ใช้คำแนะนำการดึงข้อมูลแคชล่วงหน้า
แท็ก: affects_outputs
ค่าเริ่มต้น --fdo_profile=<a build target label>: ดูคำอธิบาย
fdo_profile แทนโปรไฟล์ที่จะใช้ในการเพิ่มประสิทธิภาพ
แท็ก: affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --features=<a string> รายการ
ระบบจะเปิดใช้หรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างขึ้นในการกำหนดค่าเป้าหมาย กำลังระบุ -<feature> จะปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ ดูเพิ่มเติมที่ --host_features
แท็ก: changes_inputs affects_outputs
ค่าเริ่มต้น --[no]force_pic: "เท็จ"
หากเปิดใช้งาน การคอมไพล์ C++ ทั้งหมดจะสร้างโค้ดที่ไม่ขึ้นอยู่กับตำแหน่ง ("-fPIC") ลิงก์จะใช้ไลบรารีที่สร้างไว้ล่วงหน้าของ PIC มากกว่าไลบรารีที่ไม่ใช่ PIC และลิงก์จะสร้างไฟล์ปฏิบัติการที่ไม่ขึ้นอยู่กับตำแหน่ง ("-pie")
แท็ก: loading_and_analysis affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --host_action_env=<a 'name=value' assignment with an optional value part> รายการ
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกำหนดค่าการดำเนินการ คุณระบุตัวแปรได้ด้วยชื่อ ซึ่งในกรณีนี้ระบบจะนําค่าจากสภาพแวดล้อมการเรียกใช้ หรือคู่ name=value ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ ตัวเลือกนี้ใช้ได้หลายครั้ง สำหรับตัวเลือกที่ระบุสำหรับตัวแปรเดียวกัน ค่าที่ชนะล่าสุด และตัวเลือกของตัวแปรต่างๆ จะสะสมอยู่
แท็ก: action_command_lines
ค่าเริ่มต้นของ --host_compilation_mode=<fastbuild, dbg or opt>: "opt"
ระบุโหมดที่จะมีการสร้างเครื่องมือที่ใช้ในการสร้าง ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก: affects_outputs action_command_lines
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --host_conlyopt=<a string> รายการ
ตัวเลือกเพิ่มเติมในการส่งไปยังคอมไพเลอร์ C เมื่อคอมไพล์ไฟล์ต้นฉบับ C (ไม่ใช่ C++) ในการกำหนดค่าผู้บริหาร
แท็ก: action_command_lines affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --host_copt=<a string> รายการ
ตัวเลือกเพิ่มเติมเพื่อส่งไปยังคอมไพเลอร์ C สำหรับเครื่องมือที่สร้างขึ้นในการกำหนดค่าการดำเนินการ
แท็ก: action_command_lines affects_outputs
ค่าเริ่มต้นของ --host_cpu=<a string>: ""
CPU ของโฮสต์
แท็ก: changes_inputs affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --host_cxxopt=<a string> รายการ
ตัวเลือกเพิ่มเติมเพื่อส่งไปยังคอมไพเลอร์ C++ สำหรับเครื่องมือที่สร้างขึ้นในการกำหนดค่าดำเนินการ
แท็ก: action_command_lines affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --host_features=<a string> รายการ
ระบบจะเปิดใช้หรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างขึ้นในการกำหนดค่า exec กำลังระบุ -<feature> จะปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ
แท็ก: changes_inputs affects_outputs
ค่าเริ่มต้น --host_force_python=<PY2 or PY3>: ดูคำอธิบาย
ลบล้างเวอร์ชัน Python สำหรับการกำหนดค่า exec อาจเป็น "PY2" หรือ "PY3"
แท็ก: loading_and_analysis affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --host_linkopt=<a string> รายการ
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง Linker เมื่อลิงก์เครื่องมือในการกำหนดค่าการดำเนินการ
แท็ก: action_command_lines affects_outputs
ค่าเริ่มต้น --host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ดูคำอธิบาย
เวอร์ชัน macOS ที่เข้ากันได้ขั้นต่ำสำหรับเป้าหมายโฮสต์ หากไม่ได้ระบุ ให้ใช้ "macos_sdk_version"
แท็ก: loses_incremental_state
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options> รายการ
ตัวเลือกเพิ่มเติมเพื่อเลือกส่งไปยังคอมไพเลอร์ C/C++ ที่เลือกเมื่อคอมไพล์ไฟล์บางไฟล์ในการกำหนดค่าผู้บริหาร ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจากรายการรวมและไม่รวมรูปแบบนิพจน์ทั่วไป (ดู --instrumentation_filter) ด้วย Option_1 กับ Option_n นั้นย่อมาจากตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ ในการแยกสตริงจะใช้เฉพาะ @ แรกเท่านั้น ตัวอย่าง: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก: action_command_lines affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --host_swiftcopt=<a string> รายการ
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง Swiftc สำหรับเครื่องมือผู้บริหาร
แท็ก: action_command_lines affects_outputs
ค่าเริ่มต้น --[no]incompatible_auto_exec_groups: "เท็จ"
เมื่อเปิดใช้ ระบบจะสร้างกลุ่มผู้บริหารสำหรับ Toolchain แต่ละรายการที่กฎใช้โดยอัตโนมัติ กฎในการทำงานนี้ต้องระบุพารามิเตอร์ "toolchain" ในการดำเนินการ ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/17134
แท็ก: affects_outputs incompatible_change
ค่าเริ่มต้น --[no]incompatible_merge_genfiles_directory: "true"
หากเป็นจริง ไดเรกทอรี genfiles จะถูกพับลงในไดเรกทอรี bin
แท็ก: affects_outputs incompatible_change
ค่าเริ่มต้น --[no]incompatible_use_host_features: "true"
หากเป็นจริง ให้ใช้ --features สำหรับการกำหนดค่าเป้าหมายเท่านั้น และ --host_features สำหรับการกำหนดค่า exec
แท็ก: changes_inputs, affects_outputs, incompatible_change
ค่าเริ่มต้น --[no]instrument_test_targets: "เท็จ"
เมื่อเปิดใช้การครอบคลุม ให้ระบุว่าจะพิจารณาการใช้กฎการทดสอบการวัดคุมหรือไม่ เมื่อตั้งค่าแล้ว กฎการทดสอบที่ --instrumentation_filter รวมอยู่จะมีการวัดคุม มิฉะนั้น กฎการทดสอบจะถูกยกเว้นจากการวัดคุมการครอบคลุมเสมอ
แท็ก: affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> ค่าเริ่มต้น: "-/javatests[/:],-/test/java[/:]"
เมื่อเปิดใช้การครอบคลุม ระบบจะวัดเฉพาะกฎที่มีชื่อซึ่งตัวกรองตามนิพจน์ทั่วไปที่ระบุรวมอยู่เท่านั้น กฎที่ขึ้นต้นด้วย "-" จะได้รับการยกเว้นแทน โปรดทราบว่าระบบจะวัดคุมเฉพาะกฎที่ไม่ใช่การทดสอบเท่านั้น ยกเว้นกรณีที่เปิดใช้งาน --instrument_test_targets
แท็ก: affects_outputs
ค่าเริ่มต้น --ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ดูคำอธิบาย
เวอร์ชัน iOS ที่เข้ากันได้ขั้นต่ำสำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ระบุ ให้ใช้ "ios_sdk_version"
แท็ก: loses_incremental_state
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --ios_multi_cpus=<comma-separated list of options> รายการ
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างแอปพลิเคชัน ios_ ผลลัพธ์จะเป็นไบนารีสากลที่มีสถาปัตยกรรมที่ระบุทั้งหมด
แท็ก: loses_incremental_state loading_and_analysis
ค่าเริ่มต้น --[no]legacy_whole_archive: "true"
เลิกใช้งานแล้ว และมีผลแทนด้วย --inสามารถเข้าถึง_remove_legacy_whole_archive (ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7362) เมื่อเปิด ให้ใช้ --whole-archive สำหรับกฎ cc_binary ที่มี linkshared=True และ linkstatic=True หรือ '-static' ใน Linkopts วิธีนี้ใช้สำหรับความเข้ากันได้แบบย้อนหลังเท่านั้น อีกทางเลือกหนึ่งที่ดีกว่าคือการใช้ Alwayslink=1 เมื่อจำเป็น
แท็ก: action_command_lines, affects_outputs, deprecated
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --linkopt=<a string> รายการ
ตัวเลือกเพิ่มเติมในการส่งไปยัง gcc เมื่อลิงก์
แท็ก: action_command_lines affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --ltobackendopt=<a string> รายการ
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังขั้นตอนแบ็กเอนด์ของ LTO (ในส่วน --features=thin_lto)
แท็ก: action_command_lines affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --ltoindexopt=<a string> รายการ
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังขั้นตอนการจัดทำดัชนี LTO (ในส่วน --features=thin_lto)
แท็ก: action_command_lines affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --macos_cpus=<comma-separated list of options> รายการ
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple macOS
แท็ก: loses_incremental_state loading_and_analysis
ค่าเริ่มต้น --macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ดูคำอธิบาย
เวอร์ชัน macOS ที่เข้ากันได้ขั้นต่ำสำหรับเป้าหมาย หากไม่ได้ระบุ ให้ใช้ "macos_sdk_version"
แท็ก: loses_incremental_state
ค่าเริ่มต้น --memprof_profile=<a build target label>: ดูคำอธิบาย
ใช้โปรไฟล์ Memprof
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]objc_debug_with_GLIBCXX: "เท็จ"
หากตั้งค่า และตั้งค่าโหมดการคอมไพล์เป็น "dbg" ให้กำหนด GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC และ GLIBCPP_CONCEPT_CHECKS
แท็ก: action_command_lines
ค่าเริ่มต้น --[no]objc_enable_binary_stripping: "เท็จ"
เลือกว่าจะดำเนินการลบสัญลักษณ์และโค้ดที่เสียหายในไบนารีที่ลิงก์หรือไม่ ระบบจะลบไบนารีหากระบุทั้ง Flag และ --compilation_mode=opt นี้
แท็ก: action_command_lines
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --objccopt=<a string> รายการ
ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ Objective-C/C++
แท็ก: action_command_lines
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options> รายการ
ตัวเลือกเพิ่มเติมในการส่งผ่านไปยัง gcc เฉพาะเมื่อคอมไพล์ไฟล์บางไฟล์ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจากรายการรวมและไม่รวมรูปแบบนิพจน์ทั่วไป (ดู --instrumentation_filter) ด้วย Option_1 กับ Option_n นั้นย่อมาจากตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ ในการแยกสตริงจะใช้เฉพาะ @ แรกเท่านั้น ตัวอย่าง: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก: action_command_lines affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options> รายการ
ตัวเลือกเพิ่มเติมสำหรับเลือกส่งไปยังแบ็กเอนด์ LTO (ในส่วน --features=thin_lto) เมื่อคอมไพล์ออบเจ็กต์แบ็กเอนด์บางรายการ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจาก รายการรูปแบบ รวมและยกเว้น ของนิพจน์ทั่วไป Option_1 กับ Option_n นั้นย่อมาจากตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ ในการแยกสตริงจะใช้เฉพาะ @ แรกเท่านั้น ตัวอย่าง: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่งแบ็กเอนด์ LTO ของไฟล์ o ทั้งหมดใน //foo/ ยกเว้น bar.o
แท็ก: action_command_lines affects_outputs
ค่าเริ่มต้น --platform_suffix=<a string>: ดูคำอธิบาย
ระบุคำต่อท้ายที่จะเพิ่มในไดเรกทอรีการกำหนดค่า
แท็ก: loses_incremental_state, affects_outputs, loading_and_analysis
ค่าเริ่มต้น --propeller_optimize=<a build target label>: ดูคำอธิบาย
ใช้ข้อมูลโปรไฟล์ Propeller เพื่อเพิ่มประสิทธิภาพเป้าหมายของบิลด์ โปรไฟล์ใบพัดต้องประกอบด้วยไฟล์อย่างน้อย 1 จาก 2 ไฟล์ โปรไฟล์สำเนา และโปรไฟล์ ld แฟล็กนี้ยอมรับป้ายกำกับบิลด์ซึ่งต้องอ้างถึงไฟล์อินพุตโปรไฟล์ใบพัด ตัวอย่างเช่น ไฟล์ BUILD ที่กำหนดป้ายกำกับใน a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)อาจต้องเพิ่มคำสั่ง ecommerce_files ลงในแพ็กเกจที่เกี่ยวข้องเพื่อให้ Bazel มองเห็นไฟล์เหล่านี้ ต้องใช้ตัวเลือกเป็น: --propeller_optimize=//a/b:propeller_profile
แท็ก: action_command_lines affects_outputs
ค่าเริ่มต้น --propeller_optimize_absolute_cc_profile=<a string>: ดูคำอธิบาย
ชื่อเส้นทางสัมบูรณ์ของไฟล์ cc_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพใบพัด
แท็ก: affects_outputs
ค่าเริ่มต้น --propeller_optimize_absolute_ld_profile=<a string>: ดูคำอธิบาย
ชื่อเส้นทางสัมบูรณ์ของไฟล์ ld_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพใบพัด
แท็ก: affects_outputs
ค่าเริ่มต้น --run_under=<a prefix in front of command>: ดูคำอธิบาย
คำนำหน้าที่จะแทรกก่อนไฟล์ปฏิบัติการสำหรับ "การทดสอบ" และ "เรียกใช้" คำสั่ง หากค่าคือ "foo -bar" และบรรทัดคำสั่งสำหรับการดำเนินการคือ "test_binary -baz" บรรทัดคำสั่งสุดท้ายคือ "foo -bar test_binary -baz" บรรทัดคำสั่งนี้อาจเป็นป้ายกำกับของเป้าหมายสั่งการได้ด้วย ตัวอย่างเช่น 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'
แท็ก: action_command_lines
ค่าเริ่มต้น --[no]share_native_deps: "true"
หากจริง ระบบจะแชร์ไลบรารีเนทีฟที่มีฟังก์ชันการทำงานเหมือนกันกับเป้าหมายต่างๆ
แท็ก: loading_and_analysis, affects_outputs
ค่าเริ่มต้น --[no]stamp: "เท็จ"
ประทับไบนารีด้วยวันที่ ชื่อผู้ใช้ ชื่อโฮสต์ ข้อมูลพื้นที่ทำงาน ฯลฯ
แท็ก: affects_outputs
ค่าเริ่มต้น --strip=<always, sometimes or never>: "บางครั้ง"
ระบุว่าจะตัดไบนารีและไลบรารีที่แชร์หรือไม่ (โดยใช้ "-Wl,--strip-debug") ค่าเริ่มต้นของ "บางครั้ง" หมายถึง Strip iff --compilation_mode=fastbuild
แท็ก: affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --stripopt=<a string> รายการ
ตัวเลือกเพิ่มเติมในการส่งไปยังการตัดเมื่อสร้าง "<name>.strped" 2.
แท็ก: action_command_lines affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --swiftcopt=<a string> รายการ
ตัวเลือกเพิ่มเติมเพื่อส่งไปยังการคอมไพล์ Swift
แท็ก: action_command_lines
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --tvos_cpus=<comma-separated list of options> รายการ
รายชื่อสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple tvOS
แท็ก: loses_incremental_state loading_and_analysis
ค่าเริ่มต้น --tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ดูคำอธิบาย
เวอร์ชัน tvOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ระบุ ให้ใช้ "tvos_sdk_version"
แท็ก: loses_incremental_state
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --visionos_cpus=<comma-separated list of options> รายการ
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple visionOS
แท็ก: loses_incremental_state loading_and_analysis
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --watchos_cpus=<comma-separated list of options> รายการ
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple WatchOS
แท็ก: loses_incremental_state loading_and_analysis
ค่าเริ่มต้น --watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ดูคำอธิบาย
เวอร์ชัน WatchOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ได้ระบุ ให้ใช้ "watchos_sdk_version"
แท็ก: loses_incremental_state
ค่าเริ่มต้น --xbinary_fdo=<a build target label>: ดูคำอธิบาย
ใช้ข้อมูลโปรไฟล์ XbinaryFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อของโปรไฟล์แบบไบนารีที่เป็นค่าเริ่มต้น เมื่อใช้ตัวเลือกนี้ร่วมกับ --fdo_instrument/--fdo_optimize/--fdo_profile ตัวเลือกเหล่านั้นจะมีผลเหนือกว่าเสมอเสมือนว่าไม่ได้ระบุ xbinary_fdo
แท็ก: affects_outputs
ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตบิลด์ที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมธง ฯลฯ)
ค่าเริ่มต้นของ --auto_cpu_environment_group=<a build target label>: ""
ประกาศ cloud_group ที่จะใช้ในการแมปค่า CPU กับค่า target_environment โดยอัตโนมัติ
แท็ก: changes_inputs, loading_and_analysis, experimental
ค่าเริ่มต้น --[no]check_licenses: "เท็จ"
ตรวจสอบว่าข้อจำกัดในการออกใบอนุญาตที่กำหนดโดยแพ็กเกจที่เกี่ยวข้องไม่ขัดแย้งกับโหมดการเผยแพร่ของเป้าหมายที่กำลังสร้าง โดยค่าเริ่มต้น ใบอนุญาตจะไม่ได้รับการตรวจสอบ
แท็ก: build_file_semantics
ค่าเริ่มต้น --[no]check_visibility: "true"
หากปิดใช้ ระบบจะลดระดับข้อผิดพลาดระดับการเข้าถึงในทรัพยากร Dependency เป้าหมายให้เหลือเพียงคําเตือน
แท็ก: build_file_semantics
ค่าเริ่มต้น --[no]desugar_for_android: "true"
เลือกว่าจะใช้ไบต์โค้ด Java 8 ก่อนถอดรหัสหรือไม่
แท็ก: affects_outputs, loading_and_analysis, loses_incremental_state
ค่าเริ่มต้น --[no]desugar_java8_libs: "เท็จ"
เลือกว่าจะรวมไลบรารี Java 8 ที่รองรับในแอปสำหรับอุปกรณ์เดิมหรือไม่
แท็ก: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
ค่าเริ่มต้น --[no]enforce_constraints: "true"
ตรวจสอบสภาพแวดล้อมที่แต่ละเป้าหมายใช้งานร่วมกันได้ และรายงานข้อผิดพลาดหากเป้าหมายมีทรัพยากร Dependency ที่ไม่รองรับสภาพแวดล้อมเดียวกัน
แท็ก: build_file_semantics
ค่าเริ่มต้น --[no]experimental_check_desugar_deps: "true"
ตรวจสอบความถูกต้องของการแยกน้ำตาลที่ระดับไบนารีของ Android อีกครั้งหรือไม่
แท็ก: eagerness_to_exit, loading_and_analysis, experimental
ค่าเริ่มต้นของ --experimental_import_deps_checking=<off, warning or error>: "ปิด"
เมื่อเปิดใช้ ให้ตรวจสอบว่าทรัพยากร Dependency ของ aar_IMPORT เสร็จสมบูรณ์หรือไม่ การบังคับใช้นี้อาจทำให้บิลด์เสียหายหรืออาจทำให้เกิดคำเตือน
แท็ก: loading_and_analysis
ค่าเริ่มต้น --experimental_strict_java_deps=<off, warn, error, strict or default>: "ค่าเริ่มต้น"
หากเป็นจริง ให้ตรวจสอบว่าเป้าหมาย Java ประกาศเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency อย่างชัดเจน
แท็ก: build_file_semantics eagerness_to_exit
ค่าเริ่มต้น --[no]incompatible_check_testonly_for_output_files: "เท็จ"
หากเปิดใช้ ให้ตรวจสอบ testonly สำหรับเป้าหมายที่จำเป็นเบื้องต้นที่เป็นไฟล์เอาต์พุตโดยค้นหา testonly ของกฎที่สร้าง รายการนี้ตรงกับการตรวจสอบระดับการเข้าถึง
แท็ก: build_file_semantics incompatible_change
ค่าเริ่มต้น --[no]incompatible_check_visibility_for_toolchains: "เท็จ"
หากเปิดใช้ การตรวจสอบระดับการเข้าถึงจะมีผลกับการติดตั้งใช้งาน Toolchain ด้วย
แท็ก: build_file_semantics incompatible_change
ค่าเริ่มต้น --[no]incompatible_disable_native_android_rules: "เท็จ"
หากเปิดใช้ ระบบจะปิดใช้กฎที่มีอยู่สำหรับ Android โดยตรง โปรดใช้กฎของ Android Starlark จาก https://github.com/bazelbuild/rules_android
แท็ก: eagerness_to_exit incompatible_change
ค่าเริ่มต้น --[no]incompatible_disable_native_apple_binary_rule: "เท็จ"
ไม่มีการดำเนินการ เก็บไว้ที่นี่เพื่อดูความเข้ากันได้แบบย้อนหลัง
แท็ก: eagerness_to_exit incompatible_change
ค่าเริ่มต้น --[no]incompatible_python_disable_py2: "true"
หากเป็น "จริง" การใช้การตั้งค่า Python 2 จะทำให้เกิดข้อผิดพลาด ซึ่งรวมถึง python_version=PY2, srcs_version=PY2 และ srcs_version=PY2ONLY ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/15684
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --[no]incompatible_validate_top_level_header_inclusions: "true"
หากเป็นจริง Bazel จะตรวจสอบการรวมส่วนหัวไดเรกทอรีระดับบนสุดด้วย (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/10047)
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --python_native_rules_allowlist=<a build target label>: ดูคำอธิบาย
รายการที่อนุญาต (package_group target (เป้าหมายกลุ่มแพ็กเกจ) ที่จะใช้เมื่อบังคับใช้ --incompatible_python_disallow_native_rules
แท็ก: loading_and_analysis
ค่าเริ่มต้น --[no]strict_filesets: "เท็จ"
หากเปิดใช้ตัวเลือกนี้ ระบบจะรายงานว่าชุดไฟล์ข้ามขอบเขตของแพ็กเกจเป็นข้อผิดพลาด
แท็ก: build_file_semantics eagerness_to_exit
ค่าเริ่มต้น --strict_proto_deps=<off, warn, error, strict or default>: "ข้อผิดพลาด"
หากไม่ "ปิด" ให้ตรวจสอบว่าเป้าหมาย protocol_library ประกาศอย่างชัดแจ้งว่าเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency
แท็ก: build_file_semantics, eagerness_to_exit, incompatible_change
ค่าเริ่มต้นของ --strict_public_imports=<off, warn, error, strict or default>: "ปิด"
หากไม่ "ปิด" ให้ตรวจสอบว่าเป้าหมาย protocol_library ประกาศอย่างชัดเจนถึงเป้าหมายทั้งหมดที่ใช้ใน "นำเข้าสาธารณะ" ตามที่ส่งออกแล้ว
แท็ก: build_file_semantics, eagerness_to_exit, incompatible_change
ค่าเริ่มต้น --[no]strict_system_includes: "เท็จ"
หากเป็น "จริง" ส่วนหัวที่พบผ่านทางระบบรวมเส้นทาง (-isystem) ต้องมีการประกาศด้วย
แท็ก: loading_and_analysis eagerness_to_exit
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --target_environment=<a build target label> รายการ
ประกาศสภาพแวดล้อมเป้าหมายของบิลด์นี้ ต้องอ้างอิงถึงป้ายกำกับไปยัง "สภาพแวดล้อม" กฎ หากระบุ เป้าหมายระดับบนสุดทั้งหมดต้องเข้ากันได้กับสภาพแวดล้อมนี้
แท็ก: changes_inputs
ตัวเลือกที่มีผลต่อเอาต์พุตการลงชื่อของบิลด์:
ค่าเริ่มต้น --apk_signing_method=<v1, v2, v1_v2 or v4>: "v1_v2"
การใช้งานเพื่อรับรอง APK
แท็ก: action_command_lines, affects_outputs, loading_and_analysis
ค่าเริ่มต้น --[no]device_debug_entitlements: "true"
หากมีการตั้งค่า และโหมดการคอมไพล์ไม่ใช่ "เพิ่มประสิทธิภาพ" แอป objc จะรวมการให้สิทธิ์การแก้ไขข้อบกพร่องเมื่อลงชื่อ
แท็ก: changes_inputs
ค่าเริ่มต้น --ios_signing_cert_name=<a string>: ดูคำอธิบาย
ชื่อใบรับรองที่จะใช้สำหรับ iOS Signing หากไม่ได้ตั้งค่า ระบบจะกลับไปใช้โปรไฟล์การจัดสรร อาจเป็นค่ากำหนดข้อมูลประจำตัว Keychain ของใบรับรองหรือ (สตริงย่อย) ของชื่อสามัญของใบรับรองตามหน้า man ของ Codesign (รหัสการลงชื่อเข้าใช้)
แท็ก: action_command_lines
ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
ค่าเริ่มต้น --[no]incompatible_disallow_legacy_py_provider: "true"
ไม่มีการดำเนินการ จะถูกนำออกในเร็วๆ นี้
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --[no]incompatible_disallow_sdk_frameworks_attributes: "เท็จ"
หากเป็น "จริง" ไม่อนุญาตแอตทริบิวต์ sdk_frameworks และ external_sdk_frameworks ใน objc_library andobjc_import
แท็ก: build_file_semantics incompatible_change
หากเป็น "จริง" ตั้งค่าเริ่มต้นเป็น "จริง" สำหรับแอตทริบิวต์ Alwayslink ใน objc_library และ objc_IMPORT
แท็ก: build_file_semantics incompatible_change
ค่าเริ่มต้น --[no]incompatible_python_disallow_native_rules: "เท็จ"
เมื่อเป็นจริง เกิดข้อผิดพลาดขึ้นเมื่อใช้กฎ py_* ในตัว ควรใช้กฎ rules_python แทน ดูข้อมูลเพิ่มเติมและวิธีการย้ายข้อมูลได้ที่ https://github.com/bazelbuild/bazel/issues/17773
แท็ก: loading_and_analysis incompatible_change
ตัวเลือกที่ควบคุมพฤติกรรมของ
สภาพแวดล้อมการทดสอบหรือตัวดำเนินการทดสอบ:
ค่าเริ่มต้น --[no]allow_analysis_failures: "เท็จ"
หากจริง การวิเคราะห์เป้าหมายของกฎไม่สำเร็จส่งผลให้เกิดการเผยแพร่อินสแตนซ์ของ AnalysisFailureInfo ของเป้าหมายที่มีคำอธิบายข้อผิดพลาด แทนที่จะทำให้บิลด์ไม่สำเร็จ
แท็ก: loading_and_analysis experimental
ค่าเริ่มต้น --analysis_testing_deps_limit=<an integer>: "2000"
ตั้งค่าจำนวนสูงสุดของทรัพยากร Dependency แบบทรานซิทีฟผ่านแอตทริบิวต์กฎที่มีการเปลี่ยนการกำหนดค่า for_analysis_testing การใช้เกินขีดจำกัดนี้จะทำให้เกิดข้อผิดพลาดของกฎ
แท็ก: loading_and_analysis
ค่าเริ่มต้น --[no]break_build_on_parallel_dex2oat_failure: "เท็จ"
หากความล้มเหลวจริงในการดำเนินการ dex2oat จะทำให้บิลด์เสียหายแทนที่จะเรียกใช้ dex2oat ระหว่างรันไทม์ทดสอบ
แท็ก: loading_and_analysis experimental
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g. memory=10,30,60,100> รายการ
ลบล้างจำนวนทรัพยากรเริ่มต้นสำหรับการทดสอบ รูปแบบที่คาดไว้คือ <resource>=<value> หากระบุจำนวนบวกตัวเดียวเป็น <value> ระบบจะลบล้างทรัพยากรเริ่มต้นสำหรับขนาดทดสอบทั้งหมด หากระบุตัวเลขที่คั่นด้วยคอมมา 4 ตัว จำนวนดังกล่าวจะแทนที่จำนวนทรัพยากรสำหรับขนาดทดสอบขนาดเล็ก กลาง ใหญ่ และขนาดใหญ่ตามลำดับ ค่าอาจเป็น HOST_RAM/HOST_CPU (ไม่บังคับ) ตามด้วย [-|*]<Flo> (เช่น Memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4) ทรัพยากรการทดสอบเริ่มต้นที่ระบุโดยแฟล็กนี้จะถูกลบล้างโดยทรัพยากรที่อาจไม่เหมาะสมซึ่งระบุไว้ในแท็ก
ค่าเริ่มต้น --[no]experimental_android_use_parallel_dex2oat: "เท็จ"
ใช้ dex2oat แบบขนานเพื่อเร่งความเร็ว android_test
แท็ก: loading_and_analysis, host_machine_resource_optimizations, experimental
ค่าเริ่มต้น --[no]ios_memleaks: "เท็จ"
เปิดใช้การตรวจหาหน่วยความจำรั่วไหลในเป้าหมาย ios_test
แท็ก: action_command_lines
ค่าเริ่มต้น --ios_simulator_device=<a string>: ดูคำอธิบาย
อุปกรณ์ที่จะจำลองเมื่อเรียกใช้แอปพลิเคชัน iOS ในเครื่องมือจำลอง เช่น "iPhone 6" คุณดูรายการอุปกรณ์ได้โดยเรียกใช้ "xcrun simctl list devicetypes" บนเครื่องที่เครื่องมือจำลองจะทำงาน
แท็ก: test_runner
ค่าเริ่มต้น --ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ดูคำอธิบาย
เวอร์ชันของ iOS ที่จะเรียกใช้บนเครื่องมือจำลองเมื่อทำงานหรือทดสอบ ระบบจะไม่สนใจกฎ ios_test หากกฎระบุอุปกรณ์เป้าหมายไว้ในกฎ
แท็ก: test_runner
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once> รายการ
ระบุจำนวนครั้งที่จะทำการทดสอบแต่ละครั้ง หากการดำเนินการเหล่านั้นล้มเหลวไม่ว่าด้วยเหตุผลใดก็ตาม จะถือว่าการทดสอบทั้งหมดไม่ผ่าน โดยปกติแล้ว ค่าที่ระบุจะเป็นแค่จำนวนเต็ม ตัวอย่าง: --runs_per_test=3 จะทำการทดสอบทั้งหมด 3 ครั้ง ไวยากรณ์สำรอง: regex_filter@runs_per_test โดย running_per_test ย่อมาจากค่าจำนวนเต็ม ส่วน regex_filter หมายถึงรายการรูปแบบการรวมและยกเว้นรูปแบบนิพจน์ทั่วไป (โปรดดู --instrumentation_filter) ตัวอย่างเช่น --runs_per_test=//foo/.*,-//foo/bar/.*@3 จะทำการทดสอบทั้งหมดใน //foo/ ยกเว้นการทดสอบภายใต้ foo/bar 3 ครั้ง ตัวเลือกนี้ส่งได้หลายครั้ง อาร์กิวเมนต์ที่ส่งผ่านล่าสุดที่ตรงกันจะมีความสำคัญเหนือกว่า หากไม่มีผลลัพธ์ที่ตรงกัน ระบบจะทำการทดสอบเพียงครั้งเดียว
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --test_env=<a 'name=value' assignment with an optional value part> รายการ
ระบุตัวแปรสภาพแวดล้อมเพิ่มเติมที่จะแทรกลงในสภาพแวดล้อมตัวดำเนินการทดสอบ คุณระบุตัวแปรได้โดยใช้ชื่อ ซึ่งในกรณีนี้ระบบจะอ่านค่าของตัวแปรจากสภาพแวดล้อมไคลเอ็นต์ Bazel หรือด้วยคู่ชื่อ=ค่า ตัวเลือกนี้ใช้ได้หลายครั้งเพื่อระบุตัวแปรหลายรายการ ใช้เฉพาะโดย "การทดสอบ bazel" เท่านั้น คำสั่ง
แท็ก: test_runner
ค่าเริ่มต้น --test_timeout=<a single integer or comma-separated list of 4 integers>: "-1"
ลบล้างค่าระยะหมดเวลาในการทดสอบเริ่มต้นสำหรับระยะหมดเวลาทดสอบ (เป็นวินาที) หากระบุค่าจำนวนเต็มบวกค่าเดียว ค่าดังกล่าวจะแทนที่หมวดหมู่ทั้งหมด หากระบุจำนวนเต็มที่คั่นด้วยคอมมา 4 ตัวเลข ค่าดังกล่าวจะลบล้างระยะหมดเวลาสำหรับแบบสั้น ปานกลาง ยาว และนิรันดร์ (ตามลำดับนั้น) ไม่ว่าจะเป็นรูปแบบใด ค่า -1 จะบอกให้ Blaze ใช้ระยะหมดเวลาเริ่มต้นสำหรับหมวดหมู่นั้น
ค่าเริ่มต้น --[no]zip_undeclared_test_outputs: "true"
หากเป็น "จริง" ระบบจะเก็บเอาต์พุตทดสอบที่ไม่ได้ประกาศไว้ในไฟล์ ZIP
แท็ก: test_runner
ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตการค้นหาและความหมาย
ค่าเริ่มต้น --aspect_deps=<off, conservative or precise>: "เชิงรับ"
วิธีแก้ไขทรัพยากร Dependency ของลักษณะเมื่อรูปแบบเอาต์พุตเป็นหนึ่งใน {xml,protocol,record} "off" หมายความว่าจะไม่มีการแก้ไขทรัพยากร Dependency ในด้านต่างๆ "เชิงรับ" (ค่าเริ่มต้น) หมายความว่าจะมีการเพิ่มทรัพยากร Dependency ที่ประกาศทั้งหมด ไม่ว่าทรัพยากรเหล่านั้นจะได้รับคลาสของกฎการขึ้นต่อกันโดยตรงหรือไม่ ซึ่งก็คือ "แม่นยำ" หมายความว่าจะมีการเพิ่มเฉพาะด้านที่อาจทำงานอยู่ตามคลาสกฎของทรัพยากร Dependency โดยตรง โปรดทราบว่าโหมดแม่นยำต้องมีการโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียว ซึ่งจะทำให้ช้ากว่าโหมดอื่นๆ และโปรดทราบด้วยว่า โหมดแม้กระทั่งที่แม่นยำก็ไม่ได้แม่นยำทั้งหมด การตัดสินใจว่าจะคำนวณด้านใดด้านหนึ่งหรือไม่จะทำในขั้นตอนการวิเคราะห์ ซึ่งจะไม่ทำงานระหว่าง "การค้นหาแบบงัดแงะ"
แท็ก: build_file_semantics
ค่าเริ่มต้น --[no]consistent_labels: "เท็จ"
หากเปิดใช้งาน ทุกคำสั่งการค้นหาจะแสดงป้ายกำกับประหนึ่งว่าด้วย Starlark <code>str</code> ที่ใช้กับ<code>ป้ายกำกับ</code> อินสแตนซ์ ซึ่งมีประโยชน์สำหรับเครื่องมือที่จำเป็นต้องจับคู่เอาต์พุตของคำสั่งการค้นหาและ/หรือป้ายกำกับต่างๆ ที่กฎเรียกใช้ หากไม่เปิดใช้ ตัวจัดรูปแบบเอาต์พุตจะแสดงชื่อที่เก็บที่ชัดเจน (สัมพันธ์กับที่เก็บหลัก) แทนเพื่อทำให้เอาต์พุตอ่านได้ง่ายขึ้น
แท็ก: terminal_output
ค่าเริ่มต้น --[no]experimental_explicit_aspects: "เท็จ"
aquery, cquery: จะรวมการทำงานที่สร้างโดยมุมมองไว้ในเอาต์พุตหรือไม่ คำค้นหา: ไม่มีการดำเนินการ (ติดตามเสมอ)
แท็ก: terminal_output
ค่าเริ่มต้น --[no]graph:factored: "true"
หากเป็น "จริง" กราฟจะแสดงผลแบบ "แยกตัวประกอบ" นั่นคือ โหนดที่เท่าเทียมกันทางโทโพโลจีจะผสานเข้าด้วยกันและป้ายกำกับของโหนดทั้งสองเชื่อมติดกัน ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก: terminal_output
ค่าเริ่มต้น --graph:node_limit=<an integer>: "512"
ความยาวสูงสุดของสตริงป้ายกำกับสำหรับโหนดกราฟในเอาต์พุต ป้ายกำกับที่ยาวขึ้นจะถูกตัด -1 หมายถึงไม่มีการตัดข้อความ ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก: terminal_output
ค่าเริ่มต้น --[no]implicit_deps: "true"
หากเปิดใช้ การขึ้นต่อกันโดยปริยายจะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ทรัพยากร Dependency โดยนัยคือทรัพยากรที่ไม่มีการระบุอย่างชัดแจ้งในไฟล์ BUILD แต่เพิ่มโดย Bazel สำหรับ cquery ตัวเลือกนี้จะควบคุมการกรอง Toolchain ที่มีการแก้ปัญหาแล้ว
แท็ก: build_file_semantics
ค่าเริ่มต้น --[no]include_artifacts: "true"
รวมชื่อของอินพุตและเอาต์พุตการดำเนินการในเอาต์พุต (ซึ่งอาจมีขนาดใหญ่)
แท็ก: terminal_output
ค่าเริ่มต้น --[no]include_aspects: "true"
aquery, cquery: จะรวมการทำงานที่สร้างโดยมุมมองไว้ในเอาต์พุตหรือไม่ คำค้นหา: ไม่มีการดำเนินการ (ติดตามเสมอ)
แท็ก: terminal_output
ค่าเริ่มต้น --[no]include_commandline: "true"
มีเนื้อหาของบรรทัดคำสั่งสำหรับการดำเนินการในเอาต์พุต (อาจมีขนาดใหญ่)
แท็ก: terminal_output
ค่าเริ่มต้น --[no]include_file_write_contents: "เท็จ"
ใส่เนื้อหาไฟล์สำหรับการดำเนินการ FileWrite, SourceSymlinkManifest และ RepoMappingManifest (ซึ่งอาจมีขนาดใหญ่)
แท็ก: terminal_output
ค่าเริ่มต้น --[no]include_param_files: "เท็จ"
รวมเนื้อหาของไฟล์พารามิเตอร์ที่ใช้ในคำสั่ง (อาจมีขนาดใหญ่) หมายเหตุ: การเปิดใช้งานการตั้งค่าสถานะนี้จะเป็นการเปิดใช้การตั้งค่าสถานะ --include_commandline โดยอัตโนมัติ
แท็ก: terminal_output
ค่าเริ่มต้น --[no]incompatible_package_group_includes_double_slash: "true"
หากเปิดใช้ เมื่อแสดงแอตทริบิวต์ "packages" ของpackage_group จะไม่ละเว้น "//" ที่นำหน้า
แท็ก: terminal_output incompatible_change
ค่าเริ่มต้น --[no]infer_universe_scope: "เท็จ"
หากตั้งค่า และ --universe_scope ไม่ได้ตั้งค่าไว้ ระบบจะอนุมานค่าของ --universe_scope เป็นรายการรูปแบบเป้าหมายที่ไม่ซ้ำกันในนิพจน์การค้นหา โปรดทราบว่าค่า --universe_scope ที่อนุมานสำหรับนิพจน์การค้นหาที่ใช้ฟังก์ชันที่กําหนดขอบเขตระดับจักรวาล (เช่น "allrdeps") อาจไม่ใช่สิ่งที่คุณต้องการ คุณจึงควรใช้ตัวเลือกนี้ก็ต่อเมื่อคุณทราบว่าคุณกำลังทำอะไรอยู่เท่านั้น ดูรายละเอียดและตัวอย่างได้ที่ https://bazel.build/reference/query#sky-query หากตั้งค่า --universe_scope ค่า ระบบจะไม่สนใจค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้ใช้ได้เฉพาะกับ "query" (กล่าวคือ ไม่ใช่ "cquery")
แท็ก: loading_and_analysis
ค่าเริ่มต้น --[no]line_terminator_null: "เท็จ"
เลือกว่าจะสิ้นสุดแต่ละรูปแบบด้วย \0 แทนการขึ้นบรรทัดใหม่หรือไม่
แท็ก: terminal_output
ค่าเริ่มต้น --[no]nodep_deps: "true"
หากเปิดใช้ ระบบจะแยกออกจาก "nodep" จะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ตัวอย่างทั่วไปของ "nodep" คือ "visibility" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ "info create-language" เพื่อดูข้อมูลเกี่ยวกับ "nodep" ทั้งหมด ในภาษาของบิลด์
แท็ก: build_file_semantics
ค่าเริ่มต้น --output=<a string>: "ข้อความ"
รูปแบบที่ควรพิมพ์ผลการค้นหาคำค้นหา ค่าที่อนุญาตสำหรับ aquery คือ text, textprotocol, proto, streamed_profi, jsonprotocol
แท็ก: terminal_output
ค่าเริ่มต้น --[no]proto:default_values: "true"
หากเป็น "จริง" ระบบจะรวมแอตทริบิวต์ที่ไม่ได้ระบุไว้อย่างชัดเจนในไฟล์ BUILD มิฉะนั้นจะถูกละเว้น ตัวเลือกนี้ใช้ได้กับ --output=prof
แท็ก: terminal_output
ค่าเริ่มต้น --[no]proto:definition_stack: "เท็จ"
ป้อนข้อมูลในช่อง Proto ของ Definition_stack ซึ่งบันทึกสำหรับสแต็กการเรียกใช้ Starlark สำหรับแต่ละอินสแตนซ์ของกฎ ณ เวลาที่มีการกำหนดคลาสของกฎ
แท็ก: terminal_output
ค่าเริ่มต้น --[no]proto:flatten_selects: "true"
หากเปิดใช้ ระบบจะแยกแอตทริบิวต์ที่กำหนดค่าได้ซึ่งสร้างโดย select() ไว้ในรูปแบบ สำหรับประเภทรายการ การแสดงแบบ "แยกเป็นหลายรายการ" คือรายการซึ่งประกอบด้วยแต่ละค่าของแผนที่ที่เลือกเพียงครั้งเดียว ระบบจะแยกประเภทสเกลาร์เป็นค่าว่าง
แท็ก: build_file_semantics
ค่าเริ่มต้น --[no]proto:include_attribute_source_aspects: "เท็จ"
ป้อนข้อมูลในช่อง Proto ของ source_aspect_name ของแต่ละแอตทริบิวต์ด้วยลักษณะต้นทางของแอตทริบิวต์นั้น (สตริงว่างเปล่าหากไม่มีข้อมูล)
แท็ก: terminal_output
ค่าเริ่มต้น --[no]proto:include_synthetic_attribute_hash: "เท็จ"
คำนวณและเติมข้อมูลแอตทริบิวต์ $internal_attr_hash หรือไม่
แท็ก: terminal_output
ค่าเริ่มต้น --[no]proto:instantiation_stack: "เท็จ"
ป้อนข้อมูลสแต็กการเรียกใช้การสร้างอินสแตนซ์ของแต่ละกฎ โปรดทราบว่าการดำเนินการนี้ต้องมีสแต็กอยู่
แท็ก: terminal_output
ค่าเริ่มต้น --[no]proto:locations: "true"
ระบุว่าจะแสดงข้อมูลตำแหน่งในเอาต์พุต Pro เลยหรือไม่
แท็ก: terminal_output
ค่าเริ่มต้น --proto:output_rule_attrs=<comma-separated list of options>: "ทั้งหมด"
รายการแอตทริบิวต์ที่คั่นด้วยจุลภาคที่จะรวมในเอาต์พุต ค่าเริ่มต้นคือแอตทริบิวต์ทั้งหมด ตั้งค่าเป็นสตริงว่างเปล่าเพื่อไม่ให้แสดงแอตทริบิวต์ใดๆ ตัวเลือกนี้ใช้ได้กับ --output=protocol
แท็ก: terminal_output
ค่าเริ่มต้น --[no]proto:rule_inputs_and_outputs: "true"
เติมข้อมูลในช่อง rules_input และ rules_output หรือไม่
แท็ก: terminal_output
ค่าเริ่มต้นของ --query_file=<a string>: ""
หากมีการตั้งค่าไว้ การค้นหาจะอ่านการค้นหาจากไฟล์ที่มีชื่อที่นี่ แทนที่จะเป็นบรรทัดคำสั่ง การระบุไฟล์ที่นี่และคำค้นหาบรรทัดคำสั่งเป็นข้อผิดพลาด
แท็ก: changes_inputs
ค่าเริ่มต้น --[no]relative_locations: "เท็จ"
หากเป็นจริง ตำแหน่งของไฟล์ BUILD ใน XML และเอาต์พุต Pro จะสัมพันธ์กัน โดยค่าเริ่มต้น เอาต์พุตตำแหน่งจะเป็นเส้นทางสัมบูรณ์และจะไม่สอดคล้องกันในแต่ละเครื่อง คุณสามารถตั้งค่าตัวเลือกนี้เป็น "จริง" เพื่อให้ได้ผลลัพธ์ที่สอดคล้องกันในอุปกรณ์ทุกเครื่อง
แท็ก: terminal_output
ค่าเริ่มต้น --[no]skyframe_state: "เท็จ"
ดัมพ์กราฟการดำเนินการปัจจุบันจาก Skyframe โดยไม่ต้องทำการวิเคราะห์เพิ่มเติม หมายเหตุ: ขณะนี้ระบบยังไม่รองรับการระบุเป้าหมายด้วย --skyframe_state แฟล็กนี้ใช้ได้เฉพาะกับ --output=prof หรือ --output=textprotocol
แท็ก: terminal_output
ค่าเริ่มต้น --[no]tool_deps: "true"
การค้นหา: หากปิดใช้ ทรัพยากร Dependency ใน "การกำหนดค่า exec" จะไม่รวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน "การกำหนดค่าการดำเนินการ" เอดจ์ของทรัพยากร Dependency เช่น ขีดจำกัดจาก "proto_library" ให้กับโปรโตคอลคอมไพเลอร์ ซึ่งโดยทั่วไปจะชี้ไปยังเครื่องมือที่ดำเนินการระหว่างการสร้างแทนที่จะเป็นส่วนของ "เป้าหมาย" เดียวกัน ของโปรแกรม Cquery: หากปิดใช้ จะกรองเป้าหมายที่กำหนดค่าไว้ทั้งหมดซึ่งข้ามการเปลี่ยนการดำเนินการจากเป้าหมายระดับบนสุดที่ค้นพบเป้าหมายที่กำหนดค่าไว้นี้ออก ซึ่งหมายความว่าหากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าเป้าหมาย ระบบจะแสดงผลเฉพาะเป้าหมายที่กำหนดค่าไว้ในการกำหนดค่าเป้าหมายด้วย ถ้าเป้าหมายระดับบนสุดอยู่ในการกำหนดค่า exec ระบบจะแสดงผลเฉพาะเป้าหมายที่กำหนดค่าของ exec เท่านั้น ตัวเลือกนี้จะ "ไม่" ยกเว้น Toolchain ที่แก้ไขแล้ว
แท็ก: build_file_semantics
ค่าเริ่มต้นของ --universe_scope=<comma-separated list of options>: ""
ชุดรูปแบบเป้าหมายที่คั่นด้วยคอมมา (บวกและลบ) การค้นหาอาจดำเนินการในจักรวาลที่กำหนดโดยการปิดแบบสับเปลี่ยนของเป้าหมายที่ระบุ ตัวเลือกนี้ใช้สําหรับคำสั่งการค้นหาและคำสั่ง cquery สำหรับ cquery อินพุตของตัวเลือกนี้จะเป็นเป้าหมายในการสร้างคำตอบทั้งหมด ดังนั้นตัวเลือกนี้อาจส่งผลต่อการกําหนดค่าและการเปลี่ยน หากไม่ได้ระบุตัวเลือกนี้ ระบบจะถือว่าเป้าหมายระดับบนสุดเป็นเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหา หมายเหตุ: สำหรับ cquery การไม่ระบุตัวเลือกนี้อาจทำให้บิลด์ไม่ทำงานหากเป้าหมายที่แยกวิเคราะห์จากนิพจน์คำค้นหาไม่สามารถสร้างได้ด้วยตัวเลือกระดับบนสุด
แท็ก: loading_and_analysis
ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพเวลาของบิลด์
ค่าเริ่มต้น --[no]experimental_filter_library_jar_with_program_jar: "เท็จ"
กรอง ProGuard ProgramJar เพื่อนำชั้นเรียนที่อยู่ใน LibraryJar ออกด้วย
แท็ก: action_command_lines
ค่าเริ่มต้น --[no]experimental_inmemory_dotd_files: "true"
หากเปิดใช้ ระบบจะส่งไฟล์ C++ .d ในหน่วยความจำโดยตรงจากโหนดบิลด์ระยะไกลแทนที่จะถูกเขียนลงในดิสก์
แท็ก: loading_and_analysis, execution, affects_outputs, experimental
ค่าเริ่มต้น --[no]experimental_inmemory_jdeps_files: "true"
หากเปิดใช้ ไฟล์ทรัพยากร Dependency (.jdeps) ที่สร้างขึ้นจากการคอมไพล์ Java จะส่งผ่านในหน่วยความจำโดยตรงจากโหนดบิลด์ระยะไกลแทนที่จะถูกเขียนลงในดิสก์
แท็ก: loading_and_analysis, execution, affects_outputs, experimental
ค่าเริ่มต้น --[no]experimental_objc_include_scanning: "เท็จ"
ระบุว่าจะทำการสแกนรวมสำหรับวัตถุประสงค์ C/C++ หรือไม่
แท็ก: loading_and_analysis, execution, changes_inputs
ค่าเริ่มต้น --[no]experimental_retain_test_configuration_across_testonly: "เท็จ"
เมื่อเปิดใช้ --trim_test_configuration จะไม่ตัดการกำหนดค่าการทดสอบสำหรับกฎที่ทำเครื่องหมายว่า testonly=1 ทั้งนี้เพื่อลดปัญหาความขัดแย้งในการดำเนินการเมื่อกฎที่ไม่ใช่การทดสอบต้องพึ่งพากฎ cc_test จะไม่มีผลหาก --trim_test_configuration เป็นเท็จ
แท็ก: loading_and_analysis loses_incremental_state
ค่าเริ่มต้น --[no]experimental_starlark_cc_import: "เท็จ"
หากเปิดใช้ เวอร์ชัน Starlark ของ cc_import จะสามารถใช้ได้
แท็ก: loading_and_analysis experimental
ค่าเริ่มต้น --[no]experimental_unsupported_and_brittle_include_scanning: "เท็จ"
เลือกว่าจะจำกัดอินพุตเฉพาะการคอมไพล์ C/C++ หรือไม่โดยการแยกวิเคราะห์ #include บรรทัดจากไฟล์อินพุต ซึ่งจะช่วยปรับปรุงประสิทธิภาพและส่วนเพิ่มด้วยการลดขนาดของแผนผังอินพุตสำหรับการคอมไพล์ อย่างไรก็ตาม ก็อาจทำให้บิลด์เสียหายได้เช่นกัน เนื่องจากเครื่องมือสแกนดังกล่าวไม่สามารถใช้งานความหมายของโปรเซสเซอร์ล่วงหน้าแบบ C ได้อย่างสมบูรณ์ โดยเฉพาะอย่างยิ่ง ระบบจะไม่เข้าใจคำสั่ง #include แบบไดนามิก และไม่สนใจตรรกะตามเงื่อนไขของตัวประมวลผลล่วงหน้า คุณต้องรับความเสี่ยงของการใช้งานเอง เราจะปิดปัญหาที่เกี่ยวข้องกับการแจ้งว่าไม่เหมาะสมนี้
แท็ก: loading_and_analysis, execution, changes_inputs
ค่าเริ่มต้น --[no]incremental_dexing: "true"
ส่วนใหญ่จะทำงานสำหรับ Dexing แยกต่างหากสำหรับไฟล์ Jar แต่ละไฟล์
แท็ก: affects_outputs, loading_and_analysis, loses_incremental_state
ค่าเริ่มต้น --[no]objc_use_dotd_pruning: "true"
หากตั้งค่าไว้ จะมีการใช้ไฟล์ .d ที่มาจาก clang เพื่อตัดชุดอินพุตที่ส่งผ่านเข้าไปในคอมไพล์ objc
แท็ก: changes_inputs loading_and_analysis
ค่าเริ่มต้น --[no]process_headers_in_dependencies: "เท็จ"
เมื่อสร้าง //a:a เป้าหมาย ให้ประมวลผลส่วนหัวในเป้าหมายทั้งหมดที่ //a:a ต้องใช้ (หากเปิดใช้การประมวลผลส่วนหัวสำหรับ Toolchain)
แท็ก: execution
ค่าเริ่มต้น --[no]trim_test_configuration: "true"
เมื่อเปิดใช้ ระบบจะล้างตัวเลือกที่เกี่ยวข้องกับการทดสอบซึ่งอยู่ใต้ระดับบนสุดของบิลด์ เมื่อแฟล็กนี้ทำงานอยู่ ระบบจะสร้างการทดสอบเป็นทรัพยากร Dependency ของกฎที่ไม่ใช่การทดสอบไม่ได้ แต่การเปลี่ยนแปลงตัวเลือกที่เกี่ยวข้องกับการทดสอบจะไม่ทำให้มีการวิเคราะห์กฎที่ไม่ใช่การทดสอบอีกครั้ง
แท็ก: loading_and_analysis loses_incremental_state
ตัวเลือกที่ส่งผลต่อ
การพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
ค่าเริ่มต้น --toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: "-.*"
พิมพ์ข้อมูลการแก้ไขข้อบกพร่องระหว่างการแปลง Toolchain แฟล็กจะใช้นิพจน์ทั่วไปซึ่งตรวจสอบกับประเภท Toolchain และเป้าหมายที่เฉพาะเจาะจงเพื่อดูว่าควรแก้ไขข้อบกพร่องใด นิพจน์ทั่วไปหลายรายการจะคั่นด้วยคอมมา แล้วระบบจะเลือกนิพจน์ทั่วไปแต่ละรายการแยกกัน หมายเหตุ: เอาต์พุตของ Flag นี้มีความซับซ้อนมากและน่าจะเป็นประโยชน์ต่อผู้เชี่ยวชาญด้านการแก้ไข Toolchain เท่านั้น
แท็ก: terminal_output
ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --flag_alias=<a 'name=value' flag alias> รายการ
ตั้งชื่อย่อสำหรับธง Starlark โดยใช้คู่คีย์-ค่าคู่เดียวในรูปแบบ "<key>=<value>" เป็นอาร์กิวเมนต์
แท็ก: changes_inputs
ค่าเริ่มต้น --[no]incompatible_default_to_explicit_init_py: "เท็จ"
แฟล็กนี้เปลี่ยนลักษณะการทำงานเริ่มต้นเพื่อไม่ให้สร้างไฟล์ __init__.py โดยอัตโนมัติในไฟล์การเรียกใช้ของเป้าหมาย Python อีกต่อไป แม่นยำเมื่อเป้าหมาย py_binary หรือ py_test ตั้งค่า legacy_create_init เป็น "auto" (ค่าเริ่มต้น) ระบบจะถือว่าเป็น "เท็จ" เมื่อมีการตั้งค่าแฟล็กนี้เท่านั้น ดู https://github.com/bazelbuild/bazel/issues/10076
แท็ก: affects_outputs incompatible_change
ค่าเริ่มต้น --[no]incompatible_py2_outputs_are_suffixed: "true"
หากเป็นจริง เป้าหมายที่สร้างในการกำหนดค่า Python 2 จะปรากฏภายใต้รูทเอาต์พุตที่มีคำต่อท้าย "-py2" ขณะที่เป้าหมายที่สร้างขึ้นสำหรับ Python 3 จะปรากฏในรูทที่ไม่มีส่วนต่อท้ายที่เกี่ยวข้องกับ Python ซึ่งหมายความว่าลิงก์สัญลักษณ์ความสะดวก "bazel-bin" จะชี้ไปยังเป้าหมาย Python 3 แทนที่จะเป็น Python 2 หากคุณเปิดใช้ตัวเลือกนี้ ขอแนะนำให้เปิดใช้ "--incompatible_py3_is_default" ด้วย
แท็ก: affects_outputs incompatible_change
ค่าเริ่มต้น --[no]incompatible_py3_is_default: "true"
หากเป็นจริง เป้าหมาย "py_binary" และ "py_test" ที่ไม่ได้ตั้งค่าแอตทริบิวต์ "python_version" (หรือ "default_python_version") จะมีค่าเริ่มต้นเป็น PY3 แทนที่จะเป็น PY2 หากตั้งค่าแฟล็กนี้ ขอแนะนำให้ตั้งค่า "--incompatible_py2_outputs_are_suffixed"
แท็ก: loading_and_analysis, affects_outputs, incompatible_change
ค่าเริ่มต้น --[no]incompatible_use_python_toolchains: "true"
หากตั้งค่าเป็น "จริง" กฎ Python ในเครื่องที่เป็นไฟล์ปฏิบัติการจะใช้รันไทม์ของ Python ที่ระบุโดย Toolchain ของ Python แทนรันไทม์ที่มาจากแฟล็กเดิม เช่น --python_top
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --python_version=<PY2 or PY3>: ดูคำอธิบาย
โหมดเวอร์ชันหลักของ Python ไม่ว่าจะเป็น "PY2" หรือ "PY3" โปรดทราบว่าเป้าหมาย "py_binary" และ "py_test" จะลบล้างค่านี้ (แม้ว่าจะไม่ได้ระบุเวอร์ชันอย่างชัดเจน) จึงมักไม่มีเหตุผลที่จะต้องระบุแฟล็กนี้
แท็ก: loading_and_analysis affects_outputs
ตัวเลือกเบ็ดเตล็ด
ที่ไม่ถูกจัดหมวดหมู่:
--[no]cache_test_results [-t] ค่าเริ่มต้น: "อัตโนมัติ"
หากตั้งค่าเป็น "อัตโนมัติ" Bazel จะทำการทดสอบอีกครั้งเฉพาะในกรณีต่อไปนี้ (1) Bazel ตรวจพบการเปลี่ยนแปลงในการทดสอบหรือทรัพยากร Dependency (2) การทดสอบได้รับการทำเครื่องหมายว่าเป็นภายนอก (3) มีการขอทำการทดสอบหลายครั้งด้วย --runs_per_test หรือ(4) การทดสอบล้มเหลวก่อนหน้านี้ หากตั้งค่าเป็น "ใช่" Bazel จะแคชผลการทดสอบทั้งหมด ยกเว้นการทดสอบที่ทำเครื่องหมายว่าภายนอก หากตั้งค่าเป็น "ไม่" Bazel จะไม่แคชผลการทดสอบใดๆ
ค่าเริ่มต้น --[no]experimental_cancel_concurrent_tests: "เท็จ"
หากเป็น "จริง" Blaze จะยกเลิกการทดสอบพร้อมกันในการรันที่สำเร็จครั้งแรก วิธีนี้จะมีประโยชน์เมื่อใช้ร่วมกับ --runs_per_test_detects_flakes เท่านั้น
แท็ก: affects_outputs loading_and_analysis
ค่าเริ่มต้น --[no]experimental_fetch_all_coverage_outputs: "เท็จ"
หากเป็น "จริง" Bazel จะดึงข้อมูลไดเรกทอรีข้อมูลการครอบคลุมทั้งหมดสำหรับการทดสอบแต่ละครั้งระหว่างการทำงานของการครอบคลุม
แท็ก: affects_outputs loading_and_analysis
ค่าเริ่มต้น --[no]experimental_generate_llvm_lcov: "เท็จ"
หากเป็น "จริง" ความครอบคลุมของคําพูดจะสร้างรายงาน LCOV
แท็ก: affects_outputs loading_and_analysis
ค่าเริ่มต้น --[no]experimental_j2objc_header_map: "true"
เลือกว่าจะสร้างแผนที่ส่วนหัว J2ObjC ควบคู่ไปกับการแปลง J2ObjC หรือไม่
ค่าเริ่มต้น --[no]experimental_j2objc_shorter_header_path: "เท็จ"
เลือกว่าจะสร้างโดยใช้เส้นทางส่วนหัวที่สั้นกว่าหรือไม่ (ใช้ "_ios" แทน "_j2objc")
แท็ก: affects_outputs
ค่าเริ่มต้น --experimental_java_classpath=<off, javabuilder or bazel>: "javabuilder"
เปิดใช้งานคลาสพาธที่ลดลงสำหรับการคอมไพล์ Java
ค่าเริ่มต้น --[no]experimental_limit_android_lint_to_android_constrained_java: "เท็จ"
จำกัด --experimental_run_android_lint_on_java_rules เฉพาะไลบรารีที่เข้ากันได้กับ Android
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]experimental_run_android_lint_on_java_rules: "เท็จ"
ระบุว่าจะตรวจสอบแหล่งที่มา java_* หรือไม่
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]explicit_java_test_deps: "เท็จ"
ระบุทรัพยากร Dependency ของ JUnit หรือ Hamcrest อย่างชัดเจนใน java_test แทนที่จะได้มาจาก Dep ของ TestRunner โดยไม่ตั้งใจ ตอนนี้ใช้ได้กับ bazel เท่านั้น
ค่าเริ่มต้น --host_java_launcher=<a build target label>: ดูคำอธิบาย
Java Launcher ที่เครื่องมือใช้ซึ่งดำเนินการในระหว่างบิลด์
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --host_javacopt=<a string> รายการ
ตัวเลือกเพิ่มเติมในการส่งไปยัง Javac เมื่อสร้างเครื่องมือที่ดำเนินการระหว่างบิลด์
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --host_jvmopt=<a string> รายการ
ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง Java VM เมื่อสร้างเครื่องมือสร้างที่ดำเนินการระหว่างบิลด์ ระบบจะเพิ่มตัวเลือกเหล่านี้ไปยังตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
ค่าเริ่มต้น --[no]incompatible_check_sharding_support: "true"
หากเป็น "จริง" Bazel จะไม่ผ่านการทดสอบชาร์ด หากตัวดำเนินการทดสอบไม่ได้ระบุว่ารองรับการชาร์ดดิ้งโดยการแตะไฟล์ที่เส้นทางใน TEST_SHARD_STATUS_FILE หากเป็นเท็จ ตัวดำเนินการทดสอบที่ไม่รองรับการชาร์ดจะนำไปยังการทดสอบทั้งหมดที่ทำงานในชาร์ดแต่ละรายการ
แท็ก: incompatible_change
ค่าเริ่มต้น --[no]incompatible_exclusive_test_sandboxed: "true"
หากจริง การทดสอบพิเศษจะทำงานโดยใช้กลยุทธ์แซนด์บ็อกซ์ เพิ่ม "ท้องถิ่น" เพื่อบังคับให้การทดสอบพิเศษทำงานภายในเครื่อง
แท็ก: incompatible_change
ค่าเริ่มต้น --[no]incompatible_strict_action_env: "เท็จ"
หากเป็นจริง Bazel จะใช้สภาพแวดล้อมที่มีค่าคงที่สำหรับ PATH และไม่รับค่า LD_LIBRARY_PATH ใช้ --action_env=ENV_VARIABLE หากคุณต้องการรับตัวแปรสภาพแวดล้อมที่เฉพาะเจาะจงจากไคลเอ็นต์ แต่โปรดทราบว่าการทำเช่นนี้อาจป้องกันการแคชข้ามผู้ใช้ได้หากมีการใช้แคชที่แชร์
แท็ก: loading_and_analysis incompatible_change
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --j2objc_translation_flags=<comma-separated list of options> รายการ
ตัวเลือกเพิ่มเติมเพื่อส่งไปยังเครื่องมือ J2ObjC
--java_debug
ทำให้เครื่องเสมือนของ Java ของการทดสอบ Java ต้องรอการเชื่อมต่อจากโปรแกรมแก้ไขข้อบกพร่องที่สอดคล้องกับ JDWP (เช่น jdb) ก่อนเริ่มการทดสอบ โดยนัย -test_output=streamed
ขยายเป็น

--test_arg=--wrapper_script_flag=--debug --test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
ค่าเริ่มต้น --[no]java_deps: "true"
สร้างข้อมูลทรัพยากร Dependency (ในขณะนี้คือคลาสพาธเวลาคอมไพล์) ต่อเป้าหมาย Java
ค่าเริ่มต้น --[no]java_header_compilation: "true"
คอมไพล์จากต้นทางโดยตรง
ค่าเริ่มต้นของ --java_language_version=<a string>: ""
เวอร์ชันภาษา Java
ค่าเริ่มต้น --java_launcher=<a build target label>: ดูคำอธิบาย
Java Launcher ที่จะใช้เมื่อสร้างไบนารีของ Java หากตั้งค่าสถานะนี้เป็นสตริงว่างเปล่า ระบบจะใช้ Launcher ของ JDK "Launcher" จะลบล้างแฟล็กนี้
--java_runtime_version=<a string> ค่าเริ่มต้น: "local_jdk"
เวอร์ชันรันไทม์ของ Java
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --javacopt=<a string> รายการ
ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง Javac
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --jvmopt=<a string> รายการ
ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง Java VM ระบบจะเพิ่มตัวเลือกเหล่านี้ไปยังตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
ค่าเริ่มต้น --legacy_main_dex_list_generator=<a build target label>: ดูคำอธิบาย
ระบุไบนารีที่จะใช้สร้างรายการคลาสที่ต้องอยู่ใน Dex หลักเมื่อคอมไพล์ Multidex เดิม
ค่าเริ่มต้น --optimizing_dexer=<a build target label>: ดูคำอธิบาย
ระบุไบนารีที่จะใช้ทำ Dexing โดยไม่ต้องชาร์ดดิ้ง
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --plugin=<a build target label> รายการ
ปลั๊กอินที่ใช้ในบิลด์ ปัจจุบันใช้งานได้กับ java_plugin
ค่าเริ่มต้น --proguard_top=<a build target label>: ดูคำอธิบาย
ระบุเวอร์ชัน ProGuard ที่จะใช้สำหรับการนำโค้ดออกเมื่อสร้างไบนารีของ Java
--proto_compiler=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/protocol:protocol"
ป้ายกำกับของคอมไพเลอร์ Proto
แท็ก: affects_outputs loading_and_analysis
--proto_toolchain_for_cc=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/protocol:cc_toolchain"
ป้ายกำกับของ profto_lang_toolchain() ที่อธิบายวิธีคอมไพล์ C++ Proto
แท็ก: affects_outputs, loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/j2objc:j2objc_protocol_toolchain"
ป้ายกำกับของ Proto_lang_toolchain() ที่อธิบายถึงวิธีคอมไพล์ j2objc Proto
แท็ก: affects_outputs, loading_and_analysis
--proto_toolchain_for_java=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/protocol:java_toolchain"
ป้ายกำกับของ protocol_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ Java Prot
แท็ก: affects_outputs, loading_and_analysis
--proto_toolchain_for_javalite=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/protocol:javalite_toolchain"
ป้ายกำกับของ Proto_lang_toolchain() ที่อธิบายถึงวิธีคอมไพล์ JavaLite Proto
แท็ก: affects_outputs, loading_and_analysis
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --protocopt=<a string> รายการ
ตัวเลือกเพิ่มเติมเพื่อส่งไปยังคอมไพเลอร์ Protocolbuf
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]runs_per_test_detects_flakes: "เท็จ"
หากเป็นจริง ชาร์ดที่การเรียกใช้/ความพยายามอย่างน้อย 1 ครั้งผ่านและการเรียกใช้/ความพยายามอย่างน้อย 1 ครั้งล้มเหลวจะได้รับสถานะ FLAKY
ค่าเริ่มต้น --shell_executable=<a path>: ดูคำอธิบาย
เส้นทางสัมบูรณ์ไปยังเชลล์ปฏิบัติการของ Bazel ที่จะใช้ หากไม่ได้ตั้งค่านี้ แต่มีการตั้งค่าตัวแปรสภาพแวดล้อม BAZEL_SH ในการเรียกใช้ Bazel แรก (ซึ่งเริ่มต้นเซิร์ฟเวอร์ Bazel) Bazel จะใช้ตัวแปรนั้น หากไม่ได้ตั้งค่าไว้ Bazel จะใช้เส้นทางเริ่มต้นแบบฮาร์ดโค้ด โดยขึ้นอยู่กับระบบปฏิบัติการที่ใช้ (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, อื่นๆ ทั้งหมด: /bin/bash) โปรดทราบว่าการใช้ Shell ที่เข้ากันไม่ได้กับ Bash อาจทำให้บิลด์ล้มเหลวหรือรันไทม์ของไบนารีที่สร้างขึ้นไม่สำเร็จ
แท็ก: loading_and_analysis
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --test_arg=<a string> รายการ
ระบุตัวเลือกและอาร์กิวเมนต์เพิ่มเติมที่ควรส่งไปยังไฟล์ปฏิบัติการทดสอบ ซึ่งสามารถใช้หลายครั้งเพื่อระบุอาร์กิวเมนต์ได้หลายรายการ หากดำเนินการทดสอบหลายรายการ แต่ละรายการจะได้รับอาร์กิวเมนต์ที่เหมือนกัน ใช้เฉพาะโดย "การทดสอบ bazel" เท่านั้น คำสั่ง
ค่าเริ่มต้น --test_filter=<a string>: ดูคำอธิบาย
ระบุตัวกรองที่จะส่งต่อไปยังเฟรมเวิร์กการทดสอบ ใช้เพื่อจำกัดการทดสอบ โปรดทราบว่าการเปลี่ยนแปลงนี้ไม่มีผลต่อเป้าหมายที่สร้างขึ้น
ค่าเริ่มต้น --test_result_expiration=<an integer>: "-1"
ตัวเลือกนี้เลิกใช้งานแล้วและไม่ส่งผลใดๆ
ค่าเริ่มต้น --[no]test_runner_fail_fast: "เท็จ"
การส่งต่อล้มเหลวตัวเลือกอย่างรวดเร็วไปยังตัวดำเนินการทดสอบ ตัวดำเนินการทดสอบควรหยุดการดำเนินการเมื่อล้มเหลวครั้งแรก
ค่าเริ่มต้น --test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>: "อาจไม่เหมาะสม"
ระบุกลยุทธ์สำหรับการทดสอบชาร์ดดิ้ง: "Explicit" จะใช้ชาร์ดดิ้งก็ต่อเมื่อ "shard_count" เท่านั้น มีแอตทริบิวต์ BUILD "ปิดใช้" ว่าจะไม่ใช้ทดสอบชาร์ดดิ้ง "forced=k" เพื่อบังคับใช้ "k" ชาร์ดสำหรับการทดสอบโดยไม่คำนึงถึง "shard_count" BUILD
ค่าเริ่มต้นของ --tool_java_language_version=<a string>: ""
เวอร์ชันภาษา Java ที่ใช้เพื่อเรียกใช้เครื่องมือที่จำเป็นระหว่างการสร้าง
ค่าเริ่มต้นของ --tool_java_runtime_version=<a string>: "remotejdk_11"
เวอร์ชันรันไทม์ของ Java ที่ใช้เพื่อเรียกใช้เครื่องมือในระหว่างบิลด์
ค่าเริ่มต้น --[no]use_ijars: "true"
หากเปิดใช้ ตัวเลือกนี้จะทำให้การคอมไพล์ Java ใช้ jars อินเทอร์เฟซ ซึ่งจะทำให้การคอมไพล์แบบเพิ่มขึ้นเรื่อยๆ ได้เร็วขึ้น แต่ข้อความแสดงข้อผิดพลาดอาจแตกต่างกันได้

ตัวเลือกสำหรับบิลด์

ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --distdir=<a path> รายการ
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก: bazel_internal_configuration
หากมีการตั้งค่า แคชของที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่เกิดแคชแทนที่จะคัดลอก ซึ่งช่วยประหยัดพื้นที่ในดิสก์
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --experimental_repository_downloader_retries=<an integer>: "0"
จำนวนครั้งสูงสุดในการลองดาวน์โหลดข้อผิดพลาดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก: experimental
ค่าเริ่มต้น --experimental_scale_timeouts=<a double>: "1.0"
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ด้วยปัจจัยนี้ ด้วยวิธีนี้ ที่เก็บภายนอกจะทำให้ทำงานกับเครื่องที่ทำงานช้ากว่าที่ผู้สร้างกฎคาดไว้ โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก: bazel_internal_configuration experimental
ค่าเริ่มต้น --http_connector_attempts=<an integer>: "8"
จำนวนครั้งสูงสุดในการดาวน์โหลด HTTP
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --http_connector_retry_max_timeout=<An immutable length of time.>: "0s"
การหมดเวลาสูงสุดสำหรับการลองดาวน์โหลด HTTP ซ้ำ เมื่อใช้ค่า 0 จะไม่มีการกำหนดระยะหมดเวลาสูงสุด
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --http_timeout_scaling=<a double>: "1.0"
ปรับขนาดการหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลด HTTP ด้วยตัวประกอบที่ระบุ
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --repository_cache=<a path>: ดูคำอธิบาย
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการเรียกข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช มิเช่นนั้น จะใช้ค่าเริ่มต้นเป็น "<output_user_root>/cache/repos/v1" ถูกใช้แล้ว
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --[no]repository_disable_download: "เท็จ"
หากตั้งค่าไว้ ไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลที่เก็บ โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้อย่างสมบูรณ์ ctx.execute ยังคงสามารถรันไฟล์ปฏิบัติการที่กำหนดเองได้ในการเข้าถึงอินเทอร์เน็ต
แท็ก: bazel_internal_configuration
ตัวเลือกที่ควบคุมการดำเนินการของบิลด์:
ค่าเริ่มต้น --[no]check_up_to_date: "เท็จ"
ห้ามดำเนินการสร้าง เพียงตรวจสอบว่าเป็นรุ่นล่าสุดหรือไม่ หากเป้าหมายทั้งหมดเป็นปัจจุบัน แสดงว่าบิลด์เสร็จสมบูรณ์ หากต้องดำเนินการในขั้นตอนใด ระบบจะรายงานข้อผิดพลาดและบิลด์ล้มเหลว
แท็ก: execution
ค่าเริ่มต้น --dynamic_local_execution_delay=<an integer>: "1000"
การดำเนินการในเครื่องควรล่าช้าไปกี่มิลลิวินาที หากการดำเนินการจากระยะไกลเร็วขึ้นระหว่างบิลด์อย่างน้อย 1 ครั้ง
แท็ก: execution host_machine_resource_optimizations
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment> รายการ
กลยุทธ์ในท้องถิ่นซึ่งจะนำไปใช้สำหรับการช่วยจำที่ระบุ ระบบจะใช้กลยุทธ์แรกที่เกี่ยวข้อง เช่น "ผู้ปฏิบัติงาน, แซนด์บ็อกซ์" จะเรียกใช้การดำเนินการที่รองรับผู้ปฏิบัติงานถาวรโดยใช้กลยุทธ์ผู้ปฏิบัติงาน และเรียกใช้การดำเนินการอื่นๆ ทั้งหมดที่ใช้กลยุทธ์แซนด์บ็อกซ์ หากไม่ได้ระบุวิธีช่วยจำ ระบบจะใช้รายการกลยุทธ์เป็นรายการสำรองสำหรับการช่วยจำทั้งหมด รายการสำรองเริ่มต้นคือ "worker,sandboxed" หรือ "worker,sandboxed,อัปเกรด" หากตั้งค่า "experimental_local_lockfree_output" ต้องใช้ [mnemonic=]local_strategy[,local_strategy,...]
แท็ก: execution host_machine_resource_optimizations
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment> รายการ
กลยุทธ์ระยะไกลเพื่อที่จะนำไปใช้สำหรับการช่วยจำที่ระบุ ระบบจะใช้กลยุทธ์แรกที่เกี่ยวข้อง หากไม่ได้ระบุวิธีช่วยจำ ระบบจะใช้รายการกลยุทธ์เป็นรายการสำรองสำหรับการช่วยจำทั้งหมด รายการสำรองเริ่มต้นคือ "remote" ดังนั้นโดยปกติจึงไม่จำเป็นต้องตั้งค่าแฟล็กนี้อย่างชัดแจ้ง ต้องใช้ [mnemonic=]remote_strategy[,remote_strategy,...]
แท็ก: execution host_machine_resource_optimizations
ค่าเริ่มต้นของ --experimental_docker_image=<a string>: ""
ระบุชื่ออิมเมจ Docker (เช่น "ubuntu:latest") ที่ควรจะใช้เพื่อดำเนินการแซนด์บ็อกซ์เมื่อใช้กลยุทธ์ Docker และตัวการดำเนินการยังไม่มีแอตทริบิวต์รูปภาพคอนเทนเนอร์ใน Remote_execution_properties ในคำอธิบายแพลตฟอร์ม ค่าของแฟล็กนี้ส่งผ่านแบบคำต่อคำไปยัง "docker Run" ดังนั้นจึงรองรับไวยากรณ์และกลไกเดียวกันกับ Docker
แท็ก: execution
ค่าเริ่มต้น --[no]experimental_docker_use_customized_images: "true"
หากเปิดใช้ ระบบจะแทรก uid และ gid ของผู้ใช้ปัจจุบันลงในอิมเมจ Docker ก่อนใช้งาน ซึ่งจำเป็นหากบิลด์ / การทดสอบของคุณขึ้นอยู่กับผู้ใช้ที่มีชื่อและไดเรกทอรีหน้าแรกในคอนเทนเนอร์ ตัวเลือกนี้เปิดใช้งานโดยค่าเริ่มต้น แต่คุณสามารถปิดใช้งานได้ในกรณีที่ฟีเจอร์การปรับแต่งรูปภาพอัตโนมัติไม่ทำงานในกรณีของคุณ หรือคุณทราบว่าไม่จำเป็นต้องใช้
แท็ก: execution
ค่าเริ่มต้น --[no]experimental_dynamic_exclude_tools: "true"
เมื่อตั้งค่าแล้ว เป้าหมายที่เป็น "สำหรับเครื่องมือ" ไม่ต้องใช้การเรียกใช้แบบไดนามิก เป้าหมายดังกล่าวไม่มีแนวโน้มที่จะสร้างทีละส่วน จึงไม่คุ้มกับการใช้จ่ายในพื้นที่
แท็ก: execution host_machine_resource_optimizations
ค่าเริ่มต้น --experimental_dynamic_local_load_factor=<a double>: "0"
ควบคุมปริมาณภาระงานจากการดำเนินการแบบไดนามิกที่จะนำขึ้นเครื่องภายใน แฟล็กนี้จะปรับจำนวนการดำเนินการในการดำเนินการแบบไดนามิกที่เราจะกำหนดเวลาพร้อมกัน ขึ้นอยู่กับจำนวน CPU ที่ Blaze คิดว่าพร้อมใช้งาน ซึ่งควบคุมได้ด้วยแฟล็ก --local_cpu_resources หากแฟล็กนี้เป็น 0 ระบบจะกำหนดเวลาการดำเนินการทั้งหมดในเครื่องทันที หาก > 0 จำนวนการดำเนินการที่กำหนดเวลาไว้ภายในเครื่องจะจำกัดตามจำนวน CPU ที่ใช้ได้ ถ้า < 1 ปัจจัยในการโหลดจะใช้เพื่อลดจำนวนการดำเนินการที่กำหนดเวลาไว้ภายในเครื่องเมื่อมีจำนวนการดำเนินการที่รอกำหนดเวลาอยู่ในระดับสูง ซึ่งจะช่วยลดโหลดของเครื่องภายในในเคสบิลด์ที่สะอาด ซึ่งเครื่องในเครือข่ายอาจไม่ให้ผลมากนัก
แท็ก: execution host_machine_resource_optimizations
ค่าเริ่มต้น --experimental_dynamic_slow_remote_time=<An immutable length of time.>: "0"
หากมากกว่า 0 เวลาที่การดำเนินการแบบไดนามิกจะต้องเรียกใช้จากระยะไกลเท่านั้นก่อนที่เราจะจัดลำดับความสำคัญของการดำเนินการในเครื่องเพื่อหลีกเลี่ยงการหมดเวลาจากระยะไกล วิธีนี้อาจซ่อนปัญหาบางอย่างในระบบการดำเนินการระยะไกล อย่าเปิดฟีเจอร์นี้โดยไม่ตรวจสอบปัญหาด้านการดำเนินการจากระยะไกล
แท็ก: execution host_machine_resource_optimizations
ค่าเริ่มต้น --[no]experimental_enable_docker_sandbox: "เท็จ"
เปิดใช้แซนด์บ็อกซ์ที่อิงตาม Docker ตัวเลือกนี้จะไม่มีผลหากไม่ได้ติดตั้ง Docker
แท็ก: execution
ค่าเริ่มต้น --experimental_sandbox_async_tree_delete_idle_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">: "4"
หากค่าเป็น 0 ให้ลบแผนผังแซนด์บ็อกซ์ทันทีที่การทำงานเสร็จสิ้น (ทำให้การดำเนินการเสร็จสิ้นล่าช้า) หากมากกว่า 0 ให้ดำเนินการลบ 3 รายการดังกล่าวใน Thread Pool แบบไม่พร้อมกันที่มีขนาด 1 เมื่อบิลด์ทำงานอยู่และเติบโตเป็นขนาดที่ระบุโดย Flag นี้เมื่อเซิร์ฟเวอร์ไม่มีการใช้งาน
แท็ก: host_machine_resource_optimizations execution
ค่าเริ่มต้น --experimental_sandbox_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>: "0"
หาก > 0 แซนด์บ็อกซ์ของ Linux แต่ละแซนด์บ็อกซ์จะถูกจำกัดปริมาณหน่วยความจำที่ระบุ (เป็น MB) ต้องใช้ cgroups v1 หรือ v2 และสิทธิ์สำหรับผู้ใช้ในการเข้าถึงไดเรกทอรี cgroups
แท็ก: execution
ค่าเริ่มต้น --[no]experimental_shrink_worker_pool: "เท็จ"
หากเปิดใช้ อาจย่อพูลผู้ปฏิบัติงานหากหน่วยความจำของผู้ปฏิบัติงานสูง การตั้งค่าสถานะนี้จะทำงานเมื่อเปิดใช้งานการตั้งค่าสถานะ Experiment_total_worker_memory_limit_mb เท่านั้น
แท็ก: execution host_machine_resource_optimizations
ค่าเริ่มต้น --[no]experimental_split_xml_generation: "true"
หากมีการกำหนดแฟล็กนี้ และการดำเนินการทดสอบไม่สร้างไฟล์ test.xml ขึ้นมา Bazel จะใช้การดำเนินการแยกต่างหากเพื่อสร้างไฟล์ test.xml จำลองที่มีบันทึกการทดสอบ มิฉะนั้น Bazel จะสร้าง test.xml เป็นส่วนหนึ่งของการดำเนินการทดสอบ
แท็ก: execution
ค่าเริ่มต้น --experimental_total_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>: "0"
หากขีดจำกัดนี้มากกว่า 0 ผู้ปฏิบัติงานที่ไม่มีการใช้งานอาจหยุดทำงานหากการใช้งานหน่วยความจำรวมของผู้ปฏิบัติงานทั้งหมดเกินขีดจำกัด
แท็ก: execution host_machine_resource_optimizations
ค่าเริ่มต้น --[no]experimental_use_hermetic_linux_sandbox: "เท็จ"
หากตั้งค่าเป็น "จริง" ไม่ต้องต่อเชื่อมรูท ให้ต่อเชื่อมเฉพาะสิ่งที่มาพร้อมกับ sandbox_add_mount_pair ไฟล์ที่ป้อนจะฮาร์ดลิงก์ไปยังแซนด์บ็อกซ์แทนที่จะลิงก์มาจากแซนด์บ็อกซ์ หากไฟล์อินพุตการดำเนินการอยู่ในระบบไฟล์ที่แตกต่างจากแซนด์บ็อกซ์ ระบบจะคัดลอกไฟล์อินพุตแทน
แท็ก: execution
ค่าเริ่มต้น --[no]experimental_use_semaphore_for_jobs: "true"
หากตั้งค่าเป็น "จริง" ให้ใช้ Semaphore เพิ่มเติมเพื่อจำกัดจำนวนงานที่เกิดขึ้นพร้อมกัน
แท็ก: host_machine_resource_optimizations execution
ค่าเริ่มต้น --[no]experimental_use_windows_sandbox: "เท็จ"
ใช้แซนด์บ็อกซ์ของ Windows เพื่อเรียกใช้การดำเนินการ หากเป็น "ใช่" ไบนารีที่ระบุโดย --experimental_windows_sandbox_path ต้องเป็นไฟล์ที่ถูกต้องและสอดคล้องกับ sandboxfs เวอร์ชันที่รองรับ หากเป็น "auto" ไบนารีอาจหายไปหรือเข้ากันไม่ได้
แท็ก: execution
ค่าเริ่มต้นของ --experimental_windows_sandbox_path=<a string>: "BazelSandbox.exe"
เส้นทางไปยังไบนารีแซนด์บ็อกซ์ของ Windows เพื่อใช้เมื่อ --experimental_use_windows_sandbox เป็นจริง หากเป็นชื่อเปล่า ให้ใช้ไบนารีแรกของชื่อที่พบใน PATH
แท็ก: execution
ค่าเริ่มต้น --experimental_worker_allowlist=<comma-separated set of options>: ดูคำอธิบาย
หากไม่ว่างเปล่า อนุญาตให้ใช้เฉพาะผู้ปฏิบัติงานถาวรที่มีความสามารถในการจำของคีย์ผู้ปฏิบัติงานที่ระบุ
แท็ก: execution host_machine_resource_optimizations
ค่าเริ่มต้น --[no]experimental_worker_as_resource: "true"
ไม่มีการดำเนินการ จะถูกนำออกในเร็วๆ นี้
แท็ก: no_op
ค่าเริ่มต้น --[no]experimental_worker_cancellation: "เท็จ"
หากเปิดใช้ Bazel อาจส่งคำขอยกเลิกไปยังผู้ปฏิบัติงานที่ให้การสนับสนุน
แท็ก: execution
ค่าเริ่มต้น --experimental_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>: "0"
หากขีดจำกัดนี้มากกว่า 0 ผู้ปฏิบัติงานอาจหยุดทำงานหากการใช้งานหน่วยความจำของผู้ปฏิบัติงานเกินขีดจำกัด หากไม่ใช้ร่วมกับการดำเนินการแบบไดนามิกและ "--experimental_dynamic_ignore_local_signals=9" อาจทำให้บิลด์ของคุณขัดข้อง
แท็ก: execution host_machine_resource_optimizations
ค่าเริ่มต้น --experimental_worker_metrics_poll_interval=<An immutable length of time.>: "5s"
ช่วงเวลาระหว่างการรวบรวมเมตริกผู้ปฏิบัติงานและอาจต้องพยายามปลดออก ประสิทธิภาพต้องไม่น้อยกว่า 1 วินาทีเนื่องจากเหตุผลด้านประสิทธิภาพ
แท็ก: execution host_machine_resource_optimizations
ค่าเริ่มต้น --[no]experimental_worker_multiplex_sandboxing: "เท็จ"
หากเปิดใช้ ระบบจะแซนด์บ็อกซ์ผู้ปฏิบัติงานมัลติเพล็กซ์โดยใช้ไดเรกทอรีแซนด์บ็อกซ์แยกต่างหากตามคำของาน เฉพาะผู้ปฏิบัติงานที่มี "supports- Multiplex-sandboxing" ข้อกำหนดการดำเนินการจะถูกแซนด์บ็อกซ์
แท็ก: execution
ค่าเริ่มต้น --[no]experimental_worker_sandbox_hardening: "เท็จ"
หากเปิดใช้ ผู้ปฏิบัติงานจะทำงานในแซนด์บ็อกซ์ที่แข็งแกร่ง หากการใช้งานอนุญาตให้ทำได้
แท็ก: execution
ค่าเริ่มต้น --[no]experimental_worker_strict_flagfiles: "เท็จ"
หากเปิดใช้ อาร์กิวเมนต์การดำเนินการสำหรับผู้ปฏิบัติงานที่ไม่เป็นไปตามข้อกำหนดของผู้ปฏิบัติงานจะเกิดข้อผิดพลาด อาร์กิวเมนต์ผู้ปฏิบัติงานต้องมีอาร์กิวเมนต์ @flagfile เพียง 1 รายการเป็นรายการอาร์กิวเมนต์สุดท้าย
แท็ก: execution
ค่าเริ่มต้น --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
เปอร์เซ็นต์ของพื้นที่เก็บข้อมูลเต็ม (0-100) ซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์แรงดันหน่วยความจำเทียบกับขีดจำกัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก: host_machine_resource_optimizations
ค่าเริ่มต้นของ --genrule_strategy=<comma-separated list of options>: ""
ระบุวิธีเรียกใช้ Genrule การแจ้งว่าไม่เหมาะสมนี้จะถูกนำออก ให้ใช้ --spawn_strategy=<value> แทน เพื่อควบคุมการดำเนินการทั้งหมด หรือ --strategy=Genrule=<value> เพื่อควบคุม Genrules เท่านั้น
แท็ก: execution
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --high_priority_workers=<a string> รายการ
ไม่มีการดำเนินการ จะถูกนำออกในเร็วๆ นี้
แท็ก: execution
หากตั้งค่าเป็น "จริง" ลิงก์สัญลักษณ์ที่อัปโหลดไปยังแคชระยะไกลหรือดิสก์แคชจะได้รับอนุญาตให้ห้อยคอได้
แท็ก: execution incompatible_change
หากตั้งค่าเป็น "จริง" Bazel จะอัปโหลดลิงก์สัญลักษณ์ไปยังรีโมตหรือดิสก์แคชเสมอ มิฉะนั้นระบบจะอัปโหลดลิงก์สัญลักษณ์ที่เกี่ยวข้องที่ไม่ก่อให้เกิดอันตรายเป็นไฟล์หรือไดเรกทอรีที่ลิงก์ไป
แท็ก: execution incompatible_change
ค่าเริ่มต้น --[no]incompatible_sandbox_hermetic_tmp: "true"
หากตั้งค่าเป็น "จริง" แซนด์บ็อกซ์ของ Linux แต่ละรายการจะมีไดเรกทอรีว่างเฉพาะของตัวเองต่อเชื่อมเป็น /tmp แทนที่จะแชร์ /tmp กับระบบไฟล์ของโฮสต์ ใช้ --sandbox_add_mount_pair=/tmp เพื่อดู /tmp ของโฮสต์ต่อไปในแซนด์บ็อกซ์ทั้งหมด
แท็ก: execution
ค่าเริ่มต้น --[no]internal_spawn_scheduler: "เท็จ"
ตัวเลือกตัวยึดตำแหน่งเพื่อให้เราสามารถบอกใน Blaze ว่าเครื่องจัดตารางเวลาสร้างได้เปิดใช้อยู่หรือไม่
แท็ก: execution host_machine_resource_optimizations
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> [-j] ค่าเริ่มต้น: "อัตโนมัติ"
จำนวนงานที่เกิดขึ้นพร้อมกันที่จะเรียกใช้ ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") โดยจะเลือกตามด้วยการดำเนินการ ([-|*]<Float>) เช่น "auto", "HOST_CPUS*.5" ค่าต้องอยู่ระหว่าง 1 ถึง 5000 ค่าที่สูงกว่า 2,500 อาจก่อให้เกิดปัญหาเกี่ยวกับหน่วยความจำ "อัตโนมัติ" จะคำนวณค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์
แท็ก: host_machine_resource_optimizations execution
--[no]keep_going [-k] ค่าเริ่มต้น: "เท็จ"
ดำเนินการต่อให้มากที่สุดหลังจากเกิดข้อผิดพลาด แม้ว่าเป้าหมายที่ล้มเหลวและเป้าหมายที่อ้างอิงอยู่จะไม่สามารถวิเคราะห์ได้ แต่ข้อกําหนดเบื้องต้นอื่นๆ ของเป้าหมายเหล่านี้อาจเป็นไปได้
แท็ก: eagerness_to_exit
ค่าเริ่มต้น --loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">: "อัตโนมัติ"
จำนวนชุดข้อความแบบขนานที่จะใช้สำหรับขั้นตอนการโหลด/การวิเคราะห์ ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") หรือเลือกตามด้วยการดำเนินการ ([-|*]<Float>) เช่น "auto", "HOST_CPUS*.5" "อัตโนมัติ" ตั้งค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --[no]reuse_sandbox_directories: "true"
หากตั้งค่าเป็น "จริง" ระบบอาจนำไดเรกทอรีที่ใช้โดยการดำเนินการที่ไม่ใช่ผู้ปฏิบัติงานโดยใช้แซนด์บ็อกซ์มาใช้ใหม่เพื่อหลีกเลี่ยงค่าใช้จ่ายที่ไม่จำเป็นในการตั้งค่า
แท็ก: host_machine_resource_optimizations execution
ค่าเริ่มต้นของ --sandbox_base=<a string>: ""
อนุญาตให้แซนด์บ็อกซ์สร้างไดเรกทอรีแซนด์บ็อกซ์ของตนภายใต้เส้นทางนี้ ระบุเส้นทางบน tmpfs (เช่น /run/shm) เพื่ออาจปรับปรุงประสิทธิภาพได้อย่างมากเมื่อบิลด์ / การทดสอบของคุณมีไฟล์อินพุตจำนวนมาก หมายเหตุ: คุณต้องมี RAM และพื้นที่ว่างใน tmpfs เพียงพอที่จะเก็บเอาต์พุตและไฟล์กลางที่สร้างขึ้นโดยการเรียกใช้การดำเนินการ
แท็ก: host_machine_resource_optimizations execution
ค่าเริ่มต้น --[no]sandbox_explicit_pseudoterminal: "เท็จ"
อนุญาตให้สร้าง Pseudoterminals สำหรับการดำเนินการแซนด์บ็อกซ์อย่างชัดเจน การใช้ Linux บางโปรแกรมต้องตั้งค่ารหัสกลุ่มของกระบวนการเป็น "tty" ภายในแซนด์บ็อกซ์เพื่อให้ Pseudoterminals ทำงาน หากการทำเครื่องหมายนี้ก่อให้เกิดปัญหา ให้ปิดการแจ้งปัญหานี้เพื่อให้ใช้งานกลุ่มอื่นๆ ได้
แท็ก: execution
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --sandbox_tmpfs_path=<an absolute path> รายการ
สำหรับการดำเนินการที่ทำแซนด์บ็อกซ์ ให้ต่อเชื่อมไดเรกทอรีที่ว่างเปล่าซึ่งเขียนได้ไว้ที่เส้นทางสัมบูรณ์นี้ (หากการใช้แซนด์บ็อกซ์รองรับ และจะไม่พิจารณา มิฉะนั้น)
แท็ก: host_machine_resource_optimizations execution
ค่าเริ่มต้น --[no]skip_incompatible_explicit_targets: "เท็จ"
ข้ามเป้าหมายที่ใช้ร่วมกันไม่ได้ซึ่งระบุไว้อย่างชัดแจ้งในบรรทัดคำสั่ง โดยค่าเริ่มต้น การสร้างเป้าหมายดังกล่าวจะทำให้เกิดข้อผิดพลาด แต่เป้าหมายเหล่านี้จะถูกข้ามโดยอัตโนมัติเมื่อเปิดใช้ตัวเลือกนี้ ดูที่ https://bazel.build/extending/platforms#skipping-incompatible-targets
แท็ก: loading_and_analysis
ค่าเริ่มต้นของ --spawn_strategy=<comma-separated list of options>: ""
ระบุวิธีการสร้างคำสั่งเริ่มต้น ยอมรับรายการกลยุทธ์ที่คั่นด้วยจุลภาคจากลำดับความสำคัญสูงสุดไปต่ำสุด สำหรับการกระทำแต่ละรายการ Bazel จะเลือกกลยุทธ์ที่มีลำดับความสำคัญสูงสุดที่สามารถกระทำได้ ค่าเริ่มต้นคือ "remote,worker,sandboxed,local" ดูรายละเอียดได้ที่ https://blog.bazel.build/2019/06/19/list-strategy.html
แท็ก: execution
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --strategy=<a '[name=]value1[,..,valueN]' assignment> รายการ
ระบุวิธีการเผยแพร่การคอมไพล์การดำเนินการอื่นๆ ที่สร้างขึ้น ยอมรับรายการกลยุทธ์ที่คั่นด้วยจุลภาคจากลำดับความสำคัญสูงสุดไปต่ำสุด สำหรับการกระทำแต่ละรายการ Bazel จะเลือกกลยุทธ์ที่มีลำดับความสำคัญสูงสุดที่สามารถกระทำได้ ค่าเริ่มต้นคือ "remote,worker,sandboxed,local" แฟล็กนี้จะลบล้างค่าที่กำหนดโดย --spawn_strategy (และ --genrule_strategy หากใช้กับ mnemonic Genrule) ดูรายละเอียดได้ที่ https://blog.bazel.build/2019/06/19/list-strategy.html
แท็ก: execution
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --strategy_regexp=<a '<RegexFilter>=value[,value]' assignment> รายการ
ลบล้างกลยุทธ์การสร้างที่สร้างขึ้นเพื่อเรียกใช้การดำเนินการที่สร้างขึ้นซึ่งมีคำอธิบายตรงกับ regex_filter บางรายการ ดู --per_file_copt สำหรับรายละเอียดการจับคู่เกี่ยวกับนิพจน์ทั่วไป ระบบจะใช้ regex_filter สุดท้ายที่ตรงกับคำอธิบาย ตัวเลือกนี้จะลบล้างแฟล็กอื่นๆ สำหรับการระบุกลยุทธ์ ตัวอย่าง: --strategy_regexp=//foo.*\.cc,-//foo/bar=local หมายถึงการเรียกใช้การดำเนินการโดยใช้กลยุทธ์ท้องถิ่นหากคำอธิบายตรงกับ //foo.*.cc แต่ไม่ตรงกับ //foo/bar ตัวอย่างเช่น --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed จะเรียกใช้ 'Compiling //foo/bar/baz' พร้อมแป้น "local" แต่การกลับลำดับคำสั่งซื้อจะทำงานด้วย "แซนด์บ็อกซ์"
แท็ก: execution
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --worker_extra_flag=<a 'name=value' assignment> รายการ
แฟล็กคำสั่งเพิ่มเติมที่จะส่งผ่านไปยังกระบวนการของพนักงานนอกเหนือจาก --persistent_worker ซึ่งคีย์โดย Mnemonic (เช่น --worker_extra_flag=Javac=--debug
แท็ก: execution host_machine_resource_optimizations
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --worker_max_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> รายการ
จำนวนอินสแตนซ์ของผู้ปฏิบัติงานที่ทำงานต่อเนื่องแต่ละประเภทที่อาจมีการเปิดใช้หากคุณใช้ "ผู้ปฏิบัติงาน" ของคุณ อาจระบุเป็น [name=value] เพื่อให้ค่าที่แตกต่างกันต่อความทรงจำ ขีดจำกัดนี้อิงตามคีย์ผู้ปฏิบัติงาน ซึ่งแตกต่างกันตามการจำ และขึ้นอยู่กับแฟล็กและสภาพแวดล้อมการเริ่มต้นด้วย ดังนั้นในบางกรณีอาจมีผู้ปฏิบัติงานต่อความทรงจำมากกว่าที่แฟล็กนี้ระบุ ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") โดยจะเลือกตามด้วยการดำเนินการ ([-|*]<Float>) เช่น "auto", "HOST_CPUS*.5" "auto" จะคำนวณค่าเริ่มต้นที่สมเหตุสมผลตามความจุของเครื่อง "=ค่า" จะตั้งค่าเริ่มต้นสำหรับการช่วยจำที่ไม่ระบุ
แท็ก: execution host_machine_resource_optimizations
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --worker_max_multiplex_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> รายการ
จำนวนของ WorkRequest ที่ผู้ปฏิบัติงานมัลติเพล็กซ์จะได้รับพร้อมกันหากคุณใช้ "ผู้ปฏิบัติงาน" ด้วย --worker_multiplex อาจระบุเป็น [name=value] เพื่อให้ค่าที่แตกต่างกันต่อความทรงจำ ขีดจำกัดนี้อิงตามคีย์ผู้ปฏิบัติงาน ซึ่งแตกต่างกันตามการจำ และขึ้นอยู่กับแฟล็กและสภาพแวดล้อมการเริ่มต้นด้วย ดังนั้นในบางกรณีอาจมีผู้ปฏิบัติงานต่อความทรงจำมากกว่าที่แฟล็กนี้ระบุ ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") โดยจะเลือกตามด้วยการดำเนินการ ([-|*]<Float>) เช่น "auto", "HOST_CPUS*.5" "auto" จะคำนวณค่าเริ่มต้นที่สมเหตุสมผลตามความจุของเครื่อง "=ค่า" จะตั้งค่าเริ่มต้นสำหรับการช่วยจำที่ไม่ระบุ
แท็ก: execution host_machine_resource_optimizations
ค่าเริ่มต้น --[no]worker_multiplex: "true"
หากเปิดใช้ ผู้ปฏิบัติงานจะใช้การมัลติเพล็กซ์หากรองรับ
แท็ก: execution host_machine_resource_optimizations
ค่าเริ่มต้น --[no]worker_quit_after_build: "เท็จ"
หากเปิดใช้ ผู้ปฏิบัติงานทั้งหมดจะออกหลังจากบิลด์เสร็จสิ้น
แท็ก: execution host_machine_resource_optimizations
ค่าเริ่มต้น --[no]worker_sandboxing: "เท็จ"
หากเปิดใช้ ผู้ปฏิบัติงานจะถูกดำเนินการในสภาพแวดล้อมแบบแซนด์บ็อกซ์
แท็ก: execution
ค่าเริ่มต้น --[no]worker_verbose: "เท็จ"
หากเปิดใช้ พิมพ์ข้อความแบบละเอียดเมื่อผู้ปฏิบัติงานเริ่มงาน ปิดเครื่อง ...
ตัวเลือกที่กำหนดค่า Toolchain ที่ใช้สำหรับการดำเนินการมีดังนี้
ค่าเริ่มต้นของ --target_platform_fallback=<a string>: ""
ตัวเลือกนี้เลิกใช้งานแล้วและไม่ส่งผลใดๆ
แท็ก: affects_outputs, changes_inputs, loading_and_analysis
ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่ง:
ค่าเริ่มต้น --[no]build: "true"
ดำเนินการสร้าง นี่เป็นลักษณะการทำงานปกติ การระบุ --nobuild จะทำให้บิลด์หยุดทำงานก่อนที่จะดำเนินการของบิลด์ ซึ่งแสดงผลเป็น 0 หากขั้นตอนการโหลดแพ็กเกจและการวิเคราะห์เสร็จสมบูรณ์ โหมดนี้มีประโยชน์ในการทดสอบระยะเหล่านั้น
แท็ก: execution affects_outputs
ค่าเริ่มต้น --[no]experimental_use_validation_aspect: "เท็จ"
เลือกว่าจะเรียกใช้การตรวจสอบโดยใช้มุมมอง (สำหรับการทำงานพร้อมกันกับการทดสอบ) หรือไม่
แท็ก: execution affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --output_groups=<comma-separated list of options> รายการ
รายการของชื่อกลุ่มเอาต์พุตที่คั่นด้วยคอมมา ซึ่งแต่ละรายการอาจนำหน้าด้วยเครื่องหมาย + หรือ - ระบบจะเพิ่มกลุ่มที่ขึ้นต้นด้วย + ลงในชุดกลุ่มเอาต์พุตเริ่มต้น ส่วนกลุ่มที่ขึ้นต้นด้วย - จะถูกนำออกจากชุดเริ่มต้น หากมีอย่างน้อย 1 กลุ่มที่ไม่มีคำนำหน้า ระบบจะละเว้นชุดกลุ่มเอาต์พุตเริ่มต้น ตัวอย่างเช่น --output_groups=+foo,+bar จะสร้างการรวมของชุดเริ่มต้น ได้แก่ foo และ bar ในขณะที่ --output_groups=foo,bar จะลบล้างชุดเริ่มต้นที่สร้างเฉพาะ foo และ bar
แท็ก: execution affects_outputs
ค่าเริ่มต้น --[no]run_validations: "true"
ระบุว่าจะเรียกใช้การดำเนินการตรวจสอบเป็นส่วนหนึ่งของบิลด์หรือไม่ โปรดดู https://bazel.build/extending/rules#Validation_actions
แท็ก: execution affects_outputs
ตัวเลือกที่ให้ผู้ใช้กำหนดค่า
เอาต์พุตที่ต้องการ ซึ่งส่งผลต่อค่าของผลลัพธ์ ไม่ใช่ค่าที่มีอยู่
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --aspects=<comma-separated list of options> รายการ
รายการด้านที่คั่นด้วยจุลภาคที่จะนำไปใช้กับเป้าหมายระดับบนสุด ในรายการนี้ หากลักษณะ some_aspect ระบุผู้ให้บริการด้านที่จำเป็นผ่าน required_aspect_providers นั้น some_aspect จะทำงานหลังจากทุกด้านที่พูดถึงก่อนหน้าในรายการด้านที่ผู้ให้บริการด้านโฆษณาตอบสนองผู้ให้บริการด้านบางด้านที่จำเป็น นอกจากนี้ some_aspect จะทำงานหลังจากด้านที่ต้องระบุทั้งหมดที่ระบุไว้โดย required [แอตทริบิวต์] จากนั้น some_aspect จะมีสิทธิ์เข้าถึงคุณค่าของแง่มุมเหล่านั้น ผู้ให้บริการเครือข่าย <bzl-file-label>%<aspect_name> เช่น '//tools:my_def.bzl%my_aspect' โดยที่ 'my_aspect' เป็นค่าระดับบนสุดจากเครื่องมือไฟล์/my_def.bzl
ค่าเริ่มต้น --bep_maximum_open_remote_upload_files=<an integer>: "-1"
จำนวนไฟล์เปิดสูงสุดที่อนุญาตระหว่างการอัปโหลดอาร์ติแฟกต์ BEP
แท็ก: affects_outputs
แฟล็กนี้ควบคุมวิธีจัดการลิงก์สัญลักษณ์ตามความสะดวก (ลิงก์สัญลักษณ์ที่ปรากฏในพื้นที่ทำงานหลังบิลด์) ค่าที่เป็นไปได้มีดังนี้ ปกติ (ค่าเริ่มต้น): ระบบจะสร้างหรือลบลิงก์สัญลักษณ์เพื่อความสะดวกแต่ละประเภทตามที่กำหนดโดยบิลด์ สะอาด: ลิงก์สัญลักษณ์ทั้งหมดจะถูกลบโดยไม่มีเงื่อนไข เพิกเฉย: สัญลักษณ์ลิงก์จะไม่ปรากฏเพียงอย่างเดียว log_only: สร้างข้อความบันทึกเสมือนเป็น "ปกติ" ผ่าน แต่ไม่ได้ดำเนินการเกี่ยวกับระบบไฟล์จริงๆ (มีประโยชน์สำหรับเครื่องมือ) โปรดทราบว่าเฉพาะลิงก์สัญลักษณ์ที่มีชื่อที่สร้างขึ้นด้วยค่าปัจจุบันของ --symlink_prefix เท่านั้นที่อาจได้รับผลกระทบ หากคำนำหน้าเปลี่ยนไป ลิงก์สัญลักษณ์ที่มีอยู่แล้วก็จะถูกปล่อยไว้ตามเดิม
แท็ก: affects_outputs
แฟล็กนี้ควบคุมว่าเราจะโพสต์เหตุการณ์บิลด์ConvenienceSymlinksIdentified ไปยัง BuildEventProtocol หรือไม่ หากค่าเป็น "จริง" BuildEventProtocol จะมีรายการ ConvesSymlinksIdentified ที่มีรายการลิงก์สัญลักษณ์แบบอำนวยความสะดวกทั้งหมดที่สร้างในพื้นที่ทำงานของคุณ หากเป็น "เท็จ" รายการ meetSymlinksIdentified ใน BuildEventProtocol จะว่างเปล่า
แท็ก: affects_outputs
--remote_download_all
ดาวน์โหลดเอาต์พุตระยะไกลทั้งหมดไปยังเครื่องภายใน แฟล็กนี้เป็นชื่อแทนของ --remote_download_outputs=all
ขยายเป็น

--remote_download_outputs=all
แท็ก: affects_outputs
--remote_download_minimal
ไม่ดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลไปยังเครื่องภายใน แฟล็กนี้เป็นชื่อแทนของ --remote_download_outputs=minimal
ขยายเป็น

--remote_download_outputs=minimal
แท็ก: affects_outputs
ค่าเริ่มต้น --remote_download_outputs=<all, minimal or toplevel>: "ระดับบนสุด"
หากตั้งค่าเป็น "ขั้นต่ำ" จะไม่ดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลไปยังเครื่องภายใน ยกเว้นเอาต์พุตที่การดำเนินการในเครื่องจำเป็นต้องใช้ หากตั้งค่าเป็น "ระดับบนสุด" แสดงตัวเหมือน "น้อยมาก" เว้นแต่ว่าจะดาวน์โหลดเอาต์พุตของเป้าหมายระดับบนสุดไปยังเครื่องภายในด้วย ตัวเลือกทั้ง 2 รายการจะช่วยลดเวลาบิลด์ได้อย่างมากหากแบนด์วิดท์ของเครือข่ายเป็นจุดคอขวด
แท็ก: affects_outputs
สร้างลิงก์สัญลักษณ์แทนการดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลไปยังเครื่องภายใน ระบุเป้าหมายของลิงก์สัญลักษณ์ในรูปแบบสตริงเทมเพลตได้ สตริงเทมเพลตนี้อาจมี {hash} และ {size_bytes} ที่ขยายเป็นแฮชของออบเจ็กต์และขนาดเป็นไบต์ตามลำดับ เช่น ลิงก์สัญลักษณ์เหล่านี้อาจชี้ไปยังระบบไฟล์ FUSE ที่โหลดออบเจ็กต์จาก CAS ตามคำขอ
แท็ก: affects_outputs
--remote_download_toplevel
ดาวน์โหลดเฉพาะเอาต์พุตระยะไกลของเป้าหมายระดับบนสุดไปยังเครื่องภายในเท่านั้น แฟล็กนี้เป็นชื่อแทนของ --remote_download_outputs=toplevel
ขยายเป็น

--remote_download_outputs=toplevel
แท็ก: affects_outputs
คำนำหน้าที่เพิ่มด้านหน้าของลิงก์สัญลักษณ์แบบอำนวยความสะดวกที่สร้างขึ้นหลังบิลด์ หากไม่ระบุ ค่าเริ่มต้นจะเป็นชื่อของเครื่องมือสร้างตามด้วยขีดกลาง ถ้า '/' จะไม่มีการสร้างลิงก์สัญลักษณ์และไม่มีคำเตือน คำเตือน: ฟังก์ชันพิเศษสำหรับ "/" จะเลิกใช้งานเร็วๆ นี้ โปรดใช้ --experimental_convenience_symlinks=ignore แทน
แท็ก: affects_outputs
ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตบิลด์ที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมธง ฯลฯ)
ค่าเริ่มต้น --[no]experimental_docker_privileged: "เท็จ"
หากเปิดใช้งาน Bazel จะส่งธง --Privileified ไปยัง "Doker Run" เมื่อเรียกใช้การดำเนินการ การทำงานนี้อาจจำเป็นสำหรับงานสร้างของคุณ แต่ก็อาจส่งผลให้มีเนื้อที่น้อยลงด้วย
แท็ก: execution
ไม่มีการดำเนินการ
แท็ก: host_machine_resource_optimizations, execution
ค่าเริ่มต้น --[no]incompatible_legacy_local_fallback: "เท็จ"
หากตั้งค่าเป็น "จริง" จะเปิดใช้วิดีโอสำรองโดยนัยแบบเดิมจากแซนด์บ็อกซ์เป็นกลยุทธ์ในเครื่อง แฟล็กนี้จะมีค่าเริ่มต้นเป็น "เท็จ" และจะกลายเป็น no-op ใช้ --strategy, --spawn_strategy หรือ --dynamic_local_strategy กำหนดค่าวิดีโอสำรองแทน
แท็ก: execution incompatible_change
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --sandbox_add_mount_pair=<a single path or a 'source:target' pair> รายการ
เพิ่มคู่เส้นทางเพิ่มเติมเพื่อต่อเชื่อมในแซนด์บ็อกซ์
แท็ก: execution
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --sandbox_block_path=<a string> รายการ
สำหรับการดำเนินการที่ทำแซนด์บ็อกซ์ โปรดอย่าอนุญาตการเข้าถึงนี้
แท็ก: execution
ค่าเริ่มต้น --[no]sandbox_default_allow_network: "true"
อนุญาตการเข้าถึงเครือข่ายโดยค่าเริ่มต้นสำหรับการทำงาน ซึ่งอาจใช้ไม่ได้กับการใช้งานแซนด์บ็อกซ์บางประเภท
แท็ก: execution
ค่าเริ่มต้น --[no]sandbox_fake_hostname: "เท็จ"
เปลี่ยนชื่อโฮสต์ปัจจุบันเป็น "localhost" สำหรับการดำเนินการที่ทำแซนด์บ็อกซ์
แท็ก: execution
ค่าเริ่มต้น --[no]sandbox_fake_username: "เท็จ"
เปลี่ยนชื่อผู้ใช้ปัจจุบันเป็น "nobody" สำหรับการดำเนินการที่ทำแซนด์บ็อกซ์
แท็ก: execution
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --sandbox_writable_path=<a string> รายการ
สำหรับการดำเนินการที่ทำแซนด์บ็อกซ์ ให้ทำให้ไดเรกทอรีที่มีอยู่เขียนได้ในแซนด์บ็อกซ์ (หากการดำเนินการแซนด์บ็อกซ์รองรับ และจะไม่พิจารณาไดเรกทอรีอื่น)
แท็ก: execution
ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
ค่าเริ่มต้น --[no]incompatible_config_setting_private_default_visibility: "เท็จ"
หากไม่รองรับ _enforce_config_setting_visibility=false ค่าจะเป็น Noop หรือไม่เช่นนั้น หากแฟล็กนี้เป็นเท็จ config_setting ใดๆ ที่ไม่มีแอตทริบิวต์การเปิดเผยอย่างชัดแจ้งจะเป็น //visibility:public หากแฟล็กนี้เป็นจริง config_setting จะใช้ตรรกะระดับการเข้าถึงเดียวกันกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --[no]incompatible_enforce_config_setting_visibility: "true"
หากเป็น "จริง" ให้บังคับใช้การจำกัดระดับการเข้าถึง config_setting หากเป็น "เท็จ" ทุก config_setting จะปรากฏแก่เป้าหมายทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก: loading_and_analysis incompatible_change
ตัวเลือกที่ควบคุมพฤติกรรมของ
สภาพแวดล้อมการทดสอบหรือตัวดำเนินการทดสอบ:
ค่าเริ่มต้น --[no]check_tests_up_to_date: "เท็จ"
โดยไม่ต้องทำการทดสอบ เพียงแต่ต้องตรวจสอบว่าการทดสอบเป็นข้อมูลล่าสุดหรือไม่ หากผลการทดสอบทั้งหมดเป็นปัจจุบัน แสดงว่าการทดสอบเสร็จสมบูรณ์ หากต้องสร้างหรือดำเนินการทดสอบใดๆ ระบบจะรายงานข้อผิดพลาดและการทดสอบจะไม่สำเร็จ ตัวเลือกนี้กล่าวเป็นนัยถึงลักษณะการทำงาน --check_up_to_date
แท็ก: execution
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once> รายการ
ในกรณีที่การทดสอบล้มเหลว ระบบจะพยายามทดสอบซ้ำจนถึงจำนวนครั้งที่ระบุไว้ การทดสอบที่ต้องผ่านมากกว่า 1 ครั้งจะมีการทำเครื่องหมายเป็น "FLAKY" ในสรุปการทดสอบ โดยปกติแล้ว ค่าที่ระบุจะเป็นแค่จำนวนเต็มหรือสตริง "ค่าเริ่มต้น" หากเป็นจำนวนเต็ม การทดสอบทั้งหมดจะทำงานได้ไม่เกิน N ครั้ง หากเป็น "ค่าเริ่มต้น" ระบบจะพยายามทดสอบเพียงครั้งเดียวสำหรับการทดสอบปกติ และอีก 3 ครั้งสำหรับการทดสอบที่มีการทำเครื่องหมายอย่างชัดแจ้งว่า "ไม่สม่ำเสมอ" ตามกฎ (แอตทริบิวต์ flaky=1) ไวยากรณ์อื่น: regex_filter@flaky_test_attempts flaky_test_attempts เหมือนกับข้างต้น และ regex_filter ย่อมาจากรายการรวมและยกเว้นรูปแบบนิพจน์ทั่วไป (โปรดดู --runs_per_test) ตัวอย่าง: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 ดีเฟลกการทดสอบทั้งหมดใน //foo/ ยกเว้นการทดสอบที่อยู่ภายใต้ foo/bar 3 ครั้ง ตัวเลือกนี้ส่งได้หลายครั้ง อาร์กิวเมนต์ที่ส่งผ่านล่าสุดที่ตรงกันจะมีความสำคัญเหนือกว่า หากไม่มีผลลัพธ์ที่ตรงกัน ลักษณะการทำงานจะเป็นเหมือน "ค่าเริ่มต้น" ที่ด้านบน
แท็ก: execution
ค่าเริ่มต้น --local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">: "อัตโนมัติ"
จำนวนงานทดสอบในเครื่องที่จะเรียกใช้พร้อมกันสูงสุด ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") โดยจะเลือกตามด้วยการดำเนินการ ([-|*]<Float>) เช่น "auto", "HOST_CPUS*.5" 0 หมายความว่าทรัพยากรในเครื่องจะจำกัดจำนวนงานทดสอบในเครื่องที่จะเรียกใช้พร้อมกันแทน การตั้งค่านี้ที่มากกว่าค่าสำหรับ --jobs จะไม่มีผล
แท็ก: execution
ค่าเริ่มต้น --[no]test_keep_going: "true"
เมื่อปิดใช้ การทดสอบที่ไม่ผ่านจะทำให้ทั้งบิลด์หยุดทำงาน โดยค่าเริ่มต้น ระบบจะทำการทดสอบทั้งหมดแม้ว่าจะไม่ผ่านก็ตาม
แท็ก: execution
ค่าเริ่มต้นของ --test_strategy=<a string>: ""
ระบุกลยุทธ์ที่จะใช้เมื่อทำการทดสอบ
แท็ก: execution
ค่าเริ่มต้น --test_tmpdir=<a path>: ดูคำอธิบาย
ระบุไดเรกทอรีชั่วคราวพื้นฐานสําหรับ "การทดสอบ Bazel" ในการใช้กัน
ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตการค้นหาและความหมาย
ค่าเริ่มต้น --[no]experimental_parallel_aquery_output: "true"
ไม่มีการดำเนินการ
ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --allow_yanked_versions=<a string> รายการ
ระบุเวอร์ชันโมดูลในรูปแบบ "<module1>@<version1>,<module2>@<version2>" ซึ่งจะได้รับอนุญาตในกราฟทรัพยากร Dependency ที่ได้รับการแก้ไขแล้ว แม้ว่าจะมีการประกาศเวอร์ชันในรีจิสทรีในที่มาของเวอร์ชัน (หากไม่ได้มาจาก NonRegistryOverride) มิเช่นนั้น เวอร์ชันที่แยกออกมาจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันแยกที่อนุญาตด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" ได้ด้วย คุณสามารถปิดการตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "ทั้งหมด" (ไม่แนะนำ)
แท็ก: loading_and_analysis
ค่าเริ่มต้น --check_bazel_compatibility=<error, warning or off>: "ข้อผิดพลาด"
ตรวจสอบความเข้ากันได้กับเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" ที่ส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" ให้พิมพ์คำเตือนเมื่อตรวจพบข้อมูลที่ไม่ตรงกัน
แท็ก: loading_and_analysis
ค่าเริ่มต้น --check_direct_dependencies=<off, warning or error>: "คำเตือน"
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟทรัพยากร Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" ให้พิมพ์คำเตือนเมื่อตรวจพบข้อมูลไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อยกระดับการแก้ปัญหาไม่สำเร็จ
แท็ก: loading_and_analysis
ค่าเริ่มต้น --[no]ignore_dev_dependency: "เท็จ"
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะไม่สนใจทรัพยากร Dependency สำหรับนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูทไม่ว่าค่าของแฟล็กนี้จะเป็นอะไร
แท็ก: loading_and_analysis
ค่าเริ่มต้น --lockfile_mode=<off, update or error>: "อัปเดต"
ระบุวิธีและวิธีใช้ล็อกไฟล์ ค่าที่ถูกต้องคือ "อัปเดต" เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง "ข้อผิดพลาด" ในการใช้ไฟล์ล็อกแต่เกิดข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" ไม่อ่านหรือเขียนไปยังไฟล์ล็อก
แท็ก: loading_and_analysis
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --override_module=<an equals-separated mapping of module name to path> รายการ
ลบล้างโมดูลด้วยเส้นทางภายในในรูปแบบ <module name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์ ระบบจะใช้เส้นทางตามที่เป็น ถ้าเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพัทธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางดังกล่าวจะสัมพัทธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --registry=<a string> รายการ
ระบุรีจิสทรีที่จะใช้ในการค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับเป็นสิ่งสำคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีในภายหลังเมื่อไม่มีรีจิสทรีที่ขาดหายไป
แท็ก: changes_inputs
ค่าเริ่มต้น --vendor_dir=<a path>: ดูคำอธิบาย
ระบุไดเรกทอรีที่ควรเก็บที่เก็บภายนอกในโหมดผู้ให้บริการ ไม่ว่าจะเพื่อวัตถุประสงค์ในการดึงข้อมูลลงในที่เก็บหรือใช้ขณะที่สร้าง คุณสามารถระบุเส้นทางเป็นเส้นทางสัมบูรณ์หรือเส้นทางที่สัมพันธ์กับไดเรกทอรีพื้นที่ทำงานก็ได้
แท็ก: loading_and_analysis
ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพเวลาของบิลด์
ค่าเริ่มต้นของ --cache_computed_file_digests=<a long integer>: "50,000"
หากมากกว่า 0 ให้กำหนดค่า Bazel ให้แคชไดเจสต์ของไฟล์ในหน่วยความจำตามข้อมูลเมตาของไฟล์แทนการคำนวณไดเจสต์ใหม่จากดิสก์ทุกครั้งที่ต้องการ การตั้งค่านี้เป็น 0 จะรับประกันความถูกต้อง เนื่องจากการเปลี่ยนแปลงไฟล์บางอย่างอาจบันทึกจากข้อมูลเมตาของไฟล์ไม่ได้ เมื่อไม่ใช่ 0 ตัวเลขนี้บ่งบอกถึงขนาดของแคชตามจำนวนไดเจสต์ของไฟล์ที่จะแคช
ค่าเริ่มต้น --experimental_dynamic_ignore_local_signals=<a comma-separated list of signal numbers>: ดูคำอธิบาย
รับรายการหมายเลขสัญญาณของระบบปฏิบัติการ หาก Branch ของการดำเนินการแบบไดนามิกไม่ทำงานด้วยสัญญาณเหล่านี้ ระบบจะอนุญาตให้ Branch ระยะไกลทำงานให้เสร็จแทน สำหรับผู้ปฏิบัติงานที่ทำงานต่อเนื่อง นโยบายนี้จะส่งผลต่อสัญญาณที่ยุติกระบวนการทำงานของพนักงานเท่านั้น
แท็ก: execution
ค่าเริ่มต้น --gc_thrashing_limits=<comma separated pairs of <period>:<count>>: "1s:2,20s:3,1m:5"
ถึงขีดจำกัดแล้ว (หากมี) จะทำให้ GcThrashingDetector ทำให้ Bazel ขัดข้องด้วย OOM ขีดจํากัดแต่ละรายการจะระบุเป็น <period>:<count> โดยที่ระยะเวลาคือระยะเวลาและจํานวนเป็นจำนวนเต็มบวก หากมีการใช้งานพื้นที่มากกว่า --gc_thrashing_threshold เปอร์เซ็นต์ของพื้นที่ว่าง (ฮีป Gen เก่า) หลัง <count> GC แบบเต็มติดต่อกันภายใน <period> จะมีการทริกเกอร์ OOM คุณระบุขีดจำกัดหลายรายการได้โดยคั่นด้วยเครื่องหมายจุลภาค
แท็ก: host_machine_resource_optimizations
ค่าเริ่มต้นของ --local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>: "HOST_CPUS"
กำหนดจำนวนแกน CPU ภายในทั้งหมดอย่างชัดเจนให้กับ Bazel เพื่อใช้จ่ายกับการดำเนินการของบิลด์ที่ดำเนินการภายในเครื่อง ใช้ค่าจำนวนเต็มหรือ "HOST_CPUS" แล้วตามด้วย [-|*]<float> (ไม่บังคับ) (เช่น HOST_CPUS*.5 เพื่อใช้แกน CPU ที่มีอยู่ครึ่งหนึ่ง) โดยค่าเริ่มต้น ("HOST_CPUS") Bazel จะค้นหาการกำหนดค่าของระบบเพื่อประมาณจำนวนแกน CPU ที่มี
แท็ก: host_machine_resource_optimizations
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --local_extra_resources=<a named float, 'name=value'> รายการ
กำหนดจำนวนทรัพยากรเพิ่มเติมที่ใช้ได้กับ Bazel รับในคู่สตริง-ลอย ใช้เพื่อระบุทรัพยากรเพิ่มเติมได้หลายประเภท Bazel จะจำกัดการดำเนินการที่เกิดขึ้นพร้อมกันตามทรัพยากรที่มีและทรัพยากรเพิ่มเติมที่จำเป็น การทดสอบสามารถประกาศจำนวนทรัพยากรเพิ่มเติมที่ต้องการโดยใช้แท็ก "resources:<resoucename>:<amount>" ตั้งค่า CPU, RAM และทรัพยากรที่มีอยู่ด้วยแฟล็กนี้ไม่ได้
แท็ก: host_machine_resource_optimizations
ค่าเริ่มต้น --local_ram_resources=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>: "HOST_RAM*.67"
กำหนดจำนวน RAM ทั้งหมดของโฮสต์ในเครื่อง (เป็น MB) ที่ Bazel จะใช้ได้อย่างชัดเจนเพื่อใช้จ่ายกับการดำเนินการของบิลด์ที่ดำเนินการภายในเครื่อง ใช้จำนวนเต็มหรือ "HOST_RAM" แล้วตามด้วย [-|*]<float> หรือไม่ก็ได้ (เช่น HOST_RAM*.5 เพื่อใช้ RAM ที่มีอยู่ครึ่งหนึ่ง) โดยค่าเริ่มต้น ("HOST_RAM*.67") Bazel จะค้นหาการกำหนดค่าของระบบเพื่อประมาณจำนวน RAM ที่มีและจะใช้ 67% จากการกำหนดค่านี้
แท็ก: host_machine_resource_optimizations
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --local_resources=<a named double, 'name=value', where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> รายการ
กำหนดจำนวนทรัพยากรที่ Bazel ใช้ได้ นำงานไปยัง Float หรือ HOST_RAM/HOST_CPUS (ไม่บังคับ) ตามด้วย [-|*]<Flo> (เช่น Memory=HOST_RAM*.5 เพื่อใช้ RAM ที่มีอยู่ครึ่งหนึ่ง) ใช้เพื่อระบุทรัพยากรได้หลายประเภทได้หลายครั้ง Bazel จะจำกัดการดำเนินการที่เกิดขึ้นพร้อมกันตามทรัพยากรที่มีและทรัพยากรที่จำเป็น การทดสอบจะประกาศจำนวนทรัพยากรที่ต้องการได้โดยใช้แท็ก "resources:<resource name>:<amount>" ลบล้างทรัพยากรที่ระบุโดย --local_{cpu|ram|extra}_resources
แท็ก: host_machine_resource_optimizations
ค่าเริ่มต้นของ --skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
ตั้งค่าสถานะสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้ฮีปที่เก็บรักษาไว้เกินเกณฑ์ที่ --skyframe_high_water_mark_threshold กำหนด เมื่อเกิดเหตุการณ์ GC เต็มรูปแบบเกิดขึ้น สถานะของ Skyframe ชั่วคราวจะถูกตัดทิ้งโดยไม่จำเป็นจนถึงจำนวนครั้งดังกล่าวต่อการเรียกใช้หลายครั้ง ค่าเริ่มต้นคือจำนวนเต็ม MAX_VALUE ได้อย่างไม่จำกัด 0 หมายความว่ากิจกรรม GC ทั้งหมดจะไม่ทริกเกอร์การลดลง หากถึงขีดจำกัด สถานะ Skyframe จะไม่ลดลงอีกต่อไปเมื่อเกิดเหตุการณ์ GC เต็มรูปแบบและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก: host_machine_resource_optimizations
ค่าเริ่มต้นของ --skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>: "2147483647"
ตั้งค่าสถานะสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้ฮีปที่เก็บรักษาไว้เกินเกณฑ์ที่ --skyframe_high_water_mark_threshold ตั้งค่าอยู่ เมื่อเกิดเหตุการณ์ GC ที่ไม่ร้ายแรง เหตุการณ์ GC ที่ไม่ร้ายแรงจะเกิดขึ้น ระบบจะหยุดสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นออกไปจนถึงหลายครั้งต่อการเรียกใช้ ค่าเริ่มต้นคือจำนวนเต็ม MAX_VALUE ได้อย่างไม่จำกัด ศูนย์หมายความว่ากิจกรรม GC ที่ไม่สำคัญจะไม่ทริกเกอร์การลดลงเลย หากถึงขีดจำกัดแล้ว สถานะ Skyframe จะไม่ลดลงอีกต่อไปเมื่อเกิดเหตุการณ์ GC ที่ไม่ร้ายแรงและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก: host_machine_resource_optimizations
ค่าเริ่มต้นของ --skyframe_high_water_mark_threshold=<an integer>: "85"
ตั้งค่าสถานะสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้ฮีปที่เก็บรักษาไว้ถึงเกณฑ์นี้เป็นอย่างน้อย ก็จะทิ้งสถานะ Skyframe ชั่วคราวโดยไม่จำเป็น การปรับแต่งนี้อาจช่วยลดผลกระทบจากเวลาจริงของการ Thrash
แท็ก: host_machine_resource_optimizations
ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
ค่าเริ่มต้น --[no]debug_spawn_scheduler: "เท็จ"
ค่าเริ่มต้น --[no]experimental_bep_target_summary: "เท็จ"
ต้องการเผยแพร่เหตุการณ์ TargetSummary หรือไม่
ค่าเริ่มต้น --[no]experimental_build_event_expand_filesets: "เท็จ"
หากเป็น "จริง" ให้ขยายชุดไฟล์ใน BEP เมื่อนำเสนอไฟล์เอาต์พุต
แท็ก: affects_outputs
หากเป็น "จริง" ให้แปลค่าลิงก์สัญลักษณ์ของ Fileset สัมพัทธ์ทั้งหมดใน BEP เมื่อนำเสนอไฟล์เอาต์พุต ต้องมี --experimental_build_event_expand_filesset
แท็ก: affects_outputs
ค่าเริ่มต้น --experimental_build_event_upload_max_retries=<an integer>: "4"
จำนวนครั้งสูงสุดที่ Bazel ควรลองอัปโหลดเหตุการณ์บิลด์อีกครั้ง
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>: "1s"
เริ่มแรก ความล่าช้าขั้นต่ำสำหรับการลองใหม่แบบ Exponential Backoff เมื่ออัปโหลด BEP ไม่สำเร็จ (เลขชี้กำลัง: 1.6)
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --experimental_build_event_upload_strategy=<a string>: ดูคำอธิบาย
เลือกวิธีอัปโหลดอาร์ติแฟกต์ที่อ้างอิงในโปรโตคอลเหตุการณ์บิลด์
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]experimental_collect_local_sandbox_action_metrics: "true"
ไม่มีการดำเนินการที่เลิกใช้งาน
แท็ก: execution
ค่าเริ่มต้น --experimental_command_profile=<cpu, wall, alloc or lock>: ดูคำอธิบาย
บันทึกโปรไฟล์ Java Flight Recorder ตามระยะเวลาของคำสั่ง ต้องระบุประเภทเหตุการณ์การสร้างโปรไฟล์ที่รองรับ (CPU, หน้าจอ, Allo หรือ Lock) เป็นอาร์กิวเมนต์ โปรไฟล์จะเขียนไปยังไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ภายใต้ไดเรกทอรีฐานเอาต์พุต ไวยากรณ์และความหมายของแฟล็กนี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม คุณต้องรับความเสี่ยงของการใช้งานเองด้วย
ค่าเริ่มต้น --[no]experimental_docker_verbose: "เท็จ"
หากเปิดใช้ Bazel จะพิมพ์ข้อความที่มีรายละเอียดเกี่ยวกับกลยุทธ์แซนด์บ็อกซ์ของ Docker มากขึ้น
แท็ก: execution
ค่าเริ่มต้น --[no]experimental_materialize_param_files_directly: "เท็จ"
หากทำให้ไฟล์พารามิเตอร์เป็นรูปธรรม ให้ดำเนินการดังกล่าวด้วยการเขียนไปยังดิสก์โดยตรง
แท็ก: execution
ค่าเริ่มต้น --[no]experimental_record_metrics_for_all_mnemonics: "เท็จ"
โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจำกัดอยู่ที่ 20 รายการที่มีการกระทำมากที่สุด การตั้งค่าตัวเลือกนี้จะเป็นการเขียนสถิติสำหรับการช่วยจำทั้งหมด
ค่าเริ่มต้นของ --experimental_repository_resolved_file=<a string>: ""
หากไม่ว่างเปล่า ให้เขียนค่า Starlark พร้อมข้อมูลที่แก้ไขแล้วของกฎที่เก็บ Starlark ทั้งหมดที่ดำเนินการ
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]experimental_run_bep_event_include_residue: "เท็จ"
เลือกว่าจะรวมการขาดเหลือของบรรทัดคำสั่งในเหตุการณ์บิลด์ซึ่งอาจมีส่วนที่เหลือหรือไม่ โดยค่าเริ่มต้น ความต่อเนื่องจะไม่รวมอยู่ในเหตุการณ์การสร้างคำสั่งการเรียกใช้คำสั่งที่อาจมีส่วนที่เหลืออยู่
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]experimental_stream_log_file_uploads: "เท็จ"
สตรีมไฟล์บันทึกจะอัปโหลดไปยังพื้นที่เก็บข้อมูลระยะไกลโดยตรงแทนการเขียนลงดิสก์
แท็ก: affects_outputs
ค่าเริ่มต้น --explain=<a path>: ดูคำอธิบาย
ทำให้ระบบบิลด์อธิบายแต่ละขั้นตอนที่ดำเนินการแล้วของบิลด์ ระบบจะเขียนคำอธิบายลงในไฟล์บันทึกที่ระบุ
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]ignore_unsupported_sandboxing: "เท็จ"
ไม่ต้องพิมพ์คำเตือนเมื่อระบบนี้ไม่รองรับการดำเนินการแบบแซนด์บ็อกซ์
แท็ก: terminal_output
ค่าเริ่มต้น --[no]legacy_important_outputs: "true"
ใช้อาร์กิวเมนต์นี้เพื่อระงับการสร้างช่อง legal_outputs เดิมในเหตุการณ์ TargetComplete ต้องใช้ required_outputs สำหรับการผสานรวม Bazel กับ ResultStore
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]materialize_param_files: "เท็จ"
เขียนไฟล์พารามิเตอร์ระดับกลางไปยังโครงสร้างเอาต์พุตแม้ในขณะที่ใช้การดำเนินการจากระยะไกล มีประโยชน์เมื่อมีการแก้ไขข้อบกพร่อง ซึ่งหมายถึง --subcommands และ --verbose_failures
แท็ก: execution
ค่าเริ่มต้น --max_config_changes_to_show=<an integer>: "3"
เมื่อทิ้งแคชการวิเคราะห์เนื่องจากการเปลี่ยนแปลงตัวเลือกบิลด์ จะแสดงชื่อตัวเลือกที่มีการเปลี่ยนแปลงตามจำนวนที่กำหนด ถ้าตัวเลขที่ระบุคือ -1 ตัวเลือกที่มีการเปลี่ยนแปลงทั้งหมดจะแสดง
แท็ก: terminal_output
ค่าเริ่มต้น --max_test_output_bytes=<an integer>: "-1"
ระบุขนาดสูงสุดของบันทึกต่อการทดสอบที่ส่งได้เมื่อ --test_output คือ "ข้อผิดพลาด" หรือ "ทั้งหมด" มีประโยชน์เพื่อหลีกเลี่ยงเอาต์พุตที่ไม่ได้ทำให้เอาต์พุตการทดสอบมีเสียงดังรบกวนมากเกินไป ส่วนหัวการทดสอบจะรวมอยู่ในขนาดบันทึก ค่าลบหมายถึงไม่มีขีดจำกัด เอาต์พุตทั้งหมดหรือไม่มีเลย
แท็ก: test_runner, terminal_output, execution
ค่าเริ่มต้น --output_filter=<a valid Java regular expression>: ดูคำอธิบาย
แสดงเฉพาะเอาต์พุตของคำเตือนและการดำเนินการสำหรับกฎที่มีชื่อตรงกับนิพจน์ทั่วไปที่ระบุ
แท็ก: affects_outputs
ค่าเริ่มต้น --progress_report_interval=<an integer in 0-3600 range>: "0"
จำนวนวินาทีที่จะรอระหว่างรายงานในงานที่ยังทำงานอยู่ ค่าเริ่มต้น 0 หมายความว่าระบบจะพิมพ์รายงานแรกหลังผ่านไป 10 วินาที จากนั้นจะแสดงเป็นเวลา 30 วินาที หลังจากนั้นจะมีการรายงานความคืบหน้า 1 ครั้งในทุกๆ นาที เมื่อเปิดใช้งาน --curses จะมีการรายงานความคืบหน้าทุกวินาที
แท็ก: affects_outputs
ค่าเริ่มต้น --remote_print_execution_messages=<failure, success or all>: "ล้มเหลว"
เลือกเวลาที่จะพิมพ์ข้อความการดำเนินการจากระยะไกล ค่าที่ใช้ได้คือ "ล้มเหลว" หากต้องการพิมพ์เมื่อล้มเหลวเท่านั้น "สำเร็จ" เพื่อพิมพ์เฉพาะเมื่อสำเร็จ และ "ทั้งหมด" เพื่อพิมพ์เสมอ
แท็ก: terminal_output
ค่าเริ่มต้น --[no]sandbox_debug: "เท็จ"
เปิดใช้ฟีเจอร์การแก้ไขข้อบกพร่องสำหรับฟีเจอร์แซนด์บ็อกซ์ ซึ่งรวมถึง 2 อย่างแรกคือ เนื้อหารูทของแซนด์บ็อกซ์จะไม่ต้องดำเนินการใดๆ หลังบิลด์ และอย่างที่สอง พิมพ์ข้อมูลการแก้ไขข้อบกพร่องเพิ่มเติมในการเรียกใช้ ซึ่งจะช่วยให้นักพัฒนาซอฟต์แวร์ของกฎ Bazel หรือ Starlark แก้ไขข้อบกพร่องไม่สำเร็จเนื่องจากไม่มีไฟล์อินพุต ฯลฯ
แท็ก: terminal_output
ค่าเริ่มต้น --show_result=<an integer>: "1"
แสดงผลลัพธ์ของบิลด์ สำหรับแต่ละเป้าหมาย ให้ระบุว่าเป็นข้อมูลล่าสุดหรือไม่ และหากใช่ ให้แจ้งรายการไฟล์เอาต์พุตที่สร้างขึ้น ไฟล์ที่พิมพ์เป็นสตริงที่สะดวกสำหรับการคัดลอก+วางลงใน Shell เพื่อเรียกใช้ไฟล์ ตัวเลือกนี้ต้องใช้อาร์กิวเมนต์จำนวนเต็ม ซึ่งเป็นจำนวนเกณฑ์ของเป้าหมายด้านบนซึ่งระบบจะไม่พิมพ์ข้อมูลผลลัพธ์ ดังนั้น 0 จะทำให้มีการระงับข้อความและ MAX_INT จะทำให้มีการพิมพ์ผลลัพธ์เสมอ ค่าเริ่มต้นคือ 1 หากไม่มีสิ่งใดที่สร้างขึ้นสำหรับเป้าหมาย ระบบอาจละเว้นผลลัพธ์เพื่อให้เอาต์พุตอยู่ภายใต้เกณฑ์
แท็ก: affects_outputs
--[no]subcommands [-s] ค่าเริ่มต้น: "เท็จ"
แสดงคำสั่งย่อยที่ดำเนินการระหว่างบิลด์ แฟล็กที่เกี่ยวข้อง: --execution_log_json_file, --execution_log_binary_file (สำหรับการบันทึกคำสั่งย่อยไปยังไฟล์ในรูปแบบที่ง่ายต่อการใช้เครื่องมือ)
แท็ก: terminal_output
ค่าเริ่มต้น --test_output=<summary, errors, all or streamed>: "summary"
ระบุโหมดเอาต์พุตที่ต้องการ ค่าที่ถูกต้องคือ "summary" เพื่อแสดงเฉพาะสรุปสถานะการทดสอบ "ข้อผิดพลาด" เพื่อพิมพ์บันทึกการทดสอบสำหรับการทดสอบที่ล้มเหลวด้วย "ทั้งหมด" เพื่อพิมพ์บันทึกสำหรับการทดสอบทั้งหมดและ "สตรีม" เพื่อส่งออกบันทึกสำหรับการทดสอบทั้งหมดในแบบเรียลไทม์ (การดำเนินการนี้จะบังคับให้ดำเนินการทดสอบในเครื่องครั้งละ 1 รายการโดยไม่คำนึงถึงค่า --test_strategy)
แท็ก: test_runner, terminal_output, execution
ค่าเริ่มต้นของ --test_summary=<short, terse, detailed, none or testcase>: "สั้น"
ระบุรูปแบบของสรุปการทดสอบที่ต้องการ ค่าที่ถูกต้องคือ "short" เพื่อพิมพ์ข้อมูลเกี่ยวกับการทดสอบที่ดําเนินการเท่านั้น "แบบละเอียด" เพื่อพิมพ์เฉพาะข้อมูลเกี่ยวกับการทดสอบที่ดําเนินการไม่สําเร็จเท่านั้น เช่น "แบบละเอียด" เพื่อพิมพ์ข้อมูลโดยละเอียดเกี่ยวกับกรอบการทดสอบที่ล้มเหลว เช่น "testcase" เพื่อพิมพ์สรุปในการแก้ปัญหากรอบการทดสอบ อย่าพิมพ์ข้อมูลโดยละเอียดเกี่ยวกับกรอบการทดสอบที่ล้มเหลวและ "ไม่มี" ที่จะละเว้นข้อมูลสรุป
แท็ก: terminal_output
ค่าเริ่มต้น --[no]verbose_explanations: "เท็จ"
เพิ่มรายละเอียดของคำอธิบายที่ออกหากเปิดใช้ --explain จะไม่มีผล หากไม่ได้เปิดใช้งาน --explain
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]verbose_failures: "เท็จ"
หากเรียกใช้คำสั่งไม่สำเร็จ ให้พิมพ์บรรทัดคำสั่งแบบเต็ม
แท็ก: terminal_output
ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --aspects_parameters=<a 'name=value' assignment> รายการ
ระบุค่าของพารามิเตอร์ด้านบรรทัดคำสั่ง ค่าพารามิเตอร์แต่ละรายการจะระบุผ่าน <param_name>=<param_value> เช่น 'my_param=my_val' ที่ "my_param" คือพารามิเตอร์ของบางด้านในรายการ --aspects รายการ หรือจำเป็นต้องใช้สำหรับด้านใดด้านหนึ่งในรายการ ตัวเลือกนี้ใช้ได้หลายครั้ง อย่างไรก็ตาม ไม่อนุญาตให้กำหนดค่าให้กับพารามิเตอร์เดียวกันมากกว่า 1 ครั้ง
แท็ก: loading_and_analysis
ค่าเริ่มต้นของ --experimental_resolved_file_instead_of_workspace=<a string>: ""
หากไม่ว่างเปล่า ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก: changes_inputs
ค่าเริ่มต้นของ --target_pattern_file=<a string>: ""
ถ้ามีการตั้งค่า บิลด์จะอ่านรูปแบบจากไฟล์ที่มีชื่อที่นี่ แทนที่จะเป็นบรรทัดคำสั่ง การระบุไฟล์ที่นี่ รวมถึงรูปแบบบรรทัดคำสั่งเป็นข้อผิดพลาด
แท็ก: changes_inputs
ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
ค่าเริ่มต้น --experimental_circuit_breaker_strategy=<failure>: ดูคำอธิบาย
ระบุกลยุทธ์ที่เบรกเกอร์จะใช้ กลยุทธ์ที่ใช้ได้คือ "ความล้มเหลว" หากค่าที่ไม่ถูกต้องสำหรับตัวเลือก ลักษณะการทำงานเช่นเดียวกันกับตัวเลือกไม่ได้ตั้งค่า
แท็ก: execution
ค่าเริ่มต้น --experimental_downloader_config=<a string>: ดูคำอธิบาย
ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด แต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือสองรูปแบบ รูปแบบหนึ่งจะจับคู่กัน และอีกรูปแบบหนึ่งใช้เป็น URL ทดแทน โดยมีการอ้างอิงกลับเริ่มตั้งแต่ "$1" เป็นไปได้ที่จะมีการใช้คำสั่ง "rewrite" หลายคำสั่งสำหรับ URL เดียวกัน และในกรณีนี้ระบบจะส่งคืน URL หลายรายการ
ค่าเริ่มต้น --[no]experimental_guard_against_concurrent_changes: "เท็จ"
ปิดการตั้งค่านี้เพื่อปิดใช้การตรวจสอบเวลาของไฟล์อินพุตของการดำเนินการก่อนอัปโหลดไปยังแคชระยะไกล ในบางกรณีที่เคอร์เนลของ Linux จะหน่วงเวลาการเขียนไฟล์ ซึ่งอาจทำให้เกิดผลบวกลวง
ค่าเริ่มต้น --[no]experimental_remote_cache_async: "เท็จ"
หากเป็น "จริง" I/O ของแคชระยะไกลจะเกิดขึ้นในเบื้องหลังแทนที่จะเกิดขึ้นเป็นส่วนที่สร้างขึ้น
ค่าเริ่มต้น --experimental_remote_cache_compression_threshold=<an integer>: "0"
ขนาด BLOB ขั้นต่ำที่ต้องใช้เพื่อบีบอัด/คลายการบีบอัดด้วย zstd จะไม่มีผล ยกเว้นกรณีที่ตั้งค่า --remote_cache_compression ไว้
ค่าเริ่มต้น --experimental_remote_cache_eviction_retries=<an integer>: "0"
จำนวนครั้งสูงสุดที่จะลองอีกครั้งหากบิลด์พบข้อผิดพลาดในการกำจัดแคชระยะไกล ค่าที่ไม่ใช่ 0 จะมีการตั้งค่าโดยปริยาย --incompatible_remote_use_new_exit_code_for_lost_inputs เป็น "จริง" ระบบจะสร้างรหัสคำขอใหม่สำหรับการพยายามแต่ละครั้ง หากคุณสร้างรหัสคำขอและส่งให้กับ Bazel โดยใช้ --invocation_id คุณไม่ควรใช้แฟล็กนี้ แต่ให้ตั้งค่าสถานะ --incompatible_remote_use_new_exit_code_for_lost_inputs แล้วตรวจสอบโค้ดสำหรับออก 39
แท็ก: execution
ค่าเริ่มต้น --[no]experimental_remote_cache_lease_extension: "เท็จ"
หากตั้งค่าเป็น "จริง" Bazel จะขยายเวลาการเช่าสำหรับเอาต์พุตของการดำเนินการระยะไกลระหว่างการสร้างโดยการส่งการเรียกใช้ "FindDoesBlobs" ไปยังแคชระยะไกลเป็นระยะ ความถี่จะอิงตามค่าของ "--experimental_remote_cache_ttl"
ค่าเริ่มต้น --experimental_remote_cache_ttl=<An immutable length of time.>: "3 ชม."
TTL ที่รับประกันขั้นต่ำของ BLOB ในแคชระยะไกลหลังจากมีการอ้างอิงไดเจสต์เมื่อเร็วๆ นี้ เช่น โดย ActionResult หรือ Find MissingBlobs Bazel ทำการเพิ่มประสิทธิภาพมากมายโดยอิงตาม BLOB TTL เช่น ไม่ได้เรียกใช้ GetActionResult ซ้ำๆ ในบิลด์ที่เพิ่มขึ้น ควรกำหนดค่าน้อยกว่า TTL จริงเล็กน้อย เนื่องจากมีช่องว่างระหว่างเวลาที่เซิร์ฟเวอร์แสดงผลไดเจสต์กับเวลาที่ Bazel ได้รับ
แท็ก: execution
ค่าเริ่มต้น --experimental_remote_capture_corrupted_outputs=<a path>: ดูคำอธิบาย
เส้นทางไปยังไดเรกทอรีซึ่งจะมีการบันทึกเอาต์พุตที่เสียหาย
ค่าเริ่มต้น --[no]experimental_remote_discard_merkle_trees: "เท็จ"
หากตั้งค่าเป็น "จริง" ให้ทิ้งสำเนาในหน่วยความจำของโครงสร้าง Merkle ของรูทอินพุตและการแมปอินพุตที่เกี่ยวข้องระหว่างการเรียก GetActionResult() และ Execute() ซึ่งช่วยลดการใช้งานหน่วยความจำได้อย่างมาก แต่จะต้องให้ Bazel คํานวณใหม่เมื่อมีการไม่พบแคชระยะไกลหรือลองอีกครั้ง
ค่าเริ่มต้น --experimental_remote_downloader=<a string>: ดูคำอธิบาย
URI ปลายทางของ Remote Asset API ที่จะใช้เป็นพร็อกซีการดาวน์โหลดระยะไกล สคีมาที่รองรับ ได้แก่ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (ซ็อกเก็ต UNIX ในเครื่อง) หากไม่ได้ระบุสคีมา Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ดูที่ https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.เลือก
ค่าเริ่มต้น --[no]experimental_remote_downloader_local_fallback: "เท็จ"
กลับไปใช้เครื่องมือดาวน์โหลดในเครื่องหรือไม่หากโปรแกรมดาวน์โหลดระยะไกลล้มเหลว
ค่าเริ่มต้น --[no]experimental_remote_execution_keepalive: "เท็จ"
ต้องการใช้ Keepalive สำหรับการเรียกใช้การดำเนินการระยะไกลหรือไม่
ค่าเริ่มต้น --experimental_remote_failure_rate_threshold=<an integer in 0-100 range>: "10"
ตั้งค่าจำนวนอัตราความล้มเหลวที่อนุญาตเป็นเปอร์เซ็นต์สำหรับกรอบเวลาที่เจาะจงหลังจากหยุดเรียกใช้แคช/ผู้ดำเนินการระยะไกล ค่าเริ่มต้นคือ 10 การตั้งค่านี้เป็น 0 หมายความว่าไม่มีข้อจำกัด
แท็ก: execution
ค่าเริ่มต้นของ --experimental_remote_failure_window_interval=<An immutable length of time.>: "60 วินาที"
ช่วงเวลาที่มีการคำนวณอัตราความล้มเหลวของคำขอระยะไกล หากค่าเป็น 0 หรือค่าลบ ระบบจะคำนวณระยะเวลาความล้มเหลวตลอดทั้งระยะเวลาในการดำเนินการ หน่วยต่อไปนี้สามารถใช้ได้ ได้แก่ วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
แท็ก: execution
ค่าเริ่มต้น --[no]experimental_remote_mark_tool_inputs: "เท็จ"
หากตั้งค่าเป็น "จริง" Bazel จะทำเครื่องหมายอินพุตเป็นอินพุตเครื่องมือสำหรับผู้ดำเนินการระยะไกล โดยจะนำไปใช้ติดตั้งใช้งานผู้ปฏิบัติงานที่ทำงานถาวรจากระยะไกลได้
ค่าเริ่มต้น --[no]experimental_remote_merkle_tree_cache: "เท็จ"
หากตั้งค่าเป็น "จริง" ระบบจะบันทึกการคำนวณต้นไม้ Merkle เพื่อปรับปรุงความเร็วในการตรวจสอบ Hit ของแคชระยะไกล การพิมพ์พื้นที่หน่วยความจำของแคชจะควบคุมโดย --experimental_remote_merkle_tree_cache_size
ค่าเริ่มต้น --experimental_remote_merkle_tree_cache_size=<a long integer>: "1000"
จำนวนต้น Merkle ที่จะบันทึกเพื่อปรับปรุงความเร็วในการตรวจสอบการเข้าถึงแคชระยะไกล แม้ว่าแคชจะถูกตัดทอนโดยอัตโนมัติตามการจัดการการอ้างอิงแบบซอฟต์ของ Java แต่ข้อผิดพลาดจากหน่วยความจำไม่เพียงพอก็อาจเกิดขึ้นได้หากตั้งค่าสูงเกินไป หากตั้งค่าเป็น 0 ระบบจะไม่จำกัดขนาดของแคช ค่าที่ดีที่สุดจะแตกต่างกันไปตามขนาดของโปรเจ็กต์ โดยมีค่าเริ่มต้นเป็น 1,000
ค่าเริ่มต้น --[no]experimental_remote_require_cached: "เท็จ"
หากตั้งค่าเป็น "จริง" ให้บังคับใช้การแคชการดำเนินการทั้งหมดที่เรียกใช้จากระยะไกลได้ ไม่เช่นนั้นจะทำให้บิลด์ใช้งานไม่ได้ วิธีนี้มีประโยชน์ในการแก้ปัญหาที่ไม่ได้กำหนดกระบวนการ เนื่องจากจะช่วยให้ตรวจสอบได้ว่าการดำเนินการที่ควรแคชมีการแคชไว้จริงๆ หรือไม่ โดยไม่ต้องแทรกผลลัพธ์ใหม่ลงในแคชอย่างจงใจ
ค่าเริ่มต้น --experimental_remote_scrubbing_config=<Converts to a Scrubber>: ดูคำอธิบาย
เปิดใช้การสครับคีย์แคชระยะไกลด้วยไฟล์การกำหนดค่าที่ให้มา ซึ่งต้องเป็นบัฟเฟอร์โปรโตคอลในรูปแบบข้อความ (ดู src/main/protocolbuf/remote_scrubbing.เลือก) ฟีเจอร์นี้มีไว้เพื่ออำนวยความสะดวกในการแชร์แคชระยะไกล/ดิสก์ระหว่างการดำเนินการที่ดำเนินการบนแพลตฟอร์มอื่นแต่กำหนดเป้าหมายไปยังแพลตฟอร์มเดียวกัน ควรใช้ด้วยความระมัดระวังอย่างยิ่ง เนื่องจากการตั้งค่าที่ไม่เหมาะสมอาจทำให้เกิดการแชร์รายการแคชโดยไม่ได้ตั้งใจและส่งผลให้เกิดการสร้างที่ไม่ถูกต้อง การสครับไม่มีผลต่อวิธีเรียกใช้การดำเนินการ แต่มีเพียงวิธีการคำนวณคีย์แคชระยะไกล/ดิสก์เพื่อวัตถุประสงค์ในการเรียกข้อมูลหรือจัดเก็บผลลัพธ์การดำเนินการเท่านั้น การดำเนินการแบบสครับใช้กับการดำเนินการระยะไกลไม่ได้ และจะทำงานในเครื่องแทนเสมอ การแก้ไขการกำหนดค่าการสครับจะไม่ทำให้เอาต์พุตที่มีอยู่ในระบบไฟล์ในเครื่องหรือแคชภายในเป็นโมฆะ ต้องใช้บิลด์ใหม่เพื่อดำเนินการทำงานที่ได้รับผลกระทบอีกครั้ง เพื่อให้สามารถใช้ฟีเจอร์นี้ได้สำเร็จ คุณอาจต้องตั้งค่า --host_platform ที่กำหนดเองร่วมกับ --experimental_platform_in_output_dir (เพื่อทำให้คำนำหน้าเอาต์พุตเป็นมาตรฐาน) และ --incompatible_strict_action_env (เพื่อปรับตัวแปรสภาพแวดล้อมให้เป็นมาตรฐาน)
ค่าเริ่มต้น --experimental_worker_for_repo_fetching=<off, platform, virtual or auto>: "อัตโนมัติ"
โหมดชุดข้อความที่จะใช้ในการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท มิเช่นนั้น ให้ใช้เทรดแพลตฟอร์ม (เทรดระบบปฏิบัติการ) หากตั้งค่าเป็น "แพลตฟอร์ม" หรือชุดข้อความเสมือนหากตั้งค่าเป็น "เสมือนจริง" หากตั้งค่าเป็น "อัตโนมัติ" จะมีการใช้เทรดเสมือน หากมี (เช่น ทำงานใน JDK 21 ขึ้นไป) มิเช่นนั้นจะไม่มีการใช้เธรดผู้ปฏิบัติงาน
ค่าเริ่มต้น --[no]incompatible_remote_build_event_upload_respect_no_cache: "เท็จ"
เลิกใช้งานแล้ว ไม่มีการดำเนินการ โปรดใช้ --remote_build_event_upload=minimal แทน
ค่าเริ่มต้น --[no]incompatible_remote_downloader_send_all_headers: "true"
เลือกว่าจะส่งค่าทั้งหมดของส่วนหัวที่มีหลายค่าไปยังโปรแกรมดาวน์โหลดระยะไกลแทนที่จะส่งเฉพาะค่าแรกหรือไม่
แท็ก: incompatible_change
ค่าเริ่มต้น --[no]incompatible_remote_output_paths_relative_to_input_root: "เท็จ"
หากตั้งค่าเป็น "จริง" เส้นทางเอาต์พุตจะสัมพัทธ์กับรูทอินพุตแทนที่จะเป็นไดเรกทอรีที่ใช้งานได้
แท็ก: incompatible_change
ค่าเริ่มต้น --[no]incompatible_remote_results_ignore_disk: "true"
ไม่มีการดำเนินการ
แท็ก: incompatible_change
ค่าเริ่มต้น --[no]incompatible_remote_use_new_exit_code_for_lost_inputs: "true"
หากตั้งค่าเป็น "จริง" Bazel จะใช้โค้ดสำหรับออกใหม่ 39 แทน 34 หากแคชระยะไกลนำ BLOB ออกระหว่างบิลด์
แท็ก: incompatible_change
ค่าเริ่มต้น --[no]remote_accept_cached: "true"
เลือกว่าจะยอมรับผลการดำเนินการที่แคชไว้จากระยะไกลหรือไม่
ค่าเริ่มต้น --remote_build_event_upload=<all or minimal>: "ขั้นต่ำ"
หากตั้งค่าเป็น "all" ระบบจะอัปโหลดเอาต์พุตในเครื่องทั้งหมดที่ BEP อ้างอิงไปยังแคชระยะไกล หากตั้งค่าเป็น "ค่าต่ำสุด" ระบบจะไม่อัปโหลดเอาต์พุตในเครื่องที่ BEP อ้างอิงไปยังแคชระยะไกล ยกเว้นไฟล์ที่มีความสำคัญต่อผู้บริโภคของ BEP (เช่น บันทึกการทดสอบและโปรไฟล์เวลา) รูปแบบ Bystream:// จะใช้สำหรับ uri ของไฟล์เสมอ แม้ว่าจะไม่มีในแคชระยะไกลก็ตาม ค่าเริ่มต้นคือ "ขั้นต่ำ"
ค่าเริ่มต้น --remote_bytestream_uri_prefix=<a string>: ดูคำอธิบาย
ชื่อโฮสต์และชื่ออินสแตนซ์ที่จะใช้ใน URI ของ bytesstream:// ซึ่งเขียนลงในสตรีมเหตุการณ์ของบิลด์ ตัวเลือกนี้สามารถตั้งค่าได้เมื่อดำเนินการบิลด์โดยใช้พร็อกซี ซึ่งทำให้ค่าของ --remote_executor และ --remote_instance_name ไม่ตรงกับชื่อ Canonical ของบริการการดำเนินการระยะไกลอีกต่อไป หากไม่ได้ตั้งค่า จะมีค่าเริ่มต้นเป็น "${ชื่อโฮสต์}/${instance_name}"
ค่าเริ่มต้น --remote_cache=<a string>: ดูคำอธิบาย
URI ของปลายทางการแคช สคีมาที่รองรับ ได้แก่ http, https, grpc, grpcs (grpc ที่เปิดใช้ TLS) และ unix (local UNIX Sockets) หากไม่ได้ระบุสคีมา Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุสคีมา grpc://, http:// หรือ unix: เพื่อปิดใช้ TLS ดู https://bazel.build/remote/caching
ค่าเริ่มต้น --[no]remote_cache_compression: "เท็จ"
หากเปิดใช้ ให้บีบอัด/ยกเลิกการบีบอัด BLOB ของแคชที่มี zstd เมื่อขนาดเท่ากับ --experimental_remote_cache_compression_threshold เป็นอย่างน้อย
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --remote_cache_header=<a 'name=value' assignment> รายการ
ระบุส่วนหัวที่จะรวมอยู่ในคำขอแคช: --remote_cache_header=Name=Value สามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --remote_default_exec_properties=<a 'name=value' assignment> รายการ
ตั้งค่าพร็อพเพอร์ตี้ exec เริ่มต้นที่จะใช้เป็นแพลตฟอร์มการดำเนินการระยะไกล หากแพลตฟอร์มการดำเนินการยังไม่ได้ตั้งค่า exec_properties
แท็ก: affects_outputs
ค่าเริ่มต้นของ --remote_default_platform_properties=<a string>: ""
ตั้งค่าพร็อพเพอร์ตี้แพลตฟอร์มเริ่มต้นสำหรับ API การดำเนินการระยะไกล หากแพลตฟอร์มการดำเนินการยังไม่ได้ตั้งค่า Remote_execution_properties เอาไว้ ระบบจะใช้ค่านี้หากเลือกแพลตฟอร์มโฮสต์เป็นแพลตฟอร์มการดำเนินการสำหรับการดำเนินการระยะไกล
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --remote_download_regex=<a string> รายการ
บังคับให้ Bazel ดาวน์โหลดอาร์ติแฟกต์ที่ตรงกับ regexp ที่ระบุ ใช้ร่วมกับ Build โดยไม่มีไบต์ (หรือค่าเทียบเท่าภายใน) เพื่ออนุญาตให้ไคลเอ็นต์ขออาร์ติแฟกต์บางอย่างที่อาจต้องใช้ในเครื่อง (เช่น การรองรับ IDE) คุณระบุนิพจน์ทั่วไปได้หลายรายการโดยใช้แฟล็กนี้ซ้ำ
แท็ก: affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --remote_downloader_header=<a 'name=value' assignment> รายการ
ระบุส่วนหัวที่จะรวมอยู่ในคำขอโปรแกรมดาวน์โหลดระยะไกล: --remote_downloader_header=Name=Value สามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --remote_exec_header=<a 'name=value' assignment> รายการ
ระบุส่วนหัวที่จะรวมอยู่ในคำขอการดำเนินการ: --remote_exec_header=Name=Value สามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
ค่าเริ่มต้น --remote_execution_priority=<an integer>: "0"
ลำดับความสำคัญที่เกี่ยวข้องของการดำเนินการที่จะเรียกใช้จากระยะไกล ความหมายของค่าลำดับความสำคัญหนึ่งๆ จะขึ้นอยู่กับเซิร์ฟเวอร์
ค่าเริ่มต้น --remote_executor=<a string>: ดูคำอธิบาย
HOST หรือ HOST:PORT ของปลายทางการดำเนินการระยะไกล สคีมาที่รองรับ ได้แก่ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (ซ็อกเก็ต UNIX ในเครื่อง) หากไม่ได้ระบุสคีมา Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุ grpc:// หรือ unix: สคีมาเพื่อปิดใช้ TLS
ค่าเริ่มต้น --remote_grpc_log=<a path>: ดูคำอธิบาย
เส้นทางไปยังไฟล์เพื่อบันทึกรายละเอียดเกี่ยวกับการโทร gRPC หากระบุ บันทึกนี้ประกอบด้วยลำดับของ com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry protobufs ของแบบต่อเนื่อง โดยแต่ละข้อความจะมีคำนำหน้าเป็น varint ซึ่งแสดงขนาดของข้อความ protocolbuf แบบต่อเนื่องต่อไปนี้ โดยใช้เมธอด LogEntry.writeDelimitedTo(OutputStream)
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --remote_header=<a 'name=value' assignment> รายการ
ระบุส่วนหัวที่จะรวมอยู่ในคำขอ: --remote_header=Name=Value สามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
ค่าเริ่มต้นของ --remote_instance_name=<a string>: ""
ค่าที่จะส่งผ่านเป็นอินสแตนซ์_name ใน API การดำเนินการระยะไกล
ค่าเริ่มต้น --[no]remote_local_fallback: "เท็จ"
กลับไปใช้กลยุทธ์การดำเนินการภายในเครื่องแบบสแตนด์อโลนหรือไม่ หากการดำเนินการจากระยะไกลล้มเหลว
ค่าเริ่มต้น --remote_local_fallback_strategy=<a string>: "ท้องถิ่น"
ไม่มีการดำเนินการ เลิกใช้งานแล้ว ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7480
ค่าเริ่มต้น --remote_max_connections=<an integer>: "100"
จำกัดจำนวนการเชื่อมต่อพร้อมกันสูงสุดให้กับแคช/ผู้ดำเนินการระยะไกล ค่าเริ่มต้นคือ 100 การตั้งค่านี้เป็น 0 หมายความว่าไม่มีข้อจำกัด สำหรับแคชระยะไกล HTTP การเชื่อมต่อ TCP 1 รายการสามารถจัดการคำขอได้ครั้งละ 1 รายการ ดังนั้น Bazel สามารถสร้างคำขอพร้อมกันได้สูงสุด --remote_max_connections สำหรับแคช/ผู้ดำเนินการระยะไกล gRPC ช่อง gRPC หนึ่งช่องมักจะรองรับคำขอพร้อมกันได้มากกว่า 100 คำขอ ดังนั้น Bazel จึงสามารถสร้างคำขอพร้อมกันประมาณ "--remote_max_connections * 100"
แท็ก: host_machine_resource_optimizations
ค่าเริ่มต้น --remote_proxy=<a string>: ดูคำอธิบาย
เชื่อมต่อกับแคชระยะไกลผ่านพร็อกซี ปัจจุบัน Flag นี้สามารถใช้เพื่อกำหนดค่า Socket ของโดเมน Unix (unix:/path/to/socket) เท่านั้น
ค่าเริ่มต้น --remote_result_cache_priority=<an integer>: "0"
ลำดับความสำคัญที่เกี่ยวข้องของการดำเนินการระยะไกลที่จะจัดเก็บในแคชระยะไกล ความหมายของค่าลำดับความสำคัญหนึ่งๆ จะขึ้นอยู่กับเซิร์ฟเวอร์
ค่าเริ่มต้น --remote_retries=<an integer>: "5"
จำนวนสูงสุดของความพยายามที่จะลองแก้ไขข้อผิดพลาดชั่วคราวอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
ค่าเริ่มต้น --remote_retry_max_delay=<An immutable length of time.>: "5s"
การหน่วงเวลา Backoff สูงสุดระหว่างการพยายามลองอีกครั้งจากระยะไกล คุณสามารถใช้หน่วยต่อไปนี้: วัน (d), ชั่วโมง (h), นาที (m), วินาที และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
ค่าเริ่มต้นของ --remote_timeout=<An immutable length of time.>: "60 วินาที"
ระยะเวลาสูงสุดในการรอการเรียกใช้จากระยะไกลและการเรียกใช้แคช สำหรับแคช REST นี่คือทั้งการเชื่อมต่อและระยะหมดเวลาในการอ่าน คุณสามารถใช้หน่วยต่อไปนี้: วัน (d), ชั่วโมง (h), นาที (m), วินาที และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
ค่าเริ่มต้น --[no]remote_upload_local_results: "true"
เลือกว่าจะอัปโหลดผลลัพธ์การดำเนินการที่ดำเนินการในเครื่องไปยังแคชระยะไกลหรือไม่ หากแคชระยะไกลรองรับ และผู้ใช้ได้รับอนุญาตให้ดำเนินการดังกล่าว
ค่าเริ่มต้น --[no]remote_verify_downloads: "true"
หากตั้งค่าเป็น "จริง" Bazel จะคำนวณจำนวนแฮชของการดาวน์โหลดระยะไกลทั้งหมด และทิ้งค่าที่แคชไว้จากระยะไกลหากไม่ตรงกับค่าที่คาดไว้
ตัวเลือกเบ็ดเตล็ด ที่ยังไม่ได้รับการแยกประเภท:
ค่าเริ่มต้น --[no]allow_analysis_cache_discard: "true"
หากทิ้งแคชการวิเคราะห์เนื่องจากการเปลี่ยนแปลงในระบบบิลด์ การตั้งค่าตัวเลือกนี้เป็น "เท็จ" จะทำให้ระบบออก bazel แทนที่จะดำเนินการต่อด้วยบิลด์ ตัวเลือกนี้ไม่มีผลเมื่อ "discard_analysis_cache" ก็มีการตั้งค่าเช่นกัน
แท็ก: eagerness_to_exit
ค่าเริ่มต้น --auto_output_filter=<none, all, packages or subpackages>: "ไม่มี"
หากไม่ได้ระบุ --output_filter ระบบจะใช้ค่าของตัวเลือกนี้ในการสร้างตัวกรองโดยอัตโนมัติ ค่าที่ใช้ได้คือ "none" (ไม่ต้องกรอง / แสดงทุกอย่าง), "ทั้งหมด" (กรองทุกอย่าง / ไม่แสดงอะไรเลย), "แพ็กเกจ" (รวมเอาต์พุตจากกฎในแพ็กเกจที่กล่าวถึงในบรรทัดคำสั่ง Blaze) และ "แพ็กเกจย่อย" (เช่น "แพ็กเกจ" แต่รวมแพ็กเกจย่อยด้วย) สำหรับ "แพ็กเกจ" และ "แพ็กเกจย่อย" //java/foo และ //javatests/foo จะถือว่าเป็น 1 แพ็กเกจ)'
ค่าเริ่มต้น --[no]build_manual_tests: "เท็จ"
บังคับใช้เป้าหมายการทดสอบที่ติดแท็ก "ด้วยตนเอง" ให้เกิดขึ้นจริง "ด้วยตนเอง" การทดสอบจะไม่รวมอยู่ในการประมวลผล ตัวเลือกนี้จะบังคับให้ระบบสร้างรายงาน (แต่ไม่ต้องดำเนินการ)
ค่าเริ่มต้นของ --build_tag_filters=<comma-separated list of options>: ""
ระบุรายการแท็กที่คั่นด้วยคอมมา แต่ละแท็กสามารถขึ้นต้นด้วย "-" หรือไม่ก็ได้ เพื่อระบุแท็กที่ยกเว้น ระบบจะสร้างเฉพาะเป้าหมายเหล่านั้นซึ่งมีแท็กที่รวมอยู่อย่างน้อย 1 แท็กและไม่มีแท็กที่ยกเว้น ตัวเลือกนี้ไม่มีผลกับชุดการทดสอบที่ดำเนินการด้วยคำสั่ง "test" (ทดสอบ) คำสั่ง; การควบคุมเหล่านั้นจะอยู่ภายใต้ตัวเลือกการกรองทดสอบ เช่น "--test_tag_filters"
ค่าเริ่มต้น --[no]build_tests_only: "เท็จ"
หากระบุ ระบบจะสร้างเฉพาะกฎ *_test และ test_suite และจะไม่สนใจเป้าหมายอื่นๆ ที่ระบุในบรรทัดคำสั่ง โดยค่าเริ่มต้น ทุกอย่างที่ขอจะได้รับการสร้าง
ค่าเริ่มต้น --combined_report=<none or lcov>: "ไม่มี"
ระบุประเภทรายงานความครอบคลุมสะสมที่ต้องการ ขณะนี้ระบบรองรับเฉพาะ LCOV เท่านั้น
ค่าเริ่มต้น --[no]compile_one_dependency: "เท็จ"
คอมไพล์ทรัพยากร Dependency เดียวของไฟล์อาร์กิวเมนต์ วิธีนี้มีประโยชน์ในการตรวจสอบไฟล์แหล่งที่มาใน IDE เช่น การสร้างเป้าหมายเดี่ยวขึ้นมาใหม่ให้อาศัยไฟล์ต้นฉบับ เพื่อตรวจหาข้อผิดพลาดให้เร็วที่สุดในรอบการแก้ไข/สร้าง/ทดสอบ อาร์กิวเมนต์นี้จะส่งผลต่อวิธีการตีความอาร์กิวเมนต์แบบไม่แจ้งทั้งหมด แทนที่จะกำหนดเป้าหมายในการสร้างเป็นชื่อไฟล์ต้นฉบับ สำหรับชื่อไฟล์ต้นฉบับแต่ละชื่อไฟล์ จะมีเป้าหมายที่กำหนดเองที่ขึ้นอยู่กับไฟล์ดังกล่าว
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --deleted_packages=<comma-separated list of package names> รายการ
รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริงแม้ว่าจะปรากฏอยู่ที่ใดที่หนึ่งบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ เช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์ ระบบบิลด์อาจบ่นหากพบป้ายกำกับ "//x:y/z" ถ้ามีข้อมูลระบุโดยรายการpackage_path อื่นอยู่ การระบุ --deleted_packages x/y ช่วยป้องกันปัญหานี้
ค่าเริ่มต้น --[no]discard_analysis_cache: "เท็จ"
ทิ้งแคชการวิเคราะห์ทันทีหลังจากที่ขั้นตอนการวิเคราะห์เสร็จสมบูรณ์แล้ว ลดการใช้งานหน่วยความจำประมาณ 10% แต่ทำให้บิลด์เพิ่มเติมช้าลง
ค่าเริ่มต้น --disk_cache=<a path>: ดูคำอธิบาย
เส้นทางไปยังไดเรกทอรีที่ Bazel อ่านและเขียนการดำเนินการและเอาต์พุตการดำเนินการได้ หากไม่มีไดเรกทอรี ระบบจะสร้างไดเรกทอรีให้
ค่าเริ่มต้นของ --embed_label=<a one-line string>: ""
ฝังการแก้ไขการควบคุมแหล่งที่มาหรือป้ายกำกับรุ่นในไบนารี
ค่าเริ่มต้น --execution_log_binary_file=<a path>: ดูคำอธิบาย
บันทึกการสร้างที่เรียกใช้ลงในไฟล์นี้เป็นโปรโตคอลของ SpawnExec ที่คั่นด้วยความยาว ตามข้อมูลใน src/main/prodbuf/spawn.protocol แฟล็กที่เกี่ยวข้อง: --execution_log_json_file (รูปแบบข้อความ JSON แยกกัน), --execution_log_sort (ไม่ว่าจะจัดเรียงบันทึกการดำเนินการหรือไม่), --subcommands (สำหรับการแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
ค่าเริ่มต้น --execution_log_json_file=<a path>: ดูคำอธิบาย
บันทึกการสร้างที่เรียกใช้ลงในไฟล์นี้เป็นการแสดง JSON ของ SpawnExec ที่คั่นด้วยการขึ้นบรรทัดใหม่ ตามข้อมูลใน src/main/protobuf/spawn.proto แฟล็กที่เกี่ยวข้อง: --execution_log_binary_file (รูปแบบไบนารี Protobuf, แยกเฉพาะ), --execution_log_sort (ไม่ว่าจะจัดเรียงบันทึกการดำเนินการหรือไม่), --subcommands (สำหรับการแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
ค่าเริ่มต้น --[no]execution_log_sort: "true"
เลือกว่าจะจัดเรียงบันทึกการดำเนินการหรือไม่ เพื่อให้เปรียบเทียบบันทึกระหว่างการเรียกใช้ได้ง่ายขึ้น ตั้งค่าเป็น "เท็จ" เพื่อหลีกเลี่ยงการใช้ CPU และหน่วยความจำที่อาจเกิดขึ้นอย่างมากเมื่อสิ้นสุดการเรียกใช้ โดยสร้างบันทึกในลำดับการดำเนินการแบบไม่กำหนดทิศทาง ใช้กับรูปแบบไบนารีและ JSON เท่านั้น ระบบจะไม่จัดเรียงรูปแบบกะทัดรัด
ค่าเริ่มต้น --[no]expand_test_suites: "true"
ขยายเป้าหมาย test_suite ไปยังการทดสอบส่วนประกอบก่อนการวิเคราะห์ เมื่อเปิดธงนี้ (ค่าเริ่มต้น) ระบบจะใช้รูปแบบเป้าหมายเชิงลบกับการทดสอบที่เป็นของชุดทดสอบ มิฉะนั้น ระบบจะไม่ใช้รูปแบบเป้าหมายเชิงลบ การปิดแฟล็กนี้มีประโยชน์เมื่อใช้ระดับบนสุดในบรรทัดคำสั่ง จากนั้นผู้ใช้จึงวิเคราะห์เป้าหมาย test_suite ได้
แท็ก: loading_and_analysis
ค่าเริ่มต้น --experimental_execution_log_compact_file=<a path>: ดูคำอธิบาย
บันทึกการสร้างที่เรียกใช้ลงในไฟล์นี้เป็นโปรโต ExecLogEntry ของ ExecLogEntry ที่คั่นด้วยความยาวตามข้อมูลใน src/main/protocolbuf/spawn.protocol ไฟล์ทั้งไฟล์ถูกบีบอัดแบบ zstd นี่คือรูปแบบทดลองที่อยู่ระหว่างการพัฒนา และอาจเปลี่ยนแปลงได้ตลอดเวลา แฟล็กที่เกี่ยวข้อง: --execution_log_binary_file (รูปแบบไบนารี Protobuf; แยกเฉพาะ), --execution_log_json_file (รูปแบบข้อความ JSON; แยกไว้ต่างหาก), --subcommands (สำหรับแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
ค่าเริ่มต้นของ --experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: ""
เลิกใช้งานไปทีละด้าน ชุดตัวกรองเป้าหมายเพื่อตั้งเวลา extra_actions
ค่าเริ่มต้น --[no]experimental_extra_action_top_level_only: "เท็จ"
เลิกใช้งานไปทีละด้าน ตั้งเวลาให้เฉพาะการดำเนินการเพิ่มเติมสำหรับเป้าหมายระดับบนสุดเท่านั้น
--experimental_spawn_scheduler
เปิดใช้การดำเนินการแบบไดนามิกโดยเรียกใช้การดำเนินการภายในเครื่องและจากระยะไกลพร้อมกัน Bazel สร้างการดำเนินการแต่ละอย่างไว้ภายในเครื่องและจากระยะไกล แล้วเลือกการดำเนินการที่เสร็จสิ้นก่อน หากการดำเนินการรองรับผู้ปฏิบัติงาน การดำเนินการเฉพาะเครื่องจะทำงานในโหมดผู้ปฏิบัติงานถาวร หากต้องการเปิดใช้การดำเนินการแบบไดนามิกสำหรับหน่วยความจำการดำเนินการแต่ละรายการ ให้ใช้แฟล็ก "--internal_spawn_scheduler" และ "--strategy=<mnemonic>=dynamic" แทน
ขยายเป็น

--internal_spawn_scheduler --spawn_strategy=dynamic
ค่าเริ่มต้น --[no]fetch: "true"
อนุญาตให้คำสั่งดึงข้อมูลทรัพยากร Dependency ภายนอก หากตั้งค่าเป็น "เท็จ" คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ และหากไม่มี คำสั่งดังกล่าวจะทำให้การทำงานล้มเหลว
ค่าเริ่มต้น --[no]incompatible_dont_use_javasourceinfoprovider: "เท็จ"
ไม่มีการดำเนินการ
แท็ก: incompatible_change
ค่าเริ่มต้น --local_termination_grace_seconds=<an integer>: "15"
เวลาที่ต้องรอระหว่างการสิ้นสุดกระบวนการในเครื่องเนื่องจากหมดเวลาและบังคับปิดกระบวนการดังกล่าว
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --override_repository=<an equals-separated mapping of repository name to path> รายการ
ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์ ระบบจะใช้เส้นทางตามที่เป็น ถ้าเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพัทธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางดังกล่าวจะสัมพัทธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"
ค่าเริ่มต้นของ --package_path=<colon-separated list of options>: "%workspace%"
รายการตำแหน่งที่จะค้นหาแพ็กเกจที่คั่นด้วยโคลอน องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับพื้นที่ทำงานที่ล้อมรอบอยู่ หากไม่ระบุหรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
ค่าเริ่มต้น --[no]show_loading_progress: "true"
หากเปิดใช้ จะทำให้ Bazel พิมพ์ "กำลังโหลดแพ็กเกจ:" ข้อความ
ค่าเริ่มต้นของ --test_lang_filters=<comma-separated list of options>: ""
ระบุรายการภาษาทดสอบที่คั่นด้วยคอมมา แต่ละภาษาอาจนำหน้าด้วย '-' หรือไม่ก็ได้ เพื่อระบุภาษาที่ยกเว้น ระบบจะพบเฉพาะเป้าหมายทดสอบเหล่านั้นที่ใช้ภาษาที่ระบุ ชื่อที่ใช้สำหรับแต่ละภาษาควรเหมือนกับคำนำหน้าภาษาในกฎ *_test เช่น หนึ่งใน "cc", 'java', 'py' ฯลฯ ตัวเลือกนี้ส่งผลต่อพฤติกรรม --build_tests_only พฤติกรรม และคำสั่งทดสอบ
ค่าเริ่มต้นของ --test_size_filters=<comma-separated list of values: small, medium, large or enormous>: ""
ระบุรายการขนาดทดสอบที่คั่นด้วยคอมมา แต่ละขนาดจะมีเครื่องหมาย "-" นำหน้าได้ เพื่อระบุขนาดที่ยกเว้น ระบบจะพบว่าเป้าหมายทดสอบเหล่านั้นมีขนาดอย่างน้อย 1 ขนาดและไม่มีขนาดที่ยกเว้น ตัวเลือกนี้จะมีผลกับลักษณะการทำงาน --build_tests_only และคำสั่งทดสอบ
ค่าเริ่มต้นของ --test_tag_filters=<comma-separated list of options>: ""
ระบุรายการแท็กทดสอบที่คั่นด้วยคอมมา แต่ละแท็กสามารถขึ้นต้นด้วย "-" หรือไม่ก็ได้ เพื่อระบุแท็กที่ยกเว้น และจะพบว่าเป้าหมายทดสอบเหล่านั้นมีแท็กที่รวมไว้อย่างน้อย 1 แท็กและไม่มีแท็กที่ยกเว้น ตัวเลือกนี้จะมีผลกับลักษณะการทำงาน --build_tests_only และคำสั่งทดสอบ
ค่าเริ่มต้นของ --test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>: ""
ระบุรายการระยะหมดเวลาของการทดสอบที่คั่นด้วยคอมมา ระยะหมดเวลาแต่ละครั้งจะมีเครื่องหมาย "-" นำหน้าได้ เพื่อระบุการหมดเวลาที่ยกเว้น ระบบจะพบเฉพาะเป้าหมายทดสอบเหล่านั้นที่มีระยะหมดเวลาอย่างน้อย 1 รายการและไม่มีระยะหมดเวลาที่ยกเว้น ตัวเลือกนี้จะมีผลกับลักษณะการทำงาน --build_tests_only และคำสั่งทดสอบ
ค่าเริ่มต้นของ --workspace_status_command=<path>: ""
คำสั่งที่เรียกใช้ในตอนต้นของบิลด์เพื่อให้ข้อมูลสถานะเกี่ยวกับพื้นที่ทำงานในรูปแบบคู่คีย์/ค่า โปรดดูคู่มือผู้ใช้เพื่อดูข้อกำหนดทั้งหมด นอกจากนี้ โปรดดูเครื่องมือ/buildstamp/get_workspace_status เป็นต้น
ตัวเลือกที่ควบคุมการดำเนินการของบิลด์:
ค่าเริ่มต้น --[no]check_up_to_date: "เท็จ"
ห้ามดำเนินการสร้าง เพียงตรวจสอบว่าเป็นรุ่นล่าสุดหรือไม่ หากเป้าหมายทั้งหมดเป็นปัจจุบัน แสดงว่าบิลด์เสร็จสมบูรณ์ หากต้องดำเนินการในขั้นตอนใด ระบบจะรายงานข้อผิดพลาดและบิลด์ล้มเหลว
แท็ก: execution
เลือกว่าจะเรียกใช้ระบบไฟล์โดยตรงเพื่อสร้างต้นไม้ Symlink หรือไม่
แท็ก: loading_and_analysis, execution, experimental
ค่าเริ่มต้น --[no]experimental_persistent_aar_extractor: "เท็จ"
เปิดใช้เครื่องมือแยก Aar แบบถาวรโดยใช้ผู้ปฏิบัติงาน
แท็ก: execution
ค่าเริ่มต้น --[no]experimental_remotable_source_manifests: "เท็จ"
ต้องการให้การดำเนินการในไฟล์ Manifest ของแหล่งที่มาทำซ้ำได้หรือไม่
แท็ก: loading_and_analysis, execution, experimental
ค่าเริ่มต้น --[no]experimental_split_coverage_postprocessing: "เท็จ"
หากเป็น "จริง" Bazel จะดำเนินการประมวลผลภายหลังสำหรับการครอบคลุมในการทดลองที่สร้างขึ้นใหม่
แท็ก: execution
ค่าเริ่มต้น --[no]experimental_split_xml_generation: "true"
หากมีการกำหนดแฟล็กนี้ และการดำเนินการทดสอบไม่สร้างไฟล์ test.xml ขึ้นมา Bazel จะใช้การดำเนินการแยกต่างหากเพื่อสร้างไฟล์ test.xml จำลองที่มีบันทึกการทดสอบ มิฉะนั้น Bazel จะสร้าง test.xml เป็นส่วนหนึ่งของการดำเนินการทดสอบ
แท็ก: execution
ค่าเริ่มต้น --[no]experimental_strict_fileset_output: "เท็จ"
หากเปิดใช้ตัวเลือกนี้ ชุดไฟล์จะถือว่าอาร์ติแฟกต์เอาต์พุตทั้งหมดเป็นไฟล์ทั่วไป โดยจะไม่ข้ามผ่านไดเรกทอรีหรือไวต่อลิงก์สัญลักษณ์
แท็ก: execution
ค่าเริ่มต้น --[no]experimental_use_semaphore_for_jobs: "true"
หากตั้งค่าเป็น "จริง" ให้ใช้ Semaphore เพิ่มเติมเพื่อจำกัดจำนวนงานที่เกิดขึ้นพร้อมกัน
แท็ก: host_machine_resource_optimizations execution
ค่าเริ่มต้นของ --genrule_strategy=<comma-separated list of options>: ""
ระบุวิธีเรียกใช้ Genrule การแจ้งว่าไม่เหมาะสมนี้จะถูกนำออก ให้ใช้ --spawn_strategy=<value> แทน เพื่อควบคุมการดำเนินการทั้งหมด หรือ --strategy=Genrule=<value> เพื่อควบคุม Genrules เท่านั้น
แท็ก: execution
ค่าเริ่มต้น --[no]incompatible_disallow_unsound_directory_outputs: "true"
หากตั้งค่าแล้ว การดำเนินการจะแปลงไฟล์เอาต์พุตเป็นไดเรกทอรีเป็นข้อผิดพลาด ไม่ส่งผลกระทบต่อไดเรกทอรีต้นทาง ดู https://github.com/bazelbuild/bazel/issues/18646
แท็ก: bazel_internal_configuration incompatible_change
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> [-j] ค่าเริ่มต้น: "อัตโนมัติ"
จำนวนงานที่เกิดขึ้นพร้อมกันที่จะเรียกใช้ ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") โดยจะเลือกตามด้วยการดำเนินการ ([-|*]<Float>) เช่น "auto", "HOST_CPUS*.5" ค่าต้องอยู่ระหว่าง 1 ถึง 5000 ค่าที่สูงกว่า 2,500 อาจก่อให้เกิดปัญหาเกี่ยวกับหน่วยความจำ "อัตโนมัติ" จะคำนวณค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์
แท็ก: host_machine_resource_optimizations execution
--[no]keep_going [-k] ค่าเริ่มต้น: "เท็จ"
ดำเนินการต่อให้มากที่สุดหลังจากเกิดข้อผิดพลาด แม้ว่าเป้าหมายที่ล้มเหลวและเป้าหมายที่อ้างอิงอยู่จะไม่สามารถวิเคราะห์ได้ แต่ข้อกําหนดเบื้องต้นอื่นๆ ของเป้าหมายเหล่านี้อาจเป็นไปได้
แท็ก: eagerness_to_exit
ค่าเริ่มต้น --loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">: "อัตโนมัติ"
จำนวนชุดข้อความแบบขนานที่จะใช้สำหรับขั้นตอนการโหลด/การวิเคราะห์ ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") หรือเลือกตามด้วยการดำเนินการ ([-|*]<Float>) เช่น "auto", "HOST_CPUS*.5" "อัตโนมัติ" ตั้งค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก: bazel_internal_configuration
ค่าเริ่มต้นของ --modify_execution_info=<regex=[+-]key,regex=[+-]key,...>: ""
เพิ่มหรือนำคีย์ออกจากข้อมูลการดำเนินการของการดำเนินการตามความสามารถในการจำการดำเนินการ ใช้กับการดำเนินการที่รองรับข้อมูลการดำเนินการเท่านั้น การดำเนินการทั่วไปจำนวนมากรองรับข้อมูลการดำเนินการ เช่น Genrule, CppCompile, Javac, StarlarkAction, TestRunner เมื่อระบุค่าหลายค่า ลำดับมีความสำคัญเนื่องจาก regexe หลายรายการอาจใช้กับช่วยจำเดียวกันได้ ไวยากรณ์: "regex=[+-]key,regex=[+-]key,..." ตัวอย่าง: '.*=+x,.*=-y,.*=+z' เพิ่ม "x" และ "z" ถึง และนำ "y" ออก ข้อมูลการดำเนินการสำหรับการดำเนินการทั้งหมด 'Genrule=+requires-x' เพิ่ม "requires-x" กับข้อมูลการดำเนินการสำหรับการดำเนินการ Genrule ทั้งหมด '(?!Genrule).*=-requires-x' นำ "requires-x" ออก จากข้อมูลการดำเนินการสำหรับการดำเนินการ ที่ไม่ใช่ Genrule ทั้งหมด
แท็ก: execution, affects_outputs, loading_and_analysis
--persistent_android_dex_desugar
เปิดใช้การดำเนินการ Dex และ desugar ของ Android แบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น

--internal_persistent_android_dex_desugar --strategy=Desugar=worker
--strategy=DexBuilder=worker

แท็ก: host_machine_resource_optimizations execution
--persistent_android_resource_processor
เปิดใช้ผู้ประมวลผลข้อมูลทรัพยากร Android ถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น

--internal_persistent_busybox_tools --strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker

แท็ก: host_machine_resource_optimizations, execution
--persistent_multiplex_android_dex_desugar
เปิดใช้การดำเนินการ Dex และ desugar ของ Android แบบมัลติเพล็กซ์โดยใช้ผู้ปฏิบัติงาน
ขยายเป็น

--persistent_android_dex_desugar --internal_persistent_multiplex_android_dex_desugar

แท็ก: host_machine_resource_optimizations, execution
--persistent_multiplex_android_resource_processor
เปิดใช้เครื่องมือประมวลผลทรัพยากร Android แบบมัลติเพล็กซ์แบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น

--persistent_android_resource_processor --modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers

แท็ก: host_machine_resource_optimizations, execution
--persistent_multiplex_android_tools
เปิดใช้เครื่องมือ Android แบบต่อเนื่องและแบบมัลติเพล็กซ์ (Dexing, Deugaring, Resource Operations)
ขยายเป็น

--internal_persistent_multiplex_busybox_tools --persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar

แท็ก: host_machine_resource_optimizations execution
ค่าเริ่มต้น --[no]skip_incompatible_explicit_targets: "เท็จ"
ข้ามเป้าหมายที่ใช้ร่วมกันไม่ได้ซึ่งระบุไว้อย่างชัดแจ้งในบรรทัดคำสั่ง โดยค่าเริ่มต้น การสร้างเป้าหมายดังกล่าวจะทำให้เกิดข้อผิดพลาด แต่เป้าหมายเหล่านี้จะถูกข้ามโดยอัตโนมัติเมื่อเปิดใช้ตัวเลือกนี้ ดูที่ https://bazel.build/extending/platforms#skipping-incompatible-targets
แท็ก: loading_and_analysis
ค่าเริ่มต้นของ --spawn_strategy=<comma-separated list of options>: ""
ระบุวิธีการสร้างคำสั่งเริ่มต้น ยอมรับรายการกลยุทธ์ที่คั่นด้วยจุลภาคจากลำดับความสำคัญสูงสุดไปต่ำสุด สำหรับการกระทำแต่ละรายการ Bazel จะเลือกกลยุทธ์ที่มีลำดับความสำคัญสูงสุดที่สามารถกระทำได้ ค่าเริ่มต้นคือ "remote,worker,sandboxed,local" ดูรายละเอียดได้ที่ https://blog.bazel.build/2019/06/19/list-strategy.html
แท็ก: execution
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --strategy=<a '[name=]value1[,..,valueN]' assignment> รายการ
ระบุวิธีการเผยแพร่การคอมไพล์การดำเนินการอื่นๆ ที่สร้างขึ้น ยอมรับรายการกลยุทธ์ที่คั่นด้วยจุลภาคจากลำดับความสำคัญสูงสุดไปต่ำสุด สำหรับการกระทำแต่ละรายการ Bazel จะเลือกกลยุทธ์ที่มีลำดับความสำคัญสูงสุดที่สามารถกระทำได้ ค่าเริ่มต้นคือ "remote,worker,sandboxed,local" แฟล็กนี้จะลบล้างค่าที่กำหนดโดย --spawn_strategy (และ --genrule_strategy หากใช้กับ mnemonic Genrule) ดูรายละเอียดได้ที่ https://blog.bazel.build/2019/06/19/list-strategy.html
แท็ก: execution
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --strategy_regexp=<a '<RegexFilter>=value[,value]' assignment> รายการ
ลบล้างกลยุทธ์การสร้างที่สร้างขึ้นเพื่อเรียกใช้การดำเนินการที่สร้างขึ้นซึ่งมีคำอธิบายตรงกับ regex_filter บางรายการ ดู --per_file_copt สำหรับรายละเอียดการจับคู่เกี่ยวกับนิพจน์ทั่วไป ระบบจะใช้ regex_filter สุดท้ายที่ตรงกับคำอธิบาย ตัวเลือกนี้จะลบล้างแฟล็กอื่นๆ สำหรับการระบุกลยุทธ์ ตัวอย่าง: --strategy_regexp=//foo.*\.cc,-//foo/bar=local หมายถึงการเรียกใช้การดำเนินการโดยใช้กลยุทธ์ท้องถิ่นหากคำอธิบายตรงกับ //foo.*.cc แต่ไม่ตรงกับ //foo/bar ตัวอย่างเช่น --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed จะเรียกใช้ 'Compiling //foo/bar/baz' พร้อมแป้น "local" แต่การกลับลำดับคำสั่งซื้อจะทำงานด้วย "แซนด์บ็อกซ์"
แท็ก: execution
ค่าเริ่มต้น --[no]use_target_platform_for_tests: "เท็จ"
หากเป็น "จริง" Bazel จะใช้แพลตฟอร์มเป้าหมายในการทำการทดสอบแทนกลุ่มผู้บริหารทดสอบ
แท็ก: execution
ตัวเลือกที่กำหนดค่า Toolchain ที่ใช้สำหรับการดำเนินการมีดังนี้
ค่าเริ่มต้น --android_compiler=<a string>: ดูคำอธิบาย
คอมไพเลอร์เป้าหมายของ Android
แท็ก: affects_outputs, loading_and_analysis, loses_incremental_state
--android_crosstool_top=<a build target label> ค่าเริ่มต้น: "//external:android/crosstool"
ตำแหน่งของคอมไพเลอร์ C++ ที่ใช้สำหรับบิลด์ของ Android
แท็ก: affects_outputs, changes_inputs, loading_and_analysis, loses_incremental_state
ค่าเริ่มต้น --android_grte_top=<a label>: ดูคำอธิบาย
เป้าหมาย Android grte_top
แท็ก: changes_inputs, loading_and_analysis, loses_incremental_state
ค่าเริ่มต้นของ --android_manifest_merger=<legacy, android or force_android>: "android"
เลือกการควบรวมไฟล์ Manifest ที่จะใช้กับกฎ android_binary แจ้งเพื่อช่วยให้เปลี่ยนไปใช้การผสานรวมไฟล์ Manifest ของ Android จากการควบรวมเดิม
แท็ก: affects_outputs, loading_and_analysis, loses_incremental_state
ค่าเริ่มต้นของ --android_platforms=<a build target label>: ""
ตั้งค่าแพลตฟอร์มที่ android_binary กำหนดเป้าหมายใช้ หากระบุหลายแพลตฟอร์ม ไบนารีนั้นจะเป็น APK แบบอ้วน ซึ่งมีไบนารีแบบเนทีฟสำหรับแต่ละแพลตฟอร์มเป้าหมายที่ระบุ
แท็ก: changes_inputs, loading_and_analysis, loses_incremental_state
ค่าเริ่มต้นของ --android_sdk=<a build target label>: "@bazel_tools//tools/android:sdk"
ระบุ SDK/แพลตฟอร์ม Android ที่ใช้สร้างแอปพลิเคชัน Android
แท็ก: changes_inputs, loading_and_analysis, loses_incremental_state
--apple_crosstool_top=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้ในกฎของ Apple และ Objc และทรัพยากร Dependency
แท็ก: loses_incremental_state changes_inputs
ค่าเริ่มต้นของ --cc_output_directory_tag=<a string>: ""
ระบุคำต่อท้ายที่จะเพิ่มในไดเรกทอรีการกำหนดค่า
แท็ก: affects_outputs
ค่าเริ่มต้น --compiler=<a string>: ดูคำอธิบาย
คอมไพเลอร์ C++ ที่จะใช้สำหรับการคอมไพล์เป้าหมาย
แท็ก: loading_and_analysis execution
--coverage_output_generator=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/test:lcov_merger"
ตำแหน่งของไบนารีที่ใช้เพื่อประมวลผลรายงานการครอบคลุมแบบข้อมูลดิบหลังการประมวลผล ซึ่งต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งก็คือไบนารี ค่าเริ่มต้นคือ "//tools/test:lcov_merger"
แท็ก: changes_inputs, affects_outputs, loading_and_analysis
--coverage_report_generator=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_report_generator"
ตําแหน่งของไบนารีที่ใช้สร้างรายงานการครอบคลุม ซึ่งต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งก็คือไบนารี ค่าเริ่มต้นคือ "//tools/test:coverage_report_generator"
แท็ก: changes_inputs, affects_outputs, loading_and_analysis
--coverage_support=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_support"
ตำแหน่งของไฟล์สนับสนุนที่จำเป็นต้องใช้ในอินพุตของการดำเนินการทดสอบทั้งหมดที่รวบรวมการครอบคลุมของโค้ด ค่าเริ่มต้นคือ "//tools/test:coverage_support"
แท็ก: changes_inputs, affects_outputs, loading_and_analysis
--crosstool_top=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้สำหรับคอมไพล์โค้ด C++
แท็ก: loading_and_analysis, changes_inputs, affects_outputs
ค่าเริ่มต้น --custom_malloc=<a build target label>: ดูคำอธิบาย
ระบุการใช้งาน Malloc ที่กำหนดเอง การตั้งค่านี้จะลบล้างแอตทริบิวต์ Malloc ในกฎบิลด์
แท็ก: changes_inputs affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment> รายการ
รายการนิพจน์ทั่วไปที่คั่นด้วยคอมมา แต่ละรายการจะมีคำนำหน้าด้วย - (นิพจน์เชิงลบ) และกำหนด (=) ให้กับรายการเป้าหมายค่าข้อจำกัดที่คั่นด้วยคอมมา หากเป้าหมายตรงกับที่ไม่มีนิพจน์เชิงลบ และนิพจน์เชิงบวกอย่างน้อย 1 รายการ การแปลง Toolchain จะดำเนินการเสมือนว่าได้ประกาศค่าข้อจำกัดเป็นข้อจำกัดการดำเนินการ ตัวอย่าง: //demo,-test=@platforms//cpus:x86_64 จะเพิ่ม "x86_64" ไปยังเป้าหมายใดๆ ภายใต้ //demo ยกเว้นเป้าหมายที่ชื่อมี "test"
แท็ก: loading_and_analysis
ค่าเริ่มต้น --[no]experimental_include_xcode_execution_requirements: "เท็จ"
เมื่อตั้งค่าแล้ว ให้เพิ่ม "requires-xcode:{version}" สำหรับการดำเนินการของ Xcode ทุกครั้ง หากเวอร์ชัน xcode มีป้ายกำกับขีดกลาง ให้เพิ่ม "requires-xcode-label:{version_label}" ด้วย ข้อกำหนดของการดำเนินการ
แท็ก: loses_incremental_state, loading_and_analysis, execution
ค่าเริ่มต้น --[no]experimental_prefer_mutual_xcode: "true"
หากเป็นจริง ให้ใช้ Xcode ล่าสุดที่พร้อมใช้งานทั้งในเครื่องและจากระยะไกล หากเป็นเท็จหรือไม่มีเวอร์ชันที่ใช้ร่วมกัน ให้ใช้เวอร์ชันของ Xcode ในเครื่องที่เลือกผ่าน xcode-select
แท็ก: loses_incremental_state
ค่าเริ่มต้นของ --extra_execution_platforms=<comma-separated list of options>: ""
แพลตฟอร์มที่มีให้ใช้งานเป็นแพลตฟอร์มการดำเนินการเพื่อเรียกใช้การดำเนินการ สามารถระบุแพลตฟอร์มโดยเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมาย แพลตฟอร์มเหล่านี้จะได้รับการพิจารณาก่อนแพลตฟอร์มที่ประกาศในไฟล์ WORKSPACE โดยregister_execution_platforms() ตัวเลือกนี้ตั้งค่าได้เพียงครั้งเดียว อินสแตนซ์ภายหลังจะลบล้างการตั้งค่าแฟล็กก่อนหน้า
แท็ก: execution
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --extra_toolchains=<comma-separated list of options> รายการ
กฎ Toolchain ที่จะต้องพิจารณาระหว่างการแก้ไข Toolchain สามารถระบุ Toolchains ตามเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมายได้ ระบบจะพิจารณา Toolchain เหล่านี้ก่อนการประกาศในไฟล์ WORKSPACE โดยregister_toolchains()
แท็ก: affects_outputs, changes_inputs, loading_and_analysis
ค่าเริ่มต้น --grte_top=<a label>: ดูคำอธิบาย
ป้ายกำกับไปยังไลบรารี libc ที่มีการเช็คอิน Crosstool Toolchain จะเลือกค่าเริ่มต้นและคุณแทบจะไม่จำเป็นต้องลบล้างค่าเริ่มต้น
แท็ก: action_command_lines affects_outputs
ค่าเริ่มต้น --host_compiler=<a string>: ดูคำอธิบาย
คอมไพเลอร์ C++ ที่จะใช้สำหรับการคอมไพล์โฮสต์ โดยจะไม่มีผลหากไม่ได้ตั้งค่า --host_crosstool_top
แท็ก: loading_and_analysis execution
ค่าเริ่มต้น --host_crosstool_top=<a build target label>: ดูคำอธิบาย
โดยค่าเริ่มต้น ตัวเลือก --crosstool_top และ --compiler จะใช้สำหรับการกำหนดค่าผู้ดำเนินการด้วย หากมีแฟล็กนี้ Bazel จะใช้ libc และคอมไพเลอร์เริ่มต้นสำหรับ Crosstool_top ที่ระบุ
แท็ก: loading_and_analysis, changes_inputs, affects_outputs
ค่าเริ่มต้น --host_grte_top=<a label>: ดูคำอธิบาย
ถ้าระบุ การตั้งค่านี้จะลบล้างไดเรกทอรีระดับบนสุดของ libc (--grte_top) สำหรับการกำหนดค่าผู้บริหาร
แท็ก: action_command_lines affects_outputs
ค่าเริ่มต้น --host_platform=<a build target label>: "@local_config_platform//:host"
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายระบบโฮสต์
แท็ก: affects_outputs, changes_inputs, loading_and_analysis
ค่าเริ่มต้น --[no]incompatible_dont_enable_host_nonhost_crosstool_features: "true"
หากเป็น "จริง" Bazel จะไม่เปิดใช้ "โฮสต์" และ "nonhost" ใน Toolchain ของ c++ (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/7407)
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --[no]incompatible_enable_android_toolchain_resolution: "true"
ใช้ความละเอียดของ Toolchain เพื่อเลือก Android SDK สำหรับกฎ Android (Starlark และเนทีฟ)
แท็ก: loading_and_analysis, incompatible_change
ค่าเริ่มต้น --[no]incompatible_enable_apple_toolchain_resolution: "เท็จ"
ใช้ความละเอียดของ Toolchain เพื่อเลือก Apple SDK สำหรับกฎของ Apple (Starlark และเนทีฟ)
แท็ก: loading_and_analysis, incompatible_change
ค่าเริ่มต้น --[no]incompatible_make_thinlto_command_lines_standalone: "true"
หากเป็นจริง Bazel จะไม่นำบรรทัดคำสั่งสำหรับการดำเนินการลิงก์ C++ มาใช้ซ้ำสำหรับบรรทัดคำสั่งสำหรับการจัดทำดัชนี lto (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/6791)
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --[no]incompatible_remove_legacy_whole_archive: "true"
หากเป็นจริง Bazel จะไม่ลิงก์ทรัพยากร Dependency ของไลบรารีเป็นที่เก็บถาวรทั้งหมดโดยค่าเริ่มต้น (ดูวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/7362)
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --[no]incompatible_require_ctx_in_configure_features: "true"
หากเป็นจริง Bazel จะต้องใช้ "ctx" ใน cc_common.configure_features (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/7793)
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --[no]interface_shared_objects: "true"
ใช้ออบเจ็กต์ที่ใช้ร่วมกันของอินเทอร์เฟซ หาก Toolchain รองรับ เครื่องมือเชน ELF ทั้งหมดรองรับการตั้งค่านี้ในขณะนี้
แท็ก: loading_and_analysis, affects_outputs, affects_outputs
ค่าเริ่มต้น --ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ดูคำอธิบาย
ระบุเวอร์ชันของ iOS SDK ที่จะใช้สร้างแอปพลิเคชัน iOS หากไม่ระบุ ระบบจะใช้เวอร์ชันเริ่มต้นของ iOS SDK จาก "xcode_version"
แท็ก: loses_incremental_state
ค่าเริ่มต้น --macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ดูคำอธิบาย
ระบุเวอร์ชันของ macOS SDK ที่จะใช้สร้างแอปพลิเคชัน macOS หากไม่ระบุ ระบบจะใช้เวอร์ชันเริ่มต้นของ macOS SDK จาก "xcode_version"
แท็ก: loses_incremental_state
ค่าเริ่มต้น --minimum_os_version=<a string>: ดูคำอธิบาย
เวอร์ชันระบบปฏิบัติการขั้นต่ำที่การคอมไพล์กำหนดเป้าหมาย
แท็ก: loading_and_analysis affects_outputs
ค่าเริ่มต้นของ --platform_mappings=<a relative path>: ""
ตำแหน่งของไฟล์การแมปที่อธิบายแพลตฟอร์มที่จะใช้หากไม่ได้ตั้งค่าไว้ หรือแฟล็กที่จะตั้งค่าเมื่อมีแพลตฟอร์มอยู่แล้ว ต้องสัมพัทธ์กับรูทของพื้นที่ทำงานหลัก มีค่าเริ่มต้นเป็น "platform_mappings" (ไฟล์ที่อยู่ภายใต้รูทของพื้นที่ทำงานโดยตรง)
แท็ก: affects_outputs, changes_inputs, loading_and_analysis
ค่าเริ่มต้นของ --platforms=<a build target label>: ""
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายแพลตฟอร์มเป้าหมายสำหรับคำสั่งปัจจุบัน
แท็ก: affects_outputs, changes_inputs, loading_and_analysis
ค่าเริ่มต้น --python2_path=<a string>: ดูคำอธิบาย
เลิกใช้งานแล้ว ไม่มีการดำเนินการ ปิดใช้โดย "--incompatible_use_python_toolchains"
แท็ก: no_op, deprecated
ค่าเริ่มต้น --python3_path=<a string>: ดูคำอธิบาย
เลิกใช้งานแล้ว ไม่มีการดำเนินการ ปิดใช้โดย "--incompatible_use_python_toolchains"
แท็ก: no_op, deprecated
ค่าเริ่มต้น --python_path=<a string>: ดูคำอธิบาย
Absolute Path ของล่าม Python มีการเรียกใช้เป้าหมาย Python บนแพลตฟอร์มเป้าหมาย เลิกใช้งาน; ปิดใช้งานโดย --incompatible_use_python_toolchains
แท็ก: loading_and_analysis affects_outputs
ค่าเริ่มต้น --python_top=<a build target label>: ดูคำอธิบาย
ป้ายกำกับของ py_runtime ที่แทนอินเทอร์พรีเตอร์ Python ได้มีการเรียกให้เรียกใช้เป้าหมาย Python บนแพลตฟอร์มเป้าหมาย เลิกใช้งาน; ปิดใช้งานโดย --incompatible_use_python_toolchains
แท็ก: loading_and_analysis affects_outputs
ค่าเริ่มต้น --tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ดูคำอธิบาย
ระบุเวอร์ชันของ tvOS SDK ที่จะใช้สร้างแอปพลิเคชัน tvOS หากไม่ระบุ ระบบจะใช้เวอร์ชันเริ่มต้นของ tvOS SDK จาก "xcode_version"
แท็ก: loses_incremental_state
ค่าเริ่มต้น --watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ดูคำอธิบาย
ระบุเวอร์ชันของ WatchOS SDK ที่จะใช้สร้างแอปพลิเคชัน watchOS หากไม่ระบุ ระบบจะใช้เวอร์ชัน WatchOS SDK เริ่มต้นจาก "xcode_version"
แท็ก: loses_incremental_state
ค่าเริ่มต้น --xcode_version=<a string>: ดูคำอธิบาย
หากระบุไว้ ให้ใช้ Xcode ของเวอร์ชันที่ระบุสำหรับการดำเนินการของบิลด์ที่เกี่ยวข้อง หากไม่ระบุ ระบบจะใช้ Xcode เวอร์ชันเริ่มต้นของผู้ดำเนินการ
แท็ก: loses_incremental_state
--xcode_version_config=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/cpp:host_xcodes"
ป้ายกำกับของกฎ xcode_config ที่จะใช้สำหรับเลือกเวอร์ชัน Xcode ในการกำหนดค่าบิลด์
แท็ก: loses_incremental_state loading_and_analysis
ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่ง
มีดังนี้
ค่าเริ่มต้น --[no]apple_generate_dsym: "เท็จ"
เลือกว่าจะสร้างไฟล์สัญลักษณ์การแก้ไขข้อบกพร่อง (.dSYM) หรือไม่
แท็ก: affects_outputs action_command_lines
ค่าเริ่มต้น --[no]build: "true"
ดำเนินการสร้าง นี่เป็นลักษณะการทำงานปกติ การระบุ --nobuild จะทำให้บิลด์หยุดทำงานก่อนที่จะดำเนินการของบิลด์ ซึ่งแสดงผลเป็น 0 หากขั้นตอนการโหลดแพ็กเกจและการวิเคราะห์เสร็จสมบูรณ์ โหมดนี้มีประโยชน์ในการทดสอบระยะเหล่านั้น
แท็ก: execution affects_outputs
หากเป็น "จริง" ให้สร้างศูนย์การเรียกใช้ไฟล์ symlink สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้เขียนเมื่อต้องใช้การดำเนินการในเครื่อง ทดสอบ หรือเรียกใช้คำสั่งเท่านั้น
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]build_runfile_manifests: "true"
หากเป็น "จริง" ให้เขียนไฟล์ Manifest ของการเรียกใช้ไฟล์สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้ละเว้น การทดสอบในเครื่องจะทํางานไม่ได้หากเป็นเท็จ
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]build_test_dwp: "เท็จ"
หากเปิดใช้ เมื่อสร้างการทดสอบ C++ แบบคงที่ และด้วยฟิชชัน ไฟล์ .dwp สำหรับไบนารีการทดสอบจะสร้างขึ้นโดยอัตโนมัติเช่นกัน
แท็ก: loading_and_analysis affects_outputs
ค่าเริ่มต้นของ --cc_proto_library_header_suffixes=<comma-separated set of options>: ".pb.h"
ตั้งค่าคำต่อท้ายของไฟล์ส่วนหัวที่ cc_proto_library สร้างขึ้น
แท็ก: affects_outputs loading_and_analysis
ค่าเริ่มต้น --cc_proto_library_source_suffixes=<comma-separated set of options>: ".pb.cc"
ตั้งค่าคำต่อท้ายของไฟล์ต้นฉบับที่ cc_protocol_library สร้างขึ้น
แท็ก: affects_outputs loading_and_analysis
ค่าเริ่มต้น --[no]experimental_proto_descriptor_sets_include_source_info: "เท็จ"
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันอื่นๆ ใน protocol_library
แท็ก: affects_outputs, loading_and_analysis, experimental
ค่าเริ่มต้น --[no]experimental_proto_extra_actions: "เท็จ"
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันอื่นๆ ใน protocol_library
แท็ก: affects_outputs, loading_and_analysis, experimental
ค่าเริ่มต้น --[no]experimental_save_feature_state: "เท็จ"
บันทึกสถานะของฟีเจอร์ที่เปิดใช้และที่ขอเป็นเอาต์พุตของการคอมไพล์
แท็ก: affects_outputs experimental
ค่าเริ่มต้น --[no]experimental_use_validation_aspect: "เท็จ"
เลือกว่าจะเรียกใช้การตรวจสอบโดยใช้มุมมอง (สำหรับการทำงานพร้อมกันกับการทดสอบ) หรือไม่
แท็ก: execution affects_outputs
ค่าเริ่มต้น --fission=<a set of compilation modes>: "ไม่"
ระบุโหมดการคอมไพล์ที่ใช้ฟิชชันสําหรับการคอมไพล์และลิงก์ C++ อาจเป็นชุดค่าผสมใดๆ ของ {'fastbuild', 'dbg', 'opt'} หรือค่าพิเศษ 'yes' เพื่อเปิดทุกโหมดและ "ไม่" เพื่อปิดใช้โหมดทั้งหมด
แท็ก: loading_and_analysis, action_command_lines, affects_outputs
ค่าเริ่มต้น --[no]incompatible_always_include_files_in_data: "true"
หากเป็นจริง กฎของระบบจะเพิ่ม <code>DefaultInfo.files</code> ของทรัพยากร Dependency ไปยังไฟล์รันไทม์ ซึ่งตรงกับลักษณะการทำงานที่แนะนำสำหรับกฎของ Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid)
แท็ก: affects_outputs incompatible_change
ค่าเริ่มต้น --[no]legacy_external_runfiles: "true"
หากเป็น "จริง" ให้สร้างฟอเรสต์ Runfiles symlink สำหรับที่เก็บภายนอกภายใต้ .runfiles/wsname/external/repo (นอกเหนือจาก .runfiles/repo)
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]objc_generate_linkmap: "เท็จ"
ระบุว่าจะสร้างไฟล์ linkmap หรือไม่
แท็ก: affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --output_groups=<comma-separated list of options> รายการ
รายการของชื่อกลุ่มเอาต์พุตที่คั่นด้วยคอมมา ซึ่งแต่ละรายการอาจนำหน้าด้วยเครื่องหมาย + หรือ - ระบบจะเพิ่มกลุ่มที่ขึ้นต้นด้วย + ลงในชุดกลุ่มเอาต์พุตเริ่มต้น ส่วนกลุ่มที่ขึ้นต้นด้วย - จะถูกนำออกจากชุดเริ่มต้น หากมีอย่างน้อย 1 กลุ่มที่ไม่มีคำนำหน้า ระบบจะละเว้นชุดกลุ่มเอาต์พุตเริ่มต้น ตัวอย่างเช่น --output_groups=+foo,+bar จะสร้างการรวมของชุดเริ่มต้น ได้แก่ foo และ bar ในขณะที่ --output_groups=foo,bar จะลบล้างชุดเริ่มต้นที่สร้างเฉพาะ foo และ bar
แท็ก: execution affects_outputs
ค่าเริ่มต้น --[no]run_validations: "true"
ระบุว่าจะเรียกใช้การดำเนินการตรวจสอบเป็นส่วนหนึ่งของบิลด์หรือไม่ โปรดดู https://bazel.build/extending/rules#Validation_actions
แท็ก: execution affects_outputs
ค่าเริ่มต้น --[no]save_temps: "เท็จ"
หากตั้งค่าไว้ ระบบจะบันทึกเอาต์พุตชั่วคราวจาก gcc ไฟล์เหล่านี้รวมถึงไฟล์ .s (โค้ด Ascyclr), ไฟล์ .i (C ที่ประมวลผลล่วงหน้า) และ .ii (C++ ที่ประมวลผลล่วงหน้า)
แท็ก: affects_outputs
ตัวเลือกที่ให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการได้ โดยให้ส่งผลต่อค่าของเอาต์พุตแทนค่าที่มีอยู่
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --action_env=<a 'name=value' assignment with an optional value part> รายการ
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกำหนดค่าเป้าหมาย คุณระบุตัวแปรได้ด้วยชื่อ ซึ่งในกรณีนี้ระบบจะนําค่าจากสภาพแวดล้อมการเรียกใช้ หรือคู่ name=value ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ ตัวเลือกนี้ใช้ได้หลายครั้ง สำหรับตัวเลือกที่ระบุสำหรับตัวแปรเดียวกัน ค่าที่ชนะล่าสุด และตัวเลือกของตัวแปรต่างๆ จะสะสมอยู่
แท็ก: action_command_lines
ค่าเริ่มต้นของ --android_cpu=<a string>: "armeabi-v7a"
CPU เป้าหมายของ Android
แท็ก: affects_outputs, loading_and_analysis, loses_incremental_state
ค่าเริ่มต้น --[no]android_databinding_use_androidx: "true"
สร้างไฟล์การเชื่อมโยงข้อมูลที่ใช้กับ AndroidX ได้ ใช้ได้เฉพาะกับการเชื่อมโยงข้อมูล v2 เท่านั้น แฟล็กนี้ไม่มีการใช้งาน
แท็ก: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
ค่าเริ่มต้น --[no]android_databinding_use_v3_4_args: "true"
ใช้ Android Databinding v2 ที่มีอาร์กิวเมนต์ 3.4.0 แฟล็กนี้ไม่มีการใช้งาน
แท็ก: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
ค่าเริ่มต้นของ --android_dynamic_mode=<off, default or fully>: "ปิด"
กำหนดว่าจะให้ลิงก์ C++ ของกฎ Android แบบไดนามิกหรือไม่ เมื่อ cc_binary ไม่ได้สร้างไลบรารีที่ใช้ร่วมกันอย่างชัดแจ้ง "ค่าเริ่มต้น" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "สมบูรณ์" หมายความว่าไลบรารีทั้งหมดจะลิงก์แบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก: affects_outputs loading_and_analysis
ค่าเริ่มต้น --android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>: "ตามตัวอักษร"
ตั้งค่าลำดับของไฟล์ Manifest ที่ส่งไปยังการรวมไฟล์ Manifest สำหรับไบนารีของ Android อัลฟ่าหมายความว่าไฟล์ Manifest ได้รับการจัดเรียงตามเส้นทางที่สัมพันธ์กับผู้ดำเนินการ ALPHABETICAL_BY_CONFIGURATION หมายความว่าไฟล์ Manifest ได้รับการจัดเรียงตามเส้นทางที่สัมพันธ์กับไดเรกทอรีการกำหนดค่าภายในไดเรกทอรีเอาต์พุต DEPENDENCY หมายความว่าไฟล์ Manifest จะเรียงลำดับตามไฟล์ Manifest ของไลบรารีแต่ละรายการที่อยู่ก่อนไฟล์ Manifest ของทรัพยากร Dependency
แท็ก: action_command_lines execution
ค่าเริ่มต้น --[no]android_resource_shrinking: "เท็จ"
เปิดใช้การย่อทรัพยากรสำหรับ APK android_binary ที่ใช้ ProGuard
แท็ก: affects_outputs loading_and_analysis
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --aspects=<comma-separated list of options> รายการ
รายการด้านที่คั่นด้วยจุลภาคที่จะนำไปใช้กับเป้าหมายระดับบนสุด ในรายการนี้ หากลักษณะ some_aspect ระบุผู้ให้บริการด้านที่จำเป็นผ่าน required_aspect_providers นั้น some_aspect จะทำงานหลังจากทุกด้านที่พูดถึงก่อนหน้าในรายการด้านที่ผู้ให้บริการด้านโฆษณาตอบสนองผู้ให้บริการด้านบางด้านที่จำเป็น นอกจากนี้ some_aspect จะทำงานหลังจากด้านที่ต้องระบุทั้งหมดที่ระบุไว้โดย required [แอตทริบิวต์] จากนั้น some_aspect จะมีสิทธิ์เข้าถึงคุณค่าของแง่มุมเหล่านั้น ผู้ให้บริการเครือข่าย <bzl-file-label>%<aspect_name> เช่น '//tools:my_def.bzl%my_aspect' โดยที่ 'my_aspect' เป็นค่าระดับบนสุดจากเครื่องมือไฟล์/my_def.bzl
ค่าเริ่มต้น --[no]build_python_zip: "อัตโนมัติ"
สร้าง ZIP ที่เป็นไฟล์ปฏิบัติการ Python ใน Windows และปิดบนแพลตฟอร์มอื่น
แท็ก: affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --catalyst_cpus=<comma-separated list of options> รายการ
รายชื่อสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple Catalyst
แท็ก: loses_incremental_state loading_and_analysis
ค่าเริ่มต้น --[no]collect_code_coverage: "เท็จ"
หากระบุไว้ Bazel จะใช้โค้ดเครื่องมือวัด (โดยใช้การใช้เครื่องมือแบบออฟไลน์หากเป็นไปได้) และจะรวบรวมข้อมูลการครอบคลุมระหว่างการทดสอบ เฉพาะเป้าหมายที่ตรงกับ --instrumentation_filter จะได้รับผลกระทบ โดยปกติ ตัวเลือกนี้ไม่ควรระบุโดยตรง - "ความครอบคลุมของbazel" ควรใช้คำสั่งแทน
แท็ก: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] ค่าเริ่มต้น: "fastbuild"
ระบุโหมดที่จะมีการสร้างไบนารี ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก: affects_outputs action_command_lines
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --conlyopt=<a string> รายการ
ตัวเลือกเพิ่มเติมสำหรับส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C
แท็ก: action_command_lines affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --copt=<a string> รายการ
ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง gcc
แท็ก: action_command_lines affects_outputs
ค่าเริ่มต้นของ --cpu=<a string>: ""
CPU เป้าหมาย
แท็ก: changes_inputs affects_outputs
ค่าเริ่มต้น --cs_fdo_absolute_path=<a string>: ดูคำอธิบาย
ใช้ข้อมูลโปรไฟล์ CSFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อเส้นทางสัมบูรณ์ของไฟล์ ZIP ที่มีไฟล์โปรไฟล์, ไฟล์ข้อมูล RAW หรือไฟล์โปรไฟล์ LLVM ที่จัดทำดัชนีไว้
แท็ก: affects_outputs
ค่าเริ่มต้น --cs_fdo_instrument=<a string>: ดูคำอธิบาย
สร้างไบนารีด้วยเครื่องมือ FDO ที่ละเอียดอ่อนตามบริบท เมื่อใช้คอมไพเลอร์ Clang/LLVM คีย์ดังกล่าวจะยอมรับชื่อไดเรกทอรีที่ระบบจะส่งออกไฟล์โปรไฟล์แบบ RAW ขณะรันไทม์ด้วย
แท็ก: affects_outputs
ค่าเริ่มต้น --cs_fdo_profile=<a build target label>: ดูคำอธิบาย
cs_fdo_profile แสดงถึงโปรไฟล์ที่ละเอียดอ่อนตามบริบทที่จะใช้ในการเพิ่มประสิทธิภาพ
แท็ก: affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --cxxopt=<a string> รายการ
ตัวเลือกเพิ่มเติมสำหรับส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C++
แท็ก: action_command_lines affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --define=<a 'name=value' assignment> รายการ
ตัวเลือก --define แต่ละรายการจะระบุการมอบหมายสำหรับตัวแปรบิลด์
แท็ก: changes_inputs affects_outputs
ค่าเริ่มต้น --dynamic_mode=<off, default or fully>: "ค่าเริ่มต้น"
กำหนดว่าจะลิงก์ไบนารีของ C++ แบบไดนามิกหรือไม่ "ค่าเริ่มต้น" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "สมบูรณ์" หมายความว่าไลบรารีทั้งหมดจะลิงก์แบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก: loading_and_analysis affects_outputs
ค่าเริ่มต้น --[no]enable_fdo_profile_absolute_path: "true"
หากตั้งค่าไว้ การใช้ fdo_absolute_profile_path จะทำให้เกิดข้อผิดพลาด
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]enable_runfiles: "อัตโนมัติ"
เปิดใช้โครงสร้างลิงก์สัญลักษณ์ของ Runfiles ซึ่งโดยค่าเริ่มต้น จะปิดอยู่ใน Windows และในแพลตฟอร์มอื่นๆ
แท็ก: affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --experimental_action_listener=<a build target label> รายการ
เลิกใช้งานไปทีละด้าน ใช้ action_listener เพื่อแนบทางลัดไปยังการดำเนินการบิลด์ที่มีอยู่
แท็ก: execution experimental
ค่าเริ่มต้น --[no]experimental_android_compress_java_resources: "เท็จ"
บีบอัดทรัพยากร Java ใน APK
แท็ก: affects_outputs, loading_and_analysis, experimental
ค่าเริ่มต้น --[no]experimental_android_databinding_v2: "true"
ใช้ Android Data Binding v2 แฟล็กนี้ไม่มีการใช้งาน
แท็ก: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
ค่าเริ่มต้น --[no]experimental_android_resource_shrinking: "เท็จ"
เปิดใช้การย่อทรัพยากรสำหรับ APK android_binary ที่ใช้ ProGuard
แท็ก: affects_outputs loading_and_analysis
ค่าเริ่มต้น --[no]experimental_android_rewrite_dexes_with_rex: "เท็จ"
ใช้เครื่องมือ Rex เพื่อเขียนไฟล์ dex ใหม่
แท็ก: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
ค่าเริ่มต้น --[no]experimental_collect_code_coverage_for_generated_files: "เท็จ"
หากระบุไว้ Bazel จะสร้างการรวบรวมข้อมูลที่ครอบคลุมสำหรับไฟล์ที่สร้างขึ้นด้วย
แท็ก: affects_outputs
แฟล็กนี้ควบคุมวิธีจัดการลิงก์สัญลักษณ์ตามความสะดวก (ลิงก์สัญลักษณ์ที่ปรากฏในพื้นที่ทำงานหลังบิลด์) ค่าที่เป็นไปได้มีดังนี้ ปกติ (ค่าเริ่มต้น): ระบบจะสร้างหรือลบลิงก์สัญลักษณ์เพื่อความสะดวกแต่ละประเภทตามที่กำหนดโดยบิลด์ สะอาด: ลิงก์สัญลักษณ์ทั้งหมดจะถูกลบโดยไม่มีเงื่อนไข เพิกเฉย: สัญลักษณ์ลิงก์จะไม่ปรากฏเพียงอย่างเดียว log_only: สร้างข้อความบันทึกเสมือนเป็น "ปกติ" ผ่าน แต่ไม่ได้ดำเนินการเกี่ยวกับระบบไฟล์จริงๆ (มีประโยชน์สำหรับเครื่องมือ) โปรดทราบว่าเฉพาะลิงก์สัญลักษณ์ที่มีชื่อที่สร้างขึ้นด้วยค่าปัจจุบันของ --symlink_prefix เท่านั้นที่อาจได้รับผลกระทบ หากคำนำหน้าเปลี่ยนไป ลิงก์สัญลักษณ์ที่มีอยู่แล้วก็จะถูกปล่อยไว้ตามเดิม
แท็ก: affects_outputs
แฟล็กนี้ควบคุมว่าเราจะโพสต์เหตุการณ์บิลด์ConvenienceSymlinksIdentified ไปยัง BuildEventProtocol หรือไม่ หากค่าเป็น "จริง" BuildEventProtocol จะมีรายการ ConvesSymlinksIdentified ที่มีรายการลิงก์สัญลักษณ์แบบอำนวยความสะดวกทั้งหมดที่สร้างในพื้นที่ทำงานของคุณ หากเป็น "เท็จ" รายการ meetSymlinksIdentified ใน BuildEventProtocol จะว่างเปล่า
แท็ก: affects_outputs
ค่าเริ่มต้น --experimental_objc_fastbuild_options=<comma-separated list of options>: "-O0,-DDEBUG=1"
ใช้สตริงเหล่านี้เป็นตัวเลือกคอมไพเลอร์ objc Fastbuild
แท็ก: action_command_lines
ค่าเริ่มต้น --[no]experimental_omitfp: "เท็จ"
หากเป็น "จริง" ให้ใช้ libunwind สำหรับการคลายสแต็ก แล้วคอมไพล์ด้วย -fomit-frame-pointer และ -fasynchronous-unwind-tables
แท็ก: action_command_lines, affects_outputs, experimental
ค่าเริ่มต้นของ --experimental_output_paths=<off, content or strip>: "ปิด"
โมเดลที่ควรใช้สำหรับส่วนใดในกฎแผนผังเอาต์พุตจะเขียนเอาต์พุต โดยเฉพาะอย่างยิ่งสำหรับบิลด์ที่มีหลายแพลตฟอร์ม / หลายการกำหนดค่า ฟีเจอร์นี้อยู่ในขั้นทดลอง ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/6526 การดำเนินการของ Starlark เลือกใช้การแมปเส้นทางได้ด้วยการเพิ่มคีย์ "supports-path-mapping" เป็น "execution_requirements" พิมพ์ตามคำบอก
แท็ก: loses_incremental_state, bazel_internal_configuration, affects_outputs, execution
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --experimental_override_name_platform_in_output_dir=<a 'label=value' assignment> รายการ
แต่ละรายการควรอยู่ในรูปแบบ label=value โดยที่ป้ายกำกับอ้างอิงถึงแพลตฟอร์ม และค่าคือชื่อย่อที่ต้องการใช้ในเส้นทางเอาต์พุต ใช้เมื่อ --experimental_platform_in_output_dir เป็นจริงเท่านั้น มีลำดับความสำคัญในการตั้งชื่อสูงสุด
แท็ก: affects_outputs experimental
ค่าเริ่มต้น --[no]experimental_platform_in_output_dir: "เท็จ"
หากเป็นจริง ระบบจะใช้ชื่อย่อของแพลตฟอร์มเป้าหมายในชื่อไดเรกทอรีเอาต์พุตแทน CPU รูปแบบที่แน่นอนอยู่ในขั้นทดลองและอาจมีการเปลี่ยนแปลง อย่างแรก ในกรณีซึ่งเกิดขึ้นไม่บ่อยนัก ตัวเลือก --platforms ไม่ได้มีค่าเพียงค่าเดียว ระบบจะใช้แฮชของตัวเลือกแพลตฟอร์ม ถัดไป หากชื่อย่อของแพลตฟอร์มปัจจุบันลงทะเบียนโดย --experimental_override_name_platform_in_output_dir ระบบจะใช้ชื่อย่อนั้น จากนั้น หากมีการตั้งค่า --experimental_use_platforms_in_output_dir_legacy_heurism ให้ใช้ชื่อย่อที่อ้างอิงจากป้ายกำกับแพลตฟอร์มปัจจุบัน สุดท้าย ระบบจะใช้แฮชของตัวเลือกแพลตฟอร์มเป็นทางเลือกสุดท้าย
แท็ก: affects_outputs experimental
ค่าเริ่มต้น --[no]experimental_use_llvm_covmap: "เท็จ"
หากระบุ Bazel จะสร้างข้อมูลแผนที่ความครอบคลุมของ llvm-cov แทนที่จะเป็น gcov เมื่อเปิดใช้งานcollect_code_coverage
แท็ก: changes_inputs, affects_outputs, loading_and_analysis, experimental
ค่าเริ่มต้น --[no]experimental_use_platforms_in_output_dir_legacy_heuristic: "true"
โปรดใช้แฟล็กนี้เป็นส่วนหนึ่งของกลยุทธ์การย้ายข้อมูลหรือการทดสอบที่แนะนำเท่านั้น โปรดทราบว่าการเรียนรู้มีข้อบกพร่องที่ทราบแล้ว และแนะนำให้เปลี่ยนไปใช้เพียง --experimental_override_name_platform_in_output_dir
แท็ก: affects_outputs experimental
ค่าเริ่มต้นของ --fat_apk_cpu=<comma-separated set of options>: "armeabi-v7a"
การตั้งค่าตัวเลือกนี้จะเปิดใช้ APK แบบอ้วน ซึ่งมีไบนารีแบบเนทีฟสำหรับสถาปัตยกรรมเป้าหมายที่ระบุทั้งหมด เช่น --fat_apk_cpu=x86,armeabi-v7a. หากระบุแฟล็กนี้ ระบบจะละเว้น --android_cpu สำหรับทรัพยากร Dependency ของกฎ android_binary
แท็ก: affects_outputs, loading_and_analysis, loses_incremental_state
ค่าเริ่มต้น --[no]fat_apk_hwasan: "เท็จ"
เลือกว่าจะสร้างการแยก HWASAN หรือไม่
แท็ก: affects_outputs, loading_and_analysis, loses_incremental_state
ค่าเริ่มต้น --fdo_instrument=<a string>: ดูคำอธิบาย
สร้างไบนารีด้วยเครื่องมือ FDO เมื่อใช้คอมไพเลอร์ Clang/LLVM คีย์ดังกล่าวจะยอมรับชื่อไดเรกทอรีที่ระบบจะส่งออกไฟล์โปรไฟล์แบบ RAW ขณะรันไทม์ด้วย
แท็ก: affects_outputs
ค่าเริ่มต้น --fdo_optimize=<a string>: ดูคำอธิบาย
ใช้ข้อมูลโปรไฟล์ FDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อไฟล์ ZIP ที่มีแผนผังไฟล์ .gcda, ไฟล์ afdo ที่มีโปรไฟล์อัตโนมัติ หรือไฟล์โปรไฟล์ LLVM แฟล็กนี้ยอมรับไฟล์ที่ระบุเป็นป้ายกำกับด้วย (เช่น "//foo/bar:file.afdo" คุณอาจต้องเพิ่มคำสั่ง "exports_files" ไปยังแพ็กเกจที่เกี่ยวข้อง) และป้ายกำกับที่ชี้ไปยังเป้าหมาย "fdo_profile" การตั้งค่าสถานะนี้จะถูกแทนที่โดยกฎ "fdo_profile"
แท็ก: affects_outputs
ค่าเริ่มต้น --fdo_prefetch_hints=<a build target label>: ดูคำอธิบาย
ใช้คำแนะนำการดึงข้อมูลแคชล่วงหน้า
แท็ก: affects_outputs
ค่าเริ่มต้น --fdo_profile=<a build target label>: ดูคำอธิบาย
fdo_profile แทนโปรไฟล์ที่จะใช้ในการเพิ่มประสิทธิภาพ
แท็ก: affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --features=<a string> รายการ
ระบบจะเปิดใช้หรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างขึ้นในการกำหนดค่าเป้าหมาย กำลังระบุ -<feature> จะปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ ดูเพิ่มเติมที่ --host_features
แท็ก: changes_inputs affects_outputs
ค่าเริ่มต้น --[no]force_pic: "เท็จ"
หากเปิดใช้งาน การคอมไพล์ C++ ทั้งหมดจะสร้างโค้ดที่ไม่ขึ้นอยู่กับตำแหน่ง ("-fPIC") ลิงก์จะใช้ไลบรารีที่สร้างไว้ล่วงหน้าของ PIC มากกว่าไลบรารีที่ไม่ใช่ PIC และลิงก์จะสร้างไฟล์ปฏิบัติการที่ไม่ขึ้นอยู่กับตำแหน่ง ("-pie")
แท็ก: loading_and_analysis affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --host_action_env=<a 'name=value' assignment with an optional value part> รายการ
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกำหนดค่าการดำเนินการ คุณระบุตัวแปรได้ด้วยชื่อ ซึ่งในกรณีนี้ระบบจะนําค่าจากสภาพแวดล้อมการเรียกใช้ หรือคู่ name=value ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ ตัวเลือกนี้ใช้ได้หลายครั้ง สำหรับตัวเลือกที่ระบุสำหรับตัวแปรเดียวกัน ค่าที่ชนะล่าสุด และตัวเลือกของตัวแปรต่างๆ จะสะสมอยู่
แท็ก: action_command_lines
ค่าเริ่มต้นของ --host_compilation_mode=<fastbuild, dbg or opt>: "opt"
ระบุโหมดที่จะมีการสร้างเครื่องมือที่ใช้ในการสร้าง ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก: affects_outputs action_command_lines
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --host_conlyopt=<a string> รายการ
ตัวเลือกเพิ่มเติมในการส่งไปยังคอมไพเลอร์ C เมื่อคอมไพล์ไฟล์ต้นฉบับ C (ไม่ใช่ C++) ในการกำหนดค่าผู้บริหาร
แท็ก: action_command_lines affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --host_copt=<a string> รายการ
ตัวเลือกเพิ่มเติมเพื่อส่งไปยังคอมไพเลอร์ C สำหรับเครื่องมือที่สร้างขึ้นในการกำหนดค่าการดำเนินการ
แท็ก: action_command_lines affects_outputs
ค่าเริ่มต้นของ --host_cpu=<a string>: ""
CPU ของโฮสต์
แท็ก: changes_inputs affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --host_cxxopt=<a string> รายการ
ตัวเลือกเพิ่มเติมเพื่อส่งไปยังคอมไพเลอร์ C++ สำหรับเครื่องมือที่สร้างขึ้นในการกำหนดค่าดำเนินการ
แท็ก: action_command_lines affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --host_features=<a string> รายการ
ระบบจะเปิดใช้หรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างขึ้นในการกำหนดค่า exec กำลังระบุ -<feature> จะปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ
แท็ก: changes_inputs affects_outputs
ค่าเริ่มต้น --host_force_python=<PY2 or PY3>: ดูคำอธิบาย
ลบล้างเวอร์ชัน Python สำหรับการกำหนดค่า exec อาจเป็น "PY2" หรือ "PY3"
แท็ก: loading_and_analysis affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --host_linkopt=<a string> รายการ
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง Linker เมื่อลิงก์เครื่องมือในการกำหนดค่าการดำเนินการ
แท็ก: action_command_lines affects_outputs
ค่าเริ่มต้น --host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ดูคำอธิบาย
เวอร์ชัน macOS ที่เข้ากันได้ขั้นต่ำสำหรับเป้าหมายโฮสต์ หากไม่ได้ระบุ ให้ใช้ "macos_sdk_version"
แท็ก: loses_incremental_state
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options> รายการ
ตัวเลือกเพิ่มเติมเพื่อเลือกส่งไปยังคอมไพเลอร์ C/C++ ที่เลือกเมื่อคอมไพล์ไฟล์บางไฟล์ในการกำหนดค่าผู้บริหาร ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจากรายการรวมและไม่รวมรูปแบบนิพจน์ทั่วไป (ดู --instrumentation_filter) ด้วย Option_1 กับ Option_n นั้นย่อมาจากตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ ในการแยกสตริงจะใช้เฉพาะ @ แรกเท่านั้น ตัวอย่าง: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก: action_command_lines affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --host_swiftcopt=<a string> รายการ
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง Swiftc สำหรับเครื่องมือผู้บริหาร
แท็ก: action_command_lines affects_outputs
ค่าเริ่มต้น --[no]incompatible_auto_exec_groups: "เท็จ"
เมื่อเปิดใช้ ระบบจะสร้างกลุ่มผู้บริหารสำหรับ Toolchain แต่ละรายการที่กฎใช้โดยอัตโนมัติ กฎในการทำงานนี้ต้องระบุพารามิเตอร์ "toolchain" ในการดำเนินการ ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/17134
แท็ก: affects_outputs incompatible_change
ค่าเริ่มต้น --[no]incompatible_merge_genfiles_directory: "true"
หากเป็นจริง ไดเรกทอรี genfiles จะถูกพับลงในไดเรกทอรี bin
แท็ก: affects_outputs incompatible_change
ค่าเริ่มต้น --[no]incompatible_use_host_features: "true"
หากเป็นจริง ให้ใช้ --features สำหรับการกำหนดค่าเป้าหมายเท่านั้น และ --host_features สำหรับการกำหนดค่า exec
แท็ก: changes_inputs, affects_outputs, incompatible_change
ค่าเริ่มต้น --[no]instrument_test_targets: "เท็จ"
เมื่อเปิดใช้การครอบคลุม ให้ระบุว่าจะพิจารณาการใช้กฎการทดสอบการวัดคุมหรือไม่ เมื่อตั้งค่าแล้ว กฎการทดสอบที่ --instrumentation_filter รวมอยู่จะมีการวัดคุม มิฉะนั้น กฎการทดสอบจะถูกยกเว้นจากการวัดคุมการครอบคลุมเสมอ
แท็ก: affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> ค่าเริ่มต้น: "-/javatests[/:],-/test/java[/:]"
เมื่อเปิดใช้การครอบคลุม ระบบจะวัดเฉพาะกฎที่มีชื่อซึ่งตัวกรองตามนิพจน์ทั่วไปที่ระบุรวมอยู่เท่านั้น กฎที่ขึ้นต้นด้วย "-" จะได้รับการยกเว้นแทน โปรดทราบว่าระบบจะวัดคุมเฉพาะกฎที่ไม่ใช่การทดสอบเท่านั้น ยกเว้นกรณีที่เปิดใช้งาน --instrument_test_targets
แท็ก: affects_outputs
ค่าเริ่มต้น --ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ดูคำอธิบาย
เวอร์ชัน iOS ที่เข้ากันได้ขั้นต่ำสำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ระบุ ให้ใช้ "ios_sdk_version"
แท็ก: loses_incremental_state
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --ios_multi_cpus=<comma-separated list of options> รายการ
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างแอปพลิเคชัน ios_ ผลลัพธ์จะเป็นไบนารีสากลที่มีสถาปัตยกรรมที่ระบุทั้งหมด
แท็ก: loses_incremental_state loading_and_analysis
ค่าเริ่มต้น --[no]legacy_whole_archive: "true"
เลิกใช้งานแล้ว และมีผลแทนด้วย --inสามารถเข้าถึง_remove_legacy_whole_archive (ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7362) เมื่อเปิด ให้ใช้ --whole-archive สำหรับกฎ cc_binary ที่มี linkshared=True และ linkstatic=True หรือ '-static' ใน Linkopts วิธีนี้ใช้สำหรับความเข้ากันได้แบบย้อนหลังเท่านั้น อีกทางเลือกหนึ่งที่ดีกว่าคือการใช้ Alwayslink=1 เมื่อจำเป็น
แท็ก: action_command_lines, affects_outputs, deprecated
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --linkopt=<a string> รายการ
ตัวเลือกเพิ่มเติมในการส่งไปยัง gcc เมื่อลิงก์
แท็ก: action_command_lines affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --ltobackendopt=<a string> รายการ
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังขั้นตอนแบ็กเอนด์ของ LTO (ในส่วน --features=thin_lto)
แท็ก: action_command_lines affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --ltoindexopt=<a string> รายการ
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังขั้นตอนการจัดทำดัชนี LTO (ในส่วน --features=thin_lto)
แท็ก: action_command_lines affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --macos_cpus=<comma-separated list of options> รายการ
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple macOS
แท็ก: loses_incremental_state loading_and_analysis
ค่าเริ่มต้น --macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ดูคำอธิบาย
เวอร์ชัน macOS ที่เข้ากันได้ขั้นต่ำสำหรับเป้าหมาย หากไม่ได้ระบุ ให้ใช้ "macos_sdk_version"
แท็ก: loses_incremental_state
ค่าเริ่มต้น --memprof_profile=<a build target label>: ดูคำอธิบาย
ใช้โปรไฟล์ Memprof
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]objc_debug_with_GLIBCXX: "เท็จ"
หากตั้งค่า และตั้งค่าโหมดการคอมไพล์เป็น "dbg" ให้กำหนด GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC และ GLIBCPP_CONCEPT_CHECKS
แท็ก: action_command_lines
ค่าเริ่มต้น --[no]objc_enable_binary_stripping: "เท็จ"
เลือกว่าจะดำเนินการลบสัญลักษณ์และโค้ดที่เสียหายในไบนารีที่ลิงก์หรือไม่ ระบบจะลบไบนารีหากระบุทั้ง Flag และ --compilation_mode=opt นี้
แท็ก: action_command_lines
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --objccopt=<a string> รายการ
ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ Objective-C/C++
แท็ก: action_command_lines
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options> รายการ
ตัวเลือกเพิ่มเติมในการส่งผ่านไปยัง gcc เฉพาะเมื่อคอมไพล์ไฟล์บางไฟล์ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจากรายการรวมและไม่รวมรูปแบบนิพจน์ทั่วไป (ดู --instrumentation_filter) ด้วย Option_1 กับ Option_n นั้นย่อมาจากตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ ในการแยกสตริงจะใช้เฉพาะ @ แรกเท่านั้น ตัวอย่าง: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก: action_command_lines affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options> รายการ
ตัวเลือกเพิ่มเติมสำหรับเลือกส่งไปยังแบ็กเอนด์ LTO (ในส่วน --features=thin_lto) เมื่อคอมไพล์ออบเจ็กต์แบ็กเอนด์บางรายการ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจาก รายการรูปแบบ รวมและยกเว้น ของนิพจน์ทั่วไป Option_1 กับ Option_n นั้นย่อมาจากตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ ในการแยกสตริงจะใช้เฉพาะ @ แรกเท่านั้น ตัวอย่าง: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่งแบ็กเอนด์ LTO ของไฟล์ o ทั้งหมดใน //foo/ ยกเว้น bar.o
แท็ก: action_command_lines affects_outputs
ค่าเริ่มต้น --platform_suffix=<a string>: ดูคำอธิบาย
ระบุคำต่อท้ายที่จะเพิ่มในไดเรกทอรีการกำหนดค่า
แท็ก: loses_incremental_state, affects_outputs, loading_and_analysis
ค่าเริ่มต้น --propeller_optimize=<a build target label>: ดูคำอธิบาย
ใช้ข้อมูลโปรไฟล์ Propeller เพื่อเพิ่มประสิทธิภาพเป้าหมายของบิลด์ โปรไฟล์ใบพัดต้องประกอบด้วยไฟล์อย่างน้อย 1 จาก 2 ไฟล์ โปรไฟล์สำเนา และโปรไฟล์ ld แฟล็กนี้ยอมรับป้ายกำกับบิลด์ซึ่งต้องอ้างถึงไฟล์อินพุตโปรไฟล์ใบพัด ตัวอย่างเช่น ไฟล์ BUILD ที่กำหนดป้ายกำกับใน a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)อาจต้องเพิ่มคำสั่ง ecommerce_files ลงในแพ็กเกจที่เกี่ยวข้องเพื่อให้ Bazel มองเห็นไฟล์เหล่านี้ ต้องใช้ตัวเลือกเป็น: --propeller_optimize=//a/b:propeller_profile
แท็ก: action_command_lines affects_outputs
ค่าเริ่มต้น --propeller_optimize_absolute_cc_profile=<a string>: ดูคำอธิบาย
ชื่อเส้นทางสัมบูรณ์ของไฟล์ cc_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพใบพัด
แท็ก: affects_outputs
ค่าเริ่มต้น --propeller_optimize_absolute_ld_profile=<a string>: ดูคำอธิบาย
ชื่อเส้นทางสัมบูรณ์ของไฟล์ ld_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพใบพัด
แท็ก: affects_outputs
ค่าเริ่มต้น --run_under=<a prefix in front of command>: ดูคำอธิบาย
คำนำหน้าที่จะแทรกก่อนไฟล์ปฏิบัติการสำหรับ "การทดสอบ" และ "เรียกใช้" คำสั่ง หากค่าคือ "foo -bar" และบรรทัดคำสั่งสำหรับการดำเนินการคือ "test_binary -baz" บรรทัดคำสั่งสุดท้ายคือ "foo -bar test_binary -baz" บรรทัดคำสั่งนี้อาจเป็นป้ายกำกับของเป้าหมายสั่งการได้ด้วย ตัวอย่างเช่น 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'
แท็ก: action_command_lines
ค่าเริ่มต้น --[no]share_native_deps: "true"
หากจริง ระบบจะแชร์ไลบรารีเนทีฟที่มีฟังก์ชันการทำงานเหมือนกันกับเป้าหมายต่างๆ
แท็ก: loading_and_analysis, affects_outputs
ค่าเริ่มต้น --[no]stamp: "เท็จ"
ประทับไบนารีด้วยวันที่ ชื่อผู้ใช้ ชื่อโฮสต์ ข้อมูลพื้นที่ทำงาน ฯลฯ
แท็ก: affects_outputs
ค่าเริ่มต้น --strip=<always, sometimes or never>: "บางครั้ง"
ระบุว่าจะตัดไบนารีและไลบรารีที่แชร์หรือไม่ (โดยใช้ "-Wl,--strip-debug") ค่าเริ่มต้นของ "บางครั้ง" หมายถึง Strip iff --compilation_mode=fastbuild
แท็ก: affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --stripopt=<a string> รายการ
ตัวเลือกเพิ่มเติมในการส่งไปยังการตัดเมื่อสร้าง "<name>.strped" 2.
แท็ก: action_command_lines affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --swiftcopt=<a string> รายการ
ตัวเลือกเพิ่มเติมเพื่อส่งไปยังการคอมไพล์ Swift
แท็ก: action_command_lines
คำนำหน้าที่เพิ่มด้านหน้าของลิงก์สัญลักษณ์แบบอำนวยความสะดวกที่สร้างขึ้นหลังบิลด์ หากไม่ระบุ ค่าเริ่มต้นจะเป็นชื่อของเครื่องมือสร้างตามด้วยขีดกลาง ถ้า '/' จะไม่มีการสร้างลิงก์สัญลักษณ์และไม่มีคำเตือน คำเตือน: ฟังก์ชันพิเศษสำหรับ "/" จะเลิกใช้งานเร็วๆ นี้ โปรดใช้ --experimental_convenience_symlinks=ignore แทน
แท็ก: affects_outputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --tvos_cpus=<comma-separated list of options> รายการ
รายชื่อสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple tvOS
แท็ก: loses_incremental_state loading_and_analysis
ค่าเริ่มต้น --tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ดูคำอธิบาย
เวอร์ชัน tvOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ระบุ ให้ใช้ "tvos_sdk_version"
แท็ก: loses_incremental_state
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --visionos_cpus=<comma-separated list of options> รายการ
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple visionOS
แท็ก: loses_incremental_state loading_and_analysis
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --watchos_cpus=<comma-separated list of options> รายการ
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple WatchOS
แท็ก: loses_incremental_state loading_and_analysis
ค่าเริ่มต้น --watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ดูคำอธิบาย
เวอร์ชัน WatchOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ได้ระบุ ให้ใช้ "watchos_sdk_version"
แท็ก: loses_incremental_state
ค่าเริ่มต้น --xbinary_fdo=<a build target label>: ดูคำอธิบาย
ใช้ข้อมูลโปรไฟล์ XbinaryFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อของโปรไฟล์แบบไบนารีที่เป็นค่าเริ่มต้น เมื่อใช้ตัวเลือกนี้ร่วมกับ --fdo_instrument/--fdo_optimize/--fdo_profile ตัวเลือกเหล่านั้นจะมีผลเหนือกว่าเสมอเสมือนว่าไม่ได้ระบุ xbinary_fdo
แท็ก: affects_outputs
ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตบิลด์ที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมธง ฯลฯ)
ค่าเริ่มต้นของ --auto_cpu_environment_group=<a build target label>: ""
ประกาศ cloud_group ที่จะใช้ในการแมปค่า CPU กับค่า target_environment โดยอัตโนมัติ
แท็ก: changes_inputs, loading_and_analysis, experimental
ค่าเริ่มต้น --[no]check_licenses: "เท็จ"
ตรวจสอบว่าข้อจำกัดในการออกใบอนุญาตที่กำหนดโดยแพ็กเกจที่เกี่ยวข้องไม่ขัดแย้งกับโหมดการเผยแพร่ของเป้าหมายที่กำลังสร้าง โดยค่าเริ่มต้น ใบอนุญาตจะไม่ได้รับการตรวจสอบ
แท็ก: build_file_semantics
ค่าเริ่มต้น --[no]check_visibility: "true"
หากปิดใช้ ระบบจะลดระดับข้อผิดพลาดระดับการเข้าถึงในทรัพยากร Dependency เป้าหมายให้เหลือเพียงคําเตือน
แท็ก: build_file_semantics
ค่าเริ่มต้น --[no]desugar_for_android: "true"
เลือกว่าจะใช้ไบต์โค้ด Java 8 ก่อนถอดรหัสหรือไม่
แท็ก: affects_outputs, loading_and_analysis, loses_incremental_state
ค่าเริ่มต้น --[no]desugar_java8_libs: "เท็จ"
เลือกว่าจะรวมไลบรารี Java 8 ที่รองรับในแอปสำหรับอุปกรณ์เดิมหรือไม่
แท็ก: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
ค่าเริ่มต้น --[no]enforce_constraints: "true"
ตรวจสอบสภาพแวดล้อมที่แต่ละเป้าหมายใช้งานร่วมกันได้ และรายงานข้อผิดพลาดหากเป้าหมายมีทรัพยากร Dependency ที่ไม่รองรับสภาพแวดล้อมเดียวกัน
แท็ก: build_file_semantics
ค่าเริ่มต้น --[no]experimental_check_desugar_deps: "true"
ตรวจสอบความถูกต้องของการแยกน้ำตาลที่ระดับไบนารีของ Android อีกครั้งหรือไม่
แท็ก: eagerness_to_exit, loading_and_analysis, experimental
ค่าเริ่มต้นของ --experimental_import_deps_checking=<off, warning or error>: "ปิด"
เมื่อเปิดใช้ ให้ตรวจสอบว่าทรัพยากร Dependency ของ aar_IMPORT เสร็จสมบูรณ์หรือไม่ การบังคับใช้นี้อาจทำให้บิลด์เสียหายหรืออาจทำให้เกิดคำเตือน
แท็ก: loading_and_analysis
ค่าเริ่มต้น --experimental_strict_java_deps=<off, warn, error, strict or default>: "ค่าเริ่มต้น"
หากเป็นจริง ให้ตรวจสอบว่าเป้าหมาย Java ประกาศเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency อย่างชัดเจน
แท็ก: build_file_semantics eagerness_to_exit
ค่าเริ่มต้น --[no]incompatible_check_testonly_for_output_files: "เท็จ"
หากเปิดใช้ ให้ตรวจสอบ testonly สำหรับเป้าหมายที่จำเป็นเบื้องต้นที่เป็นไฟล์เอาต์พุตโดยค้นหา testonly ของกฎที่สร้าง รายการนี้ตรงกับการตรวจสอบระดับการเข้าถึง
แท็ก: build_file_semantics incompatible_change
ค่าเริ่มต้น --[no]incompatible_check_visibility_for_toolchains: "เท็จ"
หากเปิดใช้ การตรวจสอบระดับการเข้าถึงจะมีผลกับการติดตั้งใช้งาน Toolchain ด้วย
แท็ก: build_file_semantics incompatible_change
ค่าเริ่มต้น --[no]incompatible_disable_native_android_rules: "เท็จ"
หากเปิดใช้ ระบบจะปิดใช้กฎที่มีอยู่สำหรับ Android โดยตรง โปรดใช้กฎของ Android Starlark จาก https://github.com/bazelbuild/rules_android
แท็ก: eagerness_to_exit incompatible_change
ค่าเริ่มต้น --[no]incompatible_disable_native_apple_binary_rule: "เท็จ"
ไม่มีการดำเนินการ เก็บไว้ที่นี่เพื่อดูความเข้ากันได้แบบย้อนหลัง
แท็ก: eagerness_to_exit incompatible_change
ค่าเริ่มต้น --[no]incompatible_python_disable_py2: "true"
หากเป็น "จริง" การใช้การตั้งค่า Python 2 จะทำให้เกิดข้อผิดพลาด ซึ่งรวมถึง python_version=PY2, srcs_version=PY2 และ srcs_version=PY2ONLY ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/15684
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --[no]incompatible_validate_top_level_header_inclusions: "true"
หากเป็นจริง Bazel จะตรวจสอบการรวมส่วนหัวไดเรกทอรีระดับบนสุดด้วย (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/10047)
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --python_native_rules_allowlist=<a build target label>: ดูคำอธิบาย
รายการที่อนุญาต (package_group target (เป้าหมายกลุ่มแพ็กเกจ) ที่จะใช้เมื่อบังคับใช้ --incompatible_python_disallow_native_rules
แท็ก: loading_and_analysis
ค่าเริ่มต้น --[no]strict_filesets: "เท็จ"
หากเปิดใช้ตัวเลือกนี้ ระบบจะรายงานว่าชุดไฟล์ข้ามขอบเขตของแพ็กเกจเป็นข้อผิดพลาด
แท็ก: build_file_semantics eagerness_to_exit
ค่าเริ่มต้น --strict_proto_deps=<off, warn, error, strict or default>: "ข้อผิดพลาด"
หากไม่ "ปิด" ให้ตรวจสอบว่าเป้าหมาย protocol_library ประกาศอย่างชัดแจ้งว่าเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency
แท็ก: build_file_semantics, eagerness_to_exit, incompatible_change
ค่าเริ่มต้นของ --strict_public_imports=<off, warn, error, strict or default>: "ปิด"
หากไม่ "ปิด" ให้ตรวจสอบว่าเป้าหมาย protocol_library ประกาศอย่างชัดเจนถึงเป้าหมายทั้งหมดที่ใช้ใน "นำเข้าสาธารณะ" ตามที่ส่งออกแล้ว
แท็ก: build_file_semantics, eagerness_to_exit, incompatible_change
ค่าเริ่มต้น --[no]strict_system_includes: "เท็จ"
หากเป็น "จริง" ส่วนหัวที่พบผ่านทางระบบรวมเส้นทาง (-isystem) ต้องมีการประกาศด้วย
แท็ก: loading_and_analysis eagerness_to_exit
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --target_environment=<a build target label> รายการ
ประกาศสภาพแวดล้อมเป้าหมายของบิลด์นี้ ต้องอ้างอิงถึงป้ายกำกับไปยัง "สภาพแวดล้อม" กฎ หากระบุ เป้าหมายระดับบนสุดทั้งหมดต้องเข้ากันได้กับสภาพแวดล้อมนี้
แท็ก: changes_inputs
ตัวเลือกที่มีผลต่อเอาต์พุตการลงชื่อของบิลด์:
ค่าเริ่มต้น --apk_signing_method=<v1, v2, v1_v2 or v4>: "v1_v2"
การใช้งานเพื่อรับรอง APK
แท็ก: action_command_lines, affects_outputs, loading_and_analysis
ค่าเริ่มต้น --[no]device_debug_entitlements: "true"
หากมีการตั้งค่า และโหมดการคอมไพล์ไม่ใช่ "เพิ่มประสิทธิภาพ" แอป objc จะรวมการให้สิทธิ์การแก้ไขข้อบกพร่องเมื่อลงชื่อ
แท็ก: changes_inputs
ค่าเริ่มต้น --ios_signing_cert_name=<a string>: ดูคำอธิบาย
ชื่อใบรับรองที่จะใช้สำหรับ iOS Signing หากไม่ได้ตั้งค่า ระบบจะกลับไปใช้โปรไฟล์การจัดสรร อาจเป็นค่ากำหนดข้อมูลประจำตัว Keychain ของใบรับรองหรือ (สตริงย่อย) ของชื่อสามัญของใบรับรองตามหน้า man ของ Codesign (รหัสการลงชื่อเข้าใช้)
แท็ก: action_command_lines
ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
ค่าเริ่มต้น --[no]incompatible_config_setting_private_default_visibility: "เท็จ"
หากไม่รองรับ _enforce_config_setting_visibility=false ค่าจะเป็น Noop หรือไม่เช่นนั้น หากแฟล็กนี้เป็นเท็จ config_setting ใดๆ ที่ไม่มีแอตทริบิวต์การเปิดเผยอย่างชัดแจ้งจะเป็น //visibility:public หากแฟล็กนี้เป็นจริง config_setting จะใช้ตรรกะระดับการเข้าถึงเดียวกันกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --[no]incompatible_disallow_legacy_py_provider: "true"
ไม่มีการดำเนินการ จะถูกนำออกในเร็วๆ นี้
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --[no]incompatible_disallow_sdk_frameworks_attributes: "เท็จ"
หากเป็น "จริง" ไม่อนุญาตแอตทริบิวต์ sdk_frameworks และ external_sdk_frameworks ใน objc_library andobjc_import
แท็ก: build_file_semantics incompatible_change
ค่าเริ่มต้น --[no]incompatible_enforce_config_setting_visibility: "true"
หากเป็น "จริง" ให้บังคับใช้การจำกัดระดับการเข้าถึง config_setting หากเป็น "เท็จ" ทุก config_setting จะปรากฏแก่เป้าหมายทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก: loading_and_analysis incompatible_change
หากเป็น "จริง" ตั้งค่าเริ่มต้นเป็น "จริง" สำหรับแอตทริบิวต์ Alwayslink ใน objc_library และ objc_IMPORT
แท็ก: build_file_semantics incompatible_change
ค่าเริ่มต้น --[no]incompatible_python_disallow_native_rules: "เท็จ"
เมื่อเป็นจริง เกิดข้อผิดพลาดขึ้นเมื่อใช้กฎ py_* ในตัว ควรใช้กฎ rules_python แทน ดูข้อมูลเพิ่มเติมและวิธีการย้ายข้อมูลได้ที่ https://github.com/bazelbuild/bazel/issues/17773
แท็ก: loading_and_analysis incompatible_change
ตัวเลือกที่ควบคุมพฤติกรรมของ
สภาพแวดล้อมการทดสอบหรือตัวดำเนินการทดสอบ:
ค่าเริ่มต้น --[no]allow_analysis_failures: "เท็จ"
หากจริง การวิเคราะห์เป้าหมายของกฎไม่สำเร็จส่งผลให้เกิดการเผยแพร่อินสแตนซ์ของ AnalysisFailureInfo ของเป้าหมายที่มีคำอธิบายข้อผิดพลาด แทนที่จะทำให้บิลด์ไม่สำเร็จ
แท็ก: loading_and_analysis experimental
ค่าเริ่มต้น --analysis_testing_deps_limit=<an integer>: "2000"
ตั้งค่าจำนวนสูงสุดของทรัพยากร Dependency แบบทรานซิทีฟผ่านแอตทริบิวต์กฎที่มีการเปลี่ยนการกำหนดค่า for_analysis_testing การใช้เกินขีดจำกัดนี้จะทำให้เกิดข้อผิดพลาดของกฎ
แท็ก: loading_and_analysis
ค่าเริ่มต้น --[no]break_build_on_parallel_dex2oat_failure: "เท็จ"
หากความล้มเหลวจริงในการดำเนินการ dex2oat จะทำให้บิลด์เสียหายแทนที่จะเรียกใช้ dex2oat ระหว่างรันไทม์ทดสอบ
แท็ก: loading_and_analysis experimental
ค่าเริ่มต้น --[no]check_tests_up_to_date: "เท็จ"
โดยไม่ต้องทำการทดสอบ เพียงแต่ต้องตรวจสอบว่าการทดสอบเป็นข้อมูลล่าสุดหรือไม่ หากผลการทดสอบทั้งหมดเป็นปัจจุบัน แสดงว่าการทดสอบเสร็จสมบูรณ์ หากต้องสร้างหรือดำเนินการทดสอบใดๆ ระบบจะรายงานข้อผิดพลาดและการทดสอบจะไม่สำเร็จ ตัวเลือกนี้กล่าวเป็นนัยถึงลักษณะการทำงาน --check_up_to_date
แท็ก: execution
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g. memory=10,30,60,100> รายการ
ลบล้างจำนวนทรัพยากรเริ่มต้นสำหรับการทดสอบ รูปแบบที่คาดไว้คือ <resource>=<value> หากระบุจำนวนบวกตัวเดียวเป็น <value> ระบบจะลบล้างทรัพยากรเริ่มต้นสำหรับขนาดทดสอบทั้งหมด หากระบุตัวเลขที่คั่นด้วยคอมมา 4 ตัว จำนวนดังกล่าวจะแทนที่จำนวนทรัพยากรสำหรับขนาดทดสอบขนาดเล็ก กลาง ใหญ่ และขนาดใหญ่ตามลำดับ ค่าอาจเป็น HOST_RAM/HOST_CPU (ไม่บังคับ) ตามด้วย [-|*]<Flo> (เช่น Memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4) ทรัพยากรการทดสอบเริ่มต้นที่ระบุโดยแฟล็กนี้จะถูกลบล้างโดยทรัพยากรที่อาจไม่เหมาะสมซึ่งระบุไว้ในแท็ก
ค่าเริ่มต้น --[no]experimental_android_use_parallel_dex2oat: "เท็จ"
ใช้ dex2oat แบบขนานเพื่อเร่งความเร็ว android_test
แท็ก: loading_and_analysis, host_machine_resource_optimizations, experimental
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once> รายการ
ในกรณีที่การทดสอบล้มเหลว ระบบจะพยายามทดสอบซ้ำจนถึงจำนวนครั้งที่ระบุไว้ การทดสอบที่ต้องผ่านมากกว่า 1 ครั้งจะมีการทำเครื่องหมายเป็น "FLAKY" ในสรุปการทดสอบ โดยปกติแล้ว ค่าที่ระบุจะเป็นแค่จำนวนเต็มหรือสตริง "ค่าเริ่มต้น" หากเป็นจำนวนเต็ม การทดสอบทั้งหมดจะทำงานได้ไม่เกิน N ครั้ง หากเป็น "ค่าเริ่มต้น" ระบบจะพยายามทดสอบเพียงครั้งเดียวสำหรับการทดสอบปกติ และอีก 3 ครั้งสำหรับการทดสอบที่มีการทำเครื่องหมายอย่างชัดแจ้งว่า "ไม่สม่ำเสมอ" ตามกฎ (แอตทริบิวต์ flaky=1) ไวยากรณ์อื่น: regex_filter@flaky_test_attempts flaky_test_attempts เหมือนกับข้างต้น และ regex_filter ย่อมาจากรายการรวมและยกเว้นรูปแบบนิพจน์ทั่วไป (โปรดดู --runs_per_test) ตัวอย่าง: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 ดีเฟลกการทดสอบทั้งหมดใน //foo/ ยกเว้นการทดสอบที่อยู่ภายใต้ foo/bar 3 ครั้ง ตัวเลือกนี้ส่งได้หลายครั้ง อาร์กิวเมนต์ที่ส่งผ่านล่าสุดที่ตรงกันจะมีความสำคัญเหนือกว่า หากไม่มีผลลัพธ์ที่ตรงกัน ลักษณะการทำงานจะเป็นเหมือน "ค่าเริ่มต้น" ที่ด้านบน
แท็ก: execution
ค่าเริ่มต้น --[no]ios_memleaks: "เท็จ"
เปิดใช้การตรวจหาหน่วยความจำรั่วไหลในเป้าหมาย ios_test
แท็ก: action_command_lines
ค่าเริ่มต้น --ios_simulator_device=<a string>: ดูคำอธิบาย
อุปกรณ์ที่จะจำลองเมื่อเรียกใช้แอปพลิเคชัน iOS ในเครื่องมือจำลอง เช่น "iPhone 6" คุณดูรายการอุปกรณ์ได้โดยเรียกใช้ "xcrun simctl list devicetypes" บนเครื่องที่เครื่องมือจำลองจะทำงาน
แท็ก: test_runner
ค่าเริ่มต้น --ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: ดูคำอธิบาย
เวอร์ชันของ iOS ที่จะเรียกใช้บนเครื่องมือจำลองเมื่อทำงานหรือทดสอบ ระบบจะไม่สนใจกฎ ios_test หากกฎระบุอุปกรณ์เป้าหมายไว้ในกฎ
แท็ก: test_runner
ค่าเริ่มต้น --local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">: "อัตโนมัติ"
จำนวนงานทดสอบในเครื่องที่จะเรียกใช้พร้อมกันสูงสุด ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") โดยจะเลือกตามด้วยการดำเนินการ ([-|*]<Float>) เช่น "auto", "HOST_CPUS*.5" 0 หมายความว่าทรัพยากรในเครื่องจะจำกัดจำนวนงานทดสอบในเครื่องที่จะเรียกใช้พร้อมกันแทน การตั้งค่านี้ที่มากกว่าค่าสำหรับ --jobs จะไม่มีผล
แท็ก: execution
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once> รายการ
ระบุจำนวนครั้งที่จะทำการทดสอบแต่ละครั้ง หากการดำเนินการเหล่านั้นล้มเหลวไม่ว่าด้วยเหตุผลใดก็ตาม จะถือว่าการทดสอบทั้งหมดไม่ผ่าน โดยปกติแล้ว ค่าที่ระบุจะเป็นแค่จำนวนเต็ม ตัวอย่าง: --runs_per_test=3 จะทำการทดสอบทั้งหมด 3 ครั้ง ไวยากรณ์สำรอง: regex_filter@runs_per_test โดย running_per_test ย่อมาจากค่าจำนวนเต็ม ส่วน regex_filter หมายถึงรายการรูปแบบการรวมและยกเว้นรูปแบบนิพจน์ทั่วไป (โปรดดู --instrumentation_filter) ตัวอย่างเช่น --runs_per_test=//foo/.*,-//foo/bar/.*@3 จะทำการทดสอบทั้งหมดใน //foo/ ยกเว้นการทดสอบภายใต้ foo/bar 3 ครั้ง ตัวเลือกนี้ส่งได้หลายครั้ง อาร์กิวเมนต์ที่ส่งผ่านล่าสุดที่ตรงกันจะมีความสำคัญเหนือกว่า หากไม่มีผลลัพธ์ที่ตรงกัน ระบบจะทำการทดสอบเพียงครั้งเดียว
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --test_env=<a 'name=value' assignment with an optional value part> รายการ
ระบุตัวแปรสภาพแวดล้อมเพิ่มเติมที่จะแทรกลงในสภาพแวดล้อมตัวดำเนินการทดสอบ คุณระบุตัวแปรได้โดยใช้ชื่อ ซึ่งในกรณีนี้ระบบจะอ่านค่าของตัวแปรจากสภาพแวดล้อมไคลเอ็นต์ Bazel หรือด้วยคู่ชื่อ=ค่า ตัวเลือกนี้ใช้ได้หลายครั้งเพื่อระบุตัวแปรหลายรายการ ใช้เฉพาะโดย "การทดสอบ bazel" เท่านั้น คำสั่ง
แท็ก: test_runner
ค่าเริ่มต้น --[no]test_keep_going: "true"
เมื่อปิดใช้ การทดสอบที่ไม่ผ่านจะทำให้ทั้งบิลด์หยุดทำงาน โดยค่าเริ่มต้น ระบบจะทำการทดสอบทั้งหมดแม้ว่าจะไม่ผ่านก็ตาม
แท็ก: execution
ค่าเริ่มต้นของ --test_strategy=<a string>: ""
ระบุกลยุทธ์ที่จะใช้เมื่อทำการทดสอบ
แท็ก: execution
ค่าเริ่มต้น --test_timeout=<a single integer or comma-separated list of 4 integers>: "-1"
ลบล้างค่าระยะหมดเวลาในการทดสอบเริ่มต้นสำหรับระยะหมดเวลาทดสอบ (เป็นวินาที) หากระบุค่าจำนวนเต็มบวกค่าเดียว ค่าดังกล่าวจะแทนที่หมวดหมู่ทั้งหมด หากระบุจำนวนเต็มที่คั่นด้วยคอมมา 4 ตัวเลข ค่าดังกล่าวจะลบล้างระยะหมดเวลาสำหรับแบบสั้น ปานกลาง ยาว และนิรันดร์ (ตามลำดับนั้น) ไม่ว่าจะเป็นรูปแบบใด ค่า -1 จะบอกให้ Blaze ใช้ระยะหมดเวลาเริ่มต้นสำหรับหมวดหมู่นั้น
ค่าเริ่มต้น --test_tmpdir=<a path>: ดูคำอธิบาย
ระบุไดเรกทอรีชั่วคราวพื้นฐานสําหรับ "การทดสอบ Bazel" ในการใช้กัน
ค่าเริ่มต้น --[no]zip_undeclared_test_outputs: "true"
หากเป็น "จริง" ระบบจะเก็บเอาต์พุตทดสอบที่ไม่ได้ประกาศไว้ในไฟล์ ZIP
แท็ก: test_runner
ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพเวลาของบิลด์
ค่าเริ่มต้นของ --cache_computed_file_digests=<a long integer>: "50,000"
หากมากกว่า 0 ให้กำหนดค่า Bazel ให้แคชไดเจสต์ของไฟล์ในหน่วยความจำตามข้อมูลเมตาของไฟล์แทนการคำนวณไดเจสต์ใหม่จากดิสก์ทุกครั้งที่ต้องการ การตั้งค่านี้เป็น 0 จะรับประกันความถูกต้อง เนื่องจากการเปลี่ยนแปลงไฟล์บางอย่างอาจบันทึกจากข้อมูลเมตาของไฟล์ไม่ได้ เมื่อไม่ใช่ 0 ตัวเลขนี้บ่งบอกถึงขนาดของแคชตามจำนวนไดเจสต์ของไฟล์ที่จะแคช
ค่าเริ่มต้น --[no]experimental_filter_library_jar_with_program_jar: "เท็จ"
กรอง ProGuard ProgramJar เพื่อนำชั้นเรียนที่อยู่ใน LibraryJar ออกด้วย
แท็ก: action_command_lines
ค่าเริ่มต้น --[no]experimental_inmemory_dotd_files: "true"
หากเปิดใช้ ระบบจะส่งไฟล์ C++ .d ในหน่วยความจำโดยตรงจากโหนดบิลด์ระยะไกลแทนที่จะถูกเขียนลงในดิสก์
แท็ก: loading_and_analysis, execution, affects_outputs, experimental
ค่าเริ่มต้น --[no]experimental_inmemory_jdeps_files: "true"
หากเปิดใช้ ไฟล์ทรัพยากร Dependency (.jdeps) ที่สร้างขึ้นจากการคอมไพล์ Java จะส่งผ่านในหน่วยความจำโดยตรงจากโหนดบิลด์ระยะไกลแทนที่จะถูกเขียนลงในดิสก์
แท็ก: loading_and_analysis, execution, affects_outputs, experimental
ค่าเริ่มต้น --[no]experimental_objc_include_scanning: "เท็จ"
ระบุว่าจะทำการสแกนรวมสำหรับวัตถุประสงค์ C/C++ หรือไม่
แท็ก: loading_and_analysis, execution, changes_inputs
ค่าเริ่มต้น --[no]experimental_retain_test_configuration_across_testonly: "เท็จ"
เมื่อเปิดใช้ --trim_test_configuration จะไม่ตัดการกำหนดค่าการทดสอบสำหรับกฎที่ทำเครื่องหมายว่า testonly=1 ทั้งนี้เพื่อลดปัญหาความขัดแย้งในการดำเนินการเมื่อกฎที่ไม่ใช่การทดสอบต้องพึ่งพากฎ cc_test จะไม่มีผลหาก --trim_test_configuration เป็นเท็จ
แท็ก: loading_and_analysis loses_incremental_state
ค่าเริ่มต้น --[no]experimental_starlark_cc_import: "เท็จ"
หากเปิดใช้ เวอร์ชัน Starlark ของ cc_import จะสามารถใช้ได้
แท็ก: loading_and_analysis experimental
ค่าเริ่มต้น --[no]experimental_unsupported_and_brittle_include_scanning: "เท็จ"
เลือกว่าจะจำกัดอินพุตเฉพาะการคอมไพล์ C/C++ หรือไม่โดยการแยกวิเคราะห์ #include บรรทัดจากไฟล์อินพุต ซึ่งจะช่วยปรับปรุงประสิทธิภาพและส่วนเพิ่มด้วยการลดขนาดของแผนผังอินพุตสำหรับการคอมไพล์ อย่างไรก็ตาม ก็อาจทำให้บิลด์เสียหายได้เช่นกัน เนื่องจากเครื่องมือสแกนดังกล่าวไม่สามารถใช้งานความหมายของโปรเซสเซอร์ล่วงหน้าแบบ C ได้อย่างสมบูรณ์ โดยเฉพาะอย่างยิ่ง ระบบจะไม่เข้าใจคำสั่ง #include แบบไดนามิก และไม่สนใจตรรกะตามเงื่อนไขของตัวประมวลผลล่วงหน้า คุณต้องรับความเสี่ยงของการใช้งานเอง เราจะปิดปัญหาที่เกี่ยวข้องกับการแจ้งว่าไม่เหมาะสมนี้
แท็ก: loading_and_analysis, execution, changes_inputs
ค่าเริ่มต้น --[no]incremental_dexing: "true"
ส่วนใหญ่จะทำงานสำหรับ Dexing แยกต่างหากสำหรับไฟล์ Jar แต่ละไฟล์
แท็ก: affects_outputs, loading_and_analysis, loses_incremental_state
ค่าเริ่มต้นของ --local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>: "HOST_CPUS"
กำหนดจำนวนแกน CPU ภายในทั้งหมดอย่างชัดเจนให้กับ Bazel เพื่อใช้จ่ายกับการดำเนินการของบิลด์ที่ดำเนินการภายในเครื่อง ใช้ค่าจำนวนเต็มหรือ "HOST_CPUS" แล้วตามด้วย [-|*]<float> (ไม่บังคับ) (เช่น HOST_CPUS*.5 เพื่อใช้แกน CPU ที่มีอยู่ครึ่งหนึ่ง) โดยค่าเริ่มต้น ("HOST_CPUS") Bazel จะค้นหาการกำหนดค่าของระบบเพื่อประมาณจำนวนแกน CPU ที่มี
แท็ก: host_machine_resource_optimizations
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --local_extra_resources=<a named float, 'name=value'> รายการ
กำหนดจำนวนทรัพยากรเพิ่มเติมที่ใช้ได้กับ Bazel รับในคู่สตริง-ลอย ใช้เพื่อระบุทรัพยากรเพิ่มเติมได้หลายประเภท Bazel จะจำกัดการดำเนินการที่เกิดขึ้นพร้อมกันตามทรัพยากรที่มีและทรัพยากรเพิ่มเติมที่จำเป็น การทดสอบสามารถประกาศจำนวนทรัพยากรเพิ่มเติมที่ต้องการโดยใช้แท็ก "resources:<resoucename>:<amount>" ตั้งค่า CPU, RAM และทรัพยากรที่มีอยู่ด้วยแฟล็กนี้ไม่ได้
แท็ก: host_machine_resource_optimizations
ค่าเริ่มต้น --local_ram_resources=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>: "HOST_RAM*.67"
กำหนดจำนวน RAM ทั้งหมดของโฮสต์ในเครื่อง (เป็น MB) ที่ Bazel จะใช้ได้อย่างชัดเจนเพื่อใช้จ่ายกับการดำเนินการของบิลด์ที่ดำเนินการภายในเครื่อง ใช้จำนวนเต็มหรือ "HOST_RAM" แล้วตามด้วย [-|*]<float> หรือไม่ก็ได้ (เช่น HOST_RAM*.5 เพื่อใช้ RAM ที่มีอยู่ครึ่งหนึ่ง) โดยค่าเริ่มต้น ("HOST_RAM*.67") Bazel จะค้นหาการกำหนดค่าของระบบเพื่อประมาณจำนวน RAM ที่มีและจะใช้ 67% จากการกำหนดค่านี้
แท็ก: host_machine_resource_optimizations
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --local_resources=<a named double, 'name=value', where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> รายการ
กำหนดจำนวนทรัพยากรที่ Bazel ใช้ได้ นำงานไปยัง Float หรือ HOST_RAM/HOST_CPUS (ไม่บังคับ) ตามด้วย [-|*]<Flo> (เช่น Memory=HOST_RAM*.5 เพื่อใช้ RAM ที่มีอยู่ครึ่งหนึ่ง) ใช้เพื่อระบุทรัพยากรได้หลายประเภทได้หลายครั้ง Bazel จะจำกัดการดำเนินการที่เกิดขึ้นพร้อมกันตามทรัพยากรที่มีและทรัพยากรที่จำเป็น การทดสอบจะประกาศจำนวนทรัพยากรที่ต้องการได้โดยใช้แท็ก "resources:<resource name>:<amount>" ลบล้างทรัพยากรที่ระบุโดย --local_{cpu|ram|extra}_resources
แท็ก: host_machine_resource_optimizations
ค่าเริ่มต้น --[no]objc_use_dotd_pruning: "true"
หากตั้งค่าไว้ จะมีการใช้ไฟล์ .d ที่มาจาก clang เพื่อตัดชุดอินพุตที่ส่งผ่านเข้าไปในคอมไพล์ objc
แท็ก: changes_inputs loading_and_analysis
ค่าเริ่มต้น --[no]process_headers_in_dependencies: "เท็จ"
เมื่อสร้าง //a:a เป้าหมาย ให้ประมวลผลส่วนหัวในเป้าหมายทั้งหมดที่ //a:a ต้องใช้ (หากเปิดใช้การประมวลผลส่วนหัวสำหรับ Toolchain)
แท็ก: execution
ค่าเริ่มต้น --[no]trim_test_configuration: "true"
เมื่อเปิดใช้ ระบบจะล้างตัวเลือกที่เกี่ยวข้องกับการทดสอบซึ่งอยู่ใต้ระดับบนสุดของบิลด์ เมื่อแฟล็กนี้ทำงานอยู่ ระบบจะสร้างการทดสอบเป็นทรัพยากร Dependency ของกฎที่ไม่ใช่การทดสอบไม่ได้ แต่การเปลี่ยนแปลงตัวเลือกที่เกี่ยวข้องกับการทดสอบจะไม่ทำให้มีการวิเคราะห์กฎที่ไม่ใช่การทดสอบอีกครั้ง
แท็ก: loading_and_analysis loses_incremental_state
ตัวเลือกที่ส่งผลต่อ
การพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
ค่าเริ่มต้น --[no]experimental_bep_target_summary: "เท็จ"
ต้องการเผยแพร่เหตุการณ์ TargetSummary หรือไม่
ค่าเริ่มต้น --[no]experimental_build_event_expand_filesets: "เท็จ"
หากเป็น "จริง" ให้ขยายชุดไฟล์ใน BEP เมื่อนำเสนอไฟล์เอาต์พุต
แท็ก: affects_outputs
หากเป็น "จริง" ให้แปลค่าลิงก์สัญลักษณ์ของ Fileset สัมพัทธ์ทั้งหมดใน BEP เมื่อนำเสนอไฟล์เอาต์พุต ต้องมี --experimental_build_event_expand_filesset
แท็ก: affects_outputs
ค่าเริ่มต้น --experimental_build_event_upload_max_retries=<an integer>: "4"
จำนวนครั้งสูงสุดที่ Bazel ควรลองอัปโหลดเหตุการณ์บิลด์อีกครั้ง
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>: "1s"
เริ่มแรก ความล่าช้าขั้นต่ำสำหรับการลองใหม่แบบ Exponential Backoff เมื่ออัปโหลด BEP ไม่สำเร็จ (เลขชี้กำลัง: 1.6)
แท็ก: bazel_internal_configuration
ค่าเริ่มต้น --experimental_build_event_upload_strategy=<a string>: ดูคำอธิบาย
เลือกวิธีอัปโหลดอาร์ติแฟกต์ที่อ้างอิงในโปรโตคอลเหตุการณ์บิลด์
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]experimental_materialize_param_files_directly: "เท็จ"
หากทำให้ไฟล์พารามิเตอร์เป็นรูปธรรม ให้ดำเนินการดังกล่าวด้วยการเขียนไปยังดิสก์โดยตรง
แท็ก: execution
ค่าเริ่มต้น --[no]experimental_run_bep_event_include_residue: "เท็จ"
เลือกว่าจะรวมการขาดเหลือของบรรทัดคำสั่งในเหตุการณ์บิลด์ซึ่งอาจมีส่วนที่เหลือหรือไม่ โดยค่าเริ่มต้น ความต่อเนื่องจะไม่รวมอยู่ในเหตุการณ์การสร้างคำสั่งการเรียกใช้คำสั่งที่อาจมีส่วนที่เหลืออยู่
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]experimental_stream_log_file_uploads: "เท็จ"
สตรีมไฟล์บันทึกจะอัปโหลดไปยังพื้นที่เก็บข้อมูลระยะไกลโดยตรงแทนการเขียนลงดิสก์
แท็ก: affects_outputs
ค่าเริ่มต้น --explain=<a path>: ดูคำอธิบาย
ทำให้ระบบบิลด์อธิบายแต่ละขั้นตอนที่ดำเนินการแล้วของบิลด์ ระบบจะเขียนคำอธิบายลงในไฟล์บันทึกที่ระบุ
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]legacy_important_outputs: "true"
ใช้อาร์กิวเมนต์นี้เพื่อระงับการสร้างช่อง legal_outputs เดิมในเหตุการณ์ TargetComplete ต้องใช้ required_outputs สำหรับการผสานรวม Bazel กับ ResultStore
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]materialize_param_files: "เท็จ"
เขียนไฟล์พารามิเตอร์ระดับกลางไปยังโครงสร้างเอาต์พุตแม้ในขณะที่ใช้การดำเนินการจากระยะไกล มีประโยชน์เมื่อมีการแก้ไขข้อบกพร่อง ซึ่งหมายถึง --subcommands และ --verbose_failures
แท็ก: execution
ค่าเริ่มต้น --max_config_changes_to_show=<an integer>: "3"
เมื่อทิ้งแคชการวิเคราะห์เนื่องจากการเปลี่ยนแปลงตัวเลือกบิลด์ จะแสดงชื่อตัวเลือกที่มีการเปลี่ยนแปลงตามจำนวนที่กำหนด ถ้าตัวเลขที่ระบุคือ -1 ตัวเลือกที่มีการเปลี่ยนแปลงทั้งหมดจะแสดง
แท็ก: terminal_output
ค่าเริ่มต้น --max_test_output_bytes=<an integer>: "-1"
ระบุขนาดสูงสุดของบันทึกต่อการทดสอบที่ส่งได้เมื่อ --test_output คือ "ข้อผิดพลาด" หรือ "ทั้งหมด" มีประโยชน์เพื่อหลีกเลี่ยงเอาต์พุตที่ไม่ได้ทำให้เอาต์พุตการทดสอบมีเสียงดังรบกวนมากเกินไป ส่วนหัวการทดสอบจะรวมอยู่ในขนาดบันทึก ค่าลบหมายถึงไม่มีขีดจำกัด เอาต์พุตทั้งหมดหรือไม่มีเลย
แท็ก: test_runner, terminal_output, execution
ค่าเริ่มต้น --output_filter=<a valid Java regular expression>: ดูคำอธิบาย
แสดงเฉพาะเอาต์พุตของคำเตือนและการดำเนินการสำหรับกฎที่มีชื่อตรงกับนิพจน์ทั่วไปที่ระบุ
แท็ก: affects_outputs
ค่าเริ่มต้น --progress_report_interval=<an integer in 0-3600 range>: "0"
จำนวนวินาทีที่จะรอระหว่างรายงานในงานที่ยังทำงานอยู่ ค่าเริ่มต้น 0 หมายความว่าระบบจะพิมพ์รายงานแรกหลังผ่านไป 10 วินาที จากนั้นจะแสดงเป็นเวลา 30 วินาที หลังจากนั้นจะมีการรายงานความคืบหน้า 1 ครั้งในทุกๆ นาที เมื่อเปิดใช้งาน --curses จะมีการรายงานความคืบหน้าทุกวินาที
แท็ก: affects_outputs
ค่าเริ่มต้น --show_result=<an integer>: "1"
แสดงผลลัพธ์ของบิลด์ สำหรับแต่ละเป้าหมาย ให้ระบุว่าเป็นข้อมูลล่าสุดหรือไม่ และหากใช่ ให้แจ้งรายการไฟล์เอาต์พุตที่สร้างขึ้น ไฟล์ที่พิมพ์เป็นสตริงที่สะดวกสำหรับการคัดลอก+วางลงใน Shell เพื่อเรียกใช้ไฟล์ ตัวเลือกนี้ต้องใช้อาร์กิวเมนต์จำนวนเต็ม ซึ่งเป็นจำนวนเกณฑ์ของเป้าหมายด้านบนซึ่งระบบจะไม่พิมพ์ข้อมูลผลลัพธ์ ดังนั้น 0 จะทำให้มีการระงับข้อความและ MAX_INT จะทำให้มีการพิมพ์ผลลัพธ์เสมอ ค่าเริ่มต้นคือ 1 หากไม่มีสิ่งใดที่สร้างขึ้นสำหรับเป้าหมาย ระบบอาจละเว้นผลลัพธ์เพื่อให้เอาต์พุตอยู่ภายใต้เกณฑ์
แท็ก: affects_outputs
--[no]subcommands [-s] ค่าเริ่มต้น: "เท็จ"
แสดงคำสั่งย่อยที่ดำเนินการระหว่างบิลด์ แฟล็กที่เกี่ยวข้อง: --execution_log_json_file, --execution_log_binary_file (สำหรับการบันทึกคำสั่งย่อยไปยังไฟล์ในรูปแบบที่ง่ายต่อการใช้เครื่องมือ)
แท็ก: terminal_output
ค่าเริ่มต้น --test_output=<summary, errors, all or streamed>: "summary"
ระบุโหมดเอาต์พุตที่ต้องการ ค่าที่ถูกต้องคือ "summary" เพื่อแสดงเฉพาะสรุปสถานะการทดสอบ "ข้อผิดพลาด" เพื่อพิมพ์บันทึกการทดสอบสำหรับการทดสอบที่ล้มเหลวด้วย "ทั้งหมด" เพื่อพิมพ์บันทึกสำหรับการทดสอบทั้งหมดและ "สตรีม" เพื่อส่งออกบันทึกสำหรับการทดสอบทั้งหมดในแบบเรียลไทม์ (การดำเนินการนี้จะบังคับให้ดำเนินการทดสอบในเครื่องครั้งละ 1 รายการโดยไม่คำนึงถึงค่า --test_strategy)
แท็ก: test_runner, terminal_output, execution
ค่าเริ่มต้นของ --test_summary=<short, terse, detailed, none or testcase>: "สั้น"
ระบุรูปแบบของสรุปการทดสอบที่ต้องการ ค่าที่ถูกต้องคือ "short" เพื่อพิมพ์ข้อมูลเกี่ยวกับการทดสอบที่ดําเนินการเท่านั้น "แบบละเอียด" เพื่อพิมพ์เฉพาะข้อมูลเกี่ยวกับการทดสอบที่ดําเนินการไม่สําเร็จเท่านั้น เช่น "แบบละเอียด" เพื่อพิมพ์ข้อมูลโดยละเอียดเกี่ยวกับกรอบการทดสอบที่ล้มเหลว เช่น "testcase" เพื่อพิมพ์สรุปในการแก้ปัญหากรอบการทดสอบ อย่าพิมพ์ข้อมูลโดยละเอียดเกี่ยวกับกรอบการทดสอบที่ล้มเหลวและ "ไม่มี" ที่จะละเว้นข้อมูลสรุป
แท็ก: terminal_output
ค่าเริ่มต้น --toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: "-.*"
พิมพ์ข้อมูลการแก้ไขข้อบกพร่องระหว่างการแปลง Toolchain แฟล็กจะใช้นิพจน์ทั่วไปซึ่งตรวจสอบกับประเภท Toolchain และเป้าหมายที่เฉพาะเจาะจงเพื่อดูว่าควรแก้ไขข้อบกพร่องใด นิพจน์ทั่วไปหลายรายการจะคั่นด้วยคอมมา แล้วระบบจะเลือกนิพจน์ทั่วไปแต่ละรายการแยกกัน หมายเหตุ: เอาต์พุตของ Flag นี้มีความซับซ้อนมากและน่าจะเป็นประโยชน์ต่อผู้เชี่ยวชาญด้านการแก้ไข Toolchain เท่านั้น
แท็ก: terminal_output
ค่าเริ่มต้น --[no]verbose_explanations: "เท็จ"
เพิ่มรายละเอียดของคำอธิบายที่ออกหากเปิดใช้ --explain จะไม่มีผล หากไม่ได้เปิดใช้งาน --explain
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]verbose_failures: "เท็จ"
หากเรียกใช้คำสั่งไม่สำเร็จ ให้พิมพ์บรรทัดคำสั่งแบบเต็ม
แท็ก: terminal_output
ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --aspects_parameters=<a 'name=value' assignment> รายการ
ระบุค่าของพารามิเตอร์ด้านบรรทัดคำสั่ง ค่าพารามิเตอร์แต่ละรายการจะระบุผ่าน <param_name>=<param_value> เช่น 'my_param=my_val' ที่ "my_param" คือพารามิเตอร์ของบางด้านในรายการ --aspects รายการ หรือจำเป็นต้องใช้สำหรับด้านใดด้านหนึ่งในรายการ ตัวเลือกนี้ใช้ได้หลายครั้ง อย่างไรก็ตาม ไม่อนุญาตให้กำหนดค่าให้กับพารามิเตอร์เดียวกันมากกว่า 1 ครั้ง
แท็ก: loading_and_analysis
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --flag_alias=<a 'name=value' flag alias> รายการ
ตั้งชื่อย่อสำหรับธง Starlark โดยใช้คู่คีย์-ค่าคู่เดียวในรูปแบบ "<key>=<value>" เป็นอาร์กิวเมนต์
แท็ก: changes_inputs
ค่าเริ่มต้น --[no]incompatible_default_to_explicit_init_py: "เท็จ"
แฟล็กนี้เปลี่ยนลักษณะการทำงานเริ่มต้นเพื่อไม่ให้สร้างไฟล์ __init__.py โดยอัตโนมัติในไฟล์การเรียกใช้ของเป้าหมาย Python อีกต่อไป แม่นยำเมื่อเป้าหมาย py_binary หรือ py_test ตั้งค่า legacy_create_init เป็น "auto" (ค่าเริ่มต้น) ระบบจะถือว่าเป็น "เท็จ" เมื่อมีการตั้งค่าแฟล็กนี้เท่านั้น ดู https://github.com/bazelbuild/bazel/issues/10076
แท็ก: affects_outputs incompatible_change
ค่าเริ่มต้น --[no]incompatible_py2_outputs_are_suffixed: "true"
หากเป็นจริง เป้าหมายที่สร้างในการกำหนดค่า Python 2 จะปรากฏภายใต้รูทเอาต์พุตที่มีคำต่อท้าย "-py2" ขณะที่เป้าหมายที่สร้างขึ้นสำหรับ Python 3 จะปรากฏในรูทที่ไม่มีส่วนต่อท้ายที่เกี่ยวข้องกับ Python ซึ่งหมายความว่าลิงก์สัญลักษณ์ความสะดวก "bazel-bin" จะชี้ไปยังเป้าหมาย Python 3 แทนที่จะเป็น Python 2 หากคุณเปิดใช้ตัวเลือกนี้ ขอแนะนำให้เปิดใช้ "--incompatible_py3_is_default" ด้วย
แท็ก: affects_outputs incompatible_change
ค่าเริ่มต้น --[no]incompatible_py3_is_default: "true"
หากเป็นจริง เป้าหมาย "py_binary" และ "py_test" ที่ไม่ได้ตั้งค่าแอตทริบิวต์ "python_version" (หรือ "default_python_version") จะมีค่าเริ่มต้นเป็น PY3 แทนที่จะเป็น PY2 หากตั้งค่าแฟล็กนี้ ขอแนะนำให้ตั้งค่า "--incompatible_py2_outputs_are_suffixed"
แท็ก: loading_and_analysis, affects_outputs, incompatible_change
ค่าเริ่มต้น --[no]incompatible_use_python_toolchains: "true"
หากตั้งค่าเป็น "จริง" กฎ Python ในเครื่องที่เป็นไฟล์ปฏิบัติการจะใช้รันไทม์ของ Python ที่ระบุโดย Toolchain ของ Python แทนรันไทม์ที่มาจากแฟล็กเดิม เช่น --python_top
แท็ก: loading_and_analysis incompatible_change
ค่าเริ่มต้น --python_version=<PY2 or PY3>: ดูคำอธิบาย
โหมดเวอร์ชันหลักของ Python ไม่ว่าจะเป็น "PY2" หรือ "PY3" โปรดทราบว่าเป้าหมาย "py_binary" และ "py_test" จะลบล้างค่านี้ (แม้ว่าจะไม่ได้ระบุเวอร์ชันอย่างชัดเจน) จึงมักไม่มีเหตุผลที่จะต้องระบุแฟล็กนี้
แท็ก: loading_and_analysis affects_outputs
ค่าเริ่มต้นของ --target_pattern_file=<a string>: ""
ถ้ามีการตั้งค่า บิลด์จะอ่านรูปแบบจากไฟล์ที่มีชื่อที่นี่ แทนที่จะเป็นบรรทัดคำสั่ง การระบุไฟล์ที่นี่ รวมถึงรูปแบบบรรทัดคำสั่งเป็นข้อผิดพลาด
แท็ก: changes_inputs
ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
ค่าเริ่มต้น --experimental_remote_cache_eviction_retries=<an integer>: "0"
จำนวนครั้งสูงสุดที่จะลองอีกครั้งหากบิลด์พบข้อผิดพลาดในการกำจัดแคชระยะไกล ค่าที่ไม่ใช่ 0 จะมีการตั้งค่าโดยปริยาย --incompatible_remote_use_new_exit_code_for_lost_inputs เป็น "จริง" ระบบจะสร้างรหัสคำขอใหม่สำหรับการพยายามแต่ละครั้ง หากคุณสร้างรหัสคำขอและส่งให้กับ Bazel โดยใช้ --invocation_id คุณไม่ควรใช้แฟล็กนี้ แต่ให้ตั้งค่าสถานะ --incompatible_remote_use_new_exit_code_for_lost_inputs แล้วตรวจสอบโค้ดสำหรับออก 39
แท็ก: execution
ค่าเริ่มต้น --[no]incompatible_remote_use_new_exit_code_for_lost_inputs: "true"
หากตั้งค่าเป็น "จริง" Bazel จะใช้โค้ดสำหรับออกใหม่ 39 แทน 34 หากแคชระยะไกลนำ BLOB ออกระหว่างบิลด์
แท็ก: incompatible_change
ตัวเลือกเบ็ดเตล็ด ที่จัดหมวดหมู่ไว้ไม่ได้:
ค่าเริ่มต้น --[no]allow_analysis_cache_discard: "true"
หากทิ้งแคชการวิเคราะห์เนื่องจากการเปลี่ยนแปลงในระบบบิลด์ การตั้งค่าตัวเลือกนี้เป็น "เท็จ" จะทำให้ระบบออก bazel แทนที่จะดำเนินการต่อด้วยบิลด์ ตัวเลือกนี้ไม่มีผลเมื่อ "discard_analysis_cache" ก็มีการตั้งค่าเช่นกัน
แท็ก: eagerness_to_exit
ค่าเริ่มต้น --[no]build_manual_tests: "เท็จ"
บังคับใช้เป้าหมายการทดสอบที่ติดแท็ก "ด้วยตนเอง" ให้เกิดขึ้นจริง "ด้วยตนเอง" การทดสอบจะไม่รวมอยู่ในการประมวลผล ตัวเลือกนี้จะบังคับให้ระบบสร้างรายงาน (แต่ไม่ต้องดำเนินการ)
ค่าเริ่มต้นของ --build_tag_filters=<comma-separated list of options>: ""
ระบุรายการแท็กที่คั่นด้วยคอมมา แต่ละแท็กสามารถขึ้นต้นด้วย "-" หรือไม่ก็ได้ เพื่อระบุแท็กที่ยกเว้น ระบบจะสร้างเฉพาะเป้าหมายเหล่านั้นซึ่งมีแท็กที่รวมอยู่อย่างน้อย 1 แท็กและไม่มีแท็กที่ยกเว้น ตัวเลือกนี้ไม่มีผลกับชุดการทดสอบที่ดำเนินการด้วยคำสั่ง "test" (ทดสอบ) คำสั่ง; การควบคุมเหล่านั้นจะอยู่ภายใต้ตัวเลือกการกรองทดสอบ เช่น "--test_tag_filters"
ค่าเริ่มต้น --[no]build_tests_only: "เท็จ"
หากระบุ ระบบจะสร้างเฉพาะกฎ *_test และ test_suite และจะไม่สนใจเป้าหมายอื่นๆ ที่ระบุในบรรทัดคำสั่ง โดยค่าเริ่มต้น ทุกอย่างที่ขอจะได้รับการสร้าง
--[no]cache_test_results [-t] ค่าเริ่มต้น: "อัตโนมัติ"
หากตั้งค่าเป็น "อัตโนมัติ" Bazel จะทำการทดสอบอีกครั้งเฉพาะในกรณีต่อไปนี้ (1) Bazel ตรวจพบการเปลี่ยนแปลงในการทดสอบหรือทรัพยากร Dependency (2) การทดสอบได้รับการทำเครื่องหมายว่าเป็นภายนอก (3) มีการขอทำการทดสอบหลายครั้งด้วย --runs_per_test หรือ(4) การทดสอบล้มเหลวก่อนหน้านี้ หากตั้งค่าเป็น "ใช่" Bazel จะแคชผลการทดสอบทั้งหมด ยกเว้นการทดสอบที่ทำเครื่องหมายว่าภายนอก หากตั้งค่าเป็น "ไม่" Bazel จะไม่แคชผลการทดสอบใดๆ
ค่าเริ่มต้น --[no]compile_one_dependency: "เท็จ"
คอมไพล์ทรัพยากร Dependency เดียวของไฟล์อาร์กิวเมนต์ วิธีนี้มีประโยชน์ในการตรวจสอบไฟล์แหล่งที่มาใน IDE เช่น การสร้างเป้าหมายเดี่ยวขึ้นมาใหม่ให้อาศัยไฟล์ต้นฉบับ เพื่อตรวจหาข้อผิดพลาดให้เร็วที่สุดในรอบการแก้ไข/สร้าง/ทดสอบ อาร์กิวเมนต์นี้จะส่งผลต่อวิธีการตีความอาร์กิวเมนต์แบบไม่แจ้งทั้งหมด แทนที่จะกำหนดเป้าหมายในการสร้างเป็นชื่อไฟล์ต้นฉบับ สำหรับชื่อไฟล์ต้นฉบับแต่ละชื่อไฟล์ จะมีเป้าหมายที่กำหนดเองที่ขึ้นอยู่กับไฟล์ดังกล่าว
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --deleted_packages=<comma-separated list of package names> รายการ
รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริงแม้ว่าจะปรากฏอยู่ที่ใดที่หนึ่งบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ เช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์ ระบบบิลด์อาจบ่นหากพบป้ายกำกับ "//x:y/z" ถ้ามีข้อมูลระบุโดยรายการpackage_path อื่นอยู่ การระบุ --deleted_packages x/y ช่วยป้องกันปัญหานี้
ค่าเริ่มต้น --[no]discard_analysis_cache: "เท็จ"
ทิ้งแคชการวิเคราะห์ทันทีหลังจากที่ขั้นตอนการวิเคราะห์เสร็จสมบูรณ์แล้ว ลดการใช้งานหน่วยความจำประมาณ 10% แต่ทำให้บิลด์เพิ่มเติมช้าลง
ค่าเริ่มต้น --execution_log_binary_file=<a path>: ดูคำอธิบาย
บันทึกการสร้างที่เรียกใช้ลงในไฟล์นี้เป็นโปรโตคอลของ SpawnExec ที่คั่นด้วยความยาว ตามข้อมูลใน src/main/prodbuf/spawn.protocol แฟล็กที่เกี่ยวข้อง: --execution_log_json_file (รูปแบบข้อความ JSON แยกกัน), --execution_log_sort (ไม่ว่าจะจัดเรียงบันทึกการดำเนินการหรือไม่), --subcommands (สำหรับการแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
ค่าเริ่มต้น --execution_log_json_file=<a path>: ดูคำอธิบาย
บันทึกการสร้างที่เรียกใช้ลงในไฟล์นี้เป็นการแสดง JSON ของ SpawnExec ที่คั่นด้วยการขึ้นบรรทัดใหม่ ตามข้อมูลใน src/main/protobuf/spawn.proto แฟล็กที่เกี่ยวข้อง: --execution_log_binary_file (รูปแบบไบนารี Protobuf, แยกเฉพาะ), --execution_log_sort (ไม่ว่าจะจัดเรียงบันทึกการดำเนินการหรือไม่), --subcommands (สำหรับการแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
ค่าเริ่มต้น --[no]execution_log_sort: "true"
เลือกว่าจะจัดเรียงบันทึกการดำเนินการหรือไม่ เพื่อให้เปรียบเทียบบันทึกระหว่างการเรียกใช้ได้ง่ายขึ้น ตั้งค่าเป็น "เท็จ" เพื่อหลีกเลี่ยงการใช้ CPU และหน่วยความจำที่อาจเกิดขึ้นอย่างมากเมื่อสิ้นสุดการเรียกใช้ โดยสร้างบันทึกในลำดับการดำเนินการแบบไม่กำหนดทิศทาง ใช้กับรูปแบบไบนารีและ JSON เท่านั้น ระบบจะไม่จัดเรียงรูปแบบกะทัดรัด
ค่าเริ่มต้น --[no]expand_test_suites: "true"
ขยายเป้าหมาย test_suite ไปยังการทดสอบส่วนประกอบก่อนการวิเคราะห์ เมื่อเปิดธงนี้ (ค่าเริ่มต้น) ระบบจะใช้รูปแบบเป้าหมายเชิงลบกับการทดสอบที่เป็นของชุดทดสอบ มิฉะนั้น ระบบจะไม่ใช้รูปแบบเป้าหมายเชิงลบ การปิดแฟล็กนี้มีประโยชน์เมื่อใช้ระดับบนสุดในบรรทัดคำสั่ง จากนั้นผู้ใช้จึงวิเคราะห์เป้าหมาย test_suite ได้
แท็ก: loading_and_analysis
ค่าเริ่มต้น --[no]experimental_cancel_concurrent_tests: "เท็จ"
หากเป็น "จริง" Blaze จะยกเลิกการทดสอบพร้อมกันในการรันที่สำเร็จครั้งแรก วิธีนี้จะมีประโยชน์เมื่อใช้ร่วมกับ --runs_per_test_detects_flakes เท่านั้น
แท็ก: affects_outputs loading_and_analysis
ค่าเริ่มต้น --experimental_execution_log_compact_file=<a path>: ดูคำอธิบาย