bazel [<startup options>] <command> [<args>]
bazel [<startup options>] <command> [<args>] -- [<target patterns>]
ไวยากรณ์ของตัวเลือก
ตัวเลือกสามารถส่งไปยัง Bazel ได้หลายวิธี ตัวเลือกที่ต้องมีค่าจะส่งผ่านได้ด้วยเครื่องหมายเท่ากับหรือเว้นวรรค
--<option>=<value> --<option> <value>
-<short_form> <value>
ตัวเลือกบูลีนสามารถเปิดใช้ได้ดังนี้
--<option> --<option>=[true|yes|1]
--no<option> --<option>=[false|no|0]
โดยปกติแล้ว ระบบจะตั้งค่าตัวเลือกแบบ 3 สถานะเป็น "อัตโนมัติ" โดยค่าเริ่มต้น และสามารถเปิดใช้แบบบังคับได้โดยทำดังนี้
--<option>=[true|yes|1]
--no<option> --<option>=[false|no|0]
คำสั่ง
analyze-profile |
วิเคราะห์ข้อมูลโปรไฟล์การสร้าง |
aquery |
วิเคราะห์เป้าหมายที่ระบุและค้นหากราฟการดําเนินการ |
build |
สร้างเป้าหมายที่ระบุ |
canonicalize-flags |
เปลี่ยนรายการตัวเลือก bazel ให้เป็นแบบมาตรฐาน |
clean |
นำไฟล์เอาต์พุตออกและหยุดเซิร์ฟเวอร์ (ไม่บังคับ) |
coverage |
สร้างรายงานการครอบคลุมโค้ดสําหรับเป้าหมายการทดสอบที่ระบุ |
cquery |
โหลด วิเคราะห์ และค้นหาเป้าหมายที่ระบุพร้อมการกําหนดค่า |
dump |
ดัมพ์สถานะภายในของกระบวนการของเซิร์ฟเวอร์ bazel |
fetch |
ดึงข้อมูลที่เก็บภายนอกที่จำเป็นเบื้องต้นไปยังเป้าหมาย |
help |
พิมพ์ความช่วยเหลือสำหรับคำสั่งหรือดัชนี |
info |
แสดงข้อมูลรันไทม์เกี่ยวกับเซิร์ฟเวอร์ bazel |
license |
พิมพ์ใบอนุญาตของซอฟต์แวร์นี้ |
mobile-install |
ติดตั้งเป้าหมายลงในอุปกรณ์เคลื่อนที่ |
mod |
ค้นหากราฟทรัพยากร Dependency ภายนอกของ Bzlmod |
print_action |
พิมพ์อาร์กิวเมนต์บรรทัดคำสั่งสำหรับการคอมไพล์ไฟล์ |
query |
เรียกใช้การค้นหากราฟทรัพยากร Dependency |
run |
เรียกใช้เป้าหมายที่ระบุ |
shutdown |
หยุดเซิร์ฟเวอร์ Bazel |
sync |
ซิงค์ที่เก็บทั้งหมดที่ระบุไว้ในไฟล์พื้นที่ทำงาน |
test |
สร้างและเรียกใช้เป้าหมายทดสอบที่ระบุ |
vendor |
ดึงข้อมูลรีโพซิทอรีภายนอกไปยังโฟลเดอร์ที่ระบุโดยแฟล็ก --vendor_dir |
version |
พิมพ์ข้อมูลเวอร์ชันของ bazel |
ตัวเลือกการเริ่มต้น
- ตัวเลือกที่ปรากฏก่อนคําสั่งและได้รับการแยกวิเคราะห์โดยไคลเอ็นต์
--[no]autodetect_server_javabase
ค่าเริ่มต้น: "true"-
เมื่อผ่าน --noautodetect_server_javabase แล้ว Bazel จะไม่กลับไปใช้ JDK ในเครื่องเพื่อเรียกใช้เซิร์ฟเวอร์ bazel และออกแทน
แท็ก:affects_outputs
,loses_incremental_state
--[no]batch
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ระบบจะเรียกใช้ Bazel เป็นกระบวนการไคลเอ็นต์เท่านั้นโดยไม่มีเซิร์ฟเวอร์ แทนที่จะใช้โหมดไคลเอ็นต์/เซิร์ฟเวอร์มาตรฐาน เราเลิกใช้งานและจะนำตัวเลือกนี้ออกแล้ว โปรดปิดเซิร์ฟเวอร์อย่างชัดเจนหากไม่ต้องการให้เซิร์ฟเวอร์ทำงานอยู่
แท็ก:loses_incremental_state
,bazel_internal_configuration
,deprecated
- ค่าเริ่มต้น
--[no]batch_cpu_scheduling
: "เท็จ" -
ใช้ได้ใน Linux เท่านั้น ใช้การจัดตารางเวลา CPU แบบ "กลุ่ม" สำหรับ Blaze นโยบายนี้มีประโยชน์สำหรับเวิร์กโหลดที่ไม่มีการโต้ตอบ แต่ไม่ต้องการเปลี่ยนค่า Nice ดู "man 2 sched_setscheduler" หากเป็นเท็จ Bazel จะไม่เรียกใช้ระบบ
แท็ก:host_machine_resource_optimizations
--bazelrc=<path>
default: ดูคำอธิบาย-
ตำแหน่งของไฟล์ .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
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" ระบบจะบันทึกข้อมูลการแก้ไขข้อบกพร่องจากไคลเอ็นต์ไปยัง stderr การเปลี่ยนตัวเลือกนี้จะไม่ทําให้เซิร์ฟเวอร์รีสตาร์ท
แท็ก:affects_outputs
,bazel_monitoring
--connect_timeout_secs=<an integer>
ค่าเริ่มต้น: "30"-
ระยะเวลาที่ไคลเอ็นต์รอสําหรับแต่ละครั้งที่พยายามเชื่อมต่อกับเซิร์ฟเวอร์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--digest_function=<hash function>
: ดูคำอธิบาย -
ฟังก์ชันแฮชที่จะใช้เมื่อคํานวณข้อมูลสรุปไฟล์
แท็ก:loses_incremental_state
,bazel_internal_configuration
--[no]expand_configs_in_place
ค่าเริ่มต้น: "true"-
เปลี่ยนการขยาย Flag --config ให้ดำเนินการในตำแหน่งแทนการขยายจุดคงที่ระหว่างตัวเลือก rc ปกติกับตัวเลือกที่ระบุในบรรทัดคำสั่ง
แท็ก:no_op
,deprecated
--failure_detail_out=<path>
default: ดูคำอธิบาย-
หากตั้งค่าไว้ จะระบุตำแหน่งที่จะเขียนข้อความ protobuf ของ failure_detail หากเซิร์ฟเวอร์ประสบปัญหาและไม่สามารถรายงานผ่าน 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
ค่าเริ่มต้น: "false"-
ปิดใช้ไฟล์ rc ทั้งหมด โดยไม่คำนึงถึงค่าของ Flag อื่นๆ ที่แก้ไข rc แม้ว่า Flag เหล่านี้จะปรากฏในรายการตัวเลือกการเริ่มต้นภายหลังก็ตาม
แท็ก:changes_inputs
- ค่าเริ่มต้นของ
--io_nice_level={-1,0,1,2,3,4,5,6,7}
: "-1" -
ใช้ได้ใน Linux เท่านั้น ตั้งค่าระดับจาก 0-7 สำหรับการกําหนดเวลา IO ตามความพยายามที่ดีที่สุดโดยใช้คําเรียกระบบ sys_ioprio_set 0 คือลำดับความสำคัญสูงสุด 7 คือต่ำสุด ตัวจัดตารางเวลาแบบคาดการณ์จะดำเนินการตามลำดับความสำคัญสูงสุด 4 เท่านั้น หากตั้งเป็นค่าลบ Bazel จะไม่เรียกใช้ระบบ
แท็ก:host_machine_resource_optimizations
--local_startup_timeout_secs=<an integer>
ค่าเริ่มต้น: "120"-
ระยะเวลาสูงสุดที่ไคลเอ็นต์รอเชื่อมต่อกับเซิร์ฟเวอร์
แท็ก:bazel_internal_configuration
--macos_qos_class=<a string>
ค่าเริ่มต้น: "default"-
ตั้งค่าคลาสบริการ QoS ของเซิร์ฟเวอร์ bazel เมื่อใช้งานใน macOS Flag นี้ไม่มีผลกับแพลตฟอร์มอื่นๆ ทั้งหมด แต่รองรับเพื่อให้แชร์ไฟล์ rc กับแพลตฟอร์มเหล่านั้นได้โดยไม่ต้องทำการเปลี่ยนแปลง ค่าที่เป็นไปได้ ได้แก่ ผู้ใช้โต้ตอบ ผู้ใช้เริ่ม เริ่มต้น ยูทิลิตี และเบื้องหลัง
แท็ก:host_machine_resource_optimizations
--max_idle_secs=<integer>
ค่าเริ่มต้น: "10800"-
จำนวนวินาทีที่เซิร์ฟเวอร์บิลด์จะรอโดยไม่ทำงานก่อนที่จะปิด 0 หมายความว่าเซิร์ฟเวอร์จะไม่ปิดระบบเลย ระบบจะอ่านค่านี้เมื่อเซิร์ฟเวอร์เริ่มต้นเท่านั้น การเปลี่ยนแปลงตัวเลือกนี้จะไม่ทําให้เซิร์ฟเวอร์รีสตาร์ท
แท็ก:eagerness_to_exit
,loses_incremental_state
--output_base=<path>
default: ดูคำอธิบาย-
หากตั้งค่าไว้ จะระบุตำแหน่งเอาต์พุตที่จะเขียนเอาต์พุตทั้งหมดของบิลด์ มิเช่นนั้น ตำแหน่งจะเป็น ${OUTPUT_ROOT}/_blaze_${USER}/${MD5_OF_WORKSPACE_ROOT} หมายเหตุ: หากคุณระบุตัวเลือกอื่นสำหรับค่านี้ในการเรียกใช้ Bazel ครั้งถัดไป คุณอาจต้องเริ่มเซิร์ฟเวอร์ Bazel ใหม่อีกเครื่อง Bazel จะเริ่มต้นเซิร์ฟเวอร์ 1 เครื่องต่อฐานเอาต์พุตที่ระบุ โดยปกติแล้วจะมีฐานเอาต์พุต 1 ฐานต่อเวิร์กสเปซ แต่ตัวเลือกนี้จะช่วยให้คุณมีฐานเอาต์พุตหลายฐานต่อเวิร์กสเปซ และสามารถเรียกใช้บิลด์หลายรายการสำหรับลูกค้ารายเดียวกันในเครื่องเดียวกันพร้อมกันได้ ดูวิธีปิดเซิร์ฟเวอร์ Bazel ได้ที่ "bazel help shutdown"
แท็ก:affects_outputs
,loses_incremental_state
--output_user_root=<path>
default: ดูคำอธิบาย-
ไดเรกทอรีเฉพาะผู้ใช้ที่ระบบจะเขียนเอาต์พุตทั้งหมดของบิลด์ไว้ โดยค่าเริ่มต้น ไดเรกทอรีนี้เป็นฟังก์ชันของ $USER แต่การระบุค่าคงที่จะทำให้ผู้ใช้ที่ทำงานร่วมกันสามารถแชร์เอาต์พุตของบิลด์ได้
แท็ก:affects_outputs
,loses_incremental_state
--[no]preemptible
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" คำสั่งนี้อาจถูกขัดจังหวะชั่วคราวหากเริ่มใช้คำสั่งอื่น
แท็ก:eagerness_to_exit
--server_jvm_out=<path>
default: ดูคำอธิบาย-
ตำแหน่งที่จะเขียนเอาต์พุตของ JVM ของเซิร์ฟเวอร์ หากไม่ได้ตั้งค่า จะมีค่าเริ่มต้นเป็นตำแหน่งใน exit_base
แท็ก:affects_outputs
,loses_incremental_state
--[no]shutdown_on_low_sys_mem
ค่าเริ่มต้น: "false"-
หากตั้งค่า max_idle_secs และเซิร์ฟเวอร์บิลด์ไม่มีการใช้งานเป็นระยะเวลาหนึ่ง ให้ปิดเซิร์ฟเวอร์เมื่อระบบเหลือ RAM ต่ำ Linux เท่านั้น
แท็ก:eagerness_to_exit
,loses_incremental_state
--[no]system_rc
ค่าเริ่มต้น: "true"-
การค้นหา bazelrc ระดับระบบหรือไม่
แท็ก:changes_inputs
--[no]unlimit_coredumps
ค่าเริ่มต้น: "false"-
เพิ่มขีดจำกัดของไฟล์บันทึกข้อขัดข้องแบบอ่อนเป็นขีดจำกัดแบบแข็งเพื่อให้สามารถบันทึกข้อขัดข้องของเซิร์ฟเวอร์ (รวมถึง JVM) และไคลเอ็นต์ได้ในสภาพทั่วไป ใส่ Flag นี้ใน bazelrc เพียงครั้งเดียว แล้วไม่ต้องสนใจอีกต่อไปเพื่อให้คุณได้รับ coredump เมื่อพบเงื่อนไขที่ทริกเกอร์การทำงาน
แท็ก:bazel_internal_configuration
--[no]watchfs
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" 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>
รายการ - Flag ที่ส่งไปยัง JVM ที่เรียกใช้ Blaze
--host_jvm_debug
-
ตัวเลือกที่สะดวกในการเพิ่ม Flag การเริ่มต้น JVM เพิ่มเติม ซึ่งจะทำให้ JVM รอระหว่างการเริ่มต้นจนกว่าคุณจะเชื่อมต่อจากโปรแกรมแก้ไขข้อบกพร่องที่เป็นไปตามข้อกำหนด JDWP (เช่น Eclipse) กับพอร์ต 5005
ครอบคลุมถึง
--host_jvm_args=-Xdebug
--host_jvm_args=-Xrunjdwp:transport=dt_socket,server=y,address=5005
--host_jvm_profile=<profiler_name>
ค่าเริ่มต้น: ""- ตัวเลือกที่สะดวกในการเพิ่ม Flag การเริ่มต้น JVM สำหรับเครื่องมือวิเคราะห์ประสิทธิภาพ/โปรแกรมแก้ไขข้อบกพร่องบางรายการ Bazel มีรายการค่าที่รู้จักซึ่งแมปกับ Flag การเริ่มต้น JVM ที่เขียนมาอย่างหนัก ซึ่งอาจค้นหาเส้นทางที่เขียนมาอย่างหนักสำหรับไฟล์บางไฟล์
--server_javabase=<jvm path>
ค่าเริ่มต้น: ""- เส้นทางไปยัง JVM ที่ใช้เพื่อดำเนินการ Bazel
ตัวเลือกที่ใช้ได้กับคำสั่งทั้งหมด
- ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
--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
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
- ค่าเริ่มต้นของ
--experimental_ui_max_stdouterr_bytes=<an integer in (-1)-1073741819 range>
: "1048576" -
ขนาดสูงสุดของไฟล์ stdout / stderr ที่จะพิมพ์ลงในคอนโซล -1 หมายถึงไม่มีขีดจำกัด
แท็ก:execution
--[no]incompatible_remote_dangling_symlinks
ค่าเริ่มต้น: "true"-
หากตั้งค่าเป็น "จริง" ระบบจะอนุญาตให้ใช้ลิงก์สัญลักษณ์ที่อัปโหลดไปยังแคชระยะไกลหรือดิสก์
แท็ก:execution
,incompatible_change
--[no]incompatible_remote_symlinks
ค่าเริ่มต้น: "true"-
หากตั้งค่าเป็น "จริง" Bazel จะอัปโหลดลิงก์สัญลักษณ์ดังกล่าวไปยังแคชระยะไกลหรือดิสก์เสมอ มิเช่นนั้น ระบบจะอัปโหลดเฉพาะลิงก์สัญลักษณ์สัมพัทธ์ที่ไม่ใช่ลิงก์สัญลักษณ์สัมพัทธ์ที่ไม่มีการอ้างอิง (และเฉพาะลิงก์สัญลักษณ์สัมพัทธ์เหล่านั้น) เป็นไฟล์หรือไดเรกทอรีที่ลิงก์สัญลักษณ์สัมพัทธ์ชี้ไป
แท็ก:execution
,incompatible_change
- ตัวเลือกที่กําหนดค่าชุดเครื่องมือที่ใช้สําหรับการดําเนินการ
--[no]incompatible_enable_proto_toolchain_resolution
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" กฎภาษาโปรโตคอลจะกำหนดชุดเครื่องมือจากที่เก็บ rules_proto, 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>
ค่าเริ่มต้น: "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
- ตัวเลือกที่มีผลต่อความเคร่งครัดในการบังคับใช้อินพุตบิลด์ที่ถูกต้อง (เช่น คำจำกัดความของกฎ ชุดค่าผสม Flag ฯลฯ)
--[no]check_bzl_visibility
ค่าเริ่มต้น: "true"-
หากปิดใช้ ระบบจะลดระดับข้อผิดพลาดในการแสดงการโหลด .bzl ให้มีคำเตือน
แท็ก:build_file_semantics
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
--[no]enable_bzlmod
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ระบบจะเปิดใช้ระบบการจัดการทรัพยากร Dependency ของ Bzlmod ซึ่งจะมีความสำคัญเหนือกว่า WORKSPACE ดูข้อมูลเพิ่มเติมได้ที่ https://bazel.build/docs/bzlmod
แท็ก:loading_and_analysis
--[no]enable_workspace
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ระบบจะเปิดใช้ระบบ WORKSPACE รุ่นเดิมสําหรับทรัพยากรภายนอก ดูข้อมูลเพิ่มเติมได้ที่ 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 และ CPU 1 เครื่องโดยค่าเริ่มต้น
แท็ก:execution
,build_file_semantics
,experimental
- ค่าเริ่มต้น
--[no]experimental_bzl_visibility
: "จริง" -
หากเปิดใช้ ระบบจะเพิ่มฟังก์ชัน `visibility()` ที่ไฟล์ .bzl อาจเรียกใช้ในระหว่างการประเมินระดับบนสุดเพื่อตั้งค่าระดับการมองเห็นสำหรับวัตถุประสงค์ของคำสั่ง load()
แท็ก:loading_and_analysis
,experimental
-
หากตั้งค่าเป็น "จริง" แอตทริบิวต์กฎและเมธอด Starlark API ที่จําเป็นสําหรับกฎ cc_shared_library จะพร้อมใช้งาน
แท็ก:build_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_cc_static_library
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" แอตทริบิวต์ของกฎและเมธอด Starlark API ที่จําเป็นสําหรับกฎ cc_static_library จะพร้อมใช้งาน
แท็ก:build_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_disable_external_package
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" คุณจะใช้แพ็กเกจ //ภายนอกที่สร้างขึ้นโดยอัตโนมัติไม่ได้อีกต่อไป Bazel จะยังคงไม่สามารถแยกวิเคราะห์ไฟล์ "external/BUILD" ได้ แต่ Glob ที่เข้าถึง external/ จากแพ็กเกจที่ไม่มีชื่อจะใช้งานได้
แท็ก:loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]experimental_enable_android_migration_apis
: "เท็จ" -
หากตั้งค่าเป็น "จริง" ระบบจะเปิดใช้ API ที่จําเป็นสําหรับรองรับการย้ายข้อมูล Starlark ของ Android
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]experimental_enable_scl_dialect
: "เท็จ" -
หากตั้งค่าเป็น "จริง" ระบบอาจใช้ไฟล์ .scl ในคำสั่ง load()
แท็ก:build_file_semantics
--[no]experimental_google_legacy_api
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" ระบบจะแสดง 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
ค่าเริ่มต้น: "false"-
หากเปิดใช้ โมดูล experimental_java_library_export_do_not_use จะพร้อมใช้งาน
แท็ก:loading_and_analysis
,incompatible_change
--[no]experimental_platforms_api
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" ระบบจะเปิดใช้ Starlark API ที่เกี่ยวข้องกับแพลตฟอร์มหลายรายการที่เป็นประโยชน์สำหรับการแก้ไขข้อบกพร่อง
แท็ก:loading_and_analysis
,experimental
--[no]experimental_repo_remote_exec
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" Repository_rule จะมีความสามารถในการดำเนินการระยะไกลบางรายการ
แท็ก:build_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_sibling_repository_layout
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" ระบบจะฝังที่เก็บที่ไม่หลักเป็นลิงก์สัญลักษณ์ไปยังที่เก็บหลักในรูทการดําเนินการ กล่าวคือ ที่เก็บข้อมูลทั้งหมดเป็นไดเรกทอรีย่อยโดยตรงของไดเรกทอรี $output_base/execution_root ซึ่งจะส่งผลข้างเคียงในการเพิ่มพื้นที่ว่างใน $output_base/execution_root/__main__/external สำหรับไดเรกทอรี "external" ระดับบนสุดจริง
แท็ก:action_command_lines
,bazel_internal_configuration
,loading_and_analysis
,loses_incremental_state
,experimental
-
หากตั้งค่าเป็น "จริง" แท็กจะเผยแพร่จากเป้าหมายไปยังข้อกำหนดการดำเนินการของการดำเนินการ มิเช่นนั้นแท็กจะไม่เผยแพร่ ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/8830
แท็ก:build_file_semantics
,experimental
--[no]incompatible_always_check_depset_elements
ค่าเริ่มต้น: "true"-
ตรวจสอบความถูกต้องขององค์ประกอบที่เพิ่มลงใน depset ในคอนสตรัคเตอร์ทั้งหมด องค์ประกอบต้องเป็นแบบคงที่ แต่ที่ผ่านมาเครื่องมือสร้าง depset(direct=...) ลืมตรวจสอบ ใช้ทูเพลตแทนลิสต์ในองค์ประกอบ depset ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/10313
แท็ก:build_file_semantics
,incompatible_change
--incompatible_autoload_externally=<comma-separated set of options>
ค่าเริ่มต้น: ""-
รายการกฎ (หรือสัญลักษณ์อื่นๆ) ที่คั่นด้วยคอมมา ซึ่งก่อนหน้านี้เป็นส่วนหนึ่งของ Bazel และตอนนี้จะดึงมาจากที่เก็บข้อมูลภายนอกที่เกี่ยวข้อง Flag นี้มีไว้เพื่ออำนวยความสะดวกในการย้ายข้อมูลกฎออกจาก Bazel โปรดดูที่ https://github.com/bazelbuild/bazel/issues/23043
สัญลักษณ์ที่โหลดโดยอัตโนมัติภายในไฟล์จะทํางานเหมือนกับว่าคําจํากัดความใหม่ที่ถูกต้องในที่เก็บข้อมูลภายนอกมาแทนที่คําจํากัดความในตัวของ Bazel สำหรับไฟล์ BUILD สิ่งนี้หมายถึงการเพิ่มคำสั่ง request() โดยปริยาย สำหรับไฟล์ .bzl จะเป็นคำสั่ง load() หรือการเปลี่ยนแปลงช่องของออบเจ็กต์ "native" ทั้งนี้ขึ้นอยู่กับว่าสัญลักษณ์ที่โหลดอัตโนมัติเป็นกฎหรือไม่
Bazel ดูแลรักษารายการสัญลักษณ์ทั้งหมดที่กำหนดไว้อย่างเข้มงวดซึ่งอาจโหลดโดยอัตโนมัติ โดยจะมีเฉพาะสัญลักษณ์เหล่านั้นเท่านั้นที่ปรากฏใน Flag นี้ สำหรับสัญลักษณ์แต่ละรายการ Bazel จะทราบตำแหน่งคำจำกัดความใหม่ในที่เก็บข้อมูลภายนอก รวมถึงชุดที่เก็บข้อมูลแบบพิเศษที่ไม่ควรโหลดอัตโนมัติเพื่อหลีกเลี่ยงการสร้างวงจร
รายการ "+foo" ใน Flag นี้จะทำให้ระบบโหลดสัญลักษณ์ foo โดยอัตโนมัติ ยกเว้นในที่เก็บข้อมูลที่ยกเว้นของ foo ซึ่งยังมี foo เวอร์ชันที่ Bazel กำหนดไว้อยู่
รายการ "foo" จะทริกเกอร์การโหลดอัตโนมัติตามที่อธิบายไว้ข้างต้น แต่ที่เก็บข้อมูลที่ยกเว้นจะไม่สามารถใช้ foo เวอร์ชันที่ Bazel กำหนด วิธีนี้ช่วยให้มั่นใจว่าที่เก็บข้อมูลภายนอกของ foo จะไม่ขึ้นอยู่กับการใช้งาน foo ของ Bazel เวอร์ชันเก่า
รายการ "-foo" จะไม่ทริกเกอร์การโหลดอัตโนมัติ แต่จะทำให้เข้าถึง foo เวอร์ชันที่ Bazel กำหนดไว้ไม่ได้ทั่วทั้งเวิร์กスペース ซึ่งใช้เพื่อตรวจสอบว่าเวิร์กスペースพร้อมที่จะลบคําจํากัดความของ foo ออกจาก Bazel แล้ว
หากไม่ได้ตั้งชื่อสัญลักษณ์ใน Flag นี้ สัญลักษณ์จะยังคงทำงานตามปกติ ไม่มีการโหลดอัตโนมัติ และระบบจะไม่ระงับเวอร์ชันที่ Bazel กำหนด สำหรับการกำหนดค่า โปรดดูที่ https://github.com/bazelbuild/bazel/blob/master/src/main/java/com/google/devtools/build/lib/packages/AutoloadSymbols.java เนื่องจากทางลัดอาจใช้ที่เก็บทั้งหมดด้วย ตัวอย่างเช่น +@rules_python จะโหลดกฎ Python ทั้งหมดโดยอัตโนมัติ
แท็ก:loses_incremental_state
,build_file_semantics
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_depset_for_java_output_source_jars
: "true" -
เมื่อเป็นจริง Bazel จะไม่แสดงรายการจาก java_info.java_output[0].source_jars อีกต่อไป แต่แสดง depset แทน
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_depset_for_libraries_to_link_getter
ค่าเริ่มต้น: "true"-
เมื่อเป็นจริง Bazel จะไม่แสดงรายการจาก linking_context.libraries_to_link อีกต่อไป แต่แสดง depset แทน
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_disable_objc_library_transition
ค่าเริ่มต้น: "true"-
ปิดใช้ทรานซิชันที่กำหนดเองของ objc_library และรับค่าจากเป้าหมายระดับบนสุดแทน
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_disable_starlark_host_transitions
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" แอตทริบิวต์กฎจะตั้งค่า "cfg = "host"" ไม่ได้ กฎควรตั้งค่า "cfg = "exec"" แทน
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_disable_target_provider_fields
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" ระบบจะปิดใช้ความสามารถในการเข้าถึงผู้ให้บริการบนออบเจ็กต์ "เป้าหมาย" ผ่านไวยากรณ์ของช่อง ใช้ไวยากรณ์ provider-key แทน เช่น ใช้ `ctx.attr.dep[MyInfo]` แทนการใช้ `ctx.attr.dep.my_info` เพื่อเข้าถึง `my_info` จากภายในฟังก์ชันการใช้งานกฎ ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/9014
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_empty_glob
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" ค่าเริ่มต้นของอาร์กิวเมนต์ `allow_empty` ของ glob() จะเป็น False
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_struct_provider_syntax
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" ฟังก์ชันการใช้งานกฎอาจไม่แสดงผล Struct แต่จะแสดงรายการอินสแตนซ์ของผู้ให้บริการแทน
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_enable_deprecated_label_apis
ค่าเริ่มต้น: "true"-
หากเปิดใช้ ระบบจะใช้ API บางรายการที่เลิกใช้งานไปแล้วได้ (native.repository_name, Label.workspace_name, Label.relative)
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]incompatible_existing_rules_immutable_view
: "true" -
หากตั้งค่าเป็น "จริง" ตัวแปร native.existing_rule และ native.existing_rules จะแสดงผลออบเจ็กต์มุมมองแบบคงที่ที่มีน้ำหนักเบาแทนพจนานุกรมแบบเปลี่ยนแปลงได้
แท็ก:build_file_semantics
,loading_and_analysis
,incompatible_change
--[no]incompatible_fail_on_unknown_attributes
ค่าเริ่มต้น: "true"-
หากเปิดใช้ เป้าหมายที่มีการตั้งค่าแอตทริบิวต์ที่ไม่รู้จักเป็น "ไม่มี" จะดำเนินการไม่สำเร็จ
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_fix_package_group_reporoot_syntax
ค่าเริ่มต้น: "true"-
ในแอตทริบิวต์ "packages" ของpackage_group ให้เปลี่ยนความหมายของค่า "//..." เพื่ออ้างถึงแพ็กเกจทั้งหมดในที่เก็บปัจจุบัน แทนแพ็กเกจทั้งหมดในที่เก็บ คุณสามารถใช้ค่าพิเศษ "public" แทน "//..." เพื่อให้ได้ลักษณะการทำงานแบบเก่า ธงนี้กำหนดให้ต้องเปิดใช้ --incompatible_package_group_has_public_syntax ด้วย
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_java_common_parameters
ค่าเริ่มต้น: "true"-
หากตั้งค่าเป็น "จริง" ระบบจะนำพารามิเตอร์ exit_jar และ host_javabase ใน pack_sources และ host_javabase ในคอมไพล์ ออกทั้งหมด
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_merge_fixed_and_default_shell_env
ค่าเริ่มต้น: "true"-
หากเปิดใช้ การดำเนินการที่ลงทะเบียนด้วย ctx.actions.run และ ctx.actions.run_shell โดยระบุทั้ง "env" และ "use_default_shell_env = True" จะใช้สภาพแวดล้อมที่ได้มาจากสภาพแวดล้อมเชลล์เริ่มต้นโดยการลบล้างด้วยค่าที่ส่งไปยัง "env" หากปิดใช้ ระบบจะไม่สนใจค่า "env" เลยในกรณีนี้
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
ค่าเริ่มต้น: "true"-
หากตั้งค่าเป็น "จริง" API สำหรับสร้างการดำเนินการจะพร้อมใช้งานใน "ctx.actions" เท่านั้น และจะใช้กับ "ctx" ไม่ได้
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_no_attr_license
ค่าเริ่มต้น: "true"-
หากตั้งค่าเป็น "จริง" ระบบจะปิดใช้ฟังก์ชัน "attr.license"
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_no_implicit_file_export
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ไฟล์ต้นฉบับ (ที่ใช้แล้ว) จะเป็นแพ็กเกจส่วนตัว เว้นแต่จะมีการส่งออกอย่างชัดเจน ดู https://github.com/bazelbuild/proposals/blob/master/designs/2019-10-24-file-visibility.md
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_no_implicit_watch_label
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" เมธอดใน <code>repository_ctx</code> ที่ส่งผ่านป้ายกำกับจะไม่ดูไฟล์ภายใต้ป้ายกำกับนั้นโดยอัตโนมัติเพื่อดูการเปลี่ยนแปลงแม้ว่า <code>watch = "no"</code> และ <code>repository_ctx.path</code> จะไม่ทำให้มีการดูเส้นทางที่ส่งกลับอีกต่อไป โปรดใช้ <code>repository_ctx.watch</code> แทน
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_no_rule_outputs_param
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" ระบบจะปิดใช้พารามิเตอร์ "outputs" ของฟังก์ชัน Starlark "rule()"
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_objc_provider_remove_linking_info
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" ระบบจะนำ API ของ ObjcProvider สำหรับข้อมูลการลิงก์ออก
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_package_group_has_public_syntax
ค่าเริ่มต้น: "true"-
ในแอตทริบิวต์ "packages" ของ package_group อนุญาตให้เขียน "public" หรือ "private" เพื่ออ้างอิงถึงแพ็กเกจทั้งหมดหรือไม่มีแพ็กเกจตามลำดับ
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_require_linker_input_cc_api
ค่าเริ่มต้น: "true"-
หากตั้งค่าเป็น "จริง" กฎ create_linking_context จะกำหนดให้ต้องใช้ linker_inputs แทน libraries_to_link ระบบจะปิดเครื่องมือดึงข้อมูลเก่าของลิงก์_context ด้วยและมีเพียง linker_inputs เท่านั้นที่จะใช้งานได้
แท็ก:build_file_semantics
,loading_and_analysis
,incompatible_change
--[no]incompatible_run_shell_command_string
ค่าเริ่มต้น: "true"-
หากตั้งค่าเป็น "จริง" พารามิเตอร์คําสั่งของ actions.run_shell จะยอมรับเฉพาะสตริงเท่านั้น
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_stop_exporting_language_modules
ค่าเริ่มต้น: "false"-
หากเปิดใช้ โมดูลเฉพาะบางภาษา (เช่น `cc_common`) จะใช้งานไม่ได้ในไฟล์ .bzl ของผู้ใช้ และเรียกใช้ได้เฉพาะจากที่เก็บกฎที่เกี่ยวข้องเท่านั้น
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_struct_has_no_methods
: "เท็จ" -
ปิดใช้เมธอด to_json และ to_protocol ของ Struct ซึ่งทําให้เนมสเปซของช่อง Struct เสียไป แต่ให้ใช้ json.encode หรือ json.encode_indent สำหรับ JSON หรือ proto.encode_text สำหรับ textproto
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_top_level_aspects_require_providers
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" การแสดงผลระดับบนสุดจะยึดตามผู้ให้บริการที่จำเป็นและจะทำงานในเป้าหมายระดับบนสุดที่มีผู้ให้บริการซึ่งโฆษณาของกฎตรงกับผู้ให้บริการของด้านนั้นๆ เท่านั้น
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_unambiguous_label_stringification
ค่าเริ่มต้น: "true"-
เมื่อเป็นจริง Bazel จะเปลี่ยนป้ายกำกับ @//foo:bar เป็นสตริง @//foo:bar แทน //foo:bar ซึ่งจะมีผลต่อลักษณะการทํางานของ str(), ตัวดำเนินการ % และอื่นๆ เท่านั้น ส่วนลักษณะการทํางานของ repr() จะไม่มีการเปลี่ยนแปลง ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/15916
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_use_cc_configure_from_rules_cc
: "เท็จ" -
เมื่อเป็นจริง Bazel จะไม่อนุญาตให้ใช้ cc_configure จาก @bazel_tools อีกต่อไป โปรดดูรายละเอียดและวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/10134
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_use_plus_in_repo_names
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" ให้ใช้เครื่องหมายบวก (+) เป็นตัวคั่นในชื่อที่เก็บ Canonical แทนเครื่องหมายทิลเดอ (~) วิธีแก้ปัญหาร้ายแรงด้านประสิทธิภาพใน Windows ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/22865
แท็ก:loading_and_analysis
--[no]incompatible_visibility_private_attributes_at_definition
ค่าเริ่มต้น: "true"-
หากตั้งค่าเป็น "จริง" ระบบจะตรวจสอบระดับการมองเห็นแอตทริบิวต์กฎส่วนตัวตามคําจํากัดความของกฎ และจะกลับไปใช้การใช้งานกฎหากไม่เห็น
แท็ก:build_file_semantics
,incompatible_change
- ค่าเริ่มต้น
--max_computation_steps=<a long integer>
: "0" -
จำนวนขั้นตอนการคำนวณ Starlark สูงสุดที่ไฟล์ BUILD ดําเนินการได้ (0 หมายถึงไม่จํากัด)
แท็ก:build_file_semantics
--nested_set_depth_limit=<an integer>
ค่าเริ่มต้น: "3500"-
ความลึกสูงสุดของกราฟภายใน depset (หรือที่เรียกว่า NestedSet) ซึ่งค่าที่สูงกว่านี้จะทำให้ตัวสร้าง depset() ทำงานไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--repositories_without_autoloads=<comma-separated set of options>
: "" -
รายการของที่เก็บเพิ่มเติม (นอกเหนือจากที่ Bazel รู้จัก) ซึ่งจะไม่เพิ่มการโหลดอัตโนมัติ โดยปกติแล้ว รายการนี้ควรมีที่เก็บข้อมูลที่ที่เก็บข้อมูลอื่นอาจโหลดโดยอัตโนมัติต้องอาศัย (และอาจทำให้เกิดวงจร)
แท็ก:loses_incremental_state
,build_file_semantics
,incompatible_change
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพเวลาบิลด์มีดังนี้
--[no]heuristically_drop_nodes
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" Blaze จะนำโหนด FileState และ DirectoryListingState ออกหลังจากที่โหนด File และ DirectoryListing ที่เกี่ยวข้องเสร็จสิ้นเพื่อประหยัดหน่วยความจำ เราคาดว่าจะไม่จำเป็นต้องใช้โหนดเหล่านี้อีก หากเป็นเช่นนั้น โปรแกรมจะทำการประเมินอีกครั้ง
แท็ก:loses_incremental_state
--[no]incompatible_do_not_split_linking_cmdline
ค่าเริ่มต้น: "true"-
เมื่อเป็นจริง Bazel จะไม่แก้ไข Flag บรรทัดคำสั่งที่ใช้สำหรับการลิงก์อีกต่อไป และจะไม่เลือก Flag ที่จะส่งไปยังไฟล์ param และ Flag ที่จะไม่ส่ง ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7670
แท็ก:loading_and_analysis
,incompatible_change
--[no]keep_state_after_build
ค่าเริ่มต้น: "true"-
หากเป็นเท็จ Blaze จะทิ้งสถานะในหน่วยความจําจากบิลด์นี้เมื่อบิลด์เสร็จสมบูรณ์ บิลด์ที่ตามมาจะไม่มีการเพิ่มประสิทธิภาพใดๆ กับบิลด์นี้
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--[no]track_incremental_state
: "จริง" -
หากเป็นเท็จ Blaze จะไม่เก็บข้อมูลไว้ซึ่งช่วยให้สามารถทำให้ข้อมูลเป็นโมฆะและประเมินอีกครั้งในบิลด์ที่เพิ่มขึ้นเพื่อประหยัดหน่วยความจำในบิลด์นี้ บิลด์ที่ตามมาจะไม่มีการเพิ่มประสิทธิภาพใดๆ กับบิลด์นี้ โดยปกติแล้ว คุณจะต้องระบุ --batch เมื่อตั้งค่านี้เป็น "เท็จ"
แท็ก:loses_incremental_state
- ตัวเลือกที่ส่งผลต่อรายละเอียด รูปแบบ หรือตำแหน่งของการบันทึก
--[no]announce_rc
ค่าเริ่มต้น: "false"-
เลือกว่าจะประกาศตัวเลือก rc หรือไม่
แท็ก:affects_outputs
--[no]attempt_to_print_relative_paths
ค่าเริ่มต้น: "false"-
เมื่อพิมพ์ส่วนที่เป็นตำแหน่งของข้อความ ให้พยายามใช้เส้นทางที่สัมพันธ์กับไดเรกทอรีของพื้นที่ทำงานหรือไดเรกทอรีใดไดเรกทอรีหนึ่งที่ระบุโดย --package_path
แท็ก:terminal_output
--bes_backend=<a string>
ค่าเริ่มต้น: ""-
ระบุปลายทางแบ็กเอนด์ของบริการเหตุการณ์การสร้าง (BES) ในรูปแบบ [SCHEME://]HOST[:PORT] ค่าเริ่มต้นคือปิดใช้งานการอัปโหลด BES สคีมที่รองรับ ได้แก่ grpc และ grpcs (grpc ที่เปิดใช้ TLS) หากไม่ได้ระบุรูปแบบไว้ Bazel จะถือว่า grpcs
แท็ก:affects_outputs
--[no]bes_check_preceding_lifecycle_events
ค่าเริ่มต้น: "false"-
ตั้งค่าช่อง check_preceding_lifecycle_events_present ใน PublishBuildToolEventStreamRequest ซึ่งบอก BES ให้ตรวจสอบว่าก่อนหน้านี้ได้รับเหตุการณ์ InvocationAttemptStarted และ BuildEnqueued ที่ตรงกับเหตุการณ์เครื่องมือปัจจุบันหรือไม่
แท็ก:affects_outputs
--bes_header=<a 'name=value' assignment>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุส่วนหัวในรูปแบบ NAME=VALUE ที่รวมอยู่ในคําขอ BES สามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าที่มีชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
แท็ก:affects_outputs
--bes_instance_name=<a string>
default: ดูคำอธิบาย-
ระบุชื่ออินสแตนซ์ที่ BES จะเก็บ BEP ที่อัปโหลดไว้ ค่าเริ่มต้นคือ null
แท็ก:affects_outputs
--bes_keywords=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุรายการคีย์เวิร์ดสำหรับการแจ้งเตือนที่จะเพิ่มชุดคีย์เวิร์ดเริ่มต้นที่เผยแพร่ใน BES ("command_name=<command_name> ", "protocol_name=BEP") ค่าเริ่มต้นคือไม่มี
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]bes_lifecycle_events
: "จริง" -
ระบุว่าจะเผยแพร่เหตุการณ์ในวงจรของ BES หรือไม่ (มีค่าเริ่มต้นเป็น "จริง")
แท็ก:affects_outputs
--bes_oom_finish_upload_timeout=<An immutable length of time.>
ค่าเริ่มต้น: "10m"-
ระบุระยะเวลาที่ Bazel ควรรอให้อัปโหลด BES/BEP จนเสร็จสมบูรณ์ขณะที่ระบบหน่วยความจำไม่เพียงพอ Flag นี้ช่วยให้มั่นใจได้ว่าระบบจะสิ้นสุดการทำงานเมื่อ 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>
default: ดูคำอธิบาย- เชื่อมต่อกับบริการเหตุการณ์การสร้างผ่านพร็อกซี ปัจจุบัน 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" -
ระบุระยะเวลาที่ Bazel ควรรอให้อัปโหลด 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
: "จริง" -
แปลงเส้นทางในการนําเสนอไฟล์ไบนารีของโปรโตคอลเหตุการณ์การสร้างเป็น URI ที่ใช้งานได้ทั่วโลกมากขึ้นทุกครั้งที่เป็นไปได้ หากปิดใช้ ระบบจะใช้รูปแบบ URI file:// เสมอ
แท็ก: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 ที่ใช้งานได้ทั่วโลกมากขึ้นเมื่อเป็นไปได้ หากปิดใช้ ระบบจะใช้รูปแบบ URI file:// เสมอ
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--build_event_json_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
: "wait_for_upload_complete" -
ระบุว่าการอัปโหลดบริการ Build Event สำหรับ --build_event_json_file ควรบล็อกการสร้างเสร็จสมบูรณ์หรือควรสิ้นสุดการเรียกใช้ทันที แล้วดำเนินการอัปโหลดในเบื้องหลังให้เสร็จสิ้น "wait_for_upload_complete" (ค่าเริ่มต้น), "nowait_for_upload_complete" หรือ "fully_async"
แท็ก:eagerness_to_exit
- ค่าเริ่มต้นของ
--build_event_max_named_set_of_file_entries=<an integer>
: "-1" -
จํานวนรายการสูงสุดสําหรับเหตุการณ์ named_set_of_files รายการเดียว ระบบจะไม่สนใจค่าที่น้อยกว่า 2 และไม่แยกเหตุการณ์ ซึ่งมีไว้เพื่อจํากัดขนาดเหตุการณ์สูงสุดในโปรโตคอลเหตุการณ์ของบิลด์ แม้ว่าจะไม่ควบคุมขนาดเหตุการณ์โดยตรงก็ตาม ขนาดเหตุการณ์ทั้งหมดขึ้นอยู่กับโครงสร้างของชุด รวมถึงความยาวของไฟล์และ URI ซึ่งอาจขึ้นอยู่กับฟังก์ชันแฮช
แท็ก:affects_outputs
--[no]build_event_publish_all_actions
ค่าเริ่มต้น: "false"-
ว่าควรเผยแพร่การดำเนินการทั้งหมดไหม
แท็ก:affects_outputs
- ค่าเริ่มต้น
--build_event_text_file=<a string>
: "" -
หากไม่ใช่ค่าว่าง ให้เขียนการนําเสนอแบบข้อความของโปรโตคอลเหตุการณ์การสร้างลงในไฟล์นั้น
แท็ก:affects_outputs
--[no]build_event_text_file_path_conversion
ค่าเริ่มต้น: "true"-
แปลงเส้นทางในการนําเสนอไฟล์ข้อความของโปรโตคอลเหตุการณ์การสร้างเป็น URI ที่ใช้งานได้ทั่วโลกมากขึ้นทุกครั้งที่เป็นไปได้ หากปิดใช้ ระบบจะใช้รูปแบบ URI file:// เสมอ
แท็ก: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_text_file ควรบล็อกการสร้างให้เสร็จสมบูรณ์ หรือควรสิ้นสุดการเรียกใช้ทันทีและอัปโหลดให้เสร็จสมบูรณ์ในเบื้องหลัง "wait_for_upload_complete" (ค่าเริ่มต้น), "nowait_for_upload_complete" หรือ "fully_async"
แท็ก:eagerness_to_exit
--[no]experimental_announce_profile_path
ค่าเริ่มต้น: "false"-
หากเปิดใช้ ให้เพิ่มเส้นทางโปรไฟล์ JSON ลงในบันทึก
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--[no]experimental_bep_target_summary
: "เท็จ" - ระบุว่าจะเผยแพร่เหตุการณ์ TargetSummary หรือไม่
--[no]experimental_build_event_expand_filesets
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" ระบบจะขยายชุดไฟล์ใน BEP เมื่อแสดงไฟล์เอาต์พุต
แท็ก:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" ระบบจะแก้ไขลิงก์สัญลักษณ์ของไฟล์ชุดที่เกี่ยวข้องใน BEP โดยสมบูรณ์เมื่อแสดงไฟล์เอาต์พุต ต้องใช้ --experimental_build_event_expand_filesets
แท็ก:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
ค่าเริ่มต้น: "4"-
จำนวนครั้งที่ Bazel ควรลองอัปโหลดเหตุการณ์การสร้างอีกครั้งสูงสุด
แท็ก:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
ค่าเริ่มต้น: "1s"-
ความล่าช้าขั้นต่ำเริ่มต้นสำหรับการลองอีกครั้งแบบ Exponential Backoff เมื่อการอัปโหลด BEP ไม่สำเร็จ (exponent: 1.6)
แท็ก:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
default: ดูคำอธิบาย-
เลือกวิธีอัปโหลดอาร์ติแฟกต์ที่อ้างอิงในโปรโตคอลเหตุการณ์การสร้าง
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_collect_load_average_in_profiler
: "จริง" -
หากเปิดใช้ เครื่องมือวิเคราะห์จะรวบรวมค่าเฉลี่ยภาระงานโดยรวมของระบบ
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--[no]experimental_collect_pressure_stall_indicators
: "เท็จ" -
หากเปิดใช้ เครื่องมือวิเคราะห์จะรวบรวมข้อมูล PSI ของ Linux
แท็ก:bazel_monitoring
--[no]experimental_collect_resource_estimation
ค่าเริ่มต้น: "false"-
หากเปิดใช้ เครื่องมือสร้างโปรไฟล์จะรวบรวมการประมาณการใช้งาน CPU และหน่วยความจำสำหรับการกระทำเกี่ยวกับสถานที่
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--[no]experimental_collect_system_network_usage
: "เท็จ" -
หากเปิดใช้ เครื่องมือสร้างโปรไฟล์จะรวบรวมการใช้งานเครือข่ายของระบบ
แท็ก:bazel_monitoring
--[no]experimental_collect_worker_data_in_profiler
ค่าเริ่มต้น: "false"-
หากเปิดใช้ เครื่องมือวิเคราะห์จะรวบรวมข้อมูลทรัพยากรที่รวบรวมไว้ของผู้ใช้
แท็ก:bazel_monitoring
--experimental_profile_additional_tasks=<phase, action, action_check, action_lock, action_release, action_update, action_complete, bzlmod, info, create_package, remote_execution, local_execution, scanner, local_parse, upload_time, remote_process_time, remote_queue, remote_setup, fetch, local_process_time, vfs_stat, vfs_dir, vfs_readlink, vfs_md5, vfs_xattr, vfs_delete, vfs_open, vfs_read, vfs_write, vfs_glob, vfs_vmfs_stat, vfs_vmfs_dir, vfs_vmfs_read, wait, thread_name, thread_sort_index, skyframe_eval, skyfunction, critical_path, critical_path_component, handle_gc_notification, action_counts, action_cache_counts, local_cpu_usage, system_cpu_usage, cpu_usage_estimation, local_memory_usage, system_memory_usage, memory_usage_estimation, system_network_up_usage, system_network_down_usage, workers_memory_usage, system_load_average, starlark_parser, starlark_user_fn, starlark_builtin_fn, starlark_user_compiled_fn, starlark_repository_fn, action_fs_staging, remote_cache_check, remote_download, remote_network, filesystem_traversal, worker_execution, worker_setup, worker_borrow, worker_working, worker_copying_outputs, credential_helper, pressure_stall_io, pressure_stall_memory, conflict_check, dynamic_lock, repository_fetch, repository_vendor or unknown>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุงานเพิ่มเติมเกี่ยวกับโปรไฟล์ที่จะรวมไว้ในโปรไฟล์
แท็ก:bazel_monitoring
--[no]experimental_profile_include_primary_output
ค่าเริ่มต้น: "false"-
รวมแอตทริบิวต์ "out" เพิ่มเติมในเหตุการณ์การดำเนินการซึ่งมีเส้นทางการดําเนินการไปยังเอาต์พุตหลักของการดำเนินการ
แท็ก:bazel_monitoring
--[no]experimental_profile_include_target_label
ค่าเริ่มต้น: "false"-
รวมป้ายกํากับเป้าหมายในข้อมูลโปรไฟล์ JSON ของเหตุการณ์การกระทํา
แท็ก:bazel_monitoring
--[no]experimental_run_bep_event_include_residue
ค่าเริ่มต้น: "false"-
ต้องการรวมส่วนที่เหลือของบรรทัดคำสั่งในเหตุการณ์บิลด์ที่อาจมีส่วนที่เหลือหรือไม่ โดยค่าเริ่มต้น ข้อมูลที่เหลือจะไม่รวมอยู่ในเหตุการณ์การสร้างคําสั่งการเรียกใช้ที่อาจมีข้อมูลที่เหลืออยู่
แท็ก:affects_outputs
--[no]experimental_stream_log_file_uploads
ค่าเริ่มต้น: "false"-
สตรีมการอัปโหลดไฟล์บันทึกไปยังพื้นที่เก็บข้อมูลระยะไกลโดยตรงแทนที่จะเขียนลงในดิสก์
แท็ก: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
ค่าเริ่มต้น: "false"-
กำหนดว่าจะแสดงผลข้อมูลพะเนินการของกองขยะด้วยตนเองหรือไม่หากระบบแสดงข้อผิดพลาด OOM (รวมถึง OOM ที่แสดงขึ้นด้วยตนเองเนื่องจากถึงขีดจำกัด --gc_thrashing_limits) ระบบจะเขียน Dump ไปยัง <output_base>/<invocation_id>.heapdump.hprof ตัวเลือกนี้ใช้แทน -XX:+HeapDumpOnOutOfMemoryError อย่างมีประสิทธิภาพ ซึ่งจะไม่มีผลกับ OOM ที่กำหนดเอง
แท็ก:bazel_monitoring
--[no]legacy_important_outputs
ค่าเริ่มต้น: "true"-
ใช้เพื่อระงับการสร้างช่อง important_outputs แบบเดิมในเหตุการณ์ TargetComplete โดยต้องใช้ important_outputs ในการผสานรวม Bazel กับ ResultStore
แท็ก:affects_outputs
--logging=<0 <= an integer <= 6>
ค่าเริ่มต้น: "3"-
ระดับการบันทึก
แท็ก:affects_outputs
--memory_profile=<a path>
default: ดูคำอธิบาย-
หากตั้งค่าแล้ว ให้เขียนข้อมูลการใช้งานหน่วยความจำไปยังไฟล์ที่ระบุเมื่อสิ้นสุดเฟสและฮีปที่เสถียรในบันทึกหลักเมื่อสิ้นสุดบิลด์
แท็ก: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 วินาที ตามด้วย GC 4 รายการที่มีการหยุดชั่วคราว 0 วินาที
แท็ก:bazel_monitoring
--profile=<a path>
default: ดูคำอธิบาย-
หากตั้งค่าไว้ ระบบจะโปรไฟล์ Bazel และเขียนข้อมูลลงในไฟล์ที่ระบุ ใช้โปรไฟล์การวิเคราะห์ bazel เพื่อวิเคราะห์โปรไฟล์
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--[no]record_full_profiler_data
: "เท็จ" -
โดยค่าเริ่มต้น เครื่องมือวิเคราะห์ประสิทธิภาพของ Bazel จะบันทึกเฉพาะข้อมูลที่รวบรวมไว้สําหรับเหตุการณ์ที่รวดเร็วแต่มีจํานวนมาก (เช่น การแสดงสถิติของไฟล์) หากเปิดใช้ตัวเลือกนี้ เครื่องมือวิเคราะห์จะบันทึกเหตุการณ์แต่ละรายการ ซึ่งส่งผลให้ข้อมูลการโปรไฟล์แม่นยํามากขึ้น แต่ประสิทธิภาพจะลดลงอย่างมาก ตัวเลือกจะมีผลก็ต่อเมื่อมีการใช้ --profile ด้วย
แท็ก:bazel_monitoring
--remote_print_execution_messages=<failure, success or all>
ค่าเริ่มต้น: "failure"-
เลือกเวลาที่จะพิมพ์ข้อความการดําเนินการจากระยะไกล ค่าที่ใช้ได้คือ "ล้มเหลว" หากต้องการพิมพ์เมื่อล้มเหลวเท่านั้น "สำเร็จ" เพื่อพิมพ์เฉพาะเมื่อสำเร็จ และ "ทั้งหมด" เพื่อพิมพ์เสมอ
แท็ก:terminal_output
--[no]slim_profile
ค่าเริ่มต้น: "true"-
ลดขนาดของโปรไฟล์ JSON ลงโดยการรวมเหตุการณ์หากโปรไฟล์มีขนาดใหญ่เกินไป
แท็ก:bazel_monitoring
--starlark_cpu_profile=<a string>
ค่าเริ่มต้น: ""-
เขียนโปรไฟล์ pprof ของการใช้งาน CPU ของเทรด Starlark ทั้งหมดลงในไฟล์ที่ระบุ
แท็ก:bazel_monitoring
--tool_tag=<a string>
ค่าเริ่มต้น: ""-
ชื่อเครื่องมือที่จะระบุแหล่งที่มาของการเรียกใช้ Bazel นี้
แท็ก:affects_outputs
,bazel_monitoring
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ui_event_filters=<Convert list of comma separated event kind to list of filters>
รายการ -
ระบุเหตุการณ์ที่จะแสดงใน UI คุณสามารถเพิ่มหรือนําเหตุการณ์ออกจากเหตุการณ์เริ่มต้นได้โดยใช้เครื่องหมาย +/- นําหน้า หรือลบล้างชุดเริ่มต้นทั้งหมดด้วยการกําหนดค่าโดยตรง ชุดประเภทเหตุการณ์ที่รองรับ ได้แก่ INFO, DEBUG, ERROR และอื่นๆ
แท็ก:terminal_output
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล
- ค่าเริ่มต้น
--experimental_circuit_breaker_strategy=<failure>
: ดูคำอธิบาย -
ระบุกลยุทธ์ที่จะใช้กับตัวตัดวงจร กลยุทธ์ที่ใช้ได้คือ "failure" เมื่อค่าของตัวเลือกไม่ถูกต้อง ระบบจะไม่ตั้งค่าลักษณะการทำงานเหมือนกับตัวเลือก
แท็ก:execution
--[no]experimental_guard_against_concurrent_changes
ค่าเริ่มต้น: "false"- ปิดการตั้งค่านี้เพื่อปิดใช้การตรวจสอบเวลาของไฟล์อินพุตของการดำเนินการก่อนอัปโหลดไปยังแคชระยะไกล อาจมีกรณีที่เคอร์เนล 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
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" Bazel จะขยายระยะเวลาเช่าสำหรับเอาต์พุตของการดำเนินการระยะไกลระหว่างการสร้างโดยการส่งการเรียก `FindMissingBlobs` ไปยังแคชระยะไกลเป็นระยะๆ ความถี่จะอิงตามค่าของ "--experimental_remote_cache_ttl"
--experimental_remote_cache_ttl=<An immutable length of time.>
ค่าเริ่มต้น: "3h"-
TTL ขั้นต่ำที่รับประกันของ Blob ในแคชระยะไกลหลังจากที่มีการอ้างอิงข้อมูลสรุปล่าสุด เช่น โดย ActionResult หรือ FindMissingBlobs Bazel ทำการเพิ่มประสิทธิภาพหลายอย่างตาม TTL ของ Blob เช่น ไม่เรียก GetActionResult ซ้ำๆ ในบิลด์แบบเพิ่ม คุณควรตั้งค่าให้น้อยกว่า TTL จริงเล็กน้อย เนื่องจากมีช่วงเวลาระหว่างที่เซิร์ฟเวอร์แสดงผลข้อมูลสรุปและเวลาที่ Bazel ได้รับข้อมูลสรุป
แท็ก:execution
--experimental_remote_capture_corrupted_outputs=<a path>
default: ดูคำอธิบาย- เส้นทางไปยังไดเรกทอรีที่จะบันทึกเอาต์พุตที่เสียหาย
- ค่าเริ่มต้น
--[no]experimental_remote_discard_merkle_trees
: "เท็จ" - หากตั้งค่าเป็น "จริง" ให้ทิ้งสำเนาในหน่วยความจำของโครงสร้าง Merkle ของรูทอินพุตและการแมปอินพุตที่เกี่ยวข้องระหว่างการเรียก GetActionResult() และ Execute() ซึ่งช่วยลดการใช้หน่วยความจำได้อย่างมาก แต่ Bazel จะต้องคำนวณใหม่เมื่อแคชระยะไกลหายไปหรือลองใหม่
--experimental_remote_downloader=<a string>
default: ดูคำอธิบาย- URI ปลายทางของ Remote Asset API เพื่อใช้เป็นพร็อกซีการดาวน์โหลดระยะไกล สคีมาที่รองรับ ได้แก่ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ unix (ซ็อกเก็ต UNIX ในพื้นที่) หากไม่ได้ระบุสคีมา Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ดูที่ https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
ค่าเริ่มต้น: "false"- Whether to fall back to the local downloader if remote downloader fails.
--[no]experimental_remote_execution_keepalive
ค่าเริ่มต้น: "false"- ใช้ Keepalive สําหรับการเรียกใช้การดําเนินการจากระยะไกลหรือไม่
- ค่าเริ่มต้น
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
: "10" -
กำหนดจำนวนอัตราความล้มเหลวที่อนุญาตเป็นเปอร์เซ็นต์สำหรับกรอบเวลาหนึ่งๆ แล้วระบบจะหยุดเรียกใช้แคช/ผู้ดำเนินการระยะไกล โดยค่าเริ่มต้น ค่านี้คือ 10 การตั้งค่านี้เป็น 0 หมายความว่าไม่มีข้อจํากัด
แท็ก:execution
- ค่าเริ่มต้นของ
--experimental_remote_failure_window_interval=<An immutable length of time.>
: "60 วินาที" -
ช่วงเวลาที่มีการคำนวณอัตราความล้มเหลวของคำขอระยะไกล เมื่อค่าเป็น 0 หรือติดลบ ระบบจะคํานวณระยะเวลาที่ดำเนินการไม่สําเร็จเป็นระยะเวลาทั้งหมดของการดำเนินการ คุณสามารถใช้หน่วยต่อไปนี้ได้ ได้แก่ วัน (d) ชั่วโมง (h) นาที (m) วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
แท็ก:execution
--[no]experimental_remote_mark_tool_inputs
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" Bazel จะทําเครื่องหมายอินพุตเป็นอินพุตเครื่องมือสําหรับผู้ดําเนินการระยะไกล โดยใช้ข้อมูลนี้เพื่อใช้งานผู้ปฏิบัติงานที่ทำงานถาวรจากระยะไกลได้
--[no]experimental_remote_merkle_tree_cache
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" ระบบจะจดจําการคํานวณต้นไม้ Merkle เพื่อปรับปรุงความเร็วในการตรวจสอบการทํางานของแคชระยะไกล ปริมาณหน่วยความจําของแคชจะควบคุมโดย --experimental_remote_merkle_tree_cache_size
--experimental_remote_merkle_tree_cache_size=<a long integer>
ค่าเริ่มต้น: "1000"- จำนวนต้น Merkle ที่ต้องบันทึกเพื่อปรับปรุงความเร็วในการตรวจสอบการเข้าถึงแคชระยะไกล แม้ว่าระบบจะตัดแคชออกโดยอัตโนมัติตามการจัดการการอ้างอิงแบบอ่อนของ Java แต่ข้อผิดพลาดหน่วยความจําไม่เพียงพอก็อาจเกิดขึ้นได้หากตั้งค่าไว้สูงเกินไป หากตั้งค่าเป็น 0 ระบบจะไม่จำกัดขนาดของแคช ค่าที่เหมาะสมจะแตกต่างกันไปตามขนาดของโปรเจ็กต์ โดยมีค่าเริ่มต้นเป็น 1,000
--experimental_remote_output_service=<a string>
default: ดูคำอธิบาย- 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
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" ให้บังคับใช้การแคชการดำเนินการทั้งหมดที่เรียกใช้จากระยะไกลได้ ไม่เช่นนั้นจะทำให้บิลด์ใช้งานไม่ได้ วิธีนี้มีประโยชน์ในการแก้ปัญหาความไม่แน่นอน เนื่องจากช่วยให้ตรวจสอบได้ว่ามีการแคชการดําเนินการที่ควรแคชไว้จริงหรือไม่ โดยไม่ต้องแทรกผลลัพธ์ใหม่ลงในแคชโดยไม่ตั้งใจ
--experimental_remote_scrubbing_config=<Converts to a Scrubber>
default: ดูคำอธิบาย- เปิดใช้การสแกนคีย์แคชระยะไกลด้วยไฟล์การกําหนดค่าที่ระบุ ซึ่งต้องเป็นโปรโตคอลบัฟเฟอร์ในรูปแบบข้อความ (ดู src/main/protobuf/remote_scrubbing.proto) ฟีเจอร์นี้มีไว้เพื่ออำนวยความสะดวกในการแชร์คaché ระยะไกล/ดิสก์ระหว่างการดำเนินการที่ทำงานบนแพลตฟอร์มที่แตกต่างกันแต่กำหนดเป้าหมายไปยังแพลตฟอร์มเดียวกัน ควรใช้ด้วยความระมัดระวังอย่างยิ่ง เนื่องจากการตั้งค่าที่ไม่เหมาะสมอาจทำให้เกิดการแชร์รายการแคชโดยไม่ได้ตั้งใจและส่งผลให้เกิดการสร้างที่ไม่ถูกต้อง การสแกนจะไม่ส่งผลต่อวิธีดำเนินการ แต่ส่งผลต่อวิธีคํานวณคีย์แคชระยะไกล/ดิสก์เพื่อดึงข้อมูลหรือจัดเก็บผลลัพธ์การดำเนินการเท่านั้น การดำเนินการที่ลบออกจะใช้ร่วมกับการดำเนินการระยะไกลไม่ได้ และจะดำเนินการในเครื่องแทนเสมอ การแก้ไขการกำหนดค่าการสครับจะไม่ทำให้เอาต์พุตที่มีอยู่ในระบบไฟล์ในเครื่องหรือแคชภายในเป็นโมฆะ จำเป็นต้องใช้บิลด์ที่สะอาดเพื่อดำเนินการใหม่ที่ได้รับผลกระทบ เพื่อให้สามารถใช้ฟีเจอร์นี้ได้สำเร็จ คุณอาจต้องตั้งค่า --host_platform ที่กำหนดเองร่วมกับ --experimental_platform_in_output_dir (เพื่อทำให้คำนำหน้าเอาต์พุตเป็นมาตรฐาน) และ --incompatible_strict_action_env (เพื่อปรับตัวแปรสภาพแวดล้อมให้เป็นมาตรฐาน)
--[no]incompatible_remote_build_event_upload_respect_no_cache
ค่าเริ่มต้น: "false"- เลิกใช้งานแล้ว ไม่ทํางานใดๆ ให้ใช้ --remote_build_event_upload=minimal แทน
--[no]incompatible_remote_downloader_send_all_headers
ค่าเริ่มต้น: "true"-
กำหนดว่าจะส่งค่าทั้งหมดของส่วนหัวที่มีหลายค่าไปยังโปรแกรมดาวน์โหลดระยะไกลแทนที่จะส่งเฉพาะค่าแรกหรือไม่
แท็ก:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" เส้นทางเอาต์พุตจะสัมพัทธ์กับรูทของอินพุตแทนที่จะเป็นไดเรกทอรีที่ใช้งานอยู่
แท็ก:incompatible_change
--[no]incompatible_remote_results_ignore_disk
ค่าเริ่มต้น: "true"-
No-op
แท็ก:incompatible_change
--[no]remote_accept_cached
ค่าเริ่มต้น: "true"- การยอมรับผลลัพธ์การดำเนินการที่แคชไว้จากระยะไกล
--remote_build_event_upload=<all or minimal>
ค่าเริ่มต้น: "minimal"- หากตั้งค่าเป็น "ทั้งหมด" ระบบจะอัปโหลดเอาต์พุตในเครื่องทั้งหมดที่ BEP อ้างอิงไปยังแคชระยะไกล หากตั้งค่าเป็น "ขั้นต่ำ" ระบบจะไม่อัปโหลดเอาต์พุตในเครื่องที่ BEP อ้างอิงไปยังแคชระยะไกล ยกเว้นไฟล์ที่มีความสำคัญต่อผู้ใช้ BEP (เช่น บันทึกการทดสอบและโปรไฟล์การวัดเวลา) ระบบจะใช้รูปแบบ bytestream:// สำหรับ URI ของไฟล์เสมอ แม้ว่าไฟล์จะหายไปจากแคชระยะไกลก็ตาม ค่าเริ่มต้นคือ "minimal"
--remote_bytestream_uri_prefix=<a string>
default: ดูคำอธิบาย- ชื่อโฮสต์และชื่ออินสแตนซ์ที่จะใช้ใน URI ของ bytesstream:// ซึ่งเขียนลงในสตรีมเหตุการณ์ของบิลด์ ตัวเลือกนี้สามารถตั้งค่าได้เมื่อทำการบิลด์โดยใช้พร็อกซี ซึ่งจะทำให้ค่าของ --remote_executor และ --remote_instance_name ไม่สอดคล้องกับชื่อที่เป็นทางการของบริการการเรียกใช้ระยะไกลอีกต่อไป หากไม่ได้ตั้งค่าไว้ ค่าเริ่มต้นจะเป็น "${hostname}/${instance_name}"
--remote_cache=<a string>
default: ดูคำอธิบาย- URI ของปลายทางแคช สคีมาที่รองรับ ได้แก่ http, https, grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (ซ็อกเก็ต UNIX ในเครื่อง) หากไม่ได้ระบุสคีมา Bazel จะใช้ grpcs เป็นค่าเริ่มต้น ระบุสคีมา grpc://, http:// หรือ unix: เพื่อปิดใช้ TLS ดูที่ https://bazel.build/remote/caching
--[no]remote_cache_compression
ค่าเริ่มต้น: "false"- หากเปิดใช้ ให้บีบอัด/คลายการบีบอัด Blob แคชด้วย zstd เมื่อมีขนาดอย่างน้อย --experimental_remote_cache_compression_threshold
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--remote_cache_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคําขอแคช: --remote_cache_header=ชื่อ=ค่า คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุ Flag หลายครั้ง ระบบจะแปลงค่าหลายค่าที่มีชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
--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 คุณระบุรูปแบบได้หลายรายการโดยการใช้ Flag นี้ซ้ำ
แท็ก:affects_outputs
--remote_downloader_header=<a 'name=value' assignment>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ระบุส่วนหัวที่จะรวมอยู่ในคําขอของเครื่องมือดาวน์โหลดระยะไกล: --remote_downloader_header=ชื่อ=ค่า คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุ Flag หลายครั้ง ระบบจะแปลงค่าหลายค่าที่มีชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
--remote_exec_header=<a 'name=value' assignment>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ระบุส่วนหัวที่จะรวมอยู่ในคำขอการดำเนินการ: --remote_exec_header=Name=Value คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุ Flag หลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- ค่าเริ่มต้นของ
--remote_execution_priority=<an integer>
: "0" - ลําดับความสําคัญแบบสัมพัทธ์ของการดำเนินการที่จะดําเนินการจากระยะไกล ความหมายของค่าลําดับความสําคัญหนึ่งๆ จะขึ้นอยู่กับเซิร์ฟเวอร์
--remote_executor=<a string>
default: ดูคำอธิบาย- HOST หรือ HOST:PORT ของปลายทางการดำเนินการระยะไกล สคีมาที่รองรับ ได้แก่ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ unix (ซ็อกเก็ต UNIX ในพื้นที่) หากไม่ได้ระบุสคีมา Bazel จะใช้ grpcs เป็นค่าเริ่มต้น ระบุสคีมา grpc:// หรือ unix: เพื่อปิดใช้ TLS
- ค่าเริ่มต้น
--remote_grpc_log=<a path>
: ดูคำอธิบาย - เส้นทางไปยังไฟล์เพื่อบันทึกรายละเอียดการเรียกใช้ gRPC หากระบุ บันทึกนี้ประกอบด้วยลำดับ protobuf ของ com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry ที่แปลงเป็นอนุกรม โดยแต่ละข้อความจะมี varint นำหน้า ซึ่งระบุขนาดของข้อความ protobuf ที่แปลงเป็นอนุกรมรายการถัดไป ตามที่ดำเนินการโดยเมธอด LogEntry.writeDelimitedTo(OutputStream)
--remote_header=<a 'name=value' assignment>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ระบุส่วนหัวที่จะรวมอยู่ในคําขอ: --remote_header=ชื่อ=ค่า คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุ Flag หลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
--remote_instance_name=<a string>
ค่าเริ่มต้น: ""- ค่าที่จะส่งเป็น instance_name ใน API การดำเนินการระยะไกล
--[no]remote_local_fallback
ค่าเริ่มต้น: "false"- Whether to fall back to standalone local execution strategy if remote execution fails.
--remote_local_fallback_strategy=<a string>
ค่าเริ่มต้น: "local"- ไม่มีการดำเนินการใดๆ เลิกใช้งานแล้ว ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7480
--remote_max_connections=<an integer>
ค่าเริ่มต้น: "100"-
จำกัดจำนวนการเชื่อมต่อสูงสุดที่ดำเนินการได้พร้อมกันกับแคช/ผู้ดำเนินการระยะไกล โดยค่าเริ่มต้น ค่านี้คือ 100 การตั้งค่านี้เป็น 0 หมายความว่าไม่มีข้อจำกัด
สำหรับแคชระยะไกล HTTP การเชื่อมต่อ TCP 1 รายการสามารถจัดการคำขอได้ครั้งละ 1 รายการ ดังนั้น Bazel สามารถสร้างคำขอพร้อมกันได้สูงสุด --remote_max_connections
สําหรับแคช/ผู้ดําเนินการระยะไกล gRPC ปกติแล้วแชแนล gRPC 1 ช่องจะจัดการคําขอพร้อมกันได้มากกว่า 100 รายการ ดังนั้น Bazel จึงทําคําขอพร้อมกันได้ประมาณ `--remote_max_connections * 100`
แท็ก:host_machine_resource_optimizations
--remote_proxy=<a string>
default: ดูคำอธิบาย- เชื่อมต่อกับแคชระยะไกลผ่านพร็อกซี ปัจจุบันแฟล็กนี้ใช้ได้กับการกำหนดค่าซ็อกเก็ตโดเมน 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>
ค่าเริ่มต้น: "auto"- ใช้การควบคุมเคอร์เซอร์ของเทอร์มินัลเพื่อลดการเลื่อนเอาต์พุต
--disk_cache=<a path>
default: ดูคำอธิบาย- เส้นทางไปยังไดเรกทอรีที่ Bazel อ่านและเขียนการดำเนินการและเอาต์พุตการดำเนินการได้ หากยังไม่มีไดเรกทอรี ระบบจะสร้างให้
--[no]enable_platform_specific_config
ค่าเริ่มต้น: "false"- หากเป็นจริง Bazel จะใช้บรรทัดการกำหนดค่าเฉพาะโฮสต์ของระบบปฏิบัติการจากไฟล์ bazelrc เช่น หากระบบปฏิบัติการโฮสต์เป็น Linux และคุณเรียกใช้ bazel build ทาง Bazel จะเลือกบรรทัดที่ขึ้นต้นด้วย build:linux ตัวระบุระบบปฏิบัติการที่รองรับ ได้แก่ Linux, Macos, Windows, Freebsd และ openbsd การเปิดใช้ Flag นี้จะเทียบเท่ากับการใช้ --config=linux ใน Linux, --config=windows ใน Windows เป็นต้น
--experimental_disk_cache_gc_idle_delay=<An immutable length of time.>
ค่าเริ่มต้น: "5m"- ระยะเวลาที่เซิร์ฟเวอร์ต้องไม่มีการใช้งานก่อนที่ระบบจะรวบรวมขยะในแคชดิสก์ หากต้องการระบุนโยบายการเก็บขยะ ให้ตั้งค่า --experimental_disk_cache_gc_max_size และ/หรือ --experimental_disk_cache_gc_max_age
- ค่าเริ่มต้นของ
--experimental_disk_cache_gc_max_age=<An immutable length of time.>
: "0" - หากตั้งค่าเป็นค่าบวก ระบบจะรวบรวมขยะในแคชดิสก์เป็นระยะเพื่อนำรายการที่เก่ากว่าอายุนี้ออก หากตั้งค่าร่วมกับ --experimental_disk_cache_gc_max_size ระบบจะใช้ทั้ง 2 เกณฑ์ เกิดการเก็บข้อมูลขยะในพื้นหลังเมื่อเซิร์ฟเวอร์ไม่มีการใช้งาน ตามที่กำหนดโดยค่าสถานะ --experimental_disk_cache_gc_idle_delay
- ค่าเริ่มต้นของ
--experimental_disk_cache_gc_max_size=<a size in bytes, optionally followed by a K, M, G or T multiplier>
: "0" - หากตั้งค่าเป็นค่าบวก ระบบจะรวบรวมขยะในแคชดิสก์เป็นระยะๆ เพื่อให้มีขนาดไม่เกินค่านี้ หากตั้งค่าร่วมกับ --experimental_disk_cache_gc_max_age ระบบจะใช้ทั้ง 2 เกณฑ์ การรวบรวมขยะจะเกิดขึ้นในเบื้องหลังเมื่อเซิร์ฟเวอร์ไม่มีการใช้งานตามที่ระบุโดย Flag --experimental_disk_cache_gc_idle_delay
- ค่าเริ่มต้น
--[no]experimental_rule_extension_api
: "เท็จ" -
เปิดใช้ API ส่วนขยายกฎเวอร์ชันทดลองและ API กฎย่อย
แท็ก:loading_and_analysis
,experimental
--[no]experimental_windows_watchfs
ค่าเริ่มต้น: "false"- หากเป็น "จริง" ระบบจะเปิดใช้การรองรับ --watchfs เวอร์ชันทดลองใน Windows มิฉะนั้น --watchfs จะใช้งานไม่ได้ใน 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
ค่าเริ่มต้น: "false"- ใช้ "ข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชันของ Google" สำหรับการรับรองหรือไม่ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication ปิดใช้โดยค่าเริ่มต้น
- ค่าเริ่มต้น
--grpc_keepalive_time=<An immutable length of time.>
: ดูคำอธิบาย - กำหนดค่าการ ping การรักษาการเชื่อมต่อไว้สำหรับการเชื่อมต่อ gRPC ขาออก หากตั้งค่าไว้ Bazel จะส่งคําสั่ง ping หลังจากไม่มีการดำเนินการอ่านในการเชื่อมต่อเป็นเวลานานเท่านี้ แต่ในกรณีที่มีการเรียกใช้ gRPC ที่รอดำเนินการอย่างน้อย 1 รายการเท่านั้น ระบบจะถือว่าเวลามีความละเอียดเป็นวินาที การตั้งค่าค่าที่น้อยกว่า 1 วินาทีจะเป็นข้อผิดพลาด โดยค่าเริ่มต้น ระบบจะปิดใช้การ ping ที่ใช้เพื่อตรวจสอบว่าการเชื่อมต่อยังอยู่ คุณควรประสานงานกับเจ้าของบริการก่อนเปิดใช้การตั้งค่านี้ เช่น หากต้องการตั้งค่า 30 วินาทีให้กับแฟล็กนี้ ก็ควรทําดังนี้ --grpc_keepalive_time=30s
- ค่าเริ่มต้นของ
--grpc_keepalive_timeout=<An immutable length of time.>
: "20 วินาที" - กำหนดค่าการหมดเวลาการคงการเชื่อมต่อไว้สำหรับการเชื่อมต่อ gRPC ขาออก หากเปิดใช้คําสั่ง ping ที่ใช้เพื่อคงการเชื่อมต่อไว้ด้วย --grpc_keepalive_time แล้ว Bazel จะยกเลิกการเชื่อมต่อหากไม่ได้รับการตอบกลับคําสั่ง ping หลังจากผ่านไปนานเท่านี้ ระบบจะถือว่าเวลามีความละเอียดเป็นวินาที การตั้งค่าค่าที่น้อยกว่า 1 วินาทีจะเป็นข้อผิดพลาด หากปิดใช้การ ping ตรวจสอบสถานะอยู่เสมอ ระบบจะไม่สนใจการตั้งค่านี้
--[no]incompatible_disable_non_executable_java_binary
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" java_binary จะเรียกใช้ได้เสมอ ระบบจะนำแอตทริบิวต์ create_executable ออก
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disallow_symlink_file_to_dir
: "จริง" -
ไม่มีการดำเนินการใดๆ
แท็ก:loading_and_analysis
,incompatible_change
--invocation_id=<a UUID>
ค่าเริ่มต้น: ""-
ตัวระบุที่ไม่ซ้ำกันในรูปแบบ UUID สำหรับคำสั่งที่เรียกใช้ หากระบุความซ้ำกันอย่างชัดเจน ผู้เรียกต้องตรวจสอบความซ้ำกัน UUID จะพิมพ์ไปยัง stderr, BEP และโปรโตคอลการดำเนินการระยะไกล
แท็ก:bazel_monitoring
,bazel_internal_configuration
--[no]progress_in_terminal_title
ค่าเริ่มต้น: "false"- แสดงความคืบหน้าของคำสั่งในชื่อเทอร์มินัล มีประโยชน์ในการดูสิ่งที่ bazel กำลังทำเมื่อมีแท็บเทอร์มินัลหลายแท็บ
--[no]show_progress
ค่าเริ่มต้น: "true"- แสดงข้อความความคืบหน้าระหว่างการสร้าง
--show_progress_rate_limit=<a double>
ค่าเริ่มต้น: "0.2"- จำนวนวินาทีขั้นต่ำระหว่างข้อความแสดงความคืบหน้าในเอาต์พุต
--[no]show_timestamps
ค่าเริ่มต้น: "false"- ใส่การประทับเวลาในข้อความ
--tls_certificate=<a string>
default: ดูคำอธิบาย- ระบุเส้นทางไปยังใบรับรอง TLS ที่เชื่อถือให้ลงนามใบรับรองเซิร์ฟเวอร์
--tls_client_certificate=<a string>
default: ดูคำอธิบาย- ระบุใบรับรองไคลเอ็นต์ TLS ที่จะใช้ นอกจากนี้ คุณยังต้องระบุคีย์ไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
--tls_client_key=<a string>
default: ดูคำอธิบาย- ระบุคีย์ไคลเอ็นต์ TLS ที่จะใช้ นอกจากนี้ คุณยังต้องระบุใบรับรองไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
--ui_actions_shown=<an integer>
ค่าเริ่มต้น: "8"-
จํานวนการดําเนินการพร้อมกันที่แสดงในแถบความคืบหน้าแบบละเอียด โดยแต่ละการดําเนินการจะแสดงในบรรทัดแยกกัน แถบความคืบหน้าจะแสดงอย่างน้อย 1 รายการเสมอ และตัวเลขทั้งหมดที่น้อยกว่า 1 จะจับคู่กับ 1
แท็ก:terminal_output
--[no]watchfs
ค่าเริ่มต้น: "false"- ใน Linux/macOS: หากเป็น "จริง" Bazel จะพยายามใช้บริการเฝ้าดูไฟล์ของระบบปฏิบัติการสำหรับการเปลี่ยนแปลงในเครื่องแทนที่จะสแกนทุกไฟล์เพื่อหาการเปลี่ยนแปลง ใน Windows: ปัจจุบันแฟล็กนี้เป็นแบบ non-op แต่สามารถเปิดใช้ร่วมกับ --experimental_windows_watchfs ในทุกระบบปฏิบัติการ: ไม่มีการกำหนดลักษณะการทำงานหากพื้นที่ทำงานอยู่ในระบบไฟล์เครือข่าย และมีการแก้ไขไฟล์ในเครื่องระยะไกล
ตัวเลือกการวิเคราะห์โปรไฟล์
- ตัวเลือกที่ปรากฏก่อนคําสั่งและได้รับการแยกวิเคราะห์โดยไคลเอ็นต์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนที่จะเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บข้อมูลจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบในแคชแทนการคัดลอก การดำเนินการนี้มีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งที่พยายามลองอีกครั้งสูงสุดสำหรับข้อผิดพลาดในการดาวน์โหลด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ด้วยปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้น
--[no]incompatible_disable_native_repo_rules
: "เท็จ" -
หากเป็นเท็จ จะใช้กฎของรีโปเดิมใน WORKSPACE ได้ หากเป็นจริง ต้องใช้กฎของรีโป Starlark แทน กฎของรีโปเนทีฟ ได้แก่ local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
default: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลรีโพซิทอรี่ภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช มิเช่นนั้นระบบจะใช้ค่าเริ่มต้นของ "<output_user_root>/cache/repos/v1"
แท็ก:bazel_internal_configuration
--[no]repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลพื้นที่เก็บข้อมูล โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้อย่างสมบูรณ์ ctx.execute อาจยังคงเรียกใช้ไฟล์ที่เรียกใช้งานได้แบบกำหนดเองซึ่งเข้าถึงอินเทอร์เน็ตได้
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์มีดังนี้
--gc_thrashing_threshold=<an integer in 0-100 range>
ค่าเริ่มต้น: "100"-
เปอร์เซ็นต์ของพื้นที่เก็บข้อมูลแบบ Tenure ที่ใช้งานอยู่ (0-100) ซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์ความกดดันของหน่วยความจําเทียบกับขีดจํากัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะอนุญาตในกราฟ Dependency ที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่ามีการดึงออกในรีจิสทรีที่มาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น การดึงเวอร์ชันออกจะทำให้การแก้ไขไม่สำเร็จ นอกจากนี้ คุณยังกำหนดเวอร์ชันลบที่อนุญาตด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" ได้ด้วย คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็ก:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้กับเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ" "off" เพื่อปิดใช้การตรวจสอบ หรือ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน
แท็ก:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่า Dependency ของ `bazel_dep` โดยตรงที่ประกาศไว้ในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟ Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ใช้ได้คือ "off" เพื่อปิดใช้การตรวจสอบ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน หรือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ"
แท็ก: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>
ค่าเริ่มต้น: "update"-
ระบุวิธีและระบุว่าจะใช้ไฟล์ล็อกหรือไม่ ค่าที่ถูกต้องคือ "อัปเดต" เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง "รีเฟรช" เพื่อรีเฟรชข้อมูลที่เปลี่ยนแปลงได้เพิ่มเติม (เวอร์ชันที่แยกออกมาและโมดูลที่หายไปก่อนหน้านี้) จากรีจิสทรีระยะไกลเป็นครั้งคราว "ข้อผิดพลาด" ในการใช้ไฟล์ล็อกแต่เกิดข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่อไม่อ่านหรือเขียนไปยังไฟล์ล็อก
แท็ก:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างโมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีทํางานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" แสดงว่าสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel" หากเส้นทางที่ระบุว่างเปล่า ให้นำการลบล้างก่อนหน้าออก
--registry=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้ค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับเป็นสิ่งสำคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีในภายหลังเมื่อไม่มีรีจิสทรีที่ขาดหายไป
แท็ก:changes_inputs
--vendor_dir=<a path>
default: ดูคำอธิบาย-
ระบุไดเรกทอรีที่ควรเก็บที่เก็บข้อมูลภายนอกในโหมดผู้ให้บริการ ไม่ว่าจะเป็นเพื่อดึงข้อมูลมายังไดเรกทอรีดังกล่าวหรือใช้ขณะสร้าง เส้นทางอาจเป็นเส้นทางแบบสัมบูรณ์หรือเส้นทางแบบสัมพัทธ์กับไดเรกทอรีของพื้นที่ทำงานก็ได้
แท็ก: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 เปอร์เซ็นต์หลังจากการเรียกใช้ GC แบบเต็มติดต่อกัน <count> ครั้งภายใน <period> ระบบจะเรียกใช้ OOM คุณสามารถระบุขีดจํากัดหลายรายการโดยคั่นด้วยคอมมา
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC แบบเต็มขึ้น ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนครั้งต่อครั้งที่เรียกใช้ ค่าเริ่มต้นเป็น Integer.MAX_VALUE โดยไม่มีขีดจำกัด 0 หมายความว่าเหตุการณ์ GC แบบสมบูรณ์จะไม่ทริกเกอร์การลดลง หากถึงขีดจำกัด สถานะ Skyframe จะไม่ลดลงอีกต่อไปเมื่อเกิดเหตุการณ์ GC เต็มรูปแบบและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
แฟล็กสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC เล็กน้อย ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนนี้ต่อการเรียกใช้แต่ละครั้ง ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด 0 หมายความว่าเหตุการณ์ GC เล็กน้อยจะไม่ทริกเกอร์การลดลง หากถึงขีดจำกัด สถานะ Skyframe จะไม่ลดลงอีกต่อไปเมื่อเกิดเหตุการณ์ GC ที่ไม่ร้ายแรงและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานฮีปที่สะสมไว้ถึงเกณฑ์นี้เป็นอย่างน้อย ก็จะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็น การปรับแต่งนี้อาจช่วยลดผลกระทบจากเวลาจริงของการ Thashing
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ส่งผลต่อรายละเอียด รูปแบบ หรือตำแหน่งของการบันทึก
- ค่าเริ่มต้น
--dump=<text or raw>
[-d
]: ดูรายละเอียด -
แสดงข้อมูลโปรไฟล์ทั้งหมดในรูปแบบ "ข้อความ" ที่มนุษย์อ่านได้หรือรูปแบบ "ไฟล์ดิบ" ที่เหมาะสำหรับสคริปต์
แท็ก:affects_outputs
--experimental_command_profile=<cpu, wall, alloc or lock>
default: ดูคำอธิบาย- บันทึกโปรไฟล์ Java Flight Recorder ตลอดระยะเวลาของคำสั่ง คุณต้องระบุประเภทเหตุการณ์โปรไฟล์ที่รองรับ (cpu, wall, alloc หรือ lock) รายการใดรายการหนึ่งเป็นอาร์กิวเมนต์ ระบบจะเขียนโปรไฟล์ลงในไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ในไดเรกทอรีฐานเอาต์พุต ไวยากรณ์และความหมายของแฟล็กนี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับประเภทโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม คุณต้องยอมรับความเสี่ยงที่เกิดขึ้นเอง
- ค่าเริ่มต้น
--[no]experimental_record_metrics_for_all_mnemonics
: "เท็จ" - โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจํากัดไว้ที่คําช่วยจํา 20 รายการที่มีการดําเนินการมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับคําช่วยจําทั้งหมด
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ใช่ค่าว่าง ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการระยะไกล
- ค่าเริ่มต้น
--experimental_downloader_config=<a string>
: ดูคำอธิบาย - ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดจากระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด แต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือสองรูปแบบ รูปแบบหนึ่งจะใช้ตรงกัน และอีกรูปแบบหนึ่งใช้เป็น URL ทดแทน โดยมีการอ้างอิงกลับที่เริ่มต้นจาก "$1" ซึ่งระบบอาจส่งคืนคำสั่ง "rewrite" หลายครั้งสำหรับ URL เดียวกัน
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
ค่าเริ่มต้น: "auto"- โหมดการแยกชุดข้อความที่จะใช้ดึงข้อมูลรีโป หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท ไม่เช่นนั้นจะใช้เธรดผู้ทํางานเสมือน
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้าออก
ตัวเลือกคำค้นหา
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
--distdir=<a path>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนที่จะเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากตั้งค่าไว้ แคชที่เก็บข้อมูลจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบในแคชแทนการคัดลอก ซึ่งช่วยประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งที่พยายามลองอีกครั้งสูงสุดสำหรับข้อผิดพลาดในการดาวน์โหลด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองอีกครั้ง
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ด้วยปัจจัยนี้ วิธีนี้ช่วยให้รีโพซิทอรีภายนอกทํางานบนเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้น
--[no]incompatible_disable_native_repo_rules
: "เท็จ" -
หากเป็นเท็จ จะใช้กฎของรีโปเดิมใน WORKSPACE ได้ หากเป็นจริง ต้องใช้กฎของรีโป Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูคำอธิบาย -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลรีโพซิทอรี่ภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช มิเช่นนั้นระบบจะใช้ค่าเริ่มต้นของ "<output_user_root>/cache/repos/v1"
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]repository_disable_download
: "เท็จ" -
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลพื้นที่เก็บข้อมูล โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้โดยสมบูรณ์ โดย ctx.exeโดยสมบูรณ์ยังคงเรียกใช้ไฟล์ปฏิบัติการที่กำหนดเองได้ซึ่งเข้าถึงอินเทอร์เน็ตได้
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
- ค่าเริ่มต้น
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
เปอร์เซ็นต์ของพื้นที่เก็บข้อมูลแบบ Tenure ที่ใช้งานอยู่ (0-100) ซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์ความกดดันของหน่วยความจําเทียบกับขีดจํากัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตการค้นหาและความหมาย
--aspect_deps=<off, conservative or precise>
ค่าเริ่มต้น: "conservative"-
วิธีแก้ไขการพึ่งพาแง่มุมเมื่อรูปแบบเอาต์พุตเป็นหนึ่งใน {xml,proto,record} "ปิด" หมายความว่าไม่มีการแก้ไขข้อกําหนดของมิติข้อมูล "แบบอนุรักษ์นิยม" (ค่าเริ่มต้น) หมายความว่าระบบจะเพิ่มข้อกําหนดของมิติข้อมูลที่ประกาศไว้ทั้งหมด ไม่ว่าจะได้รับคลาสกฎของข้อกําหนดโดยตรงหรือไม่ "แม่นยํา" หมายความว่าระบบจะเพิ่มเฉพาะมิติข้อมูลเหล่านั้นที่อาจใช้งานได้โดยพิจารณาจากคลาสกฎของข้อกําหนดโดยตรง โปรดทราบว่าโหมดแม่นยำต้องมีการโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียว ซึ่งจะทำให้ช้ากว่าโหมดอื่นๆ นอกจากนี้ โปรดทราบว่าโหมดที่แม่นยำก็อาจไม่แม่นยำทั้งหมด เนื่องจากการตัดสินใจว่าจะคำนวณแง่มุมใดหรือไม่นั้นจะเกิดขึ้นในระยะการวิเคราะห์ ซึ่งไม่ได้ทำงานระหว่าง "การค้นหา Bazel"
แท็ก:build_file_semantics
--[no]consistent_labels
ค่าเริ่มต้น: "false"-
หากเปิดใช้ คำสั่งการค้นหาทุกรายการจะแสดงป้ายกำกับราวกับว่าฟังก์ชัน <code>str</code> ของ Starlark มีผลกับอินสแตนซ์ <code>Label</code> ซึ่งมีประโยชน์สําหรับเครื่องมือที่ต้องจับคู่เอาต์พุตของคําสั่งการค้นหาและ/หรือป้ายกำกับต่างๆ ที่กฎสร้างขึ้น หากไม่เปิดใช้ ตัวจัดรูปแบบเอาต์พุตจะแสดงชื่อที่เก็บที่ชัดเจน (สัมพันธ์กับที่เก็บหลัก) แทนเพื่อทำให้เอาต์พุตอ่านได้ง่ายขึ้น
แท็ก:terminal_output
--[no]experimental_explicit_aspects
ค่าเริ่มต้น: "false"-
aquery, cquery: ระบุว่าจะรวมการดำเนินการที่เกิดจากแง่มุมไว้ในเอาต์พุตหรือไม่ query: no-op (ระบบจะตามแง่มุมเสมอ)
แท็ก:terminal_output
--[no]graph:factored
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ระบบจะแสดงกราฟที่ "แยกปัจจัย" กล่าวคือจะผสานโหนดที่เทียบเท่ากันตามแบบแผนเข้าด้วยกันและต่อป้ายกำกับของโหนดเหล่านั้น ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
--graph:node_limit=<an integer>
ค่าเริ่มต้น: "512"-
ความยาวสูงสุดของสตริงป้ายกำกับสำหรับโหนดกราฟในเอาต์พุต ระบบจะตัดป้ายกำกับที่ยาวกว่าออก โดย -1 หมายความว่าไม่ตัด ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]implicit_deps
: "true" -
หากเปิดใช้ ทรัพยากร Dependency ที่ไม่ชัดแจ้งจะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงานอยู่ Dependency ที่ไม่ชัดแจ้งคือ Dependency ที่ไม่ได้ระบุไว้อย่างชัดเจนในไฟล์ BUILD แต่ Bazel เพิ่มเข้ามา สําหรับ cquery ตัวเลือกนี้จะควบคุมการกรองเครื่องมือทางเทคนิคที่แก้ไขแล้ว
แท็ก:build_file_semantics
--[no]include_artifacts
ค่าเริ่มต้น: "true"-
รวมชื่ออินพุตและเอาต์พุตการดําเนินการไว้ในเอาต์พุต (อาจมีขนาดใหญ่)
แท็ก:terminal_output
--[no]include_aspects
ค่าเริ่มต้น: "true"-
aquery, cquery: ระบุว่าจะรวมการดำเนินการที่เกิดจากแง่มุมไว้ในเอาต์พุตหรือไม่ query: no-op (ระบบจะตามแง่มุมเสมอ)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]include_commandline
: "true" -
รวมเนื้อหาของบรรทัดคำสั่งสำหรับการดำเนินการในเอาต์พุต (อาจมีขนาดใหญ่)
แท็ก:terminal_output
--[no]include_file_write_contents
ค่าเริ่มต้น: "false"-
ใส่เนื้อหาไฟล์สําหรับการดําเนินการ FileWrite, SourceSymlinkManifest และ RepoMappingManifest (อาจมีขนาดใหญ่)
แท็ก:terminal_output
--[no]include_param_files
ค่าเริ่มต้น: "false"-
รวมเนื้อหาของไฟล์พารามิเตอร์ที่ใช้ในคำสั่ง (อาจมีขนาดใหญ่) หมายเหตุ: การเปิดใช้ Flag นี้จะเปิดใช้ Flag --include_commandline โดยอัตโนมัติ
แท็ก:terminal_output
--[no]incompatible_package_group_includes_double_slash
ค่าเริ่มต้น: "true"-
หากเปิดใช้ เมื่อแสดงผลแอตทริบิวต์ "packages" ของ package_group ระบบจะไม่ละเว้น "//" ขึ้นต้น
แท็ก:terminal_output
,incompatible_change
- ค่าเริ่มต้น
--[no]infer_universe_scope
: "เท็จ" -
หากตั้งค่าและไม่ได้ตั้งค่า --universe_scope ระบบจะอนุมานค่าของ --universe_scope เป็นรายการรูปแบบเป้าหมายที่ไม่ซ้ำกันในนิพจน์การค้นหา โปรดทราบว่าค่า --universe_scope ที่อนุมานสำหรับนิพจน์การค้นหาที่ใช้ฟังก์ชันที่กำหนดขอบเขตระดับจักรวาล (เช่น "allrdeps") อาจไม่ใช่สิ่งที่คุณต้องการ คุณจึงควรใช้ตัวเลือกนี้ก็ต่อเมื่อคุณทราบว่าคุณกำลังทำอะไรอยู่เท่านั้น ดูรายละเอียดและตัวอย่างได้ที่ https://bazel.build/reference/query#sky-query หากตั้งค่า --universe_scope แล้ว ระบบจะไม่สนใจค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้มีผลกับ "query" เท่านั้น (ไม่ใช่ "cquery")
แท็ก:loading_and_analysis
--[no]line_terminator_null
ค่าเริ่มต้น: "false"-
ระบุว่าแต่ละรูปแบบสิ้นสุดด้วย \0 แทนการขึ้นบรรทัดใหม่หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]nodep_deps
: "จริง" -
หากเปิดใช้ Dep จากแอตทริบิวต์ "nodep" จะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ตัวอย่างที่พบบ่อยของแอตทริบิวต์ "nodep" คือ "visibility" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ "info build-language" เพื่อดูข้อมูลเกี่ยวกับแอตทริบิวต์ "nodep" ทั้งหมดในภาษาของบิลด์
แท็ก:build_file_semantics
--output=<a string>
ค่าเริ่มต้น: "text"-
รูปแบบที่ควรพิมพ์ผลลัพธ์ของ aquery ค่าที่อนุญาตสำหรับ aquery ได้แก่ text, textproto, proto, streamed_proto, jsonproto
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:default_values
: "จริง" -
หากเป็น "จริง" ระบบจะรวมแอตทริบิวต์ที่ค่าไม่ได้ระบุไว้อย่างชัดเจนในไฟล์ BUILD หากเป็น "เท็จ" ระบบจะไม่รวมแอตทริบิวต์ดังกล่าว ตัวเลือกนี้ใช้ได้กับ --output=proto
แท็ก:terminal_output
--[no]proto:definition_stack
ค่าเริ่มต้น: "false"-
ป้อนข้อมูลในช่อง Proto ของ Definition_stack ซึ่งบันทึกสำหรับสแต็กการเรียกใช้ของ Starlark สำหรับแต่ละอินสแตนซ์ของกฎในขณะที่กำหนดคลาสของกฎ
แท็ก:terminal_output
--[no]proto:flatten_selects
ค่าเริ่มต้น: "true"-
หากเปิดใช้ ระบบจะยุบแอตทริบิวต์ที่กำหนดค่าได้ซึ่งสร้างโดย select() สําหรับประเภทลิสต์ การแสดงผลแบบแบนคือลิสต์ที่มีค่าแต่ละค่าของแผนที่ที่เลือกเพียงครั้งเดียว ระบบจะเปลี่ยนประเภทสเกลาร์ให้เป็นค่าว่าง
แท็ก:build_file_semantics
--[no]proto:include_attribute_source_aspects
ค่าเริ่มต้น: "false"-
ป้อนข้อมูลฟิลด์ proto ของ source_aspect_name ของแอตทริบิวต์แต่ละรายการด้วยแง่มุมแหล่งที่มาของแอตทริบิวต์ (สตริงว่างหากไม่มี)
แท็ก:terminal_output
--[no]proto:include_synthetic_attribute_hash
ค่าเริ่มต้น: "false"-
กำหนดว่าจะคำนวณและป้อนข้อมูลแอตทริบิวต์ $internal_attr_hash หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:instantiation_stack
: "เท็จ" -
ป้อนข้อมูลสแต็กการเรียกใช้การสร้างอินสแตนซ์ของแต่ละกฎ โปรดทราบว่าต้องมีสแต็กอยู่
แท็ก:terminal_output
--[no]proto:locations
ค่าเริ่มต้น: "true"-
แสดงข้อมูลตําแหน่งในเอาต์พุต proto หรือไม่
แท็ก:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
ค่าเริ่มต้น: "all"-
รายการแอตทริบิวต์ที่คั่นด้วยคอมมาที่จะรวมไว้ในเอาต์พุต ค่าเริ่มต้นคือแอตทริบิวต์ทั้งหมด ตั้งค่าเป็นสตริงว่างเปล่าเพื่อไม่ให้แสดงแอตทริบิวต์ใดๆ ตัวเลือกนี้ใช้ได้กับ --output=proto
แท็ก:terminal_output
--[no]proto:rule_inputs_and_outputs
ค่าเริ่มต้น: "true"-
การป้อนข้อมูลในช่อง rule_input และ rule_output หรือไม่
แท็ก:terminal_output
--query_file=<a string>
ค่าเริ่มต้น: ""-
หากตั้งค่าไว้ ระบบจะอ่านข้อความค้นหาจากไฟล์ที่ระบุชื่อไว้ที่นี่แทนที่จะอ่านจากบรรทัดคำสั่ง การระบุไฟล์ที่นี่พร้อมกับการค้นหาบรรทัดคำสั่งเป็นข้อผิดพลาด
แท็ก:changes_inputs
--[no]relative_locations
ค่าเริ่มต้น: "false"-
หากเป็นจริง ตำแหน่งของไฟล์ BUILD ใน XML และเอาต์พุต Pro จะสัมพันธ์กัน โดยค่าเริ่มต้น เอาต์พุตตำแหน่งจะเป็นเส้นทางแบบสัมบูรณ์และจะไม่สอดคล้องกันในแต่ละเครื่อง คุณสามารถตั้งค่าตัวเลือกนี้เป็น "จริง" เพื่อให้ได้ผลลัพธ์ที่สอดคล้องกันในทุกเครื่อง
แท็ก:terminal_output
--[no]skyframe_state
ค่าเริ่มต้น: "false"-
หากไม่ทำการวิเคราะห์เพิ่มเติม ให้ดัมพ์กราฟการดำเนินการปัจจุบันจาก Skyframe หมายเหตุ: ปัจจุบันระบบยังไม่รองรับการระบุเป้าหมายด้วย --skyframe_state ใช้แฟล็กนี้ได้กับ --output=proto หรือ --output=textproto เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]tool_deps
: "true" -
การค้นหา: หากปิดใช้ Dependency ของ "การกําหนดค่า exec" จะไม่รวมอยู่ในกราฟ Dependency ที่การค้นหาทํางาน ขอบความเกี่ยวข้องของ "การกำหนดค่า exec" เช่น ขอบจากกฎ "proto_library" ไปยังคอมไพเลอร์โปรโตคอล มักจะชี้ไปยังเครื่องมือที่ดำเนินการระหว่างการสร้าง ไม่ใช่ส่วนหนึ่งของโปรแกรม "เป้าหมาย" เดียวกัน
Cquery: หากปิดใช้ ระบบจะกรองเป้าหมายที่กําหนดค่าไว้ทั้งหมดซึ่งข้ามการเปลี่ยนสถานะการดําเนินการจากเป้าหมายระดับบนสุดที่ค้นพบเป้าหมายที่กําหนดค่าไว้นี้ ซึ่งหมายความว่าหากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าเป้าหมาย ระบบจะแสดงเฉพาะเป้าหมายที่กำหนดค่าไว้ซึ่งอยู่ในการกำหนดค่าเป้าหมายด้วย ถ้าเป้าหมายระดับบนสุดอยู่ในการกำหนดค่า exec ระบบจะแสดงผลเฉพาะเป้าหมายที่กำหนดค่าของ exec เท่านั้น ตัวเลือกนี้จะไม่ยกเว้นเครื่องมือทางเทคนิคที่แก้ไขแล้ว
แท็ก:build_file_semantics
--universe_scope=<comma-separated list of options>
ค่าเริ่มต้น: ""-
ชุดรูปแบบเป้าหมายที่คั่นด้วยคอมมา (แบบเพิ่มและแบบลบ) การค้นหาอาจดำเนินการในจักรวาลที่กําหนดโดยการปิดเชิงการเปลี่ยนรูปแบบของเป้าหมายที่ระบุ ตัวเลือกนี้ใช้สำหรับคำสั่ง query และ cquery
สําหรับ cquery อินพุตของตัวเลือกนี้คือเป้าหมายที่สร้างขึ้นสําหรับคําตอบทั้งหมด ดังนั้นตัวเลือกนี้จึงอาจส่งผลต่อการกำหนดค่าและการเปลี่ยน หากไม่ได้ระบุตัวเลือกนี้ ระบบจะถือว่าเป้าหมายระดับบนสุดเป็นเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหา หมายเหตุ: สําหรับ cquery การไม่ระบุตัวเลือกนี้อาจทําให้บิลด์ใช้งานไม่ได้ หากเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหาไม่สามารถสร้างด้วยตัวเลือกระดับบนสุด
แท็ก:loading_and_analysis
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะอนุญาตในกราฟ Dependency ที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่ามีการดึงออกในรีจิสทรีที่มาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิเช่นนั้น เวอร์ชันที่แยกออกมาจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันแยกที่อนุญาตด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" ได้ด้วย คุณสามารถปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้กับเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ" "off" เพื่อปิดใช้การตรวจสอบ หรือ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน
แท็ก:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟทรัพยากร Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดการตรวจสอบ "คำเตือน" ให้พิมพ์คำเตือนเมื่อตรวจพบข้อมูลที่ไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อยกระดับการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็นจริง Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นข้อกำหนดในการพัฒนาเหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูท ไม่ว่าค่าของ Flag นี้จะเป็นอย่างไรก็ตาม
แท็ก:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
ค่าเริ่มต้น: "update"-
ระบุวิธีและระบุว่าจะใช้ไฟล์ล็อกหรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ไฟล์ล็อกและอัปเดตไฟล์หากมีการเปลี่ยนแปลง "refresh" เพื่อรีเฟรชข้อมูลที่เปลี่ยนแปลงได้เพิ่มเติม (เวอร์ชันที่ยกเลิกและโมดูลที่ขาดหายไปก่อนหน้านี้) จากรีจิสทรีระยะไกลเป็นครั้งคราว "error" เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่เป็นปัจจุบัน หรือ "off" เพื่อไม่อ่านหรือเขียนลงในไฟล์ล็อก
แท็ก:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างโมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีทํางานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้านี้ออก
--registry=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้ในการค้นหาทรัพยากร Dependency ของโมดูล Bazel ลําดับมีความสําคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะเปลี่ยนไปใช้รีจิสทรีที่ใหม่กว่าก็ต่อเมื่อไม่มีโมดูลที่ต้องการในรีจิสทรีก่อนหน้า
แท็ก:changes_inputs
--vendor_dir=<a path>
default: ดูคำอธิบาย-
ระบุไดเรกทอรีที่ควรเก็บที่เก็บภายนอกในโหมดผู้ให้บริการ ไม่ว่าจะเพื่อวัตถุประสงค์ในการดึงข้อมูลลงในที่เก็บหรือใช้ขณะที่สร้าง เส้นทางอาจเป็นเส้นทางแบบสัมบูรณ์หรือเส้นทางแบบสัมพัทธ์กับไดเรกทอรีของพื้นที่ทำงานก็ได้
แท็ก:loading_and_analysis
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพของเวลาสร้าง
- ค่าเริ่มต้น
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "1s:2,20s:3,1m:5" -
ขีดจำกัดซึ่งหากถึงแล้วจะทำให้ GcThrashingDetector เกิดข้อขัดข้องกับ Bazel ด้วย OOM โดยระบุขีดจํากัดแต่ละรายการเป็น <period>:<count> โดยที่ period คือระยะเวลา และ count คือจํานวนเต็มบวก หากมีการใช้พื้นที่ที่มีการจัดสรรไว้ (ฮีปรุ่นเก่า) มากกว่า --gc_thrashing_threshold เปอร์เซ็นต์หลังจากการเรียกใช้ GC แบบเต็มติดต่อกัน <count> ครั้งภายใน <period> ระบบจะเรียกใช้ OOM คุณสามารถระบุขีดจํากัดหลายรายการโดยคั่นด้วยคอมมา
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC แบบเต็มขึ้น ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนครั้งต่อครั้งที่เรียกใช้ ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด 0 หมายความว่าเหตุการณ์ GC แบบสมบูรณ์จะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC แบบเต็มและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้ฮีปที่เก็บรักษาไว้เกินเกณฑ์ที่ --skyframe_high_water_mark_threshold ตั้งค่าอยู่ เมื่อเกิดเหตุการณ์ GC ที่ไม่ร้ายแรง เหตุการณ์ GC ที่ไม่ร้ายแรงจะเกิดขึ้น ระบบจะหยุดสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นออกไปจนถึงหลายครั้งต่อการเรียกใช้ ค่าเริ่มต้นคือจำนวนเต็มMAX_VALUE โดยไม่มีขีดจำกัด 0 หมายความว่าเหตุการณ์ GC เล็กน้อยจะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC ย่อยและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์กองที่เก็บไว้อย่างน้อยถึงเกณฑ์นี้ ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็น การปรับแต่งค่านี้อาจช่วยลดผลกระทบต่อเวลาจริงของการกระหน่ำ GC เมื่อการกระหน่ำ GC (1) เกิดจากการใช้งานหน่วยความจําของสถานะชั่วคราวนี้ และ (2) เสียค่าใช้จ่ายมากกว่าการสร้างสถานะใหม่เมื่อจําเป็น
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ส่งผลต่อรายละเอียด รูปแบบ หรือตำแหน่งของการบันทึก
--experimental_command_profile=<cpu, wall, alloc or lock>
default: ดูคำอธิบาย- บันทึกโปรไฟล์ Java Flight Recorder ตลอดระยะเวลาของคำสั่ง คุณต้องระบุประเภทเหตุการณ์โปรไฟล์ที่รองรับ (cpu, wall, alloc หรือ lock) รายการใดรายการหนึ่งเป็นอาร์กิวเมนต์ ระบบจะเขียนโปรไฟล์ลงในไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ในไดเรกทอรีฐานเอาต์พุต รูปแบบคำสั่งและความหมายของ Flag นี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับประเภทโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม โปรดใช้โดยยอมรับความเสี่ยงเอง
- ค่าเริ่มต้น
--[no]experimental_record_metrics_for_all_mnemonics
: "เท็จ" - โดยค่าเริ่มต้น ระบบจะจำกัดจำนวนประเภทการดำเนินการไว้ที่ 20 รายการ ซึ่งเป็นคําช่วยจําที่มีการดำเนินการมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับคําช่วยจําทั้งหมด
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ค่าเริ่มต้น
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
หากไม่ว่างเปล่า ให้อ่านไฟล์ที่แก้ไขแล้วแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
--experimental_downloader_config=<a string>
default: ดูคำอธิบาย- ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดจากระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะขึ้นต้นด้วยคําสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สําหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ โดยรูปแบบหนึ่งใช้เพื่อจับคู่และอีกรูปแบบหนึ่งใช้แทน URL โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณอาจระบุคําสั่ง `rewrite` หลายรายการสําหรับ URL เดียวกันได้ ซึ่งในกรณีนี้ระบบจะแสดงผล URL หลายรายการ
- ค่าเริ่มต้น
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "อัตโนมัติ" - โหมดการแยกชุดข้อความที่จะใช้ดึงข้อมูลรีโป หากตั้งค่าเป็น "ปิด" ระบบจะไม่ใช้เธรดสำหรับงานและการดึงข้อมูลรีโปจะขึ้นอยู่กับการรีสตาร์ท หรือใช้เธรดผู้ปฏิบัติงานเสมือนแทน
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บโดยใช้เส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีทํางานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้าออก
- ตัวเลือกที่ควบคุมการดำเนินการบิลด์
--[no]experimental_inprocess_symlink_creation
ค่าเริ่มต้น: "false"-
กำหนดว่าจะเรียกใช้ระบบไฟล์โดยตรงเพื่อสร้างแผนผังลิงก์สัญลักษณ์หรือไม่
แท็ก:loading_and_analysis
,execution
,experimental
--[no]experimental_persistent_aar_extractor
ค่าเริ่มต้น: "false"-
เปิดใช้เครื่องมือแยก Aar แบบถาวรโดยใช้เวิร์กเกอร์
แท็ก:execution
--[no]experimental_remotable_source_manifests
ค่าเริ่มต้น: "false"-
กำหนดให้ดำเนินการในไฟล์ Manifest ของแหล่งที่มาจากระยะไกลได้หรือไม่
แท็ก:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" Bazel จะเรียกใช้การประมวลผลผลลัพธ์ของการทดสอบในกระบวนการใหม่
แท็ก:execution
--[no]experimental_strict_fileset_output
ค่าเริ่มต้น: "false"-
หากเปิดใช้ตัวเลือกนี้ ไฟล์ชุดจะถือว่าอาร์ติแฟกต์เอาต์พุตทั้งหมดเป็นไฟล์ปกติ จะไม่ไปยังไดเรกทอรีต่างๆ หรือสนใจเกี่ยวกับสัญลักษณ์ลิงก์
แท็ก:execution
--[no]incompatible_disallow_unsound_directory_outputs
ค่าเริ่มต้น: "true"-
หากตั้งค่าไว้ ระบบจะแสดงข้อผิดพลาดเมื่อดำเนินการสร้างไฟล์เอาต์พุตเป็นไดเรกทอรี ไม่มีผลต่อไดเรกทอรีต้นทาง ดู https://github.com/bazelbuild/bazel/issues/18646
แท็ก:bazel_internal_configuration
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_modify_execution_info_additive
: "เท็จ" -
เมื่อเปิดใช้ การส่ง Flag --modify_execution_info หลายรายการจะเป็นการเพิ่ม เมื่อปิดใช้ ระบบจะพิจารณาเฉพาะการแจ้งเตือนล่าสุดเท่านั้น
แท็ก:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
รายการ -
เพิ่มหรือนําคีย์ออกจากข้อมูลการดําเนินการของการดำเนินการตามคําช่วยจําของการดำเนินการ ใช้กับการดำเนินการที่รองรับข้อมูลการดำเนินการเท่านั้น การดำเนินการทั่วไปหลายรายการรองรับข้อมูลการดำเนินการ เช่น Genrule, CppCompile, Javac, StarlarkAction, TestRunner เมื่อระบุค่าหลายค่า ลำดับมีความสำคัญเนื่องจาก regexe หลายรายการอาจใช้กับช่วยจำเดียวกันได้
ไวยากรณ์: "regex=[+-]key,regex=[+-]key,..."
ตัวอย่างเช่น ".*=+x,.*=-y,.*=+z" เพิ่ม "x" และ "z" และนำ "y" ออกจากข้อมูลการดำเนินการสำหรับการดำเนินการทั้งหมด
"Genrule=+requires-x" เพิ่ม "requires-x" ในข้อมูลการดำเนินการสำหรับการดำเนินการ Genrule ทั้งหมด
"(?!Genrule).*=-requires-x" นำ "requires-x" ออกจากข้อมูลการดำเนินการสำหรับการดำเนินการที่ไม่ใช่ Genrule ทั้งหมด
แท็ก:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
เปิดใช้การดำเนินการ Dex และ desugar ของ Android แบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
แท็ก:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
เปิดใช้ตัวประมวลผลทรัพยากร Android แบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
เปิดใช้การดำเนินการ Desugar และ Dex ของ Android แบบหลายเพล็กซ์แบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
เปิดใช้เครื่องมือประมวลผลทรัพยากร Android แบบมัลติเพล็กซ์อย่างถาวรโดยใช้ผู้ปฏิบัติงาน
ครอบคลุมถึง
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
{/7/2}
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
{/7/2}--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
-
เปิดใช้เครื่องมือ Android แบบถาวรและแบบหลายเพล็กซ์ (การแปลงไฟล์ Dex, การถอด Sugar, การประมวลผลทรัพยากร)
ขยายเป็น
--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 จะใช้แพลตฟอร์มเป้าหมายในการเรียกใช้การทดสอบแทนกลุ่ม exec ทดสอบ
แท็ก:execution
- ตัวเลือกที่กำหนดค่าเครื่องมือที่ใช้สำหรับการดำเนินการ
--android_compiler=<a string>
default: ดูคำอธิบาย-
คอมไพเลอร์เป้าหมาย Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
ค่าเริ่มต้น: "//external:android/crosstool"-
ตำแหน่งคอมไพเลอร์ C++ ที่ใช้สำหรับบิลด์ Android
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--android_grte_top=<a label>
: ดูคำอธิบาย -
เป้าหมาย grte_top ของ Android
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
ค่าเริ่มต้น: "android"-
เลือกเครื่องมือผสานไฟล์ Manifest ที่จะใช้กับกฎ android_binary แจ้งเพื่อช่วยให้การเปลี่ยนไปใช้การผสานไฟล์ Manifest ของ Android จากเครื่องมือผสานเดิมเป็นไปอย่างราบรื่น
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_platforms=<a build target label>
: "" -
กำหนดแพลตฟอร์มที่ android_binary กำหนดเป้าหมายใช้ หากระบุแพลตฟอร์มหลายรายการ ไฟล์ไบนารีจะเป็น APK แบบรวมซึ่งมีไบนารีเนทีฟสำหรับแพลตฟอร์มเป้าหมายแต่ละรายการที่ระบุ
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/android:sdk"-
ระบุ Android SDK/แพลตฟอร์มที่ใช้สร้างแอปพลิเคชัน Android
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้ในกฎของ Apple และ Objc รวมถึงการพึ่งพา
แท็ก:loses_incremental_state
,changes_inputs
- ค่าเริ่มต้น
--cc_output_directory_tag=<a string>
: "" -
ระบุส่วนต่อท้ายที่จะเพิ่มในไดเรกทอรีการกำหนดค่า
แท็ก:affects_outputs
--compiler=<a string>
default: ดูคำอธิบาย-
คอมไพเลอร์ 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>
default: "@bazel_tools//tools/test:coverage_report_generator"-
ตำแหน่งของไบนารีที่ใช้สร้างรายงานการครอบคลุม ซึ่งต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งก็คือไบนารี ค่าเริ่มต้นคือ "//tools/test:coverage_report_generator"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_support"-
ตำแหน่งของไฟล์สนับสนุนที่จําเป็นในอินพุตของการดำเนินการทดสอบทุกครั้งที่รวบรวมการครอบคลุมโค้ด ค่าเริ่มต้นคือ "//tools/test:coverage_support"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้สำหรับคอมไพล์โค้ด C++
แท็ก:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
default: ดูคำอธิบาย-
ระบุการใช้งาน malloc ที่กําหนดเอง การตั้งค่านี้จะลบล้างแอตทริบิวต์ Malloc ในกฎบิลด์
แท็ก:changes_inputs
,affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
รายการนิพจน์ทั่วไปที่คั่นด้วยคอมมา โดยแต่ละรายการจะมีคำนำหน้าเป็น - (นิพจน์เชิงลบ) หรือไม่ก็ได้ ซึ่งกำหนดค่า (=) ให้กับรายการเป้าหมายค่าข้อจำกัดที่คั่นด้วยคอมมา หากเป้าหมายไม่ตรงกับนิพจน์เชิงลบและตรงกับนิพจน์เชิงบวกอย่างน้อย 1 รายการ ระบบจะดำเนินการแก้ไขเครื่องมือทางเทคนิคของเป้าหมายนั้นราวกับว่าได้ประกาศค่าข้อจำกัดเป็นข้อจำกัดการดําเนินการ ตัวอย่างเช่น //demo,-test=@platforms//cpus:x86_64 จะเพิ่ม "x86_64" ลงในเป้าหมายใดก็ได้ในส่วน //demo ยกเว้นเป้าหมายที่มีชื่อเป็น "test"
แท็ก:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ให้เพิ่มข้อกำหนดการเรียกใช้ "requires-xcode:{version}" ลงในการดำเนินการ Xcode ทั้งหมด หากเวอร์ชัน Xcode มีป้ายกำกับที่ขีดกลาง ให้เพิ่มข้อกำหนดการเรียกใช้ "requires-xcode-label:{version_label}" ด้วย
แท็ก:loses_incremental_state
,loading_and_analysis
,execution
--[no]experimental_prefer_mutual_xcode
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ให้ใช้ Xcode เวอร์ชันล่าสุดที่มีทั้งแบบในเครื่องและแบบระยะไกล หากเป็นเท็จหรือไม่มีเวอร์ชันที่ใช้ร่วมกันได้ ให้ใช้ Xcode เวอร์ชันในเครื่องที่เลือกผ่าน xcode-select
แท็ก:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
ค่าเริ่มต้น: ""-
แพลตฟอร์มที่ใช้เป็นแพลตฟอร์มการดําเนินการเพื่อเรียกใช้การดําเนินการ แพลตฟอร์มสามารถระบุตามเป้าหมายที่ตรงกันทั้งหมดหรือเป็นรูปแบบเป้าหมาย ระบบจะพิจารณาแพลตฟอร์มเหล่านี้ก่อนแพลตฟอร์มที่ประกาศไว้ในไฟล์ WORKSPACE โดย register_execution_platforms() ตัวเลือกนี้ตั้งค่าได้เพียงครั้งเดียว อินสแตนซ์ที่ตามมาจะลบล้างการตั้งค่า Flag ก่อนหน้า
แท็ก:execution
--extra_toolchains=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
กฎสำหรับ Toolchain ที่ควรพิจารณาระหว่างการแก้ไข Toolchain คุณสามารถระบุ Toolchain ตามเป้าหมายที่ตรงกันทั้งหมด หรือเป็นรูปแบบเป้าหมายก็ได้ ระบบจะพิจารณาเครื่องมือเหล่านี้ก่อนเครื่องมือที่ประกาศไว้ในไฟล์ WORKSPACE โดย register_toolchains()
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
default: ดูคำอธิบาย-
ป้ายกำกับไปยังไลบรารี libc ที่มีการเช็คอิน Crosstool Toolchain จะเลือกค่าเริ่มต้นและคุณแทบจะไม่จำเป็นต้องลบล้างค่าเริ่มต้น
แท็ก:action_command_lines
,affects_outputs
--host_compiler=<a string>
default: ดูคำอธิบาย-
คอมไพเลอร์ C++ ที่จะใช้ในการคอมไพล์โฮสต์ ระบบจะไม่สนใจหากไม่ได้ตั้งค่า --host_crosstool_top
แท็ก:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
default: ดูคำอธิบาย-
โดยค่าเริ่มต้น ระบบจะใช้ตัวเลือก --crosstool_top และ --compiler สำหรับการกําหนดค่า exec ด้วย หากมีการแฟล็กนี้ Bazel จะใช้ libc และคอมไพเลอร์เริ่มต้นสำหรับ Crosstool_top ที่ระบุ
แท็ก:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
default: ดูคำอธิบาย-
หากระบุไว้ การตั้งค่านี้จะลบล้างไดเรกทอรีระดับบนสุดของ libc (--grte_top) สําหรับการกําหนดค่า exec
แท็ก:action_command_lines
,affects_outputs
--host_platform=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools:host_platform"-
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายระบบโฮสต์
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "จริง" -
หากเป็น "จริง" Bazel จะไม่เปิดใช้ฟีเจอร์ "โฮสต์" และ "ไม่ใช่โฮสต์" ในชุดเครื่องมือ C++ (ดูข้อมูลเพิ่มเติมที่ https://github.com/bazelbuild/bazel/issues/7407)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_enable_android_toolchain_resolution
: "จริง" -
ใช้การแก้ไข Toolchain เพื่อเลือก Android SDK สําหรับกฎ Android (Starlark และแบบดั้งเดิม)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
ค่าเริ่มต้น: "false"-
ใช้การแก้ไขเครื่องมือเพื่อเลือก Apple SDK สําหรับกฎของ Apple (Starlark และแบบดั้งเดิม)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" Bazel จะไม่นําบรรทัดคําสั่งการดําเนินการลิงก์ C++ มาใช้ซ้ำสําหรับบรรทัดคําสั่งการจัดทําดัชนี lto (ดูข้อมูลเพิ่มเติมที่ https://github.com/bazelbuild/bazel/issues/6791)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" Bazel จะไม่ลิงก์ไลบรารี Dependency เป็นไฟล์เก็บถาวรทั้งไฟล์โดยค่าเริ่มต้น (ดูวิธีการย้ายข้อมูลได้ที่ https://github.com/bazelbuild/bazel/issues/7362)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" Bazel จะกำหนดให้ต้องมีพารามิเตอร์ "ctx" ใน cc_common.configure_features (ดูข้อมูลเพิ่มเติมที่ https://github.com/bazelbuild/bazel/issues/7793)
แท็ก:loading_and_analysis
,incompatible_change
-
ใช้ออบเจ็กต์ที่แชร์ของอินเทอร์เฟซหากเครื่องมือทางเทคนิครองรับ เครื่องมือทํางาน ELF ทั้งหมดรองรับการตั้งค่านี้ในปัจจุบัน
แท็ก:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: ดูคำอธิบาย-
ระบุเวอร์ชันของ iOS SDK ที่จะใช้สร้างแอปพลิเคชัน iOS หากไม่ระบุ ระบบจะใช้เวอร์ชันเริ่มต้นของ iOS SDK จาก "xcode_version"
แท็ก:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: ดูคำอธิบาย-
ระบุเวอร์ชันของ macOS SDK ที่จะใช้สร้างแอปพลิเคชัน macOS หากไม่ระบุ ระบบจะใช้เวอร์ชัน macOS SDK เริ่มต้นจาก "xcode_version"
แท็ก:loses_incremental_state
--minimum_os_version=<a string>
default: ดูคำอธิบาย-
เวอร์ชันระบบปฏิบัติการขั้นต่ำที่การคอมไพล์กำหนดเป้าหมาย
แท็ก:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
ค่าเริ่มต้น: ""-
ตำแหน่งของไฟล์การแมปที่อธิบายว่าควรใช้แพลตฟอร์มใดหากไม่ได้ตั้งค่าไว้ หรือควรตั้งค่า Flag ใดเมื่อมีแพลตฟอร์มอยู่แล้ว ต้องสัมพันธ์กับรูทของพื้นที่ทํางานหลัก ค่าเริ่มต้นคือ "platform_mappings" (ไฟล์ที่อยู่ใต้รูทของพื้นที่ทํางานโดยตรง)
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
ค่าเริ่มต้น: ""-
ป้ายกํากับของกฎแพลตฟอร์มที่อธิบายแพลตฟอร์มเป้าหมายสําหรับคําสั่งปัจจุบัน
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
default: ดูคำอธิบาย-
เลิกใช้งาน ไม่ดำเนินการ ปิดใช้โดย "--incompatible_use_python_toolchains"
แท็ก:no_op
,deprecated
--python3_path=<a string>
default: ดูคำอธิบาย-
เลิกใช้งานแล้ว ใช้งานไม่ได้ ปิดใช้โดย `--incompatible_use_python_toolchains`
แท็ก:no_op
,deprecated
- ค่าเริ่มต้น
--python_path=<a string>
: ดูคำอธิบาย -
เส้นทางสัมบูรณ์ของโปรแกรมแปลภาษา Python ที่เรียกใช้เพื่อเรียกใช้เป้าหมาย Python ในแพลตฟอร์มเป้าหมาย เลิกใช้งานแล้ว ปิดใช้โดย --incompatible_use_python_toolchains
แท็ก:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
default: ดูคำอธิบาย-
ป้ายกํากับของ 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')>
default: ดูคำอธิบาย-
ระบุเวอร์ชันของ tvOS SDK ที่จะใช้สร้างแอปพลิเคชัน tvOS หากไม่ระบุ ระบบจะใช้เวอร์ชันเริ่มต้นของ tvOS SDK จาก "xcode_version"
แท็ก:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: ดูคำอธิบาย-
ระบุเวอร์ชันของ WatchOS SDK ที่จะใช้สร้างแอปพลิเคชัน watchOS หากไม่ระบุ ระบบจะใช้เวอร์ชัน watchOS SDK เริ่มต้นจาก "xcode_version"
แท็ก:loses_incremental_state
--xcode_version=<a string>
default: ดูคำอธิบาย-
หากระบุ ให้ใช้ 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 ของ Runfiles สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้เขียนเฉพาะเมื่อการดำเนินการในเครื่องต้องใช้ ทดสอบ หรือเรียกใช้คำสั่งเท่านั้น
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]build_runfile_manifests
: "จริง" -
หากเป็นจริง ระบบจะเขียนไฟล์ Manifest ของไฟล์รันไทม์สำหรับเป้าหมายทั้งหมด หากเป็นเท็จ ให้ละเว้น การทดสอบในเครื่องจะทํางานไม่สําเร็จเมื่อเป็นเท็จ
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]build_test_dwp
: "เท็จ" -
หากเปิดใช้ เมื่อสร้างการทดสอบ C++ แบบคงที่และด้วยฟิชชัน ระบบจะสร้างไฟล์ .dwp สำหรับไบนารีการทดสอบโดยอัตโนมัติเช่นกัน
แท็ก:loading_and_analysis
,affects_outputs
- ค่าเริ่มต้นของ
--cc_proto_library_header_suffixes=<comma-separated set of options>
: ".pb.h" -
ตั้งค่าส่วนต่อท้ายของไฟล์ส่วนหัวที่ cc_proto_library สร้างขึ้น
แท็ก:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
ค่าเริ่มต้น: ".pb.cc"-
ตั้งค่าส่วนต่อท้ายของไฟล์ต้นฉบับที่ cc_proto_library สร้าง
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_proto_descriptor_sets_include_source_info
: "เท็จ" -
เรียกใช้การดำเนินการเพิ่มเติมสำหรับเวอร์ชัน Java API อื่นใน proto_library
แท็ก:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
ค่าเริ่มต้น: "false"-
เรียกใช้การดำเนินการเพิ่มเติมสำหรับเวอร์ชัน Java API อื่นใน proto_library
แท็ก:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
ค่าเริ่มต้น: "false"-
บันทึกสถานะของฟีเจอร์ที่เปิดใช้และที่ขอไว้เป็นเอาต์พุตของการคอมไพล์
แท็ก:affects_outputs
,experimental
--fission=<a set of compilation modes>
ค่าเริ่มต้น: "no"-
ระบุว่าโหมดการคอมไพล์ใดใช้ฟิชชันสำหรับการรวบรวมและลิงก์ C++ อาจเป็นชุดค่าผสมของ {'fastbuild', 'dbg', 'opt'} หรือค่าพิเศษ "yes" เพื่อเปิดใช้ทุกโหมด และ "no" เพื่อปิดใช้ทุกโหมด
แท็ก:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" กฎแบบเนทีฟจะเพิ่ม <code>DefaultInfo.files</code> ของข้อมูลที่ต้องพึ่งพาลงในไฟล์รันไทม์ ซึ่งตรงกับลักษณะการทำงานที่แนะนำสำหรับกฎ Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid)
แท็ก:affects_outputs
,incompatible_change
- ค่าเริ่มต้น
--[no]legacy_external_runfiles
: "true" -
หากเป็น "จริง" ระบบจะสร้างป่าซิงค์ลิงก์ของไฟล์รันไทม์สำหรับที่เก็บข้อมูลภายนอกในส่วน .runfiles/wsname/external/repo (นอกเหนือจาก .runfiles/repo)
แท็ก:affects_outputs
--[no]objc_generate_linkmap
ค่าเริ่มต้น: "false"-
ระบุว่าจะสร้างไฟล์ Linkmap หรือไม่
แท็ก:affects_outputs
--[no]save_temps
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ระบบจะบันทึกเอาต์พุตชั่วคราวจาก gcc ซึ่งรวมถึงไฟล์ .s (โค้ดแอสเซมเบลอร์), ไฟล์ .i (C ที่ผ่านการประมวลผลล่วงหน้า) และไฟล์ .ii (C++ ที่ผ่านการประมวลผลล่วงหน้า)
แท็ก:affects_outputs
- ตัวเลือกที่อนุญาตให้ผู้ใช้กําหนดค่าเอาต์พุตที่ต้องการ ซึ่งส่งผลต่อค่าของเอาต์พุต ไม่ใช่การมีอยู่ของเอาต์พุต
--action_env=<a 'name=value' assignment with an optional value part>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกำหนดค่าเป้าหมาย ตัวแปรสามารถระบุโดยใช้ชื่อ ซึ่งในกรณีนี้ระบบจะนำค่ามาจากสภาพแวดล้อมการเรียกใช้ หรือระบุโดยใช้คู่ชื่อ=ค่า ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ คุณใช้ตัวเลือกนี้ได้หลายครั้ง ตัวเลือกสําหรับตัวแปรเดียวกันจะเลือกตัวเลือกล่าสุด ส่วนตัวเลือกสําหรับตัวแปรต่างๆ จะรวมกัน
แท็ก:action_command_lines
--android_cpu=<a string>
ค่าเริ่มต้น: "armeabi-v7a"-
CPU เป้าหมายของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
ค่าเริ่มต้น: "true"-
สร้างไฟล์การเชื่อมโยงข้อมูลที่เข้ากันได้กับ AndroidX ใช้กับ DataBinding v2 เท่านั้น Flag นี้ไม่มีผลใดๆ
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
ค่าเริ่มต้น: "true"-
ใช้ Android Databinding v2 ที่มีอาร์กิวเมนต์ 3.4.0 Flag นี้ไม่มีผลใดๆ
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--android_dynamic_mode=<off, default or fully>
ค่าเริ่มต้น: "off"-
กำหนดว่าจะลิงก์ส่วน C++ ของกฎ Android แบบไดนามิกหรือไม่ เมื่อ cc_binary ไม่ได้สร้างไลบรารีที่ใช้ร่วมกันอย่างชัดแจ้ง "default" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "ทั้งหมด" หมายความว่าระบบจะลิงก์คลังทั้งหมดแบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "alphabetical" -
กำหนดลำดับของไฟล์ Manifest ที่ส่งไปยังการรวมไฟล์ Manifest สำหรับไบนารีของ Android ALPHABETICAL หมายความว่าไฟล์ Manifest จะจัดเรียงตามเส้นทางที่สัมพันธ์กับ execroot 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
ค่าเริ่มต้น: "auto"-
สร้างไฟล์ ZIP ที่เรียกใช้งานได้ของ Python เปิดใน Windows ปิดในแพลตฟอร์มอื่นๆ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--catalyst_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple Catalyst
แท็ก:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
ค่าเริ่มต้น: "false"-
หากระบุ Bazel จะกำหนดรหัสเครื่องมือ (โดยใช้การใช้เครื่องมือแบบออฟไลน์หากเป็นไปได้) และจะรวบรวมข้อมูลการครอบคลุมระหว่างการทดสอบ เฉพาะเป้าหมายที่ตรงกับ --instrumentation_filter เท่านั้นที่จะได้รับผลกระทบ โดยปกติแล้วคุณไม่ควรระบุตัวเลือกนี้โดยตรง ควรใช้คำสั่ง "bazelครอบคลุมถึง" แทน
แท็ก: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>
default: ดูคำอธิบาย-
ใช้ข้อมูลโปรไฟล์ CSFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อเส้นทางสัมบูรณ์ของไฟล์ ZIP ที่มีไฟล์โปรไฟล์ ไฟล์โปรไฟล์ LLVM ดิบ หรือไฟล์โปรไฟล์ LLVM ที่จัดทําดัชนี
แท็ก:affects_outputs
--cs_fdo_instrument=<a string>
default: ดูคำอธิบาย-
สร้างไบนารีด้วยเครื่องมือ FDO ที่คำนึงถึงบริบท เมื่อใช้คอมไพเลอร์ Clang/LLVM ระบบจะยอมรับชื่อไดเรกทอรีที่จะใช้วางไฟล์โปรไฟล์ดิบเมื่อรันไทม์ด้วย
แท็ก:affects_outputs
--cs_fdo_profile=<a build target label>
default: ดูคำอธิบาย-
cs_fdo_profile ที่แสดงถึงโปรไฟล์ที่ละเอียดอ่อนตามบริบทที่จะใช้เพื่อการเพิ่มประสิทธิภาพ
แท็ก:affects_outputs
--cxxopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ซอร์ส C++
แท็ก:action_command_lines
,affects_outputs
--define=<a 'name=value' assignment>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือก --define แต่ละรายการจะระบุการมอบหมายสำหรับตัวแปรบิลด์
แท็ก:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
ค่าเริ่มต้น: "default"-
กำหนดว่าจะลิงก์ไบนารี C++ แบบไดนามิกหรือไม่ "default" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "โดยสมบูรณ์" หมายความว่าไลบรารีทั้งหมดจะมีการเชื่อมโยงแบบไดนามิก "ปิด" หมายความว่าระบบจะลิงก์คลังทั้งหมดในโหมดคงที่ส่วนใหญ่
แท็ก:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
ค่าเริ่มต้น: "true"-
หากตั้งค่าไว้ การใช้ fdo_absolute_profile_path จะทำให้เกิดข้อผิดพลาด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]enable_runfiles
: "อัตโนมัติ" -
เปิดใช้โครงสร้างลิงก์สัญลักษณ์ของ Runfiles ซึ่งโดยค่าเริ่มต้นจะปิดอยู่ใน Windows และในแพลตฟอร์มอื่นๆ
แท็ก:affects_outputs
--experimental_action_listener=<a build target label>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
เลิกใช้งานไปทีละด้าน ใช้ action_listener เพื่อแนบทางลัดไปยังการดำเนินการบิลด์ที่มีอยู่
แท็ก:execution
,experimental
--[no]experimental_android_compress_java_resources
ค่าเริ่มต้น: "false"-
บีบอัดทรัพยากร Java ใน APK
แท็ก:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
ค่าเริ่มต้น: "true"-
ใช้ Android Data Binding v2 Flag นี้ไม่มีผลใดๆ
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
ค่าเริ่มต้น: "false"-
เปิดใช้การลดขนาดทรัพยากรสำหรับ APK ประเภท android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
ค่าเริ่มต้น: "false"-
ใช้เครื่องมือ rex เพื่อเขียนไฟล์ dex ใหม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
ค่าเริ่มต้น: "false"-
หากระบุไว้ Bazel จะสร้างและรวบรวมข้อมูลการครอบคลุมสำหรับไฟล์ที่สร้างขึ้นด้วย
แท็ก:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
ค่าเริ่มต้น: "-O0,-DDEBUG=1"-
ใช้สตริงเหล่านี้เป็นตัวเลือกคอมไพเลอร์ objc Fastbuild
แท็ก:action_command_lines
--[no]experimental_omitfp
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" ระบบจะใช้ libunwind สำหรับการเลิกซ้อนของกอง และคอมไพล์ด้วย -fomit-frame-pointer และ -fasynchronous-unwind-tables
แท็ก:action_command_lines
,affects_outputs
,experimental
- ค่าเริ่มต้นของ
--experimental_output_paths=<off, content or strip>
: "off" -
โมเดลที่ควรใช้สำหรับส่วนใดในกฎผังเอาต์พุตจะเขียนเอาต์พุต โดยเฉพาะอย่างยิ่งสำหรับบิลด์ที่มีหลายแพลตฟอร์ม / หลายการกำหนดค่า ฟีเจอร์นี้อยู่ในขั้นทดลอง ดูรายละเอียดได้ที่ 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 โดยที่ label หมายถึงแพลตฟอร์ม และ values คือชื่อย่อที่ต้องการใช้ในเส้นทางเอาต์พุต ใช้เมื่อ --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_heuristic ให้ใช้ชื่อย่อตามป้ายกำกับแพลตฟอร์มปัจจุบัน สุดท้าย ระบบจะใช้แฮชของตัวเลือกแพลตฟอร์มเป็นทางเลือกสุดท้าย
แท็ก:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
ค่าเริ่มต้น: "false"-
หากระบุไว้ 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. หากระบุ Flag นี้ ระบบจะไม่สนใจ --android_cpu สำหรับข้อกำหนดของกฎ android_binary
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
ค่าเริ่มต้น: "false"-
สร้างการแยก HWASAN หรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
default: ดูคำอธิบาย-
สร้างไบนารีด้วยเครื่องมือ FDO เมื่อใช้คอมไพเลอร์ Clang/LLVM ระบบจะยอมรับชื่อไดเรกทอรีที่จะใช้วางไฟล์โปรไฟล์ดิบเมื่อรันไทม์ด้วย
แท็ก:affects_outputs
--fdo_optimize=<a string>
default: ดูคำอธิบาย-
ใช้ข้อมูลโปรไฟล์ FDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อไฟล์ ZIP ที่มีโครงสร้างไฟล์ .gcda, ไฟล์ afdo ที่มีโปรไฟล์อัตโนมัติ หรือไฟล์โปรไฟล์ LLVM นอกจากนี้ Flag นี้ยังยอมรับไฟล์ที่ระบุเป็นป้ายกำกับ (เช่น `//foo/bar:file.afdo` - คุณอาจต้องเพิ่มคำสั่ง `exports_files` ลงในแพ็กเกจที่เกี่ยวข้อง) และป้ายกำกับที่ชี้ไปยังเป้าหมาย `fdo_profile` ด้วย กฎ `fdo_profile` จะลบล้าง Flag นี้
แท็ก:affects_outputs
--fdo_prefetch_hints=<a build target label>
default: ดูคำอธิบาย-
ใช้คำแนะนำการดึงข้อมูลแคชล่วงหน้า
แท็ก:affects_outputs
--fdo_profile=<a build target label>
default: ดูคำอธิบาย-
fdo_profile ที่แสดงถึงโปรไฟล์ที่จะใช้เพิ่มประสิทธิภาพ
แท็ก:affects_outputs
--features=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบบจะเปิดหรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างขึ้นในการกำหนดค่าเป้าหมาย การระบุ -<feature> จะปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ ดูข้อมูลเพิ่มเติมได้ที่ --host_features
แท็ก:changes_inputs
,affects_outputs
--[no]force_pic
ค่าเริ่มต้น: "false"-
หากเปิดใช้ การคอมไพล์ C++ ทั้งหมดจะสร้างโค้ดที่ไม่ขึ้นกับตำแหน่ง ("-fPIC") การลิงก์จะเลือกไลบรารีที่สร้างไว้ล่วงหน้าแบบ PIC มากกว่าไลบรารีที่ไม่ใช่ PIC และการลิงก์จะสร้างไฟล์ปฏิบัติการที่ไม่ขึ้นกับตำแหน่ง ("-pie")
แท็ก:loading_and_analysis
,affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกําหนดค่าการดําเนินการ คุณระบุตัวแปรได้ด้วยชื่อ ซึ่งในกรณีนี้ระบบจะนําค่าจากสภาพแวดล้อมการเรียกใช้ หรือคู่ 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++) ในการกำหนดค่า exec
แท็ก:action_command_lines
,affects_outputs
--host_copt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยังคอมไพเลอร์ C สําหรับเครื่องมือที่สร้างในการกําหนดค่า exec
แท็ก: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 เมื่อลิงก์เครื่องมือในการกําหนดค่า exec
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้น
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน macOS ขั้นต่ำที่เข้ากันได้สำหรับเป้าหมายโฮสต์ หากไม่ระบุ ระบบจะใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมในการส่งไปยังคอมไพเลอร์ C/C++ แบบเลือกได้เมื่อคอมไพล์ไฟล์บางไฟล์ในการกําหนดค่า exec ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter หมายถึงรายการรูปแบบนิพจน์ทั่วไปที่รวมและไม่รวม (ดูที่ --instrumentation_filter ด้วย) option_1 ถึง option_n หมายถึงตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีคอมมา จะต้องใส่เครื่องหมายคำพูดด้วยเครื่องหมายแบ็กสแลช ตัวเลือกอาจมี @ แต่ระบบจะใช้เฉพาะ @ แรกในการแยกสตริง ตัวอย่างเช่น --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 จะเพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ลงในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
,affects_outputs
--host_swiftcopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง swiftc สําหรับเครื่องมือ exec
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้น
--[no]incompatible_auto_exec_groups
: "เท็จ" -
เมื่อเปิดใช้ ระบบจะสร้างกลุ่ม exec โดยอัตโนมัติสําหรับเครื่องมือทางเทคนิคแต่ละรายการที่กฎใช้ กฎในการทำงานนี้ต้องระบุพารามิเตอร์ "toolchain" ในการดำเนินการ ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/17134
แท็ก:affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ระบบจะรวมไดเรกทอรี genfiles ไว้ในไดเรกทอรี bin
แท็ก:affects_outputs
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_use_host_features
: "จริง" -
หากเป็น "จริง" ให้ใช้ --features สำหรับการกำหนดค่าเป้าหมายเท่านั้น และ --host_features สำหรับการกำหนดค่า exec
แท็ก:changes_inputs
,affects_outputs
,incompatible_change
--[no]instrument_test_targets
ค่าเริ่มต้น: "false"-
เมื่อเปิดใช้การครอบคลุม ให้ระบุว่าจะพิจารณาเครื่องมือวัดกฎการทดสอบหรือไม่ เมื่อตั้งค่าแล้ว กฎการทดสอบที่ --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')>
default: ดูคำอธิบาย-
เวอร์ชัน iOS ที่เข้ากันได้ขั้นต่ำสำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ระบุ ระบบจะใช้ "ios_sdk_version"
แท็ก:loses_incremental_state
--ios_multi_cpus=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้าง ios_application ผลลัพธ์จะเป็นไบนารีสากลที่มีสถาปัตยกรรมที่ระบุทั้งหมด
แท็ก:loses_incremental_state
,loading_and_analysis
- ค่าเริ่มต้น
--[no]legacy_whole_archive
: "จริง" -
เลิกใช้งานแล้ว แทนที่ด้วย --incompatible_remove_legacy_whole_archive (ดูรายละเอียดที่ https://github.com/bazelbuild/bazel/issues/7362) เมื่อเปิดใช้ ให้ใช้ --whole-archive สำหรับกฎ cc_binary ที่มี linkshared=True และ linkstatic=True หรือ "-static" ใน linkopts ตัวเลือกนี้มีไว้เพื่อให้ใช้กับเวอร์ชันก่อนหน้าได้เท่านั้น อีกทางเลือกหนึ่งที่ดีกว่าคือการใช้ Alwayslink=1 เมื่อจำเป็น
แท็ก:action_command_lines
,affects_outputs
,deprecated
--linkopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc เมื่อลิงก์
แท็ก:action_command_lines
,affects_outputs
--ltobackendopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยังขั้นตอนแบ็กเอนด์ LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
,affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ltoindexopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมที่จะส่งไปยังขั้นตอนการจัดทำดัชนี LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
,affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--macos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple macOS
แท็ก:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: ดูคำอธิบาย-
เวอร์ชัน macOS ขั้นต่ำที่เข้ากันได้สำหรับเป้าหมาย หากไม่ระบุ ระบบจะใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
--memprof_profile=<a build target label>
default: ดูคำอธิบาย-
ใช้โปรไฟล์ memprof
แท็ก:affects_outputs
--[no]objc_debug_with_GLIBCXX
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ และตั้งค่าโหมดการคอมไพล์เป็น "dbg" ให้กำหนด GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC และ GLIBCPP_CONCEPT_CHECKS
แท็ก:action_command_lines
--[no]objc_enable_binary_stripping
ค่าเริ่มต้น: "false"-
กำหนดว่าจะทำการลบสัญลักษณ์และโค้ดที่ตายแล้วในไบนารีที่ลิงก์หรือไม่ ระบบจะดำเนินการลบข้อมูลในไบนารีหากระบุทั้ง 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>
default: ดูคำอธิบาย-
ระบุส่วนต่อท้ายที่จะเพิ่มในไดเรกทอรีการกำหนดค่า
แท็ก:loses_incremental_state
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--propeller_optimize=<a build target label>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ Propeller เพื่อเพิ่มประสิทธิภาพเป้าหมายการสร้าง โปรไฟล์ Propeller ต้องมีไฟล์อย่างน้อย 1 ใน 2 ไฟล์ ได้แก่ โปรไฟล์ cc และโปรไฟล์ ld Flag นี้ยอมรับป้ายกำกับบิลด์ซึ่งต้องอ้างอิงถึงไฟล์อินพุตโปรไฟล์ใบพัด เช่น ไฟล์ BUILD ที่กําหนดป้ายกํากับใน a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",) อาจต้องเพิ่มคําสั่ง exports_files ลงในแพ็กเกจที่เกี่ยวข้องเพื่อให้ Bazel เห็นไฟล์เหล่านี้ ตัวเลือกนี้ต้องใช้ในรูปแบบ --propeller_optimize=//a/b:propeller_profile
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้น
--propeller_optimize_absolute_cc_profile=<a string>
: ดูคำอธิบาย -
ชื่อเส้นทางสัมบูรณ์ของไฟล์ cc_profile สำหรับบิลด์ Propeller Optimized
แท็ก:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
default: ดูคำอธิบาย-
ชื่อเส้นทางแบบสัมบูรณ์ของไฟล์ ld_profile สำหรับบิลด์ Propeller Optimized
แท็ก:affects_outputs
--run_under=<a prefix in front of command>
default: ดูคำอธิบาย-
คำนำหน้าที่จะแทรกไว้ก่อนไฟล์ปฏิบัติการสำหรับคำสั่ง "test" และ "run" หากค่าคือ "foo -bar" และบรรทัดคำสั่งสำหรับการดำเนินการคือ "test_binary -baz" บรรทัดคำสั่งสุดท้ายคือ "foo -bar test_binary -baz" บรรทัดคำสั่งนี้อาจเป็นป้ายกำกับของเป้าหมายสั่งการได้ด้วย ตัวอย่างบางส่วน ได้แก่ "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", '//package:target', '//package:target --options'
แท็ก:action_command_lines
-
หากเป็น "จริง" ระบบจะแชร์ไลบรารีเนทีฟที่มีฟังก์ชันการทำงานเหมือนกันระหว่างเป้าหมายต่างๆ
แท็ก:loading_and_analysis
,affects_outputs
- ค่าเริ่มต้น
--[no]stamp
: "เท็จ" -
ประทับไบนารีด้วยวันที่ ชื่อผู้ใช้ ชื่อโฮสต์ ข้อมูลพื้นที่ทำงาน ฯลฯ
แท็ก:affects_outputs
- ค่าเริ่มต้น
--strip=<always, sometimes or never>
: "บางครั้ง" -
ระบุว่าจะตัดไบนารีและไลบรารีที่แชร์หรือไม่ (โดยใช้ "-Wl,--strip-debug") ค่าเริ่มต้นของ "บางครั้ง" หมายถึง "strip" เฉพาะในกรณีที่ --compilation_mode=fastbuild
แท็ก:affects_outputs
--stripopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง strip เมื่อสร้างไบนารี "<name>.stripped"
แท็ก:action_command_lines
,affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--swiftcopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมที่จะส่งไปยังการคอมไพล์ Swift
แท็ก:action_command_lines
--tvos_cpus=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารี Apple tvOS
แท็ก:loses_incremental_state
,loading_and_analysis
- ค่าเริ่มต้น
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน tvOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ระบุ ระบบจะใช้ "tvos_sdk_version"
แท็ก:loses_incremental_state
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--visionos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารี Apple VisionOS
แท็ก:loses_incremental_state
,loading_and_analysis
--watchos_cpus=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple watchOS
แท็ก:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: ดูคำอธิบาย-
เวอร์ชัน WatchOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ระบุ ระบบจะใช้ "watchos_sdk_version"
แท็ก:loses_incremental_state
--xbinary_fdo=<a build target label>
default: ดูคำอธิบาย-
ใช้ข้อมูลโปรไฟล์ XbinaryFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อโปรไฟล์ข้ามไบนารีเริ่มต้น เมื่อใช้ตัวเลือกนี้ร่วมกับ --fdo_instrument/--fdo_optimize/--fdo_profile ตัวเลือกเหล่านั้นจะมีผลเสมอ ราวกับว่าไม่ได้ระบุ xbinary_fdo เลย
แท็ก:affects_outputs
- ตัวเลือกที่ส่งผลต่อความเข้มงวดที่ Bazel ใช้บังคับอินพุตการสร้างที่ถูกต้อง (คําจํากัดความของกฎ ชุดค่าผสมของ Flag ฯลฯ)
- ค่าเริ่มต้น
--auto_cpu_environment_group=<a build target label>
: "" -
ประกาศ environment_group ที่จะใช้สําหรับการแมปค่า cpu กับค่า target_environment โดยอัตโนมัติ
แท็ก:changes_inputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]check_licenses
: "เท็จ" -
ตรวจสอบว่าข้อจำกัดการอนุญาตให้ใช้สิทธิที่แพ็กเกจที่ต้องพึ่งพากำหนดไว้ไม่ขัดแย้งกับโหมดการจัดจำหน่ายของเป้าหมายที่สร้าง โดยค่าเริ่มต้น ใบอนุญาตจะไม่ได้รับการตรวจสอบ
แท็ก:build_file_semantics
--[no]check_visibility
ค่าเริ่มต้น: "true"-
หากปิดใช้ ระบบจะลดระดับข้อผิดพลาดด้านการแสดงผลในข้อกําหนดของเป้าหมายเป็นคําเตือน
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]desugar_for_android
: "จริง" -
กำหนดว่าจะ Dexugar ไบต์โค้ด Java 8 ก่อนถอดรหัสหรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
ค่าเริ่มต้น: "false"-
การรวมไลบรารี Java 8 ที่รองรับไว้ในแอปสำหรับอุปกรณ์รุ่นเดิมหรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
ค่าเริ่มต้น: "true"-
ตรวจสอบสภาพแวดล้อมที่เป้าหมายแต่ละรายการเข้ากันได้ และรายงานข้อผิดพลาดหากเป้าหมายใดมีทรัพยากร Dependencies ที่ไม่รองรับสภาพแวดล้อมเดียวกัน
แท็ก:build_file_semantics
--[no]experimental_check_desugar_deps
ค่าเริ่มต้น: "true"-
กำหนดว่าจะตรวจสอบการลดน้ำตาลที่ถูกต้องอีกครั้งที่ระดับไบนารีของ Android หรือไม่
แท็ก:eagerness_to_exit
,loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--experimental_import_deps_checking=<off, warning or error>
: "OFF" -
เมื่อเปิดใช้แล้ว ให้ตรวจสอบว่ารายการอ้างอิงของ aar_import สมบูรณ์หรือไม่ การบังคับใช้นี้อาจทำให้บิลด์ใช้งานไม่ได้ หรืออาจส่งผลให้เกิดคำเตือนเท่านั้น
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--experimental_one_version_enforcement=<off, warning or error>
: "OFF" -
เมื่อเปิดใช้ กฎ 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
ค่าเริ่มต้น: "false"-
หากเปิดใช้ ให้ตรวจสอบ testonly สำหรับเป้าหมายที่เป็นข้อกําหนดเบื้องต้นซึ่งเป็นไฟล์เอาต์พุตโดยค้นหา testonly ของกฎการสร้าง ซึ่งตรงกับการตรวจสอบระดับการเข้าถึง
แท็ก:build_file_semantics
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_check_visibility_for_toolchains
: "เท็จ" -
หากเปิดใช้ การตรวจสอบระดับการเข้าถึงจะมีผลกับการติดตั้งใช้งานเครื่องมือทางเทคนิคด้วย
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
ค่าเริ่มต้น: "false"-
หากเปิดใช้ ระบบจะปิดใช้กฎเนทีฟของ Android โดยตรง โปรดใช้กฎ Starlark สำหรับ Android จาก https://github.com/bazelbuild/rules_android
แท็ก:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
ค่าเริ่มต้น: "false"-
ไม่มีการดำเนินการใดๆ เก็บไว้ที่นี่เพื่อให้มีความเข้ากันได้แบบย้อนหลัง
แท็ก:eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_python_disable_py2
: "true" -
หากเป็นจริง การใช้การตั้งค่า Python 2 จะทำให้เกิดข้อผิดพลาด ซึ่งรวมถึง python_version=PY2, srcs_version=PY2 และ srcs_version=PY2ONLY ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/15684
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" Bazel จะตรวจสอบการรวมส่วนหัวของไดเรกทอรีระดับบนสุดด้วย (ดูข้อมูลเพิ่มเติมที่ https://github.com/bazelbuild/bazel/issues/10047)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้น
--[no]one_version_enforcement_on_java_tests
: "จริง" -
เมื่อเปิดใช้ และตั้งค่าการทดลอง_one_version_enforcement เป็นค่าที่ไม่ใช่ NONE แล้ว ให้บังคับใช้ 1 เวอร์ชันกับเป้าหมาย java_test คุณปิดใช้ Flag นี้เพื่อปรับปรุงประสิทธิภาพการทดสอบที่เพิ่มขึ้นได้ แต่อาจพลาดการละเมิดเวอร์ชันเดียวที่อาจเกิดขึ้น
แท็ก:loading_and_analysis
--python_native_rules_allowlist=<a build target label>
default: ดูคำอธิบาย-
รายการที่อนุญาต (เป้าหมาย package_group) เพื่อใช้เมื่อบังคับใช้ --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>
ค่าเริ่มต้น: "error"-
ยกเว้นในกรณีที่เป็น OFF ระบบจะตรวจสอบว่าเป้าหมาย proto_library ประกาศเป้าหมายทั้งหมดที่ใช้โดยตรงเป็น Dependency อย่างชัดแจ้ง
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้นของ
--strict_public_imports=<off, warn, error, strict or default>
: "off" -
ยกเว้นในกรณีที่ปิดอยู่ ระบบจะตรวจสอบว่าเป้าหมาย proto_library ประกาศเป้าหมายทั้งหมดที่ใช้ใน "import public" เป็นการนําส่งอย่างชัดแจ้ง
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" จะต้องประกาศส่วนหัวที่พบผ่านเส้นทางรวมของระบบ (-isystem) ด้วย
แท็ก:loading_and_analysis
,eagerness_to_exit
--target_environment=<a build target label>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ประกาศสภาพแวดล้อมเป้าหมายของบิลด์นี้ ต้องเป็นการอ้างอิงป้ายกำกับไปยังกฎ "environment" หากระบุไว้ เป้าหมายระดับบนสุดทั้งหมดต้องเข้ากันได้กับสภาพแวดล้อมนี้
แท็ก: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
: "จริง" -
หากตั้งค่าแล้ว และโหมดการคอมไพล์ไม่ใช่ "เพิ่มประสิทธิภาพ" แอป objc จะรวมการให้สิทธิ์การแก้ไขข้อบกพร่องไว้ด้วยเมื่อลงนาม
แท็ก:changes_inputs
--ios_signing_cert_name=<a string>
default: ดูคำอธิบาย-
ชื่อใบรับรองที่จะใช้สำหรับ iOS Signing หากไม่ได้ตั้งค่าไว้ ระบบจะใช้โปรไฟล์การจัดสรรแทน อาจเป็นค่ากำหนดข้อมูลประจำตัว Keychain ของใบรับรองหรือ (สตริงย่อย) ของชื่อสามัญของใบรับรองตามหน้า man ของ Codesign (รหัสการลงชื่อเข้าใช้)
แท็ก:action_command_lines
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
--[no]incompatible_disallow_legacy_py_provider
ค่าเริ่มต้น: "true"-
ไม่มีการดำเนินการ จะถูกนำออกในเร็วๆ นี้
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" ไม่อนุญาตแอตทริบิวต์ sdk_frameworks และ external_sdk_frameworks ใน objc_library andobjc_import
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" ให้ตั้งค่าเริ่มต้นเป็น "จริง" สําหรับแอตทริบิวต์ alwayslink ใน objc_library และ objc_import
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
ค่าเริ่มต้น: "false"-
เมื่อเป็นจริง ระบบจะแสดงข้อผิดพลาดเมื่อใช้กฎ py_* ในตัว คุณจึงควรใช้กฎ "rule_python" แทน ดูข้อมูลเพิ่มเติมและวิธีการย้ายข้อมูลได้ที่ https://github.com/bazelbuild/bazel/issues/17773
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่ควบคุมลักษณะการทํางานของสภาพแวดล้อมการทดสอบหรือโปรแกรมรันทดสอบ
--[no]allow_analysis_failures
ค่าเริ่มต้น: "false"-
หากเป็นจริง การวิเคราะห์เป้าหมายของกฎไม่สำเร็จส่งผลให้เกิดการเผยแพร่อินสแตนซ์ของ AnalysisFailureInfo ของเป้าหมายที่มีคำอธิบายข้อผิดพลาด แทนที่จะทำให้บิลด์ล้มเหลว
แท็ก:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
ค่าเริ่มต้น: "2000"-
กำหนดจำนวนสูงสุดของความสัมพันธ์แบบทรานซิทีฟผ่านแอตทริบิวต์กฎที่มีการเปลี่ยนการกำหนดค่า for_analysis_testing เกินขีดจำกัดนี้จะทำให้เกิดข้อผิดพลาดของกฎ
แท็ก:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
ค่าเริ่มต้น: "false"-
หากความล้มเหลวจริงในการดำเนินการ dex2oat จะทำให้บิลด์ขัดข้องแทนที่จะเรียกใช้ dex2oat ระหว่างรันไทม์ทดสอบ
แท็ก:loading_and_analysis
,experimental
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g. memory=10,30,60,100>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างจำนวนทรัพยากรเริ่มต้นสำหรับการทดสอบ รูปแบบที่รองรับคือ <resource>=<value> หากระบุตัวเลขบวกเพียงค่าเดียวเป็น <value> ระบบจะลบล้างทรัพยากรเริ่มต้นสำหรับขนาดการทดสอบทั้งหมด หากระบุตัวเลข 4 รายการที่คั่นด้วยคอมมา ระบบจะลบล้างจำนวนทรัพยากรสําหรับขนาดการทดสอบขนาดเล็ก กลาง ใหญ่ และใหญ่มากตามลําดับ ค่าอาจเป็น HOST_RAM/HOST_CPU หรือจะตามด้วย [-|*]<Float> ก็ได้ (เช่น Memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4) ทรัพยากรการทดสอบเริ่มต้นที่ระบุโดย Flag นี้จะลบล้างโดยทรัพยากรที่ระบุอย่างชัดเจนในแท็ก
--[no]experimental_android_use_parallel_dex2oat
ค่าเริ่มต้น: "false"-
ใช้ dex2oat ควบคู่กันเพื่อเพิ่มความเร็วของ android_test
แท็ก:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- ค่าเริ่มต้น
--[no]ios_memleaks
: "เท็จ" -
เปิดใช้การตรวจหาหน่วยความจำรั่วไหลในเป้าหมาย ios_test
แท็ก:action_command_lines
--ios_simulator_device=<a string>
default: ดูคำอธิบาย-
อุปกรณ์ที่จะจําลองเมื่อเรียกใช้แอปพลิเคชัน iOS ในโปรแกรมจําลอง เช่น "iPhone 6" คุณสามารถดูรายการอุปกรณ์ได้โดยเรียกใช้ "xcrun simctl list devicetypes" ในเครื่องที่เครื่องจำลองจะทำงาน
แท็ก:test_runner
- ค่าเริ่มต้น
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน iOS ที่จะใช้งานบนเครื่องจำลองเมื่อเรียกใช้หรือทดสอบ ระบบจะไม่สนใจกฎ ios_test หากกฎระบุอุปกรณ์เป้าหมายไว้ในกฎ
แท็ก:test_runner
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ระบุจํานวนครั้งที่จะเรียกใช้การทดสอบแต่ละรายการ หากการดำเนินการเหล่านั้นล้มเหลวไม่ว่าด้วยเหตุผลใดก็ตาม จะถือว่าการทดสอบทั้งหมดไม่ผ่าน โดยปกติแล้ว ค่าที่ระบุจะเป็นแค่จำนวนเต็ม ตัวอย่างเช่น --runs_per_test=3 จะเรียกใช้การทดสอบทั้งหมด 3 ครั้ง ไวยากรณ์สำรอง: regex_filter@runs_per_test โดยที่ runs_per_test หมายถึงค่าจำนวนเต็ม และ regex_filter หมายถึงรายการรูปแบบนิพจน์ทั่วไปที่รวมและไม่รวม (ดู --instrumentation_filter ด้วย) ตัวอย่างเช่น --runs_per_test=//foo/.*,-//foo/bar/.*@3 เรียกใช้การทดสอบทั้งหมดใน //foo/ ยกเว้นการทดสอบที่อยู่ใน foo/bar 3 ครั้ง ตัวเลือกนี้ส่งได้หลายครั้ง อาร์กิวเมนต์ที่ส่งผ่านล่าสุดที่ตรงกันจะมีความสำคัญเหนือกว่า หากไม่พบรายการที่ตรงกัน ระบบจะเรียกใช้การทดสอบเพียงครั้งเดียว
--test_env=<a 'name=value' assignment with an optional value part>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุตัวแปรสภาพแวดล้อมเพิ่มเติมที่จะแทรกลงในสภาพแวดล้อมโปรแกรมรันทดสอบ คุณระบุตัวแปรได้โดยใช้ชื่อ ซึ่งในกรณีนี้ระบบจะอ่านค่าของตัวแปรจากสภาพแวดล้อมไคลเอ็นต์ Bazel หรือด้วยคู่ชื่อ=ค่า คุณใช้ตัวเลือกนี้หลายครั้งเพื่อระบุตัวแปรหลายรายการได้ ใช้เฉพาะโดยคำสั่ง "การทดสอบ Bazel" เท่านั้น
แท็ก:test_runner
- ค่าเริ่มต้น
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - ลบล้างค่าระยะหมดเวลาในการทดสอบเริ่มต้นสำหรับระยะหมดเวลาทดสอบ (เป็นวินาที) หากระบุค่าจำนวนเต็มบวกเพียงค่าเดียว ระบบจะลบล้างหมวดหมู่ทั้งหมด หากระบุจำนวนเต็ม 4 รายการที่คั่นด้วยคอมมา ระบบจะลบล้างการหมดเวลาสำหรับระยะสั้น ปานกลาง ยาว และตลอดไป (ตามลำดับ) ไม่ว่ารูปแบบใด ค่า -1 จะบอกให้ Blaze ใช้การหมดเวลาเริ่มต้นสำหรับหมวดหมู่นั้น
--[no]zip_undeclared_test_outputs
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ระบบจะเก็บถาวรเอาต์พุตการทดสอบที่ไม่ได้ประกาศไว้ในไฟล์ ZIP
แท็ก:test_runner
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตการค้นหาและความหมาย
- ค่าเริ่มต้นของ
--aspect_deps=<off, conservative or precise>
: "เชิงรับ" -
วิธีแก้ไขการพึ่งพาแง่มุมเมื่อรูปแบบเอาต์พุตเป็นหนึ่งใน {xml,proto,record} "ปิด" หมายความว่าไม่มีการแก้ไขข้อกําหนดของมิติข้อมูล "แบบอนุรักษ์นิยม" (ค่าเริ่มต้น) หมายความว่าระบบจะเพิ่มข้อกําหนดของมิติข้อมูลที่ประกาศไว้ทั้งหมด ไม่ว่าจะได้รับคลาสกฎของข้อกําหนดโดยตรงหรือไม่ "แม่นยํา" หมายความว่าระบบจะเพิ่มเฉพาะมิติข้อมูลเหล่านั้นที่อาจใช้งานได้โดยพิจารณาจากคลาสกฎของข้อกําหนดโดยตรง โปรดทราบว่าโหมดที่แม่นยำต้องโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียว จึงทําให้ช้ากว่าโหมดอื่นๆ และโปรดทราบว่าแม้แต่โหมดที่แม่นยำก็ไม่ได้แม่นยำทั้งหมด การตัดสินใจว่าจะคำนวณด้านใดด้านหนึ่งหรือไม่จะทำในขั้นตอนการวิเคราะห์ ซึ่งจะไม่ทำงานระหว่าง "การค้นหาแบบทำให้สับสน"
แท็ก:build_file_semantics
--[no]consistent_labels
ค่าเริ่มต้น: "false"-
หากเปิดใช้ คำสั่งการค้นหาทุกรายการจะแสดงป้ายกำกับราวกับว่าฟังก์ชัน <code>str</code> ของ Starlark มีผลกับอินสแตนซ์ <code>Label</code> ซึ่งมีประโยชน์สําหรับเครื่องมือที่ต้องจับคู่เอาต์พุตของคําสั่งการค้นหาและ/หรือป้ายกำกับต่างๆ ที่กฎสร้างขึ้น หากไม่ได้เปิดใช้ ตัวจัดรูปแบบเอาต์พุตจะแสดงชื่อที่เก็บที่ชัดเจน (สัมพันธ์กับที่เก็บหลัก) แทนเพื่อให้อ่านเอาต์พุตได้ง่ายขึ้น
แท็ก:terminal_output
--[no]experimental_explicit_aspects
ค่าเริ่มต้น: "false"-
aquery, cquery: ระบุว่าจะรวมการดำเนินการที่เกิดจากแง่มุมไว้ในเอาต์พุตหรือไม่ query: no-op (ระบบจะตามแง่มุมเสมอ)
แท็ก:terminal_output
--[no]graph:factored
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ระบบจะแสดงกราฟที่ "แยกปัจจัย" กล่าวคือ จะผสานโหนดที่เทียบเท่ากันตามแบบแผนเข้าด้วยกันและต่อป้ายกำกับของโหนดเหล่านั้น ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
--graph:node_limit=<an integer>
ค่าเริ่มต้น: "512"-
ความยาวสูงสุดของสตริงป้ายกำกับสำหรับโหนดกราฟในเอาต์พุต ระบบจะตัดป้ายกำกับที่ยาวกว่าออก โดย -1 หมายความว่าไม่ตัดออก ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
--[no]implicit_deps
ค่าเริ่มต้น: "true"-
หากเปิดใช้ ทรัพยากร Dependency ที่ไม่ชัดแจ้งจะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงานอยู่ Dependency ที่ไม่ชัดแจ้งคือ Dependency ที่ไม่ได้ระบุไว้อย่างชัดเจนในไฟล์ BUILD แต่ Bazel เพิ่มเข้ามา สําหรับ cquery ตัวเลือกนี้จะควบคุมการกรองเครื่องมือทางเทคนิคที่แก้ไขแล้ว
แท็ก:build_file_semantics
--[no]include_artifacts
ค่าเริ่มต้น: "true"-
รวมชื่ออินพุตและเอาต์พุตการดําเนินการไว้ในเอาต์พุต (อาจมีขนาดใหญ่)
แท็ก:terminal_output
--[no]include_aspects
ค่าเริ่มต้น: "true"-
aquery, cquery: ระบุว่าจะรวมการดำเนินการที่เกิดจากแง่มุมไว้ในเอาต์พุตหรือไม่ query: no-op (ระบบจะตามแง่มุมเสมอ)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]include_commandline
: "จริง" -
รวมเนื้อหาของบรรทัดคำสั่งการดำเนินการไว้ในเอาต์พุต (อาจมีขนาดใหญ่)
แท็ก:terminal_output
--[no]include_file_write_contents
ค่าเริ่มต้น: "false"-
รวมเนื้อหาไฟล์สำหรับการดำเนินการ FileWrite, SourceSymlinkManifest และ RepoMappingManifest (ซึ่งอาจมีขนาดใหญ่)
แท็ก:terminal_output
--[no]include_param_files
ค่าเริ่มต้น: "false"-
รวมเนื้อหาของไฟล์พารามิเตอร์ที่ใช้ในคำสั่ง (อาจมีขนาดใหญ่) หมายเหตุ: การเปิดใช้ Flag นี้จะเปิดใช้ Flag --include_commandline โดยอัตโนมัติ
แท็ก:terminal_output
--[no]incompatible_package_group_includes_double_slash
ค่าเริ่มต้น: "true"-
หากเปิดใช้ เมื่อแสดงผลแอตทริบิวต์ "packages" ของ package_group ระบบจะไม่ละเว้น "//" ที่อยู่ด้านหน้า
แท็ก:terminal_output
,incompatible_change
--[no]infer_universe_scope
ค่าเริ่มต้น: "false"-
หากตั้งค่าและไม่ได้ตั้งค่า --universe_scope ระบบจะอนุมานค่าของ --universe_scope เป็นรายการรูปแบบเป้าหมายที่ไม่ซ้ำกันในนิพจน์การค้นหา โปรดทราบว่าค่า --universe_scope ที่อนุมานสําหรับนิพจน์การค้นหาที่ใช้ฟังก์ชันระดับจักรวาล (เช่น `allrdeps`) อาจไม่ใช่สิ่งที่คุณต้องการ คุณจึงควรใช้ตัวเลือกนี้เฉพาะในกรณีที่คุณเข้าใจสิ่งที่ทําอยู่ ดูรายละเอียดและตัวอย่างได้ที่ https://bazel.build/reference/query#sky-query หากตั้งค่า --universe_scope แล้ว ระบบจะไม่สนใจค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้มีผลกับ "query" เท่านั้น (ไม่ใช่ "cquery")
แท็ก:loading_and_analysis
--[no]line_terminator_null
ค่าเริ่มต้น: "false"-
แต่ละรูปแบบสิ้นสุดด้วย \0 แทนบรรทัดใหม่หรือไม่
แท็ก:terminal_output
--[no]nodep_deps
ค่าเริ่มต้น: "true"-
หากเปิดใช้ deps จากแอตทริบิวต์ "nodep" จะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาจะดำเนินการ ตัวอย่างทั่วไปของแอตทริบิวต์ "nodep" คือ "ระดับการเข้าถึง" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ "info build-language" เพื่อดูข้อมูลเกี่ยวกับแอตทริบิวต์ "nodep" ทั้งหมดในภาษาของบิลด์
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--output=<a string>
: "ข้อความ" -
รูปแบบที่ควรพิมพ์ผลการค้นหา ค่าที่อนุญาตสำหรับ aquery คือ text, textprotocol, Proto, streamed_profi, jsonprotocol
แท็ก:terminal_output
--[no]proto:default_values
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ระบบจะรวมแอตทริบิวต์ที่ไม่ได้ระบุค่าไว้อย่างชัดแจ้งในไฟล์ BUILD มิเช่นนั้นระบบจะละเว้นแอตทริบิวต์เหล่านั้น ตัวเลือกนี้ใช้ได้กับ --output=proto
แท็ก: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
ค่าเริ่มต้น: "false"-
ป้อนข้อมูลฟิลด์ proto ของ source_aspect_name ของแอตทริบิวต์แต่ละรายการด้วยแง่มุมแหล่งที่มาของแอตทริบิวต์ (สตริงว่างหากไม่มี)
แท็ก:terminal_output
--[no]proto:include_synthetic_attribute_hash
ค่าเริ่มต้น: "false"-
กำหนดว่าจะคำนวณและป้อนข้อมูลแอตทริบิวต์ $internal_attr_hash หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:instantiation_stack
: "เท็จ" -
ป้อนข้อมูลสแต็กการเรียกอินสแตนซ์ของกฎแต่ละข้อ โปรดทราบว่าต้องมีสแต็กอยู่
แท็ก:terminal_output
--[no]proto:locations
ค่าเริ่มต้น: "true"-
แสดงข้อมูลตำแหน่งในเอาต์พุต proto หรือไม่
แท็ก:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
ค่าเริ่มต้น: "all"-
รายการแอตทริบิวต์ที่คั่นด้วยคอมมาที่จะรวมไว้ในเอาต์พุต ค่าเริ่มต้นคือแอตทริบิวต์ทั้งหมด ตั้งค่าเป็นสตริงว่างเปล่าเพื่อไม่ให้แสดงแอตทริบิวต์ใดๆ ตัวเลือกนี้ใช้ได้กับ --output=proto
แท็ก:terminal_output
--[no]proto:rule_inputs_and_outputs
ค่าเริ่มต้น: "true"-
การป้อนข้อมูลในช่อง rule_input และ rule_output หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้น
--query_file=<a string>
: "" -
หากตั้งค่าไว้ การค้นหาจะอ่านการค้นหาจากไฟล์ที่มีชื่อในส่วนนี้ แทนที่จะเป็นบรรทัดคำสั่ง การระบุไฟล์ที่นี่พร้อมกับการค้นหาบรรทัดคำสั่งเป็นข้อผิดพลาด
แท็ก:changes_inputs
--[no]relative_locations
ค่าเริ่มต้น: "false"-
หากเป็นจริง ตำแหน่งของไฟล์ BUILD ใน XML และเอาต์พุต Pro จะสัมพันธ์กัน โดยค่าเริ่มต้น เอาต์พุตตำแหน่งจะเป็นเส้นทางแบบสัมบูรณ์และจะไม่สอดคล้องกันในแต่ละเครื่อง คุณสามารถตั้งค่าตัวเลือกนี้เป็น "จริง" เพื่อให้ได้ผลลัพธ์ที่สอดคล้องกันในทุกเครื่อง
แท็ก:terminal_output
--[no]skyframe_state
ค่าเริ่มต้น: "false"-
วางข้อมูลกราฟการดำเนินการปัจจุบันจาก Skyframe โดยไม่ทำการวิเคราะห์เพิ่มเติม หมายเหตุ: ปัจจุบันระบบยังไม่รองรับการระบุเป้าหมายด้วย --skyframe_state ใช้แฟล็กนี้ได้กับ --output=proto หรือ --output=textproto เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]tool_deps
: "จริง" -
การค้นหา: หากปิดใช้ Dependency ของ "การกําหนดค่า exec" จะไม่รวมอยู่ในกราฟ Dependency ที่การค้นหาทํางาน เอดจ์ของ "การกำหนดค่าผู้ดำเนินการ" เช่น กฎจากกฎ "protocol_library" ไปยังโปรโตคอลคอมไพเลอร์ โดยทั่วไปจะชี้ไปยังเครื่องมือที่ดำเนินการระหว่างบิลด์ ไม่ใช่เป็นส่วนหนึ่งของโปรแกรม "เป้าหมาย" เดียวกัน
Cquery: หากปิดใช้ ระบบจะกรองเป้าหมายที่กําหนดค่าไว้ทั้งหมดซึ่งข้ามการเปลี่ยนสถานะการดําเนินการจากเป้าหมายระดับบนสุดที่ค้นพบเป้าหมายที่กําหนดค่าไว้นี้ ซึ่งหมายความว่าหากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าเป้าหมาย ระบบจะแสดงเฉพาะเป้าหมายที่กำหนดค่าไว้ซึ่งอยู่ในการกำหนดค่าเป้าหมายด้วย หากเป้าหมายระดับบนสุดอยู่ในการกําหนดค่า exec ระบบจะแสดงเฉพาะเป้าหมายที่กําหนดค่า exec ตัวเลือกนี้จะไม่ยกเว้นเครื่องมือทางเทคนิคที่แก้ไขแล้ว
แท็ก:build_file_semantics
--universe_scope=<comma-separated list of options>
ค่าเริ่มต้น: ""-
ชุดรูปแบบเป้าหมายที่คั่นด้วยคอมมา (แบบเพิ่มและแบบลบ) การค้นหาอาจดำเนินการในจักรวาลที่กําหนดโดยการปิดเชิงการเปลี่ยนรูปแบบของเป้าหมายที่ระบุ ตัวเลือกนี้ใช้สําหรับคำสั่งการค้นหาและคำสั่ง cquery
สําหรับ cquery อินพุตของตัวเลือกนี้คือเป้าหมายที่สร้างขึ้นสําหรับคําตอบทั้งหมด ดังนั้นตัวเลือกนี้จึงอาจส่งผลต่อการกำหนดค่าและการเปลี่ยน หากไม่ได้ระบุตัวเลือกนี้ ระบบจะถือว่าเป้าหมายระดับบนสุดเป็นเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหา หมายเหตุ: สําหรับ cquery การไม่ระบุตัวเลือกนี้อาจทําให้บิลด์ใช้งานไม่ได้ หากเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหาไม่สามารถสร้างด้วยตัวเลือกระดับบนสุด
แท็ก:loading_and_analysis
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพของเวลาสร้าง
--[no]experimental_filter_library_jar_with_program_jar
ค่าเริ่มต้น: "false"-
กรอง ProgramJar ของ ProGuard เพื่อนำคลาสที่อยู่ใน LibraryJar ออกด้วย
แท็ก:action_command_lines
--[no]experimental_inmemory_dotd_files
ค่าเริ่มต้น: "true"-
หากเปิดใช้ ระบบจะส่งไฟล์ .d ของ C++ ในหน่วยความจำจากโหนดการสร้างระยะไกลโดยตรงแทนที่จะเขียนลงในดิสก์
แท็ก:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
ค่าเริ่มต้น: "true"-
หากเปิดใช้ ระบบจะส่งไฟล์ที่ต้องพึ่งพา (.jdeps) ที่สร้างขึ้นจากการคอมไพล์ Java ผ่านหน่วยความจำจากโหนดการสร้างระยะไกลโดยตรงแทนที่จะเขียนลงในดิสก์
แท็ก:loading_and_analysis
,execution
,affects_outputs
,experimental
- ค่าเริ่มต้น
--[no]experimental_objc_include_scanning
: "เท็จ" -
กำหนดว่าจะทำการสแกนรวมสำหรับ Objective C/C++ หรือไม่
แท็ก:loading_and_analysis
,execution
,changes_inputs
--[no]experimental_retain_test_configuration_across_testonly
ค่าเริ่มต้น: "false"-
เมื่อเปิดใช้ --trim_test_configuration จะไม่ตัดการกำหนดค่าการทดสอบสำหรับกฎที่มีการทำเครื่องหมาย testonly=1 การดำเนินการนี้มีไว้เพื่อลดปัญหาการขัดแย้งของการดำเนินการเมื่อกฎที่ไม่ใช่การทดสอบขึ้นอยู่กับกฎ cc_test จะไม่มีผลหาก --trim_test_configuration เป็นเท็จ
แท็ก:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
ค่าเริ่มต้น: "false"-
หากเปิดใช้ คุณจะใช้เวอร์ชัน Starlark ของ cc_import ได้
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_unsupported_and_brittle_include_scanning
: "เท็จ" -
การจำกัดอินพุตให้แคบลงสำหรับการคอมไพล์ C/C++ โดยการแยกวิเคราะห์บรรทัด #include จากไฟล์อินพุต ซึ่งจะช่วยปรับปรุงประสิทธิภาพและความสามารถในการเพิ่มประสิทธิภาพโดยลดขนาดของต้นไม้อินพุตการคอมไพล์ อย่างไรก็ตาม การดำเนินการนี้อาจทำให้บิลด์ใช้งานไม่ได้เนื่องจากเครื่องมือสแกนรวมไม่ได้ใช้ความหมายของ C preprocessor อย่างเต็มรูปแบบ โดยเฉพาะอย่างยิ่ง จะไม่เข้าใจคำสั่ง #include แบบไดนามิกและไม่สนใจตรรกะแบบมีเงื่อนไขของโปรแกรมประมวลผลข้อมูลล่วงหน้า คุณต้องใช้โดยยอมรับความเสี่ยงเอง เราจะปิดปัญหาที่เกี่ยวข้องกับการแจ้งว่าไม่เหมาะสมนี้
แท็ก:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
ค่าเริ่มต้น: "true"-
ทํางานส่วนใหญ่สําหรับการจัดทําดัชนีแยกกันสําหรับไฟล์ Jar แต่ละไฟล์
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
ค่าเริ่มต้น: "true"-
หากตั้งค่าไว้ ระบบจะใช้ไฟล์ .d ที่ clang สร้างขึ้นเพื่อตัดชุดอินพุตที่ส่งไปยังการคอมไพล์ objc
แท็ก:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
ค่าเริ่มต้น: "false"-
เมื่อสร้าง //a:a เป้าหมาย ให้ประมวลผลส่วนหัวในเป้าหมายทั้งหมดที่ //a:a ต้องใช้ (หากเปิดใช้การประมวลผลส่วนหัวสำหรับ Toolchain)
แท็ก:execution
--[no]trim_test_configuration
ค่าเริ่มต้น: "true"-
เมื่อเปิดใช้ ระบบจะล้างตัวเลือกที่เกี่ยวข้องกับการทดสอบซึ่งอยู่ใต้ระดับบนสุดของบิลด์ เมื่อ Flag นี้ทำงานอยู่ ระบบจะไม่สร้างการทดสอบเป็นข้อกําหนดของกฎที่ไม่ใช่การทดสอบ แต่การเปลี่ยนแปลงตัวเลือกที่เกี่ยวข้องกับการทดสอบจะไม่ทําให้ระบบวิเคราะห์กฎที่ไม่ใช่การทดสอบอีกครั้ง
แท็ก:loading_and_analysis
,loses_incremental_state
- ตัวเลือกที่ส่งผลต่อรายละเอียด รูปแบบ หรือตำแหน่งของการบันทึก ได้แก่
- ค่าเริ่มต้นของ
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
พิมพ์ข้อมูลการแก้ไขข้อบกพร่องระหว่างการแก้ไขเครื่องมือ แฟล็กจะใช้นิพจน์ทั่วไปซึ่งตรวจสอบกับประเภท Toolchain และเป้าหมายที่เฉพาะเจาะจงเพื่อดูว่าควรแก้ไขข้อบกพร่องใด คุณคั่นนิพจน์ทั่วไปหลายรายการด้วยคอมมา จากนั้นระบบจะตรวจสอบนิพจน์ทั่วไปแต่ละรายการแยกกัน หมายเหตุ: เอาต์พุตของ Flag นี้จะซับซ้อนมากและอาจเป็นประโยชน์ต่อผู้เชี่ยวชาญในการแก้ปัญหาเกี่ยวกับเครื่องมือทางเทคนิคเท่านั้น
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--flag_alias=<a 'name=value' flag alias>
รายการ -
ตั้งชื่อย่อสำหรับ Flag ของ Starlark ซึ่งจะใช้คู่คีย์-ค่าคู่เดียวในรูปแบบ "<key>=<value>" เป็นอาร์กิวเมนต์
แท็ก:changes_inputs
--[no]incompatible_default_to_explicit_init_py
ค่าเริ่มต้น: "false"-
Flag นี้จะเปลี่ยนลักษณะการทำงานเริ่มต้นเพื่อไม่ให้ระบบสร้างไฟล์ __init__.py โดยอัตโนมัติในไฟล์รันไทม์ของเป้าหมาย Python อีกต่อไป กล่าวโดยละเอียดคือ เมื่อเป้าหมาย py_binary หรือ py_test มีการตั้งค่า legacy_create_init เป็น "auto" (ค่าเริ่มต้น) ระบบจะถือว่าค่านี้เป็นเท็จก็ต่อเมื่อมีการตั้งค่า Flag นี้เท่านั้น ดูที่ https://github.com/bazelbuild/bazel/issues/10076
แท็ก:affects_outputs
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_py2_outputs_are_suffixed
: "จริง" -
หากเป็นจริง เป้าหมายที่สร้างขึ้นในการกำหนดค่า 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 หากคุณตั้งค่า Flag นี้ เราขอแนะนำให้ตั้งค่า `--incompatible_py2_outputs_are_suffixed` ด้วยเช่นกัน
แท็ก:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
ค่าเริ่มต้น: "true"-
หากตั้งค่าเป็น "จริง" กฎ Python เดิมที่เรียกใช้ได้จะใช้รันไทม์ Python ที่ระบุโดยชุดเครื่องมือ Python แทนรันไทม์ที่ระบุโดย Flag รุ่นเดิม เช่น --python_top
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้น
--python_version=<PY2 or PY3>
: ดูคำอธิบาย -
โหมดเวอร์ชันหลักของ Python ซึ่งอาจเป็น "PY2" หรือ "PY3" โปรดทราบว่าเป้าหมาย "py_binary" และ "py_test" จะลบล้างค่านี้ (แม้ว่าจะไม่ระบุเวอร์ชันอย่างชัดเจนก็ตาม) ดังนั้นจึงไม่ค่อยมีเหตุผลที่จะต้องระบุ Flag นี้
แท็ก:loading_and_analysis
,affects_outputs
- ตัวเลือกเบ็ดเตล็ดที่ยังไม่ได้รับการจัดหมวดหมู่:
--[no]cache_test_results
[-t
] ค่าเริ่มต้น: "auto"- หากตั้งค่าเป็น "อัตโนมัติ" Bazel จะทำการทดสอบอีกครั้งเฉพาะในกรณีต่อไปนี้ (1) Bazel ตรวจพบการเปลี่ยนแปลงในการทดสอบหรือทรัพยากร Dependency (2) มีการทำเครื่องหมายการทดสอบว่าเป็นภายนอก (3) มีการขอทำการทดสอบหลายครั้งด้วย --runs_per_test หรือ(4) การทดสอบล้มเหลวก่อนหน้านี้ หากตั้งค่าเป็น "ใช่" Bazel จะแคชผลการทดสอบทั้งหมด ยกเว้นการทดสอบที่ทำเครื่องหมายว่าภายนอก หากตั้งค่าเป็น "no" ไว้ Bazel จะไม่แคชผลการทดสอบใดๆ
--[no]experimental_cancel_concurrent_tests
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" Blaze จะยกเลิกการทดสอบที่ทํางานพร้อมกันเมื่อการเรียกใช้ครั้งแรกสําเร็จ วิธีนี้จะมีประโยชน์เมื่อใช้ร่วมกับ --runs_per_test_detects_flakes เท่านั้น
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_fetch_all_coverage_outputs
: "เท็จ" -
หากเป็น "จริง" Bazel จะดึงข้อมูลไดเรกทอรีข้อมูลการครอบคลุมทั้งหมดสําหรับการทดสอบแต่ละครั้งในระหว่างการเรียกใช้การครอบคลุม
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_generate_llvm_lcov
: "เท็จ" -
หากเป็น "จริง" การครอบคลุมสำหรับ clang จะสร้างรายงาน LCOV
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_j2objc_header_map
: "true" - สร้างแผนที่ส่วนหัว J2ObjC ควบคู่กับการแปลง J2ObjC หรือไม่
- ค่าเริ่มต้น
--[no]experimental_j2objc_shorter_header_path
: "เท็จ" -
กำหนดว่าจะสร้างโดยใช้เส้นทางส่วนหัวที่สั้นลง (ใช้ "_ios" แทน "_j2objc") หรือไม่
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_java_classpath=<off, javabuilder or bazel>
: "javabuilder" - เปิดใช้เส้นทางคลาสที่ลดลงสำหรับการคอมไพล์ Java
- ค่าเริ่มต้น
--[no]experimental_limit_android_lint_to_android_constrained_java
: "เท็จ" -
จำกัด --experimental_run_android_lint_on_java_rules ไว้สำหรับไลบรารีที่เข้ากันได้กับ Android
แท็ก:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
ค่าเริ่มต้น: "false"-
กำหนดว่าจะตรวจสอบแหล่งที่มา java_* หรือไม่
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]explicit_java_test_deps
: "เท็จ" - ระบุทรัพยากร Dependency ของ JUnit หรือ Hamcrest อย่างชัดเจนใน java_test แทนที่จะได้มาจาก Dep ของ TestRunner โดยไม่ตั้งใจ ตอนนี้ใช้ได้กับ bazel เท่านั้น
--host_java_launcher=<a build target label>
default: ดูคำอธิบาย- ตัวเปิด Java ที่เครื่องมือใช้ในระหว่างการบิลด์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_javacopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมที่จะส่งไปยัง javac เมื่อสร้างเครื่องมือที่จะดำเนินการระหว่างการบิลด์
--host_jvmopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ตัวเลือกเพิ่มเติมที่จะส่งไปยัง Java VM เมื่อสร้างเครื่องมือที่จะดำเนินการระหว่างการบิลด์ ระบบจะเพิ่มตัวเลือกเหล่านี้ไปยังตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
--[no]incompatible_check_sharding_support
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" Bazel จะทดสอบแบบแยกกลุ่มไม่สำเร็จหากเครื่องมือรันทดสอบไม่ได้ระบุว่ารองรับการแยกกลุ่มโดยแตะไฟล์ที่เส้นทางใน TEST_SHARD_STATUS_FILE หากเป็นเท็จ ตัวดำเนินการทดสอบที่ไม่รองรับการชาร์ดจะนำไปยังการทดสอบทั้งหมดที่ทำงานในชาร์ดแต่ละรายการ
แท็ก:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
ค่าเริ่มต้น: "true"-
หากเป็นจริง การทดสอบพิเศษจะทำงานโดยใช้กลยุทธ์แซนด์บ็อกซ์ เพิ่มแท็ก "local" เพื่อบังคับให้ทำการทดสอบแบบพิเศษในเครื่อง
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_strict_action_env
: "เท็จ" -
หากเป็น "จริง" Bazel จะใช้สภาพแวดล้อมที่มีค่าแบบคงที่สำหรับ PATH และไม่รับค่า LD_LIBRARY_PATH ไป ใช้ --action_env=ENV_VARIABLE หากต้องการรับค่าตัวแปรสภาพแวดล้อมที่เฉพาะเจาะจงจากไคลเอ็นต์ แต่โปรดทราบว่าการดำเนินการนี้อาจป้องกันไม่ให้แคชข้ามผู้ใช้หากใช้แคชที่แชร์
แท็ก:loading_and_analysis
,incompatible_change
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--j2objc_translation_flags=<comma-separated list of options>
รายการ - ตัวเลือกเพิ่มเติมที่จะส่งไปยังเครื่องมือ J2ObjC
--java_debug
-
ทำให้เครื่องเสมือนของ Java ของการทดสอบ Java ต้องรอการเชื่อมต่อจากโปรแกรมแก้ไขข้อบกพร่องที่สอดคล้องกับ JDWP (เช่น jdb) ก่อนเริ่มการทดสอบ บอกเป็นนัยว่า -test_output=streamed
ขยายเป็น
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
ค่าเริ่มต้น: "true"- สร้างข้อมูลการพึ่งพา (ตอนนี้คือ classpath ขณะคอมไพล์) ต่อเป้าหมาย Java
--[no]java_header_compilation
ค่าเริ่มต้น: "true"- คอมไพล์ ijars จากแหล่งที่มาโดยตรง
- ค่าเริ่มต้นของ
--java_language_version=<a string>
: "" - เวอร์ชันภาษา Java
--java_launcher=<a build target label>
default: ดูคำอธิบาย- โปรแกรมเปิด Java ที่จะใช้ในการสร้างไบนารี Java หากตั้งค่า Flag นี้เป็นสตริงว่าง ระบบจะใช้ตัวเปิด 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>
default: ดูคำอธิบาย- ระบุไบนารีที่จะใช้สร้างรายการคลาสที่ต้องอยู่ใน Dex หลักเมื่อคอมไพล์ MultiDex รุ่นเดิม
--optimizing_dexer=<a build target label>
default: ดูคำอธิบาย- ระบุไบนารีที่จะใช้ในการจัดทําดัชนีโดยไม่มีการแยกข้อมูล
--plugin=<a build target label>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ปลั๊กอินที่จะใช้ในบิลด์ ปัจจุบันใช้งานได้กับ java_plugin
--proguard_top=<a build target label>
default: ดูคำอธิบาย- ระบุเวอร์ชันของ ProGuard ที่จะใช้นำโค้ดออกเมื่อสร้างไบนารี Java
--proto_compiler=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/proto:protoc"-
ป้ายกำกับของ Proto-compiler
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/proto:cc_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ C++ protos
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ j2objc protos
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/proto:java_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์โปรโตคอล Java
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/proto:javalite_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์โปรโตคอล JavaLite
แท็ก:affects_outputs
,loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--protocopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งไปยังคอมไพเลอร์ Protocolbuf
แท็ก:affects_outputs
--[no]runs_per_test_detects_flakes
ค่าเริ่มต้น: "false"- หากเป็น "จริง" ข้อมูลพร็อพเพอร์ตี้ที่รัน/พยายามอย่างน้อย 1 ครั้งผ่านและรัน/พยายามอย่างน้อย 1 ครั้งไม่ผ่านจะได้รับสถานะ "ไม่เสถียร"
- ค่าเริ่มต้น
--shell_executable=<a path>
: ดูคำอธิบาย -
เส้นทางสัมบูรณ์ไปยังเชลล์ที่ปฏิบัติการได้สำหรับ Bazel หากไม่ได้ตั้งค่านี้ แต่มีการตั้งค่าตัวแปรสภาพแวดล้อม BAZEL_SH ในการเรียกใช้ Bazel แรก (ซึ่งเริ่มต้นเซิร์ฟเวอร์ Bazel) Bazel จะใช้ตัวแปรนั้น หากไม่ได้ตั้งค่าไว้ Bazel จะใช้เส้นทางเริ่มต้นแบบฮาร์ดโค้ด โดยขึ้นอยู่กับระบบปฏิบัติการที่ใช้ (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, อื่นๆ ทั้งหมด: /bin/bash) โปรดทราบว่าการใช้เชลล์ที่เข้ากันไม่ได้กับ bash อาจทําให้การสร้างไม่สําเร็จหรือรันไทม์ของไบนารีที่สร้างขึ้นไม่สําเร็จ
แท็ก:loading_and_analysis
--test_arg=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ระบุตัวเลือกและอาร์กิวเมนต์เพิ่มเติมที่ควรส่งไปยังไฟล์ปฏิบัติการทดสอบ ซึ่งสามารถใช้หลายครั้งเพื่อระบุอาร์กิวเมนต์ได้หลายรายการ หากทำการทดสอบหลายรายการ แต่ละรายการจะได้รับอาร์กิวเมนต์ที่เหมือนกัน ใช้เฉพาะโดยคำสั่ง "การทดสอบ Bazel" เท่านั้น
- ค่าเริ่มต้น
--test_filter=<a string>
: ดูคำอธิบาย - ระบุตัวกรองที่จะส่งต่อไปยังเฟรมเวิร์กการทดสอบ ใช้เพื่อจำกัดการทดสอบ โปรดทราบว่าการดำเนินการนี้จะไม่ส่งผลต่อเป้าหมายที่สร้าง
- ค่าเริ่มต้นของ
--test_result_expiration=<an integer>
: "-1" - ตัวเลือกนี้เลิกใช้งานแล้วและไม่มีผล
--[no]test_runner_fail_fast
ค่าเริ่มต้น: "false"- ส่งต่อตัวเลือก "ดำเนินการทดสอบอย่างรวดเร็ว" ไปยังโปรแกรมรันทดสอบ ตัวดำเนินการทดสอบควรหยุดการดำเนินการเมื่อล้มเหลวครั้งแรก
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
ค่าเริ่มต้น: "explicit"- ระบุกลยุทธ์สำหรับการแยกกลุ่มทดสอบ: "explicit" เพื่อใช้การแยกกลุ่มเฉพาะในกรณีที่มีแอตทริบิวต์ BUILD "shard_count" เท่านั้น "disabled" เพื่อไม่ให้ใช้การแยกกลุ่มทดสอบ "forced=k" เพื่อบังคับใช้ชาร์ด "k" สำหรับการทดสอบโดยไม่คำนึงถึงแอตทริบิวต์ BUILD "shard_count"
--tool_java_language_version=<a string>
ค่าเริ่มต้น: ""- เวอร์ชันภาษา Java ที่ใช้ในการเรียกใช้เครื่องมือที่จําเป็นในระหว่างการสร้าง
--tool_java_runtime_version=<a string>
ค่าเริ่มต้น: "remotejdk_11"- เวอร์ชันรันไทม์ Java ที่ใช้ในการเรียกใช้เครื่องมือระหว่างการสร้าง
- ค่าเริ่มต้น
--[no]use_ijars
: "จริง" - หากเปิดใช้ ตัวเลือกนี้จะทำให้การคอมไพล์ Java ใช้ JAR อินเทอร์เฟซ ซึ่งจะทำให้การคอมไพล์แบบเพิ่มขึ้นเรื่อยๆ ได้เร็วขึ้น แต่ข้อความแสดงข้อผิดพลาดอาจแตกต่างกันได้
ตัวเลือกการสร้าง
- ตัวเลือกที่ปรากฏก่อนคําสั่งและได้รับการแยกวิเคราะห์โดยไคลเอ็นต์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนที่จะเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บข้อมูลจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบในแคชแทนการคัดลอก การดำเนินการนี้มีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งที่พยายามลองอีกครั้งสูงสุดสำหรับข้อผิดพลาดในการดาวน์โหลด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองอีกครั้ง
แท็ก:experimental
- ค่าเริ่มต้น
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับเวลาหมดอายุทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ช่วยให้รีโพซิทอรีภายนอกทํางานบนเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
ค่าเริ่มต้น: "false"-
หากเป็นเท็จ จะใช้กฎของรีโปเดิมใน WORKSPACE ได้ หากเป็นจริง ต้องใช้กฎของรีโป Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
default: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลรีโพซิทอรี่ภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช มิเช่นนั้นระบบจะใช้ค่าเริ่มต้นของ "<output_user_root>/cache/repos/v1"
แท็ก:bazel_internal_configuration
--[no]repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลพื้นที่เก็บข้อมูล โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้อย่างสมบูรณ์ ctx.execute อาจยังคงเรียกใช้ไฟล์ที่เรียกใช้งานได้แบบกำหนดเองซึ่งเข้าถึงอินเทอร์เน็ตได้
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
--[no]check_up_to_date
ค่าเริ่มต้น: "false"-
อย่าสร้าง เพียงตรวจสอบว่าอัปเดตแล้ว หากเป้าหมายทั้งหมดเป็นเวอร์ชันล่าสุดแล้ว การสร้างจะเสร็จสมบูรณ์ หากต้องดำเนินการขั้นตอนใด ระบบจะรายงานข้อผิดพลาดและบิลด์จะไม่สำเร็จ
แท็ก:execution
--dynamic_local_execution_delay=<an integer>
ค่าเริ่มต้น: "1000"-
การดำเนินการในเครื่องควรล่าช้าไปกี่มิลลิวินาที หากการดำเนินการจากระยะไกลเร็วขึ้นในระหว่างบิลด์อย่างน้อย 1 ครั้ง
แท็ก:execution
,host_machine_resource_optimizations
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment>
รายการ -
กลยุทธ์ในร้านตามลําดับที่จะใช้กับคําช่วยจําที่ระบุ ระบบจะใช้กลยุทธ์แรกที่ใช้ได้ เช่น `worker,sandboxed` จะเรียกใช้การดำเนินการที่รองรับผู้ปฏิบัติงานแบบถาวรโดยใช้กลยุทธ์ผู้ปฏิบัติงาน และการดำเนินการอื่นๆ ทั้งหมดโดยใช้กลยุทธ์ที่ใช้แซนด์บ็อกซ์ หากไม่ได้ระบุคําช่วยจํา ระบบจะใช้รายการกลยุทธ์เป็นคําช่วยจําสำรองสําหรับคําช่วยจําทั้งหมด รายการสำรองเริ่มต้นคือ "worker,sandboxed" หรือ "worker,sandboxed,staคอนเทนต์" หากตั้งค่า "experimental_local_lockfree_output" ใช้ [mnemonic=]local_strategy[,local_strategy,...]
แท็ก:execution
,host_machine_resource_optimizations
--dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
กลยุทธ์ระยะไกลตามลําดับที่จะใช้กับคําช่วยจําที่ระบุ - ระบบจะใช้กลยุทธ์แรกที่ใช้ได้ หากไม่ได้ระบุคําช่วยจํา ระบบจะใช้รายการกลยุทธ์เป็นคําช่วยจําสำรองสําหรับคําช่วยจําทั้งหมด รายการสำรองเริ่มต้นคือ "remote" ดังนั้นโดยปกติแล้วคุณไม่จำเป็นต้องตั้งค่า Flag นี้อย่างชัดเจน ต้องใช้ [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" -
ควบคุมปริมาณภาระงานจากการดำเนินการแบบไดนามิกที่จะนำไปใช้กับเครื่องภายใน Flag นี้จะปรับจํานวนการดำเนินการในการดําเนินการแบบไดนามิกที่เราจะกําหนดเวลาให้ทํางานพร้อมกัน ซึ่งจะอิงตามจํานวน CPU ที่ Blaze คิดว่าพร้อมใช้งาน ซึ่งสามารถควบคุมได้ด้วย Flag --local_cpu_resources
หาก Flag นี้เป็น 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
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" ระบบจะติดตามเนื้อหาของแซนด์บ็อกซ์ที่เก็บไว้สำหรับ reuse_sandbox_directories ในหน่วยความจำ ซึ่งจะช่วยลดปริมาณ I/O ที่ต้องใช้ในระหว่างการนำมาใช้ใหม่ Flag นี้อาจช่วยปรับปรุงเวลาจริงได้ ทั้งนี้ขึ้นอยู่กับบิลด์ นอกจากนี้ Flag นี้ยังอาจใช้หน่วยความจําเพิ่มเติมจํานวนมาก ทั้งนี้ขึ้นอยู่กับบิลด์
แท็ก: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 รายการดังกล่าวในพูลเธรดแบบแอซิงโครนัสที่มีขนาด 1 เมื่อบิลด์ทำงานอยู่ และเพิ่มขนาดเป็นขนาดที่ระบุโดย Flag นี้เมื่อเซิร์ฟเวอร์ไม่มีการใช้งาน
แท็ก:host_machine_resource_optimizations
,execution
- ค่าเริ่มต้นของ
--experimental_sandbox_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "0" -
หากมีค่ามากกว่า 0 ซานด์บ็อกซ์ Linux แต่ละรายการจะมีหน่วยความจำจํากัดตามจำนวนที่ระบุ (เป็น MB) ต้องใช้ cgroups v1 หรือ v2 และสิทธิ์สำหรับผู้ใช้ในไดเรกทอรี cgroups
แท็ก:execution
--[no]experimental_shrink_worker_pool
ค่าเริ่มต้น: "false"-
หากเปิดใช้ อาจมีการปรับขนาดพูลผู้ปฏิบัติงานให้เล็กลงหากมีแรงกดดันของหน่วยความจําของผู้ปฏิบัติงานสูง แฟล็กนี้จะใช้งานได้ก็ต่อเมื่อเปิดใช้ Flag experimental_total_worker_memory_limit_mb เท่านั้น
แท็ก:execution
,host_machine_resource_optimizations
--[no]experimental_split_xml_generation
ค่าเริ่มต้น: "true"-
หากตั้งค่าแฟล็กนี้และการดำเนินการทดสอบไม่สร้างไฟล์ test.xml ขึ้นมา Bazel จะใช้การดำเนินการแยกต่างหากเพื่อสร้างไฟล์ test.xml จำลองที่มีบันทึกการทดสอบ มิฉะนั้น Bazel จะสร้าง test.xml เป็นส่วนหนึ่งของการดำเนินการทดสอบ
แท็ก:execution
- ค่าเริ่มต้นของ
--experimental_total_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "0" -
หากขีดจํากัดนี้มากกว่า 0 ระบบอาจหยุดผู้ปฏิบัติงานที่ไม่ได้ใช้งานอยู่หากการใช้งานหน่วยความจําทั้งหมดของผู้ปฏิบัติงานทั้งหมดเกินขีดจํากัด
แท็ก:execution
,host_machine_resource_optimizations
- ค่าเริ่มต้น
--[no]experimental_use_hermetic_linux_sandbox
: "เท็จ" -
หากตั้งค่าเป็น "จริง" อย่ามาสก์รูท ให้มาสก์เฉพาะสิ่งที่ระบุไว้ใน sandbox_add_mount_pair ไฟล์ที่ป้อนจะฮาร์ดลิงก์ไปยังแซนด์บ็อกซ์แทนที่จะลิงก์มาจากแซนด์บ็อกซ์ หากไฟล์อินพุตการดำเนินการอยู่ในระบบไฟล์ที่แตกต่างจากแซนด์บ็อกซ์ ระบบจะคัดลอกไฟล์อินพุตแทน
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_use_semaphore_for_jobs
: "true" -
หากตั้งค่าเป็น "จริง" ให้ใช้เซมาโฟร์เพื่อจำกัดจำนวนงานที่ทำงานพร้อมกันด้วย
แท็ก:host_machine_resource_optimizations
,execution
- ค่าเริ่มต้น
--[no]experimental_use_windows_sandbox
: "เท็จ" -
ใช้แซนด์บ็อกซ์ของ Windows เพื่อเรียกใช้การดำเนินการ หากเป็น "ใช่" ไบนารีที่ระบุโดย --experimental_windows_sandbox_path ต้องเป็นไฟล์ที่ถูกต้องและสอดคล้องกับ sandboxfs เวอร์ชันที่รองรับ หากเป็น "auto" แสดงว่าไฟล์ไบนารีอาจไม่อยู่หรือไม่เข้ากันได้
แท็ก:execution
--experimental_windows_sandbox_path=<a string>
ค่าเริ่มต้น: "BazelSandbox.exe"-
เส้นทางไปยังไบนารีแซนด์บ็อกซ์ของ Windows ที่จะใช้เมื่อ --experimental_use_windows_sandbox เป็นจริง หากเป็นชื่ออย่างเดียว ให้ใช้ไบนารีชื่อนั้นรายการแรกที่พบใน PATH
แท็ก:execution
- ค่าเริ่มต้น
--experimental_worker_allowlist=<comma-separated set of options>
: ดูคำอธิบาย -
หากไม่ใช่ค่าว่าง ระบบจะอนุญาตให้ใช้เฉพาะผู้ปฏิบัติงานถาวรที่มีคีย์ผู้ปฏิบัติงานซึ่งจำได้ง่ายที่ระบุ
แท็ก:execution
,host_machine_resource_optimizations
--[no]experimental_worker_as_resource
ค่าเริ่มต้น: "true"-
ไม่มีการดำเนินการ จะถูกนำออกในเร็วๆ นี้
แท็ก:no_op
--[no]experimental_worker_cancellation
ค่าเริ่มต้น: "false"-
หากเปิดใช้ Bazel อาจส่งคำขอยกเลิกไปยังผู้ทำงานที่รองรับ
แท็ก:execution
- ค่าเริ่มต้นของ
--experimental_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "0" -
หากขีดจำกัดนี้มากกว่า 0 ผู้ปฏิบัติงานอาจถูกยกเลิกการใช้งานหน่วยความจำของผู้ปฏิบัติงานเกินขีดจำกัด หากไม่ได้ใช้ร่วมกับการดำเนินการแบบไดนามิกและ `--experimental_dynamic_ignore_local_signals=9` ตัวเลือกนี้อาจทำให้บิลด์ขัดข้อง
แท็ก:execution
,host_machine_resource_optimizations
- ค่าเริ่มต้น
--experimental_worker_metrics_poll_interval=<An immutable length of time.>
: "5s" -
ช่วงเวลาระหว่างการรวบรวมเมตริกผู้ปฏิบัติงานกับการพยายามปลดออก ต้องใช้เวลาอย่างน้อย 1 วินาทีเนื่องจากเหตุผลด้านประสิทธิภาพ
แท็ก:execution
,host_machine_resource_optimizations
- ค่าเริ่มต้น
--[no]experimental_worker_multiplex_sandboxing
: "เท็จ" -
หากเปิดใช้ ระบบจะจัดเตรียมพื้นที่ทํางานแบบหลายรายการโดยใช้ไดเรกทอรีแซนด์บ็อกซ์แยกกันต่อคำของาน เฉพาะผู้ปฏิบัติงานที่มีข้อกําหนดการดําเนินการ "supports-multiplex-sandboxing" เท่านั้นที่จะอยู่ในแซนด์บ็อกซ์
แท็ก:execution
--[no]experimental_worker_sandbox_hardening
ค่าเริ่มต้น: "false"-
หากเปิดใช้ ระบบจะเรียกใช้ผู้ปฏิบัติงานในแซนด์บ็อกซ์ที่แข็งแกร่ง หากการใช้งานอนุญาตให้ทำได้
แท็ก:execution
--[no]experimental_worker_strict_flagfiles
ค่าเริ่มต้น: "false"-
หากเปิดใช้ อาร์กิวเมนต์การดำเนินการสำหรับ Worker ที่ไม่เป็นไปตามข้อกำหนดของ Worker จะทำให้เกิดข้อผิดพลาด อาร์กิวเมนต์ของผู้ปฏิบัติงานต้องมีอาร์กิวเมนต์ @flagfile เพียง 1 รายการเป็นรายการสุดท้ายของรายการอาร์กิวเมนต์
แท็ก:execution
--gc_thrashing_threshold=<an integer in 0-100 range>
ค่าเริ่มต้น: "100"-
เปอร์เซ็นต์ของพื้นที่เช่า (0-100) ข้างต้นซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์แรงดันหน่วยความจำเทียบกับขีดจำกัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--genrule_strategy=<comma-separated list of options>
: "" -
ระบุวิธีเรียกใช้ Genrule การแจ้งว่าไม่เหมาะสมนี้จะถูกนำออก แต่ให้ใช้ --spawn_strategy=<value> เพื่อควบคุมการดำเนินการทั้งหมด หรือ --strategy=Genrule=<value> เพื่อควบคุม Genrule เท่านั้น
แท็ก:execution
--high_priority_workers=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ไม่มีการดำเนินการ จะถูกนำออกในเร็วๆ นี้
แท็ก: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]internal_spawn_scheduler
ค่าเริ่มต้น: "false"-
ตัวเลือกตัวยึดตําแหน่งเพื่อให้เราบอกใน Blaze ได้ว่าจะเปิดใช้ตัวจัดตารางการเกิดหรือไม่
แท็ก:execution
,host_machine_resource_optimizations
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] ค่าเริ่มต้น: "auto"-
จำนวนงานที่จะเรียกใช้พร้อมกัน ใช้จำนวนเต็มหรือคีย์เวิร์ด ("auto", "HOST_CPUS", "HOST_RAM") ตามด้วยการดำเนินการ ([-|*]<float>) ตามต้องการ เช่น "auto", "HOST_CPUS*.5" ค่าต้องอยู่ระหว่าง 1 ถึง 5,000 ค่าที่สูงกว่า 2,500 อาจก่อให้เกิดปัญหาเกี่ยวกับหน่วยความจำ "auto" จะคำนวณค่าเริ่มต้นที่เหมาะสมตามทรัพยากรของโฮสต์
แท็ก:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] default: "false"-
ดำเนินการต่อให้มากที่สุดหลังจากเกิดข้อผิดพลาด แม้ว่าจะวิเคราะห์เป้าหมายที่ไม่สําเร็จและเป้าหมายที่ขึ้นอยู่กับเป้าหมายนั้นไม่ได้ แต่สามารถวิเคราะห์ข้อกําหนดเบื้องต้นอื่นๆ ของเป้าหมายเหล่านี้ได้
แท็ก:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
ค่าเริ่มต้น: "auto"-
จํานวนเธรดแบบขนานที่จะใช้สําหรับระยะการโหลด/การวิเคราะห์ ใช้จํานวนเต็มหรือคีย์เวิร์ด ("auto", "HOST_CPUS", "HOST_RAM") ตามด้วยการดำเนินการ ([-|*]<float>) ตามต้องการ เช่น "auto", "HOST_CPUS*.5" "auto" จะตั้งค่าเริ่มต้นที่เหมาะสมตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]reuse_sandbox_directories
: "จริง" -
หากตั้งค่าเป็น "จริง" ระบบอาจนําไดเรกทอรีที่ใช้โดยการดำเนินการที่ไม่ใช่เวิร์กเกอร์ในแซนด์บ็อกซ์มาใช้ซ้ำเพื่อหลีกเลี่ยงค่าใช้จ่ายในการตั้งค่าที่ไม่จําเป็น
แท็ก:host_machine_resource_optimizations
,execution
- ค่าเริ่มต้นของ
--sandbox_base=<a string>
: "" -
ช่วยให้แซนด์บ็อกซ์สร้างไดเรกทอรีแซนด์บ็อกซ์ใต้เส้นทางนี้ได้ ระบุเส้นทางใน tmpfs (เช่น /run/shm) เพื่อเพิ่มประสิทธิภาพได้อย่างมากเมื่อบิลด์ / การทดสอบมีไฟล์อินพุตจำนวนมาก หมายเหตุ: คุณต้องมี RAM และพื้นที่ว่างใน tmpfs เพียงพอที่จะเก็บเอาต์พุตและไฟล์กลางที่สร้างขึ้นโดยการเรียกใช้การดำเนินการ
แท็ก:host_machine_resource_optimizations
,execution
--[no]sandbox_explicit_pseudoterminal
ค่าเริ่มต้น: "false"-
เปิดใช้การสร้าง 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" Flag นี้จะลบล้างค่าที่กําหนดโดย --spawn_strategy (และ --genrule_strategy หากใช้กับ Genrule ที่เป็นคําช่วยจํา) ดูรายละเอียดได้ที่ https://blog.bazel.build/2019/06/19/list-strategy.html
แท็ก:execution
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ลบล้างกลยุทธ์การสร้างใหม่ที่จะใช้เพื่อดำเนินการสร้างใหม่ซึ่งมีคำอธิบายตรงกับ regex_filter บางรายการ ดูรายละเอียดเกี่ยวกับการจับคู่ regex_filter ได้ที่ --per_file_copt ระบบจะใช้ regex_filter รายการล่าสุดที่ตรงกับคำอธิบาย ตัวเลือกนี้จะลบล้าง Flag อื่นๆ สำหรับการระบุกลยุทธ์ ตัวอย่างเช่น --strategy_regexp=//foo.*\.cc,-//foo/bar=local หมายถึงการดําเนินการโดยใช้กลยุทธ์แบบท้องถิ่นหากคําอธิบายตรงกับ //foo.*.cc แต่ไม่ใช่ //foo/bar ตัวอย่างเช่น --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed จะเรียกใช้ "Compiling //foo/bar/baz" ด้วยกลยุทธ์ "local" แต่การกลับลําดับจะเรียกใช้ด้วย "sandboxed"
แท็ก:execution
--worker_extra_flag=<a 'name=value' assignment>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
Flag คำสั่งเพิ่มเติมที่จะส่งไปยังกระบวนการทำงานนอกเหนือจาก --persistent_worker โดยคีย์ตามคําจำ (เช่น --worker_extra_flag=Javac=--debug
แท็ก:execution
,host_machine_resource_optimizations
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--worker_max_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
รายการ -
ในกรณีที่ใช้กลยุทธ์ "ผู้ปฏิบัติงาน" อาจมีการเปิดใช้ผู้ปฏิบัติงานถาวรแต่ละประเภท อาจระบุเป็น [name=value] เพื่อให้ค่าแตกต่างกันไปตามคําช่วยจํา ขีดจํากัดจะอิงตามคีย์ผู้ทํางาน ซึ่งจะแยกตามคําช่วยจํา แต่รวมถึงตาม Flag และสภาพแวดล้อมการเริ่มต้นด้วย ดังนั้นในบางกรณีอาจมีผู้ทํางานต่อคําช่วยจํามากกว่าที่ Flag นี้ระบุ ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") โดยจะเลือกตามด้วยการดำเนินการ ([-|*]<Float>) เช่น "auto", "HOST_CPUS*.5" "auto" จะคำนวณค่าเริ่มต้นที่เหมาะสมตามขีดความสามารถของเครื่อง "=value" จะตั้งค่าเริ่มต้นสำหรับคําช่วยจําที่ไม่ได้ระบุ
แท็ก:execution
,host_machine_resource_optimizations
--worker_max_multiplex_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
ระบบจะรวบรวมการใช้งานหลายครั้ง-
จํานวน WorkRequest ที่กระบวนการทํางานแบบมัลติเพล็กซ์อาจได้รับพร้อมกันหากคุณใช้กลยุทธ์ "worker" กับ --worker_multiplex อาจระบุเป็น [name=value] เพื่อให้ค่าแตกต่างกันไปตามคําช่วยจํา ขีดจํากัดจะอิงตามคีย์ผู้ทํางาน ซึ่งจะแยกตามคําช่วยจํา แต่รวมถึงตาม Flag และสภาพแวดล้อมการเริ่มต้นด้วย ดังนั้นในบางกรณีอาจมีผู้ทํางานต่อคําช่วยจํามากกว่าที่ Flag นี้ระบุ ใช้จำนวนเต็มหรือคีย์เวิร์ด ("auto", "HOST_CPUS", "HOST_RAM") ตามด้วยการดำเนินการ ([-|*]<float>) ตามต้องการ เช่น "auto", "HOST_CPUS*.5" "auto" จะคำนวณค่าเริ่มต้นที่เหมาะสมตามขีดความสามารถของเครื่อง "=value" จะตั้งค่าเริ่มต้นสำหรับคําช่วยจําที่ไม่ได้ระบุ
แท็ก:execution
,host_machine_resource_optimizations
--[no]worker_multiplex
ค่าเริ่มต้น: "true"-
หากเปิดใช้ ผู้ปฏิบัติงานจะใช้มัลติเพล็กซ์หากรองรับ
แท็ก:execution
,host_machine_resource_optimizations
--[no]worker_quit_after_build
ค่าเริ่มต้น: "false"-
หากเปิดใช้ ผู้ปฏิบัติงานทั้งหมดจะออกหลังจากบิลด์เสร็จสมบูรณ์
แท็ก:execution
,host_machine_resource_optimizations
- ค่าเริ่มต้น
--[no]worker_sandboxing
: "เท็จ" -
หากเปิดใช้ ระบบจะเรียกใช้ผู้ปฏิบัติงานในสภาพแวดล้อมที่ใช้แซนด์บ็อกซ์
แท็ก:execution
--[no]worker_verbose
ค่าเริ่มต้น: "false"- หากเปิดใช้ ระบบจะพิมพ์ข้อความแบบละเอียดเมื่อเริ่ม ปิด ฯลฯ ของเวิร์กเกอร์
- ตัวเลือกที่กำหนดค่าเครื่องมือที่ใช้สำหรับการดำเนินการ
--target_platform_fallback=<a string>
ค่าเริ่มต้น: ""-
ตัวเลือกนี้เลิกใช้งานแล้วและไม่มีผล
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่งมีดังนี้
- ค่าเริ่มต้น
--[no]build
: "true" -
เรียกใช้บิลด์ ซึ่งเป็นลักษณะการทำงานปกติ การระบุ --nobuild จะทำให้การบิลด์หยุดลงก่อนที่จะดำเนินการกับการดำเนินการบิลด์ โดยจะแสดงผลเป็น 0 เฉพาะในกรณีที่การโหลดแพ็กเกจและระยะการวิเคราะห์เสร็จสมบูรณ์เท่านั้น โหมดนี้มีประโยชน์สำหรับการทดสอบระยะดังกล่าว
แท็ก:execution
,affects_outputs
--[no]experimental_use_validation_aspect
ค่าเริ่มต้น: "false"-
การเรียกใช้การดำเนินการตรวจสอบโดยใช้แง่มุม (สําหรับการทำงานแบบขนานกับการทดสอบ)
แท็ก:execution
,affects_outputs
--output_groups=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
รายการชื่อกลุ่มเอาต์พุตที่คั่นด้วยคอมมา โดยแต่ละชื่อจะมีเครื่องหมาย + หรือ - นำหน้าก็ได้ ระบบจะเพิ่มกลุ่มที่มีเครื่องหมาย + นำหน้าไปยังชุดกลุ่มเอาต์พุตเริ่มต้น ส่วนกลุ่มที่มีเครื่องหมาย - นำหน้าจะถูกนำออกจากชุดเริ่มต้น หากไม่มีการกำหนดคำนำหน้าให้กับกลุ่มอย่างน้อย 1 กลุ่ม ระบบจะไม่รวมชุดกลุ่มเอาต์พุตเริ่มต้น เช่น --output_groups=+foo,+bar จะสร้างยูเนียนของชุดค่าเริ่มต้น foo และ bar ส่วน --output_groups=foo,bar จะลบล้างชุดค่าเริ่มต้นเพื่อให้ระบบสร้างเฉพาะ foo และ bar
แท็ก:execution
,affects_outputs
- ค่าเริ่มต้น
--[no]run_validations
: "จริง" -
กำหนดว่าจะเรียกใช้การดำเนินการตรวจสอบเป็นส่วนหนึ่งของการสร้างหรือไม่ ดูที่ https://bazel.build/extending/rules#validation_actions
แท็ก:execution
,affects_outputs
- ตัวเลือกที่อนุญาตให้ผู้ใช้กําหนดค่าเอาต์พุตที่ต้องการ ซึ่งส่งผลต่อค่าของเอาต์พุต ไม่ใช่การมีอยู่ของเอาต์พุต
--aspects=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง- รายการที่คั่นด้วยคอมมาของด้านที่จะใช้กับเป้าหมายระดับบนสุด ในรายการนี้ หากแอตทริบิวต์ some_aspect ระบุผู้ให้บริการแอตทริบิวต์ที่จำเป็นผ่าน required_aspect_providers ทางแอตทริบิวต์ some_aspect จะทำงานหลังจากแอตทริบิวต์ทุกรายการที่กล่าวถึงก่อนหน้าในรายการแอตทริบิวต์ซึ่งมีผู้ให้บริการที่โฆษณาตรงกับผู้ให้บริการแอตทริบิวต์ที่จำเป็นของ some_aspect นอกจากนี้ some_aspect จะทํางานหลังจากทุกส่วนที่จําเป็นที่ระบุไว้โดย required [แอตทริบิวต์] แล้ว some_aspect จะมีสิทธิ์เข้าถึงค่าของผู้ให้บริการด้านเหล่านั้น <bzl-file-label>%<aspect_name> เช่น "//tools:my_def.bzl%my_aspect" โดยที่ "my_aspect" คือค่าระดับบนสุดจากไฟล์ tools/my_def.bzl
- ค่าเริ่มต้นของ
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
จำนวนไฟล์เปิดสูงสุดที่อนุญาตในระหว่างการอัปโหลดอาร์ติแฟกต์ BEP
แท็ก:affects_outputs
--[no]experimental_convenience_symlinks
ค่าเริ่มต้น: "normal"-
Flag นี้จะควบคุมวิธีจัดการสัญลักษณ์ลิงก์เพื่อความสะดวก (สัญลักษณ์ลิงก์ที่ปรากฏในพื้นที่ทํางานหลังจากการบิลด์) ค่าที่เป็นไปได้มีดังนี้
normal (ค่าเริ่มต้น): ระบบจะสร้างหรือลบลิงก์สัญลักษณ์ที่สะดวกแต่ละประเภทตามที่กำหนดโดยบิลด์
clean: ระบบจะลบลิงก์สัญลักษณ์ทั้งหมดโดยไม่มีเงื่อนไข
ignore: ระบบจะไม่ดำเนินการกับสัญลักษณ์ลิงก์
log_only: สร้างข้อความบันทึกราวกับว่ามีการผ่าน "normal" แต่ไม่ได้ดำเนินการใดๆ ในระบบไฟล์ (มีประโยชน์สำหรับเครื่องมือ)
โปรดทราบว่าเฉพาะ symlink ที่มีชื่อสร้างขึ้นจากค่าปัจจุบันของ --symlink_prefix เท่านั้นที่จะได้รับผลกระทบ หากคำนำหน้ามีการเปลี่ยนแปลง ระบบจะไม่เปลี่ยนแปลง symlink ที่มีอยู่ก่อน
แท็ก:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
ค่าเริ่มต้น: "false"-
Flag นี้จะควบคุมว่าเราจะโพสต์ eventConvenienceSymlinksIdentified ของบิลด์ไปยัง BuildEventProtocol หรือไม่ หากค่าเป็น "จริง" BuildEventProtocol จะมีรายการสำหรับ convenienceSymlinksIdentified ซึ่งแสดงรายการลิงก์สัญลักษณ์ที่สะดวกทั้งหมดที่สร้างขึ้นในเวิร์กスペース หากเป็นเท็จ รายการ convenienceSymlinksIdentified ใน 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>
: "ระดับบนสุด" -
หากตั้งค่าเป็น "ขั้นต่ำ" ระบบจะไม่ดาวน์โหลดเอาต์พุตการสร้างจากระยะไกลลงในเครื่อง ยกเว้นเอาต์พุตที่การดำเนินการในเครื่องต้องใช้ หากตั้งค่าเป็น "toplevel" ระบบจะทํางานเหมือน "minimal" ยกเว้นว่าจะดาวน์โหลดเอาต์พุตของเป้าหมายระดับบนสุดไปยังเครื่องภายในด้วย ตัวเลือกทั้ง 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>
default: ดูคำอธิบาย-
คำนำหน้าที่จะเพิ่มไว้หน้าลิงก์สัญลักษณ์เพื่อความสะดวกซึ่งสร้างขึ้นหลังจากการบิลด์ หากไม่ระบุ ค่าเริ่มต้นจะเป็นชื่อของเครื่องมือสร้างตามด้วยขีดกลาง หากส่ง "/" ระบบจะไม่สร้างสัญลักษณ์ลิงก์และจะไม่แสดงคำเตือน คำเตือน: ฟังก์ชันพิเศษสำหรับ "/" จะถูกเลิกใช้ในไม่ช้า โปรดใช้ --experimental_convenience_symlinks=ignore แทน
แท็ก:affects_outputs
- ตัวเลือกที่มีผลต่อความเคร่งครัดในการบังคับใช้อินพุตบิลด์ที่ถูกต้อง (เช่น คำจำกัดความของกฎ ชุดค่าผสม Flag ฯลฯ)
--[no]experimental_docker_privileged
ค่าเริ่มต้น: "false"-
หากเปิดใช้ Bazel จะส่ง Flag --privileged ไปยัง "docker run" เมื่อเรียกใช้การดำเนินการ บิลด์ของคุณอาจกำหนดให้ต้องดำเนินการนี้ แต่อาจทำให้การปิดผนึกลดลงด้วย
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_sandboxfs_map_symlink_targets
: "เท็จ" -
No-op
แท็ก:host_machine_resource_optimizations
,execution
--[no]incompatible_legacy_local_fallback
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" ระบบจะเปิดใช้กลยุทธ์ที่แสดงโดยนัยเดิมจากแซนด์บ็อกซ์เป็นกลยุทธ์ในเครื่อง ในที่สุด Flag นี้จะมีค่าเริ่มต้นเป็นเท็จและจะกลายเป็นการดำเนินการที่ไม่มีผล ใช้ --strategy, --spawn_strategy หรือ --dynamic_local_strategy เพื่อกําหนดค่าการแทนที่แทน
แท็ก:execution
,incompatible_change
--sandbox_add_mount_pair=<a single path or a 'source:target' pair>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
เพิ่มคู่เส้นทางเพิ่มเติมเพื่อต่อเชื่อมในแซนด์บ็อกซ์
แท็ก:execution
--sandbox_block_path=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
สำหรับการดำเนินการในกล่องทดสอบ ให้ไม่อนุญาตการเข้าถึงเส้นทางนี้
แท็ก:execution
--[no]sandbox_default_allow_network
ค่าเริ่มต้น: "true"-
อนุญาตการเข้าถึงเครือข่ายโดยค่าเริ่มต้นสำหรับการดำเนินการ ซึ่งอาจใช้ไม่ได้กับการใช้งานแซนด์บ็อกซ์บางประเภท
แท็ก:execution
- ค่าเริ่มต้น
--[no]sandbox_fake_hostname
: "เท็จ" -
เปลี่ยนชื่อโฮสต์ปัจจุบันเป็น "localhost" เพื่อดำเนินการที่ใช้แซนด์บ็อกซ์
แท็ก:execution
- ค่าเริ่มต้น
--[no]sandbox_fake_username
: "เท็จ" -
เปลี่ยนชื่อผู้ใช้ปัจจุบันเป็น "nobody" สําหรับการดําเนินการในกล่องทดสอบ
แท็ก:execution
--sandbox_writable_path=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
สำหรับการดำเนินการที่เป็นแซนด์บ็อกซ์ ให้ทำให้ไดเรกทอรีที่มีอยู่เขียนได้ในแซนด์บ็อกซ์ (หากการใช้งานแซนด์บ็อกซ์รองรับ และจะไม่พิจารณาไดเรกทอรีอื่น)
แท็ก:execution
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ API การสร้างที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_config_setting_private_default_visibility
: "เท็จ" -
หาก incompatible_enforce_config_setting_visibility=false จะไม่มีการดำเนินการใดๆ หรือหาก Flag นี้เป็นเท็จ config_setting ที่ไม่มีแอตทริบิวต์ระดับการมองเห็นที่ชัดเจนจะเป็น //visibility:public หาก Flag นี้เป็น "จริง" config_setting จะใช้ตรรกะการแสดงผลเดียวกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_enforce_config_setting_visibility
: "true" -
หากเป็น "จริง" ระบบจะบังคับใช้ข้อจำกัดการแสดงผลของ config_setting หากเป็น "เท็จ" ทุก config_setting จะปรากฏแก่เป้าหมายทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่ควบคุมลักษณะการทํางานของสภาพแวดล้อมการทดสอบหรือโปรแกรมรันทดสอบ
- ค่าเริ่มต้น
--[no]check_tests_up_to_date
: "เท็จ" -
อย่าทำการทดสอบ เพียงตรวจสอบว่าอัปเดตแล้ว หากผลการทดสอบทั้งหมดเป็นปัจจุบัน แสดงว่าการทดสอบเสร็จสมบูรณ์ หากต้องสร้างหรือดำเนินการทดสอบใดๆ ระบบจะรายงานข้อผิดพลาดและการทดสอบจะไม่สำเร็จ ตัวเลือกนี้ใช้กับลักษณะการทํางานของ --check_up_to_date
แท็ก:execution
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
รายการ -
ระบบจะพยายามทดสอบแต่ละรายการอีกครั้งตามจำนวนครั้งที่ระบุไว้ในกรณีที่ทดสอบไม่สำเร็จ การทดสอบที่ต้องใช้มากกว่า 1 ครั้งจึงจะผ่านจะมีการทําเครื่องหมายเป็น "ไม่เสถียร" ในสรุปการทดสอบ โดยปกติแล้ว ค่าที่ระบุจะเป็นแค่จำนวนเต็มหรือสตริง "ค่าเริ่มต้น" หากเป็นจำนวนเต็ม ระบบจะเรียกใช้การทดสอบทั้งหมดไม่เกิน 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">
: "อัตโนมัติ" -
จำนวนงานทดสอบในเครื่องสูงสุดที่จะเรียกใช้พร้อมกัน ใช้จำนวนเต็มหรือคีย์เวิร์ด ("auto", "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 test" ที่จะใช้
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตการค้นหาและความหมาย
- ค่าเริ่มต้น
--[no]experimental_parallel_aquery_output
: "true" - ไม่มีการดำเนินการใดๆ
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะอนุญาตในกราฟ Dependency ที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่ามีการดึงออกในรีจิสทรีที่มาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น การดึงเวอร์ชันออกจะทำให้การแก้ไขไม่สำเร็จ นอกจากนี้ คุณยังกำหนดเวอร์ชันลบที่อนุญาตด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" ได้ด้วย คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็ก:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ" "off" เพื่อปิดใช้การตรวจสอบ หรือ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่า Dependency ของ `bazel_dep` โดยตรงที่ประกาศไว้ในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟ Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ใช้ได้คือ "off" เพื่อปิดใช้การตรวจสอบ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน หรือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ"
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นข้อกำหนดในการพัฒนาเหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูท ไม่ว่าค่าของ Flag นี้จะเป็นอย่างไรก็ตาม
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--lockfile_mode=<off, update, refresh or error>
: "อัปเดต" -
ระบุวิธีและระบุว่าจะใช้ไฟล์ล็อกหรือไม่ ค่าที่ถูกต้องคือ "อัปเดต" เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง "รีเฟรช" เพื่อรีเฟรชข้อมูลที่เปลี่ยนแปลงได้เพิ่มเติม (เวอร์ชันที่แยกออกมาและโมดูลที่หายไปก่อนหน้านี้) จากรีจิสทรีระยะไกลเป็นครั้งคราว "ข้อผิดพลาด" ในการใช้ไฟล์ล็อกแต่เกิดข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่อไม่อ่านหรือเขียนไปยังไฟล์ล็อก
แท็ก:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างโมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีทํางานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้านี้ออก
--registry=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้ในการค้นหาทรัพยากร Dependency ของโมดูล Bazel ลําดับมีความสําคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะเปลี่ยนไปใช้รีจิสทรีที่ใหม่กว่าก็ต่อเมื่อไม่มีโมดูลที่ต้องการในรีจิสทรีก่อนหน้า
แท็ก:changes_inputs
- ค่าเริ่มต้น
--vendor_dir=<a path>
: ดูคำอธิบาย -
ระบุไดเรกทอรีที่ควรเก็บที่เก็บข้อมูลภายนอกในโหมดผู้ให้บริการ ไม่ว่าจะเป็นเพื่อดึงข้อมูลมายังไดเรกทอรีดังกล่าวหรือใช้ขณะสร้าง เส้นทางอาจเป็นเส้นทางแบบสัมบูรณ์หรือเส้นทางแบบสัมพัทธ์กับไดเรกทอรีของพื้นที่ทำงานก็ได้
แท็ก:loading_and_analysis
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพของเวลาสร้างมีดังนี้
--cache_computed_file_digests=<a long integer>
ค่าเริ่มต้น: "50000"- หากมากกว่า 0 ให้กำหนดค่า Bazel ให้แคชไดเจสต์ของไฟล์ในหน่วยความจำตามข้อมูลเมตาแทนการคำนวณไดเจสต์ใหม่จากดิสก์ทุกครั้งที่ต้องการ การตั้งค่านี้เป็น 0 จะทำให้แน่ใจได้ว่าถูกต้อง เนื่องจากระบบไม่สามารถบันทึกการเปลี่ยนแปลงของไฟล์ทั้งหมดจากข้อมูลเมตาของไฟล์ เมื่อไม่ใช่ 0 ตัวเลขนี้บ่งบอกถึงขนาดของแคชตามจำนวนไดเจสต์ของไฟล์ที่จะแคช
--experimental_dynamic_ignore_local_signals=<a comma-separated list of signal numbers>
default: ดูคำอธิบาย-
ใช้รายการหมายเลขสัญญาณ OS หากสาขาการดําเนินการแบบไดนามิกในเครื่องถูกหยุดด้วยสัญญาณเหล่านี้ ระบบจะอนุญาตให้สาขาระยะไกลดําเนินการจนเสร็จสิ้นแทน สําหรับผู้ทํางานที่ทำงานอยู่อย่างต่อเนื่อง ตัวเลือกนี้จะมีผลต่อสัญญาณที่หยุดกระบวนการทํางานเท่านั้น
แท็ก:execution
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
ค่าเริ่มต้น: "1s:2,20s:3,1m:5"-
ขีดจำกัดซึ่งหากถึงแล้วจะทำให้ GcThrashingDetector เกิดข้อขัดข้องกับ Bazel ด้วย OOM โดยระบุขีดจํากัดแต่ละรายการเป็น <period>:<count> โดยที่ period คือระยะเวลา และ count คือจํานวนเต็มบวก หากมีการใช้พื้นที่ที่มีการจัดสรรไว้ (ฮีปรุ่นเก่า) มากกว่า --gc_thrashing_threshold เปอร์เซ็นต์หลังจากการเรียกใช้ GC แบบเต็มติดต่อกัน <count> ครั้งภายใน <period> ระบบจะเรียกใช้ OOM คุณสามารถระบุขีดจํากัดหลายรายการโดยคั่นด้วยคอมมา
แท็ก:host_machine_resource_optimizations
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
ค่าเริ่มต้น: "HOST_CPUS"-
กำหนดจำนวนแกน CPU ทั้งหมดในเครื่องที่พร้อมให้ Bazel ใช้สำหรับการดำเนินการสร้างที่ดำเนินการในเครื่อง ใช้จำนวนเต็มหรือ "HOST_CPUS" ตามด้วย [-|*]<float> (ไม่บังคับ) (เช่น HOST_CPUS*.5 เพื่อใช้แกน CPU ที่มีครึ่งหนึ่ง) โดยค่าเริ่มต้น ("HOST_CPUS") Bazel จะค้นหาการกําหนดค่าระบบเพื่อประมาณจํานวนแกน CPU ที่พร้อมใช้งาน
แท็ก:host_machine_resource_optimizations
--local_extra_resources=<a named float, 'name=value'>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
กำหนดจำนวนทรัพยากรเพิ่มเติมที่พร้อมใช้งานสำหรับ Bazel รับคู่สตริง-float ใช้ซ้ำได้เพื่อระบุทรัพยากรเพิ่มเติมหลายประเภท Bazel จะจำกัดการดำเนินการที่ทำงานพร้อมกันตามทรัพยากรเพิ่มเติมที่มีอยู่และทรัพยากรเพิ่มเติมที่จําเป็น การทดสอบสามารถประกาศจํานวนทรัพยากรเพิ่มเติมที่ต้องการได้โดยใช้แท็กรูปแบบ "resources:<resoucename>:<amount>" คุณไม่สามารถตั้งค่า CPU, RAM และทรัพยากรที่ใช้ได้โดยใช้ Flag นี้
แท็ก: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% ของ RAM นั้น
แท็ก:host_machine_resource_optimizations
--local_resources=<a named double, 'name=value', where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
ระบบจะรวบรวมการใช้งานหลายครั้ง-
กำหนดจำนวนทรัพยากรที่พร้อมใช้งานสำหรับ Bazel รับการกําหนดค่าไปยัง float หรือ HOST_RAM/HOST_CPUS ตามด้วย [-|*]<float> (ไม่บังคับ) (เช่น memory=HOST_RAM*.5 เพื่อใช้ RAM ที่มีครึ่งหนึ่ง) ใช้หลายครั้งเพื่อระบุทรัพยากรหลายประเภทได้ Bazel จะจำกัดการดำเนินการที่ทำงานพร้อมกันตามทรัพยากรที่มีอยู่และทรัพยากรที่จำเป็น การทดสอบสามารถประกาศจํานวนทรัพยากรที่ต้องการได้โดยใช้แท็กรูปแบบ "resources:<resource name>:<amount>" ลบล้างทรัพยากรที่ระบุโดย --local_{cpu|ram|extra}_resources
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้ฮีปที่เก็บรักษาไว้เกินเกณฑ์ที่ --skyframe_high_water_mark_threshold กำหนด เมื่อเกิดเหตุการณ์ GC เต็มรูปแบบเกิดขึ้น สถานะของ Skyframe ชั่วคราวจะถูกตัดทิ้งโดยไม่จำเป็นจนถึงจำนวนครั้งดังกล่าวต่อการเรียกใช้หลายครั้ง ค่าเริ่มต้นเป็น Integer.MAX_VALUE โดยไม่มีขีดจำกัด 0 หมายความว่าเหตุการณ์ GC แบบสมบูรณ์จะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC แบบเต็มและเปอร์เซ็นต์ของกองข้อมูลที่เก็บรักษาไว้เกินเกณฑ์
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
แฟล็กสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC เล็กน้อยขึ้น ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนนี้ต่อการเรียกใช้แต่ละครั้ง ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด 0 หมายความว่าเหตุการณ์ GC เล็กน้อยจะไม่ทริกเกอร์การลดลง หากถึงขีดจำกัด สถานะ Skyframe จะไม่ลดลงอีกต่อไปเมื่อเกิดเหตุการณ์ GC ที่ไม่ร้ายแรงและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
แฟล็กสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานฮีปที่สะสมไว้ถึงเกณฑ์นี้เป็นอย่างน้อย ก็จะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็น การปรับแต่งค่านี้อาจช่วยลดผลกระทบต่อเวลาจริงของการกระหน่ำ GC เมื่อการกระหน่ำ GC (1) เกิดจากการใช้งานหน่วยความจําของสถานะชั่วคราวนี้ และ (2) เสียค่าใช้จ่ายมากกว่าการสร้างสถานะใหม่เมื่อจําเป็น
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก
--[no]debug_spawn_scheduler
ค่าเริ่มต้น: "false"--[no]experimental_bep_target_summary
ค่าเริ่มต้น: "false"- ระบุว่าจะเผยแพร่เหตุการณ์ TargetSummary หรือไม่
--[no]experimental_build_event_expand_filesets
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" ระบบจะขยายชุดไฟล์ใน BEP เมื่อแสดงไฟล์เอาต์พุต
แท็ก:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" ระบบจะแก้ไขลิงก์สัญลักษณ์ของไฟล์ชุดที่เกี่ยวข้องใน BEP โดยสมบูรณ์เมื่อแสดงไฟล์เอาต์พุต ต้องมี --experimental_build_event_expand_filesset
แท็ก:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
ค่าเริ่มต้น: "4"-
จำนวนครั้งที่ Bazel ควรลองอัปโหลดเหตุการณ์การสร้างอีกครั้งสูงสุด
แท็ก:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
ค่าเริ่มต้น: "1s"-
ขั้นแรก ความล่าช้าขั้นต่ำสำหรับการลองใหม่แบบ Exponential Backoff เมื่ออัปโหลด BEP ไม่สำเร็จ (เลขชี้กำลัง: 1.6)
แท็ก:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
default: ดูคำอธิบาย-
เลือกวิธีอัปโหลดอาร์ติแฟกต์ที่อ้างอิงในโปรโตคอลเหตุการณ์การสร้าง
แท็ก:affects_outputs
--[no]experimental_collect_local_sandbox_action_metrics
ค่าเริ่มต้น: "true"-
เลิกใช้งานแล้ว ดำเนินการโดยไม่มีการดำเนินการใดๆ
แท็ก:execution
--experimental_command_profile=<cpu, wall, alloc or lock>
default: ดูคำอธิบาย- บันทึกโปรไฟล์ Java Flight Recorder ตลอดระยะเวลาของคำสั่ง คุณต้องระบุประเภทเหตุการณ์โปรไฟล์ที่รองรับ (cpu, wall, alloc หรือ lock) รายการใดรายการหนึ่งเป็นอาร์กิวเมนต์ โปรไฟล์จะเขียนไปยังไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ภายใต้ไดเรกทอรีฐานเอาต์พุต ไวยากรณ์และความหมายของแฟล็กนี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับประเภทโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม คุณต้องยอมรับความเสี่ยงที่เกิดขึ้นเอง
--[no]experimental_docker_verbose
ค่าเริ่มต้น: "false"-
หากเปิดใช้ Bazel จะพิมพ์ข้อความที่ละเอียดมากขึ้นเกี่ยวกับกลยุทธ์แซนด์บ็อกซ์ของ Docker
แท็ก:execution
--[no]experimental_materialize_param_files_directly
ค่าเริ่มต้น: "false"-
หากจะแสดงไฟล์พารามิเตอร์ ให้เขียนลงในดิสก์โดยตรง
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_record_metrics_for_all_mnemonics
: "เท็จ" - โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจํากัดไว้ที่คําช่วยจํา 20 รายการที่มีการดําเนินการมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับคําช่วยจําทั้งหมด
--experimental_repository_resolved_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่างเปล่า ให้เขียนค่า Starlark พร้อมข้อมูลที่แก้ไขแล้วของกฎที่เก็บ Starlark ทั้งหมดที่ดำเนินการ
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_run_bep_event_include_residue
: "เท็จ" -
ไม่ว่าจะรวมข้อมูลที่เหลืออยู่ในบรรทัดคำสั่งไว้ในเหตุการณ์การเรียกใช้บิลด์ที่อาจมีข้อมูลที่เหลืออยู่หรือไม่ โดยค่าเริ่มต้น ข้อมูลที่เหลือจะไม่รวมอยู่ในเหตุการณ์การสร้างคําสั่งการเรียกใช้ที่อาจมีข้อมูลที่เหลืออยู่
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_stream_log_file_uploads
: "เท็จ" -
สตรีมการอัปโหลดไฟล์บันทึกไปยังพื้นที่เก็บข้อมูลระยะไกลโดยตรงแทนที่จะเขียนลงในดิสก์
แท็ก:affects_outputs
--explain=<a path>
default: ดูคำอธิบาย-
ทําให้ระบบบิลด์อธิบายแต่ละขั้นตอนที่ดำเนินการของบิลด์ ระบบจะเขียนคำอธิบายลงในไฟล์บันทึกที่ระบุ
แท็ก:affects_outputs
--[no]ignore_unsupported_sandboxing
ค่าเริ่มต้น: "false"-
อย่าพิมพ์คำเตือนเมื่อระบบนี้ไม่รองรับการดำเนินการใน sandbox
แท็ก:terminal_output
--[no]legacy_important_outputs
ค่าเริ่มต้น: "true"-
ใช้เพื่อระงับการสร้างช่อง important_outputs แบบเดิมในเหตุการณ์ TargetComplete โดยต้องใช้ important_outputs ในการผสานรวม Bazel กับ ResultStore
แท็ก:affects_outputs
--[no]materialize_param_files
ค่าเริ่มต้น: "false"-
เขียนไฟล์พารามิเตอร์กลางลงในต้นไม้เอาต์พุตแม้ว่าจะใช้การดำเนินการระยะไกลก็ตาม มีประโยชน์เมื่อแก้ไขข้อบกพร่องของการดำเนินการ ซึ่งจะแสดงโดย --subcommands และ --verbose_failures
แท็ก:execution
- ค่าเริ่มต้น
--max_config_changes_to_show=<an integer>
: "3" -
เมื่อทิ้งแคชการวิเคราะห์เนื่องจากการเปลี่ยนแปลงตัวเลือกการสร้าง ระบบจะแสดงชื่อตัวเลือกที่เปลี่ยนแปลงสูงสุดตามจำนวนที่ระบุ หากตัวเลขที่ระบุคือ -1 ตัวเลือกทั้งหมดที่มีการเปลี่ยนแปลงจะแสดงขึ้น
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--max_test_output_bytes=<an integer>
: "-1" -
ระบุขนาดสูงสุดของบันทึกการทดสอบต่อรายการที่ระบบจะแสดงเมื่อ --test_output เป็น "errors" หรือ "all" มีประโยชน์ในการหลีกเลี่ยงไม่ให้เอาต์พุตมีข้อมูลทดสอบที่รบกวนมากเกินไป ส่วนหัวการทดสอบจะรวมอยู่ในขนาดบันทึก ค่าติดลบหมายถึงไม่มีขีดจํากัด เอาต์พุตคือทั้งหมดหรือไม่มีเลย
แท็ก:test_runner
,terminal_output
,execution
--output_filter=<a valid Java regular expression>
default: ดูคำอธิบาย-
แสดงเฉพาะคำเตือนและเอาต์พุตการดำเนินการสำหรับกฎที่มีชื่อตรงกับนิพจน์ทั่วไปที่ระบุ
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--progress_report_interval=<an integer in 0-3600 range>
: "0" -
จำนวนวินาทีที่จะรอระหว่างรายงานเกี่ยวกับงานที่ยังคงทำงานอยู่ ค่าเริ่มต้น 0 หมายความว่าระบบจะพิมพ์รายงานฉบับแรกหลังจากผ่านไป 10 วินาที จากนั้นจะพิมพ์ทุก 30 วินาที และหลังจากนั้นระบบจะรายงานความคืบหน้าทุกนาที เมื่อเปิดใช้ --curses ระบบจะรายงานความคืบหน้าทุกๆ วินาที
แท็ก:affects_outputs
--remote_print_execution_messages=<failure, success or all>
ค่าเริ่มต้น: "failure"-
เลือกเวลาที่จะพิมพ์ข้อความการดำเนินการจากระยะไกล ค่าที่ถูกต้องคือ "failure" เพื่อแสดงเฉพาะในกรณีที่ไม่สําเร็จ "success" เพื่อแสดงเฉพาะในกรณีที่สําเร็จ และ "all" เพื่อแสดงเสมอ
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]sandbox_debug
: "เท็จ" -
เปิดใช้ฟีเจอร์การแก้ไขข้อบกพร่องสำหรับฟีเจอร์แซนด์บ็อกซ์ ซึ่งประกอบด้วย 2 สิ่ง ได้แก่ ประการแรก เนื้อหารูทของกล่องทรายจะยังคงเดิมหลังจากการบิลด์ และประการที่ 2 คือการพิมพ์ข้อมูลเพิ่มเติมเกี่ยวกับการแก้ไขข้อบกพร่องในการดำเนินการ ซึ่งจะช่วยนักพัฒนากฎ Bazel หรือ Starlark ในกรณีที่แก้ไขข้อบกพร่องไม่สำเร็จเนื่องจากไม่มีไฟล์อินพุต ฯลฯ
แท็ก:terminal_output
--show_result=<an integer>
ค่าเริ่มต้น: "1"-
แสดงผลลัพธ์ของบิลด์ สำหรับแต่ละเป้าหมาย ให้ระบุว่าเป็นข้อมูลล่าสุดหรือไม่ และหากใช่ ให้แจ้งรายการไฟล์เอาต์พุตที่สร้างขึ้น ไฟล์ที่พิมพ์เป็นสตริงที่สะดวกสำหรับการคัดลอกและวางลงในเชลล์เพื่อเรียกใช้
ตัวเลือกนี้ต้องใช้อาร์กิวเมนต์จำนวนเต็ม ซึ่งเป็นจำนวนเกณฑ์ของเป้าหมายด้านบนซึ่งระบบจะไม่พิมพ์ข้อมูลผลลัพธ์ ดังนั้น 0 จะทำให้เกิดการระงับข้อความ และ MAX_INT จะทําให้ระบบพิมพ์ผลลัพธ์เสมอ ค่าเริ่มต้นคือ 1
หากไม่มีการสร้างเป้าหมายใดเลย ระบบอาจละเว้นผลลัพธ์ของเป้าหมายนั้นเพื่อไม่ให้เอาต์พุตเกินเกณฑ์
แท็ก:affects_outputs
--[no]subcommands
[-s
] default: "false"-
แสดงคำสั่งย่อยที่ดำเนินการระหว่างการสร้าง Flag ที่เกี่ยวข้อง: --execution_log_json_file, --execution_log_binary_file (สําหรับการบันทึกคําสั่งย่อยลงในไฟล์ในรูปแบบที่เครื่องมือใช้งานง่าย)
แท็ก:terminal_output
- ค่าเริ่มต้น
--test_output=<summary, errors, all or streamed>
: "summary" -
ระบุโหมดเอาต์พุตที่ต้องการ ค่าที่ถูกต้องคือ "สรุป" เพื่อแสดงผลลัพธ์สรุปสถานะการทดสอบเท่านั้น, "ข้อผิดพลาด" เพื่อพิมพ์บันทึกการทดสอบสำหรับการทดสอบที่ล้มเหลวด้วย, "ทั้งหมด" เพื่อพิมพ์บันทึกสำหรับการทดสอบทั้งหมด และ "สตรีม" ไปยังบันทึกเอาต์พุตสำหรับการทดสอบทั้งหมดแบบเรียลไทม์ (ซึ่งจะบังคับให้ดำเนินการทดสอบพร้อมกันทีละเครื่องโดยไม่คำนึงถึงค่า --test_strategy)
แท็ก:test_runner
,terminal_output
,execution
- ค่าเริ่มต้นของ
--test_summary=<short, terse, detailed, none or testcase>
: "สั้น" -
ระบุรูปแบบที่ต้องการของสรุปการทดสอบ ค่าที่ใช้ได้คือ "สั้น" สำหรับพิมพ์ข้อมูลเฉพาะเกี่ยวกับการทดสอบที่ดำเนินการ, "บางส่วน" เพื่อพิมพ์ข้อมูลเฉพาะเกี่ยวกับการทดสอบที่ไม่สำเร็จ, "รายละเอียด" เพื่อพิมพ์ข้อมูลโดยละเอียดเกี่ยวกับกรอบการทดสอบที่ไม่สำเร็จ, "กรอบ" เพื่อพิมพ์ข้อมูลสรุปเพื่อแก้ไขกรอบการทดสอบ, อย่าพิมพ์ข้อมูลโดยละเอียดเกี่ยวกับกรอบการทดสอบที่ไม่สำเร็จ และ "ไม่มี" เพื่อละเว้นข้อมูลสรุป
แท็ก:terminal_output
--[no]verbose_explanations
ค่าเริ่มต้น: "false"-
เพิ่มรายละเอียดของคำอธิบายที่แสดงหากเปิดใช้ --explain จะไม่มีผล หากไม่ได้เปิดใช้งาน --explain
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]verbose_failures
: "เท็จ" -
หากคําสั่งไม่สําเร็จ ให้พิมพ์บรรทัดคําสั่งแบบเต็ม
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
--aspects_parameters=<a 'name=value' assignment>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุค่าของพารามิเตอร์แง่มุมบรรทัดคำสั่ง ค่าพารามิเตอร์แต่ละค่าจะระบุผ่าน <param_name>=<param_value> เช่น "my_param=my_val" โดยที่ "my_param" คือพารามิเตอร์ของแง่มุมบางอย่างในรายการ --aspects หรือเป็นแง่มุมในรายการที่กำหนด ตัวเลือกนี้ใช้ได้หลายครั้ง อย่างไรก็ตาม ไม่อนุญาตให้กำหนดค่าให้กับพารามิเตอร์เดียวกันมากกว่า 1 ครั้ง
แท็ก:loading_and_analysis
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ใช่ค่าว่าง ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
--target_pattern_file=<a string>
ค่าเริ่มต้น: ""-
หากตั้งค่าไว้ บิลด์จะอ่านรูปแบบจากไฟล์ที่ระบุชื่อไว้ที่นี่แทนที่จะเป็นในบรรทัดคำสั่ง การระบุไฟล์ที่นี่พร้อมกับรูปแบบบรรทัดคำสั่งจะเป็นข้อผิดพลาด
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล
- ค่าเริ่มต้น
--experimental_circuit_breaker_strategy=<failure>
: ดูคำอธิบาย -
ระบุกลยุทธ์ที่จะใช้กับตัวตัดวงจร กลยุทธ์ที่ใช้ได้คือ "failure" เมื่อค่าของตัวเลือกไม่ถูกต้อง ระบบจะไม่ตั้งค่าลักษณะการทำงานเหมือนกับตัวเลือก
แท็ก:execution
- ค่าเริ่มต้น
--experimental_downloader_config=<a string>
: ดูคำอธิบาย - ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดจากระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะขึ้นต้นด้วยคําสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สําหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ โดยรูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้แทน URL โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณอาจระบุคําสั่ง `rewrite` หลายรายการสําหรับ URL เดียวกันได้ ซึ่งในกรณีนี้ระบบจะแสดงผล URL หลายรายการ
--[no]experimental_guard_against_concurrent_changes
ค่าเริ่มต้น: "false"- ปิดการตั้งค่านี้เพื่อปิดใช้การตรวจสอบ ctime ของไฟล์อินพุตของการดำเนินการก่อนที่จะอัปโหลดไปยังแคชระยะไกล อาจมีกรณีที่เคอร์เนล Linux เลื่อนเวลาการเขียนไฟล์ ซึ่งอาจทำให้เกิดผลบวกเท็จ
--[no]experimental_remote_cache_async
ค่าเริ่มต้น: "false"- หากเป็น "จริง" การดำเนินการ 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 คุณไม่ควรใช้ Flag นี้ แต่ให้ตั้งค่า Flag --incompatible_remote_use_new_exit_code_for_lost_inputs แล้วตรวจสอบโค้ดออก 39
แท็ก:execution
--[no]experimental_remote_cache_lease_extension
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" Bazel จะขยายระยะเวลาเช่าสำหรับเอาต์พุตของการดำเนินการระยะไกลระหว่างการสร้างโดยการส่งการเรียก `FindMissingBlobs` ไปยังแคชระยะไกลเป็นระยะๆ ความถี่จะอิงตามค่าของ `--experimental_remote_cache_ttl`
- ค่าเริ่มต้น
--experimental_remote_cache_ttl=<An immutable length of time.>
: "3 ชม." -
TTL ที่รับประกันขั้นต่ำของ BLOB ในแคชระยะไกลหลังจากมีการอ้างอิงไดเจสต์เมื่อเร็วๆ นี้ เช่น โดย ActionResult หรือ FindDoesBlobs Bazel ทำการเพิ่มประสิทธิภาพหลายอย่างตาม TTL ของ Blob เช่น ไม่เรียก GetActionResult ซ้ำๆ ในบิลด์แบบเพิ่ม คุณควรตั้งค่าให้น้อยกว่า TTL จริงเล็กน้อย เนื่องจากมีช่วงเวลาระหว่างที่เซิร์ฟเวอร์แสดงผลข้อมูลสรุปและเวลาที่ Bazel ได้รับข้อมูลสรุป
แท็ก:execution
--experimental_remote_capture_corrupted_outputs=<a path>
default: ดูคำอธิบาย- เส้นทางไปยังไดเรกทอรีที่จะบันทึกเอาต์พุตที่เสียหาย
- ค่าเริ่มต้น
--[no]experimental_remote_discard_merkle_trees
: "เท็จ" - หากตั้งค่าเป็น "จริง" ระบบจะทิ้งสำเนาในหน่วยความจำของต้นไม้ Merkle ของรูทอินพุตและการแมปอินพุตที่เกี่ยวข้องในระหว่างการเรียก GetActionResult() และ Execute() ซึ่งจะช่วยลดการใช้หน่วยความจำได้อย่างมาก แต่จะทำให้ Bazel ต้องคํานวณใหม่เมื่อแคชระยะไกลไม่พบและพยายามอีกครั้ง
- ค่าเริ่มต้น
--experimental_remote_downloader=<a string>
: ดูคำอธิบาย - URI ของปลายทาง Remote Asset API เพื่อใช้เป็นพร็อกซีการดาวน์โหลดจากระยะไกล สคีมาที่รองรับ ได้แก่ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ unix (ซ็อกเก็ต UNIX ในพื้นที่) หากไม่ได้ระบุสคีมา Bazel จะใช้ grpcs เป็นค่าเริ่มต้น ดูที่ https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
ค่าเริ่มต้น: "false"- เลือกว่าจะเปลี่ยนไปใช้โปรแกรมดาวน์โหลดในเครื่องหรือไม่หากโปรแกรมดาวน์โหลดระยะไกลล้มเหลว
- ค่าเริ่มต้น
--[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
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" Bazel จะทําเครื่องหมายอินพุตเป็นอินพุตเครื่องมือสําหรับผู้ดําเนินการระยะไกล โดยใช้ข้อมูลนี้เพื่อใช้งานผู้ปฏิบัติงานที่ทำงานถาวรจากระยะไกลได้
--[no]experimental_remote_merkle_tree_cache
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" ระบบจะจดจําการคํานวณต้นไม้ Merkle เพื่อปรับปรุงความเร็วในการตรวจสอบการทํางานของแคชระยะไกล ปริมาณหน่วยความจําของแคชจะควบคุมโดย --experimental_remote_merkle_tree_cache_size
--experimental_remote_merkle_tree_cache_size=<a long integer>
ค่าเริ่มต้น: "1000"- จํานวนต้นไม้ Merkle ที่จะจดจําเพื่อปรับปรุงความเร็วในการตรวจสอบการทํางานของแคชระยะไกล แม้ว่าแคชจะถูกตัดออกโดยอัตโนมัติตามการจัดการการอ้างอิงแบบซอฟต์ของ Java แต่ก็สามารถเกิดข้อผิดพลาดออกจากหน่วยความจำได้ถ้าตั้งไว้สูงเกินไป หากตั้งค่าเป็น 0 ระบบจะไม่จำกัดขนาดแคช ค่าที่เหมาะสมจะแตกต่างกันไปตามขนาดของโปรเจ็กต์ ค่าเริ่มต้นคือ 1,000
- ค่าเริ่มต้น
--experimental_remote_output_service=<a string>
: ดูคำอธิบาย - HOST หรือ HOST:PORT ของปลายทางบริการเอาต์พุตระยะไกล สคีมาที่รองรับ ได้แก่ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ unix (ซ็อกเก็ต UNIX ในพื้นที่) หากไม่ได้ระบุสคีมา Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุสคีมา grpc:// หรือ unix: เพื่อปิดใช้ TLS
- ค่าเริ่มต้น
--experimental_remote_output_service_output_path_prefix=<a string>
: "" - เส้นทางการวางเนื้อหาของไดเรกทอรีเอาต์พุตที่จัดการโดย --experimental_remote_output_service ไดเรกทอรีเอาต์พุตจริงที่บิลด์ใช้จะเป็นรายการสืบทอดของเส้นทางนี้และกำหนดโดยบริการเอาต์พุต
--[no]experimental_remote_require_cached
ค่าเริ่มต้น: "false"- หากตั้งค่าเป็น "จริง" ให้บังคับใช้การแคชการดำเนินการทั้งหมดที่เรียกใช้จากระยะไกลได้ ไม่เช่นนั้นจะทำให้บิลด์ใช้งานไม่ได้ วิธีนี้มีประโยชน์ในการแก้ปัญหาความไม่แน่นอน เนื่องจากช่วยให้ตรวจสอบได้ว่ามีการแคชการดําเนินการที่ควรแคชไว้จริงหรือไม่ โดยไม่ต้องแทรกผลลัพธ์ใหม่ลงในแคชโดยไม่ตั้งใจ
--experimental_remote_scrubbing_config=<Converts to a Scrubber>
default: ดูคำอธิบาย- เปิดใช้การสแกนคีย์แคชระยะไกลด้วยไฟล์การกําหนดค่าที่ระบุ ซึ่งต้องเป็นโปรโตคอลบัฟเฟอร์ในรูปแบบข้อความ (ดู src/main/protobuf/remote_scrubbing.proto) ฟีเจอร์นี้มีไว้เพื่ออำนวยความสะดวกในการแชร์คaché ระยะไกล/ดิสก์ระหว่างการดำเนินการที่ทำงานบนแพลตฟอร์มที่แตกต่างกันแต่กำหนดเป้าหมายไปยังแพลตฟอร์มเดียวกัน คุณควรใช้การตั้งค่านี้อย่างระมัดระวัง เนื่องจากการตั้งค่าที่ไม่เหมาะสมอาจทำให้เกิดการแชร์รายการแคชโดยไม่ตั้งใจและส่งผลให้บิลด์ไม่ถูกต้อง การสแกนจะไม่ส่งผลต่อวิธีดำเนินการ แต่ส่งผลต่อวิธีคํานวณคีย์แคชระยะไกล/ดิสก์เพื่อดึงข้อมูลหรือจัดเก็บผลลัพธ์การดำเนินการเท่านั้น การดำเนินการแบบสครับใช้กับการดำเนินการระยะไกลไม่ได้ และจะดำเนินการภายในแทนเสมอ การแก้ไขการกําหนดค่าการสแกนจะไม่ทำให้เอาต์พุตที่มีอยู่ในระบบไฟล์ในเครื่องหรือแคชภายในเป็นโมฆะ คุณจะต้องสร้างใหม่แบบ "Clean Build" เพื่อดําเนินการที่มีผลอีกครั้ง หากต้องการใช้ฟีเจอร์นี้ให้สําเร็จ คุณอาจต้องตั้งค่า --host_platform ที่กําหนดเองพร้อมกับ --experimental_platform_in_output_dir (เพื่อทำให้คำนำหน้าเอาต์พุตเป็นมาตรฐาน) และ --incompatible_strict_action_env (เพื่อทำให้ตัวแปรสภาพแวดล้อมเป็นมาตรฐาน)
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
ค่าเริ่มต้น: "auto"- โหมดการแยกชุดข้อความที่จะใช้ดึงข้อมูลรีโป หากตั้งค่าเป็น "ปิด" ระบบจะไม่ใช้เธรดสำหรับงานและการดึงข้อมูลรีโปจะขึ้นอยู่กับการรีสตาร์ท ไม่เช่นนั้นจะใช้เธรดผู้ทํางานเสมือน
--[no]incompatible_remote_build_event_upload_respect_no_cache
ค่าเริ่มต้น: "false"- เลิกใช้งานแล้ว ไม่ทํางานใดๆ ให้ใช้ --remote_build_event_upload=minimal แทน
--[no]incompatible_remote_downloader_send_all_headers
ค่าเริ่มต้น: "true"-
กำหนดว่าจะส่งค่าทั้งหมดของส่วนหัวแบบหลายค่าไปยังโปรแกรมดาวน์โหลดระยะไกลแทนที่จะส่งเฉพาะค่าแรกหรือไม่
แท็ก:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
ค่าเริ่มต้น: "false"-
หากตั้งค่าเป็น "จริง" เส้นทางเอาต์พุตจะสัมพันธ์กับรูทอินพุตแทนไดเรกทอรีการทำงาน
แท็ก:incompatible_change
--[no]incompatible_remote_results_ignore_disk
ค่าเริ่มต้น: "true"-
No-op
แท็ก:incompatible_change
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
ค่าเริ่มต้น: "true"-
หากตั้งค่าเป็น "จริง" Bazel จะใช้รหัสออกใหม่ 39 แทน 34 หากข้อผิดพลาดเกี่ยวกับแคชระยะไกล รวมถึงการลบแคชออกทําให้บิลด์ไม่สําเร็จ
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]remote_accept_cached
: "จริง" - การยอมรับผลลัพธ์การดำเนินการที่แคชไว้จากระยะไกล
- ค่าเริ่มต้น
--remote_build_event_upload=<all or minimal>
: "ขั้นต่ำ" - หากตั้งค่าเป็น "ทั้งหมด" ระบบจะอัปโหลดเอาต์พุตในเครื่องทั้งหมดที่ BEP อ้างอิงไปยังแคชระยะไกล หากตั้งค่าเป็น "ต่ำสุด" ระบบจะไม่อัปโหลดเอาต์พุตในเครื่องที่อ้างอิงโดย BEP ไปยังแคชระยะไกล ยกเว้นไฟล์ที่มีความสำคัญต่อผู้บริโภคของ BEP (เช่น บันทึกการทดสอบและโปรไฟล์การจับเวลา) ระบบจะใช้รูปแบบ bytesstream:// กับ URI ของไฟล์เสมอแม้ว่าไฟล์เหล่านั้นจะหายไปจากแคชระยะไกลก็ตาม ค่าเริ่มต้นคือ "ขั้นต่ำ"
--remote_bytestream_uri_prefix=<a string>
default: ดูคำอธิบาย- ชื่อโฮสต์และชื่ออินสแตนซ์ที่จะใช้ใน URI ของ bytestream:// ที่เขียนลงในสตรีมเหตุการณ์การสร้าง ตัวเลือกนี้สามารถตั้งค่าได้เมื่อทำการบิลด์โดยใช้พร็อกซี ซึ่งจะทำให้ค่าของ --remote_executor และ --remote_instance_name ไม่สอดคล้องกับชื่อที่เป็นทางการของบริการการเรียกใช้ระยะไกลอีกต่อไป หากไม่ได้ตั้งค่าไว้ ค่าเริ่มต้นจะเป็น "${hostname}/${instance_name}"
--remote_cache=<a string>
default: ดูคำอธิบาย- URI ของปลายทางแคช สคีมที่รองรับ ได้แก่ http, https, grpc, grpcs (grpc ที่เปิดใช้ TLS) และ unix (ซ็อกเก็ต UNIX ในพื้นที่) หากไม่ได้ระบุสคีมา Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุสคีมา grpc://, http:// หรือ unix: เพื่อปิดใช้ TLS ดูที่ https://bazel.build/remote/caching
--[no]remote_cache_compression
ค่าเริ่มต้น: "false"- หากเปิดใช้ ให้บีบอัด/คลายการบีบอัด Blob แคชด้วย zstd เมื่อมีขนาดอย่างน้อย --experimental_remote_cache_compression_threshold
--remote_cache_header=<a 'name=value' assignment>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ระบุส่วนหัวที่จะรวมอยู่ในคําขอแคช: --remote_cache_header=ชื่อ=ค่า คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุ Flag หลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
--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 คุณระบุรูปแบบได้หลายรายการโดยการใช้ Flag นี้ซ้ำ
แท็ก:affects_outputs
--remote_downloader_header=<a 'name=value' assignment>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ระบุส่วนหัวที่จะรวมอยู่ในคําขอของเครื่องมือดาวน์โหลดระยะไกล: --remote_downloader_header=ชื่อ=ค่า คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุ Flag หลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--remote_exec_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคําขอการดําเนินการ: --remote_exec_header=ชื่อ=ค่า คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุ Flag หลายครั้ง ระบบจะแปลงค่าหลายค่าที่มีชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- ค่าเริ่มต้น
--remote_execution_priority=<an integer>
: "0" - ลําดับความสําคัญแบบสัมพัทธ์ของการดำเนินการที่จะดําเนินการจากระยะไกล ความหมายของค่าลำดับความสำคัญหนึ่งๆ จะขึ้นอยู่กับเซิร์ฟเวอร์
--remote_executor=<a string>
default: ดูคำอธิบาย- HOST หรือ HOST:PORT ของปลายทางการเรียกใช้ระยะไกล สคีมาที่รองรับ ได้แก่ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ unix (ซ็อกเก็ต UNIX ในพื้นที่) หากไม่ได้ระบุสคีมา Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุสคีมา grpc:// หรือ unix: เพื่อปิดใช้ TLS
--remote_grpc_log=<a path>
default: ดูคำอธิบาย- เส้นทางไปยังไฟล์เพื่อบันทึกรายละเอียดการเรียกใช้ gRPC หากระบุ บันทึกนี้ประกอบด้วยลำดับ protobuf ของ com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry ที่แปลงเป็นอนุกรม โดยแต่ละข้อความจะมี varint นำหน้า ซึ่งระบุขนาดของข้อความ protobuf ที่แปลงเป็นอนุกรมรายการถัดไป ตามที่ดำเนินการโดยเมธอด LogEntry.writeDelimitedTo(OutputStream)
--remote_header=<a 'name=value' assignment>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ระบุส่วนหัวที่จะรวมอยู่ในคําขอ: --remote_header=ชื่อ=ค่า คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุ Flag หลายครั้ง ระบบจะแปลงค่าหลายค่าที่มีชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
--remote_instance_name=<a string>
ค่าเริ่มต้น: ""- ค่าที่จะส่งเป็น instance_name ใน API การดำเนินการระยะไกล
- ค่าเริ่มต้น
--[no]remote_local_fallback
: "เท็จ" - Whether to fall back to standalone local execution strategy if remote execution fails.
--remote_local_fallback_strategy=<a string>
ค่าเริ่มต้น: "local"- ไม่มีการดำเนินการใดๆ เลิกใช้งานแล้ว ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7480
--remote_max_connections=<an integer>
ค่าเริ่มต้น: "100"-
จำกัดจำนวนการเชื่อมต่อพร้อมกันสูงสุดให้กับแคช/ผู้ดำเนินการระยะไกล โดยค่าเริ่มต้น ค่านี้คือ 100 การตั้งค่านี้เป็น 0 หมายความว่าไม่มีข้อจํากัด
สำหรับแคชระยะไกล HTTP การเชื่อมต่อ TCP 1 รายการจะจัดการคำขอได้ 1 รายการพร้อมกัน ดังนั้น Bazel จึงส่งคำขอพร้อมกันได้สูงสุด --remote_max_connections
สําหรับแคช/ผู้ดําเนินการระยะไกล gRPC ปกติแล้วแชแนล gRPC 1 ช่องจะจัดการคําขอพร้อมกันได้มากกว่า 100 รายการ ดังนั้น Bazel จึงทําคําขอพร้อมกันได้ประมาณ `--remote_max_connections * 100`
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้น
--remote_proxy=<a string>
: ดูคำอธิบาย - เชื่อมต่อกับแคชระยะไกลผ่านพร็อกซี ปัจจุบันแฟล็กนี้ใช้ได้กับการกำหนดค่าซ็อกเก็ตโดเมน 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) วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
--remote_timeout=<An immutable length of time.>
default: "60s"- ระยะเวลาสูงสุดที่รอการเรียกใช้ระยะไกลและการเรียกใช้แคช สําหรับแคช REST ค่านี้คือทั้งการหมดเวลาเชื่อมต่อและการอ่าน คุณสามารถใช้หน่วยต่อไปนี้ได้ ได้แก่ วัน (d) ชั่วโมง (h) นาที (m) วินาที (s) และมิลลิวินาที (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" (ไม่กรอง / แสดงทุกอย่าง), "all" (กรองทุกอย่าง / แสดงไม่มีอะไร), "packages" (รวมเอาเอาต์พุตจากกฎในแพ็กเกจที่กล่าวถึงในบรรทัดคำสั่งของ Blaze) และ "subpackages" (เหมือนกับ "packages" แต่รวมเอาแพ็กเกจย่อยด้วย) สำหรับค่า "packages" และ "subpackages" ระบบจะถือว่า //java/foo และ //javatests/foo เป็นแพ็กเกจเดียวกัน)'
--[no]build_manual_tests
ค่าเริ่มต้น: "false"- บังคับให้สร้างเป้าหมายทดสอบที่ติดแท็ก "ด้วยตนเอง" ระบบจะไม่ประมวลผลการทดสอบที่ "ดำเนินการด้วยตนเอง" ตัวเลือกนี้จะบังคับให้คอมไพล์ (แต่ไม่เรียกใช้)
--build_tag_filters=<comma-separated list of options>
ค่าเริ่มต้น: ""- ระบุรายการแท็กที่คั่นด้วยคอมมา แต่ละแท็กสามารถใส่เครื่องหมาย "-" ไว้ข้างหน้าได้เพื่อระบุแท็กที่ยกเว้น ระบบจะสร้างเฉพาะเป้าหมายที่มีแท็กที่รวมไว้อย่างน้อย 1 แท็กและไม่มีแท็กที่ยกเว้น ตัวเลือกนี้ไม่มีผลกับชุดการทดสอบที่ดำเนินการด้วยคําสั่ง "test" ซึ่งอยู่ภายใต้การควบคุมของตัวเลือกการกรองการทดสอบ เช่น "--test_tag_filters"
--[no]build_tests_only
ค่าเริ่มต้น: "false"- หากระบุ ระบบจะสร้างเฉพาะกฎ *_test และ test_suite และจะละเว้นเป้าหมายอื่นๆ ที่ระบุไว้ในบรรทัดคำสั่ง โดยค่าเริ่มต้น ระบบจะสร้างทุกอย่างที่ขอ
--combined_report=<none or lcov>
ค่าเริ่มต้น: "none"- ระบุประเภทรายงานความครอบคลุมแบบสะสมที่ต้องการ ขณะนี้รองรับเฉพาะ LCOV
--[no]compile_one_dependency
ค่าเริ่มต้น: "false"- คอมไพล์ไฟล์อาร์กิวเมนต์แบบพึ่งพาไฟล์เดียว ซึ่งมีประโยชน์ในการตรวจสอบไวยากรณ์ของไฟล์ต้นทางใน IDE เช่น การสร้างเป้าหมายรายการเดียวขึ้นใหม่ซึ่งขึ้นอยู่กับไฟล์ต้นทางเพื่อตรวจหาข้อผิดพลาดได้เร็วที่สุดเท่าที่จะทำได้ในวงจรแก้ไข/สร้าง/ทดสอบ อาร์กิวเมนต์นี้ส่งผลต่อวิธีการตีความอาร์กิวเมนต์แบบไม่แจ้งทั้งหมด แทนที่จะเป็นเป้าหมายในการสร้างเป็นชื่อไฟล์ต้นทาง ระบบจะสร้างเป้าหมายที่กำหนดเองซึ่งขึ้นอยู่กับชื่อไฟล์ต้นฉบับแต่ละรายการ
--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>
default: ดูคำอธิบาย- บันทึกการเรียกใช้ที่ดำเนินการแล้วลงในไฟล์นี้เป็นโปรโตคอล SpawnExec ที่แบ่งความยาวตาม src/main/protobuf/spawn.proto โปรดใช้ --execution_log_compact_file ซึ่งไฟล์มีขนาดเล็กกว่าและประหยัดค่าใช้จ่ายในการจัดทำได้อย่างมาก Flag ที่เกี่ยวข้อง: --execution_log_compact_file (รูปแบบกะทัดรัด; ใช้ร่วมกันไม่ได้), --execution_log_json_file (รูปแบบ JSON ที่เป็นข้อความ; ใช้ร่วมกันไม่ได้), --execution_log_sort (จัดเรียงบันทึกการดำเนินการหรือไม่), --subcommands (สำหรับแสดงคำสั่งย่อยในเอาต์พุตของเทอร์มินัล)
--execution_log_compact_file=<a path>
default: ดูคำอธิบาย- บันทึกการเริ่มที่ดำเนินการแล้วลงในไฟล์นี้เป็นโปรโตคอล ExecLogEntry ที่จำกัดความยาวตาม src/main/protobuf/spawn.proto ไฟล์ทั้งหมดได้รับการบีบอัด zstd Flag ที่เกี่ยวข้อง: --execution_log_binary_file (รูปแบบไบนารี protobuf; ใช้ร่วมกันไม่ได้), --execution_log_json_file (รูปแบบข้อความ JSON; ใช้ร่วมกันไม่ได้), --subcommands (สำหรับแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
--execution_log_json_file=<a path>
default: ดูคำอธิบาย- บันทึกการเริ่มที่ดำเนินการแล้วลงในไฟล์นี้เป็นการแสดงโปรโตคอล SpawnExec ในรูปแบบ JSON ที่คั่นด้วยการขึ้นบรรทัดใหม่ตาม src/main/protobuf/spawn.proto เลือกใช้ --execution_log_compact_file ซึ่งมีขนาดเล็กกว่ามากและต้นทุนในการผลิตถูกกว่า Flag ที่เกี่ยวข้อง: --execution_log_compact_file (รูปแบบกะทัดรัด; ใช้ร่วมกันไม่ได้), --execution_log_binary_file (รูปแบบ protobuf แบบไบนารี; ใช้ร่วมกันไม่ได้), --execution_log_sort (จัดเรียงบันทึกการดำเนินการหรือไม่), --subcommands (สำหรับแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
--[no]execution_log_sort
ค่าเริ่มต้น: "true"- เลือกว่าจะจัดเรียงบันทึกการดำเนินการหรือไม่ ซึ่งจะช่วยให้เปรียบเทียบบันทึกระหว่างการเรียกใช้ได้ง่ายขึ้น ตั้งค่าเป็นเท็จเพื่อหลีกเลี่ยงการใช้งาน CPU และหน่วยความจําที่อาจเกิดขึ้นเมื่อการเรียกใช้สิ้นสุดลง แต่จะต้องเสียค่าใช้จ่ายในการสร้างบันทึกในลําดับการดําเนินการที่ไม่ใช่แบบกำหนดได้ มีผลกับรูปแบบไบนารีและ JSON เท่านั้น ระบบจะไม่จัดเรียงรูปแบบกะทัดรัด
--[no]expand_test_suites
ค่าเริ่มต้น: "true"-
ขยายเป้าหมาย test_suite ไปยังการทดสอบส่วนประกอบก่อนการวิเคราะห์ เมื่อเปิดใช้ Flag นี้ (ค่าเริ่มต้น) รูปแบบเป้าหมายเชิงลบจะมีผลกับทดสอบที่อยู่ในชุดทดสอบ มิเช่นนั้นจะไม่มีผล การปิดใช้ Flag นี้จะมีประโยชน์เมื่อใช้แง่มุมระดับบนสุดในบรรทัดคำสั่ง จากนั้นระบบจะวิเคราะห์เป้าหมาย test_suite ได้
แท็ก:loading_and_analysis
--experimental_disk_cache_gc_idle_delay=<An immutable length of time.>
ค่าเริ่มต้น: "5m"- ระยะเวลาที่เซิร์ฟเวอร์ต้องไม่มีการใช้งานก่อนที่ระบบจะรวบรวมขยะในแคชดิสก์ หากต้องการระบุนโยบายการเก็บขยะ ให้ตั้งค่า --experimental_disk_cache_gc_max_size และ/หรือ --experimental_disk_cache_gc_max_age
- ค่าเริ่มต้นของ
--experimental_disk_cache_gc_max_age=<An immutable length of time.>
: "0" - หากตั้งเป็นค่าบวก ดิสก์แคชจะรวบรวมข้อมูลขยะเป็นระยะๆ เพื่อลบรายการที่มีอายุมากกว่าอายุนี้ หากตั้งค่าร่วมกับ --experimental_disk_cache_gc_max_size ระบบจะใช้ทั้ง 2 เกณฑ์ เกิดการเก็บข้อมูลขยะในพื้นหลังเมื่อเซิร์ฟเวอร์ไม่มีการใช้งาน ตามที่กำหนดโดยค่าสถานะ --experimental_disk_cache_gc_idle_delay
- ค่าเริ่มต้นของ
--experimental_disk_cache_gc_max_size=<a size in bytes, optionally followed by a K, M, G or T multiplier>
: "0" - หากตั้งเป็นค่าบวก ดิสก์แคชจะรวบรวมขยะเป็นระยะๆ เพื่อให้มีขนาดไม่เกินนี้ หากตั้งค่าร่วมกับ --experimental_disk_cache_gc_max_age ระบบจะใช้ทั้ง 2 เกณฑ์ การรวบรวมขยะจะเกิดขึ้นในเบื้องหลังเมื่อเซิร์ฟเวอร์ไม่มีการใช้งานตามที่กำหนดโดย Flag --experimental_disk_cache_gc_idle_delay
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
ค่าเริ่มต้น: ""- เลิกใช้งานแล้วเพื่อใช้ "แง่มุม" แทน ชุดตัวกรองเป้าหมายเพื่อตั้งเวลา extra_actions
--[no]experimental_extra_action_top_level_only
ค่าเริ่มต้น: "false"- เลิกใช้งานไปทีละด้าน ตั้งเวลาให้เฉพาะการดำเนินการเพิ่มเติมสำหรับเป้าหมายระดับบนสุดเท่านั้น
--experimental_spawn_scheduler
-
เปิดใช้การดำเนินการแบบไดนามิกโดยเรียกใช้การดำเนินการพร้อมกันทั้งแบบในเครื่องและจากระยะไกล Bazel จะสร้างการดำเนินการแต่ละรายการในเครื่องและจากระยะไกล แล้วเลือกการดำเนินการที่เสร็จสมบูรณ์ก่อน หากการดำเนินการรองรับผู้ปฏิบัติงาน การดำเนินการเฉพาะเครื่องจะทำงานในโหมดผู้ปฏิบัติงานถาวร หากต้องการเปิดใช้การดำเนินการแบบไดนามิกสำหรับหน่วยความจำการดำเนินการแต่ละรายการ ให้ใช้แฟล็ก "--internal_spawn_scheduler" และ "--strategy=<mnemonic>=dynamic" แทน
ขยายเป็น
--internal_spawn_scheduler
--spawn_strategy=dynamic
--[no]fetch
ค่าเริ่มต้น: "true"- อนุญาตให้คําสั่งดึงข้อมูลการอ้างอิงภายนอก หากตั้งค่าเป็นเท็จ คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ หากไม่มี คำสั่งจะดำเนินการไม่สำเร็จ
--[no]incompatible_dont_use_javasourceinfoprovider
ค่าเริ่มต้น: "false"-
No-op
แท็ก:incompatible_change
--local_termination_grace_seconds=<an integer>
ค่าเริ่มต้น: "15"- เวลารอระหว่างการสิ้นสุดกระบวนการในเครื่องเนื่องจากหมดเวลากับการปิดกระบวนการนั้นโดยบังคับ
--override_repository=<an equals-separated mapping of repository name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างที่เก็บโดยใช้เส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้าออก
- ค่าเริ่มต้นของ
--package_path=<colon-separated list of options>
: "%workspace%" - รายการค้นหาแพ็กเกจที่คั่นด้วยโคลอน องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับพื้นที่ทำงานที่ล้อมรอบอยู่ หากละเว้นหรือว่างเปล่า ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
--[no]show_loading_progress
ค่าเริ่มต้น: "true"- หากเปิดใช้จะทำให้ Bazel พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ:"
- ค่าเริ่มต้น
--test_lang_filters=<comma-separated list of options>
: "" - ระบุรายการภาษาทดสอบที่คั่นด้วยคอมมา คุณใส่เครื่องหมาย "-" ไว้หน้าแต่ละภาษาเพื่อระบุภาษาที่ยกเว้นได้ ระบบจะพบเฉพาะเป้าหมายทดสอบเหล่านั้นที่ใช้ภาษาที่ระบุ ชื่อที่ใช้สำหรับแต่ละภาษาควรเหมือนกับคำนำหน้าภาษาในกฎ *_test เช่น "cc", "java", "py" เป็นต้น ตัวเลือกนี้จะส่งผลต่อลักษณะการทํางานของ --build_tests_only และคำสั่งทดสอบ
- ค่าเริ่มต้นของ
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
: "" - ระบุรายการขนาดการทดสอบที่คั่นด้วยคอมมา แต่ละขนาดจะมีเครื่องหมาย "-" นำหน้าเพื่อระบุขนาดที่ยกเว้น ระบบจะค้นหาเฉพาะเป้าหมายการทดสอบที่มีขนาดที่รวมไว้อย่างน้อย 1 ขนาดและไม่มีขนาดที่ยกเว้น ตัวเลือกนี้จะส่งผลต่อลักษณะการทํางานของ --build_tests_only และคำสั่งทดสอบ
- ค่าเริ่มต้นของ
--test_tag_filters=<comma-separated list of options>
: "" - ระบุรายการแท็กทดสอบที่คั่นด้วยคอมมา แต่ละแท็กสามารถใส่เครื่องหมาย "-" ไว้ข้างหน้าได้เพื่อระบุแท็กที่ยกเว้น ระบบจะค้นหาเฉพาะเป้าหมายการทดสอบที่มีแท็กที่รวมไว้อย่างน้อย 1 แท็กและไม่มีแท็กที่ยกเว้น ตัวเลือกนี้จะส่งผลต่อลักษณะการทํางานของ --build_tests_only และคำสั่งทดสอบ
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
ค่าเริ่มต้น: ""- ระบุรายการการหมดเวลาการทดสอบที่คั่นด้วยคอมมา คุณใส่เครื่องหมาย "-" ไว้หน้าการหมดเวลาแต่ละรายการเพื่อระบุการหมดเวลาที่ยกเว้นได้ ระบบจะพบเฉพาะเป้าหมายทดสอบเหล่านั้นที่มีระยะหมดเวลาอย่างน้อย 1 รายการและไม่มีระยะหมดเวลาที่ยกเว้น ตัวเลือกนี้จะส่งผลต่อลักษณะการทํางานของ --build_tests_only และคำสั่งทดสอบ
--workspace_status_command=<path>
ค่าเริ่มต้น: ""- คําสั่งที่เรียกใช้ในช่วงเริ่มต้นของการสร้างเพื่อระบุข้อมูลสถานะเกี่ยวกับพื้นที่ทํางานในรูปแบบคู่คีย์/ค่า ดูข้อกำหนดฉบับเต็มได้ในคู่มือผู้ใช้ นอกจากนี้ โปรดดูเครื่องมือ/buildstamp/get_workspace_status เป็นต้น
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์มีดังนี้
- ค่าเริ่มต้น
--[no]check_up_to_date
: "เท็จ" -
อย่าดำเนินการสร้าง เพียงตรวจสอบว่าเป็นเวอร์ชันล่าสุดหรือไม่ หากเป้าหมายทั้งหมดเป็นเวอร์ชันล่าสุดแล้ว การสร้างจะเสร็จสมบูรณ์ หากต้องดำเนินการขั้นตอนใด ระบบจะรายงานข้อผิดพลาดและบิลด์จะไม่สำเร็จ
แท็ก:execution
--[no]experimental_inprocess_symlink_creation
ค่าเริ่มต้น: "false"-
Whether to make direct file system calls to create symlink trees
Tags:loading_and_analysis
,execution
,experimental
--[no]experimental_persistent_aar_extractor
ค่าเริ่มต้น: "false"-
เปิดใช้เครื่องมือแยก Aar แบบถาวรโดยใช้เวิร์กเกอร์
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_remotable_source_manifests
: "เท็จ" -
กำหนดให้ดำเนินการในไฟล์ Manifest ของแหล่งที่มาจากระยะไกลได้หรือไม่
แท็ก:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" Bazel จะเรียกใช้การประมวลผลผลลัพธ์ของการทดสอบในกระบวนการใหม่
แท็ก:execution
--[no]experimental_split_xml_generation
ค่าเริ่มต้น: "true"-
หากตั้งค่า Flag นี้ไว้ และการดำเนินการทดสอบไม่ได้สร้างไฟล์ test.xml ขึ้นมา Bazel จะใช้การดำเนินการแยกต่างหากเพื่อสร้างไฟล์ test.xml จําลองที่มีบันทึกการทดสอบ มิฉะนั้น Bazel จะสร้าง test.xml เป็นส่วนหนึ่งของการดำเนินการทดสอบ
แท็ก:execution
--[no]experimental_strict_fileset_output
ค่าเริ่มต้น: "false"-
หากเปิดใช้ตัวเลือกนี้ ไฟล์ชุดจะถือว่าอาร์ติแฟกต์เอาต์พุตทั้งหมดเป็นไฟล์ปกติ จะไม่ไปยังไดเรกทอรีต่างๆ หรือสนใจเกี่ยวกับสัญลักษณ์ลิงก์
แท็ก:execution
--[no]experimental_use_semaphore_for_jobs
ค่าเริ่มต้น: "true"-
หากตั้งค่าเป็น "จริง" ให้ใช้สัญลักษณ์ชั่วคราวเพื่อจำกัดจำนวนงานที่เกิดขึ้นพร้อมกัน
แท็ก:host_machine_resource_optimizations
,execution
--genrule_strategy=<comma-separated list of options>
ค่าเริ่มต้น: ""-
ระบุวิธีเรียกใช้ genrules การแจ้งว่าไม่เหมาะสมนี้จะถูกนำออก แต่ให้ใช้ --spawn_strategy=<value> เพื่อควบคุมการดำเนินการทั้งหมด หรือ --strategy=Genrule=<value> เพื่อควบคุม Genrule เท่านั้น
แท็ก:execution
--[no]incompatible_disallow_unsound_directory_outputs
ค่าเริ่มต้น: "true"-
หากตั้งค่าไว้ ระบบจะแสดงข้อผิดพลาดเมื่อดำเนินการสร้างไฟล์เอาต์พุตเป็นไดเรกทอรี ไม่มีผลต่อไดเรกทอรีต้นทาง ดู https://github.com/bazelbuild/bazel/issues/18646
แท็ก:bazel_internal_configuration
,incompatible_change
--[no]incompatible_modify_execution_info_additive
ค่าเริ่มต้น: "false"-
เมื่อเปิดใช้ การส่ง Flag --modify_execution_info หลายรายการจะเป็นการเพิ่ม เมื่อปิดใช้ ระบบจะพิจารณาเฉพาะธงล่าสุดเท่านั้น
แท็ก:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] ค่าเริ่มต้น: "อัตโนมัติ"-
จำนวนงานที่ทำงานพร้อมกัน ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") โดยจะเลือกตามด้วยการดำเนินการ ([-|*]<Float>) เช่น "auto", "HOST_CPUS*.5" ค่าต้องอยู่ระหว่าง 1 ถึง 5,000 ค่าที่มากกว่า 2,500 อาจทำให้เกิดปัญหาเกี่ยวกับหน่วยความจํา "auto" จะคำนวณค่าเริ่มต้นที่เหมาะสมตามทรัพยากรของโฮสต์
แท็ก:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] default: "false"-
ดำเนินการต่อให้มากที่สุดหลังจากเกิดข้อผิดพลาด แม้ว่าจะวิเคราะห์เป้าหมายที่ไม่สําเร็จและเป้าหมายที่ขึ้นอยู่กับเป้าหมายนั้นไม่ได้ แต่ระบบจะวิเคราะห์ข้อกําหนดเบื้องต้นอื่นๆ ของเป้าหมายเหล่านี้ได้
แท็ก:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
ค่าเริ่มต้น: "auto"-
จํานวนเธรดแบบขนานที่จะใช้สําหรับระยะการโหลด/การวิเคราะห์ ใช้จํานวนเต็มหรือคีย์เวิร์ด ("auto", "HOST_CPUS", "HOST_RAM") ตามด้วยการดำเนินการ ([-|*]<float>) ตามต้องการ เช่น "auto", "HOST_CPUS*.5" "auto" จะตั้งค่าเริ่มต้นที่เหมาะสมตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก:bazel_internal_configuration
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
เพิ่มหรือนําคีย์ออกจากข้อมูลการดําเนินการของการดำเนินการตามคําช่วยจําของการดำเนินการ ใช้กับการดำเนินการที่รองรับข้อมูลการดำเนินการเท่านั้น การดำเนินการทั่วไปหลายรายการรองรับข้อมูลการดำเนินการ เช่น Genrule, CppCompile, Javac, StarlarkAction, TestRunner เมื่อระบุหลายค่า ลําดับจะมีความสำคัญเนื่องจากนิพจน์ทั่วไปหลายรายการอาจใช้กับคําช่วยจําเดียวกัน
ไวยากรณ์: "regex=[+-]key,regex=[+-]key,..."
ตัวอย่างเช่น ".*=+x,.*=-y,.*=+z" เพิ่ม "x" และ "z" และนำ "y" ออกจากข้อมูลการดำเนินการสำหรับการดำเนินการทั้งหมด
"Genrule=+requires-x" จะเพิ่ม "requires-x" ลงในข้อมูลการดําเนินการสําหรับการดําเนินการ Genrule ทั้งหมด
"(?!Genrule).*=-requires-x" จะนำ "requires-x" ออกจากข้อมูลการดำเนินการสำหรับการดำเนินการที่ไม่ใช่ Genrule ทั้งหมด
แท็ก:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
เปิดใช้การดำเนินการ Desugar และ Dex ของ Android แบบถาวรโดยใช้ Executor
ขยายเป็น
--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
-
เปิดใช้การดำเนินการ Desugar และ Dex ของ 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, De หากไม่ต้องการ, การประมวลผลทรัพยากร)
ขยายเป็น
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
แท็ก:host_machine_resource_optimizations
,execution
--[no]skip_incompatible_explicit_targets
ค่าเริ่มต้น: "false"-
ข้ามเป้าหมายที่เข้ากันไม่ได้ซึ่งระบุไว้ในบรรทัดคำสั่งอย่างชัดเจน โดยค่าเริ่มต้น การสร้างเป้าหมายดังกล่าวจะทำให้เกิดข้อผิดพลาด แต่ระบบจะข้ามเป้าหมายดังกล่าวโดยอัตโนมัติเมื่อเปิดใช้ตัวเลือกนี้ ดูที่ 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" Flag นี้จะลบล้างค่าที่กําหนดโดย --spawn_strategy (และ --genrule_strategy หากใช้กับ Genrule ที่เป็นคําช่วยจํา) ดูรายละเอียดได้ที่ https://blog.bazel.build/2019/06/19/list-strategy.html
แท็ก:execution
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ลบล้างกลยุทธ์การสร้างที่สร้างขึ้นเพื่อเรียกใช้การดำเนินการที่สร้างขึ้นซึ่งมีคำอธิบายตรงกับ regex_filter บางรายการ ดู --per_file_copt สำหรับรายละเอียดการจับคู่เกี่ยวกับนิพจน์ทั่วไป ระบบจะใช้ regex_filter รายการล่าสุดที่ตรงกับคำอธิบาย ตัวเลือกนี้จะลบล้าง Flag อื่นๆ สำหรับการระบุกลยุทธ์ ตัวอย่าง: --strategy_regexp=//foo.*\.cc,-//foo/bar=local หมายถึงการเรียกใช้การดำเนินการโดยใช้กลยุทธ์ท้องถิ่นหากคำอธิบายตรงกับ //foo.*.cc แต่ไม่ตรงกับ //foo/bar ตัวอย่างเช่น --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed จะเรียกใช้ "Compiling //foo/bar/baz" ด้วยกลยุทธ์ "local" แต่การกลับลําดับจะเรียกใช้ด้วย "sandboxed"
แท็ก:execution
--[no]use_target_platform_for_tests
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะใช้แพลตฟอร์มเป้าหมายในการเรียกใช้การทดสอบแทนกลุ่ม exec ทดสอบ
แท็ก:execution
- ตัวเลือกในการกำหนดค่า Toolchain ที่ใช้สำหรับการดำเนินการมีดังนี้
--android_compiler=<a string>
default: ดูคำอธิบาย-
คอมไพเลอร์เป้าหมาย Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
ค่าเริ่มต้น: "//external:android/crosstool"-
ตำแหน่งคอมไพเลอร์ C++ ที่ใช้สำหรับบิลด์ Android
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
default: ดูคำอธิบาย-
เป้าหมาย grte_top ของ Android
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
ค่าเริ่มต้น: "android"-
เลือกเครื่องมือผสานไฟล์ Manifest ที่จะใช้กับกฎ android_binary แจ้งเพื่อช่วยให้เปลี่ยนไปใช้การผสานรวมไฟล์ Manifest ของ Android จากการควบรวมเดิม
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
ค่าเริ่มต้น: ""-
กำหนดแพลตฟอร์มที่เป้าหมาย android_binary ใช้ หากระบุหลายแพลตฟอร์ม ไฟล์ไบนารีจะเป็น APK แบบรวมซึ่งมีไบนารีเนทีฟสำหรับแพลตฟอร์มเป้าหมายแต่ละรายการที่ระบุ
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/android:sdk"-
ระบุ Android SDK/แพลตฟอร์มที่ใช้สร้างแอปพลิเคชัน Android
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้ในกฎของ Apple และ Objc รวมถึงการพึ่งพา
แท็ก:loses_incremental_state
,changes_inputs
- ค่าเริ่มต้นของ
--cc_output_directory_tag=<a string>
: "" -
ระบุส่วนต่อท้ายที่จะเพิ่มลงในไดเรกทอรีการกําหนดค่า
แท็ก:affects_outputs
--compiler=<a string>
default: ดูคำอธิบาย-
คอมไพเลอร์ C++ ที่จะใช้ในการคอมไพล์เป้าหมาย
แท็ก:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:lcov_merger"-
ตำแหน่งของไบนารีที่ใช้ประมวลผลรายงานการครอบคลุมแบบดิบในขั้นตอนหลัง ซึ่งปัจจุบันต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งเป็นไฟล์ไบนารี ค่าเริ่มต้นคือ "//tools/test:lcov_merger"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_report_generator"-
ตำแหน่งของไบนารีที่ใช้สร้างรายงานการครอบคลุม ซึ่งปัจจุบันต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งเป็นไฟล์ไบนารี ค่าเริ่มต้นคือ "//tools/test:coverage_report_generator"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_support"-
ตำแหน่งของไฟล์สนับสนุนที่จําเป็นในอินพุตของการดำเนินการทดสอบทุกครั้งที่รวบรวมการครอบคลุมโค้ด ค่าเริ่มต้นคือ "//tools/test:coverage_support"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้ในการคอมไพล์โค้ด C++
แท็ก:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
default: ดูคำอธิบาย-
ระบุการใช้งาน 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
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ให้เพิ่มข้อกำหนดการเรียกใช้ "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 คุณสามารถระบุ Toolchain ตามเป้าหมายที่ตรงกันทั้งหมด หรือเป็นรูปแบบเป้าหมายก็ได้ ระบบจะพิจารณา Toolchain เหล่านี้ก่อน Toolchain ที่ประกาศไว้ในไฟล์ WORKSPACE โดย register_toolchains()
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
default: ดูคำอธิบาย-
ป้ายกำกับสำหรับไลบรารี libc ที่เช็คอินแล้ว เครื่องมือทํางานแบบข้ามแพลตฟอร์มจะเลือกค่าเริ่มต้น และคุณแทบไม่จําเป็นต้องลบล้างค่าดังกล่าว
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้น
--host_compiler=<a string>
: ดูคำอธิบาย -
คอมไพเลอร์ C++ ที่จะใช้ในการคอมไพล์โฮสต์ ระบบจะไม่สนใจหากไม่ได้ตั้งค่า --host_crosstool_top
แท็ก:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
default: ดูคำอธิบาย-
โดยค่าเริ่มต้น ระบบจะใช้ตัวเลือก --crosstool_top และ --compiler สำหรับการกําหนดค่า exec ด้วย หากมีการแฟล็กนี้ Bazel จะใช้ libc และคอมไพเลอร์เริ่มต้นสำหรับ Crosstool_top ที่ระบุ
แท็ก:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
default: ดูคำอธิบาย-
หากระบุไว้ การตั้งค่านี้จะลบล้างไดเรกทอรีระดับบนสุดของ libc (--grte_top) สําหรับการกําหนดค่า exec
แท็ก:action_command_lines
,affects_outputs
--host_platform=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools:host_platform"-
ป้ายกํากับของกฎแพลตฟอร์มที่อธิบายระบบโฮสต์
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" Bazel จะไม่เปิดใช้ฟีเจอร์ "โฮสต์" และ "ไม่ใช่โฮสต์" ในชุดเครื่องมือ C++ (ดูข้อมูลเพิ่มเติมที่ https://github.com/bazelbuild/bazel/issues/7407)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_enable_android_toolchain_resolution
: "true" -
ใช้การแก้ไข Toolchain เพื่อเลือก Android SDK สําหรับกฎ Android (Starlark และแบบดั้งเดิม)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
ค่าเริ่มต้น: "false"-
ใช้การแก้ไขเครื่องมือเพื่อเลือก Apple SDK สําหรับกฎของ Apple (Starlark และแบบดั้งเดิม)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_make_thinlto_command_lines_standalone
: "จริง" -
หากเป็น "จริง" Bazel จะไม่นําบรรทัดคําสั่งการดําเนินการลิงก์ C++ มาใช้ซ้ำสําหรับบรรทัดคําสั่งการจัดทําดัชนี lto (ดูข้อมูลเพิ่มเติมที่ https://github.com/bazelbuild/bazel/issues/6791)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
ค่าเริ่มต้น: "true"-
โดยค่าเริ่มต้น Bazel จะไม่ลิงก์ทรัพยากร Dependency ของไลบรารีเป็นที่เก็บถาวรทั้งหมด (ดูวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/7362)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_require_ctx_in_configure_features
: "จริง" -
หากเป็น "จริง" Bazel จะกำหนดให้ต้องมีพารามิเตอร์ "ctx" ใน cc_common.configure_features (ดูข้อมูลเพิ่มเติมที่ https://github.com/bazelbuild/bazel/issues/7793)
แท็ก:loading_and_analysis
,incompatible_change
-
ใช้ออบเจ็กต์ที่แชร์ของอินเทอร์เฟซหากเครื่องมือทางเทคนิครองรับ เครื่องมือเชน ELF ทั้งหมดรองรับการตั้งค่านี้ในขณะนี้
แท็ก:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: ดูคำอธิบาย-
ระบุเวอร์ชันของ iOS SDK ที่จะใช้สร้างแอปพลิเคชัน iOS หากไม่ระบุ ระบบจะใช้เวอร์ชันเริ่มต้นของ iOS SDK จาก "xcode_version"
แท็ก:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: ดูคำอธิบาย-
ระบุเวอร์ชันของ 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>
ค่าเริ่มต้น: ""-
ตำแหน่งของไฟล์การแมปที่อธิบายว่าควรใช้แพลตฟอร์มใดหากไม่ได้ตั้งค่าไว้ หรือควรตั้งค่า Flag ใดเมื่อมีแพลตฟอร์มอยู่แล้ว ต้องสัมพัทธ์กับรูทของพื้นที่ทำงานหลัก ค่าเริ่มต้นคือ "platform_mappings" (ไฟล์ที่อยู่ใต้รูทของพื้นที่ทํางานโดยตรง)
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
ค่าเริ่มต้น: ""-
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายแพลตฟอร์มเป้าหมายสำหรับคำสั่งปัจจุบัน
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--python2_path=<a string>
: ดูคำอธิบาย -
เลิกใช้งาน ไม่ดำเนินการ ปิดใช้โดย "--incompatible_use_python_toolchains"
แท็ก:no_op
,deprecated
--python3_path=<a string>
default: ดูคำอธิบาย-
เลิกใช้งานแล้ว ใช้งานไม่ได้ ปิดใช้โดย `--incompatible_use_python_toolchains`
แท็ก:no_op
,deprecated
--python_path=<a string>
default: ดูคำอธิบาย-
เส้นทางสัมบูรณ์ของล่าม 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')>
default: ดูคำอธิบาย-
ระบุเวอร์ชันของ 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>
default: ดูคำอธิบาย-
หากระบุไว้ จะใช้ 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
ค่าเริ่มต้น: "false"-
สร้างไฟล์สัญลักษณ์สำหรับแก้ไขข้อบกพร่อง (.dSYM) หรือไม่
แท็ก:affects_outputs
,action_command_lines
- ค่าเริ่มต้น
--[no]build
: "จริง" -
ดำเนินการสร้าง ซึ่งเป็นลักษณะการทำงานปกติ การระบุ --nobuild จะทำให้บิลด์หยุดทำงานก่อนที่จะดำเนินการของบิลด์ ซึ่งแสดงผลเป็น 0 หากขั้นตอนการโหลดแพ็กเกจและการวิเคราะห์เสร็จสมบูรณ์แล้ว โหมดนี้มีประโยชน์สำหรับการทดสอบเฟสเหล่านั้น
แท็ก:execution
,affects_outputs
--[no]build_runfile_links
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ระบบจะสร้างป่าซิงค์ลิงไฟล์รันไทม์สำหรับเป้าหมายทั้งหมด หากเป็นเท็จ ระบบจะเขียนเฉพาะในกรณีที่การดำเนินการในเครื่อง ทดสอบ หรือเรียกใช้คำสั่งจำเป็นต้องใช้
แท็ก:affects_outputs
--[no]build_runfile_manifests
ค่าเริ่มต้น: "true"-
หากเป็นจริง ระบบจะเขียนไฟล์ Manifest ของไฟล์รันไทม์สำหรับเป้าหมายทั้งหมด หากเป็นเท็จ ให้ละเว้น การทดสอบในเครื่องจะทํางานไม่ได้หากเป็นเท็จ
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]build_test_dwp
: "เท็จ" -
หากเปิดใช้ เมื่อสร้างการทดสอบ C++ แบบคงที่และด้วย Fission ระบบจะสร้างไฟล์ .dwp สำหรับไบนารีทดสอบโดยอัตโนมัติด้วย
แท็ก:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
ค่าเริ่มต้น: ".pb.h"-
ตั้งค่าคำต่อท้ายของไฟล์ส่วนหัวที่ cc_protocol_library สร้างขึ้น
แท็ก:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
ค่าเริ่มต้น: ".pb.cc"-
ตั้งค่าส่วนต่อท้ายของไฟล์ต้นฉบับที่ cc_proto_library สร้าง
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
ค่าเริ่มต้น: "false"-
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันอื่นใน proto_library
แท็ก:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
ค่าเริ่มต้น: "false"-
เรียกใช้การดำเนินการเพิ่มเติมสำหรับเวอร์ชัน Java API อื่นใน proto_library
แท็ก:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
ค่าเริ่มต้น: "false"-
บันทึกสถานะของฟีเจอร์ที่เปิดใช้และที่ขอไว้เป็นเอาต์พุตของการคอมไพล์
แท็ก:affects_outputs
,experimental
--[no]experimental_use_validation_aspect
ค่าเริ่มต้น: "false"-
กำหนดว่าจะเรียกใช้การตรวจสอบโดยใช้มุมมอง (สำหรับการดำเนินการพร้อมกันกับการทดสอบ) หรือไม่
แท็ก:execution
,affects_outputs
--fission=<a set of compilation modes>
ค่าเริ่มต้น: "no"-
ระบุโหมดการคอมไพล์ที่ใช้ Fission สําหรับการคอมไพล์และการลิงก์ C++ อาจเป็นชุดค่าผสมใดๆ ระหว่าง {'fastbuild', 'dbg', 'opt'} หรือค่าพิเศษ 'yes' เพื่อเปิดใช้งานทุกโหมด และ 'no' เพื่อปิดใช้งานทุกโหมด
แท็ก:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
ค่าเริ่มต้น: "true"-
หากเป็นจริง กฎแบบเนทีฟจะเพิ่ม <code>DefaultInfo.files</code> ของทรัพยากร Dependency ของข้อมูลลงในไฟล์การเรียกใช้ ซึ่งตรงกับลักษณะการทำงานที่แนะนำสำหรับกฎของ Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid)
แท็ก:affects_outputs
,incompatible_change
- ค่าเริ่มต้น
--[no]legacy_external_runfiles
: "true" -
หากเป็น "จริง" ระบบจะสร้างป่าซิงค์ลิงก์ของไฟล์รันไทม์สำหรับที่เก็บข้อมูลภายนอกในส่วน .runfiles/wsname/external/repo (นอกเหนือจาก .runfiles/repo)
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]objc_generate_linkmap
: "เท็จ" -
ระบุว่าจะสร้างไฟล์ Linkmap หรือไม่
แท็ก:affects_outputs
--output_groups=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
รายการชื่อกลุ่มเอาต์พุตที่คั่นด้วยคอมมา โดยแต่ละชื่อจะมีเครื่องหมาย + หรือ - นำหน้าก็ได้ ระบบจะเพิ่มกลุ่มที่มีเครื่องหมาย + นำหน้าไปยังชุดกลุ่มเอาต์พุตเริ่มต้น ส่วนกลุ่มที่มีเครื่องหมาย - นำหน้าจะถูกนำออกจากชุดเริ่มต้น หากมีอย่างน้อย 1 กลุ่มที่ไม่มีคำนำหน้า ระบบจะละเว้นชุดกลุ่มเอาต์พุตเริ่มต้น เช่น --output_groups=+foo,+bar จะสร้างยูเนียนของชุดค่าเริ่มต้น foo และ bar ส่วน --output_groups=foo,bar จะลบล้างชุดค่าเริ่มต้นเพื่อให้ระบบสร้างเฉพาะ foo และ bar
แท็ก:execution
,affects_outputs
--[no]run_validations
ค่าเริ่มต้น: "true"-
ระบุว่าจะเรียกใช้การดำเนินการตรวจสอบในฐานะส่วนหนึ่งของบิลด์หรือไม่ ดู https://bazel.build/extending/rules#validation_actions
แท็ก:execution
,affects_outputs
--[no]save_temps
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ระบบจะบันทึกเอาต์พุตชั่วคราวจาก gcc ซึ่งรวมถึงไฟล์ .s (โค้ดแอสเซมเบลอร์), ไฟล์ .i (C ที่ผ่านการปรับแต่งล่วงหน้า) และไฟล์ .ii (C++ ที่ผ่านการปรับแต่งล่วงหน้า)
แท็ก:affects_outputs
- ตัวเลือกที่อนุญาตให้ผู้ใช้กําหนดค่าเอาต์พุตที่ต้องการ ซึ่งส่งผลต่อค่าของเอาต์พุต ไม่ใช่การมีอยู่ของเอาต์พุต
--action_env=<a 'name=value' assignment with an optional value part>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดําเนินการที่มีการกำหนดค่าเป้าหมาย ตัวแปรสามารถระบุโดยใช้ชื่อ ซึ่งในกรณีนี้ระบบจะนำค่ามาจากสภาพแวดล้อมการเรียกใช้ หรือระบุโดยใช้คู่ชื่อ=ค่า ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ คุณใช้ตัวเลือกนี้ได้หลายครั้ง ตัวเลือกสําหรับตัวแปรเดียวกันจะเลือกตัวเลือกล่าสุด ส่วนตัวเลือกสําหรับตัวแปรต่างๆ จะรวมกัน
แท็ก:action_command_lines
--android_cpu=<a string>
ค่าเริ่มต้น: "armeabi-v7a"-
CPU เป้าหมายของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
ค่าเริ่มต้น: "true"-
สร้างไฟล์การเชื่อมโยงข้อมูลที่ใช้กับ AndroidX ได้ ใช้ได้เฉพาะกับการเชื่อมโยงข้อมูล v2 เท่านั้น Flag นี้ไม่มีผลใดๆ
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
ค่าเริ่มต้น: "true"-
ใช้ Android Databinding v2 ที่มีอาร์กิวเมนต์ 3.4.0 Flag นี้ไม่มีผลใดๆ
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้นของ
--android_dynamic_mode=<off, default or fully>
: "off" -
กำหนดว่าจะลิงก์ส่วน C++ ของกฎ Android แบบไดนามิกหรือไม่ เมื่อ cc_binary ไม่ได้สร้างไลบรารีที่ใช้ร่วมกันอย่างชัดแจ้ง "default" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "โดยสมบูรณ์" หมายความว่าไลบรารีทั้งหมดจะมีการเชื่อมโยงแบบไดนามิก "ปิด" หมายความว่าระบบจะลิงก์คลังทั้งหมดในโหมดคงที่ส่วนใหญ่
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "ตามตัวอักษร" -
กำหนดลําดับของไฟล์ Manifest ที่ส่งไปยังเครื่องมือผสานไฟล์ Manifest สําหรับไบนารีของ Android ALPHABETICAL หมายความว่าไฟล์ Manifest จะจัดเรียงตามเส้นทางที่สัมพันธ์กับ execroot ALPHABETICAL_BY_CONFIGURATION หมายความว่าไฟล์ Manifest จะจัดเรียงตามเส้นทางที่สัมพันธ์กับไดเรกทอรีการกําหนดค่าภายในไดเรกทอรีเอาต์พุต DEPENDENCY หมายความว่าไฟล์ Manifest จะเรียงลำดับโดยให้ไฟล์ Manifest ของแต่ละไลบรารีอยู่ก่อนไฟล์ Manifest ของไลบรารีที่ต้องพึ่งพา
แท็ก:action_command_lines
,execution
--[no]android_resource_shrinking
ค่าเริ่มต้น: "false"-
เปิดใช้การลดขนาดทรัพยากรสำหรับ APK ประเภท android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
,loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--aspects=<comma-separated list of options>
รายการ - รายการที่คั่นด้วยคอมมาของด้านที่จะใช้กับเป้าหมายระดับบนสุด ในรายการนี้ หากแอตทริบิวต์ some_aspect ระบุผู้ให้บริการแอตทริบิวต์ที่จำเป็นผ่าน required_aspect_providers ทางแอตทริบิวต์ some_aspect จะทำงานหลังจากแอตทริบิวต์ทุกรายการที่กล่าวถึงก่อนหน้าในรายการแอตทริบิวต์ซึ่งมีผู้ให้บริการที่โฆษณาตรงกับผู้ให้บริการแอตทริบิวต์ที่จำเป็นของ some_aspect นอกจากนี้ some_aspect จะทำงานหลังจากแง่มุมที่จําเป็นทั้งหมดที่ระบุโดยแอตทริบิวต์ requires แล้ว จากนั้น some_aspect จะมีสิทธิ์เข้าถึงค่าของผู้ให้บริการของแง่มุมเหล่านั้น <bzl-file-label>%<aspect_name> เช่น "//tools:my_def.bzl%my_aspect" โดยที่ "my_aspect" คือค่าระดับบนสุดจากไฟล์ tools/my_def.bzl
- ค่าเริ่มต้น
--[no]build_python_zip
: "อัตโนมัติ" -
สร้างไฟล์ ZIP ที่เรียกใช้งานได้ของ Python เปิดใน Windows ปิดในแพลตฟอร์มอื่นๆ
แท็ก:affects_outputs
--catalyst_cpus=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple Catalyst
แท็ก:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
ค่าเริ่มต้น: "false"-
หากระบุไว้ Bazel จะใส่เครื่องมือวัดโค้ด (โดยใช้เครื่องมือวัดแบบออฟไลน์หากเป็นไปได้) และจะรวบรวมข้อมูลการครอบคลุมระหว่างการทดสอบ เฉพาะเป้าหมายที่ตรงกับ --instrumentation_filter จะได้รับผลกระทบ โดยปกติแล้วไม่ควรระบุตัวเลือกนี้โดยตรง แต่ควรใช้คําสั่ง "bazel coverage" แทน
แท็ก:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] ค่าเริ่มต้น: "fastbuild"-
ระบุโหมดที่จะสร้างไบนารี ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
,action_command_lines
--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>
default: ดูคำอธิบาย-
ใช้ข้อมูลโปรไฟล์ CSFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อเส้นทางสัมบูรณ์ของไฟล์ ZIP ที่มีไฟล์โปรไฟล์ ไฟล์โปรไฟล์ LLVM ดิบ หรือไฟล์โปรไฟล์ LLVM ที่จัดทําดัชนี
แท็ก:affects_outputs
--cs_fdo_instrument=<a string>
default: ดูคำอธิบาย-
สร้างไบนารีด้วยเครื่องมือ FDO ที่คำนึงถึงบริบท เมื่อใช้คอมไพเลอร์ Clang/LLVM ระบบจะยอมรับชื่อไดเรกทอรีที่จะใช้วางไฟล์โปรไฟล์ดิบเมื่อรันไทม์ด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--cs_fdo_profile=<a build target label>
: ดูคำอธิบาย -
The cs_fdo_profile representing the context sensitive profile to be used for optimization.
แท็ก:affects_outputs
--cxxopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ซอร์ส C++
แท็ก:action_command_lines
,affects_outputs
--define=<a 'name=value' assignment>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือก --define แต่ละรายการจะระบุการกําหนดค่าสําหรับตัวแปรบิลด์
แท็ก:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
ค่าเริ่มต้น: "default"-
กำหนดว่าจะลิงก์ไบนารี C++ แบบไดนามิกหรือไม่ "default" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "ทั้งหมด" หมายความว่าระบบจะลิงก์คลังทั้งหมดแบบไดนามิก "ปิด" หมายความว่าระบบจะลิงก์คลังทั้งหมดในโหมดคงที่ส่วนใหญ่
แท็ก:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
ค่าเริ่มต้น: "true"-
หากตั้งค่าไว้ การใช้ fdo_absolute_profile_path จะทำให้เกิดข้อผิดพลาด
แท็ก:affects_outputs
--[no]enable_runfiles
ค่าเริ่มต้น: "auto"-
เปิดใช้โครงสร้าง Symlink ของไฟล์รันไทม์ โดยค่าเริ่มต้นจะปิดอยู่ใน Windows และเปิดอยู่ในแพลตฟอร์มอื่นๆ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_action_listener=<a build target label>
รายการ -
เลิกใช้งานแล้วเพื่อใช้ "แง่มุม" แทน ใช้ action_listener เพื่อแนบ extra_action กับการดำเนินการบิลด์ที่มีอยู่
แท็ก: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 Flag นี้ไม่มีผลใดๆ
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
ค่าเริ่มต้น: "false"-
เปิดใช้การย่อทรัพยากรสำหรับ APK android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
ค่าเริ่มต้น: "false"-
ใช้เครื่องมือ rex เพื่อเขียนไฟล์ dex ใหม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]experimental_collect_code_coverage_for_generated_files
: "เท็จ" -
หากระบุไว้ Bazel จะสร้างและรวบรวมข้อมูลการครอบคลุมสำหรับไฟล์ที่สร้างขึ้นด้วย
แท็ก:affects_outputs
--[no]experimental_convenience_symlinks
ค่าเริ่มต้น: "normal"-
Flag นี้จะควบคุมวิธีจัดการสัญลักษณ์ลิงก์เพื่อความสะดวก (สัญลักษณ์ลิงก์ที่ปรากฏในพื้นที่ทํางานหลังจากการบิลด์) ค่าที่เป็นไปได้ ได้แก่ ปกติ (ค่าเริ่มต้น): ระบบจะสร้างหรือลบลิงก์สัญลักษณ์ตามความสะดวกแต่ละประเภทตามที่บิลด์กำหนด
clean: ระบบจะลบลิงก์สัญลักษณ์ทั้งหมดโดยไม่มีเงื่อนไข
ignore: ระบบจะไม่ดำเนินการกับสัญลักษณ์ลิงก์
log_only: สร้างข้อความบันทึกราวกับว่ามีการผ่าน "normal" แต่ไม่ได้ดำเนินการใดๆ ในระบบไฟล์ (มีประโยชน์สำหรับเครื่องมือ)
โปรดทราบว่าเฉพาะลิงก์สัญลักษณ์ที่สร้างจากค่าปัจจุบันของ --symlink_prefix เท่านั้นที่อาจได้รับผลกระทบ หากคำนำหน้ามีการเปลี่ยนแปลง ระบบจะปล่อยลิงก์สัญลักษณ์ที่มีอยู่แล้วไว้ตามเดิม
แท็ก:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
ค่าเริ่มต้น: "false"-
Flag นี้จะควบคุมว่าเราจะโพสต์ eventConvenienceSymlinksIdentified ของบิลด์ไปยัง BuildEventProtocol หรือไม่ หากค่าเป็น "จริง" BuildEventProtocol จะมีรายการสำหรับ convenienceSymlinksIdentified ซึ่งแสดงรายการลิงก์สัญลักษณ์ที่สะดวกทั้งหมดที่สร้างขึ้นในเวิร์กスペース หากเป็นเท็จ รายการ convenienceSymlinksIdentified ใน BuildEventProtocol จะว่างเปล่า
แท็ก:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
ค่าเริ่มต้น: "-O0,-DDEBUG=1"-
ใช้สตริงเหล่านี้เป็นตัวเลือกคอมไพเลอร์ objc fastbuild
แท็ก:action_command_lines
--[no]experimental_omitfp
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้ libunwind เพื่อคลายสแต็ก แล้วคอมไพล์ด้วย -fomit-frame-pointer และ -fasynchronous-unwind-tables
แท็ก:action_command_lines
,affects_outputs
,experimental
- ค่าเริ่มต้นของ
--experimental_output_paths=<off, content or strip>
: "off" -
โมเดลที่ควรใช้สำหรับส่วนใดในกฎผังเอาต์พุตจะเขียนเอาต์พุต โดยเฉพาะอย่างยิ่งสำหรับบิลด์ที่มีหลายแพลตฟอร์ม / หลายการกำหนดค่า ฟีเจอร์นี้อยู่ในขั้นทดลอง ดูรายละเอียดได้ที่ 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 โดยที่ label หมายถึงแพลตฟอร์ม และ values คือชื่อย่อที่ต้องการใช้ในเส้นทางเอาต์พุต ใช้เมื่อ --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"-
โปรดใช้ Flag นี้เป็นส่วนหนึ่งของกลยุทธ์การย้ายข้อมูลหรือการทดสอบที่แนะนําเท่านั้น โปรดทราบว่าวิธีการเฮิวริสติกมีข้อบกพร่องที่ทราบอยู่แล้ว และเราขอแนะนำให้เปลี่ยนไปใช้เฉพาะ --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. หากระบุ Flag นี้ ระบบจะไม่สนใจ --android_cpu สำหรับข้อกำหนดของกฎ android_binary
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
ค่าเริ่มต้น: "false"-
สร้างการแยก HWASAN หรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
default: ดูคำอธิบาย-
สร้างไบนารีด้วยเครื่องมือวัดผล FDO เมื่อใช้คอมไพเลอร์ Clang/LLVM ระบบจะยอมรับชื่อไดเรกทอรีที่จะใช้วางไฟล์โปรไฟล์ดิบเมื่อรันไทม์ด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_optimize=<a string>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ FDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อไฟล์ ZIP ที่มีโครงสร้างไฟล์ .gcda, ไฟล์ afdo ที่มีโปรไฟล์อัตโนมัติ หรือไฟล์โปรไฟล์ LLVM นอกจากนี้ Flag นี้ยังยอมรับไฟล์ที่ระบุเป็นป้ายกำกับ (เช่น `//foo/bar:file.afdo` - คุณอาจต้องเพิ่มคำสั่ง `exports_files` ลงในแพ็กเกจที่เกี่ยวข้อง) และป้ายกำกับที่ชี้ไปยังเป้าหมาย `fdo_profile` ด้วย กฎ `fdo_profile` จะลบล้าง Flag นี้
แท็ก:affects_outputs
--fdo_prefetch_hints=<a build target label>
default: ดูคำอธิบาย-
ใช้คำแนะนำการดึงข้อมูลแคชล่วงหน้า
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_profile=<a build target label>
: ดูคำอธิบาย -
fdo_profile ที่แสดงถึงโปรไฟล์ที่จะใช้เพิ่มประสิทธิภาพ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--features=<a string>
รายการ -
ระบบจะเปิดหรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างในการกําหนดค่าเป้าหมาย การระบุ -<feature> จะปิดใช้ฟีเจอร์นั้น ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ ดูข้อมูลเพิ่มเติมได้ที่ --host_features
แท็ก:changes_inputs
,affects_outputs
- ค่าเริ่มต้น
--[no]force_pic
: "เท็จ" -
หากเปิดใช้ การคอมไพล์ C++ ทั้งหมดจะสร้างโค้ดที่ไม่ขึ้นอยู่กับตำแหน่ง ("-fPIC") ลิงก์จะใช้ไลบรารีที่สร้างไว้ล่วงหน้าของ PIC มากกว่าไลบรารีที่ไม่ใช่ PIC และลิงก์จะสร้างไฟล์ปฏิบัติการที่ไม่ขึ้นอยู่กับตำแหน่ง ("-พาย")
แท็ก:loading_and_analysis
,affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกําหนดค่าการดําเนินการ ตัวแปรสามารถระบุโดยใช้ชื่อ ซึ่งในกรณีนี้ระบบจะนำค่ามาจากสภาพแวดล้อมการเรียกใช้ หรือระบุโดยใช้คู่ชื่อ=ค่า ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ คุณใช้ตัวเลือกนี้ได้หลายครั้ง ตัวเลือกสําหรับตัวแปรเดียวกันจะเลือกตัวเลือกล่าสุด ส่วนตัวเลือกสําหรับตัวแปรต่างๆ จะรวมกัน
แท็ก: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 สําหรับเครื่องมือที่สร้างในการกําหนดค่า exec
แท็ก:action_command_lines
,affects_outputs
--host_cpu=<a string>
ค่าเริ่มต้น: ""-
CPU ของโฮสต์
แท็ก:changes_inputs
,affects_outputs
--host_cxxopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยังคอมไพเลอร์ C++ สําหรับเครื่องมือที่สร้างในการกําหนดค่า exec
แท็ก:action_command_lines
,affects_outputs
--host_features=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบบจะเปิดหรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างในการกําหนดค่า exec การระบุ -<feature> จะเป็นการปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ
แท็ก:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
default: ดูคำอธิบาย-
ลบล้างเวอร์ชัน Python สําหรับการกําหนดค่า exec อาจเป็น "PY2" หรือ "PY3"
แท็ก:loading_and_analysis
,affects_outputs
--host_linkopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง linker เมื่อลิงก์เครื่องมือในการกําหนดค่า exec
แท็ก:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: ดูคำอธิบาย-
เวอร์ชัน macOS ขั้นต่ำที่เข้ากันได้สำหรับเป้าหมายโฮสต์ หากไม่ระบุ ระบบจะใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมเพื่อเลือกส่งผ่านไปยังคอมไพเลอร์ C/C++ เมื่อคอมไพเลอร์ไฟล์บางไฟล์ในการกำหนดค่าการดำเนินการ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter หมายถึงรายการรูปแบบนิพจน์ทั่วไปที่รวมและไม่รวม (ดูที่ --instrumentation_filter ด้วย) option_1 ถึง option_n หมายถึงตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบคสแลชในตัวเลือกนั้น ตัวเลือกมี @ ได้ โดยระบบจะใช้เฉพาะ @ แรกในการแยกสตริง ตัวอย่างเช่น --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 จะเพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ลงในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
,affects_outputs
--host_swiftcopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง swiftc สําหรับเครื่องมือ exec
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้น
--[no]incompatible_auto_exec_groups
: "เท็จ" -
เมื่อเปิดใช้ ระบบจะสร้างกลุ่มผู้บริหารสำหรับ Toolchain แต่ละรายการที่กฎใช้โดยอัตโนมัติ กฎต้องระบุพารามิเตอร์ "toolchain" ในการดำเนินการเพื่อให้การทำงานนี้ได้ผล ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/17134
แท็ก:affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ระบบจะรวมไดเรกทอรี genfiles ไว้ในไดเรกทอรี bin
แท็ก:affects_outputs
,incompatible_change
--[no]incompatible_use_host_features
ค่าเริ่มต้น: "true"-
หากเป็นจริง ให้ใช้ --features สำหรับการกำหนดค่าเป้าหมายเท่านั้น และใช้ --host_features สำหรับการกำหนดค่าการดำเนินการ
แท็ก:changes_inputs
,affects_outputs
,incompatible_change
- ค่าเริ่มต้น
--[no]instrument_test_targets
: "เท็จ" -
เมื่อเปิดใช้การครอบคลุม ให้ระบุว่าจะพิจารณาเครื่องมือวัดกฎการทดสอบหรือไม่ เมื่อตั้งค่าแล้ว ระบบจะเครื่องมือวัดกฎการทดสอบที่รวมโดย --instrumentation_filter มิฉะนั้น กฎการทดสอบจะถูกยกเว้นจากการวัดคุมการครอบคลุมเสมอ
แท็ก:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
ค่าเริ่มต้น: "-/javatests[/:],-/test/java[/:]"-
เมื่อเปิดใช้ความครอบคลุม ระบบจะเครื่องมือวัดเฉพาะกฎที่มีชื่อซึ่งรวมอยู่ในตัวกรองตามนิพจน์ทั่วไปที่ระบุเท่านั้น ระบบจะยกเว้นกฎที่ขึ้นต้นด้วย "-" แทน โปรดทราบว่าระบบจะวัดคุมเฉพาะกฎที่ไม่ใช่การทดสอบเท่านั้น ยกเว้นกรณีที่เปิดใช้งาน --instrument_test_targets
แท็ก:affects_outputs
- ค่าเริ่มต้น
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน iOS ที่เข้ากันได้ขั้นต่ำสำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ระบุ ระบบจะใช้ "ios_sdk_version"
แท็ก:loses_incremental_state
--ios_multi_cpus=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้าง ios_application ผลลัพธ์ที่ได้คือไบนารีแบบสากลที่มีสถาปัตยกรรมที่ระบุไว้ทั้งหมด
แท็ก:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
ค่าเริ่มต้น: "true"-
เลิกใช้งานแล้ว แทนที่ด้วย --incompatible_remove_legacy_whole_archive (ดูรายละเอียดที่ https://github.com/bazelbuild/bazel/issues/7362) เมื่อเปิด ให้ใช้ --whole-archive สำหรับกฎ cc_binary ที่มี linkshared=True และ linkstatic=True หรือ '-static' ใน linkopts ตัวเลือกนี้มีไว้เพื่อให้ใช้กับเวอร์ชันก่อนหน้าได้เท่านั้น อีกทางเลือกหนึ่งที่ดีกว่าคือการใช้ Alwayslink=1 เมื่อจำเป็น
แท็ก:action_command_lines
,affects_outputs
,deprecated
--linkopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc เมื่อลิงก์
แท็ก:action_command_lines
,affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ltobackendopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังขั้นตอนแบ็กเอนด์ของ LTO (ใต้ --features=thin_lto)
แท็ก:action_command_lines
,affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ltoindexopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมที่จะส่งไปยังขั้นตอนการจัดทำดัชนี LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
,affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--macos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple macOS
แท็ก:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: ดูคำอธิบาย-
เวอร์ชัน 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
ค่าเริ่มต้น: "false"-
กำหนดว่าจะใช้การลบสัญลักษณ์และโค้ดที่เสียหายในไบนารีที่ลิงก์หรือไม่ ระบบจะลบไบนารีหากระบุทั้ง 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>
default: ดูคำอธิบาย-
ระบุส่วนต่อท้ายที่จะเพิ่มลงในไดเรกทอรีการกําหนดค่า
แท็ก:loses_incremental_state
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--propeller_optimize=<a build target label>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ Propeller เพื่อเพิ่มประสิทธิภาพเป้าหมายการสร้าง โปรไฟล์ Propeller ต้องมีไฟล์อย่างน้อย 1 ใน 2 ไฟล์ ได้แก่ โปรไฟล์ cc และโปรไฟล์ ld Flag นี้ยอมรับป้ายกำกับบิลด์ซึ่งต้องอ้างอิงถึงไฟล์อินพุตโปรไฟล์ใบพัด เช่น ไฟล์ BUILD ที่กําหนดป้ายกํากับใน a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",) อาจต้องเพิ่มคําสั่ง exports_files ลงในแพ็กเกจที่เกี่ยวข้องเพื่อให้ Bazel เห็นไฟล์เหล่านี้ ตัวเลือกนี้ต้องใช้ในรูปแบบ --propeller_optimize=//a/b:propeller_profile
แท็ก:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
default: ดูคำอธิบาย-
ชื่อเส้นทางสัมบูรณ์ของไฟล์ cc_profile สำหรับบิลด์ Propeller Optimized
แท็ก:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
default: ดูคำอธิบาย-
ชื่อเส้นทางแบบสัมบูรณ์ของไฟล์ ld_profile สำหรับบิลด์ Propeller Optimized
แท็ก:affects_outputs
- ค่าเริ่มต้น
--run_under=<a prefix in front of command>
: ดูคำอธิบาย -
คำนำหน้าที่จะแทรกไว้หน้าไฟล์ปฏิบัติการสำหรับคำสั่ง "test" และ "run" หากค่าคือ "foo -bar" และบรรทัดคำสั่งการดําเนินการคือ "test_binary -baz" บรรทัดคำสั่งสุดท้ายจะเป็น "foo -bar test_binary -baz" ซึ่งอาจเป็นป้ายกำกับของเป้าหมายที่เรียกใช้ได้เช่นกัน ตัวอย่างเช่น 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'
แท็ก:action_command_lines
-
หากเป็น "จริง" ระบบจะแชร์ไลบรารีเนทีฟที่มีฟังก์ชันการทำงานเหมือนกันระหว่างเป้าหมายต่างๆ
แท็ก:loading_and_analysis
,affects_outputs
--[no]stamp
ค่าเริ่มต้น: "false"-
ประทับเวลาไบนารีด้วยวันที่ ชื่อผู้ใช้ ชื่อโฮสต์ ข้อมูลเวิร์กスペース ฯลฯ
แท็ก:affects_outputs
--strip=<always, sometimes or never>
ค่าเริ่มต้น: "บางครั้ง"-
ระบุว่าจะลบข้อมูลโค้ดที่ไม่จำเป็นในไฟล์ไบนารีและไลบรารีที่ใช้ร่วมกันหรือไม่ (โดยใช้ "-Wl,--strip-debug") ค่าเริ่มต้นของ "บางครั้ง" หมายถึง Strip iff --compilation_mode=fastbuild
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--stripopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง strip เมื่อสร้างไบนารี "<name>.stripped"
แท็ก:action_command_lines
,affects_outputs
--swiftcopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยังการคอมไพล์ Swift
แท็ก:action_command_lines
- ค่าเริ่มต้น
--symlink_prefix=<a string>
: ดูคำอธิบาย -
คำนำหน้าที่จะเพิ่มไว้ข้างหน้าลิงก์สัญลักษณ์เพื่อความสะดวกซึ่งสร้างขึ้นหลังจากการบิลด์ หากไม่ระบุ ค่าเริ่มต้นจะเป็นชื่อของเครื่องมือสร้างตามด้วยขีดกลาง หากส่ง "/" ระบบจะไม่สร้างสัญลักษณ์ลิงก์และจะไม่แสดงคำเตือน คำเตือน: เราจะเลิกใช้งานฟังก์ชันพิเศษสำหรับ "/" ในเร็วๆ นี้ โปรดใช้ --experimental_convenience_symlinks=ignore แทน
แท็ก:affects_outputs
--tvos_cpus=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple tvOS
แท็ก:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: ดูคำอธิบาย-
เวอร์ชัน 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')>
default: ดูคำอธิบาย-
เวอร์ชัน 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 ใช้บังคับอินพุตการสร้างที่ถูกต้อง (คําจํากัดความของกฎ ชุดค่าผสมของ Flag ฯลฯ)
--auto_cpu_environment_group=<a build target label>
ค่าเริ่มต้น: ""-
ประกาศ environment_group ที่จะใช้สําหรับการแมปค่า cpu กับค่า target_environment โดยอัตโนมัติ
แท็ก:changes_inputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]check_licenses
: "เท็จ" -
ตรวจสอบว่าข้อจำกัดการอนุญาตให้ใช้สิทธิที่แพ็กเกจที่ต้องพึ่งพากำหนดไว้ไม่ขัดแย้งกับโหมดการจัดจำหน่ายของเป้าหมายที่สร้าง โดยค่าเริ่มต้น ใบอนุญาตจะไม่ได้รับการตรวจสอบ
แท็ก:build_file_semantics
--[no]check_visibility
ค่าเริ่มต้น: "true"-
หากปิดใช้ ระบบจะลดระดับข้อผิดพลาดด้านการแสดงผลในข้อกําหนดของเป้าหมายเป็นคําเตือน
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]desugar_for_android
: "จริง" -
กำหนดว่าจะถอด Sugar ออกจาก Bytecode ของ 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
: "จริง" -
ตรวจสอบสภาพแวดล้อมที่เป้าหมายแต่ละรายการเข้ากันได้ และรายงานข้อผิดพลาดหากเป้าหมายใดมีทรัพยากร Dependencies ที่ไม่รองรับสภาพแวดล้อมเดียวกัน
แท็ก:build_file_semantics
--[no]experimental_check_desugar_deps
ค่าเริ่มต้น: "true"-
ตรวจสอบอีกครั้งว่าการถอด Sugar ถูกต้องในระดับไบนารีของ Android หรือไม่
แท็ก:eagerness_to_exit
,loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--experimental_import_deps_checking=<off, warning or error>
: "ปิด" -
เมื่อเปิดใช้แล้ว ให้ตรวจสอบว่าทรัพยากร Dependency ของ aar_IMPORT เสร็จสมบูรณ์หรือไม่ การบังคับใช้นี้อาจทำให้บิลด์ใช้งานไม่ได้ หรืออาจส่งผลให้เกิดคำเตือนเท่านั้น
แท็ก:loading_and_analysis
--experimental_one_version_enforcement=<off, warning or error>
ค่าเริ่มต้น: "OFF"-
เมื่อเปิดใช้ กฎ java_binary จะต้องไม่มีไฟล์คลาสเดียวกันใน classpath มากกว่า 1 เวอร์ชัน การบังคับใช้นี้อาจทำให้บิลด์ใช้งานไม่ได้ หรืออาจส่งผลให้เกิดคำเตือนเท่านั้น
แท็ก:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
ค่าเริ่มต้น: "default"-
หากเป็น "จริง" ระบบจะตรวจสอบว่าเป้าหมาย Java ประกาศเป้าหมายทั้งหมดที่ใช้โดยตรงเป็น Dependency อย่างชัดเจน
แท็ก:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
ค่าเริ่มต้น: "false"-
หากเปิดใช้ ให้ตรวจสอบ testonly สำหรับเป้าหมายที่เป็นข้อกําหนดเบื้องต้นซึ่งเป็นไฟล์เอาต์พุตโดยค้นหา testonly ของกฎการสร้าง ซึ่งตรงกับการตรวจสอบระดับการเข้าถึง
แท็ก:build_file_semantics
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_check_visibility_for_toolchains
: "เท็จ" -
หากเปิดใช้ การตรวจสอบระดับการเข้าถึงจะมีผลกับการติดตั้งใช้งานเครื่องมือทางเทคนิคด้วย
แท็ก:build_file_semantics
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_disable_native_android_rules
: "เท็จ" -
หากเปิดใช้ ระบบจะปิดใช้การใช้กฎ Android ดั้งเดิมโดยตรง โปรดใช้กฎ Starlark สำหรับ Android จาก https://github.com/bazelbuild/rules_android
แท็ก:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
ค่าเริ่มต้น: "false"-
ไม่มีการดำเนินการใดๆ เก็บไว้ที่นี่เพื่อให้มีความเข้ากันได้แบบย้อนหลัง
แท็ก:eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_python_disable_py2
: "จริง" -
หากเป็นจริง การใช้การตั้งค่า Python 2 จะทำให้เกิดข้อผิดพลาด ซึ่งรวมถึง python_version=PY2, srcs_version=PY2 และ srcs_version=PY2ONLY ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/15684
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_validate_top_level_header_inclusions
: "true" -
หากเป็นจริง Bazel จะตรวจสอบการรวมส่วนหัวไดเรกทอรีระดับบนสุดด้วย (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/10047)
แท็ก:loading_and_analysis
,incompatible_change
--[no]one_version_enforcement_on_java_tests
ค่าเริ่มต้น: "true"-
เมื่อเปิดใช้และตั้งค่า experimental_one_version_enforcement เป็นค่าที่ไม่ใช่ NONE ให้บังคับใช้เวอร์ชันเดียวในเป้าหมาย java_test คุณปิดใช้ Flag นี้เพื่อปรับปรุงประสิทธิภาพการทดสอบที่เพิ่มขึ้นได้ แต่อาจพลาดการละเมิดเวอร์ชันเดียวที่อาจเกิดขึ้น
แท็ก:loading_and_analysis
--python_native_rules_allowlist=<a build target label>
default: ดูคำอธิบาย-
รายการที่อนุญาต (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>
ค่าเริ่มต้น: "error"-
ยกเว้นในกรณีที่เป็น OFF ระบบจะตรวจสอบว่าเป้าหมาย proto_library ประกาศเป้าหมายทั้งหมดที่ใช้โดยตรงเป็น Dependency อย่างชัดแจ้ง
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้นของ
--strict_public_imports=<off, warn, error, strict or default>
: "off" -
หากไม่ปิด ให้ตรวจสอบว่าเป้าหมาย protocol_library จะประกาศเป้าหมายทั้งหมดที่ใช้ใน "นําเข้าแบบสาธารณะ" ว่าส่งออกอย่างชัดเจน
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" จะต้องประกาศส่วนหัวที่พบผ่านเส้นทางรวมของระบบ (-isystem) ด้วย
แท็ก:loading_and_analysis
,eagerness_to_exit
--target_environment=<a build target label>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ประกาศสภาพแวดล้อมเป้าหมายของบิลด์นี้ ต้องเป็นการอ้างอิงป้ายกำกับไปยังกฎ "environment" หากระบุไว้ เป้าหมายระดับบนสุดทั้งหมดต้องเข้ากันได้กับสภาพแวดล้อมนี้
แท็ก:changes_inputs
- ตัวเลือกที่ส่งผลต่อเอาต์พุตการลงนามของบิลด์
- ค่าเริ่มต้น
--apk_signing_method=<v1, v2, v1_v2 or v4>
: "v1_v2" -
การใช้งานเพื่อรับรอง APK
แท็ก:action_command_lines
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--[no]device_debug_entitlements
: "จริง" -
หากตั้งค่าไว้และโหมดการคอมไพล์ไม่ใช่ "opt" แอป objc จะรวมการให้สิทธิ์แก้ไขข้อบกพร่องเมื่อลงชื่อ
แท็ก:changes_inputs
--ios_signing_cert_name=<a string>
default: ดูคำอธิบาย-
ชื่อใบรับรองที่จะใช้สำหรับการลงนาม iOS หากไม่ได้ตั้งค่าไว้ ระบบจะใช้โปรไฟล์การจัดสรรแทน อาจเป็นค่ากำหนดข้อมูลประจำตัว Keychain ของใบรับรองหรือ (สตริงย่อย) ของชื่อสามัญของใบรับรองตามหน้า man ของ Codesign (รหัสการลงชื่อเข้าใช้)
แท็ก:action_command_lines
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
--[no]incompatible_config_setting_private_default_visibility
ค่าเริ่มต้น: "false"-
หากตัวยึดตำแหน่ง_enforce_config_setting_visibility=false จะหมายความว่าไม่มีการดำเนินการ หรือหาก Flag นี้เป็นเท็จ config_setting ที่ไม่มีแอตทริบิวต์ระดับการมองเห็นที่ชัดเจนจะเป็น //visibility:public หากแฟล็กนี้เป็นจริง config_setting จะใช้ตรรกะระดับการเข้าถึงเดียวกันกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_legacy_py_provider
ค่าเริ่มต้น: "true"-
No-op, will be removed soon.
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" ไม่อนุญาตแอตทริบิวต์ sdk_frameworks และ external_sdk_frameworks ใน objc_library andobjc_import
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ระบบจะบังคับใช้ข้อจำกัดการแสดงผลของ config_setting หากเป็นเท็จ เป้าหมายทุกรายการจะเห็น config_setting ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" ให้ตั้งค่าเริ่มต้นเป็น "จริง" สําหรับแอตทริบิวต์ alwayslink ใน objc_library และ objc_import
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
ค่าเริ่มต้น: "false"-
เมื่อเป็น "จริง" ระบบจะแสดงข้อผิดพลาดเมื่อใช้กฎ py_* ในตัว คุณควรใช้กฎ rule_python แทน ดูข้อมูลเพิ่มเติมและวิธีการย้ายข้อมูลได้ที่ https://github.com/bazelbuild/bazel/issues/17773
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่ควบคุมลักษณะการทํางานของสภาพแวดล้อมการทดสอบหรือโปรแกรมรันทดสอบ
--[no]allow_analysis_failures
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" การวิเคราะห์เป้าหมายของกฎที่ล้มเหลวจะส่งผลให้เป้าหมายเผยแพร่อินสแตนซ์ของ AnalysisFailureInfo ที่มีคำอธิบายข้อผิดพลาดแทนที่จะส่งผลให้การบิลด์ล้มเหลว
แท็ก:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
ค่าเริ่มต้น: "2000"-
กำหนดจำนวนสูงสุดของความสัมพันธ์แบบสื่อกลางผ่านแอตทริบิวต์กฎที่มีการเปลี่ยนการกำหนดค่า for_analysis_testing การเกินขีดจํากัดนี้จะทำให้เกิดข้อผิดพลาดเกี่ยวกับกฎ
แท็ก:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
ค่าเริ่มต้น: "false"-
หากเป็นจริง การดำเนินการ dex2oat ที่ล้มเหลวจะทำให้บิลด์หยุดทำงานแทนที่จะเรียกใช้ dex2oat ในระหว่างรันไทม์การทดสอบ
แท็ก:loading_and_analysis
,experimental
--[no]check_tests_up_to_date
ค่าเริ่มต้น: "false"-
อย่าทำการทดสอบ เพียงตรวจสอบว่าการทดสอบเป็นปัจจุบันหรือไม่ หากผลการทดสอบทั้งหมดเป็นข้อมูลล่าสุด การทดสอบจะเสร็จสมบูรณ์ หากต้องสร้างหรือดำเนินการทดสอบใดๆ ระบบจะรายงานข้อผิดพลาดและการทดสอบจะไม่สำเร็จ ตัวเลือกนี้ใช้กับลักษณะการทํางานของ --check_up_to_date
แท็ก:execution
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g. memory=10,30,60,100>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างจำนวนทรัพยากรเริ่มต้นสำหรับการทดสอบ รูปแบบที่รองรับคือ <resource>=<value> หากระบุตัวเลขบวกเพียงค่าเดียวเป็น <value> ระบบจะลบล้างทรัพยากรเริ่มต้นสำหรับขนาดการทดสอบทั้งหมด หากระบุตัวเลข 4 รายการที่คั่นด้วยคอมมา ระบบจะลบล้างจำนวนทรัพยากรสําหรับขนาดการทดสอบขนาดเล็ก กลาง ใหญ่ และใหญ่มากตามลําดับ ค่าอาจเป็น HOST_RAM/HOST_CPU หรือจะตามด้วย [-|*]<Float> ก็ได้ (เช่น Memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4) ทรัพยากรการทดสอบเริ่มต้นที่ระบุโดย Flag นี้จะลบล้างโดยทรัพยากรที่ระบุอย่างชัดเจนในแท็ก
--[no]experimental_android_use_parallel_dex2oat
ค่าเริ่มต้น: "false"-
ใช้ dex2oat ควบคู่กันเพื่อเพิ่มความเร็วของ android_test
แท็ก:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ในกรณีที่การทดสอบไม่สำเร็จ ระบบจะดำเนินการทดสอบแต่ละรายการซ้ำจนถึงจำนวนครั้งที่ระบุไว้ การทดสอบที่ต้องใช้มากกว่า 1 ครั้งจึงจะผ่านจะมีการทําเครื่องหมายเป็น "ไม่เสถียร" ในสรุปการทดสอบ โดยปกติแล้ว ค่าที่ระบุจะเป็นจํานวนเต็มหรือสตริง "default" เท่านั้น หากเป็นจำนวนเต็ม ระบบจะเรียกใช้การทดสอบทั้งหมดไม่เกิน N ครั้ง หากเป็น "default" ระบบจะพยายามทดสอบเพียงครั้งเดียวสําหรับการทดสอบปกติ และ 3 ครั้งสําหรับการทดสอบที่มีการทำเครื่องหมายว่าไม่น่าเชื่อถืออย่างชัดเจนโดยกฎ (แอตทริบิวต์ flaky=1) ไวยากรณ์สำรอง: regex_filter@flaky_test_attempts โดยที่ flaky_test_attempts จะเป็นค่าเดียวกับด้านบน และ regex_filter หมายถึงรายการรูปแบบนิพจน์ทั่วไปที่รวมและยกเว้น (ดู --runs_per_test ด้วย) ตัวอย่าง: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 ดีเฟลกการทดสอบทั้งหมดใน //foo/ ยกเว้นการทดสอบที่อยู่ภายใต้ foo/bar 3 ครั้ง ตัวเลือกนี้ส่งได้หลายครั้ง อาร์กิวเมนต์ที่ตรงกันซึ่งส่งล่าสุดจะมีความสําคัญเหนือกว่า หากไม่พบรายการที่ตรงกัน ลักษณะการทํางานจะเหมือนกับ "ค่าเริ่มต้น" ด้านบน
แท็ก:execution
--[no]ios_memleaks
ค่าเริ่มต้น: "false"-
เปิดใช้การตรวจสอบการรั่วไหลของหน่วยความจำในเป้าหมาย ios_test
แท็ก:action_command_lines
- ค่าเริ่มต้น
--ios_simulator_device=<a string>
: ดูคำอธิบาย -
อุปกรณ์ที่จะจําลองเมื่อเรียกใช้แอปพลิเคชัน iOS ในโปรแกรมจําลอง เช่น "iPhone 6" คุณสามารถดูรายการอุปกรณ์ได้โดยเรียกใช้ "xcrun simctl list devicetypes" ในเครื่องที่จะเรียกใช้โปรแกรมจำลอง
แท็ก:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: ดูคำอธิบาย-
เวอร์ชัน iOS ที่จะใช้งานบนเครื่องจำลองเมื่อเรียกใช้หรือทดสอบ ระบบจะไม่สนใจกฎ ios_test หากกฎระบุอุปกรณ์เป้าหมายไว้ในกฎ
แท็ก:test_runner
- ค่าเริ่มต้น
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "อัตโนมัติ" -
จำนวนงานทดสอบในเครื่องสูงสุดที่จะทํางานพร้อมกัน ใช้จำนวนเต็มหรือคีย์เวิร์ด ("auto", "HOST_CPUS", "HOST_RAM") ตามด้วยการดำเนินการ ([-|*]<float>) ตามต้องการ เช่น "auto", "HOST_CPUS*.5" 0 หมายความว่าทรัพยากรในเครื่องจะจำกัดจำนวนงานทดสอบในเครื่องที่จะเรียกใช้พร้อมกันแทน การตั้งค่านี้ให้มากกว่าค่าสำหรับ --jobs จะไม่มีผล
แท็ก:execution
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ระบุจํานวนครั้งที่จะเรียกใช้การทดสอบแต่ละรายการ หากการพยายามดังกล่าวไม่สำเร็จไม่ว่าด้วยเหตุผลใดก็ตาม ระบบจะถือว่าการทดสอบทั้งหมดไม่สำเร็จ โดยปกติแล้วค่าที่ระบุจะเป็นจํานวนเต็มเท่านั้น ตัวอย่าง: --runs_per_test=3 จะทำการทดสอบทั้งหมด 3 ครั้ง ไวยากรณ์สำรอง: regex_filter@runs_per_test โดย running_per_test ย่อมาจากค่าจำนวนเต็ม ส่วน regex_filter หมายถึงรายการรูปแบบการรวมและยกเว้นรูปแบบนิพจน์ทั่วไป (โปรดดู --instrumentation_filter) ตัวอย่างเช่น --runs_per_test=//foo/.*,-//foo/bar/.*@3 จะทำการทดสอบทั้งหมดใน //foo/ ยกเว้นการทดสอบภายใต้ foo/bar 3 ครั้ง ตัวเลือกนี้ส่งได้หลายครั้ง อาร์กิวเมนต์ที่ส่งผ่านล่าสุดที่ตรงกันจะมีความสำคัญเหนือกว่า หากไม่พบรายการที่ตรงกัน ระบบจะเรียกใช้การทดสอบเพียงครั้งเดียว
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--test_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุตัวแปรสภาพแวดล้อมเพิ่มเติมที่จะแทรกลงในสภาพแวดล้อมโปรแกรมรันทดสอบ คุณสามารถระบุตัวแปรโดยใช้ชื่อ ซึ่งระบบจะอ่านค่าจากสภาพแวดล้อมไคลเอ็นต์ Bazel หรือจะระบุโดยใช้คู่ชื่อ=ค่าก็ได้ คุณใช้ตัวเลือกนี้ได้หลายครั้งเพื่อระบุตัวแปรหลายรายการ ใช้เฉพาะโดยคำสั่ง "การทดสอบ Bazel" เท่านั้น
แท็ก:test_runner
--[no]test_keep_going
ค่าเริ่มต้น: "true"-
เมื่อปิดใช้ การทดสอบที่ไม่ผ่านจะทำให้บิลด์ทั้งหมดหยุดลง โดยค่าเริ่มต้น ระบบจะทำการทดสอบทั้งหมดแม้ว่าจะไม่ผ่านก็ตาม
แท็ก:execution
--test_strategy=<a string>
ค่าเริ่มต้น: ""-
ระบุกลยุทธ์ที่จะใช้เมื่อทำการทดสอบ
แท็ก:execution
- ค่าเริ่มต้นของ
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - ลบล้างค่าระยะหมดเวลาในการทดสอบเริ่มต้นสำหรับระยะหมดเวลาทดสอบ (เป็นวินาที) หากระบุค่าจำนวนเต็มบวกค่าเดียว ค่าดังกล่าวจะแทนที่หมวดหมู่ทั้งหมด หากระบุจำนวนเต็ม 4 รายการที่คั่นด้วยคอมมา ระบบจะลบล้างการหมดเวลาสำหรับระยะสั้น ปานกลาง ยาว และตลอดไป (ตามลำดับ) ไม่ว่ารูปแบบใด ค่า -1 จะบอกให้ Blaze ใช้การหมดเวลาเริ่มต้นสำหรับหมวดหมู่นั้น
- ค่าเริ่มต้น
--test_tmpdir=<a path>
: ดูคำอธิบาย - ระบุไดเรกทอรีชั่วคราวพื้นฐานสำหรับ "bazel test" ที่จะใช้
- ค่าเริ่มต้น
--[no]zip_undeclared_test_outputs
: "จริง" -
หากเป็น "จริง" ระบบจะเก็บถาวรเอาต์พุตการทดสอบที่ไม่ได้ประกาศไว้ในไฟล์ ZIP
แท็ก:test_runner
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพของเวลาบิลด์
- ค่าเริ่มต้นของ
--cache_computed_file_digests=<a long integer>
: "50,000" - หากมากกว่า 0 ระบบจะกำหนดค่า Bazel ให้แคชข้อมูลสรุปไฟล์ไว้ในหน่วยความจำตามข้อมูลเมตาแทนที่จะคำนวณข้อมูลสรุปจากดิสก์อีกครั้งทุกครั้งที่ต้องการ การตั้งค่านี้เป็น 0 จะทำให้แน่ใจได้ว่าถูกต้อง เนื่องจากระบบไม่สามารถบันทึกการเปลี่ยนแปลงของไฟล์ทั้งหมดจากข้อมูลเมตาของไฟล์ หากไม่ใช่ 0 ตัวเลขจะระบุขนาดของแคชเป็นจํานวนข้อมูลสรุปไฟล์ที่จะแคช
--[no]experimental_filter_library_jar_with_program_jar
ค่าเริ่มต้น: "false"-
กรอง ProgramJar ของ ProGuard เพื่อนำคลาสที่อยู่ใน LibraryJar ออกด้วย
แท็ก:action_command_lines
- ค่าเริ่มต้น
--[no]experimental_inmemory_dotd_files
: "จริง" -
หากเปิดใช้ ระบบจะส่งไฟล์ .d ของ C++ ในหน่วยความจำจากโหนดการสร้างระยะไกลโดยตรงแทนที่จะเขียนลงในดิสก์
แท็ก:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
ค่าเริ่มต้น: "true"-
หากเปิดใช้ ระบบจะส่งไฟล์ที่ต้องพึ่งพา (.jdeps) ที่สร้างขึ้นจากการคอมไพล์ Java ผ่านหน่วยความจำจากโหนดการสร้างระยะไกลโดยตรงแทนที่จะเขียนลงในดิสก์
แท็ก:loading_and_analysis
,execution
,affects_outputs
,experimental
- ค่าเริ่มต้น
--[no]experimental_objc_include_scanning
: "เท็จ" -
กำหนดว่าจะทำการสแกนรวมสำหรับ Objective C/C++ หรือไม่
แท็ก:loading_and_analysis
,execution
,changes_inputs
--[no]experimental_retain_test_configuration_across_testonly
ค่าเริ่มต้น: "false"-
เมื่อเปิดใช้ --trim_test_configuration จะไม่ตัดการกำหนดค่าการทดสอบสำหรับกฎที่มีการทำเครื่องหมาย testonly=1 ทั้งนี้เพื่อลดปัญหาความขัดแย้งในการดำเนินการเมื่อกฎที่ไม่ใช่การทดสอบต้องพึ่งพากฎ cc_test จะไม่มีผลหาก --trim_test_configuration เป็นเท็จ
แท็ก:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
ค่าเริ่มต้น: "false"-
หากเปิดใช้ คุณจะสามารถใช้ cc_import เวอร์ชัน Starlark ได้
แท็ก:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
ค่าเริ่มต้น: "false"-
การจำกัดอินพุตให้แคบลงสำหรับการคอมไพล์ C/C++ โดยการแยกวิเคราะห์บรรทัด #include จากไฟล์อินพุต ซึ่งจะช่วยปรับปรุงประสิทธิภาพและความสามารถในการเพิ่มประสิทธิภาพโดยการลดขนาดของต้นไม้อินพุตการคอมไพล์ อย่างไรก็ตาม การดำเนินการนี้อาจทำให้บิลด์ใช้งานไม่ได้เนื่องจากเครื่องมือสแกนรวมไม่ได้ใช้ความหมายของ C preprocessor อย่างเต็มรูปแบบ โดยเฉพาะอย่างยิ่ง จะไม่เข้าใจคำสั่ง #include แบบไดนามิกและไม่สนใจตรรกะแบบมีเงื่อนไขของโปรแกรมประมวลผลข้อมูลล่วงหน้า คุณต้องใช้โดยยอมรับความเสี่ยงเอง เราจะปิดปัญหาทั้งหมดที่เกี่ยวข้องกับการแจ้งว่าไม่เหมาะสมนี้
แท็ก:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
ค่าเริ่มต้น: "true"-
การทำงานส่วนใหญ่ทำงานกับไฟล์ Jar แต่ละรายการแยกกันได้
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
: "HOST_CPUS" -
กำหนดจำนวนแกน CPU ทั้งหมดในเครื่องที่พร้อมให้ Bazel ใช้สำหรับการดำเนินการสร้างที่ดำเนินการในเครื่อง ใช้จำนวนเต็มหรือ "HOST_CPUS" แล้วตามด้วย [-|*]<Float> (เช่น HOST_CPUS*.5 เพื่อใช้แกน CPU ที่มีอยู่ครึ่งหนึ่ง) โดยค่าเริ่มต้น ("HOST_CPUS") Bazel จะค้นหาการกำหนดค่าของระบบเพื่อประมาณจำนวนแกน CPU ที่มี
แท็ก:host_machine_resource_optimizations
--local_extra_resources=<a named float, 'name=value'>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
กำหนดจำนวนทรัพยากรเพิ่มเติมที่พร้อมใช้งานสำหรับ Bazel รับในคู่สตริง-ทศนิยม ใช้ซ้ำได้เพื่อระบุทรัพยากรเพิ่มเติมหลายประเภท Bazel จะจำกัดการดำเนินการที่ทำงานพร้อมกันตามทรัพยากรเพิ่มเติมที่มีอยู่และทรัพยากรเพิ่มเติมที่จําเป็น การทดสอบสามารถประกาศจํานวนทรัพยากรเพิ่มเติมที่ต้องการได้โดยใช้แท็กรูปแบบ "resources:<resoucename>:<amount>" คุณไม่สามารถตั้งค่า CPU, RAM และทรัพยากรที่ใช้ได้โดยใช้ Flag นี้
แท็ก: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% ของ RAM นั้น
แท็ก:host_machine_resource_optimizations
--local_resources=<a named double, 'name=value', where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
ระบบจะรวบรวมการใช้งานหลายครั้ง-
กำหนดจำนวนทรัพยากรที่ Bazel ใช้ได้ รับการกําหนดค่าไปยัง float หรือ HOST_RAM/HOST_CPUS ตามด้วย [-|*]<float> (ไม่บังคับ) (เช่น memory=HOST_RAM*.5 เพื่อใช้ RAM ที่มีครึ่งหนึ่ง) ใช้หลายครั้งเพื่อระบุทรัพยากรหลายประเภทได้ Bazel จะจำกัดการดำเนินการที่ทำงานพร้อมกันตามทรัพยากรที่มีอยู่และทรัพยากรที่จำเป็น การทดสอบจะประกาศจำนวนทรัพยากรที่ต้องการได้โดยใช้แท็กรูปแบบ "resources:<resource name>:<amount>" ลบล้างทรัพยากรที่ระบุโดย --local_{cpu|ram|extra}_resources
แท็ก:host_machine_resource_optimizations
--[no]objc_use_dotd_pruning
ค่าเริ่มต้น: "true"-
หากตั้งค่าไว้ ระบบจะใช้ไฟล์ .d ที่ clang สร้างขึ้นเพื่อตัดชุดอินพุตที่ส่งไปยังการคอมไพล์ objc
แท็ก:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
ค่าเริ่มต้น: "false"-
เมื่อสร้างเป้าหมาย //a:a ให้ประมวลผลส่วนหัวในเป้าหมายทั้งหมดที่ //a:a นั้นใช้ (หากเปิดใช้การประมวลผลส่วนหัวสําหรับเครื่องมือทางเทคนิค)
แท็ก:execution
- ค่าเริ่มต้น
--[no]trim_test_configuration
: "จริง" -
เมื่อเปิดใช้ ระบบจะล้างตัวเลือกที่เกี่ยวข้องกับการทดสอบด้านล่างระดับบนสุดของบิลด์ เมื่อ Flag นี้ทำงานอยู่ ระบบจะไม่สร้างการทดสอบเป็นข้อกําหนดของกฎที่ไม่ใช่การทดสอบ แต่การเปลี่ยนแปลงตัวเลือกที่เกี่ยวข้องกับการทดสอบจะไม่ทําให้ระบบวิเคราะห์กฎที่ไม่ใช่การทดสอบอีกครั้ง
แท็ก:loading_and_analysis
,loses_incremental_state
- ตัวเลือกที่ส่งผลต่อรายละเอียด รูปแบบ หรือตำแหน่งของการบันทึก ได้แก่
--[no]experimental_bep_target_summary
ค่าเริ่มต้น: "false"- ระบุว่าจะเผยแพร่เหตุการณ์ TargetSummary หรือไม่
--[no]experimental_build_event_expand_filesets
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" ระบบจะขยายชุดไฟล์ใน BEP เมื่อแสดงไฟล์เอาต์พุต
แท็ก:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" ระบบจะแก้ไขลิงก์สัญลักษณ์ของไฟล์ชุดที่เกี่ยวข้องใน BEP โดยสมบูรณ์เมื่อแสดงไฟล์เอาต์พุต ต้องใช้ --experimental_build_event_expand_filesets
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_build_event_upload_max_retries=<an integer>
: "4" -
จำนวนครั้งที่ Bazel ควรลองอัปโหลดเหตุการณ์การสร้างอีกครั้งสูงสุด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1s" -
เริ่มแรก ความล่าช้าขั้นต่ำสำหรับการลองใหม่แบบ Exponential Backoff เมื่ออัปโหลด BEP ไม่สำเร็จ (เลขชี้กำลัง: 1.6)
แท็ก:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
default: ดูคำอธิบาย-
เลือกวิธีอัปโหลดอาร์ติแฟกต์ที่อ้างอิงในโปรโตคอลเหตุการณ์การสร้าง
แท็ก:affects_outputs
--[no]experimental_materialize_param_files_directly
ค่าเริ่มต้น: "false"-
หากจะแสดงไฟล์พารามิเตอร์ ให้เขียนลงในดิสก์โดยตรง
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_run_bep_event_include_residue
: "เท็จ" -
การรวมข้อมูลที่เหลืออยู่ในบรรทัดคำสั่งไว้ในเหตุการณ์การเรียกใช้บิลด์ที่อาจมีข้อมูลที่เหลืออยู่ โดยค่าเริ่มต้น ข้อมูลที่เหลือจะไม่รวมอยู่ในเหตุการณ์การสร้างคําสั่งการเรียกใช้ที่อาจมีข้อมูลที่เหลืออยู่
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]experimental_stream_log_file_uploads
: "เท็จ" -
สตรีมการอัปโหลดไฟล์บันทึกไปยังพื้นที่เก็บข้อมูลระยะไกลโดยตรงแทนที่จะเขียนลงในดิสก์
แท็ก:affects_outputs
- ค่าเริ่มต้น
--explain=<a path>
: ดูคำอธิบาย -
ทำให้ระบบบิลด์อธิบายแต่ละขั้นตอนที่ดำเนินการแล้วของบิลด์ ระบบจะเขียนคำอธิบายลงในไฟล์บันทึกที่ระบุ
แท็ก:affects_outputs
--[no]legacy_important_outputs
ค่าเริ่มต้น: "true"-
ใช้พารามิเตอร์นี้เพื่อระงับการสร้างช่อง _outputs เดิมในเหตุการณ์ TargetComplete ต้องใช้คีย์นี้สำหรับการผสานรวม Bazel กับ ResultStore
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]materialize_param_files
: "เท็จ" -
เขียนไฟล์พารามิเตอร์กลางลงในต้นไม้เอาต์พุตแม้ว่าจะใช้การดำเนินการระยะไกลก็ตาม มีประโยชน์เมื่อมีการแก้ไขข้อบกพร่อง ซึ่งหมายถึง --subcommands และ --verbose_failures
แท็ก:execution
- ค่าเริ่มต้น
--max_config_changes_to_show=<an integer>
: "3" -
เมื่อทิ้งแคชการวิเคราะห์เนื่องจากการเปลี่ยนแปลงในตัวเลือกบิลด์ จะแสดงชื่อตัวเลือกที่มีการเปลี่ยนแปลงตามจำนวนที่ระบุ หากตัวเลขที่ระบุคือ -1 ตัวเลือกทั้งหมดที่มีการเปลี่ยนแปลงจะแสดงขึ้น
แท็ก:terminal_output
- ค่าเริ่มต้น
--max_test_output_bytes=<an integer>
: "-1" -
ระบุขนาดสูงสุดของบันทึกการทดสอบต่อรายการที่ระบบจะแสดงเมื่อ --test_output เป็น "errors" หรือ "all" มีประโยชน์เพื่อหลีกเลี่ยงเอาต์พุตที่ไม่ได้ทำให้เอาต์พุตการทดสอบมีเสียงดังรบกวนมากเกินไป ส่วนหัวการทดสอบจะรวมอยู่ในขนาดบันทึก ค่าติดลบหมายถึงไม่มีขีดจํากัด เอาต์พุตคือทั้งหมดหรือไม่มีเลย
แท็ก:test_runner
,terminal_output
,execution
--output_filter=<a valid Java regular expression>
default: ดูคำอธิบาย-
แสดงเฉพาะคำเตือนและเอาต์พุตการดำเนินการสำหรับกฎที่มีชื่อตรงกับนิพจน์ทั่วไปที่ระบุ
แท็ก:affects_outputs
- ค่าเริ่มต้น
--progress_report_interval=<an integer in 0-3600 range>
: "0" -
จำนวนวินาทีที่จะรอระหว่างรายงานเกี่ยวกับงานที่ยังคงทำงานอยู่ ค่าเริ่มต้น 0 หมายความว่าระบบจะพิมพ์รายงานฉบับแรกหลังจากผ่านไป 10 วินาที จากนั้นจะพิมพ์ทุก 30 วินาที และหลังจากนั้นระบบจะรายงานความคืบหน้าทุกนาที เมื่อเปิดใช้ --curses ระบบจะรายงานความคืบหน้าทุกๆ วินาที
แท็ก:affects_outputs
--show_result=<an integer>
ค่าเริ่มต้น: "1"-
แสดงผลลัพธ์ของบิลด์ สำหรับแต่ละเป้าหมาย ให้ระบุว่าเป็นข้อมูลล่าสุดหรือไม่ และหากใช่ ให้แจ้งรายการไฟล์เอาต์พุตที่สร้างขึ้น ไฟล์ที่พิมพ์เป็นสตริงที่สะดวกสำหรับการคัดลอกและวางลงในเชลล์เพื่อเรียกใช้
ตัวเลือกนี้ต้องใช้อาร์กิวเมนต์แบบจำนวนเต็ม ซึ่งเป็นจำนวนเป้าหมายขั้นต่ำที่ระบบจะไม่พิมพ์ข้อมูลผลลัพธ์ ดังนั้น 0 จะทำให้เกิดการระงับข้อความ และ MAX_INT จะทําให้ระบบพิมพ์ผลลัพธ์เสมอ ค่าเริ่มต้นคือ 1
หากไม่มีการสร้างเป้าหมายใดเลย ระบบอาจละเว้นผลลัพธ์ของเป้าหมายนั้นเพื่อไม่ให้เอาต์พุตเกินเกณฑ์
แท็ก:affects_outputs
--[no]subcommands
[-s
] default: "false"-
แสดงคำสั่งย่อยที่ดำเนินการระหว่างการสร้าง Flag ที่เกี่ยวข้อง: --execution_log_json_file, --execution_log_binary_file (สําหรับการบันทึกคําสั่งย่อยลงในไฟล์ในรูปแบบที่เครื่องมือใช้งานง่าย)
แท็ก:terminal_output
--test_output=<summary, errors, all or streamed>
ค่าเริ่มต้น: "summary"-
ระบุโหมดเอาต์พุตที่ต้องการ ค่าที่ถูกต้องคือ "สรุป" เพื่อแสดงผลลัพธ์สรุปสถานะการทดสอบเท่านั้น, "ข้อผิดพลาด" เพื่อพิมพ์บันทึกการทดสอบสำหรับการทดสอบที่ล้มเหลวด้วย, "ทั้งหมด" เพื่อพิมพ์บันทึกสำหรับการทดสอบทั้งหมด และ "สตรีม" ไปยังบันทึกเอาต์พุตสำหรับการทดสอบทั้งหมดแบบเรียลไทม์ (ซึ่งจะบังคับให้ดำเนินการทดสอบพร้อมกันในเครื่องโดยไม่คำนึงถึงค่า --test_strategy)
แท็ก:test_runner
,terminal_output
,execution
--test_summary=<short, terse, detailed, none or testcase>
ค่าเริ่มต้น: "short"-
ระบุรูปแบบที่ต้องการของสรุปการทดสอบ ค่าที่ถูกต้องคือ "short" เพื่อพิมพ์เฉพาะข้อมูลเกี่ยวกับการทดสอบที่ดำเนินการ "terse" เพื่อพิมพ์เฉพาะข้อมูลเกี่ยวกับการทดสอบที่ไม่สําเร็จที่ดำเนินการ "detailed" เพื่อพิมพ์ข้อมูลโดยละเอียดเกี่ยวกับเฟรมทดสอบที่ไม่สําเร็จ "testcase" เพื่อพิมพ์สรุปในการแก้ไขเฟรมทดสอบ ไม่พิมพ์ข้อมูลโดยละเอียดเกี่ยวกับเฟรมทดสอบที่ไม่สําเร็จ และ "none" เพื่อละเว้นสรุป
แท็ก:terminal_output
- ค่าเริ่มต้น
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
พิมพ์ข้อมูลการแก้ไขข้อบกพร่องระหว่างการแปลงเครื่องมือเชน แฟล็กจะใช้นิพจน์ทั่วไปซึ่งตรวจสอบกับประเภท Toolchain และเป้าหมายที่เฉพาะเจาะจงเพื่อดูว่าควรแก้ไขข้อบกพร่องใด คุณคั่นนิพจน์ทั่วไปหลายรายการด้วยคอมมา จากนั้นระบบจะตรวจสอบนิพจน์ทั่วไปแต่ละรายการแยกกัน หมายเหตุ: เอาต์พุตของ Flag นี้มีความซับซ้อนมากและน่าจะเป็นประโยชน์ต่อผู้เชี่ยวชาญด้านการแก้ไข Toolchain เท่านั้น
แท็ก:terminal_output
--[no]verbose_explanations
ค่าเริ่มต้น: "false"-
เพิ่มรายละเอียดของคำอธิบายที่แสดงหากเปิดใช้ --explain จะไม่มีผลหากไม่ได้เปิดใช้ --explain
แท็ก:affects_outputs
--[no]verbose_failures
ค่าเริ่มต้น: "false"-
หากคําสั่งไม่สําเร็จ ให้พิมพ์บรรทัดคําสั่งแบบเต็ม
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
--aspects_parameters=<a 'name=value' assignment>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุค่าของพารามิเตอร์แง่มุมบรรทัดคำสั่ง ค่าพารามิเตอร์แต่ละค่าจะได้รับการระบุผ่าน <param_name>=<param_value> เช่น 'my_param=my_val' โดยที่ "my_param" เป็นพารามิเตอร์ของบางองค์ประกอบในรายการ --aspects หรือต้องระบุสำหรับองค์ประกอบในรายการ ตัวเลือกนี้ใช้ได้หลายครั้ง อย่างไรก็ตาม คุณจะกําหนดค่าให้กับพารามิเตอร์เดียวกันได้เพียงครั้งเดียว
แท็ก:loading_and_analysis
--flag_alias=<a 'name=value' flag alias>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตั้งชื่อย่อสำหรับ Flag ของ Starlark โดยจะใช้คู่คีย์-ค่าเดียวในรูปแบบ "<key>=<value>" เป็นอาร์กิวเมนต์
แท็ก:changes_inputs
--[no]incompatible_default_to_explicit_init_py
ค่าเริ่มต้น: "false"-
Flag นี้จะเปลี่ยนลักษณะการทำงานเริ่มต้นเพื่อไม่ให้ระบบสร้างไฟล์ __init__.py โดยอัตโนมัติในไฟล์รันไทม์ของเป้าหมาย Python อีกต่อไป กล่าวโดยละเอียดคือ เมื่อเป้าหมาย py_binary หรือ py_test มีการตั้งค่า legacy_create_init เป็น "auto" (ค่าเริ่มต้น) ระบบจะถือว่าค่านี้เป็นเท็จก็ต่อเมื่อมีการตั้งค่า Flag นี้เท่านั้น ดู 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 ที่ระบุโดยชุดเครื่องมือ Python แทนรันไทม์ที่ระบุโดย Flag รุ่นเดิม เช่น --python_top
แท็ก:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
default: ดูคำอธิบาย-
โหมดเวอร์ชันหลักของ Python ไม่ว่าจะเป็น "PY2" หรือ "PY3" โปรดทราบว่าเป้าหมาย "py_binary" และ "py_test" จะลบล้างค่านี้ (แม้ว่าจะไม่ได้ระบุเวอร์ชันอย่างชัดเจน) จึงมักไม่มีเหตุผลที่จะต้องระบุแฟล็กนี้
แท็ก:loading_and_analysis
,affects_outputs
--target_pattern_file=<a string>
ค่าเริ่มต้น: ""-
หากตั้งค่าไว้ บิลด์จะอ่านรูปแบบจากไฟล์ที่ระบุชื่อไว้ที่นี่แทนที่จะเป็นในบรรทัดคำสั่ง การระบุไฟล์ที่นี่พร้อมกับรูปแบบบรรทัดคำสั่งจะเป็นข้อผิดพลาด
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล
- ค่าเริ่มต้นของ
--experimental_remote_cache_eviction_retries=<an integer>
: "0" -
จำนวนครั้งที่พยายามสูงสุดในการลองอีกครั้งหากบิลด์พบข้อผิดพลาดแคชระยะไกลชั่วคราวซึ่งจะทำให้บิลด์ไม่สำเร็จ มีผลบังคับใช้ เช่น เมื่อระบบนำรายการต่างๆ ออกจากแคชระยะไกล หรือในบางกรณีที่แคชไม่ทำงาน ค่าที่ไม่ใช่ 0 จะตั้งค่า --incompatible_remote_use_new_exit_code_for_lost_inputs เป็น "จริง" โดยปริยาย ระบบจะสร้างรหัสการเรียกใช้ใหม่สําหรับแต่ละครั้งที่พยายาม หากคุณสร้างรหัสการเรียกใช้และส่งให้กับ Bazel ด้วย --invocation_id คุณไม่ควรใช้ Flag นี้ แต่ให้ตั้งค่าสถานะ --incompatible_remote_use_new_exit_code_for_lost_inputs แล้วตรวจสอบโค้ดสำหรับออก 39
แท็ก:execution
- ค่าเริ่มต้น
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
: "true" -
หากตั้งค่าเป็น "จริง" Bazel จะใช้รหัสออกใหม่ 39 แทน 34 หากข้อผิดพลาดเกี่ยวกับแคชระยะไกล รวมถึงการลบแคชออกทําให้บิลด์ไม่สําเร็จ
แท็ก:incompatible_change
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้
--[no]allow_analysis_cache_discard
ค่าเริ่มต้น: "true"-
หากต้องการทิ้งแคชการวิเคราะห์เนื่องจากการเปลี่ยนแปลงในระบบการบิลด์ การตั้งค่าตัวเลือกนี้เป็นเท็จจะทำให้ bazel ออก แทนที่จะดำเนินการต่อด้วยการสร้าง ตัวเลือกนี้จะไม่มีผลเมื่อตั้งค่า "discard_analysis_cache" ด้วย
แท็ก:eagerness_to_exit
- ค่าเริ่มต้น
--[no]build_manual_tests
: "เท็จ" - บังคับให้สร้างเป้าหมายทดสอบที่ติดแท็ก "ด้วยตนเอง" ระบบจะไม่ประมวลผลการทดสอบที่ "ดำเนินการด้วยตนเอง" ตัวเลือกนี้จะบังคับให้ระบบสร้างรายงาน (แต่ไม่ต้องดำเนินการ)
--build_tag_filters=<comma-separated list of options>
ค่าเริ่มต้น: ""- ระบุรายการแท็กที่คั่นด้วยคอมมา แต่ละแท็กสามารถใส่เครื่องหมาย "-" ไว้ข้างหน้าได้เพื่อระบุแท็กที่ยกเว้น ระบบจะสร้างเฉพาะเป้าหมายที่มีแท็กที่รวมไว้อย่างน้อย 1 แท็กและไม่มีแท็กที่ยกเว้น ตัวเลือกนี้ไม่มีผลกับชุดการทดสอบที่ดำเนินการด้วยคําสั่ง "test" ซึ่งอยู่ภายใต้การควบคุมของตัวเลือกการกรองการทดสอบ เช่น "--test_tag_filters"
--[no]build_tests_only
ค่าเริ่มต้น: "false"- หากระบุ ระบบจะสร้างเฉพาะกฎ *_test และ test_suite และจะละเว้นเป้าหมายอื่นๆ ที่ระบุไว้ในบรรทัดคำสั่ง โดยค่าเริ่มต้น ระบบจะสร้างทุกอย่างที่ขอ
--[no]cache_test_results
[-t
] ค่าเริ่มต้น: "auto"- หากตั้งค่าเป็น "auto" ไว้ Bazel จะทำการทดสอบอีกครั้งก็ต่อเมื่อ (1) Bazel ตรวจพบการเปลี่ยนแปลงในการทดสอบหรือข้อมูลที่ต้องพึ่งพา (2) มีการทําเครื่องหมายการทดสอบว่าเป็นแบบภายนอก (3) มีคำขอการทดสอบหลายรายการด้วย --runs_per_test หรือ(4) การทดสอบก่อนหน้านี้ไม่สําเร็จ หากตั้งค่าเป็น "ใช่" Bazel จะแคชผลการทดสอบทั้งหมด ยกเว้นการทดสอบที่ทำเครื่องหมายว่าภายนอก หากตั้งค่าเป็น "ไม่" Bazel จะไม่แคชผลการทดสอบใดๆ
--[no]compile_one_dependency
ค่าเริ่มต้น: "false"- คอมไพล์ไฟล์อาร์กิวเมนต์แบบพึ่งพาไฟล์เดียว ซึ่งมีประโยชน์ในการตรวจสอบไวยากรณ์ของไฟล์ต้นทางใน IDE เช่น การสร้างเป้าหมายรายการเดียวขึ้นใหม่ซึ่งขึ้นอยู่กับไฟล์ต้นทางเพื่อตรวจหาข้อผิดพลาดได้เร็วที่สุดเท่าที่จะทำได้ในวงจรแก้ไข/สร้าง/ทดสอบ อาร์กิวเมนต์นี้จะส่งผลต่อวิธีตีความอาร์กิวเมนต์ที่ไม่ใช่ Flag ทั้งหมด โดยจะเป็นชื่อไฟล์ต้นทางแทนที่จะเป็นเป้าหมายที่จะสร้าง สำหรับชื่อไฟล์ต้นฉบับแต่ละชื่อไฟล์ จะมีเป้าหมายที่กำหนดเองที่ขึ้นอยู่กับไฟล์ดังกล่าว
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--deleted_packages=<comma-separated list of package names>
รายการ - รายการชื่อแพ็กเกจที่คั่นด้วยคอมมา ซึ่งระบบบิลด์จะถือว่าไม่มีอยู่ แม้ว่าจะปรากฏที่ใดก็ตามในเส้นทางแพ็กเกจ ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ ตัวอย่างเช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์แล้ว ระบบบิลด์อาจแสดงข้อผิดพลาดหากพบป้ายกำกับ "//x:y/z" หากยังมีรายการ package_path อื่นระบุอยู่ การระบุ --deleted_packages x/y จะช่วยหลีกเลี่ยงปัญหานี้ได้
--[no]discard_analysis_cache
ค่าเริ่มต้น: "false"- ทิ้งแคชการวิเคราะห์ทันทีที่ระยะการวิเคราะห์เสร็จสมบูรณ์ ลดการใช้งานหน่วยความจำประมาณ 10% แต่ทำให้บิลด์เพิ่มเติมช้าลง
--execution_log_binary_file=<a path>
default: ดูคำอธิบาย- บันทึกการสร้างผลิตภัณฑ์ที่ดำเนินการแล้วลงในไฟล์นี้เป็น Prot ของ SpawnExec ที่คั่นด้วยความยาว ตามข้อมูลใน src/main/protocolbuf/spawn.proto โปรดใช้ --execution_log_compact_file ซึ่งไฟล์มีขนาดเล็กกว่าและประหยัดค่าใช้จ่ายในการจัดทำได้อย่างมาก แฟล็กที่เกี่ยวข้อง: --execution_log_compact_file (รูปแบบกะทัดรัด ไม่เกี่ยวข้องกัน), --execution_log_json_file (รูปแบบข้อความ JSON; แยกเฉพาะ), --execution_log_sort (ไม่ว่าจะจัดเรียงบันทึกการดำเนินการหรือไม่), --subcommands (สำหรับแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
--execution_log_compact_file=<a path>
default: ดูคำอธิบาย- บันทึกการเริ่มที่ดำเนินการแล้วลงในไฟล์นี้เป็นโปรโตคอล ExecLogEntry ที่จำกัดความยาวตาม src/main/protobuf/spawn.proto ไฟล์ทั้งหมดได้รับการบีบอัด zstd Flag ที่เกี่ยวข้อง: --execution_log_binary_file (รูปแบบไบนารี protobuf; ใช้ร่วมกันไม่ได้), --execution_log_json_file (รูปแบบข้อความ JSON; ใช้ร่วมกันไม่ได้), --subcommands (สำหรับแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
--execution_log_json_file=<a path>
default: ดูคำอธิบาย- บันทึกการเริ่มที่ดำเนินการแล้วลงในไฟล์นี้เป็นการแสดงโปรโตคอล SpawnExec ในรูปแบบ JSON ที่คั่นด้วยการขึ้นบรรทัดใหม่ตาม src/main/protobuf/spawn.proto เลือกใช้ --execution_log_compact_file ซึ่งมีขนาดเล็กกว่ามากและต้นทุนในการผลิตถูกกว่า แฟล็กที่เกี่ยวข้อง: --execution_log_compact_file (รูปแบบกะทัดรัด แยกกันต่างหาก), --execution_log_binary_file (รูปแบบไบนารี, ไม่เกี่ยวข้องกัน), --execution_log_sort (ไม่ว่าจะจัดเรียงบันทึกการดำเนินการหรือไม่), --subcommands (สำหรับการแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
--[no]execution_log_sort
ค่าเริ่มต้น: "true"- เลือกว่าจะจัดเรียงบันทึกการดำเนินการหรือไม่ ซึ่งจะช่วยให้เปรียบเทียบบันทึกระหว่างการเรียกใช้ได้ง่ายขึ้น ตั้งค่าเป็นเท็จเพื่อหลีกเลี่ยงการใช้งาน CPU และหน่วยความจําที่อาจเกิดขึ้นเมื่อการเรียกใช้สิ้นสุดลง แต่จะต้องเสียค่าใช้จ่ายในการสร้างบันทึกในลําดับการดําเนินการที่ไม่ใช่แบบกำหนดได้ มีผลกับรูปแบบไบนารีและ JSON เท่านั้น ระบบจะไม่จัดเรียงรูปแบบกะทัดรัด
- ค่าเริ่มต้น
--[no]expand_test_suites
: "true" -
ขยายเป้าหมาย test_suite เป็นการทดสอบที่เกี่ยวข้องก่อนการวิเคราะห์ เมื่อเปิดใช้ Flag นี้ (ค่าเริ่มต้น) รูปแบบเป้าหมายเชิงลบจะมีผลกับทดสอบที่อยู่ในชุดทดสอบ มิเช่นนั้นจะไม่มีผล การปิดใช้ Flag นี้มีประโยชน์เมื่อใช้แง่มุมระดับบนสุดในบรรทัดคำสั่ง จากนั้นระบบจะวิเคราะห์เป้าหมาย test_suite ได้
แท็ก:loading_and_analysis
--[no]experimental_cancel_concurrent_tests
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" Blaze จะยกเลิกการทดสอบที่ทํางานพร้อมกันเมื่อการเรียกใช้ครั้งแรกสําเร็จ ซึ่งมีประโยชน์เมื่อใช้ร่วมกับ --runs_per_test_detects_flakes เท่านั้น
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "" - เลิกใช้งานไปทีละด้าน กรองชุดเป้าหมายเพื่อกําหนดเวลา extra_actions
--[no]experimental_extra_action_top_level_only
ค่าเริ่มต้น: "false"- เลิกใช้งานไปทีละด้าน ตั้งเวลาให้เฉพาะการดำเนินการเพิ่มเติมสำหรับเป้าหมายระดับบนสุดเท่านั้น
--[no]experimental_fetch_all_coverage_outputs
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" Bazel จะดึงข้อมูลไดเรกทอรีข้อมูลการครอบคลุมทั้งหมดสําหรับการทดสอบแต่ละครั้งในระหว่างการเรียกใช้การครอบคลุม
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" การครอบคลุมสำหรับ clang จะสร้างรายงาน LCOV
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
ค่าเริ่มต้น: "true"- เลือกว่าจะสร้างแผนที่ส่วนหัว J2ObjC ควบคู่ไปกับการแปลง J2ObjC หรือไม่
--[no]experimental_j2objc_shorter_header_path
ค่าเริ่มต้น: "false"-
พิจารณาว่าจะสร้างโดยใช้เส้นทางส่วนหัวที่สั้นลง (ใช้ "_ios" แทน "_j2objc") หรือไม่
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_java_classpath=<off, javabuilder or bazel>
: "javabuilder" - เปิดใช้เส้นทางคลาสที่ลดลงสำหรับการคอมไพล์ Java
- ค่าเริ่มต้น
--[no]experimental_limit_android_lint_to_android_constrained_java
: "เท็จ" -
จำกัด --experimental_run_android_lint_on_java_rules ไว้สำหรับไลบรารีที่เข้ากันได้กับ Android
แท็ก:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
ค่าเริ่มต้น: "false"-
ระบุว่าจะตรวจสอบแหล่งที่มา java_* หรือไม่
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]explicit_java_test_deps
: "เท็จ" - ระบุทรัพยากร Dependency ของ JUnit หรือ Hamcrest อย่างชัดเจนใน java_test แทนที่จะได้มาจาก Dep ของ TestRunner โดยไม่ตั้งใจ ขณะนี้ใช้ได้กับ Bazel เท่านั้น
- ค่าเริ่มต้น
--[no]fetch
: "true" - อนุญาตให้คําสั่งดึงข้อมูลการอ้างอิงภายนอก หากตั้งค่าเป็นเท็จ คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ หากไม่มี คำสั่งจะดำเนินการไม่สำเร็จ
--host_java_launcher=<a build target label>
default: ดูคำอธิบาย- Java Launcher ที่เครื่องมือใช้ซึ่งดำเนินการในระหว่างบิลด์
--host_javacopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง Javac เมื่อสร้างเครื่องมือที่ดำเนินการระหว่างบิลด์
--host_jvmopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ตัวเลือกเพิ่มเติมที่จะส่งไปยัง Java VM เมื่อสร้างเครื่องมือที่จะดำเนินการระหว่างการบิลด์ ระบบจะเพิ่มตัวเลือกเหล่านี้ลงในตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
- ค่าเริ่มต้น
--[no]incompatible_check_sharding_support
: "true" -
หากเป็น "จริง" Bazel จะทดสอบแบบแยกกลุ่มไม่สำเร็จหากเครื่องมือทดสอบไม่ได้ระบุว่ารองรับการแยกกลุ่มโดยแตะไฟล์ที่เส้นทางใน TEST_SHARD_STATUS_FILE หากเป็นเท็จ เครื่องมือรันทดสอบที่ไม่รองรับการแยกกลุ่มจะทำให้การทดสอบทั้งหมดทำงานในแต่ละกลุ่ม
แท็ก:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" การทดสอบเฉพาะจะทํางานด้วยกลยุทธ์ที่ใช้แซนด์บ็อกซ์ เพิ่มแท็ก "local" เพื่อบังคับให้ทำการทดสอบพิเศษในเครื่อง
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_strict_action_env
: "เท็จ" -
หากเป็น "จริง" Bazel จะใช้สภาพแวดล้อมที่มีค่าแบบคงที่สำหรับ PATH และไม่รับค่า LD_LIBRARY_PATH ไป ใช้ --action_env=ENV_VARIABLE หากต้องการรับค่าตัวแปรสภาพแวดล้อมที่เฉพาะเจาะจงจากไคลเอ็นต์ แต่โปรดทราบว่าการดำเนินการนี้อาจป้องกันไม่ให้แคชข้ามผู้ใช้หากใช้แคชที่แชร์
แท็ก:loading_and_analysis
,incompatible_change
--j2objc_translation_flags=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ตัวเลือกเพิ่มเติมที่จะส่งไปยังเครื่องมือ J2ObjC
--java_debug
-
ทําให้เครื่องเสมือน Java ของการทดสอบ Java รอการเชื่อมต่อจากโปรแกรมแก้ไขข้อบกพร่องที่เป็นไปตามข้อกําหนดของ JDWP (เช่น jdb) ก่อนเริ่มการทดสอบ บอกเป็นนัยว่า -test_output=streamed
ขยายเป็น
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- ค่าเริ่มต้น
--[no]java_deps
: "true" - สร้างข้อมูลการพึ่งพา (ตอนนี้คือ classpath ขณะคอมไพล์) ต่อเป้าหมาย Java
--[no]java_header_compilation
ค่าเริ่มต้น: "true"- คอมไพล์ ijars จากแหล่งที่มาโดยตรง
--java_language_version=<a string>
ค่าเริ่มต้น: ""- เวอร์ชันภาษา Java
--java_launcher=<a build target label>
default: ดูคำอธิบาย- โปรแกรมเปิด Java ที่จะใช้ในการสร้างไบนารี Java หากตั้งค่า Flag นี้เป็นสตริงว่าง ระบบจะใช้ตัวเปิด 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>
default: ดูคำอธิบาย- ระบุไบนารีที่จะใช้สร้างรายการคลาสที่ต้องอยู่ใน Dex หลักเมื่อคอมไพล์ MultiDex รุ่นเดิม
--local_termination_grace_seconds=<an integer>
ค่าเริ่มต้น: "15"- เวลาที่ต้องรอระหว่างการสิ้นสุดกระบวนการในเครื่องเนื่องจากหมดเวลาและบังคับให้ปิดกระบวนการดังกล่าว
- ค่าเริ่มต้น
--optimizing_dexer=<a build target label>
: ดูคำอธิบาย - ระบุไบนารีที่จะใช้ในการจัดทําดัชนีโดยไม่มีการแยกข้อมูล
--package_path=<colon-separated list of options>
ค่าเริ่มต้น: "%workspace%"- รายการตำแหน่งที่จะค้นหาแพ็กเกจที่คั่นด้วยโคลอน องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับเวิร์กスペースที่ล้อมรอบ หากละเว้นหรือว่างเปล่า ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
--plugin=<a build target label>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ปลั๊กอินที่จะใช้ในบิลด์ ปัจจุบันใช้ได้กับ java_plugin
- ค่าเริ่มต้น
--proguard_top=<a build target label>
: ดูคำอธิบาย - ระบุเวอร์ชันของ ProGuard ที่จะใช้สำหรับการนำโค้ดออกเมื่อสร้างไบนารี Java
--proto_compiler=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/proto:protoc"-
ป้ายกำกับของคอมไพเลอร์โปรโต
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/proto:cc_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ C++ protos
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/j2objc:j2objc_protocol_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ j2objc protos
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/proto:java_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์โปรโตคอล Java
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/proto:javalite_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์โปรโตคอล JavaLite
แท็ก:affects_outputs
,loading_and_analysis
--protocopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมในการส่งไปยังคอมไพเลอร์ Protocolbuf
แท็ก:affects_outputs
--[no]runs_per_test_detects_flakes
ค่าเริ่มต้น: "false"- หากเป็น "จริง" ข้อมูลพร็อพเพอร์ตี้ที่รัน/พยายามอย่างน้อย 1 ครั้งผ่านและรัน/พยายามอย่างน้อย 1 ครั้งไม่ผ่านจะได้รับสถานะ "ไม่เสถียร"
--shell_executable=<a path>
default: ดูคำอธิบาย-
เส้นทางสัมบูรณ์ไปยังเชลล์ปฏิบัติการสำหรับ Bazel เพื่อใช้งาน หากไม่ได้ตั้งค่านี้ แต่มีการตั้งค่าตัวแปรสภาพแวดล้อม BAZEL_SH ในการเรียกใช้ Bazel ครั้งแรก (ซึ่งจะเริ่มต้นเซิร์ฟเวอร์ Bazel) Bazel จะใช้ตัวแปรนั้น หากไม่ได้ตั้งค่าค่าใดเลย Bazel จะใช้เส้นทางเริ่มต้นแบบฮาร์ดโค้ดโดยขึ้นอยู่กับระบบปฏิบัติการที่ใช้ (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, อื่นๆ ทั้งหมด: /bin/bash) โปรดทราบว่าการใช้เชลล์ที่เข้ากันไม่ได้กับ bash อาจทําให้การสร้างไม่สําเร็จหรือรันไทม์ของไบนารีที่สร้างขึ้นไม่สําเร็จ
แท็ก:loading_and_analysis
--[no]show_loading_progress
ค่าเริ่มต้น: "true"- หากเปิดใช้ จะทำให้ Bazel พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ:"
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--test_arg=<a string>
รายการ - ระบุตัวเลือกและอาร์กิวเมนต์เพิ่มเติมที่ควรส่งไปยังไฟล์ปฏิบัติการทดสอบ ใช้หลายครั้งเพื่อระบุอาร์กิวเมนต์หลายรายการได้ หากทำการทดสอบหลายรายการ แต่ละรายการจะได้รับอาร์กิวเมนต์ที่เหมือนกัน ใช้โดยคำสั่ง "bazel test" เท่านั้น
- ค่าเริ่มต้น
--test_filter=<a string>
: ดูคำอธิบาย - ระบุตัวกรองที่จะส่งต่อไปยังเฟรมเวิร์กการทดสอบ ใช้เพื่อจำกัดการทดสอบ โปรดทราบว่าการเปลี่ยนแปลงนี้ไม่มีผลต่อเป้าหมายที่สร้างขึ้น
--test_lang_filters=<comma-separated list of options>
ค่าเริ่มต้น: ""- ระบุรายการภาษาทดสอบที่คั่นด้วยคอมมา คุณใส่เครื่องหมาย "-" ไว้หน้าแต่ละภาษาเพื่อระบุภาษาที่ยกเว้นได้ ระบบจะค้นหาเฉพาะเป้าหมายการทดสอบที่เขียนในภาษาที่ระบุ ชื่อที่ใช้สำหรับแต่ละภาษาควรเหมือนกับคำนำหน้าภาษาในกฎ *_test เช่น "cc", "java", "py" เป็นต้น ตัวเลือกนี้จะส่งผลต่อลักษณะการทํางานของ --build_tests_only และคำสั่งทดสอบ
- ค่าเริ่มต้นของ
--test_result_expiration=<an integer>
: "-1" - ตัวเลือกนี้เลิกใช้งานแล้วและไม่มีผล
--[no]test_runner_fail_fast
ค่าเริ่มต้น: "false"- การส่งต่อตัวเลือกแบบเร็วไม่สำเร็จไปยังตัวดำเนินการทดสอบ โปรแกรมรันทดสอบควรหยุดการดําเนินการเมื่อเกิดความผิดพลาดครั้งแรก
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
ค่าเริ่มต้น: "explicit"- ระบุกลยุทธ์สำหรับการแยกกลุ่มทดสอบ: "explicit" เพื่อใช้การแยกกลุ่มเฉพาะในกรณีที่มีแอตทริบิวต์ BUILD "shard_count" เท่านั้น "disabled" เพื่อไม่ให้ใช้การแยกกลุ่มทดสอบ 'forced=k' เพื่อบังคับใช้กลุ่ม "k" สำหรับการทดสอบโดยไม่คำนึงถึงแอตทริบิวต์ BUILD "shard_count"
- ค่าเริ่มต้นของ
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
: "" - ระบุรายการขนาดทดสอบที่คั่นด้วยคอมมา แต่ละขนาดจะมีเครื่องหมาย "-" นำหน้าเพื่อระบุขนาดที่ยกเว้น ระบบจะค้นหาเฉพาะเป้าหมายการทดสอบที่มีขนาดที่รวมไว้อย่างน้อย 1 ขนาดและไม่มีขนาดที่ยกเว้น ตัวเลือกนี้จะมีผลกับลักษณะการทำงาน --build_tests_only และคำสั่งทดสอบ
--test_tag_filters=<comma-separated list of options>
ค่าเริ่มต้น: ""- ระบุรายการแท็กทดสอบที่คั่นด้วยคอมมา แต่ละแท็กสามารถใส่เครื่องหมาย "-" ไว้ข้างหน้าได้เพื่อระบุแท็กที่ยกเว้น ระบบจะค้นหาเฉพาะเป้าหมายการทดสอบที่มีแท็กที่รวมไว้อย่างน้อย 1 แท็กและไม่มีแท็กที่ยกเว้น ตัวเลือกนี้จะมีผลกับลักษณะการทำงาน --build_tests_only และคำสั่งทดสอบ
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
ค่าเริ่มต้น: ""- ระบุรายการการหมดเวลาการทดสอบที่คั่นด้วยคอมมา คุณใส่เครื่องหมาย "-" ไว้หน้าการหมดเวลาแต่ละรายการเพื่อระบุการหมดเวลาที่ยกเว้นได้ ระบบจะค้นหาเฉพาะเป้าหมายการทดสอบที่มีระยะหมดเวลาที่รวมไว้อย่างน้อย 1 รายการและไม่มีระยะหมดเวลาที่ยกเว้น ตัวเลือกนี้จะส่งผลต่อลักษณะการทํางานของ --build_tests_only และคำสั่งทดสอบ
--tool_java_language_version=<a string>
ค่าเริ่มต้น: ""- เวอร์ชันภาษา Java ที่ใช้ในการเรียกใช้เครื่องมือที่จําเป็นในระหว่างการสร้าง
--tool_java_runtime_version=<a string>
ค่าเริ่มต้น: "remotejdk_11"- เวอร์ชันรันไทม์ Java ที่ใช้ในการเรียกใช้เครื่องมือระหว่างการสร้าง
--[no]use_ijars
ค่าเริ่มต้น: "true"- หากเปิดใช้ ตัวเลือกนี้จะทําให้คอมไพล์ Java ใช้ JAR อินเทอร์เฟซ ซึ่งจะส่งผลให้การคอมไพล์แบบเพิ่มประสิทธิภาพเร็วขึ้น แต่ข้อความแสดงข้อผิดพลาดอาจแตกต่างกัน
ตัวเลือก Canonicalize-flags
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคําสั่งและได้รับการแยกวิเคราะห์โดยไคลเอ็นต์
--distdir=<a path>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนที่จะเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บข้อมูลจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบในแคชแทนการคัดลอก การดำเนินการนี้มีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งที่พยายามลองอีกครั้งสูงสุดสำหรับข้อผิดพลาดในการดาวน์โหลด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองอีกครั้ง
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับเวลาหมดอายุทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ช่วยให้รีโพซิทอรีภายนอกทํางานบนเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้น
--[no]incompatible_disable_native_repo_rules
: "เท็จ" -
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
default: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการเรียกข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช มิเช่นนั้นระบบจะใช้ค่าเริ่มต้นของ "<output_user_root>/cache/repos/v1"
แท็ก:bazel_internal_configuration
--[no]repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลพื้นที่เก็บข้อมูล โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้อย่างสมบูรณ์ ctx.execute อาจยังคงเรียกใช้ไฟล์ที่เรียกใช้งานได้แบบกำหนดเองซึ่งเข้าถึงอินเทอร์เน็ตได้
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
--gc_thrashing_threshold=<an integer in 0-100 range>
ค่าเริ่มต้น: "100"-
เปอร์เซ็นต์ของพื้นที่เก็บข้อมูลแบบ Tenure ที่ใช้งานอยู่ (0-100) ซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์ความกดดันของหน่วยความจําเทียบกับขีดจํากัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ควบคุมเอาต์พุตของคําสั่ง
- ค่าเริ่มต้น
--[no]canonicalize_policy
: "เท็จ" -
แสดงนโยบาย Canonical หลังจากการขยายและการกรอง ระบบจะไม่แสดงอาร์กิวเมนต์คำสั่งที่เปลี่ยนรูปแบบแล้วเมื่อตั้งค่าตัวเลือกนี้เป็น "จริง" เพื่อให้เอาต์พุตสะอาด โปรดทราบว่าคำสั่งที่ระบุโดย --for_command จะส่งผลต่อนโยบายที่กรอง และหากไม่มีการระบุไว้ คำสั่งเริ่มต้นจะเป็น "build"
แท็ก:affects_outputs
,terminal_output
- ค่าเริ่มต้น
--[no]experimental_include_default_values
: "เท็จ" -
การรวมตัวเลือก Starlark ที่ตั้งค่าเป็นค่าเริ่มต้นไว้ในเอาต์พุต
แท็ก:affects_outputs
,terminal_output
- ตัวเลือกนี้จะส่งผลต่อความหมายของภาษา Starlark หรือ API การสร้างที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
--[no]incompatible_config_setting_private_default_visibility
ค่าเริ่มต้น: "false"-
หาก incompatible_enforce_config_setting_visibility=false จะไม่มีการดำเนินการใดๆ หรือหาก Flag นี้เป็นเท็จ config_setting ที่ไม่มีแอตทริบิวต์ระดับการมองเห็นที่ชัดเจนจะเป็น //visibility:public หาก Flag นี้เป็น "จริง" config_setting จะใช้ตรรกะการแสดงผลเดียวกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ระบบจะบังคับใช้ข้อจำกัดการแสดงผลของ config_setting หากเป็นเท็จ เป้าหมายทุกรายการจะเห็น config_setting ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod มีดังนี้
--allow_yanked_versions=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะอนุญาตในกราฟ Dependency ที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่ามีการดึงออกในรีจิสทรีที่มาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น การดึงเวอร์ชันออกจะทำให้การแก้ไขไม่สำเร็จ นอกจากนี้ คุณยังกำหนดเวอร์ชันที่ดึงออกได้โดยใช้ตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็ก:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ" "off" เพื่อปิดใช้การตรวจสอบ หรือ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน
แท็ก:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่า Dependency ของ `bazel_dep` โดยตรงที่ประกาศไว้ในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟ Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ใช้ได้คือ "off" เพื่อปิดใช้การตรวจสอบ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน หรือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ"
แท็ก:loading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นข้อกำหนดในการพัฒนาเหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูท ไม่ว่าค่าของ Flag นี้จะเป็นอย่างไรก็ตาม
แท็ก:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
ค่าเริ่มต้น: "update"-
ระบุวิธีและวิธีใช้ล็อกไฟล์ ค่าที่ถูกต้องคือ "อัปเดต" เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง "รีเฟรช" เพื่อรีเฟรชข้อมูลที่เปลี่ยนแปลงได้เพิ่มเติม (เวอร์ชันที่แยกออกมาและโมดูลที่หายไปก่อนหน้านี้) จากรีจิสทรีระยะไกลเป็นครั้งคราว "ข้อผิดพลาด" ในการใช้ไฟล์ล็อกแต่เกิดข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่อไม่อ่านหรือเขียนไปยังไฟล์ล็อก
แท็ก:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างโมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีทํางานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้านี้ออก
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--registry=<a string>
รายการ -
ระบุรีจิสทรีที่จะใช้ค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับเป็นสิ่งสำคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีในภายหลังเมื่อไม่มีรีจิสทรีที่ขาดหายไป
แท็ก:changes_inputs
--vendor_dir=<a path>
default: ดูคำอธิบาย-
ระบุไดเรกทอรีที่ควรเก็บที่เก็บข้อมูลภายนอกในโหมดผู้ให้บริการ ไม่ว่าจะเป็นเพื่อดึงข้อมูลมายังไดเรกทอรีดังกล่าวหรือใช้ขณะสร้าง เส้นทางอาจเป็นเส้นทางแบบสัมบูรณ์หรือเส้นทางแบบสัมพัทธ์กับไดเรกทอรีของพื้นที่ทำงานก็ได้
แท็ก:loading_and_analysis
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพของเวลาสร้าง
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
ค่าเริ่มต้น: "1s:2,20s:3,1m:5"-
ขีดจํากัดที่หากถึงแล้วจะทำให้ GcThrashingDetector ทำให้ Bazel ขัดข้องด้วย OOM โดยระบุขีดจํากัดแต่ละรายการเป็น <period>:<count> โดยที่ period คือระยะเวลา และ count คือจํานวนเต็มบวก หากมีการใช้งานพื้นที่ที่คงไว้ (ฮีป Gen เก่า) เกินกว่า --gc_thrashing_threshold เปอร์เซ็นต์ของพื้นที่ที่คงไว้ (ฮีปของ Gen เดิม) หลังจาก GC เต็ม <count> ตัวติดต่อกันภายใน <period> จะมีการทริกเกอร์ OOM คุณระบุขีดจำกัดหลายรายการได้โดยคั่นด้วยเครื่องหมายจุลภาค
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC แบบเต็มขึ้น ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนครั้งต่อครั้งที่เรียกใช้ ค่าเริ่มต้นเป็น Integer.MAX_VALUE โดยไม่มีขีดจำกัด 0 หมายความว่าเหตุการณ์ GC แบบสมบูรณ์จะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC แบบเต็มและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC เล็กน้อยขึ้น ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนนี้ต่อการเรียกใช้แต่ละครั้ง ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด 0 หมายความว่าเหตุการณ์ GC เล็กน้อยจะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC เล็กน้อยและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์กองที่เก็บไว้อย่างน้อยถึงเกณฑ์นี้ ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็น การปรับแต่งค่านี้อาจช่วยลดผลกระทบต่อเวลาจริงของการกระชาก GC เมื่อการกระชาก GC (1) เกิดจากการใช้งานหน่วยความจําของสถานะชั่วคราวนี้ และ (2) เสียค่าใช้จ่ายมากกว่าการสร้างสถานะใหม่เมื่อจําเป็น
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก
- ค่าเริ่มต้น
--experimental_command_profile=<cpu, wall, alloc or lock>
: ดูคำอธิบาย - บันทึกโปรไฟล์ Java Flight Recorder ตลอดระยะเวลาของคำสั่ง คุณต้องระบุประเภทเหตุการณ์โปรไฟล์ที่รองรับ (cpu, wall, alloc หรือ lock) รายการใดรายการหนึ่งเป็นอาร์กิวเมนต์ ระบบจะเขียนโปรไฟล์ลงในไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ในไดเรกทอรีฐานเอาต์พุต ไวยากรณ์และความหมายของแฟล็กนี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับประเภทโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม คุณต้องยอมรับความเสี่ยงที่เกิดขึ้นเอง
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจำกัดอยู่ที่ 20 รายการที่มีการกระทำมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับคําช่วยจําทั้งหมด
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ใช่ค่าว่าง ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
--for_command=<a string>
ค่าเริ่มต้น: "build"-
คำสั่งที่ควรเปลี่ยนรูปแบบตัวเลือก
แท็ก:affects_outputs
,terminal_output
- ค่าเริ่มต้น
--invocation_policy=<a string>
: "" -
ใช้นโยบายการเรียกใช้กับตัวเลือกที่จะกำหนดให้เป็นหน้า Canonical
แท็ก:affects_outputs
,terminal_output
- ตัวเลือกการแคชและการดำเนินการระยะไกล
- ค่าเริ่มต้น
--experimental_downloader_config=<a string>
: ดูคำอธิบาย - ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะขึ้นต้นด้วยคําสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สําหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ โดยรูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้แทน URL โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณระบุคําสั่ง `rewrite` หลายรายการสําหรับ URL เดียวกันได้ และในกรณีนี้ระบบจะแสดงผล URL หลายรายการ
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
ค่าเริ่มต้น: "auto"- โหมดการแยกชุดข้อความที่จะใช้ดึงข้อมูลรีโป หากตั้งค่าเป็น "ปิด" ระบบจะไม่ใช้เธรดสำหรับงานและการดึงข้อมูลรีโปจะขึ้นอยู่กับการรีสตาร์ท ไม่เช่นนั้นจะใช้เธรดผู้ทํางานเสมือน
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
--deleted_packages=<comma-separated list of package names>
ระบบจะรวบรวมการใช้งานหลายครั้ง- รายการชื่อแพ็กเกจที่คั่นด้วยคอมมา ซึ่งระบบบิลด์จะถือว่าไม่มีอยู่ แม้ว่าจะปรากฏในเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ ตัวอย่างเช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์ของคุณ ระบบบิลด์อาจบ่นหากพบป้ายกำกับ "//x:y/z" หากยังพบป้ายกำกับโดยรายการpackage_path อื่นอยู่ การระบุ --deleted_packages x/y จะช่วยหลีกเลี่ยงปัญหานี้ได้
--[no]fetch
ค่าเริ่มต้น: "true"- อนุญาตให้คําสั่งดึงข้อมูลการอ้างอิงภายนอก หากตั้งค่าเป็นเท็จ คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ หากไม่มี คำสั่งจะดำเนินการไม่สำเร็จ
--override_repository=<an equals-separated mapping of repository name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างที่เก็บโดยใช้เส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้าออก
- ค่าเริ่มต้นของ
--package_path=<colon-separated list of options>
: "%workspace%" - รายการตำแหน่งที่จะค้นหาแพ็กเกจที่คั่นด้วยโคลอน องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับเวิร์กスペースที่ล้อมรอบ หากละเว้นหรือว่างเปล่า ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
--[no]show_loading_progress
ค่าเริ่มต้น: "true"- หากเปิดใช้ จะทำให้ Bazel พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ:"
ตัวเลือกการล้าง
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคําสั่งและได้รับการแยกวิเคราะห์โดยไคลเอ็นต์
--distdir=<a path>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนที่จะเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชของที่เก็บจะลิงก์ไฟล์แบบถาวรในกรณีที่มีการเกิดแคชแทนที่จะคัดลอก การดำเนินการนี้มีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งที่พยายามลองอีกครั้งสูงสุดสำหรับข้อผิดพลาดในการดาวน์โหลด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองอีกครั้ง
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับเวลาหมดอายุทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
ค่าเริ่มต้น: "false"-
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎของรีโปเนทีฟ ได้แก่ local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
default: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลรีโพซิทอรี่ภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช มิเช่นนั้นระบบจะใช้ค่าเริ่มต้นของ "<output_user_root>/cache/repos/v1"
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]repository_disable_download
: "เท็จ" -
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลพื้นที่เก็บข้อมูล โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้อย่างสมบูรณ์ ctx.execute อาจยังคงเรียกใช้ไฟล์ที่เรียกใช้งานได้แบบกำหนดเองซึ่งเข้าถึงอินเทอร์เน็ตได้
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
--gc_thrashing_threshold=<an integer in 0-100 range>
ค่าเริ่มต้น: "100"-
เปอร์เซ็นต์ของพื้นที่เก็บข้อมูลแบบ Tenure ที่ใช้งานอยู่ (0-100) ซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์ความกดดันของหน่วยความจําเทียบกับขีดจํากัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่งมีดังนี้
--[no]async
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" การล้างเอาต์พุตจะเป็นแบบไม่พร้อมกัน เมื่อคำสั่งนี้เสร็จสมบูรณ์แล้ว คุณจะเรียกใช้คำสั่งใหม่ในไคลเอ็นต์เดียวกันได้อย่างปลอดภัย แม้ว่าการลบจะยังคงดำเนินต่อไปในเบื้องหลัง
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้น
--[no]expunge
: "เท็จ" -
หากเป็น "จริง" การล้างจะนำโครงสร้างการทำงานทั้งหมดของอินสแตนซ์ Bazel ออก ซึ่งรวมถึงไฟล์ชั่วคราวและสร้างไฟล์เอาต์พุตที่สร้างขึ้นด้วย Bazel ทั้งหมด และหยุดเซิร์ฟเวอร์ bazel หากทำงาน
แท็ก:host_machine_resource_optimizations
--expunge_async
-
หากระบุไว้ clean จะนําทั้งทรีทํางานสําหรับอินสแตนซ์ Bazel นี้ออกแบบไม่สอดคล้องกัน ซึ่งรวมถึงไฟล์เอาต์พุตและไฟล์ชั่วคราวทั้งหมดที่ Bazel สร้างขึ้น และหยุดเซิร์ฟเวอร์ Bazel หากทํางานอยู่ เมื่อคำสั่งนี้เสร็จสมบูรณ์แล้ว คุณจะเรียกใช้คำสั่งใหม่ในไคลเอ็นต์เดียวกันได้อย่างปลอดภัย แม้ว่าการลบจะยังคงดำเนินต่อไปในเบื้องหลัง
ขยายเป็น
--expunge
--async
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะอนุญาตในกราฟ Dependency ที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่ามีการดึงออกในรีจิสทรีที่มาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น การดึงเวอร์ชันออกจะทำให้การแก้ไขไม่สำเร็จ นอกจากนี้ คุณยังกำหนดเวอร์ชันที่ดึงออกได้โดยใช้ตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็ก:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ" "off" เพื่อปิดใช้การตรวจสอบ หรือ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน
แท็ก:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่า Dependency ของ `bazel_dep` โดยตรงที่ประกาศไว้ในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟ Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ใช้ได้คือ "off" เพื่อปิดใช้การตรวจสอบ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน หรือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ"
แท็ก:loading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นข้อกำหนดในการพัฒนาเหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูท ไม่ว่าค่าของ Flag นี้จะเป็นอย่างไรก็ตาม
แท็ก:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
ค่าเริ่มต้น: "update"-
ระบุวิธีและระบุว่าจะใช้ไฟล์ล็อกหรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ไฟล์ล็อกและอัปเดตไฟล์หากมีการเปลี่ยนแปลง "refresh" เพื่อรีเฟรชข้อมูลที่เปลี่ยนแปลงได้เพิ่มเติม (เวอร์ชันที่ยกเลิกและโมดูลที่ขาดหายไปก่อนหน้านี้) จากรีจิสทรีระยะไกลเป็นครั้งคราว "error" เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่เป็นปัจจุบัน หรือ "off" เพื่อไม่อ่านหรือเขียนลงในไฟล์ล็อก
แท็ก: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>
default: ดูคำอธิบาย-
ระบุไดเรกทอรีที่ควรเก็บที่เก็บข้อมูลภายนอกในโหมดผู้ให้บริการ ไม่ว่าจะเป็นเพื่อดึงข้อมูลมายังไดเรกทอรีดังกล่าวหรือใช้ขณะสร้าง เส้นทางอาจเป็นเส้นทางแบบสัมบูรณ์หรือเส้นทางแบบสัมพัทธ์กับไดเรกทอรีของพื้นที่ทำงานก็ได้
แท็ก:loading_and_analysis
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพของเวลาสร้างมีดังนี้
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
ค่าเริ่มต้น: "1s:2,20s:3,1m:5"-
ขีดจำกัดที่หากถึงจะทำให้ GcThrashingDetector ทำให้ Bazel ขัดข้องด้วย OOM โดยระบุขีดจํากัดแต่ละรายการเป็น <period>:<count> โดยที่ period คือระยะเวลา และ count คือจํานวนเต็มบวก หากมีการใช้งานพื้นที่ที่คงไว้ (ฮีป Gen เก่า) เกินกว่า --gc_thrashing_threshold เปอร์เซ็นต์ของพื้นที่ที่คงไว้ (ฮีปของ Gen เดิม) หลังจาก GC เต็ม <count> ตัวติดต่อกันภายใน <period> จะมีการทริกเกอร์ OOM คุณสามารถระบุขีดจํากัดหลายรายการโดยคั่นด้วยคอมมา
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
แฟล็กสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC แบบเต็มขึ้น ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนครั้งต่อครั้งที่เรียกใช้ ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด 0 หมายความว่าเหตุการณ์ GC แบบสมบูรณ์จะไม่ทริกเกอร์การลดลง หากถึงขีดจำกัด สถานะ Skyframe จะไม่ลดลงอีกต่อไปเมื่อเกิดเหตุการณ์ GC เต็มรูปแบบและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
แฟล็กสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC เล็กน้อย ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนนี้ต่อการเรียกใช้แต่ละครั้ง ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด ค่า 0 หมายความว่ากิจกรรม GC ที่ไม่สำคัญมากจะไม่ทำให้ลดลงเลย หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC ย่อยและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์กองที่เก็บไว้อย่างน้อยถึงเกณฑ์นี้ ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็น การปรับแต่งค่านี้อาจช่วยลดผลกระทบต่อเวลาจริงของการกระหน่ำ GC เมื่อการกระหน่ำ GC (1) เกิดจากการใช้งานหน่วยความจําของสถานะชั่วคราวนี้ และ (2) เสียค่าใช้จ่ายมากกว่าการสร้างสถานะใหม่เมื่อจําเป็น
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ส่งผลต่อรายละเอียด รูปแบบ หรือตำแหน่งของการบันทึก
- ค่าเริ่มต้น
--experimental_command_profile=<cpu, wall, alloc or lock>
: ดูคำอธิบาย - บันทึกโปรไฟล์ Java Flight Recorder ตลอดระยะเวลาของคำสั่ง คุณต้องระบุประเภทเหตุการณ์โปรไฟล์ที่รองรับ (cpu, wall, alloc หรือ lock) รายการใดรายการหนึ่งเป็นอาร์กิวเมนต์ โปรไฟล์จะเขียนไปยังไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ภายใต้ไดเรกทอรีฐานเอาต์พุต รูปแบบคำสั่งและความหมายของแฟล็กนี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับประเภทโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม โปรดใช้โดยยอมรับความเสี่ยงเอง
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจํากัดไว้ที่คําช่วยจํา 20 รายการที่มีการดําเนินการมากที่สุด การตั้งค่าตัวเลือกนี้จะเป็นการเขียนสถิติสำหรับการช่วยจำทั้งหมด
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ค่าเริ่มต้น
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
หากไม่ใช่ค่าว่าง ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการระยะไกล
--experimental_downloader_config=<a string>
default: ดูคำอธิบาย- ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะขึ้นต้นด้วยคําสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สําหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ โดยรูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้แทน URL โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณอาจระบุคําสั่ง `rewrite` หลายรายการสําหรับ URL เดียวกันได้ ซึ่งในกรณีนี้ระบบจะแสดงผล URL หลายรายการ
- ค่าเริ่มต้น
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "อัตโนมัติ" - โหมดการแยกชุดข้อความที่จะใช้ดึงข้อมูลรีโป หากตั้งค่าเป็น "ปิด" ระบบจะไม่ใช้เธรดสำหรับงานและการดึงข้อมูลรีโปจะขึ้นอยู่กับการรีสตาร์ท ไม่เช่นนั้นจะใช้เธรดผู้ทํางานเสมือน
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
--override_repository=<an equals-separated mapping of repository name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างที่เก็บโดยใช้เส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีทํางานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้าออก
ตัวเลือกการกําหนดค่า
ตัวเลือกความคุ้มครอง
รับค่าตัวเลือกทั้งหมดจาก test
- ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บข้อมูลจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบในแคชแทนการคัดลอก การดำเนินการนี้มีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งที่พยายามลองอีกครั้งสูงสุดสำหรับข้อผิดพลาดในการดาวน์โหลด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองอีกครั้ง
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับเวลาหมดอายุทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ช่วยให้รีโพซิทอรีภายนอกทํางานบนเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
ค่าเริ่มต้น: "false"-
หากเป็นเท็จ จะใช้กฎของรีโปเดิมใน WORKSPACE ได้ หากเป็นจริง ต้องใช้กฎของรีโป Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูคำอธิบาย -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลรีโพซิทอรี่ภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช มิเช่นนั้นระบบจะใช้ค่าเริ่มต้นของ "<output_user_root>/cache/repos/v1"
แท็ก:bazel_internal_configuration
--[no]repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลที่เก็บ โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้อย่างสมบูรณ์ ctx.execute อาจยังคงเรียกใช้ไฟล์ที่เรียกใช้งานได้แบบกำหนดเองซึ่งเข้าถึงอินเทอร์เน็ตได้
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
--gc_thrashing_threshold=<an integer in 0-100 range>
ค่าเริ่มต้น: "100"-
เปอร์เซ็นต์ของพื้นที่เก็บข้อมูลแบบ Tenure ที่ใช้งานอยู่ (0-100) ซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์ความกดดันของหน่วยความจําเทียบกับขีดจํากัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะอนุญาตในกราฟ Dependency ที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่ามีการดึงออกในรีจิสทรีที่มาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น การดึงเวอร์ชันออกจะทำให้การแก้ไขไม่สำเร็จ นอกจากนี้ คุณยังกำหนดเวอร์ชันลบที่อนุญาตด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" ได้ด้วย คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็ก:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" ที่ส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" ให้พิมพ์คำเตือนเมื่อตรวจพบข้อมูลที่ไม่ตรงกัน
แท็ก:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่า Dependency ของ `bazel_dep` โดยตรงที่ประกาศไว้ในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟ Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ใช้ได้คือ "off" เพื่อปิดใช้การตรวจสอบ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน หรือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ"
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นข้อกำหนดในการพัฒนาเหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูท ไม่ว่าค่าของ Flag นี้จะเป็นอย่างไรก็ตาม
แท็ก:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
ค่าเริ่มต้น: "update"-
ระบุวิธีและระบุว่าจะใช้ไฟล์ล็อกหรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ไฟล์ล็อกและอัปเดตไฟล์หากมีการเปลี่ยนแปลง "refresh" เพื่อรีเฟรชข้อมูลที่เปลี่ยนแปลงได้เพิ่มเติม (เวอร์ชันที่ยกเลิกและโมดูลที่ขาดหายไปก่อนหน้านี้) จากรีจิสทรีระยะไกลเป็นครั้งคราว "error" เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่เป็นปัจจุบัน หรือ "off" เพื่อไม่อ่านหรือเขียนลงในไฟล์ล็อก
แท็ก:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างโมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีทํางานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้านี้ออก
--registry=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้ค้นหาทรัพยากร Dependency ของโมดูล Bazel ลําดับมีความสําคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะเปลี่ยนไปใช้รีจิสทรีที่ใหม่กว่าก็ต่อเมื่อไม่มีโมดูลที่ต้องการในรีจิสทรีก่อนหน้า
แท็ก:changes_inputs
--vendor_dir=<a path>
default: ดูคำอธิบาย-
ระบุไดเรกทอรีที่ควรเก็บที่เก็บข้อมูลภายนอกในโหมดผู้ให้บริการ ไม่ว่าจะเป็นเพื่อดึงข้อมูลมายังไดเรกทอรีดังกล่าวหรือใช้ขณะสร้าง คุณสามารถระบุเส้นทางเป็นเส้นทางสัมบูรณ์หรือเส้นทางที่สัมพันธ์กับไดเรกทอรีพื้นที่ทำงานก็ได้
แท็ก:loading_and_analysis
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพของเวลาบิลด์
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
ค่าเริ่มต้น: "1s:2,20s:3,1m:5"-
ขีดจํากัดที่หากถึงแล้วจะทำให้ GcThrashingDetector ทำให้ Bazel ขัดข้องด้วย OOM โดยระบุขีดจํากัดแต่ละรายการเป็น <period>:<count> โดยที่ period คือระยะเวลา และ count คือจํานวนเต็มบวก หากมีการใช้พื้นที่ที่มีการจัดสรรไว้ (ฮีปรุ่นเก่า) มากกว่า --gc_thrashing_threshold เปอร์เซ็นต์หลังจากการเรียกใช้ GC แบบเต็มติดต่อกัน <count> ครั้งภายใน <period> ระบบจะเรียกใช้ OOM คุณระบุขีดจำกัดหลายรายการได้โดยคั่นด้วยเครื่องหมายจุลภาค
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC แบบเต็มขึ้น ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนครั้งต่อครั้งที่เรียกใช้ ค่าเริ่มต้นคือจำนวนเต็มMAX_VALUE โดยไม่มีขีดจำกัด 0 หมายความว่าเหตุการณ์ GC แบบสมบูรณ์จะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC แบบเต็มและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
แฟล็กสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้ฮีปที่เก็บรักษาไว้เกินเกณฑ์ที่ --skyframe_high_water_mark_threshold ตั้งค่าอยู่ เมื่อเกิดเหตุการณ์ GC ที่ไม่ร้ายแรง เหตุการณ์ GC ที่ไม่ร้ายแรงจะเกิดขึ้น ระบบจะหยุดสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นออกไปจนถึงหลายครั้งต่อการเรียกใช้ ค่าเริ่มต้นคือจำนวนเต็มMAX_VALUE โดยไม่มีขีดจำกัด 0 หมายความว่าเหตุการณ์ GC เล็กน้อยจะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC เล็กน้อยและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
แฟล็กสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์กองที่เก็บไว้อย่างน้อยถึงเกณฑ์นี้ ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็น การปรับแต่งค่านี้อาจช่วยลดผลกระทบต่อเวลาจริงของการกระหน่ำ GC เมื่อการกระหน่ำ GC (1) เกิดจากการใช้งานหน่วยความจําของสถานะชั่วคราวนี้ และ (2) เสียค่าใช้จ่ายมากกว่าการสร้างสถานะใหม่เมื่อจําเป็น
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ส่งผลต่อรายละเอียด รูปแบบ หรือตำแหน่งของการบันทึก
--experimental_command_profile=<cpu, wall, alloc or lock>
default: ดูคำอธิบาย- บันทึกโปรไฟล์ Java Flight Recorder ตลอดระยะเวลาของคำสั่ง คุณต้องระบุประเภทเหตุการณ์โปรไฟล์ที่รองรับ (cpu, wall, alloc หรือ lock) รายการใดรายการหนึ่งเป็นอาร์กิวเมนต์ ระบบจะเขียนโปรไฟล์ลงในไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ในไดเรกทอรีฐานเอาต์พุต รูปแบบคำสั่งและความหมายของแฟล็กนี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับประเภทโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม โปรดใช้โดยยอมรับความเสี่ยงเอง
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจํากัดไว้ที่คําช่วยจํา 20 รายการที่มีการดําเนินการมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับคําช่วยจําทั้งหมด
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ใช่ค่าว่าง ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการระยะไกล
--experimental_downloader_config=<a string>
default: ดูคำอธิบาย- ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดจากระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด แต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือสองรูปแบบ รูปแบบหนึ่งจะใช้ตรงกัน และอีกรูปแบบหนึ่งใช้เป็น URL ทดแทน โดยมีการอ้างอิงกลับที่เริ่มต้นจาก "$1" ซึ่งระบบอาจส่งคืนคำสั่ง "rewrite" หลายครั้งสำหรับ URL เดียวกัน
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
ค่าเริ่มต้น: "auto"- โหมดการแยกชุดข้อความที่จะใช้ดึงข้อมูลรีโป หากตั้งค่าเป็น "ปิด" ระบบจะไม่ใช้เธรดสำหรับงานและการดึงข้อมูลรีโปจะขึ้นอยู่กับการรีสตาร์ท ไม่เช่นนั้นจะใช้เธรดผู้ทํางานเสมือน
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้านี้ออก
ตัวเลือก Cquery
รับค่าตัวเลือกทั้งหมดจาก test
- ตัวเลือกที่ปรากฏก่อนคําสั่งและได้รับการแยกวิเคราะห์โดยไคลเอ็นต์
--distdir=<a path>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนที่จะเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บข้อมูลจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบในแคชแทนการคัดลอก การดำเนินการนี้มีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองดาวน์โหลดข้อผิดพลาดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองอีกครั้ง
แท็ก:experimental
- ค่าเริ่มต้น
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับเวลาหมดอายุทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
ค่าเริ่มต้น: "false"-
หากเป็นเท็จ จะใช้กฎของรีโปเดิมใน WORKSPACE ได้ หากเป็นจริง ต้องใช้กฎของรีโป Starlark แทน กฎของรีโปเนทีฟ ได้แก่ local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
default: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลรีโพซิทอรี่ภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดแคช มิเช่นนั้นจะใช้ค่าเริ่มต้น "<output_user_root>/cache/repos/v1"
แท็ก:bazel_internal_configuration
--[no]repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลพื้นที่เก็บข้อมูล โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้โดยสมบูรณ์ โดย ctx.execute ยังคงสามารถรันไฟล์ปฏิบัติการที่กำหนดเองได้ซึ่งมีการเข้าถึงอินเทอร์เน็ต
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์มีดังนี้
- ค่าเริ่มต้น
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
เปอร์เซ็นต์ของพื้นที่เช่า (0-100) ข้างต้นซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์แรงดันหน่วยความจำเทียบกับขีดจำกัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตการค้นหาและความหมาย
- ค่าเริ่มต้น
--aspect_deps=<off, conservative or precise>
: "เชิงรับ" -
วิธีแก้ไขการพึ่งพาแง่มุมเมื่อรูปแบบเอาต์พุตเป็นหนึ่งใน {xml,proto,record} "ปิด" หมายความว่าไม่มีการแก้ไขข้อกําหนดของมิติข้อมูล "แบบอนุรักษ์นิยม" (ค่าเริ่มต้น) หมายความว่าระบบจะเพิ่มข้อกําหนดของมิติข้อมูลที่ประกาศไว้ทั้งหมด ไม่ว่าจะได้รับคลาสกฎของข้อกําหนดโดยตรงหรือไม่ "แม่นยํา" หมายความว่าระบบจะเพิ่มเฉพาะมิติข้อมูลเหล่านั้นที่อาจใช้งานได้โดยพิจารณาจากคลาสกฎของข้อกําหนดโดยตรง โปรดทราบว่าโหมดที่แม่นยำต้องโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียว จึงทําให้ช้ากว่าโหมดอื่นๆ นอกจากนี้ โปรดทราบว่าโหมดที่แม่นยำก็อาจไม่แม่นยำทั้งหมด เนื่องจากการตัดสินใจว่าจะคำนวณแง่มุมใดหรือไม่นั้นจะเกิดขึ้นในระยะการวิเคราะห์ ซึ่งไม่ได้ทำงานระหว่าง "การค้นหา Bazel"
แท็ก:build_file_semantics
--[no]consistent_labels
ค่าเริ่มต้น: "false"-
หากเปิดใช้ คำสั่งการค้นหาทุกคำสั่งจะปล่อยป้ายกำกับราวกับว่าฟังก์ชัน Starlark <code>str</code> ใช้กับอินสแตนซ์ <code>Label</code> ซึ่งมีประโยชน์สําหรับเครื่องมือที่ต้องจับคู่เอาต์พุตของคําสั่งการค้นหาและ/หรือป้ายกำกับต่างๆ ที่กฎสร้างขึ้น หากไม่ได้เปิดใช้ ตัวจัดรูปแบบเอาต์พุตจะแสดงชื่อที่เก็บที่ชัดเจน (สัมพันธ์กับที่เก็บหลัก) แทนเพื่อให้อ่านเอาต์พุตได้ง่ายขึ้น
แท็ก:terminal_output
--[no]experimental_explicit_aspects
ค่าเริ่มต้น: "false"-
aquery, cquery: รวมการดำเนินการที่สร้างขึ้นในเอาต์พุตหรือไม่ คำค้นหา: no-op (ติดตามเสมอ)
แท็ก:terminal_output
--[no]graph:factored
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ระบบจะแสดงกราฟที่ "แยกปัจจัย" กล่าวคือจะผสานโหนดที่เทียบเท่ากันตามแบบแผนเข้าด้วยกันและต่อป้ายกำกับของโหนดเหล่านั้น ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
--graph:node_limit=<an integer>
ค่าเริ่มต้น: "512"-
ความยาวสูงสุดของสตริงป้ายกำกับสำหรับโหนดกราฟในเอาต์พุต ระบบจะตัดป้ายกำกับที่ยาวกว่าออก โดย -1 หมายความว่าจะไม่ตัดออก ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
--[no]implicit_deps
ค่าเริ่มต้น: "true"-
หากเปิดใช้ ทรัพยากร Dependency โดยนัยจะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน Dependency ที่ไม่ชัดแจ้งคือ Dependency ที่ไม่ได้ระบุไว้อย่างชัดเจนในไฟล์ BUILD แต่ Bazel เพิ่มเข้ามา สําหรับ cquery ตัวเลือกนี้จะควบคุมการกรองเครื่องมือทางเทคนิคที่แก้ไขแล้ว
แท็ก:build_file_semantics
--[no]include_aspects
ค่าเริ่มต้น: "true"-
aquery, cquery: จะรวมการดำเนินการที่สร้างขึ้นในเอาต์พุตหรือไม่ คำค้นหา: no-op (ติดตามเสมอ)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]incompatible_package_group_includes_double_slash
: "true" -
หากเปิดใช้ เมื่อแสดงผลแอตทริบิวต์ "packages" ของ package_group ระบบจะไม่ละเว้น "//" ที่อยู่ด้านหน้า
แท็ก:terminal_output
,incompatible_change
- ค่าเริ่มต้น
--[no]infer_universe_scope
: "เท็จ" -
หากไม่ได้ตั้งค่า และ --universe_scope แล้ว ระบบจะอนุมานค่าของ --universe_scope เป็นรายการรูปแบบเป้าหมายที่ไม่ซ้ำกันในนิพจน์การค้นหา โปรดทราบว่าค่า --universe_scope ที่อนุมานสําหรับนิพจน์การค้นหาที่ใช้ฟังก์ชันระดับจักรวาล (เช่น `allrdeps`) อาจไม่ใช่สิ่งที่คุณต้องการ คุณจึงควรใช้ตัวเลือกนี้เฉพาะในกรณีที่คุณเข้าใจสิ่งที่ทําอยู่ ดูรายละเอียดและตัวอย่างได้ที่ https://bazel.build/reference/query#sky-query หากตั้งค่า --universe_scope ค่า ระบบจะไม่สนใจค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้มีผลกับ "query" เท่านั้น (ไม่ใช่ "cquery")
แท็ก:loading_and_analysis
--[no]line_terminator_null
ค่าเริ่มต้น: "false"-
แต่ละรูปแบบสิ้นสุดด้วย \0 แทนบรรทัดใหม่หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]nodep_deps
: "จริง" -
หากเปิดใช้ Dep จากแอตทริบิวต์ "nodep" จะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ตัวอย่างทั่วไปของแอตทริบิวต์ "nodep" คือ "ระดับการเข้าถึง" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ "info build-language" เพื่อดูข้อมูลเกี่ยวกับแอตทริบิวต์ "nodep" ทั้งหมดในภาษาของบิลด์
แท็ก:build_file_semantics
--output=<a string>
ค่าเริ่มต้น: "label"-
รูปแบบที่ควรพิมพ์ผลการค้นหา BigQuery ค่าที่อนุญาตสําหรับ cquery ได้แก่ label, label_kind, textproto, transitions, proto, streamed_proto, jsonproto หากเลือก "transitions" คุณจะต้องระบุตัวเลือก --transitions=(lite|full) ด้วย
แท็ก:terminal_output
--[no]proto:default_values
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ระบบจะรวมแอตทริบิวต์ที่ไม่ได้ระบุค่าไว้อย่างชัดแจ้งในไฟล์ BUILD มิเช่นนั้นระบบจะละเว้นแอตทริบิวต์เหล่านั้น ตัวเลือกนี้ใช้ได้กับ --output=proto
แท็ก:terminal_output
--[no]proto:definition_stack
ค่าเริ่มต้น: "false"-
ป้อนข้อมูลในช่อง proto ของ definition_stack ซึ่งจะบันทึกสแต็กการเรียกใช้ Starlark สำหรับอินสแตนซ์กฎแต่ละรายการ ณ เวลาที่กําหนดคลาสของกฎ
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:flatten_selects
: "true" -
หากเปิดใช้ ระบบจะยุบแอตทริบิวต์ที่กำหนดค่าได้ซึ่งสร้างโดย select() สําหรับประเภทลิสต์ การแสดงผลแบบแบนคือลิสต์ที่มีค่าแต่ละค่าของแผนที่ที่เลือกเพียงครั้งเดียว ระบบจะเปลี่ยนประเภทสเกลาร์ให้เป็นค่าว่าง
แท็ก:build_file_semantics
--[no]proto:include_attribute_source_aspects
ค่าเริ่มต้น: "false"-
ป้อนข้อมูลฟิลด์ proto ของ source_aspect_name ของแอตทริบิวต์แต่ละรายการด้วยแง่มุมแหล่งที่มาของแอตทริบิวต์ (สตริงว่างหากไม่มี)
แท็ก:terminal_output
--[no]proto:include_configurations
ค่าเริ่มต้น: "true"-
หากเปิดใช้ เอาต์พุต Proto จะมีข้อมูลเกี่ยวกับการกำหนดค่า เมื่อปิดใช้ รูปแบบเอาต์พุต CQuery Proto จะคล้ายกับรูปแบบเอาต์พุตการค้นหา
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]proto:include_synthetic_attribute_hash
: "เท็จ" -
กำหนดว่าจะคำนวณและป้อนข้อมูลแอตทริบิวต์ $internal_attr_hash หรือไม่
แท็ก:terminal_output
--[no]proto:instantiation_stack
ค่าเริ่มต้น: "false"-
ป้อนข้อมูลสแต็กการเรียกอินสแตนซ์ของกฎแต่ละข้อ โปรดทราบว่าต้องมีสแต็กอยู่
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:locations
: "จริง" -
แสดงข้อมูลตำแหน่งในเอาต์พุต proto หรือไม่
แท็ก:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
ค่าเริ่มต้น: "all"-
รายการแอตทริบิวต์ที่คั่นด้วยคอมมาที่จะรวมไว้ในเอาต์พุต ค่าเริ่มต้นคือแอตทริบิวต์ทั้งหมด ตั้งค่าเป็นสตริงว่างเพื่อไม่ให้แสดงผลแอตทริบิวต์ใดๆ ตัวเลือกนี้ใช้ได้กับ --output=proto
แท็ก:terminal_output
--[no]proto:rule_inputs_and_outputs
ค่าเริ่มต้น: "true"-
ว่าจะเติมข้อมูลในช่อง rules_input และ rules_output หรือไม่
แท็ก:terminal_output
--query_file=<a string>
ค่าเริ่มต้น: ""-
หากตั้งค่าไว้ การค้นหาจะอ่านการค้นหาจากไฟล์ที่มีชื่อในส่วนนี้ แทนที่จะเป็นบรรทัดคำสั่ง การระบุไฟล์ที่นี่พร้อมกับการค้นหาบรรทัดคำสั่งเป็นข้อผิดพลาด
แท็ก:changes_inputs
- ค่าเริ่มต้น
--[no]relative_locations
: "เท็จ" -
หากเป็น "จริง" ตำแหน่งของไฟล์ BUILD ในเอาต์พุต XML และ proto จะเป็นแบบสัมพัทธ์ โดยค่าเริ่มต้น เอาต์พุตตำแหน่งจะเป็นเส้นทางแบบสัมบูรณ์และจะไม่สอดคล้องกันในแต่ละเครื่อง คุณสามารถตั้งค่าตัวเลือกนี้เป็น "จริง" เพื่อให้ได้ผลลัพธ์ที่สอดคล้องกันในทุกเครื่อง
แท็ก:terminal_output
--show_config_fragments=<off, direct or transitive>
ค่าเริ่มต้น: "off"-
แสดงข้อมูลโค้ดการกำหนดค่าที่กฎต้องการและข้อมูลโค้ดที่ต้องพึ่งพากัน ซึ่งจะเป็นประโยชน์ในการประเมินจํานวนกราฟเป้าหมายที่กําหนดค่าไว้ซึ่งสามารถตัดได้
แท็ก:affects_outputs
- ค่าเริ่มต้น
--starlark:expr=<a string>
: "" -
นิพจน์ Starlark เพื่อจัดรูปแบบเป้าหมายที่กําหนดค่าแต่ละรายการในโหมด --output=starlark ของ cquery เป้าหมายที่กําหนดค่าไว้จะเชื่อมโยงกับ "target" หากไม่ได้ระบุ --starlark:expr หรือ --starlark:file ตัวเลือกนี้จะมีค่าเริ่มต้นเป็น "str(target.label)" การระบุทั้ง --starlark:expr และ --starlark:file จะทำให้เกิดข้อผิดพลาด
แท็ก:terminal_output
--starlark:file=<a string>
ค่าเริ่มต้น: ""-
ชื่อไฟล์ที่กําหนดฟังก์ชัน Starlark ชื่อ "format" ซึ่งมีอาร์กิวเมนต์ 1 รายการ ซึ่งนําไปใช้กับแต่ละเป้าหมายที่กําหนดค่าไว้เพื่อจัดรูปแบบเป็นสตริง การระบุทั้ง --starlark:expr และ --starlark:file จะทำให้เกิดข้อผิดพลาด ดูรายละเอียดเพิ่มเติมเกี่ยวกับ --output=starlark ได้ที่ความช่วยเหลือ
แท็ก:terminal_output
--[no]tool_deps
ค่าเริ่มต้น: "true"-
การค้นหา: หากปิดใช้ Dependency ของ "การกําหนดค่า exec" จะไม่รวมอยู่ในกราฟ Dependency ที่การค้นหาทํางาน ขอบความเกี่ยวข้องของ "การกำหนดค่า exec" เช่น ขอบจากกฎ "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
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ 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 ค่าที่ใช้ได้คือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ" "off" เพื่อปิดใช้การตรวจสอบ หรือ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน
แท็ก:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟทรัพยากร Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ใช้ได้คือ "off" เพื่อปิดใช้การตรวจสอบ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน หรือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ"
แท็ก:loading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นข้อกำหนดในการพัฒนาเหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูท ไม่ว่าค่าของ Flag นี้จะเป็นอย่างไรก็ตาม
แท็ก:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
ค่าเริ่มต้น: "update"-
ระบุวิธีและวิธีใช้ล็อกไฟล์ ค่าที่ถูกต้องคือ "update" เพื่อใช้ไฟล์ล็อกและอัปเดตไฟล์หากมีการเปลี่ยนแปลง "refresh" เพื่อรีเฟรชข้อมูลที่เปลี่ยนแปลงได้เพิ่มเติม (เวอร์ชันที่ยกเลิกและโมดูลที่ขาดหายไปก่อนหน้านี้) จากรีจิสทรีระยะไกลเป็นครั้งคราว "error" เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่เป็นปัจจุบัน หรือ "off" เพื่อไม่อ่านหรือเขียนลงในไฟล์ล็อก
แท็ก:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างโมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีทํางานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" แสดงว่าสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel" หากเส้นทางที่ระบุว่างเปล่า ให้นำการลบล้างก่อนหน้าออก
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--registry=<a string>
รายการ -
ระบุรีจิสทรีที่จะใช้ค้นหาทรัพยากร Dependency ของโมดูล Bazel ลําดับมีความสําคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะเปลี่ยนไปใช้รีจิสทรีที่ใหม่กว่าก็ต่อเมื่อไม่มีโมดูลที่ต้องการในรีจิสทรีก่อนหน้า
แท็ก:changes_inputs
--vendor_dir=<a path>
default: ดูคำอธิบาย-
ระบุไดเรกทอรีที่ควรเก็บที่เก็บข้อมูลภายนอกในโหมดผู้ให้บริการ ไม่ว่าจะเป็นเพื่อดึงข้อมูลมาไว้ในไดเรกทอรีดังกล่าวหรือเพื่อใช้งานขณะสร้าง เส้นทางอาจเป็นเส้นทางแบบสัมบูรณ์หรือเส้นทางแบบสัมพัทธ์กับไดเรกทอรีของพื้นที่ทำงานก็ได้
แท็ก: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 เปอร์เซ็นต์หลังจาก GC แบบสมบูรณ์ติดต่อกัน <count> ครั้งภายใน <period> ระบบจะเรียกใช้ OOM คุณสามารถระบุขีดจํากัดหลายรายการโดยคั่นด้วยคอมมา
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
แฟล็กสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC แบบเต็มขึ้น ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนครั้งต่อครั้งที่เรียกใช้ ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด 0 หมายความว่าเหตุการณ์ GC แบบสมบูรณ์จะไม่ทริกเกอร์การลดลง หากถึงขีดจำกัด สถานะ Skyframe จะไม่ลดลงอีกต่อไปเมื่อเกิดเหตุการณ์ GC เต็มรูปแบบและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC เล็กน้อย ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนนี้ต่อการเรียกใช้แต่ละครั้ง ค่าเริ่มต้นเป็น Integer.MAX_VALUE โดยไม่มีขีดจำกัด ค่า 0 หมายความว่ากิจกรรม GC ที่ไม่สำคัญมากจะไม่ทำให้ลดลงเลย หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC เล็กน้อยและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
แฟล็กสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้ฮีปที่เก็บรักษาไว้ถึงเกณฑ์นี้เป็นอย่างน้อย ก็จะทิ้งสถานะ Skyframe ชั่วคราวโดยไม่จำเป็น การปรับแต่งค่านี้อาจช่วยลดผลกระทบต่อเวลาจริงของการกระหน่ำ GC เมื่อการกระหน่ำ GC (1) เกิดจากการใช้งานหน่วยความจําของสถานะชั่วคราวนี้ และ (2) เสียค่าใช้จ่ายมากกว่าการสร้างสถานะใหม่เมื่อจําเป็น
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ส่งผลต่อรายละเอียด รูปแบบ หรือตำแหน่งของการบันทึก
--experimental_command_profile=<cpu, wall, alloc or lock>
default: ดูคำอธิบาย- บันทึกโปรไฟล์ Java Flight Recorder ตลอดระยะเวลาของคำสั่ง คุณต้องระบุประเภทเหตุการณ์โปรไฟล์ที่รองรับ (cpu, wall, alloc หรือ lock) รายการใดรายการหนึ่งเป็นอาร์กิวเมนต์ ระบบจะเขียนโปรไฟล์ลงในไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ในไดเรกทอรีฐานเอาต์พุต รูปแบบคำสั่งและความหมายของ Flag นี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับประเภทโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม โปรดใช้โดยยอมรับความเสี่ยงเอง
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจํากัดไว้ที่คําช่วยจํา 20 รายการที่มีการดําเนินการมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับคําช่วยจําทั้งหมด
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ใช่ค่าว่าง ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการระยะไกล
--experimental_downloader_config=<a string>
default: ดูคำอธิบาย- ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดจากระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะขึ้นต้นด้วยคําสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สําหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ โดยรูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้แทน URL โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณอาจระบุคําสั่ง `rewrite` หลายรายการสําหรับ URL เดียวกันได้ ซึ่งในกรณีนี้ระบบจะแสดงผล URL หลายรายการ
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
ค่าเริ่มต้น: "auto"- โหมดการแยกชุดข้อความที่ใช้สำหรับการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท ไม่เช่นนั้นจะใช้เธรดผู้ทํางานเสมือน
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้
--override_repository=<an equals-separated mapping of repository name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้าออก
- ตัวเลือกที่ควบคุมการดำเนินการบิลด์
--[no]experimental_inprocess_symlink_creation
ค่าเริ่มต้น: "false"-
Whether to make direct file system calls to create symlink trees
Tags:loading_and_analysis
,execution
,experimental
- ค่าเริ่มต้น
--[no]experimental_persistent_aar_extractor
: "เท็จ" -
เปิดใช้เครื่องมือแยก Aar แบบถาวรโดยใช้เวิร์กเกอร์
แท็ก:execution
--[no]experimental_remotable_source_manifests
ค่าเริ่มต้น: "false"-
กำหนดให้ดำเนินการในไฟล์ Manifest ของแหล่งที่มาจากระยะไกลได้หรือไม่
แท็ก:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" Bazel จะเรียกใช้การประมวลผลผลลัพธ์ของการทดสอบในกระบวนการใหม่
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_strict_fileset_output
: "เท็จ" -
หากเปิดใช้ตัวเลือกนี้ ชุดไฟล์จะถือว่าอาร์ติแฟกต์เอาต์พุตทั้งหมดเป็นไฟล์ทั่วไป โดยจะไม่ข้ามผ่านไดเรกทอรีหรือไวต่อลิงก์สัญลักษณ์
แท็ก:execution
--[no]incompatible_disallow_unsound_directory_outputs
ค่าเริ่มต้น: "true"-
หากตั้งค่าไว้ ระบบจะแสดงข้อผิดพลาดเมื่อดำเนินการสร้างไฟล์เอาต์พุตเป็นไดเรกทอรี ไม่มีผลต่อไดเรกทอรีต้นทาง ดู https://github.com/bazelbuild/bazel/issues/18646
แท็ก:bazel_internal_configuration
,incompatible_change
--[no]incompatible_modify_execution_info_additive
ค่าเริ่มต้น: "false"-
เมื่อเปิดใช้ การส่ง Flag --modify_execution_info หลายรายการจะเป็นการเพิ่ม เมื่อปิดใช้ ระบบจะพิจารณาเฉพาะการแจ้งเตือนล่าสุดเท่านั้น
แท็ก:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
เพิ่มหรือนําคีย์ออกจากข้อมูลการดําเนินการของการดำเนินการตามคําช่วยจําการดําเนินการ ใช้กับการดำเนินการที่รองรับข้อมูลการดำเนินการเท่านั้น การดำเนินการทั่วไปหลายรายการรองรับข้อมูลการดำเนินการ เช่น Genrule, CppCompile, Javac, StarlarkAction, TestRunner เมื่อระบุหลายค่า ลําดับจะมีความสำคัญเนื่องจากนิพจน์ทั่วไปหลายรายการอาจใช้กับคําช่วยจําเดียวกัน
ไวยากรณ์: "regex=[+-]key,regex=[+-]key,..."
ตัวอย่างเช่น ".*=+x,.*=-y,.*=+z" เพิ่ม "x" และ "z" และนำ "y" ออกจากข้อมูลการดำเนินการสำหรับการดำเนินการทั้งหมด
"Genrule=+requires-x" เพิ่ม "requires-x" ในข้อมูลการดำเนินการสำหรับการดำเนินการ Genrule ทั้งหมด
"(?!Genrule).*=-requires-x" จะนำ "requires-x" ออกจากข้อมูลการดำเนินการสำหรับการดำเนินการที่ไม่ใช่ Genrule ทั้งหมด
แท็ก:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
เปิดใช้การดำเนินการ Dex และ desugar ของ Android แบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--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
-
เปิดใช้การดำเนินการ Desugar และ Dex ของ Android แบบหลายเพล็กซ์แบบถาวรโดยใช้เวิร์กเกอร์
ขยายเป็น
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
แท็ก:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
เปิดใช้ตัวประมวลผลทรัพยากร Android แบบหลายเพล็กซ์แบบถาวรโดยใช้ผู้ปฏิบัติงาน
ครอบคลุมถึง
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
{/7/2}
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
{/7/2}--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
-
เปิดใช้เครื่องมือ Android แบบถาวรและแบบหลายเพล็กซ์ (การแปลงไฟล์ Dex, การถอด Sugar, การประมวลผลทรัพยากร)
ขยายเป็น
--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
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะใช้แพลตฟอร์มเป้าหมายเพื่อทำการทดสอบแทนกลุ่มผู้บริหารทดสอบ
แท็ก:execution
- ตัวเลือกที่กำหนดค่าเครื่องมือที่ใช้สำหรับการดำเนินการ
--android_compiler=<a string>
default: ดูคำอธิบาย-
คอมไพเลอร์เป้าหมาย Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
ค่าเริ่มต้น: "//external:android/crosstool"-
ตำแหน่งของคอมไพเลอร์ C++ ที่ใช้สำหรับบิลด์ของ Android
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
default: ดูคำอธิบาย-
เป้าหมาย grte_top ของ Android
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_manifest_merger=<legacy, android or force_android>
: "android" -
เลือกเครื่องมือผสานไฟล์ Manifest ที่จะใช้กับกฎ android_binary แจ้งเพื่อช่วยให้เปลี่ยนไปใช้การผสานรวมไฟล์ Manifest ของ Android จากการควบรวมเดิม
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
ค่าเริ่มต้น: ""-
กำหนดแพลตฟอร์มที่เป้าหมาย android_binary ใช้ หากระบุแพลตฟอร์มหลายรายการ ไฟล์ไบนารีจะเป็น APK แบบรวมซึ่งมีไบนารีเนทีฟสำหรับแพลตฟอร์มเป้าหมายแต่ละรายการที่ระบุ
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/android:sdk"-
ระบุ Android SDK/แพลตฟอร์มที่ใช้สร้างแอปพลิเคชัน Android
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้ในกฎของ Apple และ Objc รวมถึงการอ้างอิง
แท็ก:loses_incremental_state
,changes_inputs
--cc_output_directory_tag=<a string>
ค่าเริ่มต้น: ""-
ระบุส่วนต่อท้ายที่จะเพิ่มในไดเรกทอรีการกำหนดค่า
แท็ก:affects_outputs
--compiler=<a string>
default: ดูคำอธิบาย-
คอมไพเลอร์ 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>
default: "@bazel_tools//tools/test:coverage_report_generator"-
ตำแหน่งของไบนารีที่ใช้สร้างรายงานการครอบคลุม ซึ่งปัจจุบันต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งเป็นไฟล์ไบนารี ค่าเริ่มต้นคือ "//tools/test:coverage_report_generator"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_support"-
ตำแหน่งของไฟล์สนับสนุนที่จําเป็นในอินพุตของการดำเนินการทดสอบทุกครั้งที่รวบรวมการครอบคลุมโค้ด ค่าเริ่มต้นคือ "//tools/test:coverage_support"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้ในการคอมไพล์โค้ด C++
แท็ก:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
default: ดูคำอธิบาย-
ระบุการใช้งาน malloc ที่กําหนดเอง การตั้งค่านี้จะลบล้างแอตทริบิวต์ malloc ในกฎการสร้าง
แท็ก:changes_inputs
,affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
รายการนิพจน์ทั่วไปที่คั่นด้วยคอมมา โดยแต่ละรายการจะมีคำนำหน้าเป็น - (นิพจน์เชิงลบ) หรือไม่ก็ได้ ซึ่งกำหนด (=) ให้กับรายการเป้าหมายค่าข้อจำกัดที่คั่นด้วยคอมมา หากเป้าหมายไม่ตรงกับนิพจน์เชิงลบและตรงกับนิพจน์เชิงบวกอย่างน้อย 1 รายการ ระบบจะดำเนินการแก้ไขเครื่องมือทางเทคนิคของเป้าหมายนั้นราวกับว่าได้ประกาศค่าข้อจำกัดเป็นข้อจำกัดการดําเนินการ ตัวอย่างเช่น //demo,-test=@platforms//cpus:x86_64 จะเพิ่ม "x86_64" ลงในเป้าหมายภายใต้ //demo ยกเว้นเป้าหมายที่มีชื่อเป็น "test"
แท็ก:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ให้เพิ่มข้อกำหนดการเรียกใช้ "requires-xcode:{version}" ลงในการดำเนินการ Xcode ทั้งหมด หากเวอร์ชัน xcode มีป้ายกำกับขีดกลาง ให้เพิ่มข้อกำหนดการดำเนินการ "requires-xcode-label:{version_label}"
แท็ก:loses_incremental_state
,loading_and_analysis
,execution
- ค่าเริ่มต้น
--[no]experimental_prefer_mutual_xcode
: "จริง" -
หากเป็น "จริง" ให้ใช้ Xcode เวอร์ชันล่าสุดที่มีทั้งแบบในเครื่องและแบบระยะไกล หากเป็นเท็จหรือไม่มีเวอร์ชันที่ใช้ร่วมกัน ให้ใช้เวอร์ชันของ Xcode ในเครื่องที่เลือกผ่าน xcode-select
แท็ก:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
ค่าเริ่มต้น: ""-
แพลตฟอร์มที่ใช้เป็นแพลตฟอร์มการดําเนินการเพื่อเรียกใช้การดําเนินการ แพลตฟอร์มสามารถระบุตามเป้าหมายที่ตรงกันทั้งหมดหรือเป็นรูปแบบเป้าหมาย ระบบจะพิจารณาแพลตฟอร์มเหล่านี้ก่อนแพลตฟอร์มที่ประกาศไว้ในไฟล์ WORKSPACE โดย register_execution_platforms() ตัวเลือกนี้ตั้งค่าได้เพียงครั้งเดียว อินสแตนซ์ที่ตามมาจะลบล้างการตั้งค่า Flag ก่อนหน้า
แท็ก:execution
--extra_toolchains=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
กฎสำหรับ Toolchain ที่ควรพิจารณาระหว่างการแก้ไข Toolchain คุณสามารถระบุ Toolchain ตามเป้าหมายที่ตรงกันทั้งหมด หรือเป็นรูปแบบเป้าหมายก็ได้ ระบบจะพิจารณา Toolchain เหล่านี้ก่อน Toolchain ที่ประกาศไว้ในไฟล์ WORKSPACE โดย register_toolchains()
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
default: ดูคำอธิบาย-
ป้ายกำกับไปยังไลบรารี libc ที่มีการเช็คอิน เครื่องมือทํางานแบบข้ามแพลตฟอร์มจะเลือกค่าเริ่มต้น และคุณแทบไม่จําเป็นต้องลบล้างค่าดังกล่าว
แท็ก:action_command_lines
,affects_outputs
--host_compiler=<a string>
default: ดูคำอธิบาย-
คอมไพเลอร์ C++ ที่จะใช้ในการคอมไพล์โฮสต์ โดยจะไม่มีผลหากไม่ได้ตั้งค่า --host_crosstool_top
แท็ก:loading_and_analysis
,execution
- ค่าเริ่มต้น
--host_crosstool_top=<a build target label>
: ดูคำอธิบาย -
โดยค่าเริ่มต้น ระบบจะใช้ตัวเลือก --crosstool_top และ --compiler สำหรับการกําหนดค่า exec ด้วย หากระบุ Flag นี้ Bazel จะใช้ libc และคอมไพเลอร์เริ่มต้นสำหรับ crosstool_top ที่ระบุ
แท็ก:loading_and_analysis
,changes_inputs
,affects_outputs
- ค่าเริ่มต้น
--host_grte_top=<a label>
: ดูคำอธิบาย -
หากระบุไว้ การตั้งค่านี้จะลบล้างไดเรกทอรีระดับบนสุดของ libc (--grte_top) สําหรับการกําหนดค่า exec
แท็ก:action_command_lines
,affects_outputs
--host_platform=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools:host_platform"-
ป้ายกํากับของกฎแพลตฟอร์มที่อธิบายระบบโฮสต์
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
ค่าเริ่มต้น: "true"-
หากเป็นจริง Bazel จะไม่เปิดใช้ฟีเจอร์ "โฮสต์" และ "nonhost" ใน Toolchain ของ c++ (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/7407)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
ค่าเริ่มต้น: "true"-
ใช้การแก้ไข Toolchain เพื่อเลือก Android SDK สําหรับกฎ Android (Starlark และแบบดั้งเดิม)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
ค่าเริ่มต้น: "false"-
ใช้การแปลง Toolchain เพื่อเลือก Apple SDK สำหรับกฎของ Apple (Starlark และเนทีฟ)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" Bazel จะไม่นําบรรทัดคําสั่งการดําเนินการลิงก์ C++ มาใช้ซ้ำสําหรับบรรทัดคําสั่งการจัดทําดัชนี lto (ดูข้อมูลเพิ่มเติมที่ https://github.com/bazelbuild/bazel/issues/6791)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" Bazel จะไม่ลิงก์ไลบรารี Dependency เป็นไฟล์เก็บถาวรทั้งไฟล์โดยค่าเริ่มต้น (ดูวิธีการย้ายข้อมูลได้ที่ https://github.com/bazelbuild/bazel/issues/7362)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_require_ctx_in_configure_features
: "จริง" -
หากเป็น "จริง" Bazel จะกำหนดให้ต้องมีพารามิเตอร์ "ctx" ใน cc_common.configure_features (ดูข้อมูลเพิ่มเติมที่ https://github.com/bazelbuild/bazel/issues/7793)
แท็ก:loading_and_analysis
,incompatible_change
-
ใช้ออบเจ็กต์ที่แชร์ของอินเทอร์เฟซหากเครื่องมือทางเทคนิครองรับ เครื่องมือชุดค่าผสม ELF ทั้งหมดรองรับการตั้งค่านี้ในปัจจุบัน
แท็ก:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: ดูคำอธิบาย-
ระบุเวอร์ชันของ 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>
default: ดูคำอธิบาย-
เวอร์ชันระบบปฏิบัติการขั้นต่ำที่การคอมไพล์กำหนดเป้าหมาย
แท็ก:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
ค่าเริ่มต้น: ""-
ตำแหน่งของไฟล์การแมปที่อธิบายว่าควรใช้แพลตฟอร์มใดหากไม่ได้ตั้งค่าไว้ หรือควรตั้งค่า Flag ใดเมื่อมีแพลตฟอร์มอยู่แล้ว ต้องสัมพันธ์กับรูทของพื้นที่ทํางานหลัก ค่าเริ่มต้นคือ "platform_mappings" (ไฟล์ที่อยู่ใต้รูทของพื้นที่ทํางานโดยตรง)
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--platforms=<a build target label>
: "" -
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายแพลตฟอร์มเป้าหมายสำหรับคำสั่งปัจจุบัน
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
default: ดูคำอธิบาย-
เลิกใช้งาน ไม่ดำเนินการ ปิดใช้โดย "--incompatible_use_python_toolchains"
แท็ก:no_op
,deprecated
--python3_path=<a string>
default: ดูคำอธิบาย-
เลิกใช้งานแล้ว ใช้งานไม่ได้ ปิดใช้โดย `--incompatible_use_python_toolchains`
แท็ก:no_op
,deprecated
- ค่าเริ่มต้น
--python_path=<a string>
: ดูคำอธิบาย -
เส้นทางสัมบูรณ์ของโปรแกรมแปลภาษา Python ที่เรียกใช้เพื่อเรียกใช้เป้าหมาย Python ในแพลตฟอร์มเป้าหมาย เลิกใช้งานแล้ว ปิดใช้โดย --incompatible_use_python_toolchains
แท็ก:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
default: ดูคำอธิบาย-
ป้ายกำกับของ 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')>
default: ดูคำอธิบาย-
ระบุเวอร์ชันของ tvOS SDK ที่จะใช้สร้างแอปพลิเคชัน tvOS หากไม่ระบุ ระบบจะใช้เวอร์ชันเริ่มต้นของ tvOS SDK จาก "xcode_version"
แท็ก:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: ดูคำอธิบาย-
ระบุเวอร์ชันของ watchOS SDK ที่จะใช้สร้างแอปพลิเคชัน watchOS หากไม่ระบุ ระบบจะใช้เวอร์ชัน watchOS SDK เริ่มต้นจาก "xcode_version"
แท็ก:loses_incremental_state
--xcode_version=<a string>
default: ดูคำอธิบาย-
หากระบุไว้ ให้ใช้ 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
ค่าเริ่มต้น: "false"-
สร้างไฟล์สัญลักษณ์สำหรับแก้ไขข้อบกพร่อง (.dSYM) หรือไม่
แท็ก:affects_outputs
,action_command_lines
--[no]build_runfile_links
ค่าเริ่มต้น: "true"-
หากเป็นจริง ให้สร้างไฟล์ symlink ของ Runfiles สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้เขียนเฉพาะเมื่อการดำเนินการในเครื่องต้องใช้ ทดสอบ หรือเรียกใช้คำสั่งเท่านั้น
แท็ก:affects_outputs
--[no]build_runfile_manifests
ค่าเริ่มต้น: "true"-
หากเป็นจริง ให้เขียนไฟล์ Manifest ของการเรียกใช้ไฟล์สำหรับเป้าหมายทั้งหมด หากเป็นเท็จ ให้ละเว้น การทดสอบในเครื่องจะทํางานไม่สําเร็จเมื่อเป็นเท็จ
แท็ก:affects_outputs
--[no]build_test_dwp
ค่าเริ่มต้น: "false"-
หากเปิดใช้ เมื่อสร้างการทดสอบ C++ แบบคงที่และด้วย Fission ระบบจะสร้างไฟล์ .dwp สำหรับไบนารีทดสอบโดยอัตโนมัติด้วย
แท็ก:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
ค่าเริ่มต้น: ".pb.h"-
ตั้งค่าส่วนต่อท้ายของไฟล์ส่วนหัวที่ cc_proto_library สร้างขึ้น
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--cc_proto_library_source_suffixes=<comma-separated set of options>
: ".pb.cc" -
ตั้งค่าคำต่อท้ายของไฟล์ต้นฉบับที่ cc_proto_library สร้างขึ้น
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
ค่าเริ่มต้น: "false"-
เรียกใช้การดำเนินการเพิ่มเติมสำหรับเวอร์ชัน Java API อื่นใน proto_library
แท็ก:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
ค่าเริ่มต้น: "false"-
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันอื่นใน proto_library
แท็ก:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
ค่าเริ่มต้น: "false"-
บันทึกสถานะของฟีเจอร์ที่เปิดใช้และที่ขอเป็นเอาต์พุตของการคอมไพล์
แท็ก:affects_outputs
,experimental
--fission=<a set of compilation modes>
ค่าเริ่มต้น: "no"-
ระบุโหมดการคอมไพล์ที่ใช้ Fission สําหรับการคอมไพล์และการลิงก์ C++ อาจเป็นชุดค่าผสมของ {'fastbuild', 'dbg', 'opt'} หรือค่าพิเศษ "yes" เพื่อเปิดใช้ทุกโหมด และ "no" เพื่อปิดใช้ทุกโหมด
แท็ก:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" กฎแบบเนทีฟจะเพิ่ม <code>DefaultInfo.files</code> ของข้อมูลที่ต้องพึ่งพาลงในไฟล์รันไทม์ ซึ่งตรงกับลักษณะการทำงานที่แนะนำสำหรับกฎ 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>
รายการ -
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกำหนดค่าเป้าหมาย ตัวแปรสามารถระบุโดยใช้ชื่อ ซึ่งในกรณีนี้ระบบจะนำค่ามาจากสภาพแวดล้อมการเรียกใช้ หรือระบุโดยใช้คู่ชื่อ=ค่า ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ คุณใช้ตัวเลือกนี้ได้หลายครั้ง ตัวเลือกสําหรับตัวแปรเดียวกันจะเลือกตัวเลือกล่าสุด ส่วนตัวเลือกสําหรับตัวแปรต่างๆ จะรวมกัน
แท็ก:action_command_lines
--android_cpu=<a string>
ค่าเริ่มต้น: "armeabi-v7a"-
CPU เป้าหมายของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
ค่าเริ่มต้น: "true"-
สร้างไฟล์การเชื่อมโยงข้อมูลที่เข้ากันได้กับ AndroidX ใช้กับ DataBinding v2 เท่านั้น Flag นี้ไม่มีผลใดๆ
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
ค่าเริ่มต้น: "true"-
ใช้ Android Databinding v2 ที่มีอาร์กิวเมนต์ 3.4.0 Flag นี้ไม่มีผลใดๆ
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้นของ
--android_dynamic_mode=<off, default or fully>
: "off" -
กำหนดว่าจะลิงก์ deps C++ ของกฎ Android แบบไดนามิกหรือไม่เมื่อ cc_binary ไม่ได้สร้างไลบรารีที่ใช้ร่วมกันอย่างชัดเจน "default" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "ทั้งหมด" หมายความว่าระบบจะลิงก์คลังทั้งหมดแบบไดนามิก "ปิด" หมายความว่าระบบจะลิงก์คลังทั้งหมดในโหมดคงที่ส่วนใหญ่
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "alphabetical" -
กำหนดลําดับของไฟล์ Manifest ที่ส่งไปยังเครื่องมือผสานไฟล์ Manifest สําหรับไบนารีของ Android ALPHABETICAL หมายความว่าไฟล์ Manifest จะจัดเรียงตามเส้นทางที่สัมพันธ์กับ execroot ALPHABETICAL_BY_CONFIGURATION หมายความว่าไฟล์ Manifest จะจัดเรียงตามเส้นทางที่สัมพันธ์กับไดเรกทอรีการกําหนดค่าภายในไดเรกทอรีเอาต์พุต DEPENDENCY หมายความว่าไฟล์ Manifest จะเรียงลำดับโดยให้ไฟล์ Manifest ของแต่ละไลบรารีอยู่ก่อนไฟล์ Manifest ของไลบรารีที่ต้องพึ่งพา
แท็ก:action_command_lines
,execution
--[no]android_resource_shrinking
ค่าเริ่มต้น: "false"-
เปิดใช้การลดขนาดทรัพยากรสำหรับ APK ประเภท android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--[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 coverage" แทน
แท็ก: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>
default: ดูคำอธิบาย-
ใช้ข้อมูลโปรไฟล์ CSFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อเส้นทางสัมบูรณ์ของไฟล์ ZIP ที่มีไฟล์โปรไฟล์, ไฟล์ข้อมูล RAW หรือไฟล์โปรไฟล์ LLVM ที่จัดทำดัชนีไว้
แท็ก:affects_outputs
--cs_fdo_instrument=<a string>
default: ดูคำอธิบาย-
สร้างไบนารีด้วยเครื่องมือ FDO ที่คำนึงถึงบริบท เมื่อใช้คอมไพเลอร์ Clang/LLVM ระบบจะยอมรับชื่อไดเรกทอรีที่จะใช้วางไฟล์โปรไฟล์ดิบเมื่อรันไทม์ด้วย
แท็ก:affects_outputs
--cs_fdo_profile=<a build target label>
default: ดูคำอธิบาย-
The cs_fdo_profile representing the context sensitive profile to be used for optimization.
แท็ก: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++ แบบไดนามิกหรือไม่ "default" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "โดยสมบูรณ์" หมายความว่าไลบรารีทั้งหมดจะมีการเชื่อมโยงแบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
ค่าเริ่มต้น: "true"-
หากตั้งค่าไว้ การใช้ fdo_absolute_profile_path จะทำให้เกิดข้อผิดพลาด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]enable_runfiles
: "อัตโนมัติ" -
เปิดใช้โครงสร้าง Symlink ของไฟล์รันไทม์ โดยค่าเริ่มต้นจะปิดอยู่ใน Windows และเปิดอยู่ในแพลตฟอร์มอื่นๆ
แท็ก:affects_outputs
--experimental_action_listener=<a build target label>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
เลิกใช้งานแล้วเพื่อใช้ "แง่มุม" แทน ใช้ action_listener เพื่อแนบ extra_action กับการดำเนินการบิลด์ที่มีอยู่
แท็ก:execution
,experimental
--[no]experimental_android_compress_java_resources
ค่าเริ่มต้น: "false"-
บีบอัดทรัพยากร Java ใน APK
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_android_databinding_v2
: "จริง" -
ใช้ Android Databinding v2 Flag นี้ไม่มีผลใดๆ
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
ค่าเริ่มต้น: "false"-
เปิดใช้การลดขนาดทรัพยากรสำหรับ APK ประเภท android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
ค่าเริ่มต้น: "false"-
ใช้เครื่องมือ rex เพื่อเขียนไฟล์ dex ใหม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
ค่าเริ่มต้น: "false"-
หากระบุ Bazel จะสร้างข้อมูลการครอบคลุมสำหรับไฟล์ที่สร้างขึ้นด้วย
แท็ก:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
ค่าเริ่มต้น: "-O0,-DDEBUG=1"-
ใช้สตริงเหล่านี้เป็นตัวเลือกคอมไพเลอร์ objc fastbuild
แท็ก:action_command_lines
--[no]experimental_omitfp
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" ระบบจะใช้ libunwind สำหรับการเลิกซ้อนของกอง และคอมไพล์ด้วย -fomit-frame-pointer และ -fasynchronous-unwind-tables
แท็ก:action_command_lines
,affects_outputs
,experimental
- ค่าเริ่มต้นของ
--experimental_output_paths=<off, content or strip>
: "off" -
รูปแบบที่จะใช้สำหรับตำแหน่งในกฎของต้นไม้เอาต์พุตที่จะเขียนเอาต์พุต โดยเฉพาะสำหรับบิลด์หลายแพลตฟอร์ม / หลายการกำหนดค่า ฟีเจอร์นี้อยู่ในขั้นทดลอง ดูรายละเอียดได้ที่ 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 โดยที่ label หมายถึงแพลตฟอร์ม และ values คือชื่อย่อที่ต้องการใช้ในเส้นทางเอาต์พุต ใช้เมื่อ --experimental_platform_in_output_dir เป็น "จริง" เท่านั้น มีลำดับความสำคัญในการตั้งชื่อสูงสุด
แท็ก:affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
ค่าเริ่มต้น: "false"-
หากเป็นจริง ระบบจะใช้ชื่อย่อของแพลตฟอร์มเป้าหมายในชื่อไดเรกทอรีเอาต์พุตแทน CPU รูปแบบที่แน่นอนเป็นรูปแบบทดลองและอาจมีการเปลี่ยนแปลงได้ ประการแรก ในบางกรณีที่ตัวเลือก --platforms ไม่มีค่าเพียงค่าเดียว ระบบจะใช้แฮชของตัวเลือกแพลตฟอร์ม ถัดไป หากชื่อย่อของแพลตฟอร์มปัจจุบันลงทะเบียนโดย --experimental_override_name_platform_in_output_dir ระบบจะใช้ชื่อย่อนั้น จากนั้นหากตั้งค่า --experimental_use_platforms_in_output_dir_legacy_heuristic ให้ใช้ชื่อย่อตามป้ายกำกับแพลตฟอร์มปัจจุบัน สุดท้าย ระบบจะใช้แฮชของตัวเลือกแพลตฟอร์มเป็นทางเลือกสุดท้าย
แท็ก:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
ค่าเริ่มต้น: "false"-
หากระบุไว้ 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"-
โปรดใช้ Flag นี้เป็นส่วนหนึ่งของกลยุทธ์การย้ายข้อมูลหรือการทดสอบที่แนะนําเท่านั้น โปรดทราบว่าวิธีการเฮิวริสติกมีข้อบกพร่องที่ทราบอยู่แล้ว และเราขอแนะนำให้เปลี่ยนไปใช้เฉพาะ --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. หากระบุ Flag นี้ ระบบจะไม่สนใจ --android_cpu สำหรับข้อกำหนดของกฎ android_binary
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
ค่าเริ่มต้น: "false"-
สร้างการแยก HWASAN หรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
default: ดูคำอธิบาย-
สร้างไบนารีด้วยเครื่องมือ FDO เมื่อใช้คอมไพเลอร์ Clang/LLVM ระบบจะยอมรับชื่อไดเรกทอรีที่จะใช้วางไฟล์โปรไฟล์ดิบเมื่อรันไทม์ด้วย
แท็ก:affects_outputs
--fdo_optimize=<a string>
default: ดูคำอธิบาย-
ใช้ข้อมูลโปรไฟล์ FDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อไฟล์ ZIP ที่มีโครงสร้างไฟล์ .gcda, ไฟล์ afdo ที่มีโปรไฟล์อัตโนมัติ หรือไฟล์โปรไฟล์ LLVM นอกจากนี้ Flag นี้ยังยอมรับไฟล์ที่ระบุเป็นป้ายกำกับ (เช่น `//foo/bar:file.afdo` - คุณอาจต้องเพิ่มคำสั่ง `exports_files` ลงในแพ็กเกจที่เกี่ยวข้อง) และป้ายกำกับที่ชี้ไปยังเป้าหมาย `fdo_profile` ด้วย กฎ `fdo_profile` จะลบล้าง Flag นี้
แท็ก:affects_outputs
--fdo_prefetch_hints=<a build target label>
default: ดูคำอธิบาย-
ใช้คำแนะนำในการดึงแคชล่วงหน้า
แท็ก: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
ค่าเริ่มต้น: "false"-
หากเปิดใช้ การคอมไพล์ C++ ทั้งหมดจะสร้างโค้ดที่ไม่ขึ้นกับตำแหน่ง ("-fPIC") การลิงก์จะเลือกไลบรารีที่สร้างไว้ล่วงหน้าแบบ PIC มากกว่าไลบรารีที่ไม่ใช่ PIC และการลิงก์จะสร้างไฟล์ปฏิบัติการที่ไม่ขึ้นกับตำแหน่ง ("-pie")
แท็ก:loading_and_analysis
,affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกําหนดค่าการดําเนินการ ตัวแปรสามารถระบุโดยใช้ชื่อ ซึ่งในกรณีนี้ระบบจะนำค่ามาจากสภาพแวดล้อมการเรียกใช้ หรือระบุโดยใช้คู่ชื่อ=ค่า ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ คุณใช้ตัวเลือกนี้ได้หลายครั้ง ตัวเลือกสําหรับตัวแปรเดียวกันจะเลือกตัวเลือกล่าสุด ส่วนตัวเลือกสําหรับตัวแปรต่างๆ จะรวมกัน
แท็ก:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
ค่าเริ่มต้น: "opt"-
ระบุโหมดที่จะใช้สร้างเครื่องมือที่ใช้ในระหว่างการสร้าง ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
,action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_conlyopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมที่จะส่งไปยังคอมไพเลอร์ C เมื่อคอมไพล์ไฟล์ซอร์ส C (แต่ไม่ใช่ C++) ในการกำหนดค่า exec
แท็ก: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++ สําหรับเครื่องมือที่สร้างในการกําหนดค่า exec
แท็ก:action_command_lines
,affects_outputs
--host_features=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบบจะเปิดหรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างในการกําหนดค่า exec การระบุ -<feature> จะปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ
แท็ก:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
default: ดูคำอธิบาย-
ลบล้างเวอร์ชัน Python สําหรับการกําหนดค่า exec อาจเป็น "PY2" หรือ "PY3"
แท็ก:loading_and_analysis
,affects_outputs
--host_linkopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง linker เมื่อลิงก์เครื่องมือในการกําหนดค่า exec
แท็ก:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: ดูคำอธิบาย-
เวอร์ชัน macOS ขั้นต่ำที่เข้ากันได้สำหรับเป้าหมายโฮสต์ หากไม่ระบุ ระบบจะใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมเพื่อเลือกส่งผ่านไปยังคอมไพเลอร์ C/C++ เมื่อคอมไพเลอร์ไฟล์บางไฟล์ในการกำหนดค่าการดำเนินการ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจากรายการรวมและไม่รวมรูปแบบนิพจน์ทั่วไป (ดูที่ --instrumentation_filter) ด้วย Option_1 กับ Option_n คือตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีคอมมา จะต้องใส่เครื่องหมายคำพูดด้วยเครื่องหมายแบ็กสแลช ตัวเลือกมี @ ได้ โดยระบบจะใช้เฉพาะ @ แรกในการแยกสตริง ตัวอย่างเช่น --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 จะเพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ลงในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
,affects_outputs
--host_swiftcopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง swiftc สําหรับเครื่องมือ exec
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้น
--[no]incompatible_auto_exec_groups
: "เท็จ" -
เมื่อเปิดใช้ ระบบจะสร้างกลุ่ม exec โดยอัตโนมัติสําหรับเครื่องมือทางเทคนิคแต่ละรายการที่กฎใช้ กฎต้องระบุพารามิเตอร์ "toolchain" ในการดำเนินการเพื่อให้การทำงานนี้ได้ผล ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/17134
แท็ก:affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ระบบจะรวมไดเรกทอรี genfiles ไว้ในไดเรกทอรี bin
แท็ก:affects_outputs
,incompatible_change
--[no]incompatible_use_host_features
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ให้ใช้ --features สำหรับการกำหนดค่าเป้าหมายเท่านั้น และ --host_features สำหรับการกำหนดค่า exec
แท็ก:changes_inputs
,affects_outputs
,incompatible_change
- ค่าเริ่มต้น
--[no]instrument_test_targets
: "เท็จ" -
เมื่อเปิดใช้การครอบคลุม ให้ระบุว่าจะพิจารณาเครื่องมือวัดกฎการทดสอบหรือไม่ เมื่อตั้งค่าแล้ว ระบบจะเครื่องมือวัดกฎการทดสอบที่รวมโดย --instrumentation_filter มิฉะนั้น ระบบจะยกเว้นกฎการทดสอบจากการวัดการครอบคลุมเสมอ
แท็ก:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
ค่าเริ่มต้น: "-/javatests[/:],-/test/java[/:]"-
เมื่อเปิดใช้ความครอบคลุม ระบบจะเครื่องมือวัดเฉพาะกฎที่มีชื่อซึ่งรวมอยู่ในตัวกรองตามนิพจน์ทั่วไปที่ระบุเท่านั้น ระบบจะยกเว้นกฎที่มีคำนำหน้าเป็น "-" แทน โปรดทราบว่าระบบจะเครื่องมือวัดเฉพาะกฎที่ไม่ใช่การทดสอบ เว้นแต่ว่าจะมีการเปิดใช้ --instrument_test_targets
แท็ก:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: ดูคำอธิบาย-
เวอร์ชัน iOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองและอุปกรณ์เป้าหมาย หากไม่ระบุ ระบบจะใช้ "ios_sdk_version"
แท็ก:loses_incremental_state
--ios_multi_cpus=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างแอปพลิเคชัน ios_ ผลลัพธ์ที่ได้คือไบนารีแบบสากลที่มีสถาปัตยกรรมที่ระบุไว้ทั้งหมด
แท็ก:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
ค่าเริ่มต้น: "true"-
เลิกใช้งานแล้ว แทนที่ด้วย --incompatible_remove_legacy_whole_archive (ดูรายละเอียดที่ https://github.com/bazelbuild/bazel/issues/7362) เมื่อเปิดใช้ ให้ใช้ --whole-archive สำหรับกฎ cc_binary ที่มี linkshared=True และ linkstatic=True หรือ "-static" ใน linkopts ตัวเลือกนี้มีไว้เพื่อให้ใช้กับเวอร์ชันก่อนหน้าได้เท่านั้น วิธีอื่นที่ดีกว่าคือการใช้ alwayslink=1 ในที่ที่ต้องใช้
แท็ก:action_command_lines
,affects_outputs
,deprecated
--linkopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc เมื่อลิงก์
แท็ก:action_command_lines
,affects_outputs
--ltobackendopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยังขั้นตอนแบ็กเอนด์ LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
,affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ltoindexopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมที่จะส่งไปยังขั้นตอนการจัดทำดัชนี LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
,affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--macos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple macOS
แท็ก:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: ดูคำอธิบาย-
เวอร์ชัน macOS ขั้นต่ำที่เข้ากันได้สำหรับเป้าหมาย หากไม่ระบุ ระบบจะใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
--memprof_profile=<a build target label>
default: ดูคำอธิบาย-
ใช้โปรไฟล์ memprof
แท็ก:affects_outputs
--[no]objc_debug_with_GLIBCXX
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้และตั้งค่าโหมดการคอมไพล์เป็น "dbg" ให้กําหนด GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC และ GLIBCPP_CONCEPT_CHECKS
แท็ก:action_command_lines
--[no]objc_enable_binary_stripping
ค่าเริ่มต้น: "false"-
กำหนดว่าจะทำการลบสัญลักษณ์และโค้ดที่ตายแล้วในไบนารีที่ลิงก์หรือไม่ ระบบจะดำเนินการลบข้อมูลในไบนารีหากระบุทั้ง 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>
default: ดูคำอธิบาย-
ระบุส่วนต่อท้ายที่จะเพิ่มลงในไดเรกทอรีการกําหนดค่า
แท็ก:loses_incremental_state
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--propeller_optimize=<a build target label>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ Propeller เพื่อเพิ่มประสิทธิภาพเป้าหมายการสร้าง โปรไฟล์ Propeller ต้องมีไฟล์อย่างน้อย 1 ใน 2 ไฟล์ ได้แก่ โปรไฟล์ cc และโปรไฟล์ ld แฟล็กนี้ยอมรับป้ายกำกับบิลด์ซึ่งต้องอ้างถึงไฟล์อินพุตโปรไฟล์ใบพัด เช่น ไฟล์ BUILD ที่กําหนดป้ายกํากับใน a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",) อาจต้องเพิ่มคําสั่ง exports_files ลงในแพ็กเกจที่เกี่ยวข้องเพื่อให้ Bazel เห็นไฟล์เหล่านี้ ตัวเลือกนี้ต้องใช้ในรูปแบบ --propeller_optimize=//a/b:propeller_profile
แท็ก:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
default: ดูคำอธิบาย-
ชื่อเส้นทางสัมบูรณ์ของไฟล์ cc_profile สำหรับบิลด์ Propeller Optimized
แท็ก:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
default: ดูคำอธิบาย-
ชื่อเส้นทางแบบสัมบูรณ์ของไฟล์ ld_profile สำหรับบิลด์ Propeller Optimized
แท็ก:affects_outputs
--run_under=<a prefix in front of command>
default: ดูคำอธิบาย-
คำนำหน้าที่จะแทรกไว้ก่อนไฟล์ปฏิบัติการสำหรับคำสั่ง "test" และ "run" หากค่าคือ "foo -bar" และบรรทัดคำสั่งสำหรับการดำเนินการคือ "test_binary -baz" บรรทัดคำสั่งสุดท้ายคือ "foo -bar test_binary -baz" บรรทัดคำสั่งนี้อาจเป็นป้ายกำกับของเป้าหมายสั่งการได้ด้วย ตัวอย่างบางส่วน ได้แก่ "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", '//package:target --options'
แท็ก:action_command_lines
-
หากเป็น "จริง" ระบบจะแชร์ไลบรารีเนทีฟที่มีฟังก์ชันการทำงานเหมือนกันระหว่างเป้าหมายต่างๆ
แท็ก:loading_and_analysis
,affects_outputs
--[no]stamp
ค่าเริ่มต้น: "false"-
ประทับเวลาไบนารีด้วยวันที่ ชื่อผู้ใช้ ชื่อโฮสต์ ข้อมูลเวิร์กスペース ฯลฯ
แท็ก:affects_outputs
- ค่าเริ่มต้น
--strip=<always, sometimes or never>
: "บางครั้ง" -
ระบุว่าจะลบข้อมูลโค้ดที่ไม่จำเป็นในไฟล์ไบนารีและไลบรารีที่ใช้ร่วมกันหรือไม่ (โดยใช้ "-Wl,--strip-debug") ค่าเริ่มต้นของ "บางครั้ง" หมายถึง Strip iff --compilation_mode=fastbuild
แท็ก:affects_outputs
--stripopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง strip เมื่อสร้างไบนารี "<name>.stripped"
แท็ก:action_command_lines
,affects_outputs
--swiftcopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยังการคอมไพล์ Swift
แท็ก:action_command_lines
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--tvos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารี Apple tvOS
แท็ก:loses_incremental_state
,loading_and_analysis
- ค่าเริ่มต้น
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน tvOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ระบุ ระบบจะใช้ "tvos_sdk_version"
แท็ก:loses_incremental_state
--visionos_cpus=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple visionOS
แท็ก:loses_incremental_state
,loading_and_analysis
--watchos_cpus=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารี Apple watchOS
แท็ก:loses_incremental_state
,loading_and_analysis
- ค่าเริ่มต้น
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน WatchOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองเป้าหมายและอุปกรณ์ หากไม่ระบุ ให้ใช้ "watchos_sdk_version"
แท็ก:loses_incremental_state
--xbinary_fdo=<a build target label>
default: ดูคำอธิบาย-
ใช้ข้อมูลโปรไฟล์ XbinaryFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อโปรไฟล์ข้ามไบนารีเริ่มต้น เมื่อใช้ตัวเลือกนี้ร่วมกับ --fdo_instrument/--fdo_optimize/--fdo_profile ตัวเลือกเหล่านั้นจะมีผลเสมอ ราวกับว่าไม่ได้ระบุ xbinary_fdo เลย
แท็ก:affects_outputs
- ตัวเลือกที่มีผลต่อความเคร่งครัดในการบังคับใช้อินพุตบิลด์ที่ถูกต้อง (เช่น คำจำกัดความของกฎ ชุดค่าผสม Flag ฯลฯ)
--auto_cpu_environment_group=<a build target label>
ค่าเริ่มต้น: ""-
ประกาศ environment_group ที่จะใช้สําหรับการแมปค่า cpu กับค่า target_environment โดยอัตโนมัติ
แท็ก:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
ค่าเริ่มต้น: "false"-
ตรวจสอบว่าข้อจำกัดการอนุญาตให้ใช้สิทธิที่แพ็กเกจที่ต้องพึ่งพากำหนดไว้ไม่ขัดแย้งกับโหมดการจัดจำหน่ายของเป้าหมายที่สร้าง โดยค่าเริ่มต้น ระบบจะไม่ตรวจสอบใบอนุญาต
แท็ก:build_file_semantics
--[no]check_visibility
ค่าเริ่มต้น: "true"-
หากปิดใช้ ระบบจะลดระดับข้อผิดพลาดด้านการแสดงผลในข้อกําหนดของเป้าหมายเป็นคําเตือน
แท็ก:build_file_semantics
--[no]desugar_for_android
ค่าเริ่มต้น: "true"-
กำหนดว่าจะ Dexugar ไบต์โค้ด Java 8 ก่อนถอดรหัสหรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
ค่าเริ่มต้น: "false"-
การรวมไลบรารี Java 8 ที่รองรับไว้ในแอปสำหรับอุปกรณ์รุ่นเดิมหรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
ค่าเริ่มต้น: "true"-
ตรวจสอบสภาพแวดล้อมที่เป้าหมายแต่ละรายการเข้ากันได้ และรายงานข้อผิดพลาดหากเป้าหมายใดมีทรัพยากร Dependencies ที่ไม่รองรับสภาพแวดล้อมเดียวกัน
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]experimental_check_desugar_deps
: "จริง" -
ระบุว่าจะตรวจสอบการลดน้ำตาลที่ถูกต้องอีกครั้งที่ระดับไบนารีของ Android หรือไม่
แท็ก:eagerness_to_exit
,loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--experimental_import_deps_checking=<off, warning or error>
: "ปิด" -
เมื่อเปิดใช้แล้ว ให้ตรวจสอบว่ารายการอ้างอิงของ aar_import สมบูรณ์หรือไม่ การบังคับใช้นี้อาจทำให้บิลด์ใช้งานไม่ได้ หรืออาจส่งผลให้เกิดคำเตือนเท่านั้น
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--experimental_one_version_enforcement=<off, warning or error>
: "ปิด" -
เมื่อเปิดใช้ กฎ java_binary จะต้องไม่มีไฟล์คลาสเดียวกันใน classpath มากกว่า 1 เวอร์ชัน การบังคับใช้นี้อาจทำให้บิลด์ใช้งานไม่ได้ หรืออาจส่งผลให้เกิดคำเตือนเท่านั้น
แท็ก:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
ค่าเริ่มต้น: "default"-
หากเป็น "จริง" ระบบจะตรวจสอบว่าเป้าหมาย Java ประกาศเป้าหมายทั้งหมดที่ใช้โดยตรงเป็น Dependency อย่างชัดเจน
แท็ก:build_file_semantics
,eagerness_to_exit
- ค่าเริ่มต้น
--[no]incompatible_check_testonly_for_output_files
: "เท็จ" -
หากเปิดใช้ ให้ตรวจสอบ testonly สำหรับเป้าหมายที่เป็นข้อกําหนดเบื้องต้นซึ่งเป็นไฟล์เอาต์พุตโดยค้นหา testonly ของกฎการสร้าง ซึ่งตรงกับการตรวจสอบระดับการเข้าถึง
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
ค่าเริ่มต้น: "false"-
หากเปิดใช้ การตรวจสอบระดับการเข้าถึงจะมีผลกับการติดตั้งใช้งานเครื่องมือทางเทคนิคด้วย
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
ค่าเริ่มต้น: "false"-
หากเปิดใช้ ระบบจะปิดใช้การใช้กฎ Android ดั้งเดิมโดยตรง โปรดใช้กฎของ Android ของ Starlark จาก https://github.com/bazelbuild/rules_android
แท็ก:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
ค่าเริ่มต้น: "false"-
ไม่มีการดำเนินการใดๆ เก็บไว้ที่นี่เพื่อให้มีความเข้ากันได้แบบย้อนหลัง
แท็ก:eagerness_to_exit
,incompatible_change
--[no]incompatible_python_disable_py2
ค่าเริ่มต้น: "true"-
หากเป็นจริง การใช้การตั้งค่า Python 2 จะทำให้เกิดข้อผิดพลาด ซึ่งรวมถึง python_version=PY2, srcs_version=PY2 และ srcs_version=PY2ONLY ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/15684
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" Bazel จะตรวจสอบการรวมส่วนหัวของไดเรกทอรีระดับบนสุดด้วย (ดูข้อมูลเพิ่มเติมที่ https://github.com/bazelbuild/bazel/issues/10047)
แท็ก:loading_and_analysis
,incompatible_change
--[no]one_version_enforcement_on_java_tests
ค่าเริ่มต้น: "true"-
เมื่อเปิดใช้และตั้งค่า experimental_one_version_enforcement เป็นค่าที่ไม่ใช่ NONE ให้บังคับใช้เวอร์ชันเดียวในเป้าหมาย java_test คุณสามารถปิดการแจ้งว่าไม่เหมาะสมนี้เพื่อปรับปรุงประสิทธิภาพการทดสอบให้ดียิ่งขึ้นได้ โดยไม่ต้องกลัวว่าจะมีการละเมิดเวอร์ชันใดเวอร์ชันหนึ่ง
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--python_native_rules_allowlist=<a build target label>
: ดูคำอธิบาย -
รายการที่อนุญาต (เป้าหมาย package_group) เพื่อใช้เมื่อบังคับใช้ --incompatible_python_disallow_native_rules
แท็ก:loading_and_analysis
--[no]strict_filesets
ค่าเริ่มต้น: "false"-
หากเปิดใช้ตัวเลือกนี้ ระบบจะรายงานว่าชุดไฟล์ข้ามขอบเขตของแพ็กเกจเป็นข้อผิดพลาด
แท็ก:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
ค่าเริ่มต้น: "error"-
หากไม่ "ปิดใช้" ให้ตรวจสอบว่าเป้าหมาย protocol_library ประกาศอย่างชัดแจ้งว่าเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้นของ
--strict_public_imports=<off, warn, error, strict or default>
: "off" -
ยกเว้นในกรณีที่ปิดอยู่ ระบบจะตรวจสอบว่าเป้าหมาย proto_library ประกาศเป้าหมายทั้งหมดที่ใช้ใน "import public" เป็นการนําส่งอย่างชัดแจ้ง
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" จะต้องประกาศส่วนหัวที่พบผ่านเส้นทางรวมของระบบ (-isystem) ด้วย
แท็ก:loading_and_analysis
,eagerness_to_exit
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--target_environment=<a build target label>
รายการ -
ประกาศสภาพแวดล้อมเป้าหมายของบิลด์นี้ ต้องเป็นการอ้างอิงป้ายกำกับไปยังกฎ "environment" หากระบุไว้ เป้าหมายระดับบนสุดทั้งหมดต้องเข้ากันได้กับสภาพแวดล้อมนี้
แท็ก:changes_inputs
- ตัวเลือกที่ส่งผลต่อเอาต์พุตการลงนามของบิลด์
--apk_signing_method=<v1, v2, v1_v2 or v4>
ค่าเริ่มต้น: "v1_v2"-
การใช้งานเพื่อรับรอง APK
แท็ก:action_command_lines
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--[no]device_debug_entitlements
: "จริง" -
หากตั้งค่าไว้และโหมดการคอมไพล์ไม่ใช่ "opt" แอป objc จะรวมการให้สิทธิ์แก้ไขข้อบกพร่องเมื่อลงชื่อ
แท็ก:changes_inputs
--ios_signing_cert_name=<a string>
default: ดูคำอธิบาย-
ชื่อใบรับรองที่จะใช้สำหรับการลงนาม iOS หากไม่ได้ตั้งค่า ระบบจะกลับไปใช้โปรไฟล์การจัดสรร อาจเป็นค่ากำหนดข้อมูลระบุตัวตนในพวงกุญแจของใบรับรองหรือ (สตริงย่อย) ของชื่อจริงของใบรับรอง ตามหน้าข้อมูลของ codesign (ข้อมูลระบุตัวตนสำหรับการลงนาม)
แท็ก:action_command_lines
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงโดยไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE
--[no]incompatible_disallow_legacy_py_provider
ค่าเริ่มต้น: "true"-
No-op, will be removed soon.
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" ไม่อนุญาตแอตทริบิวต์ sdk_frameworks และ external_sdk_frameworks ใน objc_library andobjc_import
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" ให้ตั้งค่าเริ่มต้นเป็น "จริง" สําหรับแอตทริบิวต์ alwayslink ใน objc_library และ objc_import
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
ค่าเริ่มต้น: "false"-
เมื่อเป็น "จริง" ระบบจะแสดงข้อผิดพลาดเมื่อใช้กฎ py_* ในตัว คุณควรใช้กฎ rule_python แทน ดูข้อมูลเพิ่มเติมและวิธีการย้ายข้อมูลได้ที่ https://github.com/bazelbuild/bazel/issues/17773
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่ควบคุมลักษณะการทำงานของสภาพแวดล้อมการทดสอบหรือตัวดำเนินการทดสอบมีดังนี้
--[no]allow_analysis_failures
ค่าเริ่มต้น: "false"-
หากเป็นจริง การวิเคราะห์เป้าหมายของกฎไม่สำเร็จส่งผลให้เกิดการเผยแพร่อินสแตนซ์ของ AnalysisFailureInfo ของเป้าหมายที่มีคำอธิบายข้อผิดพลาด แทนที่จะทำให้บิลด์ล้มเหลว
แท็ก:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
ค่าเริ่มต้น: "2000"-
กำหนดจำนวนสูงสุดของความสัมพันธ์แบบสื่อกลางผ่านแอตทริบิวต์กฎที่มีการเปลี่ยนการกำหนดค่า for_analysis_testing การเกินขีดจํากัดนี้จะทำให้เกิดข้อผิดพลาดเกี่ยวกับกฎ
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]break_build_on_parallel_dex2oat_failure
: "เท็จ" -
หากความล้มเหลวจริงในการดำเนินการ dex2oat จะทำให้บิลด์ขัดข้องแทนที่จะเรียกใช้ dex2oat ระหว่างรันไทม์ทดสอบ
แท็ก:loading_and_analysis
,experimental
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g. memory=10,30,60,100>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างจำนวนทรัพยากรเริ่มต้นสำหรับการทดสอบ รูปแบบที่คาดไว้คือ <resource>=<value> หากตัวเลขจำนวนบวกเดียวระบุเป็น <value> จำนวนดังกล่าวจะแทนที่ทรัพยากรเริ่มต้นสำหรับขนาดการทดสอบทั้งหมด หากระบุตัวเลข 4 รายการที่คั่นด้วยคอมมา ระบบจะลบล้างจำนวนทรัพยากรสําหรับขนาดการทดสอบขนาดเล็ก กลาง ใหญ่ และใหญ่มากตามลําดับ ค่าอาจเป็น HOST_RAM/HOST_CPU ตามด้วย [-|*]<float> (ไม่บังคับ) ก็ได้ (เช่น memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4) ทรัพยากรการทดสอบเริ่มต้นที่ระบุโดย Flag นี้จะลบล้างโดยทรัพยากรที่ระบุอย่างชัดเจนในแท็ก
--[no]experimental_android_use_parallel_dex2oat
ค่าเริ่มต้น: "false"-
ใช้ 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')>
default: ดูคำอธิบาย-
เวอร์ชัน iOS ที่จะใช้งานบนเครื่องจำลองเมื่อเรียกใช้หรือทดสอบ ระบบจะละเว้นค่านี้สำหรับกฎ ios_test หากมีการระบุอุปกรณ์เป้าหมายในกฎ
แท็ก:test_runner
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ระบุจํานวนครั้งที่จะเรียกใช้การทดสอบแต่ละรายการ หากการดำเนินการเหล่านั้นล้มเหลวไม่ว่าด้วยเหตุผลใดก็ตาม จะถือว่าการทดสอบทั้งหมดไม่ผ่าน โดยปกติแล้วค่าที่ระบุจะเป็นจํานวนเต็มเท่านั้น ตัวอย่างเช่น --runs_per_test=3 จะเรียกใช้การทดสอบทั้งหมด 3 ครั้ง ไวยากรณ์สำรอง: regex_filter@runs_per_test โดยที่ runs_per_test หมายถึงค่าจำนวนเต็ม และ regex_filter หมายถึงรายการรูปแบบนิพจน์ทั่วไปที่รวมและไม่รวม (ดู --instrumentation_filter ด้วย) ตัวอย่างเช่น --runs_per_test=//foo/.*,-//foo/bar/.*@3 เรียกใช้การทดสอบทั้งหมดใน //foo/ ยกเว้นการทดสอบที่อยู่ใน foo/bar 3 ครั้ง ตัวเลือกนี้ส่งได้หลายครั้ง อาร์กิวเมนต์ที่ตรงกันซึ่งส่งล่าสุดจะมีความสําคัญเหนือกว่า หากไม่พบรายการที่ตรงกัน ระบบจะเรียกใช้การทดสอบเพียงครั้งเดียว
--test_env=<a 'name=value' assignment with an optional value part>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุตัวแปรสภาพแวดล้อมเพิ่มเติมที่จะแทรกลงในสภาพแวดล้อมโปรแกรมรันทดสอบ คุณสามารถระบุตัวแปรโดยใช้ชื่อ ซึ่งระบบจะอ่านค่าจากสภาพแวดล้อมไคลเอ็นต์ Bazel หรือจะระบุโดยใช้คู่ชื่อ=ค่าก็ได้ คุณใช้ตัวเลือกนี้ได้หลายครั้งเพื่อระบุตัวแปรหลายรายการ ใช้เฉพาะโดยคำสั่ง "การทดสอบ Bazel" เท่านั้น
แท็ก:test_runner
- ค่าเริ่มต้นของ
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - ลบล้างค่าการหมดเวลาการทดสอบเริ่มต้นสําหรับการหมดเวลาการทดสอบ (เป็นวินาที) หากระบุค่าจำนวนเต็มบวกเพียงค่าเดียว ระบบจะลบล้างหมวดหมู่ทั้งหมด หากระบุจำนวนเต็มที่คั่นด้วยคอมมา 4 ตัวเลข ค่าดังกล่าวจะลบล้างระยะหมดเวลาสำหรับแบบสั้น ปานกลาง ยาว และนิรันดร์ (ตามลำดับนั้น) ไม่ว่ารูปแบบใด ค่า -1 จะบอกให้ Blaze ใช้การหมดเวลาเริ่มต้นสำหรับหมวดหมู่นั้น
--[no]zip_undeclared_test_outputs
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ระบบจะเก็บถาวรเอาต์พุตการทดสอบที่ไม่ได้ประกาศไว้ในไฟล์ ZIP
แท็ก:test_runner
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตการค้นหาและความหมาย
--aspect_deps=<off, conservative or precise>
ค่าเริ่มต้น: "conservative"-
วิธีแก้ไขการพึ่งพาแง่มุมเมื่อรูปแบบเอาต์พุตเป็นหนึ่งใน {xml,proto,record} "ปิด" หมายความว่าไม่มีการแก้ไขข้อกําหนดของมิติข้อมูล "แบบอนุรักษ์นิยม" (ค่าเริ่มต้น) หมายความว่าระบบจะเพิ่มข้อกําหนดของมิติข้อมูลที่ประกาศไว้ทั้งหมด ไม่ว่าจะได้รับคลาสกฎของข้อกําหนดโดยตรงหรือไม่ "แม่นยํา" หมายความว่าระบบจะเพิ่มเฉพาะมิติข้อมูลเหล่านั้นที่อาจใช้งานได้โดยพิจารณาจากคลาสกฎของข้อกําหนดโดยตรง โปรดทราบว่าโหมดแม่นยำต้องมีการโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียว ซึ่งจะทำให้ช้ากว่าโหมดอื่นๆ นอกจากนี้ โปรดทราบว่าโหมดที่แม่นยำก็อาจไม่แม่นยำทั้งหมด เนื่องจากการตัดสินใจว่าจะคำนวณแง่มุมใดหรือไม่นั้นจะเกิดขึ้นในระยะการวิเคราะห์ ซึ่งไม่ได้ทำงานระหว่าง "การค้นหา Bazel"
แท็ก:build_file_semantics
--[no]consistent_labels
ค่าเริ่มต้น: "false"-
หากเปิดใช้ คำสั่งการค้นหาทุกคำสั่งจะแสดงป้ายกำกับราวกับว่าฟังก์ชัน Starlark <code>str</code> ใช้กับอินสแตนซ์ <code>Label</code> ซึ่งมีประโยชน์สําหรับเครื่องมือที่ต้องจับคู่เอาต์พุตของคําสั่งการค้นหาและ/หรือป้ายกำกับต่างๆ ที่กฎสร้างขึ้น หากไม่ได้เปิดใช้ ตัวจัดรูปแบบเอาต์พุตจะแสดงชื่อที่เก็บที่ชัดเจน (สัมพันธ์กับที่เก็บหลัก) แทนเพื่อให้อ่านเอาต์พุตได้ง่ายขึ้น
แท็ก:terminal_output
--[no]experimental_explicit_aspects
ค่าเริ่มต้น: "false"-
aquery, cquery: ระบุว่าจะรวมการดำเนินการที่เกิดจากแง่มุมไว้ในเอาต์พุตหรือไม่ query: no-op (ระบบจะตามแง่มุมเสมอ)
แท็ก:terminal_output
--[no]graph:factored
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ระบบจะแสดงกราฟที่ "แยกปัจจัย" กล่าวคือ จะผสานโหนดที่เทียบเท่ากันตามแบบแผนเข้าด้วยกันและต่อป้ายกำกับของโหนดเหล่านั้น ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
--graph:node_limit=<an integer>
ค่าเริ่มต้น: "512"-
ความยาวสูงสุดของสตริงป้ายกำกับสำหรับโหนดกราฟในเอาต์พุต ระบบจะตัดป้ายกำกับที่ยาวกว่าออก โดย -1 หมายความว่าไม่ตัด ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
--[no]implicit_deps
ค่าเริ่มต้น: "true"-
หากเปิดใช้ ทรัพยากร Dependency ที่ไม่ชัดแจ้งจะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงานอยู่ ทรัพยากร Dependency โดยนัยคือทรัพยากรที่ไม่มีการระบุอย่างชัดแจ้งในไฟล์ BUILD แต่เพิ่มโดย bazel สําหรับ cquery ตัวเลือกนี้จะควบคุมการกรองเครื่องมือทางเทคนิคที่แก้ไขแล้ว
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]include_aspects
: "true" -
aquery, cquery: ระบุว่าจะรวมการดำเนินการที่เกิดจากแง่มุมไว้ในเอาต์พุตหรือไม่ query: no-op (ระบบจะตามแง่มุมเสมอ)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]incompatible_package_group_includes_double_slash
: "จริง" -
หากเปิดใช้ เมื่อแสดงผลแอตทริบิวต์ "packages" ของ package_group ระบบจะไม่ละเว้น "//" ขึ้นต้น
แท็ก:terminal_output
,incompatible_change
--[no]infer_universe_scope
ค่าเริ่มต้น: "false"-
หากไม่ได้ตั้งค่า และ --universe_scope แล้ว ระบบจะอนุมานค่าของ --universe_scope เป็นรายการรูปแบบเป้าหมายที่ไม่ซ้ำกันในนิพจน์การค้นหา โปรดทราบว่าค่า --universe_scope ที่อนุมานสําหรับนิพจน์การค้นหาที่ใช้ฟังก์ชันระดับจักรวาล (เช่น `allrdeps`) อาจไม่ใช่สิ่งที่คุณต้องการ คุณจึงควรใช้ตัวเลือกนี้เฉพาะในกรณีที่คุณเข้าใจสิ่งที่ทําอยู่ ดูรายละเอียดและตัวอย่างได้ที่ https://bazel.build/reference/query#sky-query หากตั้งค่า --universe_scope แล้ว ระบบจะไม่สนใจค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้มีผลกับ "query" เท่านั้น (ไม่ใช่ "cquery")
แท็ก:loading_and_analysis
--[no]line_terminator_null
ค่าเริ่มต้น: "false"-
แต่ละรูปแบบสิ้นสุดด้วย \0 แทนบรรทัดใหม่หรือไม่
แท็ก:terminal_output
--[no]nodep_deps
ค่าเริ่มต้น: "true"-
หากเปิดใช้ Dep จากแอตทริบิวต์ "nodep" จะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ตัวอย่างที่พบบ่อยของแอตทริบิวต์ "nodep" คือ "visibility" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ "info build-language" เพื่อดูข้อมูลเกี่ยวกับแอตทริบิวต์ "nodep" ทั้งหมดในภาษาของบิลด์
แท็ก:build_file_semantics
--output=<a string>
ค่าเริ่มต้น: "label"-
รูปแบบที่ควรพิมพ์ผลลัพธ์ cquery ค่าที่อนุญาตสําหรับ cquery ได้แก่ label, label_kind, textproto, transitions, proto, streamed_proto, jsonproto หากเลือก "transitions" คุณจะต้องระบุตัวเลือก --transitions=(lite|full) ด้วย
แท็ก:terminal_output
--[no]proto:default_values
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ระบบจะรวมแอตทริบิวต์ที่ค่าไม่ได้ระบุไว้อย่างชัดเจนในไฟล์ BUILD หากเป็น "เท็จ" ระบบจะไม่รวมแอตทริบิวต์ดังกล่าว ตัวเลือกนี้ใช้ได้กับ --output=proto
แท็ก:terminal_output
--[no]proto:definition_stack
ค่าเริ่มต้น: "false"-
ป้อนข้อมูลในช่อง proto ของ definition_stack ซึ่งจะบันทึกสแต็กการเรียกใช้ Starlark สำหรับอินสแตนซ์กฎแต่ละรายการ ณ เวลาที่กําหนดคลาสของกฎ
แท็ก:terminal_output
--[no]proto:flatten_selects
ค่าเริ่มต้น: "true"-
หากเปิดใช้ ระบบจะยุบแอตทริบิวต์ที่กำหนดค่าได้ซึ่งสร้างโดย select() สําหรับประเภทลิสต์ การแสดงผลแบบแบนคือลิสต์ที่มีค่าแต่ละค่าของแผนที่ที่เลือกเพียงครั้งเดียว ระบบจะแยกประเภทสเกลาร์เป็นค่าว่าง
แท็ก:build_file_semantics
--[no]proto:include_attribute_source_aspects
ค่าเริ่มต้น: "false"-
ป้อนข้อมูลในช่อง Proto ของ source_aspect_name ของแต่ละแอตทริบิวต์ด้วยแง่มุมของแหล่งที่มาของแอตทริบิวต์นั้น (สตริงว่างเปล่าหากไม่มีข้อมูล)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:include_configurations
: "true" -
หากเปิดใช้ เอาต์พุต proto จะมีข้อมูลเกี่ยวกับการกําหนดค่า เมื่อปิดใช้ รูปแบบเอาต์พุต CQuery Proto จะคล้ายกับรูปแบบเอาต์พุตการค้นหา
แท็ก:affects_outputs
--[no]proto:include_synthetic_attribute_hash
ค่าเริ่มต้น: "false"-
กำหนดว่าจะคำนวณและป้อนข้อมูลแอตทริบิวต์ $internal_attr_hash หรือไม่
แท็ก:terminal_output
--[no]proto:instantiation_stack
ค่าเริ่มต้น: "false"-
ป้อนข้อมูลสแต็กการเรียกใช้การสร้างอินสแตนซ์ของแต่ละกฎ โปรดทราบว่าต้องมีสแต็กอยู่
แท็ก:terminal_output
--[no]proto:locations
ค่าเริ่มต้น: "true"-
แสดงข้อมูลตำแหน่งในเอาต์พุต proto หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้น
--proto:output_rule_attrs=<comma-separated list of options>
: "ทั้งหมด" -
รายการแอตทริบิวต์ที่คั่นด้วยคอมมาที่จะรวมไว้ในเอาต์พุต ค่าเริ่มต้นคือแอตทริบิวต์ทั้งหมด ตั้งค่าเป็นสตริงว่างเปล่าเพื่อไม่ให้แสดงแอตทริบิวต์ใดๆ ตัวเลือกนี้ใช้ได้กับ --output=proto
แท็ก:terminal_output
--[no]proto:rule_inputs_and_outputs
ค่าเริ่มต้น: "true"-
การป้อนข้อมูลในช่อง rule_input และ rule_output หรือไม่
แท็ก:terminal_output
--query_file=<a string>
ค่าเริ่มต้น: ""-
หากตั้งค่าไว้ ระบบจะอ่านข้อความค้นหาจากไฟล์ที่ระบุชื่อไว้ที่นี่แทนที่จะอ่านจากบรรทัดคำสั่ง การระบุไฟล์ที่นี่พร้อมกับการค้นหาบรรทัดคำสั่งเป็นข้อผิดพลาด
แท็ก:changes_inputs
- ค่าเริ่มต้น
--[no]relative_locations
: "เท็จ" -
หากเป็นจริง ตำแหน่งของไฟล์ BUILD ใน XML และเอาต์พุต Pro จะสัมพันธ์กัน โดยค่าเริ่มต้น เอาต์พุตตำแหน่งจะเป็นเส้นทางแบบสัมบูรณ์และจะไม่สอดคล้องกันในแต่ละเครื่อง คุณสามารถตั้งค่าตัวเลือกนี้เป็น "จริง" เพื่อให้ได้ผลลัพธ์ที่สอดคล้องกันในทุกเครื่อง
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--show_config_fragments=<off, direct or transitive>
: "off" -
แสดงข้อมูลโค้ดการกำหนดค่าที่กฎต้องการและข้อมูลโค้ดที่ต้องพึ่งพากัน วิธีนี้จะมีประโยชน์ในการประเมินว่าสามารถตัดกราฟเป้าหมายที่กำหนดค่าไว้ได้มากน้อยเพียงใด
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--starlark:expr=<a string>
: "" -
นิพจน์ Starlark เพื่อจัดรูปแบบเป้าหมายที่กําหนดค่าแต่ละรายการในโหมด --output=starlark ของ cquery เป้าหมายที่กําหนดค่าไว้จะเชื่อมโยงกับ "target" หากไม่ได้ระบุ --starlark:expr หรือ --starlark:file ตัวเลือกนี้จะมีค่าเริ่มต้นเป็น "str(target.label)" การระบุทั้ง --starlark:expr และ --starlark:file จะทำให้เกิดข้อผิดพลาด
แท็ก:terminal_output
--starlark:file=<a string>
ค่าเริ่มต้น: ""-
ชื่อไฟล์ที่กําหนดฟังก์ชัน Starlark ชื่อ "format" ซึ่งมีอาร์กิวเมนต์ 1 รายการ ซึ่งนําไปใช้กับแต่ละเป้าหมายที่กําหนดค่าไว้เพื่อจัดรูปแบบเป็นสตริง การระบุทั้ง --starlark:expr และ --starlark:file จะทำให้เกิดข้อผิดพลาด ดูรายละเอียดเพิ่มเติมเกี่ยวกับ --output=starlark ได้ที่ความช่วยเหลือ
แท็ก:terminal_output
--[no]tool_deps
ค่าเริ่มต้น: "true"-
คำค้นหา: หากปิดใช้ ทรัพยากร Dependency ใน "การกำหนดค่าการดำเนินการ" จะไม่รวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ขอบความเกี่ยวข้องของ "การกำหนดค่า exec" เช่น ขอบจากกฎ "proto_library" ไปยังคอมไพเลอร์โปรโตคอล มักจะชี้ไปยังเครื่องมือที่ดำเนินการระหว่างการสร้าง ไม่ใช่ส่วนหนึ่งของโปรแกรม "เป้าหมาย" เดียวกัน
Cquery: หากปิดใช้ ระบบจะกรองเป้าหมายที่กําหนดค่าไว้ทั้งหมดซึ่งข้ามการเปลี่ยนสถานะการดําเนินการจากเป้าหมายระดับบนสุดที่ค้นพบเป้าหมายที่กําหนดค่าไว้นี้ ซึ่งหมายความว่าหากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าเป้าหมาย ระบบจะแสดงเฉพาะเป้าหมายที่กำหนดค่าไว้ซึ่งอยู่ในการกำหนดค่าเป้าหมายด้วย หากเป้าหมายระดับบนสุดอยู่ในการกําหนดค่า exec ระบบจะแสดงเฉพาะเป้าหมายที่กําหนดค่า exec ตัวเลือกนี้จะ "ไม่" ยกเว้น Toolchain ที่แก้ไขแล้ว
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--transitions=<full, lite or none>
: "ไม่มี" -
รูปแบบที่ cquery จะพิมพ์ข้อมูลการเปลี่ยน
แท็ก:affects_outputs
--universe_scope=<comma-separated list of options>
ค่าเริ่มต้น: ""-
ชุดรูปแบบเป้าหมายที่คั่นด้วยคอมมา (บวกและการลบ) การค้นหาอาจดำเนินการในจักรวาลที่กําหนดโดยการปิดเชิงการเปลี่ยนรูปแบบของเป้าหมายที่ระบุ ตัวเลือกนี้ใช้สำหรับคำสั่ง query และ cquery
สำหรับ cquery อินพุตของตัวเลือกนี้จะเป็นเป้าหมายในการสร้างคำตอบทั้งหมด ดังนั้นตัวเลือกนี้อาจส่งผลต่อการกําหนดค่าและการเปลี่ยน หากไม่ได้ระบุตัวเลือกนี้ ระบบจะถือว่าเป้าหมายระดับบนสุดเป็นเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหา หมายเหตุ: สําหรับ cquery การไม่ระบุตัวเลือกนี้อาจทําให้บิลด์ใช้งานไม่ได้ หากเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหาไม่สามารถสร้างด้วยตัวเลือกระดับบนสุด
แท็ก:loading_and_analysis
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพของเวลาสร้าง
--[no]experimental_filter_library_jar_with_program_jar
ค่าเริ่มต้น: "false"-
กรอง ProgramJar ของ ProGuard เพื่อนำคลาสที่อยู่ใน LibraryJar ออกด้วย
แท็ก:action_command_lines
--[no]experimental_inmemory_dotd_files
ค่าเริ่มต้น: "true"-
หากเปิดใช้ ระบบจะส่งไฟล์ .d ของ C++ ในหน่วยความจำจากโหนดการสร้างระยะไกลโดยตรงแทนที่จะเขียนลงในดิสก์
แท็ก:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
ค่าเริ่มต้น: "true"-
หากเปิดใช้ ระบบจะส่งไฟล์ Dependency (.jdeps) ที่สร้างขึ้นจากการคอมไพล์ Java ผ่านหน่วยความจำจากโหนดการสร้างระยะไกลโดยตรงแทนที่จะเขียนลงในดิสก์
แท็ก:loading_and_analysis
,execution
,affects_outputs
,experimental
- ค่าเริ่มต้น
--[no]experimental_objc_include_scanning
: "เท็จ" -
กำหนดว่าจะทำการสแกนรวมสำหรับ Objective C/C++ หรือไม่
แท็ก:loading_and_analysis
,execution
,changes_inputs
- ค่าเริ่มต้น
--[no]experimental_retain_test_configuration_across_testonly
: "เท็จ" -
เมื่อเปิดใช้ --trim_test_configuration จะไม่ตัดการกำหนดค่าการทดสอบสำหรับกฎที่ทำเครื่องหมายว่า testonly=1 การดำเนินการนี้มีไว้เพื่อลดปัญหาการขัดแย้งของการดำเนินการเมื่อกฎที่ไม่ใช่การทดสอบขึ้นอยู่กับกฎ cc_test จะไม่มีผลหาก --trim_test_configuration เป็นเท็จ
แท็ก:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
ค่าเริ่มต้น: "false"-
หากเปิดใช้ คุณจะสามารถใช้ cc_import เวอร์ชัน Starlark ได้
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_unsupported_and_brittle_include_scanning
: "เท็จ" -
การจำกัดอินพุตให้แคบลงสำหรับการคอมไพล์ C/C++ โดยการแยกวิเคราะห์บรรทัด #include จากไฟล์อินพุต ซึ่งจะช่วยปรับปรุงประสิทธิภาพและความสามารถในการเพิ่มประสิทธิภาพโดยการลดขนาดของต้นไม้อินพุตการคอมไพล์ อย่างไรก็ตาม การดำเนินการนี้อาจทำให้บิลด์ใช้งานไม่ได้เนื่องจากเครื่องมือสแกนรวมไม่ได้ใช้ความหมายของ C preprocessor อย่างเต็มรูปแบบ โดยเฉพาะอย่างยิ่ง จะไม่เข้าใจคำสั่ง #include แบบไดนามิกและไม่สนใจตรรกะแบบมีเงื่อนไขของโปรแกรมประมวลผลข้อมูลล่วงหน้า คุณต้องใช้โดยยอมรับความเสี่ยงเอง เราจะปิดปัญหาทั้งหมดที่เกี่ยวข้องกับการแจ้งว่าไม่เหมาะสมนี้
แท็ก:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
ค่าเริ่มต้น: "true"-
ทํางานส่วนใหญ่สําหรับการจัดทําดัชนีแยกกันสําหรับไฟล์ Jar แต่ละไฟล์
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
ค่าเริ่มต้น: "true"-
หากตั้งค่าไว้ ระบบจะใช้ไฟล์ .d ที่ clang สร้างขึ้นเพื่อตัดชุดอินพุตที่ส่งไปยังการคอมไพล์ objc
แท็ก:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
ค่าเริ่มต้น: "false"-
เมื่อสร้างเป้าหมาย //a:a ให้ประมวลผลส่วนหัวในเป้าหมายทั้งหมดที่ //a:a นั้นใช้ (หากเปิดใช้การประมวลผลส่วนหัวสําหรับเครื่องมือทางเทคนิค)
แท็ก: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 และเป้าหมายที่เฉพาะเจาะจงเพื่อดูว่าควรแก้ไขข้อบกพร่องใด คุณคั่นนิพจน์ทั่วไปหลายรายการด้วยคอมมา จากนั้นระบบจะตรวจสอบนิพจน์ทั่วไปแต่ละรายการแยกกัน หมายเหตุ: เอาต์พุตของ Flag นี้จะซับซ้อนมากและอาจเป็นประโยชน์ต่อผู้เชี่ยวชาญในการแก้ปัญหาเกี่ยวกับเครื่องมือทางเทคนิคเท่านั้น
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
--flag_alias=<a 'name=value' flag alias>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตั้งชื่อแบบย่อสำหรับแฟล็ก Starlark โดยจะใช้คู่คีย์-ค่าเดียวในรูปแบบ "<key>=<value>" เป็นอาร์กิวเมนต์
แท็ก:changes_inputs
--[no]incompatible_default_to_explicit_init_py
ค่าเริ่มต้น: "false"-
Flag นี้จะเปลี่ยนลักษณะการทำงานเริ่มต้นเพื่อไม่ให้ระบบสร้างไฟล์ __init__.py โดยอัตโนมัติในไฟล์รันไทม์ของเป้าหมาย Python อีกต่อไป กล่าวโดยละเอียดคือ เมื่อเป้าหมาย py_binary หรือ py_test มีการตั้งค่า legacy_create_init เป็น "auto" (ค่าเริ่มต้น) ระบบจะถือว่าค่านี้เป็นเท็จก็ต่อเมื่อมีการตั้งค่า Flag นี้เท่านั้น ดู 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 ที่ระบุโดยชุดเครื่องมือ Python แทนรันไทม์ที่ระบุโดย Flag รุ่นเดิม เช่น --python_top
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้น
--python_version=<PY2 or PY3>
: ดูคำอธิบาย -
โหมดเวอร์ชันหลักของ Python ไม่ว่าจะเป็น "PY2" หรือ "PY3" โปรดทราบว่าเป้าหมาย "py_binary" และ "py_test" จะลบล้างค่านี้ (แม้ว่าจะไม่ได้ระบุเวอร์ชันอย่างชัดเจน) จึงมักไม่มีเหตุผลที่จะต้องระบุแฟล็กนี้
แท็ก:loading_and_analysis
,affects_outputs
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้
--[no]cache_test_results
[-t
] ค่าเริ่มต้น: "อัตโนมัติ"- หากตั้งค่าเป็น "อัตโนมัติ" Bazel จะทำการทดสอบอีกครั้งเฉพาะในกรณีต่อไปนี้ (1) Bazel ตรวจพบการเปลี่ยนแปลงในการทดสอบหรือทรัพยากร Dependency (2) มีการทำเครื่องหมายการทดสอบว่าเป็นภายนอก (3) มีการขอทำการทดสอบหลายครั้งด้วย --runs_per_test หรือ(4) การทดสอบล้มเหลวก่อนหน้านี้ หากตั้งค่าเป็น "ใช่" Bazel จะแคชผลการทดสอบทั้งหมด ยกเว้นการทดสอบที่ทำเครื่องหมายว่าภายนอก หากตั้งค่าเป็น "no" ไว้ Bazel จะไม่แคชผลการทดสอบใดๆ
--[no]experimental_cancel_concurrent_tests
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" Blaze จะยกเลิกการทดสอบที่ทํางานพร้อมกันเมื่อการเรียกใช้ครั้งแรกสําเร็จ ซึ่งมีประโยชน์เมื่อใช้ร่วมกับ --runs_per_test_detects_flakes เท่านั้น
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_fetch_all_coverage_outputs
: "เท็จ" -
หากเป็น "จริง" Bazel จะดึงข้อมูลไดเรกทอรีข้อมูลการครอบคลุมทั้งหมดสําหรับการทดสอบแต่ละครั้งในระหว่างการเรียกใช้การครอบคลุม
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" การครอบคลุมสำหรับ clang จะสร้างรายงาน LCOV
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
ค่าเริ่มต้น: "true"- เลือกว่าจะสร้างแผนที่ส่วนหัว J2ObjC ควบคู่ไปกับการแปลง J2ObjC หรือไม่
- ค่าเริ่มต้น
--[no]experimental_j2objc_shorter_header_path
: "เท็จ" -
Whether to generate with shorter header path (uses "_ios" instead of "_j2objc").
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_java_classpath=<off, javabuilder or bazel>
: "javabuilder" - เปิดใช้เส้นทางคลาสที่ลดลงสำหรับการคอมไพล์ Java
--[no]experimental_limit_android_lint_to_android_constrained_java
ค่าเริ่มต้น: "false"-
จำกัด --experimental_run_android_lint_on_java_rules ไว้สำหรับไลบรารีที่เข้ากันได้กับ Android
แท็ก:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
ค่าเริ่มต้น: "false"-
กำหนดว่าจะตรวจสอบแหล่งที่มา java_* หรือไม่
แท็ก:affects_outputs
--[no]explicit_java_test_deps
ค่าเริ่มต้น: "false"- ระบุการพึ่งพา JUnit หรือ Hamcrest ใน java_test อย่างชัดเจนแทนที่จะรับจาก deps ของ TestRunner โดยไม่ได้ตั้งใจ ขณะนี้ใช้ได้กับ Bazel เท่านั้น
--host_java_launcher=<a build target label>
default: ดูคำอธิบาย- ตัวเปิด Java ที่เครื่องมือใช้ในระหว่างการบิลด์
--host_javacopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง Javac เมื่อสร้างเครื่องมือที่ดำเนินการระหว่างบิลด์
--host_jvmopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ตัวเลือกเพิ่มเติมเพื่อส่งไปยัง Java VM เมื่อสร้างเครื่องมือสร้างที่ดำเนินการระหว่างบิลด์ ระบบจะเพิ่มตัวเลือกเหล่านี้ลงในตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
- ค่าเริ่มต้น
--[no]incompatible_check_sharding_support
: "true" -
หากเป็น "จริง" Bazel จะทดสอบแบบแยกกลุ่มไม่สำเร็จหากเครื่องมือรันทดสอบไม่ได้ระบุว่ารองรับการแยกกลุ่มโดยแตะไฟล์ที่เส้นทางใน TEST_SHARD_STATUS_FILE หากเป็นเท็จ เครื่องมือรันทดสอบที่ไม่รองรับการแยกกลุ่มจะทำให้การทดสอบทั้งหมดทำงานในแต่ละกลุ่ม
แท็ก:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" การทดสอบเฉพาะจะทํางานด้วยกลยุทธ์ที่ใช้แซนด์บ็อกซ์ เพิ่มแท็ก "local" เพื่อบังคับให้ทำการทดสอบแบบพิเศษในเครื่อง
แท็ก:incompatible_change
--[no]incompatible_strict_action_env
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" Bazel จะใช้สภาพแวดล้อมที่มีค่าแบบคงที่สำหรับ PATH และไม่รับค่า LD_LIBRARY_PATH ไป ใช้ --action_env=ENV_VARIABLE หากต้องการรับค่าตัวแปรสภาพแวดล้อมที่เฉพาะเจาะจงจากไคลเอ็นต์ แต่โปรดทราบว่าการดำเนินการนี้อาจป้องกันไม่ให้แคชข้ามผู้ใช้หากใช้แคชที่แชร์
แท็ก:loading_and_analysis
,incompatible_change
--j2objc_translation_flags=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ตัวเลือกเพิ่มเติมที่จะส่งไปยังเครื่องมือ J2ObjC
--java_debug
-
ทําให้เครื่องเสมือน Java ของการทดสอบ Java รอการเชื่อมต่อจากโปรแกรมแก้ไขข้อบกพร่องที่เป็นไปตามข้อกําหนดของ JDWP (เช่น jdb) ก่อนเริ่มการทดสอบ โดยนัย -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 ที่จะใช้ในการสร้างไบนารี Java หากตั้งค่า Flag นี้เป็นสตริงว่าง ระบบจะใช้ตัวเปิด 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>
default: ดูคำอธิบาย- ระบุไบนารีที่จะใช้สร้างรายการคลาสที่ต้องอยู่ใน Dex หลักเมื่อคอมไพล์ MultiDex รุ่นเดิม
--optimizing_dexer=<a build target label>
default: ดูคำอธิบาย- ระบุไบนารีที่จะใช้ในการจัดทําดัชนีโดยไม่มีการแยกข้อมูล
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--plugin=<a build target label>
รายการ - ปลั๊กอินที่จะใช้ในบิลด์ ปัจจุบันใช้ได้กับ java_plugin
--proguard_top=<a build target label>
default: ดูคำอธิบาย- ระบุว่า ProGuard เวอร์ชันใดที่จะใช้สำหรับการนำโค้ดออกเมื่อสร้างไบนารีของ Java
--proto_compiler=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/protocol:protocol"-
ป้ายกำกับของคอมไพเลอร์โปรโต
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/proto:cc_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ C++ protos
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ j2objc protos
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/protocol:java_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์โปรโตคอล Java
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/proto:javalite_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์โปรโตคอล JavaLite
แท็ก:affects_outputs
,loading_and_analysis
--protocopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยังคอมไพเลอร์ protobuf
แท็ก:affects_outputs
--[no]runs_per_test_detects_flakes
ค่าเริ่มต้น: "false"- หากเป็น "จริง" ชาร์ดที่การเรียกใช้/ความพยายามอย่างน้อย 1 ครั้งผ่านและการเรียกใช้/ความพยายามอย่างน้อย 1 ครั้งล้มเหลวจะได้รับสถานะ FLAKY
- ค่าเริ่มต้น
--shell_executable=<a path>
: ดูคำอธิบาย -
เส้นทางสัมบูรณ์ไปยังเชลล์ที่ปฏิบัติการได้สำหรับ Bazel หากไม่ได้ตั้งค่านี้ แต่มีการตั้งค่าตัวแปรสภาพแวดล้อม BAZEL_SH ในการเรียกใช้ Bazel ครั้งแรก (ซึ่งจะเริ่มต้นเซิร์ฟเวอร์ Bazel) Bazel จะใช้ตัวแปรนั้น หากไม่ได้ตั้งค่าค่าใดเลย Bazel จะใช้เส้นทางเริ่มต้นแบบฮาร์ดโค้ดโดยขึ้นอยู่กับระบบปฏิบัติการที่ใช้ (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, อื่นๆ ทั้งหมด: /bin/bash) โปรดทราบว่าการใช้เชลล์ที่เข้ากันไม่ได้กับ bash อาจทําให้การสร้างไม่สําเร็จหรือรันไทม์ของไบนารีที่สร้างขึ้นไม่สําเร็จ
แท็ก:loading_and_analysis
--test_arg=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ระบุตัวเลือกและอาร์กิวเมนต์เพิ่มเติมที่ควรส่งไปยังไฟล์ปฏิบัติการทดสอบ ใช้หลายครั้งเพื่อระบุอาร์กิวเมนต์หลายรายการได้ หากทำการทดสอบหลายรายการ แต่ละรายการจะได้รับอาร์กิวเมนต์ที่เหมือนกัน ใช้โดยคำสั่ง "bazel test" เท่านั้น
- ค่าเริ่มต้น
--test_filter=<a string>
: ดูคำอธิบาย - ระบุตัวกรองที่จะส่งต่อไปยังเฟรมเวิร์กการทดสอบ ใช้เพื่อจํากัดการเรียกใช้การทดสอบ โปรดทราบว่าการดำเนินการนี้จะไม่ส่งผลต่อเป้าหมายที่สร้าง
- ค่าเริ่มต้นของ
--test_result_expiration=<an integer>
: "-1" - ตัวเลือกนี้เลิกใช้งานแล้วและไม่มีผล
--[no]test_runner_fail_fast
ค่าเริ่มต้น: "false"- การส่งต่อตัวเลือกแบบเร็วไม่สำเร็จไปยังตัวดำเนินการทดสอบ โปรแกรมรันทดสอบควรหยุดการดําเนินการเมื่อเกิดความผิดพลาดครั้งแรก
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
ค่าเริ่มต้น: "explicit"- ระบุกลยุทธ์สำหรับการแยกกลุ่มทดสอบ: "explicit" เพื่อใช้การแยกกลุ่มเฉพาะในกรณีที่มีแอตทริบิวต์ BUILD "shard_count" เท่านั้น "disabled" เพื่อไม่ให้ใช้การแยกกลุ่มทดสอบ 'forced=k' เพื่อบังคับใช้กลุ่ม "k" สำหรับการทดสอบโดยไม่คำนึงถึงแอตทริบิวต์ BUILD "shard_count"
--tool_java_language_version=<a string>
ค่าเริ่มต้น: ""- เวอร์ชันภาษา Java ที่ใช้เพื่อเรียกใช้เครื่องมือที่จำเป็นระหว่างบิลด์
--tool_java_runtime_version=<a string>
ค่าเริ่มต้น: "remotejdk_11"- เวอร์ชันรันไทม์ของ Java ที่ใช้เพื่อเรียกใช้เครื่องมือในระหว่างบิลด์
--[no]use_ijars
ค่าเริ่มต้น: "true"- หากเปิดใช้ ตัวเลือกนี้จะทําให้คอมไพล์ Java ใช้ JAR อินเทอร์เฟซ ซึ่งจะส่งผลให้การคอมไพล์แบบเพิ่มทีละน้อยเร็วขึ้น แต่ข้อความแสดงข้อผิดพลาดอาจแตกต่างกัน
ตัวเลือกดัมพ์
- ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากมีการตั้งค่า แคชของที่เก็บจะลิงก์ไฟล์แบบถาวรในกรณีที่มีการเกิดแคชแทนที่จะคัดลอก การดำเนินการนี้มีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองดาวน์โหลดข้อผิดพลาดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองอีกครั้ง
แท็ก:experimental
- ค่าเริ่มต้น
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับเวลาหมดอายุทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ช่วยให้รีโพซิทอรีภายนอกทำงานบนเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
ค่าเริ่มต้น: "false"-
หากเป็นเท็จ จะใช้กฎของรีโปเดิมใน WORKSPACE ได้ หากเป็นจริง ต้องใช้กฎของรีโป Starlark แทน กฎของรีโปเนทีฟ ได้แก่ local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
default: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลรีโพซิทอรี่ภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช มิเช่นนั้นระบบจะใช้ค่าเริ่มต้นของ "<output_user_root>/cache/repos/v1"
แท็ก:bazel_internal_configuration
--[no]repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลพื้นที่เก็บข้อมูล โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้โดยสมบูรณ์ โดย ctx.execute ยังคงสามารถรันไฟล์ปฏิบัติการที่กำหนดเองได้ซึ่งมีการเข้าถึงอินเทอร์เน็ต
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์มีดังนี้
--gc_thrashing_threshold=<an integer in 0-100 range>
ค่าเริ่มต้น: "100"-
เปอร์เซ็นต์ของพื้นที่เก็บข้อมูลแบบ Tenure ที่ใช้งานอยู่ (0-100) ซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์ความกดดันของหน่วยความจําเทียบกับขีดจํากัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ควบคุมเอาต์พุตของคําสั่ง
--[no]action_cache
ค่าเริ่มต้น: "false"-
แสดงเนื้อหาแคชการดำเนินการ
แท็ก:bazel_monitoring
--[no]packages
ค่าเริ่มต้น: "false"-
แสดงเนื้อหาแคชของแพ็กเกจ
แท็ก:bazel_monitoring
--[no]rule_classes
ค่าเริ่มต้น: "false"-
คลาสของกฎดัมพ์
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--[no]rules
: "เท็จ" -
กฎการถ่ายโอนข้อมูล รวมถึงจํานวนและการนําหน่วยความจําไปใช้ (หากมีการติดตามหน่วยความจํา)
แท็ก:bazel_monitoring
- ค่าเริ่มต้นของ
--skyframe=<off, summary, count, deps or rdeps>
: "ปิด" -
ดัมพ์กราฟ Skyframe: "ปิด" "สรุป" "จำนวน" "deps" หรือ "rdeps"
แท็ก:bazel_monitoring
--skykey_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
ค่าเริ่มต้น: ".*"-
ตัวกรองนิพจน์ทั่วไปของชื่อ SkyKey สำหรับเอาต์พุต ใช้กับ --skyframe=deps, rdeps เท่านั้น
แท็ก:bazel_monitoring
--skylark_memory=<a string>
default: ดูคำอธิบาย-
แสดงผลโปรไฟล์หน่วยความจําที่เข้ากันได้กับ pprof ไปยังเส้นทางที่ระบุ ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/google/pprof
แท็ก:bazel_monitoring
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะอนุญาตในกราฟ Dependency ที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่ามีการดึงออกในรีจิสทรีที่มาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น การดึงเวอร์ชันออกจะทำให้การแก้ไขไม่สำเร็จ นอกจากนี้ คุณยังกำหนดเวอร์ชันที่ดึงออกได้โดยใช้ตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็ก:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ" "off" เพื่อปิดใช้การตรวจสอบ หรือ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน
แท็ก:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่า Dependency ของ `bazel_dep` โดยตรงที่ประกาศไว้ในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟ Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ใช้ได้คือ "off" เพื่อปิดใช้การตรวจสอบ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน หรือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ"
แท็ก:loading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นข้อกำหนดในการพัฒนาเหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูท ไม่ว่าค่าของ Flag นี้จะเป็นอย่างไรก็ตาม
แท็ก:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
ค่าเริ่มต้น: "update"-
ระบุวิธีและวิธีใช้ล็อกไฟล์ ค่าที่ถูกต้องคือ "update" เพื่อใช้ไฟล์ล็อกและอัปเดตไฟล์หากมีการเปลี่ยนแปลง "refresh" เพื่อรีเฟรชข้อมูลที่เปลี่ยนแปลงได้เพิ่มเติม (เวอร์ชันที่ยกเลิกและโมดูลที่ขาดหายไปก่อนหน้านี้) จากรีจิสทรีระยะไกลเป็นครั้งคราว "error" เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่เป็นปัจจุบัน หรือ "off" เพื่อไม่อ่านหรือเขียนลงในไฟล์ล็อก
แท็ก:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างโมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีทํางานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้านี้ออก
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--registry=<a string>
รายการ -
ระบุรีจิสทรีที่จะใช้ในการค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับมีความสำคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะเปลี่ยนไปใช้รีจิสทรีที่ใหม่กว่าก็ต่อเมื่อไม่มีโมดูลที่ต้องการในรีจิสทรีก่อนหน้า
แท็ก:changes_inputs
- ค่าเริ่มต้น
--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> โดยที่ period คือระยะเวลา และ count คือจํานวนเต็มบวก หากมีการใช้พื้นที่ที่มีการจัดสรรไว้ (ฮีปรุ่นเก่า) มากกว่า --gc_thrashing_threshold เปอร์เซ็นต์หลังจาก GC แบบสมบูรณ์ติดต่อกัน <count> ครั้งภายใน <period> ระบบจะเรียกใช้ OOM คุณสามารถระบุขีดจํากัดหลายรายการโดยคั่นด้วยคอมมา
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
แฟล็กสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC แบบเต็มขึ้น ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนครั้งต่อครั้งที่เรียกใช้ ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด 0 หมายความว่าเหตุการณ์ GC แบบสมบูรณ์จะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC แบบเต็มและเปอร์เซ็นต์ของกองข้อมูลที่เก็บรักษาไว้เกินเกณฑ์
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC เล็กน้อยขึ้น ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนนี้ต่อการเรียกใช้แต่ละครั้ง ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด 0 หมายความว่าเหตุการณ์ GC เล็กน้อยจะไม่ทริกเกอร์การลดลง หากถึงขีดจำกัด สถานะ Skyframe จะไม่ลดลงอีกต่อไปเมื่อเกิดเหตุการณ์ GC ที่ไม่ร้ายแรงและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
แฟล็กสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานฮีปที่สะสมไว้ถึงเกณฑ์นี้เป็นอย่างน้อย ก็จะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็น การปรับแต่งนี้อาจช่วยลดผลกระทบจากเวลาจริงของการ Thashing
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งในการบันทึก
- ค่าเริ่มต้น
--experimental_command_profile=<cpu, wall, alloc or lock>
: ดูคำอธิบาย - บันทึกโปรไฟล์ Java Flight Recorder ตลอดระยะเวลาของคำสั่ง คุณต้องระบุประเภทเหตุการณ์โปรไฟล์ที่รองรับ (cpu, wall, alloc หรือ lock) รายการใดรายการหนึ่งเป็นอาร์กิวเมนต์ โปรไฟล์จะเขียนไปยังไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ภายใต้ไดเรกทอรีฐานเอาต์พุต ไวยากรณ์และความหมายของแฟล็กนี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับประเภทโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม คุณต้องยอมรับความเสี่ยงที่เกิดขึ้นเอง
- ค่าเริ่มต้น
--[no]experimental_record_metrics_for_all_mnemonics
: "เท็จ" - โดยค่าเริ่มต้น ระบบจะจำกัดจำนวนประเภทการดำเนินการไว้ที่ 20 รายการ ซึ่งเป็นคําช่วยจําที่มีการดำเนินการมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับคําช่วยจําทั้งหมด
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่างเปล่า ให้อ่านไฟล์ที่แก้ไขแล้วแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
--experimental_downloader_config=<a string>
default: ดูคำอธิบาย- ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะขึ้นต้นด้วยคําสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สําหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ โดยรูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้แทน URL โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณอาจระบุคําสั่ง `rewrite` หลายรายการสําหรับ URL เดียวกันได้ ซึ่งในกรณีนี้ระบบจะแสดงผล URL หลายรายการ
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
ค่าเริ่มต้น: "auto"- โหมดการแยกชุดข้อความที่จะใช้ดึงข้อมูลรีโป หากตั้งค่าเป็น "ปิด" ระบบจะไม่ใช้เธรดสำหรับงานและการดึงข้อมูลรีโปจะขึ้นอยู่กับการรีสตาร์ท ไม่เช่นนั้นจะใช้เธรดผู้ทํางานเสมือน
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้
--override_repository=<an equals-separated mapping of repository name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์จะถูกนำมาใช้ตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ เส้นทางดังกล่าวจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" แสดงว่าสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel" หากเส้นทางที่ระบุว่างเปล่า ให้นำการลบล้างก่อนหน้าออก
ตัวเลือกการดึงข้อมูล
รับค่าตัวเลือกทั้งหมดจาก test
- ตัวเลือกที่ปรากฏก่อนคําสั่งและได้รับการแยกวิเคราะห์โดยไคลเอ็นต์
--distdir=<a path>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนที่จะเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บข้อมูลจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบในแคชแทนการคัดลอก การดำเนินการนี้มีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งที่พยายามลองอีกครั้งสูงสุดสำหรับข้อผิดพลาดในการดาวน์โหลด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองอีกครั้ง
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ด้วยปัจจัยนี้ วิธีนี้ช่วยให้รีโพซิทอรีภายนอกทํางานบนเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
ค่าเริ่มต้น: "false"-
หากเป็นเท็จ จะใช้กฎของรีโปเดิมใน WORKSPACE ได้ หากเป็นจริง ต้องใช้กฎของรีโป Starlark แทน กฎของรีโปเนทีฟ ได้แก่ local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูคำอธิบาย -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลรีโพซิทอรี่ภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดแคช มิเช่นนั้นจะใช้ค่าเริ่มต้น "<output_user_root>/cache/repos/v1"
แท็ก:bazel_internal_configuration
--[no]repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลพื้นที่เก็บข้อมูล โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้โดยสมบูรณ์ โดย ctx.exeโดยสมบูรณ์ยังคงเรียกใช้ไฟล์ปฏิบัติการที่กำหนดเองได้ซึ่งเข้าถึงอินเทอร์เน็ตได้
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์มีดังนี้
- ค่าเริ่มต้น
--[no]all
: "เท็จ" -
ดึงข้อมูลที่เก็บภายนอกทั้งหมดที่จำเป็นสำหรับการสร้างเป้าหมายหรือที่เก็บ ตัวเลือกนี้เป็นค่าเริ่มต้นหากไม่มีการกำหนดแฟล็กและอาร์กิวเมนต์อื่นๆ ใช้ได้ก็ต่อเมื่อ --enable_bzlmod เปิดอยู่
แท็ก:changes_inputs
- ค่าเริ่มต้น
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
เปอร์เซ็นต์ของพื้นที่เก็บข้อมูลแบบ Tenure ที่ใช้งานอยู่ (0-100) ซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์ความกดดันของหน่วยความจําเทียบกับขีดจํากัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก:host_machine_resource_optimizations
--[no]keep_going
[-k
] default: "false"-
ดำเนินการต่อให้มากที่สุดหลังจากเกิดข้อผิดพลาด แม้ว่าเป้าหมายที่ล้มเหลวและเป้าหมายที่อ้างอิงอยู่จะไม่สามารถวิเคราะห์ได้ แต่ข้อกำหนดเบื้องต้นอื่นๆ ของเป้าหมายเหล่านี้อาจเป็นไปได้
แท็ก:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
ค่าเริ่มต้น: "auto"-
จำนวนชุดข้อความแบบขนานที่จะใช้สำหรับขั้นตอนการโหลด/การวิเคราะห์ ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") โดยจะเลือกตามด้วยการดำเนินการ ([-|*]<Float>) หรือไม่ก็ได้ "auto", "HOST_CPUS*.5" "auto" จะตั้งค่าเริ่มต้นที่เหมาะสมตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก:bazel_internal_configuration
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือบิลด์ API ที่ไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE เข้าถึงได้
- ค่าเริ่มต้น
--[no]incompatible_config_setting_private_default_visibility
: "เท็จ" -
หาก incompatible_enforce_config_setting_visibility=false จะไม่มีการดำเนินการใดๆ หรือหาก Flag นี้เป็นเท็จ config_setting ที่ไม่มีแอตทริบิวต์ระดับการมองเห็นที่ชัดเจนจะเป็น //visibility:public หาก Flag นี้เป็น "จริง" config_setting จะใช้ตรรกะการแสดงผลเดียวกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
ค่าเริ่มต้น: "true"-
หากเป็นจริง ให้บังคับใช้การจำกัดระดับการเข้าถึง config_setting หากเป็นเท็จ เป้าหมายทุกรายการจะเห็น config_setting ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะอนุญาตในกราฟ Dependency ที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่ามีการดึงออกในรีจิสทรีที่มาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิเช่นนั้น เวอร์ชันที่แยกออกมาจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันที่ดึงออกได้โดยใช้ตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็ก:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ" "off" เพื่อปิดใช้การตรวจสอบ หรือ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน
แท็ก:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่า Dependency ของ `bazel_dep` โดยตรงที่ประกาศไว้ในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟ Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดการตรวจสอบ "คำเตือน" ให้พิมพ์คำเตือนเมื่อตรวจพบข้อมูลที่ไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อยกระดับการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
--[no]configure
ค่าเริ่มต้น: "false"-
ดึงข้อมูลเฉพาะที่เก็บข้อมูลที่ทําเครื่องหมายเป็น "กําหนดค่า" เพื่อวัตถุประสงค์ในการกําหนดค่าระบบ ใช้ได้ก็ต่อเมื่อ --enable_bzlmod เปิดอยู่
แท็ก:changes_inputs
- ค่าเริ่มต้น
--[no]force
: "เท็จ" -
ละเว้นที่เก็บที่มีอยู่ (หากมี) และบังคับให้ดึงข้อมูลที่เก็บอีกครั้ง ใช้ได้ก็ต่อเมื่อ --enable_bzlmod เปิดอยู่
แท็ก:changes_inputs
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นข้อกำหนดในการพัฒนาเหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูท ไม่ว่าค่าของ Flag นี้จะเป็นอย่างไรก็ตาม
แท็ก:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
ค่าเริ่มต้น: "update"-
ระบุวิธีและวิธีใช้ล็อกไฟล์ ค่าที่ถูกต้องคือ "update" เพื่อใช้ไฟล์ล็อกและอัปเดตไฟล์หากมีการเปลี่ยนแปลง "refresh" เพื่อรีเฟรชข้อมูลที่เปลี่ยนแปลงได้เพิ่มเติม (เวอร์ชันที่ยกเลิกและโมดูลที่ขาดหายไปก่อนหน้านี้) จากรีจิสทรีระยะไกลเป็นครั้งคราว "error" เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่เป็นปัจจุบัน หรือ "off" เพื่อไม่อ่านหรือเขียนลงในไฟล์ล็อก
แท็ก:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างโมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีทํางานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้าออก
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--registry=<a string>
รายการ -
ระบุรีจิสทรีที่จะใช้ในการค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับเป็นสิ่งสำคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีในภายหลังเมื่อไม่มีรีจิสทรีที่ขาดหายไป
แท็ก:changes_inputs
--repo=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ดึงข้อมูลเฉพาะที่เก็บข้อมูลที่ระบุ ซึ่งอาจเป็น {@apparent_repo_name} หรือ {@@canonical_repo_name} ทำงานเมื่อเปิด --enable_bzlmod เท่านั้น
แท็ก:changes_inputs
- ค่าเริ่มต้น
--vendor_dir=<a path>
: ดูคำอธิบาย -
ระบุไดเรกทอรีที่ควรเก็บที่เก็บข้อมูลภายนอกในโหมดผู้ให้บริการ ไม่ว่าจะเป็นเพื่อดึงข้อมูลมายังไดเรกทอรีดังกล่าวหรือใช้ขณะสร้าง เส้นทางอาจเป็นเส้นทางแบบสัมบูรณ์หรือเส้นทางแบบสัมพัทธ์กับไดเรกทอรีของพื้นที่ทำงานก็ได้
แท็ก:loading_and_analysis
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพของเวลาบิลด์
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
ค่าเริ่มต้น: "1s:2,20s:3,1m:5"-
ขีดจำกัดที่หากถึงจะทำให้ GcThrashingDetector ทำให้ Bazel ขัดข้องด้วย OOM โดยระบุขีดจํากัดแต่ละรายการเป็น <period>:<count> โดยที่ period คือระยะเวลา และ count คือจํานวนเต็มบวก หากมีการใช้พื้นที่ที่มีการจัดสรรไว้ (ฮีปรุ่นเก่า) มากกว่า --gc_thrashing_threshold เปอร์เซ็นต์หลังจากการเรียกใช้ GC แบบเต็มติดต่อกัน <count> ครั้งภายใน <period> ระบบจะเรียกใช้ OOM คุณสามารถระบุขีดจํากัดหลายรายการโดยคั่นด้วยคอมมา
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้ฮีปที่เก็บรักษาไว้เกินเกณฑ์ที่ --skyframe_high_water_mark_threshold กำหนด เมื่อเกิดเหตุการณ์ GC เต็มรูปแบบเกิดขึ้น สถานะของ Skyframe ชั่วคราวจะถูกตัดทิ้งโดยไม่จำเป็นจนถึงจำนวนครั้งดังกล่าวต่อการเรียกใช้หลายครั้ง ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด 0 หมายความว่าเหตุการณ์ GC แบบสมบูรณ์จะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC แบบเต็มและเปอร์เซ็นต์ของกองข้อมูลที่เก็บรักษาไว้เกินเกณฑ์
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC เล็กน้อย ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนนี้ต่อการเรียกใช้แต่ละครั้ง ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด 0 หมายความว่าเหตุการณ์ GC เล็กน้อยจะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC ย่อยและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์กองที่เก็บไว้อย่างน้อยถึงเกณฑ์นี้ ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็น การปรับแต่งค่านี้อาจช่วยลดผลกระทบต่อเวลาจริงของการกระหน่ำ GC เมื่อการกระหน่ำ GC (1) เกิดจากการใช้งานหน่วยความจําของสถานะชั่วคราวนี้ และ (2) เสียค่าใช้จ่ายมากกว่าการสร้างสถานะใหม่เมื่อจําเป็น
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ส่งผลต่อรายละเอียด รูปแบบ หรือตำแหน่งของการบันทึก
--experimental_command_profile=<cpu, wall, alloc or lock>
default: ดูคำอธิบาย- บันทึกโปรไฟล์ Java Flight Recorder ตลอดระยะเวลาของคำสั่ง ต้องระบุประเภทเหตุการณ์การสร้างโปรไฟล์ที่รองรับ (CPU, หน้าจอ, Allo หรือ Lock) เป็นอาร์กิวเมนต์ โปรไฟล์จะเขียนไปยังไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ภายใต้ไดเรกทอรีฐานเอาต์พุต รูปแบบคำสั่งและความหมายของแฟล็กนี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับประเภทโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม โปรดใช้โดยยอมรับความเสี่ยงเอง
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจํากัดไว้ที่คําช่วยจํา 20 รายการที่มีการดําเนินการมากที่สุด การตั้งค่าตัวเลือกนี้จะเป็นการเขียนสถิติสำหรับการช่วยจำทั้งหมด
--experimental_repository_resolved_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่างเปล่า ให้เขียนค่า Starlark พร้อมข้อมูลที่แก้ไขแล้วของกฎที่เก็บ Starlark ทั้งหมดที่ดำเนินการ
แท็ก:affects_outputs
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ใช่ค่าว่าง ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการระยะไกล
- ค่าเริ่มต้น
--experimental_downloader_config=<a string>
: ดูคำอธิบาย - ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดจากระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะขึ้นต้นด้วยคําสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สําหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ โดยรูปแบบหนึ่งใช้เพื่อจับคู่และอีกรูปแบบหนึ่งใช้แทน URL โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณอาจระบุคําสั่ง `rewrite` หลายรายการสําหรับ URL เดียวกันได้ ซึ่งในกรณีนี้ระบบจะแสดงผล URL หลายรายการ
- ค่าเริ่มต้น
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "อัตโนมัติ" - โหมดการแยกชุดข้อความที่จะใช้ดึงข้อมูลรีโป หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท ไม่เช่นนั้นจะใช้เธรดผู้ทํางานเสมือน
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
--deleted_packages=<comma-separated list of package names>
ระบบจะรวบรวมการใช้งานหลายครั้ง- รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริง แม้ว่าจะแสดงอยู่ในที่ใดที่หนึ่งบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ ตัวอย่างเช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์แล้ว ระบบบิลด์อาจแสดงข้อผิดพลาดหากพบป้ายกำกับ "//x:y/z" หากยังมีรายการ package_path อื่นระบุอยู่ การระบุ --deleted_packages x/y จะช่วยหลีกเลี่ยงปัญหานี้ได้
- ค่าเริ่มต้น
--[no]fetch
: "จริง" - อนุญาตให้คําสั่งดึงข้อมูลการอ้างอิงภายนอก หากตั้งค่าเป็นเท็จ คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ หากไม่มี คำสั่งจะดำเนินการไม่สำเร็จ
--override_repository=<an equals-separated mapping of repository name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างที่เก็บโดยใช้เส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้าออก
--package_path=<colon-separated list of options>
ค่าเริ่มต้น: "%workspace%"- รายการค้นหาแพ็กเกจที่คั่นด้วยโคลอน องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับเวิร์กスペースที่ล้อมรอบ หากละเว้นหรือว่างเปล่า ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
--[no]show_loading_progress
ค่าเริ่มต้น: "true"- หากเปิดใช้ จะทำให้ Bazel พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ:"
- ตัวเลือกที่ควบคุมการดำเนินการบิลด์
- ค่าเริ่มต้น
--[no]all
: "เท็จ" -
ดึงข้อมูลที่เก็บภายนอกทั้งหมดที่จำเป็นต่อการสร้างเป้าหมายหรือที่เก็บ การตั้งค่านี่เป็นค่าเริ่มต้นหากไม่ได้ระบุ Flag และอาร์กิวเมนต์อื่นๆ ใช้งานได้เมื่อ --enable_bzlmod เปิดอยู่เท่านั้น
แท็ก:changes_inputs
- ค่าเริ่มต้น
--[no]experimental_inprocess_symlink_creation
: "เท็จ" -
กำหนดว่าจะเรียกใช้ระบบไฟล์โดยตรงเพื่อสร้างแผนผังลิงก์สัญลักษณ์หรือไม่
แท็ก: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
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" Bazel จะเรียกใช้การประมวลผลผลลัพธ์ของการทดสอบในกระบวนการใหม่
แท็ก:execution
--[no]experimental_strict_fileset_output
ค่าเริ่มต้น: "false"-
หากเปิดใช้ตัวเลือกนี้ ชุดไฟล์จะถือว่าอาร์ติแฟกต์เอาต์พุตทั้งหมดเป็นไฟล์ทั่วไป จะไม่ไปยังไดเรกทอรีต่างๆ หรือสนใจเกี่ยวกับสัญลักษณ์ลิงก์
แท็ก:execution
--[no]incompatible_disallow_unsound_directory_outputs
ค่าเริ่มต้น: "true"-
หากตั้งค่าไว้ ระบบจะแสดงข้อผิดพลาดเมื่อดำเนินการสร้างไฟล์เอาต์พุตเป็นไดเรกทอรี ไม่มีผลต่อไดเรกทอรีต้นทาง ดู https://github.com/bazelbuild/bazel/issues/18646
แท็ก:bazel_internal_configuration
,incompatible_change
--[no]incompatible_modify_execution_info_additive
ค่าเริ่มต้น: "false"-
เมื่อเปิดใช้ การส่ง Flag --modify_execution_info หลายรายการจะเป็นการเพิ่ม เมื่อปิดใช้ ระบบจะพิจารณาเฉพาะการแจ้งเตือนล่าสุดเท่านั้น
แท็ก:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
--[no]keep_going
[-k
] ค่าเริ่มต้น: "เท็จ"-
ดำเนินการต่อให้มากที่สุดหลังจากเกิดข้อผิดพลาด แม้ว่าจะวิเคราะห์เป้าหมายที่ไม่สําเร็จและเป้าหมายที่ขึ้นอยู่กับเป้าหมายนั้นไม่ได้ แต่สามารถวิเคราะห์ข้อกําหนดเบื้องต้นอื่นๆ ของเป้าหมายเหล่านี้ได้
แท็ก:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
ค่าเริ่มต้น: "auto"-
จํานวนเธรดแบบขนานที่จะใช้สําหรับระยะการโหลด/การวิเคราะห์ ใช้จํานวนเต็มหรือคีย์เวิร์ด ("auto", "HOST_CPUS", "HOST_RAM") ตามด้วยการดำเนินการ ([-|*]<float>) ตามต้องการ เช่น "auto", "HOST_CPUS*.5" "auto" จะตั้งค่าเริ่มต้นที่เหมาะสมตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก:bazel_internal_configuration
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
เพิ่มหรือนําคีย์ออกจากข้อมูลการดําเนินการของการดำเนินการตามคําช่วยจําของการดำเนินการ ใช้กับการดำเนินการที่รองรับข้อมูลการดำเนินการเท่านั้น การดำเนินการทั่วไปหลายอย่างรองรับข้อมูลการดำเนินการ เช่น Genrule, CppCompile, Javac, StarlarkAction, TestRunner เมื่อระบุหลายค่า ลําดับจะมีความสำคัญเนื่องจากนิพจน์ทั่วไปหลายรายการอาจใช้กับคําช่วยจําเดียวกัน
ไวยากรณ์: "regex=[+-]key,regex=[+-]key,..."
ตัวอย่างเช่น ".*=+x,.*=-y,.*=+z" เพิ่ม "x" และ "z" และนำ "y" ออกจากข้อมูลการดำเนินการสำหรับการดำเนินการทั้งหมด
"Genrule=+requires-x" จะเพิ่ม "requires-x" ลงในข้อมูลการดําเนินการสําหรับการดําเนินการ Genrule ทั้งหมด
"(?!Genrule).*=-requires-x" นำ "requires-x" ออกจากข้อมูลการดำเนินการสำหรับการดำเนินการที่ไม่ใช่ Genrule ทั้งหมด
แท็ก:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
เปิดใช้การดำเนินการ Dex และ desugar ของ Android แบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--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
-
เปิดใช้การดำเนินการ Desugar และ Dex ของ 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 แบบถาวรและแบบหลายเพล็กซ์ (การแปลงไฟล์ Dex, การถอด Sugar, การประมวลผลทรัพยากร)
ขยายเป็น
--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
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะใช้แพลตฟอร์มเป้าหมายเพื่อทำการทดสอบแทนกลุ่มผู้บริหารทดสอบ
แท็ก:execution
- ตัวเลือกในการกำหนดค่า Toolchain ที่ใช้สำหรับการดำเนินการมีดังนี้
- ค่าเริ่มต้น
--android_compiler=<a string>
: ดูคำอธิบาย -
คอมไพเลอร์เป้าหมาย Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
ค่าเริ่มต้น: "//external:android/crosstool"-
ตำแหน่งคอมไพเลอร์ C++ ที่ใช้สำหรับบิลด์ Android
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
default: ดูคำอธิบาย-
เป้าหมาย grte_top ของ Android
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
ค่าเริ่มต้น: "android"-
เลือกการควบรวมไฟล์ Manifest ที่จะใช้กับกฎ android_binary แจ้งเพื่อช่วยให้เปลี่ยนไปใช้การผสานรวมไฟล์ Manifest ของ Android จากการควบรวมเดิม
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
ค่าเริ่มต้น: ""-
กำหนดแพลตฟอร์มที่ android_binary กำหนดเป้าหมายใช้ หากระบุแพลตฟอร์มหลายรายการ ไฟล์ไบนารีจะเป็น APK แบบรวมซึ่งมีไบนารีเนทีฟสำหรับแพลตฟอร์มเป้าหมายแต่ละรายการที่ระบุ
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/android:sdk"-
ระบุ SDK/แพลตฟอร์ม Android ที่ใช้สร้างแอปพลิเคชัน Android
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจข้ามเครื่องมือที่จะใช้ในกฎของ Apple และ Objc และทรัพยากร Dependency
แท็ก:loses_incremental_state
,changes_inputs
--cc_output_directory_tag=<a string>
ค่าเริ่มต้น: ""-
ระบุส่วนต่อท้ายที่จะเพิ่มลงในไดเรกทอรีการกําหนดค่า
แท็ก:affects_outputs
- ค่าเริ่มต้น
--compiler=<a string>
: ดูคำอธิบาย -
คอมไพเลอร์ C++ ที่จะใช้ในการคอมไพล์เป้าหมาย
แท็ก:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:lcov_merger"-
ตำแหน่งของไบนารีที่ใช้ประมวลผลรายงานการครอบคลุมแบบดิบในขั้นตอนหลัง ซึ่งปัจจุบันต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งเป็นไฟล์ไบนารี ค่าเริ่มต้นคือ "//tools/test:lcov_merger"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_report_generator"-
ตำแหน่งของไบนารีที่ใช้สร้างรายงานการครอบคลุม ซึ่งปัจจุบันต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งเป็นไฟล์ไบนารี ค่าเริ่มต้นคือ "//tools/test:coverage_report_generator"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_support"-
ตำแหน่งของไฟล์สนับสนุนที่จำเป็นต้องมีในอินพุตของการดำเนินการทดสอบทุกรายการที่รวบรวมการครอบคลุมของโค้ด ค่าเริ่มต้นคือ "//tools/test:coverage_support"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้ในการคอมไพล์โค้ด C++
แท็ก:loading_and_analysis
,changes_inputs
,affects_outputs
--custom_malloc=<a build target label>
default: ดูคำอธิบาย-
ระบุการติดตั้งใช้งาน Malloc ที่กำหนดเอง การตั้งค่านี้จะลบล้างแอตทริบิวต์ Malloc ในกฎบิลด์
แท็ก:changes_inputs
,affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
รายการนิพจน์ทั่วไปที่คั่นด้วยคอมมา โดยแต่ละรายการจะมีคำนำหน้าเป็น - (นิพจน์เชิงลบ) หรือไม่ก็ได้ ซึ่งกำหนดค่า (=) ให้กับรายการเป้าหมายค่าข้อจำกัดที่คั่นด้วยคอมมา หากเป้าหมายไม่ตรงกับนิพจน์เชิงลบและตรงกับนิพจน์เชิงบวกอย่างน้อย 1 รายการ ระบบจะดำเนินการแก้ไขเครื่องมือทางเทคนิคของเป้าหมายนั้นราวกับว่าได้ประกาศค่าข้อจำกัดเป็นข้อจำกัดการดําเนินการ ตัวอย่างเช่น //demo,-test=@platforms//cpus:x86_64 จะเพิ่ม "x86_64" ลงในเป้าหมายใดก็ได้ในส่วน //demo ยกเว้นเป้าหมายที่มีชื่อเป็น "test"
แท็ก:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
ค่าเริ่มต้น: "false"-
หากตั้งค่าแล้ว ให้เพิ่มข้อกำหนดการดำเนินการ "requires-xcode:{version}" ในการดำเนินการกับ Xcode ทุกรายการ หากเวอร์ชัน xcode มีป้ายกำกับที่ขีดกลาง ให้เพิ่มข้อกำหนดการเรียกใช้ "requires-xcode-label:{version_label}" ด้วย
แท็ก:loses_incremental_state
,loading_and_analysis
,execution
- ค่าเริ่มต้น
--[no]experimental_prefer_mutual_xcode
: "true" -
หากเป็น "จริง" ให้ใช้ Xcode เวอร์ชันล่าสุดที่มีทั้งแบบในเครื่องและแบบระยะไกล หากเป็นเท็จหรือไม่มีเวอร์ชันที่ใช้ร่วมกันได้ ให้ใช้ Xcode เวอร์ชันในเครื่องที่เลือกผ่าน xcode-select
แท็ก:loses_incremental_state
- ค่าเริ่มต้นของ
--extra_execution_platforms=<comma-separated list of options>
: "" -
แพลตฟอร์มที่มีให้ใช้งานเป็นแพลตฟอร์มการดำเนินการเพื่อเรียกใช้การดำเนินการ แพลตฟอร์มสามารถระบุตามเป้าหมายที่ตรงกันทั้งหมดหรือเป็นรูปแบบเป้าหมาย ระบบจะพิจารณาแพลตฟอร์มเหล่านี้ก่อนแพลตฟอร์มที่ประกาศไว้ในไฟล์ WORKSPACE โดย register_execution_platforms() ตัวเลือกนี้ตั้งค่าได้เพียงครั้งเดียว อินสแตนซ์ที่ตามมาจะลบล้างการตั้งค่า Flag ก่อนหน้า
แท็ก:execution
--extra_toolchains=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
กฎสำหรับ Toolchain ที่ควรพิจารณาระหว่างการแก้ไข Toolchain คุณสามารถระบุ Toolchain ตามเป้าหมายที่ตรงกันทั้งหมด หรือเป็นรูปแบบเป้าหมายก็ได้ ระบบจะพิจารณา Toolchain เหล่านี้ก่อน Toolchain ที่ประกาศไว้ในไฟล์ WORKSPACE โดย register_toolchains()
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
default: ดูคำอธิบาย-
ป้ายกำกับไปยังไลบรารี libc ที่มีการเช็คอิน เครื่องมือทํางานแบบข้ามแพลตฟอร์มจะเลือกค่าเริ่มต้น และคุณแทบไม่จําเป็นต้องลบล้างค่าดังกล่าว
แท็ก:action_command_lines
,affects_outputs
--host_compiler=<a string>
default: ดูคำอธิบาย-
คอมไพเลอร์ C++ ที่จะใช้ในการคอมไพล์โฮสต์ ระบบจะไม่สนใจหากไม่ได้ตั้งค่า --host_crosstool_top
แท็ก:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
default: ดูคำอธิบาย-
โดยค่าเริ่มต้น ระบบจะใช้ตัวเลือก --crosstool_top และ --compiler สำหรับการกําหนดค่า exec ด้วย หากมีการแฟล็กนี้ Bazel จะใช้ libc และคอมไพเลอร์เริ่มต้นสำหรับ Crosstool_top ที่ระบุ
แท็ก:loading_and_analysis
,changes_inputs
,affects_outputs
- ค่าเริ่มต้น
--host_grte_top=<a label>
: ดูคำอธิบาย -
หากระบุไว้ การตั้งค่านี้จะลบล้างไดเรกทอรีระดับบนสุดของ libc (--grte_top) สําหรับการกําหนดค่า exec
แท็ก:action_command_lines
,affects_outputs
--host_platform=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools:host_platform"-
ป้ายกํากับของกฎแพลตฟอร์มที่อธิบายระบบโฮสต์
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "จริง" -
หากเป็นจริง Bazel จะไม่เปิดใช้ฟีเจอร์ "โฮสต์" และ "nonhost" ใน Toolchain ของ c++ (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/7407)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_enable_android_toolchain_resolution
: "true" -
ใช้การแก้ไข Toolchain เพื่อเลือก Android SDK สําหรับกฎ Android (Starlark และแบบดั้งเดิม)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
ค่าเริ่มต้น: "false"-
ใช้การแก้ไขเครื่องมือเพื่อเลือก Apple SDK สําหรับกฎของ Apple (Starlark และแบบดั้งเดิม)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_make_thinlto_command_lines_standalone
: "จริง" -
หากเป็น "จริง" Bazel จะไม่นําบรรทัดคําสั่งการดําเนินการลิงก์ C++ มาใช้ซ้ำสําหรับบรรทัดคําสั่งการจัดทําดัชนี lto (ดูข้อมูลเพิ่มเติมที่ https://github.com/bazelbuild/bazel/issues/6791)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
ค่าเริ่มต้น: "true"-
หากเป็นจริง Bazel จะไม่ลิงก์ทรัพยากร Dependency ของไลบรารีเป็นที่เก็บถาวรทั้งหมดโดยค่าเริ่มต้น (ดูวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/7362)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" Bazel จะกำหนดให้ต้องมีพารามิเตอร์ "ctx" ใน cc_common.configure_features (ดูข้อมูลเพิ่มเติมที่ https://github.com/bazelbuild/bazel/issues/7793)
แท็ก:loading_and_analysis
,incompatible_change
-
ใช้ออบเจ็กต์ที่แชร์ของอินเทอร์เฟซหากเครื่องมือทางเทคนิครองรับ เครื่องมือทํางาน 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>
default: ดูคำอธิบาย-
เวอร์ชันของระบบปฏิบัติการขั้นต่ำที่การคอมไพล์กำหนดเป้าหมาย
แท็ก:loading_and_analysis
,affects_outputs
- ค่าเริ่มต้นของ
--platform_mappings=<a relative path>
: "" -
ตำแหน่งของไฟล์การแมปที่อธิบายว่าควรใช้แพลตฟอร์มใดหากไม่ได้ตั้งค่าไว้ หรือควรตั้งค่า Flag ใดเมื่อมีแพลตฟอร์มอยู่แล้ว ต้องสัมพัทธ์กับรูทของพื้นที่ทำงานหลัก ค่าเริ่มต้นคือ "platform_mappings" (ไฟล์ที่อยู่ใต้รูทของพื้นที่ทํางานโดยตรง)
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
ค่าเริ่มต้น: ""-
ป้ายกํากับของกฎแพลตฟอร์มที่อธิบายแพลตฟอร์มเป้าหมายสําหรับคําสั่งปัจจุบัน
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
default: ดูคำอธิบาย-
เลิกใช้งานแล้ว ใช้งานไม่ได้ ปิดใช้โดย `--incompatible_use_python_toolchains`
แท็ก:no_op
,deprecated
--python3_path=<a string>
default: ดูคำอธิบาย-
เลิกใช้งานแล้ว ใช้งานไม่ได้ ปิดใช้โดย `--incompatible_use_python_toolchains`
แท็ก:no_op
,deprecated
--python_path=<a string>
default: ดูคำอธิบาย-
เส้นทางสัมบูรณ์ของโปรแกรมแปลภาษา Python ที่เรียกใช้เพื่อเรียกใช้เป้าหมาย Python ในแพลตฟอร์มเป้าหมาย เลิกใช้งานแล้ว ปิดใช้โดย --incompatible_use_python_toolchains
แท็ก:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
default: ดูคำอธิบาย-
ป้ายกํากับของ 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')>
default: ดูคำอธิบาย-
ระบุเวอร์ชันของ tvOS SDK ที่จะใช้สร้างแอปพลิเคชัน tvOS หากไม่ระบุ ระบบจะใช้เวอร์ชันเริ่มต้นของ tvOS SDK จาก "xcode_version"
แท็ก:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: ดูคำอธิบาย-
ระบุเวอร์ชันของ 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 ของ Runfiles สำหรับเป้าหมายทั้งหมด หากเป็นเท็จ ระบบจะเขียนเฉพาะในกรณีที่การดำเนินการในเครื่อง ทดสอบ หรือเรียกใช้คำสั่งจำเป็นต้องใช้
แท็ก:affects_outputs
--[no]build_runfile_manifests
ค่าเริ่มต้น: "true"-
หากเป็นจริง ให้เขียนไฟล์ Manifest ของการเรียกใช้ไฟล์สำหรับเป้าหมายทั้งหมด หากเป็นเท็จ ให้ละเว้น การทดสอบในเครื่องจะทํางานไม่สําเร็จเมื่อเป็นเท็จ
แท็ก:affects_outputs
--[no]build_test_dwp
ค่าเริ่มต้น: "false"-
หากเปิดใช้ เมื่อสร้างการทดสอบ C++ แบบคงที่และด้วย Fission ระบบจะสร้างไฟล์ .dwp สำหรับไบนารีทดสอบโดยอัตโนมัติด้วย
แท็ก:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
ค่าเริ่มต้น: ".pb.h"-
ตั้งค่าส่วนต่อท้ายของไฟล์ส่วนหัวที่ cc_proto_library สร้างขึ้น
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--cc_proto_library_source_suffixes=<comma-separated set of options>
: ".pb.cc" -
ตั้งค่าส่วนต่อท้ายของไฟล์ต้นฉบับที่ cc_proto_library สร้าง
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
ค่าเริ่มต้น: "false"-
เรียกใช้การดำเนินการเพิ่มเติมสำหรับเวอร์ชัน Java API อื่นใน proto_library
แท็ก:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
ค่าเริ่มต้น: "false"-
เรียกใช้การดำเนินการเพิ่มเติมสำหรับเวอร์ชัน Java API อื่นใน proto_library
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_save_feature_state
: "เท็จ" -
บันทึกสถานะของฟีเจอร์ที่เปิดใช้และที่ขอไว้เป็นเอาต์พุตของการคอมไพล์
แท็ก:affects_outputs
,experimental
--fission=<a set of compilation modes>
ค่าเริ่มต้น: "no"-
ระบุว่าโหมดการคอมไพล์ใดใช้ฟิชชันสำหรับการรวบรวมและลิงก์ C++ อาจเป็นชุดค่าผสมใดๆ ระหว่าง {'fastbuild', 'dbg', 'opt'} หรือค่าพิเศษ 'yes' เพื่อเปิดใช้งานทุกโหมด และ 'no' เพื่อปิดใช้งานทุกโหมด
แท็ก:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" กฎแบบเนทีฟจะเพิ่ม <code>DefaultInfo.files</code> ของข้อมูลที่ต้องพึ่งพาลงในไฟล์รันไทม์ ซึ่งตรงกับลักษณะการทำงานที่แนะนำสำหรับกฎ Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid)
แท็ก:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ระบบจะสร้างป่าซิงค์ลิงก์ของไฟล์รันไทม์สำหรับที่เก็บข้อมูลภายนอกในส่วน .runfiles/wsname/external/repo (นอกเหนือจาก .runfiles/repo)
แท็ก:affects_outputs
--[no]objc_generate_linkmap
ค่าเริ่มต้น: "false"-
ระบุว่าจะสร้างไฟล์ Linkmap หรือไม่
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]save_temps
: "เท็จ" -
หากตั้งค่าไว้ ระบบจะบันทึกเอาต์พุตชั่วคราวจาก gcc ซึ่งรวมถึงไฟล์ .s (โค้ดแอสเซมเบลอร์), ไฟล์ .i (C ที่ผ่านการประมวลผลล่วงหน้า) และไฟล์ .ii (C++ ที่ผ่านการประมวลผลล่วงหน้า)
แท็ก:affects_outputs
- ตัวเลือกที่อนุญาตให้ผู้ใช้กําหนดค่าเอาต์พุตที่ต้องการ ซึ่งส่งผลต่อค่าของเอาต์พุต ไม่ใช่การมีอยู่ของเอาต์พุต
--action_env=<a 'name=value' assignment with an optional value part>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดําเนินการที่มีการกำหนดค่าเป้าหมาย คุณระบุตัวแปรได้ด้วยชื่อ ซึ่งในกรณีนี้ระบบจะนําค่าจากสภาพแวดล้อมการเรียกใช้ หรือคู่ name=value ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ ตัวเลือกนี้ใช้ได้หลายครั้ง สำหรับตัวเลือกที่ระบุสำหรับตัวแปรเดียวกัน ค่าที่ชนะล่าสุด จะมีการสะสมตัวเลือกสำหรับตัวแปรต่างๆ
แท็ก:action_command_lines
--android_cpu=<a string>
ค่าเริ่มต้น: "armeabi-v7a"-
CPU เป้าหมายของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
ค่าเริ่มต้น: "true"-
สร้างไฟล์การเชื่อมโยงข้อมูลที่เข้ากันได้กับ AndroidX ใช้ได้เฉพาะกับการเชื่อมโยงข้อมูล v2 เท่านั้น Flag นี้ไม่มีผลใดๆ
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
ค่าเริ่มต้น: "true"-
ใช้ Android Databinding v2 ที่มีอาร์กิวเมนต์ 3.4.0 Flag นี้ไม่มีผลใดๆ
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้นของ
--android_dynamic_mode=<off, default or fully>
: "off" -
กำหนดว่าจะลิงก์ deps C++ ของกฎ Android แบบไดนามิกหรือไม่เมื่อ cc_binary ไม่ได้สร้างไลบรารีที่ใช้ร่วมกันอย่างชัดเจน "default" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "โดยสมบูรณ์" หมายความว่าไลบรารีทั้งหมดจะมีการเชื่อมโยงแบบไดนามิก "ปิด" หมายความว่าระบบจะลิงก์คลังทั้งหมดในโหมดคงที่ส่วนใหญ่
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "alphabetical" -
กำหนดลําดับของไฟล์ Manifest ที่ส่งไปยังเครื่องมือผสานไฟล์ Manifest สําหรับไบนารีของ Android ALPHABETICAL หมายความว่าไฟล์ Manifest จะจัดเรียงตามเส้นทางที่สัมพันธ์กับ execroot 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
ค่าเริ่มต้น: "auto"-
สร้างไฟล์ ZIP ที่เรียกใช้งานได้ของ Python เปิดใน Windows ปิดในแพลตฟอร์มอื่นๆ
แท็ก:affects_outputs
--catalyst_cpus=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple Catalyst
แท็ก:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
ค่าเริ่มต้น: "false"-
หากระบุไว้ Bazel จะใส่เครื่องมือวัดโค้ด (โดยใช้เครื่องมือวัดแบบออฟไลน์หากเป็นไปได้) และจะรวบรวมข้อมูลการครอบคลุมระหว่างการทดสอบ เฉพาะเป้าหมายที่ตรงกับ --instrumentation_filter เท่านั้นที่จะได้รับผลกระทบ โดยปกติแล้วคุณไม่ควรระบุตัวเลือกนี้โดยตรง ควรใช้คำสั่ง "bazelครอบคลุมถึง" แทน
แท็ก: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>
default: ดูคำอธิบาย-
ใช้ข้อมูลโปรไฟล์ CSFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อเส้นทางสัมบูรณ์ของไฟล์ ZIP ที่มีไฟล์โปรไฟล์ ไฟล์โปรไฟล์ LLVM ดิบ หรือไฟล์โปรไฟล์ LLVM ที่จัดทําดัชนี
แท็ก:affects_outputs
--cs_fdo_instrument=<a string>
default: ดูคำอธิบาย-
สร้างไบนารีด้วยเครื่องมือ FDO ที่คำนึงถึงบริบท เมื่อใช้คอมไพเลอร์ Clang/LLVM ระบบจะยอมรับชื่อไดเรกทอรีที่จะใช้วางไฟล์โปรไฟล์ดิบเมื่อรันไทม์ด้วย
แท็ก:affects_outputs
--cs_fdo_profile=<a build target label>
default: ดูคำอธิบาย-
The cs_fdo_profile representing the context sensitive profile to be used for optimization.
แท็ก:affects_outputs
--cxxopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ซอร์ส C++
แท็ก:action_command_lines
,affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--define=<a 'name=value' assignment>
รายการ -
ตัวเลือก --define แต่ละรายการจะระบุการกําหนดค่าสําหรับตัวแปรบิลด์
แท็ก:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
ค่าเริ่มต้น: "default"-
กำหนดว่าจะลิงก์ไบนารี C++ แบบไดนามิกหรือไม่ "default" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "ทั้งหมด" หมายความว่าระบบจะลิงก์คลังทั้งหมดแบบไดนามิก "ปิด" หมายความว่าระบบจะลิงก์คลังทั้งหมดในโหมดคงที่ส่วนใหญ่
แท็ก:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
ค่าเริ่มต้น: "true"-
หากตั้งค่าไว้ การใช้ fdo_absolute_profile_path จะทำให้เกิดข้อผิดพลาด
แท็ก:affects_outputs
--[no]enable_runfiles
ค่าเริ่มต้น: "auto"-
เปิดใช้ต้นไม้สัญลักษณ์ลิงก์ของไฟล์รันไทม์ โดยค่าเริ่มต้นจะปิดอยู่ใน Windows และเปิดอยู่ในแพลตฟอร์มอื่นๆ
แท็ก:affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--experimental_action_listener=<a build target label>
รายการ -
เลิกใช้งานแล้วเพื่อใช้ "แง่มุม" แทน ใช้ action_listener เพื่อแนบ extra_action กับการดำเนินการบิลด์ที่มีอยู่
แท็ก:execution
,experimental
--[no]experimental_android_compress_java_resources
ค่าเริ่มต้น: "false"-
บีบอัดทรัพยากร Java ใน APK
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_android_databinding_v2
: "จริง" -
ใช้ Android Databinding v2 Flag นี้ไม่มีผลใดๆ
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
ค่าเริ่มต้น: "false"-
เปิดใช้การลดขนาดทรัพยากรสำหรับ APK ประเภท android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
ค่าเริ่มต้น: "false"-
ใช้เครื่องมือ rex เพื่อเขียนไฟล์ dex ใหม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้น
--[no]experimental_collect_code_coverage_for_generated_files
: "เท็จ" -
หากระบุไว้ Bazel จะสร้างและรวบรวมข้อมูลการครอบคลุมสำหรับไฟล์ที่สร้างขึ้นด้วย
แท็ก:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
ค่าเริ่มต้น: "-O0,-DDEBUG=1"-
ใช้สตริงเหล่านี้เป็นตัวเลือกคอมไพเลอร์ objc Fastbuild
แท็ก:action_command_lines
--[no]experimental_omitfp
ค่าเริ่มต้น: "false"-
หากเป็นจริง ให้ใช้ libunwind เพื่อคลายสแต็ก แล้วคอมไพล์ด้วย -fomit-frame-pointer และ -fasynchronous-unwind-tables
แท็ก:action_command_lines
,affects_outputs
,experimental
- ค่าเริ่มต้นของ
--experimental_output_paths=<off, content or strip>
: "off" -
โมเดลที่ควรใช้สำหรับส่วนใดในกฎผังเอาต์พุตจะเขียนเอาต์พุต โดยเฉพาะอย่างยิ่งสำหรับบิลด์ที่มีหลายแพลตฟอร์ม / หลายการกำหนดค่า ฟีเจอร์นี้อยู่ในขั้นทดลอง ดูรายละเอียดได้ที่ 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 โดยที่ label หมายถึงแพลตฟอร์ม และ values คือชื่อย่อที่ต้องการใช้ในเส้นทางเอาต์พุต ใช้เมื่อ --experimental_platform_in_output_dir เป็น "จริง" เท่านั้น มีลําดับความสําคัญสูงสุดในการตั้งชื่อ
แท็ก:affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
ค่าเริ่มต้น: "false"-
หากเป็นจริง ระบบจะใช้ชื่อย่อของแพลตฟอร์มเป้าหมายในชื่อไดเรกทอรีเอาต์พุตแทน CPU รูปแบบที่แน่นอนอยู่ในขั้นทดลองและอาจมีการเปลี่ยนแปลง อย่างแรก ในกรณีซึ่งเกิดขึ้นไม่บ่อยนัก ตัวเลือก --platforms ไม่ได้มีค่าเพียงค่าเดียว ระบบจะใช้แฮชของตัวเลือกแพลตฟอร์ม ถัดไป หากมีชื่อย่อสำหรับแพลตฟอร์มปัจจุบันที่ลงทะเบียนโดย --experimental_override_name_platform_in_output_dir ระบบจะใช้ชื่อย่อนั้น จากนั้นหากตั้งค่า --experimental_use_platforms_in_output_dir_legacy_heuristic ให้ใช้ชื่อย่อตามป้ายกำกับแพลตฟอร์มปัจจุบัน สุดท้าย ระบบจะใช้แฮชของตัวเลือกแพลตฟอร์มเป็นทางเลือกสุดท้าย
แท็ก: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. หากระบุ Flag นี้ ระบบจะไม่สนใจ --android_cpu สำหรับข้อกําหนดของกฎ android_binary
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--[no]fat_apk_hwasan
: "เท็จ" -
สร้างการแยก HWASAN หรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--fdo_instrument=<a string>
default: ดูคำอธิบาย-
สร้างไบนารีด้วยเครื่องมือวัดผล FDO เมื่อใช้คอมไพเลอร์ Clang/LLVM ระบบจะยอมรับชื่อไดเรกทอรีที่จะใช้วางไฟล์โปรไฟล์ดิบเมื่อรันไทม์ด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_optimize=<a string>
: ดูคำอธิบาย -
ใช้ข้อมูลโปรไฟล์ FDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อไฟล์ ZIP ที่มีโครงสร้างไฟล์ .gcda, ไฟล์ afdo ที่มีโปรไฟล์อัตโนมัติ หรือไฟล์โปรไฟล์ LLVM นอกจากนี้ Flag นี้ยังยอมรับไฟล์ที่ระบุเป็นป้ายกำกับ (เช่น `//foo/bar:file.afdo` - คุณอาจต้องเพิ่มคำสั่ง `exports_files` ลงในแพ็กเกจที่เกี่ยวข้อง) และป้ายกำกับที่ชี้ไปยังเป้าหมาย `fdo_profile` ด้วย การตั้งค่าสถานะนี้จะถูกแทนที่โดยกฎ "fdo_profile"
แท็ก:affects_outputs
--fdo_prefetch_hints=<a build target label>
default: ดูคำอธิบาย-
ใช้คำแนะนำการดึงข้อมูลแคชล่วงหน้า
แท็ก:affects_outputs
--fdo_profile=<a build target label>
default: ดูคำอธิบาย-
fdo_profile ที่แสดงถึงโปรไฟล์ที่จะใช้เพิ่มประสิทธิภาพ
แท็ก:affects_outputs
--features=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบบจะเปิดหรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างในการกําหนดค่าเป้าหมาย การระบุ -<feature> จะปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ และดูที่ --host_features
แท็ก:changes_inputs
,affects_outputs
--[no]force_pic
ค่าเริ่มต้น: "false"-
หากเปิดใช้ การคอมไพล์ C++ ทั้งหมดจะสร้างโค้ดที่ไม่ขึ้นกับตำแหน่ง ("-fPIC") การลิงก์จะเลือกไลบรารีที่สร้างไว้ล่วงหน้าแบบ PIC มากกว่าไลบรารีที่ไม่ใช่ PIC และการลิงก์จะสร้างไฟล์ปฏิบัติการที่ไม่ขึ้นกับตำแหน่ง ("-pie")
แท็ก:loading_and_analysis
,affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกําหนดค่าการดําเนินการ คุณระบุตัวแปรได้ด้วยชื่อ ซึ่งในกรณีนี้ระบบจะนําค่าจากสภาพแวดล้อมการเรียกใช้ หรือคู่ 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++) ในการกำหนดค่า exec
แท็ก:action_command_lines
,affects_outputs
--host_copt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยังคอมไพเลอร์ C สําหรับเครื่องมือที่สร้างในการกําหนดค่า exec
แท็ก: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>
default: ดูคำอธิบาย-
ลบล้างเวอร์ชัน Python สําหรับการกําหนดค่า exec อาจเป็น "PY2" หรือ "PY3"
แท็ก:loading_and_analysis
,affects_outputs
--host_linkopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง linker เมื่อลิงก์เครื่องมือในการกําหนดค่า exec
แท็ก:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: ดูคำอธิบาย-
เวอร์ชัน macOS ที่เข้ากันได้ขั้นต่ำสำหรับเป้าหมายโฮสต์ หากไม่ได้ระบุ ให้ใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมในการส่งไปยังคอมไพเลอร์ C/C++ แบบเลือกได้เมื่อคอมไพล์ไฟล์บางไฟล์ในการกําหนดค่า exec ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter หมายถึงรายการรูปแบบนิพจน์ทั่วไปที่รวมและไม่รวม (ดูที่ --instrumentation_filter ด้วย) option_1 ถึง option_n หมายถึงตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีคอมมา จะต้องใส่เครื่องหมายคำพูดด้วยเครื่องหมายแบ็กสแลช ตัวเลือกอาจมี @ แต่ระบบจะใช้เฉพาะ @ แรกในการแยกสตริง ตัวอย่างเช่น --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 จะเพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ลงในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
,affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_swiftcopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง swiftc สําหรับเครื่องมือ exec
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้น
--[no]incompatible_auto_exec_groups
: "เท็จ" -
เมื่อเปิดใช้ ระบบจะสร้างกลุ่มผู้บริหารสำหรับ Toolchain แต่ละรายการที่กฎใช้โดยอัตโนมัติ กฎต้องระบุพารามิเตอร์ "toolchain" ในการดำเนินการเพื่อให้การทำงานนี้ได้ผล ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/17134
แท็ก:affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ระบบจะรวมไดเรกทอรี genfiles ไว้ในไดเรกทอรี bin
แท็ก:affects_outputs
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_use_host_features
: "จริง" -
หากเป็น "จริง" ให้ใช้ --features สำหรับการกำหนดค่าเป้าหมายเท่านั้น และ --host_features สำหรับการกำหนดค่า exec
แท็ก:changes_inputs
,affects_outputs
,incompatible_change
--[no]instrument_test_targets
ค่าเริ่มต้น: "false"-
เมื่อเปิดใช้การครอบคลุม ให้ระบุว่าจะพิจารณาเครื่องมือวัดกฎการทดสอบหรือไม่ เมื่อตั้งค่าแล้ว ระบบจะเครื่องมือวัดกฎการทดสอบที่รวมโดย --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_application ผลลัพธ์ที่ได้คือไบนารีแบบสากลที่มีสถาปัตยกรรมที่ระบุไว้ทั้งหมด
แท็ก:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
ค่าเริ่มต้น: "true"-
เลิกใช้งานแล้ว แทนที่ด้วย --incompatible_remove_legacy_whole_archive (ดูรายละเอียดที่ https://github.com/bazelbuild/bazel/issues/7362) เมื่อเปิดใช้ ให้ใช้ --whole-archive สำหรับกฎ cc_binary ที่มี linkshared=True และ linkstatic=True หรือ "-static" ใน linkopts วิธีนี้ใช้สำหรับความเข้ากันได้แบบย้อนหลังเท่านั้น วิธีอื่นที่ดีกว่าคือการใช้ alwayslink=1 ในที่ที่ต้องใช้
แท็ก:action_command_lines
,affects_outputs
,deprecated
--linkopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง gcc เมื่อลิงก์
แท็ก:action_command_lines
,affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ltobackendopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมที่จะส่งไปยังขั้นตอนแบ็กเอนด์ LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
,affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ltoindexopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมที่จะส่งไปยังขั้นตอนการจัดทำดัชนี LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
,affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--macos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple macOS
แท็ก:loses_incremental_state
,loading_and_analysis
- ค่าเริ่มต้น
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน macOS ขั้นต่ำที่เข้ากันได้สำหรับเป้าหมาย หากไม่ได้ระบุ ให้ใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
--memprof_profile=<a build target label>
default: ดูคำอธิบาย-
ใช้โปรไฟล์ memprof
แท็ก:affects_outputs
--[no]objc_debug_with_GLIBCXX
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ และตั้งค่าโหมดการคอมไพล์เป็น "dbg" ให้กำหนด GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC และ GLIBCPP_CONCEPT_CHECKS
แท็ก:action_command_lines
- ค่าเริ่มต้น
--[no]objc_enable_binary_stripping
: "เท็จ" -
กำหนดว่าจะทำการลบสัญลักษณ์และโค้ดที่ตายแล้วในไบนารีที่ลิงก์หรือไม่ ระบบจะดำเนินการลบข้อมูลในไบนารีหากระบุทั้ง Flag นี้และ --compilation_mode=opt
แท็ก:action_command_lines
--objccopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ซอร์ส Objective-C/C++
แท็ก:action_command_lines
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมในการส่งไปยัง gcc แบบเลือกได้เมื่อคอมไพล์ไฟล์บางไฟล์ ตัวเลือกนี้ส่งได้หลายครั้ง รูปแบบคำสั่ง: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter หมายถึงรายการรูปแบบนิพจน์ทั่วไปที่รวมและไม่รวม (ดูที่ --instrumentation_filter ด้วย) option_1 ถึง option_n หมายถึงตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีคอมมา จะต้องใส่เครื่องหมายคำพูดด้วยเครื่องหมายแบ็กสแลช ตัวเลือกอาจมี @ แต่ระบบจะใช้เฉพาะ @ แรกในการแยกสตริง ตัวอย่างเช่น --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 จะเพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ลงในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
,affects_outputs
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมในการส่งไปยังแบ็กเอนด์ LTO แบบเลือก (ในส่วน --features=thin_lto) เมื่อคอมไพล์ออบเจ็กต์แบ็กเอนด์บางรายการ ตัวเลือกนี้ส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจาก "รวมและยกเว้น" รูปแบบนิพจน์ทั่วไป ตัวเลือก_1 ถึง "ตัวเลือก_n" คือตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบ็กสแลชในเครื่องหมายคำพูดนั้น ตัวเลือกอาจมี @ แต่ระบบจะใช้เฉพาะ @ แรกในการแยกสตริง ตัวอย่างเช่น --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 จะเพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ลงในบรรทัดคำสั่งแบ็กเอนด์ LTO ของไฟล์ o ทั้งหมดใน //foo/ ยกเว้น bar.o
แท็ก:action_command_lines
,affects_outputs
--platform_suffix=<a string>
default: ดูคำอธิบาย-
ระบุส่วนต่อท้ายที่จะเพิ่มลงในไดเรกทอรีการกําหนดค่า
แท็ก:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
default: ดูคำอธิบาย-
ใช้ข้อมูลโปรไฟล์ของ Propeller เพื่อเพิ่มประสิทธิภาพเป้าหมายของบิลด์ โปรไฟล์ใบพัดต้องประกอบด้วยไฟล์อย่างน้อย 1 จาก 2 ไฟล์ ได้แก่ โปรไฟล์ CC และโปรไฟล์ ld Flag นี้ยอมรับป้ายกำกับบิลด์ซึ่งต้องอ้างอิงถึงไฟล์อินพุตโปรไฟล์ใบพัด ตัวอย่างเช่น ไฟล์ 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 สำหรับบิลด์ Propeller Optimized
แท็ก:affects_outputs
- ค่าเริ่มต้น
--propeller_optimize_absolute_ld_profile=<a string>
: ดูคำอธิบาย -
ชื่อเส้นทางแบบสัมบูรณ์ของไฟล์ ld_profile สำหรับบิลด์ Propeller Optimized
แท็ก:affects_outputs
--run_under=<a prefix in front of command>
default: ดูคำอธิบาย-
คำนำหน้าที่จะแทรกไว้ก่อนไฟล์ปฏิบัติการสำหรับคำสั่ง "test" และ "run" หากค่าคือ "foo -bar" และบรรทัดคำสั่งการดําเนินการคือ "test_binary -baz" บรรทัดคำสั่งสุดท้ายจะเป็น "foo -bar test_binary -baz" ซึ่งอาจเป็นป้ายกำกับของเป้าหมายที่เรียกใช้ได้เช่นกัน ตัวอย่างบางส่วน ได้แก่ "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", '//package:target', '//package:target --options'
แท็ก:action_command_lines
-
หากเป็น "จริง" ระบบจะแชร์ไลบรารีเนทีฟที่มีฟังก์ชันการทำงานเหมือนกันระหว่างเป้าหมายต่างๆ
แท็ก:loading_and_analysis
,affects_outputs
- ค่าเริ่มต้น
--[no]stamp
: "เท็จ" -
ประทับเวลาไบนารีด้วยวันที่ ชื่อผู้ใช้ ชื่อโฮสต์ ข้อมูลเวิร์กスペース ฯลฯ
แท็ก:affects_outputs
--strip=<always, sometimes or never>
ค่าเริ่มต้น: "บางครั้ง"-
ระบุว่าจะลบข้อมูลโค้ดที่ไม่จำเป็นในไฟล์ไบนารีและไลบรารีที่ใช้ร่วมกันหรือไม่ (โดยใช้ "-Wl,--strip-debug") ค่าเริ่มต้นของ "บางครั้ง" หมายถึง Strip iff --compilation_mode=fastbuild
แท็ก:affects_outputs
--stripopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง strip เมื่อสร้างไบนารี "<name>.stripped"
แท็ก:action_command_lines
,affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--swiftcopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมที่จะส่งไปยังการคอมไพล์ Swift
แท็ก:action_command_lines
--tvos_cpus=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารี Apple tvOS
แท็ก:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: ดูคำอธิบาย-
เวอร์ชัน 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')>
default: ดูคำอธิบาย-
เวอร์ชัน 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 ใช้บังคับอินพุตการสร้างที่ถูกต้อง (คําจํากัดความของกฎ ชุดค่าผสมของ Flag ฯลฯ)
--auto_cpu_environment_group=<a build target label>
ค่าเริ่มต้น: ""-
ประกาศ environment_group ที่จะใช้สําหรับการแมปค่า cpu กับค่า target_environment โดยอัตโนมัติ
แท็ก:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
ค่าเริ่มต้น: "false"-
ตรวจสอบว่าข้อจำกัดการอนุญาตให้ใช้สิทธิที่แพ็กเกจที่ต้องพึ่งพากำหนดไว้ไม่ขัดแย้งกับโหมดการจัดจำหน่ายของเป้าหมายที่สร้าง โดยค่าเริ่มต้น ระบบจะไม่ตรวจสอบใบอนุญาต
แท็ก:build_file_semantics
--[no]check_visibility
ค่าเริ่มต้น: "true"-
หากปิดใช้ ระบบจะลดระดับข้อผิดพลาดด้านการแสดงผลในข้อกําหนดของเป้าหมายเป็นคําเตือน
แท็ก:build_file_semantics
--[no]desugar_for_android
ค่าเริ่มต้น: "true"-
กำหนดว่าจะยกเลิกการทำให้โค้ด Java 8 เป็น Sugar ก่อนการแยกไฟล์หรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
ค่าเริ่มต้น: "false"-
การรวมไลบรารี Java 8 ที่รองรับไว้ในแอปสำหรับอุปกรณ์รุ่นเดิมหรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
ค่าเริ่มต้น: "true"-
ตรวจสอบสภาพแวดล้อมที่เป้าหมายแต่ละรายการเข้ากันได้ และรายงานข้อผิดพลาดหากเป้าหมายใดมีทรัพยากร Dependencies ที่ไม่รองรับสภาพแวดล้อมเดียวกัน
แท็ก:build_file_semantics
--[no]experimental_check_desugar_deps
ค่าเริ่มต้น: "true"-
กำหนดว่าจะตรวจสอบการลดน้ำตาลที่ถูกต้องอีกครั้งที่ระดับไบนารีของ Android หรือไม่
แท็ก:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<off, warning or error>
ค่าเริ่มต้น: "OFF"-
เมื่อเปิดใช้แล้ว ให้ตรวจสอบว่ารายการอ้างอิงของ aar_import สมบูรณ์หรือไม่ การบังคับใช้นี้อาจทำให้บิลด์เสียหายหรืออาจทำให้เกิดคำเตือน
แท็ก: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>
ค่าเริ่มต้น: "default"-
หากเป็น "จริง" ระบบจะตรวจสอบว่าเป้าหมาย Java ประกาศเป้าหมายทั้งหมดที่ใช้โดยตรงเป็น Dependency อย่างชัดเจน
แท็ก:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
ค่าเริ่มต้น: "false"-
หากเปิดใช้ ให้ตรวจสอบ testonly สำหรับเป้าหมายที่เป็นข้อกําหนดเบื้องต้นซึ่งเป็นไฟล์เอาต์พุตโดยค้นหา testonly ของกฎการสร้าง ซึ่งตรงกับการตรวจสอบระดับการเข้าถึง
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
ค่าเริ่มต้น: "false"-
หากเปิดใช้ การตรวจสอบระดับการเข้าถึงจะมีผลกับการติดตั้งใช้งาน Toolchain ด้วย
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
ค่าเริ่มต้น: "false"-
หากเปิดใช้ ระบบจะปิดใช้กฎเนทีฟของ Android โดยตรง โปรดใช้กฎ Starlark สำหรับ Android จาก https://github.com/bazelbuild/rules_android
แท็ก:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
ค่าเริ่มต้น: "false"-
ไม่มีการดำเนินการใดๆ เก็บไว้ที่นี่เพื่อให้มีความเข้ากันได้แบบย้อนหลัง
แท็ก:eagerness_to_exit
,incompatible_change
--[no]incompatible_python_disable_py2
ค่าเริ่มต้น: "true"-
หากเป็นจริง การใช้การตั้งค่า Python 2 จะทำให้เกิดข้อผิดพลาด ซึ่งรวมถึง python_version=PY2, srcs_version=PY2 และ srcs_version=PY2ONLY ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/15684
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" Bazel จะตรวจสอบการรวมส่วนหัวของไดเรกทอรีระดับบนสุดด้วย (ดูข้อมูลเพิ่มเติมที่ https://github.com/bazelbuild/bazel/issues/10047)
แท็ก:loading_and_analysis
,incompatible_change
--[no]one_version_enforcement_on_java_tests
ค่าเริ่มต้น: "true"-
เมื่อเปิดใช้ และตั้งค่าการทดลอง_one_version_enforcement เป็นค่าที่ไม่ใช่ NONE แล้ว ให้บังคับใช้ 1 เวอร์ชันกับเป้าหมาย java_test คุณปิดใช้ Flag นี้เพื่อปรับปรุงประสิทธิภาพการทดสอบที่เพิ่มขึ้นได้ แต่อาจพลาดการละเมิดเวอร์ชันเดียวที่อาจเกิดขึ้น
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--python_native_rules_allowlist=<a build target label>
: ดูคำอธิบาย -
รายการที่อนุญาต (เป้าหมาย package_group) เพื่อใช้เมื่อบังคับใช้ --incompatible_python_disallow_native_rules
แท็ก:loading_and_analysis
--[no]strict_filesets
ค่าเริ่มต้น: "false"-
หากเปิดใช้ตัวเลือกนี้ ระบบจะรายงานไฟล์เซ็ตที่ข้ามขอบเขตแพ็กเกจเป็นข้อผิดพลาด
แท็ก:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
ค่าเริ่มต้น: "error"-
หากไม่ "ปิดใช้" ให้ตรวจสอบว่าเป้าหมาย 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>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ประกาศสภาพแวดล้อมเป้าหมายของบิลด์นี้ ต้องเป็นการอ้างอิงป้ายกำกับไปยังกฎ "environment" หากระบุ เป้าหมายระดับบนสุดทั้งหมดต้องเข้ากันได้กับสภาพแวดล้อมนี้
แท็ก: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" -
หากตั้งค่าไว้และโหมดการคอมไพล์ไม่ใช่ "opt" แอป objc จะรวมการให้สิทธิ์แก้ไขข้อบกพร่องเมื่อลงชื่อ
แท็ก:changes_inputs
--ios_signing_cert_name=<a string>
default: ดูคำอธิบาย-
ชื่อใบรับรองที่จะใช้สำหรับการลงนาม iOS หากไม่ได้ตั้งค่าไว้ ระบบจะใช้โปรไฟล์การจัดสรรแทน อาจเป็นค่ากำหนดข้อมูลระบุตัวตนในพวงกุญแจของใบรับรองหรือ (สตริงย่อย) ของชื่อจริงของใบรับรอง ตามหน้าข้อมูลของ codesign (ข้อมูลระบุตัวตนสำหรับการลงนาม)
แท็ก:action_command_lines
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
--[no]incompatible_config_setting_private_default_visibility
ค่าเริ่มต้น: "false"-
หากตัวยึดตำแหน่ง_enforce_config_setting_visibility=false จะหมายความว่าไม่มีการดำเนินการ หรือหาก Flag นี้เป็นเท็จ config_setting ที่ไม่มีแอตทริบิวต์ระดับการมองเห็นที่ชัดเจนจะเป็น //visibility:public หาก Flag นี้เป็น "จริง" config_setting จะใช้ตรรกะการแสดงผลเดียวกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_legacy_py_provider
ค่าเริ่มต้น: "true"-
ไม่มีการดำเนินการใดๆ ระบบจะนำออกในเร็วๆ นี้
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" ไม่อนุญาตแอตทริบิวต์ sdk_frameworks และ external_sdk_frameworks ใน objc_library andobjc_import
แท็ก:build_file_semantics
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_enforce_config_setting_visibility
: "จริง" -
หากเป็น "จริง" ระบบจะบังคับใช้ข้อจำกัดการแสดงผลของ config_setting หากเป็นเท็จ เป้าหมายทุกรายการจะเห็น config_setting ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" ให้ตั้งค่าเริ่มต้นเป็น "จริง" สําหรับแอตทริบิวต์ alwayslink ใน objc_library และ objc_import
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
ค่าเริ่มต้น: "false"-
เมื่อเป็น "จริง" ระบบจะแสดงข้อผิดพลาดเมื่อใช้กฎ py_* ในตัว คุณควรใช้กฎ rule_python แทน ดูข้อมูลเพิ่มเติมและวิธีการย้ายข้อมูลได้ที่ https://github.com/bazelbuild/bazel/issues/17773
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่ควบคุมลักษณะการทำงานของสภาพแวดล้อมการทดสอบหรือตัวดำเนินการทดสอบมีดังนี้
- ค่าเริ่มต้น
--[no]allow_analysis_failures
: "เท็จ" -
หากเป็นจริง การวิเคราะห์เป้าหมายของกฎไม่สำเร็จส่งผลให้เกิดการเผยแพร่อินสแตนซ์ของ AnalysisFailureInfo ของเป้าหมายที่มีคำอธิบายข้อผิดพลาด แทนที่จะทำให้บิลด์ล้มเหลว
แท็ก:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
ค่าเริ่มต้น: "2000"-
กำหนดจำนวนสูงสุดของความสัมพันธ์แบบสื่อกลางผ่านแอตทริบิวต์กฎที่มีการเปลี่ยนการกำหนดค่า for_analysis_testing การเกินขีดจํากัดนี้จะทำให้เกิดข้อผิดพลาดเกี่ยวกับกฎ
แท็ก:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
ค่าเริ่มต้น: "false"-
หากความล้มเหลวจริงในการดำเนินการ dex2oat จะทำให้บิลด์ขัดข้องแทนที่จะเรียกใช้ dex2oat ระหว่างรันไทม์ทดสอบ
แท็ก:loading_and_analysis
,experimental
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g. memory=10,30,60,100>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างจำนวนทรัพยากรเริ่มต้นสำหรับการทดสอบ รูปแบบที่รองรับคือ <resource>=<value> หากระบุตัวเลขบวกเพียงค่าเดียวเป็น <value> ระบบจะลบล้างทรัพยากรเริ่มต้นสำหรับขนาดการทดสอบทั้งหมด หากระบุตัวเลข 4 รายการที่คั่นด้วยคอมมา ระบบจะลบล้างจำนวนทรัพยากรสําหรับขนาดการทดสอบขนาดเล็ก กลาง ใหญ่ และใหญ่มากตามลําดับ ค่าอาจเป็น HOST_RAM/HOST_CPU ตามด้วย [-|*]<float> (ไม่บังคับ) ก็ได้ (เช่น memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4) ทรัพยากรการทดสอบเริ่มต้นที่ระบุโดย Flag นี้จะลบล้างโดยทรัพยากรที่ระบุอย่างชัดเจนในแท็ก
- ค่าเริ่มต้น
--[no]experimental_android_use_parallel_dex2oat
: "เท็จ" -
ใช้ dex2oat ควบคู่กันเพื่อเพิ่มความเร็วของ android_test
แท็ก:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
ค่าเริ่มต้น: "false"-
เปิดใช้การตรวจหาหน่วยความจำรั่วไหลในเป้าหมาย ios_test
แท็ก:action_command_lines
- ค่าเริ่มต้น
--ios_simulator_device=<a string>
: ดูคำอธิบาย -
อุปกรณ์ที่จะจําลองเมื่อเรียกใช้แอปพลิเคชัน iOS ในโปรแกรมจําลอง เช่น "iPhone 6" คุณสามารถดูรายการอุปกรณ์ได้โดยเรียกใช้ "xcrun simctl list devicetypes" ในเครื่องที่จะเรียกใช้โปรแกรมจำลอง
แท็ก:test_runner
- ค่าเริ่มต้น
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูคำอธิบาย -
เวอร์ชัน iOS ที่จะใช้งานบนเครื่องจำลองเมื่อเรียกใช้หรือทดสอบ ระบบจะละเว้นค่านี้สำหรับกฎ ios_test หากมีการระบุอุปกรณ์เป้าหมายในกฎ
แท็ก:test_runner
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ระบุจํานวนครั้งที่จะเรียกใช้การทดสอบแต่ละรายการ หากการพยายามดังกล่าวไม่สำเร็จไม่ว่าด้วยเหตุผลใดก็ตาม ระบบจะถือว่าการทดสอบทั้งหมดไม่สำเร็จ โดยปกติแล้วค่าที่ระบุจะเป็นจำนวนเต็มเท่านั้น ตัวอย่าง: --runs_per_test=3 จะทำการทดสอบทั้งหมด 3 ครั้ง ไวยากรณ์สำรอง: regex_filter@runs_per_test โดยที่ runs_per_test หมายถึงค่าจำนวนเต็ม และ regex_filter หมายถึงรายการรูปแบบนิพจน์ทั่วไปที่รวมและไม่รวม (ดู --instrumentation_filter ด้วย) ตัวอย่างเช่น --runs_per_test=//foo/.*,-//foo/bar/.*@3 เรียกใช้การทดสอบทั้งหมดใน //foo/ ยกเว้นการทดสอบที่อยู่ใน foo/bar 3 ครั้ง ตัวเลือกนี้ส่งได้หลายครั้ง อาร์กิวเมนต์ที่ตรงกันซึ่งส่งล่าสุดจะมีความสําคัญเหนือกว่า หากไม่พบรายการที่ตรงกัน ระบบจะเรียกใช้การทดสอบเพียงครั้งเดียว
--test_env=<a 'name=value' assignment with an optional value part>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุตัวแปรสภาพแวดล้อมเพิ่มเติมที่จะแทรกลงในสภาพแวดล้อมตัวดำเนินการทดสอบ คุณสามารถระบุตัวแปรโดยใช้ชื่อ ซึ่งระบบจะอ่านค่าจากสภาพแวดล้อมไคลเอ็นต์ Bazel หรือจะระบุโดยใช้คู่ชื่อ=ค่าก็ได้ คุณใช้ตัวเลือกนี้ได้หลายครั้งเพื่อระบุตัวแปรหลายรายการ ใช้โดยคำสั่ง "bazel test" เท่านั้น
แท็ก:test_runner
- ค่าเริ่มต้นของ
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - ลบล้างค่าระยะหมดเวลาในการทดสอบเริ่มต้นสำหรับระยะหมดเวลาทดสอบ (เป็นวินาที) หากระบุค่าจำนวนเต็มบวกเพียงค่าเดียว ระบบจะลบล้างหมวดหมู่ทั้งหมด หากระบุจำนวนเต็ม 4 รายการที่คั่นด้วยคอมมา ระบบจะลบล้างการหมดเวลาสำหรับระยะสั้น ปานกลาง ยาว และตลอดไป (ตามลำดับ) ไม่ว่าจะเป็นรูปแบบใด ค่า -1 จะบอกให้ Blaze ใช้ระยะหมดเวลาเริ่มต้นสำหรับหมวดหมู่นั้น
--[no]zip_undeclared_test_outputs
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ระบบจะเก็บถาวรเอาต์พุตการทดสอบที่ไม่ได้ประกาศไว้ในไฟล์ ZIP
แท็ก:test_runner
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--[no]configure
ค่าเริ่มต้น: "false"-
ดึงข้อมูลเฉพาะที่เก็บข้อมูลที่ทําเครื่องหมายเป็น "กําหนดค่า" เพื่อวัตถุประสงค์ในการกําหนดค่าระบบ ใช้ได้ก็ต่อเมื่อ --enable_bzlmod เปิดอยู่
แท็ก:changes_inputs
--[no]force
ค่าเริ่มต้น: "false"-
ละเว้นที่เก็บที่มีอยู่ (หากมี) และบังคับให้ดึงข้อมูลที่เก็บอีกครั้ง ใช้งานได้เมื่อ --enable_bzlmod เปิดอยู่เท่านั้น
แท็ก:changes_inputs
--repo=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ดึงข้อมูลเฉพาะที่เก็บข้อมูลที่ระบุ ซึ่งอาจเป็น {@apparent_repo_name} หรือ {@@canonical_repo_name} ใช้ได้ก็ต่อเมื่อ --enable_bzlmod เปิดอยู่
แท็ก:changes_inputs
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพของเวลาสร้างมีดังนี้
--[no]experimental_filter_library_jar_with_program_jar
ค่าเริ่มต้น: "false"-
กรอง ProgramJar ของ ProGuard เพื่อนำคลาสที่อยู่ใน LibraryJar ออกด้วย
แท็ก:action_command_lines
--[no]experimental_inmemory_dotd_files
ค่าเริ่มต้น: "true"-
หากเปิดใช้ ระบบจะส่งไฟล์ .d ของ C++ ในหน่วยความจำจากโหนดการสร้างระยะไกลโดยตรงแทนที่จะเขียนลงในดิสก์
แท็ก:loading_and_analysis
,execution
,affects_outputs
,experimental
- ค่าเริ่มต้น
--[no]experimental_inmemory_jdeps_files
: "จริง" -
หากเปิดใช้ ระบบจะส่งไฟล์ที่ต้องพึ่งพา (.jdeps) ที่สร้างขึ้นจากการคอมไพล์ Java ผ่านหน่วยความจำจากโหนดการสร้างระยะไกลโดยตรงแทนที่จะเขียนลงในดิสก์
แท็ก:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_objc_include_scanning
ค่าเริ่มต้น: "false"-
ไม่ว่าจะดำเนินการรวมการสแกนสำหรับวัตถุประสงค์ C/C++ หรือไม่
แท็ก:loading_and_analysis
,execution
,changes_inputs
- ค่าเริ่มต้น
--[no]experimental_retain_test_configuration_across_testonly
: "เท็จ" -
เมื่อเปิดใช้ --trim_test_configuration จะไม่ตัดการกำหนดค่าการทดสอบสำหรับกฎที่มีการทำเครื่องหมาย testonly=1 การดำเนินการนี้มีไว้เพื่อลดปัญหาการขัดแย้งของการดำเนินการเมื่อกฎที่ไม่ใช่การทดสอบขึ้นอยู่กับกฎ cc_test จะไม่มีผลหาก --trim_test_configuration เป็นเท็จ
แท็ก:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
ค่าเริ่มต้น: "false"-
หากเปิดใช้ คุณจะสามารถใช้ cc_import เวอร์ชัน Starlark ได้
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_unsupported_and_brittle_include_scanning
: "เท็จ" -
การจำกัดอินพุตให้แคบลงสำหรับการคอมไพล์ C/C++ โดยการแยกวิเคราะห์บรรทัด #include จากไฟล์อินพุต ซึ่งจะช่วยปรับปรุงประสิทธิภาพและความสามารถในการเพิ่มประสิทธิภาพโดยการลดขนาดของต้นไม้อินพุตการคอมไพล์ อย่างไรก็ตาม ก็อาจทำให้บิลด์เสียหายได้เช่นกัน เนื่องจากเครื่องมือสแกนดังกล่าวไม่สามารถใช้งานความหมายของโปรเซสเซอร์ล่วงหน้าแบบ C ได้อย่างสมบูรณ์ โดยเฉพาะอย่างยิ่ง จะไม่เข้าใจคำสั่ง #include แบบไดนามิกและไม่สนใจตรรกะแบบมีเงื่อนไขของโปรแกรมประมวลผลข้อมูลล่วงหน้า คุณต้องรับความเสี่ยงของการใช้งานเอง เราจะปิดปัญหาทั้งหมดที่เกี่ยวข้องกับการแจ้งว่าไม่เหมาะสมนี้
แท็ก:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
ค่าเริ่มต้น: "true"-
ทํางานส่วนใหญ่สําหรับการจัดทําดัชนีแยกกันสําหรับไฟล์ Jar แต่ละไฟล์
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--[no]objc_use_dotd_pruning
: "จริง" -
หากตั้งค่าไว้ ระบบจะใช้ไฟล์ .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>
: "-.*" -
พิมพ์ข้อมูลการแก้ไขข้อบกพร่องระหว่างการแปลงเครื่องมือเชน Flag จะใช้นิพจน์ทั่วไป ซึ่งจะตรวจสอบกับประเภทเครื่องมือและเป้าหมายที่เฉพาะเจาะจงเพื่อดูว่าควรแก้ไขข้อบกพร่องรายการใด คุณคั่นนิพจน์ทั่วไปหลายรายการด้วยคอมมา จากนั้นระบบจะตรวจสอบนิพจน์ทั่วไปแต่ละรายการแยกกัน หมายเหตุ: เอาต์พุตของ Flag นี้จะซับซ้อนมากและอาจเป็นประโยชน์ต่อผู้เชี่ยวชาญในการแก้ปัญหาเกี่ยวกับเครื่องมือทางเทคนิคเท่านั้น
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
--flag_alias=<a 'name=value' flag alias>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตั้งชื่อย่อสำหรับ Flag ของ Starlark โดยจะใช้คู่คีย์-ค่าเดียวในรูปแบบ "<key>=<value>" เป็นอาร์กิวเมนต์
แท็ก:changes_inputs
--[no]incompatible_default_to_explicit_init_py
ค่าเริ่มต้น: "false"-
แฟล็กนี้เปลี่ยนลักษณะการทำงานเริ่มต้นเพื่อไม่ให้สร้างไฟล์ __init__.py โดยอัตโนมัติในไฟล์รันไทม์ของเป้าหมาย Python อีกต่อไป กล่าวโดยละเอียดคือ เมื่อเป้าหมาย py_binary หรือ py_test มีการตั้งค่า legacy_create_init เป็น "auto" (ค่าเริ่มต้น) ระบบจะถือว่าค่านี้เป็นเท็จก็ต่อเมื่อมีการตั้งค่า Flag นี้เท่านั้น ดู 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 หากคุณตั้งค่า Flag นี้ เราขอแนะนำให้ตั้งค่า `--incompatible_py2_outputs_are_suffixed` ด้วยเช่นกัน
แท็ก:loading_and_analysis
,affects_outputs
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_use_python_toolchains
: "จริง" -
หากตั้งค่าเป็น "จริง" กฎ Python เดิมที่เรียกใช้ได้จะใช้รันไทม์ Python ที่ระบุโดยชุดเครื่องมือ Python แทนรันไทม์ที่ระบุโดย Flag รุ่นเดิม เช่น --python_top
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้น
--python_version=<PY2 or PY3>
: ดูคำอธิบาย -
โหมดเวอร์ชันหลักของ Python ซึ่งอาจเป็น "PY2" หรือ "PY3" โปรดทราบว่าเป้าหมาย "py_binary" และ "py_test" จะลบล้างค่านี้ (แม้ว่าจะไม่ระบุเวอร์ชันอย่างชัดเจนก็ตาม) ดังนั้นจึงไม่ค่อยมีเหตุผลที่จะต้องระบุ Flag นี้
แท็ก:loading_and_analysis
,affects_outputs
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้
--[no]cache_test_results
[-t
] ค่าเริ่มต้น: "auto"- หากตั้งค่าเป็น "auto" ไว้ Bazel จะทำการทดสอบอีกครั้งก็ต่อเมื่อ (1) Bazel ตรวจพบการเปลี่ยนแปลงในการทดสอบหรือข้อมูลที่ต้องพึ่งพา (2) มีการทําเครื่องหมายการทดสอบว่าเป็นแบบภายนอก (3) มีคำขอการทดสอบหลายรายการด้วย --runs_per_test หรือ(4) การทดสอบก่อนหน้านี้ไม่สําเร็จ หากตั้งค่าเป็น "ใช่" Bazel จะแคชผลการทดสอบทั้งหมด ยกเว้นการทดสอบที่ทำเครื่องหมายว่าภายนอก หากตั้งค่าเป็น "no" ไว้ Bazel จะไม่แคชผลการทดสอบใดๆ
--deleted_packages=<comma-separated list of package names>
ระบบจะรวบรวมการใช้งานหลายครั้ง- รายการชื่อแพ็กเกจที่คั่นด้วยคอมมา ซึ่งระบบบิลด์จะถือว่าไม่มีอยู่ แม้ว่าจะปรากฏในเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจที่มีอยู่ "x" ตัวอย่างเช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์แล้ว ระบบบิลด์อาจแสดงข้อผิดพลาดหากพบป้ายกำกับ "//x:y/z" หากยังมีรายการ package_path อื่นระบุอยู่ การระบุ --deleted_packages x/y จะช่วยหลีกเลี่ยงปัญหานี้ได้
- ค่าเริ่มต้น
--[no]experimental_cancel_concurrent_tests
: "เท็จ" -
หากเป็น "จริง" Blaze จะยกเลิกการทดสอบที่ทํางานพร้อมกันเมื่อการเรียกใช้ครั้งแรกสําเร็จ วิธีนี้จะมีประโยชน์เมื่อใช้ร่วมกับ --runs_per_test_detects_flakes เท่านั้น
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" Bazel จะดึงข้อมูลไดเรกทอรีข้อมูลการครอบคลุมทั้งหมดสำหรับการทดสอบแต่ละครั้งระหว่างการทำงานของการครอบคลุม
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" การครอบคลุมสำหรับ clang จะสร้างรายงาน LCOV
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
ค่าเริ่มต้น: "true"- สร้างแผนที่ส่วนหัว J2ObjC ควบคู่กับการแปลง J2ObjC หรือไม่
- ค่าเริ่มต้น
--[no]experimental_j2objc_shorter_header_path
: "เท็จ" -
Whether to generate with shorter header path (uses "_ios" instead of "_j2objc").
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_java_classpath=<off, javabuilder or bazel>
: "javabuilder" - เปิดใช้เส้นทางคลาสที่ลดลงสำหรับการคอมไพล์ Java
--[no]experimental_limit_android_lint_to_android_constrained_java
ค่าเริ่มต้น: "false"-
จำกัด --experimental_run_android_lint_on_java_rules ไว้สำหรับไลบรารีที่เข้ากันได้กับ Android
แท็ก:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
ค่าเริ่มต้น: "false"-
กำหนดว่าจะตรวจสอบแหล่งที่มา java_* หรือไม่
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]explicit_java_test_deps
: "เท็จ" - ระบุการพึ่งพา JUnit หรือ Hamcrest ใน java_test อย่างชัดเจนแทนที่จะรับจาก deps ของ TestRunner โดยไม่ได้ตั้งใจ ตอนนี้ใช้ได้กับ bazel เท่านั้น
--[no]fetch
ค่าเริ่มต้น: "true"- อนุญาตให้คำสั่งดึงข้อมูลทรัพยากร Dependency ภายนอก หากตั้งค่าเป็นเท็จ คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ หากไม่มี คำสั่งจะดำเนินการไม่สำเร็จ
- ค่าเริ่มต้น
--host_java_launcher=<a build target label>
: ดูคำอธิบาย - Java Launcher ที่เครื่องมือใช้ซึ่งดำเนินการในระหว่างบิลด์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_javacopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมที่จะส่งไปยัง javac เมื่อสร้างเครื่องมือที่จะดำเนินการระหว่างการบิลด์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_jvmopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมที่จะส่งไปยัง Java VM เมื่อสร้างเครื่องมือที่จะดำเนินการระหว่างการบิลด์ ระบบจะเพิ่มตัวเลือกเหล่านี้ไปยังตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
--[no]incompatible_check_sharding_support
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" Bazel จะทดสอบแบบแยกกลุ่มไม่สำเร็จหากเครื่องมือรันทดสอบไม่ได้ระบุว่ารองรับการแยกกลุ่มโดยแตะไฟล์ที่เส้นทางใน TEST_SHARD_STATUS_FILE หากเป็นเท็จ ตัวดำเนินการทดสอบที่ไม่รองรับการชาร์ดจะนำไปยังการทดสอบทั้งหมดที่ทำงานในชาร์ดแต่ละรายการ
แท็ก:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
ค่าเริ่มต้น: "true"-
หากเป็นจริง การทดสอบพิเศษจะทำงานโดยใช้กลยุทธ์แซนด์บ็อกซ์ เพิ่มแท็ก "local" เพื่อบังคับให้ทำการทดสอบแบบพิเศษในเครื่อง
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_strict_action_env
: "เท็จ" -
หากเป็น "จริง" Bazel จะใช้สภาพแวดล้อมที่มีค่าแบบคงที่สำหรับ PATH และไม่รับค่า LD_LIBRARY_PATH ไป ใช้ --action_env=ENV_VARIABLE หากต้องการรับค่าตัวแปรสภาพแวดล้อมที่เฉพาะเจาะจงจากไคลเอ็นต์ แต่โปรดทราบว่าการดำเนินการนี้อาจป้องกันไม่ให้แคชข้ามผู้ใช้หากใช้แคชที่แชร์
แท็ก:loading_and_analysis
,incompatible_change
--j2objc_translation_flags=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ตัวเลือกเพิ่มเติมที่จะส่งไปยังเครื่องมือ J2ObjC
--java_debug
-
ทําให้เครื่องเสมือน Java ของการทดสอบ Java รอการเชื่อมต่อจากโปรแกรมแก้ไขข้อบกพร่องที่เป็นไปตามข้อกําหนดของ JDWP (เช่น jdb) ก่อนเริ่มการทดสอบ บอกเป็นนัยว่า -test_output=streamed
ขยายเป็น
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
ค่าเริ่มต้น: "true"- สร้างข้อมูลการพึ่งพา (ตอนนี้คือ classpath ขณะคอมไพล์) ต่อเป้าหมาย Java
--[no]java_header_compilation
ค่าเริ่มต้น: "true"- คอมไพล์ ijars จากแหล่งที่มาโดยตรง
--java_language_version=<a string>
ค่าเริ่มต้น: ""- เวอร์ชันภาษา Java
--java_launcher=<a build target label>
default: ดูคำอธิบาย- Java Launcher สำหรับใช้เมื่อสร้างไบนารีของ Java หากตั้งค่า Flag นี้เป็นสตริงว่าง ระบบจะใช้ตัวเปิด 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>
default: ดูคำอธิบาย- ระบุไบนารีที่จะใช้สร้างรายการคลาสที่ต้องอยู่ใน Dex หลักเมื่อคอมไพล์ MultiDex รุ่นเดิม
--optimizing_dexer=<a build target label>
default: ดูคำอธิบาย- ระบุไบนารีที่จะใช้เดกซ์โดยไม่ต้องชาร์ดดิ้ง
--package_path=<colon-separated list of options>
ค่าเริ่มต้น: "%workspace%"- รายการตำแหน่งที่จะค้นหาแพ็กเกจที่คั่นด้วยโคลอน องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับเวิร์กスペースที่ล้อมรอบ หากละเว้นหรือว่างเปล่า ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--plugin=<a build target label>
รายการ - ปลั๊กอินที่จะใช้ในบิลด์ ปัจจุบันใช้ได้กับ java_plugin
--proguard_top=<a build target label>
default: ดูคำอธิบาย- ระบุว่า ProGuard เวอร์ชันใดที่จะใช้สำหรับการนำโค้ดออกเมื่อสร้างไบนารีของ Java
--proto_compiler=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/proto:protoc"-
ป้ายกำกับของคอมไพเลอร์โปรโต
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/protocol:cc_toolchain"-
ป้ายกำกับของ protocol_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ C++ Proto
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ proto ของ j2objc
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/protocol:java_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์โปรโตคอล Java
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/proto:javalite_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์โปรโตคอล JavaLite
แท็ก:affects_outputs
,loading_and_analysis
--protocopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมสำหรับการส่งไปยังคอมไพเลอร์ Protocolbuf
แท็ก:affects_outputs
--[no]runs_per_test_detects_flakes
ค่าเริ่มต้น: "false"- หากเป็น "จริง" ข้อมูลพร็อพเพอร์ตี้ที่รัน/พยายามอย่างน้อย 1 ครั้งผ่านและรัน/พยายามอย่างน้อย 1 ครั้งไม่ผ่านจะได้รับสถานะ "ไม่เสถียร"
--shell_executable=<a path>
default: ดูคำอธิบาย-
เส้นทางสัมบูรณ์ไปยังเชลล์ปฏิบัติการสำหรับ Bazel เพื่อใช้งาน หากไม่ได้ตั้งค่านี้ แต่มีการตั้งค่าตัวแปรสภาพแวดล้อม BAZEL_SH ในการเรียกใช้ Bazel แรก (ซึ่งเริ่มต้นเซิร์ฟเวอร์ Bazel) Bazel จะใช้ตัวแปรนั้น หากไม่ได้ตั้งค่าไว้ Bazel จะใช้เส้นทางเริ่มต้นแบบฮาร์ดโค้ด โดยขึ้นอยู่กับระบบปฏิบัติการที่ใช้ (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, อื่นๆ ทั้งหมด: /bin/bash) โปรดทราบว่าการใช้เชลล์ที่เข้ากันไม่ได้กับ bash อาจทําให้การสร้างไม่สําเร็จหรือรันไทม์ของไบนารีที่สร้างขึ้นไม่สําเร็จ
แท็ก:loading_and_analysis
--[no]show_loading_progress
ค่าเริ่มต้น: "true"- หากเปิดใช้ จะทำให้ Bazel พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ:"
--test_arg=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ระบุตัวเลือกและอาร์กิวเมนต์เพิ่มเติมที่ควรส่งไปยังไฟล์ปฏิบัติการทดสอบ ใช้หลายครั้งเพื่อระบุอาร์กิวเมนต์หลายรายการได้ หากทำการทดสอบหลายรายการ แต่ละรายการจะได้รับอาร์กิวเมนต์ที่เหมือนกัน ใช้เฉพาะโดยคำสั่ง "การทดสอบ Bazel" เท่านั้น
- ค่าเริ่มต้น
--test_filter=<a string>
: ดูคำอธิบาย - ระบุตัวกรองที่จะส่งต่อไปยังเฟรมเวิร์กการทดสอบ ใช้เพื่อจำกัดการทดสอบ โปรดทราบว่าการดำเนินการนี้จะไม่ส่งผลต่อเป้าหมายที่สร้าง
- ค่าเริ่มต้นของ
--test_result_expiration=<an integer>
: "-1" - ตัวเลือกนี้เลิกใช้งานแล้วและไม่มีผล
--[no]test_runner_fail_fast
ค่าเริ่มต้น: "false"- ส่งต่อตัวเลือก "ดำเนินการทดสอบอย่างรวดเร็ว" ไปยังโปรแกรมรันทดสอบ โปรแกรมรันทดสอบควรหยุดการดําเนินการเมื่อเกิดความผิดพลาดครั้งแรก
- ค่าเริ่มต้น
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
: "อาจไม่เหมาะสม" - ระบุกลยุทธ์สำหรับการแยกกลุ่มทดสอบ: "explicit" เพื่อใช้การแยกกลุ่มเฉพาะในกรณีที่มีแอตทริบิวต์ BUILD "shard_count" เท่านั้น "disabled" เพื่อไม่ให้ใช้การแยกกลุ่มทดสอบ 'forced=k' เพื่อบังคับใช้กลุ่ม "k" สำหรับการทดสอบโดยไม่คำนึงถึงแอตทริบิวต์ BUILD "shard_count"
--tool_java_language_version=<a string>
ค่าเริ่มต้น: ""- เวอร์ชันภาษา Java ที่ใช้เพื่อเรียกใช้เครื่องมือที่จำเป็นระหว่างบิลด์
--tool_java_runtime_version=<a string>
ค่าเริ่มต้น: "remotejdk_11"- เวอร์ชันรันไทม์ Java ที่ใช้ในการเรียกใช้เครื่องมือระหว่างการสร้าง
--[no]use_ijars
ค่าเริ่มต้น: "true"- หากเปิดใช้ ตัวเลือกนี้จะทําให้คอมไพล์ Java ใช้ไฟล์ jar อินเทอร์เฟซ ซึ่งจะส่งผลให้การคอมไพล์แบบเพิ่มทีละน้อยเร็วขึ้น แต่ข้อความแสดงข้อผิดพลาดอาจแตกต่างกัน
ตัวเลือกความช่วยเหลือ
- ตัวเลือกที่ปรากฏก่อนคำสั่งและได้รับการแยกวิเคราะห์โดยไคลเอ็นต์
--distdir=<a path>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนที่จะเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บข้อมูลจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบในแคชแทนการคัดลอก การดำเนินการนี้มีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งที่พยายามลองอีกครั้งสูงสุดสำหรับข้อผิดพลาดในการดาวน์โหลด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองอีกครั้ง
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ด้วยปัจจัยนี้ วิธีนี้ช่วยให้รีโพซิทอรีภายนอกทํางานบนเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้น
--[no]incompatible_disable_native_repo_rules
: "เท็จ" -
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎของรีโปเนทีฟ ได้แก่ local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
default: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลรีโพซิทอรี่ภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช มิเช่นนั้นระบบจะใช้ค่าเริ่มต้นของ "<output_user_root>/cache/repos/v1"
แท็ก:bazel_internal_configuration
--[no]repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลพื้นที่เก็บข้อมูล โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้อย่างสมบูรณ์ ctx.execute อาจยังคงเรียกใช้ไฟล์ที่เรียกใช้งานได้แบบไม่จำกัดซึ่งเข้าถึงอินเทอร์เน็ตได้
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์มีดังนี้
- ค่าเริ่มต้น
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
เปอร์เซ็นต์ของพื้นที่เก็บข้อมูลแบบ Tenure ที่ใช้งานอยู่ (0-100) ซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์ความกดดันของหน่วยความจําเทียบกับขีดจํากัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะอนุญาตในกราฟดีเพนเดนซีที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่ามีการดึงออกในรีจิสทรีที่มาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิเช่นนั้น เวอร์ชันที่แยกออกมาจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันลบที่อนุญาตด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" ได้ด้วย คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็ก:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ" "off" เพื่อปิดใช้การตรวจสอบ หรือ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน
แท็ก:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่า Dependency ของ `bazel_dep` โดยตรงที่ประกาศไว้ในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟ Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ใช้ได้คือ "off" เพื่อปิดใช้การตรวจสอบ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน หรือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ"
แท็ก:loading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นข้อกำหนดในการพัฒนาเหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูท ไม่ว่าค่าของ Flag นี้จะเป็นอย่างไรก็ตาม
แท็ก:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
ค่าเริ่มต้น: "update"-
ระบุวิธีและระบุว่าจะใช้ไฟล์ล็อกหรือไม่ ค่าที่ถูกต้องคือ "อัปเดต" เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง "รีเฟรช" เพื่อรีเฟรชข้อมูลที่เปลี่ยนแปลงได้เพิ่มเติม (เวอร์ชันที่แยกออกมาและโมดูลที่หายไปก่อนหน้านี้) จากรีจิสทรีระยะไกลเป็นครั้งคราว "ข้อผิดพลาด" ในการใช้ไฟล์ล็อกแต่เกิดข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่อไม่อ่านหรือเขียนไปยังไฟล์ล็อก
แท็ก:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างโมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีทํางานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้านี้ออก
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--registry=<a string>
รายการ -
ระบุรีจิสทรีที่จะใช้ค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับมีความสำคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะเปลี่ยนไปใช้รีจิสทรีที่ใหม่กว่าก็ต่อเมื่อไม่มีโมดูลที่ต้องการในรีจิสทรีก่อนหน้า
แท็ก:changes_inputs
- ค่าเริ่มต้น
--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> โดยที่ระยะเวลาคือระยะเวลา และจํานวนเต็มเป็นจำนวนเต็มบวก หากมีการใช้งานพื้นที่ที่คงไว้ (ฮีป Gen เก่า) เกินกว่า --gc_thrashing_threshold เปอร์เซ็นต์ของพื้นที่ที่คงไว้ (ฮีปของ Gen เดิม) หลังจาก GC เต็ม <count> ตัวติดต่อกันภายใน <period> จะมีการทริกเกอร์ OOM คุณสามารถระบุขีดจํากัดหลายรายการโดยคั่นด้วยคอมมา
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC แบบเต็มขึ้น ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนครั้งต่อครั้งที่เรียกใช้ ค่าเริ่มต้นเป็น Integer.MAX_VALUE โดยไม่มีขีดจำกัด 0 หมายความว่าเหตุการณ์ GC แบบสมบูรณ์จะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC แบบเต็มและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้ฮีปที่เก็บรักษาไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อมีเหตุการณ์ GC ที่ไม่ร้ายแรงเกิดขึ้น ระบบจะยกเลิกสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นออกไปจนถึงหลายครั้งต่อการเรียกใช้ ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด 0 หมายความว่าเหตุการณ์ GC เล็กน้อยจะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC ย่อยและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
แฟล็กสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์กองที่เก็บไว้อย่างน้อยถึงเกณฑ์นี้ ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็น การปรับแต่งค่านี้อาจช่วยลดผลกระทบต่อเวลาจริงของการกระหน่ำ GC เมื่อการกระหน่ำ GC (1) เกิดจากการใช้งานหน่วยความจําของสถานะชั่วคราวนี้ และ (2) เสียค่าใช้จ่ายมากกว่าการสร้างสถานะใหม่เมื่อจําเป็น
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ส่งผลต่อรายละเอียด รูปแบบ หรือตำแหน่งของการบันทึก
--experimental_command_profile=<cpu, wall, alloc or lock>
default: ดูคำอธิบาย- บันทึกโปรไฟล์ Java Flight Recorder ตลอดระยะเวลาของคำสั่ง คุณต้องระบุประเภทเหตุการณ์โปรไฟล์ที่รองรับ (cpu, wall, alloc หรือ lock) รายการใดรายการหนึ่งเป็นอาร์กิวเมนต์ ระบบจะเขียนโปรไฟล์ลงในไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ในไดเรกทอรีฐานเอาต์พุต ไวยากรณ์และความหมายของแฟล็กนี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับประเภทโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม คุณต้องยอมรับความเสี่ยงที่เกิดขึ้นเอง
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจํากัดไว้ที่คําช่วยจํา 20 รายการที่มีการดําเนินการมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับคําช่วยจําทั้งหมด
- ค่าเริ่มต้น
--help_verbosity=<long, medium or short>
: "ปานกลาง" -
เลือกรายละเอียดของคำสั่งความช่วยเหลือ
แท็ก:affects_outputs
,terminal_output
--long
[-l
]-
แสดงคำอธิบายแบบเต็มของตัวเลือกแต่ละรายการแทนที่จะแสดงเฉพาะชื่อ
ขยายเป็น
--help_verbosity=long
แท็ก:affects_outputs
,terminal_output
--short
-
แสดงเฉพาะชื่อของตัวเลือก โดยไม่แสดงประเภทหรือความหมาย
ขยายเป็น
--help_verbosity=short
แท็ก:affects_outputs
,terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่ได้อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ใช่ค่าว่าง ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการระยะไกล
--experimental_downloader_config=<a string>
default: ดูคำอธิบาย- ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดจากระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะขึ้นต้นด้วยคําสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สําหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ โดยรูปแบบหนึ่งใช้เพื่อจับคู่และอีกรูปแบบหนึ่งใช้แทน URL โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณอาจระบุคําสั่ง `rewrite` หลายรายการสําหรับ URL เดียวกันได้ ซึ่งในกรณีนี้ระบบจะแสดงผล URL หลายรายการ
- ค่าเริ่มต้น
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "อัตโนมัติ" - โหมดการแยกชุดข้อความที่จะใช้ดึงข้อมูลรีโป หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท ไม่เช่นนั้นจะใช้เธรดผู้ทํางานเสมือน
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
--override_repository=<an equals-separated mapping of repository name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้าออก
ตัวเลือกข้อมูล
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคําสั่งและได้รับการแยกวิเคราะห์โดยไคลเอ็นต์
--distdir=<a path>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บข้อมูลจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบในแคชแทนการคัดลอก การดำเนินการนี้มีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งที่พยายามลองอีกครั้งสูงสุดสำหรับข้อผิดพลาดในการดาวน์โหลด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองอีกครั้ง
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับเวลาหมดอายุทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ช่วยให้รีโพซิทอรีภายนอกทํางานบนเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
ค่าเริ่มต้น: "false"-
หากเป็น "เท็จ" คุณจะใช้กฎที่เก็บแบบเนทีฟใน WORKSPACE ได้ ไม่เช่นนั้นต้องใช้กฎที่เก็บของ Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูคำอธิบาย -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลรีโพซิทอรี่ภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดแคช มิเช่นนั้นจะใช้ค่าเริ่มต้น "<output_user_root>/cache/repos/v1"
แท็ก:bazel_internal_configuration
--[no]repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลพื้นที่เก็บข้อมูล โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้อย่างสมบูรณ์ ctx.execute อาจยังคงเรียกใช้ไฟล์ที่เรียกใช้งานได้แบบกำหนดเองซึ่งเข้าถึงอินเทอร์เน็ตได้
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
--gc_thrashing_threshold=<an integer in 0-100 range>
ค่าเริ่มต้น: "100"-
เปอร์เซ็นต์ของพื้นที่เก็บข้อมูลแบบ Tenure ที่ใช้งานอยู่ (0-100) ซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์ความกดดันของหน่วยความจําเทียบกับขีดจํากัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะอนุญาตในกราฟ Dependency ที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่ามีการดึงออกในรีจิสทรีที่มาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น การดึงเวอร์ชันออกจะทำให้การแก้ไขไม่สำเร็จ นอกจากนี้ คุณยังกำหนดเวอร์ชันที่ดึงออกได้โดยใช้ตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็ก:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ" "off" เพื่อปิดใช้การตรวจสอบ หรือ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน
แท็ก:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่า Dependency ของ `bazel_dep` โดยตรงที่ประกาศไว้ในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟ Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดการตรวจสอบ "คำเตือน" ให้พิมพ์คำเตือนเมื่อตรวจพบข้อมูลที่ไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อยกระดับการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นข้อกำหนดในการพัฒนาเหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูท ไม่ว่าค่าของ Flag นี้จะเป็นอย่างไรก็ตาม
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--lockfile_mode=<off, update, refresh or error>
: "อัปเดต" -
ระบุวิธีและระบุว่าจะใช้ไฟล์ล็อกหรือไม่ ค่าที่ถูกต้องคือ "อัปเดต" เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง "รีเฟรช" เพื่อรีเฟรชข้อมูลที่เปลี่ยนแปลงได้เพิ่มเติม (เวอร์ชันที่แยกออกมาและโมดูลที่หายไปก่อนหน้านี้) จากรีจิสทรีระยะไกลเป็นครั้งคราว "ข้อผิดพลาด" ในการใช้ไฟล์ล็อกแต่เกิดข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่อไม่อ่านหรือเขียนไปยังไฟล์ล็อก
แท็ก:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างโมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีทํางานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้าออก
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--registry=<a string>
รายการ -
ระบุรีจิสทรีที่จะใช้ในการค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับเป็นสิ่งสำคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีในภายหลังเมื่อไม่มีรีจิสทรีที่ขาดหายไป
แท็ก:changes_inputs
--vendor_dir=<a path>
default: ดูคำอธิบาย-
ระบุไดเรกทอรีที่ควรเก็บที่เก็บข้อมูลภายนอกในโหมดผู้ให้บริการ ไม่ว่าจะเป็นเพื่อดึงข้อมูลมายังไดเรกทอรีดังกล่าวหรือใช้ขณะสร้าง เส้นทางอาจเป็นเส้นทางแบบสัมบูรณ์หรือเส้นทางแบบสัมพัทธ์กับไดเรกทอรีของพื้นที่ทำงานก็ได้
แท็ก:loading_and_analysis
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพของเวลาสร้างมีดังนี้
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
ค่าเริ่มต้น: "1s:2,20s:3,1m:5"-
ขีดจํากัดที่หากถึงแล้วจะทำให้ GcThrashingDetector ทำให้ Bazel ขัดข้องด้วย OOM โดยระบุขีดจํากัดแต่ละรายการเป็น <period>:<count> โดยที่ period คือระยะเวลา และ count คือจํานวนเต็มบวก หากมีการใช้งานพื้นที่ที่คงไว้ (ฮีป Gen เก่า) เกินกว่า --gc_thrashing_threshold เปอร์เซ็นต์ของพื้นที่ที่คงไว้ (ฮีป Gen เดิม) หลังจาก GC เต็ม <count> ตัวติดต่อกันภายใน <period> จะมีการทริกเกอร์ OOM คุณสามารถระบุขีดจํากัดหลายรายการโดยคั่นด้วยคอมมา
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้ฮีปที่เก็บรักษาไว้เกินเกณฑ์ที่ --skyframe_high_water_mark_threshold กำหนด เมื่อเกิดเหตุการณ์ GC เต็มรูปแบบเกิดขึ้น สถานะของ Skyframe ชั่วคราวจะถูกตัดทิ้งโดยไม่จำเป็นจนถึงจำนวนครั้งดังกล่าวต่อการเรียกใช้หลายครั้ง ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด ศูนย์หมายความว่าเหตุการณ์ GC ทั้งหมดจะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC แบบเต็มและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC เล็กน้อย ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนนี้ต่อการเรียกใช้แต่ละครั้ง ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด 0 หมายความว่าเหตุการณ์ GC เล็กน้อยจะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC ย่อยขึ้นและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
แฟล็กสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์กองที่เก็บไว้อย่างน้อยถึงเกณฑ์นี้ ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็น การปรับแต่งค่านี้อาจช่วยลดผลกระทบต่อเวลาจริงของการกระหน่ำ GC เมื่อการกระหน่ำ GC (1) เกิดจากการใช้งานหน่วยความจําของสถานะชั่วคราวนี้ และ (2) เสียค่าใช้จ่ายมากกว่าการสร้างสถานะใหม่เมื่อจําเป็น
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ส่งผลต่อรายละเอียด รูปแบบ หรือตำแหน่งของการบันทึก
--experimental_command_profile=<cpu, wall, alloc or lock>
default: ดูคำอธิบาย- บันทึกโปรไฟล์ Java Flight Recorder ตลอดระยะเวลาของคำสั่ง คุณต้องระบุประเภทเหตุการณ์โปรไฟล์ที่รองรับ (cpu, wall, alloc หรือ lock) รายการใดรายการหนึ่งเป็นอาร์กิวเมนต์ ระบบจะเขียนโปรไฟล์ลงในไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ในไดเรกทอรีฐานเอาต์พุต ไวยากรณ์และความหมายของแฟล็กนี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับประเภทโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม คุณต้องยอมรับความเสี่ยงที่เกิดขึ้นเอง
- ค่าเริ่มต้น
--[no]experimental_record_metrics_for_all_mnemonics
: "เท็จ" - โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจํากัดไว้ที่คําช่วยจํา 20 รายการที่มีการดําเนินการมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับคําช่วยจําทั้งหมด
- ค่าเริ่มต้น
--[no]show_make_env
: "เท็จ" -
รวมสภาพแวดล้อม "Make" ไว้ในเอาต์พุต
แท็ก:affects_outputs
,terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ค่าเริ่มต้น
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
หากไม่ใช่ค่าว่าง ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการระยะไกล
- ค่าเริ่มต้น
--experimental_downloader_config=<a string>
: ดูคำอธิบาย - ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดจากระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะขึ้นต้นด้วยคําสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สําหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ โดยรูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้แทน URL โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณอาจระบุคําสั่ง `rewrite` หลายรายการสําหรับ URL เดียวกันได้ ซึ่งในกรณีนี้ระบบจะแสดงผล URL หลายรายการ
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
ค่าเริ่มต้น: "auto"- โหมดการแยกชุดข้อความที่จะใช้ดึงข้อมูลรีโป หากตั้งค่าเป็น "ปิด" ระบบจะไม่ใช้เธรดสำหรับงานและการดึงข้อมูลรีโปจะขึ้นอยู่กับการรีสตาร์ท ไม่เช่นนั้น ให้ใช้เทรดผู้ปฏิบัติงานเสมือน
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
--override_repository=<an equals-separated mapping of repository name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์จะถูกนำมาใช้ตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ เส้นทางดังกล่าวจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" แสดงว่าสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel" หากเส้นทางที่ระบุว่างเปล่า ให้นำการลบล้างก่อนหน้าออก
ตัวเลือกใบอนุญาต
- ตัวเลือกที่ปรากฏก่อนคําสั่งและได้รับการแยกวิเคราะห์โดยไคลเอ็นต์
--distdir=<a path>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนที่จะเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากมีการตั้งค่า แคชของที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่เกิดแคชแทนที่จะคัดลอก การดำเนินการนี้มีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งที่พยายามลองอีกครั้งสูงสุดสำหรับข้อผิดพลาดในการดาวน์โหลด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองอีกครั้ง
แท็ก:experimental
- ค่าเริ่มต้น
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับเวลาหมดอายุทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ช่วยให้รีโพซิทอรีภายนอกทํางานบนเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
ค่าเริ่มต้น: "false"-
หากเป็นเท็จ จะใช้กฎของรีโปเดิมใน WORKSPACE ได้ หากเป็นจริง ต้องใช้กฎของรีโป Starlark แทน กฎของรีโปเนทีฟ ได้แก่ local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
default: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลรีโพซิทอรี่ภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช มิเช่นนั้นระบบจะใช้ค่าเริ่มต้นของ "<output_user_root>/cache/repos/v1"
แท็ก:bazel_internal_configuration
--[no]repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลพื้นที่เก็บข้อมูล โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้อย่างสมบูรณ์ ctx.execute อาจยังคงเรียกใช้ไฟล์ที่เรียกใช้งานได้แบบกำหนดเองซึ่งเข้าถึงอินเทอร์เน็ตได้
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
--gc_thrashing_threshold=<an integer in 0-100 range>
ค่าเริ่มต้น: "100"-
เปอร์เซ็นต์ของพื้นที่เก็บข้อมูลแบบ Tenure ที่ใช้งานอยู่ (0-100) ซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์ความกดดันของหน่วยความจำเทียบกับขีดจํากัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุเวอร์ชันโมดูลในรูปแบบ "<module1>@<version1>,<module2>@<version2>" ซึ่งจะอนุญาตในกราฟทรัพยากร Dependency ที่ได้รับการแก้ไขแล้ว แม้ว่าจะประกาศเวอร์ชันในรีจิสทรีในรีจิสทรีซึ่งเป็นที่มาก็ตาม (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น การดึงเวอร์ชันออกจะทำให้การแก้ไขไม่สำเร็จ นอกจากนี้ คุณยังกำหนดเวอร์ชันที่ดึงออกได้โดยใช้ตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ" "off" เพื่อปิดใช้การตรวจสอบ หรือ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน
แท็ก:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่า Dependency ของ `bazel_dep` โดยตรงที่ประกาศไว้ในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟ Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ใช้ได้คือ "off" เพื่อปิดใช้การตรวจสอบ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน หรือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ"
แท็ก:loading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะไม่สนใจทรัพยากร Dependency สำหรับนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูทไม่ว่าค่าของแฟล็กนี้จะเป็นอะไร
แท็ก:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
ค่าเริ่มต้น: "update"-
ระบุวิธีและระบุว่าจะใช้ไฟล์ล็อกหรือไม่ ค่าที่ถูกต้องคือ "อัปเดต" เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง "รีเฟรช" เพื่อรีเฟรชข้อมูลที่เปลี่ยนแปลงได้เพิ่มเติม (เวอร์ชันที่แยกออกมาและโมดูลที่หายไปก่อนหน้านี้) จากรีจิสทรีระยะไกลเป็นครั้งคราว "ข้อผิดพลาด" ในการใช้ไฟล์ล็อกแต่เกิดข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่อไม่อ่านหรือเขียนไปยังไฟล์ล็อก
แท็ก:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างโมดูลด้วยเส้นทางภายในในรูปแบบ <module name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์ ระบบจะใช้เส้นทางตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ เส้นทางดังกล่าวจะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้าออก
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--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> โดยที่ period คือระยะเวลา และ count คือจํานวนเต็มบวก หากมีการใช้พื้นที่ที่มีการจัดสรรไว้ (ฮีปรุ่นเก่า) มากกว่า --gc_thrashing_threshold เปอร์เซ็นต์หลังจากการเรียกใช้ GC แบบเต็มติดต่อกัน <count> ครั้งภายใน <period> ระบบจะเรียกใช้ OOM คุณสามารถระบุขีดจํากัดหลายรายการโดยคั่นด้วยคอมมา
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
แฟล็กสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้ฮีปที่เก็บรักษาไว้เกินเกณฑ์ที่ --skyframe_high_water_mark_threshold กำหนด เมื่อเกิดเหตุการณ์ GC เต็มรูปแบบเกิดขึ้น สถานะของ Skyframe ชั่วคราวจะถูกตัดทิ้งโดยไม่จำเป็นจนถึงจำนวนครั้งดังกล่าวต่อการเรียกใช้หลายครั้ง ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด 0 หมายความว่าเหตุการณ์ GC แบบสมบูรณ์จะไม่ทริกเกอร์การลดลง หากถึงขีดจำกัด สถานะ Skyframe จะไม่ลดลงอีกต่อไปเมื่อเกิดเหตุการณ์ GC เต็มรูปแบบและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC เล็กน้อย ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนนี้ต่อการเรียกใช้แต่ละครั้ง ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด 0 หมายความว่าเหตุการณ์ GC เล็กน้อยจะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC เล็กน้อยและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานฮีปที่สะสมไว้ถึงเกณฑ์นี้เป็นอย่างน้อย ก็จะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็น การปรับแต่งค่านี้อาจช่วยลดผลกระทบต่อเวลาจริงของการกระหน่ำ GC เมื่อการกระหน่ำ GC (1) เกิดจากการใช้งานหน่วยความจําของสถานะชั่วคราวนี้ และ (2) เสียค่าใช้จ่ายมากกว่าการสร้างสถานะใหม่เมื่อจําเป็น
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ส่งผลต่อรายละเอียด รูปแบบ หรือตำแหน่งของการบันทึก
--experimental_command_profile=<cpu, wall, alloc or lock>
default: ดูคำอธิบาย- บันทึกโปรไฟล์ Java Flight Recorder ตลอดระยะเวลาของคำสั่ง คุณต้องระบุประเภทเหตุการณ์โปรไฟล์ที่รองรับ (cpu, wall, alloc หรือ lock) รายการใดรายการหนึ่งเป็นอาร์กิวเมนต์ ระบบจะเขียนโปรไฟล์ลงในไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ในไดเรกทอรีฐานเอาต์พุต รูปแบบคำสั่งและความหมายของแฟล็กนี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับประเภทโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม โปรดใช้โดยยอมรับความเสี่ยงเอง
- ค่าเริ่มต้น
--[no]experimental_record_metrics_for_all_mnemonics
: "เท็จ" - โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจำกัดอยู่ที่ 20 รายการที่มีการกระทำมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับคําช่วยจําทั้งหมด
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ใช่ค่าว่าง ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการระยะไกล
- ค่าเริ่มต้น
--experimental_downloader_config=<a string>
: ดูคำอธิบาย - ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดจากระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด แต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือสองรูปแบบ รูปแบบหนึ่งจะจับคู่กัน และอีกรูปแบบหนึ่งใช้เป็น URL ทดแทน โดยมีการอ้างอิงกลับที่เริ่มต้นจาก "$1" ซึ่งระบบอาจส่งคืนคำสั่ง "rewrite" ให้กับ URL เดียวกันหลายครั้ง
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
ค่าเริ่มต้น: "auto"- โหมดการแยกชุดข้อความที่จะใช้ดึงข้อมูลรีโป หากตั้งค่าเป็น "ปิด" ระบบจะไม่ใช้เธรดสำหรับงานและการดึงข้อมูลรีโปจะขึ้นอยู่กับการรีสตาร์ท ไม่เช่นนั้น ให้ใช้เทรดผู้ปฏิบัติงานเสมือน
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้
--override_repository=<an equals-separated mapping of repository name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้าออก
ตัวเลือกการติดตั้งบนอุปกรณ์เคลื่อนที่
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคําสั่งและได้รับการแยกวิเคราะห์โดยไคลเอ็นต์
--distdir=<a path>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนที่จะเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากตั้งค่าไว้ แคชที่เก็บข้อมูลจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบในแคชแทนการคัดลอก ซึ่งช่วยประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งที่พยายามลองอีกครั้งสูงสุดสำหรับข้อผิดพลาดในการดาวน์โหลด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองอีกครั้ง
แท็ก:experimental
- ค่าเริ่มต้น
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับเวลาหมดอายุทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
ค่าเริ่มต้น: "false"-
หากเป็นเท็จ จะใช้กฎของรีโปเดิมใน WORKSPACE ได้ หากเป็นจริง ต้องใช้กฎของรีโป Starlark แทน กฎของรีโปเนทีฟ ได้แก่ local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูคำอธิบาย -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลรีโพซิทอรี่ภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช มิเช่นนั้นระบบจะใช้ค่าเริ่มต้นของ "<output_user_root>/cache/repos/v1"
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]repository_disable_download
: "เท็จ" -
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลที่เก็บ โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้อย่างสมบูรณ์ ctx.execute อาจยังคงเรียกใช้ไฟล์ที่เรียกใช้งานได้แบบกำหนดเองซึ่งเข้าถึงอินเทอร์เน็ตได้
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
- ค่าเริ่มต้น
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
เปอร์เซ็นต์ของพื้นที่เก็บข้อมูลแบบ Tenure ที่ใช้งานอยู่ (0-100) ซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์ความกดดันของหน่วยความจําเทียบกับขีดจํากัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก:host_machine_resource_optimizations
--mode=<classic, classic_internal_test_do_not_use or skylark>
ค่าเริ่มต้น: "classic"-
เลือกวิธีเรียกใช้การติดตั้งบนอุปกรณ์เคลื่อนที่ "classic" เรียกใช้ mobile-install เวอร์ชันปัจจุบัน "skylark" ใช้ Starlark เวอร์ชันใหม่ซึ่งรองรับ android_test
แท็ก:loading_and_analysis
,execution
,incompatible_change
- ตัวเลือกในการกำหนดค่า Toolchain ที่ใช้สำหรับการดำเนินการมีดังนี้
--adb=<a string>
ค่าเริ่มต้น: ""-
ไบนารี adb ที่จะใช้สำหรับคำสั่ง "mobile-install" หากไม่ระบุ ระบบจะใช้ SDK ใน Android SDK ที่ระบุโดยตัวเลือกบรรทัดคำสั่ง --android_sdk (หรือ SDK เริ่มต้นหากไม่ได้ระบุ --android_sdk)
แท็ก:changes_inputs
- ตัวเลือกที่ควบคุมเอาต์พุตของคําสั่ง
--[no]incremental
ค่าเริ่มต้น: "false"-
ต้องการติดตั้งแบบเพิ่มหรือไม่ หากเป็น "จริง" ให้พยายามหลีกเลี่ยงการทำงานเพิ่มเติมที่ไม่จำเป็นโดยการอ่านสถานะของอุปกรณ์ที่จะติดตั้งโค้ดและใช้ข้อมูลดังกล่าวเพื่อหลีกเลี่ยงการทำงานที่ไม่จำเป็น หากเป็นเท็จ (ค่าเริ่มต้น) ให้ทำการติดตั้งแบบเต็มเสมอ
แท็ก: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>
ค่าเริ่มต้น: "ไม่"-
วิธีเริ่มแอปหลังจากติดตั้ง ตั้งค่าเป็น WARM เพื่อเก็บรักษาและคืนค่าสถานะแอปพลิเคชันในการติดตั้งที่เพิ่มขึ้น
แท็ก:execution
--start_app
-
ไม่ว่าจะเริ่มแอปหลังจากติดตั้งหรือไม่
ขยายเป็น
--start=COLD
แท็ก:execution
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันโมดูลในรูปแบบ "<module1>@<version1>,<module2>@<version2>" ซึ่งจะอนุญาตในกราฟทรัพยากร Dependency ที่ได้รับการแก้ไขแล้ว แม้ว่าจะประกาศเวอร์ชันในรีจิสทรีในรีจิสทรีซึ่งเป็นที่มาก็ตาม (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น การดึงเวอร์ชันออกจะทำให้การแก้ไขไม่สำเร็จ นอกจากนี้ คุณยังกำหนดเวอร์ชันที่ดึงออกได้โดยใช้ตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็ก:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ" "off" เพื่อปิดใช้การตรวจสอบ หรือ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน
แท็ก:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าทรัพยากร 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>
ค่าเริ่มต้น: "update"-
ระบุวิธีและระบุว่าจะใช้ไฟล์ล็อกหรือไม่ ค่าที่ถูกต้องคือ "อัปเดต" เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง "รีเฟรช" เพื่อรีเฟรชข้อมูลที่เปลี่ยนแปลงได้เพิ่มเติม (เวอร์ชันที่แยกออกมาและโมดูลที่หายไปก่อนหน้านี้) จากรีจิสทรีระยะไกลเป็นครั้งคราว "ข้อผิดพลาด" ในการใช้ไฟล์ล็อกแต่เกิดข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่อไม่อ่านหรือเขียนไปยังไฟล์ล็อก
แท็ก:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างโมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีทํางานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้าออก
--registry=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้ค้นหาทรัพยากร Dependency ของโมดูล Bazel ลําดับมีความสําคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะเปลี่ยนไปใช้รีจิสทรีที่ใหม่กว่าก็ต่อเมื่อไม่มีโมดูลที่ต้องการในรีจิสทรีก่อนหน้า
แท็ก:changes_inputs
- ค่าเริ่มต้น
--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> โดยที่ period คือระยะเวลา และ count คือจํานวนเต็มบวก หากมีการใช้พื้นที่ที่มีการจัดสรรไว้ (ฮีปรุ่นเก่า) มากกว่า --gc_thrashing_threshold เปอร์เซ็นต์หลังจากการเรียกใช้ GC แบบเต็มติดต่อกัน <count> ครั้งภายใน <period> ระบบจะเรียกใช้ OOM คุณสามารถระบุขีดจํากัดหลายรายการโดยคั่นด้วยคอมมา
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
แฟล็กสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC แบบเต็มขึ้น ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนครั้งต่อแต่ละครั้งที่เรียกใช้ ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด ศูนย์หมายความว่าเหตุการณ์ GC ทั้งหมดจะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC แบบเต็มและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC เล็กน้อย ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนนี้ต่อการเรียกใช้แต่ละครั้ง ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด 0 หมายความว่าเหตุการณ์ GC เล็กน้อยจะไม่ทริกเกอร์การลดลง หากถึงขีดจำกัด สถานะ Skyframe จะไม่ลดลงอีกต่อไปเมื่อเกิดเหตุการณ์ GC ที่ไม่ร้ายแรงและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์กองที่เก็บไว้อย่างน้อยถึงเกณฑ์นี้ ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็น การปรับแต่งค่านี้อาจช่วยลดผลกระทบต่อเวลาจริงของการกระหน่ำ GC เมื่อการกระหน่ำ GC (1) เกิดจากการใช้งานหน่วยความจําของสถานะชั่วคราวนี้ และ (2) เสียค่าใช้จ่ายมากกว่าการสร้างสถานะใหม่เมื่อจําเป็น
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ส่งผลต่อรายละเอียด รูปแบบ หรือตำแหน่งของการบันทึก
- ค่าเริ่มต้น
--experimental_command_profile=<cpu, wall, alloc or lock>
: ดูคำอธิบาย - บันทึกโปรไฟล์ Java Flight Recorder ตลอดระยะเวลาของคำสั่ง คุณต้องระบุประเภทเหตุการณ์โปรไฟล์ที่รองรับ (cpu, wall, alloc หรือ lock) รายการใดรายการหนึ่งเป็นอาร์กิวเมนต์ โปรไฟล์จะเขียนไปยังไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ภายใต้ไดเรกทอรีฐานเอาต์พุต ไวยากรณ์และความหมายของแฟล็กนี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับประเภทโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม คุณต้องยอมรับความเสี่ยงที่เกิดขึ้นเอง
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจํากัดไว้ที่คําช่วยจํา 20 รายการที่มีการดําเนินการมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับคําช่วยจําทั้งหมด
--incremental_install_verbosity=<a string>
ค่าเริ่มต้น: ""-
การพูดรายละเอียดสำหรับการติดตั้งที่เพิ่มขึ้น ตั้งค่าเป็น 1 สำหรับการบันทึกการแก้ไขข้อบกพร่อง
แท็ก:bazel_monitoring
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ค่าเริ่มต้นของ
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
หากไม่ใช่ค่าว่าง ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการระยะไกล
- ค่าเริ่มต้น
--experimental_downloader_config=<a string>
: ดูคำอธิบาย - ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดจากระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด แต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือสองรูปแบบ รูปแบบหนึ่งจะใช้ตรงกัน และอีกรูปแบบหนึ่งใช้เป็น URL ทดแทน โดยมีการอ้างอิงกลับที่เริ่มต้นจาก "$1" ซึ่งระบบอาจส่งคืนคำสั่ง "rewrite" หลายครั้งสำหรับ URL เดียวกัน
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
ค่าเริ่มต้น: "auto"- โหมดการแยกชุดข้อความที่ใช้สำหรับการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" ระบบจะไม่ใช้เธรดสำหรับงานและการดึงข้อมูลรีโปจะขึ้นอยู่กับการรีสตาร์ท ไม่เช่นนั้นจะใช้เธรดผู้ทํางานเสมือน
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้
--override_repository=<an equals-separated mapping of repository name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างที่เก็บโดยใช้เส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้าออก
ตัวเลือกม็อด
- ตัวเลือกที่ปรากฏก่อนคําสั่งและได้รับการแยกวิเคราะห์โดยไคลเอ็นต์
--distdir=<a path>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนที่จะเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากมีการตั้งค่า แคชของที่เก็บจะลิงก์ไฟล์แบบถาวรในกรณีที่มีการเกิดแคชแทนที่จะคัดลอก การดำเนินการนี้มีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองดาวน์โหลดข้อผิดพลาดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองอีกครั้ง
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับเวลาหมดอายุทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ช่วยให้รีโพซิทอรีภายนอกทํางานบนเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
ค่าเริ่มต้น: "false"-
หากเป็นเท็จ จะใช้กฎของรีโปเดิมใน WORKSPACE ได้ หากเป็นจริง ต้องใช้กฎของรีโป Starlark แทน กฎของรีโปเนทีฟ ได้แก่ local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
default: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลรีโพซิทอรี่ภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช มิเช่นนั้นระบบจะใช้ค่าเริ่มต้นของ "<output_user_root>/cache/repos/v1"
แท็ก:bazel_internal_configuration
--[no]repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลพื้นที่เก็บข้อมูล โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้อย่างสมบูรณ์ ctx.execute อาจยังคงเรียกใช้ไฟล์ที่เรียกใช้งานได้แบบกำหนดเองซึ่งเข้าถึงอินเทอร์เน็ตได้
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
--gc_thrashing_threshold=<an integer in 0-100 range>
ค่าเริ่มต้น: "100"-
เปอร์เซ็นต์ของพื้นที่เช่า (0-100) ข้างต้นซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์แรงดันหน่วยความจำเทียบกับขีดจำกัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก:host_machine_resource_optimizations
--[no]keep_going
[-k
] default: "false"-
ดำเนินการต่อให้มากที่สุดหลังจากเกิดข้อผิดพลาด แม้ว่าจะวิเคราะห์เป้าหมายที่ไม่สําเร็จและเป้าหมายที่ขึ้นอยู่กับเป้าหมายนั้นไม่ได้ แต่ระบบจะวิเคราะห์ข้อกําหนดเบื้องต้นอื่นๆ ของเป้าหมายเหล่านี้ได้
แท็ก:eagerness_to_exit
- ค่าเริ่มต้น
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "อัตโนมัติ" -
จํานวนเธรดแบบขนานที่จะใช้สําหรับระยะการโหลด/การวิเคราะห์ ใช้จํานวนเต็มหรือคีย์เวิร์ด ("auto", "HOST_CPUS", "HOST_RAM") ตามด้วยการดำเนินการ ([-|*]<float>) ตามต้องการ เช่น "auto", "HOST_CPUS*.5" "auto" จะตั้งค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก:bazel_internal_configuration
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ API การสร้างที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
--[no]incompatible_config_setting_private_default_visibility
ค่าเริ่มต้น: "false"-
หาก incompatible_enforce_config_setting_visibility=false จะไม่มีการดำเนินการใดๆ หรือหาก Flag นี้เป็นเท็จ config_setting ที่ไม่มีแอตทริบิวต์ระดับการมองเห็นที่ชัดเจนจะเป็น //visibility:public หาก Flag นี้เป็น "จริง" config_setting จะใช้ตรรกะการแสดงผลเดียวกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_enforce_config_setting_visibility
: "true" -
หากเป็น "จริง" ระบบจะบังคับใช้ข้อจำกัดการแสดงผลของ config_setting หากเป็น "เท็จ" ทุก config_setting จะปรากฏแก่เป้าหมายทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของคำสั่งย่อย "mod"
- ค่าเริ่มต้น
--base_module=<"<root>" for the root module; <module>@<version> for a specific version of a module; <module> for all versions of a module; @<name> for a repo with the given apparent name; or @@<name> for a repo with the given canonical name>
: "<root>" -
ระบุโมดูลที่เกี่ยวข้องกับการตีความที่เก็บเป้าหมายที่ระบุ
แท็ก:terminal_output
--charset=<utf8 or ascii>
ค่าเริ่มต้น: "utf8"-
เลือกชุดอักขระที่จะใช้สำหรับโครงสร้างต้นไม้ มีผลต่อเอาต์พุตข้อความเท่านั้น ค่าที่ใช้ได้คือ "utf8" หรือ "ascii" ค่าเริ่มต้นคือ "utf8"
แท็ก:terminal_output
--[no]cycles
ค่าเริ่มต้น: "false"-
ชี้ให้เห็นวงจรการพึ่งพาภายในแผนภูมิที่แสดง ซึ่งโดยปกติระบบจะละเว้น
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--depth=<an integer>
: "-1" -
ความลึกสูงสุดในการแสดงแผนผังความเกี่ยวข้อง เช่น ความลึก 1 จะแสดงรายการที่ขึ้นต่อกันโดยตรง สำหรับ tree, path และ all_paths ค่าเริ่มต้นคือ Integer.MAX_VALUE ส่วนสำหรับ deps และ explain ค่าเริ่มต้นคือ 1 (แสดงเฉพาะ deps โดยตรงของรูทนอกเหนือจากใบเป้าหมายและรูทของใบนั้นๆ)
แท็ก:terminal_output
- ค่าเริ่มต้น
--extension_filter=<a comma-separated list of <extension>s>
: ดูคำอธิบาย -
แสดงเฉพาะการใช้งานส่วนขยายโมดูลเหล่านี้และที่เก็บที่สร้างขึ้นหากมีการตั้งค่า Flag ที่เกี่ยวข้องไว้ หากตั้งค่าไว้ กราฟผลลัพธ์จะรวมเฉพาะเส้นทางที่มีโมดูลที่ใช้ส่วนขยายที่ระบุ รายการว่างจะปิดใช้ตัวกรอง ซึ่งจะระบุส่วนขยายที่เป็นไปได้ทั้งหมดได้อย่างมีประสิทธิภาพ
แท็ก:terminal_output
--extension_info=<hidden, usages, repos or all>
ค่าเริ่มต้น: "hidden"-
ระบุรายละเอียดเกี่ยวกับการใช้งานส่วนขยายที่จะรวมไว้ในผลการค้นหา "การใช้งาน" จะแสดงเฉพาะชื่อส่วนขยาย ส่วน "ที่เก็บ" จะรวมที่เก็บที่นำเข้าด้วย use_repo ด้วย และ "ทั้งหมด" จะแสดงที่เก็บอื่นๆ ที่ส่วนขยายสร้างขึ้นด้วย
แท็ก:terminal_output
- ค่าเริ่มต้น
--extension_usages=<a comma-separated list of <module>s>
: "" -
ระบุโมดูลที่การใช้งานส่วนขยายจะแสดงในการค้นหา show_extension
แท็ก:terminal_output
--from=<a comma-separated list of <module>s>
ค่าเริ่มต้น: "<root>"-
โมดูลที่เริ่มต้นจากการค้นหากราฟทรัพยากร Dependency จะปรากฏขึ้น ตรวจสอบคำอธิบายของคําค้นหาแต่ละรายการเพื่อดูความหมายที่แน่นอน มีค่าเริ่มต้นเป็น <root>
แท็ก:terminal_output
--[no]include_builtin
ค่าเริ่มต้น: "false"-
รวมโมดูลในตัวไว้ในกราฟการอ้างอิง ปิดใช้งานโดยค่าเริ่มต้นเนื่องจากมีเสียงดัง
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]include_unused
: "เท็จ" -
นอกจากนี้ การค้นหาจะพิจารณาและแสดงโมดูลที่ไม่ได้ใช้ ซึ่งไม่อยู่ในกราฟการแก้ไขโมดูลหลังจากเลือก (เนื่องจากการเลือกเวอร์ชันขั้นต่ำหรือกฎการลบล้าง) ซึ่งจะมีผลที่แตกต่างกันสําหรับการค้นหาแต่ละประเภท เช่น การรวมเส้นทางใหม่ในคําสั่ง all_paths หรือการอ้างอิงเพิ่มเติมในคําสั่งอธิบาย
แท็ก:terminal_output
- ค่าเริ่มต้น
--output=<text, json or graph>
: "ข้อความ" -
รูปแบบที่ควรพิมพ์ผลการค้นหา ค่าที่ใช้ได้สำหรับข้อความค้นหา ได้แก่ text, json, graph
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]verbose
: "เท็จ" -
นอกจากนี้ การค้นหาจะแสดงสาเหตุที่โมดูลได้รับการแก้ไขเป็นเวอร์ชันปัจจุบันด้วย (หากมีการเปลี่ยนแปลง) ค่าเริ่มต้นคือ "จริง" สำหรับคำค้นหา "อธิบาย" เท่านั้น
แท็ก:terminal_output
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะอนุญาตในกราฟ Dependency ที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่ามีการดึงออกในรีจิสทรีที่มาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น การดึงเวอร์ชันออกจะทำให้การแก้ไขไม่สำเร็จ นอกจากนี้ คุณยังกำหนดเวอร์ชันลบที่อนุญาตด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" ได้ด้วย คุณสามารถปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้กับเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ" "off" เพื่อปิดใช้การตรวจสอบ หรือ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน
แท็ก:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่า Dependency ของ `bazel_dep` โดยตรงที่ประกาศไว้ในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟ Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ใช้ได้คือ "off" เพื่อปิดใช้การตรวจสอบ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน หรือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ"
แท็ก:loading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะไม่สนใจทรัพยากร Dependency สำหรับนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูทไม่ว่าค่าของแฟล็กนี้จะเป็นอะไร
แท็ก:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
ค่าเริ่มต้น: "update"-
ระบุวิธีและวิธีใช้ล็อกไฟล์ ค่าที่ถูกต้องคือ "อัปเดต" เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง "รีเฟรช" เพื่อรีเฟรชข้อมูลที่เปลี่ยนแปลงได้เพิ่มเติม (เวอร์ชันที่แยกออกมาและโมดูลที่หายไปก่อนหน้านี้) จากรีจิสทรีระยะไกลเป็นครั้งคราว "ข้อผิดพลาด" ในการใช้ไฟล์ล็อกแต่เกิดข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่อไม่อ่านหรือเขียนไปยังไฟล์ล็อก
แท็ก:loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--override_module=<an equals-separated mapping of module name to path>
รายการ - ลบล้างโมดูลด้วยเส้นทางภายในในรูปแบบ <module name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์ ระบบจะใช้เส้นทางตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ เส้นทางดังกล่าวจะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้านี้ออก
--registry=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้ค้นหาทรัพยากร Dependency ของโมดูล Bazel ลําดับมีความสําคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะเปลี่ยนไปใช้รีจิสทรีที่ใหม่กว่าก็ต่อเมื่อไม่มีโมดูลที่ต้องการในรีจิสทรีก่อนหน้า
แท็ก:changes_inputs
--vendor_dir=<a path>
default: ดูคำอธิบาย-
ระบุไดเรกทอรีที่ควรเก็บที่เก็บข้อมูลภายนอกในโหมดผู้ให้บริการ ไม่ว่าจะเป็นเพื่อดึงข้อมูลมายังไดเรกทอรีดังกล่าวหรือใช้ขณะสร้าง เส้นทางอาจเป็นเส้นทางแบบสัมบูรณ์หรือเส้นทางแบบสัมพัทธ์กับไดเรกทอรีของพื้นที่ทำงานก็ได้
แท็ก: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 เปอร์เซ็นต์หลังจาก GC แบบสมบูรณ์ติดต่อกัน <count> ครั้งภายใน <period> ระบบจะเรียกใช้ OOM คุณสามารถระบุขีดจํากัดหลายรายการโดยคั่นด้วยคอมมา
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
แฟล็กสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC แบบเต็มขึ้น ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนครั้งต่อครั้งที่เรียกใช้ ค่าเริ่มต้นเป็น Integer.MAX_VALUE โดยไม่มีขีดจำกัด ศูนย์หมายความว่าเหตุการณ์ GC ทั้งหมดจะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC แบบเต็มและเปอร์เซ็นต์ของกองข้อมูลที่เก็บรักษาไว้เกินเกณฑ์
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC เล็กน้อยขึ้น ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนนี้ต่อการเรียกใช้แต่ละครั้ง ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด ค่า 0 หมายความว่ากิจกรรม GC ที่ไม่สำคัญมากจะไม่ทำให้ลดลงเลย หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC ย่อยและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานฮีปที่สะสมไว้ถึงเกณฑ์นี้เป็นอย่างน้อย ก็จะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็น การปรับแต่งค่านี้อาจช่วยลดผลกระทบต่อเวลาจริงของการกระหน่ำ GC เมื่อการกระหน่ำ GC (1) เกิดจากการใช้งานหน่วยความจําของสถานะชั่วคราวนี้ และ (2) เสียค่าใช้จ่ายมากกว่าการสร้างสถานะใหม่เมื่อจําเป็น
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ส่งผลต่อรายละเอียด รูปแบบ หรือตำแหน่งของการบันทึก
--experimental_command_profile=<cpu, wall, alloc or lock>
default: ดูคำอธิบาย- บันทึกโปรไฟล์ Java Flight Recorder ตลอดระยะเวลาของคำสั่ง คุณต้องระบุประเภทเหตุการณ์โปรไฟล์ที่รองรับ (cpu, wall, alloc หรือ lock) รายการใดรายการหนึ่งเป็นอาร์กิวเมนต์ ระบบจะเขียนโปรไฟล์ลงในไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ในไดเรกทอรีฐานเอาต์พุต ไวยากรณ์และความหมายของแฟล็กนี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับประเภทโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม คุณต้องยอมรับความเสี่ยงที่เกิดขึ้นเอง
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจำกัดอยู่ที่ 20 รายการที่มีการกระทำมากที่สุด การตั้งค่าตัวเลือกนี้จะเป็นการเขียนสถิติสำหรับการช่วยจำทั้งหมด
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ใช่ค่าว่าง ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการระยะไกล
--experimental_downloader_config=<a string>
default: ดูคำอธิบาย- ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดจากระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะขึ้นต้นด้วยคําสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สําหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ โดยรูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้แทน URL โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณระบุคําสั่ง `rewrite` หลายรายการสําหรับ URL เดียวกันได้ และในกรณีนี้ระบบจะแสดงผล URL หลายรายการ
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
ค่าเริ่มต้น: "auto"- โหมดการแยกชุดข้อความที่จะใช้ดึงข้อมูลรีโป หากตั้งค่าเป็น "ปิด" ระบบจะไม่ใช้เธรดสำหรับงานและการดึงข้อมูลรีโปจะขึ้นอยู่กับการรีสตาร์ท ไม่เช่นนั้นจะใช้เธรดผู้ทํางานเสมือน
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้
--deleted_packages=<comma-separated list of package names>
ระบบจะรวบรวมการใช้งานหลายครั้ง- รายการชื่อแพ็กเกจที่คั่นด้วยคอมมา ซึ่งระบบบิลด์จะถือว่าไม่มีอยู่ แม้ว่าจะปรากฏในเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ ตัวอย่างเช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์แล้ว ระบบบิลด์อาจแสดงข้อผิดพลาดหากพบป้ายกำกับ "//x:y/z" หากยังมีรายการ package_path อื่นระบุอยู่ การระบุ --deleted_packages x/y จะช่วยหลีกเลี่ยงปัญหานี้ได้
--[no]fetch
ค่าเริ่มต้น: "true"- อนุญาตให้คำสั่งดึงข้อมูลทรัพยากร Dependency ภายนอก หากตั้งค่าเป็นเท็จ คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ หากไม่มี คำสั่งจะดำเนินการไม่สำเร็จ
--override_repository=<an equals-separated mapping of repository name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" แสดงว่าสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel" หากเส้นทางที่ระบุว่างเปล่า ให้นำการลบล้างก่อนหน้าออก
--package_path=<colon-separated list of options>
ค่าเริ่มต้น: "%workspace%"- รายการตำแหน่งที่จะค้นหาแพ็กเกจที่คั่นด้วยโคลอน องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับพื้นที่ทำงานที่ล้อมรอบอยู่ หากละเว้นหรือว่างเปล่า ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
--[no]show_loading_progress
ค่าเริ่มต้น: "true"- หากเปิดใช้จะทำให้ Bazel พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ:"
ตัวเลือก Print_action
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
--distdir=<a path>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนที่จะเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บข้อมูลจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบในแคชแทนการคัดลอก การดำเนินการนี้มีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งที่พยายามลองอีกครั้งสูงสุดสำหรับข้อผิดพลาดในการดาวน์โหลด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองอีกครั้ง
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับเวลาหมดอายุทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้น
--[no]incompatible_disable_native_repo_rules
: "เท็จ" -
หากเป็นเท็จ จะใช้กฎของรีโปเดิมใน WORKSPACE ได้ หากเป็นจริง ต้องใช้กฎของรีโป Starlark แทน กฎของรีโปเนทีฟ ได้แก่ local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
default: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลรีโพซิทอรี่ภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดแคช มิเช่นนั้นจะใช้ค่าเริ่มต้น "<output_user_root>/cache/repos/v1"
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]repository_disable_download
: "เท็จ" -
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลพื้นที่เก็บข้อมูล โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้อย่างสมบูรณ์ ctx.execute อาจยังคงเรียกใช้ไฟล์ที่เรียกใช้งานได้แบบกำหนดเองซึ่งเข้าถึงอินเทอร์เน็ตได้
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
--gc_thrashing_threshold=<an integer in 0-100 range>
ค่าเริ่มต้น: "100"-
เปอร์เซ็นต์ของพื้นที่เก็บข้อมูลแบบ Tenure ที่ใช้งานอยู่ (0-100) ซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์ความกดดันของหน่วยความจำเทียบกับขีดจํากัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุเวอร์ชันโมดูลในรูปแบบ "<module1>@<version1>,<module2>@<version2>" ซึ่งจะอนุญาตในกราฟทรัพยากร Dependency ที่ได้รับการแก้ไขแล้ว แม้ว่าจะประกาศเวอร์ชันในรีจิสทรีในรีจิสทรีซึ่งเป็นที่มาก็ตาม (หากไม่ได้มาจาก NonRegistryOverride) มิเช่นนั้น เวอร์ชันที่แยกออกมาจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันที่ดึงออกได้โดยใช้ตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็ก:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ" "off" เพื่อปิดใช้การตรวจสอบ หรือ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน
แท็ก:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่า Dependency ของ `bazel_dep` โดยตรงที่ประกาศไว้ในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟ Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ใช้ได้คือ "off" เพื่อปิดใช้การตรวจสอบ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน หรือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ"
แท็ก:loading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นข้อกำหนดในการพัฒนาเหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูท ไม่ว่าค่าของ Flag นี้จะเป็นอย่างไรก็ตาม
แท็ก:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
ค่าเริ่มต้น: "update"-
ระบุวิธีและระบุว่าจะใช้ไฟล์ล็อกหรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ไฟล์ล็อกและอัปเดตไฟล์หากมีการเปลี่ยนแปลง "refresh" เพื่อรีเฟรชข้อมูลที่เปลี่ยนแปลงได้เพิ่มเติม (เวอร์ชันที่ยกเลิกและโมดูลที่ขาดหายไปก่อนหน้านี้) จากรีจิสทรีระยะไกลเป็นครั้งคราว "error" เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่เป็นปัจจุบัน หรือ "off" เพื่อไม่อ่านหรือเขียนลงในไฟล์ล็อก
แท็ก:loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--override_module=<an equals-separated mapping of module name to path>
รายการ - ลบล้างโมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีทํางานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้าออก
--registry=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้ค้นหาทรัพยากร Dependency ของโมดูล Bazel ลําดับมีความสําคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะเปลี่ยนไปใช้รีจิสทรีที่ใหม่กว่าก็ต่อเมื่อไม่มีโมดูลที่ต้องการในรีจิสทรีก่อนหน้า
แท็ก:changes_inputs
--vendor_dir=<a path>
default: ดูคำอธิบาย-
ระบุไดเรกทอรีที่ควรเก็บที่เก็บข้อมูลภายนอกในโหมดผู้ให้บริการ ไม่ว่าจะเป็นเพื่อดึงข้อมูลมายังไดเรกทอรีดังกล่าวหรือใช้ขณะสร้าง คุณสามารถระบุเส้นทางเป็นเส้นทางสัมบูรณ์หรือเส้นทางที่สัมพันธ์กับไดเรกทอรีพื้นที่ทำงานก็ได้
แท็ก:loading_and_analysis
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพของเวลาสร้างมีดังนี้
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
ค่าเริ่มต้น: "1s:2,20s:3,1m:5"-
ขีดจํากัดที่หากถึงแล้วจะทำให้ GcThrashingDetector ทำให้ Bazel ขัดข้องด้วย OOM ขีดจํากัดแต่ละรายการจะระบุเป็น <period>:<count> โดยที่ระยะเวลาคือระยะเวลา และจํานวนเต็มเป็นจำนวนเต็มบวก หากมีการใช้งานพื้นที่ที่คงไว้ (ฮีป Gen เก่า) เกินกว่า --gc_thrashing_threshold เปอร์เซ็นต์ของพื้นที่ที่คงไว้ (ฮีปของ Gen เดิม) หลังจาก GC เต็ม <count> ตัวติดต่อกันภายใน <period> จะมีการทริกเกอร์ OOM คุณสามารถระบุขีดจํากัดหลายรายการโดยคั่นด้วยคอมมา
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้ฮีปที่เก็บรักษาไว้เกินเกณฑ์ที่ --skyframe_high_water_mark_threshold กำหนด เมื่อเกิดเหตุการณ์ GC เต็มรูปแบบเกิดขึ้น สถานะของ Skyframe ชั่วคราวจะถูกตัดทิ้งโดยไม่จำเป็นจนถึงจำนวนครั้งดังกล่าวต่อการเรียกใช้หลายครั้ง ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด 0 หมายความว่าเหตุการณ์ GC แบบสมบูรณ์จะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC แบบเต็มและเปอร์เซ็นต์ของกองข้อมูลที่เก็บรักษาไว้เกินเกณฑ์
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
แฟล็กสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC เล็กน้อย ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนนี้ต่อการเรียกใช้แต่ละครั้ง ค่าเริ่มต้นเป็น Integer.MAX_VALUE โดยไม่มีขีดจำกัด ค่า 0 หมายความว่ากิจกรรม GC ที่ไม่สำคัญมากจะไม่ทำให้ลดลงเลย หากถึงขีดจำกัด สถานะ Skyframe จะไม่ลดลงอีกต่อไปเมื่อเกิดเหตุการณ์ GC ที่ไม่ร้ายแรงและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์กองที่เก็บไว้อย่างน้อยถึงเกณฑ์นี้ ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็น การปรับแต่งค่านี้อาจช่วยลดผลกระทบต่อเวลาจริงของการกระหน่ำ GC เมื่อการกระหน่ำ GC (1) เกิดจากการใช้งานหน่วยความจําของสถานะชั่วคราวนี้ และ (2) เสียค่าใช้จ่ายมากกว่าการสร้างสถานะใหม่เมื่อจําเป็น
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ส่งผลต่อรายละเอียด รูปแบบ หรือตำแหน่งของการบันทึก
--experimental_command_profile=<cpu, wall, alloc or lock>
default: ดูคำอธิบาย- บันทึกโปรไฟล์ Java Flight Recorder ตลอดระยะเวลาของคำสั่ง คุณต้องระบุประเภทเหตุการณ์โปรไฟล์ที่รองรับ (cpu, wall, alloc หรือ lock) รายการใดรายการหนึ่งเป็นอาร์กิวเมนต์ ระบบจะเขียนโปรไฟล์ลงในไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ในไดเรกทอรีฐานเอาต์พุต ไวยากรณ์และความหมายของแฟล็กนี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับประเภทโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม คุณต้องยอมรับความเสี่ยงที่เกิดขึ้นเอง
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจํากัดไว้ที่คําช่วยจํา 20 รายการที่มีการดําเนินการมากที่สุด การตั้งค่าตัวเลือกนี้จะเป็นการเขียนสถิติสำหรับการช่วยจำทั้งหมด
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ใช่ค่าว่าง ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการระยะไกล
--experimental_downloader_config=<a string>
default: ดูคำอธิบาย- ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดจากระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด แต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือสองรูปแบบ รูปแบบหนึ่งจะใช้ตรงกัน และอีกรูปแบบหนึ่งใช้เป็น URL ทดแทน โดยมีการอ้างอิงกลับที่เริ่มต้นจาก "$1" ซึ่งระบบอาจส่งคืนคำสั่ง "rewrite" หลายครั้งสำหรับ URL เดียวกัน
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
ค่าเริ่มต้น: "auto"- โหมดการแยกชุดข้อความที่จะใช้ดึงข้อมูลรีโป หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท ไม่เช่นนั้น ให้ใช้เทรดผู้ปฏิบัติงานเสมือน
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
--override_repository=<an equals-separated mapping of repository name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างที่เก็บโดยใช้เส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้าออก
--print_action_mnemonics=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง- แสดงรายการคําช่วยจําสําหรับกรองข้อมูล print_action โดยจะไม่มีการจัดทําการกรองหากปล่อยว่างไว้
ตัวเลือกการค้นหา
- ตัวเลือกที่ปรากฏก่อนคําสั่งและได้รับการแยกวิเคราะห์โดยไคลเอ็นต์
--distdir=<a path>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนที่จะเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บข้อมูลจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบในแคชแทนการคัดลอก การดำเนินการนี้มีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งที่พยายามลองอีกครั้งสูงสุดสำหรับข้อผิดพลาดในการดาวน์โหลด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองอีกครั้ง
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ด้วยปัจจัยนี้ วิธีนี้ช่วยให้รีโพซิทอรีภายนอกทํางานบนเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
ค่าเริ่มต้น: "false"-
หากเป็นเท็จ จะใช้กฎของพื้นที่เก็บข้อมูลแบบดั้งเดิมใน WORKSPACE ได้ หากเป็นจริง ต้องใช้กฎของพื้นที่เก็บข้อมูล Starlark แทน กฎของรีโปเนทีฟ ได้แก่ local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูคำอธิบาย -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลรีโพซิทอรี่ภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช มิเช่นนั้นระบบจะใช้ค่าเริ่มต้นของ "<output_user_root>/cache/repos/v1"
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]repository_disable_download
: "เท็จ" -
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลพื้นที่เก็บข้อมูล โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้อย่างสมบูรณ์ ctx.execute อาจยังคงเรียกใช้ไฟล์ที่เรียกใช้งานได้แบบกำหนดเองซึ่งเข้าถึงอินเทอร์เน็ตได้
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
--gc_thrashing_threshold=<an integer in 0-100 range>
ค่าเริ่มต้น: "100"-
เปอร์เซ็นต์ของพื้นที่เก็บข้อมูลแบบ Tenure ที่ใช้งานอยู่ (0-100) ซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์ความกดดันของหน่วยความจําเทียบกับขีดจํากัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก:host_machine_resource_optimizations
--[no]keep_going
[-k
] ค่าเริ่มต้น: "เท็จ"-
ดำเนินการต่อให้มากที่สุดหลังจากเกิดข้อผิดพลาด แม้ว่าเป้าหมายที่ล้มเหลวและเป้าหมายที่อ้างอิงอยู่จะไม่สามารถวิเคราะห์ได้ แต่ข้อกำหนดเบื้องต้นอื่นๆ ของเป้าหมายเหล่านี้อาจเป็นไปได้
แท็ก:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
ค่าเริ่มต้น: "auto"-
จํานวนเธรดแบบขนานที่จะใช้สําหรับระยะการโหลด/การวิเคราะห์ ใช้จํานวนเต็มหรือคีย์เวิร์ด ("auto", "HOST_CPUS", "HOST_RAM") ตามด้วยการดำเนินการ ([-|*]<float>) ตามต้องการ เช่น "auto", "HOST_CPUS*.5" "auto" จะตั้งค่าเริ่มต้นที่เหมาะสมตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก:bazel_internal_configuration
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือบิลด์ API ที่ไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE เข้าถึงได้
--[no]incompatible_config_setting_private_default_visibility
ค่าเริ่มต้น: "false"-
หาก incompatible_enforce_config_setting_visibility=false จะไม่มีการดำเนินการใดๆ หรือไม่เช่นนั้น หากแฟล็กนี้เป็นเท็จ config_setting ใดๆ ที่ไม่มีแอตทริบิวต์การเปิดเผยอย่างชัดแจ้งจะเป็น //visibility:public หากแฟล็กนี้เป็นจริง config_setting จะใช้ตรรกะระดับการเข้าถึงเดียวกันกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
ค่าเริ่มต้น: "true"-
หากเป็นจริง ให้บังคับใช้การจำกัดระดับการเข้าถึง config_setting หากเป็นเท็จ เป้าหมายทุกรายการจะเห็น config_setting ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตการค้นหาและความหมาย
--aspect_deps=<off, conservative or precise>
ค่าเริ่มต้น: "conservative"-
วิธีแก้ไขการพึ่งพาแง่มุมเมื่อรูปแบบเอาต์พุตเป็นหนึ่งใน {xml,proto,record} "ปิด" หมายความว่าไม่มีการแก้ไขข้อกําหนดของมิติข้อมูล "แบบอนุรักษ์นิยม" (ค่าเริ่มต้น) หมายความว่าระบบจะเพิ่มข้อกําหนดของมิติข้อมูลที่ประกาศไว้ทั้งหมด ไม่ว่าจะได้รับคลาสกฎของข้อกําหนดโดยตรงหรือไม่ "แม่นยํา" หมายความว่าระบบจะเพิ่มเฉพาะมิติข้อมูลเหล่านั้นที่อาจใช้งานได้โดยพิจารณาจากคลาสกฎของข้อกําหนดโดยตรง โปรดทราบว่าโหมดที่แม่นยำต้องโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียว จึงทําให้ช้ากว่าโหมดอื่นๆ นอกจากนี้ โปรดทราบว่าโหมดที่แม่นยำก็อาจไม่แม่นยำทั้งหมด เนื่องจากการตัดสินใจว่าจะคำนวณแง่มุมใดหรือไม่นั้นจะเกิดขึ้นในระยะการวิเคราะห์ ซึ่งไม่ได้ทำงานระหว่าง "การค้นหา Bazel"
แท็ก:build_file_semantics
--[no]consistent_labels
ค่าเริ่มต้น: "false"-
หากเปิดใช้ คำสั่งการค้นหาทุกรายการจะแสดงป้ายกำกับราวกับว่าฟังก์ชัน <code>str</code> ของ Starlark มีผลกับอินสแตนซ์ <code>Label</code> ซึ่งมีประโยชน์สําหรับเครื่องมือที่ต้องจับคู่เอาต์พุตของคําสั่งการค้นหาและ/หรือป้ายกำกับต่างๆ ที่กฎสร้างขึ้น หากไม่ได้เปิดใช้ ตัวจัดรูปแบบเอาต์พุตจะแสดงชื่อที่เก็บที่ชัดเจน (สัมพันธ์กับที่เก็บหลัก) แทนเพื่อให้อ่านเอาต์พุตได้ง่ายขึ้น
แท็ก:terminal_output
--[no]experimental_explicit_aspects
ค่าเริ่มต้น: "false"-
aquery, cquery: จะรวมการดำเนินการที่สร้างขึ้นในเอาต์พุตหรือไม่ คำค้นหา: no-op (ติดตามเสมอ)
แท็ก: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 ที่การค้นหาทำงาน Dependency ที่ไม่ชัดแจ้งคือ Dependency ที่ไม่ได้ระบุไว้อย่างชัดเจนในไฟล์ BUILD แต่ Bazel เพิ่มเข้ามา สําหรับ cquery ตัวเลือกนี้จะควบคุมการกรองเครื่องมือทางเทคนิคที่แก้ไขแล้ว
แท็ก:build_file_semantics
- ค่าเริ่มต้น
--[no]include_aspects
: "true" -
aquery, cquery: ระบุว่าจะรวมการดำเนินการที่เกิดจากแง่มุมไว้ในเอาต์พุตหรือไม่ query: no-op (ระบบจะตามแง่มุมเสมอ)
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]incompatible_lexicographical_output
: "true" -
หากตั้งค่าตัวเลือกนี้ ระบบจะจัดเรียงเอาต์พุต --order_output=auto ตามลําดับตัวอักษร
แท็ก:terminal_output
,incompatible_change
--[no]incompatible_package_group_includes_double_slash
ค่าเริ่มต้น: "true"-
หากเปิดใช้ เมื่อแสดงผลแอตทริบิวต์ "packages" ของ package_group ระบบจะไม่ละเว้น "//" ที่อยู่ด้านหน้า
แท็ก:terminal_output
,incompatible_change
- ค่าเริ่มต้น
--[no]infer_universe_scope
: "เท็จ" -
หากตั้งค่าและไม่ได้ตั้งค่า --universe_scope ระบบจะอนุมานค่าของ --universe_scope เป็นรายการรูปแบบเป้าหมายที่ไม่ซ้ำกันในนิพจน์การค้นหา โปรดทราบว่าค่า --universe_scope ที่อนุมานสําหรับนิพจน์การค้นหาที่ใช้ฟังก์ชันระดับจักรวาล (เช่น `allrdeps`) อาจไม่ใช่สิ่งที่คุณต้องการ คุณจึงควรใช้ตัวเลือกนี้เฉพาะในกรณีที่คุณเข้าใจสิ่งที่ทําอยู่ ดูรายละเอียดและตัวอย่างได้ที่ https://bazel.build/reference/query#sky-query หากตั้งค่า --universe_scope แล้ว ระบบจะไม่สนใจค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้ใช้ได้กับ "ข้อความค้นหา" เท่านั้น (ไม่ใช่ "cquery")
แท็ก:loading_and_analysis
--[no]line_terminator_null
ค่าเริ่มต้น: "false"-
แต่ละรูปแบบสิ้นสุดด้วย \0 แทนบรรทัดใหม่หรือไม่
แท็ก:terminal_output
--[no]nodep_deps
ค่าเริ่มต้น: "true"-
หากเปิดใช้ Dep จากแอตทริบิวต์ "nodep" จะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ตัวอย่างทั่วไปของแอตทริบิวต์ "nodep" คือ "ระดับการเข้าถึง" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ "info build-language" เพื่อดูข้อมูลเกี่ยวกับแอตทริบิวต์ "nodep" ทั้งหมดในภาษาของบิลด์
แท็ก:build_file_semantics
--noorder_results
-
แสดงผลลัพธ์ตามลําดับความขึ้นต่อกัน (ค่าเริ่มต้น) หรือไม่เป็นลําดับ เอาต์พุตแบบไม่จัดลําดับจะเร็วกว่า แต่รองรับเฉพาะเมื่อ --output ไม่ใช่ minrank, maxrank หรือ graph
ขยายเป็น
--order_output=no
แท็ก:terminal_output
--null
-
แต่ละรูปแบบสิ้นสุดด้วย \0 แทนบรรทัดใหม่หรือไม่
ขยายเป็น
--line_terminator_null=true
แท็ก:terminal_output
--order_output=<no, deps, auto or full>
ค่าเริ่มต้น: "auto"-
แสดงผลลัพธ์แบบไม่จัดเรียง (no) จัดเรียงตามลำดับความสำคัญ (deps) หรือจัดเรียงอย่างสมบูรณ์ (full) ค่าเริ่มต้นคือ "auto" ซึ่งหมายความว่าระบบจะแสดงผลลัพธ์ตามลําดับความเกี่ยวข้องหรือตามลําดับโดยสมบูรณ์ ทั้งนี้ขึ้นอยู่กับเครื่องมือจัดรูปแบบเอาต์พุต (ตามลําดับความเกี่ยวข้องสําหรับ proto, minrank, maxrank และกราฟ ตามลําดับโดยสมบูรณ์สําหรับรายการอื่นๆ ทั้งหมด) เมื่อเรียงลำดับเอาต์พุตอย่างสมบูรณ์แล้ว โหนดจะพิมพ์ตามลำดับเชิงกำหนดโดยสมบูรณ์ (ทั้งหมด) ขั้นแรก ระบบจะจัดเรียงโหนดทั้งหมดตามลําดับตัวอักษร จากนั้นระบบจะใช้โหนดแต่ละรายการในรายการเป็นจุดเริ่มต้นของการค้นหาแบบเข้าใกล้ตามลําดับหลัง ซึ่งจะไปยังขอบขาออกไปยังโหนดที่ยังไม่ได้เข้าชมตามลําดับตัวอักษรของโหนดที่สืบทอด สุดท้าย ระบบจะพิมพ์โหนดตามลำดับย้อนกลับจากการเข้าชม
แท็ก:terminal_output
--order_results
-
แสดงผลเป็นผลลัพธ์ตามลำดับของทรัพยากร Dependency (ค่าเริ่มต้น) หรือไม่เรียงลำดับ เอาต์พุตแบบไม่จัดลําดับจะเร็วกว่า แต่รองรับเฉพาะเมื่อ --output ไม่ใช่ minrank, maxrank หรือ graph
ขยายเป็น
--order_output=auto
แท็ก:terminal_output
--output=<a string>
ค่าเริ่มต้น: "label"-
รูปแบบที่ควรพิมพ์ผลการค้นหา ค่าที่อนุญาตสำหรับคำค้นหา ได้แก่ build, graph, streamed_jsonproto, label, label_kind, location, maxrank, minrank, package, proto, streamed_proto, textproto, xml
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:default_values
: "true" -
หากเป็น "จริง" ระบบจะรวมแอตทริบิวต์ที่ค่าไม่ได้ระบุไว้อย่างชัดเจนในไฟล์ BUILD หากเป็น "เท็จ" ระบบจะไม่รวมแอตทริบิวต์ดังกล่าว ตัวเลือกนี้ใช้ได้กับ --output=proto
แท็ก:terminal_output
--[no]proto:definition_stack
ค่าเริ่มต้น: "false"-
ป้อนข้อมูลในช่อง 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
ค่าเริ่มต้น: "false"-
กำหนดว่าจะคำนวณและป้อนข้อมูลแอตทริบิวต์ $internal_attr_hash หรือไม่
แท็ก:terminal_output
--[no]proto:instantiation_stack
ค่าเริ่มต้น: "false"-
ป้อนข้อมูลสแต็กการเรียกอินสแตนซ์ของกฎแต่ละข้อ โปรดทราบว่าขั้นตอนนี้ต้องมีสแต็ก
แท็ก:terminal_output
- ค่าเริ่มต้น
--[no]proto:locations
: "true" -
กำหนดว่าจะแสดงข้อมูลตำแหน่งในเอาต์พุต Pro เลยหรือไม่
แท็ก:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
ค่าเริ่มต้น: "all"-
รายการแอตทริบิวต์ที่คั่นด้วยคอมมาที่จะรวมไว้ในเอาต์พุต ค่าเริ่มต้นคือแอตทริบิวต์ทั้งหมด ตั้งค่าเป็นสตริงว่างเปล่าเพื่อไม่ให้แสดงแอตทริบิวต์ใดๆ ตัวเลือกนี้ใช้ได้กับ --output=proto
แท็ก: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
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" นิพจน์ tests() จะแสดงข้อผิดพลาดหากพบ test_suite ที่มีเป้าหมายที่ไม่ใช่การทดสอบ
แท็ก:build_file_semantics
,eagerness_to_exit
--[no]tool_deps
ค่าเริ่มต้น: "true"-
คำค้นหา: หากปิดใช้ ทรัพยากร Dependency ใน "การกำหนดค่าการดำเนินการ" จะไม่รวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาทำงาน ขอบความเกี่ยวข้องของ "การกำหนดค่า exec" เช่น ขอบจากกฎ "proto_library" ไปยัง Protocol Compiler มักจะชี้ไปยังเครื่องมือที่ดำเนินการระหว่างการสร้าง ไม่ใช่ส่วนหนึ่งของโปรแกรม "เป้าหมาย" เดียวกัน
Cquery: หากปิดใช้ ระบบจะกรองเป้าหมายที่กําหนดค่าไว้ทั้งหมดซึ่งข้ามการเปลี่ยนการดำเนินการจากเป้าหมายระดับบนสุดที่ค้นพบเป้าหมายที่กําหนดค่าไว้นี้ ซึ่งหมายความว่าหากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าเป้าหมาย ระบบจะแสดงเฉพาะเป้าหมายที่กำหนดค่าไว้ในการกำหนดค่าเป้าหมายเท่านั้น หากเป้าหมายระดับบนสุดอยู่ในการกําหนดค่า exec ระบบจะแสดงเฉพาะเป้าหมายที่กําหนดค่า exec ตัวเลือกนี้จะ "ไม่" ยกเว้น Toolchain ที่แก้ไขแล้ว
แท็ก:build_file_semantics
--universe_scope=<comma-separated list of options>
ค่าเริ่มต้น: ""-
ชุดรูปแบบเป้าหมายที่คั่นด้วยคอมมา (บวกและการลบ) การค้นหาอาจดำเนินการในจักรวาลที่กําหนดโดยการปิดเชิงการเปลี่ยนรูปแบบของเป้าหมายที่ระบุ ตัวเลือกนี้ใช้สำหรับคำสั่ง query และ cquery
สําหรับ cquery อินพุตของตัวเลือกนี้คือเป้าหมายที่สร้างขึ้นสําหรับคําตอบทั้งหมด ดังนั้นตัวเลือกนี้จึงอาจส่งผลต่อการกำหนดค่าและการเปลี่ยน หากไม่ได้ระบุตัวเลือกนี้ ระบบจะถือว่าเป้าหมายระดับบนสุดเป็นเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหา หมายเหตุ: สําหรับ cquery การไม่ระบุตัวเลือกนี้อาจทําให้บิลด์ใช้งานไม่ได้ หากเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหาไม่สามารถสร้างด้วยตัวเลือกระดับบนสุด
แท็ก:loading_and_analysis
--[no]xml:default_values
ค่าเริ่มต้น: "false"-
หากเป็นจริง ระบบจะพิมพ์แอตทริบิวต์กฎที่ค่าไม่ได้ระบุไว้อย่างชัดเจนในไฟล์ BUILD มิเช่นนั้น ระบบจะไม่พิมพ์
แท็ก:terminal_output
--[no]xml:line_numbers
ค่าเริ่มต้น: "true"-
หากเป็นจริง เอาต์พุต XML จะมีหมายเลขบรรทัด การปิดใช้ตัวเลือกนี้อาจทําให้อ่านความแตกต่างได้ง่ายขึ้น ตัวเลือกนี้ใช้ได้กับ --output=xml เท่านั้น
แท็ก:terminal_output
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod มีดังนี้
--allow_yanked_versions=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะอนุญาตในกราฟ Dependency ที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่ามีการดึงออกในรีจิสทรีที่มาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น การดึงเวอร์ชันออกจะทำให้การแก้ไขไม่สำเร็จ นอกจากนี้ คุณยังกำหนดเวอร์ชันที่ดึงออกได้โดยใช้ตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้กับเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ" "off" เพื่อปิดใช้การตรวจสอบ หรือ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่า Dependency ของ `bazel_dep` โดยตรงที่ประกาศไว้ในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟ Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ใช้ได้คือ "off" เพื่อปิดใช้การตรวจสอบ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน หรือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ"
แท็ก:loading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นข้อกำหนดในการพัฒนาเหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูท ไม่ว่าค่าของ Flag นี้จะเป็นอย่างไรก็ตาม
แท็ก:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
ค่าเริ่มต้น: "update"-
ระบุวิธีและระบุว่าจะใช้ไฟล์ล็อกหรือไม่ ค่าที่ถูกต้องคือ "อัปเดต" เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง "รีเฟรช" เพื่อรีเฟรชข้อมูลที่เปลี่ยนแปลงได้เพิ่มเติม (เวอร์ชันที่แยกออกมาและโมดูลที่หายไปก่อนหน้านี้) จากรีจิสทรีระยะไกลเป็นครั้งคราว "ข้อผิดพลาด" ในการใช้ไฟล์ล็อกแต่เกิดข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่อไม่อ่านหรือเขียนไปยังไฟล์ล็อก
แท็ก: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>
default: ดูคำอธิบาย-
ระบุไดเรกทอรีที่ควรเก็บที่เก็บข้อมูลภายนอกในโหมดผู้ให้บริการ ไม่ว่าจะเป็นเพื่อดึงข้อมูลมายังไดเรกทอรีดังกล่าวหรือใช้ขณะสร้าง เส้นทางอาจเป็นเส้นทางแบบสัมบูรณ์หรือเส้นทางแบบสัมพัทธ์กับไดเรกทอรีของพื้นที่ทำงานก็ได้
แท็ก:loading_and_analysis
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพของเวลาบิลด์
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
ค่าเริ่มต้น: "1s:2,20s:3,1m:5"-
ขีดจำกัดที่หากถึงจะทำให้ GcThrashingDetector ทำให้ Bazel ขัดข้องด้วย OOM โดยระบุขีดจํากัดแต่ละรายการเป็น <period>:<count> โดยที่ period คือระยะเวลา และ count คือจํานวนเต็มบวก หากมีการใช้พื้นที่ที่มีการจัดสรรไว้ (ฮีปรุ่นเก่า) มากกว่า --gc_thrashing_threshold เปอร์เซ็นต์หลังจากการเรียกใช้ GC แบบเต็มติดต่อกัน <count> ครั้งภายใน <period> ระบบจะเรียกใช้ OOM คุณสามารถระบุขีดจํากัดหลายรายการโดยคั่นด้วยคอมมา
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC แบบเต็มขึ้น ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนครั้งต่อครั้งที่เรียกใช้ ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด ศูนย์หมายความว่าเหตุการณ์ GC ทั้งหมดจะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC แบบเต็มและเปอร์เซ็นต์ของกองข้อมูลที่เก็บรักษาไว้เกินเกณฑ์
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC เล็กน้อย ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนนี้ต่อการเรียกใช้แต่ละครั้ง ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด 0 หมายความว่าเหตุการณ์ GC เล็กน้อยจะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC ย่อยและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานฮีปที่สะสมไว้ถึงเกณฑ์นี้เป็นอย่างน้อย ก็จะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็น การปรับแต่งนี้อาจช่วยลดผลกระทบจากเวลาจริงของการ Thashing
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ส่งผลต่อรายละเอียด รูปแบบ หรือตำแหน่งของการบันทึก
--experimental_command_profile=<cpu, wall, alloc or lock>
default: ดูคำอธิบาย- บันทึกโปรไฟล์ Java Flight Recorder ตลอดระยะเวลาของคำสั่ง ต้องระบุประเภทเหตุการณ์การสร้างโปรไฟล์ที่รองรับ (CPU, หน้าจอ, Allo หรือ Lock) เป็นอาร์กิวเมนต์ ระบบจะเขียนโปรไฟล์ลงในไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ในไดเรกทอรีฐานเอาต์พุต รูปแบบคำสั่งและความหมายของ Flag นี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับประเภทโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม โปรดใช้โดยยอมรับความเสี่ยงเอง
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจํากัดไว้ที่คําช่วยจํา 20 รายการที่มีการดําเนินการมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับคําช่วยจําทั้งหมด
--experimental_repository_resolved_file=<a string>
ค่าเริ่มต้น: ""-
หากไม่ใช่ค่าว่าง ให้เขียนค่า Starlark ที่มีข้อมูลที่แก้ไขแล้วของกฎที่เก็บ Starlark ทั้งหมดที่ดำเนินการ
แท็ก:affects_outputs
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ใช่ค่าว่าง ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการระยะไกล
--experimental_downloader_config=<a string>
default: ดูคำอธิบาย- ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดจากระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด แต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือสองรูปแบบ รูปแบบหนึ่งจะใช้ตรงกัน และอีกรูปแบบหนึ่งใช้เป็น URL ทดแทน โดยมีการอ้างอิงกลับที่เริ่มต้นจาก "$1" ซึ่งระบบอาจส่งคืนคำสั่ง "rewrite" หลายครั้งสำหรับ URL เดียวกัน
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
ค่าเริ่มต้น: "auto"- โหมดการแยกชุดข้อความที่จะใช้ดึงข้อมูลรีโป หากตั้งค่าเป็น "ปิด" ระบบจะไม่ใช้เธรดสำหรับงานและการดึงข้อมูลรีโปจะขึ้นอยู่กับการรีสตาร์ท ไม่เช่นนั้นจะใช้เธรดผู้ทํางานเสมือน
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้
--deleted_packages=<comma-separated list of package names>
ระบบจะรวบรวมการใช้งานหลายครั้ง- รายการชื่อแพ็กเกจที่คั่นด้วยคอมมา ซึ่งระบบบิลด์จะถือว่าไม่มีอยู่ แม้ว่าจะปรากฏในเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจที่มีอยู่ "x" ตัวอย่างเช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์แล้ว ระบบบิลด์อาจแสดงข้อผิดพลาดหากพบป้ายกำกับ "//x:y/z" หากยังมีรายการ package_path อื่นระบุอยู่ การระบุ --deleted_packages x/y ช่วยป้องกันปัญหานี้
- ค่าเริ่มต้น
--[no]fetch
: "true" - อนุญาตให้คําสั่งดึงข้อมูลการอ้างอิงภายนอก หากตั้งค่าเป็นเท็จ คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ หากไม่มี คำสั่งจะดำเนินการไม่สำเร็จ
--override_repository=<an equals-separated mapping of repository name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างที่เก็บโดยใช้เส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" แสดงว่าสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "พื้นที่ทำงานของข้อมูล Bazel" หากเส้นทางที่ระบุว่างเปล่า ให้นำการลบล้างก่อนหน้าออก
--package_path=<colon-separated list of options>
ค่าเริ่มต้น: "%workspace%"- รายการตำแหน่งที่จะค้นหาแพ็กเกจที่คั่นด้วยโคลอน องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับเวิร์กスペースที่ล้อมรอบ หากละเว้นหรือว่างเปล่า ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
--[no]show_loading_progress
ค่าเริ่มต้น: "true"- หากเปิดใช้ จะทำให้ Bazel พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ:"
ตัวเลือกการเรียกใช้
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
--distdir=<a path>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนที่จะเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บข้อมูลจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบในแคชแทนการคัดลอก การดำเนินการนี้มีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งที่พยายามลองอีกครั้งสูงสุดสำหรับข้อผิดพลาดในการดาวน์โหลด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก:experimental
- ค่าเริ่มต้น
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับเวลาหมดอายุทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ช่วยให้รีโพซิทอรีภายนอกทํางานบนเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้น
--[no]incompatible_disable_native_repo_rules
: "เท็จ" -
หากเป็นเท็จ จะใช้กฎของรีโปเดิมใน WORKSPACE ได้ หากเป็นจริง ต้องใช้กฎของรีโป Starlark แทน กฎของรีโปเนทีฟ ได้แก่ local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
default: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการเรียกข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดแคช มิเช่นนั้นจะใช้ค่าเริ่มต้น "<output_user_root>/cache/repos/v1"
แท็ก:bazel_internal_configuration
--[no]repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลพื้นที่เก็บข้อมูล โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้อย่างสมบูรณ์ ctx.execute อาจยังคงเรียกใช้ไฟล์ที่เรียกใช้งานได้แบบกำหนดเองซึ่งเข้าถึงอินเทอร์เน็ตได้
แท็ก:bazel_internal_configuration
--[no]run
ค่าเริ่มต้น: "true"-
หากเป็น "เท็จ" ให้ข้ามการเรียกใช้บรรทัดคำสั่งที่สร้างขึ้นสำหรับเป้าหมายที่สร้างขึ้น
แท็ก:affects_outputs
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์มีดังนี้
--gc_thrashing_threshold=<an integer in 0-100 range>
ค่าเริ่มต้น: "100"-
เปอร์เซ็นต์ของพื้นที่เช่า (0-100) ข้างต้นซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์แรงดันหน่วยความจำเทียบกับขีดจำกัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการซึ่งส่งผลต่อค่าของแท็ก ซึ่งต่างจากที่มีอยู่
- ค่าเริ่มต้น
--script_path=<a path>
: ดูคำอธิบาย -
หากตั้งค่าไว้ ให้เขียนสคริปต์เชลล์ไปยังไฟล์ซึ่งเรียกใช้เป้าหมาย หากตั้งค่าตัวเลือกนี้ ระบบจะไม่เรียกใช้เป้าหมายจาก bazel ใช้ "bazel run --script_path=foo //foo && ./foo" เพื่อเรียกใช้เป้าหมาย "//foo" ซึ่งแตกต่างจาก "bazel run //foo" ตรงที่ระบบจะยกเลิกการล็อก bazel และเชื่อมต่อไฟล์ที่ปฏิบัติการได้กับ stdin ของเทอร์มินัล
แท็ก:affects_outputs
,execution
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะอนุญาตในกราฟ Dependency ที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่ามีการดึงออกในรีจิสทรีที่มาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น การดึงเวอร์ชันออกจะทำให้การแก้ไขไม่สำเร็จ นอกจากนี้ คุณยังกำหนดเวอร์ชันที่ดึงออกได้โดยใช้ตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็ก:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ" "off" เพื่อปิดใช้การตรวจสอบ หรือ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน
แท็ก:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟทรัพยากร Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ใช้ได้คือ "off" เพื่อปิดใช้การตรวจสอบ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน หรือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ"
แท็ก:loading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นข้อกำหนดในการพัฒนาเหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูท ไม่ว่าค่าของ Flag นี้จะเป็นอย่างไรก็ตาม
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--lockfile_mode=<off, update, refresh or error>
: "อัปเดต" -
ระบุวิธีและระบุว่าจะใช้ไฟล์ล็อกหรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ไฟล์ล็อกและอัปเดตไฟล์หากมีการเปลี่ยนแปลง "refresh" เพื่อรีเฟรชข้อมูลที่เปลี่ยนแปลงได้เพิ่มเติม (เวอร์ชันที่ยกเลิกและโมดูลที่ขาดหายไปก่อนหน้านี้) จากรีจิสทรีระยะไกลเป็นครั้งคราว "error" เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่เป็นปัจจุบัน หรือ "off" เพื่อไม่อ่านหรือเขียนลงในไฟล์ล็อก
แท็ก:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างโมดูลด้วยเส้นทางภายในในรูปแบบ <module name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์ ระบบจะใช้เส้นทางตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ เส้นทางดังกล่าวจะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้าออก
--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> โดยที่ period คือระยะเวลา และ count คือจํานวนเต็มบวก หากมีการใช้พื้นที่ที่มีการจัดสรรไว้ (ฮีปรุ่นเก่า) มากกว่า --gc_thrashing_threshold เปอร์เซ็นต์หลังจากการเรียกใช้ GC แบบเต็มติดต่อกัน <count> ครั้งภายใน <period> ระบบจะเรียกใช้ OOM คุณสามารถระบุขีดจํากัดหลายรายการโดยคั่นด้วยคอมมา
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
แฟล็กสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC แบบเต็มขึ้น ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนครั้งต่อครั้งที่เรียกใช้ ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด 0 หมายความว่าเหตุการณ์ GC แบบสมบูรณ์จะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC แบบเต็มและเปอร์เซ็นต์ของกองข้อมูลที่เก็บรักษาไว้เกินเกณฑ์
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
แฟล็กสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้ฮีปที่เก็บรักษาไว้เกินเกณฑ์ที่ --skyframe_high_water_mark_threshold ตั้งค่าอยู่ เมื่อเกิดเหตุการณ์ GC ที่ไม่ร้ายแรง เหตุการณ์ GC ที่ไม่ร้ายแรงจะเกิดขึ้น ระบบจะหยุดสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นออกไปจนถึงหลายครั้งต่อการเรียกใช้ ค่าเริ่มต้นคือจำนวนเต็มMAX_VALUE โดยไม่มีขีดจำกัด ศูนย์หมายความว่ากิจกรรม GC ที่ไม่สำคัญจะไม่ทริกเกอร์การลดลงเลย หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC เล็กน้อยและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้อย่างน้อยถึงเกณฑ์นี้ ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็น การปรับแต่งนี้อาจช่วยลดผลกระทบจากเวลาจริงของการ Thashing
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ส่งผลต่อรายละเอียด รูปแบบ หรือตำแหน่งของการบันทึก
--experimental_command_profile=<cpu, wall, alloc or lock>
default: ดูคำอธิบาย- บันทึกโปรไฟล์ Java Flight Recorder ตลอดระยะเวลาของคำสั่ง คุณต้องระบุประเภทเหตุการณ์โปรไฟล์ที่รองรับ (cpu, wall, alloc หรือ lock) รายการใดรายการหนึ่งเป็นอาร์กิวเมนต์ ระบบจะเขียนโปรไฟล์ลงในไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ในไดเรกทอรีฐานเอาต์พุต รูปแบบคำสั่งและความหมายของแฟล็กนี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับประเภทโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม โปรดใช้โดยยอมรับความเสี่ยงเอง
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจํากัดไว้ที่คําช่วยจํา 20 รายการที่มีการดําเนินการมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับคําช่วยจําทั้งหมด
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ค่าเริ่มต้น
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
หากไม่ใช่ค่าว่าง ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการระยะไกล
- ค่าเริ่มต้น
--experimental_downloader_config=<a string>
: ดูคำอธิบาย - ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดจากระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะขึ้นต้นด้วยคําสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สําหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ โดยรูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้แทน URL โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณอาจระบุคําสั่ง `rewrite` หลายรายการสําหรับ URL เดียวกันได้ ซึ่งในกรณีนี้ระบบจะแสดงผล URL หลายรายการ
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
ค่าเริ่มต้น: "auto"- โหมดการแยกชุดข้อความที่ใช้สำหรับการดึงข้อมูลที่เก็บ หากตั้งค่าเป็น "ปิด" ระบบจะไม่ใช้เธรดสำหรับงานและการดึงข้อมูลรีโปจะขึ้นอยู่กับการรีสตาร์ท ไม่เช่นนั้นจะใช้เธรดผู้ทํางานเสมือน
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
--override_repository=<an equals-separated mapping of repository name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างที่เก็บโดยใช้เส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีทํางานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้าออก
ตัวเลือกการปิดเครื่อง
- ตัวเลือกที่ปรากฏก่อนคําสั่งและได้รับการแยกวิเคราะห์โดยไคลเอ็นต์
--distdir=<a path>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนที่จะเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บข้อมูลจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบในแคชแทนการคัดลอก การดำเนินการนี้มีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งที่พยายามลองอีกครั้งสูงสุดสำหรับข้อผิดพลาดในการดาวน์โหลด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก:experimental
- ค่าเริ่มต้น
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับเวลาหมดอายุทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ช่วยให้รีโพซิทอรีภายนอกทํางานบนเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
ค่าเริ่มต้น: "false"-
หากเป็นเท็จ จะใช้กฎของรีโปเดิมใน WORKSPACE ได้ หากเป็นจริง ต้องใช้กฎของรีโป Starlark แทน กฎของรีโปเนทีฟ ได้แก่ local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
default: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการเรียกข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช มิเช่นนั้นระบบจะใช้ค่าเริ่มต้นของ "<output_user_root>/cache/repos/v1"
แท็ก:bazel_internal_configuration
--[no]repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลพื้นที่เก็บข้อมูล โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้อย่างสมบูรณ์ ctx.execute อาจยังคงเรียกใช้ไฟล์ที่เรียกใช้งานได้แบบกำหนดเองซึ่งเข้าถึงอินเทอร์เน็ตได้
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
--gc_thrashing_threshold=<an integer in 0-100 range>
ค่าเริ่มต้น: "100"-
เปอร์เซ็นต์ของพื้นที่เก็บข้อมูลแบบ Tenure ที่ใช้งานอยู่ (0-100) ซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์ความกดดันของหน่วยความจําเทียบกับขีดจํากัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ควบคุมเอาต์พุตของคําสั่ง
- ค่าเริ่มต้นของ
--iff_heap_size_greater_than=<an integer>
: "0" -
หากไม่ใช่ 0 ระบบจะปิดเซิร์ฟเวอร์เฉพาะในกรณีที่ JVM ใช้หน่วยความจำทั้งหมด (เป็น MB) เกินค่านี้
แท็ก:loses_incremental_state
,eagerness_to_exit
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันโมดูลในรูปแบบ "<module1>@<version1>,<module2>@<version2>" ซึ่งจะอนุญาตในกราฟทรัพยากร Dependency ที่ได้รับการแก้ไขแล้ว แม้ว่าจะมีการประกาศเวอร์ชันในรีจิสทรีในที่มาของเวอร์ชัน (หากไม่ได้มาจาก NonRegistryOverride) มิเช่นนั้น เวอร์ชันที่แยกออกมาจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันแยกที่อนุญาตด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" ได้ด้วย คุณสามารถปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ" "off" เพื่อปิดใช้การตรวจสอบ หรือ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน
แท็ก:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟทรัพยากร Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ใช้ได้คือ "off" เพื่อปิดใช้การตรวจสอบ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน หรือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ"
แท็ก:loading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นข้อกำหนดในการพัฒนาเหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูท ไม่ว่าค่าของ Flag นี้จะเป็นอย่างไรก็ตาม
แท็ก:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
ค่าเริ่มต้น: "update"-
ระบุวิธีและวิธีใช้ล็อกไฟล์ ค่าที่ถูกต้องคือ "อัปเดต" เพื่อใช้ไฟล์ล็อกและอัปเดตหากมีการเปลี่ยนแปลง "รีเฟรช" เพื่อรีเฟรชข้อมูลที่เปลี่ยนแปลงได้เพิ่มเติม (เวอร์ชันที่แยกออกมาและโมดูลที่หายไปก่อนหน้านี้) จากรีจิสทรีระยะไกลเป็นครั้งคราว "ข้อผิดพลาด" ในการใช้ไฟล์ล็อกแต่เกิดข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่อไม่อ่านหรือเขียนไปยังไฟล์ล็อก
แท็ก:loading_and_analysis
--override_module=<an equals-separated mapping of module name to 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> โดยที่ period คือระยะเวลา และ count คือจํานวนเต็มบวก หากมีการใช้พื้นที่ที่มีการจัดสรรไว้ (ฮีปรุ่นเก่า) มากกว่า --gc_thrashing_threshold เปอร์เซ็นต์หลังจาก GC แบบสมบูรณ์ติดต่อกัน <count> ครั้งภายใน <period> ระบบจะเรียกใช้ OOM คุณสามารถระบุขีดจํากัดหลายรายการโดยคั่นด้วยคอมมา
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC แบบเต็มขึ้น ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนครั้งต่อครั้งที่เรียกใช้ ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด 0 หมายความว่ากิจกรรม GC ทั้งหมดจะไม่ทริกเกอร์การลดลง หากถึงขีดจำกัด สถานะ Skyframe จะไม่ลดลงอีกต่อไปเมื่อเกิดเหตุการณ์ GC เต็มรูปแบบและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC เล็กน้อยขึ้น ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนนี้ต่อการเรียกใช้แต่ละครั้ง ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด 0 หมายความว่าเหตุการณ์ GC เล็กน้อยจะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC เล็กน้อยและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้ฮีปที่เก็บรักษาไว้ถึงเกณฑ์นี้เป็นอย่างน้อย ก็จะทิ้งสถานะ Skyframe ชั่วคราวโดยไม่จำเป็น การปรับแต่งค่านี้อาจช่วยลดผลกระทบต่อเวลาจริงของการกระหน่ำ GC เมื่อการกระหน่ำ GC (1) เกิดจากการใช้งานหน่วยความจําของสถานะชั่วคราวนี้ และ (2) เสียค่าใช้จ่ายมากกว่าการสร้างสถานะใหม่เมื่อจําเป็น
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ส่งผลต่อรายละเอียด รูปแบบ หรือตำแหน่งของการบันทึก
--experimental_command_profile=<cpu, wall, alloc or lock>
default: ดูคำอธิบาย- บันทึกโปรไฟล์ Java Flight Recorder ตลอดระยะเวลาของคำสั่ง คุณต้องระบุประเภทเหตุการณ์โปรไฟล์ที่รองรับ (cpu, wall, alloc หรือ lock) รายการใดรายการหนึ่งเป็นอาร์กิวเมนต์ ระบบจะเขียนโปรไฟล์ลงในไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ในไดเรกทอรีฐานเอาต์พุต ไวยากรณ์และความหมายของแฟล็กนี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับประเภทโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม คุณต้องยอมรับความเสี่ยงที่เกิดขึ้นเอง
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจำกัดอยู่ที่ 20 รายการที่มีการกระทำมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับคําช่วยจําทั้งหมด
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ค่าเริ่มต้น
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
หากไม่ใช่ค่าว่าง ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการระยะไกล
--experimental_downloader_config=<a string>
default: ดูคำอธิบาย- ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดจากระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด แต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือสองรูปแบบ รูปแบบหนึ่งจะใช้ตรงกัน และอีกรูปแบบหนึ่งใช้เป็น URL ทดแทน โดยมีการอ้างอิงกลับที่เริ่มต้นจาก "$1" ซึ่งระบบอาจส่งคืนคำสั่ง "rewrite" หลายครั้งสำหรับ URL เดียวกัน
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
ค่าเริ่มต้น: "auto"- โหมดการแยกชุดข้อความที่จะใช้ดึงข้อมูลรีโป หากตั้งค่าเป็น "ปิด" ระบบจะไม่ใช้เธรดสำหรับงานและการดึงข้อมูลรีโปจะขึ้นอยู่กับการรีสตาร์ท ไม่เช่นนั้น ให้ใช้เทรดผู้ปฏิบัติงานเสมือน
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้
--override_repository=<an equals-separated mapping of repository name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างที่เก็บโดยใช้เส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีทํางานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้านี้ออก
ตัวเลือกการซิงค์
- ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนที่จะเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ แคชที่เก็บข้อมูลจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบในแคชแทนการคัดลอก ซึ่งช่วยประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งที่พยายามลองอีกครั้งสูงสุดสำหรับข้อผิดพลาดในการดาวน์โหลด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองอีกครั้ง
แท็ก:experimental
- ค่าเริ่มต้น
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับเวลาหมดอายุทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ช่วยให้รีโพซิทอรีภายนอกทํางานบนเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
ค่าเริ่มต้น: "false"-
หากเป็นเท็จ จะใช้กฎของรีโปเดิมใน WORKSPACE ได้ หากเป็นจริง ต้องใช้กฎของรีโป Starlark แทน กฎที่เก็บในระบบรวมถึง local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
default: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลรีโพซิทอรี่ภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช มิเช่นนั้นระบบจะใช้ค่าเริ่มต้นของ "<output_user_root>/cache/repos/v1"
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]repository_disable_download
: "เท็จ" -
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลพื้นที่เก็บข้อมูล โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้อย่างสมบูรณ์ ctx.execute อาจยังคงเรียกใช้ไฟล์ที่เรียกใช้งานได้แบบกำหนดเองซึ่งเข้าถึงอินเทอร์เน็ตได้
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์มีดังนี้
--[no]configure
ค่าเริ่มต้น: "False"-
เฉพาะที่เก็บข้อมูลการซิงค์ที่ทำเครื่องหมายเป็น "กำหนดค่า" เพื่อวัตถุประสงค์ในการกำหนดค่าระบบ
แท็ก:changes_inputs
- ค่าเริ่มต้น
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
เปอร์เซ็นต์ของพื้นที่เก็บข้อมูลแบบ Tenure ที่ใช้งานอยู่ (0-100) ซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์ความกดดันของหน่วยความจําเทียบกับขีดจํากัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก:host_machine_resource_optimizations
--[no]keep_going
[-k
] ค่าเริ่มต้น: "เท็จ"-
ดำเนินการต่อให้มากที่สุดหลังจากเกิดข้อผิดพลาด แม้ว่าจะวิเคราะห์เป้าหมายที่ไม่สําเร็จและเป้าหมายที่ขึ้นอยู่กับเป้าหมายนั้นไม่ได้ แต่สามารถวิเคราะห์ข้อกําหนดเบื้องต้นอื่นๆ ของเป้าหมายเหล่านี้ได้
แท็ก:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
ค่าเริ่มต้น: "auto"-
จํานวนเธรดแบบขนานที่จะใช้สําหรับระยะการโหลด/การวิเคราะห์ ใช้จํานวนเต็มหรือคีย์เวิร์ด ("auto", "HOST_CPUS", "HOST_RAM") ตามด้วยการดำเนินการ ([-|*]<float>) ตามต้องการ เช่น "auto", "HOST_CPUS*.5" "auto" จะตั้งค่าเริ่มต้นที่เหมาะสมตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก:bazel_internal_configuration
--only=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
หากระบุตัวเลือกนี้ ระบบจะซิงค์เฉพาะที่เก็บข้อมูลที่ระบุด้วยตัวเลือกนี้ ยังคงถือว่าทั้งหมด (หรือทั้งหมดที่คล้ายกับ "กำหนดค่า" หากมี --configure) ล้าสมัย
แท็ก:changes_inputs
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ API การสร้างที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
--[no]incompatible_config_setting_private_default_visibility
ค่าเริ่มต้น: "false"-
หาก incompatible_enforce_config_setting_visibility=false จะไม่มีการดำเนินการใดๆ หรือไม่เช่นนั้น หากแฟล็กนี้เป็นเท็จ config_setting ใดๆ ที่ไม่มีแอตทริบิวต์การเปิดเผยอย่างชัดแจ้งจะเป็น //visibility:public หาก Flag นี้เป็น "จริง" config_setting จะใช้ตรรกะการแสดงผลเดียวกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ระบบจะบังคับใช้ข้อจำกัดการแสดงผลของ config_setting หากเป็นเท็จ เป้าหมายทุกรายการจะเห็น config_setting ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod มีดังนี้
--allow_yanked_versions=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะอนุญาตในกราฟ Dependency ที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่ามีการดึงออกในรีจิสทรีที่มาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น การดึงเวอร์ชันออกจะทำให้การแก้ไขไม่สำเร็จ นอกจากนี้ คุณยังกำหนดเวอร์ชันที่ดึงออกได้โดยใช้ตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็ก:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ" "off" เพื่อปิดใช้การตรวจสอบ หรือ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟทรัพยากร Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ใช้ได้คือ "off" เพื่อปิดใช้การตรวจสอบ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน หรือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ"
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นข้อกำหนดในการพัฒนาเหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูท ไม่ว่าค่าของ Flag นี้จะเป็นอย่างไรก็ตาม
แท็ก:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
ค่าเริ่มต้น: "update"-
ระบุวิธีและระบุว่าจะใช้ไฟล์ล็อกหรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ไฟล์ล็อกและอัปเดตไฟล์หากมีการเปลี่ยนแปลง "refresh" เพื่อรีเฟรชข้อมูลที่เปลี่ยนแปลงได้เพิ่มเติม (เวอร์ชันที่ยกเลิกและโมดูลที่ขาดหายไปก่อนหน้านี้) จากรีจิสทรีระยะไกลเป็นครั้งคราว "error" เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่เป็นปัจจุบัน หรือ "off" เพื่อไม่อ่านหรือเขียนลงในไฟล์ล็อก
แท็ก:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างโมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีทํางานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้านี้ออก
--registry=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้ค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับเป็นสิ่งสำคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีในภายหลังเมื่อไม่มีรีจิสทรีที่ขาดหายไป
แท็ก:changes_inputs
--vendor_dir=<a path>
default: ดูคำอธิบาย-
ระบุไดเรกทอรีที่ควรเก็บที่เก็บข้อมูลภายนอกในโหมดผู้ให้บริการ ไม่ว่าจะเป็นเพื่อดึงข้อมูลมายังไดเรกทอรีดังกล่าวหรือใช้ขณะสร้าง เส้นทางอาจเป็นเส้นทางแบบสัมบูรณ์หรือเส้นทางแบบสัมพัทธ์กับไดเรกทอรีของพื้นที่ทำงานก็ได้
แท็ก:loading_and_analysis
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพของเวลาสร้างมีดังนี้
- ค่าเริ่มต้น
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "1s:2,20s:3,1m:5" -
ขีดจํากัดที่หากถึงแล้วจะทำให้ GcThrashingDetector ทำให้ Bazel ขัดข้องด้วย OOM โดยระบุขีดจํากัดแต่ละรายการเป็น <period>:<count> โดยที่ period คือระยะเวลา และ count คือจํานวนเต็มบวก หากมีการใช้งานพื้นที่ที่คงไว้ (ฮีป Gen เก่า) เกินกว่า --gc_thrashing_threshold เปอร์เซ็นต์ของพื้นที่ที่คงไว้ (ฮีป Gen เดิม) หลังจาก GC เต็ม <count> ตัวติดต่อกันภายใน <period> จะมีการทริกเกอร์ OOM คุณสามารถระบุขีดจํากัดหลายรายการโดยคั่นด้วยคอมมา
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
แฟล็กสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC แบบเต็มขึ้น ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนครั้งต่อครั้งที่เรียกใช้ ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด ศูนย์หมายความว่าเหตุการณ์ GC ทั้งหมดจะไม่ทริกเกอร์การลดลง หากถึงขีดจำกัด สถานะ Skyframe จะไม่ลดลงอีกต่อไปเมื่อเกิดเหตุการณ์ GC เต็มรูปแบบและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC เล็กน้อย ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนนี้ต่อการเรียกใช้แต่ละครั้ง ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด ค่า 0 หมายความว่ากิจกรรม GC ที่ไม่สำคัญมากจะไม่ทำให้ลดลงเลย หากถึงขีดจำกัด สถานะ Skyframe จะไม่ลดลงอีกต่อไปเมื่อเกิดเหตุการณ์ GC ที่ไม่ร้ายแรงและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้ฮีปที่เก็บรักษาไว้ถึงเกณฑ์นี้เป็นอย่างน้อย ก็จะทิ้งสถานะ Skyframe ชั่วคราวโดยไม่จำเป็น การปรับแต่งนี้อาจช่วยลดผลกระทบจากเวลาจริงของการ Thashing
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ส่งผลต่อรายละเอียด รูปแบบ หรือตำแหน่งของการบันทึก
--experimental_command_profile=<cpu, wall, alloc or lock>
default: ดูคำอธิบาย- บันทึกโปรไฟล์ Java Flight Recorder ตลอดระยะเวลาของคำสั่ง ต้องระบุประเภทเหตุการณ์การสร้างโปรไฟล์ที่รองรับ (CPU, หน้าจอ, Allo หรือ Lock) เป็นอาร์กิวเมนต์ โปรไฟล์จะเขียนไปยังไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ภายใต้ไดเรกทอรีฐานเอาต์พุต รูปแบบคำสั่งและความหมายของแฟล็กนี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับประเภทโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม โปรดใช้โดยยอมรับความเสี่ยงเอง
--[no]experimental_record_metrics_for_all_mnemonics
ค่าเริ่มต้น: "false"- โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจำกัดอยู่ที่ 20 รายการที่มีการกระทำมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับคําช่วยจําทั้งหมด
- ค่าเริ่มต้น
--experimental_repository_resolved_file=<a string>
: "" -
หากไม่ใช่ค่าว่าง ให้เขียนค่า Starlark ที่มีข้อมูลที่แก้ไขแล้วของกฎที่เก็บ Starlark ทั้งหมดที่ดำเนินการ
แท็ก:affects_outputs
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ค่าเริ่มต้น
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
หากไม่ว่างเปล่า ให้อ่านไฟล์ที่แก้ไขแล้วแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
- ค่าเริ่มต้น
--experimental_downloader_config=<a string>
: ดูคำอธิบาย - ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดจากระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะขึ้นต้นด้วยคําสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สําหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ โดยรูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้แทน URL โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณอาจระบุคําสั่ง `rewrite` หลายรายการสําหรับ URL เดียวกันได้ ซึ่งในกรณีนี้ระบบจะแสดงผล URL หลายรายการ
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
ค่าเริ่มต้น: "auto"- โหมดการแยกชุดข้อความที่จะใช้ดึงข้อมูลรีโป หากตั้งค่าเป็น "ปิด" จะไม่มีการใช้เทรดผู้ปฏิบัติงาน และการดึงข้อมูลที่เก็บจะต้องรีสตาร์ท ไม่เช่นนั้นจะใช้เธรดผู้ทํางานเสมือน
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้
--deleted_packages=<comma-separated list of package names>
ระบบจะรวบรวมการใช้งานหลายครั้ง- รายการชื่อแพ็กเกจที่คั่นด้วยคอมมา ซึ่งระบบบิลด์จะถือว่าไม่มีอยู่ แม้ว่าจะปรากฏในเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ ตัวอย่างเช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์แล้ว ระบบบิลด์อาจแสดงข้อผิดพลาดหากพบป้ายกำกับ "//x:y/z" หากยังมีรายการ package_path อื่นระบุอยู่ การระบุ --deleted_packages x/y จะช่วยหลีกเลี่ยงปัญหานี้ได้
- ค่าเริ่มต้น
--[no]fetch
: "true" - อนุญาตให้คำสั่งดึงข้อมูลทรัพยากร Dependency ภายนอก หากตั้งค่าเป็นเท็จ คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ หากไม่มี คำสั่งจะดำเนินการไม่สำเร็จ
--override_repository=<an equals-separated mapping of repository name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้านี้ออก
--package_path=<colon-separated list of options>
ค่าเริ่มต้น: "%workspace%"- รายการค้นหาแพ็กเกจที่คั่นด้วยโคลอน องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับเวิร์กスペースที่ล้อมรอบ หากไม่ระบุหรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตเป็น "bazel info default-package-path"
--[no]show_loading_progress
ค่าเริ่มต้น: "true"- หากเปิดใช้ จะทำให้ Bazel พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ:"
ตัวเลือกการทดสอบ
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคําสั่งและได้รับการแยกวิเคราะห์โดยไคลเอ็นต์
--distdir=<a path>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชของที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่เกิดแคชแทนที่จะคัดลอก การดำเนินการนี้มีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งที่พยายามลองอีกครั้งสูงสุดสำหรับข้อผิดพลาดในการดาวน์โหลด หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองอีกครั้ง
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับเวลาหมดอายุทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ช่วยให้รีโพซิทอรีภายนอกทํางานบนเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
ค่าเริ่มต้น: "false"-
หากเป็นเท็จ จะใช้กฎของรีโปเดิมใน WORKSPACE ได้ หากเป็นจริง ต้องใช้กฎของรีโป Starlark แทน กฎของรีโปเนทีฟ ได้แก่ local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
default: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลรีโพซิทอรี่ภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช มิเช่นนั้นระบบจะใช้ค่าเริ่มต้นของ "<output_user_root>/cache/repos/v1"
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]repository_disable_download
: "เท็จ" -
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลพื้นที่เก็บข้อมูล โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้โดยสมบูรณ์ โดย ctx.exeโดยสมบูรณ์ยังคงเรียกใช้ไฟล์ปฏิบัติการที่กำหนดเองได้ซึ่งเข้าถึงอินเทอร์เน็ตได้
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์มีดังนี้
--gc_thrashing_threshold=<an integer in 0-100 range>
ค่าเริ่มต้น: "100"-
เปอร์เซ็นต์ของพื้นที่เช่า (0-100) ข้างต้นซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์แรงดันหน่วยความจำเทียบกับขีดจำกัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะอนุญาตในกราฟ Dependency ที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่ามีการดึงออกในรีจิสทรีที่มาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น การดึงเวอร์ชันออกจะทำให้การแก้ไขไม่สำเร็จ นอกจากนี้ คุณยังกำหนดเวอร์ชันที่ดึงออกได้โดยใช้ตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็ก:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ" "off" เพื่อปิดใช้การตรวจสอบ หรือ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน
แท็ก:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่า Dependency ของ `bazel_dep` โดยตรงที่ประกาศไว้ในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟ Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ใช้ได้คือ "off" เพื่อปิดใช้การตรวจสอบ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน หรือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ"
แท็ก:loading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นข้อกำหนดในการพัฒนาเหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูท ไม่ว่าค่าของ Flag นี้จะเป็นอย่างไรก็ตาม
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--lockfile_mode=<off, update, refresh or error>
: "อัปเดต" -
ระบุวิธีและระบุว่าจะใช้ไฟล์ล็อกหรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ไฟล์ล็อกและอัปเดตไฟล์หากมีการเปลี่ยนแปลง "refresh" เพื่อรีเฟรชข้อมูลที่เปลี่ยนแปลงได้เพิ่มเติม (เวอร์ชันที่ยกเลิกและโมดูลที่ขาดหายไปก่อนหน้านี้) จากรีจิสทรีระยะไกลเป็นครั้งคราว "error" เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่เป็นปัจจุบัน หรือ "off" เพื่อไม่อ่านหรือเขียนลงในไฟล์ล็อก
แท็ก:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างโมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีทํางานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้านี้ออก
--registry=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้ค้นหาทรัพยากร Dependency ของโมดูล Bazel ลําดับมีความสําคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะเปลี่ยนไปใช้รีจิสทรีที่ใหม่กว่าก็ต่อเมื่อไม่มีโมดูลที่ต้องการในรีจิสทรีก่อนหน้า
แท็ก:changes_inputs
- ค่าเริ่มต้น
--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> โดยที่ period คือระยะเวลา และ count คือจํานวนเต็มบวก หากมีการใช้พื้นที่ที่มีการจัดสรรไว้ (ฮีปรุ่นเก่า) มากกว่า --gc_thrashing_threshold เปอร์เซ็นต์หลังจาก GC แบบสมบูรณ์ติดต่อกัน <count> ครั้งภายใน <period> ระบบจะเรียกใช้ OOM คุณสามารถระบุขีดจํากัดหลายรายการโดยคั่นด้วยคอมมา
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
แฟล็กสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC แบบเต็มขึ้น ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนครั้งต่อครั้งที่เรียกใช้ ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด 0 หมายความว่าเหตุการณ์ GC แบบสมบูรณ์จะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC แบบเต็มและเปอร์เซ็นต์ของกองข้อมูลที่เก็บรักษาไว้เกินเกณฑ์
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC เล็กน้อยขึ้น ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนนี้ต่อการเรียกใช้แต่ละครั้ง ค่าเริ่มต้นเป็น Integer.MAX_VALUE โดยไม่มีขีดจำกัด 0 หมายความว่าเหตุการณ์ GC เล็กน้อยจะไม่ทริกเกอร์การลดลง หากถึงขีดจำกัด สถานะ Skyframe จะไม่ลดลงอีกต่อไปเมื่อเกิดเหตุการณ์ GC ที่ไม่ร้ายแรงและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
แฟล็กสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์กองที่เก็บไว้อย่างน้อยถึงเกณฑ์นี้ ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็น การปรับแต่งค่านี้อาจช่วยลดผลกระทบต่อเวลาจริงของการกระหน่ำ GC เมื่อการกระหน่ำ GC (1) เกิดจากการใช้งานหน่วยความจําของสถานะชั่วคราวนี้ และ (2) เสียค่าใช้จ่ายมากกว่าการสร้างสถานะใหม่เมื่อจําเป็น
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ส่งผลต่อรายละเอียด รูปแบบ หรือตำแหน่งของการบันทึก
--experimental_command_profile=<cpu, wall, alloc or lock>
default: ดูคำอธิบาย- บันทึกโปรไฟล์ Java Flight Recorder ตลอดระยะเวลาของคำสั่ง ต้องระบุประเภทเหตุการณ์การสร้างโปรไฟล์ที่รองรับ (CPU, หน้าจอ, Allo หรือ Lock) เป็นอาร์กิวเมนต์ โปรไฟล์จะเขียนไปยังไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ภายใต้ไดเรกทอรีฐานเอาต์พุต รูปแบบคำสั่งและความหมายของแฟล็กนี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับประเภทโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม โปรดใช้โดยยอมรับความเสี่ยงเอง
- ค่าเริ่มต้น
--[no]experimental_record_metrics_for_all_mnemonics
: "เท็จ" - โดยค่าเริ่มต้น ระบบจะจำกัดจำนวนประเภทการดำเนินการไว้ที่ 20 รายการ ซึ่งเป็นคําช่วยจําที่มีการดำเนินการมากที่สุด การตั้งค่าตัวเลือกนี้จะเป็นการเขียนสถิติสำหรับการช่วยจำทั้งหมด
--[no]print_relative_test_log_paths
ค่าเริ่มต้น: "false"-
หากเป็นจริง เมื่อพิมพ์เส้นทางไปยังบันทึกการทดสอบ ให้ใช้เส้นทางแบบสัมพัทธ์ที่ใช้ลิงก์สัญลักษณ์ "testlogs" ที่สะดวก หมายเหตุ - การเรียกใช้ "build"/"test"/etc ในภายหลังที่มีการกำหนดค่าอื่นอาจทำให้เป้าหมายของลิงก์สัญลักษณ์นี้เปลี่ยนแปลงไป ทำให้เส้นทางที่พิมพ์ก่อนหน้านี้ไม่มีประโยชน์อีกต่อไป
แท็ก:affects_outputs
--[no]test_verbose_timeout_warnings
ค่าเริ่มต้น: "false"-
หากเป็นจริง ระบบจะพิมพ์คำเตือนเพิ่มเติมเมื่อเวลาดำเนินการทดสอบจริงไม่ตรงกับเวลาหมดเวลาที่การทดสอบกำหนดไว้ (ไม่ว่าจะโดยนัยหรือชัดเจน)
แท็ก:affects_outputs
--[no]verbose_test_summary
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ให้พิมพ์ข้อมูลเพิ่มเติม (ระยะเวลา จำนวนการเรียกใช้ที่ล้มเหลว ฯลฯ) ในสรุปการทดสอบ
แท็ก:affects_outputs
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ว่างเปล่า ให้อ่านไฟล์ที่แก้ไขแล้วแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
--experimental_downloader_config=<a string>
default: ดูคำอธิบาย- ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดจากระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด แต่ละบรรทัดจะเริ่มต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือสองรูปแบบ รูปแบบหนึ่งจะใช้ตรงกัน และอีกรูปแบบหนึ่งใช้เป็น URL ทดแทน โดยมีการอ้างอิงกลับที่เริ่มต้นจาก "$1" ซึ่งระบบอาจส่งคืนคำสั่ง "rewrite" หลายครั้งสำหรับ URL เดียวกัน
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
ค่าเริ่มต้น: "auto"- โหมดการแยกชุดข้อความที่จะใช้ดึงข้อมูลรีโป หากตั้งค่าเป็น "ปิด" ระบบจะไม่ใช้เธรดสำหรับงานและการดึงข้อมูลรีโปจะขึ้นอยู่กับการรีสตาร์ท ไม่เช่นนั้นจะใช้เธรดผู้ทํางานเสมือน
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้กำหนดหมวดหมู่ไว้:
--override_repository=<an equals-separated mapping of repository name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางสัมบูรณ์จะถูกนำมาใช้ตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ เส้นทางดังกล่าวจะสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้าออก
ตัวเลือกผู้ให้บริการ
รับค่าตัวเลือกทั้งหมดจาก test
- ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนที่จะเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากตั้งค่าไว้ แคชที่เก็บข้อมูลจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบในแคชแทนการคัดลอก ซึ่งช่วยประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองดาวน์โหลดข้อผิดพลาดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองอีกครั้ง
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับเวลาหมดอายุทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ช่วยให้รีโพซิทอรีภายนอกทำงานบนเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
--[no]incompatible_disable_native_repo_rules
ค่าเริ่มต้น: "false"-
หากเป็นเท็จ จะใช้กฎของรีโปเดิมใน WORKSPACE ได้ หากเป็นจริง ต้องใช้กฎของรีโป Starlark แทน กฎของรีโปเนทีฟ ได้แก่ local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
default: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลรีโพซิทอรี่ภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช มิเช่นนั้นระบบจะใช้ค่าเริ่มต้นของ "<output_user_root>/cache/repos/v1"
แท็ก:bazel_internal_configuration
--[no]repository_disable_download
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลพื้นที่เก็บข้อมูล โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้อย่างสมบูรณ์ ctx.execute อาจยังคงเรียกใช้ไฟล์ที่เรียกใช้งานได้แบบกำหนดเองซึ่งเข้าถึงอินเทอร์เน็ตได้
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
--gc_thrashing_threshold=<an integer in 0-100 range>
ค่าเริ่มต้น: "100"-
เปอร์เซ็นต์ของพื้นที่เก็บข้อมูลแบบ Tenure ที่ใช้งานอยู่ (0-100) ซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์ความกดดันของหน่วยความจำเทียบกับขีดจํากัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก:host_machine_resource_optimizations
--[no]keep_going
[-k
] default: "false"-
ดำเนินการต่อให้มากที่สุดหลังจากเกิดข้อผิดพลาด แม้ว่าเป้าหมายที่ล้มเหลวและเป้าหมายที่อ้างอิงอยู่จะไม่สามารถวิเคราะห์ได้ แต่ข้อกำหนดเบื้องต้นอื่นๆ ของเป้าหมายเหล่านี้อาจเป็นไปได้
แท็ก:eagerness_to_exit
- ค่าเริ่มต้น
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "อัตโนมัติ" -
จำนวนชุดข้อความแบบขนานที่จะใช้สำหรับขั้นตอนการโหลด/การวิเคราะห์ ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") โดยจะเลือกตามด้วยการดำเนินการ ([-|*]<Float>) หรือไม่ก็ได้ "auto", "HOST_CPUS*.5" "auto" จะตั้งค่าเริ่มต้นที่เหมาะสมตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก:bazel_internal_configuration
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ API การสร้างที่เข้าถึงไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE ได้
- ค่าเริ่มต้น
--[no]incompatible_config_setting_private_default_visibility
: "เท็จ" -
หาก incompatible_enforce_config_setting_visibility=false จะไม่มีการดำเนินการใดๆ หรือหาก Flag นี้เป็นเท็จ config_setting ที่ไม่มีแอตทริบิวต์ระดับการมองเห็นที่ชัดเจนจะเป็น //visibility:public หาก Flag นี้เป็น "จริง" config_setting จะใช้ตรรกะการแสดงผลเดียวกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
ค่าเริ่มต้น: "true"-
หากเป็นจริง ให้บังคับใช้การจำกัดระดับการเข้าถึง config_setting หากเป็นเท็จ เป้าหมายทุกรายการจะเห็น config_setting ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะอนุญาตในกราฟ Dependency ที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่ามีการดึงออกในรีจิสทรีที่มาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิเช่นนั้น เวอร์ชันที่แยกออกมาจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชันที่ดึงออกได้โดยใช้ตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็ก:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ" "off" เพื่อปิดใช้การตรวจสอบ หรือ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่า Dependency ของ `bazel_dep` โดยตรงที่ประกาศไว้ในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟ Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ใช้ได้คือ "off" เพื่อปิดใช้การตรวจสอบ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน หรือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ"
แท็ก:loading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะไม่สนใจทรัพยากร Dependency สำหรับนักพัฒนาซอฟต์แวร์เหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูทไม่ว่าค่าของแฟล็กนี้จะเป็นอะไร
แท็ก:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
ค่าเริ่มต้น: "update"-
ระบุวิธีและระบุว่าจะใช้ไฟล์ล็อกหรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ไฟล์ล็อกและอัปเดตไฟล์หากมีการเปลี่ยนแปลง "refresh" เพื่อรีเฟรชข้อมูลที่เปลี่ยนแปลงได้เพิ่มเติม (เวอร์ชันที่ยกเลิกและโมดูลที่ขาดหายไปก่อนหน้านี้) จากรีจิสทรีระยะไกลเป็นครั้งคราว "error" เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่เป็นปัจจุบัน หรือ "off" เพื่อไม่อ่านหรือเขียนลงในไฟล์ล็อก
แท็ก:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างโมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีทํางานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้านี้ออก
--registry=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้ค้นหาทรัพยากร Dependency ของโมดูล Bazel ลำดับเป็นสิ่งสำคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะกลับไปใช้รีจิสทรีในภายหลังเมื่อไม่มีรีจิสทรีที่ขาดหายไป
แท็ก:changes_inputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--repo=<a string>
รายการ -
เฉพาะผู้ให้บริการที่ใช้ที่เก็บข้อมูลที่ระบุ ซึ่งอาจเป็น@apparent_repo_name หรือ@@canonical_repo_name ตัวเลือกนี้ตั้งค่าได้หลายครั้ง
แท็ก:changes_inputs
--vendor_dir=<a path>
default: ดูคำอธิบาย-
ระบุไดเรกทอรีที่ควรเก็บที่เก็บภายนอกในโหมดผู้ให้บริการ ไม่ว่าจะเพื่อวัตถุประสงค์ในการดึงข้อมูลลงในที่เก็บหรือใช้ขณะที่สร้าง เส้นทางอาจเป็นเส้นทางแบบสัมบูรณ์หรือเส้นทางแบบสัมพัทธ์กับไดเรกทอรีของพื้นที่ทำงานก็ได้
แท็ก: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 เปอร์เซ็นต์หลังจาก GC แบบสมบูรณ์ติดต่อกัน <count> ครั้งภายใน <period> ระบบจะเรียกใช้ OOM คุณสามารถระบุขีดจํากัดหลายรายการโดยคั่นด้วยคอมมา
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC แบบเต็มขึ้น ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนครั้งต่อแต่ละครั้งที่เรียกใช้ ค่าเริ่มต้นเป็น Integer.MAX_VALUE โดยไม่มีขีดจำกัด ศูนย์หมายความว่าเหตุการณ์ GC ทั้งหมดจะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC แบบเต็มและเปอร์เซ็นต์ของกองข้อมูลที่เก็บรักษาไว้เกินเกณฑ์
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
แฟล็กสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC เล็กน้อยขึ้น ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนนี้ต่อการเรียกใช้แต่ละครั้ง ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด 0 หมายความว่าเหตุการณ์ GC เล็กน้อยจะไม่ทริกเกอร์การลดลง หากถึงขีดจำกัด สถานะ Skyframe จะไม่ลดลงอีกต่อไปเมื่อเกิดเหตุการณ์ GC ที่ไม่ร้ายแรงและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์กองที่เก็บไว้อย่างน้อยถึงเกณฑ์นี้ ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็น การปรับแต่งค่านี้อาจช่วยลดผลกระทบต่อเวลาจริงของการกระหน่ำ GC เมื่อการกระหน่ำ GC (1) เกิดจากการใช้งานหน่วยความจําของสถานะชั่วคราวนี้ และ (2) เสียค่าใช้จ่ายมากกว่าการสร้างสถานะใหม่เมื่อจําเป็น
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ส่งผลต่อรายละเอียด รูปแบบ หรือตำแหน่งของการบันทึก
--experimental_command_profile=<cpu, wall, alloc or lock>
default: ดูคำอธิบาย- บันทึกโปรไฟล์ Java Flight Recorder ตลอดระยะเวลาของคำสั่ง คุณต้องระบุประเภทเหตุการณ์โปรไฟล์ที่รองรับ (cpu, wall, alloc หรือ lock) รายการใดรายการหนึ่งเป็นอาร์กิวเมนต์ ระบบจะเขียนโปรไฟล์ลงในไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ในไดเรกทอรีฐานเอาต์พุต รูปแบบคำสั่งและความหมายของแฟล็กนี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับประเภทโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม โปรดใช้โดยยอมรับความเสี่ยงเอง
- ค่าเริ่มต้น
--[no]experimental_record_metrics_for_all_mnemonics
: "เท็จ" - โดยค่าเริ่มต้น ระบบจะจำกัดจำนวนประเภทการดำเนินการไว้ที่ 20 รายการ ซึ่งเป็นคําช่วยจําที่มีการดำเนินการมากที่สุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสำหรับคําช่วยจําทั้งหมด
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ใช่ค่าว่าง ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการระยะไกล
--experimental_downloader_config=<a string>
default: ดูคำอธิบาย- ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะขึ้นต้นด้วยคําสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สําหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ โดยรูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้แทน URL โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณอาจระบุคําสั่ง `rewrite` หลายรายการสําหรับ URL เดียวกันได้ ซึ่งในกรณีนี้ระบบจะแสดงผล URL หลายรายการ
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
ค่าเริ่มต้น: "auto"- โหมดการแยกชุดข้อความที่จะใช้ดึงข้อมูลรีโป หากตั้งค่าเป็น "ปิด" ระบบจะไม่ใช้เธรดสำหรับงานและการดึงข้อมูลรีโปจะขึ้นอยู่กับการรีสตาร์ท ไม่เช่นนั้นจะใช้เธรดผู้ทํางานเสมือน
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้
--deleted_packages=<comma-separated list of package names>
ระบบจะรวบรวมการใช้งานหลายครั้ง- รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริง แม้ว่าจะแสดงอยู่ในที่ใดที่หนึ่งบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจที่มีอยู่ "x" ตัวอย่างเช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์แล้ว ระบบบิลด์อาจแสดงข้อผิดพลาดหากพบป้ายกำกับ "//x:y/z" หากยังมีรายการ package_path อื่นระบุอยู่ การระบุ --deleted_packages x/y จะช่วยหลีกเลี่ยงปัญหานี้ได้
--[no]fetch
ค่าเริ่มต้น: "true"- อนุญาตให้คําสั่งดึงข้อมูลการอ้างอิงภายนอก หากตั้งค่าเป็นเท็จ คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ หากไม่มี คำสั่งจะดำเนินการไม่สำเร็จ
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บโดยใช้เส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้าออก
--package_path=<colon-separated list of options>
ค่าเริ่มต้น: "%workspace%"- รายการค้นหาแพ็กเกจที่คั่นด้วยโคลอน องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับเวิร์กスペースที่ล้อมรอบ หากละเว้นหรือว่างเปล่า ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
--[no]show_loading_progress
ค่าเริ่มต้น: "true"- หากเปิดใช้ จะทำให้ Bazel พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ:"
- ตัวเลือกที่ควบคุมการดำเนินการบิลด์
- ค่าเริ่มต้น
--[no]experimental_inprocess_symlink_creation
: "เท็จ" -
Whether to make direct file system calls to create symlink trees
Tags:loading_and_analysis
,execution
,experimental
- ค่าเริ่มต้น
--[no]experimental_persistent_aar_extractor
: "เท็จ" -
เปิดใช้เครื่องมือแยก Aar แบบถาวรโดยใช้เวิร์กเกอร์
แท็ก:execution
--[no]experimental_remotable_source_manifests
ค่าเริ่มต้น: "false"-
กำหนดให้ดำเนินการในไฟล์ Manifest ของแหล่งที่มาจากระยะไกลได้หรือไม่
แท็ก:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" Bazel จะเรียกใช้การประมวลผลผลลัพธ์ของการทดสอบในกระบวนการใหม่
แท็ก:execution
- ค่าเริ่มต้น
--[no]experimental_strict_fileset_output
: "เท็จ" -
หากเปิดใช้ตัวเลือกนี้ ชุดไฟล์จะถือว่าอาร์ติแฟกต์เอาต์พุตทั้งหมดเป็นไฟล์ทั่วไป จะไม่ไปยังไดเรกทอรีต่างๆ หรือสนใจเกี่ยวกับสัญลักษณ์ลิงก์
แท็ก:execution
--[no]incompatible_disallow_unsound_directory_outputs
ค่าเริ่มต้น: "true"-
หากตั้งค่าไว้ ระบบจะแสดงข้อผิดพลาดเมื่อดำเนินการสร้างไฟล์เอาต์พุตเป็นไดเรกทอรี ไม่มีผลต่อไดเรกทอรีต้นทาง ดู https://github.com/bazelbuild/bazel/issues/18646
แท็ก:bazel_internal_configuration
,incompatible_change
--[no]incompatible_modify_execution_info_additive
ค่าเริ่มต้น: "false"-
เมื่อเปิดใช้ การส่ง Flag --modify_execution_info หลายรายการจะเป็นการเพิ่ม เมื่อปิดใช้ ระบบจะพิจารณาเฉพาะธงล่าสุดเท่านั้น
แท็ก:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
--[no]keep_going
[-k
] ค่าเริ่มต้น: "เท็จ"-
ดำเนินการต่อให้มากที่สุดหลังจากเกิดข้อผิดพลาด แม้ว่าจะวิเคราะห์เป้าหมายที่ไม่สําเร็จและเป้าหมายที่ขึ้นอยู่กับเป้าหมายนั้นไม่ได้ แต่ระบบจะวิเคราะห์ข้อกําหนดเบื้องต้นอื่นๆ ของเป้าหมายเหล่านี้ได้
แท็ก:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
ค่าเริ่มต้น: "auto"-
จำนวนชุดข้อความแบบขนานที่จะใช้สำหรับขั้นตอนการโหลด/การวิเคราะห์ ใช้จำนวนเต็มหรือคีย์เวิร์ด ("อัตโนมัติ", "HOST_CPUS", "HOST_RAM") โดยจะเลือกตามด้วยการดำเนินการ ([-|*]<Float>) หรือไม่ก็ได้ "auto", "HOST_CPUS*.5" "auto" จะตั้งค่าเริ่มต้นที่เหมาะสมตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก:bazel_internal_configuration
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
รายการ -
เพิ่มหรือนําคีย์ออกจากข้อมูลการดําเนินการของการดำเนินการตามคําช่วยจําของการดำเนินการ ใช้กับการดำเนินการที่รองรับข้อมูลการดำเนินการเท่านั้น การดำเนินการทั่วไปหลายรายการรองรับข้อมูลการดำเนินการ เช่น Genrule, CppCompile, Javac, StarlarkAction, TestRunner เมื่อระบุหลายค่า ลําดับจะมีความสำคัญเนื่องจากนิพจน์ทั่วไปหลายรายการอาจใช้กับคําช่วยจําเดียวกัน
ไวยากรณ์: "regex=[+-]key,regex=[+-]key,..."
ตัวอย่าง
'.*=+x,.*=-y,.*=+z' จะเพิ่ม "x" และ "z" ลงในข้อมูลการดำเนินการสําหรับการดําเนินการทั้งหมด และนํา "y" ออก
"Genrule=+requires-x" จะเพิ่ม "requires-x" ลงในข้อมูลการดำเนินการสำหรับการดำเนินการ Genrule ทั้งหมด
"(?!Genrule).*=-requires-x" นำ "requires-x" ออกจากข้อมูลการดำเนินการสำหรับการดำเนินการที่ไม่ใช่ Genrule ทั้งหมด
แท็ก:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
เปิดใช้การดำเนินการ Desugar และ Dex ของ Android แบบถาวรโดยใช้ Executor
ขยายเป็น
--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
-
เปิดใช้การดำเนินการ Desugar และ Dex ของ 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 แบบถาวรและแบบหลายเพล็กซ์ (การแปลงไฟล์ Dex, การถอด Sugar, การประมวลผลทรัพยากร)
ขยายเป็น
--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
ค่าเริ่มต้น: "false"-
หากเป็นจริง Bazel จะใช้แพลตฟอร์มเป้าหมายในการเรียกใช้การทดสอบแทนกลุ่ม exec ทดสอบ
แท็ก:execution
- ตัวเลือกที่กำหนดค่าเครื่องมือที่ใช้สำหรับการดำเนินการ
--android_compiler=<a string>
default: ดูคำอธิบาย-
คอมไพเลอร์เป้าหมายของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
ค่าเริ่มต้น: "//external:android/crosstool"-
ตำแหน่งคอมไพเลอร์ C++ ที่ใช้สำหรับบิลด์ Android
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--android_grte_top=<a label>
: ดูคำอธิบาย -
เป้าหมาย grte_top ของ Android
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_manifest_merger=<legacy, android or force_android>
: "android" -
เลือกเครื่องมือผสานไฟล์ Manifest ที่จะใช้กับกฎ android_binary แจ้งเพื่อช่วยให้การเปลี่ยนไปใช้การผสานไฟล์ Manifest ของ Android จากเครื่องมือผสานเดิมเป็นไปอย่างราบรื่น
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_platforms=<a build target label>
: "" -
กำหนดแพลตฟอร์มที่เป้าหมาย android_binary ใช้ หากระบุแพลตฟอร์มหลายรายการ ไฟล์ไบนารีจะเป็น APK แบบรวมซึ่งมีไบนารีเนทีฟสำหรับแพลตฟอร์มเป้าหมายแต่ละรายการที่ระบุ
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/android:sdk"-
ระบุ Android SDK/แพลตฟอร์มที่ใช้สร้างแอปพลิเคชัน 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>
default: ดูคำอธิบาย-
คอมไพเลอร์ 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>
default: "@bazel_tools//tools/test:coverage_report_generator"-
ตำแหน่งของไบนารีที่ใช้สร้างรายงานการครอบคลุม ซึ่งปัจจุบันต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดียว ซึ่งเป็นไฟล์ไบนารี ค่าเริ่มต้นคือ "//tools/test:coverage_report_generator"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_support"-
ตำแหน่งของไฟล์สนับสนุนที่จําเป็นในอินพุตของการดำเนินการทดสอบทุกครั้งที่รวบรวมการครอบคลุมโค้ด ค่าเริ่มต้นคือ "//tools/test:coverage_support"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้ในการคอมไพล์โค้ด C++
แท็ก:loading_and_analysis
,changes_inputs
,affects_outputs
- ค่าเริ่มต้น
--custom_malloc=<a build target label>
: ดูคำอธิบาย -
ระบุการใช้งาน malloc ที่กําหนดเอง การตั้งค่านี้จะลบล้างแอตทริบิวต์ malloc ในกฎการสร้าง
แท็ก:changes_inputs
,affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
รายการนิพจน์ทั่วไปที่คั่นด้วยคอมมา แต่ละรายการจะมีคำนำหน้าด้วย - (นิพจน์เชิงลบ) และกำหนด (=) ให้กับรายการเป้าหมายค่าจำกัดที่คั่นด้วยคอมมา หากเป้าหมายตรงกับที่ไม่มีนิพจน์เชิงลบ และนิพจน์เชิงบวกอย่างน้อย 1 รายการ การแปลง Toolchain จะดำเนินการเสมือนว่าได้ประกาศค่าข้อจำกัดเป็นข้อจำกัดการดำเนินการ ตัวอย่างเช่น //demo,-test=@platforms//cpus:x86_64 จะเพิ่ม "x86_64" ลงในเป้าหมายภายใต้ //demo ยกเว้นเป้าหมายที่มีชื่อเป็น "test"
แท็ก:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
ค่าเริ่มต้น: "false"-
หากตั้งค่าแล้ว ให้เพิ่มข้อกำหนดการดำเนินการ "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 คุณสามารถระบุ Toolchain ตามเป้าหมายที่ตรงกันทั้งหมด หรือเป็นรูปแบบเป้าหมายก็ได้ ระบบจะพิจารณา Toolchain เหล่านี้ก่อน Toolchain ที่ประกาศไว้ในไฟล์ WORKSPACE โดย register_toolchains()
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--grte_top=<a label>
: ดูคำอธิบาย -
ป้ายกำกับสำหรับไลบรารี libc ที่เช็คอินแล้ว Crosstool Toolchain จะเลือกค่าเริ่มต้นและคุณแทบจะไม่จำเป็นต้องลบล้างค่าเริ่มต้น
แท็ก:action_command_lines
,affects_outputs
--host_compiler=<a string>
default: ดูคำอธิบาย-
คอมไพเลอร์ C++ ที่จะใช้ในการคอมไพล์โฮสต์ ระบบจะไม่สนใจหากไม่ได้ตั้งค่า --host_crosstool_top
แท็ก:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
default: ดูคำอธิบาย-
โดยค่าเริ่มต้น ระบบจะใช้ตัวเลือก --crosstool_top และ --compiler สำหรับการกําหนดค่า exec ด้วย หากมีการแฟล็กนี้ Bazel จะใช้ libc และคอมไพเลอร์เริ่มต้นสำหรับ Crosstool_top ที่ระบุ
แท็ก:loading_and_analysis
,changes_inputs
,affects_outputs
- ค่าเริ่มต้น
--host_grte_top=<a label>
: ดูคำอธิบาย -
หากระบุไว้ การตั้งค่านี้จะลบล้างไดเรกทอรีระดับบนสุดของ libc (--grte_top) สําหรับการกําหนดค่า exec
แท็ก:action_command_lines
,affects_outputs
--host_platform=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools:host_platform"-
ป้ายกํากับของกฎแพลตฟอร์มที่อธิบายระบบโฮสต์
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "true" -
หากเป็น "จริง" Bazel จะไม่เปิดใช้ฟีเจอร์ "โฮสต์" และ "ไม่ใช่โฮสต์" ในชุดเครื่องมือ C++ (ดูข้อมูลเพิ่มเติมที่ https://github.com/bazelbuild/bazel/issues/7407)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
ค่าเริ่มต้น: "true"-
ใช้การแก้ไข Toolchain เพื่อเลือก Android SDK สําหรับกฎ Android (Starlark และแบบดั้งเดิม)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
ค่าเริ่มต้น: "false"-
ใช้การแก้ไขเครื่องมือเพื่อเลือก Apple SDK สําหรับกฎของ Apple (Starlark และแบบดั้งเดิม)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" Bazel จะไม่นําบรรทัดคําสั่งการดําเนินการลิงก์ C++ มาใช้ซ้ำสําหรับบรรทัดคําสั่งการจัดทําดัชนี lto (ดูข้อมูลเพิ่มเติมที่ https://github.com/bazelbuild/bazel/issues/6791)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" Bazel จะไม่ลิงก์ไลบรารี Dependency เป็นไฟล์เก็บถาวรทั้งไฟล์โดยค่าเริ่มต้น (ดูวิธีการย้ายข้อมูลได้ที่ https://github.com/bazelbuild/bazel/issues/7362)
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
ค่าเริ่มต้น: "true"-
หากเป็นจริง Bazel จะกำหนดให้มีพารามิเตอร์ "ctx" ใน cc_common.configure_features (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/7793)
แท็ก:loading_and_analysis
,incompatible_change
-
ใช้ออบเจ็กต์ที่แชร์ของอินเทอร์เฟซหากเครื่องมือทางเทคนิครองรับ เครื่องมือทํางาน ELF ทั้งหมดรองรับการตั้งค่านี้ในปัจจุบัน
แท็ก:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: ดูคำอธิบาย-
ระบุเวอร์ชันของ iOS SDK ที่จะใช้สร้างแอปพลิเคชัน iOS หากไม่ระบุ ระบบจะใช้เวอร์ชันเริ่มต้นของ iOS SDK จาก "xcode_version"
แท็ก:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: ดูคำอธิบาย-
ระบุเวอร์ชันของ macOS SDK ที่จะใช้สร้างแอปพลิเคชัน macOS หากไม่ระบุ ระบบจะใช้เวอร์ชัน macOS SDK เริ่มต้นจาก "xcode_version"
แท็ก:loses_incremental_state
--minimum_os_version=<a string>
default: ดูคำอธิบาย-
เวอร์ชันระบบปฏิบัติการขั้นต่ำที่การคอมไพล์กำหนดเป้าหมาย
แท็ก:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
ค่าเริ่มต้น: ""-
ตำแหน่งของไฟล์การแมปที่อธิบายแพลตฟอร์มที่จะใช้หากไม่มีการตั้งค่าหรือแฟล็กที่จะตั้งค่าเมื่อมีแพลตฟอร์มอยู่แล้ว ต้องสัมพัทธ์กับรูทของพื้นที่ทำงานหลัก ค่าเริ่มต้นคือ "platform_mappings" (ไฟล์ที่อยู่ใต้รูทของพื้นที่ทํางานโดยตรง)
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
ค่าเริ่มต้น: ""-
ป้ายกํากับของกฎแพลตฟอร์มที่อธิบายแพลตฟอร์มเป้าหมายสําหรับคําสั่งปัจจุบัน
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--python2_path=<a string>
: ดูคำอธิบาย -
เลิกใช้งานแล้ว ใช้งานไม่ได้ ปิดใช้โดย `--incompatible_use_python_toolchains`
แท็ก:no_op
,deprecated
--python3_path=<a string>
default: ดูคำอธิบาย-
เลิกใช้งานแล้ว ใช้งานไม่ได้ ปิดใช้โดย `--incompatible_use_python_toolchains`
แท็ก:no_op
,deprecated
--python_path=<a string>
default: ดูคำอธิบาย-
เส้นทางสัมบูรณ์ของโปรแกรมแปลภาษา Python ที่เรียกใช้เพื่อเรียกใช้เป้าหมาย Python ในแพลตฟอร์มเป้าหมาย เลิกใช้งานแล้ว ปิดใช้โดย --incompatible_use_python_toolchains
แท็ก:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
default: ดูคำอธิบาย-
ป้ายกำกับของ 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')>
default: ดูคำอธิบาย-
ระบุเวอร์ชันของ watchOS SDK ที่จะใช้สร้างแอปพลิเคชัน watchOS หากไม่ระบุ ระบบจะใช้เวอร์ชัน WatchOS SDK เริ่มต้นจาก "xcode_version"
แท็ก:loses_incremental_state
--xcode_version=<a string>
default: ดูคำอธิบาย-
หากระบุไว้ จะใช้ 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
ค่าเริ่มต้น: "false"-
ว่าจะสร้างไฟล์สัญลักษณ์การแก้ไขข้อบกพร่อง(.dSYM) หรือไม่
แท็ก:affects_outputs
,action_command_lines
--[no]build_runfile_links
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ระบบจะสร้างป่าซิงค์ลิงไฟล์รันไทม์สำหรับเป้าหมายทั้งหมด หากเป็นเท็จ ระบบจะเขียนเฉพาะในกรณีที่การดำเนินการในเครื่อง ทดสอบ หรือเรียกใช้คําสั่งจําเป็น
แท็ก:affects_outputs
--[no]build_runfile_manifests
ค่าเริ่มต้น: "true"-
หากเป็นจริง ให้เขียนไฟล์ Manifest ของการเรียกใช้ไฟล์สำหรับเป้าหมายทั้งหมด หากเป็นเท็จ ให้ละเว้น การทดสอบในเครื่องจะทํางานไม่สําเร็จเมื่อเป็นเท็จ
แท็ก:affects_outputs
--[no]build_test_dwp
ค่าเริ่มต้น: "false"-
หากเปิดใช้ เมื่อสร้างการทดสอบ C++ แบบคงที่และด้วย Fission ระบบจะสร้างไฟล์ .dwp สำหรับไบนารีทดสอบโดยอัตโนมัติด้วย
แท็ก:loading_and_analysis
,affects_outputs
- ค่าเริ่มต้นของ
--cc_proto_library_header_suffixes=<comma-separated set of options>
: ".pb.h" -
ตั้งค่าคำต่อท้ายของไฟล์ส่วนหัวที่ cc_protocol_library สร้างขึ้น
แท็ก:affects_outputs
,loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
ค่าเริ่มต้น: ".pb.cc"-
ตั้งค่าส่วนต่อท้ายของไฟล์ต้นฉบับที่ cc_proto_library สร้าง
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
ค่าเริ่มต้น: "false"-
เรียกใช้การดำเนินการเพิ่มเติมสำหรับเวอร์ชัน Java API อื่นใน proto_library
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_proto_extra_actions
: "เท็จ" -
เรียกใช้การดำเนินการเพิ่มเติมสำหรับเวอร์ชัน Java API อื่นใน proto_library
แท็ก:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
ค่าเริ่มต้น: "false"-
บันทึกสถานะของฟีเจอร์ที่เปิดใช้และที่ขอไว้เป็นเอาต์พุตของการคอมไพล์
แท็ก:affects_outputs
,experimental
- ค่าเริ่มต้น
--fission=<a set of compilation modes>
: "ไม่" -
ระบุโหมดการคอมไพล์ที่ใช้ Fission สําหรับการคอมไพล์และการลิงก์ C++ อาจเป็นชุดค่าผสมใดๆ ระหว่าง {'fastbuild', 'dbg', 'opt'} หรือค่าพิเศษ 'yes' เพื่อเปิดใช้งานทุกโหมด และ 'no' เพื่อปิดใช้งานทุกโหมด
แท็ก:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" กฎเนทีฟจะเพิ่ม <code>DefaultInfo.files</code> ของข้อมูลที่ต้องพึ่งพาลงในไฟล์รันไทม์ ซึ่งตรงกับลักษณะการทำงานที่แนะนำสำหรับกฎ Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid)
แท็ก:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ระบบจะสร้างป่าซิงค์ลิงก์ของไฟล์รันไทม์สำหรับที่เก็บข้อมูลภายนอกในส่วน .runfiles/wsname/external/repo (นอกเหนือจาก .runfiles/repo)
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]objc_generate_linkmap
: "เท็จ" -
ระบุว่าจะสร้างไฟล์ Linkmap หรือไม่
แท็ก:affects_outputs
--[no]save_temps
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ระบบจะบันทึกเอาต์พุตชั่วคราวจาก gcc ซึ่งรวมถึงไฟล์ .s (โค้ดแอสเซมเบลอร์), ไฟล์ .i (C ที่ผ่านการประมวลผลล่วงหน้า) และไฟล์ .ii (C++ ที่ผ่านการประมวลผลล่วงหน้า)
แท็ก:affects_outputs
- ตัวเลือกที่อนุญาตให้ผู้ใช้กําหนดค่าเอาต์พุตที่ต้องการ ซึ่งส่งผลต่อค่าของเอาต์พุต ไม่ใช่การมีอยู่ของเอาต์พุต
--action_env=<a 'name=value' assignment with an optional value part>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกำหนดค่าเป้าหมาย ตัวแปรสามารถระบุโดยใช้ชื่อ ซึ่งในกรณีนี้ระบบจะนำค่ามาจากสภาพแวดล้อมการเรียกใช้ หรือระบุโดยใช้คู่ชื่อ=ค่า ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ คุณใช้ตัวเลือกนี้ได้หลายครั้ง ตัวเลือกสําหรับตัวแปรเดียวกันจะเลือกตัวเลือกล่าสุด ส่วนตัวเลือกสําหรับตัวแปรต่างๆ จะรวมกัน
แท็ก:action_command_lines
--android_cpu=<a string>
ค่าเริ่มต้น: "armeabi-v7a"-
CPU เป้าหมายของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--[no]android_databinding_use_androidx
: "จริง" -
สร้างไฟล์การเชื่อมโยงข้อมูลที่เข้ากันได้กับ AndroidX ใช้กับ DataBinding v2 เท่านั้น Flag นี้ไม่มีผลใดๆ
แท็ก: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>
: "off" -
กำหนดว่าจะลิงก์ส่วน C++ ของกฎ Android แบบไดนามิกหรือไม่ เมื่อ cc_binary ไม่ได้สร้างไลบรารีที่ใช้ร่วมกันอย่างชัดแจ้ง "default" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "ทั้งหมด" หมายความว่าระบบจะลิงก์คลังทั้งหมดแบบไดนามิก "ปิด" หมายความว่าระบบจะลิงก์คลังทั้งหมดในโหมดคงที่ส่วนใหญ่
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "alphabetical" -
กำหนดลําดับของไฟล์ Manifest ที่ส่งไปยังเครื่องมือผสานไฟล์ Manifest สําหรับไบนารีของ Android อัลฟ่าหมายความว่าไฟล์ Manifest ได้รับการจัดเรียงตามเส้นทางที่สัมพันธ์กับผู้ดำเนินการ ALPHABETICAL_BY_CONFIGURATION หมายความว่าไฟล์ Manifest จะจัดเรียงตามเส้นทางที่สัมพันธ์กับไดเรกทอรีการกําหนดค่าภายในไดเรกทอรีเอาต์พุต DEPENDENCY หมายความว่าไฟล์ Manifest จะเรียงลำดับโดยให้ไฟล์ Manifest ของแต่ละไลบรารีอยู่ก่อนไฟล์ Manifest ของไลบรารีที่ต้องพึ่งพา
แท็ก:action_command_lines
,execution
--[no]android_resource_shrinking
ค่าเริ่มต้น: "false"-
เปิดใช้การย่อทรัพยากรสำหรับ APK android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
,loading_and_analysis
--[no]build_python_zip
ค่าเริ่มต้น: "auto"-
สร้างไฟล์ ZIP ที่เรียกใช้งานได้ของ Python เปิดใน Windows ปิดในแพลตฟอร์มอื่นๆ
แท็ก:affects_outputs
--catalyst_cpus=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple Catalyst
แท็ก:loses_incremental_state
,loading_and_analysis
- ค่าเริ่มต้น
--[no]collect_code_coverage
: "เท็จ" -
หากระบุไว้ Bazel จะใส่เครื่องมือวัดโค้ด (โดยใช้เครื่องมือวัดแบบออฟไลน์หากเป็นไปได้) และจะรวบรวมข้อมูลการครอบคลุมระหว่างการทดสอบ เฉพาะเป้าหมายที่ตรงกับ --instrumentation_filter จะได้รับผลกระทบ โดยปกติแล้ว คุณไม่ควรระบุตัวเลือกนี้โดยตรง แต่ควรใช้คำสั่ง "bazel coverage" แทน
แท็ก: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>
default: ดูคำอธิบาย-
ใช้ข้อมูลโปรไฟล์ CSFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อเส้นทางสัมบูรณ์ของไฟล์ ZIP ที่มีไฟล์โปรไฟล์, ไฟล์ข้อมูล RAW หรือไฟล์โปรไฟล์ LLVM ที่จัดทำดัชนีไว้
แท็ก:affects_outputs
--cs_fdo_instrument=<a string>
default: ดูคำอธิบาย-
สร้างไบนารีด้วยเครื่องมือ FDO ที่ละเอียดอ่อนตามบริบท เมื่อใช้คอมไพเลอร์ Clang/LLVM ระบบจะยอมรับชื่อไดเรกทอรีที่จะใช้วางไฟล์โปรไฟล์ดิบเมื่อรันไทม์ด้วย
แท็ก:affects_outputs
--cs_fdo_profile=<a build target label>
default: ดูคำอธิบาย-
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++ แบบไดนามิกหรือไม่ "default" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "โดยสมบูรณ์" หมายความว่าไลบรารีทั้งหมดจะมีการเชื่อมโยงแบบไดนามิก "ปิด" หมายความว่าระบบจะลิงก์คลังทั้งหมดในโหมดคงที่ส่วนใหญ่
แท็ก:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
ค่าเริ่มต้น: "true"-
หากตั้งค่าไว้ การใช้ fdo_absolute_profile_path จะทำให้เกิดข้อผิดพลาด
แท็ก:affects_outputs
- ค่าเริ่มต้น
--[no]enable_runfiles
: "อัตโนมัติ" -
เปิดใช้ต้นไม้สัญลักษณ์ลิงก์ของไฟล์รันไทม์ โดยค่าเริ่มต้นจะปิดอยู่ใน Windows และเปิดอยู่ในแพลตฟอร์มอื่นๆ
แท็ก:affects_outputs
--experimental_action_listener=<a build target label>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
เลิกใช้งานไปทีละด้าน ใช้ action_listener เพื่อแนบ extra_action กับการดำเนินการสร้างที่มีอยู่
แท็ก:execution
,experimental
--[no]experimental_android_compress_java_resources
ค่าเริ่มต้น: "false"-
บีบอัดทรัพยากร Java ใน APK
แท็ก:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
ค่าเริ่มต้น: "true"-
ใช้ Android Data Binding v2 Flag นี้ไม่มีผลใดๆ
แท็ก: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
ค่าเริ่มต้น: "false"-
ใช้เครื่องมือ rex เพื่อเขียนไฟล์ dex ใหม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
ค่าเริ่มต้น: "false"-
หากระบุ Bazel จะสร้างข้อมูลการครอบคลุมสำหรับไฟล์ที่สร้างขึ้นด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_objc_fastbuild_options=<comma-separated list of options>
: "-O0,-DDEBUG=1" -
ใช้สตริงเหล่านี้เป็นตัวเลือกคอมไพเลอร์ objc fastbuild
แท็ก:action_command_lines
--[no]experimental_omitfp
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" ระบบจะใช้ libunwind สำหรับการเลิกซ้อนของกอง และคอมไพล์ด้วย -fomit-frame-pointer และ -fasynchronous-unwind-tables
แท็ก:action_command_lines
,affects_outputs
,experimental
- ค่าเริ่มต้นของ
--experimental_output_paths=<off, content or strip>
: "off" -
รูปแบบที่จะใช้สำหรับตำแหน่งในกฎของต้นไม้เอาต์พุตที่จะเขียนเอาต์พุต โดยเฉพาะสำหรับบิลด์หลายแพลตฟอร์ม / หลายการกำหนดค่า ฟีเจอร์นี้อยู่ในขั้นทดลอง ดูรายละเอียดได้ที่ 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
ค่าเริ่มต้น: "false"-
หากเป็นจริง ระบบจะใช้ชื่อย่อของแพลตฟอร์มเป้าหมายในชื่อไดเรกทอรีเอาต์พุตแทน CPU รูปแบบที่แน่นอนเป็นรูปแบบทดลองและอาจมีการเปลี่ยนแปลงได้ ประการแรก ในบางกรณีที่ตัวเลือก --platforms ไม่มีค่าเพียงค่าเดียว ระบบจะใช้แฮชของตัวเลือกแพลตฟอร์ม ถัดไป หากมีชื่อย่อสำหรับแพลตฟอร์มปัจจุบันที่ลงทะเบียนโดย --experimental_override_name_platform_in_output_dir ระบบจะใช้ชื่อย่อนั้น จากนั้นหากตั้งค่า --experimental_use_platforms_in_output_dir_legacy_heuristic ให้ใช้ชื่อย่อตามป้ายกำกับแพลตฟอร์มปัจจุบัน สุดท้าย ระบบจะใช้แฮชของตัวเลือกแพลตฟอร์มเป็นทางเลือกสุดท้าย
แท็ก:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
ค่าเริ่มต้น: "false"-
หากระบุไว้ Bazel จะสร้างข้อมูลแผนที่การครอบคลุม llvm-cov แทน gcov เมื่อเปิดใช้ collect_code_coverage
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
: "จริง" -
โปรดใช้ Flag นี้เป็นส่วนหนึ่งของกลยุทธ์การย้ายข้อมูลหรือการทดสอบที่แนะนําเท่านั้น โปรดทราบว่าวิธีการเฮิวริสติกมีข้อบกพร่องที่ทราบอยู่แล้ว และเราขอแนะนำให้เปลี่ยนไปใช้เฉพาะ --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. หากระบุ Flag นี้ ระบบจะไม่สนใจ --android_cpu สำหรับข้อกำหนดของกฎ android_binary
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--[no]fat_apk_hwasan
: "เท็จ" -
สร้างการแยก HWASAN หรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--fdo_instrument=<a string>
: ดูคำอธิบาย -
สร้างไบนารีด้วยเครื่องมือ FDO เมื่อใช้คอมไพเลอร์ Clang/LLVM คีย์ดังกล่าวจะยอมรับชื่อไดเรกทอรีที่ระบบจะส่งออกไฟล์โปรไฟล์แบบ RAW ขณะรันไทม์ด้วย
แท็ก:affects_outputs
--fdo_optimize=<a string>
default: ดูคำอธิบาย-
ใช้ข้อมูลโปรไฟล์ FDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อไฟล์ ZIP ที่มีโครงสร้างไฟล์ .gcda, ไฟล์ afdo ที่มีโปรไฟล์อัตโนมัติ หรือไฟล์โปรไฟล์ LLVM นอกจากนี้ Flag นี้ยังยอมรับไฟล์ที่ระบุเป็นป้ายกำกับ (เช่น `//foo/bar:file.afdo` - คุณอาจต้องเพิ่มคำสั่ง `exports_files` ลงในแพ็กเกจที่เกี่ยวข้อง) และป้ายกำกับที่ชี้ไปยังเป้าหมาย `fdo_profile` ด้วย กฎ `fdo_profile` จะลบล้าง Flag นี้
แท็ก:affects_outputs
--fdo_prefetch_hints=<a build target label>
default: ดูคำอธิบาย-
ใช้คำแนะนำการดึงข้อมูลแคชล่วงหน้า
แท็ก: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
ค่าเริ่มต้น: "false"-
หากเปิดใช้ การคอมไพล์ C++ ทั้งหมดจะสร้างโค้ดที่ไม่ขึ้นอยู่กับตำแหน่ง ("-fPIC") ลิงก์จะใช้ไลบรารีที่สร้างไว้ล่วงหน้าของ PIC มากกว่าไลบรารีที่ไม่ใช่ PIC และลิงก์จะสร้างไฟล์ปฏิบัติการที่ไม่ขึ้นอยู่กับตำแหน่ง ("-พาย")
แท็ก:loading_and_analysis
,affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกําหนดค่าการดําเนินการ ตัวแปรสามารถระบุโดยใช้ชื่อ ซึ่งในกรณีนี้ระบบจะนำค่ามาจากสภาพแวดล้อมการเรียกใช้ หรือระบุโดยใช้คู่ชื่อ=ค่า ซึ่งจะตั้งค่าโดยไม่ขึ้นอยู่กับสภาพแวดล้อมการเรียกใช้ คุณใช้ตัวเลือกนี้ได้หลายครั้ง ตัวเลือกสําหรับตัวแปรเดียวกันจะเลือกตัวเลือกล่าสุด ส่วนตัวเลือกสําหรับตัวแปรต่างๆ จะรวมกัน
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--host_compilation_mode=<fastbuild, dbg or opt>
: "opt" -
ระบุโหมดที่จะใช้สร้างเครื่องมือที่ใช้ในระหว่างการสร้าง ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
,action_command_lines
--host_conlyopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยังคอมไพเลอร์ C เมื่อคอมไพล์ไฟล์ซอร์ส C (แต่ไม่ใช่ C++) ในการกำหนดค่า exec
แท็ก: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++ สําหรับเครื่องมือที่สร้างในการกําหนดค่า exec
แท็ก:action_command_lines
,affects_outputs
--host_features=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบบจะเปิดหรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างในการกําหนดค่า exec การระบุ -<feature> จะปิดใช้ฟีเจอร์ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ
แท็ก:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
default: ดูคำอธิบาย-
ลบล้างเวอร์ชัน Python สําหรับการกําหนดค่า exec อาจเป็น "PY2" หรือ "PY3"
แท็ก:loading_and_analysis
,affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_linkopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง linker เมื่อลิงก์เครื่องมือในการกําหนดค่า exec
แท็ก:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: ดูคำอธิบาย-
เวอร์ชัน macOS ที่เข้ากันได้ขั้นต่ำสำหรับเป้าหมายโฮสต์ หากไม่ระบุ ระบบจะใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมในการส่งไปยังคอมไพเลอร์ C/C++ แบบเลือกได้เมื่อคอมไพล์ไฟล์บางไฟล์ในการกําหนดค่า exec ตัวเลือกนี้ส่งได้หลายครั้ง รูปแบบคำสั่ง: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจากรายการรวมและไม่รวมรูปแบบนิพจน์ทั่วไป (ดูที่ --instrumentation_filter) ด้วย Option_1 กับ Option_n คือตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบ็กสแลชในเครื่องหมายคำพูดนั้น ตัวเลือกอาจมี @ แต่ระบบจะใช้เฉพาะ @ แรกในการแยกสตริง ตัวอย่างเช่น --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 จะเพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ลงในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
,affects_outputs
--host_swiftcopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยัง swiftc สําหรับเครื่องมือ exec
แท็ก:action_command_lines
,affects_outputs
--[no]incompatible_auto_exec_groups
ค่าเริ่มต้น: "false"-
เมื่อเปิดใช้ ระบบจะสร้างกลุ่ม exec โดยอัตโนมัติสําหรับเครื่องมือทางเทคนิคแต่ละรายการที่กฎใช้ กฎต้องระบุพารามิเตอร์ "toolchain" ในการดำเนินการเพื่อให้การทำงานนี้ได้ผล ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/17134
แท็ก:affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
ค่าเริ่มต้น: "true"-
หากเป็นจริง ระบบจะพับไดเรกทอรี Genfiles ลงในไดเรกทอรี Bin
แท็ก:affects_outputs
,incompatible_change
--[no]incompatible_use_host_features
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" ให้ใช้ --features สำหรับการกำหนดค่าเป้าหมายเท่านั้น และ --host_features สำหรับการกำหนดค่า exec
แท็ก:changes_inputs
,affects_outputs
,incompatible_change
--[no]instrument_test_targets
ค่าเริ่มต้น: "false"-
เมื่อเปิดใช้การครอบคลุม ให้ระบุว่าจะพิจารณาเครื่องมือวัดกฎการทดสอบหรือไม่ เมื่อตั้งค่าแล้ว ระบบจะเครื่องมือวัดกฎการทดสอบที่รวมโดย --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')>
default: ดูคำอธิบาย-
เวอร์ชัน iOS ขั้นต่ำที่เข้ากันได้สำหรับโปรแกรมจำลองและอุปกรณ์เป้าหมาย หากไม่ระบุ ระบบจะใช้ "ios_sdk_version"
แท็ก:loses_incremental_state
--ios_multi_cpus=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้าง ios_application ผลลัพธ์ที่ได้คือไบนารีแบบสากลที่มีสถาปัตยกรรมที่ระบุไว้ทั้งหมด
แท็ก:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
ค่าเริ่มต้น: "true"-
เลิกใช้งานแล้ว แทนที่ด้วย --incompatible_remove_legacy_whole_archive (ดูรายละเอียดที่ https://github.com/bazelbuild/bazel/issues/7362) เมื่อเปิดใช้ ให้ใช้ --whole-archive สำหรับกฎ cc_binary ที่มี linkshared=True และ linkstatic=True หรือ "-static" ใน linkopts ตัวเลือกนี้มีไว้เพื่อให้ใช้กับเวอร์ชันก่อนหน้าได้เท่านั้น วิธีอื่นที่ดีกว่าคือการใช้ alwayslink=1 ในที่ที่ต้องใช้
แท็ก:action_command_lines
,affects_outputs
,deprecated
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--linkopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc เมื่อลิงก์
แท็ก:action_command_lines
,affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--ltobackendopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมที่จะส่งไปยังขั้นตอนแบ็กเอนด์ LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
,affects_outputs
--ltoindexopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยังขั้นตอนการจัดทำดัชนี LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
,affects_outputs
--macos_cpus=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple macOS
แท็ก:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: ดูคำอธิบาย-
เวอร์ชัน macOS ขั้นต่ำที่เข้ากันได้สำหรับเป้าหมาย หากไม่ได้ระบุ ให้ใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
--memprof_profile=<a build target label>
default: ดูคำอธิบาย-
ใช้โปรไฟล์ memprof
แท็ก:affects_outputs
--[no]objc_debug_with_GLIBCXX
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้และตั้งค่าโหมดการคอมไพล์เป็น "dbg" ให้กําหนด GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC และ GLIBCPP_CONCEPT_CHECKS
แท็ก:action_command_lines
--[no]objc_enable_binary_stripping
ค่าเริ่มต้น: "false"-
กำหนดว่าจะทำการลบสัญลักษณ์และโค้ดที่ตายแล้วในไบนารีที่ลิงก์หรือไม่ ระบบจะลบไบนารีหากระบุทั้ง Flag และ --compilation_mode=opt นี้
แท็ก:action_command_lines
--objccopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมในการส่งไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ Objective-C/C++
แท็ก:action_command_lines
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมในการส่งไปยัง gcc แบบเลือกได้เมื่อคอมไพล์ไฟล์บางไฟล์ ตัวเลือกนี้ส่งได้หลายครั้ง รูปแบบคำสั่ง: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter หมายถึงรายการรูปแบบนิพจน์ทั่วไปที่รวมและไม่รวม (ดูที่ --instrumentation_filter ด้วย) option_1 ถึง option_n หมายถึงตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีคอมมา จะต้องใส่เครื่องหมายคำพูดด้วยเครื่องหมายแบ็กสแลช ตัวเลือกมี @ ได้ โดยระบบจะใช้เฉพาะ @ แรกในการแยกสตริง ตัวอย่างเช่น --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 จะเพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ลงในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
,affects_outputs
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งไปยังแบ็กเอนด์ LTO แบบเลือก (ในส่วน --features=thin_lto) เมื่อคอมไพล์ออบเจ็กต์แบ็กเอนด์บางรายการ ตัวเลือกนี้ส่งได้หลายครั้ง รูปแบบคำสั่ง: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจาก "รวมและยกเว้น" รูปแบบนิพจน์ทั่วไป ตัวเลือก_1 ถึง "ตัวเลือก_n" คือตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีคอมมา จะต้องใส่เครื่องหมายคำพูดด้วยเครื่องหมายแบ็กสแลช ตัวเลือกอาจมี @ แต่ระบบจะใช้เฉพาะ @ แรกในการแยกสตริง ตัวอย่างเช่น --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 จะเพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ลงในบรรทัดคำสั่งแบ็กเอนด์ LTO ของไฟล์ o ทั้งหมดใน //foo/ ยกเว้น bar.o
แท็ก:action_command_lines
,affects_outputs
--platform_suffix=<a string>
default: ดูคำอธิบาย-
ระบุส่วนต่อท้ายที่จะเพิ่มลงในไดเรกทอรีการกําหนดค่า
แท็ก:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
default: ดูคำอธิบาย-
ใช้ข้อมูลโปรไฟล์ของ Propeller เพื่อเพิ่มประสิทธิภาพเป้าหมายของบิลด์ โปรไฟล์ใบพัดต้องประกอบด้วยไฟล์อย่างน้อย 1 จาก 2 ไฟล์ ได้แก่ โปรไฟล์ CC และโปรไฟล์ ld Flag นี้ยอมรับป้ายกำกับบิลด์ซึ่งต้องอ้างอิงถึงไฟล์อินพุตโปรไฟล์ใบพัด เช่น ไฟล์ BUILD ที่กําหนดป้ายกํากับใน a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",) อาจต้องเพิ่มคําสั่ง exports_files ลงในแพ็กเกจที่เกี่ยวข้องเพื่อให้ Bazel เห็นไฟล์เหล่านี้ ตัวเลือกนี้ต้องใช้ในรูปแบบ --propeller_optimize=//a/b:propeller_profile
แท็ก:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
default: ดูคำอธิบาย-
ชื่อเส้นทางสัมบูรณ์ของไฟล์ cc_profile สำหรับบิลด์ Propeller Optimized
แท็ก:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
default: ดูคำอธิบาย-
ชื่อเส้นทางสัมบูรณ์ของไฟล์ ld_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพใบพัด
แท็ก:affects_outputs
--run_under=<a prefix in front of command>
default: ดูคำอธิบาย-
คำนำหน้าที่จะแทรกไว้ก่อนไฟล์ปฏิบัติการสำหรับคำสั่ง "test" และ "run" หากค่าคือ "foo -bar" และบรรทัดคำสั่งสำหรับการดำเนินการคือ "test_binary -baz" บรรทัดคำสั่งสุดท้ายคือ "foo -bar test_binary -baz" บรรทัดคำสั่งนี้อาจเป็นป้ายกำกับของเป้าหมายสั่งการได้ด้วย ตัวอย่างบางส่วน ได้แก่ "valgrind", "strace", "strace -c", "valgrind --quiet --num-callers=20", "//package:target", '//package:target --options'
แท็ก:action_command_lines
-
หากเป็น "จริง" ระบบจะแชร์ไลบรารีเนทีฟที่มีฟังก์ชันการทำงานเหมือนกันระหว่างเป้าหมายต่างๆ
แท็ก:loading_and_analysis
,affects_outputs
--[no]stamp
ค่าเริ่มต้น: "false"-
ประทับไบนารีด้วยวันที่ ชื่อผู้ใช้ ชื่อโฮสต์ ข้อมูลพื้นที่ทำงาน ฯลฯ
แท็ก:affects_outputs
--strip=<always, sometimes or never>
ค่าเริ่มต้น: "บางครั้ง"-
ระบุว่าจะลบข้อมูลโค้ดที่ไม่จำเป็นในไฟล์ไบนารีและไลบรารีที่ใช้ร่วมกันหรือไม่ (โดยใช้ "-Wl,--strip-debug") ค่าเริ่มต้น "บางครั้ง" หมายถึง Strip iff --compilation_mode=fastbuild
แท็ก:affects_outputs
--stripopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมในการส่งไปยังการแยกเมื่อสร้างไบนารี "<name>.strped"
แท็ก:action_command_lines
,affects_outputs
--swiftcopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตัวเลือกเพิ่มเติมที่จะส่งไปยังการคอมไพล์ Swift
แท็ก:action_command_lines
--tvos_cpus=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารี Apple tvOS
แท็ก:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: ดูคำอธิบาย-
เวอร์ชัน 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')>
default: ดูคำอธิบาย-
เวอร์ชัน watchOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองและอุปกรณ์เป้าหมาย หากไม่ได้ระบุ ให้ใช้ "watchos_sdk_version"
แท็ก:loses_incremental_state
--xbinary_fdo=<a build target label>
default: ดูคำอธิบาย-
ใช้ข้อมูลโปรไฟล์ XbinaryFDO เพื่อเพิ่มประสิทธิภาพการคอมไพล์ ระบุชื่อโปรไฟล์ข้ามไบนารีเริ่มต้น เมื่อใช้ตัวเลือกนี้ร่วมกับ --fdo_instrument/--fdo_optimize/--fdo_profile ตัวเลือกเหล่านั้นจะมีผลเหนือกว่าเสมอเสมือนว่าไม่ได้ระบุ xbinary_fdo
แท็ก:affects_outputs
- ตัวเลือกที่ส่งผลต่อความเข้มงวดที่ Bazel ใช้บังคับอินพุตการสร้างที่ถูกต้อง (คําจํากัดความของกฎ ชุดค่าผสมของ Flag ฯลฯ)
--auto_cpu_environment_group=<a build target label>
ค่าเริ่มต้น: ""-
ประกาศ environment_group ที่จะใช้สําหรับการแมปค่า cpu กับค่า target_environment โดยอัตโนมัติ
แท็ก:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
ค่าเริ่มต้น: "false"-
ตรวจสอบว่าข้อจำกัดการอนุญาตให้ใช้สิทธิที่แพ็กเกจที่ต้องพึ่งพากำหนดไว้ไม่ขัดแย้งกับโหมดการจัดจำหน่ายของเป้าหมายที่สร้าง โดยค่าเริ่มต้น ใบอนุญาตจะไม่ได้รับการตรวจสอบ
แท็ก:build_file_semantics
--[no]check_visibility
ค่าเริ่มต้น: "true"-
หากปิดใช้ ระบบจะลดระดับข้อผิดพลาดเกี่ยวกับระดับการเข้าถึงในทรัพยากร Dependency เป้าหมายเป็นคำเตือน
แท็ก:build_file_semantics
--[no]desugar_for_android
ค่าเริ่มต้น: "true"-
กำหนดว่าจะถอด Sugar ออกจาก Bytecode ของ Java 8 ก่อนการแยกไฟล์หรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
ค่าเริ่มต้น: "false"-
กำหนดว่าจะรวมไลบรารี Java 8 ที่รองรับไว้ในแอปสำหรับอุปกรณ์เดิมหรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
ค่าเริ่มต้น: "true"-
ตรวจสอบสภาพแวดล้อมที่เป้าหมายแต่ละรายการเข้ากันได้ และรายงานข้อผิดพลาดหากเป้าหมายใดมีทรัพยากร Dependencies ที่ไม่รองรับสภาพแวดล้อมเดียวกัน
แท็ก:build_file_semantics
--[no]experimental_check_desugar_deps
ค่าเริ่มต้น: "true"-
กำหนดว่าจะตรวจสอบการลดน้ำตาลที่ถูกต้องอีกครั้งที่ระดับไบนารีของ Android หรือไม่
แท็ก:eagerness_to_exit
,loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--experimental_import_deps_checking=<off, warning or error>
: "OFF" -
เมื่อเปิดใช้แล้ว ให้ตรวจสอบว่ารายการอ้างอิงของ aar_import สมบูรณ์หรือไม่ การบังคับใช้นี้อาจทำให้บิลด์ใช้งานไม่ได้ หรืออาจส่งผลให้เกิดคำเตือนเท่านั้น
แท็ก:loading_and_analysis
--experimental_one_version_enforcement=<off, warning or error>
ค่าเริ่มต้น: "OFF"-
เมื่อเปิดใช้ กฎ java_binary จะต้องไม่มีไฟล์คลาสเดียวกันใน classpath มากกว่า 1 เวอร์ชัน การบังคับใช้นี้อาจทำให้บิลด์เสียหายหรือเพียงแค่ส่งผลให้มีคำเตือน
แท็ก:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
ค่าเริ่มต้น: "default"-
หากเป็นจริง ให้ตรวจสอบว่าเป้าหมาย Java ประกาศเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency อย่างชัดแจ้ง
แท็ก:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
ค่าเริ่มต้น: "false"-
หากเปิดใช้แล้ว ให้ตรวจสอบ testonly สำหรับเป้าหมายเบื้องต้นที่เป็นไฟล์เอาต์พุตโดยค้นหา testonly ของกฎที่สร้าง รายการนี้ตรงกับการตรวจสอบระดับการเข้าถึง
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
ค่าเริ่มต้น: "false"-
หากเปิดใช้ การตรวจสอบระดับการเข้าถึงจะมีผลกับการติดตั้งใช้งาน Toolchain ด้วย
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
ค่าเริ่มต้น: "false"-
หากเปิดใช้ ระบบจะปิดใช้การใช้กฎ Android ดั้งเดิมโดยตรง โปรดใช้กฎ Starlark สำหรับ Android จาก https://github.com/bazelbuild/rules_android
แท็ก:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
ค่าเริ่มต้น: "false"-
ไม่ต้องดำเนินการ เก็บไว้ที่นี่สำหรับความเข้ากันได้แบบย้อนหลัง
แท็ก:eagerness_to_exit
,incompatible_change
--[no]incompatible_python_disable_py2
ค่าเริ่มต้น: "true"-
หากเป็นจริง การใช้การตั้งค่า Python 2 จะทำให้เกิดข้อผิดพลาด ซึ่งรวมถึง python_version=PY2, srcs_version=PY2 และ srcs_version=PY2ONLY ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/15684
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" Bazel จะตรวจสอบการรวมส่วนหัวของไดเรกทอรีระดับบนสุดด้วย (ดูข้อมูลเพิ่มเติมที่ https://github.com/bazelbuild/bazel/issues/10047)
แท็ก:loading_and_analysis
,incompatible_change
--[no]one_version_enforcement_on_java_tests
ค่าเริ่มต้น: "true"-
เมื่อเปิดใช้และตั้งค่า experimental_one_version_enforcement เป็นค่าที่ไม่ใช่ NONE ให้บังคับใช้เวอร์ชันเดียวในเป้าหมาย java_test คุณปิดใช้ Flag นี้เพื่อปรับปรุงประสิทธิภาพการทดสอบที่เพิ่มขึ้นได้ แต่อาจพลาดการละเมิดเวอร์ชันเดียวที่อาจเกิดขึ้น
แท็ก: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
ค่าเริ่มต้น: "false"-
หากเปิดใช้ตัวเลือกนี้ ระบบจะรายงานไฟล์เซ็ตที่ข้ามขอบเขตแพ็กเกจเป็นข้อผิดพลาด
แท็ก:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
ค่าเริ่มต้น: "error"-
ตรวจสอบว่าเป้าหมาย proto_library ประกาศเป้าหมายทั้งหมดที่ใช้โดยตรงเป็น Dependency อย่างชัดแจ้ง เว้นแต่ว่าจะเป็น OFF
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้นของ
--strict_public_imports=<off, warn, error, strict or default>
: "ปิด" -
ยกเว้นในกรณีที่ปิดอยู่ ระบบจะตรวจสอบว่าเป้าหมาย proto_library ประกาศเป้าหมายทั้งหมดที่ใช้ใน "import public" เป็นการนําส่งอย่างชัดแจ้ง
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้น
--[no]strict_system_includes
: "เท็จ" -
หากเป็น "จริง" จะต้องประกาศส่วนหัวที่พบผ่านเส้นทางรวมของระบบ (-isystem) ด้วย
แท็ก:loading_and_analysis
,eagerness_to_exit
--target_environment=<a build target label>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ประกาศสภาพแวดล้อมเป้าหมายของบิลด์นี้ ต้องเป็นการอ้างอิงป้ายกำกับไปยังกฎ "environment" หากระบุไว้ เป้าหมายระดับบนสุดทั้งหมดต้องเข้ากันได้กับสภาพแวดล้อมนี้
แท็ก: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"-
หากตั้งค่าไว้และโหมดการคอมไพล์ไม่ใช่ "opt" แอป objc จะรวมการให้สิทธิ์แก้ไขข้อบกพร่องเมื่อลงชื่อ
แท็ก:changes_inputs
--ios_signing_cert_name=<a string>
default: ดูคำอธิบาย-
ชื่อใบรับรองที่จะใช้สำหรับการลงนาม iOS หากไม่ได้ตั้งค่าไว้ ระบบจะใช้โปรไฟล์การจัดสรรแทน อาจเป็นค่ากำหนดข้อมูลระบุตัวตนในพวงกุญแจของใบรับรองหรือ (สตริงย่อย) ของชื่อจริงของใบรับรอง ตามหน้าข้อมูลของ codesign (ข้อมูลระบุตัวตนสำหรับการลงนาม)
แท็ก:action_command_lines
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือบิลด์ที่เข้าถึงโดยไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE
--[no]incompatible_config_setting_private_default_visibility
ค่าเริ่มต้น: "false"-
หาก incompatible_enforce_config_setting_visibility=false จะไม่มีการดำเนินการใดๆ หรือหาก Flag นี้เป็นเท็จ config_setting ที่ไม่มีแอตทริบิวต์ระดับการมองเห็นที่ชัดเจนจะเป็น //visibility:public หาก Flag นี้เป็น "จริง" config_setting จะใช้ตรรกะการแสดงผลเดียวกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_legacy_py_provider
ค่าเริ่มต้น: "true"-
ไม่มีการดำเนินการใดๆ ระบบจะนำออกในเร็วๆ นี้
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" ไม่อนุญาตแอตทริบิวต์ sdk_frameworks และ external_sdk_frameworks ใน objc_library andobjc_import
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
ค่าเริ่มต้น: "true"-
หากเป็นจริง ให้บังคับใช้การจำกัดระดับการเข้าถึง config_setting หากเป็น "เท็จ" ทุก config_setting จะปรากฏแก่เป้าหมายทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" ให้ตั้งค่าเริ่มต้นเป็น "จริง" สําหรับแอตทริบิวต์ alwayslink ใน objc_library และ objc_import
แท็ก:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
ค่าเริ่มต้น: "false"-
เมื่อเป็น "จริง" ระบบจะแสดงข้อผิดพลาดเมื่อใช้กฎ py_* ในตัว คุณควรใช้กฎ rule_python แทน ดูข้อมูลเพิ่มเติมและวิธีการย้ายข้อมูลได้ที่ https://github.com/bazelbuild/bazel/issues/17773
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่ควบคุมลักษณะการทํางานของสภาพแวดล้อมการทดสอบหรือโปรแกรมรันทดสอบ
- ค่าเริ่มต้น
--[no]allow_analysis_failures
: "เท็จ" -
หากเป็น "จริง" การวิเคราะห์เป้าหมายของกฎที่ล้มเหลวจะส่งผลให้เป้าหมายเผยแพร่อินสแตนซ์ของ AnalysisFailureInfo ที่มีคำอธิบายข้อผิดพลาดแทนที่จะส่งผลให้การบิลด์ล้มเหลว
แท็ก:loading_and_analysis
,experimental
--analysis_testing_deps_limit=<an integer>
ค่าเริ่มต้น: "2000"-
กำหนดจำนวนสูงสุดของความสัมพันธ์แบบสื่อกลางผ่านแอตทริบิวต์กฎที่มีการเปลี่ยนการกำหนดค่า for_analysis_testing เกินขีดจำกัดนี้จะทำให้เกิดข้อผิดพลาดของกฎ
แท็ก:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
ค่าเริ่มต้น: "false"-
หากเป็นจริง การดำเนินการ dex2oat ที่ล้มเหลวจะทำให้บิลด์หยุดทำงานแทนที่จะเรียกใช้ dex2oat ในระหว่างรันไทม์การทดสอบ
แท็ก:loading_and_analysis
,experimental
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g. memory=10,30,60,100>
รายการ - ลบล้างจำนวนทรัพยากรเริ่มต้นสำหรับการทดสอบ รูปแบบที่รองรับคือ <resource>=<value> หากระบุตัวเลขบวกเพียงค่าเดียวเป็น <value> ระบบจะลบล้างทรัพยากรเริ่มต้นสำหรับขนาดการทดสอบทั้งหมด หากระบุตัวเลข 4 รายการที่คั่นด้วยคอมมา ระบบจะลบล้างจำนวนทรัพยากรสําหรับขนาดการทดสอบขนาดเล็ก กลาง ใหญ่ และใหญ่มากตามลําดับ ค่าอาจเป็น HOST_RAM/HOST_CPU ตามด้วย [-|*]<float> (ไม่บังคับ) ก็ได้ (เช่น memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4) ทรัพยากรการทดสอบเริ่มต้นที่ระบุโดยแฟล็กนี้จะถูกลบล้างโดยทรัพยากรที่อาจไม่เหมาะสมซึ่งระบุไว้ในแท็ก
- ค่าเริ่มต้น
--[no]experimental_android_use_parallel_dex2oat
: "เท็จ" -
ใช้ dex2oat ควบคู่กันเพื่อเพิ่มความเร็วของ android_test
แท็ก:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
ค่าเริ่มต้น: "false"-
เปิดใช้การตรวจสอบการรั่วไหลของหน่วยความจำในเป้าหมาย ios_test
แท็ก:action_command_lines
--ios_simulator_device=<a string>
default: ดูคำอธิบาย-
อุปกรณ์ที่จะจําลองเมื่อเรียกใช้แอปพลิเคชัน iOS ในโปรแกรมจําลอง เช่น "iPhone 6" คุณสามารถดูรายการอุปกรณ์ได้โดยเรียกใช้ "xcrun simctl list devicetypes" ในเครื่องที่เครื่องจำลองจะทำงาน
แท็ก:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: ดูคำอธิบาย-
เวอร์ชัน iOS ที่จะใช้งานบนเครื่องจำลองเมื่อเรียกใช้หรือทดสอบ ระบบจะละเว้นค่านี้สำหรับกฎ ios_test หากมีการระบุอุปกรณ์เป้าหมายในกฎ
แท็ก:test_runner
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ระบุจำนวนครั้งในการทำการทดสอบแต่ละครั้ง หากการดำเนินการเหล่านั้นล้มเหลวไม่ว่าด้วยเหตุผลใดก็ตาม จะถือว่าการทดสอบทั้งหมดไม่ผ่าน โดยปกติแล้วค่าที่ระบุจะเป็นจํานวนเต็มเท่านั้น ตัวอย่างเช่น --runs_per_test=3 จะเรียกใช้การทดสอบทั้งหมด 3 ครั้ง ไวยากรณ์สำรอง: regex_filter@runs_per_test โดยที่ runs_per_test หมายถึงค่าจำนวนเต็ม และ regex_filter หมายถึงรายการรูปแบบนิพจน์ทั่วไปที่รวมและไม่รวม (ดู --instrumentation_filter ด้วย) ตัวอย่างเช่น --runs_per_test=//foo/.*,-//foo/bar/.*@3 เรียกใช้การทดสอบทั้งหมดใน //foo/ ยกเว้นการทดสอบที่อยู่ใน foo/bar 3 ครั้ง ตัวเลือกนี้ส่งได้หลายครั้ง อาร์กิวเมนต์ที่ตรงกันซึ่งส่งล่าสุดจะมีความสําคัญเหนือกว่า หากไม่มีผลลัพธ์ที่ตรงกัน ระบบจะทำการทดสอบเพียงครั้งเดียว
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--test_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุตัวแปรสภาพแวดล้อมเพิ่มเติมที่จะแทรกลงในสภาพแวดล้อมโปรแกรมรันทดสอบ คุณระบุตัวแปรได้โดยใช้ชื่อ ซึ่งในกรณีนี้ระบบจะอ่านค่าของตัวแปรจากสภาพแวดล้อมไคลเอ็นต์ Bazel หรือด้วยคู่ชื่อ=ค่า คุณใช้ตัวเลือกนี้หลายครั้งเพื่อระบุตัวแปรหลายรายการได้ ใช้โดยคำสั่ง "bazel test" เท่านั้น
แท็ก:test_runner
- ค่าเริ่มต้นของ
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - ลบล้างค่าระยะหมดเวลาในการทดสอบเริ่มต้นสำหรับระยะหมดเวลาทดสอบ (เป็นวินาที) หากระบุค่าจำนวนเต็มบวกเพียงค่าเดียว ระบบจะลบล้างหมวดหมู่ทั้งหมด หากระบุจำนวนเต็ม 4 รายการที่คั่นด้วยคอมมา ระบบจะลบล้างการหมดเวลาสำหรับระยะสั้น ปานกลาง ยาว และตลอดไป (ตามลำดับ) ไม่ว่ารูปแบบใด ค่า -1 จะบอกให้ Blaze ใช้การหมดเวลาเริ่มต้นสำหรับหมวดหมู่นั้น
- ค่าเริ่มต้น
--[no]zip_undeclared_test_outputs
: "จริง" -
หากเป็น "จริง" ระบบจะเก็บถาวรเอาต์พุตการทดสอบที่ไม่ได้ประกาศไว้ในไฟล์ ZIP
แท็ก:test_runner
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--repo=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
เฉพาะผู้ให้บริการที่เก็บข้อมูลที่ระบุ ซึ่งอาจเป็น@apparent_repo_name หรือ@@canonical_repo_name ตัวเลือกนี้ตั้งค่าได้หลายครั้ง
แท็ก:changes_inputs
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพของเวลาสร้าง
--[no]experimental_filter_library_jar_with_program_jar
ค่าเริ่มต้น: "false"-
กรอง ProGuard ProgramJar เพื่อนำชั้นเรียนที่อยู่ใน LibraryJar ออกด้วย
แท็ก:action_command_lines
- ค่าเริ่มต้น
--[no]experimental_inmemory_dotd_files
: "จริง" -
หากเปิดใช้ ระบบจะส่งไฟล์ .d ของ C++ ในหน่วยความจำจากโหนดการสร้างระยะไกลโดยตรงแทนที่จะเขียนลงในดิสก์
แท็ก:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
ค่าเริ่มต้น: "true"-
หากเปิดใช้ ระบบจะส่งไฟล์ที่ต้องพึ่งพา (.jdeps) ที่สร้างขึ้นจากการคอมไพล์ Java ผ่านหน่วยความจำจากโหนดการสร้างระยะไกลโดยตรงแทนที่จะเขียนลงในดิสก์
แท็ก:loading_and_analysis
,execution
,affects_outputs
,experimental
- ค่าเริ่มต้น
--[no]experimental_objc_include_scanning
: "เท็จ" -
กำหนดว่าจะทำการสแกนรวมสำหรับ Objective C/C++ หรือไม่
แท็ก:loading_and_analysis
,execution
,changes_inputs
--[no]experimental_retain_test_configuration_across_testonly
ค่าเริ่มต้น: "false"-
เมื่อเปิดใช้ --trim_test_configuration จะไม่ตัดการกำหนดค่าการทดสอบสำหรับกฎที่มีการทำเครื่องหมาย testonly=1 การดำเนินการนี้มีไว้เพื่อลดปัญหาการขัดแย้งของการดำเนินการเมื่อกฎที่ไม่ใช่การทดสอบขึ้นอยู่กับกฎ cc_test จะไม่มีผลหาก --trim_test_configuration เป็นเท็จ
แท็ก:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
ค่าเริ่มต้น: "false"-
หากเปิดใช้ คุณจะสามารถใช้ cc_import เวอร์ชัน Starlark ได้
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้น
--[no]experimental_unsupported_and_brittle_include_scanning
: "เท็จ" -
การจำกัดอินพุตให้แคบลงสำหรับการคอมไพล์ C/C++ โดยการแยกวิเคราะห์บรรทัด #include จากไฟล์อินพุต ซึ่งจะช่วยปรับปรุงประสิทธิภาพและส่วนเพิ่มด้วยการลดขนาดของแผนผังอินพุตสำหรับการคอมไพล์ อย่างไรก็ตาม การดำเนินการนี้อาจทำให้บิลด์ใช้งานไม่ได้เนื่องจากเครื่องมือสแกนรวมไม่ได้ใช้ความหมายของ C preprocessor อย่างเต็มรูปแบบ โดยเฉพาะอย่างยิ่ง จะไม่เข้าใจคำสั่ง #include แบบไดนามิกและไม่สนใจตรรกะแบบมีเงื่อนไขของโปรแกรมประมวลผลข้อมูลล่วงหน้า คุณต้องรับความเสี่ยงของการใช้งานเอง เราจะปิดปัญหาทั้งหมดที่เกี่ยวข้องกับการแจ้งว่าไม่เหมาะสมนี้
แท็ก:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
ค่าเริ่มต้น: "true"-
ทํางานส่วนใหญ่สําหรับการจัดทําดัชนีแยกกันสําหรับไฟล์ Jar แต่ละไฟล์
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
ค่าเริ่มต้น: "true"-
หากตั้งค่าไว้ ระบบจะใช้ไฟล์ .d ที่ clang สร้างขึ้นเพื่อตัดชุดอินพุตที่ส่งไปยังการคอมไพล์ objc
แท็ก:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
ค่าเริ่มต้น: "false"-
เมื่อสร้างเป้าหมาย //a:a ให้ประมวลผลส่วนหัวในเป้าหมายทั้งหมดที่ //a:a นั้นใช้ (หากเปิดใช้การประมวลผลส่วนหัวสําหรับเครื่องมือทางเทคนิค)
แท็ก: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>
: "-.*" -
พิมพ์ข้อมูลการแก้ไขข้อบกพร่องระหว่างการแก้ไขเครื่องมือ Flag จะใช้นิพจน์ทั่วไป ซึ่งจะตรวจสอบกับประเภทเครื่องมือและเป้าหมายที่เฉพาะเจาะจงเพื่อดูว่าควรแก้ไขข้อบกพร่องรายการใด คุณคั่นนิพจน์ทั่วไปหลายรายการด้วยคอมมา จากนั้นระบบจะตรวจสอบนิพจน์ทั่วไปแต่ละรายการแยกกัน หมายเหตุ: เอาต์พุตของ Flag นี้จะซับซ้อนมากและอาจเป็นประโยชน์ต่อผู้เชี่ยวชาญในการแก้ปัญหาเกี่ยวกับเครื่องมือทางเทคนิคเท่านั้น
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปสำหรับคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--flag_alias=<a 'name=value' flag alias>
รายการ -
ตั้งชื่อแบบย่อสำหรับแฟล็ก Starlark โดยจะใช้คู่คีย์-ค่าเดียวในรูปแบบ "<key>=<value>" เป็นอาร์กิวเมนต์
แท็ก:changes_inputs
- ค่าเริ่มต้น
--[no]incompatible_default_to_explicit_init_py
: "เท็จ" -
Flag นี้จะเปลี่ยนลักษณะการทำงานเริ่มต้นเพื่อไม่ให้ระบบสร้างไฟล์ __init__.py โดยอัตโนมัติในไฟล์รันไทม์ของเป้าหมาย Python อีกต่อไป กล่าวโดยละเอียดคือ เมื่อเป้าหมาย py_binary หรือ py_test มีการตั้งค่า legacy_create_init เป็น "auto" (ค่าเริ่มต้น) ระบบจะถือว่าค่านี้เป็นเท็จก็ต่อเมื่อมีการตั้งค่า Flag นี้เท่านั้น ดู https://github.com/bazelbuild/bazel/issues/10076
แท็ก:affects_outputs
,incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_py2_outputs_are_suffixed
: "จริง" -
หากเป็น "จริง" เป้าหมายที่สร้างในการกําหนดค่า 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 หากคุณตั้งค่า Flag นี้ เราขอแนะนำให้ตั้งค่า `--incompatible_py2_outputs_are_suffixed` ด้วยเช่นกัน
แท็ก:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
ค่าเริ่มต้น: "true"-
หากตั้งค่าเป็น "จริง" กฎ Python ในเครื่องที่เป็นไฟล์ปฏิบัติการจะใช้รันไทม์ของ Python ที่ระบุโดย Toolchain ของ Python แทนรันไทม์ที่กำหนดโดย Flag เดิม เช่น --python_top
แท็ก:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
default: ดูคำอธิบาย-
โหมดเวอร์ชันหลักของ Python ซึ่งอาจเป็น "PY2" หรือ "PY3" โปรดทราบว่าเป้าหมาย "py_binary" และ "py_test" จะลบล้างค่านี้ (แม้ว่าจะไม่ระบุเวอร์ชันอย่างชัดเจนก็ตาม) ดังนั้นจึงไม่ค่อยมีเหตุผลที่จะต้องระบุ Flag นี้
แท็ก:loading_and_analysis
,affects_outputs
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้
--[no]cache_test_results
[-t
] ค่าเริ่มต้น: "อัตโนมัติ"- หากตั้งค่าเป็น "auto" ไว้ Bazel จะทำการทดสอบอีกครั้งก็ต่อเมื่อ (1) Bazel ตรวจพบการเปลี่ยนแปลงในการทดสอบหรือข้อมูลที่ต้องพึ่งพา (2) มีการทําเครื่องหมายการทดสอบว่าเป็นแบบภายนอก (3) มีคำขอการทดสอบหลายรายการด้วย --runs_per_test หรือ(4) การทดสอบก่อนหน้านี้ไม่สําเร็จ หากตั้งค่าเป็น "ใช่" Bazel จะแคชผลการทดสอบทั้งหมดยกเว้นการทดสอบที่ทำเครื่องหมายว่าภายนอก หากตั้งค่าเป็น "ไม่" Bazel จะไม่แคชผลการทดสอบใดๆ
--deleted_packages=<comma-separated list of package names>
ระบบจะรวบรวมการใช้งานหลายครั้ง- รายการชื่อแพ็กเกจที่คั่นด้วยคอมมา ซึ่งระบบบิลด์จะถือว่าไม่มีอยู่ แม้ว่าจะปรากฏในเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ ตัวอย่างเช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์แล้ว ระบบบิลด์อาจแสดงข้อผิดพลาดหากพบป้ายกำกับ "//x:y/z" หากยังมีรายการ package_path อื่นระบุอยู่ การระบุ --deleted_packages x/y จะช่วยหลีกเลี่ยงปัญหานี้ได้
--[no]experimental_cancel_concurrent_tests
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" Blaze จะยกเลิกการทดสอบที่ทํางานพร้อมกันเมื่อการเรียกใช้ครั้งแรกสําเร็จ ซึ่งมีประโยชน์เมื่อใช้ร่วมกับ --runs_per_test_detects_flakes เท่านั้น
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" Bazel จะดึงข้อมูลไดเรกทอรีข้อมูลการครอบคลุมทั้งหมดสำหรับการทดสอบแต่ละครั้งระหว่างการทำงานของการครอบคลุม
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--[no]experimental_generate_llvm_lcov
: "เท็จ" -
หากเป็น "จริง" การครอบคลุมสำหรับ clang จะสร้างรายงาน LCOV
แท็ก:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
ค่าเริ่มต้น: "true"- สร้างแผนที่ส่วนหัว J2ObjC ควบคู่กับการแปลง J2ObjC หรือไม่
--[no]experimental_j2objc_shorter_header_path
ค่าเริ่มต้น: "false"-
Whether to generate with shorter header path (uses "_ios" instead of "_j2objc").
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_java_classpath=<off, javabuilder or bazel>
: "javabuilder" - เปิดใช้เส้นทางคลาสที่ลดลงสำหรับการคอมไพล์ Java
--[no]experimental_limit_android_lint_to_android_constrained_java
ค่าเริ่มต้น: "false"-
จำกัด --experimental_run_android_lint_on_java_rules ไว้สำหรับไลบรารีที่เข้ากันได้กับ Android
แท็ก:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
ค่าเริ่มต้น: "false"-
กำหนดว่าจะตรวจสอบแหล่งที่มา java_* หรือไม่
แท็ก:affects_outputs
--[no]explicit_java_test_deps
ค่าเริ่มต้น: "false"- ระบุการพึ่งพา JUnit หรือ Hamcrest ใน java_test อย่างชัดเจนแทนที่จะรับจาก deps ของ TestRunner โดยไม่ได้ตั้งใจ ตอนนี้ใช้ได้กับ bazel เท่านั้น
- ค่าเริ่มต้น
--[no]fetch
: "จริง" - อนุญาตให้คําสั่งดึงข้อมูลการอ้างอิงภายนอก หากตั้งค่าเป็นเท็จ คำสั่งจะใช้ทรัพยากร Dependency เวอร์ชันที่แคชไว้ หากไม่มี คำสั่งจะดำเนินการไม่สำเร็จ
--host_java_launcher=<a build target label>
default: ดูคำอธิบาย- ตัวเปิด Java ที่เครื่องมือใช้ในระหว่างการบิลด์
--host_javacopt=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง Javac เมื่อสร้างเครื่องมือที่ดำเนินการระหว่างบิลด์
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--host_jvmopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมที่จะส่งไปยัง VM ของ Java เมื่อสร้างเครื่องมือที่จะดำเนินการระหว่างการบิลด์ ระบบจะเพิ่มตัวเลือกเหล่านี้ลงในตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
--[no]incompatible_check_sharding_support
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" Bazel จะทดสอบแบบแยกกลุ่มไม่สำเร็จหากเครื่องมือรันทดสอบไม่ได้ระบุว่ารองรับการแยกกลุ่มโดยแตะไฟล์ที่เส้นทางใน TEST_SHARD_STATUS_FILE หากเป็นเท็จ เครื่องมือรันทดสอบที่ไม่รองรับการแยกกลุ่มจะทำให้การทดสอบทั้งหมดทำงานในแต่ละกลุ่ม
แท็ก:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
ค่าเริ่มต้น: "true"-
หากเป็น "จริง" การทดสอบเฉพาะจะทํางานด้วยกลยุทธ์ที่ใช้แซนด์บ็อกซ์ เพิ่มแท็ก "local" เพื่อบังคับให้ทำการทดสอบแบบพิเศษในเครื่อง
แท็ก:incompatible_change
- ค่าเริ่มต้น
--[no]incompatible_strict_action_env
: "เท็จ" -
หากเป็น "จริง" Bazel จะใช้สภาพแวดล้อมที่มีค่าแบบคงที่สำหรับ PATH และไม่รับค่า LD_LIBRARY_PATH ไป ใช้ --action_env=ENV_VARIABLE หากคุณต้องการรับตัวแปรสภาพแวดล้อมที่เฉพาะเจาะจงจากไคลเอ็นต์ แต่โปรดทราบว่าการทำเช่นนี้อาจป้องกันการแคชข้ามผู้ใช้ได้หากมีการใช้แคชที่แชร์
แท็ก:loading_and_analysis
,incompatible_change
--j2objc_translation_flags=<comma-separated list of options>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ตัวเลือกเพิ่มเติมที่จะส่งไปยังเครื่องมือ J2ObjC
--java_debug
-
ทำให้เครื่องเสมือนของ Java ของการทดสอบ Java ต้องรอการเชื่อมต่อจากโปรแกรมแก้ไขข้อบกพร่องที่สอดคล้องกับ JDWP (เช่น jdb) ก่อนเริ่มการทดสอบ บอกเป็นนัยว่า -test_output=streamed
ขยายเป็น
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
ค่าเริ่มต้น: "true"- สร้างข้อมูลทรัพยากร Dependency (ในขณะนี้คือคลาสพาธเวลาคอมไพล์) ต่อเป้าหมาย Java
--[no]java_header_compilation
ค่าเริ่มต้น: "true"- คอมไพล์จากต้นทางโดยตรง
--java_language_version=<a string>
ค่าเริ่มต้น: ""- เวอร์ชันภาษา Java
--java_launcher=<a build target label>
default: ดูคำอธิบาย- 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>
default: ดูคำอธิบาย- ระบุไบนารีที่จะใช้สร้างรายการคลาสที่ต้องอยู่ใน Dex หลักเมื่อคอมไพล์ MultiDex รุ่นเดิม
--optimizing_dexer=<a build target label>
default: ดูคำอธิบาย- ระบุไบนารีที่จะใช้ในการจัดทําดัชนีโดยไม่มีการแยกข้อมูล
--package_path=<colon-separated list of options>
ค่าเริ่มต้น: "%workspace%"- รายการตำแหน่งที่จะค้นหาแพ็กเกจที่คั่นด้วยโคลอน องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับพื้นที่ทำงานที่ล้อมรอบอยู่ หากละเว้นหรือว่างเปล่า ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
--plugin=<a build target label>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ปลั๊กอินที่จะใช้ในบิลด์ ปัจจุบันใช้งานได้กับ java_plugin
--proguard_top=<a build target label>
default: ดูคำอธิบาย- ระบุเวอร์ชันของ ProGuard ที่จะใช้สำหรับการนำโค้ดออกเมื่อสร้างไบนารี Java
--proto_compiler=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/proto:protoc"-
ป้ายกำกับของคอมไพเลอร์โปรโต
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/proto:cc_toolchain"-
ป้ายกำกับของ protocol_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ C++ Proto
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ j2objc protos
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/protocol:java_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์ Java Proto
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/proto:javalite_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ซึ่งอธิบายวิธีคอมไพล์โปรโตคอล JavaLite
แท็ก:affects_outputs
,loading_and_analysis
- ระบบได้สะสมการใช้งานหลายครั้งแล้ว
--protocopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมที่จะส่งไปยังคอมไพเลอร์ protobuf
แท็ก:affects_outputs
--[no]runs_per_test_detects_flakes
ค่าเริ่มต้น: "false"- หากเป็น "จริง" ข้อมูลพร็อพเพอร์ตี้ที่รัน/พยายามอย่างน้อย 1 ครั้งผ่านและรัน/พยายามอย่างน้อย 1 ครั้งไม่ผ่านจะได้รับสถานะ "ไม่เสถียร"
- ค่าเริ่มต้น
--shell_executable=<a path>
: ดูคำอธิบาย -
เส้นทางสัมบูรณ์ไปยังเชลล์ที่ปฏิบัติการได้สำหรับ Bazel หากไม่ได้ตั้งค่านี้ แต่มีการตั้งค่าตัวแปรสภาพแวดล้อม BAZEL_SH ในการเรียกใช้ Bazel ครั้งแรก (ซึ่งจะเริ่มต้นเซิร์ฟเวอร์ Bazel) Bazel จะใช้ตัวแปรนั้น หากไม่ได้ตั้งค่าค่าใดเลย Bazel จะใช้เส้นทางเริ่มต้นแบบฮาร์ดโค้ดโดยขึ้นอยู่กับระบบปฏิบัติการที่ใช้ (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, อื่นๆ ทั้งหมด: /bin/bash) โปรดทราบว่าการใช้ Shell ที่เข้ากันไม่ได้กับ Bash อาจทำให้บิลด์ล้มเหลวหรือรันไทม์ของไบนารีที่สร้างขึ้นไม่สำเร็จ
แท็ก:loading_and_analysis
--[no]show_loading_progress
ค่าเริ่มต้น: "true"- หากเปิดใช้ จะทำให้ Bazel พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ:"
--test_arg=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ระบุตัวเลือกและอาร์กิวเมนต์เพิ่มเติมที่ควรส่งไปยังไฟล์ปฏิบัติการทดสอบ ใช้หลายครั้งเพื่อระบุอาร์กิวเมนต์หลายรายการได้ หากทำการทดสอบหลายรายการ แต่ละรายการจะได้รับอาร์กิวเมนต์ที่เหมือนกัน ใช้เฉพาะโดยคำสั่ง "การทดสอบ Bazel" เท่านั้น
--test_filter=<a string>
default: ดูคำอธิบาย- ระบุตัวกรองที่จะส่งต่อไปยังเฟรมเวิร์กการทดสอบ ใช้เพื่อจํากัดการเรียกใช้การทดสอบ โปรดทราบว่าการดำเนินการนี้จะไม่ส่งผลต่อเป้าหมายที่สร้าง
- ค่าเริ่มต้นของ
--test_result_expiration=<an integer>
: "-1" - ตัวเลือกนี้เลิกใช้งานแล้วและไม่มีผล
--[no]test_runner_fail_fast
ค่าเริ่มต้น: "false"- ส่งต่อตัวเลือก "ดำเนินการทดสอบอย่างรวดเร็ว" ไปยังโปรแกรมรันทดสอบ โปรแกรมรันทดสอบควรหยุดการดําเนินการเมื่อเกิดความผิดพลาดครั้งแรก
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
ค่าเริ่มต้น: "explicit"- ระบุกลยุทธ์สำหรับการทดสอบชาร์ดดิ้ง: "Explicit" เพื่อใช้การชาร์ดดิ้งเฉพาะในกรณีที่มีแอตทริบิวต์ BUILD "shard_count" เท่านั้น "disabled" เพื่อไม่ให้ใช้การแยกกลุ่มทดสอบ 'forced=k' เพื่อบังคับใช้กลุ่ม "k" สำหรับการทดสอบโดยไม่คำนึงถึงแอตทริบิวต์ BUILD "shard_count"
--tool_java_language_version=<a string>
ค่าเริ่มต้น: ""- เวอร์ชันภาษา Java ที่ใช้ในการเรียกใช้เครื่องมือที่จําเป็นในระหว่างการสร้าง
--tool_java_runtime_version=<a string>
ค่าเริ่มต้น: "remotejdk_11"- เวอร์ชันรันไทม์ของ Java ที่ใช้เพื่อเรียกใช้เครื่องมือในระหว่างบิลด์
--[no]use_ijars
ค่าเริ่มต้น: "true"- หากเปิดใช้ ตัวเลือกนี้จะทําให้คอมไพล์ Java ใช้ไฟล์ jar อินเทอร์เฟซ ซึ่งจะส่งผลให้การคอมไพล์แบบเพิ่มประสิทธิภาพเร็วขึ้น แต่ข้อความแสดงข้อผิดพลาดอาจแตกต่างกัน
ตัวเลือกเวอร์ชัน
- ตัวเลือกที่ปรากฏก่อนคำสั่งและแยกวิเคราะห์โดยไคลเอ็นต์
--distdir=<a path>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากตั้งค่าไว้ แคชที่เก็บข้อมูลจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบในแคชแทนการคัดลอก การดำเนินการนี้มีไว้เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองดาวน์โหลดข้อผิดพลาดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองอีกครั้ง
แท็ก:experimental
- ค่าเริ่มต้น
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับเวลาหมดอายุทั้งหมดในกฎของที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ช่วยให้รีโพซิทอรีภายนอกทํางานบนเครื่องที่ช้ากว่าที่ผู้เขียนกฎคาดไว้ได้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้น
--[no]incompatible_disable_native_repo_rules
: "เท็จ" -
หากเป็นเท็จ จะใช้กฎของรีโปเดิมใน WORKSPACE ได้ หากเป็นจริง ต้องใช้กฎของรีโป Starlark แทน กฎของรีโปเนทีฟ ได้แก่ local_repository, new_local_repository, local_config_platform, android_sdk_repository และ android_ndk_repository
แท็ก:bazel_internal_configuration
--repository_cache=<a path>
default: ดูคำอธิบาย-
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลรีโพซิทอรี่ภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช มิเช่นนั้นระบบจะใช้ค่าเริ่มต้นของ "<output_user_root>/cache/repos/v1"
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--[no]repository_disable_download
: "เท็จ" -
หากตั้งค่าไว้ ระบบจะไม่อนุญาตให้ดาวน์โหลดโดยใช้ ctx.download{,_and_extract} ระหว่างการดึงข้อมูลที่เก็บ โปรดทราบว่าการเข้าถึงเครือข่ายไม่ได้ถูกปิดใช้อย่างสมบูรณ์ ctx.execute อาจยังคงเรียกใช้ไฟล์ที่เรียกใช้งานได้แบบไม่จำกัดซึ่งเข้าถึงอินเทอร์เน็ตได้
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการเรียกใช้บิลด์
- ค่าเริ่มต้น
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
เปอร์เซ็นต์ของพื้นที่เก็บข้อมูลแบบ Tenure ที่ใช้งานอยู่ (0-100) ซึ่ง GcThrashingDetector จะพิจารณาเหตุการณ์ความกดดันของหน่วยความจําเทียบกับขีดจํากัด (--gc_thrashing_limits) หากตั้งค่าเป็น 100 ระบบจะปิดใช้ GcThrashingDetector
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่อนุญาตให้ผู้ใช้กําหนดค่าเอาต์พุตที่ต้องการ ซึ่งส่งผลต่อค่าของเอาต์พุต ไม่ใช่การมีอยู่ของเอาต์พุต
--[no]gnu_format
ค่าเริ่มต้น: "false"-
หากตั้งค่าไว้ ระบบจะเขียนเวอร์ชันไปยัง stdout โดยใช้รูปแบบที่อธิบายไว้ในมาตรฐาน GNU
แท็ก:affects_outputs
,execution
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
--allow_yanked_versions=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ที่จะอนุญาตในกราฟ Dependency ที่แก้ไขแล้ว แม้ว่าจะมีการประกาศว่ามีการดึงออกในรีจิสทรีที่มาจาก (หากไม่ได้มาจาก NonRegistryOverride) มิฉะนั้น การดึงเวอร์ชันออกจะทำให้การแก้ไขไม่สำเร็จ นอกจากนี้ คุณยังกำหนดเวอร์ชันที่ดึงออกได้โดยใช้ตัวแปรสภาพแวดล้อม `BZLMOD_ALLOW_YANKED_VERSIONS` คุณปิดใช้การตรวจสอบนี้ได้โดยใช้คีย์เวิร์ด "all" (ไม่แนะนำ)
แท็ก:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
ค่าเริ่มต้น: "error"-
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ใช้ได้คือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ" "off" เพื่อปิดใช้การตรวจสอบ หรือ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน
แท็ก:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
ค่าเริ่มต้น: "warning"-
ตรวจสอบว่า Dependency ของ `bazel_dep` โดยตรงที่ประกาศไว้ในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟ Dependency ที่แก้ไขแล้วหรือไม่ ค่าที่ใช้ได้คือ "off" เพื่อปิดใช้การตรวจสอบ "warning" เพื่อพิมพ์คําเตือนเมื่อตรวจพบการไม่ตรงกัน หรือ "error" เพื่อส่งต่อเป็น "การแก้ปัญหาไม่สําเร็จ"
แท็ก:loading_and_analysis
--[no]ignore_dev_dependency
ค่าเริ่มต้น: "false"-
หากเป็น "จริง" Bazel จะไม่สนใจ `bazel_dep` และ `use_extension` ที่ประกาศเป็น `dev_dependency` ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าระบบจะละเว้นข้อกำหนดในการพัฒนาเหล่านั้นใน MODULE.bazel เสมอหากไม่ใช่โมดูลรูท ไม่ว่าค่าของ Flag นี้จะเป็นอย่างไรก็ตาม
แท็ก:loading_and_analysis
--lockfile_mode=<off, update, refresh or error>
ค่าเริ่มต้น: "update"-
ระบุวิธีและวิธีใช้ล็อกไฟล์ ค่าที่ถูกต้องคือ "update" เพื่อใช้ไฟล์ล็อกและอัปเดตไฟล์หากมีการเปลี่ยนแปลง "refresh" เพื่อรีเฟรชข้อมูลที่เปลี่ยนแปลงได้เพิ่มเติม (เวอร์ชันที่ยกเลิกและโมดูลที่ขาดหายไปก่อนหน้านี้) จากรีจิสทรีระยะไกลเป็นครั้งคราว "error" เพื่อใช้ไฟล์ล็อกแต่แสดงข้อผิดพลาดหากไฟล์ล็อกไม่เป็นปัจจุบัน หรือ "off" เพื่อไม่อ่านหรือเขียนลงในไฟล์ล็อก
แท็ก:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างโมดูลด้วยเส้นทางในเครื่องในรูปแบบ <ชื่อโมดูล>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีทํางานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้านี้ออก
--registry=<a string>
ระบบจะรวบรวมการใช้งานหลายครั้ง-
ระบุรีจิสทรีที่จะใช้ค้นหาทรัพยากร Dependency ของโมดูล Bazel ลําดับมีความสําคัญ: ระบบจะค้นหาโมดูลในรีจิสทรีก่อนหน้าก่อน และจะเปลี่ยนไปใช้รีจิสทรีที่ใหม่กว่าก็ต่อเมื่อไม่มีโมดูลที่ต้องการในรีจิสทรีก่อนหน้า
แท็ก:changes_inputs
--vendor_dir=<a path>
default: ดูคำอธิบาย-
ระบุไดเรกทอรีที่ควรเก็บที่เก็บข้อมูลภายนอกในโหมดผู้ให้บริการ ไม่ว่าจะเป็นเพื่อดึงข้อมูลมาไว้ในไดเรกทอรีดังกล่าวหรือเพื่อใช้งานขณะสร้าง คุณสามารถระบุเส้นทางเป็นเส้นทางสัมบูรณ์หรือเส้นทางที่สัมพันธ์กับไดเรกทอรีพื้นที่ทำงานก็ได้
แท็ก:loading_and_analysis
- ตัวเลือกที่ทริกเกอร์การเพิ่มประสิทธิภาพของเวลาสร้างมีดังนี้
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
ค่าเริ่มต้น: "1s:2,20s:3,1m:5"-
ขีดจํากัดที่หากถึงแล้วจะทำให้ GcThrashingDetector ทำให้ Bazel ขัดข้องด้วย OOM โดยระบุขีดจํากัดแต่ละรายการเป็น <period>:<count> โดยที่ period คือระยะเวลา และ count คือจํานวนเต็มบวก หากมีการใช้พื้นที่ที่มีการจัดสรรไว้ (ฮีปรุ่นเก่า) มากกว่า --gc_thrashing_threshold เปอร์เซ็นต์หลังจากการเรียกใช้ GC แบบเต็มติดต่อกัน <count> ครั้งภายใน <period> ระบบจะเรียกใช้ OOM คุณสามารถระบุขีดจํากัดหลายรายการโดยคั่นด้วยคอมมา
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
แฟล็กสำหรับการกำหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC แบบเต็มขึ้น ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนครั้งต่อครั้งที่เรียกใช้ ค่าเริ่มต้นคือ Integer.MAX_VALUE ซึ่งจะถือว่าไม่มีขีดจํากัด 0 หมายความว่าเหตุการณ์ GC แบบสมบูรณ์จะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC แบบเต็มและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บรักษาไว้
แท็ก:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
ค่าเริ่มต้น: "2147483647"-
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์ฮีปที่เก็บไว้เกินเกณฑ์ที่กำหนดโดย --skyframe_high_water_mark_threshold เมื่อเกิดเหตุการณ์ GC เล็กน้อยขึ้น ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็นสูงสุดจำนวนนี้ต่อการเรียกใช้แต่ละครั้ง ค่าเริ่มต้นเป็น Integer.MAX_VALUE โดยไม่มีขีดจำกัด 0 หมายความว่าเหตุการณ์ GC เล็กน้อยจะไม่ทริกเกอร์การลดลง หากถึงขีดจํากัด ระบบจะไม่ทิ้งสถานะ Skyframe อีกต่อไปเมื่อเกิดเหตุการณ์ GC ย่อยและเกินเกณฑ์เปอร์เซ็นต์ฮีปที่เก็บไว้
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag สําหรับการกําหนดค่าขั้นสูงของเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่ามีการใช้งานเปอร์เซ็นต์กองที่เก็บไว้อย่างน้อยถึงเกณฑ์นี้ ระบบจะทิ้งสถานะ Skyframe ชั่วคราวที่ไม่จำเป็น การปรับแต่งค่านี้อาจช่วยลดผลกระทบต่อเวลาจริงของการกระหน่ำ GC เมื่อการกระหน่ำ GC (1) เกิดจากการใช้งานหน่วยความจําของสถานะชั่วคราวนี้ และ (2) เสียค่าใช้จ่ายมากกว่าการสร้างสถานะใหม่เมื่อจําเป็น
แท็ก:host_machine_resource_optimizations
- ตัวเลือกที่ส่งผลต่อรายละเอียด รูปแบบ หรือตำแหน่งของการบันทึก
--experimental_command_profile=<cpu, wall, alloc or lock>
default: ดูคำอธิบาย- บันทึกโปรไฟล์ Java Flight Recorder ตลอดระยะเวลาของคำสั่ง คุณต้องระบุประเภทเหตุการณ์โปรไฟล์ที่รองรับ (cpu, wall, alloc หรือ lock) รายการใดรายการหนึ่งเป็นอาร์กิวเมนต์ ระบบจะเขียนโปรไฟล์ลงในไฟล์ที่ตั้งชื่อตามประเภทเหตุการณ์ในไดเรกทอรีฐานเอาต์พุต รูปแบบคำสั่งและความหมายของ Flag นี้อาจเปลี่ยนแปลงในอนาคตเพื่อรองรับประเภทโปรไฟล์หรือรูปแบบเอาต์พุตเพิ่มเติม โปรดใช้โดยยอมรับความเสี่ยงเอง
- ค่าเริ่มต้น
--[no]experimental_record_metrics_for_all_mnemonics
: "เท็จ" - โดยค่าเริ่มต้น จำนวนประเภทการดำเนินการจะจํากัดไว้ที่คําช่วยจํา 20 รายการที่มีการดําเนินการมากที่สุด การตั้งค่าตัวเลือกนี้จะเป็นการเขียนสถิติสำหรับการช่วยจำทั้งหมด
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
--experimental_resolved_file_instead_of_workspace=<a string>
ค่าเริ่มต้น: ""-
หากไม่ใช่ค่าว่าง ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการระยะไกล
--experimental_downloader_config=<a string>
default: ดูคำอธิบาย- ระบุไฟล์ที่จะใช้กำหนดค่าโปรแกรมดาวน์โหลดจากระยะไกล ไฟล์นี้ประกอบด้วยบรรทัดต่างๆ ซึ่งแต่ละบรรทัดจะขึ้นต้นด้วยคําสั่ง (`allow`, `block` หรือ `rewrite`) ตามด้วยชื่อโฮสต์ (สําหรับ `allow` และ `block`) หรือรูปแบบ 2 รูปแบบ โดยรูปแบบหนึ่งใช้เพื่อจับคู่ และอีกรูปแบบหนึ่งใช้แทน URL โดยมีการอ้างอิงย้อนกลับที่เริ่มต้นจาก `$1` คุณอาจระบุคําสั่ง `rewrite` หลายรายการสําหรับ URL เดียวกันได้ ซึ่งในกรณีนี้ระบบจะแสดงผล URL หลายรายการ
- ค่าเริ่มต้น
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "อัตโนมัติ" - โหมดการแยกชุดข้อความที่จะใช้ดึงข้อมูลรีโป หากตั้งค่าเป็น "ปิด" ระบบจะไม่ใช้เธรดสำหรับงานและการดึงข้อมูลรีโปจะขึ้นอยู่กับการรีสตาร์ท ไม่เช่นนั้นจะใช้เธรดผู้ทํางานเสมือน
- ตัวเลือกอื่นๆ ที่ไม่ได้จัดหมวดหมู่ไว้
--override_repository=<an equals-separated mapping of repository name to path>
ระบบจะรวบรวมการใช้งานหลายครั้ง- ลบล้างที่เก็บโดยใช้เส้นทางในเครื่องในรูปแบบ <ชื่อที่เก็บ>=<เส้นทาง> หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางสัมพัทธ์ ระบบจะใช้เส้นทางนั้นโดยสัมพันธ์กับไดเรกทอรีการทำงานปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" เส้นทางนั้นจะสัมพันธ์กับรูทของพื้นที่ทํางาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace" หากเส้นทางที่ระบุว่างเปล่า ระบบจะนำการลบล้างก่อนหน้านี้ออก
แท็กผลของตัวเลือก
unknown |
ตัวเลือกนี้มีผลที่ไม่รู้จักหรือไม่มีเอกสารประกอบ |
no_op |
ตัวเลือกนี้จะไม่มีผลใดๆ ทั้งสิ้น |
loses_incremental_state |
การเปลี่ยนค่าของตัวเลือกนี้อาจทำให้สูญเสียสถานะที่เพิ่มขึ้นเป็นอย่างมาก ซึ่งจะทำให้บิลด์ช้าลง สถานะอาจสูญหายเนื่องจากการรีสตาร์ทเซิร์ฟเวอร์หรือการทำให้กราฟความเกี่ยวข้องส่วนใหญ่ใช้งานไม่ได้ |
changes_inputs |
ตัวเลือกนี้จะเปลี่ยนอินพุตที่ Bazel พิจารณาสําหรับการสร้าง เช่น ข้อจํากัดของระบบไฟล์ เวอร์ชันที่เก็บ หรือตัวเลือกอื่นๆ |
affects_outputs |
ตัวเลือกนี้จะส่งผลต่อเอาต์พุตของ bazel แท็กนี้มีไว้เพื่อครอบคลุมอย่างจงใจ อาจมีผลแบบเปลี่ยนผ่าน และไม่ได้ระบุประเภทเอาต์พุตที่ได้รับผลกระทบ |
build_file_semantics |
ตัวเลือกนี้จะมีผลต่อความหมายของไฟล์ BUILD หรือ .bzl |
bazel_internal_configuration |
ตัวเลือกนี้จะมีผลกับการตั้งค่าเครื่องจักรภายในแบบ bazel แท็กนี้ไม่ได้หมายความว่าอาร์ติแฟกต์การสร้างจะได้รับผลกระทบ |
loading_and_analysis |
ตัวเลือกนี้ส่งผลต่อการโหลดและการวิเคราะห์ทรัพยากร Dependency และการสร้างกราฟทรัพยากร Dependency |
execution |
ตัวเลือกนี้มีผลต่อระยะการดําเนินการ เช่น ตัวเลือกที่เกี่ยวข้องกับแซนด์บ็อกซ์หรือการดําเนินการจากระยะไกล |
host_machine_resource_optimizations |
ตัวเลือกนี้จะทริกเกอร์การเพิ่มประสิทธิภาพที่อาจเจาะจงเครื่องและไม่ได้รับประกันว่าจะใช้งานได้กับทุกเครื่อง การเพิ่มประสิทธิภาพอาจรวมถึงการแลกกับประสิทธิภาพด้านอื่นๆ เช่น หน่วยความจำหรือต้นทุน CPU |
eagerness_to_exit |
ตัวเลือกนี้จะเปลี่ยนความกระตือรือร้นของ Bazel ที่จะออกจากการทำงานที่ไม่สำเร็จ โดยจะมีตัวเลือกให้ดำเนินการต่อแม้จะไม่สำเร็จและสิ้นสุดการเรียกใช้ |
bazel_monitoring |
ตัวเลือกนี้ใช้เพื่อตรวจสอบพฤติกรรมและประสิทธิภาพของ Bazel |
terminal_output |
ตัวเลือกนี้จะส่งผลต่อเอาต์พุตเทอร์มินัลของ bazel |
action_command_lines |
ตัวเลือกนี้จะเปลี่ยนอาร์กิวเมนต์บรรทัดคำสั่งของการดำเนินการบิลด์อย่างน้อย 1 รายการ |
test_runner |
ตัวเลือกนี้จะเปลี่ยนสภาพแวดล้อมของ TestRunner ของบิลด์ |
แท็กข้อมูลเมตาของตัวเลือก
experimental |
ตัวเลือกนี้จะเปิดใช้ฟีเจอร์ทดลองโดยไม่มีการรับประกันฟังก์ชันการทำงาน |
incompatible_change |
ตัวเลือกนี้จะทำให้เกิดการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ ใช้ตัวเลือกนี้เพื่อทดสอบความพร้อมในการย้ายข้อมูลหรือทดลองใช้ฟีเจอร์ใหม่ก่อนเปิดตัว |
deprecated |
ตัวเลือกนี้เลิกใช้งานแล้ว อาจเป็นไปได้ว่าฟีเจอร์ที่ได้รับผลกระทบเลิกใช้งานแล้ว หรืออาจแนะนำวิธีระบุข้อมูลอื่น |