bazel [<startup options>] <command> [<args>]
bazel [<startup options>] <command> [<args>] -- [<target patterns>]
ไวยากรณ์ตัวเลือก
ส่งผ่านตัวเลือกไปยัง Bazel ได้หลายวิธี ตัวเลือกที่ต้องมีค่า อาจส่งด้วยเครื่องหมายเท่ากับหรือเว้นวรรคก็ได้ ดังนี้
--<option>=<value> --<option> <value>
-<short_form> <value>
ตัวเลือกบูลีนสามารถเปิดใช้ได้ดังนี้
--<option> --<option>=[true|yes|1]
--no<option> --<option>=[false|no|0]
โดยปกติตัวเลือก Tristate จะตั้งไว้เป็นแบบอัตโนมัติโดยค่าเริ่มต้น และสามารถ ดังนี้
--<option>=[true|yes|1]
--no<option> --<option>=[false|no|0]
คำสั่ง
analyze-profile |
วิเคราะห์ข้อมูลโปรไฟล์ของบิลด์ |
aquery |
วิเคราะห์เป้าหมายที่ระบุและค้นหากราฟการกระทำ |
build |
สร้างเป้าหมายที่ระบุ |
canonicalize-flags |
การกำหนดรายการตัวเลือก Canonical เป็น Canonical |
clean |
นำไฟล์เอาต์พุตออกและเลือกหยุดเซิร์ฟเวอร์หรือไม่ก็ได้ |
coverage |
สร้างรายงานการครอบคลุมของโค้ดสำหรับเป้าหมายทดสอบที่ระบุ |
cquery |
โหลด วิเคราะห์ และค้นหาเป้าหมายที่ระบุพร้อมการกำหนดค่า |
dump |
ดัมพ์สถานะภายในของกระบวนการของเซิร์ฟเวอร์ bazel |
fetch |
ดึงข้อมูลที่เก็บภายนอกที่จำเป็นเบื้องต้นไปยังเป้าหมาย |
help |
ความช่วยเหลือเกี่ยวกับการพิมพ์สำหรับคำสั่งหรือดัชนี |
info |
แสดงข้อมูลรันไทม์เกี่ยวกับเซิร์ฟเวอร์ bazel |
license |
พิมพ์ใบอนุญาตของซอฟต์แวร์นี้ |
mobile-install |
เป้าหมายการติดตั้งไปยังอุปกรณ์เคลื่อนที่ |
mod |
ค้นหากราฟทรัพยากร Dependency ภายนอกของ Bzlmod |
print_action |
พิมพ์อาร์กิวเมนต์บรรทัดคำสั่งเพื่อคอมไพล์ไฟล์ |
query |
ดำเนินการค้นหากราฟทรัพยากร Dependency |
run |
เรียกใช้เป้าหมายที่ระบุ |
shutdown |
หยุดเซิร์ฟเวอร์ bazel |
sync |
ซิงค์ที่เก็บทั้งหมดที่ระบุไว้ในไฟล์พื้นที่ทำงาน |
test |
สร้างและเรียกใช้เป้าหมายทดสอบที่ระบุ |
version |
พิมพ์ข้อมูลเวอร์ชันสำหรับ Bazel |
ตัวเลือกการเริ่มทำงาน
- ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
- ค่าเริ่มต้น
--[no]autodetect_server_javabase
: "true" -
เมื่อมีการส่ง --noautodetect_server_javabase แล้ว Bazel จะไม่ถอยกลับไปยัง JDK ในเครื่องเพื่อเรียกใช้เซิร์ฟเวอร์ bazel และออกแทน
แท็ก:affects_outputs
loses_incremental_state
- ค่าเริ่มต้น
--[no]batch
: "เท็จ" -
หากตั้งค่าไว้ Bazel จะทำงานเป็นกระบวนการของไคลเอ็นต์โดยไม่มีเซิร์ฟเวอร์ แทนที่จะเป็นโหมดไคลเอ็นต์/เซิร์ฟเวอร์มาตรฐาน คำสั่งนี้เลิกใช้งานแล้วและจะถูกนำออก โปรดปิดเซิร์ฟเวอร์อย่างชัดเจนหากต้องการหลีกเลี่ยงไม่ให้เซิร์ฟเวอร์ค้าง
แท็ก:loses_incremental_state
,bazel_internal_configuration
,deprecated
- ค่าเริ่มต้น
--[no]batch_cpu_scheduling
: "เท็จ" -
เฉพาะใน Linux ใช้ "กลุ่ม" การตั้งเวลา CPU สำหรับ Blaze นโยบายนี้มีประโยชน์สำหรับภาระงานที่ไม่ใช่แบบอินเทอร์แอกทีฟ แต่ไม่ต้องการลดคุณค่าที่แท้จริง ดู "man 2 sched_setscheduler" หากเป็น "เท็จ" Bazel จะไม่เรียกใช้ระบบ
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้น
--bazelrc=<path>
: ดูคำอธิบาย -
ตำแหน่งของไฟล์ .bazelrc ของผู้ใช้ที่มีค่าเริ่มต้นของตัวเลือก Bazel /dev/null ระบุว่าระบบจะไม่สนใจ "--bazelrc" ทั้งหมดหลังจากนั้น ซึ่งมีประโยชน์ในการปิดใช้การค้นหาไฟล์ rc ของผู้ใช้ เช่น ในบิลด์ที่เผยแพร่
ตัวเลือกนี้สามารถระบุได้หลายครั้ง
เช่น โดย `--bazelrc=x.rc --bazelrc=y.rc --bazelrc=/dev/null --bazelrc=z.rc`,
1) อ่าน x.rc และ y.rc
2) ระบบไม่พิจารณา z.rc เนื่องจาก /dev/null ก่อนหน้านี้
หากไม่ระบุ Bazel จะใช้ไฟล์ .bazelrc ไฟล์แรกที่พบใน 2 ตำแหน่งต่อไปนี้ ได้แก่ ไดเรกทอรีพื้นที่ทำงาน และไดเรกทอรีหลักของผู้ใช้
หมายเหตุ: ตัวเลือกบรรทัดคำสั่งจะมีผลแทนตัวเลือกใดๆ ใน bazelrc เสมอ
แท็ก:changes_inputs
- ค่าเริ่มต้น
--[no]block_for_lock
: "true" -
เมื่อ --noblock_for_lock ผ่านแล้ว Bazel จะไม่รอให้คำสั่งที่ทำงานอยู่เสร็จสมบูรณ์ แต่จะออกในทันทีแทน
แท็ก:eagerness_to_exit
- ค่าเริ่มต้น
--[no]client_debug
: "เท็จ" -
หากเป็นจริง ให้บันทึกข้อมูลการแก้ไขข้อบกพร่องจากไคลเอ็นต์ไปยัง stderr การเปลี่ยนตัวเลือกนี้จะไม่ทำให้เซิร์ฟเวอร์ต้องรีสตาร์ท
แท็ก:affects_outputs
bazel_monitoring
- ค่าเริ่มต้น
--connect_timeout_secs=<an integer>
: "30" -
ระยะเวลาที่ไคลเอ็นต์รอการเชื่อมต่อเซิร์ฟเวอร์ในแต่ละครั้ง
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]expand_configs_in_place
: "true" -
เปลี่ยนการขยายแฟล็ก --config ที่จะทำในตำแหน่ง ต่างจากการขยายจุดคงที่ระหว่างตัวเลือก rc ปกติและตัวเลือกที่ระบุบรรทัดคำสั่ง
แท็ก:no_op
deprecated
- ค่าเริ่มต้น
--failure_detail_out=<path>
: ดูคำอธิบาย -
ถ้ามีการตั้งค่า ให้ระบุตำแหน่งที่จะเขียนข้อความ protocolbuf ของการทำงานล้มเหลว หากเซิร์ฟเวอร์ประสบกับความล้มเหลวและไม่สามารถรายงานผ่าน gRPC ได้ตามปกติ ไม่เช่นนั้น สถานที่จะเป็น ${OUTPUT_BASE}/failure_detail.rawprotocol
แท็ก:affects_outputs
loses_incremental_state
- ค่าเริ่มต้น
--[no]home_rc
: "true" -
ค้นหาไฟล์ bazelrc ของบ้านที่ $HOME/.bazelrc หรือไม่
แท็ก:changes_inputs
- ค่าเริ่มต้น
--[no]idle_server_tasks
: "true" -
เรียกใช้ System.gc() เมื่อเซิร์ฟเวอร์ไม่มีการใช้งาน
แท็ก:loses_incremental_state
,host_machine_resource_optimizations
- ค่าเริ่มต้น
--[no]ignore_all_rc_files
: "เท็จ" -
ปิดใช้ไฟล์ rc ทั้งหมด โดยไม่คำนึงถึงค่าของแฟล็กการแก้ไข rc อื่นๆ แม้ว่าแฟล็กเหล่านี้จะอยู่ภายหลังในรายการตัวเลือกการเริ่มต้นใช้งานก็ตาม
แท็ก:changes_inputs
- ค่าเริ่มต้น
--io_nice_level={-1,0,1,2,3,4,5,6,7}
: "-1" -
เฉพาะใน Linux ตั้งระดับตั้งแต่ 0-7 เพื่อการกำหนดเวลา IO ที่ใช้ความพยายามมากที่สุดโดยใช้การเรียกระบบ sys_ioprio_set 0 คือลำดับความสำคัญสูงสุด 7 คือต่ำสุด เครื่องจัดตารางเวลาที่คาดไว้จะใช้ได้ไม่เกิน 4 ลำดับความสำคัญ หากตั้งเป็นค่าลบ Bazel จะไม่เรียกใช้ระบบ
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้น
--local_startup_timeout_secs=<an integer>
: "120" -
ระยะเวลาสูงสุดที่ไคลเอ็นต์ต้องรอเพื่อเชื่อมต่อกับเซิร์ฟเวอร์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--macos_qos_class=<a string>
: "ค่าเริ่มต้น" -
ตั้งค่าคลาสบริการ QoS ของเซิร์ฟเวอร์ bazel เมื่อใช้งานใน macOS แฟล็กนี้ไม่มีผลกับแพลตฟอร์มอื่นๆ ทั้งหมด แต่รองรับเพื่อให้แชร์ไฟล์ rc ระหว่างแพลตฟอร์มได้โดยไม่มีการเปลี่ยนแปลง ค่าที่เป็นไปได้ ได้แก่ โฆษณาแบบอินเทอร์แอกทีฟ ผู้ใช้ที่เริ่มต้นเอง ค่าเริ่มต้น ยูทิลิตี และพื้นหลัง
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--max_idle_secs=<integer>
: "10800" -
จำนวนวินาทีที่เซิร์ฟเวอร์บิลด์จะรอให้ไม่มีการใช้งานก่อนปิดการทำงาน ค่า 0 หมายความว่าเซิร์ฟเวอร์จะไม่ปิดการทำงาน ซึ่งจะอ่านเมื่อเริ่มต้นเซิร์ฟเวอร์เท่านั้น การเปลี่ยนแปลงตัวเลือกนี้จะไม่ทำให้เซิร์ฟเวอร์รีสตาร์ท
แท็ก:eagerness_to_exit
loses_incremental_state
- ค่าเริ่มต้น
--output_base=<path>
: ดูคำอธิบาย -
หากมีการตั้งค่าแล้ว ให้ระบุตำแหน่งเอาต์พุตที่ระบบจะเขียนเอาต์พุตของบิลด์ทั้งหมด มิเช่นนั้น สถานที่จะเป็น ${OUTPUT_ROOT}/_blaze_${USER}/${MD5_OF_WORKSPACE_ROOT} หมายเหตุ: หากคุณระบุตัวเลือกที่แตกต่างจากการเรียกใช้ Bazel ถัดไปสำหรับค่านี้ คุณอาจต้องเริ่มต้นเซิร์ฟเวอร์ Bazel ใหม่เพิ่มเติม Bazel เริ่มต้นเพียง 1 เซิร์ฟเวอร์ต่อฐานเอาต์พุตที่ระบุ โดยปกติจะมีฐานเอาต์พุต 1 รายการต่อพื้นที่ทำงาน แต่ด้วยตัวเลือกนี้ คุณอาจมีฐานเอาต์พุตหลายรายการต่อพื้นที่ทำงาน ดังนั้นจึงเรียกใช้บิลด์หลายรายการสำหรับไคลเอ็นต์เดียวกันในเครื่องเดียวกันพร้อมกัน ดู "ปิดตัวช่วยเหลือด้วย Bazel" เกี่ยวกับวิธีปิดเซิร์ฟเวอร์ Bazel
แท็ก:affects_outputs
loses_incremental_state
- ค่าเริ่มต้น
--output_user_root=<path>
: ดูคำอธิบาย -
ไดเรกทอรีเฉพาะผู้ใช้ด้านล่างที่มีการเขียนเอาต์พุตของบิลด์ทั้งหมด โดยค่าเริ่มต้น นี่เป็นฟังก์ชันของ $USER แต่เมื่อระบุเอาต์พุตของบิลด์แล้ว จะสามารถแชร์เอาต์พุตของบิลด์ระหว่างผู้ใช้ที่ทํางานร่วมกันได้
แท็ก:affects_outputs
loses_incremental_state
- ค่าเริ่มต้น
--[no]preemptible
: "เท็จ" -
หากเป็น "จริง" คำสั่งนี้อาจถูกขัดจังหวะชั่วคราวหากมีการเริ่มต้นคำสั่งอื่น
แท็ก:eagerness_to_exit
- ค่าเริ่มต้น
--server_jvm_out=<path>
: ดูคำอธิบาย -
ตำแหน่งที่จะเขียนเอาต์พุตของ JVM ของเซิร์ฟเวอร์ หากไม่ได้ตั้งค่า จะมีค่าเริ่มต้นเป็นตำแหน่งใน exit_base
แท็ก:affects_outputs
loses_incremental_state
- ค่าเริ่มต้น
--[no]shutdown_on_low_sys_mem
: "เท็จ" -
หากตั้งค่า max_idle_secs และเซิร์ฟเวอร์บิลด์ไม่มีการใช้งานเป็นระยะเวลาหนึ่ง ให้ปิดเซิร์ฟเวอร์เมื่อระบบเหลือ RAM ต่ำ Linux เท่านั้น
แท็ก:eagerness_to_exit
loses_incremental_state
- ค่าเริ่มต้น
--[no]system_rc
: "true" -
ต้องการมองหา bazelrc ทั้งระบบหรือไม่
แท็ก:changes_inputs
- ค่าเริ่มต้น
--[no]unlimit_coredumps
: "เท็จ" -
เพิ่มขีดจำกัด Soft Coredump ให้ถึงขีดจำกัดแบบฮาร์ดคอร์เพื่อสร้าง Coredump ของเซิร์ฟเวอร์ (รวมถึง JVM) และไคลเอ็นต์เป็นไปได้ภายใต้เงื่อนไขทั่วไป ติด Flag นี้ไว้ใน bazelrc 1 ครั้ง แล้วลืมติดแฟล็กนั้น เพื่อให้คุณได้รับ Coredumps เมื่อพบเงื่อนไขที่ทริกเกอร์ Coredump จริงๆ
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]watchfs
: "เท็จ" -
หากเป็น "จริง" bazel จะพยายามใช้บริการดูไฟล์ของระบบปฏิบัติการสำหรับการเปลี่ยนแปลงในเครื่องแทนการสแกนทุกไฟล์เพื่อหาการเปลี่ยนแปลง
แท็ก:deprecated
- ค่าเริ่มต้น
--[no]windows_enable_symlinks
: "เท็จ" -
หากจริง ระบบจะสร้างลิงก์สัญลักษณ์จริงบน Windows แทนการคัดลอกไฟล์ ต้องเปิดใช้โหมดนักพัฒนาซอฟต์แวร์ Windows และ Windows 10 เวอร์ชัน 1703 ขึ้นไป
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]workspace_rc
: "true" -
มองหาไฟล์ Workspace bazelrc ที่ $workspace/.bazelrc หรือไม่
แท็ก:changes_inputs
- ตัวเลือกเบ็ดเตล็ด ที่จัดหมวดหมู่ไว้ไม่ได้:
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_jvm_args=<jvm_arg>
รายการ - แฟล็กที่จะส่งไปยัง Blaze ที่เรียกใช้ JVM
--host_jvm_debug
-
ตัวเลือกความสะดวกในการเพิ่ม Flag การเริ่มต้นของ JVM เพิ่มเติม ซึ่งจะทำให้ JVM ต้องรอในระหว่างการเริ่มต้นจนกว่าคุณจะเชื่อมต่อจากโปรแกรมแก้ไขข้อบกพร่องที่สอดคล้องกับ JDWP (เช่น Eclipse) ไปยังพอร์ต 5005
ขยายเป็น
--host_jvm_args=-Xdebug
--host_jvm_args=-Xrunjdwp:transport=dt_socket,server=y,address=5005
- ค่าเริ่มต้นของ
--host_jvm_profile=<profiler_name>
: "" - ตัวเลือกความสะดวกในการเพิ่ม Flag การเริ่มต้น JVM เฉพาะสำหรับเครื่องมือสร้างโปรไฟล์/โปรแกรมแก้ไขข้อบกพร่อง Bazel มีรายการค่าที่รู้จักซึ่งแมปกับแฟล็กการเริ่มต้น JVM แบบฮาร์ดโค้ด ซึ่งอาจค้นหาเส้นทางแบบฮาร์ดโค้ดสำหรับไฟล์บางไฟล์
- ค่าเริ่มต้นของ
--server_javabase=<jvm path>
: "" - เส้นทางไปยัง JVM ที่ใช้เพื่อดำเนินการ Bazel เอง
ตัวเลือกเหมือนกับคำสั่งทั้งหมด
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์:
- ค่าเริ่มต้น
--experimental_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
- ตัวเลือกที่ให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการได้ โดยให้ส่งผลต่อค่าของเอาต์พุตแทนค่าที่มีอยู่
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--repo_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุตัวแปรสภาพแวดล้อมเพิ่มเติมเพื่อให้ใช้ได้กับกฎที่เก็บเท่านั้น โปรดทราบว่ากฎที่เก็บจะดูสภาพแวดล้อมแบบเต็มได้ แต่ด้วยวิธีนี้ระบบจะส่งข้อมูลการกำหนดค่าไปยังที่เก็บผ่านตัวเลือกต่างๆ ได้โดยที่กราฟการดำเนินการจะไม่ถูกต้อง
แท็ก:action_command_lines
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตบิลด์ที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมธง ฯลฯ)
- ค่าเริ่มต้น
--[no]check_bzl_visibility
: "true" -
หากปิดใช้ ระบบจะลดระดับข้อผิดพลาดในการแสดงการโหลด .bzl ให้มีคำเตือน
แท็ก:build_file_semantics
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]enable_bzlmod
: "เท็จ" -
หากเป็น "จริง" จะเปิดใช้ระบบการจัดการทรัพยากร Dependency ของ Bzlmod โดยมีผลเหนือกว่า WORKSPACE ดูข้อมูลเพิ่มเติมได้ที่ https://bazel.build/docs/bzlmod
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_action_resource_set
: "true" -
หากตั้งค่าเป็น "จริง" ctx.actions.run() และ ctx.actions.run_shell() จะยอมรับพารามิเตอร์ resource_set สำหรับการดำเนินการในเครื่อง มิเช่นนั้น หน่วยความจำจะเริ่มต้นที่ 250 MB สำหรับหน่วยความจำและ 1 CPU
แท็ก:execution
,build_file_semantics
,experimental
-
หากตั้งค่าเป็น "จริง" แท็กจะส่งผ่านจากเป้าหมายไปยังการดำเนินการ ข้อกำหนดในการดำเนินการ มิฉะนั้นแท็กจะไม่ถูกเผยแพร่ ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/8830
แท็ก:build_file_semantics
experimental
- ค่าเริ่มต้น
--[no]experimental_analysis_test_call
: "true" -
หากตั้งค่าเป็น "จริง" การเรียกใช้แบบเนทีฟ Analysis_test จะพร้อมใช้งาน
แท็ก:loading_and_analysis
,build_file_semantics
,experimental
- ค่าเริ่มต้น
--[no]experimental_bzl_visibility
: "true" -
หากเปิดใช้ ให้เพิ่มฟังก์ชัน "visibility()" ที่ไฟล์ .bzl อาจเรียกใช้ในระหว่างการประเมินระดับบนสุดเพื่อตั้งค่าการแสดงผลไว้ตามวัตถุประสงค์ของคำสั่ง remove()
แท็ก:loading_and_analysis
experimental
-
หากตั้งค่าเป็น "จริง" แอตทริบิวต์กฎและเมธอด Starlark API ที่จำเป็นสำหรับกฎ cc_shared_library จะพร้อมใช้งาน
แท็ก:build_file_semantics
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_disable_external_package
: "เท็จ" -
หากตั้งค่าเป็น "จริง" แพ็กเกจ //ภายนอกที่สร้างขึ้นโดยอัตโนมัติจะใช้งานไม่ได้อีกต่อไป Bazel จะยังคงแยกวิเคราะห์ไฟล์ "external/BUILD" ไม่ได้ แต่ globs ที่เข้าถึงภายนอก/ จากแพ็กเกจที่ไม่มีชื่อจะใช้งานได้
แท็ก:loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]experimental_enable_android_migration_apis
: "เท็จ" -
หากตั้งค่าเป็น "จริง" จะเปิดใช้ API ที่ต้องใช้เพื่อรองรับการย้ายข้อมูลของ Android Starlark
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]experimental_get_fixed_configured_action_env
: "เท็จ" -
หากเปิดใช้ action.env จะแสดงผลตัวแปรสภาพแวดล้อมคงที่ที่ระบุผ่านการกำหนดค่าฟีเจอร์ด้วย
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--[no]experimental_google_legacy_api
: "เท็จ" -
หากตั้งค่าเป็น "จริง" จะแสดงส่วนทดลองของ Starlark Build API ที่เกี่ยวข้องกับโค้ดเดิมของ Google
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--[no]experimental_lazy_template_expansion
: "true" -
หากตั้งค่าเป็น "จริง" ctx.actions.expand_template() จะยอมรับพารามิเตอร์ TemplateDict สำหรับการประเมินค่าทดแทนที่มีการเลื่อนเวลา
แท็ก:execution
,build_file_semantics
,experimental
- ค่าเริ่มต้น
--[no]experimental_platforms_api
: "เท็จ" -
หากตั้งค่าเป็น "จริง" จะเปิดใช้ Starlark API ที่เกี่ยวข้องกับแพลตฟอร์มจำนวนหนึ่งซึ่งมีประโยชน์สำหรับการแก้ไขข้อบกพร่อง
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--[no]experimental_repo_remote_exec
: "เท็จ" -
หากตั้งค่าเป็น "จริง" Reposit_rule จะมีความสามารถในการดำเนินการระยะไกลบางรายการ
แท็ก:build_file_semantics
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_sibling_repository_layout
: "เท็จ" -
หากตั้งค่าเป็น "จริง" ระบบจะสร้างที่เก็บที่ไม่ใช่หลักเป็นลิงก์สัญลักษณ์ไปยังที่เก็บหลักในรูทการดำเนินการ กล่าวคือ ที่เก็บทั้งหมดจะเป็นรายการย่อยโดยตรงของไดเรกทอรี $output_base/execution_root การดำเนินการนี้มีผลข้างเคียงจากการเพิ่มพื้นที่ว่าง $output_base/execution_root/__main__/external สำหรับ "ภายนอก" ระดับบนสุดจริง ไดเรกทอรี
แท็ก:action_command_lines
,bazel_internal_configuration
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]incompatible_always_check_depset_elements
: "true" -
ตรวจสอบความถูกต้องขององค์ประกอบที่เพิ่มลงในชุดย่อยในตัวสร้างทั้งหมด องค์ประกอบต้องเปลี่ยนแปลงไม่ได้ แต่ที่ผ่านมาเครื่องมือสร้าง depset(direct=...) ลืมตรวจสอบ ใช้ Tuples แทนรายการในองค์ประกอบ Depset ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/10313
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_depset_for_libraries_to_link_getter
: "true" -
เมื่อเป็น "จริง" Bazel จะไม่แสดงรายการจาก linked_context.libraries_to_link อีกต่อไป แต่จะแสดงผลการตั้งค่าแทน
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disable_starlark_host_transitions
: "เท็จ" -
หากตั้งค่าเป็น "จริง" แอตทริบิวต์กฎจะตั้งค่า 'cfg = "host"' ไม่ได้ กฎควรตั้งค่า 'cfg = "exec"' แทน
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disable_target_provider_fields
: "เท็จ" -
หากตั้งค่าเป็น "จริง" ให้ปิดความสามารถในการเข้าถึงผู้ให้บริการใน "เป้าหมาย" ผ่านไวยากรณ์ฟิลด์ ใช้ไวยากรณ์คีย์ผู้ให้บริการแทน เช่น แทนที่จะใช้ "ctx.attr.dep.my_info" เพื่อเข้าถึง "my_info" จากภายในฟังก์ชันการใช้งานกฎ ให้ใช้ "ctx.attr.dep[MyInfo]" แทน ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/9014
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disallow_empty_glob
: "เท็จ" -
หากตั้งค่าเป็น "จริง" ค่าเริ่มต้นของอาร์กิวเมนต์ `allow_empty` ของ glob() จะเป็น False
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disallow_legacy_javainfo
: "true" -
เลิกใช้งานแล้ว ไม่มีการดำเนินการ
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disallow_struct_provider_syntax
: "เท็จ" -
หากตั้งค่าเป็น "จริง" ฟังก์ชันการใช้งานกฎอาจไม่แสดงโครงสร้าง โดยจะต้องแสดงผลรายการอินสแตนซ์ของผู้ให้บริการแทน
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_existing_rules_immutable_view
: "true" -
หากตั้งค่าเป็น "จริง" Native.existing_rule และnative.existing_rules จะแสดงออบเจ็กต์มุมมองที่เปลี่ยนแปลงไม่ได้ขนาดเล็กแทนคำสั่งที่เปลี่ยนแปลงได้
แท็ก:build_file_semantics
,loading_and_analysis
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_fix_package_group_reporoot_syntax
: "true" -
ในแอตทริบิวต์ "packages" ของPackage_group ให้เปลี่ยนความหมายของค่า "//..." เพื่ออ้างถึงแพ็กเกจทั้งหมดในที่เก็บปัจจุบัน แทนที่จะเป็นแพ็กเกจทั้งหมดในที่เก็บใดๆ คุณสามารถใช้ค่าพิเศษ "สาธารณะ" แทน "//..." เพื่อรับลักษณะการทำงานเดิม ธงนี้กำหนดให้ต้องเปิดใช้งาน --incompatible_package_group_has_public_syntax ด้วย
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_java_common_parameters
: "true" -
หากตั้งค่าเป็น "จริง" พารามิเตอร์เอาต์พุต_jar และ host_javabase ใน pack_sources และ host_javabase ในคอมไพล์จะถูกนำออกทั้งหมด
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_new_actions_api
: "true" -
หากตั้งค่าเป็น "จริง" API เพื่อสร้างการดำเนินการจะพร้อมใช้งานใน "ctx.actions" เท่านั้น ไม่ใช่ใน "ctx"
แท็ก:build_file_semantics
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_no_attr_license
: "true" -
หากตั้งค่าเป็น "จริง" จะเป็นการปิดใช้ฟังก์ชัน "attr.license"
แท็ก:build_file_semantics
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_no_implicit_file_export
: "เท็จ" -
หากตั้งค่าไว้ ไฟล์ต้นฉบับ (ที่ใช้แล้ว) จะเป็นแพ็กเกจส่วนตัวเว้นแต่จะมีการส่งออกอย่างชัดเจน ดู https://github.com/bazelbuild/proposals/blob/master/designs/2019-10-24-file-visibility.md
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_no_rule_outputs_param
: "เท็จ" -
หากตั้งค่าเป็น "จริง" จะปิดใช้พารามิเตอร์ "เอาต์พุต" ของฟังก์ชัน "rule()" Starlark
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_package_group_has_public_syntax
: "true" -
ในแอตทริบิวต์ "packages" ของแพ็กเกจ [package_group] อนุญาตให้เขียน "สาธารณะ" หรือ "ส่วนตัว" อ้างอิงถึงแพ็กเกจทั้งหมดหรือไม่มีแพ็กเกจตามลำดับ
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_require_linker_input_cc_api
: "true" -
หากตั้งค่าเป็น "จริง" กฎ create_linking_context จะต้องใช้ linker_inputs แทน library_to_link ระบบจะปิดเครื่องมือดึงข้อมูลเก่าของ linker_context ด้วย แล้วระบบก็จะมีเพียง linker_inputs เท่านั้นที่ใช้ได้
แท็ก:build_file_semantics
,loading_and_analysis
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_run_shell_command_string
: "true" -
หากตั้งค่าเป็น "จริง" พารามิเตอร์คำสั่งของ actions.run_shell จะยอมรับเฉพาะสตริงเท่านั้น
แท็ก:build_file_semantics
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_stop_exporting_language_modules
: "เท็จ" -
หากเปิดใช้ โมดูลเฉพาะภาษาบางโมดูล (เช่น "cc_common") จะไม่พร้อมใช้งานในไฟล์ .bzl ของผู้ใช้ และอาจเรียกใช้จากที่เก็บกฎที่เกี่ยวข้องเท่านั้น
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_struct_has_no_methods
: "เท็จ" -
ปิดใช้เมธอด to_json และ to_เลือก ของโครงสร้าง ซึ่งทำให้เนมสเปซของช่อง Struct เสีย โปรดใช้ json.encode หรือ json.encode_indent สำหรับ JSON หรือใช้ protocol.encode_text สําหรับ textprotocol แทน
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_top_level_aspects_require_providers
: "เท็จ" -
หากตั้งค่าเป็น "จริง" การแสดงผลระดับบนสุดจะยึดตามผู้ให้บริการที่จำเป็นและจะทำงานในเป้าหมายระดับบนสุดที่มีกฎเท่านั้น ผู้ให้บริการที่โฆษณาตรงตามผู้ให้บริการในด้านดังกล่าว
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_unambiguous_label_stringification
: "true" -
เมื่อเป็นจริง Bazel จะเพิ่มป้ายกำกับ @//foo:bar เป็น @//foo:bar แทน //foo:bar การเลือกนี้จะส่งผลต่อลักษณะการทำงานของ str(), โอเปอเรเตอร์ % และอื่นๆ เท่านั้น ลักษณะการทำงานของ repr() จะไม่มีการเปลี่ยนแปลง ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/15916
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_use_cc_configure_from_rules_cc
: "เท็จ" -
เมื่อเป็นจริง Bazel จะไม่อนุญาตให้ใช้ cc_configure จาก @bazel_tools อีกต่อไป โปรดดูรายละเอียดและวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/10134
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_visibility_private_attributes_at_definition
: "เท็จ" -
หากตั้งค่าเป็น "จริง" ระบบจะตรวจสอบการแสดงผลของแอตทริบิวต์กฎส่วนตัวตามคำจำกัดความของกฎ ไม่ใช่การใช้กฎ
แท็ก: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
: "true" -
เมื่อเป็นจริง Bazel จะไม่แก้ไขแฟล็กบรรทัดคำสั่งที่ใช้ในการลิงก์อีกต่อไป และจะไม่เลือกว่าแฟล็กใดจะส่งไปยังไฟล์พารามิเตอร์และจะไม่ใช้ ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7670
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]keep_state_after_build
: "true" -
หากเป็น "เท็จ" Blaze จะทิ้งสถานะ Inmemory จากบิลด์นี้เมื่อบิลด์เสร็จสมบูรณ์ การสร้างครั้งต่อๆ ไปจะไม่มีส่วนเพิ่มที่เกี่ยวข้องกับเวอร์ชันนี้
แท็ก:loses_incremental_state
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
ตั้งค่าสถานะสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้ฮีปที่เก็บรักษาไว้ถึงเกณฑ์นี้เป็นอย่างน้อย ก็จะทิ้งสถานะ Skyframe ชั่วคราวโดยไม่จำเป็น การปรับแต่งนี้อาจช่วยลดผลกระทบจากเวลาจริงของการ Thrash
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้น
--[no]track_incremental_state
: "true" -
หากเป็น "เท็จ" Blaze จะไม่เก็บข้อมูลที่ทำให้ใช้งานไม่ได้และมีการประเมินซ้ำในบิลด์ที่เพิ่มขึ้นเพื่อประหยัดหน่วยความจำในบิลด์นี้ การสร้างครั้งต่อๆ ไปจะไม่มีส่วนเพิ่มที่เกี่ยวข้องกับเวอร์ชันนี้ โดยปกติแล้วคุณจะต้องระบุ --batch เมื่อตั้งค่าเป็น false
แท็ก:loses_incremental_state
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
- ค่าเริ่มต้น
--[no]announce_rc
: "เท็จ" -
เลือกว่าจะประกาศตัวเลือก rc หรือไม่
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]attempt_to_print_relative_paths
: "เท็จ" -
เมื่อพิมพ์ส่วนที่เป็นตำแหน่งของข้อความ ให้พยายามใช้เส้นทางที่สัมพันธ์กับไดเรกทอรีของพื้นที่ทำงานหรือหนึ่งในไดเรกทอรีที่ระบุโดย --package_path
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--bes_backend=<a string>
: "" -
ระบุปลายทางแบ็กเอนด์ของบริการบิลด์ (BES) ในรูปแบบ [SCHEME://]HOST[:PORT] ค่าเริ่มต้นคือปิดใช้งานการอัปโหลด BES รูปแบบที่รองรับคือ grpc และ grpcs (grpc ที่เปิดใช้ TLS) หากไม่ได้ระบุรูปแบบไว้ Bazel จะถือว่า grpcs
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]bes_check_preceding_lifecycle_events
: "เท็จ" -
ตั้งค่าช่อง check_preceding_lifecycle_events_present ใน PublishBuildToolEventStreamRequest ซึ่งจะบอกให้ BES ตรวจสอบว่าก่อนหน้านี้ได้รับเหตุการณ์ InvocationAttemptStarted และ BuildEnqueued ที่ตรงกับเหตุการณ์เครื่องมือปัจจุบันหรือไม่
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--bes_header=<a 'name=value' assignment>
รายการ -
ระบุส่วนหัวในแบบฟอร์ม NAME=VALUE ที่จะรวมอยู่ในคำขอ BES สามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
แท็ก:affects_outputs
- ค่าเริ่มต้น
--bes_instance_name=<a string>
: ดูคำอธิบาย -
ระบุชื่ออินสแตนซ์ที่ BES จะคง BEP ที่อัปโหลดไว้ ค่าเริ่มต้นคือ Null
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--bes_keywords=<comma-separated list of options>
รายการ -
ระบุรายการคีย์เวิร์ดสำหรับการแจ้งเตือนเพื่อเพิ่มชุดคีย์เวิร์ดเริ่มต้นที่เผยแพร่ใน BES ("command_name=<command_name> ", "protocol_name=BEP") ค่าเริ่มต้นคือไม่มี
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]bes_lifecycle_events
: "true" -
ระบุว่าจะเผยแพร่เหตุการณ์ในวงจรของ BES หรือไม่ (มีค่าเริ่มต้นเป็น "จริง")
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--bes_oom_finish_upload_timeout=<An immutable length of time.>
: "10m" -
ระบุระยะเวลาที่ควรรอให้การอัปโหลด BES/BEP เสร็จสมบูรณ์ขณะทำ OOMing แฟล็กนี้ทำให้แน่ใจได้ถึงการสิ้นสุดเมื่อ JVM เกิดการขว้าง GC อย่างรุนแรง และไม่สามารถดำเนินการต่างๆ ในเทรดผู้ใช้ใดๆ ได้
แท็ก:bazel_monitoring
- ค่าเริ่มต้นของ
--bes_outerr_buffer_size=<an integer>
: "10240" -
ระบุขนาดสูงสุดของ Stdout หรือ stderr ที่จะบัฟเฟอร์ใน BEP ก่อนที่จะรายงานเป็นเหตุการณ์ความคืบหน้า การเขียนแต่ละรายการจะยังคงได้รับการรายงานในเหตุการณ์เดียว แม้ว่าจะมากกว่าค่าที่ระบุสูงสุดถึง --bes_outerr_chunk_size ก็ตาม
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--bes_outerr_chunk_size=<an integer>
: "1048576" -
ระบุขนาดสูงสุดของ stdout หรือ stderr ที่จะส่งไปยัง BEP ในข้อความเดียว
แท็ก:affects_outputs
- ค่าเริ่มต้น
--bes_proxy=<a string>
: ดูคำอธิบาย - เชื่อมต่อบริการ Build Event ผ่านพร็อกซี ปัจจุบัน Flag นี้สามารถใช้เพื่อกำหนดค่า Socket ของโดเมน Unix (unix:/path/to/socket) เท่านั้น
- ค่าเริ่มต้นของ
--bes_results_url=<a string>
: "" -
ระบุ URL พื้นฐานที่ผู้ใช้สามารถดูข้อมูลที่สตรีมไปยังแบ็กเอนด์ BES Bazel จะแสดง URL ต่อท้ายด้วยรหัสการเรียกใช้ไปยังเทอร์มินัล
แท็ก:terminal_output
- ค่าเริ่มต้น
--bes_timeout=<An immutable length of time.>
: "0s" -
ระบุระยะเวลาที่ควรรอให้การอัปโหลด 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
: "true" -
แปลงเส้นทางในการนำเสนอไฟล์ไบนารีของโปรโตคอลกิจกรรมบิลด์เป็น URI ที่ใช้ได้ทั่วโลกมากขึ้นเมื่อเป็นไปได้ หากปิดใช้ ระบบจะใช้รูปแบบ file:// uri เสมอ
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--build_event_json_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้เขียนการเรียงลำดับ JSON ของโปรโตคอลเหตุการณ์บิลด์ไปยังไฟล์นั้น
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]build_event_json_file_path_conversion
: "true" -
แปลงเส้นทางในไฟล์ JSON ของโปรโตคอลเหตุการณ์บิลด์ให้เป็น URI ที่ถูกต้องทั่วโลกมากขึ้นเมื่อเป็นไปได้ หากปิดใช้ ระบบจะใช้รูปแบบ file:// uri เสมอ
แท็ก:affects_outputs
- ค่าเริ่มต้น
--build_event_max_named_set_of_file_entries=<an integer>
: "-1" -
จํานวนรายการสูงสุดสําหรับเหตุการณ์เดียวที่ชื่อ_set_of_files ระบบจะไม่สนใจค่าที่น้อยกว่า 2 และไม่มีการแยกเหตุการณ์ ตัวเลือกนี้มีไว้เพื่อจำกัดขนาดเหตุการณ์สูงสุดในโปรโตคอลเหตุการณ์บิลด์ แม้ว่าจะไม่ได้ควบคุมขนาดของเหตุการณ์โดยตรง ขนาดกิจกรรมรวมเป็นฟังก์ชันของโครงสร้างของชุด ตลอดจนความยาวของไฟล์และ URI ซึ่งอาจขึ้นอยู่กับฟังก์ชันแฮช
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]build_event_publish_all_actions
: "เท็จ" -
ควรเผยแพร่การดำเนินการทั้งหมดไหม
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--build_event_text_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้เขียนการนำเสนอโปรโตคอลเหตุการณ์บิลด์ไปยังไฟล์นั้น
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]build_event_text_file_path_conversion
: "true" -
แปลงเส้นทางในไฟล์ข้อความของโปรโตคอลเหตุการณ์บิลด์เป็น URI ที่ใช้ได้ทั่วโลกมากขึ้นเมื่อเป็นไปได้ หากปิดใช้ ระบบจะใช้รูปแบบ file:// uri เสมอ
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_announce_profile_path
: "เท็จ" -
หากเปิดใช้ ให้เพิ่มเส้นทางโปรไฟล์ JSON ลงในบันทึก
แท็ก:affects_outputs
bazel_monitoring
- ค่าเริ่มต้น
--[no]experimental_bep_target_summary
: "เท็จ" - ต้องการเผยแพร่เหตุการณ์ TargetSummary หรือไม่
- ค่าเริ่มต้น
--[no]experimental_build_event_expand_filesets
: "เท็จ" -
หากเป็น "จริง" ให้ขยายชุดไฟล์ใน BEP เมื่อนำเสนอไฟล์เอาต์พุต
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: "เท็จ" -
หากเป็น "จริง" ให้แปลค่าลิงก์สัญลักษณ์ของ Fileset สัมพัทธ์ทั้งหมดใน BEP เมื่อนำเสนอไฟล์เอาต์พุต ต้องมี --experimental_build_event_expand_filesset
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_build_event_upload_max_retries=<an integer>
: "4" -
จำนวนครั้งสูงสุดที่ Bazel ควรลองอัปโหลดเหตุการณ์บิลด์อีกครั้ง
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1s" -
เริ่มแรก ความล่าช้าขั้นต่ำสำหรับการลองใหม่แบบ Exponential Backoff เมื่ออัปโหลด BEP ไม่สำเร็จ (เลขชี้กำลัง: 1.6)
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--experimental_build_event_upload_strategy=<a string>
: ดูคำอธิบาย -
เลือกวิธีอัปโหลดอาร์ติแฟกต์ที่อ้างอิงในโปรโตคอลเหตุการณ์บิลด์
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_profile_additional_tasks=<phase, action, action_check, action_lock, action_release, action_update, action_complete, 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
: "เท็จ" -
รวมค่า "ออก" เพิ่มเติม ในเหตุการณ์การดำเนินการที่มีเส้นทางปฏิบัติการไปยังเอาต์พุตหลักของการดำเนินการ
แท็ก:affects_outputs
bazel_monitoring
- ค่าเริ่มต้น
--[no]experimental_profile_include_target_label
: "เท็จ" -
รวมป้ายกำกับเป้าหมายในเหตุการณ์การดำเนินการ ข้อมูลโปรไฟล์ JSON
แท็ก:affects_outputs
bazel_monitoring
- ค่าเริ่มต้น
--[no]experimental_stream_log_file_uploads
: "เท็จ" -
สตรีมไฟล์บันทึกจะอัปโหลดไปยังพื้นที่เก็บข้อมูลระยะไกลโดยตรงแทนการเขียนลงดิสก์
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_workspace_rules_log_file=<a path>
: ดูคำอธิบาย - บันทึกเหตุการณ์บางอย่างของกฎ Workspace ลงในไฟล์นี้เป็นโปรโตคอล WorkspaceEvent ที่คั่นด้วยเครื่องหมาย
- ค่าเริ่มต้น
--[no]generate_json_trace_profile
: "อัตโนมัติ" -
หากเปิดใช้ Bazel จะโปรไฟล์บิลด์และเขียนโปรไฟล์รูปแบบ JSON ลงในไฟล์ในฐานเอาต์พุต ดูโปรไฟล์โดยการโหลดลงใน chrome://tracing โดยค่าเริ่มต้น Bazel จะเขียนโปรไฟล์สำหรับคำสั่งและคำค้นหาที่เหมือนกับบิลด์ทั้งหมด
แท็ก:affects_outputs
bazel_monitoring
- ค่าเริ่มต้น
--[no]heap_dump_on_oom
: "เท็จ" -
เลือกว่าจะแสดงฮีปดัมป์ด้วยตนเองหรือไม่หากมีการส่ง OOM (รวมถึง OOM เนื่องจาก --experimental_oom_more_eagerly_threshold) ระบบจะเขียน Dump ไปยัง <output_base>/<invocation_id>.heapdump.hprof ตัวเลือกนี้มาแทนที่ -XX:+HeapDumpOnOutOfMemoryError อย่างมีประสิทธิภาพ ซึ่งจะไม่มีผลเนื่องจาก OOM ถูกตรวจจับและเปลี่ยนเส้นทางไปยัง Runtime#halt
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--[no]legacy_important_outputs
: "true" -
ใช้อาร์กิวเมนต์นี้เพื่อระงับการสร้างช่อง legal_outputs เดิมในเหตุการณ์ TargetComplete ต้องใช้ required_outputs สำหรับการผสานรวม Bazel กับ ResultStore
แท็ก:affects_outputs
- ค่าเริ่มต้น
--logging=<0 <= an integer <= 6>
: "3" -
ระดับการบันทึก
แท็ก:affects_outputs
- ค่าเริ่มต้น
--memory_profile=<a path>
: ดูคำอธิบาย -
หากตั้งค่า ให้เขียนข้อมูลการใช้งานหน่วยความจำไปยังไฟล์ที่ระบุเมื่อเฟสสิ้นสุดและฮีปที่เสถียรในบันทึกหลักเมื่อสิ้นสุดบิลด์
แท็ก:affects_outputs
bazel_monitoring
- ค่าเริ่มต้น
--memory_profile_stable_heap_parameters=<integers, separated by a comma expected in pairs>
: "1,0" -
ปรับการคำนวณฮีปที่เสถียรของโปรไฟล์หน่วยความจำที่ส่วนท้ายของบิลด์ ควรเป็นจํานวนเต็มและจำนวนคู่คั่นด้วยคอมมา ในแต่ละคู่ จำนวนเต็มแรกคือจำนวน GC ที่จะดำเนินการ จำนวนเต็มที่สองในแต่ละคู่คือจำนวนวินาทีที่จะรอระหว่าง GC ตัวอย่างเช่น 2,4,4,0 จะ GC 2 รายการที่มีการหยุดชั่วคราว 4 วินาที ตามด้วย 4 GC ที่มีการหยุดชั่วคราว 0 วินาที
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--profile=<a path>
: ดูคำอธิบาย -
หากมีการตั้งค่า ให้สร้างโปรไฟล์ Bazel และเขียนข้อมูลไปยังไฟล์ที่ระบุ ใช้โปรไฟล์การวิเคราะห์ bazel เพื่อวิเคราะห์โปรไฟล์
แท็ก:affects_outputs
bazel_monitoring
- ค่าเริ่มต้น
--[no]slim_profile
: "true" -
ลดขนาดของโปรไฟล์ 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>
: "อัตโนมัติ" - ใช้ตัวควบคุมเทอร์มินัลเพื่อกำหนดสีเอาต์พุต
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--config=<a string>
รายการ - เลือกส่วนการกำหนดค่าเพิ่มเติมจากไฟล์ rc สำหรับทุก <command> จะมีการดึงตัวเลือกจาก <command>:<config> หากมีส่วนดังกล่าว หากไม่มีส่วนนี้ในไฟล์ .rc ระบบจะดำเนินการ Blaze ไม่สำเร็จโดยมีข้อผิดพลาด ส่วนการกำหนดค่าและชุด Flag ต่างๆ ที่เนื้อหาเหล่านี้จะเทียบเท่ากันจะอยู่ในไฟล์การกำหนดค่า Tools/*.blazerc
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
รายการ - กำหนดค่าตัวช่วยข้อมูลเข้าสู่ระบบเพื่อใช้สำหรับเรียกข้อมูลข้อมูลเข้าสู่ระบบการให้สิทธิ์สำหรับการดึงข้อมูลที่เก็บ การแคชและการดำเนินการจากระยะไกล และบริการเหตุการณ์ของบิลด์ ข้อมูลเข้าสู่ระบบที่ผู้ช่วยให้ไว้จะมีความสำคัญเหนือกว่าข้อมูลเข้าสู่ระบบที่จัดหาโดย --google_default_credentials, --google_credentials, ไฟล์ .netrc หรือพารามิเตอร์การตรวจสอบสิทธิ์ไปยัง identifier_ctx.download และ sample_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 เพื่อล้างแคช คำสั่งล้างจะล้างแคชเสมอ โดยไม่คำนึงถึงแฟล็กนี้
- ค่าเริ่มต้น
--credential_helper_timeout=<An immutable length of time.>
: "10 วินาที" - กำหนดค่าการหมดเวลาสำหรับตัวช่วยข้อมูลเข้าสู่ระบบ ตัวช่วยข้อมูลเข้าสู่ระบบที่ไม่ตอบกลับภายในระยะหมดเวลานี้จะเรียกใช้ไม่สําเร็จ
- ค่าเริ่มต้น
--curses=<yes, no or auto>
: "อัตโนมัติ" - ใช้การควบคุมเคอร์เซอร์เทอร์มินัลเพื่อลดขนาดเอาต์พุตแบบเลื่อน
- ค่าเริ่มต้น
--[no]enable_platform_specific_config
: "เท็จ" - หากเป็นจริง Bazel จะใช้บรรทัดการกำหนดค่าเฉพาะโฮสต์ของระบบปฏิบัติการจากไฟล์ bazelrc ตัวอย่างเช่น หากระบบปฏิบัติการของโฮสต์คือ Linux และคุณเรียกใช้บิลด์ของ Bazel เบราว์เซอร์ Bazel จะดึงข้อมูลบรรทัดที่เริ่มต้นด้วย Builder:linux ตัวระบุระบบปฏิบัติการที่รองรับ ได้แก่ Linux, Macos, Windows, Freebsd และ openbsd การเปิดใช้งานการตั้งค่าสถานะนี้เทียบเท่ากับการใช้ --config=linux ใน Linux, --config=windows ใน Windows ฯลฯ
- ค่าเริ่มต้น
--[no]experimental_skymeld_ui
: "เท็จ" -
แสดงทั้งการวิเคราะห์และความคืบหน้าของระยะการดำเนินการเมื่อทั้ง 2 ระยะทำงานพร้อมกัน
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]experimental_windows_watchfs
: "เท็จ" - หากเป็นจริง จะมีการเปิดใช้งานการสนับสนุน Windows รุ่นทดลองสำหรับ --watchfs มิฉะนั้น --watchfsis จะเป็นแบบไม่ดำเนินการบน Windows โปรดตรวจสอบว่าได้เปิดใช้งาน --watchfs ด้วย
- ค่าเริ่มต้น
--google_auth_scopes=<comma-separated list of options>
: "https://www.googleapis.com/auth/cloud-platform" - รายการขอบเขตการตรวจสอบสิทธิ์ Google Cloud ที่คั่นด้วยคอมมา
- ค่าเริ่มต้น
--google_credentials=<a string>
: ดูคำอธิบาย - ระบุไฟล์ที่จะรับข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication
- ค่าเริ่มต้น
--[no]google_default_credentials
: "เท็จ" - จะใช้ "ข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชันของ Google" หรือไม่ เพื่อตรวจสอบสิทธิ์ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication ปิดใช้โดยค่าเริ่มต้น
- ค่าเริ่มต้น
--grpc_keepalive_time=<An immutable length of time.>
: ดูคำอธิบาย - กำหนดค่าคำสั่ง ping แบบ Keep-alive สำหรับการเชื่อมต่อ gRPC ขาออก หากตั้งค่าไว้ Bazel จะส่งคำสั่ง ping หลังจากไม่มีการดำเนินการอ่านในการเชื่อมต่อเป็นเวลานาน แต่เฉพาะเมื่อมีการเรียกใช้ gRPC ที่รอดำเนินการอย่างน้อย 1 ครั้ง เวลาจะถือว่าเป็นรายละเอียดที่ 2 การตั้งค่าน้อยกว่า 1 วินาทีเป็นข้อผิดพลาด โดยค่าเริ่มต้น ระบบจะปิดใช้คําสั่ง ping ของ Keep-alive ไว้ คุณควรประสานงานกับเจ้าของบริการก่อนเปิดใช้การตั้งค่านี้ ตัวอย่างเช่น หากต้องการกำหนดค่า 30 วินาทีให้กับแฟล็กนี้ ก็ควรทำแบบนี้ --grpc_keepalive_time=30s
- ค่าเริ่มต้นของ
--grpc_keepalive_timeout=<An immutable length of time.>
: "20 วินาที" - กำหนดค่าระยะหมดเวลาแบบ Keep-alive สำหรับการเชื่อมต่อ gRPC ขาออก หากเปิดใช้งานคําสั่ง ping ตลอดเวลาด้วย --grpc_keepalive_time แล้ว Bazel จะหมดเวลาการเชื่อมต่อหากไม่ได้รับคําสั่ง ping หลังจากผ่านไประยะหนึ่ง เวลาจะถือว่าเป็นรายละเอียดที่ 2 การตั้งค่าน้อยกว่า 1 วินาทีเป็นข้อผิดพลาด หากปิดการใช้คําสั่ง ping ของ Keep-alive การตั้งค่านี้จะไม่มีผล
- ค่าเริ่มต้น
--[no]incompatible_disallow_symlink_file_to_dir
: "true" -
หากตั้งค่าเป็น "จริง" "ctx.actions.symlink" จะไม่อนุญาตให้ลิงก์สัญลักษณ์ไฟล์ไปยังไดเรกทอรี
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_remove_rule_name_parameter
: "true" -
หากตั้งค่าเป็น "จริง" คุณจะเรียกใช้ "กฎ" ด้วยพารามิเตอร์ "ชื่อ" ไม่ได้
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]progress_in_terminal_title
: "เท็จ" - แสดงความคืบหน้าของคำสั่งในชื่อเทอร์มินัล มีประโยชน์ในการดูว่า bazel กำลังทำอะไรเมื่อมีแท็บเทอร์มินัลหลายแท็บ
- ค่าเริ่มต้น
--[no]show_progress
: "true" - แสดงข้อความความคืบหน้าระหว่างบิลด์
- ค่าเริ่มต้น
--show_progress_rate_limit=<a double>
: "0.2" - จำนวนวินาทีขั้นต่ำระหว่างข้อความแสดงความคืบหน้าในเอาต์พุต
- ค่าเริ่มต้น
--[no]show_timestamps
: "เท็จ" - ใส่การประทับเวลาในข้อความ
- ค่าเริ่มต้น
--tls_certificate=<a string>
: ดูคำอธิบาย - ระบุเส้นทางไปยังใบรับรอง TLS ที่เชื่อถือให้ลงนามใบรับรองเซิร์ฟเวอร์
- ค่าเริ่มต้น
--tls_client_certificate=<a string>
: ดูคำอธิบาย - ระบุใบรับรองไคลเอ็นต์ TLS ที่จะใช้ คุณต้องระบุคีย์ไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
- ค่าเริ่มต้น
--tls_client_key=<a string>
: ดูคำอธิบาย - ระบุคีย์ไคลเอ็นต์ TLS ที่จะใช้ คุณจะต้องระบุใบรับรองไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์
- ค่าเริ่มต้น
--ui_actions_shown=<an integer>
: "8" -
จำนวนการดำเนินการที่เกิดขึ้นพร้อมกันซึ่งแสดงในแถบความคืบหน้าโดยละเอียด การดำเนินการแต่ละรายการจะแสดงแยกบรรทัดกัน แถบความคืบหน้าจะแสดงอย่างน้อย 1 รายการเสมอ และตัวเลขทั้งหมดที่น้อยกว่า 1 จะจับคู่กับ 1
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]watchfs
: "เท็จ" - ใน Linux/macOS: หากเป็น "จริง" bazel จะพยายามใช้บริการเฝ้าดูไฟล์ของระบบปฏิบัติการสำหรับการเปลี่ยนแปลงในเครื่องแทนการสแกนทุกไฟล์เพื่อหาการเปลี่ยนแปลง ใน Windows: ปัจจุบันแฟล็กนี้เป็นแบบ non-op แต่สามารถเปิดใช้ร่วมกับ --experimental_windows_watchfs ในทุกระบบปฏิบัติการ: ไม่มีการกำหนดลักษณะการทำงานหากพื้นที่ทำงานอยู่ในระบบไฟล์เครือข่าย และมีการแก้ไขไฟล์ในเครื่องระยะไกล
ตัวเลือกการวิเคราะห์
- ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชของที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่เกิดแคชแทนที่จะคัดลอก ซึ่งช่วยประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุไว้ ซึ่งจะทำให้การเปลี่ยนแปลง URL ส่งผลให้มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม สามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ทำให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--[no]experimental_repository_disable_download
: "เท็จ" -
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก: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 หรือ API บิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
ไม่มีการดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันโมดูลในรูปแบบ "<module1>@<version1>,<module2>@<version2>" ซึ่งจะได้รับอนุญาตในกราฟทรัพยากร Dependency ที่ได้รับการแก้ไขแล้ว แม้ว่าจะมีการประกาศเวอร์ชันในรีจิสทรีในที่มาของเวอร์ชัน (หากไม่ได้มาจาก NonRegistryOverride) มิเช่นนั้น เวอร์ชันที่แยกออกมาจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันแยกที่อนุญาตด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" ได้ด้วย คุณสามารถปิดการตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้กับเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" ที่ส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" ให้พิมพ์คำเตือนเมื่อตรวจพบข้อมูลที่ไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟทรัพยากร Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" ให้พิมพ์คำเตือนเมื่อตรวจพบข้อมูลไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อยกระดับการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะไม่สนใจทรัพยากร Dependency สำหรับนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูทไม่ว่าค่าของแฟล็กนี้จะเป็นอะไร
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--lockfile_mode=<off, update or error>
: "อัปเดต" -
ระบุวิธีและวิธีใช้ล็อกไฟล์ ค่าที่ถูกต้องคือ "อัปเดต" เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง "ข้อผิดพลาด" ในการใช้ไฟล์ล็อกแต่เกิดข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" ไม่อ่านหรือเขียนไปยังไฟล์ล็อก
แท็ก:loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--override_module=<an equals-separated mapping of module name to path>
รายการ - ลบล้างโมดูลด้วยเส้นทางภายในในรูปแบบ <module name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์ ระบบจะใช้เส้นทางตามที่เป็น ถ้าเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพัทธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางดังกล่าวจะสัมพัทธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--registry=<a string>
รายการ -
ระบุรีจิสทรีที่จะใช้ในการค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับเป็นสิ่งสำคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีในภายหลังเมื่อไม่มีรีจิสทรีที่ขาดหายไป
แท็ก:changes_inputs
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
- ค่าเริ่มต้น
--dump=<text or raw>
[-d
]: ดูรายละเอียด -
ส่งดัมพ์ของข้อมูลโปรไฟล์แบบเต็มใน "ข้อความ" ที่มนุษย์อ่านได้ "ข้อมูลดิบ" ที่เหมาะกับรูปแบบหรือสคริปต์
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_record_metrics_for_all_mnemonics
: "เท็จ" - โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจำกัดอยู่ที่ 20 รายการที่มีการกระทำมากที่สุด การตั้งค่าตัวเลือกนี้จะเป็นการเขียนสถิติสำหรับการช่วยจำทั้งหมด
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ค่าเริ่มต้นของ
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
หากไม่ว่างเปล่า ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
- ค่าเริ่มต้น
--experimental_downloader_config=<a string>
: ดูคำอธิบาย - ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด แต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือสองรูปแบบ รูปแบบหนึ่งจะจับคู่กัน และอีกรูปแบบหนึ่งใช้เป็น URL ทดแทน โดยมีการอ้างอิงกลับเริ่มตั้งแต่ "$1" เป็นไปได้ที่จะมีการใช้คำสั่ง "rewrite" หลายคำสั่งสำหรับ URL เดียวกัน และในกรณีนี้ระบบจะส่งคืน URL หลายรายการ
- ตัวเลือกเบ็ดเตล็ด ที่ยังไม่ได้รับการแยกประเภท:
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์ ระบบจะใช้เส้นทางตามที่เป็น ถ้าเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพัทธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางดังกล่าวจะสัมพัทธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"
ตัวเลือกคำค้นหา
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชของที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่เกิดแคชแทนที่จะคัดลอก ซึ่งช่วยประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุไว้ ซึ่งจะทำให้การเปลี่ยนแปลง URL ส่งผลให้มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม สามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ทำให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--[no]experimental_repository_disable_download
: "เท็จ" -
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก: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 หรือ API บิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
ไม่มีการดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตการค้นหาและความหมาย:
- ค่าเริ่มต้น
--aspect_deps=<off, conservative or precise>
: "เชิงรับ" -
วิธีแก้ไขทรัพยากร Dependency ของลักษณะเมื่อรูปแบบเอาต์พุตเป็นหนึ่งใน {xml,protocol,record} "off" หมายความว่าจะไม่มีการแก้ไขทรัพยากร Dependency ในด้านต่างๆ "เชิงรับ" (ค่าเริ่มต้น) หมายความว่าจะมีการเพิ่มทรัพยากร Dependency ที่ประกาศทั้งหมด ไม่ว่าทรัพยากรเหล่านั้นจะได้รับคลาสของกฎการขึ้นต่อกันโดยตรงหรือไม่ ซึ่งก็คือ "แม่นยำ" หมายความว่าจะมีการเพิ่มเฉพาะด้านที่อาจทำงานอยู่ตามคลาสกฎของทรัพยากร Dependency โดยตรง โปรดทราบว่าโหมดแม่นยำต้องมีการโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียว ซึ่งจะทำให้ช้ากว่าโหมดอื่นๆ และโปรดทราบด้วยว่า โหมดแม้กระทั่งที่แม่นยำก็ไม่ได้แม่นยำทั้งหมด การตัดสินใจว่าจะคำนวณด้านใดด้านหนึ่งหรือไม่จะทำในขั้นตอนการวิเคราะห์ ซึ่งจะไม่ทำงานระหว่าง "การค้นหาแบบงัดแงะ"
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]deduplicate_depsets
: "true" -
นำรายการย่อยที่ไม่ใช่ Leaf ที่ซ้ำกันของ dep_set_of_files ออกในเอาต์พุต protocol/textprotocol/json สุดท้าย การดำเนินการนี้จะไม่ลบชุดย่อยที่ซ้ำกันซึ่งไม่ได้มีกลุ่มระดับบนเหมือนกัน การดำเนินการนี้จะไม่ส่งผลต่อรายการอาร์ติแฟกต์อินพุตที่มีประสิทธิภาพสุดท้ายของการดำเนินการ
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]graph:factored
: "true" -
หากเป็น "จริง" กราฟจะแสดงผลแบบ "แยกตัวประกอบ" นั่นคือ โหนดที่เท่าเทียมกันทางโทโพโลจีจะผสานเข้าด้วยกันและป้ายกำกับของโหนดทั้งสองเชื่อมติดกัน ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้น
--graph:node_limit=<an integer>
: "512" -
ความยาวสูงสุดของสตริงป้ายกำกับสำหรับโหนดกราฟในเอาต์พุต ป้ายกำกับที่ยาวขึ้นจะถูกตัด -1 หมายถึงไม่มีการตัดข้อความ ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]implicit_deps
: "true" -
หากเปิดใช้ การขึ้นต่อกันโดยปริยายจะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ทรัพยากร Dependency โดยนัยคือทรัพยากรที่ไม่มีการระบุอย่างชัดแจ้งในไฟล์ BUILD แต่เพิ่มโดย Bazel สำหรับ cquery ตัวเลือกนี้จะควบคุมการกรอง Toolchain ที่มีการแก้ปัญหาแล้ว
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]include_artifacts
: "true" -
รวมชื่อของอินพุตและเอาต์พุตการดำเนินการในเอาต์พุต (ซึ่งอาจมีขนาดใหญ่)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]include_aspects
: "true" -
aquery, cquery: จะรวมการทำงานที่สร้างโดยมุมมองไว้ในเอาต์พุตหรือไม่ คำค้นหา: ไม่มีการดำเนินการ (ติดตามเสมอ)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]include_commandline
: "true" -
มีเนื้อหาของบรรทัดคำสั่งสำหรับการดำเนินการในเอาต์พุต (อาจมีขนาดใหญ่)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]include_file_write_contents
: "เท็จ" -
ใส่เนื้อหาไฟล์สำหรับการดำเนินการ FileWrite และ SourceSymlinkManifest (อาจมีขนาดใหญ่)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]include_param_files
: "เท็จ" -
รวมเนื้อหาของไฟล์พารามิเตอร์ที่ใช้ในคำสั่ง (อาจมีขนาดใหญ่) หมายเหตุ: การเปิดใช้งานการตั้งค่าสถานะนี้จะเป็นการเปิดใช้การตั้งค่าสถานะ --include_commandline โดยอัตโนมัติ
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]incompatible_display_source_file_location
: "true" -
"จริง" จะแสดงเป้าหมายของไฟล์ต้นฉบับโดยค่าเริ่มต้น หากเป็นจริง จะแสดงตำแหน่งของบรรทัดที่ 1 ของไฟล์ต้นฉบับในเอาต์พุตตำแหน่ง แฟล็กนี้มีไว้เพื่อวัตถุประสงค์ในการย้ายข้อมูลเท่านั้น
แท็ก:terminal_output
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_package_group_includes_double_slash
: "true" -
หากเปิดใช้ เมื่อแสดงแอตทริบิวต์ "packages" ของpackage_group จะไม่ละเว้น "//" ที่นำหน้า
แท็ก:terminal_output
incompatible_change
- ค่าเริ่มต้น
--[no]infer_universe_scope
: "เท็จ" -
หากตั้งค่า และ --universe_scope ไม่ได้ตั้งค่าไว้ ระบบจะอนุมานค่าของ --universe_scope เป็นรายการรูปแบบเป้าหมายที่ไม่ซ้ำกันในนิพจน์การค้นหา โปรดทราบว่าค่า --universe_scope ที่อนุมานสำหรับนิพจน์การค้นหาที่ใช้ฟังก์ชันที่กําหนดขอบเขตระดับจักรวาล (เช่น "allrdeps") อาจไม่ใช่สิ่งที่คุณต้องการ คุณจึงควรใช้ตัวเลือกนี้ก็ต่อเมื่อคุณทราบว่าคุณกำลังทำอะไรอยู่เท่านั้น ดูรายละเอียดและตัวอย่างได้ที่ https://bazel.build/reference/query#sky-query หากตั้งค่า --universe_scope ค่า ระบบจะไม่สนใจค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้ใช้ได้เฉพาะกับ "query" (กล่าวคือ ไม่ใช่ "cquery")
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]line_terminator_null
: "เท็จ" -
เลือกว่าจะสิ้นสุดแต่ละรูปแบบด้วย \0 แทนการขึ้นบรรทัดใหม่หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]nodep_deps
: "true" -
หากเปิดใช้ ระบบจะแยกออกจาก "nodep" จะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ตัวอย่างทั่วไปของ "nodep" คือ "visibility" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ "info create-language" เพื่อดูข้อมูลเกี่ยวกับ "nodep" ทั้งหมด ในภาษาของบิลด์
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--output=<a string>
: "ข้อความ" -
รูปแบบที่ควรพิมพ์ผลการค้นหาคำค้นหา ค่าที่อนุญาตสำหรับ aquery ได้แก่ text, textprotocol, Proto, jsonแคมเปญของคุณ
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:default_values
: "true" -
หากเป็น "จริง" ระบบจะรวมแอตทริบิวต์ที่ไม่ได้ระบุไว้อย่างชัดเจนในไฟล์ BUILD มิฉะนั้นจะถูกละเว้น ตัวเลือกนี้ใช้ได้กับ --output=prof
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:definition_stack
: "เท็จ" -
ป้อนข้อมูลในช่อง Proto ของ Definition_stack ซึ่งบันทึกสำหรับสแต็กการเรียกใช้ Starlark สำหรับแต่ละอินสแตนซ์ของกฎ ณ เวลาที่มีการกำหนดคลาสของกฎ
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:flatten_selects
: "true" -
หากเปิดใช้ ระบบจะแยกแอตทริบิวต์ที่กำหนดค่าได้ซึ่งสร้างโดย select() ไว้ในรูปแบบ สำหรับประเภทรายการ การแสดงแบบ "แยกเป็นหลายรายการ" คือรายการซึ่งประกอบด้วยแต่ละค่าของแผนที่ที่เลือกเพียงครั้งเดียว ระบบจะแยกประเภทสเกลาร์เป็นค่าว่าง
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]proto:include_synthetic_attribute_hash
: "เท็จ" -
คำนวณและเติมข้อมูลแอตทริบิวต์ $internal_attr_hash หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:instantiation_stack
: "เท็จ" -
ป้อนข้อมูลสแต็กการเรียกใช้การสร้างอินสแตนซ์ของแต่ละกฎ โปรดทราบว่าการดำเนินการนี้ต้องมีสแต็กอยู่
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:locations
: "true" -
ระบุว่าจะแสดงข้อมูลตำแหน่งในเอาต์พุต Pro เลยหรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้น
--proto:output_rule_attrs=<comma-separated list of options>
: "ทั้งหมด" -
รายการแอตทริบิวต์ที่คั่นด้วยจุลภาคที่จะรวมในเอาต์พุต ค่าเริ่มต้นคือแอตทริบิวต์ทั้งหมด ตั้งค่าเป็นสตริงว่างเปล่าเพื่อไม่ให้แสดงแอตทริบิวต์ใดๆ ตัวเลือกนี้ใช้ได้กับ --output=protocol
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:rule_inputs_and_outputs
: "true" -
เติมข้อมูลในช่อง rules_input และ rules_output หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--query_file=<a string>
: "" -
หากมีการตั้งค่าไว้ การค้นหาจะอ่านการค้นหาจากไฟล์ที่มีชื่อที่นี่ แทนที่จะเป็นบรรทัดคำสั่ง การระบุไฟล์ที่นี่และคำค้นหาบรรทัดคำสั่งเป็นข้อผิดพลาด
แท็ก:changes_inputs
- ค่าเริ่มต้น
--[no]relative_locations
: "เท็จ" -
หากเป็นจริง ตำแหน่งของไฟล์ BUILD ใน XML และเอาต์พุต Pro จะสัมพันธ์กัน โดยค่าเริ่มต้น เอาต์พุตตำแหน่งจะเป็นเส้นทางสัมบูรณ์และจะไม่สอดคล้องกันในแต่ละเครื่อง คุณสามารถตั้งค่าตัวเลือกนี้เป็น "จริง" เพื่อให้ได้ผลลัพธ์ที่สอดคล้องกันในอุปกรณ์ทุกเครื่อง
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]skyframe_state
: "เท็จ" -
ดัมพ์กราฟการดำเนินการปัจจุบันจาก Skyframe โดยไม่ต้องทำการวิเคราะห์เพิ่มเติม หมายเหตุ: ขณะนี้ระบบยังไม่รองรับการระบุเป้าหมายด้วย --skyframe_state แฟล็กนี้ใช้ได้เฉพาะกับ --output=prof หรือ --output=textprotocol
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]tool_deps
: "true" -
คำถาม: หากปิดใช้ ทรัพยากร Dependency ใน "การกำหนดค่าโฮสต์" หรือ "การดำเนินการ" เป้าหมายจะไม่รวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน "การกำหนดค่าโฮสต์" เอดจ์ของทรัพยากร Dependency เช่น ขีดจำกัดจาก "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>" ซึ่งจะได้รับอนุญาตในกราฟทรัพยากร Dependency ที่ได้รับการแก้ไขแล้ว แม้ว่าจะมีการประกาศเวอร์ชันในรีจิสทรีในที่มาของเวอร์ชัน (หากไม่ได้มาจาก NonRegistryOverride) มิเช่นนั้น เวอร์ชันที่แยกออกมาจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันแยกที่อนุญาตด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" ได้ด้วย คุณสามารถปิดการตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้กับเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" ที่ส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" ให้พิมพ์คำเตือนเมื่อตรวจพบข้อมูลที่ไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟทรัพยากร Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" ให้พิมพ์คำเตือนเมื่อตรวจพบข้อมูลไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อยกระดับการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะไม่สนใจทรัพยากร Dependency สำหรับนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูทไม่ว่าค่าของแฟล็กนี้จะเป็นอะไร
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--lockfile_mode=<off, update or error>
: "อัปเดต" -
ระบุวิธีและวิธีใช้ล็อกไฟล์ ค่าที่ถูกต้องคือ "อัปเดต" เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง "ข้อผิดพลาด" ในการใช้ไฟล์ล็อกแต่เกิดข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" ไม่อ่านหรือเขียนไปยังไฟล์ล็อก
แท็ก:loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--override_module=<an equals-separated mapping of module name to path>
รายการ - ลบล้างโมดูลด้วยเส้นทางภายในในรูปแบบ <module name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์ ระบบจะใช้เส้นทางตามที่เป็น ถ้าเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพัทธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางดังกล่าวจะสัมพัทธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--registry=<a string>
รายการ -
ระบุรีจิสทรีที่จะใช้ในการค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับเป็นสิ่งสำคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีในภายหลังเมื่อไม่มีรีจิสทรีที่ขาดหายไป
แท็ก:changes_inputs
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
- ค่าเริ่มต้น
--[no]experimental_record_metrics_for_all_mnemonics
: "เท็จ" - โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจำกัดอยู่ที่ 20 รายการที่มีการกระทำมากที่สุด การตั้งค่าตัวเลือกนี้จะเป็นการเขียนสถิติสำหรับการช่วยจำทั้งหมด
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ค่าเริ่มต้นของ
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
หากไม่ว่างเปล่า ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
- ค่าเริ่มต้น
--experimental_downloader_config=<a string>
: ดูคำอธิบาย - ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด แต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือสองรูปแบบ รูปแบบหนึ่งจะจับคู่กัน และอีกรูปแบบหนึ่งใช้เป็น URL ทดแทน โดยมีการอ้างอิงกลับเริ่มตั้งแต่ "$1" เป็นไปได้ที่จะมีการใช้คำสั่ง "rewrite" หลายคำสั่งสำหรับ URL เดียวกัน และในกรณีนี้ระบบจะส่งคืน URL หลายรายการ
- ตัวเลือกเบ็ดเตล็ด ที่ยังไม่ได้รับการแยกประเภท:
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์ ระบบจะใช้เส้นทางตามที่เป็น ถ้าเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพัทธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางดังกล่าวจะสัมพัทธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์:
- ค่าเริ่มต้น
--[no]experimental_inprocess_symlink_creation
: "เท็จ" -
เลือกว่าจะเรียกใช้ระบบไฟล์โดยตรงเพื่อสร้างต้นไม้ Symlink หรือไม่
แท็ก:loading_and_analysis
,execution
,experimental
- ค่าเริ่มต้น
--[no]experimental_remotable_source_manifests
: "เท็จ" -
ต้องการให้การดำเนินการในไฟล์ Manifest ของแหล่งที่มาทำซ้ำได้หรือไม่
แท็ก:loading_and_analysis
,execution
,experimental
- ค่าเริ่มต้น
--[no]experimental_split_coverage_postprocessing
: "เท็จ" -
หากเป็น "จริง" Bazel จะดำเนินการประมวลผลภายหลังสำหรับการครอบคลุมในการทดลองที่สร้างขึ้นใหม่
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_strict_fileset_output
: "เท็จ" -
หากเปิดใช้ตัวเลือกนี้ ชุดไฟล์จะถือว่าอาร์ติแฟกต์เอาต์พุตทั้งหมดเป็นไฟล์ทั่วไป โดยจะไม่ข้ามผ่านไดเรกทอรีหรือไวต่อลิงก์สัญลักษณ์
แท็ก:execution
- ค่าเริ่มต้นของ
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
: "" -
เพิ่มหรือนำคีย์ออกจากข้อมูลการดำเนินการของการดำเนินการตามความสามารถในการจำการดำเนินการ ใช้กับการดำเนินการที่รองรับข้อมูลการดำเนินการเท่านั้น การดำเนินการทั่วไปจำนวนมากรองรับข้อมูลการดำเนินการ เช่น Genrule, CppCompile, Javac, StarlarkAction, TestRunner เมื่อระบุค่าหลายค่า ลำดับมีความสำคัญเนื่องจาก regexe หลายรายการอาจใช้กับช่วยจำเดียวกันได้
ไวยากรณ์: "regex=[+-]key,regex=[+-]key,..."
ตัวอย่าง:
'.*=+x,.*=-y,.*=+z' เพิ่ม "x" และ "z" ถึง และนำ "y" ออก ข้อมูลการดำเนินการสำหรับการดำเนินการทั้งหมด
'Genrule=+requires-x' เพิ่ม "requires-x" กับข้อมูลการดำเนินการสำหรับการดำเนินการ Genrule ทั้งหมด
'(?!Genrule).*=-requires-x' นำ "requires-x" ออก จากข้อมูลการดำเนินการสำหรับการดำเนินการ
ที่ไม่ใช่ Genrule ทั้งหมด
แท็ก:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
เปิดใช้การดำเนินการ Dex และ desugar ของ Android แบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
แท็ก:host_machine_resource_optimizations
execution
--persistent_android_resource_processor
-
เปิดใช้ผู้ประมวลผลข้อมูลทรัพยากร Android ถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
เปิดใช้การดำเนินการ Dex และ desugar ของ Android แบบมัลติเพล็กซ์โดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
เปิดใช้เครื่องมือประมวลผลทรัพยากร Android แบบมัลติเพล็กซ์แบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
เปิดใช้เครื่องมือ Android แบบต่อเนื่องและแบบมัลติเพล็กซ์ (Dexing, Deugaring, Resource Operations)
ขยายเป็น
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
แท็ก:host_machine_resource_optimizations
execution
- ตัวเลือกที่กำหนดค่า Toolchain ที่ใช้สำหรับการดำเนินการมีดังนี้
- ค่าเริ่มต้น
--android_compiler=<a string>
: ดูคำอธิบาย -
คอมไพเลอร์เป้าหมายของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
ค่าเริ่มต้น: "//external:android/crosstool"-
ตำแหน่งของคอมไพเลอร์ C++ ที่ใช้สำหรับบิลด์ของ Android
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--android_grte_top=<a label>
: ดูคำอธิบาย -
เป้าหมาย Android grte_top
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_manifest_merger=<legacy, android or force_android>
: "android" -
เลือกการควบรวมไฟล์ Manifest ที่จะใช้กับกฎ android_binary แจ้งเพื่อช่วยให้เปลี่ยนไปใช้การผสานรวมไฟล์ Manifest ของ Android จากการควบรวมเดิม
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_platforms=<a build target label>
: "" -
ตั้งค่าแพลตฟอร์มที่ android_binary กำหนดเป้าหมายใช้ หากระบุหลายแพลตฟอร์ม ไบนารีนั้นจะเป็น APK แบบอ้วน ซึ่งมีไบนารีแบบเนทีฟสำหรับแต่ละแพลตฟอร์มเป้าหมายที่ระบุ
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_sdk=<a build target label>
: "@bazel_tools//tools/android:sdk" -
ระบุ SDK/แพลตฟอร์ม Android ที่ใช้สร้างแอปพลิเคชัน Android
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--apple_compiler=<a string>
: ดูคำอธิบาย -
คอมไพเลอร์เป้าหมายของ Apple มีประโยชน์สำหรับการเลือกเวอร์ชันของ Toolchain (เช่น xcode-beta)
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้ในกฎของ Apple และ Objc และทรัพยากร Dependency
แท็ก:loses_incremental_state
changes_inputs
- ค่าเริ่มต้น
--apple_grte_top=<a build target label>
: ดูคำอธิบาย -
เป้าหมาย grte_top ของ Apple
แท็ก: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>
ค่าเริ่มต้น: "@bazel_tools//tools/test:lcov_merger"-
ตำแหน่งของไบนารีที่ใช้เพื่อประมวลผลรายงานการครอบคลุมแบบข้อมูลดิบหลังการประมวลผล ซึ่งต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งก็คือไบนารี ค่าเริ่มต้นคือ "//tools/test:lcov_merger"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_report_generator"-
ตําแหน่งของไบนารีที่ใช้สร้างรายงานการครอบคลุม ซึ่งต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งก็คือไบนารี ค่าเริ่มต้นคือ "//tools/test:coverage_report_generator"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_support"-
ตำแหน่งของไฟล์สนับสนุนที่จำเป็นต้องใช้ในอินพุตของการดำเนินการทดสอบทั้งหมดที่รวบรวมการครอบคลุมของโค้ด ค่าเริ่มต้นคือ "//tools/test:coverage_support"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้สำหรับคอมไพล์โค้ด C++
แท็ก:loading_and_analysis
,changes_inputs
,affects_outputs
- ค่าเริ่มต้น
--custom_malloc=<a build target label>
: ดูคำอธิบาย -
ระบุการใช้งาน Malloc ที่กำหนดเอง การตั้งค่านี้จะลบล้างแอตทริบิวต์ Malloc ในกฎบิลด์
แท็ก:changes_inputs
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
รายการ -
รายการนิพจน์ทั่วไปที่คั่นด้วยคอมมา แต่ละรายการจะมีคำนำหน้าด้วย - (นิพจน์เชิงลบ) และกำหนด (=) ให้กับรายการเป้าหมายค่าข้อจำกัดที่คั่นด้วยคอมมา หากเป้าหมายตรงกับที่ไม่มีนิพจน์เชิงลบ และนิพจน์เชิงบวกอย่างน้อย 1 รายการ การแปลง Toolchain จะดำเนินการเสมือนว่าได้ประกาศค่าข้อจำกัดเป็นข้อจำกัดการดำเนินการ ตัวอย่าง: //demo,-test=@platforms//cpus:x86_64 จะเพิ่ม "x86_64" ไปยังเป้าหมายใดๆ ภายใต้ //demo ยกเว้นเป้าหมายที่ชื่อมี "test"
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_enable_objc_cc_deps
: "true" -
อนุญาตให้กฎ objc_* ขึ้นอยู่กับ cc_library และทำให้ทรัพยากร Dependency ของ objc สร้างขึ้นด้วย --cpu ตั้งค่าเป็น "ios_<--ios_cpu>" สำหรับค่าใดก็ได้ใน --ios_multi_cpu
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]experimental_include_xcode_execution_requirements
: "เท็จ" -
เมื่อตั้งค่าแล้ว ให้เพิ่ม "requires-xcode:{version}" สำหรับการดำเนินการของ Xcode ทุกครั้ง หากเวอร์ชัน xcode มีป้ายกำกับขีดกลาง ให้เพิ่ม "requires-xcode-label:{version_label}" ด้วย ข้อกำหนดของการดำเนินการ
แท็ก:loses_incremental_state
,loading_and_analysis
,execution
- ค่าเริ่มต้น
--[no]experimental_prefer_mutual_xcode
: "true" -
หากเป็นจริง ให้ใช้ Xcode ล่าสุดที่พร้อมใช้งานทั้งในเครื่องและจากระยะไกล หากเป็นเท็จหรือไม่มีเวอร์ชันที่ใช้ร่วมกัน ให้ใช้เวอร์ชันของ Xcode ในเครื่องที่เลือกผ่าน xcode-select
แท็ก:loses_incremental_state
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--extra_execution_platforms=<comma-separated list of options>
รายการ -
แพลตฟอร์มที่มีให้ใช้งานเป็นแพลตฟอร์มการดำเนินการเพื่อเรียกใช้การดำเนินการ สามารถระบุแพลตฟอร์มโดยเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมาย แพลตฟอร์มเหล่านี้จะได้รับการพิจารณาก่อนแพลตฟอร์มที่ประกาศในไฟล์ WORKSPACE โดยregister_execution_platforms()
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--extra_toolchains=<comma-separated list of options>
รายการ -
กฎ Toolchain ที่จะต้องพิจารณาระหว่างการแก้ไข Toolchain สามารถระบุ Toolchains ตามเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมายได้ ระบบจะพิจารณา Toolchain เหล่านี้ก่อนการประกาศในไฟล์ WORKSPACE โดยregister_toolchains()
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--grte_top=<a label>
: ดูคำอธิบาย -
ป้ายกำกับไปยังไลบรารี libc ที่มีการเช็คอิน Crosstool Toolchain จะเลือกค่าเริ่มต้นและคุณแทบจะไม่จำเป็นต้องลบล้างค่าเริ่มต้น
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--host_compiler=<a string>
: ดูคำอธิบาย -
คอมไพเลอร์ C++ ที่จะใช้สำหรับการคอมไพล์โฮสต์ โดยจะไม่มีผลหากไม่ได้ตั้งค่า --host_crosstool_top
แท็ก:loading_and_analysis
execution
- ค่าเริ่มต้น
--host_crosstool_top=<a build target label>
: ดูคำอธิบาย -
โดยค่าเริ่มต้น ตัวเลือก --crosstool_top และ --compiler จะใช้สำหรับการกำหนดค่าโฮสต์ด้วย หากมีแฟล็กนี้ Bazel จะใช้ libc และคอมไพเลอร์เริ่มต้นสำหรับ Crosstool_top ที่ระบุ
แท็ก:loading_and_analysis
,changes_inputs
,affects_outputs
- ค่าเริ่มต้น
--host_grte_top=<a label>
: ดูคำอธิบาย -
ถ้าระบุ การตั้งค่านี้จะลบล้างไดเรกทอรีระดับบนสุดของ libc (--grte_top) สำหรับการกำหนดค่าโฮสต์
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้นของ
--host_platform=<a build target label>
: "" -
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายระบบโฮสต์
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--[no]incompatible_disable_expand_if_all_available_in_flag_set
: "true" -
หากเป็น "จริง" Bazel จะไม่อนุญาตให้ระบุลักษณะที่ขยายออก (expand_if_all_available) ในแฟล็ก_sets (ดูวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/7008)
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "true" -
หากเป็น "จริง" Bazel จะไม่เปิดใช้ "โฮสต์" และ "nonhost" ใน Toolchain ของ c++ (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/7407)
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_enable_android_toolchain_resolution
: "เท็จ" -
ใช้ความละเอียดของ Toolchain เพื่อเลือก Android SDK สำหรับกฎ Android (Starlark และเนทีฟ)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_enable_apple_toolchain_resolution
: "เท็จ" -
ใช้ความละเอียดของ Toolchain เพื่อเลือก Apple SDK สำหรับกฎของ Apple (Starlark และเนทีฟ)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_make_thinlto_command_lines_standalone
: "true" -
หากเป็นจริง Bazel จะไม่นำบรรทัดคำสั่งสำหรับการดำเนินการลิงก์ C++ มาใช้ซ้ำสำหรับบรรทัดคำสั่งสำหรับการจัดทำดัชนี lto (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/6791)
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
: "true" -
หากเป็นจริง 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
: "true" -
หากเป็นจริง Bazel จะไม่ลิงก์ทรัพยากร Dependency ของไลบรารีเป็นที่เก็บถาวรทั้งหมดโดยค่าเริ่มต้น (ดูวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/7362)
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_require_ctx_in_configure_features
: "true" -
หากเป็นจริง Bazel จะต้องใช้ "ctx" ใน cc_common.configure_features (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/7793)
แท็ก:loading_and_analysis
incompatible_change
-
ใช้ออบเจ็กต์ที่ใช้ร่วมกันของอินเทอร์เฟซ หาก Toolchain รองรับ เครื่องมือเชน ELF ทั้งหมดรองรับการตั้งค่านี้ในขณะนี้
แท็ก:loading_and_analysis
,affects_outputs
,affects_outputs
- ค่าเริ่มต้น
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
ระบุเวอร์ชันของ iOS SDK ที่จะใช้สร้างแอปพลิเคชัน iOS หากไม่ระบุ ระบบจะใช้เวอร์ชันเริ่มต้นของ iOS SDK จาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
ระบุเวอร์ชันของ macOS SDK ที่จะใช้สร้างแอปพลิเคชัน macOS หากไม่ระบุ ระบบจะใช้เวอร์ชันเริ่มต้นของ macOS SDK จาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--minimum_os_version=<a string>
: ดูคำอธิบาย -
เวอร์ชันระบบปฏิบัติการขั้นต่ำที่การคอมไพล์กำหนดเป้าหมาย
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้นของ
--platform_mappings=<a relative path>
: "" -
ตำแหน่งของไฟล์การแมปที่อธิบายแพลตฟอร์มที่จะใช้หากไม่ได้ตั้งค่าไว้ หรือแฟล็กที่จะตั้งค่าเมื่อมีแพลตฟอร์มอยู่แล้ว ต้องสัมพัทธ์กับรูทของพื้นที่ทำงานหลัก มีค่าเริ่มต้นเป็น "platform_mappings" (ไฟล์ที่อยู่ภายใต้รูทของพื้นที่ทำงานโดยตรง)
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--platforms=<a build target label>
: "" -
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายแพลตฟอร์มเป้าหมายสำหรับคำสั่งปัจจุบัน
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--python2_path=<a string>
: ดูคำอธิบาย -
เลิกใช้งานแล้ว ไม่มีการดำเนินการ ปิดใช้โดย "--incompatible_use_python_toolchains"
แท็ก:no_op
,deprecated
- ค่าเริ่มต้น
--python3_path=<a string>
: ดูคำอธิบาย -
เลิกใช้งานแล้ว ไม่มีการดำเนินการ ปิดใช้โดย "--incompatible_use_python_toolchains"
แท็ก:no_op
,deprecated
- ค่าเริ่มต้น
--python_path=<a string>
: ดูคำอธิบาย -
Absolute Path ของล่าม Python มีการเรียกใช้เป้าหมาย Python บนแพลตฟอร์มเป้าหมาย เลิกใช้งาน; ปิดใช้งานโดย --incompatible_use_python_toolchains
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้น
--python_top=<a build target label>
: ดูคำอธิบาย -
ป้ายกำกับของ py_runtime ที่แทนอินเทอร์พรีเตอร์ Python ได้มีการเรียกให้เรียกใช้เป้าหมาย Python บนแพลตฟอร์มเป้าหมาย เลิกใช้งาน; ปิดใช้งานโดย --incompatible_use_python_toolchains
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้น
--target_platform_fallback=<a build target label>
: "@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 หากไม่ระบุ ระบบจะใช้เวอร์ชันเริ่มต้นของ tvOS SDK จาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
ระบุเวอร์ชันของ WatchOS SDK ที่จะใช้สร้างแอปพลิเคชัน watchOS หากไม่ระบุ ระบบจะใช้เวอร์ชัน WatchOS SDK เริ่มต้นจาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--xcode_version=<a string>
: ดูคำอธิบาย -
หากระบุไว้ ให้ใช้ Xcode ของเวอร์ชันที่ระบุสำหรับการดำเนินการของบิลด์ที่เกี่ยวข้อง หากไม่ระบุ ระบบจะใช้ Xcode เวอร์ชันเริ่มต้นของผู้ดำเนินการ
แท็ก:loses_incremental_state
--xcode_version_config=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:host_xcodes"-
ป้ายกำกับของกฎ xcode_config ที่จะใช้สำหรับเลือกเวอร์ชัน Xcode ในการกำหนดค่าบิลด์
แท็ก:loses_incremental_state
loading_and_analysis
- มีดังนี้
- ค่าเริ่มต้น
--[no]apple_enable_auto_dsym_dbg
: "เท็จ" -
เลือกว่าจะบังคับให้เปิดใช้ไฟล์สัญลักษณ์การแก้ไขข้อบกพร่อง(.dSYM) สำหรับบิลด์ dbg หรือไม่
แท็ก:affects_outputs
action_command_lines
- ค่าเริ่มต้น
--[no]apple_generate_dsym
: "เท็จ" -
เลือกว่าจะสร้างไฟล์สัญลักษณ์การแก้ไขข้อบกพร่อง (.dSYM) หรือไม่
แท็ก:affects_outputs
action_command_lines
- ค่าเริ่มต้น
--[no]build_runfile_links
: "true" -
หากเป็น "จริง" ให้สร้างศูนย์การเรียกใช้ไฟล์ symlink สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้เขียนเฉพาะไฟล์ Manifest เมื่อเป็นไปได้
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]build_runfile_manifests
: "true" -
หากเป็น "จริง" ให้เขียนไฟล์ Manifest ของการเรียกใช้ไฟล์สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้ละเว้น การทดสอบในเครื่องจะทํางานไม่ได้หากเป็นเท็จ
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]build_test_dwp
: "เท็จ" -
หากเปิดใช้ เมื่อสร้างการทดสอบ C++ แบบคงที่ และด้วยฟิชชัน ไฟล์ .dwp สำหรับไบนารีการทดสอบจะสร้างขึ้นโดยอัตโนมัติเช่นกัน
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้นของ
--cc_proto_library_header_suffixes=<comma-separated 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
: "เท็จ" -
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันอื่นๆ ใน protocol_library
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_proto_extra_actions
: "เท็จ" -
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันอื่นๆ ใน protocol_library
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_save_feature_state
: "เท็จ" -
บันทึกสถานะของฟีเจอร์ที่เปิดใช้และที่ขอเป็นเอาต์พุตของการคอมไพล์
แท็ก:affects_outputs
experimental
- ค่าเริ่มต้น
--fission=<a set of compilation modes>
: "ไม่" -
ระบุโหมดการคอมไพล์ที่ใช้ฟิชชันสําหรับการคอมไพล์และลิงก์ C++ อาจเป็นชุดค่าผสมใดๆ ของ {'fastbuild', 'dbg', 'opt'} หรือค่าพิเศษ 'yes' เพื่อเปิดทุกโหมดและ "ไม่" เพื่อปิดใช้โหมดทั้งหมด
แท็ก:loading_and_analysis
,action_command_lines
,affects_outputs
- ค่าเริ่มต้น
--[no]incompatible_always_include_files_in_data
: "true" -
หากเป็นจริง กฎของระบบจะเพิ่ม <code>DefaultInfo.files</code> ของทรัพยากร Dependency ไปยังไฟล์รันไทม์ ซึ่งตรงกับลักษณะการทำงานที่แนะนำสำหรับกฎของ Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid)
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]legacy_external_runfiles
: "true" -
หากเป็น "จริง" ให้สร้างฟอเรสต์ Runfiles symlink สำหรับที่เก็บภายนอกภายใต้ .runfiles/wsname/external/repo (นอกเหนือจาก .runfiles/repo)
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]objc_generate_linkmap
: "เท็จ" -
ระบุว่าจะสร้างไฟล์ linkmap หรือไม่
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]save_temps
: "เท็จ" -
หากตั้งค่าไว้ ระบบจะบันทึกเอาต์พุตชั่วคราวจาก gcc ไฟล์เหล่านี้รวมถึงไฟล์ .s (โค้ด Ascyclr), ไฟล์ .i (C ที่ประมวลผลล่วงหน้า) และ .ii (C++ ที่ประมวลผลล่วงหน้า)
แท็ก:affects_outputs
- ตัวเลือกที่ให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการได้ โดยให้ส่งผลต่อค่าของเอาต์พุตแทนค่าที่มีอยู่
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--action_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกำหนดค่าเป้าหมาย คุณระบุตัวแปรได้ด้วยชื่อ ซึ่งในกรณีนี้ระบบจะนําค่าจากสภาพแวดล้อมการเรียกใช้ หรือคู่ name=value ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ ตัวเลือกนี้ใช้ได้หลายครั้ง สำหรับตัวเลือกที่ระบุสำหรับตัวแปรเดียวกัน ค่าที่ชนะล่าสุด และตัวเลือกของตัวแปรต่างๆ จะสะสมอยู่
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--android_cpu=<a string>
: "armeabi-v7a" -
CPU เป้าหมายของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--[no]android_databinding_use_androidx
: "เท็จ" -
สร้างไฟล์การเชื่อมโยงข้อมูลที่ใช้กับ AndroidX ได้ ใช้ได้เฉพาะกับการเชื่อมโยงข้อมูล v2 เท่านั้น
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]android_databinding_use_v3_4_args
: "เท็จ" -
ใช้ Android Databinding v2 ที่มีอาร์กิวเมนต์ 3.4.0
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้นของ
--android_dynamic_mode=<off, default or fully>
: "ปิด" -
กำหนดว่าจะให้ลิงก์ C++ ของกฎ Android แบบไดนามิกหรือไม่ เมื่อ cc_binary ไม่ได้สร้างไลบรารีที่ใช้ร่วมกันอย่างชัดแจ้ง "ค่าเริ่มต้น" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "สมบูรณ์" หมายความว่าไลบรารีทั้งหมดจะลิงก์แบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "ตามตัวอักษร" -
ตั้งค่าลำดับของไฟล์ Manifest ที่ส่งไปยังการรวมไฟล์ Manifest สำหรับไบนารีของ Android อัลฟ่าหมายความว่าไฟล์ Manifest ได้รับการจัดเรียงตามเส้นทางที่สัมพันธ์กับผู้ดำเนินการ ALPHABETICAL_BY_CONFIGURATION หมายความว่าไฟล์ Manifest ได้รับการจัดเรียงตามเส้นทางที่สัมพันธ์กับไดเรกทอรีการกำหนดค่าภายในไดเรกทอรีเอาต์พุต DEPENDENCY หมายความว่าไฟล์ Manifest จะเรียงลำดับตามไฟล์ Manifest ของไลบรารีแต่ละรายการที่อยู่ก่อนไฟล์ Manifest ของทรัพยากร Dependency
แท็ก:action_command_lines
execution
- ค่าเริ่มต้น
--[no]android_resource_shrinking
: "เท็จ" -
เปิดใช้การย่อทรัพยากรสำหรับ APK android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, watchos, tvos, macos or catalyst>
รายการ -
ระบุโหมดบิตโค้ดของ Apple สำหรับขั้นตอนการคอมไพล์ที่กำหนดเป้าหมายสถาปัตยกรรมอุปกรณ์ ค่าจะอยู่ในรูปแบบ "[platform=]mode" โดยที่แพลตฟอร์ม (ต้องเป็น "ios", "macos", "tvos" หรือ "watchos") เป็นไม่บังคับ หากมี ระบบจะใช้โหมดบิตโค้ดสำหรับแพลตฟอร์มนั้นโดยเฉพาะ หากไม่ระบุ ก็จะใช้กับทุกแพลตฟอร์ม โหมดต้องเป็น "none" "embedded_markers" หรือ "embedded" ตัวเลือกนี้อาจมีหลายครั้ง
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--[no]build_python_zip
: "อัตโนมัติ" -
สร้าง ZIP ที่เป็นไฟล์ปฏิบัติการ Python ใน Windows และปิดบนแพลตฟอร์มอื่น
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--catalyst_cpus=<comma-separated list of options>
รายการ -
รายชื่อสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple Catalyst
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--[no]collect_code_coverage
: "เท็จ" -
หากระบุไว้ Bazel จะใช้โค้ดเครื่องมือวัด (โดยใช้การใช้เครื่องมือแบบออฟไลน์หากเป็นไปได้) และจะรวบรวมข้อมูลการครอบคลุมระหว่างการทดสอบ เฉพาะเป้าหมายที่ตรงกับ --instrumentation_filter จะได้รับผลกระทบ โดยปกติ ตัวเลือกนี้ไม่ควรระบุโดยตรง - "ความครอบคลุมของbazel" ควรใช้คำสั่งแทน
แท็ก:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] ค่าเริ่มต้น: "fastbuild"-
ระบุโหมดที่จะมีการสร้างไบนารี ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
,action_command_lines
,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 ที่มีไฟล์โปรไฟล์, ไฟล์ข้อมูล RAW หรือไฟล์โปรไฟล์ LLVM ที่จัดทำดัชนีไว้
แท็ก:affects_outputs
- ค่าเริ่มต้น
--cs_fdo_instrument=<a string>
: ดูคำอธิบาย -
สร้างไบนารีด้วยเครื่องมือ FDO ที่ละเอียดอ่อนตามบริบท เมื่อใช้คอมไพเลอร์ Clang/LLVM คีย์ดังกล่าวจะยอมรับชื่อไดเรกทอรีที่ระบบจะส่งออกไฟล์โปรไฟล์แบบ RAW ขณะรันไทม์ด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--cs_fdo_profile=<a build target label>
: ดูคำอธิบาย -
cs_fdo_profile แสดงถึงโปรไฟล์ที่ละเอียดอ่อนตามบริบทที่จะใช้ในการเพิ่มประสิทธิภาพ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--cxxopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C++
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--define=<a 'name=value' assignment>
รายการ -
ตัวเลือก --define แต่ละรายการจะระบุการมอบหมายสำหรับตัวแปรบิลด์
แท็ก:changes_inputs
affects_outputs
- ค่าเริ่มต้น
--dynamic_mode=<off, default or fully>
: "ค่าเริ่มต้น" -
กำหนดว่าจะลิงก์ไบนารีของ C++ แบบไดนามิกหรือไม่ "ค่าเริ่มต้น" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "สมบูรณ์" หมายความว่าไลบรารีทั้งหมดจะลิงก์แบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้น
--[no]enable_fdo_profile_absolute_path
: "true" -
หากตั้งค่าไว้ การใช้ fdo_absolute_profile_path จะทำให้เกิดข้อผิดพลาด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]enable_runfiles
: "อัตโนมัติ" -
เปิดใช้โครงสร้างลิงก์สัญลักษณ์ของ Runfiles ซึ่งโดยค่าเริ่มต้น จะปิดอยู่ใน Windows และในแพลตฟอร์มอื่นๆ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_action_listener=<a build target label>
รายการ -
เลิกใช้งานไปทีละด้าน ใช้ action_listener เพื่อแนบทางลัดไปยังการดำเนินการบิลด์ที่มีอยู่
แท็ก:execution
experimental
- ค่าเริ่มต้น
--[no]experimental_android_compress_java_resources
: "เท็จ" -
บีบอัดทรัพยากร Java ใน APK
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_android_databinding_v2
: "เท็จ" -
ใช้ Android Databinding v2
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]experimental_android_resource_shrinking
: "เท็จ" -
เปิดใช้การย่อทรัพยากรสำหรับ APK android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_android_rewrite_dexes_with_rex
: "เท็จ" -
ใช้เครื่องมือ Rex เพื่อเขียนไฟล์ dex ใหม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]experimental_collect_code_coverage_for_generated_files
: "เท็จ" -
หากระบุไว้ Bazel จะสร้างการรวบรวมข้อมูลที่ครอบคลุมสำหรับไฟล์ที่สร้างขึ้นด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_objc_fastbuild_options=<comma-separated list of options>
: "-O0,-DDEBUG=1" -
ใช้สตริงเหล่านี้เป็นตัวเลือกคอมไพเลอร์ objc Fastbuild
แท็ก:action_command_lines
- ค่าเริ่มต้น
--[no]experimental_omitfp
: "เท็จ" -
หากเป็น "จริง" ให้ใช้ libunwind สำหรับการคลายสแต็ก แล้วคอมไพล์ด้วย -fomit-frame-pointer และ -fasynchronous-unwind-tables
แท็ก:action_command_lines
,affects_outputs
,experimental
- ค่าเริ่มต้น
--[no]experimental_platform_in_output_dir
: "เท็จ" -
หากเป็น "จริง" ระบบจะใช้แพลตฟอร์มเป้าหมายในชื่อไดเรกทอรีเอาต์พุตแทน CPU
แท็ก:affects_outputs
experimental
- ค่าเริ่มต้น
--[no]experimental_use_llvm_covmap
: "เท็จ" -
หากระบุ 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_apk_cpu=x86,armeabi-v7a. หากระบุแฟล็กนี้ ระบบจะละเว้น --android_cpu สำหรับทรัพยากร Dependency ของกฎ android_binary
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--[no]fat_apk_hwasan
: "เท็จ" -
เลือกว่าจะสร้างการแยก HWASAN หรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--fdo_instrument=<a string>
: ดูคำอธิบาย -
สร้างไบนารีด้วยเครื่องมือ FDO เมื่อใช้คอมไพเลอร์ Clang/LLVM คีย์ดังกล่าวจะยอมรับชื่อไดเรกทอรีที่ระบบจะส่งออกไฟล์โปรไฟล์แบบ RAW ขณะรันไทม์ด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_optimize=<a string>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ FDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อไฟล์ ZIP ที่มีแผนผังไฟล์ .gcda, ไฟล์ afdo ที่มีโปรไฟล์อัตโนมัติ หรือไฟล์โปรไฟล์ LLVM แฟล็กนี้ยอมรับไฟล์ที่ระบุเป็นป้ายกำกับด้วย (เช่น "//foo/bar:file.afdo" คุณอาจต้องเพิ่มคำสั่ง "exports_files" ไปยังแพ็กเกจที่เกี่ยวข้อง) และป้ายกำกับที่ชี้ไปยังเป้าหมาย "fdo_profile" การตั้งค่าสถานะนี้จะถูกแทนที่โดยกฎ "fdo_profile"
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_prefetch_hints=<a build target label>
: ดูคำอธิบาย -
ใช้คำแนะนำการดึงข้อมูลแคชล่วงหน้า
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_profile=<a build target label>
: ดูคำอธิบาย -
fdo_profile แทนโปรไฟล์ที่จะใช้ในการเพิ่มประสิทธิภาพ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--features=<a string>
รายการ -
ระบบจะเปิดใช้หรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างขึ้นในการกำหนดค่าเป้าหมาย กำลังระบุ -<feature> จะปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ ดูเพิ่มเติมที่ --host_features
แท็ก:changes_inputs
affects_outputs
- ค่าเริ่มต้น
--[no]force_pic
: "เท็จ" -
หากเปิดใช้งาน การคอมไพล์ C++ ทั้งหมดจะสร้างโค้ดที่ไม่ขึ้นอยู่กับตำแหน่ง ("-fPIC") ลิงก์จะใช้ไลบรารีที่สร้างไว้ล่วงหน้าของ PIC มากกว่าไลบรารีที่ไม่ใช่ PIC และลิงก์จะสร้างไฟล์ปฏิบัติการที่ไม่ขึ้นอยู่กับตำแหน่ง ("-pie")
แท็ก:loading_and_analysis
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_action_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกำหนดค่าโฮสต์หรือการดำเนินการ คุณระบุตัวแปรได้ด้วยชื่อ ซึ่งในกรณีนี้ระบบจะนําค่าจากสภาพแวดล้อมการเรียกใช้ หรือคู่ name=value ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ ตัวเลือกนี้ใช้ได้หลายครั้ง สำหรับตัวเลือกที่ระบุสำหรับตัวแปรเดียวกัน ค่าที่ชนะล่าสุด และตัวเลือกของตัวแปรต่างๆ จะสะสมอยู่
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--host_compilation_mode=<fastbuild, dbg or opt>
: "opt" -
ระบุโหมดที่จะมีการสร้างเครื่องมือที่ใช้ในการสร้าง ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_conlyopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งไปยัง 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 กำลังระบุ -<feature> จะปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ
แท็ก: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++ เมื่อคอมไพเลอร์ไฟล์บางไฟล์ในการกำหนดค่าโฮสต์หรือการดำเนินการ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: 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
: "true" -
หากเปิดใช้ ไลบรารีที่ลิงก์แบบไดนามิก (DLL) ของ C++ ทั้งหมดที่สร้างโดย cc_library ใน Windows จะเปลี่ยนชื่อเป็น name_{hash}.dll ซึ่งระบบคำนวณแฮชตาม RepositoryName และเส้นทางแพ็กเกจของ DLL ตัวเลือกนี้มีประโยชน์เมื่อคุณมีแพ็กเกจเดียว ซึ่งอาศัย cc_library ที่มีชื่อเดียวกันหลายรายการ (เช่น //foo/bar1:utils และ //foo/bar2:utils)
แท็ก:loading_and_analysis
,affects_outputs
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_merge_genfiles_directory
: "true" -
หากเป็นจริง ไดเรกทอรี genfiles จะถูกพับลงในไดเรกทอรี bin
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_use_host_features
: "เท็จ" -
หากเป็นจริง ให้ใช้ --features สำหรับการกำหนดค่าเป้าหมายเท่านั้น และ --host_features สำหรับการกำหนดค่า exec
แท็ก:changes_inputs
,affects_outputs
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_use_platforms_repo_for_constraints
: "true" -
หากเป็นจริง ระบบจะนำการตั้งค่าข้อจำกัดจาก @bazel_tools ออก
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]instrument_test_targets
: "เท็จ" -
เมื่อเปิดใช้การครอบคลุม ให้ระบุว่าจะพิจารณาการใช้กฎการทดสอบการวัดคุมหรือไม่ เมื่อตั้งค่าแล้ว กฎการทดสอบที่ --instrumentation_filter รวมอยู่จะมีการวัดคุม มิฉะนั้น กฎการทดสอบจะถูกยกเว้นจากการวัดคุมการครอบคลุมเสมอ
แท็ก:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
ค่าเริ่มต้น: "-/javatests[/:],-/test/java[/:]"-
เมื่อเปิดใช้การครอบคลุม ระบบจะวัดเฉพาะกฎที่มีชื่อซึ่งตัวกรองตามนิพจน์ทั่วไปที่ระบุรวมอยู่เท่านั้น กฎที่ขึ้นต้นด้วย "-" จะได้รับการยกเว้นแทน โปรดทราบว่าระบบจะวัดคุมเฉพาะกฎที่ไม่ใช่การทดสอบเท่านั้น ยกเว้นกรณีที่เปิดใช้งาน --instrument_test_targets
แท็ก:affects_outputs
- ค่าเริ่มต้น
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน iOS ที่เข้ากันได้ขั้นต่ำสำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ระบุ ให้ใช้ "ios_sdk_version"
แท็ก:loses_incremental_state
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ios_multi_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างแอปพลิเคชัน ios_ ผลลัพธ์จะเป็นไบนารีสากลที่มีสถาปัตยกรรมที่ระบุทั้งหมด
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--[no]legacy_whole_archive
: "true" -
เลิกใช้งานแล้ว และมีผลแทนด้วย --inสามารถเข้าถึง_remove_legacy_whole_archive (ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7362) เมื่อเปิด ให้ใช้ --whole-archive สำหรับกฎ cc_binary ที่มี linkshared=True และ linkstatic=True หรือ '-static' ใน Linkopts วิธีนี้ใช้สำหรับความเข้ากันได้แบบย้อนหลังเท่านั้น อีกทางเลือกหนึ่งที่ดีกว่าคือการใช้ Alwayslink=1 เมื่อจำเป็น
แท็ก:action_command_lines
,affects_outputs
,deprecated
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--linkopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งไปยัง gcc เมื่อลิงก์
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ltobackendopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังขั้นตอนแบ็กเอนด์ของ LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ltoindexopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังขั้นตอนการจัดทำดัชนี LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--macos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple macOS
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน macOS ที่เข้ากันได้ขั้นต่ำสำหรับเป้าหมาย หากไม่ได้ระบุ ให้ใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--[no]objc_debug_with_GLIBCXX
: "เท็จ" -
หากตั้งค่า และตั้งค่าโหมดการคอมไพล์เป็น "dbg" ให้กำหนด GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC และ GLIBCPP_CONCEPT_CHECKS
แท็ก:action_command_lines
- ค่าเริ่มต้น
--[no]objc_enable_binary_stripping
: "เท็จ" -
เลือกว่าจะดำเนินการลบสัญลักษณ์และโค้ดที่เสียหายในไบนารีที่ลิงก์หรือไม่ ระบบจะลบไบนารีหากระบุทั้ง Flag และ --compilation_mode=opt นี้
แท็ก:action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--objccopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ Objective-C/C++
แท็ก:action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งผ่านไปยัง gcc เฉพาะเมื่อคอมไพล์ไฟล์บางไฟล์ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจากรายการรวมและไม่รวมรูปแบบนิพจน์ทั่วไป (ดู --instrumentation_filter) ด้วย Option_1 กับ Option_n นั้นย่อมาจากตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ ในการแยกสตริงจะใช้เฉพาะ @ แรกเท่านั้น ตัวอย่าง: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับเลือกส่งไปยังแบ็กเอนด์ LTO (ในส่วน --features=thin_lto) เมื่อคอมไพล์ออบเจ็กต์แบ็กเอนด์บางรายการ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจาก รายการรูปแบบ รวมและยกเว้น ของนิพจน์ทั่วไป Option_1 กับ Option_n นั้นย่อมาจากตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ ในการแยกสตริงจะใช้เฉพาะ @ แรกเท่านั้น ตัวอย่าง: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่งแบ็กเอนด์ LTO ของไฟล์ o ทั้งหมดใน //foo/ ยกเว้น bar.o
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--platform_suffix=<a string>
: ดูคำอธิบาย -
ระบุคำต่อท้ายที่จะเพิ่มในไดเรกทอรีการกำหนดค่า
แท็ก:loses_incremental_state
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--propeller_optimize=<a build target label>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ Propeller เพื่อเพิ่มประสิทธิภาพเป้าหมายของบิลด์ โปรไฟล์ใบพัดต้องประกอบด้วยไฟล์อย่างน้อย 1 จาก 2 ไฟล์ โปรไฟล์สำเนา และโปรไฟล์ ld แฟล็กนี้ยอมรับป้ายกำกับบิลด์ซึ่งต้องอ้างถึงไฟล์อินพุตโปรไฟล์ใบพัด ตัวอย่างเช่น ไฟล์ BUILD ที่กำหนดป้ายกำกับใน a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)อาจต้องเพิ่มคำสั่ง ecommerce_files ลงในแพ็กเกจที่เกี่ยวข้องเพื่อให้ Bazel มองเห็นไฟล์เหล่านี้ ต้องใช้ตัวเลือกเป็น: --propeller_optimize=//a/b:propeller_profile
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--propeller_optimize_absolute_cc_profile=<a string>
: ดูคำอธิบาย -
ชื่อเส้นทางสัมบูรณ์ของไฟล์ cc_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพใบพัด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--propeller_optimize_absolute_ld_profile=<a string>
: ดูคำอธิบาย -
ชื่อเส้นทางสัมบูรณ์ของไฟล์ ld_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพใบพัด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--run_under=<a prefix in front of command>
: ดูคำอธิบาย -
คำนำหน้าที่จะแทรกก่อนไฟล์ปฏิบัติการสำหรับ "การทดสอบ" และ "เรียกใช้" คำสั่ง หากค่าคือ "foo -bar" และบรรทัดคำสั่งสำหรับการดำเนินการคือ "test_binary -baz" บรรทัดคำสั่งสุดท้ายคือ "foo -bar test_binary -baz" บรรทัดคำสั่งนี้อาจเป็นป้ายกำกับของเป้าหมายสั่งการได้ด้วย ตัวอย่างเช่น 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'
แท็ก:action_command_lines
-
หากจริง ระบบจะแชร์ไลบรารีเนทีฟที่มีฟังก์ชันการทำงานเหมือนกันกับเป้าหมายต่างๆ
แท็ก:loading_and_analysis
,affects_outputs
- ค่าเริ่มต้น
--[no]stamp
: "เท็จ" -
ประทับไบนารีด้วยวันที่ ชื่อผู้ใช้ ชื่อโฮสต์ ข้อมูลพื้นที่ทำงาน ฯลฯ
แท็ก:affects_outputs
- ค่าเริ่มต้น
--strip=<always, sometimes or never>
: "บางครั้ง" -
ระบุว่าจะตัดไบนารีและไลบรารีที่แชร์หรือไม่ (โดยใช้ "-Wl,--strip-debug") ค่าเริ่มต้นของ "บางครั้ง" หมายถึง Strip iff --compilation_mode=fastbuild
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--stripopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งไปยังการตัดเมื่อสร้าง "<name>.strped" 2.
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--swiftcopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยังการคอมไพล์ Swift
แท็ก:action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--tvos_cpus=<comma-separated list of options>
รายการ -
รายชื่อสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple tvOS
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน tvOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ระบุ ให้ใช้ "tvos_sdk_version"
แท็ก:loses_incremental_state
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--watchos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple WatchOS
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน WatchOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ได้ระบุ ให้ใช้ "watchos_sdk_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--xbinary_fdo=<a build target label>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ XbinaryFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อของโปรไฟล์แบบไบนารีที่เป็นค่าเริ่มต้น เมื่อใช้ตัวเลือกนี้ร่วมกับ --fdo_instrument/--fdo_optimize/--fdo_profile ตัวเลือกเหล่านั้นจะมีผลเหนือกว่าเสมอเสมือนว่าไม่ได้ระบุ xbinary_fdo
แท็ก:affects_outputs
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตบิลด์ที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมธง ฯลฯ)
- ค่าเริ่มต้นของ
--auto_cpu_environment_group=<a build target label>
: "" -
ประกาศ cloud_group ที่จะใช้ในการแมปค่า CPU กับค่า target_environment โดยอัตโนมัติ
แท็ก:changes_inputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]check_licenses
: "เท็จ" -
ตรวจสอบว่าข้อจำกัดในการออกใบอนุญาตที่กำหนดโดยแพ็กเกจที่เกี่ยวข้องไม่ขัดแย้งกับโหมดการเผยแพร่ของเป้าหมายที่กำลังสร้าง โดยค่าเริ่มต้น ใบอนุญาตจะไม่ได้รับการตรวจสอบ
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]check_visibility
: "true" -
หากปิดใช้ ระบบจะลดระดับข้อผิดพลาดระดับการเข้าถึงในทรัพยากร Dependency เป้าหมายให้เหลือเพียงคําเตือน
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]desugar_for_android
: "true" -
เลือกว่าจะใช้ไบต์โค้ด Java 8 ก่อนถอดรหัสหรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--[no]desugar_java8_libs
: "เท็จ" -
เลือกว่าจะรวมไลบรารี Java 8 ที่รองรับในแอปสำหรับอุปกรณ์เดิมหรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]enforce_constraints
: "true" -
ตรวจสอบสภาพแวดล้อมที่แต่ละเป้าหมายใช้งานร่วมกันได้ และรายงานข้อผิดพลาดหากเป้าหมายมีทรัพยากร Dependency ที่ไม่รองรับสภาพแวดล้อมเดียวกัน
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]experimental_allow_android_library_deps_without_srcs
: "เท็จ" -
แจ้งเพื่อช่วยให้เปลี่ยนจากการอนุญาตเป็นไม่อนุญาตกฎ android_library ที่ไม่มี srcs ด้วย dep คุณต้องล้าง Depot เพื่อเริ่มใช้งานโดยค่าเริ่มต้น
แท็ก:eagerness_to_exit
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_check_desugar_deps
: "true" -
ตรวจสอบความถูกต้องของการแยกน้ำตาลที่ระดับไบนารีของ Android อีกครั้งหรือไม่
แท็ก:eagerness_to_exit
,loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--experimental_import_deps_checking=<off, warning or error>
: "ปิด" -
เมื่อเปิดใช้ ให้ตรวจสอบว่าทรัพยากร Dependency ของ aar_IMPORT เสร็จสมบูรณ์หรือไม่ การบังคับใช้นี้อาจทำให้บิลด์เสียหายหรืออาจทำให้เกิดคำเตือน
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "ค่าเริ่มต้น" -
หากเป็นจริง ให้ตรวจสอบว่าเป้าหมาย Java ประกาศเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency อย่างชัดเจน
แท็ก:build_file_semantics
eagerness_to_exit
- ค่าเริ่มต้น
--[no]incompatible_check_testonly_for_output_files
: "เท็จ" -
หากเปิดใช้ ให้ตรวจสอบ testonly สำหรับเป้าหมายที่จำเป็นเบื้องต้นที่เป็นไฟล์เอาต์พุตโดยค้นหา testonly ของกฎที่สร้าง รายการนี้ตรงกับการตรวจสอบระดับการเข้าถึง
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disable_native_android_rules
: "เท็จ" -
หากเปิดใช้ ระบบจะปิดใช้กฎที่มีอยู่สำหรับ Android โดยตรง โปรดใช้กฎของ Android Starlark จาก https://github.com/bazelbuild/rules_android
แท็ก:eagerness_to_exit
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disable_native_apple_binary_rule
: "เท็จ" -
ไม่มีการดำเนินการ เก็บไว้ที่นี่เพื่อดูความเข้ากันได้แบบย้อนหลัง
แท็ก:eagerness_to_exit
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_force_strict_header_check_from_starlark
: "true" -
หากเปิดใช้ ให้ตั้งค่าการตรวจสอบส่วนหัวที่เข้มงวดใน Starlark API
แท็ก:loading_and_analysis
,changes_inputs
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_validate_top_level_header_inclusions
: "true" -
หากเป็นจริง Bazel จะตรวจสอบการรวมส่วนหัวไดเรกทอรีระดับบนสุดด้วย (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/10047)
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]strict_filesets
: "เท็จ" -
หากเปิดใช้ตัวเลือกนี้ ระบบจะรายงานว่าชุดไฟล์ข้ามขอบเขตของแพ็กเกจเป็นข้อผิดพลาด และจะไม่ทำงานเมื่อปิดใช้ check_fileset_dependencies_recursively
แท็ก:build_file_semantics
eagerness_to_exit
- ค่าเริ่มต้น
--strict_proto_deps=<off, warn, error, strict or default>
: "ข้อผิดพลาด" -
หากไม่ "ปิด" ให้ตรวจสอบว่าเป้าหมาย protocol_library ประกาศอย่างชัดแจ้งว่าเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้นของ
--strict_public_imports=<off, warn, error, strict or default>
: "ปิด" -
หากไม่ "ปิด" ให้ตรวจสอบว่าเป้าหมาย protocol_library ประกาศอย่างชัดเจนถึงเป้าหมายทั้งหมดที่ใช้ใน "นำเข้าสาธารณะ" ตามที่ส่งออกแล้ว
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้น
--[no]strict_system_includes
: "เท็จ" -
หากเป็น "จริง" ส่วนหัวที่พบผ่านทางระบบรวมเส้นทาง (-isystem) ต้องมีการประกาศด้วย
แท็ก:loading_and_analysis
eagerness_to_exit
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--target_environment=<a build target label>
รายการ -
ประกาศสภาพแวดล้อมเป้าหมายของบิลด์นี้ ต้องอ้างอิงถึงป้ายกำกับไปยัง "สภาพแวดล้อม" กฎ หากระบุ เป้าหมายระดับบนสุดทั้งหมดต้องเข้ากันได้กับสภาพแวดล้อมนี้
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อเอาต์พุตการลงชื่อของบิลด์:
- ค่าเริ่มต้น
--apk_signing_method=<v1, v2, v1_v2 or v4>
: "v1_v2" -
การใช้งานเพื่อรับรอง APK
แท็ก:action_command_lines
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--[no]device_debug_entitlements
: "true" -
หากมีการตั้งค่า และโหมดการคอมไพล์ไม่ใช่ "เพิ่มประสิทธิภาพ" แอป objc จะรวมการให้สิทธิ์การแก้ไขข้อบกพร่องเมื่อลงชื่อ
แท็ก:changes_inputs
- ค่าเริ่มต้น
--ios_signing_cert_name=<a string>
: ดูคำอธิบาย -
ชื่อใบรับรองที่จะใช้สำหรับ iOS Signing หากไม่ได้ตั้งค่า ระบบจะกลับไปใช้โปรไฟล์การจัดสรร อาจเป็นค่ากำหนดข้อมูลประจำตัว Keychain ของใบรับรองหรือ (สตริงย่อย) ของชื่อสามัญของใบรับรองตามหน้า man ของ Codesign (รหัสการลงชื่อเข้าใช้)
แท็ก:action_command_lines
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_disallow_legacy_py_provider
: "true" -
ไม่มีการดำเนินการ จะถูกนำออกในเร็วๆ นี้
แท็ก:loading_and_analysis
incompatible_change
- สภาพแวดล้อมการทดสอบหรือตัวดำเนินการทดสอบ:
- ค่าเริ่มต้น
--[no]allow_analysis_failures
: "เท็จ" -
หากจริง การวิเคราะห์เป้าหมายของกฎไม่สำเร็จส่งผลให้เกิดการเผยแพร่อินสแตนซ์ของ AnalysisFailureInfo ของเป้าหมายที่มีคำอธิบายข้อผิดพลาด แทนที่จะทำให้บิลด์ไม่สำเร็จ
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--analysis_testing_deps_limit=<an integer>
: "2000" -
ตั้งค่าจำนวนสูงสุดของทรัพยากร Dependency แบบทรานซิทีฟผ่านแอตทริบิวต์กฎที่มีการเปลี่ยนการกำหนดค่า for_analysis_testing การใช้เกินขีดจำกัดนี้จะทำให้เกิดข้อผิดพลาดของกฎ
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]break_build_on_parallel_dex2oat_failure
: "เท็จ" -
หากความล้มเหลวจริงในการดำเนินการ dex2oat จะทำให้บิลด์เสียหายแทนที่จะเรียกใช้ dex2oat ระหว่างรันไทม์ทดสอบ
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--[no]experimental_android_use_parallel_dex2oat
: "เท็จ" -
ใช้ dex2oat แบบขนานเพื่อเร่งความเร็ว android_test
แท็ก:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- ค่าเริ่มต้น
--[no]ios_memleaks
: "เท็จ" -
เปิดใช้การตรวจหาหน่วยความจำรั่วไหลในเป้าหมาย ios_test
แท็ก:action_command_lines
- ค่าเริ่มต้น
--ios_simulator_device=<a string>
: ดูคำอธิบาย -
อุปกรณ์ที่จะจำลองเมื่อเรียกใช้แอปพลิเคชัน iOS ในเครื่องมือจำลอง เช่น "iPhone 6" คุณดูรายการอุปกรณ์ได้โดยเรียกใช้ "xcrun simctl list devicetypes" บนเครื่องที่เครื่องมือจำลองจะทำงาน
แท็ก:test_runner
- ค่าเริ่มต้น
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชันของ iOS ที่จะเรียกใช้บนเครื่องมือจำลองเมื่อทำงานหรือทดสอบ ระบบจะไม่สนใจกฎ ios_test หากกฎระบุอุปกรณ์เป้าหมายไว้ในกฎ
แท็ก:test_runner
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
รายการ - ระบุจำนวนครั้งที่จะทำการทดสอบแต่ละครั้ง หากการดำเนินการเหล่านั้นล้มเหลวไม่ว่าด้วยเหตุผลใดก็ตาม จะถือว่าการทดสอบทั้งหมดไม่ผ่าน โดยปกติแล้ว ค่าที่ระบุจะเป็นแค่จำนวนเต็ม ตัวอย่าง: --runs_per_test=3 จะทำการทดสอบทั้งหมด 3 ครั้ง ไวยากรณ์สำรอง: regex_filter@runs_per_test โดย running_per_test ย่อมาจากค่าจำนวนเต็ม ส่วน regex_filter หมายถึงรายการรูปแบบการรวมและยกเว้นรูปแบบนิพจน์ทั่วไป (โปรดดู --instrumentation_filter) ตัวอย่างเช่น --runs_per_test=//foo/.*,-//foo/bar/.*@3 จะทำการทดสอบทั้งหมดใน //foo/ ยกเว้นการทดสอบภายใต้ foo/bar 3 ครั้ง ตัวเลือกนี้ส่งได้หลายครั้ง อาร์กิวเมนต์ที่ส่งผ่านล่าสุดที่ตรงกันจะมีความสำคัญเหนือกว่า หากไม่มีผลลัพธ์ที่ตรงกัน ระบบจะทำการทดสอบเพียงครั้งเดียว
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--test_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุตัวแปรสภาพแวดล้อมเพิ่มเติมที่จะแทรกลงในสภาพแวดล้อมตัวดำเนินการทดสอบ คุณระบุตัวแปรได้โดยใช้ชื่อ ซึ่งในกรณีนี้ระบบจะอ่านค่าของตัวแปรจากสภาพแวดล้อมไคลเอ็นต์ Bazel หรือด้วยคู่ชื่อ=ค่า ตัวเลือกนี้ใช้ได้หลายครั้งเพื่อระบุตัวแปรหลายรายการ ใช้เฉพาะโดย "การทดสอบ bazel" เท่านั้น คำสั่ง
แท็ก:test_runner
- ค่าเริ่มต้น
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - ลบล้างค่าระยะหมดเวลาในการทดสอบเริ่มต้นสำหรับระยะหมดเวลาทดสอบ (เป็นวินาที) หากระบุค่าจำนวนเต็มบวกค่าเดียว ค่าดังกล่าวจะแทนที่หมวดหมู่ทั้งหมด หากระบุจำนวนเต็มที่คั่นด้วยคอมมา 4 ตัวเลข ค่าดังกล่าวจะลบล้างระยะหมดเวลาสำหรับแบบสั้น ปานกลาง ยาว และนิรันดร์ (ตามลำดับนั้น) ไม่ว่าจะเป็นรูปแบบใด ค่า -1 จะบอกให้ Blaze ใช้ระยะหมดเวลาเริ่มต้นสำหรับหมวดหมู่นั้น
- ค่าเริ่มต้น
--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
: "true" -
หากเป็น "จริง" ระบบจะเก็บเอาต์พุตทดสอบที่ไม่ได้ประกาศไว้ในไฟล์ ZIP
แท็ก:test_runner
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตการค้นหาและความหมาย
- ค่าเริ่มต้น
--aspect_deps=<off, conservative or precise>
: "เชิงรับ" -
วิธีแก้ไขทรัพยากร Dependency ของลักษณะเมื่อรูปแบบเอาต์พุตเป็นหนึ่งใน {xml,protocol,record} "off" หมายความว่าจะไม่มีการแก้ไขทรัพยากร Dependency ในด้านต่างๆ "เชิงรับ" (ค่าเริ่มต้น) หมายความว่าจะมีการเพิ่มทรัพยากร Dependency ที่ประกาศทั้งหมด ไม่ว่าทรัพยากรเหล่านั้นจะได้รับคลาสของกฎการขึ้นต่อกันโดยตรงหรือไม่ ซึ่งก็คือ "แม่นยำ" หมายความว่าจะมีการเพิ่มเฉพาะด้านที่อาจทำงานอยู่ตามคลาสกฎของทรัพยากร Dependency โดยตรง โปรดทราบว่าโหมดแม่นยำต้องมีการโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียว ซึ่งจะทำให้ช้ากว่าโหมดอื่นๆ และโปรดทราบด้วยว่า โหมดแม้กระทั่งที่แม่นยำก็ไม่ได้แม่นยำทั้งหมด การตัดสินใจว่าจะคำนวณด้านใดด้านหนึ่งหรือไม่จะทำในขั้นตอนการวิเคราะห์ ซึ่งจะไม่ทำงานระหว่าง "การค้นหาแบบงัดแงะ"
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]deduplicate_depsets
: "true" -
นำรายการย่อยที่ไม่ใช่ Leaf ที่ซ้ำกันของ dep_set_of_files ออกในเอาต์พุต protocol/textprotocol/json สุดท้าย การดำเนินการนี้จะไม่ลบชุดย่อยที่ซ้ำกันซึ่งไม่ได้มีกลุ่มระดับบนเหมือนกัน การดำเนินการนี้จะไม่ส่งผลต่อรายการอาร์ติแฟกต์อินพุตที่มีประสิทธิภาพสุดท้ายของการดำเนินการ
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]graph:factored
: "true" -
หากเป็น "จริง" กราฟจะแสดงผลแบบ "แยกตัวประกอบ" นั่นคือ โหนดที่เท่าเทียมกันทางโทโพโลจีจะผสานเข้าด้วยกันและป้ายกำกับของโหนดทั้งสองเชื่อมติดกัน ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้น
--graph:node_limit=<an integer>
: "512" -
ความยาวสูงสุดของสตริงป้ายกำกับสำหรับโหนดกราฟในเอาต์พุต ป้ายกำกับที่ยาวขึ้นจะถูกตัด -1 หมายถึงไม่มีการตัดข้อความ ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]implicit_deps
: "true" -
หากเปิดใช้ การขึ้นต่อกันโดยปริยายจะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ทรัพยากร Dependency โดยนัยคือทรัพยากรที่ไม่มีการระบุอย่างชัดแจ้งในไฟล์ BUILD แต่เพิ่มโดย Bazel สำหรับ cquery ตัวเลือกนี้จะควบคุมการกรอง Toolchain ที่มีการแก้ปัญหาแล้ว
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]include_artifacts
: "true" -
รวมชื่อของอินพุตและเอาต์พุตการดำเนินการในเอาต์พุต (ซึ่งอาจมีขนาดใหญ่)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]include_aspects
: "true" -
aquery, cquery: จะรวมการทำงานที่สร้างโดยมุมมองไว้ในเอาต์พุตหรือไม่ คำค้นหา: ไม่มีการดำเนินการ (ติดตามเสมอ)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]include_commandline
: "true" -
มีเนื้อหาของบรรทัดคำสั่งสำหรับการดำเนินการในเอาต์พุต (อาจมีขนาดใหญ่)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]include_file_write_contents
: "เท็จ" -
ใส่เนื้อหาไฟล์สำหรับการดำเนินการ FileWrite และ SourceSymlinkManifest (อาจมีขนาดใหญ่)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]include_param_files
: "เท็จ" -
รวมเนื้อหาของไฟล์พารามิเตอร์ที่ใช้ในคำสั่ง (อาจมีขนาดใหญ่) หมายเหตุ: การเปิดใช้งานการตั้งค่าสถานะนี้จะเป็นการเปิดใช้การตั้งค่าสถานะ --include_commandline โดยอัตโนมัติ
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]incompatible_display_source_file_location
: "true" -
"จริง" จะแสดงเป้าหมายของไฟล์ต้นฉบับโดยค่าเริ่มต้น หากเป็นจริง จะแสดงตำแหน่งของบรรทัดที่ 1 ของไฟล์ต้นฉบับในเอาต์พุตตำแหน่ง แฟล็กนี้มีไว้เพื่อวัตถุประสงค์ในการย้ายข้อมูลเท่านั้น
แท็ก:terminal_output
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_package_group_includes_double_slash
: "true" -
หากเปิดใช้ เมื่อแสดงแอตทริบิวต์ "packages" ของpackage_group จะไม่ละเว้น "//" ที่นำหน้า
แท็ก:terminal_output
incompatible_change
- ค่าเริ่มต้น
--[no]infer_universe_scope
: "เท็จ" -
หากตั้งค่า และ --universe_scope ไม่ได้ตั้งค่าไว้ ระบบจะอนุมานค่าของ --universe_scope เป็นรายการรูปแบบเป้าหมายที่ไม่ซ้ำกันในนิพจน์การค้นหา โปรดทราบว่าค่า --universe_scope ที่อนุมานสำหรับนิพจน์การค้นหาที่ใช้ฟังก์ชันที่กําหนดขอบเขตระดับจักรวาล (เช่น "allrdeps") อาจไม่ใช่สิ่งที่คุณต้องการ คุณจึงควรใช้ตัวเลือกนี้ก็ต่อเมื่อคุณทราบว่าคุณกำลังทำอะไรอยู่เท่านั้น ดูรายละเอียดและตัวอย่างได้ที่ https://bazel.build/reference/query#sky-query หากตั้งค่า --universe_scope ค่า ระบบจะไม่สนใจค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้ใช้ได้เฉพาะกับ "query" (กล่าวคือ ไม่ใช่ "cquery")
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]line_terminator_null
: "เท็จ" -
เลือกว่าจะสิ้นสุดแต่ละรูปแบบด้วย \0 แทนการขึ้นบรรทัดใหม่หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]nodep_deps
: "true" -
หากเปิดใช้ ระบบจะแยกออกจาก "nodep" จะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ตัวอย่างทั่วไปของ "nodep" คือ "visibility" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ "info create-language" เพื่อดูข้อมูลเกี่ยวกับ "nodep" ทั้งหมด ในภาษาของบิลด์
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--output=<a string>
: "ข้อความ" -
รูปแบบที่ควรพิมพ์ผลการค้นหาคำค้นหา ค่าที่อนุญาตสำหรับ aquery คือ text, textprotocol, protocol, jsonโร
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:default_values
: "true" -
หากเป็น "จริง" ระบบจะรวมแอตทริบิวต์ที่ไม่ได้ระบุไว้อย่างชัดเจนในไฟล์ BUILD มิฉะนั้นจะถูกละเว้น ตัวเลือกนี้ใช้ได้กับ --output=prof
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:definition_stack
: "เท็จ" -
ป้อนข้อมูลในช่อง Proto ของ Definition_stack ซึ่งบันทึกสำหรับสแต็กการเรียกใช้ Starlark สำหรับแต่ละอินสแตนซ์ของกฎ ณ เวลาที่มีการกำหนดคลาสของกฎ
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:flatten_selects
: "true" -
หากเปิดใช้ ระบบจะแยกแอตทริบิวต์ที่กำหนดค่าได้ซึ่งสร้างโดย select() ไว้ในรูปแบบ สำหรับประเภทรายการ การแสดงแบบ "แยกเป็นหลายรายการ" คือรายการซึ่งประกอบด้วยแต่ละค่าของแผนที่ที่เลือกเพียงครั้งเดียว ระบบจะแยกประเภทสเกลาร์เป็นค่าว่าง
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]proto:include_synthetic_attribute_hash
: "เท็จ" -
คำนวณและเติมข้อมูลแอตทริบิวต์ $internal_attr_hash หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:instantiation_stack
: "เท็จ" -
ป้อนข้อมูลสแต็กการเรียกใช้การสร้างอินสแตนซ์ของแต่ละกฎ โปรดทราบว่าการดำเนินการนี้ต้องมีสแต็กอยู่
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:locations
: "true" -
ระบุว่าจะแสดงข้อมูลตำแหน่งในเอาต์พุต Pro เลยหรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้น
--proto:output_rule_attrs=<comma-separated list of options>
: "ทั้งหมด" -
รายการแอตทริบิวต์ที่คั่นด้วยจุลภาคที่จะรวมในเอาต์พุต ค่าเริ่มต้นคือแอตทริบิวต์ทั้งหมด ตั้งค่าเป็นสตริงว่างเปล่าเพื่อไม่ให้แสดงแอตทริบิวต์ใดๆ ตัวเลือกนี้ใช้ได้กับ --output=protocol
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:rule_inputs_and_outputs
: "true" -
เติมข้อมูลในช่อง rules_input และ rules_output หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--query_file=<a string>
: "" -
หากมีการตั้งค่าไว้ การค้นหาจะอ่านการค้นหาจากไฟล์ที่มีชื่อที่นี่ แทนที่จะเป็นบรรทัดคำสั่ง การระบุไฟล์ที่นี่และคำค้นหาบรรทัดคำสั่งเป็นข้อผิดพลาด
แท็ก:changes_inputs
- ค่าเริ่มต้น
--[no]relative_locations
: "เท็จ" -
หากเป็นจริง ตำแหน่งของไฟล์ BUILD ใน XML และเอาต์พุต Pro จะสัมพันธ์กัน โดยค่าเริ่มต้น เอาต์พุตตำแหน่งจะเป็นเส้นทางสัมบูรณ์และจะไม่สอดคล้องกันในแต่ละเครื่อง คุณสามารถตั้งค่าตัวเลือกนี้เป็น "จริง" เพื่อให้ได้ผลลัพธ์ที่สอดคล้องกันในอุปกรณ์ทุกเครื่อง
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]skyframe_state
: "เท็จ" -
ดัมพ์กราฟการดำเนินการปัจจุบันจาก Skyframe โดยไม่ต้องทำการวิเคราะห์เพิ่มเติม หมายเหตุ: ขณะนี้ระบบยังไม่รองรับการระบุเป้าหมายด้วย --skyframe_state แฟล็กนี้ใช้ได้เฉพาะกับ --output=prof หรือ --output=textprotocol
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]tool_deps
: "true" -
คำถาม: หากปิดใช้ ทรัพยากร Dependency ใน "การกำหนดค่าโฮสต์" หรือ "การดำเนินการ" เป้าหมายจะไม่รวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน "การกำหนดค่าโฮสต์" เอดจ์ของทรัพยากร Dependency เช่น ขีดจำกัดจาก "proto_library" ให้กับโปรโตคอลคอมไพเลอร์ ซึ่งโดยทั่วไปจะชี้ไปยังเครื่องมือที่ดำเนินการระหว่างการสร้างแทนที่จะเป็นส่วนของ "เป้าหมาย" เดียวกัน ของโปรแกรม
Cquery: หากปิดใช้ จะกรองเป้าหมายที่กำหนดค่าไว้ทั้งหมดซึ่งข้ามโฮสต์หรือการดำเนินการเปลี่ยนจากเป้าหมายระดับบนสุดที่ค้นพบเป้าหมายที่กำหนดค่าไว้นี้ออก ซึ่งหมายความว่าหากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าเป้าหมาย ระบบจะแสดงผลเฉพาะเป้าหมายที่กำหนดค่าไว้ในการกำหนดค่าเป้าหมายด้วย หากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าโฮสต์ ระบบจะแสดงผลเฉพาะเป้าหมายที่กำหนดค่าไว้ของโฮสต์เท่านั้น ตัวเลือกนี้จะ "ไม่" ยกเว้น Toolchain ที่แก้ไขแล้ว
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--universe_scope=<comma-separated list of options>
: "" -
ชุดรูปแบบเป้าหมายที่คั่นด้วยคอมมา (บวกและลบ) การค้นหาอาจดำเนินการในจักรวาลที่กำหนดโดยการปิดแบบสับเปลี่ยนของเป้าหมายที่ระบุ ตัวเลือกนี้ใช้สําหรับคำสั่งการค้นหาและคำสั่ง cquery
สำหรับ cquery อินพุตของตัวเลือกนี้จะเป็นเป้าหมายในการสร้างคำตอบทั้งหมด ดังนั้นตัวเลือกนี้อาจส่งผลต่อการกําหนดค่าและการเปลี่ยน หากไม่ได้ระบุตัวเลือกนี้ ระบบจะถือว่าเป้าหมายระดับบนสุดเป็นเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหา หมายเหตุ: สำหรับ cquery การไม่ระบุตัวเลือกนี้อาจทำให้บิลด์ไม่ทำงานหากเป้าหมายที่แยกวิเคราะห์จากนิพจน์คำค้นหาไม่สามารถสร้างได้ด้วยตัวเลือกระดับบนสุด
แท็ก:loading_and_analysis
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพเวลาของบิลด์
- ค่าเริ่มต้น
--[no]collapse_duplicate_defines
: "เท็จ" -
เมื่อเปิดใช้ ระบบจะนำการกำหนดซ้ำซ้อนออกในตอนต้นของบิลด์ การดำเนินการนี้จะหลีกเลี่ยงการสูญเสียแคชการวิเคราะห์โดยไม่จำเป็นสำหรับบิลด์บางประเภทที่เทียบเท่า
แท็ก:loading_and_analysis
loses_incremental_state
- ค่าเริ่มต้น
--[no]experimental_filter_library_jar_with_program_jar
: "เท็จ" -
กรอง ProGuard ProgramJar เพื่อนำชั้นเรียนที่อยู่ใน LibraryJar ออกด้วย
แท็ก:action_command_lines
- ค่าเริ่มต้น
--[no]experimental_inmemory_dotd_files
: "true" -
หากเปิดใช้ ระบบจะส่งไฟล์ C++ .d ในหน่วยความจำโดยตรงจากโหนดบิลด์ระยะไกลแทนที่จะถูกเขียนลงในดิสก์
แท็ก:loading_and_analysis
,execution
,affects_outputs
,experimental
- ค่าเริ่มต้น
--[no]experimental_inmemory_jdeps_files
: "true" -
หากเปิดใช้ ไฟล์ทรัพยากร Dependency (.jdeps) ที่สร้างขึ้นจากการคอมไพล์ Java จะส่งผ่านในหน่วยความจำโดยตรงจากโหนดบิลด์ระยะไกลแทนที่จะถูกเขียนลงในดิสก์
แท็ก:loading_and_analysis
,execution
,affects_outputs
,experimental
- ค่าเริ่มต้น
--[no]experimental_objc_include_scanning
: "เท็จ" -
ระบุว่าจะทำการสแกนรวมสำหรับวัตถุประสงค์ C/C++ หรือไม่
แท็ก:loading_and_analysis
,execution
,changes_inputs
- ค่าเริ่มต้น
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
: "เท็จ" -
หากเปิดใช้ ฟีเจอร์ parse_headers จะไม่สร้างการดำเนินการคอมไพล์ส่วนหัวแยกต่างหากหากพบแหล่งที่มาที่มีชื่อฐานเดียวกันในเป้าหมายเดียวกัน
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้น
--[no]experimental_retain_test_configuration_across_testonly
: "เท็จ" -
เมื่อเปิดใช้ --trim_test_configuration จะไม่ตัดการกำหนดค่าการทดสอบสำหรับกฎที่ทำเครื่องหมายว่า testonly=1 ทั้งนี้เพื่อลดปัญหาความขัดแย้งในการดำเนินการเมื่อกฎที่ไม่ใช่การทดสอบต้องพึ่งพากฎ cc_test จะไม่มีผลหาก --trim_test_configuration เป็นเท็จ
แท็ก:loading_and_analysis
loses_incremental_state
- ค่าเริ่มต้น
--[no]experimental_starlark_cc_import
: "เท็จ" -
หากเปิดใช้ เวอร์ชัน Starlark ของ cc_import จะสามารถใช้ได้
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--[no]experimental_unsupported_and_brittle_include_scanning
: "เท็จ" -
เลือกว่าจะจำกัดอินพุตเฉพาะการคอมไพล์ C/C++ หรือไม่โดยการแยกวิเคราะห์ #include บรรทัดจากไฟล์อินพุต ซึ่งจะช่วยปรับปรุงประสิทธิภาพและส่วนเพิ่มด้วยการลดขนาดของแผนผังอินพุตสำหรับการคอมไพล์ อย่างไรก็ตาม ก็อาจทำให้บิลด์เสียหายได้เช่นกัน เนื่องจากเครื่องมือสแกนดังกล่าวไม่สามารถใช้งานความหมายของโปรเซสเซอร์ล่วงหน้าแบบ C ได้อย่างสมบูรณ์ โดยเฉพาะอย่างยิ่ง ระบบจะไม่เข้าใจคำสั่ง #include แบบไดนามิก และไม่สนใจตรรกะตามเงื่อนไขของตัวประมวลผลล่วงหน้า คุณต้องรับความเสี่ยงของการใช้งานเอง เราจะปิดปัญหาที่เกี่ยวข้องกับการแจ้งว่าไม่เหมาะสมนี้
แท็ก:loading_and_analysis
,execution
,changes_inputs
- ค่าเริ่มต้น
--[no]incremental_dexing
: "true" -
ส่วนใหญ่จะทำงานสำหรับ Dexing แยกต่างหากสำหรับไฟล์ Jar แต่ละไฟล์
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--[no]objc_use_dotd_pruning
: "true" -
หากตั้งค่าไว้ จะมีการใช้ไฟล์ .d ที่มาจาก clang เพื่อตัดชุดอินพุตที่ส่งผ่านเข้าไปในคอมไพล์ objc
แท็ก:changes_inputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]process_headers_in_dependencies
: "เท็จ" -
เมื่อสร้าง //a:a เป้าหมาย ให้ประมวลผลส่วนหัวในเป้าหมายทั้งหมดที่ //a:a ต้องใช้ (หากเปิดใช้การประมวลผลส่วนหัวสำหรับ Toolchain)
แท็ก:execution
- ค่าเริ่มต้น
--[no]trim_test_configuration
: "true" -
เมื่อเปิดใช้ ระบบจะล้างตัวเลือกที่เกี่ยวข้องกับการทดสอบซึ่งอยู่ใต้ระดับบนสุดของบิลด์ เมื่อแฟล็กนี้ทำงานอยู่ ระบบจะสร้างการทดสอบเป็นทรัพยากร Dependency ของกฎที่ไม่ใช่การทดสอบไม่ได้ แต่การเปลี่ยนแปลงตัวเลือกที่เกี่ยวข้องกับการทดสอบจะไม่ทำให้มีการวิเคราะห์กฎที่ไม่ใช่การทดสอบอีกครั้ง
แท็ก:loading_and_analysis
loses_incremental_state
- ค่าเริ่มต้น
--[no]use_singlejar_apkbuilder
: "true" -
ตัวเลือกนี้เลิกใช้งานแล้ว ไม่มีการดำเนินการแล้วและจะถูกนำออกในเร็วๆ นี้
แท็ก:loading_and_analysis
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
- ค่าเริ่มต้น
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
พิมพ์ข้อมูลการแก้ไขข้อบกพร่องระหว่างการแปลง Toolchain แฟล็กจะใช้นิพจน์ทั่วไปซึ่งตรวจสอบกับประเภท Toolchain และเป้าหมายที่เฉพาะเจาะจงเพื่อดูว่าควรแก้ไขข้อบกพร่องใด นิพจน์ทั่วไปหลายรายการจะคั่นด้วยคอมมา แล้วระบบจะเลือกนิพจน์ทั่วไปแต่ละรายการแยกกัน หมายเหตุ: เอาต์พุตของ Flag นี้มีความซับซ้อนมากและน่าจะเป็นประโยชน์ต่อผู้เชี่ยวชาญด้านการแก้ไข Toolchain เท่านั้น
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--flag_alias=<a 'name=value' flag alias>
รายการ -
ตั้งชื่อย่อสำหรับธง Starlark โดยใช้คู่คีย์-ค่าคู่เดียวในรูปแบบ "<key>=<value>" เป็นอาร์กิวเมนต์
แท็ก:changes_inputs
- ค่าเริ่มต้น
--[no]incompatible_default_to_explicit_init_py
: "เท็จ" -
แฟล็กนี้เปลี่ยนลักษณะการทำงานเริ่มต้นเพื่อไม่ให้สร้างไฟล์ __init__.py โดยอัตโนมัติในไฟล์การเรียกใช้ของเป้าหมาย Python อีกต่อไป แม่นยำเมื่อเป้าหมาย py_binary หรือ py_test ตั้งค่า legacy_create_init เป็น "auto" (ค่าเริ่มต้น) ระบบจะถือว่าเป็น "เท็จ" เมื่อมีการตั้งค่าแฟล็กนี้เท่านั้น ดู https://github.com/bazelbuild/bazel/issues/10076
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_py2_outputs_are_suffixed
: "true" -
หากเป็นจริง เป้าหมายที่สร้างในการกำหนดค่า Python 2 จะปรากฏภายใต้รูทเอาต์พุตที่มีคำต่อท้าย "-py2" ขณะที่เป้าหมายที่สร้างขึ้นสำหรับ Python 3 จะปรากฏในรูทที่ไม่มีส่วนต่อท้ายที่เกี่ยวข้องกับ Python ซึ่งหมายความว่าลิงก์สัญลักษณ์ความสะดวก "bazel-bin" จะชี้ไปยังเป้าหมาย Python 3 แทนที่จะเป็น Python 2 หากคุณเปิดใช้ตัวเลือกนี้ ขอแนะนำให้เปิดใช้ "--incompatible_py3_is_default" ด้วย
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_py3_is_default
: "true" -
หากเป็นจริง เป้าหมาย "py_binary" และ "py_test" ที่ไม่ได้ตั้งค่าแอตทริบิวต์ "python_version" (หรือ "default_python_version") จะมีค่าเริ่มต้นเป็น PY3 แทนที่จะเป็น PY2 หากตั้งค่าแฟล็กนี้ ขอแนะนำให้ตั้งค่า "--incompatible_py2_outputs_are_suffixed"
แท็ก:loading_and_analysis
,affects_outputs
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_use_python_toolchains
: "true" -
หากตั้งค่าเป็น "จริง" กฎ Python ในเครื่องที่เป็นไฟล์ปฏิบัติการจะใช้รันไทม์ของ Python ที่ระบุโดย Toolchain ของ Python แทนรันไทม์ที่มาจากแฟล็กเดิม เช่น --python_top
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--python_version=<PY2 or PY3>
: ดูคำอธิบาย -
โหมดเวอร์ชันหลักของ Python ไม่ว่าจะเป็น "PY2" หรือ "PY3" โปรดทราบว่าเป้าหมาย "py_binary" และ "py_test" จะลบล้างค่านี้ (แม้ว่าจะไม่ได้ระบุเวอร์ชันอย่างชัดเจน) จึงมักไม่มีเหตุผลที่จะต้องระบุแฟล็กนี้
แท็ก:loading_and_analysis
,affects_outputs
,explicit_in_output_path
- ตัวเลือกเบ็ดเตล็ด ที่ยังไม่ได้รับการจัดหมวดหมู่:
--[no]cache_test_results
[-t
] ค่าเริ่มต้น: "อัตโนมัติ"- หากตั้งค่าเป็น "อัตโนมัติ" Bazel จะทำการทดสอบอีกครั้งเฉพาะในกรณีต่อไปนี้ (1) Bazel ตรวจพบการเปลี่ยนแปลงในการทดสอบหรือทรัพยากร Dependency (2) การทดสอบได้รับการทำเครื่องหมายว่าเป็นภายนอก (3) มีการขอทำการทดสอบหลายครั้งด้วย --runs_per_test หรือ(4) การทดสอบล้มเหลวก่อนหน้านี้ หากตั้งค่าเป็น "ใช่" Bazel จะแคชผลการทดสอบทั้งหมด ยกเว้นการทดสอบที่ทำเครื่องหมายว่าภายนอก หากตั้งค่าเป็น "ไม่" Bazel จะไม่แคชผลการทดสอบใดๆ
- ค่าเริ่มต้น
--[no]experimental_cancel_concurrent_tests
: "เท็จ" -
หากเป็น "จริง" Blaze จะยกเลิกการทดสอบพร้อมกันในการรันที่สำเร็จครั้งแรก วิธีนี้จะมีประโยชน์เมื่อใช้ร่วมกับ --runs_per_test_detects_flakes เท่านั้น
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_fetch_all_coverage_outputs
: "เท็จ" -
หากเป็น "จริง" Bazel จะดึงข้อมูลไดเรกทอรีข้อมูลการครอบคลุมทั้งหมดสำหรับการทดสอบแต่ละครั้งระหว่างการทำงานของการครอบคลุม
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_generate_llvm_lcov
: "เท็จ" -
หากเป็น "จริง" ความครอบคลุมของคําพูดจะสร้างรายงาน LCOV
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_j2objc_header_map
: "true" - เลือกว่าจะสร้างแผนที่ส่วนหัว J2ObjC ควบคู่ไปกับการแปลง J2ObjC หรือไม่
- ค่าเริ่มต้น
--[no]experimental_j2objc_shorter_header_path
: "เท็จ" -
เลือกว่าจะสร้างโดยใช้เส้นทางส่วนหัวที่สั้นกว่าหรือไม่ (ใช้ "_ios" แทน "_j2objc")
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_java_classpath=<off, javabuilder or bazel>
: "javabuilder" - เปิดใช้งานคลาสพาธที่ลดลงสำหรับการคอมไพล์ Java
- ค่าเริ่มต้น
--[no]experimental_limit_android_lint_to_android_constrained_java
: "เท็จ" -
จำกัด --experimental_run_android_lint_on_java_rules เฉพาะไลบรารีที่เข้ากันได้กับ Android
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_run_android_lint_on_java_rules
: "เท็จ" -
ระบุว่าจะตรวจสอบแหล่งที่มา java_* หรือไม่
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]explicit_java_test_deps
: "เท็จ" - ระบุทรัพยากร Dependency ของ JUnit หรือ Hamcrest อย่างชัดเจนใน java_test แทนที่จะได้มาจาก Dep ของ TestRunner โดยไม่ตั้งใจ ตอนนี้ใช้ได้กับ bazel เท่านั้น
- ค่าเริ่มต้น
--host_java_launcher=<a build target label>
: ดูคำอธิบาย - Java Launcher ที่เครื่องมือใช้ซึ่งดำเนินการในระหว่างบิลด์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_javacopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมในการส่งไปยัง Javac เมื่อสร้างเครื่องมือที่ดำเนินการระหว่างบิลด์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_jvmopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง Java VM เมื่อสร้างเครื่องมือสร้างที่ดำเนินการระหว่างบิลด์ ระบบจะเพิ่มตัวเลือกเหล่านี้ไปยังตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
- ค่าเริ่มต้น
--[no]incompatible_check_sharding_support
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่ผ่านการทดสอบชาร์ด หากตัวดำเนินการทดสอบไม่ได้ระบุว่ารองรับการชาร์ดดิ้งโดยการแตะไฟล์ที่เส้นทางใน TEST_SHARD_STATUS_FILE หากเป็นเท็จ ตัวดำเนินการทดสอบที่ไม่รองรับการชาร์ดจะนำไปยังการทดสอบทั้งหมดที่ทำงานในชาร์ดแต่ละรายการ
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_exclusive_test_sandboxed
: "เท็จ" -
หากจริง การทดสอบพิเศษจะทำงานโดยใช้กลยุทธ์แซนด์บ็อกซ์ เพิ่ม "ท้องถิ่น" เพื่อบังคับให้การทดสอบพิเศษทำงานภายในเครื่อง
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_strict_action_env
: "เท็จ" -
หากเป็นจริง Bazel จะใช้สภาพแวดล้อมที่มีค่าคงที่สำหรับ PATH และไม่รับค่า LD_LIBRARY_PATH ใช้ --action_env=ENV_VARIABLE หากคุณต้องการรับตัวแปรสภาพแวดล้อมที่เฉพาะเจาะจงจากไคลเอ็นต์ แต่โปรดทราบว่าการทำเช่นนี้อาจป้องกันการแคชข้ามผู้ใช้ได้หากมีการใช้แคชที่แชร์
แท็ก:loading_and_analysis
incompatible_change
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--j2objc_translation_flags=<comma-separated list of options>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยังเครื่องมือ J2ObjC
--java_debug
-
ทำให้เครื่องเสมือนของ Java ของการทดสอบ Java ต้องรอการเชื่อมต่อจากโปรแกรมแก้ไขข้อบกพร่องที่สอดคล้องกับ JDWP (เช่น jdb) ก่อนเริ่มการทดสอบ โดยนัย -test_output=streamed
ขยายเป็น
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- ค่าเริ่มต้น
--[no]java_deps
: "true" - สร้างข้อมูลทรัพยากร Dependency (ในขณะนี้คือคลาสพาธเวลาคอมไพล์) ต่อเป้าหมาย Java
- ค่าเริ่มต้น
--[no]java_header_compilation
: "true" - คอมไพล์จากต้นทางโดยตรง
- ค่าเริ่มต้น
--java_language_version=<a string>
: "8" - เวอร์ชันภาษา Java
- ค่าเริ่มต้น
--java_launcher=<a build target label>
: ดูคำอธิบาย - Java Launcher ที่จะใช้เมื่อสร้างไบนารีของ Java หากตั้งค่าสถานะนี้เป็นสตริงว่างเปล่า ระบบจะใช้ Launcher ของ JDK "Launcher" จะลบล้างแฟล็กนี้
--java_runtime_version=<a string>
ค่าเริ่มต้น: "local_jdk"- เวอร์ชันรันไทม์ของ Java
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--javacopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง Javac
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--jvmopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง Java VM ระบบจะเพิ่มตัวเลือกเหล่านี้ไปยังตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
- ค่าเริ่มต้น
--legacy_main_dex_list_generator=<a build target label>
: ดูคำอธิบาย - ระบุไบนารีที่จะใช้สร้างรายการคลาสที่ต้องอยู่ใน Dex หลักเมื่อคอมไพล์ Multidex เดิม
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--plugin=<a build target label>
รายการ - ปลั๊กอินที่ใช้ในบิลด์ ปัจจุบันใช้งานได้กับ java_plugin
- ค่าเริ่มต้น
--proguard_top=<a build target label>
: ดูคำอธิบาย - ระบุเวอร์ชัน ProGuard ที่จะใช้สำหรับการนำโค้ดออกเมื่อสร้างไบนารีของ Java
--proto_compiler=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/protocol:protocol"-
ป้ายกำกับของคอมไพเลอร์ Proto
แท็ก:affects_outputs
loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/protocol:cc_toolchain"-
ป้ายกำกับของ profto_lang_toolchain() ที่อธิบายวิธีคอมไพล์ C++ Proto
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/j2objc:j2objc_protocol_toolchain"-
ป้ายกำกับของ Proto_lang_toolchain() ที่อธิบายถึงวิธีคอมไพล์ j2objc Proto
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/protocol:java_toolchain"-
ป้ายกำกับของ protocol_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ Java Prot
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/protocol:javalite_toolchain"-
ป้ายกำกับของ Proto_lang_toolchain() ที่อธิบายถึงวิธีคอมไพล์ JavaLite Proto
แท็ก:affects_outputs
,loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--protocopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยังคอมไพเลอร์ Protocolbuf
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]runs_per_test_detects_flakes
: "เท็จ" - หากเป็นจริง ชาร์ดที่การเรียกใช้/ความพยายามอย่างน้อย 1 ครั้งผ่านและการเรียกใช้/ความพยายามอย่างน้อย 1 ครั้งล้มเหลวจะได้รับสถานะ FLAKY
- ค่าเริ่มต้น
--shell_executable=<a path>
: ดูคำอธิบาย -
เส้นทางสัมบูรณ์ไปยังเชลล์ปฏิบัติการของ Bazel ที่จะใช้ หากไม่ได้ตั้งค่านี้ แต่มีการตั้งค่าตัวแปรสภาพแวดล้อม BAZEL_SH ในการเรียกใช้ Bazel แรก (ซึ่งเริ่มต้นเซิร์ฟเวอร์ Bazel) Bazel จะใช้ตัวแปรนั้น หากไม่ได้ตั้งค่าไว้ Bazel จะใช้เส้นทางเริ่มต้นแบบฮาร์ดโค้ด โดยขึ้นอยู่กับระบบปฏิบัติการที่ใช้ (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, อื่นๆ ทั้งหมด: /bin/bash) โปรดทราบว่าการใช้ Shell ที่เข้ากันไม่ได้กับ Bash อาจทำให้บิลด์ล้มเหลวหรือรันไทม์ของไบนารีที่สร้างขึ้นไม่สำเร็จ
แท็ก:loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--test_arg=<a string>
รายการ - ระบุตัวเลือกและอาร์กิวเมนต์เพิ่มเติมที่ควรส่งไปยังไฟล์ปฏิบัติการทดสอบ ซึ่งสามารถใช้หลายครั้งเพื่อระบุอาร์กิวเมนต์ได้หลายรายการ หากดำเนินการทดสอบหลายรายการ แต่ละรายการจะได้รับอาร์กิวเมนต์ที่เหมือนกัน ใช้เฉพาะโดย "การทดสอบ bazel" เท่านั้น คำสั่ง
- ค่าเริ่มต้น
--test_filter=<a string>
: ดูคำอธิบาย - ระบุตัวกรองที่จะส่งต่อไปยังเฟรมเวิร์กการทดสอบ ใช้เพื่อจำกัดการทดสอบ โปรดทราบว่าการเปลี่ยนแปลงนี้ไม่มีผลต่อเป้าหมายที่สร้างขึ้น
- ค่าเริ่มต้น
--test_result_expiration=<an integer>
: "-1" - ตัวเลือกนี้เลิกใช้งานแล้วและไม่ส่งผลใดๆ
- ค่าเริ่มต้น
--[no]test_runner_fail_fast
: "เท็จ" - การส่งต่อล้มเหลวตัวเลือกอย่างรวดเร็วไปยังตัวดำเนินการทดสอบ ตัวดำเนินการทดสอบควรหยุดการดำเนินการเมื่อล้มเหลวครั้งแรก
- ค่าเริ่มต้น
--test_sharding_strategy=<explicit or disabled>
: "อาจไม่เหมาะสม" - ระบุกลยุทธ์สำหรับการทดสอบชาร์ดดิ้ง: "Explicit" จะใช้ชาร์ดดิ้งก็ต่อเมื่อ "shard_count" เท่านั้น มีแอตทริบิวต์ BUILD "ปิดใช้" ว่าจะไม่ใช้ทดสอบชาร์ดดิ้ง
- ค่าเริ่มต้น
--tool_java_language_version=<a string>
: "8" - เวอร์ชันภาษา Java ที่ใช้เพื่อเรียกใช้เครื่องมือที่จำเป็นระหว่างการสร้าง
- ค่าเริ่มต้นของ
--tool_java_runtime_version=<a string>
: "remotejdk_11" - เวอร์ชันรันไทม์ของ Java ที่ใช้เพื่อเรียกใช้เครื่องมือในระหว่างบิลด์
- ค่าเริ่มต้น
--[no]use_ijars
: "true" - หากเปิดใช้ ตัวเลือกนี้จะทำให้การคอมไพล์ Java ใช้ jars อินเทอร์เฟซ ซึ่งจะทำให้การคอมไพล์แบบเพิ่มขึ้นเรื่อยๆ ได้เร็วขึ้น แต่ข้อความแสดงข้อผิดพลาดอาจแตกต่างกันได้
ตัวเลือกสำหรับบิลด์
- ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชของที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่เกิดแคชแทนที่จะคัดลอก ซึ่งช่วยประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุไว้ ซึ่งจะทำให้การเปลี่ยนแปลง URL ส่งผลให้มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม สามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ทำให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--[no]experimental_repository_disable_download
: "เท็จ" -
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก: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
: "เท็จ" -
ห้ามดำเนินการสร้าง เพียงตรวจสอบว่าเป็นรุ่นล่าสุดหรือไม่ หากเป้าหมายทั้งหมดเป็นปัจจุบัน แสดงว่าบิลด์เสร็จสมบูรณ์ หากต้องดำเนินการในขั้นตอนใด ระบบจะรายงานข้อผิดพลาดและบิลด์ล้มเหลว
แท็ก:execution
- ค่าเริ่มต้น
--dynamic_local_execution_delay=<an integer>
: "1000" -
การดำเนินการในเครื่องควรล่าช้าไปกี่มิลลิวินาที หากการดำเนินการจากระยะไกลเร็วขึ้นระหว่างบิลด์อย่างน้อย 1 ครั้ง
แท็ก:execution
host_machine_resource_optimizations
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment>
รายการ -
กลยุทธ์ท้องถิ่นตามลำดับสำหรับใช้กับการช่วยจำที่กำหนด ส่งผ่าน "local" เนื่องจากช่วยจำจะตั้งค่าเริ่มต้นสำหรับการช่วยจำที่ไม่ระบุ ต้องใช้ [mnemonic=]local_strategy[,local_strategy,...]
แท็ก:execution
host_machine_resource_optimizations
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment>
รายการ -
กลยุทธ์ระยะไกลที่จะใช้สำหรับการช่วยจำที่ระบุ กําลังส่ง "รีโมต" เนื่องจากช่วยจำจะตั้งค่าเริ่มต้นสำหรับการช่วยจำที่ไม่ระบุ ต้องใช้ [mnemonic=]remote_strategy[,remote_strategy,...]
แท็ก:execution
host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--experimental_docker_image=<a string>
: "" -
ระบุชื่ออิมเมจ Docker (เช่น "ubuntu:latest") ที่ควรจะใช้เพื่อดำเนินการแซนด์บ็อกซ์เมื่อใช้กลยุทธ์ Docker และตัวการดำเนินการยังไม่มีแอตทริบิวต์รูปภาพคอนเทนเนอร์ใน Remote_execution_properties ในคำอธิบายแพลตฟอร์ม ค่าของแฟล็กนี้ส่งผ่านแบบคำต่อคำไปยัง "docker Run" ดังนั้นจึงรองรับไวยากรณ์และกลไกเดียวกันกับ Docker
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_docker_use_customized_images
: "true" -
หากเปิดใช้ ระบบจะแทรก uid และ gid ของผู้ใช้ปัจจุบันลงในอิมเมจ Docker ก่อนใช้งาน ซึ่งจำเป็นหากบิลด์ / การทดสอบของคุณขึ้นอยู่กับผู้ใช้ที่มีชื่อและไดเรกทอรีหน้าแรกในคอนเทนเนอร์ ตัวเลือกนี้เปิดใช้งานโดยค่าเริ่มต้น แต่คุณสามารถปิดใช้งานได้ในกรณีที่ฟีเจอร์การปรับแต่งรูปภาพอัตโนมัติไม่ทำงานในกรณีของคุณ หรือคุณทราบว่าไม่จำเป็นต้องใช้
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_dynamic_exclude_tools
: "true" -
เมื่อตั้งค่าแล้ว เป้าหมายที่เป็น "สำหรับเครื่องมือ" ไม่ต้องใช้การเรียกใช้แบบไดนามิก เป้าหมายดังกล่าวไม่มีแนวโน้มที่จะสร้างทีละส่วน จึงไม่คุ้มกับการใช้จ่ายในพื้นที่
แท็ก:execution
host_machine_resource_optimizations
- ค่าเริ่มต้น
--experimental_dynamic_local_load_factor=<a double>
: "0" -
ควบคุมปริมาณภาระงานจากการดำเนินการแบบไดนามิกที่จะนำขึ้นเครื่องภายใน แฟล็กนี้จะปรับจำนวนการดำเนินการในการดำเนินการแบบไดนามิกที่เราจะกำหนดเวลาพร้อมกัน ขึ้นอยู่กับจำนวน CPU ที่ Blaze คิดว่าพร้อมใช้งาน ซึ่งควบคุมได้ด้วยแฟล็ก --local_cpu_resources
หากแฟล็กนี้เป็น 0 ระบบจะกำหนดเวลาการดำเนินการทั้งหมดในเครื่องทันที หาก > 0 จำนวนการดำเนินการที่กำหนดเวลาไว้ภายในเครื่องจะจำกัดตามจำนวน CPU ที่ใช้ได้ ถ้า < 1 ปัจจัยในการโหลดจะใช้เพื่อลดจำนวนการดำเนินการที่กำหนดเวลาไว้ภายในเครื่องเมื่อมีจำนวนการดำเนินการที่รอกำหนดเวลาอยู่ในระดับสูง ซึ่งจะช่วยลดโหลดของเครื่องภายในในเคสบิลด์ที่สะอาด ซึ่งเครื่องในเครือข่ายอาจไม่ให้ผลมากนัก
แท็ก:execution
host_machine_resource_optimizations
- ค่าเริ่มต้น
--experimental_dynamic_slow_remote_time=<An immutable length of time.>
: "0" -
หากมากกว่า 0 เวลาที่การดำเนินการแบบไดนามิกจะต้องเรียกใช้จากระยะไกลเท่านั้นก่อนที่เราจะจัดลำดับความสำคัญของการดำเนินการในเครื่องเพื่อหลีกเลี่ยงการหมดเวลาจากระยะไกล วิธีนี้อาจซ่อนปัญหาบางอย่างในระบบการดำเนินการระยะไกล อย่าเปิดฟีเจอร์นี้โดยไม่ตรวจสอบปัญหาด้านการดำเนินการจากระยะไกล
แท็ก:execution
host_machine_resource_optimizations
- ค่าเริ่มต้น
--[no]experimental_enable_docker_sandbox
: "เท็จ" -
เปิดใช้แซนด์บ็อกซ์ที่อิงตาม Docker ตัวเลือกนี้จะไม่มีผลหากไม่ได้ติดตั้ง Docker
แท็ก:execution
--experimental_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 ให้ดำเนินการลบ 3 รายการดังกล่าวใน Thread Pool แบบไม่พร้อมกันที่มีขนาด 1 เมื่อบิลด์ทำงานอยู่และเติบโตเป็นขนาดที่ระบุโดย Flag นี้เมื่อเซิร์ฟเวอร์ไม่มีการใช้งาน
แท็ก: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
: "true" -
หากมีการกำหนดแฟล็กนี้ และการดำเนินการทดสอบไม่สร้างไฟล์ 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
: "เท็จ" -
หากตั้งค่าเป็น "จริง" ไม่ต้องต่อเชื่อมรูท ให้ต่อเชื่อมเฉพาะสิ่งที่มาพร้อมกับ sandbox_add_mount_pair ไฟล์ที่ป้อนจะฮาร์ดลิงก์ไปยังแซนด์บ็อกซ์แทนที่จะลิงก์มาจากแซนด์บ็อกซ์ หากไฟล์อินพุตการดำเนินการอยู่ในระบบไฟล์ที่แตกต่างจากแซนด์บ็อกซ์ ระบบจะคัดลอกไฟล์อินพุตแทน
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_use_sandboxfs
: "เท็จ" -
ใช้ sandboxfs เพื่อสร้างการดำเนินการ ไดเรกทอรี execroot แทนการสร้างแผนผังลิงก์สัญลักษณ์ หากเป็น "ใช่" ไบนารีที่ระบุโดย --experimental_sandboxfs_path ต้องเป็นค่าที่ถูกต้องและสอดคล้องกับ sandboxf เวอร์ชันที่รองรับ หากเป็น "auto" ไบนารีอาจหายไปหรือเข้ากันไม่ได้
แท็ก:host_machine_resource_optimizations
execution
- ค่าเริ่มต้น
--[no]experimental_use_windows_sandbox
: "เท็จ" - ใช้แซนด์บ็อกซ์ของ Windows เพื่อเรียกใช้การดำเนินการ หากเป็น "ใช่" ไบนารีที่ระบุโดย --experimental_windows_sandbox_path ต้องเป็นไฟล์ที่ถูกต้องและสอดคล้องกับ sandboxfs เวอร์ชันที่รองรับ หากเป็น "auto" ไบนารีอาจหายไปหรือเข้ากันไม่ได้
- ค่าเริ่มต้นของ
--experimental_windows_sandbox_path=<a string>
: "BazelSandbox.exe" - เส้นทางไปยังไบนารีแซนด์บ็อกซ์ของ Windows เพื่อใช้เมื่อ --experimental_use_windows_sandbox เป็นจริง หากเป็นชื่อเปล่า ให้ใช้ไบนารีแรกของชื่อที่พบใน PATH
- ค่าเริ่มต้น
--[no]experimental_worker_as_resource
: "เท็จ" -
หากเปิดใช้ ระบบจะดึงผู้ปฏิบัติงานเป็นทรัพยากรจาก ResourceManager
แท็ก:execution
host_machine_resource_optimizations
- ค่าเริ่มต้น
--[no]experimental_worker_cancellation
: "เท็จ" -
หากเปิดใช้ Bazel อาจส่งคำขอยกเลิกไปยังผู้ปฏิบัติงานที่ให้การสนับสนุน
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_worker_multiplex
: "true" -
หากเปิดใช้ ผู้ปฏิบัติงานที่รองรับฟีเจอร์การมัลติเพล็กซ์แบบทดลองจะใช้ฟีเจอร์ดังกล่าว
แท็ก:execution
host_machine_resource_optimizations
- ค่าเริ่มต้น
--[no]experimental_worker_multiplex_sandboxing
: "เท็จ" -
หากเปิดใช้ ระบบจะแซนด์บ็อกซ์ผู้ปฏิบัติงานมัลติเพล็กซ์โดยใช้ไดเรกทอรีแซนด์บ็อกซ์แยกต่างหากตามคำของาน เฉพาะผู้ปฏิบัติงานที่มี "supports- Multiplex-sandboxing" ข้อกำหนดการดำเนินการจะถูกแซนด์บ็อกซ์
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_worker_strict_flagfiles
: "เท็จ" -
หากเปิดใช้ อาร์กิวเมนต์การดำเนินการสำหรับผู้ปฏิบัติงานที่ไม่เป็นไปตามข้อกำหนดของผู้ปฏิบัติงานจะเกิดข้อผิดพลาด อาร์กิวเมนต์ผู้ปฏิบัติงานต้องมีอาร์กิวเมนต์ @flagfile เพียง 1 รายการเป็นรายการอาร์กิวเมนต์สุดท้าย
แท็ก:execution
- ค่าเริ่มต้นของ
--genrule_strategy=<comma-separated list of options>
: "" -
ระบุวิธีเรียกใช้ Genrule การแจ้งว่าไม่เหมาะสมนี้จะถูกนำออก ให้ใช้ --spawn_strategy=<value> แทน เพื่อควบคุมการดำเนินการทั้งหมด หรือ --strategy=Genrule=<value> เพื่อควบคุม Genrules เท่านั้น
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--high_priority_workers=<a string>
รายการ -
ความทรงจำของผู้ปฏิบัติงานที่จะทำงานโดยให้ความสำคัญสูง เมื่อผู้ปฏิบัติงานที่มีลำดับความสำคัญสูงทำงานอยู่ทั้งหมด ผู้ปฏิบัติงานคนอื่นๆ จะถูกควบคุม
แท็ก:execution
- ค่าเริ่มต้น
--[no]incompatible_remote_dangling_symlinks
: "true" -
หากตั้งค่าเป็น "จริง" และ --incompatible_remote_symlinks เป็นจริงเช่นกัน ระบบจะอนุญาตให้ลิงก์สัญลักษณ์ในเอาต์พุตการดำเนินการห้อยกัน
แท็ก:execution
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_remote_symlinks
: "true" -
หากตั้งค่าเป็น "จริง" Bazel จะแสดงลิงก์สัญลักษณ์ในเอาต์พุตการดำเนินการในโปรโตคอลการแคช/การดำเนินการระยะไกล มิฉะนั้น ลิงก์สัญลักษณ์จะถูกติดตามและแสดงเป็นไฟล์หรือไดเรกทอรี ดูรายละเอียดได้ที่ #6631
แท็ก:execution
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_sandbox_hermetic_tmp
: "เท็จ" -
หากตั้งค่าเป็น "จริง" แซนด์บ็อกซ์ของ Linux แต่ละรายการจะมีไดเรกทอรีว่างเฉพาะของตนเองต่อเชื่อมเป็น /tmp แทนที่จะแชร์ /tmp กับระบบไฟล์ของโฮสต์ ใช้ --sandbox_add_mount_pair=/tmp เพื่อดู /tmp ของโฮสต์ต่อไปในแซนด์บ็อกซ์ทั้งหมด
แท็ก:execution
- ค่าเริ่มต้น
--[no]internal_spawn_scheduler
: "เท็จ" -
ตัวเลือกตัวยึดตำแหน่งเพื่อให้เราสามารถบอกใน Blaze ว่าเครื่องจัดตารางเวลาสร้างได้เปิดใช้อยู่หรือไม่
แท็ก:execution
host_machine_resource_optimizations
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] ค่าเริ่มต้น: "อัตโนมัติ"-
จำนวนงานที่เกิดขึ้นพร้อมกันที่จะเรียกใช้ ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") โดยจะเลือกตามด้วยการดำเนินการ ([-|*]<Float>) เช่น "auto", "HOST_CPUS*.5" ค่าต้องอยู่ระหว่าง 1 ถึง 5000 ค่าที่สูงกว่า 2,500 อาจก่อให้เกิดปัญหาเกี่ยวกับหน่วยความจำ "อัตโนมัติ" จะคำนวณค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์
แท็ก:host_machine_resource_optimizations
execution
--[no]keep_going
[-k
] ค่าเริ่มต้น: "เท็จ"-
ดำเนินการต่อให้มากที่สุดหลังจากเกิดข้อผิดพลาด แม้ว่าเป้าหมายที่ล้มเหลวและเป้าหมายที่อ้างอิงอยู่จะไม่สามารถวิเคราะห์ได้ แต่ข้อกําหนดเบื้องต้นอื่นๆ ของเป้าหมายเหล่านี้อาจเป็นไปได้
แท็ก:eagerness_to_exit
- ค่าเริ่มต้น
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "อัตโนมัติ" -
จำนวนชุดข้อความแบบขนานที่จะใช้สำหรับขั้นตอนการโหลด/การวิเคราะห์ ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") หรือเลือกตามด้วยการดำเนินการ ([-|*]<Float>) เช่น "auto", "HOST_CPUS*.5" "อัตโนมัติ" ตั้งค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]reuse_sandbox_directories
: "เท็จ" -
หากตั้งค่าเป็น "จริง" ระบบอาจนำไดเรกทอรีที่ใช้โดยการดำเนินการที่ไม่ใช่ผู้ปฏิบัติงานโดยใช้แซนด์บ็อกซ์มาใช้ใหม่เพื่อหลีกเลี่ยงค่าใช้จ่ายที่ไม่จำเป็นในการตั้งค่า
แท็ก:host_machine_resource_optimizations
execution
- ค่าเริ่มต้นของ
--sandbox_base=<a string>
: "" -
อนุญาตให้แซนด์บ็อกซ์สร้างไดเรกทอรีแซนด์บ็อกซ์ของตนภายใต้เส้นทางนี้ ระบุเส้นทางบน tmpfs (เช่น /run/shm) เพื่ออาจปรับปรุงประสิทธิภาพได้อย่างมากเมื่อบิลด์ / การทดสอบของคุณมีไฟล์อินพุตจำนวนมาก หมายเหตุ: คุณต้องมี RAM และพื้นที่ว่างใน tmpfs เพียงพอที่จะเก็บเอาต์พุตและไฟล์กลางที่สร้างขึ้นโดยการเรียกใช้การดำเนินการ
แท็ก:host_machine_resource_optimizations
execution
- ค่าเริ่มต้น
--[no]sandbox_explicit_pseudoterminal
: "เท็จ" -
อนุญาตให้สร้าง Pseudoterminals สำหรับการดำเนินการแซนด์บ็อกซ์อย่างชัดเจน การใช้ Linux บางโปรแกรมต้องตั้งค่ารหัสกลุ่มของกระบวนการเป็น "tty" ภายในแซนด์บ็อกซ์เพื่อให้ Pseudoterminals ทำงาน หากการทำเครื่องหมายนี้ก่อให้เกิดปัญหา ให้ปิดการแจ้งปัญหานี้เพื่อให้ใช้งานกลุ่มอื่นๆ ได้
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--sandbox_tmpfs_path=<an absolute path>
รายการ -
สำหรับการดำเนินการที่ทำแซนด์บ็อกซ์ ให้ต่อเชื่อมไดเรกทอรีที่ว่างเปล่าซึ่งเขียนได้ไว้ที่เส้นทางสัมบูรณ์นี้ (หากการใช้แซนด์บ็อกซ์รองรับ และจะไม่พิจารณา มิฉะนั้น)
แท็ก:host_machine_resource_optimizations
execution
- ค่าเริ่มต้นของ
--spawn_strategy=<comma-separated list of options>
: "" -
ระบุวิธีการสร้างคำสั่งเริ่มต้น ยอมรับรายการกลยุทธ์ที่คั่นด้วยจุลภาคจากลำดับความสำคัญสูงสุดไปต่ำสุด สำหรับการกระทำแต่ละรายการ Bazel จะเลือกกลยุทธ์ที่มีลำดับความสำคัญสูงสุดที่สามารถกระทำได้ ค่าเริ่มต้นคือ "remote,worker,sandboxed,local" ดูรายละเอียดได้ที่ https://blog.bazel.build/2019/06/19/list-strategy.html
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--strategy=<a '[name=]value1[,..,valueN]' assignment>
รายการ -
ระบุวิธีการเผยแพร่การคอมไพล์การดำเนินการอื่นๆ ที่สร้างขึ้น ยอมรับรายการกลยุทธ์ที่คั่นด้วยจุลภาคจากลำดับความสำคัญสูงสุดไปต่ำสุด สำหรับการกระทำแต่ละรายการ Bazel จะเลือกกลยุทธ์ที่มีลำดับความสำคัญสูงสุดที่สามารถกระทำได้ ค่าเริ่มต้นคือ "remote,worker,sandboxed,local" แฟล็กนี้จะลบล้างค่าที่กำหนดโดย --spawn_strategy (และ --genrule_strategy หากใช้กับ mnemonic Genrule) ดูรายละเอียดได้ที่ https://blog.bazel.build/2019/06/19/list-strategy.html
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
รายการ -
ลบล้างกลยุทธ์การสร้างที่สร้างขึ้นเพื่อเรียกใช้การดำเนินการที่สร้างขึ้นซึ่งมีคำอธิบายตรงกับ regex_filter บางรายการ ดู --per_file_copt สำหรับรายละเอียดการจับคู่เกี่ยวกับนิพจน์ทั่วไป ระบบจะใช้ regex_filter รายการแรกที่ตรงกับคำอธิบาย ตัวเลือกนี้จะลบล้างแฟล็กอื่นๆ สำหรับการระบุกลยุทธ์ ตัวอย่าง: --strategy_regexp=//foo.*\.cc,-//foo/bar=local หมายถึงการเรียกใช้การดำเนินการโดยใช้กลยุทธ์ท้องถิ่นหากคำอธิบายตรงกับ //foo.*.cc แต่ไม่ตรงกับ //foo/bar ตัวอย่างเช่น --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed จะเรียกใช้ 'Compiling //foo/bar/baz' พร้อมแป้น "local" แต่การกลับลำดับคำสั่งซื้อจะทำงานด้วย "แซนด์บ็อกซ์"
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--worker_extra_flag=<a 'name=value' assignment>
รายการ -
แฟล็กคำสั่งเพิ่มเติมที่จะส่งผ่านไปยังกระบวนการของพนักงานนอกเหนือจาก --persistent_worker ซึ่งคีย์โดย Mnemonic (เช่น --worker_extra_flag=Javac=--debug
แท็ก:execution
host_machine_resource_optimizations
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--worker_max_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
รายการ -
อาจมีการเรียกใช้กระบวนการของผู้ปฏิบัติงาน (เช่น คอมไพเลอร์ Java ถาวร) หากคุณใช้ "ผู้ปฏิบัติงาน" ของคุณ อาจระบุเป็น [name=value] เพื่อให้ได้ค่าที่แตกต่างกันต่อการรับรู้ของผู้ปฏิบัติงาน ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") โดยจะเลือกตามด้วยการดำเนินการ ([-|*]<Float>) เช่น "auto", "HOST_CPUS*.5" "auto" จะคำนวณค่าเริ่มต้นที่สมเหตุสมผลตามความจุของเครื่อง "=ค่า" จะตั้งค่าเริ่มต้นสำหรับการช่วยจำที่ไม่ระบุ
แท็ก:execution
host_machine_resource_optimizations
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--worker_max_multiplex_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
รายการ -
จำนวนของ WorkRequest ที่ผู้ปฏิบัติงานมัลติเพล็กซ์จะได้รับพร้อมกันหากคุณใช้ "ผู้ปฏิบัติงาน" ด้วย --experimental_worker_multiplex อาจระบุเป็น [name=value] เพื่อให้ได้ค่าที่แตกต่างกันต่อการรับรู้ของผู้ปฏิบัติงาน ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") โดยจะเลือกตามด้วยการดำเนินการ ([-|*]<Float>) เช่น "auto", "HOST_CPUS*.5" "auto" จะคำนวณค่าเริ่มต้นที่สมเหตุสมผลตามความจุของเครื่อง "=ค่า" จะตั้งค่าเริ่มต้นสำหรับการช่วยจำที่ไม่ระบุ
แท็ก:execution
host_machine_resource_optimizations
- ค่าเริ่มต้น
--[no]worker_quit_after_build
: "เท็จ" -
หากเปิดใช้ ผู้ปฏิบัติงานทั้งหมดจะออกหลังจากบิลด์เสร็จสิ้น
แท็ก:execution
host_machine_resource_optimizations
- ค่าเริ่มต้น
--[no]worker_sandboxing
: "เท็จ" -
หากเปิดใช้ ผู้ปฏิบัติงานจะถูกดำเนินการในสภาพแวดล้อมแบบแซนด์บ็อกซ์
แท็ก:execution
- ค่าเริ่มต้น
--[no]worker_verbose
: "เท็จ" - หากเปิดใช้ พิมพ์ข้อความแบบละเอียดเมื่อผู้ปฏิบัติงานเริ่มงาน ปิดเครื่อง ...
- ตัวเลือกที่กำหนดค่า Toolchain ที่ใช้สำหรับการดำเนินการมีดังนี้
- ค่าเริ่มต้น
--[no]incompatible_disable_runtimes_filegroups
: "เท็จ" -
ไม่มีการดำเนินการที่เลิกใช้งาน
แท็ก:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_dont_emit_static_libgcc
: "true" -
ไม่มีการดำเนินการที่เลิกใช้งาน
แท็ก:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_linkopts_in_user_link_flags
: "true" -
ไม่มีการดำเนินการที่เลิกใช้งาน
แท็ก:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่งมีดังนี้
- ค่าเริ่มต้น
--[no]build
: "true" -
ดำเนินการสร้าง นี่เป็นลักษณะการทำงานปกติ การระบุ --nobuild จะทำให้บิลด์หยุดทำงานก่อนที่จะดำเนินการของบิลด์ ซึ่งแสดงผลเป็น 0 หากขั้นตอนการโหลดแพ็กเกจและการวิเคราะห์เสร็จสมบูรณ์ โหมดนี้มีประโยชน์ในการทดสอบระยะเหล่านั้น
แท็ก:execution
affects_outputs
- ค่าเริ่มต้น
--[no]experimental_run_validations
: "true" -
โปรดใช้ --run_Validations แทน
แท็ก:execution
affects_outputs
- ค่าเริ่มต้น
--[no]experimental_use_validation_aspect
: "เท็จ" -
เลือกว่าจะเรียกใช้การตรวจสอบโดยใช้มุมมอง (สำหรับการทำงานพร้อมกันกับการทดสอบ) หรือไม่
แท็ก:execution
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--output_groups=<comma-separated list of options>
รายการ -
รายการของชื่อกลุ่มเอาต์พุตที่คั่นด้วยคอมมา ซึ่งแต่ละรายการอาจนำหน้าด้วยเครื่องหมาย + หรือ - ระบบจะเพิ่มกลุ่มที่ขึ้นต้นด้วย + ลงในชุดกลุ่มเอาต์พุตเริ่มต้น ส่วนกลุ่มที่ขึ้นต้นด้วย - จะถูกนำออกจากชุดเริ่มต้น หากมีอย่างน้อย 1 กลุ่มที่ไม่มีคำนำหน้า ระบบจะละเว้นชุดกลุ่มเอาต์พุตเริ่มต้น ตัวอย่างเช่น --output_groups=+foo,+bar จะสร้างการรวมของชุดเริ่มต้น ได้แก่ foo และ bar ในขณะที่ --output_groups=foo,bar จะลบล้างชุดเริ่มต้นที่สร้างเฉพาะ foo และ bar
แท็ก:execution
affects_outputs
- ค่าเริ่มต้น
--[no]run_validations
: "true" -
ระบุว่าจะเรียกใช้การดำเนินการตรวจสอบเป็นส่วนหนึ่งของบิลด์หรือไม่ ดู https://bazel.build/rules/rules#Validation_actions
แท็ก:execution
affects_outputs
- เอาต์พุตที่ต้องการ ซึ่งส่งผลต่อค่าของผลลัพธ์ ไม่ใช่ค่าที่มีอยู่
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--aspects=<comma-separated list of options>
รายการ - รายการด้านที่คั่นด้วยจุลภาคที่จะนำไปใช้กับเป้าหมายระดับบนสุด ในรายการนี้ หากลักษณะ some_aspect ระบุผู้ให้บริการด้านที่จำเป็นผ่าน required_aspect_providers นั้น some_aspect จะทำงานหลังจากทุกด้านที่พูดถึงก่อนหน้าในรายการด้านที่ผู้ให้บริการด้านโฆษณาตอบสนองผู้ให้บริการด้านบางด้านที่จำเป็น นอกจากนี้ some_aspect จะทำงานหลังจากด้านที่ต้องระบุทั้งหมดที่ระบุไว้โดย required [แอตทริบิวต์] จากนั้น some_aspect จะมีสิทธิ์เข้าถึงคุณค่าของแง่มุมเหล่านั้น ผู้ให้บริการเครือข่าย <bzl-file-label>%<aspect_name> เช่น '//tools:my_def.bzl%my_aspect' โดยที่ 'my_aspect' เป็นค่าระดับบนสุดจากเครื่องมือไฟล์/my_def.bzl
- ค่าเริ่มต้น
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
จำนวนไฟล์เปิดสูงสุดที่อนุญาตระหว่างการอัปโหลดอาร์ติแฟกต์ BEP
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_convenience_symlinks
: "ปกติ" -
แฟล็กนี้ควบคุมวิธีจัดการลิงก์สัญลักษณ์ตามความสะดวก (ลิงก์สัญลักษณ์ที่ปรากฏในพื้นที่ทำงานหลังบิลด์) ค่าที่เป็นไปได้มีดังนี้
ปกติ (ค่าเริ่มต้น): ระบบจะสร้างหรือลบลิงก์สัญลักษณ์เพื่อความสะดวกแต่ละประเภทตามที่กำหนดโดยบิลด์
สะอาด: ลิงก์สัญลักษณ์ทั้งหมดจะถูกลบโดยไม่มีเงื่อนไข
เพิกเฉย: สัญลักษณ์ลิงก์จะไม่ปรากฏเพียงอย่างเดียว
log_only: สร้างข้อความบันทึกเสมือนเป็น "ปกติ" ผ่าน แต่ไม่ได้ดำเนินการเกี่ยวกับระบบไฟล์จริงๆ (มีประโยชน์สำหรับเครื่องมือ)
โปรดทราบว่าเฉพาะลิงก์สัญลักษณ์ที่มีชื่อที่สร้างขึ้นด้วยค่าปัจจุบันของ --symlink_prefix เท่านั้นที่อาจได้รับผลกระทบ หากคำนำหน้าเปลี่ยนไป ลิงก์สัญลักษณ์ที่มีอยู่แล้วก็จะถูกปล่อยไว้ตามเดิม
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_convenience_symlinks_bep_event
: "เท็จ" -
แฟล็กนี้ควบคุมว่าเราจะโพสต์เหตุการณ์บิลด์ConvenienceSymlinksIdentified ไปยัง BuildEventProtocol หรือไม่ หากค่าเป็น "จริง" BuildEventProtocol จะมีรายการ ConvesSymlinksIdentified ที่มีรายการลิงก์สัญลักษณ์แบบอำนวยความสะดวกทั้งหมดที่สร้างในพื้นที่ทำงานของคุณ หากเป็น "เท็จ" รายการ meetSymlinksIdentified ใน BuildEventProtocol จะว่างเปล่า
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_multi_cpu=<comma-separated list of options>
รายการ -
เลิกใช้งานแล้ว ไม่มีการดำเนินการ
แท็ก:affects_outputs
experimental
--remote_download_minimal
-
ไม่ดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลไปยังเครื่องภายใน แฟล็กนี้เป็นทางลัดสำหรับแฟล็ก: --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>
: "ทั้งหมด" -
หากตั้งค่าเป็น "ขั้นต่ำ" จะไม่ดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลไปยังเครื่องภายใน ยกเว้นเอาต์พุตที่การดำเนินการในเครื่องจำเป็นต้องใช้ หากตั้งค่าเป็น "ระดับบนสุด" แสดงตัวเหมือน "น้อยมาก" เว้นแต่ว่าจะดาวน์โหลดเอาต์พุตของเป้าหมายระดับบนสุดไปยังเครื่องภายในด้วย ตัวเลือกทั้ง 2 รายการจะช่วยลดเวลาบิลด์ได้อย่างมากหากแบนด์วิดท์ของเครือข่ายเป็นจุดคอขวด
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--remote_download_symlink_template=<a string>
: "" -
สร้างลิงก์สัญลักษณ์แทนการดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลไปยังเครื่องภายใน ระบุเป้าหมายของลิงก์สัญลักษณ์ในรูปแบบสตริงเทมเพลตได้ สตริงเทมเพลตนี้อาจมี {hash} และ {size_bytes} ที่ขยายเป็นแฮชของออบเจ็กต์และขนาดเป็นไบต์ตามลำดับ เช่น ลิงก์สัญลักษณ์เหล่านี้อาจชี้ไปยังระบบไฟล์ FUSE ที่โหลดออบเจ็กต์จาก CAS ตามคำขอ
แท็ก:affects_outputs
--remote_download_toplevel
-
ดาวน์โหลดเฉพาะเอาต์พุตระยะไกลของเป้าหมายระดับบนสุดไปยังเครื่องภายในเท่านั้น แฟล็กนี้เป็นทางลัดสำหรับแฟล็ก: --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
: "เท็จ" -
หากเปิดใช้งาน Bazel จะส่งธง --Privileified ไปยัง "Doker Run" เมื่อเรียกใช้การดำเนินการ การทำงานนี้อาจจำเป็นสำหรับงานสร้างของคุณ แต่ก็อาจส่งผลให้มีเนื้อที่น้อยลงด้วย
แท็ก:execution
- ค่าเริ่มต้นของ
--experimental_repository_hash_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรยืนยันแฮชของไดเรกทอรีที่เก็บ
แท็ก:affects_outputs
,experimental
- ค่าเริ่มต้น
--[no]experimental_sandboxfs_map_symlink_targets
: "เท็จ" -
หากจริง ให้แมปเป้าหมายของลิงก์สัญลักษณ์ที่ระบุเป็นอินพุตการดำเนินการลงในแซนด์บ็อกซ์ ฟีเจอร์นี้มีไว้เพื่อแก้ปัญหากฎที่มีข้อบกพร่องเท่านั้น ซึ่งจะไม่ดำเนินการดังกล่าวด้วยตนเอง และควรนำออกเมื่อกฎดังกล่าวทั้งหมดได้รับการแก้ไขแล้ว
แท็ก:host_machine_resource_optimizations
execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_verify_repository_rules=<a string>
รายการ -
หากรายการกฎที่เก็บควรยืนยันแฮชของไดเรกทอรีเอาต์พุต หากไฟล์ถูกระบุโดย --experimental_repository_hash_file
แท็ก:affects_outputs
experimental
- ค่าเริ่มต้น
--[no]incompatible_legacy_local_fallback
: "true" -
หากตั้งค่าเป็น "จริง" จะเปิดใช้วิดีโอสำรองโดยนัยแบบเดิมจากแซนด์บ็อกซ์เป็นกลยุทธ์ในเครื่อง แฟล็กนี้จะมีค่าเริ่มต้นเป็น "เท็จ" และจะกลายเป็น no-op ใช้ --strategy, --spawn_strategy หรือ --dynamic_local_strategy กำหนดค่าวิดีโอสำรองแทน
แท็ก:execution
incompatible_change
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--sandbox_add_mount_pair=<a single path or a 'source:target' pair>
รายการ -
เพิ่มคู่เส้นทางเพิ่มเติมเพื่อต่อเชื่อมในแซนด์บ็อกซ์
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--sandbox_block_path=<a string>
รายการ -
สำหรับการดำเนินการที่ทำแซนด์บ็อกซ์ โปรดอย่าอนุญาตการเข้าถึงนี้
แท็ก:execution
- ค่าเริ่มต้น
--[no]sandbox_default_allow_network
: "true" - อนุญาตการเข้าถึงเครือข่ายโดยค่าเริ่มต้นสำหรับการทำงาน ซึ่งอาจใช้ไม่ได้กับการใช้งานแซนด์บ็อกซ์บางประเภท
- ค่าเริ่มต้น
--[no]sandbox_fake_hostname
: "เท็จ" -
เปลี่ยนชื่อโฮสต์ปัจจุบันเป็น "localhost" สำหรับการดำเนินการที่ทำแซนด์บ็อกซ์
แท็ก:execution
- ค่าเริ่มต้น
--[no]sandbox_fake_username
: "เท็จ" -
เปลี่ยนชื่อผู้ใช้ปัจจุบันเป็น "nobody" สำหรับการดำเนินการที่ทำแซนด์บ็อกซ์
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--sandbox_writable_path=<a string>
รายการ -
สำหรับการดำเนินการที่ทำแซนด์บ็อกซ์ ให้ทำให้ไดเรกทอรีที่มีอยู่เขียนได้ในแซนด์บ็อกซ์ (หากการดำเนินการแซนด์บ็อกซ์รองรับ และจะไม่พิจารณาไดเรกทอรีอื่น)
แท็ก:execution
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
ไม่มีการดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ค่าเริ่มต้น
--[no]incompatible_config_setting_private_default_visibility
: "เท็จ" -
หากไม่รองรับ _enforce_config_setting_visibility=false ค่าจะเป็น Noop หรือไม่เช่นนั้น หากแฟล็กนี้เป็นเท็จ config_setting ใดๆ ที่ไม่มีแอตทริบิวต์การเปิดเผยอย่างชัดแจ้งจะเป็น //visibility:public หากแฟล็กนี้เป็นจริง config_setting จะใช้ตรรกะระดับการเข้าถึงเดียวกันกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_enforce_config_setting_visibility
: "true" -
หากเป็น "จริง" ให้บังคับใช้การจำกัดระดับการเข้าถึง config_setting หากเป็น "เท็จ" ทุก config_setting จะปรากฏแก่เป้าหมายทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
incompatible_change
- สภาพแวดล้อมการทดสอบหรือตัวดำเนินการทดสอบ:
- ค่าเริ่มต้น
--[no]check_tests_up_to_date
: "เท็จ" -
โดยไม่ต้องทำการทดสอบ เพียงแต่ต้องตรวจสอบว่าการทดสอบเป็นข้อมูลล่าสุดหรือไม่ หากผลการทดสอบทั้งหมดเป็นปัจจุบัน แสดงว่าการทดสอบเสร็จสมบูรณ์ หากต้องสร้างหรือดำเนินการทดสอบใดๆ ระบบจะรายงานข้อผิดพลาดและการทดสอบจะไม่สำเร็จ ตัวเลือกนี้กล่าวเป็นนัยถึงลักษณะการทำงาน --check_up_to_date
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
รายการ -
ในกรณีที่การทดสอบล้มเหลว ระบบจะพยายามทดสอบซ้ำจนถึงจำนวนครั้งที่ระบุไว้ การทดสอบที่ต้องผ่านมากกว่า 1 ครั้งจะมีการทำเครื่องหมายเป็น "FLAKY" ในสรุปการทดสอบ โดยปกติแล้ว ค่าที่ระบุจะเป็นแค่จำนวนเต็มหรือสตริง "ค่าเริ่มต้น" หากเป็นจำนวนเต็ม การทดสอบทั้งหมดจะทำงานได้ไม่เกิน N ครั้ง หากเป็น "ค่าเริ่มต้น" ระบบจะพยายามทดสอบเพียงครั้งเดียวสำหรับการทดสอบปกติ และอีก 3 ครั้งสำหรับการทดสอบที่มีการทำเครื่องหมายอย่างชัดแจ้งว่า "ไม่สม่ำเสมอ" ตามกฎ (แอตทริบิวต์ flaky=1) ไวยากรณ์อื่น: regex_filter@flaky_test_attempts flaky_test_attempts เหมือนกับข้างต้น และ regex_filter ย่อมาจากรายการรวมและยกเว้นรูปแบบนิพจน์ทั่วไป (โปรดดู --runs_per_test) ตัวอย่าง: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 ดีเฟลกการทดสอบทั้งหมดใน //foo/ ยกเว้นการทดสอบที่อยู่ภายใต้ foo/bar 3 ครั้ง ตัวเลือกนี้ส่งได้หลายครั้ง อาร์กิวเมนต์ที่ส่งผ่านล่าสุดที่ตรงกันจะมีความสำคัญเหนือกว่า หากไม่มีผลลัพธ์ที่ตรงกัน ลักษณะการทำงานจะเป็นเหมือน "ค่าเริ่มต้น" ที่ด้านบน
แท็ก:execution
- ค่าเริ่มต้น
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "อัตโนมัติ" -
จำนวนงานทดสอบในเครื่องที่จะเรียกใช้พร้อมกันสูงสุด ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") โดยจะเลือกตามด้วยการดำเนินการ ([-|*]<Float>) เช่น "auto", "HOST_CPUS*.5" 0 หมายความว่าทรัพยากรในเครื่องจะจำกัดจำนวนงานทดสอบในเครื่องที่จะเรียกใช้พร้อมกันแทน การตั้งค่านี้ที่มากกว่าค่าสำหรับ --jobs จะไม่มีผล
แท็ก:execution
- ค่าเริ่มต้น
--[no]test_keep_going
: "true" -
เมื่อปิดใช้ การทดสอบที่ไม่ผ่านจะทำให้ทั้งบิลด์หยุดทำงาน โดยค่าเริ่มต้น ระบบจะทำการทดสอบทั้งหมดแม้ว่าจะไม่ผ่านก็ตาม
แท็ก:execution
- ค่าเริ่มต้นของ
--test_strategy=<a string>
: "" -
ระบุกลยุทธ์ที่จะใช้เมื่อทำการทดสอบ
แท็ก:execution
- ค่าเริ่มต้น
--test_tmpdir=<a path>
: ดูคำอธิบาย - ระบุไดเรกทอรีชั่วคราวพื้นฐานสําหรับ "การทดสอบ Bazel" ในการใช้กัน
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันโมดูลในรูปแบบ "<module1>@<version1>,<module2>@<version2>" ซึ่งจะได้รับอนุญาตในกราฟทรัพยากร Dependency ที่ได้รับการแก้ไขแล้ว แม้ว่าจะมีการประกาศเวอร์ชันในรีจิสทรีในที่มาของเวอร์ชัน (หากไม่ได้มาจาก NonRegistryOverride) มิเช่นนั้น เวอร์ชันที่แยกออกมาจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันแยกที่อนุญาตด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" ได้ด้วย คุณสามารถปิดการตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้กับเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" ที่ส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" ให้พิมพ์คำเตือนเมื่อตรวจพบข้อมูลที่ไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟทรัพยากร Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" ให้พิมพ์คำเตือนเมื่อตรวจพบข้อมูลไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อยกระดับการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะไม่สนใจทรัพยากร Dependency สำหรับนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูทไม่ว่าค่าของแฟล็กนี้จะเป็นอะไร
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--lockfile_mode=<off, update or error>
: "อัปเดต" -
ระบุวิธีและวิธีใช้ล็อกไฟล์ ค่าที่ถูกต้องคือ "อัปเดต" เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง "ข้อผิดพลาด" ในการใช้ไฟล์ล็อกแต่เกิดข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" ไม่อ่านหรือเขียนไปยังไฟล์ล็อก
แท็ก:loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--override_module=<an equals-separated mapping of module name to path>
รายการ - ลบล้างโมดูลด้วยเส้นทางภายในในรูปแบบ <module name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์ ระบบจะใช้เส้นทางตามที่เป็น ถ้าเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพัทธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางดังกล่าวจะสัมพัทธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--registry=<a string>
รายการ -
ระบุรีจิสทรีที่จะใช้ในการค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับเป็นสิ่งสำคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีในภายหลังเมื่อไม่มีรีจิสทรีที่ขาดหายไป
แท็ก:changes_inputs
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
- ค่าเริ่มต้น
--[no]announce
: "เท็จ" -
เลิกใช้งานแล้ว ไม่มีการดำเนินการ
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]debug_spawn_scheduler
: "เท็จ" - ค่าเริ่มต้น
--[no]experimental_bep_target_summary
: "เท็จ" - ต้องการเผยแพร่เหตุการณ์ TargetSummary หรือไม่
- ค่าเริ่มต้น
--[no]experimental_build_event_expand_filesets
: "เท็จ" -
หากเป็น "จริง" ให้ขยายชุดไฟล์ใน BEP เมื่อนำเสนอไฟล์เอาต์พุต
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: "เท็จ" -
หากเป็น "จริง" ให้แปลค่าลิงก์สัญลักษณ์ของ Fileset สัมพัทธ์ทั้งหมดใน BEP เมื่อนำเสนอไฟล์เอาต์พุต ต้องมี --experimental_build_event_expand_filesset
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_build_event_upload_max_retries=<an integer>
: "4" -
จำนวนครั้งสูงสุดที่ Bazel ควรลองอัปโหลดเหตุการณ์บิลด์อีกครั้ง
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1s" -
เริ่มแรก ความล่าช้าขั้นต่ำสำหรับการลองใหม่แบบ Exponential Backoff เมื่ออัปโหลด BEP ไม่สำเร็จ (เลขชี้กำลัง: 1.6)
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--experimental_build_event_upload_strategy=<a string>
: ดูคำอธิบาย -
เลือกวิธีอัปโหลดอาร์ติแฟกต์ที่อ้างอิงในโปรโตคอลเหตุการณ์บิลด์
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_collect_local_sandbox_action_metrics
: "true" -
เมื่อเปิดใช้ ระบบจะบันทึกสถิติการดำเนินการ (เช่น ผู้ใช้และเวลาของระบบ) สำหรับการดำเนินการที่ทำในเครื่องซึ่งใช้แซนด์บ็อกซ์
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_docker_verbose
: "เท็จ" -
หากเปิดใช้ Bazel จะพิมพ์ข้อความที่มีรายละเอียดเกี่ยวกับกลยุทธ์แซนด์บ็อกซ์ของ Docker มากขึ้น
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_materialize_param_files_directly
: "เท็จ" -
หากทำให้ไฟล์พารามิเตอร์เป็นรูปธรรม ให้ดำเนินการดังกล่าวด้วยการเขียนไปยังดิสก์โดยตรง
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_record_metrics_for_all_mnemonics
: "เท็จ" - โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจำกัดอยู่ที่ 20 รายการที่มีการกระทำมากที่สุด การตั้งค่าตัวเลือกนี้จะเป็นการเขียนสถิติสำหรับการช่วยจำทั้งหมด
- ค่าเริ่มต้นของ
--experimental_repository_resolved_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้เขียนค่า Starlark พร้อมข้อมูลที่แก้ไขแล้วของกฎที่เก็บ Starlark ทั้งหมดที่ดำเนินการ
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_stream_log_file_uploads
: "เท็จ" -
สตรีมไฟล์บันทึกจะอัปโหลดไปยังพื้นที่เก็บข้อมูลระยะไกลโดยตรงแทนการเขียนลงดิสก์
แท็ก:affects_outputs
- ค่าเริ่มต้น
--explain=<a path>
: ดูคำอธิบาย -
ทำให้ระบบบิลด์อธิบายแต่ละขั้นตอนที่ดำเนินการแล้วของบิลด์ ระบบจะเขียนคำอธิบายลงในไฟล์บันทึกที่ระบุ
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]legacy_important_outputs
: "true" -
ใช้อาร์กิวเมนต์นี้เพื่อระงับการสร้างช่อง legal_outputs เดิมในเหตุการณ์ TargetComplete ต้องใช้ required_outputs สำหรับการผสานรวม Bazel กับ ResultStore
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]materialize_param_files
: "เท็จ" -
เขียนไฟล์พารามิเตอร์ระดับกลางไปยังโครงสร้างเอาต์พุตแม้ในขณะที่ใช้การดำเนินการจากระยะไกล มีประโยชน์เมื่อมีการแก้ไขข้อบกพร่อง ซึ่งหมายถึง --subcommands และ --verbose_failures
แท็ก:execution
- ค่าเริ่มต้น
--max_config_changes_to_show=<an integer>
: "3" -
เมื่อทิ้งแคชการวิเคราะห์เนื่องจากการเปลี่ยนแปลงตัวเลือกบิลด์ จะแสดงชื่อตัวเลือกที่มีการเปลี่ยนแปลงตามจำนวนที่กำหนด ถ้าตัวเลขที่ระบุคือ -1 ตัวเลือกที่มีการเปลี่ยนแปลงทั้งหมดจะแสดง
แท็ก:terminal_output
- ค่าเริ่มต้น
--max_test_output_bytes=<an integer>
: "-1" -
ระบุขนาดสูงสุดของบันทึกต่อการทดสอบที่ส่งได้เมื่อ --test_output คือ "ข้อผิดพลาด" หรือ "ทั้งหมด" มีประโยชน์เพื่อหลีกเลี่ยงเอาต์พุตที่ไม่ได้ทำให้เอาต์พุตการทดสอบมีเสียงดังรบกวนมากเกินไป ส่วนหัวการทดสอบจะรวมอยู่ในขนาดบันทึก ค่าลบหมายถึงไม่มีขีดจำกัด เอาต์พุตทั้งหมดหรือไม่มีเลย
แท็ก:test_runner
,terminal_output
,execution
- ค่าเริ่มต้น
--output_filter=<a valid Java regular expression>
: ดูคำอธิบาย -
แสดงเฉพาะคำเตือนสำหรับกฎที่มีชื่อตรงกับนิพจน์ทั่วไปที่ระบุเท่านั้น
แท็ก:affects_outputs
- ค่าเริ่มต้น
--progress_report_interval=<an integer in 0-3600 range>
: "0" -
จำนวนวินาทีระหว่างรายงานในงานที่ยังทำงานอยู่ ค่าเริ่มต้น 0 หมายความว่าระบบจะพิมพ์รายงานแรกหลังผ่านไป 10 วินาที จากนั้นจะแสดงเป็นเวลา 30 วินาที หลังจากนั้นจะมีการรายงานความคืบหน้า 1 ครั้งในทุกๆ นาที เมื่อเปิดใช้งาน --curses จะมีการรายงานความคืบหน้าทุกวินาที
แท็ก:affects_outputs
- ค่าเริ่มต้น
--remote_print_execution_messages=<failure, success or all>
: "ล้มเหลว" -
เลือกเวลาที่จะพิมพ์ข้อความการดำเนินการจากระยะไกล ค่าที่ใช้ได้คือ "ล้มเหลว" หากต้องการพิมพ์เมื่อล้มเหลวเท่านั้น "สำเร็จ" เพื่อพิมพ์เฉพาะเมื่อสำเร็จ และ "ทั้งหมด" เพื่อพิมพ์เสมอ
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]sandbox_debug
: "เท็จ" -
เปิดใช้ฟีเจอร์การแก้ไขข้อบกพร่องสำหรับฟีเจอร์แซนด์บ็อกซ์ ซึ่งรวมถึง 2 สิ่งต่อไปนี้ อย่างแรกคือ เนื้อหารูทของแซนด์บ็อกซ์จะไม่ต้องดำเนินการใดๆ หลังจากบิลด์ (และหากใช้ sandboxfs อยู่ ระบบไฟล์จะต่อเชื่อมไว้) และอย่างที่สอง พิมพ์ข้อมูลการแก้ไขข้อบกพร่องเพิ่มเติมในการเรียกใช้ ซึ่งจะช่วยให้นักพัฒนาซอฟต์แวร์ของกฎ Bazel หรือ Starlark แก้ไขข้อบกพร่องไม่สำเร็จเนื่องจากไม่มีไฟล์อินพุต ฯลฯ
แท็ก:terminal_output
- ค่าเริ่มต้น
--show_result=<an integer>
: "1" -
แสดงผลลัพธ์ของบิลด์ สำหรับแต่ละเป้าหมาย ให้ระบุว่าเป็นข้อมูลล่าสุดหรือไม่ และหากใช่ ให้แจ้งรายการไฟล์เอาต์พุตที่สร้างขึ้น ไฟล์ที่พิมพ์เป็นสตริงที่สะดวกสำหรับการคัดลอก+วางลงใน Shell เพื่อเรียกใช้ไฟล์
ตัวเลือกนี้ต้องใช้อาร์กิวเมนต์จำนวนเต็ม ซึ่งเป็นจำนวนเกณฑ์ของเป้าหมายด้านบนซึ่งระบบจะไม่พิมพ์ข้อมูลผลลัพธ์ ดังนั้น 0 จะทำให้มีการระงับข้อความและ MAX_INT จะทำให้มีการพิมพ์ผลลัพธ์เสมอ ค่าเริ่มต้นคือ 1
แท็ก:affects_outputs
--[no]subcommands
[-s
] ค่าเริ่มต้น: "เท็จ"-
แสดงคำสั่งย่อยที่ดำเนินการระหว่างบิลด์ แฟล็กที่เกี่ยวข้อง: --execution_log_json_file, --execution_log_binary_file (สำหรับการบันทึกคำสั่งย่อยไปยังไฟล์ในรูปแบบที่ง่ายต่อการใช้เครื่องมือ)
แท็ก:terminal_output
- ค่าเริ่มต้น
--test_output=<summary, errors, all or streamed>
: "summary" -
ระบุโหมดเอาต์พุตที่ต้องการ ค่าที่ถูกต้องคือ "summary" เพื่อแสดงเฉพาะสรุปสถานะการทดสอบ "ข้อผิดพลาด" เพื่อพิมพ์บันทึกการทดสอบสำหรับการทดสอบที่ล้มเหลวด้วย "ทั้งหมด" เพื่อพิมพ์บันทึกสำหรับการทดสอบทั้งหมดและ "สตรีม" เพื่อส่งออกบันทึกสำหรับการทดสอบทั้งหมดในแบบเรียลไทม์ (การดำเนินการนี้จะบังคับให้ดำเนินการทดสอบในเครื่องครั้งละ 1 รายการโดยไม่คำนึงถึงค่า --test_strategy)
แท็ก:test_runner
,terminal_output
,execution
- ค่าเริ่มต้นของ
--test_summary=<short, terse, detailed, none or testcase>
: "สั้น" -
ระบุรูปแบบของสรุปการทดสอบที่ต้องการ ค่าที่ถูกต้องคือ "short" เพื่อพิมพ์ข้อมูลเกี่ยวกับการทดสอบที่ดําเนินการเท่านั้น "แบบละเอียด" เพื่อพิมพ์เฉพาะข้อมูลเกี่ยวกับการทดสอบที่ดําเนินการไม่สําเร็จเท่านั้น เช่น "แบบละเอียด" เพื่อพิมพ์ข้อมูลโดยละเอียดเกี่ยวกับกรอบการทดสอบที่ล้มเหลว เช่น "testcase" เพื่อพิมพ์สรุปในการแก้ปัญหากรอบการทดสอบ อย่าพิมพ์ข้อมูลโดยละเอียดเกี่ยวกับกรอบการทดสอบที่ล้มเหลวและ "ไม่มี" ที่จะละเว้นข้อมูลสรุป
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]verbose_explanations
: "เท็จ" -
เพิ่มรายละเอียดของคำอธิบายที่ออกหากเปิดใช้ --explain จะไม่มีผล หากไม่ได้เปิดใช้งาน --explain
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]verbose_failures
: "เท็จ" -
หากเรียกใช้คำสั่งไม่สำเร็จ ให้พิมพ์บรรทัดคำสั่งแบบเต็ม
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--aspects_parameters=<a 'name=value' assignment>
รายการ -
ระบุค่าของพารามิเตอร์ด้านบรรทัดคำสั่ง ค่าพารามิเตอร์แต่ละรายการจะระบุผ่าน <param_name>=<param_value> เช่น 'my_param=my_val' ที่ "my_param" คือพารามิเตอร์ของบางด้านในรายการ --aspects รายการ หรือจำเป็นต้องใช้สำหรับด้านใดด้านหนึ่งในรายการ ตัวเลือกนี้ใช้ได้หลายครั้ง อย่างไรก็ตาม ไม่อนุญาตให้กำหนดค่าให้กับพารามิเตอร์เดียวกันมากกว่า 1 ครั้ง
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
หากไม่ว่างเปล่า ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ค่าเริ่มต้นของ
--target_pattern_file=<a string>
: "" -
ถ้ามีการตั้งค่า บิลด์จะอ่านรูปแบบจากไฟล์ที่มีชื่อที่นี่ แทนที่จะเป็นบรรทัดคำสั่ง การระบุไฟล์ที่นี่ รวมถึงรูปแบบบรรทัดคำสั่งเป็นข้อผิดพลาด
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
- ค่าเริ่มต้น
--experimental_circuit_breaker_strategy=<failure>
: ดูคำอธิบาย -
ระบุกลยุทธ์ที่เบรกเกอร์จะใช้ กลยุทธ์ที่ใช้ได้คือ "ความล้มเหลว" หากค่าที่ไม่ถูกต้องสำหรับตัวเลือก ลักษณะการทำงานเช่นเดียวกันกับตัวเลือกไม่ได้ตั้งค่า
แท็ก:execution
- ค่าเริ่มต้น
--experimental_downloader_config=<a string>
: ดูคำอธิบาย - ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด แต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือสองรูปแบบ รูปแบบหนึ่งจะจับคู่กัน และอีกรูปแบบหนึ่งใช้เป็น URL ทดแทน โดยมีการอ้างอิงกลับเริ่มตั้งแต่ "$1" เป็นไปได้ที่จะมีการใช้คำสั่ง "rewrite" หลายคำสั่งสำหรับ URL เดียวกัน และในกรณีนี้ระบบจะส่งคืน URL หลายรายการ
- ค่าเริ่มต้น
--[no]experimental_guard_against_concurrent_changes
: "เท็จ" - ปิดการตั้งค่านี้เพื่อปิดใช้การตรวจสอบเวลาของไฟล์อินพุตของการดำเนินการก่อนอัปโหลดไปยังแคชระยะไกล ในบางกรณีที่เคอร์เนลของ Linux จะหน่วงเวลาการเขียนไฟล์ ซึ่งอาจทำให้เกิดผลบวกลวง
- ค่าเริ่มต้น
--experimental_remote_build_event_upload=<all or minimal>
: "ทั้งหมด" - หากตั้งค่าเป็น "all" ระบบจะอัปโหลดเอาต์พุตในเครื่องทั้งหมดที่ BEP อ้างอิงไปยังแคชระยะไกล หากตั้งค่าเป็น "ค่าต่ำสุด" ระบบจะไม่อัปโหลดเอาต์พุตในเครื่องที่ BEP อ้างอิงไปยังแคชระยะไกล ยกเว้นไฟล์ที่มีความสำคัญต่อผู้บริโภคของ BEP (เช่น บันทึกการทดสอบและโปรไฟล์เวลา) รูปแบบ Bystream:// จะใช้สำหรับ uri ของไฟล์เสมอ แม้ว่าจะไม่มีในแคชระยะไกลก็ตาม โดยจะมีค่าเริ่มต้นเป็น "all"
- ค่าเริ่มต้น
--[no]experimental_remote_cache_async
: "เท็จ" - หากเป็น "จริง" I/O ของแคชระยะไกลจะเกิดขึ้นในเบื้องหลังแทนที่จะเกิดขึ้นเป็นส่วนที่สร้างขึ้น
- ค่าเริ่มต้น
--[no]experimental_remote_cache_compression
: "เท็จ" - หากเปิดใช้ ให้บีบอัด/ยกเลิกการบีบอัด 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
: "เท็จ" - หากตั้งค่าเป็น "จริง" ให้ทิ้งสำเนาในหน่วยความจำของโครงสร้าง Merkle ของรูทอินพุตและการแมปอินพุตที่เกี่ยวข้องระหว่างการเรียก GetActionResult() และ Execute() ซึ่งช่วยลดการใช้งานหน่วยความจำได้อย่างมาก แต่จะต้องให้ Bazel คํานวณใหม่เมื่อมีการไม่พบแคชระยะไกลหรือลองอีกครั้ง
- ค่าเริ่มต้น
--experimental_remote_downloader=<a string>
: ดูคำอธิบาย - URI ปลายทางของ Remote Asset API ที่จะใช้เป็นพร็อกซีการดาวน์โหลดระยะไกล สคีมาที่รองรับ ได้แก่ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (ซ็อกเก็ต UNIX ในเครื่อง) หากไม่ได้ระบุสคีมา Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ดูที่ https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.เลือก
- ค่าเริ่มต้น
--[no]experimental_remote_downloader_local_fallback
: "เท็จ" - กลับไปใช้เครื่องมือดาวน์โหลดในเครื่องหรือไม่หากโปรแกรมดาวน์โหลดระยะไกลล้มเหลว
- ค่าเริ่มต้น
--[no]experimental_remote_execution_keepalive
: "เท็จ" - ต้องการใช้ Keepalive สำหรับการเรียกใช้การดำเนินการระยะไกลหรือไม่
- ค่าเริ่มต้น
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
: "10" -
ตั้งค่าจำนวนอัตราความล้มเหลวที่อนุญาตเป็นเปอร์เซ็นต์สำหรับกรอบเวลาที่เจาะจงหลังจากหยุดเรียกใช้แคช/ผู้ดำเนินการระยะไกล ค่าเริ่มต้นคือ 10 การตั้งค่านี้เป็น 0 หมายความว่าไม่มีข้อจำกัด
แท็ก:execution
- ค่าเริ่มต้นของ
--experimental_remote_failure_window_interval=<An immutable length of time.>
: "60 วินาที" -
ช่วงเวลาที่มีการคำนวณอัตราความล้มเหลวของคำขอระยะไกล หากค่าเป็น 0 หรือค่าลบ ระบบจะคำนวณระยะเวลาความล้มเหลวตลอดทั้งระยะเวลาในการดำเนินการ หน่วยต่อไปนี้สามารถใช้ได้ ได้แก่ วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_remote_mark_tool_inputs
: "เท็จ" - หากตั้งค่าเป็น "จริง" Bazel จะทำเครื่องหมายอินพุตเป็นอินพุตเครื่องมือสำหรับผู้ดำเนินการระยะไกล โดยจะนำไปใช้ติดตั้งใช้งานผู้ปฏิบัติงานที่ทำงานถาวรจากระยะไกลได้
- ค่าเริ่มต้น
--[no]experimental_remote_merkle_tree_cache
: "เท็จ" - หากตั้งค่าเป็น "จริง" ระบบจะบันทึกการคำนวณต้นไม้ Merkle เพื่อปรับปรุงความเร็วในการตรวจสอบ Hit ของแคชระยะไกล การพิมพ์พื้นที่หน่วยความจำของแคชจะควบคุมโดย --experimental_remote_merkle_tree_cache_size
- ค่าเริ่มต้น
--experimental_remote_merkle_tree_cache_size=<a long integer>
: "1000" - จำนวนต้น Merkle ที่จะบันทึกเพื่อปรับปรุงความเร็วในการตรวจสอบการเข้าถึงแคชระยะไกล แม้ว่าแคชจะถูกตัดทอนโดยอัตโนมัติตามการจัดการการอ้างอิงแบบซอฟต์ของ Java แต่ข้อผิดพลาดจากหน่วยความจำไม่เพียงพอก็อาจเกิดขึ้นได้หากตั้งค่าสูงเกินไป หากตั้งค่าเป็น 0 ระบบจะไม่จำกัดขนาดของแคช ค่าที่ดีที่สุดจะแตกต่างกันไปตามขนาดของโปรเจ็กต์ โดยมีค่าเริ่มต้นเป็น 1,000
- ค่าเริ่มต้น
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "เท็จ" - หากตั้งค่าเป็น "จริง" ระบบจะไม่อัปโหลดเอาต์พุตที่ BEP อ้างอิงไปยังแคชระยะไกล หากการดำเนินการที่สร้างไม่สามารถแคชจากระยะไกลได้
- ค่าเริ่มต้น
--[no]incompatible_remote_downloader_send_all_headers
: "true" -
เลือกว่าจะส่งค่าทั้งหมดของส่วนหัวที่มีหลายค่าไปยังโปรแกรมดาวน์โหลดระยะไกลแทนที่จะส่งเฉพาะค่าแรกหรือไม่
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_remote_output_paths_relative_to_input_root
: "เท็จ" -
หากตั้งค่าเป็น "จริง" เส้นทางเอาต์พุตจะสัมพัทธ์กับรูทอินพุตแทนที่จะเป็นไดเรกทอรีที่ใช้งานได้
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_remote_results_ignore_disk
: "true" -
หากตั้งค่าเป็น "จริง" --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
: "เท็จ" -
หากตั้งค่าเป็น "จริง" Bazel จะใช้โค้ดสำหรับออกใหม่ 39 แทน 34 หากแคชระยะไกลนำ BLOB ออกระหว่างบิลด์
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]remote_accept_cached
: "true" - เลือกว่าจะยอมรับผลการดำเนินการที่แคชไว้จากระยะไกลหรือไม่
- ค่าเริ่มต้น
--remote_bytestream_uri_prefix=<a string>
: ดูคำอธิบาย - ชื่อโฮสต์และชื่ออินสแตนซ์ที่จะใช้ใน URI ของ bytesstream:// ซึ่งเขียนลงในสตรีมเหตุการณ์ของบิลด์ ตัวเลือกนี้สามารถตั้งค่าได้เมื่อดำเนินการบิลด์โดยใช้พร็อกซี ซึ่งทำให้ค่าของ --remote_executor และ --remote_instance_name ไม่ตรงกับชื่อ Canonical ของบริการการดำเนินการระยะไกลอีกต่อไป หากไม่ได้ตั้งค่า จะมีค่าเริ่มต้นเป็น "${ชื่อโฮสต์}/${instance_name}"
- ค่าเริ่มต้น
--remote_cache=<a string>
: ดูคำอธิบาย - URI ของปลายทางการแคช สคีมาที่รองรับ ได้แก่ http, https, grpc, grpcs (grpc ที่เปิดใช้ TLS) และ unix (local UNIX Sockets) หากไม่ได้ระบุสคีมา Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุสคีมา grpc://, http:// หรือ unix: เพื่อปิดใช้ TLS ดู https://bazel.build/remote/caching
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--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 หากระบุ บันทึกนี้ประกอบด้วยลำดับของ com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry protobufs ของแบบต่อเนื่อง โดยแต่ละข้อความจะมีคำนำหน้าเป็น varint ซึ่งแสดงขนาดของข้อความ protocolbuf แบบต่อเนื่องต่อไปนี้ โดยใช้เมธอด LogEntry.writeDelimitedTo(OutputStream)
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--remote_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอ: --remote_header=Name=Value สามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- ค่าเริ่มต้นของ
--remote_instance_name=<a string>
: "" - ค่าที่จะส่งผ่านเป็นอินสแตนซ์_name ใน API การดำเนินการระยะไกล
- ค่าเริ่มต้น
--[no]remote_local_fallback
: "เท็จ" - กลับไปใช้กลยุทธ์การดำเนินการภายในเครื่องแบบสแตนด์อโลนหรือไม่ หากการดำเนินการจากระยะไกลล้มเหลว
- ค่าเริ่มต้น
--remote_local_fallback_strategy=<a string>
: "ท้องถิ่น" - ไม่มีการดำเนินการ เลิกใช้งานแล้ว ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7480
- ค่าเริ่มต้น
--remote_max_connections=<an integer>
: "100" -
จำกัดจำนวนการเชื่อมต่อพร้อมกันสูงสุดให้กับแคช/ผู้ดำเนินการระยะไกล ค่าเริ่มต้นคือ 100 การตั้งค่านี้เป็น 0 หมายความว่าไม่มีข้อจำกัด
สำหรับแคชระยะไกล HTTP การเชื่อมต่อ TCP 1 รายการสามารถจัดการคำขอได้ครั้งละ 1 รายการ ดังนั้น Bazel สามารถสร้างคำขอพร้อมกันได้สูงสุด --remote_max_connections
สำหรับแคช/ผู้ดำเนินการระยะไกล gRPC ช่อง gRPC หนึ่งช่องมักจะรองรับคำขอพร้อมกันได้มากกว่า 100 คำขอ ดังนั้น Bazel จึงสามารถสร้างคำขอพร้อมกันประมาณ "--remote_max_connections * 100"
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้น
--remote_proxy=<a string>
: ดูคำอธิบาย - เชื่อมต่อกับแคชระยะไกลผ่านพร็อกซี ปัจจุบัน Flag นี้สามารถใช้เพื่อกำหนดค่า Socket ของโดเมน Unix (unix:/path/to/socket) เท่านั้น
- ค่าเริ่มต้น
--remote_result_cache_priority=<an integer>
: "0" - ลำดับความสำคัญที่เกี่ยวข้องของการดำเนินการระยะไกลที่จะจัดเก็บในแคชระยะไกล ความหมายของค่าลำดับความสำคัญหนึ่งๆ จะขึ้นอยู่กับเซิร์ฟเวอร์
- ค่าเริ่มต้น
--remote_retries=<an integer>
: "5" - จำนวนสูงสุดของความพยายามที่จะลองแก้ไขข้อผิดพลาดชั่วคราวอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
- ค่าเริ่มต้น
--remote_retry_max_delay=<An immutable length of time.>
: "5s" - การหน่วงเวลา Backoff สูงสุดระหว่างการพยายามลองอีกครั้งจากระยะไกล คุณสามารถใช้หน่วยต่อไปนี้: วัน (d), ชั่วโมง (h), นาที (m), วินาที และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
- ค่าเริ่มต้นของ
--remote_timeout=<An immutable length of time.>
: "60 วินาที" - ระยะเวลาสูงสุดในการรอการเรียกใช้จากระยะไกลและการเรียกใช้แคช สำหรับแคช REST นี่คือทั้งการเชื่อมต่อและระยะหมดเวลาในการอ่าน คุณสามารถใช้หน่วยต่อไปนี้: วัน (d), ชั่วโมง (h), นาที (m), วินาที และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
- ค่าเริ่มต้น
--[no]remote_upload_local_results
: "true" - เลือกว่าจะอัปโหลดผลลัพธ์การดำเนินการที่ดำเนินการในเครื่องไปยังแคชระยะไกลหรือไม่ หากแคชระยะไกลรองรับ และผู้ใช้ได้รับอนุญาตให้ดำเนินการดังกล่าว
- ค่าเริ่มต้น
--[no]remote_verify_downloads
: "true" - หากตั้งค่าเป็น "จริง" Bazel จะคำนวณจำนวนแฮชของการดาวน์โหลดระยะไกลทั้งหมด และทิ้งค่าที่แคชไว้จากระยะไกลหากไม่ตรงกับค่าที่คาดไว้
- ตัวเลือกเบ็ดเตล็ด ที่ยังไม่ได้รับการแยกประเภท:
- ค่าเริ่มต้น
--auto_output_filter=<none, all, packages or subpackages>
: "ไม่มี" - หากไม่ได้ระบุ --output_filter ระบบจะใช้ค่าของตัวเลือกนี้ในการสร้างตัวกรองโดยอัตโนมัติ ค่าที่ใช้ได้คือ "none" (ไม่ต้องกรอง / แสดงทุกอย่าง), "ทั้งหมด" (กรองทุกอย่าง / ไม่แสดงอะไรเลย), "แพ็กเกจ" (รวมเอาต์พุตจากกฎในแพ็กเกจที่กล่าวถึงในบรรทัดคำสั่ง Blaze) และ "แพ็กเกจย่อย" (เช่น "แพ็กเกจ" แต่รวมแพ็กเกจย่อยด้วย) สำหรับ "แพ็กเกจ" และ "แพ็กเกจย่อย" //java/foo และ //javatests/foo จะถือว่าเป็น 1 แพ็กเกจ)'
- ค่าเริ่มต้น
--[no]build_manual_tests
: "เท็จ" - บังคับใช้เป้าหมายการทดสอบที่ติดแท็ก "ด้วยตนเอง" ให้เกิดขึ้นจริง "ด้วยตนเอง" การทดสอบจะไม่รวมอยู่ในการประมวลผล ตัวเลือกนี้จะบังคับให้ระบบสร้างรายงาน (แต่ไม่ต้องดำเนินการ)
- ค่าเริ่มต้นของ
--build_tag_filters=<comma-separated list of options>
: "" - ระบุรายการแท็กที่คั่นด้วยคอมมา แต่ละแท็กสามารถขึ้นต้นด้วย "-" หรือไม่ก็ได้ เพื่อระบุแท็กที่ยกเว้น ระบบจะสร้างเฉพาะเป้าหมายเหล่านั้นซึ่งมีแท็กที่รวมอยู่อย่างน้อย 1 แท็กและไม่มีแท็กที่ยกเว้น ตัวเลือกนี้ไม่มีผลกับชุดการทดสอบที่ดำเนินการด้วยคำสั่ง "test" (ทดสอบ) คำสั่ง; การควบคุมเหล่านั้นจะอยู่ภายใต้ตัวเลือกการกรองทดสอบ เช่น "--test_tag_filters"
- ค่าเริ่มต้น
--[no]build_tests_only
: "เท็จ" - หากระบุ ระบบจะสร้างเฉพาะกฎ *_test และ test_suite และจะไม่สนใจเป้าหมายอื่นๆ ที่ระบุในบรรทัดคำสั่ง โดยค่าเริ่มต้น ทุกอย่างที่ขอจะได้รับการสร้าง
- ค่าเริ่มต้น
--combined_report=<none or lcov>
: "ไม่มี" - ระบุประเภทรายงานความครอบคลุมสะสมที่ต้องการ ขณะนี้ระบบรองรับเฉพาะ LCOV เท่านั้น
- ค่าเริ่มต้น
--[no]compile_one_dependency
: "เท็จ" - คอมไพล์ทรัพยากร Dependency เดียวของไฟล์อาร์กิวเมนต์ วิธีนี้มีประโยชน์ในการตรวจสอบไฟล์แหล่งที่มาใน IDE เช่น การสร้างเป้าหมายเดี่ยวขึ้นมาใหม่ให้อาศัยไฟล์ต้นฉบับ เพื่อตรวจหาข้อผิดพลาดให้เร็วที่สุดในรอบการแก้ไข/สร้าง/ทดสอบ อาร์กิวเมนต์นี้จะส่งผลต่อวิธีการตีความอาร์กิวเมนต์แบบไม่แจ้งทั้งหมด แทนที่จะกำหนดเป้าหมายในการสร้างเป็นชื่อไฟล์ต้นฉบับ สำหรับชื่อไฟล์ต้นฉบับแต่ละชื่อไฟล์ จะมีเป้าหมายที่กำหนดเองที่ขึ้นอยู่กับไฟล์ดังกล่าว
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--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 หรือพารามิเตอร์การตรวจสอบสิทธิ์ไปยัง identifier_ctx.download และ sample_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 เพื่อล้างแคช คำสั่งล้างจะล้างแคชเสมอ โดยไม่คำนึงถึงแฟล็กนี้
- ค่าเริ่มต้น
--credential_helper_timeout=<An immutable length of time.>
: "10 วินาที" - กำหนดค่าการหมดเวลาสำหรับตัวช่วยข้อมูลเข้าสู่ระบบ ตัวช่วยข้อมูลเข้าสู่ระบบที่ไม่ตอบกลับภายในระยะหมดเวลานี้จะเรียกใช้ไม่สําเร็จ
- ค่าเริ่มต้นของ
--deleted_packages=<comma-separated list of package names>
: "" - รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริงแม้ว่าจะปรากฏอยู่ที่ใดที่หนึ่งบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ เช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์ ระบบบิลด์อาจบ่นหากพบป้ายกำกับ "//x:y/z" ถ้ามีข้อมูลระบุโดยรายการpackage_path อื่นอยู่ การระบุ --deleted_packages x/y ช่วยป้องกันปัญหานี้
- ค่าเริ่มต้น
--[no]discard_analysis_cache
: "เท็จ" - ทิ้งแคชการวิเคราะห์ทันทีหลังจากที่ขั้นตอนการวิเคราะห์เสร็จสมบูรณ์แล้ว ลดการใช้งานหน่วยความจำประมาณ 10% แต่ทำให้บิลด์เพิ่มเติมช้าลง
- ค่าเริ่มต้น
--disk_cache=<a path>
: ดูคำอธิบาย - เส้นทางไปยังไดเรกทอรีที่ Bazel อ่านและเขียนการดำเนินการและเอาต์พุตการดำเนินการได้ หากไม่มีไดเรกทอรี ระบบจะสร้างไดเรกทอรีให้
- ค่าเริ่มต้นของ
--embed_label=<a one-line string>
: "" - ฝังการแก้ไขการควบคุมแหล่งที่มาหรือป้ายกำกับรุ่นในไบนารี
- ค่าเริ่มต้น
--execution_log_binary_file=<a path>
: ดูคำอธิบาย - บันทึกการสร้างที่เรียกใช้ลงในไฟล์นี้เป็น Prot ของการสร้างเมืองที่คั่นด้วยข้อความตาม src/main/protocolbuf/spawn.protocol บันทึกจะมีการเขียนเป็นลำดับแรกโดยไม่เรียงลำดับ จากนั้นเมื่อสิ้นสุดการเรียกใช้ ระบบจะจัดเรียงตามลำดับที่เสถียร (อาจเป็น CPU และการใช้หน่วยความจำ) แฟล็กที่เกี่ยวข้อง: --execution_log_json_file (รูปแบบ json ของข้อความตามลำดับ), --experimental_execution_log_file (รูปแบบไบนารี Protobuf ที่ไม่เรียงลำดับ), --คำสั่งย่อย (สำหรับการแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
- ค่าเริ่มต้น
--execution_log_json_file=<a path>
: ดูคำอธิบาย - บันทึกคำสั่งสร้างที่เรียกใช้ลงในไฟล์นี้ในรูปแบบ json ของโปรโตคอล Spawn ที่คั่นด้วยอักขระ ตาม src/main/processbuf/spawn.protocol บันทึกจะมีการเขียนเป็นลำดับแรกโดยไม่เรียงลำดับ จากนั้นเมื่อสิ้นสุดการเรียกใช้ ระบบจะจัดเรียงตามลำดับที่เสถียร (อาจเป็น CPU และการใช้หน่วยความจำ) แฟล็กที่เกี่ยวข้อง: แฟล็กที่เกี่ยวข้อง: --execution_log_binary_file (รูปแบบไบนารีของโปรโตคอลที่เรียงลำดับ), --experimental_execution_log_file (รูปแบบไบนารีโปรโตบูฟที่ไม่เรียงลำดับ), --คำสั่งย่อย (สำหรับการแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
- ค่าเริ่มต้น
--[no]execution_log_sort
: "true" - เลือกว่าจะจัดเรียงบันทึกการดำเนินการหรือไม่ ตั้งค่าเป็น "เท็จ" เพื่อปรับปรุงประสิทธิภาพของหน่วยความจำ โดยใช้ต้นทุนในการสร้างบันทึกตามลำดับที่ไม่กำหนด
- ค่าเริ่มต้น
--[no]expand_test_suites
: "true" -
ขยายเป้าหมาย test_suite ไปยังการทดสอบส่วนประกอบก่อนการวิเคราะห์ เมื่อเปิดธงนี้ (ค่าเริ่มต้น) ระบบจะใช้รูปแบบเป้าหมายเชิงลบกับการทดสอบที่เป็นของชุดทดสอบ มิฉะนั้น ระบบจะไม่ใช้รูปแบบเป้าหมายเชิงลบ การปิดแฟล็กนี้มีประโยชน์เมื่อใช้ระดับบนสุดในบรรทัดคำสั่ง จากนั้นผู้ใช้จึงวิเคราะห์เป้าหมาย test_suite ได้
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--experimental_execution_log_file=<a path>
: ดูคำอธิบาย - บันทึกการสร้างที่เรียกใช้ลงในไฟล์นี้เป็น Prot ของการสร้างเมืองที่คั่นด้วยข้อความตาม src/main/protocolbuf/spawn.protocol ไฟล์นี้เขียนตามลำดับการดำเนินการของตัววางไข่ แฟล็กที่เกี่ยวข้อง: --execution_log_binary_file (รูปแบบไบนารีของโปรโตคอลที่เรียงลำดับ), --execution_log_json_file (รูปแบบ json ของข้อความตามลำดับ), --subcommands (สำหรับการแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
- ค่าเริ่มต้น
--[no]experimental_execution_log_spawn_metrics
: "เท็จ" - รวมเมตริกที่สร้างขึ้นในบันทึกการสร้างที่ดำเนินการแล้ว
- ค่าเริ่มต้นของ
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "" - เลิกใช้งานไปทีละด้าน ชุดตัวกรองเป้าหมายเพื่อตั้งเวลา extra_actions
- ค่าเริ่มต้น
--[no]experimental_extra_action_top_level_only
: "เท็จ" - เลิกใช้งานไปทีละด้าน ตั้งเวลาให้เฉพาะการดำเนินการเพิ่มเติมสำหรับเป้าหมายระดับบนสุดเท่านั้น
- ค่าเริ่มต้น
--[no]experimental_prioritize_local_actions
: "true" -
หากตั้งค่าไว้ การดำเนินการที่เรียกใช้ได้ในเครื่องเท่านั้นจะได้รับโอกาสแรกในการรับทรัพยากร โอกาสสำหรับผู้ปฏิบัติงานที่เรียกใช้แบบไดนามิกจะได้รับโอกาสครั้งที่ 2 และการดำเนินการแบบสแตนด์อโลนที่เรียกใช้แบบไดนามิกจะเป็นอันดับสุดท้าย
แท็ก:execution
--experimental_spawn_scheduler
-
เปิดใช้การดำเนินการแบบไดนามิกโดยเรียกใช้การดำเนินการภายในเครื่องและจากระยะไกลพร้อมกัน Bazel สร้างการดำเนินการแต่ละอย่างไว้ภายในเครื่องและจากระยะไกล แล้วเลือกการดำเนินการที่เสร็จสิ้นก่อน หากการดำเนินการรองรับผู้ปฏิบัติงาน การดำเนินการเฉพาะเครื่องจะทำงานในโหมดผู้ปฏิบัติงานถาวร หากต้องการเปิดใช้การดำเนินการแบบไดนามิกสำหรับหน่วยความจำการดำเนินการแต่ละรายการ ให้ใช้แฟล็ก "--internal_spawn_scheduler" และ "--strategy=<mnemonic>=dynamic" แทน
ขยายเป็น
--internal_spawn_scheduler
--spawn_strategy=dynamic
- ค่าเริ่มต้น
--google_auth_scopes=<comma-separated list of options>
: "https://www.googleapis.com/auth/cloud-platform" - รายการขอบเขตการตรวจสอบสิทธิ์ Google Cloud ที่คั่นด้วยคอมมา
- ค่าเริ่มต้น
--google_credentials=<a string>
: ดูคำอธิบาย - ระบุไฟล์ที่จะรับข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication
- ค่าเริ่มต้น
--[no]google_default_credentials
: "เท็จ" - จะใช้ "ข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชันของ Google" หรือไม่ เพื่อตรวจสอบสิทธิ์ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication ปิดใช้โดยค่าเริ่มต้น
- ค่าเริ่มต้น
--grpc_keepalive_time=<An immutable length of time.>
: ดูคำอธิบาย - กำหนดค่าคำสั่ง ping แบบ Keep-alive สำหรับการเชื่อมต่อ gRPC ขาออก หากตั้งค่าไว้ Bazel จะส่งคำสั่ง ping หลังจากไม่มีการดำเนินการอ่านในการเชื่อมต่อเป็นเวลานาน แต่เฉพาะเมื่อมีการเรียกใช้ gRPC ที่รอดำเนินการอย่างน้อย 1 ครั้ง เวลาจะถือว่าเป็นรายละเอียดที่ 2 การตั้งค่าน้อยกว่า 1 วินาทีเป็นข้อผิดพลาด โดยค่าเริ่มต้น ระบบจะปิดใช้คําสั่ง ping ของ Keep-alive ไว้ คุณควรประสานงานกับเจ้าของบริการก่อนเปิดใช้การตั้งค่านี้ ตัวอย่างเช่น หากต้องการกำหนดค่า 30 วินาทีให้กับแฟล็กนี้ ก็ควรทำแบบนี้ --grpc_keepalive_time=30s
- ค่าเริ่มต้นของ
--grpc_keepalive_timeout=<An immutable length of time.>
: "20 วินาที" - กำหนดค่าระยะหมดเวลาแบบ Keep-alive สำหรับการเชื่อมต่อ gRPC ขาออก หากเปิดใช้งานคําสั่ง ping ตลอดเวลาด้วย --grpc_keepalive_time แล้ว Bazel จะหมดเวลาการเชื่อมต่อหากไม่ได้รับคําสั่ง ping หลังจากผ่านไประยะหนึ่ง เวลาจะถือว่าเป็นรายละเอียดที่ 2 การตั้งค่าน้อยกว่า 1 วินาทีเป็นข้อผิดพลาด หากปิดการใช้คําสั่ง ping ของ Keep-alive การตั้งค่านี้จะไม่มีผล
- ค่าเริ่มต้น
--[no]ignore_unsupported_sandboxing
: "เท็จ" - ไม่ต้องพิมพ์คำเตือนเมื่อระบบนี้ไม่รองรับการดำเนินการแบบแซนด์บ็อกซ์
- ค่าเริ่มต้น
--[no]incompatible_dont_use_javasourceinfoprovider
: "เท็จ" -
ไม่มีการดำเนินการ
แท็ก: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% จากการกำหนดค่านี้
- ค่าเริ่มต้น
--local_termination_grace_seconds=<an integer>
: "15" - เวลาที่ต้องรอระหว่างการสิ้นสุดกระบวนการในเครื่องเนื่องจากหมดเวลาและบังคับปิดกระบวนการดังกล่าว
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์ ระบบจะใช้เส้นทางตามที่เป็น ถ้าเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพัทธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางดังกล่าวจะสัมพัทธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"
- ค่าเริ่มต้นของ
--package_path=<colon-separated list of options>
: "%workspace%" - รายการตำแหน่งที่จะค้นหาแพ็กเกจที่คั่นด้วยโคลอน องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับพื้นที่ทำงานที่ล้อมรอบอยู่ หากไม่ระบุหรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
- ค่าเริ่มต้น
--[no]show_loading_progress
: "true" - หากเปิดใช้ จะทำให้ Bazel พิมพ์ "กำลังโหลดแพ็กเกจ:" ข้อความ
- ค่าเริ่มต้นของ
--test_lang_filters=<comma-separated list of options>
: "" - ระบุรายการภาษาทดสอบที่คั่นด้วยคอมมา แต่ละภาษาอาจนำหน้าด้วย '-' หรือไม่ก็ได้ เพื่อระบุภาษาที่ยกเว้น ระบบจะพบเฉพาะเป้าหมายทดสอบเหล่านั้นที่ใช้ภาษาที่ระบุ ชื่อที่ใช้สำหรับแต่ละภาษาควรเหมือนกับคำนำหน้าภาษาในกฎ *_test เช่น หนึ่งใน "cc", 'java', 'py' ฯลฯ ตัวเลือกนี้ส่งผลต่อพฤติกรรม --build_tests_only พฤติกรรม และคำสั่งทดสอบ
- ค่าเริ่มต้นของ
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
: "" - ระบุรายการขนาดทดสอบที่คั่นด้วยคอมมา แต่ละขนาดจะมีเครื่องหมาย "-" นำหน้าได้ เพื่อระบุขนาดที่ยกเว้น ระบบจะพบว่าเป้าหมายทดสอบเหล่านั้นมีขนาดอย่างน้อย 1 ขนาดและไม่มีขนาดที่ยกเว้น ตัวเลือกนี้จะมีผลกับลักษณะการทำงาน --build_tests_only และคำสั่งทดสอบ
- ค่าเริ่มต้นของ
--test_tag_filters=<comma-separated list of options>
: "" - ระบุรายการแท็กทดสอบที่คั่นด้วยคอมมา แต่ละแท็กสามารถขึ้นต้นด้วย "-" หรือไม่ก็ได้ เพื่อระบุแท็กที่ยกเว้น และจะพบว่าเป้าหมายทดสอบเหล่านั้นมีแท็กที่รวมไว้อย่างน้อย 1 แท็กและไม่มีแท็กที่ยกเว้น ตัวเลือกนี้จะมีผลกับลักษณะการทำงาน --build_tests_only และคำสั่งทดสอบ
- ค่าเริ่มต้นของ
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
: "" - ระบุรายการระยะหมดเวลาของการทดสอบที่คั่นด้วยคอมมา ระยะหมดเวลาแต่ละครั้งจะมีเครื่องหมาย "-" นำหน้าได้ เพื่อระบุการหมดเวลาที่ยกเว้น ระบบจะพบเฉพาะเป้าหมายทดสอบเหล่านั้นที่มีระยะหมดเวลาอย่างน้อย 1 รายการและไม่มีระยะหมดเวลาที่ยกเว้น ตัวเลือกนี้จะมีผลกับลักษณะการทำงาน --build_tests_only และคำสั่งทดสอบ
- ค่าเริ่มต้น
--tls_certificate=<a string>
: ดูคำอธิบาย - ระบุเส้นทางไปยังใบรับรอง TLS ที่เชื่อถือให้ลงนามใบรับรองเซิร์ฟเวอร์
- ค่าเริ่มต้น
--tls_client_certificate=<a string>
: ดูคำอธิบาย - ระบุใบรับรองไคลเอ็นต์ TLS ที่จะใช้ คุณต้องระบุคีย์ไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
- ค่าเริ่มต้น
--tls_client_key=<a string>
: ดูคำอธิบาย - ระบุคีย์ไคลเอ็นต์ TLS ที่จะใช้ คุณจะต้องระบุใบรับรองไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์
- ค่าเริ่มต้นของ
--workspace_status_command=<path>
: "" - คำสั่งที่เรียกใช้ในตอนต้นของบิลด์เพื่อให้ข้อมูลสถานะเกี่ยวกับพื้นที่ทำงานในรูปแบบคู่คีย์/ค่า โปรดดูคู่มือผู้ใช้เพื่อดูข้อกำหนดทั้งหมด นอกจากนี้ โปรดดูเครื่องมือ/buildstamp/get_workspace_status เป็นต้น
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์:
- ค่าเริ่มต้น
--[no]check_up_to_date
: "เท็จ" -
ห้ามดำเนินการสร้าง เพียงตรวจสอบว่าเป็นรุ่นล่าสุดหรือไม่ หากเป้าหมายทั้งหมดเป็นปัจจุบัน แสดงว่าบิลด์เสร็จสมบูรณ์ หากต้องดำเนินการในขั้นตอนใด ระบบจะรายงานข้อผิดพลาดและบิลด์ล้มเหลว
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_inprocess_symlink_creation
: "เท็จ" -
เลือกว่าจะเรียกใช้ระบบไฟล์โดยตรงเพื่อสร้างต้นไม้ Symlink หรือไม่
แท็ก:loading_and_analysis
,execution
,experimental
- ค่าเริ่มต้น
--[no]experimental_remotable_source_manifests
: "เท็จ" -
ต้องการให้การดำเนินการในไฟล์ Manifest ของแหล่งที่มาทำซ้ำได้หรือไม่
แท็ก:loading_and_analysis
,execution
,experimental
- ค่าเริ่มต้น
--[no]experimental_split_coverage_postprocessing
: "เท็จ" -
หากเป็น "จริง" Bazel จะดำเนินการประมวลผลภายหลังสำหรับการครอบคลุมในการทดลองที่สร้างขึ้นใหม่
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_split_xml_generation
: "true" -
หากมีการกำหนดแฟล็กนี้ และการดำเนินการทดสอบไม่สร้างไฟล์ test.xml ขึ้นมา Bazel จะใช้การดำเนินการแยกต่างหากเพื่อสร้างไฟล์ test.xml จำลองที่มีบันทึกการทดสอบ มิฉะนั้น Bazel จะสร้าง test.xml เป็นส่วนหนึ่งของการดำเนินการทดสอบ
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_strict_fileset_output
: "เท็จ" -
หากเปิดใช้ตัวเลือกนี้ ชุดไฟล์จะถือว่าอาร์ติแฟกต์เอาต์พุตทั้งหมดเป็นไฟล์ทั่วไป โดยจะไม่ข้ามผ่านไดเรกทอรีหรือไวต่อลิงก์สัญลักษณ์
แท็ก:execution
- ค่าเริ่มต้นของ
--genrule_strategy=<comma-separated list of options>
: "" -
ระบุวิธีเรียกใช้ Genrule การแจ้งว่าไม่เหมาะสมนี้จะถูกนำออก ให้ใช้ --spawn_strategy=<value> แทน เพื่อควบคุมการดำเนินการทั้งหมด หรือ --strategy=Genrule=<value> เพื่อควบคุม Genrules เท่านั้น
แท็ก:execution
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] ค่าเริ่มต้น: "อัตโนมัติ"-
จำนวนงานที่เกิดขึ้นพร้อมกันที่จะเรียกใช้ ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") โดยจะเลือกตามด้วยการดำเนินการ ([-|*]<Float>) เช่น "auto", "HOST_CPUS*.5" ค่าต้องอยู่ระหว่าง 1 ถึง 5000 ค่าที่สูงกว่า 2,500 อาจก่อให้เกิดปัญหาเกี่ยวกับหน่วยความจำ "อัตโนมัติ" จะคำนวณค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์
แท็ก:host_machine_resource_optimizations
execution
--[no]keep_going
[-k
] ค่าเริ่มต้น: "เท็จ"-
ดำเนินการต่อให้มากที่สุดหลังจากเกิดข้อผิดพลาด แม้ว่าเป้าหมายที่ล้มเหลวและเป้าหมายที่อ้างอิงอยู่จะไม่สามารถวิเคราะห์ได้ แต่ข้อกําหนดเบื้องต้นอื่นๆ ของเป้าหมายเหล่านี้อาจเป็นไปได้
แท็ก:eagerness_to_exit
- ค่าเริ่มต้น
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "อัตโนมัติ" -
จำนวนชุดข้อความแบบขนานที่จะใช้สำหรับขั้นตอนการโหลด/การวิเคราะห์ ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") หรือเลือกตามด้วยการดำเนินการ ([-|*]<Float>) เช่น "auto", "HOST_CPUS*.5" "อัตโนมัติ" ตั้งค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
: "" -
เพิ่มหรือนำคีย์ออกจากข้อมูลการดำเนินการของการดำเนินการตามความสามารถในการจำการดำเนินการ ใช้กับการดำเนินการที่รองรับข้อมูลการดำเนินการเท่านั้น การดำเนินการทั่วไปจำนวนมากรองรับข้อมูลการดำเนินการ เช่น Genrule, CppCompile, Javac, StarlarkAction, TestRunner เมื่อระบุค่าหลายค่า ลำดับมีความสำคัญเนื่องจาก regexe หลายรายการอาจใช้กับช่วยจำเดียวกันได้
ไวยากรณ์: "regex=[+-]key,regex=[+-]key,..."
ตัวอย่าง:
'.*=+x,.*=-y,.*=+z' เพิ่ม "x" และ "z" ถึง และนำ "y" ออก ข้อมูลการดำเนินการสำหรับการดำเนินการทั้งหมด
'Genrule=+requires-x' เพิ่ม "requires-x" กับข้อมูลการดำเนินการสำหรับการดำเนินการ Genrule ทั้งหมด
'(?!Genrule).*=-requires-x' นำ "requires-x" ออก จากข้อมูลการดำเนินการสำหรับการดำเนินการ
ที่ไม่ใช่ Genrule ทั้งหมด
แท็ก:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
เปิดใช้การดำเนินการ Dex และ desugar ของ Android แบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
แท็ก:host_machine_resource_optimizations
execution
--persistent_android_resource_processor
-
เปิดใช้ผู้ประมวลผลข้อมูลทรัพยากร Android ถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
เปิดใช้การดำเนินการ Dex และ desugar ของ Android แบบมัลติเพล็กซ์โดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
เปิดใช้เครื่องมือประมวลผลทรัพยากร Android แบบมัลติเพล็กซ์แบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
เปิดใช้เครื่องมือ Android แบบต่อเนื่องและแบบมัลติเพล็กซ์ (Dexing, Deugaring, Resource Operations)
ขยายเป็น
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
แท็ก:host_machine_resource_optimizations
execution
- ค่าเริ่มต้นของ
--spawn_strategy=<comma-separated list of options>
: "" -
ระบุวิธีการสร้างคำสั่งเริ่มต้น ยอมรับรายการกลยุทธ์ที่คั่นด้วยจุลภาคจากลำดับความสำคัญสูงสุดไปต่ำสุด สำหรับการกระทำแต่ละรายการ Bazel จะเลือกกลยุทธ์ที่มีลำดับความสำคัญสูงสุดที่สามารถกระทำได้ ค่าเริ่มต้นคือ "remote,worker,sandboxed,local" ดูรายละเอียดได้ที่ https://blog.bazel.build/2019/06/19/list-strategy.html
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--strategy=<a '[name=]value1[,..,valueN]' assignment>
รายการ -
ระบุวิธีการเผยแพร่การคอมไพล์การดำเนินการอื่นๆ ที่สร้างขึ้น ยอมรับรายการกลยุทธ์ที่คั่นด้วยจุลภาคจากลำดับความสำคัญสูงสุดไปต่ำสุด สำหรับการกระทำแต่ละรายการ Bazel จะเลือกกลยุทธ์ที่มีลำดับความสำคัญสูงสุดที่สามารถกระทำได้ ค่าเริ่มต้นคือ "remote,worker,sandboxed,local" แฟล็กนี้จะลบล้างค่าที่กำหนดโดย --spawn_strategy (และ --genrule_strategy หากใช้กับ mnemonic Genrule) ดูรายละเอียดได้ที่ https://blog.bazel.build/2019/06/19/list-strategy.html
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
รายการ -
ลบล้างกลยุทธ์การสร้างที่สร้างขึ้นเพื่อเรียกใช้การดำเนินการที่สร้างขึ้นซึ่งมีคำอธิบายตรงกับ regex_filter บางรายการ ดู --per_file_copt สำหรับรายละเอียดการจับคู่เกี่ยวกับนิพจน์ทั่วไป ระบบจะใช้ regex_filter รายการแรกที่ตรงกับคำอธิบาย ตัวเลือกนี้จะลบล้างแฟล็กอื่นๆ สำหรับการระบุกลยุทธ์ ตัวอย่าง: --strategy_regexp=//foo.*\.cc,-//foo/bar=local หมายถึงการเรียกใช้การดำเนินการโดยใช้กลยุทธ์ท้องถิ่นหากคำอธิบายตรงกับ //foo.*.cc แต่ไม่ตรงกับ //foo/bar ตัวอย่างเช่น --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed จะเรียกใช้ 'Compiling //foo/bar/baz' พร้อมแป้น "local" แต่การกลับลำดับคำสั่งซื้อจะทำงานด้วย "แซนด์บ็อกซ์"
แท็ก:execution
- ตัวเลือกที่กำหนดค่า Toolchain ที่ใช้สำหรับการดำเนินการมีดังนี้
- ค่าเริ่มต้น
--android_compiler=<a string>
: ดูคำอธิบาย -
คอมไพเลอร์เป้าหมายของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
ค่าเริ่มต้น: "//external:android/crosstool"-
ตำแหน่งของคอมไพเลอร์ C++ ที่ใช้สำหรับบิลด์ของ Android
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--android_grte_top=<a label>
: ดูคำอธิบาย -
เป้าหมาย Android grte_top
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_manifest_merger=<legacy, android or force_android>
: "android" -
เลือกการควบรวมไฟล์ Manifest ที่จะใช้กับกฎ android_binary แจ้งเพื่อช่วยให้เปลี่ยนไปใช้การผสานรวมไฟล์ Manifest ของ Android จากการควบรวมเดิม
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_platforms=<a build target label>
: "" -
ตั้งค่าแพลตฟอร์มที่ android_binary กำหนดเป้าหมายใช้ หากระบุหลายแพลตฟอร์ม ไบนารีนั้นจะเป็น APK แบบอ้วน ซึ่งมีไบนารีแบบเนทีฟสำหรับแต่ละแพลตฟอร์มเป้าหมายที่ระบุ
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_sdk=<a build target label>
: "@bazel_tools//tools/android:sdk" -
ระบุ SDK/แพลตฟอร์ม Android ที่ใช้สร้างแอปพลิเคชัน Android
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--apple_compiler=<a string>
: ดูคำอธิบาย -
คอมไพเลอร์เป้าหมายของ Apple มีประโยชน์สำหรับการเลือกเวอร์ชันของ Toolchain (เช่น xcode-beta)
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้ในกฎของ Apple และ Objc และทรัพยากร Dependency
แท็ก:loses_incremental_state
changes_inputs
- ค่าเริ่มต้น
--apple_grte_top=<a build target label>
: ดูคำอธิบาย -
เป้าหมาย grte_top ของ Apple
แท็ก: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>
ค่าเริ่มต้น: "@bazel_tools//tools/test:lcov_merger"-
ตำแหน่งของไบนารีที่ใช้เพื่อประมวลผลรายงานการครอบคลุมแบบข้อมูลดิบหลังการประมวลผล ซึ่งต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งก็คือไบนารี ค่าเริ่มต้นคือ "//tools/test:lcov_merger"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_report_generator"-
ตําแหน่งของไบนารีที่ใช้สร้างรายงานการครอบคลุม ซึ่งต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งก็คือไบนารี ค่าเริ่มต้นคือ "//tools/test:coverage_report_generator"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_support"-
ตำแหน่งของไฟล์สนับสนุนที่จำเป็นต้องใช้ในอินพุตของการดำเนินการทดสอบทั้งหมดที่รวบรวมการครอบคลุมของโค้ด ค่าเริ่มต้นคือ "//tools/test:coverage_support"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้สำหรับคอมไพล์โค้ด C++
แท็ก:loading_and_analysis
,changes_inputs
,affects_outputs
- ค่าเริ่มต้น
--custom_malloc=<a build target label>
: ดูคำอธิบาย -
ระบุการใช้งาน Malloc ที่กำหนดเอง การตั้งค่านี้จะลบล้างแอตทริบิวต์ Malloc ในกฎบิลด์
แท็ก:changes_inputs
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
รายการ -
รายการนิพจน์ทั่วไปที่คั่นด้วยคอมมา แต่ละรายการจะมีคำนำหน้าด้วย - (นิพจน์เชิงลบ) และกำหนด (=) ให้กับรายการเป้าหมายค่าข้อจำกัดที่คั่นด้วยคอมมา หากเป้าหมายตรงกับที่ไม่มีนิพจน์เชิงลบ และนิพจน์เชิงบวกอย่างน้อย 1 รายการ การแปลง Toolchain จะดำเนินการเสมือนว่าได้ประกาศค่าข้อจำกัดเป็นข้อจำกัดการดำเนินการ ตัวอย่าง: //demo,-test=@platforms//cpus:x86_64 จะเพิ่ม "x86_64" ไปยังเป้าหมายใดๆ ภายใต้ //demo ยกเว้นเป้าหมายที่ชื่อมี "test"
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_enable_objc_cc_deps
: "true" -
อนุญาตให้กฎ objc_* ขึ้นอยู่กับ cc_library และทำให้ทรัพยากร Dependency ของ objc สร้างขึ้นด้วย --cpu ตั้งค่าเป็น "ios_<--ios_cpu>" สำหรับค่าใดก็ได้ใน --ios_multi_cpu
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]experimental_include_xcode_execution_requirements
: "เท็จ" -
เมื่อตั้งค่าแล้ว ให้เพิ่ม "requires-xcode:{version}" สำหรับการดำเนินการของ Xcode ทุกครั้ง หากเวอร์ชัน xcode มีป้ายกำกับขีดกลาง ให้เพิ่ม "requires-xcode-label:{version_label}" ด้วย ข้อกำหนดของการดำเนินการ
แท็ก:loses_incremental_state
,loading_and_analysis
,execution
- ค่าเริ่มต้น
--[no]experimental_prefer_mutual_xcode
: "true" -
หากเป็นจริง ให้ใช้ Xcode ล่าสุดที่พร้อมใช้งานทั้งในเครื่องและจากระยะไกล หากเป็นเท็จหรือไม่มีเวอร์ชันที่ใช้ร่วมกัน ให้ใช้เวอร์ชันของ Xcode ในเครื่องที่เลือกผ่าน xcode-select
แท็ก:loses_incremental_state
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--extra_execution_platforms=<comma-separated list of options>
รายการ -
แพลตฟอร์มที่มีให้ใช้งานเป็นแพลตฟอร์มการดำเนินการเพื่อเรียกใช้การดำเนินการ สามารถระบุแพลตฟอร์มโดยเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมาย แพลตฟอร์มเหล่านี้จะได้รับการพิจารณาก่อนแพลตฟอร์มที่ประกาศในไฟล์ WORKSPACE โดยregister_execution_platforms()
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--extra_toolchains=<comma-separated list of options>
รายการ -
กฎ Toolchain ที่จะต้องพิจารณาระหว่างการแก้ไข Toolchain สามารถระบุ Toolchains ตามเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมายได้ ระบบจะพิจารณา Toolchain เหล่านี้ก่อนการประกาศในไฟล์ WORKSPACE โดยregister_toolchains()
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--grte_top=<a label>
: ดูคำอธิบาย -
ป้ายกำกับไปยังไลบรารี libc ที่มีการเช็คอิน Crosstool Toolchain จะเลือกค่าเริ่มต้นและคุณแทบจะไม่จำเป็นต้องลบล้างค่าเริ่มต้น
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--host_compiler=<a string>
: ดูคำอธิบาย -
คอมไพเลอร์ C++ ที่จะใช้สำหรับการคอมไพล์โฮสต์ โดยจะไม่มีผลหากไม่ได้ตั้งค่า --host_crosstool_top
แท็ก:loading_and_analysis
execution
- ค่าเริ่มต้น
--host_crosstool_top=<a build target label>
: ดูคำอธิบาย -
โดยค่าเริ่มต้น ตัวเลือก --crosstool_top และ --compiler จะใช้สำหรับการกำหนดค่าโฮสต์ด้วย หากมีแฟล็กนี้ Bazel จะใช้ libc และคอมไพเลอร์เริ่มต้นสำหรับ Crosstool_top ที่ระบุ
แท็ก:loading_and_analysis
,changes_inputs
,affects_outputs
- ค่าเริ่มต้น
--host_grte_top=<a label>
: ดูคำอธิบาย -
ถ้าระบุ การตั้งค่านี้จะลบล้างไดเรกทอรีระดับบนสุดของ libc (--grte_top) สำหรับการกำหนดค่าโฮสต์
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้นของ
--host_platform=<a build target label>
: "" -
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายระบบโฮสต์
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--[no]incompatible_disable_expand_if_all_available_in_flag_set
: "true" -
หากเป็น "จริง" Bazel จะไม่อนุญาตให้ระบุลักษณะที่ขยายออก (expand_if_all_available) ในแฟล็ก_sets (ดูวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/7008)
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "true" -
หากเป็น "จริง" Bazel จะไม่เปิดใช้ "โฮสต์" และ "nonhost" ใน Toolchain ของ c++ (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/7407)
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_enable_android_toolchain_resolution
: "เท็จ" -
ใช้ความละเอียดของ Toolchain เพื่อเลือก Android SDK สำหรับกฎ Android (Starlark และเนทีฟ)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_enable_apple_toolchain_resolution
: "เท็จ" -
ใช้ความละเอียดของ Toolchain เพื่อเลือก Apple SDK สำหรับกฎของ Apple (Starlark และเนทีฟ)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_make_thinlto_command_lines_standalone
: "true" -
หากเป็นจริง Bazel จะไม่นำบรรทัดคำสั่งสำหรับการดำเนินการลิงก์ C++ มาใช้ซ้ำสำหรับบรรทัดคำสั่งสำหรับการจัดทำดัชนี lto (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/6791)
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
: "true" -
หากเป็นจริง 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
: "true" -
หากเป็นจริง Bazel จะไม่ลิงก์ทรัพยากร Dependency ของไลบรารีเป็นที่เก็บถาวรทั้งหมดโดยค่าเริ่มต้น (ดูวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/7362)
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_require_ctx_in_configure_features
: "true" -
หากเป็นจริง Bazel จะต้องใช้ "ctx" ใน cc_common.configure_features (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/7793)
แท็ก:loading_and_analysis
incompatible_change
-
ใช้ออบเจ็กต์ที่ใช้ร่วมกันของอินเทอร์เฟซ หาก Toolchain รองรับ เครื่องมือเชน ELF ทั้งหมดรองรับการตั้งค่านี้ในขณะนี้
แท็ก:loading_and_analysis
,affects_outputs
,affects_outputs
- ค่าเริ่มต้น
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
ระบุเวอร์ชันของ iOS SDK ที่จะใช้สร้างแอปพลิเคชัน iOS หากไม่ระบุ ระบบจะใช้เวอร์ชันเริ่มต้นของ iOS SDK จาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
ระบุเวอร์ชันของ macOS SDK ที่จะใช้สร้างแอปพลิเคชัน macOS หากไม่ระบุ ระบบจะใช้เวอร์ชันเริ่มต้นของ macOS SDK จาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--minimum_os_version=<a string>
: ดูคำอธิบาย -
เวอร์ชันระบบปฏิบัติการขั้นต่ำที่การคอมไพล์กำหนดเป้าหมาย
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้นของ
--platform_mappings=<a relative path>
: "" -
ตำแหน่งของไฟล์การแมปที่อธิบายแพลตฟอร์มที่จะใช้หากไม่ได้ตั้งค่าไว้ หรือแฟล็กที่จะตั้งค่าเมื่อมีแพลตฟอร์มอยู่แล้ว ต้องสัมพัทธ์กับรูทของพื้นที่ทำงานหลัก มีค่าเริ่มต้นเป็น "platform_mappings" (ไฟล์ที่อยู่ภายใต้รูทของพื้นที่ทำงานโดยตรง)
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--platforms=<a build target label>
: "" -
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายแพลตฟอร์มเป้าหมายสำหรับคำสั่งปัจจุบัน
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--python2_path=<a string>
: ดูคำอธิบาย -
เลิกใช้งานแล้ว ไม่มีการดำเนินการ ปิดใช้โดย "--incompatible_use_python_toolchains"
แท็ก:no_op
,deprecated
- ค่าเริ่มต้น
--python3_path=<a string>
: ดูคำอธิบาย -
เลิกใช้งานแล้ว ไม่มีการดำเนินการ ปิดใช้โดย "--incompatible_use_python_toolchains"
แท็ก:no_op
,deprecated
- ค่าเริ่มต้น
--python_path=<a string>
: ดูคำอธิบาย -
Absolute Path ของล่าม Python มีการเรียกใช้เป้าหมาย Python บนแพลตฟอร์มเป้าหมาย เลิกใช้งาน; ปิดใช้งานโดย --incompatible_use_python_toolchains
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้น
--python_top=<a build target label>
: ดูคำอธิบาย -
ป้ายกำกับของ py_runtime ที่แทนอินเทอร์พรีเตอร์ Python ได้มีการเรียกให้เรียกใช้เป้าหมาย Python บนแพลตฟอร์มเป้าหมาย เลิกใช้งาน; ปิดใช้งานโดย --incompatible_use_python_toolchains
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้น
--target_platform_fallback=<a build target label>
: "@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 หากไม่ระบุ ระบบจะใช้เวอร์ชันเริ่มต้นของ tvOS SDK จาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
ระบุเวอร์ชันของ WatchOS SDK ที่จะใช้สร้างแอปพลิเคชัน watchOS หากไม่ระบุ ระบบจะใช้เวอร์ชัน WatchOS SDK เริ่มต้นจาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--xcode_version=<a string>
: ดูคำอธิบาย -
หากระบุไว้ ให้ใช้ Xcode ของเวอร์ชันที่ระบุสำหรับการดำเนินการของบิลด์ที่เกี่ยวข้อง หากไม่ระบุ ระบบจะใช้ Xcode เวอร์ชันเริ่มต้นของผู้ดำเนินการ
แท็ก:loses_incremental_state
--xcode_version_config=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:host_xcodes"-
ป้ายกำกับของกฎ xcode_config ที่จะใช้สำหรับเลือกเวอร์ชัน Xcode ในการกำหนดค่าบิลด์
แท็ก:loses_incremental_state
loading_and_analysis
- มีดังนี้
- ค่าเริ่มต้น
--[no]apple_enable_auto_dsym_dbg
: "เท็จ" -
เลือกว่าจะบังคับให้เปิดใช้ไฟล์สัญลักษณ์การแก้ไขข้อบกพร่อง(.dSYM) สำหรับบิลด์ dbg หรือไม่
แท็ก:affects_outputs
action_command_lines
- ค่าเริ่มต้น
--[no]apple_generate_dsym
: "เท็จ" -
เลือกว่าจะสร้างไฟล์สัญลักษณ์การแก้ไขข้อบกพร่อง (.dSYM) หรือไม่
แท็ก:affects_outputs
action_command_lines
- ค่าเริ่มต้น
--[no]build
: "true" -
ดำเนินการสร้าง นี่เป็นลักษณะการทำงานปกติ การระบุ --nobuild จะทำให้บิลด์หยุดทำงานก่อนที่จะดำเนินการของบิลด์ ซึ่งแสดงผลเป็น 0 หากขั้นตอนการโหลดแพ็กเกจและการวิเคราะห์เสร็จสมบูรณ์ โหมดนี้มีประโยชน์ในการทดสอบระยะเหล่านั้น
แท็ก:execution
affects_outputs
- ค่าเริ่มต้น
--[no]build_runfile_links
: "true" -
หากเป็น "จริง" ให้สร้างศูนย์การเรียกใช้ไฟล์ symlink สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้เขียนเฉพาะไฟล์ Manifest เมื่อเป็นไปได้
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]build_runfile_manifests
: "true" -
หากเป็น "จริง" ให้เขียนไฟล์ Manifest ของการเรียกใช้ไฟล์สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้ละเว้น การทดสอบในเครื่องจะทํางานไม่ได้หากเป็นเท็จ
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]build_test_dwp
: "เท็จ" -
หากเปิดใช้ เมื่อสร้างการทดสอบ C++ แบบคงที่ และด้วยฟิชชัน ไฟล์ .dwp สำหรับไบนารีการทดสอบจะสร้างขึ้นโดยอัตโนมัติเช่นกัน
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้นของ
--cc_proto_library_header_suffixes=<comma-separated 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
: "เท็จ" -
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันอื่นๆ ใน protocol_library
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_proto_extra_actions
: "เท็จ" -
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันอื่นๆ ใน protocol_library
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_run_validations
: "true" -
โปรดใช้ --run_Validations แทน
แท็ก:execution
affects_outputs
- ค่าเริ่มต้น
--[no]experimental_save_feature_state
: "เท็จ" -
บันทึกสถานะของฟีเจอร์ที่เปิดใช้และที่ขอเป็นเอาต์พุตของการคอมไพล์
แท็ก:affects_outputs
experimental
- ค่าเริ่มต้น
--[no]experimental_use_validation_aspect
: "เท็จ" -
เลือกว่าจะเรียกใช้การตรวจสอบโดยใช้มุมมอง (สำหรับการทำงานพร้อมกันกับการทดสอบ) หรือไม่
แท็ก:execution
affects_outputs
- ค่าเริ่มต้น
--fission=<a set of compilation modes>
: "ไม่" -
ระบุโหมดการคอมไพล์ที่ใช้ฟิชชันสําหรับการคอมไพล์และลิงก์ C++ อาจเป็นชุดค่าผสมใดๆ ของ {'fastbuild', 'dbg', 'opt'} หรือค่าพิเศษ 'yes' เพื่อเปิดทุกโหมดและ "ไม่" เพื่อปิดใช้โหมดทั้งหมด
แท็ก:loading_and_analysis
,action_command_lines
,affects_outputs
- ค่าเริ่มต้น
--[no]incompatible_always_include_files_in_data
: "true" -
หากเป็นจริง กฎของระบบจะเพิ่ม <code>DefaultInfo.files</code> ของทรัพยากร Dependency ไปยังไฟล์รันไทม์ ซึ่งตรงกับลักษณะการทำงานที่แนะนำสำหรับกฎของ Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid)
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]legacy_external_runfiles
: "true" -
หากเป็น "จริง" ให้สร้างฟอเรสต์ Runfiles symlink สำหรับที่เก็บภายนอกภายใต้ .runfiles/wsname/external/repo (นอกเหนือจาก .runfiles/repo)
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]objc_generate_linkmap
: "เท็จ" -
ระบุว่าจะสร้างไฟล์ linkmap หรือไม่
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--output_groups=<comma-separated list of options>
รายการ -
รายการของชื่อกลุ่มเอาต์พุตที่คั่นด้วยคอมมา ซึ่งแต่ละรายการอาจนำหน้าด้วยเครื่องหมาย + หรือ - ระบบจะเพิ่มกลุ่มที่ขึ้นต้นด้วย + ลงในชุดกลุ่มเอาต์พุตเริ่มต้น ส่วนกลุ่มที่ขึ้นต้นด้วย - จะถูกนำออกจากชุดเริ่มต้น หากมีอย่างน้อย 1 กลุ่มที่ไม่มีคำนำหน้า ระบบจะละเว้นชุดกลุ่มเอาต์พุตเริ่มต้น ตัวอย่างเช่น --output_groups=+foo,+bar จะสร้างการรวมของชุดเริ่มต้น ได้แก่ foo และ bar ในขณะที่ --output_groups=foo,bar จะลบล้างชุดเริ่มต้นที่สร้างเฉพาะ foo และ bar
แท็ก:execution
affects_outputs
- ค่าเริ่มต้น
--[no]run_validations
: "true" -
ระบุว่าจะเรียกใช้การดำเนินการตรวจสอบเป็นส่วนหนึ่งของบิลด์หรือไม่ ดู https://bazel.build/rules/rules#Validation_actions
แท็ก:execution
affects_outputs
- ค่าเริ่มต้น
--[no]save_temps
: "เท็จ" -
หากตั้งค่าไว้ ระบบจะบันทึกเอาต์พุตชั่วคราวจาก gcc ไฟล์เหล่านี้รวมถึงไฟล์ .s (โค้ด Ascyclr), ไฟล์ .i (C ที่ประมวลผลล่วงหน้า) และ .ii (C++ ที่ประมวลผลล่วงหน้า)
แท็ก:affects_outputs
- ตัวเลือกที่ให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการได้ โดยให้ส่งผลต่อค่าของเอาต์พุตแทนค่าที่มีอยู่
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--action_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกำหนดค่าเป้าหมาย คุณระบุตัวแปรได้ด้วยชื่อ ซึ่งในกรณีนี้ระบบจะนําค่าจากสภาพแวดล้อมการเรียกใช้ หรือคู่ name=value ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ ตัวเลือกนี้ใช้ได้หลายครั้ง สำหรับตัวเลือกที่ระบุสำหรับตัวแปรเดียวกัน ค่าที่ชนะล่าสุด และตัวเลือกของตัวแปรต่างๆ จะสะสมอยู่
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--android_cpu=<a string>
: "armeabi-v7a" -
CPU เป้าหมายของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--[no]android_databinding_use_androidx
: "เท็จ" -
สร้างไฟล์การเชื่อมโยงข้อมูลที่ใช้กับ AndroidX ได้ ใช้ได้เฉพาะกับการเชื่อมโยงข้อมูล v2 เท่านั้น
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]android_databinding_use_v3_4_args
: "เท็จ" -
ใช้ Android Databinding v2 ที่มีอาร์กิวเมนต์ 3.4.0
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้นของ
--android_dynamic_mode=<off, default or fully>
: "ปิด" -
กำหนดว่าจะให้ลิงก์ C++ ของกฎ Android แบบไดนามิกหรือไม่ เมื่อ cc_binary ไม่ได้สร้างไลบรารีที่ใช้ร่วมกันอย่างชัดแจ้ง "ค่าเริ่มต้น" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "สมบูรณ์" หมายความว่าไลบรารีทั้งหมดจะลิงก์แบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "ตามตัวอักษร" -
ตั้งค่าลำดับของไฟล์ Manifest ที่ส่งไปยังการรวมไฟล์ Manifest สำหรับไบนารีของ Android อัลฟ่าหมายความว่าไฟล์ Manifest ได้รับการจัดเรียงตามเส้นทางที่สัมพันธ์กับผู้ดำเนินการ ALPHABETICAL_BY_CONFIGURATION หมายความว่าไฟล์ Manifest ได้รับการจัดเรียงตามเส้นทางที่สัมพันธ์กับไดเรกทอรีการกำหนดค่าภายในไดเรกทอรีเอาต์พุต DEPENDENCY หมายความว่าไฟล์ Manifest จะเรียงลำดับตามไฟล์ Manifest ของไลบรารีแต่ละรายการที่อยู่ก่อนไฟล์ Manifest ของทรัพยากร Dependency
แท็ก:action_command_lines
execution
- ค่าเริ่มต้น
--[no]android_resource_shrinking
: "เท็จ" -
เปิดใช้การย่อทรัพยากรสำหรับ APK android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, 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 จะทำงานหลังจากด้านที่ต้องระบุทั้งหมดที่ระบุไว้โดย required [แอตทริบิวต์] จากนั้น some_aspect จะมีสิทธิ์เข้าถึงคุณค่าของแง่มุมเหล่านั้น ผู้ให้บริการเครือข่าย <bzl-file-label>%<aspect_name> เช่น '//tools:my_def.bzl%my_aspect' โดยที่ 'my_aspect' เป็นค่าระดับบนสุดจากเครื่องมือไฟล์/my_def.bzl
- ค่าเริ่มต้น
--[no]build_python_zip
: "อัตโนมัติ" -
สร้าง ZIP ที่เป็นไฟล์ปฏิบัติการ Python ใน Windows และปิดบนแพลตฟอร์มอื่น
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--catalyst_cpus=<comma-separated list of options>
รายการ -
รายชื่อสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple Catalyst
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--[no]collect_code_coverage
: "เท็จ" -
หากระบุไว้ Bazel จะใช้โค้ดเครื่องมือวัด (โดยใช้การใช้เครื่องมือแบบออฟไลน์หากเป็นไปได้) และจะรวบรวมข้อมูลการครอบคลุมระหว่างการทดสอบ เฉพาะเป้าหมายที่ตรงกับ --instrumentation_filter จะได้รับผลกระทบ โดยปกติ ตัวเลือกนี้ไม่ควรระบุโดยตรง - "ความครอบคลุมของbazel" ควรใช้คำสั่งแทน
แท็ก:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] ค่าเริ่มต้น: "fastbuild"-
ระบุโหมดที่จะมีการสร้างไบนารี ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
,action_command_lines
,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 ที่มีไฟล์โปรไฟล์, ไฟล์ข้อมูล RAW หรือไฟล์โปรไฟล์ LLVM ที่จัดทำดัชนีไว้
แท็ก:affects_outputs
- ค่าเริ่มต้น
--cs_fdo_instrument=<a string>
: ดูคำอธิบาย -
สร้างไบนารีด้วยเครื่องมือ FDO ที่ละเอียดอ่อนตามบริบท เมื่อใช้คอมไพเลอร์ Clang/LLVM คีย์ดังกล่าวจะยอมรับชื่อไดเรกทอรีที่ระบบจะส่งออกไฟล์โปรไฟล์แบบ RAW ขณะรันไทม์ด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--cs_fdo_profile=<a build target label>
: ดูคำอธิบาย -
cs_fdo_profile แสดงถึงโปรไฟล์ที่ละเอียดอ่อนตามบริบทที่จะใช้ในการเพิ่มประสิทธิภาพ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--cxxopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C++
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--define=<a 'name=value' assignment>
รายการ -
ตัวเลือก --define แต่ละรายการจะระบุการมอบหมายสำหรับตัวแปรบิลด์
แท็ก:changes_inputs
affects_outputs
- ค่าเริ่มต้น
--dynamic_mode=<off, default or fully>
: "ค่าเริ่มต้น" -
กำหนดว่าจะลิงก์ไบนารีของ C++ แบบไดนามิกหรือไม่ "ค่าเริ่มต้น" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "สมบูรณ์" หมายความว่าไลบรารีทั้งหมดจะลิงก์แบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้น
--[no]enable_fdo_profile_absolute_path
: "true" -
หากตั้งค่าไว้ การใช้ fdo_absolute_profile_path จะทำให้เกิดข้อผิดพลาด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]enable_runfiles
: "อัตโนมัติ" -
เปิดใช้โครงสร้างลิงก์สัญลักษณ์ของ Runfiles ซึ่งโดยค่าเริ่มต้น จะปิดอยู่ใน Windows และในแพลตฟอร์มอื่นๆ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_action_listener=<a build target label>
รายการ -
เลิกใช้งานไปทีละด้าน ใช้ action_listener เพื่อแนบทางลัดไปยังการดำเนินการบิลด์ที่มีอยู่
แท็ก:execution
experimental
- ค่าเริ่มต้น
--[no]experimental_android_compress_java_resources
: "เท็จ" -
บีบอัดทรัพยากร Java ใน APK
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_android_databinding_v2
: "เท็จ" -
ใช้ Android Databinding v2
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]experimental_android_resource_shrinking
: "เท็จ" -
เปิดใช้การย่อทรัพยากรสำหรับ APK android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_android_rewrite_dexes_with_rex
: "เท็จ" -
ใช้เครื่องมือ Rex เพื่อเขียนไฟล์ dex ใหม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]experimental_collect_code_coverage_for_generated_files
: "เท็จ" -
หากระบุไว้ Bazel จะสร้างการรวบรวมข้อมูลที่ครอบคลุมสำหรับไฟล์ที่สร้างขึ้นด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_convenience_symlinks
: "ปกติ" -
แฟล็กนี้ควบคุมวิธีจัดการลิงก์สัญลักษณ์ตามความสะดวก (ลิงก์สัญลักษณ์ที่ปรากฏในพื้นที่ทำงานหลังบิลด์) ค่าที่เป็นไปได้มีดังนี้
ปกติ (ค่าเริ่มต้น): ระบบจะสร้างหรือลบลิงก์สัญลักษณ์เพื่อความสะดวกแต่ละประเภทตามที่กำหนดโดยบิลด์
สะอาด: ลิงก์สัญลักษณ์ทั้งหมดจะถูกลบโดยไม่มีเงื่อนไข
เพิกเฉย: สัญลักษณ์ลิงก์จะไม่ปรากฏเพียงอย่างเดียว
log_only: สร้างข้อความบันทึกเสมือนเป็น "ปกติ" ผ่าน แต่ไม่ได้ดำเนินการเกี่ยวกับระบบไฟล์จริงๆ (มีประโยชน์สำหรับเครื่องมือ)
โปรดทราบว่าเฉพาะลิงก์สัญลักษณ์ที่มีชื่อที่สร้างขึ้นด้วยค่าปัจจุบันของ --symlink_prefix เท่านั้นที่อาจได้รับผลกระทบ หากคำนำหน้าเปลี่ยนไป ลิงก์สัญลักษณ์ที่มีอยู่แล้วก็จะถูกปล่อยไว้ตามเดิม
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_convenience_symlinks_bep_event
: "เท็จ" -
แฟล็กนี้ควบคุมว่าเราจะโพสต์เหตุการณ์บิลด์ConvenienceSymlinksIdentified ไปยัง BuildEventProtocol หรือไม่ หากค่าเป็น "จริง" BuildEventProtocol จะมีรายการ ConvesSymlinksIdentified ที่มีรายการลิงก์สัญลักษณ์แบบอำนวยความสะดวกทั้งหมดที่สร้างในพื้นที่ทำงานของคุณ หากเป็น "เท็จ" รายการ meetSymlinksIdentified ใน 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
: "เท็จ" -
หากเป็น "จริง" ให้ใช้ libunwind สำหรับการคลายสแต็ก แล้วคอมไพล์ด้วย -fomit-frame-pointer และ -fasynchronous-unwind-tables
แท็ก:action_command_lines
,affects_outputs
,experimental
- ค่าเริ่มต้น
--[no]experimental_platform_in_output_dir
: "เท็จ" -
หากเป็น "จริง" ระบบจะใช้แพลตฟอร์มเป้าหมายในชื่อไดเรกทอรีเอาต์พุตแทน CPU
แท็ก:affects_outputs
experimental
- ค่าเริ่มต้น
--[no]experimental_use_llvm_covmap
: "เท็จ" -
หากระบุ 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_apk_cpu=x86,armeabi-v7a. หากระบุแฟล็กนี้ ระบบจะละเว้น --android_cpu สำหรับทรัพยากร Dependency ของกฎ android_binary
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--[no]fat_apk_hwasan
: "เท็จ" -
เลือกว่าจะสร้างการแยก HWASAN หรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--fdo_instrument=<a string>
: ดูคำอธิบาย -
สร้างไบนารีด้วยเครื่องมือ FDO เมื่อใช้คอมไพเลอร์ Clang/LLVM คีย์ดังกล่าวจะยอมรับชื่อไดเรกทอรีที่ระบบจะส่งออกไฟล์โปรไฟล์แบบ RAW ขณะรันไทม์ด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_optimize=<a string>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ FDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อไฟล์ ZIP ที่มีแผนผังไฟล์ .gcda, ไฟล์ afdo ที่มีโปรไฟล์อัตโนมัติ หรือไฟล์โปรไฟล์ LLVM แฟล็กนี้ยอมรับไฟล์ที่ระบุเป็นป้ายกำกับด้วย (เช่น "//foo/bar:file.afdo" คุณอาจต้องเพิ่มคำสั่ง "exports_files" ไปยังแพ็กเกจที่เกี่ยวข้อง) และป้ายกำกับที่ชี้ไปยังเป้าหมาย "fdo_profile" การตั้งค่าสถานะนี้จะถูกแทนที่โดยกฎ "fdo_profile"
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_prefetch_hints=<a build target label>
: ดูคำอธิบาย -
ใช้คำแนะนำการดึงข้อมูลแคชล่วงหน้า
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_profile=<a build target label>
: ดูคำอธิบาย -
fdo_profile แทนโปรไฟล์ที่จะใช้ในการเพิ่มประสิทธิภาพ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--features=<a string>
รายการ -
ระบบจะเปิดใช้หรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างขึ้นในการกำหนดค่าเป้าหมาย กำลังระบุ -<feature> จะปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ ดูเพิ่มเติมที่ --host_features
แท็ก:changes_inputs
affects_outputs
- ค่าเริ่มต้น
--[no]force_pic
: "เท็จ" -
หากเปิดใช้งาน การคอมไพล์ C++ ทั้งหมดจะสร้างโค้ดที่ไม่ขึ้นอยู่กับตำแหน่ง ("-fPIC") ลิงก์จะใช้ไลบรารีที่สร้างไว้ล่วงหน้าของ PIC มากกว่าไลบรารีที่ไม่ใช่ PIC และลิงก์จะสร้างไฟล์ปฏิบัติการที่ไม่ขึ้นอยู่กับตำแหน่ง ("-pie")
แท็ก:loading_and_analysis
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_action_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกำหนดค่าโฮสต์หรือการดำเนินการ คุณระบุตัวแปรได้ด้วยชื่อ ซึ่งในกรณีนี้ระบบจะนําค่าจากสภาพแวดล้อมการเรียกใช้ หรือคู่ name=value ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ ตัวเลือกนี้ใช้ได้หลายครั้ง สำหรับตัวเลือกที่ระบุสำหรับตัวแปรเดียวกัน ค่าที่ชนะล่าสุด และตัวเลือกของตัวแปรต่างๆ จะสะสมอยู่
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--host_compilation_mode=<fastbuild, dbg or opt>
: "opt" -
ระบุโหมดที่จะมีการสร้างเครื่องมือที่ใช้ในการสร้าง ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_conlyopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งไปยัง 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 กำลังระบุ -<feature> จะปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ
แท็ก: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++ เมื่อคอมไพเลอร์ไฟล์บางไฟล์ในการกำหนดค่าโฮสต์หรือการดำเนินการ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: 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
: "true" -
หากเปิดใช้ ไลบรารีที่ลิงก์แบบไดนามิก (DLL) ของ C++ ทั้งหมดที่สร้างโดย cc_library ใน Windows จะเปลี่ยนชื่อเป็น name_{hash}.dll ซึ่งระบบคำนวณแฮชตาม RepositoryName และเส้นทางแพ็กเกจของ DLL ตัวเลือกนี้มีประโยชน์เมื่อคุณมีแพ็กเกจเดียว ซึ่งอาศัย cc_library ที่มีชื่อเดียวกันหลายรายการ (เช่น //foo/bar1:utils และ //foo/bar2:utils)
แท็ก:loading_and_analysis
,affects_outputs
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_merge_genfiles_directory
: "true" -
หากเป็นจริง ไดเรกทอรี genfiles จะถูกพับลงในไดเรกทอรี bin
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_use_host_features
: "เท็จ" -
หากเป็นจริง ให้ใช้ --features สำหรับการกำหนดค่าเป้าหมายเท่านั้น และ --host_features สำหรับการกำหนดค่า exec
แท็ก:changes_inputs
,affects_outputs
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_use_platforms_repo_for_constraints
: "true" -
หากเป็นจริง ระบบจะนำการตั้งค่าข้อจำกัดจาก @bazel_tools ออก
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]instrument_test_targets
: "เท็จ" -
เมื่อเปิดใช้การครอบคลุม ให้ระบุว่าจะพิจารณาการใช้กฎการทดสอบการวัดคุมหรือไม่ เมื่อตั้งค่าแล้ว กฎการทดสอบที่ --instrumentation_filter รวมอยู่จะมีการวัดคุม มิฉะนั้น กฎการทดสอบจะถูกยกเว้นจากการวัดคุมการครอบคลุมเสมอ
แท็ก:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
ค่าเริ่มต้น: "-/javatests[/:],-/test/java[/:]"-
เมื่อเปิดใช้การครอบคลุม ระบบจะวัดเฉพาะกฎที่มีชื่อซึ่งตัวกรองตามนิพจน์ทั่วไปที่ระบุรวมอยู่เท่านั้น กฎที่ขึ้นต้นด้วย "-" จะได้รับการยกเว้นแทน โปรดทราบว่าระบบจะวัดคุมเฉพาะกฎที่ไม่ใช่การทดสอบเท่านั้น ยกเว้นกรณีที่เปิดใช้งาน --instrument_test_targets
แท็ก:affects_outputs
- ค่าเริ่มต้น
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน iOS ที่เข้ากันได้ขั้นต่ำสำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ระบุ ให้ใช้ "ios_sdk_version"
แท็ก:loses_incremental_state
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ios_multi_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างแอปพลิเคชัน ios_ ผลลัพธ์จะเป็นไบนารีสากลที่มีสถาปัตยกรรมที่ระบุทั้งหมด
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--[no]legacy_whole_archive
: "true" -
เลิกใช้งานแล้ว และมีผลแทนด้วย --inสามารถเข้าถึง_remove_legacy_whole_archive (ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7362) เมื่อเปิด ให้ใช้ --whole-archive สำหรับกฎ cc_binary ที่มี linkshared=True และ linkstatic=True หรือ '-static' ใน Linkopts วิธีนี้ใช้สำหรับความเข้ากันได้แบบย้อนหลังเท่านั้น อีกทางเลือกหนึ่งที่ดีกว่าคือการใช้ Alwayslink=1 เมื่อจำเป็น
แท็ก:action_command_lines
,affects_outputs
,deprecated
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--linkopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งไปยัง gcc เมื่อลิงก์
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ltobackendopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังขั้นตอนแบ็กเอนด์ของ LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ltoindexopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังขั้นตอนการจัดทำดัชนี LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--macos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple macOS
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน macOS ที่เข้ากันได้ขั้นต่ำสำหรับเป้าหมาย หากไม่ได้ระบุ ให้ใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--[no]objc_debug_with_GLIBCXX
: "เท็จ" -
หากตั้งค่า และตั้งค่าโหมดการคอมไพล์เป็น "dbg" ให้กำหนด GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC และ GLIBCPP_CONCEPT_CHECKS
แท็ก:action_command_lines
- ค่าเริ่มต้น
--[no]objc_enable_binary_stripping
: "เท็จ" -
เลือกว่าจะดำเนินการลบสัญลักษณ์และโค้ดที่เสียหายในไบนารีที่ลิงก์หรือไม่ ระบบจะลบไบนารีหากระบุทั้ง Flag และ --compilation_mode=opt นี้
แท็ก:action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--objccopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ Objective-C/C++
แท็ก:action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งผ่านไปยัง gcc เฉพาะเมื่อคอมไพล์ไฟล์บางไฟล์ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจากรายการรวมและไม่รวมรูปแบบนิพจน์ทั่วไป (ดู --instrumentation_filter) ด้วย Option_1 กับ Option_n นั้นย่อมาจากตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ ในการแยกสตริงจะใช้เฉพาะ @ แรกเท่านั้น ตัวอย่าง: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับเลือกส่งไปยังแบ็กเอนด์ LTO (ในส่วน --features=thin_lto) เมื่อคอมไพล์ออบเจ็กต์แบ็กเอนด์บางรายการ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจาก รายการรูปแบบ รวมและยกเว้น ของนิพจน์ทั่วไป Option_1 กับ Option_n นั้นย่อมาจากตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ ในการแยกสตริงจะใช้เฉพาะ @ แรกเท่านั้น ตัวอย่าง: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่งแบ็กเอนด์ LTO ของไฟล์ o ทั้งหมดใน //foo/ ยกเว้น bar.o
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--platform_suffix=<a string>
: ดูคำอธิบาย -
ระบุคำต่อท้ายที่จะเพิ่มในไดเรกทอรีการกำหนดค่า
แท็ก:loses_incremental_state
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--propeller_optimize=<a build target label>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ Propeller เพื่อเพิ่มประสิทธิภาพเป้าหมายของบิลด์ โปรไฟล์ใบพัดต้องประกอบด้วยไฟล์อย่างน้อย 1 จาก 2 ไฟล์ โปรไฟล์สำเนา และโปรไฟล์ ld แฟล็กนี้ยอมรับป้ายกำกับบิลด์ซึ่งต้องอ้างถึงไฟล์อินพุตโปรไฟล์ใบพัด ตัวอย่างเช่น ไฟล์ BUILD ที่กำหนดป้ายกำกับใน a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)อาจต้องเพิ่มคำสั่ง ecommerce_files ลงในแพ็กเกจที่เกี่ยวข้องเพื่อให้ Bazel มองเห็นไฟล์เหล่านี้ ต้องใช้ตัวเลือกเป็น: --propeller_optimize=//a/b:propeller_profile
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--propeller_optimize_absolute_cc_profile=<a string>
: ดูคำอธิบาย -
ชื่อเส้นทางสัมบูรณ์ของไฟล์ cc_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพใบพัด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--propeller_optimize_absolute_ld_profile=<a string>
: ดูคำอธิบาย -
ชื่อเส้นทางสัมบูรณ์ของไฟล์ ld_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพใบพัด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--run_under=<a prefix in front of command>
: ดูคำอธิบาย -
คำนำหน้าที่จะแทรกก่อนไฟล์ปฏิบัติการสำหรับ "การทดสอบ" และ "เรียกใช้" คำสั่ง หากค่าคือ "foo -bar" และบรรทัดคำสั่งสำหรับการดำเนินการคือ "test_binary -baz" บรรทัดคำสั่งสุดท้ายคือ "foo -bar test_binary -baz" บรรทัดคำสั่งนี้อาจเป็นป้ายกำกับของเป้าหมายสั่งการได้ด้วย ตัวอย่างเช่น 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'
แท็ก:action_command_lines
-
หากจริง ระบบจะแชร์ไลบรารีเนทีฟที่มีฟังก์ชันการทำงานเหมือนกันกับเป้าหมายต่างๆ
แท็ก:loading_and_analysis
,affects_outputs
- ค่าเริ่มต้น
--[no]stamp
: "เท็จ" -
ประทับไบนารีด้วยวันที่ ชื่อผู้ใช้ ชื่อโฮสต์ ข้อมูลพื้นที่ทำงาน ฯลฯ
แท็ก:affects_outputs
- ค่าเริ่มต้น
--strip=<always, sometimes or never>
: "บางครั้ง" -
ระบุว่าจะตัดไบนารีและไลบรารีที่แชร์หรือไม่ (โดยใช้ "-Wl,--strip-debug") ค่าเริ่มต้นของ "บางครั้ง" หมายถึง Strip iff --compilation_mode=fastbuild
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--stripopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งไปยังการตัดเมื่อสร้าง "<name>.strped" 2.
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--swiftcopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยังการคอมไพล์ Swift
แท็ก:action_command_lines
- ค่าเริ่มต้น
--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
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--watchos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple WatchOS
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน WatchOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ได้ระบุ ให้ใช้ "watchos_sdk_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--xbinary_fdo=<a build target label>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ XbinaryFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อของโปรไฟล์แบบไบนารีที่เป็นค่าเริ่มต้น เมื่อใช้ตัวเลือกนี้ร่วมกับ --fdo_instrument/--fdo_optimize/--fdo_profile ตัวเลือกเหล่านั้นจะมีผลเหนือกว่าเสมอเสมือนว่าไม่ได้ระบุ xbinary_fdo
แท็ก:affects_outputs
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตบิลด์ที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมธง ฯลฯ)
- ค่าเริ่มต้นของ
--auto_cpu_environment_group=<a build target label>
: "" -
ประกาศ cloud_group ที่จะใช้ในการแมปค่า CPU กับค่า target_environment โดยอัตโนมัติ
แท็ก:changes_inputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]check_licenses
: "เท็จ" -
ตรวจสอบว่าข้อจำกัดในการออกใบอนุญาตที่กำหนดโดยแพ็กเกจที่เกี่ยวข้องไม่ขัดแย้งกับโหมดการเผยแพร่ของเป้าหมายที่กำลังสร้าง โดยค่าเริ่มต้น ใบอนุญาตจะไม่ได้รับการตรวจสอบ
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]check_visibility
: "true" -
หากปิดใช้ ระบบจะลดระดับข้อผิดพลาดระดับการเข้าถึงในทรัพยากร Dependency เป้าหมายให้เหลือเพียงคําเตือน
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]desugar_for_android
: "true" -
เลือกว่าจะใช้ไบต์โค้ด Java 8 ก่อนถอดรหัสหรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--[no]desugar_java8_libs
: "เท็จ" -
เลือกว่าจะรวมไลบรารี Java 8 ที่รองรับในแอปสำหรับอุปกรณ์เดิมหรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]enforce_constraints
: "true" -
ตรวจสอบสภาพแวดล้อมที่แต่ละเป้าหมายใช้งานร่วมกันได้ และรายงานข้อผิดพลาดหากเป้าหมายมีทรัพยากร Dependency ที่ไม่รองรับสภาพแวดล้อมเดียวกัน
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]experimental_allow_android_library_deps_without_srcs
: "เท็จ" -
แจ้งเพื่อช่วยให้เปลี่ยนจากการอนุญาตเป็นไม่อนุญาตกฎ android_library ที่ไม่มี srcs ด้วย dep คุณต้องล้าง Depot เพื่อเริ่มใช้งานโดยค่าเริ่มต้น
แท็ก:eagerness_to_exit
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_check_desugar_deps
: "true" -
ตรวจสอบความถูกต้องของการแยกน้ำตาลที่ระดับไบนารีของ Android อีกครั้งหรือไม่
แท็ก:eagerness_to_exit
,loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--experimental_import_deps_checking=<off, warning or error>
: "ปิด" -
เมื่อเปิดใช้ ให้ตรวจสอบว่าทรัพยากร Dependency ของ aar_IMPORT เสร็จสมบูรณ์หรือไม่ การบังคับใช้นี้อาจทำให้บิลด์เสียหายหรืออาจทำให้เกิดคำเตือน
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "ค่าเริ่มต้น" -
หากเป็นจริง ให้ตรวจสอบว่าเป้าหมาย Java ประกาศเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency อย่างชัดเจน
แท็ก:build_file_semantics
eagerness_to_exit
- ค่าเริ่มต้น
--[no]incompatible_check_testonly_for_output_files
: "เท็จ" -
หากเปิดใช้ ให้ตรวจสอบ testonly สำหรับเป้าหมายที่จำเป็นเบื้องต้นที่เป็นไฟล์เอาต์พุตโดยค้นหา testonly ของกฎที่สร้าง รายการนี้ตรงกับการตรวจสอบระดับการเข้าถึง
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disable_native_android_rules
: "เท็จ" -
หากเปิดใช้ ระบบจะปิดใช้กฎที่มีอยู่สำหรับ Android โดยตรง โปรดใช้กฎของ Android Starlark จาก https://github.com/bazelbuild/rules_android
แท็ก:eagerness_to_exit
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disable_native_apple_binary_rule
: "เท็จ" -
ไม่มีการดำเนินการ เก็บไว้ที่นี่เพื่อดูความเข้ากันได้แบบย้อนหลัง
แท็ก:eagerness_to_exit
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_force_strict_header_check_from_starlark
: "true" -
หากเปิดใช้ ให้ตั้งค่าการตรวจสอบส่วนหัวที่เข้มงวดใน Starlark API
แท็ก:loading_and_analysis
,changes_inputs
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_validate_top_level_header_inclusions
: "true" -
หากเป็นจริง Bazel จะตรวจสอบการรวมส่วนหัวไดเรกทอรีระดับบนสุดด้วย (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/10047)
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]strict_filesets
: "เท็จ" -
หากเปิดใช้ตัวเลือกนี้ ระบบจะรายงานว่าชุดไฟล์ข้ามขอบเขตของแพ็กเกจเป็นข้อผิดพลาด และจะไม่ทำงานเมื่อปิดใช้ check_fileset_dependencies_recursively
แท็ก:build_file_semantics
eagerness_to_exit
- ค่าเริ่มต้น
--strict_proto_deps=<off, warn, error, strict or default>
: "ข้อผิดพลาด" -
หากไม่ "ปิด" ให้ตรวจสอบว่าเป้าหมาย protocol_library ประกาศอย่างชัดแจ้งว่าเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้นของ
--strict_public_imports=<off, warn, error, strict or default>
: "ปิด" -
หากไม่ "ปิด" ให้ตรวจสอบว่าเป้าหมาย protocol_library ประกาศอย่างชัดเจนถึงเป้าหมายทั้งหมดที่ใช้ใน "นำเข้าสาธารณะ" ตามที่ส่งออกแล้ว
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้น
--[no]strict_system_includes
: "เท็จ" -
หากเป็น "จริง" ส่วนหัวที่พบผ่านทางระบบรวมเส้นทาง (-isystem) ต้องมีการประกาศด้วย
แท็ก:loading_and_analysis
eagerness_to_exit
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--target_environment=<a build target label>
รายการ -
ประกาศสภาพแวดล้อมเป้าหมายของบิลด์นี้ ต้องอ้างอิงถึงป้ายกำกับไปยัง "สภาพแวดล้อม" กฎ หากระบุ เป้าหมายระดับบนสุดทั้งหมดต้องเข้ากันได้กับสภาพแวดล้อมนี้
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อเอาต์พุตการลงชื่อของบิลด์:
- ค่าเริ่มต้น
--apk_signing_method=<v1, v2, v1_v2 or v4>
: "v1_v2" -
การใช้งานเพื่อรับรอง APK
แท็ก:action_command_lines
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--[no]device_debug_entitlements
: "true" -
หากมีการตั้งค่า และโหมดการคอมไพล์ไม่ใช่ "เพิ่มประสิทธิภาพ" แอป objc จะรวมการให้สิทธิ์การแก้ไขข้อบกพร่องเมื่อลงชื่อ
แท็ก:changes_inputs
- ค่าเริ่มต้น
--ios_signing_cert_name=<a string>
: ดูคำอธิบาย -
ชื่อใบรับรองที่จะใช้สำหรับ iOS Signing หากไม่ได้ตั้งค่า ระบบจะกลับไปใช้โปรไฟล์การจัดสรร อาจเป็นค่ากำหนดข้อมูลประจำตัว Keychain ของใบรับรองหรือ (สตริงย่อย) ของชื่อสามัญของใบรับรองตามหน้า man ของ Codesign (รหัสการลงชื่อเข้าใช้)
แท็ก:action_command_lines
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_config_setting_private_default_visibility
: "เท็จ" -
หากไม่รองรับ _enforce_config_setting_visibility=false ค่าจะเป็น Noop หรือไม่เช่นนั้น หากแฟล็กนี้เป็นเท็จ config_setting ใดๆ ที่ไม่มีแอตทริบิวต์การเปิดเผยอย่างชัดแจ้งจะเป็น //visibility:public หากแฟล็กนี้เป็นจริง config_setting จะใช้ตรรกะระดับการเข้าถึงเดียวกันกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disallow_legacy_py_provider
: "true" -
ไม่มีการดำเนินการ จะถูกนำออกในเร็วๆ นี้
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_enforce_config_setting_visibility
: "true" -
หากเป็น "จริง" ให้บังคับใช้การจำกัดระดับการเข้าถึง config_setting หากเป็น "เท็จ" ทุก config_setting จะปรากฏแก่เป้าหมายทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
incompatible_change
- สภาพแวดล้อมการทดสอบหรือตัวดำเนินการทดสอบ:
- ค่าเริ่มต้น
--[no]allow_analysis_failures
: "เท็จ" -
หากจริง การวิเคราะห์เป้าหมายของกฎไม่สำเร็จส่งผลให้เกิดการเผยแพร่อินสแตนซ์ของ AnalysisFailureInfo ของเป้าหมายที่มีคำอธิบายข้อผิดพลาด แทนที่จะทำให้บิลด์ไม่สำเร็จ
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--analysis_testing_deps_limit=<an integer>
: "2000" -
ตั้งค่าจำนวนสูงสุดของทรัพยากร Dependency แบบทรานซิทีฟผ่านแอตทริบิวต์กฎที่มีการเปลี่ยนการกำหนดค่า for_analysis_testing การใช้เกินขีดจำกัดนี้จะทำให้เกิดข้อผิดพลาดของกฎ
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]break_build_on_parallel_dex2oat_failure
: "เท็จ" -
หากความล้มเหลวจริงในการดำเนินการ dex2oat จะทำให้บิลด์เสียหายแทนที่จะเรียกใช้ dex2oat ระหว่างรันไทม์ทดสอบ
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--[no]check_tests_up_to_date
: "เท็จ" -
โดยไม่ต้องทำการทดสอบ เพียงแต่ต้องตรวจสอบว่าการทดสอบเป็นข้อมูลล่าสุดหรือไม่ หากผลการทดสอบทั้งหมดเป็นปัจจุบัน แสดงว่าการทดสอบเสร็จสมบูรณ์ หากต้องสร้างหรือดำเนินการทดสอบใดๆ ระบบจะรายงานข้อผิดพลาดและการทดสอบจะไม่สำเร็จ ตัวเลือกนี้กล่าวเป็นนัยถึงลักษณะการทำงาน --check_up_to_date
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_android_use_parallel_dex2oat
: "เท็จ" -
ใช้ dex2oat แบบขนานเพื่อเร่งความเร็ว android_test
แท็ก:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
รายการ -
ในกรณีที่การทดสอบล้มเหลว ระบบจะพยายามทดสอบซ้ำจนถึงจำนวนครั้งที่ระบุไว้ การทดสอบที่ต้องผ่านมากกว่า 1 ครั้งจะมีการทำเครื่องหมายเป็น "FLAKY" ในสรุปการทดสอบ โดยปกติแล้ว ค่าที่ระบุจะเป็นแค่จำนวนเต็มหรือสตริง "ค่าเริ่มต้น" หากเป็นจำนวนเต็ม การทดสอบทั้งหมดจะทำงานได้ไม่เกิน N ครั้ง หากเป็น "ค่าเริ่มต้น" ระบบจะพยายามทดสอบเพียงครั้งเดียวสำหรับการทดสอบปกติ และอีก 3 ครั้งสำหรับการทดสอบที่มีการทำเครื่องหมายอย่างชัดแจ้งว่า "ไม่สม่ำเสมอ" ตามกฎ (แอตทริบิวต์ flaky=1) ไวยากรณ์อื่น: regex_filter@flaky_test_attempts flaky_test_attempts เหมือนกับข้างต้น และ regex_filter ย่อมาจากรายการรวมและยกเว้นรูปแบบนิพจน์ทั่วไป (โปรดดู --runs_per_test) ตัวอย่าง: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 ดีเฟลกการทดสอบทั้งหมดใน //foo/ ยกเว้นการทดสอบที่อยู่ภายใต้ foo/bar 3 ครั้ง ตัวเลือกนี้ส่งได้หลายครั้ง อาร์กิวเมนต์ที่ส่งผ่านล่าสุดที่ตรงกันจะมีความสำคัญเหนือกว่า หากไม่มีผลลัพธ์ที่ตรงกัน ลักษณะการทำงานจะเป็นเหมือน "ค่าเริ่มต้น" ที่ด้านบน
แท็ก:execution
- ค่าเริ่มต้น
--[no]ios_memleaks
: "เท็จ" -
เปิดใช้การตรวจหาหน่วยความจำรั่วไหลในเป้าหมาย ios_test
แท็ก:action_command_lines
- ค่าเริ่มต้น
--ios_simulator_device=<a string>
: ดูคำอธิบาย -
อุปกรณ์ที่จะจำลองเมื่อเรียกใช้แอปพลิเคชัน iOS ในเครื่องมือจำลอง เช่น "iPhone 6" คุณดูรายการอุปกรณ์ได้โดยเรียกใช้ "xcrun simctl list devicetypes" บนเครื่องที่เครื่องมือจำลองจะทำงาน
แท็ก:test_runner
- ค่าเริ่มต้น
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชันของ iOS ที่จะเรียกใช้บนเครื่องมือจำลองเมื่อทำงานหรือทดสอบ ระบบจะไม่สนใจกฎ ios_test หากกฎระบุอุปกรณ์เป้าหมายไว้ในกฎ
แท็ก:test_runner
- ค่าเริ่มต้น
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "อัตโนมัติ" -
จำนวนงานทดสอบในเครื่องที่จะเรียกใช้พร้อมกันสูงสุด ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") โดยจะเลือกตามด้วยการดำเนินการ ([-|*]<Float>) เช่น "auto", "HOST_CPUS*.5" 0 หมายความว่าทรัพยากรในเครื่องจะจำกัดจำนวนงานทดสอบในเครื่องที่จะเรียกใช้พร้อมกันแทน การตั้งค่านี้ที่มากกว่าค่าสำหรับ --jobs จะไม่มีผล
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
รายการ - ระบุจำนวนครั้งที่จะทำการทดสอบแต่ละครั้ง หากการดำเนินการเหล่านั้นล้มเหลวไม่ว่าด้วยเหตุผลใดก็ตาม จะถือว่าการทดสอบทั้งหมดไม่ผ่าน โดยปกติแล้ว ค่าที่ระบุจะเป็นแค่จำนวนเต็ม ตัวอย่าง: --runs_per_test=3 จะทำการทดสอบทั้งหมด 3 ครั้ง ไวยากรณ์สำรอง: regex_filter@runs_per_test โดย running_per_test ย่อมาจากค่าจำนวนเต็ม ส่วน regex_filter หมายถึงรายการรูปแบบการรวมและยกเว้นรูปแบบนิพจน์ทั่วไป (โปรดดู --instrumentation_filter) ตัวอย่างเช่น --runs_per_test=//foo/.*,-//foo/bar/.*@3 จะทำการทดสอบทั้งหมดใน //foo/ ยกเว้นการทดสอบภายใต้ foo/bar 3 ครั้ง ตัวเลือกนี้ส่งได้หลายครั้ง อาร์กิวเมนต์ที่ส่งผ่านล่าสุดที่ตรงกันจะมีความสำคัญเหนือกว่า หากไม่มีผลลัพธ์ที่ตรงกัน ระบบจะทำการทดสอบเพียงครั้งเดียว
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--test_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุตัวแปรสภาพแวดล้อมเพิ่มเติมที่จะแทรกลงในสภาพแวดล้อมตัวดำเนินการทดสอบ คุณระบุตัวแปรได้โดยใช้ชื่อ ซึ่งในกรณีนี้ระบบจะอ่านค่าของตัวแปรจากสภาพแวดล้อมไคลเอ็นต์ Bazel หรือด้วยคู่ชื่อ=ค่า ตัวเลือกนี้ใช้ได้หลายครั้งเพื่อระบุตัวแปรหลายรายการ ใช้เฉพาะโดย "การทดสอบ bazel" เท่านั้น คำสั่ง
แท็ก:test_runner
- ค่าเริ่มต้น
--[no]test_keep_going
: "true" -
เมื่อปิดใช้ การทดสอบที่ไม่ผ่านจะทำให้ทั้งบิลด์หยุดทำงาน โดยค่าเริ่มต้น ระบบจะทำการทดสอบทั้งหมดแม้ว่าจะไม่ผ่านก็ตาม
แท็ก:execution
- ค่าเริ่มต้นของ
--test_strategy=<a string>
: "" -
ระบุกลยุทธ์ที่จะใช้เมื่อทำการทดสอบ
แท็ก:execution
- ค่าเริ่มต้น
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - ลบล้างค่าระยะหมดเวลาในการทดสอบเริ่มต้นสำหรับระยะหมดเวลาทดสอบ (เป็นวินาที) หากระบุค่าจำนวนเต็มบวกค่าเดียว ค่าดังกล่าวจะแทนที่หมวดหมู่ทั้งหมด หากระบุจำนวนเต็มที่คั่นด้วยคอมมา 4 ตัวเลข ค่าดังกล่าวจะลบล้างระยะหมดเวลาสำหรับแบบสั้น ปานกลาง ยาว และนิรันดร์ (ตามลำดับนั้น) ไม่ว่าจะเป็นรูปแบบใด ค่า -1 จะบอกให้ Blaze ใช้ระยะหมดเวลาเริ่มต้นสำหรับหมวดหมู่นั้น
- ค่าเริ่มต้น
--test_tmpdir=<a path>
: ดูคำอธิบาย - ระบุไดเรกทอรีชั่วคราวพื้นฐานสําหรับ "การทดสอบ Bazel" ในการใช้กัน
- ค่าเริ่มต้น
--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
: "true" -
หากเป็น "จริง" ระบบจะเก็บเอาต์พุตทดสอบที่ไม่ได้ประกาศไว้ในไฟล์ ZIP
แท็ก:test_runner
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพเวลาของบิลด์
- ค่าเริ่มต้น
--[no]collapse_duplicate_defines
: "เท็จ" -
เมื่อเปิดใช้ ระบบจะนำการกำหนดซ้ำซ้อนออกในตอนต้นของบิลด์ การดำเนินการนี้จะหลีกเลี่ยงการสูญเสียแคชการวิเคราะห์โดยไม่จำเป็นสำหรับบิลด์บางประเภทที่เทียบเท่า
แท็ก:loading_and_analysis
loses_incremental_state
- ค่าเริ่มต้น
--[no]experimental_filter_library_jar_with_program_jar
: "เท็จ" -
กรอง ProGuard ProgramJar เพื่อนำชั้นเรียนที่อยู่ใน LibraryJar ออกด้วย
แท็ก:action_command_lines
- ค่าเริ่มต้น
--[no]experimental_inmemory_dotd_files
: "true" -
หากเปิดใช้ ระบบจะส่งไฟล์ C++ .d ในหน่วยความจำโดยตรงจากโหนดบิลด์ระยะไกลแทนที่จะถูกเขียนลงในดิสก์
แท็ก:loading_and_analysis
,execution
,affects_outputs
,experimental
- ค่าเริ่มต้น
--[no]experimental_inmemory_jdeps_files
: "true" -
หากเปิดใช้ ไฟล์ทรัพยากร Dependency (.jdeps) ที่สร้างขึ้นจากการคอมไพล์ Java จะส่งผ่านในหน่วยความจำโดยตรงจากโหนดบิลด์ระยะไกลแทนที่จะถูกเขียนลงในดิสก์
แท็ก:loading_and_analysis
,execution
,affects_outputs
,experimental
- ค่าเริ่มต้น
--[no]experimental_objc_include_scanning
: "เท็จ" -
ระบุว่าจะทำการสแกนรวมสำหรับวัตถุประสงค์ C/C++ หรือไม่
แท็ก:loading_and_analysis
,execution
,changes_inputs
- ค่าเริ่มต้น
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
: "เท็จ" -
หากเปิดใช้ ฟีเจอร์ parse_headers จะไม่สร้างการดำเนินการคอมไพล์ส่วนหัวแยกต่างหากหากพบแหล่งที่มาที่มีชื่อฐานเดียวกันในเป้าหมายเดียวกัน
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้น
--[no]experimental_retain_test_configuration_across_testonly
: "เท็จ" -
เมื่อเปิดใช้ --trim_test_configuration จะไม่ตัดการกำหนดค่าการทดสอบสำหรับกฎที่ทำเครื่องหมายว่า testonly=1 ทั้งนี้เพื่อลดปัญหาความขัดแย้งในการดำเนินการเมื่อกฎที่ไม่ใช่การทดสอบต้องพึ่งพากฎ cc_test จะไม่มีผลหาก --trim_test_configuration เป็นเท็จ
แท็ก:loading_and_analysis
loses_incremental_state
- ค่าเริ่มต้น
--[no]experimental_starlark_cc_import
: "เท็จ" -
หากเปิดใช้ เวอร์ชัน Starlark ของ cc_import จะสามารถใช้ได้
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--[no]experimental_unsupported_and_brittle_include_scanning
: "เท็จ" -
เลือกว่าจะจำกัดอินพุตเฉพาะการคอมไพล์ C/C++ หรือไม่โดยการแยกวิเคราะห์ #include บรรทัดจากไฟล์อินพุต ซึ่งจะช่วยปรับปรุงประสิทธิภาพและส่วนเพิ่มด้วยการลดขนาดของแผนผังอินพุตสำหรับการคอมไพล์ อย่างไรก็ตาม ก็อาจทำให้บิลด์เสียหายได้เช่นกัน เนื่องจากเครื่องมือสแกนดังกล่าวไม่สามารถใช้งานความหมายของโปรเซสเซอร์ล่วงหน้าแบบ C ได้อย่างสมบูรณ์ โดยเฉพาะอย่างยิ่ง ระบบจะไม่เข้าใจคำสั่ง #include แบบไดนามิก และไม่สนใจตรรกะตามเงื่อนไขของตัวประมวลผลล่วงหน้า คุณต้องรับความเสี่ยงของการใช้งานเอง เราจะปิดปัญหาที่เกี่ยวข้องกับการแจ้งว่าไม่เหมาะสมนี้
แท็ก:loading_and_analysis
,execution
,changes_inputs
- ค่าเริ่มต้น
--[no]incremental_dexing
: "true" -
ส่วนใหญ่จะทำงานสำหรับ Dexing แยกต่างหากสำหรับไฟล์ Jar แต่ละไฟล์
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--[no]objc_use_dotd_pruning
: "true" -
หากตั้งค่าไว้ จะมีการใช้ไฟล์ .d ที่มาจาก clang เพื่อตัดชุดอินพุตที่ส่งผ่านเข้าไปในคอมไพล์ objc
แท็ก:changes_inputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]process_headers_in_dependencies
: "เท็จ" -
เมื่อสร้าง //a:a เป้าหมาย ให้ประมวลผลส่วนหัวในเป้าหมายทั้งหมดที่ //a:a ต้องใช้ (หากเปิดใช้การประมวลผลส่วนหัวสำหรับ Toolchain)
แท็ก:execution
- ค่าเริ่มต้น
--[no]trim_test_configuration
: "true" -
เมื่อเปิดใช้ ระบบจะล้างตัวเลือกที่เกี่ยวข้องกับการทดสอบซึ่งอยู่ใต้ระดับบนสุดของบิลด์ เมื่อแฟล็กนี้ทำงานอยู่ ระบบจะสร้างการทดสอบเป็นทรัพยากร Dependency ของกฎที่ไม่ใช่การทดสอบไม่ได้ แต่การเปลี่ยนแปลงตัวเลือกที่เกี่ยวข้องกับการทดสอบจะไม่ทำให้มีการวิเคราะห์กฎที่ไม่ใช่การทดสอบอีกครั้ง
แท็ก:loading_and_analysis
loses_incremental_state
- ค่าเริ่มต้น
--[no]use_singlejar_apkbuilder
: "true" -
ตัวเลือกนี้เลิกใช้งานแล้ว ไม่มีการดำเนินการแล้วและจะถูกนำออกในเร็วๆ นี้
แท็ก:loading_and_analysis
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
- ค่าเริ่มต้น
--[no]announce
: "เท็จ" -
เลิกใช้งานแล้ว ไม่มีการดำเนินการ
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_bep_target_summary
: "เท็จ" - ต้องการเผยแพร่เหตุการณ์ TargetSummary หรือไม่
- ค่าเริ่มต้น
--[no]experimental_build_event_expand_filesets
: "เท็จ" -
หากเป็น "จริง" ให้ขยายชุดไฟล์ใน BEP เมื่อนำเสนอไฟล์เอาต์พุต
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: "เท็จ" -
หากเป็น "จริง" ให้แปลค่าลิงก์สัญลักษณ์ของ Fileset สัมพัทธ์ทั้งหมดใน BEP เมื่อนำเสนอไฟล์เอาต์พุต ต้องมี --experimental_build_event_expand_filesset
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_build_event_upload_max_retries=<an integer>
: "4" -
จำนวนครั้งสูงสุดที่ Bazel ควรลองอัปโหลดเหตุการณ์บิลด์อีกครั้ง
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1s" -
เริ่มแรก ความล่าช้าขั้นต่ำสำหรับการลองใหม่แบบ Exponential Backoff เมื่ออัปโหลด BEP ไม่สำเร็จ (เลขชี้กำลัง: 1.6)
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--experimental_build_event_upload_strategy=<a string>
: ดูคำอธิบาย -
เลือกวิธีอัปโหลดอาร์ติแฟกต์ที่อ้างอิงในโปรโตคอลเหตุการณ์บิลด์
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_materialize_param_files_directly
: "เท็จ" -
หากทำให้ไฟล์พารามิเตอร์เป็นรูปธรรม ให้ดำเนินการดังกล่าวด้วยการเขียนไปยังดิสก์โดยตรง
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_stream_log_file_uploads
: "เท็จ" -
สตรีมไฟล์บันทึกจะอัปโหลดไปยังพื้นที่เก็บข้อมูลระยะไกลโดยตรงแทนการเขียนลงดิสก์
แท็ก:affects_outputs
- ค่าเริ่มต้น
--explain=<a path>
: ดูคำอธิบาย -
ทำให้ระบบบิลด์อธิบายแต่ละขั้นตอนที่ดำเนินการแล้วของบิลด์ ระบบจะเขียนคำอธิบายลงในไฟล์บันทึกที่ระบุ
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]legacy_important_outputs
: "true" -
ใช้อาร์กิวเมนต์นี้เพื่อระงับการสร้างช่อง legal_outputs เดิมในเหตุการณ์ TargetComplete ต้องใช้ required_outputs สำหรับการผสานรวม Bazel กับ ResultStore
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]materialize_param_files
: "เท็จ" -
เขียนไฟล์พารามิเตอร์ระดับกลางไปยังโครงสร้างเอาต์พุตแม้ในขณะที่ใช้การดำเนินการจากระยะไกล มีประโยชน์เมื่อมีการแก้ไขข้อบกพร่อง ซึ่งหมายถึง --subcommands และ --verbose_failures
แท็ก:execution
- ค่าเริ่มต้น
--max_config_changes_to_show=<an integer>
: "3" -
เมื่อทิ้งแคชการวิเคราะห์เนื่องจากการเปลี่ยนแปลงตัวเลือกบิลด์ จะแสดงชื่อตัวเลือกที่มีการเปลี่ยนแปลงตามจำนวนที่กำหนด ถ้าตัวเลขที่ระบุคือ -1 ตัวเลือกที่มีการเปลี่ยนแปลงทั้งหมดจะแสดง
แท็ก:terminal_output
- ค่าเริ่มต้น
--max_test_output_bytes=<an integer>
: "-1" -
ระบุขนาดสูงสุดของบันทึกต่อการทดสอบที่ส่งได้เมื่อ --test_output คือ "ข้อผิดพลาด" หรือ "ทั้งหมด" มีประโยชน์เพื่อหลีกเลี่ยงเอาต์พุตที่ไม่ได้ทำให้เอาต์พุตการทดสอบมีเสียงดังรบกวนมากเกินไป ส่วนหัวการทดสอบจะรวมอยู่ในขนาดบันทึก ค่าลบหมายถึงไม่มีขีดจำกัด เอาต์พุตทั้งหมดหรือไม่มีเลย
แท็ก:test_runner
,terminal_output
,execution
- ค่าเริ่มต้น
--output_filter=<a valid Java regular expression>
: ดูคำอธิบาย -
แสดงเฉพาะคำเตือนสำหรับกฎที่มีชื่อตรงกับนิพจน์ทั่วไปที่ระบุเท่านั้น
แท็ก:affects_outputs
- ค่าเริ่มต้น
--progress_report_interval=<an integer in 0-3600 range>
: "0" -
จำนวนวินาทีระหว่างรายงานในงานที่ยังทำงานอยู่ ค่าเริ่มต้น 0 หมายความว่าระบบจะพิมพ์รายงานแรกหลังผ่านไป 10 วินาที จากนั้นจะแสดงเป็นเวลา 30 วินาที หลังจากนั้นจะมีการรายงานความคืบหน้า 1 ครั้งในทุกๆ นาที เมื่อเปิดใช้งาน --curses จะมีการรายงานความคืบหน้าทุกวินาที
แท็ก:affects_outputs
- ค่าเริ่มต้น
--show_result=<an integer>
: "1" -
แสดงผลลัพธ์ของบิลด์ สำหรับแต่ละเป้าหมาย ให้ระบุว่าเป็นข้อมูลล่าสุดหรือไม่ และหากใช่ ให้แจ้งรายการไฟล์เอาต์พุตที่สร้างขึ้น ไฟล์ที่พิมพ์เป็นสตริงที่สะดวกสำหรับการคัดลอก+วางลงใน Shell เพื่อเรียกใช้ไฟล์
ตัวเลือกนี้ต้องใช้อาร์กิวเมนต์จำนวนเต็ม ซึ่งเป็นจำนวนเกณฑ์ของเป้าหมายด้านบนซึ่งระบบจะไม่พิมพ์ข้อมูลผลลัพธ์ ดังนั้น 0 จะทำให้มีการระงับข้อความและ MAX_INT จะทำให้มีการพิมพ์ผลลัพธ์เสมอ ค่าเริ่มต้นคือ 1
แท็ก:affects_outputs
--[no]subcommands
[-s
] ค่าเริ่มต้น: "เท็จ"-
แสดงคำสั่งย่อยที่ดำเนินการระหว่างบิลด์ แฟล็กที่เกี่ยวข้อง: --execution_log_json_file, --execution_log_binary_file (สำหรับการบันทึกคำสั่งย่อยไปยังไฟล์ในรูปแบบที่ง่ายต่อการใช้เครื่องมือ)
แท็ก:terminal_output
- ค่าเริ่มต้น
--test_output=<summary, errors, all or streamed>
: "summary" -
ระบุโหมดเอาต์พุตที่ต้องการ ค่าที่ถูกต้องคือ "summary" เพื่อแสดงเฉพาะสรุปสถานะการทดสอบ "ข้อผิดพลาด" เพื่อพิมพ์บันทึกการทดสอบสำหรับการทดสอบที่ล้มเหลวด้วย "ทั้งหมด" เพื่อพิมพ์บันทึกสำหรับการทดสอบทั้งหมดและ "สตรีม" เพื่อส่งออกบันทึกสำหรับการทดสอบทั้งหมดในแบบเรียลไทม์ (การดำเนินการนี้จะบังคับให้ดำเนินการทดสอบในเครื่องครั้งละ 1 รายการโดยไม่คำนึงถึงค่า --test_strategy)
แท็ก:test_runner
,terminal_output
,execution
- ค่าเริ่มต้นของ
--test_summary=<short, terse, detailed, none or testcase>
: "สั้น" -
ระบุรูปแบบของสรุปการทดสอบที่ต้องการ ค่าที่ถูกต้องคือ "short" เพื่อพิมพ์ข้อมูลเกี่ยวกับการทดสอบที่ดําเนินการเท่านั้น "แบบละเอียด" เพื่อพิมพ์เฉพาะข้อมูลเกี่ยวกับการทดสอบที่ดําเนินการไม่สําเร็จเท่านั้น เช่น "แบบละเอียด" เพื่อพิมพ์ข้อมูลโดยละเอียดเกี่ยวกับกรอบการทดสอบที่ล้มเหลว เช่น "testcase" เพื่อพิมพ์สรุปในการแก้ปัญหากรอบการทดสอบ อย่าพิมพ์ข้อมูลโดยละเอียดเกี่ยวกับกรอบการทดสอบที่ล้มเหลวและ "ไม่มี" ที่จะละเว้นข้อมูลสรุป
แท็ก:terminal_output
- ค่าเริ่มต้น
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
พิมพ์ข้อมูลการแก้ไขข้อบกพร่องระหว่างการแปลง Toolchain แฟล็กจะใช้นิพจน์ทั่วไปซึ่งตรวจสอบกับประเภท Toolchain และเป้าหมายที่เฉพาะเจาะจงเพื่อดูว่าควรแก้ไขข้อบกพร่องใด นิพจน์ทั่วไปหลายรายการจะคั่นด้วยคอมมา แล้วระบบจะเลือกนิพจน์ทั่วไปแต่ละรายการแยกกัน หมายเหตุ: เอาต์พุตของ Flag นี้มีความซับซ้อนมากและน่าจะเป็นประโยชน์ต่อผู้เชี่ยวชาญด้านการแก้ไข Toolchain เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]verbose_explanations
: "เท็จ" -
เพิ่มรายละเอียดของคำอธิบายที่ออกหากเปิดใช้ --explain จะไม่มีผล หากไม่ได้เปิดใช้งาน --explain
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]verbose_failures
: "เท็จ" -
หากเรียกใช้คำสั่งไม่สำเร็จ ให้พิมพ์บรรทัดคำสั่งแบบเต็ม
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--aspects_parameters=<a 'name=value' assignment>
รายการ -
ระบุค่าของพารามิเตอร์ด้านบรรทัดคำสั่ง ค่าพารามิเตอร์แต่ละรายการจะระบุผ่าน <param_name>=<param_value> เช่น 'my_param=my_val' ที่ "my_param" คือพารามิเตอร์ของบางด้านในรายการ --aspects รายการ หรือจำเป็นต้องใช้สำหรับด้านใดด้านหนึ่งในรายการ ตัวเลือกนี้ใช้ได้หลายครั้ง อย่างไรก็ตาม ไม่อนุญาตให้กำหนดค่าให้กับพารามิเตอร์เดียวกันมากกว่า 1 ครั้ง
แท็ก:loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--flag_alias=<a 'name=value' flag alias>
รายการ -
ตั้งชื่อย่อสำหรับธง Starlark โดยใช้คู่คีย์-ค่าคู่เดียวในรูปแบบ "<key>=<value>" เป็นอาร์กิวเมนต์
แท็ก:changes_inputs
- ค่าเริ่มต้น
--[no]incompatible_default_to_explicit_init_py
: "เท็จ" -
แฟล็กนี้เปลี่ยนลักษณะการทำงานเริ่มต้นเพื่อไม่ให้สร้างไฟล์ __init__.py โดยอัตโนมัติในไฟล์การเรียกใช้ของเป้าหมาย Python อีกต่อไป แม่นยำเมื่อเป้าหมาย py_binary หรือ py_test ตั้งค่า legacy_create_init เป็น "auto" (ค่าเริ่มต้น) ระบบจะถือว่าเป็น "เท็จ" เมื่อมีการตั้งค่าแฟล็กนี้เท่านั้น ดู https://github.com/bazelbuild/bazel/issues/10076
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_py2_outputs_are_suffixed
: "true" -
หากเป็นจริง เป้าหมายที่สร้างในการกำหนดค่า Python 2 จะปรากฏภายใต้รูทเอาต์พุตที่มีคำต่อท้าย "-py2" ขณะที่เป้าหมายที่สร้างขึ้นสำหรับ Python 3 จะปรากฏในรูทที่ไม่มีส่วนต่อท้ายที่เกี่ยวข้องกับ Python ซึ่งหมายความว่าลิงก์สัญลักษณ์ความสะดวก "bazel-bin" จะชี้ไปยังเป้าหมาย Python 3 แทนที่จะเป็น Python 2 หากคุณเปิดใช้ตัวเลือกนี้ ขอแนะนำให้เปิดใช้ "--incompatible_py3_is_default" ด้วย
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_py3_is_default
: "true" -
หากเป็นจริง เป้าหมาย "py_binary" และ "py_test" ที่ไม่ได้ตั้งค่าแอตทริบิวต์ "python_version" (หรือ "default_python_version") จะมีค่าเริ่มต้นเป็น PY3 แทนที่จะเป็น PY2 หากตั้งค่าแฟล็กนี้ ขอแนะนำให้ตั้งค่า "--incompatible_py2_outputs_are_suffixed"
แท็ก:loading_and_analysis
,affects_outputs
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_use_python_toolchains
: "true" -
หากตั้งค่าเป็น "จริง" กฎ Python ในเครื่องที่เป็นไฟล์ปฏิบัติการจะใช้รันไทม์ของ Python ที่ระบุโดย Toolchain ของ Python แทนรันไทม์ที่มาจากแฟล็กเดิม เช่น --python_top
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--python_version=<PY2 or PY3>
: ดูคำอธิบาย -
โหมดเวอร์ชันหลักของ Python ไม่ว่าจะเป็น "PY2" หรือ "PY3" โปรดทราบว่าเป้าหมาย "py_binary" และ "py_test" จะลบล้างค่านี้ (แม้ว่าจะไม่ได้ระบุเวอร์ชันอย่างชัดเจน) จึงมักไม่มีเหตุผลที่จะต้องระบุแฟล็กนี้
แท็ก:loading_and_analysis
,affects_outputs
,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]build_manual_tests
: "เท็จ" - บังคับใช้เป้าหมายการทดสอบที่ติดแท็ก "ด้วยตนเอง" ให้เกิดขึ้นจริง "ด้วยตนเอง" การทดสอบจะไม่รวมอยู่ในการประมวลผล ตัวเลือกนี้จะบังคับให้ระบบสร้างรายงาน (แต่ไม่ต้องดำเนินการ)
- ค่าเริ่มต้นของ
--build_tag_filters=<comma-separated list of options>
: "" - ระบุรายการแท็กที่คั่นด้วยคอมมา แต่ละแท็กสามารถขึ้นต้นด้วย "-" หรือไม่ก็ได้ เพื่อระบุแท็กที่ยกเว้น ระบบจะสร้างเฉพาะเป้าหมายเหล่านั้นซึ่งมีแท็กที่รวมอยู่อย่างน้อย 1 แท็กและไม่มีแท็กที่ยกเว้น ตัวเลือกนี้ไม่มีผลกับชุดการทดสอบที่ดำเนินการด้วยคำสั่ง "test" (ทดสอบ) คำสั่ง; การควบคุมเหล่านั้นจะอยู่ภายใต้ตัวเลือกการกรองทดสอบ เช่น "--test_tag_filters"
- ค่าเริ่มต้น
--[no]build_tests_only
: "เท็จ" - หากระบุ ระบบจะสร้างเฉพาะกฎ *_test และ test_suite และจะไม่สนใจเป้าหมายอื่นๆ ที่ระบุในบรรทัดคำสั่ง โดยค่าเริ่มต้น ทุกอย่างที่ขอจะได้รับการสร้าง
--[no]cache_test_results
[-t
] ค่าเริ่มต้น: "อัตโนมัติ"- หากตั้งค่าเป็น "อัตโนมัติ" Bazel จะทำการทดสอบอีกครั้งเฉพาะในกรณีต่อไปนี้ (1) Bazel ตรวจพบการเปลี่ยนแปลงในการทดสอบหรือทรัพยากร Dependency (2) การทดสอบได้รับการทำเครื่องหมายว่าเป็นภายนอก (3) มีการขอทำการทดสอบหลายครั้งด้วย --runs_per_test หรือ(4) การทดสอบล้มเหลวก่อนหน้านี้ หากตั้งค่าเป็น "ใช่" Bazel จะแคชผลการทดสอบทั้งหมด ยกเว้นการทดสอบที่ทำเครื่องหมายว่าภายนอก หากตั้งค่าเป็น "ไม่" Bazel จะไม่แคชผลการทดสอบใดๆ
- ค่าเริ่มต้น
--[no]compile_one_dependency
: "เท็จ" - คอมไพล์ทรัพยากร Dependency เดียวของไฟล์อาร์กิวเมนต์ วิธีนี้มีประโยชน์ในการตรวจสอบไฟล์แหล่งที่มาใน IDE เช่น การสร้างเป้าหมายเดี่ยวขึ้นมาใหม่ให้อาศัยไฟล์ต้นฉบับ เพื่อตรวจหาข้อผิดพลาดให้เร็วที่สุดในรอบการแก้ไข/สร้าง/ทดสอบ อาร์กิวเมนต์นี้จะส่งผลต่อวิธีการตีความอาร์กิวเมนต์แบบไม่แจ้งทั้งหมด แทนที่จะกำหนดเป้าหมายในการสร้างเป็นชื่อไฟล์ต้นฉบับ สำหรับชื่อไฟล์ต้นฉบับแต่ละชื่อไฟล์ จะมีเป้าหมายที่กำหนดเองที่ขึ้นอยู่กับไฟล์ดังกล่าว
- ค่าเริ่มต้นของ
--deleted_packages=<comma-separated list of package names>
: "" - รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริงแม้ว่าจะปรากฏอยู่ที่ใดที่หนึ่งบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ เช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์ ระบบบิลด์อาจบ่นหากพบป้ายกำกับ "//x:y/z" ถ้ามีข้อมูลระบุโดยรายการpackage_path อื่นอยู่ การระบุ --deleted_packages x/y ช่วยป้องกันปัญหานี้
- ค่าเริ่มต้น
--[no]discard_analysis_cache
: "เท็จ" - ทิ้งแคชการวิเคราะห์ทันทีหลังจากที่ขั้นตอนการวิเคราะห์เสร็จสมบูรณ์แล้ว ลดการใช้งานหน่วยความจำประมาณ 10% แต่ทำให้บิลด์เพิ่มเติมช้าลง
- ค่าเริ่มต้น
--execution_log_binary_file=<a path>
: ดูคำอธิบาย - บันทึกการสร้างที่เรียกใช้ลงในไฟล์นี้เป็น Prot ของการสร้างเมืองที่คั่นด้วยข้อความตาม src/main/protocolbuf/spawn.protocol บันทึกจะมีการเขียนเป็นลำดับแรกโดยไม่เรียงลำดับ จากนั้นเมื่อสิ้นสุดการเรียกใช้ ระบบจะจัดเรียงตามลำดับที่เสถียร (อาจเป็น CPU และการใช้หน่วยความจำ) แฟล็กที่เกี่ยวข้อง: --execution_log_json_file (รูปแบบ json ของข้อความตามลำดับ), --experimental_execution_log_file (รูปแบบไบนารี Protobuf ที่ไม่เรียงลำดับ), --คำสั่งย่อย (สำหรับการแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
- ค่าเริ่มต้น
--execution_log_json_file=<a path>
: ดูคำอธิบาย - บันทึกคำสั่งสร้างที่เรียกใช้ลงในไฟล์นี้ในรูปแบบ json ของโปรโตคอล Spawn ที่คั่นด้วยอักขระ ตาม src/main/processbuf/spawn.protocol บันทึกจะมีการเขียนเป็นลำดับแรกโดยไม่เรียงลำดับ จากนั้นเมื่อสิ้นสุดการเรียกใช้ ระบบจะจัดเรียงตามลำดับที่เสถียร (อาจเป็น CPU และการใช้หน่วยความจำ) แฟล็กที่เกี่ยวข้อง: แฟล็กที่เกี่ยวข้อง: --execution_log_binary_file (รูปแบบไบนารีของโปรโตคอลที่เรียงลำดับ), --experimental_execution_log_file (รูปแบบไบนารีโปรโตบูฟที่ไม่เรียงลำดับ), --คำสั่งย่อย (สำหรับการแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
- ค่าเริ่มต้น
--[no]execution_log_sort
: "true" - เลือกว่าจะจัดเรียงบันทึกการดำเนินการหรือไม่ ตั้งค่าเป็น "เท็จ" เพื่อปรับปรุงประสิทธิภาพของหน่วยความจำ โดยใช้ต้นทุนในการสร้างบันทึกตามลำดับที่ไม่กำหนด
- ค่าเริ่มต้น
--[no]expand_test_suites
: "true" -
ขยายเป้าหมาย test_suite ไปยังการทดสอบส่วนประกอบก่อนการวิเคราะห์ เมื่อเปิดธงนี้ (ค่าเริ่มต้น) ระบบจะใช้รูปแบบเป้าหมายเชิงลบกับการทดสอบที่เป็นของชุดทดสอบ มิฉะนั้น ระบบจะไม่ใช้รูปแบบเป้าหมายเชิงลบ การปิดแฟล็กนี้มีประโยชน์เมื่อใช้ระดับบนสุดในบรรทัดคำสั่ง จากนั้นผู้ใช้จึงวิเคราะห์เป้าหมาย test_suite ได้
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_cancel_concurrent_tests
: "เท็จ" -
หากเป็น "จริง" Blaze จะยกเลิกการทดสอบพร้อมกันในการรันที่สำเร็จครั้งแรก วิธีนี้จะมีประโยชน์เมื่อใช้ร่วมกับ --runs_per_test_detects_flakes เท่านั้น
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--experimental_execution_log_file=<a path>
: ดูคำอธิบาย - บันทึกการสร้างที่เรียกใช้ลงในไฟล์นี้เป็น Prot ของการสร้างเมืองที่คั่นด้วยข้อความตาม src/main/protocolbuf/spawn.protocol ไฟล์นี้เขียนตามลำดับการดำเนินการของตัววางไข่ แฟล็กที่เกี่ยวข้อง: --execution_log_binary_file (รูปแบบไบนารีของโปรโตคอลที่เรียงลำดับ), --execution_log_json_file (รูปแบบ json ของข้อความตามลำดับ), --subcommands (สำหรับการแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
- ค่าเริ่มต้น
--[no]experimental_execution_log_spawn_metrics
: "เท็จ" - รวมเมตริกที่สร้างขึ้นในบันทึกการสร้างที่ดำเนินการแล้ว
- ค่าเริ่มต้นของ
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "" - เลิกใช้งานไปทีละด้าน ชุดตัวกรองเป้าหมายเพื่อตั้งเวลา extra_actions
- ค่าเริ่มต้น
--[no]experimental_extra_action_top_level_only
: "เท็จ" - เลิกใช้งานไปทีละด้าน ตั้งเวลาให้เฉพาะการดำเนินการเพิ่มเติมสำหรับเป้าหมายระดับบนสุดเท่านั้น
- ค่าเริ่มต้น
--[no]experimental_fetch_all_coverage_outputs
: "เท็จ" -
หากเป็น "จริง" Bazel จะดึงข้อมูลไดเรกทอรีข้อมูลการครอบคลุมทั้งหมดสำหรับการทดสอบแต่ละครั้งระหว่างการทำงานของการครอบคลุม
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_generate_llvm_lcov
: "เท็จ" -
หากเป็น "จริง" ความครอบคลุมของคําพูดจะสร้างรายงาน LCOV
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_j2objc_header_map
: "true" - เลือกว่าจะสร้างแผนที่ส่วนหัว J2ObjC ควบคู่ไปกับการแปลง J2ObjC หรือไม่
- ค่าเริ่มต้น
--[no]experimental_j2objc_shorter_header_path
: "เท็จ" -
เลือกว่าจะสร้างโดยใช้เส้นทางส่วนหัวที่สั้นกว่าหรือไม่ (ใช้ "_ios" แทน "_j2objc")
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_java_classpath=<off, javabuilder or bazel>
: "javabuilder" - เปิดใช้งานคลาสพาธที่ลดลงสำหรับการคอมไพล์ Java
- ค่าเริ่มต้น
--[no]experimental_limit_android_lint_to_android_constrained_java
: "เท็จ" -
จำกัด --experimental_run_android_lint_on_java_rules เฉพาะไลบรารีที่เข้ากันได้กับ Android
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_prioritize_local_actions
: "true" -
หากตั้งค่าไว้ การดำเนินการที่เรียกใช้ได้ในเครื่องเท่านั้นจะได้รับโอกาสแรกในการรับทรัพยากร โอกาสสำหรับผู้ปฏิบัติงานที่เรียกใช้แบบไดนามิกจะได้รับโอกาสครั้งที่ 2 และการดำเนินการแบบสแตนด์อโลนที่เรียกใช้แบบไดนามิกจะเป็นอันดับสุดท้าย
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_run_android_lint_on_java_rules
: "เท็จ" -
ระบุว่าจะตรวจสอบแหล่งที่มา java_* หรือไม่
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]explicit_java_test_deps
: "เท็จ" - ระบุทรัพยากร Dependency ของ JUnit หรือ Hamcrest อย่างชัดเจนใน java_test แทนที่จะได้มาจาก Dep ของ TestRunner โดยไม่ตั้งใจ ตอนนี้ใช้ได้กับ bazel เท่านั้น
- ค่าเริ่มต้น
--host_java_launcher=<a build target label>
: ดูคำอธิบาย - Java Launcher ที่เครื่องมือใช้ซึ่งดำเนินการในระหว่างบิลด์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_javacopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมในการส่งไปยัง Javac เมื่อสร้างเครื่องมือที่ดำเนินการระหว่างบิลด์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_jvmopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง Java VM เมื่อสร้างเครื่องมือสร้างที่ดำเนินการระหว่างบิลด์ ระบบจะเพิ่มตัวเลือกเหล่านี้ไปยังตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
- ค่าเริ่มต้น
--[no]incompatible_check_sharding_support
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่ผ่านการทดสอบชาร์ด หากตัวดำเนินการทดสอบไม่ได้ระบุว่ารองรับการชาร์ดดิ้งโดยการแตะไฟล์ที่เส้นทางใน TEST_SHARD_STATUS_FILE หากเป็นเท็จ ตัวดำเนินการทดสอบที่ไม่รองรับการชาร์ดจะนำไปยังการทดสอบทั้งหมดที่ทำงานในชาร์ดแต่ละรายการ
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_exclusive_test_sandboxed
: "เท็จ" -
หากจริง การทดสอบพิเศษจะทำงานโดยใช้กลยุทธ์แซนด์บ็อกซ์ เพิ่ม "ท้องถิ่น" เพื่อบังคับให้การทดสอบพิเศษทำงานภายในเครื่อง
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_strict_action_env
: "เท็จ" -
หากเป็นจริง Bazel จะใช้สภาพแวดล้อมที่มีค่าคงที่สำหรับ PATH และไม่รับค่า LD_LIBRARY_PATH ใช้ --action_env=ENV_VARIABLE หากคุณต้องการรับตัวแปรสภาพแวดล้อมที่เฉพาะเจาะจงจากไคลเอ็นต์ แต่โปรดทราบว่าการทำเช่นนี้อาจป้องกันการแคชข้ามผู้ใช้ได้หากมีการใช้แคชที่แชร์
แท็ก:loading_and_analysis
incompatible_change
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--j2objc_translation_flags=<comma-separated list of options>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยังเครื่องมือ J2ObjC
--java_debug
-
ทำให้เครื่องเสมือนของ Java ของการทดสอบ Java ต้องรอการเชื่อมต่อจากโปรแกรมแก้ไขข้อบกพร่องที่สอดคล้องกับ JDWP (เช่น jdb) ก่อนเริ่มการทดสอบ โดยนัย -test_output=streamed
ขยายเป็น
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- ค่าเริ่มต้น
--[no]java_deps
: "true" - สร้างข้อมูลทรัพยากร Dependency (ในขณะนี้คือคลาสพาธเวลาคอมไพล์) ต่อเป้าหมาย Java
- ค่าเริ่มต้น
--[no]java_header_compilation
: "true" - คอมไพล์จากต้นทางโดยตรง
- ค่าเริ่มต้น
--java_language_version=<a string>
: "8" - เวอร์ชันภาษา Java
- ค่าเริ่มต้น
--java_launcher=<a build target label>
: ดูคำอธิบาย - Java Launcher ที่จะใช้เมื่อสร้างไบนารีของ Java หากตั้งค่าสถานะนี้เป็นสตริงว่างเปล่า ระบบจะใช้ Launcher ของ JDK "Launcher" จะลบล้างแฟล็กนี้
--java_runtime_version=<a string>
ค่าเริ่มต้น: "local_jdk"- เวอร์ชันรันไทม์ของ Java
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--javacopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง Javac
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--jvmopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง Java VM ระบบจะเพิ่มตัวเลือกเหล่านี้ไปยังตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
- ค่าเริ่มต้น
--legacy_main_dex_list_generator=<a build target label>
: ดูคำอธิบาย - ระบุไบนารีที่จะใช้สร้างรายการคลาสที่ต้องอยู่ใน Dex หลักเมื่อคอมไพล์ Multidex เดิม
- ค่าเริ่มต้นของ
--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% จากการกำหนดค่านี้
- ค่าเริ่มต้น
--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>
ค่าเริ่มต้น: "@bazel_tools//tools/protocol:protocol"-
ป้ายกำกับของคอมไพเลอร์ Proto
แท็ก:affects_outputs
loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/protocol:cc_toolchain"-
ป้ายกำกับของ profto_lang_toolchain() ที่อธิบายวิธีคอมไพล์ C++ Proto
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/j2objc:j2objc_protocol_toolchain"-
ป้ายกำกับของ Proto_lang_toolchain() ที่อธิบายถึงวิธีคอมไพล์ j2objc Proto
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/protocol:java_toolchain"-
ป้ายกำกับของ protocol_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ Java Prot
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/protocol:javalite_toolchain"-
ป้ายกำกับของ Proto_lang_toolchain() ที่อธิบายถึงวิธีคอมไพล์ JavaLite Proto
แท็ก:affects_outputs
,loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--protocopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยังคอมไพเลอร์ Protocolbuf
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]runs_per_test_detects_flakes
: "เท็จ" - หากเป็นจริง ชาร์ดที่การเรียกใช้/ความพยายามอย่างน้อย 1 ครั้งผ่านและการเรียกใช้/ความพยายามอย่างน้อย 1 ครั้งล้มเหลวจะได้รับสถานะ FLAKY
- ค่าเริ่มต้น
--shell_executable=<a path>
: ดูคำอธิบาย -
เส้นทางสัมบูรณ์ไปยังเชลล์ปฏิบัติการของ Bazel ที่จะใช้ หากไม่ได้ตั้งค่านี้ แต่มีการตั้งค่าตัวแปรสภาพแวดล้อม BAZEL_SH ในการเรียกใช้ Bazel แรก (ซึ่งเริ่มต้นเซิร์ฟเวอร์ Bazel) Bazel จะใช้ตัวแปรนั้น หากไม่ได้ตั้งค่าไว้ Bazel จะใช้เส้นทางเริ่มต้นแบบฮาร์ดโค้ด โดยขึ้นอยู่กับระบบปฏิบัติการที่ใช้ (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, อื่นๆ ทั้งหมด: /bin/bash) โปรดทราบว่าการใช้ Shell ที่เข้ากันไม่ได้กับ Bash อาจทำให้บิลด์ล้มเหลวหรือรันไทม์ของไบนารีที่สร้างขึ้นไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]show_loading_progress
: "true" - หากเปิดใช้ จะทำให้ Bazel พิมพ์ "กำลังโหลดแพ็กเกจ:" ข้อความ
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--test_arg=<a string>
รายการ - ระบุตัวเลือกและอาร์กิวเมนต์เพิ่มเติมที่ควรส่งไปยังไฟล์ปฏิบัติการทดสอบ ซึ่งสามารถใช้หลายครั้งเพื่อระบุอาร์กิวเมนต์ได้หลายรายการ หากดำเนินการทดสอบหลายรายการ แต่ละรายการจะได้รับอาร์กิวเมนต์ที่เหมือนกัน ใช้เฉพาะโดย "การทดสอบ bazel" เท่านั้น คำสั่ง
- ค่าเริ่มต้น
--test_filter=<a string>
: ดูคำอธิบาย - ระบุตัวกรองที่จะส่งต่อไปยังเฟรมเวิร์กการทดสอบ ใช้เพื่อจำกัดการทดสอบ โปรดทราบว่าการเปลี่ยนแปลงนี้ไม่มีผลต่อเป้าหมายที่สร้างขึ้น
- ค่าเริ่มต้นของ
--test_lang_filters=<comma-separated list of options>
: "" - ระบุรายการภาษาทดสอบที่คั่นด้วยคอมมา แต่ละภาษาอาจนำหน้าด้วย '-' หรือไม่ก็ได้ เพื่อระบุภาษาที่ยกเว้น ระบบจะพบเฉพาะเป้าหมายทดสอบเหล่านั้นที่ใช้ภาษาที่ระบุ ชื่อที่ใช้สำหรับแต่ละภาษาควรเหมือนกับคำนำหน้าภาษาในกฎ *_test เช่น หนึ่งใน "cc", 'java', 'py' ฯลฯ ตัวเลือกนี้ส่งผลต่อพฤติกรรม --build_tests_only พฤติกรรม และคำสั่งทดสอบ
- ค่าเริ่มต้น
--test_result_expiration=<an integer>
: "-1" - ตัวเลือกนี้เลิกใช้งานแล้วและไม่ส่งผลใดๆ
- ค่าเริ่มต้น
--[no]test_runner_fail_fast
: "เท็จ" - การส่งต่อล้มเหลวตัวเลือกอย่างรวดเร็วไปยังตัวดำเนินการทดสอบ ตัวดำเนินการทดสอบควรหยุดการดำเนินการเมื่อล้มเหลวครั้งแรก
- ค่าเริ่มต้น
--test_sharding_strategy=<explicit or disabled>
: "อาจไม่เหมาะสม" - ระบุกลยุทธ์สำหรับการทดสอบชาร์ดดิ้ง: "Explicit" จะใช้ชาร์ดดิ้งก็ต่อเมื่อ "shard_count" เท่านั้น มีแอตทริบิวต์ BUILD "ปิดใช้" ว่าจะไม่ใช้ทดสอบชาร์ดดิ้ง
- ค่าเริ่มต้นของ
--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
: "true" - หากเปิดใช้ ตัวเลือกนี้จะทำให้การคอมไพล์ Java ใช้ jars อินเทอร์เฟซ ซึ่งจะทำให้การคอมไพล์แบบเพิ่มขึ้นเรื่อยๆ ได้เร็วขึ้น แต่ข้อความแสดงข้อผิดพลาดอาจแตกต่างกันได้
ตัวเลือกการตั้งค่าสถานะ Canonical
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชของที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่เกิดแคชแทนที่จะคัดลอก ซึ่งช่วยประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุไว้ ซึ่งจะทำให้การเปลี่ยนแปลง URL ส่งผลให้มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม สามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ทำให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--[no]experimental_repository_disable_download
: "เท็จ" -
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก: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
: "เท็จ" -
แสดงนโยบาย Canonical หลังจากการขยายและการกรอง เพื่อให้เอาต์พุตดูสะอาดตา อาร์กิวเมนต์คำสั่ง Canonical จะไม่แสดงเมื่อตั้งค่าตัวเลือกนี้เป็น "จริง" โปรดทราบว่าคำสั่งที่ระบุโดย --for_command จะมีผลกับนโยบายที่กรอง และหากไม่มีการระบุไว้ คำสั่งเริ่มต้นจะเป็น "build"
แท็ก:affects_outputs
terminal_output
- ค่าเริ่มต้น
--[no]show_warnings
: "เท็จ" -
เอาต์พุตของคำเตือนโปรแกรมแยกวิเคราะห์เป็นข้อผิดพลาดมาตรฐาน (เช่น สำหรับตัวเลือกการตั้งค่าสถานะที่ขัดแย้งกัน)
แท็ก: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 หรือ API บิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
ไม่มีการดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ค่าเริ่มต้น
--[no]incompatible_config_setting_private_default_visibility
: "เท็จ" -
หากไม่รองรับ _enforce_config_setting_visibility=false ค่าจะเป็น Noop หรือไม่เช่นนั้น หากแฟล็กนี้เป็นเท็จ config_setting ใดๆ ที่ไม่มีแอตทริบิวต์การเปิดเผยอย่างชัดแจ้งจะเป็น //visibility:public หากแฟล็กนี้เป็นจริง config_setting จะใช้ตรรกะระดับการเข้าถึงเดียวกันกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_enforce_config_setting_visibility
: "true" -
หากเป็น "จริง" ให้บังคับใช้การจำกัดระดับการเข้าถึง config_setting หากเป็น "เท็จ" ทุก config_setting จะปรากฏแก่เป้าหมายทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
incompatible_change
- :
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันโมดูลในรูปแบบ "<module1>@<version1>,<module2>@<version2>" ซึ่งจะได้รับอนุญาตในกราฟทรัพยากร Dependency ที่ได้รับการแก้ไขแล้ว แม้ว่าจะมีการประกาศเวอร์ชันในรีจิสทรีในที่มาของเวอร์ชัน (หากไม่ได้มาจาก NonRegistryOverride) มิเช่นนั้น เวอร์ชันที่แยกออกมาจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันแยกที่อนุญาตด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" ได้ด้วย คุณสามารถปิดการตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้กับเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" ที่ส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" ให้พิมพ์คำเตือนเมื่อตรวจพบข้อมูลที่ไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟทรัพยากร Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" ให้พิมพ์คำเตือนเมื่อตรวจพบข้อมูลไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อยกระดับการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะไม่สนใจทรัพยากร Dependency สำหรับนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูทไม่ว่าค่าของแฟล็กนี้จะเป็นอะไร
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--lockfile_mode=<off, update or error>
: "อัปเดต" -
ระบุวิธีและวิธีใช้ล็อกไฟล์ ค่าที่ถูกต้องคือ "อัปเดต" เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง "ข้อผิดพลาด" ในการใช้ไฟล์ล็อกแต่เกิดข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" ไม่อ่านหรือเขียนไปยังไฟล์ล็อก
แท็ก:loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--override_module=<an equals-separated mapping of module name to path>
รายการ - ลบล้างโมดูลด้วยเส้นทางภายในในรูปแบบ <module name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์ ระบบจะใช้เส้นทางตามที่เป็น ถ้าเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพัทธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางดังกล่าวจะสัมพัทธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--registry=<a string>
รายการ -
ระบุรีจิสทรีที่จะใช้ในการค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับเป็นสิ่งสำคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีในภายหลังเมื่อไม่มีรีจิสทรีที่ขาดหายไป
แท็ก:changes_inputs
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
- ค่าเริ่มต้น
--[no]experimental_record_metrics_for_all_mnemonics
: "เท็จ" - โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจำกัดอยู่ที่ 20 รายการที่มีการกระทำมากที่สุด การตั้งค่าตัวเลือกนี้จะเป็นการเขียนสถิติสำหรับการช่วยจำทั้งหมด
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ค่าเริ่มต้นของ
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
หากไม่ว่างเปล่า ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ค่าเริ่มต้น
--for_command=<a string>
: "สร้าง" -
คำสั่งที่ควรกำหนดตัวเลือกให้เป็นหน้า Canonical
แท็ก:affects_outputs
terminal_output
- ค่าเริ่มต้นของ
--invocation_policy=<a string>
: "" -
ใช้นโยบายการเรียกใช้กับตัวเลือกที่จะกำหนดเวอร์ชัน Canonical
แท็ก:affects_outputs
terminal_output
- ค่าเริ่มต้น
--experimental_downloader_config=<a string>
: ดูคำอธิบาย - ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด แต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือสองรูปแบบ รูปแบบหนึ่งจะจับคู่กัน และอีกรูปแบบหนึ่งใช้เป็น URL ทดแทน โดยมีการอ้างอิงกลับเริ่มตั้งแต่ "$1" เป็นไปได้ที่จะมีการใช้คำสั่ง "rewrite" หลายคำสั่งสำหรับ URL เดียวกัน และในกรณีนี้ระบบจะส่งคืน 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>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์ ระบบจะใช้เส้นทางตามที่เป็น ถ้าเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพัทธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางดังกล่าวจะสัมพัทธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"
- ค่าเริ่มต้นของ
--package_path=<colon-separated list of options>
: "%workspace%" - รายการตำแหน่งที่จะค้นหาแพ็กเกจที่คั่นด้วยโคลอน องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับพื้นที่ทำงานที่ล้อมรอบอยู่ หากไม่ระบุหรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
- ค่าเริ่มต้น
--[no]show_loading_progress
: "true" - หากเปิดใช้ จะทำให้ Bazel พิมพ์ "กำลังโหลดแพ็กเกจ:" ข้อความ
ตัวเลือกในการล้างข้อมูล
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชของที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่เกิดแคชแทนที่จะคัดลอก ซึ่งช่วยประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุไว้ ซึ่งจะทำให้การเปลี่ยนแปลง URL ส่งผลให้มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม สามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ทำให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--[no]experimental_repository_disable_download
: "เท็จ" -
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก: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
: "เท็จ" -
หากเป็น "จริง" การล้างเอาต์พุตจะเป็นแบบไม่พร้อมกัน เมื่อคำสั่งนี้เสร็จสิ้น คำสั่งใหม่ในไคลเอ็นต์เดียวกันจะปลอดภัย แม้การลบอาจดำเนินการต่ออยู่เบื้องหลังก็ตาม
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้น
--[no]expunge
: "เท็จ" -
หากเป็น "จริง" การล้างจะนำโครงสร้างการทำงานทั้งหมดของอินสแตนซ์ Bazel ออก ซึ่งรวมถึงไฟล์เอาต์พุตชั่วคราวและสร้างไฟล์เอาต์พุตที่สร้างขึ้นด้วย Bazel ทั้งหมด และหยุดเซิร์ฟเวอร์ bazel หากทำงาน
แท็ก:host_machine_resource_optimizations
--expunge_async
-
หากระบุไว้ ให้ล้างแบบไม่พร้อมกันจะนำโครงสร้างการทำงานทั้งหมดสำหรับอินสแตนซ์ Bazel ออก ซึ่งรวมถึงไฟล์เอาต์พุตชั่วคราวและสร้างไฟล์เอาต์พุตที่สร้างขึ้นด้วย Bazel ทั้งหมด และหยุดเซิร์ฟเวอร์ Bazel หากเซิร์ฟเวอร์ดังกล่าวทำงานอยู่ เมื่อคำสั่งนี้เสร็จสิ้น คำสั่งใหม่ในไคลเอ็นต์เดียวกันจะปลอดภัย แม้การลบอาจดำเนินการต่ออยู่เบื้องหลังก็ตาม
ขยายเป็น
--expunge
--async
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้น
--[no]remove_all_convenience_symlinks
: "เท็จ" -
หากจริง ระบบจะลบลิงก์สัญลักษณ์ทั้งหมดในพื้นที่ทำงานที่มีคำนำหน้า 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 หรือ API บิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
ไม่มีการดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันโมดูลในรูปแบบ "<module1>@<version1>,<module2>@<version2>" ซึ่งจะได้รับอนุญาตในกราฟทรัพยากร Dependency ที่ได้รับการแก้ไขแล้ว แม้ว่าจะมีการประกาศเวอร์ชันในรีจิสทรีในที่มาของเวอร์ชัน (หากไม่ได้มาจาก NonRegistryOverride) มิเช่นนั้น เวอร์ชันที่แยกออกมาจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันแยกที่อนุญาตด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" ได้ด้วย คุณสามารถปิดการตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้กับเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" ที่ส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" ให้พิมพ์คำเตือนเมื่อตรวจพบข้อมูลที่ไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟทรัพยากร Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" ให้พิมพ์คำเตือนเมื่อตรวจพบข้อมูลไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อยกระดับการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะไม่สนใจทรัพยากร Dependency สำหรับนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูทไม่ว่าค่าของแฟล็กนี้จะเป็นอะไร
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--lockfile_mode=<off, update or error>
: "อัปเดต" -
ระบุวิธีและวิธีใช้ล็อกไฟล์ ค่าที่ถูกต้องคือ "อัปเดต" เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง "ข้อผิดพลาด" ในการใช้ไฟล์ล็อกแต่เกิดข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" ไม่อ่านหรือเขียนไปยังไฟล์ล็อก
แท็ก:loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--override_module=<an equals-separated mapping of module name to path>
รายการ - ลบล้างโมดูลด้วยเส้นทางภายในในรูปแบบ <module name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์ ระบบจะใช้เส้นทางตามที่เป็น ถ้าเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพัทธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางดังกล่าวจะสัมพัทธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--registry=<a string>
รายการ -
ระบุรีจิสทรีที่จะใช้ในการค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับเป็นสิ่งสำคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีในภายหลังเมื่อไม่มีรีจิสทรีที่ขาดหายไป
แท็ก:changes_inputs
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
- ค่าเริ่มต้น
--[no]experimental_record_metrics_for_all_mnemonics
: "เท็จ" - โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจำกัดอยู่ที่ 20 รายการที่มีการกระทำมากที่สุด การตั้งค่าตัวเลือกนี้จะเป็นการเขียนสถิติสำหรับการช่วยจำทั้งหมด
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ค่าเริ่มต้นของ
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
หากไม่ว่างเปล่า ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
- ค่าเริ่มต้น
--experimental_downloader_config=<a string>
: ดูคำอธิบาย - ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด แต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือสองรูปแบบ รูปแบบหนึ่งจะจับคู่กัน และอีกรูปแบบหนึ่งใช้เป็น URL ทดแทน โดยมีการอ้างอิงกลับเริ่มตั้งแต่ "$1" เป็นไปได้ที่จะมีการใช้คำสั่ง "rewrite" หลายคำสั่งสำหรับ URL เดียวกัน และในกรณีนี้ระบบจะส่งคืน URL หลายรายการ
- ตัวเลือกเบ็ดเตล็ด ที่ยังไม่ได้รับการแยกประเภท:
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์ ระบบจะใช้เส้นทางตามที่เป็น ถ้าเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพัทธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางดังกล่าวจะสัมพัทธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel"
ตัวเลือกการกำหนดค่า
ตัวเลือกความคุ้มครอง
รับค่าตัวเลือกทั้งหมดจาก test
- ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชของที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่เกิดแคชแทนที่จะคัดลอก ซึ่งช่วยประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่ได้จาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุไว้ ซึ่งจะทำให้การเปลี่ยนแปลง URL ส่งผลให้มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม สามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ทำให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--[no]experimental_repository_disable_download
: "เท็จ" -
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก: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 หรือ API บิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
ไม่มีการดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันโมดูลในรูปแบบ "<module1>@<version1>,<module2>@<version2>" ซึ่งจะได้รับอนุญาตในกราฟทรัพยากร Dependency ที่ได้รับการแก้ไขแล้ว แม้ว่าจะมีการประกาศเวอร์ชันในรีจิสทรีในที่มาของเวอร์ชัน (หากไม่ได้มาจาก NonRegistryOverride) มิเช่นนั้น เวอร์ชันที่แยกออกมาจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันแยกที่อนุญาตด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" ได้ด้วย คุณสามารถปิดการตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้กับเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" ที่ส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" ให้พิมพ์คำเตือนเมื่อตรวจพบข้อมูลที่ไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" - ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟทรัพยากร Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" ให้พิมพ์คำเตือนเมื่อตรวจพบข้อมูลไม่ตรงกัน หร