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

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
Tags: 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
ตัวเลือกที่มีผลต่อความเคร่งครัดในการบังคับใช้อินพุตบิลด์ที่ถูกต้อง (เช่น คำจำกัดความของกฎ ชุดค่าผสม Flag ฯลฯ)
ค่าเริ่มต้น --[no]check_bzl_visibility: "true"
หากปิดใช้ ระบบจะลดระดับข้อผิดพลาดในการแสดงการโหลด .bzl ให้มีคำเตือน
แท็ก: build_file_semantics
ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ API ของบิลด์ที่เข้าถึงไฟล์ 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 อาจเรียกใช้ในระหว่างการประเมินระดับบนสุดเพื่อตั้งค่าการแสดงผลไว้เพื่อจุดประสงค์ในคำสั่ง talk()
แท็ก: 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 ในคำสั่ง remove()
แท็ก: 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: "เท็จ"
หากเปิดใช้ไว้ โมดูลรุ่นทดลอง_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: "เท็จ"
หากตั้งค่าเป็น "จริง" Repository_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 ในเครื่องมือสร้างทั้งหมด องค์ประกอบต้องเปลี่ยนแปลงไม่ได้ แต่ที่ผ่านมาเครื่องมือสร้าง 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 จะไม่แสดงรายการจาก linking_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: "เท็จ"
หากตั้งค่าเป็น "จริง" ให้ปิดความสามารถในการเข้าถึงผู้ให้บริการในออบเจ็กต์ "target" ผ่านไวยากรณ์ในช่อง ใช้ไวยากรณ์คีย์ผู้ให้บริการแทน เช่น ลองใช้ "ctx.attr.dep[MyInfo]" แทนการใช้ "ctx.attr.dep.my_info" เพื่อเข้าถึง "my_info" จากภายในฟังก์ชันการใช้งานกฎ ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/9014
แท็ก: build_file_semantics, incompatible_change
ค่าเริ่มต้น --[no]incompatible_disallow_empty_glob: "เท็จ"
หากตั้งค่าเป็น "จริง" ค่าเริ่มต้นของอาร์กิวเมนต์ "allow_available" ของ glob() จะเป็น "เท็จ"
แท็ก: 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 = True" จะใช้สภาพแวดล้อมที่ได้รับจากสภาพแวดล้อม 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: "เท็จ"
หากตั้งค่าเป็น "จริง" ระบบจะปิดใช้พารามิเตอร์ "outputs" ของฟังก์ชัน "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 ระบบจะปิดเครื่องมือดึงข้อมูลเก่าของ linked_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_protocol ของ Struct ซึ่งทําให้เนมสเปซของช่อง 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 จะทิ้งสถานะในหน่วยความจำจากบิลด์นี้เมื่อบิลด์เสร็จสิ้น การสร้างครั้งต่อๆ ไปจะไม่มีส่วนเพิ่มที่เกี่ยวข้องกับรุ่นนี้
แท็ก: 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_คีย์เวิร์ด ใช้สำหรับโอเปอเรเตอร์บริการ 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_filesets
แท็ก: 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: "เท็จ"
รวมแอตทริบิวต์ "out" เพิ่มเติมในเหตุการณ์การดำเนินการที่มีเส้นทางการดำเนินการไปยังเอาต์พุตหลักของการดำเนินการ
แท็ก: 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"
ใช้พารามิเตอร์นี้เพื่อระงับการสร้างฟิลด์ _outputs เดิมในเหตุการณ์ TargetComplete ต้องใช้คีย์นี้สำหรับการผสานรวม 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 ทำการเพิ่มประสิทธิภาพหลายรายการตาม TTL ของ Blob เช่น ไม่ได้เรียกใช้ 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>: ดูคำอธิบาย
URL ปลายทางของ 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.protocol
ค่าเริ่มต้น --[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 เพื่อปรับปรุงความเร็วในการตรวจสอบการเข้าถึงแคชระยะไกล การพิมพ์พื้นที่หน่วยความจำของแคชจะควบคุมโดย --experimental_remote_merkle_tree_cache_size
ค่าเริ่มต้น --experimental_remote_merkle_tree_cache_size=<a long integer>: "1000"
จำนวนต้น Merkle ที่ต้องบันทึกเพื่อปรับปรุงความเร็วในการตรวจสอบการเข้าถึงแคชระยะไกล แม้ว่าแคชจะถูกตัดทอนโดยอัตโนมัติตามการจัดการการอ้างอิงแบบซอฟต์ของ Java แต่ข้อผิดพลาดจากหน่วยความจำไม่เพียงพอก็อาจเกิดขึ้นได้หากตั้งค่าสูงเกินไป หากตั้งค่าเป็น 0 ระบบจะไม่จำกัดขนาดของแคช ค่าที่ดีที่สุดจะแตกต่างกันไปตามขนาดของโปรเจ็กต์ โดยมีค่าเริ่มต้นเป็น 1,000
ค่าเริ่มต้น --experimental_remote_output_service=<a string>: ดูคำอธิบาย
HOST หรือ HOST:PORT ของปลายทางบริการเอาต์พุตระยะไกล สคีมาที่รองรับ ได้แก่ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (ซ็อกเก็ต UNIX ในเครื่อง) หากไม่ได้ระบุสคีมา Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุ grpc:// หรือ unix: สคีมาเพื่อปิดใช้ TLS
ค่าเริ่มต้นของ --experimental_remote_output_service_output_path_prefix=<a string>: ""
เส้นทางการวางเนื้อหาของไดเรกทอรีเอาต์พุตที่จัดการโดย --experimental_remote_output_service ไดเรกทอรีเอาต์พุตจริงที่บิลด์ใช้จะเป็นรายการสืบทอดของเส้นทางนี้และกำหนดโดยบริการเอาต์พุต
ค่าเริ่มต้น --[no]experimental_remote_require_cached: "เท็จ"
หากตั้งค่าเป็น "จริง" ให้บังคับใช้การแคชการดำเนินการทั้งหมดที่เรียกใช้จากระยะไกลได้ ไม่เช่นนั้นจะทำให้บิลด์ใช้งานไม่ได้ วิธีนี้มีประโยชน์ในการแก้ปัญหาที่ไม่ได้กำหนดกระบวนการ เนื่องจากจะช่วยให้ตรวจสอบได้ว่าการดำเนินการที่ควรแคชมีการแคชไว้จริงๆ หรือไม่ โดยไม่ต้องแทรกผลลัพธ์ใหม่ลงในแคชอย่างจงใจ
ค่าเริ่มต้น --experimental_remote_scrubbing_config=<Converts to a Scrubber>: ดูคำอธิบาย
เปิดใช้การสครับคีย์แคชระยะไกลด้วยไฟล์การกำหนดค่าที่มีให้ ซึ่งต้องเป็นบัฟเฟอร์โปรโตคอลในรูปแบบข้อความ (ดูที่ src/main/protocolbuf/remote_scrubbing.protocol) ฟีเจอร์นี้มีไว้เพื่ออำนวยความสะดวกในการแชร์แคชระยะไกล/ดิสก์ระหว่างการดำเนินการที่ดำเนินการบนแพลตฟอร์มอื่นแต่กำหนดเป้าหมายไปยังแพลตฟอร์มเดียวกัน ควรใช้ด้วยความระมัดระวังอย่างยิ่ง เนื่องจากการตั้งค่าที่ไม่เหมาะสมอาจทำให้เกิดการแชร์รายการแคชโดยไม่ได้ตั้งใจและส่งผลให้เกิดการสร้างที่ไม่ถูกต้อง การสครับไม่มีผลต่อวิธีเรียกใช้การดำเนินการ แต่มีเพียงวิธีการคำนวณคีย์แคชระยะไกล/ดิสก์เพื่อวัตถุประสงค์ในการเรียกข้อมูลหรือจัดเก็บผลลัพธ์การดำเนินการเท่านั้น การดำเนินการแบบสครับใช้กับการดำเนินการระยะไกลไม่ได้ และจะทำงานในเครื่องแทนเสมอ การแก้ไขการกำหนดค่าการสครับจะไม่ทำให้เอาต์พุตที่มีอยู่ในระบบไฟล์ในเครื่องหรือแคชภายในเป็นโมฆะ จำเป็นต้องใช้บิลด์ที่สะอาดเพื่อดำเนินการใหม่ที่ได้รับผลกระทบ เพื่อให้สามารถใช้ฟีเจอร์นี้ได้สำเร็จ คุณอาจต้องตั้งค่า --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 (เช่น บันทึกการทดสอบและโปรไฟล์การจับเวลา) ระบบจะใช้รูปแบบ bytesstream:// กับ 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 (ซ็อกเก็ต UNIX ในเครื่อง) หากไม่ได้ระบุสคีมา 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 valid Java regular expression> รายการ
บังคับให้ดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลที่มีเส้นทางตรงกับรูปแบบนี้ โดยไม่คำนึงถึง --remote_download_outputs คุณสามารถระบุรูปแบบได้หลายรูปแบบด้วยการตั้งค่าสถานะนี้ซ้ำ
แท็ก: 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>: ""
ค่าที่จะส่งผ่านเป็นinstance_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: ปัจจุบันแฟล็กนี้ยังไม่เป็นแบบ 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
ค่าเริ่มต้น --[no]incompatible_disable_native_repo_rules: "เท็จ"
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก: 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, refresh 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 เก่า) หลังจาก GC เต็ม <count> รายการติดต่อกันภายใน <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 เดียวกัน
ค่าเริ่มต้น --experimental_worker_for_repo_fetching=<off, platform, virtual or auto>: "อัตโนมัติ"
โหมดการแยกชุดข้อความที่ใช้สำหรับการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท หรือใช้เธรดผู้ปฏิบัติงานเสมือนแทน
ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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
ค่าเริ่มต้น --[no]incompatible_disable_native_repo_rules: "เท็จ"
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก: 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 ใดๆ ส่วน "conservative" (ค่าเริ่มต้น) หมายความว่าจะมีการเพิ่มทรัพยากร Dependency ที่ประกาศทั้งหมด ไม่ว่าจะได้รับคลาสกฎของทรัพยากร Dependency โดยตรงหรือไม่ ส่วน "precise" หมายความว่ามีการเพิ่มเฉพาะด้านที่อาจทำงานอยู่เท่านั้นตามคลาสกฎของทรัพยากร Dependency โดยตรง โปรดทราบว่าโหมดแม่นยำต้องมีการโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียว ซึ่งจะทำให้ช้ากว่าโหมดอื่นๆ และโปรดทราบด้วยว่า โหมดแม้กระทั่งที่แม่นยำก็ไม่ได้แม่นยำทั้งหมด การตัดสินใจว่าจะคำนวณด้านใดด้านหนึ่งหรือไม่จะทำในขั้นตอนการวิเคราะห์ ซึ่งจะไม่ทำงานระหว่าง "การค้นหาแบบงัดแงะ"
แท็ก: build_file_semantics
ค่าเริ่มต้น --[no]consistent_labels: "เท็จ"
หากเปิดใช้ คำสั่งการค้นหาทุกคำสั่งจะปล่อยป้ายกำกับราวกับว่าฟังก์ชัน Starlark <code>str</code> ใช้กับอินสแตนซ์ <code>Label</code> ซึ่งมีประโยชน์สำหรับเครื่องมือที่จำเป็นต้องจับคู่เอาต์พุตของคำสั่งการค้นหาและ/หรือป้ายกำกับต่างๆ ที่กฎเรียกใช้ หากไม่เปิดใช้ ตัวจัดรูปแบบเอาต์พุตจะแสดงชื่อที่เก็บที่ชัดเจน (สัมพันธ์กับที่เก็บหลัก) แทนเพื่อทำให้เอาต์พุตอ่านได้ง่ายขึ้น
แท็ก: terminal_output
ค่าเริ่มต้น --[no]experimental_explicit_aspects: "เท็จ"
aquery, cquery: จะรวมการดำเนินการที่สร้างขึ้นในเอาต์พุตหรือไม่ คำค้นหา: no-op (ติดตามเสมอ)
แท็ก: 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 ที่การค้นหาทำงาน ทรัพยากร Dependency โดยนัยคือทรัพยากรที่ไม่มีการระบุอย่างชัดแจ้งในไฟล์ BUILD แต่เพิ่มโดย Bazel สำหรับ cquery ตัวเลือกนี้จะควบคุมการกรอง Toolchain ที่มีการแก้ปัญหาแล้ว
แท็ก: build_file_semantics
ค่าเริ่มต้น --[no]include_artifacts: "true"
ประกอบด้วยชื่อของอินพุตและเอาต์พุตการดำเนินการในเอาต์พุต (ซึ่งอาจมีขนาดใหญ่)
แท็ก: terminal_output
ค่าเริ่มต้น --[no]include_aspects: "true"
aquery, cquery: จะรวมการดำเนินการที่สร้างขึ้นในเอาต์พุตหรือไม่ คำค้นหา: no-op (ติดตามเสมอ)
แท็ก: 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 ค่า ระบบจะไม่สนใจค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้ใช้ได้กับ "ข้อความค้นหา" เท่านั้น (ไม่ใช่ "cquery")
แท็ก: loading_and_analysis
ค่าเริ่มต้น --[no]line_terminator_null: "เท็จ"
กำหนดว่าแต่ละรูปแบบจะสิ้นสุดด้วย \0 แทนการขึ้นบรรทัดใหม่หรือไม่
แท็ก: terminal_output
ค่าเริ่มต้น --[no]nodep_deps: "true"
หากเปิดใช้ ระบบจะรวม Dep จากแอตทริบิวต์ "nodep" ไว้ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ตัวอย่างทั่วไปของแอตทริบิวต์ "nodep" คือ "ระดับการเข้าถึง" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ "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=prod
แท็ก: 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 ใน "การกำหนดค่าการดำเนินการ" จะไม่รวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน เอดจ์ของ "การกำหนดค่าผู้ดำเนินการ" เช่น กฎจากกฎ "protocol_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, refresh 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 เก่า) หลังจาก GC เต็ม <count> รายการติดต่อกันภายใน <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 เดียวกัน
ค่าเริ่มต้น --experimental_worker_for_repo_fetching=<off, platform, virtual or auto>: "อัตโนมัติ"
โหมดการแยกชุดข้อความที่ใช้สำหรับการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท หรือใช้เธรดผู้ปฏิบัติงานเสมือนแทน
ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --override_repository=<an equals-separated mapping of repository name to path> รายการ
ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์จะใช้ตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางดังกล่าวจะสัมพัทธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานข้อมูลของ Bazel"
ตัวเลือกที่ควบคุมการทำงานของบิลด์:
กำหนดว่าจะเรียกใช้ระบบไฟล์โดยตรงเพื่อสร้างต้นไม้ลิงก์สัญลักษณ์หรือไม่
แท็ก: 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
ค่าเริ่มต้น --[no]incompatible_modify_execution_info_additive: "เท็จ"
เมื่อเปิดใช้ การส่งผ่าน Flag --modify_execution_info หลายรายการจะเป็นส่วนเสริม เมื่อปิดใช้ ระบบจะพิจารณาเฉพาะธงล่าสุดเท่านั้น
แท็ก: execution, affects_outputs, loading_and_analysis, 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=ProcessDatabinding=worker
--strategy=Aapt2Optimize=worker{/--internal_persistent_busybox_tools
--internal_persistent_busybox_tools



--strategy=AndroidManifestMerger=worker--strategy=AARGenerator=worker--strategy=GenerateDataBindingBaseClasses=workerhost_machine_resource_optimizationsexecution
--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{/7/2}
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers{/7/2}

--modify_execution_info=AARGenerator=+supports-multiplex-workershost_machine_resource_optimizationsexecution
--persistent_multiplex_android_tools
เปิดใช้เครื่องมือ Android แบบต่อเนื่องและแบบมัลติเพล็กซ์ (Dexing, De หากไม่ต้องการ, การประมวลผลทรัพยากร)
ขยายเป็น
  --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"
ป้ายกำกับของแพ็กเกจข้ามเครื่องมือที่จะใช้ในกฎของ 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 ตามเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมายได้ เราจะพิจารณาเชนเครื่องมือเหล่านี้ก่อนการประกาศในไฟล์ 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> ค่าเริ่มต้น: "@bazel_tools//tools:host_platform"
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายระบบโฮสต์
แท็ก: 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>: ดูคำอธิบาย
เส้นทางสัมบูรณ์ของล่าม 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 ของ Runfiles สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้เขียนเมื่อต้องใช้การดำเนินการในเครื่อง ทดสอบ หรือเรียกใช้คำสั่งเท่านั้น
แท็ก: 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_proto_library สร้างขึ้น
แท็ก: affects_outputs, loading_and_analysis
ค่าเริ่มต้น --[no]experimental_proto_descriptor_sets_include_source_info: "เท็จ"
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันอื่นใน proto_library
แท็ก: affects_outputs, loading_and_analysis, experimental
ค่าเริ่มต้น --[no]experimental_proto_extra_actions: "เท็จ"
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันอื่นใน proto_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' เพื่อเปิดใช้งานทุกโหมด และ 'no' เพื่อปิดใช้งานทุกโหมด
แท็ก: 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 และลิงก์จะสร้างไฟล์ปฏิบัติการที่ไม่ขึ้นอยู่กับตำแหน่ง ("-พาย")
แท็ก: 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> รายการ
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง Swift สำหรับเครื่องมือผู้บริหาร
แท็ก: 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 สำหรับการกำหนดค่าการดำเนินการ
แท็ก: 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"
เลิกใช้งานแล้ว และมีผลแทนด้วย --incompatible_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 ย่อมาจาก "รวมและยกเว้น" รูปแบบนิพจน์ทั่วไป ตัวเลือก_1 ถึง "ตัวเลือก_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 ไฟล์ ได้แก่ โปรไฟล์ CC และโปรไฟล์ ld แฟล็กนี้ยอมรับป้ายกำกับบิลด์ซึ่งต้องอ้างถึงไฟล์อินพุตโปรไฟล์ใบพัด ตัวอย่างเช่น ไฟล์ BUILD ที่กำหนดป้ายกำกับใน a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)อาจต้องเพิ่มคำสั่ง Export_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>: ดูคำอธิบาย
คำนำหน้าที่จะแทรกไว้หน้าไฟล์ปฏิบัติการสำหรับคำสั่ง "test" และ "run" หากค่าคือ "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"
แท็ก: 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
ตัวเลือกที่มีผลต่อความเคร่งครัดในการบังคับใช้อินพุตบิลด์ที่ถูกต้อง (เช่น คำจำกัดความของกฎ ชุดค่าผสม Flag ฯลฯ)
ค่าเริ่มต้นของ --auto_cpu_environment_group=<a build target label>: ""
ประกาศชื่อ "สภาพแวดล้อม_กลุ่ม" เพื่อใช้แมปค่า 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"
กำหนดว่าจะ Dexugar ไบต์โค้ด 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
หากเป็น "จริง" ให้กำหนดค่าเริ่มต้นเป็น "จริง" สำหรับแอตทริบิวต์เชื่อมต่อตลอดเวลาใน objc_library และ objc_IMPORT
แท็ก: build_file_semantics, incompatible_change
ค่าเริ่มต้น --[no]incompatible_python_disallow_native_rules: "เท็จ"
เมื่อเป็นจริง ระบบจะแสดงข้อผิดพลาดเมื่อใช้กฎ py_* ในตัว คุณจึงควรใช้กฎ "rule_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 หรืออาจตามด้วย [-|*]<Float> (เช่น 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 ใดๆ ส่วน "conservative" (ค่าเริ่มต้น) หมายความว่าจะมีการเพิ่มทรัพยากร Dependency ที่ประกาศทั้งหมด ไม่ว่าจะได้รับคลาสกฎของทรัพยากร Dependency โดยตรงหรือไม่ ส่วน "precise" หมายความว่ามีการเพิ่มเฉพาะด้านที่อาจทำงานอยู่เท่านั้นตามคลาสกฎของทรัพยากร Dependency โดยตรง โปรดทราบว่าโหมดแม่นยำต้องมีการโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียว ซึ่งจะทำให้ช้ากว่าโหมดอื่นๆ และโปรดทราบด้วยว่า โหมดแม้กระทั่งที่แม่นยำก็ไม่ได้แม่นยำทั้งหมด การตัดสินใจว่าจะคำนวณด้านใดด้านหนึ่งหรือไม่จะทำในขั้นตอนการวิเคราะห์ ซึ่งจะไม่ทำงานระหว่าง "การค้นหาแบบงัดแงะ"
แท็ก: build_file_semantics
ค่าเริ่มต้น --[no]consistent_labels: "เท็จ"
หากเปิดใช้ คำสั่งการค้นหาทุกคำสั่งจะปล่อยป้ายกำกับราวกับว่าฟังก์ชัน Starlark <code>str</code> ใช้กับอินสแตนซ์ <code>Label</code> ซึ่งมีประโยชน์สำหรับเครื่องมือที่จำเป็นต้องจับคู่เอาต์พุตของคำสั่งการค้นหาและ/หรือป้ายกำกับต่างๆ ที่กฎเรียกใช้ หากไม่เปิดใช้ ตัวจัดรูปแบบเอาต์พุตจะแสดงชื่อที่เก็บที่ชัดเจน (สัมพันธ์กับที่เก็บหลัก) แทนเพื่อทำให้เอาต์พุตอ่านได้ง่ายขึ้น
แท็ก: terminal_output
ค่าเริ่มต้น --[no]experimental_explicit_aspects: "เท็จ"
aquery, cquery: จะรวมการดำเนินการที่สร้างขึ้นในเอาต์พุตหรือไม่ คำค้นหา: no-op (ติดตามเสมอ)
แท็ก: 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 ที่การค้นหาทำงาน ทรัพยากร Dependency โดยนัยคือทรัพยากรที่ไม่มีการระบุอย่างชัดแจ้งในไฟล์ BUILD แต่เพิ่มโดย Bazel สำหรับ cquery ตัวเลือกนี้จะควบคุมการกรอง Toolchain ที่มีการแก้ปัญหาแล้ว
แท็ก: build_file_semantics
ค่าเริ่มต้น --[no]include_artifacts: "true"
ประกอบด้วยชื่อของอินพุตและเอาต์พุตการดำเนินการในเอาต์พุต (ซึ่งอาจมีขนาดใหญ่)
แท็ก: terminal_output
ค่าเริ่มต้น --[no]include_aspects: "true"
aquery, cquery: จะรวมการดำเนินการที่สร้างขึ้นในเอาต์พุตหรือไม่ คำค้นหา: no-op (ติดตามเสมอ)
แท็ก: 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 ค่า ระบบจะไม่สนใจค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้ใช้ได้กับ "ข้อความค้นหา" เท่านั้น (ไม่ใช่ "cquery")
แท็ก: loading_and_analysis
ค่าเริ่มต้น --[no]line_terminator_null: "เท็จ"
กำหนดว่าแต่ละรูปแบบจะสิ้นสุดด้วย \0 แทนการขึ้นบรรทัดใหม่หรือไม่
แท็ก: terminal_output
ค่าเริ่มต้น --[no]nodep_deps: "true"
หากเปิดใช้ ระบบจะรวม Dep จากแอตทริบิวต์ "nodep" ไว้ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ตัวอย่างทั่วไปของแอตทริบิวต์ "nodep" คือ "ระดับการเข้าถึง" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ "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=prod
แท็ก: 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 ใน "การกำหนดค่าการดำเนินการ" จะไม่รวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน เอดจ์ของ "การกำหนดค่าผู้ดำเนินการ" เช่น กฎจากกฎ "protocol_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"
การทำงานส่วนใหญ่ทำงานกับไฟล์ 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 แทนรันไทม์ที่กำหนดโดย Flag เดิม เช่น --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"
หากเป็นจริง การทดสอบพิเศษจะทำงานโดยใช้กลยุทธ์แซนด์บ็อกซ์ เพิ่มแท็ก "local" เพื่อบังคับให้ทำการทดสอบพิเศษในเครื่อง
แท็ก: 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" จะลบล้าง Flag นี้
--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>: ดูคำอธิบาย
ระบุไบนารีที่จะใช้เดกซ์โดยไม่ต้องชาร์ดดิ้ง
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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-compiler
แท็ก: affects_outputs, loading_and_analysis
--proto_toolchain_for_cc=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/protocol:cc_toolchain"
ป้ายกำกับของ protocol_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ C++ Proto
แท็ก: affects_outputs, loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/j2objc:j2objc_protocol_toolchain"
ป้ายกำกับของ protocol_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ j2objc Proto
แท็ก: affects_outputs, loading_and_analysis
--proto_toolchain_for_java=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/protocol:java_toolchain"
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ Java Proto
แท็ก: 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" เพื่อใช้การชาร์ดดิ้งเฉพาะในกรณีที่มีแอตทริบิวต์ BUILD "shard_count" เท่านั้น "ปิดใช้" เพื่อไม่ใช้การชาร์ดดิ้งทดสอบ "forced=k" เพื่อบังคับใช้ชาร์ด "k" สำหรับการทดสอบโดยไม่คำนึงถึงแอตทริบิวต์ BUILD "shard_count"
ค่าเริ่มต้นของ --tool_java_language_version=<a string>: ""
เวอร์ชันภาษา Java ที่ใช้เพื่อเรียกใช้เครื่องมือที่จำเป็นระหว่างบิลด์
ค่าเริ่มต้นของ --tool_java_runtime_version=<a string>: "remotejdk_11"
เวอร์ชันรันไทม์ของ Java ที่ใช้เพื่อเรียกใช้เครื่องมือในระหว่างบิลด์
ค่าเริ่มต้น --[no]use_ijars: "true"
หากเปิดใช้ ตัวเลือกนี้จะทำให้การคอมไพล์ Java ใช้ JAR อินเทอร์เฟซ ซึ่งจะทำให้การคอมไพล์แบบเพิ่มขึ้นเรื่อยๆ ได้เร็วขึ้น แต่ข้อความแสดงข้อผิดพลาดอาจแตกต่างกันได้

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

ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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
ค่าเริ่มต้น --[no]incompatible_disable_native_repo_rules: "เท็จ"
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก: 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 และตัวการดำเนินการยังไม่มีแอตทริบิวต์ Container-Image ใน 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 และสิทธิ์ของผู้ใช้ในการเข้าถึงไดเรกทอรีกลุ่ม
แท็ก: 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"
หากตั้งค่าเป็น "จริง" ให้ใช้สัญลักษณ์ชั่วคราวเพื่อจำกัดจำนวนงานที่เกิดขึ้นพร้อมกัน
แท็ก: 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 อาจก่อให้เกิดปัญหาเกี่ยวกับหน่วยความจำ "auto" จะคำนวณค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์
แท็ก: 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" "auto" จะตั้งค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 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" แต่การกลับลำดับคำสั่งซื้อจะต้องเรียกใช้ด้วย "sandboxed"
แท็ก: 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" จะคำนวณค่าเริ่มต้นที่สมเหตุสมผลตามความจุของเครื่อง "=value" จะตั้งค่าเริ่มต้นสำหรับการช่วยจำที่ไม่ระบุ
แท็ก: 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" กับ --worker_multiplex อาจระบุเป็น [name=value] เพื่อให้ค่าที่แตกต่างกันต่อความทรงจำ ขีดจำกัดนี้อิงตามคีย์ผู้ปฏิบัติงาน ซึ่งแตกต่างกันตามการจำ และขึ้นอยู่กับแฟล็กและสภาพแวดล้อมการเริ่มต้นด้วย ดังนั้นในบางกรณีอาจมีผู้ปฏิบัติงานต่อความทรงจำมากกว่าที่แฟล็กนี้ระบุ ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") โดยจะเลือกตามด้วยการดำเนินการ ([-|*]<Float>) เช่น "auto", "HOST_CPUS*.5" "auto" จะคำนวณค่าเริ่มต้นที่สมเหตุสมผลตามความจุของเครื่อง "=value" จะตั้งค่าเริ่มต้นสำหรับการช่วยจำที่ไม่ระบุ
แท็ก: 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: "เท็จ"
หากเปิดใช้ ให้พิมพ์ข้อความแบบละเอียดเมื่อผู้ปฏิบัติงานเริ่มทำงาน ปิดเครื่อง ...
ตัวเลือกที่กำหนดค่าเครื่องมือเชนที่ใช้สำหรับการดำเนินการ
ค่าเริ่มต้นของ --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 มาก่อน นอกจากนี้ some_aspect จะทํางานหลังจากทุกด้านที่จําเป็นที่ระบุไว้โดยต้องระบุแอตทริบิวต์ จากนั้น 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
ตัวเลือกที่มีผลต่อความเคร่งครัดในการบังคับใช้อินพุตบิลด์ที่ถูกต้อง (เช่น คำจำกัดความของกฎ ชุดค่าผสม Flag ฯลฯ)
ค่าเริ่มต้น --[no]experimental_docker_privileged: "เท็จ"
หากเปิดใช้ Bazel จะส่ง Flag --Privileged ไปยัง "docker run" เมื่อเรียกใช้การดำเนินการ การทำงานนี้อาจจำเป็นสำหรับงานสร้างของคุณ แต่ก็อาจส่งผลให้มีเนื้อที่น้อยลงด้วย
แท็ก: execution
ไม่มีการดำเนินการ
แท็ก: host_machine_resource_optimizations, execution
ค่าเริ่มต้น --[no]incompatible_legacy_local_fallback: "เท็จ"
หากตั้งค่าเป็น "จริง" จะเปิดใช้วิดีโอสำรองโดยนัยแบบเดิมจากแซนด์บ็อกซ์เป็นกลยุทธ์ในเครื่อง ท้ายที่สุดแล้ว ธงจะมีค่าเริ่มต้นเป็น false และจะกลายเป็น 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 หรือ API ของบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
ค่าเริ่มต้น --[no]incompatible_config_setting_private_default_visibility: "เท็จ"
หากตัวยึดตำแหน่ง_enforce_config_setting_visibility=false จะหมายความว่าไม่มีการดำเนินการ หรือไม่เช่นนั้น หากแฟล็กนี้เป็นเท็จ 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 สามครั้ง ตัวเลือกนี้ส่งได้หลายครั้ง อาร์กิวเมนต์ที่ส่งผ่านล่าสุดที่ตรงกันจะมีความสำคัญเหนือกว่า หากไม่มีผลลัพธ์ที่ตรงกัน ลักษณะการทำงานจะเหมือนกับ "ค่าเริ่มต้น" ด้านบน
แท็ก: 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, refresh 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 เก่า) หลังจาก GC เต็ม <count> รายการติดต่อกันภายใน <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 ตามด้วย [-|*]<Float> (เช่น 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"
ใช้พารามิเตอร์นี้เพื่อระงับการสร้างฟิลด์ _outputs เดิมในเหตุการณ์ TargetComplete ต้องใช้คีย์นี้สำหรับการผสานรวม 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 อย่าง อย่างแรกคือ เนื้อหารูทของแซนด์บ็อกซ์จะไม่ต้องดำเนินการใดๆ หลังบิลด์ และอย่างที่ 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"
ระบุโหมดเอาต์พุตที่ต้องการ ค่าที่ถูกต้องคือ "สรุป" เพื่อแสดงผลลัพธ์สรุปสถานะการทดสอบเท่านั้น, "ข้อผิดพลาด" เพื่อพิมพ์บันทึกการทดสอบสำหรับการทดสอบที่ล้มเหลวด้วย, "ทั้งหมด" เพื่อพิมพ์บันทึกสำหรับการทดสอบทั้งหมด และ "สตรีม" ไปยังบันทึกเอาต์พุตสำหรับการทดสอบทั้งหมดแบบเรียลไทม์ (ซึ่งจะบังคับให้ดำเนินการทดสอบพร้อมกันในเครื่องโดยไม่คำนึงถึงค่า --test_strategy)
แท็ก: test_runner, terminal_output, execution
ค่าเริ่มต้นของ --test_summary=<short, terse, detailed, none or 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 เดียวกัน
ค่าเริ่มต้น --[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 ทำการเพิ่มประสิทธิภาพหลายรายการตาม TTL ของ Blob เช่น ไม่ได้เรียกใช้ 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>: ดูคำอธิบาย
URL ปลายทางของ 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.protocol
ค่าเริ่มต้น --[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 เพื่อปรับปรุงความเร็วในการตรวจสอบการเข้าถึงแคชระยะไกล การพิมพ์พื้นที่หน่วยความจำของแคชจะควบคุมโดย --experimental_remote_merkle_tree_cache_size
ค่าเริ่มต้น --experimental_remote_merkle_tree_cache_size=<a long integer>: "1000"
จำนวนต้น Merkle ที่ต้องบันทึกเพื่อปรับปรุงความเร็วในการตรวจสอบการเข้าถึงแคชระยะไกล แม้ว่าแคชจะถูกตัดทอนโดยอัตโนมัติตามการจัดการการอ้างอิงแบบซอฟต์ของ Java แต่ข้อผิดพลาดจากหน่วยความจำไม่เพียงพอก็อาจเกิดขึ้นได้หากตั้งค่าสูงเกินไป หากตั้งค่าเป็น 0 ระบบจะไม่จำกัดขนาดของแคช ค่าที่ดีที่สุดจะแตกต่างกันไปตามขนาดของโปรเจ็กต์ โดยมีค่าเริ่มต้นเป็น 1,000
ค่าเริ่มต้น --experimental_remote_output_service=<a string>: ดูคำอธิบาย
HOST หรือ HOST:PORT ของปลายทางบริการเอาต์พุตระยะไกล สคีมาที่รองรับ ได้แก่ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (ซ็อกเก็ต UNIX ในเครื่อง) หากไม่ได้ระบุสคีมา Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุ grpc:// หรือ unix: สคีมาเพื่อปิดใช้ TLS
ค่าเริ่มต้นของ --experimental_remote_output_service_output_path_prefix=<a string>: ""
เส้นทางการวางเนื้อหาของไดเรกทอรีเอาต์พุตที่จัดการโดย --experimental_remote_output_service ไดเรกทอรีเอาต์พุตจริงที่บิลด์ใช้จะเป็นรายการสืบทอดของเส้นทางนี้และกำหนดโดยบริการเอาต์พุต
ค่าเริ่มต้น --[no]experimental_remote_require_cached: "เท็จ"
หากตั้งค่าเป็น "จริง" ให้บังคับใช้การแคชการดำเนินการทั้งหมดที่เรียกใช้จากระยะไกลได้ ไม่เช่นนั้นจะทำให้บิลด์ใช้งานไม่ได้ วิธีนี้มีประโยชน์ในการแก้ปัญหาที่ไม่ได้กำหนดกระบวนการ เนื่องจากจะช่วยให้ตรวจสอบได้ว่าการดำเนินการที่ควรแคชมีการแคชไว้จริงๆ หรือไม่ โดยไม่ต้องแทรกผลลัพธ์ใหม่ลงในแคชอย่างจงใจ
ค่าเริ่มต้น --experimental_remote_scrubbing_config=<Converts to a Scrubber>: ดูคำอธิบาย
เปิดใช้การสครับคีย์แคชระยะไกลด้วยไฟล์การกำหนดค่าที่มีให้ ซึ่งต้องเป็นบัฟเฟอร์โปรโตคอลในรูปแบบข้อความ (ดูที่ src/main/protocolbuf/remote_scrubbing.protocol) ฟีเจอร์นี้มีไว้เพื่ออำนวยความสะดวกในการแชร์แคชระยะไกล/ดิสก์ระหว่างการดำเนินการที่ดำเนินการบนแพลตฟอร์มอื่นแต่กำหนดเป้าหมายไปยังแพลตฟอร์มเดียวกัน ควรใช้ด้วยความระมัดระวังอย่างยิ่ง เนื่องจากการตั้งค่าที่ไม่เหมาะสมอาจทำให้เกิดการแชร์รายการแคชโดยไม่ได้ตั้งใจและส่งผลให้เกิดการสร้างที่ไม่ถูกต้อง การสครับไม่มีผลต่อวิธีเรียกใช้การดำเนินการ แต่มีเพียงวิธีการคำนวณคีย์แคชระยะไกล/ดิสก์เพื่อวัตถุประสงค์ในการเรียกข้อมูลหรือจัดเก็บผลลัพธ์การดำเนินการเท่านั้น การดำเนินการแบบสครับใช้กับการดำเนินการระยะไกลไม่ได้ และจะทำงานในเครื่องแทนเสมอ การแก้ไขการกำหนดค่าการสครับจะไม่ทำให้เอาต์พุตที่มีอยู่ในระบบไฟล์ในเครื่องหรือแคชภายในเป็นโมฆะ จำเป็นต้องใช้บิลด์ที่สะอาดเพื่อดำเนินการใหม่ที่ได้รับผลกระทบ เพื่อให้สามารถใช้ฟีเจอร์นี้ได้สำเร็จ คุณอาจต้องตั้งค่า --host_platform ที่กำหนดเองร่วมกับ --experimental_platform_in_output_dir (เพื่อทำให้คำนำหน้าเอาต์พุตเป็นมาตรฐาน) และ --incompatible_strict_action_env (เพื่อปรับตัวแปรสภาพแวดล้อมให้เป็นมาตรฐาน)
ค่าเริ่มต้น --experimental_worker_for_repo_fetching=<off, platform, virtual or auto>: "อัตโนมัติ"
โหมดการแยกชุดข้อความที่ใช้สำหรับการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท หรือใช้เธรดผู้ปฏิบัติงานเสมือนแทน
ค่าเริ่มต้น --[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 (เช่น บันทึกการทดสอบและโปรไฟล์การจับเวลา) ระบบจะใช้รูปแบบ bytesstream:// กับ 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 (ซ็อกเก็ต UNIX ในเครื่อง) หากไม่ได้ระบุสคีมา 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 valid Java regular expression> รายการ
บังคับให้ดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลที่มีเส้นทางตรงกับรูปแบบนี้ โดยไม่คำนึงถึง --remote_download_outputs คุณสามารถระบุรูปแบบได้หลายรูปแบบด้วยการตั้งค่าสถานะนี้ซ้ำ
แท็ก: 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>: ""
ค่าที่จะส่งผ่านเป็นinstance_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 ระบบจะใช้ค่าของตัวเลือกนี้ในการสร้างตัวกรองโดยอัตโนมัติ ค่าที่อนุญาตคือ "ไม่มี" (ไม่ต้องกรอง / แสดงทุกอย่าง), "ทั้งหมด" (กรองทุกอย่าง / ไม่แสดงรายการ), "แพ็กเกจ" (รวมเอาต์พุตจากกฎในแพ็กเกจที่กล่าวถึงในบรรทัดคำสั่ง Blaze) และ "แพ็กเกจย่อย" (เช่น "แพ็กเกจ" แต่รวมแพ็กเกจย่อยด้วย) สำหรับค่า "packages" และ "subpackages" ถือว่า //java/foo และ //javatests/foo ถือว่าเป็นแพ็กเกจเดียว)
ค่าเริ่มต้น --[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: "เท็จ"
คอมไพล์ไฟล์อาร์กิวเมนต์เดี่ยวๆ วิธีนี้มีประโยชน์ในการตรวจสอบไฟล์แหล่งที่มาใน 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>: ดูคำอธิบาย
บันทึกการสร้างที่สร้างขึ้นลงในไฟล์นี้เป็น Prot ของ SpawnExec ที่คั่นด้วยความยาว ตามข้อมูลใน src/main/protobuf/spawn.protocol แฟล็กที่เกี่ยวข้อง: --execution_log_json_file (รูปแบบข้อความ JSON แยกกัน), --execution_log_sort (ไม่ว่าจะจัดเรียงบันทึกการดำเนินการหรือไม่), --subcommands (สำหรับการแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
ค่าเริ่มต้น --execution_log_json_file=<a path>: ดูคำอธิบาย
บันทึกการสร้างที่เรียกใช้แล้วลงในไฟล์นี้เป็นการแสดง JSON ของ SpawnExec ที่คั่นด้วยการขึ้นบรรทัดใหม่ ตามข้อมูลจาก src/main/prodbuf/spawn.เลือก แฟล็กที่เกี่ยวข้อง: --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 Prot ของ ExecLogEntry ที่คั่นด้วยความยาวตามข้อมูลใน src/main/prodbuf/spawn.proto ไฟล์ทั้งไฟล์ถูกบีบอัดแบบ 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
กำหนดว่าจะเรียกใช้ระบบไฟล์โดยตรงเพื่อสร้างต้นไม้ลิงก์สัญลักษณ์หรือไม่
แท็ก: 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"
หากตั้งค่าเป็น "จริง" ให้ใช้สัญลักษณ์ชั่วคราวเพื่อจำกัดจำนวนงานที่เกิดขึ้นพร้อมกัน
แท็ก: 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
ค่าเริ่มต้น --[no]incompatible_modify_execution_info_additive: "เท็จ"
เมื่อเปิดใช้ การส่งผ่าน Flag --modify_execution_info หลายรายการจะเป็นส่วนเสริม เมื่อปิดใช้ ระบบจะพิจารณาเฉพาะธงล่าสุดเท่านั้น
แท็ก: execution, affects_outputs, loading_and_analysis, 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 อาจก่อให้เกิดปัญหาเกี่ยวกับหน่วยความจำ "auto" จะคำนวณค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์
แท็ก: 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" "auto" จะตั้งค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 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=ProcessDatabinding=worker
--strategy=Aapt2Optimize=worker{/--internal_persistent_busybox_tools
--internal_persistent_busybox_tools



--strategy=AndroidManifestMerger=worker--strategy=AARGenerator=worker--strategy=GenerateDataBindingBaseClasses=workerhost_machine_resource_optimizationsexecution
--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{/7/2}
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers{/7/2}

--modify_execution_info=AARGenerator=+supports-multiplex-workershost_machine_resource_optimizationsexecution
--persistent_multiplex_android_tools
เปิดใช้เครื่องมือ Android แบบต่อเนื่องและแบบมัลติเพล็กซ์ (Dexing, De หากไม่ต้องการ, การประมวลผลทรัพยากร)
ขยายเป็น
  --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" แต่การกลับลำดับคำสั่งซื้อจะต้องเรียกใช้ด้วย "sandboxed"
แท็ก: 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"
ป้ายกำกับของแพ็กเกจข้ามเครื่องมือที่จะใช้ในกฎของ 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 ตามเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมายได้ เราจะพิจารณาเชนเครื่องมือเหล่านี้ก่อนการประกาศในไฟล์ 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> ค่าเริ่มต้น: "@bazel_tools//tools:host_platform"
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายระบบโฮสต์
แท็ก: 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>: ดูคำอธิบาย
เส้นทางสัมบูรณ์ของล่าม 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 ของ Runfiles สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้เขียนเมื่อต้องใช้การดำเนินการในเครื่อง ทดสอบ หรือเรียกใช้คำสั่งเท่านั้น
แท็ก: 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_proto_library สร้างขึ้น
แท็ก: affects_outputs, loading_and_analysis
ค่าเริ่มต้น --[no]experimental_proto_descriptor_sets_include_source_info: "เท็จ"
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันอื่นใน proto_library
แท็ก: affects_outputs, loading_and_analysis, experimental
ค่าเริ่มต้น --[no]experimental_proto_extra_actions: "เท็จ"
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันอื่นใน proto_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' เพื่อเปิดใช้งานทุกโหมด และ 'no' เพื่อปิดใช้งานทุกโหมด
แท็ก: 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 มาก่อน นอกจากนี้ some_aspect จะทํางานหลังจากทุกด้านที่จําเป็นที่ระบุไว้โดยต้องระบุแอตทริบิวต์ จากนั้น 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 และลิงก์จะสร้างไฟล์ปฏิบัติการที่ไม่ขึ้นอยู่กับตำแหน่ง ("-พาย")
แท็ก: 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> รายการ
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง Swift สำหรับเครื่องมือผู้บริหาร
แท็ก: 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 สำหรับการกำหนดค่าการดำเนินการ
แท็ก: 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"
เลิกใช้งานแล้ว และมีผลแทนด้วย --incompatible_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 ย่อมาจาก "รวมและยกเว้น" รูปแบบนิพจน์ทั่วไป ตัวเลือก_1 ถึง "ตัวเลือก_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 ไฟล์ ได้แก่ โปรไฟล์ CC และโปรไฟล์ ld แฟล็กนี้ยอมรับป้ายกำกับบิลด์ซึ่งต้องอ้างถึงไฟล์อินพุตโปรไฟล์ใบพัด ตัวอย่างเช่น ไฟล์ BUILD ที่กำหนดป้ายกำกับใน a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)อาจต้องเพิ่มคำสั่ง Export_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>: ดูคำอธิบาย
คำนำหน้าที่จะแทรกไว้หน้าไฟล์ปฏิบัติการสำหรับคำสั่ง "test" และ "run" หากค่าคือ "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"
แท็ก: 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
ตัวเลือกที่มีผลต่อความเคร่งครัดในการบังคับใช้อินพุตบิลด์ที่ถูกต้อง (เช่น คำจำกัดความของกฎ ชุดค่าผสม Flag ฯลฯ)
ค่าเริ่มต้นของ --auto_cpu_environment_group=<a build target label>: ""
ประกาศชื่อ "สภาพแวดล้อม_กลุ่ม" เพื่อใช้แมปค่า 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"
กำหนดว่าจะ Dexugar ไบต์โค้ด 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 จะหมายความว่าไม่มีการดำเนินการ หรือไม่เช่นนั้น หากแฟล็กนี้เป็นเท็จ 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
หากเป็น "จริง" ให้กำหนดค่าเริ่มต้นเป็น "จริง" สำหรับแอตทริบิวต์เชื่อมต่อตลอดเวลาใน objc_library และ objc_IMPORT
แท็ก: build_file_semantics, incompatible_change
ค่าเริ่มต้น --[no]incompatible_python_disallow_native_rules: "เท็จ"
เมื่อเป็นจริง ระบบจะแสดงข้อผิดพลาดเมื่อใช้กฎ py_* ในตัว คุณจึงควรใช้กฎ "rule_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 หรืออาจตามด้วย [-|*]<Float> (เช่น 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 สามครั้ง ตัวเลือกนี้ส่งได้หลายครั้ง อาร์กิวเมนต์ที่ส่งผ่านล่าสุดที่ตรงกันจะมีความสำคัญเหนือกว่า หากไม่มีผลลัพธ์ที่ตรงกัน ลักษณะการทำงานจะเหมือนกับ "ค่าเริ่มต้น" ด้านบน
แท็ก: 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"
การทำงานส่วนใหญ่ทำงานกับไฟล์ 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 ตามด้วย [-|*]<Float> (เช่น 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"
ใช้พารามิเตอร์นี้เพื่อระงับการสร้างฟิลด์ _outputs เดิมในเหตุการณ์ TargetComplete ต้องใช้คีย์นี้สำหรับการผสานรวม 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"
ระบุโหมดเอาต์พุตที่ต้องการ ค่าที่ถูกต้องคือ "สรุป" เพื่อแสดงผลลัพธ์สรุปสถานะการทดสอบเท่านั้น, "ข้อผิดพลาด" เพื่อพิมพ์บันทึกการทดสอบสำหรับการทดสอบที่ล้มเหลวด้วย, "ทั้งหมด" เพื่อพิมพ์บันทึกสำหรับการทดสอบทั้งหมด และ "สตรีม" ไปยังบันทึกเอาต์พุตสำหรับการทดสอบทั้งหมดแบบเรียลไทม์ (ซึ่งจะบังคับให้ดำเนินการทดสอบพร้อมกันในเครื่องโดยไม่คำนึงถึงค่า --test_strategy)
แท็ก: test_runner, terminal_output, execution
ค่าเริ่มต้นของ --test_summary=<short, terse, detailed, none or 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 แทนรันไทม์ที่กำหนดโดย Flag เดิม เช่น --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: "เท็จ"
คอมไพล์ไฟล์อาร์กิวเมนต์เดี่ยวๆ วิธีนี้มีประโยชน์ในการตรวจสอบไฟล์แหล่งที่มาใน 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>: ดูคำอธิบาย
บันทึกการสร้างที่สร้างขึ้นลงในไฟล์นี้เป็น Prot ของ SpawnExec ที่คั่นด้วยความยาว ตามข้อมูลใน src/main/protobuf/spawn.protocol แฟล็กที่เกี่ยวข้อง: --execution_log_json_file (รูปแบบข้อความ JSON แยกกัน), --execution_log_sort (ไม่ว่าจะจัดเรียงบันทึกการดำเนินการหรือไม่), --subcommands (สำหรับการแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
ค่าเริ่มต้น --execution_log_json_file=<a path>: ดูคำอธิบาย
บันทึกการสร้างที่เรียกใช้แล้วลงในไฟล์นี้เป็นการแสดง JSON ของ SpawnExec ที่คั่นด้วยการขึ้นบรรทัดใหม่ ตามข้อมูลจาก src/main/prodbuf/spawn.เลือก แฟล็กที่เกี่ยวข้อง: --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>: ดูคำอธิบาย
บันทึกการสร้างที่เรียกใช้ลงในไฟล์นี้เป็น ExecLogEntry Prot ของ ExecLogEntry ที่คั่นด้วยความยาวตามข้อมูลใน src/main/prodbuf/spawn.proto ไฟล์ทั้งไฟล์ถูกบีบอัดแบบ 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: "เท็จ"
เลิกใช้งานไปทีละด้าน ตั้งเวลาให้เฉพาะการดำเนินการเพิ่มเติมสำหรับเป้าหมายระดับบนสุดเท่านั้น
ค่าเริ่มต้น --[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 เท่านั้น
ค่าเริ่มต้น --[no]fetch: "true"
อนุญาตให้คำสั่งดึงข้อมูลทรัพยากร Dependency ภายนอก หากตั้งค่าเป็น "เท็จ" คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ และหากไม่มี คำสั่งดังกล่าวจะทำให้การทำงานล้มเหลว
ค่าเริ่มต้น --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"
หากเป็นจริง การทดสอบพิเศษจะทำงานโดยใช้กลยุทธ์แซนด์บ็อกซ์ เพิ่มแท็ก "local" เพื่อบังคับให้ทำการทดสอบพิเศษในเครื่อง
แท็ก: 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" จะลบล้าง Flag นี้
--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 เดิม
ค่าเริ่มต้น --local_termination_grace_seconds=<an integer>: "15"
เวลาที่ต้องรอระหว่างการสิ้นสุดกระบวนการในเครื่องเนื่องจากหมดเวลาและบังคับให้ปิดกระบวนการดังกล่าว
ค่าเริ่มต้น --optimizing_dexer=<a build target label>: ดูคำอธิบาย
ระบุไบนารีที่จะใช้เดกซ์โดยไม่ต้องชาร์ดดิ้ง
ค่าเริ่มต้นของ --package_path=<colon-separated list of options>: "%workspace%"
รายการค้นหาแพ็กเกจที่คั่นด้วยโคลอน องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับพื้นที่ทำงานที่ล้อมรอบอยู่ หากไม่ระบุหรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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-compiler
แท็ก: affects_outputs, loading_and_analysis
--proto_toolchain_for_cc=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/protocol:cc_toolchain"
ป้ายกำกับของ protocol_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ C++ Proto
แท็ก: affects_outputs, loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/j2objc:j2objc_protocol_toolchain"
ป้ายกำกับของ protocol_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ j2objc Proto
แท็ก: affects_outputs, loading_and_analysis
--proto_toolchain_for_java=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/protocol:java_toolchain"
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ Java Proto
แท็ก: 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
ค่าเริ่มต้น --[no]show_loading_progress: "true"
หากเปิดใช้จะทำให้ Bazel พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ:"
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --test_arg=<a string> รายการ
ระบุตัวเลือกและอาร์กิวเมนต์เพิ่มเติมที่ควรส่งไปยังไฟล์ปฏิบัติการทดสอบ ซึ่งสามารถใช้หลายครั้งเพื่อระบุอาร์กิวเมนต์ได้หลายรายการ หากดำเนินการทดสอบหลายรายการ แต่ละรายการจะได้รับอาร์กิวเมนต์ที่เหมือนกัน ใช้เฉพาะโดยคำสั่ง "การทดสอบ Bazel" เท่านั้น
ค่าเริ่มต้น --test_filter=<a string>: ดูคำอธิบาย
ระบุตัวกรองที่จะส่งต่อไปยังเฟรมเวิร์กการทดสอบ ใช้เพื่อจำกัดการทดสอบ โปรดทราบว่าการเปลี่ยนแปลงนี้ไม่มีผลต่อเป้าหมายที่สร้างขึ้น
ค่าเริ่มต้นของ --test_lang_filters=<comma-separated list of options>: ""
ระบุรายการภาษาทดสอบที่คั่นด้วยคอมมา แต่ละภาษาอาจนำหน้าด้วย "-" เพื่อระบุภาษาที่ไม่รวม ระบบจะพบเฉพาะเป้าหมายทดสอบเหล่านั้นที่ใช้ภาษาที่ระบุ ชื่อที่ใช้สำหรับแต่ละภาษาควรเหมือนกับคำนำหน้าภาษาในกฎ *_test เช่น 'cc', 'java', 'py' เป็นต้น ตัวเลือกนี้จะมีผลต่อพฤติกรรม --build_tests_only พฤติกรรม และคำสั่งทดสอบ
ค่าเริ่มต้น --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" เพื่อใช้การชาร์ดดิ้งเฉพาะในกรณีที่มีแอตทริบิวต์ BUILD "shard_count" เท่านั้น "ปิดใช้" เพื่อไม่ใช้การชาร์ดดิ้งทดสอบ "forced=k" เพื่อบังคับใช้ชาร์ด "k" สำหรับการทดสอบโดยไม่คำนึงถึงแอตทริบิวต์ BUILD "shard_count"
ค่าเริ่มต้นของ --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 และคำสั่งทดสอบ
ค่าเริ่มต้นของ --tool_java_language_version=<a string>: ""
เวอร์ชันภาษา Java ที่ใช้เพื่อเรียกใช้เครื่องมือที่จำเป็นระหว่างบิลด์
ค่าเริ่มต้นของ --tool_java_runtime_version=<a string>: "remotejdk_11"
เวอร์ชันรันไทม์ของ Java ที่ใช้เพื่อเรียกใช้เครื่องมือในระหว่างบิลด์
ค่าเริ่มต้น --[no]use_ijars: "true"
หากเปิดใช้ ตัวเลือกนี้จะทำให้การคอมไพล์ Java ใช้ JAR อินเทอร์เฟซ ซึ่งจะทำให้การคอมไพล์แบบเพิ่มขึ้นเรื่อยๆ ได้เร็วขึ้น แต่ข้อความแสดงข้อผิดพลาดอาจแตกต่างกันได้

ตัวเลือกการตั้งค่าสถานะ Canonical

รับค่าตัวเลือกทั้งหมดจาก 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
ค่าเริ่มต้น --[no]incompatible_disable_native_repo_rules: "เท็จ"
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก: 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
ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่งมีดังนี้
ค่าเริ่มต้น --[no]canonicalize_policy: "เท็จ"
แสดงนโยบาย Canonical หลังจากการขยายและการกรอง เพื่อให้เอาต์พุตดูสะอาดตา อาร์กิวเมนต์คำสั่ง Canonical จะไม่แสดงเมื่อตั้งค่าตัวเลือกนี้เป็น "จริง" โปรดทราบว่าคำสั่งที่ระบุโดย --for_command จะส่งผลต่อนโยบายที่กรอง และหากไม่มีการระบุไว้ คำสั่งเริ่มต้นจะเป็น "build"
แท็ก: affects_outputs, terminal_output
ค่าเริ่มต้น --[no]experimental_include_default_values: "เท็จ"
ไม่ว่าตัวเลือก Starlark ที่ตั้งค่าเป็นค่าเริ่มต้นจะรวมอยู่ในเอาต์พุตหรือไม่
แท็ก: affects_outputs, terminal_output
ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือบิลด์ API ที่เข้าถึงได้จากไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE
ค่าเริ่มต้น --[no]incompatible_config_setting_private_default_visibility: "เท็จ"
หากตัวยึดตำแหน่ง_enforce_config_setting_visibility=false จะหมายความว่าไม่มีการดำเนินการ หรือไม่เช่นนั้น หากแฟล็กนี้เป็นเท็จ 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
ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ 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, refresh 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 เก่า) หลังจาก GC เต็ม <count> รายการติดต่อกันภายใน <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
ค่าเริ่มต้น --for_command=<a string>: "สร้าง"
คำสั่งสำหรับกำหนดให้ตัวเลือกดังกล่าวเป็นหน้า Canonical
แท็ก: affects_outputs, terminal_output
ค่าเริ่มต้นของ --invocation_policy=<a string>: ""
ใช้นโยบายการเรียกใช้กับตัวเลือกที่จะกำหนดให้เป็นหน้า Canonical
แท็ก: affects_outputs, terminal_output
ตัวเลือกการแคชและการดำเนินการจากระยะไกลมีดังนี้
ค่าเริ่มต้น --experimental_downloader_config=<a string>: ดูคำอธิบาย
ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด แต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือสองรูปแบบ รูปแบบหนึ่งจะใช้ตรงกัน และอีกรูปแบบหนึ่งใช้เป็น URL ทดแทน โดยมีการอ้างอิงกลับที่เริ่มต้นจาก "$1" ซึ่งระบบอาจส่งคืนคำสั่ง "rewrite" หลายครั้งสำหรับ URL เดียวกัน
ค่าเริ่มต้น --experimental_worker_for_repo_fetching=<off, platform, virtual or auto>: "อัตโนมัติ"
โหมดการแยกชุดข้อความที่ใช้สำหรับการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท หรือใช้เธรดผู้ปฏิบัติงานเสมือนแทน
ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --deleted_packages=<comma-separated list of package names> รายการ
รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริง แม้ว่าจะแสดงอยู่ในที่ใดที่หนึ่งบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ ตัวอย่างเช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์ของคุณ ระบบบิลด์อาจบ่นหากพบป้ายกำกับ "//x:y/z" หากยังพบป้ายกำกับโดยรายการpackage_path อื่นอยู่ การระบุ --deleted_packages x/y ช่วยป้องกันปัญหานี้
ค่าเริ่มต้น --[no]fetch: "true"
อนุญาตให้คำสั่งดึงข้อมูลทรัพยากร Dependency ภายนอก หากตั้งค่าเป็น "เท็จ" คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ และหากไม่มี คำสั่งดังกล่าวจะทำให้การทำงานล้มเหลว
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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 พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ:"

ตัวเลือกในการล้างข้อมูล

รับค่าตัวเลือกทั้งหมดจาก 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
ค่าเริ่มต้น --[no]incompatible_disable_native_repo_rules: "เท็จ"
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก: 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
ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่งมีดังนี้
ค่าเริ่มต้น --[no]async: "เท็จ"
หากเป็นจริง การล้างเอาต์พุตจะเป็นแบบไม่พร้อมกัน เมื่อคำสั่งนี้เสร็จสิ้น คุณจะเรียกใช้คำสั่งใหม่ในไคลเอ็นต์เดียวกันได้อย่างปลอดภัย แม้ว่าการลบอาจดำเนินต่อไปในเบื้องหลังก็ตาม
แท็ก: host_machine_resource_optimizations
ค่าเริ่มต้น --[no]expunge: "เท็จ"
หากเป็น "จริง" การล้างจะนำโครงสร้างการทำงานทั้งหมดของอินสแตนซ์ Bazel ออก ซึ่งรวมถึงไฟล์ชั่วคราวและสร้างไฟล์เอาต์พุตที่สร้างขึ้นด้วย Bazel ทั้งหมด และหยุดเซิร์ฟเวอร์ bazel หากทำงานอยู่
แท็ก: host_machine_resource_optimizations
--expunge_async
หากระบุ ให้ล้างแบบไม่พร้อมกันจะนำโครงสร้างการทำงานทั้งหมดสำหรับอินสแตนซ์ Bazel ออก ซึ่งรวมถึงไฟล์เอาต์พุตชั่วคราวและบิลด์ของ Bazel ทั้งหมด และหยุดเซิร์ฟเวอร์ Bazel หากทำงานอยู่ เมื่อคำสั่งนี้เสร็จสิ้น คุณจะเรียกใช้คำสั่งใหม่ในไคลเอ็นต์เดียวกันได้อย่างปลอดภัย แม้ว่าการลบอาจดำเนินต่อไปในเบื้องหลังก็ตาม
ขยายขอบเขตเป็น
  --expunge
  --async

แท็ก: 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, refresh 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 เก่า) หลังจาก GC เต็ม <count> รายการติดต่อกันภายใน <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 เดียวกัน
ค่าเริ่มต้น --experimental_worker_for_repo_fetching=<off, platform, virtual or auto>: "อัตโนมัติ"
โหมดการแยกชุดข้อความที่ใช้สำหรับการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท หรือใช้เธรดผู้ปฏิบัติงานเสมือนแทน
ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --override_repository=<an equals-separated mapping of repository name to path> รายการ
ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์จะใช้ตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" แสดงว่าสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"

ตัวเลือกการกำหนดค่า

ตัวเลือกความคุ้มครอง

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

ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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
ค่าเริ่มต้น --[no]incompatible_disable_native_repo_rules: "เท็จ"
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก: 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, refresh 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 เก่า) หลังจาก GC เต็ม <count> รายการติดต่อกันภายใน <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 เดียวกัน
ค่าเริ่มต้น --experimental_worker_for_repo_fetching=<off, platform, virtual or auto>: "อัตโนมัติ"
โหมดการแยกชุดข้อความที่ใช้สำหรับการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท หรือใช้เธรดผู้ปฏิบัติงานเสมือนแทน
ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --override_repository=<an equals-separated mapping of repository name to path> รายการ
ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์จะใช้ตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" แสดงว่าสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"

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

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

ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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
ค่าเริ่มต้น --[no]incompatible_disable_native_repo_rules: "เท็จ"
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก: 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 ใดๆ ส่วน "conservative" (ค่าเริ่มต้น) หมายความว่าจะมีการเพิ่มทรัพยากร Dependency ที่ประกาศทั้งหมด ไม่ว่าจะได้รับคลาสกฎของทรัพยากร Dependency โดยตรงหรือไม่ ส่วน "precise" หมายความว่ามีการเพิ่มเฉพาะด้านที่อาจทำงานอยู่เท่านั้นตามคลาสกฎของทรัพยากร Dependency โดยตรง โปรดทราบว่าโหมดแม่นยำต้องมีการโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียว ซึ่งจะทำให้ช้ากว่าโหมดอื่นๆ และโปรดทราบด้วยว่า โหมดแม้กระทั่งที่แม่นยำก็ไม่ได้แม่นยำทั้งหมด การตัดสินใจว่าจะคำนวณด้านใดด้านหนึ่งหรือไม่จะทำในขั้นตอนการวิเคราะห์ ซึ่งจะไม่ทำงานระหว่าง "การค้นหาแบบงัดแงะ"
แท็ก: build_file_semantics
ค่าเริ่มต้น --[no]consistent_labels: "เท็จ"
หากเปิดใช้ คำสั่งการค้นหาทุกคำสั่งจะปล่อยป้ายกำกับราวกับว่าฟังก์ชัน Starlark <code>str</code> ใช้กับอินสแตนซ์ <code>Label</code> ซึ่งมีประโยชน์สำหรับเครื่องมือที่จำเป็นต้องจับคู่เอาต์พุตของคำสั่งการค้นหาและ/หรือป้ายกำกับต่างๆ ที่กฎเรียกใช้ หากไม่เปิดใช้ ตัวจัดรูปแบบเอาต์พุตจะแสดงชื่อที่เก็บที่ชัดเจน (สัมพันธ์กับที่เก็บหลัก) แทนเพื่อทำให้เอาต์พุตอ่านได้ง่ายขึ้น
แท็ก: terminal_output
ค่าเริ่มต้น --[no]experimental_explicit_aspects: "เท็จ"
aquery, cquery: จะรวมการดำเนินการที่สร้างขึ้นในเอาต์พุตหรือไม่ คำค้นหา: no-op (ติดตามเสมอ)
แท็ก: 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 ที่การค้นหาทำงาน ทรัพยากร Dependency โดยนัยคือทรัพยากรที่ไม่มีการระบุอย่างชัดแจ้งในไฟล์ BUILD แต่เพิ่มโดย Bazel สำหรับ cquery ตัวเลือกนี้จะควบคุมการกรอง Toolchain ที่มีการแก้ปัญหาแล้ว
แท็ก: build_file_semantics
ค่าเริ่มต้น --[no]include_aspects: "true"
aquery, cquery: จะรวมการดำเนินการที่สร้างขึ้นในเอาต์พุตหรือไม่ คำค้นหา: no-op (ติดตามเสมอ)
แท็ก: 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 ค่า ระบบจะไม่สนใจค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้ใช้ได้กับ "ข้อความค้นหา" เท่านั้น (ไม่ใช่ "cquery")
แท็ก: loading_and_analysis
ค่าเริ่มต้น --[no]line_terminator_null: "เท็จ"
กำหนดว่าแต่ละรูปแบบจะสิ้นสุดด้วย \0 แทนการขึ้นบรรทัดใหม่หรือไม่
แท็ก: terminal_output
ค่าเริ่มต้น --[no]nodep_deps: "true"
หากเปิดใช้ ระบบจะรวม Dep จากแอตทริบิวต์ "nodep" ไว้ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ตัวอย่างทั่วไปของแอตทริบิวต์ "nodep" คือ "ระดับการเข้าถึง" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ "info create-language" เพื่อดูข้อมูลเกี่ยวกับแอตทริบิวต์ "nodep" ทั้งหมดในภาษาของบิลด์
แท็ก: build_file_semantics
ค่าเริ่มต้น --output=<a string>: "ป้ายกำกับ"
รูปแบบที่ควรพิมพ์ผลการค้นหา BigQuery ค่าที่อนุญาตสำหรับ cquery มีดังนี้: label, label_kind, textผสานรวม, ทรานซิชัน, โปรโต, โปรโมท สตรีม โปรโต, อีโคโปรโต หากเลือก "การเปลี่ยน" คุณต้องระบุตัวเลือก --transitions=(lite|full) ด้วย
แท็ก: terminal_output
ค่าเริ่มต้น --[no]proto:default_values: "true"
หากเป็น "จริง" ระบบจะรวมแอตทริบิวต์ที่ไม่ได้ระบุค่าไว้อย่างชัดแจ้งในไฟล์ BUILD มิเช่นนั้นระบบจะละเว้นแอตทริบิวต์เหล่านั้น ตัวเลือกนี้ใช้ได้กับ --output=prod
แท็ก: 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_configurations: "true"
หากเปิดใช้ เอาต์พุต Proto จะมีข้อมูลเกี่ยวกับการกำหนดค่า เมื่อปิดใช้งาน รูปแบบเอาต์พุต Proto ของ cquery จะมีลักษณะคล้ายกับรูปแบบเอาต์พุตของการค้นหา
แท็ก: affects_outputs
ค่าเริ่มต้น --[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
ค่าเริ่มต้นของ --show_config_fragments=<off, direct or transitive>: "ปิด"
แสดงส่วนย่อยการกำหนดค่าที่จำเป็นสำหรับกฎและทรัพยากร Dependency แบบทรานซิทีฟ วิธีนี้จะมีประโยชน์ในการประเมินว่าสามารถตัดกราฟเป้าหมายที่กำหนดค่าไว้ได้มากน้อยเพียงใด
แท็ก: affects_outputs
ค่าเริ่มต้นของ --starlark:expr=<a string>: ""
นิพจน์ Starlark เพื่อจัดรูปแบบเป้าหมายที่กำหนดค่าแต่ละรายการในโหมด --output=starlark ของ cquery เป้าหมายที่กำหนดค่าไว้เชื่อมโยงกับ "เป้าหมาย" ถ้าไม่ได้ระบุทั้ง --starlark:expr หรือ --starlark:file ตัวเลือกนี้จะมีค่าเริ่มต้นเป็น "str(target.label)" มีข้อผิดพลาดในการระบุทั้ง --starlark:expr และ --starlark:file
แท็ก: terminal_output
ค่าเริ่มต้นของ --starlark:file=<a string>: ""
ชื่อไฟล์ที่กำหนดฟังก์ชัน Starlark ที่เรียกว่า "format" ของอาร์กิวเมนต์ 1 รายการ ซึ่งใช้กับเป้าหมายที่กำหนดค่าแต่ละรายการเพื่อจัดรูปแบบเป็นสตริง มีข้อผิดพลาดในการระบุทั้ง --starlark:expr และ --starlark:file ดูความช่วยเหลือสำหรับ --output=starlark สำหรับรายละเอียดเพิ่มเติม
แท็ก: terminal_output
ค่าเริ่มต้น --[no]tool_deps: "true"
คำค้นหา: หากปิดใช้ ทรัพยากร Dependency ใน "การกำหนดค่าการดำเนินการ" จะไม่รวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน เอดจ์ของ "การกำหนดค่าผู้ดำเนินการ" เช่น กฎจากกฎ "protocol_library" ไปยังโปรโตคอลคอมไพเลอร์ โดยทั่วไปจะชี้ไปยังเครื่องมือที่ดำเนินการระหว่างบิลด์ ไม่ใช่เป็นส่วนหนึ่งของโปรแกรม "เป้าหมาย" เดียวกัน Cquery: หากปิดใช้ จะกรองเป้าหมายที่กำหนดค่าไว้ทั้งหมดซึ่งข้ามการเปลี่ยนการดำเนินการจากเป้าหมายระดับบนสุดที่ค้นพบเป้าหมายที่กำหนดค่าไว้นี้ออก ซึ่งหมายความว่าหากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าเป้าหมาย ระบบจะแสดงผลเฉพาะเป้าหมายที่กำหนดค่าไว้ในการกำหนดค่าเป้าหมายด้วย ถ้าเป้าหมายระดับบนสุดอยู่ในการกำหนดค่า exec ระบบจะแสดงผลเฉพาะเป้าหมายที่กำหนดค่าของ exec เท่านั้น ตัวเลือกนี้จะ "ไม่" ยกเว้น Toolchain ที่แก้ไขแล้ว
แท็ก: build_file_semantics
ค่าเริ่มต้น --transitions=<full, lite or none>: "ไม่มี"
รูปแบบที่ cquery จะพิมพ์ข้อมูลการเปลี่ยน
แท็ก: affects_outputs
ค่าเริ่มต้นของ --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, refresh 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 เก่า) หลังจาก GC เต็ม <count> รายการติดต่อกันภายใน <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 เดียวกัน
ค่าเริ่มต้น --experimental_worker_for_repo_fetching=<off, platform, virtual or auto>: "อัตโนมัติ"
โหมดการแยกชุดข้อความที่ใช้สำหรับการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท หรือใช้เธรดผู้ปฏิบัติงานเสมือนแทน
ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --override_repository=<an equals-separated mapping of repository name to path> รายการ
ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์จะใช้ตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางดังกล่าวจะสัมพัทธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานข้อมูลของ Bazel"
ตัวเลือกที่ควบคุมการทำงานของบิลด์:
กำหนดว่าจะเรียกใช้ระบบไฟล์โดยตรงเพื่อสร้างต้นไม้ลิงก์สัญลักษณ์หรือไม่
แท็ก: 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
ค่าเริ่มต้น --[no]incompatible_modify_execution_info_additive: "เท็จ"
เมื่อเปิดใช้ การส่งผ่าน Flag --modify_execution_info หลายรายการจะเป็นส่วนเสริม เมื่อปิดใช้ ระบบจะพิจารณาเฉพาะธงล่าสุดเท่านั้น
แท็ก: execution, affects_outputs, loading_and_analysis, 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=ProcessDatabinding=worker
--strategy=Aapt2Optimize=worker{/--internal_persistent_busybox_tools
--internal_persistent_busybox_tools



--strategy=AndroidManifestMerger=worker--strategy=AARGenerator=worker--strategy=GenerateDataBindingBaseClasses=workerhost_machine_resource_optimizationsexecution
--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{/7/2}
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers{/7/2}

--modify_execution_info=AARGenerator=+supports-multiplex-workershost_machine_resource_optimizationsexecution
--persistent_multiplex_android_tools
เปิดใช้เครื่องมือ Android แบบต่อเนื่องและแบบมัลติเพล็กซ์ (Dexing, De หากไม่ต้องการ, การประมวลผลทรัพยากร)
ขยายเป็น
  --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"
ป้ายกำกับของแพ็กเกจข้ามเครื่องมือที่จะใช้ในกฎของ 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 ตามเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมายได้ เราจะพิจารณาเชนเครื่องมือเหล่านี้ก่อนการประกาศในไฟล์ 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> ค่าเริ่มต้น: "@bazel_tools//tools:host_platform"
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายระบบโฮสต์
แท็ก: 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>: ดูคำอธิบาย
เส้นทางสัมบูรณ์ของล่าม 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 ของ Runfiles สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้เขียนเมื่อต้องใช้การดำเนินการในเครื่อง ทดสอบ หรือเรียกใช้คำสั่งเท่านั้น
แท็ก: 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_proto_library สร้างขึ้น
แท็ก: affects_outputs, loading_and_analysis
ค่าเริ่มต้น --[no]experimental_proto_descriptor_sets_include_source_info: "เท็จ"
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันอื่นใน proto_library
แท็ก: affects_outputs, loading_and_analysis, experimental
ค่าเริ่มต้น --[no]experimental_proto_extra_actions: "เท็จ"
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันอื่นใน proto_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' เพื่อเปิดใช้งานทุกโหมด และ 'no' เพื่อปิดใช้งานทุกโหมด
แท็ก: 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 และลิงก์จะสร้างไฟล์ปฏิบัติการที่ไม่ขึ้นอยู่กับตำแหน่ง ("-พาย")
แท็ก: 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> รายการ
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง Swift สำหรับเครื่องมือผู้บริหาร
แท็ก: 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 สำหรับการกำหนดค่าการดำเนินการ
แท็ก: 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"
เลิกใช้งานแล้ว และมีผลแทนด้วย --incompatible_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 ย่อมาจาก "รวมและยกเว้น" รูปแบบนิพจน์ทั่วไป ตัวเลือก_1 ถึง "ตัวเลือก_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 ไฟล์ ได้แก่ โปรไฟล์ CC และโปรไฟล์ ld แฟล็กนี้ยอมรับป้ายกำกับบิลด์ซึ่งต้องอ้างถึงไฟล์อินพุตโปรไฟล์ใบพัด ตัวอย่างเช่น ไฟล์ BUILD ที่กำหนดป้ายกำกับใน a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)อาจต้องเพิ่มคำสั่ง Export_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>: ดูคำอธิบาย
คำนำหน้าที่จะแทรกไว้หน้าไฟล์ปฏิบัติการสำหรับคำสั่ง "test" และ "run" หากค่าคือ "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"
แท็ก: 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
ตัวเลือกที่มีผลต่อความเคร่งครัดในการบังคับใช้อินพุตบิลด์ที่ถูกต้อง (เช่น คำจำกัดความของกฎ ชุดค่าผสม Flag ฯลฯ)
ค่าเริ่มต้นของ --auto_cpu_environment_group=<a build target label>: ""
ประกาศชื่อ "สภาพแวดล้อม_กลุ่ม" เพื่อใช้แมปค่า 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"
กำหนดว่าจะ Dexugar ไบต์โค้ด 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
หากเป็น "จริง" ให้กำหนดค่าเริ่มต้นเป็น "จริง" สำหรับแอตทริบิวต์เชื่อมต่อตลอดเวลาใน objc_library และ objc_IMPORT
แท็ก: build_file_semantics, incompatible_change
ค่าเริ่มต้น --[no]incompatible_python_disallow_native_rules: "เท็จ"
เมื่อเป็นจริง ระบบจะแสดงข้อผิดพลาดเมื่อใช้กฎ py_* ในตัว คุณจึงควรใช้กฎ "rule_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 หรืออาจตามด้วย [-|*]<Float> (เช่น 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 ใดๆ ส่วน "conservative" (ค่าเริ่มต้น) หมายความว่าจะมีการเพิ่มทรัพยากร Dependency ที่ประกาศทั้งหมด ไม่ว่าจะได้รับคลาสกฎของทรัพยากร Dependency โดยตรงหรือไม่ ส่วน "precise" หมายความว่ามีการเพิ่มเฉพาะด้านที่อาจทำงานอยู่เท่านั้นตามคลาสกฎของทรัพยากร Dependency โดยตรง โปรดทราบว่าโหมดแม่นยำต้องมีการโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียว ซึ่งจะทำให้ช้ากว่าโหมดอื่นๆ และโปรดทราบด้วยว่า โหมดแม้กระทั่งที่แม่นยำก็ไม่ได้แม่นยำทั้งหมด การตัดสินใจว่าจะคำนวณด้านใดด้านหนึ่งหรือไม่จะทำในขั้นตอนการวิเคราะห์ ซึ่งจะไม่ทำงานระหว่าง "การค้นหาแบบงัดแงะ"
แท็ก: build_file_semantics
ค่าเริ่มต้น --[no]consistent_labels: "เท็จ"
หากเปิดใช้ คำสั่งการค้นหาทุกคำสั่งจะปล่อยป้ายกำกับราวกับว่าฟังก์ชัน Starlark <code>str</code> ใช้กับอินสแตนซ์ <code>Label</code> ซึ่งมีประโยชน์สำหรับเครื่องมือที่จำเป็นต้องจับคู่เอาต์พุตของคำสั่งการค้นหาและ/หรือป้ายกำกับต่างๆ ที่กฎเรียกใช้ หากไม่เปิดใช้ ตัวจัดรูปแบบเอาต์พุตจะแสดงชื่อที่เก็บที่ชัดเจน (สัมพันธ์กับที่เก็บหลัก) แทนเพื่อทำให้เอาต์พุตอ่านได้ง่ายขึ้น
แท็ก: terminal_output
ค่าเริ่มต้น --[no]experimental_explicit_aspects: "เท็จ"
aquery, cquery: จะรวมการดำเนินการที่สร้างขึ้นในเอาต์พุตหรือไม่ คำค้นหา: no-op (ติดตามเสมอ)
แท็ก: 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 ที่การค้นหาทำงาน ทรัพยากร Dependency โดยนัยคือทรัพยากรที่ไม่มีการระบุอย่างชัดแจ้งในไฟล์ BUILD แต่เพิ่มโดย Bazel สำหรับ cquery ตัวเลือกนี้จะควบคุมการกรอง Toolchain ที่มีการแก้ปัญหาแล้ว
แท็ก: build_file_semantics
ค่าเริ่มต้น --[no]include_aspects: "true"
aquery, cquery: จะรวมการดำเนินการที่สร้างขึ้นในเอาต์พุตหรือไม่ คำค้นหา: no-op (ติดตามเสมอ)
แท็ก: 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 ค่า ระบบจะไม่สนใจค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้ใช้ได้กับ "ข้อความค้นหา" เท่านั้น (ไม่ใช่ "cquery")
แท็ก: loading_and_analysis
ค่าเริ่มต้น --[no]line_terminator_null: "เท็จ"
กำหนดว่าแต่ละรูปแบบจะสิ้นสุดด้วย \0 แทนการขึ้นบรรทัดใหม่หรือไม่
แท็ก: terminal_output
ค่าเริ่มต้น --[no]nodep_deps: "true"
หากเปิดใช้ ระบบจะรวม Dep จากแอตทริบิวต์ "nodep" ไว้ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ตัวอย่างทั่วไปของแอตทริบิวต์ "nodep" คือ "ระดับการเข้าถึง" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ "info create-language" เพื่อดูข้อมูลเกี่ยวกับแอตทริบิวต์ "nodep" ทั้งหมดในภาษาของบิลด์
แท็ก: build_file_semantics
ค่าเริ่มต้น --output=<a string>: "ป้ายกำกับ"
รูปแบบที่ควรพิมพ์ผลการค้นหา BigQuery ค่าที่อนุญาตสำหรับ cquery มีดังนี้: label, label_kind, textผสานรวม, ทรานซิชัน, โปรโต, โปรโมท สตรีม โปรโต, อีโคโปรโต หากเลือก "การเปลี่ยน" คุณต้องระบุตัวเลือก --transitions=(lite|full) ด้วย
แท็ก: terminal_output
ค่าเริ่มต้น --[no]proto:default_values: "true"
หากเป็น "จริง" ระบบจะรวมแอตทริบิวต์ที่ไม่ได้ระบุค่าไว้อย่างชัดแจ้งในไฟล์ BUILD มิเช่นนั้นระบบจะละเว้นแอตทริบิวต์เหล่านั้น ตัวเลือกนี้ใช้ได้กับ --output=prod
แท็ก: 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_configurations: "true"
หากเปิดใช้ เอาต์พุต Proto จะมีข้อมูลเกี่ยวกับการกำหนดค่า เมื่อปิดใช้งาน รูปแบบเอาต์พุต Proto ของ cquery จะมีลักษณะคล้ายกับรูปแบบเอาต์พุตของการค้นหา
แท็ก: affects_outputs
ค่าเริ่มต้น --[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
ค่าเริ่มต้นของ --show_config_fragments=<off, direct or transitive>: "ปิด"
แสดงส่วนย่อยการกำหนดค่าที่จำเป็นสำหรับกฎและทรัพยากร Dependency แบบทรานซิทีฟ วิธีนี้จะมีประโยชน์ในการประเมินว่าสามารถตัดกราฟเป้าหมายที่กำหนดค่าไว้ได้มากน้อยเพียงใด
แท็ก: affects_outputs
ค่าเริ่มต้นของ --starlark:expr=<a string>: ""
นิพจน์ Starlark เพื่อจัดรูปแบบเป้าหมายที่กำหนดค่าแต่ละรายการในโหมด --output=starlark ของ cquery เป้าหมายที่กำหนดค่าไว้เชื่อมโยงกับ "เป้าหมาย" ถ้าไม่ได้ระบุทั้ง --starlark:expr หรือ --starlark:file ตัวเลือกนี้จะมีค่าเริ่มต้นเป็น "str(target.label)" มีข้อผิดพลาดในการระบุทั้ง --starlark:expr และ --starlark:file
แท็ก: terminal_output
ค่าเริ่มต้นของ --starlark:file=<a string>: ""
ชื่อไฟล์ที่กำหนดฟังก์ชัน Starlark ที่เรียกว่า "format" ของอาร์กิวเมนต์ 1 รายการ ซึ่งใช้กับเป้าหมายที่กำหนดค่าแต่ละรายการเพื่อจัดรูปแบบเป็นสตริง มีข้อผิดพลาดในการระบุทั้ง --starlark:expr และ --starlark:file ดูความช่วยเหลือสำหรับ --output=starlark สำหรับรายละเอียดเพิ่มเติม
แท็ก: terminal_output
ค่าเริ่มต้น --[no]tool_deps: "true"
คำค้นหา: หากปิดใช้ ทรัพยากร Dependency ใน "การกำหนดค่าการดำเนินการ" จะไม่รวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน เอดจ์ของ "การกำหนดค่าผู้ดำเนินการ" เช่น กฎจากกฎ "protocol_library" ไปยังโปรโตคอลคอมไพเลอร์ โดยทั่วไปจะชี้ไปยังเครื่องมือที่ดำเนินการระหว่างบิลด์ ไม่ใช่เป็นส่วนหนึ่งของโปรแกรม "เป้าหมาย" เดียวกัน Cquery: หากปิดใช้ จะกรองเป้าหมายที่กำหนดค่าไว้ทั้งหมดซึ่งข้ามการเปลี่ยนการดำเนินการจากเป้าหมายระดับบนสุดที่ค้นพบเป้าหมายที่กำหนดค่าไว้นี้ออก ซึ่งหมายความว่าหากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าเป้าหมาย ระบบจะแสดงผลเฉพาะเป้าหมายที่กำหนดค่าไว้ในการกำหนดค่าเป้าหมายด้วย ถ้าเป้าหมายระดับบนสุดอยู่ในการกำหนดค่า exec ระบบจะแสดงผลเฉพาะเป้าหมายที่กำหนดค่าของ exec เท่านั้น ตัวเลือกนี้จะ "ไม่" ยกเว้น Toolchain ที่แก้ไขแล้ว
แท็ก: build_file_semantics
ค่าเริ่มต้น --transitions=<full, lite or none>: "ไม่มี"
รูปแบบที่ cquery จะพิมพ์ข้อมูลการเปลี่ยน
แท็ก: affects_outputs
ค่าเริ่มต้นของ --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"
การทำงานส่วนใหญ่ทำงานกับไฟล์ 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 แทนรันไทม์ที่กำหนดโดย Flag เดิม เช่น --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"
หากเป็นจริง การทดสอบพิเศษจะทำงานโดยใช้กลยุทธ์แซนด์บ็อกซ์ เพิ่มแท็ก "local" เพื่อบังคับให้ทำการทดสอบพิเศษในเครื่อง
แท็ก: 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" จะลบล้าง Flag นี้
--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>: ดูคำอธิบาย
ระบุไบนารีที่จะใช้เดกซ์โดยไม่ต้องชาร์ดดิ้ง
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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-compiler
แท็ก: affects_outputs, loading_and_analysis
--proto_toolchain_for_cc=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/protocol:cc_toolchain"
ป้ายกำกับของ protocol_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ C++ Proto
แท็ก: affects_outputs, loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/j2objc:j2objc_protocol_toolchain"
ป้ายกำกับของ protocol_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ j2objc Proto
แท็ก: affects_outputs, loading_and_analysis
--proto_toolchain_for_java=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/protocol:java_toolchain"
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ Java Proto
แท็ก: 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" เพื่อใช้การชาร์ดดิ้งเฉพาะในกรณีที่มีแอตทริบิวต์ BUILD "shard_count" เท่านั้น "ปิดใช้" เพื่อไม่ใช้การชาร์ดดิ้งทดสอบ "forced=k" เพื่อบังคับใช้ชาร์ด "k" สำหรับการทดสอบโดยไม่คำนึงถึงแอตทริบิวต์ BUILD "shard_count"
ค่าเริ่มต้นของ --tool_java_language_version=<a string>: ""
เวอร์ชันภาษา Java ที่ใช้เพื่อเรียกใช้เครื่องมือที่จำเป็นระหว่างบิลด์
ค่าเริ่มต้นของ --tool_java_runtime_version=<a string>: "remotejdk_11"
เวอร์ชันรันไทม์ของ Java ที่ใช้เพื่อเรียกใช้เครื่องมือในระหว่างบิลด์
ค่าเริ่มต้น --[no]use_ijars: "true"
หากเปิดใช้ ตัวเลือกนี้จะทำให้การคอมไพล์ Java ใช้ JAR อินเทอร์เฟซ ซึ่งจะทำให้การคอมไพล์แบบเพิ่มขึ้นเรื่อยๆ ได้เร็วขึ้น แต่ข้อความแสดงข้อผิดพลาดอาจแตกต่างกันได้

ตัวเลือกดัมพ์

ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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
ค่าเริ่มต้น --[no]incompatible_disable_native_repo_rules: "เท็จ"
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก: 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
ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่งมีดังนี้
ค่าเริ่มต้น --[no]action_cache: "เท็จ"
ดัมพ์เนื้อหาของแคช
แท็ก: bazel_monitoring
ค่าเริ่มต้น --[no]packages: "เท็จ"
ดัมพ์เนื้อหาแคชของแพ็กเกจ
แท็ก: bazel_monitoring
ค่าเริ่มต้น --[no]rule_classes: "เท็จ"
คลาสของกฎดัมพ์
แท็ก: bazel_monitoring
ค่าเริ่มต้น --[no]rules: "เท็จ"
กฎดัมพ์ รวมถึงจำนวนและการใช้หน่วยความจำ (หากมีการติดตามหน่วยความจำ)
แท็ก: bazel_monitoring
ค่าเริ่มต้นของ --skyframe=<off, summary, count, deps or rdeps>: "ปิด"
ดัมพ์กราฟ Skyframe: "ปิด" "สรุป" "จำนวน" "deps" หรือ "rdeps"
แท็ก: bazel_monitoring
ค่าเริ่มต้น --skykey_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: ".*"
ตัวกรองนิพจน์ทั่วไปของชื่อ SkyKey ที่จะเอาต์พุต ใช้กับ --skyframe=deps, rdeps เท่านั้น
แท็ก: bazel_monitoring
ค่าเริ่มต้น --skylark_memory=<a string>: ดูคำอธิบาย
ถ่ายโอนโปรไฟล์หน่วยความจำที่เข้ากันได้กับ pprof ไปยังเส้นทางที่ระบุ ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/google/pprof
แท็ก: bazel_monitoring
ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ 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, refresh 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 เก่า) หลังจาก GC เต็ม <count> รายการติดต่อกันภายใน <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 เดียวกัน
ค่าเริ่มต้น --experimental_worker_for_repo_fetching=<off, platform, virtual or auto>: "อัตโนมัติ"
โหมดการแยกชุดข้อความที่ใช้สำหรับการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท หรือใช้เธรดผู้ปฏิบัติงานเสมือนแทน
ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --override_repository=<an equals-separated mapping of repository name to path> รายการ
ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์จะใช้ตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" แสดงว่าสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"

ตัวเลือกการดึงข้อมูล

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

ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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
ค่าเริ่มต้น --[no]incompatible_disable_native_repo_rules: "เท็จ"
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก: 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]all: "เท็จ"
ดึงข้อมูลที่เก็บภายนอกทั้งหมดที่จำเป็นสำหรับการสร้างเป้าหมายหรือที่เก็บ ทำงานเมื่อเปิด --enable_bzlmod เท่านั้น
แท็ก: changes_inputs
ค่าเริ่มต้น --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
เปอร์เซ็นต์ของพื้นที่เก็บข้อมูลที่ใช้งานได้ (0-100) ซึ่งสูงกว่าที่ GcThrashingDetector จะพิจารณาเหตุการณ์แรงดันหน่วยความจำเทียบกับขีดจำกัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก: host_machine_resource_optimizations
--[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" "auto" จะตั้งค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก: bazel_internal_configuration
ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือบิลด์ API ที่ไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE เข้าถึงได้
ค่าเริ่มต้น --[no]incompatible_config_setting_private_default_visibility: "เท็จ"
หากตัวยึดตำแหน่ง_enforce_config_setting_visibility=false จะหมายความว่าไม่มีการดำเนินการ หรือไม่เช่นนั้น หากแฟล็กนี้เป็นเท็จ 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
ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ 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]configure: "เท็จ"
จะดึงข้อมูลเฉพาะที่เก็บที่มีเครื่องหมายว่า "กำหนดค่า" เพื่อวัตถุประสงค์ในการกำหนดค่าระบบ ทำงานเมื่อเปิด --enable_bzlmod เท่านั้น
แท็ก: changes_inputs
ค่าเริ่มต้น --[no]force: "เท็จ"
ไม่ต้องสนใจที่เก็บที่มีอยู่ (หากมี) และบังคับให้ดึงข้อมูลที่เก็บอีกครั้ง ทำงานเมื่อเปิด --enable_bzlmod เท่านั้น
แท็ก: changes_inputs
ค่าเริ่มต้น --[no]ignore_dev_dependency: "เท็จ"
หากเป็นจริง Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะไม่สนใจทรัพยากร Dependency สำหรับนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูทไม่ว่าค่าของแฟล็กนี้จะเป็นอะไร
แท็ก: loading_and_analysis
ค่าเริ่มต้น --lockfile_mode=<off, update, refresh 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
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --repo=<a string> รายการ
จะดึงข้อมูลเฉพาะที่เก็บที่ระบุเท่านั้น ซึ่งอาจเป็น {@apparent_repo_name} หรือ {@@canonical_repo_name} ทำงานเมื่อเปิด --enable_bzlmod เท่านั้น
แท็ก: 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 เก่า) หลังจาก GC เต็ม <count> รายการติดต่อกันภายใน <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 รายการที่มีการกระทำมากที่สุด การตั้งค่าตัวเลือกนี้จะเป็นการเขียนสถิติสำหรับการช่วยจำทั้งหมด
ค่าเริ่มต้นของ --experimental_repository_resolved_file=<a string>: ""
หากไม่ว่างเปล่า ให้เขียนค่า Starlark พร้อมข้อมูลที่แก้ไขแล้วของกฎที่เก็บ Starlark ทั้งหมดที่ดำเนินการ
แท็ก: affects_outputs
ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง 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 เดียวกัน
ค่าเริ่มต้น --experimental_worker_for_repo_fetching=<off, platform, virtual or auto>: "อัตโนมัติ"
โหมดการแยกชุดข้อความที่ใช้สำหรับการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท หรือใช้เธรดผู้ปฏิบัติงานเสมือนแทน
ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --deleted_packages=<comma-separated list of package names> รายการ
รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริง แม้ว่าจะแสดงอยู่ในที่ใดที่หนึ่งบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ ตัวอย่างเช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์ของคุณ ระบบบิลด์อาจบ่นหากพบป้ายกำกับ "//x:y/z" หากยังพบป้ายกำกับโดยรายการpackage_path อื่นอยู่ การระบุ --deleted_packages x/y ช่วยป้องกันปัญหานี้
ค่าเริ่มต้น --[no]fetch: "true"
อนุญาตให้คำสั่งดึงข้อมูลทรัพยากร Dependency ภายนอก หากตั้งค่าเป็น "เท็จ" คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ และหากไม่มี คำสั่งดังกล่าวจะทำให้การทำงานล้มเหลว
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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 พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ:"
ตัวเลือกที่ควบคุมการดำเนินการของบิลด์มีดังนี้
ค่าเริ่มต้น --[no]all: "เท็จ"
ดึงข้อมูลที่เก็บภายนอกทั้งหมดที่จำเป็นสำหรับการสร้างเป้าหมายหรือที่เก็บ ทำงานเมื่อเปิด --enable_bzlmod เท่านั้น
แท็ก: changes_inputs
กำหนดว่าจะเรียกใช้ระบบไฟล์โดยตรงเพื่อสร้างต้นไม้ลิงก์สัญลักษณ์หรือไม่
แท็ก: 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
ค่าเริ่มต้น --[no]incompatible_modify_execution_info_additive: "เท็จ"
เมื่อเปิดใช้ การส่งผ่าน Flag --modify_execution_info หลายรายการจะเป็นส่วนเสริม เมื่อปิดใช้ ระบบจะพิจารณาเฉพาะธงล่าสุดเท่านั้น
แท็ก: execution, affects_outputs, loading_and_analysis, incompatible_change
--[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" "auto" จะตั้งค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 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=ProcessDatabinding=worker
--strategy=Aapt2Optimize=worker{/--internal_persistent_busybox_tools
--internal_persistent_busybox_tools



--strategy=AndroidManifestMerger=worker--strategy=AARGenerator=worker--strategy=GenerateDataBindingBaseClasses=workerhost_machine_resource_optimizationsexecution
--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{/7/2}
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers{/7/2}

--modify_execution_info=AARGenerator=+supports-multiplex-workershost_machine_resource_optimizationsexecution
--persistent_multiplex_android_tools
เปิดใช้เครื่องมือ Android แบบต่อเนื่องและแบบมัลติเพล็กซ์ (Dexing, De หากไม่ต้องการ, การประมวลผลทรัพยากร)
ขยายเป็น
  --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"
ป้ายกำกับของแพ็กเกจข้ามเครื่องมือที่จะใช้ในกฎของ 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 ตามเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมายได้ เราจะพิจารณาเชนเครื่องมือเหล่านี้ก่อนการประกาศในไฟล์ 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> ค่าเริ่มต้น: "@bazel_tools//tools:host_platform"
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายระบบโฮสต์
แท็ก: 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>: ดูคำอธิบาย
เส้นทางสัมบูรณ์ของล่าม 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 ของ Runfiles สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้เขียนเมื่อต้องใช้การดำเนินการในเครื่อง ทดสอบ หรือเรียกใช้คำสั่งเท่านั้น
แท็ก: 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_proto_library สร้างขึ้น
แท็ก: affects_outputs, loading_and_analysis
ค่าเริ่มต้น --[no]experimental_proto_descriptor_sets_include_source_info: "เท็จ"
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันอื่นใน proto_library
แท็ก: affects_outputs, loading_and_analysis, experimental
ค่าเริ่มต้น --[no]experimental_proto_extra_actions: "เท็จ"
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันอื่นใน proto_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' เพื่อเปิดใช้งานทุกโหมด และ 'no' เพื่อปิดใช้งานทุกโหมด
แท็ก: 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 และลิงก์จะสร้างไฟล์ปฏิบัติการที่ไม่ขึ้นอยู่กับตำแหน่ง ("-พาย")
แท็ก: 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> รายการ
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง Swift สำหรับเครื่องมือผู้บริหาร
แท็ก: 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 สำหรับการกำหนดค่าการดำเนินการ
แท็ก: 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"
เลิกใช้งานแล้ว และมีผลแทนด้วย --incompatible_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 ย่อมาจาก "รวมและยกเว้น" รูปแบบนิพจน์ทั่วไป ตัวเลือก_1 ถึง "ตัวเลือก_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 ไฟล์ ได้แก่ โปรไฟล์ CC และโปรไฟล์ ld แฟล็กนี้ยอมรับป้ายกำกับบิลด์ซึ่งต้องอ้างถึงไฟล์อินพุตโปรไฟล์ใบพัด ตัวอย่างเช่น ไฟล์ BUILD ที่กำหนดป้ายกำกับใน a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)อาจต้องเพิ่มคำสั่ง Export_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>: ดูคำอธิบาย
คำนำหน้าที่จะแทรกไว้หน้าไฟล์ปฏิบัติการสำหรับคำสั่ง "test" และ "run" หากค่าคือ "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"
แท็ก: 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
ตัวเลือกที่มีผลต่อความเคร่งครัดในการบังคับใช้อินพุตบิลด์ที่ถูกต้อง (เช่น คำจำกัดความของกฎ ชุดค่าผสม Flag ฯลฯ)
ค่าเริ่มต้นของ --auto_cpu_environment_group=<a build target label>: ""
ประกาศชื่อ "สภาพแวดล้อม_กลุ่ม" เพื่อใช้แมปค่า 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"
กำหนดว่าจะ Dexugar ไบต์โค้ด 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 จะหมายความว่าไม่มีการดำเนินการ หรือไม่เช่นนั้น หากแฟล็กนี้เป็นเท็จ 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
หากเป็น "จริง" ให้กำหนดค่าเริ่มต้นเป็น "จริง" สำหรับแอตทริบิวต์เชื่อมต่อตลอดเวลาใน objc_library และ objc_IMPORT
แท็ก: build_file_semantics, incompatible_change
ค่าเริ่มต้น --[no]incompatible_python_disallow_native_rules: "เท็จ"
เมื่อเป็นจริง ระบบจะแสดงข้อผิดพลาดเมื่อใช้กฎ py_* ในตัว คุณจึงควรใช้กฎ "rule_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 หรืออาจตามด้วย [-|*]<Float> (เช่น 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
ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod มีดังนี้
ค่าเริ่มต้น --[no]configure: "เท็จ"
จะดึงข้อมูลเฉพาะที่เก็บที่มีเครื่องหมายว่า "กำหนดค่า" เพื่อวัตถุประสงค์ในการกำหนดค่าระบบ ทำงานเมื่อเปิด --enable_bzlmod เท่านั้น
แท็ก: changes_inputs
ค่าเริ่มต้น --[no]force: "เท็จ"
ไม่ต้องสนใจที่เก็บที่มีอยู่ (หากมี) และบังคับให้ดึงข้อมูลที่เก็บอีกครั้ง ทำงานเมื่อเปิด --enable_bzlmod เท่านั้น
แท็ก: changes_inputs
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --repo=<a string> รายการ
จะดึงข้อมูลเฉพาะที่เก็บที่ระบุเท่านั้น ซึ่งอาจเป็น {@apparent_repo_name} หรือ {@@canonical_repo_name} ทำงานเมื่อเปิด --enable_bzlmod เท่านั้น
แท็ก: changes_inputs
ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพของเวลาบิลด์
ค่าเริ่มต้น --[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"
การทำงานส่วนใหญ่ทำงานกับไฟล์ 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 แทนรันไทม์ที่กำหนดโดย Flag เดิม เช่น --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 จะไม่แคชผลการทดสอบใดๆ
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --deleted_packages=<comma-separated list of package names> รายการ
รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริง แม้ว่าจะแสดงอยู่ในที่ใดที่หนึ่งบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ ตัวอย่างเช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์ของคุณ ระบบบิลด์อาจบ่นหากพบป้ายกำกับ "//x:y/z" หากยังพบป้ายกำกับโดยรายการpackage_path อื่นอยู่ การระบุ --deleted_packages x/y ช่วยป้องกันปัญหานี้
ค่าเริ่มต้น --[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 เท่านั้น
ค่าเริ่มต้น --[no]fetch: "true"
อนุญาตให้คำสั่งดึงข้อมูลทรัพยากร Dependency ภายนอก หากตั้งค่าเป็น "เท็จ" คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ และหากไม่มี คำสั่งดังกล่าวจะทำให้การทำงานล้มเหลว
ค่าเริ่มต้น --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"
หากเป็นจริง การทดสอบพิเศษจะทำงานโดยใช้กลยุทธ์แซนด์บ็อกซ์ เพิ่มแท็ก "local" เพื่อบังคับให้ทำการทดสอบพิเศษในเครื่อง
แท็ก: 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" จะลบล้าง Flag นี้
--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>: ดูคำอธิบาย
ระบุไบนารีที่จะใช้เดกซ์โดยไม่ต้องชาร์ดดิ้ง
ค่าเริ่มต้นของ --package_path=<colon-separated list of options>: "%workspace%"
รายการค้นหาแพ็กเกจที่คั่นด้วยโคลอน องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับพื้นที่ทำงานที่ล้อมรอบอยู่ หากไม่ระบุหรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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-compiler
แท็ก: affects_outputs, loading_and_analysis
--proto_toolchain_for_cc=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/protocol:cc_toolchain"
ป้ายกำกับของ protocol_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ C++ Proto
แท็ก: affects_outputs, loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/j2objc:j2objc_protocol_toolchain"
ป้ายกำกับของ protocol_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ j2objc Proto
แท็ก: affects_outputs, loading_and_analysis
--proto_toolchain_for_java=<a build target label> ค่าเริ่มต้น: "@bazel_tools//tools/protocol:java_toolchain"
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ Java Proto
แท็ก: 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
ค่าเริ่มต้น --[no]show_loading_progress: "true"
หากเปิดใช้จะทำให้ Bazel พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ:"
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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" เพื่อใช้การชาร์ดดิ้งเฉพาะในกรณีที่มีแอตทริบิวต์ BUILD "shard_count" เท่านั้น "ปิดใช้" เพื่อไม่ใช้การชาร์ดดิ้งทดสอบ "forced=k" เพื่อบังคับใช้ชาร์ด "k" สำหรับการทดสอบโดยไม่คำนึงถึงแอตทริบิวต์ BUILD "shard_count"
ค่าเริ่มต้นของ --tool_java_language_version=<a string>: ""
เวอร์ชันภาษา Java ที่ใช้เพื่อเรียกใช้เครื่องมือที่จำเป็นระหว่างบิลด์
ค่าเริ่มต้นของ --tool_java_runtime_version=<a string>: "remotejdk_11"
เวอร์ชันรันไทม์ของ Java ที่ใช้เพื่อเรียกใช้เครื่องมือในระหว่างบิลด์
ค่าเริ่มต้น --[no]use_ijars: "true"
หากเปิดใช้ ตัวเลือกนี้จะทำให้การคอมไพล์ Java ใช้ JAR อินเทอร์เฟซ ซึ่งจะทำให้การคอมไพล์แบบเพิ่มขึ้นเรื่อยๆ ได้เร็วขึ้น แต่ข้อความแสดงข้อผิดพลาดอาจแตกต่างกันได้

ตัวเลือกความช่วยเหลือ

ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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
ค่าเริ่มต้น --[no]incompatible_disable_native_repo_rules: "เท็จ"
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก: 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, refresh 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 เก่า) หลังจาก GC เต็ม <count> รายการติดต่อกันภายใน <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 รายการที่มีการกระทำมากที่สุด การตั้งค่าตัวเลือกนี้จะเป็นการเขียนสถิติสำหรับการช่วยจำทั้งหมด
ค่าเริ่มต้น --help_verbosity=<long, medium or short>: "ปานกลาง"
เลือกรายละเอียดของคำสั่งความช่วยเหลือ
แท็ก: affects_outputs, terminal_output
--long [-l]
แสดงคำอธิบายแบบเต็มของตัวเลือกแต่ละรายการ แทนที่จะแสดงเพียงชื่อตัวเลือก
ขยายเป็น
  --help_verbosity=long

แท็ก: affects_outputs, terminal_output
--short
แสดงเฉพาะชื่อของตัวเลือกเท่านั้น ไม่แสดงประเภทหรือความหมาย
ขยายเป็น
  --help_verbosity=short

แท็ก: affects_outputs, terminal_output
ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคําสั่ง 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 เดียวกัน
ค่าเริ่มต้น --experimental_worker_for_repo_fetching=<off, platform, virtual or auto>: "อัตโนมัติ"
โหมดการแยกชุดข้อความที่ใช้สำหรับการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท หรือใช้เธรดผู้ปฏิบัติงานเสมือนแทน
ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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
ค่าเริ่มต้น --[no]incompatible_disable_native_repo_rules: "เท็จ"
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก: 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, refresh 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 เก่า) หลังจาก GC เต็ม <count> รายการติดต่อกันภายใน <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 รายการที่มีการกระทำมากที่สุด การตั้งค่าตัวเลือกนี้จะเป็นการเขียนสถิติสำหรับการช่วยจำทั้งหมด
ค่าเริ่มต้น --[no]show_make_env: "เท็จ"
รวมสภาพแวดล้อม "Make" ไว้ในเอาต์พุต
แท็ก: affects_outputs, terminal_output
ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง 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 เดียวกัน
ค่าเริ่มต้น --experimental_worker_for_repo_fetching=<off, platform, virtual or auto>: "อัตโนมัติ"
โหมดการแยกชุดข้อความที่ใช้สำหรับการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท หรือใช้เธรดผู้ปฏิบัติงานเสมือนแทน
ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --override_repository=<an equals-separated mapping of repository name to path> รายการ
ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์จะใช้ตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" แสดงว่าสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"

ตัวเลือกใบอนุญาต

ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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
ค่าเริ่มต้น --[no]incompatible_disable_native_repo_rules: "เท็จ"
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก: 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, refresh 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 เก่า) หลังจาก GC เต็ม <count> รายการติดต่อกันภายใน <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 เดียวกัน
ค่าเริ่มต้น --experimental_worker_for_repo_fetching=<off, platform, virtual or auto>: "อัตโนมัติ"
โหมดการแยกชุดข้อความที่ใช้สำหรับการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท หรือใช้เธรดผู้ปฏิบัติงานเสมือนแทน
ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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
ค่าเริ่มต้น --[no]incompatible_disable_native_repo_rules: "เท็จ"
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก: 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
ค่าเริ่มต้น --mode=<classic, classic_internal_test_do_not_use or skylark>: "คลาสสิก"
เลือกวิธีเรียกใช้การติดตั้งบนอุปกรณ์เคลื่อนที่ "คลาสสิก" จะเรียกใช้การติดตั้งบนอุปกรณ์เคลื่อนที่เวอร์ชันปัจจุบัน "skylark" ใช้ Starlark เวอร์ชันใหม่ที่รองรับ android_test
แท็ก: loading_and_analysis, execution, incompatible_change
ตัวเลือกในการกำหนดค่า Toolchain ที่ใช้สำหรับการดำเนินการมีดังนี้
ค่าเริ่มต้นของ --adb=<a string>: ""
ไบนารี adb ที่จะใช้สำหรับคำสั่ง "mobile-install" หากไม่ระบุ ระบบจะใช้ SDK ใน Android SDK ที่ระบุโดยตัวเลือกบรรทัดคำสั่ง --android_sdk (หรือ SDK เริ่มต้นหากไม่ได้ระบุ --android_sdk)
แท็ก: changes_inputs
ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่งมีดังนี้
ค่าเริ่มต้น --[no]incremental: "เท็จ"
ต้องการติดตั้งทีละส่วนหรือไม่ หากเป็นจริง ให้พยายามหลีกเลี่ยงการทำงานเพิ่มเติมที่ไม่จำเป็นโดยการอ่านสถานะของอุปกรณ์ที่จะมีการติดตั้งโค้ดและใช้ข้อมูลดังกล่าวเพื่อหลีกเลี่ยงการทำงานที่ไม่จำเป็น หากเป็น "เท็จ" (ค่าเริ่มต้น) ให้ทำการติดตั้งโดยสมบูรณ์เสมอ
แท็ก: loading_and_analysis
ค่าเริ่มต้น --[no]split_apks: "เท็จ"
ต้องการใช้ APK แยกเพื่อติดตั้งและอัปเดตแอปพลิเคชันในอุปกรณ์หรือไม่ ใช้ได้กับอุปกรณ์ที่มี Marshmallow ขึ้นไปเท่านั้น
แท็ก: loading_and_analysis, affects_outputs
ตัวเลือกที่ให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการ ซึ่งจะส่งผลต่อค่าของเอาต์พุตแทนค่าที่มีอยู่
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --adb_arg=<a string> รายการ
มีอาร์กิวเมนต์เพิ่มเติมสำหรับส่งผ่านไปยัง adb มักใช้เพื่อระบุอุปกรณ์ที่จะติดตั้ง
แท็ก: action_command_lines
--debug_app
กำหนดว่าต้องรอโปรแกรมแก้ไขข้อบกพร่องก่อนเริ่มแอปหรือไม่
ขยายเป็น
  --start=DEBUG

แท็ก: execution
ค่าเริ่มต้นของ --device=<a string>: ""
หมายเลขซีเรียลของอุปกรณ์ adb หากไม่ได้ระบุ ระบบจะใช้อุปกรณ์เครื่องแรก
แท็ก: action_command_lines
ค่าเริ่มต้น --start=<no, cold, warm or debug>: "NO"
วิธีเริ่มต้นใช้งานแอปหลังจากติดตั้ง ตั้งค่าเป็น WARM เพื่อเก็บรักษาและคืนค่าสถานะแอปพลิเคชันในการติดตั้งที่เพิ่มขึ้น
แท็ก: execution
--start_app
เลือกว่าจะเริ่มแอปหลังจากติดตั้งหรือไม่
ขยายเป็น
  --start=COLD

แท็ก: execution
ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ 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, refresh 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 เก่า) หลังจาก GC เต็ม <count> รายการติดต่อกันภายใน <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 รายการที่มีการกระทำมากที่สุด การตั้งค่าตัวเลือกนี้จะเป็นการเขียนสถิติสำหรับการช่วยจำทั้งหมด
ค่าเริ่มต้นของ --incremental_install_verbosity=<a string>: ""
การพูดรายละเอียดสำหรับการติดตั้งที่เพิ่มขึ้น ตั้งค่าเป็น 1 สำหรับการบันทึกการแก้ไขข้อบกพร่อง
แท็ก: bazel_monitoring
ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง 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 เดียวกัน
ค่าเริ่มต้น --experimental_worker_for_repo_fetching=<off, platform, virtual or auto>: "อัตโนมัติ"
โหมดการแยกชุดข้อความที่ใช้สำหรับการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท หรือใช้เธรดผู้ปฏิบัติงานเสมือนแทน
ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --override_repository=<an equals-separated mapping of repository name to path> รายการ
ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์จะใช้ตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" แสดงว่าสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"

ตัวเลือกม็อด

ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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
ค่าเริ่มต้น --[no]incompatible_disable_native_repo_rules: "เท็จ"
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก: 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
--[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" "auto" จะตั้งค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก: bazel_internal_configuration
ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือบิลด์ API ที่ไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE เข้าถึงได้
ค่าเริ่มต้น --[no]incompatible_config_setting_private_default_visibility: "เท็จ"
หากตัวยึดตำแหน่ง_enforce_config_setting_visibility=false จะหมายความว่าไม่มีการดำเนินการ หรือไม่เช่นนั้น หากแฟล็กนี้เป็นเท็จ 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
ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของคำสั่งย่อย "mod":
ค่าเริ่มต้น --base_module=<"<root>" for the root module; <module>@<version> for a specific version of a module; <module> for all versions of a module; @<name> for a repo with the given apparent name; or @@<name> for a repo with the given canonical name>: "<root>"
ระบุโมดูลซึ่งสัมพันธ์กับที่เก็บเป้าหมายที่ระบุซึ่งจะมีการตีความ
แท็ก: terminal_output
ค่าเริ่มต้นของ --charset=<utf8 or ascii>: "utf8"
เลือกการเข้ารหัสที่จะใช้กับต้นไม้ มีผลกับเอาต์พุตข้อความเท่านั้น ค่าที่ถูกต้องคือ "utf8" หรือ "ascii" ค่าเริ่มต้นคือ "utf8"
แท็ก: terminal_output
ค่าเริ่มต้น --[no]cycles: "เท็จ"
ระบุรอบทรัพยากร Dependency ภายในแผนผังที่แสดง ซึ่งปกติจะละเว้นโดยค่าเริ่มต้น
แท็ก: terminal_output
ค่าเริ่มต้น --depth=<an integer>: "-1"
ความลึกในการแสดงผลสูงสุดของแผนผัง Dependency เช่น ความลึกที่ 1 จะแสดงทรัพยากร Dependency โดยตรง สำหรับต้นไม้ เส้นทาง และ all_paths จะใช้ค่าเริ่มต้นเป็นจำนวนเต็มMAX_VALUE ส่วนสำหรับ deps และอธิบายค่าเริ่มต้นจะเป็น 1 (แสดงเฉพาะส่วนโดยตรงของรากนอกเหนือจากใบเป้าหมายและระดับบนสุด)
แท็ก: terminal_output
ค่าเริ่มต้น --extension_filter=<a comma-separated list of <extension>s>: ดูคำอธิบาย
แสดงเฉพาะการใช้งานส่วนขยายโมดูลเหล่านี้และที่เก็บที่สร้างขึ้นหากมีการตั้งค่า Flag ที่เกี่ยวข้องไว้ หากตั้งค่าไว้ กราฟผลลัพธ์จะรวมเฉพาะเส้นทางที่มีโมดูลที่ใช้ส่วนขยายที่ระบุ รายการที่ว่างเปล่าจะเป็นการปิดใช้ตัวกรอง โดยระบุส่วนขยายทั้งหมดที่เป็นไปได้อย่างมีประสิทธิภาพ
แท็ก: terminal_output
ค่าเริ่มต้น --extension_info=<hidden, usages, repos or all>: "ซ่อนอยู่"
ระบุรายละเอียดของการใช้ส่วนขยายที่จะรวมไว้ในผลการค้นหา "การใช้งาน" จะแสดงเฉพาะชื่อส่วนขยาย "repos" จะรวมที่เก็บที่นำเข้าพร้อม use_repo ด้วย และ "all" จะแสดงที่เก็บอื่นๆ ที่ส่วนขยายสร้างขึ้นด้วย
แท็ก: terminal_output
ค่าเริ่มต้นของ --extension_usages=<a comma-separated list of <module>s>: ""
ระบุโมดูลที่การใช้งานส่วนขยายจะแสดงในการค้นหา show_extension
แท็ก: terminal_output
ค่าเริ่มต้น --from=<a comma-separated list of <module>s>: "<root>"
โมดูลที่เริ่มต้นจากการค้นหากราฟทรัพยากร Dependency จะปรากฏขึ้น ตรวจสอบคำอธิบายการค้นหาแต่ละรายการเพื่อดูความหมายที่ตรงกันทั้งหมด ค่าเริ่มต้นจะเป็น <root>
แท็ก: terminal_output
ค่าเริ่มต้น --[no]include_builtin: "เท็จ"
รวมโมดูลในตัวไว้ในกราฟทรัพยากร Dependency ปิดใช้งานโดยค่าเริ่มต้นเนื่องจากมีเสียงดัง
แท็ก: terminal_output
ค่าเริ่มต้น --[no]include_unused: "เท็จ"
การค้นหาจะพิจารณาและแสดงโมดูลที่ไม่ได้ใช้ด้วย ซึ่งไม่ได้แสดงในกราฟความละเอียดของโมดูลหลังจากที่เลือก (เนื่องจากกฎการเลือกเวอร์ชันขั้นต่ำหรือลบล้าง) ซึ่งจะมีผลที่แตกต่างกันสําหรับการค้นหาแต่ละประเภท เช่น การรวมเส้นทางใหม่ในคําสั่ง all_paths หรือการอ้างอิงเพิ่มเติมในคําสั่งอธิบาย
แท็ก: terminal_output
ค่าเริ่มต้น --output=<text, json or graph>: "ข้อความ"
รูปแบบที่ควรพิมพ์ผลการค้นหา ค่าที่อนุญาตสำหรับการค้นหา ได้แก่ text, json, กราฟ
แท็ก: terminal_output
ค่าเริ่มต้น --[no]verbose: "เท็จ"
นอกจากนี้ การค้นหาจะแสดงเหตุผลว่าทำไมโมดูลจึงได้รับการแก้ไขเป็นเวอร์ชันปัจจุบัน (หากมีการเปลี่ยนแปลง) ค่าเริ่มต้นเป็น true สำหรับการค้นหาอธิบายเท่านั้น
แท็ก: terminal_output
ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ 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, refresh 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 เก่า) หลังจาก GC เต็ม <count> รายการติดต่อกันภายใน <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 เดียวกัน
ค่าเริ่มต้น --experimental_worker_for_repo_fetching=<off, platform, virtual or auto>: "อัตโนมัติ"
โหมดการแยกชุดข้อความที่ใช้สำหรับการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท หรือใช้เธรดผู้ปฏิบัติงานเสมือนแทน
ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --deleted_packages=<comma-separated list of package names> รายการ
รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริง แม้ว่าจะแสดงอยู่ในที่ใดที่หนึ่งบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ ตัวอย่างเช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์ของคุณ ระบบบิลด์อาจบ่นหากพบป้ายกำกับ "//x:y/z" หากยังพบป้ายกำกับโดยรายการpackage_path อื่นอยู่ การระบุ --deleted_packages x/y ช่วยป้องกันปัญหานี้
ค่าเริ่มต้น --[no]fetch: "true"
อนุญาตให้คำสั่งดึงข้อมูลทรัพยากร Dependency ภายนอก หากตั้งค่าเป็น "เท็จ" คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ และหากไม่มี คำสั่งดังกล่าวจะทำให้การทำงานล้มเหลว
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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 พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ:"

รับค่าตัวเลือกทั้งหมดจาก 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
ค่าเริ่มต้น --[no]incompatible_disable_native_repo_rules: "เท็จ"
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก: 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, refresh 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 เก่า) หลังจาก GC เต็ม <count> รายการติดต่อกันภายใน <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 เดียวกัน
ค่าเริ่มต้น --experimental_worker_for_repo_fetching=<off, platform, virtual or auto>: "อัตโนมัติ"
โหมดการแยกชุดข้อความที่ใช้สำหรับการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท หรือใช้เธรดผู้ปฏิบัติงานเสมือนแทน
ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --override_repository=<an equals-separated mapping of repository name to path> รายการ
ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์จะใช้ตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางดังกล่าวจะสัมพัทธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --print_action_mnemonics=<a string> รายการ
รายการความทรงจำที่ใช้กรองข้อมูล Print_action โดยไม่มีการกรองเมื่อปล่อยว่างไว้

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

ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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
ค่าเริ่มต้น --[no]incompatible_disable_native_repo_rules: "เท็จ"
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก: 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
--[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" "auto" จะตั้งค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก: bazel_internal_configuration
ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือบิลด์ API ที่ไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE เข้าถึงได้
ค่าเริ่มต้น --[no]incompatible_config_setting_private_default_visibility: "เท็จ"
หากตัวยึดตำแหน่ง_enforce_config_setting_visibility=false จะหมายความว่าไม่มีการดำเนินการ หรือไม่เช่นนั้น หากแฟล็กนี้เป็นเท็จ 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
ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตการค้นหาและความหมาย
ค่าเริ่มต้น --aspect_deps=<off, conservative or precise>: "เชิงรับ"
วิธีแก้ไขทรัพยากร Dependency ในสัดส่วนภาพเมื่อรูปแบบเอาต์พุตเป็นหนึ่งใน {xml,protocol,record} "off" หมายความว่าจะไม่มีการแก้ไขทรัพยากร Dependency ใดๆ ส่วน "conservative" (ค่าเริ่มต้น) หมายความว่าจะมีการเพิ่มทรัพยากร Dependency ที่ประกาศทั้งหมด ไม่ว่าจะได้รับคลาสกฎของทรัพยากร Dependency โดยตรงหรือไม่ ส่วน "precise" หมายความว่ามีการเพิ่มเฉพาะด้านที่อาจทำงานอยู่เท่านั้นตามคลาสกฎของทรัพยากร Dependency โดยตรง โปรดทราบว่าโหมดแม่นยำต้องมีการโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียว ซึ่งจะทำให้ช้ากว่าโหมดอื่นๆ และโปรดทราบด้วยว่า โหมดแม้กระทั่งที่แม่นยำก็ไม่ได้แม่นยำทั้งหมด การตัดสินใจว่าจะคำนวณด้านใดด้านหนึ่งหรือไม่จะทำในขั้นตอนการวิเคราะห์ ซึ่งจะไม่ทำงานระหว่าง "การค้นหาแบบงัดแงะ"
แท็ก: build_file_semantics
ค่าเริ่มต้น --[no]consistent_labels: "เท็จ"
หากเปิดใช้ คำสั่งการค้นหาทุกคำสั่งจะปล่อยป้ายกำกับราวกับว่าฟังก์ชัน Starlark <code>str</code> ใช้กับอินสแตนซ์ <code>Label</code> ซึ่งมีประโยชน์สำหรับเครื่องมือที่จำเป็นต้องจับคู่เอาต์พุตของคำสั่งการค้นหาและ/หรือป้ายกำกับต่างๆ ที่กฎเรียกใช้ หากไม่เปิดใช้ ตัวจัดรูปแบบเอาต์พุตจะแสดงชื่อที่เก็บที่ชัดเจน (สัมพันธ์กับที่เก็บหลัก) แทนเพื่อทำให้เอาต์พุตอ่านได้ง่ายขึ้น
แท็ก: terminal_output
ค่าเริ่มต้น --[no]experimental_explicit_aspects: "เท็จ"
aquery, cquery: จะรวมการดำเนินการที่สร้างขึ้นในเอาต์พุตหรือไม่ คำค้นหา: no-op (ติดตามเสมอ)
แท็ก: terminal_output
ค่าเริ่มต้น --[no]experimental_graphless_query: "อัตโนมัติ"
หากเป็นจริง ให้ใช้การใช้การค้นหาที่ไม่ได้ทำสำเนาของกราฟ การใช้งานใหม่รองรับเฉพาะ --order_output=no รวมถึงชุดย่อยของตัวจัดรูปแบบเอาต์พุต
แท็ก: build_file_semantics, eagerness_to_exit
ค่าเริ่มต้น --graph:conditional_edges_limit=<an integer>: "4"
จำนวนสูงสุดของป้ายกำกับเงื่อนไขที่จะแสดง -1 หมายถึงไม่มีการตัดข้อความ และ 0 หมายถึงไม่มีคำอธิบายประกอบ ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก: 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 ที่การค้นหาทำงาน ทรัพยากร Dependency โดยนัยคือทรัพยากรที่ไม่มีการระบุอย่างชัดแจ้งในไฟล์ BUILD แต่เพิ่มโดย Bazel สำหรับ cquery ตัวเลือกนี้จะควบคุมการกรอง Toolchain ที่มีการแก้ปัญหาแล้ว
แท็ก: build_file_semantics
ค่าเริ่มต้น --[no]include_aspects: "true"
aquery, cquery: จะรวมการดำเนินการที่สร้างขึ้นในเอาต์พุตหรือไม่ คำค้นหา: no-op (ติดตามเสมอ)
แท็ก: terminal_output
ค่าเริ่มต้น --[no]incompatible_lexicographical_output: "true"
หากตั้งค่าตัวเลือกนี้ไว้ ให้จัดเรียง --order_output=autoปลาย ตามลำดับแบบพจนานุกรม
แท็ก: terminal_output, incompatible_change
ค่าเริ่มต้น --[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 ค่า ระบบจะไม่สนใจค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้ใช้ได้กับ "ข้อความค้นหา" เท่านั้น (ไม่ใช่ "cquery")
แท็ก: loading_and_analysis
ค่าเริ่มต้น --[no]line_terminator_null: "เท็จ"
กำหนดว่าแต่ละรูปแบบจะสิ้นสุดด้วย \0 แทนการขึ้นบรรทัดใหม่หรือไม่
แท็ก: terminal_output
ค่าเริ่มต้น --[no]nodep_deps: "true"
หากเปิดใช้ ระบบจะรวม Dep จากแอตทริบิวต์ "nodep" ไว้ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ตัวอย่างทั่วไปของแอตทริบิวต์ "nodep" คือ "ระดับการเข้าถึง" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ "info create-language" เพื่อดูข้อมูลเกี่ยวกับแอตทริบิวต์ "nodep" ทั้งหมดในภาษาของบิลด์
แท็ก: build_file_semantics
--noorder_results
แสดงผลลัพธ์ในแบบการขึ้นต่อกัน (ค่าเริ่มต้น) หรือไม่เรียงลำดับ ผลลัพธ์ที่ไม่เรียงลำดับจะเร็วขึ้น แต่จะได้รับการสนับสนุนเมื่อ --output ไม่ใช่ minrank, maxrank หรือกราฟ
ขยายเป็น
  --order_output=no

แท็ก: terminal_output
--null
กำหนดว่าแต่ละรูปแบบจะสิ้นสุดด้วย \0 แทนการขึ้นบรรทัดใหม่หรือไม่
ขยายเป็น
  --line_terminator_null=true

แท็ก: terminal_output
ค่าเริ่มต้น --order_output=<no, deps, auto or full>: "อัตโนมัติ"
แสดงผลลัพธ์โดยไม่เรียงลำดับ (ไม่) เรียงลำดับ Dependency (deps) หรือเรียงลำดับแบบเต็ม (เต็ม) ค่าเริ่มต้นคือ "อัตโนมัติ" ซึ่งหมายความว่าผลลัพธ์จะเป็นผลลัพธ์ตามลำดับการขึ้นต่อกันหรือเรียงลำดับทั้งหมด ขึ้นอยู่กับตัวจัดรูปแบบเอาต์พุต (เรียงลำดับการขึ้นต่อกันสำหรับ Proโต, minrank, maxrank และกราฟ เรียงลำดับอย่างสมบูรณ์สำหรับรายการอื่นๆ ทั้งหมด) เมื่อเรียงลำดับเอาต์พุตอย่างสมบูรณ์แล้ว โหนดจะพิมพ์ตามลำดับเชิงกำหนดโดยสมบูรณ์ (ทั้งหมด) ขั้นแรก โหนดทั้งหมดจัดเรียงตามตัวอักษร จากนั้นแต่ละโหนดในรายการจะใช้เป็นจุดเริ่มต้นของการค้นหาแรกหลังลำดับความลึก ซึ่งจะข้ามผ่านขอบขาออกไปยังโหนดที่ยังไม่ได้เข้าชม จะข้ามผ่านตามลำดับตัวอักษรของโหนดที่สืบทอดมา สุดท้าย โหนดจะถูกพิมพ์กลับกันของลำดับที่เข้าชม
แท็ก: terminal_output
--order_results
แสดงผลลัพธ์ในแบบการขึ้นต่อกัน (ค่าเริ่มต้น) หรือไม่เรียงลำดับ ผลลัพธ์ที่ไม่เรียงลำดับจะเร็วขึ้น แต่จะได้รับการสนับสนุนเมื่อ --output ไม่ใช่ minrank, maxrank หรือกราฟ
ขยายเป็น
  --order_output=auto

แท็ก: terminal_output
ค่าเริ่มต้น --output=<a string>: "ป้ายกำกับ"
รูปแบบที่ควรพิมพ์ผลการค้นหา ค่าที่อนุญาตสำหรับข้อความค้นหาได้แก่ create, graph, streamed_jsonprotocol, label, label_kind, location, maxrank, minrank, package, protocol, streamed_protocol, textprotocol, xml
แท็ก: terminal_output
ค่าเริ่มต้น --[no]proto:default_values: "true"
หากเป็น "จริง" ระบบจะรวมแอตทริบิวต์ที่ไม่ได้ระบุค่าไว้อย่างชัดแจ้งในไฟล์ BUILD มิเช่นนั้นระบบจะละเว้นแอตทริบิวต์เหล่านั้น ตัวเลือกนี้ใช้ได้กับ --output=prod
แท็ก: 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]strict_test_suite: "เท็จ"
หากเป็นจริง นิพจน์ testing() จะแจ้งข้อผิดพลาดหากพบ test_suite ที่มีเป้าหมายที่ไม่ใช่การทดสอบ
แท็ก: build_file_semantics, eagerness_to_exit
ค่าเริ่มต้น --[no]tool_deps: "true"
คำค้นหา: หากปิดใช้ ทรัพยากร Dependency ใน "การกำหนดค่าการดำเนินการ" จะไม่รวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน เอดจ์ของ "การกำหนดค่าผู้ดำเนินการ" เช่น กฎจากกฎ "protocol_library" ไปยังโปรโตคอลคอมไพเลอร์ โดยทั่วไปจะชี้ไปยังเครื่องมือที่ดำเนินการระหว่างบิลด์ ไม่ใช่เป็นส่วนหนึ่งของโปรแกรม "เป้าหมาย" เดียวกัน Cquery: หากปิดใช้ จะกรองเป้าหมายที่กำหนดค่าไว้ทั้งหมดซึ่งข้ามการเปลี่ยนการดำเนินการจากเป้าหมายระดับบนสุดที่ค้นพบเป้าหมายที่กำหนดค่าไว้นี้ออก ซึ่งหมายความว่าหากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าเป้าหมาย ระบบจะแสดงผลเฉพาะเป้าหมายที่กำหนดค่าไว้ในการกำหนดค่าเป้าหมายด้วย ถ้าเป้าหมายระดับบนสุดอยู่ในการกำหนดค่า exec ระบบจะแสดงผลเฉพาะเป้าหมายที่กำหนดค่าของ exec เท่านั้น ตัวเลือกนี้จะ "ไม่" ยกเว้น Toolchain ที่แก้ไขแล้ว
แท็ก: build_file_semantics
ค่าเริ่มต้นของ --universe_scope=<comma-separated list of options>: ""
ชุดรูปแบบเป้าหมายที่คั่นด้วยคอมมา (บวกและการลบ) การค้นหาอาจดำเนินการในจักรวาลที่กำหนดโดยการปิดแบบสับเปลี่ยนของเป้าหมายที่ระบุ ตัวเลือกนี้ใช้สําหรับคำสั่งการค้นหาและคำสั่ง cquery สำหรับ cquery อินพุตของตัวเลือกนี้จะเป็นเป้าหมายในการสร้างคำตอบทั้งหมด ดังนั้นตัวเลือกนี้อาจส่งผลต่อการกําหนดค่าและการเปลี่ยน หากไม่ได้ระบุตัวเลือกนี้ ระบบจะถือว่าเป้าหมายระดับบนสุดเป็นเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหา หมายเหตุ: สำหรับ cquery การไม่ระบุตัวเลือกนี้อาจทำให้บิลด์ไม่ทำงานหากเป้าหมายที่แยกวิเคราะห์จากนิพจน์คำค้นหาไม่สามารถสร้างได้ด้วยตัวเลือกระดับบนสุด
แท็ก: loading_and_analysis
ค่าเริ่มต้น --[no]xml:default_values: "เท็จ"
หากเป็น "จริง" ระบบจะพิมพ์แอตทริบิวต์ของกฎที่ไม่ได้ระบุค่าไว้อย่างชัดแจ้งในไฟล์ BUILD มิเช่นนั้นระบบจะพิมพ์แอตทริบิวต์เหล่านั้นออก
แท็ก: terminal_output
ค่าเริ่มต้น --[no]xml:line_numbers: "true"
หากเป็น "จริง" เอาต์พุต XML จะมีหมายเลขบรรทัด การปิดใช้ตัวเลือกนี้อาจทำให้อ่านความแตกต่างได้ง่ายขึ้น ตัวเลือกนี้ใช้ได้กับ --output=xml เท่านั้น
แท็ก: terminal_output
ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ 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, refresh 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 เก่า) หลังจาก GC เต็ม <count> รายการติดต่อกันภายใน <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 รายการที่มีการกระทำมากที่สุด การตั้งค่าตัวเลือกนี้จะเป็นการเขียนสถิติสำหรับการช่วยจำทั้งหมด
ค่าเริ่มต้นของ --experimental_repository_resolved_file=<a string>: ""
หากไม่ว่างเปล่า ให้เขียนค่า Starlark พร้อมข้อมูลที่แก้ไขแล้วของกฎที่เก็บ Starlark ทั้งหมดที่ดำเนินการ
แท็ก: affects_outputs
ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง 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 เดียวกัน
ค่าเริ่มต้น --experimental_worker_for_repo_fetching=<off, platform, virtual or auto>: "อัตโนมัติ"
โหมดการแยกชุดข้อความที่ใช้สำหรับการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท หรือใช้เธรดผู้ปฏิบัติงานเสมือนแทน
ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --deleted_packages=<comma-separated list of package names> รายการ
รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริง แม้ว่าจะแสดงอยู่ในที่ใดที่หนึ่งบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ ตัวอย่างเช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์ของคุณ ระบบบิลด์อาจบ่นหากพบป้ายกำกับ "//x:y/z" หากยังพบป้ายกำกับโดยรายการpackage_path อื่นอยู่ การระบุ --deleted_packages x/y ช่วยป้องกันปัญหานี้
ค่าเริ่มต้น --[no]fetch: "true"
อนุญาตให้คำสั่งดึงข้อมูลทรัพยากร Dependency ภายนอก หากตั้งค่าเป็น "เท็จ" คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ และหากไม่มี คำสั่งดังกล่าวจะทำให้การทำงานล้มเหลว
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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 พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ:"

ตัวเลือกการเรียกใช้

รับค่าตัวเลือกทั้งหมดจาก 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
ค่าเริ่มต้น --[no]incompatible_disable_native_repo_rules: "เท็จ"
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก: 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]run: "true"
หากเป็น "เท็จ" ให้ข้ามการเรียกใช้บรรทัดคำสั่งที่สร้างขึ้นสำหรับเป้าหมายที่สร้างขึ้น
แท็ก: affects_outputs
ตัวเลือกที่ควบคุมการดำเนินการของบิลด์มีดังนี้
ค่าเริ่มต้น --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
เปอร์เซ็นต์ของพื้นที่เก็บข้อมูลที่ใช้งานได้ (0-100) ซึ่งสูงกว่าที่ GcThrashingDetector จะพิจารณาเหตุการณ์แรงดันหน่วยความจำเทียบกับขีดจำกัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก: host_machine_resource_optimizations
ตัวเลือกที่ให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการซึ่งส่งผลต่อค่าของแท็ก ซึ่งต่างจากที่มีอยู่
ค่าเริ่มต้น --script_path=<a path>: ดูคำอธิบาย
หากตั้งค่าไว้ ให้เขียนสคริปต์เชลล์ไปยังไฟล์ซึ่งเรียกใช้เป้าหมาย หากตั้งค่านโยบายนี้ เป้าหมายจะไม่เรียกใช้จาก Bazel ใช้ "bazel Run --script_path=foo //foo && ./foo" เพื่อเรียกใช้เป้าหมาย "//foo" ซึ่งแตกต่างจาก "bazel run //foo" ตรงที่ปล่อยล็อก Bazel และไฟล์ปฏิบัติการเชื่อมต่อกับ Stin ของเทอร์มินัล
แท็ก: affects_outputs, execution
ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ 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, refresh 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 เก่า) หลังจาก GC เต็ม <count> รายการติดต่อกันภายใน <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 เดียวกัน
ค่าเริ่มต้น --experimental_worker_for_repo_fetching=<off, platform, virtual or auto>: "อัตโนมัติ"
โหมดการแยกชุดข้อความที่ใช้สำหรับการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท หรือใช้เธรดผู้ปฏิบัติงานเสมือนแทน
ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --override_repository=<an equals-separated mapping of repository name to path> รายการ
ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์จะใช้ตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" แสดงว่าสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"

ตัวเลือกการปิดเครื่อง

ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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
ค่าเริ่มต้น --[no]incompatible_disable_native_repo_rules: "เท็จ"
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก: 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
ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่งมีดังนี้
ค่าเริ่มต้น --iff_heap_size_greater_than=<an integer>: "0"
หากไม่ใช่ 0 การปิดเซิร์ฟเวอร์จะปิดก็ต่อเมื่อหน่วยความจำรวม (เป็น MB) ที่ JVM ใช้เกินค่านี้
แท็ก: loses_incremental_state, eagerness_to_exit
ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ 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, refresh 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 เก่า) หลังจาก GC เต็ม <count> รายการติดต่อกันภายใน <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 เดียวกัน
ค่าเริ่มต้น --experimental_worker_for_repo_fetching=<off, platform, virtual or auto>: "อัตโนมัติ"
โหมดการแยกชุดข้อความที่ใช้สำหรับการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท หรือใช้เธรดผู้ปฏิบัติงานเสมือนแทน
ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --override_repository=<an equals-separated mapping of repository name to path> รายการ
ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์จะใช้ตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" แสดงว่าสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"

ตัวเลือกการซิงค์

ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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
ค่าเริ่มต้น --[no]incompatible_disable_native_repo_rules: "เท็จ"
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก: 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]configure: "เท็จ"
เฉพาะที่เก็บที่มีเครื่องหมายว่า "กำหนดค่า" เพื่อจุดประสงค์ในการกำหนดค่าระบบเท่านั้น
แท็ก: changes_inputs
ค่าเริ่มต้น --gc_thrashing_threshold=<an integer in 0-100 range>: "100"
เปอร์เซ็นต์ของพื้นที่เก็บข้อมูลที่ใช้งานได้ (0-100) ซึ่งสูงกว่าที่ GcThrashingDetector จะพิจารณาเหตุการณ์แรงดันหน่วยความจำเทียบกับขีดจำกัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก: host_machine_resource_optimizations
--[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" "auto" จะตั้งค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก: bazel_internal_configuration
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --only=<a string> รายการ
หากมีตัวเลือกนี้ไว้ ให้ซิงค์เฉพาะที่เก็บที่ระบุด้วยตัวเลือกนี้ แต่ยังถือว่าทั้งหมด (หรือทั้งหมดที่เหมือนกับการกำหนดค่า ของ --กำหนดค่า) ล้าสมัย
แท็ก: changes_inputs
ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือบิลด์ API ที่ไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE เข้าถึงได้
ค่าเริ่มต้น --[no]incompatible_config_setting_private_default_visibility: "เท็จ"
หากตัวยึดตำแหน่ง_enforce_config_setting_visibility=false จะหมายความว่าไม่มีการดำเนินการ หรือไม่เช่นนั้น หากแฟล็กนี้เป็นเท็จ 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
ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ 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, refresh 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 เก่า) หลังจาก GC เต็ม <count> รายการติดต่อกันภายใน <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 รายการที่มีการกระทำมากที่สุด การตั้งค่าตัวเลือกนี้จะเป็นการเขียนสถิติสำหรับการช่วยจำทั้งหมด
ค่าเริ่มต้นของ --experimental_repository_resolved_file=<a string>: ""
หากไม่ว่างเปล่า ให้เขียนค่า Starlark พร้อมข้อมูลที่แก้ไขแล้วของกฎที่เก็บ Starlark ทั้งหมดที่ดำเนินการ
แท็ก: affects_outputs
ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง 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 เดียวกัน
ค่าเริ่มต้น --experimental_worker_for_repo_fetching=<off, platform, virtual or auto>: "อัตโนมัติ"
โหมดการแยกชุดข้อความที่ใช้สำหรับการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท หรือใช้เธรดผู้ปฏิบัติงานเสมือนแทน
ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --deleted_packages=<comma-separated list of package names> รายการ
รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริง แม้ว่าจะแสดงอยู่ในที่ใดที่หนึ่งบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ ตัวอย่างเช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์ของคุณ ระบบบิลด์อาจบ่นหากพบป้ายกำกับ "//x:y/z" หากยังพบป้ายกำกับโดยรายการpackage_path อื่นอยู่ การระบุ --deleted_packages x/y ช่วยป้องกันปัญหานี้
ค่าเริ่มต้น --[no]fetch: "true"
อนุญาตให้คำสั่งดึงข้อมูลทรัพยากร Dependency ภายนอก หากตั้งค่าเป็น "เท็จ" คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ และหากไม่มี คำสั่งดังกล่าวจะทำให้การทำงานล้มเหลว
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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 พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ:"

ตัวเลือกการทดสอบ

รับค่าตัวเลือกทั้งหมดจาก 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
ค่าเริ่มต้น --[no]incompatible_disable_native_repo_rules: "เท็จ"
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก: 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, refresh 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 เก่า) หลังจาก GC เต็ม <count> รายการติดต่อกันภายใน <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 รายการที่มีการกระทำมากที่สุด การตั้งค่าตัวเลือกนี้จะเป็นการเขียนสถิติสำหรับการช่วยจำทั้งหมด
ค่าเริ่มต้น --[no]print_relative_test_log_paths: "เท็จ"
หากเป็นจริง เมื่อพิมพ์เส้นทางไปยังบันทึกการทดสอบ ให้ใช้เส้นทางแบบสัมพัทธ์ที่ใช้ลิงก์สัญลักษณ์ความสะดวก "testlogs" หมายเหตุ - การเรียกใช้ 'build'/'test'/ฯลฯ ที่มีการกำหนดค่าต่างกันอาจทำให้เป้าหมายของลิงก์สัญลักษณ์นี้เปลี่ยนไป ทำให้เส้นทางที่พิมพ์ก่อนหน้านี้ไม่มีประโยชน์อีกต่อไป
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]test_verbose_timeout_warnings: "เท็จ"
หากเป็น "จริง" ให้พิมพ์คำเตือนเพิ่มเติมเมื่อเวลาการดำเนินการทดสอบจริงไม่ตรงกับระยะหมดเวลาที่กำหนดโดยการทดสอบ (ไม่ว่าจะโดยนัยหรือโดยชัดแจ้ง)
แท็ก: affects_outputs
ค่าเริ่มต้น --[no]verbose_test_summary: "true"
หากเป็นจริง ให้พิมพ์ข้อมูลเพิ่มเติม (ระยะเวลา จำนวนการเรียกใช้ที่ล้มเหลว ฯลฯ) ในสรุปการทดสอบ
แท็ก: affects_outputs
ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง 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 เดียวกัน
ค่าเริ่มต้น --experimental_worker_for_repo_fetching=<off, platform, virtual or auto>: "อัตโนมัติ"
โหมดการแยกชุดข้อความที่ใช้สำหรับการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท หรือใช้เธรดผู้ปฏิบัติงานเสมือนแทน
ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --override_repository=<an equals-separated mapping of repository name to path> รายการ
ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์จะใช้ตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" แสดงว่าสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"

