bazel [<startup options>] <command> [<args>]หรือ วันที่
bazel [<startup options>] <command> [<args>] -- [<target patterns>]โปรดดูคู่มือผู้ใช้สำหรับ รูปแบบเป้าหมาย
ไวยากรณ์ตัวเลือก
ส่งผ่านตัวเลือกไปยัง Bazel ได้หลายวิธี ตัวเลือกที่ต้องมีค่า อาจส่งด้วยเครื่องหมายเท่ากับหรือเว้นวรรคก็ได้ ดังนี้
--<option>=<value> --<option> <value>ตัวเลือกบางรายการจะมีรูปแบบสั้นๆ แบบอักขระเดียว ในกรณีนี้ รูปแบบสั้นๆ จะต้องใส่ขีดกลางเพียงครั้งเดียวและเว้นวรรค
-<short_form> <value>
ตัวเลือกบูลีนสามารถเปิดใช้ได้ดังนี้
--<option> --<option>=[true|yes|1]และปิดใช้ ดังนี้ วันที่
--no<option> --<option>=[false|no|0]
โดยปกติตัวเลือก Tristate จะตั้งไว้เป็นแบบอัตโนมัติโดยค่าเริ่มต้น และสามารถ ดังนี้
--<option>=[true|yes|1]หรือถูกบังคับให้ปิดใช้ วันที่
--no<option> --<option>=[false|no|0]
คำสั่ง
analyze-profile |
วิเคราะห์ข้อมูลโปรไฟล์ของบิลด์ |
aquery |
วิเคราะห์เป้าหมายที่ระบุและค้นหากราฟการกระทำ |
build |
สร้างเป้าหมายที่ระบุ |
canonicalize-flags |
การกำหนดรายการตัวเลือก Canonical เป็น Canonical |
clean |
นำไฟล์เอาต์พุตออกและเลือกหยุดเซิร์ฟเวอร์หรือไม่ก็ได้ |
coverage |
สร้างรายงานการครอบคลุมของโค้ดสำหรับเป้าหมายทดสอบที่ระบุ |
cquery |
โหลด วิเคราะห์ และค้นหาเป้าหมายที่ระบุพร้อมการกำหนดค่า |
dump |
ดัมพ์สถานะภายในของกระบวนการของเซิร์ฟเวอร์ bazel |
fetch |
ดึงข้อมูลที่เก็บภายนอกที่จำเป็นเบื้องต้นไปยังเป้าหมาย |
help |
ความช่วยเหลือเกี่ยวกับการพิมพ์สำหรับคำสั่งหรือดัชนี |
info |
แสดงข้อมูลรันไทม์เกี่ยวกับเซิร์ฟเวอร์ bazel |
license |
พิมพ์ใบอนุญาตของซอฟต์แวร์นี้ |
mobile-install |
เป้าหมายการติดตั้งไปยังอุปกรณ์เคลื่อนที่ |
mod |
ค้นหากราฟทรัพยากร Dependency ภายนอกของ Bzlmod |
print_action |
พิมพ์อาร์กิวเมนต์บรรทัดคำสั่งเพื่อคอมไพล์ไฟล์ |
query |
ดำเนินการค้นหากราฟทรัพยากร Dependency |
run |
เรียกใช้เป้าหมายที่ระบุ |
shutdown |
หยุดเซิร์ฟเวอร์ bazel |
sync |
ซิงค์ที่เก็บทั้งหมดที่ระบุไว้ในไฟล์พื้นที่ทำงาน |
test |
สร้างและเรียกใช้เป้าหมายทดสอบที่ระบุ |
vendor |
ดึงข้อมูลที่เก็บภายนอกลงในโฟลเดอร์ที่ระบุโดยแฟล็ก --vendor_dir |
version |
พิมพ์ข้อมูลเวอร์ชันสำหรับ Bazel |
ตัวเลือกการเริ่มทำงาน
- ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
- ค่าเริ่มต้น
--[no]autodetect_server_javabase
: "true" -
เมื่อมีการส่ง --noautodetect_server_javabase แล้ว Bazel จะไม่ถอยกลับไปยัง JDK ในเครื่องเพื่อเรียกใช้เซิร์ฟเวอร์ bazel และออกแทน
แท็ก:affects_outputs
loses_incremental_state
- ค่าเริ่มต้น
--[no]batch
: "เท็จ" -
หากตั้งค่าไว้ Bazel จะทำงานเป็นกระบวนการของไคลเอ็นต์โดยไม่มีเซิร์ฟเวอร์ แทนที่จะเป็นโหมดไคลเอ็นต์/เซิร์ฟเวอร์มาตรฐาน คำสั่งนี้เลิกใช้งานแล้วและจะถูกนำออก โปรดปิดเซิร์ฟเวอร์อย่างชัดเจนหากต้องการหลีกเลี่ยงไม่ให้เซิร์ฟเวอร์ค้าง
แท็ก:loses_incremental_state
,bazel_internal_configuration
,deprecated
- ค่าเริ่มต้น
--[no]batch_cpu_scheduling
: "เท็จ" -
เฉพาะใน Linux ใช้ "กลุ่ม" การตั้งเวลา CPU สำหรับ Blaze นโยบายนี้มีประโยชน์สำหรับภาระงานที่ไม่ใช่แบบอินเทอร์แอกทีฟ แต่ไม่ต้องการลดคุณค่าที่แท้จริง ดู "man 2 sched_setscheduler" หากเป็น "เท็จ" Bazel จะไม่เรียกใช้ระบบ
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้น
--bazelrc=<path>
: ดูคำอธิบาย -
ตำแหน่งของไฟล์ .bazelrc ของผู้ใช้ที่มีค่าเริ่มต้นของตัวเลือก Bazel /dev/null ระบุว่าระบบจะไม่สนใจ "--bazelrc" ทั้งหมดหลังจากนั้น ซึ่งมีประโยชน์ในการปิดใช้การค้นหาไฟล์ rc ของผู้ใช้ เช่น ในบิลด์ที่เผยแพร่
ตัวเลือกนี้สามารถระบุได้หลายครั้ง
เช่น โดย `--bazelrc=x.rc --bazelrc=y.rc --bazelrc=/dev/null --bazelrc=z.rc`,
1) อ่าน x.rc และ y.rc
2) ระบบไม่พิจารณา z.rc เนื่องจาก /dev/null ก่อนหน้านี้
หากไม่ระบุ Bazel จะใช้ไฟล์ .bazelrc ไฟล์แรกที่พบใน 2 ตำแหน่งต่อไปนี้ ได้แก่ ไดเรกทอรีพื้นที่ทำงาน และไดเรกทอรีหลักของผู้ใช้
หมายเหตุ: ตัวเลือกบรรทัดคำสั่งจะมีผลแทนตัวเลือกใดๆ ใน bazelrc เสมอ
แท็ก:changes_inputs
- ค่าเริ่มต้น
--[no]block_for_lock
: "true" -
เมื่อ --noblock_for_lock ผ่านแล้ว Bazel จะไม่รอให้คำสั่งที่ทำงานอยู่เสร็จสมบูรณ์ แต่จะออกในทันทีแทน
แท็ก:eagerness_to_exit
- ค่าเริ่มต้น
--[no]client_debug
: "เท็จ" -
หากเป็นจริง ให้บันทึกข้อมูลการแก้ไขข้อบกพร่องจากไคลเอ็นต์ไปยัง stderr การเปลี่ยนตัวเลือกนี้จะไม่ทำให้เซิร์ฟเวอร์ต้องรีสตาร์ท
แท็ก:affects_outputs
bazel_monitoring
- ค่าเริ่มต้น
--connect_timeout_secs=<an integer>
: "30" -
ระยะเวลาที่ไคลเอ็นต์รอการเชื่อมต่อเซิร์ฟเวอร์ในแต่ละครั้ง
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--digest_function=<hash function>
: ดูคำอธิบาย -
ฟังก์ชันแฮชที่จะใช้เมื่อคำนวณไดเจสต์ไฟล์
แท็ก:loses_incremental_state
bazel_internal_configuration
- ค่าเริ่มต้น
--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
- ค่าเริ่มต้นของ
--server_javabase=<jvm path>
: "" - เส้นทางไปยัง JVM ที่ใช้เพื่อดำเนินการ Bazel เอง
ตัวเลือกเหมือนกับคำสั่งทั้งหมด
- ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชของที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่เกิดแคชแทนที่จะคัดลอก ซึ่งช่วยประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--experimental_repository_downloader_retries=<an integer>
: "5" -
จำนวนครั้งสูงสุดในการลองดาวน์โหลดข้อผิดพลาดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก:experimental
- ค่าเริ่มต้น
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ด้วยปัจจัยนี้ ด้วยวิธีนี้ ที่เก็บภายนอกจะทำให้ทำงานกับเครื่องที่ทำงานช้ากว่าที่ผู้สร้างกฎคาดไว้ โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
experimental
- ค่าเริ่มต้น
--http_connector_attempts=<an integer>
: "8" -
จำนวนครั้งสูงสุดในการดาวน์โหลด HTTP
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--http_connector_retry_max_timeout=<An immutable length of time.>
: "0s" -
การหมดเวลาสูงสุดสำหรับการลองดาวน์โหลด HTTP ซ้ำ เมื่อใช้ค่า 0 จะไม่มีการกำหนดระยะหมดเวลาสูงสุด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--http_max_parallel_downloads=<an integer>
: "8" -
จำนวนสูงสุดที่ดาวน์โหลด HTTP พร้อมกัน
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--http_timeout_scaling=<a double>
: "1.0" -
ปรับขนาดการหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลด HTTP ด้วยตัวประกอบที่ระบุ
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]incompatible_disable_native_repo_rules
: "เท็จ" -
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บในระบบได้ใน WORKSPACE ไม่เช่นนั้นคุณต้องใช้กฎที่เก็บของ Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform และ android_sdk_repository
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูคำอธิบาย -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการเรียกข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช มิเช่นนั้น จะใช้ค่าเริ่มต้นเป็น "<output_user_root>/cache/repos/v1" ถูกใช้แล้ว
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]repository_disable_download
: "เท็จ" -
หากตั้งค่าไว้ ไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลที่เก็บ โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้อย่างสมบูรณ์ ctx.execute ยังคงสามารถรันไฟล์ปฏิบัติการที่กำหนดเองได้ในการเข้าถึงอินเทอร์เน็ต
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์:
- ค่าเริ่มต้นของ
--experimental_ui_max_stdouterr_bytes=<an integer in (-1)-1073741819 range>
: "1048576" -
ขนาดสูงสุดของไฟล์ stdout / stderr ที่จะพิมพ์ลงในคอนโซล -1 หมายถึงไม่จำกัด
แท็ก:execution
- ค่าเริ่มต้น
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
เปอร์เซ็นต์ของพื้นที่เก็บข้อมูลเต็ม (0-100) ซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์แรงดันหน่วยความจำเทียบกับขีดจำกัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้น
--[no]incompatible_remote_dangling_symlinks
: "true" -
หากตั้งค่าเป็น "จริง" ลิงก์สัญลักษณ์ที่อัปโหลดไปยังแคชระยะไกลหรือดิสก์แคชจะได้รับอนุญาตให้ห้อยคอได้
แท็ก:execution
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_remote_symlinks
: "true" -
หากตั้งค่าเป็น "จริง" Bazel จะอัปโหลดลิงก์สัญลักษณ์ไปยังรีโมตหรือดิสก์แคชเสมอ มิฉะนั้นระบบจะอัปโหลดลิงก์สัญลักษณ์ที่เกี่ยวข้องที่ไม่ก่อให้เกิดอันตรายเป็นไฟล์หรือไดเรกทอรีที่ลิงก์ไป
แท็ก:execution
incompatible_change
- ที่ใช้สำหรับการดำเนินการมีดังนี้
- ค่าเริ่มต้น
--[no]incompatible_enable_proto_toolchain_resolution
: "เท็จ" -
หากเป็น "จริง" กฎ Pro lang จะกำหนด Toolchain จากที่เก็บ rules_protocol, rules_java, rules_cc
แท็ก:loading_and_analysis
incompatible_change
- เอาต์พุตที่ต้องการ ซึ่งส่งผลต่อค่าของผลลัพธ์ ไม่ใช่ค่าที่มีอยู่
- ค่าเริ่มต้น
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
จำนวนไฟล์เปิดสูงสุดที่อนุญาตระหว่างการอัปโหลดอาร์ติแฟกต์ BEP
แท็ก:affects_outputs
--remote_download_all
-
ดาวน์โหลดเอาต์พุตระยะไกลทั้งหมดไปยังเครื่องภายใน แฟล็กนี้เป็นชื่อแทนของ --remote_download_outputs=all
ขยายเป็น
--remote_download_outputs=all
แท็ก:affects_outputs
--remote_download_minimal
-
ไม่ดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลไปยังเครื่องภายใน แฟล็กนี้เป็นชื่อแทนของ --remote_download_outputs=minimal
ขยายเป็น
--remote_download_outputs=minimal
แท็ก:affects_outputs
- ค่าเริ่มต้น
--remote_download_outputs=<all, minimal or toplevel>
: "ระดับบนสุด" -
หากตั้งค่าเป็น "ขั้นต่ำ" จะไม่ดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลไปยังเครื่องภายใน ยกเว้นเอาต์พุตที่การดำเนินการในเครื่องจำเป็นต้องใช้ หากตั้งค่าเป็น "ระดับบนสุด" แสดงตัวเหมือน "น้อยมาก" เว้นแต่ว่าจะดาวน์โหลดเอาต์พุตของเป้าหมายระดับบนสุดไปยังเครื่องภายในด้วย ตัวเลือกทั้ง 2 รายการจะช่วยลดเวลาบิลด์ได้อย่างมากหากแบนด์วิดท์ของเครือข่ายเป็นจุดคอขวด
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--remote_download_symlink_template=<a string>
: "" -
สร้างลิงก์สัญลักษณ์แทนการดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลไปยังเครื่องภายใน ระบุเป้าหมายของลิงก์สัญลักษณ์ในรูปแบบสตริงเทมเพลตได้ สตริงเทมเพลตนี้อาจมี {hash} และ {size_bytes} ที่ขยายเป็นแฮชของออบเจ็กต์และขนาดเป็นไบต์ตามลำดับ เช่น ลิงก์สัญลักษณ์เหล่านี้อาจชี้ไปยังระบบไฟล์ FUSE ที่โหลดออบเจ็กต์จาก CAS ตามคำขอ
แท็ก:affects_outputs
--remote_download_toplevel
-
ดาวน์โหลดเฉพาะเอาต์พุตระยะไกลของเป้าหมายระดับบนสุดไปยังเครื่องภายในเท่านั้น แฟล็กนี้เป็นชื่อแทนของ --remote_download_outputs=toplevel
ขยายเป็น
--remote_download_outputs=toplevel
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--repo_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุตัวแปรสภาพแวดล้อมเพิ่มเติมเพื่อให้ใช้ได้กับกฎที่เก็บเท่านั้น โปรดทราบว่ากฎที่เก็บจะดูสภาพแวดล้อมแบบเต็มได้ แต่ด้วยวิธีนี้ระบบจะส่งข้อมูลการกำหนดค่าไปยังที่เก็บผ่านตัวเลือกต่างๆ ได้โดยที่กราฟการดำเนินการจะไม่ถูกต้อง
แท็ก:action_command_lines
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตบิลด์ที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมธง ฯลฯ)
- ค่าเริ่มต้น
--[no]check_bzl_visibility
: "true" -
หากปิดใช้ ระบบจะลดระดับข้อผิดพลาดในการแสดงการโหลด .bzl ให้มีคำเตือน
แท็ก:build_file_semantics
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]enable_bzlmod
: "true" -
หากเป็น "จริง" จะเปิดใช้ระบบการจัดการทรัพยากร Dependency ของ Bzlmod โดยมีผลเหนือกว่า WORKSPACE ดูข้อมูลเพิ่มเติมได้ที่ https://bazel.build/docs/bzlmod
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]enable_workspace
: "true" -
หากเป็น "จริง" จะเปิดใช้ระบบ WORKSPACE เดิมสำหรับทรัพยากร Dependency ภายนอก ดูข้อมูลเพิ่มเติมได้ที่ https://bazel.build/external/overview
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_action_resource_set
: "true" -
หากตั้งค่าเป็น "จริง" ctx.actions.run() และ ctx.actions.run_shell() จะยอมรับพารามิเตอร์ resource_set สำหรับการดำเนินการในเครื่อง มิเช่นนั้น หน่วยความจำจะเริ่มต้นที่ 250 MB สำหรับหน่วยความจำและ 1 CPU
แท็ก:execution
,build_file_semantics
,experimental
- ค่าเริ่มต้น
--[no]experimental_bzl_visibility
: "true" -
หากเปิดใช้ ให้เพิ่มฟังก์ชัน "visibility()" ที่ไฟล์ .bzl อาจเรียกใช้ในระหว่างการประเมินระดับบนสุดเพื่อตั้งค่าการแสดงผลไว้ตามวัตถุประสงค์ของคำสั่ง remove()
แท็ก:loading_and_analysis
experimental
-
หากตั้งค่าเป็น "จริง" แอตทริบิวต์กฎและเมธอด Starlark API ที่จำเป็นสำหรับกฎ cc_shared_library จะพร้อมใช้งาน
แท็ก:build_file_semantics
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_cc_static_library
: "เท็จ" -
หากตั้งค่าเป็น "จริง" แอตทริบิวต์กฎและเมธอด Starlark API ที่จำเป็นสำหรับกฎ cc_static_library จะพร้อมใช้งาน
แท็ก:build_file_semantics
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_disable_external_package
: "เท็จ" -
หากตั้งค่าเป็น "จริง" แพ็กเกจ //ภายนอกที่สร้างขึ้นโดยอัตโนมัติจะใช้งานไม่ได้อีกต่อไป Bazel จะยังคงแยกวิเคราะห์ไฟล์ "external/BUILD" ไม่ได้ แต่ globs ที่เข้าถึงภายนอก/ จากแพ็กเกจที่ไม่มีชื่อจะใช้งานได้
แท็ก:loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]experimental_enable_android_migration_apis
: "เท็จ" -
หากตั้งค่าเป็น "จริง" จะเปิดใช้ API ที่ต้องใช้เพื่อรองรับการย้ายข้อมูลของ Android Starlark
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]experimental_enable_first_class_macros
: "เท็จ" -
หากตั้งค่าเป็น "จริง" จะเปิดใช้การสร้าง "macro()" สำหรับกำหนดมาโครคลาสเฟิร์สคลาส
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]experimental_enable_scl_dialect
: "เท็จ" -
หากตั้งค่าเป็น "จริง" อาจใช้ไฟล์ .scl ในคำสั่ง request() ได้
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]experimental_google_legacy_api
: "เท็จ" -
หากตั้งค่าเป็น "จริง" จะแสดงส่วนทดลองของ Starlark Build API ที่เกี่ยวข้องกับโค้ดเดิมของ Google
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--[no]experimental_isolated_extension_usages
: "เท็จ" -
หากเป็นจริง จะเปิดใช้ <code>ISOlate</code> ใน <a href="https://bazel.build/rules/lib/globals/module#use_extension"><code>use_extension</code></a>
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_java_library_export
: "เท็จ" -
หากเปิดใช้ โมดูล Experiment_java_library_export_do_not_use จะพร้อมใช้งาน
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]experimental_platforms_api
: "เท็จ" -
หากตั้งค่าเป็น "จริง" จะเปิดใช้ Starlark API ที่เกี่ยวข้องกับแพลตฟอร์มจำนวนหนึ่งซึ่งมีประโยชน์สำหรับการแก้ไขข้อบกพร่อง
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--[no]experimental_repo_remote_exec
: "เท็จ" -
หากตั้งค่าเป็น "จริง" Reposit_rule จะมีความสามารถในการดำเนินการระยะไกลบางรายการ
แท็ก:build_file_semantics
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_sibling_repository_layout
: "เท็จ" -
หากตั้งค่าเป็น "จริง" ระบบจะสร้างที่เก็บที่ไม่ใช่หลักเป็นลิงก์สัญลักษณ์ไปยังที่เก็บหลักในรูทการดำเนินการ กล่าวคือ ที่เก็บทั้งหมดจะเป็นรายการย่อยโดยตรงของไดเรกทอรี $output_base/execution_root การดำเนินการนี้มีผลข้างเคียงจากการเพิ่มพื้นที่ว่าง $output_base/execution_root/__main__/external สำหรับ "ภายนอก" ระดับบนสุดจริง ไดเรกทอรี
แท็ก:action_command_lines
,bazel_internal_configuration
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]experimental_single_package_toolchain_binding
: "เท็จ" -
หากเปิดใช้ ฟังก์ชันregister_toolchain อาจไม่มีรูปแบบเป้าหมายซึ่งอาจหมายถึงแพ็กเกจมากกว่า 1 รายการ
แท็ก:loading_and_analysis
incompatible_change
-
หากตั้งค่าเป็น "จริง" แท็กจะส่งผ่านจากเป้าหมายไปยังการดำเนินการ ข้อกำหนดในการดำเนินการ มิฉะนั้นแท็กจะไม่ถูกเผยแพร่ ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/8830
แท็ก:build_file_semantics
experimental
- ค่าเริ่มต้น
--[no]incompatible_always_check_depset_elements
: "true" -
ตรวจสอบความถูกต้องขององค์ประกอบที่เพิ่มลงในชุดย่อยในตัวสร้างทั้งหมด องค์ประกอบต้องเปลี่ยนแปลงไม่ได้ แต่ที่ผ่านมาเครื่องมือสร้าง depset(direct=...) ลืมตรวจสอบ ใช้ Tuples แทนรายการในองค์ประกอบ Depset ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/10313
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_depset_for_libraries_to_link_getter
: "true" -
เมื่อเป็น "จริง" Bazel จะไม่แสดงรายการจาก linked_context.libraries_to_link อีกต่อไป แต่จะแสดงผลการตั้งค่าแทน
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disable_objc_library_transition
: "true" -
ปิดใช้การเปลี่ยนที่กำหนดเองของ objc_library และรับค่าจากเป้าหมายระดับบนสุดแทน (No-op ใน Bazel)
แท็ก:build_file_semantics
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disable_starlark_host_transitions
: "เท็จ" -
หากตั้งค่าเป็น "จริง" แอตทริบิวต์กฎจะตั้งค่า 'cfg = "host"' ไม่ได้ กฎควรตั้งค่า 'cfg = "exec"' แทน
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disable_target_default_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_disable_target_provider_fields
: "เท็จ" -
หากตั้งค่าเป็น "จริง" ให้ปิดความสามารถในการใช้ผู้ให้บริการเริ่มต้นผ่านไวยากรณ์ในช่อง ใช้ไวยากรณ์คีย์ผู้ให้บริการแทน ตัวอย่างเช่น แทนที่จะใช้ "ctx.attr.dep.files" เพื่อเข้าถึง "files" ให้ใช้ "ctx.attr.dep[DefaultInfo].files" ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/9014
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disallow_ctx_resolve_tools
: "เท็จ" -
หากตั้งค่าเป็น "จริง" การเรียกใช้ ctx.resolve_tools API ที่เลิกใช้งานแล้วจะล้มเหลวเสมอ การใช้ API นี้ควรแทนที่ด้วยอาร์กิวเมนต์ที่ดำเนินการได้หรืออาร์กิวเมนต์เครื่องมือเพื่อ ctx.actions.run หรือ ctx.actions.run_shell
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disallow_empty_glob
: "เท็จ" -
หากตั้งค่าเป็น "จริง" ค่าเริ่มต้นของอาร์กิวเมนต์ `allow_empty` ของ glob() จะเป็น False
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disallow_struct_provider_syntax
: "เท็จ" -
หากตั้งค่าเป็น "จริง" ฟังก์ชันการใช้งานกฎอาจไม่แสดงโครงสร้าง โดยจะต้องแสดงผลรายการอินสแตนซ์ของผู้ให้บริการแทน
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_enable_deprecated_label_apis
: "true" -
หากเปิดใช้ คุณจะสามารถใช้ API ที่เลิกใช้งานแล้วบางรายการ (native.repository_name, Label.workspace_name, Label.relative)
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]incompatible_fail_on_unknown_attributes
: "true" -
หากเปิดใช้ เป้าหมายที่มีแอตทริบิวต์ที่ไม่รู้จักซึ่งตั้งค่าเป็น "ไม่มี" จะล้มเหลว
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_fix_package_group_reporoot_syntax
: "true" -
ในแอตทริบิวต์ "packages" ของPackage_group ให้เปลี่ยนความหมายของค่า "//..." เพื่ออ้างถึงแพ็กเกจทั้งหมดในที่เก็บปัจจุบัน แทนที่จะเป็นแพ็กเกจทั้งหมดในที่เก็บใดๆ คุณสามารถใช้ค่าพิเศษ "สาธารณะ" แทน "//..." เพื่อรับลักษณะการทำงานเดิม ธงนี้กำหนดให้ต้องเปิดใช้งาน --incompatible_package_group_has_public_syntax ด้วย
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_java_common_parameters
: "true" -
หากตั้งค่าเป็น "จริง" พารามิเตอร์เอาต์พุต_jar และ host_javabase ใน pack_sources และ host_javabase ในคอมไพล์จะถูกนำออกทั้งหมด
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_merge_fixed_and_default_shell_env
: "true" -
หากเปิดใช้ การดำเนินการที่ลงทะเบียนด้วย ctx.actions.run และ ctx.actions.run_shell ด้วย 'env' เอาไว้ และ 'use_default_shell_env = จริง' ที่ระบุจะใช้สภาพแวดล้อมที่ได้รับจากสภาพแวดล้อมของ Shell เริ่มต้นโดยการลบล้างค่าที่ส่งไปยัง "env" หากปิดใช้ ค่าของ "env" จะไม่มีผลใดๆ ในกรณีนี้
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_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_build_file_path
: "เท็จ" -
หากตั้งค่าเป็น "จริง" คุณจะใช้ ctx.build_file_path ที่เลิกใช้งานแล้วไม่ได้ ctx.label.package + '/BUILD'
สามารถใช้แทน
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_stop_exporting_language_modules
: "เท็จ" -
หากเปิดใช้ โมดูลเฉพาะภาษาบางโมดูล (เช่น "cc_common") จะไม่พร้อมใช้งานในไฟล์ .bzl ของผู้ใช้ และอาจเรียกใช้จากที่เก็บกฎที่เกี่ยวข้องเท่านั้น
แท็ก:loading_and_analysis
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
- ค่าเริ่มต้น
--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
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันโมดูลในรูปแบบ "<module1>@<version1>,<module2>@<version2>" ซึ่งจะได้รับอนุญาตในกราฟทรัพยากร Dependency ที่ได้รับการแก้ไขแล้ว แม้ว่าจะมีการประกาศเวอร์ชันในรีจิสทรีในที่มาของเวอร์ชัน (หากไม่ได้มาจาก NonRegistryOverride) มิเช่นนั้น เวอร์ชันที่แยกออกมาจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันแยกที่อนุญาตด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" ได้ด้วย คุณสามารถปิดการตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้กับเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" ที่ส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" ให้พิมพ์คำเตือนเมื่อตรวจพบข้อมูลที่ไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟทรัพยากร Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" ให้พิมพ์คำเตือนเมื่อตรวจพบข้อมูลไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อยกระดับการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะไม่สนใจทรัพยากร Dependency สำหรับนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูทไม่ว่าค่าของแฟล็กนี้จะเป็นอะไร
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--lockfile_mode=<off, update, refresh or error>
: "อัปเดต" -
ระบุวิธีและวิธีใช้ล็อกไฟล์ ค่าที่ถูกต้องคือ "อัปเดต" เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง "รีเฟรช" เพื่อรีเฟรชข้อมูลที่เปลี่ยนแปลงได้เพิ่มเติม (เวอร์ชันที่แยกออกมาและโมดูลที่หายไปก่อนหน้านี้) จากรีจิสทรีระยะไกลเป็นครั้งคราว "ข้อผิดพลาด" ในการใช้ไฟล์ล็อกแต่เกิดข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่อไม่อ่านหรือเขียนไปยังไฟล์ล็อก
แท็ก:loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--override_module=<an equals-separated mapping of module name to path>
รายการ - ลบล้างโมดูลด้วยเส้นทางภายในในรูปแบบ <module name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์ ระบบจะใช้เส้นทางตามที่เป็น ถ้าเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพัทธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางดังกล่าวจะสัมพัทธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel" หากเส้นทางที่ระบุว่างเปล่า ให้นำการลบล้างก่อนหน้าออก
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--registry=<a string>
รายการ -
ระบุรีจิสทรีที่จะใช้ในการค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับเป็นสิ่งสำคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีในภายหลังเมื่อไม่มีรีจิสทรีที่ขาดหายไป
แท็ก:changes_inputs
- ค่าเริ่มต้น
--vendor_dir=<a path>
: ดูคำอธิบาย -
ระบุไดเรกทอรีที่ควรเก็บที่เก็บภายนอกในโหมดผู้ให้บริการ ไม่ว่าจะเพื่อวัตถุประสงค์ในการดึงข้อมูลลงในที่เก็บหรือใช้ขณะที่สร้าง คุณสามารถระบุเส้นทางเป็นเส้นทางสัมบูรณ์หรือเส้นทางที่สัมพันธ์กับไดเรกทอรีพื้นที่ทำงานก็ได้
แท็ก:loading_and_analysis
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพเวลาของบิลด์
- ค่าเริ่มต้น
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "1s:2,20s:3,1m:5" -
ถึงขีดจำกัดแล้ว (หากมี) จะทำให้ GcThrashingDetector ทำให้ Bazel ขัดข้องด้วย OOM ขีดจํากัดแต่ละรายการจะระบุเป็น <period>:<count> โดยที่ระยะเวลาคือระยะเวลาและจํานวนเป็นจำนวนเต็มบวก หากมีการใช้งานพื้นที่มากกว่า --gc_thrashing_threshold เปอร์เซ็นต์ของพื้นที่ว่าง (ฮีป Gen เก่า) หลัง <count> GC แบบเต็มติดต่อกันภายใน <period> จะมีการทริกเกอร์ OOM คุณระบุขีดจำกัดหลายรายการได้โดยคั่นด้วยเครื่องหมายจุลภาค
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้น
--[no]heuristically_drop_nodes
: "เท็จ" -
หากเป็น "จริง" Blaze จะนำโหนด FileState และ DirectoryListingState ออกหลังจากที่โหนด File และ DirectoryListing ที่เกี่ยวข้องเสร็จสิ้นเพื่อประหยัดหน่วยความจำ เราคาดว่าโอกาสที่จะต้องใช้โหนดเหล่านี้อีกน้อยลง หากเป็นเช่นนั้น โปรแกรมจะทำการประเมินอีกครั้ง
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--[no]incompatible_do_not_split_linking_cmdline
: "true" -
เมื่อเป็นจริง Bazel จะไม่แก้ไขแฟล็กบรรทัดคำสั่งที่ใช้ในการลิงก์อีกต่อไป และจะไม่เลือกว่าแฟล็กใดจะส่งไปยังไฟล์พารามิเตอร์และจะไม่ใช้ ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7670
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]keep_state_after_build
: "true" -
หากเป็น "เท็จ" Blaze จะทิ้งสถานะ Inmemory จากบิลด์นี้เมื่อบิลด์เสร็จสมบูรณ์ การสร้างครั้งต่อๆ ไปจะไม่มีส่วนเพิ่มที่เกี่ยวข้องกับเวอร์ชันนี้
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "10" -
ตั้งค่าสถานะสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้ฮีปที่เก็บรักษาไว้เกินเกณฑ์ที่ --skyframe_high_water_mark_threshold กำหนด เมื่อเกิดเหตุการณ์ GC เต็มรูปแบบเกิดขึ้น สถานะของ Skyframe ชั่วคราวจะถูกตัดทิ้งโดยไม่จำเป็นจนถึงจำนวนครั้งดังกล่าวต่อการเรียกใช้หลายครั้ง ค่าเริ่มต้นคือ 10 0 หมายความว่ากิจกรรม GC ทั้งหมดจะไม่ทริกเกอร์การลดลง หากถึงขีดจำกัด สถานะ Skyframe จะไม่ลดลงอีกต่อไปเมื่อเกิดเหตุการณ์ GC เต็มรูปแบบและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้น
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "10" -
ตั้งค่าสถานะสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้ฮีปที่เก็บรักษาไว้เกินเกณฑ์ที่ --skyframe_high_water_mark_threshold ตั้งค่าอยู่ เมื่อเกิดเหตุการณ์ GC ที่ไม่ร้ายแรง เหตุการณ์ GC ที่ไม่ร้ายแรงจะเกิดขึ้น ระบบจะหยุดสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นออกไปจนถึงหลายครั้งต่อการเรียกใช้ ค่าเริ่มต้นคือ 10 ศูนย์หมายความว่ากิจกรรม GC ที่ไม่สำคัญจะไม่ทริกเกอร์การลดลงเลย หากถึงขีดจำกัดแล้ว สถานะ Skyframe จะไม่ลดลงอีกต่อไปเมื่อเกิดเหตุการณ์ GC ที่ไม่ร้ายแรงและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
ตั้งค่าสถานะสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้ฮีปที่เก็บรักษาไว้ถึงเกณฑ์นี้เป็นอย่างน้อย ก็จะทิ้งสถานะ Skyframe ชั่วคราวโดยไม่จำเป็น การปรับแต่งนี้อาจช่วยลดผลกระทบจากเวลาจริงของการ Thrash
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้น
--[no]track_incremental_state
: "true" -
หากเป็น "เท็จ" Blaze จะไม่เก็บข้อมูลที่ทำให้ใช้งานไม่ได้และมีการประเมินซ้ำในบิลด์ที่เพิ่มขึ้นเพื่อประหยัดหน่วยความจำในบิลด์นี้ การสร้างครั้งต่อๆ ไปจะไม่มีส่วนเพิ่มที่เกี่ยวข้องกับเวอร์ชันนี้ โดยปกติแล้วคุณจะต้องระบุ --batch เมื่อตั้งค่าเป็น false
แท็ก:loses_incremental_state
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
- ค่าเริ่มต้น
--[no]announce_rc
: "เท็จ" -
เลือกว่าจะประกาศตัวเลือก rc หรือไม่
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]attempt_to_print_relative_paths
: "เท็จ" -
เมื่อพิมพ์ส่วนที่เป็นตำแหน่งของข้อความ ให้พยายามใช้เส้นทางที่สัมพันธ์กับไดเรกทอรีของพื้นที่ทำงานหรือหนึ่งในไดเรกทอรีที่ระบุโดย --package_path
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--bes_backend=<a string>
: "" -
ระบุปลายทางแบ็กเอนด์ของบริการบิลด์ (BES) ในรูปแบบ [SCHEME://]HOST[:PORT] ค่าเริ่มต้นคือปิดใช้งานการอัปโหลด BES รูปแบบที่รองรับคือ grpc และ grpcs (grpc ที่เปิดใช้ TLS) หากไม่ได้ระบุรูปแบบไว้ Bazel จะถือว่า grpcs
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]bes_check_preceding_lifecycle_events
: "เท็จ" -
ตั้งค่าช่อง check_preceding_lifecycle_events_present ใน PublishBuildToolEventStreamRequest ซึ่งจะบอกให้ BES ตรวจสอบว่าก่อนหน้านี้ได้รับเหตุการณ์ InvocationAttemptStarted และ BuildEnqueued ที่ตรงกับเหตุการณ์เครื่องมือปัจจุบันหรือไม่
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--bes_header=<a 'name=value' assignment>
รายการ -
ระบุส่วนหัวในแบบฟอร์ม NAME=VALUE ที่จะรวมอยู่ในคำขอ BES สามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
แท็ก:affects_outputs
- ค่าเริ่มต้น
--bes_instance_name=<a string>
: ดูคำอธิบาย -
ระบุชื่ออินสแตนซ์ที่ BES จะคง BEP ที่อัปโหลดไว้ ค่าเริ่มต้นคือ Null
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--bes_keywords=<comma-separated list of options>
รายการ -
ระบุรายการคีย์เวิร์ดสำหรับการแจ้งเตือนเพื่อเพิ่มชุดคีย์เวิร์ดเริ่มต้นที่เผยแพร่ใน BES ("command_name=<command_name> ", "protocol_name=BEP") ค่าเริ่มต้นคือไม่มี
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]bes_lifecycle_events
: "true" -
ระบุว่าจะเผยแพร่เหตุการณ์ในวงจรของ BES หรือไม่ (มีค่าเริ่มต้นเป็น "จริง")
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--bes_oom_finish_upload_timeout=<An immutable length of time.>
: "10m" -
ระบุระยะเวลาที่ควรรอให้การอัปโหลด BES/BEP เสร็จสมบูรณ์ขณะทำ OOMing แฟล็กนี้ทำให้แน่ใจได้ถึงการสิ้นสุดเมื่อ JVM เกิดการขว้าง GC อย่างรุนแรง และไม่สามารถดำเนินการต่างๆ ในเทรดผู้ใช้ใดๆ ได้
แท็ก:bazel_monitoring
- ค่าเริ่มต้นของ
--bes_outerr_buffer_size=<an integer>
: "10240" -
ระบุขนาดสูงสุดของ Stdout หรือ stderr ที่จะบัฟเฟอร์ใน BEP ก่อนที่จะรายงานเป็นเหตุการณ์ความคืบหน้า การเขียนแต่ละรายการจะยังคงได้รับการรายงานในเหตุการณ์เดียว แม้ว่าจะมากกว่าค่าที่ระบุสูงสุดถึง --bes_outerr_chunk_size ก็ตาม
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--bes_outerr_chunk_size=<an integer>
: "1048576" -
ระบุขนาดสูงสุดของ stdout หรือ stderr ที่จะส่งไปยัง BEP ในข้อความเดียว
แท็ก:affects_outputs
- ค่าเริ่มต้น
--bes_proxy=<a string>
: ดูคำอธิบาย - เชื่อมต่อบริการ Build Event ผ่านพร็อกซี ปัจจุบัน Flag นี้สามารถใช้เพื่อกำหนดค่า Socket ของโดเมน Unix (unix:/path/to/socket) เท่านั้น
- ค่าเริ่มต้นของ
--bes_results_url=<a string>
: "" -
ระบุ URL พื้นฐานที่ผู้ใช้สามารถดูข้อมูลที่สตรีมไปยังแบ็กเอนด์ BES Bazel จะแสดง URL ต่อท้ายด้วยรหัสการเรียกใช้ไปยังเทอร์มินัล
แท็ก:terminal_output
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--bes_system_keywords=<comma-separated list of options>
รายการ -
ระบุรายการคีย์เวิร์ดสำหรับการแจ้งเตือนที่จะรวมโดยตรง โดยไม่มี "user_keyword=" ใส่คำนำหน้าสำหรับคีย์เวิร์ดที่มาจาก --bes_keywords ใช้สำหรับโอเปอเรเตอร์บริการ Build ที่กำหนด --bes_lifecycle_events=false และรวมคีย์เวิร์ดเมื่อเรียกใช้ PublishLifecycleEvent สร้างโอเปอเรเตอร์บริการที่ใช้ Flag นี้ควรป้องกันไม่ให้ผู้ใช้ลบล้างค่าแฟล็ก
แท็ก:affects_outputs
- ค่าเริ่มต้น
--bes_timeout=<An immutable length of time.>
: "0s" -
ระบุระยะเวลาที่ควรรอให้การอัปโหลด BES/BEP เสร็จสมบูรณ์หลังจากการสร้างและการทดสอบเสร็จสิ้น ระยะหมดเวลาที่ถูกต้องคือจำนวนปกติที่ตามด้วยหน่วย: วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) ค่าเริ่มต้นคือ "0" หมายความว่าไม่มีระยะหมดเวลา
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--bes_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
: "wait_for_upload_complete" -
ระบุว่าการอัปโหลดบริการ Build Event ควรบล็อกการดำเนินการบิลด์เสร็จสมบูรณ์ หรือควรสิ้นสุดการเรียกใช้ทันทีและอัปโหลดอยู่เบื้องหลังให้เสร็จสิ้น หรือ "wait_for_upload_complete" (ค่าเริ่มต้น), "nowait_for_upload_complete" หรือ "Fully_async"
แท็ก:eagerness_to_exit
- ค่าเริ่มต้นของ
--build_event_binary_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้เขียนการนำเสนอโปรโตคอลเหตุการณ์บิลด์ที่คั่นด้วย varint ไปยังไฟล์นั้น ตัวเลือกนี้หมายถึง --bes_upload_mode=wait_for_upload_complete
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]build_event_binary_file_path_conversion
: "true" -
แปลงเส้นทางในการนำเสนอไฟล์ไบนารีของโปรโตคอลกิจกรรมบิลด์เป็น URI ที่ใช้ได้ทั่วโลกมากขึ้นเมื่อเป็นไปได้ หากปิดใช้ ระบบจะใช้รูปแบบ file:// uri เสมอ
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--build_event_binary_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
: "wait_for_upload_complete" -
ระบุว่าการอัปโหลดบริการเหตุการณ์ของบิลด์สำหรับ --build_event_binary_file ควรบล็อกการสร้างเสร็จสมบูรณ์หรือควรสิ้นสุดการเรียกใช้ทันที แล้วอัปโหลดในเบื้องหลังให้เสร็จสิ้น หรือ "wait_for_upload_complete" (ค่าเริ่มต้น), "nowait_for_upload_complete" หรือ "Fully_async"
แท็ก:eagerness_to_exit
- ค่าเริ่มต้นของ
--build_event_json_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้เขียนการเรียงลำดับ JSON ของโปรโตคอลเหตุการณ์บิลด์ไปยังไฟล์นั้น ตัวเลือกนี้หมายถึง --bes_upload_mode=wait_for_upload_complete
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]build_event_json_file_path_conversion
: "true" -
แปลงเส้นทางในไฟล์ JSON ของโปรโตคอลเหตุการณ์บิลด์ให้เป็น URI ที่ถูกต้องทั่วโลกมากขึ้นเมื่อเป็นไปได้ หากปิดใช้ ระบบจะใช้รูปแบบ file:// uri เสมอ
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--build_event_json_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
: "wait_for_upload_complete" -
ระบุว่าการอัปโหลดบริการ Build Event สำหรับ --build_event_json_file ควรบล็อกการสร้างเสร็จสมบูรณ์หรือควรสิ้นสุดการเรียกใช้ทันที และอัปโหลดในเบื้องหลังให้เสร็จสิ้น หรือ "wait_for_upload_complete" (ค่าเริ่มต้น), "nowait_for_upload_complete" หรือ "Fully_async"
แท็ก:eagerness_to_exit
- ค่าเริ่มต้น
--build_event_max_named_set_of_file_entries=<an integer>
: "5000" -
จํานวนรายการสูงสุดสําหรับเหตุการณ์เดียวที่ชื่อ_set_of_files ระบบจะไม่สนใจค่าที่น้อยกว่า 2 และไม่มีการแยกเหตุการณ์ ตัวเลือกนี้มีไว้เพื่อจำกัดขนาดเหตุการณ์สูงสุดในโปรโตคอลเหตุการณ์บิลด์ แม้ว่าจะไม่ได้ควบคุมขนาดของเหตุการณ์โดยตรง ขนาดกิจกรรมรวมเป็นฟังก์ชันของโครงสร้างของชุด ตลอดจนความยาวของไฟล์และ URI ซึ่งอาจขึ้นอยู่กับฟังก์ชันแฮช
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]build_event_publish_all_actions
: "เท็จ" -
ควรเผยแพร่การดำเนินการทั้งหมดไหม
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--build_event_text_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้เขียนการนำเสนอโปรโตคอลเหตุการณ์บิลด์ไปยังไฟล์นั้น
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]build_event_text_file_path_conversion
: "true" -
แปลงเส้นทางในไฟล์ข้อความของโปรโตคอลเหตุการณ์บิลด์เป็น URI ที่ใช้ได้ทั่วโลกมากขึ้นเมื่อเป็นไปได้ หากปิดใช้ ระบบจะใช้รูปแบบ file:// uri เสมอ
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--build_event_text_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
: "wait_for_upload_complete" -
ระบุว่าการอัปโหลดบริการ Build Event สำหรับ --build_event_text_file ควรบล็อกการสร้างเสร็จสมบูรณ์หรือควรสิ้นสุดการเรียกใช้ทันที และอัปโหลดในเบื้องหลังให้เสร็จสิ้น หรือ "wait_for_upload_complete" (ค่าเริ่มต้น), "nowait_for_upload_complete" หรือ "Fully_async"
แท็ก:eagerness_to_exit
- ค่าเริ่มต้น
--build_event_upload_max_retries=<an integer>
: "4" -
จำนวนครั้งสูงสุดที่ Bazel ควรลองอัปโหลดเหตุการณ์บิลด์อีกครั้ง
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[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_retry_minimum_delay=<An immutable length of time.>
: "1s" -
เริ่มแรก ความล่าช้าขั้นต่ำสำหรับการลองใหม่แบบ Exponential Backoff เมื่ออัปโหลด BEP ไม่สำเร็จ (เลขชี้กำลัง: 1.6)
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--experimental_build_event_upload_strategy=<a string>
: ดูคำอธิบาย -
เลือกวิธีอัปโหลดอาร์ติแฟกต์ที่อ้างอิงในโปรโตคอลเหตุการณ์บิลด์
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_collect_load_average_in_profiler
: "true" -
หากเปิดใช้ เครื่องมือสร้างโปรไฟล์จะรวบรวมค่าเฉลี่ยการโหลดโดยรวมของระบบ
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--[no]experimental_collect_pressure_stall_indicators
: "เท็จ" -
หากเปิดใช้ เครื่องมือสร้างโปรไฟล์จะรวบรวมข้อมูล PSI ของ Linux
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--[no]experimental_collect_resource_estimation
: "เท็จ" -
หากเปิดใช้ เครื่องมือสร้างโปรไฟล์จะรวบรวมการประมาณการใช้งาน CPU และหน่วยความจำสำหรับการกระทำเกี่ยวกับสถานที่
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--[no]experimental_collect_skyframe_counts_in_profiler
: "เท็จ" -
หากเปิดใช้ เครื่องมือสร้างโปรไฟล์จะรวบรวมจำนวน SkyFunction ในกราฟ Skyframe เมื่อเวลาผ่านไปสำหรับประเภทฟังก์ชันหลัก เช่น เป้าหมายที่กำหนดค่าไว้และการดำเนินการ อาจมีการกระทบต่อประสิทธิภาพเนื่องจากการเข้าชมกราฟ Skyframe ทั้งรายการในทุกหน่วยเวลาการทำโปรไฟล์ อย่าใช้แฟล็กนี้กับการวัดผลที่สำคัญต่อประสิทธิภาพ
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--[no]experimental_collect_system_network_usage
: "true" -
หากเปิดใช้งาน เครื่องมือสร้างโปรไฟล์จะรวบรวมการใช้งานเครือข่ายของระบบ
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--[no]experimental_collect_worker_data_in_profiler
: "เท็จ" -
หากเปิดใช้ เครื่องมือสร้างโปรไฟล์จะรวบรวมข้อมูลทรัพยากรแบบรวมของผู้ปฏิบัติงาน
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--experimental_command_profile=<cpu, wall, alloc or lock>
: ดูคำอธิบาย - บันทึกโปรไฟล์ Java Flight Recorder ตามระยะเวลาของคำสั่ง ต้องระบุประเภทเหตุการณ์การสร้างโปรไฟล์ที่รองรับ (CPU, หน้าจอ, Allo หรือ Lock) เป็นอาร์กิวเมนต์ โปรไฟล์จะเขียนไปยังไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ภายใต้ไดเรกทอรีฐานเอาต์พุต ไวยากรณ์และความหมายของแฟล็กนี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม คุณต้องรับความเสี่ยงของการใช้งานเองด้วย
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_profile_additional_tasks=<phase, action, discover_inputs, action_check, action_lock, action_update, action_complete, action_rewinding, bzlmod, info, create_package, remote_execution, local_execution, scanner, local_parse, upload_time, remote_process_time, remote_queue, remote_setup, fetch, local_process_time, vfs_stat, vfs_dir, vfs_readlink, vfs_md5, vfs_xattr, vfs_delete, vfs_open, vfs_read, vfs_write, vfs_glob, vfs_vmfs_stat, vfs_vmfs_dir, vfs_vmfs_read, wait, thread_name, thread_sort_index, skyframe_eval, skyfunction, critical_path, critical_path_component, handle_gc_notification, action_counts, action_cache_counts, local_action_counts, local_cpu_usage, system_cpu_usage, cpu_usage_estimation, local_memory_usage, system_memory_usage, memory_usage_estimation, system_network_up_usage, system_network_down_usage, workers_memory_usage, system_load_average, starlark_parser, starlark_user_fn, starlark_builtin_fn, starlark_user_compiled_fn, starlark_repository_fn, action_fs_staging, remote_cache_check, remote_download, remote_network, filesystem_traversal, worker_execution, worker_setup, worker_borrow, worker_working, worker_copying_outputs, credential_helper, pressure_stall_full_io, pressure_stall_full_memory, pressure_stall_some_io, pressure_stall_some_memory, pressure_stall_some_cpu, conflict_check, dynamic_lock, repository_fetch, repository_vendor, glob_skyfunction, glob_skyfunction_done, globs_skyfunction, globs_skyfunction_done, bzl_load_skyfunction, bzl_load_skyfunction_done, package_skyfunction, package_skyfunction_done, action_execution_skyfunction, action_execution_skyfunction_done, configured_target_skyfunction, configured_target_skyfunction_done, aspect_skyfunction, aspect_skyfunction_done or unknown>
รายการ -
ระบุงานเพิ่มเติมเกี่ยวกับโปรไฟล์ที่จะรวมไว้ในโปรไฟล์
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--[no]experimental_profile_include_primary_output
: "เท็จ" -
รวมค่า "ออก" เพิ่มเติม ในเหตุการณ์การดำเนินการที่มีเส้นทางปฏิบัติการไปยังเอาต์พุตหลักของการดำเนินการ
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--[no]experimental_profile_include_target_label
: "เท็จ" -
รวมป้ายกำกับเป้าหมายในเหตุการณ์การดำเนินการ ข้อมูลโปรไฟล์ JSON
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--[no]experimental_record_metrics_for_all_mnemonics
: "เท็จ" - ควบคุมเอาต์พุตของ BEP ActionSummary และ BuildGraphMetrics โดยจำกัดจำนวนบันทึกใน ActionData และจำนวนรายการที่รายงานใน BuildGraphMetrics.AspectCount/RuleClassCount โดยค่าเริ่มต้น จำนวนประเภทจะจำกัดอยู่ที่ 20 อันดับแรก ตามจำนวนการดำเนินการที่ดำเนินการกับ ActionData และอินสแตนซ์สำหรับ RuleClass และ Asepcts การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับการช่วยจำ คลาสของกฎ และแง่มุมต่างๆ ทั้งหมด
- ค่าเริ่มต้น
--[no]experimental_record_skyframe_metrics
: "เท็จ" - ควบคุมเอาต์พุตของ BEP BuildGraphMetrics รวมถึงคำนวณเมตริก SkyFrame ที่ฉับพลันเกี่ยวกับ Skykey, RuleClass และ Aspects หากตั้งค่า Flag นี้เป็น BuildGraphMetrics.rule_count จะทำให้ระบบไม่สร้างข้อมูลมุมมองฟิลด์ใน BEP
- ค่าเริ่มต้น
--[no]experimental_run_bep_event_include_residue
: "เท็จ" -
เลือกว่าจะรวมการขาดเหลือของบรรทัดคำสั่งในเหตุการณ์บิลด์ซึ่งอาจมีส่วนที่เหลือหรือไม่ โดยค่าเริ่มต้น ความต่อเนื่องจะไม่รวมอยู่ในเหตุการณ์การสร้างคำสั่งการเรียกใช้คำสั่งที่อาจมีส่วนที่เหลืออยู่
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_stream_log_file_uploads
: "เท็จ" -
สตรีมไฟล์บันทึกจะอัปโหลดไปยังพื้นที่เก็บข้อมูลระยะไกลโดยตรงแทนการเขียนลงดิสก์
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_workspace_rules_log_file=<a path>
: ดูคำอธิบาย - บันทึกเหตุการณ์บางอย่างของกฎ Workspace ลงในไฟล์นี้เป็นโปรโตคอล WorkspaceEvent ที่คั่นด้วยเครื่องหมาย
- ค่าเริ่มต้น
--[no]generate_json_trace_profile
: "อัตโนมัติ" -
หากเปิดใช้ Bazel จะโปรไฟล์บิลด์และเขียนโปรไฟล์รูปแบบ JSON ลงในไฟล์ในฐานเอาต์พุต ดูโปรไฟล์โดยการโหลดลงใน chrome://tracing โดยค่าเริ่มต้น Bazel จะเขียนโปรไฟล์สำหรับคำสั่งและคำค้นหาที่เหมือนกับบิลด์ทั้งหมด
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--[no]heap_dump_on_oom
: "เท็จ" -
เลือกว่าจะแสดงฮีปดัมป์ด้วยตนเองหรือไม่หากมีการส่ง OOM (รวมถึง OOM ด้วยตนเองเนื่องจากถึง --gc_thrashing_limits) ระบบจะเขียน Dump ไปยัง <output_base>/<invocation_id>.heapdump.hprof ตัวเลือกนี้ใช้แทน -XX:+HeapDumpOnOutOfMemoryError อย่างมีประสิทธิภาพ ซึ่งจะไม่มีผลกับ OOM ที่กำหนดเอง
แท็ก:bazel_monitoring
--jvm_heap_histogram_internal_object_pattern=<a valid Java regular expression>
ค่าเริ่มต้น: "jdk\.internal\.vm\.Filler.+"- นิพจน์ทั่วไปสำหรับลบล้างตรรกะที่ตรงกันสำหรับคอลเล็กชันหน่วยความจำฮีป JDK21+ JVM เราอาศัยรายละเอียดกระบวนการ G1 GC ภายในที่มีความผันผวนเพื่อให้ได้เมตริกหน่วยความจำที่สะอาด ตัวเลือกนี้ช่วยให้เราปรับให้เข้ากับการเปลี่ยนแปลงการใช้งานภายในได้โดยไม่ต้องรอการเปิดตัวแบบไบนารี ส่งผ่านไปยัง JDK Matcher.find()
- ค่าเริ่มต้น
--[no]legacy_important_outputs
: "true" -
ใช้อาร์กิวเมนต์นี้เพื่อระงับการสร้างช่อง legal_outputs เดิมในเหตุการณ์ TargetComplete ต้องใช้ required_outputs สำหรับการผสานรวม Bazel กับ ResultStore
แท็ก:affects_outputs
- ค่าเริ่มต้น
--logging=<0 <= an integer <= 6>
: "3" -
ระดับการบันทึก
แท็ก:affects_outputs
- ค่าเริ่มต้น
--memory_profile=<a path>
: ดูคำอธิบาย -
หากตั้งค่า ให้เขียนข้อมูลการใช้งานหน่วยความจำไปยังไฟล์ที่ระบุเมื่อเฟสสิ้นสุดและฮีปที่เสถียรในบันทึกหลักเมื่อสิ้นสุดบิลด์
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--memory_profile_stable_heap_parameters=<integers, separated by a comma expected in pairs>
: "1,0" -
ปรับการคำนวณฮีปที่เสถียรของโปรไฟล์หน่วยความจำที่ส่วนท้ายของบิลด์ ควรเป็นจํานวนเต็มและจำนวนคู่คั่นด้วยคอมมา ในแต่ละคู่ จำนวนเต็มแรกคือจำนวน GC ที่จะดำเนินการ จำนวนเต็มที่สองในแต่ละคู่คือจำนวนวินาทีที่จะรอระหว่าง GC ตัวอย่างเช่น 2,4,4,0 จะ GC 2 รายการที่มีการหยุดชั่วคราว 4 วินาที ตามด้วย 4 GC ที่มีการหยุดชั่วคราว 0 วินาที
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--profile=<a path>
: ดูคำอธิบาย -
หากมีการตั้งค่า ให้สร้างโปรไฟล์ Bazel และเขียนข้อมูลไปยังไฟล์ที่ระบุ ใช้โปรไฟล์การวิเคราะห์ bazel เพื่อวิเคราะห์โปรไฟล์
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--[no]record_full_profiler_data
: "เท็จ" -
โดยค่าเริ่มต้น เครื่องมือสร้างโปรไฟล์ Bazel จะบันทึกเฉพาะข้อมูลรวมสำหรับกิจกรรมที่รวดเร็ว แต่มีกิจกรรมจำนวนมาก (เช่น การระบุไฟล์) หากเปิดใช้งานตัวเลือกนี้ เครื่องมือสร้างโปรไฟล์จะบันทึกแต่ละเหตุการณ์ ซึ่งทำให้ข้อมูลการทำโปรไฟล์แม่นยำมากขึ้นแต่มีการทำงานที่มีประสิทธิภาพ LARGE ตัวเลือกจะมีผลก็ต่อเมื่อใช้ --profile ด้วย
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--remote_print_execution_messages=<failure, success or all>
: "ล้มเหลว" -
เลือกเวลาที่จะพิมพ์ข้อความการดำเนินการจากระยะไกล ค่าที่ใช้ได้คือ "ล้มเหลว" หากต้องการพิมพ์เมื่อล้มเหลวเท่านั้น "สำเร็จ" เพื่อพิมพ์เฉพาะเมื่อสำเร็จ และ "ทั้งหมด" เพื่อพิมพ์เสมอ
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]slim_profile
: "true" -
ลดขนาดของโปรไฟล์ JSON ลงโดยการรวมเหตุการณ์หากโปรไฟล์มีขนาดใหญ่เกินไป
แท็ก:bazel_monitoring
- ค่าเริ่มต้นของ
--starlark_cpu_profile=<a string>
: "" -
เขียนโปรไฟล์ pprof ของการใช้งาน CPU ของเทรด Starlark ทั้งหมดลงในไฟล์ที่ระบุ
แท็ก:bazel_monitoring
- ค่าเริ่มต้นของ
--tool_tag=<a string>
: "" -
ชื่อเครื่องมือที่จะระบุแหล่งที่มาของการเรียกใช้ Bazel นี้
แท็ก:affects_outputs
bazel_monitoring
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ui_event_filters=<Convert list of comma separated event kind to list of filters>
รายการ -
ระบุเหตุการณ์ที่จะแสดงใน UI คุณสามารถเพิ่มหรือนําเหตุการณ์ออกจากเหตุการณ์เริ่มต้นได้โดยใช้ +/- นําหน้า หรือลบล้างชุดเริ่มต้นทั้งหมดด้วยการกำหนดโดยตรง โดยชุดประเภทเหตุการณ์ที่รองรับประกอบด้วย INFO, DEBUG, ERROR และอื่นๆ
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ค่าเริ่มต้นของ
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
หากไม่ว่างเปล่า ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
- ค่าเริ่มต้น
--experimental_circuit_breaker_strategy=<failure>
: ดูคำอธิบาย -
ระบุกลยุทธ์ที่เบรกเกอร์จะใช้ กลยุทธ์ที่ใช้ได้คือ "ความล้มเหลว" หากค่าที่ไม่ถูกต้องสำหรับตัวเลือก ลักษณะการทำงานเช่นเดียวกันกับตัวเลือกไม่ได้ตั้งค่า
แท็ก:execution
- ค่าเริ่มต้น
--experimental_downloader_config=<a string>
: ดูคำอธิบาย - ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด แต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือสองรูปแบบ รูปแบบหนึ่งจะจับคู่กัน และอีกรูปแบบหนึ่งใช้เป็น URL ทดแทน โดยมีการอ้างอิงกลับเริ่มตั้งแต่ "$1" เป็นไปได้ที่จะมีการใช้คำสั่ง "rewrite" หลายคำสั่งสำหรับ URL เดียวกัน และในกรณีนี้ระบบจะส่งคืน URL หลายรายการ
- ค่าเริ่มต้น
--[no]experimental_guard_against_concurrent_changes
: "เท็จ" - ปิดการตั้งค่านี้เพื่อปิดใช้การตรวจสอบเวลาของไฟล์อินพุตของการดำเนินการก่อนอัปโหลดไปยังแคชระยะไกล ในบางกรณีที่เคอร์เนลของ Linux จะหน่วงเวลาการเขียนไฟล์ ซึ่งอาจทำให้เกิดผลบวกลวง
- ค่าเริ่มต้น
--[no]experimental_remote_cache_async
: "เท็จ" - หากเป็น "จริง" I/O ของแคชระยะไกลจะเกิดขึ้นในเบื้องหลังแทนที่จะเกิดขึ้นเป็นส่วนที่สร้างขึ้น
- ค่าเริ่มต้น
--experimental_remote_cache_compression_threshold=<an integer>
: "0" - ขนาด BLOB ขั้นต่ำที่ต้องใช้เพื่อบีบอัด/คลายการบีบอัดด้วย zstd จะไม่มีผล ยกเว้นกรณีที่ตั้งค่า --remote_cache_compression ไว้
- ค่าเริ่มต้น
--[no]experimental_remote_cache_lease_extension
: "เท็จ" - หากตั้งค่าเป็น "จริง" Bazel จะขยายเวลาการเช่าสำหรับเอาต์พุตของการดำเนินการระยะไกลระหว่างการสร้างโดยการส่งการเรียกใช้ "FindDoesBlobs" ไปยังแคชระยะไกลเป็นระยะ ความถี่จะอิงตามค่าของ "--experimental_remote_cache_ttl"
- ค่าเริ่มต้น
--experimental_remote_cache_ttl=<An immutable length of time.>
: "3 ชม." -
TTL ที่รับประกันขั้นต่ำของ BLOB ในแคชระยะไกลหลังจากมีการอ้างอิงไดเจสต์เมื่อเร็วๆ นี้ เช่น โดย ActionResult หรือ Find MissingBlobs Bazel ทำการเพิ่มประสิทธิภาพมากมายโดยอิงตาม BLOB TTL เช่น ไม่ได้เรียกใช้ GetActionResult ซ้ำๆ ในบิลด์ที่เพิ่มขึ้น ควรกำหนดค่าน้อยกว่า TTL จริงเล็กน้อย เนื่องจากมีช่องว่างระหว่างเวลาที่เซิร์ฟเวอร์แสดงผลไดเจสต์กับเวลาที่ Bazel ได้รับ
แท็ก:execution
- ค่าเริ่มต้น
--experimental_remote_capture_corrupted_outputs=<a path>
: ดูคำอธิบาย - เส้นทางไปยังไดเรกทอรีซึ่งจะมีการบันทึกเอาต์พุตที่เสียหาย
- ค่าเริ่มต้น
--[no]experimental_remote_discard_merkle_trees
: "true" - หากตั้งค่าเป็น "จริง" ให้ทิ้งสำเนาในหน่วยความจำของโครงสร้าง Merkle ของรูทอินพุตและการแมปอินพุตที่เกี่ยวข้องระหว่างการเรียก GetActionResult() และ Execute() ซึ่งช่วยลดการใช้งานหน่วยความจำได้อย่างมาก แต่จะต้องให้ Bazel คํานวณใหม่เมื่อมีการไม่พบแคชระยะไกลหรือลองอีกครั้ง
- ค่าเริ่มต้น
--experimental_remote_downloader=<a string>
: ดูคำอธิบาย - URI ปลายทางของ Remote Asset API ที่จะใช้เป็นพร็อกซีการดาวน์โหลดระยะไกล สคีมาที่รองรับ ได้แก่ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (ซ็อกเก็ต UNIX ในเครื่อง) หากไม่ได้ระบุสคีมา Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ดูที่ https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.เลือก
- ค่าเริ่มต้น
--[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
- ค่าเริ่มต้น
--experimental_remote_output_service=<a string>
: ดูคำอธิบาย - HOST หรือ HOST:PORT ของปลายทางบริการเอาต์พุตระยะไกล สคีมาที่รองรับ ได้แก่ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (ซ็อกเก็ต UNIX ในเครื่อง) หากไม่ได้ระบุสคีมา Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุ grpc:// หรือ unix: สคีมาเพื่อปิดใช้ TLS
- ค่าเริ่มต้นของ
--experimental_remote_output_service_output_path_prefix=<a string>
: "" - เส้นทางที่เก็บเนื้อหาของไดเรกทอรีเอาต์พุตที่จัดการโดย --experimental_remote_output_service ไดเรกทอรีเอาต์พุตจริงที่บิลด์ใช้จะเป็นรายการสืบทอดของเส้นทางนี้และกำหนดโดยบริการเอาต์พุต
- ค่าเริ่มต้น
--[no]experimental_remote_require_cached
: "เท็จ" - หากตั้งค่าเป็น "จริง" ให้บังคับใช้การแคชการดำเนินการทั้งหมดที่เรียกใช้จากระยะไกลได้ ไม่เช่นนั้นจะทำให้บิลด์ใช้งานไม่ได้ วิธีนี้มีประโยชน์ในการแก้ปัญหาที่ไม่ได้กำหนดกระบวนการ เนื่องจากจะช่วยให้ตรวจสอบได้ว่าการดำเนินการที่ควรแคชมีการแคชไว้จริงๆ หรือไม่ โดยไม่ต้องแทรกผลลัพธ์ใหม่ลงในแคชอย่างจงใจ
- ค่าเริ่มต้น
--experimental_remote_scrubbing_config=<Converts to a Scrubber>
: ดูคำอธิบาย - เปิดใช้การสครับคีย์แคชระยะไกลด้วยไฟล์การกำหนดค่าที่ให้มา ซึ่งต้องเป็นบัฟเฟอร์โปรโตคอลในรูปแบบข้อความ (ดู src/main/protocolbuf/remote_scrubbing.เลือก) ฟีเจอร์นี้มีไว้เพื่ออำนวยความสะดวกในการแชร์แคชระยะไกล/ดิสก์ระหว่างการดำเนินการที่ดำเนินการบนแพลตฟอร์มอื่นแต่กำหนดเป้าหมายไปยังแพลตฟอร์มเดียวกัน ควรใช้ด้วยความระมัดระวังอย่างยิ่ง เนื่องจากการตั้งค่าที่ไม่เหมาะสมอาจทำให้เกิดการแชร์รายการแคชโดยไม่ได้ตั้งใจและส่งผลให้เกิดการสร้างที่ไม่ถูกต้อง การสครับไม่มีผลต่อวิธีเรียกใช้การดำเนินการ แต่มีเพียงวิธีการคำนวณคีย์แคชระยะไกล/ดิสก์เพื่อวัตถุประสงค์ในการเรียกข้อมูลหรือจัดเก็บผลลัพธ์การดำเนินการเท่านั้น การดำเนินการแบบสครับใช้กับการดำเนินการระยะไกลไม่ได้ และจะทำงานในเครื่องแทนเสมอ การแก้ไขการกำหนดค่าการสครับจะไม่ทำให้เอาต์พุตที่มีอยู่ในระบบไฟล์ในเครื่องหรือแคชภายในเป็นโมฆะ ต้องใช้บิลด์ใหม่เพื่อดำเนินการทำงานที่ได้รับผลกระทบอีกครั้ง เพื่อให้สามารถใช้ฟีเจอร์นี้ได้สำเร็จ คุณอาจต้องตั้งค่า --host_platform ที่กำหนดเองร่วมกับ --experimental_platform_in_output_dir (เพื่อทำให้คำนำหน้าเอาต์พุตเป็นมาตรฐาน) และ --incompatible_strict_action_env (เพื่อปรับตัวแปรสภาพแวดล้อมให้เป็นมาตรฐาน)
- ค่าเริ่มต้น
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "อัตโนมัติ" - โหมดชุดข้อความที่จะใช้ในการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท หรือใช้เธรดผู้ปฏิบัติงานเสมือนแทน
- ค่าเริ่มต้น
--[no]incompatible_remote_downloader_send_all_headers
: "true" -
เลือกว่าจะส่งค่าทั้งหมดของส่วนหัวที่มีหลายค่าไปยังโปรแกรมดาวน์โหลดระยะไกลแทนที่จะส่งเฉพาะค่าแรกหรือไม่
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_remote_output_paths_relative_to_input_root
: "เท็จ" -
หากตั้งค่าเป็น "จริง" เส้นทางเอาต์พุตจะสัมพัทธ์กับรูทอินพุตแทนที่จะเป็นไดเรกทอรีที่ใช้งานได้
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]remote_accept_cached
: "true" - เลือกว่าจะยอมรับผลการดำเนินการที่แคชไว้จากระยะไกลหรือไม่
- ค่าเริ่มต้น
--remote_build_event_upload=<all or minimal>
: "ขั้นต่ำ" - หากตั้งค่าเป็น "all" ระบบจะอัปโหลดเอาต์พุตในเครื่องทั้งหมดที่ BEP อ้างอิงไปยังแคชระยะไกล หากตั้งค่าเป็น "ค่าต่ำสุด" ระบบจะไม่อัปโหลดเอาต์พุตในเครื่องที่ BEP อ้างอิงไปยังแคชระยะไกล ยกเว้นไฟล์ที่มีความสำคัญต่อผู้บริโภคของ BEP (เช่น บันทึกการทดสอบและโปรไฟล์เวลา) รูปแบบ Bystream:// จะใช้สำหรับ uri ของไฟล์เสมอ แม้ว่าจะไม่มีในแคชระยะไกลก็ตาม ค่าเริ่มต้นคือ "ขั้นต่ำ"
- ค่าเริ่มต้น
--remote_bytestream_uri_prefix=<a string>
: ดูคำอธิบาย - ชื่อโฮสต์และชื่ออินสแตนซ์ที่จะใช้ใน URI ของ bytesstream:// ซึ่งเขียนลงในสตรีมเหตุการณ์ของบิลด์ ตัวเลือกนี้สามารถตั้งค่าได้เมื่อดำเนินการบิลด์โดยใช้พร็อกซี ซึ่งทำให้ค่าของ --remote_executor และ --remote_instance_name ไม่ตรงกับชื่อ Canonical ของบริการการดำเนินการระยะไกลอีกต่อไป หากไม่ได้ตั้งค่า จะมีค่าเริ่มต้นเป็น "${ชื่อโฮสต์}/${instance_name}"
- ค่าเริ่มต้น
--remote_cache=<a string>
: ดูคำอธิบาย - URI ของปลายทางการแคช สคีมาที่รองรับ ได้แก่ http, https, grpc, grpcs (grpc ที่เปิดใช้ TLS) และ unix (local UNIX Sockets) หากไม่ได้ระบุสคีมา Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุสคีมา grpc://, http:// หรือ unix: เพื่อปิดใช้ TLS ดู https://bazel.build/remote/caching
- ค่าเริ่มต้น
--[no]remote_cache_compression
: "เท็จ" - หากเปิดใช้ ให้บีบอัด/ยกเลิกการบีบอัด BLOB ของแคชที่มี zstd เมื่อขนาดเท่ากับ --experimental_remote_cache_compression_threshold เป็นอย่างน้อย
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--remote_cache_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอแคช: --remote_cache_header=Name=Value สามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--remote_default_exec_properties=<a 'name=value' assignment>
รายการ -
ตั้งค่าพร็อพเพอร์ตี้ exec เริ่มต้นที่จะใช้เป็นแพลตฟอร์มการดำเนินการระยะไกล หากแพลตฟอร์มการดำเนินการยังไม่ได้ตั้งค่า exec_properties
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--remote_default_platform_properties=<a string>
: "" - ตั้งค่าพร็อพเพอร์ตี้แพลตฟอร์มเริ่มต้นสำหรับ API การดำเนินการระยะไกล หากแพลตฟอร์มการดำเนินการยังไม่ได้ตั้งค่า Remote_execution_properties เอาไว้ ระบบจะใช้ค่านี้หากเลือกแพลตฟอร์มโฮสต์เป็นแพลตฟอร์มการดำเนินการสำหรับการดำเนินการระยะไกล
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--remote_download_regex=<a valid Java regular expression>
รายการ -
บังคับให้ดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลที่มีเส้นทางตรงกับรูปแบบนี้ โดยไม่คำนึงถึง --remote_download_outputs คุณสามารถระบุรูปแบบได้หลายรูปแบบด้วยการตั้งค่าสถานะนี้ซ้ำ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--remote_downloader_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอโปรแกรมดาวน์โหลดระยะไกล: --remote_downloader_header=Name=Value สามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--remote_exec_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอการดำเนินการ: --remote_exec_header=Name=Value สามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- ค่าเริ่มต้น
--remote_execution_priority=<an integer>
: "0" - ลำดับความสำคัญที่เกี่ยวข้องของการดำเนินการที่จะเรียกใช้จากระยะไกล ความหมายของค่าลำดับความสำคัญหนึ่งๆ จะขึ้นอยู่กับเซิร์ฟเวอร์
- ค่าเริ่มต้น
--remote_executor=<a string>
: ดูคำอธิบาย - HOST หรือ HOST:PORT ของปลายทางการดำเนินการระยะไกล สคีมาที่รองรับ ได้แก่ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (ซ็อกเก็ต UNIX ในเครื่อง) หากไม่ได้ระบุสคีมา Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุ grpc:// หรือ unix: สคีมาเพื่อปิดใช้ TLS
- ค่าเริ่มต้น
--remote_grpc_log=<a path>
: ดูคำอธิบาย - เส้นทางไปยังไฟล์เพื่อบันทึกรายละเอียดเกี่ยวกับการโทร gRPC หากระบุ บันทึกนี้ประกอบด้วยลำดับของ com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry protobufs ของแบบต่อเนื่อง โดยแต่ละข้อความจะมีคำนำหน้าเป็น varint ซึ่งแสดงขนาดของข้อความ protocolbuf แบบต่อเนื่องต่อไปนี้ โดยใช้เมธอด LogEntry.writeDelimitedTo(OutputStream)
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--remote_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอ: --remote_header=Name=Value สามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- ค่าเริ่มต้นของ
--remote_instance_name=<a string>
: "" - ค่าที่จะส่งผ่านเป็นอินสแตนซ์_name ใน API การดำเนินการระยะไกล
- ค่าเริ่มต้น
--[no]remote_local_fallback
: "เท็จ" - กลับไปใช้กลยุทธ์การดำเนินการภายในเครื่องแบบสแตนด์อโลนหรือไม่ หากการดำเนินการจากระยะไกลล้มเหลว
- ค่าเริ่มต้น
--remote_local_fallback_strategy=<a string>
: "ท้องถิ่น" - เลิกใช้งานแล้ว ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7480
- ค่าเริ่มต้น
--remote_max_connections=<an integer>
: "100" -
จำกัดจำนวนการเชื่อมต่อพร้อมกันสูงสุดให้กับแคช/ผู้ดำเนินการระยะไกล ค่าเริ่มต้นคือ 100 การตั้งค่านี้เป็น 0 หมายความว่าไม่มีข้อจำกัด
สำหรับแคชระยะไกล HTTP การเชื่อมต่อ TCP 1 รายการสามารถจัดการคำขอได้ครั้งละ 1 รายการ ดังนั้น Bazel สามารถสร้างคำขอพร้อมกันได้สูงสุด --remote_max_connections
สำหรับแคช/ผู้ดำเนินการระยะไกล gRPC ช่อง gRPC หนึ่งช่องมักจะรองรับคำขอพร้อมกันได้มากกว่า 100 คำขอ ดังนั้น Bazel จึงสามารถสร้างคำขอพร้อมกันประมาณ "--remote_max_connections * 100"
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้น
--remote_proxy=<a string>
: ดูคำอธิบาย - เชื่อมต่อกับแคชระยะไกลผ่านพร็อกซี ปัจจุบัน Flag นี้สามารถใช้เพื่อกำหนดค่า Socket ของโดเมน Unix (unix:/path/to/socket) เท่านั้น
- ค่าเริ่มต้น
--remote_result_cache_priority=<an integer>
: "0" - ลำดับความสำคัญที่เกี่ยวข้องของการดำเนินการระยะไกลที่จะจัดเก็บในแคชระยะไกล ความหมายของค่าลำดับความสำคัญหนึ่งๆ จะขึ้นอยู่กับเซิร์ฟเวอร์
- ค่าเริ่มต้น
--remote_retries=<an integer>
: "5" - จำนวนสูงสุดของความพยายามที่จะลองแก้ไขข้อผิดพลาดชั่วคราวอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
- ค่าเริ่มต้น
--remote_retry_max_delay=<An immutable length of time.>
: "5s" - การหน่วงเวลา Backoff สูงสุดระหว่างการพยายามลองอีกครั้งจากระยะไกล คุณสามารถใช้หน่วยต่อไปนี้: วัน (d), ชั่วโมง (h), นาที (m), วินาที และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
- ค่าเริ่มต้นของ
--remote_timeout=<An immutable length of time.>
: "60 วินาที" - ระยะเวลาสูงสุดในการรอการเรียกใช้จากระยะไกลและการเรียกใช้แคช สำหรับแคช REST นี่คือทั้งการเชื่อมต่อและระยะหมดเวลาในการอ่าน คุณสามารถใช้หน่วยต่อไปนี้: วัน (d), ชั่วโมง (h), นาที (m), วินาที และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
- ค่าเริ่มต้น
--[no]remote_upload_local_results
: "true" - เลือกว่าจะอัปโหลดผลลัพธ์การดำเนินการที่ดำเนินการในเครื่องไปยังแคชระยะไกลหรือไม่ หากแคชระยะไกลรองรับ และผู้ใช้ได้รับอนุญาตให้ดำเนินการดังกล่าว
- ค่าเริ่มต้น
--[no]remote_verify_downloads
: "true" - หากตั้งค่าเป็น "จริง" Bazel จะคำนวณจำนวนแฮชของการดาวน์โหลดระยะไกลทั้งหมด และทิ้งค่าที่แคชไว้จากระยะไกลหากไม่ตรงกับค่าที่คาดไว้
- ตัวเลือกเบ็ดเตล็ด ที่ยังไม่ได้รับการแยกประเภท:
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--build_metadata=<a 'name=value' assignment>
รายการ -
คู่คีย์-ค่าที่กำหนดเองที่จะระบุไว้ในเหตุการณ์บิลด์
แท็ก:terminal_output
- ค่าเริ่มต้น
--color=<yes, no or auto>
: "อัตโนมัติ" - ใช้ตัวควบคุมเทอร์มินัลเพื่อกำหนดสีเอาต์พุต
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--config=<a string>
รายการ - เลือกส่วนการกำหนดค่าเพิ่มเติมจากไฟล์ rc สำหรับทุก <command> จะมีการดึงตัวเลือกจาก <command>:<config> หากมีส่วนดังกล่าว หากไม่มีส่วนนี้ในไฟล์ .rc ระบบจะดำเนินการ Blaze ไม่สำเร็จโดยมีข้อผิดพลาด ส่วนการกำหนดค่าและชุด Flag ต่างๆ ที่เนื้อหาเหล่านี้จะเทียบเท่ากันจะอยู่ในไฟล์การกำหนดค่า Tools/*.blazerc
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
รายการ - กำหนดค่าโปรแกรมช่วยข้อมูลเข้าสู่ระบบที่สอดคล้องกับ<a href="https://github.com/EngFlow/credential-helper-spec">ข้อมูลจำเพาะของโปรแกรมช่วยข้อมูลรับรอง</a> เพื่อใช้สำหรับเรียกข้อมูลเข้าสู่ระบบการให้สิทธิ์สำหรับการดึงข้อมูลที่เก็บ การแคชและการดำเนินการจากระยะไกล และบริการเหตุการณ์ของบิลด์ ข้อมูลเข้าสู่ระบบที่ผู้ช่วยระบุจะมีความสำคัญเหนือกว่าข้อมูลเข้าสู่ระบบที่จัดให้โดย "--google_default_credentials", "--google_credentials", ไฟล์ ".netrc" หรือพารามิเตอร์การตรวจสอบสิทธิ์กับ "repository_ctx.download()" และ "repository_ctx.download_and_extract()" สามารถระบุได้หลายครั้งเพื่อตั้งค่าผู้ช่วยหลายตัว ดูวิธีการได้ที่ https://blog.engflow.com/2023/10/09/configuring-bazels-credential-helper/
- ค่าเริ่มต้นของ
--credential_helper_cache_duration=<An immutable length of time.>
: "30m" - ระยะเวลาเริ่มต้นที่ระบบจะแคชข้อมูลเข้าสู่ระบบที่ตัวช่วยข้อมูลเข้าสู่ระบบให้ไว้ หากตัวช่วยนั้นไม่ได้ระบุเมื่อข้อมูลเข้าสู่ระบบหมดอายุ
- ค่าเริ่มต้น
--credential_helper_timeout=<An immutable length of time.>
: "10 วินาที" - กำหนดค่าการหมดเวลาสำหรับตัวช่วยข้อมูลเข้าสู่ระบบ ตัวช่วยข้อมูลเข้าสู่ระบบที่ไม่ตอบกลับภายในระยะหมดเวลานี้จะเรียกใช้ไม่สําเร็จ
- ค่าเริ่มต้น
--curses=<yes, no or auto>
: "อัตโนมัติ" - ใช้การควบคุมเคอร์เซอร์เทอร์มินัลเพื่อลดขนาดเอาต์พุตแบบเลื่อน
- ค่าเริ่มต้น
--disk_cache=<a path>
: ดูคำอธิบาย - เส้นทางไปยังไดเรกทอรีที่ Bazel อ่านและเขียนการดำเนินการและเอาต์พุตการดำเนินการได้ หากไม่มีไดเรกทอรี ระบบจะสร้างไดเรกทอรีให้
- ค่าเริ่มต้น
--[no]enable_platform_specific_config
: "เท็จ" - หากเป็นจริง Bazel จะใช้บรรทัดการกำหนดค่าเฉพาะโฮสต์ของระบบปฏิบัติการจากไฟล์ bazelrc ตัวอย่างเช่น หากระบบปฏิบัติการของโฮสต์คือ Linux และคุณเรียกใช้บิลด์ของ Bazel เบราว์เซอร์ Bazel จะดึงข้อมูลบรรทัดที่เริ่มต้นด้วย Builder:linux ตัวระบุระบบปฏิบัติการที่รองรับ ได้แก่ Linux, Macos, Windows, Freebsd และ openbsd การเปิดใช้งานการตั้งค่าสถานะนี้เทียบเท่ากับการใช้ --config=linux ใน Linux, --config=windows ใน Windows ฯลฯ
- ค่าเริ่มต้น
--experimental_disk_cache_max_size=<a size in bytes, optionally followed by a K, M, G or T multiplier>
: "0" - ไม่พร้อมใช้งาน
- ค่าเริ่มต้น
--[no]experimental_rule_extension_api
: "เท็จ" -
เปิดใช้ API ส่วนขยายกฎทดลองและ API กฎย่อย
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_windows_watchfs
: "เท็จ" - หากเป็นจริง จะมีการเปิดใช้งานการสนับสนุน Windows รุ่นทดลองสำหรับ --watchfs มิฉะนั้น --watchfsis จะเป็นแบบไม่ดำเนินการบน Windows โปรดตรวจสอบว่าได้เปิดใช้งาน --watchfs ด้วย
- ค่าเริ่มต้น
--google_auth_scopes=<comma-separated list of options>
: "https://www.googleapis.com/auth/cloud-platform" - รายการขอบเขตการตรวจสอบสิทธิ์ Google Cloud ที่คั่นด้วยคอมมา
- ค่าเริ่มต้น
--google_credentials=<a string>
: ดูคำอธิบาย - ระบุไฟล์ที่จะรับข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication
- ค่าเริ่มต้น
--[no]google_default_credentials
: "เท็จ" - จะใช้ "ข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชันของ Google" หรือไม่ เพื่อตรวจสอบสิทธิ์ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication ปิดใช้โดยค่าเริ่มต้น
- ค่าเริ่มต้น
--grpc_keepalive_time=<An immutable length of time.>
: ดูคำอธิบาย - กำหนดค่าคำสั่ง ping แบบ Keep-alive สำหรับการเชื่อมต่อ gRPC ขาออก หากตั้งค่าไว้ Bazel จะส่งคำสั่ง ping หลังจากไม่มีการดำเนินการอ่านในการเชื่อมต่อเป็นเวลานาน แต่เฉพาะเมื่อมีการเรียกใช้ gRPC ที่รอดำเนินการอย่างน้อย 1 ครั้ง เวลาจะถือว่าเป็นรายละเอียดที่ 2 การตั้งค่าน้อยกว่า 1 วินาทีเป็นข้อผิดพลาด โดยค่าเริ่มต้น ระบบจะปิดใช้คําสั่ง ping ของ Keep-alive ไว้ คุณควรประสานงานกับเจ้าของบริการก่อนเปิดใช้การตั้งค่านี้ ตัวอย่างเช่น หากต้องการกำหนดค่า 30 วินาทีให้กับแฟล็กนี้ ก็ควรทำแบบนี้ --grpc_keepalive_time=30s
- ค่าเริ่มต้นของ
--grpc_keepalive_timeout=<An immutable length of time.>
: "20 วินาที" - กำหนดค่าระยะหมดเวลาแบบ Keep-alive สำหรับการเชื่อมต่อ gRPC ขาออก หากเปิดใช้งานคําสั่ง ping ตลอดเวลาด้วย --grpc_keepalive_time แล้ว Bazel จะหมดเวลาการเชื่อมต่อหากไม่ได้รับคําสั่ง ping หลังจากผ่านไประยะหนึ่ง เวลาจะถือว่าเป็นรายละเอียดที่ 2 การตั้งค่าน้อยกว่า 1 วินาทีเป็นข้อผิดพลาด หากปิดการใช้คําสั่ง ping ของ Keep-alive การตั้งค่านี้จะไม่มีผล
- ค่าเริ่มต้น
--[no]incompatible_disable_non_executable_java_binary
: "เท็จ" -
หากเป็นจริง java_binary จะทำงานได้เสมอ นำแอตทริบิวต์ create_executable ออกแล้ว
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้นของ
--invocation_id=<a UUID>
: "" -
ตัวระบุที่ไม่ซ้ำกันในรูปแบบ UUID สำหรับคำสั่งที่เรียกใช้ ผู้โทรจะต้องตรวจสอบความไม่ซ้ำกันหากระบุไว้อย่างชัดแจ้ง UUID จะพิมพ์ไปยัง stderr, BEP และโปรโตคอลการดำเนินการระยะไกล
แท็ก:bazel_monitoring
bazel_internal_configuration
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์ ระบบจะใช้เส้นทางตามที่เป็น ถ้าเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพัทธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางดังกล่าวจะสัมพัทธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel" หากเส้นทางที่ระบุว่างเปล่า ให้นำการลบล้างก่อนหน้าออก
- ค่าเริ่มต้น
--[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 ในทุกระบบปฏิบัติการ: ไม่มีการกำหนดลักษณะการทำงานหากพื้นที่ทำงานอยู่ในระบบไฟล์เครือข่าย และมีการแก้ไขไฟล์ในเครื่องระยะไกล
ตัวเลือกการวิเคราะห์
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_use_plus_in_repo_names
: "true" -
ไม่มีการดำเนินการ
แท็ก:loading_and_analysis
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
- ค่าเริ่มต้น
--dump=<text or raw>
[-d
]: ดูรายละเอียด -
ส่งดัมพ์ของข้อมูลโปรไฟล์แบบเต็มใน "ข้อความ" ที่มนุษย์อ่านได้ "ข้อมูลดิบ" ที่เหมาะกับรูปแบบหรือสคริปต์
แท็ก:bazel_monitoring
ตัวเลือกคำค้นหา
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_use_plus_in_repo_names
: "true" -
ไม่มีการดำเนินการ
แท็ก:loading_and_analysis
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตการค้นหาและความหมาย
- ค่าเริ่มต้น
--aspect_deps=<off, conservative or precise>
: "เชิงรับ" -
วิธีแก้ไขทรัพยากร Dependency ของลักษณะเมื่อรูปแบบเอาต์พุตเป็นหนึ่งใน {xml,protocol,record} "off" หมายความว่าจะไม่มีการแก้ไขทรัพยากร Dependency ในด้านต่างๆ "เชิงรับ" (ค่าเริ่มต้น) หมายความว่าจะมีการเพิ่มทรัพยากร Dependency ที่ประกาศทั้งหมด ไม่ว่าทรัพยากรเหล่านั้นจะได้รับคลาสของกฎการขึ้นต่อกันโดยตรงหรือไม่ ซึ่งก็คือ "แม่นยำ" หมายความว่าจะมีการเพิ่มเฉพาะด้านที่อาจทำงานอยู่ตามคลาสกฎของทรัพยากร Dependency โดยตรง โปรดทราบว่าโหมดแม่นยำต้องมีการโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียว ซึ่งจะทำให้ช้ากว่าโหมดอื่นๆ และโปรดทราบด้วยว่า โหมดแม้กระทั่งที่แม่นยำก็ไม่ได้แม่นยำทั้งหมด การตัดสินใจว่าจะคำนวณด้านใดด้านหนึ่งหรือไม่จะทำในขั้นตอนการวิเคราะห์ ซึ่งจะไม่ทำงานระหว่าง "การค้นหาแบบงัดแงะ"
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]consistent_labels
: "เท็จ" -
หากเปิดใช้งาน ทุกคำสั่งการค้นหาจะแสดงป้ายกำกับประหนึ่งว่าด้วย Starlark <code>str</code> ที่ใช้กับ<code>ป้ายกำกับ</code> อินสแตนซ์ ซึ่งมีประโยชน์สำหรับเครื่องมือที่จำเป็นต้องจับคู่เอาต์พุตของคำสั่งการค้นหาและ/หรือป้ายกำกับต่างๆ ที่กฎเรียกใช้ หากไม่เปิดใช้ ตัวจัดรูปแบบเอาต์พุตจะแสดงชื่อที่เก็บที่ชัดเจน (สัมพันธ์กับที่เก็บหลัก) แทนเพื่อทำให้เอาต์พุตอ่านได้ง่ายขึ้น
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]experimental_explicit_aspects
: "เท็จ" -
aquery, cquery: จะรวมการทำงานที่สร้างโดยมุมมองไว้ในเอาต์พุตหรือไม่ คำค้นหา: ไม่มีการดำเนินการ (ติดตามเสมอ)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]graph:factored
: "true" -
หากเป็น "จริง" กราฟจะแสดงผลแบบ "แยกตัวประกอบ" นั่นคือ โหนดที่เท่าเทียมกันทางโทโพโลจีจะผสานเข้าด้วยกันและป้ายกำกับของโหนดทั้งสองเชื่อมติดกัน ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้น
--graph:node_limit=<an integer>
: "512" -
ความยาวสูงสุดของสตริงป้ายกำกับสำหรับโหนดกราฟในเอาต์พุต ป้ายกำกับที่ยาวขึ้นจะถูกตัด -1 หมายถึงไม่มีการตัดข้อความ ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]implicit_deps
: "true" -
หากเปิดใช้ การขึ้นต่อกันโดยปริยายจะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ทรัพยากร Dependency โดยนัยคือทรัพยากรที่ไม่มีการระบุอย่างชัดแจ้งในไฟล์ BUILD แต่เพิ่มโดย Bazel สำหรับ cquery ตัวเลือกนี้จะควบคุมการกรอง Toolchain ที่มีการแก้ปัญหาแล้ว
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]include_artifacts
: "true" -
รวมชื่อของอินพุตและเอาต์พุตการดำเนินการในเอาต์พุต (ซึ่งอาจมีขนาดใหญ่)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]include_aspects
: "true" -
aquery, cquery: จะรวมการทำงานที่สร้างโดยมุมมองไว้ในเอาต์พุตหรือไม่ คำค้นหา: ไม่มีการดำเนินการ (ติดตามเสมอ)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]include_commandline
: "true" -
มีเนื้อหาของบรรทัดคำสั่งสำหรับการดำเนินการในเอาต์พุต (อาจมีขนาดใหญ่)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]include_file_write_contents
: "เท็จ" -
ใส่เนื้อหาไฟล์สำหรับการดำเนินการ FileWrite, SourceSymlinkManifest และ RepoMappingManifest (ซึ่งอาจมีขนาดใหญ่)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]include_param_files
: "เท็จ" -
รวมเนื้อหาของไฟล์พารามิเตอร์ที่ใช้ในคำสั่ง (อาจมีขนาดใหญ่) หมายเหตุ: การเปิดใช้งานการตั้งค่าสถานะนี้จะเป็นการเปิดใช้การตั้งค่าสถานะ --include_commandline โดยอัตโนมัติ
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]include_scheduling_dependencies
: "เท็จ" -
รวมชื่อของทรัพยากร Dependency ในกำหนดการของการดำเนินการ (ซึ่งอาจมีขนาดใหญ่) จะมีผลเมื่อตั้งค่า --include_artifacts ไว้เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]incompatible_package_group_includes_double_slash
: "true" -
หากเปิดใช้ เมื่อแสดงแอตทริบิวต์ "packages" ของpackage_group จะไม่ละเว้น "//" ที่นำหน้า
แท็ก:terminal_output
incompatible_change
- ค่าเริ่มต้น
--[no]infer_universe_scope
: "เท็จ" -
หากตั้งค่า และ --universe_scope ไม่ได้ตั้งค่าไว้ ระบบจะอนุมานค่าของ --universe_scope เป็นรายการรูปแบบเป้าหมายที่ไม่ซ้ำกันในนิพจน์การค้นหา โปรดทราบว่าค่า --universe_scope ที่อนุมานสำหรับนิพจน์การค้นหาที่ใช้ฟังก์ชันที่กําหนดขอบเขตระดับจักรวาล (เช่น "allrdeps") อาจไม่ใช่สิ่งที่คุณต้องการ คุณจึงควรใช้ตัวเลือกนี้ก็ต่อเมื่อคุณทราบว่าคุณกำลังทำอะไรอยู่เท่านั้น ดูรายละเอียดและตัวอย่างได้ที่ https://bazel.build/reference/query#sky-query หากตั้งค่า --universe_scope ค่า ระบบจะไม่สนใจค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้ใช้ได้เฉพาะกับ "query" (กล่าวคือ ไม่ใช่ "cquery")
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]line_terminator_null
: "เท็จ" -
เลือกว่าจะสิ้นสุดแต่ละรูปแบบด้วย \0 แทนการขึ้นบรรทัดใหม่หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]nodep_deps
: "true" -
หากเปิดใช้ ระบบจะแยกออกจาก "nodep" จะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ตัวอย่างทั่วไปของ "nodep" คือ "visibility" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ "info create-language" เพื่อดูข้อมูลเกี่ยวกับ "nodep" ทั้งหมด ในภาษาของบิลด์
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--output=<a string>
: "ข้อความ" -
รูปแบบที่ควรพิมพ์ผลการค้นหาคำค้นหา ค่าที่อนุญาตสำหรับ aquery คือ text, textprotocol, proto, streamed_profi, jsonprotocol
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:default_values
: "true" -
หากเป็น "จริง" ระบบจะรวมแอตทริบิวต์ที่ไม่ได้ระบุไว้อย่างชัดเจนในไฟล์ BUILD มิฉะนั้นจะถูกละเว้น ตัวเลือกนี้ใช้ได้กับ --output=prof
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:definition_stack
: "เท็จ" -
ป้อนข้อมูลในช่อง Proto ของ Definition_stack ซึ่งบันทึกสำหรับสแต็กการเรียกใช้ Starlark สำหรับแต่ละอินสแตนซ์ของกฎ ณ เวลาที่มีการกำหนดคลาสของกฎ
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:flatten_selects
: "true" -
หากเปิดใช้ ระบบจะแยกแอตทริบิวต์ที่กำหนดค่าได้ซึ่งสร้างโดย select() ไว้ในรูปแบบ สำหรับประเภทรายการ การแสดงแบบ "แยกเป็นหลายรายการ" คือรายการซึ่งประกอบด้วยแต่ละค่าของแผนที่ที่เลือกเพียงครั้งเดียว ระบบจะแยกประเภทสเกลาร์เป็นค่าว่าง
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]proto:include_attribute_source_aspects
: "เท็จ" -
ป้อนข้อมูลในช่อง Proto ของ source_aspect_name ของแต่ละแอตทริบิวต์ด้วยลักษณะต้นทางของแอตทริบิวต์นั้น (สตริงว่างเปล่าหากไม่มีข้อมูล)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:include_synthetic_attribute_hash
: "เท็จ" -
คำนวณและเติมข้อมูลแอตทริบิวต์ $internal_attr_hash หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:instantiation_stack
: "เท็จ" -
ป้อนข้อมูลสแต็กการเรียกใช้การสร้างอินสแตนซ์ของแต่ละกฎ โปรดทราบว่าการดำเนินการนี้ต้องมีสแต็กอยู่
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:locations
: "true" -
ระบุว่าจะแสดงข้อมูลตำแหน่งในเอาต์พุต Pro เลยหรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้น
--proto:output_rule_attrs=<comma-separated list of options>
: "ทั้งหมด" -
รายการแอตทริบิวต์ที่คั่นด้วยจุลภาคที่จะรวมในเอาต์พุต ค่าเริ่มต้นคือแอตทริบิวต์ทั้งหมด ตั้งค่าเป็นสตริงว่างเปล่าเพื่อไม่ให้แสดงแอตทริบิวต์ใดๆ ตัวเลือกนี้ใช้ได้กับ --output=protocol
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:rule_inputs_and_outputs
: "true" -
เติมข้อมูลในช่อง rules_input และ rules_output หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--query_file=<a string>
: "" -
หากมีการตั้งค่าไว้ การค้นหาจะอ่านการค้นหาจากไฟล์ที่มีชื่อที่นี่ แทนที่จะเป็นบรรทัดคำสั่ง การระบุไฟล์ที่นี่และคำค้นหาบรรทัดคำสั่งเป็นข้อผิดพลาด
แท็ก:changes_inputs
- ค่าเริ่มต้น
--[no]relative_locations
: "เท็จ" -
หากเป็นจริง ตำแหน่งของไฟล์ BUILD ใน XML และเอาต์พุต Pro จะสัมพันธ์กัน โดยค่าเริ่มต้น เอาต์พุตตำแหน่งจะเป็นเส้นทางสัมบูรณ์และจะไม่สอดคล้องกันในแต่ละเครื่อง คุณสามารถตั้งค่าตัวเลือกนี้เป็น "จริง" เพื่อให้ได้ผลลัพธ์ที่สอดคล้องกันในอุปกรณ์ทุกเครื่อง
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]skyframe_state
: "เท็จ" -
ดัมพ์กราฟการดำเนินการปัจจุบันจาก Skyframe โดยไม่ต้องทำการวิเคราะห์เพิ่มเติม หมายเหตุ: ขณะนี้ระบบยังไม่รองรับการระบุเป้าหมายด้วย --skyframe_state แฟล็กนี้ใช้ได้เฉพาะกับ --output=prof หรือ --output=textprotocol
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]tool_deps
: "true" -
การค้นหา: หากปิดใช้ ทรัพยากร Dependency ใน "การกำหนดค่า exec" จะไม่รวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน "การกำหนดค่าการดำเนินการ" เอดจ์ของทรัพยากร Dependency เช่น ขีดจำกัดจาก "proto_library" ให้กับโปรโตคอลคอมไพเลอร์ ซึ่งโดยทั่วไปจะชี้ไปยังเครื่องมือที่ดำเนินการระหว่างการสร้างแทนที่จะเป็นส่วนของ "เป้าหมาย" เดียวกัน ของโปรแกรม
Cquery: หากปิดใช้ จะกรองเป้าหมายที่กำหนดค่าไว้ทั้งหมดซึ่งข้ามการเปลี่ยนการดำเนินการจากเป้าหมายระดับบนสุดที่ค้นพบเป้าหมายที่กำหนดค่าไว้นี้ออก ซึ่งหมายความว่าหากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าเป้าหมาย ระบบจะแสดงผลเฉพาะเป้าหมายที่กำหนดค่าไว้ในการกำหนดค่าเป้าหมายด้วย ถ้าเป้าหมายระดับบนสุดอยู่ในการกำหนดค่า exec ระบบจะแสดงผลเฉพาะเป้าหมายที่กำหนดค่าของ exec เท่านั้น ตัวเลือกนี้จะ "ไม่" ยกเว้น Toolchain ที่แก้ไขแล้ว
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--universe_scope=<comma-separated list of options>
: "" -
ชุดรูปแบบเป้าหมายที่คั่นด้วยคอมมา (บวกและลบ) การค้นหาอาจดำเนินการในจักรวาลที่กำหนดโดยการปิดแบบสับเปลี่ยนของเป้าหมายที่ระบุ ตัวเลือกนี้ใช้สําหรับคำสั่งการค้นหาและคำสั่ง cquery
สำหรับ cquery อินพุตของตัวเลือกนี้จะเป็นเป้าหมายในการสร้างคำตอบทั้งหมด ดังนั้นตัวเลือกนี้อาจส่งผลต่อการกําหนดค่าและการเปลี่ยน หากไม่ได้ระบุตัวเลือกนี้ ระบบจะถือว่าเป้าหมายระดับบนสุดเป็นเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหา หมายเหตุ: สำหรับ cquery การไม่ระบุตัวเลือกนี้อาจทำให้บิลด์ไม่ทำงานหากเป้าหมายที่แยกวิเคราะห์จากนิพจน์คำค้นหาไม่สามารถสร้างได้ด้วยตัวเลือกระดับบนสุด
แท็ก:loading_and_analysis
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์:
- ค่าเริ่มต้น
--[no]experimental_inprocess_symlink_creation
: "เท็จ" -
เลือกว่าจะเรียกใช้ระบบไฟล์โดยตรงเพื่อสร้างต้นไม้ Symlink หรือไม่
แท็ก:loading_and_analysis
,execution
,experimental
- ค่าเริ่มต้น
--[no]experimental_persistent_aar_extractor
: "เท็จ" -
เปิดใช้เครื่องมือแยก Aar แบบถาวรโดยใช้ผู้ปฏิบัติงาน
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_remotable_source_manifests
: "เท็จ" -
ต้องการให้การดำเนินการในไฟล์ Manifest ของแหล่งที่มาทำซ้ำได้หรือไม่
แท็ก:loading_and_analysis
,execution
,experimental
- ค่าเริ่มต้น
--[no]experimental_split_coverage_postprocessing
: "เท็จ" -
หากเป็น "จริง" Bazel จะดำเนินการประมวลผลภายหลังสำหรับการครอบคลุมในการทดลองที่สร้างขึ้นใหม่
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_strict_fileset_output
: "เท็จ" -
หากเปิดใช้ตัวเลือกนี้ ชุดไฟล์จะถือว่าอาร์ติแฟกต์เอาต์พุตทั้งหมดเป็นไฟล์ทั่วไป โดยจะไม่ข้ามผ่านไดเรกทอรีหรือไวต่อลิงก์สัญลักษณ์
แท็ก:execution
- ค่าเริ่มต้น
--[no]incompatible_modify_execution_info_additive
: "เท็จ" -
เมื่อเปิดใช้ การส่งแฟล็ก --modify_execution_info หลายรายการจะเป็นแบบบวกเพิ่ม เมื่อปิดใช้ ระบบจะพิจารณาเฉพาะธงล่าสุดเท่านั้น
แท็ก:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
รายการ -
เพิ่มหรือนำคีย์ออกจากข้อมูลการดำเนินการของการดำเนินการตามความสามารถในการจำการดำเนินการ ใช้กับการดำเนินการที่รองรับข้อมูลการดำเนินการเท่านั้น การดำเนินการทั่วไปจำนวนมากรองรับข้อมูลการดำเนินการ เช่น Genrule, CppCompile, Javac, StarlarkAction, TestRunner เมื่อระบุค่าหลายค่า ลำดับมีความสำคัญเนื่องจาก regexe หลายรายการอาจใช้กับช่วยจำเดียวกันได้
ไวยากรณ์: "regex=[+-]key,regex=[+-]key,..."
ตัวอย่าง:
'.*=+x,.*=-y,.*=+z' เพิ่ม "x" และ "z" ถึง และนำ "y" ออก ข้อมูลการดำเนินการสำหรับการดำเนินการทั้งหมด
'Genrule=+requires-x' เพิ่ม "requires-x" กับข้อมูลการดำเนินการสำหรับการดำเนินการ Genrule ทั้งหมด
'(?!Genrule).*=-requires-x' นำ "requires-x" ออก จากข้อมูลการดำเนินการสำหรับการดำเนินการ
ที่ไม่ใช่ Genrule ทั้งหมด
แท็ก:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
เปิดใช้การดำเนินการ Dex และ desugar ของ Android แบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
แท็ก:host_machine_resource_optimizations
execution
--persistent_android_resource_processor
-
เปิดใช้ผู้ประมวลผลข้อมูลทรัพยากร Android ถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
เปิดใช้การดำเนินการ Dex และ desugar ของ Android แบบมัลติเพล็กซ์โดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
เปิดใช้เครื่องมือประมวลผลทรัพยากร Android แบบมัลติเพล็กซ์แบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
เปิดใช้เครื่องมือ Android แบบต่อเนื่องและแบบมัลติเพล็กซ์ (Dexing, Deugaring, Resource Operations)
ขยายเป็น
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
แท็ก:host_machine_resource_optimizations
execution
- ค่าเริ่มต้น
--[no]use_target_platform_for_tests
: "เท็จ" -
หากเป็น "จริง" Bazel จะใช้แพลตฟอร์มเป้าหมายในการทำการทดสอบแทนกลุ่มผู้บริหารทดสอบ
แท็ก:execution
- ตัวเลือกที่กำหนดค่า Toolchain ที่ใช้สำหรับการดำเนินการมีดังนี้
- ค่าเริ่มต้น
--android_compiler=<a string>
: ดูคำอธิบาย -
คอมไพเลอร์เป้าหมายของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_manifest_merger=<legacy, android or force_android>
: "android" -
เลือกการควบรวมไฟล์ Manifest ที่จะใช้กับกฎ android_binary แจ้งเพื่อช่วยให้เปลี่ยนไปใช้การผสานรวมไฟล์ Manifest ของ Android จากการควบรวมเดิม
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_platforms=<a build target label>
: "" -
ตั้งค่าแพลตฟอร์มที่ android_binary กำหนดเป้าหมายใช้ หากระบุหลายแพลตฟอร์ม ไบนารีนั้นจะเป็น APK แบบอ้วน ซึ่งมีไบนารีแบบเนทีฟสำหรับแต่ละแพลตฟอร์มเป้าหมายที่ระบุ
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_sdk=<a build target label>
: "@bazel_tools//tools/android:sdk" -
ระบุ SDK/แพลตฟอร์ม Android ที่ใช้สร้างแอปพลิเคชัน Android
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้ในกฎของ Apple และ Objc และทรัพยากร Dependency
แท็ก:loses_incremental_state
changes_inputs
- ค่าเริ่มต้นของ
--cc_output_directory_tag=<a string>
: "" -
ระบุคำต่อท้ายที่จะเพิ่มในไดเรกทอรีการกำหนดค่า
แท็ก:affects_outputs
- ค่าเริ่มต้น
--compiler=<a string>
: ดูคำอธิบาย -
คอมไพเลอร์ C++ ที่จะใช้สำหรับการคอมไพล์เป้าหมาย
แท็ก:loading_and_analysis
execution
--coverage_output_generator=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:lcov_merger"-
ตำแหน่งของไบนารีที่ใช้เพื่อประมวลผลรายงานการครอบคลุมแบบข้อมูลดิบหลังการประมวลผล ซึ่งต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งก็คือไบนารี ค่าเริ่มต้นคือ "//tools/test:lcov_merger"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_report_generator"-
ตําแหน่งของไบนารีที่ใช้สร้างรายงานการครอบคลุม ซึ่งต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งก็คือไบนารี ค่าเริ่มต้นคือ "//tools/test:coverage_report_generator"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_support"-
ตำแหน่งของไฟล์สนับสนุนที่จำเป็นต้องใช้ในอินพุตของการดำเนินการทดสอบทั้งหมดที่รวบรวมการครอบคลุมของโค้ด ค่าเริ่มต้นคือ "//tools/test:coverage_support"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--custom_malloc=<a build target label>
: ดูคำอธิบาย -
ระบุการใช้งาน Malloc ที่กำหนดเอง การตั้งค่านี้จะลบล้างแอตทริบิวต์ Malloc ในกฎบิลด์
แท็ก:changes_inputs
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
รายการ -
รายการนิพจน์ทั่วไปที่คั่นด้วยคอมมา แต่ละรายการจะมีคำนำหน้าด้วย - (นิพจน์เชิงลบ) และกำหนด (=) ให้กับรายการเป้าหมายค่าข้อจำกัดที่คั่นด้วยคอมมา หากเป้าหมายตรงกับที่ไม่มีนิพจน์เชิงลบ และนิพจน์เชิงบวกอย่างน้อย 1 รายการ การแปลง Toolchain จะดำเนินการเสมือนว่าได้ประกาศค่าข้อจำกัดเป็นข้อจำกัดการดำเนินการ ตัวอย่าง: //demo,-test=@platforms//cpus:x86_64 จะเพิ่ม "x86_64" ไปยังเป้าหมายใดๆ ภายใต้ //demo ยกเว้นเป้าหมายที่ชื่อมี "test"
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_include_xcode_execution_requirements
: "เท็จ" -
เมื่อตั้งค่าแล้ว ให้เพิ่ม "requires-xcode:{version}" สำหรับการดำเนินการของ Xcode ทุกครั้ง หากเวอร์ชัน Xcode มีป้ายกำกับขีดกลาง ให้เพิ่ม "requires-xcode-label:{version_label}" ด้วย ข้อกำหนดของการดำเนินการ
แท็ก:loses_incremental_state
,loading_and_analysis
,execution
- ค่าเริ่มต้น
--[no]experimental_prefer_mutual_xcode
: "true" -
หากเป็นจริง ให้ใช้ Xcode ล่าสุดที่พร้อมใช้งานทั้งในเครื่องและจากระยะไกล หากเป็นเท็จหรือไม่มีเวอร์ชันที่ใช้ร่วมกัน ให้ใช้เวอร์ชันของ Xcode ในเครื่องที่เลือกผ่าน xcode-select
แท็ก:loses_incremental_state
- ค่าเริ่มต้นของ
--extra_execution_platforms=<comma-separated list of options>
: "" -
แพลตฟอร์มที่มีให้ใช้งานเป็นแพลตฟอร์มการดำเนินการเพื่อเรียกใช้การดำเนินการ สามารถระบุแพลตฟอร์มโดยเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมาย แพลตฟอร์มเหล่านี้จะได้รับการพิจารณาก่อนแพลตฟอร์มที่ประกาศในไฟล์ WORKSPACE โดยregister_execution_platforms() ตัวเลือกนี้ตั้งค่าได้เพียงครั้งเดียว อินสแตนซ์ภายหลังจะลบล้างการตั้งค่าแฟล็กก่อนหน้า
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--extra_toolchains=<comma-separated list of options>
รายการ -
กฎ Toolchain ที่จะต้องพิจารณาระหว่างการแก้ไข Toolchain สามารถระบุ Toolchains ตามเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมายได้ ระบบจะพิจารณา Toolchain เหล่านี้ก่อนการประกาศในไฟล์ WORKSPACE โดยregister_toolchains()
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--grte_top=<a label>
: ดูคำอธิบาย -
ป้ายกำกับไปยังไลบรารี libc ที่มีการเช็คอิน Crosstool Toolchain จะเลือกค่าเริ่มต้นและคุณแทบจะไม่จำเป็นต้องลบล้างค่าเริ่มต้น
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--host_compiler=<a string>
: ดูคำอธิบาย -
แฟล็กที่ไม่มีการดำเนินการ ระบบจะนำออกในรุ่นถัดไป
แท็ก:loading_and_analysis
execution
- ค่าเริ่มต้น
--host_grte_top=<a label>
: ดูคำอธิบาย -
ถ้าระบุ การตั้งค่านี้จะลบล้างไดเรกทอรีระดับบนสุดของ libc (--grte_top) สำหรับการกำหนดค่าผู้บริหาร
แท็ก:action_command_lines
affects_outputs
--host_platform=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools:host_platform"-
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายระบบโฮสต์
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--[no]incompatible_bazel_test_exec_run_under
: "เท็จ" -
หากเปิดใช้ "การทดสอบ bazel --run_under=//:runner" บิลด์ "//:runner" ในการกำหนดค่า exec หากปิดใช้ จะสร้าง "//:runner" ในการกำหนดค่าเป้าหมาย Bazel ทำการทดสอบบนเครื่องปฏิบัติการ ดังนั้นเครื่องแรกจึงถูกต้องกว่า ซึ่งไม่ส่งผลกับ "Bazel Run" ซึ่งจะสร้าง "`--run_under=//foo" เสมอ ในการกำหนดค่าเป้าหมาย
แท็ก:affects_outputs
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_apple_toolchain_resolution
: "เท็จ" -
ใช้ความละเอียดของ Toolchain เพื่อเลือก Apple SDK สำหรับกฎของ Apple (Starlark และเนทีฟ)
แท็ก: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_strip_executable_safely
: "เท็จ" -
หากเป็น "จริง" การดำเนินการตัดไฟล์สำหรับไฟล์ปฏิบัติการจะใช้แฟล็ก -x ซึ่งไม่ส่งผลกับความละเอียดของสัญลักษณ์แบบไดนามิก
แท็ก:action_command_lines
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
,immutable
- ค่าเริ่มต้นของ
--platforms=<a build target label>
: "" -
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายแพลตฟอร์มเป้าหมายสำหรับคำสั่งปัจจุบัน
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--python_path=<a string>
: ดูคำอธิบาย -
Absolute Path ของล่าม Python มีการเรียกใช้เป้าหมาย Python บนแพลตฟอร์มเป้าหมาย เลิกใช้งาน; ปิดใช้งานโดย --incompatible_use_python_toolchains
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้น
--python_top=<a build target label>
: ดูคำอธิบาย -
ป้ายกำกับของ py_runtime ที่แทนอินเทอร์พรีเตอร์ Python ได้มีการเรียกให้เรียกใช้เป้าหมาย Python บนแพลตฟอร์มเป้าหมาย เลิกใช้งาน; ปิดใช้งานโดย --incompatible_use_python_toolchains
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้น
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
ระบุเวอร์ชันของ tvOS SDK ที่จะใช้สร้างแอปพลิเคชัน tvOS หากไม่ระบุ ระบบจะใช้เวอร์ชันเริ่มต้นของ tvOS SDK จาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
ระบุเวอร์ชันของ WatchOS SDK ที่จะใช้สร้างแอปพลิเคชัน watchOS หากไม่ระบุ ระบบจะใช้เวอร์ชัน WatchOS SDK เริ่มต้นจาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--xcode_version=<a string>
: ดูคำอธิบาย -
หากระบุไว้ ให้ใช้ Xcode ของเวอร์ชันที่ระบุสำหรับการดำเนินการของบิลด์ที่เกี่ยวข้อง หากไม่ระบุ ระบบจะใช้ Xcode เวอร์ชันเริ่มต้นของผู้ดำเนินการ
แท็ก:loses_incremental_state
--xcode_version_config=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:host_xcodes"-
ป้ายกำกับของกฎ xcode_config ที่จะใช้สำหรับเลือกเวอร์ชัน Xcode ในการกำหนดค่าบิลด์
แท็ก:loses_incremental_state
loading_and_analysis
- มีดังนี้
- ค่าเริ่มต้น
--[no]apple_generate_dsym
: "เท็จ" -
เลือกว่าจะสร้างไฟล์สัญลักษณ์การแก้ไขข้อบกพร่อง (.dSYM) หรือไม่
แท็ก:affects_outputs
action_command_lines
- ค่าเริ่มต้น
--[no]build_runfile_links
: "true" -
หากเป็น "จริง" ให้สร้างศูนย์การเรียกใช้ไฟล์ symlink สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้เขียนเมื่อต้องใช้การดำเนินการในเครื่อง ทดสอบ หรือเรียกใช้คำสั่งเท่านั้น
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]build_runfile_manifests
: "true" -
หากเป็น "จริง" ให้เขียนไฟล์ Manifest ของการเรียกใช้ไฟล์สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้ละเว้น การทดสอบในเครื่องจะทํางานไม่ได้หากเป็นเท็จ
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]build_test_dwp
: "เท็จ" -
หากเปิดใช้ เมื่อสร้างการทดสอบ C++ แบบคงที่ และด้วยฟิชชัน ไฟล์ .dwp สำหรับไบนารีการทดสอบจะสร้างขึ้นโดยอัตโนมัติเช่นกัน
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้นของ
--cc_proto_library_header_suffixes=<comma-separated set of options>
: ".pb.h" -
ตั้งค่าคำต่อท้ายของไฟล์ส่วนหัวที่ cc_proto_library สร้างขึ้น
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--cc_proto_library_source_suffixes=<comma-separated set of options>
: ".pb.cc" -
ตั้งค่าคำต่อท้ายของไฟล์ต้นฉบับที่ cc_protocol_library สร้างขึ้น
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_proto_descriptor_sets_include_source_info
: "เท็จ" -
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันอื่นๆ ใน protocol_library
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_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
- ค่าเริ่มต้น
--[no]android_databinding_use_androidx
: "true" -
สร้างไฟล์การเชื่อมโยงข้อมูลที่ใช้กับ AndroidX ได้ ใช้ได้เฉพาะกับการเชื่อมโยงข้อมูล v2 เท่านั้น แฟล็กนี้ไม่มีการใช้งาน
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]android_databinding_use_v3_4_args
: "true" -
ใช้ Android Databinding v2 ที่มีอาร์กิวเมนต์ 3.4.0 แฟล็กนี้ไม่มีการใช้งาน
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้นของ
--android_dynamic_mode=<off, default or fully>
: "ปิด" -
กำหนดว่าจะให้ลิงก์ C++ ของกฎ Android แบบไดนามิกหรือไม่ เมื่อ cc_binary ไม่ได้สร้างไลบรารีที่ใช้ร่วมกันอย่างชัดแจ้ง "ค่าเริ่มต้น" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "สมบูรณ์" หมายความว่าไลบรารีทั้งหมดจะลิงก์แบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "ตามตัวอักษร" -
ตั้งค่าลำดับของไฟล์ Manifest ที่ส่งไปยังการรวมไฟล์ Manifest สำหรับไบนารีของ Android อัลฟ่าหมายความว่าไฟล์ Manifest ได้รับการจัดเรียงตามเส้นทางที่สัมพันธ์กับผู้ดำเนินการ ALPHABETICAL_BY_CONFIGURATION หมายความว่าไฟล์ Manifest ได้รับการจัดเรียงตามเส้นทางที่สัมพันธ์กับไดเรกทอรีการกำหนดค่าภายในไดเรกทอรีเอาต์พุต DEPENDENCY หมายความว่าไฟล์ Manifest จะเรียงลำดับตามไฟล์ Manifest ของไลบรารีแต่ละรายการที่อยู่ก่อนไฟล์ Manifest ของทรัพยากร Dependency
แท็ก:action_command_lines
execution
- ค่าเริ่มต้น
--[no]android_resource_shrinking
: "เท็จ" -
เปิดใช้การย่อทรัพยากรสำหรับ APK android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]build_python_zip
: "อัตโนมัติ" -
สร้าง ZIP ที่เป็นไฟล์ปฏิบัติการ Python ใน Windows และปิดบนแพลตฟอร์มอื่น
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--catalyst_cpus=<comma-separated list of options>
รายการ -
รายชื่อสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple Catalyst
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--[no]collect_code_coverage
: "เท็จ" -
หากระบุไว้ Bazel จะใช้โค้ดเครื่องมือวัด (โดยใช้การใช้เครื่องมือแบบออฟไลน์หากเป็นไปได้) และจะรวบรวมข้อมูลการครอบคลุมระหว่างการทดสอบ เฉพาะเป้าหมายที่ตรงกับ --instrumentation_filter จะได้รับผลกระทบ โดยปกติ ตัวเลือกนี้ไม่ควรระบุโดยตรง - "ความครอบคลุมของbazel" ควรใช้คำสั่งแทน
แท็ก:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] ค่าเริ่มต้น: "fastbuild"-
ระบุโหมดที่จะมีการสร้างไบนารี ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--conlyopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--copt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง gcc
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้นของ
--cpu=<a string>
: "" -
CPU เป้าหมาย
แท็ก:changes_inputs
affects_outputs
- ค่าเริ่มต้น
--cs_fdo_absolute_path=<a string>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ CSFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อเส้นทางสัมบูรณ์ของไฟล์ ZIP ที่มีไฟล์โปรไฟล์, ไฟล์ข้อมูล RAW หรือไฟล์โปรไฟล์ LLVM ที่จัดทำดัชนีไว้
แท็ก:affects_outputs
- ค่าเริ่มต้น
--cs_fdo_instrument=<a string>
: ดูคำอธิบาย -
สร้างไบนารีด้วยเครื่องมือ FDO ที่ละเอียดอ่อนตามบริบท เมื่อใช้คอมไพเลอร์ Clang/LLVM คีย์ดังกล่าวจะยอมรับชื่อไดเรกทอรีที่ระบบจะส่งออกไฟล์โปรไฟล์แบบ RAW ขณะรันไทม์ด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--cs_fdo_profile=<a build target label>
: ดูคำอธิบาย -
cs_fdo_profile แสดงถึงโปรไฟล์ที่ละเอียดอ่อนตามบริบทที่จะใช้ในการเพิ่มประสิทธิภาพ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--cxxopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C++
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--define=<a 'name=value' assignment>
รายการ -
ตัวเลือก --define แต่ละรายการจะระบุการมอบหมายสำหรับตัวแปรบิลด์ ในกรณีที่ตัวแปรหนึ่งมีค่าหลายค่า ค่าสุดท้ายจะชนะ
แท็ก:changes_inputs
affects_outputs
- ค่าเริ่มต้น
--dynamic_mode=<off, default or fully>
: "ค่าเริ่มต้น" -
กำหนดว่าจะลิงก์ไบนารีของ C++ แบบไดนามิกหรือไม่ "ค่าเริ่มต้น" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "สมบูรณ์" หมายความว่าไลบรารีทั้งหมดจะลิงก์แบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้น
--[no]enable_propeller_optimize_absolute_paths
: "true" -
หากตั้งค่าไว้ การใช้เส้นทางสัมบูรณ์สำหรับการเพิ่มประสิทธิภาพใบพัดจะทำให้เกิดข้อผิดพลาด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]enable_remaining_fdo_absolute_paths
: "true" -
ถ้ามีการตั้งค่า การใช้เส้นทางสัมบูรณ์สำหรับ FDO จะทำให้เกิดข้อผิดพลาด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]enable_runfiles
: "อัตโนมัติ" -
เปิดใช้โครงสร้างลิงก์สัญลักษณ์ของ Runfiles ซึ่งโดยค่าเริ่มต้น จะปิดอยู่ใน Windows และในแพลตฟอร์มอื่นๆ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_action_listener=<a build target label>
รายการ -
เลิกใช้งานไปทีละด้าน ใช้ action_listener เพื่อแนบทางลัดไปยังการดำเนินการบิลด์ที่มีอยู่
แท็ก:execution
experimental
- ค่าเริ่มต้น
--[no]experimental_android_compress_java_resources
: "เท็จ" -
บีบอัดทรัพยากร Java ใน APK
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_android_databinding_v2
: "true" -
ใช้ Android Data Binding v2 แฟล็กนี้ไม่มีการใช้งาน
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]experimental_android_resource_shrinking
: "เท็จ" -
เปิดใช้การย่อทรัพยากรสำหรับ APK android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_android_rewrite_dexes_with_rex
: "เท็จ" -
ใช้เครื่องมือ Rex เพื่อเขียนไฟล์ dex ใหม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]experimental_collect_code_coverage_for_generated_files
: "เท็จ" -
หากระบุไว้ Bazel จะสร้างการรวบรวมข้อมูลที่ครอบคลุมสำหรับไฟล์ที่สร้างขึ้นด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_objc_fastbuild_options=<comma-separated list of options>
: "-O0,-DDEBUG=1" -
ใช้สตริงเหล่านี้เป็นตัวเลือกคอมไพเลอร์ objc Fastbuild
แท็ก:action_command_lines
- ค่าเริ่มต้น
--[no]experimental_omitfp
: "เท็จ" -
หากเป็น "จริง" ให้ใช้ libunwind สำหรับการคลายสแต็ก แล้วคอมไพล์ด้วย -fomit-frame-pointer และ -fasynchronous-unwind-tables
แท็ก:action_command_lines
,affects_outputs
,experimental
- ค่าเริ่มต้นของ
--experimental_output_paths=<off, content or strip>
: "ปิด" -
โมเดลที่ควรใช้สำหรับส่วนใดในกฎแผนผังเอาต์พุตจะเขียนเอาต์พุต โดยเฉพาะอย่างยิ่งสำหรับบิลด์ที่มีหลายแพลตฟอร์ม / หลายการกำหนดค่า ฟีเจอร์นี้อยู่ในขั้นทดลอง ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/6526 การดำเนินการของ Starlark เลือกใช้การแมปเส้นทางได้ด้วยการเพิ่มคีย์ "supports-path-mapping" เป็น "execution_requirements" พิมพ์ตามคำบอก
แท็ก:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
รายการ -
แต่ละรายการควรอยู่ในรูปแบบ label=value โดยที่ป้ายกำกับอ้างอิงถึงแพลตฟอร์ม และค่าคือชื่อย่อที่ต้องการใช้ในเส้นทางเอาต์พุต ใช้เมื่อ --experimental_platform_in_output_dir เป็นจริงเท่านั้น มีลำดับความสำคัญในการตั้งชื่อสูงสุด
แท็ก:affects_outputs
experimental
- ค่าเริ่มต้น
--[no]experimental_platform_in_output_dir
: "เท็จ" -
หากเป็นจริง ระบบจะใช้ชื่อย่อของแพลตฟอร์มเป้าหมายในชื่อไดเรกทอรีเอาต์พุตแทน CPU รูปแบบที่แน่นอนอยู่ในขั้นทดลองและอาจมีการเปลี่ยนแปลง อย่างแรก ในกรณีซึ่งเกิดขึ้นไม่บ่อยนัก ตัวเลือก --platforms ไม่ได้มีค่าเพียงค่าเดียว ระบบจะใช้แฮชของตัวเลือกแพลตฟอร์ม ถัดไป หากชื่อย่อของแพลตฟอร์มปัจจุบันลงทะเบียนโดย --experimental_override_name_platform_in_output_dir ระบบจะใช้ชื่อย่อนั้น จากนั้น หากมีการตั้งค่า --experimental_use_platforms_in_output_dir_legacy_heurism ให้ใช้ชื่อย่อที่อ้างอิงจากป้ายกำกับแพลตฟอร์มปัจจุบัน สุดท้าย ระบบจะใช้แฮชของตัวเลือกแพลตฟอร์มเป็นทางเลือกสุดท้าย
แท็ก:affects_outputs
experimental
- ค่าเริ่มต้น
--[no]experimental_use_llvm_covmap
: "เท็จ" -
หากระบุ Bazel จะสร้างข้อมูลแผนที่ความครอบคลุมของ llvm-cov แทนที่จะเป็น gcov เมื่อเปิดใช้งานcollect_code_coverage
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
: "true" -
โปรดใช้แฟล็กนี้เป็นส่วนหนึ่งของกลยุทธ์การย้ายข้อมูลหรือการทดสอบที่แนะนำเท่านั้น โปรดทราบว่าการเรียนรู้มีข้อบกพร่องที่ทราบแล้ว และแนะนำให้เปลี่ยนไปใช้เพียง --experimental_override_name_platform_in_output_dir
แท็ก:affects_outputs
experimental
- ค่าเริ่มต้นของ
--fat_apk_cpu=<comma-separated set of options>
: "armeabi-v7a" -
การตั้งค่าตัวเลือกนี้จะเปิดใช้ APK แบบอ้วน ซึ่งมีไบนารีแบบเนทีฟสำหรับสถาปัตยกรรมเป้าหมายที่ระบุทั้งหมด เช่น --fat_apk_cpu=x86,armeabi-v7a. หากระบุแฟล็กนี้ ระบบจะละเว้น --android_cpu สำหรับทรัพยากร Dependency ของกฎ android_binary
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--fdo_instrument=<a string>
: ดูคำอธิบาย -
สร้างไบนารีด้วยเครื่องมือ FDO เมื่อใช้คอมไพเลอร์ Clang/LLVM คีย์ดังกล่าวจะยอมรับชื่อไดเรกทอรีที่ระบบจะส่งออกไฟล์โปรไฟล์แบบ RAW ขณะรันไทม์ด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_optimize=<a string>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ FDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อไฟล์ ZIP ที่มีแผนผังไฟล์ .gcda, ไฟล์ afdo ที่มีโปรไฟล์อัตโนมัติ หรือไฟล์โปรไฟล์ LLVM แฟล็กนี้ยอมรับไฟล์ที่ระบุเป็นป้ายกำกับด้วย (เช่น "//foo/bar:file.afdo" คุณอาจต้องเพิ่มคำสั่ง "exports_files" ไปยังแพ็กเกจที่เกี่ยวข้อง) และป้ายกำกับที่ชี้ไปยังเป้าหมาย "fdo_profile" การตั้งค่าสถานะนี้จะถูกแทนที่โดยกฎ "fdo_profile"
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_prefetch_hints=<a build target label>
: ดูคำอธิบาย -
ใช้คำแนะนำการดึงข้อมูลแคชล่วงหน้า
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_profile=<a build target label>
: ดูคำอธิบาย -
fdo_profile แทนโปรไฟล์ที่จะใช้ในการเพิ่มประสิทธิภาพ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--features=<a string>
รายการ -
ระบบจะเปิดใช้หรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างขึ้นในการกำหนดค่าเป้าหมาย กำลังระบุ -<feature> จะปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ ดูเพิ่มเติมที่ --host_features
แท็ก:changes_inputs
affects_outputs
- ค่าเริ่มต้น
--[no]force_pic
: "เท็จ" -
หากเปิดใช้งาน การคอมไพล์ C++ ทั้งหมดจะสร้างโค้ดที่ไม่ขึ้นอยู่กับตำแหน่ง ("-fPIC") ลิงก์จะใช้ไลบรารีที่สร้างไว้ล่วงหน้าของ PIC มากกว่าไลบรารีที่ไม่ใช่ PIC และลิงก์จะสร้างไฟล์ปฏิบัติการที่ไม่ขึ้นอยู่กับตำแหน่ง ("-pie")
แท็ก:loading_and_analysis
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_action_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกำหนดค่าการดำเนินการ คุณระบุตัวแปรได้ด้วยชื่อ ซึ่งในกรณีนี้ระบบจะนําค่าจากสภาพแวดล้อมการเรียกใช้ หรือคู่ name=value ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ ตัวเลือกนี้ใช้ได้หลายครั้ง สำหรับตัวเลือกที่ระบุสำหรับตัวแปรเดียวกัน ค่าที่ชนะล่าสุด และตัวเลือกของตัวแปรต่างๆ จะสะสมอยู่
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--host_compilation_mode=<fastbuild, dbg or opt>
: "opt" -
ระบุโหมดที่จะมีการสร้างเครื่องมือที่ใช้ในการสร้าง ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_conlyopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งไปยังคอมไพเลอร์ C เมื่อคอมไพล์ไฟล์ต้นฉบับ C (ไม่ใช่ C++) ในการกำหนดค่าผู้บริหาร
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_copt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยังคอมไพเลอร์ C สำหรับเครื่องมือที่สร้างขึ้นในการกำหนดค่าการดำเนินการ
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้นของ
--host_cpu=<a string>
: "" -
CPU ของโฮสต์
แท็ก:changes_inputs
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_cxxopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยังคอมไพเลอร์ C++ สำหรับเครื่องมือที่สร้างขึ้นในการกำหนดค่าดำเนินการ
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_features=<a string>
รายการ -
ระบบจะเปิดใช้หรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างขึ้นในการกำหนดค่า exec กำลังระบุ -<feature> จะปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ
แท็ก:changes_inputs
affects_outputs
- ค่าเริ่มต้น
--host_force_python=<PY2 or PY3>
: ดูคำอธิบาย -
ลบล้างเวอร์ชัน Python สำหรับการกำหนดค่า exec อาจเป็น "PY2" หรือ "PY3"
แท็ก:loading_and_analysis
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_linkopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง Linker เมื่อลิงก์เครื่องมือในการกำหนดค่าการดำเนินการ
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน macOS ที่เข้ากันได้ขั้นต่ำสำหรับเป้าหมายโฮสต์ หากไม่ได้ระบุ ให้ใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อเลือกส่งไปยังคอมไพเลอร์ C/C++ ที่เลือกเมื่อคอมไพล์ไฟล์บางไฟล์ในการกำหนดค่าผู้บริหาร ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจากรายการรวมและไม่รวมรูปแบบนิพจน์ทั่วไป (ดู --instrumentation_filter) ด้วย Option_1 กับ Option_n นั้นย่อมาจากตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ ในการแยกสตริงจะใช้เฉพาะ @ แรกเท่านั้น ตัวอย่าง: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--[no]incompatible_auto_exec_groups
: "เท็จ" -
เมื่อเปิดใช้ ระบบจะสร้างกลุ่มผู้บริหารสำหรับ Toolchain แต่ละรายการที่กฎใช้โดยอัตโนมัติ กฎในการทำงานนี้ต้องระบุพารามิเตอร์ "toolchain" ในการดำเนินการ ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/17134
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_merge_genfiles_directory
: "true" -
หากเป็นจริง ไดเรกทอรี genfiles จะถูกพับลงในไดเรกทอรี bin
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]instrument_test_targets
: "เท็จ" -
เมื่อเปิดใช้การครอบคลุม ให้ระบุว่าจะพิจารณาการใช้กฎการทดสอบการวัดคุมหรือไม่ เมื่อตั้งค่าแล้ว กฎการทดสอบที่ --instrumentation_filter รวมอยู่จะมีการวัดคุม มิฉะนั้น กฎการทดสอบจะถูกยกเว้นจากการวัดคุมการครอบคลุมเสมอ
แท็ก:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
ค่าเริ่มต้น: "-/javatests[/:],-/test/java[/:]"-
เมื่อเปิดใช้การครอบคลุม ระบบจะวัดเฉพาะกฎที่มีชื่อซึ่งตัวกรองตามนิพจน์ทั่วไปที่ระบุรวมอยู่เท่านั้น กฎที่ขึ้นต้นด้วย "-" จะได้รับการยกเว้นแทน โปรดทราบว่าระบบจะวัดคุมเฉพาะกฎที่ไม่ใช่การทดสอบเท่านั้น ยกเว้นกรณีที่เปิดใช้งาน --instrument_test_targets
แท็ก:affects_outputs
- ค่าเริ่มต้น
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน iOS ที่เข้ากันได้ขั้นต่ำสำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ระบุ ให้ใช้ "ios_sdk_version"
แท็ก:loses_incremental_state
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ios_multi_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างแอปพลิเคชัน ios_ ผลลัพธ์จะเป็นไบนารีสากลที่มีสถาปัตยกรรมที่ระบุทั้งหมด
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--[no]legacy_whole_archive
: "true" -
เลิกใช้งานแล้ว และมีผลแทนด้วย --inสามารถเข้าถึง_remove_legacy_whole_archive (ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7362) เมื่อเปิด ให้ใช้ --whole-archive สำหรับกฎ cc_binary ที่มี linkshared=True และ linkstatic=True หรือ '-static' ใน Linkopts วิธีนี้ใช้สำหรับความเข้ากันได้แบบย้อนหลังเท่านั้น อีกทางเลือกหนึ่งที่ดีกว่าคือการใช้ Alwayslink=1 เมื่อจำเป็น
แท็ก:action_command_lines
,affects_outputs
,deprecated
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--linkopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งไปยัง gcc เมื่อลิงก์
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ltobackendopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังขั้นตอนแบ็กเอนด์ของ LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ltoindexopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังขั้นตอนการจัดทำดัชนี LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--macos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple macOS
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน macOS ที่เข้ากันได้ขั้นต่ำสำหรับเป้าหมาย หากไม่ได้ระบุ ให้ใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--memprof_profile=<a build target label>
: ดูคำอธิบาย -
ใช้โปรไฟล์ Memprof
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]objc_debug_with_GLIBCXX
: "เท็จ" -
หากตั้งค่า และตั้งค่าโหมดการคอมไพล์เป็น "dbg" ให้กำหนด GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC และ GLIBCPP_CONCEPT_CHECKS
แท็ก:action_command_lines
- ค่าเริ่มต้น
--[no]objc_enable_binary_stripping
: "เท็จ" -
เลือกว่าจะดำเนินการลบสัญลักษณ์และโค้ดที่เสียหายในไบนารีที่ลิงก์หรือไม่ ระบบจะลบไบนารีหากระบุทั้ง Flag และ --compilation_mode=opt นี้
แท็ก:action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--objccopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ Objective-C/C++
แท็ก:action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งผ่านไปยัง gcc เฉพาะเมื่อคอมไพล์ไฟล์บางไฟล์ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจากรายการรวมและไม่รวมรูปแบบนิพจน์ทั่วไป (ดู --instrumentation_filter) ด้วย Option_1 กับ Option_n นั้นย่อมาจากตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ ในการแยกสตริงจะใช้เฉพาะ @ แรกเท่านั้น ตัวอย่าง: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับเลือกส่งไปยังแบ็กเอนด์ LTO (ในส่วน --features=thin_lto) เมื่อคอมไพล์ออบเจ็กต์แบ็กเอนด์บางรายการ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจาก รายการรูปแบบ รวมและยกเว้น ของนิพจน์ทั่วไป Option_1 กับ Option_n นั้นย่อมาจากตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ ในการแยกสตริงจะใช้เฉพาะ @ แรกเท่านั้น ตัวอย่าง: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่งแบ็กเอนด์ LTO ของไฟล์ o ทั้งหมดใน //foo/ ยกเว้น bar.o
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--platform_suffix=<a string>
: ดูคำอธิบาย -
ระบุคำต่อท้ายที่จะเพิ่มในไดเรกทอรีการกำหนดค่า
แท็ก:loses_incremental_state
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--propeller_optimize=<a build target label>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ Propeller เพื่อเพิ่มประสิทธิภาพเป้าหมายของบิลด์ โปรไฟล์ใบพัดต้องประกอบด้วยไฟล์อย่างน้อย 1 จาก 2 ไฟล์ โปรไฟล์สำเนา และโปรไฟล์ ld แฟล็กนี้ยอมรับป้ายกำกับบิลด์ซึ่งต้องอ้างถึงไฟล์อินพุตโปรไฟล์ใบพัด ตัวอย่างเช่น ไฟล์ BUILD ที่กำหนดป้ายกำกับใน a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)อาจต้องเพิ่มคำสั่ง ecommerce_files ลงในแพ็กเกจที่เกี่ยวข้องเพื่อให้ Bazel มองเห็นไฟล์เหล่านี้ ต้องใช้ตัวเลือกเป็น: --propeller_optimize=//a/b:propeller_profile
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--propeller_optimize_absolute_cc_profile=<a string>
: ดูคำอธิบาย -
ชื่อเส้นทางสัมบูรณ์ของไฟล์ cc_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพใบพัด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--propeller_optimize_absolute_ld_profile=<a string>
: ดูคำอธิบาย -
ชื่อเส้นทางสัมบูรณ์ของไฟล์ ld_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพใบพัด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--run_under=<a prefix in front of command>
: ดูคำอธิบาย -
คำนำหน้าที่จะแทรกก่อนไฟล์ปฏิบัติการสำหรับ "การทดสอบ" และ "เรียกใช้" คำสั่ง หากค่าคือ "foo -bar" และบรรทัดคำสั่งสำหรับการดำเนินการคือ "test_binary -baz" บรรทัดคำสั่งสุดท้ายคือ "foo -bar test_binary -baz" บรรทัดคำสั่งนี้อาจเป็นป้ายกำกับของเป้าหมายสั่งการได้ด้วย ตัวอย่างเช่น 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'
แท็ก:action_command_lines
-
หากจริง ระบบจะแชร์ไลบรารีเนทีฟที่มีฟังก์ชันการทำงานเหมือนกันกับเป้าหมายต่างๆ
แท็ก: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
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--tvos_cpus=<comma-separated list of options>
รายการ -
รายชื่อสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple tvOS
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน tvOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ระบุ ให้ใช้ "tvos_sdk_version"
แท็ก:loses_incremental_state
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--visionos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple visionOS
แท็ก:loses_incremental_state
loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--watchos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple WatchOS
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน WatchOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ได้ระบุ ให้ใช้ "watchos_sdk_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--xbinary_fdo=<a build target label>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ XbinaryFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อของโปรไฟล์แบบไบนารีที่เป็นค่าเริ่มต้น เมื่อใช้ตัวเลือกนี้ร่วมกับ --fdo_instrument/--fdo_optimize/--fdo_profile ตัวเลือกเหล่านั้นจะมีผลเหนือกว่าเสมอเสมือนว่าไม่ได้ระบุ xbinary_fdo
แท็ก:affects_outputs
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตบิลด์ที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมธง ฯลฯ)
- ค่าเริ่มต้น
--[no]check_licenses
: "เท็จ" -
ตรวจสอบว่าข้อจำกัดในการออกใบอนุญาตที่กำหนดโดยแพ็กเกจที่เกี่ยวข้องไม่ขัดแย้งกับโหมดการเผยแพร่ของเป้าหมายที่กำลังสร้าง โดยค่าเริ่มต้น ใบอนุญาตจะไม่ได้รับการตรวจสอบ
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]check_visibility
: "true" -
หากปิดใช้ ระบบจะลดระดับข้อผิดพลาดระดับการเข้าถึงในทรัพยากร Dependency เป้าหมายให้เหลือเพียงคําเตือน
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]desugar_for_android
: "true" -
เลือกว่าจะใช้ไบต์โค้ด Java 8 ก่อนถอดรหัสหรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--[no]desugar_java8_libs
: "เท็จ" -
เลือกว่าจะรวมไลบรารี Java 8 ที่รองรับในแอปสำหรับอุปกรณ์เดิมหรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]enforce_constraints
: "true" -
ตรวจสอบสภาพแวดล้อมที่แต่ละเป้าหมายใช้งานร่วมกันได้ และรายงานข้อผิดพลาดหากเป้าหมายมีทรัพยากร Dependency ที่ไม่รองรับสภาพแวดล้อมเดียวกัน
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]experimental_check_desugar_deps
: "true" -
ตรวจสอบความถูกต้องของการแยกน้ำตาลที่ระดับไบนารีของ Android อีกครั้งหรือไม่
แท็ก:eagerness_to_exit
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--experimental_import_deps_checking=<a string>
: ดูคำอธิบาย -
ไม่มีการดำเนินการ เก็บไว้สำหรับความเข้ากันได้แบบย้อนหลังเท่านั้น
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--experimental_one_version_enforcement=<off, warning or error>
: "ปิด" -
เมื่อเปิดใช้ ให้บังคับใช้ว่ากฎ java_binary จะมีไฟล์คลาสเดียวกันใน classpath มากกว่า 1 เวอร์ชันไม่ได้ การบังคับใช้นี้อาจทำให้บิลด์เสียหายหรืออาจทำให้เกิดคำเตือน
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "ค่าเริ่มต้น" -
หากเป็นจริง ให้ตรวจสอบว่าเป้าหมาย Java ประกาศเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency อย่างชัดเจน
แท็ก:build_file_semantics
eagerness_to_exit
- ค่าเริ่มต้น
--[no]incompatible_check_testonly_for_output_files
: "เท็จ" -
หากเปิดใช้ ให้ตรวจสอบ testonly สำหรับเป้าหมายที่จำเป็นเบื้องต้นที่เป็นไฟล์เอาต์พุตโดยค้นหา testonly ของกฎที่สร้าง รายการนี้ตรงกับการตรวจสอบระดับการเข้าถึง
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_check_visibility_for_toolchains
: "เท็จ" -
หากเปิดใช้ การตรวจสอบระดับการเข้าถึงจะมีผลกับการติดตั้งใช้งาน Toolchain ด้วย
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disable_native_android_rules
: "เท็จ" -
หากเปิดใช้ ระบบจะปิดใช้กฎที่มีอยู่สำหรับ Android โดยตรง โปรดใช้กฎของ Android Starlark จาก https://github.com/bazelbuild/rules_android
แท็ก:eagerness_to_exit
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disable_native_apple_binary_rule
: "เท็จ" -
ไม่มีการดำเนินการ เก็บไว้ที่นี่เพื่อดูความเข้ากันได้แบบย้อนหลัง
แท็ก:eagerness_to_exit
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_python_disable_py2
: "true" -
หากเป็น "จริง" การใช้การตั้งค่า Python 2 จะทำให้เกิดข้อผิดพลาด ซึ่งรวมถึง python_version=PY2, srcs_version=PY2 และ srcs_version=PY2ONLY ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/15684
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]one_version_enforcement_on_java_tests
: "true" -
เมื่อเปิดใช้ และตั้งค่า Experiment_one_version_enforcement เป็นค่าที่ไม่ใช่ NONE แล้ว ให้บังคับใช้ 1 เวอร์ชันกับเป้าหมาย java_test คุณสามารถปิดการแจ้งว่าไม่เหมาะสมนี้เพื่อปรับปรุงประสิทธิภาพการทดสอบให้ดียิ่งขึ้นได้ โดยไม่ต้องกลัวว่าจะมีการละเมิดเวอร์ชันใดเวอร์ชันหนึ่ง
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--python_native_rules_allowlist=<a build target label>
: ดูคำอธิบาย -
รายการที่อนุญาต (package_group target (เป้าหมายกลุ่มแพ็กเกจ) ที่จะใช้เมื่อบังคับใช้ --incompatible_python_disallow_native_rules
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]strict_filesets
: "เท็จ" -
หากเปิดใช้ตัวเลือกนี้ ระบบจะรายงานว่าชุดไฟล์ข้ามขอบเขตของแพ็กเกจเป็นข้อผิดพลาด
แท็ก:build_file_semantics
eagerness_to_exit
- ค่าเริ่มต้น
--strict_proto_deps=<off, warn, error, strict or default>
: "ข้อผิดพลาด" -
หากไม่ "ปิด" ให้ตรวจสอบว่าเป้าหมาย protocol_library ประกาศอย่างชัดแจ้งว่าเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้นของ
--strict_public_imports=<off, warn, error, strict or default>
: "ปิด" -
หากไม่ "ปิด" ให้ตรวจสอบว่าเป้าหมาย protocol_library ประกาศอย่างชัดเจนถึงเป้าหมายทั้งหมดที่ใช้ใน "นำเข้าสาธารณะ" ตามที่ส่งออกแล้ว
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้น
--[no]strict_system_includes
: "เท็จ" -
หากเป็น "จริง" ส่วนหัวที่พบผ่านทางระบบรวมเส้นทาง (-isystem) ต้องมีการประกาศด้วย
แท็ก:loading_and_analysis
eagerness_to_exit
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--target_environment=<a build target label>
รายการ -
ประกาศสภาพแวดล้อมเป้าหมายของบิลด์นี้ ต้องอ้างอิงถึงป้ายกำกับไปยัง "สภาพแวดล้อม" กฎ หากระบุ เป้าหมายระดับบนสุดทั้งหมดต้องเข้ากันได้กับสภาพแวดล้อมนี้
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อเอาต์พุตการลงชื่อของบิลด์:
- ค่าเริ่มต้น
--apk_signing_method=<v1, v2, v1_v2 or v4>
: "v1_v2" -
การใช้งานเพื่อรับรอง APK
แท็ก:action_command_lines
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--[no]device_debug_entitlements
: "true" -
หากมีการตั้งค่า และโหมดการคอมไพล์ไม่ใช่ "เพิ่มประสิทธิภาพ" แอป objc จะรวมการให้สิทธิ์การแก้ไขข้อบกพร่องเมื่อลงชื่อ
แท็ก:changes_inputs
- ค่าเริ่มต้น
--ios_signing_cert_name=<a string>
: ดูคำอธิบาย -
ชื่อใบรับรองที่จะใช้สำหรับ iOS Signing หากไม่ได้ตั้งค่า ระบบจะกลับไปใช้โปรไฟล์การจัดสรร อาจเป็นค่ากำหนดข้อมูลประจำตัว Keychain ของใบรับรองหรือ (สตริงย่อย) ของชื่อสามัญของใบรับรองตามหน้า man ของ Codesign (รหัสการลงชื่อเข้าใช้)
แท็ก:action_command_lines
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_disallow_legacy_py_provider
: "true" -
ไม่มีการดำเนินการ จะถูกนำออกในเร็วๆ นี้
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disallow_sdk_frameworks_attributes
: "เท็จ" -
หากเป็น "จริง" ไม่อนุญาตแอตทริบิวต์ sdk_frameworks และ external_sdk_frameworks ใน objc_library andobjc_import
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_objc_alwayslink_by_default
: "เท็จ" -
หากเป็น "จริง" ตั้งค่าเริ่มต้นเป็น "จริง" สำหรับแอตทริบิวต์ Alwayslink ใน objc_library และ objc_IMPORT
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_python_disallow_native_rules
: "เท็จ" -
เมื่อเป็นจริง เกิดข้อผิดพลาดขึ้นเมื่อใช้กฎ py_* ในตัว ควรใช้กฎ rules_python แทน ดูข้อมูลเพิ่มเติมและวิธีการย้ายข้อมูลได้ที่ https://github.com/bazelbuild/bazel/issues/17773
แท็ก:loading_and_analysis
incompatible_change
- สภาพแวดล้อมการทดสอบหรือตัวดำเนินการทดสอบ:
- ค่าเริ่มต้น
--[no]allow_analysis_failures
: "เท็จ" -
หากจริง การวิเคราะห์เป้าหมายของกฎไม่สำเร็จส่งผลให้เกิดการเผยแพร่อินสแตนซ์ของ AnalysisFailureInfo ของเป้าหมายที่มีคำอธิบายข้อผิดพลาด แทนที่จะทำให้บิลด์ไม่สำเร็จ
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--analysis_testing_deps_limit=<an integer>
: "2000" -
ตั้งค่าจำนวนสูงสุดของทรัพยากร Dependency แบบทรานซิทีฟผ่านแอตทริบิวต์กฎที่มีการเปลี่ยนการกำหนดค่า for_analysis_testing การใช้เกินขีดจำกัดนี้จะทำให้เกิดข้อผิดพลาดของกฎ
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]break_build_on_parallel_dex2oat_failure
: "เท็จ" -
หากความล้มเหลวจริงในการดำเนินการ dex2oat จะทำให้บิลด์เสียหายแทนที่จะเรียกใช้ dex2oat ระหว่างรันไทม์ทดสอบ
แท็ก:loading_and_analysis
experimental
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g memory=10,30,60,100>
รายการ - ลบล้างจำนวนทรัพยากรเริ่มต้นสำหรับการทดสอบ รูปแบบที่คาดไว้คือ <resource>=<value> หากระบุจำนวนบวกตัวเดียวเป็น <value> ระบบจะลบล้างทรัพยากรเริ่มต้นสำหรับขนาดทดสอบทั้งหมด หากระบุตัวเลขที่คั่นด้วยคอมมา 4 ตัว จำนวนดังกล่าวจะแทนที่จำนวนทรัพยากรสำหรับขนาดทดสอบขนาดเล็ก กลาง ใหญ่ และขนาดใหญ่ตามลำดับ ค่าอาจเป็น HOST_RAM/HOST_CPU (ไม่บังคับ) ตามด้วย [-|*]<Flo> (เช่น Memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4) ทรัพยากรการทดสอบเริ่มต้นที่ระบุโดยแฟล็กนี้จะถูกลบล้างโดยทรัพยากรที่อาจไม่เหมาะสมซึ่งระบุไว้ในแท็ก
- ค่าเริ่มต้น
--[no]experimental_android_use_parallel_dex2oat
: "เท็จ" -
ใช้ dex2oat แบบขนานเพื่อเร่งความเร็ว android_test
แท็ก:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- ค่าเริ่มต้น
--[no]ios_memleaks
: "เท็จ" -
เปิดใช้การตรวจหาหน่วยความจำรั่วไหลในเป้าหมาย ios_test
แท็ก:action_command_lines
- ค่าเริ่มต้น
--ios_simulator_device=<a string>
: ดูคำอธิบาย -
อุปกรณ์ที่จะจำลองเมื่อเรียกใช้แอปพลิเคชัน iOS ในเครื่องมือจำลอง เช่น "iPhone 6" คุณดูรายการอุปกรณ์ได้โดยเรียกใช้ "xcrun simctl list devicetypes" บนเครื่องที่เครื่องมือจำลองจะทำงาน
แท็ก:test_runner
- ค่าเริ่มต้น
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชันของ iOS ที่จะเรียกใช้บนเครื่องมือจำลองเมื่อทำงานหรือทดสอบ ระบบจะไม่สนใจกฎ ios_test หากกฎระบุอุปกรณ์เป้าหมายไว้ในกฎ
แท็ก:test_runner
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
รายการ - ระบุจำนวนครั้งที่จะทำการทดสอบแต่ละครั้ง หากการดำเนินการเหล่านั้นล้มเหลวไม่ว่าด้วยเหตุผลใดก็ตาม จะถือว่าการทดสอบทั้งหมดไม่ผ่าน โดยปกติแล้ว ค่าที่ระบุจะเป็นแค่จำนวนเต็ม ตัวอย่าง: --runs_per_test=3 จะทำการทดสอบทั้งหมด 3 ครั้ง ไวยากรณ์สำรอง: regex_filter@runs_per_test โดย running_per_test ย่อมาจากค่าจำนวนเต็ม ส่วน regex_filter หมายถึงรายการรูปแบบการรวมและยกเว้นรูปแบบนิพจน์ทั่วไป (โปรดดู --instrumentation_filter) ตัวอย่างเช่น --runs_per_test=//foo/.*,-//foo/bar/.*@3 จะทำการทดสอบทั้งหมดใน //foo/ ยกเว้นการทดสอบภายใต้ foo/bar 3 ครั้ง ตัวเลือกนี้ส่งได้หลายครั้ง อาร์กิวเมนต์ที่ส่งผ่านล่าสุดที่ตรงกันจะมีความสำคัญเหนือกว่า หากไม่มีผลลัพธ์ที่ตรงกัน ระบบจะทำการทดสอบเพียงครั้งเดียว
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--test_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุตัวแปรสภาพแวดล้อมเพิ่มเติมที่จะแทรกลงในสภาพแวดล้อมตัวดำเนินการทดสอบ คุณระบุตัวแปรได้โดยใช้ชื่อ ซึ่งในกรณีนี้ระบบจะอ่านค่าของตัวแปรจากสภาพแวดล้อมไคลเอ็นต์ Bazel หรือด้วยคู่ชื่อ=ค่า ตัวเลือกนี้ใช้ได้หลายครั้งเพื่อระบุตัวแปรหลายรายการ ใช้เฉพาะโดย "การทดสอบ bazel" เท่านั้น คำสั่ง
แท็ก:test_runner
- ค่าเริ่มต้น
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - ลบล้างค่าระยะหมดเวลาในการทดสอบเริ่มต้นสำหรับระยะหมดเวลาทดสอบ (เป็นวินาที) หากระบุค่าจำนวนเต็มบวกค่าเดียว ค่าดังกล่าวจะแทนที่หมวดหมู่ทั้งหมด หากระบุจำนวนเต็มที่คั่นด้วยคอมมา 4 ตัวเลข ค่าดังกล่าวจะลบล้างระยะหมดเวลาสำหรับแบบสั้น ปานกลาง ยาว และนิรันดร์ (ตามลำดับนั้น) ไม่ว่าจะเป็นรูปแบบใด ค่า -1 จะบอกให้ Blaze ใช้ระยะหมดเวลาเริ่มต้นสำหรับหมวดหมู่นั้น
- ค่าเริ่มต้น
--[no]zip_undeclared_test_outputs
: "true" -
หากเป็น "จริง" ระบบจะเก็บเอาต์พุตทดสอบที่ไม่ได้ประกาศไว้ในไฟล์ ZIP
แท็ก:test_runner
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพเวลาของบิลด์
- ค่าเริ่มต้น
--[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_retain_test_configuration_across_testonly
: "เท็จ" -
เมื่อเปิดใช้ --trim_test_configuration จะไม่ตัดการกำหนดค่าการทดสอบสำหรับกฎที่ทำเครื่องหมายว่า testonly=1 ทั้งนี้เพื่อลดปัญหาความขัดแย้งในการดำเนินการเมื่อกฎที่ไม่ใช่การทดสอบต้องพึ่งพากฎ cc_test จะไม่มีผลหาก --trim_test_configuration เป็นเท็จ
แท็ก:loading_and_analysis
loses_incremental_state
- ค่าเริ่มต้น
--[no]experimental_starlark_cc_import
: "เท็จ" -
หากเปิดใช้ เวอร์ชัน Starlark ของ cc_import จะสามารถใช้ได้
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--[no]experimental_unsupported_and_brittle_include_scanning
: "เท็จ" -
เลือกว่าจะจำกัดอินพุตเฉพาะการคอมไพล์ C/C++ หรือไม่โดยการแยกวิเคราะห์ #include บรรทัดจากไฟล์อินพุต ซึ่งจะช่วยปรับปรุงประสิทธิภาพและส่วนเพิ่มด้วยการลดขนาดของแผนผังอินพุตสำหรับการคอมไพล์ อย่างไรก็ตาม ก็อาจทำให้บิลด์เสียหายได้เช่นกัน เนื่องจากเครื่องมือสแกนดังกล่าวไม่สามารถใช้งานความหมายของโปรเซสเซอร์ล่วงหน้าแบบ C ได้อย่างสมบูรณ์ โดยเฉพาะอย่างยิ่ง ระบบจะไม่เข้าใจคำสั่ง #include แบบไดนามิก และไม่สนใจตรรกะตามเงื่อนไขของตัวประมวลผลล่วงหน้า คุณต้องรับความเสี่ยงของการใช้งานเอง เราจะปิดปัญหาที่เกี่ยวข้องกับการแจ้งว่าไม่เหมาะสมนี้
แท็ก:loading_and_analysis
,execution
,changes_inputs
- ค่าเริ่มต้น
--[no]incremental_dexing
: "true" -
ส่วนใหญ่จะทำงานสำหรับ Dexing แยกต่างหากสำหรับไฟล์ Jar แต่ละไฟล์
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--[no]objc_use_dotd_pruning
: "true" -
หากตั้งค่าไว้ จะมีการใช้ไฟล์ .d ที่มาจาก clang เพื่อตัดชุดอินพุตที่ส่งผ่านเข้าไปในคอมไพล์ objc
แท็ก:changes_inputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]process_headers_in_dependencies
: "เท็จ" -
เมื่อสร้าง //a:a เป้าหมาย ให้ประมวลผลส่วนหัวในเป้าหมายทั้งหมดที่ //a:a ต้องใช้ (หากเปิดใช้การประมวลผลส่วนหัวสำหรับ Toolchain)
แท็ก:execution
- ค่าเริ่มต้น
--[no]trim_test_configuration
: "true" -
เมื่อเปิดใช้ ระบบจะล้างตัวเลือกที่เกี่ยวข้องกับการทดสอบซึ่งอยู่ใต้ระดับบนสุดของบิลด์ เมื่อแฟล็กนี้ทำงานอยู่ ระบบจะสร้างการทดสอบเป็นทรัพยากร Dependency ของกฎที่ไม่ใช่การทดสอบไม่ได้ แต่การเปลี่ยนแปลงตัวเลือกที่เกี่ยวข้องกับการทดสอบจะไม่ทำให้มีการวิเคราะห์กฎที่ไม่ใช่การทดสอบอีกครั้ง
แท็ก:loading_and_analysis
loses_incremental_state
- การพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
- ค่าเริ่มต้น
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
พิมพ์ข้อมูลการแก้ไขข้อบกพร่องระหว่างการแปลง Toolchain แฟล็กจะใช้นิพจน์ทั่วไปซึ่งตรวจสอบกับประเภท Toolchain และเป้าหมายที่เฉพาะเจาะจงเพื่อดูว่าควรแก้ไขข้อบกพร่องใด นิพจน์ทั่วไปหลายรายการจะคั่นด้วยคอมมา แล้วระบบจะเลือกนิพจน์ทั่วไปแต่ละรายการแยกกัน หมายเหตุ: เอาต์พุตของ Flag นี้มีความซับซ้อนมากและน่าจะเป็นประโยชน์ต่อผู้เชี่ยวชาญด้านการแก้ไข Toolchain เท่านั้น
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--flag_alias=<a 'name=value' flag alias>
รายการ -
ตั้งชื่อย่อสำหรับธง Starlark โดยใช้คู่คีย์-ค่าคู่เดียวในรูปแบบ "<key>=<value>" เป็นอาร์กิวเมนต์
แท็ก:changes_inputs
- ค่าเริ่มต้น
--[no]incompatible_default_to_explicit_init_py
: "เท็จ" -
แฟล็กนี้เปลี่ยนลักษณะการทำงานเริ่มต้นเพื่อไม่ให้สร้างไฟล์ __init__.py โดยอัตโนมัติในไฟล์การเรียกใช้ของเป้าหมาย Python อีกต่อไป แม่นยำเมื่อเป้าหมาย py_binary หรือ py_test ตั้งค่า legacy_create_init เป็น "auto" (ค่าเริ่มต้น) ระบบจะถือว่าเป็น "เท็จ" เมื่อมีการตั้งค่าแฟล็กนี้เท่านั้น ดู https://github.com/bazelbuild/bazel/issues/10076
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_py2_outputs_are_suffixed
: "true" -
หากเป็นจริง เป้าหมายที่สร้างในการกำหนดค่า Python 2 จะปรากฏภายใต้รูทเอาต์พุตที่มีคำต่อท้าย "-py2" ขณะที่เป้าหมายที่สร้างขึ้นสำหรับ Python 3 จะปรากฏในรูทที่ไม่มีส่วนต่อท้ายที่เกี่ยวข้องกับ Python ซึ่งหมายความว่าลิงก์สัญลักษณ์ความสะดวก "bazel-bin" จะชี้ไปยังเป้าหมาย Python 3 แทนที่จะเป็น Python 2 หากคุณเปิดใช้ตัวเลือกนี้ ขอแนะนำให้เปิดใช้ "--incompatible_py3_is_default" ด้วย
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_py3_is_default
: "true" -
หากเป็นจริง เป้าหมาย "py_binary" และ "py_test" ที่ไม่ได้ตั้งค่าแอตทริบิวต์ "python_version" (หรือ "default_python_version") จะมีค่าเริ่มต้นเป็น PY3 แทนที่จะเป็น PY2 หากตั้งค่าแฟล็กนี้ ขอแนะนำให้ตั้งค่า "--incompatible_py2_outputs_are_suffixed"
แท็ก:loading_and_analysis
,affects_outputs
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_use_python_toolchains
: "true" -
หากตั้งค่าเป็น "จริง" กฎ Python ในเครื่องที่เป็นไฟล์ปฏิบัติการจะใช้รันไทม์ของ Python ที่ระบุโดย Toolchain ของ Python แทนรันไทม์ที่มาจากแฟล็กเดิม เช่น --python_top
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--python_version=<PY2 or PY3>
: ดูคำอธิบาย -
โหมดเวอร์ชันหลักของ Python ไม่ว่าจะเป็น "PY2" หรือ "PY3" โปรดทราบว่าเป้าหมาย "py_binary" และ "py_test" จะลบล้างค่านี้ (แม้ว่าจะไม่ได้ระบุเวอร์ชันอย่างชัดเจน) จึงมักไม่มีเหตุผลที่จะต้องระบุแฟล็กนี้
แท็ก:loading_and_analysis
affects_outputs
- ที่ไม่ถูกจัดหมวดหมู่:
--[no]cache_test_results
[-t
] ค่าเริ่มต้น: "อัตโนมัติ"- หากตั้งค่าเป็น "อัตโนมัติ" Bazel จะทำการทดสอบอีกครั้งเฉพาะในกรณีต่อไปนี้ (1) Bazel ตรวจพบการเปลี่ยนแปลงในการทดสอบหรือทรัพยากร Dependency (2) การทดสอบได้รับการทำเครื่องหมายว่าเป็นภายนอก (3) มีการขอทำการทดสอบหลายครั้งด้วย --runs_per_test หรือ(4) การทดสอบล้มเหลวก่อนหน้านี้ หากตั้งค่าเป็น "ใช่" Bazel จะแคชผลการทดสอบทั้งหมด ยกเว้นการทดสอบที่ทำเครื่องหมายว่าภายนอก หากตั้งค่าเป็น "ไม่" Bazel จะไม่แคชผลการทดสอบใดๆ
- ค่าเริ่มต้น
--[no]experimental_cancel_concurrent_tests
: "เท็จ" -
หากเป็น "จริง" Blaze จะยกเลิกการทดสอบพร้อมกันในการรันที่สำเร็จครั้งแรก วิธีนี้จะมีประโยชน์เมื่อใช้ร่วมกับ --runs_per_test_detects_flakes เท่านั้น
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_fetch_all_coverage_outputs
: "เท็จ" -
หากเป็น "จริง" Bazel จะดึงข้อมูลไดเรกทอรีข้อมูลการครอบคลุมทั้งหมดสำหรับการทดสอบแต่ละครั้งระหว่างการทำงานของการครอบคลุม
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_generate_llvm_lcov
: "เท็จ" -
หากเป็น "จริง" ความครอบคลุมของคําพูดจะสร้างรายงาน LCOV
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_j2objc_header_map
: "true" - เลือกว่าจะสร้างแผนที่ส่วนหัว J2ObjC ควบคู่ไปกับการแปลง J2ObjC หรือไม่
- ค่าเริ่มต้น
--[no]experimental_j2objc_shorter_header_path
: "เท็จ" -
เลือกว่าจะสร้างโดยใช้เส้นทางส่วนหัวที่สั้นกว่าหรือไม่ (ใช้ "_ios" แทน "_j2objc")
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_java_classpath=<off, javabuilder or bazel>
: "javabuilder" - เปิดใช้งานคลาสพาธที่ลดลงสำหรับการคอมไพล์ Java
- ค่าเริ่มต้น
--[no]experimental_limit_android_lint_to_android_constrained_java
: "เท็จ" -
ไม่มีการดำเนินการ เก็บไว้สำหรับความเข้ากันได้แบบย้อนหลังเท่านั้น
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_run_android_lint_on_java_rules
: "เท็จ" -
ระบุว่าจะตรวจสอบแหล่งที่มา java_* หรือไม่
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]explicit_java_test_deps
: "เท็จ" - ระบุทรัพยากร Dependency ของ JUnit หรือ Hamcrest อย่างชัดเจนใน java_test แทนที่จะได้มาจาก Dep ของ TestRunner โดยไม่ตั้งใจ ตอนนี้ใช้ได้กับ bazel เท่านั้น
- ค่าเริ่มต้น
--host_java_launcher=<a build target label>
: ดูคำอธิบาย - Java Launcher ที่เครื่องมือใช้ซึ่งดำเนินการในระหว่างบิลด์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_javacopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมในการส่งไปยัง Javac เมื่อสร้างเครื่องมือที่ดำเนินการระหว่างบิลด์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_jvmopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง Java VM เมื่อสร้างเครื่องมือสร้างที่ดำเนินการระหว่างบิลด์ ระบบจะเพิ่มตัวเลือกเหล่านี้ไปยังตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
- ค่าเริ่มต้น
--[no]incompatible_check_sharding_support
: "true" -
หากเป็น "จริง" Bazel จะไม่ผ่านการทดสอบชาร์ด หากตัวดำเนินการทดสอบไม่ได้ระบุว่ารองรับการชาร์ดดิ้งโดยการแตะไฟล์ที่เส้นทางใน TEST_SHARD_STATUS_FILE หากเป็นเท็จ ตัวดำเนินการทดสอบที่ไม่รองรับการชาร์ดจะนำไปยังการทดสอบทั้งหมดที่ทำงานในชาร์ดแต่ละรายการ
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_exclusive_test_sandboxed
: "true" -
หากจริง การทดสอบพิเศษจะทำงานโดยใช้กลยุทธ์แซนด์บ็อกซ์ เพิ่ม "ท้องถิ่น" เพื่อบังคับให้การทดสอบพิเศษทำงานภายในเครื่อง
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_strict_action_env
: "เท็จ" -
หากเป็นจริง Bazel จะใช้สภาพแวดล้อมที่มีค่าคงที่สำหรับ PATH และไม่รับค่า LD_LIBRARY_PATH ใช้ --action_env=ENV_VARIABLE หากคุณต้องการรับตัวแปรสภาพแวดล้อมที่เฉพาะเจาะจงจากไคลเอ็นต์ แต่โปรดทราบว่าการทำเช่นนี้อาจป้องกันการแคชข้ามผู้ใช้ได้หากมีการใช้แคชที่แชร์
แท็ก:loading_and_analysis
incompatible_change
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--j2objc_translation_flags=<comma-separated list of options>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยังเครื่องมือ J2ObjC
--java_debug
-
ทำให้เครื่องเสมือนของ Java ของการทดสอบ Java ต้องรอการเชื่อมต่อจากโปรแกรมแก้ไขข้อบกพร่องที่สอดคล้องกับ JDWP (เช่น jdb) ก่อนเริ่มการทดสอบ โดยนัย -test_output=streamed
ขยายเป็น
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- ค่าเริ่มต้น
--[no]java_deps
: "true" - สร้างข้อมูลทรัพยากร Dependency (ในขณะนี้คือคลาสพาธเวลาคอมไพล์) ต่อเป้าหมาย Java
- ค่าเริ่มต้น
--[no]java_header_compilation
: "true" - คอมไพล์จากต้นทางโดยตรง
- ค่าเริ่มต้นของ
--java_language_version=<a string>
: "" - เวอร์ชันภาษา Java
- ค่าเริ่มต้น
--java_launcher=<a build target label>
: ดูคำอธิบาย - Java Launcher ที่จะใช้เมื่อสร้างไบนารีของ Java หากตั้งค่าสถานะนี้เป็นสตริงว่างเปล่า ระบบจะใช้ Launcher ของ JDK "Launcher" จะลบล้างแฟล็กนี้
--java_runtime_version=<a string>
ค่าเริ่มต้น: "local_jdk"- เวอร์ชันรันไทม์ของ Java
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--javacopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง Javac
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--jvmopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง Java VM ระบบจะเพิ่มตัวเลือกเหล่านี้ไปยังตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
- ค่าเริ่มต้น
--legacy_main_dex_list_generator=<a build target label>
: ดูคำอธิบาย - ระบุไบนารีที่จะใช้สร้างรายการคลาสที่ต้องอยู่ใน Dex หลักเมื่อคอมไพล์ Multidex เดิม
- ค่าเริ่มต้น
--optimizing_dexer=<a build target label>
: ดูคำอธิบาย - ระบุไบนารีที่จะใช้ทำ Dexing โดยไม่ต้องชาร์ดดิ้ง
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--plugin=<a build target label>
รายการ - ปลั๊กอินที่ใช้ในบิลด์ ปัจจุบันใช้งานได้กับ java_plugin
- ค่าเริ่มต้น
--proguard_top=<a build target label>
: ดูคำอธิบาย - ระบุเวอร์ชัน ProGuard ที่จะใช้สำหรับการนำโค้ดออกเมื่อสร้างไบนารีของ Java
--proto_compiler=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/protocol:protocol"-
ป้ายกำกับของคอมไพเลอร์ Proto
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]proto_profile
: "true" -
ระบุว่าจะส่ง profile_path ไปยังคอมไพเลอร์ Pro หรือไม่
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--proto_profile_path=<a build target label>
: ดูคำอธิบาย -
โปรไฟล์ที่จะส่งไปยังคอมไพเลอร์ Pro เป็น profile_path หากไม่ได้ตั้งค่า แต่ --Proto_profile เป็นจริง (ค่าเริ่มต้น) จะอนุมานเส้นทางจาก --fdo_optimize
แท็ก: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:/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, อื่นๆ ทั้งหมด: /bin/bash) โปรดทราบว่าการใช้ Shell ที่เข้ากันไม่ได้กับ Bash อาจทำให้บิลด์ล้มเหลวหรือรันไทม์ของไบนารีที่สร้างขึ้นไม่สำเร็จ
แท็ก:loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--test_arg=<a string>
รายการ - ระบุตัวเลือกและอาร์กิวเมนต์เพิ่มเติมที่ควรส่งไปยังไฟล์ปฏิบัติการทดสอบ ซึ่งสามารถใช้หลายครั้งเพื่อระบุอาร์กิวเมนต์ได้หลายรายการ หากดำเนินการทดสอบหลายรายการ แต่ละรายการจะได้รับอาร์กิวเมนต์ที่เหมือนกัน ใช้เฉพาะโดย "การทดสอบ bazel" เท่านั้น คำสั่ง
- ค่าเริ่มต้น
--test_filter=<a string>
: ดูคำอธิบาย - ระบุตัวกรองที่จะส่งต่อไปยังเฟรมเวิร์กการทดสอบ ใช้เพื่อจำกัดการทดสอบ โปรดทราบว่าการเปลี่ยนแปลงนี้ไม่มีผลต่อเป้าหมายที่สร้างขึ้น
- ค่าเริ่มต้น
--test_result_expiration=<an integer>
: "-1" - ตัวเลือกนี้เลิกใช้งานแล้วและไม่ส่งผลใดๆ
- ค่าเริ่มต้น
--[no]test_runner_fail_fast
: "เท็จ" - การส่งต่อล้มเหลวตัวเลือกอย่างรวดเร็วไปยังตัวดำเนินการทดสอบ ตัวดำเนินการทดสอบควรหยุดการดำเนินการเมื่อล้มเหลวครั้งแรก
- ค่าเริ่มต้น
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
: "อาจไม่เหมาะสม" - ระบุกลยุทธ์สำหรับการทดสอบชาร์ดดิ้ง: "Explicit" จะใช้ชาร์ดดิ้งก็ต่อเมื่อ "shard_count" เท่านั้น มีแอตทริบิวต์ BUILD "ปิดใช้" ว่าจะไม่ใช้ทดสอบชาร์ดดิ้ง "forced=k" เพื่อบังคับใช้ "k" ชาร์ดสำหรับการทดสอบโดยไม่คำนึงถึง "shard_count" BUILD
- ค่าเริ่มต้นของ
--tool_java_language_version=<a string>
: "" - เวอร์ชันภาษา Java ที่ใช้เพื่อเรียกใช้เครื่องมือที่จำเป็นระหว่างการสร้าง
- ค่าเริ่มต้นของ
--tool_java_runtime_version=<a string>
: "remotejdk_11" - เวอร์ชันรันไทม์ของ Java ที่ใช้เพื่อเรียกใช้เครื่องมือในระหว่างบิลด์
- ค่าเริ่มต้น
--[no]use_ijars
: "true" - หากเปิดใช้ ตัวเลือกนี้จะทำให้การคอมไพล์ Java ใช้ jars อินเทอร์เฟซ ซึ่งจะทำให้การคอมไพล์แบบเพิ่มขึ้นเรื่อยๆ ได้เร็วขึ้น แต่ข้อความแสดงข้อผิดพลาดอาจแตกต่างกันได้
ตัวเลือกสำหรับบิลด์
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์:
- ค่าเริ่มต้น
--[no]check_up_to_date
: "เท็จ" -
ห้ามดำเนินการสร้าง เพียงตรวจสอบว่าเป็นรุ่นล่าสุดหรือไม่ หากเป้าหมายทั้งหมดเป็นปัจจุบัน แสดงว่าบิลด์เสร็จสมบูรณ์ หากต้องดำเนินการในขั้นตอนใด ระบบจะรายงานข้อผิดพลาดและบิลด์ล้มเหลว
แท็ก:execution
- ค่าเริ่มต้น
--dynamic_local_execution_delay=<an integer>
: "1000" -
การดำเนินการในเครื่องควรล่าช้าไปกี่มิลลิวินาที หากการดำเนินการจากระยะไกลเร็วขึ้นระหว่างบิลด์อย่างน้อย 1 ครั้ง
แท็ก:execution
host_machine_resource_optimizations
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment>
รายการ -
กลยุทธ์ในท้องถิ่นซึ่งจะนำไปใช้สำหรับการช่วยจำที่ระบุ ระบบจะใช้กลยุทธ์แรกที่เกี่ยวข้อง เช่น "ผู้ปฏิบัติงาน, แซนด์บ็อกซ์" จะเรียกใช้การดำเนินการที่รองรับผู้ปฏิบัติงานถาวรโดยใช้กลยุทธ์ผู้ปฏิบัติงาน และเรียกใช้การดำเนินการอื่นๆ ทั้งหมดที่ใช้กลยุทธ์แซนด์บ็อกซ์ หากไม่ได้ระบุวิธีช่วยจำ ระบบจะใช้รายการกลยุทธ์เป็นรายการสำรองสำหรับการช่วยจำทั้งหมด รายการสำรองเริ่มต้นคือ "worker,sandboxed" หรือ "worker,sandboxed,อัปเกรด" หากตั้งค่า "experimental_local_lockfree_output" ต้องใช้ [mnemonic=]local_strategy[,local_strategy,...]
แท็ก:execution
host_machine_resource_optimizations
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment>
รายการ -
กลยุทธ์ระยะไกลเพื่อที่จะนำไปใช้สำหรับการช่วยจำที่ระบุ ระบบจะใช้กลยุทธ์แรกที่เกี่ยวข้อง หากไม่ได้ระบุวิธีช่วยจำ ระบบจะใช้รายการกลยุทธ์เป็นรายการสำรองสำหรับการช่วยจำทั้งหมด รายการสำรองเริ่มต้นคือ "remote" ดังนั้นโดยปกติจึงไม่จำเป็นต้องตั้งค่าแฟล็กนี้อย่างชัดแจ้ง ต้องใช้ [mnemonic=]remote_strategy[,remote_strategy,...]
แท็ก:execution
host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--experimental_docker_image=<a string>
: "" -
ระบุชื่ออิมเมจ Docker (เช่น "ubuntu:latest") ที่ควรจะใช้เพื่อดำเนินการแซนด์บ็อกซ์เมื่อใช้กลยุทธ์ Docker และตัวการดำเนินการยังไม่มีแอตทริบิวต์รูปภาพคอนเทนเนอร์ใน Remote_execution_properties ในคำอธิบายแพลตฟอร์ม ค่าของแฟล็กนี้ส่งผ่านแบบคำต่อคำไปยัง "docker Run" ดังนั้นจึงรองรับไวยากรณ์และกลไกเดียวกันกับ Docker
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_docker_use_customized_images
: "true" -
หากเปิดใช้ ระบบจะแทรก uid และ gid ของผู้ใช้ปัจจุบันลงในอิมเมจ Docker ก่อนใช้งาน ซึ่งจำเป็นหากบิลด์ / การทดสอบของคุณขึ้นอยู่กับผู้ใช้ที่มีชื่อและไดเรกทอรีหน้าแรกในคอนเทนเนอร์ ตัวเลือกนี้เปิดใช้งานโดยค่าเริ่มต้น แต่คุณสามารถปิดใช้งานได้ในกรณีที่ฟีเจอร์การปรับแต่งรูปภาพอัตโนมัติไม่ทำงานในกรณีของคุณ หรือคุณทราบว่าไม่จำเป็นต้องใช้
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_dynamic_exclude_tools
: "true" -
เมื่อตั้งค่าแล้ว เป้าหมายที่เป็น "สำหรับเครื่องมือ" ไม่ต้องใช้การเรียกใช้แบบไดนามิก เป้าหมายดังกล่าวไม่มีแนวโน้มที่จะสร้างทีละส่วน จึงไม่คุ้มกับการใช้จ่ายในพื้นที่
แท็ก:execution
host_machine_resource_optimizations
- ค่าเริ่มต้น
--experimental_dynamic_local_load_factor=<a double>
: "0" -
ควบคุมปริมาณภาระงานจากการดำเนินการแบบไดนามิกที่จะนำขึ้นเครื่องภายใน แฟล็กนี้จะปรับจำนวนการดำเนินการในการดำเนินการแบบไดนามิกที่เราจะกำหนดเวลาพร้อมกัน ขึ้นอยู่กับจำนวน CPU ที่ Blaze คิดว่าพร้อมใช้งาน ซึ่งควบคุมได้ด้วยแฟล็ก --local_cpu_resources
หากแฟล็กนี้เป็น 0 ระบบจะกำหนดเวลาการดำเนินการทั้งหมดในเครื่องทันที หาก > 0 จำนวนการดำเนินการที่กำหนดเวลาไว้ภายในเครื่องจะจำกัดตามจำนวน CPU ที่ใช้ได้ ถ้า < 1 ปัจจัยในการโหลดจะใช้เพื่อลดจำนวนการดำเนินการที่กำหนดเวลาไว้ภายในเครื่องเมื่อมีจำนวนการดำเนินการที่รอกำหนดเวลาอยู่ในระดับสูง ซึ่งจะช่วยลดโหลดของเครื่องภายในในเคสบิลด์ที่สะอาด ซึ่งเครื่องในเครือข่ายอาจไม่ให้ผลมากนัก
แท็ก:execution
host_machine_resource_optimizations
- ค่าเริ่มต้น
--experimental_dynamic_slow_remote_time=<An immutable length of time.>
: "0" -
หากมากกว่า 0 เวลาที่การดำเนินการแบบไดนามิกจะต้องเรียกใช้จากระยะไกลเท่านั้นก่อนที่เราจะจัดลำดับความสำคัญของการดำเนินการในเครื่องเพื่อหลีกเลี่ยงการหมดเวลาจากระยะไกล วิธีนี้อาจซ่อนปัญหาบางอย่างในระบบการดำเนินการระยะไกล อย่าเปิดฟีเจอร์นี้โดยไม่ตรวจสอบปัญหาด้านการดำเนินการจากระยะไกล
แท็ก:execution
host_machine_resource_optimizations
- ค่าเริ่มต้น
--[no]experimental_enable_docker_sandbox
: "เท็จ" -
เปิดใช้แซนด์บ็อกซ์ที่อิงตาม Docker ตัวเลือกนี้จะไม่มีผลหากไม่ได้ติดตั้ง Docker
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_inmemory_sandbox_stashes
: "เท็จ" -
หากตั้งค่าเป็น "จริง" ระบบจะติดตามเนื้อหาของแซนด์บ็อกซ์ที่ซ่อนไว้สำหรับ "rein_sandbox_directory" ไว้ในหน่วยความจำ ซึ่งจะช่วยลดปริมาณ I/O ที่ต้องใช้ในระหว่างการนำมาใช้ใหม่ แฟล็กนี้อาจช่วยปรับปรุงเวลาจริงโดยขึ้นอยู่กับบิลด์ แฟล็กนี้อาจใช้หน่วยความจำเพิ่มเติมจำนวนมาก ทั้งนี้ขึ้นอยู่กับบิลด์ด้วย
แท็ก:host_machine_resource_optimizations
execution
- ค่าเริ่มต้น
--experimental_sandbox_async_tree_delete_idle_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "4" -
หากค่าเป็น 0 ให้ลบแผนผังแซนด์บ็อกซ์ทันทีที่การทำงานเสร็จสิ้น (ทำให้การดำเนินการเสร็จสิ้นล่าช้า) หากมากกว่า 0 ให้ดำเนินการลบ 3 รายการดังกล่าวใน Thread Pool แบบไม่พร้อมกันที่มีขนาด 1 เมื่อบิลด์ทำงานอยู่และเติบโตเป็นขนาดที่ระบุโดย Flag นี้เมื่อเซิร์ฟเวอร์ไม่มีการใช้งาน
แท็ก:host_machine_resource_optimizations
execution
- ค่าเริ่มต้นของ
--experimental_sandbox_enforce_resources_regexp=<a valid Java regular expression>
: "" -
หากเป็นจริง การดำเนินการที่มี Mnemonic ตรงกับนิพจน์ทั่วไปของอินพุตจะมีการบังคับใช้คำขอทรัพยากรเป็นขีดจำกัด โดยลบล้างค่าของ --experimental_sandbox_limits หากประเภททรัพยากรรองรับ ตัวอย่างเช่น การทดสอบที่ประกาศว่า cpu:3 และทรัพยากร:memory:10 จะทำงานโดยใช้ CPU ไม่เกิน 3 ตัว และหน่วยความจำ 10 เมกะไบต์
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_sandbox_limits=<a named double, 'name=value', where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
รายการ -
หาก > 0 แซนด์บ็อกซ์ของ Linux แต่ละแซนด์บ็อกซ์จะถูกจำกัดตามปริมาณที่ระบุสำหรับทรัพยากรที่ระบุ ต้องใช้ --incompatible_use_new_cgroup_implementation และการลบล้าง --experimental_sandbox_memory_limit_mb ต้องใช้ cgroups v1 หรือ v2 และสิทธิ์สำหรับผู้ใช้ในการเข้าถึงไดเรกทอรี cgroups
แท็ก:execution
- ค่าเริ่มต้น
--experimental_sandbox_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "0" -
หาก > 0 แซนด์บ็อกซ์ของ Linux แต่ละแซนด์บ็อกซ์จะถูกจำกัดปริมาณหน่วยความจำที่ระบุ (เป็น MB) ต้องใช้ cgroups v1 หรือ v2 และสิทธิ์สำหรับผู้ใช้ในการเข้าถึงไดเรกทอรี cgroups
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_shrink_worker_pool
: "เท็จ" -
หากเปิดใช้ อาจย่อพูลผู้ปฏิบัติงานหากหน่วยความจำของผู้ปฏิบัติงานสูง การตั้งค่าสถานะนี้จะทำงานเมื่อเปิดใช้งานการตั้งค่าสถานะ Experiment_total_worker_memory_limit_mb เท่านั้น
แท็ก:execution
host_machine_resource_optimizations
- ค่าเริ่มต้น
--[no]experimental_split_xml_generation
: "true" -
หากมีการกำหนดแฟล็กนี้ และการดำเนินการทดสอบไม่สร้างไฟล์ test.xml ขึ้นมา Bazel จะใช้การดำเนินการแยกต่างหากเพื่อสร้างไฟล์ test.xml จำลองที่มีบันทึกการทดสอบ มิฉะนั้น Bazel จะสร้าง test.xml เป็นส่วนหนึ่งของการดำเนินการทดสอบ
แท็ก:execution
- ค่าเริ่มต้น
--experimental_total_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "0" -
หากขีดจำกัดนี้มากกว่า 0 ผู้ปฏิบัติงานที่ไม่มีการใช้งานอาจหยุดทำงานหากการใช้งานหน่วยความจำรวมของผู้ปฏิบัติงานทั้งหมดเกินขีดจำกัด
แท็ก:execution
host_machine_resource_optimizations
- ค่าเริ่มต้น
--[no]experimental_use_hermetic_linux_sandbox
: "เท็จ" -
หากตั้งค่าเป็น "จริง" ไม่ต้องต่อเชื่อมรูท ให้ต่อเชื่อมเฉพาะสิ่งที่มาพร้อมกับ sandbox_add_mount_pair ไฟล์ที่ป้อนจะฮาร์ดลิงก์ไปยังแซนด์บ็อกซ์แทนที่จะลิงก์มาจากแซนด์บ็อกซ์ หากไฟล์อินพุตการดำเนินการอยู่ในระบบไฟล์ที่แตกต่างจากแซนด์บ็อกซ์ ระบบจะคัดลอกไฟล์อินพุตแทน
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_use_semaphore_for_jobs
: "true" -
หากตั้งค่าเป็น "จริง" ให้ใช้ Semaphore เพิ่มเติมเพื่อจำกัดจำนวนงานที่เกิดขึ้นพร้อมกัน
แท็ก:host_machine_resource_optimizations
execution
- ค่าเริ่มต้น
--[no]experimental_use_windows_sandbox
: "เท็จ" -
ใช้แซนด์บ็อกซ์ของ Windows เพื่อเรียกใช้การดำเนินการ หากเป็น "ใช่" ไบนารีที่ระบุโดย --experimental_windows_sandbox_path ต้องเป็นไฟล์ที่ถูกต้องและสอดคล้องกับ sandboxfs เวอร์ชันที่รองรับ หากเป็น "auto" ไบนารีอาจหายไปหรือเข้ากันไม่ได้
แท็ก:execution
- ค่าเริ่มต้นของ
--experimental_windows_sandbox_path=<a string>
: "BazelSandbox.exe" -
เส้นทางไปยังไบนารีแซนด์บ็อกซ์ของ Windows เพื่อใช้เมื่อ --experimental_use_windows_sandbox เป็นจริง หากเป็นชื่อเปล่า ให้ใช้ไบนารีแรกของชื่อที่พบใน PATH
แท็ก:execution
- ค่าเริ่มต้น
--experimental_worker_allowlist=<comma-separated set of options>
: ดูคำอธิบาย -
หากไม่ว่างเปล่า อนุญาตให้ใช้เฉพาะผู้ปฏิบัติงานถาวรที่มีความสามารถในการจำของคีย์ผู้ปฏิบัติงานที่ระบุ
แท็ก:execution
host_machine_resource_optimizations
- ค่าเริ่มต้น
--[no]experimental_worker_cancellation
: "เท็จ" -
หากเปิดใช้ Bazel อาจส่งคำขอยกเลิกไปยังผู้ปฏิบัติงานที่ให้การสนับสนุน
แท็ก:execution
- ค่าเริ่มต้น
--experimental_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "0" -
หากขีดจำกัดนี้มากกว่า 0 ผู้ปฏิบัติงานอาจหยุดทำงานหากการใช้งานหน่วยความจำของผู้ปฏิบัติงานเกินขีดจำกัด หากไม่ใช้ร่วมกับการดำเนินการแบบไดนามิกและ "--experimental_dynamic_ignore_local_signals=9" อาจทำให้บิลด์ของคุณขัดข้อง
แท็ก:execution
host_machine_resource_optimizations
- ค่าเริ่มต้น
--experimental_worker_metrics_poll_interval=<An immutable length of time.>
: "5s" -
ช่วงเวลาระหว่างการรวบรวมเมตริกผู้ปฏิบัติงานและอาจต้องพยายามปลดออก ประสิทธิภาพต้องไม่น้อยกว่า 1 วินาทีเนื่องจากเหตุผลด้านประสิทธิภาพ
แท็ก:execution
host_machine_resource_optimizations
- ค่าเริ่มต้น
--[no]experimental_worker_multiplex_sandboxing
: "เท็จ" -
หากเปิดใช้ ผู้ปฏิบัติงาน Multiplex ที่มี "supports- Multiplex-sandboxing" ข้อกำหนดการดำเนินการจะเรียกใช้ในสภาพแวดล้อมแบบแซนด์บ็อกซ์ โดยใช้ไดเรกทอรีแซนด์บ็อกซ์แยกต่างหากตามคำของาน ผู้ปฏิบัติงาน Multiplex ที่มีข้อกำหนดด้านการดำเนินการจะมีการแซนด์บ็อกซ์เสมอเมื่อทำงานภายใต้กลยุทธ์การดำเนินการแบบไดนามิก โดยไม่คำนึงถึงแฟล็กนี้
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_worker_sandbox_hardening
: "เท็จ" -
หากเปิดใช้ ผู้ปฏิบัติงานจะทำงานในแซนด์บ็อกซ์ที่แข็งแกร่ง หากการใช้งานอนุญาตให้ทำได้ หากเปิดใช้การปิดช่องโหว่แล้ว ไดเรกทอรี tmp จะแตกต่างออกไปสำหรับผู้ปฏิบัติงานแต่ละคน
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_worker_sandbox_inmemory_tracking=<a string>
รายการ -
ช่วยจำคีย์ผู้ปฏิบัติงานที่มีการติดตามเนื้อหาของไดเรกทอรีแซนด์บ็อกซ์ในหน่วยความจำ ซึ่งอาจช่วยปรับปรุงประสิทธิภาพของบิลด์ซึ่งใช้หน่วยความจำเพิ่มเติมได้ มีผลกับผู้ปฏิบัติงานที่ใช้แซนด์บ็อกซ์เท่านั้น สามารถระบุได้หลายครั้งสำหรับการช่วยจำที่ต่างกัน
แท็ก: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
- ค่าเริ่มต้น
--[no]incompatible_remote_dangling_symlinks
: "true" -
หากตั้งค่าเป็น "จริง" ลิงก์สัญลักษณ์ที่อัปโหลดไปยังแคชระยะไกลหรือดิสก์แคชจะได้รับอนุญาตให้ห้อยคอได้
แท็ก:execution
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_remote_symlinks
: "true" -
หากตั้งค่าเป็น "จริง" Bazel จะอัปโหลดลิงก์สัญลักษณ์ไปยังรีโมตหรือดิสก์แคชเสมอ มิฉะนั้นระบบจะอัปโหลดลิงก์สัญลักษณ์ที่เกี่ยวข้องที่ไม่ก่อให้เกิดอันตรายเป็นไฟล์หรือไดเรกทอรีที่ลิงก์ไป
แท็ก:execution
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_sandbox_hermetic_tmp
: "true" -
หากตั้งค่าเป็น "จริง" แซนด์บ็อกซ์ของ Linux แต่ละรายการจะมีไดเรกทอรีว่างเฉพาะของตัวเองต่อเชื่อมเป็น /tmp แทนที่จะแชร์ /tmp กับระบบไฟล์ของโฮสต์ ใช้ --sandbox_add_mount_pair=/tmp เพื่อดู /tmp ของโฮสต์ต่อไปในแซนด์บ็อกซ์ทั้งหมด
แท็ก:execution
- ค่าเริ่มต้น
--[no]incompatible_use_new_cgroup_implementation
: "เท็จ" -
หากเป็น "จริง" ให้ใช้การใช้งานใหม่สำหรับ cgroups การใช้งานแบบเก่ารองรับเฉพาะตัวควบคุมหน่วยความจำและไม่สนใจค่า --experimental_sandbox_limits
แท็ก:execution
- ค่าเริ่มต้น
--[no]internal_spawn_scheduler
: "true" -
ตัวเลือกตัวยึดตำแหน่งเพื่อให้เราสามารถบอกใน Blaze ว่าเครื่องจัดตารางเวลาสร้างได้เปิดใช้อยู่หรือไม่
แท็ก:execution
host_machine_resource_optimizations
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] ค่าเริ่มต้น: "อัตโนมัติ"-
จำนวนงานที่เกิดขึ้นพร้อมกันที่จะเรียกใช้ ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") โดยจะเลือกตามด้วยการดำเนินการ ([-|*]<Float>) เช่น "auto", "HOST_CPUS*.5" ค่าต้องอยู่ระหว่าง 1 ถึง 5000 ค่าที่สูงกว่า 2,500 อาจก่อให้เกิดปัญหาเกี่ยวกับหน่วยความจำ "อัตโนมัติ" จะคำนวณค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์
แท็ก:host_machine_resource_optimizations
execution
--[no]keep_going
[-k
] ค่าเริ่มต้น: "เท็จ"-
ดำเนินการต่อให้มากที่สุดหลังจากเกิดข้อผิดพลาด แม้ว่าเป้าหมายที่ล้มเหลวและเป้าหมายที่อ้างอิงอยู่จะไม่สามารถวิเคราะห์ได้ แต่ข้อกําหนดเบื้องต้นอื่นๆ ของเป้าหมายเหล่านี้อาจเป็นไปได้
แท็ก:eagerness_to_exit
- ค่าเริ่มต้น
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "อัตโนมัติ" -
จำนวนชุดข้อความแบบขนานที่จะใช้สำหรับขั้นตอนการโหลด/การวิเคราะห์ ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") หรือเลือกตามด้วยการดำเนินการ ([-|*]<Float>) เช่น "auto", "HOST_CPUS*.5" "อัตโนมัติ" ตั้งค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]reuse_sandbox_directories
: "true" -
หากตั้งค่าเป็น "จริง" ระบบอาจนำไดเรกทอรีที่ใช้โดยการดำเนินการที่ไม่ใช่ผู้ปฏิบัติงานโดยใช้แซนด์บ็อกซ์มาใช้ใหม่เพื่อหลีกเลี่ยงค่าใช้จ่ายที่ไม่จำเป็นในการตั้งค่า
แท็ก:host_machine_resource_optimizations
execution
- ค่าเริ่มต้นของ
--sandbox_base=<a string>
: "" -
อนุญาตให้แซนด์บ็อกซ์สร้างไดเรกทอรีแซนด์บ็อกซ์ของตนภายใต้เส้นทางนี้ ระบุเส้นทางบน tmpfs (เช่น /run/shm) เพื่ออาจปรับปรุงประสิทธิภาพได้อย่างมากเมื่อบิลด์ / การทดสอบของคุณมีไฟล์อินพุตจำนวนมาก หมายเหตุ: คุณต้องมี RAM และพื้นที่ว่างใน tmpfs เพียงพอที่จะเก็บเอาต์พุตและไฟล์กลางที่สร้างขึ้นโดยการเรียกใช้การดำเนินการ
แท็ก:host_machine_resource_optimizations
execution
- ค่าเริ่มต้น
--[no]sandbox_explicit_pseudoterminal
: "เท็จ" -
อนุญาตให้สร้าง Pseudoterminals สำหรับการดำเนินการแซนด์บ็อกซ์อย่างชัดเจน การใช้ Linux บางโปรแกรมต้องตั้งค่ารหัสกลุ่มของกระบวนการเป็น "tty" ภายในแซนด์บ็อกซ์เพื่อให้ Pseudoterminals ทำงาน หากการทำเครื่องหมายนี้ก่อให้เกิดปัญหา ให้ปิดการแจ้งปัญหานี้เพื่อให้ใช้งานกลุ่มอื่นๆ ได้
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--sandbox_tmpfs_path=<an absolute path>
รายการ -
สำหรับการดำเนินการที่ทำแซนด์บ็อกซ์ ให้ต่อเชื่อมไดเรกทอรีที่ว่างเปล่าซึ่งเขียนได้ไว้ที่เส้นทางสัมบูรณ์นี้ (หากการใช้แซนด์บ็อกซ์รองรับ และจะไม่พิจารณา มิฉะนั้น)
แท็ก:host_machine_resource_optimizations
execution
- ค่าเริ่มต้น
--[no]skip_incompatible_explicit_targets
: "เท็จ" -
ข้ามเป้าหมายที่ใช้ร่วมกันไม่ได้ซึ่งระบุไว้อย่างชัดแจ้งในบรรทัดคำสั่ง โดยค่าเริ่มต้น การสร้างเป้าหมายดังกล่าวจะทำให้เกิดข้อผิดพลาด แต่เป้าหมายเหล่านี้จะถูกข้ามโดยอัตโนมัติเมื่อเปิดใช้ตัวเลือกนี้ ดูที่ https://bazel.build/extending/platforms#skipping-incompatible-targets
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--spawn_strategy=<comma-separated list of options>
: "" -
ระบุวิธีการสร้างคำสั่งเริ่มต้น ยอมรับรายการกลยุทธ์ที่คั่นด้วยจุลภาคจากลำดับความสำคัญสูงสุดไปต่ำสุด สำหรับการกระทำแต่ละรายการ Bazel จะเลือกกลยุทธ์ที่มีลำดับความสำคัญสูงสุดที่สามารถกระทำได้ ค่าเริ่มต้นคือ "remote,worker,sandboxed,local" ดูรายละเอียดได้ที่ https://blog.bazel.build/2019/06/19/list-strategy.html
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--strategy=<a '[name=]value1[,..,valueN]' assignment>
รายการ -
ระบุวิธีการเผยแพร่การคอมไพล์การดำเนินการอื่นๆ ที่สร้างขึ้น ยอมรับรายการกลยุทธ์ที่คั่นด้วยจุลภาคจากลำดับความสำคัญสูงสุดไปต่ำสุด สำหรับการกระทำแต่ละรายการ Bazel จะเลือกกลยุทธ์ที่มีลำดับความสำคัญสูงสุดที่สามารถกระทำได้ ค่าเริ่มต้นคือ "remote,worker,sandboxed,local" แฟล็กนี้จะลบล้างค่าที่กำหนดโดย --spawn_strategy (และ --genrule_strategy หากใช้กับ mnemonic Genrule) ดูรายละเอียดได้ที่ https://blog.bazel.build/2019/06/19/list-strategy.html
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
รายการ -
ลบล้างกลยุทธ์การสร้างที่สร้างขึ้นเพื่อเรียกใช้การดำเนินการที่สร้างขึ้นซึ่งมีคำอธิบายตรงกับ regex_filter บางรายการ ดู --per_file_copt สำหรับรายละเอียดการจับคู่เกี่ยวกับนิพจน์ทั่วไป ระบบจะใช้ regex_filter สุดท้ายที่ตรงกับคำอธิบาย ตัวเลือกนี้จะลบล้างแฟล็กอื่นๆ สำหรับการระบุกลยุทธ์ ตัวอย่าง: --strategy_regexp=//foo.*\.cc,-//foo/bar=local หมายถึงการเรียกใช้การดำเนินการโดยใช้กลยุทธ์ท้องถิ่นหากคำอธิบายตรงกับ //foo.*.cc แต่ไม่ตรงกับ //foo/bar ตัวอย่างเช่น --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed จะเรียกใช้ 'Compiling //foo/bar/baz' พร้อมแป้น "local" แต่การกลับลำดับคำสั่งซื้อจะทำงานด้วย "แซนด์บ็อกซ์"
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--worker_extra_flag=<a 'name=value' assignment>
รายการ -
แฟล็กคำสั่งเพิ่มเติมที่จะส่งผ่านไปยังกระบวนการของพนักงานนอกเหนือจาก --persistent_worker ซึ่งคีย์โดย Mnemonic (เช่น --worker_extra_flag=Javac=--debug
แท็ก:execution
host_machine_resource_optimizations
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--worker_max_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
รายการ -
จำนวนอินสแตนซ์ของผู้ปฏิบัติงานที่ทำงานต่อเนื่องแต่ละประเภทที่อาจมีการเปิดใช้หากคุณใช้ "ผู้ปฏิบัติงาน" ของคุณ อาจระบุเป็น [name=value] เพื่อให้ค่าที่แตกต่างกันต่อความทรงจำ ขีดจำกัดนี้อิงตามคีย์ผู้ปฏิบัติงาน ซึ่งแตกต่างกันตามการจำ และขึ้นอยู่กับแฟล็กและสภาพแวดล้อมการเริ่มต้นด้วย ดังนั้นในบางกรณีอาจมีผู้ปฏิบัติงานต่อความทรงจำมากกว่าที่แฟล็กนี้ระบุ ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") โดยจะเลือกตามด้วยการดำเนินการ ([-|*]<Float>) เช่น "auto", "HOST_CPUS*.5" "auto" จะคำนวณค่าเริ่มต้นที่สมเหตุสมผลตามความจุของเครื่อง "=ค่า" จะตั้งค่าเริ่มต้นสำหรับการช่วยจำที่ไม่ระบุ
แท็ก:execution
host_machine_resource_optimizations
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--worker_max_multiplex_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
รายการ -
จำนวนของ WorkRequest ที่ผู้ปฏิบัติงานมัลติเพล็กซ์จะได้รับพร้อมกันหากคุณใช้ "ผู้ปฏิบัติงาน" ด้วย --worker_multiplex อาจระบุเป็น [name=value] เพื่อให้ค่าที่แตกต่างกันต่อความทรงจำ ขีดจำกัดนี้อิงตามคีย์ผู้ปฏิบัติงาน ซึ่งแตกต่างกันตามการจำ และขึ้นอยู่กับแฟล็กและสภาพแวดล้อมการเริ่มต้นด้วย ดังนั้นในบางกรณีอาจมีผู้ปฏิบัติงานต่อความทรงจำมากกว่าที่แฟล็กนี้ระบุ ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") โดยจะเลือกตามด้วยการดำเนินการ ([-|*]<Float>) เช่น "auto", "HOST_CPUS*.5" "auto" จะคำนวณค่าเริ่มต้นที่สมเหตุสมผลตามความจุของเครื่อง "=ค่า" จะตั้งค่าเริ่มต้นสำหรับการช่วยจำที่ไม่ระบุ
แท็ก:execution
host_machine_resource_optimizations
- ค่าเริ่มต้น
--[no]worker_multiplex
: "true" -
หากเปิดใช้ ผู้ปฏิบัติงานจะใช้การมัลติเพล็กซ์หากรองรับ
แท็ก:execution
host_machine_resource_optimizations
- ค่าเริ่มต้น
--[no]worker_quit_after_build
: "เท็จ" -
หากเปิดใช้ ผู้ปฏิบัติงานทั้งหมดจะออกหลังจากบิลด์เสร็จสิ้น
แท็ก:execution
host_machine_resource_optimizations
- ค่าเริ่มต้น
--[no]worker_sandboxing
: "เท็จ" -
หากเปิดใช้ ผู้ปฏิบัติงาน Singleplex จะทำงานในสภาพแวดล้อมแบบแซนด์บ็อกซ์ ระบบจะแซนด์บ็อกซ์ของผู้ปฏิบัติงาน Singleplex เสมอเมื่อทำงานภายใต้กลยุทธ์การดำเนินการแบบไดนามิก โดยไม่คำนึงถึง Flag นี้
แท็ก:execution
- ค่าเริ่มต้น
--[no]worker_verbose
: "เท็จ" - หากเปิดใช้ พิมพ์ข้อความแบบละเอียดเมื่อผู้ปฏิบัติงานเริ่มงาน ปิดเครื่อง ...
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่ง
- ค่าเริ่มต้น
--[no]build
: "true" -
ดำเนินการสร้าง นี่เป็นลักษณะการทำงานปกติ การระบุ --nobuild จะทำให้บิลด์หยุดทำงานก่อนที่จะดำเนินการของบิลด์ ซึ่งแสดงผลเป็น 0 หากขั้นตอนการโหลดแพ็กเกจและการวิเคราะห์เสร็จสมบูรณ์ โหมดนี้มีประโยชน์ในการทดสอบระยะเหล่านั้น
แท็ก:execution
affects_outputs
- ค่าเริ่มต้น
--[no]experimental_use_validation_aspect
: "เท็จ" -
เลือกว่าจะเรียกใช้การตรวจสอบโดยใช้มุมมอง (สำหรับการทำงานพร้อมกันกับการทดสอบ) หรือไม่
แท็ก:execution
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--output_groups=<comma-separated list of options>
รายการ -
รายการของชื่อกลุ่มเอาต์พุตที่คั่นด้วยคอมมา ซึ่งแต่ละรายการอาจนำหน้าด้วยเครื่องหมาย + หรือ - ระบบจะเพิ่มกลุ่มที่ขึ้นต้นด้วย + ลงในชุดกลุ่มเอาต์พุตเริ่มต้น ส่วนกลุ่มที่ขึ้นต้นด้วย - จะถูกนำออกจากชุดเริ่มต้น หากมีอย่างน้อย 1 กลุ่มที่ไม่มีคำนำหน้า ระบบจะละเว้นชุดกลุ่มเอาต์พุตเริ่มต้น ตัวอย่างเช่น --output_groups=+foo,+bar จะสร้างการรวมของชุดเริ่มต้น ได้แก่ foo และ bar ในขณะที่ --output_groups=foo,bar จะลบล้างชุดเริ่มต้นที่สร้างเฉพาะ foo และ bar
แท็ก:execution
affects_outputs
- ค่าเริ่มต้น
--[no]run_validations
: "true" -
ระบุว่าจะเรียกใช้การดำเนินการตรวจสอบเป็นส่วนหนึ่งของบิลด์หรือไม่ โปรดดู https://bazel.build/extending/rules#Validation_actions
แท็ก:execution
affects_outputs
- เอาต์พุตที่ต้องการ ซึ่งส่งผลต่อค่าของผลลัพธ์ ไม่ใช่ค่าที่มีอยู่
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--aspects=<comma-separated list of options>
รายการ - รายการด้านที่คั่นด้วยจุลภาคที่จะนำไปใช้กับเป้าหมายระดับบนสุด ในรายการนี้ หากลักษณะ some_aspect ระบุผู้ให้บริการด้านที่จำเป็นผ่าน required_aspect_providers นั้น some_aspect จะทำงานหลังจากทุกด้านที่พูดถึงก่อนหน้าในรายการด้านที่ผู้ให้บริการด้านโฆษณาตอบสนองผู้ให้บริการด้านบางด้านที่จำเป็น นอกจากนี้ some_aspect จะทำงานหลังจากด้านที่ต้องระบุทั้งหมดที่ระบุไว้โดย required [แอตทริบิวต์] จากนั้น some_aspect จะมีสิทธิ์เข้าถึงคุณค่าของแง่มุมเหล่านั้น ผู้ให้บริการเครือข่าย <bzl-file-label>%<aspect_name> เช่น '//tools:my_def.bzl%my_aspect' โดยที่ 'my_aspect' เป็นค่าระดับบนสุดจากเครื่องมือไฟล์/my_def.bzl
- ค่าเริ่มต้น
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
จำนวนไฟล์เปิดสูงสุดที่อนุญาตระหว่างการอัปโหลดอาร์ติแฟกต์ BEP
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_convenience_symlinks
: "ปกติ" -
แฟล็กนี้ควบคุมวิธีจัดการลิงก์สัญลักษณ์ตามความสะดวก (ลิงก์สัญลักษณ์ที่ปรากฏในพื้นที่ทำงานหลังบิลด์) ค่าที่เป็นไปได้มีดังนี้
ปกติ (ค่าเริ่มต้น): ระบบจะสร้างหรือลบลิงก์สัญลักษณ์เพื่อความสะดวกแต่ละประเภทตามที่กำหนดโดยบิลด์
สะอาด: ลิงก์สัญลักษณ์ทั้งหมดจะถูกลบโดยไม่มีเงื่อนไข
เพิกเฉย: จะไม่มีการสร้างหรือล้าง Symlinks
log_only: สร้างข้อความบันทึกเสมือนเป็น "ปกติ" ผ่าน แต่ไม่ได้ดำเนินการเกี่ยวกับระบบไฟล์จริงๆ (มีประโยชน์สำหรับเครื่องมือ)
โปรดทราบว่าเฉพาะลิงก์สัญลักษณ์ที่มีชื่อที่สร้างขึ้นด้วยค่าปัจจุบันของ --symlink_prefix เท่านั้นที่อาจได้รับผลกระทบ หากคำนำหน้าเปลี่ยนไป ลิงก์สัญลักษณ์ที่มีอยู่แล้วก็จะถูกปล่อยไว้ตามเดิม
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_convenience_symlinks_bep_event
: "true" -
แฟล็กนี้ควบคุมว่าเราจะโพสต์เหตุการณ์บิลด์ConvenienceSymlinksIdentified ไปยัง BuildEventProtocol หรือไม่ หากค่าเป็น "จริง" BuildEventProtocol จะมีรายการ ConvesSymlinksIdentified ที่มีรายการลิงก์สัญลักษณ์แบบอำนวยความสะดวกทั้งหมดที่สร้างในพื้นที่ทำงานของคุณ หากเป็น "เท็จ" รายการ meetSymlinksIdentified ใน BuildEventProtocol จะว่างเปล่า
แท็ก:affects_outputs
--remote_download_all
-
ดาวน์โหลดเอาต์พุตระยะไกลทั้งหมดไปยังเครื่องภายใน แฟล็กนี้เป็นชื่อแทนของ --remote_download_outputs=all
ขยายเป็น
--remote_download_outputs=all
แท็ก:affects_outputs
--remote_download_minimal
-
ไม่ดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลไปยังเครื่องภายใน แฟล็กนี้เป็นชื่อแทนของ --remote_download_outputs=minimal
ขยายเป็น
--remote_download_outputs=minimal
แท็ก:affects_outputs
- ค่าเริ่มต้น
--remote_download_outputs=<all, minimal or toplevel>
: "ระดับบนสุด" -
หากตั้งค่าเป็น "ขั้นต่ำ" จะไม่ดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลไปยังเครื่องภายใน ยกเว้นเอาต์พุตที่การดำเนินการในเครื่องจำเป็นต้องใช้ หากตั้งค่าเป็น "ระดับบนสุด" แสดงตัวเหมือน "น้อยมาก" เว้นแต่ว่าจะดาวน์โหลดเอาต์พุตของเป้าหมายระดับบนสุดไปยังเครื่องภายในด้วย ตัวเลือกทั้ง 2 รายการจะช่วยลดเวลาบิลด์ได้อย่างมากหากแบนด์วิดท์ของเครือข่ายเป็นจุดคอขวด
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--remote_download_symlink_template=<a string>
: "" -
สร้างลิงก์สัญลักษณ์แทนการดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลไปยังเครื่องภายใน ระบุเป้าหมายของลิงก์สัญลักษณ์ในรูปแบบสตริงเทมเพลตได้ สตริงเทมเพลตนี้อาจมี {hash} และ {size_bytes} ที่ขยายเป็นแฮชของออบเจ็กต์และขนาดเป็นไบต์ตามลำดับ เช่น ลิงก์สัญลักษณ์เหล่านี้อาจชี้ไปยังระบบไฟล์ FUSE ที่โหลดออบเจ็กต์จาก CAS ตามคำขอ
แท็ก:affects_outputs
--remote_download_toplevel
-
ดาวน์โหลดเฉพาะเอาต์พุตระยะไกลของเป้าหมายระดับบนสุดไปยังเครื่องภายในเท่านั้น แฟล็กนี้เป็นชื่อแทนของ --remote_download_outputs=toplevel
ขยายเป็น
--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
- ค่าเริ่มต้น
--[no]experimental_sandboxfs_map_symlink_targets
: "เท็จ" -
ไม่มีการดำเนินการ
แท็ก:host_machine_resource_optimizations
,execution
- ค่าเริ่มต้น
--[no]incompatible_legacy_local_fallback
: "เท็จ" -
หากตั้งค่าเป็น "จริง" จะเปิดใช้วิดีโอสำรองโดยนัยแบบเดิมจากแซนด์บ็อกซ์เป็นกลยุทธ์ในเครื่อง แฟล็กนี้จะมีค่าเริ่มต้นเป็น "เท็จ" และจะกลายเป็น no-op ใช้ --strategy, --spawn_strategy หรือ --dynamic_local_strategy กำหนดค่าวิดีโอสำรองแทน
แท็ก:execution
incompatible_change
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--sandbox_add_mount_pair=<a single path or a 'source:target' pair>
รายการ -
เพิ่มคู่เส้นทางเพิ่มเติมเพื่อต่อเชื่อมในแซนด์บ็อกซ์
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--sandbox_block_path=<a string>
รายการ -
สำหรับการดำเนินการที่ทำแซนด์บ็อกซ์ โปรดอย่าอนุญาตการเข้าถึงนี้
แท็ก:execution
- ค่าเริ่มต้น
--[no]sandbox_default_allow_network
: "true" -
อนุญาตการเข้าถึงเครือข่ายโดยค่าเริ่มต้นสำหรับการทำงาน ซึ่งอาจใช้ไม่ได้กับการใช้งานแซนด์บ็อกซ์บางประเภท
แท็ก:execution
- ค่าเริ่มต้น
--[no]sandbox_fake_hostname
: "เท็จ" -
เปลี่ยนชื่อโฮสต์ปัจจุบันเป็น "localhost" สำหรับการดำเนินการที่ทำแซนด์บ็อกซ์
แท็ก:execution
- ค่าเริ่มต้น
--[no]sandbox_fake_username
: "เท็จ" -
เปลี่ยนชื่อผู้ใช้ปัจจุบันเป็น "nobody" สำหรับการดำเนินการที่ทำแซนด์บ็อกซ์
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--sandbox_writable_path=<a string>
รายการ -
สำหรับการดำเนินการที่ทำแซนด์บ็อกซ์ ให้ทำให้ไดเรกทอรีที่มีอยู่เขียนได้ในแซนด์บ็อกซ์ (หากการดำเนินการแซนด์บ็อกซ์รองรับ และจะไม่พิจารณาไดเรกทอรีอื่น)
แท็ก:execution
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_config_setting_private_default_visibility
: "เท็จ" -
หากไม่รองรับ _enforce_config_setting_visibility=false ค่าจะเป็น Noop หรือไม่เช่นนั้น หากแฟล็กนี้เป็นเท็จ config_setting ใดๆ ที่ไม่มีแอตทริบิวต์การเปิดเผยอย่างชัดแจ้งจะเป็น //visibility:public หากแฟล็กนี้เป็นจริง config_setting จะใช้ตรรกะระดับการเข้าถึงเดียวกันกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_enforce_config_setting_visibility
: "true" -
หากเป็น "จริง" ให้บังคับใช้การจำกัดระดับการเข้าถึง config_setting หากเป็น "เท็จ" ทุก config_setting จะปรากฏแก่เป้าหมายทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_use_plus_in_repo_names
: "true" -
ไม่มีการดำเนินการ
แท็ก:loading_and_analysis
- ตัวเลือกที่ควบคุมลักษณะการทำงานของสภาพแวดล้อมการทดสอบหรือตัวดำเนินการทดสอบ
- ค่าเริ่มต้น
--[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" ในการใช้กัน
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพเวลาบิลด์
- ค่าเริ่มต้นของ
--cache_computed_file_digests=<a long integer>
: "50,000" - หากมากกว่า 0 ให้กำหนดค่า Bazel ให้แคชไดเจสต์ของไฟล์ในหน่วยความจำตามข้อมูลเมตาของไฟล์แทนการคำนวณไดเจสต์ใหม่จากดิสก์ทุกครั้งที่ต้องการ การตั้งค่านี้เป็น 0 จะรับประกันความถูกต้อง เนื่องจากการเปลี่ยนแปลงไฟล์บางอย่างอาจบันทึกจากข้อมูลเมตาของไฟล์ไม่ได้ เมื่อไม่ใช่ 0 ตัวเลขนี้บ่งบอกถึงขนาดของแคชตามจำนวนไดเจสต์ของไฟล์ที่จะแคช
- ค่าเริ่มต้น
--[no]experimental_cpu_load_scheduling
: "เท็จ" -
เปิดใช้การกำหนดเวลาการดำเนินการในเครื่องแบบทดลองตามโหลดของ CPU ไม่ใช่การประมาณการดำเนินการทีละรายการ การจัดตารางเวลาแบบทดลองได้แสดงให้เห็นถึงประโยชน์อย่างมากจากบิลด์ภายในเครื่องขนาดใหญ่ ซึ่งได้จากเครื่องที่ทรงพลังที่มีแกนประมวลผลจำนวนมาก แนะนำให้ใช้กับ --local_resources=cpu=HOST_CPUS
แท็ก:execution
- ค่าเริ่มต้น
--experimental_dynamic_ignore_local_signals=<a comma-separated list of signal numbers>
: ดูคำอธิบาย -
รับรายการหมายเลขสัญญาณของระบบปฏิบัติการ หาก Branch ของการดำเนินการแบบไดนามิกไม่ทำงานด้วยสัญญาณเหล่านี้ ระบบจะอนุญาตให้ Branch ระยะไกลทำงานให้เสร็จแทน สำหรับผู้ปฏิบัติงานที่ทำงานต่อเนื่อง นโยบายนี้จะส่งผลต่อสัญญาณที่ยุติกระบวนการทำงานของพนักงานเท่านั้น
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_enable_skyfocus
: "เท็จ" -
หากเป็นจริง ให้เปิดใช้ --experimental_working_set เพื่อลดการใช้หน่วยความจำของ Bazel สำหรับบิลด์ที่เพิ่มขึ้น ฟีเจอร์นี้เรียกว่า SkyFocus
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--experimental_working_set=<comma-separated list of options>
: "" -
ชุดการทำงานสำหรับ SkyFocus ระบุเป็นเส้นทางที่สัมพันธ์กับรูทของพื้นที่ทำงานซึ่งคั่นด้วยคอมมา นี่คือการแจ้งสถานะ การกำหนดชุดการทำงานจะยังคงอยู่สำหรับการเรียกใช้ครั้งต่อๆ ไป จนกว่าจะมีการกำหนดชุดใหม่ด้วยชุดใหม่
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
: "HOST_CPUS" -
กำหนดจำนวนแกน CPU ภายในทั้งหมดอย่างชัดเจนให้กับ Bazel เพื่อใช้จ่ายกับการดำเนินการของบิลด์ที่ดำเนินการภายในเครื่อง ใช้ค่าจำนวนเต็มหรือ "HOST_CPUS" แล้วตามด้วย [-|*]<float> (ไม่บังคับ) (เช่น HOST_CPUS*.5 เพื่อใช้แกน CPU ที่มีอยู่ครึ่งหนึ่ง) โดยค่าเริ่มต้น ("HOST_CPUS") Bazel จะค้นหาการกำหนดค่าของระบบเพื่อประมาณจำนวนแกน CPU ที่มี
แท็ก:host_machine_resource_optimizations
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--local_extra_resources=<a named float, 'name=value'>
รายการ -
กำหนดจำนวนทรัพยากรเพิ่มเติมที่ใช้ได้กับ Bazel รับในคู่สตริง-ลอย ใช้เพื่อระบุทรัพยากรเพิ่มเติมได้หลายประเภท Bazel จะจำกัดการดำเนินการที่เกิดขึ้นพร้อมกันตามทรัพยากรที่มีและทรัพยากรเพิ่มเติมที่จำเป็น การทดสอบสามารถประกาศจำนวนทรัพยากรเพิ่มเติมที่ต้องการโดยใช้แท็ก "resources:<resoucename>:<amount>" ตั้งค่า CPU, RAM และทรัพยากรที่มีอยู่ด้วยแฟล็กนี้ไม่ได้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้น
--local_ram_resources=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "HOST_RAM*.67" -
กำหนดจำนวน RAM ทั้งหมดของโฮสต์ในเครื่อง (เป็น MB) ที่ Bazel จะใช้ได้อย่างชัดเจนเพื่อใช้จ่ายกับการดำเนินการของบิลด์ที่ดำเนินการภายในเครื่อง ใช้จำนวนเต็มหรือ "HOST_RAM" แล้วตามด้วย [-|*]<float> หรือไม่ก็ได้ (เช่น HOST_RAM*.5 เพื่อใช้ RAM ที่มีอยู่ครึ่งหนึ่ง) โดยค่าเริ่มต้น ("HOST_RAM*.67") Bazel จะค้นหาการกำหนดค่าของระบบเพื่อประมาณจำนวน RAM ที่มีและจะใช้ 67% จากการกำหนดค่านี้
แท็ก:host_machine_resource_optimizations
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--local_resources=<a named double, 'name=value', where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
รายการ -
กำหนดจำนวนทรัพยากรที่ Bazel ใช้ได้ นำงานไปยัง Float หรือ HOST_RAM/HOST_CPUS (ไม่บังคับ) ตามด้วย [-|*]<Flo> (เช่น Memory=HOST_RAM*.5 เพื่อใช้ RAM ที่มีอยู่ครึ่งหนึ่ง) ใช้เพื่อระบุทรัพยากรได้หลายประเภทได้หลายครั้ง Bazel จะจำกัดการดำเนินการที่เกิดขึ้นพร้อมกันตามทรัพยากรที่มีและทรัพยากรที่จำเป็น การทดสอบจะประกาศจำนวนทรัพยากรที่ต้องการได้โดยใช้แท็ก "resources:<resource name>:<amount>" ลบล้างทรัพยากรที่ระบุโดย --local_{cpu|ram|extra}_resources
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
- ค่าเริ่มต้น
--build_event_upload_max_retries=<an integer>
: "4" -
จำนวนครั้งสูงสุดที่ Bazel ควรลองอัปโหลดเหตุการณ์บิลด์อีกครั้ง
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[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_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_docker_verbose
: "เท็จ" -
หากเปิดใช้ Bazel จะพิมพ์ข้อความที่มีรายละเอียดเกี่ยวกับกลยุทธ์แซนด์บ็อกซ์ของ Docker มากขึ้น
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_materialize_param_files_directly
: "เท็จ" -
หากทำให้ไฟล์พารามิเตอร์เป็นรูปธรรม ให้ดำเนินการดังกล่าวด้วยการเขียนไปยังดิสก์โดยตรง
แท็ก:execution
- ค่าเริ่มต้นของ
--experimental_repository_resolved_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้เขียนค่า Starlark พร้อมข้อมูลที่แก้ไขแล้วของกฎที่เก็บ Starlark ทั้งหมดที่ดำเนินการ
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_run_bep_event_include_residue
: "เท็จ" -
เลือกว่าจะรวมการขาดเหลือของบรรทัดคำสั่งในเหตุการณ์บิลด์ซึ่งอาจมีส่วนที่เหลือหรือไม่ โดยค่าเริ่มต้น ความต่อเนื่องจะไม่รวมอยู่ในเหตุการณ์การสร้างคำสั่งการเรียกใช้คำสั่งที่อาจมีส่วนที่เหลืออยู่
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_skyfocus_dump_keys=<none, count or verbose>
: "ไม่มี" -
สำหรับการแก้ไขข้อบกพร่องของ SkyFocus ข้าม SkyKeys ที่โฟกัส (ราก ใบไม้ เดปที่เน้น การเน้นเสียง)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]experimental_skyfocus_dump_post_gc_stats
: "เท็จ" -
สำหรับการแก้ไขข้อบกพร่องของ SkyFocus หากเปิดใช้ ให้เรียกใช้ GC ด้วยตนเองก่อน/หลังการโฟกัสเพื่อรายงานการลดขนาดฮีป ซึ่งจะเพิ่มเวลาในการตอบสนองของ SkyFocus
แท็ก:terminal_output
- ค่าเริ่มต้น
--experimental_skyfocus_handling_strategy=<strict or warn>
: "เข้มงวด" -
กลยุทธ์สำหรับ SkyFocus เพื่อรับมือกับการเปลี่ยนแปลงนอกเหนือจากการทำงาน
แท็ก:eagerness_to_exit
- ค่าเริ่มต้น
--[no]experimental_stream_log_file_uploads
: "เท็จ" -
สตรีมไฟล์บันทึกจะอัปโหลดไปยังพื้นที่เก็บข้อมูลระยะไกลโดยตรงแทนการเขียนลงดิสก์
แท็ก:affects_outputs
- ค่าเริ่มต้น
--explain=<a path>
: ดูคำอธิบาย -
ทำให้ระบบบิลด์อธิบายแต่ละขั้นตอนที่ดำเนินการแล้วของบิลด์ ระบบจะเขียนคำอธิบายลงในไฟล์บันทึกที่ระบุ
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]ignore_unsupported_sandboxing
: "เท็จ" -
ไม่ต้องพิมพ์คำเตือนเมื่อระบบนี้ไม่รองรับการดำเนินการแบบแซนด์บ็อกซ์
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]legacy_important_outputs
: "true" -
ใช้อาร์กิวเมนต์นี้เพื่อระงับการสร้างช่อง legal_outputs เดิมในเหตุการณ์ TargetComplete ต้องใช้ required_outputs สำหรับการผสานรวม Bazel กับ ResultStore
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]materialize_param_files
: "เท็จ" -
เขียนไฟล์พารามิเตอร์ระดับกลางไปยังโครงสร้างเอาต์พุตแม้ในขณะที่ใช้การดำเนินการจากระยะไกล มีประโยชน์เมื่อมีการแก้ไขข้อบกพร่อง ซึ่งหมายถึง --subcommands และ --verbose_failures
แท็ก:execution
- ค่าเริ่มต้น
--max_config_changes_to_show=<an integer>
: "3" -
เมื่อทิ้งแคชการวิเคราะห์เนื่องจากการเปลี่ยนแปลงตัวเลือกบิลด์ จะแสดงชื่อตัวเลือกที่มีการเปลี่ยนแปลงตามจำนวนที่กำหนด ถ้าตัวเลขที่ระบุคือ -1 ตัวเลือกที่มีการเปลี่ยนแปลงทั้งหมดจะแสดง
แท็ก:terminal_output
- ค่าเริ่มต้น
--max_test_output_bytes=<an integer>
: "-1" -
ระบุขนาดสูงสุดของบันทึกต่อการทดสอบที่ส่งได้เมื่อ --test_output คือ "ข้อผิดพลาด" หรือ "ทั้งหมด" มีประโยชน์เพื่อหลีกเลี่ยงเอาต์พุตที่ไม่ได้ทำให้เอาต์พุตการทดสอบมีเสียงดังรบกวนมากเกินไป ส่วนหัวการทดสอบจะรวมอยู่ในขนาดบันทึก ค่าลบหมายถึงไม่มีขีดจำกัด เอาต์พุตทั้งหมดหรือไม่มีเลย
แท็ก:test_runner
,terminal_output
,execution
- ค่าเริ่มต้น
--output_filter=<a valid Java regular expression>
: ดูคำอธิบาย -
แสดงเฉพาะเอาต์พุตของคำเตือนและการดำเนินการสำหรับกฎที่มีชื่อตรงกับนิพจน์ทั่วไปที่ระบุ
แท็ก:affects_outputs
- ค่าเริ่มต้น
--progress_report_interval=<an integer in 0-3600 range>
: "0" -
จำนวนวินาทีที่จะรอระหว่างรายงานในงานที่ยังทำงานอยู่ ค่าเริ่มต้น 0 หมายความว่าระบบจะพิมพ์รายงานแรกหลังผ่านไป 10 วินาที จากนั้นจะแสดงเป็นเวลา 30 วินาที หลังจากนั้นจะมีการรายงานความคืบหน้า 1 ครั้งในทุกๆ นาที เมื่อเปิดใช้งาน --curses จะมีการรายงานความคืบหน้าทุกวินาที
แท็ก:affects_outputs
- ค่าเริ่มต้น
--remote_print_execution_messages=<failure, success or all>
: "ล้มเหลว" -
เลือกเวลาที่จะพิมพ์ข้อความการดำเนินการจากระยะไกล ค่าที่ใช้ได้คือ "ล้มเหลว" หากต้องการพิมพ์เมื่อล้มเหลวเท่านั้น "สำเร็จ" เพื่อพิมพ์เฉพาะเมื่อสำเร็จ และ "ทั้งหมด" เพื่อพิมพ์เสมอ
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]sandbox_debug
: "เท็จ" -
เปิดใช้ฟีเจอร์การแก้ไขข้อบกพร่องสำหรับฟีเจอร์แซนด์บ็อกซ์ ซึ่งรวมถึง 2 อย่างแรกคือ เนื้อหารูทของแซนด์บ็อกซ์จะไม่ต้องดำเนินการใดๆ หลังบิลด์ และอย่างที่สอง พิมพ์ข้อมูลการแก้ไขข้อบกพร่องเพิ่มเติมในการเรียกใช้ ซึ่งจะช่วยให้นักพัฒนาซอฟต์แวร์ของกฎ Bazel หรือ Starlark แก้ไขข้อบกพร่องไม่สำเร็จเนื่องจากไม่มีไฟล์อินพุต ฯลฯ
แท็ก:terminal_output
- ค่าเริ่มต้น
--show_result=<an integer>
: "1" -
แสดงผลลัพธ์ของบิลด์ สำหรับแต่ละเป้าหมาย ให้ระบุว่าเป็นข้อมูลล่าสุดหรือไม่ และหากใช่ ให้แจ้งรายการไฟล์เอาต์พุตที่สร้างขึ้น ไฟล์ที่พิมพ์เป็นสตริงที่สะดวกสำหรับการคัดลอก+วางลงใน Shell เพื่อเรียกใช้ไฟล์
ตัวเลือกนี้ต้องใช้อาร์กิวเมนต์จำนวนเต็ม ซึ่งเป็นจำนวนเกณฑ์ของเป้าหมายด้านบนซึ่งระบบจะไม่พิมพ์ข้อมูลผลลัพธ์ ดังนั้น 0 จะทำให้มีการระงับข้อความและ MAX_INT จะทำให้มีการพิมพ์ผลลัพธ์เสมอ ค่าเริ่มต้นคือ 1
หากไม่มีสิ่งใดที่สร้างขึ้นสำหรับเป้าหมาย ระบบอาจละเว้นผลลัพธ์เพื่อให้เอาต์พุตอยู่ภายใต้เกณฑ์
แท็ก:affects_outputs
--[no]subcommands
[-s
] ค่าเริ่มต้น: "เท็จ"-
แสดงคำสั่งย่อยที่ดำเนินการระหว่างบิลด์ แฟล็กที่เกี่ยวข้อง: --execution_log_json_file, --execution_log_binary_file (สำหรับการบันทึกคำสั่งย่อยไปยังไฟล์ในรูปแบบที่ง่ายต่อการใช้เครื่องมือ)
แท็ก:terminal_output
- ค่าเริ่มต้น
--test_output=<summary, errors, all or streamed>
: "summary" -
ระบุโหมดเอาต์พุตที่ต้องการ ค่าที่ถูกต้องคือ "summary" เพื่อแสดงเฉพาะสรุปสถานะการทดสอบ "ข้อผิดพลาด" เพื่อพิมพ์บันทึกการทดสอบสำหรับการทดสอบที่ล้มเหลวด้วย "ทั้งหมด" เพื่อพิมพ์บันทึกสำหรับการทดสอบทั้งหมดและ "สตรีม" เพื่อส่งออกบันทึกสำหรับการทดสอบทั้งหมดในแบบเรียลไทม์ (การดำเนินการนี้จะบังคับให้ดำเนินการทดสอบในเครื่องครั้งละ 1 รายการโดยไม่คำนึงถึงค่า --test_strategy)
แท็ก:test_runner
,terminal_output
,execution
- ค่าเริ่มต้นของ
--test_summary=<short, terse, detailed, none or testcase>
: "สั้น" -
ระบุรูปแบบของสรุปการทดสอบที่ต้องการ ค่าที่ถูกต้องคือ "short" เพื่อพิมพ์ข้อมูลเกี่ยวกับการทดสอบที่ดําเนินการเท่านั้น "แบบละเอียด" เพื่อพิมพ์เฉพาะข้อมูลเกี่ยวกับการทดสอบที่ดําเนินการไม่สําเร็จเท่านั้น เช่น "แบบละเอียด" เพื่อพิมพ์ข้อมูลโดยละเอียดเกี่ยวกับกรอบการทดสอบที่ล้มเหลว เช่น "testcase" เพื่อพิมพ์สรุปในการแก้ปัญหากรอบการทดสอบ อย่าพิมพ์ข้อมูลโดยละเอียดเกี่ยวกับกรอบการทดสอบที่ล้มเหลวและ "ไม่มี" ที่จะละเว้นข้อมูลสรุป
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]verbose_explanations
: "เท็จ" -
เพิ่มรายละเอียดของคำอธิบายที่ออกหากเปิดใช้ --explain จะไม่มีผล หากไม่ได้เปิดใช้งาน --explain
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]verbose_failures
: "เท็จ" -
หากเรียกใช้คำสั่งไม่สำเร็จ ให้พิมพ์บรรทัดคำสั่งแบบเต็ม
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--aspects_parameters=<a 'name=value' assignment>
รายการ -
ระบุค่าของพารามิเตอร์ด้านบรรทัดคำสั่ง ค่าพารามิเตอร์แต่ละรายการจะระบุผ่าน <param_name>=<param_value> เช่น 'my_param=my_val' ที่ "my_param" คือพารามิเตอร์ของบางด้านในรายการ --aspects รายการ หรือจำเป็นต้องใช้สำหรับด้านใดด้านหนึ่งในรายการ ตัวเลือกนี้ใช้ได้หลายครั้ง อย่างไรก็ตาม ไม่อนุญาตให้กำหนดค่าให้กับพารามิเตอร์เดียวกันมากกว่า 1 ครั้ง
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--target_pattern_file=<a string>
: "" -
ถ้ามีการตั้งค่า บิลด์จะอ่านรูปแบบจากไฟล์ที่มีชื่อที่นี่ แทนที่จะเป็นบรรทัดคำสั่ง การระบุไฟล์ที่นี่ รวมถึงรูปแบบบรรทัดคำสั่งเป็นข้อผิดพลาด
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
- ค่าเริ่มต้น
--experimental_circuit_breaker_strategy=<failure>
: ดูคำอธิบาย -
ระบุกลยุทธ์ที่เบรกเกอร์จะใช้ กลยุทธ์ที่ใช้ได้คือ "ความล้มเหลว" หากค่าที่ไม่ถูกต้องสำหรับตัวเลือก ลักษณะการทำงานเช่นเดียวกันกับตัวเลือกไม่ได้ตั้งค่า
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_guard_against_concurrent_changes
: "เท็จ" - ปิดการตั้งค่านี้เพื่อปิดใช้การตรวจสอบเวลาของไฟล์อินพุตของการดำเนินการก่อนอัปโหลดไปยังแคชระยะไกล ในบางกรณีที่เคอร์เนลของ Linux จะหน่วงเวลาการเขียนไฟล์ ซึ่งอาจทำให้เกิดผลบวกลวง
- ค่าเริ่มต้น
--[no]experimental_remote_cache_async
: "เท็จ" - หากเป็น "จริง" I/O ของแคชระยะไกลจะเกิดขึ้นในเบื้องหลังแทนที่จะเกิดขึ้นเป็นส่วนที่สร้างขึ้น
- ค่าเริ่มต้น
--experimental_remote_cache_compression_threshold=<an integer>
: "0" - ขนาด BLOB ขั้นต่ำที่ต้องใช้เพื่อบีบอัด/คลายการบีบอัดด้วย zstd จะไม่มีผล ยกเว้นกรณีที่ตั้งค่า --remote_cache_compression ไว้
- ค่าเริ่มต้น
--experimental_remote_cache_eviction_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดที่จะลองอีกครั้งหากบิลด์พบข้อผิดพลาดในการกำจัดแคชระยะไกล ค่าที่ไม่ใช่ 0 จะมีการตั้งค่าโดยปริยาย --incompatible_remote_use_new_exit_code_for_lost_inputs เป็น "จริง" ระบบจะสร้างรหัสคำขอใหม่สำหรับการพยายามแต่ละครั้ง หากคุณสร้างรหัสคำขอและส่งให้กับ Bazel โดยใช้ --invocation_id คุณไม่ควรใช้แฟล็กนี้ แต่ให้ตั้งค่าสถานะ --incompatible_remote_use_new_exit_code_for_lost_inputs แล้วตรวจสอบโค้ดสำหรับออก 39
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_remote_cache_lease_extension
: "เท็จ" - หากตั้งค่าเป็น "จริง" Bazel จะขยายเวลาการเช่าสำหรับเอาต์พุตของการดำเนินการระยะไกลระหว่างการสร้างโดยการส่งการเรียกใช้ "FindDoesBlobs" ไปยังแคชระยะไกลเป็นระยะ ความถี่จะอิงตามค่าของ "--experimental_remote_cache_ttl"
- ค่าเริ่มต้น
--experimental_remote_cache_ttl=<An immutable length of time.>
: "3 ชม." -
TTL ที่รับประกันขั้นต่ำของ BLOB ในแคชระยะไกลหลังจากมีการอ้างอิงไดเจสต์เมื่อเร็วๆ นี้ เช่น โดย ActionResult หรือ Find MissingBlobs Bazel ทำการเพิ่มประสิทธิภาพมากมายโดยอิงตาม BLOB TTL เช่น ไม่ได้เรียกใช้ GetActionResult ซ้ำๆ ในบิลด์ที่เพิ่มขึ้น ควรกำหนดค่าน้อยกว่า TTL จริงเล็กน้อย เนื่องจากมีช่องว่างระหว่างเวลาที่เซิร์ฟเวอร์แสดงผลไดเจสต์กับเวลาที่ Bazel ได้รับ
แท็ก:execution
- ค่าเริ่มต้น
--experimental_remote_capture_corrupted_outputs=<a path>
: ดูคำอธิบาย - เส้นทางไปยังไดเรกทอรีซึ่งจะมีการบันทึกเอาต์พุตที่เสียหาย
- ค่าเริ่มต้น
--[no]experimental_remote_discard_merkle_trees
: "true" - หากตั้งค่าเป็น "จริง" ให้ทิ้งสำเนาในหน่วยความจำของโครงสร้าง Merkle ของรูทอินพุตและการแมปอินพุตที่เกี่ยวข้องระหว่างการเรียก GetActionResult() และ Execute() ซึ่งช่วยลดการใช้งานหน่วยความจำได้อย่างมาก แต่จะต้องให้ Bazel คํานวณใหม่เมื่อมีการไม่พบแคชระยะไกลหรือลองอีกครั้ง
- ค่าเริ่มต้น
--experimental_remote_downloader=<a string>
: ดูคำอธิบาย - URI ปลายทางของ Remote Asset API ที่จะใช้เป็นพร็อกซีการดาวน์โหลดระยะไกล สคีมาที่รองรับ ได้แก่ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (ซ็อกเก็ต UNIX ในเครื่อง) หากไม่ได้ระบุสคีมา Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ดูที่ https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.เลือก
- ค่าเริ่มต้น
--[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
- ค่าเริ่มต้น
--experimental_remote_output_service=<a string>
: ดูคำอธิบาย - HOST หรือ HOST:PORT ของปลายทางบริการเอาต์พุตระยะไกล สคีมาที่รองรับ ได้แก่ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (ซ็อกเก็ต UNIX ในเครื่อง) หากไม่ได้ระบุสคีมา Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุ grpc:// หรือ unix: สคีมาเพื่อปิดใช้ TLS
- ค่าเริ่มต้นของ
--experimental_remote_output_service_output_path_prefix=<a string>
: "" - เส้นทางที่เก็บเนื้อหาของไดเรกทอรีเอาต์พุตที่จัดการโดย --experimental_remote_output_service ไดเรกทอรีเอาต์พุตจริงที่บิลด์ใช้จะเป็นรายการสืบทอดของเส้นทางนี้และกำหนดโดยบริการเอาต์พุต
- ค่าเริ่มต้น
--[no]experimental_remote_require_cached
: "เท็จ" - หากตั้งค่าเป็น "จริง" ให้บังคับใช้การแคชการดำเนินการทั้งหมดที่เรียกใช้จากระยะไกลได้ ไม่เช่นนั้นจะทำให้บิลด์ใช้งานไม่ได้ วิธีนี้มีประโยชน์ในการแก้ปัญหาที่ไม่ได้กำหนดกระบวนการ เนื่องจากจะช่วยให้ตรวจสอบได้ว่าการดำเนินการที่ควรแคชมีการแคชไว้จริงๆ หรือไม่ โดยไม่ต้องแทรกผลลัพธ์ใหม่ลงในแคชอย่างจงใจ
- ค่าเริ่มต้น
--experimental_remote_scrubbing_config=<Converts to a Scrubber>
: ดูคำอธิบาย - เปิดใช้การสครับคีย์แคชระยะไกลด้วยไฟล์การกำหนดค่าที่ให้มา ซึ่งต้องเป็นบัฟเฟอร์โปรโตคอลในรูปแบบข้อความ (ดู src/main/protocolbuf/remote_scrubbing.เลือก) ฟีเจอร์นี้มีไว้เพื่ออำนวยความสะดวกในการแชร์แคชระยะไกล/ดิสก์ระหว่างการดำเนินการที่ดำเนินการบนแพลตฟอร์มอื่นแต่กำหนดเป้าหมายไปยังแพลตฟอร์มเดียวกัน ควรใช้ด้วยความระมัดระวังอย่างยิ่ง เนื่องจากการตั้งค่าที่ไม่เหมาะสมอาจทำให้เกิดการแชร์รายการแคชโดยไม่ได้ตั้งใจและส่งผลให้เกิดการสร้างที่ไม่ถูกต้อง การสครับไม่มีผลต่อวิธีเรียกใช้การดำเนินการ แต่มีเพียงวิธีการคำนวณคีย์แคชระยะไกล/ดิสก์เพื่อวัตถุประสงค์ในการเรียกข้อมูลหรือจัดเก็บผลลัพธ์การดำเนินการเท่านั้น การดำเนินการแบบสครับใช้กับการดำเนินการระยะไกลไม่ได้ และจะทำงานในเครื่องแทนเสมอ การแก้ไขการกำหนดค่าการสครับจะไม่ทำให้เอาต์พุตที่มีอยู่ในระบบไฟล์ในเครื่องหรือแคชภายในเป็นโมฆะ ต้องใช้บิลด์ใหม่เพื่อดำเนินการทำงานที่ได้รับผลกระทบอีกครั้ง เพื่อให้สามารถใช้ฟีเจอร์นี้ได้สำเร็จ คุณอาจต้องตั้งค่า --host_platform ที่กำหนดเองร่วมกับ --experimental_platform_in_output_dir (เพื่อทำให้คำนำหน้าเอาต์พุตเป็นมาตรฐาน) และ --incompatible_strict_action_env (เพื่อปรับตัวแปรสภาพแวดล้อมให้เป็นมาตรฐาน)
- ค่าเริ่มต้น
--[no]incompatible_remote_downloader_send_all_headers
: "true" -
เลือกว่าจะส่งค่าทั้งหมดของส่วนหัวที่มีหลายค่าไปยังโปรแกรมดาวน์โหลดระยะไกลแทนที่จะส่งเฉพาะค่าแรกหรือไม่
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_remote_output_paths_relative_to_input_root
: "เท็จ" -
หากตั้งค่าเป็น "จริง" เส้นทางเอาต์พุตจะสัมพัทธ์กับรูทอินพุตแทนที่จะเป็นไดเรกทอรีที่ใช้งานได้
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
: "true" -
หากตั้งค่าเป็น "จริง" Bazel จะใช้โค้ดสำหรับออกใหม่ 39 แทน 34 หากแคชระยะไกลนำ BLOB ออกระหว่างบิลด์
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]remote_accept_cached
: "true" - เลือกว่าจะยอมรับผลการดำเนินการที่แคชไว้จากระยะไกลหรือไม่
- ค่าเริ่มต้น
--remote_build_event_upload=<all or minimal>
: "ขั้นต่ำ" - หากตั้งค่าเป็น "all" ระบบจะอัปโหลดเอาต์พุตในเครื่องทั้งหมดที่ BEP อ้างอิงไปยังแคชระยะไกล หากตั้งค่าเป็น "ค่าต่ำสุด" ระบบจะไม่อัปโหลดเอาต์พุตในเครื่องที่ BEP อ้างอิงไปยังแคชระยะไกล ยกเว้นไฟล์ที่มีความสำคัญต่อผู้บริโภคของ BEP (เช่น บันทึกการทดสอบและโปรไฟล์เวลา) รูปแบบ Bystream:// จะใช้สำหรับ uri ของไฟล์เสมอ แม้ว่าจะไม่มีในแคชระยะไกลก็ตาม ค่าเริ่มต้นคือ "ขั้นต่ำ"
- ค่าเริ่มต้น
--remote_bytestream_uri_prefix=<a string>
: ดูคำอธิบาย - ชื่อโฮสต์และชื่ออินสแตนซ์ที่จะใช้ใน URI ของ bytesstream:// ซึ่งเขียนลงในสตรีมเหตุการณ์ของบิลด์ ตัวเลือกนี้สามารถตั้งค่าได้เมื่อดำเนินการบิลด์โดยใช้พร็อกซี ซึ่งทำให้ค่าของ --remote_executor และ --remote_instance_name ไม่ตรงกับชื่อ Canonical ของบริการการดำเนินการระยะไกลอีกต่อไป หากไม่ได้ตั้งค่า จะมีค่าเริ่มต้นเป็น "${ชื่อโฮสต์}/${instance_name}"
- ค่าเริ่มต้น
--remote_cache=<a string>
: ดูคำอธิบาย - URI ของปลายทางการแคช สคีมาที่รองรับ ได้แก่ http, https, grpc, grpcs (grpc ที่เปิดใช้ TLS) และ unix (local UNIX Sockets) หากไม่ได้ระบุสคีมา Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุสคีมา grpc://, http:// หรือ unix: เพื่อปิดใช้ TLS ดู https://bazel.build/remote/caching
- ค่าเริ่มต้น
--[no]remote_cache_compression
: "เท็จ" - หากเปิดใช้ ให้บีบอัด/ยกเลิกการบีบอัด BLOB ของแคชที่มี zstd เมื่อขนาดเท่ากับ --experimental_remote_cache_compression_threshold เป็นอย่างน้อย
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--remote_cache_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอแคช: --remote_cache_header=Name=Value สามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--remote_default_exec_properties=<a 'name=value' assignment>
รายการ -
ตั้งค่าพร็อพเพอร์ตี้ exec เริ่มต้นที่จะใช้เป็นแพลตฟอร์มการดำเนินการระยะไกล หากแพลตฟอร์มการดำเนินการยังไม่ได้ตั้งค่า exec_properties
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--remote_default_platform_properties=<a string>
: "" - ตั้งค่าพร็อพเพอร์ตี้แพลตฟอร์มเริ่มต้นสำหรับ API การดำเนินการระยะไกล หากแพลตฟอร์มการดำเนินการยังไม่ได้ตั้งค่า Remote_execution_properties เอาไว้ ระบบจะใช้ค่านี้หากเลือกแพลตฟอร์มโฮสต์เป็นแพลตฟอร์มการดำเนินการสำหรับการดำเนินการระยะไกล
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--remote_download_regex=<a valid Java regular expression>
รายการ -
บังคับให้ดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลที่มีเส้นทางตรงกับรูปแบบนี้ โดยไม่คำนึงถึง --remote_download_outputs คุณสามารถระบุรูปแบบได้หลายรูปแบบด้วยการตั้งค่าสถานะนี้ซ้ำ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--remote_downloader_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอโปรแกรมดาวน์โหลดระยะไกล: --remote_downloader_header=Name=Value สามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--remote_exec_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอการดำเนินการ: --remote_exec_header=Name=Value สามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- ค่าเริ่มต้น
--remote_execution_priority=<an integer>
: "0" - ลำดับความสำคัญที่เกี่ยวข้องของการดำเนินการที่จะเรียกใช้จากระยะไกล ความหมายของค่าลำดับความสำคัญหนึ่งๆ จะขึ้นอยู่กับเซิร์ฟเวอร์
- ค่าเริ่มต้น
--remote_executor=<a string>
: ดูคำอธิบาย - HOST หรือ HOST:PORT ของปลายทางการดำเนินการระยะไกล สคีมาที่รองรับ ได้แก่ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (ซ็อกเก็ต UNIX ในเครื่อง) หากไม่ได้ระบุสคีมา Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุ grpc:// หรือ unix: สคีมาเพื่อปิดใช้ TLS
- ค่าเริ่มต้น
--remote_grpc_log=<a path>
: ดูคำอธิบาย - เส้นทางไปยังไฟล์เพื่อบันทึกรายละเอียดเกี่ยวกับการโทร gRPC หากระบุ บันทึกนี้ประกอบด้วยลำดับของ com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry protobufs ของแบบต่อเนื่อง โดยแต่ละข้อความจะมีคำนำหน้าเป็น varint ซึ่งแสดงขนาดของข้อความ protocolbuf แบบต่อเนื่องต่อไปนี้ โดยใช้เมธอด LogEntry.writeDelimitedTo(OutputStream)
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--remote_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอ: --remote_header=Name=Value สามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- ค่าเริ่มต้นของ
--remote_instance_name=<a string>
: "" - ค่าที่จะส่งผ่านเป็นอินสแตนซ์_name ใน API การดำเนินการระยะไกล
- ค่าเริ่มต้น
--[no]remote_local_fallback
: "เท็จ" - กลับไปใช้กลยุทธ์การดำเนินการภายในเครื่องแบบสแตนด์อโลนหรือไม่ หากการดำเนินการจากระยะไกลล้มเหลว
- ค่าเริ่มต้น
--remote_local_fallback_strategy=<a string>
: "ท้องถิ่น" - เลิกใช้งานแล้ว ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7480
- ค่าเริ่มต้น
--remote_max_connections=<an integer>
: "100" -
จำกัดจำนวนการเชื่อมต่อพร้อมกันสูงสุดให้กับแคช/ผู้ดำเนินการระยะไกล ค่าเริ่มต้นคือ 100 การตั้งค่านี้เป็น 0 หมายความว่าไม่มีข้อจำกัด
สำหรับแคชระยะไกล HTTP การเชื่อมต่อ TCP 1 รายการสามารถจัดการคำขอได้ครั้งละ 1 รายการ ดังนั้น Bazel สามารถสร้างคำขอพร้อมกันได้สูงสุด --remote_max_connections
สำหรับแคช/ผู้ดำเนินการระยะไกล gRPC ช่อง gRPC หนึ่งช่องมักจะรองรับคำขอพร้อมกันได้มากกว่า 100 คำขอ ดังนั้น Bazel จึงสามารถสร้างคำขอพร้อมกันประมาณ "--remote_max_connections * 100"
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้น
--remote_proxy=<a string>
: ดูคำอธิบาย - เชื่อมต่อกับแคชระยะไกลผ่านพร็อกซี ปัจจุบัน Flag นี้สามารถใช้เพื่อกำหนดค่า Socket ของโดเมน Unix (unix:/path/to/socket) เท่านั้น
- ค่าเริ่มต้น
--remote_result_cache_priority=<an integer>
: "0" - ลำดับความสำคัญที่เกี่ยวข้องของการดำเนินการระยะไกลที่จะจัดเก็บในแคชระยะไกล ความหมายของค่าลำดับความสำคัญหนึ่งๆ จะขึ้นอยู่กับเซิร์ฟเวอร์
- ค่าเริ่มต้น
--remote_retries=<an integer>
: "5" - จำนวนสูงสุดของความพยายามที่จะลองแก้ไขข้อผิดพลาดชั่วคราวอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
- ค่าเริ่มต้น
--remote_retry_max_delay=<An immutable length of time.>
: "5s" - การหน่วงเวลา Backoff สูงสุดระหว่างการพยายามลองอีกครั้งจากระยะไกล คุณสามารถใช้หน่วยต่อไปนี้: วัน (d), ชั่วโมง (h), นาที (m), วินาที และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
- ค่าเริ่มต้นของ
--remote_timeout=<An immutable length of time.>
: "60 วินาที" - ระยะเวลาสูงสุดในการรอการเรียกใช้จากระยะไกลและการเรียกใช้แคช สำหรับแคช REST นี่คือทั้งการเชื่อมต่อและระยะหมดเวลาในการอ่าน คุณสามารถใช้หน่วยต่อไปนี้: วัน (d), ชั่วโมง (h), นาที (m), วินาที และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
- ค่าเริ่มต้น
--[no]remote_upload_local_results
: "true" - เลือกว่าจะอัปโหลดผลลัพธ์การดำเนินการที่ดำเนินการในเครื่องไปยังแคชระยะไกลหรือไม่ หากแคชระยะไกลรองรับ และผู้ใช้ได้รับอนุญาตให้ดำเนินการดังกล่าว
- ค่าเริ่มต้น
--[no]remote_verify_downloads
: "true" - หากตั้งค่าเป็น "จริง" Bazel จะคำนวณจำนวนแฮชของการดาวน์โหลดระยะไกลทั้งหมด และทิ้งค่าที่แคชไว้จากระยะไกลหากไม่ตรงกับค่าที่คาดไว้
- ตัวเลือกเบ็ดเตล็ด ที่ยังไม่ได้รับการแยกประเภท:
- ค่าเริ่มต้น
--[no]allow_analysis_cache_discard
: "true" -
หากทิ้งแคชการวิเคราะห์เนื่องจากการเปลี่ยนแปลงในระบบบิลด์ การตั้งค่าตัวเลือกนี้เป็น "เท็จ" จะทำให้ระบบออก bazel แทนที่จะดำเนินการต่อด้วยบิลด์ ตัวเลือกนี้ไม่มีผลเมื่อ "discard_analysis_cache" ก็มีการตั้งค่าเช่นกัน
แท็ก:eagerness_to_exit
- ค่าเริ่มต้น
--auto_output_filter=<none, all, packages or subpackages>
: "ไม่มี" - หากไม่ได้ระบุ --output_filter ระบบจะใช้ค่าของตัวเลือกนี้ในการสร้างตัวกรองโดยอัตโนมัติ ค่าที่ใช้ได้คือ "none" (ไม่ต้องกรอง / แสดงทุกอย่าง), "ทั้งหมด" (กรองทุกอย่าง / ไม่แสดงอะไรเลย), "แพ็กเกจ" (รวมเอาต์พุตจากกฎในแพ็กเกจที่กล่าวถึงในบรรทัดคำสั่ง Blaze) และ "แพ็กเกจย่อย" (เช่น "แพ็กเกจ" แต่รวมแพ็กเกจย่อยด้วย) สำหรับ "แพ็กเกจ" และ "แพ็กเกจย่อย" //java/foo และ //javatests/foo จะถือว่าเป็น 1 แพ็กเกจ)'
- ค่าเริ่มต้น
--[no]build_manual_tests
: "เท็จ" - บังคับใช้เป้าหมายการทดสอบที่ติดแท็ก "ด้วยตนเอง" ให้เกิดขึ้นจริง "ด้วยตนเอง" การทดสอบจะไม่รวมอยู่ในการประมวลผล ตัวเลือกนี้จะบังคับให้ระบบสร้างรายงาน (แต่ไม่ต้องดำเนินการ)
- ค่าเริ่มต้นของ
--build_tag_filters=<comma-separated list of options>
: "" - ระบุรายการแท็กที่คั่นด้วยคอมมา แต่ละแท็กสามารถขึ้นต้นด้วย "-" หรือไม่ก็ได้ เพื่อระบุแท็กที่ยกเว้น ระบบจะสร้างเฉพาะเป้าหมายเหล่านั้นซึ่งมีแท็กที่รวมอยู่อย่างน้อย 1 แท็กและไม่มีแท็กที่ยกเว้น ตัวเลือกนี้ไม่มีผลกับชุดการทดสอบที่ดำเนินการด้วยคำสั่ง "test" (ทดสอบ) คำสั่ง; การควบคุมเหล่านั้นจะอยู่ภายใต้ตัวเลือกการกรองทดสอบ เช่น "--test_tag_filters"
- ค่าเริ่มต้น
--[no]build_tests_only
: "เท็จ" - หากระบุ ระบบจะสร้างเฉพาะกฎ *_test และ test_suite และจะไม่สนใจเป้าหมายอื่นๆ ที่ระบุในบรรทัดคำสั่ง โดยค่าเริ่มต้น ทุกอย่างที่ขอจะได้รับการสร้าง
- ค่าเริ่มต้น
--combined_report=<none or lcov>
: "ไม่มี" - ระบุประเภทรายงานความครอบคลุมสะสมที่ต้องการ ขณะนี้ระบบรองรับเฉพาะ LCOV เท่านั้น
- ค่าเริ่มต้น
--[no]compile_one_dependency
: "เท็จ" - คอมไพล์ทรัพยากร Dependency เดียวของไฟล์อาร์กิวเมนต์ วิธีนี้มีประโยชน์ในการตรวจสอบไฟล์แหล่งที่มาใน IDE เช่น การสร้างเป้าหมายเดี่ยวขึ้นมาใหม่ให้อาศัยไฟล์ต้นฉบับ เพื่อตรวจหาข้อผิดพลาดให้เร็วที่สุดในรอบการแก้ไข/สร้าง/ทดสอบ อาร์กิวเมนต์นี้จะส่งผลต่อวิธีการตีความอาร์กิวเมนต์แบบไม่แจ้งทั้งหมด แทนที่จะกำหนดเป้าหมายในการสร้างเป็นชื่อไฟล์ต้นฉบับ สำหรับชื่อไฟล์ต้นฉบับแต่ละชื่อไฟล์ จะมีเป้าหมายที่กำหนดเองที่ขึ้นอยู่กับไฟล์ดังกล่าว
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--deleted_packages=<comma-separated list of package names>
รายการ - รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริงแม้ว่าจะปรากฏอยู่ที่ใดที่หนึ่งบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ เช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์ ระบบบิลด์อาจบ่นหากพบป้ายกำกับ "//x:y/z" ถ้ามีข้อมูลระบุโดยรายการpackage_path อื่นอยู่ การระบุ --deleted_packages x/y ช่วยป้องกันปัญหานี้
- ค่าเริ่มต้น
--[no]discard_analysis_cache
: "เท็จ" - ทิ้งแคชการวิเคราะห์ทันทีหลังจากที่ขั้นตอนการวิเคราะห์เสร็จสมบูรณ์แล้ว ลดการใช้งานหน่วยความจำประมาณ 10% แต่ทำให้บิลด์เพิ่มเติมช้าลง
- ค่าเริ่มต้น
--disk_cache=<a path>
: ดูคำอธิบาย - เส้นทางไปยังไดเรกทอรีที่ Bazel อ่านและเขียนการดำเนินการและเอาต์พุตการดำเนินการได้ หากไม่มีไดเรกทอรี ระบบจะสร้างไดเรกทอรีให้
- ค่าเริ่มต้นของ
--embed_label=<a one-line string>
: "" - ฝังการแก้ไขการควบคุมแหล่งที่มาหรือป้ายกำกับรุ่นในไบนารี
- ค่าเริ่มต้น
--execution_log_binary_file=<a path>
: ดูคำอธิบาย - บันทึกการสร้างที่เรียกใช้ลงในไฟล์นี้เป็นโปรโตคอลของ SpawnExec ที่คั่นด้วยความยาว ตามข้อมูลใน src/main/prodbuf/spawn.protocol แฟล็กที่เกี่ยวข้อง: --execution_log_json_file (รูปแบบข้อความ JSON แยกกัน), --execution_log_sort (ไม่ว่าจะจัดเรียงบันทึกการดำเนินการหรือไม่), --subcommands (สำหรับการแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
- ค่าเริ่มต้น
--execution_log_json_file=<a path>
: ดูคำอธิบาย - บันทึกการสร้างที่เรียกใช้ลงในไฟล์นี้เป็นการแสดง JSON ของ SpawnExec ที่คั่นด้วยการขึ้นบรรทัดใหม่ ตามข้อมูลใน src/main/protobuf/spawn.proto แฟล็กที่เกี่ยวข้อง: --execution_log_binary_file (รูปแบบไบนารี Protobuf, แยกเฉพาะ), --execution_log_sort (ไม่ว่าจะจัดเรียงบันทึกการดำเนินการหรือไม่), --subcommands (สำหรับการแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
- ค่าเริ่มต้น
--[no]execution_log_sort
: "true" - เลือกว่าจะจัดเรียงบันทึกการดำเนินการหรือไม่ เพื่อให้เปรียบเทียบบันทึกระหว่างการเรียกใช้ได้ง่ายขึ้น ตั้งค่าเป็น "เท็จ" เพื่อหลีกเลี่ยงการใช้ CPU และหน่วยความจำที่อาจเกิดขึ้นอย่างมากเมื่อสิ้นสุดการเรียกใช้ โดยสร้างบันทึกในลำดับการดำเนินการแบบไม่กำหนดทิศทาง ใช้กับรูปแบบไบนารีและ JSON เท่านั้น ระบบจะไม่จัดเรียงรูปแบบกะทัดรัด
- ค่าเริ่มต้น
--[no]expand_test_suites
: "true" -
ขยายเป้าหมาย test_suite ไปยังการทดสอบส่วนประกอบก่อนการวิเคราะห์ เมื่อเปิดธงนี้ (ค่าเริ่มต้น) ระบบจะใช้รูปแบบเป้าหมายเชิงลบกับการทดสอบที่เป็นของชุดทดสอบ มิฉะนั้น ระบบจะไม่ใช้รูปแบบเป้าหมายเชิงลบ การปิดแฟล็กนี้มีประโยชน์เมื่อใช้ระดับบนสุดในบรรทัดคำสั่ง จากนั้นผู้ใช้จึงวิเคราะห์เป้าหมาย test_suite ได้
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--experimental_disk_cache_max_size=<a size in bytes, optionally followed by a K, M, G or T multiplier>
: "0" - ไม่พร้อมใช้งาน
- ค่าเริ่มต้น
--experimental_execution_log_compact_file=<a path>
: ดูคำอธิบาย - บันทึกการสร้างที่เรียกใช้ลงในไฟล์นี้เป็นโปรโต ExecLogEntry ของ ExecLogEntry ที่คั่นด้วยความยาวตามข้อมูลใน src/main/protocolbuf/spawn.protocol ไฟล์ทั้งไฟล์ถูกบีบอัดแบบ zstd นี่คือรูปแบบทดลองที่อยู่ระหว่างการพัฒนา และอาจเปลี่ยนแปลงได้ตลอดเวลา แฟล็กที่เกี่ยวข้อง: --execution_log_binary_file (รูปแบบไบนารี Protobuf; แยกเฉพาะ), --execution_log_json_file (รูปแบบข้อความ JSON; แยกไว้ต่างหาก), --subcommands (สำหรับแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
- ค่าเริ่มต้นของ
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "" - เลิกใช้งานไปทีละด้าน ชุดตัวกรองเป้าหมายเพื่อตั้งเวลา extra_actions
- ค่าเริ่มต้น
--[no]experimental_extra_action_top_level_only
: "เท็จ" - เลิกใช้งานไปทีละด้าน ตั้งเวลาให้เฉพาะการดำเนินการเพิ่มเติมสำหรับเป้าหมายระดับบนสุดเท่านั้น
--experimental_spawn_scheduler
-
เปิดใช้การดำเนินการแบบไดนามิกโดยเรียกใช้การดำเนินการภายในเครื่องและจากระยะไกลพร้อมกัน Bazel สร้างการดำเนินการแต่ละอย่างไว้ภายในเครื่องและจากระยะไกล แล้วเลือกการดำเนินการที่เสร็จสิ้นก่อน หากการดำเนินการรองรับผู้ปฏิบัติงาน การดำเนินการเฉพาะเครื่องจะทำงานในโหมดผู้ปฏิบัติงานถาวร หากต้องการเปิดใช้การดำเนินการแบบไดนามิกสำหรับหน่วยความจำการดำเนินการแต่ละรายการ ให้ใช้แฟล็ก "--internal_spawn_scheduler" และ "--strategy=<mnemonic>=dynamic" แทน
ขยายเป็น
--internal_spawn_scheduler
--spawn_strategy=dynamic
- ค่าเริ่มต้น
--[no]fetch
: "true" - อนุญาตให้คำสั่งดึงข้อมูลทรัพยากร Dependency ภายนอก หากตั้งค่าเป็น "เท็จ" คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ และหากไม่มี คำสั่งดังกล่าวจะทำให้การทำงานล้มเหลว
- ค่าเริ่มต้น
--local_termination_grace_seconds=<an integer>
: "15" - เวลาที่ต้องรอระหว่างการสิ้นสุดกระบวนการในเครื่องเนื่องจากหมดเวลาและบังคับปิดกระบวนการดังกล่าว
- ค่าเริ่มต้นของ
--package_path=<colon-separated list of options>
: "%workspace%" - รายการตำแหน่งที่จะค้นหาแพ็กเกจที่คั่นด้วยโคลอน องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับพื้นที่ทำงานที่ล้อมรอบอยู่ หากไม่ระบุหรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
- ค่าเริ่มต้น
--[no]show_loading_progress
: "true" - หากเปิดใช้ จะทำให้ Bazel พิมพ์ "กำลังโหลดแพ็กเกจ:" ข้อความ
- ค่าเริ่มต้นของ
--test_lang_filters=<comma-separated list of options>
: "" - ระบุรายการภาษาทดสอบที่คั่นด้วยคอมมา แต่ละภาษาอาจนำหน้าด้วย '-' หรือไม่ก็ได้ เพื่อระบุภาษาที่ยกเว้น ระบบจะพบเฉพาะเป้าหมายทดสอบเหล่านั้นที่ใช้ภาษาที่ระบุ ชื่อที่ใช้สำหรับแต่ละภาษาควรเหมือนกับคำนำหน้าภาษาในกฎ *_test เช่น หนึ่งใน "cc", 'java', 'py' ฯลฯ ตัวเลือกนี้ส่งผลต่อพฤติกรรม --build_tests_only พฤติกรรม และคำสั่งทดสอบ
- ค่าเริ่มต้นของ
--test_size_filters=<comma-separated list of values: small, medium, large, or enormous>
: "" - ระบุรายการขนาดทดสอบที่คั่นด้วยคอมมา แต่ละขนาดจะมีเครื่องหมาย "-" นำหน้าได้ เพื่อระบุขนาดที่ยกเว้น ระบบจะพบว่าเป้าหมายทดสอบเหล่านั้นมีขนาดอย่างน้อย 1 ขนาดและไม่มีขนาดที่ยกเว้น ตัวเลือกนี้จะมีผลกับลักษณะการทำงาน --build_tests_only และคำสั่งทดสอบ
- ค่าเริ่มต้นของ
--test_tag_filters=<comma-separated list of options>
: "" - ระบุรายการแท็กทดสอบที่คั่นด้วยคอมมา แต่ละแท็กสามารถขึ้นต้นด้วย "-" หรือไม่ก็ได้ เพื่อระบุแท็กที่ยกเว้น และจะพบว่าเป้าหมายทดสอบเหล่านั้นมีแท็กที่รวมไว้อย่างน้อย 1 แท็กและไม่มีแท็กที่ยกเว้น ตัวเลือกนี้จะมีผลกับลักษณะการทำงาน --build_tests_only และคำสั่งทดสอบ
- ค่าเริ่มต้นของ
--test_timeout_filters=<comma-separated list of values: short, moderate, long, or eternal>
: "" - ระบุรายการระยะหมดเวลาของการทดสอบที่คั่นด้วยคอมมา ระยะหมดเวลาแต่ละครั้งจะมีเครื่องหมาย "-" นำหน้าได้ เพื่อระบุการหมดเวลาที่ยกเว้น ระบบจะพบเฉพาะเป้าหมายทดสอบเหล่านั้นที่มีระยะหมดเวลาอย่างน้อย 1 รายการและไม่มีระยะหมดเวลาที่ยกเว้น ตัวเลือกนี้จะมีผลกับลักษณะการทำงาน --build_tests_only และคำสั่งทดสอบ
- ค่าเริ่มต้นของ
--workspace_status_command=<path>
: "" - คำสั่งที่เรียกใช้ในตอนต้นของบิลด์เพื่อให้ข้อมูลสถานะเกี่ยวกับพื้นที่ทำงานในรูปแบบคู่คีย์/ค่า โปรดดูคู่มือผู้ใช้เพื่อดูข้อกำหนดทั้งหมด นอกจากนี้ โปรดดูเครื่องมือ/buildstamp/get_workspace_status เป็นต้น
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์:
- ค่าเริ่มต้น
--[no]experimental_inprocess_symlink_creation
: "เท็จ" -
เลือกว่าจะเรียกใช้ระบบไฟล์โดยตรงเพื่อสร้างต้นไม้ Symlink หรือไม่
แท็ก:loading_and_analysis
,execution
,experimental
- ค่าเริ่มต้น
--[no]experimental_persistent_aar_extractor
: "เท็จ" -
เปิดใช้เครื่องมือแยก Aar แบบถาวรโดยใช้ผู้ปฏิบัติงาน
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_remotable_source_manifests
: "เท็จ" -
ต้องการให้การดำเนินการในไฟล์ Manifest ของแหล่งที่มาทำซ้ำได้หรือไม่
แท็ก:loading_and_analysis
,execution
,experimental
- ค่าเริ่มต้น
--[no]experimental_split_coverage_postprocessing
: "เท็จ" -
หากเป็น "จริง" Bazel จะดำเนินการประมวลผลภายหลังสำหรับการครอบคลุมในการทดลองที่สร้างขึ้นใหม่
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_strict_fileset_output
: "เท็จ" -
หากเปิดใช้ตัวเลือกนี้ ชุดไฟล์จะถือว่าอาร์ติแฟกต์เอาต์พุตทั้งหมดเป็นไฟล์ทั่วไป โดยจะไม่ข้ามผ่านไดเรกทอรีหรือไวต่อลิงก์สัญลักษณ์
แท็ก:execution
- ค่าเริ่มต้น
--[no]incompatible_modify_execution_info_additive
: "เท็จ" -
เมื่อเปิดใช้ การส่งแฟล็ก --modify_execution_info หลายรายการจะเป็นแบบบวกเพิ่ม เมื่อปิดใช้ ระบบจะพิจารณาเฉพาะธงล่าสุดเท่านั้น
แท็ก:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
รายการ -
เพิ่มหรือนำคีย์ออกจากข้อมูลการดำเนินการของการดำเนินการตามความสามารถในการจำการดำเนินการ ใช้กับการดำเนินการที่รองรับข้อมูลการดำเนินการเท่านั้น การดำเนินการทั่วไปจำนวนมากรองรับข้อมูลการดำเนินการ เช่น Genrule, CppCompile, Javac, StarlarkAction, TestRunner เมื่อระบุค่าหลายค่า ลำดับมีความสำคัญเนื่องจาก regexe หลายรายการอาจใช้กับช่วยจำเดียวกันได้
ไวยากรณ์: "regex=[+-]key,regex=[+-]key,..."
ตัวอย่าง:
'.*=+x,.*=-y,.*=+z' เพิ่ม "x" และ "z" ถึง และนำ "y" ออก ข้อมูลการดำเนินการสำหรับการดำเนินการทั้งหมด
'Genrule=+requires-x' เพิ่ม "requires-x" กับข้อมูลการดำเนินการสำหรับการดำเนินการ Genrule ทั้งหมด
'(?!Genrule).*=-requires-x' นำ "requires-x" ออก จากข้อมูลการดำเนินการสำหรับการดำเนินการ
ที่ไม่ใช่ Genrule ทั้งหมด
แท็ก:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
เปิดใช้การดำเนินการ Dex และ desugar ของ Android แบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
แท็ก:host_machine_resource_optimizations
execution
--persistent_android_resource_processor
-
เปิดใช้ผู้ประมวลผลข้อมูลทรัพยากร Android ถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
เปิดใช้การดำเนินการ Dex และ desugar ของ Android แบบมัลติเพล็กซ์โดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
เปิดใช้เครื่องมือประมวลผลทรัพยากร Android แบบมัลติเพล็กซ์แบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
เปิดใช้เครื่องมือ Android แบบต่อเนื่องและแบบมัลติเพล็กซ์ (Dexing, Deugaring, Resource Operations)
ขยายเป็น
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
แท็ก:host_machine_resource_optimizations
execution
- ค่าเริ่มต้น
--[no]use_target_platform_for_tests
: "เท็จ" -
หากเป็น "จริง" Bazel จะใช้แพลตฟอร์มเป้าหมายในการทำการทดสอบแทนกลุ่มผู้บริหารทดสอบ
แท็ก:execution
- ตัวเลือกที่กำหนดค่า Toolchain ที่ใช้สำหรับการดำเนินการมีดังนี้
- ค่าเริ่มต้น
--android_compiler=<a string>
: ดูคำอธิบาย -
คอมไพเลอร์เป้าหมายของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_manifest_merger=<legacy, android or force_android>
: "android" -
เลือกการควบรวมไฟล์ Manifest ที่จะใช้กับกฎ android_binary แจ้งเพื่อช่วยให้เปลี่ยนไปใช้การผสานรวมไฟล์ Manifest ของ Android จากการควบรวมเดิม
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_platforms=<a build target label>
: "" -
ตั้งค่าแพลตฟอร์มที่ android_binary กำหนดเป้าหมายใช้ หากระบุหลายแพลตฟอร์ม ไบนารีนั้นจะเป็น APK แบบอ้วน ซึ่งมีไบนารีแบบเนทีฟสำหรับแต่ละแพลตฟอร์มเป้าหมายที่ระบุ
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_sdk=<a build target label>
: "@bazel_tools//tools/android:sdk" -
ระบุ SDK/แพลตฟอร์ม Android ที่ใช้สร้างแอปพลิเคชัน Android
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้ในกฎของ Apple และ Objc และทรัพยากร Dependency
แท็ก:loses_incremental_state
changes_inputs
- ค่าเริ่มต้นของ
--cc_output_directory_tag=<a string>
: "" -
ระบุคำต่อท้ายที่จะเพิ่มในไดเรกทอรีการกำหนดค่า
แท็ก:affects_outputs
- ค่าเริ่มต้น
--compiler=<a string>
: ดูคำอธิบาย -
คอมไพเลอร์ C++ ที่จะใช้สำหรับการคอมไพล์เป้าหมาย
แท็ก:loading_and_analysis
execution
--coverage_output_generator=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:lcov_merger"-
ตำแหน่งของไบนารีที่ใช้เพื่อประมวลผลรายงานการครอบคลุมแบบข้อมูลดิบหลังการประมวลผล ซึ่งต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งก็คือไบนารี ค่าเริ่มต้นคือ "//tools/test:lcov_merger"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_report_generator"-
ตําแหน่งของไบนารีที่ใช้สร้างรายงานการครอบคลุม ซึ่งต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งก็คือไบนารี ค่าเริ่มต้นคือ "//tools/test:coverage_report_generator"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_support"-
ตำแหน่งของไฟล์สนับสนุนที่จำเป็นต้องใช้ในอินพุตของการดำเนินการทดสอบทั้งหมดที่รวบรวมการครอบคลุมของโค้ด ค่าเริ่มต้นคือ "//tools/test:coverage_support"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--custom_malloc=<a build target label>
: ดูคำอธิบาย -
ระบุการใช้งาน Malloc ที่กำหนดเอง การตั้งค่านี้จะลบล้างแอตทริบิวต์ Malloc ในกฎบิลด์
แท็ก:changes_inputs
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
รายการ -
รายการนิพจน์ทั่วไปที่คั่นด้วยคอมมา แต่ละรายการจะมีคำนำหน้าด้วย - (นิพจน์เชิงลบ) และกำหนด (=) ให้กับรายการเป้าหมายค่าข้อจำกัดที่คั่นด้วยคอมมา หากเป้าหมายตรงกับที่ไม่มีนิพจน์เชิงลบ และนิพจน์เชิงบวกอย่างน้อย 1 รายการ การแปลง Toolchain จะดำเนินการเสมือนว่าได้ประกาศค่าข้อจำกัดเป็นข้อจำกัดการดำเนินการ ตัวอย่าง: //demo,-test=@platforms//cpus:x86_64 จะเพิ่ม "x86_64" ไปยังเป้าหมายใดๆ ภายใต้ //demo ยกเว้นเป้าหมายที่ชื่อมี "test"
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_include_xcode_execution_requirements
: "เท็จ" -
เมื่อตั้งค่าแล้ว ให้เพิ่ม "requires-xcode:{version}" สำหรับการดำเนินการของ Xcode ทุกครั้ง หากเวอร์ชัน Xcode มีป้ายกำกับขีดกลาง ให้เพิ่ม "requires-xcode-label:{version_label}" ด้วย ข้อกำหนดของการดำเนินการ
แท็ก:loses_incremental_state
,loading_and_analysis
,execution
- ค่าเริ่มต้น
--[no]experimental_prefer_mutual_xcode
: "true" -
หากเป็นจริง ให้ใช้ Xcode ล่าสุดที่พร้อมใช้งานทั้งในเครื่องและจากระยะไกล หากเป็นเท็จหรือไม่มีเวอร์ชันที่ใช้ร่วมกัน ให้ใช้เวอร์ชันของ Xcode ในเครื่องที่เลือกผ่าน xcode-select
แท็ก:loses_incremental_state
- ค่าเริ่มต้นของ
--extra_execution_platforms=<comma-separated list of options>
: "" -
แพลตฟอร์มที่มีให้ใช้งานเป็นแพลตฟอร์มการดำเนินการเพื่อเรียกใช้การดำเนินการ สามารถระบุแพลตฟอร์มโดยเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมาย แพลตฟอร์มเหล่านี้จะได้รับการพิจารณาก่อนแพลตฟอร์มที่ประกาศในไฟล์ WORKSPACE โดยregister_execution_platforms() ตัวเลือกนี้ตั้งค่าได้เพียงครั้งเดียว อินสแตนซ์ภายหลังจะลบล้างการตั้งค่าแฟล็กก่อนหน้า
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--extra_toolchains=<comma-separated list of options>
รายการ -
กฎ Toolchain ที่จะต้องพิจารณาระหว่างการแก้ไข Toolchain สามารถระบุ Toolchains ตามเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมายได้ ระบบจะพิจารณา Toolchain เหล่านี้ก่อนการประกาศในไฟล์ WORKSPACE โดยregister_toolchains()
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--grte_top=<a label>
: ดูคำอธิบาย -
ป้ายกำกับไปยังไลบรารี libc ที่มีการเช็คอิน Crosstool Toolchain จะเลือกค่าเริ่มต้นและคุณแทบจะไม่จำเป็นต้องลบล้างค่าเริ่มต้น
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--host_compiler=<a string>
: ดูคำอธิบาย -
แฟล็กที่ไม่มีการดำเนินการ ระบบจะนำออกในรุ่นถัดไป
แท็ก:loading_and_analysis
execution
- ค่าเริ่มต้น
--host_grte_top=<a label>
: ดูคำอธิบาย -
ถ้าระบุ การตั้งค่านี้จะลบล้างไดเรกทอรีระดับบนสุดของ libc (--grte_top) สำหรับการกำหนดค่าผู้บริหาร
แท็ก:action_command_lines
affects_outputs
--host_platform=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools:host_platform"-
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายระบบโฮสต์
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--[no]incompatible_bazel_test_exec_run_under
: "เท็จ" -
หากเปิดใช้ "การทดสอบ bazel --run_under=//:runner" บิลด์ "//:runner" ในการกำหนดค่า exec หากปิดใช้ จะสร้าง "//:runner" ในการกำหนดค่าเป้าหมาย Bazel ทำการทดสอบบนเครื่องปฏิบัติการ ดังนั้นเครื่องแรกจึงถูกต้องกว่า ซึ่งไม่ส่งผลกับ "Bazel Run" ซึ่งจะสร้าง "`--run_under=//foo" เสมอ ในการกำหนดค่าเป้าหมาย
แท็ก:affects_outputs
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_apple_toolchain_resolution
: "เท็จ" -
ใช้ความละเอียดของ Toolchain เพื่อเลือก Apple SDK สำหรับกฎของ Apple (Starlark และเนทีฟ)
แท็ก: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_strip_executable_safely
: "เท็จ" -
หากเป็น "จริง" การดำเนินการตัดไฟล์สำหรับไฟล์ปฏิบัติการจะใช้แฟล็ก -x ซึ่งไม่ส่งผลกับความละเอียดของสัญลักษณ์แบบไดนามิก
แท็ก:action_command_lines
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
,immutable
- ค่าเริ่มต้นของ
--platforms=<a build target label>
: "" -
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายแพลตฟอร์มเป้าหมายสำหรับคำสั่งปัจจุบัน
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--python_path=<a string>
: ดูคำอธิบาย -
Absolute Path ของล่าม Python มีการเรียกใช้เป้าหมาย Python บนแพลตฟอร์มเป้าหมาย เลิกใช้งาน; ปิดใช้งานโดย --incompatible_use_python_toolchains
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้น
--python_top=<a build target label>
: ดูคำอธิบาย -
ป้ายกำกับของ py_runtime ที่แทนอินเทอร์พรีเตอร์ Python ได้มีการเรียกให้เรียกใช้เป้าหมาย Python บนแพลตฟอร์มเป้าหมาย เลิกใช้งาน; ปิดใช้งานโดย --incompatible_use_python_toolchains
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้น
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
ระบุเวอร์ชันของ tvOS SDK ที่จะใช้สร้างแอปพลิเคชัน tvOS หากไม่ระบุ ระบบจะใช้เวอร์ชันเริ่มต้นของ tvOS SDK จาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
ระบุเวอร์ชันของ WatchOS SDK ที่จะใช้สร้างแอปพลิเคชัน watchOS หากไม่ระบุ ระบบจะใช้เวอร์ชัน WatchOS SDK เริ่มต้นจาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--xcode_version=<a string>
: ดูคำอธิบาย -
หากระบุไว้ ให้ใช้ Xcode ของเวอร์ชันที่ระบุสำหรับการดำเนินการของบิลด์ที่เกี่ยวข้อง หากไม่ระบุ ระบบจะใช้ Xcode เวอร์ชันเริ่มต้นของผู้ดำเนินการ
แท็ก:loses_incremental_state
--xcode_version_config=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:host_xcodes"-
ป้ายกำกับของกฎ xcode_config ที่จะใช้สำหรับเลือกเวอร์ชัน Xcode ในการกำหนดค่าบิลด์
แท็ก:loses_incremental_state
loading_and_analysis
- มีดังนี้
- ค่าเริ่มต้น
--[no]apple_generate_dsym
: "เท็จ" -
เลือกว่าจะสร้างไฟล์สัญลักษณ์การแก้ไขข้อบกพร่อง (.dSYM) หรือไม่
แท็ก:affects_outputs
action_command_lines
- ค่าเริ่มต้น
--[no]build_runfile_links
: "true" -
หากเป็น "จริง" ให้สร้างศูนย์การเรียกใช้ไฟล์ symlink สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้เขียนเมื่อต้องใช้การดำเนินการในเครื่อง ทดสอบ หรือเรียกใช้คำสั่งเท่านั้น
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]build_runfile_manifests
: "true" -
หากเป็น "จริง" ให้เขียนไฟล์ Manifest ของการเรียกใช้ไฟล์สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้ละเว้น การทดสอบในเครื่องจะทํางานไม่ได้หากเป็นเท็จ
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]build_test_dwp
: "เท็จ" -
หากเปิดใช้ เมื่อสร้างการทดสอบ C++ แบบคงที่ และด้วยฟิชชัน ไฟล์ .dwp สำหรับไบนารีการทดสอบจะสร้างขึ้นโดยอัตโนมัติเช่นกัน
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้นของ
--cc_proto_library_header_suffixes=<comma-separated set of options>
: ".pb.h" -
ตั้งค่าคำต่อท้ายของไฟล์ส่วนหัวที่ cc_proto_library สร้างขึ้น
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--cc_proto_library_source_suffixes=<comma-separated set of options>
: ".pb.cc" -
ตั้งค่าคำต่อท้ายของไฟล์ต้นฉบับที่ cc_protocol_library สร้างขึ้น
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_proto_descriptor_sets_include_source_info
: "เท็จ" -
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันอื่นๆ ใน protocol_library
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_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
- ค่าเริ่มต้น
--[no]android_databinding_use_androidx
: "true" -
สร้างไฟล์การเชื่อมโยงข้อมูลที่ใช้กับ AndroidX ได้ ใช้ได้เฉพาะกับการเชื่อมโยงข้อมูล v2 เท่านั้น แฟล็กนี้ไม่มีการใช้งาน
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]android_databinding_use_v3_4_args
: "true" -
ใช้ Android Databinding v2 ที่มีอาร์กิวเมนต์ 3.4.0 แฟล็กนี้ไม่มีการใช้งาน
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้นของ
--android_dynamic_mode=<off, default or fully>
: "ปิด" -
กำหนดว่าจะให้ลิงก์ C++ ของกฎ Android แบบไดนามิกหรือไม่ เมื่อ cc_binary ไม่ได้สร้างไลบรารีที่ใช้ร่วมกันอย่างชัดแจ้ง "ค่าเริ่มต้น" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "สมบูรณ์" หมายความว่าไลบรารีทั้งหมดจะลิงก์แบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "ตามตัวอักษร" -
ตั้งค่าลำดับของไฟล์ Manifest ที่ส่งไปยังการรวมไฟล์ Manifest สำหรับไบนารีของ Android อัลฟ่าหมายความว่าไฟล์ Manifest ได้รับการจัดเรียงตามเส้นทางที่สัมพันธ์กับผู้ดำเนินการ ALPHABETICAL_BY_CONFIGURATION หมายความว่าไฟล์ Manifest ได้รับการจัดเรียงตามเส้นทางที่สัมพันธ์กับไดเรกทอรีการกำหนดค่าภายในไดเรกทอรีเอาต์พุต DEPENDENCY หมายความว่าไฟล์ Manifest จะเรียงลำดับตามไฟล์ Manifest ของไลบรารีแต่ละรายการที่อยู่ก่อนไฟล์ Manifest ของทรัพยากร Dependency
แท็ก:action_command_lines
execution
- ค่าเริ่มต้น
--[no]android_resource_shrinking
: "เท็จ" -
เปิดใช้การย่อทรัพยากรสำหรับ APK android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]build_python_zip
: "อัตโนมัติ" -
สร้าง ZIP ที่เป็นไฟล์ปฏิบัติการ Python ใน Windows และปิดบนแพลตฟอร์มอื่น
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--catalyst_cpus=<comma-separated list of options>
รายการ -
รายชื่อสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple Catalyst
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--[no]collect_code_coverage
: "เท็จ" -
หากระบุไว้ Bazel จะใช้โค้ดเครื่องมือวัด (โดยใช้การใช้เครื่องมือแบบออฟไลน์หากเป็นไปได้) และจะรวบรวมข้อมูลการครอบคลุมระหว่างการทดสอบ เฉพาะเป้าหมายที่ตรงกับ --instrumentation_filter จะได้รับผลกระทบ โดยปกติ ตัวเลือกนี้ไม่ควรระบุโดยตรง - "ความครอบคลุมของbazel" ควรใช้คำสั่งแทน
แท็ก:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] ค่าเริ่มต้น: "fastbuild"-
ระบุโหมดที่จะมีการสร้างไบนารี ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--conlyopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--copt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง gcc
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้นของ
--cpu=<a string>
: "" -
CPU เป้าหมาย
แท็ก:changes_inputs
affects_outputs
- ค่าเริ่มต้น
--cs_fdo_absolute_path=<a string>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ CSFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อเส้นทางสัมบูรณ์ของไฟล์ ZIP ที่มีไฟล์โปรไฟล์, ไฟล์ข้อมูล RAW หรือไฟล์โปรไฟล์ LLVM ที่จัดทำดัชนีไว้
แท็ก:affects_outputs
- ค่าเริ่มต้น
--cs_fdo_instrument=<a string>
: ดูคำอธิบาย -
สร้างไบนารีด้วยเครื่องมือ FDO ที่ละเอียดอ่อนตามบริบท เมื่อใช้คอมไพเลอร์ Clang/LLVM คีย์ดังกล่าวจะยอมรับชื่อไดเรกทอรีที่ระบบจะส่งออกไฟล์โปรไฟล์แบบ RAW ขณะรันไทม์ด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--cs_fdo_profile=<a build target label>
: ดูคำอธิบาย -
cs_fdo_profile แสดงถึงโปรไฟล์ที่ละเอียดอ่อนตามบริบทที่จะใช้ในการเพิ่มประสิทธิภาพ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--cxxopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C++
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--define=<a 'name=value' assignment>
รายการ -
ตัวเลือก --define แต่ละรายการจะระบุการมอบหมายสำหรับตัวแปรบิลด์ ในกรณีที่ตัวแปรหนึ่งมีค่าหลายค่า ค่าสุดท้ายจะชนะ
แท็ก:changes_inputs
affects_outputs
- ค่าเริ่มต้น
--dynamic_mode=<off, default or fully>
: "ค่าเริ่มต้น" -
กำหนดว่าจะลิงก์ไบนารีของ C++ แบบไดนามิกหรือไม่ "ค่าเริ่มต้น" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "สมบูรณ์" หมายความว่าไลบรารีทั้งหมดจะลิงก์แบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้น
--[no]enable_propeller_optimize_absolute_paths
: "true" -
หากตั้งค่าไว้ การใช้เส้นทางสัมบูรณ์สำหรับการเพิ่มประสิทธิภาพใบพัดจะทำให้เกิดข้อผิดพลาด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]enable_remaining_fdo_absolute_paths
: "true" -
ถ้ามีการตั้งค่า การใช้เส้นทางสัมบูรณ์สำหรับ FDO จะทำให้เกิดข้อผิดพลาด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]enable_runfiles
: "อัตโนมัติ" -
เปิดใช้โครงสร้างลิงก์สัญลักษณ์ของ Runfiles ซึ่งโดยค่าเริ่มต้น จะปิดอยู่ใน Windows และในแพลตฟอร์มอื่นๆ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_action_listener=<a build target label>
รายการ -
เลิกใช้งานไปทีละด้าน ใช้ action_listener เพื่อแนบทางลัดไปยังการดำเนินการบิลด์ที่มีอยู่
แท็ก:execution
experimental
- ค่าเริ่มต้น
--[no]experimental_android_compress_java_resources
: "เท็จ" -
บีบอัดทรัพยากร Java ใน APK
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_android_databinding_v2
: "true" -
ใช้ Android Data Binding v2 แฟล็กนี้ไม่มีการใช้งาน
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]experimental_android_resource_shrinking
: "เท็จ" -
เปิดใช้การย่อทรัพยากรสำหรับ APK android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_android_rewrite_dexes_with_rex
: "เท็จ" -
ใช้เครื่องมือ Rex เพื่อเขียนไฟล์ dex ใหม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]experimental_collect_code_coverage_for_generated_files
: "เท็จ" -
หากระบุไว้ Bazel จะสร้างการรวบรวมข้อมูลที่ครอบคลุมสำหรับไฟล์ที่สร้างขึ้นด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_objc_fastbuild_options=<comma-separated list of options>
: "-O0,-DDEBUG=1" -
ใช้สตริงเหล่านี้เป็นตัวเลือกคอมไพเลอร์ objc Fastbuild
แท็ก:action_command_lines
- ค่าเริ่มต้น
--[no]experimental_omitfp
: "เท็จ" -
หากเป็น "จริง" ให้ใช้ libunwind สำหรับการคลายสแต็ก แล้วคอมไพล์ด้วย -fomit-frame-pointer และ -fasynchronous-unwind-tables
แท็ก:action_command_lines
,affects_outputs
,experimental
- ค่าเริ่มต้นของ
--experimental_output_paths=<off, content or strip>
: "ปิด" -
โมเดลที่ควรใช้สำหรับส่วนใดในกฎแผนผังเอาต์พุตจะเขียนเอาต์พุต โดยเฉพาะอย่างยิ่งสำหรับบิลด์ที่มีหลายแพลตฟอร์ม / หลายการกำหนดค่า ฟีเจอร์นี้อยู่ในขั้นทดลอง ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/6526 การดำเนินการของ Starlark เลือกใช้การแมปเส้นทางได้ด้วยการเพิ่มคีย์ "supports-path-mapping" เป็น "execution_requirements" พิมพ์ตามคำบอก
แท็ก:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
รายการ -
แต่ละรายการควรอยู่ในรูปแบบ label=value โดยที่ป้ายกำกับอ้างอิงถึงแพลตฟอร์ม และค่าคือชื่อย่อที่ต้องการใช้ในเส้นทางเอาต์พุต ใช้เมื่อ --experimental_platform_in_output_dir เป็นจริงเท่านั้น มีลำดับความสำคัญในการตั้งชื่อสูงสุด
แท็ก:affects_outputs
experimental
- ค่าเริ่มต้น
--[no]experimental_platform_in_output_dir
: "เท็จ" -
หากเป็นจริง ระบบจะใช้ชื่อย่อของแพลตฟอร์มเป้าหมายในชื่อไดเรกทอรีเอาต์พุตแทน CPU รูปแบบที่แน่นอนอยู่ในขั้นทดลองและอาจมีการเปลี่ยนแปลง อย่างแรก ในกรณีซึ่งเกิดขึ้นไม่บ่อยนัก ตัวเลือก --platforms ไม่ได้มีค่าเพียงค่าเดียว ระบบจะใช้แฮชของตัวเลือกแพลตฟอร์ม ถัดไป หากชื่อย่อของแพลตฟอร์มปัจจุบันลงทะเบียนโดย --experimental_override_name_platform_in_output_dir ระบบจะใช้ชื่อย่อนั้น จากนั้น หากมีการตั้งค่า --experimental_use_platforms_in_output_dir_legacy_heurism ให้ใช้ชื่อย่อที่อ้างอิงจากป้ายกำกับแพลตฟอร์มปัจจุบัน สุดท้าย ระบบจะใช้แฮชของตัวเลือกแพลตฟอร์มเป็นทางเลือกสุดท้าย
แท็ก:affects_outputs
experimental
- ค่าเริ่มต้น
--[no]experimental_use_llvm_covmap
: "เท็จ" -
หากระบุ Bazel จะสร้างข้อมูลแผนที่ความครอบคลุมของ llvm-cov แทนที่จะเป็น gcov เมื่อเปิดใช้งานcollect_code_coverage
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
: "true" -
โปรดใช้แฟล็กนี้เป็นส่วนหนึ่งของกลยุทธ์การย้ายข้อมูลหรือการทดสอบที่แนะนำเท่านั้น โปรดทราบว่าการเรียนรู้มีข้อบกพร่องที่ทราบแล้ว และแนะนำให้เปลี่ยนไปใช้เพียง --experimental_override_name_platform_in_output_dir
แท็ก:affects_outputs
experimental
- ค่าเริ่มต้นของ
--fat_apk_cpu=<comma-separated set of options>
: "armeabi-v7a" -
การตั้งค่าตัวเลือกนี้จะเปิดใช้ APK แบบอ้วน ซึ่งมีไบนารีแบบเนทีฟสำหรับสถาปัตยกรรมเป้าหมายที่ระบุทั้งหมด เช่น --fat_apk_cpu=x86,armeabi-v7a. หากระบุแฟล็กนี้ ระบบจะละเว้น --android_cpu สำหรับทรัพยากร Dependency ของกฎ android_binary
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--fdo_instrument=<a string>
: ดูคำอธิบาย -
สร้างไบนารีด้วยเครื่องมือ FDO เมื่อใช้คอมไพเลอร์ Clang/LLVM คีย์ดังกล่าวจะยอมรับชื่อไดเรกทอรีที่ระบบจะส่งออกไฟล์โปรไฟล์แบบ RAW ขณะรันไทม์ด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_optimize=<a string>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ FDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อไฟล์ ZIP ที่มีแผนผังไฟล์ .gcda, ไฟล์ afdo ที่มีโปรไฟล์อัตโนมัติ หรือไฟล์โปรไฟล์ LLVM แฟล็กนี้ยอมรับไฟล์ที่ระบุเป็นป้ายกำกับด้วย (เช่น "//foo/bar:file.afdo" คุณอาจต้องเพิ่มคำสั่ง "exports_files" ไปยังแพ็กเกจที่เกี่ยวข้อง) และป้ายกำกับที่ชี้ไปยังเป้าหมาย "fdo_profile" การตั้งค่าสถานะนี้จะถูกแทนที่โดยกฎ "fdo_profile"
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_prefetch_hints=<a build target label>
: ดูคำอธิบาย -
ใช้คำแนะนำการดึงข้อมูลแคชล่วงหน้า
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_profile=<a build target label>
: ดูคำอธิบาย -
fdo_profile แทนโปรไฟล์ที่จะใช้ในการเพิ่มประสิทธิภาพ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--features=<a string>
รายการ -
ระบบจะเปิดใช้หรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างขึ้นในการกำหนดค่าเป้าหมาย กำลังระบุ -<feature> จะปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ ดูเพิ่มเติมที่ --host_features
แท็ก:changes_inputs
affects_outputs
- ค่าเริ่มต้น
--[no]force_pic
: "เท็จ" -
หากเปิดใช้งาน การคอมไพล์ C++ ทั้งหมดจะสร้างโค้ดที่ไม่ขึ้นอยู่กับตำแหน่ง ("-fPIC") ลิงก์จะใช้ไลบรารีที่สร้างไว้ล่วงหน้าของ PIC มากกว่าไลบรารีที่ไม่ใช่ PIC และลิงก์จะสร้างไฟล์ปฏิบัติการที่ไม่ขึ้นอยู่กับตำแหน่ง ("-pie")
แท็ก:loading_and_analysis
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_action_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกำหนดค่าการดำเนินการ คุณระบุตัวแปรได้ด้วยชื่อ ซึ่งในกรณีนี้ระบบจะนําค่าจากสภาพแวดล้อมการเรียกใช้ หรือคู่ name=value ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ ตัวเลือกนี้ใช้ได้หลายครั้ง สำหรับตัวเลือกที่ระบุสำหรับตัวแปรเดียวกัน ค่าที่ชนะล่าสุด และตัวเลือกของตัวแปรต่างๆ จะสะสมอยู่
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--host_compilation_mode=<fastbuild, dbg or opt>
: "opt" -
ระบุโหมดที่จะมีการสร้างเครื่องมือที่ใช้ในการสร้าง ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_conlyopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งไปยังคอมไพเลอร์ C เมื่อคอมไพล์ไฟล์ต้นฉบับ C (ไม่ใช่ C++) ในการกำหนดค่าผู้บริหาร
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_copt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยังคอมไพเลอร์ C สำหรับเครื่องมือที่สร้างขึ้นในการกำหนดค่าการดำเนินการ
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้นของ
--host_cpu=<a string>
: "" -
CPU ของโฮสต์
แท็ก:changes_inputs
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_cxxopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยังคอมไพเลอร์ C++ สำหรับเครื่องมือที่สร้างขึ้นในการกำหนดค่าดำเนินการ
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_features=<a string>
รายการ -
ระบบจะเปิดใช้หรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างขึ้นในการกำหนดค่า exec กำลังระบุ -<feature> จะปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ
แท็ก:changes_inputs
affects_outputs
- ค่าเริ่มต้น
--host_force_python=<PY2 or PY3>
: ดูคำอธิบาย -
ลบล้างเวอร์ชัน Python สำหรับการกำหนดค่า exec อาจเป็น "PY2" หรือ "PY3"
แท็ก:loading_and_analysis
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_linkopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง Linker เมื่อลิงก์เครื่องมือในการกำหนดค่าการดำเนินการ
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน macOS ที่เข้ากันได้ขั้นต่ำสำหรับเป้าหมายโฮสต์ หากไม่ได้ระบุ ให้ใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อเลือกส่งไปยังคอมไพเลอร์ C/C++ ที่เลือกเมื่อคอมไพล์ไฟล์บางไฟล์ในการกำหนดค่าผู้บริหาร ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจากรายการรวมและไม่รวมรูปแบบนิพจน์ทั่วไป (ดู --instrumentation_filter) ด้วย Option_1 กับ Option_n นั้นย่อมาจากตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ ในการแยกสตริงจะใช้เฉพาะ @ แรกเท่านั้น ตัวอย่าง: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--[no]incompatible_auto_exec_groups
: "เท็จ" -
เมื่อเปิดใช้ ระบบจะสร้างกลุ่มผู้บริหารสำหรับ Toolchain แต่ละรายการที่กฎใช้โดยอัตโนมัติ กฎในการทำงานนี้ต้องระบุพารามิเตอร์ "toolchain" ในการดำเนินการ ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/17134
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_merge_genfiles_directory
: "true" -
หากเป็นจริง ไดเรกทอรี genfiles จะถูกพับลงในไดเรกทอรี bin
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]instrument_test_targets
: "เท็จ" -
เมื่อเปิดใช้การครอบคลุม ให้ระบุว่าจะพิจารณาการใช้กฎการทดสอบการวัดคุมหรือไม่ เมื่อตั้งค่าแล้ว กฎการทดสอบที่ --instrumentation_filter รวมอยู่จะมีการวัดคุม มิฉะนั้น กฎการทดสอบจะถูกยกเว้นจากการวัดคุมการครอบคลุมเสมอ
แท็ก:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
ค่าเริ่มต้น: "-/javatests[/:],-/test/java[/:]"-
เมื่อเปิดใช้การครอบคลุม ระบบจะวัดเฉพาะกฎที่มีชื่อซึ่งตัวกรองตามนิพจน์ทั่วไปที่ระบุรวมอยู่เท่านั้น กฎที่ขึ้นต้นด้วย "-" จะได้รับการยกเว้นแทน โปรดทราบว่าระบบจะวัดคุมเฉพาะกฎที่ไม่ใช่การทดสอบเท่านั้น ยกเว้นกรณีที่เปิดใช้งาน --instrument_test_targets
แท็ก:affects_outputs
- ค่าเริ่มต้น
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน iOS ที่เข้ากันได้ขั้นต่ำสำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ระบุ ให้ใช้ "ios_sdk_version"
แท็ก:loses_incremental_state
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ios_multi_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างแอปพลิเคชัน ios_ ผลลัพธ์จะเป็นไบนารีสากลที่มีสถาปัตยกรรมที่ระบุทั้งหมด
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--[no]legacy_whole_archive
: "true" -
เลิกใช้งานแล้ว และมีผลแทนด้วย --inสามารถเข้าถึง_remove_legacy_whole_archive (ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7362) เมื่อเปิด ให้ใช้ --whole-archive สำหรับกฎ cc_binary ที่มี linkshared=True และ linkstatic=True หรือ '-static' ใน Linkopts วิธีนี้ใช้สำหรับความเข้ากันได้แบบย้อนหลังเท่านั้น อีกทางเลือกหนึ่งที่ดีกว่าคือการใช้ Alwayslink=1 เมื่อจำเป็น
แท็ก:action_command_lines
,affects_outputs
,deprecated
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--linkopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งไปยัง gcc เมื่อลิงก์
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ltobackendopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังขั้นตอนแบ็กเอนด์ของ LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ltoindexopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังขั้นตอนการจัดทำดัชนี LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--macos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple macOS
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน macOS ที่เข้ากันได้ขั้นต่ำสำหรับเป้าหมาย หากไม่ได้ระบุ ให้ใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--memprof_profile=<a build target label>
: ดูคำอธิบาย -
ใช้โปรไฟล์ Memprof
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]objc_debug_with_GLIBCXX
: "เท็จ" -
หากตั้งค่า และตั้งค่าโหมดการคอมไพล์เป็น "dbg" ให้กำหนด GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC และ GLIBCPP_CONCEPT_CHECKS
แท็ก:action_command_lines
- ค่าเริ่มต้น
--[no]objc_enable_binary_stripping
: "เท็จ" -
เลือกว่าจะดำเนินการลบสัญลักษณ์และโค้ดที่เสียหายในไบนารีที่ลิงก์หรือไม่ ระบบจะลบไบนารีหากระบุทั้ง Flag และ --compilation_mode=opt นี้
แท็ก:action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--objccopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ Objective-C/C++
แท็ก:action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งผ่านไปยัง gcc เฉพาะเมื่อคอมไพล์ไฟล์บางไฟล์ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจากรายการรวมและไม่รวมรูปแบบนิพจน์ทั่วไป (ดู --instrumentation_filter) ด้วย Option_1 กับ Option_n นั้นย่อมาจากตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ ในการแยกสตริงจะใช้เฉพาะ @ แรกเท่านั้น ตัวอย่าง: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับเลือกส่งไปยังแบ็กเอนด์ LTO (ในส่วน --features=thin_lto) เมื่อคอมไพล์ออบเจ็กต์แบ็กเอนด์บางรายการ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจาก รายการรูปแบบ รวมและยกเว้น ของนิพจน์ทั่วไป Option_1 กับ Option_n นั้นย่อมาจากตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ ในการแยกสตริงจะใช้เฉพาะ @ แรกเท่านั้น ตัวอย่าง: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่งแบ็กเอนด์ LTO ของไฟล์ o ทั้งหมดใน //foo/ ยกเว้น bar.o
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--platform_suffix=<a string>
: ดูคำอธิบาย -
ระบุคำต่อท้ายที่จะเพิ่มในไดเรกทอรีการกำหนดค่า
แท็ก:loses_incremental_state
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--propeller_optimize=<a build target label>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ Propeller เพื่อเพิ่มประสิทธิภาพเป้าหมายของบิลด์ โปรไฟล์ใบพัดต้องประกอบด้วยไฟล์อย่างน้อย 1 จาก 2 ไฟล์ โปรไฟล์สำเนา และโปรไฟล์ ld แฟล็กนี้ยอมรับป้ายกำกับบิลด์ซึ่งต้องอ้างถึงไฟล์อินพุตโปรไฟล์ใบพัด ตัวอย่างเช่น ไฟล์ BUILD ที่กำหนดป้ายกำกับใน a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)อาจต้องเพิ่มคำสั่ง ecommerce_files ลงในแพ็กเกจที่เกี่ยวข้องเพื่อให้ Bazel มองเห็นไฟล์เหล่านี้ ต้องใช้ตัวเลือกเป็น: --propeller_optimize=//a/b:propeller_profile
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--propeller_optimize_absolute_cc_profile=<a string>
: ดูคำอธิบาย -
ชื่อเส้นทางสัมบูรณ์ของไฟล์ cc_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพใบพัด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--propeller_optimize_absolute_ld_profile=<a string>
: ดูคำอธิบาย -
ชื่อเส้นทางสัมบูรณ์ของไฟล์ ld_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพใบพัด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--run_under=<a prefix in front of command>
: ดูคำอธิบาย -
คำนำหน้าที่จะแทรกก่อนไฟล์ปฏิบัติการสำหรับ "การทดสอบ" และ "เรียกใช้" คำสั่ง หากค่าคือ "foo -bar" และบรรทัดคำสั่งสำหรับการดำเนินการคือ "test_binary -baz" บรรทัดคำสั่งสุดท้ายคือ "foo -bar test_binary -baz" บรรทัดคำสั่งนี้อาจเป็นป้ายกำกับของเป้าหมายสั่งการได้ด้วย ตัวอย่างเช่น 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'
แท็ก:action_command_lines
-
หากจริง ระบบจะแชร์ไลบรารีเนทีฟที่มีฟังก์ชันการทำงานเหมือนกันกับเป้าหมายต่างๆ
แท็ก: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
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--tvos_cpus=<comma-separated list of options>
รายการ -
รายชื่อสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple tvOS
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน tvOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ระบุ ให้ใช้ "tvos_sdk_version"
แท็ก:loses_incremental_state
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--visionos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple visionOS
แท็ก:loses_incremental_state
loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--watchos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple WatchOS
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน WatchOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ได้ระบุ ให้ใช้ "watchos_sdk_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--xbinary_fdo=<a build target label>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ XbinaryFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อของโปรไฟล์แบบไบนารีที่เป็นค่าเริ่มต้น เมื่อใช้ตัวเลือกนี้ร่วมกับ --fdo_instrument/--fdo_optimize/--fdo_profile ตัวเลือกเหล่านั้นจะมีผลเหนือกว่าเสมอเสมือนว่าไม่ได้ระบุ xbinary_fdo
แท็ก:affects_outputs
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตบิลด์ที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมธง ฯลฯ)
- ค่าเริ่มต้น
--[no]check_licenses
: "เท็จ" -
ตรวจสอบว่าข้อจำกัดในการออกใบอนุญาตที่กำหนดโดยแพ็กเกจที่เกี่ยวข้องไม่ขัดแย้งกับโหมดการเผยแพร่ของเป้าหมายที่กำลังสร้าง โดยค่าเริ่มต้น ใบอนุญาตจะไม่ได้รับการตรวจสอบ
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]check_visibility
: "true" -
หากปิดใช้ ระบบจะลดระดับข้อผิดพลาดระดับการเข้าถึงในทรัพยากร Dependency เป้าหมายให้เหลือเพียงคําเตือน
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]desugar_for_android
: "true" -
เลือกว่าจะใช้ไบต์โค้ด Java 8 ก่อนถอดรหัสหรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--[no]desugar_java8_libs
: "เท็จ" -
เลือกว่าจะรวมไลบรารี Java 8 ที่รองรับในแอปสำหรับอุปกรณ์เดิมหรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]enforce_constraints
: "true" -
ตรวจสอบสภาพแวดล้อมที่แต่ละเป้าหมายใช้งานร่วมกันได้ และรายงานข้อผิดพลาดหากเป้าหมายมีทรัพยากร Dependency ที่ไม่รองรับสภาพแวดล้อมเดียวกัน
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]experimental_check_desugar_deps
: "true" -
ตรวจสอบความถูกต้องของการแยกน้ำตาลที่ระดับไบนารีของ Android อีกครั้งหรือไม่
แท็ก:eagerness_to_exit
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--experimental_import_deps_checking=<a string>
: ดูคำอธิบาย -
ไม่มีการดำเนินการ เก็บไว้สำหรับความเข้ากันได้แบบย้อนหลังเท่านั้น
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--experimental_one_version_enforcement=<off, warning or error>
: "ปิด" -
เมื่อเปิดใช้ ให้บังคับใช้ว่ากฎ java_binary จะมีไฟล์คลาสเดียวกันใน classpath มากกว่า 1 เวอร์ชันไม่ได้ การบังคับใช้นี้อาจทำให้บิลด์เสียหายหรืออาจทำให้เกิดคำเตือน
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "ค่าเริ่มต้น" -
หากเป็นจริง ให้ตรวจสอบว่าเป้าหมาย Java ประกาศเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency อย่างชัดเจน
แท็ก:build_file_semantics
eagerness_to_exit
- ค่าเริ่มต้น
--[no]incompatible_check_testonly_for_output_files
: "เท็จ" -
หากเปิดใช้ ให้ตรวจสอบ testonly สำหรับเป้าหมายที่จำเป็นเบื้องต้นที่เป็นไฟล์เอาต์พุตโดยค้นหา testonly ของกฎที่สร้าง รายการนี้ตรงกับการตรวจสอบระดับการเข้าถึง
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_check_visibility_for_toolchains
: "เท็จ" -
หากเปิดใช้ การตรวจสอบระดับการเข้าถึงจะมีผลกับการติดตั้งใช้งาน Toolchain ด้วย
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disable_native_android_rules
: "เท็จ" -
หากเปิดใช้ ระบบจะปิดใช้กฎที่มีอยู่สำหรับ Android โดยตรง โปรดใช้กฎของ Android Starlark จาก https://github.com/bazelbuild/rules_android
แท็ก:eagerness_to_exit
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disable_native_apple_binary_rule
: "เท็จ" -
ไม่มีการดำเนินการ เก็บไว้ที่นี่เพื่อดูความเข้ากันได้แบบย้อนหลัง
แท็ก:eagerness_to_exit
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_python_disable_py2
: "true" -
หากเป็น "จริง" การใช้การตั้งค่า Python 2 จะทำให้เกิดข้อผิดพลาด ซึ่งรวมถึง python_version=PY2, srcs_version=PY2 และ srcs_version=PY2ONLY ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/15684
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]one_version_enforcement_on_java_tests
: "true" -
เมื่อเปิดใช้ และตั้งค่า Experiment_one_version_enforcement เป็นค่าที่ไม่ใช่ NONE แล้ว ให้บังคับใช้ 1 เวอร์ชันกับเป้าหมาย java_test คุณสามารถปิดการแจ้งว่าไม่เหมาะสมนี้เพื่อปรับปรุงประสิทธิภาพการทดสอบให้ดียิ่งขึ้นได้ โดยไม่ต้องกลัวว่าจะมีการละเมิดเวอร์ชันใดเวอร์ชันหนึ่ง
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--python_native_rules_allowlist=<a build target label>
: ดูคำอธิบาย -
รายการที่อนุญาต (package_group target (เป้าหมายกลุ่มแพ็กเกจ) ที่จะใช้เมื่อบังคับใช้ --incompatible_python_disallow_native_rules
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]strict_filesets
: "เท็จ" -
หากเปิดใช้ตัวเลือกนี้ ระบบจะรายงานว่าชุดไฟล์ข้ามขอบเขตของแพ็กเกจเป็นข้อผิดพลาด
แท็ก:build_file_semantics
eagerness_to_exit
- ค่าเริ่มต้น
--strict_proto_deps=<off, warn, error, strict or default>
: "ข้อผิดพลาด" -
หากไม่ "ปิด" ให้ตรวจสอบว่าเป้าหมาย protocol_library ประกาศอย่างชัดแจ้งว่าเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้นของ
--strict_public_imports=<off, warn, error, strict or default>
: "ปิด" -
หากไม่ "ปิด" ให้ตรวจสอบว่าเป้าหมาย protocol_library ประกาศอย่างชัดเจนถึงเป้าหมายทั้งหมดที่ใช้ใน "นำเข้าสาธารณะ" ตามที่ส่งออกแล้ว
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้น
--[no]strict_system_includes
: "เท็จ" -
หากเป็น "จริง" ส่วนหัวที่พบผ่านทางระบบรวมเส้นทาง (-isystem) ต้องมีการประกาศด้วย
แท็ก:loading_and_analysis
eagerness_to_exit
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--target_environment=<a build target label>
รายการ -
ประกาศสภาพแวดล้อมเป้าหมายของบิลด์นี้ ต้องอ้างอิงถึงป้ายกำกับไปยัง "สภาพแวดล้อม" กฎ หากระบุ เป้าหมายระดับบนสุดทั้งหมดต้องเข้ากันได้กับสภาพแวดล้อมนี้
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อเอาต์พุตการลงชื่อของบิลด์:
- ค่าเริ่มต้น
--apk_signing_method=<v1, v2, v1_v2 or v4>
: "v1_v2" -
การใช้งานเพื่อรับรอง APK
แท็ก:action_command_lines
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--[no]device_debug_entitlements
: "true" -
หากมีการตั้งค่า และโหมดการคอมไพล์ไม่ใช่ "เพิ่มประสิทธิภาพ" แอป objc จะรวมการให้สิทธิ์การแก้ไขข้อบกพร่องเมื่อลงชื่อ
แท็ก:changes_inputs
- ค่าเริ่มต้น
--ios_signing_cert_name=<a string>
: ดูคำอธิบาย -
ชื่อใบรับรองที่จะใช้สำหรับ iOS Signing หากไม่ได้ตั้งค่า ระบบจะกลับไปใช้โปรไฟล์การจัดสรร อาจเป็นค่ากำหนดข้อมูลประจำตัว Keychain ของใบรับรองหรือ (สตริงย่อย) ของชื่อสามัญของใบรับรองตามหน้า man ของ Codesign (รหัสการลงชื่อเข้าใช้)
แท็ก:action_command_lines
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_disallow_legacy_py_provider
: "true" -
ไม่มีการดำเนินการ จะถูกนำออกในเร็วๆ นี้
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disallow_sdk_frameworks_attributes
: "เท็จ" -
หากเป็น "จริง" ไม่อนุญาตแอตทริบิวต์ sdk_frameworks และ external_sdk_frameworks ใน objc_library andobjc_import
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_objc_alwayslink_by_default
: "เท็จ" -
หากเป็น "จริง" ตั้งค่าเริ่มต้นเป็น "จริง" สำหรับแอตทริบิวต์ Alwayslink ใน objc_library และ objc_IMPORT
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_python_disallow_native_rules
: "เท็จ" -
เมื่อเป็นจริง เกิดข้อผิดพลาดขึ้นเมื่อใช้กฎ py_* ในตัว ควรใช้กฎ rules_python แทน ดูข้อมูลเพิ่มเติมและวิธีการย้ายข้อมูลได้ที่ https://github.com/bazelbuild/bazel/issues/17773
แท็ก:loading_and_analysis
incompatible_change
- สภาพแวดล้อมการทดสอบหรือตัวดำเนินการทดสอบ:
- ค่าเริ่มต้น
--[no]allow_analysis_failures
: "เท็จ" -
หากจริง การวิเคราะห์เป้าหมายของกฎไม่สำเร็จส่งผลให้เกิดการเผยแพร่อินสแตนซ์ของ AnalysisFailureInfo ของเป้าหมายที่มีคำอธิบายข้อผิดพลาด แทนที่จะทำให้บิลด์ไม่สำเร็จ
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--analysis_testing_deps_limit=<an integer>
: "2000" -
ตั้งค่าจำนวนสูงสุดของทรัพยากร Dependency แบบทรานซิทีฟผ่านแอตทริบิวต์กฎที่มีการเปลี่ยนการกำหนดค่า for_analysis_testing การใช้เกินขีดจำกัดนี้จะทำให้เกิดข้อผิดพลาดของกฎ
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]break_build_on_parallel_dex2oat_failure
: "เท็จ" -
หากความล้มเหลวจริงในการดำเนินการ dex2oat จะทำให้บิลด์เสียหายแทนที่จะเรียกใช้ dex2oat ระหว่างรันไทม์ทดสอบ
แท็ก:loading_and_analysis
experimental
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g memory=10,30,60,100>
รายการ - ลบล้างจำนวนทรัพยากรเริ่มต้นสำหรับการทดสอบ รูปแบบที่คาดไว้คือ <resource>=<value> หากระบุจำนวนบวกตัวเดียวเป็น <value> ระบบจะลบล้างทรัพยากรเริ่มต้นสำหรับขนาดทดสอบทั้งหมด หากระบุตัวเลขที่คั่นด้วยคอมมา 4 ตัว จำนวนดังกล่าวจะแทนที่จำนวนทรัพยากรสำหรับขนาดทดสอบขนาดเล็ก กลาง ใหญ่ และขนาดใหญ่ตามลำดับ ค่าอาจเป็น HOST_RAM/HOST_CPU (ไม่บังคับ) ตามด้วย [-|*]<Flo> (เช่น Memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4) ทรัพยากรการทดสอบเริ่มต้นที่ระบุโดยแฟล็กนี้จะถูกลบล้างโดยทรัพยากรที่อาจไม่เหมาะสมซึ่งระบุไว้ในแท็ก
- ค่าเริ่มต้น
--[no]experimental_android_use_parallel_dex2oat
: "เท็จ" -
ใช้ dex2oat แบบขนานเพื่อเร่งความเร็ว android_test
แท็ก:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- ค่าเริ่มต้น
--[no]ios_memleaks
: "เท็จ" -
เปิดใช้การตรวจหาหน่วยความจำรั่วไหลในเป้าหมาย ios_test
แท็ก:action_command_lines
- ค่าเริ่มต้น
--ios_simulator_device=<a string>
: ดูคำอธิบาย -
อุปกรณ์ที่จะจำลองเมื่อเรียกใช้แอปพลิเคชัน iOS ในเครื่องมือจำลอง เช่น "iPhone 6" คุณดูรายการอุปกรณ์ได้โดยเรียกใช้ "xcrun simctl list devicetypes" บนเครื่องที่เครื่องมือจำลองจะทำงาน
แท็ก:test_runner
- ค่าเริ่มต้น
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชันของ iOS ที่จะเรียกใช้บนเครื่องมือจำลองเมื่อทำงานหรือทดสอบ ระบบจะไม่สนใจกฎ ios_test หากกฎระบุอุปกรณ์เป้าหมายไว้ในกฎ
แท็ก:test_runner
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
รายการ - ระบุจำนวนครั้งที่จะทำการทดสอบแต่ละครั้ง หากการดำเนินการเหล่านั้นล้มเหลวไม่ว่าด้วยเหตุผลใดก็ตาม จะถือว่าการทดสอบทั้งหมดไม่ผ่าน โดยปกติแล้ว ค่าที่ระบุจะเป็นแค่จำนวนเต็ม ตัวอย่าง: --runs_per_test=3 จะทำการทดสอบทั้งหมด 3 ครั้ง ไวยากรณ์สำรอง: regex_filter@runs_per_test โดย running_per_test ย่อมาจากค่าจำนวนเต็ม ส่วน regex_filter หมายถึงรายการรูปแบบการรวมและยกเว้นรูปแบบนิพจน์ทั่วไป (โปรดดู --instrumentation_filter) ตัวอย่างเช่น --runs_per_test=//foo/.*,-//foo/bar/.*@3 จะทำการทดสอบทั้งหมดใน //foo/ ยกเว้นการทดสอบภายใต้ foo/bar 3 ครั้ง ตัวเลือกนี้ส่งได้หลายครั้ง อาร์กิวเมนต์ที่ส่งผ่านล่าสุดที่ตรงกันจะมีความสำคัญเหนือกว่า หากไม่มีผลลัพธ์ที่ตรงกัน ระบบจะทำการทดสอบเพียงครั้งเดียว
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--test_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุตัวแปรสภาพแวดล้อมเพิ่มเติมที่จะแทรกลงในสภาพแวดล้อมตัวดำเนินการทดสอบ คุณระบุตัวแปรได้โดยใช้ชื่อ ซึ่งในกรณีนี้ระบบจะอ่านค่าของตัวแปรจากสภาพแวดล้อมไคลเอ็นต์ Bazel หรือด้วยคู่ชื่อ=ค่า ตัวเลือกนี้ใช้ได้หลายครั้งเพื่อระบุตัวแปรหลายรายการ ใช้เฉพาะโดย "การทดสอบ bazel" เท่านั้น คำสั่ง
แท็ก:test_runner
- ค่าเริ่มต้น
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - ลบล้างค่าระยะหมดเวลาในการทดสอบเริ่มต้นสำหรับระยะหมดเวลาทดสอบ (เป็นวินาที) หากระบุค่าจำนวนเต็มบวกค่าเดียว ค่าดังกล่าวจะแทนที่หมวดหมู่ทั้งหมด หากระบุจำนวนเต็มที่คั่นด้วยคอมมา 4 ตัวเลข ค่าดังกล่าวจะลบล้างระยะหมดเวลาสำหรับแบบสั้น ปานกลาง ยาว และนิรันดร์ (ตามลำดับนั้น) ไม่ว่าจะเป็นรูปแบบใด ค่า -1 จะบอกให้ Blaze ใช้ระยะหมดเวลาเริ่มต้นสำหรับหมวดหมู่นั้น
- ค่าเริ่มต้น
--[no]zip_undeclared_test_outputs
: "true" -
หากเป็น "จริง" ระบบจะเก็บเอาต์พุตทดสอบที่ไม่ได้ประกาศไว้ในไฟล์ ZIP
แท็ก:test_runner
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพเวลาของบิลด์
- ค่าเริ่มต้น
--[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_retain_test_configuration_across_testonly
: "เท็จ" -
เมื่อเปิดใช้ --trim_test_configuration จะไม่ตัดการกำหนดค่าการทดสอบสำหรับกฎที่ทำเครื่องหมายว่า testonly=1 ทั้งนี้เพื่อลดปัญหาความขัดแย้งในการดำเนินการเมื่อกฎที่ไม่ใช่การทดสอบต้องพึ่งพากฎ cc_test จะไม่มีผลหาก --trim_test_configuration เป็นเท็จ
แท็ก:loading_and_analysis
loses_incremental_state
- ค่าเริ่มต้น
--[no]experimental_starlark_cc_import
: "เท็จ" -
หากเปิดใช้ เวอร์ชัน Starlark ของ cc_import จะสามารถใช้ได้
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--[no]experimental_unsupported_and_brittle_include_scanning
: "เท็จ" -
เลือกว่าจะจำกัดอินพุตเฉพาะการคอมไพล์ C/C++ หรือไม่โดยการแยกวิเคราะห์ #include บรรทัดจากไฟล์อินพุต ซึ่งจะช่วยปรับปรุงประสิทธิภาพและส่วนเพิ่มด้วยการลดขนาดของแผนผังอินพุตสำหรับการคอมไพล์ อย่างไรก็ตาม ก็อาจทำให้บิลด์เสียหายได้เช่นกัน เนื่องจากเครื่องมือสแกนดังกล่าวไม่สามารถใช้งานความหมายของโปรเซสเซอร์ล่วงหน้าแบบ C ได้อย่างสมบูรณ์ โดยเฉพาะอย่างยิ่ง ระบบจะไม่เข้าใจคำสั่ง #include แบบไดนามิก และไม่สนใจตรรกะตามเงื่อนไขของตัวประมวลผลล่วงหน้า คุณต้องรับความเสี่ยงของการใช้งานเอง เราจะปิดปัญหาที่เกี่ยวข้องกับการแจ้งว่าไม่เหมาะสมนี้
แท็ก:loading_and_analysis
,execution
,changes_inputs
- ค่าเริ่มต้น
--[no]incremental_dexing
: "true" -
ส่วนใหญ่จะทำงานสำหรับ Dexing แยกต่างหากสำหรับไฟล์ Jar แต่ละไฟล์
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--[no]objc_use_dotd_pruning
: "true" -
หากตั้งค่าไว้ จะมีการใช้ไฟล์ .d ที่มาจาก clang เพื่อตัดชุดอินพุตที่ส่งผ่านเข้าไปในคอมไพล์ objc
แท็ก:changes_inputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]process_headers_in_dependencies
: "เท็จ" -
เมื่อสร้าง //a:a เป้าหมาย ให้ประมวลผลส่วนหัวในเป้าหมายทั้งหมดที่ //a:a ต้องใช้ (หากเปิดใช้การประมวลผลส่วนหัวสำหรับ Toolchain)
แท็ก:execution
- ค่าเริ่มต้น
--[no]trim_test_configuration
: "true" -
เมื่อเปิดใช้ ระบบจะล้างตัวเลือกที่เกี่ยวข้องกับการทดสอบซึ่งอยู่ใต้ระดับบนสุดของบิลด์ เมื่อแฟล็กนี้ทำงานอยู่ ระบบจะสร้างการทดสอบเป็นทรัพยากร Dependency ของกฎที่ไม่ใช่การทดสอบไม่ได้ แต่การเปลี่ยนแปลงตัวเลือกที่เกี่ยวข้องกับการทดสอบจะไม่ทำให้มีการวิเคราะห์กฎที่ไม่ใช่การทดสอบอีกครั้ง
แท็ก:loading_and_analysis
loses_incremental_state
- การพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
- ค่าเริ่มต้น
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
พิมพ์ข้อมูลการแก้ไขข้อบกพร่องระหว่างการแปลง Toolchain แฟล็กจะใช้นิพจน์ทั่วไปซึ่งตรวจสอบกับประเภท Toolchain และเป้าหมายที่เฉพาะเจาะจงเพื่อดูว่าควรแก้ไขข้อบกพร่องใด นิพจน์ทั่วไปหลายรายการจะคั่นด้วยคอมมา แล้วระบบจะเลือกนิพจน์ทั่วไปแต่ละรายการแยกกัน หมายเหตุ: เอาต์พุตของ Flag นี้มีความซับซ้อนมากและน่าจะเป็นประโยชน์ต่อผู้เชี่ยวชาญด้านการแก้ไข Toolchain เท่านั้น
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--flag_alias=<a 'name=value' flag alias>
รายการ -
ตั้งชื่อย่อสำหรับธง Starlark โดยใช้คู่คีย์-ค่าคู่เดียวในรูปแบบ "<key>=<value>" เป็นอาร์กิวเมนต์
แท็ก:changes_inputs
- ค่าเริ่มต้น
--[no]incompatible_default_to_explicit_init_py
: "เท็จ" -
แฟล็กนี้เปลี่ยนลักษณะการทำงานเริ่มต้นเพื่อไม่ให้สร้างไฟล์ __init__.py โดยอัตโนมัติในไฟล์การเรียกใช้ของเป้าหมาย Python อีกต่อไป แม่นยำเมื่อเป้าหมาย py_binary หรือ py_test ตั้งค่า legacy_create_init เป็น "auto" (ค่าเริ่มต้น) ระบบจะถือว่าเป็น "เท็จ" เมื่อมีการตั้งค่าแฟล็กนี้เท่านั้น ดู https://github.com/bazelbuild/bazel/issues/10076
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_py2_outputs_are_suffixed
: "true" -
หากเป็นจริง เป้าหมายที่สร้างในการกำหนดค่า Python 2 จะปรากฏภายใต้รูทเอาต์พุตที่มีคำต่อท้าย "-py2" ขณะที่เป้าหมายที่สร้างขึ้นสำหรับ Python 3 จะปรากฏในรูทที่ไม่มีส่วนต่อท้ายที่เกี่ยวข้องกับ Python ซึ่งหมายความว่าลิงก์สัญลักษณ์ความสะดวก "bazel-bin" จะชี้ไปยังเป้าหมาย Python 3 แทนที่จะเป็น Python 2 หากคุณเปิดใช้ตัวเลือกนี้ ขอแนะนำให้เปิดใช้ "--incompatible_py3_is_default" ด้วย
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_py3_is_default
: "true" -
หากเป็นจริง เป้าหมาย "py_binary" และ "py_test" ที่ไม่ได้ตั้งค่าแอตทริบิวต์ "python_version" (หรือ "default_python_version") จะมีค่าเริ่มต้นเป็น PY3 แทนที่จะเป็น PY2 หากตั้งค่าแฟล็กนี้ ขอแนะนำให้ตั้งค่า "--incompatible_py2_outputs_are_suffixed"
แท็ก:loading_and_analysis
,affects_outputs
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_use_python_toolchains
: "true" -
หากตั้งค่าเป็น "จริง" กฎ Python ในเครื่องที่เป็นไฟล์ปฏิบัติการจะใช้รันไทม์ของ Python ที่ระบุโดย Toolchain ของ Python แทนรันไทม์ที่มาจากแฟล็กเดิม เช่น --python_top
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--python_version=<PY2 or PY3>
: ดูคำอธิบาย -
โหมดเวอร์ชันหลักของ Python ไม่ว่าจะเป็น "PY2" หรือ "PY3" โปรดทราบว่าเป้าหมาย "py_binary" และ "py_test" จะลบล้างค่านี้ (แม้ว่าจะไม่ได้ระบุเวอร์ชันอย่างชัดเจน) จึงมักไม่มีเหตุผลที่จะต้องระบุแฟล็กนี้
แท็ก:loading_and_analysis
affects_outputs
- ที่ไม่ถูกจัดหมวดหมู่:
--[no]cache_test_results
[-t
] ค่าเริ่มต้น: "อัตโนมัติ"- หากตั้งค่าเป็น "อัตโนมัติ" Bazel จะทำการทดสอบอีกครั้งเฉพาะในกรณีต่อไปนี้ (1) Bazel ตรวจพบการเปลี่ยนแปลงในการทดสอบหรือทรัพยากร Dependency (2) การทดสอบได้รับการทำเครื่องหมายว่าเป็นภายนอก (3) มีการขอทำการทดสอบหลายครั้งด้วย --runs_per_test หรือ(4) การทดสอบล้มเหลวก่อนหน้านี้ หากตั้งค่าเป็น "ใช่" Bazel จะแคชผลการทดสอบทั้งหมด ยกเว้นการทดสอบที่ทำเครื่องหมายว่าภายนอก หากตั้งค่าเป็น "ไม่" Bazel จะไม่แคชผลการทดสอบใดๆ
- ค่าเริ่มต้น
--[no]experimental_cancel_concurrent_tests
: "เท็จ" -
หากเป็น "จริง" Blaze จะยกเลิกการทดสอบพร้อมกันในการรันที่สำเร็จครั้งแรก วิธีนี้จะมีประโยชน์เมื่อใช้ร่วมกับ --runs_per_test_detects_flakes เท่านั้น
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_fetch_all_coverage_outputs
: "เท็จ" -
หากเป็น "จริง" Bazel จะดึงข้อมูลไดเรกทอรีข้อมูลการครอบคลุมทั้งหมดสำหรับการทดสอบแต่ละครั้งระหว่างการทำงานของการครอบคลุม
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_generate_llvm_lcov
: "เท็จ" -
หากเป็น "จริง" ความครอบคลุมของคําพูดจะสร้างรายงาน LCOV
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_j2objc_header_map
: "true" - เลือกว่าจะสร้างแผนที่ส่วนหัว J2ObjC ควบคู่ไปกับการแปลง J2ObjC หรือไม่
- ค่าเริ่มต้น
--[no]experimental_j2objc_shorter_header_path
: "เท็จ" -
เลือกว่าจะสร้างโดยใช้เส้นทางส่วนหัวที่สั้นกว่าหรือไม่ (ใช้ "_ios" แทน "_j2objc")
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_java_classpath=<off, javabuilder or bazel>
: "javabuilder" - เปิดใช้งานคลาสพาธที่ลดลงสำหรับการคอมไพล์ Java
- ค่าเริ่มต้น
--[no]experimental_limit_android_lint_to_android_constrained_java
: "เท็จ" -
ไม่มีการดำเนินการ เก็บไว้สำหรับความเข้ากันได้แบบย้อนหลังเท่านั้น
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_run_android_lint_on_java_rules
: "เท็จ" -
ระบุว่าจะตรวจสอบแหล่งที่มา java_* หรือไม่
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]explicit_java_test_deps
: "เท็จ" - ระบุทรัพยากร Dependency ของ JUnit หรือ Hamcrest อย่างชัดเจนใน java_test แทนที่จะได้มาจาก Dep ของ TestRunner โดยไม่ตั้งใจ ตอนนี้ใช้ได้กับ bazel เท่านั้น
- ค่าเริ่มต้น
--host_java_launcher=<a build target label>
: ดูคำอธิบาย - Java Launcher ที่เครื่องมือใช้ซึ่งดำเนินการในระหว่างบิลด์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_javacopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมในการส่งไปยัง Javac เมื่อสร้างเครื่องมือที่ดำเนินการระหว่างบิลด์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_jvmopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง Java VM เมื่อสร้างเครื่องมือสร้างที่ดำเนินการระหว่างบิลด์ ระบบจะเพิ่มตัวเลือกเหล่านี้ไปยังตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
- ค่าเริ่มต้น
--[no]incompatible_check_sharding_support
: "true" -
หากเป็น "จริง" Bazel จะไม่ผ่านการทดสอบชาร์ด หากตัวดำเนินการทดสอบไม่ได้ระบุว่ารองรับการชาร์ดดิ้งโดยการแตะไฟล์ที่เส้นทางใน TEST_SHARD_STATUS_FILE หากเป็นเท็จ ตัวดำเนินการทดสอบที่ไม่รองรับการชาร์ดจะนำไปยังการทดสอบทั้งหมดที่ทำงานในชาร์ดแต่ละรายการ
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_exclusive_test_sandboxed
: "true" -
หากจริง การทดสอบพิเศษจะทำงานโดยใช้กลยุทธ์แซนด์บ็อกซ์ เพิ่ม "ท้องถิ่น" เพื่อบังคับให้การทดสอบพิเศษทำงานภายในเครื่อง
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_strict_action_env
: "เท็จ" -
หากเป็นจริง Bazel จะใช้สภาพแวดล้อมที่มีค่าคงที่สำหรับ PATH และไม่รับค่า LD_LIBRARY_PATH ใช้ --action_env=ENV_VARIABLE หากคุณต้องการรับตัวแปรสภาพแวดล้อมที่เฉพาะเจาะจงจากไคลเอ็นต์ แต่โปรดทราบว่าการทำเช่นนี้อาจป้องกันการแคชข้ามผู้ใช้ได้หากมีการใช้แคชที่แชร์
แท็ก:loading_and_analysis
incompatible_change
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--j2objc_translation_flags=<comma-separated list of options>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยังเครื่องมือ J2ObjC
--java_debug
-
ทำให้เครื่องเสมือนของ Java ของการทดสอบ Java ต้องรอการเชื่อมต่อจากโปรแกรมแก้ไขข้อบกพร่องที่สอดคล้องกับ JDWP (เช่น jdb) ก่อนเริ่มการทดสอบ โดยนัย -test_output=streamed
ขยายเป็น
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- ค่าเริ่มต้น
--[no]java_deps
: "true" - สร้างข้อมูลทรัพยากร Dependency (ในขณะนี้คือคลาสพาธเวลาคอมไพล์) ต่อเป้าหมาย Java
- ค่าเริ่มต้น
--[no]java_header_compilation
: "true" - คอมไพล์จากต้นทางโดยตรง
- ค่าเริ่มต้นของ
--java_language_version=<a string>
: "" - เวอร์ชันภาษา Java
- ค่าเริ่มต้น
--java_launcher=<a build target label>
: ดูคำอธิบาย - Java Launcher ที่จะใช้เมื่อสร้างไบนารีของ Java หากตั้งค่าสถานะนี้เป็นสตริงว่างเปล่า ระบบจะใช้ Launcher ของ JDK "Launcher" จะลบล้างแฟล็กนี้
--java_runtime_version=<a string>
ค่าเริ่มต้น: "local_jdk"- เวอร์ชันรันไทม์ของ Java
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--javacopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง Javac
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--jvmopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง Java VM ระบบจะเพิ่มตัวเลือกเหล่านี้ไปยังตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
- ค่าเริ่มต้น
--legacy_main_dex_list_generator=<a build target label>
: ดูคำอธิบาย - ระบุไบนารีที่จะใช้สร้างรายการคลาสที่ต้องอยู่ใน Dex หลักเมื่อคอมไพล์ Multidex เดิม
- ค่าเริ่มต้น
--optimizing_dexer=<a build target label>
: ดูคำอธิบาย - ระบุไบนารีที่จะใช้ทำ Dexing โดยไม่ต้องชาร์ดดิ้ง
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--plugin=<a build target label>
รายการ - ปลั๊กอินที่ใช้ในบิลด์ ปัจจุบันใช้งานได้กับ java_plugin
- ค่าเริ่มต้น
--proguard_top=<a build target label>
: ดูคำอธิบาย - ระบุเวอร์ชัน ProGuard ที่จะใช้สำหรับการนำโค้ดออกเมื่อสร้างไบนารีของ Java
--proto_compiler=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/protocol:protocol"-
ป้ายกำกับของคอมไพเลอร์ Proto
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]proto_profile
: "true" -
ระบุว่าจะส่ง profile_path ไปยังคอมไพเลอร์ Pro หรือไม่
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--proto_profile_path=<a build target label>
: ดูคำอธิบาย -
โปรไฟล์ที่จะส่งไปยังคอมไพเลอร์ Pro เป็น profile_path หากไม่ได้ตั้งค่า แต่ --Proto_profile เป็นจริง (ค่าเริ่มต้น) จะอนุมานเส้นทางจาก --fdo_optimize
แท็ก: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:/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, อื่นๆ ทั้งหมด: /bin/bash) โปรดทราบว่าการใช้ Shell ที่เข้ากันไม่ได้กับ Bash อาจทำให้บิลด์ล้มเหลวหรือรันไทม์ของไบนารีที่สร้างขึ้นไม่สำเร็จ
แท็ก:loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--test_arg=<a string>
รายการ - ระบุตัวเลือกและอาร์กิวเมนต์เพิ่มเติมที่ควรส่งไปยังไฟล์ปฏิบัติการทดสอบ ซึ่งสามารถใช้หลายครั้งเพื่อระบุอาร์กิวเมนต์ได้หลายรายการ หากดำเนินการทดสอบหลายรายการ แต่ละรายการจะได้รับอาร์กิวเมนต์ที่เหมือนกัน ใช้เฉพาะโดย "การทดสอบ bazel" เท่านั้น คำสั่ง
- ค่าเริ่มต้น
--test_filter=<a string>
: ดูคำอธิบาย - ระบุตัวกรองที่จะส่งต่อไปยังเฟรมเวิร์กการทดสอบ ใช้เพื่อจำกัดการทดสอบ โปรดทราบว่าการเปลี่ยนแปลงนี้ไม่มีผลต่อเป้าหมายที่สร้างขึ้น
- ค่าเริ่มต้น
--test_result_expiration=<an integer>
: "-1" - ตัวเลือกนี้เลิกใช้งานแล้วและไม่ส่งผลใดๆ
- ค่าเริ่มต้น
--[no]test_runner_fail_fast
: "เท็จ" - การส่งต่อล้มเหลวตัวเลือกอย่างรวดเร็วไปยังตัวดำเนินการทดสอบ ตัวดำเนินการทดสอบควรหยุดการดำเนินการเมื่อล้มเหลวครั้งแรก
- ค่าเริ่มต้น
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
: "อาจไม่เหมาะสม" - ระบุกลยุทธ์สำหรับการทดสอบชาร์ดดิ้ง: "Explicit" จะใช้ชาร์ดดิ้งก็ต่อเมื่อ "shard_count" เท่านั้น มีแอตทริบิวต์ BUILD "ปิดใช้" ว่าจะไม่ใช้ทดสอบชาร์ดดิ้ง "forced=k" เพื่อบังคับใช้ "k" ชาร์ดสำหรับการทดสอบโดยไม่คำนึงถึง "shard_count" BUILD
- ค่าเริ่มต้นของ
--tool_java_language_version=<a string>
: "" - เวอร์ชันภาษา Java ที่ใช้เพื่อเรียกใช้เครื่องมือที่จำเป็นระหว่างการสร้าง
- ค่าเริ่มต้นของ
--tool_java_runtime_version=<a string>
: "remotejdk_11" - เวอร์ชันรันไทม์ของ Java ที่ใช้เพื่อเรียกใช้เครื่องมือในระหว่างบิลด์
- ค่าเริ่มต้น
--[no]use_ijars
: "true" - หากเปิดใช้ ตัวเลือกนี้จะทำให้การคอมไพล์ Java ใช้ jars อินเทอร์เฟซ ซึ่งจะทำให้การคอมไพล์แบบเพิ่มขึ้นเรื่อยๆ ได้เร็วขึ้น แต่ข้อความแสดงข้อผิดพลาดอาจแตกต่างกันได้
ตัวเลือกการตั้งค่าสถานะ Canonical
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่งมีดังนี้
- ค่าเริ่มต้น
--[no]canonicalize_policy
: "เท็จ" -
แสดงนโยบาย Canonical หลังจากการขยายและการกรอง เพื่อให้เอาต์พุตดูสะอาดตา อาร์กิวเมนต์คำสั่ง Canonical จะไม่แสดงเมื่อตั้งค่าตัวเลือกนี้เป็น "จริง" โปรดทราบว่าคำสั่งที่ระบุโดย --for_command จะมีผลกับนโยบายที่กรอง และหากไม่มีการระบุไว้ คำสั่งเริ่มต้นจะเป็น "build"
แท็ก:affects_outputs
terminal_output
- ค่าเริ่มต้น
--[no]experimental_include_default_values
: "true" -
ตัวเลือก Starlark ที่ตั้งค่าเป็นค่าเริ่มต้นจะรวมอยู่ในเอาต์พุตหรือไม่
แท็ก:affects_outputs
terminal_output
- ภาษา Starlark หรือ API บิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_config_setting_private_default_visibility
: "เท็จ" -
หากไม่รองรับ _enforce_config_setting_visibility=false ค่าจะเป็น Noop หรือไม่เช่นนั้น หากแฟล็กนี้เป็นเท็จ config_setting ใดๆ ที่ไม่มีแอตทริบิวต์การเปิดเผยอย่างชัดแจ้งจะเป็น //visibility:public หากแฟล็กนี้เป็นจริง config_setting จะใช้ตรรกะระดับการเข้าถึงเดียวกันกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_enforce_config_setting_visibility
: "true" -
หากเป็น "จริง" ให้บังคับใช้การจำกัดระดับการเข้าถึง config_setting หากเป็น "เท็จ" ทุก config_setting จะปรากฏแก่เป้าหมายทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_use_plus_in_repo_names
: "true" -
ไม่มีการดำเนินการ
แท็ก:loading_and_analysis
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ค่าเริ่มต้น
--for_command=<a string>
: "สร้าง" -
คำสั่งที่ควรกำหนดตัวเลือกให้เป็นหน้า Canonical
แท็ก:affects_outputs
terminal_output
- ค่าเริ่มต้นของ
--invocation_policy=<a string>
: "" -
ใช้นโยบายการเรียกใช้กับตัวเลือกที่จะกำหนดเวอร์ชัน Canonical
แท็ก:affects_outputs
terminal_output
- ที่ไม่ถูกจัดหมวดหมู่:
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--deleted_packages=<comma-separated list of package names>
รายการ - รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริงแม้ว่าจะปรากฏอยู่ที่ใดที่หนึ่งบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ เช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์ ระบบบิลด์อาจบ่นหากพบป้ายกำกับ "//x:y/z" ถ้ามีข้อมูลระบุโดยรายการpackage_path อื่นอยู่ การระบุ --deleted_packages x/y ช่วยป้องกันปัญหานี้
- ค่าเริ่มต้น
--[no]fetch
: "true" - อนุญาตให้คำสั่งดึงข้อมูลทรัพยากร Dependency ภายนอก หากตั้งค่าเป็น "เท็จ" คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ และหากไม่มี คำสั่งดังกล่าวจะทำให้การทำงานล้มเหลว
- ค่าเริ่มต้นของ
--package_path=<colon-separated list of options>
: "%workspace%" - รายการตำแหน่งที่จะค้นหาแพ็กเกจที่คั่นด้วยโคลอน องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับพื้นที่ทำงานที่ล้อมรอบอยู่ หากไม่ระบุหรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
- ค่าเริ่มต้น
--[no]show_loading_progress
: "true" - หากเปิดใช้ จะทำให้ Bazel พิมพ์ "กำลังโหลดแพ็กเกจ:" ข้อความ
ตัวเลือกในการล้างข้อมูล
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่งมีดังนี้
- ค่าเริ่มต้น
--[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
- ตัวเลือกนี้จะมีผลต่อความหมายของภาษา Starlark หรือ API บิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_use_plus_in_repo_names
: "true" -
ไม่มีการดำเนินการ
แท็ก:loading_and_analysis
ตัวเลือกการกำหนดค่า
ตัวเลือกความคุ้มครอง
รับค่าตัวเลือกทั้งหมดจาก test
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_use_plus_in_repo_names
: "true" -
ไม่มีการดำเนินการ
แท็ก:loading_and_analysis
ตัวเลือกคำค้นหา
รับค่าตัวเลือกทั้งหมดจาก test
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_use_plus_in_repo_names
: "true" -
ไม่มีการดำเนินการ
แท็ก:loading_and_analysis
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตการค้นหาและความหมาย
- ค่าเริ่มต้น
--aspect_deps=<off, conservative or precise>
: "เชิงรับ" -
วิธีแก้ไขทรัพยากร Dependency ของลักษณะเมื่อรูปแบบเอาต์พุตเป็นหนึ่งใน {xml,protocol,record} "off" หมายความว่าจะไม่มีการแก้ไขทรัพยากร Dependency ในด้านต่างๆ "เชิงรับ" (ค่าเริ่มต้น) หมายความว่าจะมีการเพิ่มทรัพยากร Dependency ที่ประกาศทั้งหมด ไม่ว่าทรัพยากรเหล่านั้นจะได้รับคลาสของกฎการขึ้นต่อกันโดยตรงหรือไม่ ซึ่งก็คือ "แม่นยำ" หมายความว่าจะมีการเพิ่มเฉพาะด้านที่อาจทำงานอยู่ตามคลาสกฎของทรัพยากร Dependency โดยตรง โปรดทราบว่าโหมดแม่นยำต้องมีการโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียว ซึ่งจะทำให้ช้ากว่าโหมดอื่นๆ และโปรดทราบด้วยว่า โหมดแม้กระทั่งที่แม่นยำก็ไม่ได้แม่นยำทั้งหมด การตัดสินใจว่าจะคำนวณด้านใดด้านหนึ่งหรือไม่จะทำในขั้นตอนการวิเคราะห์ ซึ่งจะไม่ทำงานระหว่าง "การค้นหาแบบงัดแงะ"
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]consistent_labels
: "เท็จ" -
หากเปิดใช้งาน ทุกคำสั่งการค้นหาจะแสดงป้ายกำกับประหนึ่งว่าด้วย Starlark <code>str</code> ที่ใช้กับ<code>ป้ายกำกับ</code> อินสแตนซ์ ซึ่งมีประโยชน์สำหรับเครื่องมือที่จำเป็นต้องจับคู่เอาต์พุตของคำสั่งการค้นหาและ/หรือป้ายกำกับต่างๆ ที่กฎเรียกใช้ หากไม่เปิดใช้ ตัวจัดรูปแบบเอาต์พุตจะแสดงชื่อที่เก็บที่ชัดเจน (สัมพันธ์กับที่เก็บหลัก) แทนเพื่อทำให้เอาต์พุตอ่านได้ง่ายขึ้น
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]experimental_explicit_aspects
: "เท็จ" -
aquery, cquery: จะรวมการทำงานที่สร้างโดยมุมมองไว้ในเอาต์พุตหรือไม่ คำค้นหา: ไม่มีการดำเนินการ (ติดตามเสมอ)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]graph:factored
: "true" -
หากเป็น "จริง" กราฟจะแสดงผลแบบ "แยกตัวประกอบ" นั่นคือ โหนดที่เท่าเทียมกันทางโทโพโลจีจะผสานเข้าด้วยกันและป้ายกำกับของโหนดทั้งสองเชื่อมติดกัน ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้น
--graph:node_limit=<an integer>
: "512" -
ความยาวสูงสุดของสตริงป้ายกำกับสำหรับโหนดกราฟในเอาต์พุต ป้ายกำกับที่ยาวขึ้นจะถูกตัด -1 หมายถึงไม่มีการตัดข้อความ ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]implicit_deps
: "true" -
หากเปิดใช้ การขึ้นต่อกันโดยปริยายจะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ทรัพยากร Dependency โดยนัยคือทรัพยากรที่ไม่มีการระบุอย่างชัดแจ้งในไฟล์ BUILD แต่เพิ่มโดย Bazel สำหรับ cquery ตัวเลือกนี้จะควบคุมการกรอง Toolchain ที่มีการแก้ปัญหาแล้ว
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]include_aspects
: "true" -
aquery, cquery: จะรวมการทำงานที่สร้างโดยมุมมองไว้ในเอาต์พุตหรือไม่ คำค้นหา: ไม่มีการดำเนินการ (ติดตามเสมอ)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]incompatible_package_group_includes_double_slash
: "true" -
หากเปิดใช้ เมื่อแสดงแอตทริบิวต์ "packages" ของpackage_group จะไม่ละเว้น "//" ที่นำหน้า
แท็ก:terminal_output
incompatible_change
- ค่าเริ่มต้น
--[no]infer_universe_scope
: "เท็จ" -
หากตั้งค่า และ --universe_scope ไม่ได้ตั้งค่าไว้ ระบบจะอนุมานค่าของ --universe_scope เป็นรายการรูปแบบเป้าหมายที่ไม่ซ้ำกันในนิพจน์การค้นหา โปรดทราบว่าค่า --universe_scope ที่อนุมานสำหรับนิพจน์การค้นหาที่ใช้ฟังก์ชันที่กําหนดขอบเขตระดับจักรวาล (เช่น "allrdeps") อาจไม่ใช่สิ่งที่คุณต้องการ คุณจึงควรใช้ตัวเลือกนี้ก็ต่อเมื่อคุณทราบว่าคุณกำลังทำอะไรอยู่เท่านั้น ดูรายละเอียดและตัวอย่างได้ที่ https://bazel.build/reference/query#sky-query หากตั้งค่า --universe_scope ค่า ระบบจะไม่สนใจค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้ใช้ได้เฉพาะกับ "query" (กล่าวคือ ไม่ใช่ "cquery")
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]line_terminator_null
: "เท็จ" -
เลือกว่าจะสิ้นสุดแต่ละรูปแบบด้วย \0 แทนการขึ้นบรรทัดใหม่หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]nodep_deps
: "true" -
หากเปิดใช้ ระบบจะแยกออกจาก "nodep" จะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ตัวอย่างทั่วไปของ "nodep" คือ "visibility" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ "info create-language" เพื่อดูข้อมูลเกี่ยวกับ "nodep" ทั้งหมด ในภาษาของบิลด์
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--output=<a string>
: "ป้ายกำกับ" -
รูปแบบที่ควรพิมพ์ผลการค้นหา cquery ค่าที่อนุญาตสำหรับ cquery มีดังนี้: label, label_kind, textผสานรวม, ทรานซิชัน, โปรโต, โปรโมท สตรีม โปรโต, JSONโปรโตคอล หากเลือก "การเปลี่ยน" คุณต้องระบุตัวเลือก --transitions=(lite|full) ด้วย
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:default_values
: "true" -
หากเป็น "จริง" ระบบจะรวมแอตทริบิวต์ที่ไม่ได้ระบุไว้อย่างชัดเจนในไฟล์ BUILD มิฉะนั้นจะถูกละเว้น ตัวเลือกนี้ใช้ได้กับ --output=prof
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:definition_stack
: "เท็จ" -
ป้อนข้อมูลในช่อง Proto ของ Definition_stack ซึ่งบันทึกสำหรับสแต็กการเรียกใช้ Starlark สำหรับแต่ละอินสแตนซ์ของกฎ ณ เวลาที่มีการกำหนดคลาสของกฎ
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:flatten_selects
: "true" -
หากเปิดใช้ ระบบจะแยกแอตทริบิวต์ที่กำหนดค่าได้ซึ่งสร้างโดย select() ไว้ในรูปแบบ สำหรับประเภทรายการ การแสดงแบบ "แยกเป็นหลายรายการ" คือรายการซึ่งประกอบด้วยแต่ละค่าของแผนที่ที่เลือกเพียงครั้งเดียว ระบบจะแยกประเภทสเกลาร์เป็นค่าว่าง
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]proto:include_attribute_source_aspects
: "เท็จ" -
ป้อนข้อมูลในช่อง Proto ของ source_aspect_name ของแต่ละแอตทริบิวต์ด้วยลักษณะต้นทางของแอตทริบิวต์นั้น (สตริงว่างเปล่าหากไม่มีข้อมูล)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:include_configurations
: "true" -
หากเปิดใช้ เอาต์พุต Proto จะมีข้อมูลเกี่ยวกับการกำหนดค่า เมื่อปิดใช้งาน รูปแบบเอาต์พุต Proto ของ cquery จะมีลักษณะคล้ายกับรูปแบบเอาต์พุตของการค้นหา
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]proto:include_synthetic_attribute_hash
: "เท็จ" -
คำนวณและเติมข้อมูลแอตทริบิวต์ $internal_attr_hash หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:instantiation_stack
: "เท็จ" -
ป้อนข้อมูลสแต็กการเรียกใช้การสร้างอินสแตนซ์ของแต่ละกฎ โปรดทราบว่าการดำเนินการนี้ต้องมีสแต็กอยู่
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:locations
: "true" -
ระบุว่าจะแสดงข้อมูลตำแหน่งในเอาต์พุต Pro เลยหรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้น
--proto:output_rule_attrs=<comma-separated list of options>
: "ทั้งหมด" -
รายการแอตทริบิวต์ที่คั่นด้วยจุลภาคที่จะรวมในเอาต์พุต ค่าเริ่มต้นคือแอตทริบิวต์ทั้งหมด ตั้งค่าเป็นสตริงว่างเปล่าเพื่อไม่ให้แสดงแอตทริบิวต์ใดๆ ตัวเลือกนี้ใช้ได้กับ --output=protocol
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:rule_inputs_and_outputs
: "true" -
เติมข้อมูลในช่อง rules_input และ rules_output หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--query_file=<a string>
: "" -
หากมีการตั้งค่าไว้ การค้นหาจะอ่านการค้นหาจากไฟล์ที่มีชื่อที่นี่ แทนที่จะเป็นบรรทัดคำสั่ง การระบุไฟล์ที่นี่และคำค้นหาบรรทัดคำสั่งเป็นข้อผิดพลาด
แท็ก:changes_inputs
- ค่าเริ่มต้น
--[no]relative_locations
: "เท็จ" -
หากเป็นจริง ตำแหน่งของไฟล์ BUILD ใน XML และเอาต์พุต Pro จะสัมพันธ์กัน โดยค่าเริ่มต้น เอาต์พุตตำแหน่งจะเป็นเส้นทางสัมบูรณ์และจะไม่สอดคล้องกันในแต่ละเครื่อง คุณสามารถตั้งค่าตัวเลือกนี้เป็น "จริง" เพื่อให้ได้ผลลัพธ์ที่สอดคล้องกันในอุปกรณ์ทุกเครื่อง
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--show_config_fragments=<off, direct or transitive>
: "ปิด" -
แสดงส่วนย่อยการกำหนดค่าที่กฎจำเป็นต้องใช้และทรัพยากร Dependency แบบทรานซิทีฟ วิธีนี้จะมีประโยชน์ในการประเมินว่าสามารถตัดกราฟเป้าหมายที่กำหนดค่าไว้ได้มากน้อยเพียงใด
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--starlark:expr=<a string>
: "" -
นิพจน์ Starlark เพื่อจัดรูปแบบเป้าหมายที่กำหนดค่าแต่ละรายการในโหมด --output=starlark ของ cquery เป้าหมายที่กำหนดค่าไว้เชื่อมโยงกับ "เป้าหมาย" ถ้าไม่ได้ระบุทั้ง --starlark:expr หรือ --starlark:file ตัวเลือกนี้จะมีค่าเริ่มต้นเป็น "str(target.label)" มีข้อผิดพลาดในการระบุทั้ง --starlark:expr และ --starlark:file
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--starlark:file=<a string>
: "" -
ชื่อไฟล์ที่กำหนดฟังก์ชัน Starlark ที่เรียกว่า "format" ของอาร์กิวเมนต์ 1 รายการ ซึ่งใช้กับเป้าหมายที่กำหนดค่าแต่ละรายการเพื่อจัดรูปแบบเป็นสตริง มีข้อผิดพลาดในการระบุทั้ง --starlark:expr และ --starlark:file ดูความช่วยเหลือสำหรับ --output=starlark สำหรับรายละเอียดเพิ่มเติม
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]tool_deps
: "true" -
การค้นหา: หากปิดใช้ ทรัพยากร Dependency ใน "การกำหนดค่า exec" จะไม่รวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน "การกำหนดค่าการดำเนินการ" เอดจ์ของทรัพยากร Dependency เช่น ขีดจำกัดจาก "proto_library" ให้กับโปรโตคอลคอมไพเลอร์ ซึ่งโดยทั่วไปจะชี้ไปยังเครื่องมือที่ดำเนินการระหว่างการสร้างแทนที่จะเป็นส่วนของ "เป้าหมาย" เดียวกัน ของโปรแกรม
Cquery: หากปิดใช้ จะกรองเป้าหมายที่กำหนดค่าไว้ทั้งหมดซึ่งข้ามการเปลี่ยนการดำเนินการจากเป้าหมายระดับบนสุดที่ค้นพบเป้าหมายที่กำหนดค่าไว้นี้ออก ซึ่งหมายความว่าหากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าเป้าหมาย ระบบจะแสดงผลเฉพาะเป้าหมายที่กำหนดค่าไว้ในการกำหนดค่าเป้าหมายด้วย ถ้าเป้าหมายระดับบนสุดอยู่ในการกำหนดค่า exec ระบบจะแสดงผลเฉพาะเป้าหมายที่กำหนดค่าของ exec เท่านั้น ตัวเลือกนี้จะ "ไม่" ยกเว้น Toolchain ที่แก้ไขแล้ว
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--transitions=<full, lite or none>
: "ไม่มี" -
รูปแบบที่ cquery จะพิมพ์ข้อมูลการเปลี่ยน
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--universe_scope=<comma-separated list of options>
: "" -
ชุดรูปแบบเป้าหมายที่คั่นด้วยคอมมา (บวกและลบ) การค้นหาอาจดำเนินการในจักรวาลที่กำหนดโดยการปิดแบบสับเปลี่ยนของเป้าหมายที่ระบุ ตัวเลือกนี้ใช้สําหรับคำสั่งการค้นหาและคำสั่ง cquery
สำหรับ cquery อินพุตของตัวเลือกนี้จะเป็นเป้าหมายในการสร้างคำตอบทั้งหมด ดังนั้นตัวเลือกนี้อาจส่งผลต่อการกําหนดค่าและการเปลี่ยน หากไม่ได้ระบุตัวเลือกนี้ ระบบจะถือว่าเป้าหมายระดับบนสุดเป็นเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหา หมายเหตุ: สำหรับ cquery การไม่ระบุตัวเลือกนี้อาจทำให้บิลด์ไม่ทำงานหากเป้าหมายที่แยกวิเคราะห์จากนิพจน์คำค้นหาไม่สามารถสร้างได้ด้วยตัวเลือกระดับบนสุด
แท็ก:loading_and_analysis
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์:
- ค่าเริ่มต้น
--[no]experimental_inprocess_symlink_creation
: "เท็จ" -
เลือกว่าจะเรียกใช้ระบบไฟล์โดยตรงเพื่อสร้างต้นไม้ Symlink หรือไม่
แท็ก:loading_and_analysis
,execution
,experimental
- ค่าเริ่มต้น
--[no]experimental_persistent_aar_extractor
: "เท็จ" -
เปิดใช้เครื่องมือแยก Aar แบบถาวรโดยใช้ผู้ปฏิบัติงาน
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_remotable_source_manifests
: "เท็จ" -
ต้องการให้การดำเนินการในไฟล์ Manifest ของแหล่งที่มาทำซ้ำได้หรือไม่
แท็ก:loading_and_analysis
,execution
,experimental
- ค่าเริ่มต้น
--[no]experimental_split_coverage_postprocessing
: "เท็จ" -
หากเป็น "จริง" Bazel จะดำเนินการประมวลผลภายหลังสำหรับการครอบคลุมในการทดลองที่สร้างขึ้นใหม่
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_strict_fileset_output
: "เท็จ" -
หากเปิดใช้ตัวเลือกนี้ ชุดไฟล์จะถือว่าอาร์ติแฟกต์เอาต์พุตทั้งหมดเป็นไฟล์ทั่วไป โดยจะไม่ข้ามผ่านไดเรกทอรีหรือไวต่อลิงก์สัญลักษณ์
แท็ก:execution
- ค่าเริ่มต้น
--[no]incompatible_modify_execution_info_additive
: "เท็จ" -
เมื่อเปิดใช้ การส่งแฟล็ก --modify_execution_info หลายรายการจะเป็นแบบบวกเพิ่ม เมื่อปิดใช้ ระบบจะพิจารณาเฉพาะธงล่าสุดเท่านั้น
แท็ก:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
รายการ -
เพิ่มหรือนำคีย์ออกจากข้อมูลการดำเนินการของการดำเนินการตามความสามารถในการจำการดำเนินการ ใช้กับการดำเนินการที่รองรับข้อมูลการดำเนินการเท่านั้น การดำเนินการทั่วไปจำนวนมากรองรับข้อมูลการดำเนินการ เช่น Genrule, CppCompile, Javac, StarlarkAction, TestRunner เมื่อระบุค่าหลายค่า ลำดับมีความสำคัญเนื่องจาก regexe หลายรายการอาจใช้กับช่วยจำเดียวกันได้
ไวยากรณ์: "regex=[+-]key,regex=[+-]key,..."
ตัวอย่าง:
'.*=+x,.*=-y,.*=+z' เพิ่ม "x" และ "z" ถึง และนำ "y" ออก ข้อมูลการดำเนินการสำหรับการดำเนินการทั้งหมด
'Genrule=+requires-x' เพิ่ม "requires-x" กับข้อมูลการดำเนินการสำหรับการดำเนินการ Genrule ทั้งหมด
'(?!Genrule).*=-requires-x' นำ "requires-x" ออก จากข้อมูลการดำเนินการสำหรับการดำเนินการ
ที่ไม่ใช่ Genrule ทั้งหมด
แท็ก:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
เปิดใช้การดำเนินการ Dex และ desugar ของ Android แบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
แท็ก:host_machine_resource_optimizations
execution
--persistent_android_resource_processor
-
เปิดใช้ผู้ประมวลผลข้อมูลทรัพยากร Android ถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
เปิดใช้การดำเนินการ Dex และ desugar ของ Android แบบมัลติเพล็กซ์โดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
เปิดใช้เครื่องมือประมวลผลทรัพยากร Android แบบมัลติเพล็กซ์แบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
เปิดใช้เครื่องมือ Android แบบต่อเนื่องและแบบมัลติเพล็กซ์ (Dexing, Deugaring, Resource Operations)
ขยายเป็น
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
แท็ก:host_machine_resource_optimizations
execution
- ค่าเริ่มต้น
--[no]use_target_platform_for_tests
: "เท็จ" -
หากเป็น "จริง" Bazel จะใช้แพลตฟอร์มเป้าหมายในการทำการทดสอบแทนกลุ่มผู้บริหารทดสอบ
แท็ก:execution
- ตัวเลือกที่กำหนดค่า Toolchain ที่ใช้สำหรับการดำเนินการมีดังนี้
- ค่าเริ่มต้น
--android_compiler=<a string>
: ดูคำอธิบาย -
คอมไพเลอร์เป้าหมายของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_manifest_merger=<legacy, android or force_android>
: "android" -
เลือกการควบรวมไฟล์ Manifest ที่จะใช้กับกฎ android_binary แจ้งเพื่อช่วยให้เปลี่ยนไปใช้การผสานรวมไฟล์ Manifest ของ Android จากการควบรวมเดิม
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_platforms=<a build target label>
: "" -
ตั้งค่าแพลตฟอร์มที่ android_binary กำหนดเป้าหมายใช้ หากระบุหลายแพลตฟอร์ม ไบนารีนั้นจะเป็น APK แบบอ้วน ซึ่งมีไบนารีแบบเนทีฟสำหรับแต่ละแพลตฟอร์มเป้าหมายที่ระบุ
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_sdk=<a build target label>
: "@bazel_tools//tools/android:sdk" -
ระบุ SDK/แพลตฟอร์ม Android ที่ใช้สร้างแอปพลิเคชัน Android
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้ในกฎของ Apple และ Objc และทรัพยากร Dependency
แท็ก:loses_incremental_state
changes_inputs
- ค่าเริ่มต้นของ
--cc_output_directory_tag=<a string>
: "" -
ระบุคำต่อท้ายที่จะเพิ่มในไดเรกทอรีการกำหนดค่า
แท็ก:affects_outputs
- ค่าเริ่มต้น
--compiler=<a string>
: ดูคำอธิบาย -
คอมไพเลอร์ C++ ที่จะใช้สำหรับการคอมไพล์เป้าหมาย
แท็ก:loading_and_analysis
execution
--coverage_output_generator=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:lcov_merger"-
ตำแหน่งของไบนารีที่ใช้เพื่อประมวลผลรายงานการครอบคลุมแบบข้อมูลดิบหลังการประมวลผล ซึ่งต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งก็คือไบนารี ค่าเริ่มต้นคือ "//tools/test:lcov_merger"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_report_generator"-
ตําแหน่งของไบนารีที่ใช้สร้างรายงานการครอบคลุม ซึ่งต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งก็คือไบนารี ค่าเริ่มต้นคือ "//tools/test:coverage_report_generator"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_support"-
ตำแหน่งของไฟล์สนับสนุนที่จำเป็นต้องใช้ในอินพุตของการดำเนินการทดสอบทั้งหมดที่รวบรวมการครอบคลุมของโค้ด ค่าเริ่มต้นคือ "//tools/test:coverage_support"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--custom_malloc=<a build target label>
: ดูคำอธิบาย -
ระบุการใช้งาน Malloc ที่กำหนดเอง การตั้งค่านี้จะลบล้างแอตทริบิวต์ Malloc ในกฎบิลด์
แท็ก:changes_inputs
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
รายการ -
รายการนิพจน์ทั่วไปที่คั่นด้วยคอมมา แต่ละรายการจะมีคำนำหน้าด้วย - (นิพจน์เชิงลบ) และกำหนด (=) ให้กับรายการเป้าหมายค่าข้อจำกัดที่คั่นด้วยคอมมา หากเป้าหมายตรงกับที่ไม่มีนิพจน์เชิงลบ และนิพจน์เชิงบวกอย่างน้อย 1 รายการ การแปลง Toolchain จะดำเนินการเสมือนว่าได้ประกาศค่าข้อจำกัดเป็นข้อจำกัดการดำเนินการ ตัวอย่าง: //demo,-test=@platforms//cpus:x86_64 จะเพิ่ม "x86_64" ไปยังเป้าหมายใดๆ ภายใต้ //demo ยกเว้นเป้าหมายที่ชื่อมี "test"
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_include_xcode_execution_requirements
: "เท็จ" -
เมื่อตั้งค่าแล้ว ให้เพิ่ม "requires-xcode:{version}" สำหรับการดำเนินการของ Xcode ทุกครั้ง หากเวอร์ชัน Xcode มีป้ายกำกับขีดกลาง ให้เพิ่ม "requires-xcode-label:{version_label}" ด้วย ข้อกำหนดของการดำเนินการ
แท็ก:loses_incremental_state
,loading_and_analysis
,execution
- ค่าเริ่มต้น
--[no]experimental_prefer_mutual_xcode
: "true" -
หากเป็นจริง ให้ใช้ Xcode ล่าสุดที่พร้อมใช้งานทั้งในเครื่องและจากระยะไกล หากเป็นเท็จหรือไม่มีเวอร์ชันที่ใช้ร่วมกัน ให้ใช้เวอร์ชันของ Xcode ในเครื่องที่เลือกผ่าน xcode-select
แท็ก:loses_incremental_state
- ค่าเริ่มต้นของ
--extra_execution_platforms=<comma-separated list of options>
: "" -
แพลตฟอร์มที่มีให้ใช้งานเป็นแพลตฟอร์มการดำเนินการเพื่อเรียกใช้การดำเนินการ สามารถระบุแพลตฟอร์มโดยเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมาย แพลตฟอร์มเหล่านี้จะได้รับการพิจารณาก่อนแพลตฟอร์มที่ประกาศในไฟล์ WORKSPACE โดยregister_execution_platforms() ตัวเลือกนี้ตั้งค่าได้เพียงครั้งเดียว อินสแตนซ์ภายหลังจะลบล้างการตั้งค่าแฟล็กก่อนหน้า
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--extra_toolchains=<comma-separated list of options>
รายการ -
กฎ Toolchain ที่จะต้องพิจารณาระหว่างการแก้ไข Toolchain สามารถระบุ Toolchains ตามเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมายได้ ระบบจะพิจารณา Toolchain เหล่านี้ก่อนการประกาศในไฟล์ WORKSPACE โดยregister_toolchains()
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--grte_top=<a label>
: ดูคำอธิบาย -
ป้ายกำกับไปยังไลบรารี libc ที่มีการเช็คอิน Crosstool Toolchain จะเลือกค่าเริ่มต้นและคุณแทบจะไม่จำเป็นต้องลบล้างค่าเริ่มต้น
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--host_compiler=<a string>
: ดูคำอธิบาย -
แฟล็กที่ไม่มีการดำเนินการ ระบบจะนำออกในรุ่นถัดไป
แท็ก:loading_and_analysis
execution
- ค่าเริ่มต้น
--host_grte_top=<a label>
: ดูคำอธิบาย -
ถ้าระบุ การตั้งค่านี้จะลบล้างไดเรกทอรีระดับบนสุดของ libc (--grte_top) สำหรับการกำหนดค่าผู้บริหาร
แท็ก:action_command_lines
affects_outputs
--host_platform=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools:host_platform"-
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายระบบโฮสต์
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--[no]incompatible_bazel_test_exec_run_under
: "เท็จ" -
หากเปิดใช้ "การทดสอบ bazel --run_under=//:runner" บิลด์ "//:runner" ในการกำหนดค่า exec หากปิดใช้ จะสร้าง "//:runner" ในการกำหนดค่าเป้าหมาย Bazel ทำการทดสอบบนเครื่องปฏิบัติการ ดังนั้นเครื่องแรกจึงถูกต้องกว่า ซึ่งไม่ส่งผลกับ "Bazel Run" ซึ่งจะสร้าง "`--run_under=//foo" เสมอ ในการกำหนดค่าเป้าหมาย
แท็ก:affects_outputs
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_apple_toolchain_resolution
: "เท็จ" -
ใช้ความละเอียดของ Toolchain เพื่อเลือก Apple SDK สำหรับกฎของ Apple (Starlark และเนทีฟ)
แท็ก: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_strip_executable_safely
: "เท็จ" -
หากเป็น "จริง" การดำเนินการตัดไฟล์สำหรับไฟล์ปฏิบัติการจะใช้แฟล็ก -x ซึ่งไม่ส่งผลกับความละเอียดของสัญลักษณ์แบบไดนามิก
แท็ก:action_command_lines
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
,immutable
- ค่าเริ่มต้นของ
--platforms=<a build target label>
: "" -
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายแพลตฟอร์มเป้าหมายสำหรับคำสั่งปัจจุบัน
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--python_path=<a string>
: ดูคำอธิบาย -
Absolute Path ของล่าม Python มีการเรียกใช้เป้าหมาย Python บนแพลตฟอร์มเป้าหมาย เลิกใช้งาน; ปิดใช้งานโดย --incompatible_use_python_toolchains
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้น
--python_top=<a build target label>
: ดูคำอธิบาย -
ป้ายกำกับของ py_runtime ที่แทนอินเทอร์พรีเตอร์ Python ได้มีการเรียกให้เรียกใช้เป้าหมาย Python บนแพลตฟอร์มเป้าหมาย เลิกใช้งาน; ปิดใช้งานโดย --incompatible_use_python_toolchains
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้น
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
ระบุเวอร์ชันของ tvOS SDK ที่จะใช้สร้างแอปพลิเคชัน tvOS หากไม่ระบุ ระบบจะใช้เวอร์ชันเริ่มต้นของ tvOS SDK จาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
ระบุเวอร์ชันของ WatchOS SDK ที่จะใช้สร้างแอปพลิเคชัน watchOS หากไม่ระบุ ระบบจะใช้เวอร์ชัน WatchOS SDK เริ่มต้นจาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--xcode_version=<a string>
: ดูคำอธิบาย -
หากระบุไว้ ให้ใช้ Xcode ของเวอร์ชันที่ระบุสำหรับการดำเนินการของบิลด์ที่เกี่ยวข้อง หากไม่ระบุ ระบบจะใช้ Xcode เวอร์ชันเริ่มต้นของผู้ดำเนินการ
แท็ก:loses_incremental_state
--xcode_version_config=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:host_xcodes"-
ป้ายกำกับของกฎ xcode_config ที่จะใช้สำหรับเลือกเวอร์ชัน Xcode ในการกำหนดค่าบิลด์
แท็ก:loses_incremental_state
loading_and_analysis
- มีดังนี้
- ค่าเริ่มต้น
--[no]apple_generate_dsym
: "เท็จ" -
เลือกว่าจะสร้างไฟล์สัญลักษณ์การแก้ไขข้อบกพร่อง (.dSYM) หรือไม่
แท็ก:affects_outputs
action_command_lines
- ค่าเริ่มต้น
--[no]build_runfile_links
: "true" -
หากเป็น "จริง" ให้สร้างศูนย์การเรียกใช้ไฟล์ symlink สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้เขียนเมื่อต้องใช้การดำเนินการในเครื่อง ทดสอบ หรือเรียกใช้คำสั่งเท่านั้น
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]build_runfile_manifests
: "true" -
หากเป็น "จริง" ให้เขียนไฟล์ Manifest ของการเรียกใช้ไฟล์สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้ละเว้น การทดสอบในเครื่องจะทํางานไม่ได้หากเป็นเท็จ
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]build_test_dwp
: "เท็จ" -
หากเปิดใช้ เมื่อสร้างการทดสอบ C++ แบบคงที่ และด้วยฟิชชัน ไฟล์ .dwp สำหรับไบนารีการทดสอบจะสร้างขึ้นโดยอัตโนมัติเช่นกัน
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้นของ
--cc_proto_library_header_suffixes=<comma-separated set of options>
: ".pb.h" -
ตั้งค่าคำต่อท้ายของไฟล์ส่วนหัวที่ cc_proto_library สร้างขึ้น
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--cc_proto_library_source_suffixes=<comma-separated set of options>
: ".pb.cc" -
ตั้งค่าคำต่อท้ายของไฟล์ต้นฉบับที่ cc_protocol_library สร้างขึ้น
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_proto_descriptor_sets_include_source_info
: "เท็จ" -
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันอื่นๆ ใน protocol_library
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_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
- ค่าเริ่มต้น
--[no]android_databinding_use_androidx
: "true" -
สร้างไฟล์การเชื่อมโยงข้อมูลที่ใช้กับ AndroidX ได้ ใช้ได้เฉพาะกับการเชื่อมโยงข้อมูล v2 เท่านั้น แฟล็กนี้ไม่มีการใช้งาน
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]android_databinding_use_v3_4_args
: "true" -
ใช้ Android Databinding v2 ที่มีอาร์กิวเมนต์ 3.4.0 แฟล็กนี้ไม่มีการใช้งาน
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้นของ
--android_dynamic_mode=<off, default or fully>
: "ปิด" -
กำหนดว่าจะให้ลิงก์ C++ ของกฎ Android แบบไดนามิกหรือไม่ เมื่อ cc_binary ไม่ได้สร้างไลบรารีที่ใช้ร่วมกันอย่างชัดแจ้ง "ค่าเริ่มต้น" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "สมบูรณ์" หมายความว่าไลบรารีทั้งหมดจะลิงก์แบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "ตามตัวอักษร" -
ตั้งค่าลำดับของไฟล์ Manifest ที่ส่งไปยังการรวมไฟล์ Manifest สำหรับไบนารีของ Android อัลฟ่าหมายความว่าไฟล์ Manifest ได้รับการจัดเรียงตามเส้นทางที่สัมพันธ์กับผู้ดำเนินการ ALPHABETICAL_BY_CONFIGURATION หมายความว่าไฟล์ Manifest ได้รับการจัดเรียงตามเส้นทางที่สัมพันธ์กับไดเรกทอรีการกำหนดค่าภายในไดเรกทอรีเอาต์พุต DEPENDENCY หมายความว่าไฟล์ Manifest จะเรียงลำดับตามไฟล์ Manifest ของไลบรารีแต่ละรายการที่อยู่ก่อนไฟล์ Manifest ของทรัพยากร Dependency
แท็ก:action_command_lines
execution
- ค่าเริ่มต้น
--[no]android_resource_shrinking
: "เท็จ" -
เปิดใช้การย่อทรัพยากรสำหรับ APK android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]build_python_zip
: "อัตโนมัติ" -
สร้าง ZIP ที่เป็นไฟล์ปฏิบัติการ Python ใน Windows และปิดบนแพลตฟอร์มอื่น
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--catalyst_cpus=<comma-separated list of options>
รายการ -
รายชื่อสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple Catalyst
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--[no]collect_code_coverage
: "เท็จ" -
หากระบุไว้ Bazel จะใช้โค้ดเครื่องมือวัด (โดยใช้การใช้เครื่องมือแบบออฟไลน์หากเป็นไปได้) และจะรวบรวมข้อมูลการครอบคลุมระหว่างการทดสอบ เฉพาะเป้าหมายที่ตรงกับ --instrumentation_filter จะได้รับผลกระทบ โดยปกติ ตัวเลือกนี้ไม่ควรระบุโดยตรง - "ความครอบคลุมของbazel" ควรใช้คำสั่งแทน
แท็ก:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] ค่าเริ่มต้น: "fastbuild"-
ระบุโหมดที่จะมีการสร้างไบนารี ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--conlyopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--copt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง gcc
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้นของ
--cpu=<a string>
: "" -
CPU เป้าหมาย
แท็ก:changes_inputs
affects_outputs
- ค่าเริ่มต้น
--cs_fdo_absolute_path=<a string>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ CSFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อเส้นทางสัมบูรณ์ของไฟล์ ZIP ที่มีไฟล์โปรไฟล์, ไฟล์ข้อมูล RAW หรือไฟล์โปรไฟล์ LLVM ที่จัดทำดัชนีไว้
แท็ก:affects_outputs
- ค่าเริ่มต้น
--cs_fdo_instrument=<a string>
: ดูคำอธิบาย -
สร้างไบนารีด้วยเครื่องมือ FDO ที่ละเอียดอ่อนตามบริบท เมื่อใช้คอมไพเลอร์ Clang/LLVM คีย์ดังกล่าวจะยอมรับชื่อไดเรกทอรีที่ระบบจะส่งออกไฟล์โปรไฟล์แบบ RAW ขณะรันไทม์ด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--cs_fdo_profile=<a build target label>
: ดูคำอธิบาย -
cs_fdo_profile แสดงถึงโปรไฟล์ที่ละเอียดอ่อนตามบริบทที่จะใช้ในการเพิ่มประสิทธิภาพ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--cxxopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C++
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--define=<a 'name=value' assignment>
รายการ -
ตัวเลือก --define แต่ละรายการจะระบุการมอบหมายสำหรับตัวแปรบิลด์ ในกรณีที่ตัวแปรหนึ่งมีค่าหลายค่า ค่าสุดท้ายจะชนะ
แท็ก:changes_inputs
affects_outputs
- ค่าเริ่มต้น
--dynamic_mode=<off, default or fully>
: "ค่าเริ่มต้น" -
กำหนดว่าจะลิงก์ไบนารีของ C++ แบบไดนามิกหรือไม่ "ค่าเริ่มต้น" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "สมบูรณ์" หมายความว่าไลบรารีทั้งหมดจะลิงก์แบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้น
--[no]enable_propeller_optimize_absolute_paths
: "true" -
หากตั้งค่าไว้ การใช้เส้นทางสัมบูรณ์สำหรับการเพิ่มประสิทธิภาพใบพัดจะทำให้เกิดข้อผิดพลาด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]enable_remaining_fdo_absolute_paths
: "true" -
ถ้ามีการตั้งค่า การใช้เส้นทางสัมบูรณ์สำหรับ FDO จะทำให้เกิดข้อผิดพลาด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]enable_runfiles
: "อัตโนมัติ" -
เปิดใช้โครงสร้างลิงก์สัญลักษณ์ของ Runfiles ซึ่งโดยค่าเริ่มต้น จะปิดอยู่ใน Windows และในแพลตฟอร์มอื่นๆ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_action_listener=<a build target label>
รายการ -
เลิกใช้งานไปทีละด้าน ใช้ action_listener เพื่อแนบทางลัดไปยังการดำเนินการบิลด์ที่มีอยู่
แท็ก:execution
experimental
- ค่าเริ่มต้น
--[no]experimental_android_compress_java_resources
: "เท็จ" -
บีบอัดทรัพยากร Java ใน APK
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_android_databinding_v2
: "true" -
ใช้ Android Data Binding v2 แฟล็กนี้ไม่มีการใช้งาน
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]experimental_android_resource_shrinking
: "เท็จ" -
เปิดใช้การย่อทรัพยากรสำหรับ APK android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_android_rewrite_dexes_with_rex
: "เท็จ" -
ใช้เครื่องมือ Rex เพื่อเขียนไฟล์ dex ใหม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]experimental_collect_code_coverage_for_generated_files
: "เท็จ" -
หากระบุไว้ Bazel จะสร้างการรวบรวมข้อมูลที่ครอบคลุมสำหรับไฟล์ที่สร้างขึ้นด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_objc_fastbuild_options=<comma-separated list of options>
: "-O0,-DDEBUG=1" -
ใช้สตริงเหล่านี้เป็นตัวเลือกคอมไพเลอร์ objc Fastbuild
แท็ก:action_command_lines
- ค่าเริ่มต้น
--[no]experimental_omitfp
: "เท็จ" -
หากเป็น "จริง" ให้ใช้ libunwind สำหรับการคลายสแต็ก แล้วคอมไพล์ด้วย -fomit-frame-pointer และ -fasynchronous-unwind-tables
แท็ก:action_command_lines
,affects_outputs
,experimental
- ค่าเริ่มต้นของ
--experimental_output_paths=<off, content or strip>
: "ปิด" -
โมเดลที่ควรใช้สำหรับส่วนใดในกฎแผนผังเอาต์พุตจะเขียนเอาต์พุต โดยเฉพาะอย่างยิ่งสำหรับบิลด์ที่มีหลายแพลตฟอร์ม / หลายการกำหนดค่า ฟีเจอร์นี้อยู่ในขั้นทดลอง ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/6526 การดำเนินการของ Starlark เลือกใช้การแมปเส้นทางได้ด้วยการเพิ่มคีย์ "supports-path-mapping" เป็น "execution_requirements" พิมพ์ตามคำบอก
แท็ก:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
รายการ -
แต่ละรายการควรอยู่ในรูปแบบ label=value โดยที่ป้ายกำกับอ้างอิงถึงแพลตฟอร์ม และค่าคือชื่อย่อที่ต้องการใช้ในเส้นทางเอาต์พุต ใช้เมื่อ --experimental_platform_in_output_dir เป็นจริงเท่านั้น มีลำดับความสำคัญในการตั้งชื่อสูงสุด
แท็ก:affects_outputs
experimental
- ค่าเริ่มต้น
--[no]experimental_platform_in_output_dir
: "เท็จ" -
หากเป็นจริง ระบบจะใช้ชื่อย่อของแพลตฟอร์มเป้าหมายในชื่อไดเรกทอรีเอาต์พุตแทน CPU รูปแบบที่แน่นอนอยู่ในขั้นทดลองและอาจมีการเปลี่ยนแปลง อย่างแรก ในกรณีซึ่งเกิดขึ้นไม่บ่อยนัก ตัวเลือก --platforms ไม่ได้มีค่าเพียงค่าเดียว ระบบจะใช้แฮชของตัวเลือกแพลตฟอร์ม ถัดไป หากชื่อย่อของแพลตฟอร์มปัจจุบันลงทะเบียนโดย --experimental_override_name_platform_in_output_dir ระบบจะใช้ชื่อย่อนั้น จากนั้น หากมีการตั้งค่า --experimental_use_platforms_in_output_dir_legacy_heurism ให้ใช้ชื่อย่อที่อ้างอิงจากป้ายกำกับแพลตฟอร์มปัจจุบัน สุดท้าย ระบบจะใช้แฮชของตัวเลือกแพลตฟอร์มเป็นทางเลือกสุดท้าย
แท็ก:affects_outputs
experimental
- ค่าเริ่มต้น
--[no]experimental_use_llvm_covmap
: "เท็จ" -
หากระบุ Bazel จะสร้างข้อมูลแผนที่ความครอบคลุมของ llvm-cov แทนที่จะเป็น gcov เมื่อเปิดใช้งานcollect_code_coverage
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
: "true" -
โปรดใช้แฟล็กนี้เป็นส่วนหนึ่งของกลยุทธ์การย้ายข้อมูลหรือการทดสอบที่แนะนำเท่านั้น โปรดทราบว่าการเรียนรู้มีข้อบกพร่องที่ทราบแล้ว และแนะนำให้เปลี่ยนไปใช้เพียง --experimental_override_name_platform_in_output_dir
แท็ก:affects_outputs
experimental
- ค่าเริ่มต้นของ
--fat_apk_cpu=<comma-separated set of options>
: "armeabi-v7a" -
การตั้งค่าตัวเลือกนี้จะเปิดใช้ APK แบบอ้วน ซึ่งมีไบนารีแบบเนทีฟสำหรับสถาปัตยกรรมเป้าหมายที่ระบุทั้งหมด เช่น --fat_apk_cpu=x86,armeabi-v7a. หากระบุแฟล็กนี้ ระบบจะละเว้น --android_cpu สำหรับทรัพยากร Dependency ของกฎ android_binary
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--fdo_instrument=<a string>
: ดูคำอธิบาย -
สร้างไบนารีด้วยเครื่องมือ FDO เมื่อใช้คอมไพเลอร์ Clang/LLVM คีย์ดังกล่าวจะยอมรับชื่อไดเรกทอรีที่ระบบจะส่งออกไฟล์โปรไฟล์แบบ RAW ขณะรันไทม์ด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_optimize=<a string>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ FDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อไฟล์ ZIP ที่มีแผนผังไฟล์ .gcda, ไฟล์ afdo ที่มีโปรไฟล์อัตโนมัติ หรือไฟล์โปรไฟล์ LLVM แฟล็กนี้ยอมรับไฟล์ที่ระบุเป็นป้ายกำกับด้วย (เช่น "//foo/bar:file.afdo" คุณอาจต้องเพิ่มคำสั่ง "exports_files" ไปยังแพ็กเกจที่เกี่ยวข้อง) และป้ายกำกับที่ชี้ไปยังเป้าหมาย "fdo_profile" การตั้งค่าสถานะนี้จะถูกแทนที่โดยกฎ "fdo_profile"
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_prefetch_hints=<a build target label>
: ดูคำอธิบาย -
ใช้คำแนะนำการดึงข้อมูลแคชล่วงหน้า
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_profile=<a build target label>
: ดูคำอธิบาย -
fdo_profile แทนโปรไฟล์ที่จะใช้ในการเพิ่มประสิทธิภาพ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--features=<a string>
รายการ -
ระบบจะเปิดใช้หรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างขึ้นในการกำหนดค่าเป้าหมาย กำลังระบุ -<feature> จะปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ ดูเพิ่มเติมที่ --host_features
แท็ก:changes_inputs
affects_outputs
- ค่าเริ่มต้น
--[no]force_pic
: "เท็จ" -
หากเปิดใช้งาน การคอมไพล์ C++ ทั้งหมดจะสร้างโค้ดที่ไม่ขึ้นอยู่กับตำแหน่ง ("-fPIC") ลิงก์จะใช้ไลบรารีที่สร้างไว้ล่วงหน้าของ PIC มากกว่าไลบรารีที่ไม่ใช่ PIC และลิงก์จะสร้างไฟล์ปฏิบัติการที่ไม่ขึ้นอยู่กับตำแหน่ง ("-pie")
แท็ก:loading_and_analysis
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_action_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกำหนดค่าการดำเนินการ คุณระบุตัวแปรได้ด้วยชื่อ ซึ่งในกรณีนี้ระบบจะนําค่าจากสภาพแวดล้อมการเรียกใช้ หรือคู่ name=value ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ ตัวเลือกนี้ใช้ได้หลายครั้ง สำหรับตัวเลือกที่ระบุสำหรับตัวแปรเดียวกัน ค่าที่ชนะล่าสุด และตัวเลือกของตัวแปรต่างๆ จะสะสมอยู่
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--host_compilation_mode=<fastbuild, dbg or opt>
: "opt" -
ระบุโหมดที่จะมีการสร้างเครื่องมือที่ใช้ในการสร้าง ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_conlyopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งไปยังคอมไพเลอร์ C เมื่อคอมไพล์ไฟล์ต้นฉบับ C (ไม่ใช่ C++) ในการกำหนดค่าผู้บริหาร
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_copt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยังคอมไพเลอร์ C สำหรับเครื่องมือที่สร้างขึ้นในการกำหนดค่าการดำเนินการ
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้นของ
--host_cpu=<a string>
: "" -
CPU ของโฮสต์
แท็ก:changes_inputs
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_cxxopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยังคอมไพเลอร์ C++ สำหรับเครื่องมือที่สร้างขึ้นในการกำหนดค่าดำเนินการ
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_features=<a string>
รายการ -
ระบบจะเปิดใช้หรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างขึ้นในการกำหนดค่า exec กำลังระบุ -<feature> จะปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ
แท็ก:changes_inputs
affects_outputs
- ค่าเริ่มต้น
--host_force_python=<PY2 or PY3>
: ดูคำอธิบาย -
ลบล้างเวอร์ชัน Python สำหรับการกำหนดค่า exec อาจเป็น "PY2" หรือ "PY3"
แท็ก:loading_and_analysis
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_linkopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง Linker เมื่อลิงก์เครื่องมือในการกำหนดค่าการดำเนินการ
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน macOS ที่เข้ากันได้ขั้นต่ำสำหรับเป้าหมายโฮสต์ หากไม่ได้ระบุ ให้ใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อเลือกส่งไปยังคอมไพเลอร์ C/C++ ที่เลือกเมื่อคอมไพล์ไฟล์บางไฟล์ในการกำหนดค่าผู้บริหาร ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจากรายการรวมและไม่รวมรูปแบบนิพจน์ทั่วไป (ดู --instrumentation_filter) ด้วย Option_1 กับ Option_n นั้นย่อมาจากตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ ในการแยกสตริงจะใช้เฉพาะ @ แรกเท่านั้น ตัวอย่าง: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--[no]incompatible_auto_exec_groups
: "เท็จ" -
เมื่อเปิดใช้ ระบบจะสร้างกลุ่มผู้บริหารสำหรับ Toolchain แต่ละรายการที่กฎใช้โดยอัตโนมัติ กฎในการทำงานนี้ต้องระบุพารามิเตอร์ "toolchain" ในการดำเนินการ ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/17134
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_merge_genfiles_directory
: "true" -
หากเป็นจริง ไดเรกทอรี genfiles จะถูกพับลงในไดเรกทอรี bin
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]instrument_test_targets
: "เท็จ" -
เมื่อเปิดใช้การครอบคลุม ให้ระบุว่าจะพิจารณาการใช้กฎการทดสอบการวัดคุมหรือไม่ เมื่อตั้งค่าแล้ว กฎการทดสอบที่ --instrumentation_filter รวมอยู่จะมีการวัดคุม มิฉะนั้น กฎการทดสอบจะถูกยกเว้นจากการวัดคุมการครอบคลุมเสมอ
แท็ก:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
ค่าเริ่มต้น: "-/javatests[/:],-/test/java[/:]"-
เมื่อเปิดใช้การครอบคลุม ระบบจะวัดเฉพาะกฎที่มีชื่อซึ่งตัวกรองตามนิพจน์ทั่วไปที่ระบุรวมอยู่เท่านั้น กฎที่ขึ้นต้นด้วย "-" จะได้รับการยกเว้นแทน โปรดทราบว่าระบบจะวัดคุมเฉพาะกฎที่ไม่ใช่การทดสอบเท่านั้น ยกเว้นกรณีที่เปิดใช้งาน --instrument_test_targets
แท็ก:affects_outputs
- ค่าเริ่มต้น
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน iOS ที่เข้ากันได้ขั้นต่ำสำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ระบุ ให้ใช้ "ios_sdk_version"
แท็ก:loses_incremental_state
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ios_multi_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างแอปพลิเคชัน ios_ ผลลัพธ์จะเป็นไบนารีสากลที่มีสถาปัตยกรรมที่ระบุทั้งหมด
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--[no]legacy_whole_archive
: "true" -
เลิกใช้งานแล้ว และมีผลแทนด้วย --inสามารถเข้าถึง_remove_legacy_whole_archive (ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7362) เมื่อเปิด ให้ใช้ --whole-archive สำหรับกฎ cc_binary ที่มี linkshared=True และ linkstatic=True หรือ '-static' ใน Linkopts วิธีนี้ใช้สำหรับความเข้ากันได้แบบย้อนหลังเท่านั้น อีกทางเลือกหนึ่งที่ดีกว่าคือการใช้ Alwayslink=1 เมื่อจำเป็น
แท็ก:action_command_lines
,affects_outputs
,deprecated
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--linkopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งไปยัง gcc เมื่อลิงก์
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ltobackendopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังขั้นตอนแบ็กเอนด์ของ LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ltoindexopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังขั้นตอนการจัดทำดัชนี LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--macos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple macOS
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน macOS ที่เข้ากันได้ขั้นต่ำสำหรับเป้าหมาย หากไม่ได้ระบุ ให้ใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--memprof_profile=<a build target label>
: ดูคำอธิบาย -
ใช้โปรไฟล์ Memprof
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]objc_debug_with_GLIBCXX
: "เท็จ" -
หากตั้งค่า และตั้งค่าโหมดการคอมไพล์เป็น "dbg" ให้กำหนด GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC และ GLIBCPP_CONCEPT_CHECKS
แท็ก:action_command_lines
- ค่าเริ่มต้น
--[no]objc_enable_binary_stripping
: "เท็จ" -
เลือกว่าจะดำเนินการลบสัญลักษณ์และโค้ดที่เสียหายในไบนารีที่ลิงก์หรือไม่ ระบบจะลบไบนารีหากระบุทั้ง Flag และ --compilation_mode=opt นี้
แท็ก:action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--objccopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ Objective-C/C++
แท็ก:action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งผ่านไปยัง gcc เฉพาะเมื่อคอมไพล์ไฟล์บางไฟล์ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจากรายการรวมและไม่รวมรูปแบบนิพจน์ทั่วไป (ดู --instrumentation_filter) ด้วย Option_1 กับ Option_n นั้นย่อมาจากตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ ในการแยกสตริงจะใช้เฉพาะ @ แรกเท่านั้น ตัวอย่าง: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับเลือกส่งไปยังแบ็กเอนด์ LTO (ในส่วน --features=thin_lto) เมื่อคอมไพล์ออบเจ็กต์แบ็กเอนด์บางรายการ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจาก รายการรูปแบบ รวมและยกเว้น ของนิพจน์ทั่วไป Option_1 กับ Option_n นั้นย่อมาจากตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ ในการแยกสตริงจะใช้เฉพาะ @ แรกเท่านั้น ตัวอย่าง: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่งแบ็กเอนด์ LTO ของไฟล์ o ทั้งหมดใน //foo/ ยกเว้น bar.o
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--platform_suffix=<a string>
: ดูคำอธิบาย -
ระบุคำต่อท้ายที่จะเพิ่มในไดเรกทอรีการกำหนดค่า
แท็ก:loses_incremental_state
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--propeller_optimize=<a build target label>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ Propeller เพื่อเพิ่มประสิทธิภาพเป้าหมายของบิลด์ โปรไฟล์ใบพัดต้องประกอบด้วยไฟล์อย่างน้อย 1 จาก 2 ไฟล์ โปรไฟล์สำเนา และโปรไฟล์ ld แฟล็กนี้ยอมรับป้ายกำกับบิลด์ซึ่งต้องอ้างถึงไฟล์อินพุตโปรไฟล์ใบพัด ตัวอย่างเช่น ไฟล์ BUILD ที่กำหนดป้ายกำกับใน a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)อาจต้องเพิ่มคำสั่ง ecommerce_files ลงในแพ็กเกจที่เกี่ยวข้องเพื่อให้ Bazel มองเห็นไฟล์เหล่านี้ ต้องใช้ตัวเลือกเป็น: --propeller_optimize=//a/b:propeller_profile
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--propeller_optimize_absolute_cc_profile=<a string>
: ดูคำอธิบาย -
ชื่อเส้นทางสัมบูรณ์ของไฟล์ cc_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพใบพัด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--propeller_optimize_absolute_ld_profile=<a string>
: ดูคำอธิบาย -
ชื่อเส้นทางสัมบูรณ์ของไฟล์ ld_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพใบพัด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--run_under=<a prefix in front of command>
: ดูคำอธิบาย -
คำนำหน้าที่จะแทรกก่อนไฟล์ปฏิบัติการสำหรับ "การทดสอบ" และ "เรียกใช้" คำสั่ง หากค่าคือ "foo -bar" และบรรทัดคำสั่งสำหรับการดำเนินการคือ "test_binary -baz" บรรทัดคำสั่งสุดท้ายคือ "foo -bar test_binary -baz" บรรทัดคำสั่งนี้อาจเป็นป้ายกำกับของเป้าหมายสั่งการได้ด้วย ตัวอย่างเช่น 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'
แท็ก:action_command_lines
-
หากจริง ระบบจะแชร์ไลบรารีเนทีฟที่มีฟังก์ชันการทำงานเหมือนกันกับเป้าหมายต่างๆ
แท็ก: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
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--tvos_cpus=<comma-separated list of options>
รายการ -
รายชื่อสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple tvOS
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน tvOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ระบุ ให้ใช้ "tvos_sdk_version"
แท็ก:loses_incremental_state
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--visionos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple visionOS
แท็ก:loses_incremental_state
loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--watchos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple WatchOS
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน WatchOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ได้ระบุ ให้ใช้ "watchos_sdk_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--xbinary_fdo=<a build target label>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ XbinaryFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อของโปรไฟล์แบบไบนารีที่เป็นค่าเริ่มต้น เมื่อใช้ตัวเลือกนี้ร่วมกับ --fdo_instrument/--fdo_optimize/--fdo_profile ตัวเลือกเหล่านั้นจะมีผลเหนือกว่าเสมอเสมือนว่าไม่ได้ระบุ xbinary_fdo
แท็ก:affects_outputs
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตบิลด์ที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมธง ฯลฯ)
- ค่าเริ่มต้น
--[no]check_licenses
: "เท็จ" -
ตรวจสอบว่าข้อจำกัดในการออกใบอนุญาตที่กำหนดโดยแพ็กเกจที่เกี่ยวข้องไม่ขัดแย้งกับโหมดการเผยแพร่ของเป้าหมายที่กำลังสร้าง โดยค่าเริ่มต้น ใบอนุญาตจะไม่ได้รับการตรวจสอบ
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]check_visibility
: "true" -
หากปิดใช้ ระบบจะลดระดับข้อผิดพลาดระดับการเข้าถึงในทรัพยากร Dependency เป้าหมายให้เหลือเพียงคําเตือน
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]desugar_for_android
: "true" -
เลือกว่าจะใช้ไบต์โค้ด Java 8 ก่อนถอดรหัสหรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--[no]desugar_java8_libs
: "เท็จ" -
เลือกว่าจะรวมไลบรารี Java 8 ที่รองรับในแอปสำหรับอุปกรณ์เดิมหรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]enforce_constraints
: "true" -
ตรวจสอบสภาพแวดล้อมที่แต่ละเป้าหมายใช้งานร่วมกันได้ และรายงานข้อผิดพลาดหากเป้าหมายมีทรัพยากร Dependency ที่ไม่รองรับสภาพแวดล้อมเดียวกัน
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]experimental_check_desugar_deps
: "true" -
ตรวจสอบความถูกต้องของการแยกน้ำตาลที่ระดับไบนารีของ Android อีกครั้งหรือไม่
แท็ก:eagerness_to_exit
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--experimental_import_deps_checking=<a string>
: ดูคำอธิบาย -
ไม่มีการดำเนินการ เก็บไว้สำหรับความเข้ากันได้แบบย้อนหลังเท่านั้น
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--experimental_one_version_enforcement=<off, warning or error>
: "ปิด" -
เมื่อเปิดใช้ ให้บังคับใช้ว่ากฎ java_binary จะมีไฟล์คลาสเดียวกันใน classpath มากกว่า 1 เวอร์ชันไม่ได้ การบังคับใช้นี้อาจทำให้บิลด์เสียหายหรืออาจทำให้เกิดคำเตือน
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "ค่าเริ่มต้น" -
หากเป็นจริง ให้ตรวจสอบว่าเป้าหมาย Java ประกาศเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency อย่างชัดเจน
แท็ก:build_file_semantics
eagerness_to_exit
- ค่าเริ่มต้น
--[no]incompatible_check_testonly_for_output_files
: "เท็จ" -
หากเปิดใช้ ให้ตรวจสอบ testonly สำหรับเป้าหมายที่จำเป็นเบื้องต้นที่เป็นไฟล์เอาต์พุตโดยค้นหา testonly ของกฎที่สร้าง รายการนี้ตรงกับการตรวจสอบระดับการเข้าถึง
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_check_visibility_for_toolchains
: "เท็จ" -
หากเปิดใช้ การตรวจสอบระดับการเข้าถึงจะมีผลกับการติดตั้งใช้งาน Toolchain ด้วย
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disable_native_android_rules
: "เท็จ" -
หากเปิดใช้ ระบบจะปิดใช้กฎที่มีอยู่สำหรับ Android โดยตรง โปรดใช้กฎของ Android Starlark จาก https://github.com/bazelbuild/rules_android
แท็ก:eagerness_to_exit
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disable_native_apple_binary_rule
: "เท็จ" -
ไม่มีการดำเนินการ เก็บไว้ที่นี่เพื่อดูความเข้ากันได้แบบย้อนหลัง
แท็ก:eagerness_to_exit
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_python_disable_py2
: "true" -
หากเป็น "จริง" การใช้การตั้งค่า Python 2 จะทำให้เกิดข้อผิดพลาด ซึ่งรวมถึง python_version=PY2, srcs_version=PY2 และ srcs_version=PY2ONLY ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/15684
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]one_version_enforcement_on_java_tests
: "true" -
เมื่อเปิดใช้ และตั้งค่า Experiment_one_version_enforcement เป็นค่าที่ไม่ใช่ NONE แล้ว ให้บังคับใช้ 1 เวอร์ชันกับเป้าหมาย java_test คุณสามารถปิดการแจ้งว่าไม่เหมาะสมนี้เพื่อปรับปรุงประสิทธิภาพการทดสอบให้ดียิ่งขึ้นได้ โดยไม่ต้องกลัวว่าจะมีการละเมิดเวอร์ชันใดเวอร์ชันหนึ่ง
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--python_native_rules_allowlist=<a build target label>
: ดูคำอธิบาย -
รายการที่อนุญาต (package_group target (เป้าหมายกลุ่มแพ็กเกจ) ที่จะใช้เมื่อบังคับใช้ --incompatible_python_disallow_native_rules
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]strict_filesets
: "เท็จ" -
หากเปิดใช้ตัวเลือกนี้ ระบบจะรายงานว่าชุดไฟล์ข้ามขอบเขตของแพ็กเกจเป็นข้อผิดพลาด
แท็ก:build_file_semantics
eagerness_to_exit
- ค่าเริ่มต้น
--strict_proto_deps=<off, warn, error, strict or default>
: "ข้อผิดพลาด" -
หากไม่ "ปิด" ให้ตรวจสอบว่าเป้าหมาย protocol_library ประกาศอย่างชัดแจ้งว่าเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้นของ
--strict_public_imports=<off, warn, error, strict or default>
: "ปิด" -
หากไม่ "ปิด" ให้ตรวจสอบว่าเป้าหมาย protocol_library ประกาศอย่างชัดเจนถึงเป้าหมายทั้งหมดที่ใช้ใน "นำเข้าสาธารณะ" ตามที่ส่งออกแล้ว
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้น
--[no]strict_system_includes
: "เท็จ" -
หากเป็น "จริง" ส่วนหัวที่พบผ่านทางระบบรวมเส้นทาง (-isystem) ต้องมีการประกาศด้วย
แท็ก:loading_and_analysis
eagerness_to_exit
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--target_environment=<a build target label>
รายการ -
ประกาศสภาพแวดล้อมเป้าหมายของบิลด์นี้ ต้องอ้างอิงถึงป้ายกำกับไปยัง "สภาพแวดล้อม" กฎ หากระบุ เป้าหมายระดับบนสุดทั้งหมดต้องเข้ากันได้กับสภาพแวดล้อมนี้
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อเอาต์พุตการลงชื่อของบิลด์:
- ค่าเริ่มต้น
--apk_signing_method=<v1, v2, v1_v2 or v4>
: "v1_v2" -
การใช้งานเพื่อรับรอง APK
แท็ก:action_command_lines
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--[no]device_debug_entitlements
: "true" -
หากมีการตั้งค่า และโหมดการคอมไพล์ไม่ใช่ "เพิ่มประสิทธิภาพ" แอป objc จะรวมการให้สิทธิ์การแก้ไขข้อบกพร่องเมื่อลงชื่อ
แท็ก:changes_inputs
- ค่าเริ่มต้น
--ios_signing_cert_name=<a string>
: ดูคำอธิบาย -
ชื่อใบรับรองที่จะใช้สำหรับ iOS Signing หากไม่ได้ตั้งค่า ระบบจะกลับไปใช้โปรไฟล์การจัดสรร อาจเป็นค่ากำหนดข้อมูลประจำตัว Keychain ของใบรับรองหรือ (สตริงย่อย) ของชื่อสามัญของใบรับรองตามหน้า man ของ Codesign (รหัสการลงชื่อเข้าใช้)
แท็ก:action_command_lines
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_disallow_legacy_py_provider
: "true" -
ไม่มีการดำเนินการ จะถูกนำออกในเร็วๆ นี้
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disallow_sdk_frameworks_attributes
: "เท็จ" -
หากเป็น "จริง" ไม่อนุญาตแอตทริบิวต์ sdk_frameworks และ external_sdk_frameworks ใน objc_library andobjc_import
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_objc_alwayslink_by_default
: "เท็จ" -
หากเป็น "จริง" ตั้งค่าเริ่มต้นเป็น "จริง" สำหรับแอตทริบิวต์ Alwayslink ใน objc_library และ objc_IMPORT
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_python_disallow_native_rules
: "เท็จ" -
เมื่อเป็นจริง เกิดข้อผิดพลาดขึ้นเมื่อใช้กฎ py_* ในตัว ควรใช้กฎ rules_python แทน ดูข้อมูลเพิ่มเติมและวิธีการย้ายข้อมูลได้ที่ https://github.com/bazelbuild/bazel/issues/17773
แท็ก:loading_and_analysis
incompatible_change
- สภาพแวดล้อมการทดสอบหรือตัวดำเนินการทดสอบ:
- ค่าเริ่มต้น
--[no]allow_analysis_failures
: "เท็จ" -
หากจริง การวิเคราะห์เป้าหมายของกฎไม่สำเร็จส่งผลให้เกิดการเผยแพร่อินสแตนซ์ของ AnalysisFailureInfo ของเป้าหมายที่มีคำอธิบายข้อผิดพลาด แทนที่จะทำให้บิลด์ไม่สำเร็จ
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--analysis_testing_deps_limit=<an integer>
: "2000" -
ตั้งค่าจำนวนสูงสุดของทรัพยากร Dependency แบบทรานซิทีฟผ่านแอตทริบิวต์กฎที่มีการเปลี่ยนการกำหนดค่า for_analysis_testing การใช้เกินขีดจำกัดนี้จะทำให้เกิดข้อผิดพลาดของกฎ
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]break_build_on_parallel_dex2oat_failure
: "เท็จ" -
หากความล้มเหลวจริงในการดำเนินการ dex2oat จะทำให้บิลด์เสียหายแทนที่จะเรียกใช้ dex2oat ระหว่างรันไทม์ทดสอบ
แท็ก:loading_and_analysis
experimental
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g memory=10,30,60,100>
รายการ - ลบล้างจำนวนทรัพยากรเริ่มต้นสำหรับการทดสอบ รูปแบบที่คาดไว้คือ <resource>=<value> หากระบุจำนวนบวกตัวเดียวเป็น <value> ระบบจะลบล้างทรัพยากรเริ่มต้นสำหรับขนาดทดสอบทั้งหมด หากระบุตัวเลขที่คั่นด้วยคอมมา 4 ตัว จำนวนดังกล่าวจะแทนที่จำนวนทรัพยากรสำหรับขนาดทดสอบขนาดเล็ก กลาง ใหญ่ และขนาดใหญ่ตามลำดับ ค่าอาจเป็น HOST_RAM/HOST_CPU (ไม่บังคับ) ตามด้วย [-|*]<Flo> (เช่น Memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4) ทรัพยากรการทดสอบเริ่มต้นที่ระบุโดยแฟล็กนี้จะถูกลบล้างโดยทรัพยากรที่อาจไม่เหมาะสมซึ่งระบุไว้ในแท็ก
- ค่าเริ่มต้น
--[no]experimental_android_use_parallel_dex2oat
: "เท็จ" -
ใช้ dex2oat แบบขนานเพื่อเร่งความเร็ว android_test
แท็ก:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- ค่าเริ่มต้น
--[no]ios_memleaks
: "เท็จ" -
เปิดใช้การตรวจหาหน่วยความจำรั่วไหลในเป้าหมาย ios_test
แท็ก:action_command_lines
- ค่าเริ่มต้น
--ios_simulator_device=<a string>
: ดูคำอธิบาย -
อุปกรณ์ที่จะจำลองเมื่อเรียกใช้แอปพลิเคชัน iOS ในเครื่องมือจำลอง เช่น "iPhone 6" คุณดูรายการอุปกรณ์ได้โดยเรียกใช้ "xcrun simctl list devicetypes" บนเครื่องที่เครื่องมือจำลองจะทำงาน
แท็ก:test_runner
- ค่าเริ่มต้น
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชันของ iOS ที่จะเรียกใช้บนเครื่องมือจำลองเมื่อทำงานหรือทดสอบ ระบบจะไม่สนใจกฎ ios_test หากกฎระบุอุปกรณ์เป้าหมายไว้ในกฎ
แท็ก:test_runner
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
รายการ - ระบุจำนวนครั้งที่จะทำการทดสอบแต่ละครั้ง หากการดำเนินการเหล่านั้นล้มเหลวไม่ว่าด้วยเหตุผลใดก็ตาม จะถือว่าการทดสอบทั้งหมดไม่ผ่าน โดยปกติแล้ว ค่าที่ระบุจะเป็นแค่จำนวนเต็ม ตัวอย่าง: --runs_per_test=3 จะทำการทดสอบทั้งหมด 3 ครั้ง ไวยากรณ์สำรอง: regex_filter@runs_per_test โดย running_per_test ย่อมาจากค่าจำนวนเต็ม ส่วน regex_filter หมายถึงรายการรูปแบบการรวมและยกเว้นรูปแบบนิพจน์ทั่วไป (โปรดดู --instrumentation_filter) ตัวอย่างเช่น --runs_per_test=//foo/.*,-//foo/bar/.*@3 จะทำการทดสอบทั้งหมดใน //foo/ ยกเว้นการทดสอบภายใต้ foo/bar 3 ครั้ง ตัวเลือกนี้ส่งได้หลายครั้ง อาร์กิวเมนต์ที่ส่งผ่านล่าสุดที่ตรงกันจะมีความสำคัญเหนือกว่า หากไม่มีผลลัพธ์ที่ตรงกัน ระบบจะทำการทดสอบเพียงครั้งเดียว
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--test_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุตัวแปรสภาพแวดล้อมเพิ่มเติมที่จะแทรกลงในสภาพแวดล้อมตัวดำเนินการทดสอบ คุณระบุตัวแปรได้โดยใช้ชื่อ ซึ่งในกรณีนี้ระบบจะอ่านค่าของตัวแปรจากสภาพแวดล้อมไคลเอ็นต์ Bazel หรือด้วยคู่ชื่อ=ค่า ตัวเลือกนี้ใช้ได้หลายครั้งเพื่อระบุตัวแปรหลายรายการ ใช้เฉพาะโดย "การทดสอบ bazel" เท่านั้น คำสั่ง
แท็ก:test_runner
- ค่าเริ่มต้น
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - ลบล้างค่าระยะหมดเวลาในการทดสอบเริ่มต้นสำหรับระยะหมดเวลาทดสอบ (เป็นวินาที) หากระบุค่าจำนวนเต็มบวกค่าเดียว ค่าดังกล่าวจะแทนที่หมวดหมู่ทั้งหมด หากระบุจำนวนเต็มที่คั่นด้วยคอมมา 4 ตัวเลข ค่าดังกล่าวจะลบล้างระยะหมดเวลาสำหรับแบบสั้น ปานกลาง ยาว และนิรันดร์ (ตามลำดับนั้น) ไม่ว่าจะเป็นรูปแบบใด ค่า -1 จะบอกให้ Blaze ใช้ระยะหมดเวลาเริ่มต้นสำหรับหมวดหมู่นั้น
- ค่าเริ่มต้น
--[no]zip_undeclared_test_outputs
: "true" -
หากเป็น "จริง" ระบบจะเก็บเอาต์พุตทดสอบที่ไม่ได้ประกาศไว้ในไฟล์ ZIP
แท็ก:test_runner
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพเวลาของบิลด์
- ค่าเริ่มต้น
--[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_retain_test_configuration_across_testonly
: "เท็จ" -
เมื่อเปิดใช้ --trim_test_configuration จะไม่ตัดการกำหนดค่าการทดสอบสำหรับกฎที่ทำเครื่องหมายว่า testonly=1 ทั้งนี้เพื่อลดปัญหาความขัดแย้งในการดำเนินการเมื่อกฎที่ไม่ใช่การทดสอบต้องพึ่งพากฎ cc_test จะไม่มีผลหาก --trim_test_configuration เป็นเท็จ
แท็ก:loading_and_analysis
loses_incremental_state
- ค่าเริ่มต้น
--[no]experimental_starlark_cc_import
: "เท็จ" -
หากเปิดใช้ เวอร์ชัน Starlark ของ cc_import จะสามารถใช้ได้
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--[no]experimental_unsupported_and_brittle_include_scanning
: "เท็จ" -
เลือกว่าจะจำกัดอินพุตเฉพาะการคอมไพล์ C/C++ หรือไม่โดยการแยกวิเคราะห์ #include บรรทัดจากไฟล์อินพุต ซึ่งจะช่วยปรับปรุงประสิทธิภาพและส่วนเพิ่มด้วยการลดขนาดของแผนผังอินพุตสำหรับการคอมไพล์ อย่างไรก็ตาม ก็อาจทำให้บิลด์เสียหายได้เช่นกัน เนื่องจากเครื่องมือสแกนดังกล่าวไม่สามารถใช้งานความหมายของโปรเซสเซอร์ล่วงหน้าแบบ C ได้อย่างสมบูรณ์ โดยเฉพาะอย่างยิ่ง ระบบจะไม่เข้าใจคำสั่ง #include แบบไดนามิก และไม่สนใจตรรกะตามเงื่อนไขของตัวประมวลผลล่วงหน้า คุณต้องรับความเสี่ยงของการใช้งานเอง เราจะปิดปัญหาที่เกี่ยวข้องกับการแจ้งว่าไม่เหมาะสมนี้
แท็ก:loading_and_analysis
,execution
,changes_inputs
- ค่าเริ่มต้น
--[no]incremental_dexing
: "true" -
ส่วนใหญ่จะทำงานสำหรับ Dexing แยกต่างหากสำหรับไฟล์ Jar แต่ละไฟล์
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--[no]objc_use_dotd_pruning
: "true" -
หากตั้งค่าไว้ จะมีการใช้ไฟล์ .d ที่มาจาก clang เพื่อตัดชุดอินพุตที่ส่งผ่านเข้าไปในคอมไพล์ objc
แท็ก:changes_inputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]process_headers_in_dependencies
: "เท็จ" -
เมื่อสร้าง //a:a เป้าหมาย ให้ประมวลผลส่วนหัวในเป้าหมายทั้งหมดที่ //a:a ต้องใช้ (หากเปิดใช้การประมวลผลส่วนหัวสำหรับ Toolchain)
แท็ก:execution
- ค่าเริ่มต้น
--[no]trim_test_configuration
: "true" -
เมื่อเปิดใช้ ระบบจะล้างตัวเลือกที่เกี่ยวข้องกับการทดสอบซึ่งอยู่ใต้ระดับบนสุดของบิลด์ เมื่อแฟล็กนี้ทำงานอยู่ ระบบจะสร้างการทดสอบเป็นทรัพยากร Dependency ของกฎที่ไม่ใช่การทดสอบไม่ได้ แต่การเปลี่ยนแปลงตัวเลือกที่เกี่ยวข้องกับการทดสอบจะไม่ทำให้มีการวิเคราะห์กฎที่ไม่ใช่การทดสอบอีกครั้ง
แท็ก:loading_and_analysis
loses_incremental_state
- การพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
- ค่าเริ่มต้น
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
พิมพ์ข้อมูลการแก้ไขข้อบกพร่องระหว่างการแปลง Toolchain แฟล็กจะใช้นิพจน์ทั่วไปซึ่งตรวจสอบกับประเภท Toolchain และเป้าหมายที่เฉพาะเจาะจงเพื่อดูว่าควรแก้ไขข้อบกพร่องใด นิพจน์ทั่วไปหลายรายการจะคั่นด้วยคอมมา แล้วระบบจะเลือกนิพจน์ทั่วไปแต่ละรายการแยกกัน หมายเหตุ: เอาต์พุตของ Flag นี้มีความซับซ้อนมากและน่าจะเป็นประโยชน์ต่อผู้เชี่ยวชาญด้านการแก้ไข Toolchain เท่านั้น
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--flag_alias=<a 'name=value' flag alias>
รายการ -
ตั้งชื่อย่อสำหรับธง Starlark โดยใช้คู่คีย์-ค่าคู่เดียวในรูปแบบ "<key>=<value>" เป็นอาร์กิวเมนต์
แท็ก:changes_inputs
- ค่าเริ่มต้น
--[no]incompatible_default_to_explicit_init_py
: "เท็จ" -
แฟล็กนี้เปลี่ยนลักษณะการทำงานเริ่มต้นเพื่อไม่ให้สร้างไฟล์ __init__.py โดยอัตโนมัติในไฟล์การเรียกใช้ของเป้าหมาย Python อีกต่อไป แม่นยำเมื่อเป้าหมาย py_binary หรือ py_test ตั้งค่า legacy_create_init เป็น "auto" (ค่าเริ่มต้น) ระบบจะถือว่าเป็น "เท็จ" เมื่อมีการตั้งค่าแฟล็กนี้เท่านั้น ดู https://github.com/bazelbuild/bazel/issues/10076
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_py2_outputs_are_suffixed
: "true" -
หากเป็นจริง เป้าหมายที่สร้างในการกำหนดค่า Python 2 จะปรากฏภายใต้รูทเอาต์พุตที่มีคำต่อท้าย "-py2" ขณะที่เป้าหมายที่สร้างขึ้นสำหรับ Python 3 จะปรากฏในรูทที่ไม่มีส่วนต่อท้ายที่เกี่ยวข้องกับ Python ซึ่งหมายความว่าลิงก์สัญลักษณ์ความสะดวก "bazel-bin" จะชี้ไปยังเป้าหมาย Python 3 แทนที่จะเป็น Python 2 หากคุณเปิดใช้ตัวเลือกนี้ ขอแนะนำให้เปิดใช้ "--incompatible_py3_is_default" ด้วย
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_py3_is_default
: "true" -
หากเป็นจริง เป้าหมาย "py_binary" และ "py_test" ที่ไม่ได้ตั้งค่าแอตทริบิวต์ "python_version" (หรือ "default_python_version") จะมีค่าเริ่มต้นเป็น PY3 แทนที่จะเป็น PY2 หากตั้งค่าแฟล็กนี้ ขอแนะนำให้ตั้งค่า "--incompatible_py2_outputs_are_suffixed"
แท็ก:loading_and_analysis
,affects_outputs
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_use_python_toolchains
: "true" -
หากตั้งค่าเป็น "จริง" กฎ Python ในเครื่องที่เป็นไฟล์ปฏิบัติการจะใช้รันไทม์ของ Python ที่ระบุโดย Toolchain ของ Python แทนรันไทม์ที่มาจากแฟล็กเดิม เช่น --python_top
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--python_version=<PY2 or PY3>
: ดูคำอธิบาย -
โหมดเวอร์ชันหลักของ Python ไม่ว่าจะเป็น "PY2" หรือ "PY3" โปรดทราบว่าเป้าหมาย "py_binary" และ "py_test" จะลบล้างค่านี้ (แม้ว่าจะไม่ได้ระบุเวอร์ชันอย่างชัดเจน) จึงมักไม่มีเหตุผลที่จะต้องระบุแฟล็กนี้
แท็ก:loading_and_analysis
affects_outputs
- ที่ไม่ถูกจัดหมวดหมู่:
--[no]cache_test_results
[-t
] ค่าเริ่มต้น: "อัตโนมัติ"- หากตั้งค่าเป็น "อัตโนมัติ" Bazel จะทำการทดสอบอีกครั้งเฉพาะในกรณีต่อไปนี้ (1) Bazel ตรวจพบการเปลี่ยนแปลงในการทดสอบหรือทรัพยากร Dependency (2) การทดสอบได้รับการทำเครื่องหมายว่าเป็นภายนอก (3) มีการขอทำการทดสอบหลายครั้งด้วย --runs_per_test หรือ(4) การทดสอบล้มเหลวก่อนหน้านี้ หากตั้งค่าเป็น "ใช่" Bazel จะแคชผลการทดสอบทั้งหมด ยกเว้นการทดสอบที่ทำเครื่องหมายว่าภายนอก หากตั้งค่าเป็น "ไม่" Bazel จะไม่แคชผลการทดสอบใดๆ
- ค่าเริ่มต้น
--[no]experimental_cancel_concurrent_tests
: "เท็จ" -
หากเป็น "จริง" Blaze จะยกเลิกการทดสอบพร้อมกันในการรันที่สำเร็จครั้งแรก วิธีนี้จะมีประโยชน์เมื่อใช้ร่วมกับ --runs_per_test_detects_flakes เท่านั้น
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_fetch_all_coverage_outputs
: "เท็จ" -
หากเป็น "จริง" Bazel จะดึงข้อมูลไดเรกทอรีข้อมูลการครอบคลุมทั้งหมดสำหรับการทดสอบแต่ละครั้งระหว่างการทำงานของการครอบคลุม
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_generate_llvm_lcov
: "เท็จ" -
หากเป็น "จริง" ความครอบคลุมของคําพูดจะสร้างรายงาน LCOV
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_j2objc_header_map
: "true" - เลือกว่าจะสร้างแผนที่ส่วนหัว J2ObjC ควบคู่ไปกับการแปลง J2ObjC หรือไม่
- ค่าเริ่มต้น
--[no]experimental_j2objc_shorter_header_path
: "เท็จ" -
เลือกว่าจะสร้างโดยใช้เส้นทางส่วนหัวที่สั้นกว่าหรือไม่ (ใช้ "_ios" แทน "_j2objc")
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_java_classpath=<off, javabuilder or bazel>
: "javabuilder" - เปิดใช้งานคลาสพาธที่ลดลงสำหรับการคอมไพล์ Java
- ค่าเริ่มต้น
--[no]experimental_limit_android_lint_to_android_constrained_java
: "เท็จ" -
ไม่มีการดำเนินการ เก็บไว้สำหรับความเข้ากันได้แบบย้อนหลังเท่านั้น
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_run_android_lint_on_java_rules
: "เท็จ" -
ระบุว่าจะตรวจสอบแหล่งที่มา java_* หรือไม่
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]explicit_java_test_deps
: "เท็จ" - ระบุทรัพยากร Dependency ของ JUnit หรือ Hamcrest อย่างชัดเจนใน java_test แทนที่จะได้มาจาก Dep ของ TestRunner โดยไม่ตั้งใจ ตอนนี้ใช้ได้กับ bazel เท่านั้น
- ค่าเริ่มต้น
--host_java_launcher=<a build target label>
: ดูคำอธิบาย - Java Launcher ที่เครื่องมือใช้ซึ่งดำเนินการในระหว่างบิลด์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_javacopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมในการส่งไปยัง Javac เมื่อสร้างเครื่องมือที่ดำเนินการระหว่างบิลด์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_jvmopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง Java VM เมื่อสร้างเครื่องมือสร้างที่ดำเนินการระหว่างบิลด์ ระบบจะเพิ่มตัวเลือกเหล่านี้ไปยังตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
- ค่าเริ่มต้น
--[no]incompatible_check_sharding_support
: "true" -
หากเป็น "จริง" Bazel จะไม่ผ่านการทดสอบชาร์ด หากตัวดำเนินการทดสอบไม่ได้ระบุว่ารองรับการชาร์ดดิ้งโดยการแตะไฟล์ที่เส้นทางใน TEST_SHARD_STATUS_FILE หากเป็นเท็จ ตัวดำเนินการทดสอบที่ไม่รองรับการชาร์ดจะนำไปยังการทดสอบทั้งหมดที่ทำงานในชาร์ดแต่ละรายการ
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_exclusive_test_sandboxed
: "true" -
หากจริง การทดสอบพิเศษจะทำงานโดยใช้กลยุทธ์แซนด์บ็อกซ์ เพิ่ม "ท้องถิ่น" เพื่อบังคับให้การทดสอบพิเศษทำงานภายในเครื่อง
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_strict_action_env
: "เท็จ" -
หากเป็นจริง Bazel จะใช้สภาพแวดล้อมที่มีค่าคงที่สำหรับ PATH และไม่รับค่า LD_LIBRARY_PATH ใช้ --action_env=ENV_VARIABLE หากคุณต้องการรับตัวแปรสภาพแวดล้อมที่เฉพาะเจาะจงจากไคลเอ็นต์ แต่โปรดทราบว่าการทำเช่นนี้อาจป้องกันการแคชข้ามผู้ใช้ได้หากมีการใช้แคชที่แชร์
แท็ก:loading_and_analysis
incompatible_change
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--j2objc_translation_flags=<comma-separated list of options>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยังเครื่องมือ J2ObjC
--java_debug
-
ทำให้เครื่องเสมือนของ Java ของการทดสอบ Java ต้องรอการเชื่อมต่อจากโปรแกรมแก้ไขข้อบกพร่องที่สอดคล้องกับ JDWP (เช่น jdb) ก่อนเริ่มการทดสอบ โดยนัย -test_output=streamed
ขยายเป็น
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- ค่าเริ่มต้น
--[no]java_deps
: "true" - สร้างข้อมูลทรัพยากร Dependency (ในขณะนี้คือคลาสพาธเวลาคอมไพล์) ต่อเป้าหมาย Java
- ค่าเริ่มต้น
--[no]java_header_compilation
: "true" - คอมไพล์จากต้นทางโดยตรง
- ค่าเริ่มต้นของ
--java_language_version=<a string>
: "" - เวอร์ชันภาษา Java
- ค่าเริ่มต้น
--java_launcher=<a build target label>
: ดูคำอธิบาย - Java Launcher ที่จะใช้เมื่อสร้างไบนารีของ Java หากตั้งค่าสถานะนี้เป็นสตริงว่างเปล่า ระบบจะใช้ Launcher ของ JDK "Launcher" จะลบล้างแฟล็กนี้
--java_runtime_version=<a string>
ค่าเริ่มต้น: "local_jdk"- เวอร์ชันรันไทม์ของ Java
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--javacopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง Javac
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--jvmopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง Java VM ระบบจะเพิ่มตัวเลือกเหล่านี้ไปยังตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
- ค่าเริ่มต้น
--legacy_main_dex_list_generator=<a build target label>
: ดูคำอธิบาย - ระบุไบนารีที่จะใช้สร้างรายการคลาสที่ต้องอยู่ใน Dex หลักเมื่อคอมไพล์ Multidex เดิม
- ค่าเริ่มต้น
--optimizing_dexer=<a build target label>
: ดูคำอธิบาย - ระบุไบนารีที่จะใช้ทำ Dexing โดยไม่ต้องชาร์ดดิ้ง
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--plugin=<a build target label>
รายการ - ปลั๊กอินที่ใช้ในบิลด์ ปัจจุบันใช้งานได้กับ java_plugin
- ค่าเริ่มต้น
--proguard_top=<a build target label>
: ดูคำอธิบาย - ระบุเวอร์ชัน ProGuard ที่จะใช้สำหรับการนำโค้ดออกเมื่อสร้างไบนารีของ Java
--proto_compiler=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/protocol:protocol"-
ป้ายกำกับของคอมไพเลอร์ Proto
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]proto_profile
: "true" -
ระบุว่าจะส่ง profile_path ไปยังคอมไพเลอร์ Pro หรือไม่
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--proto_profile_path=<a build target label>
: ดูคำอธิบาย -
โปรไฟล์ที่จะส่งไปยังคอมไพเลอร์ Pro เป็น profile_path หากไม่ได้ตั้งค่า แต่ --Proto_profile เป็นจริง (ค่าเริ่มต้น) จะอนุมานเส้นทางจาก --fdo_optimize
แท็ก: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:/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, อื่นๆ ทั้งหมด: /bin/bash) โปรดทราบว่าการใช้ Shell ที่เข้ากันไม่ได้กับ Bash อาจทำให้บิลด์ล้มเหลวหรือรันไทม์ของไบนารีที่สร้างขึ้นไม่สำเร็จ
แท็ก:loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--test_arg=<a string>
รายการ - ระบุตัวเลือกและอาร์กิวเมนต์เพิ่มเติมที่ควรส่งไปยังไฟล์ปฏิบัติการทดสอบ ซึ่งสามารถใช้หลายครั้งเพื่อระบุอาร์กิวเมนต์ได้หลายรายการ หากดำเนินการทดสอบหลายรายการ แต่ละรายการจะได้รับอาร์กิวเมนต์ที่เหมือนกัน ใช้เฉพาะโดย "การทดสอบ bazel" เท่านั้น คำสั่ง
- ค่าเริ่มต้น
--test_filter=<a string>
: ดูคำอธิบาย - ระบุตัวกรองที่จะส่งต่อไปยังเฟรมเวิร์กการทดสอบ ใช้เพื่อจำกัดการทดสอบ โปรดทราบว่าการเปลี่ยนแปลงนี้ไม่มีผลต่อเป้าหมายที่สร้างขึ้น
- ค่าเริ่มต้น
--test_result_expiration=<an integer>
: "-1" - ตัวเลือกนี้เลิกใช้งานแล้วและไม่ส่งผลใดๆ
- ค่าเริ่มต้น
--[no]test_runner_fail_fast
: "เท็จ" - การส่งต่อล้มเหลวตัวเลือกอย่างรวดเร็วไปยังตัวดำเนินการทดสอบ ตัวดำเนินการทดสอบควรหยุดการดำเนินการเมื่อล้มเหลวครั้งแรก
- ค่าเริ่มต้น
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
: "อาจไม่เหมาะสม" - ระบุกลยุทธ์สำหรับการทดสอบชาร์ดดิ้ง: "Explicit" จะใช้ชาร์ดดิ้งก็ต่อเมื่อ "shard_count" เท่านั้น มีแอตทริบิวต์ BUILD "ปิดใช้" ว่าจะไม่ใช้ทดสอบชาร์ดดิ้ง "forced=k" เพื่อบังคับใช้ "k" ชาร์ดสำหรับการทดสอบโดยไม่คำนึงถึง "shard_count" BUILD
- ค่าเริ่มต้นของ
--tool_java_language_version=<a string>
: "" - เวอร์ชันภาษา Java ที่ใช้เพื่อเรียกใช้เครื่องมือที่จำเป็นระหว่างการสร้าง
- ค่าเริ่มต้นของ
--tool_java_runtime_version=<a string>
: "remotejdk_11" - เวอร์ชันรันไทม์ของ Java ที่ใช้เพื่อเรียกใช้เครื่องมือในระหว่างบิลด์
- ค่าเริ่มต้น
--[no]use_ijars
: "true" - หากเปิดใช้ ตัวเลือกนี้จะทำให้การคอมไพล์ Java ใช้ jars อินเทอร์เฟซ ซึ่งจะทำให้การคอมไพล์แบบเพิ่มขึ้นเรื่อยๆ ได้เร็วขึ้น แต่ข้อความแสดงข้อผิดพลาดอาจแตกต่างกันได้
ตัวเลือกดัมพ์
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่งมีดังนี้
- ค่าเริ่มต้น
--[no]action_cache
: "เท็จ" -
ดัมพ์เนื้อหาของแคช
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--memory=<memory mode>
: ดูคำอธิบาย -
ดัมพ์การใช้หน่วยความจำของโหนด Skyframe ที่ระบุ
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--[no]packages
: "เท็จ" -
ดัมพ์เนื้อหาแคชของแพ็กเกจ
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--[no]rule_classes
: "เท็จ" -
ดัมพ์คลาสของกฎ
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--[no]rules
: "เท็จ" -
กฎดัมพ์ รวมถึงจำนวนและการใช้หน่วยความจำ (หากมีการติดตามหน่วยความจำ)
แท็ก:bazel_monitoring
- ค่าเริ่มต้นของ
--serialized_frontier_profile=<a string>
: "" -
ดัมพ์โปรไฟล์ของไบต์พรมแดนแบบอนุกรม ระบุเส้นทางเอาต์พุต
แท็ก:bazel_monitoring
- ค่าเริ่มต้นของ
--skyframe=<off, summary, count, value, deps, rdeps, function_graph, working_set or working_set_frontier_deps>
: "ปิด" -
ถ่ายโอนกราฟ Skyframe
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--skykey_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: ".*" -
ตัวกรองนิพจน์ทั่วไปของชื่อ SkyKey ที่จะเอาต์พุต ใช้กับ --skyframe=deps, rdeps, function_graph เท่านั้น
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--skylark_memory=<a string>
: ดูคำอธิบาย -
ถ่ายโอนโปรไฟล์หน่วยความจำที่เข้ากันได้กับ pprof ไปยังเส้นทางที่ระบุ ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/google/pprof
แท็ก:bazel_monitoring
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_use_plus_in_repo_names
: "true" -
ไม่มีการดำเนินการ
แท็ก:loading_and_analysis
ตัวเลือกการดึงข้อมูล
รับค่าตัวเลือกทั้งหมดจาก test
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์:
- ค่าเริ่มต้น
--[no]all
: "เท็จ" -
ดึงข้อมูลที่เก็บภายนอกทั้งหมดที่จำเป็นสำหรับการสร้างเป้าหมายหรือที่เก็บ ทำงานเมื่อเปิด --enable_bzlmod เท่านั้น
แท็ก:changes_inputs
--[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
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_config_setting_private_default_visibility
: "เท็จ" -
หากไม่รองรับ _enforce_config_setting_visibility=false ค่าจะเป็น Noop หรือไม่เช่นนั้น หากแฟล็กนี้เป็นเท็จ config_setting ใดๆ ที่ไม่มีแอตทริบิวต์การเปิดเผยอย่างชัดแจ้งจะเป็น //visibility:public หากแฟล็กนี้เป็นจริง config_setting จะใช้ตรรกะระดับการเข้าถึงเดียวกันกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_enforce_config_setting_visibility
: "true" -
หากเป็น "จริง" ให้บังคับใช้การจำกัดระดับการเข้าถึง config_setting หากเป็น "เท็จ" ทุก config_setting จะปรากฏแก่เป้าหมายทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_use_plus_in_repo_names
: "true" -
ไม่มีการดำเนินการ
แท็ก:loading_and_analysis
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
- ค่าเริ่มต้น
--[no]configure
: "เท็จ" -
ดึงข้อมูลเฉพาะที่เก็บที่มีเครื่องหมายว่า "กำหนดค่า" ในการกำหนดค่าระบบ ทำงานเมื่อเปิด --enable_bzlmod เท่านั้น
แท็ก:changes_inputs
- ค่าเริ่มต้น
--[no]force
: "เท็จ" -
ละเว้นที่เก็บที่มีอยู่ (หากมี) และบังคับให้ดึงข้อมูลที่เก็บอีกครั้ง ทำงานเมื่อเปิด --enable_bzlmod เท่านั้น
แท็ก:changes_inputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--repo=<a string>
รายการ -
จะดึงข้อมูลที่เก็บที่ระบุเท่านั้น ซึ่งอาจเป็น {@apparent_repo_name} หรือ {@@canonical_repo_name} ทำงานเมื่อเปิด --enable_bzlmod เท่านั้น
แท็ก:changes_inputs
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
- ค่าเริ่มต้นของ
--experimental_repository_resolved_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้เขียนค่า Starlark พร้อมข้อมูลที่แก้ไขแล้วของกฎที่เก็บ Starlark ทั้งหมดที่ดำเนินการ
แท็ก:affects_outputs
- ตัวเลือกเบ็ดเตล็ด ที่จัดหมวดหมู่ไว้ไม่ได้:
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--deleted_packages=<comma-separated list of package names>
รายการ - รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริงแม้ว่าจะปรากฏอยู่ที่ใดที่หนึ่งบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ เช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์ ระบบบิลด์อาจบ่นหากพบป้ายกำกับ "//x:y/z" ถ้ามีข้อมูลระบุโดยรายการpackage_path อื่นอยู่ การระบุ --deleted_packages x/y ช่วยป้องกันปัญหานี้
- ค่าเริ่มต้น
--[no]fetch
: "true" - อนุญาตให้คำสั่งดึงข้อมูลทรัพยากร Dependency ภายนอก หากตั้งค่าเป็น "เท็จ" คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ และหากไม่มี คำสั่งดังกล่าวจะทำให้การทำงานล้มเหลว
- ค่าเริ่มต้นของ
--package_path=<colon-separated list of options>
: "%workspace%" - รายการตำแหน่งที่จะค้นหาแพ็กเกจที่คั่นด้วยโคลอน องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับพื้นที่ทำงานที่ล้อมรอบอยู่ หากไม่ระบุหรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
- ค่าเริ่มต้น
--[no]show_loading_progress
: "true" - หากเปิดใช้ จะทำให้ Bazel พิมพ์ "กำลังโหลดแพ็กเกจ:" ข้อความ
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์:
- ค่าเริ่มต้น
--[no]experimental_inprocess_symlink_creation
: "เท็จ" -
เลือกว่าจะเรียกใช้ระบบไฟล์โดยตรงเพื่อสร้างต้นไม้ Symlink หรือไม่
แท็ก:loading_and_analysis
,execution
,experimental
- ค่าเริ่มต้น
--[no]experimental_persistent_aar_extractor
: "เท็จ" -
เปิดใช้เครื่องมือแยก Aar แบบถาวรโดยใช้ผู้ปฏิบัติงาน
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_remotable_source_manifests
: "เท็จ" -
ต้องการให้การดำเนินการในไฟล์ Manifest ของแหล่งที่มาทำซ้ำได้หรือไม่
แท็ก:loading_and_analysis
,execution
,experimental
- ค่าเริ่มต้น
--[no]experimental_split_coverage_postprocessing
: "เท็จ" -
หากเป็น "จริง" Bazel จะดำเนินการประมวลผลภายหลังสำหรับการครอบคลุมในการทดลองที่สร้างขึ้นใหม่
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_strict_fileset_output
: "เท็จ" -
หากเปิดใช้ตัวเลือกนี้ ชุดไฟล์จะถือว่าอาร์ติแฟกต์เอาต์พุตทั้งหมดเป็นไฟล์ทั่วไป โดยจะไม่ข้ามผ่านไดเรกทอรีหรือไวต่อลิงก์สัญลักษณ์
แท็ก:execution
- ค่าเริ่มต้น
--[no]incompatible_modify_execution_info_additive
: "เท็จ" -
เมื่อเปิดใช้ การส่งแฟล็ก --modify_execution_info หลายรายการจะเป็นแบบบวกเพิ่ม เมื่อปิดใช้ ระบบจะพิจารณาเฉพาะธงล่าสุดเท่านั้น
แท็ก:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
รายการ -
เพิ่มหรือนำคีย์ออกจากข้อมูลการดำเนินการของการดำเนินการตามความสามารถในการจำการดำเนินการ ใช้กับการดำเนินการที่รองรับข้อมูลการดำเนินการเท่านั้น การดำเนินการทั่วไปจำนวนมากรองรับข้อมูลการดำเนินการ เช่น Genrule, CppCompile, Javac, StarlarkAction, TestRunner เมื่อระบุค่าหลายค่า ลำดับมีความสำคัญเนื่องจาก regexe หลายรายการอาจใช้กับช่วยจำเดียวกันได้
ไวยากรณ์: "regex=[+-]key,regex=[+-]key,..."
ตัวอย่าง:
'.*=+x,.*=-y,.*=+z' เพิ่ม "x" และ "z" ถึง และนำ "y" ออก ข้อมูลการดำเนินการสำหรับการดำเนินการทั้งหมด
'Genrule=+requires-x' เพิ่ม "requires-x" กับข้อมูลการดำเนินการสำหรับการดำเนินการ Genrule ทั้งหมด
'(?!Genrule).*=-requires-x' นำ "requires-x" ออก จากข้อมูลการดำเนินการสำหรับการดำเนินการ
ที่ไม่ใช่ Genrule ทั้งหมด
แท็ก:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
เปิดใช้การดำเนินการ Dex และ desugar ของ Android แบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
แท็ก:host_machine_resource_optimizations
execution
--persistent_android_resource_processor
-
เปิดใช้ผู้ประมวลผลข้อมูลทรัพยากร Android ถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
เปิดใช้การดำเนินการ Dex และ desugar ของ Android แบบมัลติเพล็กซ์โดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
เปิดใช้เครื่องมือประมวลผลทรัพยากร Android แบบมัลติเพล็กซ์แบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
เปิดใช้เครื่องมือ Android แบบต่อเนื่องและแบบมัลติเพล็กซ์ (Dexing, Deugaring, Resource Operations)
ขยายเป็น
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
แท็ก:host_machine_resource_optimizations
execution
- ค่าเริ่มต้น
--[no]use_target_platform_for_tests
: "เท็จ" -
หากเป็น "จริง" Bazel จะใช้แพลตฟอร์มเป้าหมายในการทำการทดสอบแทนกลุ่มผู้บริหารทดสอบ
แท็ก:execution
- ตัวเลือกที่กำหนดค่า Toolchain ที่ใช้สำหรับการดำเนินการมีดังนี้
- ค่าเริ่มต้น
--android_compiler=<a string>
: ดูคำอธิบาย -
คอมไพเลอร์เป้าหมายของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_manifest_merger=<legacy, android or force_android>
: "android" -
เลือกการควบรวมไฟล์ Manifest ที่จะใช้กับกฎ android_binary แจ้งเพื่อช่วยให้เปลี่ยนไปใช้การผสานรวมไฟล์ Manifest ของ Android จากการควบรวมเดิม
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_platforms=<a build target label>
: "" -
ตั้งค่าแพลตฟอร์มที่ android_binary กำหนดเป้าหมายใช้ หากระบุหลายแพลตฟอร์ม ไบนารีนั้นจะเป็น APK แบบอ้วน ซึ่งมีไบนารีแบบเนทีฟสำหรับแต่ละแพลตฟอร์มเป้าหมายที่ระบุ
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_sdk=<a build target label>
: "@bazel_tools//tools/android:sdk" -
ระบุ SDK/แพลตฟอร์ม Android ที่ใช้สร้างแอปพลิเคชัน Android
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้ในกฎของ Apple และ Objc และทรัพยากร Dependency
แท็ก:loses_incremental_state
changes_inputs
- ค่าเริ่มต้นของ
--cc_output_directory_tag=<a string>
: "" -
ระบุคำต่อท้ายที่จะเพิ่มในไดเรกทอรีการกำหนดค่า
แท็ก:affects_outputs
- ค่าเริ่มต้น
--compiler=<a string>
: ดูคำอธิบาย -
คอมไพเลอร์ C++ ที่จะใช้สำหรับการคอมไพล์เป้าหมาย
แท็ก:loading_and_analysis
execution
--coverage_output_generator=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:lcov_merger"-
ตำแหน่งของไบนารีที่ใช้เพื่อประมวลผลรายงานการครอบคลุมแบบข้อมูลดิบหลังการประมวลผล ซึ่งต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งก็คือไบนารี ค่าเริ่มต้นคือ "//tools/test:lcov_merger"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_report_generator"-
ตําแหน่งของไบนารีที่ใช้สร้างรายงานการครอบคลุม ซึ่งต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งก็คือไบนารี ค่าเริ่มต้นคือ "//tools/test:coverage_report_generator"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_support"-
ตำแหน่งของไฟล์สนับสนุนที่จำเป็นต้องใช้ในอินพุตของการดำเนินการทดสอบทั้งหมดที่รวบรวมการครอบคลุมของโค้ด ค่าเริ่มต้นคือ "//tools/test:coverage_support"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--custom_malloc=<a build target label>
: ดูคำอธิบาย -
ระบุการใช้งาน Malloc ที่กำหนดเอง การตั้งค่านี้จะลบล้างแอตทริบิวต์ Malloc ในกฎบิลด์
แท็ก:changes_inputs
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
รายการ -
รายการนิพจน์ทั่วไปที่คั่นด้วยคอมมา แต่ละรายการจะมีคำนำหน้าด้วย - (นิพจน์เชิงลบ) และกำหนด (=) ให้กับรายการเป้าหมายค่าข้อจำกัดที่คั่นด้วยคอมมา หากเป้าหมายตรงกับที่ไม่มีนิพจน์เชิงลบ และนิพจน์เชิงบวกอย่างน้อย 1 รายการ การแปลง Toolchain จะดำเนินการเสมือนว่าได้ประกาศค่าข้อจำกัดเป็นข้อจำกัดการดำเนินการ ตัวอย่าง: //demo,-test=@platforms//cpus:x86_64 จะเพิ่ม "x86_64" ไปยังเป้าหมายใดๆ ภายใต้ //demo ยกเว้นเป้าหมายที่ชื่อมี "test"
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_include_xcode_execution_requirements
: "เท็จ" -
เมื่อตั้งค่าแล้ว ให้เพิ่ม "requires-xcode:{version}" สำหรับการดำเนินการของ Xcode ทุกครั้ง หากเวอร์ชัน Xcode มีป้ายกำกับขีดกลาง ให้เพิ่ม "requires-xcode-label:{version_label}" ด้วย ข้อกำหนดของการดำเนินการ
แท็ก:loses_incremental_state
,loading_and_analysis
,execution
- ค่าเริ่มต้น
--[no]experimental_prefer_mutual_xcode
: "true" -
หากเป็นจริง ให้ใช้ Xcode ล่าสุดที่พร้อมใช้งานทั้งในเครื่องและจากระยะไกล หากเป็นเท็จหรือไม่มีเวอร์ชันที่ใช้ร่วมกัน ให้ใช้เวอร์ชันของ Xcode ในเครื่องที่เลือกผ่าน xcode-select
แท็ก:loses_incremental_state
- ค่าเริ่มต้นของ
--extra_execution_platforms=<comma-separated list of options>
: "" -
แพลตฟอร์มที่มีให้ใช้งานเป็นแพลตฟอร์มการดำเนินการเพื่อเรียกใช้การดำเนินการ สามารถระบุแพลตฟอร์มโดยเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมาย แพลตฟอร์มเหล่านี้จะได้รับการพิจารณาก่อนแพลตฟอร์มที่ประกาศในไฟล์ WORKSPACE โดยregister_execution_platforms() ตัวเลือกนี้ตั้งค่าได้เพียงครั้งเดียว อินสแตนซ์ภายหลังจะลบล้างการตั้งค่าแฟล็กก่อนหน้า
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--extra_toolchains=<comma-separated list of options>
รายการ -
กฎ Toolchain ที่จะต้องพิจารณาระหว่างการแก้ไข Toolchain สามารถระบุ Toolchains ตามเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมายได้ ระบบจะพิจารณา Toolchain เหล่านี้ก่อนการประกาศในไฟล์ WORKSPACE โดยregister_toolchains()
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--grte_top=<a label>
: ดูคำอธิบาย -
ป้ายกำกับไปยังไลบรารี libc ที่มีการเช็คอิน Crosstool Toolchain จะเลือกค่าเริ่มต้นและคุณแทบจะไม่จำเป็นต้องลบล้างค่าเริ่มต้น
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--host_compiler=<a string>
: ดูคำอธิบาย -
แฟล็กที่ไม่มีการดำเนินการ ระบบจะนำออกในรุ่นถัดไป
แท็ก:loading_and_analysis
execution
- ค่าเริ่มต้น
--host_grte_top=<a label>
: ดูคำอธิบาย -
ถ้าระบุ การตั้งค่านี้จะลบล้างไดเรกทอรีระดับบนสุดของ libc (--grte_top) สำหรับการกำหนดค่าผู้บริหาร
แท็ก:action_command_lines
affects_outputs
--host_platform=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools:host_platform"-
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายระบบโฮสต์
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--[no]incompatible_bazel_test_exec_run_under
: "เท็จ" -
หากเปิดใช้ "การทดสอบ bazel --run_under=//:runner" บิลด์ "//:runner" ในการกำหนดค่า exec หากปิดใช้ จะสร้าง "//:runner" ในการกำหนดค่าเป้าหมาย Bazel ทำการทดสอบบนเครื่องปฏิบัติการ ดังนั้นเครื่องแรกจึงถูกต้องกว่า ซึ่งไม่ส่งผลกับ "Bazel Run" ซึ่งจะสร้าง "`--run_under=//foo" เสมอ ในการกำหนดค่าเป้าหมาย
แท็ก:affects_outputs
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_apple_toolchain_resolution
: "เท็จ" -
ใช้ความละเอียดของ Toolchain เพื่อเลือก Apple SDK สำหรับกฎของ Apple (Starlark และเนทีฟ)
แท็ก: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_strip_executable_safely
: "เท็จ" -
หากเป็น "จริง" การดำเนินการตัดไฟล์สำหรับไฟล์ปฏิบัติการจะใช้แฟล็ก -x ซึ่งไม่ส่งผลกับความละเอียดของสัญลักษณ์แบบไดนามิก
แท็ก:action_command_lines
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
,immutable
- ค่าเริ่มต้นของ
--platforms=<a build target label>
: "" -
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายแพลตฟอร์มเป้าหมายสำหรับคำสั่งปัจจุบัน
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--python_path=<a string>
: ดูคำอธิบาย -
Absolute Path ของล่าม Python มีการเรียกใช้เป้าหมาย Python บนแพลตฟอร์มเป้าหมาย เลิกใช้งาน; ปิดใช้งานโดย --incompatible_use_python_toolchains
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้น
--python_top=<a build target label>
: ดูคำอธิบาย -
ป้ายกำกับของ py_runtime ที่แทนอินเทอร์พรีเตอร์ Python ได้มีการเรียกให้เรียกใช้เป้าหมาย Python บนแพลตฟอร์มเป้าหมาย เลิกใช้งาน; ปิดใช้งานโดย --incompatible_use_python_toolchains
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้น
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
ระบุเวอร์ชันของ tvOS SDK ที่จะใช้สร้างแอปพลิเคชัน tvOS หากไม่ระบุ ระบบจะใช้เวอร์ชันเริ่มต้นของ tvOS SDK จาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
ระบุเวอร์ชันของ WatchOS SDK ที่จะใช้สร้างแอปพลิเคชัน watchOS หากไม่ระบุ ระบบจะใช้เวอร์ชัน WatchOS SDK เริ่มต้นจาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--xcode_version=<a string>
: ดูคำอธิบาย -
หากระบุไว้ ให้ใช้ Xcode ของเวอร์ชันที่ระบุสำหรับการดำเนินการของบิลด์ที่เกี่ยวข้อง หากไม่ระบุ ระบบจะใช้ Xcode เวอร์ชันเริ่มต้นของผู้ดำเนินการ
แท็ก:loses_incremental_state
--xcode_version_config=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:host_xcodes"-
ป้ายกำกับของกฎ xcode_config ที่จะใช้สำหรับเลือกเวอร์ชัน Xcode ในการกำหนดค่าบิลด์
แท็ก:loses_incremental_state
loading_and_analysis
- มีดังนี้
- ค่าเริ่มต้น
--[no]apple_generate_dsym
: "เท็จ" -
เลือกว่าจะสร้างไฟล์สัญลักษณ์การแก้ไขข้อบกพร่อง (.dSYM) หรือไม่
แท็ก:affects_outputs
action_command_lines
- ค่าเริ่มต้น
--[no]build_runfile_links
: "true" -
หากเป็น "จริง" ให้สร้างศูนย์การเรียกใช้ไฟล์ symlink สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้เขียนเมื่อต้องใช้การดำเนินการในเครื่อง ทดสอบ หรือเรียกใช้คำสั่งเท่านั้น
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]build_runfile_manifests
: "true" -
หากเป็น "จริง" ให้เขียนไฟล์ Manifest ของการเรียกใช้ไฟล์สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้ละเว้น การทดสอบในเครื่องจะทํางานไม่ได้หากเป็นเท็จ
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]build_test_dwp
: "เท็จ" -
หากเปิดใช้ เมื่อสร้างการทดสอบ C++ แบบคงที่ และด้วยฟิชชัน ไฟล์ .dwp สำหรับไบนารีการทดสอบจะสร้างขึ้นโดยอัตโนมัติเช่นกัน
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้นของ
--cc_proto_library_header_suffixes=<comma-separated set of options>
: ".pb.h" -
ตั้งค่าคำต่อท้ายของไฟล์ส่วนหัวที่ cc_proto_library สร้างขึ้น
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--cc_proto_library_source_suffixes=<comma-separated set of options>
: ".pb.cc" -
ตั้งค่าคำต่อท้ายของไฟล์ต้นฉบับที่ cc_protocol_library สร้างขึ้น
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_proto_descriptor_sets_include_source_info
: "เท็จ" -
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันอื่นๆ ใน protocol_library
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_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
- ค่าเริ่มต้น
--[no]android_databinding_use_androidx
: "true" -
สร้างไฟล์การเชื่อมโยงข้อมูลที่ใช้กับ AndroidX ได้ ใช้ได้เฉพาะกับการเชื่อมโยงข้อมูล v2 เท่านั้น แฟล็กนี้ไม่มีการใช้งาน
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]android_databinding_use_v3_4_args
: "true" -
ใช้ Android Databinding v2 ที่มีอาร์กิวเมนต์ 3.4.0 แฟล็กนี้ไม่มีการใช้งาน
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้นของ
--android_dynamic_mode=<off, default or fully>
: "ปิด" -
กำหนดว่าจะให้ลิงก์ C++ ของกฎ Android แบบไดนามิกหรือไม่ เมื่อ cc_binary ไม่ได้สร้างไลบรารีที่ใช้ร่วมกันอย่างชัดแจ้ง "ค่าเริ่มต้น" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "สมบูรณ์" หมายความว่าไลบรารีทั้งหมดจะลิงก์แบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "ตามตัวอักษร" -
ตั้งค่าลำดับของไฟล์ Manifest ที่ส่งไปยังการรวมไฟล์ Manifest สำหรับไบนารีของ Android อัลฟ่าหมายความว่าไฟล์ Manifest ได้รับการจัดเรียงตามเส้นทางที่สัมพันธ์กับผู้ดำเนินการ ALPHABETICAL_BY_CONFIGURATION หมายความว่าไฟล์ Manifest ได้รับการจัดเรียงตามเส้นทางที่สัมพันธ์กับไดเรกทอรีการกำหนดค่าภายในไดเรกทอรีเอาต์พุต DEPENDENCY หมายความว่าไฟล์ Manifest จะเรียงลำดับตามไฟล์ Manifest ของไลบรารีแต่ละรายการที่อยู่ก่อนไฟล์ Manifest ของทรัพยากร Dependency
แท็ก:action_command_lines
execution
- ค่าเริ่มต้น
--[no]android_resource_shrinking
: "เท็จ" -
เปิดใช้การย่อทรัพยากรสำหรับ APK android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]build_python_zip
: "อัตโนมัติ" -
สร้าง ZIP ที่เป็นไฟล์ปฏิบัติการ Python ใน Windows และปิดบนแพลตฟอร์มอื่น
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--catalyst_cpus=<comma-separated list of options>
รายการ -
รายชื่อสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple Catalyst
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--[no]collect_code_coverage
: "เท็จ" -
หากระบุไว้ Bazel จะใช้โค้ดเครื่องมือวัด (โดยใช้การใช้เครื่องมือแบบออฟไลน์หากเป็นไปได้) และจะรวบรวมข้อมูลการครอบคลุมระหว่างการทดสอบ เฉพาะเป้าหมายที่ตรงกับ --instrumentation_filter จะได้รับผลกระทบ โดยปกติ ตัวเลือกนี้ไม่ควรระบุโดยตรง - "ความครอบคลุมของbazel" ควรใช้คำสั่งแทน
แท็ก:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] ค่าเริ่มต้น: "fastbuild"-
ระบุโหมดที่จะมีการสร้างไบนารี ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--conlyopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--copt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง gcc
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้นของ
--cpu=<a string>
: "" -
CPU เป้าหมาย
แท็ก:changes_inputs
affects_outputs
- ค่าเริ่มต้น
--cs_fdo_absolute_path=<a string>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ CSFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อเส้นทางสัมบูรณ์ของไฟล์ ZIP ที่มีไฟล์โปรไฟล์, ไฟล์ข้อมูล RAW หรือไฟล์โปรไฟล์ LLVM ที่จัดทำดัชนีไว้
แท็ก:affects_outputs
- ค่าเริ่มต้น
--cs_fdo_instrument=<a string>
: ดูคำอธิบาย -
สร้างไบนารีด้วยเครื่องมือ FDO ที่ละเอียดอ่อนตามบริบท เมื่อใช้คอมไพเลอร์ Clang/LLVM คีย์ดังกล่าวจะยอมรับชื่อไดเรกทอรีที่ระบบจะส่งออกไฟล์โปรไฟล์แบบ RAW ขณะรันไทม์ด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--cs_fdo_profile=<a build target label>
: ดูคำอธิบาย -
cs_fdo_profile แสดงถึงโปรไฟล์ที่ละเอียดอ่อนตามบริบทที่จะใช้ในการเพิ่มประสิทธิภาพ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--cxxopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C++
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--define=<a 'name=value' assignment>
รายการ -
ตัวเลือก --define แต่ละรายการจะระบุการมอบหมายสำหรับตัวแปรบิลด์ ในกรณีที่ตัวแปรหนึ่งมีค่าหลายค่า ค่าสุดท้ายจะชนะ
แท็ก:changes_inputs
affects_outputs
- ค่าเริ่มต้น
--dynamic_mode=<off, default or fully>
: "ค่าเริ่มต้น" -
กำหนดว่าจะลิงก์ไบนารีของ C++ แบบไดนามิกหรือไม่ "ค่าเริ่มต้น" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "สมบูรณ์" หมายความว่าไลบรารีทั้งหมดจะลิงก์แบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้น
--[no]enable_propeller_optimize_absolute_paths
: "true" -
หากตั้งค่าไว้ การใช้เส้นทางสัมบูรณ์สำหรับการเพิ่มประสิทธิภาพใบพัดจะทำให้เกิดข้อผิดพลาด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]enable_remaining_fdo_absolute_paths
: "true" -
ถ้ามีการตั้งค่า การใช้เส้นทางสัมบูรณ์สำหรับ FDO จะทำให้เกิดข้อผิดพลาด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]enable_runfiles
: "อัตโนมัติ" -
เปิดใช้โครงสร้างลิงก์สัญลักษณ์ของ Runfiles ซึ่งโดยค่าเริ่มต้น จะปิดอยู่ใน Windows และในแพลตฟอร์มอื่นๆ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_action_listener=<a build target label>
รายการ -
เลิกใช้งานไปทีละด้าน ใช้ action_listener เพื่อแนบทางลัดไปยังการดำเนินการบิลด์ที่มีอยู่
แท็ก:execution
experimental
- ค่าเริ่มต้น
--[no]experimental_android_compress_java_resources
: "เท็จ" -
บีบอัดทรัพยากร Java ใน APK
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_android_databinding_v2
: "true" -
ใช้ Android Data Binding v2 แฟล็กนี้ไม่มีการใช้งาน
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]experimental_android_resource_shrinking
: "เท็จ" -
เปิดใช้การย่อทรัพยากรสำหรับ APK android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_android_rewrite_dexes_with_rex
: "เท็จ" -
ใช้เครื่องมือ Rex เพื่อเขียนไฟล์ dex ใหม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]experimental_collect_code_coverage_for_generated_files
: "เท็จ" -
หากระบุไว้ Bazel จะสร้างการรวบรวมข้อมูลที่ครอบคลุมสำหรับไฟล์ที่สร้างขึ้นด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_objc_fastbuild_options=<comma-separated list of options>
: "-O0,-DDEBUG=1" -
ใช้สตริงเหล่านี้เป็นตัวเลือกคอมไพเลอร์ objc Fastbuild
แท็ก:action_command_lines
- ค่าเริ่มต้น
--[no]experimental_omitfp
: "เท็จ" -
หากเป็น "จริง" ให้ใช้ libunwind สำหรับการคลายสแต็ก แล้วคอมไพล์ด้วย -fomit-frame-pointer และ -fasynchronous-unwind-tables
แท็ก:action_command_lines
,affects_outputs
,experimental
- ค่าเริ่มต้นของ
--experimental_output_paths=<off, content or strip>
: "ปิด" -
โมเดลที่ควรใช้สำหรับส่วนใดในกฎแผนผังเอาต์พุตจะเขียนเอาต์พุต โดยเฉพาะอย่างยิ่งสำหรับบิลด์ที่มีหลายแพลตฟอร์ม / หลายการกำหนดค่า ฟีเจอร์นี้อยู่ในขั้นทดลอง ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/6526 การดำเนินการของ Starlark เลือกใช้การแมปเส้นทางได้ด้วยการเพิ่มคีย์ "supports-path-mapping" เป็น "execution_requirements" พิมพ์ตามคำบอก
แท็ก:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
รายการ -
แต่ละรายการควรอยู่ในรูปแบบ label=value โดยที่ป้ายกำกับอ้างอิงถึงแพลตฟอร์ม และค่าคือชื่อย่อที่ต้องการใช้ในเส้นทางเอาต์พุต ใช้เมื่อ --experimental_platform_in_output_dir เป็นจริงเท่านั้น มีลำดับความสำคัญในการตั้งชื่อสูงสุด
แท็ก:affects_outputs
experimental
- ค่าเริ่มต้น
--[no]experimental_platform_in_output_dir
: "เท็จ" -
หากเป็นจริง ระบบจะใช้ชื่อย่อของแพลตฟอร์มเป้าหมายในชื่อไดเรกทอรีเอาต์พุตแทน CPU รูปแบบที่แน่นอนอยู่ในขั้นทดลองและอาจมีการเปลี่ยนแปลง อย่างแรก ในกรณีซึ่งเกิดขึ้นไม่บ่อยนัก ตัวเลือก --platforms ไม่ได้มีค่าเพียงค่าเดียว ระบบจะใช้แฮชของตัวเลือกแพลตฟอร์ม ถัดไป หากชื่อย่อของแพลตฟอร์มปัจจุบันลงทะเบียนโดย --experimental_override_name_platform_in_output_dir ระบบจะใช้ชื่อย่อนั้น จากนั้น หากมีการตั้งค่า --experimental_use_platforms_in_output_dir_legacy_heurism ให้ใช้ชื่อย่อที่อ้างอิงจากป้ายกำกับแพลตฟอร์มปัจจุบัน สุดท้าย ระบบจะใช้แฮชของตัวเลือกแพลตฟอร์มเป็นทางเลือกสุดท้าย
แท็ก:affects_outputs
experimental
- ค่าเริ่มต้น
--[no]experimental_use_llvm_covmap
: "เท็จ" -
หากระบุ Bazel จะสร้างข้อมูลแผนที่ความครอบคลุมของ llvm-cov แทนที่จะเป็น gcov เมื่อเปิดใช้งานcollect_code_coverage
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
: "true" -
โปรดใช้แฟล็กนี้เป็นส่วนหนึ่งของกลยุทธ์การย้ายข้อมูลหรือการทดสอบที่แนะนำเท่านั้น โปรดทราบว่าการเรียนรู้มีข้อบกพร่องที่ทราบแล้ว และแนะนำให้เปลี่ยนไปใช้เพียง --experimental_override_name_platform_in_output_dir
แท็ก:affects_outputs
experimental
- ค่าเริ่มต้นของ
--fat_apk_cpu=<comma-separated set of options>
: "armeabi-v7a" -
การตั้งค่าตัวเลือกนี้จะเปิดใช้ APK แบบอ้วน ซึ่งมีไบนารีแบบเนทีฟสำหรับสถาปัตยกรรมเป้าหมายที่ระบุทั้งหมด เช่น --fat_apk_cpu=x86,armeabi-v7a. หากระบุแฟล็กนี้ ระบบจะละเว้น --android_cpu สำหรับทรัพยากร Dependency ของกฎ android_binary
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--fdo_instrument=<a string>
: ดูคำอธิบาย -
สร้างไบนารีด้วยเครื่องมือ FDO เมื่อใช้คอมไพเลอร์ Clang/LLVM คีย์ดังกล่าวจะยอมรับชื่อไดเรกทอรีที่ระบบจะส่งออกไฟล์โปรไฟล์แบบ RAW ขณะรันไทม์ด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_optimize=<a string>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ FDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อไฟล์ ZIP ที่มีแผนผังไฟล์ .gcda, ไฟล์ afdo ที่มีโปรไฟล์อัตโนมัติ หรือไฟล์โปรไฟล์ LLVM แฟล็กนี้ยอมรับไฟล์ที่ระบุเป็นป้ายกำกับด้วย (เช่น "//foo/bar:file.afdo" คุณอาจต้องเพิ่มคำสั่ง "exports_files" ไปยังแพ็กเกจที่เกี่ยวข้อง) และป้ายกำกับที่ชี้ไปยังเป้าหมาย "fdo_profile" การตั้งค่าสถานะนี้จะถูกแทนที่โดยกฎ "fdo_profile"
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_prefetch_hints=<a build target label>
: ดูคำอธิบาย -
ใช้คำแนะนำการดึงข้อมูลแคชล่วงหน้า
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_profile=<a build target label>
: ดูคำอธิบาย -
fdo_profile แทนโปรไฟล์ที่จะใช้ในการเพิ่มประสิทธิภาพ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--features=<a string>
รายการ -
ระบบจะเปิดใช้หรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างขึ้นในการกำหนดค่าเป้าหมาย กำลังระบุ -<feature> จะปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ ดูเพิ่มเติมที่ --host_features
แท็ก:changes_inputs
affects_outputs
- ค่าเริ่มต้น
--[no]force_pic
: "เท็จ" -
หากเปิดใช้งาน การคอมไพล์ C++ ทั้งหมดจะสร้างโค้ดที่ไม่ขึ้นอยู่กับตำแหน่ง ("-fPIC") ลิงก์จะใช้ไลบรารีที่สร้างไว้ล่วงหน้าของ PIC มากกว่าไลบรารีที่ไม่ใช่ PIC และลิงก์จะสร้างไฟล์ปฏิบัติการที่ไม่ขึ้นอยู่กับตำแหน่ง ("-pie")
แท็ก:loading_and_analysis
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_action_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกำหนดค่าการดำเนินการ คุณระบุตัวแปรได้ด้วยชื่อ ซึ่งในกรณีนี้ระบบจะนําค่าจากสภาพแวดล้อมการเรียกใช้ หรือคู่ name=value ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ ตัวเลือกนี้ใช้ได้หลายครั้ง สำหรับตัวเลือกที่ระบุสำหรับตัวแปรเดียวกัน ค่าที่ชนะล่าสุด และตัวเลือกของตัวแปรต่างๆ จะสะสมอยู่
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--host_compilation_mode=<fastbuild, dbg or opt>
: "opt" -
ระบุโหมดที่จะมีการสร้างเครื่องมือที่ใช้ในการสร้าง ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_conlyopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งไปยังคอมไพเลอร์ C เมื่อคอมไพล์ไฟล์ต้นฉบับ C (ไม่ใช่ C++) ในการกำหนดค่าผู้บริหาร
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_copt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยังคอมไพเลอร์ C สำหรับเครื่องมือที่สร้างขึ้นในการกำหนดค่าการดำเนินการ
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้นของ
--host_cpu=<a string>
: "" -
CPU ของโฮสต์
แท็ก:changes_inputs
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_cxxopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยังคอมไพเลอร์ C++ สำหรับเครื่องมือที่สร้างขึ้นในการกำหนดค่าดำเนินการ
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_features=<a string>
รายการ -
ระบบจะเปิดใช้หรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างขึ้นในการกำหนดค่า exec กำลังระบุ -<feature> จะปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ
แท็ก:changes_inputs
affects_outputs
- ค่าเริ่มต้น
--host_force_python=<PY2 or PY3>
: ดูคำอธิบาย -
ลบล้างเวอร์ชัน Python สำหรับการกำหนดค่า exec อาจเป็น "PY2" หรือ "PY3"
แท็ก:loading_and_analysis
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_linkopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง Linker เมื่อลิงก์เครื่องมือในการกำหนดค่าการดำเนินการ
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน macOS ที่เข้ากันได้ขั้นต่ำสำหรับเป้าหมายโฮสต์ หากไม่ได้ระบุ ให้ใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อเลือกส่งไปยังคอมไพเลอร์ C/C++ ที่เลือกเมื่อคอมไพล์ไฟล์บางไฟล์ในการกำหนดค่าผู้บริหาร ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจากรายการรวมและไม่รวมรูปแบบนิพจน์ทั่วไป (ดู --instrumentation_filter) ด้วย Option_1 กับ Option_n นั้นย่อมาจากตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ ในการแยกสตริงจะใช้เฉพาะ @ แรกเท่านั้น ตัวอย่าง: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--[no]incompatible_auto_exec_groups
: "เท็จ" -
เมื่อเปิดใช้ ระบบจะสร้างกลุ่มผู้บริหารสำหรับ Toolchain แต่ละรายการที่กฎใช้โดยอัตโนมัติ กฎในการทำงานนี้ต้องระบุพารามิเตอร์ "toolchain" ในการดำเนินการ ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/17134
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_merge_genfiles_directory
: "true" -
หากเป็นจริง ไดเรกทอรี genfiles จะถูกพับลงในไดเรกทอรี bin
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]instrument_test_targets
: "เท็จ" -
เมื่อเปิดใช้การครอบคลุม ให้ระบุว่าจะพิจารณาการใช้กฎการทดสอบการวัดคุมหรือไม่ เมื่อตั้งค่าแล้ว กฎการทดสอบที่ --instrumentation_filter รวมอยู่จะมีการวัดคุม มิฉะนั้น กฎการทดสอบจะถูกยกเว้นจากการวัดคุมการครอบคลุมเสมอ
แท็ก:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
ค่าเริ่มต้น: "-/javatests[/:],-/test/java[/:]"-
เมื่อเปิดใช้การครอบคลุม ระบบจะวัดเฉพาะกฎที่มีชื่อซึ่งตัวกรองตามนิพจน์ทั่วไปที่ระบุรวมอยู่เท่านั้น กฎที่ขึ้นต้นด้วย "-" จะได้รับการยกเว้นแทน โปรดทราบว่าระบบจะวัดคุมเฉพาะกฎที่ไม่ใช่การทดสอบเท่านั้น ยกเว้นกรณีที่เปิดใช้งาน --instrument_test_targets
แท็ก:affects_outputs
- ค่าเริ่มต้น
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน iOS ที่เข้ากันได้ขั้นต่ำสำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ระบุ ให้ใช้ "ios_sdk_version"
แท็ก:loses_incremental_state
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ios_multi_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างแอปพลิเคชัน ios_ ผลลัพธ์จะเป็นไบนารีสากลที่มีสถาปัตยกรรมที่ระบุทั้งหมด
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--[no]legacy_whole_archive
: "true" -
เลิกใช้งานแล้ว และมีผลแทนด้วย --inสามารถเข้าถึง_remove_legacy_whole_archive (ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7362) เมื่อเปิด ให้ใช้ --whole-archive สำหรับกฎ cc_binary ที่มี linkshared=True และ linkstatic=True หรือ '-static' ใน Linkopts วิธีนี้ใช้สำหรับความเข้ากันได้แบบย้อนหลังเท่านั้น อีกทางเลือกหนึ่งที่ดีกว่าคือการใช้ Alwayslink=1 เมื่อจำเป็น
แท็ก:action_command_lines
,affects_outputs
,deprecated
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--linkopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งไปยัง gcc เมื่อลิงก์
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ltobackendopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังขั้นตอนแบ็กเอนด์ของ LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ltoindexopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังขั้นตอนการจัดทำดัชนี LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--macos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple macOS
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน macOS ที่เข้ากันได้ขั้นต่ำสำหรับเป้าหมาย หากไม่ได้ระบุ ให้ใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--memprof_profile=<a build target label>
: ดูคำอธิบาย -
ใช้โปรไฟล์ Memprof
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]objc_debug_with_GLIBCXX
: "เท็จ" -
หากตั้งค่า และตั้งค่าโหมดการคอมไพล์เป็น "dbg" ให้กำหนด GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC และ GLIBCPP_CONCEPT_CHECKS
แท็ก:action_command_lines
- ค่าเริ่มต้น
--[no]objc_enable_binary_stripping
: "เท็จ" -
เลือกว่าจะดำเนินการลบสัญลักษณ์และโค้ดที่เสียหายในไบนารีที่ลิงก์หรือไม่ ระบบจะลบไบนารีหากระบุทั้ง Flag และ --compilation_mode=opt นี้
แท็ก:action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--objccopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ Objective-C/C++
แท็ก:action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งผ่านไปยัง gcc เฉพาะเมื่อคอมไพล์ไฟล์บางไฟล์ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจากรายการรวมและไม่รวมรูปแบบนิพจน์ทั่วไป (ดู --instrumentation_filter) ด้วย Option_1 กับ Option_n นั้นย่อมาจากตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ ในการแยกสตริงจะใช้เฉพาะ @ แรกเท่านั้น ตัวอย่าง: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับเลือกส่งไปยังแบ็กเอนด์ LTO (ในส่วน --features=thin_lto) เมื่อคอมไพล์ออบเจ็กต์แบ็กเอนด์บางรายการ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจาก รายการรูปแบบ รวมและยกเว้น ของนิพจน์ทั่วไป Option_1 กับ Option_n นั้นย่อมาจากตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ ในการแยกสตริงจะใช้เฉพาะ @ แรกเท่านั้น ตัวอย่าง: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่งแบ็กเอนด์ LTO ของไฟล์ o ทั้งหมดใน //foo/ ยกเว้น bar.o
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--platform_suffix=<a string>
: ดูคำอธิบาย -
ระบุคำต่อท้ายที่จะเพิ่มในไดเรกทอรีการกำหนดค่า
แท็ก:loses_incremental_state
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--propeller_optimize=<a build target label>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ Propeller เพื่อเพิ่มประสิทธิภาพเป้าหมายของบิลด์ โปรไฟล์ใบพัดต้องประกอบด้วยไฟล์อย่างน้อย 1 จาก 2 ไฟล์ โปรไฟล์สำเนา และโปรไฟล์ ld แฟล็กนี้ยอมรับป้ายกำกับบิลด์ซึ่งต้องอ้างถึงไฟล์อินพุตโปรไฟล์ใบพัด ตัวอย่างเช่น ไฟล์ BUILD ที่กำหนดป้ายกำกับใน a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)อาจต้องเพิ่มคำสั่ง ecommerce_files ลงในแพ็กเกจที่เกี่ยวข้องเพื่อให้ Bazel มองเห็นไฟล์เหล่านี้ ต้องใช้ตัวเลือกเป็น: --propeller_optimize=//a/b:propeller_profile
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--propeller_optimize_absolute_cc_profile=<a string>
: ดูคำอธิบาย -
ชื่อเส้นทางสัมบูรณ์ของไฟล์ cc_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพใบพัด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--propeller_optimize_absolute_ld_profile=<a string>
: ดูคำอธิบาย -
ชื่อเส้นทางสัมบูรณ์ของไฟล์ ld_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพใบพัด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--run_under=<a prefix in front of command>
: ดูคำอธิบาย -
คำนำหน้าที่จะแทรกก่อนไฟล์ปฏิบัติการสำหรับ "การทดสอบ" และ "เรียกใช้" คำสั่ง หากค่าคือ "foo -bar" และบรรทัดคำสั่งสำหรับการดำเนินการคือ "test_binary -baz" บรรทัดคำสั่งสุดท้ายคือ "foo -bar test_binary -baz" บรรทัดคำสั่งนี้อาจเป็นป้ายกำกับของเป้าหมายสั่งการได้ด้วย ตัวอย่างเช่น 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'
แท็ก:action_command_lines
-
หากจริง ระบบจะแชร์ไลบรารีเนทีฟที่มีฟังก์ชันการทำงานเหมือนกันกับเป้าหมายต่างๆ
แท็ก: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
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--tvos_cpus=<comma-separated list of options>
รายการ -
รายชื่อสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple tvOS
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน tvOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ระบุ ให้ใช้ "tvos_sdk_version"
แท็ก:loses_incremental_state
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--visionos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple visionOS
แท็ก:loses_incremental_state
loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--watchos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple WatchOS
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน WatchOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ได้ระบุ ให้ใช้ "watchos_sdk_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--xbinary_fdo=<a build target label>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ XbinaryFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อของโปรไฟล์แบบไบนารีที่เป็นค่าเริ่มต้น เมื่อใช้ตัวเลือกนี้ร่วมกับ --fdo_instrument/--fdo_optimize/--fdo_profile ตัวเลือกเหล่านั้นจะมีผลเหนือกว่าเสมอเสมือนว่าไม่ได้ระบุ xbinary_fdo
แท็ก:affects_outputs
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตบิลด์ที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมธง ฯลฯ)
- ค่าเริ่มต้น
--[no]check_licenses
: "เท็จ" -
ตรวจสอบว่าข้อจำกัดในการออกใบอนุญาตที่กำหนดโดยแพ็กเกจที่เกี่ยวข้องไม่ขัดแย้งกับโหมดการเผยแพร่ของเป้าหมายที่กำลังสร้าง โดยค่าเริ่มต้น ใบอนุญาตจะไม่ได้รับการตรวจสอบ
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]check_visibility
: "true" -
หากปิดใช้ ระบบจะลดระดับข้อผิดพลาดระดับการเข้าถึงในทรัพยากร Dependency เป้าหมายให้เหลือเพียงคําเตือน
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]desugar_for_android
: "true" -
เลือกว่าจะใช้ไบต์โค้ด Java 8 ก่อนถอดรหัสหรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--[no]desugar_java8_libs
: "เท็จ" -
เลือกว่าจะรวมไลบรารี Java 8 ที่รองรับในแอปสำหรับอุปกรณ์เดิมหรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]enforce_constraints
: "true" -
ตรวจสอบสภาพแวดล้อมที่แต่ละเป้าหมายใช้งานร่วมกันได้ และรายงานข้อผิดพลาดหากเป้าหมายมีทรัพยากร Dependency ที่ไม่รองรับสภาพแวดล้อมเดียวกัน
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]experimental_check_desugar_deps
: "true" -
ตรวจสอบความถูกต้องของการแยกน้ำตาลที่ระดับไบนารีของ Android อีกครั้งหรือไม่
แท็ก:eagerness_to_exit
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--experimental_import_deps_checking=<a string>
: ดูคำอธิบาย -
ไม่มีการดำเนินการ เก็บไว้สำหรับความเข้ากันได้แบบย้อนหลังเท่านั้น
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--experimental_one_version_enforcement=<off, warning or error>
: "ปิด" -
เมื่อเปิดใช้ ให้บังคับใช้ว่ากฎ java_binary จะมีไฟล์คลาสเดียวกันใน classpath มากกว่า 1 เวอร์ชันไม่ได้ การบังคับใช้นี้อาจทำให้บิลด์เสียหายหรืออาจทำให้เกิดคำเตือน
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "ค่าเริ่มต้น" -
หากเป็นจริง ให้ตรวจสอบว่าเป้าหมาย Java ประกาศเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency อย่างชัดเจน
แท็ก:build_file_semantics
eagerness_to_exit
- ค่าเริ่มต้น
--[no]incompatible_check_testonly_for_output_files
: "เท็จ" -
หากเปิดใช้ ให้ตรวจสอบ testonly สำหรับเป้าหมายที่จำเป็นเบื้องต้นที่เป็นไฟล์เอาต์พุตโดยค้นหา testonly ของกฎที่สร้าง รายการนี้ตรงกับการตรวจสอบระดับการเข้าถึง
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_check_visibility_for_toolchains
: "เท็จ" -
หากเปิดใช้ การตรวจสอบระดับการเข้าถึงจะมีผลกับการติดตั้งใช้งาน Toolchain ด้วย
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disable_native_android_rules
: "เท็จ" -
หากเปิดใช้ ระบบจะปิดใช้กฎที่มีอยู่สำหรับ Android โดยตรง โปรดใช้กฎของ Android Starlark จาก https://github.com/bazelbuild/rules_android
แท็ก:eagerness_to_exit
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disable_native_apple_binary_rule
: "เท็จ" -
ไม่มีการดำเนินการ เก็บไว้ที่นี่เพื่อดูความเข้ากันได้แบบย้อนหลัง
แท็ก:eagerness_to_exit
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_python_disable_py2
: "true" -
หากเป็น "จริง" การใช้การตั้งค่า Python 2 จะทำให้เกิดข้อผิดพลาด ซึ่งรวมถึง python_version=PY2, srcs_version=PY2 และ srcs_version=PY2ONLY ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/15684
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]one_version_enforcement_on_java_tests
: "true" -
เมื่อเปิดใช้ และตั้งค่า Experiment_one_version_enforcement เป็นค่าที่ไม่ใช่ NONE แล้ว ให้บังคับใช้ 1 เวอร์ชันกับเป้าหมาย java_test คุณสามารถปิดการแจ้งว่าไม่เหมาะสมนี้เพื่อปรับปรุงประสิทธิภาพการทดสอบให้ดียิ่งขึ้นได้ โดยไม่ต้องกลัวว่าจะมีการละเมิดเวอร์ชันใดเวอร์ชันหนึ่ง
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--python_native_rules_allowlist=<a build target label>
: ดูคำอธิบาย -
รายการที่อนุญาต (package_group target (เป้าหมายกลุ่มแพ็กเกจ) ที่จะใช้เมื่อบังคับใช้ --incompatible_python_disallow_native_rules
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]strict_filesets
: "เท็จ" -
หากเปิดใช้ตัวเลือกนี้ ระบบจะรายงานว่าชุดไฟล์ข้ามขอบเขตของแพ็กเกจเป็นข้อผิดพลาด
แท็ก:build_file_semantics
eagerness_to_exit
- ค่าเริ่มต้น
--strict_proto_deps=<off, warn, error, strict or default>
: "ข้อผิดพลาด" -
หากไม่ "ปิด" ให้ตรวจสอบว่าเป้าหมาย protocol_library ประกาศอย่างชัดแจ้งว่าเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้นของ
--strict_public_imports=<off, warn, error, strict or default>
: "ปิด" -
หากไม่ "ปิด" ให้ตรวจสอบว่าเป้าหมาย protocol_library ประกาศอย่างชัดเจนถึงเป้าหมายทั้งหมดที่ใช้ใน "นำเข้าสาธารณะ" ตามที่ส่งออกแล้ว
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้น
--[no]strict_system_includes
: "เท็จ" -
หากเป็น "จริง" ส่วนหัวที่พบผ่านทางระบบรวมเส้นทาง (-isystem) ต้องมีการประกาศด้วย
แท็ก:loading_and_analysis
eagerness_to_exit
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--target_environment=<a build target label>
รายการ -
ประกาศสภาพแวดล้อมเป้าหมายของบิลด์นี้ ต้องอ้างอิงถึงป้ายกำกับไปยัง "สภาพแวดล้อม" กฎ หากระบุ เป้าหมายระดับบนสุดทั้งหมดต้องเข้ากันได้กับสภาพแวดล้อมนี้
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อเอาต์พุตการลงชื่อของบิลด์:
- ค่าเริ่มต้น
--apk_signing_method=<v1, v2, v1_v2 or v4>
: "v1_v2" -
การใช้งานเพื่อรับรอง APK
แท็ก:action_command_lines
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--[no]device_debug_entitlements
: "true" -
หากมีการตั้งค่า และโหมดการคอมไพล์ไม่ใช่ "เพิ่มประสิทธิภาพ" แอป objc จะรวมการให้สิทธิ์การแก้ไขข้อบกพร่องเมื่อลงชื่อ
แท็ก:changes_inputs
- ค่าเริ่มต้น
--ios_signing_cert_name=<a string>
: ดูคำอธิบาย -
ชื่อใบรับรองที่จะใช้สำหรับ iOS Signing หากไม่ได้ตั้งค่า ระบบจะกลับไปใช้โปรไฟล์การจัดสรร อาจเป็นค่ากำหนดข้อมูลประจำตัว Keychain ของใบรับรองหรือ (สตริงย่อย) ของชื่อสามัญของใบรับรองตามหน้า man ของ Codesign (รหัสการลงชื่อเข้าใช้)
แท็ก:action_command_lines
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_disallow_legacy_py_provider
: "true" -
ไม่มีการดำเนินการ จะถูกนำออกในเร็วๆ นี้
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disallow_sdk_frameworks_attributes
: "เท็จ" -
หากเป็น "จริง" ไม่อนุญาตแอตทริบิวต์ sdk_frameworks และ external_sdk_frameworks ใน objc_library andobjc_import
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_objc_alwayslink_by_default
: "เท็จ" -
หากเป็น "จริง" ตั้งค่าเริ่มต้นเป็น "จริง" สำหรับแอตทริบิวต์ Alwayslink ใน objc_library และ objc_IMPORT
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_python_disallow_native_rules
: "เท็จ" -
เมื่อเป็นจริง เกิดข้อผิดพลาดขึ้นเมื่อใช้กฎ py_* ในตัว ควรใช้กฎ rules_python แทน ดูข้อมูลเพิ่มเติมและวิธีการย้ายข้อมูลได้ที่ https://github.com/bazelbuild/bazel/issues/17773
แท็ก:loading_and_analysis
incompatible_change
- สภาพแวดล้อมการทดสอบหรือตัวดำเนินการทดสอบ:
- ค่าเริ่มต้น
--[no]allow_analysis_failures
: "เท็จ" -
หากจริง การวิเคราะห์เป้าหมายของกฎไม่สำเร็จส่งผลให้เกิดการเผยแพร่อินสแตนซ์ของ AnalysisFailureInfo ของเป้าหมายที่มีคำอธิบายข้อผิดพลาด แทนที่จะทำให้บิลด์ไม่สำเร็จ
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--analysis_testing_deps_limit=<an integer>
: "2000" -
ตั้งค่าจำนวนสูงสุดของทรัพยากร Dependency แบบทรานซิทีฟผ่านแอตทริบิวต์กฎที่มีการเปลี่ยนการกำหนดค่า for_analysis_testing การใช้เกินขีดจำกัดนี้จะทำให้เกิดข้อผิดพลาดของกฎ
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]break_build_on_parallel_dex2oat_failure
: "เท็จ" -
หากความล้มเหลวจริงในการดำเนินการ dex2oat จะทำให้บิลด์เสียหายแทนที่จะเรียกใช้ dex2oat ระหว่างรันไทม์ทดสอบ
แท็ก:loading_and_analysis
experimental
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g memory=10,30,60,100>
รายการ - ลบล้างจำนวนทรัพยากรเริ่มต้นสำหรับการทดสอบ รูปแบบที่คาดไว้คือ <resource>=<value> หากระบุจำนวนบวกตัวเดียวเป็น <value> ระบบจะลบล้างทรัพยากรเริ่มต้นสำหรับขนาดทดสอบทั้งหมด หากระบุตัวเลขที่คั่นด้วยคอมมา 4 ตัว จำนวนดังกล่าวจะแทนที่จำนวนทรัพยากรสำหรับขนาดทดสอบขนาดเล็ก กลาง ใหญ่ และขนาดใหญ่ตามลำดับ ค่าอาจเป็น HOST_RAM/HOST_CPU (ไม่บังคับ) ตามด้วย [-|*]<Flo> (เช่น Memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4) ทรัพยากรการทดสอบเริ่มต้นที่ระบุโดยแฟล็กนี้จะถูกลบล้างโดยทรัพยากรที่อาจไม่เหมาะสมซึ่งระบุไว้ในแท็ก
- ค่าเริ่มต้น
--[no]experimental_android_use_parallel_dex2oat
: "เท็จ" -
ใช้ dex2oat แบบขนานเพื่อเร่งความเร็ว android_test
แท็ก:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- ค่าเริ่มต้น
--[no]ios_memleaks
: "เท็จ" -
เปิดใช้การตรวจหาหน่วยความจำรั่วไหลในเป้าหมาย ios_test
แท็ก:action_command_lines
- ค่าเริ่มต้น
--ios_simulator_device=<a string>
: ดูคำอธิบาย -
อุปกรณ์ที่จะจำลองเมื่อเรียกใช้แอปพลิเคชัน iOS ในเครื่องมือจำลอง เช่น "iPhone 6" คุณดูรายการอุปกรณ์ได้โดยเรียกใช้ "xcrun simctl list devicetypes" บนเครื่องที่เครื่องมือจำลองจะทำงาน
แท็ก:test_runner
- ค่าเริ่มต้น
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชันของ iOS ที่จะเรียกใช้บนเครื่องมือจำลองเมื่อทำงานหรือทดสอบ ระบบจะไม่สนใจกฎ ios_test หากกฎระบุอุปกรณ์เป้าหมายไว้ในกฎ
แท็ก:test_runner
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
รายการ - ระบุจำนวนครั้งที่จะทำการทดสอบแต่ละครั้ง หากการดำเนินการเหล่านั้นล้มเหลวไม่ว่าด้วยเหตุผลใดก็ตาม จะถือว่าการทดสอบทั้งหมดไม่ผ่าน โดยปกติแล้ว ค่าที่ระบุจะเป็นแค่จำนวนเต็ม ตัวอย่าง: --runs_per_test=3 จะทำการทดสอบทั้งหมด 3 ครั้ง ไวยากรณ์สำรอง: regex_filter@runs_per_test โดย running_per_test ย่อมาจากค่าจำนวนเต็ม ส่วน regex_filter หมายถึงรายการรูปแบบการรวมและยกเว้นรูปแบบนิพจน์ทั่วไป (โปรดดู --instrumentation_filter) ตัวอย่างเช่น --runs_per_test=//foo/.*,-//foo/bar/.*@3 จะทำการทดสอบทั้งหมดใน //foo/ ยกเว้นการทดสอบภายใต้ foo/bar 3 ครั้ง ตัวเลือกนี้ส่งได้หลายครั้ง อาร์กิวเมนต์ที่ส่งผ่านล่าสุดที่ตรงกันจะมีความสำคัญเหนือกว่า หากไม่มีผลลัพธ์ที่ตรงกัน ระบบจะทำการทดสอบเพียงครั้งเดียว
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--test_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุตัวแปรสภาพแวดล้อมเพิ่มเติมที่จะแทรกลงในสภาพแวดล้อมตัวดำเนินการทดสอบ คุณระบุตัวแปรได้โดยใช้ชื่อ ซึ่งในกรณีนี้ระบบจะอ่านค่าของตัวแปรจากสภาพแวดล้อมไคลเอ็นต์ Bazel หรือด้วยคู่ชื่อ=ค่า ตัวเลือกนี้ใช้ได้หลายครั้งเพื่อระบุตัวแปรหลายรายการ ใช้เฉพาะโดย "การทดสอบ bazel" เท่านั้น คำสั่ง
แท็ก:test_runner
- ค่าเริ่มต้น
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - ลบล้างค่าระยะหมดเวลาในการทดสอบเริ่มต้นสำหรับระยะหมดเวลาทดสอบ (เป็นวินาที) หากระบุค่าจำนวนเต็มบวกค่าเดียว ค่าดังกล่าวจะแทนที่หมวดหมู่ทั้งหมด หากระบุจำนวนเต็มที่คั่นด้วยคอมมา 4 ตัวเลข ค่าดังกล่าวจะลบล้างระยะหมดเวลาสำหรับแบบสั้น ปานกลาง ยาว และนิรันดร์ (ตามลำดับนั้น) ไม่ว่าจะเป็นรูปแบบใด ค่า -1 จะบอกให้ Blaze ใช้ระยะหมดเวลาเริ่มต้นสำหรับหมวดหมู่นั้น
- ค่าเริ่มต้น
--[no]zip_undeclared_test_outputs
: "true" -
หากเป็น "จริง" ระบบจะเก็บเอาต์พุตทดสอบที่ไม่ได้ประกาศไว้ในไฟล์ ZIP
แท็ก:test_runner
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพเวลาของบิลด์
- ค่าเริ่มต้น
--[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_retain_test_configuration_across_testonly
: "เท็จ" -
เมื่อเปิดใช้ --trim_test_configuration จะไม่ตัดการกำหนดค่าการทดสอบสำหรับกฎที่ทำเครื่องหมายว่า testonly=1 ทั้งนี้เพื่อลดปัญหาความขัดแย้งในการดำเนินการเมื่อกฎที่ไม่ใช่การทดสอบต้องพึ่งพากฎ cc_test จะไม่มีผลหาก --trim_test_configuration เป็นเท็จ
แท็ก:loading_and_analysis
loses_incremental_state
- ค่าเริ่มต้น
--[no]experimental_starlark_cc_import
: "เท็จ" -
หากเปิดใช้ เวอร์ชัน Starlark ของ cc_import จะสามารถใช้ได้
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--[no]experimental_unsupported_and_brittle_include_scanning
: "เท็จ" -
เลือกว่าจะจำกัดอินพุตเฉพาะการคอมไพล์ C/C++ หรือไม่โดยการแยกวิเคราะห์ #include บรรทัดจากไฟล์อินพุต ซึ่งจะช่วยปรับปรุงประสิทธิภาพและส่วนเพิ่มด้วยการลดขนาดของแผนผังอินพุตสำหรับการคอมไพล์ อย่างไรก็ตาม ก็อาจทำให้บิลด์เสียหายได้เช่นกัน เนื่องจากเครื่องมือสแกนดังกล่าวไม่สามารถใช้งานความหมายของโปรเซสเซอร์ล่วงหน้าแบบ C ได้อย่างสมบูรณ์ โดยเฉพาะอย่างยิ่ง ระบบจะไม่เข้าใจคำสั่ง #include แบบไดนามิก และไม่สนใจตรรกะตามเงื่อนไขของตัวประมวลผลล่วงหน้า คุณต้องรับความเสี่ยงของการใช้งานเอง เราจะปิดปัญหาที่เกี่ยวข้องกับการแจ้งว่าไม่เหมาะสมนี้
แท็ก:loading_and_analysis
,execution
,changes_inputs
- ค่าเริ่มต้น
--[no]incremental_dexing
: "true" -
ส่วนใหญ่จะทำงานสำหรับ Dexing แยกต่างหากสำหรับไฟล์ Jar แต่ละไฟล์
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--[no]objc_use_dotd_pruning
: "true" -
หากตั้งค่าไว้ จะมีการใช้ไฟล์ .d ที่มาจาก clang เพื่อตัดชุดอินพุตที่ส่งผ่านเข้าไปในคอมไพล์ objc
แท็ก:changes_inputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]process_headers_in_dependencies
: "เท็จ" -
เมื่อสร้าง //a:a เป้าหมาย ให้ประมวลผลส่วนหัวในเป้าหมายทั้งหมดที่ //a:a ต้องใช้ (หากเปิดใช้การประมวลผลส่วนหัวสำหรับ Toolchain)
แท็ก:execution
- ค่าเริ่มต้น
--[no]trim_test_configuration
: "true" -
เมื่อเปิดใช้ ระบบจะล้างตัวเลือกที่เกี่ยวข้องกับการทดสอบซึ่งอยู่ใต้ระดับบนสุดของบิลด์ เมื่อแฟล็กนี้ทำงานอยู่ ระบบจะสร้างการทดสอบเป็นทรัพยากร Dependency ของกฎที่ไม่ใช่การทดสอบไม่ได้ แต่การเปลี่ยนแปลงตัวเลือกที่เกี่ยวข้องกับการทดสอบจะไม่ทำให้มีการวิเคราะห์กฎที่ไม่ใช่การทดสอบอีกครั้ง
แท็ก:loading_and_analysis
loses_incremental_state
- การพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
- ค่าเริ่มต้น
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
พิมพ์ข้อมูลการแก้ไขข้อบกพร่องระหว่างการแปลง Toolchain แฟล็กจะใช้นิพจน์ทั่วไปซึ่งตรวจสอบกับประเภท Toolchain และเป้าหมายที่เฉพาะเจาะจงเพื่อดูว่าควรแก้ไขข้อบกพร่องใด นิพจน์ทั่วไปหลายรายการจะคั่นด้วยคอมมา แล้วระบบจะเลือกนิพจน์ทั่วไปแต่ละรายการแยกกัน หมายเหตุ: เอาต์พุตของ Flag นี้มีความซับซ้อนมากและน่าจะเป็นประโยชน์ต่อผู้เชี่ยวชาญด้านการแก้ไข Toolchain เท่านั้น
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--flag_alias=<a 'name=value' flag alias>
รายการ -
ตั้งชื่อย่อสำหรับธง Starlark โดยใช้คู่คีย์-ค่าคู่เดียวในรูปแบบ "<key>=<value>" เป็นอาร์กิวเมนต์
แท็ก:changes_inputs
- ค่าเริ่มต้น
--[no]incompatible_default_to_explicit_init_py
: "เท็จ" -
แฟล็กนี้เปลี่ยนลักษณะการทำงานเริ่มต้นเพื่อไม่ให้สร้างไฟล์ __init__.py โดยอัตโนมัติในไฟล์การเรียกใช้ของเป้าหมาย Python อีกต่อไป แม่นยำเมื่อเป้าหมาย py_binary หรือ py_test ตั้งค่า legacy_create_init เป็น "auto" (ค่าเริ่มต้น) ระบบจะถือว่าเป็น "เท็จ" เมื่อมีการตั้งค่าแฟล็กนี้เท่านั้น ดู https://github.com/bazelbuild/bazel/issues/10076
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_py2_outputs_are_suffixed
: "true" -
หากเป็นจริง เป้าหมายที่สร้างในการกำหนดค่า Python 2 จะปรากฏภายใต้รูทเอาต์พุตที่มีคำต่อท้าย "-py2" ขณะที่เป้าหมายที่สร้างขึ้นสำหรับ Python 3 จะปรากฏในรูทที่ไม่มีส่วนต่อท้ายที่เกี่ยวข้องกับ Python ซึ่งหมายความว่าลิงก์สัญลักษณ์ความสะดวก "bazel-bin" จะชี้ไปยังเป้าหมาย Python 3 แทนที่จะเป็น Python 2 หากคุณเปิดใช้ตัวเลือกนี้ ขอแนะนำให้เปิดใช้ "--incompatible_py3_is_default" ด้วย
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_py3_is_default
: "true" -
หากเป็นจริง เป้าหมาย "py_binary" และ "py_test" ที่ไม่ได้ตั้งค่าแอตทริบิวต์ "python_version" (หรือ "default_python_version") จะมีค่าเริ่มต้นเป็น PY3 แทนที่จะเป็น PY2 หากตั้งค่าแฟล็กนี้ ขอแนะนำให้ตั้งค่า "--incompatible_py2_outputs_are_suffixed"
แท็ก:loading_and_analysis
,affects_outputs
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_use_python_toolchains
: "true" -
หากตั้งค่าเป็น "จริง" กฎ Python ในเครื่องที่เป็นไฟล์ปฏิบัติการจะใช้รันไทม์ของ Python ที่ระบุโดย Toolchain ของ Python แทนรันไทม์ที่มาจากแฟล็กเดิม เช่น --python_top
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--python_version=<PY2 or PY3>
: ดูคำอธิบาย -
โหมดเวอร์ชันหลักของ Python ไม่ว่าจะเป็น "PY2" หรือ "PY3" โปรดทราบว่าเป้าหมาย "py_binary" และ "py_test" จะลบล้างค่านี้ (แม้ว่าจะไม่ได้ระบุเวอร์ชันอย่างชัดเจน) จึงมักไม่มีเหตุผลที่จะต้องระบุแฟล็กนี้
แท็ก:loading_and_analysis
affects_outputs
- ที่ไม่ถูกจัดหมวดหมู่:
--[no]cache_test_results
[-t
] ค่าเริ่มต้น: "อัตโนมัติ"- หากตั้งค่าเป็น "อัตโนมัติ" Bazel จะทำการทดสอบอีกครั้งเฉพาะในกรณีต่อไปนี้ (1) Bazel ตรวจพบการเปลี่ยนแปลงในการทดสอบหรือทรัพยากร Dependency (2) การทดสอบได้รับการทำเครื่องหมายว่าเป็นภายนอก (3) มีการขอทำการทดสอบหลายครั้งด้วย --runs_per_test หรือ(4) การทดสอบล้มเหลวก่อนหน้านี้ หากตั้งค่าเป็น "ใช่" Bazel จะแคชผลการทดสอบทั้งหมด ยกเว้นการทดสอบที่ทำเครื่องหมายว่าภายนอก หากตั้งค่าเป็น "ไม่" Bazel จะไม่แคชผลการทดสอบใดๆ
- ค่าเริ่มต้น
--[no]experimental_cancel_concurrent_tests
: "เท็จ" -
หากเป็น "จริง" Blaze จะยกเลิกการทดสอบพร้อมกันในการรันที่สำเร็จครั้งแรก วิธีนี้จะมีประโยชน์เมื่อใช้ร่วมกับ --runs_per_test_detects_flakes เท่านั้น
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_fetch_all_coverage_outputs
: "เท็จ" -
หากเป็น "จริง" Bazel จะดึงข้อมูลไดเรกทอรีข้อมูลการครอบคลุมทั้งหมดสำหรับการทดสอบแต่ละครั้งระหว่างการทำงานของการครอบคลุม
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_generate_llvm_lcov
: "เท็จ" -
หากเป็น "จริง" ความครอบคลุมของคําพูดจะสร้างรายงาน LCOV
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_j2objc_header_map
: "true" - เลือกว่าจะสร้างแผนที่ส่วนหัว J2ObjC ควบคู่ไปกับการแปลง J2ObjC หรือไม่
- ค่าเริ่มต้น
--[no]experimental_j2objc_shorter_header_path
: "เท็จ" -
เลือกว่าจะสร้างโดยใช้เส้นทางส่วนหัวที่สั้นกว่าหรือไม่ (ใช้ "_ios" แทน "_j2objc")
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_java_classpath=<off, javabuilder or bazel>
: "javabuilder" - เปิดใช้งานคลาสพาธที่ลดลงสำหรับการคอมไพล์ Java
- ค่าเริ่มต้น
--[no]experimental_limit_android_lint_to_android_constrained_java
: "เท็จ" -
ไม่มีการดำเนินการ เก็บไว้สำหรับความเข้ากันได้แบบย้อนหลังเท่านั้น
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_run_android_lint_on_java_rules
: "เท็จ" -
ระบุว่าจะตรวจสอบแหล่งที่มา java_* หรือไม่
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]explicit_java_test_deps
: "เท็จ" - ระบุทรัพยากร Dependency ของ JUnit หรือ Hamcrest อย่างชัดเจนใน java_test แทนที่จะได้มาจาก Dep ของ TestRunner โดยไม่ตั้งใจ ตอนนี้ใช้ได้กับ bazel เท่านั้น
- ค่าเริ่มต้น
--host_java_launcher=<a build target label>
: ดูคำอธิบาย - Java Launcher ที่เครื่องมือใช้ซึ่งดำเนินการในระหว่างบิลด์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_javacopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมในการส่งไปยัง Javac เมื่อสร้างเครื่องมือที่ดำเนินการระหว่างบิลด์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_jvmopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง Java VM เมื่อสร้างเครื่องมือสร้างที่ดำเนินการระหว่างบิลด์ ระบบจะเพิ่มตัวเลือกเหล่านี้ไปยังตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
- ค่าเริ่มต้น
--[no]incompatible_check_sharding_support
: "true" -
หากเป็น "จริง" Bazel จะไม่ผ่านการทดสอบชาร์ด หากตัวดำเนินการทดสอบไม่ได้ระบุว่ารองรับการชาร์ดดิ้งโดยการแตะไฟล์ที่เส้นทางใน TEST_SHARD_STATUS_FILE หากเป็นเท็จ ตัวดำเนินการทดสอบที่ไม่รองรับการชาร์ดจะนำไปยังการทดสอบทั้งหมดที่ทำงานในชาร์ดแต่ละรายการ
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_exclusive_test_sandboxed
: "true" -
หากจริง การทดสอบพิเศษจะทำงานโดยใช้กลยุทธ์แซนด์บ็อกซ์ เพิ่ม "ท้องถิ่น" เพื่อบังคับให้การทดสอบพิเศษทำงานภายในเครื่อง
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_strict_action_env
: "เท็จ" -
หากเป็นจริง Bazel จะใช้สภาพแวดล้อมที่มีค่าคงที่สำหรับ PATH และไม่รับค่า LD_LIBRARY_PATH ใช้ --action_env=ENV_VARIABLE หากคุณต้องการรับตัวแปรสภาพแวดล้อมที่เฉพาะเจาะจงจากไคลเอ็นต์ แต่โปรดทราบว่าการทำเช่นนี้อาจป้องกันการแคชข้ามผู้ใช้ได้หากมีการใช้แคชที่แชร์
แท็ก:loading_and_analysis
incompatible_change
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--j2objc_translation_flags=<comma-separated list of options>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยังเครื่องมือ J2ObjC
--java_debug
-
ทำให้เครื่องเสมือนของ Java ของการทดสอบ Java ต้องรอการเชื่อมต่อจากโปรแกรมแก้ไขข้อบกพร่องที่สอดคล้องกับ JDWP (เช่น jdb) ก่อนเริ่มการทดสอบ โดยนัย -test_output=streamed
ขยายเป็น
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- ค่าเริ่มต้น
--[no]java_deps
: "true" - สร้างข้อมูลทรัพยากร Dependency (ในขณะนี้คือคลาสพาธเวลาคอมไพล์) ต่อเป้าหมาย Java
- ค่าเริ่มต้น
--[no]java_header_compilation
: "true" - คอมไพล์จากต้นทางโดยตรง
- ค่าเริ่มต้นของ
--java_language_version=<a string>
: "" - เวอร์ชันภาษา Java
- ค่าเริ่มต้น
--java_launcher=<a build target label>
: ดูคำอธิบาย - Java Launcher ที่จะใช้เมื่อสร้างไบนารีของ Java หากตั้งค่าสถานะนี้เป็นสตริงว่างเปล่า ระบบจะใช้ Launcher ของ JDK "Launcher" จะลบล้างแฟล็กนี้
--java_runtime_version=<a string>
ค่าเริ่มต้น: "local_jdk"- เวอร์ชันรันไทม์ของ Java
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--javacopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง Javac
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--jvmopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง Java VM ระบบจะเพิ่มตัวเลือกเหล่านี้ไปยังตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
- ค่าเริ่มต้น
--legacy_main_dex_list_generator=<a build target label>
: ดูคำอธิบาย - ระบุไบนารีที่จะใช้สร้างรายการคลาสที่ต้องอยู่ใน Dex หลักเมื่อคอมไพล์ Multidex เดิม
- ค่าเริ่มต้น
--optimizing_dexer=<a build target label>
: ดูคำอธิบาย - ระบุไบนารีที่จะใช้ทำ Dexing โดยไม่ต้องชาร์ดดิ้ง
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--plugin=<a build target label>
รายการ - ปลั๊กอินที่ใช้ในบิลด์ ปัจจุบันใช้งานได้กับ java_plugin
- ค่าเริ่มต้น
--proguard_top=<a build target label>
: ดูคำอธิบาย - ระบุเวอร์ชัน ProGuard ที่จะใช้สำหรับการนำโค้ดออกเมื่อสร้างไบนารีของ Java
--proto_compiler=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/protocol:protocol"-
ป้ายกำกับของคอมไพเลอร์ Proto
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]proto_profile
: "true" -
ระบุว่าจะส่ง profile_path ไปยังคอมไพเลอร์ Pro หรือไม่
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--proto_profile_path=<a build target label>
: ดูคำอธิบาย -
โปรไฟล์ที่จะส่งไปยังคอมไพเลอร์ Pro เป็น profile_path หากไม่ได้ตั้งค่า แต่ --Proto_profile เป็นจริง (ค่าเริ่มต้น) จะอนุมานเส้นทางจาก --fdo_optimize
แท็ก: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:/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, อื่นๆ ทั้งหมด: /bin/bash) โปรดทราบว่าการใช้ Shell ที่เข้ากันไม่ได้กับ Bash อาจทำให้บิลด์ล้มเหลวหรือรันไทม์ของไบนารีที่สร้างขึ้นไม่สำเร็จ
แท็ก:loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--test_arg=<a string>
รายการ - ระบุตัวเลือกและอาร์กิวเมนต์เพิ่มเติมที่ควรส่งไปยังไฟล์ปฏิบัติการทดสอบ ซึ่งสามารถใช้หลายครั้งเพื่อระบุอาร์กิวเมนต์ได้หลายรายการ หากดำเนินการทดสอบหลายรายการ แต่ละรายการจะได้รับอาร์กิวเมนต์ที่เหมือนกัน ใช้เฉพาะโดย "การทดสอบ bazel" เท่านั้น คำสั่ง
- ค่าเริ่มต้น
--test_filter=<a string>
: ดูคำอธิบาย - ระบุตัวกรองที่จะส่งต่อไปยังเฟรมเวิร์กการทดสอบ ใช้เพื่อจำกัดการทดสอบ โปรดทราบว่าการเปลี่ยนแปลงนี้ไม่มีผลต่อเป้าหมายที่สร้างขึ้น
- ค่าเริ่มต้น
--test_result_expiration=<an integer>
: "-1" - ตัวเลือกนี้เลิกใช้งานแล้วและไม่ส่งผลใดๆ
- ค่าเริ่มต้น
--[no]test_runner_fail_fast
: "เท็จ" - การส่งต่อล้มเหลวตัวเลือกอย่างรวดเร็วไปยังตัวดำเนินการทดสอบ ตัวดำเนินการทดสอบควรหยุดการดำเนินการเมื่อล้มเหลวครั้งแรก
- ค่าเริ่มต้น
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
: "อาจไม่เหมาะสม" - ระบุกลยุทธ์สำหรับการทดสอบชาร์ดดิ้ง: "Explicit" จะใช้ชาร์ดดิ้งก็ต่อเมื่อ "shard_count" เท่านั้น มีแอตทริบิวต์ BUILD "ปิดใช้" ว่าจะไม่ใช้ทดสอบชาร์ดดิ้ง "forced=k" เพื่อบังคับใช้ "k" ชาร์ดสำหรับการทดสอบโดยไม่คำนึงถึง "shard_count" BUILD
- ค่าเริ่มต้นของ
--tool_java_language_version=<a string>
: "" - เวอร์ชันภาษา Java ที่ใช้เพื่อเรียกใช้เครื่องมือที่จำเป็นระหว่างการสร้าง
- ค่าเริ่มต้นของ
--tool_java_runtime_version=<a string>
: "remotejdk_11" - เวอร์ชันรันไทม์ของ Java ที่ใช้เพื่อเรียกใช้เครื่องมือในระหว่างบิลด์
- ค่าเริ่มต้น
--[no]use_ijars
: "true" - หากเปิดใช้ ตัวเลือกนี้จะทำให้การคอมไพล์ Java ใช้ jars อินเทอร์เฟซ ซึ่งจะทำให้การคอมไพล์แบบเพิ่มขึ้นเรื่อยๆ ได้เร็วขึ้น แต่ข้อความแสดงข้อผิดพลาดอาจแตกต่างกันได้
ตัวเลือกความช่วยเหลือ
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_use_plus_in_repo_names
: "true" -
ไม่มีการดำเนินการ
แท็ก:loading_and_analysis
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
- ค่าเริ่มต้น
--help_verbosity=<long, medium or short>
: "ปานกลาง" -
เลือกรายละเอียดของคำสั่งความช่วยเหลือ
แท็ก:terminal_output
--long
[-l
]-
แสดงคำอธิบายแบบเต็มของตัวเลือกแต่ละรายการ แทนที่จะแสดงเพียงชื่อตัวเลือก
ขยายเป็น
--help_verbosity=long
แท็ก:terminal_output
--short
-
แสดงเฉพาะชื่อตัวเลือก ไม่ใช่ประเภทหรือความหมาย
ขยายเป็น
--help_verbosity=short
แท็ก:terminal_output
ตัวเลือกข้อมูล
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_use_plus_in_repo_names
: "true" -
ไม่มีการดำเนินการ
แท็ก:loading_and_analysis
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
- ค่าเริ่มต้น
--[no]show_make_env
: "เท็จ" -
มี "ผู้ผลิต" สภาพแวดล้อมในเอาต์พุต
แท็ก:affects_outputs
terminal_output
ตัวเลือกใบอนุญาต
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_use_plus_in_repo_names
: "true" -
ไม่มีการดำเนินการ
แท็ก:loading_and_analysis
ตัวเลือกการติดตั้งบนอุปกรณ์เคลื่อนที่
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์:
- ค่าเริ่มต้นของ
--mode=<classic, classic_internal_test_do_not_use or skylark>
: "skylark" -
เลิกใช้งาน Flag ไม่มีผล ระบบยังคงรองรับเฉพาะโหมด Skylark เท่านั้น
แท็ก:loading_and_analysis
,execution
,incompatible_change
- ตัวเลือกที่กำหนดค่า Toolchain ที่ใช้สำหรับการดำเนินการมีดังนี้
- ค่าเริ่มต้นของ
--adb=<a string>
: "" -
ไบนารี adb ที่จะใช้สำหรับ "การติดตั้งบนมือถือ" คำสั่ง หากไม่ระบุ ระบบจะใช้ SDK ใน Android SDK ที่ระบุโดยตัวเลือกบรรทัดคำสั่ง --android_sdk (หรือ SDK เริ่มต้นหากไม่ได้ระบุ --android_sdk)
แท็ก:changes_inputs
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่งมีดังนี้
- ค่าเริ่มต้น
--[no]incremental
: "เท็จ" -
เลือกว่าจะติดตั้งเพิ่มหรือไม่ หากเป็นจริง ให้พยายามหลีกเลี่ยงการทำงานเพิ่มเติมที่ไม่จำเป็นโดยการอ่านสถานะของอุปกรณ์ที่จะมีการติดตั้งโค้ดและใช้ข้อมูลดังกล่าวเพื่อหลีกเลี่ยงการทำงานที่ไม่จำเป็น หากเป็น "เท็จ" (ค่าเริ่มต้น) ให้ทำการติดตั้งโดยสมบูรณ์เสมอ
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]split_apks
: "เท็จ" -
ต้องการใช้ APK แยกเพื่อติดตั้งและอัปเดตแอปพลิเคชันในอุปกรณ์หรือไม่ ใช้งานได้กับอุปกรณ์ที่ใช้ Marshmallow ขึ้นไปเท่านั้น
แท็ก:loading_and_analysis
affects_outputs
- เอาต์พุตที่ต้องการ ซึ่งส่งผลต่อค่าของผลลัพธ์ ไม่ใช่ค่าที่มีอยู่
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--adb_arg=<a string>
รายการ -
อาร์กิวเมนต์เพิ่มเติมสำหรับส่งผ่านไปยัง adb มักใช้เพื่อระบุอุปกรณ์ที่จะติดตั้ง
แท็ก:action_command_lines
--debug_app
-
เลือกว่าจะรอโปรแกรมแก้ไขข้อบกพร่องก่อนเริ่มแอปหรือไม่
วันที่
ขยายเป็น
--start=DEBUG
แท็ก:execution
- ค่าเริ่มต้นของ
--device=<a string>
: "" -
หมายเลขซีเรียลของอุปกรณ์ adb หากไม่ได้ระบุ ระบบจะใช้อุปกรณ์เครื่องแรก
แท็ก:action_command_lines
- ค่าเริ่มต้น
--start=<no, cold, warm or debug>
: "NO" -
แอปควรเริ่มต้นใช้งานอย่างไรหลังจากติดตั้ง ตั้งค่าเป็น WARM เพื่อเก็บรักษาและคืนค่าสถานะแอปพลิเคชันในการติดตั้งที่เพิ่มขึ้น
แท็ก:execution
--start_app
-
เลือกว่าจะเริ่มแอปหลังจากติดตั้งหรือไม่
ขยายเป็น
--start=COLD
แท็ก:execution
- ตัวเลือกนี้จะมีผลต่อความหมายของภาษา Starlark หรือ API บิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_use_plus_in_repo_names
: "true" -
ไม่มีการดำเนินการ
แท็ก:loading_and_analysis
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
- ค่าเริ่มต้นของ
--incremental_install_verbosity=<a string>
: "" -
การพูดรายละเอียดสำหรับการติดตั้งทีละน้อย ตั้งค่าเป็น 1 สำหรับการบันทึกการแก้ไขข้อบกพร่อง
แท็ก:bazel_monitoring
ตัวเลือกม็อด
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์:
--[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
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_config_setting_private_default_visibility
: "เท็จ" -
หากไม่รองรับ _enforce_config_setting_visibility=false ค่าจะเป็น Noop หรือไม่เช่นนั้น หากแฟล็กนี้เป็นเท็จ config_setting ใดๆ ที่ไม่มีแอตทริบิวต์การเปิดเผยอย่างชัดแจ้งจะเป็น //visibility:public หากแฟล็กนี้เป็นจริง config_setting จะใช้ตรรกะระดับการเข้าถึงเดียวกันกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_enforce_config_setting_visibility
: "true" -
หากเป็น "จริง" ให้บังคับใช้การจำกัดระดับการเข้าถึง config_setting หากเป็น "เท็จ" ทุก config_setting จะปรากฏแก่เป้าหมายทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_use_plus_in_repo_names
: "true" -
ไม่มีการดำเนินการ
แท็ก:loading_and_analysis
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของคำสั่งย่อย "mod":
- ค่าเริ่มต้น
--base_module=<"<root>" for the root module; <module>@<version> for a specific version of a module; <module> for all versions of a module; @<name> for a repo with the given apparent name; or @@<name> for a repo with the given canonical name>
: "<root>" -
ระบุโมดูลที่สัมพันธ์กับที่เก็บเป้าหมายที่ระบุซึ่งจะมีการตีความ
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--charset=<utf8 or ascii>
: "utf8" -
เลือกการเข้ารหัสข้อความที่จะใช้กับโครงสร้าง มีผลกับเอาต์พุตข้อความเท่านั้น ค่าที่ถูกต้องคือ "utf8" หรือ "ASCII" ค่าเริ่มต้นคือ "utf8"
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]cycles
: "เท็จ" -
ชี้ให้เห็นรอบการขึ้นต่อกันภายในแผนผังที่แสดง ซึ่งปกติจะละเว้นโดยค่าเริ่มต้น
แท็ก:terminal_output
- ค่าเริ่มต้น
--depth=<an integer>
: "-1" -
ความลึกในการแสดงผลสูงสุดของแผนผังทรัพยากร Dependency เช่น ความลึกที่ 1 จะแสดงทรัพยากร Dependency โดยตรง สำหรับต้นไม้ เส้นทาง และ all_paths จะใช้ค่าเริ่มต้นเป็นจำนวนเต็มMAX_VALUE ส่วนสำหรับ deps และอธิบายค่าเริ่มต้นจะเป็น 1 (แสดงเฉพาะส่วนโดยตรงของรากนอกเหนือจากใบเป้าหมายและระดับบนสุด)
แท็ก:terminal_output
- ค่าเริ่มต้น
--extension_filter=<a comma-separated list of <extension>s>
: ดูคำอธิบาย -
แสดงเฉพาะการใช้งานส่วนขยายโมดูลเหล่านี้และ Repos ที่สร้างขึ้นโดยส่วนขยายเหล่านี้หากมีการตั้งค่า Flag ที่เกี่ยวข้องไว้ หากตั้งค่าไว้ กราฟผลลัพธ์จะรวมเฉพาะเส้นทางที่มีโมดูลที่ใช้ส่วนขยายที่ระบุ รายการที่ว่างเปล่าจะเป็นการปิดใช้ตัวกรอง โดยระบุส่วนขยายทั้งหมดที่เป็นไปได้อย่างมีประสิทธิภาพ
แท็ก:terminal_output
- ค่าเริ่มต้น
--extension_info=<hidden, usages, repos or all>
: "ซ่อนอยู่" -
ระบุรายละเอียดเกี่ยวกับการใช้งานส่วนขยายที่จะรวมไว้ในผลการค้นหา "การใช้งาน" จะแสดงเฉพาะชื่อส่วนขยาย "repos" จะรวมที่เก็บที่นำเข้าพร้อม use_repo และ "all" ไว้ด้วย จะแสดงที่เก็บอื่นๆ ที่ส่วนขยายสร้างขึ้นด้วย
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--extension_usages=<a comma-separated list of <module>s>
: "" -
ระบุโมดูลที่การใช้งานส่วนขยายจะแสดงในการค้นหา show_extension
แท็ก:terminal_output
- ค่าเริ่มต้น
--from=<a comma-separated list of <module>s>
: "<root>" -
โมดูลที่เริ่มต้นจากการค้นหากราฟการอ้างอิงจะปรากฏขึ้น ตรวจสอบคำอธิบายการค้นหาแต่ละรายการเพื่อดูความหมายที่ตรงกันทั้งหมด ค่าเริ่มต้นคือ <root>
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]include_builtin
: "เท็จ" -
รวมโมดูลในตัวไว้ในกราฟทรัพยากร Dependency ปิดใช้งานโดยค่าเริ่มต้นเนื่องจากมีเสียงดัง
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]include_unused
: "เท็จ" -
การค้นหาจะคำนึงถึงและแสดงโมดูลที่ไม่ได้ใช้ด้วย ซึ่งไม่ได้แสดงในกราฟความละเอียดของโมดูลหลังจากที่เลือก (เนื่องจากกฎการเลือกเวอร์ชันขั้นต่ำหรือการลบล้าง) ซึ่งจะมีผลที่แตกต่างกันสําหรับการค้นหาแต่ละประเภท เช่น การรวมเส้นทางใหม่ในคําสั่ง all_paths หรือการอ้างอิงเพิ่มเติมในคําสั่งอธิบาย
แท็ก:terminal_output
- ค่าเริ่มต้น
--output=<text, json or graph>
: "ข้อความ" -
รูปแบบที่ควรพิมพ์ผลการค้นหา ค่าที่อนุญาตสำหรับการค้นหาได้แก่ text, json, กราฟ
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]verbose
: "เท็จ" -
คำค้นหาจะแสดงเหตุผลว่าทำไมโมดูลจึงได้รับการแก้ไขเป็นเวอร์ชันปัจจุบัน (หากมีการเปลี่ยนแปลง) ค่าเริ่มต้นเป็น true สำหรับการค้นหาอธิบายเท่านั้น
แท็ก:terminal_output
- ตัวเลือกเบ็ดเตล็ด ที่จัดหมวดหมู่ไว้ไม่ได้:
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--deleted_packages=<comma-separated list of package names>
รายการ - รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริงแม้ว่าจะปรากฏอยู่ที่ใดที่หนึ่งบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ เช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์ ระบบบิลด์อาจบ่นหากพบป้ายกำกับ "//x:y/z" ถ้ามีข้อมูลระบุโดยรายการpackage_path อื่นอยู่ การระบุ --deleted_packages x/y ช่วยป้องกันปัญหานี้
- ค่าเริ่มต้น
--[no]fetch
: "true" - อนุญาตให้คำสั่งดึงข้อมูลทรัพยากร Dependency ภายนอก หากตั้งค่าเป็น "เท็จ" คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ และหากไม่มี คำสั่งดังกล่าวจะทำให้การทำงานล้มเหลว
- ค่าเริ่มต้นของ
--package_path=<colon-separated list of options>
: "%workspace%" - รายการตำแหน่งที่จะค้นหาแพ็กเกจที่คั่นด้วยโคลอน องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับพื้นที่ทำงานที่ล้อมรอบอยู่ หากไม่ระบุหรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
- ค่าเริ่มต้น
--[no]show_loading_progress
: "true" - หากเปิดใช้ จะทำให้ Bazel พิมพ์ "กำลังโหลดแพ็กเกจ:" ข้อความ
ตัวเลือกการพิมพ์
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_use_plus_in_repo_names
: "true" -
ไม่มีการดำเนินการ
แท็ก:loading_and_analysis
- ตัวเลือกเบ็ดเตล็ด ที่จัดหมวดหมู่ไว้ไม่ได้:
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--print_action_mnemonics=<a string>
รายการ - แสดงรายการความทรงจำที่ใช้กรองข้อมูล type_action โดยไม่มีการกรองเมื่อปล่อยว่างไว้
ตัวเลือกการค้นหา
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์:
--[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
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_config_setting_private_default_visibility
: "เท็จ" -
หากไม่รองรับ _enforce_config_setting_visibility=false ค่าจะเป็น Noop หรือไม่เช่นนั้น หากแฟล็กนี้เป็นเท็จ config_setting ใดๆ ที่ไม่มีแอตทริบิวต์การเปิดเผยอย่างชัดแจ้งจะเป็น //visibility:public หากแฟล็กนี้เป็นจริง config_setting จะใช้ตรรกะระดับการเข้าถึงเดียวกันกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_enforce_config_setting_visibility
: "true" -
หากเป็น "จริง" ให้บังคับใช้การจำกัดระดับการเข้าถึง config_setting หากเป็น "เท็จ" ทุก config_setting จะปรากฏแก่เป้าหมายทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_use_plus_in_repo_names
: "true" -
ไม่มีการดำเนินการ
แท็ก:loading_and_analysis
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตการค้นหาและความหมาย
- ค่าเริ่มต้น
--aspect_deps=<off, conservative or precise>
: "เชิงรับ" -
วิธีแก้ไขทรัพยากร Dependency ของลักษณะเมื่อรูปแบบเอาต์พุตเป็นหนึ่งใน {xml,protocol,record} "off" หมายความว่าจะไม่มีการแก้ไขทรัพยากร Dependency ในด้านต่างๆ "เชิงรับ" (ค่าเริ่มต้น) หมายความว่าจะมีการเพิ่มทรัพยากร Dependency ที่ประกาศทั้งหมด ไม่ว่าทรัพยากรเหล่านั้นจะได้รับคลาสของกฎการขึ้นต่อกันโดยตรงหรือไม่ ซึ่งก็คือ "แม่นยำ" หมายความว่าจะมีการเพิ่มเฉพาะด้านที่อาจทำงานอยู่ตามคลาสกฎของทรัพยากร Dependency โดยตรง โปรดทราบว่าโหมดแม่นยำต้องมีการโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียว ซึ่งจะทำให้ช้ากว่าโหมดอื่นๆ และโปรดทราบด้วยว่า โหมดแม้กระทั่งที่แม่นยำก็ไม่ได้แม่นยำทั้งหมด การตัดสินใจว่าจะคำนวณด้านใดด้านหนึ่งหรือไม่จะทำในขั้นตอนการวิเคราะห์ ซึ่งจะไม่ทำงานระหว่าง "การค้นหาแบบงัดแงะ"
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]consistent_labels
: "เท็จ" -
หากเปิดใช้งาน ทุกคำสั่งการค้นหาจะแสดงป้ายกำกับประหนึ่งว่าด้วย Starlark <code>str</code> ที่ใช้กับ<code>ป้ายกำกับ</code> อินสแตนซ์ ซึ่งมีประโยชน์สำหรับเครื่องมือที่จำเป็นต้องจับคู่เอาต์พุตของคำสั่งการค้นหาและ/หรือป้ายกำกับต่างๆ ที่กฎเรียกใช้ หากไม่เปิดใช้ ตัวจัดรูปแบบเอาต์พุตจะแสดงชื่อที่เก็บที่ชัดเจน (สัมพันธ์กับที่เก็บหลัก) แทนเพื่อทำให้เอาต์พุตอ่านได้ง่ายขึ้น
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]experimental_explicit_aspects
: "เท็จ" -
aquery, cquery: จะรวมการทำงานที่สร้างโดยมุมมองไว้ในเอาต์พุตหรือไม่ คำค้นหา: ไม่มีการดำเนินการ (ติดตามเสมอ)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]experimental_graphless_query
: "อัตโนมัติ" -
หากเป็นจริง ให้ใช้การใช้งาน Query ที่ไม่ได้ทำสำเนากราฟ การใช้งานใหม่รองรับเฉพาะ --order_output=no รวมถึงชุดย่อยของตัวจัดรูปแบบเอาต์พุต
แท็ก:build_file_semantics
eagerness_to_exit
- ค่าเริ่มต้น
--graph:conditional_edges_limit=<an integer>
: "4" -
จำนวนสูงสุดของป้ายกำกับเงื่อนไขที่จะแสดง -1 หมายถึงไม่มีการตัดข้อความ และ 0 หมายถึงไม่มีคำอธิบายประกอบ ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]graph:factored
: "true" -
หากเป็น "จริง" กราฟจะแสดงผลแบบ "แยกตัวประกอบ" นั่นคือ โหนดที่เท่าเทียมกันทางโทโพโลจีจะผสานเข้าด้วยกันและป้ายกำกับของโหนดทั้งสองเชื่อมติดกัน ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้น
--graph:node_limit=<an integer>
: "512" -
ความยาวสูงสุดของสตริงป้ายกำกับสำหรับโหนดกราฟในเอาต์พุต ป้ายกำกับที่ยาวขึ้นจะถูกตัด -1 หมายถึงไม่มีการตัดข้อความ ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]implicit_deps
: "true" -
หากเปิดใช้ การขึ้นต่อกันโดยปริยายจะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ทรัพยากร Dependency โดยนัยคือทรัพยากรที่ไม่มีการระบุอย่างชัดแจ้งในไฟล์ BUILD แต่เพิ่มโดย Bazel สำหรับ cquery ตัวเลือกนี้จะควบคุมการกรอง Toolchain ที่มีการแก้ปัญหาแล้ว
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]include_aspects
: "true" -
aquery, cquery: จะรวมการทำงานที่สร้างโดยมุมมองไว้ในเอาต์พุตหรือไม่ คำค้นหา: ไม่มีการดำเนินการ (ติดตามเสมอ)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]incompatible_lexicographical_output
: "true" -
หากตั้งค่าตัวเลือกนี้ไว้ ให้จัดเรียง --order_output=autoปลาย ตามลำดับแบบพจนานุกรม
แท็ก:terminal_output
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_package_group_includes_double_slash
: "true" -
หากเปิดใช้ เมื่อแสดงแอตทริบิวต์ "packages" ของpackage_group จะไม่ละเว้น "//" ที่นำหน้า
แท็ก:terminal_output
incompatible_change
- ค่าเริ่มต้น
--[no]infer_universe_scope
: "เท็จ" -
หากตั้งค่า และ --universe_scope ไม่ได้ตั้งค่าไว้ ระบบจะอนุมานค่าของ --universe_scope เป็นรายการรูปแบบเป้าหมายที่ไม่ซ้ำกันในนิพจน์การค้นหา โปรดทราบว่าค่า --universe_scope ที่อนุมานสำหรับนิพจน์การค้นหาที่ใช้ฟังก์ชันที่กําหนดขอบเขตระดับจักรวาล (เช่น "allrdeps") อาจไม่ใช่สิ่งที่คุณต้องการ คุณจึงควรใช้ตัวเลือกนี้ก็ต่อเมื่อคุณทราบว่าคุณกำลังทำอะไรอยู่เท่านั้น ดูรายละเอียดและตัวอย่างได้ที่ https://bazel.build/reference/query#sky-query หากตั้งค่า --universe_scope ค่า ระบบจะไม่สนใจค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้ใช้ได้เฉพาะกับ "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
--noorder_results
-
แสดงผลลัพธ์เป็นลำดับการขึ้นต่อกัน (ค่าเริ่มต้น) หรือไม่เรียงลำดับ ผลลัพธ์ที่ไม่เรียงลำดับจะเร็วขึ้น แต่จะได้รับการสนับสนุนเมื่อ --output ไม่ใช่ minrank, maxrank หรือกราฟ
ขยายเป็น
--order_output=no
แท็ก:terminal_output
--null
-
เลือกว่าจะสิ้นสุดแต่ละรูปแบบด้วย \0 แทนการขึ้นบรรทัดใหม่หรือไม่
ขยายเป็น
--line_terminator_null=true
แท็ก:terminal_output
- ค่าเริ่มต้น
--order_output=<no, deps, auto or full>
: "อัตโนมัติ" -
แสดงผลลัพธ์โดยไม่เรียงลำดับ (ไม่) เรียงลำดับการอ้างอิง (deps) หรือเรียงลำดับแบบเต็ม (เต็ม) ค่าเริ่มต้นคือ "อัตโนมัติ" ซึ่งหมายความว่าผลลัพธ์จะเป็นผลลัพธ์ตามลำดับการขึ้นต่อกันหรือเรียงลำดับทั้งหมด ขึ้นอยู่กับตัวจัดรูปแบบเอาต์พุต (เรียงลำดับการขึ้นต่อกันสำหรับ Proโต, minrank, maxrank และกราฟ จะเรียงลำดับตามแหล่งอื่นๆ ทั้งหมด) เมื่อเรียงลำดับเอาต์พุตอย่างสมบูรณ์แล้ว โหนดจะพิมพ์ตามลำดับเชิงกำหนดโดยสมบูรณ์ (ทั้งหมด) ขั้นแรก โหนดทั้งหมดจัดเรียงตามตัวอักษร จากนั้นแต่ละโหนดในรายการจะใช้เป็นจุดเริ่มต้นของการค้นหาแรกหลังลำดับความลึก ซึ่งจะข้ามผ่านขอบขาออกไปยังโหนดที่ยังไม่ได้เข้าชม จะข้ามผ่านตามลำดับตัวอักษรของโหนดที่สืบทอดมา สุดท้าย โหนดจะถูกพิมพ์กลับกันของลำดับที่เข้าชม
แท็ก:terminal_output
--order_results
-
แสดงผลลัพธ์เป็นลำดับการขึ้นต่อกัน (ค่าเริ่มต้น) หรือไม่เรียงลำดับ ผลลัพธ์ที่ไม่เรียงลำดับจะเร็วขึ้น แต่จะได้รับการสนับสนุนเมื่อ --output ไม่ใช่ minrank, maxrank หรือกราฟ
ขยายเป็น
--order_output=auto
แท็ก:terminal_output
- ค่าเริ่มต้น
--output=<a string>
: "ป้ายกำกับ" -
รูปแบบที่ควรพิมพ์ผลการค้นหา ค่าที่อนุญาตสำหรับข้อความค้นหา ได้แก่ create, graph, streamed_jsonprotocol, label, label_kind, location, maxrank, minrank, package, protocol, streamed_protocol, xml
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:default_values
: "true" -
หากเป็น "จริง" ระบบจะรวมแอตทริบิวต์ที่ไม่ได้ระบุไว้อย่างชัดเจนในไฟล์ BUILD มิฉะนั้นจะถูกละเว้น ตัวเลือกนี้ใช้ได้กับ --output=prof
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:definition_stack
: "เท็จ" -
ป้อนข้อมูลในช่อง Proto ของ Definition_stack ซึ่งบันทึกสำหรับสแต็กการเรียกใช้ Starlark สำหรับแต่ละอินสแตนซ์ของกฎ ณ เวลาที่มีการกำหนดคลาสของกฎ
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:flatten_selects
: "true" -
หากเปิดใช้ ระบบจะแยกแอตทริบิวต์ที่กำหนดค่าได้ซึ่งสร้างโดย select() ไว้ในรูปแบบ สำหรับประเภทรายการ การแสดงแบบ "แยกเป็นหลายรายการ" คือรายการซึ่งประกอบด้วยแต่ละค่าของแผนที่ที่เลือกเพียงครั้งเดียว ระบบจะแยกประเภทสเกลาร์เป็นค่าว่าง
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]proto:include_attribute_source_aspects
: "เท็จ" -
ป้อนข้อมูลในช่อง Proto ของ source_aspect_name ของแต่ละแอตทริบิวต์ด้วยลักษณะต้นทางของแอตทริบิวต์นั้น (สตริงว่างเปล่าหากไม่มีข้อมูล)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:include_synthetic_attribute_hash
: "เท็จ" -
คำนวณและเติมข้อมูลแอตทริบิวต์ $internal_attr_hash หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:instantiation_stack
: "เท็จ" -
ป้อนข้อมูลสแต็กการเรียกใช้การสร้างอินสแตนซ์ของแต่ละกฎ โปรดทราบว่าการดำเนินการนี้ต้องมีสแต็กอยู่
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:locations
: "true" -
ระบุว่าจะแสดงข้อมูลตำแหน่งในเอาต์พุต Pro เลยหรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้น
--proto:output_rule_attrs=<comma-separated list of options>
: "ทั้งหมด" -
รายการแอตทริบิวต์ที่คั่นด้วยจุลภาคที่จะรวมในเอาต์พุต ค่าเริ่มต้นคือแอตทริบิวต์ทั้งหมด ตั้งค่าเป็นสตริงว่างเปล่าเพื่อไม่ให้แสดงแอตทริบิวต์ใดๆ ตัวเลือกนี้ใช้ได้กับ --output=protocol
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:rule_inputs_and_outputs
: "true" -
เติมข้อมูลในช่อง rules_input และ rules_output หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--query_file=<a string>
: "" -
หากมีการตั้งค่าไว้ การค้นหาจะอ่านการค้นหาจากไฟล์ที่มีชื่อที่นี่ แทนที่จะเป็นบรรทัดคำสั่ง การระบุไฟล์ที่นี่และคำค้นหาบรรทัดคำสั่งเป็นข้อผิดพลาด
แท็ก:changes_inputs
- ค่าเริ่มต้น
--[no]relative_locations
: "เท็จ" -
หากเป็นจริง ตำแหน่งของไฟล์ BUILD ใน XML และเอาต์พุต Pro จะสัมพันธ์กัน โดยค่าเริ่มต้น เอาต์พุตตำแหน่งจะเป็นเส้นทางสัมบูรณ์และจะไม่สอดคล้องกันในแต่ละเครื่อง คุณสามารถตั้งค่าตัวเลือกนี้เป็น "จริง" เพื่อให้ได้ผลลัพธ์ที่สอดคล้องกันในอุปกรณ์ทุกเครื่อง
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]strict_test_suite
: "เท็จ" -
หากเป็น "จริง" นิพจน์ testing() จะแจ้งข้อผิดพลาดหากพบ test_suite ที่มีเป้าหมายที่ไม่ใช่การทดสอบ
แท็ก:build_file_semantics
eagerness_to_exit
- ค่าเริ่มต้น
--[no]tool_deps
: "true" -
การค้นหา: หากปิดใช้ ทรัพยากร Dependency ใน "การกำหนดค่า exec" จะไม่รวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน "การกำหนดค่าการดำเนินการ" เอดจ์ของทรัพยากร Dependency เช่น ขีดจำกัดจาก "proto_library" ให้กับโปรโตคอลคอมไพเลอร์ ซึ่งโดยทั่วไปจะชี้ไปยังเครื่องมือที่ดำเนินการระหว่างการสร้างแทนที่จะเป็นส่วนของ "เป้าหมาย" เดียวกัน ของโปรแกรม
Cquery: หากปิดใช้ จะกรองเป้าหมายที่กำหนดค่าไว้ทั้งหมดซึ่งข้ามการเปลี่ยนการดำเนินการจากเป้าหมายระดับบนสุดที่ค้นพบเป้าหมายที่กำหนดค่าไว้นี้ออก ซึ่งหมายความว่าหากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าเป้าหมาย ระบบจะแสดงผลเฉพาะเป้าหมายที่กำหนดค่าไว้ในการกำหนดค่าเป้าหมายด้วย ถ้าเป้าหมายระดับบนสุดอยู่ในการกำหนดค่า exec ระบบจะแสดงผลเฉพาะเป้าหมายที่กำหนดค่าของ exec เท่านั้น ตัวเลือกนี้จะ "ไม่" ยกเว้น Toolchain ที่แก้ไขแล้ว
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--universe_scope=<comma-separated list of options>
: "" -
ชุดรูปแบบเป้าหมายที่คั่นด้วยคอมมา (บวกและลบ) การค้นหาอาจดำเนินการในจักรวาลที่กำหนดโดยการปิดแบบสับเปลี่ยนของเป้าหมายที่ระบุ ตัวเลือกนี้ใช้สําหรับคำสั่งการค้นหาและคำสั่ง cquery
สำหรับ cquery อินพุตของตัวเลือกนี้จะเป็นเป้าหมายในการสร้างคำตอบทั้งหมด ดังนั้นตัวเลือกนี้อาจส่งผลต่อการกําหนดค่าและการเปลี่ยน หากไม่ได้ระบุตัวเลือกนี้ ระบบจะถือว่าเป้าหมายระดับบนสุดเป็นเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหา หมายเหตุ: สำหรับ cquery การไม่ระบุตัวเลือกนี้อาจทำให้บิลด์ไม่ทำงานหากเป้าหมายที่แยกวิเคราะห์จากนิพจน์คำค้นหาไม่สามารถสร้างได้ด้วยตัวเลือกระดับบนสุด
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]xml:default_values
: "เท็จ" -
หากเป็น "จริง" ระบบจะพิมพ์แอตทริบิวต์กฎที่ไม่ได้ระบุค่าไว้อย่างชัดแจ้งในไฟล์ BUILD มิฉะนั้นจะถูกละเว้น
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]xml:line_numbers
: "true" -
หากเป็น "จริง" เอาต์พุต XML จะมีหมายเลขบรรทัด การปิดใช้ตัวเลือกนี้อาจทำให้อ่านความแตกต่างได้ง่ายขึ้น ตัวเลือกนี้ใช้ได้กับ --output=xml เท่านั้น
แท็ก:terminal_output
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
- ค่าเริ่มต้นของ
--experimental_repository_resolved_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้เขียนค่า Starlark พร้อมข้อมูลที่แก้ไขแล้วของกฎที่เก็บ Starlark ทั้งหมดที่ดำเนินการ
แท็ก:affects_outputs
- ตัวเลือกเบ็ดเตล็ด ที่จัดหมวดหมู่ไว้ไม่ได้:
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--deleted_packages=<comma-separated list of package names>
รายการ - รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริงแม้ว่าจะปรากฏอยู่ที่ใดที่หนึ่งบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ เช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์ ระบบบิลด์อาจบ่นหากพบป้ายกำกับ "//x:y/z" ถ้ามีข้อมูลระบุโดยรายการpackage_path อื่นอยู่ การระบุ --deleted_packages x/y ช่วยป้องกันปัญหานี้
- ค่าเริ่มต้น
--[no]fetch
: "true" - อนุญาตให้คำสั่งดึงข้อมูลทรัพยากร Dependency ภายนอก หากตั้งค่าเป็น "เท็จ" คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ และหากไม่มี คำสั่งดังกล่าวจะทำให้การทำงานล้มเหลว
- ค่าเริ่มต้นของ
--package_path=<colon-separated list of options>
: "%workspace%" - รายการตำแหน่งที่จะค้นหาแพ็กเกจที่คั่นด้วยโคลอน องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับพื้นที่ทำงานที่ล้อมรอบอยู่ หากไม่ระบุหรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
- ค่าเริ่มต้น
--[no]show_loading_progress
: "true" - หากเปิดใช้ จะทำให้ Bazel พิมพ์ "กำลังโหลดแพ็กเกจ:" ข้อความ
ตัวเลือกการเรียกใช้
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
- ค่าเริ่มต้น
--[no]portable_paths
: "เท็จ" -
หากเป็นจริง จะรวมเส้นทางที่จะแทนที่ใน ExecRequest เพื่อให้เส้นทางที่เป็นผลลัพธ์สามารถย้ายได้
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]run
: "true" -
หากเป็น "เท็จ" ให้ข้ามการเรียกใช้บรรทัดคำสั่งที่สร้างขึ้นสำหรับเป้าหมายที่สร้างขึ้น โปรดทราบว่าแฟล็กนี้จะไม่มีผลสำหรับบิลด์ --script_path ทั้งหมด
แท็ก:affects_outputs
- ตัวเลือกที่ให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการได้ โดยให้ส่งผลต่อค่าของเอาต์พุตแทนค่าที่มีอยู่
- ค่าเริ่มต้น
--script_path=<a path>
: ดูคำอธิบาย -
หากตั้งค่าไว้ ให้เขียนสคริปต์เชลล์ไปยังไฟล์ที่ต้องการเรียกใช้เป้าหมาย หากตั้งค่านโยบายนี้ เป้าหมายจะไม่เรียกใช้จาก Bazel ใช้ 'bazel run --script_path=foo //foo && ./foo' เพื่อเรียกเป้าหมาย "//foo" ซึ่งแตกต่างจาก "bazel Run //foo" เมื่อมีการปล่อยล็อก Bazel และไฟล์ปฏิบัติการเชื่อมต่อกับ Stin ของเทอร์มินัล
แท็ก:affects_outputs
execution
- ภาษา Starlark หรือ API บิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_use_plus_in_repo_names
: "true" -
ไม่มีการดำเนินการ
แท็ก:loading_and_analysis
ตัวเลือกการปิดเครื่อง
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่งมีดังนี้
- ค่าเริ่มต้น
--iff_heap_size_greater_than=<an integer>
: "0" -
หากไม่ใช่ 0 การปิดเซิร์ฟเวอร์จะปิดก็ต่อเมื่อหน่วยความจำรวม (เป็น MB) ที่ JVM ใช้เกินค่านี้
แท็ก:loses_incremental_state
eagerness_to_exit
- ภาษา Starlark หรือ API บิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_use_plus_in_repo_names
: "true" -
ไม่มีการดำเนินการ
แท็ก:loading_and_analysis
ตัวเลือกการซิงค์
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์:
- ค่าเริ่มต้นของ
--[no]configure
: "เท็จ" -
เฉพาะที่เก็บการซิงค์ที่ทำเครื่องหมายว่า "กำหนดค่า" ในการกำหนดค่าระบบ
แท็ก:changes_inputs
--[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
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--only=<a string>
รายการ -
หากมีตัวเลือกนี้ ให้ซิงค์เฉพาะที่เก็บที่ระบุด้วยตัวเลือกนี้ แต่ยังถือว่าทั้งหมด (หรือทั้งหมดที่เหมือนกับการกำหนดค่า ของ --กำหนดค่า) ล้าสมัย
แท็ก:changes_inputs
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_config_setting_private_default_visibility
: "เท็จ" -
หากไม่รองรับ _enforce_config_setting_visibility=false ค่าจะเป็น Noop หรือไม่เช่นนั้น หากแฟล็กนี้เป็นเท็จ config_setting ใดๆ ที่ไม่มีแอตทริบิวต์การเปิดเผยอย่างชัดแจ้งจะเป็น //visibility:public หากแฟล็กนี้เป็นจริง config_setting จะใช้ตรรกะระดับการเข้าถึงเดียวกันกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_enforce_config_setting_visibility
: "true" -
หากเป็น "จริง" ให้บังคับใช้การจำกัดระดับการเข้าถึง config_setting หากเป็น "เท็จ" ทุก config_setting จะปรากฏแก่เป้าหมายทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_use_plus_in_repo_names
: "true" -
ไม่มีการดำเนินการ
แท็ก:loading_and_analysis
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
- ค่าเริ่มต้นของ
--experimental_repository_resolved_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้เขียนค่า Starlark พร้อมข้อมูลที่แก้ไขแล้วของกฎที่เก็บ Starlark ทั้งหมดที่ดำเนินการ
แท็ก:affects_outputs
- ตัวเลือกเบ็ดเตล็ด ที่จัดหมวดหมู่ไว้ไม่ได้:
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--deleted_packages=<comma-separated list of package names>
รายการ - รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริงแม้ว่าจะปรากฏอยู่ที่ใดที่หนึ่งบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ เช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์ ระบบบิลด์อาจบ่นหากพบป้ายกำกับ "//x:y/z" ถ้ามีข้อมูลระบุโดยรายการpackage_path อื่นอยู่ การระบุ --deleted_packages x/y ช่วยป้องกันปัญหานี้
- ค่าเริ่มต้น
--[no]fetch
: "true" - อนุญาตให้คำสั่งดึงข้อมูลทรัพยากร Dependency ภายนอก หากตั้งค่าเป็น "เท็จ" คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ และหากไม่มี คำสั่งดังกล่าวจะทำให้การทำงานล้มเหลว
- ค่าเริ่มต้นของ
--package_path=<colon-separated list of options>
: "%workspace%" - รายการตำแหน่งที่จะค้นหาแพ็กเกจที่คั่นด้วยโคลอน องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับพื้นที่ทำงานที่ล้อมรอบอยู่ หากไม่ระบุหรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
- ค่าเริ่มต้น
--[no]show_loading_progress
: "true" - หากเปิดใช้ จะทำให้ Bazel พิมพ์ "กำลังโหลดแพ็กเกจ:" ข้อความ
ตัวเลือกการทดสอบ
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_use_plus_in_repo_names
: "true" -
ไม่มีการดำเนินการ
แท็ก:loading_and_analysis
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
- ค่าเริ่มต้น
--[no]print_relative_test_log_paths
: "เท็จ" -
หากเป็นจริง เมื่อพิมพ์เส้นทางไปยังบันทึกทดสอบ ให้ใช้เส้นทางสัมพัทธ์ที่ใช้ "testlogs" ลิงก์สัญลักษณ์ความสะดวก หมายเหตุ - การเรียกใช้ 'build'/'test'/ฯลฯ ที่มีการกำหนดค่าเป็นอย่างอื่นอาจทำให้เป้าหมายของลิงก์สัญลักษณ์นี้เปลี่ยนไป ทำให้เส้นทางที่พิมพ์ก่อนหน้านี้ไม่มีประโยชน์อีกต่อไป
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]test_verbose_timeout_warnings
: "เท็จ" -
หากเป็น "จริง" ให้พิมพ์คำเตือนเพิ่มเติมเมื่อเวลาดำเนินการทดสอบจริงไม่ตรงกับระยะหมดเวลาที่กำหนดโดยการทดสอบ (ไม่ว่าจะโดยนัยหรืออย่างโจ่งแจ้ง)
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]verbose_test_summary
: "true" -
หากเป็น "จริง" ให้พิมพ์ข้อมูลเพิ่มเติม (ระยะเวลา จำนวนการเรียกใช้ที่ล้มเหลว ฯลฯ) ในสรุปการทดสอบ
แท็ก:affects_outputs
ตัวเลือกของผู้ให้บริการ
รับค่าตัวเลือกทั้งหมดจาก test
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์:
--[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
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_config_setting_private_default_visibility
: "เท็จ" -
หากไม่รองรับ _enforce_config_setting_visibility=false ค่าจะเป็น Noop หรือไม่เช่นนั้น หากแฟล็กนี้เป็นเท็จ config_setting ใดๆ ที่ไม่มีแอตทริบิวต์การเปิดเผยอย่างชัดแจ้งจะเป็น //visibility:public หากแฟล็กนี้เป็นจริง config_setting จะใช้ตรรกะระดับการเข้าถึงเดียวกันกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_enforce_config_setting_visibility
: "true" -
หากเป็น "จริง" ให้บังคับใช้การจำกัดระดับการเข้าถึง config_setting หากเป็น "เท็จ" ทุก config_setting จะปรากฏแก่เป้าหมายทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_use_plus_in_repo_names
: "true" -
ไม่มีการดำเนินการ
แท็ก:loading_and_analysis
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--repo=<a string>
รายการ -
เฉพาะผู้ให้บริการในที่เก็บที่ระบุเท่านั้น ซึ่งอาจเป็น "@apparent_repo_name" หรือ "@@canonical_repo_name" ตัวเลือกนี้ตั้งค่าได้หลายครั้ง
แท็ก:changes_inputs
- ตัวเลือกเบ็ดเตล็ด ที่จัดหมวดหมู่ไว้ไม่ได้:
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--deleted_packages=<comma-separated list of package names>
รายการ - รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริงแม้ว่าจะปรากฏอยู่ที่ใดที่หนึ่งบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ เช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์ ระบบบิลด์อาจบ่นหากพบป้ายกำกับ "//x:y/z" ถ้ามีข้อมูลระบุโดยรายการpackage_path อื่นอยู่ การระบุ --deleted_packages x/y ช่วยป้องกันปัญหานี้
- ค่าเริ่มต้น
--[no]fetch
: "true" - อนุญาตให้คำสั่งดึงข้อมูลทรัพยากร Dependency ภายนอก หากตั้งค่าเป็น "เท็จ" คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ และหากไม่มี คำสั่งดังกล่าวจะทำให้การทำงานล้มเหลว
- ค่าเริ่มต้นของ
--package_path=<colon-separated list of options>
: "%workspace%" - รายการตำแหน่งที่จะค้นหาแพ็กเกจที่คั่นด้วยโคลอน องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับพื้นที่ทำงานที่ล้อมรอบอยู่ หากไม่ระบุหรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
- ค่าเริ่มต้น
--[no]show_loading_progress
: "true" - หากเปิดใช้ จะทำให้ Bazel พิมพ์ "กำลังโหลดแพ็กเกจ:" ข้อความ
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์:
- ค่าเริ่มต้น
--[no]experimental_inprocess_symlink_creation
: "เท็จ" -
เลือกว่าจะเรียกใช้ระบบไฟล์โดยตรงเพื่อสร้างต้นไม้ Symlink หรือไม่
แท็ก:loading_and_analysis
,execution
,experimental
- ค่าเริ่มต้น
--[no]experimental_persistent_aar_extractor
: "เท็จ" -
เปิดใช้เครื่องมือแยก Aar แบบถาวรโดยใช้ผู้ปฏิบัติงาน
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_remotable_source_manifests
: "เท็จ" -
ต้องการให้การดำเนินการในไฟล์ Manifest ของแหล่งที่มาทำซ้ำได้หรือไม่
แท็ก:loading_and_analysis
,execution
,experimental
- ค่าเริ่มต้น
--[no]experimental_split_coverage_postprocessing
: "เท็จ" -
หากเป็น "จริง" Bazel จะดำเนินการประมวลผลภายหลังสำหรับการครอบคลุมในการทดลองที่สร้างขึ้นใหม่
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_strict_fileset_output
: "เท็จ" -
หากเปิดใช้ตัวเลือกนี้ ชุดไฟล์จะถือว่าอาร์ติแฟกต์เอาต์พุตทั้งหมดเป็นไฟล์ทั่วไป โดยจะไม่ข้ามผ่านไดเรกทอรีหรือไวต่อลิงก์สัญลักษณ์
แท็ก:execution
- ค่าเริ่มต้น
--[no]incompatible_modify_execution_info_additive
: "เท็จ" -
เมื่อเปิดใช้ การส่งแฟล็ก --modify_execution_info หลายรายการจะเป็นแบบบวกเพิ่ม เมื่อปิดใช้ ระบบจะพิจารณาเฉพาะธงล่าสุดเท่านั้น
แท็ก:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
รายการ -
เพิ่มหรือนำคีย์ออกจากข้อมูลการดำเนินการของการดำเนินการตามความสามารถในการจำการดำเนินการ ใช้กับการดำเนินการที่รองรับข้อมูลการดำเนินการเท่านั้น การดำเนินการทั่วไปจำนวนมากรองรับข้อมูลการดำเนินการ เช่น Genrule, CppCompile, Javac, StarlarkAction, TestRunner เมื่อระบุค่าหลายค่า ลำดับมีความสำคัญเนื่องจาก regexe หลายรายการอาจใช้กับช่วยจำเดียวกันได้
ไวยากรณ์: "regex=[+-]key,regex=[+-]key,..."
ตัวอย่าง:
'.*=+x,.*=-y,.*=+z' เพิ่ม "x" และ "z" ถึง และนำ "y" ออก ข้อมูลการดำเนินการสำหรับการดำเนินการทั้งหมด
'Genrule=+requires-x' เพิ่ม "requires-x" กับข้อมูลการดำเนินการสำหรับการดำเนินการ Genrule ทั้งหมด
'(?!Genrule).*=-requires-x' นำ "requires-x" ออก จากข้อมูลการดำเนินการสำหรับการดำเนินการ
ที่ไม่ใช่ Genrule ทั้งหมด
แท็ก:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
เปิดใช้การดำเนินการ Dex และ desugar ของ Android แบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
แท็ก:host_machine_resource_optimizations
execution
--persistent_android_resource_processor
-
เปิดใช้ผู้ประมวลผลข้อมูลทรัพยากร Android ถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
เปิดใช้การดำเนินการ Dex และ desugar ของ Android แบบมัลติเพล็กซ์โดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
เปิดใช้เครื่องมือประมวลผลทรัพยากร Android แบบมัลติเพล็กซ์แบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
เปิดใช้เครื่องมือ Android แบบต่อเนื่องและแบบมัลติเพล็กซ์ (Dexing, Deugaring, Resource Operations)
ขยายเป็น
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
แท็ก:host_machine_resource_optimizations
execution
- ค่าเริ่มต้น
--[no]use_target_platform_for_tests
: "เท็จ" -
หากเป็น "จริง" Bazel จะใช้แพลตฟอร์มเป้าหมายในการทำการทดสอบแทนกลุ่มผู้บริหารทดสอบ
แท็ก:execution
- ตัวเลือกที่กำหนดค่า Toolchain ที่ใช้สำหรับการดำเนินการมีดังนี้
- ค่าเริ่มต้น
--android_compiler=<a string>
: ดูคำอธิบาย -
คอมไพเลอร์เป้าหมายของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_manifest_merger=<legacy, android or force_android>
: "android" -
เลือกการควบรวมไฟล์ Manifest ที่จะใช้กับกฎ android_binary แจ้งเพื่อช่วยให้เปลี่ยนไปใช้การผสานรวมไฟล์ Manifest ของ Android จากการควบรวมเดิม
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_platforms=<a build target label>
: "" -
ตั้งค่าแพลตฟอร์มที่ android_binary กำหนดเป้าหมายใช้ หากระบุหลายแพลตฟอร์ม ไบนารีนั้นจะเป็น APK แบบอ้วน ซึ่งมีไบนารีแบบเนทีฟสำหรับแต่ละแพลตฟอร์มเป้าหมายที่ระบุ
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_sdk=<a build target label>
: "@bazel_tools//tools/android:sdk" -
ระบุ SDK/แพลตฟอร์ม Android ที่ใช้สร้างแอปพลิเคชัน Android
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้ในกฎของ Apple และ Objc และทรัพยากร Dependency
แท็ก:loses_incremental_state
changes_inputs
- ค่าเริ่มต้นของ
--cc_output_directory_tag=<a string>
: "" -
ระบุคำต่อท้ายที่จะเพิ่มในไดเรกทอรีการกำหนดค่า
แท็ก:affects_outputs
- ค่าเริ่มต้น
--compiler=<a string>
: ดูคำอธิบาย -
คอมไพเลอร์ C++ ที่จะใช้สำหรับการคอมไพล์เป้าหมาย
แท็ก:loading_and_analysis
execution
--coverage_output_generator=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:lcov_merger"-
ตำแหน่งของไบนารีที่ใช้เพื่อประมวลผลรายงานการครอบคลุมแบบข้อมูลดิบหลังการประมวลผล ซึ่งต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งก็คือไบนารี ค่าเริ่มต้นคือ "//tools/test:lcov_merger"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_report_generator"-
ตําแหน่งของไบนารีที่ใช้สร้างรายงานการครอบคลุม ซึ่งต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งก็คือไบนารี ค่าเริ่มต้นคือ "//tools/test:coverage_report_generator"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_support"-
ตำแหน่งของไฟล์สนับสนุนที่จำเป็นต้องใช้ในอินพุตของการดำเนินการทดสอบทั้งหมดที่รวบรวมการครอบคลุมของโค้ด ค่าเริ่มต้นคือ "//tools/test:coverage_support"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--custom_malloc=<a build target label>
: ดูคำอธิบาย -
ระบุการใช้งาน Malloc ที่กำหนดเอง การตั้งค่านี้จะลบล้างแอตทริบิวต์ Malloc ในกฎบิลด์
แท็ก:changes_inputs
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
รายการ -
รายการนิพจน์ทั่วไปที่คั่นด้วยคอมมา แต่ละรายการจะมีคำนำหน้าด้วย - (นิพจน์เชิงลบ) และกำหนด (=) ให้กับรายการเป้าหมายค่าข้อจำกัดที่คั่นด้วยคอมมา หากเป้าหมายตรงกับที่ไม่มีนิพจน์เชิงลบ และนิพจน์เชิงบวกอย่างน้อย 1 รายการ การแปลง Toolchain จะดำเนินการเสมือนว่าได้ประกาศค่าข้อจำกัดเป็นข้อจำกัดการดำเนินการ ตัวอย่าง: //demo,-test=@platforms//cpus:x86_64 จะเพิ่ม "x86_64" ไปยังเป้าหมายใดๆ ภายใต้ //demo ยกเว้นเป้าหมายที่ชื่อมี "test"
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_include_xcode_execution_requirements
: "เท็จ" -
เมื่อตั้งค่าแล้ว ให้เพิ่ม "requires-xcode:{version}" สำหรับการดำเนินการของ Xcode ทุกครั้ง หากเวอร์ชัน Xcode มีป้ายกำกับขีดกลาง ให้เพิ่ม "requires-xcode-label:{version_label}" ด้วย ข้อกำหนดของการดำเนินการ
แท็ก:loses_incremental_state
,loading_and_analysis
,execution
- ค่าเริ่มต้น
--[no]experimental_prefer_mutual_xcode
: "true" -
หากเป็นจริง ให้ใช้ Xcode ล่าสุดที่พร้อมใช้งานทั้งในเครื่องและจากระยะไกล หากเป็นเท็จหรือไม่มีเวอร์ชันที่ใช้ร่วมกัน ให้ใช้เวอร์ชันของ Xcode ในเครื่องที่เลือกผ่าน xcode-select
แท็ก:loses_incremental_state
- ค่าเริ่มต้นของ
--extra_execution_platforms=<comma-separated list of options>
: "" -
แพลตฟอร์มที่มีให้ใช้งานเป็นแพลตฟอร์มการดำเนินการเพื่อเรียกใช้การดำเนินการ สามารถระบุแพลตฟอร์มโดยเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมาย แพลตฟอร์มเหล่านี้จะได้รับการพิจารณาก่อนแพลตฟอร์มที่ประกาศในไฟล์ WORKSPACE โดยregister_execution_platforms() ตัวเลือกนี้ตั้งค่าได้เพียงครั้งเดียว อินสแตนซ์ภายหลังจะลบล้างการตั้งค่าแฟล็กก่อนหน้า
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--extra_toolchains=<comma-separated list of options>
รายการ -
กฎ Toolchain ที่จะต้องพิจารณาระหว่างการแก้ไข Toolchain สามารถระบุ Toolchains ตามเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมายได้ ระบบจะพิจารณา Toolchain เหล่านี้ก่อนการประกาศในไฟล์ WORKSPACE โดยregister_toolchains()
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--grte_top=<a label>
: ดูคำอธิบาย -
ป้ายกำกับไปยังไลบรารี libc ที่มีการเช็คอิน Crosstool Toolchain จะเลือกค่าเริ่มต้นและคุณแทบจะไม่จำเป็นต้องลบล้างค่าเริ่มต้น
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--host_compiler=<a string>
: ดูคำอธิบาย -
แฟล็กที่ไม่มีการดำเนินการ ระบบจะนำออกในรุ่นถัดไป
แท็ก:loading_and_analysis
execution
- ค่าเริ่มต้น
--host_grte_top=<a label>
: ดูคำอธิบาย -
ถ้าระบุ การตั้งค่านี้จะลบล้างไดเรกทอรีระดับบนสุดของ libc (--grte_top) สำหรับการกำหนดค่าผู้บริหาร
แท็ก:action_command_lines
affects_outputs
--host_platform=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools:host_platform"-
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายระบบโฮสต์
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--[no]incompatible_bazel_test_exec_run_under
: "เท็จ" -
หากเปิดใช้ "การทดสอบ bazel --run_under=//:runner" บิลด์ "//:runner" ในการกำหนดค่า exec หากปิดใช้ จะสร้าง "//:runner" ในการกำหนดค่าเป้าหมาย Bazel ทำการทดสอบบนเครื่องปฏิบัติการ ดังนั้นเครื่องแรกจึงถูกต้องกว่า ซึ่งไม่ส่งผลกับ "Bazel Run" ซึ่งจะสร้าง "`--run_under=//foo" เสมอ ในการกำหนดค่าเป้าหมาย
แท็ก:affects_outputs
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_apple_toolchain_resolution
: "เท็จ" -
ใช้ความละเอียดของ Toolchain เพื่อเลือก Apple SDK สำหรับกฎของ Apple (Starlark และเนทีฟ)
แท็ก: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_strip_executable_safely
: "เท็จ" -
หากเป็น "จริง" การดำเนินการตัดไฟล์สำหรับไฟล์ปฏิบัติการจะใช้แฟล็ก -x ซึ่งไม่ส่งผลกับความละเอียดของสัญลักษณ์แบบไดนามิก
แท็ก:action_command_lines
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
,immutable
- ค่าเริ่มต้นของ
--platforms=<a build target label>
: "" -
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายแพลตฟอร์มเป้าหมายสำหรับคำสั่งปัจจุบัน
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--python_path=<a string>
: ดูคำอธิบาย -
Absolute Path ของล่าม Python มีการเรียกใช้เป้าหมาย Python บนแพลตฟอร์มเป้าหมาย เลิกใช้งาน; ปิดใช้งานโดย --incompatible_use_python_toolchains
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้น
--python_top=<a build target label>
: ดูคำอธิบาย -
ป้ายกำกับของ py_runtime ที่แทนอินเทอร์พรีเตอร์ Python ได้มีการเรียกให้เรียกใช้เป้าหมาย Python บนแพลตฟอร์มเป้าหมาย เลิกใช้งาน; ปิดใช้งานโดย --incompatible_use_python_toolchains
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้น
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
ระบุเวอร์ชันของ tvOS SDK ที่จะใช้สร้างแอปพลิเคชัน tvOS หากไม่ระบุ ระบบจะใช้เวอร์ชันเริ่มต้นของ tvOS SDK จาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
ระบุเวอร์ชันของ WatchOS SDK ที่จะใช้สร้างแอปพลิเคชัน watchOS หากไม่ระบุ ระบบจะใช้เวอร์ชัน WatchOS SDK เริ่มต้นจาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--xcode_version=<a string>
: ดูคำอธิบาย -
หากระบุไว้ ให้ใช้ Xcode ของเวอร์ชันที่ระบุสำหรับการดำเนินการของบิลด์ที่เกี่ยวข้อง หากไม่ระบุ ระบบจะใช้ Xcode เวอร์ชันเริ่มต้นของผู้ดำเนินการ
แท็ก:loses_incremental_state
--xcode_version_config=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:host_xcodes"-
ป้ายกำกับของกฎ xcode_config ที่จะใช้สำหรับเลือกเวอร์ชัน Xcode ในการกำหนดค่าบิลด์
แท็ก:loses_incremental_state
loading_and_analysis
- มีดังนี้
- ค่าเริ่มต้น
--[no]apple_generate_dsym
: "เท็จ" -
เลือกว่าจะสร้างไฟล์สัญลักษณ์การแก้ไขข้อบกพร่อง (.dSYM) หรือไม่
แท็ก:affects_outputs
action_command_lines
- ค่าเริ่มต้น
--[no]build_runfile_links
: "true" -
หากเป็น "จริง" ให้สร้างศูนย์การเรียกใช้ไฟล์ symlink สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้เขียนเมื่อต้องใช้การดำเนินการในเครื่อง ทดสอบ หรือเรียกใช้คำสั่งเท่านั้น
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]build_runfile_manifests
: "true" -
หากเป็น "จริง" ให้เขียนไฟล์ Manifest ของการเรียกใช้ไฟล์สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้ละเว้น การทดสอบในเครื่องจะทํางานไม่ได้หากเป็นเท็จ
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]build_test_dwp
: "เท็จ" -
หากเปิดใช้ เมื่อสร้างการทดสอบ C++ แบบคงที่ และด้วยฟิชชัน ไฟล์ .dwp สำหรับไบนารีการทดสอบจะสร้างขึ้นโดยอัตโนมัติเช่นกัน
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้นของ
--cc_proto_library_header_suffixes=<comma-separated set of options>
: ".pb.h" -
ตั้งค่าคำต่อท้ายของไฟล์ส่วนหัวที่ cc_proto_library สร้างขึ้น
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--cc_proto_library_source_suffixes=<comma-separated set of options>
: ".pb.cc" -
ตั้งค่าคำต่อท้ายของไฟล์ต้นฉบับที่ cc_protocol_library สร้างขึ้น
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_proto_descriptor_sets_include_source_info
: "เท็จ" -
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันอื่นๆ ใน protocol_library
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_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
- ค่าเริ่มต้น
--[no]android_databinding_use_androidx
: "true" -
สร้างไฟล์การเชื่อมโยงข้อมูลที่ใช้กับ AndroidX ได้ ใช้ได้เฉพาะกับการเชื่อมโยงข้อมูล v2 เท่านั้น แฟล็กนี้ไม่มีการใช้งาน
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]android_databinding_use_v3_4_args
: "true" -
ใช้ Android Databinding v2 ที่มีอาร์กิวเมนต์ 3.4.0 แฟล็กนี้ไม่มีการใช้งาน
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้นของ
--android_dynamic_mode=<off, default or fully>
: "ปิด" -
กำหนดว่าจะให้ลิงก์ C++ ของกฎ Android แบบไดนามิกหรือไม่ เมื่อ cc_binary ไม่ได้สร้างไลบรารีที่ใช้ร่วมกันอย่างชัดแจ้ง "ค่าเริ่มต้น" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "สมบูรณ์" หมายความว่าไลบรารีทั้งหมดจะลิงก์แบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "ตามตัวอักษร" -
ตั้งค่าลำดับของไฟล์ Manifest ที่ส่งไปยังการรวมไฟล์ Manifest สำหรับไบนารีของ Android อัลฟ่าหมายความว่าไฟล์ Manifest ได้รับการจัดเรียงตามเส้นทางที่สัมพันธ์กับผู้ดำเนินการ ALPHABETICAL_BY_CONFIGURATION หมายความว่าไฟล์ Manifest ได้รับการจัดเรียงตามเส้นทางที่สัมพันธ์กับไดเรกทอรีการกำหนดค่าภายในไดเรกทอรีเอาต์พุต DEPENDENCY หมายความว่าไฟล์ Manifest จะเรียงลำดับตามไฟล์ Manifest ของไลบรารีแต่ละรายการที่อยู่ก่อนไฟล์ Manifest ของทรัพยากร Dependency
แท็ก:action_command_lines
execution
- ค่าเริ่มต้น
--[no]android_resource_shrinking
: "เท็จ" -
เปิดใช้การย่อทรัพยากรสำหรับ APK android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]build_python_zip
: "อัตโนมัติ" -
สร้าง ZIP ที่เป็นไฟล์ปฏิบัติการ Python ใน Windows และปิดบนแพลตฟอร์มอื่น
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--catalyst_cpus=<comma-separated list of options>
รายการ -
รายชื่อสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple Catalyst
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--[no]collect_code_coverage
: "เท็จ" -
หากระบุไว้ Bazel จะใช้โค้ดเครื่องมือวัด (โดยใช้การใช้เครื่องมือแบบออฟไลน์หากเป็นไปได้) และจะรวบรวมข้อมูลการครอบคลุมระหว่างการทดสอบ เฉพาะเป้าหมายที่ตรงกับ --instrumentation_filter จะได้รับผลกระทบ โดยปกติ ตัวเลือกนี้ไม่ควรระบุโดยตรง - "ความครอบคลุมของbazel" ควรใช้คำสั่งแทน
แท็ก:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] ค่าเริ่มต้น: "fastbuild"-
ระบุโหมดที่จะมีการสร้างไบนารี ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--conlyopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--copt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง gcc
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้นของ
--cpu=<a string>
: "" -
CPU เป้าหมาย
แท็ก:changes_inputs
affects_outputs
- ค่าเริ่มต้น
--cs_fdo_absolute_path=<a string>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ CSFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อเส้นทางสัมบูรณ์ของไฟล์ ZIP ที่มีไฟล์โปรไฟล์, ไฟล์ข้อมูล RAW หรือไฟล์โปรไฟล์ LLVM ที่จัดทำดัชนีไว้
แท็ก:affects_outputs
- ค่าเริ่มต้น
--cs_fdo_instrument=<a string>
: ดูคำอธิบาย -
สร้างไบนารีด้วยเครื่องมือ FDO ที่ละเอียดอ่อนตามบริบท เมื่อใช้คอมไพเลอร์ Clang/LLVM คีย์ดังกล่าวจะยอมรับชื่อไดเรกทอรีที่ระบบจะส่งออกไฟล์โปรไฟล์แบบ RAW ขณะรันไทม์ด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--cs_fdo_profile=<a build target label>
: ดูคำอธิบาย -
cs_fdo_profile แสดงถึงโปรไฟล์ที่ละเอียดอ่อนตามบริบทที่จะใช้ในการเพิ่มประสิทธิภาพ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--cxxopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C++
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--define=<a 'name=value' assignment>
รายการ -
ตัวเลือก --define แต่ละรายการจะระบุการมอบหมายสำหรับตัวแปรบิลด์ ในกรณีที่ตัวแปรหนึ่งมีค่าหลายค่า ค่าสุดท้ายจะชนะ
แท็ก:changes_inputs
affects_outputs
- ค่าเริ่มต้น
--dynamic_mode=<off, default or fully>
: "ค่าเริ่มต้น" -
กำหนดว่าจะลิงก์ไบนารีของ C++ แบบไดนามิกหรือไม่ "ค่าเริ่มต้น" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "สมบูรณ์" หมายความว่าไลบรารีทั้งหมดจะลิงก์แบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก:loading_and_analysis
affects_outputs
- ค่าเริ่มต้น
--[no]enable_propeller_optimize_absolute_paths
: "true" -
หากตั้งค่าไว้ การใช้เส้นทางสัมบูรณ์สำหรับการเพิ่มประสิทธิภาพใบพัดจะทำให้เกิดข้อผิดพลาด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]enable_remaining_fdo_absolute_paths
: "true" -
ถ้ามีการตั้งค่า การใช้เส้นทางสัมบูรณ์สำหรับ FDO จะทำให้เกิดข้อผิดพลาด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]enable_runfiles
: "อัตโนมัติ" -
เปิดใช้โครงสร้างลิงก์สัญลักษณ์ของ Runfiles ซึ่งโดยค่าเริ่มต้น จะปิดอยู่ใน Windows และในแพลตฟอร์มอื่นๆ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_action_listener=<a build target label>
รายการ -
เลิกใช้งานไปทีละด้าน ใช้ action_listener เพื่อแนบทางลัดไปยังการดำเนินการบิลด์ที่มีอยู่
แท็ก:execution
experimental
- ค่าเริ่มต้น
--[no]experimental_android_compress_java_resources
: "เท็จ" -
บีบอัดทรัพยากร Java ใน APK
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_android_databinding_v2
: "true" -
ใช้ Android Data Binding v2 แฟล็กนี้ไม่มีการใช้งาน
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]experimental_android_resource_shrinking
: "เท็จ" -
เปิดใช้การย่อทรัพยากรสำหรับ APK android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_android_rewrite_dexes_with_rex
: "เท็จ" -
ใช้เครื่องมือ Rex เพื่อเขียนไฟล์ dex ใหม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]experimental_collect_code_coverage_for_generated_files
: "เท็จ" -
หากระบุไว้ Bazel จะสร้างการรวบรวมข้อมูลที่ครอบคลุมสำหรับไฟล์ที่สร้างขึ้นด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_objc_fastbuild_options=<comma-separated list of options>
: "-O0,-DDEBUG=1" -
ใช้สตริงเหล่านี้เป็นตัวเลือกคอมไพเลอร์ objc Fastbuild
แท็ก:action_command_lines
- ค่าเริ่มต้น
--[no]experimental_omitfp
: "เท็จ" -
หากเป็น "จริง" ให้ใช้ libunwind สำหรับการคลายสแต็ก แล้วคอมไพล์ด้วย -fomit-frame-pointer และ -fasynchronous-unwind-tables
แท็ก:action_command_lines
,affects_outputs
,experimental
- ค่าเริ่มต้นของ
--experimental_output_paths=<off, content or strip>
: "ปิด" -
โมเดลที่ควรใช้สำหรับส่วนใดในกฎแผนผังเอาต์พุตจะเขียนเอาต์พุต โดยเฉพาะอย่างยิ่งสำหรับบิลด์ที่มีหลายแพลตฟอร์ม / หลายการกำหนดค่า ฟีเจอร์นี้อยู่ในขั้นทดลอง ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/6526 การดำเนินการของ Starlark เลือกใช้การแมปเส้นทางได้ด้วยการเพิ่มคีย์ "supports-path-mapping" เป็น "execution_requirements" พิมพ์ตามคำบอก
แท็ก:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
รายการ -
แต่ละรายการควรอยู่ในรูปแบบ label=value โดยที่ป้ายกำกับอ้างอิงถึงแพลตฟอร์ม และค่าคือชื่อย่อที่ต้องการใช้ในเส้นทางเอาต์พุต ใช้เมื่อ --experimental_platform_in_output_dir เป็นจริงเท่านั้น มีลำดับความสำคัญในการตั้งชื่อสูงสุด
แท็ก:affects_outputs
experimental
- ค่าเริ่มต้น
--[no]experimental_platform_in_output_dir
: "เท็จ" -
หากเป็นจริง ระบบจะใช้ชื่อย่อของแพลตฟอร์มเป้าหมายในชื่อไดเรกทอรีเอาต์พุตแทน CPU รูปแบบที่แน่นอนอยู่ในขั้นทดลองและอาจมีการเปลี่ยนแปลง อย่างแรก ในกรณีซึ่งเกิดขึ้นไม่บ่อยนัก ตัวเลือก --platforms ไม่ได้มีค่าเพียงค่าเดียว ระบบจะใช้แฮชของตัวเลือกแพลตฟอร์ม ถัดไป หากชื่อย่อของแพลตฟอร์มปัจจุบันลงทะเบียนโดย --experimental_override_name_platform_in_output_dir ระบบจะใช้ชื่อย่อนั้น จากนั้น หากมีการตั้งค่า --experimental_use_platforms_in_output_dir_legacy_heurism ให้ใช้ชื่อย่อที่อ้างอิงจากป้ายกำกับแพลตฟอร์มปัจจุบัน สุดท้าย ระบบจะใช้แฮชของตัวเลือกแพลตฟอร์มเป็นทางเลือกสุดท้าย
แท็ก:affects_outputs
experimental
- ค่าเริ่มต้น
--[no]experimental_use_llvm_covmap
: "เท็จ" -
หากระบุ Bazel จะสร้างข้อมูลแผนที่ความครอบคลุมของ llvm-cov แทนที่จะเป็น gcov เมื่อเปิดใช้งานcollect_code_coverage
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
: "true" -
โปรดใช้แฟล็กนี้เป็นส่วนหนึ่งของกลยุทธ์การย้ายข้อมูลหรือการทดสอบที่แนะนำเท่านั้น โปรดทราบว่าการเรียนรู้มีข้อบกพร่องที่ทราบแล้ว และแนะนำให้เปลี่ยนไปใช้เพียง --experimental_override_name_platform_in_output_dir
แท็ก:affects_outputs
experimental
- ค่าเริ่มต้นของ
--fat_apk_cpu=<comma-separated set of options>
: "armeabi-v7a" -
การตั้งค่าตัวเลือกนี้จะเปิดใช้ APK แบบอ้วน ซึ่งมีไบนารีแบบเนทีฟสำหรับสถาปัตยกรรมเป้าหมายที่ระบุทั้งหมด เช่น --fat_apk_cpu=x86,armeabi-v7a. หากระบุแฟล็กนี้ ระบบจะละเว้น --android_cpu สำหรับทรัพยากร Dependency ของกฎ android_binary
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--fdo_instrument=<a string>
: ดูคำอธิบาย -
สร้างไบนารีด้วยเครื่องมือ FDO เมื่อใช้คอมไพเลอร์ Clang/LLVM คีย์ดังกล่าวจะยอมรับชื่อไดเรกทอรีที่ระบบจะส่งออกไฟล์โปรไฟล์แบบ RAW ขณะรันไทม์ด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_optimize=<a string>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ FDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อไฟล์ ZIP ที่มีแผนผังไฟล์ .gcda, ไฟล์ afdo ที่มีโปรไฟล์อัตโนมัติ หรือไฟล์โปรไฟล์ LLVM แฟล็กนี้ยอมรับไฟล์ที่ระบุเป็นป้ายกำกับด้วย (เช่น "//foo/bar:file.afdo" คุณอาจต้องเพิ่มคำสั่ง "exports_files" ไปยังแพ็กเกจที่เกี่ยวข้อง) และป้ายกำกับที่ชี้ไปยังเป้าหมาย "fdo_profile" การตั้งค่าสถานะนี้จะถูกแทนที่โดยกฎ "fdo_profile"
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_prefetch_hints=<a build target label>
: ดูคำอธิบาย -
ใช้คำแนะนำการดึงข้อมูลแคชล่วงหน้า
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_profile=<a build target label>
: ดูคำอธิบาย -
fdo_profile แทนโปรไฟล์ที่จะใช้ในการเพิ่มประสิทธิภาพ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--features=<a string>
รายการ -
ระบบจะเปิดใช้หรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างขึ้นในการกำหนดค่าเป้าหมาย กำลังระบุ -<feature> จะปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ ดูเพิ่มเติมที่ --host_features
แท็ก:changes_inputs
affects_outputs
- ค่าเริ่มต้น
--[no]force_pic
: "เท็จ" -
หากเปิดใช้งาน การคอมไพล์ C++ ทั้งหมดจะสร้างโค้ดที่ไม่ขึ้นอยู่กับตำแหน่ง ("-fPIC") ลิงก์จะใช้ไลบรารีที่สร้างไว้ล่วงหน้าของ PIC มากกว่าไลบรารีที่ไม่ใช่ PIC และลิงก์จะสร้างไฟล์ปฏิบัติการที่ไม่ขึ้นอยู่กับตำแหน่ง ("-pie")
แท็ก:loading_and_analysis
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_action_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกำหนดค่าการดำเนินการ คุณระบุตัวแปรได้ด้วยชื่อ ซึ่งในกรณีนี้ระบบจะนําค่าจากสภาพแวดล้อมการเรียกใช้ หรือคู่ name=value ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ ตัวเลือกนี้ใช้ได้หลายครั้ง สำหรับตัวเลือกที่ระบุสำหรับตัวแปรเดียวกัน ค่าที่ชนะล่าสุด และตัวเลือกของตัวแปรต่างๆ จะสะสมอยู่
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--host_compilation_mode=<fastbuild, dbg or opt>
: "opt" -
ระบุโหมดที่จะมีการสร้างเครื่องมือที่ใช้ในการสร้าง ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_conlyopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งไปยังคอมไพเลอร์ C เมื่อคอมไพล์ไฟล์ต้นฉบับ C (ไม่ใช่ C++) ในการกำหนดค่าผู้บริหาร
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_copt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยังคอมไพเลอร์ C สำหรับเครื่องมือที่สร้างขึ้นในการกำหนดค่าการดำเนินการ
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้นของ
--host_cpu=<a string>
: "" -
CPU ของโฮสต์
แท็ก:changes_inputs
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_cxxopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยังคอมไพเลอร์ C++ สำหรับเครื่องมือที่สร้างขึ้นในการกำหนดค่าดำเนินการ
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_features=<a string>
รายการ -
ระบบจะเปิดใช้หรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างขึ้นในการกำหนดค่า exec กำลังระบุ -<feature> จะปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ
แท็ก:changes_inputs
affects_outputs
- ค่าเริ่มต้น
--host_force_python=<PY2 or PY3>
: ดูคำอธิบาย -
ลบล้างเวอร์ชัน Python สำหรับการกำหนดค่า exec อาจเป็น "PY2" หรือ "PY3"
แท็ก:loading_and_analysis
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_linkopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง Linker เมื่อลิงก์เครื่องมือในการกำหนดค่าการดำเนินการ
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน macOS ที่เข้ากันได้ขั้นต่ำสำหรับเป้าหมายโฮสต์ หากไม่ได้ระบุ ให้ใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อเลือกส่งไปยังคอมไพเลอร์ C/C++ ที่เลือกเมื่อคอมไพล์ไฟล์บางไฟล์ในการกำหนดค่าผู้บริหาร ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจากรายการรวมและไม่รวมรูปแบบนิพจน์ทั่วไป (ดู --instrumentation_filter) ด้วย Option_1 กับ Option_n นั้นย่อมาจากตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ ในการแยกสตริงจะใช้เฉพาะ @ แรกเท่านั้น ตัวอย่าง: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--[no]incompatible_auto_exec_groups
: "เท็จ" -
เมื่อเปิดใช้ ระบบจะสร้างกลุ่มผู้บริหารสำหรับ Toolchain แต่ละรายการที่กฎใช้โดยอัตโนมัติ กฎในการทำงานนี้ต้องระบุพารามิเตอร์ "toolchain" ในการดำเนินการ ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/17134
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_merge_genfiles_directory
: "true" -
หากเป็นจริง ไดเรกทอรี genfiles จะถูกพับลงในไดเรกทอรี bin
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]instrument_test_targets
: "เท็จ" -
เมื่อเปิดใช้การครอบคลุม ให้ระบุว่าจะพิจารณาการใช้กฎการทดสอบการวัดคุมหรือไม่ เมื่อตั้งค่าแล้ว กฎการทดสอบที่ --instrumentation_filter รวมอยู่จะมีการวัดคุม มิฉะนั้น กฎการทดสอบจะถูกยกเว้นจากการวัดคุมการครอบคลุมเสมอ
แท็ก:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
ค่าเริ่มต้น: "-/javatests[/:],-/test/java[/:]"-
เมื่อเปิดใช้การครอบคลุม ระบบจะวัดเฉพาะกฎที่มีชื่อซึ่งตัวกรองตามนิพจน์ทั่วไปที่ระบุรวมอยู่เท่านั้น กฎที่ขึ้นต้นด้วย "-" จะได้รับการยกเว้นแทน โปรดทราบว่าระบบจะวัดคุมเฉพาะกฎที่ไม่ใช่การทดสอบเท่านั้น ยกเว้นกรณีที่เปิดใช้งาน --instrument_test_targets
แท็ก:affects_outputs
- ค่าเริ่มต้น
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน iOS ที่เข้ากันได้ขั้นต่ำสำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ระบุ ให้ใช้ "ios_sdk_version"
แท็ก:loses_incremental_state
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ios_multi_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างแอปพลิเคชัน ios_ ผลลัพธ์จะเป็นไบนารีสากลที่มีสถาปัตยกรรมที่ระบุทั้งหมด
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--[no]legacy_whole_archive
: "true" -
เลิกใช้งานแล้ว และมีผลแทนด้วย --inสามารถเข้าถึง_remove_legacy_whole_archive (ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7362) เมื่อเปิด ให้ใช้ --whole-archive สำหรับกฎ cc_binary ที่มี linkshared=True และ linkstatic=True หรือ '-static' ใน Linkopts วิธีนี้ใช้สำหรับความเข้ากันได้แบบย้อนหลังเท่านั้น อีกทางเลือกหนึ่งที่ดีกว่าคือการใช้ Alwayslink=1 เมื่อจำเป็น
แท็ก:action_command_lines
,affects_outputs
,deprecated
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--linkopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งไปยัง gcc เมื่อลิงก์
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ltobackendopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังขั้นตอนแบ็กเอนด์ของ LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ltoindexopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังขั้นตอนการจัดทำดัชนี LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--macos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple macOS
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน macOS ที่เข้ากันได้ขั้นต่ำสำหรับเป้าหมาย หากไม่ได้ระบุ ให้ใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--memprof_profile=<a build target label>
: ดูคำอธิบาย -
ใช้โปรไฟล์ Memprof
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]objc_debug_with_GLIBCXX
: "เท็จ" -
หากตั้งค่า และตั้งค่าโหมดการคอมไพล์เป็น "dbg" ให้กำหนด GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC และ GLIBCPP_CONCEPT_CHECKS
แท็ก:action_command_lines
- ค่าเริ่มต้น
--[no]objc_enable_binary_stripping
: "เท็จ" -
เลือกว่าจะดำเนินการลบสัญลักษณ์และโค้ดที่เสียหายในไบนารีที่ลิงก์หรือไม่ ระบบจะลบไบนารีหากระบุทั้ง Flag และ --compilation_mode=opt นี้
แท็ก:action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--objccopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ Objective-C/C++
แท็ก:action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งผ่านไปยัง gcc เฉพาะเมื่อคอมไพล์ไฟล์บางไฟล์ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจากรายการรวมและไม่รวมรูปแบบนิพจน์ทั่วไป (ดู --instrumentation_filter) ด้วย Option_1 กับ Option_n นั้นย่อมาจากตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ ในการแยกสตริงจะใช้เฉพาะ @ แรกเท่านั้น ตัวอย่าง: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับเลือกส่งไปยังแบ็กเอนด์ LTO (ในส่วน --features=thin_lto) เมื่อคอมไพล์ออบเจ็กต์แบ็กเอนด์บางรายการ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจาก รายการรูปแบบ รวมและยกเว้น ของนิพจน์ทั่วไป Option_1 กับ Option_n นั้นย่อมาจากตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ ในการแยกสตริงจะใช้เฉพาะ @ แรกเท่านั้น ตัวอย่าง: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่งแบ็กเอนด์ LTO ของไฟล์ o ทั้งหมดใน //foo/ ยกเว้น bar.o
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--platform_suffix=<a string>
: ดูคำอธิบาย -
ระบุคำต่อท้ายที่จะเพิ่มในไดเรกทอรีการกำหนดค่า
แท็ก:loses_incremental_state
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--propeller_optimize=<a build target label>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ Propeller เพื่อเพิ่มประสิทธิภาพเป้าหมายของบิลด์ โปรไฟล์ใบพัดต้องประกอบด้วยไฟล์อย่างน้อย 1 จาก 2 ไฟล์ โปรไฟล์สำเนา และโปรไฟล์ ld แฟล็กนี้ยอมรับป้ายกำกับบิลด์ซึ่งต้องอ้างถึงไฟล์อินพุตโปรไฟล์ใบพัด ตัวอย่างเช่น ไฟล์ BUILD ที่กำหนดป้ายกำกับใน a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)อาจต้องเพิ่มคำสั่ง ecommerce_files ลงในแพ็กเกจที่เกี่ยวข้องเพื่อให้ Bazel มองเห็นไฟล์เหล่านี้ ต้องใช้ตัวเลือกเป็น: --propeller_optimize=//a/b:propeller_profile
แท็ก:action_command_lines
affects_outputs
- ค่าเริ่มต้น
--propeller_optimize_absolute_cc_profile=<a string>
: ดูคำอธิบาย -
ชื่อเส้นทางสัมบูรณ์ของไฟล์ cc_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพใบพัด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--propeller_optimize_absolute_ld_profile=<a string>
: ดูคำอธิบาย -
ชื่อเส้นทางสัมบูรณ์ของไฟล์ ld_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพใบพัด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--run_under=<a prefix in front of command>
: ดูคำอธิบาย -
คำนำหน้าที่จะแทรกก่อนไฟล์ปฏิบัติการสำหรับ "การทดสอบ" และ "เรียกใช้" คำสั่ง หากค่าคือ "foo -bar" และบรรทัดคำสั่งสำหรับการดำเนินการคือ "test_binary -baz" บรรทัดคำสั่งสุดท้ายคือ "foo -bar test_binary -baz" บรรทัดคำสั่งนี้อาจเป็นป้ายกำกับของเป้าหมายสั่งการได้ด้วย ตัวอย่างเช่น 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'
แท็ก:action_command_lines
-
หากจริง ระบบจะแชร์ไลบรารีเนทีฟที่มีฟังก์ชันการทำงานเหมือนกันกับเป้าหมายต่างๆ
แท็ก: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
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--tvos_cpus=<comma-separated list of options>
รายการ -
รายชื่อสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple tvOS
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน tvOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ระบุ ให้ใช้ "tvos_sdk_version"
แท็ก:loses_incremental_state
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--visionos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple visionOS
แท็ก:loses_incremental_state
loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--watchos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple WatchOS
แท็ก:loses_incremental_state
loading_and_analysis
- ค่าเริ่มต้น
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน WatchOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ได้ระบุ ให้ใช้ "watchos_sdk_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--xbinary_fdo=<a build target label>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ XbinaryFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อของโปรไฟล์แบบไบนารีที่เป็นค่าเริ่มต้น เมื่อใช้ตัวเลือกนี้ร่วมกับ --fdo_instrument/--fdo_optimize/--fdo_profile ตัวเลือกเหล่านั้นจะมีผลเหนือกว่าเสมอเสมือนว่าไม่ได้ระบุ xbinary_fdo
แท็ก:affects_outputs
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตบิลด์ที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมธง ฯลฯ)
- ค่าเริ่มต้น
--[no]check_licenses
: "เท็จ" -
ตรวจสอบว่าข้อจำกัดในการออกใบอนุญาตที่กำหนดโดยแพ็กเกจที่เกี่ยวข้องไม่ขัดแย้งกับโหมดการเผยแพร่ของเป้าหมายที่กำลังสร้าง โดยค่าเริ่มต้น ใบอนุญาตจะไม่ได้รับการตรวจสอบ
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]check_visibility
: "true" -
หากปิดใช้ ระบบจะลดระดับข้อผิดพลาดระดับการเข้าถึงในทรัพยากร Dependency เป้าหมายให้เหลือเพียงคําเตือน
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]desugar_for_android
: "true" -
เลือกว่าจะใช้ไบต์โค้ด Java 8 ก่อนถอดรหัสหรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--[no]desugar_java8_libs
: "เท็จ" -
เลือกว่าจะรวมไลบรารี Java 8 ที่รองรับในแอปสำหรับอุปกรณ์เดิมหรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]enforce_constraints
: "true" -
ตรวจสอบสภาพแวดล้อมที่แต่ละเป้าหมายใช้งานร่วมกันได้ และรายงานข้อผิดพลาดหากเป้าหมายมีทรัพยากร Dependency ที่ไม่รองรับสภาพแวดล้อมเดียวกัน
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]experimental_check_desugar_deps
: "true" -
ตรวจสอบความถูกต้องของการแยกน้ำตาลที่ระดับไบนารีของ Android อีกครั้งหรือไม่
แท็ก:eagerness_to_exit
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--experimental_import_deps_checking=<a string>
: ดูคำอธิบาย -
ไม่มีการดำเนินการ เก็บไว้สำหรับความเข้ากันได้แบบย้อนหลังเท่านั้น
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--experimental_one_version_enforcement=<off, warning or error>
: "ปิด" -
เมื่อเปิดใช้ ให้บังคับใช้ว่ากฎ java_binary จะมีไฟล์คลาสเดียวกันใน classpath มากกว่า 1 เวอร์ชันไม่ได้ การบังคับใช้นี้อาจทำให้บิลด์เสียหายหรืออาจทำให้เกิดคำเตือน
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "ค่าเริ่มต้น" -
หากเป็นจริง ให้ตรวจสอบว่าเป้าหมาย Java ประกาศเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency อย่างชัดเจน
แท็ก:build_file_semantics
eagerness_to_exit
- ค่าเริ่มต้น
--[no]incompatible_check_testonly_for_output_files
: "เท็จ" -
หากเปิดใช้ ให้ตรวจสอบ testonly สำหรับเป้าหมายที่จำเป็นเบื้องต้นที่เป็นไฟล์เอาต์พุตโดยค้นหา testonly ของกฎที่สร้าง รายการนี้ตรงกับการตรวจสอบระดับการเข้าถึง
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_check_visibility_for_toolchains
: "เท็จ" -
หากเปิดใช้ การตรวจสอบระดับการเข้าถึงจะมีผลกับการติดตั้งใช้งาน Toolchain ด้วย
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disable_native_android_rules
: "เท็จ" -
หากเปิดใช้ ระบบจะปิดใช้กฎที่มีอยู่สำหรับ Android โดยตรง โปรดใช้กฎของ Android Starlark จาก https://github.com/bazelbuild/rules_android
แท็ก:eagerness_to_exit
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disable_native_apple_binary_rule
: "เท็จ" -
ไม่มีการดำเนินการ เก็บไว้ที่นี่เพื่อดูความเข้ากันได้แบบย้อนหลัง
แท็ก:eagerness_to_exit
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_python_disable_py2
: "true" -
หากเป็น "จริง" การใช้การตั้งค่า Python 2 จะทำให้เกิดข้อผิดพลาด ซึ่งรวมถึง python_version=PY2, srcs_version=PY2 และ srcs_version=PY2ONLY ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/15684
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]one_version_enforcement_on_java_tests
: "true" -
เมื่อเปิดใช้ และตั้งค่า Experiment_one_version_enforcement เป็นค่าที่ไม่ใช่ NONE แล้ว ให้บังคับใช้ 1 เวอร์ชันกับเป้าหมาย java_test คุณสามารถปิดการแจ้งว่าไม่เหมาะสมนี้เพื่อปรับปรุงประสิทธิภาพการทดสอบให้ดียิ่งขึ้นได้ โดยไม่ต้องกลัวว่าจะมีการละเมิดเวอร์ชันใดเวอร์ชันหนึ่ง
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--python_native_rules_allowlist=<a build target label>
: ดูคำอธิบาย -
รายการที่อนุญาต (package_group target (เป้าหมายกลุ่มแพ็กเกจ) ที่จะใช้เมื่อบังคับใช้ --incompatible_python_disallow_native_rules
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]strict_filesets
: "เท็จ" -
หากเปิดใช้ตัวเลือกนี้ ระบบจะรายงานว่าชุดไฟล์ข้ามขอบเขตของแพ็กเกจเป็นข้อผิดพลาด
แท็ก:build_file_semantics
eagerness_to_exit
- ค่าเริ่มต้น
--strict_proto_deps=<off, warn, error, strict or default>
: "ข้อผิดพลาด" -
หากไม่ "ปิด" ให้ตรวจสอบว่าเป้าหมาย protocol_library ประกาศอย่างชัดแจ้งว่าเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้นของ
--strict_public_imports=<off, warn, error, strict or default>
: "ปิด" -
หากไม่ "ปิด" ให้ตรวจสอบว่าเป้าหมาย protocol_library ประกาศอย่างชัดเจนถึงเป้าหมายทั้งหมดที่ใช้ใน "นำเข้าสาธารณะ" ตามที่ส่งออกแล้ว
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้น
--[no]strict_system_includes
: "เท็จ" -
หากเป็น "จริง" ส่วนหัวที่พบผ่านทางระบบรวมเส้นทาง (-isystem) ต้องมีการประกาศด้วย
แท็ก:loading_and_analysis
eagerness_to_exit
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--target_environment=<a build target label>
รายการ -
ประกาศสภาพแวดล้อมเป้าหมายของบิลด์นี้ ต้องอ้างอิงถึงป้ายกำกับไปยัง "สภาพแวดล้อม" กฎ หากระบุ เป้าหมายระดับบนสุดทั้งหมดต้องเข้ากันได้กับสภาพแวดล้อมนี้
แท็ก:changes_inputs
- ตัวเลือกที่มีผลต่อเอาต์พุตการลงชื่อของบิลด์:
- ค่าเริ่มต้น
--apk_signing_method=<v1, v2, v1_v2 or v4>
: "v1_v2" -
การใช้งานเพื่อรับรอง APK
แท็ก:action_command_lines
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--[no]device_debug_entitlements
: "true" -
หากมีการตั้งค่า และโหมดการคอมไพล์ไม่ใช่ "เพิ่มประสิทธิภาพ" แอป objc จะรวมการให้สิทธิ์การแก้ไขข้อบกพร่องเมื่อลงชื่อ
แท็ก:changes_inputs
- ค่าเริ่มต้น
--ios_signing_cert_name=<a string>
: ดูคำอธิบาย -
ชื่อใบรับรองที่จะใช้สำหรับ iOS Signing หากไม่ได้ตั้งค่า ระบบจะกลับไปใช้โปรไฟล์การจัดสรร อาจเป็นค่ากำหนดข้อมูลประจำตัว Keychain ของใบรับรองหรือ (สตริงย่อย) ของชื่อสามัญของใบรับรองตามหน้า man ของ Codesign (รหัสการลงชื่อเข้าใช้)
แท็ก:action_command_lines
- ตัวเลือกนี้จะมีผลกับความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_disallow_legacy_py_provider
: "true" -
ไม่มีการดำเนินการ จะถูกนำออกในเร็วๆ นี้
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disallow_sdk_frameworks_attributes
: "เท็จ" -
หากเป็น "จริง" ไม่อนุญาตแอตทริบิวต์ sdk_frameworks และ external_sdk_frameworks ใน objc_library andobjc_import
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_objc_alwayslink_by_default
: "เท็จ" -
หากเป็น "จริง" ตั้งค่าเริ่มต้นเป็น "จริง" สำหรับแอตทริบิวต์ Alwayslink ใน objc_library และ objc_IMPORT
แท็ก:build_file_semantics
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_python_disallow_native_rules
: "เท็จ" -
เมื่อเป็นจริง เกิดข้อผิดพลาดขึ้นเมื่อใช้กฎ py_* ในตัว ควรใช้กฎ rules_python แทน ดูข้อมูลเพิ่มเติมและวิธีการย้ายข้อมูลได้ที่ https://github.com/bazelbuild/bazel/issues/17773
แท็ก:loading_and_analysis
incompatible_change
- สภาพแวดล้อมการทดสอบหรือตัวดำเนินการทดสอบ:
- ค่าเริ่มต้น
--[no]allow_analysis_failures
: "เท็จ" -
หากจริง การวิเคราะห์เป้าหมายของกฎไม่สำเร็จส่งผลให้เกิดการเผยแพร่อินสแตนซ์ของ AnalysisFailureInfo ของเป้าหมายที่มีคำอธิบายข้อผิดพลาด แทนที่จะทำให้บิลด์ไม่สำเร็จ
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--analysis_testing_deps_limit=<an integer>
: "2000" -
ตั้งค่าจำนวนสูงสุดของทรัพยากร Dependency แบบทรานซิทีฟผ่านแอตทริบิวต์กฎที่มีการเปลี่ยนการกำหนดค่า for_analysis_testing การใช้เกินขีดจำกัดนี้จะทำให้เกิดข้อผิดพลาดของกฎ
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]break_build_on_parallel_dex2oat_failure
: "เท็จ" -
หากความล้มเหลวจริงในการดำเนินการ dex2oat จะทำให้บิลด์เสียหายแทนที่จะเรียกใช้ dex2oat ระหว่างรันไทม์ทดสอบ
แท็ก:loading_and_analysis
experimental
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g memory=10,30,60,100>
รายการ - ลบล้างจำนวนทรัพยากรเริ่มต้นสำหรับการทดสอบ รูปแบบที่คาดไว้คือ <resource>=<value> หากระบุจำนวนบวกตัวเดียวเป็น <value> ระบบจะลบล้างทรัพยากรเริ่มต้นสำหรับขนาดทดสอบทั้งหมด หากระบุตัวเลขที่คั่นด้วยคอมมา 4 ตัว จำนวนดังกล่าวจะแทนที่จำนวนทรัพยากรสำหรับขนาดทดสอบขนาดเล็ก กลาง ใหญ่ และขนาดใหญ่ตามลำดับ ค่าอาจเป็น HOST_RAM/HOST_CPU (ไม่บังคับ) ตามด้วย [-|*]<Flo> (เช่น Memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4) ทรัพยากรการทดสอบเริ่มต้นที่ระบุโดยแฟล็กนี้จะถูกลบล้างโดยทรัพยากรที่อาจไม่เหมาะสมซึ่งระบุไว้ในแท็ก
- ค่าเริ่มต้น
--[no]experimental_android_use_parallel_dex2oat
: "เท็จ" -
ใช้ dex2oat แบบขนานเพื่อเร่งความเร็ว android_test
แท็ก:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- ค่าเริ่มต้น
--[no]ios_memleaks
: "เท็จ" -
เปิดใช้การตรวจหาหน่วยความจำรั่วไหลในเป้าหมาย ios_test
แท็ก:action_command_lines
- ค่าเริ่มต้น
--ios_simulator_device=<a string>
: ดูคำอธิบาย -
อุปกรณ์ที่จะจำลองเมื่อเรียกใช้แอปพลิเคชัน iOS ในเครื่องมือจำลอง เช่น "iPhone 6" คุณดูรายการอุปกรณ์ได้โดยเรียกใช้ "xcrun simctl list devicetypes" บนเครื่องที่เครื่องมือจำลองจะทำงาน
แท็ก:test_runner
- ค่าเริ่มต้น
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชันของ iOS ที่จะเรียกใช้บนเครื่องมือจำลองเมื่อทำงานหรือทดสอบ ระบบจะไม่สนใจกฎ ios_test หากกฎระบุอุปกรณ์เป้าหมายไว้ในกฎ
แท็ก:test_runner
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
รายการ - ระบุจำนวนครั้งที่จะทำการทดสอบแต่ละครั้ง หากการดำเนินการเหล่านั้นล้มเหลวไม่ว่าด้วยเหตุผลใดก็ตาม จะถือว่าการทดสอบทั้งหมดไม่ผ่าน โดยปกติแล้ว ค่าที่ระบุจะเป็นแค่จำนวนเต็ม ตัวอย่าง: --runs_per_test=3 จะทำการทดสอบทั้งหมด 3 ครั้ง ไวยากรณ์สำรอง: regex_filter@runs_per_test โดย running_per_test ย่อมาจากค่าจำนวนเต็ม ส่วน regex_filter หมายถึงรายการรูปแบบการรวมและยกเว้นรูปแบบนิพจน์ทั่วไป (โปรดดู --instrumentation_filter) ตัวอย่างเช่น --runs_per_test=//foo/.*,-//foo/bar/.*@3 จะทำการทดสอบทั้งหมดใน //foo/ ยกเว้นการทดสอบภายใต้ foo/bar 3 ครั้ง ตัวเลือกนี้ส่งได้หลายครั้ง อาร์กิวเมนต์ที่ส่งผ่านล่าสุดที่ตรงกันจะมีความสำคัญเหนือกว่า หากไม่มีผลลัพธ์ที่ตรงกัน ระบบจะทำการทดสอบเพียงครั้งเดียว
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--test_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุตัวแปรสภาพแวดล้อมเพิ่มเติมที่จะแทรกลงในสภาพแวดล้อมตัวดำเนินการทดสอบ คุณระบุตัวแปรได้โดยใช้ชื่อ ซึ่งในกรณีนี้ระบบจะอ่านค่าของตัวแปรจากสภาพแวดล้อมไคลเอ็นต์ Bazel หรือด้วยคู่ชื่อ=ค่า ตัวเลือกนี้ใช้ได้หลายครั้งเพื่อระบุตัวแปรหลายรายการ ใช้เฉพาะโดย "การทดสอบ bazel" เท่านั้น คำสั่ง
แท็ก:test_runner
- ค่าเริ่มต้น
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - ลบล้างค่าระยะหมดเวลาในการทดสอบเริ่มต้นสำหรับระยะหมดเวลาทดสอบ (เป็นวินาที) หากระบุค่าจำนวนเต็มบวกค่าเดียว ค่าดังกล่าวจะแทนที่หมวดหมู่ทั้งหมด หากระบุจำนวนเต็มที่คั่นด้วยคอมมา 4 ตัวเลข ค่าดังกล่าวจะลบล้างระยะหมดเวลาสำหรับแบบสั้น ปานกลาง ยาว และนิรันดร์ (ตามลำดับนั้น) ไม่ว่าจะเป็นรูปแบบใด ค่า -1 จะบอกให้ Blaze ใช้ระยะหมดเวลาเริ่มต้นสำหรับหมวดหมู่นั้น
- ค่าเริ่มต้น
--[no]zip_undeclared_test_outputs
: "true" -
หากเป็น "จริง" ระบบจะเก็บเอาต์พุตทดสอบที่ไม่ได้ประกาศไว้ในไฟล์ ZIP
แท็ก:test_runner
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพเวลาของบิลด์
- ค่าเริ่มต้น
--[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_retain_test_configuration_across_testonly
: "เท็จ" -
เมื่อเปิดใช้ --trim_test_configuration จะไม่ตัดการกำหนดค่าการทดสอบสำหรับกฎที่ทำเครื่องหมายว่า testonly=1 ทั้งนี้เพื่อลดปัญหาความขัดแย้งในการดำเนินการเมื่อกฎที่ไม่ใช่การทดสอบต้องพึ่งพากฎ cc_test จะไม่มีผลหาก --trim_test_configuration เป็นเท็จ
แท็ก:loading_and_analysis
loses_incremental_state
- ค่าเริ่มต้น
--[no]experimental_starlark_cc_import
: "เท็จ" -
หากเปิดใช้ เวอร์ชัน Starlark ของ cc_import จะสามารถใช้ได้
แท็ก:loading_and_analysis
experimental
- ค่าเริ่มต้น
--[no]experimental_unsupported_and_brittle_include_scanning
: "เท็จ" -
เลือกว่าจะจำกัดอินพุตเฉพาะการคอมไพล์ C/C++ หรือไม่โดยการแยกวิเคราะห์ #include บรรทัดจากไฟล์อินพุต ซึ่งจะช่วยปรับปรุงประสิทธิภาพและส่วนเพิ่มด้วยการลดขนาดของแผนผังอินพุตสำหรับการคอมไพล์ อย่างไรก็ตาม ก็อาจทำให้บิลด์เสียหายได้เช่นกัน เนื่องจากเครื่องมือสแกนดังกล่าวไม่สามารถใช้งานความหมายของโปรเซสเซอร์ล่วงหน้าแบบ C ได้อย่างสมบูรณ์ โดยเฉพาะอย่างยิ่ง ระบบจะไม่เข้าใจคำสั่ง #include แบบไดนามิก และไม่สนใจตรรกะตามเงื่อนไขของตัวประมวลผลล่วงหน้า คุณต้องรับความเสี่ยงของการใช้งานเอง เราจะปิดปัญหาที่เกี่ยวข้องกับการแจ้งว่าไม่เหมาะสมนี้
แท็ก:loading_and_analysis
,execution
,changes_inputs
- ค่าเริ่มต้น
--[no]incremental_dexing
: "true" -
ส่วนใหญ่จะทำงานสำหรับ Dexing แยกต่างหากสำหรับไฟล์ Jar แต่ละไฟล์
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--[no]objc_use_dotd_pruning
: "true" -
หากตั้งค่าไว้ จะมีการใช้ไฟล์ .d ที่มาจาก clang เพื่อตัดชุดอินพุตที่ส่งผ่านเข้าไปในคอมไพล์ objc
แท็ก:changes_inputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]process_headers_in_dependencies
: "เท็จ" -
เมื่อสร้าง //a:a เป้าหมาย ให้ประมวลผลส่วนหัวในเป้าหมายทั้งหมดที่ //a:a ต้องใช้ (หากเปิดใช้การประมวลผลส่วนหัวสำหรับ Toolchain)
แท็ก:execution
- ค่าเริ่มต้น
--[no]trim_test_configuration
: "true" -
เมื่อเปิดใช้ ระบบจะล้างตัวเลือกที่เกี่ยวข้องกับการทดสอบซึ่งอยู่ใต้ระดับบนสุดของบิลด์ เมื่อแฟล็กนี้ทำงานอยู่ ระบบจะสร้างการทดสอบเป็นทรัพยากร Dependency ของกฎที่ไม่ใช่การทดสอบไม่ได้ แต่การเปลี่ยนแปลงตัวเลือกที่เกี่ยวข้องกับการทดสอบจะไม่ทำให้มีการวิเคราะห์กฎที่ไม่ใช่การทดสอบอีกครั้ง
แท็ก:loading_and_analysis
loses_incremental_state
- การพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก:
- ค่าเริ่มต้น
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
พิมพ์ข้อมูลการแก้ไขข้อบกพร่องระหว่างการแปลง Toolchain แฟล็กจะใช้นิพจน์ทั่วไปซึ่งตรวจสอบกับประเภท Toolchain และเป้าหมายที่เฉพาะเจาะจงเพื่อดูว่าควรแก้ไขข้อบกพร่องใด นิพจน์ทั่วไปหลายรายการจะคั่นด้วยคอมมา แล้วระบบจะเลือกนิพจน์ทั่วไปแต่ละรายการแยกกัน หมายเหตุ: เอาต์พุตของ Flag นี้มีความซับซ้อนมากและน่าจะเป็นประโยชน์ต่อผู้เชี่ยวชาญด้านการแก้ไข Toolchain เท่านั้น
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--flag_alias=<a 'name=value' flag alias>
รายการ -
ตั้งชื่อย่อสำหรับธง Starlark โดยใช้คู่คีย์-ค่าคู่เดียวในรูปแบบ "<key>=<value>" เป็นอาร์กิวเมนต์
แท็ก:changes_inputs
- ค่าเริ่มต้น
--[no]incompatible_default_to_explicit_init_py
: "เท็จ" -
แฟล็กนี้เปลี่ยนลักษณะการทำงานเริ่มต้นเพื่อไม่ให้สร้างไฟล์ __init__.py โดยอัตโนมัติในไฟล์การเรียกใช้ของเป้าหมาย Python อีกต่อไป แม่นยำเมื่อเป้าหมาย py_binary หรือ py_test ตั้งค่า legacy_create_init เป็น "auto" (ค่าเริ่มต้น) ระบบจะถือว่าเป็น "เท็จ" เมื่อมีการตั้งค่าแฟล็กนี้เท่านั้น ดู https://github.com/bazelbuild/bazel/issues/10076
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_py2_outputs_are_suffixed
: "true" -
หากเป็นจริง เป้าหมายที่สร้างในการกำหนดค่า Python 2 จะปรากฏภายใต้รูทเอาต์พุตที่มีคำต่อท้าย "-py2" ขณะที่เป้าหมายที่สร้างขึ้นสำหรับ Python 3 จะปรากฏในรูทที่ไม่มีส่วนต่อท้ายที่เกี่ยวข้องกับ Python ซึ่งหมายความว่าลิงก์สัญลักษณ์ความสะดวก "bazel-bin" จะชี้ไปยังเป้าหมาย Python 3 แทนที่จะเป็น Python 2 หากคุณเปิดใช้ตัวเลือกนี้ ขอแนะนำให้เปิดใช้ "--incompatible_py3_is_default" ด้วย
แท็ก:affects_outputs
incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_py3_is_default
: "true" -
หากเป็นจริง เป้าหมาย "py_binary" และ "py_test" ที่ไม่ได้ตั้งค่าแอตทริบิวต์ "python_version" (หรือ "default_python_version") จะมีค่าเริ่มต้นเป็น PY3 แทนที่จะเป็น PY2 หากตั้งค่าแฟล็กนี้ ขอแนะนำให้ตั้งค่า "--incompatible_py2_outputs_are_suffixed"
แท็ก:loading_and_analysis
,affects_outputs
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_use_python_toolchains
: "true" -
หากตั้งค่าเป็น "จริง" กฎ Python ในเครื่องที่เป็นไฟล์ปฏิบัติการจะใช้รันไทม์ของ Python ที่ระบุโดย Toolchain ของ Python แทนรันไทม์ที่มาจากแฟล็กเดิม เช่น --python_top
แท็ก:loading_and_analysis
incompatible_change
- ค่าเริ่มต้น
--python_version=<PY2 or PY3>
: ดูคำอธิบาย -
โหมดเวอร์ชันหลักของ Python ไม่ว่าจะเป็น "PY2" หรือ "PY3" โปรดทราบว่าเป้าหมาย "py_binary" และ "py_test" จะลบล้างค่านี้ (แม้ว่าจะไม่ได้ระบุเวอร์ชันอย่างชัดเจน) จึงมักไม่มีเหตุผลที่จะต้องระบุแฟล็กนี้
แท็ก:loading_and_analysis
affects_outputs
- ที่ไม่ถูกจัดหมวดหมู่:
--[no]cache_test_results
[-t
] ค่าเริ่มต้น: "อัตโนมัติ"- หากตั้งค่าเป็น "อัตโนมัติ" Bazel จะทำการทดสอบอีกครั้งเฉพาะในกรณีต่อไปนี้ (1) Bazel ตรวจพบการเปลี่ยนแปลงในการทดสอบหรือทรัพยากร Dependency (2) การทดสอบได้รับการทำเครื่องหมายว่าเป็นภายนอก (3) มีการขอทำการทดสอบหลายครั้งด้วย --runs_per_test หรือ(4) การทดสอบล้มเหลวก่อนหน้านี้ หากตั้งค่าเป็น "ใช่" Bazel จะแคชผลการทดสอบทั้งหมด ยกเว้นการทดสอบที่ทำเครื่องหมายว่าภายนอก หากตั้งค่าเป็น "ไม่" Bazel จะไม่แคชผลการทดสอบใดๆ
- ค่าเริ่มต้น
--[no]experimental_cancel_concurrent_tests
: "เท็จ" -
หากเป็น "จริง" Blaze จะยกเลิกการทดสอบพร้อมกันในการรันที่สำเร็จครั้งแรก วิธีนี้จะมีประโยชน์เมื่อใช้ร่วมกับ --runs_per_test_detects_flakes เท่านั้น
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_fetch_all_coverage_outputs
: "เท็จ" -
หากเป็น "จริง" Bazel จะดึงข้อมูลไดเรกทอรีข้อมูลการครอบคลุมทั้งหมดสำหรับการทดสอบแต่ละครั้งระหว่างการทำงานของการครอบคลุม
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_generate_llvm_lcov
: "เท็จ" -
หากเป็น "จริง" ความครอบคลุมของคําพูดจะสร้างรายงาน LCOV
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_j2objc_header_map
: "true" - เลือกว่าจะสร้างแผนที่ส่วนหัว J2ObjC ควบคู่ไปกับการแปลง J2ObjC หรือไม่
- ค่าเริ่มต้น
--[no]experimental_j2objc_shorter_header_path
: "เท็จ" -
เลือกว่าจะสร้างโดยใช้เส้นทางส่วนหัวที่สั้นกว่าหรือไม่ (ใช้ "_ios" แทน "_j2objc")
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_java_classpath=<off, javabuilder or bazel>
: "javabuilder" - เปิดใช้งานคลาสพาธที่ลดลงสำหรับการคอมไพล์ Java
- ค่าเริ่มต้น
--[no]experimental_limit_android_lint_to_android_constrained_java
: "เท็จ" -
ไม่มีการดำเนินการ เก็บไว้สำหรับความเข้ากันได้แบบย้อนหลังเท่านั้น
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_run_android_lint_on_java_rules
: "เท็จ" -
ระบุว่าจะตรวจสอบแหล่งที่มา java_* หรือไม่
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]explicit_java_test_deps
: "เท็จ" - ระบุทรัพยากร Dependency ของ JUnit หรือ Hamcrest อย่างชัดเจนใน java_test แทนที่จะได้มาจาก Dep ของ TestRunner โดยไม่ตั้งใจ ตอนนี้ใช้ได้กับ bazel เท่านั้น
- ค่าเริ่มต้น
--host_java_launcher=<a build target label>
: ดูคำอธิบาย - Java Launcher ที่เครื่องมือใช้ซึ่งดำเนินการในระหว่างบิลด์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_javacopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมในการส่งไปยัง Javac เมื่อสร้างเครื่องมือที่ดำเนินการระหว่างบิลด์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_jvmopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง Java VM เมื่อสร้างเครื่องมือสร้างที่ดำเนินการระหว่างบิลด์ ระบบจะเพิ่มตัวเลือกเหล่านี้ไปยังตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
- ค่าเริ่มต้น
--[no]incompatible_check_sharding_support
: "true" -
หากเป็น "จริง" Bazel จะไม่ผ่านการทดสอบชาร์ด หากตัวดำเนินการทดสอบไม่ได้ระบุว่ารองรับการชาร์ดดิ้งโดยการแตะไฟล์ที่เส้นทางใน TEST_SHARD_STATUS_FILE หากเป็นเท็จ ตัวดำเนินการทดสอบที่ไม่รองรับการชาร์ดจะนำไปยังการทดสอบทั้งหมดที่ทำงานในชาร์ดแต่ละรายการ
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_exclusive_test_sandboxed
: "true" -
หากจริง การทดสอบพิเศษจะทำงานโดยใช้กลยุทธ์แซนด์บ็อกซ์ เพิ่ม "ท้องถิ่น" เพื่อบังคับให้การทดสอบพิเศษทำงานภายในเครื่อง
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_strict_action_env
: "เท็จ" -
หากเป็นจริง Bazel จะใช้สภาพแวดล้อมที่มีค่าคงที่สำหรับ PATH และไม่รับค่า LD_LIBRARY_PATH ใช้ --action_env=ENV_VARIABLE หากคุณต้องการรับตัวแปรสภาพแวดล้อมที่เฉพาะเจาะจงจากไคลเอ็นต์ แต่โปรดทราบว่าการทำเช่นนี้อาจป้องกันการแคชข้ามผู้ใช้ได้หากมีการใช้แคชที่แชร์
แท็ก:loading_and_analysis
incompatible_change
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--j2objc_translation_flags=<comma-separated list of options>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยังเครื่องมือ J2ObjC
--java_debug
-
ทำให้เครื่องเสมือนของ Java ของการทดสอบ Java ต้องรอการเชื่อมต่อจากโปรแกรมแก้ไขข้อบกพร่องที่สอดคล้องกับ JDWP (เช่น jdb) ก่อนเริ่มการทดสอบ โดยนัย -test_output=streamed
ขยายเป็น
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- ค่าเริ่มต้น
--[no]java_deps
: "true" - สร้างข้อมูลทรัพยากร Dependency (ในขณะนี้คือคลาสพาธเวลาคอมไพล์) ต่อเป้าหมาย Java
- ค่าเริ่มต้น
--[no]java_header_compilation
: "true" - คอมไพล์จากต้นทางโดยตรง
- ค่าเริ่มต้นของ
--java_language_version=<a string>
: "" - เวอร์ชันภาษา Java
- ค่าเริ่มต้น
--java_launcher=<a build target label>
: ดูคำอธิบาย - Java Launcher ที่จะใช้เมื่อสร้างไบนารีของ Java หากตั้งค่าสถานะนี้เป็นสตริงว่างเปล่า ระบบจะใช้ Launcher ของ JDK "Launcher" จะลบล้างแฟล็กนี้
--java_runtime_version=<a string>
ค่าเริ่มต้น: "local_jdk"- เวอร์ชันรันไทม์ของ Java
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--javacopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง Javac
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--jvmopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง Java VM ระบบจะเพิ่มตัวเลือกเหล่านี้ไปยังตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
- ค่าเริ่มต้น
--legacy_main_dex_list_generator=<a build target label>
: ดูคำอธิบาย - ระบุไบนารีที่จะใช้สร้างรายการคลาสที่ต้องอยู่ใน Dex หลักเมื่อคอมไพล์ Multidex เดิม
- ค่าเริ่มต้น
--optimizing_dexer=<a build target label>
: ดูคำอธิบาย - ระบุไบนารีที่จะใช้ทำ Dexing โดยไม่ต้องชาร์ดดิ้ง
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--plugin=<a build target label>
รายการ - ปลั๊กอินที่ใช้ในบิลด์ ปัจจุบันใช้งานได้กับ java_plugin
- ค่าเริ่มต้น
--proguard_top=<a build target label>
: ดูคำอธิบาย - ระบุเวอร์ชัน ProGuard ที่จะใช้สำหรับการนำโค้ดออกเมื่อสร้างไบนารีของ Java
--proto_compiler=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/protocol:protocol"-
ป้ายกำกับของคอมไพเลอร์ Proto
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--[no]proto_profile
: "true" -
ระบุว่าจะส่ง profile_path ไปยังคอมไพเลอร์ Pro หรือไม่
แท็ก:affects_outputs
loading_and_analysis
- ค่าเริ่มต้น
--proto_profile_path=<a build target label>
: ดูคำอธิบาย -
โปรไฟล์ที่จะส่งไปยังคอมไพเลอร์ Pro เป็น profile_path หากไม่ได้ตั้งค่า แต่ --protocol_profile เป็นจริง (ค่าเริ่มต้น) จะอนุมานเส้นทางจาก --fdo_optimize
แท็ก: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:/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, อื่นๆ ทั้งหมด: /bin/bash) โปรดทราบว่าการใช้ Shell ที่เข้ากันไม่ได้กับ Bash อาจทำให้บิลด์ล้มเหลวหรือรันไทม์ของไบนารีที่สร้างขึ้นไม่สำเร็จ
แท็ก:loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--test_arg=<a string>
รายการ - ระบุตัวเลือกและอาร์กิวเมนต์เพิ่มเติมที่ควรส่งไปยังไฟล์ปฏิบัติการทดสอบ ซึ่งสามารถใช้หลายครั้งเพื่อระบุอาร์กิวเมนต์ได้หลายรายการ หากดำเนินการทดสอบหลายรายการ แต่ละรายการจะได้รับอาร์กิวเมนต์ที่เหมือนกัน ใช้เฉพาะโดย "การทดสอบ bazel" เท่านั้น คำสั่ง
- ค่าเริ่มต้น
--test_filter=<a string>
: ดูคำอธิบาย - ระบุตัวกรองที่จะส่งต่อไปยังเฟรมเวิร์กการทดสอบ ใช้เพื่อจำกัดการทดสอบ โปรดทราบว่าการเปลี่ยนแปลงนี้ไม่มีผลต่อเป้าหมายที่สร้างขึ้น
- ค่าเริ่มต้น
--test_result_expiration=<an integer>
: "-1" - ตัวเลือกนี้เลิกใช้งานแล้วและไม่ส่งผลใดๆ
- ค่าเริ่มต้น
--[no]test_runner_fail_fast
: "เท็จ" - การส่งต่อล้มเหลวตัวเลือกอย่างรวดเร็วไปยังตัวดำเนินการทดสอบ ตัวดำเนินการทดสอบควรหยุดการดำเนินการเมื่อล้มเหลวครั้งแรก
- ค่าเริ่มต้น
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
: "อาจไม่เหมาะสม" - ระบุกลยุทธ์สำหรับการทดสอบชาร์ดดิ้ง: "Explicit" จะใช้ชาร์ดดิ้งก็ต่อเมื่อ "shard_count" เท่านั้น มีแอตทริบิวต์ BUILD "ปิดใช้" ว่าจะไม่ใช้ทดสอบชาร์ดดิ้ง "forced=k" เพื่อบังคับใช้ "k" ชาร์ดสำหรับการทดสอบโดยไม่คำนึงถึง "shard_count" BUILD
- ค่าเริ่มต้นของ
--tool_java_language_version=<a string>
: "" - เวอร์ชันภาษา Java ที่ใช้เพื่อเรียกใช้เครื่องมือที่จำเป็นระหว่างการสร้าง
- ค่าเริ่มต้นของ
--tool_java_runtime_version=<a string>
: "remotejdk_11" - เวอร์ชันรันไทม์ของ Java ที่ใช้เพื่อเรียกใช้เครื่องมือในระหว่างบิลด์
- ค่าเริ่มต้น
--[no]use_ijars
: "true" - หากเปิดใช้ ตัวเลือกนี้จะทำให้การคอมไพล์ Java ใช้ jars อินเทอร์เฟซ ซึ่งจะทำให้การคอมไพล์แบบเพิ่มขึ้นเรื่อยๆ ได้เร็วขึ้น แต่ข้อความแสดงข้อผิดพลาดอาจแตกต่างกันได้
ตัวเลือกเวอร์ชัน
- ตัวเลือกที่ให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการได้ โดยให้ส่งผลต่อค่าของเอาต์พุตแทนค่าที่มีอยู่
- ค่าเริ่มต้น
--[no]gnu_format
: "เท็จ" -
หากตั้งค่าไว้ ให้เขียนเวอร์ชันเป็น Sttdout โดยใช้แบบแผนที่อธิบายไว้ในมาตรฐาน GNU
แท็ก:affects_outputs
execution
- ภาษา Starlark หรือ API บิลด์ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_use_plus_in_repo_names
: "true" -
ไม่มีการดำเนินการ
แท็ก:loading_and_analysis
แท็กเอฟเฟกต์ตัวเลือก
unknown |
ตัวเลือกนี้มีผลกระทบที่ไม่รู้จักหรือไม่ได้ระบุไว้ |
no_op |
ตัวเลือกนี้ไม่มีผลใดๆ ทั้งสิ้น |
loses_incremental_state |
การเปลี่ยนค่าของตัวเลือกนี้อาจทำให้สูญเสียสถานะที่เพิ่มขึ้นเป็นอย่างมาก ซึ่งจะทำให้บิลด์ช้าลง สถานะอาจสูญหายเนื่องจากการรีสตาร์ทเซิร์ฟเวอร์หรือการทำให้กราฟทรัพยากร Dependency ส่วนใหญ่ถูกยกเลิก |
changes_inputs |
ตัวเลือกนี้จะเปลี่ยนอินพุตที่ bazel พิจารณาสำหรับบิลด์ เช่น ข้อจำกัดของระบบไฟล์ เวอร์ชันของที่เก็บ หรือตัวเลือกอื่นๆ |
affects_outputs |
ตัวเลือกนี้จะส่งผลต่อเอาต์พุตของ bazel แท็กนี้ตั้งใจให้กว้างขึ้น สามารถรวมผลกระทบแบบสับเปลี่ยน และไม่ระบุประเภทของเอาต์พุตที่จะได้รับผลกระทบ |
build_file_semantics |
ตัวเลือกนี้จะมีผลกับความหมายของไฟล์ BUILD หรือ .bzl |
bazel_internal_configuration |
ตัวเลือกนี้จะมีผลกับการตั้งค่าเครื่องจักรภายในแบบ bazel แท็กนี้ไม่ได้หมายความว่าอาร์ติแฟกต์ของบิลด์ได้รับผลกระทบ |
loading_and_analysis |
ตัวเลือกนี้ส่งผลต่อการโหลดและการวิเคราะห์ทรัพยากร Dependency และการสร้างกราฟทรัพยากร Dependency |
execution |
ตัวเลือกนี้จะส่งผลต่อระยะการดำเนินการ เช่น ตัวเลือกที่เกี่ยวข้องกับการทำแซนด์บ็อกซ์หรือการดำเนินการระยะไกล |
host_machine_resource_optimizations |
ตัวเลือกนี้จะทริกเกอร์การเพิ่มประสิทธิภาพที่อาจเจาะจงเครื่องและไม่รับประกันว่าจะใช้ได้กับคอมพิวเตอร์ทุกเครื่อง การเพิ่มประสิทธิภาพอาจรวมถึงการแลกกับประสิทธิภาพด้านอื่นๆ เช่น หน่วยความจำหรือต้นทุน CPU |
eagerness_to_exit |
ตัวเลือกนี้จะเปลี่ยนวิธีที่ทำให้ bazel สุดๆ ออกจากความล้มเหลว คือมีตัวเลือกระหว่างดำเนินการต่อทั้งที่ล้มเหลวและจบการเรียกใช้อยู่ |
bazel_monitoring |
ตัวเลือกนี้ใช้เพื่อตรวจสอบพฤติกรรมและประสิทธิภาพของ Bazel |
terminal_output |
ตัวเลือกนี้จะมีผลกับเอาต์พุตเทอร์มินัลของ bazel |
action_command_lines |
ตัวเลือกนี้จะเปลี่ยนอาร์กิวเมนต์บรรทัดคำสั่งของการดำเนินการบิลด์อย่างน้อย 1 รายการ |
test_runner |
ตัวเลือกนี้จะเปลี่ยนสภาพแวดล้อมผู้ทดสอบของบิลด์ |
แท็กข้อมูลเมตาของตัวเลือก
experimental |
ตัวเลือกนี้จะเรียกใช้ฟีเจอร์ทดลองโดยไม่มีการรับประกันฟังก์ชันการทำงาน |
incompatible_change |
ตัวเลือกนี้จะทำให้เกิดการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ ใช้ตัวเลือกนี้เพื่อทดสอบความพร้อมในการย้ายข้อมูลหรือทดลองใช้ฟีเจอร์ใหม่ก่อนเปิดตัว |
deprecated |
ตัวเลือกนี้เลิกใช้งานแล้ว อาจเป็นไปได้ว่าฟีเจอร์ที่ได้รับผลกระทบเลิกใช้งานแล้ว หรืออาจแนะนำวิธีระบุข้อมูลอื่น |
immutable |
ตัวเลือกนี้จะเปลี่ยนแปลงในช่วงการเปลี่ยนผ่านไม่ได้ |