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]
โดยปกติแล้ว ตัวเลือกแบบ 3 สถานะจะตั้งค่าเป็นอัตโนมัติโดยค่าเริ่มต้น และสามารถ บังคับเปิดใช้ได้ดังนี้
--<option>=[true|yes|1]
--no<option> --<option>=[false|no|0]
คำสั่ง
analyze-profile |
วิเคราะห์ข้อมูลโปรไฟล์การสร้าง |
aquery |
วิเคราะห์เป้าหมายที่ระบุและค้นหากราฟการดำเนินการ |
build |
สร้างเป้าหมายที่ระบุ |
canonicalize-flags |
จัดรูปแบบรายการตัวเลือก Bazel |
clean |
นำไฟล์เอาต์พุตออกและหยุดเซิร์ฟเวอร์ (หากต้องการ) |
coverage |
สร้างรายงานความครอบคลุมของโค้ดสำหรับเป้าหมายการทดสอบที่ระบุ |
cquery |
โหลด วิเคราะห์ และค้นหาเป้าหมายที่ระบุพร้อมการกำหนดค่า |
dump |
ส่งออกสถานะภายในของกระบวนการเซิร์ฟเวอร์ Bazel |
fetch |
ดึงข้อมูลที่เก็บภายนอกซึ่งเป็นข้อกำหนดเบื้องต้นของเป้าหมาย |
help |
พิมพ์ความช่วยเหลือสำหรับคำสั่งหรือดัชนี |
info |
แสดงข้อมูลรันไทม์เกี่ยวกับเซิร์ฟเวอร์ Bazel |
license |
พิมพ์ใบอนุญาตของซอฟต์แวร์นี้ |
mobile-install |
ติดตั้งเป้าหมายไปยังอุปกรณ์เคลื่อนที่ |
mod |
ค้นหากราฟทรัพยากร Dependency ภายนอกของ Bzlmod |
print_action |
พิมพ์อาร์กิวเมนต์บรรทัดคำสั่งสำหรับการคอมไพล์ไฟล์ |
query |
ดำเนินการค้นหากราฟทรัพยากร Dependency |
run |
เรียกใช้เป้าหมายที่ระบุ |
shutdown |
หยุดเซิร์ฟเวอร์ Bazel |
sync |
ซิงค์ที่เก็บทั้งหมดที่ระบุในไฟล์พื้นที่ทำงาน |
test |
สร้างและเรียกใช้เป้าหมายการทดสอบที่ระบุ |
version |
พิมพ์ข้อมูลเวอร์ชันสำหรับ Bazel |
ตัวเลือกการเริ่มต้น
- ตัวเลือกที่ปรากฏก่อนคำสั่งและไคลเอ็นต์แยกวิเคราะห์
--[no]autodetect_server_javabase
ค่าเริ่มต้น: "จริง"-
เมื่อส่ง --noautodetect_server_javabase Bazel จะไม่กลับไปใช้ JDK ในเครื่องเพื่อเรียกใช้เซิร์ฟเวอร์ Bazel แต่จะออกแทน
แท็ก:affects_outputs
,loses_incremental_state
--[no]batch
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ Bazel จะทำงานเป็นเพียงกระบวนการไคลเอ็นต์ที่ไม่มีเซิร์ฟเวอร์แทนที่จะเป็นโหมดไคลเอ็นต์/เซิร์ฟเวอร์มาตรฐาน เลิกใช้งานแล้วและจะนำออก โปรดปิดเซิร์ฟเวอร์อย่างชัดเจนหากต้องการหลีกเลี่ยงเซิร์ฟเวอร์ที่ยังคงทำงานอยู่
แท็กloses_incremental_state
,bazel_internal_configuration
,deprecated
--[no]batch_cpu_scheduling
ค่าเริ่มต้น: "false"-
ใน Linux เท่านั้น ให้ใช้การจัดกำหนดการ CPU แบบ "batch" สำหรับ Blaze นโยบายนี้มีประโยชน์สำหรับภาระงานที่ไม่มีการโต้ตอบ แต่ไม่ต้องการลดค่า nice ดู "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
ค่าเริ่มต้น: "จริง"-
เมื่อส่ง --noblock_for_lock Bazel จะไม่รอให้คำสั่งที่กำลังทำงานเสร็จสมบูรณ์ แต่จะออกทันที
แท็กeagerness_to_exit
--[no]client_debug
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้บันทึกข้อมูลการแก้ไขข้อบกพร่องจากไคลเอ็นต์ไปยัง stderr การเปลี่ยนตัวเลือกนี้จะไม่ทำให้เซิร์ฟเวอร์รีสตาร์ท
แท็ก:affects_outputs
,bazel_monitoring
--connect_timeout_secs=<an integer>
ค่าเริ่มต้น: "30"-
ระยะเวลาที่ไคลเอ็นต์รอการพยายามเชื่อมต่อกับเซิร์ฟเวอร์แต่ละครั้ง
แท็กbazel_internal_configuration
--[no]expand_configs_in_place
ค่าเริ่มต้น: "จริง"-
เปลี่ยนการขยายแฟล็ก --config ให้ดำเนินการในตำแหน่งเดิม แทนที่จะขยายในจุดคงที่ระหว่างตัวเลือก rc ปกติกับตัวเลือกที่ระบุในบรรทัดคำสั่ง
แท็ก:no_op
,deprecated
--failure_detail_out=<path>
ค่าเริ่มต้น: ดูคำอธิบาย-
หากตั้งค่าไว้ จะระบุตำแหน่งที่จะเขียนข้อความ protobuf failure_detail หากเซิร์ฟเวอร์เกิดข้อผิดพลาดและรายงานผ่าน gRPC ไม่ได้ตามปกติ มิฉะนั้น ตำแหน่งจะเป็น ${OUTPUT_BASE}/failure_detail.rawproto
แท็ก:affects_outputs
,loses_incremental_state
--[no]home_rc
ค่าเริ่มต้น: "จริง"-
จะค้นหาไฟล์ .bazelrc ในไดเรกทอรีหน้าแรกที่ $HOME/.bazelrc หรือไม่
แท็ก:changes_inputs
--[no]idle_server_tasks
ค่าเริ่มต้น: "จริง"-
เรียกใช้ System.gc() เมื่อเซิร์ฟเวอร์ไม่ได้ใช้งาน
แท็กloses_incremental_state
,host_machine_resource_optimizations
--[no]ignore_all_rc_files
ค่าเริ่มต้น: "false"-
ปิดใช้ไฟล์ 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>
ค่าเริ่มต้น: "default"-
ตั้งค่าคลาสบริการ QoS ของเซิร์ฟเวอร์ Bazel เมื่อทำงานใน macOS โดยแฟล็กนี้จะไม่มีผลกับแพลตฟอร์มอื่นๆ ทั้งหมด แต่รองรับเพื่อให้มั่นใจว่าไฟล์ rc สามารถแชร์ระหว่างแพลตฟอร์มได้โดยไม่ต้องเปลี่ยนแปลง ค่าที่เป็นไปได้ ได้แก่ user-interactive, user-initiated, default, utility และ background
แท็ก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 help shutdown"
แท็ก:affects_outputs
,loses_incremental_state
--output_user_root=<path>
ค่าเริ่มต้น: ดูคำอธิบาย-
ไดเรกทอรีเฉพาะผู้ใช้ที่เขียนเอาต์พุตการสร้างทั้งหมดไว้ใต้ไดเรกทอรีนี้ โดยค่าเริ่มต้นจะเป็นฟังก์ชันของ $USER แต่การระบุค่าคงที่จะช่วยให้ผู้ใช้ที่ทำงานร่วมกันแชร์เอาต์พุตการสร้างได้
แท็ก:affects_outputs
,loses_incremental_state
--[no]preemptible
ค่าเริ่มต้น: "false"-
หากเป็นจริง ระบบจะขัดจังหวะคำสั่งได้หากมีการเริ่มคำสั่งอื่น
แท็กeagerness_to_exit
--server_jvm_out=<path>
ค่าเริ่มต้น: ดูคำอธิบาย-
ตำแหน่งที่จะเขียนเอาต์พุตของ JVM ของเซิร์ฟเวอร์ หากไม่ได้ตั้งค่า ระบบจะใช้ตำแหน่งใน output_base เป็นค่าเริ่มต้น
แท็ก:affects_outputs
,loses_incremental_state
--[no]shutdown_on_low_sys_mem
ค่าเริ่มต้น: "false"-
หากตั้งค่า max_idle_secs และเซิร์ฟเวอร์บิลด์ไม่ได้ใช้งานมาระยะหนึ่ง ให้ปิดเซิร์ฟเวอร์เมื่อระบบมี RAM ที่มีพื้นที่ว่างเหลือน้อย Linux เท่านั้น
แท็ก:eagerness_to_exit
,loses_incremental_state
--[no]system_rc
ค่าเริ่มต้น: "จริง"-
จะค้นหา bazelrc ทั่วทั้งระบบหรือไม่
แท็กchanges_inputs
--[no]unlimit_coredumps
ค่าเริ่มต้น: "false"-
เพิ่มขีดจำกัดแบบไม่บังคับของ Coredump เป็นขีดจำกัดแบบบังคับเพื่อให้สร้าง Coredump ของเซิร์ฟเวอร์ (รวมถึง JVM) และไคลเอ็นต์ได้ภายใต้เงื่อนไขทั่วไป ใส่ Flag นี้ใน bazelrc เพียงครั้งเดียวแล้วไม่ต้องสนใจอีก เพื่อให้คุณได้รับ Core Dump เมื่อพบเงื่อนไขที่ทริกเกอร์
แท็กbazel_internal_configuration
--[no]watchfs
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะพยายามใช้บริการตรวจสอบไฟล์ของระบบปฏิบัติการสำหรับการเปลี่ยนแปลงในเครื่องแทนการสแกนทุกไฟล์เพื่อหาการเปลี่ยนแปลง
แท็กdeprecated
--[no]windows_enable_symlinks
ค่าเริ่มต้น: "false"-
หากเป็นจริง ระบบจะสร้างลิงก์สัญลักษณ์จริงใน Windows แทนการคัดลอกไฟล์ ต้องเปิดใช้โหมดนักพัฒนาแอปของ Windows และใช้ Windows 10 เวอร์ชัน 1703 ขึ้นไป
แท็กbazel_internal_configuration
--[no]workspace_rc
ค่าเริ่มต้น: "จริง"-
จะค้นหาไฟล์ bazelrc ของพื้นที่ทำงานที่ $workspace/.bazelrc หรือไม่
แท็กchanges_inputs
--host_jvm_args=<jvm_arg>
มีการสะสมการใช้งานหลายครั้ง- Flags to pass to the JVM executing Blaze.
--host_jvm_debug
-
ตัวเลือกที่สะดวกในการเพิ่มแฟล็กการเริ่มต้น 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>
ค่าเริ่มต้น: ""- ตัวเลือกที่สะดวกในการเพิ่มแฟล็กการเริ่มต้น JVM ที่เฉพาะเจาะจงสำหรับโปรไฟล์เลอร์/ดีบักเกอร์บางรายการ Bazel มีรายการค่าที่รู้จักซึ่งจะแมปกับแฟล็กการเริ่มต้น JVM ที่ฮาร์ดโค้ด และอาจค้นหาเส้นทางที่ฮาร์ดโค้ดบางเส้นทางสำหรับไฟล์บางไฟล์
--server_javabase=<jvm path>
ค่าเริ่มต้น: ""- เส้นทางไปยัง JVM ที่ใช้เรียกใช้ Bazel เอง
ตัวเลือกที่ใช้ร่วมกันในคำสั่งทั้งหมด
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
--experimental_oom_more_eagerly_threshold=<an integer>
ค่าเริ่มต้น: "100"-
หากตั้งค่าแฟล็กนี้เป็นค่าที่น้อยกว่า 100 Bazel จะ OOM หากหลังจาก GC แบบเต็ม 2 ครั้งแล้ว ยังมีฮีป (รุ่นเก่า) มากกว่าเปอร์เซ็นต์นี้ที่ยังคงใช้งานอยู่
แท็กhost_machine_resource_optimizations
--experimental_ui_max_stdouterr_bytes=<an integer in (-1)-1073741819 range>
ค่าเริ่มต้น: "1048576"-
ขนาดสูงสุดของไฟล์ stdout / stderr ที่จะพิมพ์ไปยังคอนโซล -1 หมายถึงไม่มีขีดจำกัด
แท็ก:execution
- ตัวเลือกที่กำหนดค่าเครื่องมือที่ใช้สำหรับการดำเนินการ
--[no]incompatible_enable_proto_toolchain_resolution
ค่าเริ่มต้น: "false"-
หากเป็นจริง กฎภาษาโปรโตคอลจะกำหนดเครื่องมือจากที่เก็บ rules_proto, rules_java, rules_cc
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่อนุญาตให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการ ซึ่งจะส่งผลต่อค่าของเอาต์พุตนั้น ไม่ใช่การมีอยู่ของเอาต์พุต
--repo_env=<a 'name=value' assignment with an optional value part>
มีการสะสมการใช้งานหลายครั้ง-
ระบุตัวแปรสภาพแวดล้อมเพิ่มเติมที่จะใช้ได้เฉพาะกับกฎของที่เก็บ โปรดทราบว่ากฎของที่เก็บจะเห็นสภาพแวดล้อมทั้งหมดอยู่แล้ว แต่ในลักษณะนี้ ข้อมูลการกำหนดค่าจะส่งไปยังที่เก็บผ่านตัวเลือกได้โดยไม่ต้องทำให้กราฟการดำเนินการไม่ถูกต้อง
แท็ก:action_command_lines
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้ข้อมูลอินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าสถานะ ฯลฯ)
--[no]check_bzl_visibility
ค่าเริ่มต้น: "จริง"-
หากปิดใช้ ข้อผิดพลาดเกี่ยวกับระดับการเข้าถึงการโหลด .bzl จะลดระดับเป็นคำเตือน
แท็ก:build_file_semantics
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ในไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE:
--[no]enable_bzlmod
ค่าเริ่มต้น: "false"-
หากเป็นจริง จะเปิดใช้ระบบการจัดการทรัพยากร Dependency ของ Bzlmod โดยมีความสำคัญเหนือกว่า WORKSPACE ดูข้อมูลเพิ่มเติมได้ที่ https://bazel.build/docs/bzlmod
แท็กloading_and_analysis
--[no]experimental_action_resource_set
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็นจริง ctx.actions.run() และ ctx.actions.run_shell() จะยอมรับพารามิเตอร์ resource_set สำหรับการดำเนินการในเครื่อง ไม่เช่นนั้น ระบบจะตั้งค่าเริ่มต้นเป็นหน่วยความจำ 250 MB และ CPU 1 รายการ
แท็กexecution
,build_file_semantics
,experimental
-
หากตั้งค่าเป็นจริง ระบบจะส่งต่อแท็กจากเป้าหมายไปยังข้อกำหนดการดำเนินการของ Actions มิเช่นนั้นจะไม่ส่งต่อแท็ก ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/8830
แท็ก:build_file_semantics
,experimental
--[no]experimental_analysis_test_call
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็น "จริง" การเรียกใช้ฟังก์ชันดั้งเดิม analysis_test จะพร้อมใช้งาน
แท็กloading_and_analysis
,build_file_semantics
,experimental
--[no]experimental_bzl_visibility
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ จะเพิ่มฟังก์ชัน `visibility()` ที่ไฟล์ .bzl อาจเรียกใช้ในระหว่างการประเมินระดับบนสุดเพื่อตั้งค่าระดับการมองเห็นสำหรับคำสั่ง load()
แท็ก:loading_and_analysis
,experimental
-
หากตั้งค่าเป็น true แอตทริบิวต์ของกฎและเมธอด Starlark API ที่จำเป็นสำหรับกฎ cc_shared_library จะพร้อมใช้งาน
แท็กbuild_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_disable_external_package
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" แพ็กเกจ //external ที่สร้างขึ้นโดยอัตโนมัติจะใช้งานไม่ได้อีกต่อไป Bazel จะยังคงแยกวิเคราะห์ไฟล์ "external/BUILD" ไม่ได้ แต่ glob ที่เข้าถึง external/ จากแพ็กเกจที่ไม่มีชื่อจะใช้งานได้
แท็กloading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_enable_android_migration_apis
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" จะเปิดใช้ API ที่จำเป็นต่อการรองรับการย้ายข้อมูล Android Starlark
แท็กbuild_file_semantics
--[no]experimental_get_fixed_configured_action_env
ค่าเริ่มต้น: "false"-
หากเปิดใช้ action.env จะแสดงตัวแปรสภาพแวดล้อมคงที่ที่ระบุผ่านการกำหนดค่าฟีเจอร์ด้วย
แท็ก:loading_and_analysis
,experimental
--[no]experimental_google_legacy_api
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็นจริง จะแสดงชิ้นส่วนทดลองจำนวนหนึ่งของ Starlark Build API ที่เกี่ยวข้องกับโค้ดเดิมของ Google
แท็ก:loading_and_analysis
,experimental
--[no]experimental_isolated_extension_usages
ค่าเริ่มต้น: "false"-
หากเป็นจริง จะเปิดใช้พารามิเตอร์ <code>isolate</code> ในฟังก์ชัน <a href="https://bazel.build/rules/lib/globals/module#use_extension"><code>use_extension</code></a>
แท็กloading_and_analysis
--[no]experimental_lazy_template_expansion
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็น true ctx.actions.expand_template() จะยอมรับพารามิเตอร์ TemplateDict สำหรับการประเมินค่าการแทนที่ที่เลื่อนออกไป
แท็กexecution
,build_file_semantics
,experimental
--[no]experimental_platforms_api
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" จะเปิดใช้ Starlark API ที่เกี่ยวข้องกับแพลตฟอร์มหลายรายการซึ่งมีประโยชน์สำหรับการแก้ไขข้อบกพร่อง
แท็ก:loading_and_analysis
,experimental
--[no]experimental_repo_remote_exec
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" repository_rule จะมีความสามารถในการดำเนินการจากระยะไกลบางอย่าง
แท็กbuild_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_sibling_repository_layout
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" ระบบจะฝังที่เก็บที่ไม่ใช่ที่เก็บหลักเป็นลิงก์สัญลักษณ์ไปยังที่เก็บหลักในรูทการดำเนินการ กล่าวคือ ที่เก็บทั้งหมดเป็นรายการย่อยโดยตรงของไดเรกทอรี $output_base/execution_root ซึ่งจะส่งผลให้ $output_base/execution_root/__main__/external ว่างลงสำหรับไดเรกทอรี "external" ระดับบนสุดที่แท้จริง
แท็ก:action_command_lines
,bazel_internal_configuration
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]incompatible_always_check_depset_elements
ค่าเริ่มต้น: "จริง"-
ตรวจสอบความถูกต้องขององค์ประกอบที่เพิ่มลงในชุดทรัพยากร Dependency ในตัวสร้างทั้งหมด องค์ประกอบต้องไม่เปลี่ยนแปลง แต่ในอดีตเครื่องมือสร้าง depset(direct=...) ลืมตรวจสอบ ใช้ Tuple แทนรายการในองค์ประกอบ depset ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/10313
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_depset_for_libraries_to_link_getter
ค่าเริ่มต้น: "จริง"-
เมื่อเป็นจริง Bazel จะไม่แสดงรายการจาก linking_context.libraries_to_link อีกต่อไป แต่จะแสดง depset แทน
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_disable_objc_library_transition
ค่าเริ่มต้น: "false"-
ปิดใช้การเปลี่ยนที่กำหนดเองของ objc_library และรับค่าจากเป้าหมายระดับบนสุดแทน
แท็กbuild_file_semantics
,incompatible_change
--[no]incompatible_disable_starlark_host_transitions
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" แอตทริบิวต์ของกฎจะตั้งค่า "cfg = "host"" ไม่ได้ กฎควรตั้งค่า "cfg = "exec"" แทน
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_disable_target_provider_fields
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" จะปิดใช้ความสามารถในการเข้าถึงผู้ให้บริการในออบเจ็กต์ "เป้าหมาย" ผ่านไวยากรณ์ฟิลด์ โปรดใช้ไวยากรณ์ provider-key แทน เช่น แทนที่จะใช้ `ctx.attr.dep.my_info` เพื่อเข้าถึง `my_info` จากภายในฟังก์ชันการใช้งานกฎ ให้ใช้ `ctx.attr.dep[MyInfo]` ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/9014
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_empty_glob
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น True ค่าเริ่มต้นของอาร์กิวเมนต์ `allow_empty` ของ glob() จะเป็น False
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_legacy_javainfo
ค่าเริ่มต้น: "จริง"-
เลิกใช้งานแล้ว ไม่มีการดำเนินการ
แท็กbuild_file_semantics
,incompatible_change
--[no]incompatible_disallow_struct_provider_syntax
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" ฟังก์ชันการใช้งานกฎอาจไม่แสดงผลโครงสร้าง แต่ต้องแสดงรายการอินสแตนซ์ของผู้ให้บริการแทน
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_enable_deprecated_label_apis
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ คุณจะใช้ 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 จะแสดงออบเจ็กต์มุมมองแบบไม่เปลี่ยนแปลงที่มีน้ำหนักเบาแทนที่จะเป็น dict ที่เปลี่ยนแปลงได้
แท็กbuild_file_semantics
,loading_and_analysis
,incompatible_change
--[no]incompatible_fail_on_unknown_attributes
ค่าเริ่มต้น: "false"-
หากเปิดใช้ เป้าหมายที่มีแอตทริบิวต์ที่ไม่รู้จักซึ่งตั้งค่าเป็น "ไม่มี" จะล้มเหลว
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_fix_package_group_reporoot_syntax
ค่าเริ่มต้น: "จริง"-
ในแอตทริบิวต์ `packages` ของ package_group ให้เปลี่ยนความหมายของค่า "//..." เพื่ออ้างอิงถึงแพ็กเกจทั้งหมดในที่เก็บปัจจุบันแทนที่จะเป็นแพ็กเกจทั้งหมดในที่เก็บใดๆ คุณใช้ค่าพิเศษ "public" แทน "//..." เพื่อให้ได้ลักษณะการทำงานแบบเดิมได้ แฟล็กนี้กำหนดให้ต้องเปิดใช้ --incompatible_package_group_has_public_syntax ด้วย
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_java_common_parameters
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็น true ระบบจะนำพารามิเตอร์ output_jar และ host_javabase ใน pack_sources รวมถึง host_javabase ใน compile ออกทั้งหมด
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_merge_fixed_and_default_shell_env
ค่าเริ่มต้น: "false"-
หากเปิดใช้ การดำเนินการที่ลงทะเบียนด้วย ctx.actions.run และ ctx.actions.run_shell โดยระบุทั้ง "env" และ "use_default_shell_env = True" จะใช้สภาพแวดล้อมที่ได้จากสภาพแวดล้อมของเชลล์เริ่มต้นโดยการลบล้างด้วยค่าที่ส่งไปยัง "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
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ไฟล์ต้นฉบับ (ที่ใช้) จะเป็นแบบส่วนตัวของแพ็กเกจ เว้นแต่จะส่งออกอย่างชัดเจน ดู 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
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็นจริง จะปิดใช้พารามิเตอร์ `outputs` ของฟังก์ชัน Starlark `rule()`
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_package_group_has_public_syntax
ค่าเริ่มต้น: "จริง"-
ในแอตทริบิวต์ `packages` ของ package_group จะอนุญาตให้เขียน "public" หรือ "private" เพื่ออ้างอิงถึงแพ็กเกจทั้งหมดหรือไม่มีแพ็กเกจตามลำดับ
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_require_linker_input_cc_api
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็น "true" กฎ create_linking_context จะกำหนดให้ใช้ linker_inputs แทน libraries_to_link ระบบจะปิดใช้ตัวรับค่าเก่าของ linking_context และจะใช้ได้เฉพาะ linker_inputs เท่านั้น
แท็กbuild_file_semantics
,loading_and_analysis
,incompatible_change
--[no]incompatible_run_shell_command_string
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็นจริง พารามิเตอร์คำสั่งของ actions.run_shell จะยอมรับเฉพาะสตริง
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_stop_exporting_language_modules
ค่าเริ่มต้น: "false"-
หากเปิดใช้ โมดูลเฉพาะภาษาบางอย่าง (เช่น `cc_common`) จะไม่พร้อมใช้งานในไฟล์ .bzl ของผู้ใช้ และอาจเรียกใช้ได้จากที่เก็บกฎที่เกี่ยวข้องเท่านั้น
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_struct_has_no_methods
ค่าเริ่มต้น: "false"-
ปิดใช้เมธอด to_json และ to_proto ของ Struct ซึ่งทำให้เนมสเปซของฟิลด์ Struct เสียหาย ให้ใช้ json.encode หรือ json.encode_indent สำหรับ JSON หรือ proto.encode_text สำหรับ textproto แทน
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_top_level_aspects_require_providers
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" องค์ประกอบระดับบนสุดจะใช้ผู้ให้บริการที่จำเป็นและทำงานเฉพาะในเป้าหมายระดับบนสุดซึ่งผู้ให้บริการที่โฆษณาของกฎเป็นไปตามผู้ให้บริการที่จำเป็นขององค์ประกอบ
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_unambiguous_label_stringification
ค่าเริ่มต้น: "จริง"-
เมื่อเป็นจริง 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
ค่าเริ่มต้น: "false"-
เมื่อเป็นจริง Bazel จะไม่อนุญาตให้ใช้ cc_configure จาก @bazel_tools อีกต่อไป โปรดดูรายละเอียดและวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/10134
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็น "จริง" ระบบจะตรวจสอบระดับการมองเห็นของแอตทริบิวต์กฎส่วนตัวตามคำจำกัดความของกฎ โดยจะกลับไปใช้การใช้กฎหากมองไม่เห็น
แท็ก: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]incompatible_do_not_split_linking_cmdline
ค่าเริ่มต้น: "จริง"-
เมื่อเป็นจริง Bazel จะไม่แก้ไขแฟล็กบรรทัดคำสั่งที่ใช้สำหรับการลิงก์อีกต่อไป และจะไม่เลือกแฟล็กที่จะไปที่ไฟล์ param และแฟล็กที่จะไม่ไป ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7670
แท็ก:loading_and_analysis
,incompatible_change
--[no]keep_state_after_build
ค่าเริ่มต้น: "จริง"-
หากเป็นเท็จ Blaze จะทิ้งสถานะในหน่วยความจำจากการสร้างนี้เมื่อการสร้างเสร็จสิ้น บิลด์ต่อๆ ไปจะไม่มีการเพิ่มขึ้นเมื่อเทียบกับบิลด์นี้
แท็กloses_incremental_state
--skyframe_high_water_mark_threshold=<an integer>
ค่าเริ่มต้น: "85"-
Flag สำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่าการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้มีค่าอย่างน้อยเท่ากับเกณฑ์นี้ Bazel จะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็น การปรับแต่งนี้อาจช่วยลดผลกระทบของเวลาจริงที่เกิดจากการสลับหน่วยความจำของ GC เมื่อการสลับหน่วยความจำของ GC (1) เกิดจากการใช้หน่วยความจำของสถานะชั่วคราวนี้ และ (2) มีค่าใช้จ่ายมากกว่าการสร้างสถานะใหม่เมื่อจำเป็น
แท็กhost_machine_resource_optimizations
--[no]track_incremental_state
ค่าเริ่มต้น: "จริง"-
หากเป็นเท็จ Blaze จะไม่คงข้อมูลที่อนุญาตให้มีการลบล้างและประเมินซ้ำในการสร้างแบบเพิ่มทีละรายการเพื่อประหยัดหน่วยความจำในการสร้างนี้ บิลด์ต่อๆ ไปจะไม่มีการเพิ่มขึ้นเมื่อเทียบกับบิลด์นี้ โดยปกติแล้ว คุณจะต้องระบุ --batch เมื่อตั้งค่านี้เป็น false
แท็ก:loses_incremental_state
- ตัวเลือกที่มีผลต่อความละเอียด รูปแบบ หรือตำแหน่งของการบันทึก:
--[no]announce_rc
ค่าเริ่มต้น: "false"-
ว่าจะประกาศตัวเลือก rc หรือไม่
แท็กaffects_outputs
--[no]attempt_to_print_relative_paths
ค่าเริ่มต้น: "false"-
เมื่อพิมพ์ส่วนตำแหน่งของข้อความ ให้พยายามใช้เส้นทางที่สัมพันธ์กับไดเรกทอรีพื้นที่ทำงานหรือไดเรกทอรีใดไดเรกทอรีหนึ่งที่ระบุโดย --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
ค่าเริ่มต้น: "false"-
ตั้งค่าฟิลด์ 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
ค่าเริ่มต้น: "จริง"-
ระบุว่าจะเผยแพร่เหตุการณ์วงจร BES หรือไม่ (ค่าเริ่มต้นคือ "true")
แท็กaffects_outputs
--bes_oom_finish_upload_timeout=<An immutable length of time.>
ค่าเริ่มต้น: "10m"-
ระบุระยะเวลาที่ Bazel ควรรอให้การอัปโหลด 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>
ค่าเริ่มต้น: ดูคำอธิบาย- เชื่อมต่อกับบริการเหตุการณ์บิลด์ผ่านพร็อกซี ปัจจุบันนี้ คุณใช้แฟล็กนี้เพื่อกำหนดค่า Unix Domain Socket (unix:/path/to/socket) ได้เท่านั้น
--bes_results_url=<a string>
ค่าเริ่มต้น: ""-
ระบุ URL ฐานที่ผู้ใช้สามารถดูข้อมูลที่สตรีมไปยังแบ็กเอนด์ของ BES Bazel จะแสดง URL ที่ต่อท้ายด้วยรหัสการเรียกใช้ไปยังเทอร์มินัล
แท็กterminal_output
--bes_timeout=<An immutable length of time.>
ค่าเริ่มต้น: "0s"-
ระบุระยะเวลาที่ Bazel ควรรอการอัปโหลด BES/BEP ให้เสร็จสมบูรณ์หลังจากที่บิลด์และการทดสอบเสร็จสิ้น การหมดเวลาที่ถูกต้องคือจำนวนเต็มตามด้วยหน่วย ได้แก่ วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) ค่าเริ่มต้นคือ "0" ซึ่งหมายความว่าไม่มีการหมดเวลา
แท็กaffects_outputs
--build_event_binary_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้เขียนการแสดงไบนารีที่คั่นด้วย Varint ของการแสดงโปรโตคอลเหตุการณ์การสร้างไปยังไฟล์นั้น ตัวเลือกนี้หมายถึง --bes_upload_mode=wait_for_upload_complete
แท็กaffects_outputs
--[no]build_event_binary_file_path_conversion
ค่าเริ่มต้น: "จริง"-
แปลงเส้นทางในการแสดงไฟล์ไบนารีของโปรโตคอลเหตุการณ์บิลด์เป็น URI ที่ถูกต้องในระดับสากลมากขึ้นทุกครั้งที่ทำได้ หากปิดใช้ ระบบจะใช้รูปแบบ URI file:// เสมอ
แท็กaffects_outputs
--build_event_json_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่างเปล่า ให้เขียนการซีเรียลไลซ์ JSON ของโปรโตคอลเหตุการณ์บิลด์ลงในไฟล์นั้น
แท็กaffects_outputs
--[no]build_event_json_file_path_conversion
ค่าเริ่มต้น: "จริง"-
แปลงเส้นทางในการแสดงไฟล์ JSON ของโปรโตคอลเหตุการณ์บิลด์เป็น URI ที่ถูกต้องในระดับสากลมากขึ้นทุกครั้งที่ทำได้ หากปิดใช้ ระบบจะใช้รูปแบบ URI file:// เสมอ
แท็ก:affects_outputs
--build_event_max_named_set_of_file_entries=<an integer>
ค่าเริ่มต้น: "-1"-
จำนวนรายการสูงสุดสำหรับเหตุการณ์ named_set_of_files รายการเดียว ระบบจะไม่สนใจค่าที่น้อยกว่า 2 และจะไม่แยกเหตุการณ์ พารามิเตอร์นี้มีไว้เพื่อจำกัดขนาดเหตุการณ์สูงสุดในโปรโตคอลเหตุการณ์บิลด์ แม้ว่าจะไม่ได้ควบคุมขนาดเหตุการณ์โดยตรงก็ตาม ขนาดเหตุการณ์ทั้งหมดเป็นฟังก์ชันของโครงสร้างชุด รวมถึงความยาวของไฟล์และ URI ซึ่งอาจขึ้นอยู่กับฟังก์ชันแฮช
แท็กaffects_outputs
--[no]build_event_publish_all_actions
ค่าเริ่มต้น: "false"-
ระบุว่าควรเผยแพร่การดำเนินการทั้งหมดหรือไม่
แท็กaffects_outputs
--build_event_text_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้เขียนการแสดงข้อความของโปรโตคอลเหตุการณ์บิลด์ลงในไฟล์นั้น
แท็ก:affects_outputs
--[no]build_event_text_file_path_conversion
ค่าเริ่มต้น: "จริง"-
แปลงเส้นทางในข้อความที่แสดงถึงโปรโตคอลเหตุการณ์การสร้างเป็น URI ที่ถูกต้องในระดับสากลมากขึ้นทุกครั้งที่เป็นไปได้ หากปิดใช้ ระบบจะใช้รูปแบบ URI file:// เสมอ
แท็ก:affects_outputs
--[no]experimental_announce_profile_path
ค่าเริ่มต้น: "false"-
หากเปิดใช้ จะเพิ่มเส้นทางโปรไฟล์ JSON ลงในบันทึก
แท็ก:affects_outputs
,bazel_monitoring
--[no]experimental_bep_target_summary
ค่าเริ่มต้น: "false"- ระบุว่าจะเผยแพร่เหตุการณ์ TargetSummary หรือไม่
--[no]experimental_build_event_expand_filesets
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ขยายชุดไฟล์ใน BEP เมื่อนำเสนอไฟล์เอาต์พุต
แท็กaffects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้แก้ไขลิงก์สัญลักษณ์ 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
--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, process_time, remote_queue, remote_setup, fetch, 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, local_cpu_usage, system_cpu_usage, local_memory_usage, system_memory_usage, 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 or unknown>
มีการสะสมการใช้งานหลายครั้ง-
ระบุงานโปรไฟล์เพิ่มเติมที่จะรวมไว้ในโปรไฟล์
แท็ก:affects_outputs
,bazel_monitoring
--[no]experimental_profile_include_primary_output
ค่าเริ่มต้น: "false"-
รวมแอตทริบิวต์ "out" เพิ่มเติมในเหตุการณ์การดำเนินการที่มีเส้นทางการดำเนินการไปยังเอาต์พุตหลักของการดำเนินการ
แท็ก:affects_outputs
,bazel_monitoring
--[no]experimental_profile_include_target_label
ค่าเริ่มต้น: "false"-
รวมป้ายกำกับเป้าหมายในข้อมูลโปรไฟล์ JSON ของเหตุการณ์การกระทำ
แท็ก:affects_outputs
,bazel_monitoring
--[no]experimental_stream_log_file_uploads
ค่าเริ่มต้น: "false"-
สตรีมการอัปโหลดไฟล์บันทึกไปยังพื้นที่เก็บข้อมูลระยะไกลโดยตรงแทนการเขียนลงในดิสก์
แท็กaffects_outputs
--experimental_workspace_rules_log_file=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย- บันทึกเหตุการณ์กฎของ Workspace บางอย่างลงในไฟล์นี้เป็นโปรโตคอล WorkspaceEvent ที่คั่นด้วยตัวคั่น
--[no]generate_json_trace_profile
ค่าเริ่มต้น: "auto"-
หากเปิดใช้ Bazel จะสร้างโปรไฟล์การสร้างและเขียนโปรไฟล์รูปแบบ JSON ลงในไฟล์ในเอาต์พุตเบส ดูโปรไฟล์โดยโหลดลงใน chrome://tracing โดยค่าเริ่มต้น Bazel จะเขียนโปรไฟล์สำหรับคำสั่งและการค้นหาที่คล้ายกับการสร้างทั้งหมด
แท็ก:affects_outputs
,bazel_monitoring
--[no]heap_dump_on_oom
ค่าเริ่มต้น: "false"-
จะส่งออกการดัมพ์ฮีปด้วยตนเองหรือไม่หากมีการส่ง OOM (รวมถึง OOM ที่เกิดจาก --experimental_oom_more_eagerly_threshold) ระบบจะเขียนข้อมูลการทิ้งไปยัง <output_base>/<invocation_id>.heapdump.hprof ตัวเลือกนี้จะแทนที่ -XX:+HeapDumpOnOutOfMemoryError ซึ่งไม่มีผลเนื่องจากระบบจะตรวจจับ OOM และเปลี่ยนเส้นทางไปยัง Runtime#halt
แท็กbazel_monitoring
--[no]legacy_important_outputs
ค่าเริ่มต้น: "จริง"-
ใช้เพื่อระงับการสร้างฟิลด์ important_outputs เดิมในเหตุการณ์ TargetComplete จำเป็นต้องมี important_outputs สำหรับการผสานรวม Bazel กับ ResultStore
แท็กaffects_outputs
--logging=<0 <= an integer <= 6>
ค่าเริ่มต้น: "3"-
ระดับการบันทึก
แท็กaffects_outputs
--memory_profile=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
หากตั้งค่าไว้ ให้เขียนข้อมูลการใช้หน่วยความจำลงในไฟล์ที่ระบุเมื่อสิ้นสุดเฟส และเขียนฮีปที่เสถียรลงในบันทึกหลักเมื่อสิ้นสุดการสร้าง
แท็ก:affects_outputs
,bazel_monitoring
--memory_profile_stable_heap_parameters=<integers, separated by a comma expected in pairs>
ค่าเริ่มต้น: "1,0"-
ปรับการคำนวณฮีปที่เสถียรของโปรไฟล์หน่วยความจำเมื่อสิ้นสุดการสร้าง ควรเป็นจำนวนเต็มคู่ที่คั่นด้วยคอมมา ในแต่ละคู่ จำนวนเต็มแรกคือจำนวน GC ที่จะดำเนินการ จำนวนเต็มที่ 2 ในแต่ละคู่คือจำนวนวินาทีที่จะรอระหว่าง GC เช่น 2,4,4,0 จะหมายถึง 2 GC ที่มีหยุดชั่วคราว 4 วินาที ตามด้วย 4 GC ที่มีหยุดชั่วคราว 0 วินาที
แท็ก:bazel_monitoring
--profile=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
หากตั้งค่าไว้ ให้สร้างโปรไฟล์ Bazel และเขียนข้อมูลลงในไฟล์ที่ระบุ ใช้ bazel analyze-profile เพื่อวิเคราะห์โปรไฟล์
แท็ก:affects_outputs
,bazel_monitoring
--[no]slim_profile
ค่าเริ่มต้น: "จริง"-
ลดขนาดโปรไฟล์ JSON โดยการผสานกิจกรรมหากโปรไฟล์มีขนาดใหญ่เกินไป
แท็ก:affects_outputs
,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
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้:
--build_metadata=<a 'name=value' assignment>
มีการสะสมการใช้งานหลายครั้ง-
คู่สตริงคีย์-ค่าที่กำหนดเองเพื่อระบุในเหตุการณ์บิลด์
แท็กterminal_output
--color=<yes, no or auto>
ค่าเริ่มต้น: "auto"- ใช้การควบคุมเทอร์มินัลเพื่อใส่สีให้กับเอาต์พุต
--config=<a string>
มีการสะสมการใช้งานหลายครั้ง- เลือกส่วนการกำหนดค่าเพิ่มเติมจากไฟล์ .rc สำหรับทุก <command> ระบบจะดึงตัวเลือกจาก <command>:<config> ด้วย หากมีส่วนดังกล่าว หากไม่มีส่วนนี้ในไฟล์ .rc ใดๆ Blaze จะล้มเหลวพร้อมข้อผิดพลาด ส่วนการกำหนดค่าและการผสมค่าสถานะที่เทียบเท่าจะอยู่ในไฟล์การกำหนดค่า 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.>
มีการสะสมการใช้งานหลายครั้ง- กำหนดค่าโปรแกรมช่วยเหลือข้อมูลเข้าสู่ระบบที่จะใช้ในการดึงข้อมูลเข้าสู่ระบบการให้สิทธิ์สำหรับการดึงข้อมูลที่เก็บ การแคชและการดำเนินการระยะไกล และบริการเหตุการณ์การสร้าง ข้อมูลเข้าสู่ระบบที่ตัวช่วยระบุจะมีลำดับความสำคัญเหนือกว่าข้อมูลเข้าสู่ระบบที่ระบุโดย --google_default_credentials, --google_credentials, ไฟล์ .netrc หรือพารามิเตอร์การตรวจสอบสิทธิ์ไปยัง repository_ctx.download และ repository_ctx.download_and_extract ระบุได้หลายครั้งเพื่อตั้งค่าผู้ช่วยหลายราย ดูรายละเอียดได้ที่ https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md
--credential_helper_cache_duration=<An immutable length of time.>
ค่าเริ่มต้น: "30m"- ระยะเวลาที่ระบบจะแคชข้อมูลเข้าสู่ระบบที่ตัวช่วยข้อมูลเข้าสู่ระบบระบุ การเรียกใช้ด้วยค่าอื่นจะปรับอายุการใช้งานของรายการที่มีอยู่แล้ว ให้ส่งค่า 0 เพื่อล้างแคช คำสั่ง clean จะล้างแคชเสมอ ไม่ว่าจะมีแฟล็กนี้หรือไม่ก็ตาม
--credential_helper_timeout=<An immutable length of time.>
ค่าเริ่มต้น: "10s"- กำหนดค่าการหมดเวลาสำหรับโปรแกรมช่วยจัดการข้อมูลเข้าสู่ระบบ หากผู้ช่วยจัดการข้อมูลเข้าสู่ระบบไม่ตอบกลับภายในระยะหมดเวลานี้ การเรียกใช้จะล้มเหลว
--curses=<yes, no or auto>
ค่าเริ่มต้น: "auto"- ใช้การควบคุมเคอร์เซอร์ของเทอร์มินัลเพื่อลดเอาต์พุตการเลื่อน
--[no]enable_platform_specific_config
ค่าเริ่มต้น: "false"- หากเป็นจริง Bazel จะเลือกบรรทัดการกำหนดค่าเฉพาะระบบปฏิบัติการของโฮสต์จากไฟล์ bazelrc เช่น หากระบบปฏิบัติการโฮสต์เป็น Linux และคุณเรียกใช้ bazel build Bazel จะเลือกบรรทัดที่ขึ้นต้นด้วย build:linux ตัวระบุระบบปฏิบัติการที่รองรับ ได้แก่ linux, macos, windows, freebsd และ openbsd การเปิดใช้ฟีเจอร์นี้จะเทียบเท่ากับการใช้ --config=linux ใน Linux, --config=windows ใน Windows เป็นต้น
--[no]experimental_skymeld_ui
ค่าเริ่มต้น: "false"-
แสดงความคืบหน้าทั้งในระยะการวิเคราะห์และการดำเนินการเมื่อทั้ง 2 อย่างทำงานพร้อมกัน
แท็กterminal_output
--[no]experimental_windows_watchfs
ค่าเริ่มต้น: "false"- หากเป็นจริง ระบบจะเปิดใช้การรองรับ Windows เวอร์ชันทดลองสำหรับ --watchfs มิฉะนั้น watchfs จะไม่ทำงานใน Windows อย่าลืมเปิดใช้ --watchfs ด้วย
--google_auth_scopes=<comma-separated list of options>
default: "https://www.googleapis.com/auth/cloud-platform"- รายการขอบเขตการตรวจสอบสิทธิ์ของ Google Cloud ที่คั่นด้วยคอมมา
--google_credentials=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไฟล์ที่จะรับข้อมูลเข้าสู่ระบบสำหรับการตรวจสอบสิทธิ์ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication
--[no]google_default_credentials
ค่าเริ่มต้น: "false"- ว่าจะใช้ "ข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชันของ Google" สำหรับการตรวจสอบสิทธิ์หรือไม่ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication ปิดใช้โดยค่าเริ่มต้น
--grpc_keepalive_time=<An immutable length of time.>
ค่าเริ่มต้น: ดูคำอธิบาย- กำหนดค่า Ping Keep-Alive สำหรับการเชื่อมต่อ gRPC ขาออก หากตั้งค่านี้ไว้ Bazel จะส่งการ Ping หลังจากไม่มีการดำเนินการอ่านในการเชื่อมต่อเป็นเวลานานเท่านี้ แต่จะส่งก็ต่อเมื่อมีการเรียก gRPC ที่รอดำเนินการอย่างน้อย 1 รายการ ระบบจะถือว่าเวลาเป็นหน่วยวินาที การตั้งค่าที่น้อยกว่า 1 วินาทีถือเป็นข้อผิดพลาด โดยค่าเริ่มต้น ระบบจะปิดใช้ Ping Keep-Alive คุณควรประสานงานกับเจ้าของบริการก่อนที่จะเปิดใช้การตั้งค่านี้ เช่น หากต้องการตั้งค่าเป็น 30 วินาที ให้ทำดังนี้ --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.>
ค่าเริ่มต้น: "20s"- กำหนดค่าการหมดเวลา Keep-Alive สำหรับการเชื่อมต่อ gRPC ขาออก หากเปิดใช้คำสั่ง ping keep-alive ด้วย --grpc_keepalive_time Bazel จะหมดเวลาการเชื่อมต่อหากไม่ได้รับการตอบกลับคำสั่ง ping หลังจากผ่านไประยะเวลาดังกล่าว ระบบจะถือว่าเวลาเป็นหน่วยวินาที การตั้งค่าที่น้อยกว่า 1 วินาทีถือเป็นข้อผิดพลาด หากปิดใช้ Ping Keep-Alive ระบบจะไม่สนใจการตั้งค่านี้
--[no]incompatible_disallow_symlink_file_to_dir
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็น "จริง" `ctx.actions.symlink` จะไม่อนุญาตให้สร้างลิงก์สัญลักษณ์ของไฟล์ลงในไดเรกทอรี
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_rule_name_parameter
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็น "จริง" จะเรียกใช้ `rule` ด้วยพารามิเตอร์ `name` ไม่ได้
แท็ก:loading_and_analysis
,incompatible_change
--[no]progress_in_terminal_title
ค่าเริ่มต้น: "false"- แสดงความคืบหน้าของคำสั่งในชื่อเทอร์มินัล มีประโยชน์ในการดูว่า Bazel กำลังทำอะไรอยู่เมื่อมีแท็บเทอร์มินัลหลายแท็บ
--[no]show_progress
ค่าเริ่มต้น: "จริง"- แสดงข้อความความคืบหน้าระหว่างการสร้าง
--show_progress_rate_limit=<a double>
ค่าเริ่มต้น: "0.2"- จำนวนวินาทีขั้นต่ำระหว่างข้อความความคืบหน้าในเอาต์พุต
--[no]show_timestamps
ค่าเริ่มต้น: "false"- รวมการประทับเวลาในข้อความ
--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
ค่าเริ่มต้น: "false"- ใน Linux/macOS: หากเป็นจริง Bazel จะพยายามใช้บริการตรวจสอบไฟล์ของระบบปฏิบัติการสำหรับการเปลี่ยนแปลงในเครื่องแทนที่จะสแกนทุกไฟล์เพื่อหาการเปลี่ยนแปลง ใน Windows: ปัจจุบัน Flag นี้ไม่มีการดำเนินการใดๆ แต่สามารถเปิดใช้ร่วมกับ --experimental_windows_watchfs ได้ ในระบบปฏิบัติการใดก็ตาม: ระบบจะไม่กำหนดลักษณะการทำงานหากพื้นที่ทำงานอยู่ในระบบไฟล์เครือข่ายและมีการแก้ไขไฟล์ในเครื่องระยะไกล
ตัวเลือกการวิเคราะห์โปรไฟล์
- ตัวเลือกที่ปรากฏก่อนคำสั่งและไคลเอ็นต์แยกวิเคราะห์
--distdir=<a path>
มีการสะสมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาไฟล์เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บจะลิงก์แบบฮาร์ดลิงก์ไฟล์ในกรณีที่แคชตรงกันแทนที่จะคัดลอก ซึ่งมีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL เปลี่ยนแปลงและส่งผลให้มีการดาวน์โหลดซ้ำแม้ว่าแคชจะมีรายการที่ดาวน์โหลดซึ่งมีแฮชเดียวกันก็ตาม ซึ่งใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL ไม่ได้ทำให้ที่เก็บข้อมูลเสียหายซึ่งถูกแคชซ่อนไว้
แท็ก:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ จะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็กexperimental
--experimental_repository_downloader_retries=<an integer>
ค่าเริ่มต้น: "0"-
จำนวนครั้งสูงสุดที่พยายามลองดาวน์โหลดซ้ำเมื่อเกิดข้อผิดพลาด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็กexperimental
--experimental_scale_timeouts=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับขนาดการหมดเวลาทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ ด้วยวิธีนี้ คุณจึงทำให้ที่เก็บข้อมูลภายนอกทำงานในเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็กbazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับการหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลดผ่าน http ตามปัจจัยที่ระบุ
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้มาในระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้ข้อมูลอินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าสถานะ ฯลฯ):
--experimental_repository_hash_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรมีการยืนยันแฮชของไดเรกทอรีที่เก็บเทียบกับค่านี้
แท็ก:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
มีการสะสมการใช้งานหลายครั้ง-
หากมีรายการกฎที่เก็บที่ควรมีการยืนยันแฮชของไดเรกทอรีเอาต์พุต โดยระบุไฟล์ด้วย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้มีผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ในไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
ค่าเริ่มต้น: "จริง"-
ไม่มีการดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะได้รับอนุญาตในกราฟการอ้างอิงที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่าถูกยกเลิกในรีจิสทรีที่โมดูลมาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น เวอร์ชันที่ถูกเพิกถอนจะทำให้การแก้ไขล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันที่อนุญาตให้ยกเลิกได้ด้วยตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็กloading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ `error` เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาที่ไม่สำเร็จ, `off` เพื่อปิดใช้การตรวจสอบ หรือ `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน
แท็กloading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าการอ้างอิง `bazel_dep` โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้ว ค่าที่ใช้ได้คือ `off` เพื่อปิดใช้การตรวจสอบ, `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน หรือ `error` เพื่อส่งต่อเป็นความล้มเหลวในการแก้ไข
แท็กloading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นการขึ้นต่อกันของนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท ไม่ว่าค่าของแฟล็กนี้จะเป็นอะไรก็ตาม
แท็กloading_and_analysis
--lockfile_mode=<off, update or error>
ค่าเริ่มต้น: "ปิด"-
ระบุวิธีและจะใช้หรือไม่ใช้ไฟล์ล็อก ค่าที่ใช้ได้คือ `update` เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง, `error` เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่อัปเดต หรือ `off` เพื่อไม่ให้อ่านหรือเขียนไปยังไฟล์ล็อก
แท็กloading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
มีการสะสมการใช้งานหลายครั้ง- แทนที่โมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--registry=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้เพื่อค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับมีความสำคัญ โดยระบบจะค้นหาโมดูลในรีจิสทรีที่อยู่ก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีที่อยู่ถัดไปก็ต่อเมื่อไม่มีโมดูลในรีจิสทรีที่อยู่ก่อนหน้า
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อความละเอียด รูปแบบ หรือตำแหน่งของการบันทึก:
--dump=<text or raw>
[-d
] ค่าเริ่มต้น: ดูคำอธิบาย-
ส่งออกข้อมูลโปรไฟล์ทั้งหมดในรูปแบบ "ข้อความ" ที่มนุษย์อ่านได้ หรือรูปแบบ "ดิบ" ที่เป็นมิตรกับสคริปต์
แท็กaffects_outputs
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น ระบบจะจำกัดจำนวนประเภทการดำเนินการไว้ที่ 20 นิโมนิกที่มีจำนวนการดำเนินการที่ดำเนินการแล้วมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับทุกคำช่วยจำ
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปในคำสั่ง Bazel ซึ่งไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้อ่านไฟล์ที่ระบุซึ่งแก้ไขแล้วแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
--experimental_downloader_config=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไฟล์เพื่อกำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สำหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ รูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้เป็น URL แทน โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณสามารถระบุคำสั่ง `rewrite` หลายรายการสำหรับ URL เดียวกันได้ และในกรณีนี้ ระบบจะแสดง URL หลายรายการ
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้:
--override_repository=<an equals-separated mapping of repository name to path>
มีการสะสมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุเริ่มต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
ตัวเลือก Aquery
รับตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคำสั่งและไคลเอ็นต์แยกวิเคราะห์
--distdir=<a path>
มีการสะสมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาไฟล์เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บจะลิงก์แบบฮาร์ดลิงก์ไฟล์ในกรณีที่แคชตรงกันแทนที่จะคัดลอก ซึ่งมีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL เปลี่ยนแปลงและส่งผลให้มีการดาวน์โหลดซ้ำแม้ว่าแคชจะมีรายการที่ดาวน์โหลดซึ่งมีแฮชเดียวกันก็ตาม ซึ่งใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL ไม่ได้ทำให้ที่เก็บข้อมูลเสียหายซึ่งถูกแคชซ่อนไว้
แท็ก:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ จะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็กexperimental
--experimental_repository_downloader_retries=<an integer>
ค่าเริ่มต้น: "0"-
จำนวนครั้งสูงสุดที่พยายามลองดาวน์โหลดซ้ำเมื่อเกิดข้อผิดพลาด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็กexperimental
--experimental_scale_timeouts=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับขนาดการหมดเวลาทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ ด้วยวิธีนี้ คุณจึงทำให้ที่เก็บข้อมูลภายนอกทำงานในเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็กbazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับการหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลดผ่าน http ตามปัจจัยที่ระบุ
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้มาในระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้ข้อมูลอินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าสถานะ ฯลฯ):
--experimental_repository_hash_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรมีการยืนยันแฮชของไดเรกทอรีที่เก็บเทียบกับค่านี้
แท็ก:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
มีการสะสมการใช้งานหลายครั้ง-
หากมีรายการกฎที่เก็บที่ควรมีการยืนยันแฮชของไดเรกทอรีเอาต์พุต โดยระบุไฟล์ด้วย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้มีผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ในไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
ค่าเริ่มต้น: "จริง"-
ไม่มีการดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและการตีความหมายของคำค้นหา
--aspect_deps=<off, conservative or precise>
ค่าเริ่มต้น: "ระมัดระวัง"-
วิธีแก้ไขการขึ้นต่อกันของแง่มุมเมื่อรูปแบบเอาต์พุตเป็นหนึ่งใน {xml,proto,record} "off" หมายความว่าจะไม่มีการแก้ไขการขึ้นต่อกันของแง่มุม "conservative" (ค่าเริ่มต้น) หมายความว่าจะมีการเพิ่มการขึ้นต่อกันของแง่มุมที่ประกาศทั้งหมดไม่ว่าจะมีคลาสกฎของการขึ้นต่อกันโดยตรงหรือไม่ก็ตาม "precise" หมายความว่าจะมีการเพิ่มเฉพาะแง่มุมที่อาจใช้งานได้เมื่อพิจารณาจากคลาสกฎของการขึ้นต่อกันโดยตรง โปรดทราบว่าโหมดที่แม่นยำต้องโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียว จึงทำให้ช้ากว่าโหมดอื่นๆ โปรดทราบว่าแม้ในโหมดที่แม่นยำก็ยังไม่แม่นยำโดยสมบูรณ์ เนื่องจากระบบจะตัดสินใจว่าจะคำนวณแง่มุมใดในระยะการวิเคราะห์ ซึ่งไม่ได้ทำงานระหว่าง "bazel query"
แท็กbuild_file_semantics
--[no]consistent_labels
ค่าเริ่มต้น: "false"-
หากเปิดใช้ คำสั่งการค้นหาทุกคำสั่งจะปล่อยป้ายกำกับออกมาเหมือนกับฟังก์ชัน <code>str</code> ของ Starlark ที่ใช้กับอินสแตนซ์ <code>Label</code> ซึ่งจะเป็นประโยชน์สำหรับเครื่องมือที่ต้องจับคู่เอาต์พุตของคำสั่งการค้นหาและ/หรือป้ายกำกับต่างๆ ที่กฎปล่อยออกมา หากไม่ได้เปิดใช้ ตัวจัดรูปแบบเอาต์พุตจะสามารถปล่อยชื่อที่เก็บที่ชัดเจน (เทียบกับที่เก็บหลัก) แทนเพื่อให้เอาต์พุตอ่านง่ายขึ้น
แท็กterminal_output
--[no]deduplicate_depsets
ค่าเริ่มต้น: "จริง"-
ลบรายการที่ซ้ำกันขององค์ประกอบย่อยที่ไม่ใช่ใบของ dep_set_of_files ในเอาต์พุต proto/textproto/json สุดท้าย การดำเนินการนี้จะไม่ขจัดชุดทรัพยากรที่ซ้ำกันซึ่งไม่มีองค์ประกอบระดับบนสุดร่วมกัน ซึ่งจะไม่ส่งผลต่อรายการอาร์ติแฟกต์อินพุตที่มีผลสุดท้ายของการดำเนินการ
แท็กterminal_output
--[no]graph:factored
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ระบบจะส่งกราฟที่ "แยกตัวประกอบ" กล่าวคือ ระบบจะผสานโหนดที่เทียบเท่ากันในเชิงโทโพโลยีเข้าด้วยกันและต่อป้ายกำกับของโหนดเหล่านั้น ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็กterminal_output
--graph:node_limit=<an integer>
ค่าเริ่มต้น: "512"-
ความยาวสูงสุดของสตริงป้ายกำกับสำหรับโหนดกราฟในเอาต์พุต ระบบจะตัดป้ายกำกับที่ยาวเกินไป โดย -1 หมายถึงไม่มีการตัด ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็กterminal_output
--[no]implicit_deps
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ระบบจะรวมทรัพยากร Dependency โดยนัยไว้ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน การขึ้นต่อกันโดยนัยคือการขึ้นต่อกันที่ไม่ได้ระบุอย่างชัดเจนในไฟล์ BUILD แต่ Bazel เพิ่มให้ สำหรับ cquery ตัวเลือกนี้จะควบคุมการกรอง Toolchain ที่แก้ไขแล้ว
แท็กbuild_file_semantics
--[no]include_artifacts
ค่าเริ่มต้น: "จริง"-
รวมชื่อของอินพุตและเอาต์พุตของการดำเนินการในเอาต์พุต (อาจมีขนาดใหญ่)
แท็กterminal_output
--[no]include_aspects
ค่าเริ่มต้น: "จริง"-
aquery, cquery: whether to include aspect-generated actions in the output. query: no-op (aspects are always followed).
แท็กterminal_output
--[no]include_commandline
ค่าเริ่มต้น: "จริง"-
รวมเนื้อหาของบรรทัดคำสั่งการดำเนินการในเอาต์พุต (อาจมีขนาดใหญ่)
แท็กterminal_output
--[no]include_file_write_contents
ค่าเริ่มต้น: "false"-
รวมเนื้อหาของไฟล์สำหรับการดำเนินการ FileWrite และ SourceSymlinkManifest (อาจมีขนาดใหญ่)
แท็กterminal_output
--[no]include_param_files
ค่าเริ่มต้น: "false"-
รวมเนื้อหาของไฟล์พารามิเตอร์ที่ใช้ในคำสั่ง (อาจมีขนาดใหญ่) หมายเหตุ: การเปิดใช้ฟีเจอร์นี้จะเปิดใช้แฟล็ก --include_commandline โดยอัตโนมัติ
แท็กterminal_output
--[no]incompatible_display_source_file_location
ค่าเริ่มต้น: "จริง"-
ค่าเริ่มต้นเป็น "จริง" ซึ่งจะแสดงเป้าหมายของไฟล์ต้นฉบับ หากจริง จะแสดงตำแหน่งของบรรทัดที่ 1 ของไฟล์แหล่งที่มาในเอาต์พุตตำแหน่ง โดยแฟล็กนี้มีไว้เพื่อวัตถุประสงค์ในการย้ายข้อมูลเท่านั้น
แท็ก:terminal_output
,incompatible_change
--[no]incompatible_package_group_includes_double_slash
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ เมื่อส่งออกแอตทริบิวต์ `packages` ของ package_group ระบบจะไม่ละเว้น `//` ที่นำหน้า
แท็ก:terminal_output
,incompatible_change
--[no]infer_universe_scope
ค่าเริ่มต้น: "false"-
หากตั้งค่าและไม่ได้ตั้งค่า --universe_scope ระบบจะอนุมานค่าของ --universe_scope เป็นรายการรูปแบบเป้าหมายที่ไม่ซ้ำกันในนิพจน์การค้นหา โปรดทราบว่าค่า --universe_scope ที่อนุมานสำหรับนิพจน์การค้นหาที่ใช้ฟังก์ชันระดับจักรวาล (เช่น `allrdeps`) อาจไม่ใช่สิ่งที่คุณต้องการ ดังนั้นคุณควรใช้ตัวเลือกนี้เฉพาะในกรณีที่คุณทราบว่ากำลังทำอะไรอยู่ ดูรายละเอียดและตัวอย่างได้ที่ https://bazel.build/reference/query#sky-query หากตั้งค่า --universe_scope ระบบจะไม่สนใจค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้ใช้ได้กับ `query` เท่านั้น (ไม่ใช่ `cquery`)
แท็ก:loading_and_analysis
--[no]line_terminator_null
ค่าเริ่มต้น: "false"-
ไม่ว่าจะสิ้นสุดแต่ละรูปแบบด้วย \0 แทนการขึ้นบรรทัดใหม่
แท็กterminal_output
--[no]nodep_deps
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ระบบจะรวมการอ้างอิงจากแอตทริบิวต์ "nodep" ไว้ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ตัวอย่างทั่วไปของแอตทริบิวต์ "nodep" คือ "visibility" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ `info build-language` เพื่อดูข้อมูลเกี่ยวกับแอตทริบิวต์ "nodep" ทั้งหมดในภาษาบิลด์
แท็กbuild_file_semantics
--output=<a string>
ค่าเริ่มต้น: "ข้อความ"-
รูปแบบที่ควรพิมพ์ผลลัพธ์ของ aquery ค่าที่อนุญาตสำหรับ aquery คือ text, textproto, proto, jsonproto
แท็กterminal_output
--[no]proto:default_values
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ระบบจะรวมแอตทริบิวต์ที่ไม่ได้ระบุค่าอย่างชัดเจนในไฟล์ BUILD ไว้ด้วย มิฉะนั้นจะละเว้น ตัวเลือกนี้ใช้ได้กับ --output=proto
แท็ก:terminal_output
--[no]proto:definition_stack
ค่าเริ่มต้น: "false"-
ป้อนข้อมูลฟิลด์ Proto ของ definition_stack ซึ่งจะบันทึกสแต็กการเรียก Starlark สำหรับอินสแตนซ์ของกฎแต่ละรายการ ณ เวลาที่กำหนดคลาสของกฎ
แท็กterminal_output
--[no]proto:flatten_selects
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ระบบจะทำให้แอตทริบิวต์ที่กำหนดค่าได้ซึ่งสร้างโดย select() แบนราบ สำหรับประเภทรายการ การแสดงแบบ Flatten คือรายการที่มีค่าของแผนที่ที่เลือกแต่ละค่าเพียงครั้งเดียว ระบบจะทำให้ประเภทสเกลาร์แบนเป็นค่าว่าง
แท็กbuild_file_semantics
--[no]proto:include_synthetic_attribute_hash
ค่าเริ่มต้น: "false"-
จะคำนวณและสร้างแอตทริบิวต์ $internal_attr_hash หรือไม่
แท็กterminal_output
--[no]proto:instantiation_stack
ค่าเริ่มต้น: "false"-
สร้างสแต็กการเรียกอินสแตนซ์ของแต่ละกฎ โปรดทราบว่าต้องมีสแต็กจึงจะดำเนินการนี้ได้
แท็กterminal_output
--[no]proto:locations
ค่าเริ่มต้น: "จริง"-
จะแสดงข้อมูลตำแหน่งในเอาต์พุต Proto หรือไม่
แท็กterminal_output
--proto:output_rule_attrs=<comma-separated list of options>
ค่าเริ่มต้น: "all"-
รายการแอตทริบิวต์ที่คั่นด้วยคอมมาที่จะรวมไว้ในเอาต์พุต ค่าเริ่มต้นคือแอตทริบิวต์ทั้งหมด ตั้งค่าเป็นสตริงว่างเปล่าเพื่อไม่ให้แสดงแอตทริบิวต์ใดๆ ตัวเลือกนี้ใช้ได้กับ --output=proto
แท็กterminal_output
--[no]proto:rule_inputs_and_outputs
ค่าเริ่มต้น: "จริง"-
จะป้อนข้อมูลในช่อง rule_input และ rule_output หรือไม่
แท็กterminal_output
--query_file=<a string>
ค่าเริ่มต้น: ""-
หากตั้งค่าไว้ การค้นหาจะอ่านการค้นหาจากไฟล์ที่ตั้งชื่อไว้ที่นี่ แทนที่จะอ่านจากบรรทัดคำสั่ง การระบุไฟล์ที่นี่รวมถึงการค้นหาในบรรทัดคำสั่งถือเป็นข้อผิดพลาด
แท็กchanges_inputs
--[no]relative_locations
ค่าเริ่มต้น: "false"-
หากเป็นจริง ตำแหน่งของไฟล์ BUILD ในเอาต์พุต XML และ Proto จะเป็นแบบสัมพัทธ์ โดยค่าเริ่มต้น เอาต์พุตตำแหน่งจะเป็นเส้นทางที่สมบูรณ์และจะไม่สอดคล้องกันในเครื่องต่างๆ คุณสามารถตั้งค่าตัวเลือกนี้เป็น "จริง" เพื่อให้ได้ผลลัพธ์ที่สอดคล้องกันในเครื่องต่างๆ
แท็กterminal_output
--[no]skyframe_state
ค่าเริ่มต้น: "false"-
โดยไม่ต้องทำการวิเคราะห์เพิ่มเติม ให้ทิ้ง Action Graph ปัจจุบันจาก Skyframe หมายเหตุ: ปัจจุบันยังไม่รองรับการระบุเป้าหมายด้วย --skyframe_state โดยแฟล็กนี้ใช้ได้กับ --output=proto หรือ --output=textproto เท่านั้น
แท็กterminal_output
--[no]tool_deps
ค่าเริ่มต้น: "จริง"-
คำค้นหา: หากปิดใช้ ระบบจะไม่รวมการอ้างอิงเป้าหมาย "การกำหนดค่าโฮสต์" หรือ "การดำเนินการ" ไว้ในกราฟการอ้างอิงที่คำค้นหาดำเนินการ ขอบเขตการพึ่งพา "การกำหนดค่าโฮสต์" เช่น ขอบเขตจากกฎ "proto_library" ไปยังคอมไพเลอร์โปรโตคอล มักจะชี้ไปยังเครื่องมือที่ดำเนินการในระหว่างการบิลด์แทนที่จะเป็นส่วนหนึ่งของโปรแกรม "เป้าหมาย" เดียวกัน
Cquery: หากปิดใช้ ระบบจะกรองเป้าหมายที่กำหนดค่าทั้งหมดซึ่งข้ามโฮสต์หรือการเปลี่ยนการดำเนินการจากเป้าหมายระดับบนสุดที่ค้นพบเป้าหมายที่กำหนดค่านี้ ซึ่งหมายความว่าหากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าเป้าหมาย ระบบจะแสดงเฉพาะเป้าหมายที่กำหนดค่าซึ่งอยู่ในกำหนดค่าเป้าหมายด้วย หากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าโฮสต์ ระบบจะแสดงเฉพาะเป้าหมายที่กำหนดค่าโฮสต์ ตัวเลือกนี้จะไม่ยกเว้น 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>` ที่จะได้รับอนุญาตในกราฟการอ้างอิงที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่าถูกยกเลิกในรีจิสทรีที่โมดูลมาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น เวอร์ชันที่ถูกเพิกถอนจะทำให้การแก้ไขล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันที่อนุญาตให้ยกเลิกได้ด้วยตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็กloading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ `error` เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาที่ไม่สำเร็จ, `off` เพื่อปิดใช้การตรวจสอบ หรือ `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน
แท็กloading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าการอ้างอิง `bazel_dep` โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้ว ค่าที่ใช้ได้คือ `off` เพื่อปิดใช้การตรวจสอบ, `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน หรือ `error` เพื่อส่งต่อเป็นความล้มเหลวในการแก้ไข
แท็กloading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นการขึ้นต่อกันของนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท ไม่ว่าค่าของแฟล็กนี้จะเป็นอะไรก็ตาม
แท็กloading_and_analysis
--lockfile_mode=<off, update or error>
ค่าเริ่มต้น: "ปิด"-
ระบุวิธีและจะใช้หรือไม่ใช้ไฟล์ล็อก ค่าที่ใช้ได้คือ `update` เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง, `error` เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่อัปเดต หรือ `off` เพื่อไม่ให้อ่านหรือเขียนไปยังไฟล์ล็อก
แท็กloading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
มีการสะสมการใช้งานหลายครั้ง- แทนที่โมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--registry=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้เพื่อค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับมีความสำคัญ โดยระบบจะค้นหาโมดูลในรีจิสทรีที่อยู่ก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีที่อยู่ถัดไปก็ต่อเมื่อไม่มีโมดูลในรีจิสทรีที่อยู่ก่อนหน้า
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อความละเอียด รูปแบบ หรือตำแหน่งของการบันทึก:
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น ระบบจะจำกัดจำนวนประเภทการดำเนินการไว้ที่ 20 นิโมนิกที่มีจำนวนการดำเนินการที่ดำเนินการแล้วมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับทุกคำช่วยจำ
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปในคำสั่ง Bazel ซึ่งไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้อ่านไฟล์ที่ระบุซึ่งแก้ไขแล้วแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
--experimental_downloader_config=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไฟล์เพื่อกำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สำหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ รูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้เป็น URL แทน โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณสามารถระบุคำสั่ง `rewrite` หลายรายการสำหรับ URL เดียวกันได้ และในกรณีนี้ ระบบจะแสดง URL หลายรายการ
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้:
--override_repository=<an equals-separated mapping of repository name to path>
มีการสะสมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุเริ่มต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
--[no]experimental_inprocess_symlink_creation
ค่าเริ่มต้น: "false"-
จะเรียกใช้ระบบไฟล์โดยตรงเพื่อสร้างโครงสร้างซิมลิงก์หรือไม่
แท็ก:loading_and_analysis
,execution
,experimental
--[no]experimental_remotable_source_manifests
ค่าเริ่มต้น: "false"-
จะทำให้การดำเนินการกับไฟล์ Manifest ต้นฉบับสามารถดำเนินการจากระยะไกลได้หรือไม่
แท็ก:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะเรียกใช้การประมวลผลภายหลังของ Coverage สำหรับการทดสอบในกระบวนการใหม่
แท็กexecution
--[no]experimental_strict_fileset_output
ค่าเริ่มต้น: "false"-
หากเปิดใช้ตัวเลือกนี้ ชุดไฟล์จะถือว่าอาร์ติแฟกต์เอาต์พุตทั้งหมดเป็นไฟล์ปกติ โดยจะไม่ข้ามไดเรกทอรีหรือคำนึงถึงลิงก์สัญลักษณ์
แท็กexecution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
ค่าเริ่มต้น: ""-
เพิ่มหรือนำคีย์ออกจากข้อมูลการดำเนินการของแอ็กชันตามคำช่วยจำของแอ็กชัน ใช้กับการดำเนินการที่รองรับข้อมูลการดำเนินการเท่านั้น การดำเนินการทั่วไปหลายอย่างรองรับข้อมูลการดำเนินการ เช่น Genrule, CppCompile, Javac, StarlarkAction, TestRunner เมื่อระบุค่าหลายค่า ลำดับมีความสำคัญเนื่องจากนิพจน์ทั่วไปจำนวนมากอาจใช้กับตัวช่วยจำเดียวกัน
ไวยากรณ์: "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 อย่างต่อเนื่องโดยใช้ Worker
ขยายเป็น
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
แท็กhost_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
เปิดใช้ตัวประมวลผลทรัพยากร Android แบบถาวรโดยใช้ Worker
ขยายเป็น
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
แท็กhost_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
เปิดใช้การดำเนินการ dex และ desugar ของ Android แบบหลายรายการที่ต่อเนื่องโดยใช้ Worker
ขยายเป็น:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
เปิดใช้ตัวประมวลผลทรัพยากร Android แบบมัลติเพล็กซ์ถาวรโดยใช้ Worker
ขยายเป็น
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
แท็กhost_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
เปิดใช้เครื่องมือ Android แบบถาวรและแบบมัลติเพล็กซ์ (dexing, desugaring, การประมวลผลทรัพยากร)
ขยายเป็น:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
แท็ก:host_machine_resource_optimizations
,execution
- ตัวเลือกที่กำหนดค่าเครื่องมือที่ใช้สำหรับการดำเนินการ:
--android_compiler=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
คอมไพเลอร์เป้าหมายของ Android
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
default: "//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 Flag to help thetransition to the Android manifest merger from the legacy merger.
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
ค่าเริ่มต้น: ""-
ตั้งค่าแพลตฟอร์มที่เป้าหมาย android_binary ใช้ หากระบุหลายแพลตฟอร์ม ไบนารีจะเป็น APK แบบ Fat ซึ่งมีไบนารีแบบเนทีฟสำหรับแต่ละแพลตฟอร์มเป้าหมายที่ระบุ
แท็กchanges_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
default: "@bazel_tools//tools/android:sdk"-
ระบุ Android SDK/แพลตฟอร์มที่ใช้สร้างแอปพลิเคชัน Android
แท็กchanges_inputs
,loading_and_analysis
,loses_incremental_state
--apple_compiler=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
คอมไพเลอร์เป้าหมายของ Apple มีประโยชน์สำหรับการเลือกตัวแปรของ Toolchain (เช่น xcode-beta)
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
default: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้ในกฎ Apple และ Objc รวมถึงการอ้างอิงของกฎเหล่านั้น
แท็ก:loses_incremental_state
,changes_inputs
--apple_grte_top=<a build target label>
ค่าเริ่มต้น: ดูคำอธิบาย-
เป้าหมาย Apple grte_top
แท็กchanges_inputs
,loading_and_analysis
,loses_incremental_state
--cc_output_directory_tag=<a string>
ค่าเริ่มต้น: ""-
ระบุคำต่อท้ายที่จะเพิ่มลงในไดเรกทอรีการกำหนดค่า
แท็ก:affects_outputs
,explicit_in_output_path
--compiler=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
คอมไพเลอร์ C++ ที่จะใช้คอมไพล์เป้าหมาย
แท็ก:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
default: "@bazel_tools//tools/test:lcov_merger"-
ตำแหน่งของไบนารีที่ใช้ในการประมวลผลรายงานความครอบคลุมดิบ ปัจจุบันต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งก็คือไบนารี ค่าเริ่มต้นคือ "//tools/test:lcov_merger"
แท็กchanges_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
default: "@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>
default: "@bazel_tools//tools/test:coverage_support"-
ตำแหน่งของไฟล์สนับสนุนที่จำเป็นในอินพุตของการดำเนินการทดสอบทุกครั้งที่รวบรวมความครอบคลุมของโค้ด ค่าเริ่มต้นคือ "//tools/test:coverage_support"
แท็กchanges_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
default: "@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 รายการ ระบบจะดำเนินการความละเอียดของเครื่องมือราวกับว่าได้ประกาศค่าข้อจำกัดเป็นข้อจำกัดในการดำเนินการ ตัวอย่าง: //demo,-test=@platforms//cpus:x86_64 จะเพิ่ม "x86_64" ให้กับเป้าหมายใดก็ตามภายใต้ //demo ยกเว้นเป้าหมายที่มีชื่อซึ่งมี "test"
แท็กloading_and_analysis
--[no]experimental_enable_objc_cc_deps
ค่าเริ่มต้น: "จริง"-
อนุญาตให้กฎ objc_* ขึ้นอยู่กับ cc_library และทำให้มีการสร้างการอ้างอิง objc ใดๆ โดยตั้งค่า --cpu เป็น "ios_<--ios_cpu>" สำหรับค่าใดๆ ใน --ios_multi_cpu
แท็ก:loading_and_analysis
,incompatible_change
--[no]experimental_include_xcode_execution_requirements
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ให้เพิ่มข้อกำหนดในการดำเนินการ "requires-xcode:{version}" ลงในการดำเนินการ Xcode ทุกรายการ หากเวอร์ชัน xcode มีป้ายกำกับที่มีขีดกลาง ให้เพิ่มข้อกำหนดในการดำเนินการ "requires-xcode-label:{version_label}" ด้วย
แท็กloses_incremental_state
,loading_and_analysis
,execution
--[no]experimental_prefer_mutual_xcode
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ให้ใช้ 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 คุณระบุ Toolchain ได้โดยใช้เป้าหมายที่แน่นอนหรือรูปแบบเป้าหมาย ระบบจะพิจารณา Toolchain เหล่านี้ก่อน Toolchain ที่ประกาศไว้ในไฟล์ WORKSPACE โดย register_toolchains()
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
ค่าเริ่มต้น: ดูคำอธิบาย-
ป้ายกำกับสำหรับไลบรารี libc ที่เช็คอินแล้ว ค่าเริ่มต้นจะเลือกโดยเครื่องมือ Crosstool Toolchain และคุณแทบจะไม่ต้องลบล้างค่านี้
แท็ก:action_command_lines
,affects_outputs
--host_compiler=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
คอมไพเลอร์ C++ ที่จะใช้สำหรับการคอมไพล์โฮสต์ ระบบจะไม่สนใจหากไม่ได้ตั้งค่า --host_crosstool_top
แท็ก:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
ค่าเริ่มต้น: ดูคำอธิบาย-
โดยค่าเริ่มต้น ระบบจะใช้ตัวเลือก --crosstool_top และ --compiler กับการกำหนดค่าโฮสต์ด้วย หากมีการระบุแฟล็กนี้ Bazel จะใช้ libc และคอมไพเลอร์เริ่มต้นสำหรับ crosstool_top ที่ระบุ
แท็กloading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
ค่าเริ่มต้น: ดูคำอธิบาย-
หากระบุไว้ การตั้งค่านี้จะลบล้างไดเรกทอรีระดับบนสุดของ libc (--grte_top) สำหรับการกำหนดค่าโฮสต์
แท็ก:action_command_lines
,affects_outputs
--host_platform=<a build target label>
ค่าเริ่มต้น: ""-
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายระบบโฮสต์
แท็กaffects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง Bazel จะไม่อนุญาตให้ระบุ expand_if_all_available ใน flag_sets(ดูวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/7008)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง Bazel จะไม่เปิดใช้ฟีเจอร์ "โฮสต์" และ "ไม่ใช่โฮสต์" ในเครื่องมือ C++ (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/7407)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
ค่าเริ่มต้น: "false"-
ใช้การแก้ปัญหา Toolchain เพื่อเลือก Android SDK สำหรับกฎ Android (Starlark และเนทีฟ)
แท็กloading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
ค่าเริ่มต้น: "false"-
ใช้การแก้ปัญหา Toolchain เพื่อเลือก Apple SDK สำหรับกฎของ Apple (Starlark และเนทีฟ)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง Bazel จะไม่นำบรรทัดคำสั่งการดำเนินการลิงก์ C++ กลับมาใช้ซ้ำสำหรับบรรทัดคำสั่งการจัดทำดัชนี LTO (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/6791)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง Bazel จะแจ้งข้อผิดพลาดเมื่อตั้งค่าแอตทริบิวต์ cc_toolchain.cpu และ cc_toolchain.compiler (ดูวิธีการย้ายข้อมูลได้ที่ https://github.com/bazelbuild/bazel/issues/7075)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง Bazel จะไม่ลิงก์ทรัพยากร Dependency ของไลบรารีเป็นทั้งอาร์ไคฟ์โดยค่าเริ่มต้น (ดูวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/7362)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง Bazel จะกำหนดให้มีพารามิเตอร์ "ctx" ใน cc_common.configure_features (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/7793)
แท็ก:loading_and_analysis
,incompatible_change
-
ใช้ออบเจ็กต์ที่แชร์ของอินเทอร์เฟซหากชุดเครื่องมือรองรับ ปัจจุบัน 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 หากไม่ได้ระบุ ให้ใช้ SDK เวอร์ชันเริ่มต้นของ iOS จาก "xcode_version"
แท็กloses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุเวอร์ชันของ macOS SDK ที่จะใช้ในการสร้างแอปพลิเคชัน macOS หากไม่ได้ระบุไว้ ให้ใช้ SDK เวอร์ชันเริ่มต้นของ macOS จาก "xcode_version"
แท็กloses_incremental_state
--minimum_os_version=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
เวอร์ชันระบบปฏิบัติการขั้นต่ำที่การคอมไพล์ของคุณกำหนดเป้าหมาย
แท็ก:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
ค่าเริ่มต้น: ""-
ตำแหน่งของไฟล์แมปที่อธิบายว่าควรใช้แพลตฟอร์มใดหากไม่ได้ตั้งค่า หรือควรตั้งค่า Flag ใดเมื่อมีแพลตฟอร์มอยู่แล้ว ต้องสัมพันธ์กับรูทของพื้นที่ทำงานหลัก ค่าเริ่มต้นคือ "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
--target_platform_fallback=<a build target label>
default: "@local_config_platform//:host"-
ป้ายกำกับของกฎแพลตฟอร์มที่ควรใช้หากไม่ได้ตั้งค่าแพลตฟอร์มเป้าหมายและไม่มีการแมปแพลตฟอร์มที่ตรงกับชุดค่าสถานะปัจจุบัน
แท็กaffects_outputs
,changes_inputs
,loading_and_analysis
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุเวอร์ชันของ tvOS SDK ที่จะใช้ในการสร้างแอปพลิเคชัน tvOS หากไม่ได้ระบุ ระบบจะใช้ SDK เวอร์ชันเริ่มต้นของ tvOS จาก "xcode_version"
แท็กloses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุเวอร์ชันของ watchOS SDK ที่จะใช้ในการสร้างแอปพลิเคชัน watchOS หากไม่ได้ระบุ ให้ใช้ SDK เวอร์ชันเริ่มต้นของ watchOS จาก "xcode_version"
แท็กloses_incremental_state
--xcode_version=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
หากระบุไว้ จะใช้ Xcode เวอร์ชันที่กำหนดสำหรับการดำเนินการบิลด์ที่เกี่ยวข้อง หากไม่ได้ระบุ ระบบจะใช้ Xcode เวอร์ชันเริ่มต้นของตัวดำเนินการ
แท็กloses_incremental_state
--xcode_version_config=<a build target label>
default: "@bazel_tools//tools/cpp:host_xcodes"-
ป้ายกำกับของกฎ xcode_config ที่จะใช้ในการเลือกเวอร์ชัน Xcode ในการกำหนดค่าบิลด์
แท็ก:loses_incremental_state
,loading_and_analysis
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่ง
--[no]apple_enable_auto_dsym_dbg
ค่าเริ่มต้น: "false"-
เลือกว่าจะบังคับให้เปิดใช้การสร้างไฟล์สัญลักษณ์สำหรับแก้ไขข้อบกพร่อง (.dSYM) สำหรับบิลด์ dbg หรือไม่
แท็ก:affects_outputs
,action_command_lines
--[no]apple_generate_dsym
ค่าเริ่มต้น: "false"-
จะสร้างไฟล์สัญลักษณ์สำหรับแก้ไขข้อบกพร่อง (.dSYM) หรือไม่
แท็ก:affects_outputs
,action_command_lines
--[no]build_runfile_links
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ให้สร้างป่าซิมลิงก์ของไฟล์ที่เรียกใช้ได้สำหรับเป้าหมายทั้งหมด หากเป็นเท็จ ให้เขียนเฉพาะไฟล์ Manifest เมื่อเป็นไปได้
แท็กaffects_outputs
--[no]build_runfile_manifests
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ให้เขียนไฟล์ Manifest ของไฟล์ที่เรียกใช้สำหรับเป้าหมายทั้งหมด หากเป็นเท็จ ให้ละเว้น การทดสอบในเครื่องจะเรียกใช้ไม่สำเร็จเมื่อเป็นเท็จ
แท็กaffects_outputs
--[no]build_test_dwp
ค่าเริ่มต้น: "false"-
หากเปิดใช้ เมื่อสร้างการทดสอบ C++ แบบคงที่และใช้ฟิชชัน ระบบจะสร้างไฟล์ .dwp สำหรับไบนารีของการทดสอบโดยอัตโนมัติด้วย
แท็ก:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated list of options>
ค่าเริ่มต้น: ".pb.h"-
ตั้งค่าคำนำหน้าของไฟล์ส่วนหัวที่ cc_proto_library สร้างขึ้น
แท็ก:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated list of options>
ค่าเริ่มต้น: ".pb.cc"-
ตั้งค่าคำนำหน้าของไฟล์ต้นฉบับที่ cc_proto_library สร้างขึ้น
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
ค่าเริ่มต้น: "false"-
เรียกใช้การดำเนินการเพิ่มเติมสำหรับเวอร์ชัน API ของ Java สำรองใน proto_library
แท็กaffects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
ค่าเริ่มต้น: "false"-
เรียกใช้การดำเนินการเพิ่มเติมสำหรับเวอร์ชัน API ของ Java สำรองใน proto_library
แท็กaffects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
ค่าเริ่มต้น: "false"-
บันทึกสถานะของฟีเจอร์ที่เปิดใช้และที่ขอเป็นเอาต์พุตของการคอมไพล์
แท็ก:affects_outputs
,experimental
--fission=<a set of compilation modes>
ค่าเริ่มต้น: "no"-
ระบุโหมดการคอมไพล์ที่ใช้ฟิชชันสำหรับการคอมไพล์และการลิงก์ C++ อาจเป็นชุดค่าผสมใดก็ได้ของ {'fastbuild', 'dbg', 'opt'} หรือค่าพิเศษ 'yes' เพื่อเปิดใช้ทุกโหมด และ 'no' เพื่อปิดใช้ทุกโหมด
แท็กloading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง กฎดั้งเดิมจะเพิ่ม <code>DefaultInfo.files</code> ของการขึ้นต่อกันของข้อมูลลงในไฟล์ที่เรียกใช้ ซึ่งตรงกับลักษณะการทำงานที่แนะนำสำหรับกฎ Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid)
แท็ก:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ให้สร้างป่าซิมลิงก์ของไฟล์ที่เรียกใช้สำหรับที่เก็บภายนอกภายใต้ .runfiles/wsname/external/repo (นอกเหนือจาก .runfiles/repo)
แท็กaffects_outputs
--[no]objc_generate_linkmap
ค่าเริ่มต้น: "false"-
ระบุว่าจะสร้างไฟล์ Linkmap หรือไม่
แท็กaffects_outputs
--[no]save_temps
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ระบบจะบันทึกเอาต์พุตชั่วคราวจาก gcc ซึ่งรวมถึงไฟล์ .s (โค้ดแอสเซมเบลอร์), ไฟล์ .i (C ที่ประมวลผลล่วงหน้า) และไฟล์ .ii (C++ ที่ประมวลผลล่วงหน้า)
แท็ก:affects_outputs
- ตัวเลือกที่ช่วยให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการ ซึ่งจะส่งผลต่อค่าของเอาต์พุตนั้นๆ ไม่ใช่การมีอยู่ของเอาต์พุต
--action_env=<a 'name=value' assignment with an optional value part>
มีการสะสมการใช้งานหลายครั้ง-
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกำหนดค่าเป้าหมาย ตัวแปรอาจระบุตามชื่อ ในกรณีนี้ค่าจะมาจากสภาพแวดล้อมการเรียกใช้ หรือระบุตามคู่ชื่อ=ค่า ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ คุณใช้ตัวเลือกนี้ได้หลายครั้ง สำหรับตัวเลือกที่ระบุไว้สำหรับตัวแปรเดียวกัน ตัวเลือกที่ระบุล่าสุดจะชนะ ส่วนตัวเลือกสำหรับตัวแปรที่แตกต่างกันจะสะสม
แท็กaction_command_lines
--android_cpu=<a string>
ค่าเริ่มต้น: "armeabi-v7a"-
CPU เป้าหมายของ Android
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
ค่าเริ่มต้น: "false"-
สร้างไฟล์การเชื่อมโยงข้อมูลที่เข้ากันได้กับ AndroidX ซึ่งใช้ได้กับ Data Binding v2 เท่านั้น
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
ค่าเริ่มต้น: "false"-
ใช้ Data Binding v2 ของ Android กับอาร์กิวเมนต์ 3.4.0
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
ค่าเริ่มต้น: "ปิด"-
กำหนดว่าจะลิงก์ C++ deps ของกฎ Android แบบไดนามิกหรือไม่เมื่อ cc_binary ไม่ได้สร้างไลบรารีที่ใช้ร่วมกันอย่างชัดเจน "default" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "ทั้งหมด" หมายความว่าระบบจะลิงก์ไลบรารีทั้งหมดแบบไดนามิก "ปิด" หมายความว่าระบบจะลิงก์ไลบรารีทั้งหมดในโหมดแบบคงที่เป็นส่วนใหญ่
แท็ก:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
ค่าเริ่มต้น: "ตามตัวอักษร"-
กำหนดลำดับของไฟล์ Manifest ที่ส่งผ่านไปยังเครื่องมือผสานไฟล์ Manifest สำหรับไบนารี Android ALPHABETICAL หมายความว่าระบบจะจัดเรียงไฟล์ Manifest ตามเส้นทางที่เกี่ยวข้องกับ execroot ALPHABETICAL_BY_CONFIGURATION หมายความว่าระบบจะจัดเรียงไฟล์ Manifest ตามเส้นทางที่สัมพันธ์กับไดเรกทอรีการกำหนดค่าภายในไดเรกทอรีเอาต์พุต DEPENDENCY หมายความว่าไฟล์ Manifest จะเรียงตามลำดับโดยไฟล์ Manifest ของแต่ละไลบรารีจะอยู่ก่อนไฟล์ Manifest ของการอ้างอิง
แท็ก:action_command_lines
,execution
--[no]android_resource_shrinking
ค่าเริ่มต้น: "false"-
เปิดใช้การลดขนาดทรัพยากรสำหรับ APK ของ android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
,loading_and_analysis
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, visionos, watchos, tvos, macos or catalyst>
มีการสะสมการใช้งานหลายครั้ง-
ระบุโหมดบิตโค้ดของ Apple สำหรับขั้นตอนการคอมไพล์ที่กำหนดเป้าหมายเป็นสถาปัตยกรรมของอุปกรณ์ ค่าอยู่ในรูปแบบ "[platform=]mode" โดยแพลตฟอร์ม (ซึ่งต้องเป็น "ios", "macos", "tvos" หรือ "watchos") เป็นตัวเลือก หากระบุไว้ ระบบจะใช้โหมดบิตโค้ดสำหรับแพลตฟอร์มนั้นโดยเฉพาะ หากไม่ระบุ ระบบจะใช้โหมดบิตโค้ดสำหรับทุกแพลตฟอร์ม โหมดต้องเป็น "none", "embedded_markers" หรือ "embedded" ตัวเลือกนี้อาจแสดงหลายครั้ง
แท็กloses_incremental_state
--[no]build_python_zip
ค่าเริ่มต้น: "auto"-
สร้างไฟล์ zip ที่เรียกใช้งาน Python ได้ เปิดใน Windows ปิดในแพลตฟอร์มอื่นๆ
แท็ก:affects_outputs
--catalyst_cpus=<comma-separated list of options>
มีการสะสมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาซึ่งจะใช้สร้างไบนารี Apple Catalyst
แท็ก:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
ค่าเริ่มต้น: "false"-
หากระบุไว้ Bazel จะวัดโค้ด (ใช้การวัดแบบออฟไลน์หากเป็นไปได้) และจะรวบรวมข้อมูลความครอบคลุมระหว่างการทดสอบ โดยจะมีผลเฉพาะเป้าหมายที่ตรงกับ --instrumentation_filter โดยปกติแล้วไม่ควรกำหนดตัวเลือกนี้โดยตรง แต่ควรใช้คำสั่ง "bazel coverage" แทน
แท็กaffects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] ค่าเริ่มต้น: "fastbuild"-
ระบุโหมดที่จะสร้างไบนารี ค่า: 'fastbuild', 'dbg', 'opt'
แท็กaffects_outputs
,action_command_lines
,explicit_in_output_path
--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
,explicit_in_output_path
--cs_fdo_absolute_path=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
ใช้ข้อมูลโปรไฟล์ CSFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อเส้นทางสัมบูรณ์ของไฟล์ ZIP ที่มีไฟล์โปรไฟล์ ไฟล์ LLVM โปรไฟล์แบบดิบ หรือไฟล์ LLVM โปรไฟล์ที่จัดทำดัชนี
แท็กaffects_outputs
--cs_fdo_instrument=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
สร้างไบนารีด้วยการใช้ FDO ที่คำนึงถึงบริบทเป็นเครื่องมือ เมื่อใช้คอมไพเลอร์ Clang/LLVM ระบบจะยอมรับชื่อไดเรกทอรีที่จะทิ้งไฟล์โปรไฟล์ดิบในรันไทม์ด้วย
แท็ก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>
ค่าเริ่มต้น: "default"-
กำหนดว่าจะลิงก์ไบนารี C++ แบบไดนามิกหรือไม่ "default" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "ทั้งหมด" หมายความว่าระบบจะลิงก์ไลบรารีทั้งหมดแบบไดนามิก "ปิด" หมายความว่าระบบจะลิงก์ไลบรารีทั้งหมดในโหมดแบบคงที่เป็นส่วนใหญ่
แท็ก:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าไว้ การใช้ fdo_absolute_profile_path จะทำให้เกิดข้อผิดพลาด
แท็กaffects_outputs
--[no]enable_runfiles
ค่าเริ่มต้น: "auto"-
เปิดใช้ทรีลิงก์สัญลักษณ์ของไฟล์ที่เรียกใช้ โดยค่าเริ่มต้นจะปิดใน Windows และเปิดในแพลตฟอร์มอื่นๆ
แท็กaffects_outputs
--experimental_action_listener=<a build target label>
มีการสะสมการใช้งานหลายครั้ง-
เลิกใช้งานแล้วเพื่อใช้แง่มุมแทน ใช้ action_listener เพื่อแนบ extra_action กับการดำเนินการบิลด์ที่มีอยู่
แท็ก:execution
,experimental
--[no]experimental_android_compress_java_resources
ค่าเริ่มต้น: "false"-
บีบอัดทรัพยากร Java ใน APK
แท็ก:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
ค่าเริ่มต้น: "false"-
ใช้ Data Binding v2 ของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
ค่าเริ่มต้น: "false"-
เปิดใช้การลดขนาดทรัพยากรสำหรับ APK ของ android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
ค่าเริ่มต้น: "false"-
ใช้เครื่องมือ rex เพื่อเขียนไฟล์ dex ใหม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
ค่าเริ่มต้น: "false"-
หากระบุไว้ Bazel จะสร้างข้อมูลความครอบคลุมในการรวบรวมสำหรับไฟล์ที่สร้างขึ้นด้วย
แท็กaffects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
ค่าเริ่มต้น: "-O0,-DDEBUG=1"-
ใช้สตริงเหล่านี้เป็นตัวเลือกคอมไพเลอร์ objc fastbuild
แท็กaction_command_lines
--[no]experimental_omitfp
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้ libunwind สำหรับการคลายสแต็ก และคอมไพล์ด้วย -fomit-frame-pointer และ -fasynchronous-unwind-tables
แท็กaction_command_lines
,affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
ค่าเริ่มต้น: "false"-
หากเป็นจริง ระบบจะใช้แพลตฟอร์มเป้าหมายในชื่อไดเรกทอรีเอาต์พุตแทน CPU
แท็ก:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
ค่าเริ่มต้น: "false"-
หากระบุไว้ Bazel จะสร้างข้อมูลแผนที่ความครอบคลุมของ llvm-cov แทน gcov เมื่อเปิดใช้ collect_code_coverage
แท็กchanges_inputs
,affects_outputs
,loading_and_analysis
,experimental
--fat_apk_cpu=<comma-separated list of options>
ค่าเริ่มต้น: "armeabi-v7a"-
การตั้งค่าตัวเลือกนี้จะเปิดใช้ APK แบบ Fat ซึ่งมีไบนารีเนทีฟสำหรับสถาปัตยกรรมเป้าหมายที่ระบุทั้งหมด เช่น --fat_apk_cpu=x86,armeabi-v7a. หากระบุแฟล็กนี้ ระบบจะไม่สนใจ --android_cpu สำหรับการขึ้นต่อกันของกฎ android_binary
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
ค่าเริ่มต้น: "false"-
ว่าจะสร้างการแยก HWASAN หรือไม่
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
สร้างไบนารีด้วยการใช้ FDO เป็นเครื่องมือ เมื่อใช้คอมไพเลอร์ Clang/LLVM ระบบจะยอมรับชื่อไดเรกทอรีที่จะทิ้งไฟล์โปรไฟล์ดิบในรันไทม์ด้วย
แท็ก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>
มีการสะสมการใช้งานหลายครั้ง-
ระบบจะเปิดหรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างในการกำหนดค่าเป้าหมาย การระบุ -<ฟีเจอร์> จะเป็นการปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ ดูเพิ่มเติม --host_features
แท็ก:changes_inputs
,affects_outputs
--[no]force_pic
ค่าเริ่มต้น: "false"-
หากเปิดใช้ การคอมไพล์ C++ ทั้งหมดจะสร้างโค้ดที่ไม่ขึ้นกับตำแหน่ง ("-fPIC") ลิงก์จะเลือกใช้ไลบรารี PIC ที่สร้างไว้ล่วงหน้ามากกว่าไลบรารีที่ไม่ใช่ PIC และลิงก์จะสร้างไฟล์ปฏิบัติการที่ไม่ขึ้นกับตำแหน่ง ("-pie")
แท็ก:loading_and_analysis
,affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
มีการสะสมการใช้งานหลายครั้ง-
ระบุชุดตัวแปรสภาพแวดล้อมที่พร้อมใช้งานสำหรับการดำเนินการที่มีการกำหนดค่าโฮสต์หรือการดำเนินการ ตัวแปรอาจระบุตามชื่อ ในกรณีนี้ค่าจะมาจากสภาพแวดล้อมการเรียกใช้ หรือระบุตามคู่ชื่อ=ค่า ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ คุณใช้ตัวเลือกนี้ได้หลายครั้ง สำหรับตัวเลือกที่ระบุไว้สำหรับตัวแปรเดียวกัน ตัวเลือกที่ระบุล่าสุดจะชนะ ส่วนตัวเลือกสำหรับตัวแปรที่แตกต่างกันจะสะสม
แท็กaction_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
ค่าเริ่มต้น: "opt"-
ระบุโหมดที่จะใช้สร้างเครื่องมือที่ใช้ในระหว่างการสร้าง ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
,action_command_lines
--host_conlyopt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C สำหรับเครื่องมือโฮสต์
แท็ก:action_command_lines
,affects_outputs
--host_copt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง gcc สำหรับเครื่องมือโฮสต์
แท็ก:action_command_lines
,affects_outputs
--host_cpu=<a string>
ค่าเริ่มต้น: ""-
CPU ของโฮสต์
แท็ก:changes_inputs
,affects_outputs
--host_cxxopt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง gcc สำหรับเครื่องมือโฮสต์
แท็ก:action_command_lines
,affects_outputs
--host_features=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบบจะเปิดหรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างในการกำหนดค่า exec การระบุ -<ฟีเจอร์> จะเป็นการปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ
แท็ก:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
ค่าเริ่มต้น: ดูคำอธิบาย-
ลบล้างเวอร์ชัน Python สำหรับการกำหนดค่าโฮสต์ อาจเป็น "PY2" หรือ "PY3"
แท็ก:loading_and_analysis
,affects_outputs
--host_linkopt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง gcc เมื่อลิงก์เครื่องมือโฮสต์
แท็ก: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++ อย่างเลือกเมื่อคอมไพล์ไฟล์บางไฟล์ในการกำหนดค่าโฮสต์หรือการกำหนดค่า Exec ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter หมายถึงรายการรูปแบบนิพจน์ทั่วไปที่รวมและยกเว้น (ดู --instrumentation_filter ด้วย) ส่วน option_1 ถึง option_n หมายถึงตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีคอมมา คุณต้องใส่เครื่องหมายคำพูดพร้อมแบ็กสแลช ตัวเลือกมี @ ได้ แต่จะใช้ @ ตัวแรกเท่านั้นในการแยกสตริง ตัวอย่าง: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 จะเพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ลงในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
,affects_outputs
--host_swiftcopt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง swiftc สำหรับเครื่องมือโฮสต์
แท็ก:action_command_lines
,affects_outputs
--[no]incompatible_avoid_conflict_dlls
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ระบบจะเปลี่ยนชื่อไลบรารีลิงก์แบบไดนามิก (DLL) ของ C++ ทั้งหมดที่สร้างโดย cc_library ใน Windows เป็น name_{hash}.dll โดยที่ hash จะคำนวณตาม RepositoryName และเส้นทางแพ็กเกจของ DLL ตัวเลือกนี้มีประโยชน์เมื่อคุณมีแพ็กเกจเดียวที่ขึ้นอยู่กับ cc_library หลายรายการที่มีชื่อเดียวกัน (เช่น //foo/bar1:utils และ //foo/bar2:utils)
แท็กloading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ระบบจะรวมไดเรกทอรี genfiles เข้ากับไดเรกทอรี bin
แท็ก:affects_outputs
,incompatible_change
--[no]incompatible_use_host_features
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้ --features สำหรับการกำหนดค่าเป้าหมายเท่านั้น และใช้ --host_features สำหรับการกำหนดค่า exec
แท็กchanges_inputs
,affects_outputs
,incompatible_change
--[no]incompatible_use_platforms_repo_for_constraints
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ระบบจะนำการตั้งค่าข้อจำกัดจาก @bazel_tools ออก
แท็ก:affects_outputs
,incompatible_change
--[no]instrument_test_targets
ค่าเริ่มต้น: "false"-
เมื่อเปิดใช้ Coverage จะระบุว่าจะพิจารณากฎการทดสอบที่ใช้เครื่องมือหรือไม่ เมื่อตั้งค่าไว้ ระบบจะใช้เครื่องมือกับกฎการทดสอบที่รวมไว้โดย --instrumentation_filter มิฉะนั้น ระบบจะไม่รวมกฎการทดสอบไว้ในการวัดความครอบคลุมเสมอ
แท็กaffects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
default: "-/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_application ผลลัพธ์คือไบนารีแบบสากลที่มีสถาปัตยกรรมที่ระบุทั้งหมด
แท็ก:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
ค่าเริ่มต้น: "จริง"-
เลิกใช้งานแล้ว ถูกแทนที่ด้วย --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
--[no]objc_debug_with_GLIBCXX
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้และตั้งค่าโหมดการคอมไพล์เป็น "dbg" ให้กำหนด GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC และ GLIBCPP_CONCEPT_CHECKS
แท็กaction_command_lines
--[no]objc_enable_binary_stripping
ค่าเริ่มต้น: "false"-
ระบุว่าจะลบสัญลักษณ์และโค้ดที่ไม่ได้ใช้ในไบนารีที่ลิงก์หรือไม่ ระบบจะทำการลบไบนารีออกหากมีการระบุทั้งแฟล็กนี้และ --compilation_mode=opt
แท็กaction_command_lines
--objccopt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ Objective-C/C++
แท็กaction_command_lines
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง gcc อย่างเลือกสรรเมื่อคอมไพล์ไฟล์บางไฟล์ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter หมายถึงรายการรูปแบบนิพจน์ทั่วไปที่รวมและยกเว้น (ดู --instrumentation_filter ด้วย) ส่วน option_1 ถึง option_n หมายถึงตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีคอมมา คุณต้องใส่เครื่องหมายคำพูดพร้อมแบ็กสแลช ตัวเลือกมี @ ได้ แต่จะใช้ @ ตัวแรกเท่านั้นในการแยกสตริง ตัวอย่าง: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 จะเพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ลงในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
,affects_outputs
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมในการส่งไปยังแบ็กเอนด์ LTO แบบเลือก (ในส่วน --features=thin_lto) เมื่อคอมไพล์ออบเจ็กต์แบ็กเอนด์บางรายการ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดย regex_filter หมายถึงรายการรูปแบบนิพจน์ทั่วไปที่รวมและยกเว้น ส่วน option_1 ถึง option_n หมายถึงตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีคอมมา คุณต้องใส่เครื่องหมายคำพูดพร้อมแบ็กสแลช ตัวเลือกมี @ ได้ แต่จะใช้ @ ตัวแรกเท่านั้นในการแยกสตริง ตัวอย่าง: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 จะเพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ลงในบรรทัดคำสั่งของ LTO Backend ของไฟล์.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 เพื่อเพิ่มประสิทธิภาพเป้าหมายการบิลด์ โปรไฟล์ Propeller ต้องประกอบด้วยไฟล์อย่างน้อย 1 ใน 2 ไฟล์ ได้แก่ โปรไฟล์ cc และโปรไฟล์ ld แฟล็กนี้ยอมรับป้ายกำกับการสร้างซึ่งต้องอ้างอิงไฟล์อินพุตโปรไฟล์ Propeller เช่น ไฟล์ BUILD ที่กำหนดป้ายกำกับใน a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",) อาจต้องเพิ่มคำสั่ง exports_files ลงในแพ็กเกจที่เกี่ยวข้องเพื่อให้ Bazel มองเห็นไฟล์เหล่านี้ ต้องใช้ตัวเลือกในรูปแบบ --propeller_optimize=//a/b:propeller_profile
แท็ก:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
ชื่อเส้นทางสัมบูรณ์ของไฟล์ cc_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพสำหรับ Propeller
แท็กaffects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
ชื่อเส้นทางแบบสัมบูรณ์ของไฟล์ ld_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพของ Propeller
แท็ก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
-
หากเป็นจริง ระบบจะแชร์ไลบรารีเนทีฟที่มีฟังก์ชันการทำงานเหมือนกันในกลุ่มเป้าหมายต่างๆ
แท็ก:loading_and_analysis
,affects_outputs
--[no]stamp
ค่าเริ่มต้น: "false"-
ประทับเวลาไบนารีด้วยวันที่ ชื่อผู้ใช้ ชื่อโฮสต์ ข้อมูลพื้นที่ทำงาน ฯลฯ
แท็ก:affects_outputs
--strip=<always, sometimes or never>
ค่าเริ่มต้น: "บางครั้ง"-
ระบุว่าจะลบไบนารีและไลบรารีที่ใช้ร่วมกันหรือไม่ (ใช้ "-Wl,--strip-debug") ค่าเริ่มต้นของ "sometimes" หมายถึงการลบออกก็ต่อเมื่อ --compilation_mode=fastbuild
แท็กaffects_outputs
--stripopt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง strip เมื่อสร้างไบนารี "<name>.stripped"
แท็ก:action_command_lines
,affects_outputs
--swiftcopt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยังการคอมไพล์ Swift
แท็กaction_command_lines
--tvos_cpus=<comma-separated list of options>
มีการสะสมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาเพื่อสร้างไบนารี Apple tvOS
แท็ก:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
ค่าเริ่มต้น: ดูคำอธิบาย-
เวอร์ชัน tvOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองและอุปกรณ์เป้าหมาย หากไม่ได้ระบุ ให้ใช้ "tvos_sdk_version"
แท็กloses_incremental_state
--visionos_cpus=<comma-separated list of options>
มีการสะสมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาซึ่งจะใช้สร้างไบนารีของ Apple visionOS
แท็ก:loses_incremental_state
,loading_and_analysis
--watchos_cpus=<comma-separated list of options>
มีการสะสมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาซึ่งจะใช้สร้างไบนารีของ Apple watchOS
แท็ก:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
ค่าเริ่มต้น: ดูคำอธิบาย-
เวอร์ชัน watchOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองและอุปกรณ์เป้าหมาย หากไม่ได้ระบุ ให้ใช้ "watchos_sdk_version"
แท็กloses_incremental_state
--xbinary_fdo=<a build target label>
ค่าเริ่มต้น: ดูคำอธิบาย-
ใช้ข้อมูลโปรไฟล์ XbinaryFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อของโปรไฟล์ไบนารีข้ามเริ่มต้น เมื่อใช้ตัวเลือกนี้ร่วมกับ --fdo_instrument/--fdo_optimize/--fdo_profile ตัวเลือกเหล่านั้นจะมีผลเสมอราวกับว่าไม่ได้ระบุ xbinary_fdo
แท็ก:affects_outputs
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้ข้อมูลอินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าสถานะ ฯลฯ)
--auto_cpu_environment_group=<a build target label>
ค่าเริ่มต้น: ""-
ประกาศ environment_group ที่จะใช้ในการแมปค่า CPU กับค่า target_environment โดยอัตโนมัติ
แท็กchanges_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
ค่าเริ่มต้น: "false"-
ตรวจสอบว่าข้อจำกัดด้านการอนุญาตให้ใช้สิทธิที่กำหนดโดยแพ็กเกจที่ขึ้นต่อกันไม่ขัดแย้งกับโหมดการจัดจำหน่ายของเป้าหมายที่กำลังสร้าง โดยค่าเริ่มต้น ระบบจะไม่ตรวจสอบใบอนุญาต
แท็กbuild_file_semantics
--[no]check_visibility
ค่าเริ่มต้น: "จริง"-
หากปิดใช้ ข้อผิดพลาดด้านการมองเห็นในทรัพยากรที่ขึ้นต่อกันของเป้าหมายจะลดระดับเป็นคำเตือน
แท็กbuild_file_semantics
--[no]desugar_for_android
ค่าเริ่มต้น: "จริง"-
จะยกเลิกการเพิ่มน้ำตาลในไบต์โค้ด Java 8 ก่อนที่จะแปลงเป็น DEX หรือไม่
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
ค่าเริ่มต้น: "false"-
เลือกว่าจะรวมไลบรารี Java 8 ที่รองรับไว้ในแอปสำหรับอุปกรณ์รุ่นเดิมหรือไม่
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
ค่าเริ่มต้น: "จริง"-
ตรวจสอบสภาพแวดล้อมที่แต่ละเป้าหมายใช้งานร่วมกันได้ และรายงานข้อผิดพลาดหากเป้าหมายใดมีทรัพยากร Dependency ที่ไม่รองรับสภาพแวดล้อมเดียวกัน
แท็ก:build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs
ค่าเริ่มต้น: "false"-
Flag to help transition from allowing to disallowing srcs-less android_library rules with deps. เราต้องล้างข้อมูลในคลังเพื่อเปิดตัวฟีเจอร์นี้โดยค่าเริ่มต้น
แท็ก:eagerness_to_exit
,loading_and_analysis
--[no]experimental_check_desugar_deps
ค่าเริ่มต้น: "จริง"-
เลือกว่าจะตรวจสอบซ้ำว่าการยกเลิกการเพิ่มน้ำตาลถูกต้องที่ระดับไบนารีของ Android หรือไม่
แท็กeagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<off, warning or error>
ค่าเริ่มต้น: "ปิด"-
เมื่อเปิดใช้ ให้ตรวจสอบว่าการอ้างอิงของ aar_import เสร็จสมบูรณ์หรือไม่ การบังคับใช้นี้อาจทำให้บิลด์ใช้งานไม่ได้ หรืออาจส่งผลให้เกิดคำเตือนเท่านั้น
แท็กloading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
ค่าเริ่มต้น: "default"-
หากเป็นจริง จะตรวจสอบว่าเป้าหมาย Java ประกาศเป้าหมายทั้งหมดที่ใช้โดยตรงเป็นทรัพยากร Dependency อย่างชัดเจน
แท็ก:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
ค่าเริ่มต้น: "false"-
หากเปิดใช้ ให้ตรวจสอบ testonly สำหรับเป้าหมายที่ต้องมีก่อนซึ่งเป็นไฟล์เอาต์พุตโดยค้นหา testonly ของกฎการสร้าง ซึ่งตรงกับการตรวจสอบระดับการเข้าถึง
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
ค่าเริ่มต้น: "false"-
หากเปิดใช้ ระบบจะปิดใช้การใช้กฎ Android ดั้งเดิมโดยตรง โปรดใช้กฎ Starlark Android จาก https://github.com/bazelbuild/rules_android
แท็กeagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
ค่าเริ่มต้น: "false"-
ไม่มีการดำเนินการ เก็บไว้ที่นี่เพื่อให้เข้ากันได้แบบย้อนหลัง
แท็ก:eagerness_to_exit
,incompatible_change
--[no]incompatible_force_strict_header_check_from_starlark
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ให้ตั้งค่าการตรวจสอบส่วนหัวอย่างเข้มงวดใน Starlark API
แท็กloading_and_analysis
,changes_inputs
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง Bazel จะตรวจสอบการรวมส่วนหัวของไดเรกทอรีระดับบนสุดด้วย (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/10047)
แท็ก:loading_and_analysis
,incompatible_change
--[no]strict_filesets
ค่าเริ่มต้น: "false"-
หากเปิดใช้ตัวเลือกนี้ ระบบจะรายงานชุดไฟล์ที่ข้ามขอบเขตแพ็กเกจเป็นข้อผิดพลาด โดยจะใช้ไม่ได้เมื่อปิดใช้ check_fileset_dependencies_recursively
แท็ก:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
ค่าเริ่มต้น: "error"-
หากไม่ได้ปิดไว้ จะตรวจสอบว่าเป้าหมาย proto_library ประกาศเป้าหมายทั้งหมดที่ใช้โดยตรงเป็นทรัพยากร Dependency อย่างชัดเจน
แท็กbuild_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
ค่าเริ่มต้น: "ปิด"-
หากไม่ได้ปิดไว้ จะตรวจสอบว่าเป้าหมาย proto_library ประกาศเป้าหมายทั้งหมดที่ใช้ใน "import public" อย่างชัดเจนว่าส่งออกแล้ว
แท็กbuild_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
ค่าเริ่มต้น: "false"-
หากเป็นจริง คุณต้องประกาศส่วนหัวที่พบผ่านเส้นทางรวมของระบบ (-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
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าไว้และโหมดการคอมไพล์ไม่ใช่ "opt" แอป objc จะมีสิทธิ์ในการแก้ไขข้อบกพร่องเมื่อลงนาม
แท็กchanges_inputs
--ios_signing_cert_name=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
ชื่อใบรับรองที่จะใช้สำหรับการลงนามใน iOS หากไม่ได้ตั้งค่าไว้ ระบบจะกลับไปใช้โปรไฟล์การจัดสรร อาจเป็นค่ากำหนดข้อมูลประจำตัวในพวงกุญแจของใบรับรองหรือ (สตริงย่อย) ของชื่อจริงของใบรับรอง ตามหน้า Man ของ codesign (ข้อมูลประจำตัวในการลงนาม)
แท็ก:action_command_lines
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ในไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE:
--[no]incompatible_disallow_legacy_py_provider
ค่าเริ่มต้น: "จริง"-
ไม่มีการดำเนินการใดๆ และจะนำออกในเร็วๆ นี้
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่ควบคุมลักษณะการทำงานของสภาพแวดล้อมในการทดสอบหรือเครื่องมือเรียกใช้การทดสอบ
--[no]allow_analysis_failures
ค่าเริ่มต้น: "false"-
หากเป็นจริง การวิเคราะห์เป้าหมายของกฎล้มเหลวจะทำให้เป้าหมายเผยแพร่อินสแตนซ์ของ AnalysisFailureInfo ที่มีคำอธิบายข้อผิดพลาด แทนที่จะทำให้การสร้างล้มเหลว
แท็ก:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
ค่าเริ่มต้น: "2000"-
กำหนดจำนวนการอ้างอิงแบบทรานซิทีฟสูงสุดผ่านแอตทริบิวต์กฎที่มีการเปลี่ยนการกำหนดค่า for_analysis_testing การใช้งานเกินขีดจำกัดนี้จะทำให้เกิดข้อผิดพลาดของกฎ
แท็กloading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
ค่าเริ่มต้น: "false"-
หากเป็นจริง การดำเนินการ dex2oat ที่ล้มเหลวจะทำให้บิลด์หยุดทำงานแทนที่จะเรียกใช้ dex2oat ในระหว่างรันไทม์ของการทดสอบ
แท็ก:loading_and_analysis
,experimental
--[no]experimental_android_use_parallel_dex2oat
ค่าเริ่มต้น: "false"-
ใช้ dex2oat แบบขนานเพื่อเร่งความเร็ว android_test
แท็กloading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
ค่าเริ่มต้น: "false"-
เปิดใช้การตรวจสอบหน่วยความจำรั่วในเป้าหมาย 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 โดย runs_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" เท่านั้น
แท็กtest_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
ค่าเริ่มต้น: "-1"- ลบล้างค่าการหมดเวลาทดสอบเริ่มต้นสำหรับการหมดเวลาทดสอบ (เป็นวินาที) หากระบุค่าจำนวนเต็มบวกค่าเดียว ค่าดังกล่าวจะลบล้างหมวดหมู่ทั้งหมด หากระบุจำนวนเต็ม 4 รายการที่คั่นด้วยคอมมา ระบบจะลบล้างการหมดเวลาสำหรับระยะเวลาสั้น ปานกลาง ยาว และไม่มีกำหนด (ตามลำดับ) ไม่ว่าจะอยู่ในรูปแบบใด ค่า -1 จะบอกให้ Blaze ใช้การหมดเวลาเริ่มต้นสำหรับหมวดหมู่นั้น
--tvos_simulator_device=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
อุปกรณ์ที่จะจำลองเมื่อเรียกใช้แอปพลิเคชัน tvOS ในโปรแกรมจำลอง เช่น "Apple TV 1080p" คุณดูรายการอุปกรณ์ได้โดยเรียกใช้ "xcrun simctl list devicetypes" ในเครื่องที่จะเรียกใช้โปรแกรมจำลอง
แท็กtest_runner
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
ค่าเริ่มต้น: ดูคำอธิบาย-
เวอร์ชันของ tvOS ที่จะเรียกใช้ในโปรแกรมจำลองเมื่อเรียกใช้หรือทดสอบ
แท็กtest_runner
--watchos_simulator_device=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
อุปกรณ์ที่จะจำลองเมื่อเรียกใช้แอปพลิเคชัน watchOS ในโปรแกรมจำลอง เช่น "Apple Watch - 38 มม." คุณดูรายการอุปกรณ์ได้โดยเรียกใช้ "xcrun simctl list devicetypes" ในเครื่องที่จะเรียกใช้โปรแกรมจำลอง
แท็กtest_runner
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
ค่าเริ่มต้น: ดูคำอธิบาย-
เวอร์ชันของ watchOS ที่จะเรียกใช้ในเครื่องจำลองเมื่อเรียกใช้หรือทดสอบ
แท็กtest_runner
--[no]zip_undeclared_test_outputs
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ระบบจะเก็บเอาต์พุตการทดสอบที่ไม่ได้ประกาศไว้ในไฟล์ ZIP
แท็ก:test_runner
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและการตีความหมายของการค้นหา
--aspect_deps=<off, conservative or precise>
ค่าเริ่มต้น: "ระมัดระวัง"-
วิธีแก้ไขการขึ้นต่อกันของแง่มุมเมื่อรูปแบบเอาต์พุตเป็นหนึ่งใน {xml,proto,record} "off" หมายความว่าจะไม่มีการแก้ไขการขึ้นต่อกันของแง่มุม "conservative" (ค่าเริ่มต้น) หมายความว่าจะมีการเพิ่มการขึ้นต่อกันของแง่มุมที่ประกาศทั้งหมดไม่ว่าจะมีคลาสกฎของการขึ้นต่อกันโดยตรงหรือไม่ก็ตาม "precise" หมายความว่าจะมีการเพิ่มเฉพาะแง่มุมที่อาจใช้งานได้เมื่อพิจารณาจากคลาสกฎของการขึ้นต่อกันโดยตรง โปรดทราบว่าโหมดที่แม่นยำต้องโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียว จึงทำให้ช้ากว่าโหมดอื่นๆ โปรดทราบว่าแม้ในโหมดที่แม่นยำก็ยังไม่แม่นยำโดยสมบูรณ์ เนื่องจากระบบจะตัดสินใจว่าจะคำนวณแง่มุมใดในระยะการวิเคราะห์ ซึ่งไม่ได้ทำงานระหว่าง "bazel query"
แท็กbuild_file_semantics
--[no]consistent_labels
ค่าเริ่มต้น: "false"-
หากเปิดใช้ คำสั่งการค้นหาทุกคำสั่งจะปล่อยป้ายกำกับออกมาเหมือนกับฟังก์ชัน <code>str</code> ของ Starlark ที่ใช้กับอินสแตนซ์ <code>Label</code> ซึ่งจะเป็นประโยชน์สำหรับเครื่องมือที่ต้องจับคู่เอาต์พุตของคำสั่งการค้นหาและ/หรือป้ายกำกับต่างๆ ที่กฎปล่อยออกมา หากไม่ได้เปิดใช้ ตัวจัดรูปแบบเอาต์พุตจะสามารถปล่อยชื่อที่เก็บที่ชัดเจน (เทียบกับที่เก็บหลัก) แทนเพื่อให้เอาต์พุตอ่านง่ายขึ้น
แท็กterminal_output
--[no]deduplicate_depsets
ค่าเริ่มต้น: "จริง"-
ลบรายการที่ซ้ำกันขององค์ประกอบย่อยที่ไม่ใช่ใบของ dep_set_of_files ในเอาต์พุต proto/textproto/json สุดท้าย การดำเนินการนี้จะไม่ขจัดชุดทรัพยากรที่ซ้ำกันซึ่งไม่มีองค์ประกอบระดับบนสุดร่วมกัน ซึ่งจะไม่ส่งผลต่อรายการอาร์ติแฟกต์อินพุตที่มีผลสุดท้ายของการดำเนินการ
แท็กterminal_output
--[no]graph:factored
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ระบบจะส่งกราฟที่ "แยกตัวประกอบ" กล่าวคือ ระบบจะผสานโหนดที่เทียบเท่ากันในเชิงโทโพโลยีเข้าด้วยกันและต่อป้ายกำกับของโหนดเหล่านั้น ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็กterminal_output
--graph:node_limit=<an integer>
ค่าเริ่มต้น: "512"-
ความยาวสูงสุดของสตริงป้ายกำกับสำหรับโหนดกราฟในเอาต์พุต ระบบจะตัดป้ายกำกับที่ยาวเกินไป โดย -1 หมายถึงไม่มีการตัด ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็กterminal_output
--[no]implicit_deps
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ระบบจะรวมทรัพยากร Dependency โดยนัยไว้ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน การขึ้นต่อกันโดยนัยคือการขึ้นต่อกันที่ไม่ได้ระบุอย่างชัดเจนในไฟล์ BUILD แต่ Bazel เพิ่มให้ สำหรับ cquery ตัวเลือกนี้จะควบคุมการกรอง Toolchain ที่แก้ไขแล้ว
แท็กbuild_file_semantics
--[no]include_artifacts
ค่าเริ่มต้น: "จริง"-
รวมชื่อของอินพุตและเอาต์พุตของการดำเนินการในเอาต์พุต (อาจมีขนาดใหญ่)
แท็กterminal_output
--[no]include_aspects
ค่าเริ่มต้น: "จริง"-
aquery, cquery: whether to include aspect-generated actions in the output. query: no-op (aspects are always followed).
แท็กterminal_output
--[no]include_commandline
ค่าเริ่มต้น: "จริง"-
รวมเนื้อหาของบรรทัดคำสั่งการดำเนินการในเอาต์พุต (อาจมีขนาดใหญ่)
แท็กterminal_output
--[no]include_file_write_contents
ค่าเริ่มต้น: "false"-
รวมเนื้อหาของไฟล์สำหรับการดำเนินการ FileWrite และ SourceSymlinkManifest (อาจมีขนาดใหญ่)
แท็กterminal_output
--[no]include_param_files
ค่าเริ่มต้น: "false"-
รวมเนื้อหาของไฟล์พารามิเตอร์ที่ใช้ในคำสั่ง (อาจมีขนาดใหญ่) หมายเหตุ: การเปิดใช้ฟีเจอร์นี้จะเปิดใช้แฟล็ก --include_commandline โดยอัตโนมัติ
แท็กterminal_output
--[no]incompatible_display_source_file_location
ค่าเริ่มต้น: "จริง"-
ค่าเริ่มต้นเป็น "จริง" ซึ่งจะแสดงเป้าหมายของไฟล์ต้นฉบับ หากจริง จะแสดงตำแหน่งของบรรทัดที่ 1 ของไฟล์แหล่งที่มาในเอาต์พุตตำแหน่ง โดยแฟล็กนี้มีไว้เพื่อวัตถุประสงค์ในการย้ายข้อมูลเท่านั้น
แท็ก:terminal_output
,incompatible_change
--[no]incompatible_package_group_includes_double_slash
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ เมื่อส่งออกแอตทริบิวต์ `packages` ของ package_group ระบบจะไม่ละเว้น `//` ที่นำหน้า
แท็ก:terminal_output
,incompatible_change
--[no]infer_universe_scope
ค่าเริ่มต้น: "false"-
หากตั้งค่าและไม่ได้ตั้งค่า --universe_scope ระบบจะอนุมานค่าของ --universe_scope เป็นรายการรูปแบบเป้าหมายที่ไม่ซ้ำกันในนิพจน์การค้นหา โปรดทราบว่าค่า --universe_scope ที่อนุมานสำหรับนิพจน์การค้นหาที่ใช้ฟังก์ชันระดับจักรวาล (เช่น `allrdeps`) อาจไม่ใช่สิ่งที่คุณต้องการ ดังนั้นคุณควรใช้ตัวเลือกนี้เฉพาะในกรณีที่คุณทราบว่ากำลังทำอะไรอยู่ ดูรายละเอียดและตัวอย่างได้ที่ https://bazel.build/reference/query#sky-query หากตั้งค่า --universe_scope ระบบจะไม่สนใจค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้ใช้ได้กับ `query` เท่านั้น (ไม่ใช่ `cquery`)
แท็ก:loading_and_analysis
--[no]line_terminator_null
ค่าเริ่มต้น: "false"-
ไม่ว่าจะสิ้นสุดแต่ละรูปแบบด้วย \0 แทนการขึ้นบรรทัดใหม่
แท็กterminal_output
--[no]nodep_deps
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ระบบจะรวมการอ้างอิงจากแอตทริบิวต์ "nodep" ไว้ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ตัวอย่างทั่วไปของแอตทริบิวต์ "nodep" คือ "visibility" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ `info build-language` เพื่อดูข้อมูลเกี่ยวกับแอตทริบิวต์ "nodep" ทั้งหมดในภาษาบิลด์
แท็กbuild_file_semantics
--output=<a string>
ค่าเริ่มต้น: "ข้อความ"-
รูปแบบที่ควรพิมพ์ผลลัพธ์ของ aquery ค่าที่อนุญาตสำหรับ aquery คือ text, textproto, proto, jsonproto
แท็กterminal_output
--[no]proto:default_values
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ระบบจะรวมแอตทริบิวต์ที่ไม่ได้ระบุค่าอย่างชัดเจนในไฟล์ BUILD ไว้ด้วย มิฉะนั้นจะละเว้น ตัวเลือกนี้ใช้ได้กับ --output=proto
แท็ก:terminal_output
--[no]proto:definition_stack
ค่าเริ่มต้น: "false"-
ป้อนข้อมูลฟิลด์ Proto ของ definition_stack ซึ่งจะบันทึกสแต็กการเรียก Starlark สำหรับอินสแตนซ์ของกฎแต่ละรายการ ณ เวลาที่กำหนดคลาสของกฎ
แท็กterminal_output
--[no]proto:flatten_selects
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ระบบจะทำให้แอตทริบิวต์ที่กำหนดค่าได้ซึ่งสร้างโดย select() แบนราบ สำหรับประเภทรายการ การแสดงแบบ Flatten คือรายการที่มีค่าของแผนที่ที่เลือกแต่ละค่าเพียงครั้งเดียว ระบบจะทำให้ประเภทสเกลาร์แบนเป็นค่าว่าง
แท็กbuild_file_semantics
--[no]proto:include_synthetic_attribute_hash
ค่าเริ่มต้น: "false"-
จะคำนวณและสร้างแอตทริบิวต์ $internal_attr_hash หรือไม่
แท็กterminal_output
--[no]proto:instantiation_stack
ค่าเริ่มต้น: "false"-
สร้างสแต็กการเรียกอินสแตนซ์ของแต่ละกฎ โปรดทราบว่าต้องมีสแต็กจึงจะดำเนินการนี้ได้
แท็กterminal_output
--[no]proto:locations
ค่าเริ่มต้น: "จริง"-
จะแสดงข้อมูลตำแหน่งในเอาต์พุต Proto หรือไม่
แท็กterminal_output
--proto:output_rule_attrs=<comma-separated list of options>
ค่าเริ่มต้น: "all"-
รายการแอตทริบิวต์ที่คั่นด้วยคอมมาที่จะรวมไว้ในเอาต์พุต ค่าเริ่มต้นคือแอตทริบิวต์ทั้งหมด ตั้งค่าเป็นสตริงว่างเปล่าเพื่อไม่ให้แสดงแอตทริบิวต์ใดๆ ตัวเลือกนี้ใช้ได้กับ --output=proto
แท็กterminal_output
--[no]proto:rule_inputs_and_outputs
ค่าเริ่มต้น: "จริง"-
จะป้อนข้อมูลในช่อง rule_input และ rule_output หรือไม่
แท็กterminal_output
--query_file=<a string>
ค่าเริ่มต้น: ""-
หากตั้งค่าไว้ การค้นหาจะอ่านการค้นหาจากไฟล์ที่ตั้งชื่อไว้ที่นี่ แทนที่จะอ่านจากบรรทัดคำสั่ง การระบุไฟล์ที่นี่รวมถึงการค้นหาในบรรทัดคำสั่งถือเป็นข้อผิดพลาด
แท็กchanges_inputs
--[no]relative_locations
ค่าเริ่มต้น: "false"-
หากเป็นจริง ตำแหน่งของไฟล์ BUILD ในเอาต์พุต XML และ Proto จะเป็นแบบสัมพัทธ์ โดยค่าเริ่มต้น เอาต์พุตตำแหน่งจะเป็นเส้นทางที่สมบูรณ์และจะไม่สอดคล้องกันในเครื่องต่างๆ คุณสามารถตั้งค่าตัวเลือกนี้เป็น "จริง" เพื่อให้ได้ผลลัพธ์ที่สอดคล้องกันในเครื่องต่างๆ
แท็กterminal_output
--[no]skyframe_state
ค่าเริ่มต้น: "false"-
โดยไม่ต้องทำการวิเคราะห์เพิ่มเติม ให้ทิ้ง Action Graph ปัจจุบันจาก Skyframe หมายเหตุ: ปัจจุบันยังไม่รองรับการระบุเป้าหมายด้วย --skyframe_state โดยแฟล็กนี้ใช้ได้กับ --output=proto หรือ --output=textproto เท่านั้น
แท็กterminal_output
--[no]tool_deps
ค่าเริ่มต้น: "จริง"-
คำค้นหา: หากปิดใช้ ระบบจะไม่รวมการอ้างอิงเป้าหมาย "การกำหนดค่าโฮสต์" หรือ "การดำเนินการ" ไว้ในกราฟการอ้างอิงที่คำค้นหาดำเนินการ ขอบเขตการพึ่งพา "การกำหนดค่าโฮสต์" เช่น ขอบเขตจากกฎ "proto_library" ไปยังคอมไพเลอร์โปรโตคอล มักจะชี้ไปยังเครื่องมือที่ดำเนินการในระหว่างการบิลด์แทนที่จะเป็นส่วนหนึ่งของโปรแกรม "เป้าหมาย" เดียวกัน
Cquery: หากปิดใช้ ระบบจะกรองเป้าหมายที่กำหนดค่าทั้งหมดซึ่งข้ามโฮสต์หรือการเปลี่ยนการดำเนินการจากเป้าหมายระดับบนสุดที่ค้นพบเป้าหมายที่กำหนดค่านี้ ซึ่งหมายความว่าหากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าเป้าหมาย ระบบจะแสดงเฉพาะเป้าหมายที่กำหนดค่าซึ่งอยู่ในกำหนดค่าเป้าหมายด้วย หากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าโฮสต์ ระบบจะแสดงเฉพาะเป้าหมายที่กำหนดค่าโฮสต์ ตัวเลือกนี้จะไม่ยกเว้น Toolchain ที่แก้ไขแล้ว
แท็กbuild_file_semantics
--universe_scope=<comma-separated list of options>
ค่าเริ่มต้น: ""-
ชุดรูปแบบเป้าหมายที่คั่นด้วยคอมมา (การบวกและการลบ) ระบบอาจดำเนินการค้นหาในจักรวาลที่กำหนดโดยการปิดทรานซิทีฟของเป้าหมายที่ระบุ ตัวเลือกนี้ใช้สำหรับคำสั่งการค้นหาและ cquery
สำหรับ cquery อินพุตของตัวเลือกนี้คือเป้าหมายที่สร้างคำตอบทั้งหมดภายใต้ตัวเลือกนี้ ดังนั้นตัวเลือกนี้อาจส่งผลต่อการกำหนดค่าและการเปลี่ยน หากไม่ได้ระบุตัวเลือกนี้ ระบบจะถือว่าเป้าหมายระดับบนสุดคือเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหา หมายเหตุ: สำหรับ cquery การไม่ระบุตัวเลือกนี้อาจทำให้บิลด์หยุดทำงานหากเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหาไม่สามารถสร้างได้ด้วยตัวเลือกในระดับบนสุด
แท็ก:loading_and_analysis
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพเวลาบิลด์
--[no]collapse_duplicate_defines
ค่าเริ่มต้น: "false"-
เมื่อเปิดใช้ ระบบจะนำ --defines ที่ซ้ำกันออกตั้งแต่เนิ่นๆ ในการสร้าง ซึ่งจะช่วยหลีกเลี่ยงการสูญเสียแคชการวิเคราะห์ที่ไม่จำเป็นสำหรับการสร้างที่เทียบเท่าบางประเภท
แท็ก:loading_and_analysis
,loses_incremental_state
--[no]experimental_filter_library_jar_with_program_jar
ค่าเริ่มต้น: "false"-
กรอง ProGuard ProgramJar เพื่อนำคลาสที่อยู่ใน LibraryJar ออก
แท็กaction_command_lines
--[no]experimental_inmemory_dotd_files
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ระบบจะส่งไฟล์ .d ของ C++ ผ่านหน่วยความจำโดยตรงจากโหนดการสร้างระยะไกลแทนที่จะเขียนลงในดิสก์
แท็กloading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ระบบจะส่งไฟล์การอ้างอิง (.jdeps) ที่สร้างจากการคอมไพล์ Java ผ่านหน่วยความจำโดยตรงจากโหนดการสร้างระยะไกลแทนที่จะเขียนลงในดิสก์
แท็กloading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_objc_include_scanning
ค่าเริ่มต้น: "false"-
ว่าจะทำการสแกนรวมสำหรับ Objective C/C++ หรือไม่
แท็กloading_and_analysis
,execution
,changes_inputs
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
ค่าเริ่มต้น: "false"-
หากเปิดใช้ ฟีเจอร์ parse_headers จะไม่สร้างการดำเนินการคอมไพล์ส่วนหัวแยกต่างหากหากพบแหล่งที่มาที่มีชื่อฐานเดียวกันในเป้าหมายเดียวกัน
แท็ก:loading_and_analysis
,affects_outputs
--[no]experimental_retain_test_configuration_across_testonly
ค่าเริ่มต้น: "false"-
เมื่อเปิดใช้ --trim_test_configuration จะไม่ตัดการกำหนดค่าการทดสอบสำหรับกฎที่ทำเครื่องหมาย testonly=1 ซึ่งมีจุดประสงค์เพื่อลดปัญหาความขัดแย้งในการดำเนินการเมื่อกฎที่ไม่ใช่การทดสอบขึ้นอยู่กับกฎ cc_test จะไม่มีผลหาก --trim_test_configuration เป็นเท็จ
แท็ก:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
ค่าเริ่มต้น: "false"-
หากเปิดใช้ คุณจะใช้ cc_import เวอร์ชัน Starlark ได้
แท็ก:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
ค่าเริ่มต้น: "false"-
จะจำกัดอินพุตให้เหลือเฉพาะการคอมไพล์ C/C++ โดยการแยกวิเคราะห์บรรทัด #include จากไฟล์อินพุตหรือไม่ ซึ่งจะช่วยปรับปรุงประสิทธิภาพและส่วนเพิ่มได้ด้วยการลดขนาดของทรีอินพุตการคอมไพล์ อย่างไรก็ตาม การดำเนินการนี้อาจทำให้บิลด์หยุดทำงานได้เนื่องจากเครื่องมือสแกนการรวมไม่ได้ใช้ความหมายของตัวประมวลผล C ล่วงหน้าอย่างเต็มรูปแบบ โดยเฉพาะอย่างยิ่ง เครื่องมือนี้ไม่เข้าใจคำสั่ง #include แบบไดนามิกและไม่สนใจตรรกะแบบมีเงื่อนไขของตัวประมวลผลล่วงหน้า คุณต้องรับความเสี่ยงของการใช้งานเอง เราจะปิดปัญหาที่เกี่ยวข้องกับการแจ้งว่าไม่เหมาะสมนี้ทั้งหมด
แท็กloading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
ค่าเริ่มต้น: "จริง"-
ทำงานส่วนใหญ่ในการแยก dex สำหรับไฟล์ Jar แต่ละไฟล์
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าไว้ ระบบจะใช้ไฟล์ .d ที่ clang ปล่อยออกมาเพื่อตัดชุดอินพุตที่ส่งไปยังการคอมไพล์ objc
แท็ก:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
ค่าเริ่มต้น: "false"-
เมื่อสร้างเป้าหมาย //a:a ให้ประมวลผลส่วนหัวในเป้าหมายทั้งหมดที่ //a:a ขึ้นอยู่กับ (หากเปิดใช้การประมวลผลส่วนหัวสำหรับเครื่องมือแล้ว)
แท็กexecution
--[no]trim_test_configuration
ค่าเริ่มต้น: "จริง"-
เมื่อเปิดใช้ ตัวเลือกที่เกี่ยวข้องกับการทดสอบจะถูกล้างใต้ระดับบนสุดของบิลด์ เมื่อเปิดใช้ฟีเจอร์นี้ คุณจะสร้างการทดสอบเป็นทรัพยากร Dependency ของกฎที่ไม่ใช่การทดสอบไม่ได้ แต่การเปลี่ยนแปลงตัวเลือกที่เกี่ยวข้องกับการทดสอบจะไม่ทำให้ระบบวิเคราะห์กฎที่ไม่ใช่การทดสอบอีกครั้ง
แท็ก:loading_and_analysis
,loses_incremental_state
--[no]use_singlejar_apkbuilder
ค่าเริ่มต้น: "จริง"-
ตัวเลือกนี้เลิกใช้งานแล้ว ตอนนี้ไม่มีการดำเนินการใดๆ และจะถูกนำออกในเร็วๆ นี้
แท็ก:loading_and_analysis
- ตัวเลือกที่มีผลต่อความละเอียด รูปแบบ หรือตำแหน่งของการบันทึก:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
ค่าเริ่มต้น: "-.*"-
พิมพ์ข้อมูลการแก้ไขข้อบกพร่องระหว่างการแก้ปัญหา Toolchain โดยแฟล็กจะใช้นิพจน์ทั่วไป ซึ่งจะตรวจสอบกับประเภท Toolchain และเป้าหมายที่เฉพาะเจาะจงเพื่อดูว่าควรแก้ไขข้อบกพร่องของรายการใด คุณคั่นนิพจน์ทั่วไปหลายรายการด้วยคอมมาได้ จากนั้นระบบจะตรวจสอบนิพจน์ทั่วไปแต่ละรายการแยกกัน หมายเหตุ: เอาต์พุตของฟีเจอร์นี้มีความซับซ้อนมากและอาจมีประโยชน์เฉพาะผู้เชี่ยวชาญด้านการแก้ปัญหา Toolchain เท่านั้น
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
--flag_alias=<a 'name=value' flag alias>
มีการสะสมการใช้งานหลายครั้ง-
ตั้งชื่อย่อสำหรับแฟล็ก Starlark โดยจะรับคู่คีย์-ค่าเดียวในรูปแบบ "<key>=<value>" เป็นอาร์กิวเมนต์
แท็กchanges_inputs
--[no]incompatible_default_to_explicit_init_py
ค่าเริ่มต้น: "false"-
แฟล็กนี้จะเปลี่ยนลักษณะการทำงานเริ่มต้นเพื่อให้ระบบไม่สร้างไฟล์ __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
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง เป้าหมายที่สร้างในการกำหนดค่า Python 2 จะปรากฏภายใต้รูทเอาต์พุตที่มีคำต่อท้าย "-py2" ในขณะที่เป้าหมายที่สร้างสำหรับ Python 3 จะปรากฏในรูทที่ไม่มีคำต่อท้ายที่เกี่ยวข้องกับ Python ซึ่งหมายความว่า Symlink ที่สะดวก `bazel-bin` จะชี้ไปยังเป้าหมาย Python 3 แทนที่จะเป็น Python 2 หากเปิดใช้ตัวเลือกนี้ เราขอแนะนำให้เปิดใช้ `--incompatible_py3_is_default` ด้วย
แท็ก:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง เป้าหมาย `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
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็น "จริง" กฎ Python ดั้งเดิมที่เรียกใช้งานได้จะใช้รันไทม์ Python ที่ระบุโดยชุดเครื่องมือ Python แทนรันไทม์ที่ระบุโดยแฟล็กเดิม เช่น --python_top
แท็ก:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
ค่าเริ่มต้น: ดูคำอธิบาย-
โหมดเวอร์ชันหลักของ Python ซึ่งอาจเป็น `PY2` หรือ `PY3` โปรดทราบว่าเป้าหมาย `py_binary` และ `py_test` จะลบล้างค่านี้ (แม้ว่าจะไม่ได้ระบุเวอร์ชันอย่างชัดเจน) ดังนั้นจึงมักไม่มีเหตุผลมากนักที่จะระบุแฟล็กนี้
แท็ก:loading_and_analysis
,affects_outputs
,explicit_in_output_path
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้:
--[no]cache_test_results
[-t
] default: "auto"- หากตั้งค่าเป็น "auto" Bazel จะเรียกใช้การทดสอบอีกครั้งก็ต่อเมื่อ (1) Bazel ตรวจพบการเปลี่ยนแปลงในการทดสอบหรือการขึ้นต่อกัน (2) มีการทำเครื่องหมายการทดสอบเป็นภายนอก (3) มีการขอเรียกใช้การทดสอบหลายครั้งด้วย --runs_per_test หรือ(4) การทดสอบล้มเหลวก่อนหน้านี้ หากตั้งค่าเป็น "ใช่" Bazel จะแคชผลการทดสอบทั้งหมด ยกเว้นการทดสอบที่ทำเครื่องหมายเป็นภายนอก หากตั้งค่าเป็น "no" Bazel จะไม่แคชผลการทดสอบใดๆ
--[no]experimental_cancel_concurrent_tests
ค่าเริ่มต้น: "false"-
หากเป็นจริง Blaze จะยกเลิกการทดสอบที่ทำงานพร้อมกันในการทดสอบที่สำเร็จครั้งแรก ซึ่งจะมีประโยชน์เมื่อใช้ร่วมกับ --runs_per_test_detects_flakes เท่านั้น
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะดึงข้อมูลไดเรกทอรีข้อมูลความครอบคลุมทั้งหมดสําหรับการทดสอบแต่ละครั้งในระหว่างการเรียกใช้ความครอบคลุม
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
ค่าเริ่มต้น: "false"-
หากเป็นจริง ความครอบคลุมสำหรับ Clang จะสร้างรายงาน LCOV
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
ค่าเริ่มต้น: "จริง"- จะสร้างส่วนหัว J2ObjC แบบขนานกับการแปลง J2ObjC หรือไม่
--[no]experimental_j2objc_shorter_header_path
ค่าเริ่มต้น: "false"-
เลือกว่าจะสร้างเส้นทางส่วนหัวที่สั้นกว่าหรือไม่ (ใช้ "_ios" แทน "_j2objc")
แท็กaffects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
ค่าเริ่มต้น: "javabuilder"- เปิดใช้ classpath ที่ลดลงสำหรับการคอมไพล์ Java
--[no]experimental_limit_android_lint_to_android_constrained_java
ค่าเริ่มต้น: "false"-
จำกัด --experimental_run_android_lint_on_java_rules ให้ใช้กับไลบรารีที่เข้ากันได้กับ Android
แท็กaffects_outputs
--[no]experimental_run_android_lint_on_java_rules
ค่าเริ่มต้น: "false"-
จะตรวจสอบแหล่งที่มาของ java_* หรือไม่
แท็กaffects_outputs
--[no]explicit_java_test_deps
ค่าเริ่มต้น: "false"- ระบุการขึ้นต่อ JUnit หรือ Hamcrest อย่างชัดเจนใน java_test แทนที่จะรับจาก deps ของ TestRunner โดยไม่ตั้งใจ ขณะนี้ใช้ได้กับ Bazel เท่านั้น
--host_java_launcher=<a build target label>
ค่าเริ่มต้น: ดูคำอธิบาย- ตัวเรียกใช้ Java ที่เครื่องมือใช้ซึ่งจะดำเนินการในระหว่างการสร้าง
--host_javacopt=<a string>
มีการสะสมการใช้งานหลายครั้ง- ตัวเลือกเพิ่มเติมที่จะส่งไปยัง javac เมื่อสร้างเครื่องมือที่เรียกใช้ระหว่างบิลด์
--host_jvmopt=<a string>
มีการสะสมการใช้งานหลายครั้ง- ตัวเลือกเพิ่มเติมที่จะส่งไปยัง Java VM เมื่อสร้างเครื่องมือที่ดำเนินการระหว่างการสร้าง ระบบจะเพิ่มตัวเลือกเหล่านี้ลงในตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
--[no]incompatible_check_sharding_support
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะทำให้การทดสอบที่แยกส่วนล้มเหลวหากโปรแกรมเรียกใช้การทดสอบไม่ได้ระบุว่ารองรับการแยกส่วนโดยการแตะไฟล์ที่เส้นทางใน TEST_SHARD_STATUS_FILE หากเป็นเท็จ โปรแกรมเรียกใช้การทดสอบที่ไม่รองรับการแบ่งพาร์ติชันจะทำให้การทดสอบทั้งหมดทำงานในแต่ละพาร์ติชัน
แท็กincompatible_change
--[no]incompatible_exclusive_test_sandboxed
ค่าเริ่มต้น: "false"-
หากเป็นจริง การทดสอบแบบเฉพาะจะทํางานร่วมกับกลยุทธ์แซนด์บ็อกซ์ เพิ่มแท็ก "local" เพื่อบังคับให้เรียกใช้การทดสอบแบบเฉพาะในเครื่อง
แท็ก:incompatible_change
--[no]incompatible_strict_action_env
ค่าเริ่มต้น: "false"-
หากเป็นจริง 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) ก่อนเริ่มการทดสอบ Implies -test_output=streamed.
ขยายเป็น
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
ค่าเริ่มต้น: "จริง"- สร้างข้อมูลการขึ้นต่อกัน (ตอนนี้คือ classpath เวลาคอมไพล์) ต่อเป้าหมาย Java
--[no]java_header_compilation
ค่าเริ่มต้น: "จริง"- คอมไพล์ ijar จากแหล่งที่มาโดยตรง
--java_language_version=<a string>
ค่าเริ่มต้น: "8"- เวอร์ชันภาษา Java
--java_launcher=<a build target label>
ค่าเริ่มต้น: ดูคำอธิบาย- ตัวเรียกใช้ Java ที่จะใช้เมื่อสร้างไบนารี Java หากตั้งค่าแฟล็กนี้เป็นสตริงว่างเปล่า ระบบจะใช้ตัวเรียกใช้ JDK แอตทริบิวต์ "launcher" จะลบล้างค่าสถานะนี้
--java_runtime_version=<a string>
ค่าเริ่มต้น: "local_jdk"- เวอร์ชันรันไทม์ของ Java
--javacopt=<a string>
มีการสะสมการใช้งานหลายครั้ง- ตัวเลือกเพิ่มเติมที่จะส่งไปยัง javac
--jvmopt=<a string>
มีการสะสมการใช้งานหลายครั้ง- ตัวเลือกเพิ่มเติมที่จะส่งไปยัง Java VM ระบบจะเพิ่มตัวเลือกเหล่านี้ลงในตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
--legacy_main_dex_list_generator=<a build target label>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไบนารีที่จะใช้เพื่อสร้างรายการคลาสที่ต้องอยู่ใน dex หลักเมื่อคอมไพล์ multidex เดิม
--plugin=<a build target label>
มีการสะสมการใช้งานหลายครั้ง- ปลั๊กอินที่จะใช้ในการสร้าง ปัจจุบันใช้ได้กับ java_plugin
--proguard_top=<a build target label>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุเวอร์ชันของ ProGuard ที่จะใช้ในการนำโค้ดออกเมื่อสร้างไบนารี Java
--proto_compiler=<a build target label>
default: "@bazel_tools//tools/proto:protoc"-
ป้ายกำกับของโปรโตคอมไพเลอร์
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
default: "@bazel_tools//tools/proto:cc_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์โปรโตคอล C++
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์โปรโตคอล j2objc
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
default: "@bazel_tools//tools/proto:java_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ Proto ของ Java
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
default: "@bazel_tools//tools/proto:javalite_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์โปรโตคอล JavaLite
แท็ก:affects_outputs
,loading_and_analysis
--protocopt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยังคอมไพเลอร์ Protobuf
แท็กaffects_outputs
--[no]runs_per_test_detects_flakes
ค่าเริ่มต้น: "false"- หากเป็นจริง ชาร์ดใดก็ตามที่มีการทดสอบ/ความพยายามอย่างน้อย 1 รายการที่ผ่านและมีการทดสอบ/ความพยายามอย่างน้อย 1 รายการที่ไม่ผ่านจะได้รับสถานะไม่น่าเชื่อถือ
--shell_executable=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
เส้นทางแบบสัมบูรณ์ไปยังไฟล์ปฏิบัติการของเชลล์เพื่อให้ Bazel ใช้ หากไม่ได้ตั้งค่านี้ แต่ตั้งค่าตัวแปรสภาพแวดล้อม BAZEL_SH ในการเรียกใช้ Bazel ครั้งแรก (ซึ่งจะเริ่มเซิร์ฟเวอร์ Bazel) Bazel จะใช้ตัวแปรนั้น หากไม่ได้ตั้งค่าทั้ง 2 อย่าง Bazel จะใช้เส้นทางเริ่มต้นที่ฮาร์ดโค้ดไว้โดยขึ้นอยู่กับระบบปฏิบัติการที่ทำงาน (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, ระบบอื่นๆ ทั้งหมด: /bin/bash) โปรดทราบว่าการใช้เชลล์ที่ไม่รองรับ bash อาจทำให้การสร้างล้มเหลวหรือไบนารีที่สร้างขึ้นทำงานล้มเหลว
แท็กloading_and_analysis
--test_arg=<a string>
มีการสะสมการใช้งานหลายครั้ง- ระบุตัวเลือกและอาร์กิวเมนต์เพิ่มเติมที่ควรส่งไปยังไฟล์ปฏิบัติการทดสอบ ใช้ได้หลายครั้งเพื่อระบุอาร์กิวเมนต์หลายรายการ หากมีการเรียกใช้การทดสอบหลายรายการ การทดสอบแต่ละรายการจะได้รับอาร์กิวเมนต์ที่เหมือนกัน ใช้โดยคำสั่ง "bazel test" เท่านั้น
--test_filter=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุตัวกรองที่จะส่งต่อให้กับเฟรมเวิร์กการทดสอบ ใช้เพื่อจำกัดการทดสอบที่เรียกใช้ โปรดทราบว่าการดำเนินการนี้ไม่มีผลต่อเป้าหมายที่จะสร้าง
--test_result_expiration=<an integer>
ค่าเริ่มต้น: "-1"- ตัวเลือกนี้เลิกใช้งานแล้วและไม่มีผล
--[no]test_runner_fail_fast
ค่าเริ่มต้น: "false"- ส่งต่อตัวเลือก "ล้มเหลวอย่างรวดเร็ว" ไปยังโปรแกรมเรียกใช้การทดสอบ โปรแกรมเรียกใช้การทดสอบควรหยุดการดำเนินการเมื่อเกิดข้อผิดพลาดครั้งแรก
--test_sharding_strategy=<explicit or disabled>
ค่าเริ่มต้น: "explicit"- ระบุกลยุทธ์สำหรับการแบ่งการทดสอบ: "explicit" เพื่อใช้การแบ่งก็ต่อเมื่อมีแอตทริบิวต์ BUILD "shard_count" "disabled" เพื่อไม่ให้ใช้การแบ่งพาร์ติชันการทดสอบ
--tool_java_language_version=<a string>
ค่าเริ่มต้น: "8"- เวอร์ชันภาษา Java ที่ใช้ในการเรียกใช้เครื่องมือที่จำเป็นในระหว่างการสร้าง
--tool_java_runtime_version=<a string>
ค่าเริ่มต้น: "remotejdk_11"- เวอร์ชันรันไทม์ของ Java ที่ใช้ในการเรียกใช้เครื่องมือระหว่างการสร้าง
--[no]use_ijars
ค่าเริ่มต้น: "จริง"- หากเปิดใช้ ตัวเลือกนี้จะทำให้การคอมไพล์ Java ใช้ JAR ของอินเทอร์เฟซ ซึ่งจะทําให้การคอมไพล์ที่เพิ่มขึ้นเร็วขึ้น แต่ข้อความแสดงข้อผิดพลาดอาจแตกต่างกัน
ตัวเลือกการสร้าง
- ตัวเลือกที่ปรากฏก่อนคำสั่งและไคลเอ็นต์แยกวิเคราะห์
--distdir=<a path>
มีการสะสมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาไฟล์เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บจะลิงก์แบบฮาร์ดลิงก์ไฟล์ในกรณีที่แคชตรงกันแทนที่จะคัดลอก ซึ่งมีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL เปลี่ยนแปลงและส่งผลให้มีการดาวน์โหลดซ้ำแม้ว่าแคชจะมีรายการที่ดาวน์โหลดซึ่งมีแฮชเดียวกันก็ตาม ซึ่งใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL ไม่ได้ทำให้ที่เก็บข้อมูลเสียหายซึ่งถูกแคชซ่อนไว้
แท็ก:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ จะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็กexperimental
--experimental_repository_downloader_retries=<an integer>
ค่าเริ่มต้น: "0"-
จำนวนครั้งสูงสุดที่พยายามลองดาวน์โหลดซ้ำเมื่อเกิดข้อผิดพลาด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็กexperimental
--experimental_scale_timeouts=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับขนาดการหมดเวลาทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ ด้วยวิธีนี้ คุณจึงทำให้ที่เก็บข้อมูลภายนอกทำงานในเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็กbazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับการหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลดผ่าน http ตามปัจจัยที่ระบุ
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้มาในระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
--[no]check_up_to_date
ค่าเริ่มต้น: "false"-
ไม่ต้องสร้าง เพียงตรวจสอบว่าเวอร์ชันล่าสุดหรือไม่ หากเป้าหมายทั้งหมดเป็นข้อมูลล่าสุด การสร้างจะเสร็จสมบูรณ์ หากต้องดำเนินการขั้นตอนใดก็ตาม ระบบจะรายงานข้อผิดพลาดและบิลด์จะล้มเหลว
แท็กexecution
--dynamic_local_execution_delay=<an integer>
ค่าเริ่มต้น: "1000"-
ควรหน่วงเวลาการดำเนินการในเครื่องกี่มิลลิวินาที หากการดำเนินการจากระยะไกลเร็วกว่าในระหว่างการสร้างอย่างน้อย 1 ครั้ง
แท็ก:execution
,host_machine_resource_optimizations
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment>
มีการสะสมการใช้งานหลายครั้ง-
กลยุทธ์ในเครื่องตามลำดับที่จะใช้สำหรับมnemonic ที่ระบุ การส่ง "local" เป็นนิโมนิกจะตั้งค่าเริ่มต้นสำหรับนิโมนิกที่ไม่ได้ระบุ ใช้ [mnemonic=]local_strategy[,local_strategy,...]
แท็ก:execution
,host_machine_resource_optimizations
--dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment>
มีการสะสมการใช้งานหลายครั้ง-
กลยุทธ์ระยะไกลที่จะใช้สำหรับ Mnemonic ที่ระบุ การส่ง "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
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ จะแทรก uid และ gid ของผู้ใช้ปัจจุบันลงในอิมเมจ Docker ก่อนที่จะใช้อิมเมจ คุณต้องระบุตัวเลือกนี้หากบิลด์ / การทดสอบของคุณขึ้นอยู่กับผู้ใช้ที่มีชื่อและไดเรกทอรีหน้าแรกภายในคอนเทนเนอร์ ฟีเจอร์นี้จะเปิดอยู่โดยค่าเริ่มต้น แต่คุณปิดได้ในกรณีที่ฟีเจอร์การปรับแต่งรูปภาพอัตโนมัติใช้งานไม่ได้ หรือคุณทราบว่าไม่จำเป็นต้องใช้
แท็กexecution
--[no]experimental_dynamic_exclude_tools
ค่าเริ่มต้น: "จริง"-
เมื่อตั้งค่าแล้ว เป้าหมายที่สร้าง "สำหรับเครื่องมือ" จะไม่อยู่ภายใต้การดำเนินการแบบไดนามิก เป้าหมายดังกล่าวไม่น่าจะสร้างขึ้นได้ทีละน้อย จึงไม่คุ้มค่าที่จะใช้รอบการทำงานในเครื่อง
แท็ก: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
ค่าเริ่มต้น: "false"-
เปิดใช้แซนด์บ็อกซ์ที่ใช้ Docker ตัวเลือกนี้จะไม่มีผลหากไม่ได้ติดตั้ง Docker
แท็กexecution
--experimental_persistent_javac
-
เปิดใช้คอมไพเลอร์ Java แบบถาวรเวอร์ชันทดลอง
ขยายเป็น:
--strategy=Javac=worker
--strategy=JavaIjar=local
--strategy=JavaDeployJar=local
--strategy=JavaSourceJar=local
--strategy=Turbine=local
แท็ก:execution
,host_machine_resource_optimizations
--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">
ค่าเริ่มต้น: "0"-
หากเป็น 0 ให้ลบโครงสร้างแซนด์บ็อกซ์ทันทีที่การดำเนินการเสร็จสมบูรณ์ (ทำให้การดำเนินการเสร็จสมบูรณ์ล่าช้า) หากมากกว่า 0 ให้ดำเนินการลบสามรายการดังกล่าวในพูลเธรดแบบอะซิงโครนัสที่มีขนาด 1 เมื่อบิลด์ทำงาน และเพิ่มขนาดตามที่ระบุโดยแฟล็กนี้เมื่อเซิร์ฟเวอร์ไม่ได้ใช้งาน
แท็ก:host_machine_resource_optimizations
,execution
--experimental_sandboxfs_path=<a string>
ค่าเริ่มต้น: "sandboxfs"-
เส้นทางไปยังไบนารี sandboxfs ที่จะใช้เมื่อ --experimental_use_sandboxfs เป็นจริง หากเป็นชื่อที่ไม่มีการระบุพาธ ให้ใช้ไบนารีแรกของชื่อนั้นที่พบใน PATH
แท็ก:host_machine_resource_optimizations
,execution
--[no]experimental_split_xml_generation
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าสถานะนี้และมีการดำเนินการทดสอบที่ไม่สร้างไฟล์ test.xml แล้ว Bazel จะใช้การดำเนินการแยกต่างหากเพื่อสร้างไฟล์ test.xml จำลองที่มีบันทึกการทดสอบ มิฉะนั้น Bazel จะสร้าง test.xml เป็นส่วนหนึ่งของการดำเนินการทดสอบ
แท็กexecution
--experimental_total_worker_memory_limit_mb=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.>
ค่าเริ่มต้น: "0"-
หากขีดจำกัดนี้มากกว่า 0 ระบบอาจหยุดการทำงานของผู้ปฏิบัติงานที่ไม่ได้ใช้งานหากการใช้หน่วยความจำทั้งหมดของผู้ปฏิบัติงานทั้งหมดเกินขีดจำกัด
แท็ก:execution
,host_machine_resource_optimizations
--[no]experimental_use_hermetic_linux_sandbox
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" อย่าติดตั้งรูท ให้ติดตั้งเฉพาะสิ่งที่ระบุด้วย sandbox_add_mount_pair ระบบจะลิงก์ไฟล์อินพุตแบบฮาร์ดลิงก์ไปยังแซนด์บ็อกซ์แทนที่จะลิงก์สัญลักษณ์จากแซนด์บ็อกซ์ หากไฟล์อินพุตของการดำเนินการอยู่ในระบบไฟล์ที่แตกต่างจากแซนด์บ็อกซ์ ระบบจะคัดลอกไฟล์อินพุตแทน
แท็กexecution
--[no]experimental_use_sandboxfs
ค่าเริ่มต้น: "false"-
ใช้ sandboxfs เพื่อสร้างไดเรกทอรี execroot ของการดำเนินการแทนการสร้างทรีของลิงก์สัญลักษณ์ หากตอบว่า "ใช่" ไบนารีที่ระบุโดย --experimental_sandboxfs_path ต้องถูกต้องและสอดคล้องกับ sandboxfs เวอร์ชันที่รองรับ หากเป็น "auto" แสดงว่าไบนารีอาจขาดหายไปหรือไม่รองรับ
แท็ก:host_machine_resource_optimizations
,execution
--[no]experimental_use_windows_sandbox
ค่าเริ่มต้น: "false"- ใช้ Windows Sandbox เพื่อเรียกใช้การดำเนินการ หากตอบว่า "ใช่" ไบนารีที่ระบุโดย --experimental_windows_sandbox_path ต้องถูกต้องและสอดคล้องกับ sandboxfs เวอร์ชันที่รองรับ หากเป็น "auto" แสดงว่าไบนารีอาจขาดหายไปหรือไม่รองรับ
--experimental_windows_sandbox_path=<a string>
ค่าเริ่มต้น: "BazelSandbox.exe"- เส้นทางไปยังไบนารีของ Windows Sandbox ที่จะใช้เมื่อ --experimental_use_windows_sandbox เป็นจริง หากเป็นชื่อที่ไม่มีการระบุพาธ ให้ใช้ไบนารีแรกของชื่อนั้นที่พบใน PATH
--[no]experimental_worker_as_resource
ค่าเริ่มต้น: "false"-
หากเปิดใช้ ระบบจะจัดหา Worker เป็นทรัพยากรจาก ResourceManager
แท็ก:execution
,host_machine_resource_optimizations
--[no]experimental_worker_cancellation
ค่าเริ่มต้น: "false"-
หากเปิดใช้ Bazel อาจส่งคำขอยกเลิกไปยัง Worker ที่รองรับ
แท็กexecution
--[no]experimental_worker_multiplex
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ พนักงานที่รองรับฟีเจอร์การมัลติเพล็กซ์เวอร์ชันทดลองจะใช้ฟีเจอร์ดังกล่าว
แท็ก:execution
,host_machine_resource_optimizations
--[no]experimental_worker_multiplex_sandboxing
ค่าเริ่มต้น: "false"-
หากเปิดใช้ ระบบจะแซนด์บ็อกซ์ Worker แบบมัลติเพล็กซ์โดยใช้ไดเรกทอรีแซนด์บ็อกซ์แยกต่างหากต่อคำของาน 1 รายการ เฉพาะ Worker ที่มีข้อกำหนดในการดำเนินการ "supports-multiplex-sandboxing" เท่านั้นที่จะได้รับการแซนด์บ็อกซ์
แท็กexecution
--[no]experimental_worker_strict_flagfiles
ค่าเริ่มต้น: "false"-
หากเปิดใช้ อาร์กิวเมนต์การดำเนินการสำหรับ Worker ที่ไม่เป็นไปตามข้อกำหนดของ Worker จะทำให้เกิดข้อผิดพลาด อาร์กิวเมนต์ของ Worker ต้องมีอาร์กิวเมนต์ @flagfile เพียงรายการเดียวเป็นอาร์กิวเมนต์สุดท้ายในรายการอาร์กิวเมนต์
แท็กexecution
--genrule_strategy=<comma-separated list of options>
ค่าเริ่มต้น: ""-
ระบุวิธีเรียกใช้ genrules เราจะเลิกใช้ธงนี้ ให้ใช้ --spawn_strategy=<value> เพื่อควบคุมการดำเนินการทั้งหมด หรือ --strategy=Genrule=<value> เพื่อควบคุม genrule เท่านั้น
แท็กexecution
--high_priority_workers=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ชื่อย่อของผู้ปฏิบัติงานที่จะเรียกใช้ด้วยลำดับความสำคัญสูง เมื่อผู้ปฏิบัติงานที่มีลำดับความสำคัญสูงกำลังทำงาน ระบบจะจำกัดอัตราของผู้ปฏิบัติงานอื่นๆ ทั้งหมด
แท็กexecution
--[no]incompatible_remote_dangling_symlinks
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็นจริงและ --incompatible_remote_symlinks เป็นจริงด้วย ระบบจะอนุญาตให้ซิมลิงก์ในเอาต์พุตของการดำเนินการค้างอยู่
แท็ก:execution
,incompatible_change
--[no]incompatible_remote_symlinks
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็น "จริง" Bazel จะแสดงลิงก์สัญลักษณ์ในเอาต์พุตการดำเนินการในโปรโตคอลการแคช/การดำเนินการระยะไกลตามนั้น ไม่เช่นนั้น ระบบจะติดตามลิงก์สัญลักษณ์และแสดงเป็นไฟล์หรือไดเรกทอรี ดูรายละเอียดได้ที่ #6631
แท็ก:execution
,incompatible_change
--[no]incompatible_sandbox_hermetic_tmp
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" แซนด์บ็อกซ์ Linux แต่ละรายการจะมีไดเรกทอรีว่างเฉพาะของตัวเองซึ่งติดตั้งเป็น /tmp แทนการแชร์ /tmp กับระบบไฟล์ของโฮสต์ ใช้ --sandbox_add_mount_pair=/tmp เพื่อให้เห็น /tmp ของโฮสต์ในแซนด์บ็อกซ์ทั้งหมดต่อไป
แท็กexecution
--[no]internal_spawn_scheduler
ค่าเริ่มต้น: "false"-
ตัวเลือกตัวยึดตำแหน่งเพื่อให้เราบอกได้ใน 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
] default: "auto"-
จำนวนงานที่เกิดขึ้นพร้อมกันที่จะเรียกใช้ รับจำนวนเต็มหรือคีย์เวิร์ด ("auto", "HOST_CPUS", "HOST_RAM") ตามด้วยการดำเนินการ ([-|*]<float>) เช่น "auto", "HOST_CPUS*.5" ค่าต้องอยู่ระหว่าง 1 ถึง 5000 ค่าที่สูงกว่า 2500 อาจทำให้เกิดปัญหาเกี่ยวกับหน่วยความจำ "auto" จะคำนวณค่าเริ่มต้นที่เหมาะสมตามทรัพยากรของโฮสต์
แท็ก:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] ค่าเริ่มต้น: "false"-
ดำเนินการต่อให้ได้มากที่สุดหลังจากเกิดข้อผิดพลาด แม้ว่าจะวิเคราะห์เป้าหมายที่ล้มเหลวและเป้าหมายที่ขึ้นอยู่กับเป้าหมายนั้นไม่ได้ แต่ก็วิเคราะห์ข้อกำหนดเบื้องต้นอื่นๆ ของเป้าหมายเหล่านี้ได้
แท็ก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">
ค่าเริ่มต้น: "auto"-
จำนวนเธรดแบบขนานที่จะใช้ในระยะการโหลด/วิเคราะห์ รับค่าจำนวนเต็มหรือคีย์เวิร์ด ("auto", "HOST_CPUS", "HOST_RAM") ตามด้วยการดำเนินการ ([-|*]<float>) เช่น "auto", "HOST_CPUS*.5" "auto" จะตั้งค่าเริ่มต้นที่เหมาะสมตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็กbazel_internal_configuration
--[no]reuse_sandbox_directories
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็นจริง ระบบอาจนำไดเรกทอรีที่ใช้โดยการดำเนินการแบบแซนด์บ็อกซ์ที่ไม่ใช่ Worker กลับมาใช้ใหม่เพื่อหลีกเลี่ยงค่าใช้จ่ายในการตั้งค่าที่ไม่จำเป็น
แท็ก:host_machine_resource_optimizations
,execution
--sandbox_base=<a string>
ค่าเริ่มต้น: ""-
อนุญาตให้แซนด์บ็อกซ์สร้างไดเรกทอรีแซนด์บ็อกซ์ของตัวเองภายใต้เส้นทางนี้ ระบุเส้นทางใน tmpfs (เช่น /run/shm) เพื่ออาจปรับปรุงประสิทธิภาพได้มากเมื่อการสร้าง / การทดสอบมีไฟล์อินพุตจำนวนมาก หมายเหตุ: คุณต้องมี RAM และพื้นที่ว่างใน tmpfs เพียงพอที่จะจัดเก็บเอาต์พุตและไฟล์ชั่วคราวที่สร้างขึ้นจากการเรียกใช้การดำเนินการ
แท็ก:host_machine_resource_optimizations
,execution
--[no]sandbox_explicit_pseudoterminal
ค่าเริ่มต้น: "false"-
เปิดใช้การสร้างเทอร์มินัลเสมือนอย่างชัดเจนสำหรับการดำเนินการในแซนด์บ็อกซ์ การกระจาย Linux บางรายการกำหนดให้ตั้งค่ารหัสกลุ่มของกระบวนการเป็น "tty" ภายในแซนด์บ็อกซ์เพื่อให้เทอร์มินัลเสมือนทำงานได้ หากทำให้เกิดปัญหา คุณสามารถปิดใช้ฟีเจอร์นี้เพื่อเปิดใช้กลุ่มอื่นๆ ได้
แท็กexecution
--sandbox_tmpfs_path=<an absolute path>
มีการสะสมการใช้งานหลายครั้ง-
สำหรับการดำเนินการในแซนด์บ็อกซ์ ให้ติดตั้งไดเรกทอรีที่ว่างเปล่าและเขียนได้ที่เส้นทางแบบสัมบูรณ์นี้ (หากการติดตั้งแซนด์บ็อกซ์รองรับ มิเช่นนั้นจะถูกละเว้น)
แท็ก:host_machine_resource_optimizations
,execution
--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 หากใช้กับ Genrule แบบช่วยจำ) ดูรายละเอียดได้ที่ https://blog.bazel.build/2019/06/19/list-strategy.html
แท็กexecution
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
มีการสะสมการใช้งานหลายครั้ง-
ลบล้างกลยุทธ์การเกิดที่ควรใช้เพื่อดำเนินการกับการเกิดที่มีคำอธิบายตรงกับ regex_filter ที่เฉพาะเจาะจง ดูรายละเอียดเกี่ยวกับการจับคู่ 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 โดยมีคีย์เป็นมνηนิค (เช่น --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">
มีการสะสมการใช้งานหลายครั้ง-
หากใช้กลยุทธ์ "worker" จะเปิดตัวอินสแตนซ์ของกระบวนการ Worker (เช่น คอมไพเลอร์ Java แบบถาวร) ได้กี่อินสแตนซ์ อาจระบุเป็น [name=value] เพื่อให้ค่าที่แตกต่างกันต่อตัวช่วยจำของ Worker รับจำนวนเต็มหรือคีย์เวิร์ด ("auto", "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" กับ --experimental_worker_multiplex อาจระบุเป็น [name=value] เพื่อให้ค่าที่แตกต่างกันต่อตัวช่วยจำของ Worker รับจำนวนเต็มหรือคีย์เวิร์ด ("auto", "HOST_CPUS", "HOST_RAM") ตามด้วยการดำเนินการ ([-|*]<float>) เช่น "auto", "HOST_CPUS*.5" "auto" จะคำนวณค่าเริ่มต้นที่เหมาะสมตามความจุของเครื่อง "=value" จะตั้งค่าเริ่มต้นสำหรับตัวช่วยจำที่ไม่ได้ระบุ
แท็ก:execution
,host_machine_resource_optimizations
--[no]worker_quit_after_build
ค่าเริ่มต้น: "false"-
หากเปิดใช้ ผู้ปฏิบัติงานทั้งหมดจะหยุดทำงานหลังจากสร้างเสร็จ
แท็ก:execution
,host_machine_resource_optimizations
--[no]worker_sandboxing
ค่าเริ่มต้น: "false"-
หากเปิดใช้ ระบบจะเรียกใช้ Worker ในสภาพแวดล้อมแบบแซนด์บ็อกซ์
แท็กexecution
--[no]worker_verbose
ค่าเริ่มต้น: "false"- หากเปิดใช้แล้ว จะพิมพ์ข้อความแบบละเอียดเมื่อเริ่ม หยุดทำงานของ Worker ฯลฯ
- ตัวเลือกที่กำหนดค่า Toolchain ที่ใช้สำหรับการดำเนินการ:
--[no]incompatible_disable_runtimes_filegroups
ค่าเริ่มต้น: "false"-
เลิกใช้งานแล้ว ไม่มีการดำเนินการใดๆ
แท็ก:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
--[no]incompatible_dont_emit_static_libgcc
ค่าเริ่มต้น: "จริง"-
เลิกใช้งานแล้ว ไม่มีการดำเนินการใดๆ
แท็ก:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
--[no]incompatible_linkopts_in_user_link_flags
ค่าเริ่มต้น: "จริง"-
เลิกใช้งาน no-op แล้ว
แท็กaction_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่ง
--[no]build
ค่าเริ่มต้น: "จริง"-
เรียกใช้บิลด์ ซึ่งเป็นลักษณะการทำงานปกติ การระบุ --nobuild จะทำให้การสร้างหยุดก่อนที่จะดำเนินการสร้างการดำเนินการ โดยจะคืนค่าเป็น 0 หากโหลดแพ็กเกจและวิเคราะห์เฟสเสร็จสมบูรณ์ โหมดนี้มีประโยชน์สำหรับการทดสอบเฟสเหล่านั้น
แท็ก:execution
,affects_outputs
--[no]experimental_run_validations
ค่าเริ่มต้น: "จริง"-
โปรดใช้ --run_validations แทน
แท็ก:execution
,affects_outputs
--[no]experimental_use_validation_aspect
ค่าเริ่มต้น: "false"-
ว่าจะเรียกใช้การดำเนินการตรวจสอบโดยใช้แง่มุม (เพื่อความขนานกับการทดสอบ) หรือไม่
แท็ก: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
ค่าเริ่มต้น: "จริง"-
ว่าจะเรียกใช้การดำเนินการตรวจสอบเป็นส่วนหนึ่งของการสร้างหรือไม่ ดู https://bazel.build/rules/rules#validation_actions
แท็กexecution
,affects_outputs
- ตัวเลือกที่ช่วยให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการ ซึ่งจะส่งผลต่อค่าของเอาต์พุตนั้น ไม่ใช่การมีอยู่ของเอาต์พุต
--aspects=<comma-separated list of options>
มีการสะสมการใช้งานหลายครั้ง- รายการแง่มุมที่คั่นด้วยคอมมาที่จะใช้กับเป้าหมายระดับบนสุด ในรายการ หากแอตทริบิวต์ some_aspect ระบุผู้ให้บริการแอตทริบิวต์ที่จำเป็นผ่าน required_aspect_providers แอตทริบิวต์ some_aspect จะทํางานหลังจากแอตทริบิวต์ทุกรายการที่กล่าวถึงก่อนหน้านี้ในรายการแอตทริบิวต์ ซึ่งผู้ให้บริการที่โฆษณาเป็นไปตามผู้ให้บริการแอตทริบิวต์ที่จำเป็นของ some_aspect นอกจากนี้ some_aspect จะทํางานหลังจากแง่มุมที่จําเป็นทั้งหมดที่ระบุโดยแอตทริบิวต์ requires จากนั้น some_aspect จะมีสิทธิ์เข้าถึงค่าของผู้ให้บริการแง่มุมเหล่านั้น <bzl-file-label>%<aspect_name> เช่น '//tools:my_def.bzl%my_aspect' โดยที่ 'my_aspect' เป็นค่าระดับบนสุดจากไฟล์ tools/my_def.bzl
--bep_maximum_open_remote_upload_files=<an integer>
ค่าเริ่มต้น: "-1"-
จำนวนไฟล์ที่เปิดสูงสุดที่อนุญาตในระหว่างการอัปโหลดอาร์ติแฟกต์ BEP
แท็กaffects_outputs
--[no]experimental_convenience_symlinks
ค่าเริ่มต้น: "normal"-
ฟีเจอร์นี้ควบคุมวิธีจัดการลิงก์สัญลักษณ์ที่สะดวก (ลิงก์สัญลักษณ์ที่ปรากฏในพื้นที่ทำงานหลังจากการสร้าง) ค่าที่ใช้ได้
normal (ค่าเริ่มต้น): ระบบจะสร้างหรือลบลิงก์สัญลักษณ์ที่สะดวกแต่ละประเภทตามที่การสร้างกำหนด
clean: ระบบจะลบลิงก์สัญลักษณ์ทั้งหมดโดยไม่มีเงื่อนไข
ignore: ระบบจะไม่เปลี่ยนแปลง Symlink
log_only: สร้างข้อความบันทึกราวกับว่ามีการส่ง "normal" แต่ไม่ได้ดำเนินการใดๆ ในระบบไฟล์จริง (มีประโยชน์สำหรับเครื่องมือ)
โปรดทราบว่าเฉพาะ Symlink ที่ชื่อสร้างขึ้นจากค่าปัจจุบันของ --symlink_prefix เท่านั้นที่จะได้รับผลกระทบ หากคำนำหน้ามีการเปลี่ยนแปลง ระบบจะไม่แตะต้อง Symlink ที่มีอยู่ก่อนแล้ว
แท็กaffects_outputs
--[no]experimental_convenience_symlinks_bep_event
ค่าเริ่มต้น: "false"-
แฟล็กนี้จะควบคุมว่าเราจะโพสต์เหตุการณ์บิวด์ ConvenienceSymlinksIdentified ไปยัง BuildEventProtocol หรือไม่ หากค่าเป็นจริง BuildEventProtocol จะมีรายการสำหรับ convenienceSymlinksIdentified ซึ่งแสดงรายการลิงก์สัญลักษณ์ที่สะดวกทั้งหมดที่สร้างขึ้นในพื้นที่ทำงาน หากเป็นเท็จ รายการ convenienceSymlinksIdentified ใน BuildEventProtocol จะว่างเปล่า
แท็กaffects_outputs
--experimental_multi_cpu=<comma-separated list of options>
มีการสะสมการใช้งานหลายครั้ง-
เลิกใช้งานแล้ว ไม่มีการดำเนินการ
แท็กaffects_outputs
,experimental
--remote_download_minimal
-
ไม่ดาวน์โหลดเอาต์พุตการสร้างระยะไกลไปยังเครื่องในระบบ Flag นี้เป็นทางลัดสำหรับ Flag: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata และ --remote_download_outputs=minimal
ขยายเป็น
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
แท็กaffects_outputs
--remote_download_outputs=<all, minimal or toplevel>
ค่าเริ่มต้น: "all"-
หากตั้งค่าเป็น "น้อยที่สุด" จะไม่ดาวน์โหลดเอาต์พุตการสร้างจากระยะไกลไปยังเครื่องในพื้นที่ ยกเว้นเอาต์พุตที่การกระทำในพื้นที่กำหนด หากตั้งค่าเป็น "toplevel" จะทํางานเหมือน "minimal" ยกเว้นว่าจะดาวน์โหลดเอาต์พุตของเป้าหมายระดับบนสุดไปยังเครื่องในเครื่องด้วย ทั้ง 2 ตัวเลือกช่วยลดเวลาในการสร้างได้อย่างมากหากแบนด์วิดท์เครือข่ายเป็นคอขวด
แท็กaffects_outputs
--remote_download_symlink_template=<a string>
ค่าเริ่มต้น: ""-
สร้างลิงก์สัญลักษณ์แทนการดาวน์โหลดเอาต์พุตบิลด์ระยะไกลไปยังเครื่องภายใน คุณระบุเป้าหมายของลิงก์สัญลักษณ์ได้ในรูปแบบของสตริงเทมเพลต สตริงเทมเพลตนี้อาจมี {hash} และ {size_bytes} ซึ่งจะขยายเป็นแฮชของออบเจ็กต์และขนาดในหน่วยไบต์ตามลำดับ ตัวอย่างเช่น ลิงก์สัญลักษณ์เหล่านี้อาจชี้ไปยังระบบไฟล์ FUSE ที่โหลดออบเจ็กต์จาก CAS ตามต้องการ
แท็กaffects_outputs
--remote_download_toplevel
-
ดาวน์โหลดเฉพาะเอาต์พุตระยะไกลของเป้าหมายระดับบนสุดไปยังเครื่องในเครื่อง Flag นี้เป็นทางลัดสำหรับ Flag: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata และ --remote_download_outputs=toplevel
ขยายเป็น
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
แท็กaffects_outputs
--symlink_prefix=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
คำนำหน้าที่เพิ่มลงในลิงก์สัญลักษณ์ที่สะดวกซึ่งสร้างขึ้นหลังจากการสร้าง หากไม่ระบุ ค่าเริ่มต้นจะเป็นชื่อของเครื่องมือบิลด์ตามด้วยขีดกลาง หากส่ง '/' จะไม่มีการสร้างลิงก์สัญลักษณ์และไม่มีการแสดงคำเตือน คำเตือน: ฟังก์ชันพิเศษสำหรับ "/" จะเลิกใช้งานในเร็วๆ นี้ โปรดใช้ --experimental_convenience_symlinks=ignore แทน
แท็ก:affects_outputs
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้ข้อมูลอินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าสถานะ ฯลฯ)
--[no]experimental_docker_privileged
ค่าเริ่มต้น: "false"-
หากเปิดใช้ Bazel จะส่งแฟล็ก --privileged ไปยัง "docker run" เมื่อเรียกใช้การดำเนินการ การดำเนินการนี้อาจจำเป็นสำหรับการบิลด์ แต่ก็อาจส่งผลให้ความสามารถในการทำซ้ำลดลงด้วย
แท็กexecution
--experimental_repository_hash_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรมีการยืนยันแฮชของไดเรกทอรีที่เก็บเทียบกับค่านี้
แท็ก:affects_outputs
,experimental
--[no]experimental_sandboxfs_map_symlink_targets
ค่าเริ่มต้น: "false"-
หากเป็นจริง จะแมปเป้าหมายของลิงก์สัญลักษณ์ที่ระบุเป็นอินพุตการดำเนินการลงในแซนด์บ็อกซ์ ฟีเจอร์นี้มีไว้เพื่อแก้ปัญหากฎที่มีข้อบกพร่องซึ่งไม่สามารถดำเนินการนี้ได้ด้วยตัวเอง และควรนำออกเมื่อแก้ไขกฎดังกล่าวทั้งหมดแล้ว
แท็ก:host_machine_resource_optimizations
,execution
--experimental_verify_repository_rules=<a string>
มีการสะสมการใช้งานหลายครั้ง-
หากมีรายการกฎที่เก็บที่ควรมีการยืนยันแฮชของไดเรกทอรีเอาต์พุต โดยระบุไฟล์ด้วย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
--[no]incompatible_legacy_local_fallback
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็น "จริง" จะเปิดใช้การเปลี่ยนกลับโดยนัยแบบเดิมจากกลยุทธ์ที่อยู่ในแซนด์บ็อกซ์เป็นกลยุทธ์ในเครื่อง ในที่สุดค่าเริ่มต้นของฟีเจอร์นี้จะเป็น "เท็จ" และจะไม่มีการดำเนินการใดๆ โปรดใช้ --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
ค่าเริ่มต้น: "จริง"- อนุญาตการเข้าถึงเครือข่ายโดยค่าเริ่มต้นสำหรับการดำเนินการ ซึ่งอาจใช้ไม่ได้กับการติดตั้งใช้งานแซนด์บ็อกซ์ทั้งหมด
--[no]sandbox_fake_hostname
ค่าเริ่มต้น: "false"-
เปลี่ยนชื่อโฮสต์ปัจจุบันเป็น "localhost" สำหรับการดำเนินการในแซนด์บ็อกซ์
แท็กexecution
--[no]sandbox_fake_username
ค่าเริ่มต้น: "false"-
เปลี่ยนชื่อผู้ใช้ปัจจุบันเป็น "nobody" สำหรับการดำเนินการในแซนด์บ็อกซ์
แท็กexecution
--sandbox_writable_path=<a string>
มีการสะสมการใช้งานหลายครั้ง-
สำหรับการดำเนินการในแซนด์บ็อกซ์ ให้ทำให้ไดเรกทอรีที่มีอยู่เขียนได้ในแซนด์บ็อกซ์ (หากการติดตั้งใช้งานแซนด์บ็อกซ์รองรับ มิฉะนั้นจะละเว้น)
แท็ก:execution
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ในไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
ค่าเริ่มต้น: "จริง"-
แท็ก No-op
:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
ค่าเริ่มต้น: "false"-
หาก incompatible_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
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ให้บังคับใช้การจำกัดระดับการแชร์ config_setting หากเป็นเท็จ ทุกการตั้งค่า config จะมองเห็นได้สำหรับทุกเป้าหมาย ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่ควบคุมลักษณะการทำงานของสภาพแวดล้อมในการทดสอบหรือเครื่องมือเรียกใช้การทดสอบ
--[no]check_tests_up_to_date
ค่าเริ่มต้น: "false"-
ไม่ต้องทำการทดสอบ เพียงตรวจสอบว่าการทดสอบเป็นเวอร์ชันล่าสุดหรือไม่ หากผลการทดสอบทั้งหมดเป็นข้อมูลล่าสุด การทดสอบจะเสร็จสมบูรณ์ หากต้องสร้างหรือเรียกใช้การทดสอบ ระบบจะรายงานข้อผิดพลาดและการทดสอบจะไม่สำเร็จ ตัวเลือกนี้หมายถึงลักษณะการทำงานของ --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 ครั้งจึงจะผ่านจะมีการทำเครื่องหมายเป็น "ไม่เสถียร" ในสรุปการทดสอบ โดยปกติแล้ว ค่าที่ระบุจะเป็นเพียงจำนวนเต็มหรือสตริง "default" หากเป็นจำนวนเต็ม ระบบจะเรียกใช้การทดสอบทั้งหมดสูงสุด N ครั้ง หากเป็น "default" ระบบจะพยายามทดสอบเพียงครั้งเดียวสำหรับการทดสอบปกติ และ 3 ครั้งสำหรับการทดสอบที่ทำเครื่องหมายอย่างชัดเจนว่าไม่น่าเชื่อถือตามกฎ (แอตทริบิวต์ flaky=1) ไวยากรณ์สำรอง: regex_filter@flaky_test_attempts โดยที่ flaky_test_attempts เป็นดังที่กล่าวไว้ข้างต้น และ regex_filter หมายถึงรายการรูปแบบนิพจน์ทั่วไปที่รวมและยกเว้น (ดู --runs_per_test ด้วย) ตัวอย่าง: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 deflakes all tests in //foo/ except those under foo/bar three times. ตัวเลือกนี้ส่งได้หลายครั้ง อาร์กิวเมนต์ที่ส่งผ่านล่าสุดซึ่งตรงกันจะมีความสำคัญเหนือกว่า หากไม่มีรายการใดตรงกัน ลักษณะการทำงานจะเป็นเหมือนกับ "default" ด้านบน
แท็ก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">
ค่าเริ่มต้น: "auto"-
จำนวนสูงสุดของงานทดสอบในเครื่องที่จะเรียกใช้พร้อมกัน รับจำนวนเต็มหรือคีย์เวิร์ด ("auto", "HOST_CPUS", "HOST_RAM") ตามด้วยการดำเนินการ ([-|*]<float>) เช่น "auto", "HOST_CPUS*.5" 0 หมายความว่าทรัพยากรในเครื่องจะจำกัดจำนวนงานทดสอบในเครื่องที่จะเรียกใช้พร้อมกันแทน การตั้งค่านี้ให้มากกว่าค่าของ --jobs จะไม่มีผล
แท็กexecution
--[no]test_keep_going
ค่าเริ่มต้น: "จริง"-
เมื่อปิดใช้ การทดสอบที่ไม่ผ่านจะทำให้บิลด์ทั้งหมดหยุดทำงาน โดยค่าเริ่มต้น ระบบจะเรียกใช้การทดสอบทั้งหมด แม้ว่าการทดสอบบางรายการจะไม่ผ่านก็ตาม
แท็กexecution
--test_strategy=<a string>
ค่าเริ่มต้น: ""-
ระบุกลยุทธ์ที่จะใช้เมื่อทำการทดสอบ
แท็กexecution
--test_tmpdir=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไดเรกทอรีชั่วคราวฐานสำหรับ "bazel test" ที่จะใช้
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะได้รับอนุญาตในกราฟการอ้างอิงที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่าถูกยกเลิกในรีจิสทรีที่โมดูลมาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น เวอร์ชันที่ถูกเพิกถอนจะทำให้การแก้ไขล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันที่อนุญาตให้ยกเลิกได้ด้วยตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็กloading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ `error` เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาที่ไม่สำเร็จ, `off` เพื่อปิดใช้การตรวจสอบ หรือ `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน
แท็กloading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าการอ้างอิง `bazel_dep` โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้ว ค่าที่ใช้ได้คือ `off` เพื่อปิดใช้การตรวจสอบ, `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน หรือ `error` เพื่อส่งต่อเป็นความล้มเหลวในการแก้ไข
แท็กloading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นการขึ้นต่อกันของนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท ไม่ว่าค่าของแฟล็กนี้จะเป็นอะไรก็ตาม
แท็กloading_and_analysis
--lockfile_mode=<off, update or error>
ค่าเริ่มต้น: "ปิด"-
ระบุวิธีและจะใช้หรือไม่ใช้ไฟล์ล็อก ค่าที่ใช้ได้คือ `update` เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง, `error` เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่อัปเดต หรือ `off` เพื่อไม่ให้อ่านหรือเขียนไปยังไฟล์ล็อก
แท็กloading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
มีการสะสมการใช้งานหลายครั้ง- แทนที่โมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--registry=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้เพื่อค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับมีความสำคัญ โดยระบบจะค้นหาโมดูลในรีจิสทรีที่อยู่ก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีที่อยู่ถัดไปก็ต่อเมื่อไม่มีโมดูลในรีจิสทรีที่อยู่ก่อนหน้า
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อความละเอียด รูปแบบ หรือตำแหน่งของการบันทึก:
--[no]announce
ค่าเริ่มต้น: "false"-
เลิกใช้งานแล้ว ไม่มีการดำเนินการ
แท็ก:affects_outputs
--[no]debug_spawn_scheduler
ค่าเริ่มต้น: "false"--[no]experimental_bep_target_summary
ค่าเริ่มต้น: "false"- ระบุว่าจะเผยแพร่เหตุการณ์ TargetSummary หรือไม่
--[no]experimental_build_event_expand_filesets
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ขยายชุดไฟล์ใน BEP เมื่อนำเสนอไฟล์เอาต์พุต
แท็กaffects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้แก้ไขลิงก์สัญลักษณ์ 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_local_sandbox_action_metrics
ค่าเริ่มต้น: "จริง"-
เมื่อเปิดใช้ ระบบจะบันทึกสถิติการดำเนินการ (เช่น เวลาของผู้ใช้และเวลาของระบบ) สำหรับการดำเนินการที่ดำเนินการในเครื่องซึ่งใช้แซนด์บ็อกซ์
แท็ก:execution
--[no]experimental_docker_verbose
ค่าเริ่มต้น: "false"-
หากเปิดใช้ Bazel จะพิมพ์ข้อความที่ละเอียดมากขึ้นเกี่ยวกับกลยุทธ์แซนด์บ็อกซ์ Docker
แท็กexecution
--[no]experimental_materialize_param_files_directly
ค่าเริ่มต้น: "false"-
หากสร้างไฟล์พารามิเตอร์ ให้เขียนลงในดิสก์โดยตรง
แท็กexecution
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น ระบบจะจำกัดจำนวนประเภทการดำเนินการไว้ที่ 20 นิโมนิกที่มีจำนวนการดำเนินการที่ดำเนินการแล้วมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับทุกคำช่วยจำ
--experimental_repository_resolved_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้เขียนค่า Starlark พร้อมข้อมูลที่แก้ไขแล้วของกฎที่เก็บ Starlark ทั้งหมดที่ดำเนินการ
แท็กaffects_outputs
--[no]experimental_stream_log_file_uploads
ค่าเริ่มต้น: "false"-
สตรีมการอัปโหลดไฟล์บันทึกไปยังพื้นที่เก็บข้อมูลระยะไกลโดยตรงแทนการเขียนลงในดิสก์
แท็กaffects_outputs
--explain=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
ทำให้ระบบบิลด์อธิบายแต่ละขั้นตอนที่ดำเนินการของบิลด์ ระบบจะเขียนคำอธิบายลงในไฟล์บันทึกที่ระบุ
แท็กaffects_outputs
--[no]legacy_important_outputs
ค่าเริ่มต้น: "จริง"-
ใช้เพื่อระงับการสร้างฟิลด์ important_outputs เดิมในเหตุการณ์ TargetComplete จำเป็นต้องมี important_outputs สำหรับการผสานรวม Bazel กับ ResultStore
แท็กaffects_outputs
--[no]materialize_param_files
ค่าเริ่มต้น: "false"-
เขียนไฟล์พารามิเตอร์ระดับกลางไปยังโครงสร้างเอาต์พุตแม้ว่าจะใช้การดำเนินการระยะไกล มีประโยชน์เมื่อแก้ไขข้อบกพร่องของการดำเนินการ ซึ่งจะแสดงโดย --subcommands และ --verbose_failures
แท็กexecution
--max_config_changes_to_show=<an integer>
ค่าเริ่มต้น: "3"-
เมื่อทิ้งแคชการวิเคราะห์เนื่องจากการเปลี่ยนแปลงตัวเลือกการสร้าง จะแสดงชื่อตัวเลือกที่เปลี่ยนแปลงสูงสุดตามจำนวนที่ระบุ หากระบุหมายเลขเป็น -1 ระบบจะแสดงตัวเลือกทั้งหมดที่มีการเปลี่ยนแปลง
แท็กterminal_output
--max_test_output_bytes=<an integer>
ค่าเริ่มต้น: "-1"-
ระบุขนาดสูงสุดของบันทึกต่อการทดสอบที่สามารถปล่อยออกมาได้เมื่อ --test_output เป็น "errors" หรือ "all" มีประโยชน์ในการหลีกเลี่ยงการทำให้เอาต์พุตมีเสียงรบกวนมากเกินไปจากเอาต์พุตการทดสอบ ส่วนหัวของการทดสอบจะรวมอยู่ในขนาดบันทึก ค่าลบหมายถึงไม่มีขีดจำกัด เอาต์พุตจะเป็นทั้งหมดหรือไม่มีเลย
แท็ก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>
ค่าเริ่มต้น: "failure"-
เลือกเวลาที่จะพิมพ์ข้อความการดำเนินการจากระยะไกล ค่าที่ใช้ได้คือ `failure` เพื่อพิมพ์เฉพาะเมื่อเกิดข้อผิดพลาด `success` เพื่อพิมพ์เฉพาะเมื่อสำเร็จ และ `all` เพื่อพิมพ์เสมอ
แท็กterminal_output
--[no]sandbox_debug
ค่าเริ่มต้น: "false"-
เปิดใช้ฟีเจอร์การแก้ไขข้อบกพร่องสำหรับฟีเจอร์แซนด์บ็อกซ์ ซึ่งรวมถึง 2 สิ่ง ได้แก่ ประการแรก ระบบจะไม่แตะต้องเนื้อหาของรูทแซนด์บ็อกซ์หลังจากสร้าง (และหากใช้ sandboxfs ระบบจะปล่อยให้ระบบไฟล์ยังคงติดตั้งอยู่) และประการที่สอง ระบบจะพิมพ์ข้อมูลการแก้ไขข้อบกพร่องเพิ่มเติมในการดำเนินการ ซึ่งจะช่วยนักพัฒนาที่ใช้กฎ Bazel หรือ Starlark ในการแก้ไขข้อบกพร่องที่เกิดจากไฟล์อินพุตที่ขาดหายไป เป็นต้น
แท็กterminal_output
--show_result=<an integer>
ค่าเริ่มต้น: "1"-
แสดงผลลัพธ์ของบิลด์ สำหรับแต่ละเป้าหมาย ให้ระบุว่ามีการอัปเดตหรือไม่ และหากมีการอัปเดต ให้ระบุรายการไฟล์เอาต์พุตที่สร้างขึ้น ไฟล์ที่พิมพ์ออกมาจะเป็นสตริงที่สะดวกสำหรับการคัดลอกและวางลงในเชลล์เพื่อเรียกใช้
ตัวเลือกนี้ต้องมีอาร์กิวเมนต์จำนวนเต็ม ซึ่งเป็นจำนวนเป้าหมายขั้นต่ำที่ระบบจะไม่พิมพ์ข้อมูลผลลัพธ์ ดังนั้น 0 จะทำให้ระบบระงับข้อความและ MAX_INT จะทำให้ระบบพิมพ์ผลลัพธ์เสมอ ค่าเริ่มต้นคือ 1
แท็กaffects_outputs
--[no]subcommands
[-s
] ค่าเริ่มต้น: "false"-
แสดงคำสั่งย่อยที่ดำเนินการระหว่างการสร้าง แฟล็กที่เกี่ยวข้อง: --execution_log_json_file, --execution_log_binary_file (สำหรับการบันทึกคำสั่งย่อยลงในไฟล์ในรูปแบบที่เป็นมิตรกับเครื่องมือ)
แท็กterminal_output
--test_output=<summary, errors, all or streamed>
ค่าเริ่มต้น: "summary"-
ระบุโหมดเอาต์พุตที่ต้องการ ค่าที่ใช้ได้คือ "summary" เพื่อแสดงผลเฉพาะสรุปสถานะการทดสอบ, "errors" เพื่อพิมพ์บันทึกการทดสอบสำหรับการทดสอบที่ไม่สำเร็จด้วย, "all" เพื่อพิมพ์บันทึกสำหรับการทดสอบทั้งหมด และ "streamed" เพื่อแสดงผลบันทึกสำหรับการทดสอบทั้งหมดแบบเรียลไทม์ (การดำเนินการนี้จะบังคับให้ทดสอบในเครื่องทีละรายการโดยไม่คำนึงถึงค่า --test_strategy)
แท็กtest_runner
,terminal_output
,execution
--test_summary=<short, terse, detailed, none or testcase>
ค่าเริ่มต้น: "short"-
ระบุรูปแบบที่ต้องการของสรุปการทดสอบ ค่าที่ใช้ได้คือ "short" เพื่อพิมพ์ข้อมูลเกี่ยวกับการทดสอบที่ดำเนินการเท่านั้น, "terse" เพื่อพิมพ์ข้อมูลเกี่ยวกับการทดสอบที่ไม่สำเร็จที่ดำเนินการเท่านั้น, "detailed" เพื่อพิมพ์ข้อมูลโดยละเอียดเกี่ยวกับกรณีทดสอบที่ไม่สำเร็จ, "testcase" เพื่อพิมพ์ข้อมูลสรุปในการแก้ไขกรณีทดสอบ, ไม่พิมพ์ข้อมูลโดยละเอียดเกี่ยวกับกรณีทดสอบที่ไม่สำเร็จ และ "none" เพื่อละเว้นข้อมูลสรุป
แท็กterminal_output
--[no]verbose_explanations
ค่าเริ่มต้น: "false"-
เพิ่มความละเอียดของคำอธิบายที่ออกหากเปิดใช้ --explain จะไม่มีผลหากไม่ได้เปิดใช้ --explain
แท็กaffects_outputs
--[no]verbose_failures
ค่าเริ่มต้น: "false"-
หากคำสั่งล้มเหลว ให้พิมพ์บรรทัดคำสั่งแบบเต็ม
แท็ก: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>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุกลยุทธ์สำหรับเบรกเกอร์ที่จะใช้ กลยุทธ์ที่ใช้ได้คือ "failure" หากค่าของตัวเลือกไม่ถูกต้อง ลักษณะการทำงานจะเหมือนกับไม่ได้ตั้งค่าตัวเลือก
แท็กexecution
--experimental_downloader_config=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไฟล์เพื่อกำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สำหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ รูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้เป็น URL แทน โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณสามารถระบุคำสั่ง `rewrite` หลายรายการสำหรับ URL เดียวกันได้ และในกรณีนี้ ระบบจะแสดง URL หลายรายการ
--[no]experimental_guard_against_concurrent_changes
ค่าเริ่มต้น: "false"- ปิดตัวเลือกนี้เพื่อปิดใช้การตรวจสอบ ctime ของไฟล์อินพุตของการดำเนินการก่อนอัปโหลดไปยังแคชระยะไกล อาจมีกรณีที่เคอร์เนล Linux หน่วงเวลาการเขียนไฟล์ ซึ่งอาจทำให้เกิดผลบวกเท็จ
--experimental_remote_build_event_upload=<all or minimal>
ค่าเริ่มต้น: "all"- หากตั้งค่าเป็น "all" ระบบจะอัปโหลดเอาต์พุตในพื้นที่ทั้งหมดที่ BEP อ้างอิงไปยังแคชระยะไกล หากตั้งค่าเป็น "น้อยที่สุด" ระบบจะไม่ส่งเอาต์พุตในเครื่องที่ BEP อ้างอิงไปยังแคชระยะไกล ยกเว้นไฟล์ที่มีความสำคัญต่อผู้ใช้ BEP (เช่น บันทึกการทดสอบและโปรไฟล์เวลา) ระบบจะใช้รูปแบบ bytestream:// สำหรับ URI ของไฟล์เสมอแม้ว่าจะไม่มีไฟล์ในแคชระยะไกลก็ตาม ค่าเริ่มต้นคือ "ทั้งหมด"
--[no]experimental_remote_cache_async
ค่าเริ่มต้น: "false"- หากเป็นจริง I/O ของแคชระยะไกลจะเกิดขึ้นในเบื้องหลังแทนที่จะเป็นส่วนหนึ่งของการเกิด
--[no]experimental_remote_cache_compression
ค่าเริ่มต้น: "false"- หากเปิดใช้ ให้บีบอัด/คลายการบีบอัด Blob ของแคชด้วย zstd
--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
--experimental_remote_capture_corrupted_outputs=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย- เส้นทางไปยังไดเรกทอรีที่จะบันทึกเอาต์พุตที่เสียหาย
--[no]experimental_remote_discard_merkle_trees
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น true ให้ทิ้งสำเนาในหน่วยความจำของต้นไม้ Merkle ของรูทอินพุตและการแมปอินพุตที่เชื่อมโยงระหว่างการเรียก GetActionResult() และ Execute() ซึ่งจะช่วยลดการใช้หน่วยความจำได้อย่างมาก แต่ต้องให้ Bazel คำนวณใหม่เมื่อแคชระยะไกลไม่พบและมีการลองใหม่
--experimental_remote_downloader=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- URI ของปลายทาง Remote Asset API ที่จะใช้เป็นพร็อกซีการดาวน์โหลดจากระยะไกล สคีมาที่รองรับคือ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ unix (ซ็อกเก็ต UNIX ในเครื่อง) หากไม่ได้ระบุสคีมา Bazel จะใช้ grpcs เป็นค่าเริ่มต้น ดูที่ https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
ค่าเริ่มต้น: "false"- ว่าจะกลับไปใช้โปรแกรมดาวน์โหลดในเครื่องหรือไม่หากโปรแกรมดาวน์โหลดระยะไกลล้มเหลว
--[no]experimental_remote_execution_keepalive
ค่าเริ่มต้น: "false"- ว่าจะใช้ 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.>
ค่าเริ่มต้น: "60s"-
ช่วงเวลาที่ใช้ในการคำนวณอัตราความล้มเหลวของคำขอระยะไกล หากค่าเป็น 0 หรือค่าลบ ระบบจะคำนวณระยะเวลาที่ล้มเหลวตลอดระยะเวลาการดำเนินการทั้งหมด คุณสามารถใช้หน่วยต่อไปนี้ได้ วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
แท็กexecution
--[no]experimental_remote_mark_tool_inputs
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" Bazel จะทำเครื่องหมายอินพุตเป็นอินพุตเครื่องมือสำหรับตัวดำเนินการระยะไกล ซึ่งใช้เพื่อติดตั้งใช้งานพนักงานแบบถาวรที่ทำงานจากระยะไกลได้
--[no]experimental_remote_merkle_tree_cache
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" ระบบจะบันทึกการคำนวณ Merkle Tree เพื่อปรับปรุงความเร็วในการตรวจสอบแคชระยะไกล ระบบจะควบคุมปริมาณหน่วยความจำของแคชโดยใช้ --experimental_remote_merkle_tree_cache_size
--experimental_remote_merkle_tree_cache_size=<a long integer>
ค่าเริ่มต้น: "1000"- จำนวนต้นไม้ Merkle ที่จะบันทึกเพื่อปรับปรุงความเร็วในการตรวจสอบการเข้าถึงแคชระยะไกล แม้ว่าระบบจะล้างแคชโดยอัตโนมัติตามการจัดการการอ้างอิงแบบอ่อนของ Java แต่ข้อผิดพลาดหน่วยความจำไม่เพียงพออาจเกิดขึ้นได้หากตั้งค่าสูงเกินไป หากตั้งค่าเป็น 0 ระบบจะไม่จำกัดขนาดแคช ค่าที่เหมาะสมจะแตกต่างกันไปตามขนาดของโปรเจ็กต์ ค่าเริ่มต้นคือ 1,000
--[no]experimental_remote_require_cached
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" ให้บังคับแคชการดำเนินการทั้งหมดที่เรียกใช้จากระยะไกลได้ หรือไม่เช่นนั้นให้สร้างไม่สำเร็จ ซึ่งจะเป็นประโยชน์ในการแก้ปัญหาเกี่ยวกับความไม่แน่นอน เนื่องจากช่วยให้ตรวจสอบได้ว่าการดำเนินการที่ควรแคชนั้นแคชจริงหรือไม่ โดยไม่ต้องแทรกผลลัพธ์ใหม่ที่ไม่เกี่ยวข้องลงในแคช
--[no]incompatible_remote_build_event_upload_respect_no_cache
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" ระบบจะไม่โหลดเอาต์พุตที่ BEP อ้างอิงไปยังแคชระยะไกลหากแคชการดำเนินการสร้างจากระยะไกลไม่ได้
--[no]incompatible_remote_downloader_send_all_headers
ค่าเริ่มต้น: "จริง"-
เลือกว่าจะส่งค่าทั้งหมดของส่วนหัวที่มีหลายค่าไปยังโปรแกรมดาวน์โหลดระยะไกลแทนที่จะส่งเฉพาะค่าแรกหรือไม่
แท็กincompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" เส้นทางเอาต์พุตจะสัมพันธ์กับรูทอินพุตแทนที่จะเป็นไดเรกทอรีการทำงาน
แท็กincompatible_change
--[no]incompatible_remote_results_ignore_disk
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็น "จริง" ระบบจะไม่ใช้ --noremote_upload_local_results และ --noremote_accept_cached กับแคชในดิสก์ หากใช้แคชแบบรวม
--noremote_upload_local_results จะทำให้ระบบเขียนผลลัพธ์ลงในแคชในดิสก์ แต่จะไม่ส่งไปยังแคชระยะไกล
--noremote_accept_cached จะทำให้ Bazel ตรวจสอบผลลัพธ์ในแคชในดิสก์ แต่ไม่ใช่ในแคชระยะไกล
การดำเนินการ no-remote-exec สามารถเข้าถึงแคชในดิสก์ได้
ดูรายละเอียดได้ที่ #8216
แท็กincompatible_change
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" Bazel จะใช้รหัสออกใหม่ 39 แทน 34 หากแคชระยะไกลลบออบเจ็กต์ BLOB ระหว่างการสร้าง
แท็กincompatible_change
--[no]remote_accept_cached
ค่าเริ่มต้น: "จริง"- เลือกว่าจะยอมรับผลลัพธ์ของการดำเนินการที่แคชไว้จากระยะไกลหรือไม่
--remote_bytestream_uri_prefix=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ชื่อโฮสต์และชื่ออินสแตนซ์ที่จะใช้ใน URI ของ bytestream:// ที่เขียนลงในสตรีมเหตุการณ์บิลด์ คุณตั้งค่าตัวเลือกนี้ได้เมื่อทำการบิลด์โดยใช้พร็อกซี ซึ่งจะทำให้ค่าของ --remote_executor และ --remote_instance_name ไม่สอดคล้องกับชื่อที่แน่นอนของบริการการดำเนินการจากระยะไกลอีกต่อไป หากไม่ได้ตั้งค่าไว้ ค่าเริ่มต้นจะเป็น "${hostname}/${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
--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_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 บันทึกนี้ประกอบด้วยลำดับของ protobuf com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry ที่ทำให้เป็นอนุกรม โดยแต่ละข้อความจะมีคำนำหน้าเป็น varint ที่ระบุขนาดของข้อความ protobuf ที่ทำให้เป็นอนุกรมต่อไปนี้ ตามที่ดำเนินการโดยเมธอด 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
ค่าเริ่มต้น: "false"- จะกลับไปใช้กลยุทธ์การดำเนินการในเครื่องแบบสแตนด์อโลนหรือไม่หากการดำเนินการจากระยะไกลล้มเหลว
--remote_local_fallback_strategy=<a string>
ค่าเริ่มต้น: "local"- ไม่มีการดำเนินการ เลิกใช้งานแล้ว ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7480
--remote_max_connections=<an integer>
ค่าเริ่มต้น: "100"-
จำกัดจำนวนการเชื่อมต่อพร้อมกันสูงสุดกับแคช/เครื่องมือดำเนินการระยะไกล โดยค่าเริ่มต้น ค่านี้จะเป็น 100 การตั้งค่านี้เป็น 0 หมายความว่าไม่มีข้อจำกัด
สำหรับแคชระยะไกล HTTP การเชื่อมต่อ TCP หนึ่งรายการจะจัดการคำขอได้ครั้งละ 1 รายการ ดังนั้น Bazel จึงสามารถส่งคำขอพร้อมกันได้สูงสุด --remote_max_connections
สำหรับแคช/ตัวดำเนินการระยะไกล gRPC โดยปกติแล้วแชแนล gRPC 1 รายการจะจัดการคำขอพร้อมกันได้มากกว่า 100 รายการ ดังนั้น Bazel จึงสามารถส่งคำขอพร้อมกันได้ประมาณ `--remote_max_connections * 100` รายการ
แท็กhost_machine_resource_optimizations
--remote_proxy=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- เชื่อมต่อกับแคชระยะไกลผ่านพร็อกซี ปัจจุบันนี้ คุณใช้แฟล็กนี้เพื่อกำหนดค่า Unix Domain Socket (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), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
--remote_timeout=<An immutable length of time.>
ค่าเริ่มต้น: "60s"- ระยะเวลารอสูงสุดสำหรับการเรียกการดำเนินการระยะไกลและการเรียกแคช สำหรับแคช REST นี่คือทั้งการเชื่อมต่อและการหมดเวลาในการอ่าน คุณใช้หน่วยต่อไปนี้ได้ วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
--[no]remote_upload_local_results
ค่าเริ่มต้น: "จริง"- ว่าจะอัปโหลดผลการดำเนินการที่เรียกใช้ในเครื่องไปยังแคชระยะไกลหรือไม่ หากแคชระยะไกลรองรับและผู้ใช้ได้รับอนุญาตให้ดำเนินการดังกล่าว
--[no]remote_verify_downloads
ค่าเริ่มต้น: "จริง"- หากตั้งค่าเป็น true Bazel จะคำนวณผลรวมแฮชของการดาวน์โหลดจากระยะไกลทั้งหมด และทิ้งค่าที่แคชจากระยะไกลหากไม่ตรงกับค่าที่คาดไว้
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้:
--[no]allow_analysis_cache_discard
ค่าเริ่มต้น: "จริง"-
หากทิ้งแคชการวิเคราะห์เนื่องจากการเปลี่ยนแปลงในระบบบิลด์ การตั้งค่าตัวเลือกนี้เป็น "เท็จ" จะทำให้ Bazel ออกจากระบบแทนที่จะดำเนินการบิลด์ต่อ ตัวเลือกนี้จะไม่มีผลเมื่อตั้งค่า "discard_analysis_cache" ด้วย
แท็กeagerness_to_exit
--auto_output_filter=<none, all, packages or subpackages>
ค่าเริ่มต้น: "none"- หากไม่ได้ระบุ --output_filter ระบบจะใช้ค่าสำหรับตัวเลือกนี้เพื่อสร้างตัวกรองโดยอัตโนมัติ ค่าที่อนุญาตคือ "none" (ไม่กรอง / แสดงทุกอย่าง), "all" (กรองทุกอย่าง / ไม่แสดงอะไรเลย), "packages" (รวมเอาต์พุตจากกฎในแพ็กเกจที่กล่าวถึงในบรรทัดคำสั่ง Blaze) และ "subpackages" (เหมือน "packages" แต่รวมแพ็กเกจย่อยด้วย) สำหรับค่า "แพ็กเกจ" และ "แพ็กเกจย่อย" ระบบจะถือว่า //java/foo และ //javatests/foo เป็นแพ็กเกจเดียวกัน
--[no]build_manual_tests
ค่าเริ่มต้น: "false"- บังคับให้สร้างเป้าหมายการทดสอบที่ติดแท็ก "manual" ระบบจะไม่ประมวลผลการทดสอบ "ด้วยตนเอง" ตัวเลือกนี้จะบังคับให้สร้าง (แต่ไม่บังคับให้เรียกใช้)
--build_tag_filters=<comma-separated list of options>
ค่าเริ่มต้น: ""- ระบุรายการแท็กที่คั่นด้วยคอมมา คุณจะใส่เครื่องหมาย "-" ไว้หน้าแท็กแต่ละรายการหรือไม่ก็ได้เพื่อระบุแท็กที่ยกเว้น ระบบจะสร้างเฉพาะเป้าหมายที่มีแท็กที่รวมไว้อย่างน้อย 1 รายการและไม่มีแท็กที่ยกเว้น ตัวเลือกนี้ไม่มีผลต่อชุดการทดสอบที่ดำเนินการด้วยคำสั่ง "test" ซึ่งจะอยู่ภายใต้ตัวเลือกการกรองการทดสอบ เช่น "--test_tag_filters"
--[no]build_tests_only
ค่าเริ่มต้น: "false"- หากระบุไว้ ระบบจะสร้างเฉพาะกฎ *_test และ test_suite และจะไม่สนใจเป้าหมายอื่นๆ ที่ระบุในบรรทัดคำสั่ง โดยค่าเริ่มต้น ระบบจะสร้างทุกอย่างที่ขอ
--combined_report=<none or lcov>
ค่าเริ่มต้น: "none"- ระบุประเภทรายงานความครอบคลุมสะสมที่ต้องการ ปัจจุบันรองรับเฉพาะ LCOV
--[no]compile_one_dependency
ค่าเริ่มต้น: "false"- คอมไพล์การอ้างอิงเดียวของไฟล์อาร์กิวเมนต์ ซึ่งจะเป็นประโยชน์ในการตรวจสอบไวยากรณ์ของไฟล์ต้นฉบับใน IDE เช่น โดยการสร้างเป้าหมายเดียวที่ขึ้นอยู่กับไฟล์ต้นฉบับใหม่เพื่อตรวจหาข้อผิดพลาดให้เร็วที่สุดในวงจรการแก้ไข/การสร้าง/การทดสอบ อาร์กิวเมนต์นี้จะส่งผลต่อวิธีตีความอาร์กิวเมนต์ที่ไม่ใช่แฟล็กทั้งหมด โดยจะใช้เป็นชื่อไฟล์ต้นฉบับแทนที่จะเป็นเป้าหมายในการสร้าง ระบบจะสร้างเป้าหมายที่กำหนดเองซึ่งขึ้นอยู่กับชื่อไฟล์แหล่งที่มาแต่ละชื่อ
--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.>
มีการสะสมการใช้งานหลายครั้ง- กำหนดค่าโปรแกรมช่วยเหลือข้อมูลเข้าสู่ระบบที่จะใช้ในการดึงข้อมูลเข้าสู่ระบบการให้สิทธิ์สำหรับการดึงข้อมูลที่เก็บ การแคชและการดำเนินการระยะไกล และบริการเหตุการณ์การสร้าง ข้อมูลเข้าสู่ระบบที่ตัวช่วยระบุจะมีลำดับความสำคัญเหนือกว่าข้อมูลเข้าสู่ระบบที่ระบุโดย --google_default_credentials, --google_credentials, ไฟล์ .netrc หรือพารามิเตอร์การตรวจสอบสิทธิ์ไปยัง repository_ctx.download และ repository_ctx.download_and_extract ระบุได้หลายครั้งเพื่อตั้งค่าผู้ช่วยหลายราย ดูรายละเอียดได้ที่ https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md
--credential_helper_cache_duration=<An immutable length of time.>
ค่าเริ่มต้น: "30m"- ระยะเวลาที่ระบบจะแคชข้อมูลเข้าสู่ระบบที่ตัวช่วยข้อมูลเข้าสู่ระบบระบุ การเรียกใช้ด้วยค่าอื่นจะปรับอายุการใช้งานของรายการที่มีอยู่แล้ว ให้ส่งค่า 0 เพื่อล้างแคช คำสั่ง clean จะล้างแคชเสมอ ไม่ว่าจะมีแฟล็กนี้หรือไม่ก็ตาม
--credential_helper_timeout=<An immutable length of time.>
ค่าเริ่มต้น: "10s"- กำหนดค่าการหมดเวลาสำหรับโปรแกรมช่วยจัดการข้อมูลเข้าสู่ระบบ หากผู้ช่วยจัดการข้อมูลเข้าสู่ระบบไม่ตอบกลับภายในระยะหมดเวลานี้ การเรียกใช้จะล้มเหลว
--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
ค่าเริ่มต้น: "false"- ทิ้งแคชการวิเคราะห์ทันทีหลังจากที่ระยะการวิเคราะห์เสร็จสมบูรณ์ ลดการใช้หน่วยความจำลงประมาณ 10% แต่จะทำให้การสร้างที่เพิ่มขึ้นในภายหลังช้าลง
--disk_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย- เส้นทางไปยังไดเรกทอรีที่ Bazel อ่านและเขียนการดำเนินการและเอาต์พุตของการดำเนินการได้ หากยังไม่มีไดเรกทอรี ระบบจะสร้างให้
--embed_label=<a one-line string>
ค่าเริ่มต้น: ""- ฝังการแก้ไขการควบคุมแหล่งที่มาหรือป้ายกำกับรุ่นในไบนารี
--execution_log_binary_file=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย- บันทึกการเรียกใช้ที่ดำเนินการลงในไฟล์นี้เป็น Spawn Protos ที่คั่นตาม src/main/protobuf/spawn.proto ระบบจะเขียนบันทึกแบบไม่เรียงลำดับก่อน จากนั้นเมื่อสิ้นสุดการเรียกใช้ ระบบจะจัดเรียงบันทึกตามลำดับที่เสถียร (อาจใช้ CPU และหน่วยความจำสูง) แฟล็กที่เกี่ยวข้อง: --execution_log_json_file (รูปแบบ JSON ของข้อความที่เรียงลำดับ), --experimental_execution_log_file (รูปแบบ Protobuf ไบนารีที่ไม่ได้เรียงลำดับ), --subcommands (สําหรับแสดงคําสั่งย่อยในเอาต์พุตของเทอร์มินัล)
--execution_log_json_file=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย- บันทึกการเรียกใช้ Spawn ลงในไฟล์นี้เป็นตัวแทน JSON ของ Spawn Protos ที่คั่นตาม src/main/protobuf/spawn.proto ระบบจะเขียนบันทึกแบบไม่เรียงลำดับก่อน จากนั้นเมื่อสิ้นสุดการเรียกใช้ ระบบจะจัดเรียงบันทึกตามลำดับที่เสถียร (อาจใช้ CPU และหน่วยความจำสูง) แฟล็กที่เกี่ยวข้อง: แฟล็กที่เกี่ยวข้อง: --execution_log_binary_file (รูปแบบ protobuf ไบนารีที่เรียงลำดับ), --experimental_execution_log_file (รูปแบบ protobuf ไบนารีที่ไม่ได้เรียงลำดับ), --subcommands (สำหรับการแสดงคำสั่งย่อยในเอาต์พุตของเทอร์มินัล)
--[no]execution_log_sort
ค่าเริ่มต้น: "จริง"- เลือกว่าจะจัดเรียงบันทึกการดำเนินการหรือไม่ ตั้งค่าเป็น false เพื่อปรับปรุงประสิทธิภาพหน่วยความจำ โดยอาจทำให้บันทึกเรียงตามลำดับที่ไม่แน่นอน
--[no]expand_test_suites
ค่าเริ่มต้น: "จริง"-
ขยายเป้าหมาย test_suite ไปยังการทดสอบที่เป็นส่วนประกอบก่อนการวิเคราะห์ เมื่อเปิดใช้ฟีเจอร์นี้ (ค่าเริ่มต้น) รูปแบบเป้าหมายเชิงลบจะมีผลกับการทดสอบที่อยู่ในชุดการทดสอบ ไม่เช่นนั้นจะไม่มีผล การปิดแฟล็กนี้มีประโยชน์เมื่อใช้แง่มุมระดับบนสุดที่บรรทัดคำสั่ง จากนั้นจะวิเคราะห์เป้าหมาย test_suite ได้
แท็กloading_and_analysis
--experimental_execution_log_file=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย- บันทึกการเรียกใช้ที่ดำเนินการลงในไฟล์นี้เป็น Spawn Protos ที่คั่นตาม src/main/protobuf/spawn.proto ไฟล์นี้จะเขียนตามลำดับการดำเนินการของ Spawns แฟล็กที่เกี่ยวข้อง: --execution_log_binary_file (รูปแบบไบนารี protobuf ที่เรียงลำดับ), --execution_log_json_file (รูปแบบ JSON ของข้อความที่เรียงลำดับ), --subcommands (สำหรับการแสดงคำสั่งย่อยในเอาต์พุตของเทอร์มินัล)
--[no]experimental_execution_log_spawn_metrics
ค่าเริ่มต้น: "false"- รวมเมตริกการเกิดในบันทึกการเกิดที่ดำเนินการแล้ว
--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
ค่าเริ่มต้น: "false"- เลิกใช้งานแล้วเพื่อใช้แง่มุมแทน กำหนดเวลา extra_actions สำหรับเป้าหมายระดับบนสุดเท่านั้น
--[no]experimental_prioritize_local_actions
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าไว้ การดำเนินการที่เรียกใช้ได้เฉพาะในเครื่องจะได้รับโอกาสแรกในการรับทรัพยากร ส่วนการดำเนินการที่เรียกใช้แบบไดนามิกจะได้รับโอกาสที่ 2 และการดำเนินการแบบสแตนด์อโลนที่เรียกใช้แบบไดนามิกจะได้รับโอกาสสุดท้าย
แท็กexecution
--experimental_spawn_scheduler
-
เปิดใช้การดำเนินการแบบไดนามิกโดยการเรียกใช้การดำเนินการในเครื่องและจากระยะไกลแบบคู่ขนาน Bazel จะสร้างการดำเนินการแต่ละอย่างในเครื่องและจากระยะไกล แล้วเลือกการดำเนินการที่เสร็จสมบูรณ์ก่อน หากการดำเนินการรองรับ Worker ระบบจะเรียกใช้การดำเนินการในเครื่องในโหมด Worker แบบถาวร หากต้องการเปิดใช้การดำเนินการแบบไดนามิกสำหรับตัวช่วยจำการดำเนินการแต่ละรายการ ให้ใช้แฟล็ก `--internal_spawn_scheduler` และ `--strategy=<mnemonic>=dynamic` แทน
ขยายเป็น
--internal_spawn_scheduler
--spawn_strategy=dynamic
--google_auth_scopes=<comma-separated list of options>
default: "https://www.googleapis.com/auth/cloud-platform"- รายการขอบเขตการตรวจสอบสิทธิ์ของ Google Cloud ที่คั่นด้วยคอมมา
--google_credentials=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไฟล์ที่จะรับข้อมูลเข้าสู่ระบบสำหรับการตรวจสอบสิทธิ์ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication
--[no]google_default_credentials
ค่าเริ่มต้น: "false"- ว่าจะใช้ "ข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชันของ Google" สำหรับการตรวจสอบสิทธิ์หรือไม่ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication ปิดใช้โดยค่าเริ่มต้น
--grpc_keepalive_time=<An immutable length of time.>
ค่าเริ่มต้น: ดูคำอธิบาย- กำหนดค่า Ping Keep-Alive สำหรับการเชื่อมต่อ gRPC ขาออก หากตั้งค่านี้ไว้ Bazel จะส่งการ Ping หลังจากไม่มีการดำเนินการอ่านในการเชื่อมต่อเป็นเวลานานเท่านี้ แต่จะส่งก็ต่อเมื่อมีการเรียก gRPC ที่รอดำเนินการอย่างน้อย 1 รายการ ระบบจะถือว่าเวลาเป็นหน่วยวินาที การตั้งค่าที่น้อยกว่า 1 วินาทีถือเป็นข้อผิดพลาด โดยค่าเริ่มต้น ระบบจะปิดใช้ Ping Keep-Alive คุณควรประสานงานกับเจ้าของบริการก่อนที่จะเปิดใช้การตั้งค่านี้ เช่น หากต้องการตั้งค่าเป็น 30 วินาที ให้ทำดังนี้ --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.>
ค่าเริ่มต้น: "20s"- กำหนดค่าการหมดเวลา Keep-Alive สำหรับการเชื่อมต่อ gRPC ขาออก หากเปิดใช้คำสั่ง ping keep-alive ด้วย --grpc_keepalive_time Bazel จะหมดเวลาการเชื่อมต่อหากไม่ได้รับการตอบกลับคำสั่ง ping หลังจากผ่านไประยะเวลาดังกล่าว ระบบจะถือว่าเวลาเป็นหน่วยวินาที การตั้งค่าที่น้อยกว่า 1 วินาทีถือเป็นข้อผิดพลาด หากปิดใช้ Ping Keep-Alive ระบบจะไม่สนใจการตั้งค่านี้
--[no]ignore_unsupported_sandboxing
ค่าเริ่มต้น: "false"- อย่าพิมพ์คำเตือนเมื่อระบบนี้ไม่รองรับการดำเนินการในแซนด์บ็อกซ์
--[no]incompatible_dont_use_javasourceinfoprovider
ค่าเริ่มต้น: "false"-
ไม่มีการดำเนินการ
แท็ก:incompatible_change
--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 ที่พร้อมใช้งาน
--local_extra_resources=<a named float, 'name=value'>
มีการสะสมการใช้งานหลายครั้ง- ตั้งค่าจำนวนทรัพยากรเพิ่มเติมที่ Bazel ใช้ได้ รับคู่สตริง-โฟลต ใช้ได้หลายครั้งเพื่อระบุแหล่งข้อมูลเพิ่มเติมหลายประเภท Bazel จะจำกัดการดำเนินการที่ทำงานพร้อมกันโดยอิงตามทรัพยากรเพิ่มเติมที่มีและทรัพยากรเพิ่มเติมที่จำเป็น การทดสอบสามารถประกาศจำนวนทรัพยากรเพิ่มเติมที่ต้องการได้โดยใช้แท็กในรูปแบบ "resources:<resoucename>:<amount>" ตั้งค่า CPU, RAM และทรัพยากรที่พร้อมใช้งานด้วยแฟล็กนี้ไม่ได้
--local_ram_resources=<an integer, 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% ของ RAM นั้น
--local_termination_grace_seconds=<an integer>
ค่าเริ่มต้น: "15"- เวลารอระหว่างการสิ้นสุดกระบวนการในเครื่องเนื่องจากหมดเวลาและการปิดเครื่องโดยบังคับ
--override_repository=<an equals-separated mapping of repository name to path>
มีการสะสมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--package_path=<colon-separated list of options>
ค่าเริ่มต้น: "%workspace%"- รายการที่คั่นด้วยโคลอนของตำแหน่งที่จะค้นหาแพ็กเกจ องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับเวิร์กสเปซที่ครอบคลุม หากละไว้หรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
--[no]show_loading_progress
ค่าเริ่มต้น: "จริง"- หากเปิดใช้ จะทำให้ 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 และคำสั่งทดสอบ
--tls_certificate=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุเส้นทางไปยังใบรับรอง TLS ที่เชื่อถือได้ในการลงนามใบรับรองเซิร์ฟเวอร์
--tls_client_certificate=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุใบรับรองไคลเอ็นต์ TLS ที่จะใช้ คุณต้องระบุคีย์ไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
--tls_client_key=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุคีย์ไคลเอ็นต์ TLS ที่จะใช้ คุณต้องระบุใบรับรองไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
--workspace_status_command=<path>
ค่าเริ่มต้น: ""- คำสั่งที่เรียกใช้เมื่อเริ่มต้นการสร้างเพื่อแสดงข้อมูลสถานะเกี่ยวกับพื้นที่ทำงานในรูปแบบคู่คีย์/ค่า ดูข้อกำหนดฉบับเต็มได้ในคู่มือผู้ใช้ ดูตัวอย่างได้ที่ tools/buildstamp/get_workspace_status
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
--[no]check_up_to_date
ค่าเริ่มต้น: "false"-
ไม่ต้องสร้าง เพียงตรวจสอบว่าเวอร์ชันล่าสุดหรือไม่ หากเป้าหมายทั้งหมดเป็นข้อมูลล่าสุด การสร้างจะเสร็จสมบูรณ์ หากต้องดำเนินการขั้นตอนใดก็ตาม ระบบจะรายงานข้อผิดพลาดและบิลด์จะล้มเหลว
แท็กexecution
--[no]experimental_inprocess_symlink_creation
ค่าเริ่มต้น: "false"-
จะเรียกใช้ระบบไฟล์โดยตรงเพื่อสร้างโครงสร้างซิมลิงก์หรือไม่
แท็ก:loading_and_analysis
,execution
,experimental
--[no]experimental_remotable_source_manifests
ค่าเริ่มต้น: "false"-
จะทำให้การดำเนินการกับไฟล์ Manifest ต้นฉบับสามารถดำเนินการจากระยะไกลได้หรือไม่
แท็ก:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะเรียกใช้การประมวลผลภายหลังของ Coverage สำหรับการทดสอบในกระบวนการใหม่
แท็กexecution
--[no]experimental_split_xml_generation
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าสถานะนี้และมีการดำเนินการทดสอบที่ไม่สร้างไฟล์ test.xml แล้ว Bazel จะใช้การดำเนินการแยกต่างหากเพื่อสร้างไฟล์ test.xml จำลองที่มีบันทึกการทดสอบ มิฉะนั้น Bazel จะสร้าง test.xml เป็นส่วนหนึ่งของการดำเนินการทดสอบ
แท็กexecution
--[no]experimental_strict_fileset_output
ค่าเริ่มต้น: "false"-
หากเปิดใช้ตัวเลือกนี้ ชุดไฟล์จะถือว่าอาร์ติแฟกต์เอาต์พุตทั้งหมดเป็นไฟล์ปกติ โดยจะไม่ข้ามไดเรกทอรีหรือคำนึงถึงลิงก์สัญลักษณ์
แท็กexecution
--genrule_strategy=<comma-separated list of options>
ค่าเริ่มต้น: ""-
ระบุวิธีเรียกใช้ genrules เราจะเลิกใช้ธงนี้ ให้ใช้ --spawn_strategy=<value> เพื่อควบคุมการดำเนินการทั้งหมด หรือ --strategy=Genrule=<value> เพื่อควบคุม genrule เท่านั้น
แท็กexecution
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] default: "auto"-
จำนวนงานที่เกิดขึ้นพร้อมกันที่จะเรียกใช้ รับจำนวนเต็มหรือคีย์เวิร์ด ("auto", "HOST_CPUS", "HOST_RAM") ตามด้วยการดำเนินการ ([-|*]<float>) เช่น "auto", "HOST_CPUS*.5" ค่าต้องอยู่ระหว่าง 1 ถึง 5000 ค่าที่สูงกว่า 2500 อาจทำให้เกิดปัญหาเกี่ยวกับหน่วยความจำ "auto" จะคำนวณค่าเริ่มต้นที่เหมาะสมตามทรัพยากรของโฮสต์
แท็ก:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] ค่าเริ่มต้น: "false"-
ดำเนินการต่อให้ได้มากที่สุดหลังจากเกิดข้อผิดพลาด แม้ว่าจะวิเคราะห์เป้าหมายที่ล้มเหลวและเป้าหมายที่ขึ้นอยู่กับเป้าหมายนั้นไม่ได้ แต่ก็วิเคราะห์ข้อกำหนดเบื้องต้นอื่นๆ ของเป้าหมายเหล่านี้ได้
แท็ก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">
ค่าเริ่มต้น: "auto"-
จำนวนเธรดแบบขนานที่จะใช้ในระยะการโหลด/วิเคราะห์ รับค่าจำนวนเต็มหรือคีย์เวิร์ด ("auto", "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 เมื่อระบุค่าหลายค่า ลำดับมีความสำคัญเนื่องจากนิพจน์ทั่วไปจำนวนมากอาจใช้กับตัวช่วยจำเดียวกัน
ไวยากรณ์: "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 อย่างต่อเนื่องโดยใช้ Worker
ขยายเป็น
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
แท็กhost_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
เปิดใช้ตัวประมวลผลทรัพยากร Android แบบถาวรโดยใช้ Worker
ขยายเป็น
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
แท็กhost_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
เปิดใช้การดำเนินการ dex และ desugar ของ Android แบบหลายรายการที่ต่อเนื่องโดยใช้ Worker
ขยายเป็น:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
เปิดใช้ตัวประมวลผลทรัพยากร Android แบบมัลติเพล็กซ์ถาวรโดยใช้ Worker
ขยายเป็น
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
แท็กhost_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
เปิดใช้เครื่องมือ Android แบบถาวรและแบบมัลติเพล็กซ์ (dexing, desugaring, การประมวลผลทรัพยากร)
ขยายเป็น
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
แท็กhost_machine_resource_optimizations
,execution
--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 หากใช้กับ Genrule แบบช่วยจำ) ดูรายละเอียดได้ที่ https://blog.bazel.build/2019/06/19/list-strategy.html
แท็กexecution
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
มีการสะสมการใช้งานหลายครั้ง-
ลบล้างกลยุทธ์การเกิดที่ควรใช้เพื่อดำเนินการกับการเกิดที่มีคำอธิบายตรงกับ regex_filter ที่เฉพาะเจาะจง ดูรายละเอียดเกี่ยวกับการจับคู่ 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
- ตัวเลือกที่กำหนดค่าเครื่องมือที่ใช้สำหรับการดำเนินการ
--android_compiler=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
คอมไพเลอร์เป้าหมายของ Android
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
default: "//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 Flag to help thetransition to the Android manifest merger from the legacy merger.
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
ค่าเริ่มต้น: ""-
ตั้งค่าแพลตฟอร์มที่เป้าหมาย android_binary ใช้ หากระบุหลายแพลตฟอร์ม ไบนารีจะเป็น APK แบบ Fat ซึ่งมีไบนารีแบบเนทีฟสำหรับแต่ละแพลตฟอร์มเป้าหมายที่ระบุ
แท็กchanges_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
default: "@bazel_tools//tools/android:sdk"-
ระบุ Android SDK/แพลตฟอร์มที่ใช้สร้างแอปพลิเคชัน Android
แท็กchanges_inputs
,loading_and_analysis
,loses_incremental_state
--apple_compiler=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
คอมไพเลอร์เป้าหมายของ Apple มีประโยชน์สำหรับการเลือกตัวแปรของ Toolchain (เช่น xcode-beta)
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
default: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้ในกฎ Apple และ Objc รวมถึงการอ้างอิงของกฎเหล่านั้น
แท็ก:loses_incremental_state
,changes_inputs
--apple_grte_top=<a build target label>
ค่าเริ่มต้น: ดูคำอธิบาย-
เป้าหมาย Apple grte_top
แท็กchanges_inputs
,loading_and_analysis
,loses_incremental_state
--cc_output_directory_tag=<a string>
ค่าเริ่มต้น: ""-
ระบุคำต่อท้ายที่จะเพิ่มลงในไดเรกทอรีการกำหนดค่า
แท็ก:affects_outputs
,explicit_in_output_path
--compiler=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
คอมไพเลอร์ C++ ที่จะใช้คอมไพล์เป้าหมาย
แท็ก:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
default: "@bazel_tools//tools/test:lcov_merger"-
ตำแหน่งของไบนารีที่ใช้ในการประมวลผลรายงานความครอบคลุมดิบ ปัจจุบันต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งก็คือไบนารี ค่าเริ่มต้นคือ "//tools/test:lcov_merger"
แท็กchanges_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
default: "@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>
default: "@bazel_tools//tools/test:coverage_support"-
ตำแหน่งของไฟล์สนับสนุนที่จำเป็นในอินพุตของการดำเนินการทดสอบทุกครั้งที่รวบรวมความครอบคลุมของโค้ด ค่าเริ่มต้นคือ "//tools/test:coverage_support"
แท็กchanges_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
default: "@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 รายการ ระบบจะดำเนินการความละเอียดของเครื่องมือราวกับว่าได้ประกาศค่าข้อจำกัดเป็นข้อจำกัดในการดำเนินการ ตัวอย่าง: //demo,-test=@platforms//cpus:x86_64 จะเพิ่ม "x86_64" ให้กับเป้าหมายใดก็ตามภายใต้ //demo ยกเว้นเป้าหมายที่มีชื่อซึ่งมี "test"
แท็กloading_and_analysis
--[no]experimental_enable_objc_cc_deps
ค่าเริ่มต้น: "จริง"-
อนุญาตให้กฎ objc_* ขึ้นอยู่กับ cc_library และทำให้มีการสร้างการอ้างอิง objc ใดๆ โดยตั้งค่า --cpu เป็น "ios_<--ios_cpu>" สำหรับค่าใดๆ ใน --ios_multi_cpu
แท็ก:loading_and_analysis
,incompatible_change
--[no]experimental_include_xcode_execution_requirements
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ให้เพิ่มข้อกำหนดในการดำเนินการ "requires-xcode:{version}" ลงในการดำเนินการ Xcode ทุกรายการ หากเวอร์ชัน xcode มีป้ายกำกับที่มีขีดกลาง ให้เพิ่มข้อกำหนดในการดำเนินการ "requires-xcode-label:{version_label}" ด้วย
แท็กloses_incremental_state
,loading_and_analysis
,execution
--[no]experimental_prefer_mutual_xcode
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ให้ใช้ 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 คุณระบุ Toolchain ได้โดยใช้เป้าหมายที่แน่นอนหรือรูปแบบเป้าหมาย ระบบจะพิจารณา Toolchain เหล่านี้ก่อน Toolchain ที่ประกาศไว้ในไฟล์ WORKSPACE โดย register_toolchains()
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
ค่าเริ่มต้น: ดูคำอธิบาย-
ป้ายกำกับสำหรับไลบรารี libc ที่เช็คอินแล้ว ค่าเริ่มต้นจะเลือกโดยเครื่องมือ Crosstool Toolchain และคุณแทบจะไม่ต้องลบล้างค่านี้
แท็ก:action_command_lines
,affects_outputs
--host_compiler=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
คอมไพเลอร์ C++ ที่จะใช้สำหรับการคอมไพล์โฮสต์ ระบบจะไม่สนใจหากไม่ได้ตั้งค่า --host_crosstool_top
แท็ก:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
ค่าเริ่มต้น: ดูคำอธิบาย-
โดยค่าเริ่มต้น ระบบจะใช้ตัวเลือก --crosstool_top และ --compiler กับการกำหนดค่าโฮสต์ด้วย หากมีการระบุแฟล็กนี้ Bazel จะใช้ libc และคอมไพเลอร์เริ่มต้นสำหรับ crosstool_top ที่ระบุ
แท็กloading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
ค่าเริ่มต้น: ดูคำอธิบาย-
หากระบุไว้ การตั้งค่านี้จะลบล้างไดเรกทอรีระดับบนสุดของ libc (--grte_top) สำหรับการกำหนดค่าโฮสต์
แท็ก:action_command_lines
,affects_outputs
--host_platform=<a build target label>
ค่าเริ่มต้น: ""-
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายระบบโฮสต์
แท็กaffects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง Bazel จะไม่อนุญาตให้ระบุ expand_if_all_available ใน flag_sets(ดูวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/7008)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง Bazel จะไม่เปิดใช้ฟีเจอร์ "โฮสต์" และ "ไม่ใช่โฮสต์" ในเครื่องมือ C++ (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/7407)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
ค่าเริ่มต้น: "false"-
ใช้การแก้ปัญหา Toolchain เพื่อเลือก Android SDK สำหรับกฎ Android (Starlark และเนทีฟ)
แท็กloading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
ค่าเริ่มต้น: "false"-
ใช้การแก้ปัญหา Toolchain เพื่อเลือก Apple SDK สำหรับกฎของ Apple (Starlark และเนทีฟ)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง Bazel จะไม่นำบรรทัดคำสั่งการดำเนินการลิงก์ C++ กลับมาใช้ซ้ำสำหรับบรรทัดคำสั่งการจัดทำดัชนี LTO (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/6791)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง Bazel จะแจ้งข้อผิดพลาดเมื่อตั้งค่าแอตทริบิวต์ cc_toolchain.cpu และ cc_toolchain.compiler (ดูวิธีการย้ายข้อมูลได้ที่ https://github.com/bazelbuild/bazel/issues/7075)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง Bazel จะไม่ลิงก์ทรัพยากร Dependency ของไลบรารีเป็นทั้งอาร์ไคฟ์โดยค่าเริ่มต้น (ดูวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/7362)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง Bazel จะกำหนดให้มีพารามิเตอร์ "ctx" ใน cc_common.configure_features (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/7793)
แท็ก:loading_and_analysis
,incompatible_change
-
ใช้ออบเจ็กต์ที่แชร์ของอินเทอร์เฟซหากชุดเครื่องมือรองรับ ปัจจุบัน 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 หากไม่ได้ระบุ ให้ใช้ SDK เวอร์ชันเริ่มต้นของ iOS จาก "xcode_version"
แท็กloses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุเวอร์ชันของ macOS SDK ที่จะใช้ในการสร้างแอปพลิเคชัน macOS หากไม่ได้ระบุไว้ ให้ใช้ SDK เวอร์ชันเริ่มต้นของ macOS จาก "xcode_version"
แท็กloses_incremental_state
--minimum_os_version=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
เวอร์ชันระบบปฏิบัติการขั้นต่ำที่การคอมไพล์ของคุณกำหนดเป้าหมาย
แท็ก:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
ค่าเริ่มต้น: ""-
ตำแหน่งของไฟล์แมปที่อธิบายว่าควรใช้แพลตฟอร์มใดหากไม่ได้ตั้งค่า หรือควรตั้งค่า Flag ใดเมื่อมีแพลตฟอร์มอยู่แล้ว ต้องสัมพันธ์กับรูทของพื้นที่ทำงานหลัก ค่าเริ่มต้นคือ "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
--target_platform_fallback=<a build target label>
default: "@local_config_platform//:host"-
ป้ายกำกับของกฎแพลตฟอร์มที่ควรใช้หากไม่ได้ตั้งค่าแพลตฟอร์มเป้าหมายและไม่มีการแมปแพลตฟอร์มที่ตรงกับชุดค่าสถานะปัจจุบัน
แท็กaffects_outputs
,changes_inputs
,loading_and_analysis
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุเวอร์ชันของ tvOS SDK ที่จะใช้ในการสร้างแอปพลิเคชัน tvOS หากไม่ได้ระบุ ระบบจะใช้ SDK เวอร์ชันเริ่มต้นของ tvOS จาก "xcode_version"
แท็กloses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุเวอร์ชันของ watchOS SDK ที่จะใช้ในการสร้างแอปพลิเคชัน watchOS หากไม่ได้ระบุ ให้ใช้ SDK เวอร์ชันเริ่มต้นของ watchOS จาก "xcode_version"
แท็กloses_incremental_state
--xcode_version=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
หากระบุไว้ จะใช้ Xcode เวอร์ชันที่กำหนดสำหรับการดำเนินการบิลด์ที่เกี่ยวข้อง หากไม่ได้ระบุ ระบบจะใช้ Xcode เวอร์ชันเริ่มต้นของตัวดำเนินการ
แท็กloses_incremental_state
--xcode_version_config=<a build target label>
default: "@bazel_tools//tools/cpp:host_xcodes"-
ป้ายกำกับของกฎ xcode_config ที่จะใช้ในการเลือกเวอร์ชัน Xcode ในการกำหนดค่าบิลด์
แท็ก:loses_incremental_state
,loading_and_analysis
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่ง
--[no]apple_enable_auto_dsym_dbg
ค่าเริ่มต้น: "false"-
เลือกว่าจะบังคับให้เปิดใช้การสร้างไฟล์สัญลักษณ์สำหรับแก้ไขข้อบกพร่อง (.dSYM) สำหรับบิลด์ dbg หรือไม่
แท็ก:affects_outputs
,action_command_lines
--[no]apple_generate_dsym
ค่าเริ่มต้น: "false"-
จะสร้างไฟล์สัญลักษณ์สำหรับแก้ไขข้อบกพร่อง (.dSYM) หรือไม่
แท็ก:affects_outputs
,action_command_lines
--[no]build
ค่าเริ่มต้น: "จริง"-
เรียกใช้บิลด์ ซึ่งเป็นลักษณะการทำงานปกติ การระบุ --nobuild จะทำให้การสร้างหยุดก่อนที่จะดำเนินการสร้างการดำเนินการ โดยจะคืนค่าเป็น 0 หากโหลดแพ็กเกจและวิเคราะห์เฟสเสร็จสมบูรณ์ โหมดนี้มีประโยชน์สำหรับการทดสอบเฟสเหล่านั้น
แท็ก:execution
,affects_outputs
--[no]build_runfile_links
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ให้สร้างป่าซิมลิงก์ของไฟล์ที่เรียกใช้ได้สำหรับเป้าหมายทั้งหมด หากเป็นเท็จ ให้เขียนเฉพาะไฟล์ Manifest เมื่อเป็นไปได้
แท็กaffects_outputs
--[no]build_runfile_manifests
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ให้เขียนไฟล์ Manifest ของไฟล์ที่เรียกใช้สำหรับเป้าหมายทั้งหมด หากเป็นเท็จ ให้ละเว้น การทดสอบในเครื่องจะเรียกใช้ไม่สำเร็จเมื่อเป็นเท็จ
แท็กaffects_outputs
--[no]build_test_dwp
ค่าเริ่มต้น: "false"-
หากเปิดใช้ เมื่อสร้างการทดสอบ C++ แบบคงที่และใช้ฟิชชัน ระบบจะสร้างไฟล์ .dwp สำหรับไบนารีของการทดสอบโดยอัตโนมัติด้วย
แท็ก:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated list of options>
ค่าเริ่มต้น: ".pb.h"-
ตั้งค่าคำนำหน้าของไฟล์ส่วนหัวที่ cc_proto_library สร้างขึ้น
แท็ก:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated list of options>
ค่าเริ่มต้น: ".pb.cc"-
ตั้งค่าคำนำหน้าของไฟล์ต้นฉบับที่ cc_proto_library สร้างขึ้น
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
ค่าเริ่มต้น: "false"-
เรียกใช้การดำเนินการเพิ่มเติมสำหรับเวอร์ชัน API ของ Java สำรองใน proto_library
แท็กaffects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
ค่าเริ่มต้น: "false"-
เรียกใช้การดำเนินการเพิ่มเติมสำหรับเวอร์ชัน API ของ Java สำรองใน proto_library
แท็กaffects_outputs
,loading_and_analysis
,experimental
--[no]experimental_run_validations
ค่าเริ่มต้น: "จริง"-
โปรดใช้ --run_validations แทน
แท็ก:execution
,affects_outputs
--[no]experimental_save_feature_state
ค่าเริ่มต้น: "false"-
บันทึกสถานะของฟีเจอร์ที่เปิดใช้และที่ขอเป็นเอาต์พุตของการคอมไพล์
แท็ก:affects_outputs
,experimental
--[no]experimental_use_validation_aspect
ค่าเริ่มต้น: "false"-
ว่าจะเรียกใช้การดำเนินการตรวจสอบโดยใช้แง่มุม (เพื่อความขนานกับการทดสอบ) หรือไม่
แท็ก:execution
,affects_outputs
--fission=<a set of compilation modes>
ค่าเริ่มต้น: "no"-
ระบุโหมดการคอมไพล์ที่ใช้ฟิชชันสำหรับการคอมไพล์และการลิงก์ C++ อาจเป็นชุดค่าผสมใดก็ได้ของ {'fastbuild', 'dbg', 'opt'} หรือค่าพิเศษ 'yes' เพื่อเปิดใช้ทุกโหมด และ 'no' เพื่อปิดใช้ทุกโหมด
แท็กloading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง กฎดั้งเดิมจะเพิ่ม <code>DefaultInfo.files</code> ของการขึ้นต่อกันของข้อมูลลงในไฟล์ที่เรียกใช้ ซึ่งตรงกับลักษณะการทำงานที่แนะนำสำหรับกฎ Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid)
แท็ก:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ให้สร้างป่าซิมลิงก์ของไฟล์ที่เรียกใช้สำหรับที่เก็บภายนอกภายใต้ .runfiles/wsname/external/repo (นอกเหนือจาก .runfiles/repo)
แท็กaffects_outputs
--[no]objc_generate_linkmap
ค่าเริ่มต้น: "false"-
ระบุว่าจะสร้างไฟล์ 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
ค่าเริ่มต้น: "จริง"-
ว่าจะเรียกใช้การดำเนินการตรวจสอบเป็นส่วนหนึ่งของการสร้างหรือไม่ ดู https://bazel.build/rules/rules#validation_actions
แท็ก:execution
,affects_outputs
--[no]save_temps
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ระบบจะบันทึกเอาต์พุตชั่วคราวจาก gcc ซึ่งรวมถึงไฟล์ .s (โค้ดแอสเซมเบลอร์), ไฟล์ .i (C ที่ประมวลผลล่วงหน้า) และไฟล์ .ii (C++ ที่ประมวลผลล่วงหน้า)
แท็ก:affects_outputs
- ตัวเลือกที่ช่วยให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการ ซึ่งจะส่งผลต่อค่าของเอาต์พุตนั้นๆ ไม่ใช่การมีอยู่ของเอาต์พุต
--action_env=<a 'name=value' assignment with an optional value part>
มีการสะสมการใช้งานหลายครั้ง-
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกำหนดค่าเป้าหมาย ตัวแปรอาจระบุตามชื่อ ในกรณีนี้ค่าจะมาจากสภาพแวดล้อมการเรียกใช้ หรือระบุตามคู่ชื่อ=ค่า ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ คุณใช้ตัวเลือกนี้ได้หลายครั้ง สำหรับตัวเลือกที่ระบุไว้สำหรับตัวแปรเดียวกัน ตัวเลือกที่ระบุล่าสุดจะชนะ ส่วนตัวเลือกสำหรับตัวแปรที่แตกต่างกันจะสะสม
แท็กaction_command_lines
--android_cpu=<a string>
ค่าเริ่มต้น: "armeabi-v7a"-
CPU เป้าหมายของ Android
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
ค่าเริ่มต้น: "false"-
สร้างไฟล์การเชื่อมโยงข้อมูลที่เข้ากันได้กับ AndroidX ซึ่งใช้ได้กับ Data Binding v2 เท่านั้น
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
ค่าเริ่มต้น: "false"-
ใช้ Data Binding v2 ของ Android กับอาร์กิวเมนต์ 3.4.0
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
ค่าเริ่มต้น: "ปิด"-
กำหนดว่าจะลิงก์ C++ deps ของกฎ Android แบบไดนามิกหรือไม่เมื่อ cc_binary ไม่ได้สร้างไลบรารีที่ใช้ร่วมกันอย่างชัดเจน "default" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "ทั้งหมด" หมายความว่าระบบจะลิงก์ไลบรารีทั้งหมดแบบไดนามิก "ปิด" หมายความว่าระบบจะลิงก์ไลบรารีทั้งหมดในโหมดแบบคงที่เป็นส่วนใหญ่
แท็ก:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
ค่าเริ่มต้น: "ตามตัวอักษร"-
กำหนดลำดับของไฟล์ Manifest ที่ส่งผ่านไปยังเครื่องมือผสานไฟล์ Manifest สำหรับไบนารี Android ALPHABETICAL หมายความว่าระบบจะจัดเรียงไฟล์ Manifest ตามเส้นทางที่เกี่ยวข้องกับ execroot ALPHABETICAL_BY_CONFIGURATION หมายความว่าระบบจะจัดเรียงไฟล์ Manifest ตามเส้นทางที่สัมพันธ์กับไดเรกทอรีการกำหนดค่าภายในไดเรกทอรีเอาต์พุต DEPENDENCY หมายความว่าไฟล์ Manifest จะเรียงตามลำดับโดยไฟล์ Manifest ของแต่ละไลบรารีจะอยู่ก่อนไฟล์ Manifest ของการอ้างอิง
แท็ก:action_command_lines
,execution
--[no]android_resource_shrinking
ค่าเริ่มต้น: "false"-
เปิดใช้การลดขนาดทรัพยากรสำหรับ APK ของ android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
,loading_and_analysis
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, visionos, watchos, tvos, macos or catalyst>
มีการสะสมการใช้งานหลายครั้ง-
ระบุโหมดบิตโค้ดของ Apple สำหรับขั้นตอนการคอมไพล์ที่กำหนดเป้าหมายเป็นสถาปัตยกรรมของอุปกรณ์ ค่าอยู่ในรูปแบบ "[platform=]mode" โดยแพลตฟอร์ม (ซึ่งต้องเป็น "ios", "macos", "tvos" หรือ "watchos") เป็นตัวเลือก หากระบุไว้ ระบบจะใช้โหมดบิตโค้ดสำหรับแพลตฟอร์มนั้นโดยเฉพาะ หากไม่ระบุ ระบบจะใช้โหมดบิตโค้ดสำหรับทุกแพลตฟอร์ม โหมดต้องเป็น "none", "embedded_markers" หรือ "embedded" ตัวเลือกนี้อาจแสดงหลายครั้ง
แท็กloses_incremental_state
--aspects=<comma-separated list of options>
มีการสะสมการใช้งานหลายครั้ง- รายการแง่มุมที่คั่นด้วยคอมมาที่จะใช้กับเป้าหมายระดับบนสุด ในรายการ หากแอตทริบิวต์ some_aspect ระบุผู้ให้บริการแอตทริบิวต์ที่จำเป็นผ่าน required_aspect_providers แอตทริบิวต์ some_aspect จะทํางานหลังจากแอตทริบิวต์ทุกรายการที่กล่าวถึงก่อนหน้านี้ในรายการแอตทริบิวต์ ซึ่งผู้ให้บริการที่โฆษณาเป็นไปตามผู้ให้บริการแอตทริบิวต์ที่จำเป็นของ some_aspect นอกจากนี้ some_aspect จะทํางานหลังจากแง่มุมที่จําเป็นทั้งหมดที่ระบุโดยแอตทริบิวต์ requires จากนั้น some_aspect จะมีสิทธิ์เข้าถึงค่าของผู้ให้บริการแง่มุมเหล่านั้น <bzl-file-label>%<aspect_name> เช่น '//tools:my_def.bzl%my_aspect' โดยที่ 'my_aspect' เป็นค่าระดับบนสุดจากไฟล์ tools/my_def.bzl
--[no]build_python_zip
ค่าเริ่มต้น: "auto"-
สร้างไฟล์ zip ที่เรียกใช้งาน Python ได้ เปิดใน Windows ปิดในแพลตฟอร์มอื่นๆ
แท็ก:affects_outputs
--catalyst_cpus=<comma-separated list of options>
มีการสะสมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาซึ่งจะใช้สร้างไบนารี Apple Catalyst
แท็ก:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
ค่าเริ่มต้น: "false"-
หากระบุไว้ Bazel จะวัดโค้ด (ใช้การวัดแบบออฟไลน์หากเป็นไปได้) และจะรวบรวมข้อมูลความครอบคลุมระหว่างการทดสอบ โดยจะมีผลเฉพาะเป้าหมายที่ตรงกับ --instrumentation_filter โดยปกติแล้วไม่ควรกำหนดตัวเลือกนี้โดยตรง แต่ควรใช้คำสั่ง "bazel coverage" แทน
แท็กaffects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] ค่าเริ่มต้น: "fastbuild"-
ระบุโหมดที่จะสร้างไบนารี ค่า: 'fastbuild', 'dbg', 'opt'
แท็กaffects_outputs
,action_command_lines
,explicit_in_output_path
--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
,explicit_in_output_path
--cs_fdo_absolute_path=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
ใช้ข้อมูลโปรไฟล์ CSFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อเส้นทางสัมบูรณ์ของไฟล์ ZIP ที่มีไฟล์โปรไฟล์ ไฟล์ LLVM โปรไฟล์แบบดิบ หรือไฟล์ LLVM โปรไฟล์ที่จัดทำดัชนี
แท็กaffects_outputs
--cs_fdo_instrument=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
สร้างไบนารีด้วยการใช้ FDO ที่คำนึงถึงบริบทเป็นเครื่องมือ เมื่อใช้คอมไพเลอร์ Clang/LLVM ระบบจะยอมรับชื่อไดเรกทอรีที่จะทิ้งไฟล์โปรไฟล์ดิบในรันไทม์ด้วย
แท็ก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>
ค่าเริ่มต้น: "default"-
กำหนดว่าจะลิงก์ไบนารี C++ แบบไดนามิกหรือไม่ "default" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "ทั้งหมด" หมายความว่าระบบจะลิงก์ไลบรารีทั้งหมดแบบไดนามิก "ปิด" หมายความว่าระบบจะลิงก์ไลบรารีทั้งหมดในโหมดแบบคงที่เป็นส่วนใหญ่
แท็ก:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าไว้ การใช้ fdo_absolute_profile_path จะทำให้เกิดข้อผิดพลาด
แท็กaffects_outputs
--[no]enable_runfiles
ค่าเริ่มต้น: "auto"-
เปิดใช้ทรีลิงก์สัญลักษณ์ของไฟล์ที่เรียกใช้ โดยค่าเริ่มต้นจะปิดใน Windows และเปิดในแพลตฟอร์มอื่นๆ
แท็กaffects_outputs
--experimental_action_listener=<a build target label>
มีการสะสมการใช้งานหลายครั้ง-
เลิกใช้งานแล้วเพื่อใช้แง่มุมแทน ใช้ action_listener เพื่อแนบ extra_action กับการดำเนินการบิลด์ที่มีอยู่
แท็ก:execution
,experimental
--[no]experimental_android_compress_java_resources
ค่าเริ่มต้น: "false"-
บีบอัดทรัพยากร Java ใน APK
แท็ก:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
ค่าเริ่มต้น: "false"-
ใช้ Data Binding v2 ของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
ค่าเริ่มต้น: "false"-
เปิดใช้การลดขนาดทรัพยากรสำหรับ APK ของ android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
ค่าเริ่มต้น: "false"-
ใช้เครื่องมือ rex เพื่อเขียนไฟล์ dex ใหม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
ค่าเริ่มต้น: "false"-
หากระบุไว้ Bazel จะสร้างข้อมูลความครอบคลุมในการรวบรวมสำหรับไฟล์ที่สร้างขึ้นด้วย
แท็กaffects_outputs
--[no]experimental_convenience_symlinks
ค่าเริ่มต้น: "normal"-
ฟีเจอร์นี้ควบคุมวิธีจัดการลิงก์สัญลักษณ์ที่สะดวก (ลิงก์สัญลักษณ์ที่ปรากฏในพื้นที่ทำงานหลังจากการสร้าง) ค่าที่ใช้ได้
normal (ค่าเริ่มต้น): ระบบจะสร้างหรือลบลิงก์สัญลักษณ์ที่สะดวกแต่ละประเภทตามที่การสร้างกำหนด
clean: ระบบจะลบลิงก์สัญลักษณ์ทั้งหมดโดยไม่มีเงื่อนไข
ignore: ระบบจะไม่เปลี่ยนแปลง Symlink
log_only: สร้างข้อความบันทึกราวกับว่ามีการส่ง "normal" แต่ไม่ได้ดำเนินการใดๆ ในระบบไฟล์จริง (มีประโยชน์สำหรับเครื่องมือ)
โปรดทราบว่าเฉพาะ Symlink ที่ชื่อสร้างขึ้นจากค่าปัจจุบันของ --symlink_prefix เท่านั้นที่จะได้รับผลกระทบ หากคำนำหน้ามีการเปลี่ยนแปลง ระบบจะไม่แตะต้อง Symlink ที่มีอยู่ก่อนแล้ว
แท็กaffects_outputs
--[no]experimental_convenience_symlinks_bep_event
ค่าเริ่มต้น: "false"-
แฟล็กนี้จะควบคุมว่าเราจะโพสต์เหตุการณ์บิวด์ ConvenienceSymlinksIdentified ไปยัง BuildEventProtocol หรือไม่ หากค่าเป็นจริง BuildEventProtocol จะมีรายการสำหรับ convenienceSymlinksIdentified ซึ่งแสดงรายการลิงก์สัญลักษณ์ที่สะดวกทั้งหมดที่สร้างขึ้นในพื้นที่ทำงาน หากเป็นเท็จ รายการ convenienceSymlinksIdentified ใน BuildEventProtocol จะว่างเปล่า
แท็กaffects_outputs
--experimental_multi_cpu=<comma-separated list of options>
มีการสะสมการใช้งานหลายครั้ง-
เลิกใช้งานแล้ว ไม่มีการดำเนินการ
แท็กaffects_outputs
,experimental
--experimental_objc_fastbuild_options=<comma-separated list of options>
ค่าเริ่มต้น: "-O0,-DDEBUG=1"-
ใช้สตริงเหล่านี้เป็นตัวเลือกคอมไพเลอร์ objc fastbuild
แท็กaction_command_lines
--[no]experimental_omitfp
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้ libunwind สำหรับการคลายสแต็ก และคอมไพล์ด้วย -fomit-frame-pointer และ -fasynchronous-unwind-tables
แท็กaction_command_lines
,affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
ค่าเริ่มต้น: "false"-
หากเป็นจริง ระบบจะใช้แพลตฟอร์มเป้าหมายในชื่อไดเรกทอรีเอาต์พุตแทน CPU
แท็ก:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
ค่าเริ่มต้น: "false"-
หากระบุไว้ Bazel จะสร้างข้อมูลแผนที่ความครอบคลุมของ llvm-cov แทน gcov เมื่อเปิดใช้ collect_code_coverage
แท็กchanges_inputs
,affects_outputs
,loading_and_analysis
,experimental
--fat_apk_cpu=<comma-separated list of options>
ค่าเริ่มต้น: "armeabi-v7a"-
การตั้งค่าตัวเลือกนี้จะเปิดใช้ APK แบบ Fat ซึ่งมีไบนารีเนทีฟสำหรับสถาปัตยกรรมเป้าหมายที่ระบุทั้งหมด เช่น --fat_apk_cpu=x86,armeabi-v7a. หากระบุแฟล็กนี้ ระบบจะไม่สนใจ --android_cpu สำหรับการขึ้นต่อกันของกฎ android_binary
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
ค่าเริ่มต้น: "false"-
ว่าจะสร้างการแยก HWASAN หรือไม่
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
สร้างไบนารีด้วยการใช้ FDO เป็นเครื่องมือ เมื่อใช้คอมไพเลอร์ Clang/LLVM ระบบจะยอมรับชื่อไดเรกทอรีที่จะทิ้งไฟล์โปรไฟล์ดิบในรันไทม์ด้วย
แท็ก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>
มีการสะสมการใช้งานหลายครั้ง-
ระบบจะเปิดหรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างในการกำหนดค่าเป้าหมาย การระบุ -<ฟีเจอร์> จะเป็นการปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ ดูเพิ่มเติม --host_features
แท็ก:changes_inputs
,affects_outputs
--[no]force_pic
ค่าเริ่มต้น: "false"-
หากเปิดใช้ การคอมไพล์ C++ ทั้งหมดจะสร้างโค้ดที่ไม่ขึ้นกับตำแหน่ง ("-fPIC") ลิงก์จะเลือกใช้ไลบรารี PIC ที่สร้างไว้ล่วงหน้ามากกว่าไลบรารีที่ไม่ใช่ PIC และลิงก์จะสร้างไฟล์ปฏิบัติการที่ไม่ขึ้นกับตำแหน่ง ("-pie")
แท็ก:loading_and_analysis
,affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
มีการสะสมการใช้งานหลายครั้ง-
ระบุชุดตัวแปรสภาพแวดล้อมที่พร้อมใช้งานสำหรับการดำเนินการที่มีการกำหนดค่าโฮสต์หรือการดำเนินการ ตัวแปรอาจระบุตามชื่อ ในกรณีนี้ค่าจะมาจากสภาพแวดล้อมการเรียกใช้ หรือระบุตามคู่ชื่อ=ค่า ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ คุณใช้ตัวเลือกนี้ได้หลายครั้ง สำหรับตัวเลือกที่ระบุไว้สำหรับตัวแปรเดียวกัน ตัวเลือกที่ระบุล่าสุดจะชนะ ส่วนตัวเลือกสำหรับตัวแปรที่แตกต่างกันจะสะสม
แท็กaction_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
ค่าเริ่มต้น: "opt"-
ระบุโหมดที่จะใช้สร้างเครื่องมือที่ใช้ในระหว่างการสร้าง ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
,action_command_lines
--host_conlyopt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C สำหรับเครื่องมือโฮสต์
แท็ก:action_command_lines
,affects_outputs
--host_copt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง gcc สำหรับเครื่องมือโฮสต์
แท็ก:action_command_lines
,affects_outputs
--host_cpu=<a string>
ค่าเริ่มต้น: ""-
CPU ของโฮสต์
แท็ก:changes_inputs
,affects_outputs
--host_cxxopt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง gcc สำหรับเครื่องมือโฮสต์
แท็ก:action_command_lines
,affects_outputs
--host_features=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบบจะเปิดหรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างในการกำหนดค่า exec การระบุ -<ฟีเจอร์> จะเป็นการปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ
แท็ก:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
ค่าเริ่มต้น: ดูคำอธิบาย-
ลบล้างเวอร์ชัน Python สำหรับการกำหนดค่าโฮสต์ อาจเป็น "PY2" หรือ "PY3"
แท็ก:loading_and_analysis
,affects_outputs
--host_linkopt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง gcc เมื่อลิงก์เครื่องมือโฮสต์
แท็ก: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++ อย่างเลือกเมื่อคอมไพล์ไฟล์บางไฟล์ในการกำหนดค่าโฮสต์หรือการกำหนดค่า Exec ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter หมายถึงรายการรูปแบบนิพจน์ทั่วไปที่รวมและยกเว้น (ดู --instrumentation_filter ด้วย) ส่วน option_1 ถึง option_n หมายถึงตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีคอมมา คุณต้องใส่เครื่องหมายคำพูดพร้อมแบ็กสแลช ตัวเลือกมี @ ได้ แต่จะใช้ @ ตัวแรกเท่านั้นในการแยกสตริง ตัวอย่าง: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 จะเพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ลงในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
,affects_outputs
--host_swiftcopt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง swiftc สำหรับเครื่องมือโฮสต์
แท็ก:action_command_lines
,affects_outputs
--[no]incompatible_avoid_conflict_dlls
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ระบบจะเปลี่ยนชื่อไลบรารีลิงก์แบบไดนามิก (DLL) ของ C++ ทั้งหมดที่สร้างโดย cc_library ใน Windows เป็น name_{hash}.dll โดยที่ hash จะคำนวณตาม RepositoryName และเส้นทางแพ็กเกจของ DLL ตัวเลือกนี้มีประโยชน์เมื่อคุณมีแพ็กเกจเดียวที่ขึ้นอยู่กับ cc_library หลายรายการที่มีชื่อเดียวกัน (เช่น //foo/bar1:utils และ //foo/bar2:utils)
แท็กloading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ระบบจะรวมไดเรกทอรี genfiles เข้ากับไดเรกทอรี bin
แท็ก:affects_outputs
,incompatible_change
--[no]incompatible_use_host_features
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้ --features สำหรับการกำหนดค่าเป้าหมายเท่านั้น และใช้ --host_features สำหรับการกำหนดค่า exec
แท็กchanges_inputs
,affects_outputs
,incompatible_change
--[no]incompatible_use_platforms_repo_for_constraints
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ระบบจะนำการตั้งค่าข้อจำกัดจาก @bazel_tools ออก
แท็ก:affects_outputs
,incompatible_change
--[no]instrument_test_targets
ค่าเริ่มต้น: "false"-
เมื่อเปิดใช้ Coverage จะระบุว่าจะพิจารณากฎการทดสอบที่ใช้เครื่องมือหรือไม่ เมื่อตั้งค่าไว้ ระบบจะใช้เครื่องมือกับกฎการทดสอบที่รวมไว้โดย --instrumentation_filter มิฉะนั้น ระบบจะไม่รวมกฎการทดสอบไว้ในการวัดความครอบคลุมเสมอ
แท็กaffects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
default: "-/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_application ผลลัพธ์คือไบนารีแบบสากลที่มีสถาปัตยกรรมที่ระบุทั้งหมด
แท็ก:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
ค่าเริ่มต้น: "จริง"-
เลิกใช้งานแล้ว ถูกแทนที่ด้วย --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
--[no]objc_debug_with_GLIBCXX
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้และตั้งค่าโหมดการคอมไพล์เป็น "dbg" ให้กำหนด GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC และ GLIBCPP_CONCEPT_CHECKS
แท็กaction_command_lines
--[no]objc_enable_binary_stripping
ค่าเริ่มต้น: "false"-
ระบุว่าจะลบสัญลักษณ์และโค้ดที่ไม่ได้ใช้ในไบนารีที่ลิงก์หรือไม่ ระบบจะทำการลบไบนารีออกหากมีการระบุทั้งแฟล็กนี้และ --compilation_mode=opt
แท็กaction_command_lines
--objccopt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ Objective-C/C++
แท็กaction_command_lines
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง gcc อย่างเลือกสรรเมื่อคอมไพล์ไฟล์บางไฟล์ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter หมายถึงรายการรูปแบบนิพจน์ทั่วไปที่รวมและยกเว้น (ดู --instrumentation_filter ด้วย) ส่วน option_1 ถึง option_n หมายถึงตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีคอมมา คุณต้องใส่เครื่องหมายคำพูดพร้อมแบ็กสแลช ตัวเลือกมี @ ได้ แต่จะใช้ @ ตัวแรกเท่านั้นในการแยกสตริง ตัวอย่าง: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 จะเพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ลงในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
,affects_outputs
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมในการส่งไปยังแบ็กเอนด์ LTO แบบเลือก (ในส่วน --features=thin_lto) เมื่อคอมไพล์ออบเจ็กต์แบ็กเอนด์บางรายการ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดย regex_filter หมายถึงรายการรูปแบบนิพจน์ทั่วไปที่รวมและยกเว้น ส่วน option_1 ถึง option_n หมายถึงตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีคอมมา คุณต้องใส่เครื่องหมายคำพูดพร้อมแบ็กสแลช ตัวเลือกมี @ ได้ แต่จะใช้ @ ตัวแรกเท่านั้นในการแยกสตริง ตัวอย่าง: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 จะเพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ลงในบรรทัดคำสั่งของ LTO Backend ของไฟล์.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 เพื่อเพิ่มประสิทธิภาพเป้าหมายการบิลด์ โปรไฟล์ Propeller ต้องประกอบด้วยไฟล์อย่างน้อย 1 ใน 2 ไฟล์ ได้แก่ โปรไฟล์ cc และโปรไฟล์ ld แฟล็กนี้ยอมรับป้ายกำกับการสร้างซึ่งต้องอ้างอิงไฟล์อินพุตโปรไฟล์ Propeller เช่น ไฟล์ BUILD ที่กำหนดป้ายกำกับใน a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",) อาจต้องเพิ่มคำสั่ง exports_files ลงในแพ็กเกจที่เกี่ยวข้องเพื่อให้ Bazel มองเห็นไฟล์เหล่านี้ ต้องใช้ตัวเลือกในรูปแบบ --propeller_optimize=//a/b:propeller_profile
แท็ก:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
ชื่อเส้นทางสัมบูรณ์ของไฟล์ cc_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพสำหรับ Propeller
แท็กaffects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
ชื่อเส้นทางแบบสัมบูรณ์ของไฟล์ ld_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพของ Propeller
แท็ก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
-
หากเป็นจริง ระบบจะแชร์ไลบรารีเนทีฟที่มีฟังก์ชันการทำงานเหมือนกันในกลุ่มเป้าหมายต่างๆ
แท็ก:loading_and_analysis
,affects_outputs
--[no]stamp
ค่าเริ่มต้น: "false"-
ประทับเวลาไบนารีด้วยวันที่ ชื่อผู้ใช้ ชื่อโฮสต์ ข้อมูลพื้นที่ทำงาน ฯลฯ
แท็ก:affects_outputs
--strip=<always, sometimes or never>
ค่าเริ่มต้น: "บางครั้ง"-
ระบุว่าจะลบไบนารีและไลบรารีที่ใช้ร่วมกันหรือไม่ (ใช้ "-Wl,--strip-debug") ค่าเริ่มต้นของ "sometimes" หมายถึงการลบออกก็ต่อเมื่อ --compilation_mode=fastbuild
แท็กaffects_outputs
--stripopt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง strip เมื่อสร้างไบนารี "<name>.stripped"
แท็ก:action_command_lines
,affects_outputs
--swiftcopt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยังการคอมไพล์ Swift
แท็กaction_command_lines
--symlink_prefix=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
คำนำหน้าที่เพิ่มลงในลิงก์สัญลักษณ์ที่สะดวกซึ่งสร้างขึ้นหลังจากการสร้าง หากไม่ระบุ ค่าเริ่มต้นจะเป็นชื่อของเครื่องมือบิลด์ตามด้วยขีดกลาง หากส่ง '/' จะไม่มีการสร้างลิงก์สัญลักษณ์และไม่มีการแสดงคำเตือน คำเตือน: ฟังก์ชันพิเศษสำหรับ "/" จะเลิกใช้งานในเร็วๆ นี้ โปรดใช้ --experimental_convenience_symlinks=ignore แทน
แท็กaffects_outputs
--tvos_cpus=<comma-separated list of options>
มีการสะสมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาเพื่อสร้างไบนารี Apple tvOS
แท็ก:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
ค่าเริ่มต้น: ดูคำอธิบาย-
เวอร์ชัน tvOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองและอุปกรณ์เป้าหมาย หากไม่ได้ระบุ ให้ใช้ "tvos_sdk_version"
แท็กloses_incremental_state
--visionos_cpus=<comma-separated list of options>
มีการสะสมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาซึ่งจะใช้สร้างไบนารีของ Apple visionOS
แท็ก:loses_incremental_state
,loading_and_analysis
--watchos_cpus=<comma-separated list of options>
มีการสะสมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาซึ่งจะใช้สร้างไบนารีของ Apple watchOS
แท็ก:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
ค่าเริ่มต้น: ดูคำอธิบาย-
เวอร์ชัน watchOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองและอุปกรณ์เป้าหมาย หากไม่ได้ระบุ ให้ใช้ "watchos_sdk_version"
แท็กloses_incremental_state
--xbinary_fdo=<a build target label>
ค่าเริ่มต้น: ดูคำอธิบาย-
ใช้ข้อมูลโปรไฟล์ XbinaryFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อของโปรไฟล์ไบนารีข้ามเริ่มต้น เมื่อใช้ตัวเลือกนี้ร่วมกับ --fdo_instrument/--fdo_optimize/--fdo_profile ตัวเลือกเหล่านั้นจะมีผลเสมอราวกับว่าไม่ได้ระบุ xbinary_fdo
แท็ก:affects_outputs
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้ข้อมูลอินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าสถานะ ฯลฯ)
--auto_cpu_environment_group=<a build target label>
ค่าเริ่มต้น: ""-
ประกาศ environment_group ที่จะใช้ในการแมปค่า CPU กับค่า target_environment โดยอัตโนมัติ
แท็กchanges_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
ค่าเริ่มต้น: "false"-
ตรวจสอบว่าข้อจำกัดด้านการอนุญาตให้ใช้สิทธิที่กำหนดโดยแพ็กเกจที่ขึ้นต่อกันไม่ขัดแย้งกับโหมดการจัดจำหน่ายของเป้าหมายที่กำลังสร้าง โดยค่าเริ่มต้น ระบบจะไม่ตรวจสอบใบอนุญาต
แท็กbuild_file_semantics
--[no]check_visibility
ค่าเริ่มต้น: "จริง"-
หากปิดใช้ ข้อผิดพลาดด้านการมองเห็นในทรัพยากรที่ขึ้นต่อกันของเป้าหมายจะลดระดับเป็นคำเตือน
แท็กbuild_file_semantics
--[no]desugar_for_android
ค่าเริ่มต้น: "จริง"-
จะยกเลิกการเพิ่มน้ำตาลในไบต์โค้ด Java 8 ก่อนที่จะแปลงเป็น DEX หรือไม่
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
ค่าเริ่มต้น: "false"-
เลือกว่าจะรวมไลบรารี Java 8 ที่รองรับไว้ในแอปสำหรับอุปกรณ์รุ่นเดิมหรือไม่
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
ค่าเริ่มต้น: "จริง"-
ตรวจสอบสภาพแวดล้อมที่แต่ละเป้าหมายใช้งานร่วมกันได้ และรายงานข้อผิดพลาดหากเป้าหมายใดมีทรัพยากร Dependency ที่ไม่รองรับสภาพแวดล้อมเดียวกัน
แท็ก:build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs
ค่าเริ่มต้น: "false"-
Flag to help transition from allowing to disallowing srcs-less android_library rules with deps. เราต้องล้างข้อมูลในคลังเพื่อเปิดตัวฟีเจอร์นี้โดยค่าเริ่มต้น
แท็ก:eagerness_to_exit
,loading_and_analysis
--[no]experimental_check_desugar_deps
ค่าเริ่มต้น: "จริง"-
เลือกว่าจะตรวจสอบซ้ำว่าการยกเลิกการเพิ่มน้ำตาลถูกต้องที่ระดับไบนารีของ Android หรือไม่
แท็กeagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<off, warning or error>
ค่าเริ่มต้น: "ปิด"-
เมื่อเปิดใช้ ให้ตรวจสอบว่าการอ้างอิงของ aar_import เสร็จสมบูรณ์หรือไม่ การบังคับใช้นี้อาจทำให้บิลด์ใช้งานไม่ได้ หรืออาจส่งผลให้เกิดคำเตือนเท่านั้น
แท็กloading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
ค่าเริ่มต้น: "default"-
หากเป็นจริง จะตรวจสอบว่าเป้าหมาย Java ประกาศเป้าหมายทั้งหมดที่ใช้โดยตรงเป็นทรัพยากร Dependency อย่างชัดเจน
แท็ก:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
ค่าเริ่มต้น: "false"-
หากเปิดใช้ ให้ตรวจสอบ testonly สำหรับเป้าหมายที่ต้องมีก่อนซึ่งเป็นไฟล์เอาต์พุตโดยค้นหา testonly ของกฎการสร้าง ซึ่งตรงกับการตรวจสอบระดับการเข้าถึง
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
ค่าเริ่มต้น: "false"-
หากเปิดใช้ ระบบจะปิดใช้การใช้กฎ Android ดั้งเดิมโดยตรง โปรดใช้กฎ Starlark Android จาก https://github.com/bazelbuild/rules_android
แท็กeagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
ค่าเริ่มต้น: "false"-
ไม่มีการดำเนินการ เก็บไว้ที่นี่เพื่อให้เข้ากันได้แบบย้อนหลัง
แท็ก:eagerness_to_exit
,incompatible_change
--[no]incompatible_force_strict_header_check_from_starlark
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ให้ตั้งค่าการตรวจสอบส่วนหัวอย่างเข้มงวดใน Starlark API
แท็กloading_and_analysis
,changes_inputs
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง Bazel จะตรวจสอบการรวมส่วนหัวของไดเรกทอรีระดับบนสุดด้วย (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/10047)
แท็ก:loading_and_analysis
,incompatible_change
--[no]strict_filesets
ค่าเริ่มต้น: "false"-
หากเปิดใช้ตัวเลือกนี้ ระบบจะรายงานชุดไฟล์ที่ข้ามขอบเขตแพ็กเกจเป็นข้อผิดพลาด โดยจะใช้ไม่ได้เมื่อปิดใช้ check_fileset_dependencies_recursively
แท็ก:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
ค่าเริ่มต้น: "error"-
หากไม่ได้ปิดไว้ จะตรวจสอบว่าเป้าหมาย proto_library ประกาศเป้าหมายทั้งหมดที่ใช้โดยตรงเป็นทรัพยากร Dependency อย่างชัดเจน
แท็กbuild_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
ค่าเริ่มต้น: "ปิด"-
หากไม่ได้ปิดไว้ จะตรวจสอบว่าเป้าหมาย proto_library ประกาศเป้าหมายทั้งหมดที่ใช้ใน "import public" อย่างชัดเจนว่าส่งออกแล้ว
แท็กbuild_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
ค่าเริ่มต้น: "false"-
หากเป็นจริง คุณต้องประกาศส่วนหัวที่พบผ่านเส้นทางรวมของระบบ (-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
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าไว้และโหมดการคอมไพล์ไม่ใช่ "opt" แอป objc จะมีสิทธิ์ในการแก้ไขข้อบกพร่องเมื่อลงนาม
แท็กchanges_inputs
--ios_signing_cert_name=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
ชื่อใบรับรองที่จะใช้สำหรับการลงนามใน iOS หากไม่ได้ตั้งค่าไว้ ระบบจะกลับไปใช้โปรไฟล์การจัดสรร อาจเป็นค่ากำหนดข้อมูลประจำตัวในพวงกุญแจของใบรับรองหรือ (สตริงย่อย) ของชื่อจริงของใบรับรอง ตามหน้า Man ของ codesign (ข้อมูลประจำตัวในการลงนาม)
แท็ก:action_command_lines
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ในไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE:
--[no]incompatible_config_setting_private_default_visibility
ค่าเริ่มต้น: "false"-
หาก incompatible_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
ค่าเริ่มต้น: "จริง"-
ไม่มีการดำเนินการใดๆ และจะนำออกในเร็วๆ นี้
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ให้บังคับใช้การจำกัดระดับการแชร์ config_setting หากเป็นเท็จ ทุกการตั้งค่า config จะมองเห็นได้สำหรับทุกเป้าหมาย ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่ควบคุมลักษณะการทำงานของสภาพแวดล้อมในการทดสอบหรือเครื่องมือเรียกใช้การทดสอบ
--[no]allow_analysis_failures
ค่าเริ่มต้น: "false"-
หากเป็นจริง การวิเคราะห์เป้าหมายของกฎล้มเหลวจะทำให้เป้าหมายเผยแพร่อินสแตนซ์ของ AnalysisFailureInfo ที่มีคำอธิบายข้อผิดพลาด แทนที่จะทำให้การสร้างล้มเหลว
แท็ก:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
ค่าเริ่มต้น: "2000"-
กำหนดจำนวนการอ้างอิงแบบทรานซิทีฟสูงสุดผ่านแอตทริบิวต์กฎที่มีการเปลี่ยนการกำหนดค่า for_analysis_testing การใช้งานเกินขีดจำกัดนี้จะทำให้เกิดข้อผิดพลาดของกฎ
แท็กloading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
ค่าเริ่มต้น: "false"-
หากเป็นจริง การดำเนินการ dex2oat ที่ล้มเหลวจะทำให้บิลด์หยุดทำงานแทนที่จะเรียกใช้ dex2oat ในระหว่างรันไทม์ของการทดสอบ
แท็ก:loading_and_analysis
,experimental
--[no]check_tests_up_to_date
ค่าเริ่มต้น: "false"-
ไม่ต้องทำการทดสอบ เพียงตรวจสอบว่าการทดสอบเป็นเวอร์ชันล่าสุดหรือไม่ หากผลการทดสอบทั้งหมดเป็นข้อมูลล่าสุด การทดสอบจะเสร็จสมบูรณ์ หากต้องสร้างหรือเรียกใช้การทดสอบ ระบบจะรายงานข้อผิดพลาดและการทดสอบจะไม่สำเร็จ ตัวเลือกนี้หมายถึงลักษณะการทำงานของ --check_up_to_date
แท็กexecution
--[no]experimental_android_use_parallel_dex2oat
ค่าเริ่มต้น: "false"-
ใช้ 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 ครั้งจึงจะผ่านจะมีการทำเครื่องหมายเป็น "ไม่เสถียร" ในสรุปการทดสอบ โดยปกติแล้ว ค่าที่ระบุจะเป็นเพียงจำนวนเต็มหรือสตริง "default" หากเป็นจำนวนเต็ม ระบบจะเรียกใช้การทดสอบทั้งหมดสูงสุด N ครั้ง หากเป็น "default" ระบบจะพยายามทดสอบเพียงครั้งเดียวสำหรับการทดสอบปกติ และ 3 ครั้งสำหรับการทดสอบที่ทำเครื่องหมายอย่างชัดเจนว่าไม่น่าเชื่อถือตามกฎ (แอตทริบิวต์ flaky=1) ไวยากรณ์สำรอง: regex_filter@flaky_test_attempts โดยที่ flaky_test_attempts เป็นดังที่กล่าวไว้ข้างต้น และ regex_filter หมายถึงรายการรูปแบบนิพจน์ทั่วไปที่รวมและยกเว้น (ดู --runs_per_test ด้วย) ตัวอย่าง: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 deflakes all tests in //foo/ except those under foo/bar three times. ตัวเลือกนี้ส่งได้หลายครั้ง อาร์กิวเมนต์ที่ส่งผ่านล่าสุดซึ่งตรงกันจะมีความสำคัญเหนือกว่า หากไม่มีรายการใดตรงกัน ลักษณะการทำงานจะเป็นเหมือนกับ "default" ด้านบน
แท็กexecution
--[no]ios_memleaks
ค่าเริ่มต้น: "false"-
เปิดใช้การตรวจสอบหน่วยความจำรั่วในเป้าหมาย 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">
ค่าเริ่มต้น: "auto"-
จำนวนสูงสุดของงานทดสอบในเครื่องที่จะเรียกใช้พร้อมกัน รับจำนวนเต็มหรือคีย์เวิร์ด ("auto", "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 โดย runs_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" เท่านั้น
แท็กtest_runner
--[no]test_keep_going
ค่าเริ่มต้น: "จริง"-
เมื่อปิดใช้ การทดสอบที่ไม่ผ่านจะทำให้บิลด์ทั้งหมดหยุดทำงาน โดยค่าเริ่มต้น ระบบจะเรียกใช้การทดสอบทั้งหมด แม้ว่าการทดสอบบางรายการจะไม่ผ่านก็ตาม
แท็ก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 test" ที่จะใช้
--tvos_simulator_device=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
อุปกรณ์ที่จะจำลองเมื่อเรียกใช้แอปพลิเคชัน tvOS ในโปรแกรมจำลอง เช่น "Apple TV 1080p" คุณดูรายการอุปกรณ์ได้โดยเรียกใช้ "xcrun simctl list devicetypes" ในเครื่องที่จะเรียกใช้โปรแกรมจำลอง
แท็กtest_runner
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
ค่าเริ่มต้น: ดูคำอธิบาย-
เวอร์ชันของ tvOS ที่จะเรียกใช้ในโปรแกรมจำลองเมื่อเรียกใช้หรือทดสอบ
แท็กtest_runner
--watchos_simulator_device=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
อุปกรณ์ที่จะจำลองเมื่อเรียกใช้แอปพลิเคชัน watchOS ในโปรแกรมจำลอง เช่น "Apple Watch - 38 มม." คุณดูรายการอุปกรณ์ได้โดยเรียกใช้ "xcrun simctl list devicetypes" ในเครื่องที่จะเรียกใช้โปรแกรมจำลอง
แท็กtest_runner
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
ค่าเริ่มต้น: ดูคำอธิบาย-
เวอร์ชันของ watchOS ที่จะเรียกใช้ในเครื่องจำลองเมื่อเรียกใช้หรือทดสอบ
แท็กtest_runner
--[no]zip_undeclared_test_outputs
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ระบบจะเก็บเอาต์พุตการทดสอบที่ไม่ได้ประกาศไว้ในไฟล์ ZIP
แท็ก:test_runner
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพเวลาบิลด์
--[no]collapse_duplicate_defines
ค่าเริ่มต้น: "false"-
เมื่อเปิดใช้ ระบบจะนำ --defines ที่ซ้ำกันออกตั้งแต่เนิ่นๆ ในการสร้าง ซึ่งจะช่วยหลีกเลี่ยงการสูญเสียแคชการวิเคราะห์ที่ไม่จำเป็นสำหรับการสร้างที่เทียบเท่าบางประเภท
แท็ก:loading_and_analysis
,loses_incremental_state
--[no]experimental_filter_library_jar_with_program_jar
ค่าเริ่มต้น: "false"-
กรอง ProGuard ProgramJar เพื่อนำคลาสที่อยู่ใน LibraryJar ออก
แท็กaction_command_lines
--[no]experimental_inmemory_dotd_files
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ระบบจะส่งไฟล์ .d ของ C++ ผ่านหน่วยความจำโดยตรงจากโหนดการสร้างระยะไกลแทนที่จะเขียนลงในดิสก์
แท็กloading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ระบบจะส่งไฟล์การอ้างอิง (.jdeps) ที่สร้างจากการคอมไพล์ Java ผ่านหน่วยความจำโดยตรงจากโหนดการสร้างระยะไกลแทนที่จะเขียนลงในดิสก์
แท็กloading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_objc_include_scanning
ค่าเริ่มต้น: "false"-
ว่าจะทำการสแกนรวมสำหรับ Objective C/C++ หรือไม่
แท็กloading_and_analysis
,execution
,changes_inputs
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
ค่าเริ่มต้น: "false"-
หากเปิดใช้ ฟีเจอร์ parse_headers จะไม่สร้างการดำเนินการคอมไพล์ส่วนหัวแยกต่างหากหากพบแหล่งที่มาที่มีชื่อฐานเดียวกันในเป้าหมายเดียวกัน
แท็ก:loading_and_analysis
,affects_outputs
--[no]experimental_retain_test_configuration_across_testonly
ค่าเริ่มต้น: "false"-
เมื่อเปิดใช้ --trim_test_configuration จะไม่ตัดการกำหนดค่าการทดสอบสำหรับกฎที่ทำเครื่องหมาย testonly=1 ซึ่งมีจุดประสงค์เพื่อลดปัญหาความขัดแย้งในการดำเนินการเมื่อกฎที่ไม่ใช่การทดสอบขึ้นอยู่กับกฎ cc_test จะไม่มีผลหาก --trim_test_configuration เป็นเท็จ
แท็ก:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
ค่าเริ่มต้น: "false"-
หากเปิดใช้ คุณจะใช้ cc_import เวอร์ชัน Starlark ได้
แท็ก:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
ค่าเริ่มต้น: "false"-
จะจำกัดอินพุตให้เหลือเฉพาะการคอมไพล์ C/C++ โดยการแยกวิเคราะห์บรรทัด #include จากไฟล์อินพุตหรือไม่ ซึ่งจะช่วยปรับปรุงประสิทธิภาพและส่วนเพิ่มได้ด้วยการลดขนาดของทรีอินพุตการคอมไพล์ อย่างไรก็ตาม การดำเนินการนี้อาจทำให้บิลด์หยุดทำงานได้เนื่องจากเครื่องมือสแกนการรวมไม่ได้ใช้ความหมายของตัวประมวลผล C ล่วงหน้าอย่างเต็มรูปแบบ โดยเฉพาะอย่างยิ่ง เครื่องมือนี้ไม่เข้าใจคำสั่ง #include แบบไดนามิกและไม่สนใจตรรกะแบบมีเงื่อนไขของตัวประมวลผลล่วงหน้า คุณต้องรับความเสี่ยงของการใช้งานเอง เราจะปิดปัญหาที่เกี่ยวข้องกับการแจ้งว่าไม่เหมาะสมนี้ทั้งหมด
แท็กloading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
ค่าเริ่มต้น: "จริง"-
ทำงานส่วนใหญ่ในการแยก dex สำหรับไฟล์ Jar แต่ละไฟล์
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าไว้ ระบบจะใช้ไฟล์ .d ที่ clang ปล่อยออกมาเพื่อตัดชุดอินพุตที่ส่งไปยังการคอมไพล์ objc
แท็ก:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
ค่าเริ่มต้น: "false"-
เมื่อสร้างเป้าหมาย //a:a ให้ประมวลผลส่วนหัวในเป้าหมายทั้งหมดที่ //a:a ขึ้นอยู่กับ (หากเปิดใช้การประมวลผลส่วนหัวสำหรับเครื่องมือแล้ว)
แท็กexecution
--[no]trim_test_configuration
ค่าเริ่มต้น: "จริง"-
เมื่อเปิดใช้ ตัวเลือกที่เกี่ยวข้องกับการทดสอบจะถูกล้างใต้ระดับบนสุดของบิลด์ เมื่อเปิดใช้ฟีเจอร์นี้ คุณจะสร้างการทดสอบเป็นทรัพยากร Dependency ของกฎที่ไม่ใช่การทดสอบไม่ได้ แต่การเปลี่ยนแปลงตัวเลือกที่เกี่ยวข้องกับการทดสอบจะไม่ทำให้ระบบวิเคราะห์กฎที่ไม่ใช่การทดสอบอีกครั้ง
แท็ก:loading_and_analysis
,loses_incremental_state
--[no]use_singlejar_apkbuilder
ค่าเริ่มต้น: "จริง"-
ตัวเลือกนี้เลิกใช้งานแล้ว ตอนนี้ไม่มีการดำเนินการใดๆ และจะถูกนำออกในเร็วๆ นี้
แท็ก:loading_and_analysis
- ตัวเลือกที่มีผลต่อความละเอียด รูปแบบ หรือตำแหน่งของการบันทึก:
--[no]announce
ค่าเริ่มต้น: "false"-
เลิกใช้งานแล้ว ไม่มีการดำเนินการ
แท็ก:affects_outputs
--[no]experimental_bep_target_summary
ค่าเริ่มต้น: "false"- ระบุว่าจะเผยแพร่เหตุการณ์ TargetSummary หรือไม่
--[no]experimental_build_event_expand_filesets
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ขยายชุดไฟล์ใน BEP เมื่อนำเสนอไฟล์เอาต์พุต
แท็กaffects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้แก้ไขลิงก์สัญลักษณ์ 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_materialize_param_files_directly
ค่าเริ่มต้น: "false"-
หากสร้างไฟล์พารามิเตอร์ ให้เขียนลงในดิสก์โดยตรง
แท็กexecution
--[no]experimental_stream_log_file_uploads
ค่าเริ่มต้น: "false"-
สตรีมการอัปโหลดไฟล์บันทึกไปยังพื้นที่เก็บข้อมูลระยะไกลโดยตรงแทนการเขียนลงในดิสก์
แท็กaffects_outputs
--explain=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
ทำให้ระบบบิลด์อธิบายแต่ละขั้นตอนที่ดำเนินการของบิลด์ ระบบจะเขียนคำอธิบายลงในไฟล์บันทึกที่ระบุ
แท็กaffects_outputs
--[no]legacy_important_outputs
ค่าเริ่มต้น: "จริง"-
ใช้เพื่อระงับการสร้างฟิลด์ important_outputs เดิมในเหตุการณ์ TargetComplete จำเป็นต้องมี important_outputs สำหรับการผสานรวม Bazel กับ ResultStore
แท็กaffects_outputs
--[no]materialize_param_files
ค่าเริ่มต้น: "false"-
เขียนไฟล์พารามิเตอร์ระดับกลางไปยังโครงสร้างเอาต์พุตแม้ว่าจะใช้การดำเนินการระยะไกล มีประโยชน์เมื่อแก้ไขข้อบกพร่องของการดำเนินการ ซึ่งจะแสดงโดย --subcommands และ --verbose_failures
แท็กexecution
--max_config_changes_to_show=<an integer>
ค่าเริ่มต้น: "3"-
เมื่อทิ้งแคชการวิเคราะห์เนื่องจากการเปลี่ยนแปลงตัวเลือกการสร้าง จะแสดงชื่อตัวเลือกที่เปลี่ยนแปลงสูงสุดตามจำนวนที่ระบุ หากระบุหมายเลขเป็น -1 ระบบจะแสดงตัวเลือกทั้งหมดที่มีการเปลี่ยนแปลง
แท็กterminal_output
--max_test_output_bytes=<an integer>
ค่าเริ่มต้น: "-1"-
ระบุขนาดสูงสุดของบันทึกต่อการทดสอบที่สามารถปล่อยออกมาได้เมื่อ --test_output เป็น "errors" หรือ "all" มีประโยชน์ในการหลีกเลี่ยงการทำให้เอาต์พุตมีเสียงรบกวนมากเกินไปจากเอาต์พุตการทดสอบ ส่วนหัวของการทดสอบจะรวมอยู่ในขนาดบันทึก ค่าลบหมายถึงไม่มีขีดจำกัด เอาต์พุตจะเป็นทั้งหมดหรือไม่มีเลย
แท็ก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"-
แสดงผลลัพธ์ของบิลด์ สำหรับแต่ละเป้าหมาย ให้ระบุว่ามีการอัปเดตหรือไม่ และหากมีการอัปเดต ให้ระบุรายการไฟล์เอาต์พุตที่สร้างขึ้น ไฟล์ที่พิมพ์ออกมาจะเป็นสตริงที่สะดวกสำหรับการคัดลอกและวางลงในเชลล์เพื่อเรียกใช้
ตัวเลือกนี้ต้องมีอาร์กิวเมนต์จำนวนเต็ม ซึ่งเป็นจำนวนเป้าหมายขั้นต่ำที่ระบบจะไม่พิมพ์ข้อมูลผลลัพธ์ ดังนั้น 0 จะทำให้ระบบระงับข้อความและ MAX_INT จะทำให้ระบบพิมพ์ผลลัพธ์เสมอ ค่าเริ่มต้นคือ 1
แท็กaffects_outputs
--[no]subcommands
[-s
] ค่าเริ่มต้น: "false"-
แสดงคำสั่งย่อยที่ดำเนินการระหว่างการสร้าง แฟล็กที่เกี่ยวข้อง: --execution_log_json_file, --execution_log_binary_file (สำหรับการบันทึกคำสั่งย่อยลงในไฟล์ในรูปแบบที่เป็นมิตรกับเครื่องมือ)
แท็กterminal_output
--test_output=<summary, errors, all or streamed>
ค่าเริ่มต้น: "summary"-
ระบุโหมดเอาต์พุตที่ต้องการ ค่าที่ใช้ได้คือ "summary" เพื่อแสดงผลเฉพาะสรุปสถานะการทดสอบ, "errors" เพื่อพิมพ์บันทึกการทดสอบสำหรับการทดสอบที่ไม่สำเร็จด้วย, "all" เพื่อพิมพ์บันทึกสำหรับการทดสอบทั้งหมด และ "streamed" เพื่อแสดงผลบันทึกสำหรับการทดสอบทั้งหมดแบบเรียลไทม์ (การดำเนินการนี้จะบังคับให้ทดสอบในเครื่องทีละรายการโดยไม่คำนึงถึงค่า --test_strategy)
แท็กtest_runner
,terminal_output
,execution
--test_summary=<short, terse, detailed, none or testcase>
ค่าเริ่มต้น: "short"-
ระบุรูปแบบที่ต้องการของสรุปการทดสอบ ค่าที่ใช้ได้คือ "short" เพื่อพิมพ์ข้อมูลเกี่ยวกับการทดสอบที่ดำเนินการเท่านั้น, "terse" เพื่อพิมพ์ข้อมูลเกี่ยวกับการทดสอบที่ไม่สำเร็จที่ดำเนินการเท่านั้น, "detailed" เพื่อพิมพ์ข้อมูลโดยละเอียดเกี่ยวกับกรณีทดสอบที่ไม่สำเร็จ, "testcase" เพื่อพิมพ์ข้อมูลสรุปในการแก้ไขกรณีทดสอบ, ไม่พิมพ์ข้อมูลโดยละเอียดเกี่ยวกับกรณีทดสอบที่ไม่สำเร็จ และ "none" เพื่อละเว้นข้อมูลสรุป
แท็กterminal_output
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
ค่าเริ่มต้น: "-.*"-
พิมพ์ข้อมูลการแก้ไขข้อบกพร่องระหว่างการแก้ปัญหา Toolchain โดยแฟล็กจะใช้นิพจน์ทั่วไป ซึ่งจะตรวจสอบกับประเภท Toolchain และเป้าหมายที่เฉพาะเจาะจงเพื่อดูว่าควรแก้ไขข้อบกพร่องของรายการใด คุณคั่นนิพจน์ทั่วไปหลายรายการด้วยคอมมาได้ จากนั้นระบบจะตรวจสอบนิพจน์ทั่วไปแต่ละรายการแยกกัน หมายเหตุ: เอาต์พุตของฟีเจอร์นี้มีความซับซ้อนมากและอาจมีประโยชน์เฉพาะผู้เชี่ยวชาญด้านการแก้ปัญหา Toolchain เท่านั้น
แท็กterminal_output
--[no]verbose_explanations
ค่าเริ่มต้น: "false"-
เพิ่มความละเอียดของคำอธิบายที่ออกหากเปิดใช้ --explain จะไม่มีผลหากไม่ได้เปิดใช้ --explain
แท็กaffects_outputs
--[no]verbose_failures
ค่าเริ่มต้น: "false"-
หากคำสั่งล้มเหลว ให้พิมพ์บรรทัดคำสั่งแบบเต็ม
แท็ก: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
ค่าเริ่มต้น: "false"-
แฟล็กนี้จะเปลี่ยนลักษณะการทำงานเริ่มต้นเพื่อให้ระบบไม่สร้างไฟล์ __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
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง เป้าหมายที่สร้างในการกำหนดค่า Python 2 จะปรากฏภายใต้รูทเอาต์พุตที่มีคำต่อท้าย "-py2" ในขณะที่เป้าหมายที่สร้างสำหรับ Python 3 จะปรากฏในรูทที่ไม่มีคำต่อท้ายที่เกี่ยวข้องกับ Python ซึ่งหมายความว่า Symlink ที่สะดวก `bazel-bin` จะชี้ไปยังเป้าหมาย Python 3 แทนที่จะเป็น Python 2 หากเปิดใช้ตัวเลือกนี้ เราขอแนะนำให้เปิดใช้ `--incompatible_py3_is_default` ด้วย
แท็ก:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง เป้าหมาย `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
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็น "จริง" กฎ Python ดั้งเดิมที่เรียกใช้งานได้จะใช้รันไทม์ Python ที่ระบุโดยชุดเครื่องมือ Python แทนรันไทม์ที่ระบุโดยแฟล็กเดิม เช่น --python_top
แท็ก:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
ค่าเริ่มต้น: ดูคำอธิบาย-
โหมดเวอร์ชันหลักของ Python ซึ่งอาจเป็น `PY2` หรือ `PY3` โปรดทราบว่าเป้าหมาย `py_binary` และ `py_test` จะลบล้างค่านี้ (แม้ว่าจะไม่ได้ระบุเวอร์ชันอย่างชัดเจน) ดังนั้นจึงมักไม่มีเหตุผลมากนักที่จะระบุแฟล็กนี้
แท็กloading_and_analysis
,affects_outputs
,explicit_in_output_path
--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]allow_analysis_cache_discard
ค่าเริ่มต้น: "จริง"-
หากทิ้งแคชการวิเคราะห์เนื่องจากการเปลี่ยนแปลงในระบบบิลด์ การตั้งค่าตัวเลือกนี้เป็น "เท็จ" จะทำให้ Bazel ออกจากระบบแทนที่จะดำเนินการบิลด์ต่อ ตัวเลือกนี้จะไม่มีผลเมื่อตั้งค่า "discard_analysis_cache" ด้วย
แท็กeagerness_to_exit
--[no]build_manual_tests
ค่าเริ่มต้น: "false"- บังคับให้สร้างเป้าหมายการทดสอบที่ติดแท็ก "manual" ระบบจะไม่ประมวลผลการทดสอบ "ด้วยตนเอง" ตัวเลือกนี้จะบังคับให้สร้าง (แต่ไม่บังคับให้เรียกใช้)
--build_tag_filters=<comma-separated list of options>
ค่าเริ่มต้น: ""- ระบุรายการแท็กที่คั่นด้วยคอมมา คุณจะใส่เครื่องหมาย "-" ไว้หน้าแท็กแต่ละรายการหรือไม่ก็ได้เพื่อระบุแท็กที่ยกเว้น ระบบจะสร้างเฉพาะเป้าหมายที่มีแท็กที่รวมไว้อย่างน้อย 1 รายการและไม่มีแท็กที่ยกเว้น ตัวเลือกนี้ไม่มีผลต่อชุดการทดสอบที่ดำเนินการด้วยคำสั่ง "test" ซึ่งจะอยู่ภายใต้ตัวเลือกการกรองการทดสอบ เช่น "--test_tag_filters"
--[no]build_tests_only
ค่าเริ่มต้น: "false"- หากระบุไว้ ระบบจะสร้างเฉพาะกฎ *_test และ test_suite และจะไม่สนใจเป้าหมายอื่นๆ ที่ระบุในบรรทัดคำสั่ง โดยค่าเริ่มต้น ระบบจะสร้างทุกอย่างที่ขอ
--[no]cache_test_results
[-t
] default: "auto"- หากตั้งค่าเป็น "auto" Bazel จะเรียกใช้การทดสอบอีกครั้งก็ต่อเมื่อ (1) Bazel ตรวจพบการเปลี่ยนแปลงในการทดสอบหรือการขึ้นต่อกัน (2) มีการทำเครื่องหมายการทดสอบเป็นภายนอก (3) มีการขอเรียกใช้การทดสอบหลายครั้งด้วย --runs_per_test หรือ(4) การทดสอบล้มเหลวก่อนหน้านี้ หากตั้งค่าเป็น "ใช่" Bazel จะแคชผลการทดสอบทั้งหมด ยกเว้นการทดสอบที่ทำเครื่องหมายเป็นภายนอก หากตั้งค่าเป็น "no" Bazel จะไม่แคชผลการทดสอบใดๆ
--[no]compile_one_dependency
ค่าเริ่มต้น: "false"- คอมไพล์การอ้างอิงเดียวของไฟล์อาร์กิวเมนต์ ซึ่งจะเป็นประโยชน์ในการตรวจสอบไวยากรณ์ของไฟล์ต้นฉบับใน 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
ค่าเริ่มต้น: "false"- ทิ้งแคชการวิเคราะห์ทันทีหลังจากที่ระยะการวิเคราะห์เสร็จสมบูรณ์ ลดการใช้หน่วยความจำลงประมาณ 10% แต่จะทำให้การสร้างที่เพิ่มขึ้นในภายหลังช้าลง
--execution_log_binary_file=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย- บันทึกการเรียกใช้ที่ดำเนินการลงในไฟล์นี้เป็น Spawn Protos ที่คั่นตาม src/main/protobuf/spawn.proto ระบบจะเขียนบันทึกแบบไม่เรียงลำดับก่อน จากนั้นเมื่อสิ้นสุดการเรียกใช้ ระบบจะจัดเรียงบันทึกตามลำดับที่เสถียร (อาจใช้ CPU และหน่วยความจำสูง) แฟล็กที่เกี่ยวข้อง: --execution_log_json_file (รูปแบบ JSON ของข้อความที่เรียงลำดับ), --experimental_execution_log_file (รูปแบบ Protobuf ไบนารีที่ไม่ได้เรียงลำดับ), --subcommands (สําหรับแสดงคําสั่งย่อยในเอาต์พุตของเทอร์มินัล)
--execution_log_json_file=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย- บันทึกการเรียกใช้ Spawn ลงในไฟล์นี้เป็นตัวแทน JSON ของ Spawn Protos ที่คั่นตาม src/main/protobuf/spawn.proto ระบบจะเขียนบันทึกแบบไม่เรียงลำดับก่อน จากนั้นเมื่อสิ้นสุดการเรียกใช้ ระบบจะจัดเรียงบันทึกตามลำดับที่เสถียร (อาจใช้ CPU และหน่วยความจำสูง) แฟล็กที่เกี่ยวข้อง: แฟล็กที่เกี่ยวข้อง: --execution_log_binary_file (รูปแบบ protobuf ไบนารีที่เรียงลำดับ), --experimental_execution_log_file (รูปแบบ protobuf ไบนารีที่ไม่ได้เรียงลำดับ), --subcommands (สำหรับการแสดงคำสั่งย่อยในเอาต์พุตของเทอร์มินัล)
--[no]execution_log_sort
ค่าเริ่มต้น: "จริง"- เลือกว่าจะจัดเรียงบันทึกการดำเนินการหรือไม่ ตั้งค่าเป็น false เพื่อปรับปรุงประสิทธิภาพหน่วยความจำ โดยอาจทำให้บันทึกเรียงตามลำดับที่ไม่แน่นอน
--[no]expand_test_suites
ค่าเริ่มต้น: "จริง"-
ขยายเป้าหมาย test_suite ไปยังการทดสอบที่เป็นส่วนประกอบก่อนการวิเคราะห์ เมื่อเปิดใช้ฟีเจอร์นี้ (ค่าเริ่มต้น) รูปแบบเป้าหมายเชิงลบจะมีผลกับการทดสอบที่อยู่ในชุดการทดสอบ ไม่เช่นนั้นจะไม่มีผล การปิดแฟล็กนี้มีประโยชน์เมื่อใช้แง่มุมระดับบนสุดที่บรรทัดคำสั่ง จากนั้นจะวิเคราะห์เป้าหมาย test_suite ได้
แท็กloading_and_analysis
--[no]experimental_cancel_concurrent_tests
ค่าเริ่มต้น: "false"-
หากเป็นจริง Blaze จะยกเลิกการทดสอบที่ทำงานพร้อมกันในการทดสอบที่สำเร็จครั้งแรก ซึ่งจะมีประโยชน์เมื่อใช้ร่วมกับ --runs_per_test_detects_flakes เท่านั้น
แท็ก:affects_outputs
,loading_and_analysis
--experimental_execution_log_file=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย- บันทึกการเรียกใช้ที่ดำเนินการลงในไฟล์นี้เป็น Spawn Protos ที่คั่นตาม src/main/protobuf/spawn.proto ไฟล์นี้จะเขียนตามลำดับการดำเนินการของ Spawns แฟล็กที่เกี่ยวข้อง: --execution_log_binary_file (รูปแบบไบนารี protobuf ที่เรียงลำดับ), --execution_log_json_file (รูปแบบ JSON ของข้อความที่เรียงลำดับ), --subcommands (สำหรับการแสดงคำสั่งย่อยในเอาต์พุตของเทอร์มินัล)
--[no]experimental_execution_log_spawn_metrics
ค่าเริ่มต้น: "false"- รวมเมตริกการเกิดในบันทึกการเกิดที่ดำเนินการแล้ว
--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
ค่าเริ่มต้น: "false"- เลิกใช้งานแล้วเพื่อใช้แง่มุมแทน กำหนดเวลา extra_actions สำหรับเป้าหมายระดับบนสุดเท่านั้น
--[no]experimental_fetch_all_coverage_outputs
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะดึงข้อมูลไดเรกทอรีข้อมูลความครอบคลุมทั้งหมดสําหรับการทดสอบแต่ละครั้งในระหว่างการเรียกใช้ความครอบคลุม
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
ค่าเริ่มต้น: "false"-
หากเป็นจริง ความครอบคลุมสำหรับ Clang จะสร้างรายงาน LCOV
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
ค่าเริ่มต้น: "จริง"- จะสร้างส่วนหัว J2ObjC แบบขนานกับการแปลง J2ObjC หรือไม่
--[no]experimental_j2objc_shorter_header_path
ค่าเริ่มต้น: "false"-
เลือกว่าจะสร้างเส้นทางส่วนหัวที่สั้นกว่าหรือไม่ (ใช้ "_ios" แทน "_j2objc")
แท็กaffects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
ค่าเริ่มต้น: "javabuilder"- เปิดใช้ classpath ที่ลดลงสำหรับการคอมไพล์ Java
--[no]experimental_limit_android_lint_to_android_constrained_java
ค่าเริ่มต้น: "false"-
จำกัด --experimental_run_android_lint_on_java_rules ให้ใช้กับไลบรารีที่เข้ากันได้กับ Android
แท็กaffects_outputs
--[no]experimental_prioritize_local_actions
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าไว้ การดำเนินการที่เรียกใช้ได้เฉพาะในเครื่องจะได้รับโอกาสแรกในการรับทรัพยากร ส่วนการดำเนินการที่เรียกใช้แบบไดนามิกจะได้รับโอกาสที่ 2 และการดำเนินการแบบสแตนด์อโลนที่เรียกใช้แบบไดนามิกจะได้รับโอกาสสุดท้าย
แท็กexecution
--[no]experimental_run_android_lint_on_java_rules
ค่าเริ่มต้น: "false"-
จะตรวจสอบแหล่งที่มาของ java_* หรือไม่
แท็กaffects_outputs
--[no]explicit_java_test_deps
ค่าเริ่มต้น: "false"- ระบุการขึ้นต่อ JUnit หรือ Hamcrest อย่างชัดเจนใน java_test แทนที่จะรับจาก deps ของ TestRunner โดยไม่ตั้งใจ ขณะนี้ใช้ได้กับ Bazel เท่านั้น
--host_java_launcher=<a build target label>
ค่าเริ่มต้น: ดูคำอธิบาย- ตัวเรียกใช้ Java ที่เครื่องมือใช้ซึ่งจะดำเนินการในระหว่างการสร้าง
--host_javacopt=<a string>
มีการสะสมการใช้งานหลายครั้ง- ตัวเลือกเพิ่มเติมที่จะส่งไปยัง javac เมื่อสร้างเครื่องมือที่เรียกใช้ระหว่างบิลด์
--host_jvmopt=<a string>
มีการสะสมการใช้งานหลายครั้ง- ตัวเลือกเพิ่มเติมที่จะส่งไปยัง Java VM เมื่อสร้างเครื่องมือที่ดำเนินการระหว่างการสร้าง ระบบจะเพิ่มตัวเลือกเหล่านี้ลงในตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
--[no]incompatible_check_sharding_support
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะทำให้การทดสอบที่แยกส่วนล้มเหลวหากโปรแกรมเรียกใช้การทดสอบไม่ได้ระบุว่ารองรับการแยกส่วนโดยการแตะไฟล์ที่เส้นทางใน TEST_SHARD_STATUS_FILE หากเป็นเท็จ โปรแกรมเรียกใช้การทดสอบที่ไม่รองรับการแบ่งพาร์ติชันจะทำให้การทดสอบทั้งหมดทำงานในแต่ละพาร์ติชัน
แท็กincompatible_change
--[no]incompatible_exclusive_test_sandboxed
ค่าเริ่มต้น: "false"-
หากเป็นจริง การทดสอบแบบเฉพาะจะทํางานร่วมกับกลยุทธ์แซนด์บ็อกซ์ เพิ่มแท็ก "local" เพื่อบังคับให้เรียกใช้การทดสอบแบบเฉพาะในเครื่อง
แท็ก:incompatible_change
--[no]incompatible_strict_action_env
ค่าเริ่มต้น: "false"-
หากเป็นจริง 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) ก่อนเริ่มการทดสอบ Implies -test_output=streamed.
ขยายเป็น
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
ค่าเริ่มต้น: "จริง"- สร้างข้อมูลการขึ้นต่อกัน (ตอนนี้คือ classpath เวลาคอมไพล์) ต่อเป้าหมาย Java
--[no]java_header_compilation
ค่าเริ่มต้น: "จริง"- คอมไพล์ ijar จากแหล่งที่มาโดยตรง
--java_language_version=<a string>
ค่าเริ่มต้น: "8"- เวอร์ชันภาษา Java
--java_launcher=<a build target label>
ค่าเริ่มต้น: ดูคำอธิบาย- ตัวเรียกใช้ Java ที่จะใช้เมื่อสร้างไบนารี Java หากตั้งค่าแฟล็กนี้เป็นสตริงว่างเปล่า ระบบจะใช้ตัวเรียกใช้ JDK แอตทริบิวต์ "launcher" จะลบล้างค่าสถานะนี้
--java_runtime_version=<a string>
ค่าเริ่มต้น: "local_jdk"- เวอร์ชันรันไทม์ของ Java
--javacopt=<a string>
มีการสะสมการใช้งานหลายครั้ง- ตัวเลือกเพิ่มเติมที่จะส่งไปยัง javac
--jvmopt=<a string>
มีการสะสมการใช้งานหลายครั้ง- ตัวเลือกเพิ่มเติมที่จะส่งไปยัง Java VM ระบบจะเพิ่มตัวเลือกเหล่านี้ลงในตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
--legacy_main_dex_list_generator=<a build target label>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไบนารีที่จะใช้เพื่อสร้างรายการคลาสที่ต้องอยู่ใน dex หลักเมื่อคอมไพล์ multidex เดิม
--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 ที่พร้อมใช้งาน
--local_extra_resources=<a named float, 'name=value'>
มีการสะสมการใช้งานหลายครั้ง- ตั้งค่าจำนวนทรัพยากรเพิ่มเติมที่ Bazel ใช้ได้ รับคู่สตริง-โฟลต ใช้ได้หลายครั้งเพื่อระบุแหล่งข้อมูลเพิ่มเติมหลายประเภท Bazel จะจำกัดการดำเนินการที่ทำงานพร้อมกันโดยอิงตามทรัพยากรเพิ่มเติมที่มีและทรัพยากรเพิ่มเติมที่จำเป็น การทดสอบสามารถประกาศจำนวนทรัพยากรเพิ่มเติมที่ต้องการได้โดยใช้แท็กในรูปแบบ "resources:<resoucename>:<amount>" ตั้งค่า CPU, RAM และทรัพยากรที่พร้อมใช้งานด้วยแฟล็กนี้ไม่ได้
--local_ram_resources=<an integer, 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% ของ RAM นั้น
--local_termination_grace_seconds=<an integer>
ค่าเริ่มต้น: "15"- เวลารอระหว่างการสิ้นสุดกระบวนการในเครื่องเนื่องจากหมดเวลาและการปิดเครื่องโดยบังคับ
--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>
default: "@bazel_tools//tools/proto:protoc"-
ป้ายกำกับของโปรโตคอมไพเลอร์
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
default: "@bazel_tools//tools/proto:cc_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์โปรโตคอล C++
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์โปรโตคอล j2objc
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
default: "@bazel_tools//tools/proto:java_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ Proto ของ Java
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
default: "@bazel_tools//tools/proto:javalite_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์โปรโตคอล JavaLite
แท็ก:affects_outputs
,loading_and_analysis
--protocopt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยังคอมไพเลอร์ Protobuf
แท็กaffects_outputs
--[no]runs_per_test_detects_flakes
ค่าเริ่มต้น: "false"- หากเป็นจริง ชาร์ดใดก็ตามที่มีการทดสอบ/ความพยายามอย่างน้อย 1 รายการที่ผ่านและมีการทดสอบ/ความพยายามอย่างน้อย 1 รายการที่ไม่ผ่านจะได้รับสถานะไม่น่าเชื่อถือ
--shell_executable=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
เส้นทางแบบสัมบูรณ์ไปยังไฟล์ปฏิบัติการของเชลล์เพื่อให้ Bazel ใช้ หากไม่ได้ตั้งค่านี้ แต่ตั้งค่าตัวแปรสภาพแวดล้อม BAZEL_SH ในการเรียกใช้ Bazel ครั้งแรก (ซึ่งจะเริ่มเซิร์ฟเวอร์ Bazel) Bazel จะใช้ตัวแปรนั้น หากไม่ได้ตั้งค่าทั้ง 2 อย่าง Bazel จะใช้เส้นทางเริ่มต้นที่ฮาร์ดโค้ดไว้โดยขึ้นอยู่กับระบบปฏิบัติการที่ทำงาน (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, ระบบอื่นๆ ทั้งหมด: /bin/bash) โปรดทราบว่าการใช้เชลล์ที่ไม่รองรับ bash อาจทำให้การสร้างล้มเหลวหรือไบนารีที่สร้างขึ้นทำงานล้มเหลว
แท็กloading_and_analysis
--[no]show_loading_progress
ค่าเริ่มต้น: "จริง"- หากเปิดใช้ จะทำให้ Bazel พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ"
--test_arg=<a string>
มีการสะสมการใช้งานหลายครั้ง- ระบุตัวเลือกและอาร์กิวเมนต์เพิ่มเติมที่ควรส่งไปยังไฟล์ปฏิบัติการทดสอบ ใช้ได้หลายครั้งเพื่อระบุอาร์กิวเมนต์หลายรายการ หากมีการเรียกใช้การทดสอบหลายรายการ การทดสอบแต่ละรายการจะได้รับอาร์กิวเมนต์ที่เหมือนกัน ใช้โดยคำสั่ง "bazel test" เท่านั้น
--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
ค่าเริ่มต้น: "false"- ส่งต่อตัวเลือก "ล้มเหลวอย่างรวดเร็ว" ไปยังโปรแกรมเรียกใช้การทดสอบ โปรแกรมเรียกใช้การทดสอบควรหยุดการดำเนินการเมื่อเกิดข้อผิดพลาดครั้งแรก
--test_sharding_strategy=<explicit or disabled>
ค่าเริ่มต้น: "explicit"- ระบุกลยุทธ์สำหรับการแบ่งการทดสอบ: "explicit" เพื่อใช้การแบ่งก็ต่อเมื่อมีแอตทริบิวต์ BUILD "shard_count" "disabled" เพื่อไม่ให้ใช้การแบ่งพาร์ติชันการทดสอบ
--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>
ค่าเริ่มต้น: "8"- เวอร์ชันภาษา Java ที่ใช้ในการเรียกใช้เครื่องมือที่จำเป็นในระหว่างการสร้าง
--tool_java_runtime_version=<a string>
ค่าเริ่มต้น: "remotejdk_11"- เวอร์ชันรันไทม์ของ Java ที่ใช้ในการเรียกใช้เครื่องมือระหว่างการสร้าง
--[no]use_ijars
ค่าเริ่มต้น: "จริง"- หากเปิดใช้ ตัวเลือกนี้จะทำให้การคอมไพล์ Java ใช้ JAR ของอินเทอร์เฟซ ซึ่งจะทําให้การคอมไพล์ที่เพิ่มขึ้นเร็วขึ้น แต่ข้อความแสดงข้อผิดพลาดอาจแตกต่างกัน
ตัวเลือก Canonicalize-flags
รับตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคำสั่งและไคลเอ็นต์แยกวิเคราะห์
--distdir=<a path>
มีการสะสมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาไฟล์เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บจะลิงก์แบบฮาร์ดลิงก์ไฟล์ในกรณีที่แคชตรงกันแทนที่จะคัดลอก ซึ่งมีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL เปลี่ยนแปลงและส่งผลให้มีการดาวน์โหลดซ้ำแม้ว่าแคชจะมีรายการที่ดาวน์โหลดซึ่งมีแฮชเดียวกันก็ตาม ซึ่งใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL ไม่ได้ทำให้ที่เก็บข้อมูลเสียหายซึ่งถูกแคชซ่อนไว้
แท็ก:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ จะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็กexperimental
--experimental_repository_downloader_retries=<an integer>
ค่าเริ่มต้น: "0"-
จำนวนครั้งสูงสุดที่พยายามลองดาวน์โหลดซ้ำเมื่อเกิดข้อผิดพลาด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็กexperimental
--experimental_scale_timeouts=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับขนาดการหมดเวลาทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ ด้วยวิธีนี้ คุณจึงทำให้ที่เก็บข้อมูลภายนอกทำงานในเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็กbazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับการหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลดผ่าน http ตามปัจจัยที่ระบุ
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้มาในระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่ง
--[no]canonicalize_policy
ค่าเริ่มต้น: "false"-
แสดงนโยบายที่แน่นอนหลังจากการขยายและการกรอง หากต้องการให้เอาต์พุตสะอาด จะไม่แสดงอาร์กิวเมนต์คำสั่งที่แปลงเป็นรูปแบบ Canonical เมื่อตั้งค่าตัวเลือกนี้เป็น "จริง" โปรดทราบว่าคำสั่งที่ระบุโดย --for_command จะมีผลกับนโยบายที่กรองแล้ว และหากไม่ได้ระบุคำสั่งใดไว้ คำสั่งเริ่มต้นจะเป็น "build"
แท็ก:affects_outputs
,terminal_output
--[no]show_warnings
ค่าเริ่มต้น: "false"-
ส่งคำเตือนของโปรแกรมแยกวิเคราะห์เอาต์พุตไปยังข้อผิดพลาดมาตรฐาน (เช่น สำหรับตัวเลือก Flag ที่ขัดแย้งกัน)
แท็ก:affects_outputs
,terminal_output
- ตัวเลือกที่มีผลต่อความเข้มงวดของ Bazel ในการบังคับใช้ข้อมูลอินพุตการบิลด์ที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าสถานะ ฯลฯ)
--experimental_repository_hash_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรมีการยืนยันแฮชของไดเรกทอรีที่เก็บเทียบกับค่านี้
แท็ก:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
มีการสะสมการใช้งานหลายครั้ง-
หากมีรายการกฎที่เก็บที่ควรมีการยืนยันแฮชของไดเรกทอรีเอาต์พุต โดยระบุไฟล์ด้วย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้มีผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ในไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
ค่าเริ่มต้น: "จริง"-
แท็ก No-op
:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
ค่าเริ่มต้น: "false"-
หาก incompatible_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
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ให้บังคับใช้การจำกัดระดับการแชร์ config_setting หากเป็นเท็จ ทุกการตั้งค่า config จะมองเห็นได้สำหรับทุกเป้าหมาย ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะได้รับอนุญาตในกราฟการอ้างอิงที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่าถูกยกเลิกในรีจิสทรีที่โมดูลมาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น เวอร์ชันที่ถูกเพิกถอนจะทำให้การแก้ไขล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันที่อนุญาตให้ยกเลิกได้ด้วยตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็กloading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ `error` เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาที่ไม่สำเร็จ, `off` เพื่อปิดใช้การตรวจสอบ หรือ `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน
แท็กloading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าการอ้างอิง `bazel_dep` โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้ว ค่าที่ใช้ได้คือ `off` เพื่อปิดใช้การตรวจสอบ, `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน หรือ `error` เพื่อส่งต่อเป็นความล้มเหลวในการแก้ไข
แท็กloading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นการขึ้นต่อกันของนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท ไม่ว่าค่าของแฟล็กนี้จะเป็นอะไรก็ตาม
แท็กloading_and_analysis
--lockfile_mode=<off, update or error>
ค่าเริ่มต้น: "ปิด"-
ระบุวิธีและจะใช้หรือไม่ใช้ไฟล์ล็อก ค่าที่ใช้ได้คือ `update` เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง, `error` เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่อัปเดต หรือ `off` เพื่อไม่ให้อ่านหรือเขียนไปยังไฟล์ล็อก
แท็กloading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
มีการสะสมการใช้งานหลายครั้ง- แทนที่โมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--registry=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้เพื่อค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับมีความสำคัญ โดยระบบจะค้นหาโมดูลในรีจิสทรีที่อยู่ก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีที่อยู่ถัดไปก็ต่อเมื่อไม่มีโมดูลในรีจิสทรีที่อยู่ก่อนหน้า
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อความละเอียด รูปแบบ หรือตำแหน่งของการบันทึก:
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น ระบบจะจำกัดจำนวนประเภทการดำเนินการไว้ที่ 20 นิโมนิกที่มีจำนวนการดำเนินการที่ดำเนินการแล้วมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับทุกคำช่วยจำ
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปในคำสั่ง Bazel ซึ่งไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากมีเนื้อหา ให้อ่านไฟล์ที่ระบุซึ่งแก้ไขแล้วแทนไฟล์ WORKSPACE
แท็กchanges_inputs
--for_command=<a string>
ค่าเริ่มต้น: "build"-
คำสั่งที่ควรแปลงตัวเลือกเป็นรูปแบบมาตรฐาน
แท็ก:affects_outputs
,terminal_output
--invocation_policy=<a string>
ค่าเริ่มต้น: ""-
ใช้นโยบายการเรียกใช้กับตัวเลือกที่จะแปลงเป็นรูปแบบมาตรฐาน
แท็ก:affects_outputs
,terminal_output
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล
--experimental_downloader_config=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไฟล์เพื่อกำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สำหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ รูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้เป็น URL แทน โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณสามารถระบุคำสั่ง `rewrite` หลายรายการสำหรับ URL เดียวกันได้ และในกรณีนี้ ระบบจะแสดง URL หลายรายการ
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้:
--deleted_packages=<comma-separated list of package names>
ค่าเริ่มต้น: ""- รายการชื่อแพ็กเกจที่คั่นด้วยคอมมา ซึ่งระบบบิลด์จะถือว่าไม่มีอยู่ แม้ว่าจะมองเห็นได้ที่ใดที่หนึ่งในเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ เช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์แล้ว ระบบบิลด์อาจแจ้งข้อผิดพลาดหากพบป้ายกำกับ "//x:y/z" หากรายการ package_path อื่นยังคงระบุป้ายกำกับนั้น การระบุ --deleted_packages x/y จะช่วยหลีกเลี่ยงปัญหานี้ได้
--override_repository=<an equals-separated mapping of repository name to path>
มีการสะสมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--package_path=<colon-separated list of options>
ค่าเริ่มต้น: "%workspace%"- รายการที่คั่นด้วยโคลอนของตำแหน่งที่จะค้นหาแพ็กเกจ องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับเวิร์กสเปซที่ครอบคลุม หากละไว้หรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
--[no]show_loading_progress
ค่าเริ่มต้น: "จริง"- หากเปิดใช้ จะทำให้ Bazel พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ"
ตัวเลือกการล้าง
รับตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคำสั่งและไคลเอ็นต์แยกวิเคราะห์
--distdir=<a path>
มีการสะสมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาไฟล์เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บจะลิงก์แบบฮาร์ดลิงก์ไฟล์ในกรณีที่แคชตรงกันแทนที่จะคัดลอก ซึ่งมีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL เปลี่ยนแปลงและส่งผลให้มีการดาวน์โหลดซ้ำแม้ว่าแคชจะมีรายการที่ดาวน์โหลดซึ่งมีแฮชเดียวกันก็ตาม ซึ่งใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL ไม่ได้ทำให้ที่เก็บข้อมูลเสียหายซึ่งถูกแคชซ่อนไว้
แท็ก:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ จะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็กexperimental
--experimental_repository_downloader_retries=<an integer>
ค่าเริ่มต้น: "0"-
จำนวนครั้งสูงสุดที่พยายามลองดาวน์โหลดซ้ำเมื่อเกิดข้อผิดพลาด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็กexperimental
--experimental_scale_timeouts=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับขนาดการหมดเวลาทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ ด้วยวิธีนี้ คุณจึงทำให้ที่เก็บข้อมูลภายนอกทำงานในเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็กbazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับการหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลดผ่าน http ตามปัจจัยที่ระบุ
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้มาในระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่ง
--[no]async
ค่าเริ่มต้น: "false"-
หากเป็นจริง การล้างข้อมูลเอาต์พุตจะเป็นแบบไม่พร้อมกัน เมื่อคำสั่งนี้เสร็จสมบูรณ์ คุณจะเรียกใช้คำสั่งใหม่ในไคลเอ็นต์เดียวกันได้อย่างปลอดภัย แม้ว่าการลบอาจยังคงดำเนินการในเบื้องหลังต่อไปก็ตาม
แท็กhost_machine_resource_optimizations
--[no]expunge
ค่าเริ่มต้น: "false"-
หากเป็นจริง คำสั่ง clean จะนำทั้ง Working Tree สำหรับอินสแตนซ์ Bazel นี้ออก ซึ่งรวมถึงไฟล์เอาต์พุตการสร้างและไฟล์ชั่วคราวทั้งหมดที่ Bazel สร้างขึ้น และจะหยุดเซิร์ฟเวอร์ Bazel หากกำลังทำงานอยู่
แท็กhost_machine_resource_optimizations
--expunge_async
-
หากระบุไว้ clean จะนำทั้งแผนผังการทำงานของอินสแตนซ์ Bazel นี้ออกแบบอะซิงโครนัส ซึ่งรวมถึงไฟล์เอาต์พุตการสร้างและไฟล์ชั่วคราวทั้งหมดที่ Bazel สร้างขึ้น และจะหยุดเซิร์ฟเวอร์ Bazel หากกำลังทำงานอยู่ เมื่อคำสั่งนี้เสร็จสมบูรณ์ คุณจะเรียกใช้คำสั่งใหม่ในไคลเอ็นต์เดียวกันได้อย่างปลอดภัย แม้ว่าการลบอาจยังคงดำเนินการในเบื้องหลังต่อไปก็ตาม
ขยายเป็น
--expunge
--async
แท็กhost_machine_resource_optimizations
--[no]remove_all_convenience_symlinks
ค่าเริ่มต้น: "false"-
หากเป็นจริง ระบบจะลบ Symlink ทั้งหมดในพื้นที่ทำงานที่มีคำนำหน้า symlink_prefix หากไม่มีแฟล็กนี้ ระบบจะล้างเฉพาะลิงก์สัญลักษณ์ที่มีคำต่อท้ายที่กำหนดไว้ล่วงหน้า
แท็ก:affects_outputs
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้ข้อมูลอินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าสถานะ ฯลฯ)
--experimental_repository_hash_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรมีการยืนยันแฮชของไดเรกทอรีที่เก็บเทียบกับค่านี้
แท็ก:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
มีการสะสมการใช้งานหลายครั้ง-
หากมีรายการกฎที่เก็บที่ควรมีการยืนยันแฮชของไดเรกทอรีเอาต์พุต โดยระบุไฟล์ด้วย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้มีผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ในไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
ค่าเริ่มต้น: "จริง"-
ไม่มีการดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะได้รับอนุญาตในกราฟการอ้างอิงที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่าถูกยกเลิกในรีจิสทรีที่โมดูลมาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น เวอร์ชันที่ถูกเพิกถอนจะทำให้การแก้ไขล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันที่อนุญาตให้ยกเลิกได้ด้วยตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็กloading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ `error` เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาที่ไม่สำเร็จ, `off` เพื่อปิดใช้การตรวจสอบ หรือ `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน
แท็กloading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าการอ้างอิง `bazel_dep` โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้ว ค่าที่ใช้ได้คือ `off` เพื่อปิดใช้การตรวจสอบ, `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน หรือ `error` เพื่อส่งต่อเป็นความล้มเหลวในการแก้ไข
แท็กloading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นการขึ้นต่อกันของนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท ไม่ว่าค่าของแฟล็กนี้จะเป็นอะไรก็ตาม
แท็กloading_and_analysis
--lockfile_mode=<off, update or error>
ค่าเริ่มต้น: "ปิด"-
ระบุวิธีและจะใช้หรือไม่ใช้ไฟล์ล็อก ค่าที่ใช้ได้คือ `update` เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง, `error` เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่อัปเดต หรือ `off` เพื่อไม่ให้อ่านหรือเขียนไปยังไฟล์ล็อก
แท็กloading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
มีการสะสมการใช้งานหลายครั้ง- แทนที่โมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--registry=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้เพื่อค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับมีความสำคัญ โดยระบบจะค้นหาโมดูลในรีจิสทรีที่อยู่ก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีที่อยู่ถัดไปก็ต่อเมื่อไม่มีโมดูลในรีจิสทรีที่อยู่ก่อนหน้า
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อความละเอียด รูปแบบ หรือตำแหน่งของการบันทึก:
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น ระบบจะจำกัดจำนวนประเภทการดำเนินการไว้ที่ 20 นิโมนิกที่มีจำนวนการดำเนินการที่ดำเนินการแล้วมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับทุกคำช่วยจำ
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปในคำสั่ง Bazel ซึ่งไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้อ่านไฟล์ที่ระบุซึ่งแก้ไขแล้วแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
--experimental_downloader_config=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไฟล์เพื่อกำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สำหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ รูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้เป็น URL แทน โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณสามารถระบุคำสั่ง `rewrite` หลายรายการสำหรับ URL เดียวกันได้ และในกรณีนี้ ระบบจะแสดง URL หลายรายการ
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้:
--override_repository=<an equals-separated mapping of repository name to path>
มีการสะสมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุเริ่มต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
ตัวเลือกการกำหนดค่า
ตัวเลือกความครอบคลุม
รับค่าตัวเลือกทั้งหมดจาก test
- ตัวเลือกที่ปรากฏก่อนคำสั่งและไคลเอ็นต์แยกวิเคราะห์
--distdir=<a path>
มีการสะสมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาไฟล์เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บจะลิงก์แบบฮาร์ดลิงก์ไฟล์ในกรณีที่แคชตรงกันแทนที่จะคัดลอก ซึ่งมีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL เปลี่ยนแปลงและส่งผลให้มีการดาวน์โหลดซ้ำแม้ว่าแคชจะมีรายการที่ดาวน์โหลดซึ่งมีแฮชเดียวกันก็ตาม ซึ่งใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL ไม่ได้ทำให้ที่เก็บข้อมูลเสียหายซึ่งถูกแคชซ่อนไว้
แท็ก:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ จะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็กexperimental
--experimental_repository_downloader_retries=<an integer>
ค่าเริ่มต้น: "0"-
จำนวนครั้งสูงสุดที่พยายามลองดาวน์โหลดซ้ำเมื่อเกิดข้อผิดพลาด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็กexperimental
--experimental_scale_timeouts=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับขนาดการหมดเวลาทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ ด้วยวิธีนี้ คุณจึงทำให้ที่เก็บข้อมูลภายนอกทำงานในเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็กbazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับการหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลดผ่าน http ตามปัจจัยที่ระบุ
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้มาในระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้ข้อมูลอินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าสถานะ ฯลฯ):
--experimental_repository_hash_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรมีการยืนยันแฮชของไดเรกทอรีที่เก็บเทียบกับค่านี้
แท็ก:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
มีการสะสมการใช้งานหลายครั้ง-
หากมีรายการกฎที่เก็บที่ควรมีการยืนยันแฮชของไดเรกทอรีเอาต์พุต โดยระบุไฟล์ด้วย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้มีผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ในไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
ค่าเริ่มต้น: "จริง"-
ไม่มีการดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะได้รับอนุญาตในกราฟการอ้างอิงที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่าถูกยกเลิกในรีจิสทรีที่โมดูลมาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น เวอร์ชันที่ถูกเพิกถอนจะทำให้การแก้ไขล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันที่อนุญาตให้ยกเลิกได้ด้วยตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็กloading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ `error` เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาที่ไม่สำเร็จ, `off` เพื่อปิดใช้การตรวจสอบ หรือ `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน
แท็กloading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าการอ้างอิง `bazel_dep` โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้ว ค่าที่ใช้ได้คือ `off` เพื่อปิดใช้การตรวจสอบ, `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน หรือ `error` เพื่อส่งต่อเป็นความล้มเหลวในการแก้ไข
แท็กloading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นการขึ้นต่อกันของนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท ไม่ว่าค่าของแฟล็กนี้จะเป็นอะไรก็ตาม
แท็กloading_and_analysis
--lockfile_mode=<off, update or error>
ค่าเริ่มต้น: "ปิด"-
ระบุวิธีและจะใช้หรือไม่ใช้ไฟล์ล็อก ค่าที่ใช้ได้คือ `update` เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง, `error` เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่อัปเดต หรือ `off` เพื่อไม่ให้อ่านหรือเขียนไปยังไฟล์ล็อก
แท็กloading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
มีการสะสมการใช้งานหลายครั้ง- แทนที่โมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--registry=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้เพื่อค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับมีความสำคัญ โดยระบบจะค้นหาโมดูลในรีจิสทรีที่อยู่ก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีที่อยู่ถัดไปก็ต่อเมื่อไม่มีโมดูลในรีจิสทรีที่อยู่ก่อนหน้า
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อความละเอียด รูปแบบ หรือตำแหน่งของการบันทึก:
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น ระบบจะจำกัดจำนวนประเภทการดำเนินการไว้ที่ 20 นิโมนิกที่มีจำนวนการดำเนินการที่ดำเนินการแล้วมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับทุกคำช่วยจำ
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปในคำสั่ง Bazel ซึ่งไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้อ่านไฟล์ที่ระบุซึ่งแก้ไขแล้วแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
--experimental_downloader_config=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไฟล์เพื่อกำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สำหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ รูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้เป็น URL แทน โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณสามารถระบุคำสั่ง `rewrite` หลายรายการสำหรับ URL เดียวกันได้ และในกรณีนี้ ระบบจะแสดง URL หลายรายการ
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้:
--override_repository=<an equals-separated mapping of repository name to path>
มีการสะสมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุเริ่มต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
ตัวเลือก Cquery
รับค่าตัวเลือกทั้งหมดจาก test
- ตัวเลือกที่ปรากฏก่อนคำสั่งและไคลเอ็นต์แยกวิเคราะห์
--distdir=<a path>
มีการสะสมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาไฟล์เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บจะลิงก์แบบฮาร์ดลิงก์ไฟล์ในกรณีที่แคชตรงกันแทนที่จะคัดลอก ซึ่งมีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL เปลี่ยนแปลงและส่งผลให้มีการดาวน์โหลดซ้ำแม้ว่าแคชจะมีรายการที่ดาวน์โหลดซึ่งมีแฮชเดียวกันก็ตาม ซึ่งใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL ไม่ได้ทำให้ที่เก็บข้อมูลเสียหายซึ่งถูกแคชซ่อนไว้
แท็ก:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ จะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็กexperimental
--experimental_repository_downloader_retries=<an integer>
ค่าเริ่มต้น: "0"-
จำนวนครั้งสูงสุดที่พยายามลองดาวน์โหลดซ้ำเมื่อเกิดข้อผิดพลาด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็กexperimental
--experimental_scale_timeouts=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับขนาดการหมดเวลาทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ ด้วยวิธีนี้ คุณจึงทำให้ที่เก็บข้อมูลภายนอกทำงานในเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็กbazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับการหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลดผ่าน http ตามปัจจัยที่ระบุ
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้มาในระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้ข้อมูลอินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าสถานะ ฯลฯ):
--experimental_repository_hash_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรมีการยืนยันแฮชของไดเรกทอรีที่เก็บเทียบกับค่านี้
แท็ก:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
มีการสะสมการใช้งานหลายครั้ง-
หากมีรายการกฎที่เก็บที่ควรมีการยืนยันแฮชของไดเรกทอรีเอาต์พุต โดยระบุไฟล์ด้วย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้มีผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ในไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
ค่าเริ่มต้น: "จริง"-
ไม่มีการดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและการตีความหมายของคำค้นหา
--aspect_deps=<off, conservative or precise>
ค่าเริ่มต้น: "ระมัดระวัง"-
วิธีแก้ไขการขึ้นต่อกันของแง่มุมเมื่อรูปแบบเอาต์พุตเป็นหนึ่งใน {xml,proto,record} "off" หมายความว่าจะไม่มีการแก้ไขการขึ้นต่อกันของแง่มุม "conservative" (ค่าเริ่มต้น) หมายความว่าจะมีการเพิ่มการขึ้นต่อกันของแง่มุมที่ประกาศทั้งหมดไม่ว่าจะมีคลาสกฎของการขึ้นต่อกันโดยตรงหรือไม่ก็ตาม "precise" หมายความว่าจะมีการเพิ่มเฉพาะแง่มุมที่อาจใช้งานได้เมื่อพิจารณาจากคลาสกฎของการขึ้นต่อกันโดยตรง โปรดทราบว่าโหมดที่แม่นยำต้องโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียว จึงทำให้ช้ากว่าโหมดอื่นๆ โปรดทราบว่าแม้ในโหมดที่แม่นยำก็ยังไม่แม่นยำโดยสมบูรณ์ เนื่องจากระบบจะตัดสินใจว่าจะคำนวณแง่มุมใดในระยะการวิเคราะห์ ซึ่งไม่ได้ทำงานระหว่าง "bazel query"
แท็กbuild_file_semantics
--[no]consistent_labels
ค่าเริ่มต้น: "false"-
หากเปิดใช้ คำสั่งการค้นหาทุกคำสั่งจะปล่อยป้ายกำกับออกมาเหมือนกับฟังก์ชัน <code>str</code> ของ Starlark ที่ใช้กับอินสแตนซ์ <code>Label</code> ซึ่งจะเป็นประโยชน์สำหรับเครื่องมือที่ต้องจับคู่เอาต์พุตของคำสั่งการค้นหาและ/หรือป้ายกำกับต่างๆ ที่กฎปล่อยออกมา หากไม่ได้เปิดใช้ ตัวจัดรูปแบบเอาต์พุตจะสามารถปล่อยชื่อที่เก็บที่ชัดเจน (เทียบกับที่เก็บหลัก) แทนเพื่อให้เอาต์พุตอ่านง่ายขึ้น
แท็กterminal_output
--[no]graph:factored
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ระบบจะส่งกราฟที่ "แยกตัวประกอบ" กล่าวคือ ระบบจะผสานโหนดที่เทียบเท่ากันในเชิงโทโพโลยีเข้าด้วยกันและต่อป้ายกำกับของโหนดเหล่านั้น ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็กterminal_output
--graph:node_limit=<an integer>
ค่าเริ่มต้น: "512"-
ความยาวสูงสุดของสตริงป้ายกำกับสำหรับโหนดกราฟในเอาต์พุต ระบบจะตัดป้ายกำกับที่ยาวเกินไป โดย -1 หมายถึงไม่มีการตัด ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็กterminal_output
--[no]implicit_deps
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ระบบจะรวมทรัพยากร Dependency โดยนัยไว้ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน การขึ้นต่อกันโดยนัยคือการขึ้นต่อกันที่ไม่ได้ระบุอย่างชัดเจนในไฟล์ BUILD แต่ Bazel เพิ่มให้ สำหรับ cquery ตัวเลือกนี้จะควบคุมการกรอง Toolchain ที่แก้ไขแล้ว
แท็กbuild_file_semantics
--[no]include_aspects
ค่าเริ่มต้น: "จริง"-
aquery, cquery: whether to include aspect-generated actions in the output. query: no-op (aspects are always followed).
แท็กterminal_output
--[no]incompatible_display_source_file_location
ค่าเริ่มต้น: "จริง"-
ค่าเริ่มต้นเป็น "จริง" ซึ่งจะแสดงเป้าหมายของไฟล์ต้นฉบับ หากจริง จะแสดงตำแหน่งของบรรทัดที่ 1 ของไฟล์แหล่งที่มาในเอาต์พุตตำแหน่ง โดยแฟล็กนี้มีไว้เพื่อวัตถุประสงค์ในการย้ายข้อมูลเท่านั้น
แท็ก:terminal_output
,incompatible_change
--[no]incompatible_package_group_includes_double_slash
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ เมื่อส่งออกแอตทริบิวต์ `packages` ของ package_group ระบบจะไม่ละเว้น `//` ที่นำหน้า
แท็ก:terminal_output
,incompatible_change
--[no]infer_universe_scope
ค่าเริ่มต้น: "false"-
หากตั้งค่าและไม่ได้ตั้งค่า --universe_scope ระบบจะอนุมานค่าของ --universe_scope เป็นรายการรูปแบบเป้าหมายที่ไม่ซ้ำกันในนิพจน์การค้นหา โปรดทราบว่าค่า --universe_scope ที่อนุมานสำหรับนิพจน์การค้นหาที่ใช้ฟังก์ชันระดับจักรวาล (เช่น `allrdeps`) อาจไม่ใช่สิ่งที่คุณต้องการ ดังนั้นคุณควรใช้ตัวเลือกนี้เฉพาะในกรณีที่คุณทราบว่ากำลังทำอะไรอยู่ ดูรายละเอียดและตัวอย่างได้ที่ https://bazel.build/reference/query#sky-query หากตั้งค่า --universe_scope ระบบจะไม่สนใจค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้ใช้ได้กับ `query` เท่านั้น (ไม่ใช่ `cquery`)
แท็ก:loading_and_analysis
--[no]line_terminator_null
ค่าเริ่มต้น: "false"-
ไม่ว่าจะสิ้นสุดแต่ละรูปแบบด้วย \0 แทนการขึ้นบรรทัดใหม่
แท็กterminal_output
--[no]nodep_deps
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ระบบจะรวมการอ้างอิงจากแอตทริบิวต์ "nodep" ไว้ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ตัวอย่างทั่วไปของแอตทริบิวต์ "nodep" คือ "visibility" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ `info build-language` เพื่อดูข้อมูลเกี่ยวกับแอตทริบิวต์ "nodep" ทั้งหมดในภาษาบิลด์
แท็กbuild_file_semantics
--output=<a string>
ค่าเริ่มต้น: "label"-
รูปแบบที่ควรพิมพ์ผลลัพธ์ของ cquery ค่าที่อนุญาตสำหรับ cquery คือ label, label_kind, textproto, transitions, proto, jsonproto หากเลือก "การเปลี่ยนฉาก" คุณต้องระบุตัวเลือก --transitions=(lite|full) ด้วย
แท็กterminal_output
--[no]proto:default_values
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ระบบจะรวมแอตทริบิวต์ที่ไม่ได้ระบุค่าอย่างชัดเจนในไฟล์ BUILD ไว้ด้วย มิฉะนั้นจะละเว้น ตัวเลือกนี้ใช้ได้กับ --output=proto
แท็ก:terminal_output
--[no]proto:definition_stack
ค่าเริ่มต้น: "false"-
ป้อนข้อมูลฟิลด์ Proto ของ definition_stack ซึ่งจะบันทึกสแต็กการเรียก Starlark สำหรับอินสแตนซ์ของกฎแต่ละรายการ ณ เวลาที่กำหนดคลาสของกฎ
แท็กterminal_output
--[no]proto:flatten_selects
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ระบบจะทำให้แอตทริบิวต์ที่กำหนดค่าได้ซึ่งสร้างโดย select() แบนราบ สำหรับประเภทรายการ การแสดงแบบ Flatten คือรายการที่มีค่าของแผนที่ที่เลือกแต่ละค่าเพียงครั้งเดียว ระบบจะทำให้ประเภทสเกลาร์แบนเป็นค่าว่าง
แท็กbuild_file_semantics
--[no]proto:include_configurations
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ เอาต์พุตโปรโตคอลจะมีข้อมูลเกี่ยวกับการกำหนดค่า เมื่อปิดใช้ รูปแบบเอาต์พุตของ cquery proto จะคล้ายกับรูปแบบเอาต์พุตของคำค้นหา
แท็กaffects_outputs
--[no]proto:include_synthetic_attribute_hash
ค่าเริ่มต้น: "false"-
จะคำนวณและสร้างแอตทริบิวต์ $internal_attr_hash หรือไม่
แท็กterminal_output
--[no]proto:instantiation_stack
ค่าเริ่มต้น: "false"-
สร้างสแต็กการเรียกอินสแตนซ์ของแต่ละกฎ โปรดทราบว่าต้องมีสแต็กจึงจะดำเนินการนี้ได้
แท็กterminal_output
--[no]proto:locations
ค่าเริ่มต้น: "จริง"-
จะแสดงข้อมูลตำแหน่งในเอาต์พุต Proto หรือไม่
แท็กterminal_output
--proto:output_rule_attrs=<comma-separated list of options>
ค่าเริ่มต้น: "all"-
รายการแอตทริบิวต์ที่คั่นด้วยคอมมาที่จะรวมไว้ในเอาต์พุต ค่าเริ่มต้นคือแอตทริบิวต์ทั้งหมด ตั้งค่าเป็นสตริงว่างเปล่าเพื่อไม่ให้แสดงแอตทริบิวต์ใดๆ ตัวเลือกนี้ใช้ได้กับ --output=proto
แท็กterminal_output
--[no]proto:rule_inputs_and_outputs
ค่าเริ่มต้น: "จริง"-
จะป้อนข้อมูลในช่อง rule_input และ rule_output หรือไม่
แท็กterminal_output
--query_file=<a string>
ค่าเริ่มต้น: ""-
หากตั้งค่าไว้ การค้นหาจะอ่านการค้นหาจากไฟล์ที่ตั้งชื่อไว้ที่นี่ แทนที่จะอ่านจากบรรทัดคำสั่ง การระบุไฟล์ที่นี่รวมถึงการค้นหาในบรรทัดคำสั่งถือเป็นข้อผิดพลาด
แท็กchanges_inputs
--[no]relative_locations
ค่าเริ่มต้น: "false"-
หากเป็นจริง ตำแหน่งของไฟล์ BUILD ในเอาต์พุต XML และ Proto จะเป็นแบบสัมพัทธ์ โดยค่าเริ่มต้น เอาต์พุตตำแหน่งจะเป็นเส้นทางที่สมบูรณ์และจะไม่สอดคล้องกันในเครื่องต่างๆ คุณสามารถตั้งค่าตัวเลือกนี้เป็น "จริง" เพื่อให้ได้ผลลัพธ์ที่สอดคล้องกันในเครื่องต่างๆ
แท็กterminal_output
--show_config_fragments=<off, direct or transitive>
ค่าเริ่มต้น: "ปิด"-
แสดงส่วนการกำหนดค่าที่กฎและทรัพยากร Dependency แบบทรานซิทีฟของกฎนั้นต้องการ ซึ่งจะเป็นประโยชน์ในการประเมินว่ากราฟเป้าหมายที่กำหนดค่าไว้สามารถตัดออกได้มากน้อยเพียงใด
แท็กaffects_outputs
--starlark:expr=<a string>
ค่าเริ่มต้น: ""-
นิพจน์ Starlark เพื่อจัดรูปแบบเป้าหมายที่กำหนดค่าแต่ละรายการในโหมด --output=starlark ของ cquery เป้าหมายที่กำหนดค่าจะเชื่อมโยงกับ "target" หากไม่ได้ระบุทั้ง --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
ค่าเริ่มต้น: "จริง"-
คำค้นหา: หากปิดใช้ ระบบจะไม่รวมการอ้างอิงเป้าหมาย "การกำหนดค่าโฮสต์" หรือ "การดำเนินการ" ไว้ในกราฟการอ้างอิงที่คำค้นหาดำเนินการ ขอบเขตการพึ่งพา "การกำหนดค่าโฮสต์" เช่น ขอบเขตจากกฎ "proto_library" ไปยังคอมไพเลอร์โปรโตคอล มักจะชี้ไปยังเครื่องมือที่ดำเนินการในระหว่างการบิลด์แทนที่จะเป็นส่วนหนึ่งของโปรแกรม "เป้าหมาย" เดียวกัน
Cquery: หากปิดใช้ ระบบจะกรองเป้าหมายที่กำหนดค่าทั้งหมดซึ่งข้ามโฮสต์หรือการเปลี่ยนการดำเนินการจากเป้าหมายระดับบนสุดที่ค้นพบเป้าหมายที่กำหนดค่านี้ ซึ่งหมายความว่าหากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าเป้าหมาย ระบบจะแสดงเฉพาะเป้าหมายที่กำหนดค่าซึ่งอยู่ในกำหนดค่าเป้าหมายด้วย หากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าโฮสต์ ระบบจะแสดงเฉพาะเป้าหมายที่กำหนดค่าโฮสต์ ตัวเลือกนี้จะไม่ยกเว้น Toolchain ที่แก้ไขแล้ว
แท็กbuild_file_semantics
--transitions=<full, lite or none>
ค่าเริ่มต้น: "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>` ที่จะได้รับอนุญาตในกราฟการอ้างอิงที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่าถูกยกเลิกในรีจิสทรีที่โมดูลมาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น เวอร์ชันที่ถูกเพิกถอนจะทำให้การแก้ไขล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันที่อนุญาตให้ยกเลิกได้ด้วยตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็กloading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ `error` เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาที่ไม่สำเร็จ, `off` เพื่อปิดใช้การตรวจสอบ หรือ `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน
แท็กloading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าการอ้างอิง `bazel_dep` โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้ว ค่าที่ใช้ได้คือ `off` เพื่อปิดใช้การตรวจสอบ, `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน หรือ `error` เพื่อส่งต่อเป็นความล้มเหลวในการแก้ไข
แท็กloading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นการขึ้นต่อกันของนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท ไม่ว่าค่าของแฟล็กนี้จะเป็นอะไรก็ตาม
แท็กloading_and_analysis
--lockfile_mode=<off, update or error>
ค่าเริ่มต้น: "ปิด"-
ระบุวิธีและจะใช้หรือไม่ใช้ไฟล์ล็อก ค่าที่ใช้ได้คือ `update` เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง, `error` เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่อัปเดต หรือ `off` เพื่อไม่ให้อ่านหรือเขียนไปยังไฟล์ล็อก
แท็กloading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
มีการสะสมการใช้งานหลายครั้ง- แทนที่โมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--registry=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้เพื่อค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับมีความสำคัญ โดยระบบจะค้นหาโมดูลในรีจิสทรีที่อยู่ก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีที่อยู่ถัดไปก็ต่อเมื่อไม่มีโมดูลในรีจิสทรีที่อยู่ก่อนหน้า
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อความละเอียด รูปแบบ หรือตำแหน่งของการบันทึก:
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น ระบบจะจำกัดจำนวนประเภทการดำเนินการไว้ที่ 20 นิโมนิกที่มีจำนวนการดำเนินการที่ดำเนินการแล้วมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับทุกคำช่วยจำ
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปในคำสั่ง Bazel ซึ่งไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้อ่านไฟล์ที่ระบุซึ่งแก้ไขแล้วแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
--experimental_downloader_config=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไฟล์เพื่อกำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สำหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ รูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้เป็น URL แทน โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณสามารถระบุคำสั่ง `rewrite` หลายรายการสำหรับ URL เดียวกันได้ และในกรณีนี้ ระบบจะแสดง URL หลายรายการ
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้:
--override_repository=<an equals-separated mapping of repository name to path>
มีการสะสมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุเริ่มต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
--[no]experimental_inprocess_symlink_creation
ค่าเริ่มต้น: "false"-
จะเรียกใช้ระบบไฟล์โดยตรงเพื่อสร้างโครงสร้างซิมลิงก์หรือไม่
แท็ก:loading_and_analysis
,execution
,experimental
--[no]experimental_remotable_source_manifests
ค่าเริ่มต้น: "false"-
จะทำให้การดำเนินการกับไฟล์ Manifest ต้นฉบับสามารถดำเนินการจากระยะไกลได้หรือไม่
แท็ก:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะเรียกใช้การประมวลผลภายหลังของ Coverage สำหรับการทดสอบในกระบวนการใหม่
แท็กexecution
--[no]experimental_strict_fileset_output
ค่าเริ่มต้น: "false"-
หากเปิดใช้ตัวเลือกนี้ ชุดไฟล์จะถือว่าอาร์ติแฟกต์เอาต์พุตทั้งหมดเป็นไฟล์ปกติ โดยจะไม่ข้ามไดเรกทอรีหรือคำนึงถึงลิงก์สัญลักษณ์
แท็กexecution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
ค่าเริ่มต้น: ""-
เพิ่มหรือนำคีย์ออกจากข้อมูลการดำเนินการของแอ็กชันตามคำช่วยจำของแอ็กชัน ใช้กับการดำเนินการที่รองรับข้อมูลการดำเนินการเท่านั้น การดำเนินการทั่วไปหลายอย่างรองรับข้อมูลการดำเนินการ เช่น Genrule, CppCompile, Javac, StarlarkAction, TestRunner เมื่อระบุค่าหลายค่า ลำดับมีความสำคัญเนื่องจากนิพจน์ทั่วไปจำนวนมากอาจใช้กับตัวช่วยจำเดียวกัน
ไวยากรณ์: "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 อย่างต่อเนื่องโดยใช้ Worker
ขยายเป็น
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
แท็กhost_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
เปิดใช้ตัวประมวลผลทรัพยากร Android แบบถาวรโดยใช้ Worker
ขยายเป็น
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
แท็กhost_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
เปิดใช้การดำเนินการ dex และ desugar ของ Android แบบหลายรายการที่ต่อเนื่องโดยใช้ Worker
ขยายเป็น:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
เปิดใช้ตัวประมวลผลทรัพยากร Android แบบมัลติเพล็กซ์ถาวรโดยใช้ Worker
ขยายเป็น
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
แท็กhost_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
เปิดใช้เครื่องมือ Android แบบถาวรและแบบมัลติเพล็กซ์ (dexing, desugaring, การประมวลผลทรัพยากร)
ขยายเป็น:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
แท็ก:host_machine_resource_optimizations
,execution
- ตัวเลือกที่กำหนดค่าเครื่องมือที่ใช้สำหรับการดำเนินการ:
--android_compiler=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
คอมไพเลอร์เป้าหมายของ Android
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
default: "//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 Flag to help thetransition to the Android manifest merger from the legacy merger.
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
ค่าเริ่มต้น: ""-
ตั้งค่าแพลตฟอร์มที่เป้าหมาย android_binary ใช้ หากระบุหลายแพลตฟอร์ม ไบนารีจะเป็น APK แบบ Fat ซึ่งมีไบนารีแบบเนทีฟสำหรับแต่ละแพลตฟอร์มเป้าหมายที่ระบุ
แท็กchanges_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
default: "@bazel_tools//tools/android:sdk"-
ระบุ Android SDK/แพลตฟอร์มที่ใช้สร้างแอปพลิเคชัน Android
แท็กchanges_inputs
,loading_and_analysis
,loses_incremental_state
--apple_compiler=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
คอมไพเลอร์เป้าหมายของ Apple มีประโยชน์สำหรับการเลือกตัวแปรของ Toolchain (เช่น xcode-beta)
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
default: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้ในกฎ Apple และ Objc รวมถึงการอ้างอิงของกฎเหล่านั้น
แท็ก:loses_incremental_state
,changes_inputs
--apple_grte_top=<a build target label>
ค่าเริ่มต้น: ดูคำอธิบาย-
เป้าหมาย Apple grte_top
แท็กchanges_inputs
,loading_and_analysis
,loses_incremental_state
--cc_output_directory_tag=<a string>
ค่าเริ่มต้น: ""-
ระบุคำต่อท้ายที่จะเพิ่มลงในไดเรกทอรีการกำหนดค่า
แท็ก:affects_outputs
,explicit_in_output_path
--compiler=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
คอมไพเลอร์ C++ ที่จะใช้คอมไพล์เป้าหมาย
แท็ก:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
default: "@bazel_tools//tools/test:lcov_merger"-
ตำแหน่งของไบนารีที่ใช้ในการประมวลผลรายงานความครอบคลุมดิบ ปัจจุบันต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งก็คือไบนารี ค่าเริ่มต้นคือ "//tools/test:lcov_merger"
แท็กchanges_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
default: "@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>
default: "@bazel_tools//tools/test:coverage_support"-
ตำแหน่งของไฟล์สนับสนุนที่จำเป็นในอินพุตของการดำเนินการทดสอบทุกครั้งที่รวบรวมความครอบคลุมของโค้ด ค่าเริ่มต้นคือ "//tools/test:coverage_support"
แท็กchanges_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
default: "@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 รายการ ระบบจะดำเนินการความละเอียดของเครื่องมือราวกับว่าได้ประกาศค่าข้อจำกัดเป็นข้อจำกัดในการดำเนินการ ตัวอย่าง: //demo,-test=@platforms//cpus:x86_64 จะเพิ่ม "x86_64" ให้กับเป้าหมายใดก็ตามภายใต้ //demo ยกเว้นเป้าหมายที่มีชื่อซึ่งมี "test"
แท็กloading_and_analysis
--[no]experimental_enable_objc_cc_deps
ค่าเริ่มต้น: "จริง"-
อนุญาตให้กฎ objc_* ขึ้นอยู่กับ cc_library และทำให้มีการสร้างการอ้างอิง objc ใดๆ โดยตั้งค่า --cpu เป็น "ios_<--ios_cpu>" สำหรับค่าใดๆ ใน --ios_multi_cpu
แท็ก:loading_and_analysis
,incompatible_change
--[no]experimental_include_xcode_execution_requirements
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ให้เพิ่มข้อกำหนดในการดำเนินการ "requires-xcode:{version}" ลงในการดำเนินการ Xcode ทุกรายการ หากเวอร์ชัน xcode มีป้ายกำกับที่มีขีดกลาง ให้เพิ่มข้อกำหนดในการดำเนินการ "requires-xcode-label:{version_label}" ด้วย
แท็กloses_incremental_state
,loading_and_analysis
,execution
--[no]experimental_prefer_mutual_xcode
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ให้ใช้ 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 คุณระบุ Toolchain ได้โดยใช้เป้าหมายที่แน่นอนหรือรูปแบบเป้าหมาย ระบบจะพิจารณา Toolchain เหล่านี้ก่อน Toolchain ที่ประกาศไว้ในไฟล์ WORKSPACE โดย register_toolchains()
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
ค่าเริ่มต้น: ดูคำอธิบาย-
ป้ายกำกับสำหรับไลบรารี libc ที่เช็คอินแล้ว ค่าเริ่มต้นจะเลือกโดยเครื่องมือ Crosstool Toolchain และคุณแทบจะไม่ต้องลบล้างค่านี้
แท็ก:action_command_lines
,affects_outputs
--host_compiler=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
คอมไพเลอร์ C++ ที่จะใช้สำหรับการคอมไพล์โฮสต์ ระบบจะไม่สนใจหากไม่ได้ตั้งค่า --host_crosstool_top
แท็ก:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
ค่าเริ่มต้น: ดูคำอธิบาย-
โดยค่าเริ่มต้น ระบบจะใช้ตัวเลือก --crosstool_top และ --compiler กับการกำหนดค่าโฮสต์ด้วย หากมีการระบุแฟล็กนี้ Bazel จะใช้ libc และคอมไพเลอร์เริ่มต้นสำหรับ crosstool_top ที่ระบุ
แท็กloading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
ค่าเริ่มต้น: ดูคำอธิบาย-
หากระบุไว้ การตั้งค่านี้จะลบล้างไดเรกทอรีระดับบนสุดของ libc (--grte_top) สำหรับการกำหนดค่าโฮสต์
แท็ก:action_command_lines
,affects_outputs
--host_platform=<a build target label>
ค่าเริ่มต้น: ""-
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายระบบโฮสต์
แท็กaffects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง Bazel จะไม่อนุญาตให้ระบุ expand_if_all_available ใน flag_sets(ดูวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/7008)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง Bazel จะไม่เปิดใช้ฟีเจอร์ "โฮสต์" และ "ไม่ใช่โฮสต์" ในเครื่องมือ C++ (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/7407)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
ค่าเริ่มต้น: "false"-
ใช้การแก้ปัญหา Toolchain เพื่อเลือก Android SDK สำหรับกฎ Android (Starlark และเนทีฟ)
แท็กloading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
ค่าเริ่มต้น: "false"-
ใช้การแก้ปัญหา Toolchain เพื่อเลือก Apple SDK สำหรับกฎของ Apple (Starlark และเนทีฟ)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง Bazel จะไม่นำบรรทัดคำสั่งการดำเนินการลิงก์ C++ กลับมาใช้ซ้ำสำหรับบรรทัดคำสั่งการจัดทำดัชนี LTO (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/6791)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง Bazel จะแจ้งข้อผิดพลาดเมื่อตั้งค่าแอตทริบิวต์ cc_toolchain.cpu และ cc_toolchain.compiler (ดูวิธีการย้ายข้อมูลได้ที่ https://github.com/bazelbuild/bazel/issues/7075)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง Bazel จะไม่ลิงก์ทรัพยากร Dependency ของไลบรารีเป็นทั้งอาร์ไคฟ์โดยค่าเริ่มต้น (ดูวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/7362)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง Bazel จะกำหนดให้มีพารามิเตอร์ "ctx" ใน cc_common.configure_features (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/7793)
แท็ก:loading_and_analysis
,incompatible_change
-
ใช้ออบเจ็กต์ที่แชร์ของอินเทอร์เฟซหากชุดเครื่องมือรองรับ ปัจจุบัน 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 หากไม่ได้ระบุ ให้ใช้ SDK เวอร์ชันเริ่มต้นของ iOS จาก "xcode_version"
แท็กloses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุเวอร์ชันของ macOS SDK ที่จะใช้ในการสร้างแอปพลิเคชัน macOS หากไม่ได้ระบุไว้ ให้ใช้ SDK เวอร์ชันเริ่มต้นของ macOS จาก "xcode_version"
แท็กloses_incremental_state
--minimum_os_version=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
เวอร์ชันระบบปฏิบัติการขั้นต่ำที่การคอมไพล์ของคุณกำหนดเป้าหมาย
แท็ก:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
ค่าเริ่มต้น: ""-
ตำแหน่งของไฟล์แมปที่อธิบายว่าควรใช้แพลตฟอร์มใดหากไม่ได้ตั้งค่า หรือควรตั้งค่า Flag ใดเมื่อมีแพลตฟอร์มอยู่แล้ว ต้องสัมพันธ์กับรูทของพื้นที่ทำงานหลัก ค่าเริ่มต้นคือ "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
--target_platform_fallback=<a build target label>
default: "@local_config_platform//:host"-
ป้ายกำกับของกฎแพลตฟอร์มที่ควรใช้หากไม่ได้ตั้งค่าแพลตฟอร์มเป้าหมายและไม่มีการแมปแพลตฟอร์มที่ตรงกับชุดค่าสถานะปัจจุบัน
แท็กaffects_outputs
,changes_inputs
,loading_and_analysis
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุเวอร์ชันของ tvOS SDK ที่จะใช้ในการสร้างแอปพลิเคชัน tvOS หากไม่ได้ระบุ ระบบจะใช้ SDK เวอร์ชันเริ่มต้นของ tvOS จาก "xcode_version"
แท็กloses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุเวอร์ชันของ watchOS SDK ที่จะใช้ในการสร้างแอปพลิเคชัน watchOS หากไม่ได้ระบุ ให้ใช้ SDK เวอร์ชันเริ่มต้นของ watchOS จาก "xcode_version"
แท็กloses_incremental_state
--xcode_version=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
หากระบุไว้ จะใช้ Xcode เวอร์ชันที่กำหนดสำหรับการดำเนินการบิลด์ที่เกี่ยวข้อง หากไม่ได้ระบุ ระบบจะใช้ Xcode เวอร์ชันเริ่มต้นของตัวดำเนินการ
แท็กloses_incremental_state
--xcode_version_config=<a build target label>
default: "@bazel_tools//tools/cpp:host_xcodes"-
ป้ายกำกับของกฎ xcode_config ที่จะใช้ในการเลือกเวอร์ชัน Xcode ในการกำหนดค่าบิลด์
แท็ก:loses_incremental_state
,loading_and_analysis
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่ง
--[no]apple_enable_auto_dsym_dbg
ค่าเริ่มต้น: "false"-
เลือกว่าจะบังคับให้เปิดใช้การสร้างไฟล์สัญลักษณ์สำหรับแก้ไขข้อบกพร่อง (.dSYM) สำหรับบิลด์ dbg หรือไม่
แท็ก:affects_outputs
,action_command_lines
--[no]apple_generate_dsym
ค่าเริ่มต้น: "false"-
จะสร้างไฟล์สัญลักษณ์สำหรับแก้ไขข้อบกพร่อง (.dSYM) หรือไม่
แท็ก:affects_outputs
,action_command_lines
--[no]build_runfile_links
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ให้สร้างป่าซิมลิงก์ของไฟล์ที่เรียกใช้ได้สำหรับเป้าหมายทั้งหมด หากเป็นเท็จ ให้เขียนเฉพาะไฟล์ Manifest เมื่อเป็นไปได้
แท็กaffects_outputs
--[no]build_runfile_manifests
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ให้เขียนไฟล์ Manifest ของไฟล์ที่เรียกใช้สำหรับเป้าหมายทั้งหมด หากเป็นเท็จ ให้ละเว้น การทดสอบในเครื่องจะเรียกใช้ไม่สำเร็จเมื่อเป็นเท็จ
แท็กaffects_outputs
--[no]build_test_dwp
ค่าเริ่มต้น: "false"-
หากเปิดใช้ เมื่อสร้างการทดสอบ C++ แบบคงที่และใช้ฟิชชัน ระบบจะสร้างไฟล์ .dwp สำหรับไบนารีของการทดสอบโดยอัตโนมัติด้วย
แท็ก:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated list of options>
ค่าเริ่มต้น: ".pb.h"-
ตั้งค่าคำนำหน้าของไฟล์ส่วนหัวที่ cc_proto_library สร้างขึ้น
แท็ก:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated list of options>
ค่าเริ่มต้น: ".pb.cc"-
ตั้งค่าคำนำหน้าของไฟล์ต้นฉบับที่ cc_proto_library สร้างขึ้น
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
ค่าเริ่มต้น: "false"-
เรียกใช้การดำเนินการเพิ่มเติมสำหรับเวอร์ชัน API ของ Java สำรองใน proto_library
แท็กaffects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
ค่าเริ่มต้น: "false"-
เรียกใช้การดำเนินการเพิ่มเติมสำหรับเวอร์ชัน API ของ Java สำรองใน proto_library
แท็กaffects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
ค่าเริ่มต้น: "false"-
บันทึกสถานะของฟีเจอร์ที่เปิดใช้และที่ขอเป็นเอาต์พุตของการคอมไพล์
แท็ก:affects_outputs
,experimental
--fission=<a set of compilation modes>
ค่าเริ่มต้น: "no"-
ระบุโหมดการคอมไพล์ที่ใช้ฟิชชันสำหรับการคอมไพล์และการลิงก์ C++ อาจเป็นชุดค่าผสมใดก็ได้ของ {'fastbuild', 'dbg', 'opt'} หรือค่าพิเศษ 'yes' เพื่อเปิดใช้ทุกโหมด และ 'no' เพื่อปิดใช้ทุกโหมด
แท็กloading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง กฎดั้งเดิมจะเพิ่ม <code>DefaultInfo.files</code> ของการขึ้นต่อกันของข้อมูลลงในไฟล์ที่เรียกใช้ ซึ่งตรงกับลักษณะการทำงานที่แนะนำสำหรับกฎ Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid)
แท็ก:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ให้สร้างป่าซิมลิงก์ของไฟล์ที่เรียกใช้สำหรับที่เก็บภายนอกภายใต้ .runfiles/wsname/external/repo (นอกเหนือจาก .runfiles/repo)
แท็กaffects_outputs
--[no]objc_generate_linkmap
ค่าเริ่มต้น: "false"-
ระบุว่าจะสร้างไฟล์ Linkmap หรือไม่
แท็กaffects_outputs
--[no]save_temps
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ระบบจะบันทึกเอาต์พุตชั่วคราวจาก gcc ซึ่งรวมถึงไฟล์ .s (โค้ดแอสเซมเบลอร์), ไฟล์ .i (C ที่ประมวลผลล่วงหน้า) และไฟล์ .ii (C++ ที่ประมวลผลล่วงหน้า)
แท็ก:affects_outputs
- ตัวเลือกที่ช่วยให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการ ซึ่งจะส่งผลต่อค่าของเอาต์พุตนั้นๆ ไม่ใช่การมีอยู่ของเอาต์พุต
--action_env=<a 'name=value' assignment with an optional value part>
มีการสะสมการใช้งานหลายครั้ง-
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกำหนดค่าเป้าหมาย ตัวแปรอาจระบุตามชื่อ ในกรณีนี้ค่าจะมาจากสภาพแวดล้อมการเรียกใช้ หรือระบุตามคู่ชื่อ=ค่า ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ คุณใช้ตัวเลือกนี้ได้หลายครั้ง สำหรับตัวเลือกที่ระบุไว้สำหรับตัวแปรเดียวกัน ตัวเลือกที่ระบุล่าสุดจะชนะ ส่วนตัวเลือกสำหรับตัวแปรที่แตกต่างกันจะสะสม
แท็กaction_command_lines
--android_cpu=<a string>
ค่าเริ่มต้น: "armeabi-v7a"-
CPU เป้าหมายของ Android
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
ค่าเริ่มต้น: "false"-
สร้างไฟล์การเชื่อมโยงข้อมูลที่เข้ากันได้กับ AndroidX ซึ่งใช้ได้กับ Data Binding v2 เท่านั้น
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
ค่าเริ่มต้น: "false"-
ใช้ Data Binding v2 ของ Android กับอาร์กิวเมนต์ 3.4.0
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
ค่าเริ่มต้น: "ปิด"-
กำหนดว่าจะลิงก์ C++ deps ของกฎ Android แบบไดนามิกหรือไม่เมื่อ cc_binary ไม่ได้สร้างไลบรารีที่ใช้ร่วมกันอย่างชัดเจน "default" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "ทั้งหมด" หมายความว่าระบบจะลิงก์ไลบรารีทั้งหมดแบบไดนามิก "ปิด" หมายความว่าระบบจะลิงก์ไลบรารีทั้งหมดในโหมดแบบคงที่เป็นส่วนใหญ่
แท็ก:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
ค่าเริ่มต้น: "ตามตัวอักษร"-
กำหนดลำดับของไฟล์ Manifest ที่ส่งผ่านไปยังเครื่องมือผสานไฟล์ Manifest สำหรับไบนารี Android ALPHABETICAL หมายความว่าระบบจะจัดเรียงไฟล์ Manifest ตามเส้นทางที่เกี่ยวข้องกับ execroot ALPHABETICAL_BY_CONFIGURATION หมายความว่าระบบจะจัดเรียงไฟล์ Manifest ตามเส้นทางที่สัมพันธ์กับไดเรกทอรีการกำหนดค่าภายในไดเรกทอรีเอาต์พุต DEPENDENCY หมายความว่าไฟล์ Manifest จะเรียงตามลำดับโดยไฟล์ Manifest ของแต่ละไลบรารีจะอยู่ก่อนไฟล์ Manifest ของการอ้างอิง
แท็ก:action_command_lines
,execution
--[no]android_resource_shrinking
ค่าเริ่มต้น: "false"-
เปิดใช้การลดขนาดทรัพยากรสำหรับ APK ของ android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
,loading_and_analysis
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, visionos, watchos, tvos, macos or catalyst>
มีการสะสมการใช้งานหลายครั้ง-
ระบุโหมดบิตโค้ดของ Apple สำหรับขั้นตอนการคอมไพล์ที่กำหนดเป้าหมายเป็นสถาปัตยกรรมของอุปกรณ์ ค่าอยู่ในรูปแบบ "[platform=]mode" โดยแพลตฟอร์ม (ซึ่งต้องเป็น "ios", "macos", "tvos" หรือ "watchos") เป็นตัวเลือก หากระบุไว้ ระบบจะใช้โหมดบิตโค้ดสำหรับแพลตฟอร์มนั้นโดยเฉพาะ หากไม่ระบุ ระบบจะใช้โหมดบิตโค้ดสำหรับทุกแพลตฟอร์ม โหมดต้องเป็น "none", "embedded_markers" หรือ "embedded" ตัวเลือกนี้อาจแสดงหลายครั้ง
แท็กloses_incremental_state
--[no]build_python_zip
ค่าเริ่มต้น: "auto"-
สร้างไฟล์ zip ที่เรียกใช้งาน Python ได้ เปิดใน Windows ปิดในแพลตฟอร์มอื่นๆ
แท็ก:affects_outputs
--catalyst_cpus=<comma-separated list of options>
มีการสะสมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาซึ่งจะใช้สร้างไบนารี Apple Catalyst
แท็ก:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
ค่าเริ่มต้น: "false"-
หากระบุไว้ Bazel จะวัดโค้ด (ใช้การวัดแบบออฟไลน์หากเป็นไปได้) และจะรวบรวมข้อมูลความครอบคลุมระหว่างการทดสอบ โดยจะมีผลเฉพาะเป้าหมายที่ตรงกับ --instrumentation_filter โดยปกติแล้วไม่ควรกำหนดตัวเลือกนี้โดยตรง แต่ควรใช้คำสั่ง "bazel coverage" แทน
แท็กaffects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] ค่าเริ่มต้น: "fastbuild"-
ระบุโหมดที่จะสร้างไบนารี ค่า: 'fastbuild', 'dbg', 'opt'
แท็กaffects_outputs
,action_command_lines
,explicit_in_output_path
--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
,explicit_in_output_path
--cs_fdo_absolute_path=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
ใช้ข้อมูลโปรไฟล์ CSFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อเส้นทางสัมบูรณ์ของไฟล์ ZIP ที่มีไฟล์โปรไฟล์ ไฟล์ LLVM โปรไฟล์แบบดิบ หรือไฟล์ LLVM โปรไฟล์ที่จัดทำดัชนี
แท็กaffects_outputs
--cs_fdo_instrument=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
สร้างไบนารีด้วยการใช้ FDO ที่คำนึงถึงบริบทเป็นเครื่องมือ เมื่อใช้คอมไพเลอร์ Clang/LLVM ระบบจะยอมรับชื่อไดเรกทอรีที่จะทิ้งไฟล์โปรไฟล์ดิบในรันไทม์ด้วย
แท็ก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>
ค่าเริ่มต้น: "default"-
กำหนดว่าจะลิงก์ไบนารี C++ แบบไดนามิกหรือไม่ "default" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "ทั้งหมด" หมายความว่าระบบจะลิงก์ไลบรารีทั้งหมดแบบไดนามิก "ปิด" หมายความว่าระบบจะลิงก์ไลบรารีทั้งหมดในโหมดแบบคงที่เป็นส่วนใหญ่
แท็ก:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าไว้ การใช้ fdo_absolute_profile_path จะทำให้เกิดข้อผิดพลาด
แท็กaffects_outputs
--[no]enable_runfiles
ค่าเริ่มต้น: "auto"-
เปิดใช้ทรีลิงก์สัญลักษณ์ของไฟล์ที่เรียกใช้ โดยค่าเริ่มต้นจะปิดใน Windows และเปิดในแพลตฟอร์มอื่นๆ
แท็กaffects_outputs
--experimental_action_listener=<a build target label>
มีการสะสมการใช้งานหลายครั้ง-
เลิกใช้งานแล้วเพื่อใช้แง่มุมแทน ใช้ action_listener เพื่อแนบ extra_action กับการดำเนินการบิลด์ที่มีอยู่
แท็ก:execution
,experimental
--[no]experimental_android_compress_java_resources
ค่าเริ่มต้น: "false"-
บีบอัดทรัพยากร Java ใน APK
แท็ก:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
ค่าเริ่มต้น: "false"-
ใช้ Data Binding v2 ของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
ค่าเริ่มต้น: "false"-
เปิดใช้การลดขนาดทรัพยากรสำหรับ APK ของ android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
ค่าเริ่มต้น: "false"-
ใช้เครื่องมือ rex เพื่อเขียนไฟล์ dex ใหม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
ค่าเริ่มต้น: "false"-
หากระบุไว้ Bazel จะสร้างข้อมูลความครอบคลุมในการรวบรวมสำหรับไฟล์ที่สร้างขึ้นด้วย
แท็กaffects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
ค่าเริ่มต้น: "-O0,-DDEBUG=1"-
ใช้สตริงเหล่านี้เป็นตัวเลือกคอมไพเลอร์ objc fastbuild
แท็กaction_command_lines
--[no]experimental_omitfp
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้ libunwind สำหรับการคลายสแต็ก และคอมไพล์ด้วย -fomit-frame-pointer และ -fasynchronous-unwind-tables
แท็กaction_command_lines
,affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
ค่าเริ่มต้น: "false"-
หากเป็นจริง ระบบจะใช้แพลตฟอร์มเป้าหมายในชื่อไดเรกทอรีเอาต์พุตแทน CPU
แท็ก:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
ค่าเริ่มต้น: "false"-
หากระบุไว้ Bazel จะสร้างข้อมูลแผนที่ความครอบคลุมของ llvm-cov แทน gcov เมื่อเปิดใช้ collect_code_coverage
แท็กchanges_inputs
,affects_outputs
,loading_and_analysis
,experimental
--fat_apk_cpu=<comma-separated list of options>
ค่าเริ่มต้น: "armeabi-v7a"-
การตั้งค่าตัวเลือกนี้จะเปิดใช้ APK แบบ Fat ซึ่งมีไบนารีเนทีฟสำหรับสถาปัตยกรรมเป้าหมายที่ระบุทั้งหมด เช่น --fat_apk_cpu=x86,armeabi-v7a. หากระบุแฟล็กนี้ ระบบจะไม่สนใจ --android_cpu สำหรับการขึ้นต่อกันของกฎ android_binary
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
ค่าเริ่มต้น: "false"-
ว่าจะสร้างการแยก HWASAN หรือไม่
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
สร้างไบนารีด้วยการใช้ FDO เป็นเครื่องมือ เมื่อใช้คอมไพเลอร์ Clang/LLVM ระบบจะยอมรับชื่อไดเรกทอรีที่จะทิ้งไฟล์โปรไฟล์ดิบในรันไทม์ด้วย
แท็ก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>
มีการสะสมการใช้งานหลายครั้ง-
ระบบจะเปิดหรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างในการกำหนดค่าเป้าหมาย การระบุ -<ฟีเจอร์> จะเป็นการปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ ดูเพิ่มเติม --host_features
แท็ก:changes_inputs
,affects_outputs
--[no]force_pic
ค่าเริ่มต้น: "false"-
หากเปิดใช้ การคอมไพล์ C++ ทั้งหมดจะสร้างโค้ดที่ไม่ขึ้นกับตำแหน่ง ("-fPIC") ลิงก์จะเลือกใช้ไลบรารี PIC ที่สร้างไว้ล่วงหน้ามากกว่าไลบรารีที่ไม่ใช่ PIC และลิงก์จะสร้างไฟล์ปฏิบัติการที่ไม่ขึ้นกับตำแหน่ง ("-pie")
แท็ก:loading_and_analysis
,affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
มีการสะสมการใช้งานหลายครั้ง-
ระบุชุดตัวแปรสภาพแวดล้อมที่พร้อมใช้งานสำหรับการดำเนินการที่มีการกำหนดค่าโฮสต์หรือการดำเนินการ ตัวแปรอาจระบุตามชื่อ ในกรณีนี้ค่าจะมาจากสภาพแวดล้อมการเรียกใช้ หรือระบุตามคู่ชื่อ=ค่า ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ คุณใช้ตัวเลือกนี้ได้หลายครั้ง สำหรับตัวเลือกที่ระบุไว้สำหรับตัวแปรเดียวกัน ตัวเลือกที่ระบุล่าสุดจะชนะ ส่วนตัวเลือกสำหรับตัวแปรที่แตกต่างกันจะสะสม
แท็กaction_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
ค่าเริ่มต้น: "opt"-
ระบุโหมดที่จะใช้สร้างเครื่องมือที่ใช้ในระหว่างการสร้าง ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
,action_command_lines
--host_conlyopt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C สำหรับเครื่องมือโฮสต์
แท็ก:action_command_lines
,affects_outputs
--host_copt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง gcc สำหรับเครื่องมือโฮสต์
แท็ก:action_command_lines
,affects_outputs
--host_cpu=<a string>
ค่าเริ่มต้น: ""-
CPU ของโฮสต์
แท็ก:changes_inputs
,affects_outputs
--host_cxxopt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง gcc สำหรับเครื่องมือโฮสต์
แท็ก:action_command_lines
,affects_outputs
--host_features=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบบจะเปิดหรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างในการกำหนดค่า exec การระบุ -<ฟีเจอร์> จะเป็นการปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ
แท็ก:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
ค่าเริ่มต้น: ดูคำอธิบาย-
ลบล้างเวอร์ชัน Python สำหรับการกำหนดค่าโฮสต์ อาจเป็น "PY2" หรือ "PY3"
แท็ก:loading_and_analysis
,affects_outputs
--host_linkopt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง gcc เมื่อลิงก์เครื่องมือโฮสต์
แท็ก: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++ อย่างเลือกเมื่อคอมไพล์ไฟล์บางไฟล์ในการกำหนดค่าโฮสต์หรือการกำหนดค่า Exec ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter หมายถึงรายการรูปแบบนิพจน์ทั่วไปที่รวมและยกเว้น (ดู --instrumentation_filter ด้วย) ส่วน option_1 ถึง option_n หมายถึงตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีคอมมา คุณต้องใส่เครื่องหมายคำพูดพร้อมแบ็กสแลช ตัวเลือกมี @ ได้ แต่จะใช้ @ ตัวแรกเท่านั้นในการแยกสตริง ตัวอย่าง: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 จะเพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ลงในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
,affects_outputs
--host_swiftcopt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง swiftc สำหรับเครื่องมือโฮสต์
แท็ก:action_command_lines
,affects_outputs
--[no]incompatible_avoid_conflict_dlls
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ระบบจะเปลี่ยนชื่อไลบรารีลิงก์แบบไดนามิก (DLL) ของ C++ ทั้งหมดที่สร้างโดย cc_library ใน Windows เป็น name_{hash}.dll โดยที่ hash จะคำนวณตาม RepositoryName และเส้นทางแพ็กเกจของ DLL ตัวเลือกนี้มีประโยชน์เมื่อคุณมีแพ็กเกจเดียวที่ขึ้นอยู่กับ cc_library หลายรายการที่มีชื่อเดียวกัน (เช่น //foo/bar1:utils และ //foo/bar2:utils)
แท็กloading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ระบบจะรวมไดเรกทอรี genfiles เข้ากับไดเรกทอรี bin
แท็ก:affects_outputs
,incompatible_change
--[no]incompatible_use_host_features
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้ --features สำหรับการกำหนดค่าเป้าหมายเท่านั้น และใช้ --host_features สำหรับการกำหนดค่า exec
แท็กchanges_inputs
,affects_outputs
,incompatible_change
--[no]incompatible_use_platforms_repo_for_constraints
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ระบบจะนำการตั้งค่าข้อจำกัดจาก @bazel_tools ออก
แท็ก:affects_outputs
,incompatible_change
--[no]instrument_test_targets
ค่าเริ่มต้น: "false"-
เมื่อเปิดใช้ Coverage จะระบุว่าจะพิจารณากฎการทดสอบที่ใช้เครื่องมือหรือไม่ เมื่อตั้งค่าไว้ ระบบจะใช้เครื่องมือกับกฎการทดสอบที่รวมไว้โดย --instrumentation_filter มิฉะนั้น ระบบจะไม่รวมกฎการทดสอบไว้ในการวัดความครอบคลุมเสมอ
แท็กaffects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
default: "-/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_application ผลลัพธ์คือไบนารีแบบสากลที่มีสถาปัตยกรรมที่ระบุทั้งหมด
แท็ก:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
ค่าเริ่มต้น: "จริง"-
เลิกใช้งานแล้ว ถูกแทนที่ด้วย --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
--[no]objc_debug_with_GLIBCXX
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้และตั้งค่าโหมดการคอมไพล์เป็น "dbg" ให้กำหนด GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC และ GLIBCPP_CONCEPT_CHECKS
แท็กaction_command_lines
--[no]objc_enable_binary_stripping
ค่าเริ่มต้น: "false"-
ระบุว่าจะลบสัญลักษณ์และโค้ดที่ไม่ได้ใช้ในไบนารีที่ลิงก์หรือไม่ ระบบจะทำการลบไบนารีออกหากมีการระบุทั้งแฟล็กนี้และ --compilation_mode=opt
แท็กaction_command_lines
--objccopt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ Objective-C/C++
แท็กaction_command_lines
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง gcc อย่างเลือกสรรเมื่อคอมไพล์ไฟล์บางไฟล์ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter หมายถึงรายการรูปแบบนิพจน์ทั่วไปที่รวมและยกเว้น (ดู --instrumentation_filter ด้วย) ส่วน option_1 ถึง option_n หมายถึงตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีคอมมา คุณต้องใส่เครื่องหมายคำพูดพร้อมแบ็กสแลช ตัวเลือกมี @ ได้ แต่จะใช้ @ ตัวแรกเท่านั้นในการแยกสตริง ตัวอย่าง: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 จะเพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ลงในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
,affects_outputs
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมในการส่งไปยังแบ็กเอนด์ LTO แบบเลือก (ในส่วน --features=thin_lto) เมื่อคอมไพล์ออบเจ็กต์แบ็กเอนด์บางรายการ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดย regex_filter หมายถึงรายการรูปแบบนิพจน์ทั่วไปที่รวมและยกเว้น ส่วน option_1 ถึง option_n หมายถึงตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีคอมมา คุณต้องใส่เครื่องหมายคำพูดพร้อมแบ็กสแลช ตัวเลือกมี @ ได้ แต่จะใช้ @ ตัวแรกเท่านั้นในการแยกสตริง ตัวอย่าง: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 จะเพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ลงในบรรทัดคำสั่งของ LTO Backend ของไฟล์.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 เพื่อเพิ่มประสิทธิภาพเป้าหมายการบิลด์ โปรไฟล์ Propeller ต้องประกอบด้วยไฟล์อย่างน้อย 1 ใน 2 ไฟล์ ได้แก่ โปรไฟล์ cc และโปรไฟล์ ld แฟล็กนี้ยอมรับป้ายกำกับการสร้างซึ่งต้องอ้างอิงไฟล์อินพุตโปรไฟล์ Propeller เช่น ไฟล์ BUILD ที่กำหนดป้ายกำกับใน a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",) อาจต้องเพิ่มคำสั่ง exports_files ลงในแพ็กเกจที่เกี่ยวข้องเพื่อให้ Bazel มองเห็นไฟล์เหล่านี้ ต้องใช้ตัวเลือกในรูปแบบ --propeller_optimize=//a/b:propeller_profile
แท็ก:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
ชื่อเส้นทางสัมบูรณ์ของไฟล์ cc_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพสำหรับ Propeller
แท็กaffects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
ชื่อเส้นทางแบบสัมบูรณ์ของไฟล์ ld_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพของ Propeller
แท็ก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
-
หากเป็นจริง ระบบจะแชร์ไลบรารีเนทีฟที่มีฟังก์ชันการทำงานเหมือนกันในกลุ่มเป้าหมายต่างๆ
แท็ก:loading_and_analysis
,affects_outputs
--[no]stamp
ค่าเริ่มต้น: "false"-
ประทับเวลาไบนารีด้วยวันที่ ชื่อผู้ใช้ ชื่อโฮสต์ ข้อมูลพื้นที่ทำงาน ฯลฯ
แท็ก:affects_outputs
--strip=<always, sometimes or never>
ค่าเริ่มต้น: "บางครั้ง"-
ระบุว่าจะลบไบนารีและไลบรารีที่ใช้ร่วมกันหรือไม่ (ใช้ "-Wl,--strip-debug") ค่าเริ่มต้นของ "sometimes" หมายถึงการลบออกก็ต่อเมื่อ --compilation_mode=fastbuild
แท็กaffects_outputs
--stripopt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง strip เมื่อสร้างไบนารี "<name>.stripped"
แท็ก:action_command_lines
,affects_outputs
--swiftcopt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยังการคอมไพล์ Swift
แท็กaction_command_lines
--tvos_cpus=<comma-separated list of options>
มีการสะสมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาเพื่อสร้างไบนารี Apple tvOS
แท็ก:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
ค่าเริ่มต้น: ดูคำอธิบาย-
เวอร์ชัน tvOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองและอุปกรณ์เป้าหมาย หากไม่ได้ระบุ ให้ใช้ "tvos_sdk_version"
แท็กloses_incremental_state
--visionos_cpus=<comma-separated list of options>
มีการสะสมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาซึ่งจะใช้สร้างไบนารีของ Apple visionOS
แท็ก:loses_incremental_state
,loading_and_analysis
--watchos_cpus=<comma-separated list of options>
มีการสะสมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาซึ่งจะใช้สร้างไบนารีของ Apple watchOS
แท็ก:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
ค่าเริ่มต้น: ดูคำอธิบาย-
เวอร์ชัน watchOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองและอุปกรณ์เป้าหมาย หากไม่ได้ระบุ ให้ใช้ "watchos_sdk_version"
แท็กloses_incremental_state
--xbinary_fdo=<a build target label>
ค่าเริ่มต้น: ดูคำอธิบาย-
ใช้ข้อมูลโปรไฟล์ XbinaryFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อของโปรไฟล์ไบนารีข้ามเริ่มต้น เมื่อใช้ตัวเลือกนี้ร่วมกับ --fdo_instrument/--fdo_optimize/--fdo_profile ตัวเลือกเหล่านั้นจะมีผลเสมอราวกับว่าไม่ได้ระบุ xbinary_fdo
แท็ก:affects_outputs
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้ข้อมูลอินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าสถานะ ฯลฯ)
--auto_cpu_environment_group=<a build target label>
ค่าเริ่มต้น: ""-
ประกาศ environment_group ที่จะใช้ในการแมปค่า CPU กับค่า target_environment โดยอัตโนมัติ
แท็กchanges_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
ค่าเริ่มต้น: "false"-
ตรวจสอบว่าข้อจำกัดด้านการอนุญาตให้ใช้สิทธิที่กำหนดโดยแพ็กเกจที่ขึ้นต่อกันไม่ขัดแย้งกับโหมดการจัดจำหน่ายของเป้าหมายที่กำลังสร้าง โดยค่าเริ่มต้น ระบบจะไม่ตรวจสอบใบอนุญาต
แท็กbuild_file_semantics
--[no]check_visibility
ค่าเริ่มต้น: "จริง"-
หากปิดใช้ ข้อผิดพลาดด้านการมองเห็นในทรัพยากรที่ขึ้นต่อกันของเป้าหมายจะลดระดับเป็นคำเตือน
แท็กbuild_file_semantics
--[no]desugar_for_android
ค่าเริ่มต้น: "จริง"-
จะยกเลิกการเพิ่มน้ำตาลในไบต์โค้ด Java 8 ก่อนที่จะแปลงเป็น DEX หรือไม่
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
ค่าเริ่มต้น: "false"-
เลือกว่าจะรวมไลบรารี Java 8 ที่รองรับไว้ในแอปสำหรับอุปกรณ์รุ่นเดิมหรือไม่
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
ค่าเริ่มต้น: "จริง"-
ตรวจสอบสภาพแวดล้อมที่แต่ละเป้าหมายใช้งานร่วมกันได้ และรายงานข้อผิดพลาดหากเป้าหมายใดมีทรัพยากร Dependency ที่ไม่รองรับสภาพแวดล้อมเดียวกัน
แท็ก:build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs
ค่าเริ่มต้น: "false"-
Flag to help transition from allowing to disallowing srcs-less android_library rules with deps. เราต้องล้างข้อมูลในคลังเพื่อเปิดตัวฟีเจอร์นี้โดยค่าเริ่มต้น
แท็ก:eagerness_to_exit
,loading_and_analysis
--[no]experimental_check_desugar_deps
ค่าเริ่มต้น: "จริง"-
เลือกว่าจะตรวจสอบซ้ำว่าการยกเลิกการเพิ่มน้ำตาลถูกต้องที่ระดับไบนารีของ Android หรือไม่
แท็กeagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<off, warning or error>
ค่าเริ่มต้น: "ปิด"-
เมื่อเปิดใช้ ให้ตรวจสอบว่าการอ้างอิงของ aar_import เสร็จสมบูรณ์หรือไม่ การบังคับใช้นี้อาจทำให้บิลด์ใช้งานไม่ได้ หรืออาจส่งผลให้เกิดคำเตือนเท่านั้น
แท็กloading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
ค่าเริ่มต้น: "default"-
หากเป็นจริง จะตรวจสอบว่าเป้าหมาย Java ประกาศเป้าหมายทั้งหมดที่ใช้โดยตรงเป็นทรัพยากร Dependency อย่างชัดเจน
แท็ก:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
ค่าเริ่มต้น: "false"-
หากเปิดใช้ ให้ตรวจสอบ testonly สำหรับเป้าหมายที่ต้องมีก่อนซึ่งเป็นไฟล์เอาต์พุตโดยค้นหา testonly ของกฎการสร้าง ซึ่งตรงกับการตรวจสอบระดับการเข้าถึง
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
ค่าเริ่มต้น: "false"-
หากเปิดใช้ ระบบจะปิดใช้การใช้กฎ Android ดั้งเดิมโดยตรง โปรดใช้กฎ Starlark Android จาก https://github.com/bazelbuild/rules_android
แท็กeagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
ค่าเริ่มต้น: "false"-
ไม่มีการดำเนินการ เก็บไว้ที่นี่เพื่อให้เข้ากันได้แบบย้อนหลัง
แท็ก:eagerness_to_exit
,incompatible_change
--[no]incompatible_force_strict_header_check_from_starlark
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ให้ตั้งค่าการตรวจสอบส่วนหัวอย่างเข้มงวดใน Starlark API
แท็กloading_and_analysis
,changes_inputs
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง Bazel จะตรวจสอบการรวมส่วนหัวของไดเรกทอรีระดับบนสุดด้วย (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/10047)
แท็ก:loading_and_analysis
,incompatible_change
--[no]strict_filesets
ค่าเริ่มต้น: "false"-
หากเปิดใช้ตัวเลือกนี้ ระบบจะรายงานชุดไฟล์ที่ข้ามขอบเขตแพ็กเกจเป็นข้อผิดพลาด โดยจะใช้ไม่ได้เมื่อปิดใช้ check_fileset_dependencies_recursively
แท็ก:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
ค่าเริ่มต้น: "error"-
หากไม่ได้ปิดไว้ จะตรวจสอบว่าเป้าหมาย proto_library ประกาศเป้าหมายทั้งหมดที่ใช้โดยตรงเป็นทรัพยากร Dependency อย่างชัดเจน
แท็กbuild_file_semantics
,eagerness_to_exit
,incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
ค่าเริ่มต้น: "ปิด"-
หากไม่ได้ปิดไว้ จะตรวจสอบว่าเป้าหมาย proto_library ประกาศเป้าหมายทั้งหมดที่ใช้ใน "import public" อย่างชัดเจนว่าส่งออกแล้ว
แท็กbuild_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
ค่าเริ่มต้น: "false"-
หากเป็นจริง คุณต้องประกาศส่วนหัวที่พบผ่านเส้นทางรวมของระบบ (-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
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าไว้และโหมดการคอมไพล์ไม่ใช่ "opt" แอป objc จะมีสิทธิ์ในการแก้ไขข้อบกพร่องเมื่อลงนาม
แท็กchanges_inputs
--ios_signing_cert_name=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
ชื่อใบรับรองที่จะใช้สำหรับการลงนามใน iOS หากไม่ได้ตั้งค่าไว้ ระบบจะกลับไปใช้โปรไฟล์การจัดสรร อาจเป็นค่ากำหนดข้อมูลประจำตัวในพวงกุญแจของใบรับรองหรือ (สตริงย่อย) ของชื่อจริงของใบรับรอง ตามหน้า Man ของ codesign (ข้อมูลประจำตัวในการลงนาม)
แท็ก:action_command_lines
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ในไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE:
--[no]incompatible_disallow_legacy_py_provider
ค่าเริ่มต้น: "จริง"-
ไม่มีการดำเนินการใดๆ และจะนำออกในเร็วๆ นี้
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่ควบคุมลักษณะการทำงานของสภาพแวดล้อมในการทดสอบหรือเครื่องมือเรียกใช้การทดสอบ
--[no]allow_analysis_failures
ค่าเริ่มต้น: "false"-
หากเป็นจริง การวิเคราะห์เป้าหมายของกฎล้มเหลวจะทำให้เป้าหมายเผยแพร่อินสแตนซ์ของ AnalysisFailureInfo ที่มีคำอธิบายข้อผิดพลาด แทนที่จะทำให้การสร้างล้มเหลว
แท็ก:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
ค่าเริ่มต้น: "2000"-
กำหนดจำนวนการอ้างอิงแบบทรานซิทีฟสูงสุดผ่านแอตทริบิวต์กฎที่มีการเปลี่ยนการกำหนดค่า for_analysis_testing การใช้งานเกินขีดจำกัดนี้จะทำให้เกิดข้อผิดพลาดของกฎ
แท็กloading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
ค่าเริ่มต้น: "false"-
หากเป็นจริง การดำเนินการ dex2oat ที่ล้มเหลวจะทำให้บิลด์หยุดทำงานแทนที่จะเรียกใช้ dex2oat ในระหว่างรันไทม์ของการทดสอบ
แท็ก:loading_and_analysis
,experimental
--[no]experimental_android_use_parallel_dex2oat
ค่าเริ่มต้น: "false"-
ใช้ dex2oat แบบขนานเพื่อเร่งความเร็ว android_test
แท็กloading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
ค่าเริ่มต้น: "false"-
เปิดใช้การตรวจสอบหน่วยความจำรั่วในเป้าหมาย 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 โดย runs_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" เท่านั้น
แท็กtest_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
ค่าเริ่มต้น: "-1"- ลบล้างค่าการหมดเวลาทดสอบเริ่มต้นสำหรับการหมดเวลาทดสอบ (เป็นวินาที) หากระบุค่าจำนวนเต็มบวกค่าเดียว ค่าดังกล่าวจะลบล้างหมวดหมู่ทั้งหมด หากระบุจำนวนเต็ม 4 รายการที่คั่นด้วยคอมมา ระบบจะลบล้างการหมดเวลาสำหรับระยะเวลาสั้น ปานกลาง ยาว และไม่มีกำหนด (ตามลำดับ) ไม่ว่าจะอยู่ในรูปแบบใด ค่า -1 จะบอกให้ Blaze ใช้การหมดเวลาเริ่มต้นสำหรับหมวดหมู่นั้น
--tvos_simulator_device=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
อุปกรณ์ที่จะจำลองเมื่อเรียกใช้แอปพลิเคชัน tvOS ในโปรแกรมจำลอง เช่น "Apple TV 1080p" คุณดูรายการอุปกรณ์ได้โดยเรียกใช้ "xcrun simctl list devicetypes" ในเครื่องที่จะเรียกใช้โปรแกรมจำลอง
แท็กtest_runner
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
ค่าเริ่มต้น: ดูคำอธิบาย-
เวอร์ชันของ tvOS ที่จะเรียกใช้ในโปรแกรมจำลองเมื่อเรียกใช้หรือทดสอบ
แท็กtest_runner
--watchos_simulator_device=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย-
อุปกรณ์ที่จะจำลองเมื่อเรียกใช้แอปพลิเคชัน watchOS ในโปรแกรมจำลอง เช่น "Apple Watch - 38 มม." คุณดูรายการอุปกรณ์ได้โดยเรียกใช้ "xcrun simctl list devicetypes" ในเครื่องที่จะเรียกใช้โปรแกรมจำลอง
แท็กtest_runner
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
ค่าเริ่มต้น: ดูคำอธิบาย-
เวอร์ชันของ watchOS ที่จะเรียกใช้ในเครื่องจำลองเมื่อเรียกใช้หรือทดสอบ
แท็กtest_runner
--[no]zip_undeclared_test_outputs
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ระบบจะเก็บเอาต์พุตการทดสอบที่ไม่ได้ประกาศไว้ในไฟล์ ZIP
แท็ก:test_runner
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและการตีความหมายของการค้นหา
--aspect_deps=<off, conservative or precise>
ค่าเริ่มต้น: "ระมัดระวัง"-
วิธีแก้ไขการขึ้นต่อกันของแง่มุมเมื่อรูปแบบเอาต์พุตเป็นหนึ่งใน {xml,proto,record} "off" หมายความว่าจะไม่มีการแก้ไขการขึ้นต่อกันของแง่มุม "conservative" (ค่าเริ่มต้น) หมายความว่าจะมีการเพิ่มการขึ้นต่อกันของแง่มุมที่ประกาศทั้งหมดไม่ว่าจะมีคลาสกฎของการขึ้นต่อกันโดยตรงหรือไม่ก็ตาม "precise" หมายความว่าจะมีการเพิ่มเฉพาะแง่มุมที่อาจใช้งานได้เมื่อพิจารณาจากคลาสกฎของการขึ้นต่อกันโดยตรง โปรดทราบว่าโหมดที่แม่นยำต้องโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียว จึงทำให้ช้ากว่าโหมดอื่นๆ โปรดทราบว่าแม้ในโหมดที่แม่นยำก็ยังไม่แม่นยำโดยสมบูรณ์ เนื่องจากระบบจะตัดสินใจว่าจะคำนวณแง่มุมใดในระยะการวิเคราะห์ ซึ่งไม่ได้ทำงานระหว่าง "bazel query"
แท็กbuild_file_semantics
--[no]consistent_labels
ค่าเริ่มต้น: "false"-
หากเปิดใช้ คำสั่งการค้นหาทุกคำสั่งจะปล่อยป้ายกำกับออกมาเหมือนกับฟังก์ชัน <code>str</code> ของ Starlark ที่ใช้กับอินสแตนซ์ <code>Label</code> ซึ่งจะเป็นประโยชน์สำหรับเครื่องมือที่ต้องจับคู่เอาต์พุตของคำสั่งการค้นหาและ/หรือป้ายกำกับต่างๆ ที่กฎปล่อยออกมา หากไม่ได้เปิดใช้ ตัวจัดรูปแบบเอาต์พุตจะสามารถปล่อยชื่อที่เก็บที่ชัดเจน (เทียบกับที่เก็บหลัก) แทนเพื่อให้เอาต์พุตอ่านง่ายขึ้น
แท็กterminal_output
--[no]graph:factored
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ระบบจะส่งกราฟที่ "แยกตัวประกอบ" กล่าวคือ ระบบจะผสานโหนดที่เทียบเท่ากันในเชิงโทโพโลยีเข้าด้วยกันและต่อป้ายกำกับของโหนดเหล่านั้น ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็กterminal_output
--graph:node_limit=<an integer>
ค่าเริ่มต้น: "512"-
ความยาวสูงสุดของสตริงป้ายกำกับสำหรับโหนดกราฟในเอาต์พุต ระบบจะตัดป้ายกำกับที่ยาวเกินไป โดย -1 หมายถึงไม่มีการตัด ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็กterminal_output
--[no]implicit_deps
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ระบบจะรวมทรัพยากร Dependency โดยนัยไว้ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน การขึ้นต่อกันโดยนัยคือการขึ้นต่อกันที่ไม่ได้ระบุอย่างชัดเจนในไฟล์ BUILD แต่ Bazel เพิ่มให้ สำหรับ cquery ตัวเลือกนี้จะควบคุมการกรอง Toolchain ที่แก้ไขแล้ว
แท็กbuild_file_semantics
--[no]include_aspects
ค่าเริ่มต้น: "จริง"-
aquery, cquery: whether to include aspect-generated actions in the output. query: no-op (aspects are always followed).
แท็กterminal_output
--[no]incompatible_display_source_file_location
ค่าเริ่มต้น: "จริง"-
ค่าเริ่มต้นเป็น "จริง" ซึ่งจะแสดงเป้าหมายของไฟล์ต้นฉบับ หากจริง จะแสดงตำแหน่งของบรรทัดที่ 1 ของไฟล์แหล่งที่มาในเอาต์พุตตำแหน่ง โดยแฟล็กนี้มีไว้เพื่อวัตถุประสงค์ในการย้ายข้อมูลเท่านั้น
แท็ก:terminal_output
,incompatible_change
--[no]incompatible_package_group_includes_double_slash
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ เมื่อส่งออกแอตทริบิวต์ `packages` ของ package_group ระบบจะไม่ละเว้น `//` ที่นำหน้า
แท็ก:terminal_output
,incompatible_change
--[no]infer_universe_scope
ค่าเริ่มต้น: "false"-
หากตั้งค่าและไม่ได้ตั้งค่า --universe_scope ระบบจะอนุมานค่าของ --universe_scope เป็นรายการรูปแบบเป้าหมายที่ไม่ซ้ำกันในนิพจน์การค้นหา โปรดทราบว่าค่า --universe_scope ที่อนุมานสำหรับนิพจน์การค้นหาที่ใช้ฟังก์ชันระดับจักรวาล (เช่น `allrdeps`) อาจไม่ใช่สิ่งที่คุณต้องการ ดังนั้นคุณควรใช้ตัวเลือกนี้เฉพาะในกรณีที่คุณทราบว่ากำลังทำอะไรอยู่ ดูรายละเอียดและตัวอย่างได้ที่ https://bazel.build/reference/query#sky-query หากตั้งค่า --universe_scope ระบบจะไม่สนใจค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้ใช้ได้กับ `query` เท่านั้น (ไม่ใช่ `cquery`)
แท็ก:loading_and_analysis
--[no]line_terminator_null
ค่าเริ่มต้น: "false"-
ไม่ว่าจะสิ้นสุดแต่ละรูปแบบด้วย \0 แทนการขึ้นบรรทัดใหม่
แท็กterminal_output
--[no]nodep_deps
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ระบบจะรวมการอ้างอิงจากแอตทริบิวต์ "nodep" ไว้ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ตัวอย่างทั่วไปของแอตทริบิวต์ "nodep" คือ "visibility" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ `info build-language` เพื่อดูข้อมูลเกี่ยวกับแอตทริบิวต์ "nodep" ทั้งหมดในภาษาบิลด์
แท็กbuild_file_semantics
--output=<a string>
ค่าเริ่มต้น: "label"-
รูปแบบที่ควรพิมพ์ผลลัพธ์ของ cquery ค่าที่อนุญาตสำหรับ cquery คือ label, label_kind, textproto, transitions, proto, jsonproto หากเลือก "การเปลี่ยนฉาก" คุณต้องระบุตัวเลือก --transitions=(lite|full) ด้วย
แท็กterminal_output
--[no]proto:default_values
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ระบบจะรวมแอตทริบิวต์ที่ไม่ได้ระบุค่าอย่างชัดเจนในไฟล์ BUILD ไว้ด้วย มิฉะนั้นจะละเว้น ตัวเลือกนี้ใช้ได้กับ --output=proto
แท็ก:terminal_output
--[no]proto:definition_stack
ค่าเริ่มต้น: "false"-
ป้อนข้อมูลฟิลด์ Proto ของ definition_stack ซึ่งจะบันทึกสแต็กการเรียก Starlark สำหรับอินสแตนซ์ของกฎแต่ละรายการ ณ เวลาที่กำหนดคลาสของกฎ
แท็กterminal_output
--[no]proto:flatten_selects
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ระบบจะทำให้แอตทริบิวต์ที่กำหนดค่าได้ซึ่งสร้างโดย select() แบนราบ สำหรับประเภทรายการ การแสดงแบบ Flatten คือรายการที่มีค่าของแผนที่ที่เลือกแต่ละค่าเพียงครั้งเดียว ระบบจะทำให้ประเภทสเกลาร์แบนเป็นค่าว่าง
แท็กbuild_file_semantics
--[no]proto:include_configurations
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ เอาต์พุตโปรโตคอลจะมีข้อมูลเกี่ยวกับการกำหนดค่า เมื่อปิดใช้ รูปแบบเอาต์พุตของ cquery proto จะคล้ายกับรูปแบบเอาต์พุตของคำค้นหา
แท็กaffects_outputs
--[no]proto:include_synthetic_attribute_hash
ค่าเริ่มต้น: "false"-
จะคำนวณและสร้างแอตทริบิวต์ $internal_attr_hash หรือไม่
แท็กterminal_output
--[no]proto:instantiation_stack
ค่าเริ่มต้น: "false"-
สร้างสแต็กการเรียกอินสแตนซ์ของแต่ละกฎ โปรดทราบว่าต้องมีสแต็กจึงจะดำเนินการนี้ได้
แท็กterminal_output
--[no]proto:locations
ค่าเริ่มต้น: "จริง"-
จะแสดงข้อมูลตำแหน่งในเอาต์พุต Proto หรือไม่
แท็กterminal_output
--proto:output_rule_attrs=<comma-separated list of options>
ค่าเริ่มต้น: "all"-
รายการแอตทริบิวต์ที่คั่นด้วยคอมมาที่จะรวมไว้ในเอาต์พุต ค่าเริ่มต้นคือแอตทริบิวต์ทั้งหมด ตั้งค่าเป็นสตริงว่างเปล่าเพื่อไม่ให้แสดงแอตทริบิวต์ใดๆ ตัวเลือกนี้ใช้ได้กับ --output=proto
แท็กterminal_output
--[no]proto:rule_inputs_and_outputs
ค่าเริ่มต้น: "จริง"-
จะป้อนข้อมูลในช่อง rule_input และ rule_output หรือไม่
แท็กterminal_output
--query_file=<a string>
ค่าเริ่มต้น: ""-
หากตั้งค่าไว้ การค้นหาจะอ่านการค้นหาจากไฟล์ที่ตั้งชื่อไว้ที่นี่ แทนที่จะอ่านจากบรรทัดคำสั่ง การระบุไฟล์ที่นี่รวมถึงการค้นหาในบรรทัดคำสั่งถือเป็นข้อผิดพลาด
แท็กchanges_inputs
--[no]relative_locations
ค่าเริ่มต้น: "false"-
หากเป็นจริง ตำแหน่งของไฟล์ BUILD ในเอาต์พุต XML และ Proto จะเป็นแบบสัมพัทธ์ โดยค่าเริ่มต้น เอาต์พุตตำแหน่งจะเป็นเส้นทางที่สมบูรณ์และจะไม่สอดคล้องกันในเครื่องต่างๆ คุณสามารถตั้งค่าตัวเลือกนี้เป็น "จริง" เพื่อให้ได้ผลลัพธ์ที่สอดคล้องกันในเครื่องต่างๆ
แท็กterminal_output
--show_config_fragments=<off, direct or transitive>
ค่าเริ่มต้น: "ปิด"-
แสดงส่วนการกำหนดค่าที่กฎและทรัพยากร Dependency แบบทรานซิทีฟของกฎนั้นต้องการ ซึ่งจะเป็นประโยชน์ในการประเมินว่ากราฟเป้าหมายที่กำหนดค่าไว้สามารถตัดออกได้มากน้อยเพียงใด
แท็กaffects_outputs
--starlark:expr=<a string>
ค่าเริ่มต้น: ""-
นิพจน์ Starlark เพื่อจัดรูปแบบเป้าหมายที่กำหนดค่าแต่ละรายการในโหมด --output=starlark ของ cquery เป้าหมายที่กำหนดค่าจะเชื่อมโยงกับ "target" หากไม่ได้ระบุทั้ง --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
ค่าเริ่มต้น: "จริง"-
คำค้นหา: หากปิดใช้ ระบบจะไม่รวมการอ้างอิงเป้าหมาย "การกำหนดค่าโฮสต์" หรือ "การดำเนินการ" ไว้ในกราฟการอ้างอิงที่คำค้นหาดำเนินการ ขอบเขตการพึ่งพา "การกำหนดค่าโฮสต์" เช่น ขอบเขตจากกฎ "proto_library" ไปยังคอมไพเลอร์โปรโตคอล มักจะชี้ไปยังเครื่องมือที่ดำเนินการในระหว่างการบิลด์แทนที่จะเป็นส่วนหนึ่งของโปรแกรม "เป้าหมาย" เดียวกัน
Cquery: หากปิดใช้ ระบบจะกรองเป้าหมายที่กำหนดค่าทั้งหมดซึ่งข้ามโฮสต์หรือการเปลี่ยนการดำเนินการจากเป้าหมายระดับบนสุดที่ค้นพบเป้าหมายที่กำหนดค่านี้ ซึ่งหมายความว่าหากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าเป้าหมาย ระบบจะแสดงเฉพาะเป้าหมายที่กำหนดค่าซึ่งอยู่ในกำหนดค่าเป้าหมายด้วย หากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าโฮสต์ ระบบจะแสดงเฉพาะเป้าหมายที่กำหนดค่าโฮสต์ ตัวเลือกนี้จะไม่ยกเว้น Toolchain ที่แก้ไขแล้ว
แท็กbuild_file_semantics
--transitions=<full, lite or none>
ค่าเริ่มต้น: "none"-
รูปแบบที่ cquery จะพิมพ์ข้อมูลการเปลี่ยน
แท็กaffects_outputs
--universe_scope=<comma-separated list of options>
ค่าเริ่มต้น: ""-
ชุดรูปแบบเป้าหมายที่คั่นด้วยคอมมา (การบวกและการลบ) ระบบอาจดำเนินการค้นหาในจักรวาลที่กำหนดโดยการปิดทรานซิทีฟของเป้าหมายที่ระบุ ตัวเลือกนี้ใช้สำหรับคำสั่งการค้นหาและ cquery
สำหรับ cquery อินพุตของตัวเลือกนี้คือเป้าหมายที่สร้างคำตอบทั้งหมดภายใต้ตัวเลือกนี้ ดังนั้นตัวเลือกนี้อาจส่งผลต่อการกำหนดค่าและการเปลี่ยน หากไม่ได้ระบุตัวเลือกนี้ ระบบจะถือว่าเป้าหมายระดับบนสุดคือเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหา หมายเหตุ: สำหรับ cquery การไม่ระบุตัวเลือกนี้อาจทำให้บิลด์หยุดทำงานหากเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหาไม่สามารถสร้างได้ด้วยตัวเลือกในระดับบนสุด
แท็ก:loading_and_analysis
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพเวลาบิลด์
--[no]collapse_duplicate_defines
ค่าเริ่มต้น: "false"-
เมื่อเปิดใช้ ระบบจะนำ --defines ที่ซ้ำกันออกตั้งแต่เนิ่นๆ ในการสร้าง ซึ่งจะช่วยหลีกเลี่ยงการสูญเสียแคชการวิเคราะห์ที่ไม่จำเป็นสำหรับการสร้างที่เทียบเท่าบางประเภท
แท็ก:loading_and_analysis
,loses_incremental_state
--[no]experimental_filter_library_jar_with_program_jar
ค่าเริ่มต้น: "false"-
กรอง ProGuard ProgramJar เพื่อนำคลาสที่อยู่ใน LibraryJar ออก
แท็กaction_command_lines
--[no]experimental_inmemory_dotd_files
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ระบบจะส่งไฟล์ .d ของ C++ ผ่านหน่วยความจำโดยตรงจากโหนดการสร้างระยะไกลแทนที่จะเขียนลงในดิสก์
แท็กloading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ระบบจะส่งไฟล์การอ้างอิง (.jdeps) ที่สร้างจากการคอมไพล์ Java ผ่านหน่วยความจำโดยตรงจากโหนดการสร้างระยะไกลแทนที่จะเขียนลงในดิสก์
แท็กloading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_objc_include_scanning
ค่าเริ่มต้น: "false"-
ว่าจะทำการสแกนรวมสำหรับ Objective C/C++ หรือไม่
แท็กloading_and_analysis
,execution
,changes_inputs
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
ค่าเริ่มต้น: "false"-
หากเปิดใช้ ฟีเจอร์ parse_headers จะไม่สร้างการดำเนินการคอมไพล์ส่วนหัวแยกต่างหากหากพบแหล่งที่มาที่มีชื่อฐานเดียวกันในเป้าหมายเดียวกัน
แท็ก:loading_and_analysis
,affects_outputs
--[no]experimental_retain_test_configuration_across_testonly
ค่าเริ่มต้น: "false"-
เมื่อเปิดใช้ --trim_test_configuration จะไม่ตัดการกำหนดค่าการทดสอบสำหรับกฎที่ทำเครื่องหมาย testonly=1 ซึ่งมีจุดประสงค์เพื่อลดปัญหาความขัดแย้งในการดำเนินการเมื่อกฎที่ไม่ใช่การทดสอบขึ้นอยู่กับกฎ cc_test จะไม่มีผลหาก --trim_test_configuration เป็นเท็จ
แท็ก:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
ค่าเริ่มต้น: "false"-
หากเปิดใช้ คุณจะใช้ cc_import เวอร์ชัน Starlark ได้
แท็ก:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
ค่าเริ่มต้น: "false"-
จะจำกัดอินพุตให้เหลือเฉพาะการคอมไพล์ C/C++ โดยการแยกวิเคราะห์บรรทัด #include จากไฟล์อินพุตหรือไม่ ซึ่งจะช่วยปรับปรุงประสิทธิภาพและส่วนเพิ่มได้ด้วยการลดขนาดของทรีอินพุตการคอมไพล์ อย่างไรก็ตาม การดำเนินการนี้อาจทำให้บิลด์หยุดทำงานได้เนื่องจากเครื่องมือสแกนการรวมไม่ได้ใช้ความหมายของตัวประมวลผล C ล่วงหน้าอย่างเต็มรูปแบบ โดยเฉพาะอย่างยิ่ง เครื่องมือนี้ไม่เข้าใจคำสั่ง #include แบบไดนามิกและไม่สนใจตรรกะแบบมีเงื่อนไขของตัวประมวลผลล่วงหน้า คุณต้องรับความเสี่ยงของการใช้งานเอง เราจะปิดปัญหาที่เกี่ยวข้องกับการแจ้งว่าไม่เหมาะสมนี้ทั้งหมด
แท็กloading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
ค่าเริ่มต้น: "จริง"-
ทำงานส่วนใหญ่ในการแยก dex สำหรับไฟล์ Jar แต่ละไฟล์
แท็กaffects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าไว้ ระบบจะใช้ไฟล์ .d ที่ clang ปล่อยออกมาเพื่อตัดชุดอินพุตที่ส่งไปยังการคอมไพล์ objc
แท็ก:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
ค่าเริ่มต้น: "false"-
เมื่อสร้างเป้าหมาย //a:a ให้ประมวลผลส่วนหัวในเป้าหมายทั้งหมดที่ //a:a ขึ้นอยู่กับ (หากเปิดใช้การประมวลผลส่วนหัวสำหรับเครื่องมือแล้ว)
แท็กexecution
--[no]trim_test_configuration
ค่าเริ่มต้น: "จริง"-
เมื่อเปิดใช้ ตัวเลือกที่เกี่ยวข้องกับการทดสอบจะถูกล้างใต้ระดับบนสุดของบิลด์ เมื่อเปิดใช้ฟีเจอร์นี้ คุณจะสร้างการทดสอบเป็นทรัพยากร Dependency ของกฎที่ไม่ใช่การทดสอบไม่ได้ แต่การเปลี่ยนแปลงตัวเลือกที่เกี่ยวข้องกับการทดสอบจะไม่ทำให้ระบบวิเคราะห์กฎที่ไม่ใช่การทดสอบอีกครั้ง
แท็ก:loading_and_analysis
,loses_incremental_state
--[no]use_singlejar_apkbuilder
ค่าเริ่มต้น: "จริง"-
ตัวเลือกนี้เลิกใช้งานแล้ว ตอนนี้ไม่มีการดำเนินการใดๆ และจะถูกนำออกในเร็วๆ นี้
แท็ก:loading_and_analysis
- ตัวเลือกที่มีผลต่อความละเอียด รูปแบบ หรือตำแหน่งของการบันทึก:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
ค่าเริ่มต้น: "-.*"-
พิมพ์ข้อมูลการแก้ไขข้อบกพร่องระหว่างการแก้ปัญหา Toolchain โดยแฟล็กจะใช้นิพจน์ทั่วไป ซึ่งจะตรวจสอบกับประเภท Toolchain และเป้าหมายที่เฉพาะเจาะจงเพื่อดูว่าควรแก้ไขข้อบกพร่องของรายการใด คุณคั่นนิพจน์ทั่วไปหลายรายการด้วยคอมมาได้ จากนั้นระบบจะตรวจสอบนิพจน์ทั่วไปแต่ละรายการแยกกัน หมายเหตุ: เอาต์พุตของฟีเจอร์นี้มีความซับซ้อนมากและอาจมีประโยชน์เฉพาะผู้เชี่ยวชาญด้านการแก้ปัญหา Toolchain เท่านั้น
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
--flag_alias=<a 'name=value' flag alias>
มีการสะสมการใช้งานหลายครั้ง-
ตั้งชื่อย่อสำหรับแฟล็ก Starlark โดยจะรับคู่คีย์-ค่าเดียวในรูปแบบ "<key>=<value>" เป็นอาร์กิวเมนต์
แท็กchanges_inputs
--[no]incompatible_default_to_explicit_init_py
ค่าเริ่มต้น: "false"-
แฟล็กนี้จะเปลี่ยนลักษณะการทำงานเริ่มต้นเพื่อให้ระบบไม่สร้างไฟล์ __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
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง เป้าหมายที่สร้างในการกำหนดค่า Python 2 จะปรากฏภายใต้รูทเอาต์พุตที่มีคำต่อท้าย "-py2" ในขณะที่เป้าหมายที่สร้างสำหรับ Python 3 จะปรากฏในรูทที่ไม่มีคำต่อท้ายที่เกี่ยวข้องกับ Python ซึ่งหมายความว่า Symlink ที่สะดวก `bazel-bin` จะชี้ไปยังเป้าหมาย Python 3 แทนที่จะเป็น Python 2 หากเปิดใช้ตัวเลือกนี้ เราขอแนะนำให้เปิดใช้ `--incompatible_py3_is_default` ด้วย
แท็ก:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง เป้าหมาย `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
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็น "จริง" กฎ Python ดั้งเดิมที่เรียกใช้งานได้จะใช้รันไทม์ Python ที่ระบุโดยชุดเครื่องมือ Python แทนรันไทม์ที่ระบุโดยแฟล็กเดิม เช่น --python_top
แท็ก:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
ค่าเริ่มต้น: ดูคำอธิบาย-
โหมดเวอร์ชันหลักของ Python ซึ่งอาจเป็น `PY2` หรือ `PY3` โปรดทราบว่าเป้าหมาย `py_binary` และ `py_test` จะลบล้างค่านี้ (แม้ว่าจะไม่ได้ระบุเวอร์ชันอย่างชัดเจน) ดังนั้นจึงมักไม่มีเหตุผลมากนักที่จะระบุแฟล็กนี้
แท็ก:loading_and_analysis
,affects_outputs
,explicit_in_output_path
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้:
--[no]cache_test_results
[-t
] default: "auto"- หากตั้งค่าเป็น "auto" Bazel จะเรียกใช้การทดสอบอีกครั้งก็ต่อเมื่อ (1) Bazel ตรวจพบการเปลี่ยนแปลงในการทดสอบหรือการขึ้นต่อกัน (2) มีการทำเครื่องหมายการทดสอบเป็นภายนอก (3) มีการขอเรียกใช้การทดสอบหลายครั้งด้วย --runs_per_test หรือ(4) การทดสอบล้มเหลวก่อนหน้านี้ หากตั้งค่าเป็น "ใช่" Bazel จะแคชผลการทดสอบทั้งหมด ยกเว้นการทดสอบที่ทำเครื่องหมายเป็นภายนอก หากตั้งค่าเป็น "no" Bazel จะไม่แคชผลการทดสอบใดๆ
--[no]experimental_cancel_concurrent_tests
ค่าเริ่มต้น: "false"-
หากเป็นจริง Blaze จะยกเลิกการทดสอบที่ทำงานพร้อมกันในการทดสอบที่สำเร็จครั้งแรก ซึ่งจะมีประโยชน์เมื่อใช้ร่วมกับ --runs_per_test_detects_flakes เท่านั้น
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะดึงข้อมูลไดเรกทอรีข้อมูลความครอบคลุมทั้งหมดสําหรับการทดสอบแต่ละครั้งในระหว่างการเรียกใช้ความครอบคลุม
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
ค่าเริ่มต้น: "false"-
หากเป็นจริง ความครอบคลุมสำหรับ Clang จะสร้างรายงาน LCOV
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
ค่าเริ่มต้น: "จริง"- จะสร้างส่วนหัว J2ObjC แบบขนานกับการแปลง J2ObjC หรือไม่
--[no]experimental_j2objc_shorter_header_path
ค่าเริ่มต้น: "false"-
เลือกว่าจะสร้างเส้นทางส่วนหัวที่สั้นกว่าหรือไม่ (ใช้ "_ios" แทน "_j2objc")
แท็กaffects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
ค่าเริ่มต้น: "javabuilder"- เปิดใช้ classpath ที่ลดลงสำหรับการคอมไพล์ Java
--[no]experimental_limit_android_lint_to_android_constrained_java
ค่าเริ่มต้น: "false"-
จำกัด --experimental_run_android_lint_on_java_rules ให้ใช้กับไลบรารีที่เข้ากันได้กับ Android
แท็กaffects_outputs
--[no]experimental_run_android_lint_on_java_rules
ค่าเริ่มต้น: "false"-
จะตรวจสอบแหล่งที่มาของ java_* หรือไม่
แท็กaffects_outputs
--[no]explicit_java_test_deps
ค่าเริ่มต้น: "false"- ระบุการขึ้นต่อ JUnit หรือ Hamcrest อย่างชัดเจนใน java_test แทนที่จะรับจาก deps ของ TestRunner โดยไม่ตั้งใจ ขณะนี้ใช้ได้กับ Bazel เท่านั้น
--host_java_launcher=<a build target label>
ค่าเริ่มต้น: ดูคำอธิบาย- ตัวเรียกใช้ Java ที่เครื่องมือใช้ซึ่งจะดำเนินการในระหว่างการสร้าง
--host_javacopt=<a string>
มีการสะสมการใช้งานหลายครั้ง- ตัวเลือกเพิ่มเติมที่จะส่งไปยัง javac เมื่อสร้างเครื่องมือที่เรียกใช้ระหว่างบิลด์
--host_jvmopt=<a string>
มีการสะสมการใช้งานหลายครั้ง- ตัวเลือกเพิ่มเติมที่จะส่งไปยัง Java VM เมื่อสร้างเครื่องมือที่ดำเนินการระหว่างการสร้าง ระบบจะเพิ่มตัวเลือกเหล่านี้ลงในตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
--[no]incompatible_check_sharding_support
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะทำให้การทดสอบที่แยกส่วนล้มเหลวหากโปรแกรมเรียกใช้การทดสอบไม่ได้ระบุว่ารองรับการแยกส่วนโดยการแตะไฟล์ที่เส้นทางใน TEST_SHARD_STATUS_FILE หากเป็นเท็จ โปรแกรมเรียกใช้การทดสอบที่ไม่รองรับการแบ่งพาร์ติชันจะทำให้การทดสอบทั้งหมดทำงานในแต่ละพาร์ติชัน
แท็กincompatible_change
--[no]incompatible_exclusive_test_sandboxed
ค่าเริ่มต้น: "false"-
หากเป็นจริง การทดสอบแบบเฉพาะจะทํางานร่วมกับกลยุทธ์แซนด์บ็อกซ์ เพิ่มแท็ก "local" เพื่อบังคับให้เรียกใช้การทดสอบแบบเฉพาะในเครื่อง
แท็ก:incompatible_change
--[no]incompatible_strict_action_env
ค่าเริ่มต้น: "false"-
หากเป็นจริง 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) ก่อนเริ่มการทดสอบ Implies -test_output=streamed.
ขยายเป็น
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
ค่าเริ่มต้น: "จริง"- สร้างข้อมูลการขึ้นต่อกัน (ตอนนี้คือ classpath เวลาคอมไพล์) ต่อเป้าหมาย Java
--[no]java_header_compilation
ค่าเริ่มต้น: "จริง"- คอมไพล์ ijar จากแหล่งที่มาโดยตรง
--java_language_version=<a string>
ค่าเริ่มต้น: "8"- เวอร์ชันภาษา Java
--java_launcher=<a build target label>
ค่าเริ่มต้น: ดูคำอธิบาย- ตัวเรียกใช้ Java ที่จะใช้เมื่อสร้างไบนารี Java หากตั้งค่าแฟล็กนี้เป็นสตริงว่างเปล่า ระบบจะใช้ตัวเรียกใช้ JDK แอตทริบิวต์ "launcher" จะลบล้างค่าสถานะนี้
--java_runtime_version=<a string>
ค่าเริ่มต้น: "local_jdk"- เวอร์ชันรันไทม์ของ Java
--javacopt=<a string>
มีการสะสมการใช้งานหลายครั้ง- ตัวเลือกเพิ่มเติมที่จะส่งไปยัง javac
--jvmopt=<a string>
มีการสะสมการใช้งานหลายครั้ง- ตัวเลือกเพิ่มเติมที่จะส่งไปยัง Java VM ระบบจะเพิ่มตัวเลือกเหล่านี้ลงในตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
--legacy_main_dex_list_generator=<a build target label>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไบนารีที่จะใช้เพื่อสร้างรายการคลาสที่ต้องอยู่ใน dex หลักเมื่อคอมไพล์ multidex เดิม
--plugin=<a build target label>
มีการสะสมการใช้งานหลายครั้ง- ปลั๊กอินที่จะใช้ในการสร้าง ปัจจุบันใช้ได้กับ java_plugin
--proguard_top=<a build target label>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุเวอร์ชันของ ProGuard ที่จะใช้ในการนำโค้ดออกเมื่อสร้างไบนารี Java
--proto_compiler=<a build target label>
default: "@bazel_tools//tools/proto:protoc"-
ป้ายกำกับของโปรโตคอมไพเลอร์
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
default: "@bazel_tools//tools/proto:cc_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์โปรโตคอล C++
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์โปรโตคอล j2objc
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
default: "@bazel_tools//tools/proto:java_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ Proto ของ Java
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
default: "@bazel_tools//tools/proto:javalite_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์โปรโตคอล JavaLite
แท็ก:affects_outputs
,loading_and_analysis
--protocopt=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยังคอมไพเลอร์ Protobuf
แท็กaffects_outputs
--[no]runs_per_test_detects_flakes
ค่าเริ่มต้น: "false"- หากเป็นจริง ชาร์ดใดก็ตามที่มีการทดสอบ/ความพยายามอย่างน้อย 1 รายการที่ผ่านและมีการทดสอบ/ความพยายามอย่างน้อย 1 รายการที่ไม่ผ่านจะได้รับสถานะไม่น่าเชื่อถือ
--shell_executable=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
เส้นทางแบบสัมบูรณ์ไปยังไฟล์ปฏิบัติการของเชลล์เพื่อให้ Bazel ใช้ หากไม่ได้ตั้งค่านี้ แต่ตั้งค่าตัวแปรสภาพแวดล้อม BAZEL_SH ในการเรียกใช้ Bazel ครั้งแรก (ซึ่งจะเริ่มเซิร์ฟเวอร์ Bazel) Bazel จะใช้ตัวแปรนั้น หากไม่ได้ตั้งค่าทั้ง 2 อย่าง Bazel จะใช้เส้นทางเริ่มต้นที่ฮาร์ดโค้ดไว้โดยขึ้นอยู่กับระบบปฏิบัติการที่ทำงาน (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, ระบบอื่นๆ ทั้งหมด: /bin/bash) โปรดทราบว่าการใช้เชลล์ที่ไม่รองรับ bash อาจทำให้การสร้างล้มเหลวหรือไบนารีที่สร้างขึ้นทำงานล้มเหลว
แท็กloading_and_analysis
--test_arg=<a string>
มีการสะสมการใช้งานหลายครั้ง- ระบุตัวเลือกและอาร์กิวเมนต์เพิ่มเติมที่ควรส่งไปยังไฟล์ปฏิบัติการทดสอบ ใช้ได้หลายครั้งเพื่อระบุอาร์กิวเมนต์หลายรายการ หากมีการเรียกใช้การทดสอบหลายรายการ การทดสอบแต่ละรายการจะได้รับอาร์กิวเมนต์ที่เหมือนกัน ใช้โดยคำสั่ง "bazel test" เท่านั้น
--test_filter=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุตัวกรองที่จะส่งต่อให้กับเฟรมเวิร์กการทดสอบ ใช้เพื่อจำกัดการทดสอบที่เรียกใช้ โปรดทราบว่าการดำเนินการนี้ไม่มีผลต่อเป้าหมายที่จะสร้าง
--test_result_expiration=<an integer>
ค่าเริ่มต้น: "-1"- ตัวเลือกนี้เลิกใช้งานแล้วและไม่มีผล
--[no]test_runner_fail_fast
ค่าเริ่มต้น: "false"- ส่งต่อตัวเลือก "ล้มเหลวอย่างรวดเร็ว" ไปยังโปรแกรมเรียกใช้การทดสอบ โปรแกรมเรียกใช้การทดสอบควรหยุดการดำเนินการเมื่อเกิดข้อผิดพลาดครั้งแรก
--test_sharding_strategy=<explicit or disabled>
ค่าเริ่มต้น: "explicit"- ระบุกลยุทธ์สำหรับการแบ่งการทดสอบ: "explicit" เพื่อใช้การแบ่งก็ต่อเมื่อมีแอตทริบิวต์ BUILD "shard_count" "disabled" เพื่อไม่ให้ใช้การแบ่งพาร์ติชันการทดสอบ
--tool_java_language_version=<a string>
ค่าเริ่มต้น: "8"- เวอร์ชันภาษา Java ที่ใช้ในการเรียกใช้เครื่องมือที่จำเป็นในระหว่างการสร้าง
--tool_java_runtime_version=<a string>
ค่าเริ่มต้น: "remotejdk_11"- เวอร์ชันรันไทม์ของ Java ที่ใช้ในการเรียกใช้เครื่องมือระหว่างการสร้าง
--[no]use_ijars
ค่าเริ่มต้น: "จริง"- หากเปิดใช้ ตัวเลือกนี้จะทำให้การคอมไพล์ Java ใช้ JAR ของอินเทอร์เฟซ ซึ่งจะทําให้การคอมไพล์ที่เพิ่มขึ้นเร็วขึ้น แต่ข้อความแสดงข้อผิดพลาดอาจแตกต่างกัน
ตัวเลือกการถ่ายโอนข้อมูล
- ตัวเลือกที่ปรากฏก่อนคำสั่งและไคลเอ็นต์แยกวิเคราะห์
--distdir=<a path>
มีการสะสมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาไฟล์เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บจะลิงก์แบบฮาร์ดลิงก์ไฟล์ในกรณีที่แคชตรงกันแทนที่จะคัดลอก ซึ่งมีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL เปลี่ยนแปลงและส่งผลให้มีการดาวน์โหลดซ้ำแม้ว่าแคชจะมีรายการที่ดาวน์โหลดซึ่งมีแฮชเดียวกันก็ตาม ซึ่งใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL ไม่ได้ทำให้ที่เก็บข้อมูลเสียหายซึ่งถูกแคชซ่อนไว้
แท็ก:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ จะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็กexperimental
--experimental_repository_downloader_retries=<an integer>
ค่าเริ่มต้น: "0"-
จำนวนครั้งสูงสุดที่พยายามลองดาวน์โหลดซ้ำเมื่อเกิดข้อผิดพลาด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็กexperimental
--experimental_scale_timeouts=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับขนาดการหมดเวลาทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ ด้วยวิธีนี้ คุณจึงทำให้ที่เก็บข้อมูลภายนอกทำงานในเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็กbazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับการหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลดผ่าน http ตามปัจจัยที่ระบุ
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้มาในระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่ง
--[no]action_cache
ค่าเริ่มต้น: "false"-
ส่งออกเนื้อหาแคชการดำเนินการ
แท็กbazel_monitoring
--[no]packages
ค่าเริ่มต้น: "false"-
ทิ้งเนื้อหาแคชของแพ็กเกจ
แท็กbazel_monitoring
--[no]rule_classes
ค่าเริ่มต้น: "false"-
คลาสกฎการทิ้ง
แท็กbazel_monitoring
--[no]rules
ค่าเริ่มต้น: "false"-
กฎการทิ้ง รวมถึงจำนวนและการใช้หน่วยความจำ (หากมีการติดตามหน่วยความจำ)
แท็กbazel_monitoring
--skyframe=<off, summary, count, deps or rdeps>
ค่าเริ่มต้น: "ปิด"-
ทิ้งกราฟ Skyframe: 'off', 'summary', 'count', '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
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้ข้อมูลอินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าสถานะ ฯลฯ)
--experimental_repository_hash_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรมีการยืนยันแฮชของไดเรกทอรีที่เก็บเทียบกับค่านี้
แท็ก:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
มีการสะสมการใช้งานหลายครั้ง-
หากมีรายการกฎที่เก็บที่ควรมีการยืนยันแฮชของไดเรกทอรีเอาต์พุต โดยระบุไฟล์ด้วย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้มีผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ในไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
ค่าเริ่มต้น: "จริง"-
ไม่มีการดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะได้รับอนุญาตในกราฟการอ้างอิงที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่าถูกยกเลิกในรีจิสทรีที่โมดูลมาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น เวอร์ชันที่ถูกเพิกถอนจะทำให้การแก้ไขล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันที่อนุญาตให้ยกเลิกได้ด้วยตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็กloading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ `error` เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาที่ไม่สำเร็จ, `off` เพื่อปิดใช้การตรวจสอบ หรือ `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน
แท็กloading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าการอ้างอิง `bazel_dep` โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้ว ค่าที่ใช้ได้คือ `off` เพื่อปิดใช้การตรวจสอบ, `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน หรือ `error` เพื่อส่งต่อเป็นความล้มเหลวในการแก้ไข
แท็กloading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นการขึ้นต่อกันของนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท ไม่ว่าค่าของแฟล็กนี้จะเป็นอะไรก็ตาม
แท็กloading_and_analysis
--lockfile_mode=<off, update or error>
ค่าเริ่มต้น: "ปิด"-
ระบุวิธีและจะใช้หรือไม่ใช้ไฟล์ล็อก ค่าที่ใช้ได้คือ `update` เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง, `error` เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่อัปเดต หรือ `off` เพื่อไม่ให้อ่านหรือเขียนไปยังไฟล์ล็อก
แท็กloading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
มีการสะสมการใช้งานหลายครั้ง- แทนที่โมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--registry=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้เพื่อค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับมีความสำคัญ โดยระบบจะค้นหาโมดูลในรีจิสทรีที่อยู่ก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีที่อยู่ถัดไปก็ต่อเมื่อไม่มีโมดูลในรีจิสทรีที่อยู่ก่อนหน้า
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อความละเอียด รูปแบบ หรือตำแหน่งของการบันทึก:
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น ระบบจะจำกัดจำนวนประเภทการดำเนินการไว้ที่ 20 นิโมนิกที่มีจำนวนการดำเนินการที่ดำเนินการแล้วมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับทุกคำช่วยจำ
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปในคำสั่ง Bazel ซึ่งไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้อ่านไฟล์ที่ระบุซึ่งแก้ไขแล้วแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
--experimental_downloader_config=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไฟล์เพื่อกำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สำหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ รูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้เป็น URL แทน โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณสามารถระบุคำสั่ง `rewrite` หลายรายการสำหรับ URL เดียวกันได้ และในกรณีนี้ ระบบจะแสดง URL หลายรายการ
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้:
--override_repository=<an equals-separated mapping of repository name to path>
มีการสะสมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุเริ่มต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
ตัวเลือกการดึงข้อมูล
- ตัวเลือกที่ปรากฏก่อนคำสั่งและไคลเอ็นต์แยกวิเคราะห์
--distdir=<a path>
มีการสะสมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาไฟล์เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บจะลิงก์แบบฮาร์ดลิงก์ไฟล์ในกรณีที่แคชตรงกันแทนที่จะคัดลอก ซึ่งมีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL เปลี่ยนแปลงและส่งผลให้มีการดาวน์โหลดซ้ำแม้ว่าแคชจะมีรายการที่ดาวน์โหลดซึ่งมีแฮชเดียวกันก็ตาม ซึ่งใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL ไม่ได้ทำให้ที่เก็บข้อมูลเสียหายซึ่งถูกแคชซ่อนไว้
แท็ก:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ จะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็กexperimental
--experimental_repository_downloader_retries=<an integer>
ค่าเริ่มต้น: "0"-
จำนวนครั้งสูงสุดที่พยายามลองดาวน์โหลดซ้ำเมื่อเกิดข้อผิดพลาด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็กexperimental
--experimental_scale_timeouts=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับขนาดการหมดเวลาทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ ด้วยวิธีนี้ คุณจึงทำให้ที่เก็บข้อมูลภายนอกทำงานในเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็กbazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับการหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลดผ่าน http ตามปัจจัยที่ระบุ
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้มาในระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
--[no]incompatible_remote_dangling_symlinks
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็นจริงและ --incompatible_remote_symlinks เป็นจริงด้วย ระบบจะอนุญาตให้ซิมลิงก์ในเอาต์พุตของการดำเนินการค้างอยู่
แท็ก:execution
,incompatible_change
--[no]incompatible_remote_symlinks
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็น "จริง" Bazel จะแสดงลิงก์สัญลักษณ์ในเอาต์พุตการดำเนินการในโปรโตคอลการแคช/การดำเนินการระยะไกลตามนั้น ไม่เช่นนั้น ระบบจะติดตามลิงก์สัญลักษณ์และแสดงเป็นไฟล์หรือไดเรกทอรี ดูรายละเอียดได้ที่ #6631
แท็ก:execution
,incompatible_change
--[no]keep_going
[-k
] ค่าเริ่มต้น: "false"-
ดำเนินการต่อให้ได้มากที่สุดหลังจากเกิดข้อผิดพลาด แม้ว่าจะวิเคราะห์เป้าหมายที่ล้มเหลวและเป้าหมายที่ขึ้นอยู่กับเป้าหมายนั้นไม่ได้ แต่ก็วิเคราะห์ข้อกำหนดเบื้องต้นอื่นๆ ของเป้าหมายเหล่านี้ได้
แท็ก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">
ค่าเริ่มต้น: "auto"-
จำนวนเธรดแบบขนานที่จะใช้ในระยะการโหลด/วิเคราะห์ รับค่าจำนวนเต็มหรือคีย์เวิร์ด ("auto", "HOST_CPUS", "HOST_RAM") ตามด้วยการดำเนินการ ([-|*]<float>) เช่น "auto", "HOST_CPUS*.5" "auto" จะตั้งค่าเริ่มต้นที่เหมาะสมตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ช่วยให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการ ซึ่งจะส่งผลต่อค่าของเอาต์พุตนั้น ไม่ใช่การมีอยู่ของเอาต์พุต
--bep_maximum_open_remote_upload_files=<an integer>
ค่าเริ่มต้น: "-1"-
จำนวนไฟล์ที่เปิดสูงสุดที่อนุญาตในระหว่างการอัปโหลดอาร์ติแฟกต์ BEP
แท็กaffects_outputs
--remote_download_minimal
-
ไม่ดาวน์โหลดเอาต์พุตการสร้างระยะไกลไปยังเครื่องในระบบ Flag นี้เป็นทางลัดสำหรับ Flag: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata และ --remote_download_outputs=minimal
ขยายเป็น
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
แท็กaffects_outputs
--remote_download_outputs=<all, minimal or toplevel>
ค่าเริ่มต้น: "all"-
หากตั้งค่าเป็น "น้อยที่สุด" จะไม่ดาวน์โหลดเอาต์พุตการสร้างจากระยะไกลไปยังเครื่องในพื้นที่ ยกเว้นเอาต์พุตที่การกระทำในพื้นที่กำหนด หากตั้งค่าเป็น "toplevel" จะทํางานเหมือน "minimal" ยกเว้นว่าจะดาวน์โหลดเอาต์พุตของเป้าหมายระดับบนสุดไปยังเครื่องในเครื่องด้วย ทั้ง 2 ตัวเลือกช่วยลดเวลาในการสร้างได้อย่างมากหากแบนด์วิดท์เครือข่ายเป็นคอขวด
แท็กaffects_outputs
--remote_download_symlink_template=<a string>
ค่าเริ่มต้น: ""-
สร้างลิงก์สัญลักษณ์แทนการดาวน์โหลดเอาต์พุตบิลด์ระยะไกลไปยังเครื่องภายใน คุณระบุเป้าหมายของลิงก์สัญลักษณ์ได้ในรูปแบบของสตริงเทมเพลต สตริงเทมเพลตนี้อาจมี {hash} และ {size_bytes} ซึ่งจะขยายเป็นแฮชของออบเจ็กต์และขนาดในหน่วยไบต์ตามลำดับ ตัวอย่างเช่น ลิงก์สัญลักษณ์เหล่านี้อาจชี้ไปยังระบบไฟล์ FUSE ที่โหลดออบเจ็กต์จาก CAS ตามต้องการ
แท็กaffects_outputs
--remote_download_toplevel
-
ดาวน์โหลดเฉพาะเอาต์พุตระยะไกลของเป้าหมายระดับบนสุดไปยังเครื่องในเครื่อง Flag นี้เป็นทางลัดสำหรับ Flag: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata และ --remote_download_outputs=toplevel
ขยายเป็น
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
แท็กaffects_outputs
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้ข้อมูลอินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าสถานะ ฯลฯ)
--experimental_repository_hash_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรมีการยืนยันแฮชของไดเรกทอรีที่เก็บเทียบกับค่านี้
แท็ก:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
มีการสะสมการใช้งานหลายครั้ง-
หากมีรายการกฎที่เก็บที่ควรมีการยืนยันแฮชของไดเรกทอรีเอาต์พุต โดยระบุไฟล์ด้วย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้มีผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ในไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
ค่าเริ่มต้น: "จริง"-
แท็ก No-op
:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
ค่าเริ่มต้น: "false"-
หาก incompatible_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
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ให้บังคับใช้การจำกัดระดับการแชร์ config_setting หากเป็นเท็จ ทุกการตั้งค่า config จะมองเห็นได้สำหรับทุกเป้าหมาย ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะได้รับอนุญาตในกราฟการอ้างอิงที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่าถูกยกเลิกในรีจิสทรีที่โมดูลมาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น เวอร์ชันที่ถูกเพิกถอนจะทำให้การแก้ไขล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันที่อนุญาตให้ยกเลิกได้ด้วยตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็กloading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ `error` เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาที่ไม่สำเร็จ, `off` เพื่อปิดใช้การตรวจสอบ หรือ `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน
แท็กloading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าการอ้างอิง `bazel_dep` โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้ว ค่าที่ใช้ได้คือ `off` เพื่อปิดใช้การตรวจสอบ, `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน หรือ `error` เพื่อส่งต่อเป็นความล้มเหลวในการแก้ไข
แท็กloading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นการขึ้นต่อกันของนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท ไม่ว่าค่าของแฟล็กนี้จะเป็นอะไรก็ตาม
แท็กloading_and_analysis
--lockfile_mode=<off, update or error>
ค่าเริ่มต้น: "ปิด"-
ระบุวิธีและจะใช้หรือไม่ใช้ไฟล์ล็อก ค่าที่ใช้ได้คือ `update` เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง, `error` เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่อัปเดต หรือ `off` เพื่อไม่ให้อ่านหรือเขียนไปยังไฟล์ล็อก
แท็กloading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
มีการสะสมการใช้งานหลายครั้ง- แทนที่โมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--registry=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้เพื่อค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับมีความสำคัญ โดยระบบจะค้นหาโมดูลในรีจิสทรีที่อยู่ก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีที่อยู่ถัดไปก็ต่อเมื่อไม่มีโมดูลในรีจิสทรีที่อยู่ก่อนหน้า
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อความละเอียด รูปแบบ หรือตำแหน่งของการบันทึก:
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น ระบบจะจำกัดจำนวนประเภทการดำเนินการไว้ที่ 20 นิโมนิกที่มีจำนวนการดำเนินการที่ดำเนินการแล้วมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับทุกคำช่วยจำ
--experimental_repository_resolved_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้เขียนค่า Starlark พร้อมข้อมูลที่แก้ไขแล้วของกฎที่เก็บ Starlark ทั้งหมดที่ดำเนินการ
แท็กaffects_outputs
--remote_print_execution_messages=<failure, success or all>
ค่าเริ่มต้น: "failure"-
เลือกเวลาที่จะพิมพ์ข้อความการดำเนินการจากระยะไกล ค่าที่ใช้ได้คือ `failure` เพื่อพิมพ์เฉพาะเมื่อเกิดข้อผิดพลาด `success` เพื่อพิมพ์เฉพาะเมื่อสำเร็จ และ `all` เพื่อพิมพ์เสมอ
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้อ่านไฟล์ที่ระบุซึ่งแก้ไขแล้วแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
--experimental_circuit_breaker_strategy=<failure>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุกลยุทธ์สำหรับเบรกเกอร์ที่จะใช้ กลยุทธ์ที่ใช้ได้คือ "failure" หากค่าของตัวเลือกไม่ถูกต้อง ลักษณะการทำงานจะเหมือนกับไม่ได้ตั้งค่าตัวเลือก
แท็กexecution
--experimental_downloader_config=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไฟล์เพื่อกำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สำหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ รูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้เป็น URL แทน โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณสามารถระบุคำสั่ง `rewrite` หลายรายการสำหรับ URL เดียวกันได้ และในกรณีนี้ ระบบจะแสดง URL หลายรายการ
--[no]experimental_guard_against_concurrent_changes
ค่าเริ่มต้น: "false"- ปิดตัวเลือกนี้เพื่อปิดใช้การตรวจสอบ ctime ของไฟล์อินพุตของการดำเนินการก่อนอัปโหลดไปยังแคชระยะไกล อาจมีกรณีที่เคอร์เนล Linux หน่วงเวลาการเขียนไฟล์ ซึ่งอาจทำให้เกิดผลบวกเท็จ
--experimental_remote_build_event_upload=<all or minimal>
ค่าเริ่มต้น: "all"- หากตั้งค่าเป็น "all" ระบบจะอัปโหลดเอาต์พุตในพื้นที่ทั้งหมดที่ BEP อ้างอิงไปยังแคชระยะไกล หากตั้งค่าเป็น "น้อยที่สุด" ระบบจะไม่ส่งเอาต์พุตในเครื่องที่ BEP อ้างอิงไปยังแคชระยะไกล ยกเว้นไฟล์ที่มีความสำคัญต่อผู้ใช้ BEP (เช่น บันทึกการทดสอบและโปรไฟล์เวลา) ระบบจะใช้รูปแบบ bytestream:// สำหรับ URI ของไฟล์เสมอแม้ว่าจะไม่มีไฟล์ในแคชระยะไกลก็ตาม ค่าเริ่มต้นคือ "ทั้งหมด"
--[no]experimental_remote_cache_async
ค่าเริ่มต้น: "false"- หากเป็นจริง I/O ของแคชระยะไกลจะเกิดขึ้นในเบื้องหลังแทนที่จะเป็นส่วนหนึ่งของการเกิด
--[no]experimental_remote_cache_compression
ค่าเริ่มต้น: "false"- หากเปิดใช้ ให้บีบอัด/คลายการบีบอัด Blob ของแคชด้วย zstd
--experimental_remote_capture_corrupted_outputs=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย- เส้นทางไปยังไดเรกทอรีที่จะบันทึกเอาต์พุตที่เสียหาย
--[no]experimental_remote_discard_merkle_trees
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น true ให้ทิ้งสำเนาในหน่วยความจำของต้นไม้ Merkle ของรูทอินพุตและการแมปอินพุตที่เชื่อมโยงระหว่างการเรียก GetActionResult() และ Execute() ซึ่งจะช่วยลดการใช้หน่วยความจำได้อย่างมาก แต่ต้องให้ Bazel คำนวณใหม่เมื่อแคชระยะไกลไม่พบและมีการลองใหม่
--experimental_remote_downloader=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- URI ของปลายทาง Remote Asset API ที่จะใช้เป็นพร็อกซีการดาวน์โหลดจากระยะไกล สคีมาที่รองรับคือ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ unix (ซ็อกเก็ต UNIX ในเครื่อง) หากไม่ได้ระบุสคีมา Bazel จะใช้ grpcs เป็นค่าเริ่มต้น ดูที่ https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
ค่าเริ่มต้น: "false"- ว่าจะกลับไปใช้โปรแกรมดาวน์โหลดในเครื่องหรือไม่หากโปรแกรมดาวน์โหลดระยะไกลล้มเหลว
--[no]experimental_remote_execution_keepalive
ค่าเริ่มต้น: "false"- ว่าจะใช้ 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.>
ค่าเริ่มต้น: "60s"-
ช่วงเวลาที่ใช้ในการคำนวณอัตราความล้มเหลวของคำขอระยะไกล หากค่าเป็น 0 หรือค่าลบ ระบบจะคำนวณระยะเวลาที่ล้มเหลวตลอดระยะเวลาการดำเนินการทั้งหมด คุณสามารถใช้หน่วยต่อไปนี้ได้ วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
แท็กexecution
--[no]experimental_remote_mark_tool_inputs
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" Bazel จะทำเครื่องหมายอินพุตเป็นอินพุตเครื่องมือสำหรับตัวดำเนินการระยะไกล ซึ่งใช้เพื่อติดตั้งใช้งานพนักงานแบบถาวรที่ทำงานจากระยะไกลได้
--[no]experimental_remote_merkle_tree_cache
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" ระบบจะบันทึกการคำนวณ Merkle Tree เพื่อปรับปรุงความเร็วในการตรวจสอบแคชระยะไกล ระบบจะควบคุมปริมาณหน่วยความจำของแคชโดยใช้ --experimental_remote_merkle_tree_cache_size
--experimental_remote_merkle_tree_cache_size=<a long integer>
ค่าเริ่มต้น: "1000"- จำนวนต้นไม้ Merkle ที่จะบันทึกเพื่อปรับปรุงความเร็วในการตรวจสอบการเข้าถึงแคชระยะไกล แม้ว่าระบบจะล้างแคชโดยอัตโนมัติตามการจัดการการอ้างอิงแบบอ่อนของ Java แต่ข้อผิดพลาดหน่วยความจำไม่เพียงพออาจเกิดขึ้นได้หากตั้งค่าสูงเกินไป หากตั้งค่าเป็น 0 ระบบจะไม่จำกัดขนาดแคช ค่าที่เหมาะสมจะแตกต่างกันไปตามขนาดของโปรเจ็กต์ ค่าเริ่มต้นคือ 1,000
--[no]experimental_remote_require_cached
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" ให้บังคับแคชการดำเนินการทั้งหมดที่เรียกใช้จากระยะไกลได้ หรือไม่เช่นนั้นให้สร้างไม่สำเร็จ ซึ่งจะเป็นประโยชน์ในการแก้ปัญหาเกี่ยวกับความไม่แน่นอน เนื่องจากช่วยให้ตรวจสอบได้ว่าการดำเนินการที่ควรแคชนั้นแคชจริงหรือไม่ โดยไม่ต้องแทรกผลลัพธ์ใหม่ที่ไม่เกี่ยวข้องลงในแคช
--[no]incompatible_remote_build_event_upload_respect_no_cache
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" ระบบจะไม่โหลดเอาต์พุตที่ BEP อ้างอิงไปยังแคชระยะไกลหากแคชการดำเนินการสร้างจากระยะไกลไม่ได้
--[no]incompatible_remote_downloader_send_all_headers
ค่าเริ่มต้น: "จริง"-
เลือกว่าจะส่งค่าทั้งหมดของส่วนหัวที่มีหลายค่าไปยังโปรแกรมดาวน์โหลดระยะไกลแทนที่จะส่งเฉพาะค่าแรกหรือไม่
แท็กincompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" เส้นทางเอาต์พุตจะสัมพันธ์กับรูทอินพุตแทนที่จะเป็นไดเรกทอรีการทำงาน
แท็กincompatible_change
--[no]incompatible_remote_results_ignore_disk
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็น "จริง" ระบบจะไม่ใช้ --noremote_upload_local_results และ --noremote_accept_cached กับแคชในดิสก์ หากใช้แคชแบบรวม
--noremote_upload_local_results จะทำให้ระบบเขียนผลลัพธ์ลงในแคชในดิสก์ แต่จะไม่ส่งไปยังแคชระยะไกล
--noremote_accept_cached จะทำให้ Bazel ตรวจสอบผลลัพธ์ในแคชในดิสก์ แต่ไม่ใช่ในแคชระยะไกล
การดำเนินการ no-remote-exec สามารถเข้าถึงแคชในดิสก์ได้
ดูรายละเอียดได้ที่ #8216
แท็กincompatible_change
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" Bazel จะใช้รหัสออกใหม่ 39 แทน 34 หากแคชระยะไกลลบออบเจ็กต์ BLOB ระหว่างการสร้าง
แท็กincompatible_change
--[no]remote_accept_cached
ค่าเริ่มต้น: "จริง"- เลือกว่าจะยอมรับผลลัพธ์ของการดำเนินการที่แคชไว้จากระยะไกลหรือไม่
--remote_bytestream_uri_prefix=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ชื่อโฮสต์และชื่ออินสแตนซ์ที่จะใช้ใน URI ของ bytestream:// ที่เขียนลงในสตรีมเหตุการณ์บิลด์ คุณตั้งค่าตัวเลือกนี้ได้เมื่อทำการบิลด์โดยใช้พร็อกซี ซึ่งจะทำให้ค่าของ --remote_executor และ --remote_instance_name ไม่สอดคล้องกับชื่อที่แน่นอนของบริการการดำเนินการจากระยะไกลอีกต่อไป หากไม่ได้ตั้งค่าไว้ ค่าเริ่มต้นจะเป็น "${hostname}/${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
--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_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 บันทึกนี้ประกอบด้วยลำดับของ protobuf com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry ที่ทำให้เป็นอนุกรม โดยแต่ละข้อความจะมีคำนำหน้าเป็น varint ที่ระบุขนาดของข้อความ protobuf ที่ทำให้เป็นอนุกรมต่อไปนี้ ตามที่ดำเนินการโดยเมธอด 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
ค่าเริ่มต้น: "false"- จะกลับไปใช้กลยุทธ์การดำเนินการในเครื่องแบบสแตนด์อโลนหรือไม่หากการดำเนินการจากระยะไกลล้มเหลว
--remote_local_fallback_strategy=<a string>
ค่าเริ่มต้น: "local"- ไม่มีการดำเนินการ เลิกใช้งานแล้ว ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7480
--remote_max_connections=<an integer>
ค่าเริ่มต้น: "100"-
จำกัดจำนวนการเชื่อมต่อพร้อมกันสูงสุดกับแคช/เครื่องมือดำเนินการระยะไกล โดยค่าเริ่มต้น ค่านี้จะเป็น 100 การตั้งค่านี้เป็น 0 หมายความว่าไม่มีข้อจำกัด
สำหรับแคชระยะไกล HTTP การเชื่อมต่อ TCP หนึ่งรายการจะจัดการคำขอได้ครั้งละ 1 รายการ ดังนั้น Bazel จึงสามารถส่งคำขอพร้อมกันได้สูงสุด --remote_max_connections
สำหรับแคช/ตัวดำเนินการระยะไกล gRPC โดยปกติแล้วแชแนล gRPC 1 รายการจะจัดการคำขอพร้อมกันได้มากกว่า 100 รายการ ดังนั้น Bazel จึงสามารถส่งคำขอพร้อมกันได้ประมาณ `--remote_max_connections * 100` รายการ
แท็กhost_machine_resource_optimizations
--remote_proxy=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- เชื่อมต่อกับแคชระยะไกลผ่านพร็อกซี ปัจจุบันนี้ คุณใช้แฟล็กนี้เพื่อกำหนดค่า Unix Domain Socket (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), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
--remote_timeout=<An immutable length of time.>
ค่าเริ่มต้น: "60s"- ระยะเวลารอสูงสุดสำหรับการเรียกการดำเนินการระยะไกลและการเรียกแคช สำหรับแคช REST นี่คือทั้งการเชื่อมต่อและการหมดเวลาในการอ่าน คุณใช้หน่วยต่อไปนี้ได้ วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
--[no]remote_upload_local_results
ค่าเริ่มต้น: "จริง"- ว่าจะอัปโหลดผลการดำเนินการที่เรียกใช้ในเครื่องไปยังแคชระยะไกลหรือไม่ หากแคชระยะไกลรองรับและผู้ใช้ได้รับอนุญาตให้ดำเนินการดังกล่าว
--[no]remote_verify_downloads
ค่าเริ่มต้น: "จริง"- หากตั้งค่าเป็น true Bazel จะคำนวณผลรวมแฮชของการดาวน์โหลดจากระยะไกลทั้งหมด และทิ้งค่าที่แคชจากระยะไกลหากไม่ตรงกับค่าที่คาดไว้
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้:
--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.>
มีการสะสมการใช้งานหลายครั้ง- กำหนดค่าโปรแกรมช่วยเหลือข้อมูลเข้าสู่ระบบที่จะใช้ในการดึงข้อมูลเข้าสู่ระบบการให้สิทธิ์สำหรับการดึงข้อมูลที่เก็บ การแคชและการดำเนินการระยะไกล และบริการเหตุการณ์การสร้าง ข้อมูลเข้าสู่ระบบที่ตัวช่วยระบุจะมีลำดับความสำคัญเหนือกว่าข้อมูลเข้าสู่ระบบที่ระบุโดย --google_default_credentials, --google_credentials, ไฟล์ .netrc หรือพารามิเตอร์การตรวจสอบสิทธิ์ไปยัง repository_ctx.download และ repository_ctx.download_and_extract ระบุได้หลายครั้งเพื่อตั้งค่าผู้ช่วยหลายราย ดูรายละเอียดได้ที่ https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md
--credential_helper_cache_duration=<An immutable length of time.>
ค่าเริ่มต้น: "30m"- ระยะเวลาที่ระบบจะแคชข้อมูลเข้าสู่ระบบที่ตัวช่วยข้อมูลเข้าสู่ระบบระบุ การเรียกใช้ด้วยค่าอื่นจะปรับอายุการใช้งานของรายการที่มีอยู่แล้ว ให้ส่งค่า 0 เพื่อล้างแคช คำสั่ง clean จะล้างแคชเสมอ ไม่ว่าจะมีแฟล็กนี้หรือไม่ก็ตาม
--credential_helper_timeout=<An immutable length of time.>
ค่าเริ่มต้น: "10s"- กำหนดค่าการหมดเวลาสำหรับโปรแกรมช่วยจัดการข้อมูลเข้าสู่ระบบ หากผู้ช่วยจัดการข้อมูลเข้าสู่ระบบไม่ตอบกลับภายในระยะหมดเวลานี้ การเรียกใช้จะล้มเหลว
--deleted_packages=<comma-separated list of package names>
ค่าเริ่มต้น: ""- รายการชื่อแพ็กเกจที่คั่นด้วยคอมมา ซึ่งระบบบิลด์จะถือว่าไม่มีอยู่ แม้ว่าจะมองเห็นได้ที่ใดที่หนึ่งในเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ เช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์แล้ว ระบบบิลด์อาจแจ้งข้อผิดพลาดหากพบป้ายกำกับ "//x:y/z" หากรายการ package_path อื่นยังคงระบุป้ายกำกับนั้น การระบุ --deleted_packages x/y จะช่วยหลีกเลี่ยงปัญหานี้ได้
--disk_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย- เส้นทางไปยังไดเรกทอรีที่ Bazel อ่านและเขียนการดำเนินการและเอาต์พุตของการดำเนินการได้ หากยังไม่มีไดเรกทอรี ระบบจะสร้างให้
--google_auth_scopes=<comma-separated list of options>
default: "https://www.googleapis.com/auth/cloud-platform"- รายการขอบเขตการตรวจสอบสิทธิ์ของ Google Cloud ที่คั่นด้วยคอมมา
--google_credentials=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไฟล์ที่จะรับข้อมูลเข้าสู่ระบบสำหรับการตรวจสอบสิทธิ์ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication
--[no]google_default_credentials
ค่าเริ่มต้น: "false"- ว่าจะใช้ "ข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชันของ Google" สำหรับการตรวจสอบสิทธิ์หรือไม่ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication ปิดใช้โดยค่าเริ่มต้น
--grpc_keepalive_time=<An immutable length of time.>
ค่าเริ่มต้น: ดูคำอธิบาย- กำหนดค่า Ping Keep-Alive สำหรับการเชื่อมต่อ gRPC ขาออก หากตั้งค่านี้ไว้ Bazel จะส่งการ Ping หลังจากไม่มีการดำเนินการอ่านในการเชื่อมต่อเป็นเวลานานเท่านี้ แต่จะส่งก็ต่อเมื่อมีการเรียก gRPC ที่รอดำเนินการอย่างน้อย 1 รายการ ระบบจะถือว่าเวลาเป็นหน่วยวินาที การตั้งค่าที่น้อยกว่า 1 วินาทีถือเป็นข้อผิดพลาด โดยค่าเริ่มต้น ระบบจะปิดใช้ Ping Keep-Alive คุณควรประสานงานกับเจ้าของบริการก่อนที่จะเปิดใช้การตั้งค่านี้ เช่น หากต้องการตั้งค่าเป็น 30 วินาที ให้ทำดังนี้ --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.>
ค่าเริ่มต้น: "20s"- กำหนดค่าการหมดเวลา Keep-Alive สำหรับการเชื่อมต่อ gRPC ขาออก หากเปิดใช้คำสั่ง ping keep-alive ด้วย --grpc_keepalive_time Bazel จะหมดเวลาการเชื่อมต่อหากไม่ได้รับการตอบกลับคำสั่ง ping หลังจากผ่านไประยะเวลาดังกล่าว ระบบจะถือว่าเวลาเป็นหน่วยวินาที การตั้งค่าที่น้อยกว่า 1 วินาทีถือเป็นข้อผิดพลาด หากปิดใช้ Ping Keep-Alive ระบบจะไม่สนใจการตั้งค่านี้
--override_repository=<an equals-separated mapping of repository name to path>
มีการสะสมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--package_path=<colon-separated list of options>
ค่าเริ่มต้น: "%workspace%"- รายการที่คั่นด้วยโคลอนของตำแหน่งที่จะค้นหาแพ็กเกจ องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับเวิร์กสเปซที่ครอบคลุม หากละไว้หรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
--[no]show_loading_progress
ค่าเริ่มต้น: "จริง"- หากเปิดใช้ จะทำให้ Bazel พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ"
--tls_certificate=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุเส้นทางไปยังใบรับรอง TLS ที่เชื่อถือได้ในการลงนามใบรับรองเซิร์ฟเวอร์
--tls_client_certificate=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุใบรับรองไคลเอ็นต์ TLS ที่จะใช้ คุณต้องระบุคีย์ไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
--tls_client_key=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุคีย์ไคลเอ็นต์ TLS ที่จะใช้ คุณต้องระบุใบรับรองไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
ตัวเลือกความช่วยเหลือ
- ตัวเลือกที่ปรากฏก่อนคำสั่งและไคลเอ็นต์แยกวิเคราะห์
--distdir=<a path>
มีการสะสมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาไฟล์เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บจะลิงก์แบบฮาร์ดลิงก์ไฟล์ในกรณีที่แคชตรงกันแทนที่จะคัดลอก ซึ่งมีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL เปลี่ยนแปลงและส่งผลให้มีการดาวน์โหลดซ้ำแม้ว่าแคชจะมีรายการที่ดาวน์โหลดซึ่งมีแฮชเดียวกันก็ตาม ซึ่งใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL ไม่ได้ทำให้ที่เก็บข้อมูลเสียหายซึ่งถูกแคชซ่อนไว้
แท็ก:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ จะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็กexperimental
--experimental_repository_downloader_retries=<an integer>
ค่าเริ่มต้น: "0"-
จำนวนครั้งสูงสุดที่พยายามลองดาวน์โหลดซ้ำเมื่อเกิดข้อผิดพลาด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็กexperimental
--experimental_scale_timeouts=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับขนาดการหมดเวลาทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ ด้วยวิธีนี้ คุณจึงทำให้ที่เก็บข้อมูลภายนอกทำงานในเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็กbazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับการหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลดผ่าน http ตามปัจจัยที่ระบุ
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้มาในระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้ข้อมูลอินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าสถานะ ฯลฯ):
--experimental_repository_hash_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรมีการยืนยันแฮชของไดเรกทอรีที่เก็บเทียบกับค่านี้
แท็ก:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
มีการสะสมการใช้งานหลายครั้ง-
หากมีรายการกฎที่เก็บที่ควรมีการยืนยันแฮชของไดเรกทอรีเอาต์พุต โดยระบุไฟล์ด้วย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้มีผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ในไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
ค่าเริ่มต้น: "จริง"-
ไม่มีการดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะได้รับอนุญาตในกราฟการอ้างอิงที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่าถูกยกเลิกในรีจิสทรีที่โมดูลมาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น เวอร์ชันที่ถูกเพิกถอนจะทำให้การแก้ไขล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันที่อนุญาตให้ยกเลิกได้ด้วยตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็กloading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ `error` เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาที่ไม่สำเร็จ, `off` เพื่อปิดใช้การตรวจสอบ หรือ `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน
แท็กloading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าการอ้างอิง `bazel_dep` โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้ว ค่าที่ใช้ได้คือ `off` เพื่อปิดใช้การตรวจสอบ, `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน หรือ `error` เพื่อส่งต่อเป็นความล้มเหลวในการแก้ไข
แท็กloading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นการขึ้นต่อกันของนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท ไม่ว่าค่าของแฟล็กนี้จะเป็นอะไรก็ตาม
แท็กloading_and_analysis
--lockfile_mode=<off, update or error>
ค่าเริ่มต้น: "ปิด"-
ระบุวิธีและจะใช้หรือไม่ใช้ไฟล์ล็อก ค่าที่ใช้ได้คือ `update` เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง, `error` เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่อัปเดต หรือ `off` เพื่อไม่ให้อ่านหรือเขียนไปยังไฟล์ล็อก
แท็กloading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
มีการสะสมการใช้งานหลายครั้ง- แทนที่โมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--registry=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้เพื่อค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับมีความสำคัญ โดยระบบจะค้นหาโมดูลในรีจิสทรีที่อยู่ก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีที่อยู่ถัดไปก็ต่อเมื่อไม่มีโมดูลในรีจิสทรีที่อยู่ก่อนหน้า
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อความละเอียด รูปแบบ หรือตำแหน่งของการบันทึก:
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น ระบบจะจำกัดจำนวนประเภทการดำเนินการไว้ที่ 20 นิโมนิกที่มีจำนวนการดำเนินการที่ดำเนินการแล้วมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับทุกคำช่วยจำ
--help_verbosity=<long, medium or short>
ค่าเริ่มต้น: "ปานกลาง"-
เลือกระดับความละเอียดของคำสั่ง help
แท็ก: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`) หรือรูปแบบ 2 รูปแบบ รูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้เป็น URL แทน โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณสามารถระบุคำสั่ง `rewrite` หลายรายการสำหรับ URL เดียวกันได้ และในกรณีนี้ ระบบจะแสดง URL หลายรายการ
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้:
--override_repository=<an equals-separated mapping of repository name to path>
มีการสะสมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุเริ่มต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
ตัวเลือกข้อมูล
รับตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคำสั่งและไคลเอ็นต์แยกวิเคราะห์
--distdir=<a path>
มีการสะสมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาไฟล์เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บจะลิงก์แบบฮาร์ดลิงก์ไฟล์ในกรณีที่แคชตรงกันแทนที่จะคัดลอก ซึ่งมีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL เปลี่ยนแปลงและส่งผลให้มีการดาวน์โหลดซ้ำแม้ว่าแคชจะมีรายการที่ดาวน์โหลดซึ่งมีแฮชเดียวกันก็ตาม ซึ่งใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL ไม่ได้ทำให้ที่เก็บข้อมูลเสียหายซึ่งถูกแคชซ่อนไว้
แท็ก:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ จะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็กexperimental
--experimental_repository_downloader_retries=<an integer>
ค่าเริ่มต้น: "0"-
จำนวนครั้งสูงสุดที่พยายามลองดาวน์โหลดซ้ำเมื่อเกิดข้อผิดพลาด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็กexperimental
--experimental_scale_timeouts=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับขนาดการหมดเวลาทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ ด้วยวิธีนี้ คุณจึงทำให้ที่เก็บข้อมูลภายนอกทำงานในเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็กbazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับการหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลดผ่าน http ตามปัจจัยที่ระบุ
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้มาในระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้ข้อมูลอินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าสถานะ ฯลฯ):
--experimental_repository_hash_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรมีการยืนยันแฮชของไดเรกทอรีที่เก็บเทียบกับค่านี้
แท็ก:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
มีการสะสมการใช้งานหลายครั้ง-
หากมีรายการกฎที่เก็บที่ควรมีการยืนยันแฮชของไดเรกทอรีเอาต์พุต โดยระบุไฟล์ด้วย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้มีผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ในไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
ค่าเริ่มต้น: "จริง"-
ไม่มีการดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะได้รับอนุญาตในกราฟการอ้างอิงที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่าถูกยกเลิกในรีจิสทรีที่โมดูลมาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น เวอร์ชันที่ถูกเพิกถอนจะทำให้การแก้ไขล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันที่อนุญาตให้ยกเลิกได้ด้วยตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็กloading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ `error` เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาที่ไม่สำเร็จ, `off` เพื่อปิดใช้การตรวจสอบ หรือ `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน
แท็กloading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าการอ้างอิง `bazel_dep` โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้ว ค่าที่ใช้ได้คือ `off` เพื่อปิดใช้การตรวจสอบ, `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน หรือ `error` เพื่อส่งต่อเป็นความล้มเหลวในการแก้ไข
แท็กloading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นการขึ้นต่อกันของนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท ไม่ว่าค่าของแฟล็กนี้จะเป็นอะไรก็ตาม
แท็กloading_and_analysis
--lockfile_mode=<off, update or error>
ค่าเริ่มต้น: "ปิด"-
ระบุวิธีและจะใช้หรือไม่ใช้ไฟล์ล็อก ค่าที่ใช้ได้คือ `update` เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง, `error` เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่อัปเดต หรือ `off` เพื่อไม่ให้อ่านหรือเขียนไปยังไฟล์ล็อก
แท็กloading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
มีการสะสมการใช้งานหลายครั้ง- แทนที่โมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--registry=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้เพื่อค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับมีความสำคัญ โดยระบบจะค้นหาโมดูลในรีจิสทรีที่อยู่ก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีที่อยู่ถัดไปก็ต่อเมื่อไม่มีโมดูลในรีจิสทรีที่อยู่ก่อนหน้า
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อความละเอียด รูปแบบ หรือตำแหน่งของการบันทึก:
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น ระบบจะจำกัดจำนวนประเภทการดำเนินการไว้ที่ 20 นิโมนิกที่มีจำนวนการดำเนินการที่ดำเนินการแล้วมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับทุกคำช่วยจำ
--[no]show_make_env
ค่าเริ่มต้น: "false"-
รวมสภาพแวดล้อม "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`) หรือรูปแบบ 2 รูปแบบ รูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้เป็น URL แทน โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณสามารถระบุคำสั่ง `rewrite` หลายรายการสำหรับ URL เดียวกันได้ และในกรณีนี้ ระบบจะแสดง URL หลายรายการ
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้:
--override_repository=<an equals-separated mapping of repository name to path>
มีการสะสมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุเริ่มต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
ตัวเลือกใบอนุญาต
- ตัวเลือกที่ปรากฏก่อนคำสั่งและไคลเอ็นต์แยกวิเคราะห์
--distdir=<a path>
มีการสะสมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาไฟล์เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บจะลิงก์แบบฮาร์ดลิงก์ไฟล์ในกรณีที่แคชตรงกันแทนที่จะคัดลอก ซึ่งมีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL เปลี่ยนแปลงและส่งผลให้มีการดาวน์โหลดซ้ำแม้ว่าแคชจะมีรายการที่ดาวน์โหลดซึ่งมีแฮชเดียวกันก็ตาม ซึ่งใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL ไม่ได้ทำให้ที่เก็บข้อมูลเสียหายซึ่งถูกแคชซ่อนไว้
แท็ก:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ จะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็กexperimental
--experimental_repository_downloader_retries=<an integer>
ค่าเริ่มต้น: "0"-
จำนวนครั้งสูงสุดที่พยายามลองดาวน์โหลดซ้ำเมื่อเกิดข้อผิดพลาด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็กexperimental
--experimental_scale_timeouts=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับขนาดการหมดเวลาทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ ด้วยวิธีนี้ คุณจึงทำให้ที่เก็บข้อมูลภายนอกทำงานในเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็กbazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับการหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลดผ่าน http ตามปัจจัยที่ระบุ
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้มาในระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้ข้อมูลอินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าสถานะ ฯลฯ):
--experimental_repository_hash_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรมีการยืนยันแฮชของไดเรกทอรีที่เก็บเทียบกับค่านี้
แท็ก:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
มีการสะสมการใช้งานหลายครั้ง-
หากมีรายการกฎที่เก็บที่ควรมีการยืนยันแฮชของไดเรกทอรีเอาต์พุต โดยระบุไฟล์ด้วย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้มีผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ในไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
ค่าเริ่มต้น: "จริง"-
ไม่มีการดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะได้รับอนุญาตในกราฟการอ้างอิงที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่าถูกยกเลิกในรีจิสทรีที่โมดูลมาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น เวอร์ชันที่ถูกเพิกถอนจะทำให้การแก้ไขล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันที่อนุญาตให้ยกเลิกได้ด้วยตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็กloading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ `error` เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาที่ไม่สำเร็จ, `off` เพื่อปิดใช้การตรวจสอบ หรือ `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน
แท็กloading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าการอ้างอิง `bazel_dep` โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้ว ค่าที่ใช้ได้คือ `off` เพื่อปิดใช้การตรวจสอบ, `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน หรือ `error` เพื่อส่งต่อเป็นความล้มเหลวในการแก้ไข
แท็กloading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นการขึ้นต่อกันของนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท ไม่ว่าค่าของแฟล็กนี้จะเป็นอะไรก็ตาม
แท็กloading_and_analysis
--lockfile_mode=<off, update or error>
ค่าเริ่มต้น: "ปิด"-
ระบุวิธีและจะใช้หรือไม่ใช้ไฟล์ล็อก ค่าที่ใช้ได้คือ `update` เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง, `error` เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่อัปเดต หรือ `off` เพื่อไม่ให้อ่านหรือเขียนไปยังไฟล์ล็อก
แท็กloading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
มีการสะสมการใช้งานหลายครั้ง- แทนที่โมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--registry=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้เพื่อค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับมีความสำคัญ โดยระบบจะค้นหาโมดูลในรีจิสทรีที่อยู่ก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีที่อยู่ถัดไปก็ต่อเมื่อไม่มีโมดูลในรีจิสทรีที่อยู่ก่อนหน้า
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อความละเอียด รูปแบบ หรือตำแหน่งของการบันทึก:
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น ระบบจะจำกัดจำนวนประเภทการดำเนินการไว้ที่ 20 นิโมนิกที่มีจำนวนการดำเนินการที่ดำเนินการแล้วมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับทุกคำช่วยจำ
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปในคำสั่ง Bazel ซึ่งไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้อ่านไฟล์ที่ระบุซึ่งแก้ไขแล้วแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
--experimental_downloader_config=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไฟล์เพื่อกำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สำหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ รูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้เป็น URL แทน โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณสามารถระบุคำสั่ง `rewrite` หลายรายการสำหรับ URL เดียวกันได้ และในกรณีนี้ ระบบจะแสดง URL หลายรายการ
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้:
--override_repository=<an equals-separated mapping of repository name to path>
มีการสะสมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุเริ่มต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
ตัวเลือกการติดตั้งบนอุปกรณ์เคลื่อนที่
รับตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคำสั่งและไคลเอ็นต์แยกวิเคราะห์
--distdir=<a path>
มีการสะสมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาไฟล์เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บจะลิงก์แบบฮาร์ดลิงก์ไฟล์ในกรณีที่แคชตรงกันแทนที่จะคัดลอก ซึ่งมีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL เปลี่ยนแปลงและส่งผลให้มีการดาวน์โหลดซ้ำแม้ว่าแคชจะมีรายการที่ดาวน์โหลดซึ่งมีแฮชเดียวกันก็ตาม ซึ่งใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL ไม่ได้ทำให้ที่เก็บข้อมูลเสียหายซึ่งถูกแคชซ่อนไว้
แท็ก:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ จะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็กexperimental
--experimental_repository_downloader_retries=<an integer>
ค่าเริ่มต้น: "0"-
จำนวนครั้งสูงสุดที่พยายามลองดาวน์โหลดซ้ำเมื่อเกิดข้อผิดพลาด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็กexperimental
--experimental_scale_timeouts=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับขนาดการหมดเวลาทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ ด้วยวิธีนี้ คุณจึงทำให้ที่เก็บข้อมูลภายนอกทำงานในเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็กbazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับการหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลดผ่าน http ตามปัจจัยที่ระบุ
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้มาในระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
--mode=<classic, classic_internal_test_do_not_use or skylark>
ค่าเริ่มต้น: "คลาสสิก"-
เลือกวิธีเรียกใช้การติดตั้งบนอุปกรณ์เคลื่อนที่ "classic" จะเรียกใช้การติดตั้งบนอุปกรณ์เคลื่อนที่เวอร์ชันปัจจุบัน "skylark" ใช้ Starlark เวอร์ชันใหม่ซึ่งรองรับ android_test
แท็ก:loading_and_analysis
,execution
,incompatible_change
- ตัวเลือกที่กำหนดค่าเครื่องมือที่ใช้สำหรับการดำเนินการ
--adb=<a string>
ค่าเริ่มต้น: ""-
ไบนารี adb ที่จะใช้สำหรับคำสั่ง "mobile-install" หากไม่ได้ระบุ ระบบจะใช้ SDK ใน Android ที่ระบุโดยตัวเลือกบรรทัดคำสั่ง --android_sdk (หรือ SDK เริ่มต้นหากไม่ได้ระบุ --android_sdk)
แท็ก:changes_inputs
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่งมีดังนี้
--[no]incremental
ค่าเริ่มต้น: "false"-
จะทำการติดตั้งแบบเพิ่มทีละรายการหรือไม่ หากเป็นจริง ให้พยายามหลีกเลี่ยงการทำงานเพิ่มเติมที่ไม่จำเป็นโดยอ่านสถานะของอุปกรณ์ที่จะติดตั้งโค้ด และใช้ข้อมูลดังกล่าวเพื่อหลีกเลี่ยงการทำงานที่ไม่จำเป็น หากเป็นเท็จ (ค่าเริ่มต้น) ให้ติดตั้งแบบเต็มเสมอ
แท็กloading_and_analysis
--[no]split_apks
ค่าเริ่มต้น: "false"-
จะใช้ 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
- ตัวเลือกที่มีผลต่อความเข้มงวดของ Bazel ในการบังคับใช้ข้อมูลอินพุตการบิลด์ที่ถูกต้อง (คำจำกัดความของกฎ, ชุดค่าสถานะ ฯลฯ)
--experimental_repository_hash_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรมีการยืนยันแฮชของไดเรกทอรีที่เก็บเทียบกับค่านี้
แท็ก:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
มีการสะสมการใช้งานหลายครั้ง-
หากมีรายการกฎที่เก็บที่ควรมีการยืนยันแฮชของไดเรกทอรีเอาต์พุต โดยระบุไฟล์ด้วย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้มีผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ในไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
ค่าเริ่มต้น: "จริง"-
ไม่มีการดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะได้รับอนุญาตในกราฟการอ้างอิงที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่าถูกยกเลิกในรีจิสทรีที่โมดูลมาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น เวอร์ชันที่ถูกเพิกถอนจะทำให้การแก้ไขล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันที่อนุญาตให้ยกเลิกได้ด้วยตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็กloading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ `error` เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาที่ไม่สำเร็จ, `off` เพื่อปิดใช้การตรวจสอบ หรือ `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน
แท็กloading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าการอ้างอิง `bazel_dep` โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้ว ค่าที่ใช้ได้คือ `off` เพื่อปิดใช้การตรวจสอบ, `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน หรือ `error` เพื่อส่งต่อเป็นความล้มเหลวในการแก้ไข
แท็กloading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นการขึ้นต่อกันของนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท ไม่ว่าค่าของแฟล็กนี้จะเป็นอะไรก็ตาม
แท็กloading_and_analysis
--lockfile_mode=<off, update or error>
ค่าเริ่มต้น: "ปิด"-
ระบุวิธีและจะใช้หรือไม่ใช้ไฟล์ล็อก ค่าที่ใช้ได้คือ `update` เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง, `error` เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่อัปเดต หรือ `off` เพื่อไม่ให้อ่านหรือเขียนไปยังไฟล์ล็อก
แท็กloading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
มีการสะสมการใช้งานหลายครั้ง- แทนที่โมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--registry=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้เพื่อค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับมีความสำคัญ โดยระบบจะค้นหาโมดูลในรีจิสทรีที่อยู่ก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีที่อยู่ถัดไปก็ต่อเมื่อไม่มีโมดูลในรีจิสทรีที่อยู่ก่อนหน้า
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อความละเอียด รูปแบบ หรือตำแหน่งของการบันทึก:
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น ระบบจะจำกัดจำนวนประเภทการดำเนินการไว้ที่ 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`) หรือรูปแบบ 2 รูปแบบ รูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้เป็น URL แทน โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณสามารถระบุคำสั่ง `rewrite` หลายรายการสำหรับ URL เดียวกันได้ และในกรณีนี้ ระบบจะแสดง URL หลายรายการ
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้:
--override_repository=<an equals-separated mapping of repository name to path>
มีการสะสมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุเริ่มต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
ตัวเลือกม็อด
- ตัวเลือกที่ปรากฏก่อนคำสั่งและไคลเอ็นต์แยกวิเคราะห์
--distdir=<a path>
มีการสะสมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาไฟล์เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บจะลิงก์แบบฮาร์ดลิงก์ไฟล์ในกรณีที่แคชตรงกันแทนที่จะคัดลอก ซึ่งมีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL เปลี่ยนแปลงและส่งผลให้มีการดาวน์โหลดซ้ำแม้ว่าแคชจะมีรายการที่ดาวน์โหลดซึ่งมีแฮชเดียวกันก็ตาม ซึ่งใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL ไม่ได้ทำให้ที่เก็บข้อมูลเสียหายซึ่งถูกแคชซ่อนไว้
แท็ก:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ จะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็กexperimental
--experimental_repository_downloader_retries=<an integer>
ค่าเริ่มต้น: "0"-
จำนวนครั้งสูงสุดที่พยายามลองดาวน์โหลดซ้ำเมื่อเกิดข้อผิดพลาด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็กexperimental
--experimental_scale_timeouts=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับขนาดการหมดเวลาทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ ด้วยวิธีนี้ คุณจึงทำให้ที่เก็บข้อมูลภายนอกทำงานในเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็กbazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับการหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลดผ่าน http ตามปัจจัยที่ระบุ
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้มาในระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
--[no]keep_going
[-k
] ค่าเริ่มต้น: "false"-
ดำเนินการต่อให้ได้มากที่สุดหลังจากเกิดข้อผิดพลาด แม้ว่าจะวิเคราะห์เป้าหมายที่ล้มเหลวและเป้าหมายที่ขึ้นอยู่กับเป้าหมายนั้นไม่ได้ แต่ก็วิเคราะห์ข้อกำหนดเบื้องต้นอื่นๆ ของเป้าหมายเหล่านี้ได้
แท็ก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">
ค่าเริ่มต้น: "auto"-
จำนวนเธรดแบบขนานที่จะใช้ในระยะการโหลด/วิเคราะห์ รับค่าจำนวนเต็มหรือคีย์เวิร์ด ("auto", "HOST_CPUS", "HOST_RAM") ตามด้วยการดำเนินการ ([-|*]<float>) เช่น "auto", "HOST_CPUS*.5" "auto" จะตั้งค่าเริ่มต้นที่เหมาะสมตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้ข้อมูลอินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าสถานะ ฯลฯ):
--experimental_repository_hash_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรมีการยืนยันแฮชของไดเรกทอรีที่เก็บเทียบกับค่านี้
แท็ก:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
มีการสะสมการใช้งานหลายครั้ง-
หากมีรายการกฎที่เก็บที่ควรมีการยืนยันแฮชของไดเรกทอรีเอาต์พุต โดยระบุไฟล์ด้วย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้มีผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ในไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
ค่าเริ่มต้น: "จริง"-
แท็ก No-op
:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
ค่าเริ่มต้น: "false"-
หาก incompatible_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
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ให้บังคับใช้การจำกัดระดับการแชร์ config_setting หากเป็นเท็จ ทุกการตั้งค่า config จะมองเห็นได้สำหรับทุกเป้าหมาย ดู 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
ค่าเริ่มต้น: "false"-
ระบุวงจรการอ้างอิงภายในแผนผังที่แสดง ซึ่งโดยปกติแล้วระบบจะละเว้นโดยค่าเริ่มต้น
แท็กterminal_output
--depth=<an integer>
ค่าเริ่มต้น: "-1"-
ความลึกในการแสดงผลสูงสุดของแผนผังการอ้างอิง ความลึก 1 จะแสดงการอ้างอิงโดยตรง เช่น สำหรับ tree, path และ all_paths ค่าเริ่มต้นจะเป็น Integer.MAX_VALUE ส่วนสำหรับ deps และ explain ค่าเริ่มต้นจะเป็น 1 (แสดงเฉพาะ deps โดยตรงของรูทนอกเหนือจากใบไม้เป้าหมายและระดับบนสุด)
แท็กterminal_output
--extension_filter=<a comma-separated list of <extension>s>
ค่าเริ่มต้น: ดูคำอธิบาย-
แสดงเฉพาะการใช้งานส่วนขยายโมดูลเหล่านี้และที่เก็บที่สร้างขึ้นโดยส่วนขยายดังกล่าว หากมีการตั้งค่าสถานะที่เกี่ยวข้อง หากตั้งค่าไว้ กราฟผลลัพธ์จะรวมเฉพาะเส้นทางที่มีโมดูลที่ใช้ส่วนขยายที่ระบุ รายการที่ว่างเปล่าจะปิดใช้ตัวกรอง ซึ่งเป็นการระบุส่วนขยายที่เป็นไปได้ทั้งหมด
แท็กterminal_output
--extension_info=<hidden, usages, repos or all>
ค่าเริ่มต้น: "ซ่อน"-
ระบุรายละเอียดเกี่ยวกับการใช้งานส่วนขยายที่จะรวมไว้ในผลการค้นหา "การใช้งาน" จะแสดงเฉพาะชื่อส่วนขยาย "ที่เก็บ" จะรวมที่เก็บที่นำเข้าด้วย use_repo และ "ทั้งหมด" จะแสดงที่เก็บอื่นๆ ที่สร้างโดยส่วนขยายด้วย
แท็กterminal_output
--extension_usages=<a comma-separated list of <module>s>
ค่าเริ่มต้น: ""-
ระบุโมดูลที่จะแสดงการใช้งานส่วนขยายในคำค้นหา show_extension
แท็กterminal_output
--from=<a comma-separated list of <module>s>
ค่าเริ่มต้น: "<root>"-
โมดูลที่จะเริ่มแสดงการค้นหากราฟการอ้างอิง โปรดตรวจสอบความหมายที่แน่นอนในคำอธิบายของแต่ละคําค้นหา ค่าเริ่มต้นคือ <root>
แท็ก:terminal_output
--[no]include_builtin
ค่าเริ่มต้น: "false"-
รวมโมดูลในตัวไว้ในกราฟการอ้างอิง ปิดใช้โดยค่าเริ่มต้นเนื่องจากมีเสียงดัง
แท็กterminal_output
--[no]include_unused
ค่าเริ่มต้น: "false"-
คำค้นหาจะพิจารณาและแสดงโมดูลที่ไม่ได้ใช้ซึ่งไม่ได้อยู่ในกราฟการแก้ปัญหาของโมดูลหลังจากการเลือก (เนื่องจากกฎการเลือกเวอร์ชันขั้นต่ำหรือกฎการลบล้าง) ซึ่งอาจส่งผลแตกต่างกันสำหรับคำค้นหาแต่ละประเภท เช่น การรวมเส้นทางใหม่ในคำสั่ง all_paths หรือการเพิ่มการอ้างอิงในคำสั่ง explain
แท็กterminal_output
--output=<text, json or graph>
ค่าเริ่มต้น: "ข้อความ"-
รูปแบบที่ควรพิมพ์ผลการค้นหา ค่าที่อนุญาตสำหรับคำค้นหาคือ text, json, graph
แท็ก:terminal_output
--[no]verbose
ค่าเริ่มต้น: "false"-
นอกจากนี้ คำค้นหายังแสดงเหตุผลที่โมดูลได้รับการแก้ไขเป็นเวอร์ชันปัจจุบัน (หากมีการเปลี่ยนแปลง) ค่าเริ่มต้นเป็นจริงเฉพาะสําหรับคําค้นหา Explain
แท็ก:terminal_output
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะได้รับอนุญาตในกราฟการอ้างอิงที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่าถูกยกเลิกในรีจิสทรีที่โมดูลมาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น เวอร์ชันที่ถูกเพิกถอนจะทำให้การแก้ไขล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันที่อนุญาตให้ยกเลิกได้ด้วยตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็กloading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ `error` เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาที่ไม่สำเร็จ, `off` เพื่อปิดใช้การตรวจสอบ หรือ `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน
แท็กloading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าการอ้างอิง `bazel_dep` โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้ว ค่าที่ใช้ได้คือ `off` เพื่อปิดใช้การตรวจสอบ, `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน หรือ `error` เพื่อส่งต่อเป็นความล้มเหลวในการแก้ไข
แท็กloading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นการขึ้นต่อกันของนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท ไม่ว่าค่าของแฟล็กนี้จะเป็นอะไรก็ตาม
แท็กloading_and_analysis
--lockfile_mode=<off, update or error>
ค่าเริ่มต้น: "ปิด"-
ระบุวิธีและจะใช้หรือไม่ใช้ไฟล์ล็อก ค่าที่ใช้ได้คือ `update` เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง, `error` เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่อัปเดต หรือ `off` เพื่อไม่ให้อ่านหรือเขียนไปยังไฟล์ล็อก
แท็กloading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
มีการสะสมการใช้งานหลายครั้ง- แทนที่โมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--registry=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้เพื่อค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับมีความสำคัญ โดยระบบจะค้นหาโมดูลในรีจิสทรีที่อยู่ก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีที่อยู่ถัดไปก็ต่อเมื่อไม่มีโมดูลในรีจิสทรีที่อยู่ก่อนหน้า
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อความละเอียด รูปแบบ หรือตำแหน่งของการบันทึก:
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น ระบบจะจำกัดจำนวนประเภทการดำเนินการไว้ที่ 20 นิโมนิกที่มีจำนวนการดำเนินการที่ดำเนินการแล้วมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับทุกคำช่วยจำ
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปในคำสั่ง Bazel ซึ่งไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้อ่านไฟล์ที่ระบุซึ่งแก้ไขแล้วแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
--experimental_downloader_config=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไฟล์เพื่อกำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สำหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ รูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้เป็น URL แทน โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณสามารถระบุคำสั่ง `rewrite` หลายรายการสำหรับ URL เดียวกันได้ และในกรณีนี้ ระบบจะแสดง URL หลายรายการ
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้:
--deleted_packages=<comma-separated list of package names>
ค่าเริ่มต้น: ""- รายการชื่อแพ็กเกจที่คั่นด้วยคอมมา ซึ่งระบบบิลด์จะถือว่าไม่มีอยู่ แม้ว่าจะมองเห็นได้ที่ใดที่หนึ่งในเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ เช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์แล้ว ระบบบิลด์อาจแจ้งข้อผิดพลาดหากพบป้ายกำกับ "//x:y/z" หากรายการ package_path อื่นยังคงระบุป้ายกำกับนั้น การระบุ --deleted_packages x/y จะช่วยหลีกเลี่ยงปัญหานี้ได้
--override_repository=<an equals-separated mapping of repository name to path>
มีการสะสมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--package_path=<colon-separated list of options>
ค่าเริ่มต้น: "%workspace%"- รายการที่คั่นด้วยโคลอนของตำแหน่งที่จะค้นหาแพ็กเกจ องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับเวิร์กสเปซที่ครอบคลุม หากละไว้หรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
--[no]show_loading_progress
ค่าเริ่มต้น: "จริง"- หากเปิดใช้ จะทำให้ Bazel พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ"
ตัวเลือก Print_action
รับตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคำสั่งและไคลเอ็นต์แยกวิเคราะห์
--distdir=<a path>
มีการสะสมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาไฟล์เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บจะลิงก์แบบฮาร์ดลิงก์ไฟล์ในกรณีที่แคชตรงกันแทนที่จะคัดลอก ซึ่งมีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL เปลี่ยนแปลงและส่งผลให้มีการดาวน์โหลดซ้ำแม้ว่าแคชจะมีรายการที่ดาวน์โหลดซึ่งมีแฮชเดียวกันก็ตาม ซึ่งใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL ไม่ได้ทำให้ที่เก็บข้อมูลเสียหายซึ่งถูกแคชซ่อนไว้
แท็ก:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ จะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็กexperimental
--experimental_repository_downloader_retries=<an integer>
ค่าเริ่มต้น: "0"-
จำนวนครั้งสูงสุดที่พยายามลองดาวน์โหลดซ้ำเมื่อเกิดข้อผิดพลาด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็กexperimental
--experimental_scale_timeouts=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับขนาดการหมดเวลาทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ ด้วยวิธีนี้ คุณจึงทำให้ที่เก็บข้อมูลภายนอกทำงานในเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็กbazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับการหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลดผ่าน http ตามปัจจัยที่ระบุ
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้มาในระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้ข้อมูลอินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าสถานะ ฯลฯ):
--experimental_repository_hash_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรมีการยืนยันแฮชของไดเรกทอรีที่เก็บเทียบกับค่านี้
แท็ก:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
มีการสะสมการใช้งานหลายครั้ง-
หากมีรายการกฎที่เก็บที่ควรมีการยืนยันแฮชของไดเรกทอรีเอาต์พุต โดยระบุไฟล์ด้วย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้มีผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ในไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
ค่าเริ่มต้น: "จริง"-
ไม่มีการดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะได้รับอนุญาตในกราฟการอ้างอิงที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่าถูกยกเลิกในรีจิสทรีที่โมดูลมาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น เวอร์ชันที่ถูกเพิกถอนจะทำให้การแก้ไขล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันที่อนุญาตให้ยกเลิกได้ด้วยตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็กloading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ `error` เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาที่ไม่สำเร็จ, `off` เพื่อปิดใช้การตรวจสอบ หรือ `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน
แท็กloading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าการอ้างอิง `bazel_dep` โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้ว ค่าที่ใช้ได้คือ `off` เพื่อปิดใช้การตรวจสอบ, `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน หรือ `error` เพื่อส่งต่อเป็นความล้มเหลวในการแก้ไข
แท็กloading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นการขึ้นต่อกันของนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท ไม่ว่าค่าของแฟล็กนี้จะเป็นอะไรก็ตาม
แท็กloading_and_analysis
--lockfile_mode=<off, update or error>
ค่าเริ่มต้น: "ปิด"-
ระบุวิธีและจะใช้หรือไม่ใช้ไฟล์ล็อก ค่าที่ใช้ได้คือ `update` เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง, `error` เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่อัปเดต หรือ `off` เพื่อไม่ให้อ่านหรือเขียนไปยังไฟล์ล็อก
แท็กloading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
มีการสะสมการใช้งานหลายครั้ง- แทนที่โมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--registry=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้เพื่อค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับมีความสำคัญ โดยระบบจะค้นหาโมดูลในรีจิสทรีที่อยู่ก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีที่อยู่ถัดไปก็ต่อเมื่อไม่มีโมดูลในรีจิสทรีที่อยู่ก่อนหน้า
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อความละเอียด รูปแบบ หรือตำแหน่งของการบันทึก:
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น ระบบจะจำกัดจำนวนประเภทการดำเนินการไว้ที่ 20 นิโมนิกที่มีจำนวนการดำเนินการที่ดำเนินการแล้วมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับทุกคำช่วยจำ
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปในคำสั่ง Bazel ซึ่งไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้อ่านไฟล์ที่ระบุซึ่งแก้ไขแล้วแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
--experimental_downloader_config=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไฟล์เพื่อกำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สำหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ รูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้เป็น URL แทน โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณสามารถระบุคำสั่ง `rewrite` หลายรายการสำหรับ URL เดียวกันได้ และในกรณีนี้ ระบบจะแสดง URL หลายรายการ
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้:
--override_repository=<an equals-separated mapping of repository name to path>
มีการสะสมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--print_action_mnemonics=<a string>
มีการสะสมการใช้งานหลายครั้ง- แสดงรายการนิโมนิกที่จะใช้กรองข้อมูล print_action โดยจะไม่มีการกรองหากปล่อยว่างไว้
ตัวเลือกการค้นหา
- ตัวเลือกที่ปรากฏก่อนคำสั่งและไคลเอ็นต์แยกวิเคราะห์
--distdir=<a path>
มีการสะสมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาไฟล์เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บจะลิงก์แบบฮาร์ดลิงก์ไฟล์ในกรณีที่แคชตรงกันแทนที่จะคัดลอก ซึ่งมีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL เปลี่ยนแปลงและส่งผลให้มีการดาวน์โหลดซ้ำแม้ว่าแคชจะมีรายการที่ดาวน์โหลดซึ่งมีแฮชเดียวกันก็ตาม ซึ่งใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL ไม่ได้ทำให้ที่เก็บข้อมูลเสียหายซึ่งถูกแคชซ่อนไว้
แท็ก:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ จะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็กexperimental
--experimental_repository_downloader_retries=<an integer>
ค่าเริ่มต้น: "0"-
จำนวนครั้งสูงสุดที่พยายามลองดาวน์โหลดซ้ำเมื่อเกิดข้อผิดพลาด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็กexperimental
--experimental_scale_timeouts=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับขนาดการหมดเวลาทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ ด้วยวิธีนี้ คุณจึงทำให้ที่เก็บข้อมูลภายนอกทำงานในเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็กbazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับการหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลดผ่าน http ตามปัจจัยที่ระบุ
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้มาในระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
--[no]incompatible_remote_dangling_symlinks
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็นจริงและ --incompatible_remote_symlinks เป็นจริงด้วย ระบบจะอนุญาตให้ซิมลิงก์ในเอาต์พุตของการดำเนินการค้างอยู่
แท็ก:execution
,incompatible_change
--[no]incompatible_remote_symlinks
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็น "จริง" Bazel จะแสดงลิงก์สัญลักษณ์ในเอาต์พุตการดำเนินการในโปรโตคอลการแคช/การดำเนินการระยะไกลตามนั้น ไม่เช่นนั้น ระบบจะติดตามลิงก์สัญลักษณ์และแสดงเป็นไฟล์หรือไดเรกทอรี ดูรายละเอียดได้ที่ #6631
แท็ก:execution
,incompatible_change
--[no]keep_going
[-k
] ค่าเริ่มต้น: "false"-
ดำเนินการต่อให้ได้มากที่สุดหลังจากเกิดข้อผิดพลาด แม้ว่าจะวิเคราะห์เป้าหมายที่ล้มเหลวและเป้าหมายที่ขึ้นอยู่กับเป้าหมายนั้นไม่ได้ แต่ก็วิเคราะห์ข้อกำหนดเบื้องต้นอื่นๆ ของเป้าหมายเหล่านี้ได้
แท็ก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">
ค่าเริ่มต้น: "auto"-
จำนวนเธรดแบบขนานที่จะใช้ในระยะการโหลด/วิเคราะห์ รับค่าจำนวนเต็มหรือคีย์เวิร์ด ("auto", "HOST_CPUS", "HOST_RAM") ตามด้วยการดำเนินการ ([-|*]<float>) เช่น "auto", "HOST_CPUS*.5" "auto" จะตั้งค่าเริ่มต้นที่เหมาะสมตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ช่วยให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการ ซึ่งจะส่งผลต่อค่าของเอาต์พุตนั้น ไม่ใช่การมีอยู่ของเอาต์พุต
--bep_maximum_open_remote_upload_files=<an integer>
ค่าเริ่มต้น: "-1"-
จำนวนไฟล์ที่เปิดสูงสุดที่อนุญาตในระหว่างการอัปโหลดอาร์ติแฟกต์ BEP
แท็กaffects_outputs
--remote_download_minimal
-
ไม่ดาวน์โหลดเอาต์พุตการสร้างระยะไกลไปยังเครื่องในระบบ Flag นี้เป็นทางลัดสำหรับ Flag: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata และ --remote_download_outputs=minimal
ขยายเป็น
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
แท็กaffects_outputs
--remote_download_outputs=<all, minimal or toplevel>
ค่าเริ่มต้น: "all"-
หากตั้งค่าเป็น "น้อยที่สุด" จะไม่ดาวน์โหลดเอาต์พุตการสร้างจากระยะไกลไปยังเครื่องในพื้นที่ ยกเว้นเอาต์พุตที่การกระทำในพื้นที่กำหนด หากตั้งค่าเป็น "toplevel" จะทํางานเหมือน "minimal" ยกเว้นว่าจะดาวน์โหลดเอาต์พุตของเป้าหมายระดับบนสุดไปยังเครื่องในเครื่องด้วย ทั้ง 2 ตัวเลือกช่วยลดเวลาในการสร้างได้อย่างมากหากแบนด์วิดท์เครือข่ายเป็นคอขวด
แท็กaffects_outputs
--remote_download_symlink_template=<a string>
ค่าเริ่มต้น: ""-
สร้างลิงก์สัญลักษณ์แทนการดาวน์โหลดเอาต์พุตบิลด์ระยะไกลไปยังเครื่องภายใน คุณระบุเป้าหมายของลิงก์สัญลักษณ์ได้ในรูปแบบของสตริงเทมเพลต สตริงเทมเพลตนี้อาจมี {hash} และ {size_bytes} ซึ่งจะขยายเป็นแฮชของออบเจ็กต์และขนาดในหน่วยไบต์ตามลำดับ ตัวอย่างเช่น ลิงก์สัญลักษณ์เหล่านี้อาจชี้ไปยังระบบไฟล์ FUSE ที่โหลดออบเจ็กต์จาก CAS ตามต้องการ
แท็กaffects_outputs
--remote_download_toplevel
-
ดาวน์โหลดเฉพาะเอาต์พุตระยะไกลของเป้าหมายระดับบนสุดไปยังเครื่องในเครื่อง Flag นี้เป็นทางลัดสำหรับ Flag: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata และ --remote_download_outputs=toplevel
ขยายเป็น
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
แท็กaffects_outputs
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้ข้อมูลอินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าสถานะ ฯลฯ)
--experimental_repository_hash_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรมีการยืนยันแฮชของไดเรกทอรีที่เก็บเทียบกับค่านี้
แท็ก:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
มีการสะสมการใช้งานหลายครั้ง-
หากมีรายการกฎที่เก็บที่ควรมีการยืนยันแฮชของไดเรกทอรีเอาต์พุต โดยระบุไฟล์ด้วย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้มีผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ในไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
ค่าเริ่มต้น: "จริง"-
แท็ก No-op
:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
ค่าเริ่มต้น: "false"-
หาก incompatible_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
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ให้บังคับใช้การจำกัดระดับการแชร์ config_setting หากเป็นเท็จ ทุกการตั้งค่า config จะมองเห็นได้สำหรับทุกเป้าหมาย ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและการตีความหมายของคำค้นหา
--aspect_deps=<off, conservative or precise>
ค่าเริ่มต้น: "ระมัดระวัง"-
วิธีแก้ไขการขึ้นต่อกันของแง่มุมเมื่อรูปแบบเอาต์พุตเป็นหนึ่งใน {xml,proto,record} "off" หมายความว่าจะไม่มีการแก้ไขการขึ้นต่อกันของแง่มุม "conservative" (ค่าเริ่มต้น) หมายความว่าจะมีการเพิ่มการขึ้นต่อกันของแง่มุมที่ประกาศทั้งหมดไม่ว่าจะมีคลาสกฎของการขึ้นต่อกันโดยตรงหรือไม่ก็ตาม "precise" หมายความว่าจะมีการเพิ่มเฉพาะแง่มุมที่อาจใช้งานได้เมื่อพิจารณาจากคลาสกฎของการขึ้นต่อกันโดยตรง โปรดทราบว่าโหมดที่แม่นยำต้องโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียว จึงทำให้ช้ากว่าโหมดอื่นๆ โปรดทราบว่าแม้ในโหมดที่แม่นยำก็ยังไม่แม่นยำโดยสมบูรณ์ เนื่องจากระบบจะตัดสินใจว่าจะคำนวณแง่มุมใดในระยะการวิเคราะห์ ซึ่งไม่ได้ทำงานระหว่าง "bazel query"
แท็กbuild_file_semantics
--[no]consistent_labels
ค่าเริ่มต้น: "false"-
หากเปิดใช้ คำสั่งการค้นหาทุกคำสั่งจะปล่อยป้ายกำกับออกมาเหมือนกับฟังก์ชัน <code>str</code> ของ Starlark ที่ใช้กับอินสแตนซ์ <code>Label</code> ซึ่งจะเป็นประโยชน์สำหรับเครื่องมือที่ต้องจับคู่เอาต์พุตของคำสั่งการค้นหาและ/หรือป้ายกำกับต่างๆ ที่กฎปล่อยออกมา หากไม่ได้เปิดใช้ ตัวจัดรูปแบบเอาต์พุตจะสามารถปล่อยชื่อที่เก็บที่ชัดเจน (เทียบกับที่เก็บหลัก) แทนเพื่อให้เอาต์พุตอ่านง่ายขึ้น
แท็กterminal_output
--[no]experimental_graphless_query
ค่าเริ่มต้น: "auto"-
หากเป็นจริง จะใช้การติดตั้งใช้งานการค้นหาที่ไม่ทำสำเนากราฟ การติดตั้งใช้งานใหม่รองรับเฉพาะ --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
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ระบบจะส่งกราฟที่ "แยกตัวประกอบ" กล่าวคือ ระบบจะผสานโหนดที่เทียบเท่ากันในเชิงโทโพโลยีเข้าด้วยกันและต่อป้ายกำกับของโหนดเหล่านั้น ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็กterminal_output
--graph:node_limit=<an integer>
ค่าเริ่มต้น: "512"-
ความยาวสูงสุดของสตริงป้ายกำกับสำหรับโหนดกราฟในเอาต์พุต ระบบจะตัดป้ายกำกับที่ยาวเกินไป โดย -1 หมายถึงไม่มีการตัด ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็กterminal_output
--[no]implicit_deps
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ระบบจะรวมทรัพยากร Dependency โดยนัยไว้ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน การขึ้นต่อกันโดยนัยคือการขึ้นต่อกันที่ไม่ได้ระบุอย่างชัดเจนในไฟล์ BUILD แต่ Bazel เพิ่มให้ สำหรับ cquery ตัวเลือกนี้จะควบคุมการกรอง Toolchain ที่แก้ไขแล้ว
แท็กbuild_file_semantics
--[no]include_aspects
ค่าเริ่มต้น: "จริง"-
aquery, cquery: whether to include aspect-generated actions in the output. query: no-op (aspects are always followed).
แท็กterminal_output
--[no]incompatible_display_source_file_location
ค่าเริ่มต้น: "จริง"-
ค่าเริ่มต้นเป็น "จริง" ซึ่งจะแสดงเป้าหมายของไฟล์ต้นฉบับ หากจริง จะแสดงตำแหน่งของบรรทัดที่ 1 ของไฟล์แหล่งที่มาในเอาต์พุตตำแหน่ง โดยแฟล็กนี้มีไว้เพื่อวัตถุประสงค์ในการย้ายข้อมูลเท่านั้น
แท็ก:terminal_output
,incompatible_change
--[no]incompatible_lexicographical_output
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าตัวเลือกนี้ ฟังก์ชันการจัดเรียง --order_output=auto จะแสดงผลตามลำดับพจนานุกรม
แท็ก:terminal_output
,incompatible_change
--[no]incompatible_package_group_includes_double_slash
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ เมื่อส่งออกแอตทริบิวต์ `packages` ของ package_group ระบบจะไม่ละเว้น `//` ที่นำหน้า
แท็ก:terminal_output
,incompatible_change
--[no]infer_universe_scope
ค่าเริ่มต้น: "false"-
หากตั้งค่าและไม่ได้ตั้งค่า --universe_scope ระบบจะอนุมานค่าของ --universe_scope เป็นรายการรูปแบบเป้าหมายที่ไม่ซ้ำกันในนิพจน์การค้นหา โปรดทราบว่าค่า --universe_scope ที่อนุมานสำหรับนิพจน์การค้นหาที่ใช้ฟังก์ชันระดับจักรวาล (เช่น `allrdeps`) อาจไม่ใช่สิ่งที่คุณต้องการ ดังนั้นคุณควรใช้ตัวเลือกนี้เฉพาะในกรณีที่คุณทราบว่ากำลังทำอะไรอยู่ ดูรายละเอียดและตัวอย่างได้ที่ https://bazel.build/reference/query#sky-query หากตั้งค่า --universe_scope ระบบจะไม่สนใจค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้ใช้ได้กับ `query` เท่านั้น (ไม่ใช่ `cquery`)
แท็ก:loading_and_analysis
--[no]line_terminator_null
ค่าเริ่มต้น: "false"-
ไม่ว่าจะสิ้นสุดแต่ละรูปแบบด้วย \0 แทนการขึ้นบรรทัดใหม่
แท็กterminal_output
--[no]nodep_deps
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ระบบจะรวมการอ้างอิงจากแอตทริบิวต์ "nodep" ไว้ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ตัวอย่างทั่วไปของแอตทริบิวต์ "nodep" คือ "visibility" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ `info build-language` เพื่อดูข้อมูลเกี่ยวกับแอตทริบิวต์ "nodep" ทั้งหมดในภาษาบิลด์
แท็กbuild_file_semantics
--noorder_results
-
แสดงผลลัพธ์ตามลำดับการขึ้นต่อกัน (ค่าเริ่มต้น) หรือแบบไม่เรียงลำดับ เอาต์พุตที่ไม่มีการจัดเรียงจะเร็วกว่า แต่จะรองรับเฉพาะเมื่อ --output ไม่ใช่ minrank, maxrank หรือ graph
ขยายเป็น
--order_output=no
แท็กterminal_output
--null
-
ไม่ว่าจะสิ้นสุดแต่ละรูปแบบด้วย \0 แทนการขึ้นบรรทัดใหม่
ขยายเป็น
--line_terminator_null=true
แท็กterminal_output
--order_output=<no, deps, auto or full>
ค่าเริ่มต้น: "auto"-
แสดงผลลัพธ์โดยไม่มีการจัดเรียง (no) จัดเรียงตามการขึ้นต่อกัน (deps) หรือจัดเรียงอย่างสมบูรณ์ (full) ค่าเริ่มต้นคือ "auto" ซึ่งหมายความว่าผลลัพธ์จะแสดงตามลำดับการอ้างอิงหรือตามลำดับทั้งหมด ขึ้นอยู่กับตัวจัดรูปแบบเอาต์พุต (ตามลำดับการอ้างอิงสำหรับ proto, minrank, maxrank และ graph ส่วนตามลำดับทั้งหมดสำหรับตัวจัดรูปแบบอื่นๆ) เมื่อเอาต์พุตได้รับการจัดเรียงอย่างสมบูรณ์ ระบบจะพิมพ์โหนดตามลำดับที่กำหนดได้อย่างสมบูรณ์ (ทั้งหมด) ก่อนอื่น ระบบจะจัดเรียงโหนดทั้งหมดตามลำดับตัวอักษร จากนั้นจะใช้แต่ละโหนดในรายการเป็นจุดเริ่มต้นของการค้นหาแบบเจาะลึกหลังการเรียงลำดับ ซึ่งจะมีการข้ามขอบขาออกไปยังโหนดที่ยังไม่ได้เข้าชมตามลำดับตัวอักษรของโหนดสืบทอด สุดท้าย ระบบจะพิมพ์โหนดในลำดับย้อนกลับของลำดับที่เข้าชม
แท็กterminal_output
--order_results
-
แสดงผลลัพธ์ตามลำดับการขึ้นต่อกัน (ค่าเริ่มต้น) หรือแบบไม่เรียงลำดับ เอาต์พุตที่ไม่มีการจัดเรียงจะเร็วกว่า แต่จะรองรับเฉพาะเมื่อ --output ไม่ใช่ minrank, maxrank หรือ graph
ขยายเป็น
--order_output=auto
แท็กterminal_output
--output=<a string>
ค่าเริ่มต้น: "label"-
รูปแบบที่ควรพิมพ์ผลการค้นหา ค่าที่อนุญาตสำหรับคำค้นหา ได้แก่ build, graph, streamed_jsonproto, label, label_kind, location, maxrank, minrank, package, proto, xml
แท็กterminal_output
--[no]proto:default_values
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ระบบจะรวมแอตทริบิวต์ที่ไม่ได้ระบุค่าอย่างชัดเจนในไฟล์ BUILD ไว้ด้วย มิฉะนั้นจะละเว้น ตัวเลือกนี้ใช้ได้กับ --output=proto
แท็ก:terminal_output
--[no]proto:definition_stack
ค่าเริ่มต้น: "false"-
ป้อนข้อมูลฟิลด์ Proto ของ definition_stack ซึ่งจะบันทึกสแต็กการเรียก Starlark สำหรับอินสแตนซ์ของกฎแต่ละรายการ ณ เวลาที่กำหนดคลาสของกฎ
แท็กterminal_output
--[no]proto:flatten_selects
ค่าเริ่มต้น: "จริง"-
หากเปิดใช้ ระบบจะทำให้แอตทริบิวต์ที่กำหนดค่าได้ซึ่งสร้างโดย select() แบนราบ สำหรับประเภทรายการ การแสดงแบบ Flatten คือรายการที่มีค่าของแผนที่ที่เลือกแต่ละค่าเพียงครั้งเดียว ระบบจะทำให้ประเภทสเกลาร์แบนเป็นค่าว่าง
แท็กbuild_file_semantics
--[no]proto:include_synthetic_attribute_hash
ค่าเริ่มต้น: "false"-
จะคำนวณและสร้างแอตทริบิวต์ $internal_attr_hash หรือไม่
แท็กterminal_output
--[no]proto:instantiation_stack
ค่าเริ่มต้น: "false"-
สร้างสแต็กการเรียกอินสแตนซ์ของแต่ละกฎ โปรดทราบว่าต้องมีสแต็กจึงจะดำเนินการนี้ได้
แท็กterminal_output
--[no]proto:locations
ค่าเริ่มต้น: "จริง"-
จะแสดงข้อมูลตำแหน่งในเอาต์พุต Proto หรือไม่
แท็กterminal_output
--proto:output_rule_attrs=<comma-separated list of options>
ค่าเริ่มต้น: "all"-
รายการแอตทริบิวต์ที่คั่นด้วยคอมมาที่จะรวมไว้ในเอาต์พุต ค่าเริ่มต้นคือแอตทริบิวต์ทั้งหมด ตั้งค่าเป็นสตริงว่างเปล่าเพื่อไม่ให้แสดงแอตทริบิวต์ใดๆ ตัวเลือกนี้ใช้ได้กับ --output=proto
แท็กterminal_output
--[no]proto:rule_inputs_and_outputs
ค่าเริ่มต้น: "จริง"-
จะป้อนข้อมูลในช่อง rule_input และ rule_output หรือไม่
แท็กterminal_output
--query_file=<a string>
ค่าเริ่มต้น: ""-
หากตั้งค่าไว้ การค้นหาจะอ่านการค้นหาจากไฟล์ที่ตั้งชื่อไว้ที่นี่ แทนที่จะอ่านจากบรรทัดคำสั่ง การระบุไฟล์ที่นี่รวมถึงการค้นหาในบรรทัดคำสั่งถือเป็นข้อผิดพลาด
แท็กchanges_inputs
--[no]relative_locations
ค่าเริ่มต้น: "false"-
หากเป็นจริง ตำแหน่งของไฟล์ BUILD ในเอาต์พุต XML และ Proto จะเป็นแบบสัมพัทธ์ โดยค่าเริ่มต้น เอาต์พุตตำแหน่งจะเป็นเส้นทางที่สมบูรณ์และจะไม่สอดคล้องกันในเครื่องต่างๆ คุณสามารถตั้งค่าตัวเลือกนี้เป็น "จริง" เพื่อให้ได้ผลลัพธ์ที่สอดคล้องกันในเครื่องต่างๆ
แท็กterminal_output
--[no]strict_test_suite
ค่าเริ่มต้น: "false"-
หากเป็นจริง นิพจน์ tests() จะแสดงข้อผิดพลาดหากพบ test_suite ที่มีเป้าหมายที่ไม่ใช่การทดสอบ
แท็ก:build_file_semantics
,eagerness_to_exit
--[no]tool_deps
ค่าเริ่มต้น: "จริง"-
คำค้นหา: หากปิดใช้ ระบบจะไม่รวมการอ้างอิงเป้าหมาย "การกำหนดค่าโฮสต์" หรือ "การดำเนินการ" ไว้ในกราฟการอ้างอิงที่คำค้นหาดำเนินการ ขอบเขตการพึ่งพา "การกำหนดค่าโฮสต์" เช่น ขอบเขตจากกฎ "proto_library" ไปยังคอมไพเลอร์โปรโตคอล มักจะชี้ไปยังเครื่องมือที่ดำเนินการในระหว่างการบิลด์แทนที่จะเป็นส่วนหนึ่งของโปรแกรม "เป้าหมาย" เดียวกัน
Cquery: หากปิดใช้ ระบบจะกรองเป้าหมายที่กำหนดค่าทั้งหมดซึ่งข้ามโฮสต์หรือการเปลี่ยนการดำเนินการจากเป้าหมายระดับบนสุดที่ค้นพบเป้าหมายที่กำหนดค่านี้ ซึ่งหมายความว่าหากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าเป้าหมาย ระบบจะแสดงเฉพาะเป้าหมายที่กำหนดค่าซึ่งอยู่ในกำหนดค่าเป้าหมายด้วย หากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าโฮสต์ ระบบจะแสดงเฉพาะเป้าหมายที่กำหนดค่าโฮสต์ ตัวเลือกนี้จะไม่ยกเว้น Toolchain ที่แก้ไขแล้ว
แท็กbuild_file_semantics
--universe_scope=<comma-separated list of options>
ค่าเริ่มต้น: ""-
ชุดรูปแบบเป้าหมายที่คั่นด้วยคอมมา (การบวกและการลบ) ระบบอาจดำเนินการค้นหาในจักรวาลที่กำหนดโดยการปิดทรานซิทีฟของเป้าหมายที่ระบุ ตัวเลือกนี้ใช้สำหรับคำสั่งการค้นหาและ cquery
สำหรับ cquery อินพุตของตัวเลือกนี้คือเป้าหมายที่สร้างคำตอบทั้งหมดภายใต้ตัวเลือกนี้ ดังนั้นตัวเลือกนี้อาจส่งผลต่อการกำหนดค่าและการเปลี่ยน หากไม่ได้ระบุตัวเลือกนี้ ระบบจะถือว่าเป้าหมายระดับบนสุดคือเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหา หมายเหตุ: สำหรับ cquery การไม่ระบุตัวเลือกนี้อาจทำให้บิลด์หยุดทำงานหากเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหาไม่สามารถสร้างได้ด้วยตัวเลือกในระดับบนสุด
แท็กloading_and_analysis
--[no]xml:default_values
ค่าเริ่มต้น: "false"-
หากเป็นจริง ระบบจะพิมพ์แอตทริบิวต์ของกฎที่ไม่ได้ระบุค่าอย่างชัดเจนในไฟล์ BUILD มิฉะนั้นจะละเว้น
แท็กterminal_output
--[no]xml:line_numbers
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง เอาต์พุต XML จะมีหมายเลขบรรทัด การปิดใช้ตัวเลือกนี้อาจช่วยให้อ่าน Diff ได้ง่ายขึ้น ตัวเลือกนี้ใช้ได้กับ --output=xml เท่านั้น
แท็ก:terminal_output
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะได้รับอนุญาตในกราฟการอ้างอิงที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่าถูกยกเลิกในรีจิสทรีที่โมดูลมาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น เวอร์ชันที่ถูกเพิกถอนจะทำให้การแก้ไขล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันที่อนุญาตให้ยกเลิกได้ด้วยตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็กloading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ `error` เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาที่ไม่สำเร็จ, `off` เพื่อปิดใช้การตรวจสอบ หรือ `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน
แท็กloading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าการอ้างอิง `bazel_dep` โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้ว ค่าที่ใช้ได้คือ `off` เพื่อปิดใช้การตรวจสอบ, `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน หรือ `error` เพื่อส่งต่อเป็นความล้มเหลวในการแก้ไข
แท็กloading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นการขึ้นต่อกันของนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท ไม่ว่าค่าของแฟล็กนี้จะเป็นอะไรก็ตาม
แท็กloading_and_analysis
--lockfile_mode=<off, update or error>
ค่าเริ่มต้น: "ปิด"-
ระบุวิธีและจะใช้หรือไม่ใช้ไฟล์ล็อก ค่าที่ใช้ได้คือ `update` เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง, `error` เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่อัปเดต หรือ `off` เพื่อไม่ให้อ่านหรือเขียนไปยังไฟล์ล็อก
แท็กloading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
มีการสะสมการใช้งานหลายครั้ง- แทนที่โมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--registry=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้เพื่อค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับมีความสำคัญ โดยระบบจะค้นหาโมดูลในรีจิสทรีที่อยู่ก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีที่อยู่ถัดไปก็ต่อเมื่อไม่มีโมดูลในรีจิสทรีที่อยู่ก่อนหน้า
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อความละเอียด รูปแบบ หรือตำแหน่งของการบันทึก:
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น ระบบจะจำกัดจำนวนประเภทการดำเนินการไว้ที่ 20 นิโมนิกที่มีจำนวนการดำเนินการที่ดำเนินการแล้วมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับทุกคำช่วยจำ
--experimental_repository_resolved_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้เขียนค่า Starlark พร้อมข้อมูลที่แก้ไขแล้วของกฎที่เก็บ Starlark ทั้งหมดที่ดำเนินการ
แท็กaffects_outputs
--remote_print_execution_messages=<failure, success or all>
ค่าเริ่มต้น: "failure"-
เลือกเวลาที่จะพิมพ์ข้อความการดำเนินการจากระยะไกล ค่าที่ใช้ได้คือ `failure` เพื่อพิมพ์เฉพาะเมื่อเกิดข้อผิดพลาด `success` เพื่อพิมพ์เฉพาะเมื่อสำเร็จ และ `all` เพื่อพิมพ์เสมอ
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้อ่านไฟล์ที่ระบุซึ่งแก้ไขแล้วแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
--experimental_circuit_breaker_strategy=<failure>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุกลยุทธ์สำหรับเบรกเกอร์ที่จะใช้ กลยุทธ์ที่ใช้ได้คือ "failure" หากค่าของตัวเลือกไม่ถูกต้อง ลักษณะการทำงานจะเหมือนกับไม่ได้ตั้งค่าตัวเลือก
แท็กexecution
--experimental_downloader_config=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไฟล์เพื่อกำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สำหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ รูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้เป็น URL แทน โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณสามารถระบุคำสั่ง `rewrite` หลายรายการสำหรับ URL เดียวกันได้ และในกรณีนี้ ระบบจะแสดง URL หลายรายการ
--[no]experimental_guard_against_concurrent_changes
ค่าเริ่มต้น: "false"- ปิดตัวเลือกนี้เพื่อปิดใช้การตรวจสอบ ctime ของไฟล์อินพุตของการดำเนินการก่อนอัปโหลดไปยังแคชระยะไกล อาจมีกรณีที่เคอร์เนล Linux หน่วงเวลาการเขียนไฟล์ ซึ่งอาจทำให้เกิดผลบวกเท็จ
--experimental_remote_build_event_upload=<all or minimal>
ค่าเริ่มต้น: "all"- หากตั้งค่าเป็น "all" ระบบจะอัปโหลดเอาต์พุตในพื้นที่ทั้งหมดที่ BEP อ้างอิงไปยังแคชระยะไกล หากตั้งค่าเป็น "น้อยที่สุด" ระบบจะไม่ส่งเอาต์พุตในเครื่องที่ BEP อ้างอิงไปยังแคชระยะไกล ยกเว้นไฟล์ที่มีความสำคัญต่อผู้ใช้ BEP (เช่น บันทึกการทดสอบและโปรไฟล์เวลา) ระบบจะใช้รูปแบบ bytestream:// สำหรับ URI ของไฟล์เสมอแม้ว่าจะไม่มีไฟล์ในแคชระยะไกลก็ตาม ค่าเริ่มต้นคือ "ทั้งหมด"
--[no]experimental_remote_cache_async
ค่าเริ่มต้น: "false"- หากเป็นจริง I/O ของแคชระยะไกลจะเกิดขึ้นในเบื้องหลังแทนที่จะเป็นส่วนหนึ่งของการเกิด
--[no]experimental_remote_cache_compression
ค่าเริ่มต้น: "false"- หากเปิดใช้ ให้บีบอัด/คลายการบีบอัด Blob ของแคชด้วย zstd
--experimental_remote_capture_corrupted_outputs=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย- เส้นทางไปยังไดเรกทอรีที่จะบันทึกเอาต์พุตที่เสียหาย
--[no]experimental_remote_discard_merkle_trees
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น true ให้ทิ้งสำเนาในหน่วยความจำของต้นไม้ Merkle ของรูทอินพุตและการแมปอินพุตที่เชื่อมโยงระหว่างการเรียก GetActionResult() และ Execute() ซึ่งจะช่วยลดการใช้หน่วยความจำได้อย่างมาก แต่ต้องให้ Bazel คำนวณใหม่เมื่อแคชระยะไกลไม่พบและมีการลองใหม่
--experimental_remote_downloader=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- URI ของปลายทาง Remote Asset API ที่จะใช้เป็นพร็อกซีการดาวน์โหลดจากระยะไกล สคีมาที่รองรับคือ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ unix (ซ็อกเก็ต UNIX ในเครื่อง) หากไม่ได้ระบุสคีมา Bazel จะใช้ grpcs เป็นค่าเริ่มต้น ดูที่ https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
ค่าเริ่มต้น: "false"- ว่าจะกลับไปใช้โปรแกรมดาวน์โหลดในเครื่องหรือไม่หากโปรแกรมดาวน์โหลดระยะไกลล้มเหลว
--[no]experimental_remote_execution_keepalive
ค่าเริ่มต้น: "false"- ว่าจะใช้ 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.>
ค่าเริ่มต้น: "60s"-
ช่วงเวลาที่ใช้ในการคำนวณอัตราความล้มเหลวของคำขอระยะไกล หากค่าเป็น 0 หรือค่าลบ ระบบจะคำนวณระยะเวลาที่ล้มเหลวตลอดระยะเวลาการดำเนินการทั้งหมด คุณสามารถใช้หน่วยต่อไปนี้ได้ วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
แท็กexecution
--[no]experimental_remote_mark_tool_inputs
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" Bazel จะทำเครื่องหมายอินพุตเป็นอินพุตเครื่องมือสำหรับตัวดำเนินการระยะไกล ซึ่งใช้เพื่อติดตั้งใช้งานพนักงานแบบถาวรที่ทำงานจากระยะไกลได้
--[no]experimental_remote_merkle_tree_cache
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" ระบบจะบันทึกการคำนวณ Merkle Tree เพื่อปรับปรุงความเร็วในการตรวจสอบแคชระยะไกล ระบบจะควบคุมปริมาณหน่วยความจำของแคชโดยใช้ --experimental_remote_merkle_tree_cache_size
--experimental_remote_merkle_tree_cache_size=<a long integer>
ค่าเริ่มต้น: "1000"- จำนวนต้นไม้ Merkle ที่จะบันทึกเพื่อปรับปรุงความเร็วในการตรวจสอบการเข้าถึงแคชระยะไกล แม้ว่าระบบจะล้างแคชโดยอัตโนมัติตามการจัดการการอ้างอิงแบบอ่อนของ Java แต่ข้อผิดพลาดหน่วยความจำไม่เพียงพออาจเกิดขึ้นได้หากตั้งค่าสูงเกินไป หากตั้งค่าเป็น 0 ระบบจะไม่จำกัดขนาดแคช ค่าที่เหมาะสมจะแตกต่างกันไปตามขนาดของโปรเจ็กต์ ค่าเริ่มต้นคือ 1,000
--[no]experimental_remote_require_cached
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" ให้บังคับแคชการดำเนินการทั้งหมดที่เรียกใช้จากระยะไกลได้ หรือไม่เช่นนั้นให้สร้างไม่สำเร็จ ซึ่งจะเป็นประโยชน์ในการแก้ปัญหาเกี่ยวกับความไม่แน่นอน เนื่องจากช่วยให้ตรวจสอบได้ว่าการดำเนินการที่ควรแคชนั้นแคชจริงหรือไม่ โดยไม่ต้องแทรกผลลัพธ์ใหม่ที่ไม่เกี่ยวข้องลงในแคช
--[no]incompatible_remote_build_event_upload_respect_no_cache
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" ระบบจะไม่โหลดเอาต์พุตที่ BEP อ้างอิงไปยังแคชระยะไกลหากแคชการดำเนินการสร้างจากระยะไกลไม่ได้
--[no]incompatible_remote_downloader_send_all_headers
ค่าเริ่มต้น: "จริง"-
เลือกว่าจะส่งค่าทั้งหมดของส่วนหัวที่มีหลายค่าไปยังโปรแกรมดาวน์โหลดระยะไกลแทนที่จะส่งเฉพาะค่าแรกหรือไม่
แท็กincompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" เส้นทางเอาต์พุตจะสัมพันธ์กับรูทอินพุตแทนที่จะเป็นไดเรกทอรีการทำงาน
แท็กincompatible_change
--[no]incompatible_remote_results_ignore_disk
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็น "จริง" ระบบจะไม่ใช้ --noremote_upload_local_results และ --noremote_accept_cached กับแคชในดิสก์ หากใช้แคชแบบรวม
--noremote_upload_local_results จะทำให้ระบบเขียนผลลัพธ์ลงในแคชในดิสก์ แต่จะไม่ส่งไปยังแคชระยะไกล
--noremote_accept_cached จะทำให้ Bazel ตรวจสอบผลลัพธ์ในแคชในดิสก์ แต่ไม่ใช่ในแคชระยะไกล
การดำเนินการ no-remote-exec สามารถเข้าถึงแคชในดิสก์ได้
ดูรายละเอียดได้ที่ #8216
แท็กincompatible_change
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" Bazel จะใช้รหัสออกใหม่ 39 แทน 34 หากแคชระยะไกลลบออบเจ็กต์ BLOB ระหว่างการสร้าง
แท็กincompatible_change
--[no]remote_accept_cached
ค่าเริ่มต้น: "จริง"- เลือกว่าจะยอมรับผลลัพธ์ของการดำเนินการที่แคชไว้จากระยะไกลหรือไม่
--remote_bytestream_uri_prefix=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ชื่อโฮสต์และชื่ออินสแตนซ์ที่จะใช้ใน URI ของ bytestream:// ที่เขียนลงในสตรีมเหตุการณ์บิลด์ คุณตั้งค่าตัวเลือกนี้ได้เมื่อทำการบิลด์โดยใช้พร็อกซี ซึ่งจะทำให้ค่าของ --remote_executor และ --remote_instance_name ไม่สอดคล้องกับชื่อที่แน่นอนของบริการการดำเนินการจากระยะไกลอีกต่อไป หากไม่ได้ตั้งค่าไว้ ค่าเริ่มต้นจะเป็น "${hostname}/${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
--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_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 บันทึกนี้ประกอบด้วยลำดับของ protobuf com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry ที่ทำให้เป็นอนุกรม โดยแต่ละข้อความจะมีคำนำหน้าเป็น varint ที่ระบุขนาดของข้อความ protobuf ที่ทำให้เป็นอนุกรมต่อไปนี้ ตามที่ดำเนินการโดยเมธอด 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
ค่าเริ่มต้น: "false"- จะกลับไปใช้กลยุทธ์การดำเนินการในเครื่องแบบสแตนด์อโลนหรือไม่หากการดำเนินการจากระยะไกลล้มเหลว
--remote_local_fallback_strategy=<a string>
ค่าเริ่มต้น: "local"- ไม่มีการดำเนินการ เลิกใช้งานแล้ว ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7480
--remote_max_connections=<an integer>
ค่าเริ่มต้น: "100"-
จำกัดจำนวนการเชื่อมต่อพร้อมกันสูงสุดกับแคช/เครื่องมือดำเนินการระยะไกล โดยค่าเริ่มต้น ค่านี้จะเป็น 100 การตั้งค่านี้เป็น 0 หมายความว่าไม่มีข้อจำกัด
สำหรับแคชระยะไกล HTTP การเชื่อมต่อ TCP หนึ่งรายการจะจัดการคำขอได้ครั้งละ 1 รายการ ดังนั้น Bazel จึงสามารถส่งคำขอพร้อมกันได้สูงสุด --remote_max_connections
สำหรับแคช/ตัวดำเนินการระยะไกล gRPC โดยปกติแล้วแชแนล gRPC 1 รายการจะจัดการคำขอพร้อมกันได้มากกว่า 100 รายการ ดังนั้น Bazel จึงสามารถส่งคำขอพร้อมกันได้ประมาณ `--remote_max_connections * 100` รายการ
แท็กhost_machine_resource_optimizations
--remote_proxy=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- เชื่อมต่อกับแคชระยะไกลผ่านพร็อกซี ปัจจุบันนี้ คุณใช้แฟล็กนี้เพื่อกำหนดค่า Unix Domain Socket (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), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
--remote_timeout=<An immutable length of time.>
ค่าเริ่มต้น: "60s"- ระยะเวลารอสูงสุดสำหรับการเรียกการดำเนินการระยะไกลและการเรียกแคช สำหรับแคช REST นี่คือทั้งการเชื่อมต่อและการหมดเวลาในการอ่าน คุณใช้หน่วยต่อไปนี้ได้ วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
--[no]remote_upload_local_results
ค่าเริ่มต้น: "จริง"- ว่าจะอัปโหลดผลการดำเนินการที่เรียกใช้ในเครื่องไปยังแคชระยะไกลหรือไม่ หากแคชระยะไกลรองรับและผู้ใช้ได้รับอนุญาตให้ดำเนินการดังกล่าว
--[no]remote_verify_downloads
ค่าเริ่มต้น: "จริง"- หากตั้งค่าเป็น true Bazel จะคำนวณผลรวมแฮชของการดาวน์โหลดจากระยะไกลทั้งหมด และทิ้งค่าที่แคชจากระยะไกลหากไม่ตรงกับค่าที่คาดไว้
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้:
--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.>
มีการสะสมการใช้งานหลายครั้ง- กำหนดค่าโปรแกรมช่วยเหลือข้อมูลเข้าสู่ระบบที่จะใช้ในการดึงข้อมูลเข้าสู่ระบบการให้สิทธิ์สำหรับการดึงข้อมูลที่เก็บ การแคชและการดำเนินการระยะไกล และบริการเหตุการณ์การสร้าง ข้อมูลเข้าสู่ระบบที่ตัวช่วยระบุจะมีลำดับความสำคัญเหนือกว่าข้อมูลเข้าสู่ระบบที่ระบุโดย --google_default_credentials, --google_credentials, ไฟล์ .netrc หรือพารามิเตอร์การตรวจสอบสิทธิ์ไปยัง repository_ctx.download และ repository_ctx.download_and_extract ระบุได้หลายครั้งเพื่อตั้งค่าผู้ช่วยหลายราย ดูรายละเอียดได้ที่ https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md
--credential_helper_cache_duration=<An immutable length of time.>
ค่าเริ่มต้น: "30m"- ระยะเวลาที่ระบบจะแคชข้อมูลเข้าสู่ระบบที่ตัวช่วยข้อมูลเข้าสู่ระบบระบุ การเรียกใช้ด้วยค่าอื่นจะปรับอายุการใช้งานของรายการที่มีอยู่แล้ว ให้ส่งค่า 0 เพื่อล้างแคช คำสั่ง clean จะล้างแคชเสมอ ไม่ว่าจะมีแฟล็กนี้หรือไม่ก็ตาม
--credential_helper_timeout=<An immutable length of time.>
ค่าเริ่มต้น: "10s"- กำหนดค่าการหมดเวลาสำหรับโปรแกรมช่วยจัดการข้อมูลเข้าสู่ระบบ หากผู้ช่วยจัดการข้อมูลเข้าสู่ระบบไม่ตอบกลับภายในระยะหมดเวลานี้ การเรียกใช้จะล้มเหลว
--deleted_packages=<comma-separated list of package names>
ค่าเริ่มต้น: ""- รายการชื่อแพ็กเกจที่คั่นด้วยคอมมา ซึ่งระบบบิลด์จะถือว่าไม่มีอยู่ แม้ว่าจะมองเห็นได้ที่ใดที่หนึ่งในเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ เช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์แล้ว ระบบบิลด์อาจแจ้งข้อผิดพลาดหากพบป้ายกำกับ "//x:y/z" หากรายการ package_path อื่นยังคงระบุป้ายกำกับนั้น การระบุ --deleted_packages x/y จะช่วยหลีกเลี่ยงปัญหานี้ได้
--disk_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย- เส้นทางไปยังไดเรกทอรีที่ Bazel อ่านและเขียนการดำเนินการและเอาต์พุตของการดำเนินการได้ หากยังไม่มีไดเรกทอรี ระบบจะสร้างให้
--google_auth_scopes=<comma-separated list of options>
default: "https://www.googleapis.com/auth/cloud-platform"- รายการขอบเขตการตรวจสอบสิทธิ์ของ Google Cloud ที่คั่นด้วยคอมมา
--google_credentials=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไฟล์ที่จะรับข้อมูลเข้าสู่ระบบสำหรับการตรวจสอบสิทธิ์ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication
--[no]google_default_credentials
ค่าเริ่มต้น: "false"- ว่าจะใช้ "ข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชันของ Google" สำหรับการตรวจสอบสิทธิ์หรือไม่ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication ปิดใช้โดยค่าเริ่มต้น
--grpc_keepalive_time=<An immutable length of time.>
ค่าเริ่มต้น: ดูคำอธิบาย- กำหนดค่า Ping Keep-Alive สำหรับการเชื่อมต่อ gRPC ขาออก หากตั้งค่านี้ไว้ Bazel จะส่งการ Ping หลังจากไม่มีการดำเนินการอ่านในการเชื่อมต่อเป็นเวลานานเท่านี้ แต่จะส่งก็ต่อเมื่อมีการเรียก gRPC ที่รอดำเนินการอย่างน้อย 1 รายการ ระบบจะถือว่าเวลาเป็นหน่วยวินาที การตั้งค่าที่น้อยกว่า 1 วินาทีถือเป็นข้อผิดพลาด โดยค่าเริ่มต้น ระบบจะปิดใช้ Ping Keep-Alive คุณควรประสานงานกับเจ้าของบริการก่อนที่จะเปิดใช้การตั้งค่านี้ เช่น หากต้องการตั้งค่าเป็น 30 วินาที ให้ทำดังนี้ --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.>
ค่าเริ่มต้น: "20s"- กำหนดค่าการหมดเวลา Keep-Alive สำหรับการเชื่อมต่อ gRPC ขาออก หากเปิดใช้คำสั่ง ping keep-alive ด้วย --grpc_keepalive_time Bazel จะหมดเวลาการเชื่อมต่อหากไม่ได้รับการตอบกลับคำสั่ง ping หลังจากผ่านไประยะเวลาดังกล่าว ระบบจะถือว่าเวลาเป็นหน่วยวินาที การตั้งค่าที่น้อยกว่า 1 วินาทีถือเป็นข้อผิดพลาด หากปิดใช้ Ping Keep-Alive ระบบจะไม่สนใจการตั้งค่านี้
--override_repository=<an equals-separated mapping of repository name to path>
มีการสะสมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--package_path=<colon-separated list of options>
ค่าเริ่มต้น: "%workspace%"- รายการที่คั่นด้วยโคลอนของตำแหน่งที่จะค้นหาแพ็กเกจ องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับเวิร์กสเปซที่ครอบคลุม หากละไว้หรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
--[no]show_loading_progress
ค่าเริ่มต้น: "จริง"- หากเปิดใช้ จะทำให้ Bazel พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ"
--tls_certificate=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุเส้นทางไปยังใบรับรอง TLS ที่เชื่อถือได้ในการลงนามใบรับรองเซิร์ฟเวอร์
--tls_client_certificate=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุใบรับรองไคลเอ็นต์ TLS ที่จะใช้ คุณต้องระบุคีย์ไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
--tls_client_key=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุคีย์ไคลเอ็นต์ TLS ที่จะใช้ คุณต้องระบุใบรับรองไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
ตัวเลือกการเรียกใช้
รับตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคำสั่งและไคลเอ็นต์แยกวิเคราะห์
--distdir=<a path>
มีการสะสมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาไฟล์เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บจะลิงก์แบบฮาร์ดลิงก์ไฟล์ในกรณีที่แคชตรงกันแทนที่จะคัดลอก ซึ่งมีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL เปลี่ยนแปลงและส่งผลให้มีการดาวน์โหลดซ้ำแม้ว่าแคชจะมีรายการที่ดาวน์โหลดซึ่งมีแฮชเดียวกันก็ตาม ซึ่งใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL ไม่ได้ทำให้ที่เก็บข้อมูลเสียหายซึ่งถูกแคชซ่อนไว้
แท็ก:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ จะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็กexperimental
--experimental_repository_downloader_retries=<an integer>
ค่าเริ่มต้น: "0"-
จำนวนครั้งสูงสุดที่พยายามลองดาวน์โหลดซ้ำเมื่อเกิดข้อผิดพลาด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็กexperimental
--experimental_scale_timeouts=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับขนาดการหมดเวลาทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ ด้วยวิธีนี้ คุณจึงทำให้ที่เก็บข้อมูลภายนอกทำงานในเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็กbazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับการหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลดผ่าน http ตามปัจจัยที่ระบุ
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้มาในระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ช่วยให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการ ซึ่งจะส่งผลต่อค่าของเอาต์พุตนั้นๆ แทนที่จะส่งผลต่อการมีอยู่ของเอาต์พุต
--script_path=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
หากตั้งค่าไว้ ให้เขียนสคริปต์เชลล์ลงในไฟล์ที่ระบุซึ่งเรียกใช้เป้าหมาย หากตั้งค่าตัวเลือกนี้ ระบบจะไม่เรียกใช้เป้าหมายจาก Bazel ใช้ "bazel run --script_path=foo //foo && ./foo" เพื่อเรียกใช้เป้าหมาย "//foo" ซึ่งแตกต่างจาก "bazel run //foo" ตรงที่ระบบจะปลดล็อก Bazel และเชื่อมต่อไฟล์ที่เรียกใช้งานได้กับ stdin ของเทอร์มินัล
แท็ก:affects_outputs
,execution
- ตัวเลือกที่มีผลต่อความเข้มงวดของ Bazel ในการบังคับใช้ข้อมูลอินพุตการบิลด์ที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าสถานะ ฯลฯ)
--experimental_repository_hash_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรมีการยืนยันแฮชของไดเรกทอรีที่เก็บเทียบกับค่านี้
แท็ก:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
มีการสะสมการใช้งานหลายครั้ง-
หากมีรายการกฎที่เก็บที่ควรมีการยืนยันแฮชของไดเรกทอรีเอาต์พุต โดยระบุไฟล์ด้วย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้มีผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ในไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
ค่าเริ่มต้น: "จริง"-
ไม่มีการดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะได้รับอนุญาตในกราฟการอ้างอิงที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่าถูกยกเลิกในรีจิสทรีที่โมดูลมาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น เวอร์ชันที่ถูกเพิกถอนจะทำให้การแก้ไขล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันที่อนุญาตให้ยกเลิกได้ด้วยตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็กloading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ `error` เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาที่ไม่สำเร็จ, `off` เพื่อปิดใช้การตรวจสอบ หรือ `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน
แท็กloading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าการอ้างอิง `bazel_dep` โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้ว ค่าที่ใช้ได้คือ `off` เพื่อปิดใช้การตรวจสอบ, `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน หรือ `error` เพื่อส่งต่อเป็นความล้มเหลวในการแก้ไข
แท็กloading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นการขึ้นต่อกันของนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท ไม่ว่าค่าของแฟล็กนี้จะเป็นอะไรก็ตาม
แท็กloading_and_analysis
--lockfile_mode=<off, update or error>
ค่าเริ่มต้น: "ปิด"-
ระบุวิธีและจะใช้หรือไม่ใช้ไฟล์ล็อก ค่าที่ใช้ได้คือ `update` เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง, `error` เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่อัปเดต หรือ `off` เพื่อไม่ให้อ่านหรือเขียนไปยังไฟล์ล็อก
แท็กloading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
มีการสะสมการใช้งานหลายครั้ง- แทนที่โมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--registry=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้เพื่อค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับมีความสำคัญ โดยระบบจะค้นหาโมดูลในรีจิสทรีที่อยู่ก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีที่อยู่ถัดไปก็ต่อเมื่อไม่มีโมดูลในรีจิสทรีที่อยู่ก่อนหน้า
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อความละเอียด รูปแบบ หรือตำแหน่งของการบันทึก:
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น ระบบจะจำกัดจำนวนประเภทการดำเนินการไว้ที่ 20 นิโมนิกที่มีจำนวนการดำเนินการที่ดำเนินการแล้วมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับทุกคำช่วยจำ
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปในคำสั่ง Bazel ซึ่งไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้อ่านไฟล์ที่ระบุซึ่งแก้ไขแล้วแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
--experimental_downloader_config=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไฟล์เพื่อกำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สำหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ รูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้เป็น URL แทน โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณสามารถระบุคำสั่ง `rewrite` หลายรายการสำหรับ URL เดียวกันได้ และในกรณีนี้ ระบบจะแสดง URL หลายรายการ
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้:
--override_repository=<an equals-separated mapping of repository name to path>
มีการสะสมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุเริ่มต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
ตัวเลือกการปิดเครื่อง
- ตัวเลือกที่ปรากฏก่อนคำสั่งและไคลเอ็นต์แยกวิเคราะห์
--distdir=<a path>
มีการสะสมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาไฟล์เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บจะลิงก์แบบฮาร์ดลิงก์ไฟล์ในกรณีที่แคชตรงกันแทนที่จะคัดลอก ซึ่งมีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL เปลี่ยนแปลงและส่งผลให้มีการดาวน์โหลดซ้ำแม้ว่าแคชจะมีรายการที่ดาวน์โหลดซึ่งมีแฮชเดียวกันก็ตาม ซึ่งใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL ไม่ได้ทำให้ที่เก็บข้อมูลเสียหายซึ่งถูกแคชซ่อนไว้
แท็ก:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ จะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็กexperimental
--experimental_repository_downloader_retries=<an integer>
ค่าเริ่มต้น: "0"-
จำนวนครั้งสูงสุดที่พยายามลองดาวน์โหลดซ้ำเมื่อเกิดข้อผิดพลาด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็กexperimental
--experimental_scale_timeouts=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับขนาดการหมดเวลาทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ ด้วยวิธีนี้ คุณจึงทำให้ที่เก็บข้อมูลภายนอกทำงานในเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็กbazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับการหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลดผ่าน http ตามปัจจัยที่ระบุ
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้มาในระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่ง
--iff_heap_size_greater_than=<an integer>
ค่าเริ่มต้น: "0"-
หากไม่ใช่ 0 การปิดระบบจะปิดเซิร์ฟเวอร์ก็ต่อเมื่อหน่วยความจำทั้งหมด (ในหน่วย MB) ที่ JVM ใช้เกินค่านี้
แท็ก:loses_incremental_state
,eagerness_to_exit
- ตัวเลือกที่มีผลต่อความเข้มงวดของ Bazel ในการบังคับใช้ข้อมูลอินพุตการบิลด์ที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าสถานะ ฯลฯ)
--experimental_repository_hash_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรมีการยืนยันแฮชของไดเรกทอรีที่เก็บเทียบกับค่านี้
แท็ก:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
มีการสะสมการใช้งานหลายครั้ง-
หากมีรายการกฎที่เก็บที่ควรมีการยืนยันแฮชของไดเรกทอรีเอาต์พุต โดยระบุไฟล์ด้วย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้มีผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ในไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
ค่าเริ่มต้น: "จริง"-
ไม่มีการดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะได้รับอนุญาตในกราฟการอ้างอิงที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่าถูกยกเลิกในรีจิสทรีที่โมดูลมาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น เวอร์ชันที่ถูกเพิกถอนจะทำให้การแก้ไขล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันที่อนุญาตให้ยกเลิกได้ด้วยตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็กloading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ `error` เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาที่ไม่สำเร็จ, `off` เพื่อปิดใช้การตรวจสอบ หรือ `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน
แท็กloading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าการอ้างอิง `bazel_dep` โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้ว ค่าที่ใช้ได้คือ `off` เพื่อปิดใช้การตรวจสอบ, `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน หรือ `error` เพื่อส่งต่อเป็นความล้มเหลวในการแก้ไข
แท็กloading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นการขึ้นต่อกันของนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท ไม่ว่าค่าของแฟล็กนี้จะเป็นอะไรก็ตาม
แท็กloading_and_analysis
--lockfile_mode=<off, update or error>
ค่าเริ่มต้น: "ปิด"-
ระบุวิธีและจะใช้หรือไม่ใช้ไฟล์ล็อก ค่าที่ใช้ได้คือ `update` เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง, `error` เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่อัปเดต หรือ `off` เพื่อไม่ให้อ่านหรือเขียนไปยังไฟล์ล็อก
แท็กloading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
มีการสะสมการใช้งานหลายครั้ง- แทนที่โมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--registry=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้เพื่อค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับมีความสำคัญ โดยระบบจะค้นหาโมดูลในรีจิสทรีที่อยู่ก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีที่อยู่ถัดไปก็ต่อเมื่อไม่มีโมดูลในรีจิสทรีที่อยู่ก่อนหน้า
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อความละเอียด รูปแบบ หรือตำแหน่งของการบันทึก:
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น ระบบจะจำกัดจำนวนประเภทการดำเนินการไว้ที่ 20 นิโมนิกที่มีจำนวนการดำเนินการที่ดำเนินการแล้วมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับทุกคำช่วยจำ
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปในคำสั่ง Bazel ซึ่งไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้อ่านไฟล์ที่ระบุซึ่งแก้ไขแล้วแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
--experimental_downloader_config=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไฟล์เพื่อกำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สำหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ รูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้เป็น URL แทน โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณสามารถระบุคำสั่ง `rewrite` หลายรายการสำหรับ URL เดียวกันได้ และในกรณีนี้ ระบบจะแสดง URL หลายรายการ
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้:
--override_repository=<an equals-separated mapping of repository name to path>
มีการสะสมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุเริ่มต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
ตัวเลือกการซิงค์
- ตัวเลือกที่ปรากฏก่อนคำสั่งและไคลเอ็นต์แยกวิเคราะห์
--distdir=<a path>
มีการสะสมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาไฟล์เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บจะลิงก์แบบฮาร์ดลิงก์ไฟล์ในกรณีที่แคชตรงกันแทนที่จะคัดลอก ซึ่งมีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL เปลี่ยนแปลงและส่งผลให้มีการดาวน์โหลดซ้ำแม้ว่าแคชจะมีรายการที่ดาวน์โหลดซึ่งมีแฮชเดียวกันก็ตาม ซึ่งใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL ไม่ได้ทำให้ที่เก็บข้อมูลเสียหายซึ่งถูกแคชซ่อนไว้
แท็ก:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ จะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็กexperimental
--experimental_repository_downloader_retries=<an integer>
ค่าเริ่มต้น: "0"-
จำนวนครั้งสูงสุดที่พยายามลองดาวน์โหลดซ้ำเมื่อเกิดข้อผิดพลาด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็กexperimental
--experimental_scale_timeouts=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับขนาดการหมดเวลาทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ ด้วยวิธีนี้ คุณจึงทำให้ที่เก็บข้อมูลภายนอกทำงานในเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็กbazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับการหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลดผ่าน http ตามปัจจัยที่ระบุ
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้มาในระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
--[no]configure
ค่าเริ่มต้น: "False"-
ซิงค์เฉพาะที่เก็บที่ทำเครื่องหมายเป็น "กำหนดค่า" เพื่อวัตถุประสงค์ในการกำหนดค่าระบบ
แท็กchanges_inputs
--[no]incompatible_remote_dangling_symlinks
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็นจริงและ --incompatible_remote_symlinks เป็นจริงด้วย ระบบจะอนุญาตให้ซิมลิงก์ในเอาต์พุตของการดำเนินการค้างอยู่
แท็ก:execution
,incompatible_change
--[no]incompatible_remote_symlinks
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็น "จริง" Bazel จะแสดงลิงก์สัญลักษณ์ในเอาต์พุตการดำเนินการในโปรโตคอลการแคช/การดำเนินการระยะไกลตามนั้น ไม่เช่นนั้น ระบบจะติดตามลิงก์สัญลักษณ์และแสดงเป็นไฟล์หรือไดเรกทอรี ดูรายละเอียดได้ที่ #6631
แท็ก:execution
,incompatible_change
--[no]keep_going
[-k
] ค่าเริ่มต้น: "false"-
ดำเนินการต่อให้ได้มากที่สุดหลังจากเกิดข้อผิดพลาด แม้ว่าจะวิเคราะห์เป้าหมายที่ล้มเหลวและเป้าหมายที่ขึ้นอยู่กับเป้าหมายนั้นไม่ได้ แต่ก็วิเคราะห์ข้อกำหนดเบื้องต้นอื่นๆ ของเป้าหมายเหล่านี้ได้
แท็ก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">
ค่าเริ่มต้น: "auto"-
จำนวนเธรดแบบขนานที่จะใช้ในระยะการโหลด/วิเคราะห์ รับค่าจำนวนเต็มหรือคีย์เวิร์ด ("auto", "HOST_CPUS", "HOST_RAM") ตามด้วยการดำเนินการ ([-|*]<float>) เช่น "auto", "HOST_CPUS*.5" "auto" จะตั้งค่าเริ่มต้นที่เหมาะสมตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็กbazel_internal_configuration
--only=<a string>
มีการสะสมการใช้งานหลายครั้ง-
หากมีตัวเลือกนี้ ให้ซิงค์เฉพาะที่เก็บที่ระบุด้วยตัวเลือกนี้ ยังคงถือว่าทั้งหมด (หรือทั้งหมดที่คล้ายกับการกำหนดค่า หากมีการระบุ --configure) ล้าสมัย
แท็ก:changes_inputs
- ตัวเลือกที่ช่วยให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการ ซึ่งจะส่งผลต่อค่าของเอาต์พุตนั้น ไม่ใช่การมีอยู่ของเอาต์พุต
--bep_maximum_open_remote_upload_files=<an integer>
ค่าเริ่มต้น: "-1"-
จำนวนไฟล์ที่เปิดสูงสุดที่อนุญาตในระหว่างการอัปโหลดอาร์ติแฟกต์ BEP
แท็กaffects_outputs
--remote_download_minimal
-
ไม่ดาวน์โหลดเอาต์พุตการสร้างระยะไกลไปยังเครื่องในระบบ Flag นี้เป็นทางลัดสำหรับ Flag: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata และ --remote_download_outputs=minimal
ขยายเป็น
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
แท็กaffects_outputs
--remote_download_outputs=<all, minimal or toplevel>
ค่าเริ่มต้น: "all"-
หากตั้งค่าเป็น "น้อยที่สุด" จะไม่ดาวน์โหลดเอาต์พุตการสร้างจากระยะไกลไปยังเครื่องในพื้นที่ ยกเว้นเอาต์พุตที่การกระทำในพื้นที่กำหนด หากตั้งค่าเป็น "toplevel" จะทํางานเหมือน "minimal" ยกเว้นว่าจะดาวน์โหลดเอาต์พุตของเป้าหมายระดับบนสุดไปยังเครื่องในเครื่องด้วย ทั้ง 2 ตัวเลือกช่วยลดเวลาในการสร้างได้อย่างมากหากแบนด์วิดท์เครือข่ายเป็นคอขวด
แท็กaffects_outputs
--remote_download_symlink_template=<a string>
ค่าเริ่มต้น: ""-
สร้างลิงก์สัญลักษณ์แทนการดาวน์โหลดเอาต์พุตบิลด์ระยะไกลไปยังเครื่องภายใน คุณระบุเป้าหมายของลิงก์สัญลักษณ์ได้ในรูปแบบของสตริงเทมเพลต สตริงเทมเพลตนี้อาจมี {hash} และ {size_bytes} ซึ่งจะขยายเป็นแฮชของออบเจ็กต์และขนาดในหน่วยไบต์ตามลำดับ ตัวอย่างเช่น ลิงก์สัญลักษณ์เหล่านี้อาจชี้ไปยังระบบไฟล์ FUSE ที่โหลดออบเจ็กต์จาก CAS ตามต้องการ
แท็กaffects_outputs
--remote_download_toplevel
-
ดาวน์โหลดเฉพาะเอาต์พุตระยะไกลของเป้าหมายระดับบนสุดไปยังเครื่องในเครื่อง Flag นี้เป็นทางลัดสำหรับ Flag: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata และ --remote_download_outputs=toplevel
ขยายเป็น
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
แท็กaffects_outputs
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้ข้อมูลอินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าสถานะ ฯลฯ)
--experimental_repository_hash_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรมีการยืนยันแฮชของไดเรกทอรีที่เก็บเทียบกับค่านี้
แท็ก:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
มีการสะสมการใช้งานหลายครั้ง-
หากมีรายการกฎที่เก็บที่ควรมีการยืนยันแฮชของไดเรกทอรีเอาต์พุต โดยระบุไฟล์ด้วย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้มีผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ในไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
ค่าเริ่มต้น: "จริง"-
แท็ก No-op
:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
ค่าเริ่มต้น: "false"-
หาก incompatible_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
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ให้บังคับใช้การจำกัดระดับการแชร์ config_setting หากเป็นเท็จ ทุกการตั้งค่า config จะมองเห็นได้สำหรับทุกเป้าหมาย ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะได้รับอนุญาตในกราฟการอ้างอิงที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่าถูกยกเลิกในรีจิสทรีที่โมดูลมาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น เวอร์ชันที่ถูกเพิกถอนจะทำให้การแก้ไขล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันที่อนุญาตให้ยกเลิกได้ด้วยตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็กloading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ `error` เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาที่ไม่สำเร็จ, `off` เพื่อปิดใช้การตรวจสอบ หรือ `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน
แท็กloading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าการอ้างอิง `bazel_dep` โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้ว ค่าที่ใช้ได้คือ `off` เพื่อปิดใช้การตรวจสอบ, `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน หรือ `error` เพื่อส่งต่อเป็นความล้มเหลวในการแก้ไข
แท็กloading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นการขึ้นต่อกันของนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท ไม่ว่าค่าของแฟล็กนี้จะเป็นอะไรก็ตาม
แท็กloading_and_analysis
--lockfile_mode=<off, update or error>
ค่าเริ่มต้น: "ปิด"-
ระบุวิธีและจะใช้หรือไม่ใช้ไฟล์ล็อก ค่าที่ใช้ได้คือ `update` เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง, `error` เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่อัปเดต หรือ `off` เพื่อไม่ให้อ่านหรือเขียนไปยังไฟล์ล็อก
แท็กloading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
มีการสะสมการใช้งานหลายครั้ง- แทนที่โมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--registry=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้เพื่อค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับมีความสำคัญ โดยระบบจะค้นหาโมดูลในรีจิสทรีที่อยู่ก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีที่อยู่ถัดไปก็ต่อเมื่อไม่มีโมดูลในรีจิสทรีที่อยู่ก่อนหน้า
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อความละเอียด รูปแบบ หรือตำแหน่งของการบันทึก:
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น ระบบจะจำกัดจำนวนประเภทการดำเนินการไว้ที่ 20 นิโมนิกที่มีจำนวนการดำเนินการที่ดำเนินการแล้วมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับทุกคำช่วยจำ
--experimental_repository_resolved_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้เขียนค่า Starlark พร้อมข้อมูลที่แก้ไขแล้วของกฎที่เก็บ Starlark ทั้งหมดที่ดำเนินการ
แท็กaffects_outputs
--remote_print_execution_messages=<failure, success or all>
ค่าเริ่มต้น: "failure"-
เลือกเวลาที่จะพิมพ์ข้อความการดำเนินการจากระยะไกล ค่าที่ใช้ได้คือ `failure` เพื่อพิมพ์เฉพาะเมื่อเกิดข้อผิดพลาด `success` เพื่อพิมพ์เฉพาะเมื่อสำเร็จ และ `all` เพื่อพิมพ์เสมอ
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้อ่านไฟล์ที่ระบุซึ่งแก้ไขแล้วแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
--experimental_circuit_breaker_strategy=<failure>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุกลยุทธ์สำหรับเบรกเกอร์ที่จะใช้ กลยุทธ์ที่ใช้ได้คือ "failure" หากค่าของตัวเลือกไม่ถูกต้อง ลักษณะการทำงานจะเหมือนกับไม่ได้ตั้งค่าตัวเลือก
แท็กexecution
--experimental_downloader_config=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไฟล์เพื่อกำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สำหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ รูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้เป็น URL แทน โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณสามารถระบุคำสั่ง `rewrite` หลายรายการสำหรับ URL เดียวกันได้ และในกรณีนี้ ระบบจะแสดง URL หลายรายการ
--[no]experimental_guard_against_concurrent_changes
ค่าเริ่มต้น: "false"- ปิดตัวเลือกนี้เพื่อปิดใช้การตรวจสอบ ctime ของไฟล์อินพุตของการดำเนินการก่อนอัปโหลดไปยังแคชระยะไกล อาจมีกรณีที่เคอร์เนล Linux หน่วงเวลาการเขียนไฟล์ ซึ่งอาจทำให้เกิดผลบวกเท็จ
--experimental_remote_build_event_upload=<all or minimal>
ค่าเริ่มต้น: "all"- หากตั้งค่าเป็น "all" ระบบจะอัปโหลดเอาต์พุตในพื้นที่ทั้งหมดที่ BEP อ้างอิงไปยังแคชระยะไกล หากตั้งค่าเป็น "น้อยที่สุด" ระบบจะไม่ส่งเอาต์พุตในเครื่องที่ BEP อ้างอิงไปยังแคชระยะไกล ยกเว้นไฟล์ที่มีความสำคัญต่อผู้ใช้ BEP (เช่น บันทึกการทดสอบและโปรไฟล์เวลา) ระบบจะใช้รูปแบบ bytestream:// สำหรับ URI ของไฟล์เสมอแม้ว่าจะไม่มีไฟล์ในแคชระยะไกลก็ตาม ค่าเริ่มต้นคือ "ทั้งหมด"
--[no]experimental_remote_cache_async
ค่าเริ่มต้น: "false"- หากเป็นจริง I/O ของแคชระยะไกลจะเกิดขึ้นในเบื้องหลังแทนที่จะเป็นส่วนหนึ่งของการเกิด
--[no]experimental_remote_cache_compression
ค่าเริ่มต้น: "false"- หากเปิดใช้ ให้บีบอัด/คลายการบีบอัด Blob ของแคชด้วย zstd
--experimental_remote_capture_corrupted_outputs=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย- เส้นทางไปยังไดเรกทอรีที่จะบันทึกเอาต์พุตที่เสียหาย
--[no]experimental_remote_discard_merkle_trees
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น true ให้ทิ้งสำเนาในหน่วยความจำของต้นไม้ Merkle ของรูทอินพุตและการแมปอินพุตที่เชื่อมโยงระหว่างการเรียก GetActionResult() และ Execute() ซึ่งจะช่วยลดการใช้หน่วยความจำได้อย่างมาก แต่ต้องให้ Bazel คำนวณใหม่เมื่อแคชระยะไกลไม่พบและมีการลองใหม่
--experimental_remote_downloader=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- URI ของปลายทาง Remote Asset API ที่จะใช้เป็นพร็อกซีการดาวน์โหลดจากระยะไกล สคีมาที่รองรับคือ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ unix (ซ็อกเก็ต UNIX ในเครื่อง) หากไม่ได้ระบุสคีมา Bazel จะใช้ grpcs เป็นค่าเริ่มต้น ดูที่ https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
ค่าเริ่มต้น: "false"- ว่าจะกลับไปใช้โปรแกรมดาวน์โหลดในเครื่องหรือไม่หากโปรแกรมดาวน์โหลดระยะไกลล้มเหลว
--[no]experimental_remote_execution_keepalive
ค่าเริ่มต้น: "false"- ว่าจะใช้ 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.>
ค่าเริ่มต้น: "60s"-
ช่วงเวลาที่ใช้ในการคำนวณอัตราความล้มเหลวของคำขอระยะไกล หากค่าเป็น 0 หรือค่าลบ ระบบจะคำนวณระยะเวลาที่ล้มเหลวตลอดระยะเวลาการดำเนินการทั้งหมด คุณสามารถใช้หน่วยต่อไปนี้ได้ วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
แท็กexecution
--[no]experimental_remote_mark_tool_inputs
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" Bazel จะทำเครื่องหมายอินพุตเป็นอินพุตเครื่องมือสำหรับตัวดำเนินการระยะไกล ซึ่งใช้เพื่อติดตั้งใช้งานพนักงานแบบถาวรที่ทำงานจากระยะไกลได้
--[no]experimental_remote_merkle_tree_cache
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" ระบบจะบันทึกการคำนวณ Merkle Tree เพื่อปรับปรุงความเร็วในการตรวจสอบแคชระยะไกล ระบบจะควบคุมปริมาณหน่วยความจำของแคชโดยใช้ --experimental_remote_merkle_tree_cache_size
--experimental_remote_merkle_tree_cache_size=<a long integer>
ค่าเริ่มต้น: "1000"- จำนวนต้นไม้ Merkle ที่จะบันทึกเพื่อปรับปรุงความเร็วในการตรวจสอบการเข้าถึงแคชระยะไกล แม้ว่าระบบจะล้างแคชโดยอัตโนมัติตามการจัดการการอ้างอิงแบบอ่อนของ Java แต่ข้อผิดพลาดหน่วยความจำไม่เพียงพออาจเกิดขึ้นได้หากตั้งค่าสูงเกินไป หากตั้งค่าเป็น 0 ระบบจะไม่จำกัดขนาดแคช ค่าที่เหมาะสมจะแตกต่างกันไปตามขนาดของโปรเจ็กต์ ค่าเริ่มต้นคือ 1,000
--[no]experimental_remote_require_cached
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" ให้บังคับแคชการดำเนินการทั้งหมดที่เรียกใช้จากระยะไกลได้ หรือไม่เช่นนั้นให้สร้างไม่สำเร็จ ซึ่งจะเป็นประโยชน์ในการแก้ปัญหาเกี่ยวกับความไม่แน่นอน เนื่องจากช่วยให้ตรวจสอบได้ว่าการดำเนินการที่ควรแคชนั้นแคชจริงหรือไม่ โดยไม่ต้องแทรกผลลัพธ์ใหม่ที่ไม่เกี่ยวข้องลงในแคช
--[no]incompatible_remote_build_event_upload_respect_no_cache
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" ระบบจะไม่โหลดเอาต์พุตที่ BEP อ้างอิงไปยังแคชระยะไกลหากแคชการดำเนินการสร้างจากระยะไกลไม่ได้
--[no]incompatible_remote_downloader_send_all_headers
ค่าเริ่มต้น: "จริง"-
เลือกว่าจะส่งค่าทั้งหมดของส่วนหัวที่มีหลายค่าไปยังโปรแกรมดาวน์โหลดระยะไกลแทนที่จะส่งเฉพาะค่าแรกหรือไม่
แท็กincompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" เส้นทางเอาต์พุตจะสัมพันธ์กับรูทอินพุตแทนที่จะเป็นไดเรกทอรีการทำงาน
แท็กincompatible_change
--[no]incompatible_remote_results_ignore_disk
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็น "จริง" ระบบจะไม่ใช้ --noremote_upload_local_results และ --noremote_accept_cached กับแคชในดิสก์ หากใช้แคชแบบรวม
--noremote_upload_local_results จะทำให้ระบบเขียนผลลัพธ์ลงในแคชในดิสก์ แต่จะไม่ส่งไปยังแคชระยะไกล
--noremote_accept_cached จะทำให้ Bazel ตรวจสอบผลลัพธ์ในแคชในดิสก์ แต่ไม่ใช่ในแคชระยะไกล
การดำเนินการ no-remote-exec สามารถเข้าถึงแคชในดิสก์ได้
ดูรายละเอียดได้ที่ #8216
แท็กincompatible_change
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" Bazel จะใช้รหัสออกใหม่ 39 แทน 34 หากแคชระยะไกลลบออบเจ็กต์ BLOB ระหว่างการสร้าง
แท็กincompatible_change
--[no]remote_accept_cached
ค่าเริ่มต้น: "จริง"- เลือกว่าจะยอมรับผลลัพธ์ของการดำเนินการที่แคชไว้จากระยะไกลหรือไม่
--remote_bytestream_uri_prefix=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ชื่อโฮสต์และชื่ออินสแตนซ์ที่จะใช้ใน URI ของ bytestream:// ที่เขียนลงในสตรีมเหตุการณ์บิลด์ คุณตั้งค่าตัวเลือกนี้ได้เมื่อทำการบิลด์โดยใช้พร็อกซี ซึ่งจะทำให้ค่าของ --remote_executor และ --remote_instance_name ไม่สอดคล้องกับชื่อที่แน่นอนของบริการการดำเนินการจากระยะไกลอีกต่อไป หากไม่ได้ตั้งค่าไว้ ค่าเริ่มต้นจะเป็น "${hostname}/${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
--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_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 บันทึกนี้ประกอบด้วยลำดับของ protobuf com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry ที่ทำให้เป็นอนุกรม โดยแต่ละข้อความจะมีคำนำหน้าเป็น varint ที่ระบุขนาดของข้อความ protobuf ที่ทำให้เป็นอนุกรมต่อไปนี้ ตามที่ดำเนินการโดยเมธอด 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
ค่าเริ่มต้น: "false"- จะกลับไปใช้กลยุทธ์การดำเนินการในเครื่องแบบสแตนด์อโลนหรือไม่หากการดำเนินการจากระยะไกลล้มเหลว
--remote_local_fallback_strategy=<a string>
ค่าเริ่มต้น: "local"- ไม่มีการดำเนินการ เลิกใช้งานแล้ว ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7480
--remote_max_connections=<an integer>
ค่าเริ่มต้น: "100"-
จำกัดจำนวนการเชื่อมต่อพร้อมกันสูงสุดกับแคช/เครื่องมือดำเนินการระยะไกล โดยค่าเริ่มต้น ค่านี้จะเป็น 100 การตั้งค่านี้เป็น 0 หมายความว่าไม่มีข้อจำกัด
สำหรับแคชระยะไกล HTTP การเชื่อมต่อ TCP หนึ่งรายการจะจัดการคำขอได้ครั้งละ 1 รายการ ดังนั้น Bazel จึงสามารถส่งคำขอพร้อมกันได้สูงสุด --remote_max_connections
สำหรับแคช/ตัวดำเนินการระยะไกล gRPC โดยปกติแล้วแชแนล gRPC 1 รายการจะจัดการคำขอพร้อมกันได้มากกว่า 100 รายการ ดังนั้น Bazel จึงสามารถส่งคำขอพร้อมกันได้ประมาณ `--remote_max_connections * 100` รายการ
แท็กhost_machine_resource_optimizations
--remote_proxy=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- เชื่อมต่อกับแคชระยะไกลผ่านพร็อกซี ปัจจุบันนี้ คุณใช้แฟล็กนี้เพื่อกำหนดค่า Unix Domain Socket (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), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
--remote_timeout=<An immutable length of time.>
ค่าเริ่มต้น: "60s"- ระยะเวลารอสูงสุดสำหรับการเรียกการดำเนินการระยะไกลและการเรียกแคช สำหรับแคช REST นี่คือทั้งการเชื่อมต่อและการหมดเวลาในการอ่าน คุณใช้หน่วยต่อไปนี้ได้ วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
--[no]remote_upload_local_results
ค่าเริ่มต้น: "จริง"- ว่าจะอัปโหลดผลการดำเนินการที่เรียกใช้ในเครื่องไปยังแคชระยะไกลหรือไม่ หากแคชระยะไกลรองรับและผู้ใช้ได้รับอนุญาตให้ดำเนินการดังกล่าว
--[no]remote_verify_downloads
ค่าเริ่มต้น: "จริง"- หากตั้งค่าเป็น true Bazel จะคำนวณผลรวมแฮชของการดาวน์โหลดจากระยะไกลทั้งหมด และทิ้งค่าที่แคชจากระยะไกลหากไม่ตรงกับค่าที่คาดไว้
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้:
--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.>
มีการสะสมการใช้งานหลายครั้ง- กำหนดค่าโปรแกรมช่วยเหลือข้อมูลเข้าสู่ระบบที่จะใช้ในการดึงข้อมูลเข้าสู่ระบบการให้สิทธิ์สำหรับการดึงข้อมูลที่เก็บ การแคชและการดำเนินการระยะไกล และบริการเหตุการณ์การสร้าง ข้อมูลเข้าสู่ระบบที่ตัวช่วยระบุจะมีลำดับความสำคัญเหนือกว่าข้อมูลเข้าสู่ระบบที่ระบุโดย --google_default_credentials, --google_credentials, ไฟล์ .netrc หรือพารามิเตอร์การตรวจสอบสิทธิ์ไปยัง repository_ctx.download และ repository_ctx.download_and_extract ระบุได้หลายครั้งเพื่อตั้งค่าผู้ช่วยหลายราย ดูรายละเอียดได้ที่ https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md
--credential_helper_cache_duration=<An immutable length of time.>
ค่าเริ่มต้น: "30m"- ระยะเวลาที่ระบบจะแคชข้อมูลเข้าสู่ระบบที่ตัวช่วยข้อมูลเข้าสู่ระบบระบุ การเรียกใช้ด้วยค่าอื่นจะปรับอายุการใช้งานของรายการที่มีอยู่แล้ว ให้ส่งค่า 0 เพื่อล้างแคช คำสั่ง clean จะล้างแคชเสมอ ไม่ว่าจะมีแฟล็กนี้หรือไม่ก็ตาม
--credential_helper_timeout=<An immutable length of time.>
ค่าเริ่มต้น: "10s"- กำหนดค่าการหมดเวลาสำหรับโปรแกรมช่วยจัดการข้อมูลเข้าสู่ระบบ หากผู้ช่วยจัดการข้อมูลเข้าสู่ระบบไม่ตอบกลับภายในระยะหมดเวลานี้ การเรียกใช้จะล้มเหลว
--deleted_packages=<comma-separated list of package names>
ค่าเริ่มต้น: ""- รายการชื่อแพ็กเกจที่คั่นด้วยคอมมา ซึ่งระบบบิลด์จะถือว่าไม่มีอยู่ แม้ว่าจะมองเห็นได้ที่ใดที่หนึ่งในเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ เช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์แล้ว ระบบบิลด์อาจแจ้งข้อผิดพลาดหากพบป้ายกำกับ "//x:y/z" หากรายการ package_path อื่นยังคงระบุป้ายกำกับนั้น การระบุ --deleted_packages x/y จะช่วยหลีกเลี่ยงปัญหานี้ได้
--disk_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย- เส้นทางไปยังไดเรกทอรีที่ Bazel อ่านและเขียนการดำเนินการและเอาต์พุตของการดำเนินการได้ หากยังไม่มีไดเรกทอรี ระบบจะสร้างให้
--google_auth_scopes=<comma-separated list of options>
default: "https://www.googleapis.com/auth/cloud-platform"- รายการขอบเขตการตรวจสอบสิทธิ์ของ Google Cloud ที่คั่นด้วยคอมมา
--google_credentials=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไฟล์ที่จะรับข้อมูลเข้าสู่ระบบสำหรับการตรวจสอบสิทธิ์ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication
--[no]google_default_credentials
ค่าเริ่มต้น: "false"- ว่าจะใช้ "ข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชันของ Google" สำหรับการตรวจสอบสิทธิ์หรือไม่ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication ปิดใช้โดยค่าเริ่มต้น
--grpc_keepalive_time=<An immutable length of time.>
ค่าเริ่มต้น: ดูคำอธิบาย- กำหนดค่า Ping Keep-Alive สำหรับการเชื่อมต่อ gRPC ขาออก หากตั้งค่านี้ไว้ Bazel จะส่งการ Ping หลังจากไม่มีการดำเนินการอ่านในการเชื่อมต่อเป็นเวลานานเท่านี้ แต่จะส่งก็ต่อเมื่อมีการเรียก gRPC ที่รอดำเนินการอย่างน้อย 1 รายการ ระบบจะถือว่าเวลาเป็นหน่วยวินาที การตั้งค่าที่น้อยกว่า 1 วินาทีถือเป็นข้อผิดพลาด โดยค่าเริ่มต้น ระบบจะปิดใช้ Ping Keep-Alive คุณควรประสานงานกับเจ้าของบริการก่อนที่จะเปิดใช้การตั้งค่านี้ เช่น หากต้องการตั้งค่าเป็น 30 วินาที ให้ทำดังนี้ --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.>
ค่าเริ่มต้น: "20s"- กำหนดค่าการหมดเวลา Keep-Alive สำหรับการเชื่อมต่อ gRPC ขาออก หากเปิดใช้คำสั่ง ping keep-alive ด้วย --grpc_keepalive_time Bazel จะหมดเวลาการเชื่อมต่อหากไม่ได้รับการตอบกลับคำสั่ง ping หลังจากผ่านไประยะเวลาดังกล่าว ระบบจะถือว่าเวลาเป็นหน่วยวินาที การตั้งค่าที่น้อยกว่า 1 วินาทีถือเป็นข้อผิดพลาด หากปิดใช้ Ping Keep-Alive ระบบจะไม่สนใจการตั้งค่านี้
--override_repository=<an equals-separated mapping of repository name to path>
มีการสะสมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--package_path=<colon-separated list of options>
ค่าเริ่มต้น: "%workspace%"- รายการที่คั่นด้วยโคลอนของตำแหน่งที่จะค้นหาแพ็กเกจ องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับเวิร์กสเปซที่ครอบคลุม หากละไว้หรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
--[no]show_loading_progress
ค่าเริ่มต้น: "จริง"- หากเปิดใช้ จะทำให้ Bazel พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ"
--tls_certificate=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุเส้นทางไปยังใบรับรอง TLS ที่เชื่อถือได้ในการลงนามใบรับรองเซิร์ฟเวอร์
--tls_client_certificate=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุใบรับรองไคลเอ็นต์ TLS ที่จะใช้ คุณต้องระบุคีย์ไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
--tls_client_key=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุคีย์ไคลเอ็นต์ TLS ที่จะใช้ คุณต้องระบุใบรับรองไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
ตัวเลือกการทดสอบ
รับตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคำสั่งและไคลเอ็นต์แยกวิเคราะห์
--distdir=<a path>
มีการสะสมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาไฟล์เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บจะลิงก์แบบฮาร์ดลิงก์ไฟล์ในกรณีที่แคชตรงกันแทนที่จะคัดลอก ซึ่งมีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL เปลี่ยนแปลงและส่งผลให้มีการดาวน์โหลดซ้ำแม้ว่าแคชจะมีรายการที่ดาวน์โหลดซึ่งมีแฮชเดียวกันก็ตาม ซึ่งใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL ไม่ได้ทำให้ที่เก็บข้อมูลเสียหายซึ่งถูกแคชซ่อนไว้
แท็ก:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ จะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็กexperimental
--experimental_repository_downloader_retries=<an integer>
ค่าเริ่มต้น: "0"-
จำนวนครั้งสูงสุดที่พยายามลองดาวน์โหลดซ้ำเมื่อเกิดข้อผิดพลาด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็กexperimental
--experimental_scale_timeouts=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับขนาดการหมดเวลาทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ ด้วยวิธีนี้ คุณจึงทำให้ที่เก็บข้อมูลภายนอกทำงานในเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็กbazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับการหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลดผ่าน http ตามปัจจัยที่ระบุ
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้มาในระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
--[no]incompatible_remote_dangling_symlinks
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็นจริงและ --incompatible_remote_symlinks เป็นจริงด้วย ระบบจะอนุญาตให้ซิมลิงก์ในเอาต์พุตของการดำเนินการค้างอยู่
แท็ก:execution
,incompatible_change
--[no]incompatible_remote_symlinks
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็น "จริง" Bazel จะแสดงลิงก์สัญลักษณ์ในเอาต์พุตการดำเนินการในโปรโตคอลการแคช/การดำเนินการระยะไกลตามนั้น ไม่เช่นนั้น ระบบจะติดตามลิงก์สัญลักษณ์และแสดงเป็นไฟล์หรือไดเรกทอรี ดูรายละเอียดได้ที่ #6631
แท็ก:execution
,incompatible_change
- ตัวเลือกที่อนุญาตให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการ ซึ่งจะส่งผลต่อค่าของเอาต์พุตนั้น ไม่ใช่การมีอยู่ของเอาต์พุต
--bep_maximum_open_remote_upload_files=<an integer>
ค่าเริ่มต้น: "-1"-
จำนวนไฟล์ที่เปิดสูงสุดที่อนุญาตในระหว่างการอัปโหลดอาร์ติแฟกต์ BEP
แท็กaffects_outputs
--remote_download_minimal
-
ไม่ดาวน์โหลดเอาต์พุตการสร้างระยะไกลไปยังเครื่องในระบบ Flag นี้เป็นทางลัดสำหรับ Flag: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata และ --remote_download_outputs=minimal
ขยายเป็น
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
แท็กaffects_outputs
--remote_download_outputs=<all, minimal or toplevel>
ค่าเริ่มต้น: "all"-
หากตั้งค่าเป็น "น้อยที่สุด" จะไม่ดาวน์โหลดเอาต์พุตการสร้างจากระยะไกลไปยังเครื่องในพื้นที่ ยกเว้นเอาต์พุตที่การกระทำในพื้นที่กำหนด หากตั้งค่าเป็น "toplevel" จะทํางานเหมือน "minimal" ยกเว้นว่าจะดาวน์โหลดเอาต์พุตของเป้าหมายระดับบนสุดไปยังเครื่องในเครื่องด้วย ทั้ง 2 ตัวเลือกช่วยลดเวลาในการสร้างได้อย่างมากหากแบนด์วิดท์เครือข่ายเป็นคอขวด
แท็กaffects_outputs
--remote_download_symlink_template=<a string>
ค่าเริ่มต้น: ""-
สร้างลิงก์สัญลักษณ์แทนการดาวน์โหลดเอาต์พุตบิลด์ระยะไกลไปยังเครื่องภายใน คุณระบุเป้าหมายของลิงก์สัญลักษณ์ได้ในรูปแบบของสตริงเทมเพลต สตริงเทมเพลตนี้อาจมี {hash} และ {size_bytes} ซึ่งจะขยายเป็นแฮชของออบเจ็กต์และขนาดในหน่วยไบต์ตามลำดับ ตัวอย่างเช่น ลิงก์สัญลักษณ์เหล่านี้อาจชี้ไปยังระบบไฟล์ FUSE ที่โหลดออบเจ็กต์จาก CAS ตามต้องการ
แท็กaffects_outputs
--remote_download_toplevel
-
ดาวน์โหลดเฉพาะเอาต์พุตระยะไกลของเป้าหมายระดับบนสุดไปยังเครื่องในเครื่อง Flag นี้เป็นทางลัดสำหรับ Flag: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata และ --remote_download_outputs=toplevel
ขยายเป็น
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
แท็กaffects_outputs
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้ข้อมูลอินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าสถานะ ฯลฯ)
--experimental_repository_hash_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรมีการยืนยันแฮชของไดเรกทอรีที่เก็บเทียบกับค่านี้
แท็ก:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
มีการสะสมการใช้งานหลายครั้ง-
หากมีรายการกฎที่เก็บที่ควรมีการยืนยันแฮชของไดเรกทอรีเอาต์พุต โดยระบุไฟล์ด้วย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้มีผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ในไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
ค่าเริ่มต้น: "จริง"-
ไม่มีการดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะได้รับอนุญาตในกราฟการอ้างอิงที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่าถูกยกเลิกในรีจิสทรีที่โมดูลมาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น เวอร์ชันที่ถูกเพิกถอนจะทำให้การแก้ไขล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันที่อนุญาตให้ยกเลิกได้ด้วยตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็กloading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ `error` เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาที่ไม่สำเร็จ, `off` เพื่อปิดใช้การตรวจสอบ หรือ `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน
แท็กloading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าการอ้างอิง `bazel_dep` โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้ว ค่าที่ใช้ได้คือ `off` เพื่อปิดใช้การตรวจสอบ, `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน หรือ `error` เพื่อส่งต่อเป็นความล้มเหลวในการแก้ไข
แท็กloading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นการขึ้นต่อกันของนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท ไม่ว่าค่าของแฟล็กนี้จะเป็นอะไรก็ตาม
แท็กloading_and_analysis
--lockfile_mode=<off, update or error>
ค่าเริ่มต้น: "ปิด"-
ระบุวิธีและจะใช้หรือไม่ใช้ไฟล์ล็อก ค่าที่ใช้ได้คือ `update` เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง, `error` เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่อัปเดต หรือ `off` เพื่อไม่ให้อ่านหรือเขียนไปยังไฟล์ล็อก
แท็กloading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
มีการสะสมการใช้งานหลายครั้ง- แทนที่โมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--registry=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้เพื่อค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับมีความสำคัญ โดยระบบจะค้นหาโมดูลในรีจิสทรีที่อยู่ก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีที่อยู่ถัดไปก็ต่อเมื่อไม่มีโมดูลในรีจิสทรีที่อยู่ก่อนหน้า
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อความละเอียด รูปแบบ หรือตำแหน่งของการบันทึก:
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น ระบบจะจำกัดจำนวนประเภทการดำเนินการไว้ที่ 20 นิโมนิกที่มีจำนวนการดำเนินการที่ดำเนินการแล้วมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับทุกคำช่วยจำ
--[no]print_relative_test_log_paths
ค่าเริ่มต้น: "false"-
หากเป็นจริง เมื่อพิมพ์เส้นทางไปยังบันทึกการทดสอบ ให้ใช้เส้นทางแบบสัมพัทธ์ที่ใช้ประโยชน์จากลิงก์สัญลักษณ์ที่สะดวกของ "testlogs" หมายเหตุ - การเรียกใช้ "build"/"test"/etc ในภายหลังด้วยการกำหนดค่าที่แตกต่างกันอาจทำให้เป้าหมายของลิงก์สัญลักษณ์นี้เปลี่ยนแปลงไป ทำให้เส้นทางที่พิมพ์ก่อนหน้านี้ใช้ไม่ได้อีกต่อไป
แท็กaffects_outputs
--remote_print_execution_messages=<failure, success or all>
ค่าเริ่มต้น: "failure"-
เลือกเวลาที่จะพิมพ์ข้อความการดำเนินการจากระยะไกล ค่าที่ใช้ได้คือ `failure` เพื่อพิมพ์เฉพาะเมื่อเกิดข้อผิดพลาด `success` เพื่อพิมพ์เฉพาะเมื่อสำเร็จ และ `all` เพื่อพิมพ์เสมอ
แท็กterminal_output
--[no]test_verbose_timeout_warnings
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้พิมพ์คำเตือนเพิ่มเติมเมื่อเวลาดำเนินการทดสอบจริงไม่ตรงกับระยะหมดเวลาที่กำหนดโดยการทดสอบ (ไม่ว่าจะโดยนัยหรือโดยชัดแจ้ง)
แท็กaffects_outputs
--[no]verbose_test_summary
ค่าเริ่มต้น: "จริง"-
หากเป็นจริง ให้พิมพ์ข้อมูลเพิ่มเติม (เวลา จำนวนการเรียกใช้ที่ไม่สำเร็จ ฯลฯ) ในข้อมูลสรุปการทดสอบ
แท็ก:affects_outputs
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้อ่านไฟล์ที่ระบุซึ่งแก้ไขแล้วแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
--experimental_circuit_breaker_strategy=<failure>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุกลยุทธ์สำหรับเบรกเกอร์ที่จะใช้ กลยุทธ์ที่ใช้ได้คือ "failure" หากค่าของตัวเลือกไม่ถูกต้อง ลักษณะการทำงานจะเหมือนกับไม่ได้ตั้งค่าตัวเลือก
แท็กexecution
--experimental_downloader_config=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไฟล์เพื่อกำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สำหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ รูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้เป็น URL แทน โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณสามารถระบุคำสั่ง `rewrite` หลายรายการสำหรับ URL เดียวกันได้ และในกรณีนี้ ระบบจะแสดง URL หลายรายการ
--[no]experimental_guard_against_concurrent_changes
ค่าเริ่มต้น: "false"- ปิดตัวเลือกนี้เพื่อปิดใช้การตรวจสอบ ctime ของไฟล์อินพุตของการดำเนินการก่อนอัปโหลดไปยังแคชระยะไกล อาจมีกรณีที่เคอร์เนล Linux หน่วงเวลาการเขียนไฟล์ ซึ่งอาจทำให้เกิดผลบวกเท็จ
--experimental_remote_build_event_upload=<all or minimal>
ค่าเริ่มต้น: "all"- หากตั้งค่าเป็น "all" ระบบจะอัปโหลดเอาต์พุตในพื้นที่ทั้งหมดที่ BEP อ้างอิงไปยังแคชระยะไกล หากตั้งค่าเป็น "น้อยที่สุด" ระบบจะไม่ส่งเอาต์พุตในเครื่องที่ BEP อ้างอิงไปยังแคชระยะไกล ยกเว้นไฟล์ที่มีความสำคัญต่อผู้ใช้ BEP (เช่น บันทึกการทดสอบและโปรไฟล์เวลา) ระบบจะใช้รูปแบบ bytestream:// สำหรับ URI ของไฟล์เสมอแม้ว่าจะไม่มีไฟล์ในแคชระยะไกลก็ตาม ค่าเริ่มต้นคือ "ทั้งหมด"
--[no]experimental_remote_cache_async
ค่าเริ่มต้น: "false"- หากเป็นจริง I/O ของแคชระยะไกลจะเกิดขึ้นในเบื้องหลังแทนที่จะเป็นส่วนหนึ่งของการเกิด
--[no]experimental_remote_cache_compression
ค่าเริ่มต้น: "false"- หากเปิดใช้ ให้บีบอัด/คลายการบีบอัด Blob ของแคชด้วย zstd
--experimental_remote_capture_corrupted_outputs=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย- เส้นทางไปยังไดเรกทอรีที่จะบันทึกเอาต์พุตที่เสียหาย
--[no]experimental_remote_discard_merkle_trees
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น true ให้ทิ้งสำเนาในหน่วยความจำของต้นไม้ Merkle ของรูทอินพุตและการแมปอินพุตที่เชื่อมโยงระหว่างการเรียก GetActionResult() และ Execute() ซึ่งจะช่วยลดการใช้หน่วยความจำได้อย่างมาก แต่ต้องให้ Bazel คำนวณใหม่เมื่อแคชระยะไกลไม่พบและมีการลองใหม่
--experimental_remote_downloader=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- URI ของปลายทาง Remote Asset API ที่จะใช้เป็นพร็อกซีการดาวน์โหลดจากระยะไกล สคีมาที่รองรับคือ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ unix (ซ็อกเก็ต UNIX ในเครื่อง) หากไม่ได้ระบุสคีมา Bazel จะใช้ grpcs เป็นค่าเริ่มต้น ดูที่ https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
ค่าเริ่มต้น: "false"- ว่าจะกลับไปใช้โปรแกรมดาวน์โหลดในเครื่องหรือไม่หากโปรแกรมดาวน์โหลดระยะไกลล้มเหลว
--[no]experimental_remote_execution_keepalive
ค่าเริ่มต้น: "false"- ว่าจะใช้ 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.>
ค่าเริ่มต้น: "60s"-
ช่วงเวลาที่ใช้ในการคำนวณอัตราความล้มเหลวของคำขอระยะไกล หากค่าเป็น 0 หรือค่าลบ ระบบจะคำนวณระยะเวลาที่ล้มเหลวตลอดระยะเวลาการดำเนินการทั้งหมด คุณสามารถใช้หน่วยต่อไปนี้ได้ วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
แท็กexecution
--[no]experimental_remote_mark_tool_inputs
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" Bazel จะทำเครื่องหมายอินพุตเป็นอินพุตเครื่องมือสำหรับตัวดำเนินการระยะไกล ซึ่งใช้เพื่อติดตั้งใช้งานพนักงานแบบถาวรที่ทำงานจากระยะไกลได้
--[no]experimental_remote_merkle_tree_cache
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" ระบบจะบันทึกการคำนวณ Merkle Tree เพื่อปรับปรุงความเร็วในการตรวจสอบแคชระยะไกล ระบบจะควบคุมปริมาณหน่วยความจำของแคชโดยใช้ --experimental_remote_merkle_tree_cache_size
--experimental_remote_merkle_tree_cache_size=<a long integer>
ค่าเริ่มต้น: "1000"- จำนวนต้นไม้ Merkle ที่จะบันทึกเพื่อปรับปรุงความเร็วในการตรวจสอบการเข้าถึงแคชระยะไกล แม้ว่าระบบจะล้างแคชโดยอัตโนมัติตามการจัดการการอ้างอิงแบบอ่อนของ Java แต่ข้อผิดพลาดหน่วยความจำไม่เพียงพออาจเกิดขึ้นได้หากตั้งค่าสูงเกินไป หากตั้งค่าเป็น 0 ระบบจะไม่จำกัดขนาดแคช ค่าที่เหมาะสมจะแตกต่างกันไปตามขนาดของโปรเจ็กต์ ค่าเริ่มต้นคือ 1,000
--[no]experimental_remote_require_cached
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" ให้บังคับแคชการดำเนินการทั้งหมดที่เรียกใช้จากระยะไกลได้ หรือไม่เช่นนั้นให้สร้างไม่สำเร็จ ซึ่งจะเป็นประโยชน์ในการแก้ปัญหาเกี่ยวกับความไม่แน่นอน เนื่องจากช่วยให้ตรวจสอบได้ว่าการดำเนินการที่ควรแคชนั้นแคชจริงหรือไม่ โดยไม่ต้องแทรกผลลัพธ์ใหม่ที่ไม่เกี่ยวข้องลงในแคช
--[no]incompatible_remote_build_event_upload_respect_no_cache
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" ระบบจะไม่โหลดเอาต์พุตที่ BEP อ้างอิงไปยังแคชระยะไกลหากแคชการดำเนินการสร้างจากระยะไกลไม่ได้
--[no]incompatible_remote_downloader_send_all_headers
ค่าเริ่มต้น: "จริง"-
เลือกว่าจะส่งค่าทั้งหมดของส่วนหัวที่มีหลายค่าไปยังโปรแกรมดาวน์โหลดระยะไกลแทนที่จะส่งเฉพาะค่าแรกหรือไม่
แท็กincompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" เส้นทางเอาต์พุตจะสัมพันธ์กับรูทอินพุตแทนที่จะเป็นไดเรกทอรีการทำงาน
แท็กincompatible_change
--[no]incompatible_remote_results_ignore_disk
ค่าเริ่มต้น: "จริง"-
หากตั้งค่าเป็น "จริง" ระบบจะไม่ใช้ --noremote_upload_local_results และ --noremote_accept_cached กับแคชในดิสก์ หากใช้แคชแบบรวม
--noremote_upload_local_results จะทำให้ระบบเขียนผลลัพธ์ลงในแคชในดิสก์ แต่จะไม่ส่งไปยังแคชระยะไกล
--noremote_accept_cached จะทำให้ Bazel ตรวจสอบผลลัพธ์ในแคชในดิสก์ แต่ไม่ใช่ในแคชระยะไกล
การดำเนินการ no-remote-exec สามารถเข้าถึงแคชในดิสก์ได้
ดูรายละเอียดได้ที่ #8216
แท็กincompatible_change
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" Bazel จะใช้รหัสออกใหม่ 39 แทน 34 หากแคชระยะไกลลบออบเจ็กต์ BLOB ระหว่างการสร้าง
แท็กincompatible_change
--[no]remote_accept_cached
ค่าเริ่มต้น: "จริง"- เลือกว่าจะยอมรับผลลัพธ์ของการดำเนินการที่แคชไว้จากระยะไกลหรือไม่
--remote_bytestream_uri_prefix=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ชื่อโฮสต์และชื่ออินสแตนซ์ที่จะใช้ใน URI ของ bytestream:// ที่เขียนลงในสตรีมเหตุการณ์บิลด์ คุณตั้งค่าตัวเลือกนี้ได้เมื่อทำการบิลด์โดยใช้พร็อกซี ซึ่งจะทำให้ค่าของ --remote_executor และ --remote_instance_name ไม่สอดคล้องกับชื่อที่แน่นอนของบริการการดำเนินการจากระยะไกลอีกต่อไป หากไม่ได้ตั้งค่าไว้ ค่าเริ่มต้นจะเป็น "${hostname}/${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
--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_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 บันทึกนี้ประกอบด้วยลำดับของ protobuf com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry ที่ทำให้เป็นอนุกรม โดยแต่ละข้อความจะมีคำนำหน้าเป็น varint ที่ระบุขนาดของข้อความ protobuf ที่ทำให้เป็นอนุกรมต่อไปนี้ ตามที่ดำเนินการโดยเมธอด 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
ค่าเริ่มต้น: "false"- จะกลับไปใช้กลยุทธ์การดำเนินการในเครื่องแบบสแตนด์อโลนหรือไม่หากการดำเนินการจากระยะไกลล้มเหลว
--remote_local_fallback_strategy=<a string>
ค่าเริ่มต้น: "local"- ไม่มีการดำเนินการ เลิกใช้งานแล้ว ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7480
--remote_max_connections=<an integer>
ค่าเริ่มต้น: "100"-
จำกัดจำนวนการเชื่อมต่อพร้อมกันสูงสุดกับแคช/เครื่องมือดำเนินการระยะไกล โดยค่าเริ่มต้น ค่านี้จะเป็น 100 การตั้งค่านี้เป็น 0 หมายความว่าไม่มีข้อจำกัด
สำหรับแคชระยะไกล HTTP การเชื่อมต่อ TCP หนึ่งรายการจะจัดการคำขอได้ครั้งละ 1 รายการ ดังนั้น Bazel จึงสามารถส่งคำขอพร้อมกันได้สูงสุด --remote_max_connections
สำหรับแคช/ตัวดำเนินการระยะไกล gRPC โดยปกติแล้วแชแนล gRPC 1 รายการจะจัดการคำขอพร้อมกันได้มากกว่า 100 รายการ ดังนั้น Bazel จึงสามารถส่งคำขอพร้อมกันได้ประมาณ `--remote_max_connections * 100` รายการ
แท็กhost_machine_resource_optimizations
--remote_proxy=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- เชื่อมต่อกับแคชระยะไกลผ่านพร็อกซี ปัจจุบันนี้ คุณใช้แฟล็กนี้เพื่อกำหนดค่า Unix Domain Socket (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), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
--remote_timeout=<An immutable length of time.>
ค่าเริ่มต้น: "60s"- ระยะเวลารอสูงสุดสำหรับการเรียกการดำเนินการระยะไกลและการเรียกแคช สำหรับแคช REST นี่คือทั้งการเชื่อมต่อและการหมดเวลาในการอ่าน คุณใช้หน่วยต่อไปนี้ได้ วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
--[no]remote_upload_local_results
ค่าเริ่มต้น: "จริง"- ว่าจะอัปโหลดผลการดำเนินการที่เรียกใช้ในเครื่องไปยังแคชระยะไกลหรือไม่ หากแคชระยะไกลรองรับและผู้ใช้ได้รับอนุญาตให้ดำเนินการดังกล่าว
--[no]remote_verify_downloads
ค่าเริ่มต้น: "จริง"- หากตั้งค่าเป็น true Bazel จะคำนวณผลรวมแฮชของการดาวน์โหลดจากระยะไกลทั้งหมด และทิ้งค่าที่แคชจากระยะไกลหากไม่ตรงกับค่าที่คาดไว้
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้:
--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.>
มีการสะสมการใช้งานหลายครั้ง- กำหนดค่าโปรแกรมช่วยเหลือข้อมูลเข้าสู่ระบบที่จะใช้ในการดึงข้อมูลเข้าสู่ระบบการให้สิทธิ์สำหรับการดึงข้อมูลที่เก็บ การแคชและการดำเนินการระยะไกล และบริการเหตุการณ์การสร้าง ข้อมูลเข้าสู่ระบบที่ตัวช่วยระบุจะมีลำดับความสำคัญเหนือกว่าข้อมูลเข้าสู่ระบบที่ระบุโดย --google_default_credentials, --google_credentials, ไฟล์ .netrc หรือพารามิเตอร์การตรวจสอบสิทธิ์ไปยัง repository_ctx.download และ repository_ctx.download_and_extract ระบุได้หลายครั้งเพื่อตั้งค่าผู้ช่วยหลายราย ดูรายละเอียดได้ที่ https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md
--credential_helper_cache_duration=<An immutable length of time.>
ค่าเริ่มต้น: "30m"- ระยะเวลาที่ระบบจะแคชข้อมูลเข้าสู่ระบบที่ตัวช่วยข้อมูลเข้าสู่ระบบระบุ การเรียกใช้ด้วยค่าอื่นจะปรับอายุการใช้งานของรายการที่มีอยู่แล้ว ให้ส่งค่า 0 เพื่อล้างแคช คำสั่ง clean จะล้างแคชเสมอ ไม่ว่าจะมีแฟล็กนี้หรือไม่ก็ตาม
--credential_helper_timeout=<An immutable length of time.>
ค่าเริ่มต้น: "10s"- กำหนดค่าการหมดเวลาสำหรับโปรแกรมช่วยจัดการข้อมูลเข้าสู่ระบบ หากผู้ช่วยจัดการข้อมูลเข้าสู่ระบบไม่ตอบกลับภายในระยะหมดเวลานี้ การเรียกใช้จะล้มเหลว
--disk_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย- เส้นทางไปยังไดเรกทอรีที่ Bazel อ่านและเขียนการดำเนินการและเอาต์พุตของการดำเนินการได้ หากยังไม่มีไดเรกทอรี ระบบจะสร้างให้
--google_auth_scopes=<comma-separated list of options>
default: "https://www.googleapis.com/auth/cloud-platform"- รายการขอบเขตการตรวจสอบสิทธิ์ของ Google Cloud ที่คั่นด้วยคอมมา
--google_credentials=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไฟล์ที่จะรับข้อมูลเข้าสู่ระบบสำหรับการตรวจสอบสิทธิ์ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication
--[no]google_default_credentials
ค่าเริ่มต้น: "false"- ว่าจะใช้ "ข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชันของ Google" สำหรับการตรวจสอบสิทธิ์หรือไม่ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication ปิดใช้โดยค่าเริ่มต้น
--grpc_keepalive_time=<An immutable length of time.>
ค่าเริ่มต้น: ดูคำอธิบาย- กำหนดค่า Ping Keep-Alive สำหรับการเชื่อมต่อ gRPC ขาออก หากตั้งค่านี้ไว้ Bazel จะส่งการ Ping หลังจากไม่มีการดำเนินการอ่านในการเชื่อมต่อเป็นเวลานานเท่านี้ แต่จะส่งก็ต่อเมื่อมีการเรียก gRPC ที่รอดำเนินการอย่างน้อย 1 รายการ ระบบจะถือว่าเวลาเป็นหน่วยวินาที การตั้งค่าที่น้อยกว่า 1 วินาทีถือเป็นข้อผิดพลาด โดยค่าเริ่มต้น ระบบจะปิดใช้ Ping Keep-Alive คุณควรประสานงานกับเจ้าของบริการก่อนที่จะเปิดใช้การตั้งค่านี้ เช่น หากต้องการตั้งค่าเป็น 30 วินาที ให้ทำดังนี้ --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.>
ค่าเริ่มต้น: "20s"- กำหนดค่าการหมดเวลา Keep-Alive สำหรับการเชื่อมต่อ gRPC ขาออก หากเปิดใช้คำสั่ง ping keep-alive ด้วย --grpc_keepalive_time Bazel จะหมดเวลาการเชื่อมต่อหากไม่ได้รับการตอบกลับคำสั่ง ping หลังจากผ่านไประยะเวลาดังกล่าว ระบบจะถือว่าเวลาเป็นหน่วยวินาที การตั้งค่าที่น้อยกว่า 1 วินาทีถือเป็นข้อผิดพลาด หากปิดใช้ Ping Keep-Alive ระบบจะไม่สนใจการตั้งค่านี้
--override_repository=<an equals-separated mapping of repository name to path>
มีการสะสมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--tls_certificate=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุเส้นทางไปยังใบรับรอง TLS ที่เชื่อถือได้ในการลงนามใบรับรองเซิร์ฟเวอร์
--tls_client_certificate=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุใบรับรองไคลเอ็นต์ TLS ที่จะใช้ คุณต้องระบุคีย์ไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
--tls_client_key=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุคีย์ไคลเอ็นต์ TLS ที่จะใช้ คุณต้องระบุใบรับรองไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
ตัวเลือกเวอร์ชัน
- ตัวเลือกที่ปรากฏก่อนคำสั่งและไคลเอ็นต์แยกวิเคราะห์
--distdir=<a path>
มีการสะสมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาไฟล์เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บจะลิงก์แบบฮาร์ดลิงก์ไฟล์ในกรณีที่แคชตรงกันแทนที่จะคัดลอก ซึ่งมีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็กbazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL เปลี่ยนแปลงและส่งผลให้มีการดาวน์โหลดซ้ำแม้ว่าแคชจะมีรายการที่ดาวน์โหลดซึ่งมีแฮชเดียวกันก็ตาม ซึ่งใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL ไม่ได้ทำให้ที่เก็บข้อมูลเสียหายซึ่งถูกแคชซ่อนไว้
แท็ก:loading_and_analysis
,experimental
--[no]experimental_repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ จะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็กexperimental
--experimental_repository_downloader_retries=<an integer>
ค่าเริ่มต้น: "0"-
จำนวนครั้งสูงสุดที่พยายามลองดาวน์โหลดซ้ำเมื่อเกิดข้อผิดพลาด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็กexperimental
--experimental_scale_timeouts=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับขนาดการหมดเวลาทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ ด้วยวิธีนี้ คุณจึงทำให้ที่เก็บข้อมูลภายนอกทำงานในเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็กbazel_internal_configuration
,experimental
--http_timeout_scaling=<a double>
ค่าเริ่มต้น: "1.0"-
ปรับการหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลดผ่าน http ตามปัจจัยที่ระบุ
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
ค่าเริ่มต้น: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้มาในระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ช่วยให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการ ซึ่งจะส่งผลต่อค่าของเอาต์พุตนั้นๆ แทนที่จะส่งผลต่อการมีอยู่ของเอาต์พุต
--[no]gnu_format
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ให้เขียนเวอร์ชันไปยัง stdout โดยใช้รูปแบบที่อธิบายไว้ในมาตรฐาน GNU
แท็ก:affects_outputs
,execution
- ตัวเลือกที่มีผลต่อความเข้มงวดของ Bazel ในการบังคับใช้ข้อมูลอินพุตการบิลด์ที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าสถานะ ฯลฯ)
--experimental_repository_hash_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรมีการยืนยันแฮชของไดเรกทอรีที่เก็บเทียบกับค่านี้
แท็ก:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
มีการสะสมการใช้งานหลายครั้ง-
หากมีรายการกฎที่เก็บที่ควรมีการยืนยันแฮชของไดเรกทอรีเอาต์พุต โดยระบุไฟล์ด้วย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้มีผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ในไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE:
--[no]experimental_allow_top_level_aspects_parameters
ค่าเริ่มต้น: "จริง"-
ไม่มีการดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะได้รับอนุญาตในกราฟการอ้างอิงที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่าถูกยกเลิกในรีจิสทรีที่โมดูลมาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น เวอร์ชันที่ถูกเพิกถอนจะทำให้การแก้ไขล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันที่อนุญาตให้ยกเลิกได้ด้วยตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็กloading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ `error` เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาที่ไม่สำเร็จ, `off` เพื่อปิดใช้การตรวจสอบ หรือ `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน
แท็กloading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าการอ้างอิง `bazel_dep` โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้ว ค่าที่ใช้ได้คือ `off` เพื่อปิดใช้การตรวจสอบ, `warning` เพื่อพิมพ์คำเตือนเมื่อตรวจพบความไม่ตรงกัน หรือ `error` เพื่อส่งต่อเป็นความล้มเหลวในการแก้ไข
แท็กloading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นการขึ้นต่อกันของนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท ไม่ว่าค่าของแฟล็กนี้จะเป็นอะไรก็ตาม
แท็กloading_and_analysis
--lockfile_mode=<off, update or error>
ค่าเริ่มต้น: "ปิด"-
ระบุวิธีและจะใช้หรือไม่ใช้ไฟล์ล็อก ค่าที่ใช้ได้คือ `update` เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง, `error` เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่อัปเดต หรือ `off` เพื่อไม่ให้อ่านหรือเขียนไปยังไฟล์ล็อก
แท็กloading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
มีการสะสมการใช้งานหลายครั้ง- แทนที่โมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
--registry=<a string>
มีการสะสมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้เพื่อค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับมีความสำคัญ โดยระบบจะค้นหาโมดูลในรีจิสทรีที่อยู่ก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีที่อยู่ถัดไปก็ต่อเมื่อไม่มีโมดูลในรีจิสทรีที่อยู่ก่อนหน้า
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อความละเอียด รูปแบบ หรือตำแหน่งของการบันทึก:
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น ระบบจะจำกัดจำนวนประเภทการดำเนินการไว้ที่ 20 นิโมนิกที่มีจำนวนการดำเนินการที่ดำเนินการแล้วมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับทุกคำช่วยจำ
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปในคำสั่ง Bazel ซึ่งไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่าง ให้อ่านไฟล์ที่ระบุซึ่งแก้ไขแล้วแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
--experimental_downloader_config=<a string>
ค่าเริ่มต้น: ดูคำอธิบาย- ระบุไฟล์เพื่อกำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สำหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ รูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้เป็น URL แทน โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณสามารถระบุคำสั่ง `rewrite` หลายรายการสำหรับ URL เดียวกันได้ และในกรณีนี้ ระบบจะแสดง URL หลายรายการ
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้:
--override_repository=<an equals-separated mapping of repository name to path>
มีการสะสมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่ระบุ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ เส้นทางนั้นจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุเริ่มต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ `bazel info workspace`
แท็กเอฟเฟกต์ตัวเลือก
unknown |
ตัวเลือกนี้มีผลที่ไม่รู้จักหรือไม่ได้รับการบันทึก |
no_op |
ตัวเลือกนี้จะไม่มีผลใดๆ |
loses_incremental_state |
การเปลี่ยนค่าของตัวเลือกนี้อาจทำให้สถานะที่เพิ่มขึ้นสูญหายอย่างมาก ซึ่งจะทำให้การสร้างช้าลง สถานะอาจหายไปเนื่องจากการรีสตาร์ทเซิร์ฟเวอร์หรือการล้างข้อมูลส่วนใหญ่ของกราฟการอ้างอิง |
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 |
ตัวเลือกนี้จะเปลี่ยนสภาพแวดล้อม Testrunner ของบิลด์ |
แท็กข้อมูลเมตาของตัวเลือก
experimental |
ตัวเลือกนี้จะเรียกใช้ฟีเจอร์ทดลองโดยไม่มีการรับประกันฟังก์ชันการทำงาน |
incompatible_change |
ตัวเลือกนี้จะทําให้เกิดการเปลี่ยนแปลงที่ไม่รองรับ ใช้ตัวเลือกนี้เพื่อทดสอบความพร้อมในการย้ายข้อมูลหรือรับสิทธิ์ทดลองใช้ฟีเจอร์ใหม่ก่อนเปิดตัว |
deprecated |
ตัวเลือกนี้เลิกใช้งานแล้ว อาจเป็นเพราะฟีเจอร์ที่ได้รับผลกระทบถูกเลิกใช้งานแล้ว หรือเราต้องการให้คุณใช้วิธีอื่นในการระบุข้อมูล |
explicit_in_output_path |
ตัวเลือกนี้จะระบุไว้อย่างชัดเจนในไดเรกทอรีเอาต์พุต |