ตัวเลือกของผู้ให้บริการ

ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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
ค่าเริ่มต้น --[no]incompatible_disable_native_repo_rules: "เท็จ"
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก: 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
--[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" "auto" จะตั้งค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก: bazel_internal_configuration
ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือบิลด์ API ที่ไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE เข้าถึงได้
ค่าเริ่มต้น --[no]incompatible_config_setting_private_default_visibility: "เท็จ"
หากตัวยึดตำแหน่ง_enforce_config_setting_visibility=false จะหมายความว่าไม่มีการดำเนินการ หรือไม่เช่นนั้น หากแฟล็กนี้เป็นเท็จ 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
ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ 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, refresh 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
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --repo=<a string> รายการ
เฉพาะผู้ให้บริการในที่เก็บที่ระบุ ซึ่งอาจเป็น "@apparent_repo_name" หรือ "@@canonical_repo_name" ตัวเลือกนี้ตั้งค่าได้หลายครั้ง
แท็ก: 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 เก่า) หลังจาก GC เต็ม <count> รายการติดต่อกันภายใน <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 เดียวกัน
ค่าเริ่มต้น --experimental_worker_for_repo_fetching=<off, platform, virtual or auto>: "อัตโนมัติ"
โหมดการแยกชุดข้อความที่ใช้สำหรับการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท หรือใช้เธรดผู้ปฏิบัติงานเสมือนแทน
ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --deleted_packages=<comma-separated list of package names> รายการ
รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริง แม้ว่าจะแสดงอยู่ในที่ใดที่หนึ่งบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ ตัวอย่างเช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์ของคุณ ระบบบิลด์อาจบ่นหากพบป้ายกำกับ "//x:y/z" หากยังพบป้ายกำกับโดยรายการpackage_path อื่นอยู่ การระบุ --deleted_packages x/y ช่วยป้องกันปัญหานี้
ค่าเริ่มต้น --[no]fetch: "true"
อนุญาตให้คำสั่งดึงข้อมูลทรัพยากร Dependency ภายนอก หากตั้งค่าเป็น "เท็จ" คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ และหากไม่มี คำสั่งดังกล่าวจะทำให้การทำงานล้มเหลว
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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 พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ:"

ตัวเลือกเวอร์ชัน

ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --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
ค่าเริ่มต้น --[no]incompatible_disable_native_repo_rules: "เท็จ"
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก: 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
ตัวเลือกที่ให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการซึ่งส่งผลต่อค่าของแท็ก ซึ่งต่างจากที่มีอยู่
ค่าเริ่มต้น --[no]gnu_format: "เท็จ"
หากตั้งค่า ให้เขียนเวอร์ชันเป็น Sttdout โดยใช้รูปแบบที่อธิบายไว้ในมาตรฐาน GNU
แท็ก: affects_outputs, execution
ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ 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, refresh 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 เก่า) หลังจาก GC เต็ม <count> รายการติดต่อกันภายใน <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 เดียวกัน
ค่าเริ่มต้น --experimental_worker_for_repo_fetching=<off, platform, virtual or auto>: "อัตโนมัติ"
โหมดการแยกชุดข้อความที่ใช้สำหรับการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท หรือใช้เธรดผู้ปฏิบัติงานเสมือนแทน
ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
ระบบได้สะสมการใช้งานหลายครั้งแล้ว --override_repository=<an equals-separated mapping of repository name to path> รายการ
ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์จะใช้ตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" แสดงว่าสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"

แท็กเอฟเฟกต์ตัวเลือก

unknown ตัวเลือกนี้มีผลกระทบที่ไม่รู้จักหรือไม่ได้ระบุไว้
no_op ตัวเลือกนี้ไม่มีผลใดๆ ทั้งสิ้น
loses_incremental_state การเปลี่ยนค่าของตัวเลือกนี้อาจทำให้สูญเสียสถานะที่เพิ่มขึ้นเป็นอย่างมาก ซึ่งจะทำให้บิลด์ช้าลง สถานะอาจสูญหายเนื่องจากการรีสตาร์ทเซิร์ฟเวอร์หรือการทำให้กราฟทรัพยากร Dependency ส่วนใหญ่ถูกยกเลิก
changes_inputs ตัวเลือกนี้จะเปลี่ยนอินพุตที่ bazel พิจารณาสำหรับบิลด์ เช่น ข้อจำกัดของระบบไฟล์ เวอร์ชันของที่เก็บ หรือตัวเลือกอื่นๆ
affects_outputs ตัวเลือกนี้จะส่งผลต่อเอาต์พุตของ bazel แท็กนี้ตั้งใจให้กว้างขึ้น สามารถรวมผลกระทบแบบสับเปลี่ยน และไม่ระบุประเภทของเอาต์พุตที่จะได้รับผลกระทบ
build_file_semantics ตัวเลือกนี้จะมีผลกับความหมายของไฟล์ BUILD หรือ .bzl
bazel_internal_configuration ตัวเลือกนี้จะมีผลกับการตั้งค่าเครื่องจักรภายในแบบ bazel แท็กนี้ไม่ได้หมายความว่าอาร์ติแฟกต์ของบิลด์ได้รับผลกระทบ
loading_and_analysis ตัวเลือกนี้ส่งผลต่อการโหลดและการวิเคราะห์ทรัพยากร Dependency และการสร้างกราฟทรัพยากร Dependency
execution ตัวเลือกนี้จะส่งผลต่อระยะการดำเนินการ เช่น ตัวเลือกที่เกี่ยวข้องกับการทำแซนด์บ็อกซ์หรือการดำเนินการระยะไกล
host_machine_resource_optimizations ตัวเลือกนี้จะทริกเกอร์การเพิ่มประสิทธิภาพที่อาจเจาะจงเครื่องและไม่รับประกันว่าจะใช้ได้กับคอมพิวเตอร์ทุกเครื่อง การเพิ่มประสิทธิภาพอาจรวมถึงการแลกกับประสิทธิภาพด้านอื่นๆ เช่น หน่วยความจำหรือต้นทุน CPU
eagerness_to_exit ตัวเลือกนี้จะเปลี่ยนวิธีที่ทำให้bazelตั้งใจจะออกจากความล้มเหลว คือมีทางเลือกระหว่างการดำเนินการต่อแม้จะล้มเหลวและยุติการเรียกใช้อยู่
bazel_monitoring ตัวเลือกนี้ใช้เพื่อตรวจสอบพฤติกรรมและประสิทธิภาพของ Bazel
terminal_output ตัวเลือกนี้จะมีผลกับเอาต์พุตเทอร์มินัลของ bazel
action_command_lines ตัวเลือกนี้จะเปลี่ยนอาร์กิวเมนต์บรรทัดคำสั่งของการดำเนินการบิลด์อย่างน้อย 1 รายการ
test_runner ตัวเลือกนี้จะเปลี่ยนสภาพแวดล้อมผู้ทดสอบของบิลด์

แท็กข้อมูลเมตาของตัวเลือก

experimental ตัวเลือกนี้จะเรียกใช้ฟีเจอร์ทดลองโดยไม่มีการรับประกันฟังก์ชันการทำงาน
incompatible_change ตัวเลือกนี้จะทำให้เกิดการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ ใช้ตัวเลือกนี้เพื่อทดสอบความพร้อมในการย้ายข้อมูลหรือทดลองใช้ฟีเจอร์ใหม่ก่อนเปิดตัว
deprecated ตัวเลือกนี้เลิกใช้งานแล้ว อาจเป็นไปได้ว่าฟีเจอร์ที่ได้รับผลกระทบเลิกใช้งานแล้ว หรืออาจแนะนำวิธีระบุข้อมูลอื่น