bazel [<startup options>] <command> [<args>]หรือ
bazel [<startup options>] <command> [<args>] -- [<target patterns>]ดูคู่มือผู้ใช้สำหรับไวยากรณ์ของรูปแบบเป้าหมาย
ไวยากรณ์ตัวเลือก
คุณส่งตัวเลือกให้ Bazel ได้หลายวิธี ตัวเลือกที่ต้องการค่าสามารถส่งผ่านเครื่องหมายเท่ากับหรือเว้นวรรคได้ ดังนี้
--<option>=<value> --<option> <value>ตัวเลือกบางอย่างมีรูปแบบสั้นแบบอักขระเดียว ในกรณีดังกล่าว จะต้องส่งรูปแบบสั้นด้วยเครื่องหมายขีดกลางเดียวและเว้นวรรค
-<short_form> <value>
คุณเปิดใช้ตัวเลือกบูลีนได้ดังต่อไปนี้
--<option> --<option>=[true|yes|1]และปิดใช้ดังนี้
--no<option> --<option>=[false|no|0]
ตัวเลือก Tristate มักจะตั้งค่าเป็นอัตโนมัติโดยค่าเริ่มต้น และสามารถบังคับให้เปิดใช้ได้ดังนี้
--<option>=[true|yes|1]หรือบังคับให้ปิดใช้ ดังนี้
--no<option> --<option>=[false|no|0]
คำสั่ง
analyze-profile |
วิเคราะห์ข้อมูลโปรไฟล์บิลด์ |
aquery |
วิเคราะห์เป้าหมายที่ระบุและค้นหากราฟการดำเนินการ |
build |
สร้างเป้าหมายที่ระบุ |
canonicalize-flags |
กำหนดรายการตัวเลือกแบบ Bazel |
clean |
ลบไฟล์เอาต์พุตและเลือกหยุดเซิร์ฟเวอร์ |
coverage |
สร้างรายงานการครอบคลุมของโค้ดสำหรับเป้าหมายการทดสอบที่ระบุ |
cquery |
โหลด วิเคราะห์ และค้นหาเป้าหมายที่ระบุพร้อมการกำหนดค่า |
dump |
ดัมพ์สถานะภายในของกระบวนการเซิร์ฟเวอร์ Bazel |
fetch |
ดึงข้อมูลที่เก็บภายนอกซึ่งเป็นข้อกำหนดเบื้องต้นของเป้าหมาย |
help |
ความช่วยเหลือเกี่ยวกับการพิมพ์สำหรับคำสั่งหรือดัชนี |
info |
แสดงข้อมูลรันไทม์เกี่ยวกับเซิร์ฟเวอร์ Bazel |
license |
พิมพ์ใบอนุญาตของซอฟต์แวร์นี้ |
mobile-install |
เป้าหมายการติดตั้งไปยังอุปกรณ์เคลื่อนที่ |
mod |
การค้นหากราฟการอ้างอิงภายนอก Bzlmod |
print_action |
พิมพ์อาร์กิวเมนต์บรรทัดคำสั่งสำหรับการคอมไพล์ไฟล์ |
query |
ดำเนินการค้นหากราฟการอ้างอิง |
run |
เรียกใช้เป้าหมายที่ระบุ |
shutdown |
หยุดเซิร์ฟเวอร์ Bazel |
sync |
ซิงค์ที่เก็บทั้งหมดที่ระบุในไฟล์พื้นที่ทำงาน |
test |
สร้างและเรียกใช้เป้าหมายการทดสอบที่ระบุ |
version |
พิมพ์ข้อมูลเวอร์ชันสำหรับ Bazel |
ตัวเลือกการเริ่มต้น
- ตัวเลือกที่ปรากฏก่อนคำสั่งและถูกแยกวิเคราะห์โดยไคลเอ็นต์ ได้แก่
- ค่าเริ่มต้นของ
--[no]autodetect_server_javabase
: "จริง" -
เมื่อส่งผ่าน --noautodetect_server_javabase แล้ว Bazel จะไม่กลับไปใช้ JDK ในเครื่องเพื่อเรียกใช้เซิร์ฟเวอร์ Bazel และออกแทน
แท็ก:affects_outputs
,loses_incremental_state
- ค่าเริ่มต้นของ
--[no]batch
: "เท็จ" -
หากตั้งค่า Bazel จะเป็นเพียงกระบวนการของไคลเอ็นต์โดยไม่มีเซิร์ฟเวอร์ ไม่ใช่ในโหมดไคลเอ็นต์/เซิร์ฟเวอร์มาตรฐาน ตัวเลือกนี้เลิกใช้งานแล้วและจะถูกนำออก โปรดปิดเซิร์ฟเวอร์อย่างชัดเจนเพื่อไม่ให้เซิร์ฟเวอร์ทำงานค้าง
แท็ก:loses_incremental_state
,bazel_internal_configuration
,deprecated
- ค่าเริ่มต้นของ
--[no]batch_cpu_scheduling
: "เท็จ" -
เฉพาะใน Linux เท่านั้น ให้ใช้การกำหนดเวลา CPU "กลุ่ม" สำหรับ Blaze นโยบายนี้มีประโยชน์สำหรับภาระงานแบบไม่โต้ตอบ แต่ไม่ต้องการลดคุณค่าลง ดู "man 2 sched_setscheduler" หากเป็น "เท็จ" Bazel จะไม่ทำการเรียกของระบบ
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้น
--bazelrc=<path>
: ดูรายละเอียด -
ตำแหน่งของไฟล์ .bazelrc ของผู้ใช้ที่มีค่าเริ่มต้นของตัวเลือก Bazel /dev/null บ่งบอกว่าระบบจะไม่สนใจ "--bazelrc" เพิ่มเติมทั้งหมด ซึ่งมีประโยชน์ในการปิดการค้นหาไฟล์ rc ของผู้ใช้ เช่น ในบิลด์ที่เผยแพร่
ตัวเลือกนี้สามารถระบุได้หลายครั้งเช่นกัน
เช่น ที่มี `--bazelrc=x.rc --bazelrc=y.rc --bazelrc=/dev/null --bazelrc=z.rc`,
1) อ่าน x.rc และ y.rc
2) z.rc ไม่สนใจเนื่องจาก /dev/null ก่อนหน้า
หากไม่ระบุ Bazel จะใช้ไฟล์ .bazelrc ไฟล์แรกที่พบใน 2 ตำแหน่งต่อไปนี้ ไดเรกทอรีพื้นที่ทำงาน และไดเรกทอรีหน้าแรกของผู้ใช้
หมายเหตุ: ตัวเลือกบรรทัดคำสั่งจะมีผลแทนตัวเลือกทั้งหมดใน bazelrc เสมอ
แท็ก:changes_inputs
- ค่าเริ่มต้นของ
--[no]block_for_lock
: "จริง" -
เมื่อผ่าน --noblock_for_lock แล้ว Bazel จะไม่รอให้คำสั่งที่ทำงานอยู่เสร็จสิ้น แต่ออกทันทีแทน
แท็ก:eagerness_to_exit
- ค่าเริ่มต้นของ
--[no]client_debug
: "เท็จ" -
หากเป็น "จริง" ให้บันทึกข้อมูลการแก้ไขข้อบกพร่องจากไคลเอ็นต์ไปยัง Stderr การเปลี่ยนแปลงตัวเลือกนี้จะไม่ทำให้เซิร์ฟเวอร์รีสตาร์ท
แท็ก:affects_outputs
,bazel_monitoring
- ค่าเริ่มต้นของ
--connect_timeout_secs=<an integer>
: "30" -
ระยะเวลาที่ลูกค้ารอขณะพยายามเชื่อมต่อกับเซิร์ฟเวอร์แต่ละครั้ง
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]expand_configs_in_place
: "จริง" -
เปลี่ยนการขยายของ --config เป็นการดำเนินการ ณ ตำแหน่งเดิม แทนการขยายจุดคงที่ระหว่างตัวเลือก rc ปกติและตัวเลือกที่ระบุบรรทัดคำสั่ง
แท็ก:no_op
,deprecated
- ค่าเริ่มต้น
--failure_detail_out=<path>
: ดูรายละเอียด -
หากตั้งค่าไว้ ให้ระบุตำแหน่งที่จะเขียนข้อความ Proxybuf เกี่ยวกับความล้มเหลว_รายละเอียดหากเซิร์ฟเวอร์ประสบปัญหาและไม่สามารถรายงานผ่าน gRPC ได้ตามปกติ มิเช่นนั้น ตำแหน่งจะเป็น ${OUTPUT_BASE}/failure_detail.rawprof
แท็ก:affects_outputs
,loses_incremental_state
- ค่าเริ่มต้นของ
--[no]home_rc
: "จริง" -
ไม่ว่าจะหาไฟล์ home bazelrc ที่ $HOME/.bazelrc
แท็ก:changes_inputs
- ค่าเริ่มต้นของ
--[no]idle_server_tasks
: "จริง" -
เรียกใช้ System.gc() เมื่อเซิร์ฟเวอร์ไม่มีความเคลื่อนไหว
แท็ก:loses_incremental_state
,host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--[no]ignore_all_rc_files
: "เท็จ" -
ปิดใช้ไฟล์ rc ทั้งหมด แม้ว่าแฟล็กอื่นๆ ที่แก้ไข rc จะมีค่าใดก็ตาม แม้ว่าแฟล็กเหล่านี้จะอยู่ในรายการตัวเลือกการเริ่มต้นใช้งานก็ตาม
แท็ก:changes_inputs
- ค่าเริ่มต้นของ
--io_nice_level={-1,0,1,2,3,4,5,6,7}
: "-1" -
สำหรับ Linux เท่านั้น ให้ตั้งระดับตั้งแต่ 0-7 เพื่อการกำหนดเวลา IO ที่ดีที่สุดโดยใช้การเรียกใช้ระบบ sys_ioprio_set 0 คือลำดับความสำคัญสูงสุด 7 คือต่ำสุด เครื่องจัดตารางเวลาที่คาดว่าจะต้องใช้สูงสุดถึง 4 ลำดับความสำคัญเท่านั้น หากกำหนดค่าเป็นค่าลบ Bazel จะไม่ทำการเรียกของระบบ
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--local_startup_timeout_secs=<an integer>
: "120" -
ระยะเวลาสูงสุดที่ลูกค้ารอเพื่อเชื่อมต่อกับเซิร์ฟเวอร์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--macos_qos_class=<a string>
: "ค่าเริ่มต้น" -
ตั้งค่าคลาสบริการ QoS ของเซิร์ฟเวอร์ Bazel เมื่อทำงานใน macOS แฟล็กนี้จะไม่มีผลกับแพลตฟอร์มอื่นๆ ทั้งหมด แต่รองรับเพื่อให้มั่นใจว่าสามารถแชร์ไฟล์ rc ระหว่างแพลตฟอร์มต่างๆ ได้โดยไม่ต้องเปลี่ยนแปลง ค่าที่เป็นไปได้ ได้แก่ การโต้ตอบโดยผู้ใช้ เริ่มต้นโดยผู้ใช้ ค่าเริ่มต้น ยูทิลิตี และพื้นหลัง
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--max_idle_secs=<integer>
: "10800" -
จำนวนวินาทีที่เซิร์ฟเวอร์บิลด์จะรอให้ไม่มีการใช้งานก่อนที่จะปิดเครื่อง โดย 0 หมายความว่าเซิร์ฟเวอร์จะไม่ปิดเลย ซึ่งจะอ่านเมื่อเซิร์ฟเวอร์เริ่มทำงานเท่านั้น การเปลี่ยนแปลงตัวเลือกนี้จะไม่ทำให้เซิร์ฟเวอร์รีสตาร์ท
แท็ก:eagerness_to_exit
,loses_incremental_state
- ค่าเริ่มต้น
--output_base=<path>
: ดูรายละเอียด -
หากมีการตั้งค่า ให้ระบุตำแหน่งเอาต์พุตที่ระบบจะเขียนเอาต์พุตทั้งหมดของบิลด์ ไม่เช่นนั้น สถานที่จะเป็น ${OUTPUT_ROOT}/_blaze_${USER}/${MD5_OF_WORKSPACE_ROOT} หมายเหตุ: หากคุณระบุตัวเลือกอื่นที่ต่างจากการเรียกใช้ Bazel ครั้งถัดไปสำหรับค่านี้ จะเป็นการเริ่มเซิร์ฟเวอร์ Bazel ใหม่เพิ่มเติม Bazel จะเริ่มต้น 1 เซิร์ฟเวอร์ต่อฐานเอาต์พุตที่ระบุ โดยทั่วไปแล้วจะมีฐานเอาต์พุต 1 ฐานต่อพื้นที่ทำงาน 1 แห่ง แต่ตัวเลือกนี้คุณอาจมีฐานเอาต์พุตหลายฐานต่อพื้นที่ทำงาน 1 รายการ และเรียกใช้บิลด์หลายบิลด์สำหรับไคลเอ็นต์เดียวกันในเครื่องเดียวกันพร้อมกัน ดูวิธีปิดเซิร์ฟเวอร์ Bazel
แท็ก:affects_outputs
,loses_incremental_state
- ค่าเริ่มต้น
--output_user_root=<path>
: ดูรายละเอียด -
ไดเรกทอรีเฉพาะผู้ใช้ที่ด้านล่างซึ่งเขียนเอาต์พุตทั้งหมดของบิลด์ทั้งหมด โดยค่าเริ่มต้นแล้วจะเป็นฟังก์ชันของ $USER แต่การระบุค่าคงที่จะทำให้แชร์เอาต์พุตของบิลด์ระหว่างผู้ใช้ที่ทำงานร่วมกันได้
แท็ก:affects_outputs
,loses_incremental_state
- ค่าเริ่มต้นของ
--[no]preemptible
: "เท็จ" -
หากเป็น "จริง" คุณจะยุติคำสั่งนั้นชั่วคราวได้หากมีการเริ่มต้นคำสั่งอื่น
แท็ก:eagerness_to_exit
- ค่าเริ่มต้น
--server_jvm_out=<path>
: ดูรายละเอียด -
ตำแหน่งที่จะเขียนเอาต์พุต JVM ของเซิร์ฟเวอร์ หากไม่ได้ตั้งค่า ค่าเริ่มต้นจะเป็นตำแหน่งใน export_base
แท็ก:affects_outputs
,loses_incremental_state
- ค่าเริ่มต้นของ
--[no]shutdown_on_low_sys_mem
: "เท็จ" -
หากมีการตั้งค่า max_idle_secs และเซิร์ฟเวอร์บิลด์ไม่มีการใช้งานมาระยะหนึ่ง ให้ปิดเซิร์ฟเวอร์เมื่อระบบมี RAM ว่างเหลือน้อย Linux เท่านั้น
แท็ก:eagerness_to_exit
,loses_incremental_state
- ค่าเริ่มต้นของ
--[no]system_rc
: "จริง" -
ไม่ว่าจะมองหา bazelrc ทั้งระบบหรือไม่
แท็ก:changes_inputs
- ค่าเริ่มต้นของ
--[no]unlimit_coredumps
: "เท็จ" -
เพิ่มขีดจำกัดซอฟต์คอร์ดัมพ์เป็นขีดจำกัดแบบฮาร์ดขีดจำกัดเพื่อทำให้ Coredump ของเซิร์ฟเวอร์ (รวมถึง JVM) และไคลเอ็นต์เป็นไปได้ภายใต้เงื่อนไขทั่วไป ติด Flag นี้ไว้ใน bazelrc เพียงครั้งเดียวและลืม Flag นี้เพื่อรับ Coredumps เมื่อคุณพบภาวะที่ทริกเกอร์เหตุการณ์ดังกล่าวจริงๆ
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]watchfs
: "เท็จ" -
หากเป็น "จริง" Bazel จะพยายามใช้บริการเฝ้าไฟล์ของระบบปฏิบัติการเพื่อทำการเปลี่ยนแปลงในเครื่องแทนที่จะสแกนหาการเปลี่ยนแปลงในแต่ละไฟล์
แท็ก:deprecated
- ค่าเริ่มต้นของ
--[no]windows_enable_symlinks
: "เท็จ" -
หากเป็นจริง ระบบจะสร้างลิงก์สัญลักษณ์จริงใน Windows แทนการคัดลอกไฟล์ ต้องมีการเปิดใช้โหมดนักพัฒนาซอฟต์แวร์ Windows และ Windows 10 เวอร์ชัน 1703 หรือใหม่กว่า
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]workspace_rc
: "จริง" -
ไม่ว่าจะมองหาไฟล์ workspace bazelrc ที่ $workspace/.bazelrc
แท็ก:changes_inputs
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้จัดหมวดหมู่:
- รวมการใช้งานหลายรายการแล้ว
--host_jvm_args=<jvm_arg>
รายการ - แฟล็กเพื่อส่งไปยัง JVM ที่กำลังเรียกใช้ Blaze
--host_jvm_debug
-
ตัวเลือกแบบความสะดวกในการเพิ่มแฟล็กการเริ่มต้น JVM เพิ่มเติมบางรายการ ซึ่งทำให้ JVM ต้องรอระหว่างเริ่มต้นจนกว่าคุณจะเชื่อมต่อจากโปรแกรมแก้ไขข้อบกพร่องที่เป็นไปตามข้อกำหนด JDWP (เช่น Eclipse) ไปยังพอร์ต 5005
ขยายเป็น
--host_jvm_args=-Xdebug
--host_jvm_args=-Xrunjdwp:transport=dt_socket,server=y,address=5005
- ค่าเริ่มต้นของ
--host_jvm_profile=<profiler_name>
: "" - ตัวเลือกความสะดวกในการเพิ่มแฟล็กการเริ่มต้น JVM สำหรับเครื่องมือสร้างโปรไฟล์/โปรแกรมแก้ไขข้อบกพร่องโดยเฉพาะ Bazel มีรายการค่าที่ทราบ ซึ่งแมปกับแฟล็กเริ่มต้น JVM แบบฮาร์ดโค้ด โดยอาจค้นหาเส้นทางแบบฮาร์ดโค้ดสำหรับบางไฟล์
- ค่าเริ่มต้นของ
--server_javabase=<jvm path>
: "" - เส้นทางไปยัง JVM ที่ใช้เพื่อเรียกใช้ Bazel
ตัวเลือกที่ใช้ร่วมกันกับคำสั่งทั้งหมด
- ตัวเลือกที่ควบคุมการดำเนินการบิลด์มีดังนี้
- ค่าเริ่มต้นของ
--experimental_oom_more_eagerly_threshold=<an integer>
: "100" -
หากตั้งค่าแฟล็กนี้มีค่าน้อยกว่า 100 Bazel จะ OOM ถ้ามีการใช้ GC แบบเต็ม 2 ครั้ง เกินกว่าเปอร์เซ็นต์ของฮีป (รุ่นเดิม) นี้ยังมีการใช้งานอยู่
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--experimental_ui_max_stdouterr_bytes=<an integer in (-1)-1073741819 range>
: "1048576" -
ขนาดสูงสุดของไฟล์ stdout / stderr ที่จะพิมพ์ไปยังคอนโซล -1 หมายถึงไม่จำกัด
แท็ก:execution
- ตัวเลือกที่กำหนดค่าห่วงโซ่เครื่องมือที่ใช้สำหรับการดำเนินการดำเนินการ
- ค่าเริ่มต้นของ
--[no]incompatible_enable_proto_toolchain_resolution
: "เท็จ" -
หากเป็น "จริง" กฎภาษา Proto จะกำหนดเชนเครื่องมือจากที่เก็บ rules_Pro, rules_java, rules_cc
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่ช่วยให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการ ซึ่งส่งผลต่อค่า ไม่ใช่ที่มีอยู่
- รวมการใช้งานหลายรายการแล้ว
--repo_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุตัวแปรสภาพแวดล้อมเพิ่มเติมเพื่อให้ใช้ได้เฉพาะกับกฎที่เก็บ โปรดทราบว่ากฎของที่เก็บจะเห็นสภาพแวดล้อมที่สมบูรณ์อยู่แล้ว แต่ด้วยวิธีนี้ ข้อมูลการกำหนดค่าจะสามารถส่งผ่านตัวเลือกไปยังที่เก็บผ่านตัวเลือกโดยไม่ทำให้กราฟการดำเนินการเป็นโมฆะ
แท็ก:action_command_lines
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมของแฟล็ก ฯลฯ)
- ค่าเริ่มต้นของ
--[no]check_bzl_visibility
: "จริง" -
หากปิดใช้ ข้อผิดพลาดในการแสดงการโหลด .bzl จะถูกลดระดับเป็นคำเตือน
แท็ก:build_file_semantics
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ใน BUILD ไฟล์ .bzl หรือไฟล์ WORKSPACE
- ค่าเริ่มต้นของ
--[no]enable_bzlmod
: "เท็จ" -
หากเป็น "จริง" เปิดใช้ระบบการจัดการทรัพยากร Dependency ของ Bzlmod ซึ่งมีความสำคัญเหนือ WORKSPACE ดูข้อมูลเพิ่มเติมได้ที่ https://bazel.build/docs/bzlmod
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]experimental_action_resource_set
: "จริง" -
หากตั้งค่าเป็น "จริง" ctx.actions.run() และ ctx.actions.run_shell() จะยอมรับพารามิเตอร์ resource_set สำหรับการดำเนินการในเครื่อง มิเช่นนั้น ค่าเริ่มต้นจะเป็น 250 MB สำหรับหน่วยความจำและ CPU 1 หน่วย
แท็ก:execution
,build_file_semantics
,experimental
-
หากตั้งค่าเป็น "จริง" ระบบจะเผยแพร่แท็กจากเป้าหมายไปยังข้อกำหนดการดำเนินการของการดำเนินการ มิเช่นนั้นจะไม่มีการเผยแพร่แท็ก ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/8830
แท็ก:build_file_semantics
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_analysis_test_call
: "จริง" -
หากตั้งค่าเป็น "จริง" การเรียกใช้โฆษณาเนทีฟ Analysis_test จะพร้อมใช้งาน
แท็ก:loading_and_analysis
,build_file_semantics
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_bzl_visibility
: "จริง" -
หากเปิดใช้ ให้เพิ่มฟังก์ชัน "visibility()" ที่ไฟล์ .bzl อาจเรียกใช้ระหว่างการประเมินระดับบนสุดเพื่อตั้งค่าระดับการเข้าถึงสำหรับคำสั่ง "load()"
แท็ก:loading_and_analysis
,experimental
-
หากตั้งค่าเป็น "จริง" แอตทริบิวต์ของกฎและเมธอด Starlark API ที่จำเป็นสำหรับกฎ cc_shared_library จะพร้อมใช้งาน
แท็ก:build_file_semantics
,loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_disable_external_package
: "เท็จ" -
หากตั้งค่าเป็น "จริง" //แพ็กเกจภายนอกที่สร้างขึ้นโดยอัตโนมัติจะใช้งานไม่ได้อีกต่อไป Bazel จะยังคงแยกวิเคราะห์ไฟล์ "external/BUILD" ไม่ได้ แต่ glb ที่เข้าถึงภายนอก/ จากแพ็กเกจที่ไม่มีชื่อจะยังใช้งานได้
แท็ก:loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_enable_android_migration_apis
: "เท็จ" -
หากตั้งค่าเป็น "จริง" จะเป็นการเปิดใช้ API ที่จำเป็นเพื่อรองรับการย้ายข้อมูล Android Starlark
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--[no]experimental_get_fixed_configured_action_env
: "เท็จ" -
หากเปิดใช้ action.env จะแสดงผลตัวแปรสภาพแวดล้อมคงที่ซึ่งระบุผ่านการกำหนดค่าฟีเจอร์ด้วย
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_google_legacy_api
: "เท็จ" -
หากตั้งค่าเป็น "จริง" จะแสดงชิ้นส่วนทดลองของ Starlark Build API ที่เกี่ยวข้องกับโค้ดเดิมของ Google
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_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_lazy_template_expansion
: "จริง" -
หากตั้งค่าเป็น "จริง" ctx.actions.expand_template() จะยอมรับพารามิเตอร์ TemplateDict สำหรับการประเมินค่าการแทนที่ที่ล่าช้า
แท็ก:execution
,build_file_semantics
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_platforms_api
: "เท็จ" -
หากตั้งค่าเป็น "จริง" จะเป็นการเปิดใช้ Starlark API ที่เกี่ยวข้องกับแพลตฟอร์มจำนวนหนึ่งซึ่งมีประโยชน์ในการแก้ไขข้อบกพร่อง
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_repo_remote_exec
: "เท็จ" -
หากตั้งค่าเป็น "จริง"ที่เก็บ_กฎจะมีความสามารถในการดำเนินการระยะไกลบางอย่าง
แท็ก:build_file_semantics
,loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_sibling_repository_layout
: "เท็จ" -
หากตั้งค่าเป็น "จริง" ระบบจะแทนที่ที่เก็บที่ไม่ใช่หลักเป็นลิงก์สัญลักษณ์ไปยังที่เก็บหลักในรูทการดำเนินการ กล่าวคือ ที่เก็บทั้งหมดเป็นรายการย่อยโดยตรงของไดเรกทอรี $output_base/execution_root ซึ่งจะเป็นผลข้างเคียงจากการเพิ่ม $150 ขึ้นไปสำหรับไดเรกทอรี "ภายนอก" ระดับบนสุด
แท็ก:action_command_lines
,bazel_internal_configuration
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้นของ
--[no]incompatible_always_check_depset_elements
: "จริง" -
ตรวจสอบความถูกต้องขององค์ประกอบที่เพิ่มลงใน Depset ในตัวสร้างทั้งหมด องค์ประกอบจะต้องเปลี่ยนแปลงไม่ได้ แต่ที่ผ่านมาตัวสร้าง depset(direct=...) ลืมตรวจสอบ ใช้ tuples แทนรายการในองค์ประกอบ depset ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/10313
แท็ก:build_file_semantics
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_depset_for_libraries_to_link_getter
: "จริง" -
เมื่อค่าเป็น "จริง" Bazel จะไม่แสดงรายการจาก linking_context.libraries_to_link อีกต่อไป แต่แสดงผล depset แทน
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_disable_objc_library_transition
: "เท็จ" -
ปิดใช้การเปลี่ยนที่กำหนดเองของ objc_library แล้วรับค่าจากเป้าหมายระดับบนสุดแทน
แท็กต่อไปนี้build_file_semantics
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_disable_starlark_host_transitions
: "เท็จ" -
หากตั้งค่าเป็น "จริง" แอตทริบิวต์ของกฎจะตั้งค่า "cfg = "host"" ไม่ได้ กฎควรตั้งค่า "cfg = "exec"' แทน
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_disable_target_provider_fields
: "เท็จ" -
หากตั้งค่าเป็น "จริง" ให้ปิดเข้าถึงผู้ให้บริการในออบเจ็กต์ "target" ผ่านไวยากรณ์ของช่องได้ โปรดใช้ไวยากรณ์คีย์ผู้ให้บริการแทน เช่น ใช้ "ctx.attr.dep[MyInfo]" แทนที่จะใช้ "ctx.attr.dep.my_info" เพื่อเข้าถึง "my_info" จากภายในฟังก์ชันการใช้งานกฎ ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/9014
แท็ก:build_file_semantics
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_disallow_empty_glob
: "เท็จ" -
หากตั้งค่าเป็น "จริง" ค่าเริ่มต้นของอาร์กิวเมนต์ "allow_เริ่มต้นใช้งาน" ของ glob() จะเป็น "เท็จ"
แท็ก:build_file_semantics
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_disallow_legacy_javainfo
: "จริง" -
เลิกใช้งานแล้ว ไม่ดำเนินการ
แท็ก:build_file_semantics
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_disallow_struct_provider_syntax
: "เท็จ" -
หากตั้งค่าเป็น "จริง" ฟังก์ชันการใช้งานกฎอาจไม่แสดงผลโครงสร้าง แต่จะต้องแสดงรายการอินสแตนซ์ของผู้ให้บริการแทน
แท็ก:build_file_semantics
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_enable_deprecated_label_apis
: "จริง" -
หากเปิดใช้แล้ว คุณจะใช้ API ที่เลิกใช้งานแล้วบางรายการ (native.repository_name, Label.workspace_name, Label.sensitive) ได้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]incompatible_existing_rules_immutable_view
: "จริง" -
หากตั้งค่าเป็น "จริง" Native.existing_Rule และ Native.existing_rules จะแสดงผลออบเจ็กต์มุมมองที่เปลี่ยนแปลงไม่ได้ขนาดเล็กแทนคำสั่งที่เปลี่ยนแปลงได้
แท็ก:build_file_semantics
,loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_fail_on_unknown_attributes
: "เท็จ" -
หากเปิดใช้ เป้าหมายที่มีการตั้งค่าแอตทริบิวต์ที่ไม่รู้จักเป็น "ไม่มี" จะล้มเหลว
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_fix_package_group_reporoot_syntax
: "จริง" -
ในแอตทริบิวต์ `packages` ของ package_group จะเปลี่ยนความหมายของค่า "//..." เพื่ออ้างอิงถึงแพ็กเกจทั้งหมดในที่เก็บปัจจุบัน ไม่ใช่แพ็กเกจทั้งหมดในที่เก็บ คุณสามารถใช้ค่าพิเศษ "สาธารณะ" แทน "//..." เพื่อดูลักษณะการทำงานแบบเดิม แฟล็กนี้จำเป็นต้องเปิดใช้งาน --incompatible_package_group_has_public_syntax ด้วย
แท็ก:build_file_semantics
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_java_common_parameters
: "จริง" -
หากตั้งค่าเป็น "จริง" ระบบจะนำพารามิเตอร์เอาต์พุต_jar และ host_javabase ใน pack_sources และ host_javabase ในคอมไพล์ออกทั้งหมด
แท็ก:build_file_semantics
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_merge_fixed_and_default_shell_env
: "เท็จ" -
หากเปิดใช้ การดำเนินการที่ลงทะเบียนไว้กับ ctx.actions.run และ ctx.actions.run_shell ที่มีทั้ง "env" และ "use_default_shell_env = True" ระบุไว้จะใช้สภาพแวดล้อมที่ได้จากสภาพแวดล้อม Shell เริ่มต้นโดยการลบล้างค่าที่ส่งไปยัง "env" หากปิดใช้ ระบบจะไม่สนใจค่า "env" เลยในกรณีนี้
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_new_actions_api
: "จริง" -
หากตั้งค่าเป็น "จริง" API ที่ใช้สร้างการดำเนินการจะพร้อมใช้งานใน "ctx.actions" เท่านั้น และจะใช้กับ "ctx" ไม่ได้
แท็ก ได้แก่build_file_semantics
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_no_attr_license
: "จริง" -
หากตั้งค่าเป็น "จริง" จะเป็นการปิดใช้ฟังก์ชัน "attr.license"
แท็ก:build_file_semantics
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_no_implicit_file_export
: "เท็จ" -
หากมีการตั้งค่า ไฟล์ต้นฉบับ (ใช้แล้ว) จะเป็นแบบส่วนตัวแบบแพ็กเกจ เว้นแต่ว่ามีการส่งออกอย่างชัดเจน ดู https://github.com/bazelbuild/proposals/blob/master/designs/2019-10-24-file-visibility.md
แท็ก:build_file_semantics
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_no_rule_outputs_param
: "เท็จ" -
หากตั้งค่าเป็น "จริง" ให้ปิดใช้พารามิเตอร์ "เอาต์พุต" ของฟังก์ชัน "RULE()" ของ Starlark
แท็ก:build_file_semantics
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_package_group_has_public_syntax
: "จริง" -
ในแอตทริบิวต์ "packages" ของ package_group ให้เขียนเป็น "public" หรือ "private" เพื่ออ้างอิงถึงแพ็กเกจทั้งหมดหรือไม่มีแพ็กเกจตามลำดับ
แท็ก:build_file_semantics
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_require_linker_input_cc_api
: "จริง" -
หากตั้งค่าเป็น "จริง" กฎ create_linking_context จะต้องใช้ linker_inputs แทน library_to_link ระบบจะปิดใช้ Getter เก่าของ link_context ด้วย และจะมีแค่ linker_inputs เท่านั้นที่ใช้ได้
แท็ก:build_file_semantics
,loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_run_shell_command_string
: "จริง" -
หากตั้งค่าเป็น "จริง" พารามิเตอร์คำสั่งของ actions.run_shell จะยอมรับเฉพาะสตริงเท่านั้น
แท็กต่อไปนี้build_file_semantics
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_stop_exporting_language_modules
: "เท็จ" -
หากเปิดใช้ โมดูลเฉพาะภาษาบางรายการ (เช่น "cc_common") จะใช้งานไม่ได้ในไฟล์ .bzl ของผู้ใช้ และอาจเรียกใช้ได้จากที่เก็บกฎที่เกี่ยวข้องเท่านั้น
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_struct_has_no_methods
: "เท็จ" -
ปิดใช้เมธอด to_json และ to_Pro ของโครงสร้าง ซึ่งจะทำให้เนมสเปซของช่อง Struct ก่อให้เกิดความเสียหาย แต่ให้ใช้ json.encode หรือ json.encode_indent สำหรับ JSON หรือ pro.encode_text สำหรับ text protocol แทน
แท็ก:build_file_semantics
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_top_level_aspects_require_providers
: "เท็จ" -
หากตั้งค่าเป็น "จริง" การดำเนินการระดับบนสุดจะยึดตามผู้ให้บริการที่จำเป็น และจะทำงานกับเป้าหมายระดับบนสุดที่มีผู้ให้บริการที่โฆษณาตามกฎซึ่งตรงตามผู้ให้บริการที่จำเป็นเท่านั้น
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_unambiguous_label_stringification
: "จริง" -
เมื่อค่าเป็น "จริง" Bazel จะเป็นสตริง @//foo:bar เป็น @//foo:bar แทน //foo:bar ปัญหานี้มีผลเฉพาะกับการทำงานของ str(), โอเปอเรเตอร์ % และอื่นๆ ลักษณะการทํางานของ repr() จะไม่มีการเปลี่ยนแปลง ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/15916
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_use_cc_configure_from_rules_cc
: "เท็จ" -
เมื่อเป็นจริง Bazel จะไม่อนุญาตให้ใช้ cc_Configure จาก @bazel_tools อีกต่อไป โปรดดูรายละเอียดและวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/10134
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_visibility_private_attributes_at_definition
: "จริง" -
หากตั้งค่าเป็น "จริง" ระบบจะตรวจสอบการแสดงแอตทริบิวต์ของกฎส่วนตัวตามคำจำกัดความของกฎ และจะกลับไปใช้การใช้กฎหากมองไม่เห็น
แท็ก:build_file_semantics
,incompatible_change
- ค่าเริ่มต้นของ
--max_computation_steps=<a long integer>
: "0" -
จำนวนขั้นตอนการคำนวณ Starlark สูงสุดที่สามารถดำเนินการโดยไฟล์ BUILD (เป็น 0 หมายถึงไม่มีขีดจำกัด)
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--nested_set_depth_limit=<an integer>
: "3500" -
ความลึกสูงสุดของกราฟภายในจนถึง Depset (หรือที่เรียกว่า NestedSet) ซึ่งเหนือตัวสร้าง depset() จะล้มเหลว
แท็กloading_and_analysis
- ตัวเลือกที่กระตุ้นให้เกิดการเพิ่มประสิทธิภาพตามเวลาบิลด์
- ค่าเริ่มต้นของ
--[no]incompatible_do_not_split_linking_cmdline
: "จริง" -
เมื่อค่าเป็น "จริง" Bazel จะไม่แก้ไขแฟล็กบรรทัดคำสั่งที่ใช้ในการลิงก์อีกต่อไป และจะไม่เลือกว่าแฟล็กใดไปยังไฟล์พารามิเตอร์และรายการใดไม่ใช้ ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7670
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]keep_state_after_build
: "จริง" -
หากเป็น "เท็จ" Blaze จะทิ้งสถานะความทรงจำจากบิลด์นี้เมื่อบิลด์เสร็จสิ้นแล้ว บิลด์ต่อๆ ไปจะไม่มีส่วนเพิ่มที่เกี่ยวข้องกับเวอร์ชันนี้
แท็ก:loses_incremental_state
- ค่าเริ่มต้นของ
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
แฟล็กสำหรับการกำหนดค่าขั้นสูงสำหรับเครื่องมือ Skyframe ภายในของ Bazel หาก Bazel ตรวจพบว่าการใช้งานเปอร์เซ็นต์ฮีปที่คงไว้อยู่ที่เกณฑ์นี้เป็นอย่างน้อย ก็จะลดสถานะ Skyframe ชั่วคราวที่ไม่จำเป็น การปรับแก้ข้อมูลนี้อาจช่วยลดผลกระทบจากเวลาจริงของการโจมตี GC ได้ เมื่อการ Thrash ของ GC นั้น (1) เกิดจากการใช้หน่วยความจำของสถานะชั่วคราวนี้และ (2) ต้นทุนมากกว่าการสร้างสถานะใหม่เมื่อจำเป็น
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--[no]track_incremental_state
: "จริง" -
หากเป็น "เท็จ" Blaze จะไม่เก็บข้อมูลที่ทําให้ทำให้ใช้งานไม่ได้และประเมินซ้ำในบิลด์ที่เพิ่มขึ้นเพื่อประหยัดหน่วยความจำในบิลด์นี้ บิลด์ต่อๆ ไปจะไม่มีส่วนเพิ่มที่เกี่ยวข้องกับเวอร์ชันนี้ โดยปกติแล้ว คุณจะต้องระบุ --batch เมื่อตั้งค่าเป็น "เท็จ"
แท็ก:loses_incremental_state
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งการบันทึก
- ค่าเริ่มต้นของ
--[no]announce_rc
: "เท็จ" -
ต้องการประกาศตัวเลือก rc หรือไม่
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]attempt_to_print_relative_paths
: "เท็จ" -
เมื่อพิมพ์ส่วนตำแหน่งของข้อความ ให้พยายามใช้เส้นทางที่สัมพันธ์กับไดเรกทอรีพื้นที่ทำงานหรือไดเรกทอรีใดไดเรกทอรีหนึ่งที่ระบุโดย --package_path
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--bes_backend=<a string>
: "" -
ระบุปลายทางแบ็กเอนด์ของบริการเหตุการณ์ของบิลด์ (BES) ในรูปแบบ [SCHEME://]HOST[:PORT] ค่าเริ่มต้นคือปิดใช้งานการอัปโหลด BES รูปแบบที่รองรับคือ grpc และ grpcs (grpc ที่เปิดใช้ TLS) หากไม่ได้ระบุรูปแบบไว้ Bazel จะถือว่า Grpcs
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]bes_check_preceding_lifecycle_events
: "เท็จ" -
ตั้งค่าช่อง check_preceding_lifecycle_events_present ใน PublishBuildToolEventStreamRequest ซึ่งจะบอก BES ให้ตรวจสอบว่าก่อนหน้านี้ได้รับเหตุการณ์ InvocationAttemptStarted และ BuildEnqueued ที่ตรงกับเหตุการณ์เครื่องมือปัจจุบันหรือไม่
แท็ก:affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--bes_header=<a 'name=value' assignment>
รายการ -
ระบุส่วนหัวในรูปแบบ NAME=VALUE ที่จะรวมอยู่ในคำขอ BES คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
แท็ก:affects_outputs
- ค่าเริ่มต้น
--bes_instance_name=<a string>
: ดูรายละเอียด -
ระบุชื่ออินสแตนซ์ที่ BES จะคงการอัปโหลด BEP ไว้ ค่าเริ่มต้นคือ null
แท็ก:affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--bes_keywords=<comma-separated list of options>
รายการ -
ระบุรายการคีย์เวิร์ดสำหรับการแจ้งเตือนที่จะเพิ่มชุดคีย์เวิร์ดเริ่มต้นที่เผยแพร่ไปยัง BES ("command_name=<command_name> ", "protocol_name=BEP") ค่าเริ่มต้นคือ ไม่มี
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]bes_lifecycle_events
: "จริง" -
ระบุว่าจะเผยแพร่เหตุการณ์ในวงจร BES หรือไม่ (ค่าเริ่มต้นคือ "จริง")
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--bes_oom_finish_upload_timeout=<An immutable length of time.>
: "10 นาที" -
ระบุว่าควรรอนานเท่าใดเพื่อให้การอัปโหลด BES/BEP เสร็จสมบูรณ์ขณะ OOMing แฟล็กนี้ช่วยให้แน่ใจว่ามีการสิ้นสุดการดำเนินงานเมื่อ JVM ถูกแทรกด้วย GC อย่างหนักและดำเนินการกับเทรดของผู้ใช้ไม่ได้
แท็ก:bazel_monitoring
- ค่าเริ่มต้นของ
--bes_outerr_buffer_size=<an integer>
: "10240" -
ระบุขนาดสูงสุดของ Stdout หรือ Stderr ที่จะมีการบัฟเฟอร์ใน BEP ก่อนที่จะรายงานเป็นเหตุการณ์ความคืบหน้า ระบบจะยังคงรายงานการเขียนแต่ละรายการในเหตุการณ์เดียว แม้ว่าจะมีขนาดใหญ่กว่าค่าที่ระบุจนถึง --bes_outerr_chunk_size ก็ตาม
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--bes_outerr_chunk_size=<an integer>
: "1048576" -
ระบุขนาดสูงสุดของ Stdout หรือ Stderr ที่จะส่งไปยัง BEP ในข้อความเดียว
แท็ก:affects_outputs
- ค่าเริ่มต้น
--bes_proxy=<a string>
: ดูรายละเอียด - เชื่อมต่อกับบริการ Build Event ผ่านพร็อกซี ปัจจุบันแฟล็กนี้ใช้เพื่อกำหนดค่าซ็อกเก็ตโดเมน Unix (unix:/path/to/socket) ได้เท่านั้น
- ค่าเริ่มต้นของ
--bes_results_url=<a string>
: "" -
ระบุ URL ฐานที่ผู้ใช้จะดูข้อมูลที่สตรีมไปยังแบ็กเอนด์ BES ได้ Bazel จะแสดง URL ต่อท้ายด้วยรหัสคำขอ
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--bes_timeout=<An immutable length of time.>
: "0 วินาที" -
ระบุว่าควรรอนานเท่าใดเพื่อให้การอัปโหลด BES/BEP เสร็จสมบูรณ์หลังจากการสร้างและการทดสอบเสร็จสิ้นแล้ว ระยะหมดเวลาที่ถูกต้องจะเป็นจำนวนธรรมชาติตามด้วยหน่วย ได้แก่ วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) ค่าเริ่มต้นคือ "0" ซึ่งหมายความว่าไม่มีการหมดเวลา
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--build_event_binary_file=<a string>
: "" -
หากข้อมูลไม่ว่างเปล่า ให้เขียนการแสดงแทนแบบไบนารีที่คั่นด้วยการแปรผันตามการเป็นตัวแทนของโปรโตคอลเหตุการณ์บิลด์ไปยังไฟล์ดังกล่าว ตัวเลือกนี้หมายถึง --bes_upload_mode=wait_for_upload_complete
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]build_event_binary_file_path_conversion
: "จริง" -
แปลงเส้นทางในการนำเสนอไฟล์ไบนารีของโปรโตคอลเหตุการณ์บิลด์ให้เป็น URI ที่ใช้ได้ทั่วโลกมากขึ้นเมื่อเป็นไปได้ หากปิดใช้ ระบบจะใช้รูปแบบ file:// uri เสมอ
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--build_event_json_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้เขียนอนุกรม JSON ของโปรโตคอลเหตุการณ์บิลด์ไปยังไฟล์ดังกล่าว
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]build_event_json_file_path_conversion
: "จริง" -
แปลงเส้นทางในไฟล์ JSON ของโปรโตคอลเหตุการณ์บิลด์ให้เป็น URI ที่ใช้ได้ทั่วโลกมากขึ้นเมื่อเป็นไปได้ หากปิดใช้ ระบบจะใช้รูปแบบ file:// uri เสมอ
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--build_event_max_named_set_of_file_entries=<an integer>
: "-1" -
จำนวนรายการสูงสุดของเหตุการณ์ name_set_of_files เดียว ระบบจะไม่สนใจค่าที่น้อยกว่า 2 และไม่มีการแยกเหตุการณ์ โดยมีจุดประสงค์เพื่อจำกัดขนาดสูงสุดของเหตุการณ์ในโปรโตคอลเหตุการณ์ของบิลด์ แม้ว่าจะไม่ได้ควบคุมขนาดเหตุการณ์โดยตรง ขนาดเหตุการณ์ทั้งหมดเป็นฟังก์ชันของโครงสร้างของชุด ตลอดจนความยาวของไฟล์และ URI ซึ่งอาจขึ้นอยู่กับฟังก์ชันแฮช
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]build_event_publish_all_actions
: "เท็จ" -
ควรเผยแพร่การดำเนินการทั้งหมดหรือไม่
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--build_event_text_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้เขียนการแสดงข้อความของโปรโตคอลเหตุการณ์บิลด์ในไฟล์นั้น
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]build_event_text_file_path_conversion
: "จริง" -
แปลงเส้นทางในรูปแบบไฟล์ข้อความของโปรโตคอลเหตุการณ์บิลด์ให้เป็น URI ที่ใช้ได้ทั่วโลกมากขึ้นเมื่อเป็นไปได้ หากปิดใช้ ระบบจะใช้รูปแบบ file:// uri เสมอ
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]experimental_announce_profile_path
: "เท็จ" -
หากเปิดใช้ ให้เพิ่มเส้นทางโปรไฟล์ JSON ลงในบันทึก
แท็ก:affects_outputs
,bazel_monitoring
- ค่าเริ่มต้นของ
--[no]experimental_bep_target_summary
: "เท็จ" - ต้องการเผยแพร่เหตุการณ์ TargetSummary หรือไม่
- ค่าเริ่มต้นของ
--[no]experimental_build_event_expand_filesets
: "เท็จ" -
หากเป็น "จริง" ให้ขยายชุดไฟล์ใน BEP เมื่อนำเสนอไฟล์เอาต์พุต
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: "เท็จ" -
หากเป็น "จริง" ให้แปลงสัญลักษณ์ Fileset ที่เกี่ยวข้องอย่างสมบูรณ์ใน BEP เมื่อนำเสนอไฟล์เอาต์พุต ต้องใช้ --experimental_build_event_expand_filesets
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--experimental_build_event_upload_max_retries=<an integer>
: "4" -
จํานวนครั้งสูงสุดที่บาเซลควรลองอัปโหลดเหตุการณ์บิลด์อีกครั้ง
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1 วินาที" -
ขั้นแรกคือการหน่วงเวลาขั้นต่ำสำหรับการลองย้อนกลับแบบเอ็กซ์โปเนนเชียลเมื่อการอัปโหลด BEP ล้มเหลว (exponent: 1.6)
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--experimental_build_event_upload_strategy=<a string>
: ดูรายละเอียด -
เลือกวิธีอัปโหลดอาร์ติแฟกต์ที่อ้างอิงในโปรโตคอลเหตุการณ์ของบิลด์
แท็ก:affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--experimental_profile_additional_tasks=<phase, action, action_check, action_lock, action_release, action_update, action_complete, bzlmod, info, create_package, remote_execution, local_execution, scanner, local_parse, upload_time, process_time, remote_queue, remote_setup, fetch, vfs_stat, vfs_dir, vfs_readlink, vfs_md5, vfs_xattr, vfs_delete, vfs_open, vfs_read, vfs_write, vfs_glob, vfs_vmfs_stat, vfs_vmfs_dir, vfs_vmfs_read, wait, thread_name, thread_sort_index, skyframe_eval, skyfunction, critical_path, critical_path_component, handle_gc_notification, action_counts, local_cpu_usage, system_cpu_usage, local_memory_usage, system_memory_usage, system_network_up_usage, system_network_down_usage, workers_memory_usage, system_load_average, starlark_parser, starlark_user_fn, starlark_builtin_fn, starlark_user_compiled_fn, starlark_repository_fn, action_fs_staging, remote_cache_check, remote_download, remote_network, filesystem_traversal, worker_execution, worker_setup, worker_borrow, worker_working, worker_copying_outputs, credential_helper or unknown>
รายการ -
ระบุงานเพิ่มเติมของโปรไฟล์ที่จะรวมไว้ในโปรไฟล์
แท็ก:affects_outputs
,bazel_monitoring
- ค่าเริ่มต้นของ
--[no]experimental_profile_include_primary_output
: "เท็จ" -
รวมแอตทริบิวต์ "out" เพิ่มเติมในเหตุการณ์การดำเนินการที่มีเส้นทางการดำเนินการไปยังเอาต์พุตหลักของการดำเนินการ
แท็ก:affects_outputs
,bazel_monitoring
- ค่าเริ่มต้นของ
--[no]experimental_profile_include_target_label
: "เท็จ" -
รวมป้ายกำกับเป้าหมายในข้อมูลโปรไฟล์ JSON ของเหตุการณ์การดำเนินการ
แท็ก:affects_outputs
,bazel_monitoring
- ค่าเริ่มต้นของ
--[no]experimental_stream_log_file_uploads
: "เท็จ" -
ไฟล์บันทึกของสตรีมจะอัปโหลดไปยังพื้นที่เก็บข้อมูลระยะไกลโดยตรงแทนที่จะอัปโหลดลงในดิสก์
แท็ก:affects_outputs
- ค่าเริ่มต้น
--experimental_workspace_rules_log_file=<a path>
: ดูรายละเอียด - บันทึกเหตุการณ์กฎ Workspace บางรายการลงในไฟล์นี้เป็นโปรโตคอล WorkspaceEvent ที่คั่นด้วยอักขระ
- ค่าเริ่มต้นของ
--[no]generate_json_trace_profile
: "อัตโนมัติ" -
หากเปิดใช้ Bazel จะสร้างโปรไฟล์บิลด์และเขียนโปรไฟล์รูปแบบ JSON ลงในไฟล์ในฐานเอาต์พุต ดูโปรไฟล์โดยโหลดใน chrome://tracing โดยค่าเริ่มต้น Bazel จะเขียนโปรไฟล์สำหรับคำสั่งและคำค้นหาที่คล้ายบิลด์ทั้งหมด
แท็ก:affects_outputs
,bazel_monitoring
- ค่าเริ่มต้นของ
--[no]heap_dump_on_oom
: "เท็จ" -
ระบุว่าจะแสดงฮีพดัมพ์ด้วยตนเองหรือไม่ หากมีการส่ง OOM (รวมถึง OOM ที่เกิดจาก --experimental_oom_more_eagerly_threshold) ระบบจะเขียน Dump ไปยัง <output_base>/<invocation_id>.heapdump.hprof ตัวเลือกนี้จะแทนที่ -XX:+HeapDumpOnOutOfMemoryError อย่างมีประสิทธิภาพ ซึ่งไม่มีผลเนื่องจากระบบจับ OOM ไว้และเปลี่ยนเส้นทางไปยัง Runtime#halt
แท็ก:bazel_monitoring
- ค่าเริ่มต้นของ
--[no]legacy_important_outputs
: "จริง" -
ใช้สิ่งนี้เพื่อระงับการสร้างช่องimportant_controls เดิมในเหตุการณ์ TargetComplete ต้องมีimportant_outputs สำหรับการผสานรวม Bazel กับ ResultsStore
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--logging=<0 <= an integer <= 6>
: "3" -
ระดับการบันทึก
แท็ก:affects_outputs
- ค่าเริ่มต้น
--memory_profile=<a path>
: ดูรายละเอียด -
หากมีการตั้งค่า ให้เขียนข้อมูลการใช้งานหน่วยความจำไปยังไฟล์ที่ระบุเมื่อสิ้นสุดเฟสและเขียนฮีปที่เสถียรลงในบันทึกหลักเมื่อสิ้นสุดบิลด์
แท็ก:affects_outputs
,bazel_monitoring
- ค่าเริ่มต้นของ
--memory_profile_stable_heap_parameters=<integers, separated by a comma expected in pairs>
: "1,0" -
ปรับแต่งการคำนวณฮีปที่เสถียรของโปรไฟล์หน่วยความจำในช่วงท้ายของบิลด์ ควรเป็นเลขจำนวนเต็มคู่และคั่นด้วยคอมมา จำนวนเต็มแรกในแต่ละคู่คือจำนวน GC ที่จะดำเนินการ จำนวนเต็มที่ 2 ในแต่ละคู่คือจำนวนวินาทีที่จะรอระหว่าง GC เช่น 2, 4, 4,0 จะทำให้ GC จำนวน 2 ครั้งมีการหยุดชั่วคราว 4 วินาที ตามด้วย GC อีก 4 ครั้งที่มีการหยุดชั่วคราว 0 วินาที
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--profile=<a path>
: ดูรายละเอียด -
หากตั้งค่าแล้ว ให้สร้างโปรไฟล์ Bazel และเขียนข้อมูลไปยังไฟล์ที่ระบุ ใช้โปรไฟล์การวิเคราะห์แบบ Bazel เพื่อวิเคราะห์โปรไฟล์
แท็ก:affects_outputs
,bazel_monitoring
- ค่าเริ่มต้นของ
--[no]slim_profile
: "จริง" -
ลดขนาดของโปรไฟล์ JSON โดยการผสานรวมเหตุการณ์หากโปรไฟล์ใหญ่เกินไป
แท็ก:affects_outputs
,bazel_monitoring
- ค่าเริ่มต้นของ
--starlark_cpu_profile=<a string>
: "" -
เขียนโปรไฟล์ pprof ของการใช้งาน CPU โดยเทรด Starlark ทั้งหมดลงในไฟล์ที่ระบุ
แท็ก:bazel_monitoring
- ค่าเริ่มต้นของ
--tool_tag=<a string>
: "" -
ชื่อเครื่องมือที่จะระบุแหล่งที่มาของการเรียกใช้ Bazel นี้
แท็ก:affects_outputs
,bazel_monitoring
- รวมการใช้งานหลายรายการแล้ว
--ui_event_filters=<Convert list of comma separated event kind to list of filters>
รายการ -
ระบุเหตุการณ์ที่จะแสดงใน UI คุณจะเพิ่มหรือนำเหตุการณ์ออกจากเหตุการณ์เริ่มต้นได้โดยใช้เครื่องหมาย +/- นำหน้า หรือลบล้างชุดเริ่มต้นทั้งหมดด้วยการมอบหมายโดยตรง ชุดของประเภทเหตุการณ์ที่รองรับประกอบด้วย INFO, DEBUG, ERROR และอื่นๆ
แท็กterminal_output
- ตัวเลือกเบ็ดเตล็ด ที่ไม่ได้จัดอยู่ในหมวดหมู่อื่น:
- รวมการใช้งานหลายรายการแล้ว
--build_metadata=<a 'name=value' assignment>
รายการ -
คู่คีย์-ค่าที่กำหนดเองสำหรับใช้ในเหตุการณ์บิลด์
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--color=<yes, no or auto>
: "อัตโนมัติ" - ใช้การควบคุมเทอร์มินัลเพื่อกำหนดสีเอาต์พุต
- รวมการใช้งานหลายรายการแล้ว
--config=<a string>
รายการ - เลือกส่วนการกำหนดค่าเพิ่มเติมจากไฟล์ rc โดยทุกๆ <command> ระบบจะดึงตัวเลือกจาก <command>:<config> ด้วย หากมีส่วนดังกล่าว หากไม่มีส่วนดังกล่าวในไฟล์ .rc ระบบจะดำเนินการ Blaze ไม่สำเร็จและมีข้อผิดพลาด ส่วนการกำหนดค่าและชุดค่าผสมแฟล็กซึ่งเทียบเท่ากันจะอยู่ในไฟล์การกำหนดค่าเครื่องมือ/*.blazerc
- รวมการใช้งานหลายรายการแล้ว
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
รายการ - กำหนดค่าโปรแกรมช่วยข้อมูลเข้าสู่ระบบเพื่อใช้สำหรับเรียกข้อมูลเข้าสู่ระบบของการให้สิทธิ์สำหรับการดึงข้อมูลที่เก็บ การแคชและการดำเนินการจากระยะไกล รวมถึงบริการเหตุการณ์ของบิลด์ ข้อมูลเข้าสู่ระบบที่ผู้ช่วยเหลือมีให้จะมีความสำคัญเหนือกว่าข้อมูลรับรองที่ --google_default_credentials, --google_credentials, ไฟล์ .netrc หรือพารามิเตอร์ auth ไปยัง billing_ctx.download และ billing_ctx.download_and_extract นั้น อาจระบุได้หลายครั้งเพื่อตั้งค่าผู้ช่วยเหลือหลายราย ดูรายละเอียดได้ที่ https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md
- ค่าเริ่มต้นของ
--credential_helper_cache_duration=<An immutable length of time.>
: "30 นาที" - ระยะเวลาในการแคชข้อมูลเข้าสู่ระบบที่โปรแกรมช่วยรับรองข้อมูลเข้าสู่ระบบให้ไว้ การเรียกใช้ด้วยค่าที่แตกต่างกันจะปรับอายุการใช้งานของรายการที่มีอยู่ก่อนหน้า การส่งค่าเป็น 0 เพื่อล้างแคช คำสั่งสะอาดจะล้างแคชเสมอ โดยไม่คำนึงถึงแฟล็กนี้
- ค่าเริ่มต้นของ
--credential_helper_timeout=<An immutable length of time.>
: "10 วินาที" - กำหนดค่าระยะหมดเวลาสำหรับตัวช่วยข้อมูลเข้าสู่ระบบ ตัวช่วยข้อมูลเข้าสู่ระบบที่ไม่ตอบสนองภายในระยะหมดเวลานี้จะเรียกใช้ไม่สำเร็จ
- ค่าเริ่มต้นของ
--curses=<yes, no or auto>
: "อัตโนมัติ" - ใช้การควบคุมเคอร์เซอร์เทอร์มินัลเพื่อย่อเอาต์พุตการเลื่อนให้น้อยที่สุด
- ค่าเริ่มต้นของ
--[no]enable_platform_specific_config
: "เท็จ" - หากเป็น "จริง" Bazel จะรับบรรทัดการกำหนดค่าเฉพาะโฮสต์ของระบบปฏิบัติการจากไฟล์ bazelrc ตัวอย่างเช่น หากระบบปฏิบัติการของโฮสต์คือ Linux และคุณเรียกใช้บิลด์ Bazel แล้ว Bazel จะดึงข้อมูลบรรทัดที่ขึ้นต้นด้วย create:linux ตัวระบุระบบปฏิบัติการที่รองรับ ได้แก่ Linux, macos, Windows, Freebsd และ openbsd การเปิดใช้แฟล็กนี้เทียบเท่ากับการใช้ --config=linux ใน Linux, --config=windows ใน Windows ฯลฯ
- ค่าเริ่มต้นของ
--[no]experimental_skymeld_ui
: "เท็จ" -
แสดงทั้งการวิเคราะห์และความคืบหน้าของระยะการดำเนินการเมื่อทั้ง 2 อย่างทำงานพร้อมกัน
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]experimental_windows_watchfs
: "เท็จ" - หากเป็น "จริง" ระบบจะเปิดใช้การรองรับ Windows เวอร์ชันทดลองสำหรับ --watchfs มิฉะนั้น --watchfsis ไม่ใช่การดำเนินการใน Windows และอย่าลืมเปิดใช้ --watchfs
- ค่าเริ่มต้นของ
--google_auth_scopes=<comma-separated list of options>
: "https://www.googleapis.com/auth/cloud-platform" - รายการขอบเขตการตรวจสอบสิทธิ์ Google Cloud ที่คั่นด้วยคอมมา
- ค่าเริ่มต้น
--google_credentials=<a string>
: ดูรายละเอียด - ระบุไฟล์ที่จะรับข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication
- ค่าเริ่มต้นของ
--[no]google_default_credentials
: "เท็จ" - ระบุว่าจะใช้ "ข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชันของ Google" สำหรับการตรวจสอบสิทธิ์หรือไม่ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication ปิดใช้โดยค่าเริ่มต้น
- ค่าเริ่มต้น
--grpc_keepalive_time=<An immutable length of time.>
: ดูรายละเอียด - กำหนดค่าคําสั่ง ping แบบ Keep-alive สำหรับการเชื่อมต่อ gRPC ขาออก หากตั้งค่านี้ Bazel จะส่งคำสั่ง ping หลังจากไม่มีการดำเนินการอ่านการเชื่อมต่อเป็นเวลานานกว่านี้ แต่เฉพาะในกรณีที่มีการเรียกใช้ gRPC ที่รอดำเนินการอย่างน้อย 1 รายการ เวลาจะถือว่าเป็นรายละเอียดที่ 2 จึงถือเป็นข้อผิดพลาดในการตั้งค่าที่น้อยกว่า 1 วินาที โดยค่าเริ่มต้น การใช้คำสั่ง ping แบบ Keep-alive จะปิดใช้อยู่ คุณควรประสานงานกับเจ้าของบริการก่อนเปิดใช้การตั้งค่านี้ ตัวอย่างเช่น หากต้องการตั้งค่า 30 วินาทีเป็น Flag นี้ ก็ควรจะเป็น --grpc_keepalive_time=30s
- ค่าเริ่มต้นของ
--grpc_keepalive_timeout=<An immutable length of time.>
: "20 วินาที" - กำหนดค่าระยะหมดเวลา Keep-alive สำหรับการเชื่อมต่อ gRPC ขาออก หากเปิดใช้คำสั่ง ping แบบ Keep-alive พร้อมกับ --grpc_keepalive_time จากนั้น Bazel จะหมดเวลาการเชื่อมต่อหากไม่มีการตอบกลับคำสั่ง ping หลังผ่านไประยะหนึ่ง เวลาจะถือว่าเป็นรายละเอียดที่ 2 จึงถือเป็นข้อผิดพลาดในการตั้งค่าที่น้อยกว่า 1 วินาที หากปิดใช้คำสั่ง ping แบบ Keep-alive อยู่ ระบบจะไม่สนใจการตั้งค่านี้
- ค่าเริ่มต้นของ
--[no]incompatible_disallow_symlink_file_to_dir
: "จริง" -
หากตั้งค่าเป็น "จริง" "ctx.actions.symlink" จะไม่อนุญาตให้ลิงก์ไฟล์เข้ากับไดเรกทอรี
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remove_rule_name_parameter
: "จริง" -
หากตั้งค่าเป็น "จริง" ระบบจะเรียกใช้ "กฎ" ด้วยพารามิเตอร์ "name" ไม่ได้
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]progress_in_terminal_title
: "เท็จ" - แสดงความคืบหน้าของคำสั่งในชื่อเทอร์มินัล เครื่องมือนี้มีประโยชน์ในการดูว่า Bazel กำลังทำอะไรเมื่อมีแท็บเทอร์มินัลหลายแท็บ
- ค่าเริ่มต้นของ
--[no]show_progress
: "จริง" - แสดงข้อความความคืบหน้าระหว่างการสร้าง
- ค่าเริ่มต้นของ
--show_progress_rate_limit=<a double>
: "0.2" - จำนวนวินาทีขั้นต่ำระหว่างข้อความแสดงความคืบหน้าในเอาต์พุต
- ค่าเริ่มต้นของ
--[no]show_timestamps
: "เท็จ" - รวมการประทับเวลาในข้อความ
- ค่าเริ่มต้น
--tls_certificate=<a string>
: ดูรายละเอียด - ระบุเส้นทางไปยังใบรับรอง TLS ที่เชื่อถือได้ให้ลงนามในใบรับรองเซิร์ฟเวอร์
- ค่าเริ่มต้น
--tls_client_certificate=<a string>
: ดูรายละเอียด - ระบุใบรับรองไคลเอ็นต์ TLS ที่จะใช้ โดยต้องระบุคีย์ไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
- ค่าเริ่มต้น
--tls_client_key=<a string>
: ดูรายละเอียด - ระบุคีย์ไคลเอ็นต์ TLS ที่จะใช้ นอกจากนี้ คุณยังต้องระบุใบรับรองไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
- ค่าเริ่มต้นของ
--ui_actions_shown=<an integer>
: "8" -
จำนวนการดำเนินการที่เกิดขึ้นพร้อมกันจะแสดงในแถบความคืบหน้าโดยละเอียด โดยแต่ละการดำเนินการจะแสดงแยกบรรทัดกัน แถบความคืบหน้าจะแสดงอย่างน้อย 1 ตัวเสมอ และตัวเลขทั้งหมดที่น้อยกว่า 1 จะจับคู่กับ 1
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]watchfs
: "เท็จ" - ใน Linux/macOS: หากเป็น "จริง" Bazel จะพยายามใช้บริการดูไฟล์ของระบบปฏิบัติการเพื่อทำการเปลี่ยนแปลงในเครื่อง แทนที่จะสแกนหาการเปลี่ยนแปลงในทุกไฟล์ ใน Windows: การตั้งค่าสถานะนี้เป็นแบบไม่ใช่การทดสอบในขณะนี้ แต่สามารถเปิดใช้งานร่วมกับ --experimental_windows_watchfs ในระบบปฏิบัติการใดก็ตาม: ไม่มีการกำหนดลักษณะการทำงานนี้หากพื้นที่ทำงานอยู่ในระบบไฟล์ของเครือข่าย และมีการแก้ไขไฟล์ในเครื่องระยะไกล
ตัวเลือกการวิเคราะห์โปรไฟล์
- ตัวเลือกที่ปรากฏก่อนคำสั่งและถูกแยกวิเคราะห์โดยไคลเอ็นต์ ได้แก่
- รวมการใช้งานหลายรายการแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบแคช แทนที่จะคัดลอก โดยมีจุดประสงค์เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่มาจาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม ซึ่งสามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ส่งผลให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_repository_disable_download
: "เท็จ" -
หากมีการตั้งค่า ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองแก้ไขข้อผิดพลาดในการดาวน์โหลดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานได้ในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้นของ
--http_timeout_scaling=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลด HTTP ตามปัจจัยที่กำหนด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูรายละเอียด -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตการสร้างที่ถูกต้อง (การกำหนดกฎ การรวมแฟล็ก ฯลฯ)
- ค่าเริ่มต้นของ
--experimental_repository_hash_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรยืนยันแฮชไดเรกทอรีที่เก็บ
แท็ก:affects_outputs
,experimental
- รวมการใช้งานหลายรายการแล้ว
--experimental_verify_repository_rules=<a string>
รายการ -
หากรายการกฎที่เก็บซึ่งควรยืนยันแฮชของไดเรกทอรีเอาต์พุต ระบบจะระบุไฟล์โดย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ API ของบิลด์ที่เข้าถึงได้ด้วยการสร้างไฟล์ .bzl หรือไฟล์ WORKSPACE
- ค่าเริ่มต้นของ
--[no]experimental_allow_top_level_aspects_parameters
: "จริง" -
ไม่ดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
- รวมการใช้งานหลายรายการแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ซึ่งจะอนุญาตให้ใช้ในกราฟการอ้างอิงที่แก้ไขแล้วแม้ว่าจะมีการประกาศว่าได้รับการแย้งในรีจิสทรีที่เป็นแหล่งที่มา (หากเว็บไซต์ไม่ได้มาจาก NonRegistryReplace) มิฉะนั้น เวอร์ชันที่ยัดเยียดจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชัน yank ที่อนุญาตได้ด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" คุณสามารถปิดใช้งานการตรวจสอบนี้ได้โดยใช้คำหลัก "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ หรือ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบว่าข้อมูลไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบที่ไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าทรัพยากร Dependency ดังกล่าวจะถูกละเว้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท โดยไม่คำนึงถึงค่าของแฟล็กนี้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--lockfile_mode=<off, update or error>
: "ปิด" -
ระบุว่าจะใช้ Lockfile อย่างไรและจะใช้หรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ Lockfile และอัปเดตเมื่อมีการเปลี่ยนแปลง "ข้อผิดพลาด" ให้ใช้ Lockfile แต่จะแสดงข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่ออ่านหรือเขียนไฟล์ล็อกทั้ง 2 ไฟล์
แท็ก: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
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งการบันทึกมีดังนี้
--dump=<text or raw>
[-d
] ค่าเริ่มต้น: ดูรายละเอียด-
ส่งออกข้อมูลโปรไฟล์แบบเต็มในรูปแบบ "ข้อความ" ที่มนุษย์อ่านได้หรือรูปแบบ "ข้อมูลดิบ" ที่เหมาะกับสคริปต์
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]experimental_record_metrics_for_all_mnemonics
: "เท็จ" - โดยค่าเริ่มต้น ประเภทการดําเนินการจะจํากัดอยู่ที่ 20 ประเภทที่มีจำนวนการดำเนินการสูงสุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสําหรับการช่วยจำทั้งหมด
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปในคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ มีดังนี้
- ค่าเริ่มต้นของ
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
หากเว้นว่างไว้ ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล
- ค่าเริ่มต้น
--experimental_downloader_config=<a string>
: ดูรายละเอียด - ระบุไฟล์ที่จะใช้กำหนดค่าเครื่องมือดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด โดยแต่ละบรรทัดจะขึ้นต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือ 2 รูปแบบ รูปแบบหนึ่งเพื่อจับคู่กับ และอีกแบบหนึ่งใช้เป็น URL แทนโดยมีการอ้างอิงย้อนกลับที่เริ่มจาก "$1" เป็นไปได้ที่คำสั่ง "rewrite" อาจมีผลลัพธ์ใน URL เดียวกันหลายรายการ และระบบจะส่ง URL เดียวกันนี้กลับไปหลายรายการสำหรับ URL เดียวกัน)
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้จัดหมวดหมู่:
- รวมการใช้งานหลายรายการแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace"
ตัวเลือก Aquery
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคำสั่งและถูกแยกวิเคราะห์โดยไคลเอ็นต์ ได้แก่
- รวมการใช้งานหลายรายการแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบแคช แทนที่จะคัดลอก โดยมีจุดประสงค์เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่มาจาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม ซึ่งสามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ส่งผลให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_repository_disable_download
: "เท็จ" -
หากมีการตั้งค่า ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองแก้ไขข้อผิดพลาดในการดาวน์โหลดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานได้ในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้นของ
--http_timeout_scaling=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลด HTTP ตามปัจจัยที่กำหนด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูรายละเอียด -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตการสร้างที่ถูกต้อง (การกำหนดกฎ การรวมแฟล็ก ฯลฯ)
- ค่าเริ่มต้นของ
--experimental_repository_hash_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรยืนยันแฮชไดเรกทอรีที่เก็บ
แท็ก:affects_outputs
,experimental
- รวมการใช้งานหลายรายการแล้ว
--experimental_verify_repository_rules=<a string>
รายการ -
หากรายการกฎที่เก็บซึ่งควรยืนยันแฮชของไดเรกทอรีเอาต์พุต ระบบจะระบุไฟล์โดย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ API ของบิลด์ที่เข้าถึงได้ด้วยการสร้างไฟล์ .bzl หรือไฟล์ WORKSPACE
- ค่าเริ่มต้นของ
--[no]experimental_allow_top_level_aspects_parameters
: "จริง" -
ไม่มีการดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตการค้นหาและความหมาย
- ค่าเริ่มต้นของ
--aspect_deps=<off, conservative or precise>
: "ดั้งเดิม" -
วิธีแก้ไขทรัพยากร Dependency ของสัดส่วนภาพเมื่อรูปแบบเอาต์พุตเป็นหนึ่งใน {xml,ctr,record} "off" หมายถึงไม่มีการสรุปทรัพยากร Dependency "เชิงรับ" (ค่าเริ่มต้น) หมายถึงการเพิ่มทรัพยากร Dependency ที่ประกาศไว้ทั้งหมด โดยไม่คำนึงว่าจะได้รับคลาสกฎของทรัพยากร Dependency โดยตรงหรือไม่ "แม่นยำ" หมายความว่ามีการเพิ่มเฉพาะส่วนที่อาจใช้งานได้ตามคลาสกฎของทรัพยากร Dependency โดยตรง โปรดทราบว่าโหมดความแม่นยำจำเป็นต้องมีการโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียวและทำให้ทำงานช้ากว่าโหมดอื่นๆ นอกจากนี้ โปรดทราบว่าแม้แต่โหมดความแม่นยำก็ไม่แม่นยำทั้งหมด การตัดสินใจว่าจะคำนวณด้านใดด้านหนึ่งหรือไม่นั้น จะตัดสินใจในขั้นตอนการวิเคราะห์ ซึ่งจะไม่ทำงานระหว่าง "การค้นหาแบบ Bazel"
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--[no]consistent_labels
: "เท็จ" -
หากเปิดใช้ คำสั่งการค้นหาทุกรายการจะส่งป้ายกำกับออกมาเสมือนว่าฟังก์ชัน Starlark <code>str</code> ใช้กับอินสแตนซ์ <code>Label</code> ซึ่งจะเป็นประโยชน์สำหรับเครื่องมือที่จำเป็นต้องจับคู่เอาต์พุตของคำสั่งการค้นหาและ/หรือป้ายกำกับต่างๆ ที่กฎเรียกใช้ หากไม่ได้เปิดใช้ ตัวจัดรูปแบบเอาต์พุตจะปล่อยชื่อที่เก็บที่ชัดเจน (สัมพันธ์กับที่เก็บหลัก) แทนเพื่อทำให้เอาต์พุตอ่านได้ง่ายขึ้น
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]deduplicate_depsets
: "จริง" -
กรององค์ประกอบย่อยที่ไม่ใช่ Leaf ที่ซ้ำกันออกจากไฟล์ dep_set_of_files ในเอาต์พุต Proto/textctr/json สุดท้าย การดำเนินการนี้จะไม่กรองรายการที่ซ้ำกันออกซึ่งไม่ได้มีระดับบนสุดร่วมกับคุณ การดำเนินการนี้จะไม่ส่งผลต่อรายการอาร์ติแฟกต์อินพุตที่มีประสิทธิภาพขั้นสุดท้ายของการดำเนินการดังกล่าว
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]graph:factored
: "จริง" -
หากเป็น "จริง" กราฟจะปล่อยออกมาเป็น "แยกส่วน" กล่าวคือ โหนดที่เทียบเคียงกับโทโพโลยีจะถูกผสานเข้าด้วยกันและต่อป้ายกำกับของโหนดต่อกัน ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--graph:node_limit=<an integer>
: "512" -
ความยาวสูงสุดของสตริงป้ายกำกับสำหรับโหนดกราฟในเอาต์พุต ระบบจะตัดป้ายกำกับที่ยาวขึ้น โดย -1 หมายความว่าไม่มีการตัดข้อความ ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]implicit_deps
: "จริง" -
หากเปิดใช้ ทรัพยากร Dependency โดยนัยจะรวมอยู่ในกราฟการอ้างอิงที่การค้นหาดังกล่าวดำเนินการอยู่ ทรัพยากร Dependency โดยนัยคือทรัพยากร Dependency ที่ไม่ได้ระบุอย่างชัดเจนในไฟล์ BUILD แต่เพิ่มโดย Bazel สำหรับ cquery ตัวเลือกนี้ควบคุมการกรองชุดเครื่องมือที่แก้ไขแล้ว
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--[no]include_artifacts
: "จริง" -
มีชื่ออินพุตและเอาต์พุตการดำเนินการในเอาต์พุต (อาจมีขนาดใหญ่)
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]include_aspects
: "จริง" -
aquery, cquery: จะรวมการดำเนินการที่สร้างโดยมุมมองในเอาต์พุตหรือไม่ query: no-op (ติดตามด้านต่างๆ เสมอ)
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]include_commandline
: "จริง" -
รวมเนื้อหาของบรรทัดคำสั่งการดำเนินการในเอาต์พุต (อาจมีขนาดใหญ่)
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]include_file_write_contents
: "เท็จ" -
รวมเนื้อหาไฟล์สำหรับการดำเนินการ FileWrite และ SourceSymlinkManifest (อาจมีขนาดใหญ่)
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]include_param_files
: "เท็จ" -
รวมเนื้อหาของไฟล์พารามิเตอร์ที่ใช้ในคำสั่ง (อาจมีขนาดใหญ่) หมายเหตุ: การเปิดใช้การตั้งค่าสถานะนี้จะเป็นการเปิดใช้แฟล็ก --include_commandline โดยอัตโนมัติ
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]incompatible_display_source_file_location
: "จริง" -
"จริง" จะแสดงเป้าหมายของไฟล์ต้นฉบับโดยค่าเริ่มต้น หากเป็น "จริง" จะแสดงตำแหน่งของบรรทัดที่ 1 ของไฟล์ต้นฉบับในเอาต์พุตตำแหน่ง แฟล็กนี้มีไว้เพื่อวัตถุประสงค์ในการย้ายข้อมูลเท่านั้น
แท็ก:terminal_output
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_package_group_includes_double_slash
: "จริง" -
หากเปิดใช้ เมื่อเอาต์พุตแอตทริบิวต์ `packages` ของ package_group จะไม่ละเว้น `//` ที่นำหน้า
แท็ก:terminal_output
,incompatible_change
- ค่าเริ่มต้นของ
--[no]infer_universe_scope
: "เท็จ" -
หากไม่ได้ตั้งค่า และ --universe_scope อยู่ ระบบจะอนุมานค่าของ --universe_scope เป็นรายการรูปแบบเป้าหมายที่ไม่ซ้ำกันในนิพจน์การค้นหา โปรดทราบว่าค่า --universe_scope ที่อนุมานสำหรับนิพจน์การค้นหาที่ใช้ฟังก์ชันขอบเขตระดับจักรวาล (เช่น "allrdeps") อาจไม่ใช่ค่าที่คุณต้องการ คุณจึงควรใช้ตัวเลือกนี้ก็ต่อเมื่อคุณรู้ว่าคุณกำลังทำอะไรอยู่เท่านั้น ดูรายละเอียดและตัวอย่างได้ที่ https://bazel.build/reference/query#sky-query หากตั้งค่า --universe_scope ไว้ ระบบจะไม่พิจารณาค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้มีผลกับ "ข้อความค้นหา" เท่านั้น (กล่าวคือ ไม่ใช่ "cquery")
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]line_terminator_null
: "เท็จ" -
ระบุว่าแต่ละรูปแบบจะลงท้ายด้วย \0 แทนที่จะเป็นบรรทัดใหม่หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]nodep_deps
: "จริง" -
หากเปิดใช้ คำสั่ง deps จาก "nodep" จะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาดังกล่าวดำเนินการอยู่ ตัวอย่างทั่วไปของแอตทริบิวต์ "nodep" คือ "visibility" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ "infobuild-language" เพื่อดูข้อมูลเกี่ยวกับแอตทริบิวต์ "nodep" ทั้งหมดในภาษาบิลด์
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--output=<a string>
: "ข้อความ" -
รูปแบบที่ควรพิมพ์ผลลัพธ์การค้นหา ค่าที่อนุญาตสำหรับ aquery ได้แก่ text, textplo, Proto, jsonctr
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:default_values
: "จริง" -
หากเป็น "จริง" ระบบจะรวมแอตทริบิวต์ที่ไม่ได้ระบุค่าไว้อย่างชัดเจนในไฟล์ BUILD มิเช่นนั้นระบบจะละเว้นแอตทริบิวต์เหล่านั้น ตัวเลือกนี้ใช้ได้กับ --เอาต์พุต=โปรโตคอล
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:definition_stack
: "เท็จ" -
ป้อนข้อมูลช่อง Proto คำจำกัดความ ซึ่งจะบันทึกสำหรับอินสแตนซ์ของกฎแต่ละรายการที่สแต็กการเรียกใช้ Starlark ทันทีที่มีการกำหนดคลาสของกฎ
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:flatten_selects
: "จริง" -
หากเปิดใช้ ระบบจะรวมแอตทริบิวต์ที่กำหนดค่าได้ซึ่งสร้างด้วย select() ออก สำหรับประเภทรายการ การนำเสนอแบบรวมคือรายการที่มีแต่ละค่าของแผนที่ที่เลือกเพียงครั้งเดียว ประเภท Scalar จะถูกแบนเป็น Null
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--[no]proto:include_synthetic_attribute_hash
: "เท็จ" -
ระบุว่าจะคำนวณและป้อนข้อมูลแอตทริบิวต์ $internal_attr_hash หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:instantiation_stack
: "เท็จ" -
สร้างสแต็กการเรียกใช้อินสแตนซ์ของแต่ละกฎ โปรดทราบว่าการดำเนินการนี้ต้องมีสแต็ก
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:locations
: "จริง" -
กำหนดว่าจะแสดงข้อมูลตำแหน่งในเอาต์พุต Pro หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--proto:output_rule_attrs=<comma-separated list of options>
: "ทั้งหมด" -
รายการแอตทริบิวต์ที่คั่นด้วยคอมมาที่จะรวมไว้ในเอาต์พุต ค่าเริ่มต้นคือแอตทริบิวต์ทั้งหมด ตั้งค่าเป็นสตริงว่างเพื่อไม่ให้มีแอตทริบิวต์ใดๆ ทั้งสิ้น ตัวเลือกนี้ใช้ได้กับ --เอาต์พุต=โปรโตคอล
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:rule_inputs_and_outputs
: "จริง" -
ระบุว่าจะสร้างช่อง report_input และ rules_เอาต์พุต หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--query_file=<a string>
: "" -
หากตั้งค่าแล้ว การค้นหาจะอ่านการค้นหาจากไฟล์ที่มีชื่อที่นี่ ไม่ใช่ในบรรทัดคำสั่ง ข้อผิดพลาดในการระบุไฟล์ที่นี่ รวมถึงการค้นหาบรรทัดคำสั่ง
แท็ก:changes_inputs
- ค่าเริ่มต้นของ
--[no]relative_locations
: "เท็จ" -
หากเป็นจริง ตำแหน่งของไฟล์ BUILD ใน XML และเอาต์พุตโปรโตจะสัมพันธ์กัน โดยค่าเริ่มต้น เอาต์พุตของตำแหน่งจะเป็นเส้นทางสัมบูรณ์และจะไม่สอดคล้องกันในแต่ละเครื่อง คุณสามารถตั้งตัวเลือกนี้เป็น "จริง" เพื่อให้ผลลัพธ์สอดคล้องกันในคอมพิวเตอร์ทุกเครื่อง
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]skyframe_state
: "เท็จ" -
โดยไม่ทำการวิเคราะห์เพิ่มเติม ให้ถ่ายโอนกราฟการดำเนินการปัจจุบันจาก Skyframe หมายเหตุ: ปัจจุบันระบบยังไม่รองรับการระบุเป้าหมายด้วย --skyframe_state แฟล็กนี้ใช้ได้เฉพาะกับ --control=proto หรือ --เอาต์พุต=textสอง
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]tool_deps
: "จริง" -
คำค้นหา: หากปิดใช้ ทรัพยากร Dependency ของเป้าหมาย "การกำหนดค่าโฮสต์" หรือ "การดำเนินการ" จะไม่รวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาดังกล่าวดำเนินการอยู่ Edge ของทรัพยากร Dependency "การกำหนดค่าโฮสต์" เช่น กฎจากกฎ "Proto_library" ใดก็ตามไปยังโปรโตคอลคอมไพเลอร์ (โปรโตคอลคอมไพเลอร์) มักจะชี้ไปยังเครื่องมือที่ดำเนินการระหว่างการสร้างแทนที่จะเป็นส่วนหนึ่งของโปรแกรม "target" เดียวกัน
ค้นหา: หากปิดใช้ ให้กรองเป้าหมายที่กำหนดค่าไว้ทั้งหมดซึ่งข้ามโฮสต์หรือการเปลี่ยนการดำเนินการจากเป้าหมายระดับบนสุดที่ค้นพบเป้าหมายที่กำหนดค่าไว้นี้ออก ซึ่งหมายความว่าหากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าเป้าหมาย ระบบจะแสดงผลเฉพาะเป้าหมายที่กำหนดค่าในการกำหนดค่าเป้าหมายด้วยเท่านั้น หากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าโฮสต์ ระบบจะแสดงเฉพาะเป้าหมายที่กำหนดค่าไว้ของโฮสต์เท่านั้น ตัวเลือกนี้จะไม่ยกเว้นห่วงโซ่เครื่องมือที่แก้ไขแล้ว
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--universe_scope=<comma-separated list of options>
: "" -
ชุดรูปแบบเป้าหมายที่คั่นด้วยคอมมา (การบวกและการลบ) การค้นหาอาจดำเนินการในจักรวาลที่กำหนดโดยการปิดทางอ้อมของเป้าหมายที่ระบุ ตัวเลือกนี้ใช้สำหรับคำค้นหาและคำสั่ง cquery
สำหรับ cquery อินพุตไปยังตัวเลือกนี้จะเป็นเป้าหมายคำตอบทั้งหมดที่สร้างขึ้น ดังนั้นตัวเลือกนี้จึงอาจส่งผลต่อการกำหนดค่าและการเปลี่ยน หากไม่ได้ระบุตัวเลือกนี้ ระบบจะถือว่าเป้าหมายระดับบนสุดเป็นเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหา หมายเหตุ: สำหรับ cquery การไม่ระบุตัวเลือกนี้อาจทำให้บิลด์เสียหายได้ หากเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหาไม่สามารถสร้างได้ด้วยตัวเลือกระดับบนสุด
แท็ก:loading_and_analysis
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุต Bzlmod และอรรถศาสตร์:
- รวมการใช้งานหลายรายการแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ซึ่งจะอนุญาตให้ใช้ในกราฟการอ้างอิงที่แก้ไขแล้วแม้ว่าจะมีการประกาศว่าได้รับการแย้งในรีจิสทรีที่เป็นแหล่งที่มา (หากเว็บไซต์ไม่ได้มาจาก NonRegistryReplace) มิฉะนั้น เวอร์ชันที่ยัดเยียดจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชัน yank ที่อนุญาตได้ด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" คุณสามารถปิดใช้งานการตรวจสอบนี้ได้โดยใช้คำหลัก "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ หรือ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบว่าข้อมูลไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบที่ไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าทรัพยากร Dependency ดังกล่าวจะถูกละเว้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท โดยไม่คำนึงถึงค่าของแฟล็กนี้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--lockfile_mode=<off, update or error>
: "ปิด" -
ระบุว่าจะใช้ Lockfile อย่างไรและจะใช้หรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ Lockfile และอัปเดตเมื่อมีการเปลี่ยนแปลง "ข้อผิดพลาด" ให้ใช้ Lockfile แต่จะแสดงข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่ออ่านหรือเขียนไฟล์ล็อกทั้ง 2 ไฟล์
แท็ก: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
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งการบันทึกมีดังนี้
- ค่าเริ่มต้นของ
--[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") หรือ 2 รูปแบบ รูปแบบหนึ่งเพื่อจับคู่กับ และอีกแบบหนึ่งใช้เป็น URL แทนโดยมีการอ้างอิงย้อนกลับที่เริ่มจาก "$1" เป็นไปได้ที่คำสั่ง "rewrite" อาจมีผลลัพธ์ใน URL เดียวกันหลายรายการ และระบบจะส่ง URL เดียวกันนี้กลับไปหลายรายการสำหรับ URL เดียวกัน)
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้จัดหมวดหมู่:
- รวมการใช้งานหลายรายการแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace"
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์
- ค่าเริ่มต้นของ
--[no]experimental_inprocess_symlink_creation
: "เท็จ" -
ไม่ว่าจะเป็นการเรียกใช้ระบบไฟล์โดยตรงเพื่อสร้างต้นไม้ลิงก์สัญลักษณ์
แท็ก:loading_and_analysis
,execution
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_remotable_source_manifests
: "เท็จ" -
ไม่ว่าจะเป็นการทำให้การดำเนินการในไฟล์ Manifest ของแหล่งที่มาทำงานซ้ำได้
แท็ก:loading_and_analysis
,execution
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_split_coverage_postprocessing
: "เท็จ" -
หากเป็น "จริง" Bazel จะเรียกใช้การประมวลผลภายหลังการครอบคลุมเพื่อทดสอบในการวางรูปแบบใหม่
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]experimental_strict_fileset_output
: "เท็จ" -
หากเปิดใช้ตัวเลือกนี้ ชุดไฟล์จะถือว่าอาร์ติแฟกต์เอาต์พุตทั้งหมดเป็นไฟล์ปกติ และจะไม่ข้ามผ่านไดเรกทอรีหรือไวต่อลิงก์สัญลักษณ์
แท็ก:execution
- ค่าเริ่มต้นของ
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
: "" -
เพิ่มหรือนำคีย์ออกจากข้อมูลการดำเนินการของการดำเนินการตามคำสั่งจำเพาะ ใช้กับการดำเนินการที่รองรับข้อมูลการดำเนินการเท่านั้น การดำเนินการทั่วไปหลายรายการรองรับข้อมูลการดำเนินการ เช่น GenRule, CppCompile, Javac, StarlarkAction, TestRunner เมื่อระบุค่าหลายค่า การจัดเรียงจะมีความสำคัญเนื่องจาก regexe หลายรายการอาจใช้กับการช่วยจำเดียวกัน
ไวยากรณ์: "regex=[+-]key,regex=[+-]key,..."
เช่น '.*=+x,.*=-y,.*=+z' จะเพิ่ม "x" และ "z" ลงในและนำ "y" ออกจากข้อมูลการดำเนินการสำหรับการดำเนินการทั้งหมด
"GenRule=+requires-x" เพิ่ม "requires-x" ไปยังข้อมูลการดำเนินการสำหรับการดำเนินการ GenRule ทั้งหมด
"(?!GenRule).*=-requires-x" จะนำ "requires-x" ออกจากข้อมูลการดำเนินการสำหรับการดำเนินการทั้งหมดที่ไม่ใช่ประเภท
แท็ก:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
เปิดใช้ Android Dex และเครื่องมือลดน้ำตาลแบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--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
{/1/}
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_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
{/1/}
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
-
เปิดใช้เครื่องมือ Android แบบต่อเนื่องและแบบมัลติเพล็กซ์ (การแยกออก การกรองน้ำตาล การประมวลผลทรัพยากร)
ขยายไปยัง
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
แท็ก:host_machine_resource_optimizations
,execution
- ตัวเลือกที่กำหนดค่าห่วงโซ่เครื่องมือที่ใช้สำหรับการดำเนินการ
- ค่าเริ่มต้น
--android_compiler=<a string>
: ดูรายละเอียด -
คอมไพเลอร์เป้าหมายของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_crosstool_top=<a build target label>
: "//external:android/crosstool" -
ตำแหน่งของคอมไพเลอร์ C++ ที่ใช้สำหรับบิลด์ของ Android
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--android_grte_top=<a label>
: ดูรายละเอียด -
เป้าหมาย Android คือ grte_top
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_manifest_merger=<legacy, android or force_android>
: "android" -
เลือกการผสานไฟล์ Manifest เพื่อใช้กับกฎ android_binary แจ้งเพื่อช่วยในการเปลี่ยนจากการควบรวมกิจการเดิมไปเป็นการ ผสานรวมไฟล์ Manifest ของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_platforms=<a build target label>
: "" -
ตั้งค่าแพลตฟอร์มที่เป้าหมายของ android_binary ใช้ หากระบุหลายแพลตฟอร์ม ไบนารีจะเป็น APK แบบอ้วน ซึ่งประกอบด้วยไบนารีแบบเนทีฟสำหรับแต่ละแพลตฟอร์มเป้าหมายที่ระบุ
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/android:sdk"-
ระบุ SDK/แพลตฟอร์ม Android ที่ใช้สร้างแอปพลิเคชัน Android
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--apple_compiler=<a string>
: ดูรายละเอียด -
คอมไพเลอร์เป้าหมายของ Apple มีประโยชน์สำหรับการเลือกตัวแปรของ Toolchain (เช่น xcode-beta)
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้ในกฎ Apple และ Objc รวมถึงทรัพยากร Dependency
แท็ก:loses_incremental_state
,changes_inputs
- ค่าเริ่มต้น
--apple_grte_top=<a build target label>
: ดูรายละเอียด -
เป้าหมายของ Apple คือ grte_top
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--cc_output_directory_tag=<a string>
: "" -
ระบุส่วนต่อท้ายที่จะเพิ่มในไดเรกทอรีการกำหนดค่า
แท็ก:affects_outputs
,explicit_in_output_path
- ค่าเริ่มต้น
--compiler=<a string>
: ดูรายละเอียด -
คอมไพเลอร์ C++ ที่จะใช้สำหรับการคอมไพล์เป้าหมาย
แท็ก:loading_and_analysis
,execution
- ค่าเริ่มต้นของ
--coverage_output_generator=<a build target label>
: "@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_generate" -
ตำแหน่งของไบนารีที่ใช้ในการสร้างรายงานการครอบคลุม ปัจจุบันนี้ต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดี่ยว ซึ่งก็คือไบนารี มีค่าเริ่มต้นเป็น "//tools/test:coverage_report_generate"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_support"-
ตำแหน่งของไฟล์สนับสนุนที่จำเป็นต้องมีในอินพุตของการดำเนินการทดสอบทุกรายการที่รวบรวมความครอบคลุมของโค้ด มีค่าเริ่มต้นเป็น "//tools/test:coverage_support"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้ในการคอมไพล์โค้ด C++
แท็ก:loading_and_analysis
,changes_inputs
,affects_outputs
- ค่าเริ่มต้น
--custom_malloc=<a build target label>
: ดูรายละเอียด -
ระบุการใช้งาน Malloc ที่กําหนดเอง การตั้งค่านี้จะลบล้างแอตทริบิวต์ Malloc ในกฎบิลด์
แท็ก:changes_inputs
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
รายการ -
รายการนิพจน์ทั่วไปที่คั่นด้วยเครื่องหมายจุลภาค ซึ่งแต่ละรายการจะขึ้นต้นด้วย - (นิพจน์เชิงลบ) ที่กำหนด (=) ให้กับรายการเป้าหมายค่าจำกัดที่คั่นด้วยคอมมา หากเป้าหมายตรงกับไม่มีนิพจน์เชิงลบและนิพจน์เชิงบวกอย่างน้อย 1 รายการจะดำเนินการแก้ปัญหา Toolchain เสมือนได้ประกาศว่าค่าข้อจำกัดเป็นข้อจำกัดการดำเนินการ ตัวอย่างเช่น //demo,-test=@platforms//cpus:x86_64 จะเพิ่ม "x86_64" ไปยังเป้าหมายใดๆ ภายใต้ //demo ยกเว้นชื่อที่มีคำว่า "test"
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]experimental_enable_objc_cc_deps
: "จริง" -
อนุญาตให้กฎ objc_* ขึ้นอยู่กับ cc_library และทำให้มีการสร้างทรัพยากร Dependency ของ objc ด้วย --cpu ที่ตั้งค่าเป็น "ios_<--ios_cpu>" สำหรับค่าใดก็ได้ใน --ios_multi_cpu
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]experimental_include_xcode_execution_requirements
: "เท็จ" -
หากตั้งค่าไว้ ให้เพิ่มข้อกำหนดการดำเนินการ "requires-xcode:{version}" ลงในการดำเนินการ Xcode ทุกรายการ หากเวอร์ชัน xcode มีป้ายกำกับแบบขีดกลาง ให้เพิ่มข้อกำหนดการดำเนินการ "requires-xcode-label:{version_label}" ด้วย
แท็ก:loses_incremental_state
,loading_and_analysis
,execution
- ค่าเริ่มต้นของ
--[no]experimental_prefer_mutual_xcode
: "จริง" -
หากเป็นจริง ให้ใช้ Xcode ล่าสุดที่พร้อมใช้งานทั้งในเครื่องและจากระยะไกล หากเป็น "เท็จ" หรือหากไม่มีเวอร์ชันที่ใช้ร่วมกัน ให้ใช้เวอร์ชัน Xcode ในเครื่องที่เลือกผ่าน xcode-select
แท็ก:loses_incremental_state
- รวมการใช้งานหลายรายการแล้ว
--extra_execution_platforms=<comma-separated list of options>
รายการ -
แพลตฟอร์มที่ใช้เป็นแพลตฟอร์มการดำเนินการเพื่อเรียกใช้การดำเนินการ คุณระบุแพลตฟอร์มตามเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมายก็ได้ เราจะพิจารณาแพลตฟอร์มเหล่านี้ก่อนแพลตฟอร์มที่ประกาศในไฟล์ WORKSPACE โดย registration_execution_platforms()
แท็ก:execution
- รวมการใช้งานหลายรายการแล้ว
--extra_toolchains=<comma-separated list of options>
รายการ -
กฎเชนเครื่องมือที่จะต้องพิจารณาในระหว่างการแก้ปัญหา Toolchain สามารถระบุ Toolchain ตามเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมายก็ได้ เชนเครื่องมือเหล่านี้จะได้รับการพิจารณาก่อนที่มีการประกาศในไฟล์ WORKSPACE โดย registration_toolchains()
แท็ก ได้แก่affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--grte_top=<a label>
: ดูรายละเอียด -
ป้ายกำกับไปยังไลบรารี 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>
: ดูรายละเอียด -
โดยค่าเริ่มต้น ตัวเลือก --crosstool_top และ --Compositr ยังใช้กับการกำหนดค่าโฮสต์ได้ด้วย หากมีแฟล็กนี้ Bazel จะใช้ libc และคอมไพเลอร์ที่เป็นค่าเริ่มต้นสำหรับ Crosstool_top ที่กำหนด
แท็ก:loading_and_analysis
,changes_inputs
,affects_outputs
- ค่าเริ่มต้น
--host_grte_top=<a label>
: ดูรายละเอียด -
หากระบุ การตั้งค่านี้จะลบล้างไดเรกทอรีระดับบนสุดของ libc (--grte_top) สำหรับการกำหนดค่าโฮสต์
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้นของ
--host_platform=<a build target label>
: "" -
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายระบบโฮสต์
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]incompatible_disable_expand_if_all_available_in_flag_set
: "จริง" -
หากเป็น "จริง" Bazel จะไม่อนุญาตให้ระบุexpand_if_all_available ในFlag_sets(ดูวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/7008)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "จริง" -
หากเป็น "จริง" Bazel จะไม่เปิดใช้ฟีเจอร์ "โฮสต์" และ "ไม่ใช่โฮสต์" ใน Toolchain c++ (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/7407)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_enable_android_toolchain_resolution
: "เท็จ" -
ใช้การแปลงเชนเครื่องมือเพื่อเลือก Android SDK สำหรับกฎของ Android (Starlark และเนทีฟ)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_enable_apple_toolchain_resolution
: "เท็จ" -
ใช้การแปลงเชนเครื่องมือเพื่อเลือก Apple SDK สำหรับกฎของ Apple (Starlark และเนทีฟ)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_make_thinlto_command_lines_standalone
: "จริง" -
หากเป็น "จริง" Bazel จะไม่นำบรรทัดคำสั่งการดำเนินการลิงก์ C++ มาใช้ซ้ำสำหรับบรรทัดคำสั่งการจัดทำดัชนี lto (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/6791)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
: "จริง" -
หากเป็น "จริง" Bazel จะร้องเรียนเมื่อตั้งค่าแอตทริบิวต์ cc_toolchain.cpu และ cc_toolchain.คอมไพเลอร์ (ดูวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/7075)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remove_legacy_whole_archive
: "จริง" -
หากเป็น "จริง" Bazel จะไม่ลิงก์ทรัพยากร Dependency ของไลบรารีเป็นที่เก็บถาวรทั้งหมดโดยค่าเริ่มต้น (ดูวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/7362)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_require_ctx_in_configure_features
: "จริง" -
หากเป็น "จริง" Bazel จะต้องใช้พารามิเตอร์ "ctx" ใน cc_common.สตรีม_features (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/7793)
แท็ก:loading_and_analysis
,incompatible_change
-
ใช้ออบเจ็กต์ที่ใช้ร่วมกันของอินเทอร์เฟซหาก Toolchain รองรับ ปัจจุบันชุดเครื่องมือของ ELF ทั้งหมดรองรับการตั้งค่านี้
แท็ก:loading_and_analysis
,affects_outputs
,affects_outputs
- ค่าเริ่มต้น
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
ระบุเวอร์ชันของ iOS SDK ที่จะใช้สร้างแอปพลิเคชัน iOS หากไม่ระบุ ให้ใช้เวอร์ชัน iOS SDK เริ่มต้นจาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
ระบุเวอร์ชันของ macOS SDK ที่จะใช้สร้างแอปพลิเคชัน macOS หากไม่ระบุ ให้ใช้เวอร์ชัน macOS SDK เริ่มต้นจาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--minimum_os_version=<a string>
: ดูรายละเอียด -
เวอร์ชันระบบปฏิบัติการขั้นต่ำที่การคอมไพล์กำหนดเป้าหมาย
แท็ก:loading_and_analysis
,affects_outputs
- ค่าเริ่มต้นของ
--platform_mappings=<a relative path>
: "" -
ตำแหน่งของไฟล์การแมปซึ่งอธิบายว่าจะใช้แพลตฟอร์มใดหากไม่ได้ตั้งค่าไว้ หรือควรตั้งค่าแฟล็กใดเมื่อแพลตฟอร์มมีอยู่แล้ว ต้องสัมพันธ์กับรูทของพื้นที่ทำงานหลัก ค่าเริ่มต้นจะเป็น "platform_mappings" (ไฟล์ใต้รูทของพื้นที่ทํางานโดยตรง)
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--platforms=<a build target label>
: "" -
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายแพลตฟอร์มเป้าหมายสำหรับคำสั่งปัจจุบัน
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--python2_path=<a string>
: ดูรายละเอียด -
เลิกใช้งาน ปิดใช้ ปิดใช้โดย "--incompatible_use_python_toolchains"
แท็ก:no_op
,deprecated
- ค่าเริ่มต้น
--python3_path=<a string>
: ดูรายละเอียด -
เลิกใช้งาน ปิดใช้ ปิดใช้โดย "--incompatible_use_python_toolchains"
แท็ก:no_op
,deprecated
- ค่าเริ่มต้น
--python_path=<a string>
: ดูรายละเอียด -
มีการเรียกใช้เส้นทางสัมบูรณ์ของล่าม Python เพื่อเรียกใช้เป้าหมาย Python บนแพลตฟอร์มเป้าหมาย เลิกใช้งาน ปิดใช้โดย --incompatible_use_python_toolchains
แท็ก:loading_and_analysis
,affects_outputs
- ค่าเริ่มต้น
--python_top=<a build target label>
: ดูรายละเอียด -
ป้ายกำกับของ py_runtime ที่สื่อถึงอินเทอร์พรีเตอร์ของ Python ถูกเรียกใช้เพื่อเรียกใช้เป้าหมาย Python บนแพลตฟอร์มเป้าหมาย เลิกใช้งาน ปิดใช้โดย --incompatible_use_python_toolchains
แท็ก:loading_and_analysis
,affects_outputs
- ค่าเริ่มต้นของ
--target_platform_fallback=<a build target label>
: "@local_config_platform//:host" -
ป้ายกำกับของกฎแพลตฟอร์มที่ควรใช้หากไม่ได้ตั้งค่าแพลตฟอร์มเป้าหมายและไม่มีการแมปแพลตฟอร์มที่ตรงกับชุดแฟล็กปัจจุบัน
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
ระบุเวอร์ชันของ tvOS SDK ที่จะใช้สร้างแอปพลิเคชัน tvOS หากไม่ระบุ ให้ใช้เวอร์ชัน tvOS SDK เริ่มต้นจาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
ระบุเวอร์ชันของ watchOS SDK ที่จะใช้สร้างแอปพลิเคชัน watchOS หากไม่ระบุ ให้ใช้เวอร์ชัน WatchOS SDK เริ่มต้นจาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--xcode_version=<a string>
: ดูรายละเอียด -
หากระบุไว้ ให้ใช้ Xcode ของเวอร์ชันที่ระบุสำหรับการดำเนินการบิลด์ที่เกี่ยวข้อง หากไม่ระบุ ให้ใช้ Xcode เวอร์ชันเริ่มต้นของไฟล์ปฏิบัติการ
แท็ก:loses_incremental_state
--xcode_version_config=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:host_xcodes"-
ป้ายกำกับของกฎ xcode_config ที่จะใช้สำหรับเลือกเวอร์ชัน Xcode ในการกำหนดค่าบิลด์
แท็ก:loses_incremental_state
,loading_and_analysis
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่ง มีดังนี้
- ค่าเริ่มต้นของ
--[no]apple_enable_auto_dsym_dbg
: "เท็จ" -
กำหนดว่าจะบังคับให้สร้างไฟล์สัญลักษณ์การแก้ไขข้อบกพร่อง (.dSYM) สำหรับบิลด์ dbg หรือไม่
แท็ก:affects_outputs
,action_command_lines
- ค่าเริ่มต้นของ
--[no]apple_generate_dsym
: "เท็จ" -
ต้องการสร้างไฟล์สัญลักษณ์การแก้ไขข้อบกพร่อง (.dSYM) หรือไม่
แท็ก:affects_outputs
,action_command_lines
- ค่าเริ่มต้นของ
--[no]build_runfile_links
: "จริง" -
หากเป็น "จริง" ให้สร้างฟอเรสต์สัญลักษณ์ซิมลิงก์ของ Runfile สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้เขียนเฉพาะไฟล์ Manifest เมื่อเป็นไปได้
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]build_runfile_manifests
: "จริง" -
หากเป็น "จริง" ให้เขียนไฟล์ Manifest สำหรับไฟล์ Manifest สำหรับเป้าหมายทั้งหมด หากเป็นเท็จ ให้ข้าม ทำการทดสอบในเครื่องไม่ได้เมื่อเป็นเท็จ
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]build_test_dwp
: "เท็จ" -
หากเปิดใช้ เมื่อสร้างการทดสอบ C++ แบบคงที่และในการแยกส่วน ระบบจะสร้างไฟล์ .dwp สำหรับไบนารีทดสอบโดยอัตโนมัติด้วยเช่นกัน
แท็ก:loading_and_analysis
,affects_outputs
- ค่าเริ่มต้นของ
--cc_proto_library_header_suffixes=<comma-separated list of options>
: ".pb.h" -
ตั้งค่าคำนำหน้าของไฟล์ส่วนหัวที่ cc_master_library สร้างขึ้น
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--cc_proto_library_source_suffixes=<comma-separated list of options>
: ".pb.cc" -
ตั้งค่าคำนำหน้าของไฟล์ต้นฉบับที่ cc_promo_library สร้างขึ้น
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]experimental_proto_descriptor_sets_include_source_info
: "เท็จ" -
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันสำรองใน proto_library
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_proto_extra_actions
: "เท็จ" -
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันสำรองใน proto_library
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_save_feature_state
: "เท็จ" -
บันทึกสถานะของฟีเจอร์ที่เปิดใช้และที่ขอเป็นเอาต์พุตของการคอมไพล์
แท็ก:affects_outputs
,experimental
- ค่าเริ่มต้นของ
--fission=<a set of compilation modes>
: "ไม่" -
ระบุว่าโหมดการรวบรวมใดจะใช้ Fission สำหรับการรวบรวมและลิงก์ C++ อาจเป็นการผสมกันระหว่าง {'fastbuild', 'dbg', 'opt'} หรือค่าพิเศษ "yes" เพื่อเปิดใช้ทุกโหมด และ "no" เพื่อปิดใช้ทุกโหมด
แท็ก:loading_and_analysis
,action_command_lines
,affects_outputs
- ค่าเริ่มต้นของ
--[no]incompatible_always_include_files_in_data
: "จริง" -
หากเป็น "จริง" กฎเนทีฟจะเพิ่ม <code>DefaultInfo.files</code> ของทรัพยากร Dependency ไปยังไฟล์ Runfile ซึ่งตรงกับลักษณะการทํางานที่แนะนำสำหรับกฎ Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid)
แท็ก:affects_outputs
,incompatible_change
- ค่าเริ่มต้นของ
--[no]legacy_external_runfiles
: "จริง" -
หากเป็น "จริง" ให้สร้างฟอเรสต์ลิงก์สัญลักษณ์ของ Runfiles สำหรับที่เก็บภายนอกภายใต้ .runfiles/wsname/external/repo (นอกเหนือจาก .runfiles/repo)
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]objc_generate_linkmap
: "เท็จ" -
ระบุว่าจะสร้างไฟล์ Linkmap หรือไม่
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]save_temps
: "เท็จ" -
หากตั้งค่าไว้ ระบบจะบันทึกเอาต์พุตชั่วคราวจาก gcc ซึ่งได้แก่ ไฟล์ .s (โค้ด Assembler), ไฟล์ .i (ไฟล์ C ที่ประมวลผลไว้ล่วงหน้า) และไฟล์ .ii (C++ ที่ประมวลผลไว้ล่วงหน้า)
แท็ก:affects_outputs
- ตัวเลือกที่ให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการซึ่งส่งผลต่อค่า ตรงข้ามกับที่มีอยู่
- รวมการใช้งานหลายรายการแล้ว
--action_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกำหนดค่าเป้าหมาย คุณระบุตัวแปรตามชื่อได้ ซึ่งในกรณีนี้ ค่าจะนำมาจากสภาพแวดล้อมการเรียกใช้ หรือตามคู่ name=value ซึ่งตั้งค่าโดยไม่ขึ้นกับสภาพแวดล้อมการเรียกใช้ ตัวเลือกนี้สามารถใช้ได้หลายครั้ง สำหรับตัวเลือกที่มีให้สำหรับตัวแปรเดียวกัน ตัวเลือกที่ชนะล่าสุด ตัวเลือกสำหรับตัวแปรต่างๆ จะสะสมกัน
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--android_cpu=<a string>
: "armeabi-v7a" -
CPU เป้าหมายของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--[no]android_databinding_use_androidx
: "เท็จ" -
สร้างไฟล์การเชื่อมโยงข้อมูลที่ใช้กับ AndroidX ได้ ใช้กับการเชื่อมโยงข้อมูล v2 เท่านั้น
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้นของ
--[no]android_databinding_use_v3_4_args
: "เท็จ" -
ใช้ android databinding v2 ที่มีอาร์กิวเมนต์ 3.4.0
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้นของ
--android_dynamic_mode=<off, default or fully>
: "ปิด" -
กำหนดว่าจะลิงก์ Deps C++ ของกฎ Android แบบไดนามิกหรือไม่เมื่อ cc_binary ไม่ได้สร้างไลบรารีที่ใช้ร่วมกันอย่างชัดเจน "ค่าเริ่มต้น" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "เต็มรูปแบบ" หมายความว่าไลบรารีทั้งหมดจะลิงก์แบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "ตามลำดับตัวอักษร" -
กำหนดลำดับของไฟล์ Manifest ที่ส่งไปยังการผสานไฟล์ Manifest สำหรับไบนารี Android ALPHABETical หมายถึงไฟล์ Manifest จะจัดเรียงตามเส้นทางที่สัมพันธ์กับไฟล์ปฏิบัติการ ALPHABETical_BY_CONFIGURATION หมายถึงไฟล์ Manifest จะจัดเรียงตามเส้นทางที่สัมพันธ์กับไดเรกทอรีการกำหนดค่าภายในไดเรกทอรีเอาต์พุต DEPENDENCY หมายถึงไฟล์ Manifest ที่มีการจัดลำดับไฟล์ Manifest ของไลบรารีแต่ละแห่งก่อนไฟล์ Manifest ของทรัพยากร Dependency
แท็ก:action_command_lines
,execution
- ค่าเริ่มต้นของ
--[no]android_resource_shrinking
: "เท็จ" -
เปิดใช้การย่อทรัพยากรสำหรับ APK ของ android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
,loading_and_analysis
- รวมการใช้งานหลายรายการแล้ว
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, visionos, watchos, tvos, macos or catalyst>
รายการ -
ระบุโหมดบิตโค้ดของ Apple สำหรับขั้นตอนการคอมไพล์ขั้นตอนที่กำหนดเป้าหมายสถาปัตยกรรมของอุปกรณ์ ค่าอยู่ในรูปแบบ "[platform=]mode" โดยที่แพลตฟอร์ม (ซึ่งต้องเป็น "ios", "macos", "tvos" หรือ "watchos") เป็นตัวเลือกที่ไม่บังคับ หากระบุ ระบบจะใช้โหมดบิตโค้ดสำหรับแพลตฟอร์มนั้นโดยเฉพาะ หากไม่ระบุ โหมดนี้จะใช้กับทุกแพลตฟอร์ม โหมดต้องเป็น "none", "embedded_markers" หรือ "embedded" ตัวเลือกนี้อาจระบุได้หลายครั้ง
แท็ก:loses_incremental_state
- ค่าเริ่มต้นของ
--[no]build_python_zip
: "อัตโนมัติ" -
สร้างไฟล์ไฟล์ปฏิบัติการ Python ใน Windows ปิดบนแพลตฟอร์มอื่นๆ
แท็ก:affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--catalyst_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาที่จะสร้างไบนารี Apple Catalyst
แท็ก:loses_incremental_state
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]collect_code_coverage
: "เท็จ" -
หากระบุไว้ Bazel จะใช้โค้ดวัดคุม (โดยใช้การวัดคุมแบบออฟไลน์หากเป็นไปได้) และจะรวบรวมข้อมูลการครอบคลุมระหว่างการทดสอบ เฉพาะเป้าหมายที่ตรงกับ --instrumentation_filter เท่านั้นที่จะได้รับผลกระทบ โดยปกติไม่ควรระบุตัวเลือกนี้โดยตรง ควรใช้คำสั่ง 'bazelดีไซน์' แทน
แท็ก:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] ค่าเริ่มต้น: " Fastbuild"-
ระบุโหมดที่จะสร้างไบนารีในตัว ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
,action_command_lines
,explicit_in_output_path
- รวมการใช้งานหลายรายการแล้ว
--conlyopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--copt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้นของ
--cpu=<a string>
: "" -
CPU เป้าหมาย
แท็ก:changes_inputs
,affects_outputs
,explicit_in_output_path
- ค่าเริ่มต้น
--cs_fdo_absolute_path=<a string>
: ดูรายละเอียด -
ใช้ข้อมูลโปรไฟล์ CSFDO เพื่อเพิ่มประสิทธิภาพการรวบรวม ระบุชื่อเส้นทางสัมบูรณ์ของไฟล์ ZIP ที่มีไฟล์โปรไฟล์ ไฟล์ข้อมูล RAW หรือไฟล์โปรไฟล์ LLVM ที่จัดทำดัชนีแล้ว
แท็ก:affects_outputs
- ค่าเริ่มต้น
--cs_fdo_instrument=<a string>
: ดูรายละเอียด -
สร้างไบนารีด้วยเครื่องมือ FDO ที่คำนึงถึงบริบท เมื่อใช้คอมไพเลอร์ Clang/LLVM คอมไพเลอร์จะยอมรับชื่อไดเรกทอรีที่จะใช้ถ่ายโอนไฟล์โปรไฟล์ดิบขณะรันไทม์ด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--cs_fdo_profile=<a build target label>
: ดูรายละเอียด -
cs_fdo_profile ที่แสดงถึงโปรไฟล์ที่คำนึงถึงบริบทเพื่อใช้สำหรับการเพิ่มประสิทธิภาพ
แท็ก:affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--cxxopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C++
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--define=<a 'name=value' assignment>
รายการ -
ตัวเลือก --define แต่ละตัวเลือกจะระบุการมอบหมายสำหรับตัวแปรบิลด์
แท็ก:changes_inputs
,affects_outputs
- ค่าเริ่มต้นของ
--dynamic_mode=<off, default or fully>
: "ค่าเริ่มต้น" -
กำหนดว่าจะลิงก์ไบนารี C++ แบบไดนามิกหรือไม่ "ค่าเริ่มต้น" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "เต็มรูปแบบ" หมายความว่าไลบรารีทั้งหมดจะลิงก์แบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก:loading_and_analysis
,affects_outputs
- ค่าเริ่มต้นของ
--[no]enable_fdo_profile_absolute_path
: "จริง" -
หากตั้งค่าไว้ การใช้ fdo_absolute_profile_path จะทำให้เกิดข้อผิดพลาด
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]enable_runfiles
: "อัตโนมัติ" -
เปิดใช้โครงสร้าง Symlink ของ Runfiles ซึ่งระบบจะปิดใช้ใน Windows ในแพลตฟอร์มอื่นๆ โดยค่าเริ่มต้น
แท็ก:affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--experimental_action_listener=<a build target label>
รายการ -
เลิกใช้งานเพื่อสนับสนุนแง่มุมต่างๆ ใช้ action_listener เพื่อแนบ external_action เข้ากับการดำเนินการของบิลด์ที่มีอยู่
แท็ก:execution
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_android_compress_java_resources
: "เท็จ" -
บีบอัดทรัพยากร Java ใน APK
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_android_databinding_v2
: "เท็จ" -
ใช้ Android Databinding v2
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_android_resource_shrinking
: "เท็จ" -
เปิดใช้การย่อทรัพยากรสำหรับ APK ของ android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]experimental_android_rewrite_dexes_with_rex
: "เท็จ" -
ใช้เครื่องมือ Rex เพื่อเขียนไฟล์ dex ใหม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_collect_code_coverage_for_generated_files
: "เท็จ" -
หากระบุไว้ Bazel จะสร้างการรวบรวมข้อมูลการครอบคลุมสำหรับไฟล์ที่สร้างขึ้นด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--experimental_objc_fastbuild_options=<comma-separated list of options>
: "-O0,-DDEBUG=1" -
ใช้สตริงเหล่านี้เป็นตัวเลือกคอมไพเลอร์ Fastbuild ของ objc
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--[no]experimental_omitfp
: "เท็จ" -
หากเป็น "จริง" ให้ใช้ libunwind เพื่อคลายการคลายสแต็ก และคอมไพล์ด้วย -fomit-frame-pointer และ -fแบบอะซิงโครนัส-unwind-tables
แท็ก:action_command_lines
,affects_outputs
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_platform_in_output_dir
: "เท็จ" -
หากเป็น "จริง" ระบบจะใช้แพลตฟอร์มเป้าหมายในชื่อไดเรกทอรีเอาต์พุตแทน CPU
แท็ก:affects_outputs
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_use_llvm_covmap
: "เท็จ" -
หากระบุ Bazel จะสร้างข้อมูลแผนที่การครอบคลุม llvm-cov แทน gcov เมื่อเปิดใช้collect_code_coverage
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--fat_apk_cpu=<comma-separated list of options>
: "armeabi-v7a" -
การตั้งค่าตัวเลือกนี้จะเปิดใช้ APK แบบไขมัน ซึ่งมีไบนารีเนทีฟสำหรับสถาปัตยกรรมเป้าหมายที่ระบุทั้งหมด เช่น --fat_apk_cpu=x86,armeabi-v7a. หากมีการระบุแฟล็กนี้ --android_cpu จะถูกละเว้นสำหรับทรัพยากร Dependency ของกฎ android_binary
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--[no]fat_apk_hwasan
: "เท็จ" -
กำหนดว่าจะสร้างการแยก HWASAN หรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--fdo_instrument=<a string>
: ดูรายละเอียด -
สร้างไบนารีด้วยการวัดคุม FDO เมื่อใช้คอมไพเลอร์ Clang/LLVM คอมไพเลอร์จะยอมรับชื่อไดเรกทอรีที่จะใช้ถ่ายโอนไฟล์โปรไฟล์ดิบขณะรันไทม์ด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_optimize=<a string>
: ดูรายละเอียด -
ใช้ข้อมูลโปรไฟล์ FDO เพื่อเพิ่มประสิทธิภาพการรวบรวม ระบุชื่อไฟล์ ZIP ที่มีโครงสร้างไฟล์ .gcda, ไฟล์ afdo ที่มีโปรไฟล์อัตโนมัติ หรือไฟล์โปรไฟล์ LLVM แฟล็กนี้ยังยอมรับไฟล์ที่ระบุเป็นป้ายกำกับด้วย (เช่น `//foo/bar:file.afdo` คุณอาจต้องเพิ่มคำสั่ง "exports_files" ไปยังแพ็กเกจที่เกี่ยวข้อง) และป้ายกำกับที่ชี้ไปยังเป้าหมาย `fdo_profile` ธงนี้จะถูกแทนที่โดยกฎ "fdo_profile"
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_prefetch_hints=<a build target label>
: ดูรายละเอียด -
ใช้คำแนะนำในการดึงข้อมูลแคชล่วงหน้า
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_profile=<a build target label>
: ดูรายละเอียด -
fdo_profile ที่แสดงถึงโปรไฟล์ที่จะใช้ในการเพิ่มประสิทธิภาพ
แท็ก:affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--features=<a string>
รายการ -
ระบบจะเปิดหรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างในการกำหนดค่าเป้าหมาย การระบุ -<feature> จะเป็นการปิดใช้ฟีเจอร์นี้ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ ดู --host_features
แท็ก:changes_inputs
,affects_outputs
- ค่าเริ่มต้นของ
--[no]force_pic
: "เท็จ" -
หากเปิดใช้ การคอมไพล์ C++ ทั้งหมดจะสร้างโค้ดที่ไม่ขึ้นอยู่กับตำแหน่ง ("-fPIC") ลิงก์จะเลือกไลบรารีที่สร้างไว้ล่วงหน้าของ PIC มากกว่าไลบรารีที่ไม่ใช่ PIC และลิงก์จะสร้างไฟล์ปฏิบัติการที่ไม่ขึ้นกับตำแหน่ง ("-pie")
แท็ก:loading_and_analysis
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--host_action_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุชุดตัวแปรสภาพแวดล้อมที่พร้อมใช้งานสำหรับการดำเนินการที่มีการกำหนดค่าโฮสต์หรือการดำเนินการ คุณระบุตัวแปรตามชื่อได้ ซึ่งในกรณีนี้ ค่าจะนำมาจากสภาพแวดล้อมการเรียกใช้ หรือตามคู่ name=value ซึ่งตั้งค่าโดยไม่ขึ้นกับสภาพแวดล้อมการเรียกใช้ ตัวเลือกนี้สามารถใช้ได้หลายครั้ง สำหรับตัวเลือกที่มีให้สำหรับตัวแปรเดียวกัน ตัวเลือกที่ชนะล่าสุด ตัวเลือกสำหรับตัวแปรต่างๆ จะสะสมกัน
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--host_compilation_mode=<fastbuild, dbg or opt>
: "เลือกใช้" -
ระบุโหมดที่จะใช้ในการสร้างเครื่องมือในระหว่างบิลด์ ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
,action_command_lines
- รวมการใช้งานหลายรายการแล้ว
--host_conlyopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C สำหรับเครื่องมือของโฮสต์
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--host_copt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc สำหรับเครื่องมือของโฮสต์
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้นของ
--host_cpu=<a string>
: "" -
CPU ของโฮสต์
แท็ก:changes_inputs
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--host_cxxopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc สำหรับเครื่องมือของโฮสต์
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--host_features=<a string>
รายการ -
ฟีเจอร์ที่ระบุจะเปิดหรือปิดใช้งานโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างขึ้นในการกำหนดค่า exec การระบุ -<feature> จะเป็นการปิดใช้ฟีเจอร์นี้ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ
แท็ก:changes_inputs
,affects_outputs
- ค่าเริ่มต้น
--host_force_python=<PY2 or PY3>
: ดูรายละเอียด -
ลบล้างเวอร์ชัน Python สำหรับการกำหนดค่าโฮสต์ อาจเป็น "PY2" หรือ "PY3"
แท็ก:loading_and_analysis
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--host_linkopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc เมื่อลิงก์เครื่องมือโฮสต์
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้น
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
เวอร์ชัน macOS ขั้นต่ำที่เข้ากันได้สำหรับเป้าหมายโฮสต์ หากไม่ระบุ ให้ใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
- รวมการใช้งานหลายรายการแล้ว
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับเลือกส่งไปยังคอมไพเลอร์ C/C++ เมื่อคอมไพล์บางไฟล์ในการกำหนดค่าโฮสต์หรือโฮสต์ ตัวเลือกนี้สามารถส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจากรายการรูปแบบ "รวม" และ "ยกเว้นนิพจน์ทั่วไป" (ดู --instrumentation_filter ด้วย) Option_1 ถึง Option_n แทนตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบ็กสแลชเข้าไป ตัวเลือกจะมี @ ได้ แต่จะใช้ @ แรกเท่านั้นเพื่อแยกสตริง ตัวอย่างเช่น --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--host_swiftcopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งผ่านไปยัง swiftc สำหรับเครื่องมือของโฮสต์
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้นของ
--[no]incompatible_avoid_conflict_dlls
: "จริง" -
หากเปิดใช้ ไลบรารีที่ลิงก์แบบไดนามิกของ C++ (DLL) ทั้งหมดที่ cc_library ใน Windows จะสร้างขึ้นจะเปลี่ยนชื่อเป็น name_{hash}.dll พร้อมกับคำนวณแฮชโดยอิงตาม RepositoryName และเส้นทางแพ็กเกจของ DLL ตัวเลือกนี้จะมีประโยชน์เมื่อคุณมีแพ็กเกจเดียว ซึ่งขึ้นอยู่กับ cc_library หลายรายการที่มีชื่อเดียวกัน (เช่น //foo/bar1:utils และ //foo/bar2:utils)
แท็ก:loading_and_analysis
,affects_outputs
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_merge_genfiles_directory
: "จริง" -
หากเป็น "จริง" ระบบจะพับไดเรกทอรี genfiles ไว้ในไดเรกทอรี Bin
แท็ก:affects_outputs
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_use_host_features
: "เท็จ" -
หากเป็น "จริง" ให้ใช้ --features เฉพาะสำหรับการกำหนดค่าเป้าหมายและ --host_features สำหรับการกำหนดค่าการดำเนินการ
แท็ก:changes_inputs
,affects_outputs
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_use_platforms_repo_for_constraints
: "จริง" -
หากเป็น "จริง" ระบบจะนำการตั้งค่าข้อจำกัดจาก @bazel_tools ออก
แท็ก:affects_outputs
,incompatible_change
- ค่าเริ่มต้นของ
--[no]instrument_test_targets
: "เท็จ" -
เมื่อเปิดใช้การครอบคลุม ให้ระบุว่าจะพิจารณาการใช้กฎการทดสอบหรือไม่ เมื่อตั้งค่าแล้ว กฎการทดสอบที่ --instrumentation_filter รวมไว้จะถูกวัดคุม มิฉะนั้น กฎทดสอบจะถูกยกเว้นจากการวัดคุมการครอบคลุมเสมอ
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-/javatests[/:],-/test/java[/:]" -
เมื่อเปิดใช้การครอบคลุม จะมีการใช้เฉพาะกฎที่มีชื่อซึ่งตัวกรองที่อิงตามนิพจน์ทั่วไปที่ระบุเท่านั้น กฎที่ขึ้นต้นด้วย '-' จะถูกยกเว้นแทน โปรดทราบว่าจะมีการวัดเฉพาะกฎที่ไม่ใช่การทดสอบเท่านั้น เว้นแต่จะเปิดใช้ --instrument_test_targets
แท็ก:affects_outputs
- ค่าเริ่มต้น
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
เวอร์ชัน iOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองและอุปกรณ์เป้าหมาย หากไม่ระบุ ให้ใช้ "ios_sdk_version"
แท็ก:loses_incremental_state
- รวมการใช้งานหลายรายการแล้ว
--ios_multi_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้าง ios_application ผลลัพธ์คือไบนารีสากลที่มีสถาปัตยกรรมที่ระบุทั้งหมด
แท็ก:loses_incremental_state
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]legacy_whole_archive
: "จริง" -
เลิกใช้งาน ซึ่งถูกแทนที่โดย --incompatible_remove_legacy_whole_archive (ดูรายละเอียดที่ https://github.com/bazelbuild/bazel/issues/7362) เมื่อเปิด ให้ใช้ --whole-archive สำหรับกฎ cc_binary ที่มี linkshared=True และ linkstatic=True หรือ "-static" ใน linkopts มีไว้สำหรับความเข้ากันได้แบบย้อนหลังเท่านั้น ทางเลือกที่ดีกว่าคือการใช้ Alwayslink=1 เมื่อจำเป็น
แท็ก:action_command_lines
,affects_outputs
,deprecated
- รวมการใช้งานหลายรายการแล้ว
--linkopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc เมื่อลิงก์
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--ltobackendopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังขั้นตอนแบ็กเอนด์ของ LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--ltoindexopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังขั้นตอนการจัดทำดัชนี LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--macos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple macOS
แท็ก:loses_incremental_state
,loading_and_analysis
- ค่าเริ่มต้น
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
เวอร์ชัน macOS ขั้นต่ำที่เข้ากันได้สำหรับเป้าหมาย หากไม่ระบุ ให้ใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้นของ
--[no]objc_debug_with_GLIBCXX
: "เท็จ" -
หากตั้งค่าและตั้งค่าโหมดการรวบรวมเป็น "dbg" ให้กำหนด GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC และ GLIBCPP_CONCEPT_CheckS
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--[no]objc_enable_binary_stripping
: "เท็จ" -
กำหนดว่าจะดำเนินการตัดสัญลักษณ์และถอดรหัสแบบเดดโค้ดในไบนารีที่ลิงก์หรือไม่ จะมีการดำเนินการตัดไบนารีหากมีการระบุทั้ง Flag และ --compilation_mode=opt นี้
แท็ก:action_command_lines
- รวมการใช้งานหลายรายการแล้ว
--objccopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ Objective-C/C++
แท็ก:action_command_lines
- รวมการใช้งานหลายรายการแล้ว
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมในการเลือกส่งผ่านไปยัง gcc เมื่อคอมไพล์บางไฟล์ ตัวเลือกนี้สามารถส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจากรายการรูปแบบ "รวม" และ "ยกเว้นนิพจน์ทั่วไป" (ดู --instrumentation_filter ด้วย) Option_1 ถึง Option_n แทนตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบ็กสแลชเข้าไป ตัวเลือกจะมี @ ได้ แต่จะใช้ @ แรกเท่านั้นเพื่อแยกสตริง ตัวอย่างเช่น --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อเลือกส่งผ่านไปยังแบ็กเอนด์ LTO (ในส่วน --features=thin_lto) เมื่อคอมไพล์ออบเจ็กต์แบ็กเอนด์บางรายการ ตัวเลือกนี้สามารถส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n ที่ regex_filter คือรายการรูปแบบการรวมและยกเว้นนิพจน์ทั่วไป Option_1 ถึง Option_n แทนตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบ็กสแลชเข้าไป ตัวเลือกจะมี @ ได้ แต่จะใช้ @ แรกเท่านั้นเพื่อแยกสตริง ตัวอย่างเช่น --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ลงในบรรทัดคำสั่งแบ็กเอนด์ LTO ของไฟล์ o ทั้งหมดใน //foo/ ยกเว้น bar.o
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้น
--platform_suffix=<a string>
: ดูรายละเอียด -
ระบุส่วนต่อท้ายที่จะเพิ่มในไดเรกทอรีการกำหนดค่า
แท็ก:loses_incremental_state
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--propeller_optimize=<a build target label>
: ดูรายละเอียด -
ใช้ข้อมูลโปรไฟล์ Propeller เพื่อเพิ่มประสิทธิภาพเป้าหมายของบิลด์ โปรไฟล์ใบพัดต้องมีอย่างน้อย 1 จาก 2 ไฟล์ โปรไฟล์ 1 ใน 2 ไฟล์ และโปรไฟล์ ld แฟล็กนี้ยอมรับป้ายกำกับบิลด์ซึ่งต้องอ้างอิงถึงไฟล์อินพุตโปรไฟล์ใบพัด ตัวอย่างเช่น ไฟล์ BUILD ที่กำหนดป้ายกำกับใน a/b/BUILD:profeller_ optimize( name = "profeller_profile", cc_profile = "profeller_cc_profile.txt", ld_profile = "profeller_ld_profile.txt",)เพิ่มคำสั่ง export_files ลงในแพ็กเกจที่เกี่ยวข้องเพื่อให้ Bazel ดูไฟล์เหล่านี้ได้ ต้องใช้ตัวเลือกเป็น --profeller_Optimize=//a/b:profeller_profile
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้น
--propeller_optimize_absolute_cc_profile=<a string>
: ดูรายละเอียด -
ชื่อเส้นทางสัมบูรณ์ของไฟล์ cc_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพของ Propeller
แท็ก:affects_outputs
- ค่าเริ่มต้น
--propeller_optimize_absolute_ld_profile=<a string>
: ดูรายละเอียด -
ชื่อเส้นทางสัมบูรณ์ของไฟล์ ld_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพ Propeller
แท็ก:affects_outputs
- ค่าเริ่มต้น
--run_under=<a prefix in front of command>
: ดูรายละเอียด -
คำนำหน้าที่จะแทรกหน้าไฟล์ปฏิบัติการสำหรับคำสั่ง "test" และ "run" หากค่าเป็น "foo -bar" และบรรทัดคำสั่งการดำเนินการคือ "test_binary -baz" บรรทัดคำสั่งสุดท้ายจะเป็น "foo -bar test_binary -baz" บรรทัดนี้อาจเป็นป้ายกำกับของเป้าหมายปฏิบัติการด้วย ตัวอย่างเช่น: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'
แท็ก:action_command_lines
-
หากเป็นจริง ระบบจะแชร์ไลบรารีแบบเนทีฟที่มีฟังก์ชันการทำงานเหมือนกันกับเป้าหมายต่างๆ
แท็กต่อไปนี้loading_and_analysis
,affects_outputs
- ค่าเริ่มต้นของ
--[no]stamp
: "เท็จ" -
ประทับไบนารีด้วยวันที่ ชื่อผู้ใช้ ชื่อโฮสต์ ข้อมูลพื้นที่ทำงาน ฯลฯ
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--strip=<always, sometimes or never>
: "บางครั้ง" -
ระบุว่าจะตัดไบนารีและไลบรารีที่แชร์หรือไม่ (โดยใช้ "-Wl,--strip-debug") ค่าเริ่มต้นเป็น "sometimes" หมายถึง Strip iff --compilation_mode=fastbuild
แท็ก:affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--stripopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง Strip เมื่อสร้างไบนารี "<name>.strped"
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--swiftcopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังการคอมไพล์ Swift
แท็ก:action_command_lines
- รวมการใช้งานหลายรายการแล้ว
--tvos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับการสร้างไบนารี Apple tvOS
แท็ก:loses_incremental_state
,loading_and_analysis
- ค่าเริ่มต้น
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
เวอร์ชัน tvOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองและอุปกรณ์เป้าหมาย หากไม่ระบุ ให้ใช้ "tvos_sdk_version"
แท็ก:loses_incremental_state
- รวมการใช้งานหลายรายการแล้ว
--visionos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับการสร้างไบนารี Apple visionOS
แท็ก:loses_incremental_state
,loading_and_analysis
- รวมการใช้งานหลายรายการแล้ว
--watchos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับการสร้างไบนารี Apple WatchOS
แท็ก:loses_incremental_state
,loading_and_analysis
- ค่าเริ่มต้น
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
เวอร์ชัน WatchOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองและอุปกรณ์เป้าหมาย หากไม่ระบุ ให้ใช้ "watchos_sdk_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--xbinary_fdo=<a build target label>
: ดูรายละเอียด -
ใช้ข้อมูลโปรไฟล์ XbinaryFDO เพื่อเพิ่มประสิทธิภาพการรวบรวม ระบุชื่อของโปรไฟล์ไบนารีแบบข้ามที่เป็นค่าเริ่มต้น เมื่อใช้ตัวเลือกนี้ร่วมกับ --fdo_instrument/--fdo_optimize/--fdo_profile ตัวเลือกเหล่านั้นจะมีผลเหนือกว่าเสมอเสมือนว่าไม่ได้ระบุ xbinary_fdo
แท็ก:affects_outputs
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมของแฟล็ก ฯลฯ)
- ค่าเริ่มต้นของ
--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
: "จริง" -
หากปิดใช้ ข้อผิดพลาดในการแสดงผลในทรัพยากร Dependency เป้าหมายจะถูกลดระดับเป็นคำเตือน
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--[no]desugar_for_android
: "จริง" -
ไม่ว่าจะถอดรหัสไบต์โค้ด 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
: "จริง" -
ตรวจสอบสภาพแวดล้อมที่แต่ละเป้าหมายใช้งานร่วมกันได้ และรายงานข้อผิดพลาดหากเป้าหมายใดมีทรัพยากร Dependency ที่ไม่รองรับสภาพแวดล้อมเดียวกัน
แท็กมีดังนี้build_file_semantics
- ค่าเริ่มต้นของ
--[no]experimental_allow_android_library_deps_without_srcs
: "เท็จ" -
แจ้งเพื่อช่วยเปลี่ยนจากการอนุญาตเป็นไม่อนุญาตกฎ android_library แบบไม่มี srcs-less ที่มี deps ต้องล้างข้อมูล Depot เพื่อเปิดตัวการเปลี่ยนแปลงนี้โดยค่าเริ่มต้น
แท็ก:eagerness_to_exit
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]experimental_check_desugar_deps
: "จริง" -
ต้องการตรวจสอบการกำจัดน้ำตาลอย่างถูกต้องอีกครั้งที่ระดับไบนารีของ Android
แท็ก:eagerness_to_exit
,loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--experimental_import_deps_checking=<off, warning or error>
: "ปิด" -
เมื่อเปิดใช้ ให้ตรวจสอบว่าทรัพยากร Dependency ของ aar_import สมบูรณ์หรือไม่ การบังคับใช้นี้อาจทำให้บิลด์เสียหายหรืออาจส่งผลให้มีคำเตือนได้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "ค่าเริ่มต้น" -
หากเป็น "จริง" ให้ตรวจสอบว่าเป้าหมาย Java ประกาศเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency อย่างชัดเจน
แท็ก:build_file_semantics
,eagerness_to_exit
- ค่าเริ่มต้นของ
--[no]incompatible_check_testonly_for_output_files
: "เท็จ" -
หากเปิดใช้ไว้ ให้ตรวจสอบ testonly สำหรับเป้าหมายเบื้องต้นที่เป็นไฟล์เอาต์พุตโดยค้นหาเฉพาะ testonly ของกฎที่สร้างขึ้น ข้อมูลนี้ตรงกับการตรวจสอบการแสดงผล
แท็ก:build_file_semantics
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_disable_native_android_rules
: "เท็จ" -
หากเปิดใช้ ระบบจะปิดใช้การใช้งานกฎ Android แบบดั้งเดิมโดยตรง โปรดใช้กฎของ Starlark Android จาก https://github.com/bazelbuild/rules_android
แท็ก:eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_disable_native_apple_binary_rule
: "เท็จ" -
ไม่มีการดำเนินการ โปรดเก็บไว้ที่นี่เพื่อดูความเข้ากันได้แบบย้อนหลัง
แท็ก:eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_force_strict_header_check_from_starlark
: "จริง" -
หากเปิดใช้ ให้ตั้งค่าการตรวจสอบส่วนหัวที่เข้มงวดใน Starlark API
แท็กดังนี้loading_and_analysis
,changes_inputs
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_validate_top_level_header_inclusions
: "จริง" -
หากเป็น "จริง" Bazel จะตรวจสอบการรวมส่วนหัวของไดเรกทอรีระดับบนสุดด้วย (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/10047)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]strict_filesets
: "เท็จ" -
หากเปิดใช้ตัวเลือกนี้ ระบบจะรายงานชุดไฟล์ที่ข้ามขอบเขตของแพ็กเกจว่าเป็นข้อผิดพลาด ซึ่งจะใช้งานไม่ได้เมื่อปิดใช้ check_fileset_dependencies_recursively
แท็ก:build_file_semantics
,eagerness_to_exit
- ค่าเริ่มต้นของ
--strict_proto_deps=<off, warn, error, strict or default>
: "ข้อผิดพลาด" -
หากไม่ปิด ให้ตรวจสอบว่าเป้าหมาย protocol_library ประกาศเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency อย่างชัดเจน
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้นของ
--strict_public_imports=<off, warn, error, strict or default>
: "ปิด" -
หากไม่ "ปิด" ให้ตรวจสอบว่าเป้าหมาย proto_library ประกาศเป้าหมายทั้งหมดที่ใช้ใน "นําเข้าแบบสาธารณะ" อย่างชัดเจนเป็น "ส่งออก"
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้นของ
--[no]strict_system_includes
: "เท็จ" -
หากเป็น "จริง" จะต้องประกาศส่วนหัวที่พบในเส้นทาง (-isystem) ด้วย
แท็ก:loading_and_analysis
,eagerness_to_exit
- รวมการใช้งานหลายรายการแล้ว
--target_environment=<a build target label>
รายการ -
ประกาศสภาพแวดล้อมเป้าหมายของบิลด์นี้ ต้องเป็นการอ้างอิงป้ายกำกับไปยังกฎ "สภาพแวดล้อม" หากระบุไว้ เป้าหมายระดับบนสุดทั้งหมดต้องเข้ากันได้กับสภาพแวดล้อมนี้
แท็ก:changes_inputs
- ตัวเลือกที่ส่งผลต่อเอาต์พุตการลงชื่อเข้าใช้ของบิลด์
- ค่าเริ่มต้นของ
--apk_signing_method=<v1, v2, v1_v2 or v4>
: "v1_v2" -
การใช้งานเพื่อรับรอง APK
แท็กมีดังนี้action_command_lines
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]device_debug_entitlements
: "จริง" -
หากตั้งค่าและโหมดการรวบรวมไม่ใช่ "เลือกใช้" แอป objc จะมีการให้สิทธิ์การแก้ไขข้อบกพร่องเมื่อลงชื่อเข้าใช้
แท็ก:changes_inputs
- ค่าเริ่มต้น
--ios_signing_cert_name=<a string>
: ดูรายละเอียด -
ชื่อใบรับรองที่จะใช้สำหรับการลงนาม iOS หากไม่ได้ตั้งค่า ระบบจะกลับไปใช้โปรไฟล์การจัดสรร อาจเป็นค่ากำหนดข้อมูลประจำตัว Keychain ของใบรับรองหรือ (สตริงย่อย) ของชื่อจริงของใบรับรอง ตามหน้า man ของ Codesign (SIGNING IDENTITIES)
แท็ก:action_command_lines
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้โดยไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE
- ค่าเริ่มต้นของ
--[no]incompatible_disallow_legacy_py_provider
: "จริง" -
ไม่มีการดำเนินการ และจะถูกนำออกในเร็วๆ นี้
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่ควบคุมลักษณะการทำงานของสภาพแวดล้อมการทดสอบหรือตัวดำเนินการทดสอบมีดังนี้
- ค่าเริ่มต้นของ
--[no]allow_analysis_failures
: "เท็จ" -
หากเป็นจริง การวิเคราะห์เป้าหมายกฎไม่สำเร็จจะส่งผลให้มีการเผยแพร่อินสแตนซ์ของ AnalysisFailureInfo ที่มีคำอธิบายข้อผิดพลาด แทนที่จะทำให้บิลด์ล้มเหลว
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--analysis_testing_deps_limit=<an integer>
: "2000" -
กำหนดจำนวนสูงสุดของทรัพยากร Dependency แบบเปลี่ยนผ่านผ่านแอตทริบิวต์กฎที่มีการเปลี่ยนการกำหนดค่า for_analysis_testing การเกินขีดจำกัดนี้จะทำให้เกิดข้อผิดพลาดเกี่ยวกับกฎ
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]break_build_on_parallel_dex2oat_failure
: "เท็จ" -
หากการดำเนินการ Dex2oat ไม่สำเร็จจะทำให้บิลด์ขัดข้องแทนการเรียกใช้ Dex2oat ระหว่างรันไทม์ของการทดสอบ
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_android_use_parallel_dex2oat
: "เท็จ" -
ใช้ dex2oat ควบคู่กันเพื่อเพิ่มความเร็ว android_test
แท็ก:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- ค่าเริ่มต้นของ
--[no]ios_memleaks
: "เท็จ" -
เปิดใช้การตรวจหาการรั่วไหลของหน่วยความจำในเป้าหมาย ios_test
แท็ก:action_command_lines
- ค่าเริ่มต้น
--ios_simulator_device=<a string>
: ดูรายละเอียด -
อุปกรณ์ที่จะจำลองเมื่อเรียกใช้แอปพลิเคชัน iOS ในเครื่องมือจำลอง เช่น "iPhone 6" คุณสามารถดูรายการอุปกรณ์โดยเรียกใช้ "xcrun simctl list devicetypes" ในเครื่องที่จะเรียกใช้เครื่องจำลอง
แท็ก:test_runner
- ค่าเริ่มต้น
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
เวอร์ชันของ iOS ที่จะเรียกใช้ในเครื่องจำลองเมื่อเรียกใช้หรือทดสอบ โดยจะไม่พิจารณากฎ ios_test หากมีการระบุอุปกรณ์เป้าหมายในกฎ
แท็ก:test_runner
- รวมการใช้งานหลายรายการแล้ว
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
รายการ - ระบุจำนวนครั้งที่จะทำการทดสอบแต่ละครั้ง หากความพยายามอันใดอันหนึ่งล้มเหลวไม่ว่าด้วยเหตุผลใดก็ตาม ระบบจะถือว่าการทดสอบทั้งหมดไม่ผ่าน โดยปกติแล้วค่าที่ระบุจะเป็นจำนวนเต็ม ตัวอย่าง: --runs_per_test=3 จะทำการทดสอบทั้งหมด 3 ครั้ง ไวยากรณ์ทางเลือก: regex_filter@runs_per_test ตัวอย่าง: --runs_per_test=//foo/.*,-//foo/bar/.*@3 เรียกใช้การทดสอบทั้งหมดใน //foo/ ยกเว้นการทดสอบภายใต้ foo/bar 3 ครั้ง ตัวเลือกนี้สามารถส่งได้หลายครั้ง อาร์กิวเมนต์ที่ส่งผ่านล่าสุดที่ตรงกันจะมีความสำคัญเหนือกว่า หากไม่มีอะไรตรงกัน การทดสอบจะทำงานเพียงครั้งเดียว
- รวมการใช้งานหลายรายการแล้ว
--test_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุตัวแปรสภาพแวดล้อมเพิ่มเติมที่จะแทรกในสภาพแวดล้อมตัวดำเนินการทดสอบ สามารถระบุตัวแปรตามชื่อ ซึ่งในกรณีนี้ระบบจะอ่านค่าจากสภาพแวดล้อมไคลเอ็นต์ Bazel หรือโดยคู่ name=value สามารถใช้ตัวเลือกนี้ได้หลายครั้งเพื่อระบุตัวแปรหลายตัว ใช้โดยคำสั่ง 'bazel test' เท่านั้น
แท็ก:test_runner
- ค่าเริ่มต้นของ
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - ลบล้างค่าระยะหมดเวลาทดสอบเริ่มต้นสำหรับระยะหมดเวลาทดสอบ (เป็นวินาที) หากระบุค่าจำนวนเต็มบวกค่าเดียว ค่านั้นจะลบล้างหมวดหมู่ทั้งหมด หากระบุจำนวนเต็มที่คั่นด้วยจุลภาค 4 ตัว ค่าเหล่านั้นจะลบล้างระยะหมดเวลาสำหรับระยะสั้น ปานกลาง ยาว และตลอดไป (ตามลำดับนั้น) ไม่ว่าจะในรูปแบบใด ค่า -1 จะบอกให้ Blaze ใช้ระยะหมดเวลาเริ่มต้นสำหรับหมวดหมู่นั้น
- ค่าเริ่มต้น
--tvos_simulator_device=<a string>
: ดูรายละเอียด -
อุปกรณ์ที่จะจำลองเมื่อเรียกใช้แอปพลิเคชัน tvOS ในเครื่องมือจำลอง เช่น "Apple TV 1080p" คุณสามารถดูรายการอุปกรณ์โดยเรียกใช้ "xcrun simctl list devicetypes" ในเครื่องที่จะเรียกใช้เครื่องจำลอง
แท็ก:test_runner
- ค่าเริ่มต้น
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
เวอร์ชันของ tvOS ที่จะเรียกใช้ในเครื่องจำลองเมื่อเรียกใช้หรือทดสอบ
แท็ก:test_runner
- ค่าเริ่มต้น
--watchos_simulator_device=<a string>
: ดูรายละเอียด -
อุปกรณ์ที่จะจำลองเมื่อเรียกใช้แอปพลิเคชัน watchOS ในเครื่องมือจำลอง เช่น "Apple Watch - 38 มม." คุณสามารถดูรายการอุปกรณ์โดยเรียกใช้ "xcrun simctl list devicetypes" ในเครื่องที่จะเรียกใช้เครื่องจำลอง
แท็ก:test_runner
- ค่าเริ่มต้น
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
เวอร์ชันของ watchOS ที่จะเรียกใช้ในเครื่องมือจำลองเมื่อเรียกใช้หรือทดสอบ
แท็ก:test_runner
- ค่าเริ่มต้นของ
--[no]zip_undeclared_test_outputs
: "จริง" -
หากเป็น "จริง" ระบบจะเก็บผลลัพธ์การทดสอบที่ไม่ได้ประกาศไว้ในไฟล์ ZIP
แท็กtest_runner
- ตัวเลือกที่เกี่ยวข้องกับผลลัพธ์การค้นหาและความหมาย
- ค่าเริ่มต้นของ
--aspect_deps=<off, conservative or precise>
: "ดั้งเดิม" -
วิธีแก้ไขทรัพยากร Dependency ของสัดส่วนภาพเมื่อรูปแบบเอาต์พุตเป็นหนึ่งใน {xml,ctr,record} "off" หมายถึงไม่มีการสรุปทรัพยากร Dependency "เชิงรับ" (ค่าเริ่มต้น) หมายถึงการเพิ่มทรัพยากร Dependency ที่ประกาศไว้ทั้งหมด โดยไม่คำนึงว่าจะได้รับคลาสกฎของทรัพยากร Dependency โดยตรงหรือไม่ "แม่นยำ" หมายความว่ามีการเพิ่มเฉพาะส่วนที่อาจใช้งานได้ตามคลาสกฎของทรัพยากร Dependency โดยตรง โปรดทราบว่าโหมดความแม่นยำจำเป็นต้องมีการโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียวและทำให้ทำงานช้ากว่าโหมดอื่นๆ นอกจากนี้ โปรดทราบว่าแม้แต่โหมดความแม่นยำก็ไม่แม่นยำทั้งหมด การตัดสินใจว่าจะคำนวณด้านใดด้านหนึ่งหรือไม่นั้น จะตัดสินใจในขั้นตอนการวิเคราะห์ ซึ่งจะไม่ทำงานระหว่าง "การค้นหาแบบ Bazel"
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--[no]consistent_labels
: "เท็จ" -
หากเปิดใช้ คำสั่งการค้นหาทุกรายการจะส่งป้ายกำกับออกมาเสมือนว่าฟังก์ชัน Starlark <code>str</code> ใช้กับอินสแตนซ์ <code>Label</code> ซึ่งจะเป็นประโยชน์สำหรับเครื่องมือที่จำเป็นต้องจับคู่เอาต์พุตของคำสั่งการค้นหาและ/หรือป้ายกำกับต่างๆ ที่กฎเรียกใช้ หากไม่ได้เปิดใช้ ตัวจัดรูปแบบเอาต์พุตจะปล่อยชื่อที่เก็บที่ชัดเจน (สัมพันธ์กับที่เก็บหลัก) แทนเพื่อทำให้เอาต์พุตอ่านได้ง่ายขึ้น
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]deduplicate_depsets
: "จริง" -
กรององค์ประกอบย่อยที่ไม่ใช่ Leaf ที่ซ้ำกันออกจากไฟล์ dep_set_of_files ในเอาต์พุต Proto/textctr/json สุดท้าย การดำเนินการนี้จะไม่กรองรายการที่ซ้ำกันออกซึ่งไม่ได้มีระดับบนสุดร่วมกับคุณ การดำเนินการนี้จะไม่ส่งผลต่อรายการอาร์ติแฟกต์อินพุตที่มีประสิทธิภาพขั้นสุดท้ายของการดำเนินการดังกล่าว
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]graph:factored
: "จริง" -
หากเป็น "จริง" กราฟจะปล่อยออกมาเป็น "แยกส่วน" กล่าวคือ โหนดที่เทียบเคียงกับโทโพโลยีจะถูกผสานเข้าด้วยกันและต่อป้ายกำกับของโหนดต่อกัน ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--graph:node_limit=<an integer>
: "512" -
ความยาวสูงสุดของสตริงป้ายกำกับสำหรับโหนดกราฟในเอาต์พุต ระบบจะตัดป้ายกำกับที่ยาวขึ้น โดย -1 หมายความว่าไม่มีการตัดข้อความ ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]implicit_deps
: "จริง" -
หากเปิดใช้ ทรัพยากร Dependency โดยนัยจะรวมอยู่ในกราฟการอ้างอิงที่การค้นหาดังกล่าวดำเนินการอยู่ ทรัพยากร Dependency โดยนัยคือทรัพยากร Dependency ที่ไม่ได้ระบุอย่างชัดเจนในไฟล์ BUILD แต่เพิ่มโดย Bazel สำหรับ cquery ตัวเลือกนี้ควบคุมการกรองชุดเครื่องมือที่แก้ไขแล้ว
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--[no]include_artifacts
: "จริง" -
มีชื่ออินพุตและเอาต์พุตการดำเนินการในเอาต์พุต (อาจมีขนาดใหญ่)
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]include_aspects
: "จริง" -
aquery, cquery: จะรวมการดำเนินการที่สร้างโดยมุมมองในเอาต์พุตหรือไม่ query: no-op (ติดตามด้านต่างๆ เสมอ)
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]include_commandline
: "จริง" -
รวมเนื้อหาของบรรทัดคำสั่งการดำเนินการในเอาต์พุต (อาจมีขนาดใหญ่)
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]include_file_write_contents
: "เท็จ" -
รวมเนื้อหาไฟล์สำหรับการดำเนินการ FileWrite และ SourceSymlinkManifest (อาจมีขนาดใหญ่)
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]include_param_files
: "เท็จ" -
รวมเนื้อหาของไฟล์พารามิเตอร์ที่ใช้ในคำสั่ง (อาจมีขนาดใหญ่) หมายเหตุ: การเปิดใช้การตั้งค่าสถานะนี้จะเป็นการเปิดใช้แฟล็ก --include_commandline โดยอัตโนมัติ
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]incompatible_display_source_file_location
: "จริง" -
"จริง" จะแสดงเป้าหมายของไฟล์ต้นฉบับโดยค่าเริ่มต้น หากเป็น "จริง" จะแสดงตำแหน่งของบรรทัดที่ 1 ของไฟล์ต้นฉบับในเอาต์พุตตำแหน่ง แฟล็กนี้มีไว้เพื่อวัตถุประสงค์ในการย้ายข้อมูลเท่านั้น
แท็ก:terminal_output
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_package_group_includes_double_slash
: "จริง" -
หากเปิดใช้ เมื่อเอาต์พุตแอตทริบิวต์ `packages` ของ package_group จะไม่ละเว้น `//` ที่นำหน้า
แท็ก:terminal_output
,incompatible_change
- ค่าเริ่มต้นของ
--[no]infer_universe_scope
: "เท็จ" -
หากไม่ได้ตั้งค่า และ --universe_scope อยู่ ระบบจะอนุมานค่าของ --universe_scope เป็นรายการรูปแบบเป้าหมายที่ไม่ซ้ำกันในนิพจน์การค้นหา โปรดทราบว่าค่า --universe_scope ที่อนุมานสำหรับนิพจน์การค้นหาที่ใช้ฟังก์ชันขอบเขตระดับจักรวาล (เช่น "allrdeps") อาจไม่ใช่ค่าที่คุณต้องการ คุณจึงควรใช้ตัวเลือกนี้ก็ต่อเมื่อคุณรู้ว่าคุณกำลังทำอะไรอยู่เท่านั้น ดูรายละเอียดและตัวอย่างได้ที่ https://bazel.build/reference/query#sky-query หากตั้งค่า --universe_scope ไว้ ระบบจะไม่พิจารณาค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้มีผลกับ "ข้อความค้นหา" เท่านั้น (กล่าวคือ ไม่ใช่ "cquery")
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]line_terminator_null
: "เท็จ" -
ระบุว่าแต่ละรูปแบบจะลงท้ายด้วย \0 แทนที่จะเป็นบรรทัดใหม่หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]nodep_deps
: "จริง" -
หากเปิดใช้ คำสั่ง deps จาก "nodep" จะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาดังกล่าวดำเนินการอยู่ ตัวอย่างทั่วไปของแอตทริบิวต์ "nodep" คือ "visibility" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ "infobuild-language" เพื่อดูข้อมูลเกี่ยวกับแอตทริบิวต์ "nodep" ทั้งหมดในภาษาบิลด์
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--output=<a string>
: "ข้อความ" -
รูปแบบที่ควรพิมพ์ผลลัพธ์การค้นหา ค่าที่อนุญาตสำหรับ aquery ได้แก่ text, textplo, Proto, jsonctr
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:default_values
: "จริง" -
หากเป็น "จริง" ระบบจะรวมแอตทริบิวต์ที่ไม่ได้ระบุค่าไว้อย่างชัดเจนในไฟล์ BUILD มิเช่นนั้นระบบจะละเว้นแอตทริบิวต์เหล่านั้น ตัวเลือกนี้ใช้ได้กับ --เอาต์พุต=โปรโตคอล
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:definition_stack
: "เท็จ" -
ป้อนข้อมูลช่อง Proto คำจำกัดความ ซึ่งจะบันทึกสำหรับอินสแตนซ์ของกฎแต่ละรายการที่สแต็กการเรียกใช้ Starlark ทันทีที่มีการกำหนดคลาสของกฎ
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:flatten_selects
: "จริง" -
หากเปิดใช้ ระบบจะรวมแอตทริบิวต์ที่กำหนดค่าได้ซึ่งสร้างด้วย select() ออก สำหรับประเภทรายการ การนำเสนอแบบรวมคือรายการที่มีแต่ละค่าของแผนที่ที่เลือกเพียงครั้งเดียว ประเภท Scalar จะถูกแบนเป็น Null
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--[no]proto:include_synthetic_attribute_hash
: "เท็จ" -
ระบุว่าจะคำนวณและป้อนข้อมูลแอตทริบิวต์ $internal_attr_hash หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:instantiation_stack
: "เท็จ" -
สร้างสแต็กการเรียกใช้อินสแตนซ์ของแต่ละกฎ โปรดทราบว่าการดำเนินการนี้ต้องมีสแต็ก
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:locations
: "จริง" -
กำหนดว่าจะแสดงข้อมูลตำแหน่งในเอาต์พุต Pro หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--proto:output_rule_attrs=<comma-separated list of options>
: "ทั้งหมด" -
รายการแอตทริบิวต์ที่คั่นด้วยคอมมาที่จะรวมไว้ในเอาต์พุต ค่าเริ่มต้นคือแอตทริบิวต์ทั้งหมด ตั้งค่าเป็นสตริงว่างเพื่อไม่ให้มีแอตทริบิวต์ใดๆ ทั้งสิ้น ตัวเลือกนี้ใช้ได้กับ --เอาต์พุต=โปรโตคอล
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:rule_inputs_and_outputs
: "จริง" -
ระบุว่าจะสร้างช่อง report_input และ rules_เอาต์พุต หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--query_file=<a string>
: "" -
หากตั้งค่าแล้ว การค้นหาจะอ่านการค้นหาจากไฟล์ที่มีชื่อที่นี่ ไม่ใช่ในบรรทัดคำสั่ง ข้อผิดพลาดในการระบุไฟล์ที่นี่ รวมถึงการค้นหาบรรทัดคำสั่ง
แท็ก:changes_inputs
- ค่าเริ่มต้นของ
--[no]relative_locations
: "เท็จ" -
หากเป็นจริง ตำแหน่งของไฟล์ BUILD ใน XML และเอาต์พุตโปรโตจะสัมพันธ์กัน โดยค่าเริ่มต้น เอาต์พุตของตำแหน่งจะเป็นเส้นทางสัมบูรณ์และจะไม่สอดคล้องกันในแต่ละเครื่อง คุณสามารถตั้งตัวเลือกนี้เป็น "จริง" เพื่อให้ผลลัพธ์สอดคล้องกันในคอมพิวเตอร์ทุกเครื่อง
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]skyframe_state
: "เท็จ" -
โดยไม่ทำการวิเคราะห์เพิ่มเติม ให้ถ่ายโอนกราฟการดำเนินการปัจจุบันจาก Skyframe หมายเหตุ: ปัจจุบันระบบยังไม่รองรับการระบุเป้าหมายด้วย --skyframe_state แฟล็กนี้ใช้ได้เฉพาะกับ --control=proto หรือ --เอาต์พุต=textสอง
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]tool_deps
: "จริง" -
คำค้นหา: หากปิดใช้ ทรัพยากร Dependency ของเป้าหมาย "การกำหนดค่าโฮสต์" หรือ "การดำเนินการ" จะไม่รวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาดังกล่าวดำเนินการอยู่ Edge ของทรัพยากร Dependency "การกำหนดค่าโฮสต์" เช่น กฎจากกฎ "Proto_library" ใดก็ตามไปยังโปรโตคอลคอมไพเลอร์ (โปรโตคอลคอมไพเลอร์) มักจะชี้ไปยังเครื่องมือที่ดำเนินการระหว่างการสร้างแทนที่จะเป็นส่วนหนึ่งของโปรแกรม "target" เดียวกัน
ค้นหา: หากปิดใช้ ให้กรองเป้าหมายที่กำหนดค่าไว้ทั้งหมดซึ่งข้ามโฮสต์หรือการเปลี่ยนการดำเนินการจากเป้าหมายระดับบนสุดที่ค้นพบเป้าหมายที่กำหนดค่าไว้นี้ออก ซึ่งหมายความว่าหากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าเป้าหมาย ระบบจะแสดงผลเฉพาะเป้าหมายที่กำหนดค่าในการกำหนดค่าเป้าหมายด้วยเท่านั้น หากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าโฮสต์ ระบบจะแสดงเฉพาะเป้าหมายที่กำหนดค่าไว้ของโฮสต์เท่านั้น ตัวเลือกนี้จะไม่ยกเว้นห่วงโซ่เครื่องมือที่แก้ไขแล้ว
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--universe_scope=<comma-separated list of options>
: "" -
ชุดรูปแบบเป้าหมายที่คั่นด้วยคอมมา (การบวกและการลบ) การค้นหาอาจดำเนินการในจักรวาลที่กำหนดโดยการปิดทางอ้อมของเป้าหมายที่ระบุ ตัวเลือกนี้ใช้สำหรับคำค้นหาและคำสั่ง cquery
สำหรับ cquery อินพุตไปยังตัวเลือกนี้จะเป็นเป้าหมายคำตอบทั้งหมดที่สร้างขึ้น ดังนั้นตัวเลือกนี้จึงอาจส่งผลต่อการกำหนดค่าและการเปลี่ยน หากไม่ได้ระบุตัวเลือกนี้ ระบบจะถือว่าเป้าหมายระดับบนสุดเป็นเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหา หมายเหตุ: สำหรับ cquery การไม่ระบุตัวเลือกนี้อาจทำให้บิลด์เสียหายได้ หากเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหาไม่สามารถสร้างได้ด้วยตัวเลือกระดับบนสุด
แท็กloading_and_analysis
- ตัวเลือกที่กระตุ้นให้เกิดการเพิ่มประสิทธิภาพตามเวลาบิลด์
- ค่าเริ่มต้นของ
--[no]collapse_duplicate_defines
: "เท็จ" -
เมื่อเปิดใช้ ระบบจะนำการกำหนดที่ซ้ำกันออกในช่วงต้นของบิลด์ ซึ่งจะช่วยหลีกเลี่ยงการสูญเสียแคชการวิเคราะห์โดยไม่จำเป็นสำหรับบิลด์ที่เทียบเท่าบางประเภท
แท็ก:loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--[no]experimental_filter_library_jar_with_program_jar
: "เท็จ" -
กรอง ProGuard ProgramJar เพื่อนำคลาสที่แสดงใน LibraryJar ออกด้วย
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--[no]experimental_inmemory_dotd_files
: "จริง" -
หากเปิดใช้ ระบบจะส่งไฟล์ C++ .d ในหน่วยความจำจากโหนดบิลด์ระยะไกลโดยตรง แทนที่จะเขียนลงในดิสก์
แท็ก:loading_and_analysis
,execution
,affects_outputs
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_inmemory_jdeps_files
: "จริง" -
หากเปิดใช้ ระบบจะส่งไฟล์ทรัพยากร Dependency (.jdeps) ที่สร้างจากการคอมไพล์ Java ในหน่วยความจำจากโหนดบิลด์ระยะไกลโดยตรงแทนที่จะเขียนลงในดิสก์
แท็ก:loading_and_analysis
,execution
,affects_outputs
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_objc_include_scanning
: "เท็จ" -
ต้องรวมการสแกนหาวัตถุประสงค์ C/C++ ไหม
แท็ก:loading_and_analysis
,execution
,changes_inputs
- ค่าเริ่มต้นของ
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
: "เท็จ" -
หากเปิดใช้ ฟีเจอร์แยกวิเคราะห์ส่วนหัวจะไม่สร้างการดำเนินการคอมไพล์ส่วนหัวแยกต่างหากหากพบแหล่งที่มาที่มีชื่อฐานเดียวกันในเป้าหมายเดียวกัน
แท็ก:loading_and_analysis
,affects_outputs
- ค่าเริ่มต้นของ
--[no]experimental_retain_test_configuration_across_testonly
: "เท็จ" -
เมื่อเปิดใช้ --trim_test_configuration จะไม่ตัดการกำหนดค่าการทดสอบสำหรับกฎที่ระบุว่าเป็น testonly=1 ซึ่งจะช่วยลดปัญหาความขัดแย้งของการดำเนินการเมื่อกฎที่ไม่ใช่การทดสอบขึ้นอยู่กับกฎ cc_test จะไม่มีผลหาก --trim_test_configuration เป็นเท็จ
แท็ก:loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--[no]experimental_starlark_cc_import
: "เท็จ" -
หากเปิดใช้ คุณจะใช้ 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
: "จริง" -
การทำงานส่วนใหญ่มีไว้สำหรับการถอดรหัสไฟล์ 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
: "จริง" -
เมื่อเปิดใช้ ระบบจะล้างตัวเลือกที่เกี่ยวข้องกับการทดสอบภายใต้ระดับบนสุดของบิลด์ เมื่อแฟล็กนี้ทำงานอยู่ การทดสอบจะไม่สามารถสร้างขึ้นมาเป็นทรัพยากร Dependency ของกฎที่ไม่ใช่การทดสอบ แต่การเปลี่ยนแปลงตัวเลือกที่เกี่ยวข้องกับการทดสอบก็จะไม่ทำให้มีการวิเคราะห์กฎที่ไม่ใช่การทดสอบอีกครั้ง
แท็ก:loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--[no]use_singlejar_apkbuilder
: "จริง" -
ตัวเลือกนี้เลิกใช้งานแล้ว ตอนนี้ไม่มีการดำเนินการและจะถูกนำออกเร็วๆ นี้
แท็ก:loading_and_analysis
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งการบันทึก
- ค่าเริ่มต้นของ
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
พิมพ์ข้อมูลการแก้ไขข้อบกพร่องระหว่างการแก้ปัญหา Toolchain แฟล็กจะใช้นิพจน์ทั่วไป ซึ่งมีการตรวจสอบกับประเภท Toolchain และเป้าหมายเฉพาะเพื่อดูสิ่งที่ต้องแก้ไขข้อบกพร่อง คุณสามารถคั่นนิพจน์ทั่วไปหลายรายการได้ด้วยคอมมา แล้วจึงตรวจสอบนิพจน์ทั่วไปแต่ละรายการแยกกัน หมายเหตุ: ผลลัพธ์ของแฟล็กนี้ซับซ้อนมากและน่าจะมีประโยชน์สำหรับผู้เชี่ยวชาญด้านการแก้ปัญหาเครื่องมือเชนเท่านั้น
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- รวมการใช้งานหลายรายการแล้ว
--flag_alias=<a 'name=value' flag alias>
รายการ -
ตั้งชื่อชวเลขให้กับธง Starlark ซึ่งจะใช้คู่คีย์-ค่าเดียวในรูปแบบ "<key>=<value>" เป็นอาร์กิวเมนต์
แท็ก:changes_inputs
- ค่าเริ่มต้นของ
--[no]incompatible_default_to_explicit_init_py
: "เท็จ" -
แฟล็กนี้จะเปลี่ยนลักษณะการทำงานเริ่มต้นเพื่อไม่ให้สร้างไฟล์ __init__.py โดยอัตโนมัติในไฟล์ Runfile ของ Python เป้าหมายอีกต่อไป ในขั้นนี้ เมื่อเป้าหมาย py_binary หรือ py_test มีการตั้งค่า legacy_create_init เป็น "auto" (ค่าเริ่มต้น) ค่าดังกล่าวจะถือว่าเป็น False ก็ต่อเมื่อมีการตั้งค่าสถานะนี้เท่านั้น ดู 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
: "จริง" -
หากเป็น "จริง" เป้าหมาย "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 ที่ระบุโดย Toolchain ของ Python แทนที่จะเป็นรันไทม์ที่ได้จากแฟล็กเดิม เช่น --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
,explicit_in_output_path
- ตัวเลือกเบ็ดเตล็ด ที่ไม่ได้จัดอยู่ในหมวดหมู่อื่น:
--[no]cache_test_results
[-t
] ค่าเริ่มต้น: "อัตโนมัติ"- หากตั้งค่าเป็น "อัตโนมัติ" Bazel จะทำการทดสอบอีกครั้งเฉพาะเมื่อ (1) Bazel ตรวจพบการเปลี่ยนแปลงในการทดสอบหรือทรัพยากร Dependency (2) ระบบจะทำเครื่องหมายการทดสอบเป็นภายนอก (3) มีการขอการทดสอบหลายรายการด้วย --runs_per_test หรือ(4) การทดสอบล้มเหลวก่อนหน้านี้ หากตั้งค่าเป็น "ใช่" Bazel จะแคชผลการทดสอบทั้งหมด ยกเว้นการทดสอบที่ทำเครื่องหมายว่าเป็นภายนอก หากตั้งค่าเป็น "ไม่" Bazel จะไม่แคชผลการทดสอบใดๆ
- ค่าเริ่มต้นของ
--[no]experimental_cancel_concurrent_tests
: "เท็จ" -
หากเป็น "จริง" Blaze จะยกเลิกการทดสอบที่ทำงานอยู่พร้อมกันเมื่อเรียกใช้สำเร็จครั้งแรก วิธีนี้มีประโยชน์เมื่อใช้ร่วมกับ --runs_per_test_detects_flakes
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]experimental_fetch_all_coverage_outputs
: "เท็จ" -
หากเป็น "จริง" Bazel จะดึงข้อมูลไดเรกทอรีข้อมูลการครอบคลุมทั้งหมดสำหรับการทดสอบแต่ละครั้งระหว่างการเรียกใช้การครอบคลุม
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]experimental_generate_llvm_lcov
: "เท็จ" -
หากเป็น "จริง" ความครอบคลุมของเสียงดังจะสร้างรายงาน LCOV
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]experimental_j2objc_header_map
: "จริง" - กำหนดว่าจะสร้างแมปส่วนหัว J2ObjC ควบคู่ไปกับการเปลี่ยนรูปแบบ J2ObjC ไหม
- ค่าเริ่มต้นของ
--[no]experimental_j2objc_shorter_header_path
: "เท็จ" -
กำหนดว่าจะสร้างโดยใช้เส้นทางส่วนหัวที่สั้นลง (ใช้ "_ios" แทน "_j2objc")
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--experimental_java_classpath=<off, javabuilder or bazel>
: "javabuilder" - เปิดใช้คลาสพาธที่ลดลงสำหรับการคอมไพล์ Java
- ค่าเริ่มต้นของ
--[no]experimental_limit_android_lint_to_android_constrained_java
: "เท็จ" -
จำกัด --experimental_run_android_lint_on_java_rulesในไลบรารีที่ใช้ร่วมกับ Android ได้
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]experimental_run_android_lint_on_java_rules
: "เท็จ" -
ต้องการตรวจสอบแหล่งที่มา java_* หรือไม่
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]explicit_java_test_deps
: "เท็จ" - ระบุทรัพยากร Dependency ให้กับ JUnit หรือ Hamcrest อย่างชัดเจนใน java_test แทนการขอรับจาก Deps ของ TestRunner โดยไม่ตั้งใจ เล่นกับ Bazel ได้ตอนนี้เท่านั้น
- ค่าเริ่มต้น
--host_java_launcher=<a build target label>
: ดูรายละเอียด - JavaScript Launcher ใช้โดยเครื่องมือที่ทำงานระหว่างบิลด์
- รวมการใช้งานหลายรายการแล้ว
--host_javacopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง JavaScript เมื่อสร้างเครื่องมือที่ทำงานระหว่างบิลด์
- รวมการใช้งานหลายรายการแล้ว
--host_jvmopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง Java VM เมื่อสร้างเครื่องมือที่ทำงานระหว่างบิลด์ ระบบจะเพิ่มตัวเลือกเหล่านี้ลงในตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
- ค่าเริ่มต้นของ
--[no]incompatible_check_sharding_support
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่ผ่านการทดสอบชาร์ดหากตัวดำเนินการทดสอบไม่ได้ระบุว่ารองรับชาร์ดดิ้งโดยแตะไฟล์ที่เส้นทางใน TEST_SHARD_STATUS_FILE หากเป็นเท็จ ตัวดำเนินการทดสอบที่ไม่รองรับชาร์ดดิ้งจะนำไปสู่การทดสอบทั้งหมดที่ทำงานอยู่ในแต่ละชาร์ด
แท็ก:incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_exclusive_test_sandboxed
: "เท็จ" -
หากเป็นจริง การทดสอบพิเศษจะทํางานโดยใช้กลยุทธ์แบบแซนด์บ็อกซ์ เพิ่มแท็ก "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_เอาต์พุต=streamed
ขยายเป็น
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- ค่าเริ่มต้นของ
--[no]java_deps
: "จริง" - สร้างข้อมูลทรัพยากร Dependency (สำหรับตอนนี้คือคลาสพาธการคอมไพล์) ต่อเป้าหมาย Java
- ค่าเริ่มต้นของ
--[no]java_header_compilation
: "จริง" - รวบรวม Jar จากแหล่งที่มาโดยตรง
- ค่าเริ่มต้นของ
--java_language_version=<a string>
: "8" - เวอร์ชันภาษา Java
- ค่าเริ่มต้น
--java_launcher=<a build target label>
: ดูรายละเอียด - JavaScript Launcher ที่ใช้เมื่อสร้างไบนารีของ Java หากตั้งค่าแฟล็กนี้เป็นสตริงว่างเปล่า ระบบจะใช้ JDK Launcher แอตทริบิวต์ "launcher" จะลบล้าง Flag นี้
- ค่าเริ่มต้นของ
--java_runtime_version=<a string>
: "local_jdk" - เวอร์ชันรันไทม์ของ Java
- รวมการใช้งานหลายรายการแล้ว
--javacopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง JavaScript
- รวมการใช้งานหลายรายการแล้ว
--jvmopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง VM ของ Java ระบบจะเพิ่มตัวเลือกเหล่านี้ลงในตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
- ค่าเริ่มต้น
--legacy_main_dex_list_generator=<a build target label>
: ดูรายละเอียด - ระบุไบนารีที่จะใช้ในการสร้างรายการคลาสที่ต้องอยู่ใน Dex หลักเมื่อคอมไพล์ Multidex เดิม
- รวมการใช้งานหลายรายการแล้ว
--plugin=<a build target label>
รายการ - ปลั๊กอินที่จะใช้ในบิลด์ ใช้งานได้กับ java_plugin ในขณะนี้
- ค่าเริ่มต้น
--proguard_top=<a build target label>
: ดูรายละเอียด - ระบุว่าจะใช้ ProGuard เวอร์ชันใดสำหรับการนำโค้ดออกเมื่อสร้างไบนารี Java
- ค่าเริ่มต้นของ
--proto_compiler=<a build target label>
: "@bazel_tools//tools/ctr:ctrc" -
ป้ายกำกับของ Proto-Composer
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/prof:cc_toolchain"-
ป้ายกำกับของ ctr_lang_toolchain() ที่อธิบายวิธีคอมไพล์ C++ โปรโตคอล
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/j2objc:j2objc_plo_toolchain"-
ป้ายกำกับของ ctr_lang_toolchain() ที่อธิบายวิธีคอมไพล์ j2objc โพโตร
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/ctr:java_toolchain"-
ป้ายกำกับของ ctr_lang_toolchain() ที่อธิบายวิธีคอมไพล์ Java โปรโตคอล
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/ctr:javalite_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ที่อธิบายวิธีคอมไพล์ Proto ของ JavaLite
แท็ก:affects_outputs
,loading_and_analysis
- รวมการใช้งานหลายรายการแล้ว
--protocopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังคอมไพเลอร์ ctrbuf
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]runs_per_test_detects_flakes
: "เท็จ" - หากเป็น "จริง" ชาร์ดที่มีการรัน/พยายามอย่างน้อย 1 ครั้ง และการเรียกใช้/การลองอย่างน้อย 1 ครั้งล้มเหลวจะได้รับสถานะ "ไม่ถูกต้อง"
- ค่าเริ่มต้น
--shell_executable=<a path>
: ดูรายละเอียด -
เส้นทางสัมบูรณ์ไปยังไฟล์ปฏิบัติการ Shell ที่ Bazel จะใช้ได้ หากไม่ได้ตั้งค่าไว้ แต่ตัวแปรสภาพแวดล้อม BAZEL_SH ตั้งค่าในการเรียกใช้ Bazel ครั้งแรก (ซึ่งเริ่มต้นเซิร์ฟเวอร์ Bazel) Bazel จะใช้ค่านั้น หากไม่ได้ตั้งค่าไว้ Bazel จะใช้เส้นทางเริ่มต้นแบบฮาร์ดโค้ด ทั้งนี้ขึ้นอยู่กับระบบปฏิบัติการที่ใช้ (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, อื่นๆ ทั้งหมด: /bin/bash) โปรดทราบว่าการใช้ Shell ที่เข้ากันไม่ได้กับ Bash อาจทำให้การสร้างล้มเหลวหรือรันไทม์ล้มเหลวของไบนารีที่สร้างขึ้น
แท็ก:loading_and_analysis
- รวมการใช้งานหลายรายการแล้ว
--test_arg=<a string>
รายการ - ระบุตัวเลือกและอาร์กิวเมนต์เพิ่มเติมที่ควรส่งไปยังไฟล์ปฏิบัติการทดสอบ ใช้ได้หลายครั้งเพื่อระบุอาร์กิวเมนต์หลายข้อ หากทำการทดสอบหลายรายการ การทดสอบแต่ละรายการจะได้รับอาร์กิวเมนต์ที่เหมือนกัน ใช้โดยคำสั่ง 'bazel test' เท่านั้น
- ค่าเริ่มต้น
--test_filter=<a string>
: ดูรายละเอียด - ระบุตัวกรองสำหรับส่งต่อไปยังเฟรมเวิร์กการทดสอบ ใช้เพื่อจำกัดการทดสอบ โปรดทราบว่าการดำเนินการนี้ไม่มีผลต่อเป้าหมายที่สร้าง
- ค่าเริ่มต้นของ
--test_result_expiration=<an integer>
: "-1" - ตัวเลือกนี้เลิกใช้งานแล้วและไม่มีผล
- ค่าเริ่มต้นของ
--[no]test_runner_fail_fast
: "เท็จ" - ส่งต่อตัวเลือก "ไม่ผ่าน" ไปยังตัวดำเนินการทดสอบ ตัวดำเนินการทดสอบควรหยุดการดำเนินการเมื่อล้มเหลวในครั้งแรก
- ค่าเริ่มต้นของ
--test_sharding_strategy=<explicit or disabled>
: "โจ่งแจ้ง" - ระบุกลยุทธ์สำหรับชาร์ดดิ้งทดสอบ: "โจ่งแจ้ง" เพื่อใช้ชาร์ดดิ้งก็ต่อเมื่อมีแอตทริบิวต์ BUILD "shard_count" อยู่เท่านั้น "ปิดใช้" เพื่อไม่ให้ใช้ชาร์ดดิ้งทดสอบ
- ค่าเริ่มต้นของ
--tool_java_language_version=<a string>
: "8" - เวอร์ชันภาษา Java ที่ใช้เพื่อเรียกใช้เครื่องมือที่จำเป็นระหว่างบิลด์
- ค่าเริ่มต้นของ
--tool_java_runtime_version=<a string>
: "remotejdk_11" - เวอร์ชันรันไทม์ของ Java ที่ใช้เพื่อเรียกใช้เครื่องมือในระหว่างบิลด์
- ค่าเริ่มต้นของ
--[no]use_ijars
: "จริง" - หากเปิดใช้ ตัวเลือกนี้จะทำให้การคอมไพล์ Java ใช้ Jar ของอินเทอร์เฟซ ซึ่งจะส่งผลให้การรวบรวมเพิ่มขึ้นเร็วขึ้น แต่ข้อความแสดงข้อผิดพลาดอาจแตกต่างกันได้
ตัวเลือกบิลด์
- ตัวเลือกที่ปรากฏก่อนคำสั่งและถูกแยกวิเคราะห์โดยไคลเอ็นต์ ได้แก่
- รวมการใช้งานหลายรายการแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบแคช แทนที่จะคัดลอก โดยมีจุดประสงค์เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่มาจาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม ซึ่งสามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ส่งผลให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_repository_disable_download
: "เท็จ" -
หากมีการตั้งค่า ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองแก้ไขข้อผิดพลาดในการดาวน์โหลดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานได้ในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้นของ
--http_timeout_scaling=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลด HTTP ตามปัจจัยที่กำหนด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูรายละเอียด -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการดำเนินการบิลด์มีดังนี้
- ค่าเริ่มต้นของ
--[no]check_up_to_date
: "เท็จ" -
ไม่ต้องดำเนินการใดๆ เพียงแค่ตรวจสอบว่าเป็นเวอร์ชันล่าสุดแล้วหรือไม่ หากเป้าหมายทั้งหมดเป็นปัจจุบัน บิลด์นั้นจะเสร็จสมบูรณ์ หากจำเป็นต้องดำเนินขั้นตอนใดก็ตาม จะมีการรายงานข้อผิดพลาดและบิลด์ล้มเหลว
แท็ก:execution
- ค่าเริ่มต้นของ
--dynamic_local_execution_delay=<an integer>
: "1,000" -
การดำเนินการภายในเครื่องควรล่าช้ากี่มิลลิวินาที หากการดำเนินการระยะไกลเร็วขึ้นในระหว่างบิลด์อย่างน้อย 1 ครั้ง
แท็ก:execution
,host_machine_resource_optimizations
- รวมการใช้งานหลายรายการแล้ว
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment>
รายการ -
กลยุทธ์ในพื้นที่ที่จะใช้สำหรับการช่วยจำที่กำหนด การส่ง "ท้องถิ่น" เป็นการจดจำจะกำหนดค่าเริ่มต้นสำหรับการช่วยจำที่ไม่ได้ระบุไว้ ใช้ [mnemonic=]local_strategy[,local_strategy,...]
แท็ก:execution
,host_machine_resource_optimizations
- รวมการใช้งานหลายรายการแล้ว
--dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment>
รายการ -
กลยุทธ์ระยะไกลที่จะใช้สำหรับการช่วยจำที่กำหนด การส่ง "รีโมต" เป็นโหมดช่วยจำจะตั้งค่าค่าเริ่มต้นสำหรับการช่วยจำที่ไม่ระบุ ใช้ [mnemonic=]remote_strategy[,remote_strategy,...]
แท็ก:execution
,host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--experimental_docker_image=<a string>
: "" -
ระบุชื่ออิมเมจ Docker (เช่น "ubuntu:latest") ที่ควรใช้ในการดำเนินการกับแซนด์บ็อกซ์เมื่อใช้กลยุทธ์ Docker และตัวการดำเนินการนั้นยังไม่มีแอตทริบิวต์ Container-Image ใน Remote_execution_properties ในคำอธิบายแพลตฟอร์มอยู่แล้ว ค่าของแฟล็กนี้จะส่งแบบคำต่อคำไปยัง "Docker Run" จึงรองรับไวยากรณ์และกลไกเดียวกันกับ Docker
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]experimental_docker_use_customized_images
: "จริง" -
หากเปิดใช้ ให้แทรก UID และ gid ของผู้ใช้ปัจจุบันลงในอิมเมจ Docker ก่อนใช้งาน ซึ่งจําเป็นหากบิลด์ / การทดสอบขึ้นอยู่กับผู้ใช้ที่มีชื่อและไดเรกทอรีหน้าแรกในคอนเทนเนอร์ ตัวเลือกนี้จะเปิดอยู่โดยค่าเริ่มต้น แต่คุณสามารถปิดใช้ได้ในกรณีที่ฟีเจอร์การปรับแต่งรูปภาพอัตโนมัติไม่ทำงานในกรณีของคุณ หรือเมื่อคุณทราบว่าไม่จำเป็นต้องใช้แล้ว
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]experimental_dynamic_exclude_tools
: "จริง" -
เมื่อกำหนดแล้ว เป้าหมายที่สร้าง "สำหรับเครื่องมือ" จะไม่ขึ้นอยู่กับการดำเนินการแบบไดนามิก เป้าหมายดังกล่าวไม่สามารถสร้างได้ทีละน้อย จึงไม่คุ้มค่ากับการลงทุนในวงจรในท้องถิ่น
แท็ก:execution
,host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--experimental_dynamic_local_load_factor=<a double>
: "0" -
ควบคุมปริมาณภาระงานจากการดำเนินการแบบไดนามิกที่วางลงในเครื่องภายใน การตั้งค่าสถานะนี้ปรับจำนวนการดำเนินการในการดำเนินการแบบไดนามิกที่เราจะกำหนดเวลาพร้อมกัน ขึ้นอยู่กับจำนวน CPU ที่ Blaze คิดว่าพร้อมใช้งาน ซึ่งควบคุมได้ด้วยแฟล็ก --local_cpu_resources
หากแฟล็กนี้เป็น 0 ระบบจะกำหนดเวลาการดำเนินการทั้งหมดภายในเครื่องทันที หากมากกว่า 0 ระบบจะจำกัดจำนวนการดำเนินการที่ตั้งเวลาในเครื่องตามจำนวน CPU ที่ใช้ได้ หาก < 1 ระบบจะใช้ปัจจัยการโหลดเพื่อลดจำนวนการดำเนินการที่ตั้งเวลาไว้ในเครื่องเมื่อจำนวนการดำเนินการที่รอกำหนดเวลาสูง ซึ่งจะช่วยลดภาระงานของเครื่องภายในได้ในกรณีของบิลด์ที่สะอาดขึ้น ซึ่งเครื่องภายในไม่ได้ให้ประโยชน์มากนัก
แท็ก:execution
,host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--experimental_dynamic_slow_remote_time=<An immutable length of time.>
: "0" -
หากมากกว่า 0 การดำเนินการแบบไดนามิกจะต้องเรียกใช้จากระยะไกลเท่านั้นก่อน เราจะให้ความสำคัญกับการดำเนินการภายในระบบเพื่อหลีกเลี่ยงการหมดเวลาจากระยะไกล การดำเนินการนี้อาจซ่อนปัญหาบางอย่างในระบบการดำเนินการระยะไกล อย่าเปิดฟีเจอร์นี้โดยไม่ได้ตรวจสอบปัญหาการดำเนินการจากระยะไกล
แท็ก:execution
,host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--[no]experimental_enable_docker_sandbox
: "เท็จ" -
เปิดใช้แซนด์บ็อกซ์แบบ Docker ตัวเลือกนี้ไม่มีผลหากไม่ได้ติดตั้ง Docker
แท็ก:execution
--experimental_persistent_javac
-
เปิดใช้คอมไพเลอร์ Java ถาวรรุ่นทดลอง
ขยายเป็น
--strategy=Javac=worker
--strategy=JavaIjar=local
--strategy=JavaDeployJar=local
--strategy=JavaSourceJar=local
--strategy=Turbine=local
แท็ก:execution
,host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--experimental_sandbox_async_tree_delete_idle_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "0" -
หากเป็น 0 ให้ลบแผนผังแซนด์บ็อกซ์ทันทีที่การดำเนินการเสร็จสิ้น (ทำให้การดำเนินการเสร็จสมบูรณ์ล่าช้า) หากมีค่ามากกว่า 0 ให้ประมวลผลการลบ 3 รายการดังกล่าวในพูลเทรดแบบไม่พร้อมกันที่มีขนาด 1 เมื่อบิลด์ทำงานและขยายเป็นขนาดที่ระบุโดยแฟล็กนี้เมื่อเซิร์ฟเวอร์ไม่มีการใช้งาน
แท็ก:host_machine_resource_optimizations
,execution
- ค่าเริ่มต้นของ
--experimental_sandboxfs_path=<a string>
: "sandboxfs" -
เส้นทางไปยังไบนารี sandboxfs ที่จะใช้เมื่อ --experimental_use_sandboxfs เป็นจริง หากชื่อเปล่า ให้ใช้ไบนารีแรกของชื่อดังกล่าวที่พบใน PATH
แท็ก:host_machine_resource_optimizations
,execution
- ค่าเริ่มต้นของ
--[no]experimental_split_xml_generation
: "จริง" -
หากมีการตั้งค่าแฟล็กนี้และการดำเนินการทดสอบไม่สร้างไฟล์ test.xml แล้ว Bazel จะใช้การดำเนินการแยกต่างหากเพื่อสร้างไฟล์ test.xml จำลองที่มีบันทึกทดสอบ หรือไม่เช่นนั้น Bazel จะสร้าง test.xml เป็นส่วนหนึ่งของการดำเนินการทดสอบ
แท็ก:execution
- ค่าเริ่มต้นของ
--experimental_total_worker_memory_limit_mb=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "0" -
หากขีดจำกัดนี้มากกว่า 0 คนซึ่งทำงานที่ไม่มีการใช้งานอาจถูกตัดสิทธิ์หากการใช้หน่วยความจำรวมของผู้ปฏิบัติงานทั้งหมดเกินขีดจำกัด
แท็ก:execution
,host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--[no]experimental_use_hermetic_linux_sandbox
: "เท็จ" -
หากตั้งค่าเป็น "จริง" อย่าต่อเชื่อมรูท ให้ต่อเชื่อมเฉพาะสิ่งที่ให้มากับ sandbox_add_mount_pair ไฟล์อินพุตจะฮาร์ดลิงก์กับแซนด์บ็อกซ์แทนการลิงก์แบบสมมาตรจากแซนด์บ็อกซ์ หากไฟล์อินพุตการดำเนินการอยู่ในระบบไฟล์ที่แตกต่างจากแซนด์บ็อกซ์ ระบบจะคัดลอกไฟล์อินพุตแทน
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]experimental_use_sandboxfs
: "เท็จ" -
ใช้ sandboxfs เพื่อสร้างไดเรกทอรี execroot ของการดำเนินการแทนการสร้างโครงสร้าง symlink หากเป็น "ใช่" ไบนารีที่ระบุโดย --experimental_sandboxfs_path จะต้องถูกต้องและสอดคล้องกับ sandboxf เวอร์ชันที่สนับสนุน หากเป็น "auto" แสดงว่าไบนารีอาจไม่มีหรือใช้ร่วมกันไม่ได้
แท็ก:host_machine_resource_optimizations
,execution
- ค่าเริ่มต้นของ
--[no]experimental_use_windows_sandbox
: "เท็จ" - ใช้แซนด์บ็อกซ์ของ Windows เพื่อเรียกใช้การดำเนินการ ถ้าเป็น "ใช่" ไบนารีที่ระบุโดย --experimental_windows_sandbox_path จะต้องถูกต้องและสอดคล้องกับ sandboxf เวอร์ชันที่สนับสนุน หากเป็น "auto" แสดงว่าไบนารีอาจไม่มีหรือใช้ร่วมกันไม่ได้
- ค่าเริ่มต้นของ
--experimental_windows_sandbox_path=<a string>
: "BazelSandbox.exe" - เส้นทางไปยังไบนารีแซนด์บ็อกซ์ของ Windows ที่จะใช้เมื่อ --experimental_use_windows_sandbox เป็นจริง หากชื่อเปล่า ให้ใช้ไบนารีแรกของชื่อดังกล่าวที่พบใน PATH
- ค่าเริ่มต้นของ
--[no]experimental_worker_as_resource
: "เท็จ" -
หากเปิดใช้ ระบบจะซื้อผู้ปฏิบัติงานเป็นทรัพยากรจาก ResourceManager
แท็ก:execution
,host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--[no]experimental_worker_cancellation
: "เท็จ" -
หากเปิดใช้ไว้ Bazel อาจส่งคำขอยกเลิกไปยังผู้ปฏิบัติงานที่ให้การสนับสนุน
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]experimental_worker_multiplex
: "จริง" -
หากเปิดใช้ ผู้ปฏิบัติงานที่รองรับฟีเจอร์มัลติเพล็กซ์แบบทดลองจะใช้ฟีเจอร์นั้น
แท็ก:execution
,host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--[no]experimental_worker_multiplex_sandboxing
: "เท็จ" -
หากเปิดใช้ ระบบจะแซนด์บ็อกซ์ผู้ปฏิบัติงาน Multiplex โดยใช้ไดเรกทอรีแซนด์บ็อกซ์แยกต่างหากตามคำของาน มีเพียงผู้ปฏิบัติงานที่มีข้อกำหนดการดำเนินการ "supports-multiplex-sandboxing" เท่านั้นที่จะได้รับแซนด์บ็อกซ์
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]experimental_worker_strict_flagfiles
: "เท็จ" -
หากเปิดใช้ อาร์กิวเมนต์การดำเนินการสำหรับผู้ปฏิบัติงานที่ไม่ตรงตามข้อกำหนดผู้ปฏิบัติงานจะเกิดข้อผิดพลาด อาร์กิวเมนต์ผู้ปฏิบัติงานต้องมีอาร์กิวเมนต์ @flagfile เป็นรายการสุดท้ายของอาร์กิวเมนต์
แท็ก:execution
- ค่าเริ่มต้นของ
--genrule_strategy=<comma-separated list of options>
: "" -
ระบุวิธีเรียกใช้ Genrules ธงนี้จะถูกยกเลิก ให้ใช้ --spawn_strategy=<value> เพื่อควบคุมการดำเนินการทั้งหมดแทน หรือ --strategy=GenRule=<value> เพื่อควบคุมเฉพาะ Genrules เท่านั้น
แท็ก:execution
- รวมการใช้งานหลายรายการแล้ว
--high_priority_workers=<a string>
รายการ -
การช่วยจำผู้ปฏิบัติงานที่ต้องทำงานด้วยลำดับความสำคัญสูง ระบบจะควบคุมเวลาที่ผู้ปฏิบัติงานที่มีลำดับความสำคัญสูงกำลังเรียกใช้ผู้ปฏิบัติงานคนอื่นๆ ทั้งหมด
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]incompatible_remote_dangling_symlinks
: "จริง" -
หากตั้งค่าเป็น "จริง" และ --incompatible_remote_symlinks ก็เป็นจริงด้วยเช่นกัน ลิงก์สัญลักษณ์ในเอาต์พุตการดำเนินการจะได้รับอนุญาตให้ห้อยลง
แท็ก:execution
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remote_symlinks
: "จริง" -
หากตั้งค่าเป็น "จริง" Bazel จะแสดงลิงก์สัญลักษณ์ในเอาต์พุตการดำเนินการในโปรโตคอลการแคช/การดำเนินการระยะไกลในลักษณะดังกล่าว มิฉะนั้นระบบจะติดตามลิงก์สัญลักษณ์และแสดงเป็นไฟล์หรือไดเรกทอรี ดูรายละเอียดได้ที่ #6631
แท็ก:execution
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_sandbox_hermetic_tmp
: "เท็จ" -
หากตั้งค่าเป็น "จริง" แซนด์บ็อกซ์ของ Linux แต่ละรายการจะมีไดเรกทอรีว่างเฉพาะของตัวเองที่ต่อเชื่อมเป็น /tmp แทนการแชร์ /tmp กับระบบไฟล์ของโฮสต์ ใช้ --sandbox_add_mount_pair=/tmp เพื่อดู /tmp ของโฮสต์ในแซนด์บ็อกซ์ทั้งหมดต่อไป
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]internal_spawn_scheduler
: "เท็จ" -
ตัวเลือกตัวยึดตำแหน่งเพื่อให้เราบอกใน Blaze ได้ว่าเปิดใช้เครื่องจัดตารางเวลาที่สร้างขึ้นหรือไม่
แท็ก:execution
,host_machine_resource_optimizations
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] ค่าเริ่มต้น: "อัตโนมัติ"-
จำนวนงานที่เกิดขึ้นพร้อมกัน ใช้จำนวนเต็มหรือคีย์เวิร์ด ("auto", "HOST_CPUS", "HOST_RAM") ตามด้วยการดำเนินการ ([-|*]<Flo>) เช่น (ไม่บังคับ) "auto", "HOST_CPUS*.5" ค่าต้องอยู่ระหว่าง 1 ถึง 5000 ค่าที่สูงกว่า 2,500 อาจทำให้เกิดปัญหาเกี่ยวกับหน่วยความจำ "auto" จะคำนวณค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์
แท็ก:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] ค่าเริ่มต้น: "เท็จ"-
ดำเนินการต่อให้มากที่สุดหลังเกิดข้อผิดพลาด แม้ว่าเป้าหมายที่ล้มเหลวและเป้าหมายที่ขึ้นอยู่กับเป้าหมายจะไม่สามารถวิเคราะห์ได้ แต่ข้อกำหนดเบื้องต้นอื่นๆ ของเป้าหมายเหล่านี้อาจทำได้
แท็ก:eagerness_to_exit
- ค่าเริ่มต้นของ
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "อัตโนมัติ" -
จำนวนชุดข้อความที่ทำงานขนานกันที่จะใช้ในขั้นตอนการโหลด/การวิเคราะห์ ใช้จำนวนเต็มหรือคีย์เวิร์ด ("auto", "HOST_CPUS", "HOST_RAM") ตามด้วยการดำเนินการ ([-|*]<Flo>) เช่น "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
: "เท็จ" -
เปิดใช้การสร้าง Pseudoterminal สำหรับการดำเนินการที่มีแซนด์บ็อกซ์อย่างชัดแจ้ง การกระจาย Linux บางรายการกำหนดให้ตั้งค่า group id ของกระบวนการเป็น "tty" ภายในแซนด์บ็อกซ์เพื่อให้ Pseudoterminal ทำงานได้ หากนี่เป็นสาเหตุของปัญหา คุณสามารถปิดธงนี้เพื่อเปิดใช้งานกลุ่มอื่นๆ ได้
แท็ก:execution
- รวมการใช้งานหลายรายการแล้ว
--sandbox_tmpfs_path=<an absolute path>
รายการ -
สำหรับการดำเนินการแซนด์บ็อกซ์ ให้ต่อเชื่อมไดเรกทอรีที่ว่างเปล่าซึ่งเขียนได้ที่เส้นทางสัมบูรณ์นี้ (หากติดตั้งใช้งานแซนด์บ็อกซ์ไว้แล้ว ระบบจะไม่สนใจไดเรกทอรีอื่น)
แท็ก:host_machine_resource_optimizations
,execution
- ค่าเริ่มต้นของ
--spawn_strategy=<comma-separated list of options>
: "" -
ระบุวิธีเรียกใช้การดำเนินการดังกล่าวโดยค่าเริ่มต้น ยอมรับรายการที่คั่นด้วยจุลภาคของกลยุทธ์จากลำดับความสำคัญสูงสุดไปจนถึงต่ำสุด สำหรับการดำเนินการแต่ละรายการ Bazel จะเลือกกลยุทธ์ที่มีลำดับความสำคัญสูงสุดที่สามารถดำเนินการตามนั้นได้ ค่าเริ่มต้นคือ "remote,worker,sandboxed,local" ดูรายละเอียดได้ที่ https://blog.bazel.build/2019/06/19/list-strategy.html
แท็ก:execution
- รวมการใช้งานหลายรายการแล้ว
--strategy=<a '[name=]value1[,..,valueN]' assignment>
รายการ -
ระบุวิธีการเผยแพร่การรวบรวมการกระทำอื่นๆ ที่พบ ยอมรับรายการที่คั่นด้วยจุลภาคของกลยุทธ์จากลำดับความสำคัญสูงสุดไปจนถึงต่ำสุด สำหรับการดำเนินการแต่ละรายการ Bazel จะเลือกกลยุทธ์ที่มีลำดับความสำคัญสูงสุดที่สามารถดำเนินการตามนั้นได้ ค่าเริ่มต้นคือ "remote,worker,sandboxed,local" แฟล็กนี้จะลบล้างค่าที่กำหนดโดย --spawn_strategy (และ --genRule_strategy หากใช้กับการสร้างความทรงจำ) ดูรายละเอียดได้ที่ https://blog.bazel.build/2019/06/19/list-strategy.html
แท็ก:execution
- รวมการใช้งานหลายรายการแล้ว
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
รายการ -
ลบล้างกลยุทธ์การสร้างข้อมูลที่จะใช้เพื่อดำเนินการสร้างซึ่งมีคำอธิบายตรงกับ regex_filter บางรายการ ดูรายละเอียดการจับคู่ onregex_filter ได้ใน --per_file_copt ระบบจะใช้ regex_filter แรกที่ตรงกับคำอธิบาย ตัวเลือกนี้จะลบล้างแฟล็กอื่นๆ เพื่อระบุกลยุทธ์ ตัวอย่างเช่น --strategy_regexp=//foo.*\.cc,-//foo/bar=local หมายถึงการเรียกใช้การดำเนินการโดยใช้กลยุทธ์ในเครื่องหากคำอธิบายตรงกับ //foo.*.cc แต่ไม่ตรงกับ //foo/bar ตัวอย่าง: --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed จะเรียกใช้ "Compiling //foo/bar/baz" ด้วยกลยุทธ์ "local" แต่การกลับคำสั่งซื้อจะเรียกใช้ด้วย "sandboxed"
แท็ก:execution
- รวมการใช้งานหลายรายการแล้ว
--worker_extra_flag=<a 'name=value' assignment>
รายการ -
การแฟล็กคำสั่งพิเศษที่จะส่งไปยังกระบวนการของผู้ปฏิบัติงานนอกเหนือจาก --persistent_worker ซึ่งคีย์ด้วยการช่วยจำ (เช่น --worker_extra_flag=Javac=--debug
แท็ก:execution
,host_machine_resource_optimizations
- รวมการใช้งานหลายรายการแล้ว
--worker_max_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
รายการ -
จำนวนอินสแตนซ์ของกระบวนการสำหรับผู้ปฏิบัติงาน (เช่น Java Compiler ถาวร) ในกรณีที่ใช้กลยุทธ์ "worker" อาจระบุเป็น [name=value] เพื่อให้ค่าที่แตกต่างกันแก่พนักงานแต่ละคน ใช้จำนวนเต็มหรือคีย์เวิร์ด ("auto", "HOST_CPUS", "HOST_RAM") ตามด้วยการดำเนินการ ([-|*]<Flo>) เช่น (ไม่บังคับ) "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">
รายการ -
จำนวน WorkRequests ที่กระบวนการของผู้ปฏิบัติงาน Multiplex อาจได้รับพร้อมกันหากคุณใช้กลยุทธ์ "ผู้ปฏิบัติงาน" กับ --experimental_worker_multiplex อาจระบุเป็น [name=value] เพื่อให้ค่าที่แตกต่างกันแก่พนักงานแต่ละคน ใช้จำนวนเต็มหรือคีย์เวิร์ด ("auto", "HOST_CPUS", "HOST_RAM") ตามด้วยการดำเนินการ ([-|*]<Flo>) เช่น (ไม่บังคับ) "auto", "HOST_CPUS*.5" "auto" จะคำนวณค่าเริ่มต้นที่สมเหตุสมผลตามความจุของเครื่อง "=value" จะตั้งค่าเริ่มต้นสำหรับการช่วยจำที่ไม่ได้ระบุ
แท็ก:execution
,host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--[no]worker_quit_after_build
: "เท็จ" -
หากเปิดใช้ ผู้ปฏิบัติงานทั้งหมดจะปิดตัวลงหลังจากสร้างบิลด์แล้ว
แท็ก:execution
,host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--[no]worker_sandboxing
: "เท็จ" -
หากเปิดใช้ ผู้ปฏิบัติงานจะทำงานในสภาพแวดล้อมแบบแซนด์บ็อกซ์
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]worker_verbose
: "เท็จ" - หากเปิดใช้ ระบบจะพิมพ์ข้อความแบบละเอียดเมื่อผู้ปฏิบัติงานเริ่มทำงาน ปิดเครื่อง...
- ตัวเลือกที่กำหนดค่าห่วงโซ่เครื่องมือที่ใช้สำหรับการดำเนินการมีดังนี้
- ค่าเริ่มต้นของ
--[no]incompatible_disable_runtimes_filegroups
: "เท็จ" -
เลิกใช้งานการเลิกใช้งาน
แท็ก:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_dont_emit_static_libgcc
: "จริง" -
เลิกใช้งานการเลิกใช้งาน
แท็ก:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_linkopts_in_user_link_flags
: "จริง" -
เลิกใช้งานการเลิกใช้งาน
แท็ก:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่ง
- ค่าเริ่มต้นของ
--[no]build
: "จริง" -
ดำเนินการบิลด์ ซึ่งเป็นลักษณะการทำงานปกติ การระบุ --nobuild ทำให้บิลด์หยุดก่อนดำเนินการสร้าง ส่งคืนค่า 0 เท่ากับว่าขั้นตอนการโหลดแพ็กเกจและการวิเคราะห์เสร็จสมบูรณ์ โหมดนี้มีประโยชน์สำหรับการทดสอบระยะดังกล่าว
แท็ก:execution
,affects_outputs
- ค่าเริ่มต้นของ
--[no]experimental_run_validations
: "จริง" -
ใช้ --run_Validations แทน
แท็ก:execution
,affects_outputs
- ค่าเริ่มต้นของ
--[no]experimental_use_validation_aspect
: "เท็จ" -
กำหนดว่าจะเรียกใช้การดำเนินการตรวจสอบโดยใช้มุมมอง (สำหรับการทำงานควบคู่กับการทดสอบ) หรือไม่
แท็ก:execution
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--output_groups=<comma-separated list of options>
รายการ -
รายชื่อกลุ่มเอาต์พุตที่คั่นด้วยคอมมา ซึ่งแต่ละกลุ่มจะขึ้นต้นด้วย + หรือ - ก็ได้ ระบบจะเพิ่มกลุ่มที่ขึ้นต้นด้วย + ลงในชุดกลุ่มเอาต์พุตเริ่มต้น ส่วนกลุ่มที่ขึ้นต้นด้วย - จะถูกนำออกจากชุดเริ่มต้น หากไม่มีกลุ่มนำหน้าอย่างน้อย 1 กลุ่ม ระบบจะละชุดกลุ่มเอาต์พุตเริ่มต้น ตัวอย่างเช่น --output_groups=+foo,+bar จะสร้างการรวมของชุดที่เป็นค่าเริ่มต้น, foo และ bar ส่วน --output_groups=foo,bar จะลบล้างชุดเริ่มต้นเพื่อให้มีการสร้างเฉพาะ foo และ bar
แท็ก:execution
,affects_outputs
- ค่าเริ่มต้นของ
--[no]run_validations
: "จริง" -
ระบุว่าจะเรียกใช้การดำเนินการตรวจสอบเป็นส่วนหนึ่งของบิลด์หรือไม่ ดู https://bazel.build/rules/rules#Validation_actions
แท็ก:execution
,affects_outputs
- ตัวเลือกที่ช่วยให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการ ซึ่งจะส่งผลต่อค่า ต่างจากเดิมที่มีอยู่
- รวมการใช้งานหลายรายการแล้ว
--aspects=<comma-separated list of options>
รายการ - รายการด้านที่คั่นด้วยจุลภาคที่จะใช้กับเป้าหมายระดับบนสุด " นอกจากนี้ some_aspect จะทำงานหลังจากทุกด้านที่จำเป็นที่ระบุโดยแอตทริบิวต์ required จากนั้น some_aspect จะมีสิทธิ์เข้าถึงค่าของผู้ให้บริการของส่วนเหล่านั้น <bzl-file-label>%<aspect_name> เช่น '//tools:my_def.bzl%my_aspect' โดยที่ 'my_aspect' เป็นค่าระดับบนสุดจาก file Tools/my_def.bzl
- ค่าเริ่มต้นของ
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
จำนวนไฟล์เปิดสูงสุดที่อนุญาตระหว่างการอัปโหลดอาร์ติแฟกต์ BEP
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]experimental_convenience_symlinks
: "ปกติ" -
แฟล็กนี้ควบคุมวิธีจัดการลิงก์สัญลักษณ์อำนวยความสะดวก (ลิงก์สัญลักษณ์ที่ปรากฏในพื้นที่ทำงานหลังบิลด์) ค่าที่เป็นไปได้มีดังนี้
ปกติ (ค่าเริ่มต้น): ระบบจะสร้างหรือลบลิงก์สัญลักษณ์อำนวยความสะดวกแต่ละประเภทตามที่บิลด์กำหนด
สะอาด: ระบบจะลบลิงก์สัญลักษณ์ทั้งหมดโดยไม่มีเงื่อนไข
เพิกเฉย: ลิงก์ Symlink จะเป็นเพียงลิงก์เดียว
log_only: สร้างข้อความบันทึกเสมือนว่าผ่าน 'ปกติ' แต่ไม่ได้ดำเนินการเกี่ยวกับระบบไฟล์จริง (มีประโยชน์สำหรับเครื่องมือ)
โปรดทราบว่าเฉพาะลิงก์สัญลักษณ์ที่สร้างขึ้นด้วยค่าปัจจุบันของ --symlink_prefix เท่านั้นที่จะได้รับผลกระทบ หากคำนำหน้าเปลี่ยนไป symlink ที่มีอยู่ก่อนแล้วจะปล่อยไว้ตามเดิม
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]experimental_convenience_symlinks_bep_event
: "เท็จ" -
แฟล็กนี้ควบคุมว่าเราจะโพสต์ eventConvenienceSymlinksIdentified ใน BuildEventProtocol หรือไม่ หากค่าเป็น "true" BuildEventProtocol จะมีรายการ ConvesionSymlinksIdentified ซึ่งแสดงรายการสัญลักษณ์ความสะดวกสบายทั้งหมดที่สร้างขึ้นในพื้นที่ทำงานของคุณ หากเป็น "เท็จ" รายการ ConvensymlinksIdentified ใน BuildEventProtocol จะว่างเปล่า
แท็ก:affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--experimental_multi_cpu=<comma-separated list of options>
รายการ -
เลิกใช้งานแล้ว ไม่ดำเนินการ
แท็ก:affects_outputs
,experimental
--remote_download_minimal
-
ไม่ดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลไปยังเครื่องภายใน ค่าสถานะนี้เป็นทางลัดสำหรับแฟล็ก --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_เอาต์พุต_metadata และ --remote_download_outputs=minimal
ขยายเป็น
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--remote_download_outputs=<all, minimal or toplevel>
: "ทั้งหมด" -
หากตั้งค่าเป็น "ต่ำสุด" จะไม่ดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลใดๆ ไปยังเครื่องในระบบ ยกเว้นเอาต์พุตที่การดำเนินการในเครื่องต้องการ หากตั้งค่าเป็น "ระดับบนสุด" จะมีการทำงานเหมือน "ต่ำสุด" เว้นแต่ว่าจะดาวน์โหลดเอาต์พุตของเป้าหมายระดับบนสุดไปยังเครื่องภายในด้วย ทั้ง 2 ตัวเลือกช่วยลดเวลาในการสร้างได้อย่างมากหากแบนด์วิดท์ของเครือข่ายเป็นจุดคอขวด
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--remote_download_symlink_template=<a string>
: "" -
สร้างลิงก์สัญลักษณ์แทนการดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลไปยังเครื่องภายใน สามารถระบุเป้าหมายของลิงก์สัญลักษณ์ในรูปแบบของสตริงเทมเพลตได้ สตริงเทมเพลตนี้อาจมี {hash} และ {size_bytes} ที่ขยายเป็นแฮชของออบเจ็กต์และขนาดเป็นไบต์ตามลำดับ เช่น ลิงก์สัญลักษณ์เหล่านี้อาจชี้ไปยังระบบไฟล์ FUSE ที่โหลดออบเจ็กต์จาก CAS ออนดีมานด์
แท็ก:affects_outputs
--remote_download_toplevel
-
ดาวน์โหลดเฉพาะเอาต์พุตระยะไกลของเป้าหมายระดับบนสุดไปยังเครื่องภายในเท่านั้น ค่าสถานะนี้เป็นทางลัดสำหรับแฟล็ก --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata และ --remote_download_เอาต์พุต=toplevel
ขยายไปยัง
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
แท็ก:affects_outputs
- ค่าเริ่มต้น
--symlink_prefix=<a string>
: ดูรายละเอียด -
คำนำหน้าที่ใส่ข้างหน้าลิงก์สัญลักษณ์อำนวยความสะดวกที่สร้างขึ้นหลังบิลด์ หากไม่ระบุ ค่าเริ่มต้นจะเป็นชื่อของเครื่องมือสร้างตามด้วยขีดกลาง หากผ่านเครื่องหมาย "/" จะไม่มีการสร้างลิงก์สัญลักษณ์และไม่มีการส่งคำเตือน คำเตือน: ฟังก์ชันพิเศษสำหรับ "/" จะเลิกใช้งานในเร็วๆ นี้ โปรดใช้ --experimental_convenience_symlinks=ignore แทน
แท็ก:affects_outputs
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมของแฟล็ก ฯลฯ)
- ค่าเริ่มต้นของ
--[no]experimental_docker_privileged
: "เท็จ" -
หากเปิดใช้ Bazel จะส่งแฟล็ก --ที่มีสิทธิ์ไปยัง "Ddocker Run" เมื่อเรียกใช้การดำเนินการ ขั้นตอนนี้อาจจำเป็นสำหรับบิลด์ แต่ก็อาจส่งผลให้ความเป็นส่วนตัวลดลงได้
แท็ก:execution
- ค่าเริ่มต้นของ
--experimental_repository_hash_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรยืนยันแฮชไดเรกทอรีที่เก็บ
แท็ก:affects_outputs
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_sandboxfs_map_symlink_targets
: "เท็จ" -
หากเป็นจริง ให้แมปเป้าหมายของลิงก์สัญลักษณ์ที่ระบุเป็นอินพุตการดำเนินการลงในแซนด์บ็อกซ์ ฟีเจอร์นี้มีไว้เพื่อแก้ปัญหากฎข้อบกพร่องเท่านั้น ซึ่งจะไม่ดำเนินการดังกล่าวด้วยตนเอง และควรนำออกเมื่อกฎดังกล่าวทั้งหมดได้รับการแก้ไขแล้ว
แท็ก:host_machine_resource_optimizations
,execution
- รวมการใช้งานหลายรายการแล้ว
--experimental_verify_repository_rules=<a string>
รายการ -
หากรายการกฎที่เก็บซึ่งควรยืนยันแฮชของไดเรกทอรีเอาต์พุต ระบบจะระบุไฟล์โดย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ค่าเริ่มต้นของ
--[no]incompatible_legacy_local_fallback
: "จริง" -
หากตั้งค่าเป็น "จริง" จะเป็นการเปิดใช้กลยุทธ์สำรองโดยนัยแบบเดิมจากแซนด์บ็อกซ์เป็นกลยุทธ์ในเครื่อง ท้ายที่สุดแล้ว แฟล็กนี้จะกำหนดค่าเริ่มต้นเป็น "เท็จ" จากนั้นจะกลายเป็นรายการที่ไม่มีการดำเนินการ โปรดใช้ --strategy, --spawn_strategy หรือ --dynamic_local_strategy เพื่อกำหนดค่าโฆษณาสำรองแทน
แท็ก:execution
,incompatible_change
- รวมการใช้งานหลายรายการแล้ว
--sandbox_add_mount_pair=<a single path or a 'source:target' pair>
รายการ -
เพิ่มคู่เส้นทางเพิ่มเติมเพื่อต่อเชื่อมในแซนด์บ็อกซ์
แท็ก:execution
- รวมการใช้งานหลายรายการแล้ว
--sandbox_block_path=<a string>
รายการ -
สำหรับการดำเนินการแซนด์บ็อกซ์ คุณต้องไม่อนุญาตให้เข้าถึงเส้นทางนี้
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]sandbox_default_allow_network
: "จริง" - อนุญาตให้เข้าถึงเครือข่ายได้โดยค่าเริ่มต้นสำหรับการดำเนินการ ซึ่งอาจใช้ไม่ได้กับการใช้งานแซนด์บ็อกซ์บางอย่าง
- ค่าเริ่มต้นของ
--[no]sandbox_fake_hostname
: "เท็จ" -
เปลี่ยนชื่อโฮสต์ปัจจุบันเป็น "localhost" สำหรับการดำเนินการแซนด์บ็อกซ์
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]sandbox_fake_username
: "เท็จ" -
เปลี่ยนชื่อผู้ใช้ปัจจุบันเป็น "ไม่มี" สำหรับการดำเนินการแซนด์บ็อกซ์
แท็ก:execution
- รวมการใช้งานหลายรายการแล้ว
--sandbox_writable_path=<a string>
รายการ -
สำหรับการดำเนินการในแซนด์บ็อกซ์ คุณควรทำให้ไดเรกทอรีที่มีอยู่เขียนได้ในแซนด์บ็อกซ์ (หากการใช้งานแซนด์บ็อกซ์รองรับ มิเช่นนั้น ระบบจะไม่สนใจ)
แท็ก:execution
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้ใน BUILD ไฟล์ .bzl หรือไฟล์ WORKSPACE
- ค่าเริ่มต้นของ
--[no]experimental_allow_top_level_aspects_parameters
: "จริง" -
ไม่ดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ค่าเริ่มต้นของ
--[no]incompatible_config_setting_private_default_visibility
: "เท็จ" -
หากแฟล็กนี้เป็นเท็จ config_setting ที่ไม่มีแอตทริบิวต์การเปิดเผยอย่างชัดเจนจะเป็น //visibility:public หากแฟล็กนี้เป็นจริง config_setting จะใช้ตรรกะการแสดงผลเดียวกันกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_enforce_config_setting_visibility
: "จริง" -
หากเป็น "จริง" ให้บังคับใช้ข้อจํากัดระดับการเข้าถึง config_setting หากเป็น "เท็จ" ทุก config_setting จะปรากฏกับทุกเป้าหมาย ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่ควบคุมลักษณะการทำงานของสภาพแวดล้อมการทดสอบหรือตัวดำเนินการทดสอบมีดังนี้
- ค่าเริ่มต้นของ
--[no]check_tests_up_to_date
: "เท็จ" -
อย่าทำการทดสอบ เพียงแค่ตรวจสอบว่าข้อมูลเหล่านั้นเป็นปัจจุบันหรือไม่ หากผลการทดสอบทั้งหมดเป็นปัจจุบัน แสดงว่าการทดสอบเสร็จสมบูรณ์แล้ว หากจำเป็นต้องสร้างหรือดำเนินการทดสอบ ระบบจะรายงานข้อผิดพลาดและการทดสอบจะไม่สำเร็จ ตัวเลือกนี้หมายถึงลักษณะการทำงานของ --check_up_to_date
แท็ก:execution
- รวมการใช้งานหลายรายการแล้ว
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
รายการ -
ในกรณีที่การทดสอบล้มเหลว ระบบจะลองทดสอบแต่ละรายการซ้ำให้ครบตามจำนวนครั้งที่กำหนด ระบบจะทำเครื่องหมายการทดสอบที่ต้องผ่านมากกว่า 1 ครั้งเป็น "FLAKY" ในสรุปการทดสอบ โดยปกติแล้วค่าที่ระบุเป็นเพียงจำนวนเต็มหรือสตริง "ค่าเริ่มต้น" หากเป็นจำนวนเต็ม การทดสอบทั้งหมดจะทำงานได้สูงสุด N ครั้ง หากเลือก "ค่าเริ่มต้น" จะมีการทดสอบเพียง 1 ครั้งสำหรับการทดสอบปกติ และอีก 3 ครั้งสำหรับการทดสอบที่ทำเครื่องหมายไว้อย่างชัดเจนว่าไม่น่าเชื่อถือตามกฎ (แอตทริบิวต์ขจัดคราบ 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") ตามด้วยการดำเนินการ ([-|*]<Flo>) เช่น (ไม่บังคับ) "auto", "HOST_CPUS*.5" 0 หมายความว่าทรัพยากรในเครื่องจะจำกัดจำนวนงานทดสอบในเครื่องที่จะเรียกใช้พร้อมกันแทน การตั้งค่านี้ที่มากกว่าค่าสำหรับ --jobs จะไม่ส่งผลใดๆ
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]test_keep_going
: "จริง" -
เมื่อปิดใช้ การทดสอบที่ไม่ผ่านจะทำให้บิลด์ทั้งหมดหยุดทำงาน การทดสอบทั้งหมดจะทำงานโดยค่าเริ่มต้น แม้บางรายการจะไม่ผ่าน
แท็ก:execution
- ค่าเริ่มต้นของ
--test_strategy=<a string>
: "" -
ระบุกลยุทธ์ที่จะใช้เมื่อทำการทดสอบ
แท็ก:execution
- ค่าเริ่มต้น
--test_tmpdir=<a path>
: ดูรายละเอียด - ระบุไดเรกทอรีชั่วคราวพื้นฐานที่จะใช้สำหรับ "การทดสอบเบเซล"
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod
- รวมการใช้งานหลายรายการแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ซึ่งจะอนุญาตให้ใช้ในกราฟการอ้างอิงที่แก้ไขแล้วแม้ว่าจะมีการประกาศว่าได้รับการแย้งในรีจิสทรีที่เป็นแหล่งที่มา (หากเว็บไซต์ไม่ได้มาจาก NonRegistryReplace) มิฉะนั้น เวอร์ชันที่ยัดเยียดจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชัน yank ที่อนุญาตได้ด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" คุณสามารถปิดใช้งานการตรวจสอบนี้ได้โดยใช้คำหลัก "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ หรือ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบว่าข้อมูลไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบที่ไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าทรัพยากร Dependency ดังกล่าวจะถูกละเว้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท โดยไม่คำนึงถึงค่าของแฟล็กนี้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--lockfile_mode=<off, update or error>
: "ปิด" -
ระบุว่าจะใช้ Lockfile อย่างไรและจะใช้หรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ Lockfile และอัปเดตเมื่อมีการเปลี่ยนแปลง "ข้อผิดพลาด" ให้ใช้ Lockfile แต่จะแสดงข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่ออ่านหรือเขียนไฟล์ล็อกทั้ง 2 ไฟล์
แท็ก: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
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งการบันทึกมีดังนี้
- ค่าเริ่มต้นของ
--[no]announce
: "เท็จ" -
เลิกใช้งานแล้ว ไม่ดำเนินการ
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]debug_spawn_scheduler
: "เท็จ" - ค่าเริ่มต้นของ
--[no]experimental_bep_target_summary
: "เท็จ" - ต้องการเผยแพร่เหตุการณ์ TargetSummary หรือไม่
- ค่าเริ่มต้นของ
--[no]experimental_build_event_expand_filesets
: "เท็จ" -
หากเป็น "จริง" ให้ขยายชุดไฟล์ใน BEP เมื่อนำเสนอไฟล์เอาต์พุต
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: "เท็จ" -
หากเป็น "จริง" ให้แปลงสัญลักษณ์ Fileset ที่เกี่ยวข้องอย่างสมบูรณ์ใน BEP เมื่อนำเสนอไฟล์เอาต์พุต ต้องใช้ --experimental_build_event_expand_filesets
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--experimental_build_event_upload_max_retries=<an integer>
: "4" -
จํานวนครั้งสูงสุดที่บาเซลควรลองอัปโหลดเหตุการณ์บิลด์อีกครั้ง
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1 วินาที" -
ขั้นแรกคือการหน่วงเวลาขั้นต่ำสำหรับการลองย้อนกลับแบบเอ็กซ์โปเนนเชียลเมื่อการอัปโหลด BEP ล้มเหลว (exponent: 1.6)
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--experimental_build_event_upload_strategy=<a string>
: ดูรายละเอียด -
เลือกวิธีอัปโหลดอาร์ติแฟกต์ที่อ้างอิงในโปรโตคอลเหตุการณ์ของบิลด์
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]experimental_collect_local_sandbox_action_metrics
: "จริง" -
เมื่อเปิดใช้ ระบบจะบันทึกสถิติการดำเนินการ (เช่น เวลาของผู้ใช้และเวลาของระบบ) สำหรับการดำเนินการในเครื่องซึ่งใช้แซนด์บ็อกซ์
แท็กต่อไปนี้execution
- ค่าเริ่มต้นของ
--[no]experimental_docker_verbose
: "เท็จ" -
หากเปิดใช้ Bazel จะพิมพ์ข้อความแบบละเอียดเพิ่มเติมเกี่ยวกับกลยุทธ์แซนด์บ็อกซ์ของ Docker
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]experimental_materialize_param_files_directly
: "เท็จ" -
หากทำให้ไฟล์พารามิเตอร์เป็นรูปธรรม ให้ทำด้วยการเขียนลงดิสก์โดยตรง
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]experimental_record_metrics_for_all_mnemonics
: "เท็จ" - โดยค่าเริ่มต้น ประเภทการดําเนินการจะจํากัดอยู่ที่ 20 ประเภทที่มีจำนวนการดำเนินการสูงสุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสําหรับการช่วยจำทั้งหมด
- ค่าเริ่มต้นของ
--experimental_repository_resolved_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้เขียนค่า Starlark ด้วยข้อมูลที่แก้ไขแล้วของกฎที่เก็บ Starlark ทั้งหมดที่มีการนำไปใช้
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]experimental_stream_log_file_uploads
: "เท็จ" -
ไฟล์บันทึกของสตรีมจะอัปโหลดไปยังพื้นที่เก็บข้อมูลระยะไกลโดยตรงแทนที่จะอัปโหลดลงในดิสก์
แท็ก:affects_outputs
- ค่าเริ่มต้น
--explain=<a path>
: ดูรายละเอียด -
ทำให้ระบบบิลด์อธิบายแต่ละขั้นตอนที่ดำเนินการของบิลด์ ระบบจะเขียนคำอธิบายลงในไฟล์บันทึกที่ระบุ
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]legacy_important_outputs
: "จริง" -
ใช้สิ่งนี้เพื่อระงับการสร้างช่องimportant_controls เดิมในเหตุการณ์ TargetComplete ต้องมีimportant_outputs สำหรับการผสานรวม Bazel กับ ResultsStore
แท็ก: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_เอาต์พุต เป็น "ข้อผิดพลาด" หรือ "ทั้งหมด" มีประโยชน์สำหรับการหลีกเลี่ยงผลลัพธ์ทดสอบที่มีเสียงดังรบกวนมากเกินไป ส่วนหัวการทดสอบจะรวมอยู่ในขนาดบันทึก ค่าลบหมายถึงไม่มีขีดจำกัด เอาต์พุตทั้งหมดหรือไม่ใช้เลย
แท็ก:test_runner
,terminal_output
,execution
- ค่าเริ่มต้น
--output_filter=<a valid Java regular expression>
: ดูรายละเอียด -
แสดงเฉพาะคำเตือนสำหรับกฎที่มีชื่อตรงกับนิพจน์ทั่วไปที่ระบุ
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--progress_report_interval=<an integer in 0-3600 range>
: "0" -
จำนวนวินาทีระหว่างการรายงานเกี่ยวกับงานที่ยังคงทำงานอยู่ ค่าเริ่มต้น 0 หมายความว่าระบบจะพิมพ์รายงานแรกหลังผ่านไป 10 วินาที จากนั้นจะพิมพ์ 30 วินาทีและหลังจากรายงานความคืบหน้านั้นทุกๆ นาที เมื่อเปิดใช้ --curses ระบบจะรายงานความคืบหน้าทุกวินาที
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--remote_print_execution_messages=<failure, success or all>
: "failure" -
เลือกเวลาที่จะพิมพ์ข้อความการดำเนินการจากระยะไกล ค่าที่ถูกต้องคือ "failure" จะพิมพ์เฉพาะเวลาที่ล้มเหลว "ความสำเร็จ" จะพิมพ์เฉพาะเมื่อสำเร็จ และ "all" จะพิมพ์ทุกครั้ง
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]sandbox_debug
: "เท็จ" -
เปิดใช้ฟีเจอร์การแก้ไขข้อบกพร่องสำหรับฟีเจอร์แซนด์บ็อกซ์ ซึ่งประกอบด้วย 2 อย่าง อย่างแรก เนื้อหารากของแซนด์บ็อกซ์จะไม่ได้รับผลกระทบใดๆ หลังจากการสร้าง (และหากมีการใช้ sandboxf อยู่ ระบบจะต่อเชื่อมระบบไฟล์ค้างไว้) และข้อที่ 2 จะพิมพ์ข้อมูลการแก้ไขข้อบกพร่องเพิ่มเติมเมื่อมีการดำเนินการ การดำเนินการเช่นนี้จะช่วยให้นักพัฒนาซอฟต์แวร์ใช้กฎ Bazel หรือ Starlark ในการแก้ไขข้อบกพร่องที่ไม่สำเร็จเนื่องจากไฟล์อินพุตขาดหายไป เป็นต้น
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--show_result=<an integer>
: "1" -
แสดงผลลัพธ์ของบิลด์ ให้ระบุว่าเป้าหมายแต่ละรายการเป็นข้อมูลล่าสุดหรือไม่ และมีรายการไฟล์เอาต์พุตที่สร้างขึ้นหรือไม่ หากมี ไฟล์ที่พิมพ์เป็นสตริงที่สะดวกสบายในการคัดลอก+วางลงใน Shell เพื่อสั่งการ
ตัวเลือกนี้ต้องการอาร์กิวเมนต์จำนวนเต็ม ซึ่งเป็นจำนวนเกณฑ์ของเป้าหมายข้างต้นซึ่งจะไม่มีการพิมพ์ข้อมูลผลลัพธ์ ดังนั้นศูนย์ทำให้ไม่สามารถระงับข้อความได้และ MAX_INT จะทำให้พิมพ์ผลลัพธ์ทุกครั้ง ค่าเริ่มต้นคือ 1
แท็ก:affects_outputs
--[no]subcommands
[-s
] ค่าเริ่มต้น: "เท็จ"-
แสดงคำสั่งย่อยที่ดำเนินการระหว่างบิลด์ แฟล็กที่เกี่ยวข้อง: --execution_log_json_file, --execution_log_binary_file (สำหรับการบันทึกคำสั่งย่อยไปยังไฟล์ในรูปแบบที่ใช้งานง่าย)
แท็ก:terminal_output
- ค่าเริ่มต้น
--test_output=<summary, errors, all or streamed>
: "สรุป" -
ระบุโหมดเอาต์พุตที่ต้องการ ค่าที่ใช้ได้ ได้แก่ "สรุป" เพื่อแสดงผลเฉพาะสรุปสถานะการทดสอบ "ข้อผิดพลาด" เพื่อพิมพ์บันทึกการทดสอบสำหรับการทดสอบที่ล้มเหลวด้วย "ทั้งหมด" เพื่อพิมพ์บันทึกสำหรับการทดสอบทั้งหมด และ "สตรีม" เป็นเอาต์พุตบันทึกสำหรับการทดสอบทั้งหมดแบบเรียลไทม์ (ซึ่งจะบังคับให้ทำการทดสอบในเครื่องต่อครั้ง โดยไม่คำนึงถึงค่า --test_strategy)
แท็ก:test_runner
,terminal_output
,execution
- ค่าเริ่มต้นของ
--test_summary=<short, terse, detailed, none or testcase>
: "short" -
ระบุรูปแบบที่ต้องการของสรุปการทดสอบ ค่าที่ถูกต้องคือ "สั้น" เพื่อพิมพ์ข้อมูลเกี่ยวกับการทดสอบที่ดำเนินการเท่านั้น "ทั่วไป" เพื่อพิมพ์เฉพาะข้อมูลเกี่ยวกับการทดสอบที่ไม่สำเร็จที่เรียกใช้ "รายละเอียด" เพื่อพิมพ์ข้อมูลโดยละเอียดเกี่ยวกับกรอบการทดสอบที่ล้มเหลว "กรณีทดสอบ" เพื่อพิมพ์ข้อมูลสรุปในการแก้ปัญหาเกี่ยวกับกรอบการทดสอบ อย่าพิมพ์ข้อมูลโดยละเอียดเกี่ยวกับกรอบการทดสอบที่ล้มเหลว และ "ไม่มี" เพื่อละเว้นข้อมูลสรุป
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]verbose_explanations
: "เท็จ" -
เพิ่มรายละเอียดของคำอธิบายหากเปิดใช้ --explain ไว้ จะไม่มีผล หากไม่ได้เปิดใช้ --explain
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]verbose_failures
: "เท็จ" -
หากคำสั่งล้มเหลว ให้พิมพ์บรรทัดคำสั่งแบบเต็ม
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- รวมการใช้งานหลายรายการแล้ว
--aspects_parameters=<a 'name=value' assignment>
รายการ -
ระบุค่าของพารามิเตอร์ลักษณะบรรทัดคำสั่ง ค่าพารามิเตอร์แต่ละค่าจะระบุผ่าน <param_name>=<param_value> ตัวอย่างเช่น 'my_param=my_val' โดยที่ 'my_param' เป็นพารามิเตอร์ของบางลักษณะในรายการ --aspects หรือจำเป็นสำหรับด้านในรายการ ตัวเลือกนี้ใช้ได้หลายครั้ง อย่างไรก็ตาม เราไม่อนุญาตให้กําหนดค่าให้กับพารามิเตอร์เดียวกันมากกว่า 1 ครั้ง
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
หากไม่ว่างเปล่า ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ค่าเริ่มต้นของ
--target_pattern_file=<a string>
: "" -
หากตั้งค่าแล้ว บิลด์จะอ่านรูปแบบจากไฟล์ที่มีชื่อที่นี่ ไม่ใช่ในบรรทัดคำสั่ง การระบุไฟล์ที่นี่รวมถึงรูปแบบบรรทัดคำสั่งเป็นข้อผิดพลาด
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
- ค่าเริ่มต้น
--experimental_circuit_breaker_strategy=<failure>
: ดูรายละเอียด -
ระบุกลยุทธ์ที่เบรกเกอร์จะใช้ กลยุทธ์ที่ใช้ได้คือ "ล้มเหลว" เมื่อค่าไม่ถูกต้องสำหรับตัวเลือก ลักษณะการทำงานจะเหมือนกับที่ไม่ได้กำหนดตัวเลือกไว้
แท็ก:execution
- ค่าเริ่มต้น
--experimental_downloader_config=<a string>
: ดูรายละเอียด - ระบุไฟล์ที่จะใช้กำหนดค่าเครื่องมือดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด โดยแต่ละบรรทัดจะขึ้นต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือ 2 รูปแบบ รูปแบบหนึ่งเพื่อจับคู่กับ และอีกแบบหนึ่งใช้เป็น URL แทนโดยมีการอ้างอิงย้อนกลับที่เริ่มจาก "$1" เป็นไปได้ที่คำสั่ง "rewrite" อาจมีผลลัพธ์ใน URL เดียวกันหลายรายการ และระบบจะส่ง URL เดียวกันนี้กลับไปหลายรายการสำหรับ URL เดียวกัน)
- ค่าเริ่มต้นของ
--[no]experimental_guard_against_concurrent_changes
: "เท็จ" - ปิดการตั้งค่านี้เพื่อปิดใช้การตรวจสอบเวลาของไฟล์อินพุตของการดำเนินการก่อนที่จะอัปโหลดไปยังแคชระยะไกล อาจมีกรณีที่เคอร์เนลของ Linux ทำให้การเขียนไฟล์ล่าช้า ซึ่งอาจทำให้เกิดผลบวกลวง
- ค่าเริ่มต้นของ
--experimental_remote_build_event_upload=<all or minimal>
: "ทั้งหมด" - หากตั้งค่าเป็น "ทั้งหมด" ระบบจะอัปโหลดเอาต์พุตในเครื่องทั้งหมดที่ BEP อ้างอิงไปยังแคชระยะไกล หากตั้งค่าเป็น "minimal" เอาต์พุตในเครื่องที่อ้างอิงโดย BEP จะไม่อัปโหลดไปยังแคชระยะไกล ยกเว้นไฟล์ที่มีความสำคัญต่อผู้ใช้ BEP (เช่น บันทึกการทดสอบและโปรไฟล์การจับเวลา) ระบบจะใช้รูปแบบ bytesstream:// กับ URI ของไฟล์เสมอแม้ว่าจะหายไปจากแคชระยะไกลก็ตาม มีค่าเริ่มต้นเป็น "ทั้งหมด"
- ค่าเริ่มต้นของ
--[no]experimental_remote_cache_async
: "เท็จ" - หากเป็น "จริง" I/O แคชระยะไกลจะเกิดขึ้นในเบื้องหลังแทนที่จะเกิดขึ้นเป็นส่วนหนึ่งของการสร้าง
- ค่าเริ่มต้นของ
--[no]experimental_remote_cache_compression
: "เท็จ" - หากเปิดใช้ ให้บีบอัด/ยกเลิกการบีบอัด Cache Blob ด้วย zstd
- ค่าเริ่มต้นของ
--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
- ค่าเริ่มต้น
--experimental_remote_capture_corrupted_outputs=<a path>
: ดูรายละเอียด - เส้นทางไปยังไดเรกทอรีที่จะบันทึกเอาต์พุตที่เสียหาย
- ค่าเริ่มต้นของ
--[no]experimental_remote_discard_merkle_trees
: "เท็จ" - หากตั้งค่าเป็น "จริง" ให้ทิ้งสำเนาในหน่วยความจำของต้นไม้ Merkle ของรูทอินพุตและการแมปอินพุตที่เกี่ยวข้องระหว่างการเรียกใช้ GetAction Results() และ Execute() ซึ่งวิธีนี้จะช่วยลดการใช้หน่วยความจำลงอย่างมาก แต่ Bazel จะต้องคำนวณใหม่เมื่อแคชระยะไกลไม่พบและลองใหม่
- ค่าเริ่มต้น
--experimental_remote_downloader=<a string>
: ดูรายละเอียด - URI ปลายทางของ Remote Asset API ที่จะใช้เป็นพร็อกซีการดาวน์โหลดระยะไกล สคีมาที่รองรับคือ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (UNIX Sockets) หากไม่ได้กำหนดสคีมาไว้ Bazel จะใช้ค่าเริ่มต้นเป็น grpcs โปรดดูที่ https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.prof
- ค่าเริ่มต้นของ
--[no]experimental_remote_downloader_local_fallback
: "เท็จ" - จะกลับไปใช้โปรแกรมดาวน์โหลดในเครื่องหากโปรแกรมดาวน์โหลดระยะไกลล้มเหลว
- ค่าเริ่มต้นของ
--[no]experimental_remote_execution_keepalive
: "เท็จ" - ต้องการใช้ Keepalive สำหรับการเรียกใช้การดำเนินการระยะไกลหรือไม่
- ค่าเริ่มต้นของ
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
: "10" -
กำหนดจำนวนอัตราการทำงานไม่สำเร็จเป็นเปอร์เซ็นต์ที่อนุญาตสำหรับกรอบเวลาหนึ่งๆ หลังจากที่ระบบหยุดเรียกใช้แคช/ไฟล์ดำเนินการระยะไกล ค่าเริ่มต้นคือ 10 การตั้งค่านี้เป็น 0 หมายความว่าจะไม่มีข้อจำกัด
แท็ก:execution
- ค่าเริ่มต้นของ
--experimental_remote_failure_window_interval=<An immutable length of time.>
: "60 วินาที" -
ช่วงที่มีการคำนวณอัตราความล้มเหลวของคำขอระยะไกล สำหรับค่าศูนย์หรือค่าลบ ระยะเวลาที่ล้มเหลวจะได้รับการคำนวณตลอดระยะเวลาของการดำเนินการ หน่วยต่อไปนี้สามารถใช้ได้: วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]experimental_remote_mark_tool_inputs
: "เท็จ" - หากตั้งค่าเป็น "จริง" Bazel จะทำเครื่องหมายอินพุตเป็นอินพุตเครื่องมือสำหรับผู้ดำเนินการระยะไกล ข้อมูลนี้สามารถใช้ในการติดตั้งใช้งานผู้ปฏิบัติงานถาวรระยะไกล
- ค่าเริ่มต้นของ
--[no]experimental_remote_merkle_tree_cache
: "เท็จ" - หากตั้งค่าเป็น "จริง" ระบบจะบันทึกการคำนวณต้นไม้ Merkle เพื่อปรับปรุงความเร็วในการตรวจสอบ Hit ของแคชระยะไกล รอยเท้าหน่วยความจำของแคชจะควบคุมโดย --experimental_remote_merkle_tree_cache_size
- ค่าเริ่มต้นของ
--experimental_remote_merkle_tree_cache_size=<a long integer>
: "1,000" - จำนวนต้น Merkle ที่จะบันทึกเพื่อปรับปรุงความเร็วในการตรวจสอบแคชระยะไกล แม้ว่าแคชจะถูกตัดออกโดยอัตโนมัติตามการจัดการแบบซอฟต์การอ้างอิงของ Java แต่ข้อผิดพลาดจากหน่วยความจำนอกหน่วยความจำอาจเกิดขึ้นได้หากตั้งค่าสูงเกินไป หากตั้งค่าเป็น 0 ขนาดของแคชจะเป็นแบบไม่จำกัด มูลค่าที่เหมาะสมที่สุดจะแตกต่างกันไปโดยขึ้นอยู่กับขนาดของโปรเจ็กต์ ค่าเริ่มต้นคือ 1,000
- ค่าเริ่มต้นของ
--[no]experimental_remote_require_cached
: "เท็จ" - หากตั้งค่าเป็น "จริง" ให้บังคับให้มีการแคชการดำเนินการทั้งหมดที่เรียกใช้จากระยะไกลได้ มิเช่นนั้นระบบจะสร้างบิลด์ไม่สำเร็จ วิธีนี้มีประโยชน์ในการแก้ปัญหาที่ไม่ขึ้นอยู่กับการตัดสินใจ เนื่องจากจะช่วยให้สามารถตรวจสอบว่ามีการแคชการดำเนินการที่ควรแคชไว้จริงหรือไม่ โดยไม่ต้องแทรกผลลัพธ์ใหม่ลงในแคช
- ค่าเริ่มต้นของ
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "เท็จ" - หากตั้งค่าเป็น "จริง" ระบบจะไม่อัปโหลดเอาต์พุตที่ BEP อ้างอิงไปยังแคชระยะไกลหากการดำเนินการที่สร้างไม่สามารถแคชจากระยะไกลได้
- ค่าเริ่มต้นของ
--[no]incompatible_remote_downloader_send_all_headers
: "จริง" -
กำหนดว่าจะส่งค่าของส่วนหัวที่มีหลายค่าไปยังเครื่องมือดาวน์โหลดระยะไกลแทนที่จะส่งเพียงค่าแรกหรือไม่
แท็ก:incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remote_output_paths_relative_to_input_root
: "เท็จ" -
หากตั้งค่าเป็น "จริง" เส้นทางเอาต์พุตจะสัมพัทธ์กับรูทของอินพุตแทนที่จะเป็นไดเรกทอรีที่ใช้งานอยู่
แท็ก:incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remote_results_ignore_disk
: "จริง" -
หากตั้งค่าเป็น "จริง" --noremote_upload_local_results และ --noremote_accept_cached จะไม่มีผลกับดิสก์แคช หากใช้แคชแบบรวม:
--noremote_upload_local_results จะทำให้มีการเขียนผลลัพธ์ลงในดิสก์แคช แต่ไม่อัปโหลดไปยังแคชระยะไกล
--noremote_accept_cached จะทำให้ Bazel ตรวจสอบผลลัพธ์ในดิสก์แคช แต่ไม่ใช่ในแคชระยะไกล
การดำเนินการ no-remote-exec สามารถไปยังดิสก์แคชได้
ดูรายละเอียดได้ที่ #8216
แท็ก:incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
: "เท็จ" -
หากตั้งค่าเป็น "จริง" Bazel จะใช้รหัสออกใหม่ 39 แทน 34 หากแคชระยะไกลกำจัด BLOB ระหว่างบิลด์
แท็ก:incompatible_change
- ค่าเริ่มต้นของ
--[no]remote_accept_cached
: "จริง" - กำหนดว่าจะยอมรับผลการดำเนินการที่แคชไว้จากระยะไกลหรือไม่
- ค่าเริ่มต้น
--remote_bytestream_uri_prefix=<a string>
: ดูรายละเอียด - ชื่อโฮสต์และชื่ออินสแตนซ์ที่จะใช้ใน bytesstream:// URI ที่เขียนลงในสตรีมเหตุการณ์ของบิลด์ ตัวเลือกนี้จะตั้งค่าได้เมื่อมีการดำเนินการบิลด์โดยใช้พร็อกซี ซึ่งทำให้ค่าของ --remote_executor และ --remote_instance_name ไม่ตรงกับชื่อมาตรฐานของบริการดำเนินการระยะไกลอีกต่อไป เมื่อไม่ได้ตั้งค่า ค่าเริ่มต้นจะเป็น "${ชื่อโฮสต์}/${instance_name}"
- ค่าเริ่มต้น
--remote_cache=<a string>
: ดูรายละเอียด - URI ของปลายทางการแคช สคีมาที่รองรับ ได้แก่ http, https, grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (UNIX Sockets) หากไม่ได้กำหนดสคีมาไว้ Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุสคีมา grpc://, http:// หรือ unix: เพื่อปิดใช้ TLS โปรดดู https://bazel.build/remote/caching
- รวมการใช้งานหลายรายการแล้ว
--remote_cache_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอแคช ดังนี้ --remote_cache_header=Name=Value คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- รวมการใช้งานหลายรายการแล้ว
--remote_default_exec_properties=<a 'name=value' assignment>
รายการ -
ตั้งค่าพร็อพเพอร์ตี้ exec เริ่มต้นเพื่อใช้เป็นแพลตฟอร์มการดำเนินการระยะไกล หากแพลตฟอร์มการดำเนินการยังไม่ได้ตั้งค่า exec_properties
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--remote_default_platform_properties=<a string>
: "" - ตั้งค่าพร็อพเพอร์ตี้แพลตฟอร์มเริ่มต้นที่จะตั้งค่าสำหรับ API การดำเนินการระยะไกล หากแพลตฟอร์มการดำเนินการยังไม่ได้ตั้งค่า Remote_execution_properties ไว้ ระบบจะใช้ค่านี้ด้วยหากเลือกแพลตฟอร์มโฮสต์เป็นแพลตฟอร์มการดำเนินการสำหรับการดำเนินการจากระยะไกล
- รวมการใช้งานหลายรายการแล้ว
--remote_downloader_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอเครื่องมือดาวน์โหลดระยะไกล: --remote_downloader_header=Name=Value คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- รวมการใช้งานหลายรายการแล้ว
--remote_exec_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอการดำเนินการ: --remote_exec_header=Name=Value คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- ค่าเริ่มต้นของ
--remote_execution_priority=<an integer>
: "0" - ลำดับความสำคัญของการดำเนินการที่จะดำเนินการจากระยะไกล ความหมายของค่าลำดับความสำคัญหนึ่งๆ จะขึ้นอยู่กับเซิร์ฟเวอร์
- ค่าเริ่มต้น
--remote_executor=<a string>
: ดูรายละเอียด - HOST หรือ HOST:PORT ของปลายทางการดำเนินการระยะไกล สคีมาที่รองรับคือ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (UNIX Sockets) หากไม่ได้กำหนดสคีมาไว้ Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุ grpc:// หรือ unix: schema เพื่อปิดใช้ TLS
- ค่าเริ่มต้น
--remote_grpc_log=<a path>
: ดูรายละเอียด - หากระบุไว้ ระบบจะกำหนดเส้นทางไปยังไฟล์เพื่อบันทึกรายละเอียดที่เกี่ยวข้องกับการเรียกใช้ gRPC บันทึกนี้ประกอบด้วยลำดับของ com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry ที่ชื่อว่า ทำการ ทำการ ctrbufs ตามลำดับ โดยให้แต่ละข้อความนำหน้าด้วยตัวแปรที่แสดงถึงขนาดของข้อความ เป็นไฟล์ ctrbuf ที่ต่อเนื่องกันต่อไปนี้ ตามที่ดำเนินการโดยเมธอด LogEntry.writeDelimitedTo(ExportStream)
- รวมการใช้งานหลายรายการแล้ว
--remote_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอ: --remote_header=Name=Value คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- ค่าเริ่มต้นของ
--remote_instance_name=<a string>
: "" - ค่าที่จะส่งผ่านเป็นอินสแตนซ์_name ใน API การดำเนินการระยะไกล
- ค่าเริ่มต้นของ
--[no]remote_local_fallback
: "เท็จ" - กำหนดว่าจะกลับไปใช้กลยุทธ์การดำเนินการภายในเครื่องแบบสแตนด์อโลนหากการดำเนินการจากระยะไกลล้มเหลว
- ค่าเริ่มต้นของ
--remote_local_fallback_strategy=<a string>
: "ท้องถิ่น" - ไม่มีการดำเนินการ เลิกใช้งานไปแล้ว ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7480
- ค่าเริ่มต้นของ
--remote_max_connections=<an integer>
: "100" -
จำกัดจำนวนการเชื่อมต่อสูงสุดพร้อมกันไว้ที่แคช/ผู้ดำเนินการระยะไกล ค่าเริ่มต้นคือ 100 การตั้งค่านี้เป็น 0 หมายความว่าจะไม่มีข้อจำกัด
สำหรับแคชระยะไกลของ HTTP การเชื่อมต่อ TCP 1 รายการจะจัดการคำขอ 1 รายการต่อครั้ง ดังนั้น Bazel สามารถสร้างคำขอพร้อมกันถึง --remote_max_connections รายการ
สำหรับแคช/ไฟล์ดำเนินการระยะไกลของ gRPC ช่อง gRPC 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.>
: "5 วินาที" - การหน่วงเวลา Backoff สูงสุดระหว่างการลองใหม่จากระยะไกล หน่วยต่อไปนี้สามารถใช้ได้: วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
- ค่าเริ่มต้นของ
--remote_timeout=<An immutable length of time.>
: "60 วินาที" - ระยะเวลาสูงสุดในการรอการดำเนินการจากระยะไกลและการเรียกใช้แคช สำหรับแคช REST จะเป็นทั้งระยะหมดเวลาของการเชื่อมต่อและการอ่าน หน่วยต่อไปนี้สามารถใช้ได้: วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
- ค่าเริ่มต้นของ
--[no]remote_upload_local_results
: "จริง" - กำหนดว่าจะอัปโหลดผลการดำเนินการที่ดำเนินการในเครื่องไปยังแคชระยะไกลหรือไม่ หากรีโมตแคชรองรับและผู้ใช้ได้รับอนุญาตให้ดำเนินการ
- ค่าเริ่มต้นของ
--[no]remote_verify_downloads
: "จริง" - หากตั้งค่าเป็น "จริง" Bazel จะคำนวณผลรวมแฮชของการดาวน์โหลดจากระยะไกลทั้งหมด และทิ้งค่าที่แคชไว้จากระยะไกลหากไม่ตรงกับค่าที่คาดไว้
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้จัดหมวดหมู่:
- ค่าเริ่มต้นของ
--[no]allow_analysis_cache_discard
: "จริง" -
หากทิ้งแคชการวิเคราะห์เนื่องจากการเปลี่ยนแปลงในระบบบิลด์ การตั้งค่าตัวเลือกนี้เป็น "เท็จ" จะทำให้เบลิเทลออก แทนที่จะดำเนินการต่อกับบิลด์ ตัวเลือกนี้จะไม่มีผลเมื่อตั้งค่า "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 and //javatests/foo จะถือเป็นแพ็กเกจเดียว)"
- ค่าเริ่มต้นของ
--[no]build_manual_tests
: "เท็จ" - บังคับให้สร้างเป้าหมายการทดสอบที่ติดแท็ก "ด้วยตนเอง" ระบบจะไม่ประมวลผลการทดสอบ "ด้วยตนเอง" โดยตัวเลือกนี้จะบังคับให้สร้าง (แต่ดำเนินการไม่ได้)
- ค่าเริ่มต้นของ
--build_tag_filters=<comma-separated list of options>
: "" - ระบุรายการแท็กที่คั่นด้วยคอมมา แต่ละแท็กสามารถนำหน้าด้วย '-' เพื่อระบุแท็กที่ยกเว้นได้ ระบบจะสร้างเฉพาะเป้าหมายที่มีแท็กที่รวมอย่างน้อย 1 แท็ก และไม่มีแท็กที่ยกเว้น ตัวเลือกนี้ไม่มีผลกับชุดการทดสอบที่ดำเนินการด้วยคำสั่ง "test" ซึ่งจะควบคุมโดยตัวเลือกการกรองการทดสอบ เช่น "--test_tag_filters"
- ค่าเริ่มต้นของ
--[no]build_tests_only
: "เท็จ" - หากระบุ ระบบจะสร้างเฉพาะกฎ *_test และ test_suite และไม่สนใจเป้าหมายอื่นๆ ที่ระบุไว้ในบรรทัดคำสั่ง ระบบจะสร้างทุกอย่างตามที่ขอโดยค่าเริ่มต้น
- ค่าเริ่มต้นของ
--combined_report=<none or lcov>
: "ไม่มี" - ระบุประเภทรายงานการครอบคลุมสะสมที่ต้องการ ตอนนี้รองรับเฉพาะ LCOV เท่านั้น
- ค่าเริ่มต้นของ
--[no]compile_one_dependency
: "เท็จ" - รวบรวมทรัพยากร Dependency เดียวของไฟล์อาร์กิวเมนต์ วิธีนี้มีประโยชน์สำหรับการตรวจสอบไวยากรณ์ของไฟล์ต้นฉบับใน IDE เช่น ด้วยการสร้างเป้าหมายเดียวใหม่ซึ่งขึ้นอยู่กับไฟล์แหล่งที่มาเพื่อตรวจหาข้อผิดพลาดโดยเร็วที่สุดในรอบการแก้ไข/สร้าง/ทดสอบ อาร์กิวเมนต์นี้ส่งผลต่อวิธีแปลอาร์กิวเมนต์ทั้งหมดที่ไม่ใช่ Flag แทนที่จะเป็นเป้าหมายเพื่อสร้างเป็นชื่อไฟล์ต้นทาง จะมีการสร้างเป้าหมายที่กำหนดเองสำหรับชื่อไฟล์แหล่งข้อมูลแต่ละชื่อขึ้น
- รวมการใช้งานหลายรายการแล้ว
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
รายการ - กำหนดค่าโปรแกรมช่วยข้อมูลเข้าสู่ระบบเพื่อใช้สำหรับเรียกข้อมูลเข้าสู่ระบบของการให้สิทธิ์สำหรับการดึงข้อมูลที่เก็บ การแคชและการดำเนินการจากระยะไกล รวมถึงบริการเหตุการณ์ของบิลด์ ข้อมูลเข้าสู่ระบบที่ผู้ช่วยเหลือมีให้จะมีความสำคัญเหนือกว่าข้อมูลรับรองที่ --google_default_credentials, --google_credentials, ไฟล์ .netrc หรือพารามิเตอร์ auth ไปยัง billing_ctx.download และ billing_ctx.download_and_extract นั้น อาจระบุได้หลายครั้งเพื่อตั้งค่าผู้ช่วยเหลือหลายราย ดูรายละเอียดได้ที่ https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md
- ค่าเริ่มต้นของ
--credential_helper_cache_duration=<An immutable length of time.>
: "30 นาที" - ระยะเวลาในการแคชข้อมูลเข้าสู่ระบบที่โปรแกรมช่วยรับรองข้อมูลเข้าสู่ระบบให้ไว้ การเรียกใช้ด้วยค่าที่แตกต่างกันจะปรับอายุการใช้งานของรายการที่มีอยู่ก่อนหน้า การส่งค่าเป็น 0 เพื่อล้างแคช คำสั่งสะอาดจะล้างแคชเสมอ โดยไม่คำนึงถึงแฟล็กนี้
- ค่าเริ่มต้นของ
--credential_helper_timeout=<An immutable length of time.>
: "10 วินาที" - กำหนดค่าระยะหมดเวลาสำหรับตัวช่วยข้อมูลเข้าสู่ระบบ ตัวช่วยข้อมูลเข้าสู่ระบบที่ไม่ตอบสนองภายในระยะหมดเวลานี้จะเรียกใช้ไม่สำเร็จ
- ค่าเริ่มต้นของ
--deleted_packages=<comma-separated list of package names>
: "" - รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริง แม้ว่าจะปรากฏในตำแหน่งใดบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ ตัวอย่างเช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์แล้ว ระบบบิลด์อาจร้องเรียนหากพบป้ายกำกับ "//x:y/z" หากมีป้ายกำกับ "//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>
: ดูรายละเอียด - บันทึกการเรียกใช้ที่เรียกใช้ลงในไฟล์นี้เป็น "Sptown Protos" ที่คั่นด้วยอักขระ ตาม src/main/ctrbuf/spawn.Proto ระบบจะเขียนบันทึกก่อนโดยไม่เรียงลำดับ จากนั้นเมื่อสิ้นสุดคำขอ โดยจะจัดเรียงตามลำดับที่เสถียร (อาจเป็นการใช้ CPU และหน่วยความจำมาก) แฟล็กที่เกี่ยวข้อง: --execution_log_json_file (รูปแบบ JSON ของข้อความลำดับ), --experimental_execution_log_file (รูปแบบไบนารี โพรโทบูฟที่ไม่เรียงลำดับ), --คำสั่งย่อย (สำหรับการแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
- ค่าเริ่มต้น
--execution_log_json_file=<a path>
: ดูรายละเอียด - บันทึกการเรียกใช้ที่สร้างขึ้นลงในไฟล์นี้ในรูปแบบ JSON ของ Proto ที่คั่นด้วยตัวคั่นตาม " src/main/ctrbuf/spawn.สอง" ระบบจะเขียนบันทึกก่อนโดยไม่เรียงลำดับ จากนั้นเมื่อสิ้นสุดคำขอ โดยจะจัดเรียงตามลำดับที่เสถียร (อาจเป็นการใช้ CPU และหน่วยความจำมาก) แฟล็กที่เกี่ยวข้อง: แฟล็กที่เกี่ยวข้อง: --execution_log_binary_file (รูปแบบไบนารีตามลำดับ), --experimental_execution_log_file (รูปแบบไบนารีที่ไม่เรียงลำดับ), --commands (สำหรับการแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
- ค่าเริ่มต้นของ
--[no]execution_log_sort
: "จริง" - เลือกว่าจะจัดเรียงบันทึกการดำเนินการหรือไม่ ตั้งค่าเป็น "เท็จ" เพื่อปรับปรุงประสิทธิภาพของหน่วยความจำ ซึ่งจะมีค่าใช้จ่ายในการสร้างบันทึกตามลำดับที่กำหนดไม่ได้
- ค่าเริ่มต้นของ
--[no]expand_test_suites
: "จริง" -
ขยายเป้าหมาย test_suite ไปยังการทดสอบส่วนประกอบก่อนการวิเคราะห์ เมื่อเปิดแฟล็กนี้ (ค่าเริ่มต้น) รูปแบบเป้าหมายเชิงลบจะมีผลกับการทดสอบที่อยู่ในชุดทดสอบ ไม่เช่นนั้นจะไม่มีผล การปิดแฟล็กนี้เป็นประโยชน์เมื่อมีการใช้มุมมองระดับบนสุดในบรรทัดคำสั่ง จากนั้นจึงวิเคราะห์เป้าหมาย test_suite ได้
แท็ก:loading_and_analysis
- ค่าเริ่มต้น
--experimental_execution_log_file=<a path>
: ดูรายละเอียด - บันทึกการเรียกใช้ที่เรียกใช้ลงในไฟล์นี้เป็น "Sptown Protos" ที่คั่นด้วยอักขระ ตาม src/main/ctrbuf/spawn.Proto ไฟล์นี้เขียนขึ้นตามลำดับการเรียกใช้การสร้างซอฟต์แวร์ แฟล็กที่เกี่ยวข้อง: --execution_log_binary_file (รูปแบบไบนารี โพรโทบูฟที่เรียงลำดับ), --execution_log_json_file (รูปแบบ JSON ข้อความที่เรียงลำดับ), --คำสั่งย่อย (สำหรับการแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
- ค่าเริ่มต้นของ
--[no]experimental_execution_log_spawn_metrics
: "เท็จ" - รวมเมตริกที่สร้างขึ้นในบันทึกการสร้างการดำเนินการ
- ค่าเริ่มต้นของ
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "" - เลิกใช้งานเพื่อสนับสนุนแง่มุมต่างๆ ตัวกรองชุดเป้าหมายเพื่อกำหนดเวลา extra_actions สำหรับ
- ค่าเริ่มต้นของ
--[no]experimental_extra_action_top_level_only
: "เท็จ" - เลิกใช้งานเพื่อสนับสนุนแง่มุมต่างๆ กำหนดเวลา additional_actions สำหรับเป้าหมายระดับบนสุดเท่านั้น
- ค่าเริ่มต้นของ
--[no]experimental_prioritize_local_actions
: "จริง" -
หากตั้งค่าแล้ว การดำเนินการที่เรียกใช้ในเครื่องได้เท่านั้นจะได้รับโอกาสแรกในการได้รับทรัพยากร ผู้ปฏิบัติงานที่เรียกใช้แบบไดนามิกจะได้รับโอกาสครั้งที่ 2 และการดำเนินการแบบสแตนด์อโลนที่เรียกใช้แบบไดนามิกจะเข้ามาเป็นลำดับสุดท้าย
แท็ก:execution
--experimental_spawn_scheduler
-
เปิดใช้การดำเนินการแบบไดนามิกโดยเรียกใช้การดำเนินการในเครื่องและจากระยะไกลไปพร้อมกัน Bazel จะวางเป้าหมายแต่ละแบบไว้ในเครื่องและจากระยะไกล แล้วเลือกการทำงานให้เสร็จก่อน หากการดำเนินการรองรับผู้ปฏิบัติงาน การดำเนินการเฉพาะเครื่องจะทำงานในโหมดผู้ปฏิบัติงานถาวร หากต้องการเปิดใช้การดำเนินการแบบไดนามิกสำหรับการจดจำการดำเนินการแต่ละรายการ ให้ใช้แฟล็ก "--internal_spawn_scheduler" และ "--strategy=<mnemonic>=dynamic" แทน
ขยายเป็น
--internal_spawn_scheduler
--spawn_strategy=dynamic
- ค่าเริ่มต้นของ
--google_auth_scopes=<comma-separated list of options>
: "https://www.googleapis.com/auth/cloud-platform" - รายการขอบเขตการตรวจสอบสิทธิ์ Google Cloud ที่คั่นด้วยคอมมา
- ค่าเริ่มต้น
--google_credentials=<a string>
: ดูรายละเอียด - ระบุไฟล์ที่จะรับข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication
- ค่าเริ่มต้นของ
--[no]google_default_credentials
: "เท็จ" - ระบุว่าจะใช้ "ข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชันของ Google" สำหรับการตรวจสอบสิทธิ์หรือไม่ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication ปิดใช้โดยค่าเริ่มต้น
- ค่าเริ่มต้น
--grpc_keepalive_time=<An immutable length of time.>
: ดูรายละเอียด - กำหนดค่าคําสั่ง ping แบบ Keep-alive สำหรับการเชื่อมต่อ gRPC ขาออก หากตั้งค่านี้ Bazel จะส่งคำสั่ง ping หลังจากไม่มีการดำเนินการอ่านการเชื่อมต่อเป็นเวลานานกว่านี้ แต่เฉพาะในกรณีที่มีการเรียกใช้ gRPC ที่รอดำเนินการอย่างน้อย 1 รายการ เวลาจะถือว่าเป็นรายละเอียดที่ 2 จึงถือเป็นข้อผิดพลาดในการตั้งค่าที่น้อยกว่า 1 วินาที โดยค่าเริ่มต้น การใช้คำสั่ง ping แบบ Keep-alive จะปิดใช้อยู่ คุณควรประสานงานกับเจ้าของบริการก่อนเปิดใช้การตั้งค่านี้ ตัวอย่างเช่น หากต้องการตั้งค่า 30 วินาทีเป็น Flag นี้ ก็ควรจะเป็น --grpc_keepalive_time=30s
- ค่าเริ่มต้นของ
--grpc_keepalive_timeout=<An immutable length of time.>
: "20 วินาที" - กำหนดค่าระยะหมดเวลา Keep-alive สำหรับการเชื่อมต่อ gRPC ขาออก หากเปิดใช้คำสั่ง ping แบบ Keep-alive พร้อมกับ --grpc_keepalive_time จากนั้น Bazel จะหมดเวลาการเชื่อมต่อหากไม่มีการตอบกลับคำสั่ง ping หลังผ่านไประยะหนึ่ง เวลาจะถือว่าเป็นรายละเอียดที่ 2 จึงถือเป็นข้อผิดพลาดในการตั้งค่าที่น้อยกว่า 1 วินาที หากปิดใช้คำสั่ง ping แบบ Keep-alive อยู่ ระบบจะไม่สนใจการตั้งค่านี้
- ค่าเริ่มต้นของ
--[no]ignore_unsupported_sandboxing
: "เท็จ" - อย่าพิมพ์คำเตือนเมื่อระบบนี้ไม่รองรับการดำเนินการแซนด์บ็อกซ์
- ค่าเริ่มต้นของ
--[no]incompatible_dont_use_javasourceinfoprovider
: "เท็จ" -
ไม่ดำเนินการ
แท็ก:incompatible_change
- ค่าเริ่มต้นของ
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
: "HOST_CPUS" - กำหนดจำนวนแกน CPU ในเครื่องทั้งหมดที่ Bazel จะใช้ได้เพื่อใช้จ่ายกับการดำเนินการของบิลด์ที่ดำเนินการในเครื่อง จะใช้จำนวนเต็มหรือ "HOST_CPUS" ตามด้วย [-|*]<Flo> (เช่น HOST_CPUS*.5 เพื่อใช้แกน CPU ที่มีครึ่งหนึ่งโดยค่าเริ่มต้น ("HOST_CPUS") Bazel จะค้นหาการกำหนดค่าระบบเพื่อประมาณจำนวนแกนของ CPU ที่มี
- รวมการใช้งานหลายรายการแล้ว
--local_extra_resources=<a named float, 'name=value'>
รายการ - กำหนดจำนวนทรัพยากรเพิ่มเติมที่พร้อมใช้งานใน Bazel ใช้งานในคู่สตริงลอย ใช้ได้หลายครั้งเพื่อระบุทรัพยากรเพิ่มเติมหลายประเภท Bazel จะจำกัดการทำงานที่เกิดขึ้นพร้อมกันตามทรัพยากรเพิ่มเติมที่มีและทรัพยากรเพิ่มเติมที่จำเป็น การทดสอบจะประกาศจำนวนทรัพยากรเพิ่มเติมที่ต้องการได้โดยใช้แท็กรูปแบบ "resources:<resoucename>:<amount>" ไม่สามารถตั้งค่า CPU, RAM และทรัพยากรที่ใช้ได้ด้วยแฟล็กนี้
- ค่าเริ่มต้นของ
--local_ram_resources=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "HOST_RAM*.67" - กำหนดจำนวน RAM ของโฮสต์ในเครื่องทั้งหมด (เป็น MB) ที่ใช้ได้สำหรับ Bazel อย่างชัดเจนเพื่อใช้สำหรับการดำเนินการบิลด์ที่ดำเนินการในเครื่อง จะใช้จำนวนเต็มหรือ "HOST_RAM" แล้วตามด้วย [-|*]<Flo> (เช่น HOST_RAM*.5 เพื่อใช้ RAM ที่มีอยู่ครึ่งหนึ่ง) โดยค่าเริ่มต้น ("HOST_RAM*.67") Bazel จะค้นหาการกำหนดค่าของระบบเพื่อประมาณปริมาณ RAM ที่มีอยู่และจะใช้ 67%
- ค่าเริ่มต้นของ
--local_termination_grace_seconds=<an integer>
: "15" - เวลาที่ต้องรอจนกว่าจะสิ้นสุดกระบวนการในเครื่องเนื่องจากหมดเวลาแล้วจึงบังคับให้ปิดกระบวนการ
- รวมการใช้งานหลายรายการแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace"
- ค่าเริ่มต้นของ
--package_path=<colon-separated list of options>
: "%workspace%" - รายการที่คั่นด้วยเครื่องหมายทวิภาคของตำแหน่งสำหรับค้นหาแพ็กเกจ องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับพื้นที่ทำงานที่ล้อมรอบอยู่ หากไม่ระบุหรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
- ค่าเริ่มต้นของ
--[no]show_loading_progress
: "จริง" - หากเปิดใช้จะทำให้ Bazel พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ"
- ค่าเริ่มต้นของ
--test_lang_filters=<comma-separated list of options>
: "" - ระบุรายการภาษาทดสอบที่คั่นด้วยคอมมา แต่ละภาษาสามารถนำหน้าด้วย '-' เพื่อระบุภาษาที่ยกเว้นได้ พบเฉพาะเป้าหมายการทดสอบที่เขียนเป็นภาษาที่ระบุเท่านั้น ชื่อที่ใช้สำหรับแต่ละภาษาควรเหมือนกับคำนำหน้าภาษาในกฎ *_test เช่น 'cc', 'java', 'py' เป็นต้น ตัวเลือกนี้จะส่งผลต่อลักษณะการทำงาน --build_tests_only และคำสั่งทดสอบ
- ค่าเริ่มต้นของ
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
: "" - ระบุรายการขนาดทดสอบที่คั่นด้วยคอมมา แต่ละขนาดสามารถนำหน้าด้วยเครื่องหมาย '-' เพื่อระบุขนาดที่ยกเว้นได้ ระบบจะพบเฉพาะเป้าหมายทดสอบเหล่านั้นที่มีขนาดรวมอย่างน้อย 1 ขนาดและไม่มีขนาดที่ยกเว้น ตัวเลือกนี้มีผลกับลักษณะการทำงาน --build_tests_only และคำสั่งทดสอบ
- ค่าเริ่มต้นของ
--test_tag_filters=<comma-separated list of options>
: "" - ระบุรายการแท็กทดสอบที่คั่นด้วยคอมมา แต่ละแท็กสามารถนำหน้าด้วย '-' เพื่อระบุแท็กที่ยกเว้นได้ เฉพาะเป้าหมายทดสอบเหล่านั้นที่มีแท็กที่รวมอยู่อย่างน้อย 1 แท็กและไม่มีแท็กที่ยกเว้น ตัวเลือกนี้มีผลกับลักษณะการทำงาน --build_tests_only และคำสั่งทดสอบ
- ค่าเริ่มต้นของ
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
: "" - ระบุรายการระยะหมดเวลาทดสอบที่คั่นด้วยคอมมา แต่ละระยะหมดเวลาสามารถนำหน้าด้วย "-" ได้ เพื่อระบุระยะหมดเวลาที่ยกเว้น ระบบจะพบเฉพาะเป้าหมายการทดสอบที่มีระยะหมดเวลาที่รวมอย่างน้อย 1 รายการ และไม่มีระยะหมดเวลาที่ยกเว้น ตัวเลือกนี้มีผลกับลักษณะการทำงาน --build_tests_only และคำสั่งทดสอบ
- ค่าเริ่มต้น
--tls_certificate=<a string>
: ดูรายละเอียด - ระบุเส้นทางไปยังใบรับรอง TLS ที่เชื่อถือได้ให้ลงนามในใบรับรองเซิร์ฟเวอร์
- ค่าเริ่มต้น
--tls_client_certificate=<a string>
: ดูรายละเอียด - ระบุใบรับรองไคลเอ็นต์ TLS ที่จะใช้ โดยต้องระบุคีย์ไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
- ค่าเริ่มต้น
--tls_client_key=<a string>
: ดูรายละเอียด - ระบุคีย์ไคลเอ็นต์ TLS ที่จะใช้ นอกจากนี้ คุณยังต้องระบุใบรับรองไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
- ค่าเริ่มต้นของ
--workspace_status_command=<path>
: "" - ระบบจะเรียกใช้คำสั่งในตอนต้นของบิลด์เพื่อให้ข้อมูลสถานะเกี่ยวกับพื้นที่ทำงานในรูปแบบคู่คีย์/ค่า ดูข้อกำหนดทั้งหมดได้ในคู่มือผู้ใช้ ดูตัวอย่างเครื่องมือ/buildstamp/get_workspace_status
- ตัวเลือกที่ควบคุมการดำเนินการบิลด์มีดังนี้
- ค่าเริ่มต้นของ
--[no]check_up_to_date
: "เท็จ" -
ไม่ต้องดำเนินการใดๆ เพียงแค่ตรวจสอบว่าเป็นเวอร์ชันล่าสุดแล้วหรือไม่ หากเป้าหมายทั้งหมดเป็นปัจจุบัน บิลด์นั้นจะเสร็จสมบูรณ์ หากจำเป็นต้องดำเนินขั้นตอนใดก็ตาม จะมีการรายงานข้อผิดพลาดและบิลด์ล้มเหลว
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]experimental_inprocess_symlink_creation
: "เท็จ" -
ไม่ว่าจะเป็นการเรียกใช้ระบบไฟล์โดยตรงเพื่อสร้างต้นไม้ลิงก์สัญลักษณ์
แท็ก:loading_and_analysis
,execution
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_remotable_source_manifests
: "เท็จ" -
ไม่ว่าจะเป็นการทำให้การดำเนินการในไฟล์ Manifest ของแหล่งที่มาทำงานซ้ำได้
แท็ก:loading_and_analysis
,execution
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_split_coverage_postprocessing
: "เท็จ" -
หากเป็น "จริง" Bazel จะเรียกใช้การประมวลผลภายหลังการครอบคลุมเพื่อทดสอบในการวางรูปแบบใหม่
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]experimental_split_xml_generation
: "จริง" -
หากมีการตั้งค่าแฟล็กนี้และการดำเนินการทดสอบไม่สร้างไฟล์ test.xml แล้ว Bazel จะใช้การดำเนินการแยกต่างหากเพื่อสร้างไฟล์ test.xml จำลองที่มีบันทึกทดสอบ หรือไม่เช่นนั้น Bazel จะสร้าง test.xml เป็นส่วนหนึ่งของการดำเนินการทดสอบ
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]experimental_strict_fileset_output
: "เท็จ" -
หากเปิดใช้ตัวเลือกนี้ ชุดไฟล์จะถือว่าอาร์ติแฟกต์เอาต์พุตทั้งหมดเป็นไฟล์ปกติ และจะไม่ข้ามผ่านไดเรกทอรีหรือไวต่อลิงก์สัญลักษณ์
แท็ก:execution
- ค่าเริ่มต้นของ
--genrule_strategy=<comma-separated list of options>
: "" -
ระบุวิธีเรียกใช้ Genrules ธงนี้จะถูกยกเลิก ให้ใช้ --spawn_strategy=<value> เพื่อควบคุมการดำเนินการทั้งหมดแทน หรือ --strategy=GenRule=<value> เพื่อควบคุมเฉพาะ Genrules เท่านั้น
แท็ก:execution
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] ค่าเริ่มต้น: "อัตโนมัติ"-
จำนวนงานที่เกิดขึ้นพร้อมกัน ใช้จำนวนเต็มหรือคีย์เวิร์ด ("auto", "HOST_CPUS", "HOST_RAM") ตามด้วยการดำเนินการ ([-|*]<Flo>) เช่น (ไม่บังคับ) "auto", "HOST_CPUS*.5" ค่าต้องอยู่ระหว่าง 1 ถึง 5000 ค่าที่สูงกว่า 2,500 อาจทำให้เกิดปัญหาเกี่ยวกับหน่วยความจำ "auto" จะคำนวณค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์
แท็ก:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] ค่าเริ่มต้น: "เท็จ"-
ดำเนินการต่อให้มากที่สุดหลังเกิดข้อผิดพลาด แม้ว่าเป้าหมายที่ล้มเหลวและเป้าหมายที่ขึ้นอยู่กับเป้าหมายจะไม่สามารถวิเคราะห์ได้ แต่ข้อกำหนดเบื้องต้นอื่นๆ ของเป้าหมายเหล่านี้อาจทำได้
แท็ก:eagerness_to_exit
- ค่าเริ่มต้นของ
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "อัตโนมัติ" -
จำนวนชุดข้อความที่ทำงานขนานกันที่จะใช้ในขั้นตอนการโหลด/การวิเคราะห์ ใช้จำนวนเต็มหรือคีย์เวิร์ด ("auto", "HOST_CPUS", "HOST_RAM") ตามด้วยการดำเนินการ ([-|*]<Flo>) เช่น "auto", "HOST_CPUS*.5" "auto" ตั้งค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
: "" -
เพิ่มหรือนำคีย์ออกจากข้อมูลการดำเนินการของการดำเนินการตามคำสั่งจำเพาะ ใช้กับการดำเนินการที่รองรับข้อมูลการดำเนินการเท่านั้น การดำเนินการทั่วไปหลายรายการรองรับข้อมูลการดำเนินการ เช่น GenRule, CppCompile, Javac, StarlarkAction, TestRunner เมื่อระบุค่าหลายค่า การจัดเรียงจะมีความสำคัญเนื่องจาก regexe หลายรายการอาจใช้กับการช่วยจำเดียวกัน
ไวยากรณ์: "regex=[+-]key,regex=[+-]key,..."
เช่น '.*=+x,.*=-y,.*=+z' จะเพิ่ม "x" และ "z" ลงในและนำ "y" ออกจากข้อมูลการดำเนินการสำหรับการดำเนินการทั้งหมด
"GenRule=+requires-x" เพิ่ม "requires-x" ไปยังข้อมูลการดำเนินการสำหรับการดำเนินการ GenRule ทั้งหมด
"(?!GenRule).*=-requires-x" จะนำ "requires-x" ออกจากข้อมูลการดำเนินการสำหรับการดำเนินการทั้งหมดที่ไม่ใช่ประเภท
แท็ก:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
เปิดใช้ Android Dex และเครื่องมือลดน้ำตาลแบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--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
{/1/}
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_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
{/1/}
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
-
เปิดใช้เครื่องมือ Android แบบต่อเนื่องและแบบมัลติเพล็กซ์ (การแยกออก การกรองน้ำตาล การประมวลผลทรัพยากร)
ขยายเป็น
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
แท็ก:host_machine_resource_optimizations
,execution
- ค่าเริ่มต้นของ
--spawn_strategy=<comma-separated list of options>
: "" -
ระบุวิธีเรียกใช้การดำเนินการดังกล่าวโดยค่าเริ่มต้น ยอมรับรายการที่คั่นด้วยจุลภาคของกลยุทธ์จากลำดับความสำคัญสูงสุดไปจนถึงต่ำสุด สำหรับการดำเนินการแต่ละรายการ Bazel จะเลือกกลยุทธ์ที่มีลำดับความสำคัญสูงสุดที่สามารถดำเนินการตามนั้นได้ ค่าเริ่มต้นคือ "remote,worker,sandboxed,local" ดูรายละเอียดได้ที่ https://blog.bazel.build/2019/06/19/list-strategy.html
แท็ก:execution
- รวมการใช้งานหลายรายการแล้ว
--strategy=<a '[name=]value1[,..,valueN]' assignment>
รายการ -
ระบุวิธีการเผยแพร่การรวบรวมการกระทำอื่นๆ ที่พบ ยอมรับรายการที่คั่นด้วยจุลภาคของกลยุทธ์จากลำดับความสำคัญสูงสุดไปจนถึงต่ำสุด สำหรับการดำเนินการแต่ละรายการ Bazel จะเลือกกลยุทธ์ที่มีลำดับความสำคัญสูงสุดที่สามารถดำเนินการตามนั้นได้ ค่าเริ่มต้นคือ "remote,worker,sandboxed,local" แฟล็กนี้จะลบล้างค่าที่กำหนดโดย --spawn_strategy (และ --genRule_strategy หากใช้กับการสร้างความทรงจำ) ดูรายละเอียดได้ที่ https://blog.bazel.build/2019/06/19/list-strategy.html
แท็ก:execution
- รวมการใช้งานหลายรายการแล้ว
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
รายการ -
ลบล้างกลยุทธ์การสร้างข้อมูลที่จะใช้เพื่อดำเนินการสร้างซึ่งมีคำอธิบายตรงกับ regex_filter บางรายการ ดูรายละเอียดการจับคู่ onregex_filter ได้ใน --per_file_copt ระบบจะใช้ regex_filter แรกที่ตรงกับคำอธิบาย ตัวเลือกนี้จะลบล้างแฟล็กอื่นๆ เพื่อระบุกลยุทธ์ ตัวอย่างเช่น --strategy_regexp=//foo.*\.cc,-//foo/bar=local หมายถึงการเรียกใช้การดำเนินการโดยใช้กลยุทธ์ในเครื่องหากคำอธิบายตรงกับ //foo.*.cc แต่ไม่ตรงกับ //foo/bar ตัวอย่าง: --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed จะเรียกใช้ "Compiling //foo/bar/baz" ด้วยกลยุทธ์ "local" แต่การกลับคำสั่งซื้อจะเรียกใช้ด้วย "sandboxed"
แท็ก:execution
- ตัวเลือกที่กำหนดค่าห่วงโซ่เครื่องมือที่ใช้สำหรับการดำเนินการดำเนินการ
- ค่าเริ่มต้น
--android_compiler=<a string>
: ดูรายละเอียด -
คอมไพเลอร์เป้าหมายของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_crosstool_top=<a build target label>
: "//external:android/crosstool" -
ตำแหน่งของคอมไพเลอร์ C++ ที่ใช้สำหรับบิลด์ของ Android
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--android_grte_top=<a label>
: ดูรายละเอียด -
เป้าหมาย Android คือ grte_top
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_manifest_merger=<legacy, android or force_android>
: "android" -
เลือกการผสานไฟล์ Manifest เพื่อใช้กับกฎ android_binary แจ้งเพื่อช่วยในการเปลี่ยนจากการควบรวมกิจการเดิมไปเป็นการ ผสานรวมไฟล์ Manifest ของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_platforms=<a build target label>
: "" -
ตั้งค่าแพลตฟอร์มที่เป้าหมายของ android_binary ใช้ หากระบุหลายแพลตฟอร์ม ไบนารีจะเป็น APK แบบอ้วน ซึ่งประกอบด้วยไบนารีแบบเนทีฟสำหรับแต่ละแพลตฟอร์มเป้าหมายที่ระบุ
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/android:sdk"-
ระบุ SDK/แพลตฟอร์ม Android ที่ใช้สร้างแอปพลิเคชัน Android
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--apple_compiler=<a string>
: ดูรายละเอียด -
คอมไพเลอร์เป้าหมายของ Apple มีประโยชน์สำหรับการเลือกตัวแปรของ Toolchain (เช่น xcode-beta)
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้ในกฎ Apple และ Objc รวมถึงทรัพยากร Dependency
แท็ก:loses_incremental_state
,changes_inputs
- ค่าเริ่มต้น
--apple_grte_top=<a build target label>
: ดูรายละเอียด -
เป้าหมายของ Apple คือ grte_top
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--cc_output_directory_tag=<a string>
: "" -
ระบุส่วนต่อท้ายที่จะเพิ่มในไดเรกทอรีการกำหนดค่า
แท็ก:affects_outputs
,explicit_in_output_path
- ค่าเริ่มต้น
--compiler=<a string>
: ดูรายละเอียด -
คอมไพเลอร์ C++ ที่จะใช้สำหรับการคอมไพล์เป้าหมาย
แท็ก:loading_and_analysis
,execution
- ค่าเริ่มต้นของ
--coverage_output_generator=<a build target label>
: "@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_generate" -
ตำแหน่งของไบนารีที่ใช้ในการสร้างรายงานการครอบคลุม ปัจจุบันนี้ต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดี่ยว ซึ่งก็คือไบนารี มีค่าเริ่มต้นเป็น "//tools/test:coverage_report_generate"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_support"-
ตำแหน่งของไฟล์สนับสนุนที่จำเป็นต้องมีในอินพุตของการดำเนินการทดสอบทุกรายการที่รวบรวมความครอบคลุมของโค้ด มีค่าเริ่มต้นเป็น "//tools/test:coverage_support"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้ในการคอมไพล์โค้ด C++
แท็ก:loading_and_analysis
,changes_inputs
,affects_outputs
- ค่าเริ่มต้น
--custom_malloc=<a build target label>
: ดูรายละเอียด -
ระบุการใช้งาน Malloc ที่กําหนดเอง การตั้งค่านี้จะลบล้างแอตทริบิวต์ Malloc ในกฎบิลด์
แท็ก:changes_inputs
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
รายการ -
รายการนิพจน์ทั่วไปที่คั่นด้วยเครื่องหมายจุลภาค ซึ่งแต่ละรายการจะขึ้นต้นด้วย - (นิพจน์เชิงลบ) ที่กำหนด (=) ให้กับรายการเป้าหมายค่าจำกัดที่คั่นด้วยคอมมา หากเป้าหมายตรงกับไม่มีนิพจน์เชิงลบและนิพจน์เชิงบวกอย่างน้อย 1 รายการจะดำเนินการแก้ปัญหา Toolchain เสมือนได้ประกาศว่าค่าข้อจำกัดเป็นข้อจำกัดการดำเนินการ ตัวอย่างเช่น //demo,-test=@platforms//cpus:x86_64 จะเพิ่ม "x86_64" ไปยังเป้าหมายใดๆ ภายใต้ //demo ยกเว้นชื่อที่มีคำว่า "test"
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]experimental_enable_objc_cc_deps
: "จริง" -
อนุญาตให้กฎ objc_* ขึ้นอยู่กับ cc_library และทำให้มีการสร้างทรัพยากร Dependency ของ objc ด้วย --cpu ที่ตั้งค่าเป็น "ios_<--ios_cpu>" สำหรับค่าใดก็ได้ใน --ios_multi_cpu
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]experimental_include_xcode_execution_requirements
: "เท็จ" -
หากตั้งค่าไว้ ให้เพิ่มข้อกำหนดการดำเนินการ "requires-xcode:{version}" ลงในการดำเนินการ Xcode ทุกรายการ หากเวอร์ชัน xcode มีป้ายกำกับแบบขีดกลาง ให้เพิ่มข้อกำหนดการดำเนินการ "requires-xcode-label:{version_label}" ด้วย
แท็ก:loses_incremental_state
,loading_and_analysis
,execution
- ค่าเริ่มต้นของ
--[no]experimental_prefer_mutual_xcode
: "จริง" -
หากเป็นจริง ให้ใช้ Xcode ล่าสุดที่พร้อมใช้งานทั้งในเครื่องและจากระยะไกล หากเป็น "เท็จ" หรือหากไม่มีเวอร์ชันที่ใช้ร่วมกัน ให้ใช้เวอร์ชัน Xcode ในเครื่องที่เลือกผ่าน xcode-select
แท็ก:loses_incremental_state
- รวมการใช้งานหลายรายการแล้ว
--extra_execution_platforms=<comma-separated list of options>
รายการ -
แพลตฟอร์มที่ใช้เป็นแพลตฟอร์มการดำเนินการเพื่อเรียกใช้การดำเนินการ คุณระบุแพลตฟอร์มตามเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมายก็ได้ เราจะพิจารณาแพลตฟอร์มเหล่านี้ก่อนแพลตฟอร์มที่ประกาศในไฟล์ WORKSPACE โดย registration_execution_platforms()
แท็ก:execution
- รวมการใช้งานหลายรายการแล้ว
--extra_toolchains=<comma-separated list of options>
รายการ -
กฎเชนเครื่องมือที่จะต้องพิจารณาในระหว่างการแก้ปัญหา Toolchain สามารถระบุ Toolchain ตามเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมายก็ได้ เชนเครื่องมือเหล่านี้จะได้รับการพิจารณาก่อนที่มีการประกาศในไฟล์ WORKSPACE โดย registration_toolchains()
แท็ก ได้แก่affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--grte_top=<a label>
: ดูรายละเอียด -
ป้ายกำกับไปยังไลบรารี 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>
: ดูรายละเอียด -
โดยค่าเริ่มต้น ตัวเลือก --crosstool_top และ --Compositr ยังใช้กับการกำหนดค่าโฮสต์ได้ด้วย หากมีแฟล็กนี้ Bazel จะใช้ libc และคอมไพเลอร์ที่เป็นค่าเริ่มต้นสำหรับ Crosstool_top ที่กำหนด
แท็ก:loading_and_analysis
,changes_inputs
,affects_outputs
- ค่าเริ่มต้น
--host_grte_top=<a label>
: ดูรายละเอียด -
หากระบุ การตั้งค่านี้จะลบล้างไดเรกทอรีระดับบนสุดของ libc (--grte_top) สำหรับการกำหนดค่าโฮสต์
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้นของ
--host_platform=<a build target label>
: "" -
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายระบบโฮสต์
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]incompatible_disable_expand_if_all_available_in_flag_set
: "จริง" -
หากเป็น "จริง" Bazel จะไม่อนุญาตให้ระบุexpand_if_all_available ในFlag_sets(ดูวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/7008)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "จริง" -
หากเป็น "จริง" Bazel จะไม่เปิดใช้ฟีเจอร์ "โฮสต์" และ "ไม่ใช่โฮสต์" ใน Toolchain c++ (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/7407)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_enable_android_toolchain_resolution
: "เท็จ" -
ใช้การแปลงเชนเครื่องมือเพื่อเลือก Android SDK สำหรับกฎของ Android (Starlark และเนทีฟ)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_enable_apple_toolchain_resolution
: "เท็จ" -
ใช้การแปลงเชนเครื่องมือเพื่อเลือก Apple SDK สำหรับกฎของ Apple (Starlark และเนทีฟ)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_make_thinlto_command_lines_standalone
: "จริง" -
หากเป็น "จริง" Bazel จะไม่นำบรรทัดคำสั่งการดำเนินการลิงก์ C++ มาใช้ซ้ำสำหรับบรรทัดคำสั่งการจัดทำดัชนี lto (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/6791)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
: "จริง" -
หากเป็น "จริง" Bazel จะร้องเรียนเมื่อตั้งค่าแอตทริบิวต์ cc_toolchain.cpu และ cc_toolchain.คอมไพเลอร์ (ดูวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/7075)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remove_legacy_whole_archive
: "จริง" -
หากเป็น "จริง" Bazel จะไม่ลิงก์ทรัพยากร Dependency ของไลบรารีเป็นที่เก็บถาวรทั้งหมดโดยค่าเริ่มต้น (ดูวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/7362)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_require_ctx_in_configure_features
: "จริง" -
หากเป็น "จริง" Bazel จะต้องใช้พารามิเตอร์ "ctx" ใน cc_common.สตรีม_features (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/7793)
แท็ก:loading_and_analysis
,incompatible_change
-
ใช้ออบเจ็กต์ที่ใช้ร่วมกันของอินเทอร์เฟซหาก Toolchain รองรับ ปัจจุบันชุดเครื่องมือของ ELF ทั้งหมดรองรับการตั้งค่านี้
แท็ก:loading_and_analysis
,affects_outputs
,affects_outputs
- ค่าเริ่มต้น
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
ระบุเวอร์ชันของ iOS SDK ที่จะใช้สร้างแอปพลิเคชัน iOS หากไม่ระบุ ให้ใช้เวอร์ชัน iOS SDK เริ่มต้นจาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
ระบุเวอร์ชันของ macOS SDK ที่จะใช้สร้างแอปพลิเคชัน macOS หากไม่ระบุ ให้ใช้เวอร์ชัน macOS SDK เริ่มต้นจาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--minimum_os_version=<a string>
: ดูรายละเอียด -
เวอร์ชันระบบปฏิบัติการขั้นต่ำที่การคอมไพล์กำหนดเป้าหมาย
แท็ก:loading_and_analysis
,affects_outputs
- ค่าเริ่มต้นของ
--platform_mappings=<a relative path>
: "" -
ตำแหน่งของไฟล์การแมปซึ่งอธิบายว่าจะใช้แพลตฟอร์มใดหากไม่ได้ตั้งค่าไว้ หรือควรตั้งค่าแฟล็กใดเมื่อแพลตฟอร์มมีอยู่แล้ว ต้องสัมพันธ์กับรูทของพื้นที่ทำงานหลัก ค่าเริ่มต้นจะเป็น "platform_mappings" (ไฟล์ใต้รูทของพื้นที่ทํางานโดยตรง)
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--platforms=<a build target label>
: "" -
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายแพลตฟอร์มเป้าหมายสำหรับคำสั่งปัจจุบัน
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--python2_path=<a string>
: ดูรายละเอียด -
เลิกใช้งาน ปิดใช้ ปิดใช้โดย "--incompatible_use_python_toolchains"
แท็ก:no_op
,deprecated
- ค่าเริ่มต้น
--python3_path=<a string>
: ดูรายละเอียด -
เลิกใช้งาน ปิดใช้ ปิดใช้โดย "--incompatible_use_python_toolchains"
แท็ก:no_op
,deprecated
- ค่าเริ่มต้น
--python_path=<a string>
: ดูรายละเอียด -
มีการเรียกใช้เส้นทางสัมบูรณ์ของล่าม Python เพื่อเรียกใช้เป้าหมาย Python บนแพลตฟอร์มเป้าหมาย เลิกใช้งาน ปิดใช้โดย --incompatible_use_python_toolchains
แท็ก:loading_and_analysis
,affects_outputs
- ค่าเริ่มต้น
--python_top=<a build target label>
: ดูรายละเอียด -
ป้ายกำกับของ py_runtime ที่สื่อถึงอินเทอร์พรีเตอร์ของ Python ถูกเรียกใช้เพื่อเรียกใช้เป้าหมาย Python บนแพลตฟอร์มเป้าหมาย เลิกใช้งาน ปิดใช้โดย --incompatible_use_python_toolchains
แท็ก:loading_and_analysis
,affects_outputs
- ค่าเริ่มต้นของ
--target_platform_fallback=<a build target label>
: "@local_config_platform//:host" -
ป้ายกำกับของกฎแพลตฟอร์มที่ควรใช้หากไม่ได้ตั้งค่าแพลตฟอร์มเป้าหมายและไม่มีการแมปแพลตฟอร์มที่ตรงกับชุดแฟล็กปัจจุบัน
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
ระบุเวอร์ชันของ tvOS SDK ที่จะใช้สร้างแอปพลิเคชัน tvOS หากไม่ระบุ ให้ใช้เวอร์ชัน tvOS SDK เริ่มต้นจาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
ระบุเวอร์ชันของ watchOS SDK ที่จะใช้สร้างแอปพลิเคชัน watchOS หากไม่ระบุ ให้ใช้เวอร์ชัน WatchOS SDK เริ่มต้นจาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--xcode_version=<a string>
: ดูรายละเอียด -
หากระบุไว้ ให้ใช้ Xcode ของเวอร์ชันที่ระบุสำหรับการดำเนินการบิลด์ที่เกี่ยวข้อง หากไม่ระบุ ให้ใช้ Xcode เวอร์ชันเริ่มต้นของไฟล์ปฏิบัติการ
แท็ก:loses_incremental_state
--xcode_version_config=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:host_xcodes"-
ป้ายกำกับของกฎ xcode_config ที่จะใช้สำหรับเลือกเวอร์ชัน Xcode ในการกำหนดค่าบิลด์
แท็ก:loses_incremental_state
,loading_and_analysis
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่ง มีดังนี้
- ค่าเริ่มต้นของ
--[no]apple_enable_auto_dsym_dbg
: "เท็จ" -
กำหนดว่าจะบังคับให้สร้างไฟล์สัญลักษณ์การแก้ไขข้อบกพร่อง (.dSYM) สำหรับบิลด์ dbg หรือไม่
แท็ก:affects_outputs
,action_command_lines
- ค่าเริ่มต้นของ
--[no]apple_generate_dsym
: "เท็จ" -
ต้องการสร้างไฟล์สัญลักษณ์การแก้ไขข้อบกพร่อง (.dSYM) หรือไม่
แท็ก:affects_outputs
,action_command_lines
- ค่าเริ่มต้นของ
--[no]build
: "จริง" -
ดำเนินการบิลด์ ซึ่งเป็นลักษณะการทำงานปกติ การระบุ --nobuild ทำให้บิลด์หยุดก่อนดำเนินการสร้าง ส่งคืนค่า 0 เท่ากับว่าขั้นตอนการโหลดแพ็กเกจและการวิเคราะห์เสร็จสมบูรณ์ โหมดนี้มีประโยชน์สำหรับการทดสอบระยะดังกล่าว
แท็ก:execution
,affects_outputs
- ค่าเริ่มต้นของ
--[no]build_runfile_links
: "จริง" -
หากเป็น "จริง" ให้สร้างฟอเรสต์สัญลักษณ์ซิมลิงก์ของ Runfile สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้เขียนเฉพาะไฟล์ Manifest เมื่อเป็นไปได้
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]build_runfile_manifests
: "จริง" -
หากเป็น "จริง" ให้เขียนไฟล์ Manifest สำหรับไฟล์ Manifest สำหรับเป้าหมายทั้งหมด หากเป็นเท็จ ให้ข้าม ทำการทดสอบในเครื่องไม่ได้เมื่อเป็นเท็จ
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]build_test_dwp
: "เท็จ" -
หากเปิดใช้ เมื่อสร้างการทดสอบ C++ แบบคงที่และในการแยกส่วน ระบบจะสร้างไฟล์ .dwp สำหรับไบนารีทดสอบโดยอัตโนมัติด้วยเช่นกัน
แท็ก:loading_and_analysis
,affects_outputs
- ค่าเริ่มต้นของ
--cc_proto_library_header_suffixes=<comma-separated list of options>
: ".pb.h" -
ตั้งค่าคำนำหน้าของไฟล์ส่วนหัวที่ cc_master_library สร้างขึ้น
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--cc_proto_library_source_suffixes=<comma-separated list of options>
: ".pb.cc" -
ตั้งค่าคำนำหน้าของไฟล์ต้นฉบับที่ cc_promo_library สร้างขึ้น
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]experimental_proto_descriptor_sets_include_source_info
: "เท็จ" -
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันสำรองใน proto_library
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_proto_extra_actions
: "เท็จ" -
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันสำรองใน proto_library
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_run_validations
: "จริง" -
ใช้ --run_Validations แทน
แท็ก:execution
,affects_outputs
- ค่าเริ่มต้นของ
--[no]experimental_save_feature_state
: "เท็จ" -
บันทึกสถานะของฟีเจอร์ที่เปิดใช้และที่ขอเป็นเอาต์พุตของการคอมไพล์
แท็ก:affects_outputs
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_use_validation_aspect
: "เท็จ" -
กำหนดว่าจะเรียกใช้การดำเนินการตรวจสอบโดยใช้มุมมอง (สำหรับการทำงานควบคู่กับการทดสอบ) หรือไม่
แท็ก:execution
,affects_outputs
- ค่าเริ่มต้นของ
--fission=<a set of compilation modes>
: "ไม่" -
ระบุว่าโหมดการรวบรวมใดจะใช้ Fission สำหรับการรวบรวมและลิงก์ C++ อาจเป็นการผสมกันระหว่าง {'fastbuild', 'dbg', 'opt'} หรือค่าพิเศษ "yes" เพื่อเปิดใช้ทุกโหมด และ "no" เพื่อปิดใช้ทุกโหมด
แท็ก:loading_and_analysis
,action_command_lines
,affects_outputs
- ค่าเริ่มต้นของ
--[no]incompatible_always_include_files_in_data
: "จริง" -
หากเป็น "จริง" กฎเนทีฟจะเพิ่ม <code>DefaultInfo.files</code> ของทรัพยากร Dependency ไปยังไฟล์ Runfile ซึ่งตรงกับลักษณะการทํางานที่แนะนำสำหรับกฎ Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid)
แท็ก:affects_outputs
,incompatible_change
- ค่าเริ่มต้นของ
--[no]legacy_external_runfiles
: "จริง" -
หากเป็น "จริง" ให้สร้างฟอเรสต์ลิงก์สัญลักษณ์ของ Runfiles สำหรับที่เก็บภายนอกภายใต้ .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
: "จริง" -
ระบุว่าจะเรียกใช้การดำเนินการตรวจสอบเป็นส่วนหนึ่งของบิลด์หรือไม่ ดู https://bazel.build/rules/rules#Validation_actions
แท็ก:execution
,affects_outputs
- ค่าเริ่มต้นของ
--[no]save_temps
: "เท็จ" -
หากตั้งค่าไว้ ระบบจะบันทึกเอาต์พุตชั่วคราวจาก gcc ซึ่งได้แก่ ไฟล์ .s (โค้ด Assembler), ไฟล์ .i (ไฟล์ C ที่ประมวลผลไว้ล่วงหน้า) และไฟล์ .ii (C++ ที่ประมวลผลไว้ล่วงหน้า)
แท็ก:affects_outputs
- ตัวเลือกที่ให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการซึ่งส่งผลต่อค่า ตรงข้ามกับที่มีอยู่
- รวมการใช้งานหลายรายการแล้ว
--action_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกำหนดค่าเป้าหมาย คุณระบุตัวแปรตามชื่อได้ ซึ่งในกรณีนี้ ค่าจะนำมาจากสภาพแวดล้อมการเรียกใช้ หรือตามคู่ name=value ซึ่งตั้งค่าโดยไม่ขึ้นกับสภาพแวดล้อมการเรียกใช้ ตัวเลือกนี้สามารถใช้ได้หลายครั้ง สำหรับตัวเลือกที่มีให้สำหรับตัวแปรเดียวกัน ตัวเลือกที่ชนะล่าสุด ตัวเลือกสำหรับตัวแปรต่างๆ จะสะสมกัน
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--android_cpu=<a string>
: "armeabi-v7a" -
CPU เป้าหมายของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--[no]android_databinding_use_androidx
: "เท็จ" -
สร้างไฟล์การเชื่อมโยงข้อมูลที่ใช้กับ AndroidX ได้ ใช้กับการเชื่อมโยงข้อมูล v2 เท่านั้น
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้นของ
--[no]android_databinding_use_v3_4_args
: "เท็จ" -
ใช้ android databinding v2 ที่มีอาร์กิวเมนต์ 3.4.0
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้นของ
--android_dynamic_mode=<off, default or fully>
: "ปิด" -
กำหนดว่าจะลิงก์ Deps C++ ของกฎ Android แบบไดนามิกหรือไม่เมื่อ cc_binary ไม่ได้สร้างไลบรารีที่ใช้ร่วมกันอย่างชัดเจน "ค่าเริ่มต้น" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "เต็มรูปแบบ" หมายความว่าไลบรารีทั้งหมดจะลิงก์แบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "ตามลำดับตัวอักษร" -
กำหนดลำดับของไฟล์ Manifest ที่ส่งไปยังการผสานไฟล์ Manifest สำหรับไบนารี Android ALPHABETical หมายถึงไฟล์ Manifest จะจัดเรียงตามเส้นทางที่สัมพันธ์กับไฟล์ปฏิบัติการ ALPHABETical_BY_CONFIGURATION หมายถึงไฟล์ Manifest จะจัดเรียงตามเส้นทางที่สัมพันธ์กับไดเรกทอรีการกำหนดค่าภายในไดเรกทอรีเอาต์พุต DEPENDENCY หมายถึงไฟล์ Manifest ที่มีการจัดลำดับไฟล์ Manifest ของไลบรารีแต่ละแห่งก่อนไฟล์ Manifest ของทรัพยากร Dependency
แท็ก:action_command_lines
,execution
- ค่าเริ่มต้นของ
--[no]android_resource_shrinking
: "เท็จ" -
เปิดใช้การย่อทรัพยากรสำหรับ APK ของ android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
,loading_and_analysis
- รวมการใช้งานหลายรายการแล้ว
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, visionos, watchos, tvos, macos or catalyst>
รายการ -
ระบุโหมดบิตโค้ดของ Apple สำหรับขั้นตอนการคอมไพล์ขั้นตอนที่กำหนดเป้าหมายสถาปัตยกรรมของอุปกรณ์ ค่าอยู่ในรูปแบบ "[platform=]mode" โดยที่แพลตฟอร์ม (ซึ่งต้องเป็น "ios", "macos", "tvos" หรือ "watchos") เป็นตัวเลือกที่ไม่บังคับ หากระบุ ระบบจะใช้โหมดบิตโค้ดสำหรับแพลตฟอร์มนั้นโดยเฉพาะ หากไม่ระบุ โหมดนี้จะใช้กับทุกแพลตฟอร์ม โหมดต้องเป็น "none", "embedded_markers" หรือ "embedded" ตัวเลือกนี้อาจระบุได้หลายครั้ง
แท็ก:loses_incremental_state
- รวมการใช้งานหลายรายการแล้ว
--aspects=<comma-separated list of options>
รายการ - รายการด้านที่คั่นด้วยจุลภาคที่จะใช้กับเป้าหมายระดับบนสุด " นอกจากนี้ some_aspect จะทำงานหลังจากทุกด้านที่จำเป็นที่ระบุโดยแอตทริบิวต์ required จากนั้น some_aspect จะมีสิทธิ์เข้าถึงค่าของผู้ให้บริการของส่วนเหล่านั้น <bzl-file-label>%<aspect_name> เช่น '//tools:my_def.bzl%my_aspect' โดยที่ 'my_aspect' เป็นค่าระดับบนสุดจาก file Tools/my_def.bzl
- ค่าเริ่มต้นของ
--[no]build_python_zip
: "อัตโนมัติ" -
สร้างไฟล์ไฟล์ปฏิบัติการ Python ใน Windows ปิดบนแพลตฟอร์มอื่นๆ
แท็ก:affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--catalyst_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาที่จะสร้างไบนารี Apple Catalyst
แท็ก:loses_incremental_state
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]collect_code_coverage
: "เท็จ" -
หากระบุไว้ Bazel จะใช้โค้ดวัดคุม (โดยใช้การวัดคุมแบบออฟไลน์หากเป็นไปได้) และจะรวบรวมข้อมูลการครอบคลุมระหว่างการทดสอบ เฉพาะเป้าหมายที่ตรงกับ --instrumentation_filter เท่านั้นที่จะได้รับผลกระทบ โดยปกติไม่ควรระบุตัวเลือกนี้โดยตรง ควรใช้คำสั่ง 'bazelดีไซน์' แทน
แท็ก:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] ค่าเริ่มต้น: " Fastbuild"-
ระบุโหมดที่จะสร้างไบนารีในตัว ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
,action_command_lines
,explicit_in_output_path
- รวมการใช้งานหลายรายการแล้ว
--conlyopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--copt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้นของ
--cpu=<a string>
: "" -
CPU เป้าหมาย
แท็ก:changes_inputs
,affects_outputs
,explicit_in_output_path
- ค่าเริ่มต้น
--cs_fdo_absolute_path=<a string>
: ดูรายละเอียด -
ใช้ข้อมูลโปรไฟล์ CSFDO เพื่อเพิ่มประสิทธิภาพการรวบรวม ระบุชื่อเส้นทางสัมบูรณ์ของไฟล์ ZIP ที่มีไฟล์โปรไฟล์ ไฟล์ข้อมูล RAW หรือไฟล์โปรไฟล์ LLVM ที่จัดทำดัชนีแล้ว
แท็ก:affects_outputs
- ค่าเริ่มต้น
--cs_fdo_instrument=<a string>
: ดูรายละเอียด -
สร้างไบนารีด้วยเครื่องมือ FDO ที่คำนึงถึงบริบท เมื่อใช้คอมไพเลอร์ Clang/LLVM คอมไพเลอร์จะยอมรับชื่อไดเรกทอรีที่จะใช้ถ่ายโอนไฟล์โปรไฟล์ดิบขณะรันไทม์ด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--cs_fdo_profile=<a build target label>
: ดูรายละเอียด -
cs_fdo_profile ที่แสดงถึงโปรไฟล์ที่คำนึงถึงบริบทเพื่อใช้สำหรับการเพิ่มประสิทธิภาพ
แท็ก:affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--cxxopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C++
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--define=<a 'name=value' assignment>
รายการ -
ตัวเลือก --define แต่ละตัวเลือกจะระบุการมอบหมายสำหรับตัวแปรบิลด์
แท็ก:changes_inputs
,affects_outputs
- ค่าเริ่มต้นของ
--dynamic_mode=<off, default or fully>
: "ค่าเริ่มต้น" -
กำหนดว่าจะลิงก์ไบนารี C++ แบบไดนามิกหรือไม่ "ค่าเริ่มต้น" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "เต็มรูปแบบ" หมายความว่าไลบรารีทั้งหมดจะลิงก์แบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก:loading_and_analysis
,affects_outputs
- ค่าเริ่มต้นของ
--[no]enable_fdo_profile_absolute_path
: "จริง" -
หากตั้งค่าไว้ การใช้ fdo_absolute_profile_path จะทำให้เกิดข้อผิดพลาด
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]enable_runfiles
: "อัตโนมัติ" -
เปิดใช้โครงสร้าง Symlink ของ Runfiles ซึ่งระบบจะปิดใช้ใน Windows ในแพลตฟอร์มอื่นๆ โดยค่าเริ่มต้น
แท็ก:affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--experimental_action_listener=<a build target label>
รายการ -
เลิกใช้งานเพื่อสนับสนุนแง่มุมต่างๆ ใช้ action_listener เพื่อแนบ external_action เข้ากับการดำเนินการของบิลด์ที่มีอยู่
แท็ก:execution
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_android_compress_java_resources
: "เท็จ" -
บีบอัดทรัพยากร Java ใน APK
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_android_databinding_v2
: "เท็จ" -
ใช้ Android Databinding v2
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_android_resource_shrinking
: "เท็จ" -
เปิดใช้การย่อทรัพยากรสำหรับ APK ของ android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]experimental_android_rewrite_dexes_with_rex
: "เท็จ" -
ใช้เครื่องมือ Rex เพื่อเขียนไฟล์ dex ใหม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_collect_code_coverage_for_generated_files
: "เท็จ" -
หากระบุไว้ Bazel จะสร้างการรวบรวมข้อมูลการครอบคลุมสำหรับไฟล์ที่สร้างขึ้นด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]experimental_convenience_symlinks
: "ปกติ" -
แฟล็กนี้ควบคุมวิธีจัดการลิงก์สัญลักษณ์อำนวยความสะดวก (ลิงก์สัญลักษณ์ที่ปรากฏในพื้นที่ทำงานหลังบิลด์) ค่าที่เป็นไปได้มีดังนี้
ปกติ (ค่าเริ่มต้น): ระบบจะสร้างหรือลบลิงก์สัญลักษณ์อำนวยความสะดวกแต่ละประเภทตามที่บิลด์กำหนด
สะอาด: ระบบจะลบลิงก์สัญลักษณ์ทั้งหมดโดยไม่มีเงื่อนไข
เพิกเฉย: ลิงก์ Symlink จะเป็นเพียงลิงก์เดียว
log_only: สร้างข้อความบันทึกเสมือนว่าผ่าน 'ปกติ' แต่ไม่ได้ดำเนินการเกี่ยวกับระบบไฟล์จริง (มีประโยชน์สำหรับเครื่องมือ)
โปรดทราบว่าเฉพาะลิงก์สัญลักษณ์ที่สร้างขึ้นด้วยค่าปัจจุบันของ --symlink_prefix เท่านั้นที่จะได้รับผลกระทบ หากคำนำหน้าเปลี่ยนไป symlink ที่มีอยู่ก่อนแล้วจะปล่อยไว้ตามเดิม
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]experimental_convenience_symlinks_bep_event
: "เท็จ" -
แฟล็กนี้ควบคุมว่าเราจะโพสต์ eventConvenienceSymlinksIdentified ใน BuildEventProtocol หรือไม่ หากค่าเป็น "true" BuildEventProtocol จะมีรายการ ConvesionSymlinksIdentified ซึ่งแสดงรายการสัญลักษณ์ความสะดวกสบายทั้งหมดที่สร้างขึ้นในพื้นที่ทำงานของคุณ หากเป็น "เท็จ" รายการ ConvensymlinksIdentified ใน BuildEventProtocol จะว่างเปล่า
แท็ก:affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--experimental_multi_cpu=<comma-separated list of options>
รายการ -
เลิกใช้งานแล้ว ไม่ดำเนินการ
แท็ก:affects_outputs
,experimental
- ค่าเริ่มต้นของ
--experimental_objc_fastbuild_options=<comma-separated list of options>
: "-O0,-DDEBUG=1" -
ใช้สตริงเหล่านี้เป็นตัวเลือกคอมไพเลอร์ Fastbuild ของ objc
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--[no]experimental_omitfp
: "เท็จ" -
หากเป็น "จริง" ให้ใช้ libunwind เพื่อคลายการคลายสแต็ก และคอมไพล์ด้วย -fomit-frame-pointer และ -fแบบอะซิงโครนัส-unwind-tables
แท็ก:action_command_lines
,affects_outputs
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_platform_in_output_dir
: "เท็จ" -
หากเป็น "จริง" ระบบจะใช้แพลตฟอร์มเป้าหมายในชื่อไดเรกทอรีเอาต์พุตแทน CPU
แท็ก:affects_outputs
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_use_llvm_covmap
: "เท็จ" -
หากระบุ Bazel จะสร้างข้อมูลแผนที่การครอบคลุม llvm-cov แทน gcov เมื่อเปิดใช้collect_code_coverage
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--fat_apk_cpu=<comma-separated list of options>
: "armeabi-v7a" -
การตั้งค่าตัวเลือกนี้จะเปิดใช้ APK แบบไขมัน ซึ่งมีไบนารีเนทีฟสำหรับสถาปัตยกรรมเป้าหมายที่ระบุทั้งหมด เช่น --fat_apk_cpu=x86,armeabi-v7a. หากมีการระบุแฟล็กนี้ --android_cpu จะถูกละเว้นสำหรับทรัพยากร Dependency ของกฎ android_binary
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--[no]fat_apk_hwasan
: "เท็จ" -
กำหนดว่าจะสร้างการแยก HWASAN หรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--fdo_instrument=<a string>
: ดูรายละเอียด -
สร้างไบนารีด้วยการวัดคุม FDO เมื่อใช้คอมไพเลอร์ Clang/LLVM คอมไพเลอร์จะยอมรับชื่อไดเรกทอรีที่จะใช้ถ่ายโอนไฟล์โปรไฟล์ดิบขณะรันไทม์ด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_optimize=<a string>
: ดูรายละเอียด -
ใช้ข้อมูลโปรไฟล์ FDO เพื่อเพิ่มประสิทธิภาพการรวบรวม ระบุชื่อไฟล์ ZIP ที่มีโครงสร้างไฟล์ .gcda, ไฟล์ afdo ที่มีโปรไฟล์อัตโนมัติ หรือไฟล์โปรไฟล์ LLVM แฟล็กนี้ยังยอมรับไฟล์ที่ระบุเป็นป้ายกำกับด้วย (เช่น `//foo/bar:file.afdo` คุณอาจต้องเพิ่มคำสั่ง "exports_files" ไปยังแพ็กเกจที่เกี่ยวข้อง) และป้ายกำกับที่ชี้ไปยังเป้าหมาย `fdo_profile` ธงนี้จะถูกแทนที่โดยกฎ "fdo_profile"
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_prefetch_hints=<a build target label>
: ดูรายละเอียด -
ใช้คำแนะนำในการดึงข้อมูลแคชล่วงหน้า
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_profile=<a build target label>
: ดูรายละเอียด -
fdo_profile ที่แสดงถึงโปรไฟล์ที่จะใช้ในการเพิ่มประสิทธิภาพ
แท็ก:affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--features=<a string>
รายการ -
ระบบจะเปิดหรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างในการกำหนดค่าเป้าหมาย การระบุ -<feature> จะเป็นการปิดใช้ฟีเจอร์นี้ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ ดู --host_features
แท็ก:changes_inputs
,affects_outputs
- ค่าเริ่มต้นของ
--[no]force_pic
: "เท็จ" -
หากเปิดใช้ การคอมไพล์ C++ ทั้งหมดจะสร้างโค้ดที่ไม่ขึ้นอยู่กับตำแหน่ง ("-fPIC") ลิงก์จะเลือกไลบรารีที่สร้างไว้ล่วงหน้าของ PIC มากกว่าไลบรารีที่ไม่ใช่ PIC และลิงก์จะสร้างไฟล์ปฏิบัติการที่ไม่ขึ้นกับตำแหน่ง ("-pie")
แท็ก:loading_and_analysis
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--host_action_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุชุดตัวแปรสภาพแวดล้อมที่พร้อมใช้งานสำหรับการดำเนินการที่มีการกำหนดค่าโฮสต์หรือการดำเนินการ คุณระบุตัวแปรตามชื่อได้ ซึ่งในกรณีนี้ ค่าจะนำมาจากสภาพแวดล้อมการเรียกใช้ หรือตามคู่ name=value ซึ่งตั้งค่าโดยไม่ขึ้นกับสภาพแวดล้อมการเรียกใช้ ตัวเลือกนี้สามารถใช้ได้หลายครั้ง สำหรับตัวเลือกที่มีให้สำหรับตัวแปรเดียวกัน ตัวเลือกที่ชนะล่าสุด ตัวเลือกสำหรับตัวแปรต่างๆ จะสะสมกัน
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--host_compilation_mode=<fastbuild, dbg or opt>
: "เลือกใช้" -
ระบุโหมดที่จะใช้ในการสร้างเครื่องมือในระหว่างบิลด์ ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
,action_command_lines
- รวมการใช้งานหลายรายการแล้ว
--host_conlyopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C สำหรับเครื่องมือของโฮสต์
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--host_copt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc สำหรับเครื่องมือของโฮสต์
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้นของ
--host_cpu=<a string>
: "" -
CPU ของโฮสต์
แท็ก:changes_inputs
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--host_cxxopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc สำหรับเครื่องมือของโฮสต์
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--host_features=<a string>
รายการ -
ฟีเจอร์ที่ระบุจะเปิดหรือปิดใช้งานโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างขึ้นในการกำหนดค่า exec การระบุ -<feature> จะเป็นการปิดใช้ฟีเจอร์นี้ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ
แท็ก:changes_inputs
,affects_outputs
- ค่าเริ่มต้น
--host_force_python=<PY2 or PY3>
: ดูรายละเอียด -
ลบล้างเวอร์ชัน Python สำหรับการกำหนดค่าโฮสต์ อาจเป็น "PY2" หรือ "PY3"
แท็ก:loading_and_analysis
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--host_linkopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc เมื่อลิงก์เครื่องมือโฮสต์
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้น
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
เวอร์ชัน macOS ขั้นต่ำที่เข้ากันได้สำหรับเป้าหมายโฮสต์ หากไม่ระบุ ให้ใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
- รวมการใช้งานหลายรายการแล้ว
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับเลือกส่งไปยังคอมไพเลอร์ C/C++ เมื่อคอมไพล์บางไฟล์ในการกำหนดค่าโฮสต์หรือโฮสต์ ตัวเลือกนี้สามารถส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจากรายการรูปแบบ "รวม" และ "ยกเว้นนิพจน์ทั่วไป" (ดู --instrumentation_filter ด้วย) Option_1 ถึง Option_n แทนตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบ็กสแลชเข้าไป ตัวเลือกจะมี @ ได้ แต่จะใช้ @ แรกเท่านั้นเพื่อแยกสตริง ตัวอย่างเช่น --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--host_swiftcopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งผ่านไปยัง swiftc สำหรับเครื่องมือของโฮสต์
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้นของ
--[no]incompatible_avoid_conflict_dlls
: "จริง" -
หากเปิดใช้ ไลบรารีที่ลิงก์แบบไดนามิกของ C++ (DLL) ทั้งหมดที่ cc_library ใน Windows จะสร้างขึ้นจะเปลี่ยนชื่อเป็น name_{hash}.dll พร้อมกับคำนวณแฮชโดยอิงตาม RepositoryName และเส้นทางแพ็กเกจของ DLL ตัวเลือกนี้จะมีประโยชน์เมื่อคุณมีแพ็กเกจเดียว ซึ่งขึ้นอยู่กับ cc_library หลายรายการที่มีชื่อเดียวกัน (เช่น //foo/bar1:utils และ //foo/bar2:utils)
แท็ก:loading_and_analysis
,affects_outputs
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_merge_genfiles_directory
: "จริง" -
หากเป็น "จริง" ระบบจะพับไดเรกทอรี genfiles ไว้ในไดเรกทอรี Bin
แท็ก:affects_outputs
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_use_host_features
: "เท็จ" -
หากเป็น "จริง" ให้ใช้ --features เฉพาะสำหรับการกำหนดค่าเป้าหมายและ --host_features สำหรับการกำหนดค่าการดำเนินการ
แท็ก:changes_inputs
,affects_outputs
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_use_platforms_repo_for_constraints
: "จริง" -
หากเป็น "จริง" ระบบจะนำการตั้งค่าข้อจำกัดจาก @bazel_tools ออก
แท็ก:affects_outputs
,incompatible_change
- ค่าเริ่มต้นของ
--[no]instrument_test_targets
: "เท็จ" -
เมื่อเปิดใช้การครอบคลุม ให้ระบุว่าจะพิจารณาการใช้กฎการทดสอบหรือไม่ เมื่อตั้งค่าแล้ว กฎการทดสอบที่ --instrumentation_filter รวมไว้จะถูกวัดคุม มิฉะนั้น กฎทดสอบจะถูกยกเว้นจากการวัดคุมการครอบคลุมเสมอ
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-/javatests[/:],-/test/java[/:]" -
เมื่อเปิดใช้การครอบคลุม จะมีการใช้เฉพาะกฎที่มีชื่อซึ่งตัวกรองที่อิงตามนิพจน์ทั่วไปที่ระบุเท่านั้น กฎที่ขึ้นต้นด้วย '-' จะถูกยกเว้นแทน โปรดทราบว่าจะมีการวัดเฉพาะกฎที่ไม่ใช่การทดสอบเท่านั้น เว้นแต่จะเปิดใช้ --instrument_test_targets
แท็ก:affects_outputs
- ค่าเริ่มต้น
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
เวอร์ชัน iOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองและอุปกรณ์เป้าหมาย หากไม่ระบุ ให้ใช้ "ios_sdk_version"
แท็ก:loses_incremental_state
- รวมการใช้งานหลายรายการแล้ว
--ios_multi_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้าง ios_application ผลลัพธ์คือไบนารีสากลที่มีสถาปัตยกรรมที่ระบุทั้งหมด
แท็ก:loses_incremental_state
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]legacy_whole_archive
: "จริง" -
เลิกใช้งาน ซึ่งถูกแทนที่โดย --incompatible_remove_legacy_whole_archive (ดูรายละเอียดที่ https://github.com/bazelbuild/bazel/issues/7362) เมื่อเปิด ให้ใช้ --whole-archive สำหรับกฎ cc_binary ที่มี linkshared=True และ linkstatic=True หรือ "-static" ใน linkopts มีไว้สำหรับความเข้ากันได้แบบย้อนหลังเท่านั้น ทางเลือกที่ดีกว่าคือการใช้ Alwayslink=1 เมื่อจำเป็น
แท็ก:action_command_lines
,affects_outputs
,deprecated
- รวมการใช้งานหลายรายการแล้ว
--linkopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc เมื่อลิงก์
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--ltobackendopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังขั้นตอนแบ็กเอนด์ของ LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--ltoindexopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังขั้นตอนการจัดทำดัชนี LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--macos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple macOS
แท็ก:loses_incremental_state
,loading_and_analysis
- ค่าเริ่มต้น
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
เวอร์ชัน macOS ขั้นต่ำที่เข้ากันได้สำหรับเป้าหมาย หากไม่ระบุ ให้ใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้นของ
--[no]objc_debug_with_GLIBCXX
: "เท็จ" -
หากตั้งค่าและตั้งค่าโหมดการรวบรวมเป็น "dbg" ให้กำหนด GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC และ GLIBCPP_CONCEPT_CheckS
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--[no]objc_enable_binary_stripping
: "เท็จ" -
กำหนดว่าจะดำเนินการตัดสัญลักษณ์และถอดรหัสแบบเดดโค้ดในไบนารีที่ลิงก์หรือไม่ จะมีการดำเนินการตัดไบนารีหากมีการระบุทั้ง Flag และ --compilation_mode=opt นี้
แท็ก:action_command_lines
- รวมการใช้งานหลายรายการแล้ว
--objccopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ Objective-C/C++
แท็ก:action_command_lines
- รวมการใช้งานหลายรายการแล้ว
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมในการเลือกส่งผ่านไปยัง gcc เมื่อคอมไพล์บางไฟล์ ตัวเลือกนี้สามารถส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจากรายการรูปแบบ "รวม" และ "ยกเว้นนิพจน์ทั่วไป" (ดู --instrumentation_filter ด้วย) Option_1 ถึง Option_n แทนตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบ็กสแลชเข้าไป ตัวเลือกจะมี @ ได้ แต่จะใช้ @ แรกเท่านั้นเพื่อแยกสตริง ตัวอย่างเช่น --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อเลือกส่งผ่านไปยังแบ็กเอนด์ LTO (ในส่วน --features=thin_lto) เมื่อคอมไพล์ออบเจ็กต์แบ็กเอนด์บางรายการ ตัวเลือกนี้สามารถส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n ที่ regex_filter คือรายการรูปแบบการรวมและยกเว้นนิพจน์ทั่วไป Option_1 ถึง Option_n แทนตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบ็กสแลชเข้าไป ตัวเลือกจะมี @ ได้ แต่จะใช้ @ แรกเท่านั้นเพื่อแยกสตริง ตัวอย่างเช่น --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ลงในบรรทัดคำสั่งแบ็กเอนด์ LTO ของไฟล์ o ทั้งหมดใน //foo/ ยกเว้น bar.o
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้น
--platform_suffix=<a string>
: ดูรายละเอียด -
ระบุส่วนต่อท้ายที่จะเพิ่มในไดเรกทอรีการกำหนดค่า
แท็ก:loses_incremental_state
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--propeller_optimize=<a build target label>
: ดูรายละเอียด -
ใช้ข้อมูลโปรไฟล์ Propeller เพื่อเพิ่มประสิทธิภาพเป้าหมายของบิลด์ โปรไฟล์ใบพัดต้องมีอย่างน้อย 1 จาก 2 ไฟล์ โปรไฟล์ 1 ใน 2 ไฟล์ และโปรไฟล์ ld แฟล็กนี้ยอมรับป้ายกำกับบิลด์ซึ่งต้องอ้างอิงถึงไฟล์อินพุตโปรไฟล์ใบพัด ตัวอย่างเช่น ไฟล์ BUILD ที่กำหนดป้ายกำกับใน a/b/BUILD:profeller_ optimize( name = "profeller_profile", cc_profile = "profeller_cc_profile.txt", ld_profile = "profeller_ld_profile.txt",)เพิ่มคำสั่ง export_files ลงในแพ็กเกจที่เกี่ยวข้องเพื่อให้ Bazel ดูไฟล์เหล่านี้ได้ ต้องใช้ตัวเลือกเป็น --profeller_Optimize=//a/b:profeller_profile
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้น
--propeller_optimize_absolute_cc_profile=<a string>
: ดูรายละเอียด -
ชื่อเส้นทางสัมบูรณ์ของไฟล์ cc_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพของ Propeller
แท็ก:affects_outputs
- ค่าเริ่มต้น
--propeller_optimize_absolute_ld_profile=<a string>
: ดูรายละเอียด -
ชื่อเส้นทางสัมบูรณ์ของไฟล์ ld_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพ Propeller
แท็ก:affects_outputs
- ค่าเริ่มต้น
--run_under=<a prefix in front of command>
: ดูรายละเอียด -
คำนำหน้าที่จะแทรกหน้าไฟล์ปฏิบัติการสำหรับคำสั่ง "test" และ "run" หากค่าเป็น "foo -bar" และบรรทัดคำสั่งการดำเนินการคือ "test_binary -baz" บรรทัดคำสั่งสุดท้ายจะเป็น "foo -bar test_binary -baz" บรรทัดนี้อาจเป็นป้ายกำกับของเป้าหมายปฏิบัติการด้วย ตัวอย่างเช่น: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'
แท็ก:action_command_lines
-
หากเป็นจริง ระบบจะแชร์ไลบรารีแบบเนทีฟที่มีฟังก์ชันการทำงานเหมือนกันกับเป้าหมายต่างๆ
แท็กต่อไปนี้loading_and_analysis
,affects_outputs
- ค่าเริ่มต้นของ
--[no]stamp
: "เท็จ" -
ประทับไบนารีด้วยวันที่ ชื่อผู้ใช้ ชื่อโฮสต์ ข้อมูลพื้นที่ทำงาน ฯลฯ
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--strip=<always, sometimes or never>
: "บางครั้ง" -
ระบุว่าจะตัดไบนารีและไลบรารีที่แชร์หรือไม่ (โดยใช้ "-Wl,--strip-debug") ค่าเริ่มต้นเป็น "sometimes" หมายถึง Strip iff --compilation_mode=fastbuild
แท็ก:affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--stripopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง Strip เมื่อสร้างไบนารี "<name>.strped"
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--swiftcopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังการคอมไพล์ Swift
แท็ก:action_command_lines
- ค่าเริ่มต้น
--symlink_prefix=<a string>
: ดูรายละเอียด -
คำนำหน้าที่ใส่ข้างหน้าลิงก์สัญลักษณ์อำนวยความสะดวกที่สร้างขึ้นหลังบิลด์ หากไม่ระบุ ค่าเริ่มต้นจะเป็นชื่อของเครื่องมือสร้างตามด้วยขีดกลาง หากผ่านเครื่องหมาย "/" จะไม่มีการสร้างลิงก์สัญลักษณ์และไม่มีการส่งคำเตือน คำเตือน: ฟังก์ชันพิเศษสำหรับ "/" จะเลิกใช้งานในเร็วๆ นี้ โปรดใช้ --experimental_convenience_symlinks=ignore แทน
แท็ก:affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--tvos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับการสร้างไบนารี Apple tvOS
แท็ก:loses_incremental_state
,loading_and_analysis
- ค่าเริ่มต้น
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
เวอร์ชัน tvOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองและอุปกรณ์เป้าหมาย หากไม่ระบุ ให้ใช้ "tvos_sdk_version"
แท็ก:loses_incremental_state
- รวมการใช้งานหลายรายการแล้ว
--visionos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับการสร้างไบนารี Apple visionOS
แท็ก:loses_incremental_state
,loading_and_analysis
- รวมการใช้งานหลายรายการแล้ว
--watchos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับการสร้างไบนารี Apple WatchOS
แท็ก:loses_incremental_state
,loading_and_analysis
- ค่าเริ่มต้น
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
เวอร์ชัน WatchOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองและอุปกรณ์เป้าหมาย หากไม่ระบุ ให้ใช้ "watchos_sdk_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--xbinary_fdo=<a build target label>
: ดูรายละเอียด -
ใช้ข้อมูลโปรไฟล์ XbinaryFDO เพื่อเพิ่มประสิทธิภาพการรวบรวม ระบุชื่อของโปรไฟล์ไบนารีแบบข้ามที่เป็นค่าเริ่มต้น เมื่อใช้ตัวเลือกนี้ร่วมกับ --fdo_instrument/--fdo_optimize/--fdo_profile ตัวเลือกเหล่านั้นจะมีผลเหนือกว่าเสมอเสมือนว่าไม่ได้ระบุ xbinary_fdo
แท็ก:affects_outputs
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมของแฟล็ก ฯลฯ)
- ค่าเริ่มต้นของ
--auto_cpu_environment_group=<a build target label>
: "" -
ประกาศEnvironment_group ที่จะใช้ในการแมปค่า CPU กับค่า target_environment โดยอัตโนมัติ
แท็ก:changes_inputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]check_licenses
: "เท็จ" -
ตรวจสอบว่าข้อจำกัดการอนุญาตให้ใช้สิทธิที่กำหนดโดยแพ็กเกจที่เกี่ยวข้องไม่ขัดแย้งกับโหมดการเผยแพร่ของเป้าหมายที่สร้างขึ้น โดยค่าเริ่มต้น ระบบจะไม่เลือกใบอนุญาต
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--[no]check_visibility
: "จริง" -
หากปิดใช้ ข้อผิดพลาดในการแสดงผลในทรัพยากร Dependency เป้าหมายจะถูกลดระดับเป็นคำเตือน
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--[no]desugar_for_android
: "จริง" -
ไม่ว่าจะถอดรหัสไบต์โค้ด 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
: "จริง" -
ตรวจสอบสภาพแวดล้อมที่แต่ละเป้าหมายใช้งานร่วมกันได้ และรายงานข้อผิดพลาดหากเป้าหมายใดมีทรัพยากร Dependency ที่ไม่รองรับสภาพแวดล้อมเดียวกัน
แท็กมีดังนี้build_file_semantics
- ค่าเริ่มต้นของ
--[no]experimental_allow_android_library_deps_without_srcs
: "เท็จ" -
แจ้งเพื่อช่วยเปลี่ยนจากการอนุญาตเป็นไม่อนุญาตกฎ android_library แบบไม่มี srcs-less ที่มี deps ต้องล้างข้อมูล Depot เพื่อเปิดตัวการเปลี่ยนแปลงนี้โดยค่าเริ่มต้น
แท็ก:eagerness_to_exit
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]experimental_check_desugar_deps
: "จริง" -
ต้องการตรวจสอบการกำจัดน้ำตาลอย่างถูกต้องอีกครั้งที่ระดับไบนารีของ Android
แท็ก:eagerness_to_exit
,loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--experimental_import_deps_checking=<off, warning or error>
: "ปิด" -
เมื่อเปิดใช้ ให้ตรวจสอบว่าทรัพยากร Dependency ของ aar_import สมบูรณ์หรือไม่ การบังคับใช้นี้อาจทำให้บิลด์เสียหายหรืออาจส่งผลให้มีคำเตือนได้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "ค่าเริ่มต้น" -
หากเป็น "จริง" ให้ตรวจสอบว่าเป้าหมาย Java ประกาศเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency อย่างชัดเจน
แท็ก:build_file_semantics
,eagerness_to_exit
- ค่าเริ่มต้นของ
--[no]incompatible_check_testonly_for_output_files
: "เท็จ" -
หากเปิดใช้ไว้ ให้ตรวจสอบ testonly สำหรับเป้าหมายเบื้องต้นที่เป็นไฟล์เอาต์พุตโดยค้นหาเฉพาะ testonly ของกฎที่สร้างขึ้น ข้อมูลนี้ตรงกับการตรวจสอบการแสดงผล
แท็ก:build_file_semantics
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_disable_native_android_rules
: "เท็จ" -
หากเปิดใช้ ระบบจะปิดใช้การใช้งานกฎ Android แบบดั้งเดิมโดยตรง โปรดใช้กฎของ Starlark Android จาก https://github.com/bazelbuild/rules_android
แท็ก:eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_disable_native_apple_binary_rule
: "เท็จ" -
ไม่มีการดำเนินการ โปรดเก็บไว้ที่นี่เพื่อดูความเข้ากันได้แบบย้อนหลัง
แท็ก:eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_force_strict_header_check_from_starlark
: "จริง" -
หากเปิดใช้ ให้ตั้งค่าการตรวจสอบส่วนหัวที่เข้มงวดใน Starlark API
แท็กดังนี้loading_and_analysis
,changes_inputs
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_validate_top_level_header_inclusions
: "จริง" -
หากเป็น "จริง" Bazel จะตรวจสอบการรวมส่วนหัวของไดเรกทอรีระดับบนสุดด้วย (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/10047)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]strict_filesets
: "เท็จ" -
หากเปิดใช้ตัวเลือกนี้ ระบบจะรายงานชุดไฟล์ที่ข้ามขอบเขตของแพ็กเกจว่าเป็นข้อผิดพลาด ซึ่งจะใช้งานไม่ได้เมื่อปิดใช้ check_fileset_dependencies_recursively
แท็ก:build_file_semantics
,eagerness_to_exit
- ค่าเริ่มต้นของ
--strict_proto_deps=<off, warn, error, strict or default>
: "ข้อผิดพลาด" -
หากไม่ปิด ให้ตรวจสอบว่าเป้าหมาย protocol_library ประกาศเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency อย่างชัดเจน
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้นของ
--strict_public_imports=<off, warn, error, strict or default>
: "ปิด" -
หากไม่ "ปิด" ให้ตรวจสอบว่าเป้าหมาย proto_library ประกาศเป้าหมายทั้งหมดที่ใช้ใน "นําเข้าแบบสาธารณะ" อย่างชัดเจนเป็น "ส่งออก"
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้นของ
--[no]strict_system_includes
: "เท็จ" -
หากเป็น "จริง" จะต้องประกาศส่วนหัวที่พบในเส้นทาง (-isystem) ด้วย
แท็ก:loading_and_analysis
,eagerness_to_exit
- รวมการใช้งานหลายรายการแล้ว
--target_environment=<a build target label>
รายการ -
ประกาศสภาพแวดล้อมเป้าหมายของบิลด์นี้ ต้องเป็นการอ้างอิงป้ายกำกับไปยังกฎ "สภาพแวดล้อม" หากระบุไว้ เป้าหมายระดับบนสุดทั้งหมดต้องเข้ากันได้กับสภาพแวดล้อมนี้
แท็ก:changes_inputs
- ตัวเลือกที่ส่งผลต่อเอาต์พุตการลงชื่อเข้าใช้ของบิลด์
- ค่าเริ่มต้นของ
--apk_signing_method=<v1, v2, v1_v2 or v4>
: "v1_v2" -
การใช้งานเพื่อรับรอง APK
แท็กมีดังนี้action_command_lines
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]device_debug_entitlements
: "จริง" -
หากตั้งค่าและโหมดการรวบรวมไม่ใช่ "เลือกใช้" แอป objc จะมีการให้สิทธิ์การแก้ไขข้อบกพร่องเมื่อลงชื่อเข้าใช้
แท็ก:changes_inputs
- ค่าเริ่มต้น
--ios_signing_cert_name=<a string>
: ดูรายละเอียด -
ชื่อใบรับรองที่จะใช้สำหรับการลงนาม iOS หากไม่ได้ตั้งค่า ระบบจะกลับไปใช้โปรไฟล์การจัดสรร อาจเป็นค่ากำหนดข้อมูลประจำตัว Keychain ของใบรับรองหรือ (สตริงย่อย) ของชื่อจริงของใบรับรอง ตามหน้า man ของ Codesign (SIGNING IDENTITIES)
แท็ก:action_command_lines
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้โดยไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE
- ค่าเริ่มต้นของ
--[no]incompatible_config_setting_private_default_visibility
: "เท็จ" -
หากแฟล็กนี้เป็นเท็จ config_setting ที่ไม่มีแอตทริบิวต์การเปิดเผยอย่างชัดเจนจะเป็น //visibility:public หากแฟล็กนี้เป็นจริง config_setting จะใช้ตรรกะการแสดงผลเดียวกันกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_disallow_legacy_py_provider
: "จริง" -
ไม่มีการดำเนินการ และจะถูกนำออกในเร็วๆ นี้
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_enforce_config_setting_visibility
: "จริง" -
หากเป็น "จริง" ให้บังคับใช้ข้อจํากัดระดับการเข้าถึง config_setting หากเป็น "เท็จ" ทุก config_setting จะปรากฏกับทุกเป้าหมาย ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่ควบคุมลักษณะการทำงานของสภาพแวดล้อมการทดสอบหรือตัวดำเนินการทดสอบมีดังนี้
- ค่าเริ่มต้นของ
--[no]allow_analysis_failures
: "เท็จ" -
หากเป็นจริง การวิเคราะห์เป้าหมายกฎไม่สำเร็จจะส่งผลให้มีการเผยแพร่อินสแตนซ์ของ AnalysisFailureInfo ที่มีคำอธิบายข้อผิดพลาด แทนที่จะทำให้บิลด์ล้มเหลว
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--analysis_testing_deps_limit=<an integer>
: "2000" -
กำหนดจำนวนสูงสุดของทรัพยากร Dependency แบบเปลี่ยนผ่านผ่านแอตทริบิวต์กฎที่มีการเปลี่ยนการกำหนดค่า for_analysis_testing การเกินขีดจำกัดนี้จะทำให้เกิดข้อผิดพลาดเกี่ยวกับกฎ
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]break_build_on_parallel_dex2oat_failure
: "เท็จ" -
หากการดำเนินการ Dex2oat ไม่สำเร็จจะทำให้บิลด์ขัดข้องแทนการเรียกใช้ Dex2oat ระหว่างรันไทม์ของการทดสอบ
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]check_tests_up_to_date
: "เท็จ" -
อย่าทำการทดสอบ เพียงแค่ตรวจสอบว่าข้อมูลเหล่านั้นเป็นปัจจุบันหรือไม่ หากผลการทดสอบทั้งหมดเป็นปัจจุบัน แสดงว่าการทดสอบเสร็จสมบูรณ์แล้ว หากจำเป็นต้องสร้างหรือดำเนินการทดสอบ ระบบจะรายงานข้อผิดพลาดและการทดสอบจะไม่สำเร็จ ตัวเลือกนี้หมายถึงลักษณะการทำงานของ --check_up_to_date
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]experimental_android_use_parallel_dex2oat
: "เท็จ" -
ใช้ dex2oat ควบคู่กันเพื่อเพิ่มความเร็ว android_test
แท็ก:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- รวมการใช้งานหลายรายการแล้ว
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
รายการ -
ในกรณีที่การทดสอบล้มเหลว ระบบจะลองทดสอบแต่ละรายการซ้ำให้ครบตามจำนวนครั้งที่กำหนด ระบบจะทำเครื่องหมายการทดสอบที่ต้องผ่านมากกว่า 1 ครั้งเป็น "FLAKY" ในสรุปการทดสอบ โดยปกติแล้วค่าที่ระบุเป็นเพียงจำนวนเต็มหรือสตริง "ค่าเริ่มต้น" หากเป็นจำนวนเต็ม การทดสอบทั้งหมดจะทำงานได้สูงสุด N ครั้ง หากเลือก "ค่าเริ่มต้น" จะมีการทดสอบเพียง 1 ครั้งสำหรับการทดสอบปกติ และอีก 3 ครั้งสำหรับการทดสอบที่ทำเครื่องหมายไว้อย่างชัดเจนว่าไม่น่าเชื่อถือตามกฎ (แอตทริบิวต์ขจัดคราบ 1) ไวยากรณ์ทางเลือก: regex_filter@flaky_test_attempts โดยที่ flaky_test_attempts ไว้ดังข้างต้น และ regex_filter ย่อมาจากรายการรูปแบบการรวมและยกเว้นนิพจน์ทั่วไป (ดู --runs_per_test ด้วย) ตัวอย่างเช่น --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 ลบการทดสอบทั้งหมดใน //foo/ ยกเว้นการทดสอบที่อยู่ภายใต้ foo/bar 3 ครั้ง ตัวเลือกนี้สามารถส่งได้หลายครั้ง อาร์กิวเมนต์ที่ส่งผ่านล่าสุดที่ตรงกันจะมีความสำคัญเหนือกว่า หากไม่มีอะไรตรงกัน ลักษณะการทำงานจะเหมือนกับ "ค่าเริ่มต้น" ด้านบน
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]ios_memleaks
: "เท็จ" -
เปิดใช้การตรวจหาการรั่วไหลของหน่วยความจำในเป้าหมาย ios_test
แท็ก:action_command_lines
- ค่าเริ่มต้น
--ios_simulator_device=<a string>
: ดูรายละเอียด -
อุปกรณ์ที่จะจำลองเมื่อเรียกใช้แอปพลิเคชัน iOS ในเครื่องมือจำลอง เช่น "iPhone 6" คุณสามารถดูรายการอุปกรณ์โดยเรียกใช้ "xcrun simctl list devicetypes" ในเครื่องที่จะเรียกใช้เครื่องจำลอง
แท็ก:test_runner
- ค่าเริ่มต้น
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
เวอร์ชันของ iOS ที่จะเรียกใช้ในเครื่องจำลองเมื่อเรียกใช้หรือทดสอบ โดยจะไม่พิจารณากฎ ios_test หากมีการระบุอุปกรณ์เป้าหมายในกฎ
แท็ก:test_runner
- ค่าเริ่มต้นของ
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "อัตโนมัติ" -
จำนวนงานการทดสอบในเครื่องสูงสุดที่จะเรียกใช้พร้อมกัน ใช้จำนวนเต็มหรือคีย์เวิร์ด ("auto", "HOST_CPUS", "HOST_RAM") ตามด้วยการดำเนินการ ([-|*]<Flo>) เช่น (ไม่บังคับ) "auto", "HOST_CPUS*.5" 0 หมายความว่าทรัพยากรในเครื่องจะจำกัดจำนวนงานทดสอบในเครื่องที่จะเรียกใช้พร้อมกันแทน การตั้งค่านี้ที่มากกว่าค่าสำหรับ --jobs จะไม่ส่งผลใดๆ
แท็ก:execution
- รวมการใช้งานหลายรายการแล้ว
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
รายการ - ระบุจำนวนครั้งที่จะทำการทดสอบแต่ละครั้ง หากความพยายามอันใดอันหนึ่งล้มเหลวไม่ว่าด้วยเหตุผลใดก็ตาม ระบบจะถือว่าการทดสอบทั้งหมดไม่ผ่าน โดยปกติแล้วค่าที่ระบุจะเป็นจำนวนเต็ม ตัวอย่าง: --runs_per_test=3 จะทำการทดสอบทั้งหมด 3 ครั้ง ไวยากรณ์ทางเลือก: regex_filter@runs_per_test ตัวอย่าง: --runs_per_test=//foo/.*,-//foo/bar/.*@3 เรียกใช้การทดสอบทั้งหมดใน //foo/ ยกเว้นการทดสอบภายใต้ foo/bar 3 ครั้ง ตัวเลือกนี้สามารถส่งได้หลายครั้ง อาร์กิวเมนต์ที่ส่งผ่านล่าสุดที่ตรงกันจะมีความสำคัญเหนือกว่า หากไม่มีอะไรตรงกัน การทดสอบจะทำงานเพียงครั้งเดียว
- รวมการใช้งานหลายรายการแล้ว
--test_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุตัวแปรสภาพแวดล้อมเพิ่มเติมที่จะแทรกในสภาพแวดล้อมตัวดำเนินการทดสอบ สามารถระบุตัวแปรตามชื่อ ซึ่งในกรณีนี้ระบบจะอ่านค่าจากสภาพแวดล้อมไคลเอ็นต์ Bazel หรือโดยคู่ name=value สามารถใช้ตัวเลือกนี้ได้หลายครั้งเพื่อระบุตัวแปรหลายตัว ใช้โดยคำสั่ง 'bazel test' เท่านั้น
แท็ก:test_runner
- ค่าเริ่มต้นของ
--[no]test_keep_going
: "จริง" -
เมื่อปิดใช้ การทดสอบที่ไม่ผ่านจะทำให้บิลด์ทั้งหมดหยุดทำงาน การทดสอบทั้งหมดจะทำงานโดยค่าเริ่มต้น แม้บางรายการจะไม่ผ่าน
แท็ก:execution
- ค่าเริ่มต้นของ
--test_strategy=<a string>
: "" -
ระบุกลยุทธ์ที่จะใช้เมื่อทำการทดสอบ
แท็ก:execution
- ค่าเริ่มต้นของ
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - ลบล้างค่าระยะหมดเวลาทดสอบเริ่มต้นสำหรับระยะหมดเวลาทดสอบ (เป็นวินาที) หากระบุค่าจำนวนเต็มบวกค่าเดียว ค่านั้นจะลบล้างหมวดหมู่ทั้งหมด หากระบุจำนวนเต็มที่คั่นด้วยจุลภาค 4 ตัว ค่าเหล่านั้นจะลบล้างระยะหมดเวลาสำหรับระยะสั้น ปานกลาง ยาว และตลอดไป (ตามลำดับนั้น) ไม่ว่าจะในรูปแบบใด ค่า -1 จะบอกให้ Blaze ใช้ระยะหมดเวลาเริ่มต้นสำหรับหมวดหมู่นั้น
- ค่าเริ่มต้น
--test_tmpdir=<a path>
: ดูรายละเอียด - ระบุไดเรกทอรีชั่วคราวพื้นฐานที่จะใช้สำหรับ "การทดสอบเบเซล"
- ค่าเริ่มต้น
--tvos_simulator_device=<a string>
: ดูรายละเอียด -
อุปกรณ์ที่จะจำลองเมื่อเรียกใช้แอปพลิเคชัน tvOS ในเครื่องมือจำลอง เช่น "Apple TV 1080p" คุณสามารถดูรายการอุปกรณ์โดยเรียกใช้ "xcrun simctl list devicetypes" ในเครื่องที่จะเรียกใช้เครื่องจำลอง
แท็ก:test_runner
- ค่าเริ่มต้น
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
เวอร์ชันของ tvOS ที่จะเรียกใช้ในเครื่องจำลองเมื่อเรียกใช้หรือทดสอบ
แท็ก:test_runner
- ค่าเริ่มต้น
--watchos_simulator_device=<a string>
: ดูรายละเอียด -
อุปกรณ์ที่จะจำลองเมื่อเรียกใช้แอปพลิเคชัน watchOS ในเครื่องมือจำลอง เช่น "Apple Watch - 38 มม." คุณสามารถดูรายการอุปกรณ์โดยเรียกใช้ "xcrun simctl list devicetypes" ในเครื่องที่จะเรียกใช้เครื่องจำลอง
แท็ก:test_runner
- ค่าเริ่มต้น
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
เวอร์ชันของ watchOS ที่จะเรียกใช้ในเครื่องมือจำลองเมื่อเรียกใช้หรือทดสอบ
แท็ก:test_runner
- ค่าเริ่มต้นของ
--[no]zip_undeclared_test_outputs
: "จริง" -
หากเป็น "จริง" ระบบจะเก็บผลลัพธ์การทดสอบที่ไม่ได้ประกาศไว้ในไฟล์ ZIP
แท็กtest_runner
- ตัวเลือกที่กระตุ้นให้เกิดการเพิ่มประสิทธิภาพเวลาที่สร้าง
- ค่าเริ่มต้นของ
--[no]collapse_duplicate_defines
: "เท็จ" -
เมื่อเปิดใช้ ระบบจะนำการกำหนดที่ซ้ำกันออกในช่วงต้นของบิลด์ ซึ่งจะช่วยหลีกเลี่ยงการสูญเสียแคชการวิเคราะห์โดยไม่จำเป็นสำหรับบิลด์ที่เทียบเท่าบางประเภท
แท็ก:loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--[no]experimental_filter_library_jar_with_program_jar
: "เท็จ" -
กรอง ProGuard ProgramJar เพื่อนำคลาสที่แสดงใน LibraryJar ออกด้วย
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--[no]experimental_inmemory_dotd_files
: "จริง" -
หากเปิดใช้ ระบบจะส่งไฟล์ C++ .d ในหน่วยความจำจากโหนดบิลด์ระยะไกลโดยตรง แทนที่จะเขียนลงในดิสก์
แท็ก:loading_and_analysis
,execution
,affects_outputs
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_inmemory_jdeps_files
: "จริง" -
หากเปิดใช้ ระบบจะส่งไฟล์ทรัพยากร Dependency (.jdeps) ที่สร้างจากการคอมไพล์ Java ในหน่วยความจำจากโหนดบิลด์ระยะไกลโดยตรงแทนที่จะเขียนลงในดิสก์
แท็ก:loading_and_analysis
,execution
,affects_outputs
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_objc_include_scanning
: "เท็จ" -
ต้องรวมการสแกนหาวัตถุประสงค์ C/C++ ไหม
แท็ก:loading_and_analysis
,execution
,changes_inputs
- ค่าเริ่มต้นของ
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
: "เท็จ" -
หากเปิดใช้ ฟีเจอร์แยกวิเคราะห์ส่วนหัวจะไม่สร้างการดำเนินการคอมไพล์ส่วนหัวแยกต่างหากหากพบแหล่งที่มาที่มีชื่อฐานเดียวกันในเป้าหมายเดียวกัน
แท็ก:loading_and_analysis
,affects_outputs
- ค่าเริ่มต้นของ
--[no]experimental_retain_test_configuration_across_testonly
: "เท็จ" -
เมื่อเปิดใช้ --trim_test_configuration จะไม่ตัดการกำหนดค่าการทดสอบสำหรับกฎที่ระบุว่าเป็น testonly=1 ซึ่งจะช่วยลดปัญหาความขัดแย้งของการดำเนินการเมื่อกฎที่ไม่ใช่การทดสอบขึ้นอยู่กับกฎ cc_test จะไม่มีผลหาก --trim_test_configuration เป็นเท็จ
แท็ก:loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--[no]experimental_starlark_cc_import
: "เท็จ" -
หากเปิดใช้ คุณจะใช้ 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
: "จริง" -
การทำงานส่วนใหญ่มีไว้สำหรับการถอดรหัสไฟล์ 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
: "จริง" -
เมื่อเปิดใช้ ระบบจะล้างตัวเลือกที่เกี่ยวข้องกับการทดสอบภายใต้ระดับบนสุดของบิลด์ เมื่อแฟล็กนี้ทำงานอยู่ การทดสอบจะไม่สามารถสร้างขึ้นมาเป็นทรัพยากร Dependency ของกฎที่ไม่ใช่การทดสอบ แต่การเปลี่ยนแปลงตัวเลือกที่เกี่ยวข้องกับการทดสอบก็จะไม่ทำให้มีการวิเคราะห์กฎที่ไม่ใช่การทดสอบอีกครั้ง
แท็ก:loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--[no]use_singlejar_apkbuilder
: "จริง" -
ตัวเลือกนี้เลิกใช้งานแล้ว ตอนนี้ไม่มีการดำเนินการและจะถูกนำออกเร็วๆ นี้
แท็ก:loading_and_analysis
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งการบันทึก
- ค่าเริ่มต้นของ
--[no]announce
: "เท็จ" -
เลิกใช้งานแล้ว ไม่ดำเนินการ
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]experimental_bep_target_summary
: "เท็จ" - ต้องการเผยแพร่เหตุการณ์ TargetSummary หรือไม่
- ค่าเริ่มต้นของ
--[no]experimental_build_event_expand_filesets
: "เท็จ" -
หากเป็น "จริง" ให้ขยายชุดไฟล์ใน BEP เมื่อนำเสนอไฟล์เอาต์พุต
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: "เท็จ" -
หากเป็น "จริง" ให้แปลงสัญลักษณ์ Fileset ที่เกี่ยวข้องอย่างสมบูรณ์ใน BEP เมื่อนำเสนอไฟล์เอาต์พุต ต้องใช้ --experimental_build_event_expand_filesets
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--experimental_build_event_upload_max_retries=<an integer>
: "4" -
จํานวนครั้งสูงสุดที่บาเซลควรลองอัปโหลดเหตุการณ์บิลด์อีกครั้ง
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1 วินาที" -
ขั้นแรกคือการหน่วงเวลาขั้นต่ำสำหรับการลองย้อนกลับแบบเอ็กซ์โปเนนเชียลเมื่อการอัปโหลด BEP ล้มเหลว (exponent: 1.6)
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--experimental_build_event_upload_strategy=<a string>
: ดูรายละเอียด -
เลือกวิธีอัปโหลดอาร์ติแฟกต์ที่อ้างอิงในโปรโตคอลเหตุการณ์ของบิลด์
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]experimental_materialize_param_files_directly
: "เท็จ" -
หากทำให้ไฟล์พารามิเตอร์เป็นรูปธรรม ให้ทำด้วยการเขียนลงดิสก์โดยตรง
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]experimental_stream_log_file_uploads
: "เท็จ" -
ไฟล์บันทึกของสตรีมจะอัปโหลดไปยังพื้นที่เก็บข้อมูลระยะไกลโดยตรงแทนที่จะอัปโหลดลงในดิสก์
แท็ก:affects_outputs
- ค่าเริ่มต้น
--explain=<a path>
: ดูรายละเอียด -
ทำให้ระบบบิลด์อธิบายแต่ละขั้นตอนที่ดำเนินการของบิลด์ ระบบจะเขียนคำอธิบายลงในไฟล์บันทึกที่ระบุ
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]legacy_important_outputs
: "จริง" -
ใช้สิ่งนี้เพื่อระงับการสร้างช่องimportant_controls เดิมในเหตุการณ์ TargetComplete ต้องมีimportant_outputs สำหรับการผสานรวม Bazel กับ ResultsStore
แท็ก: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_เอาต์พุต เป็น "ข้อผิดพลาด" หรือ "ทั้งหมด" มีประโยชน์สำหรับการหลีกเลี่ยงผลลัพธ์ทดสอบที่มีเสียงดังรบกวนมากเกินไป ส่วนหัวการทดสอบจะรวมอยู่ในขนาดบันทึก ค่าลบหมายถึงไม่มีขีดจำกัด เอาต์พุตทั้งหมดหรือไม่ใช้เลย
แท็ก:test_runner
,terminal_output
,execution
- ค่าเริ่มต้น
--output_filter=<a valid Java regular expression>
: ดูรายละเอียด -
แสดงเฉพาะคำเตือนสำหรับกฎที่มีชื่อตรงกับนิพจน์ทั่วไปที่ระบุ
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--progress_report_interval=<an integer in 0-3600 range>
: "0" -
จำนวนวินาทีระหว่างการรายงานเกี่ยวกับงานที่ยังคงทำงานอยู่ ค่าเริ่มต้น 0 หมายความว่าระบบจะพิมพ์รายงานแรกหลังผ่านไป 10 วินาที จากนั้นจะพิมพ์ 30 วินาทีและหลังจากรายงานความคืบหน้านั้นทุกๆ นาที เมื่อเปิดใช้ --curses ระบบจะรายงานความคืบหน้าทุกวินาที
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--show_result=<an integer>
: "1" -
แสดงผลลัพธ์ของบิลด์ ให้ระบุว่าเป้าหมายแต่ละรายการเป็นข้อมูลล่าสุดหรือไม่ และมีรายการไฟล์เอาต์พุตที่สร้างขึ้นหรือไม่ หากมี ไฟล์ที่พิมพ์เป็นสตริงที่สะดวกสบายในการคัดลอก+วางลงใน Shell เพื่อสั่งการ
ตัวเลือกนี้ต้องการอาร์กิวเมนต์จำนวนเต็ม ซึ่งเป็นจำนวนเกณฑ์ของเป้าหมายข้างต้นซึ่งจะไม่มีการพิมพ์ข้อมูลผลลัพธ์ ดังนั้นศูนย์ทำให้ไม่สามารถระงับข้อความได้และ MAX_INT จะทำให้พิมพ์ผลลัพธ์ทุกครั้ง ค่าเริ่มต้นคือ 1
แท็ก:affects_outputs
--[no]subcommands
[-s
] ค่าเริ่มต้น: "เท็จ"-
แสดงคำสั่งย่อยที่ดำเนินการระหว่างบิลด์ แฟล็กที่เกี่ยวข้อง: --execution_log_json_file, --execution_log_binary_file (สำหรับการบันทึกคำสั่งย่อยไปยังไฟล์ในรูปแบบที่ใช้งานง่าย)
แท็ก:terminal_output
- ค่าเริ่มต้น
--test_output=<summary, errors, all or streamed>
: "สรุป" -
ระบุโหมดเอาต์พุตที่ต้องการ ค่าที่ใช้ได้ ได้แก่ "สรุป" เพื่อแสดงผลเฉพาะสรุปสถานะการทดสอบ "ข้อผิดพลาด" เพื่อพิมพ์บันทึกการทดสอบสำหรับการทดสอบที่ล้มเหลวด้วย "ทั้งหมด" เพื่อพิมพ์บันทึกสำหรับการทดสอบทั้งหมด และ "สตรีม" เป็นเอาต์พุตบันทึกสำหรับการทดสอบทั้งหมดแบบเรียลไทม์ (ซึ่งจะบังคับให้ทำการทดสอบในเครื่องต่อครั้ง โดยไม่คำนึงถึงค่า --test_strategy)
แท็ก:test_runner
,terminal_output
,execution
- ค่าเริ่มต้นของ
--test_summary=<short, terse, detailed, none or testcase>
: "short" -
ระบุรูปแบบที่ต้องการของสรุปการทดสอบ ค่าที่ถูกต้องคือ "สั้น" เพื่อพิมพ์ข้อมูลเกี่ยวกับการทดสอบที่ดำเนินการเท่านั้น "ทั่วไป" เพื่อพิมพ์เฉพาะข้อมูลเกี่ยวกับการทดสอบที่ไม่สำเร็จที่เรียกใช้ "รายละเอียด" เพื่อพิมพ์ข้อมูลโดยละเอียดเกี่ยวกับกรอบการทดสอบที่ล้มเหลว "กรณีทดสอบ" เพื่อพิมพ์ข้อมูลสรุปในการแก้ปัญหาเกี่ยวกับกรอบการทดสอบ อย่าพิมพ์ข้อมูลโดยละเอียดเกี่ยวกับกรอบการทดสอบที่ล้มเหลว และ "ไม่มี" เพื่อละเว้นข้อมูลสรุป
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
พิมพ์ข้อมูลการแก้ไขข้อบกพร่องระหว่างการแก้ปัญหา Toolchain แฟล็กจะใช้นิพจน์ทั่วไป ซึ่งมีการตรวจสอบกับประเภท Toolchain และเป้าหมายเฉพาะเพื่อดูสิ่งที่ต้องแก้ไขข้อบกพร่อง คุณสามารถคั่นนิพจน์ทั่วไปหลายรายการได้ด้วยคอมมา แล้วจึงตรวจสอบนิพจน์ทั่วไปแต่ละรายการแยกกัน หมายเหตุ: ผลลัพธ์ของแฟล็กนี้ซับซ้อนมากและน่าจะมีประโยชน์สำหรับผู้เชี่ยวชาญด้านการแก้ปัญหาเครื่องมือเชนเท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]verbose_explanations
: "เท็จ" -
เพิ่มรายละเอียดของคำอธิบายหากเปิดใช้ --explain ไว้ จะไม่มีผล หากไม่ได้เปิดใช้ --explain
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]verbose_failures
: "เท็จ" -
หากคำสั่งล้มเหลว ให้พิมพ์บรรทัดคำสั่งแบบเต็ม
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- รวมการใช้งานหลายรายการแล้ว
--aspects_parameters=<a 'name=value' assignment>
รายการ -
ระบุค่าของพารามิเตอร์ลักษณะบรรทัดคำสั่ง ค่าพารามิเตอร์แต่ละค่าจะระบุผ่าน <param_name>=<param_value> ตัวอย่างเช่น 'my_param=my_val' โดยที่ 'my_param' เป็นพารามิเตอร์ของบางลักษณะในรายการ --aspects หรือจำเป็นสำหรับด้านในรายการ ตัวเลือกนี้ใช้ได้หลายครั้ง อย่างไรก็ตาม เราไม่อนุญาตให้กําหนดค่าให้กับพารามิเตอร์เดียวกันมากกว่า 1 ครั้ง
แท็ก:loading_and_analysis
- รวมการใช้งานหลายรายการแล้ว
--flag_alias=<a 'name=value' flag alias>
รายการ -
ตั้งชื่อชวเลขให้กับธง Starlark ซึ่งจะใช้คู่คีย์-ค่าเดียวในรูปแบบ "<key>=<value>" เป็นอาร์กิวเมนต์
แท็ก:changes_inputs
- ค่าเริ่มต้นของ
--[no]incompatible_default_to_explicit_init_py
: "เท็จ" -
แฟล็กนี้จะเปลี่ยนลักษณะการทำงานเริ่มต้นเพื่อไม่ให้สร้างไฟล์ __init__.py โดยอัตโนมัติในไฟล์ Runfile ของ Python เป้าหมายอีกต่อไป ในขั้นนี้ เมื่อเป้าหมาย py_binary หรือ py_test มีการตั้งค่า legacy_create_init เป็น "auto" (ค่าเริ่มต้น) ค่าดังกล่าวจะถือว่าเป็น False ก็ต่อเมื่อมีการตั้งค่าสถานะนี้เท่านั้น ดู 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
: "จริง" -
หากเป็น "จริง" เป้าหมาย "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 ที่ระบุโดย Toolchain ของ Python แทนที่จะเป็นรันไทม์ที่ได้จากแฟล็กเดิม เช่น --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
,explicit_in_output_path
- ค่าเริ่มต้นของ
--target_pattern_file=<a string>
: "" -
หากตั้งค่าแล้ว บิลด์จะอ่านรูปแบบจากไฟล์ที่มีชื่อที่นี่ ไม่ใช่ในบรรทัดคำสั่ง การระบุไฟล์ที่นี่รวมถึงรูปแบบบรรทัดคำสั่งเป็นข้อผิดพลาด
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
- ค่าเริ่มต้นของ
--experimental_remote_cache_eviction_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองซ้ำหากบิลด์พบข้อผิดพลาดในการถอนแคชจากระยะไกล ค่าที่ไม่ใช่ 0 จะถูกตั้งค่าโดยปริยาย เช่น incompatible_remote_use_new_exit_code_for_lost_inputs ให้เป็น "จริง" ระบบจะสร้างรหัสคำขอใหม่สําหรับความพยายามแต่ละครั้ง หากคุณสร้างรหัสคำขอและส่งให้กับ Bazel โดยใช้ --invocation_id คุณไม่ควรใช้แฟล็กนี้ ให้ตั้งค่า Flag --incompatible_remote_use_new_exit_code_for_lost_inputs แล้วหารหัสออก 39 แทน
แท็ก:execution
- ตัวเลือกเบ็ดเตล็ด ที่ไม่ได้จัดอยู่ในหมวดหมู่อื่น:
- ค่าเริ่มต้นของ
--[no]allow_analysis_cache_discard
: "จริง" -
หากทิ้งแคชการวิเคราะห์เนื่องจากการเปลี่ยนแปลงในระบบบิลด์ การตั้งค่าตัวเลือกนี้เป็น "เท็จ" จะทำให้เบลิเทลออก แทนที่จะดำเนินการต่อกับบิลด์ ตัวเลือกนี้จะไม่มีผลเมื่อตั้งค่า "discard_analysis_cache" ด้วย
แท็ก:eagerness_to_exit
- ค่าเริ่มต้นของ
--[no]build_manual_tests
: "เท็จ" - บังคับให้สร้างเป้าหมายการทดสอบที่ติดแท็ก "ด้วยตนเอง" ระบบจะไม่ประมวลผลการทดสอบ "ด้วยตนเอง" โดยตัวเลือกนี้จะบังคับให้สร้าง (แต่ดำเนินการไม่ได้)
- ค่าเริ่มต้นของ
--build_tag_filters=<comma-separated list of options>
: "" - ระบุรายการแท็กที่คั่นด้วยคอมมา แต่ละแท็กสามารถนำหน้าด้วย '-' เพื่อระบุแท็กที่ยกเว้นได้ ระบบจะสร้างเฉพาะเป้าหมายที่มีแท็กที่รวมอย่างน้อย 1 แท็ก และไม่มีแท็กที่ยกเว้น ตัวเลือกนี้ไม่มีผลกับชุดการทดสอบที่ดำเนินการด้วยคำสั่ง "test" ซึ่งจะควบคุมโดยตัวเลือกการกรองการทดสอบ เช่น "--test_tag_filters"
- ค่าเริ่มต้นของ
--[no]build_tests_only
: "เท็จ" - หากระบุ ระบบจะสร้างเฉพาะกฎ *_test และ test_suite และไม่สนใจเป้าหมายอื่นๆ ที่ระบุไว้ในบรรทัดคำสั่ง ระบบจะสร้างทุกอย่างตามที่ขอโดยค่าเริ่มต้น
--[no]cache_test_results
[-t
] ค่าเริ่มต้น: "อัตโนมัติ"- หากตั้งค่าเป็น "อัตโนมัติ" Bazel จะทำการทดสอบอีกครั้งเฉพาะเมื่อ (1) Bazel ตรวจพบการเปลี่ยนแปลงในการทดสอบหรือทรัพยากร Dependency (2) ระบบจะทำเครื่องหมายการทดสอบเป็นภายนอก (3) มีการขอการทดสอบหลายรายการด้วย --runs_per_test หรือ(4) การทดสอบล้มเหลวก่อนหน้านี้ หากตั้งค่าเป็น "ใช่" Bazel จะแคชผลการทดสอบทั้งหมด ยกเว้นการทดสอบที่ทำเครื่องหมายว่าเป็นภายนอก หากตั้งค่าเป็น "ไม่" Bazel จะไม่แคชผลการทดสอบใดๆ
- ค่าเริ่มต้นของ
--[no]compile_one_dependency
: "เท็จ" - รวบรวมทรัพยากร Dependency เดียวของไฟล์อาร์กิวเมนต์ วิธีนี้มีประโยชน์สำหรับการตรวจสอบไวยากรณ์ของไฟล์ต้นฉบับใน IDE เช่น ด้วยการสร้างเป้าหมายเดียวใหม่ซึ่งขึ้นอยู่กับไฟล์แหล่งที่มาเพื่อตรวจหาข้อผิดพลาดโดยเร็วที่สุดในรอบการแก้ไข/สร้าง/ทดสอบ อาร์กิวเมนต์นี้ส่งผลต่อวิธีแปลอาร์กิวเมนต์ทั้งหมดที่ไม่ใช่ Flag แทนที่จะเป็นเป้าหมายเพื่อสร้างเป็นชื่อไฟล์ต้นทาง จะมีการสร้างเป้าหมายที่กำหนดเองสำหรับชื่อไฟล์แหล่งข้อมูลแต่ละชื่อขึ้น
- ค่าเริ่มต้นของ
--deleted_packages=<comma-separated list of package names>
: "" - รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริง แม้ว่าจะปรากฏในตำแหน่งใดบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ ตัวอย่างเช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์แล้ว ระบบบิลด์อาจร้องเรียนหากพบป้ายกำกับ "//x:y/z" หากมีป้ายกำกับ "//x:y/z" อยู่หากยังมีรายการ package_path อื่นอยู่ การระบุ --deleted_packages x/y จะหลีกเลี่ยงปัญหานี้
- ค่าเริ่มต้นของ
--[no]discard_analysis_cache
: "เท็จ" - ทิ้งแคชการวิเคราะห์ทันทีหลังจากเสร็จสิ้นขั้นตอนการวิเคราะห์ ลดการใช้งานหน่วยความจำประมาณ 10% แต่จะทำให้บิลด์เพิ่มเติมช้าลง
- ค่าเริ่มต้น
--execution_log_binary_file=<a path>
: ดูรายละเอียด - บันทึกการเรียกใช้ที่เรียกใช้ลงในไฟล์นี้เป็น "Sptown Protos" ที่คั่นด้วยอักขระ ตาม src/main/ctrbuf/spawn.Proto ระบบจะเขียนบันทึกก่อนโดยไม่เรียงลำดับ จากนั้นเมื่อสิ้นสุดคำขอ โดยจะจัดเรียงตามลำดับที่เสถียร (อาจเป็นการใช้ CPU และหน่วยความจำมาก) แฟล็กที่เกี่ยวข้อง: --execution_log_json_file (รูปแบบ JSON ของข้อความลำดับ), --experimental_execution_log_file (รูปแบบไบนารี โพรโทบูฟที่ไม่เรียงลำดับ), --คำสั่งย่อย (สำหรับการแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
- ค่าเริ่มต้น
--execution_log_json_file=<a path>
: ดูรายละเอียด - บันทึกการเรียกใช้ที่สร้างขึ้นลงในไฟล์นี้ในรูปแบบ JSON ของ Proto ที่คั่นด้วยตัวคั่นตาม " src/main/ctrbuf/spawn.สอง" ระบบจะเขียนบันทึกก่อนโดยไม่เรียงลำดับ จากนั้นเมื่อสิ้นสุดคำขอ โดยจะจัดเรียงตามลำดับที่เสถียร (อาจเป็นการใช้ CPU และหน่วยความจำมาก) แฟล็กที่เกี่ยวข้อง: แฟล็กที่เกี่ยวข้อง: --execution_log_binary_file (รูปแบบไบนารีตามลำดับ), --experimental_execution_log_file (รูปแบบไบนารีที่ไม่เรียงลำดับ), --commands (สำหรับการแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
- ค่าเริ่มต้นของ
--[no]execution_log_sort
: "จริง" - เลือกว่าจะจัดเรียงบันทึกการดำเนินการหรือไม่ ตั้งค่าเป็น "เท็จ" เพื่อปรับปรุงประสิทธิภาพของหน่วยความจำ ซึ่งจะมีค่าใช้จ่ายในการสร้างบันทึกตามลำดับที่กำหนดไม่ได้
- ค่าเริ่มต้นของ
--[no]expand_test_suites
: "จริง" -
ขยายเป้าหมาย test_suite ไปยังการทดสอบส่วนประกอบก่อนการวิเคราะห์ เมื่อเปิดแฟล็กนี้ (ค่าเริ่มต้น) รูปแบบเป้าหมายเชิงลบจะมีผลกับการทดสอบที่อยู่ในชุดทดสอบ ไม่เช่นนั้นจะไม่มีผล การปิดแฟล็กนี้เป็นประโยชน์เมื่อมีการใช้มุมมองระดับบนสุดในบรรทัดคำสั่ง จากนั้นจึงวิเคราะห์เป้าหมาย test_suite ได้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]experimental_cancel_concurrent_tests
: "เท็จ" -
หากเป็น "จริง" Blaze จะยกเลิกการทดสอบที่ทำงานอยู่พร้อมกันเมื่อเรียกใช้สำเร็จครั้งแรก วิธีนี้มีประโยชน์เมื่อใช้ร่วมกับ --runs_per_test_detects_flakes
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--experimental_execution_log_file=<a path>
: ดูรายละเอียด - บันทึกการเรียกใช้ที่เรียกใช้ลงในไฟล์นี้เป็น "Sptown Protos" ที่คั่นด้วยอักขระ ตาม src/main/ctrbuf/spawn.Proto ไฟล์นี้เขียนขึ้นตามลำดับการเรียกใช้การสร้างซอฟต์แวร์ แฟล็กที่เกี่ยวข้อง: --execution_log_binary_file (รูปแบบไบนารี โพรโทบูฟที่เรียงลำดับ), --execution_log_json_file (รูปแบบ JSON ข้อความที่เรียงลำดับ), --คำสั่งย่อย (สำหรับการแสดงคำสั่งย่อยในเอาต์พุตเทอร์มินัล)
- ค่าเริ่มต้นของ
--[no]experimental_execution_log_spawn_metrics
: "เท็จ" - รวมเมตริกที่สร้างขึ้นในบันทึกการสร้างการดำเนินการ
- ค่าเริ่มต้นของ
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "" - เลิกใช้งานเพื่อสนับสนุนแง่มุมต่างๆ ตัวกรองชุดเป้าหมายเพื่อกำหนดเวลา extra_actions สำหรับ
- ค่าเริ่มต้นของ
--[no]experimental_extra_action_top_level_only
: "เท็จ" - เลิกใช้งานเพื่อสนับสนุนแง่มุมต่างๆ กำหนดเวลา additional_actions สำหรับเป้าหมายระดับบนสุดเท่านั้น
- ค่าเริ่มต้นของ
--[no]experimental_fetch_all_coverage_outputs
: "เท็จ" -
หากเป็น "จริง" Bazel จะดึงข้อมูลไดเรกทอรีข้อมูลการครอบคลุมทั้งหมดสำหรับการทดสอบแต่ละครั้งระหว่างการเรียกใช้การครอบคลุม
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]experimental_generate_llvm_lcov
: "เท็จ" -
หากเป็น "จริง" ความครอบคลุมของเสียงดังจะสร้างรายงาน LCOV
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]experimental_j2objc_header_map
: "จริง" - กำหนดว่าจะสร้างแมปส่วนหัว J2ObjC ควบคู่ไปกับการเปลี่ยนรูปแบบ J2ObjC ไหม
- ค่าเริ่มต้นของ
--[no]experimental_j2objc_shorter_header_path
: "เท็จ" -
กำหนดว่าจะสร้างโดยใช้เส้นทางส่วนหัวที่สั้นลง (ใช้ "_ios" แทน "_j2objc")
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--experimental_java_classpath=<off, javabuilder or bazel>
: "javabuilder" - เปิดใช้คลาสพาธที่ลดลงสำหรับการคอมไพล์ Java
- ค่าเริ่มต้นของ
--[no]experimental_limit_android_lint_to_android_constrained_java
: "เท็จ" -
จำกัด --experimental_run_android_lint_on_java_rulesในไลบรารีที่ใช้ร่วมกับ Android ได้
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]experimental_prioritize_local_actions
: "จริง" -
หากตั้งค่าแล้ว การดำเนินการที่เรียกใช้ในเครื่องได้เท่านั้นจะได้รับโอกาสแรกในการได้รับทรัพยากร ผู้ปฏิบัติงานที่เรียกใช้แบบไดนามิกจะได้รับโอกาสครั้งที่ 2 และการดำเนินการแบบสแตนด์อโลนที่เรียกใช้แบบไดนามิกจะเข้ามาเป็นลำดับสุดท้าย
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]experimental_run_android_lint_on_java_rules
: "เท็จ" -
ต้องการตรวจสอบแหล่งที่มา java_* หรือไม่
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]explicit_java_test_deps
: "เท็จ" - ระบุทรัพยากร Dependency ให้กับ JUnit หรือ Hamcrest อย่างชัดเจนใน java_test แทนการขอรับจาก Deps ของ TestRunner โดยไม่ตั้งใจ เล่นกับ Bazel ได้ตอนนี้เท่านั้น
- ค่าเริ่มต้น
--host_java_launcher=<a build target label>
: ดูรายละเอียด - JavaScript Launcher ใช้โดยเครื่องมือที่ทำงานระหว่างบิลด์
- รวมการใช้งานหลายรายการแล้ว
--host_javacopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง JavaScript เมื่อสร้างเครื่องมือที่ทำงานระหว่างบิลด์
- รวมการใช้งานหลายรายการแล้ว
--host_jvmopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง Java VM เมื่อสร้างเครื่องมือที่ทำงานระหว่างบิลด์ ระบบจะเพิ่มตัวเลือกเหล่านี้ลงในตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
- ค่าเริ่มต้นของ
--[no]incompatible_check_sharding_support
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่ผ่านการทดสอบชาร์ดหากตัวดำเนินการทดสอบไม่ได้ระบุว่ารองรับชาร์ดดิ้งโดยแตะไฟล์ที่เส้นทางใน TEST_SHARD_STATUS_FILE หากเป็นเท็จ ตัวดำเนินการทดสอบที่ไม่รองรับชาร์ดดิ้งจะนำไปสู่การทดสอบทั้งหมดที่ทำงานอยู่ในแต่ละชาร์ด
แท็ก:incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_exclusive_test_sandboxed
: "เท็จ" -
หากเป็นจริง การทดสอบพิเศษจะทํางานโดยใช้กลยุทธ์แบบแซนด์บ็อกซ์ เพิ่มแท็ก "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_เอาต์พุต=streamed
ขยายเป็น
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- ค่าเริ่มต้นของ
--[no]java_deps
: "จริง" - สร้างข้อมูลทรัพยากร Dependency (สำหรับตอนนี้คือคลาสพาธการคอมไพล์) ต่อเป้าหมาย Java
- ค่าเริ่มต้นของ
--[no]java_header_compilation
: "จริง" - รวบรวม Jar จากแหล่งที่มาโดยตรง
- ค่าเริ่มต้นของ
--java_language_version=<a string>
: "8" - เวอร์ชันภาษา Java
- ค่าเริ่มต้น
--java_launcher=<a build target label>
: ดูรายละเอียด - JavaScript Launcher ที่ใช้เมื่อสร้างไบนารีของ Java หากตั้งค่าแฟล็กนี้เป็นสตริงว่างเปล่า ระบบจะใช้ JDK Launcher แอตทริบิวต์ "launcher" จะลบล้าง Flag นี้
- ค่าเริ่มต้นของ
--java_runtime_version=<a string>
: "local_jdk" - เวอร์ชันรันไทม์ของ Java
- รวมการใช้งานหลายรายการแล้ว
--javacopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง JavaScript
- รวมการใช้งานหลายรายการแล้ว
--jvmopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง VM ของ Java ระบบจะเพิ่มตัวเลือกเหล่านี้ลงในตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
- ค่าเริ่มต้น
--legacy_main_dex_list_generator=<a build target label>
: ดูรายละเอียด - ระบุไบนารีที่จะใช้ในการสร้างรายการคลาสที่ต้องอยู่ใน Dex หลักเมื่อคอมไพล์ Multidex เดิม
- ค่าเริ่มต้นของ
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
: "HOST_CPUS" - กำหนดจำนวนแกน CPU ในเครื่องทั้งหมดที่ Bazel จะใช้ได้เพื่อใช้จ่ายกับการดำเนินการของบิลด์ที่ดำเนินการในเครื่อง จะใช้จำนวนเต็มหรือ "HOST_CPUS" ตามด้วย [-|*]<Flo> (เช่น HOST_CPUS*.5 เพื่อใช้แกน CPU ที่มีครึ่งหนึ่งโดยค่าเริ่มต้น ("HOST_CPUS") Bazel จะค้นหาการกำหนดค่าระบบเพื่อประมาณจำนวนแกนของ CPU ที่มี
- รวมการใช้งานหลายรายการแล้ว
--local_extra_resources=<a named float, 'name=value'>
รายการ - กำหนดจำนวนทรัพยากรเพิ่มเติมที่พร้อมใช้งานใน Bazel ใช้งานในคู่สตริงลอย ใช้ได้หลายครั้งเพื่อระบุทรัพยากรเพิ่มเติมหลายประเภท Bazel จะจำกัดการทำงานที่เกิดขึ้นพร้อมกันตามทรัพยากรเพิ่มเติมที่มีและทรัพยากรเพิ่มเติมที่จำเป็น การทดสอบจะประกาศจำนวนทรัพยากรเพิ่มเติมที่ต้องการได้โดยใช้แท็กรูปแบบ "resources:<resoucename>:<amount>" ไม่สามารถตั้งค่า CPU, RAM และทรัพยากรที่ใช้ได้ด้วยแฟล็กนี้
- ค่าเริ่มต้นของ
--local_ram_resources=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "HOST_RAM*.67" - กำหนดจำนวน RAM ของโฮสต์ในเครื่องทั้งหมด (เป็น MB) ที่ใช้ได้สำหรับ Bazel อย่างชัดเจนเพื่อใช้สำหรับการดำเนินการบิลด์ที่ดำเนินการในเครื่อง จะใช้จำนวนเต็มหรือ "HOST_RAM" แล้วตามด้วย [-|*]<Flo> (เช่น HOST_RAM*.5 เพื่อใช้ RAM ที่มีอยู่ครึ่งหนึ่ง) โดยค่าเริ่มต้น ("HOST_RAM*.67") Bazel จะค้นหาการกำหนดค่าของระบบเพื่อประมาณปริมาณ RAM ที่มีอยู่และจะใช้ 67%
- ค่าเริ่มต้นของ
--local_termination_grace_seconds=<an integer>
: "15" - เวลาที่ต้องรอจนกว่าจะสิ้นสุดกระบวนการในเครื่องเนื่องจากหมดเวลาแล้วจึงบังคับให้ปิดกระบวนการ
- ค่าเริ่มต้นของ
--package_path=<colon-separated list of options>
: "%workspace%" - รายการที่คั่นด้วยเครื่องหมายทวิภาคของตำแหน่งสำหรับค้นหาแพ็กเกจ องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับพื้นที่ทำงานที่ล้อมรอบอยู่ หากไม่ระบุหรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
- รวมการใช้งานหลายรายการแล้ว
--plugin=<a build target label>
รายการ - ปลั๊กอินที่จะใช้ในบิลด์ ใช้งานได้กับ java_plugin ในขณะนี้
- ค่าเริ่มต้น
--proguard_top=<a build target label>
: ดูรายละเอียด - ระบุว่าจะใช้ ProGuard เวอร์ชันใดสำหรับการนำโค้ดออกเมื่อสร้างไบนารี Java
- ค่าเริ่มต้นของ
--proto_compiler=<a build target label>
: "@bazel_tools//tools/ctr:ctrc" -
ป้ายกำกับของ Proto-Composer
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/prof:cc_toolchain"-
ป้ายกำกับของ ctr_lang_toolchain() ที่อธิบายวิธีคอมไพล์ C++ โปรโตคอล
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/j2objc:j2objc_plo_toolchain"-
ป้ายกำกับของ ctr_lang_toolchain() ที่อธิบายวิธีคอมไพล์ j2objc โพโตร
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/ctr:java_toolchain"-
ป้ายกำกับของ ctr_lang_toolchain() ที่อธิบายวิธีคอมไพล์ Java โปรโตคอล
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/ctr:javalite_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ที่อธิบายวิธีคอมไพล์ Proto ของ JavaLite
แท็ก:affects_outputs
,loading_and_analysis
- รวมการใช้งานหลายรายการแล้ว
--protocopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังคอมไพเลอร์ ctrbuf
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]runs_per_test_detects_flakes
: "เท็จ" - หากเป็น "จริง" ชาร์ดที่มีการรัน/พยายามอย่างน้อย 1 ครั้ง และการเรียกใช้/การลองอย่างน้อย 1 ครั้งล้มเหลวจะได้รับสถานะ "ไม่ถูกต้อง"
- ค่าเริ่มต้น
--shell_executable=<a path>
: ดูรายละเอียด -
เส้นทางสัมบูรณ์ไปยังไฟล์ปฏิบัติการ Shell ที่ 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
: "จริง" - หากเปิดใช้จะทำให้ 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
: "เท็จ" - ส่งต่อตัวเลือก "ไม่ผ่าน" ไปยังตัวดำเนินการทดสอบ ตัวดำเนินการทดสอบควรหยุดการดำเนินการเมื่อล้มเหลวในครั้งแรก
- ค่าเริ่มต้นของ
--test_sharding_strategy=<explicit or disabled>
: "โจ่งแจ้ง" - ระบุกลยุทธ์สำหรับชาร์ดดิ้งทดสอบ: "โจ่งแจ้ง" เพื่อใช้ชาร์ดดิ้งก็ต่อเมื่อมีแอตทริบิวต์ 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>
: "8" - เวอร์ชันภาษา Java ที่ใช้เพื่อเรียกใช้เครื่องมือที่จำเป็นระหว่างบิลด์
- ค่าเริ่มต้นของ
--tool_java_runtime_version=<a string>
: "remotejdk_11" - เวอร์ชันรันไทม์ของ Java ที่ใช้เพื่อเรียกใช้เครื่องมือในระหว่างบิลด์
- ค่าเริ่มต้นของ
--[no]use_ijars
: "จริง" - หากเปิดใช้ ตัวเลือกนี้จะทำให้การคอมไพล์ Java ใช้ Jar ของอินเทอร์เฟซ ซึ่งจะส่งผลให้การรวบรวมเพิ่มขึ้นเร็วขึ้น แต่ข้อความแสดงข้อผิดพลาดอาจแตกต่างกันได้
ตัวเลือกการตั้งค่าสถานะ Canonical
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคำสั่งและถูกแยกวิเคราะห์โดยไคลเอ็นต์ ได้แก่
- รวมการใช้งานหลายรายการแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบแคช แทนที่จะคัดลอก โดยมีจุดประสงค์เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่มาจาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม ซึ่งสามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ส่งผลให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_repository_disable_download
: "เท็จ" -
หากมีการตั้งค่า ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองแก้ไขข้อผิดพลาดในการดาวน์โหลดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานได้ในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้นของ
--http_timeout_scaling=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลด HTTP ตามปัจจัยที่กำหนด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูรายละเอียด -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็กbazel_internal_configuration
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่งมีดังนี้
- ค่าเริ่มต้นของ
--[no]canonicalize_policy
: "เท็จ" -
แสดงผลนโยบาย Canonical หลังจากการขยายและการกรอง อาร์กิวเมนต์คำสั่งตามรูปแบบบัญญัติจะไม่แสดงเมื่อตั้งค่าตัวเลือกนี้เป็น "จริง" เพื่อให้เอาต์พุตสะอาดตา โปรดทราบว่าคำสั่งที่ระบุโดย --for_command จะมีผลกับนโยบายที่กรอง และหากไม่มีการระบุไว้ คำสั่งเริ่มต้นจะเป็น "build"
แท็ก:affects_outputs
,terminal_output
- ค่าเริ่มต้นของ
--[no]show_warnings
: "เท็จ" -
คำเตือนของโปรแกรมแยกวิเคราะห์เอาต์พุตเป็นข้อผิดพลาดมาตรฐาน (เช่น สำหรับตัวเลือกการแฟล็กที่ขัดแย้งกัน)
แท็ก:affects_outputs
,terminal_output
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมของแฟล็ก ฯลฯ)
- ค่าเริ่มต้นของ
--experimental_repository_hash_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรยืนยันแฮชไดเรกทอรีที่เก็บ
แท็ก:affects_outputs
,experimental
- รวมการใช้งานหลายรายการแล้ว
--experimental_verify_repository_rules=<a string>
รายการ -
หากรายการกฎที่เก็บซึ่งควรยืนยันแฮชของไดเรกทอรีเอาต์พุต ระบบจะระบุไฟล์โดย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ API ของบิลด์ที่เข้าถึงได้ด้วยการสร้างไฟล์ .bzl หรือไฟล์ WORKSPACE
- ค่าเริ่มต้นของ
--[no]experimental_allow_top_level_aspects_parameters
: "จริง" -
ไม่ดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ค่าเริ่มต้นของ
--[no]incompatible_config_setting_private_default_visibility
: "เท็จ" -
หากแฟล็กนี้เป็นเท็จ config_setting ที่ไม่มีแอตทริบิวต์การเปิดเผยอย่างชัดเจนจะเป็น //visibility:public หากแฟล็กนี้เป็นจริง config_setting จะใช้ตรรกะการแสดงผลเดียวกันกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_enforce_config_setting_visibility
: "จริง" -
หากเป็น "จริง" ให้บังคับใช้ข้อจํากัดระดับการเข้าถึง config_setting หากเป็น "เท็จ" ทุก config_setting จะปรากฏกับทุกเป้าหมาย ดู https://github.com/bazelbuild/bazel/issues/12932
แท็กloading_and_analysis
,incompatible_change
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
- รวมการใช้งานหลายรายการแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ซึ่งจะอนุญาตให้ใช้ในกราฟการอ้างอิงที่แก้ไขแล้วแม้ว่าจะมีการประกาศว่าได้รับการแย้งในรีจิสทรีที่เป็นแหล่งที่มา (หากเว็บไซต์ไม่ได้มาจาก NonRegistryReplace) มิฉะนั้น เวอร์ชันที่ยัดเยียดจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชัน yank ที่อนุญาตได้ด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" คุณสามารถปิดใช้งานการตรวจสอบนี้ได้โดยใช้คำหลัก "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ หรือ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบว่าข้อมูลไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบที่ไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าทรัพยากร Dependency ดังกล่าวจะถูกละเว้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท โดยไม่คำนึงถึงค่าของแฟล็กนี้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--lockfile_mode=<off, update or error>
: "ปิด" -
ระบุว่าจะใช้ Lockfile อย่างไรและจะใช้หรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ Lockfile และอัปเดตเมื่อมีการเปลี่ยนแปลง "ข้อผิดพลาด" ให้ใช้ Lockfile แต่จะแสดงข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่ออ่านหรือเขียนไฟล์ล็อกทั้ง 2 ไฟล์
แท็ก: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
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งการบันทึกมีดังนี้
- ค่าเริ่มต้นของ
--[no]experimental_record_metrics_for_all_mnemonics
: "เท็จ" - โดยค่าเริ่มต้น ประเภทการดําเนินการจะจํากัดอยู่ที่ 20 ประเภทที่มีจำนวนการดำเนินการสูงสุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสําหรับการช่วยจำทั้งหมด
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปในคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ มีดังนี้
- ค่าเริ่มต้นของ
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
หากไม่ว่างเปล่า ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ค่าเริ่มต้นของ
--for_command=<a string>
: "บิลด์" -
คำสั่งที่ควรกำหนดตัวเลือกเป็น Canonical
แท็ก:affects_outputs
,terminal_output
- ค่าเริ่มต้นของ
--invocation_policy=<a string>
: "" -
ใช้นโยบายการเรียกใช้กับตัวเลือกที่ต้องการกำหนดหน้า Canonical
แท็ก:affects_outputs
,terminal_output
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล:
- ค่าเริ่มต้น
--experimental_downloader_config=<a string>
: ดูรายละเอียด - ระบุไฟล์ที่จะใช้กำหนดค่าเครื่องมือดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด โดยแต่ละบรรทัดจะขึ้นต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือ 2 รูปแบบ รูปแบบหนึ่งเพื่อจับคู่กับ และอีกแบบหนึ่งใช้เป็น URL แทนโดยมีการอ้างอิงย้อนกลับที่เริ่มจาก "$1" เป็นไปได้ที่คำสั่ง "rewrite" อาจมีผลลัพธ์ใน URL เดียวกันหลายรายการ และระบบจะส่ง URL เดียวกันนี้กลับไปหลายรายการสำหรับ URL เดียวกัน)
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้จัดหมวดหมู่:
- ค่าเริ่มต้นของ
--deleted_packages=<comma-separated list of package names>
: "" - รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริง แม้ว่าจะปรากฏในตำแหน่งใดบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ ตัวอย่างเช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์แล้ว ระบบบิลด์อาจร้องเรียนหากพบป้ายกำกับ "//x:y/z" หากมีป้ายกำกับ "//x:y/z" อยู่หากยังมีรายการ package_path อื่นอยู่ การระบุ --deleted_packages x/y จะหลีกเลี่ยงปัญหานี้
- รวมการใช้งานหลายรายการแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace"
- ค่าเริ่มต้นของ
--package_path=<colon-separated list of options>
: "%workspace%" - รายการที่คั่นด้วยเครื่องหมายทวิภาคของตำแหน่งสำหรับค้นหาแพ็กเกจ องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับพื้นที่ทำงานที่ล้อมรอบอยู่ หากไม่ระบุหรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
- ค่าเริ่มต้นของ
--[no]show_loading_progress
: "จริง" - หากเปิดใช้จะทำให้ Bazel พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ"
ตัวเลือกการทำความสะอาด
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคำสั่งและถูกแยกวิเคราะห์โดยไคลเอ็นต์ ได้แก่
- รวมการใช้งานหลายรายการแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบแคช แทนที่จะคัดลอก โดยมีจุดประสงค์เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่มาจาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม ซึ่งสามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ส่งผลให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_repository_disable_download
: "เท็จ" -
หากมีการตั้งค่า ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองแก้ไขข้อผิดพลาดในการดาวน์โหลดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานได้ในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้นของ
--http_timeout_scaling=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลด HTTP ตามปัจจัยที่กำหนด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูรายละเอียด -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็กbazel_internal_configuration
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่งมีดังนี้
- ค่าเริ่มต้นของ
--[no]async
: "เท็จ" -
หากเป็น "จริง" การล้างเอาต์พุตจะเป็นแบบไม่พร้อมกัน เมื่อคำสั่งนี้เสร็จสมบูรณ์ คุณจะสามารถใช้คำสั่งใหม่ในไคลเอ็นต์เดียวกันได้อย่างปลอดภัย แม้ว่าการลบอาจดำเนินการต่อในเบื้องหลังก็ตาม
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--[no]expunge
: "เท็จ" -
หากเป็น "จริง" ฟีเจอร์ทำความสะอาดจะนำแผนผังการทำงานทั้งหมดของอินสแตนซ์ Bazel นี้ออก ซึ่งรวมถึงไฟล์เอาต์พุตชั่วคราวและบิลด์ที่สร้างขึ้นทั้งหมดของ Bazel และหยุดเซิร์ฟเวอร์ Bazel หากทำงานอยู่
แท็ก:host_machine_resource_optimizations
--expunge_async
-
หากระบุไว้ ให้ลบโครงสร้างการทำงานทั้งหมดของอินสแตนซ์ Bazel แบบไม่พร้อมกันออกทั้งหมด ซึ่งรวมถึงไฟล์ชั่วคราวที่สร้างขึ้นและการสร้างโดย Bazel ทั้งหมด และหยุดเซิร์ฟเวอร์ Bazel หากทำงานอยู่ เมื่อคำสั่งนี้เสร็จสมบูรณ์ คุณจะสามารถใช้คำสั่งใหม่ในไคลเอ็นต์เดียวกันได้อย่างปลอดภัย แม้ว่าการลบอาจดำเนินการต่อในเบื้องหลังก็ตาม
ขยายเป็น
--expunge
--async
แท็ก:host_machine_resource_optimizations
- ค่าเริ่มต้นของ
--[no]remove_all_convenience_symlinks
: "เท็จ" -
หากเป็น "จริง" ระบบจะลบลิงก์สัญลักษณ์ทั้งหมดในพื้นที่ทำงานที่มีคำนำหน้า symlink_prefix หากไม่มีแฟล็กนี้ ระบบจะล้างเฉพาะลิงก์สัญลักษณ์ที่มีคำต่อท้ายที่กำหนดไว้ล่วงหน้าเท่านั้น
แท็ก:affects_outputs
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมของแฟล็ก ฯลฯ)
- ค่าเริ่มต้นของ
--experimental_repository_hash_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรยืนยันแฮชไดเรกทอรีที่เก็บ
แท็ก:affects_outputs
,experimental
- รวมการใช้งานหลายรายการแล้ว
--experimental_verify_repository_rules=<a string>
รายการ -
หากรายการกฎที่เก็บซึ่งควรยืนยันแฮชของไดเรกทอรีเอาต์พุต ระบบจะระบุไฟล์โดย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ API ของบิลด์ที่เข้าถึงได้ด้วยการสร้างไฟล์ .bzl หรือไฟล์ WORKSPACE
- ค่าเริ่มต้นของ
--[no]experimental_allow_top_level_aspects_parameters
: "จริง" -
ไม่ดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
- รวมการใช้งานหลายรายการแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ซึ่งจะอนุญาตให้ใช้ในกราฟการอ้างอิงที่แก้ไขแล้วแม้ว่าจะมีการประกาศว่าได้รับการแย้งในรีจิสทรีที่เป็นแหล่งที่มา (หากเว็บไซต์ไม่ได้มาจาก NonRegistryReplace) มิฉะนั้น เวอร์ชันที่ยัดเยียดจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชัน yank ที่อนุญาตได้ด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" คุณสามารถปิดใช้งานการตรวจสอบนี้ได้โดยใช้คำหลัก "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ หรือ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบว่าข้อมูลไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบที่ไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าทรัพยากร Dependency ดังกล่าวจะถูกละเว้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท โดยไม่คำนึงถึงค่าของแฟล็กนี้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--lockfile_mode=<off, update or error>
: "ปิด" -
ระบุว่าจะใช้ Lockfile อย่างไรและจะใช้หรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ Lockfile และอัปเดตเมื่อมีการเปลี่ยนแปลง "ข้อผิดพลาด" ให้ใช้ Lockfile แต่จะแสดงข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่ออ่านหรือเขียนไฟล์ล็อกทั้ง 2 ไฟล์
แท็ก: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
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งการบันทึกมีดังนี้
- ค่าเริ่มต้นของ
--[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") หรือ 2 รูปแบบ รูปแบบหนึ่งเพื่อจับคู่กับ และอีกแบบหนึ่งใช้เป็น URL แทนโดยมีการอ้างอิงย้อนกลับที่เริ่มจาก "$1" เป็นไปได้ที่คำสั่ง "rewrite" อาจมีผลลัพธ์ใน URL เดียวกันหลายรายการ และระบบจะส่ง URL เดียวกันนี้กลับไปหลายรายการสำหรับ URL เดียวกัน)
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้จัดหมวดหมู่:
- รวมการใช้งานหลายรายการแล้ว
--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
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่มาจาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม ซึ่งสามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ส่งผลให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_repository_disable_download
: "เท็จ" -
หากมีการตั้งค่า ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองแก้ไขข้อผิดพลาดในการดาวน์โหลดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานได้ในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้นของ
--http_timeout_scaling=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลด HTTP ตามปัจจัยที่กำหนด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูรายละเอียด -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตการสร้างที่ถูกต้อง (การกำหนดกฎ การรวมแฟล็ก ฯลฯ)
- ค่าเริ่มต้นของ
--experimental_repository_hash_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรยืนยันแฮชไดเรกทอรีที่เก็บ
แท็ก:affects_outputs
,experimental
- รวมการใช้งานหลายรายการแล้ว
--experimental_verify_repository_rules=<a string>
รายการ -
หากรายการกฎที่เก็บซึ่งควรยืนยันแฮชของไดเรกทอรีเอาต์พุต ระบบจะระบุไฟล์โดย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ API ของบิลด์ที่เข้าถึงได้ด้วยการสร้างไฟล์ .bzl หรือไฟล์ WORKSPACE
- ค่าเริ่มต้นของ
--[no]experimental_allow_top_level_aspects_parameters
: "จริง" -
ไม่ดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
- รวมการใช้งานหลายรายการแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ซึ่งจะอนุญาตให้ใช้ในกราฟการอ้างอิงที่แก้ไขแล้วแม้ว่าจะมีการประกาศว่าได้รับการแย้งในรีจิสทรีที่เป็นแหล่งที่มา (หากเว็บไซต์ไม่ได้มาจาก NonRegistryReplace) มิฉะนั้น เวอร์ชันที่ยัดเยียดจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชัน yank ที่อนุญาตได้ด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" คุณสามารถปิดใช้งานการตรวจสอบนี้ได้โดยใช้คำหลัก "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ หรือ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบว่าข้อมูลไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบที่ไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าทรัพยากร Dependency ดังกล่าวจะถูกละเว้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท โดยไม่คำนึงถึงค่าของแฟล็กนี้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--lockfile_mode=<off, update or error>
: "ปิด" -
ระบุว่าจะใช้ Lockfile อย่างไรและจะใช้หรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ Lockfile และอัปเดตเมื่อมีการเปลี่ยนแปลง "ข้อผิดพลาด" ให้ใช้ Lockfile แต่จะแสดงข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่ออ่านหรือเขียนไฟล์ล็อกทั้ง 2 ไฟล์
แท็ก: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
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งการบันทึกมีดังนี้
- ค่าเริ่มต้นของ
--[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") หรือ 2 รูปแบบ รูปแบบหนึ่งเพื่อจับคู่กับ และอีกแบบหนึ่งใช้เป็น URL แทนโดยมีการอ้างอิงย้อนกลับที่เริ่มจาก "$1" เป็นไปได้ที่คำสั่ง "rewrite" อาจมีผลลัพธ์ใน URL เดียวกันหลายรายการ และระบบจะส่ง URL เดียวกันนี้กลับไปหลายรายการสำหรับ URL เดียวกัน)
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้จัดหมวดหมู่:
- รวมการใช้งานหลายรายการแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace"
ตัวเลือก Query
รับค่าตัวเลือกทั้งหมดจาก test
- ตัวเลือกที่ปรากฏก่อนคำสั่งและถูกแยกวิเคราะห์โดยไคลเอ็นต์ ได้แก่
- รวมการใช้งานหลายรายการแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบแคช แทนที่จะคัดลอก โดยมีจุดประสงค์เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่มาจาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม ซึ่งสามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ส่งผลให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_repository_disable_download
: "เท็จ" -
หากมีการตั้งค่า ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองแก้ไขข้อผิดพลาดในการดาวน์โหลดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานได้ในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้นของ
--http_timeout_scaling=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลด HTTP ตามปัจจัยที่กำหนด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูรายละเอียด -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตการสร้างที่ถูกต้อง (การกำหนดกฎ การรวมแฟล็ก ฯลฯ)
- ค่าเริ่มต้นของ
--experimental_repository_hash_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรยืนยันแฮชไดเรกทอรีที่เก็บ
แท็ก:affects_outputs
,experimental
- รวมการใช้งานหลายรายการแล้ว
--experimental_verify_repository_rules=<a string>
รายการ -
หากรายการกฎที่เก็บซึ่งควรยืนยันแฮชของไดเรกทอรีเอาต์พุต ระบบจะระบุไฟล์โดย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ API ของบิลด์ที่เข้าถึงได้ด้วยการสร้างไฟล์ .bzl หรือไฟล์ WORKSPACE
- ค่าเริ่มต้นของ
--[no]experimental_allow_top_level_aspects_parameters
: "จริง" -
ไม่มีการดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตการค้นหาและความหมาย
- ค่าเริ่มต้นของ
--aspect_deps=<off, conservative or precise>
: "ดั้งเดิม" -
วิธีแก้ไขทรัพยากร Dependency ของสัดส่วนภาพเมื่อรูปแบบเอาต์พุตเป็นหนึ่งใน {xml,ctr,record} "off" หมายถึงไม่มีการสรุปทรัพยากร Dependency "เชิงรับ" (ค่าเริ่มต้น) หมายถึงการเพิ่มทรัพยากร Dependency ที่ประกาศไว้ทั้งหมด โดยไม่คำนึงว่าจะได้รับคลาสกฎของทรัพยากร Dependency โดยตรงหรือไม่ "แม่นยำ" หมายความว่ามีการเพิ่มเฉพาะส่วนที่อาจใช้งานได้ตามคลาสกฎของทรัพยากร Dependency โดยตรง โปรดทราบว่าโหมดความแม่นยำจำเป็นต้องมีการโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียวและทำให้ทำงานช้ากว่าโหมดอื่นๆ นอกจากนี้ โปรดทราบว่าแม้แต่โหมดความแม่นยำก็ไม่แม่นยำทั้งหมด การตัดสินใจว่าจะคำนวณด้านใดด้านหนึ่งหรือไม่นั้น จะตัดสินใจในขั้นตอนการวิเคราะห์ ซึ่งจะไม่ทำงานระหว่าง "การค้นหาแบบ Bazel"
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--[no]consistent_labels
: "เท็จ" -
หากเปิดใช้ คำสั่งการค้นหาทุกรายการจะส่งป้ายกำกับออกมาเสมือนว่าฟังก์ชัน Starlark <code>str</code> ใช้กับอินสแตนซ์ <code>Label</code> ซึ่งจะเป็นประโยชน์สำหรับเครื่องมือที่จำเป็นต้องจับคู่เอาต์พุตของคำสั่งการค้นหาและ/หรือป้ายกำกับต่างๆ ที่กฎเรียกใช้ หากไม่ได้เปิดใช้ ตัวจัดรูปแบบเอาต์พุตจะปล่อยชื่อที่เก็บที่ชัดเจน (สัมพันธ์กับที่เก็บหลัก) แทนเพื่อทำให้เอาต์พุตอ่านได้ง่ายขึ้น
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]graph:factored
: "จริง" -
หากเป็น "จริง" กราฟจะปล่อยออกมาเป็น "แยกส่วน" กล่าวคือ โหนดที่เทียบเคียงกับโทโพโลยีจะถูกผสานเข้าด้วยกันและต่อป้ายกำกับของโหนดต่อกัน ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--graph:node_limit=<an integer>
: "512" -
ความยาวสูงสุดของสตริงป้ายกำกับสำหรับโหนดกราฟในเอาต์พุต ระบบจะตัดป้ายกำกับที่ยาวขึ้น โดย -1 หมายความว่าไม่มีการตัดข้อความ ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]implicit_deps
: "จริง" -
หากเปิดใช้ ทรัพยากร Dependency โดยนัยจะรวมอยู่ในกราฟการอ้างอิงที่การค้นหาดังกล่าวดำเนินการอยู่ ทรัพยากร Dependency โดยนัยคือทรัพยากร Dependency ที่ไม่ได้ระบุอย่างชัดเจนในไฟล์ BUILD แต่เพิ่มโดย Bazel สำหรับ cquery ตัวเลือกนี้ควบคุมการกรองชุดเครื่องมือที่แก้ไขแล้ว
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--[no]include_aspects
: "จริง" -
aquery, cquery: จะรวมการดำเนินการที่สร้างโดยมุมมองในเอาต์พุตหรือไม่ query: no-op (ติดตามด้านต่างๆ เสมอ)
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]incompatible_display_source_file_location
: "จริง" -
"จริง" จะแสดงเป้าหมายของไฟล์ต้นฉบับโดยค่าเริ่มต้น หากเป็น "จริง" จะแสดงตำแหน่งของบรรทัดที่ 1 ของไฟล์ต้นฉบับในเอาต์พุตตำแหน่ง แฟล็กนี้มีไว้เพื่อวัตถุประสงค์ในการย้ายข้อมูลเท่านั้น
แท็ก:terminal_output
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_package_group_includes_double_slash
: "จริง" -
หากเปิดใช้ เมื่อเอาต์พุตแอตทริบิวต์ `packages` ของ package_group จะไม่ละเว้น `//` ที่นำหน้า
แท็ก:terminal_output
,incompatible_change
- ค่าเริ่มต้นของ
--[no]infer_universe_scope
: "เท็จ" -
หากไม่ได้ตั้งค่า และ --universe_scope อยู่ ระบบจะอนุมานค่าของ --universe_scope เป็นรายการรูปแบบเป้าหมายที่ไม่ซ้ำกันในนิพจน์การค้นหา โปรดทราบว่าค่า --universe_scope ที่อนุมานสำหรับนิพจน์การค้นหาที่ใช้ฟังก์ชันขอบเขตระดับจักรวาล (เช่น "allrdeps") อาจไม่ใช่ค่าที่คุณต้องการ คุณจึงควรใช้ตัวเลือกนี้ก็ต่อเมื่อคุณรู้ว่าคุณกำลังทำอะไรอยู่เท่านั้น ดูรายละเอียดและตัวอย่างได้ที่ https://bazel.build/reference/query#sky-query หากตั้งค่า --universe_scope ไว้ ระบบจะไม่พิจารณาค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้มีผลกับ "ข้อความค้นหา" เท่านั้น (กล่าวคือ ไม่ใช่ "cquery")
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]line_terminator_null
: "เท็จ" -
ระบุว่าแต่ละรูปแบบจะลงท้ายด้วย \0 แทนที่จะเป็นบรรทัดใหม่หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]nodep_deps
: "จริง" -
หากเปิดใช้ คำสั่ง deps จาก "nodep" จะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาดังกล่าวดำเนินการอยู่ ตัวอย่างทั่วไปของแอตทริบิวต์ "nodep" คือ "visibility" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ "infobuild-language" เพื่อดูข้อมูลเกี่ยวกับแอตทริบิวต์ "nodep" ทั้งหมดในภาษาบิลด์
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--output=<a string>
: "label" -
รูปแบบที่ควรพิมพ์ผลลัพธ์การค้นหา ค่าที่อนุญาตสำหรับ cquery คือ label, label_kind, textรู้จัก, textโพรโต, การเปลี่ยน, โปรโตคอล, jsonโปรโต หากคุณเลือก "การเปลี่ยน" คุณต้องระบุตัวเลือก --transitions=(lite|full) ด้วย
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:default_values
: "จริง" -
หากเป็น "จริง" ระบบจะรวมแอตทริบิวต์ที่ไม่ได้ระบุค่าไว้อย่างชัดเจนในไฟล์ BUILD มิเช่นนั้นระบบจะละเว้นแอตทริบิวต์เหล่านั้น ตัวเลือกนี้ใช้ได้กับ --เอาต์พุต=โปรโตคอล
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:definition_stack
: "เท็จ" -
ป้อนข้อมูลช่อง Proto คำจำกัดความ ซึ่งจะบันทึกสำหรับอินสแตนซ์ของกฎแต่ละรายการที่สแต็กการเรียกใช้ Starlark ทันทีที่มีการกำหนดคลาสของกฎ
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:flatten_selects
: "จริง" -
หากเปิดใช้ ระบบจะรวมแอตทริบิวต์ที่กำหนดค่าได้ซึ่งสร้างด้วย select() ออก สำหรับประเภทรายการ การนำเสนอแบบรวมคือรายการที่มีแต่ละค่าของแผนที่ที่เลือกเพียงครั้งเดียว ประเภท Scalar จะถูกแบนเป็น Null
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--[no]proto:include_configurations
: "จริง" -
หากเปิดใช้ เอาต์พุตโปรโตจะมีข้อมูลเกี่ยวกับการกำหนดค่า เมื่อปิดใช้ รูปแบบเอาต์พุต Proto ของ cquery จะคล้ายกับรูปแบบเอาต์พุตการค้นหา
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]proto:include_synthetic_attribute_hash
: "เท็จ" -
ระบุว่าจะคำนวณและป้อนข้อมูลแอตทริบิวต์ $internal_attr_hash หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:instantiation_stack
: "เท็จ" -
สร้างสแต็กการเรียกใช้อินสแตนซ์ของแต่ละกฎ โปรดทราบว่าการดำเนินการนี้ต้องมีสแต็ก
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:locations
: "จริง" -
กำหนดว่าจะแสดงข้อมูลตำแหน่งในเอาต์พุต Pro หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--proto:output_rule_attrs=<comma-separated list of options>
: "ทั้งหมด" -
รายการแอตทริบิวต์ที่คั่นด้วยคอมมาที่จะรวมไว้ในเอาต์พุต ค่าเริ่มต้นคือแอตทริบิวต์ทั้งหมด ตั้งค่าเป็นสตริงว่างเพื่อไม่ให้มีแอตทริบิวต์ใดๆ ทั้งสิ้น ตัวเลือกนี้ใช้ได้กับ --เอาต์พุต=โปรโตคอล
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:rule_inputs_and_outputs
: "จริง" -
ระบุว่าจะสร้างช่อง report_input และ rules_เอาต์พุต หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--query_file=<a string>
: "" -
หากตั้งค่าแล้ว การค้นหาจะอ่านการค้นหาจากไฟล์ที่มีชื่อที่นี่ ไม่ใช่ในบรรทัดคำสั่ง ข้อผิดพลาดในการระบุไฟล์ที่นี่ รวมถึงการค้นหาบรรทัดคำสั่ง
แท็ก:changes_inputs
- ค่าเริ่มต้นของ
--[no]relative_locations
: "เท็จ" -
หากเป็นจริง ตำแหน่งของไฟล์ BUILD ใน XML และเอาต์พุตโปรโตจะสัมพันธ์กัน โดยค่าเริ่มต้น เอาต์พุตของตำแหน่งจะเป็นเส้นทางสัมบูรณ์และจะไม่สอดคล้องกันในแต่ละเครื่อง คุณสามารถตั้งตัวเลือกนี้เป็น "จริง" เพื่อให้ผลลัพธ์สอดคล้องกันในคอมพิวเตอร์ทุกเครื่อง
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--show_config_fragments=<off, direct or transitive>
: "ปิด" -
แสดงส่วนย่อยการกำหนดค่าที่กฎและทรัพยากร Dependency เริ่มต้นที่จำเป็น วิธีนี้จะมีประโยชน์ในการประเมินว่ากราฟเป้าหมายที่กำหนดค่าไว้สามารถตัดออกได้มากน้อยเพียงใด
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--starlark:expr=<a string>
: "" -
นิพจน์ Starlark เพื่อจัดรูปแบบเป้าหมายที่กำหนดค่าแต่ละรายการในโหมด --output=starlark ของ cquery เป้าหมายที่กำหนดค่าไว้เชื่อมโยงกับ "target" หากไม่ได้ระบุ --starlark:expr และ --starlark:file ตัวเลือกนี้จะมีค่าเริ่มต้นเป็น "str(target.label)" ข้อผิดพลาดในการระบุทั้ง --starlark:expr และ --starlark:file
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--starlark:file=<a string>
: "" -
ชื่อไฟล์ที่กำหนดฟังก์ชัน Starlark ที่เรียกว่า "format" ของอาร์กิวเมนต์ 1 รายการ ซึ่งจะนำไปใช้กับเป้าหมายที่กำหนดค่าไว้แต่ละรายการเพื่อจัดรูปแบบเป็นสตริง ข้อผิดพลาดในการระบุทั้ง --starlark:expr และ --starlark:file ดูรายละเอียดเพิ่มเติมได้ในความช่วยเหลือเกี่ยวกับ --output=starlark
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]tool_deps
: "จริง" -
คำค้นหา: หากปิดใช้ ทรัพยากร Dependency ของเป้าหมาย "การกำหนดค่าโฮสต์" หรือ "การดำเนินการ" จะไม่รวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาดังกล่าวดำเนินการอยู่ Edge ของทรัพยากร Dependency "การกำหนดค่าโฮสต์" เช่น กฎจากกฎ "Proto_library" ใดก็ตามไปยังโปรโตคอลคอมไพเลอร์ (โปรโตคอลคอมไพเลอร์) มักจะชี้ไปยังเครื่องมือที่ดำเนินการระหว่างการสร้างแทนที่จะเป็นส่วนหนึ่งของโปรแกรม "target" เดียวกัน
ค้นหา: หากปิดใช้ ให้กรองเป้าหมายที่กำหนดค่าไว้ทั้งหมดซึ่งข้ามโฮสต์หรือการเปลี่ยนการดำเนินการจากเป้าหมายระดับบนสุดที่ค้นพบเป้าหมายที่กำหนดค่าไว้นี้ออก ซึ่งหมายความว่าหากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าเป้าหมาย ระบบจะแสดงผลเฉพาะเป้าหมายที่กำหนดค่าในการกำหนดค่าเป้าหมายด้วยเท่านั้น หากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าโฮสต์ ระบบจะแสดงเฉพาะเป้าหมายที่กำหนดค่าไว้ของโฮสต์เท่านั้น ตัวเลือกนี้จะไม่ยกเว้นห่วงโซ่เครื่องมือที่แก้ไขแล้ว
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--transitions=<full, lite or none>
: "ไม่มี" -
รูปแบบที่การค้นหาจะพิมพ์ข้อมูลการเปลี่ยน
แท็ก: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>` ซึ่งจะอนุญาตให้ใช้ในกราฟการอ้างอิงที่แก้ไขแล้วแม้ว่าจะมีการประกาศว่าได้รับการแย้งในรีจิสทรีที่เป็นแหล่งที่มา (หากเว็บไซต์ไม่ได้มาจาก NonRegistryReplace) มิฉะนั้น เวอร์ชันที่ยัดเยียดจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชัน yank ที่อนุญาตได้ด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" คุณสามารถปิดใช้งานการตรวจสอบนี้ได้โดยใช้คำหลัก "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ หรือ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบว่าข้อมูลไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบที่ไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าทรัพยากร Dependency ดังกล่าวจะถูกละเว้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท โดยไม่คำนึงถึงค่าของแฟล็กนี้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--lockfile_mode=<off, update or error>
: "ปิด" -
ระบุว่าจะใช้ Lockfile อย่างไรและจะใช้หรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ Lockfile และอัปเดตเมื่อมีการเปลี่ยนแปลง "ข้อผิดพลาด" ให้ใช้ Lockfile แต่จะแสดงข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่ออ่านหรือเขียนไฟล์ล็อกทั้ง 2 ไฟล์
แท็ก: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
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งการบันทึกมีดังนี้
- ค่าเริ่มต้นของ
--[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") หรือ 2 รูปแบบ รูปแบบหนึ่งเพื่อจับคู่กับ และอีกแบบหนึ่งใช้เป็น URL แทนโดยมีการอ้างอิงย้อนกลับที่เริ่มจาก "$1" เป็นไปได้ที่คำสั่ง "rewrite" อาจมีผลลัพธ์ใน URL เดียวกันหลายรายการ และระบบจะส่ง URL เดียวกันนี้กลับไปหลายรายการสำหรับ URL เดียวกัน)
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้จัดหมวดหมู่:
- รวมการใช้งานหลายรายการแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับรูทของพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace"
- ตัวเลือกที่ควบคุมการดำเนินการของบิลด์
- ค่าเริ่มต้นของ
--[no]experimental_inprocess_symlink_creation
: "เท็จ" -
ไม่ว่าจะเป็นการเรียกใช้ระบบไฟล์โดยตรงเพื่อสร้างต้นไม้ลิงก์สัญลักษณ์
แท็ก:loading_and_analysis
,execution
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_remotable_source_manifests
: "เท็จ" -
ไม่ว่าจะเป็นการทำให้การดำเนินการในไฟล์ Manifest ของแหล่งที่มาทำงานซ้ำได้
แท็ก:loading_and_analysis
,execution
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_split_coverage_postprocessing
: "เท็จ" -
หากเป็น "จริง" Bazel จะเรียกใช้การประมวลผลภายหลังการครอบคลุมเพื่อทดสอบในการวางรูปแบบใหม่
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]experimental_strict_fileset_output
: "เท็จ" -
หากเปิดใช้ตัวเลือกนี้ ชุดไฟล์จะถือว่าอาร์ติแฟกต์เอาต์พุตทั้งหมดเป็นไฟล์ปกติ และจะไม่ข้ามผ่านไดเรกทอรีหรือไวต่อลิงก์สัญลักษณ์
แท็ก:execution
- ค่าเริ่มต้นของ
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
: "" -
เพิ่มหรือนำคีย์ออกจากข้อมูลการดำเนินการของการดำเนินการตามคำสั่งจำเพาะ ใช้กับการดำเนินการที่รองรับข้อมูลการดำเนินการเท่านั้น การดำเนินการทั่วไปหลายรายการรองรับข้อมูลการดำเนินการ เช่น GenRule, CppCompile, Javac, StarlarkAction, TestRunner เมื่อระบุค่าหลายค่า การจัดเรียงจะมีความสำคัญเนื่องจาก regexe หลายรายการอาจใช้กับการช่วยจำเดียวกัน
ไวยากรณ์: "regex=[+-]key,regex=[+-]key,..."
เช่น '.*=+x,.*=-y,.*=+z' จะเพิ่ม "x" และ "z" ลงในและนำ "y" ออกจากข้อมูลการดำเนินการสำหรับการดำเนินการทั้งหมด
"GenRule=+requires-x" เพิ่ม "requires-x" ไปยังข้อมูลการดำเนินการสำหรับการดำเนินการ GenRule ทั้งหมด
"(?!GenRule).*=-requires-x" จะนำ "requires-x" ออกจากข้อมูลการดำเนินการสำหรับการดำเนินการทั้งหมดที่ไม่ใช่ประเภท
แท็ก:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
เปิดใช้ Android Dex และเครื่องมือลดน้ำตาลแบบถาวรโดยใช้ผู้ปฏิบัติงาน
ขยายเป็น
--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
{/1/}
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_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
{/1/}
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
-
เปิดใช้เครื่องมือ Android แบบต่อเนื่องและแบบมัลติเพล็กซ์ (การแยกออก การกรองน้ำตาล การประมวลผลทรัพยากร)
ขยายไปยัง
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
แท็ก:host_machine_resource_optimizations
,execution
- ตัวเลือกที่กำหนดค่าห่วงโซ่เครื่องมือที่ใช้สำหรับการดำเนินการ
- ค่าเริ่มต้น
--android_compiler=<a string>
: ดูรายละเอียด -
คอมไพเลอร์เป้าหมายของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_crosstool_top=<a build target label>
: "//external:android/crosstool" -
ตำแหน่งของคอมไพเลอร์ C++ ที่ใช้สำหรับบิลด์ของ Android
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--android_grte_top=<a label>
: ดูรายละเอียด -
เป้าหมาย Android คือ grte_top
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_manifest_merger=<legacy, android or force_android>
: "android" -
เลือกการผสานไฟล์ Manifest เพื่อใช้กับกฎ android_binary แจ้งเพื่อช่วยในการเปลี่ยนจากการควบรวมกิจการเดิมไปเป็นการ ผสานรวมไฟล์ Manifest ของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--android_platforms=<a build target label>
: "" -
ตั้งค่าแพลตฟอร์มที่เป้าหมายของ android_binary ใช้ หากระบุหลายแพลตฟอร์ม ไบนารีจะเป็น APK แบบอ้วน ซึ่งประกอบด้วยไบนารีแบบเนทีฟสำหรับแต่ละแพลตฟอร์มเป้าหมายที่ระบุ
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/android:sdk"-
ระบุ SDK/แพลตฟอร์ม Android ที่ใช้สร้างแอปพลิเคชัน Android
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--apple_compiler=<a string>
: ดูรายละเอียด -
คอมไพเลอร์เป้าหมายของ Apple มีประโยชน์สำหรับการเลือกตัวแปรของ Toolchain (เช่น xcode-beta)
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้ในกฎ Apple และ Objc รวมถึงทรัพยากร Dependency
แท็ก:loses_incremental_state
,changes_inputs
- ค่าเริ่มต้น
--apple_grte_top=<a build target label>
: ดูรายละเอียด -
เป้าหมายของ Apple คือ grte_top
แท็ก:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--cc_output_directory_tag=<a string>
: "" -
ระบุส่วนต่อท้ายที่จะเพิ่มในไดเรกทอรีการกำหนดค่า
แท็ก:affects_outputs
,explicit_in_output_path
- ค่าเริ่มต้น
--compiler=<a string>
: ดูรายละเอียด -
คอมไพเลอร์ C++ ที่จะใช้สำหรับการคอมไพล์เป้าหมาย
แท็ก:loading_and_analysis
,execution
- ค่าเริ่มต้นของ
--coverage_output_generator=<a build target label>
: "@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_generate" -
ตำแหน่งของไบนารีที่ใช้ในการสร้างรายงานการครอบคลุม ปัจจุบันนี้ต้องเป็นกลุ่มไฟล์ที่มีไฟล์เดี่ยว ซึ่งก็คือไบนารี มีค่าเริ่มต้นเป็น "//tools/test:coverage_report_generate"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/test:coverage_support"-
ตำแหน่งของไฟล์สนับสนุนที่จำเป็นต้องมีในอินพุตของการดำเนินการทดสอบทุกรายการที่รวบรวมความครอบคลุมของโค้ด มีค่าเริ่มต้นเป็น "//tools/test:coverage_support"
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:toolchain"-
ป้ายกำกับของแพ็กเกจ Crosstool ที่จะใช้ในการคอมไพล์โค้ด C++
แท็ก:loading_and_analysis
,changes_inputs
,affects_outputs
- ค่าเริ่มต้น
--custom_malloc=<a build target label>
: ดูรายละเอียด -
ระบุการใช้งาน Malloc ที่กําหนดเอง การตั้งค่านี้จะลบล้างแอตทริบิวต์ Malloc ในกฎบิลด์
แท็ก:changes_inputs
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
รายการ -
รายการนิพจน์ทั่วไปที่คั่นด้วยเครื่องหมายจุลภาค ซึ่งแต่ละรายการจะขึ้นต้นด้วย - (นิพจน์เชิงลบ) ที่กำหนด (=) ให้กับรายการเป้าหมายค่าจำกัดที่คั่นด้วยคอมมา หากเป้าหมายตรงกับไม่มีนิพจน์เชิงลบและนิพจน์เชิงบวกอย่างน้อย 1 รายการจะดำเนินการแก้ปัญหา Toolchain เสมือนได้ประกาศว่าค่าข้อจำกัดเป็นข้อจำกัดการดำเนินการ ตัวอย่างเช่น //demo,-test=@platforms//cpus:x86_64 จะเพิ่ม "x86_64" ไปยังเป้าหมายใดๆ ภายใต้ //demo ยกเว้นชื่อที่มีคำว่า "test"
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]experimental_enable_objc_cc_deps
: "จริง" -
อนุญาตให้กฎ objc_* ขึ้นอยู่กับ cc_library และทำให้มีการสร้างทรัพยากร Dependency ของ objc ด้วย --cpu ที่ตั้งค่าเป็น "ios_<--ios_cpu>" สำหรับค่าใดก็ได้ใน --ios_multi_cpu
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]experimental_include_xcode_execution_requirements
: "เท็จ" -
หากตั้งค่าไว้ ให้เพิ่มข้อกำหนดการดำเนินการ "requires-xcode:{version}" ลงในการดำเนินการ Xcode ทุกรายการ หากเวอร์ชัน xcode มีป้ายกำกับแบบขีดกลาง ให้เพิ่มข้อกำหนดการดำเนินการ "requires-xcode-label:{version_label}" ด้วย
แท็ก:loses_incremental_state
,loading_and_analysis
,execution
- ค่าเริ่มต้นของ
--[no]experimental_prefer_mutual_xcode
: "จริง" -
หากเป็นจริง ให้ใช้ Xcode ล่าสุดที่พร้อมใช้งานทั้งในเครื่องและจากระยะไกล หากเป็น "เท็จ" หรือหากไม่มีเวอร์ชันที่ใช้ร่วมกัน ให้ใช้เวอร์ชัน Xcode ในเครื่องที่เลือกผ่าน xcode-select
แท็ก:loses_incremental_state
- รวมการใช้งานหลายรายการแล้ว
--extra_execution_platforms=<comma-separated list of options>
รายการ -
แพลตฟอร์มที่ใช้เป็นแพลตฟอร์มการดำเนินการเพื่อเรียกใช้การดำเนินการ คุณระบุแพลตฟอร์มตามเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมายก็ได้ เราจะพิจารณาแพลตฟอร์มเหล่านี้ก่อนแพลตฟอร์มที่ประกาศในไฟล์ WORKSPACE โดย registration_execution_platforms()
แท็ก:execution
- รวมการใช้งานหลายรายการแล้ว
--extra_toolchains=<comma-separated list of options>
รายการ -
กฎเชนเครื่องมือที่จะต้องพิจารณาในระหว่างการแก้ปัญหา Toolchain สามารถระบุ Toolchain ตามเป้าหมายที่แน่นอนหรือเป็นรูปแบบเป้าหมายก็ได้ เชนเครื่องมือเหล่านี้จะได้รับการพิจารณาก่อนที่มีการประกาศในไฟล์ WORKSPACE โดย registration_toolchains()
แท็ก ได้แก่affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--grte_top=<a label>
: ดูรายละเอียด -
ป้ายกำกับไปยังไลบรารี 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>
: ดูรายละเอียด -
โดยค่าเริ่มต้น ตัวเลือก --crosstool_top และ --Compositr ยังใช้กับการกำหนดค่าโฮสต์ได้ด้วย หากมีแฟล็กนี้ Bazel จะใช้ libc และคอมไพเลอร์ที่เป็นค่าเริ่มต้นสำหรับ Crosstool_top ที่กำหนด
แท็ก:loading_and_analysis
,changes_inputs
,affects_outputs
- ค่าเริ่มต้น
--host_grte_top=<a label>
: ดูรายละเอียด -
หากระบุ การตั้งค่านี้จะลบล้างไดเรกทอรีระดับบนสุดของ libc (--grte_top) สำหรับการกำหนดค่าโฮสต์
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้นของ
--host_platform=<a build target label>
: "" -
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายระบบโฮสต์
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]incompatible_disable_expand_if_all_available_in_flag_set
: "จริง" -
หากเป็น "จริง" Bazel จะไม่อนุญาตให้ระบุexpand_if_all_available ในFlag_sets(ดูวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/7008)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "จริง" -
หากเป็น "จริง" Bazel จะไม่เปิดใช้ฟีเจอร์ "โฮสต์" และ "ไม่ใช่โฮสต์" ใน Toolchain c++ (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/7407)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_enable_android_toolchain_resolution
: "เท็จ" -
ใช้การแปลงเชนเครื่องมือเพื่อเลือก Android SDK สำหรับกฎของ Android (Starlark และเนทีฟ)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_enable_apple_toolchain_resolution
: "เท็จ" -
ใช้การแปลงเชนเครื่องมือเพื่อเลือก Apple SDK สำหรับกฎของ Apple (Starlark และเนทีฟ)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_make_thinlto_command_lines_standalone
: "จริง" -
หากเป็น "จริง" Bazel จะไม่นำบรรทัดคำสั่งการดำเนินการลิงก์ C++ มาใช้ซ้ำสำหรับบรรทัดคำสั่งการจัดทำดัชนี lto (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/6791)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
: "จริง" -
หากเป็น "จริง" Bazel จะร้องเรียนเมื่อตั้งค่าแอตทริบิวต์ cc_toolchain.cpu และ cc_toolchain.คอมไพเลอร์ (ดูวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/7075)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remove_legacy_whole_archive
: "จริง" -
หากเป็น "จริง" Bazel จะไม่ลิงก์ทรัพยากร Dependency ของไลบรารีเป็นที่เก็บถาวรทั้งหมดโดยค่าเริ่มต้น (ดูวิธีการย้ายข้อมูลที่ https://github.com/bazelbuild/bazel/issues/7362)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_require_ctx_in_configure_features
: "จริง" -
หากเป็น "จริง" Bazel จะต้องใช้พารามิเตอร์ "ctx" ใน cc_common.สตรีม_features (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/7793)
แท็ก:loading_and_analysis
,incompatible_change
-
ใช้ออบเจ็กต์ที่ใช้ร่วมกันของอินเทอร์เฟซหาก Toolchain รองรับ ปัจจุบันชุดเครื่องมือของ ELF ทั้งหมดรองรับการตั้งค่านี้
แท็ก:loading_and_analysis
,affects_outputs
,affects_outputs
- ค่าเริ่มต้น
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
ระบุเวอร์ชันของ iOS SDK ที่จะใช้สร้างแอปพลิเคชัน iOS หากไม่ระบุ ให้ใช้เวอร์ชัน iOS SDK เริ่มต้นจาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
ระบุเวอร์ชันของ macOS SDK ที่จะใช้สร้างแอปพลิเคชัน macOS หากไม่ระบุ ให้ใช้เวอร์ชัน macOS SDK เริ่มต้นจาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--minimum_os_version=<a string>
: ดูรายละเอียด -
เวอร์ชันระบบปฏิบัติการขั้นต่ำที่การคอมไพล์กำหนดเป้าหมาย
แท็ก:loading_and_analysis
,affects_outputs
- ค่าเริ่มต้นของ
--platform_mappings=<a relative path>
: "" -
ตำแหน่งของไฟล์การแมปซึ่งอธิบายว่าจะใช้แพลตฟอร์มใดหากไม่ได้ตั้งค่าไว้ หรือควรตั้งค่าแฟล็กใดเมื่อแพลตฟอร์มมีอยู่แล้ว ต้องสัมพันธ์กับรูทของพื้นที่ทำงานหลัก ค่าเริ่มต้นจะเป็น "platform_mappings" (ไฟล์ใต้รูทของพื้นที่ทํางานโดยตรง)
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--platforms=<a build target label>
: "" -
ป้ายกำกับของกฎแพลตฟอร์มที่อธิบายแพลตฟอร์มเป้าหมายสำหรับคำสั่งปัจจุบัน
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--python2_path=<a string>
: ดูรายละเอียด -
เลิกใช้งาน ปิดใช้ ปิดใช้โดย "--incompatible_use_python_toolchains"
แท็ก:no_op
,deprecated
- ค่าเริ่มต้น
--python3_path=<a string>
: ดูรายละเอียด -
เลิกใช้งาน ปิดใช้ ปิดใช้โดย "--incompatible_use_python_toolchains"
แท็ก:no_op
,deprecated
- ค่าเริ่มต้น
--python_path=<a string>
: ดูรายละเอียด -
มีการเรียกใช้เส้นทางสัมบูรณ์ของล่าม Python เพื่อเรียกใช้เป้าหมาย Python บนแพลตฟอร์มเป้าหมาย เลิกใช้งาน ปิดใช้โดย --incompatible_use_python_toolchains
แท็ก:loading_and_analysis
,affects_outputs
- ค่าเริ่มต้น
--python_top=<a build target label>
: ดูรายละเอียด -
ป้ายกำกับของ py_runtime ที่สื่อถึงอินเทอร์พรีเตอร์ของ Python ถูกเรียกใช้เพื่อเรียกใช้เป้าหมาย Python บนแพลตฟอร์มเป้าหมาย เลิกใช้งาน ปิดใช้โดย --incompatible_use_python_toolchains
แท็ก:loading_and_analysis
,affects_outputs
- ค่าเริ่มต้นของ
--target_platform_fallback=<a build target label>
: "@local_config_platform//:host" -
ป้ายกำกับของกฎแพลตฟอร์มที่ควรใช้หากไม่ได้ตั้งค่าแพลตฟอร์มเป้าหมายและไม่มีการแมปแพลตฟอร์มที่ตรงกับชุดแฟล็กปัจจุบัน
แท็ก:affects_outputs
,changes_inputs
,loading_and_analysis
- ค่าเริ่มต้น
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
ระบุเวอร์ชันของ tvOS SDK ที่จะใช้สร้างแอปพลิเคชัน tvOS หากไม่ระบุ ให้ใช้เวอร์ชัน tvOS SDK เริ่มต้นจาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
ระบุเวอร์ชันของ watchOS SDK ที่จะใช้สร้างแอปพลิเคชัน watchOS หากไม่ระบุ ให้ใช้เวอร์ชัน WatchOS SDK เริ่มต้นจาก "xcode_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--xcode_version=<a string>
: ดูรายละเอียด -
หากระบุไว้ ให้ใช้ Xcode ของเวอร์ชันที่ระบุสำหรับการดำเนินการบิลด์ที่เกี่ยวข้อง หากไม่ระบุ ให้ใช้ Xcode เวอร์ชันเริ่มต้นของไฟล์ปฏิบัติการ
แท็ก:loses_incremental_state
--xcode_version_config=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/cpp:host_xcodes"-
ป้ายกำกับของกฎ xcode_config ที่จะใช้สำหรับเลือกเวอร์ชัน Xcode ในการกำหนดค่าบิลด์
แท็ก:loses_incremental_state
,loading_and_analysis
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่ง มีดังนี้
- ค่าเริ่มต้นของ
--[no]apple_enable_auto_dsym_dbg
: "เท็จ" -
กำหนดว่าจะบังคับให้สร้างไฟล์สัญลักษณ์การแก้ไขข้อบกพร่อง (.dSYM) สำหรับบิลด์ dbg หรือไม่
แท็ก:affects_outputs
,action_command_lines
- ค่าเริ่มต้นของ
--[no]apple_generate_dsym
: "เท็จ" -
ต้องการสร้างไฟล์สัญลักษณ์การแก้ไขข้อบกพร่อง (.dSYM) หรือไม่
แท็ก:affects_outputs
,action_command_lines
- ค่าเริ่มต้นของ
--[no]build_runfile_links
: "จริง" -
หากเป็น "จริง" ให้สร้างฟอเรสต์สัญลักษณ์ซิมลิงก์ของ Runfile สำหรับเป้าหมายทั้งหมด หากเป็น "เท็จ" ให้เขียนเฉพาะไฟล์ Manifest เมื่อเป็นไปได้
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]build_runfile_manifests
: "จริง" -
หากเป็น "จริง" ให้เขียนไฟล์ Manifest สำหรับไฟล์ Manifest สำหรับเป้าหมายทั้งหมด หากเป็นเท็จ ให้ข้าม ทำการทดสอบในเครื่องไม่ได้เมื่อเป็นเท็จ
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]build_test_dwp
: "เท็จ" -
หากเปิดใช้ เมื่อสร้างการทดสอบ C++ แบบคงที่และในการแยกส่วน ระบบจะสร้างไฟล์ .dwp สำหรับไบนารีทดสอบโดยอัตโนมัติด้วยเช่นกัน
แท็ก:loading_and_analysis
,affects_outputs
- ค่าเริ่มต้นของ
--cc_proto_library_header_suffixes=<comma-separated list of options>
: ".pb.h" -
ตั้งค่าคำนำหน้าของไฟล์ส่วนหัวที่ cc_master_library สร้างขึ้น
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--cc_proto_library_source_suffixes=<comma-separated list of options>
: ".pb.cc" -
ตั้งค่าคำนำหน้าของไฟล์ต้นฉบับที่ cc_promo_library สร้างขึ้น
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]experimental_proto_descriptor_sets_include_source_info
: "เท็จ" -
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันสำรองใน proto_library
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_proto_extra_actions
: "เท็จ" -
เรียกใช้การดำเนินการเพิ่มเติมสำหรับ Java API เวอร์ชันสำรองใน proto_library
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_save_feature_state
: "เท็จ" -
บันทึกสถานะของฟีเจอร์ที่เปิดใช้และที่ขอเป็นเอาต์พุตของการคอมไพล์
แท็ก:affects_outputs
,experimental
- ค่าเริ่มต้นของ
--fission=<a set of compilation modes>
: "ไม่" -
ระบุว่าโหมดการรวบรวมใดจะใช้ Fission สำหรับการรวบรวมและลิงก์ C++ อาจเป็นการผสมกันระหว่าง {'fastbuild', 'dbg', 'opt'} หรือค่าพิเศษ "yes" เพื่อเปิดใช้ทุกโหมด และ "no" เพื่อปิดใช้ทุกโหมด
แท็ก:loading_and_analysis
,action_command_lines
,affects_outputs
- ค่าเริ่มต้นของ
--[no]incompatible_always_include_files_in_data
: "จริง" -
หากเป็น "จริง" กฎเนทีฟจะเพิ่ม <code>DefaultInfo.files</code> ของทรัพยากร Dependency ไปยังไฟล์ Runfile ซึ่งตรงกับลักษณะการทํางานที่แนะนำสำหรับกฎ Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid)
แท็ก:affects_outputs
,incompatible_change
- ค่าเริ่มต้นของ
--[no]legacy_external_runfiles
: "จริง" -
หากเป็น "จริง" ให้สร้างฟอเรสต์ลิงก์สัญลักษณ์ของ Runfiles สำหรับที่เก็บภายนอกภายใต้ .runfiles/wsname/external/repo (นอกเหนือจาก .runfiles/repo)
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]objc_generate_linkmap
: "เท็จ" -
ระบุว่าจะสร้างไฟล์ Linkmap หรือไม่
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]save_temps
: "เท็จ" -
หากตั้งค่าไว้ ระบบจะบันทึกเอาต์พุตชั่วคราวจาก gcc ซึ่งได้แก่ ไฟล์ .s (โค้ด Assembler), ไฟล์ .i (ไฟล์ C ที่ประมวลผลไว้ล่วงหน้า) และไฟล์ .ii (C++ ที่ประมวลผลไว้ล่วงหน้า)
แท็ก:affects_outputs
- ตัวเลือกที่ให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการซึ่งส่งผลต่อค่า ตรงข้ามกับที่มีอยู่
- รวมการใช้งานหลายรายการแล้ว
--action_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุชุดตัวแปรสภาพแวดล้อมที่ใช้ได้กับการดำเนินการที่มีการกำหนดค่าเป้าหมาย คุณระบุตัวแปรตามชื่อได้ ซึ่งในกรณีนี้ ค่าจะนำมาจากสภาพแวดล้อมการเรียกใช้ หรือตามคู่ name=value ซึ่งตั้งค่าโดยไม่ขึ้นกับสภาพแวดล้อมการเรียกใช้ ตัวเลือกนี้สามารถใช้ได้หลายครั้ง สำหรับตัวเลือกที่มีให้สำหรับตัวแปรเดียวกัน ตัวเลือกที่ชนะล่าสุด ตัวเลือกสำหรับตัวแปรต่างๆ จะสะสมกัน
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--android_cpu=<a string>
: "armeabi-v7a" -
CPU เป้าหมายของ Android
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--[no]android_databinding_use_androidx
: "เท็จ" -
สร้างไฟล์การเชื่อมโยงข้อมูลที่ใช้กับ AndroidX ได้ ใช้กับการเชื่อมโยงข้อมูล v2 เท่านั้น
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้นของ
--[no]android_databinding_use_v3_4_args
: "เท็จ" -
ใช้ android databinding v2 ที่มีอาร์กิวเมนต์ 3.4.0
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้นของ
--android_dynamic_mode=<off, default or fully>
: "ปิด" -
กำหนดว่าจะลิงก์ Deps C++ ของกฎ Android แบบไดนามิกหรือไม่เมื่อ cc_binary ไม่ได้สร้างไลบรารีที่ใช้ร่วมกันอย่างชัดเจน "ค่าเริ่มต้น" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "เต็มรูปแบบ" หมายความว่าไลบรารีทั้งหมดจะลิงก์แบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "ตามลำดับตัวอักษร" -
กำหนดลำดับของไฟล์ Manifest ที่ส่งไปยังการผสานไฟล์ Manifest สำหรับไบนารี Android ALPHABETical หมายถึงไฟล์ Manifest จะจัดเรียงตามเส้นทางที่สัมพันธ์กับไฟล์ปฏิบัติการ ALPHABETical_BY_CONFIGURATION หมายถึงไฟล์ Manifest จะจัดเรียงตามเส้นทางที่สัมพันธ์กับไดเรกทอรีการกำหนดค่าภายในไดเรกทอรีเอาต์พุต DEPENDENCY หมายถึงไฟล์ Manifest ที่มีการจัดลำดับไฟล์ Manifest ของไลบรารีแต่ละแห่งก่อนไฟล์ Manifest ของทรัพยากร Dependency
แท็ก:action_command_lines
,execution
- ค่าเริ่มต้นของ
--[no]android_resource_shrinking
: "เท็จ" -
เปิดใช้การย่อทรัพยากรสำหรับ APK ของ android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
,loading_and_analysis
- รวมการใช้งานหลายรายการแล้ว
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, visionos, watchos, tvos, macos or catalyst>
รายการ -
ระบุโหมดบิตโค้ดของ Apple สำหรับขั้นตอนการคอมไพล์ขั้นตอนที่กำหนดเป้าหมายสถาปัตยกรรมของอุปกรณ์ ค่าอยู่ในรูปแบบ "[platform=]mode" โดยที่แพลตฟอร์ม (ซึ่งต้องเป็น "ios", "macos", "tvos" หรือ "watchos") เป็นตัวเลือกที่ไม่บังคับ หากระบุ ระบบจะใช้โหมดบิตโค้ดสำหรับแพลตฟอร์มนั้นโดยเฉพาะ หากไม่ระบุ โหมดนี้จะใช้กับทุกแพลตฟอร์ม โหมดต้องเป็น "none", "embedded_markers" หรือ "embedded" ตัวเลือกนี้อาจระบุได้หลายครั้ง
แท็ก:loses_incremental_state
- ค่าเริ่มต้นของ
--[no]build_python_zip
: "อัตโนมัติ" -
สร้างไฟล์ไฟล์ปฏิบัติการ Python ใน Windows ปิดบนแพลตฟอร์มอื่นๆ
แท็ก:affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--catalyst_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาที่จะสร้างไบนารี Apple Catalyst
แท็ก:loses_incremental_state
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]collect_code_coverage
: "เท็จ" -
หากระบุไว้ Bazel จะใช้โค้ดวัดคุม (โดยใช้การวัดคุมแบบออฟไลน์หากเป็นไปได้) และจะรวบรวมข้อมูลการครอบคลุมระหว่างการทดสอบ เฉพาะเป้าหมายที่ตรงกับ --instrumentation_filter เท่านั้นที่จะได้รับผลกระทบ โดยปกติไม่ควรระบุตัวเลือกนี้โดยตรง ควรใช้คำสั่ง 'bazelดีไซน์' แทน
แท็ก:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] ค่าเริ่มต้น: " Fastbuild"-
ระบุโหมดที่จะสร้างไบนารีในตัว ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
,action_command_lines
,explicit_in_output_path
- รวมการใช้งานหลายรายการแล้ว
--conlyopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--copt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้นของ
--cpu=<a string>
: "" -
CPU เป้าหมาย
แท็ก:changes_inputs
,affects_outputs
,explicit_in_output_path
- ค่าเริ่มต้น
--cs_fdo_absolute_path=<a string>
: ดูรายละเอียด -
ใช้ข้อมูลโปรไฟล์ CSFDO เพื่อเพิ่มประสิทธิภาพการรวบรวม ระบุชื่อเส้นทางสัมบูรณ์ของไฟล์ ZIP ที่มีไฟล์โปรไฟล์ ไฟล์ข้อมูล RAW หรือไฟล์โปรไฟล์ LLVM ที่จัดทำดัชนีแล้ว
แท็ก:affects_outputs
- ค่าเริ่มต้น
--cs_fdo_instrument=<a string>
: ดูรายละเอียด -
สร้างไบนารีด้วยเครื่องมือ FDO ที่คำนึงถึงบริบท เมื่อใช้คอมไพเลอร์ Clang/LLVM คอมไพเลอร์จะยอมรับชื่อไดเรกทอรีที่จะใช้ถ่ายโอนไฟล์โปรไฟล์ดิบขณะรันไทม์ด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--cs_fdo_profile=<a build target label>
: ดูรายละเอียด -
cs_fdo_profile ที่แสดงถึงโปรไฟล์ที่คำนึงถึงบริบทเพื่อใช้สำหรับการเพิ่มประสิทธิภาพ
แท็ก:affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--cxxopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C++
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--define=<a 'name=value' assignment>
รายการ -
ตัวเลือก --define แต่ละตัวเลือกจะระบุการมอบหมายสำหรับตัวแปรบิลด์
แท็ก:changes_inputs
,affects_outputs
- ค่าเริ่มต้นของ
--dynamic_mode=<off, default or fully>
: "ค่าเริ่มต้น" -
กำหนดว่าจะลิงก์ไบนารี C++ แบบไดนามิกหรือไม่ "ค่าเริ่มต้น" หมายความว่า Bazel จะเลือกว่าจะลิงก์แบบไดนามิกหรือไม่ "เต็มรูปแบบ" หมายความว่าไลบรารีทั้งหมดจะลิงก์แบบไดนามิก "off" หมายความว่าไลบรารีทั้งหมดจะลิงก์ในโหมดคงที่เป็นส่วนใหญ่
แท็ก:loading_and_analysis
,affects_outputs
- ค่าเริ่มต้นของ
--[no]enable_fdo_profile_absolute_path
: "จริง" -
หากตั้งค่าไว้ การใช้ fdo_absolute_profile_path จะทำให้เกิดข้อผิดพลาด
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]enable_runfiles
: "อัตโนมัติ" -
เปิดใช้โครงสร้าง Symlink ของ Runfiles ซึ่งระบบจะปิดใช้ใน Windows ในแพลตฟอร์มอื่นๆ โดยค่าเริ่มต้น
แท็ก:affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--experimental_action_listener=<a build target label>
รายการ -
เลิกใช้งานเพื่อสนับสนุนแง่มุมต่างๆ ใช้ action_listener เพื่อแนบ external_action เข้ากับการดำเนินการของบิลด์ที่มีอยู่
แท็ก:execution
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_android_compress_java_resources
: "เท็จ" -
บีบอัดทรัพยากร Java ใน APK
แท็ก:affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_android_databinding_v2
: "เท็จ" -
ใช้ Android Databinding v2
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_android_resource_shrinking
: "เท็จ" -
เปิดใช้การย่อทรัพยากรสำหรับ APK ของ android_binary ที่ใช้ ProGuard
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]experimental_android_rewrite_dexes_with_rex
: "เท็จ" -
ใช้เครื่องมือ Rex เพื่อเขียนไฟล์ dex ใหม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_collect_code_coverage_for_generated_files
: "เท็จ" -
หากระบุไว้ Bazel จะสร้างการรวบรวมข้อมูลการครอบคลุมสำหรับไฟล์ที่สร้างขึ้นด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--experimental_objc_fastbuild_options=<comma-separated list of options>
: "-O0,-DDEBUG=1" -
ใช้สตริงเหล่านี้เป็นตัวเลือกคอมไพเลอร์ Fastbuild ของ objc
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--[no]experimental_omitfp
: "เท็จ" -
หากเป็น "จริง" ให้ใช้ libunwind เพื่อคลายการคลายสแต็ก และคอมไพล์ด้วย -fomit-frame-pointer และ -fแบบอะซิงโครนัส-unwind-tables
แท็ก:action_command_lines
,affects_outputs
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_platform_in_output_dir
: "เท็จ" -
หากเป็น "จริง" ระบบจะใช้แพลตฟอร์มเป้าหมายในชื่อไดเรกทอรีเอาต์พุตแทน CPU
แท็ก:affects_outputs
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_use_llvm_covmap
: "เท็จ" -
หากระบุ Bazel จะสร้างข้อมูลแผนที่การครอบคลุม llvm-cov แทน gcov เมื่อเปิดใช้collect_code_coverage
แท็ก:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--fat_apk_cpu=<comma-separated list of options>
: "armeabi-v7a" -
การตั้งค่าตัวเลือกนี้จะเปิดใช้ APK แบบไขมัน ซึ่งมีไบนารีเนทีฟสำหรับสถาปัตยกรรมเป้าหมายที่ระบุทั้งหมด เช่น --fat_apk_cpu=x86,armeabi-v7a. หากมีการระบุแฟล็กนี้ --android_cpu จะถูกละเว้นสำหรับทรัพยากร Dependency ของกฎ android_binary
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--[no]fat_apk_hwasan
: "เท็จ" -
กำหนดว่าจะสร้างการแยก HWASAN หรือไม่
แท็ก:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้น
--fdo_instrument=<a string>
: ดูรายละเอียด -
สร้างไบนารีด้วยการวัดคุม FDO เมื่อใช้คอมไพเลอร์ Clang/LLVM คอมไพเลอร์จะยอมรับชื่อไดเรกทอรีที่จะใช้ถ่ายโอนไฟล์โปรไฟล์ดิบขณะรันไทม์ด้วย
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_optimize=<a string>
: ดูรายละเอียด -
ใช้ข้อมูลโปรไฟล์ FDO เพื่อเพิ่มประสิทธิภาพการรวบรวม ระบุชื่อไฟล์ ZIP ที่มีโครงสร้างไฟล์ .gcda, ไฟล์ afdo ที่มีโปรไฟล์อัตโนมัติ หรือไฟล์โปรไฟล์ LLVM แฟล็กนี้ยังยอมรับไฟล์ที่ระบุเป็นป้ายกำกับด้วย (เช่น `//foo/bar:file.afdo` คุณอาจต้องเพิ่มคำสั่ง "exports_files" ไปยังแพ็กเกจที่เกี่ยวข้อง) และป้ายกำกับที่ชี้ไปยังเป้าหมาย `fdo_profile` ธงนี้จะถูกแทนที่โดยกฎ "fdo_profile"
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_prefetch_hints=<a build target label>
: ดูรายละเอียด -
ใช้คำแนะนำในการดึงข้อมูลแคชล่วงหน้า
แท็ก:affects_outputs
- ค่าเริ่มต้น
--fdo_profile=<a build target label>
: ดูรายละเอียด -
fdo_profile ที่แสดงถึงโปรไฟล์ที่จะใช้ในการเพิ่มประสิทธิภาพ
แท็ก:affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--features=<a string>
รายการ -
ระบบจะเปิดหรือปิดใช้ฟีเจอร์ที่ระบุโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างในการกำหนดค่าเป้าหมาย การระบุ -<feature> จะเป็นการปิดใช้ฟีเจอร์นี้ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ ดู --host_features
แท็ก:changes_inputs
,affects_outputs
- ค่าเริ่มต้นของ
--[no]force_pic
: "เท็จ" -
หากเปิดใช้ การคอมไพล์ C++ ทั้งหมดจะสร้างโค้ดที่ไม่ขึ้นอยู่กับตำแหน่ง ("-fPIC") ลิงก์จะเลือกไลบรารีที่สร้างไว้ล่วงหน้าของ PIC มากกว่าไลบรารีที่ไม่ใช่ PIC และลิงก์จะสร้างไฟล์ปฏิบัติการที่ไม่ขึ้นกับตำแหน่ง ("-pie")
แท็ก:loading_and_analysis
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--host_action_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุชุดตัวแปรสภาพแวดล้อมที่พร้อมใช้งานสำหรับการดำเนินการที่มีการกำหนดค่าโฮสต์หรือการดำเนินการ คุณระบุตัวแปรตามชื่อได้ ซึ่งในกรณีนี้ ค่าจะนำมาจากสภาพแวดล้อมการเรียกใช้ หรือตามคู่ name=value ซึ่งตั้งค่าโดยไม่ขึ้นกับสภาพแวดล้อมการเรียกใช้ ตัวเลือกนี้สามารถใช้ได้หลายครั้ง สำหรับตัวเลือกที่มีให้สำหรับตัวแปรเดียวกัน ตัวเลือกที่ชนะล่าสุด ตัวเลือกสำหรับตัวแปรต่างๆ จะสะสมกัน
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--host_compilation_mode=<fastbuild, dbg or opt>
: "เลือกใช้" -
ระบุโหมดที่จะใช้ในการสร้างเครื่องมือในระหว่างบิลด์ ค่า: 'fastbuild', 'dbg', 'opt'
แท็ก:affects_outputs
,action_command_lines
- รวมการใช้งานหลายรายการแล้ว
--host_conlyopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ C สำหรับเครื่องมือของโฮสต์
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--host_copt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc สำหรับเครื่องมือของโฮสต์
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้นของ
--host_cpu=<a string>
: "" -
CPU ของโฮสต์
แท็ก:changes_inputs
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--host_cxxopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc สำหรับเครื่องมือของโฮสต์
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--host_features=<a string>
รายการ -
ฟีเจอร์ที่ระบุจะเปิดหรือปิดใช้งานโดยค่าเริ่มต้นสำหรับเป้าหมายที่สร้างขึ้นในการกำหนดค่า exec การระบุ -<feature> จะเป็นการปิดใช้ฟีเจอร์นี้ ฟีเจอร์เชิงลบจะลบล้างฟีเจอร์เชิงบวกเสมอ
แท็ก:changes_inputs
,affects_outputs
- ค่าเริ่มต้น
--host_force_python=<PY2 or PY3>
: ดูรายละเอียด -
ลบล้างเวอร์ชัน Python สำหรับการกำหนดค่าโฮสต์ อาจเป็น "PY2" หรือ "PY3"
แท็ก:loading_and_analysis
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--host_linkopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc เมื่อลิงก์เครื่องมือโฮสต์
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้น
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
เวอร์ชัน macOS ขั้นต่ำที่เข้ากันได้สำหรับเป้าหมายโฮสต์ หากไม่ระบุ ให้ใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
- รวมการใช้งานหลายรายการแล้ว
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับเลือกส่งไปยังคอมไพเลอร์ C/C++ เมื่อคอมไพล์บางไฟล์ในการกำหนดค่าโฮสต์หรือโฮสต์ ตัวเลือกนี้สามารถส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจากรายการรูปแบบ "รวม" และ "ยกเว้นนิพจน์ทั่วไป" (ดู --instrumentation_filter ด้วย) Option_1 ถึง Option_n แทนตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบ็กสแลชเข้าไป ตัวเลือกจะมี @ ได้ แต่จะใช้ @ แรกเท่านั้นเพื่อแยกสตริง ตัวอย่างเช่น --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--host_swiftcopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมในการส่งผ่านไปยัง swiftc สำหรับเครื่องมือของโฮสต์
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้นของ
--[no]incompatible_avoid_conflict_dlls
: "จริง" -
หากเปิดใช้ ไลบรารีที่ลิงก์แบบไดนามิกของ C++ (DLL) ทั้งหมดที่ cc_library ใน Windows จะสร้างขึ้นจะเปลี่ยนชื่อเป็น name_{hash}.dll พร้อมกับคำนวณแฮชโดยอิงตาม RepositoryName และเส้นทางแพ็กเกจของ DLL ตัวเลือกนี้จะมีประโยชน์เมื่อคุณมีแพ็กเกจเดียว ซึ่งขึ้นอยู่กับ cc_library หลายรายการที่มีชื่อเดียวกัน (เช่น //foo/bar1:utils และ //foo/bar2:utils)
แท็ก:loading_and_analysis
,affects_outputs
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_merge_genfiles_directory
: "จริง" -
หากเป็น "จริง" ระบบจะพับไดเรกทอรี genfiles ไว้ในไดเรกทอรี Bin
แท็ก:affects_outputs
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_use_host_features
: "เท็จ" -
หากเป็น "จริง" ให้ใช้ --features เฉพาะสำหรับการกำหนดค่าเป้าหมายและ --host_features สำหรับการกำหนดค่าการดำเนินการ
แท็ก:changes_inputs
,affects_outputs
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_use_platforms_repo_for_constraints
: "จริง" -
หากเป็น "จริง" ระบบจะนำการตั้งค่าข้อจำกัดจาก @bazel_tools ออก
แท็ก:affects_outputs
,incompatible_change
- ค่าเริ่มต้นของ
--[no]instrument_test_targets
: "เท็จ" -
เมื่อเปิดใช้การครอบคลุม ให้ระบุว่าจะพิจารณาการใช้กฎการทดสอบหรือไม่ เมื่อตั้งค่าแล้ว กฎการทดสอบที่ --instrumentation_filter รวมไว้จะถูกวัดคุม มิฉะนั้น กฎทดสอบจะถูกยกเว้นจากการวัดคุมการครอบคลุมเสมอ
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-/javatests[/:],-/test/java[/:]" -
เมื่อเปิดใช้การครอบคลุม จะมีการใช้เฉพาะกฎที่มีชื่อซึ่งตัวกรองที่อิงตามนิพจน์ทั่วไปที่ระบุเท่านั้น กฎที่ขึ้นต้นด้วย '-' จะถูกยกเว้นแทน โปรดทราบว่าจะมีการวัดเฉพาะกฎที่ไม่ใช่การทดสอบเท่านั้น เว้นแต่จะเปิดใช้ --instrument_test_targets
แท็ก:affects_outputs
- ค่าเริ่มต้น
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
เวอร์ชัน iOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองและอุปกรณ์เป้าหมาย หากไม่ระบุ ให้ใช้ "ios_sdk_version"
แท็ก:loses_incremental_state
- รวมการใช้งานหลายรายการแล้ว
--ios_multi_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้าง ios_application ผลลัพธ์คือไบนารีสากลที่มีสถาปัตยกรรมที่ระบุทั้งหมด
แท็ก:loses_incremental_state
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]legacy_whole_archive
: "จริง" -
เลิกใช้งาน ซึ่งถูกแทนที่โดย --incompatible_remove_legacy_whole_archive (ดูรายละเอียดที่ https://github.com/bazelbuild/bazel/issues/7362) เมื่อเปิด ให้ใช้ --whole-archive สำหรับกฎ cc_binary ที่มี linkshared=True และ linkstatic=True หรือ "-static" ใน linkopts มีไว้สำหรับความเข้ากันได้แบบย้อนหลังเท่านั้น ทางเลือกที่ดีกว่าคือการใช้ Alwayslink=1 เมื่อจำเป็น
แท็ก:action_command_lines
,affects_outputs
,deprecated
- รวมการใช้งานหลายรายการแล้ว
--linkopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc เมื่อลิงก์
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--ltobackendopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังขั้นตอนแบ็กเอนด์ของ LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--ltoindexopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังขั้นตอนการจัดทำดัชนี LTO (ในส่วน --features=thin_lto)
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--macos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับสร้างไบนารีของ Apple macOS
แท็ก:loses_incremental_state
,loading_and_analysis
- ค่าเริ่มต้น
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
เวอร์ชัน macOS ขั้นต่ำที่เข้ากันได้สำหรับเป้าหมาย หากไม่ระบุ ให้ใช้ "macos_sdk_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้นของ
--[no]objc_debug_with_GLIBCXX
: "เท็จ" -
หากตั้งค่าและตั้งค่าโหมดการรวบรวมเป็น "dbg" ให้กำหนด GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC และ GLIBCPP_CONCEPT_CheckS
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--[no]objc_enable_binary_stripping
: "เท็จ" -
กำหนดว่าจะดำเนินการตัดสัญลักษณ์และถอดรหัสแบบเดดโค้ดในไบนารีที่ลิงก์หรือไม่ จะมีการดำเนินการตัดไบนารีหากมีการระบุทั้ง Flag และ --compilation_mode=opt นี้
แท็ก:action_command_lines
- รวมการใช้งานหลายรายการแล้ว
--objccopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง gcc เมื่อคอมไพล์ไฟล์ต้นฉบับ Objective-C/C++
แท็ก:action_command_lines
- รวมการใช้งานหลายรายการแล้ว
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมในการเลือกส่งผ่านไปยัง gcc เมื่อคอมไพล์บางไฟล์ ตัวเลือกนี้สามารถส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n โดยที่ regex_filter ย่อมาจากรายการรูปแบบ "รวม" และ "ยกเว้นนิพจน์ทั่วไป" (ดู --instrumentation_filter ด้วย) Option_1 ถึง Option_n แทนตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบ็กสแลชเข้าไป ตัวเลือกจะมี @ ได้ แต่จะใช้ @ แรกเท่านั้นเพื่อแยกสตริง ตัวอย่างเช่น --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ในบรรทัดคำสั่ง gcc ของไฟล์ cc ทั้งหมดใน //foo/ ยกเว้น bar.cc
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
รายการ -
ตัวเลือกเพิ่มเติมเพื่อเลือกส่งผ่านไปยังแบ็กเอนด์ LTO (ในส่วน --features=thin_lto) เมื่อคอมไพล์ออบเจ็กต์แบ็กเอนด์บางรายการ ตัวเลือกนี้สามารถส่งได้หลายครั้ง ไวยากรณ์: regex_filter@option_1,option_2,...,option_n ที่ regex_filter คือรายการรูปแบบการรวมและยกเว้นนิพจน์ทั่วไป Option_1 ถึง Option_n แทนตัวเลือกบรรทัดคำสั่งที่กำหนดเอง หากตัวเลือกมีเครื่องหมายจุลภาค คุณจะต้องใส่เครื่องหมายแบ็กสแลชเข้าไป ตัวเลือกจะมี @ ได้ แต่จะใช้ @ แรกเท่านั้นเพื่อแยกสตริง ตัวอย่างเช่น --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 เพิ่มตัวเลือกบรรทัดคำสั่ง -O0 ลงในบรรทัดคำสั่งแบ็กเอนด์ LTO ของไฟล์ o ทั้งหมดใน //foo/ ยกเว้น bar.o
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้น
--platform_suffix=<a string>
: ดูรายละเอียด -
ระบุส่วนต่อท้ายที่จะเพิ่มในไดเรกทอรีการกำหนดค่า
แท็ก:loses_incremental_state
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้น
--propeller_optimize=<a build target label>
: ดูรายละเอียด -
ใช้ข้อมูลโปรไฟล์ Propeller เพื่อเพิ่มประสิทธิภาพเป้าหมายของบิลด์ โปรไฟล์ใบพัดต้องมีอย่างน้อย 1 จาก 2 ไฟล์ โปรไฟล์ 1 ใน 2 ไฟล์ และโปรไฟล์ ld แฟล็กนี้ยอมรับป้ายกำกับบิลด์ซึ่งต้องอ้างอิงถึงไฟล์อินพุตโปรไฟล์ใบพัด ตัวอย่างเช่น ไฟล์ BUILD ที่กำหนดป้ายกำกับใน a/b/BUILD:profeller_ optimize( name = "profeller_profile", cc_profile = "profeller_cc_profile.txt", ld_profile = "profeller_ld_profile.txt",)เพิ่มคำสั่ง export_files ลงในแพ็กเกจที่เกี่ยวข้องเพื่อให้ Bazel ดูไฟล์เหล่านี้ได้ ต้องใช้ตัวเลือกเป็น --profeller_Optimize=//a/b:profeller_profile
แท็ก:action_command_lines
,affects_outputs
- ค่าเริ่มต้น
--propeller_optimize_absolute_cc_profile=<a string>
: ดูรายละเอียด -
ชื่อเส้นทางสัมบูรณ์ของไฟล์ cc_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพของ Propeller
แท็ก:affects_outputs
- ค่าเริ่มต้น
--propeller_optimize_absolute_ld_profile=<a string>
: ดูรายละเอียด -
ชื่อเส้นทางสัมบูรณ์ของไฟล์ ld_profile สำหรับบิลด์ที่เพิ่มประสิทธิภาพ Propeller
แท็ก:affects_outputs
- ค่าเริ่มต้น
--run_under=<a prefix in front of command>
: ดูรายละเอียด -
คำนำหน้าที่จะแทรกหน้าไฟล์ปฏิบัติการสำหรับคำสั่ง "test" และ "run" หากค่าเป็น "foo -bar" และบรรทัดคำสั่งการดำเนินการคือ "test_binary -baz" บรรทัดคำสั่งสุดท้ายจะเป็น "foo -bar test_binary -baz" บรรทัดนี้อาจเป็นป้ายกำกับของเป้าหมายปฏิบัติการด้วย ตัวอย่างเช่น: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'
แท็ก:action_command_lines
-
หากเป็นจริง ระบบจะแชร์ไลบรารีแบบเนทีฟที่มีฟังก์ชันการทำงานเหมือนกันกับเป้าหมายต่างๆ
แท็กต่อไปนี้loading_and_analysis
,affects_outputs
- ค่าเริ่มต้นของ
--[no]stamp
: "เท็จ" -
ประทับไบนารีด้วยวันที่ ชื่อผู้ใช้ ชื่อโฮสต์ ข้อมูลพื้นที่ทำงาน ฯลฯ
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--strip=<always, sometimes or never>
: "บางครั้ง" -
ระบุว่าจะตัดไบนารีและไลบรารีที่แชร์หรือไม่ (โดยใช้ "-Wl,--strip-debug") ค่าเริ่มต้นเป็น "sometimes" หมายถึง Strip iff --compilation_mode=fastbuild
แท็ก:affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--stripopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง Strip เมื่อสร้างไบนารี "<name>.strped"
แท็ก:action_command_lines
,affects_outputs
- รวมการใช้งานหลายรายการแล้ว
--swiftcopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังการคอมไพล์ Swift
แท็ก:action_command_lines
- รวมการใช้งานหลายรายการแล้ว
--tvos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับการสร้างไบนารี Apple tvOS
แท็ก:loses_incremental_state
,loading_and_analysis
- ค่าเริ่มต้น
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
เวอร์ชัน tvOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองและอุปกรณ์เป้าหมาย หากไม่ระบุ ให้ใช้ "tvos_sdk_version"
แท็ก:loses_incremental_state
- รวมการใช้งานหลายรายการแล้ว
--visionos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับการสร้างไบนารี Apple visionOS
แท็ก:loses_incremental_state
,loading_and_analysis
- รวมการใช้งานหลายรายการแล้ว
--watchos_cpus=<comma-separated list of options>
รายการ -
รายการสถาปัตยกรรมที่คั่นด้วยคอมมาสำหรับการสร้างไบนารี Apple WatchOS
แท็ก:loses_incremental_state
,loading_and_analysis
- ค่าเริ่มต้น
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
เวอร์ชัน WatchOS ขั้นต่ำที่เข้ากันได้สำหรับเครื่องจำลองและอุปกรณ์เป้าหมาย หากไม่ระบุ ให้ใช้ "watchos_sdk_version"
แท็ก:loses_incremental_state
- ค่าเริ่มต้น
--xbinary_fdo=<a build target label>
: ดูรายละเอียด -
ใช้ข้อมูลโปรไฟล์ XbinaryFDO เพื่อเพิ่มประสิทธิภาพการรวบรวม ระบุชื่อของโปรไฟล์ไบนารีแบบข้ามที่เป็นค่าเริ่มต้น เมื่อใช้ตัวเลือกนี้ร่วมกับ --fdo_instrument/--fdo_optimize/--fdo_profile ตัวเลือกเหล่านั้นจะมีผลเหนือกว่าเสมอเสมือนว่าไม่ได้ระบุ xbinary_fdo
แท็ก:affects_outputs
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมของแฟล็ก ฯลฯ)
- ค่าเริ่มต้นของ
--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
: "จริง" -
หากปิดใช้ ข้อผิดพลาดในการแสดงผลในทรัพยากร Dependency เป้าหมายจะถูกลดระดับเป็นคำเตือน
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--[no]desugar_for_android
: "จริง" -
ไม่ว่าจะถอดรหัสไบต์โค้ด 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
: "จริง" -
ตรวจสอบสภาพแวดล้อมที่แต่ละเป้าหมายใช้งานร่วมกันได้ และรายงานข้อผิดพลาดหากเป้าหมายใดมีทรัพยากร Dependency ที่ไม่รองรับสภาพแวดล้อมเดียวกัน
แท็กมีดังนี้build_file_semantics
- ค่าเริ่มต้นของ
--[no]experimental_allow_android_library_deps_without_srcs
: "เท็จ" -
แจ้งเพื่อช่วยเปลี่ยนจากการอนุญาตเป็นไม่อนุญาตกฎ android_library แบบไม่มี srcs-less ที่มี deps ต้องล้างข้อมูล Depot เพื่อเปิดตัวการเปลี่ยนแปลงนี้โดยค่าเริ่มต้น
แท็ก:eagerness_to_exit
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]experimental_check_desugar_deps
: "จริง" -
ต้องการตรวจสอบการกำจัดน้ำตาลอย่างถูกต้องอีกครั้งที่ระดับไบนารีของ Android
แท็ก:eagerness_to_exit
,loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--experimental_import_deps_checking=<off, warning or error>
: "ปิด" -
เมื่อเปิดใช้ ให้ตรวจสอบว่าทรัพยากร Dependency ของ aar_import สมบูรณ์หรือไม่ การบังคับใช้นี้อาจทำให้บิลด์เสียหายหรืออาจส่งผลให้มีคำเตือนได้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "ค่าเริ่มต้น" -
หากเป็น "จริง" ให้ตรวจสอบว่าเป้าหมาย Java ประกาศเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency อย่างชัดเจน
แท็ก:build_file_semantics
,eagerness_to_exit
- ค่าเริ่มต้นของ
--[no]incompatible_check_testonly_for_output_files
: "เท็จ" -
หากเปิดใช้ไว้ ให้ตรวจสอบ testonly สำหรับเป้าหมายเบื้องต้นที่เป็นไฟล์เอาต์พุตโดยค้นหาเฉพาะ testonly ของกฎที่สร้างขึ้น ข้อมูลนี้ตรงกับการตรวจสอบการแสดงผล
แท็ก:build_file_semantics
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_disable_native_android_rules
: "เท็จ" -
หากเปิดใช้ ระบบจะปิดใช้การใช้งานกฎ Android แบบดั้งเดิมโดยตรง โปรดใช้กฎของ Starlark Android จาก https://github.com/bazelbuild/rules_android
แท็ก:eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_disable_native_apple_binary_rule
: "เท็จ" -
ไม่มีการดำเนินการ โปรดเก็บไว้ที่นี่เพื่อดูความเข้ากันได้แบบย้อนหลัง
แท็ก:eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_force_strict_header_check_from_starlark
: "จริง" -
หากเปิดใช้ ให้ตั้งค่าการตรวจสอบส่วนหัวที่เข้มงวดใน Starlark API
แท็กดังนี้loading_and_analysis
,changes_inputs
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_validate_top_level_header_inclusions
: "จริง" -
หากเป็น "จริง" Bazel จะตรวจสอบการรวมส่วนหัวของไดเรกทอรีระดับบนสุดด้วย (ดูข้อมูลเพิ่มเติมได้ที่ https://github.com/bazelbuild/bazel/issues/10047)
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]strict_filesets
: "เท็จ" -
หากเปิดใช้ตัวเลือกนี้ ระบบจะรายงานชุดไฟล์ที่ข้ามขอบเขตของแพ็กเกจว่าเป็นข้อผิดพลาด ซึ่งจะใช้งานไม่ได้เมื่อปิดใช้ check_fileset_dependencies_recursively
แท็ก:build_file_semantics
,eagerness_to_exit
- ค่าเริ่มต้นของ
--strict_proto_deps=<off, warn, error, strict or default>
: "ข้อผิดพลาด" -
หากไม่ปิด ให้ตรวจสอบว่าเป้าหมาย protocol_library ประกาศเป้าหมายที่ใช้โดยตรงทั้งหมดเป็นทรัพยากร Dependency อย่างชัดเจน
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้นของ
--strict_public_imports=<off, warn, error, strict or default>
: "ปิด" -
หากไม่ "ปิด" ให้ตรวจสอบว่าเป้าหมาย proto_library ประกาศเป้าหมายทั้งหมดที่ใช้ใน "นําเข้าแบบสาธารณะ" อย่างชัดเจนเป็น "ส่งออก"
แท็ก:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ค่าเริ่มต้นของ
--[no]strict_system_includes
: "เท็จ" -
หากเป็น "จริง" จะต้องประกาศส่วนหัวที่พบในเส้นทาง (-isystem) ด้วย
แท็ก:loading_and_analysis
,eagerness_to_exit
- รวมการใช้งานหลายรายการแล้ว
--target_environment=<a build target label>
รายการ -
ประกาศสภาพแวดล้อมเป้าหมายของบิลด์นี้ ต้องเป็นการอ้างอิงป้ายกำกับไปยังกฎ "สภาพแวดล้อม" หากระบุไว้ เป้าหมายระดับบนสุดทั้งหมดต้องเข้ากันได้กับสภาพแวดล้อมนี้
แท็ก:changes_inputs
- ตัวเลือกที่ส่งผลต่อเอาต์พุตการลงชื่อเข้าใช้ของบิลด์
- ค่าเริ่มต้นของ
--apk_signing_method=<v1, v2, v1_v2 or v4>
: "v1_v2" -
การใช้งานเพื่อรับรอง APK
แท็กมีดังนี้action_command_lines
,affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]device_debug_entitlements
: "จริง" -
หากตั้งค่าและโหมดการรวบรวมไม่ใช่ "เลือกใช้" แอป objc จะมีการให้สิทธิ์การแก้ไขข้อบกพร่องเมื่อลงชื่อเข้าใช้
แท็ก:changes_inputs
- ค่าเริ่มต้น
--ios_signing_cert_name=<a string>
: ดูรายละเอียด -
ชื่อใบรับรองที่จะใช้สำหรับการลงนาม iOS หากไม่ได้ตั้งค่า ระบบจะกลับไปใช้โปรไฟล์การจัดสรร อาจเป็นค่ากำหนดข้อมูลประจำตัว Keychain ของใบรับรองหรือ (สตริงย่อย) ของชื่อจริงของใบรับรอง ตามหน้า man ของ Codesign (SIGNING IDENTITIES)
แท็ก:action_command_lines
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ Build API ที่เข้าถึงได้โดยไฟล์ BUILD, ไฟล์ .bzl หรือไฟล์ WORKSPACE
- ค่าเริ่มต้นของ
--[no]incompatible_disallow_legacy_py_provider
: "จริง" -
ไม่มีการดำเนินการ และจะถูกนำออกในเร็วๆ นี้
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่ควบคุมลักษณะการทำงานของสภาพแวดล้อมการทดสอบหรือตัวดำเนินการทดสอบมีดังนี้
- ค่าเริ่มต้นของ
--[no]allow_analysis_failures
: "เท็จ" -
หากเป็นจริง การวิเคราะห์เป้าหมายกฎไม่สำเร็จจะส่งผลให้มีการเผยแพร่อินสแตนซ์ของ AnalysisFailureInfo ที่มีคำอธิบายข้อผิดพลาด แทนที่จะทำให้บิลด์ล้มเหลว
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--analysis_testing_deps_limit=<an integer>
: "2000" -
กำหนดจำนวนสูงสุดของทรัพยากร Dependency แบบเปลี่ยนผ่านผ่านแอตทริบิวต์กฎที่มีการเปลี่ยนการกำหนดค่า for_analysis_testing การเกินขีดจำกัดนี้จะทำให้เกิดข้อผิดพลาดเกี่ยวกับกฎ
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]break_build_on_parallel_dex2oat_failure
: "เท็จ" -
หากการดำเนินการ Dex2oat ไม่สำเร็จจะทำให้บิลด์ขัดข้องแทนการเรียกใช้ Dex2oat ระหว่างรันไทม์ของการทดสอบ
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_android_use_parallel_dex2oat
: "เท็จ" -
ใช้ dex2oat ควบคู่กันเพื่อเพิ่มความเร็ว android_test
แท็ก:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- ค่าเริ่มต้นของ
--[no]ios_memleaks
: "เท็จ" -
เปิดใช้การตรวจหาการรั่วไหลของหน่วยความจำในเป้าหมาย ios_test
แท็ก:action_command_lines
- ค่าเริ่มต้น
--ios_simulator_device=<a string>
: ดูรายละเอียด -
อุปกรณ์ที่จะจำลองเมื่อเรียกใช้แอปพลิเคชัน iOS ในเครื่องมือจำลอง เช่น "iPhone 6" คุณสามารถดูรายการอุปกรณ์โดยเรียกใช้ "xcrun simctl list devicetypes" ในเครื่องที่จะเรียกใช้เครื่องจำลอง
แท็ก:test_runner
- ค่าเริ่มต้น
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
เวอร์ชันของ iOS ที่จะเรียกใช้ในเครื่องจำลองเมื่อเรียกใช้หรือทดสอบ โดยจะไม่พิจารณากฎ ios_test หากมีการระบุอุปกรณ์เป้าหมายในกฎ
แท็ก:test_runner
- รวมการใช้งานหลายรายการแล้ว
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
รายการ - ระบุจำนวนครั้งที่จะทำการทดสอบแต่ละครั้ง หากความพยายามอันใดอันหนึ่งล้มเหลวไม่ว่าด้วยเหตุผลใดก็ตาม ระบบจะถือว่าการทดสอบทั้งหมดไม่ผ่าน โดยปกติแล้วค่าที่ระบุจะเป็นจำนวนเต็ม ตัวอย่าง: --runs_per_test=3 จะทำการทดสอบทั้งหมด 3 ครั้ง ไวยากรณ์ทางเลือก: regex_filter@runs_per_test ตัวอย่าง: --runs_per_test=//foo/.*,-//foo/bar/.*@3 เรียกใช้การทดสอบทั้งหมดใน //foo/ ยกเว้นการทดสอบภายใต้ foo/bar 3 ครั้ง ตัวเลือกนี้สามารถส่งได้หลายครั้ง อาร์กิวเมนต์ที่ส่งผ่านล่าสุดที่ตรงกันจะมีความสำคัญเหนือกว่า หากไม่มีอะไรตรงกัน การทดสอบจะทำงานเพียงครั้งเดียว
- รวมการใช้งานหลายรายการแล้ว
--test_env=<a 'name=value' assignment with an optional value part>
รายการ -
ระบุตัวแปรสภาพแวดล้อมเพิ่มเติมที่จะแทรกในสภาพแวดล้อมตัวดำเนินการทดสอบ สามารถระบุตัวแปรตามชื่อ ซึ่งในกรณีนี้ระบบจะอ่านค่าจากสภาพแวดล้อมไคลเอ็นต์ Bazel หรือโดยคู่ name=value สามารถใช้ตัวเลือกนี้ได้หลายครั้งเพื่อระบุตัวแปรหลายตัว ใช้โดยคำสั่ง 'bazel test' เท่านั้น
แท็ก:test_runner
- ค่าเริ่มต้นของ
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - ลบล้างค่าระยะหมดเวลาทดสอบเริ่มต้นสำหรับระยะหมดเวลาทดสอบ (เป็นวินาที) หากระบุค่าจำนวนเต็มบวกค่าเดียว ค่านั้นจะลบล้างหมวดหมู่ทั้งหมด หากระบุจำนวนเต็มที่คั่นด้วยจุลภาค 4 ตัว ค่าเหล่านั้นจะลบล้างระยะหมดเวลาสำหรับระยะสั้น ปานกลาง ยาว และตลอดไป (ตามลำดับนั้น) ไม่ว่าจะในรูปแบบใด ค่า -1 จะบอกให้ Blaze ใช้ระยะหมดเวลาเริ่มต้นสำหรับหมวดหมู่นั้น
- ค่าเริ่มต้น
--tvos_simulator_device=<a string>
: ดูรายละเอียด -
อุปกรณ์ที่จะจำลองเมื่อเรียกใช้แอปพลิเคชัน tvOS ในเครื่องมือจำลอง เช่น "Apple TV 1080p" คุณสามารถดูรายการอุปกรณ์โดยเรียกใช้ "xcrun simctl list devicetypes" ในเครื่องที่จะเรียกใช้เครื่องจำลอง
แท็ก:test_runner
- ค่าเริ่มต้น
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
เวอร์ชันของ tvOS ที่จะเรียกใช้ในเครื่องจำลองเมื่อเรียกใช้หรือทดสอบ
แท็ก:test_runner
- ค่าเริ่มต้น
--watchos_simulator_device=<a string>
: ดูรายละเอียด -
อุปกรณ์ที่จะจำลองเมื่อเรียกใช้แอปพลิเคชัน watchOS ในเครื่องมือจำลอง เช่น "Apple Watch - 38 มม." คุณสามารถดูรายการอุปกรณ์โดยเรียกใช้ "xcrun simctl list devicetypes" ในเครื่องที่จะเรียกใช้เครื่องจำลอง
แท็ก:test_runner
- ค่าเริ่มต้น
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: ดูรายละเอียด -
เวอร์ชันของ watchOS ที่จะเรียกใช้ในเครื่องมือจำลองเมื่อเรียกใช้หรือทดสอบ
แท็ก:test_runner
- ค่าเริ่มต้นของ
--[no]zip_undeclared_test_outputs
: "จริง" -
หากเป็น "จริง" ระบบจะเก็บผลลัพธ์การทดสอบที่ไม่ได้ประกาศไว้ในไฟล์ ZIP
แท็กtest_runner
- ตัวเลือกที่เกี่ยวข้องกับผลลัพธ์การค้นหาและความหมาย
- ค่าเริ่มต้นของ
--aspect_deps=<off, conservative or precise>
: "ดั้งเดิม" -
วิธีแก้ไขทรัพยากร Dependency ของสัดส่วนภาพเมื่อรูปแบบเอาต์พุตเป็นหนึ่งใน {xml,ctr,record} "off" หมายถึงไม่มีการสรุปทรัพยากร Dependency "เชิงรับ" (ค่าเริ่มต้น) หมายถึงการเพิ่มทรัพยากร Dependency ที่ประกาศไว้ทั้งหมด โดยไม่คำนึงว่าจะได้รับคลาสกฎของทรัพยากร Dependency โดยตรงหรือไม่ "แม่นยำ" หมายความว่ามีการเพิ่มเฉพาะส่วนที่อาจใช้งานได้ตามคลาสกฎของทรัพยากร Dependency โดยตรง โปรดทราบว่าโหมดความแม่นยำจำเป็นต้องมีการโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียวและทำให้ทำงานช้ากว่าโหมดอื่นๆ นอกจากนี้ โปรดทราบว่าแม้แต่โหมดความแม่นยำก็ไม่แม่นยำทั้งหมด การตัดสินใจว่าจะคำนวณด้านใดด้านหนึ่งหรือไม่นั้น จะตัดสินใจในขั้นตอนการวิเคราะห์ ซึ่งจะไม่ทำงานระหว่าง "การค้นหาแบบ Bazel"
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--[no]consistent_labels
: "เท็จ" -
หากเปิดใช้ คำสั่งการค้นหาทุกรายการจะส่งป้ายกำกับออกมาเสมือนว่าฟังก์ชัน Starlark <code>str</code> ใช้กับอินสแตนซ์ <code>Label</code> ซึ่งจะเป็นประโยชน์สำหรับเครื่องมือที่จำเป็นต้องจับคู่เอาต์พุตของคำสั่งการค้นหาและ/หรือป้ายกำกับต่างๆ ที่กฎเรียกใช้ หากไม่ได้เปิดใช้ ตัวจัดรูปแบบเอาต์พุตจะปล่อยชื่อที่เก็บที่ชัดเจน (สัมพันธ์กับที่เก็บหลัก) แทนเพื่อทำให้เอาต์พุตอ่านได้ง่ายขึ้น
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]graph:factored
: "จริง" -
หากเป็น "จริง" กราฟจะปล่อยออกมาเป็น "แยกส่วน" กล่าวคือ โหนดที่เทียบเคียงกับโทโพโลยีจะถูกผสานเข้าด้วยกันและต่อป้ายกำกับของโหนดต่อกัน ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--graph:node_limit=<an integer>
: "512" -
ความยาวสูงสุดของสตริงป้ายกำกับสำหรับโหนดกราฟในเอาต์พุต ระบบจะตัดป้ายกำกับที่ยาวขึ้น โดย -1 หมายความว่าไม่มีการตัดข้อความ ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]implicit_deps
: "จริง" -
หากเปิดใช้ ทรัพยากร Dependency โดยนัยจะรวมอยู่ในกราฟการอ้างอิงที่การค้นหาดังกล่าวดำเนินการอยู่ ทรัพยากร Dependency โดยนัยคือทรัพยากร Dependency ที่ไม่ได้ระบุอย่างชัดเจนในไฟล์ BUILD แต่เพิ่มโดย Bazel สำหรับ cquery ตัวเลือกนี้ควบคุมการกรองชุดเครื่องมือที่แก้ไขแล้ว
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--[no]include_aspects
: "จริง" -
aquery, cquery: จะรวมการดำเนินการที่สร้างโดยมุมมองในเอาต์พุตหรือไม่ query: no-op (ติดตามด้านต่างๆ เสมอ)
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]incompatible_display_source_file_location
: "จริง" -
"จริง" จะแสดงเป้าหมายของไฟล์ต้นฉบับโดยค่าเริ่มต้น หากเป็น "จริง" จะแสดงตำแหน่งของบรรทัดที่ 1 ของไฟล์ต้นฉบับในเอาต์พุตตำแหน่ง แฟล็กนี้มีไว้เพื่อวัตถุประสงค์ในการย้ายข้อมูลเท่านั้น
แท็ก:terminal_output
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_package_group_includes_double_slash
: "จริง" -
หากเปิดใช้ เมื่อเอาต์พุตแอตทริบิวต์ `packages` ของ package_group จะไม่ละเว้น `//` ที่นำหน้า
แท็ก:terminal_output
,incompatible_change
- ค่าเริ่มต้นของ
--[no]infer_universe_scope
: "เท็จ" -
หากไม่ได้ตั้งค่า และ --universe_scope อยู่ ระบบจะอนุมานค่าของ --universe_scope เป็นรายการรูปแบบเป้าหมายที่ไม่ซ้ำกันในนิพจน์การค้นหา โปรดทราบว่าค่า --universe_scope ที่อนุมานสำหรับนิพจน์การค้นหาที่ใช้ฟังก์ชันขอบเขตระดับจักรวาล (เช่น "allrdeps") อาจไม่ใช่ค่าที่คุณต้องการ คุณจึงควรใช้ตัวเลือกนี้ก็ต่อเมื่อคุณรู้ว่าคุณกำลังทำอะไรอยู่เท่านั้น ดูรายละเอียดและตัวอย่างได้ที่ https://bazel.build/reference/query#sky-query หากตั้งค่า --universe_scope ไว้ ระบบจะไม่พิจารณาค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้มีผลกับ "ข้อความค้นหา" เท่านั้น (กล่าวคือ ไม่ใช่ "cquery")
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]line_terminator_null
: "เท็จ" -
ระบุว่าแต่ละรูปแบบจะลงท้ายด้วย \0 แทนที่จะเป็นบรรทัดใหม่หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]nodep_deps
: "จริง" -
หากเปิดใช้ คำสั่ง deps จาก "nodep" จะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาดังกล่าวดำเนินการอยู่ ตัวอย่างทั่วไปของแอตทริบิวต์ "nodep" คือ "visibility" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ "infobuild-language" เพื่อดูข้อมูลเกี่ยวกับแอตทริบิวต์ "nodep" ทั้งหมดในภาษาบิลด์
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--output=<a string>
: "label" -
รูปแบบที่ควรพิมพ์ผลลัพธ์การค้นหา ค่าที่อนุญาตสำหรับ cquery คือ label, label_kind, textรู้จัก, textโพรโต, การเปลี่ยน, โปรโตคอล, jsonโปรโต หากคุณเลือก "การเปลี่ยน" คุณต้องระบุตัวเลือก --transitions=(lite|full) ด้วย
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:default_values
: "จริง" -
หากเป็น "จริง" ระบบจะรวมแอตทริบิวต์ที่ไม่ได้ระบุค่าไว้อย่างชัดเจนในไฟล์ BUILD มิเช่นนั้นระบบจะละเว้นแอตทริบิวต์เหล่านั้น ตัวเลือกนี้ใช้ได้กับ --เอาต์พุต=โปรโตคอล
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:definition_stack
: "เท็จ" -
ป้อนข้อมูลช่อง Proto คำจำกัดความ ซึ่งจะบันทึกสำหรับอินสแตนซ์ของกฎแต่ละรายการที่สแต็กการเรียกใช้ Starlark ทันทีที่มีการกำหนดคลาสของกฎ
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:flatten_selects
: "จริง" -
หากเปิดใช้ ระบบจะรวมแอตทริบิวต์ที่กำหนดค่าได้ซึ่งสร้างด้วย select() ออก สำหรับประเภทรายการ การนำเสนอแบบรวมคือรายการที่มีแต่ละค่าของแผนที่ที่เลือกเพียงครั้งเดียว ประเภท Scalar จะถูกแบนเป็น Null
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--[no]proto:include_configurations
: "จริง" -
หากเปิดใช้ เอาต์พุตโปรโตจะมีข้อมูลเกี่ยวกับการกำหนดค่า เมื่อปิดใช้ รูปแบบเอาต์พุต Proto ของ cquery จะคล้ายกับรูปแบบเอาต์พุตการค้นหา
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]proto:include_synthetic_attribute_hash
: "เท็จ" -
ระบุว่าจะคำนวณและป้อนข้อมูลแอตทริบิวต์ $internal_attr_hash หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:instantiation_stack
: "เท็จ" -
สร้างสแต็กการเรียกใช้อินสแตนซ์ของแต่ละกฎ โปรดทราบว่าการดำเนินการนี้ต้องมีสแต็ก
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:locations
: "จริง" -
กำหนดว่าจะแสดงข้อมูลตำแหน่งในเอาต์พุต Pro หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--proto:output_rule_attrs=<comma-separated list of options>
: "ทั้งหมด" -
รายการแอตทริบิวต์ที่คั่นด้วยคอมมาที่จะรวมไว้ในเอาต์พุต ค่าเริ่มต้นคือแอตทริบิวต์ทั้งหมด ตั้งค่าเป็นสตริงว่างเพื่อไม่ให้มีแอตทริบิวต์ใดๆ ทั้งสิ้น ตัวเลือกนี้ใช้ได้กับ --เอาต์พุต=โปรโตคอล
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:rule_inputs_and_outputs
: "จริง" -
ระบุว่าจะสร้างช่อง report_input และ rules_เอาต์พุต หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--query_file=<a string>
: "" -
หากตั้งค่าแล้ว การค้นหาจะอ่านการค้นหาจากไฟล์ที่มีชื่อที่นี่ ไม่ใช่ในบรรทัดคำสั่ง ข้อผิดพลาดในการระบุไฟล์ที่นี่ รวมถึงการค้นหาบรรทัดคำสั่ง
แท็ก:changes_inputs
- ค่าเริ่มต้นของ
--[no]relative_locations
: "เท็จ" -
หากเป็นจริง ตำแหน่งของไฟล์ BUILD ใน XML และเอาต์พุตโปรโตจะสัมพันธ์กัน โดยค่าเริ่มต้น เอาต์พุตของตำแหน่งจะเป็นเส้นทางสัมบูรณ์และจะไม่สอดคล้องกันในแต่ละเครื่อง คุณสามารถตั้งตัวเลือกนี้เป็น "จริง" เพื่อให้ผลลัพธ์สอดคล้องกันในคอมพิวเตอร์ทุกเครื่อง
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--show_config_fragments=<off, direct or transitive>
: "ปิด" -
แสดงส่วนย่อยการกำหนดค่าที่กฎและทรัพยากร Dependency เริ่มต้นที่จำเป็น วิธีนี้จะมีประโยชน์ในการประเมินว่ากราฟเป้าหมายที่กำหนดค่าไว้สามารถตัดออกได้มากน้อยเพียงใด
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--starlark:expr=<a string>
: "" -
นิพจน์ Starlark เพื่อจัดรูปแบบเป้าหมายที่กำหนดค่าแต่ละรายการในโหมด --output=starlark ของ cquery เป้าหมายที่กำหนดค่าไว้เชื่อมโยงกับ "target" หากไม่ได้ระบุ --starlark:expr และ --starlark:file ตัวเลือกนี้จะมีค่าเริ่มต้นเป็น "str(target.label)" ข้อผิดพลาดในการระบุทั้ง --starlark:expr และ --starlark:file
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--starlark:file=<a string>
: "" -
ชื่อไฟล์ที่กำหนดฟังก์ชัน Starlark ที่เรียกว่า "format" ของอาร์กิวเมนต์ 1 รายการ ซึ่งจะนำไปใช้กับเป้าหมายที่กำหนดค่าไว้แต่ละรายการเพื่อจัดรูปแบบเป็นสตริง ข้อผิดพลาดในการระบุทั้ง --starlark:expr และ --starlark:file ดูรายละเอียดเพิ่มเติมได้ในความช่วยเหลือเกี่ยวกับ --output=starlark
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]tool_deps
: "จริง" -
คำค้นหา: หากปิดใช้ ทรัพยากร Dependency ของเป้าหมาย "การกำหนดค่าโฮสต์" หรือ "การดำเนินการ" จะไม่รวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาดังกล่าวดำเนินการอยู่ Edge ของทรัพยากร Dependency "การกำหนดค่าโฮสต์" เช่น กฎจากกฎ "Proto_library" ใดก็ตามไปยังโปรโตคอลคอมไพเลอร์ (โปรโตคอลคอมไพเลอร์) มักจะชี้ไปยังเครื่องมือที่ดำเนินการระหว่างการสร้างแทนที่จะเป็นส่วนหนึ่งของโปรแกรม "target" เดียวกัน
ค้นหา: หากปิดใช้ ให้กรองเป้าหมายที่กำหนดค่าไว้ทั้งหมดซึ่งข้ามโฮสต์หรือการเปลี่ยนการดำเนินการจากเป้าหมายระดับบนสุดที่ค้นพบเป้าหมายที่กำหนดค่าไว้นี้ออก ซึ่งหมายความว่าหากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าเป้าหมาย ระบบจะแสดงผลเฉพาะเป้าหมายที่กำหนดค่าในการกำหนดค่าเป้าหมายด้วยเท่านั้น หากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าโฮสต์ ระบบจะแสดงเฉพาะเป้าหมายที่กำหนดค่าไว้ของโฮสต์เท่านั้น ตัวเลือกนี้จะไม่ยกเว้นห่วงโซ่เครื่องมือที่แก้ไขแล้ว
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--transitions=<full, lite or none>
: "ไม่มี" -
รูปแบบที่การค้นหาจะพิมพ์ข้อมูลการเปลี่ยน
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--universe_scope=<comma-separated list of options>
: "" -
ชุดรูปแบบเป้าหมายที่คั่นด้วยคอมมา (การบวกและการลบ) การค้นหาอาจดำเนินการในจักรวาลที่กำหนดโดยการปิดทางอ้อมของเป้าหมายที่ระบุ ตัวเลือกนี้ใช้สำหรับคำค้นหาและคำสั่ง cquery
สำหรับ cquery อินพุตไปยังตัวเลือกนี้จะเป็นเป้าหมายคำตอบทั้งหมดที่สร้างขึ้น ดังนั้นตัวเลือกนี้จึงอาจส่งผลต่อการกำหนดค่าและการเปลี่ยน หากไม่ได้ระบุตัวเลือกนี้ ระบบจะถือว่าเป้าหมายระดับบนสุดเป็นเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหา หมายเหตุ: สำหรับ cquery การไม่ระบุตัวเลือกนี้อาจทำให้บิลด์เสียหายได้ หากเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหาไม่สามารถสร้างได้ด้วยตัวเลือกระดับบนสุด
แท็กloading_and_analysis
- ตัวเลือกที่กระตุ้นให้เกิดการเพิ่มประสิทธิภาพตามเวลาบิลด์
- ค่าเริ่มต้นของ
--[no]collapse_duplicate_defines
: "เท็จ" -
เมื่อเปิดใช้ ระบบจะนำการกำหนดที่ซ้ำกันออกในช่วงต้นของบิลด์ ซึ่งจะช่วยหลีกเลี่ยงการสูญเสียแคชการวิเคราะห์โดยไม่จำเป็นสำหรับบิลด์ที่เทียบเท่าบางประเภท
แท็ก:loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--[no]experimental_filter_library_jar_with_program_jar
: "เท็จ" -
กรอง ProGuard ProgramJar เพื่อนำคลาสที่แสดงใน LibraryJar ออกด้วย
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--[no]experimental_inmemory_dotd_files
: "จริง" -
หากเปิดใช้ ระบบจะส่งไฟล์ C++ .d ในหน่วยความจำจากโหนดบิลด์ระยะไกลโดยตรง แทนที่จะเขียนลงในดิสก์
แท็ก:loading_and_analysis
,execution
,affects_outputs
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_inmemory_jdeps_files
: "จริง" -
หากเปิดใช้ ระบบจะส่งไฟล์ทรัพยากร Dependency (.jdeps) ที่สร้างจากการคอมไพล์ Java ในหน่วยความจำจากโหนดบิลด์ระยะไกลโดยตรงแทนที่จะเขียนลงในดิสก์
แท็ก:loading_and_analysis
,execution
,affects_outputs
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_objc_include_scanning
: "เท็จ" -
ต้องรวมการสแกนหาวัตถุประสงค์ C/C++ ไหม
แท็ก:loading_and_analysis
,execution
,changes_inputs
- ค่าเริ่มต้นของ
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
: "เท็จ" -
หากเปิดใช้ ฟีเจอร์แยกวิเคราะห์ส่วนหัวจะไม่สร้างการดำเนินการคอมไพล์ส่วนหัวแยกต่างหากหากพบแหล่งที่มาที่มีชื่อฐานเดียวกันในเป้าหมายเดียวกัน
แท็ก:loading_and_analysis
,affects_outputs
- ค่าเริ่มต้นของ
--[no]experimental_retain_test_configuration_across_testonly
: "เท็จ" -
เมื่อเปิดใช้ --trim_test_configuration จะไม่ตัดการกำหนดค่าการทดสอบสำหรับกฎที่ระบุว่าเป็น testonly=1 ซึ่งจะช่วยลดปัญหาความขัดแย้งของการดำเนินการเมื่อกฎที่ไม่ใช่การทดสอบขึ้นอยู่กับกฎ cc_test จะไม่มีผลหาก --trim_test_configuration เป็นเท็จ
แท็ก:loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--[no]experimental_starlark_cc_import
: "เท็จ" -
หากเปิดใช้ คุณจะใช้ 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
: "จริง" -
การทำงานส่วนใหญ่มีไว้สำหรับการถอดรหัสไฟล์ 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
: "จริง" -
เมื่อเปิดใช้ ระบบจะล้างตัวเลือกที่เกี่ยวข้องกับการทดสอบภายใต้ระดับบนสุดของบิลด์ เมื่อแฟล็กนี้ทำงานอยู่ การทดสอบจะไม่สามารถสร้างขึ้นมาเป็นทรัพยากร Dependency ของกฎที่ไม่ใช่การทดสอบ แต่การเปลี่ยนแปลงตัวเลือกที่เกี่ยวข้องกับการทดสอบก็จะไม่ทำให้มีการวิเคราะห์กฎที่ไม่ใช่การทดสอบอีกครั้ง
แท็ก:loading_and_analysis
,loses_incremental_state
- ค่าเริ่มต้นของ
--[no]use_singlejar_apkbuilder
: "จริง" -
ตัวเลือกนี้เลิกใช้งานแล้ว ตอนนี้ไม่มีการดำเนินการและจะถูกนำออกเร็วๆ นี้
แท็ก:loading_and_analysis
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งการบันทึก
- ค่าเริ่มต้นของ
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
พิมพ์ข้อมูลการแก้ไขข้อบกพร่องระหว่างการแก้ปัญหา Toolchain แฟล็กจะใช้นิพจน์ทั่วไป ซึ่งมีการตรวจสอบกับประเภท Toolchain และเป้าหมายเฉพาะเพื่อดูสิ่งที่ต้องแก้ไขข้อบกพร่อง คุณสามารถคั่นนิพจน์ทั่วไปหลายรายการได้ด้วยคอมมา แล้วจึงตรวจสอบนิพจน์ทั่วไปแต่ละรายการแยกกัน หมายเหตุ: ผลลัพธ์ของแฟล็กนี้ซับซ้อนมากและน่าจะมีประโยชน์สำหรับผู้เชี่ยวชาญด้านการแก้ปัญหาเครื่องมือเชนเท่านั้น
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- รวมการใช้งานหลายรายการแล้ว
--flag_alias=<a 'name=value' flag alias>
รายการ -
ตั้งชื่อชวเลขให้กับธง Starlark ซึ่งจะใช้คู่คีย์-ค่าเดียวในรูปแบบ "<key>=<value>" เป็นอาร์กิวเมนต์
แท็ก:changes_inputs
- ค่าเริ่มต้นของ
--[no]incompatible_default_to_explicit_init_py
: "เท็จ" -
แฟล็กนี้จะเปลี่ยนลักษณะการทำงานเริ่มต้นเพื่อไม่ให้สร้างไฟล์ __init__.py โดยอัตโนมัติในไฟล์ Runfile ของ Python เป้าหมายอีกต่อไป ในขั้นนี้ เมื่อเป้าหมาย py_binary หรือ py_test มีการตั้งค่า legacy_create_init เป็น "auto" (ค่าเริ่มต้น) ค่าดังกล่าวจะถือว่าเป็น False ก็ต่อเมื่อมีการตั้งค่าสถานะนี้เท่านั้น ดู 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
: "จริง" -
หากเป็น "จริง" เป้าหมาย "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 ที่ระบุโดย Toolchain ของ Python แทนที่จะเป็นรันไทม์ที่ได้จากแฟล็กเดิม เช่น --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
,explicit_in_output_path
- ตัวเลือกเบ็ดเตล็ด ที่ไม่ได้จัดอยู่ในหมวดหมู่อื่น:
--[no]cache_test_results
[-t
] ค่าเริ่มต้น: "อัตโนมัติ"- หากตั้งค่าเป็น "อัตโนมัติ" Bazel จะทำการทดสอบอีกครั้งเฉพาะเมื่อ (1) Bazel ตรวจพบการเปลี่ยนแปลงในการทดสอบหรือทรัพยากร Dependency (2) ระบบจะทำเครื่องหมายการทดสอบเป็นภายนอก (3) มีการขอการทดสอบหลายรายการด้วย --runs_per_test หรือ(4) การทดสอบล้มเหลวก่อนหน้านี้ หากตั้งค่าเป็น "ใช่" Bazel จะแคชผลการทดสอบทั้งหมด ยกเว้นการทดสอบที่ทำเครื่องหมายว่าเป็นภายนอก หากตั้งค่าเป็น "ไม่" Bazel จะไม่แคชผลการทดสอบใดๆ
- ค่าเริ่มต้นของ
--[no]experimental_cancel_concurrent_tests
: "เท็จ" -
หากเป็น "จริง" Blaze จะยกเลิกการทดสอบที่ทำงานอยู่พร้อมกันเมื่อเรียกใช้สำเร็จครั้งแรก วิธีนี้มีประโยชน์เมื่อใช้ร่วมกับ --runs_per_test_detects_flakes
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]experimental_fetch_all_coverage_outputs
: "เท็จ" -
หากเป็น "จริง" Bazel จะดึงข้อมูลไดเรกทอรีข้อมูลการครอบคลุมทั้งหมดสำหรับการทดสอบแต่ละครั้งระหว่างการเรียกใช้การครอบคลุม
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]experimental_generate_llvm_lcov
: "เท็จ" -
หากเป็น "จริง" ความครอบคลุมของเสียงดังจะสร้างรายงาน LCOV
แท็ก:affects_outputs
,loading_and_analysis
- ค่าเริ่มต้นของ
--[no]experimental_j2objc_header_map
: "จริง" - กำหนดว่าจะสร้างแมปส่วนหัว J2ObjC ควบคู่ไปกับการเปลี่ยนรูปแบบ J2ObjC ไหม
- ค่าเริ่มต้นของ
--[no]experimental_j2objc_shorter_header_path
: "เท็จ" -
กำหนดว่าจะสร้างโดยใช้เส้นทางส่วนหัวที่สั้นลง (ใช้ "_ios" แทน "_j2objc")
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--experimental_java_classpath=<off, javabuilder or bazel>
: "javabuilder" - เปิดใช้คลาสพาธที่ลดลงสำหรับการคอมไพล์ Java
- ค่าเริ่มต้นของ
--[no]experimental_limit_android_lint_to_android_constrained_java
: "เท็จ" -
จำกัด --experimental_run_android_lint_on_java_rulesในไลบรารีที่ใช้ร่วมกับ Android ได้
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]experimental_run_android_lint_on_java_rules
: "เท็จ" -
ต้องการตรวจสอบแหล่งที่มา java_* หรือไม่
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]explicit_java_test_deps
: "เท็จ" - ระบุทรัพยากร Dependency ให้กับ JUnit หรือ Hamcrest อย่างชัดเจนใน java_test แทนการขอรับจาก Deps ของ TestRunner โดยไม่ตั้งใจ เล่นกับ Bazel ได้ตอนนี้เท่านั้น
- ค่าเริ่มต้น
--host_java_launcher=<a build target label>
: ดูรายละเอียด - JavaScript Launcher ใช้โดยเครื่องมือที่ทำงานระหว่างบิลด์
- รวมการใช้งานหลายรายการแล้ว
--host_javacopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง JavaScript เมื่อสร้างเครื่องมือที่ทำงานระหว่างบิลด์
- รวมการใช้งานหลายรายการแล้ว
--host_jvmopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง Java VM เมื่อสร้างเครื่องมือที่ทำงานระหว่างบิลด์ ระบบจะเพิ่มตัวเลือกเหล่านี้ลงในตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
- ค่าเริ่มต้นของ
--[no]incompatible_check_sharding_support
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่ผ่านการทดสอบชาร์ดหากตัวดำเนินการทดสอบไม่ได้ระบุว่ารองรับชาร์ดดิ้งโดยแตะไฟล์ที่เส้นทางใน TEST_SHARD_STATUS_FILE หากเป็นเท็จ ตัวดำเนินการทดสอบที่ไม่รองรับชาร์ดดิ้งจะนำไปสู่การทดสอบทั้งหมดที่ทำงานอยู่ในแต่ละชาร์ด
แท็ก:incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_exclusive_test_sandboxed
: "เท็จ" -
หากเป็นจริง การทดสอบพิเศษจะทํางานโดยใช้กลยุทธ์แบบแซนด์บ็อกซ์ เพิ่มแท็ก "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_เอาต์พุต=streamed
ขยายเป็น
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- ค่าเริ่มต้นของ
--[no]java_deps
: "จริง" - สร้างข้อมูลทรัพยากร Dependency (สำหรับตอนนี้คือคลาสพาธการคอมไพล์) ต่อเป้าหมาย Java
- ค่าเริ่มต้นของ
--[no]java_header_compilation
: "จริง" - รวบรวม Jar จากแหล่งที่มาโดยตรง
- ค่าเริ่มต้นของ
--java_language_version=<a string>
: "8" - เวอร์ชันภาษา Java
- ค่าเริ่มต้น
--java_launcher=<a build target label>
: ดูรายละเอียด - JavaScript Launcher ที่ใช้เมื่อสร้างไบนารีของ Java หากตั้งค่าแฟล็กนี้เป็นสตริงว่างเปล่า ระบบจะใช้ JDK Launcher แอตทริบิวต์ "launcher" จะลบล้าง Flag นี้
- ค่าเริ่มต้นของ
--java_runtime_version=<a string>
: "local_jdk" - เวอร์ชันรันไทม์ของ Java
- รวมการใช้งานหลายรายการแล้ว
--javacopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง JavaScript
- รวมการใช้งานหลายรายการแล้ว
--jvmopt=<a string>
รายการ - ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยัง VM ของ Java ระบบจะเพิ่มตัวเลือกเหล่านี้ลงในตัวเลือกการเริ่มต้น VM ของเป้าหมาย java_binary แต่ละรายการ
- ค่าเริ่มต้น
--legacy_main_dex_list_generator=<a build target label>
: ดูรายละเอียด - ระบุไบนารีที่จะใช้ในการสร้างรายการคลาสที่ต้องอยู่ใน Dex หลักเมื่อคอมไพล์ Multidex เดิม
- รวมการใช้งานหลายรายการแล้ว
--plugin=<a build target label>
รายการ - ปลั๊กอินที่จะใช้ในบิลด์ ใช้งานได้กับ java_plugin ในขณะนี้
- ค่าเริ่มต้น
--proguard_top=<a build target label>
: ดูรายละเอียด - ระบุว่าจะใช้ ProGuard เวอร์ชันใดสำหรับการนำโค้ดออกเมื่อสร้างไบนารี Java
- ค่าเริ่มต้นของ
--proto_compiler=<a build target label>
: "@bazel_tools//tools/ctr:ctrc" -
ป้ายกำกับของ Proto-Composer
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/prof:cc_toolchain"-
ป้ายกำกับของ ctr_lang_toolchain() ที่อธิบายวิธีคอมไพล์ C++ โปรโตคอล
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/j2objc:j2objc_plo_toolchain"-
ป้ายกำกับของ ctr_lang_toolchain() ที่อธิบายวิธีคอมไพล์ j2objc โพโตร
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/ctr:java_toolchain"-
ป้ายกำกับของ ctr_lang_toolchain() ที่อธิบายวิธีคอมไพล์ Java โปรโตคอล
แท็ก:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
ค่าเริ่มต้น: "@bazel_tools//tools/ctr:javalite_toolchain"-
ป้ายกำกับของ proto_lang_toolchain() ที่อธิบายวิธีคอมไพล์ Proto ของ JavaLite
แท็ก:affects_outputs
,loading_and_analysis
- รวมการใช้งานหลายรายการแล้ว
--protocopt=<a string>
รายการ -
ตัวเลือกเพิ่มเติมสำหรับส่งผ่านไปยังคอมไพเลอร์ ctrbuf
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]runs_per_test_detects_flakes
: "เท็จ" - หากเป็น "จริง" ชาร์ดที่มีการรัน/พยายามอย่างน้อย 1 ครั้ง และการเรียกใช้/การลองอย่างน้อย 1 ครั้งล้มเหลวจะได้รับสถานะ "ไม่ถูกต้อง"
- ค่าเริ่มต้น
--shell_executable=<a path>
: ดูรายละเอียด -
เส้นทางสัมบูรณ์ไปยังไฟล์ปฏิบัติการ Shell ที่ Bazel จะใช้ได้ หากไม่ได้ตั้งค่าไว้ แต่ตัวแปรสภาพแวดล้อม BAZEL_SH ตั้งค่าในการเรียกใช้ Bazel ครั้งแรก (ซึ่งเริ่มต้นเซิร์ฟเวอร์ Bazel) Bazel จะใช้ค่านั้น หากไม่ได้ตั้งค่าไว้ Bazel จะใช้เส้นทางเริ่มต้นแบบฮาร์ดโค้ด ทั้งนี้ขึ้นอยู่กับระบบปฏิบัติการที่ใช้ (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, อื่นๆ ทั้งหมด: /bin/bash) โปรดทราบว่าการใช้ Shell ที่เข้ากันไม่ได้กับ Bash อาจทำให้การสร้างล้มเหลวหรือรันไทม์ล้มเหลวของไบนารีที่สร้างขึ้น
แท็ก:loading_and_analysis
- รวมการใช้งานหลายรายการแล้ว
--test_arg=<a string>
รายการ - ระบุตัวเลือกและอาร์กิวเมนต์เพิ่มเติมที่ควรส่งไปยังไฟล์ปฏิบัติการทดสอบ ใช้ได้หลายครั้งเพื่อระบุอาร์กิวเมนต์หลายข้อ หากทำการทดสอบหลายรายการ การทดสอบแต่ละรายการจะได้รับอาร์กิวเมนต์ที่เหมือนกัน ใช้โดยคำสั่ง 'bazel test' เท่านั้น
- ค่าเริ่มต้น
--test_filter=<a string>
: ดูรายละเอียด - ระบุตัวกรองสำหรับส่งต่อไปยังเฟรมเวิร์กการทดสอบ ใช้เพื่อจำกัดการทดสอบ โปรดทราบว่าการดำเนินการนี้ไม่มีผลต่อเป้าหมายที่สร้าง
- ค่าเริ่มต้นของ
--test_result_expiration=<an integer>
: "-1" - ตัวเลือกนี้เลิกใช้งานแล้วและไม่มีผล
- ค่าเริ่มต้นของ
--[no]test_runner_fail_fast
: "เท็จ" - ส่งต่อตัวเลือก "ไม่ผ่าน" ไปยังตัวดำเนินการทดสอบ ตัวดำเนินการทดสอบควรหยุดการดำเนินการเมื่อล้มเหลวในครั้งแรก
- ค่าเริ่มต้นของ
--test_sharding_strategy=<explicit or disabled>
: "โจ่งแจ้ง" - ระบุกลยุทธ์สำหรับชาร์ดดิ้งทดสอบ: "โจ่งแจ้ง" เพื่อใช้ชาร์ดดิ้งก็ต่อเมื่อมีแอตทริบิวต์ BUILD "shard_count" อยู่เท่านั้น "ปิดใช้" เพื่อไม่ให้ใช้ชาร์ดดิ้งทดสอบ
- ค่าเริ่มต้นของ
--tool_java_language_version=<a string>
: "8" - เวอร์ชันภาษา Java ที่ใช้เพื่อเรียกใช้เครื่องมือที่จำเป็นระหว่างบิลด์
- ค่าเริ่มต้นของ
--tool_java_runtime_version=<a string>
: "remotejdk_11" - เวอร์ชันรันไทม์ของ Java ที่ใช้เพื่อเรียกใช้เครื่องมือในระหว่างบิลด์
- ค่าเริ่มต้นของ
--[no]use_ijars
: "จริง" - หากเปิดใช้ ตัวเลือกนี้จะทำให้การคอมไพล์ Java ใช้ Jar ของอินเทอร์เฟซ ซึ่งจะส่งผลให้การรวบรวมเพิ่มขึ้นเร็วขึ้น แต่ข้อความแสดงข้อผิดพลาดอาจแตกต่างกันได้
ตัวเลือกดัมพ์
- ตัวเลือกที่ปรากฏก่อนคำสั่งและถูกแยกวิเคราะห์โดยไคลเอ็นต์ ได้แก่
- รวมการใช้งานหลายรายการแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบแคช แทนที่จะคัดลอก โดยมีจุดประสงค์เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่มาจาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม ซึ่งสามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ส่งผลให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_repository_disable_download
: "เท็จ" -
หากมีการตั้งค่า ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองแก้ไขข้อผิดพลาดในการดาวน์โหลดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานได้ในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้นของ
--http_timeout_scaling=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลด HTTP ตามปัจจัยที่กำหนด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูรายละเอียด -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็กbazel_internal_configuration
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่งมีดังนี้
- ค่าเริ่มต้นของ
--[no]action_cache
: "เท็จ" -
ถ่ายโอนเนื้อหาแคชการดำเนินการ
แท็ก:bazel_monitoring
- ค่าเริ่มต้นของ
--[no]packages
: "เท็จ" -
ดัมพ์เนื้อหาแคชของแพ็กเกจ
แท็ก:bazel_monitoring
- ค่าเริ่มต้นของ
--[no]rule_classes
: "เท็จ" -
คลาสของกฎดัมพ์
แท็ก:bazel_monitoring
- ค่าเริ่มต้นของ
--[no]rules
: "เท็จ" -
กฎดัมพ์ รวมถึงจำนวนและการใช้งานหน่วยความจำ (หากมีการติดตามหน่วยความจำ)
แท็ก:bazel_monitoring
- ค่าเริ่มต้นของ
--skyframe=<off, summary, count, deps or rdeps>
: "ปิด" -
ดัมพ์กราฟ Skyframe: "off", "summary", "count", "deps" หรือ "rdeps"
แท็ก:bazel_monitoring
- ค่าเริ่มต้นของ
--skykey_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: ".*" -
ตัวกรองนิพจน์ทั่วไปของชื่อ SkyKey ที่จะแสดงเอาต์พุต ใช้กับ --skyframe=deps, rdeps เท่านั้น
แท็ก:bazel_monitoring
- ค่าเริ่มต้น
--skylark_memory=<a string>
: ดูรายละเอียด -
ส่งออกข้อมูลโปรไฟล์หน่วยความจำที่ใช้ร่วมกับ pprof ไปยังเส้นทางที่ระบุ หากต้องการเรียนรู้เพิ่มเติม โปรดดูที่ https://github.com/google/pprof
แท็ก:bazel_monitoring
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมของแฟล็ก ฯลฯ)
- ค่าเริ่มต้นของ
--experimental_repository_hash_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรยืนยันแฮชไดเรกทอรีที่เก็บ
แท็ก:affects_outputs
,experimental
- รวมการใช้งานหลายรายการแล้ว
--experimental_verify_repository_rules=<a string>
รายการ -
หากรายการกฎที่เก็บซึ่งควรยืนยันแฮชของไดเรกทอรีเอาต์พุต ระบบจะระบุไฟล์โดย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ API ของบิลด์ที่เข้าถึงได้ด้วยการสร้างไฟล์ .bzl หรือไฟล์ WORKSPACE
- ค่าเริ่มต้นของ
--[no]experimental_allow_top_level_aspects_parameters
: "จริง" -
ไม่ดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
- รวมการใช้งานหลายรายการแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ซึ่งจะอนุญาตให้ใช้ในกราฟการอ้างอิงที่แก้ไขแล้วแม้ว่าจะมีการประกาศว่าได้รับการแย้งในรีจิสทรีที่เป็นแหล่งที่มา (หากเว็บไซต์ไม่ได้มาจาก NonRegistryReplace) มิฉะนั้น เวอร์ชันที่ยัดเยียดจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชัน yank ที่อนุญาตได้ด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" คุณสามารถปิดใช้งานการตรวจสอบนี้ได้โดยใช้คำหลัก "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ หรือ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบว่าข้อมูลไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบที่ไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าทรัพยากร Dependency ดังกล่าวจะถูกละเว้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท โดยไม่คำนึงถึงค่าของแฟล็กนี้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--lockfile_mode=<off, update or error>
: "ปิด" -
ระบุว่าจะใช้ Lockfile อย่างไรและจะใช้หรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ Lockfile และอัปเดตเมื่อมีการเปลี่ยนแปลง "ข้อผิดพลาด" ให้ใช้ Lockfile แต่จะแสดงข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่ออ่านหรือเขียนไฟล์ล็อกทั้ง 2 ไฟล์
แท็ก: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
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งการบันทึกมีดังนี้
- ค่าเริ่มต้นของ
--[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") หรือ 2 รูปแบบ รูปแบบหนึ่งเพื่อจับคู่กับ และอีกแบบหนึ่งใช้เป็น URL แทนโดยมีการอ้างอิงย้อนกลับที่เริ่มจาก "$1" เป็นไปได้ที่คำสั่ง "rewrite" อาจมีผลลัพธ์ใน URL เดียวกันหลายรายการ และระบบจะส่ง URL เดียวกันนี้กลับไปหลายรายการสำหรับ URL เดียวกัน)
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้จัดหมวดหมู่:
- รวมการใช้งานหลายรายการแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace"
ตัวเลือกการดึงข้อมูล
- ตัวเลือกที่ปรากฏก่อนคำสั่งและถูกแยกวิเคราะห์โดยไคลเอ็นต์ ได้แก่
- รวมการใช้งานหลายรายการแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบแคช แทนที่จะคัดลอก โดยมีจุดประสงค์เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่มาจาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม ซึ่งสามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ส่งผลให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_repository_disable_download
: "เท็จ" -
หากมีการตั้งค่า ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองแก้ไขข้อผิดพลาดในการดาวน์โหลดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานได้ในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้นของ
--http_timeout_scaling=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลด HTTP ตามปัจจัยที่กำหนด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูรายละเอียด -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการดำเนินการบิลด์มีดังนี้
- ค่าเริ่มต้นของ
--[no]incompatible_remote_dangling_symlinks
: "จริง" -
หากตั้งค่าเป็น "จริง" และ --incompatible_remote_symlinks ก็เป็นจริงด้วยเช่นกัน ลิงก์สัญลักษณ์ในเอาต์พุตการดำเนินการจะได้รับอนุญาตให้ห้อยลง
แท็ก:execution
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remote_symlinks
: "จริง" -
หากตั้งค่าเป็น "จริง" Bazel จะแสดงลิงก์สัญลักษณ์ในเอาต์พุตการดำเนินการในโปรโตคอลการแคช/การดำเนินการระยะไกลในลักษณะดังกล่าว มิฉะนั้นระบบจะติดตามลิงก์สัญลักษณ์และแสดงเป็นไฟล์หรือไดเรกทอรี ดูรายละเอียดได้ที่ #6631
แท็ก:execution
,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") ตามด้วยการดำเนินการ ([-|*]<Flo>) เช่น "auto", "HOST_CPUS*.5" "auto" ตั้งค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ช่วยให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการ ซึ่งจะส่งผลต่อค่าแทนการมีอยู่
- ค่าเริ่มต้นของ
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
จำนวนไฟล์เปิดสูงสุดที่อนุญาตระหว่างการอัปโหลดอาร์ติแฟกต์ BEP
แท็ก:affects_outputs
--remote_download_minimal
-
ไม่ดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลไปยังเครื่องภายใน ค่าสถานะนี้เป็นทางลัดสำหรับแฟล็ก --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_เอาต์พุต_metadata และ --remote_download_outputs=minimal
ขยายเป็น
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--remote_download_outputs=<all, minimal or toplevel>
: "ทั้งหมด" -
หากตั้งค่าเป็น "ต่ำสุด" จะไม่ดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลใดๆ ไปยังเครื่องในระบบ ยกเว้นเอาต์พุตที่การดำเนินการในเครื่องต้องการ หากตั้งค่าเป็น "ระดับบนสุด" จะมีการทำงานเหมือน "ต่ำสุด" เว้นแต่ว่าจะดาวน์โหลดเอาต์พุตของเป้าหมายระดับบนสุดไปยังเครื่องภายในด้วย ทั้ง 2 ตัวเลือกช่วยลดเวลาในการสร้างได้อย่างมากหากแบนด์วิดท์ของเครือข่ายเป็นจุดคอขวด
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--remote_download_symlink_template=<a string>
: "" -
สร้างลิงก์สัญลักษณ์แทนการดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลไปยังเครื่องภายใน สามารถระบุเป้าหมายของลิงก์สัญลักษณ์ในรูปแบบของสตริงเทมเพลตได้ สตริงเทมเพลตนี้อาจมี {hash} และ {size_bytes} ที่ขยายเป็นแฮชของออบเจ็กต์และขนาดเป็นไบต์ตามลำดับ เช่น ลิงก์สัญลักษณ์เหล่านี้อาจชี้ไปยังระบบไฟล์ FUSE ที่โหลดออบเจ็กต์จาก CAS ออนดีมานด์
แท็ก:affects_outputs
--remote_download_toplevel
-
ดาวน์โหลดเฉพาะเอาต์พุตระยะไกลของเป้าหมายระดับบนสุดไปยังเครื่องภายในเท่านั้น ค่าสถานะนี้เป็นทางลัดสำหรับแฟล็ก --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata และ --remote_download_เอาต์พุต=toplevel
ขยายไปยัง
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
แท็ก:affects_outputs
- ตัวเลือกที่มีผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมของแฟล็ก ฯลฯ) ได้แก่
- ค่าเริ่มต้นของ
--experimental_repository_hash_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรยืนยันแฮชไดเรกทอรีที่เก็บ
แท็ก:affects_outputs
,experimental
- รวมการใช้งานหลายรายการแล้ว
--experimental_verify_repository_rules=<a string>
รายการ -
หากรายการกฎที่เก็บซึ่งควรยืนยันแฮชของไดเรกทอรีเอาต์พุต ระบบจะระบุไฟล์โดย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ API ของบิลด์ที่เข้าถึงได้ด้วยการสร้างไฟล์ .bzl หรือไฟล์ WORKSPACE
- ค่าเริ่มต้นของ
--[no]experimental_allow_top_level_aspects_parameters
: "จริง" -
ไม่ดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ค่าเริ่มต้นของ
--[no]incompatible_config_setting_private_default_visibility
: "เท็จ" -
หากแฟล็กนี้เป็นเท็จ config_setting ที่ไม่มีแอตทริบิวต์การเปิดเผยอย่างชัดเจนจะเป็น //visibility:public หากแฟล็กนี้เป็นจริง config_setting จะใช้ตรรกะการแสดงผลเดียวกันกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_enforce_config_setting_visibility
: "จริง" -
หากเป็น "จริง" ให้บังคับใช้ข้อจํากัดระดับการเข้าถึง config_setting หากเป็น "เท็จ" ทุก config_setting จะปรากฏกับทุกเป้าหมาย ดู https://github.com/bazelbuild/bazel/issues/12932
แท็กloading_and_analysis
,incompatible_change
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
- รวมการใช้งานหลายรายการแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ซึ่งจะอนุญาตให้ใช้ในกราฟการอ้างอิงที่แก้ไขแล้วแม้ว่าจะมีการประกาศว่าได้รับการแย้งในรีจิสทรีที่เป็นแหล่งที่มา (หากเว็บไซต์ไม่ได้มาจาก NonRegistryReplace) มิฉะนั้น เวอร์ชันที่ยัดเยียดจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชัน yank ที่อนุญาตได้ด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" คุณสามารถปิดใช้งานการตรวจสอบนี้ได้โดยใช้คำหลัก "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ หรือ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบว่าข้อมูลไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบที่ไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าทรัพยากร Dependency ดังกล่าวจะถูกละเว้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท โดยไม่คำนึงถึงค่าของแฟล็กนี้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--lockfile_mode=<off, update or error>
: "ปิด" -
ระบุว่าจะใช้ Lockfile อย่างไรและจะใช้หรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ Lockfile และอัปเดตเมื่อมีการเปลี่ยนแปลง "ข้อผิดพลาด" ให้ใช้ Lockfile แต่จะแสดงข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่ออ่านหรือเขียนไฟล์ล็อกทั้ง 2 ไฟล์
แท็ก: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
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งการบันทึกมีดังนี้
- ค่าเริ่มต้นของ
--[no]experimental_record_metrics_for_all_mnemonics
: "เท็จ" - โดยค่าเริ่มต้น ประเภทการดําเนินการจะจํากัดอยู่ที่ 20 ประเภทที่มีจำนวนการดำเนินการสูงสุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสําหรับการช่วยจำทั้งหมด
- ค่าเริ่มต้นของ
--experimental_repository_resolved_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้เขียนค่า Starlark ด้วยข้อมูลที่แก้ไขแล้วของกฎที่เก็บ Starlark ทั้งหมดที่มีการนำไปใช้
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--remote_print_execution_messages=<failure, success or all>
: "failure" -
เลือกเวลาที่จะพิมพ์ข้อความการดำเนินการจากระยะไกล ค่าที่ถูกต้องคือ "failure" จะพิมพ์เฉพาะเวลาที่ล้มเหลว "ความสำเร็จ" จะพิมพ์เฉพาะเมื่อสำเร็จ และ "all" จะพิมพ์ทุกครั้ง
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ค่าเริ่มต้นของ
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
หากเว้นว่างไว้ ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล
- ค่าเริ่มต้น
--experimental_circuit_breaker_strategy=<failure>
: ดูรายละเอียด -
ระบุกลยุทธ์ที่เบรกเกอร์จะใช้ กลยุทธ์ที่ใช้ได้คือ "ล้มเหลว" เมื่อค่าไม่ถูกต้องสำหรับตัวเลือก ลักษณะการทำงานจะเหมือนกับที่ไม่ได้กำหนดตัวเลือกไว้
แท็ก:execution
- ค่าเริ่มต้น
--experimental_downloader_config=<a string>
: ดูรายละเอียด - ระบุไฟล์ที่จะใช้กำหนดค่าเครื่องมือดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด โดยแต่ละบรรทัดจะขึ้นต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือ 2 รูปแบบ รูปแบบหนึ่งเพื่อจับคู่กับ และอีกแบบหนึ่งใช้เป็น URL แทนโดยมีการอ้างอิงย้อนกลับที่เริ่มจาก "$1" เป็นไปได้ที่คำสั่ง "rewrite" อาจมีผลลัพธ์ใน URL เดียวกันหลายรายการ และระบบจะส่ง URL เดียวกันนี้กลับไปหลายรายการสำหรับ URL เดียวกัน)
- ค่าเริ่มต้นของ
--[no]experimental_guard_against_concurrent_changes
: "เท็จ" - ปิดการตั้งค่านี้เพื่อปิดใช้การตรวจสอบเวลาของไฟล์อินพุตของการดำเนินการก่อนที่จะอัปโหลดไปยังแคชระยะไกล อาจมีกรณีที่เคอร์เนลของ Linux ทำให้การเขียนไฟล์ล่าช้า ซึ่งอาจทำให้เกิดผลบวกลวง
- ค่าเริ่มต้นของ
--experimental_remote_build_event_upload=<all or minimal>
: "ทั้งหมด" - หากตั้งค่าเป็น "ทั้งหมด" ระบบจะอัปโหลดเอาต์พุตในเครื่องทั้งหมดที่ BEP อ้างอิงไปยังแคชระยะไกล หากตั้งค่าเป็น "minimal" เอาต์พุตในเครื่องที่อ้างอิงโดย BEP จะไม่อัปโหลดไปยังแคชระยะไกล ยกเว้นไฟล์ที่มีความสำคัญต่อผู้ใช้ BEP (เช่น บันทึกการทดสอบและโปรไฟล์การจับเวลา) ระบบจะใช้รูปแบบ bytesstream:// กับ URI ของไฟล์เสมอแม้ว่าจะหายไปจากแคชระยะไกลก็ตาม มีค่าเริ่มต้นเป็น "ทั้งหมด"
- ค่าเริ่มต้นของ
--[no]experimental_remote_cache_async
: "เท็จ" - หากเป็น "จริง" I/O แคชระยะไกลจะเกิดขึ้นในเบื้องหลังแทนที่จะเกิดขึ้นเป็นส่วนหนึ่งของการสร้าง
- ค่าเริ่มต้นของ
--[no]experimental_remote_cache_compression
: "เท็จ" - หากเปิดใช้ ให้บีบอัด/ยกเลิกการบีบอัด Cache Blob ด้วย zstd
- ค่าเริ่มต้น
--experimental_remote_capture_corrupted_outputs=<a path>
: ดูรายละเอียด - เส้นทางไปยังไดเรกทอรีที่จะบันทึกเอาต์พุตที่เสียหาย
- ค่าเริ่มต้นของ
--[no]experimental_remote_discard_merkle_trees
: "เท็จ" - หากตั้งค่าเป็น "จริง" ให้ทิ้งสำเนาในหน่วยความจำของต้นไม้ Merkle ของรูทอินพุตและการแมปอินพุตที่เกี่ยวข้องระหว่างการเรียกใช้ GetAction Results() และ Execute() ซึ่งวิธีนี้จะช่วยลดการใช้หน่วยความจำลงอย่างมาก แต่ Bazel จะต้องคำนวณใหม่เมื่อแคชระยะไกลไม่พบและลองใหม่
- ค่าเริ่มต้น
--experimental_remote_downloader=<a string>
: ดูรายละเอียด - URI ปลายทางของ Remote Asset API ที่จะใช้เป็นพร็อกซีการดาวน์โหลดระยะไกล สคีมาที่รองรับคือ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (UNIX Sockets) หากไม่ได้กำหนดสคีมาไว้ Bazel จะใช้ค่าเริ่มต้นเป็น grpcs โปรดดูที่ https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.prof
- ค่าเริ่มต้นของ
--[no]experimental_remote_downloader_local_fallback
: "เท็จ" - จะกลับไปใช้โปรแกรมดาวน์โหลดในเครื่องหากโปรแกรมดาวน์โหลดระยะไกลล้มเหลว
- ค่าเริ่มต้นของ
--[no]experimental_remote_execution_keepalive
: "เท็จ" - ต้องการใช้ Keepalive สำหรับการเรียกใช้การดำเนินการระยะไกลหรือไม่
- ค่าเริ่มต้นของ
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
: "10" -
กำหนดจำนวนอัตราการทำงานไม่สำเร็จเป็นเปอร์เซ็นต์ที่อนุญาตสำหรับกรอบเวลาหนึ่งๆ หลังจากที่ระบบหยุดเรียกใช้แคช/ไฟล์ดำเนินการระยะไกล ค่าเริ่มต้นคือ 10 การตั้งค่านี้เป็น 0 หมายความว่าจะไม่มีข้อจำกัด
แท็ก:execution
- ค่าเริ่มต้นของ
--experimental_remote_failure_window_interval=<An immutable length of time.>
: "60 วินาที" -
ช่วงที่มีการคำนวณอัตราความล้มเหลวของคำขอระยะไกล สำหรับค่าศูนย์หรือค่าลบ ระยะเวลาที่ล้มเหลวจะได้รับการคำนวณตลอดระยะเวลาของการดำเนินการ หน่วยต่อไปนี้สามารถใช้ได้: วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]experimental_remote_mark_tool_inputs
: "เท็จ" - หากตั้งค่าเป็น "จริง" Bazel จะทำเครื่องหมายอินพุตเป็นอินพุตเครื่องมือสำหรับผู้ดำเนินการระยะไกล ข้อมูลนี้สามารถใช้ในการติดตั้งใช้งานผู้ปฏิบัติงานถาวรระยะไกล
- ค่าเริ่มต้นของ
--[no]experimental_remote_merkle_tree_cache
: "เท็จ" - หากตั้งค่าเป็น "จริง" ระบบจะบันทึกการคำนวณต้นไม้ Merkle เพื่อปรับปรุงความเร็วในการตรวจสอบ Hit ของแคชระยะไกล รอยเท้าหน่วยความจำของแคชจะควบคุมโดย --experimental_remote_merkle_tree_cache_size
- ค่าเริ่มต้นของ
--experimental_remote_merkle_tree_cache_size=<a long integer>
: "1,000" - จำนวนต้น Merkle ที่จะบันทึกเพื่อปรับปรุงความเร็วในการตรวจสอบแคชระยะไกล แม้ว่าแคชจะถูกตัดออกโดยอัตโนมัติตามการจัดการแบบซอฟต์การอ้างอิงของ Java แต่ข้อผิดพลาดจากหน่วยความจำนอกหน่วยความจำอาจเกิดขึ้นได้หากตั้งค่าสูงเกินไป หากตั้งค่าเป็น 0 ขนาดของแคชจะเป็นแบบไม่จำกัด มูลค่าที่เหมาะสมที่สุดจะแตกต่างกันไปโดยขึ้นอยู่กับขนาดของโปรเจ็กต์ ค่าเริ่มต้นคือ 1,000
- ค่าเริ่มต้นของ
--[no]experimental_remote_require_cached
: "เท็จ" - หากตั้งค่าเป็น "จริง" ให้บังคับให้มีการแคชการดำเนินการทั้งหมดที่เรียกใช้จากระยะไกลได้ มิเช่นนั้นระบบจะสร้างบิลด์ไม่สำเร็จ วิธีนี้มีประโยชน์ในการแก้ปัญหาที่ไม่ขึ้นอยู่กับการตัดสินใจ เนื่องจากจะช่วยให้สามารถตรวจสอบว่ามีการแคชการดำเนินการที่ควรแคชไว้จริงหรือไม่ โดยไม่ต้องแทรกผลลัพธ์ใหม่ลงในแคช
- ค่าเริ่มต้นของ
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "เท็จ" - หากตั้งค่าเป็น "จริง" ระบบจะไม่อัปโหลดเอาต์พุตที่ BEP อ้างอิงไปยังแคชระยะไกลหากการดำเนินการที่สร้างไม่สามารถแคชจากระยะไกลได้
- ค่าเริ่มต้นของ
--[no]incompatible_remote_downloader_send_all_headers
: "จริง" -
กำหนดว่าจะส่งค่าของส่วนหัวที่มีหลายค่าไปยังเครื่องมือดาวน์โหลดระยะไกลแทนที่จะส่งเพียงค่าแรกหรือไม่
แท็ก:incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remote_output_paths_relative_to_input_root
: "เท็จ" -
หากตั้งค่าเป็น "จริง" เส้นทางเอาต์พุตจะสัมพัทธ์กับรูทของอินพุตแทนที่จะเป็นไดเรกทอรีที่ใช้งานอยู่
แท็ก:incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remote_results_ignore_disk
: "จริง" -
หากตั้งค่าเป็น "จริง" --noremote_upload_local_results และ --noremote_accept_cached จะไม่มีผลกับดิสก์แคช หากใช้แคชแบบรวม:
--noremote_upload_local_results จะทำให้มีการเขียนผลลัพธ์ลงในดิสก์แคช แต่ไม่อัปโหลดไปยังแคชระยะไกล
--noremote_accept_cached จะทำให้ Bazel ตรวจสอบผลลัพธ์ในดิสก์แคช แต่ไม่ใช่ในแคชระยะไกล
การดำเนินการ no-remote-exec สามารถไปยังดิสก์แคชได้
ดูรายละเอียดได้ที่ #8216
แท็ก:incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
: "เท็จ" -
หากตั้งค่าเป็น "จริง" Bazel จะใช้รหัสออกใหม่ 39 แทน 34 หากแคชระยะไกลกำจัด BLOB ระหว่างบิลด์
แท็ก:incompatible_change
- ค่าเริ่มต้นของ
--[no]remote_accept_cached
: "จริง" - กำหนดว่าจะยอมรับผลการดำเนินการที่แคชไว้จากระยะไกลหรือไม่
- ค่าเริ่มต้น
--remote_bytestream_uri_prefix=<a string>
: ดูรายละเอียด - ชื่อโฮสต์และชื่ออินสแตนซ์ที่จะใช้ใน bytesstream:// URI ที่เขียนลงในสตรีมเหตุการณ์ของบิลด์ ตัวเลือกนี้จะตั้งค่าได้เมื่อมีการดำเนินการบิลด์โดยใช้พร็อกซี ซึ่งทำให้ค่าของ --remote_executor และ --remote_instance_name ไม่ตรงกับชื่อมาตรฐานของบริการดำเนินการระยะไกลอีกต่อไป เมื่อไม่ได้ตั้งค่า ค่าเริ่มต้นจะเป็น "${ชื่อโฮสต์}/${instance_name}"
- ค่าเริ่มต้น
--remote_cache=<a string>
: ดูรายละเอียด - URI ของปลายทางการแคช สคีมาที่รองรับ ได้แก่ http, https, grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (UNIX Sockets) หากไม่ได้กำหนดสคีมาไว้ Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุสคีมา grpc://, http:// หรือ unix: เพื่อปิดใช้ TLS โปรดดู https://bazel.build/remote/caching
- รวมการใช้งานหลายรายการแล้ว
--remote_cache_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอแคช ดังนี้ --remote_cache_header=Name=Value คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- รวมการใช้งานหลายรายการแล้ว
--remote_default_exec_properties=<a 'name=value' assignment>
รายการ -
ตั้งค่าพร็อพเพอร์ตี้ exec เริ่มต้นเพื่อใช้เป็นแพลตฟอร์มการดำเนินการระยะไกล หากแพลตฟอร์มการดำเนินการยังไม่ได้ตั้งค่า exec_properties
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--remote_default_platform_properties=<a string>
: "" - ตั้งค่าพร็อพเพอร์ตี้แพลตฟอร์มเริ่มต้นที่จะตั้งค่าสำหรับ API การดำเนินการระยะไกล หากแพลตฟอร์มการดำเนินการยังไม่ได้ตั้งค่า Remote_execution_properties ไว้ ระบบจะใช้ค่านี้ด้วยหากเลือกแพลตฟอร์มโฮสต์เป็นแพลตฟอร์มการดำเนินการสำหรับการดำเนินการจากระยะไกล
- รวมการใช้งานหลายรายการแล้ว
--remote_downloader_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอเครื่องมือดาวน์โหลดระยะไกล: --remote_downloader_header=Name=Value คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- รวมการใช้งานหลายรายการแล้ว
--remote_exec_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอการดำเนินการ: --remote_exec_header=Name=Value คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- ค่าเริ่มต้นของ
--remote_execution_priority=<an integer>
: "0" - ลำดับความสำคัญของการดำเนินการที่จะดำเนินการจากระยะไกล ความหมายของค่าลำดับความสำคัญหนึ่งๆ จะขึ้นอยู่กับเซิร์ฟเวอร์
- ค่าเริ่มต้น
--remote_executor=<a string>
: ดูรายละเอียด - HOST หรือ HOST:PORT ของปลายทางการดำเนินการระยะไกล สคีมาที่รองรับคือ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (UNIX Sockets) หากไม่ได้กำหนดสคีมาไว้ Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุ grpc:// หรือ unix: schema เพื่อปิดใช้ TLS
- ค่าเริ่มต้น
--remote_grpc_log=<a path>
: ดูรายละเอียด - หากระบุไว้ ระบบจะกำหนดเส้นทางไปยังไฟล์เพื่อบันทึกรายละเอียดที่เกี่ยวข้องกับการเรียกใช้ gRPC บันทึกนี้ประกอบด้วยลำดับของ com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry ที่ชื่อว่า ทำการ ทำการ ctrbufs ตามลำดับ โดยให้แต่ละข้อความนำหน้าด้วยตัวแปรที่แสดงถึงขนาดของข้อความ เป็นไฟล์ ctrbuf ที่ต่อเนื่องกันต่อไปนี้ ตามที่ดำเนินการโดยเมธอด LogEntry.writeDelimitedTo(ExportStream)
- รวมการใช้งานหลายรายการแล้ว
--remote_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอ: --remote_header=Name=Value คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- ค่าเริ่มต้นของ
--remote_instance_name=<a string>
: "" - ค่าที่จะส่งผ่านเป็นอินสแตนซ์_name ใน API การดำเนินการระยะไกล
- ค่าเริ่มต้นของ
--[no]remote_local_fallback
: "เท็จ" - กำหนดว่าจะกลับไปใช้กลยุทธ์การดำเนินการภายในเครื่องแบบสแตนด์อโลนหากการดำเนินการจากระยะไกลล้มเหลว
- ค่าเริ่มต้นของ
--remote_local_fallback_strategy=<a string>
: "ท้องถิ่น" - ไม่มีการดำเนินการ เลิกใช้งานไปแล้ว ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7480
- ค่าเริ่มต้นของ
--remote_max_connections=<an integer>
: "100" -
จำกัดจำนวนการเชื่อมต่อสูงสุดพร้อมกันไว้ที่แคช/ผู้ดำเนินการระยะไกล ค่าเริ่มต้นคือ 100 การตั้งค่านี้เป็น 0 หมายความว่าจะไม่มีข้อจำกัด
สำหรับแคชระยะไกลของ HTTP การเชื่อมต่อ TCP 1 รายการจะจัดการคำขอ 1 รายการต่อครั้ง ดังนั้น Bazel สามารถสร้างคำขอพร้อมกันถึง --remote_max_connections รายการ
สำหรับแคช/ไฟล์ดำเนินการระยะไกลของ gRPC ช่อง gRPC 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.>
: "5 วินาที" - การหน่วงเวลา Backoff สูงสุดระหว่างการลองใหม่จากระยะไกล หน่วยต่อไปนี้สามารถใช้ได้: วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
- ค่าเริ่มต้นของ
--remote_timeout=<An immutable length of time.>
: "60 วินาที" - ระยะเวลาสูงสุดในการรอการดำเนินการจากระยะไกลและการเรียกใช้แคช สำหรับแคช REST จะเป็นทั้งระยะหมดเวลาของการเชื่อมต่อและการอ่าน หน่วยต่อไปนี้สามารถใช้ได้: วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
- ค่าเริ่มต้นของ
--[no]remote_upload_local_results
: "จริง" - กำหนดว่าจะอัปโหลดผลการดำเนินการที่ดำเนินการในเครื่องไปยังแคชระยะไกลหรือไม่ หากรีโมตแคชรองรับและผู้ใช้ได้รับอนุญาตให้ดำเนินการ
- ค่าเริ่มต้นของ
--[no]remote_verify_downloads
: "จริง" - หากตั้งค่าเป็น "จริง" Bazel จะคำนวณผลรวมแฮชของการดาวน์โหลดจากระยะไกลทั้งหมด และทิ้งค่าที่แคชไว้จากระยะไกลหากไม่ตรงกับค่าที่คาดไว้
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้จัดหมวดหมู่:
- รวมการใช้งานหลายรายการแล้ว
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
รายการ - กำหนดค่าโปรแกรมช่วยข้อมูลเข้าสู่ระบบเพื่อใช้สำหรับเรียกข้อมูลเข้าสู่ระบบของการให้สิทธิ์สำหรับการดึงข้อมูลที่เก็บ การแคชและการดำเนินการจากระยะไกล รวมถึงบริการเหตุการณ์ของบิลด์ ข้อมูลเข้าสู่ระบบที่ผู้ช่วยเหลือมีให้จะมีความสำคัญเหนือกว่าข้อมูลรับรองที่ --google_default_credentials, --google_credentials, ไฟล์ .netrc หรือพารามิเตอร์ auth ไปยัง billing_ctx.download และ billing_ctx.download_and_extract นั้น อาจระบุได้หลายครั้งเพื่อตั้งค่าผู้ช่วยเหลือหลายราย ดูรายละเอียดได้ที่ https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md
- ค่าเริ่มต้นของ
--credential_helper_cache_duration=<An immutable length of time.>
: "30 นาที" - ระยะเวลาในการแคชข้อมูลเข้าสู่ระบบที่โปรแกรมช่วยรับรองข้อมูลเข้าสู่ระบบให้ไว้ การเรียกใช้ด้วยค่าที่แตกต่างกันจะปรับอายุการใช้งานของรายการที่มีอยู่ก่อนหน้า การส่งค่าเป็น 0 เพื่อล้างแคช คำสั่งสะอาดจะล้างแคชเสมอ โดยไม่คำนึงถึงแฟล็กนี้
- ค่าเริ่มต้นของ
--credential_helper_timeout=<An immutable length of time.>
: "10 วินาที" - กำหนดค่าระยะหมดเวลาสำหรับตัวช่วยข้อมูลเข้าสู่ระบบ ตัวช่วยข้อมูลเข้าสู่ระบบที่ไม่ตอบสนองภายในระยะหมดเวลานี้จะเรียกใช้ไม่สำเร็จ
- ค่าเริ่มต้นของ
--deleted_packages=<comma-separated list of package names>
: "" - รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริง แม้ว่าจะปรากฏในตำแหน่งใดบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ ตัวอย่างเช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์แล้ว ระบบบิลด์อาจร้องเรียนหากพบป้ายกำกับ "//x:y/z" หากมีป้ายกำกับ "//x:y/z" อยู่หากยังมีรายการ package_path อื่นอยู่ การระบุ --deleted_packages x/y จะหลีกเลี่ยงปัญหานี้
- ค่าเริ่มต้น
--disk_cache=<a path>
: ดูรายละเอียด - เส้นทางไปยังไดเรกทอรีที่ Bazel อ่านและเขียนการดำเนินการ รวมถึงเอาต์พุตของการดำเนินการได้ แต่หากไม่มี ระบบจะสร้างไดเรกทอรีดังกล่าวขึ้นมา
- ค่าเริ่มต้นของ
--google_auth_scopes=<comma-separated list of options>
: "https://www.googleapis.com/auth/cloud-platform" - รายการขอบเขตการตรวจสอบสิทธิ์ Google Cloud ที่คั่นด้วยคอมมา
- ค่าเริ่มต้น
--google_credentials=<a string>
: ดูรายละเอียด - ระบุไฟล์ที่จะรับข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication
- ค่าเริ่มต้นของ
--[no]google_default_credentials
: "เท็จ" - ระบุว่าจะใช้ "ข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชันของ Google" สำหรับการตรวจสอบสิทธิ์หรือไม่ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication ปิดใช้โดยค่าเริ่มต้น
- ค่าเริ่มต้น
--grpc_keepalive_time=<An immutable length of time.>
: ดูรายละเอียด - กำหนดค่าคําสั่ง ping แบบ Keep-alive สำหรับการเชื่อมต่อ gRPC ขาออก หากตั้งค่านี้ Bazel จะส่งคำสั่ง ping หลังจากไม่มีการดำเนินการอ่านการเชื่อมต่อเป็นเวลานานกว่านี้ แต่เฉพาะในกรณีที่มีการเรียกใช้ gRPC ที่รอดำเนินการอย่างน้อย 1 รายการ เวลาจะถือว่าเป็นรายละเอียดที่ 2 จึงถือเป็นข้อผิดพลาดในการตั้งค่าที่น้อยกว่า 1 วินาที โดยค่าเริ่มต้น การใช้คำสั่ง ping แบบ Keep-alive จะปิดใช้อยู่ คุณควรประสานงานกับเจ้าของบริการก่อนเปิดใช้การตั้งค่านี้ ตัวอย่างเช่น หากต้องการตั้งค่า 30 วินาทีเป็น Flag นี้ ก็ควรจะเป็น --grpc_keepalive_time=30s
- ค่าเริ่มต้นของ
--grpc_keepalive_timeout=<An immutable length of time.>
: "20 วินาที" - กำหนดค่าระยะหมดเวลา Keep-alive สำหรับการเชื่อมต่อ gRPC ขาออก หากเปิดใช้คำสั่ง ping แบบ Keep-alive พร้อมกับ --grpc_keepalive_time จากนั้น Bazel จะหมดเวลาการเชื่อมต่อหากไม่มีการตอบกลับคำสั่ง ping หลังผ่านไประยะหนึ่ง เวลาจะถือว่าเป็นรายละเอียดที่ 2 จึงถือเป็นข้อผิดพลาดในการตั้งค่าที่น้อยกว่า 1 วินาที หากปิดใช้คำสั่ง ping แบบ Keep-alive อยู่ ระบบจะไม่สนใจการตั้งค่านี้
- รวมการใช้งานหลายรายการแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace"
- ค่าเริ่มต้นของ
--package_path=<colon-separated list of options>
: "%workspace%" - รายการที่คั่นด้วยเครื่องหมายทวิภาคของตำแหน่งสำหรับค้นหาแพ็กเกจ องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับพื้นที่ทำงานที่ล้อมรอบอยู่ หากไม่ระบุหรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
- ค่าเริ่มต้นของ
--[no]show_loading_progress
: "จริง" - หากเปิดใช้จะทำให้ Bazel พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ"
- ค่าเริ่มต้น
--tls_certificate=<a string>
: ดูรายละเอียด - ระบุเส้นทางไปยังใบรับรอง TLS ที่เชื่อถือได้ให้ลงนามในใบรับรองเซิร์ฟเวอร์
- ค่าเริ่มต้น
--tls_client_certificate=<a string>
: ดูรายละเอียด - ระบุใบรับรองไคลเอ็นต์ TLS ที่จะใช้ โดยต้องระบุคีย์ไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
- ค่าเริ่มต้น
--tls_client_key=<a string>
: ดูรายละเอียด - ระบุคีย์ไคลเอ็นต์ TLS ที่จะใช้ นอกจากนี้ คุณยังต้องระบุใบรับรองไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
ตัวเลือกความช่วยเหลือ
- ตัวเลือกที่ปรากฏก่อนคำสั่งและถูกแยกวิเคราะห์โดยไคลเอ็นต์ ได้แก่
- รวมการใช้งานหลายรายการแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบแคช แทนที่จะคัดลอก โดยมีจุดประสงค์เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่มาจาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม ซึ่งสามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ส่งผลให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_repository_disable_download
: "เท็จ" -
หากมีการตั้งค่า ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองแก้ไขข้อผิดพลาดในการดาวน์โหลดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานได้ในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้นของ
--http_timeout_scaling=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลด HTTP ตามปัจจัยที่กำหนด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูรายละเอียด -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตการสร้างที่ถูกต้อง (การกำหนดกฎ การรวมแฟล็ก ฯลฯ)
- ค่าเริ่มต้นของ
--experimental_repository_hash_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรยืนยันแฮชไดเรกทอรีที่เก็บ
แท็ก:affects_outputs
,experimental
- รวมการใช้งานหลายรายการแล้ว
--experimental_verify_repository_rules=<a string>
รายการ -
หากรายการกฎที่เก็บซึ่งควรยืนยันแฮชของไดเรกทอรีเอาต์พุต ระบบจะระบุไฟล์โดย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ API ของบิลด์ที่เข้าถึงได้ด้วยการสร้างไฟล์ .bzl หรือไฟล์ WORKSPACE
- ค่าเริ่มต้นของ
--[no]experimental_allow_top_level_aspects_parameters
: "จริง" -
ไม่ดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
- รวมการใช้งานหลายรายการแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ซึ่งจะอนุญาตให้ใช้ในกราฟการอ้างอิงที่แก้ไขแล้วแม้ว่าจะมีการประกาศว่าได้รับการแย้งในรีจิสทรีที่เป็นแหล่งที่มา (หากเว็บไซต์ไม่ได้มาจาก NonRegistryReplace) มิฉะนั้น เวอร์ชันที่ยัดเยียดจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชัน yank ที่อนุญาตได้ด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" คุณสามารถปิดใช้งานการตรวจสอบนี้ได้โดยใช้คำหลัก "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ หรือ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบว่าข้อมูลไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบที่ไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าทรัพยากร Dependency ดังกล่าวจะถูกละเว้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท โดยไม่คำนึงถึงค่าของแฟล็กนี้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--lockfile_mode=<off, update or error>
: "ปิด" -
ระบุว่าจะใช้ Lockfile อย่างไรและจะใช้หรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ Lockfile และอัปเดตเมื่อมีการเปลี่ยนแปลง "ข้อผิดพลาด" ให้ใช้ Lockfile แต่จะแสดงข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่ออ่านหรือเขียนไฟล์ล็อกทั้ง 2 ไฟล์
แท็ก: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
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งการบันทึกมีดังนี้
- ค่าเริ่มต้นของ
--[no]experimental_record_metrics_for_all_mnemonics
: "เท็จ" - โดยค่าเริ่มต้น ประเภทการดําเนินการจะจํากัดอยู่ที่ 20 ประเภทที่มีจำนวนการดำเนินการสูงสุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสําหรับการช่วยจำทั้งหมด
- ค่าเริ่มต้นของ
--help_verbosity=<long, medium or short>
: "ปานกลาง" -
เลือกการพูดรายละเอียดคำสั่งช่วยเหลือ
แท็ก:affects_outputs
,terminal_output
--long
[-l
]-
แสดงคำอธิบายแบบเต็มของแต่ละตัวเลือก แทนที่จะแสดงเพียงชื่อตัวเลือก
ขยายเป็น
--help_verbosity=long
แท็ก:affects_outputs
,terminal_output
--short
-
แสดงเฉพาะชื่อของตัวเลือก ไม่แสดงประเภทหรือความหมายของตัวเลือก
ขยายไปยัง
--help_verbosity=short
แท็ก:affects_outputs
,terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปในคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ค่าเริ่มต้นของ
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
หากเว้นว่างไว้ ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล
- ค่าเริ่มต้น
--experimental_downloader_config=<a string>
: ดูรายละเอียด - ระบุไฟล์ที่จะใช้กำหนดค่าเครื่องมือดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด โดยแต่ละบรรทัดจะขึ้นต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือ 2 รูปแบบ รูปแบบหนึ่งเพื่อจับคู่กับ และอีกแบบหนึ่งใช้เป็น URL แทนโดยมีการอ้างอิงย้อนกลับที่เริ่มจาก "$1" เป็นไปได้ที่คำสั่ง "rewrite" อาจมีผลลัพธ์ใน URL เดียวกันหลายรายการ และระบบจะส่ง URL เดียวกันนี้กลับไปหลายรายการสำหรับ URL เดียวกัน)
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้จัดหมวดหมู่:
- รวมการใช้งานหลายรายการแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace"
ตัวเลือกข้อมูล
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคำสั่งและถูกแยกวิเคราะห์โดยไคลเอ็นต์ ได้แก่
- รวมการใช้งานหลายรายการแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบแคช แทนที่จะคัดลอก โดยมีจุดประสงค์เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่มาจาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม ซึ่งสามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ส่งผลให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_repository_disable_download
: "เท็จ" -
หากมีการตั้งค่า ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองแก้ไขข้อผิดพลาดในการดาวน์โหลดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานได้ในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้นของ
--http_timeout_scaling=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลด HTTP ตามปัจจัยที่กำหนด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูรายละเอียด -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตการสร้างที่ถูกต้อง (การกำหนดกฎ การรวมแฟล็ก ฯลฯ)
- ค่าเริ่มต้นของ
--experimental_repository_hash_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรยืนยันแฮชไดเรกทอรีที่เก็บ
แท็ก:affects_outputs
,experimental
- รวมการใช้งานหลายรายการแล้ว
--experimental_verify_repository_rules=<a string>
รายการ -
หากรายการกฎที่เก็บซึ่งควรยืนยันแฮชของไดเรกทอรีเอาต์พุต ระบบจะระบุไฟล์โดย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ API ของบิลด์ที่เข้าถึงได้ด้วยการสร้างไฟล์ .bzl หรือไฟล์ WORKSPACE
- ค่าเริ่มต้นของ
--[no]experimental_allow_top_level_aspects_parameters
: "จริง" -
ไม่ดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
- รวมการใช้งานหลายรายการแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ซึ่งจะอนุญาตให้ใช้ในกราฟการอ้างอิงที่แก้ไขแล้วแม้ว่าจะมีการประกาศว่าได้รับการแย้งในรีจิสทรีที่เป็นแหล่งที่มา (หากเว็บไซต์ไม่ได้มาจาก NonRegistryReplace) มิฉะนั้น เวอร์ชันที่ยัดเยียดจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชัน yank ที่อนุญาตได้ด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" คุณสามารถปิดใช้งานการตรวจสอบนี้ได้โดยใช้คำหลัก "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ หรือ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบว่าข้อมูลไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบที่ไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าทรัพยากร Dependency ดังกล่าวจะถูกละเว้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท โดยไม่คำนึงถึงค่าของแฟล็กนี้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--lockfile_mode=<off, update or error>
: "ปิด" -
ระบุว่าจะใช้ Lockfile อย่างไรและจะใช้หรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ Lockfile และอัปเดตเมื่อมีการเปลี่ยนแปลง "ข้อผิดพลาด" ให้ใช้ Lockfile แต่จะแสดงข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่ออ่านหรือเขียนไฟล์ล็อกทั้ง 2 ไฟล์
แท็ก: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
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งการบันทึกมีดังนี้
- ค่าเริ่มต้นของ
--[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 เดียวกันนี้กลับไปหลายรายการสำหรับ URL เดียวกัน)
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้จัดหมวดหมู่:
- รวมการใช้งานหลายรายการแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace"
ตัวเลือกใบอนุญาต
- ตัวเลือกที่ปรากฏก่อนคำสั่งและถูกแยกวิเคราะห์โดยไคลเอ็นต์ ได้แก่
- รวมการใช้งานหลายรายการแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบแคช แทนที่จะคัดลอก โดยมีจุดประสงค์เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่มาจาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม ซึ่งสามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ส่งผลให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_repository_disable_download
: "เท็จ" -
หากมีการตั้งค่า ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองแก้ไขข้อผิดพลาดในการดาวน์โหลดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานได้ในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้นของ
--http_timeout_scaling=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลด HTTP ตามปัจจัยที่กำหนด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูรายละเอียด -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตการสร้างที่ถูกต้อง (การกำหนดกฎ การรวมแฟล็ก ฯลฯ)
- ค่าเริ่มต้นของ
--experimental_repository_hash_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรยืนยันแฮชไดเรกทอรีที่เก็บ
แท็ก:affects_outputs
,experimental
- รวมการใช้งานหลายรายการแล้ว
--experimental_verify_repository_rules=<a string>
รายการ -
หากรายการกฎที่เก็บซึ่งควรยืนยันแฮชของไดเรกทอรีเอาต์พุต ระบบจะระบุไฟล์โดย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ API ของบิลด์ที่เข้าถึงได้ด้วยการสร้างไฟล์ .bzl หรือไฟล์ WORKSPACE
- ค่าเริ่มต้นของ
--[no]experimental_allow_top_level_aspects_parameters
: "จริง" -
ไม่ดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
- รวมการใช้งานหลายรายการแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ซึ่งจะอนุญาตให้ใช้ในกราฟการอ้างอิงที่แก้ไขแล้วแม้ว่าจะมีการประกาศว่าได้รับการแย้งในรีจิสทรีที่เป็นแหล่งที่มา (หากเว็บไซต์ไม่ได้มาจาก NonRegistryReplace) มิฉะนั้น เวอร์ชันที่ยัดเยียดจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชัน yank ที่อนุญาตได้ด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" คุณสามารถปิดใช้งานการตรวจสอบนี้ได้โดยใช้คำหลัก "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ หรือ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบว่าข้อมูลไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบที่ไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าทรัพยากร Dependency ดังกล่าวจะถูกละเว้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท โดยไม่คำนึงถึงค่าของแฟล็กนี้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--lockfile_mode=<off, update or error>
: "ปิด" -
ระบุว่าจะใช้ Lockfile อย่างไรและจะใช้หรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ Lockfile และอัปเดตเมื่อมีการเปลี่ยนแปลง "ข้อผิดพลาด" ให้ใช้ Lockfile แต่จะแสดงข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่ออ่านหรือเขียนไฟล์ล็อกทั้ง 2 ไฟล์
แท็ก: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
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งการบันทึกมีดังนี้
- ค่าเริ่มต้นของ
--[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") หรือ 2 รูปแบบ รูปแบบหนึ่งเพื่อจับคู่กับ และอีกแบบหนึ่งใช้เป็น URL แทนโดยมีการอ้างอิงย้อนกลับที่เริ่มจาก "$1" เป็นไปได้ที่คำสั่ง "rewrite" อาจมีผลลัพธ์ใน URL เดียวกันหลายรายการ และระบบจะส่ง URL เดียวกันนี้กลับไปหลายรายการสำหรับ URL เดียวกัน)
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้จัดหมวดหมู่:
- รวมการใช้งานหลายรายการแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace"
ตัวเลือกการติดตั้งบนอุปกรณ์เคลื่อนที่
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคำสั่งและถูกแยกวิเคราะห์โดยไคลเอ็นต์ ได้แก่
- รวมการใช้งานหลายรายการแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบแคช แทนที่จะคัดลอก โดยมีจุดประสงค์เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่มาจาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม ซึ่งสามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ส่งผลให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_repository_disable_download
: "เท็จ" -
หากมีการตั้งค่า ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองแก้ไขข้อผิดพลาดในการดาวน์โหลดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานได้ในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้นของ
--http_timeout_scaling=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลด HTTP ตามปัจจัยที่กำหนด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูรายละเอียด -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการดำเนินการบิลด์มีดังนี้
- ค่าเริ่มต้นของ
--mode=<classic, classic_internal_test_do_not_use or skylark>
: "คลาสสิก" -
เลือกวิธีเรียกใช้การติดตั้งบนอุปกรณ์เคลื่อนที่ "คลาสสิก" เรียกใช้การติดตั้งบนอุปกรณ์เคลื่อนที่เวอร์ชันปัจจุบัน "skylark" ใช้ Starlark เวอร์ชันใหม่ ซึ่งรองรับ android_test
แท็ก:loading_and_analysis
,execution
,incompatible_change
- ตัวเลือกที่กำหนดค่าห่วงโซ่เครื่องมือที่ใช้สำหรับการดำเนินการดำเนินการมีดังนี้
- ค่าเริ่มต้นของ
--adb=<a string>
: "" -
ไบนารี adb ที่จะใช้สำหรับคำสั่ง "mobile-install" หากไม่ระบุ ระบบจะใช้อันใน Android SDK ที่ระบุโดยตัวเลือกบรรทัดคำสั่ง --android_sdk (หรือ SDK เริ่มต้นหากไม่ได้ระบุ --android_sdk)
แท็กchanges_inputs
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่งมีดังนี้
- ค่าเริ่มต้นของ
--[no]incremental
: "เท็จ" -
ระบุว่าต้องทำการติดตั้งแบบค่อยเป็นค่อยไป หากเป็น "จริง" ให้พยายามหลีกเลี่ยงการทำงานเพิ่มเติมที่ไม่จำเป็นโดยการอ่านสถานะของอุปกรณ์ที่จะติดตั้งโค้ด และใช้ข้อมูลดังกล่าวเพื่อหลีกเลี่ยงการทำงานที่ไม่จำเป็น หากเป็น "เท็จ" (ค่าเริ่มต้น) ให้ทำการติดตั้งแบบเต็มเสมอ
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]split_apks
: "เท็จ" -
ระบุว่าจะใช้ APK แยกเพื่อติดตั้งและอัปเดตแอปพลิเคชันในอุปกรณ์หรือไม่ ใช้ได้เฉพาะกับอุปกรณ์ที่ใช้ Marshmallow ขึ้นไป
แท็ก:loading_and_analysis
,affects_outputs
- ตัวเลือกที่ช่วยให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการ ซึ่งส่งผลต่อค่า ไม่ใช่ที่มีอยู่
- รวมการใช้งานหลายรายการแล้ว
--adb_arg=<a string>
รายการ -
อาร์กิวเมนต์เพิ่มเติมสำหรับส่งผ่านไปยัง adb โดยปกติจะใช้เพื่อระบุอุปกรณ์ที่จะติดตั้ง
แท็ก:action_command_lines
--debug_app
-
กำหนดว่าต้องรอโปรแกรมแก้ไขข้อบกพร่องก่อนที่จะเริ่มแอปหรือไม่
ขยายการทำงานดังนี้
--start=DEBUG
แท็ก:execution
- ค่าเริ่มต้นของ
--device=<a string>
: "" -
หมายเลขซีเรียลของอุปกรณ์ adb หากไม่ได้ระบุไว้ ระบบจะใช้อุปกรณ์เครื่องแรก
แท็ก:action_command_lines
- ค่าเริ่มต้นของ
--start=<no, cold, warm or debug>
: "ไม่" -
วิธีที่แอปควรเริ่มทำงานหลังจากติดตั้ง ตั้งค่าเป็น WARM เพื่อเก็บรักษาและคืนค่าสถานะของแอปพลิเคชันในการติดตั้งที่เพิ่มขึ้น
แท็ก:execution
--start_app
-
กำหนดว่าจะเริ่มต้นแอปหลังจากติดตั้งหรือไม่
ขยายไปยัง
--start=COLD
แท็ก:execution
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตการสร้างที่ถูกต้อง (การกำหนดกฎ การรวมแฟล็ก ฯลฯ)
- ค่าเริ่มต้นของ
--experimental_repository_hash_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรยืนยันแฮชไดเรกทอรีที่เก็บ
แท็ก:affects_outputs
,experimental
- รวมการใช้งานหลายรายการแล้ว
--experimental_verify_repository_rules=<a string>
รายการ -
หากรายการกฎที่เก็บซึ่งควรยืนยันแฮชของไดเรกทอรีเอาต์พุต ระบบจะระบุไฟล์โดย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ API ของบิลด์ที่เข้าถึงได้ด้วยการสร้างไฟล์ .bzl หรือไฟล์ WORKSPACE
- ค่าเริ่มต้นของ
--[no]experimental_allow_top_level_aspects_parameters
: "จริง" -
ไม่ดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
- รวมการใช้งานหลายรายการแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ซึ่งจะอนุญาตให้ใช้ในกราฟการอ้างอิงที่แก้ไขแล้วแม้ว่าจะมีการประกาศว่าได้รับการแย้งในรีจิสทรีที่เป็นแหล่งที่มา (หากเว็บไซต์ไม่ได้มาจาก NonRegistryReplace) มิฉะนั้น เวอร์ชันที่ยัดเยียดจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชัน yank ที่อนุญาตได้ด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" คุณสามารถปิดใช้งานการตรวจสอบนี้ได้โดยใช้คำหลัก "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ หรือ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบว่าข้อมูลไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบที่ไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าทรัพยากร Dependency ดังกล่าวจะถูกละเว้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท โดยไม่คำนึงถึงค่าของแฟล็กนี้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--lockfile_mode=<off, update or error>
: "ปิด" -
ระบุว่าจะใช้ Lockfile อย่างไรและจะใช้หรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ Lockfile และอัปเดตเมื่อมีการเปลี่ยนแปลง "ข้อผิดพลาด" ให้ใช้ Lockfile แต่จะแสดงข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่ออ่านหรือเขียนไฟล์ล็อกทั้ง 2 ไฟล์
แท็ก: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
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งการบันทึกมีดังนี้
- ค่าเริ่มต้นของ
--[no]experimental_record_metrics_for_all_mnemonics
: "เท็จ" - โดยค่าเริ่มต้น ประเภทการดําเนินการจะจํากัดอยู่ที่ 20 ประเภทที่มีจำนวนการดำเนินการสูงสุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสําหรับการช่วยจำทั้งหมด
- ค่าเริ่มต้นของ
--incremental_install_verbosity=<a string>
: "" -
รายละเอียดสำหรับการติดตั้งเพิ่มเติม ตั้งค่าเป็น 1 เพื่อบันทึกการแก้ไขข้อบกพร่อง
แท็ก:bazel_monitoring
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ค่าเริ่มต้นของ
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
หากเว้นว่างไว้ ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล
- ค่าเริ่มต้น
--experimental_downloader_config=<a string>
: ดูรายละเอียด - ระบุไฟล์ที่จะใช้กำหนดค่าเครื่องมือดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด โดยแต่ละบรรทัดจะขึ้นต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือ 2 รูปแบบ รูปแบบหนึ่งเพื่อจับคู่กับ และอีกแบบหนึ่งใช้เป็น URL แทนโดยมีการอ้างอิงย้อนกลับที่เริ่มจาก "$1" เป็นไปได้ที่คำสั่ง "rewrite" อาจมีผลลัพธ์ใน URL เดียวกันหลายรายการ และระบบจะส่ง URL เดียวกันนี้กลับไปหลายรายการสำหรับ URL เดียวกัน)
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้จัดหมวดหมู่:
- รวมการใช้งานหลายรายการแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace"
ตัวเลือกม็อด
- ตัวเลือกที่ปรากฏก่อนคำสั่งและถูกแยกวิเคราะห์โดยไคลเอ็นต์ ได้แก่
- รวมการใช้งานหลายรายการแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบแคช แทนที่จะคัดลอก โดยมีจุดประสงค์เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่มาจาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม ซึ่งสามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ส่งผลให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_repository_disable_download
: "เท็จ" -
หากมีการตั้งค่า ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองแก้ไขข้อผิดพลาดในการดาวน์โหลดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานได้ในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้นของ
--http_timeout_scaling=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลด HTTP ตามปัจจัยที่กำหนด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูรายละเอียด -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการดำเนินการบิลด์มีดังนี้
--[no]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") ตามด้วยการดำเนินการ ([-|*]<Flo>) เช่น "auto", "HOST_CPUS*.5" "auto" ตั้งค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมของแฟล็ก ฯลฯ)
- ค่าเริ่มต้นของ
--experimental_repository_hash_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรยืนยันแฮชไดเรกทอรีที่เก็บ
แท็ก:affects_outputs
,experimental
- รวมการใช้งานหลายรายการแล้ว
--experimental_verify_repository_rules=<a string>
รายการ -
หากรายการกฎที่เก็บซึ่งควรยืนยันแฮชของไดเรกทอรีเอาต์พุต ระบบจะระบุไฟล์โดย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ API ของบิลด์ที่เข้าถึงได้ด้วยการสร้างไฟล์ .bzl หรือไฟล์ WORKSPACE
- ค่าเริ่มต้นของ
--[no]experimental_allow_top_level_aspects_parameters
: "จริง" -
ไม่ดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ค่าเริ่มต้นของ
--[no]incompatible_config_setting_private_default_visibility
: "เท็จ" -
หากแฟล็กนี้เป็นเท็จ config_setting ที่ไม่มีแอตทริบิวต์การเปิดเผยอย่างชัดเจนจะเป็น //visibility:public หากแฟล็กนี้เป็นจริง config_setting จะใช้ตรรกะการแสดงผลเดียวกันกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_enforce_config_setting_visibility
: "จริง" -
หากเป็น "จริง" ให้บังคับใช้ข้อจํากัดระดับการเข้าถึง config_setting หากเป็น "เท็จ" ทุก config_setting จะปรากฏกับทุกเป้าหมาย ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของคำสั่งย่อย "mod":
- ค่าเริ่มต้นของ
--base_module=<"<root>" for the root module; <module>@<version> for a specific version of a module; <module> for all versions of a module; @<name> for a repo with the given apparent name; or @@<name> for a repo with the given canonical name>
: "<root>" -
ระบุโมดูลที่เกี่ยวข้องกับที่เก็บเป้าหมายที่ระบุ
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--charset=<utf8 or ascii>
: "utf8" -
เลือกชุดอักขระที่จะใช้กับโครงสร้างนี้ มีผลเฉพาะกับเอาต์พุตข้อความ ค่าที่ถูกต้องคือ "utf8" หรือ "ascii" ค่าเริ่มต้นคือ "utf8"
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]cycles
: "เท็จ" -
ระบุรอบทรัพยากร Dependency ในแผนผังที่แสดง ซึ่งโดยปกติแล้วจะไม่สนใจ
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--depth=<an integer>
: "-1" -
ความลึกในการแสดงผลสูงสุดของแผนผังทรัพยากร Dependency เช่น ความลึก 1 จะแสดงทรัพยากร Dependency โดยตรง สำหรับ Tree, path และ all_paths จะมีค่าเริ่มต้นเป็น IntegerMAX_VALUE ขณะที่ deps และอธิบายค่าเริ่มต้นเป็น 1 (แสดงเฉพาะ Deps ของรากโดยตรง นอกเหนือจากต้นใบเป้าหมายและต้นกำเนิด)
แท็ก:terminal_output
- ค่าเริ่มต้น
--extension_filter=<a comma-separated list of <extension>s>
: ดูรายละเอียด -
โปรดแสดงเฉพาะการใช้งานส่วนขยายโมดูลเหล่านี้และที่เก็บที่สร้างขึ้นจากส่วนขยายในกรณีที่มีการตั้งค่าแฟล็กที่เกี่ยวข้อง หากตั้งค่าไว้ กราฟผลลัพธ์จะรวมเฉพาะเส้นทางที่มีโมดูลที่ใช้ส่วนขยายที่ระบุ รายการที่ว่างเปล่าจะเป็นการปิดใช้ตัวกรอง ซึ่งระบุส่วนขยายที่เป็นไปได้ทั้งหมดได้อย่างมีประสิทธิภาพ
แท็ก:terminal_output
- ค่าเริ่มต้น
--extension_info=<hidden, usages, repos or all>
: "ซ่อนอยู่" -
ระบุรายละเอียดเกี่ยวกับการใช้งานส่วนขยายที่จะรวมไว้ในผลการค้นหา "การใช้งาน" จะแสดงเฉพาะชื่อส่วนขยายเท่านั้น "repos" จะรวม repos ที่นำเข้าพร้อม use_repo และ "all" จะแสดงที่เก็บอื่นๆ ที่สร้างโดยส่วนขยายด้วย
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--extension_usages=<a comma-separated list of <module>s>
: "" -
ระบุโมดูลที่มีการใช้งานส่วนขยายที่จะแสดงในการค้นหา show_extension
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--from=<a comma-separated list of <module>s>
: "<root>" -
โมดูลที่เริ่มจากการค้นหากราฟการอ้างอิงจะแสดงขึ้น ตรวจสอบคำอธิบายการค้นหาแต่ละรายการเพื่อดูความหมายที่แท้จริง ค่าเริ่มต้นจะเป็น <root>
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]include_builtin
: "เท็จ" -
รวมโมดูลในตัวในกราฟการอ้างอิง ปิดใช้งานโดยค่าเริ่มต้นเนื่องจากเสียงค่อนข้างดัง
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]include_unused
: "เท็จ" -
การค้นหาจะพิจารณาและแสดงโมดูลที่ไม่ได้ใช้ด้วย ซึ่งจะไม่แสดงในกราฟความละเอียดของโมดูลหลังจากการเลือก (เนื่องจากกฎการเลือกเวอร์ชันขั้นต่ำหรือกฎการลบล้าง) ซึ่งอาจให้ผลที่แตกต่างกันไปสำหรับการค้นหาแต่ละประเภท เช่น การใส่เส้นทางใหม่ในคำสั่ง all_paths หรือการเพิ่มทรัพยากร Dependency ในคำสั่งอธิบาย
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--output=<text, json or graph>
: "ข้อความ" -
รูปแบบที่ควรพิมพ์ผลการค้นหา ค่าที่อนุญาตสำหรับการค้นหา ได้แก่ text, json, กราฟ
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]verbose
: "เท็จ" -
การค้นหาจะแสดงสาเหตุที่โมดูลได้รับการแก้ไขเป็นเวอร์ชันปัจจุบันด้วย (หากมีการเปลี่ยนแปลง) ค่าเริ่มต้นจะเป็น true สำหรับคำค้นหาคำอธิบายเท่านั้น
แท็ก:terminal_output
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุต Bzlmod และอรรถศาสตร์
- รวมการใช้งานหลายรายการแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ซึ่งจะอนุญาตให้ใช้ในกราฟการอ้างอิงที่แก้ไขแล้วแม้ว่าจะมีการประกาศว่าได้รับการแย้งในรีจิสทรีที่เป็นแหล่งที่มา (หากเว็บไซต์ไม่ได้มาจาก NonRegistryReplace) มิฉะนั้น เวอร์ชันที่ยัดเยียดจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชัน yank ที่อนุญาตได้ด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" คุณสามารถปิดใช้งานการตรวจสอบนี้ได้โดยใช้คำหลัก "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ หรือ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบว่าข้อมูลไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบที่ไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าทรัพยากร Dependency ดังกล่าวจะถูกละเว้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท โดยไม่คำนึงถึงค่าของแฟล็กนี้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--lockfile_mode=<off, update or error>
: "ปิด" -
ระบุว่าจะใช้ Lockfile อย่างไรและจะใช้หรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ Lockfile และอัปเดตเมื่อมีการเปลี่ยนแปลง "ข้อผิดพลาด" ให้ใช้ Lockfile แต่จะแสดงข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่ออ่านหรือเขียนไฟล์ล็อกทั้ง 2 ไฟล์
แท็ก: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
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งการบันทึกมีดังนี้
- ค่าเริ่มต้นของ
--[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") หรือ 2 รูปแบบ รูปแบบหนึ่งเพื่อจับคู่กับ และอีกแบบหนึ่งใช้เป็น URL แทนโดยมีการอ้างอิงย้อนกลับที่เริ่มจาก "$1" เป็นไปได้ที่คำสั่ง "rewrite" อาจมีผลลัพธ์ใน URL เดียวกันหลายรายการ และระบบจะส่ง URL เดียวกันนี้กลับไปหลายรายการสำหรับ URL เดียวกัน)
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้จัดหมวดหมู่:
- ค่าเริ่มต้นของ
--deleted_packages=<comma-separated list of package names>
: "" - รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริง แม้ว่าจะปรากฏในตำแหน่งใดบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ ตัวอย่างเช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์แล้ว ระบบบิลด์อาจร้องเรียนหากพบป้ายกำกับ "//x:y/z" หากมีป้ายกำกับ "//x:y/z" อยู่หากยังมีรายการ package_path อื่นอยู่ การระบุ --deleted_packages x/y จะหลีกเลี่ยงปัญหานี้
- รวมการใช้งานหลายรายการแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace"
- ค่าเริ่มต้นของ
--package_path=<colon-separated list of options>
: "%workspace%" - รายการที่คั่นด้วยเครื่องหมายทวิภาคของตำแหน่งสำหรับค้นหาแพ็กเกจ องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับพื้นที่ทำงานที่ล้อมรอบอยู่ หากไม่ระบุหรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
- ค่าเริ่มต้นของ
--[no]show_loading_progress
: "จริง" - หากเปิดใช้จะทำให้ Bazel พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ"
ตัวเลือก Print_action
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคำสั่งและถูกแยกวิเคราะห์โดยไคลเอ็นต์ ได้แก่
- รวมการใช้งานหลายรายการแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบแคช แทนที่จะคัดลอก โดยมีจุดประสงค์เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่มาจาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม ซึ่งสามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ส่งผลให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_repository_disable_download
: "เท็จ" -
หากมีการตั้งค่า ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองแก้ไขข้อผิดพลาดในการดาวน์โหลดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานได้ในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้นของ
--http_timeout_scaling=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลด HTTP ตามปัจจัยที่กำหนด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูรายละเอียด -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตการสร้างที่ถูกต้อง (การกำหนดกฎ การรวมแฟล็ก ฯลฯ)
- ค่าเริ่มต้นของ
--experimental_repository_hash_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรยืนยันแฮชไดเรกทอรีที่เก็บ
แท็ก:affects_outputs
,experimental
- รวมการใช้งานหลายรายการแล้ว
--experimental_verify_repository_rules=<a string>
รายการ -
หากรายการกฎที่เก็บซึ่งควรยืนยันแฮชของไดเรกทอรีเอาต์พุต ระบบจะระบุไฟล์โดย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ API ของบิลด์ที่เข้าถึงได้ด้วยการสร้างไฟล์ .bzl หรือไฟล์ WORKSPACE
- ค่าเริ่มต้นของ
--[no]experimental_allow_top_level_aspects_parameters
: "จริง" -
ไม่ดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
- รวมการใช้งานหลายรายการแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ซึ่งจะอนุญาตให้ใช้ในกราฟการอ้างอิงที่แก้ไขแล้วแม้ว่าจะมีการประกาศว่าได้รับการแย้งในรีจิสทรีที่เป็นแหล่งที่มา (หากเว็บไซต์ไม่ได้มาจาก NonRegistryReplace) มิฉะนั้น เวอร์ชันที่ยัดเยียดจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชัน yank ที่อนุญาตได้ด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" คุณสามารถปิดใช้งานการตรวจสอบนี้ได้โดยใช้คำหลัก "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ หรือ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบว่าข้อมูลไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบที่ไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าทรัพยากร Dependency ดังกล่าวจะถูกละเว้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท โดยไม่คำนึงถึงค่าของแฟล็กนี้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--lockfile_mode=<off, update or error>
: "ปิด" -
ระบุว่าจะใช้ Lockfile อย่างไรและจะใช้หรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ Lockfile และอัปเดตเมื่อมีการเปลี่ยนแปลง "ข้อผิดพลาด" ให้ใช้ Lockfile แต่จะแสดงข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่ออ่านหรือเขียนไฟล์ล็อกทั้ง 2 ไฟล์
แท็ก: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
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งการบันทึกมีดังนี้
- ค่าเริ่มต้นของ
--[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") หรือ 2 รูปแบบ รูปแบบหนึ่งเพื่อจับคู่กับ และอีกแบบหนึ่งใช้เป็น URL แทนโดยมีการอ้างอิงย้อนกลับที่เริ่มจาก "$1" เป็นไปได้ที่คำสั่ง "rewrite" อาจมีผลลัพธ์ใน URL เดียวกันหลายรายการ และระบบจะส่ง URL เดียวกันนี้กลับไปหลายรายการสำหรับ URL เดียวกัน)
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้จัดหมวดหมู่:
- รวมการใช้งานหลายรายการแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace"
- รวมการใช้งานหลายรายการแล้ว
--print_action_mnemonics=<a string>
รายการ - แสดงรายการการช่วยจำที่จะใช้กรองข้อมูล Print_action โดยไม่กรองเมื่อปล่อยว่างไว้
ตัวเลือกการค้นหา
- ตัวเลือกที่ปรากฏก่อนคำสั่งและถูกแยกวิเคราะห์โดยไคลเอ็นต์ ได้แก่
- รวมการใช้งานหลายรายการแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบแคช แทนที่จะคัดลอก โดยมีจุดประสงค์เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่มาจาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม ซึ่งสามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ส่งผลให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_repository_disable_download
: "เท็จ" -
หากมีการตั้งค่า ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองแก้ไขข้อผิดพลาดในการดาวน์โหลดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานได้ในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้นของ
--http_timeout_scaling=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลด HTTP ตามปัจจัยที่กำหนด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูรายละเอียด -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการดำเนินการบิลด์มีดังนี้
- ค่าเริ่มต้นของ
--[no]incompatible_remote_dangling_symlinks
: "จริง" -
หากตั้งค่าเป็น "จริง" และ --incompatible_remote_symlinks ก็เป็นจริงด้วยเช่นกัน ลิงก์สัญลักษณ์ในเอาต์พุตการดำเนินการจะได้รับอนุญาตให้ห้อยลง
แท็ก:execution
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remote_symlinks
: "จริง" -
หากตั้งค่าเป็น "จริง" Bazel จะแสดงลิงก์สัญลักษณ์ในเอาต์พุตการดำเนินการในโปรโตคอลการแคช/การดำเนินการระยะไกลในลักษณะดังกล่าว มิฉะนั้นระบบจะติดตามลิงก์สัญลักษณ์และแสดงเป็นไฟล์หรือไดเรกทอรี ดูรายละเอียดได้ที่ #6631
แท็ก:execution
,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") ตามด้วยการดำเนินการ ([-|*]<Flo>) เช่น "auto", "HOST_CPUS*.5" "auto" ตั้งค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ช่วยให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการ ซึ่งจะส่งผลต่อค่าแทนการมีอยู่
- ค่าเริ่มต้นของ
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
จำนวนไฟล์เปิดสูงสุดที่อนุญาตระหว่างการอัปโหลดอาร์ติแฟกต์ BEP
แท็ก:affects_outputs
--remote_download_minimal
-
ไม่ดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลไปยังเครื่องภายใน ค่าสถานะนี้เป็นทางลัดสำหรับแฟล็ก --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_เอาต์พุต_metadata และ --remote_download_outputs=minimal
ขยายเป็น
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--remote_download_outputs=<all, minimal or toplevel>
: "ทั้งหมด" -
หากตั้งค่าเป็น "ต่ำสุด" จะไม่ดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลใดๆ ไปยังเครื่องในระบบ ยกเว้นเอาต์พุตที่การดำเนินการในเครื่องต้องการ หากตั้งค่าเป็น "ระดับบนสุด" จะมีการทำงานเหมือน "ต่ำสุด" เว้นแต่ว่าจะดาวน์โหลดเอาต์พุตของเป้าหมายระดับบนสุดไปยังเครื่องภายในด้วย ทั้ง 2 ตัวเลือกช่วยลดเวลาในการสร้างได้อย่างมากหากแบนด์วิดท์ของเครือข่ายเป็นจุดคอขวด
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--remote_download_symlink_template=<a string>
: "" -
สร้างลิงก์สัญลักษณ์แทนการดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลไปยังเครื่องภายใน สามารถระบุเป้าหมายของลิงก์สัญลักษณ์ในรูปแบบของสตริงเทมเพลตได้ สตริงเทมเพลตนี้อาจมี {hash} และ {size_bytes} ที่ขยายเป็นแฮชของออบเจ็กต์และขนาดเป็นไบต์ตามลำดับ เช่น ลิงก์สัญลักษณ์เหล่านี้อาจชี้ไปยังระบบไฟล์ FUSE ที่โหลดออบเจ็กต์จาก CAS ออนดีมานด์
แท็ก:affects_outputs
--remote_download_toplevel
-
ดาวน์โหลดเฉพาะเอาต์พุตระยะไกลของเป้าหมายระดับบนสุดไปยังเครื่องภายในเท่านั้น ค่าสถานะนี้เป็นทางลัดสำหรับแฟล็ก --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata และ --remote_download_เอาต์พุต=toplevel
ขยายไปยัง
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
แท็ก:affects_outputs
- ตัวเลือกที่มีผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมของแฟล็ก ฯลฯ) ได้แก่
- ค่าเริ่มต้นของ
--experimental_repository_hash_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรยืนยันแฮชไดเรกทอรีที่เก็บ
แท็ก:affects_outputs
,experimental
- รวมการใช้งานหลายรายการแล้ว
--experimental_verify_repository_rules=<a string>
รายการ -
หากรายการกฎที่เก็บซึ่งควรยืนยันแฮชของไดเรกทอรีเอาต์พุต ระบบจะระบุไฟล์โดย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ API ของบิลด์ที่เข้าถึงได้ด้วยการสร้างไฟล์ .bzl หรือไฟล์ WORKSPACE
- ค่าเริ่มต้นของ
--[no]experimental_allow_top_level_aspects_parameters
: "จริง" -
ไม่ดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ค่าเริ่มต้นของ
--[no]incompatible_config_setting_private_default_visibility
: "เท็จ" -
หากแฟล็กนี้เป็นเท็จ config_setting ที่ไม่มีแอตทริบิวต์การเปิดเผยอย่างชัดเจนจะเป็น //visibility:public หากแฟล็กนี้เป็นจริง config_setting จะใช้ตรรกะการแสดงผลเดียวกันกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_enforce_config_setting_visibility
: "จริง" -
หากเป็น "จริง" ให้บังคับใช้ข้อจํากัดระดับการเข้าถึง config_setting หากเป็น "เท็จ" ทุก config_setting จะปรากฏกับทุกเป้าหมาย ดู https://github.com/bazelbuild/bazel/issues/12932
แท็ก:loading_and_analysis
,incompatible_change
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตการค้นหาและความหมาย
- ค่าเริ่มต้นของ
--aspect_deps=<off, conservative or precise>
: "ดั้งเดิม" -
วิธีแก้ไขทรัพยากร Dependency ของสัดส่วนภาพเมื่อรูปแบบเอาต์พุตเป็นหนึ่งใน {xml,ctr,record} "off" หมายถึงไม่มีการสรุปทรัพยากร Dependency "เชิงรับ" (ค่าเริ่มต้น) หมายถึงการเพิ่มทรัพยากร Dependency ที่ประกาศไว้ทั้งหมด โดยไม่คำนึงว่าจะได้รับคลาสกฎของทรัพยากร Dependency โดยตรงหรือไม่ "แม่นยำ" หมายความว่ามีการเพิ่มเฉพาะส่วนที่อาจใช้งานได้ตามคลาสกฎของทรัพยากร Dependency โดยตรง โปรดทราบว่าโหมดความแม่นยำจำเป็นต้องมีการโหลดแพ็กเกจอื่นๆ เพื่อประเมินเป้าหมายเดียวและทำให้ทำงานช้ากว่าโหมดอื่นๆ นอกจากนี้ โปรดทราบว่าแม้แต่โหมดความแม่นยำก็ไม่แม่นยำทั้งหมด การตัดสินใจว่าจะคำนวณด้านใดด้านหนึ่งหรือไม่นั้น จะตัดสินใจในขั้นตอนการวิเคราะห์ ซึ่งจะไม่ทำงานระหว่าง "การค้นหาแบบ Bazel"
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--[no]consistent_labels
: "เท็จ" -
หากเปิดใช้ คำสั่งการค้นหาทุกรายการจะส่งป้ายกำกับออกมาเสมือนว่าฟังก์ชัน Starlark <code>str</code> ใช้กับอินสแตนซ์ <code>Label</code> ซึ่งจะเป็นประโยชน์สำหรับเครื่องมือที่จำเป็นต้องจับคู่เอาต์พุตของคำสั่งการค้นหาและ/หรือป้ายกำกับต่างๆ ที่กฎเรียกใช้ หากไม่ได้เปิดใช้ ตัวจัดรูปแบบเอาต์พุตจะปล่อยชื่อที่เก็บที่ชัดเจน (สัมพันธ์กับที่เก็บหลัก) แทนเพื่อทำให้เอาต์พุตอ่านได้ง่ายขึ้น
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]experimental_graphless_query
: "อัตโนมัติ" -
หากเป็น "จริง" ให้ใช้การใช้งานการค้นหาที่ไม่ได้ทำสำเนากราฟ การใช้งานแบบใหม่จะรองรับเฉพาะ --order_output=no และตัวจัดรูปแบบเอาต์พุตเพียงบางส่วนเท่านั้น
แท็ก:build_file_semantics
,eagerness_to_exit
- ค่าเริ่มต้นของ
--graph:conditional_edges_limit=<an integer>
: "4" -
จำนวนป้ายกำกับเงื่อนไขที่จะแสดงสูงสุด -1 หมายถึงไม่มีการตัด และ 0 หมายถึงไม่มีคำอธิบายประกอบ ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]graph:factored
: "จริง" -
หากเป็น "จริง" กราฟจะปล่อยออกมาเป็น "แยกส่วน" กล่าวคือ โหนดที่เทียบเคียงกับโทโพโลยีจะถูกผสานเข้าด้วยกันและต่อป้ายกำกับของโหนดต่อกัน ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--graph:node_limit=<an integer>
: "512" -
ความยาวสูงสุดของสตริงป้ายกำกับสำหรับโหนดกราฟในเอาต์พุต ระบบจะตัดป้ายกำกับที่ยาวขึ้น โดย -1 หมายความว่าไม่มีการตัดข้อความ ตัวเลือกนี้ใช้ได้กับ --output=graph เท่านั้น
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]implicit_deps
: "จริง" -
หากเปิดใช้ ทรัพยากร Dependency โดยนัยจะรวมอยู่ในกราฟการอ้างอิงที่การค้นหาดังกล่าวดำเนินการอยู่ ทรัพยากร Dependency โดยนัยคือทรัพยากร Dependency ที่ไม่ได้ระบุอย่างชัดเจนในไฟล์ BUILD แต่เพิ่มโดย Bazel สำหรับ cquery ตัวเลือกนี้ควบคุมการกรองชุดเครื่องมือที่แก้ไขแล้ว
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--[no]include_aspects
: "จริง" -
aquery, cquery: จะรวมการดำเนินการที่สร้างโดยมุมมองในเอาต์พุตหรือไม่ query: no-op (ติดตามด้านต่างๆ เสมอ)
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]incompatible_display_source_file_location
: "จริง" -
"จริง" จะแสดงเป้าหมายของไฟล์ต้นฉบับโดยค่าเริ่มต้น หากเป็น "จริง" จะแสดงตำแหน่งของบรรทัดที่ 1 ของไฟล์ต้นฉบับในเอาต์พุตตำแหน่ง แฟล็กนี้มีไว้เพื่อวัตถุประสงค์ในการย้ายข้อมูลเท่านั้น
แท็ก:terminal_output
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_lexicographical_output
: "จริง" -
หากตั้งค่าตัวเลือกนี้ ให้จัดเรียง --order_45 เอาต์พุตตามลําดับแบบพจนานุกรม
แท็ก:terminal_output
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_package_group_includes_double_slash
: "จริง" -
หากเปิดใช้ เมื่อเอาต์พุตแอตทริบิวต์ `packages` ของ package_group จะไม่ละเว้น `//` ที่นำหน้า
แท็ก:terminal_output
,incompatible_change
- ค่าเริ่มต้นของ
--[no]infer_universe_scope
: "เท็จ" -
หากไม่ได้ตั้งค่า และ --universe_scope อยู่ ระบบจะอนุมานค่าของ --universe_scope เป็นรายการรูปแบบเป้าหมายที่ไม่ซ้ำกันในนิพจน์การค้นหา โปรดทราบว่าค่า --universe_scope ที่อนุมานสำหรับนิพจน์การค้นหาที่ใช้ฟังก์ชันขอบเขตระดับจักรวาล (เช่น "allrdeps") อาจไม่ใช่ค่าที่คุณต้องการ คุณจึงควรใช้ตัวเลือกนี้ก็ต่อเมื่อคุณรู้ว่าคุณกำลังทำอะไรอยู่เท่านั้น ดูรายละเอียดและตัวอย่างได้ที่ https://bazel.build/reference/query#sky-query หากตั้งค่า --universe_scope ไว้ ระบบจะไม่พิจารณาค่าของตัวเลือกนี้ หมายเหตุ: ตัวเลือกนี้มีผลกับ "ข้อความค้นหา" เท่านั้น (กล่าวคือ ไม่ใช่ "cquery")
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]line_terminator_null
: "เท็จ" -
ระบุว่าแต่ละรูปแบบจะลงท้ายด้วย \0 แทนที่จะเป็นบรรทัดใหม่หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]nodep_deps
: "จริง" -
หากเปิดใช้ คำสั่ง deps จาก "nodep" จะรวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาดังกล่าวดำเนินการอยู่ ตัวอย่างทั่วไปของแอตทริบิวต์ "nodep" คือ "visibility" เรียกใช้และแยกวิเคราะห์เอาต์พุตของ "infobuild-language" เพื่อดูข้อมูลเกี่ยวกับแอตทริบิวต์ "nodep" ทั้งหมดในภาษาบิลด์
แท็ก:build_file_semantics
--noorder_results
-
แสดงผลลัพธ์เป็นแบบเรียงลำดับตามการพึ่งพิง (ค่าเริ่มต้น) หรือไม่เรียงลำดับ เอาต์พุตแบบไม่เรียงลำดับจะเร็วขึ้น แต่รองรับเฉพาะเมื่อ --เอาต์พุตไม่ใช่ minrank, maxrank หรือกราฟ
ขยายเป็น
--order_output=no
แท็ก:terminal_output
--null
-
ระบุว่าแต่ละรูปแบบจะลงท้ายด้วย \0 แทนที่จะเป็นบรรทัดใหม่หรือไม่
ขยายเป็น
--line_terminator_null=true
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--order_output=<no, deps, auto or full>
: "อัตโนมัติ" -
แสดงผลลัพธ์แบบไม่เรียงลำดับ (no) เรียงลำดับการขึ้นต่อกัน (deps) หรือเรียงลำดับทั้งหมด (เต็ม) ค่าเริ่มต้นคือ "auto" ซึ่งหมายความว่าผลลัพธ์จะเป็นผลลัพธ์ทั้งแบบเรียงลำดับตาม Dependency หรือเรียงลำดับแบบเต็ม โดยขึ้นอยู่กับตัวจัดรูปแบบเอาต์พุต (โดยเรียงลำดับแบบ Dependency สำหรับ Proto, Minrank, maxrank และกราฟ โดยเรียงลำดับทั้งหมดสำหรับอื่นๆ ทั้งหมด) เมื่อเรียงลำดับเอาต์พุตครบถ้วนแล้ว ระบบจะพิมพ์โหนดตามลำดับที่กำหนดอย่างครบถ้วน (รวม) ก่อนอื่น โหนดทั้งหมดจะจัดเรียงตามตัวอักษร จากนั้นแต่ละโหนดในรายการจะใช้เป็นจุดเริ่มต้นของการค้นหาแบบเจาะลึกหลังการสั่งซื้อ ซึ่งจะข้ามผ่านขอบขาออกไปยังโหนดที่ยังไม่ได้เข้าชม โดยเรียงตามลำดับตัวอักษรของโหนดสืบทอด สุดท้าย ระบบจะพิมพ์โหนดที่ด้านหลังของลำดับการเข้าชม
แท็ก:terminal_output
--order_results
-
แสดงผลลัพธ์เป็นแบบเรียงลำดับตามการพึ่งพิง (ค่าเริ่มต้น) หรือไม่เรียงลำดับ เอาต์พุตแบบไม่เรียงลำดับจะเร็วขึ้น แต่รองรับเฉพาะเมื่อ --เอาต์พุตไม่ใช่ minrank, maxrank หรือกราฟ
ขยายเป็น
--order_output=auto
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--output=<a string>
: "label" -
รูปแบบที่ควรพิมพ์ผลการค้นหา ค่าที่อนุญาตสำหรับข้อความค้นหา ได้แก่ create, Grab, streamed_jsonโปรโต, label, label_kind, location, maxrank, minrank, package, promo, xml
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:default_values
: "จริง" -
หากเป็น "จริง" ระบบจะรวมแอตทริบิวต์ที่ไม่ได้ระบุค่าไว้อย่างชัดเจนในไฟล์ BUILD มิเช่นนั้นระบบจะละเว้นแอตทริบิวต์เหล่านั้น ตัวเลือกนี้ใช้ได้กับ --เอาต์พุต=โปรโตคอล
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:definition_stack
: "เท็จ" -
ป้อนข้อมูลช่อง Proto คำจำกัดความ ซึ่งจะบันทึกสำหรับอินสแตนซ์ของกฎแต่ละรายการที่สแต็กการเรียกใช้ Starlark ทันทีที่มีการกำหนดคลาสของกฎ
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:flatten_selects
: "จริง" -
หากเปิดใช้ ระบบจะรวมแอตทริบิวต์ที่กำหนดค่าได้ซึ่งสร้างด้วย select() ออก สำหรับประเภทรายการ การนำเสนอแบบรวมคือรายการที่มีแต่ละค่าของแผนที่ที่เลือกเพียงครั้งเดียว ประเภท Scalar จะถูกแบนเป็น Null
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--[no]proto:include_synthetic_attribute_hash
: "เท็จ" -
ระบุว่าจะคำนวณและป้อนข้อมูลแอตทริบิวต์ $internal_attr_hash หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:instantiation_stack
: "เท็จ" -
สร้างสแต็กการเรียกใช้อินสแตนซ์ของแต่ละกฎ โปรดทราบว่าการดำเนินการนี้ต้องมีสแต็ก
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:locations
: "จริง" -
กำหนดว่าจะแสดงข้อมูลตำแหน่งในเอาต์พุต Pro หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--proto:output_rule_attrs=<comma-separated list of options>
: "ทั้งหมด" -
รายการแอตทริบิวต์ที่คั่นด้วยคอมมาที่จะรวมไว้ในเอาต์พุต ค่าเริ่มต้นคือแอตทริบิวต์ทั้งหมด ตั้งค่าเป็นสตริงว่างเพื่อไม่ให้มีแอตทริบิวต์ใดๆ ทั้งสิ้น ตัวเลือกนี้ใช้ได้กับ --เอาต์พุต=โปรโตคอล
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]proto:rule_inputs_and_outputs
: "จริง" -
ระบุว่าจะสร้างช่อง report_input และ rules_เอาต์พุต หรือไม่
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--query_file=<a string>
: "" -
หากตั้งค่าแล้ว การค้นหาจะอ่านการค้นหาจากไฟล์ที่มีชื่อที่นี่ ไม่ใช่ในบรรทัดคำสั่ง ข้อผิดพลาดในการระบุไฟล์ที่นี่ รวมถึงการค้นหาบรรทัดคำสั่ง
แท็ก:changes_inputs
- ค่าเริ่มต้นของ
--[no]relative_locations
: "เท็จ" -
หากเป็นจริง ตำแหน่งของไฟล์ BUILD ใน XML และเอาต์พุตโปรโตจะสัมพันธ์กัน โดยค่าเริ่มต้น เอาต์พุตของตำแหน่งจะเป็นเส้นทางสัมบูรณ์และจะไม่สอดคล้องกันในแต่ละเครื่อง คุณสามารถตั้งตัวเลือกนี้เป็น "จริง" เพื่อให้ผลลัพธ์สอดคล้องกันในคอมพิวเตอร์ทุกเครื่อง
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]strict_test_suite
: "เท็จ" -
หากเป็น "จริง" นิพจน์ test() จะแสดงข้อผิดพลาดหากพบ test_suite ที่มีเป้าหมายที่ไม่ใช่การทดสอบ
แท็ก:build_file_semantics
,eagerness_to_exit
- ค่าเริ่มต้นของ
--[no]tool_deps
: "จริง" -
คำค้นหา: หากปิดใช้ ทรัพยากร Dependency ของเป้าหมาย "การกำหนดค่าโฮสต์" หรือ "การดำเนินการ" จะไม่รวมอยู่ในกราฟทรัพยากร Dependency ที่การค้นหาดังกล่าวดำเนินการอยู่ Edge ของทรัพยากร Dependency "การกำหนดค่าโฮสต์" เช่น กฎจากกฎ "Proto_library" ใดก็ตามไปยังโปรโตคอลคอมไพเลอร์ (โปรโตคอลคอมไพเลอร์) มักจะชี้ไปยังเครื่องมือที่ดำเนินการระหว่างการสร้างแทนที่จะเป็นส่วนหนึ่งของโปรแกรม "target" เดียวกัน
ค้นหา: หากปิดใช้ ให้กรองเป้าหมายที่กำหนดค่าไว้ทั้งหมดซึ่งข้ามโฮสต์หรือการเปลี่ยนการดำเนินการจากเป้าหมายระดับบนสุดที่ค้นพบเป้าหมายที่กำหนดค่าไว้นี้ออก ซึ่งหมายความว่าหากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าเป้าหมาย ระบบจะแสดงผลเฉพาะเป้าหมายที่กำหนดค่าในการกำหนดค่าเป้าหมายด้วยเท่านั้น หากเป้าหมายระดับบนสุดอยู่ในการกำหนดค่าโฮสต์ ระบบจะแสดงเฉพาะเป้าหมายที่กำหนดค่าไว้ของโฮสต์เท่านั้น ตัวเลือกนี้จะไม่ยกเว้นห่วงโซ่เครื่องมือที่แก้ไขแล้ว
แท็ก:build_file_semantics
- ค่าเริ่มต้นของ
--universe_scope=<comma-separated list of options>
: "" -
ชุดรูปแบบเป้าหมายที่คั่นด้วยคอมมา (การบวกและการลบ) การค้นหาอาจดำเนินการในจักรวาลที่กำหนดโดยการปิดทางอ้อมของเป้าหมายที่ระบุ ตัวเลือกนี้ใช้สำหรับคำค้นหาและคำสั่ง cquery
สำหรับ cquery อินพุตไปยังตัวเลือกนี้จะเป็นเป้าหมายคำตอบทั้งหมดที่สร้างขึ้น ดังนั้นตัวเลือกนี้จึงอาจส่งผลต่อการกำหนดค่าและการเปลี่ยน หากไม่ได้ระบุตัวเลือกนี้ ระบบจะถือว่าเป้าหมายระดับบนสุดเป็นเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหา หมายเหตุ: สำหรับ cquery การไม่ระบุตัวเลือกนี้อาจทำให้บิลด์เสียหายได้ หากเป้าหมายที่แยกวิเคราะห์จากนิพจน์การค้นหาไม่สามารถสร้างได้ด้วยตัวเลือกระดับบนสุด
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]xml:default_values
: "เท็จ" -
หากเป็น "จริง" ระบบจะพิมพ์แอตทริบิวต์ของกฎที่ไม่ได้ระบุค่าไว้อย่างชัดเจนในไฟล์ BUILD มิเช่นนั้นระบบจะละเว้นแอตทริบิวต์ดังกล่าว
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]xml:line_numbers
: "จริง" -
หากเป็น "จริง" เอาต์พุต XML จะมีหมายเลขบรรทัด การปิดใช้ตัวเลือกนี้อาจทำให้อ่านความแตกต่างได้ง่ายขึ้น ตัวเลือกนี้ใช้ได้กับ --output=xml เท่านั้น
แท็ก:terminal_output
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุต Bzlmod และอรรถศาสตร์:
- รวมการใช้งานหลายรายการแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ซึ่งจะอนุญาตให้ใช้ในกราฟการอ้างอิงที่แก้ไขแล้วแม้ว่าจะมีการประกาศว่าได้รับการแย้งในรีจิสทรีที่เป็นแหล่งที่มา (หากเว็บไซต์ไม่ได้มาจาก NonRegistryReplace) มิฉะนั้น เวอร์ชันที่ยัดเยียดจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชัน yank ที่อนุญาตได้ด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" คุณสามารถปิดใช้งานการตรวจสอบนี้ได้โดยใช้คำหลัก "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ หรือ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบว่าข้อมูลไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบที่ไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าทรัพยากร Dependency ดังกล่าวจะถูกละเว้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท โดยไม่คำนึงถึงค่าของแฟล็กนี้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--lockfile_mode=<off, update or error>
: "ปิด" -
ระบุว่าจะใช้ Lockfile อย่างไรและจะใช้หรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ Lockfile และอัปเดตเมื่อมีการเปลี่ยนแปลง "ข้อผิดพลาด" ให้ใช้ Lockfile แต่จะแสดงข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่ออ่านหรือเขียนไฟล์ล็อกทั้ง 2 ไฟล์
แท็ก: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
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งการบันทึกมีดังนี้
- ค่าเริ่มต้นของ
--[no]experimental_record_metrics_for_all_mnemonics
: "เท็จ" - โดยค่าเริ่มต้น ประเภทการดําเนินการจะจํากัดอยู่ที่ 20 ประเภทที่มีจำนวนการดำเนินการสูงสุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสําหรับการช่วยจำทั้งหมด
- ค่าเริ่มต้นของ
--experimental_repository_resolved_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้เขียนค่า Starlark ด้วยข้อมูลที่แก้ไขแล้วของกฎที่เก็บ Starlark ทั้งหมดที่มีการนำไปใช้
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--remote_print_execution_messages=<failure, success or all>
: "failure" -
เลือกเวลาที่จะพิมพ์ข้อความการดำเนินการจากระยะไกล ค่าที่ถูกต้องคือ "failure" จะพิมพ์เฉพาะเวลาที่ล้มเหลว "ความสำเร็จ" จะพิมพ์เฉพาะเมื่อสำเร็จ และ "all" จะพิมพ์ทุกครั้ง
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ค่าเริ่มต้นของ
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
หากเว้นว่างไว้ ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล
- ค่าเริ่มต้น
--experimental_circuit_breaker_strategy=<failure>
: ดูรายละเอียด -
ระบุกลยุทธ์ที่เบรกเกอร์จะใช้ กลยุทธ์ที่ใช้ได้คือ "ล้มเหลว" เมื่อค่าไม่ถูกต้องสำหรับตัวเลือก ลักษณะการทำงานจะเหมือนกับที่ไม่ได้กำหนดตัวเลือกไว้
แท็ก:execution
- ค่าเริ่มต้น
--experimental_downloader_config=<a string>
: ดูรายละเอียด - ระบุไฟล์ที่จะใช้กำหนดค่าเครื่องมือดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด โดยแต่ละบรรทัดจะขึ้นต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือ 2 รูปแบบ รูปแบบหนึ่งเพื่อจับคู่กับ และอีกแบบหนึ่งใช้เป็น URL แทนโดยมีการอ้างอิงย้อนกลับที่เริ่มจาก "$1" เป็นไปได้ที่คำสั่ง "rewrite" อาจมีผลลัพธ์ใน URL เดียวกันหลายรายการ และระบบจะส่ง URL เดียวกันนี้กลับไปหลายรายการสำหรับ URL เดียวกัน)
- ค่าเริ่มต้นของ
--[no]experimental_guard_against_concurrent_changes
: "เท็จ" - ปิดการตั้งค่านี้เพื่อปิดใช้การตรวจสอบเวลาของไฟล์อินพุตของการดำเนินการก่อนที่จะอัปโหลดไปยังแคชระยะไกล อาจมีกรณีที่เคอร์เนลของ Linux ทำให้การเขียนไฟล์ล่าช้า ซึ่งอาจทำให้เกิดผลบวกลวง
- ค่าเริ่มต้นของ
--experimental_remote_build_event_upload=<all or minimal>
: "ทั้งหมด" - หากตั้งค่าเป็น "ทั้งหมด" ระบบจะอัปโหลดเอาต์พุตในเครื่องทั้งหมดที่ BEP อ้างอิงไปยังแคชระยะไกล หากตั้งค่าเป็น "minimal" เอาต์พุตในเครื่องที่อ้างอิงโดย BEP จะไม่อัปโหลดไปยังแคชระยะไกล ยกเว้นไฟล์ที่มีความสำคัญต่อผู้ใช้ BEP (เช่น บันทึกการทดสอบและโปรไฟล์การจับเวลา) ระบบจะใช้รูปแบบ bytesstream:// กับ URI ของไฟล์เสมอแม้ว่าจะหายไปจากแคชระยะไกลก็ตาม มีค่าเริ่มต้นเป็น "ทั้งหมด"
- ค่าเริ่มต้นของ
--[no]experimental_remote_cache_async
: "เท็จ" - หากเป็น "จริง" I/O แคชระยะไกลจะเกิดขึ้นในเบื้องหลังแทนที่จะเกิดขึ้นเป็นส่วนหนึ่งของการสร้าง
- ค่าเริ่มต้นของ
--[no]experimental_remote_cache_compression
: "เท็จ" - หากเปิดใช้ ให้บีบอัด/ยกเลิกการบีบอัด Cache Blob ด้วย zstd
- ค่าเริ่มต้น
--experimental_remote_capture_corrupted_outputs=<a path>
: ดูรายละเอียด - เส้นทางไปยังไดเรกทอรีที่จะบันทึกเอาต์พุตที่เสียหาย
- ค่าเริ่มต้นของ
--[no]experimental_remote_discard_merkle_trees
: "เท็จ" - หากตั้งค่าเป็น "จริง" ให้ทิ้งสำเนาในหน่วยความจำของต้นไม้ Merkle ของรูทอินพุตและการแมปอินพุตที่เกี่ยวข้องระหว่างการเรียกใช้ GetAction Results() และ Execute() ซึ่งวิธีนี้จะช่วยลดการใช้หน่วยความจำลงอย่างมาก แต่ Bazel จะต้องคำนวณใหม่เมื่อแคชระยะไกลไม่พบและลองใหม่
- ค่าเริ่มต้น
--experimental_remote_downloader=<a string>
: ดูรายละเอียด - URI ปลายทางของ Remote Asset API ที่จะใช้เป็นพร็อกซีการดาวน์โหลดระยะไกล สคีมาที่รองรับคือ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (UNIX Sockets) หากไม่ได้กำหนดสคีมาไว้ Bazel จะใช้ค่าเริ่มต้นเป็น grpcs โปรดดูที่ https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.prof
- ค่าเริ่มต้นของ
--[no]experimental_remote_downloader_local_fallback
: "เท็จ" - จะกลับไปใช้โปรแกรมดาวน์โหลดในเครื่องหากโปรแกรมดาวน์โหลดระยะไกลล้มเหลว
- ค่าเริ่มต้นของ
--[no]experimental_remote_execution_keepalive
: "เท็จ" - ต้องการใช้ Keepalive สำหรับการเรียกใช้การดำเนินการระยะไกลหรือไม่
- ค่าเริ่มต้นของ
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
: "10" -
กำหนดจำนวนอัตราการทำงานไม่สำเร็จเป็นเปอร์เซ็นต์ที่อนุญาตสำหรับกรอบเวลาหนึ่งๆ หลังจากที่ระบบหยุดเรียกใช้แคช/ไฟล์ดำเนินการระยะไกล ค่าเริ่มต้นคือ 10 การตั้งค่านี้เป็น 0 หมายความว่าจะไม่มีข้อจำกัด
แท็ก:execution
- ค่าเริ่มต้นของ
--experimental_remote_failure_window_interval=<An immutable length of time.>
: "60 วินาที" -
ช่วงที่มีการคำนวณอัตราความล้มเหลวของคำขอระยะไกล สำหรับค่าศูนย์หรือค่าลบ ระยะเวลาที่ล้มเหลวจะได้รับการคำนวณตลอดระยะเวลาของการดำเนินการ หน่วยต่อไปนี้สามารถใช้ได้: วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]experimental_remote_mark_tool_inputs
: "เท็จ" - หากตั้งค่าเป็น "จริง" Bazel จะทำเครื่องหมายอินพุตเป็นอินพุตเครื่องมือสำหรับผู้ดำเนินการระยะไกล ข้อมูลนี้สามารถใช้ในการติดตั้งใช้งานผู้ปฏิบัติงานถาวรระยะไกล
- ค่าเริ่มต้นของ
--[no]experimental_remote_merkle_tree_cache
: "เท็จ" - หากตั้งค่าเป็น "จริง" ระบบจะบันทึกการคำนวณต้นไม้ Merkle เพื่อปรับปรุงความเร็วในการตรวจสอบ Hit ของแคชระยะไกล รอยเท้าหน่วยความจำของแคชจะควบคุมโดย --experimental_remote_merkle_tree_cache_size
- ค่าเริ่มต้นของ
--experimental_remote_merkle_tree_cache_size=<a long integer>
: "1,000" - จำนวนต้น Merkle ที่จะบันทึกเพื่อปรับปรุงความเร็วในการตรวจสอบแคชระยะไกล แม้ว่าแคชจะถูกตัดออกโดยอัตโนมัติตามการจัดการแบบซอฟต์การอ้างอิงของ Java แต่ข้อผิดพลาดจากหน่วยความจำนอกหน่วยความจำอาจเกิดขึ้นได้หากตั้งค่าสูงเกินไป หากตั้งค่าเป็น 0 ขนาดของแคชจะเป็นแบบไม่จำกัด มูลค่าที่เหมาะสมที่สุดจะแตกต่างกันไปโดยขึ้นอยู่กับขนาดของโปรเจ็กต์ ค่าเริ่มต้นคือ 1,000
- ค่าเริ่มต้นของ
--[no]experimental_remote_require_cached
: "เท็จ" - หากตั้งค่าเป็น "จริง" ให้บังคับให้มีการแคชการดำเนินการทั้งหมดที่เรียกใช้จากระยะไกลได้ มิเช่นนั้นระบบจะสร้างบิลด์ไม่สำเร็จ วิธีนี้มีประโยชน์ในการแก้ปัญหาที่ไม่ขึ้นอยู่กับการตัดสินใจ เนื่องจากจะช่วยให้สามารถตรวจสอบว่ามีการแคชการดำเนินการที่ควรแคชไว้จริงหรือไม่ โดยไม่ต้องแทรกผลลัพธ์ใหม่ลงในแคช
- ค่าเริ่มต้นของ
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "เท็จ" - หากตั้งค่าเป็น "จริง" ระบบจะไม่อัปโหลดเอาต์พุตที่ BEP อ้างอิงไปยังแคชระยะไกลหากการดำเนินการที่สร้างไม่สามารถแคชจากระยะไกลได้
- ค่าเริ่มต้นของ
--[no]incompatible_remote_downloader_send_all_headers
: "จริง" -
กำหนดว่าจะส่งค่าของส่วนหัวที่มีหลายค่าไปยังเครื่องมือดาวน์โหลดระยะไกลแทนที่จะส่งเพียงค่าแรกหรือไม่
แท็ก:incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remote_output_paths_relative_to_input_root
: "เท็จ" -
หากตั้งค่าเป็น "จริง" เส้นทางเอาต์พุตจะสัมพัทธ์กับรูทของอินพุตแทนที่จะเป็นไดเรกทอรีที่ใช้งานอยู่
แท็ก:incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remote_results_ignore_disk
: "จริง" -
หากตั้งค่าเป็น "จริง" --noremote_upload_local_results และ --noremote_accept_cached จะไม่มีผลกับดิสก์แคช หากใช้แคชแบบรวม:
--noremote_upload_local_results จะทำให้มีการเขียนผลลัพธ์ลงในดิสก์แคช แต่ไม่อัปโหลดไปยังแคชระยะไกล
--noremote_accept_cached จะทำให้ Bazel ตรวจสอบผลลัพธ์ในดิสก์แคช แต่ไม่ใช่ในแคชระยะไกล
การดำเนินการ no-remote-exec สามารถไปยังดิสก์แคชได้
ดูรายละเอียดได้ที่ #8216
แท็ก:incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
: "เท็จ" -
หากตั้งค่าเป็น "จริง" Bazel จะใช้รหัสออกใหม่ 39 แทน 34 หากแคชระยะไกลกำจัด BLOB ระหว่างบิลด์
แท็ก:incompatible_change
- ค่าเริ่มต้นของ
--[no]remote_accept_cached
: "จริง" - กำหนดว่าจะยอมรับผลการดำเนินการที่แคชไว้จากระยะไกลหรือไม่
- ค่าเริ่มต้น
--remote_bytestream_uri_prefix=<a string>
: ดูรายละเอียด - ชื่อโฮสต์และชื่ออินสแตนซ์ที่จะใช้ใน bytesstream:// URI ที่เขียนลงในสตรีมเหตุการณ์ของบิลด์ ตัวเลือกนี้จะตั้งค่าได้เมื่อมีการดำเนินการบิลด์โดยใช้พร็อกซี ซึ่งทำให้ค่าของ --remote_executor และ --remote_instance_name ไม่ตรงกับชื่อมาตรฐานของบริการดำเนินการระยะไกลอีกต่อไป เมื่อไม่ได้ตั้งค่า ค่าเริ่มต้นจะเป็น "${ชื่อโฮสต์}/${instance_name}"
- ค่าเริ่มต้น
--remote_cache=<a string>
: ดูรายละเอียด - URI ของปลายทางการแคช สคีมาที่รองรับ ได้แก่ http, https, grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (UNIX Sockets) หากไม่ได้กำหนดสคีมาไว้ Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุสคีมา grpc://, http:// หรือ unix: เพื่อปิดใช้ TLS โปรดดู https://bazel.build/remote/caching
- รวมการใช้งานหลายรายการแล้ว
--remote_cache_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอแคช ดังนี้ --remote_cache_header=Name=Value คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- รวมการใช้งานหลายรายการแล้ว
--remote_default_exec_properties=<a 'name=value' assignment>
รายการ -
ตั้งค่าพร็อพเพอร์ตี้ exec เริ่มต้นเพื่อใช้เป็นแพลตฟอร์มการดำเนินการระยะไกล หากแพลตฟอร์มการดำเนินการยังไม่ได้ตั้งค่า exec_properties
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--remote_default_platform_properties=<a string>
: "" - ตั้งค่าพร็อพเพอร์ตี้แพลตฟอร์มเริ่มต้นที่จะตั้งค่าสำหรับ API การดำเนินการระยะไกล หากแพลตฟอร์มการดำเนินการยังไม่ได้ตั้งค่า Remote_execution_properties ไว้ ระบบจะใช้ค่านี้ด้วยหากเลือกแพลตฟอร์มโฮสต์เป็นแพลตฟอร์มการดำเนินการสำหรับการดำเนินการจากระยะไกล
- รวมการใช้งานหลายรายการแล้ว
--remote_downloader_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอเครื่องมือดาวน์โหลดระยะไกล: --remote_downloader_header=Name=Value คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- รวมการใช้งานหลายรายการแล้ว
--remote_exec_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอการดำเนินการ: --remote_exec_header=Name=Value คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- ค่าเริ่มต้นของ
--remote_execution_priority=<an integer>
: "0" - ลำดับความสำคัญของการดำเนินการที่จะดำเนินการจากระยะไกล ความหมายของค่าลำดับความสำคัญหนึ่งๆ จะขึ้นอยู่กับเซิร์ฟเวอร์
- ค่าเริ่มต้น
--remote_executor=<a string>
: ดูรายละเอียด - HOST หรือ HOST:PORT ของปลายทางการดำเนินการระยะไกล สคีมาที่รองรับคือ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (UNIX Sockets) หากไม่ได้กำหนดสคีมาไว้ Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุ grpc:// หรือ unix: schema เพื่อปิดใช้ TLS
- ค่าเริ่มต้น
--remote_grpc_log=<a path>
: ดูรายละเอียด - หากระบุไว้ ระบบจะกำหนดเส้นทางไปยังไฟล์เพื่อบันทึกรายละเอียดที่เกี่ยวข้องกับการเรียกใช้ gRPC บันทึกนี้ประกอบด้วยลำดับของ com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry ที่ชื่อว่า ทำการ ทำการ ctrbufs ตามลำดับ โดยให้แต่ละข้อความนำหน้าด้วยตัวแปรที่แสดงถึงขนาดของข้อความ เป็นไฟล์ ctrbuf ที่ต่อเนื่องกันต่อไปนี้ ตามที่ดำเนินการโดยเมธอด LogEntry.writeDelimitedTo(ExportStream)
- รวมการใช้งานหลายรายการแล้ว
--remote_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอ: --remote_header=Name=Value คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- ค่าเริ่มต้นของ
--remote_instance_name=<a string>
: "" - ค่าที่จะส่งผ่านเป็นอินสแตนซ์_name ใน API การดำเนินการระยะไกล
- ค่าเริ่มต้นของ
--[no]remote_local_fallback
: "เท็จ" - กำหนดว่าจะกลับไปใช้กลยุทธ์การดำเนินการภายในเครื่องแบบสแตนด์อโลนหากการดำเนินการจากระยะไกลล้มเหลว
- ค่าเริ่มต้นของ
--remote_local_fallback_strategy=<a string>
: "ท้องถิ่น" - ไม่มีการดำเนินการ เลิกใช้งานไปแล้ว ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7480
- ค่าเริ่มต้นของ
--remote_max_connections=<an integer>
: "100" -
จำกัดจำนวนการเชื่อมต่อสูงสุดพร้อมกันไว้ที่แคช/ผู้ดำเนินการระยะไกล ค่าเริ่มต้นคือ 100 การตั้งค่านี้เป็น 0 หมายความว่าจะไม่มีข้อจำกัด
สำหรับแคชระยะไกลของ HTTP การเชื่อมต่อ TCP 1 รายการจะจัดการคำขอ 1 รายการต่อครั้ง ดังนั้น Bazel สามารถสร้างคำขอพร้อมกันถึง --remote_max_connections รายการ
สำหรับแคช/ไฟล์ดำเนินการระยะไกลของ gRPC ช่อง gRPC 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.>
: "5 วินาที" - การหน่วงเวลา Backoff สูงสุดระหว่างการลองใหม่จากระยะไกล หน่วยต่อไปนี้สามารถใช้ได้: วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
- ค่าเริ่มต้นของ
--remote_timeout=<An immutable length of time.>
: "60 วินาที" - ระยะเวลาสูงสุดในการรอการดำเนินการจากระยะไกลและการเรียกใช้แคช สำหรับแคช REST จะเป็นทั้งระยะหมดเวลาของการเชื่อมต่อและการอ่าน หน่วยต่อไปนี้สามารถใช้ได้: วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
- ค่าเริ่มต้นของ
--[no]remote_upload_local_results
: "จริง" - กำหนดว่าจะอัปโหลดผลการดำเนินการที่ดำเนินการในเครื่องไปยังแคชระยะไกลหรือไม่ หากรีโมตแคชรองรับและผู้ใช้ได้รับอนุญาตให้ดำเนินการ
- ค่าเริ่มต้นของ
--[no]remote_verify_downloads
: "จริง" - หากตั้งค่าเป็น "จริง" Bazel จะคำนวณผลรวมแฮชของการดาวน์โหลดจากระยะไกลทั้งหมด และทิ้งค่าที่แคชไว้จากระยะไกลหากไม่ตรงกับค่าที่คาดไว้
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้จัดหมวดหมู่:
- รวมการใช้งานหลายรายการแล้ว
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
รายการ - กำหนดค่าโปรแกรมช่วยข้อมูลเข้าสู่ระบบเพื่อใช้สำหรับเรียกข้อมูลเข้าสู่ระบบของการให้สิทธิ์สำหรับการดึงข้อมูลที่เก็บ การแคชและการดำเนินการจากระยะไกล รวมถึงบริการเหตุการณ์ของบิลด์ ข้อมูลเข้าสู่ระบบที่ผู้ช่วยเหลือมีให้จะมีความสำคัญเหนือกว่าข้อมูลรับรองที่ --google_default_credentials, --google_credentials, ไฟล์ .netrc หรือพารามิเตอร์ auth ไปยัง billing_ctx.download และ billing_ctx.download_and_extract นั้น อาจระบุได้หลายครั้งเพื่อตั้งค่าผู้ช่วยเหลือหลายคน ดูรายละเอียดได้ที่ https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md
- ค่าเริ่มต้นของ
--credential_helper_cache_duration=<An immutable length of time.>
: "30 นาที" - ระยะเวลาในการแคชข้อมูลเข้าสู่ระบบที่โปรแกรมช่วยรับรองข้อมูลเข้าสู่ระบบให้ไว้ การเรียกใช้ด้วยค่าที่แตกต่างกันจะปรับอายุการใช้งานของรายการที่มีอยู่ก่อนหน้า การส่งค่าเป็น 0 เพื่อล้างแคช คำสั่งสะอาดจะล้างแคชเสมอ โดยไม่คำนึงถึงแฟล็กนี้
- ค่าเริ่มต้นของ
--credential_helper_timeout=<An immutable length of time.>
: "10 วินาที" - กำหนดค่าระยะหมดเวลาสำหรับตัวช่วยข้อมูลเข้าสู่ระบบ ตัวช่วยข้อมูลเข้าสู่ระบบที่ไม่ตอบสนองภายในระยะหมดเวลานี้จะเรียกใช้ไม่สำเร็จ
- ค่าเริ่มต้นของ
--deleted_packages=<comma-separated list of package names>
: "" - รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริง แม้ว่าจะปรากฏในตำแหน่งใดบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ ตัวอย่างเช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์แล้ว ระบบบิลด์อาจร้องเรียนหากพบป้ายกำกับ "//x:y/z" หากมีป้ายกำกับ "//x:y/z" อยู่หากยังมีรายการ package_path อื่นอยู่ การระบุ --deleted_packages x/y จะหลีกเลี่ยงปัญหานี้
- ค่าเริ่มต้น
--disk_cache=<a path>
: ดูรายละเอียด - เส้นทางไปยังไดเรกทอรีที่ Bazel อ่านและเขียนการดำเนินการ รวมถึงเอาต์พุตของการดำเนินการได้ แต่หากไม่มี ระบบจะสร้างไดเรกทอรีดังกล่าวขึ้นมา
- ค่าเริ่มต้นของ
--google_auth_scopes=<comma-separated list of options>
: "https://www.googleapis.com/auth/cloud-platform" - รายการขอบเขตการตรวจสอบสิทธิ์ Google Cloud ที่คั่นด้วยคอมมา
- ค่าเริ่มต้น
--google_credentials=<a string>
: ดูรายละเอียด - ระบุไฟล์ที่จะรับข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication
- ค่าเริ่มต้นของ
--[no]google_default_credentials
: "เท็จ" - ระบุว่าจะใช้ "ข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชันของ Google" สำหรับการตรวจสอบสิทธิ์หรือไม่ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication ปิดใช้โดยค่าเริ่มต้น
- ค่าเริ่มต้น
--grpc_keepalive_time=<An immutable length of time.>
: ดูรายละเอียด - กำหนดค่าคําสั่ง ping แบบ Keep-alive สำหรับการเชื่อมต่อ gRPC ขาออก หากตั้งค่านี้ Bazel จะส่งคำสั่ง ping หลังจากไม่มีการดำเนินการอ่านการเชื่อมต่อเป็นเวลานานกว่านี้ แต่เฉพาะในกรณีที่มีการเรียกใช้ gRPC ที่รอดำเนินการอย่างน้อย 1 รายการ เวลาจะถือว่าเป็นรายละเอียดที่ 2 จึงถือเป็นข้อผิดพลาดในการตั้งค่าที่น้อยกว่า 1 วินาที โดยค่าเริ่มต้น การใช้คำสั่ง ping แบบ Keep-alive จะปิดใช้อยู่ คุณควรประสานงานกับเจ้าของบริการก่อนเปิดใช้การตั้งค่านี้ ตัวอย่างเช่น หากต้องการตั้งค่า 30 วินาทีเป็น Flag นี้ ก็ควรจะเป็น --grpc_keepalive_time=30s
- ค่าเริ่มต้นของ
--grpc_keepalive_timeout=<An immutable length of time.>
: "20 วินาที" - กำหนดค่าระยะหมดเวลา Keep-alive สำหรับการเชื่อมต่อ gRPC ขาออก หากเปิดใช้คำสั่ง ping แบบ Keep-alive พร้อมกับ --grpc_keepalive_time จากนั้น Bazel จะหมดเวลาการเชื่อมต่อหากไม่มีการตอบกลับคำสั่ง ping หลังผ่านไประยะหนึ่ง เวลาจะถือว่าเป็นรายละเอียดที่ 2 จึงถือเป็นข้อผิดพลาดในการตั้งค่าที่น้อยกว่า 1 วินาที หากปิดใช้คำสั่ง ping แบบ Keep-alive อยู่ ระบบจะไม่สนใจการตั้งค่านี้
- รวมการใช้งานหลายรายการแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace"
- ค่าเริ่มต้นของ
--package_path=<colon-separated list of options>
: "%workspace%" - รายการที่คั่นด้วยเครื่องหมายทวิภาคของตำแหน่งสำหรับค้นหาแพ็กเกจ องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับพื้นที่ทำงานที่ล้อมรอบอยู่ หากไม่ระบุหรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
- ค่าเริ่มต้นของ
--[no]show_loading_progress
: "จริง" - หากเปิดใช้จะทำให้ Bazel พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ"
- ค่าเริ่มต้น
--tls_certificate=<a string>
: ดูรายละเอียด - ระบุเส้นทางไปยังใบรับรอง TLS ที่เชื่อถือได้ให้ลงนามในใบรับรองเซิร์ฟเวอร์
- ค่าเริ่มต้น
--tls_client_certificate=<a string>
: ดูรายละเอียด - ระบุใบรับรองไคลเอ็นต์ TLS ที่จะใช้ โดยต้องระบุคีย์ไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
- ค่าเริ่มต้น
--tls_client_key=<a string>
: ดูรายละเอียด - ระบุคีย์ไคลเอ็นต์ TLS ที่จะใช้ นอกจากนี้ คุณยังต้องระบุใบรับรองไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
เรียกใช้ตัวเลือก
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคำสั่งและถูกแยกวิเคราะห์โดยไคลเอ็นต์ ได้แก่
- รวมการใช้งานหลายรายการแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบแคช แทนที่จะคัดลอก โดยมีจุดประสงค์เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่มาจาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม ซึ่งสามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ส่งผลให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_repository_disable_download
: "เท็จ" -
หากมีการตั้งค่า ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองแก้ไขข้อผิดพลาดในการดาวน์โหลดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานได้ในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้นของ
--http_timeout_scaling=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลด HTTP ตามปัจจัยที่กำหนด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูรายละเอียด -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ช่วยให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการ ซึ่งส่งผลต่อค่า ไม่ใช่ที่มีอยู่
- ค่าเริ่มต้น
--script_path=<a path>
: ดูรายละเอียด -
หากตั้งค่าแล้ว ให้เขียนสคริปต์ Shell ไปยังไฟล์ที่ระบุ ซึ่งจะเรียกใช้เป้าหมาย หากตั้งค่าตัวเลือกนี้ เป้าหมายจะไม่เรียกใช้จาก Bazel ใช้ "bazel run --script_path=foo //foo && ./foo' เพื่อเรียกใช้เป้าหมาย '//foo' ซึ่งแตกต่างจาก "bazel Run //foo" ตรงที่ระบบจะปล่อยล็อกแบบ Bazel และไฟล์ปฏิบัติการจะเชื่อมต่อกับ stdin ของเทอร์มินัล
แท็ก:affects_outputs
,execution
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมของแฟล็ก ฯลฯ)
- ค่าเริ่มต้นของ
--experimental_repository_hash_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรยืนยันแฮชไดเรกทอรีที่เก็บ
แท็ก:affects_outputs
,experimental
- รวมการใช้งานหลายรายการแล้ว
--experimental_verify_repository_rules=<a string>
รายการ -
หากรายการกฎที่เก็บซึ่งควรยืนยันแฮชของไดเรกทอรีเอาต์พุต ระบบจะระบุไฟล์โดย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ API ของบิลด์ที่เข้าถึงได้ด้วยการสร้างไฟล์ .bzl หรือไฟล์ WORKSPACE
- ค่าเริ่มต้นของ
--[no]experimental_allow_top_level_aspects_parameters
: "จริง" -
ไม่ดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
- รวมการใช้งานหลายรายการแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ซึ่งจะอนุญาตให้ใช้ในกราฟการอ้างอิงที่แก้ไขแล้วแม้ว่าจะมีการประกาศว่าได้รับการแย้งในรีจิสทรีที่เป็นแหล่งที่มา (หากเว็บไซต์ไม่ได้มาจาก NonRegistryReplace) มิฉะนั้น เวอร์ชันที่ยัดเยียดจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชัน yank ที่อนุญาตได้ด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" คุณสามารถปิดใช้งานการตรวจสอบนี้ได้โดยใช้คำหลัก "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ หรือ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบว่าข้อมูลไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบที่ไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าทรัพยากร Dependency ดังกล่าวจะถูกละเว้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท โดยไม่คำนึงถึงค่าของแฟล็กนี้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--lockfile_mode=<off, update or error>
: "ปิด" -
ระบุว่าจะใช้ Lockfile อย่างไรและจะใช้หรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ Lockfile และอัปเดตเมื่อมีการเปลี่ยนแปลง "ข้อผิดพลาด" ให้ใช้ Lockfile แต่จะแสดงข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่ออ่านหรือเขียนไฟล์ล็อกทั้ง 2 ไฟล์
แท็ก: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
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งการบันทึกมีดังนี้
- ค่าเริ่มต้นของ
--[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") หรือ 2 รูปแบบ รูปแบบหนึ่งเพื่อจับคู่กับ และอีกแบบหนึ่งใช้เป็น URL แทนโดยมีการอ้างอิงย้อนกลับที่เริ่มจาก "$1" เป็นไปได้ที่คำสั่ง "rewrite" อาจมีผลลัพธ์ใน URL เดียวกันหลายรายการ และระบบจะส่ง URL เดียวกันนี้กลับไปหลายรายการสำหรับ URL เดียวกัน)
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้จัดหมวดหมู่:
- รวมการใช้งานหลายรายการแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace"
ตัวเลือกการปิดเครื่อง
- ตัวเลือกที่ปรากฏก่อนคำสั่งและถูกแยกวิเคราะห์โดยไคลเอ็นต์ ได้แก่
- รวมการใช้งานหลายรายการแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบแคช แทนที่จะคัดลอก โดยมีจุดประสงค์เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่มาจาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม ซึ่งสามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ส่งผลให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_repository_disable_download
: "เท็จ" -
หากมีการตั้งค่า ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองแก้ไขข้อผิดพลาดในการดาวน์โหลดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานได้ในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้นของ
--http_timeout_scaling=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลด HTTP ตามปัจจัยที่กำหนด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูรายละเอียด -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็กbazel_internal_configuration
- ตัวเลือกที่ควบคุมเอาต์พุตของคำสั่งมีดังนี้
- ค่าเริ่มต้นของ
--iff_heap_size_greater_than=<an integer>
: "0" -
หากไม่ใช่ 0 การปิดระบบจะปิดเซิร์ฟเวอร์ก็ต่อเมื่อหน่วยความจำรวม (เป็น MB) ที่ JVM ใช้เกินค่านี้
แท็ก:loses_incremental_state
,eagerness_to_exit
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมของแฟล็ก ฯลฯ)
- ค่าเริ่มต้นของ
--experimental_repository_hash_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรยืนยันแฮชไดเรกทอรีที่เก็บ
แท็ก:affects_outputs
,experimental
- รวมการใช้งานหลายรายการแล้ว
--experimental_verify_repository_rules=<a string>
รายการ -
หากรายการกฎที่เก็บซึ่งควรยืนยันแฮชของไดเรกทอรีเอาต์พุต ระบบจะระบุไฟล์โดย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ API ของบิลด์ที่เข้าถึงได้ด้วยการสร้างไฟล์ .bzl หรือไฟล์ WORKSPACE
- ค่าเริ่มต้นของ
--[no]experimental_allow_top_level_aspects_parameters
: "จริง" -
ไม่ดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
- รวมการใช้งานหลายรายการแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ซึ่งจะอนุญาตให้ใช้ในกราฟการอ้างอิงที่แก้ไขแล้วแม้ว่าจะมีการประกาศว่าได้รับการแย้งในรีจิสทรีที่เป็นแหล่งที่มา (หากเว็บไซต์ไม่ได้มาจาก NonRegistryReplace) มิฉะนั้น เวอร์ชันที่ยัดเยียดจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชัน yank ที่อนุญาตได้ด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" คุณสามารถปิดใช้งานการตรวจสอบนี้ได้โดยใช้คำหลัก "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ หรือ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบว่าข้อมูลไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบที่ไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าทรัพยากร Dependency ดังกล่าวจะถูกละเว้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท โดยไม่คำนึงถึงค่าของแฟล็กนี้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--lockfile_mode=<off, update or error>
: "ปิด" -
ระบุว่าจะใช้ Lockfile อย่างไรและจะใช้หรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ Lockfile และอัปเดตเมื่อมีการเปลี่ยนแปลง "ข้อผิดพลาด" ให้ใช้ Lockfile แต่จะแสดงข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่ออ่านหรือเขียนไฟล์ล็อกทั้ง 2 ไฟล์
แท็ก: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
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งการบันทึกมีดังนี้
- ค่าเริ่มต้นของ
--[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") หรือ 2 รูปแบบ รูปแบบหนึ่งเพื่อจับคู่กับ และอีกแบบหนึ่งใช้เป็น URL แทนโดยมีการอ้างอิงย้อนกลับที่เริ่มจาก "$1" เป็นไปได้ที่คำสั่ง "rewrite" อาจมีผลลัพธ์ใน URL เดียวกันหลายรายการ และระบบจะส่ง URL เดียวกันนี้กลับไปหลายรายการสำหรับ URL เดียวกัน)
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้จัดหมวดหมู่:
- รวมการใช้งานหลายรายการแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace"
ตัวเลือกการซิงค์
- ตัวเลือกที่ปรากฏก่อนคำสั่งและถูกแยกวิเคราะห์โดยไคลเอ็นต์ ได้แก่
- รวมการใช้งานหลายรายการแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบแคช แทนที่จะคัดลอก โดยมีจุดประสงค์เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่มาจาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม ซึ่งสามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ส่งผลให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_repository_disable_download
: "เท็จ" -
หากมีการตั้งค่า ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองแก้ไขข้อผิดพลาดในการดาวน์โหลดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานได้ในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้นของ
--http_timeout_scaling=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลด HTTP ตามปัจจัยที่กำหนด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูรายละเอียด -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการดำเนินการบิลด์มีดังนี้
- ค่าเริ่มต้นของ
--[no]configure
: "เท็จ" -
เฉพาะการซิงค์ที่เก็บที่ทำเครื่องหมายเป็น "กำหนดค่า" เพื่อวัตถุประสงค์ในการกำหนดค่าระบบ
แท็ก:changes_inputs
- ค่าเริ่มต้นของ
--[no]incompatible_remote_dangling_symlinks
: "จริง" -
หากตั้งค่าเป็น "จริง" และ --incompatible_remote_symlinks ก็เป็นจริงด้วยเช่นกัน ลิงก์สัญลักษณ์ในเอาต์พุตการดำเนินการจะได้รับอนุญาตให้ห้อยลง
แท็ก:execution
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remote_symlinks
: "จริง" -
หากตั้งค่าเป็น "จริง" Bazel จะแสดงลิงก์สัญลักษณ์ในเอาต์พุตการดำเนินการในโปรโตคอลการแคช/การดำเนินการระยะไกลในลักษณะดังกล่าว มิฉะนั้นระบบจะติดตามลิงก์สัญลักษณ์และแสดงเป็นไฟล์หรือไดเรกทอรี ดูรายละเอียดได้ที่ #6631
แท็ก:execution
,incompatible_change
--[no]keep_going
[-k
] ค่าเริ่มต้น: "เท็จ"-
ดำเนินการต่อให้มากที่สุดหลังเกิดข้อผิดพลาด แม้ว่าเป้าหมายที่ล้มเหลวและเป้าหมายที่ขึ้นอยู่กับเป้าหมายจะไม่สามารถวิเคราะห์ได้ แต่ข้อกำหนดเบื้องต้นอื่นๆ ของเป้าหมายเหล่านี้อาจทำได้
แท็ก: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") ตามด้วยการดำเนินการ ([-|*]<Flo>) เช่น "auto", "HOST_CPUS*.5" "auto" ตั้งค่าเริ่มต้นที่สมเหตุสมผลตามทรัพยากรของโฮสต์ ต้องไม่ต่ำกว่า 1
แท็ก:bazel_internal_configuration
- รวมการใช้งานหลายรายการแล้ว
--only=<a string>
รายการ -
หากใช้ตัวเลือกนี้ ให้ซิงค์เฉพาะที่เก็บที่ระบุด้วยตัวเลือกนี้ ขอให้พิจารณาว่าทุกรายการ (หรือทั้งหมดที่กำหนดการกำหนดค่าของ "ของ --" ได้รับการกำหนดไว้) ล้าสมัย
แท็ก:changes_inputs
- ตัวเลือกที่ช่วยให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการ ซึ่งจะส่งผลต่อค่าแทนการมีอยู่
- ค่าเริ่มต้นของ
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
จำนวนไฟล์เปิดสูงสุดที่อนุญาตระหว่างการอัปโหลดอาร์ติแฟกต์ BEP
แท็ก:affects_outputs
--remote_download_minimal
-
ไม่ดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลไปยังเครื่องภายใน ค่าสถานะนี้เป็นทางลัดสำหรับแฟล็ก --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_เอาต์พุต_metadata และ --remote_download_outputs=minimal
ขยายเป็น
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--remote_download_outputs=<all, minimal or toplevel>
: "ทั้งหมด" -
หากตั้งค่าเป็น "ต่ำสุด" จะไม่ดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลใดๆ ไปยังเครื่องในระบบ ยกเว้นเอาต์พุตที่การดำเนินการในเครื่องต้องการ หากตั้งค่าเป็น "ระดับบนสุด" จะมีการทำงานเหมือน "ต่ำสุด" เว้นแต่ว่าจะดาวน์โหลดเอาต์พุตของเป้าหมายระดับบนสุดไปยังเครื่องภายในด้วย ทั้ง 2 ตัวเลือกช่วยลดเวลาในการสร้างได้อย่างมากหากแบนด์วิดท์ของเครือข่ายเป็นจุดคอขวด
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--remote_download_symlink_template=<a string>
: "" -
สร้างลิงก์สัญลักษณ์แทนการดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลไปยังเครื่องภายใน สามารถระบุเป้าหมายของลิงก์สัญลักษณ์ในรูปแบบของสตริงเทมเพลตได้ สตริงเทมเพลตนี้อาจมี {hash} และ {size_bytes} ที่ขยายเป็นแฮชของออบเจ็กต์และขนาดเป็นไบต์ตามลำดับ เช่น ลิงก์สัญลักษณ์เหล่านี้อาจชี้ไปยังระบบไฟล์ FUSE ที่โหลดออบเจ็กต์จาก CAS ออนดีมานด์
แท็ก:affects_outputs
--remote_download_toplevel
-
ดาวน์โหลดเฉพาะเอาต์พุตระยะไกลของเป้าหมายระดับบนสุดไปยังเครื่องภายในเท่านั้น ค่าสถานะนี้เป็นทางลัดสำหรับแฟล็ก --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata และ --remote_download_เอาต์พุต=toplevel
ขยายไปยัง
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
แท็ก:affects_outputs
- ตัวเลือกที่มีผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมของแฟล็ก ฯลฯ) ได้แก่
- ค่าเริ่มต้นของ
--experimental_repository_hash_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรยืนยันแฮชไดเรกทอรีที่เก็บ
แท็ก:affects_outputs
,experimental
- รวมการใช้งานหลายรายการแล้ว
--experimental_verify_repository_rules=<a string>
รายการ -
หากรายการกฎที่เก็บซึ่งควรยืนยันแฮชของไดเรกทอรีเอาต์พุต ระบบจะระบุไฟล์โดย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ API ของบิลด์ที่เข้าถึงได้ด้วยการสร้างไฟล์ .bzl หรือไฟล์ WORKSPACE
- ค่าเริ่มต้นของ
--[no]experimental_allow_top_level_aspects_parameters
: "จริง" -
ไม่ดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ค่าเริ่มต้นของ
--[no]incompatible_config_setting_private_default_visibility
: "เท็จ" -
หากแฟล็กนี้เป็นเท็จ config_setting ที่ไม่มีแอตทริบิวต์การเปิดเผยอย่างชัดเจนจะเป็น //visibility:public หากแฟล็กนี้เป็นจริง config_setting จะใช้ตรรกะการแสดงผลเดียวกันกับกฎอื่นๆ ทั้งหมด ดู https://github.com/bazelbuild/bazel/issues/12933
แท็ก:loading_and_analysis
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_enforce_config_setting_visibility
: "จริง" -
หากเป็น "จริง" ให้บังคับใช้ข้อจํากัดระดับการเข้าถึง config_setting หากเป็น "เท็จ" ทุก config_setting จะปรากฏกับทุกเป้าหมาย ดู https://github.com/bazelbuild/bazel/issues/12932
แท็กloading_and_analysis
,incompatible_change
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
- รวมการใช้งานหลายรายการแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ซึ่งจะอนุญาตให้ใช้ในกราฟการอ้างอิงที่แก้ไขแล้วแม้ว่าจะมีการประกาศว่าได้รับการแย้งในรีจิสทรีที่เป็นแหล่งที่มา (หากเว็บไซต์ไม่ได้มาจาก NonRegistryReplace) มิฉะนั้น เวอร์ชันที่ยัดเยียดจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชัน yank ที่อนุญาตได้ด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" คุณสามารถปิดใช้งานการตรวจสอบนี้ได้โดยใช้คำหลัก "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ หรือ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบว่าข้อมูลไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบที่ไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าทรัพยากร Dependency ดังกล่าวจะถูกละเว้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท โดยไม่คำนึงถึงค่าของแฟล็กนี้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--lockfile_mode=<off, update or error>
: "ปิด" -
ระบุว่าจะใช้ Lockfile อย่างไรและจะใช้หรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ Lockfile และอัปเดตเมื่อมีการเปลี่ยนแปลง "ข้อผิดพลาด" ให้ใช้ Lockfile แต่จะแสดงข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่ออ่านหรือเขียนไฟล์ล็อกทั้ง 2 ไฟล์
แท็ก: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
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งการบันทึกมีดังนี้
- ค่าเริ่มต้นของ
--[no]experimental_record_metrics_for_all_mnemonics
: "เท็จ" - โดยค่าเริ่มต้น ประเภทการดําเนินการจะจํากัดอยู่ที่ 20 ประเภทที่มีจำนวนการดำเนินการสูงสุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสําหรับการช่วยจำทั้งหมด
- ค่าเริ่มต้นของ
--experimental_repository_resolved_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้เขียนค่า Starlark ด้วยข้อมูลที่แก้ไขแล้วของกฎที่เก็บ Starlark ทั้งหมดที่มีการนำไปใช้
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--remote_print_execution_messages=<failure, success or all>
: "failure" -
เลือกเวลาที่จะพิมพ์ข้อความการดำเนินการจากระยะไกล ค่าที่ถูกต้องคือ "failure" จะพิมพ์เฉพาะเวลาที่ล้มเหลว "ความสำเร็จ" จะพิมพ์เฉพาะเมื่อสำเร็จ และ "all" จะพิมพ์ทุกครั้ง
แท็ก:terminal_output
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ค่าเริ่มต้นของ
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
หากเว้นว่างไว้ ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล
- ค่าเริ่มต้น
--experimental_circuit_breaker_strategy=<failure>
: ดูรายละเอียด -
ระบุกลยุทธ์ที่เบรกเกอร์จะใช้ กลยุทธ์ที่ใช้ได้คือ "ล้มเหลว" เมื่อค่าไม่ถูกต้องสำหรับตัวเลือก ลักษณะการทำงานจะเหมือนกับที่ไม่ได้กำหนดตัวเลือกไว้
แท็ก:execution
- ค่าเริ่มต้น
--experimental_downloader_config=<a string>
: ดูรายละเอียด - ระบุไฟล์ที่จะใช้กำหนดค่าเครื่องมือดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด โดยแต่ละบรรทัดจะขึ้นต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือ 2 รูปแบบ รูปแบบหนึ่งเพื่อจับคู่กับ และอีกแบบหนึ่งใช้เป็น URL แทนโดยมีการอ้างอิงย้อนกลับที่เริ่มจาก "$1" เป็นไปได้ที่คำสั่ง "rewrite" อาจมีผลลัพธ์ใน URL เดียวกันหลายรายการ และระบบจะส่ง URL เดียวกันนี้กลับไปหลายรายการสำหรับ URL เดียวกัน)
- ค่าเริ่มต้นของ
--[no]experimental_guard_against_concurrent_changes
: "เท็จ" - ปิดการตั้งค่านี้เพื่อปิดใช้การตรวจสอบเวลาของไฟล์อินพุตของการดำเนินการก่อนที่จะอัปโหลดไปยังแคชระยะไกล อาจมีกรณีที่เคอร์เนลของ Linux ทำให้การเขียนไฟล์ล่าช้า ซึ่งอาจทำให้เกิดผลบวกลวง
- ค่าเริ่มต้นของ
--experimental_remote_build_event_upload=<all or minimal>
: "ทั้งหมด" - หากตั้งค่าเป็น "ทั้งหมด" ระบบจะอัปโหลดเอาต์พุตในเครื่องทั้งหมดที่ BEP อ้างอิงไปยังแคชระยะไกล หากตั้งค่าเป็น "minimal" เอาต์พุตในเครื่องที่อ้างอิงโดย BEP จะไม่อัปโหลดไปยังแคชระยะไกล ยกเว้นไฟล์ที่มีความสำคัญต่อผู้ใช้ BEP (เช่น บันทึกการทดสอบและโปรไฟล์การจับเวลา) ระบบจะใช้รูปแบบ bytesstream:// กับ URI ของไฟล์เสมอแม้ว่าจะหายไปจากแคชระยะไกลก็ตาม มีค่าเริ่มต้นเป็น "ทั้งหมด"
- ค่าเริ่มต้นของ
--[no]experimental_remote_cache_async
: "เท็จ" - หากเป็น "จริง" I/O แคชระยะไกลจะเกิดขึ้นในเบื้องหลังแทนที่จะเกิดขึ้นเป็นส่วนหนึ่งของการสร้าง
- ค่าเริ่มต้นของ
--[no]experimental_remote_cache_compression
: "เท็จ" - หากเปิดใช้ ให้บีบอัด/ยกเลิกการบีบอัด Cache Blob ด้วย zstd
- ค่าเริ่มต้น
--experimental_remote_capture_corrupted_outputs=<a path>
: ดูรายละเอียด - เส้นทางไปยังไดเรกทอรีที่จะบันทึกเอาต์พุตที่เสียหาย
- ค่าเริ่มต้นของ
--[no]experimental_remote_discard_merkle_trees
: "เท็จ" - หากตั้งค่าเป็น "จริง" ให้ทิ้งสำเนาในหน่วยความจำของต้นไม้ Merkle ของรูทอินพุตและการแมปอินพุตที่เกี่ยวข้องระหว่างการเรียกใช้ GetAction Results() และ Execute() ซึ่งวิธีนี้จะช่วยลดการใช้หน่วยความจำลงอย่างมาก แต่ Bazel จะต้องคำนวณใหม่เมื่อแคชระยะไกลไม่พบและลองใหม่
- ค่าเริ่มต้น
--experimental_remote_downloader=<a string>
: ดูรายละเอียด - URI ปลายทางของ Remote Asset API ที่จะใช้เป็นพร็อกซีการดาวน์โหลดระยะไกล สคีมาที่รองรับคือ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (UNIX Sockets) หากไม่ได้กำหนดสคีมาไว้ Bazel จะใช้ค่าเริ่มต้นเป็น grpcs โปรดดูที่ https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.prof
- ค่าเริ่มต้นของ
--[no]experimental_remote_downloader_local_fallback
: "เท็จ" - จะกลับไปใช้โปรแกรมดาวน์โหลดในเครื่องหากโปรแกรมดาวน์โหลดระยะไกลล้มเหลว
- ค่าเริ่มต้นของ
--[no]experimental_remote_execution_keepalive
: "เท็จ" - ต้องการใช้ Keepalive สำหรับการเรียกใช้การดำเนินการระยะไกลหรือไม่
- ค่าเริ่มต้นของ
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
: "10" -
กำหนดจำนวนอัตราการทำงานไม่สำเร็จเป็นเปอร์เซ็นต์ที่อนุญาตสำหรับกรอบเวลาหนึ่งๆ หลังจากที่ระบบหยุดเรียกใช้แคช/ไฟล์ดำเนินการระยะไกล ค่าเริ่มต้นคือ 10 การตั้งค่านี้เป็น 0 หมายความว่าจะไม่มีข้อจำกัด
แท็ก:execution
- ค่าเริ่มต้นของ
--experimental_remote_failure_window_interval=<An immutable length of time.>
: "60 วินาที" -
ช่วงที่มีการคำนวณอัตราความล้มเหลวของคำขอระยะไกล สำหรับค่าศูนย์หรือค่าลบ ระยะเวลาที่ล้มเหลวจะได้รับการคำนวณตลอดระยะเวลาของการดำเนินการ หน่วยต่อไปนี้สามารถใช้ได้: วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]experimental_remote_mark_tool_inputs
: "เท็จ" - หากตั้งค่าเป็น "จริง" Bazel จะทำเครื่องหมายอินพุตเป็นอินพุตเครื่องมือสำหรับผู้ดำเนินการระยะไกล ข้อมูลนี้สามารถใช้ในการติดตั้งใช้งานผู้ปฏิบัติงานถาวรระยะไกล
- ค่าเริ่มต้นของ
--[no]experimental_remote_merkle_tree_cache
: "เท็จ" - หากตั้งค่าเป็น "จริง" ระบบจะบันทึกการคำนวณต้นไม้ Merkle เพื่อปรับปรุงความเร็วในการตรวจสอบ Hit ของแคชระยะไกล รอยเท้าหน่วยความจำของแคชจะควบคุมโดย --experimental_remote_merkle_tree_cache_size
- ค่าเริ่มต้นของ
--experimental_remote_merkle_tree_cache_size=<a long integer>
: "1,000" - จำนวนต้น Merkle ที่จะบันทึกเพื่อปรับปรุงความเร็วในการตรวจสอบแคชระยะไกล แม้ว่าแคชจะถูกตัดออกโดยอัตโนมัติตามการจัดการแบบซอฟต์การอ้างอิงของ Java แต่ข้อผิดพลาดจากหน่วยความจำนอกหน่วยความจำอาจเกิดขึ้นได้หากตั้งค่าสูงเกินไป หากตั้งค่าเป็น 0 ขนาดของแคชจะเป็นแบบไม่จำกัด มูลค่าที่เหมาะสมที่สุดจะแตกต่างกันไปโดยขึ้นอยู่กับขนาดของโปรเจ็กต์ ค่าเริ่มต้นคือ 1,000
- ค่าเริ่มต้นของ
--[no]experimental_remote_require_cached
: "เท็จ" - หากตั้งค่าเป็น "จริง" ให้บังคับให้มีการแคชการดำเนินการทั้งหมดที่เรียกใช้จากระยะไกลได้ มิเช่นนั้นระบบจะสร้างบิลด์ไม่สำเร็จ วิธีนี้มีประโยชน์ในการแก้ปัญหาที่ไม่ขึ้นอยู่กับการตัดสินใจ เนื่องจากจะช่วยให้สามารถตรวจสอบว่ามีการแคชการดำเนินการที่ควรแคชไว้จริงหรือไม่ โดยไม่ต้องแทรกผลลัพธ์ใหม่ลงในแคช
- ค่าเริ่มต้นของ
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "เท็จ" - หากตั้งค่าเป็น "จริง" ระบบจะไม่อัปโหลดเอาต์พุตที่ BEP อ้างอิงไปยังแคชระยะไกลหากการดำเนินการที่สร้างไม่สามารถแคชจากระยะไกลได้
- ค่าเริ่มต้นของ
--[no]incompatible_remote_downloader_send_all_headers
: "จริง" -
กำหนดว่าจะส่งค่าของส่วนหัวที่มีหลายค่าไปยังเครื่องมือดาวน์โหลดระยะไกลแทนที่จะส่งเพียงค่าแรกหรือไม่
แท็ก:incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remote_output_paths_relative_to_input_root
: "เท็จ" -
หากตั้งค่าเป็น "จริง" เส้นทางเอาต์พุตจะสัมพัทธ์กับรูทของอินพุตแทนที่จะเป็นไดเรกทอรีที่ใช้งานอยู่
แท็ก:incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remote_results_ignore_disk
: "จริง" -
หากตั้งค่าเป็น "จริง" --noremote_upload_local_results และ --noremote_accept_cached จะไม่มีผลกับดิสก์แคช หากใช้แคชแบบรวม:
--noremote_upload_local_results จะทำให้มีการเขียนผลลัพธ์ลงในดิสก์แคช แต่ไม่อัปโหลดไปยังแคชระยะไกล
--noremote_accept_cached จะทำให้ Bazel ตรวจสอบผลลัพธ์ในดิสก์แคช แต่ไม่ใช่ในแคชระยะไกล
การดำเนินการ no-remote-exec สามารถไปยังดิสก์แคชได้
ดูรายละเอียดได้ที่ #8216
แท็ก:incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
: "เท็จ" -
หากตั้งค่าเป็น "จริง" Bazel จะใช้รหัสออกใหม่ 39 แทน 34 หากแคชระยะไกลกำจัด BLOB ระหว่างบิลด์
แท็ก:incompatible_change
- ค่าเริ่มต้นของ
--[no]remote_accept_cached
: "จริง" - กำหนดว่าจะยอมรับผลการดำเนินการที่แคชไว้จากระยะไกลหรือไม่
- ค่าเริ่มต้น
--remote_bytestream_uri_prefix=<a string>
: ดูรายละเอียด - ชื่อโฮสต์และชื่ออินสแตนซ์ที่จะใช้ใน bytesstream:// URI ที่เขียนลงในสตรีมเหตุการณ์ของบิลด์ ตัวเลือกนี้จะตั้งค่าได้เมื่อมีการดำเนินการบิลด์โดยใช้พร็อกซี ซึ่งทำให้ค่าของ --remote_executor และ --remote_instance_name ไม่ตรงกับชื่อมาตรฐานของบริการดำเนินการระยะไกลอีกต่อไป เมื่อไม่ได้ตั้งค่า ค่าเริ่มต้นจะเป็น "${ชื่อโฮสต์}/${instance_name}"
- ค่าเริ่มต้น
--remote_cache=<a string>
: ดูรายละเอียด - URI ของปลายทางการแคช สคีมาที่รองรับ ได้แก่ http, https, grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (UNIX Sockets) หากไม่ได้กำหนดสคีมาไว้ Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุสคีมา grpc://, http:// หรือ unix: เพื่อปิดใช้ TLS โปรดดู https://bazel.build/remote/caching
- รวมการใช้งานหลายรายการแล้ว
--remote_cache_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอแคช ดังนี้ --remote_cache_header=Name=Value คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- รวมการใช้งานหลายรายการแล้ว
--remote_default_exec_properties=<a 'name=value' assignment>
รายการ -
ตั้งค่าพร็อพเพอร์ตี้ exec เริ่มต้นเพื่อใช้เป็นแพลตฟอร์มการดำเนินการระยะไกล หากแพลตฟอร์มการดำเนินการยังไม่ได้ตั้งค่า exec_properties
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--remote_default_platform_properties=<a string>
: "" - ตั้งค่าพร็อพเพอร์ตี้แพลตฟอร์มเริ่มต้นที่จะตั้งค่าสำหรับ API การดำเนินการระยะไกล หากแพลตฟอร์มการดำเนินการยังไม่ได้ตั้งค่า Remote_execution_properties ไว้ ระบบจะใช้ค่านี้ด้วยหากเลือกแพลตฟอร์มโฮสต์เป็นแพลตฟอร์มการดำเนินการสำหรับการดำเนินการจากระยะไกล
- รวมการใช้งานหลายรายการแล้ว
--remote_downloader_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอเครื่องมือดาวน์โหลดระยะไกล: --remote_downloader_header=Name=Value คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- รวมการใช้งานหลายรายการแล้ว
--remote_exec_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอการดำเนินการ: --remote_exec_header=Name=Value คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- ค่าเริ่มต้นของ
--remote_execution_priority=<an integer>
: "0" - ลำดับความสำคัญของการดำเนินการที่จะดำเนินการจากระยะไกล ความหมายของค่าลำดับความสำคัญหนึ่งๆ จะขึ้นอยู่กับเซิร์ฟเวอร์
- ค่าเริ่มต้น
--remote_executor=<a string>
: ดูรายละเอียด - HOST หรือ HOST:PORT ของปลายทางการดำเนินการระยะไกล สคีมาที่รองรับคือ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (UNIX Sockets) หากไม่ได้กำหนดสคีมาไว้ Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุ grpc:// หรือ unix: schema เพื่อปิดใช้ TLS
- ค่าเริ่มต้น
--remote_grpc_log=<a path>
: ดูรายละเอียด - หากระบุไว้ ระบบจะกำหนดเส้นทางไปยังไฟล์เพื่อบันทึกรายละเอียดที่เกี่ยวข้องกับการเรียกใช้ gRPC บันทึกนี้ประกอบด้วยลำดับของ com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry ที่ชื่อว่า ทำการ ทำการ ctrbufs ตามลำดับ โดยให้แต่ละข้อความนำหน้าด้วยตัวแปรที่แสดงถึงขนาดของข้อความ เป็นไฟล์ ctrbuf ที่ต่อเนื่องกันต่อไปนี้ ตามที่ดำเนินการโดยเมธอด LogEntry.writeDelimitedTo(ExportStream)
- รวมการใช้งานหลายรายการแล้ว
--remote_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอ: --remote_header=Name=Value คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- ค่าเริ่มต้นของ
--remote_instance_name=<a string>
: "" - ค่าที่จะส่งผ่านเป็นอินสแตนซ์_name ใน API การดำเนินการระยะไกล
- ค่าเริ่มต้นของ
--[no]remote_local_fallback
: "เท็จ" - กำหนดว่าจะกลับไปใช้กลยุทธ์การดำเนินการภายในเครื่องแบบสแตนด์อโลนหากการดำเนินการจากระยะไกลล้มเหลว
- ค่าเริ่มต้นของ
--remote_local_fallback_strategy=<a string>
: "ท้องถิ่น" - ไม่มีการดำเนินการ เลิกใช้งานไปแล้ว ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7480
- ค่าเริ่มต้นของ
--remote_max_connections=<an integer>
: "100" -
จำกัดจำนวนการเชื่อมต่อสูงสุดพร้อมกันไว้ที่แคช/ผู้ดำเนินการระยะไกล ค่าเริ่มต้นคือ 100 การตั้งค่านี้เป็น 0 หมายความว่าจะไม่มีข้อจำกัด
สำหรับแคชระยะไกลของ HTTP การเชื่อมต่อ TCP 1 รายการจะจัดการคำขอ 1 รายการต่อครั้ง ดังนั้น Bazel สามารถสร้างคำขอพร้อมกันถึง --remote_max_connections รายการ
สำหรับแคช/ไฟล์ดำเนินการระยะไกลของ gRPC ช่อง gRPC 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.>
: "5 วินาที" - การหน่วงเวลา Backoff สูงสุดระหว่างการลองใหม่จากระยะไกล หน่วยต่อไปนี้สามารถใช้ได้: วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
- ค่าเริ่มต้นของ
--remote_timeout=<An immutable length of time.>
: "60 วินาที" - ระยะเวลาสูงสุดในการรอการดำเนินการจากระยะไกลและการเรียกใช้แคช สำหรับแคช REST จะเป็นทั้งระยะหมดเวลาของการเชื่อมต่อและการอ่าน หน่วยต่อไปนี้สามารถใช้ได้: วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
- ค่าเริ่มต้นของ
--[no]remote_upload_local_results
: "จริง" - กำหนดว่าจะอัปโหลดผลการดำเนินการที่ดำเนินการในเครื่องไปยังแคชระยะไกลหรือไม่ หากรีโมตแคชรองรับและผู้ใช้ได้รับอนุญาตให้ดำเนินการ
- ค่าเริ่มต้นของ
--[no]remote_verify_downloads
: "จริง" - หากตั้งค่าเป็น "จริง" Bazel จะคำนวณผลรวมแฮชของการดาวน์โหลดจากระยะไกลทั้งหมด และทิ้งค่าที่แคชไว้จากระยะไกลหากไม่ตรงกับค่าที่คาดไว้
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้จัดหมวดหมู่:
- รวมการใช้งานหลายรายการแล้ว
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
รายการ - กำหนดค่าโปรแกรมช่วยข้อมูลเข้าสู่ระบบเพื่อใช้สำหรับเรียกข้อมูลเข้าสู่ระบบของการให้สิทธิ์สำหรับการดึงข้อมูลที่เก็บ การแคชและการดำเนินการจากระยะไกล รวมถึงบริการเหตุการณ์ของบิลด์ ข้อมูลเข้าสู่ระบบที่ผู้ช่วยเหลือมีให้จะมีความสำคัญเหนือกว่าข้อมูลรับรองที่ --google_default_credentials, --google_credentials, ไฟล์ .netrc หรือพารามิเตอร์ auth ไปยัง billing_ctx.download และ billing_ctx.download_and_extract นั้น อาจระบุได้หลายครั้งเพื่อตั้งค่าผู้ช่วยเหลือหลายราย ดูรายละเอียดได้ที่ https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md
- ค่าเริ่มต้นของ
--credential_helper_cache_duration=<An immutable length of time.>
: "30 นาที" - ระยะเวลาในการแคชข้อมูลเข้าสู่ระบบที่โปรแกรมช่วยรับรองข้อมูลเข้าสู่ระบบให้ไว้ การเรียกใช้ด้วยค่าที่แตกต่างกันจะปรับอายุการใช้งานของรายการที่มีอยู่ก่อนหน้า การส่งค่าเป็น 0 เพื่อล้างแคช คำสั่งสะอาดจะล้างแคชเสมอ โดยไม่คำนึงถึงแฟล็กนี้
- ค่าเริ่มต้นของ
--credential_helper_timeout=<An immutable length of time.>
: "10 วินาที" - กำหนดค่าระยะหมดเวลาสำหรับตัวช่วยข้อมูลเข้าสู่ระบบ ตัวช่วยข้อมูลเข้าสู่ระบบที่ไม่ตอบสนองภายในระยะหมดเวลานี้จะเรียกใช้ไม่สำเร็จ
- ค่าเริ่มต้นของ
--deleted_packages=<comma-separated list of package names>
: "" - รายการชื่อของแพ็กเกจที่คั่นด้วยคอมมาซึ่งระบบบิลด์จะพิจารณาว่าไม่มีอยู่จริง แม้ว่าจะปรากฏในตำแหน่งใดบนเส้นทางแพ็กเกจก็ตาม ใช้ตัวเลือกนี้เมื่อลบแพ็กเกจย่อย "x/y" ของแพ็กเกจ "x" ที่มีอยู่ ตัวอย่างเช่น หลังจากลบ x/y/BUILD ในไคลเอ็นต์แล้ว ระบบบิลด์อาจร้องเรียนหากพบป้ายกำกับ "//x:y/z" หากมีป้ายกำกับ "//x:y/z" อยู่หากยังมีรายการ package_path อื่นอยู่ การระบุ --deleted_packages x/y จะหลีกเลี่ยงปัญหานี้
- ค่าเริ่มต้น
--disk_cache=<a path>
: ดูรายละเอียด - เส้นทางไปยังไดเรกทอรีที่ Bazel อ่านและเขียนการดำเนินการ รวมถึงเอาต์พุตของการดำเนินการได้ แต่หากไม่มี ระบบจะสร้างไดเรกทอรีดังกล่าวขึ้นมา
- ค่าเริ่มต้นของ
--google_auth_scopes=<comma-separated list of options>
: "https://www.googleapis.com/auth/cloud-platform" - รายการขอบเขตการตรวจสอบสิทธิ์ Google Cloud ที่คั่นด้วยคอมมา
- ค่าเริ่มต้น
--google_credentials=<a string>
: ดูรายละเอียด - ระบุไฟล์ที่จะรับข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication
- ค่าเริ่มต้นของ
--[no]google_default_credentials
: "เท็จ" - ระบุว่าจะใช้ "ข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชันของ Google" สำหรับการตรวจสอบสิทธิ์หรือไม่ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication ปิดใช้โดยค่าเริ่มต้น
- ค่าเริ่มต้น
--grpc_keepalive_time=<An immutable length of time.>
: ดูรายละเอียด - กำหนดค่าคําสั่ง ping แบบ Keep-alive สำหรับการเชื่อมต่อ gRPC ขาออก หากตั้งค่านี้ Bazel จะส่งคำสั่ง ping หลังจากไม่มีการดำเนินการอ่านการเชื่อมต่อเป็นเวลานานกว่านี้ แต่เฉพาะในกรณีที่มีการเรียกใช้ gRPC ที่รอดำเนินการอย่างน้อย 1 รายการ เวลาจะถือว่าเป็นรายละเอียดที่ 2 จึงถือเป็นข้อผิดพลาดในการตั้งค่าที่น้อยกว่า 1 วินาที โดยค่าเริ่มต้น การใช้คำสั่ง ping แบบ Keep-alive จะปิดใช้อยู่ คุณควรประสานงานกับเจ้าของบริการก่อนเปิดใช้การตั้งค่านี้ ตัวอย่างเช่น หากต้องการตั้งค่า 30 วินาทีเป็น Flag นี้ ก็ควรจะเป็น --grpc_keepalive_time=30s
- ค่าเริ่มต้นของ
--grpc_keepalive_timeout=<An immutable length of time.>
: "20 วินาที" - กำหนดค่าระยะหมดเวลา Keep-alive สำหรับการเชื่อมต่อ gRPC ขาออก หากเปิดใช้คำสั่ง ping แบบ Keep-alive พร้อมกับ --grpc_keepalive_time จากนั้น Bazel จะหมดเวลาการเชื่อมต่อหากไม่มีการตอบกลับคำสั่ง ping หลังผ่านไประยะหนึ่ง เวลาจะถือว่าเป็นรายละเอียดที่ 2 จึงถือเป็นข้อผิดพลาดในการตั้งค่าที่น้อยกว่า 1 วินาที หากปิดใช้คำสั่ง ping แบบ Keep-alive อยู่ ระบบจะไม่สนใจการตั้งค่านี้
- รวมการใช้งานหลายรายการแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace"
- ค่าเริ่มต้นของ
--package_path=<colon-separated list of options>
: "%workspace%" - รายการที่คั่นด้วยเครื่องหมายทวิภาคของตำแหน่งสำหรับค้นหาแพ็กเกจ องค์ประกอบที่ขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับพื้นที่ทำงานที่ล้อมรอบอยู่ หากไม่ระบุหรือเว้นว่างไว้ ค่าเริ่มต้นจะเป็นเอาต์พุตของ "bazel info default-package-path"
- ค่าเริ่มต้นของ
--[no]show_loading_progress
: "จริง" - หากเปิดใช้จะทำให้ Bazel พิมพ์ข้อความ "กำลังโหลดแพ็กเกจ"
- ค่าเริ่มต้น
--tls_certificate=<a string>
: ดูรายละเอียด - ระบุเส้นทางไปยังใบรับรอง TLS ที่เชื่อถือได้ให้ลงนามในใบรับรองเซิร์ฟเวอร์
- ค่าเริ่มต้น
--tls_client_certificate=<a string>
: ดูรายละเอียด - ระบุใบรับรองไคลเอ็นต์ TLS ที่จะใช้ โดยต้องระบุคีย์ไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
- ค่าเริ่มต้น
--tls_client_key=<a string>
: ดูรายละเอียด - ระบุคีย์ไคลเอ็นต์ TLS ที่จะใช้ นอกจากนี้ คุณยังต้องระบุใบรับรองไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
ตัวเลือกการทดสอบ
รับค่าตัวเลือกทั้งหมดจาก build
- ตัวเลือกที่ปรากฏก่อนคำสั่งและถูกแยกวิเคราะห์โดยไคลเอ็นต์ ได้แก่
- รวมการใช้งานหลายรายการแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบแคช แทนที่จะคัดลอก โดยมีจุดประสงค์เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่มาจาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม ซึ่งสามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ส่งผลให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_repository_disable_download
: "เท็จ" -
หากมีการตั้งค่า ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองแก้ไขข้อผิดพลาดในการดาวน์โหลดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานได้ในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้นของ
--http_timeout_scaling=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลด HTTP ตามปัจจัยที่กำหนด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูรายละเอียด -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ควบคุมการดำเนินการบิลด์มีดังนี้
- ค่าเริ่มต้นของ
--[no]incompatible_remote_dangling_symlinks
: "จริง" -
หากตั้งค่าเป็น "จริง" และ --incompatible_remote_symlinks ก็เป็นจริงด้วยเช่นกัน ลิงก์สัญลักษณ์ในเอาต์พุตการดำเนินการจะได้รับอนุญาตให้ห้อยลง
แท็ก:execution
,incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remote_symlinks
: "จริง" -
หากตั้งค่าเป็น "จริง" Bazel จะแสดงลิงก์สัญลักษณ์ในเอาต์พุตการดำเนินการในโปรโตคอลการแคช/การดำเนินการระยะไกลในลักษณะดังกล่าว มิฉะนั้นระบบจะติดตามลิงก์สัญลักษณ์และแสดงเป็นไฟล์หรือไดเรกทอรี ดูรายละเอียดได้ที่ #6631
แท็ก:execution
,incompatible_change
- ตัวเลือกที่ช่วยให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการ ซึ่งส่งผลต่อค่า ไม่ใช่ที่มีอยู่
- ค่าเริ่มต้นของ
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
จำนวนไฟล์เปิดสูงสุดที่อนุญาตระหว่างการอัปโหลดอาร์ติแฟกต์ BEP
แท็ก:affects_outputs
--remote_download_minimal
-
ไม่ดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลไปยังเครื่องภายใน ค่าสถานะนี้เป็นทางลัดสำหรับแฟล็ก --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_เอาต์พุต_metadata และ --remote_download_outputs=minimal
ขยายเป็น
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--remote_download_outputs=<all, minimal or toplevel>
: "ทั้งหมด" -
หากตั้งค่าเป็น "ต่ำสุด" จะไม่ดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลใดๆ ไปยังเครื่องในระบบ ยกเว้นเอาต์พุตที่การดำเนินการในเครื่องต้องการ หากตั้งค่าเป็น "ระดับบนสุด" จะมีการทำงานเหมือน "ต่ำสุด" เว้นแต่ว่าจะดาวน์โหลดเอาต์พุตของเป้าหมายระดับบนสุดไปยังเครื่องภายในด้วย ทั้ง 2 ตัวเลือกช่วยลดเวลาในการสร้างได้อย่างมากหากแบนด์วิดท์ของเครือข่ายเป็นจุดคอขวด
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--remote_download_symlink_template=<a string>
: "" -
สร้างลิงก์สัญลักษณ์แทนการดาวน์โหลดเอาต์พุตของบิลด์ระยะไกลไปยังเครื่องภายใน สามารถระบุเป้าหมายของลิงก์สัญลักษณ์ในรูปแบบของสตริงเทมเพลตได้ สตริงเทมเพลตนี้อาจมี {hash} และ {size_bytes} ที่ขยายเป็นแฮชของออบเจ็กต์และขนาดเป็นไบต์ตามลำดับ เช่น ลิงก์สัญลักษณ์เหล่านี้อาจชี้ไปยังระบบไฟล์ FUSE ที่โหลดออบเจ็กต์จาก CAS ออนดีมานด์
แท็ก:affects_outputs
--remote_download_toplevel
-
ดาวน์โหลดเฉพาะเอาต์พุตระยะไกลของเป้าหมายระดับบนสุดไปยังเครื่องภายในเท่านั้น ค่าสถานะนี้เป็นทางลัดสำหรับแฟล็ก --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata และ --remote_download_เอาต์พุต=toplevel
ขยายไปยัง
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
แท็ก:affects_outputs
- ตัวเลือกที่มีผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมของแฟล็ก ฯลฯ) ได้แก่
- ค่าเริ่มต้นของ
--experimental_repository_hash_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรยืนยันแฮชไดเรกทอรีที่เก็บ
แท็ก:affects_outputs
,experimental
- รวมการใช้งานหลายรายการแล้ว
--experimental_verify_repository_rules=<a string>
รายการ -
หากรายการกฎที่เก็บซึ่งควรยืนยันแฮชของไดเรกทอรีเอาต์พุต ระบบจะระบุไฟล์โดย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ API ของบิลด์ที่เข้าถึงได้ด้วยการสร้างไฟล์ .bzl หรือไฟล์ WORKSPACE
- ค่าเริ่มต้นของ
--[no]experimental_allow_top_level_aspects_parameters
: "จริง" -
ไม่ดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
- รวมการใช้งานหลายรายการแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ซึ่งจะอนุญาตให้ใช้ในกราฟการอ้างอิงที่แก้ไขแล้วแม้ว่าจะมีการประกาศว่าได้รับการแย้งในรีจิสทรีที่เป็นแหล่งที่มา (หากเว็บไซต์ไม่ได้มาจาก NonRegistryReplace) มิฉะนั้น เวอร์ชันที่ยัดเยียดจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชัน yank ที่อนุญาตได้ด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" คุณสามารถปิดใช้งานการตรวจสอบนี้ได้โดยใช้คำหลัก "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ หรือ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบว่าข้อมูลไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบที่ไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าทรัพยากร Dependency ดังกล่าวจะถูกละเว้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท โดยไม่คำนึงถึงค่าของแฟล็กนี้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--lockfile_mode=<off, update or error>
: "ปิด" -
ระบุว่าจะใช้ Lockfile อย่างไรและจะใช้หรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ Lockfile และอัปเดตเมื่อมีการเปลี่ยนแปลง "ข้อผิดพลาด" ให้ใช้ Lockfile แต่จะแสดงข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่ออ่านหรือเขียนไฟล์ล็อกทั้ง 2 ไฟล์
แท็ก: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
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งการบันทึกมีดังนี้
- ค่าเริ่มต้นของ
--[no]experimental_record_metrics_for_all_mnemonics
: "เท็จ" - โดยค่าเริ่มต้น ประเภทการดําเนินการจะจํากัดอยู่ที่ 20 ประเภทที่มีจำนวนการดำเนินการสูงสุด การตั้งค่าตัวเลือกนี้จะเขียนสถิติสําหรับการช่วยจำทั้งหมด
- ค่าเริ่มต้นของ
--[no]print_relative_test_log_paths
: "เท็จ" -
หากเป็น "จริง" เมื่อพิมพ์เส้นทางไปยังบันทึกการทดสอบ ให้ใช้เส้นทางแบบสัมพัทธ์ที่ใช้ลิงก์สัญลักษณ์อำนวยความสะดวก "การทดสอบ" หมายเหตุ - การเรียกใช้ 'build'/'test'/ฯลฯ ที่ตามมาด้วยการกำหนดค่าอื่นอาจทำให้เป้าหมายของลิงก์สัญลักษณ์นี้เปลี่ยนไป ทำให้เส้นทางที่พิมพ์ก่อนหน้านี้ไม่มีประโยชน์อีกต่อไป
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--remote_print_execution_messages=<failure, success or all>
: "failure" -
เลือกเวลาที่จะพิมพ์ข้อความการดำเนินการจากระยะไกล ค่าที่ถูกต้องคือ "failure" จะพิมพ์เฉพาะเวลาที่ล้มเหลว "ความสำเร็จ" จะพิมพ์เฉพาะเมื่อสำเร็จ และ "all" จะพิมพ์ทุกครั้ง
แท็ก:terminal_output
- ค่าเริ่มต้นของ
--[no]test_verbose_timeout_warnings
: "เท็จ" -
หากเป็น "จริง" ให้พิมพ์คำเตือนเพิ่มเติมเมื่อเวลาดำเนินการทดสอบจริงไม่ตรงกับระยะหมดเวลาที่การทดสอบกำหนดไว้ (ไม่ว่าจะโดยนัยหรือโดยชัดแจ้ง)
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--[no]verbose_test_summary
: "จริง" -
หากเป็น "จริง" ให้พิมพ์ข้อมูลเพิ่มเติม (ระยะเวลา จำนวนการเรียกใช้ที่ล้มเหลว ฯลฯ) ในสรุปการทดสอบ
แท็ก:affects_outputs
- ตัวเลือกที่ระบุหรือแก้ไขอินพุตทั่วไปเป็นคำสั่ง Bazel ที่ไม่อยู่ในหมวดหมู่อื่นๆ
- ค่าเริ่มต้นของ
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
หากเว้นว่างไว้ ให้อ่านไฟล์ที่แก้ไขแล้วที่ระบุแทนไฟล์ WORKSPACE
แท็ก:changes_inputs
- ตัวเลือกการแคชและการดำเนินการจากระยะไกล
- ค่าเริ่มต้น
--experimental_circuit_breaker_strategy=<failure>
: ดูรายละเอียด -
ระบุกลยุทธ์ที่เบรกเกอร์จะใช้ กลยุทธ์ที่ใช้ได้คือ "ล้มเหลว" เมื่อค่าไม่ถูกต้องสำหรับตัวเลือก ลักษณะการทำงานจะเหมือนกับที่ไม่ได้กำหนดตัวเลือกไว้
แท็ก:execution
- ค่าเริ่มต้น
--experimental_downloader_config=<a string>
: ดูรายละเอียด - ระบุไฟล์ที่จะใช้กำหนดค่าเครื่องมือดาวน์โหลดระยะไกล ไฟล์นี้ประกอบด้วยบรรทัด โดยแต่ละบรรทัดจะขึ้นต้นด้วยคำสั่ง ("allow", "block" หรือ "rewrite") ตามด้วยชื่อโฮสต์ (สำหรับ "allow" และ "block") หรือ 2 รูปแบบ รูปแบบหนึ่งเพื่อจับคู่กับ และอีกแบบหนึ่งใช้เป็น URL แทนโดยมีการอ้างอิงย้อนกลับที่เริ่มจาก "$1" เป็นไปได้ที่คำสั่ง "rewrite" อาจมีผลลัพธ์ใน URL เดียวกันหลายรายการ และระบบจะส่ง URL เดียวกันนี้กลับไปหลายรายการสำหรับ URL เดียวกัน)
- ค่าเริ่มต้นของ
--[no]experimental_guard_against_concurrent_changes
: "เท็จ" - ปิดการตั้งค่านี้เพื่อปิดใช้การตรวจสอบเวลาของไฟล์อินพุตของการดำเนินการก่อนที่จะอัปโหลดไปยังแคชระยะไกล อาจมีกรณีที่เคอร์เนลของ Linux ทำให้การเขียนไฟล์ล่าช้า ซึ่งอาจทำให้เกิดผลบวกลวง
- ค่าเริ่มต้นของ
--experimental_remote_build_event_upload=<all or minimal>
: "ทั้งหมด" - หากตั้งค่าเป็น "ทั้งหมด" ระบบจะอัปโหลดเอาต์พุตในเครื่องทั้งหมดที่ BEP อ้างอิงไปยังแคชระยะไกล หากตั้งค่าเป็น "minimal" เอาต์พุตในเครื่องที่อ้างอิงโดย BEP จะไม่อัปโหลดไปยังแคชระยะไกล ยกเว้นไฟล์ที่มีความสำคัญต่อผู้ใช้ BEP (เช่น บันทึกการทดสอบและโปรไฟล์การจับเวลา) ระบบจะใช้รูปแบบ bytesstream:// กับ URI ของไฟล์เสมอแม้ว่าจะหายไปจากแคชระยะไกลก็ตาม มีค่าเริ่มต้นเป็น "ทั้งหมด"
- ค่าเริ่มต้นของ
--[no]experimental_remote_cache_async
: "เท็จ" - หากเป็น "จริง" I/O แคชระยะไกลจะเกิดขึ้นในเบื้องหลังแทนที่จะเกิดขึ้นเป็นส่วนหนึ่งของการสร้าง
- ค่าเริ่มต้นของ
--[no]experimental_remote_cache_compression
: "เท็จ" - หากเปิดใช้ ให้บีบอัด/ยกเลิกการบีบอัด Cache Blob ด้วย zstd
- ค่าเริ่มต้น
--experimental_remote_capture_corrupted_outputs=<a path>
: ดูรายละเอียด - เส้นทางไปยังไดเรกทอรีที่จะบันทึกเอาต์พุตที่เสียหาย
- ค่าเริ่มต้นของ
--[no]experimental_remote_discard_merkle_trees
: "เท็จ" - หากตั้งค่าเป็น "จริง" ให้ทิ้งสำเนาในหน่วยความจำของต้นไม้ Merkle ของรูทอินพุตและการแมปอินพุตที่เกี่ยวข้องระหว่างการเรียกใช้ GetAction Results() และ Execute() ซึ่งวิธีนี้จะช่วยลดการใช้หน่วยความจำลงอย่างมาก แต่ Bazel จะต้องคำนวณใหม่เมื่อแคชระยะไกลไม่พบและลองใหม่
- ค่าเริ่มต้น
--experimental_remote_downloader=<a string>
: ดูรายละเอียด - URI ปลายทางของ Remote Asset API ที่จะใช้เป็นพร็อกซีการดาวน์โหลดระยะไกล สคีมาที่รองรับคือ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (UNIX Sockets) หากไม่ได้กำหนดสคีมาไว้ Bazel จะใช้ค่าเริ่มต้นเป็น grpcs โปรดดูที่ https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.prof
- ค่าเริ่มต้นของ
--[no]experimental_remote_downloader_local_fallback
: "เท็จ" - จะกลับไปใช้โปรแกรมดาวน์โหลดในเครื่องหากโปรแกรมดาวน์โหลดระยะไกลล้มเหลว
- ค่าเริ่มต้นของ
--[no]experimental_remote_execution_keepalive
: "เท็จ" - ต้องการใช้ Keepalive สำหรับการเรียกใช้การดำเนินการระยะไกลหรือไม่
- ค่าเริ่มต้นของ
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
: "10" -
กำหนดจำนวนอัตราการทำงานไม่สำเร็จเป็นเปอร์เซ็นต์ที่อนุญาตสำหรับกรอบเวลาหนึ่งๆ หลังจากที่ระบบหยุดเรียกใช้แคช/ไฟล์ดำเนินการระยะไกล ค่าเริ่มต้นคือ 10 การตั้งค่านี้เป็น 0 หมายความว่าจะไม่มีข้อจำกัด
แท็ก:execution
- ค่าเริ่มต้นของ
--experimental_remote_failure_window_interval=<An immutable length of time.>
: "60 วินาที" -
ช่วงที่มีการคำนวณอัตราความล้มเหลวของคำขอระยะไกล สำหรับค่าศูนย์หรือค่าลบ ระยะเวลาที่ล้มเหลวจะได้รับการคำนวณตลอดระยะเวลาของการดำเนินการ หน่วยต่อไปนี้สามารถใช้ได้: วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
แท็ก:execution
- ค่าเริ่มต้นของ
--[no]experimental_remote_mark_tool_inputs
: "เท็จ" - หากตั้งค่าเป็น "จริง" Bazel จะทำเครื่องหมายอินพุตเป็นอินพุตเครื่องมือสำหรับผู้ดำเนินการระยะไกล ข้อมูลนี้สามารถใช้ในการติดตั้งใช้งานผู้ปฏิบัติงานถาวรระยะไกล
- ค่าเริ่มต้นของ
--[no]experimental_remote_merkle_tree_cache
: "เท็จ" - หากตั้งค่าเป็น "จริง" ระบบจะบันทึกการคำนวณต้นไม้ Merkle เพื่อปรับปรุงความเร็วในการตรวจสอบ Hit ของแคชระยะไกล รอยเท้าหน่วยความจำของแคชจะควบคุมโดย --experimental_remote_merkle_tree_cache_size
- ค่าเริ่มต้นของ
--experimental_remote_merkle_tree_cache_size=<a long integer>
: "1,000" - จำนวนต้น Merkle ที่จะบันทึกเพื่อปรับปรุงความเร็วในการตรวจสอบแคชระยะไกล แม้ว่าแคชจะถูกตัดออกโดยอัตโนมัติตามการจัดการแบบซอฟต์การอ้างอิงของ Java แต่ข้อผิดพลาดจากหน่วยความจำนอกหน่วยความจำอาจเกิดขึ้นได้หากตั้งค่าสูงเกินไป หากตั้งค่าเป็น 0 ขนาดของแคชจะเป็นแบบไม่จำกัด มูลค่าที่เหมาะสมที่สุดจะแตกต่างกันไปโดยขึ้นอยู่กับขนาดของโปรเจ็กต์ ค่าเริ่มต้นคือ 1,000
- ค่าเริ่มต้นของ
--[no]experimental_remote_require_cached
: "เท็จ" - หากตั้งค่าเป็น "จริง" ให้บังคับให้มีการแคชการดำเนินการทั้งหมดที่เรียกใช้จากระยะไกลได้ มิเช่นนั้นระบบจะสร้างบิลด์ไม่สำเร็จ วิธีนี้มีประโยชน์ในการแก้ปัญหาที่ไม่ขึ้นอยู่กับการตัดสินใจ เนื่องจากจะช่วยให้สามารถตรวจสอบว่ามีการแคชการดำเนินการที่ควรแคชไว้จริงหรือไม่ โดยไม่ต้องแทรกผลลัพธ์ใหม่ลงในแคช
- ค่าเริ่มต้นของ
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "เท็จ" - หากตั้งค่าเป็น "จริง" ระบบจะไม่อัปโหลดเอาต์พุตที่ BEP อ้างอิงไปยังแคชระยะไกลหากการดำเนินการที่สร้างไม่สามารถแคชจากระยะไกลได้
- ค่าเริ่มต้นของ
--[no]incompatible_remote_downloader_send_all_headers
: "จริง" -
กำหนดว่าจะส่งค่าของส่วนหัวที่มีหลายค่าไปยังเครื่องมือดาวน์โหลดระยะไกลแทนที่จะส่งเพียงค่าแรกหรือไม่
แท็ก:incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remote_output_paths_relative_to_input_root
: "เท็จ" -
หากตั้งค่าเป็น "จริง" เส้นทางเอาต์พุตจะสัมพัทธ์กับรูทของอินพุตแทนที่จะเป็นไดเรกทอรีที่ใช้งานอยู่
แท็ก:incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remote_results_ignore_disk
: "จริง" -
หากตั้งค่าเป็น "จริง" --noremote_upload_local_results และ --noremote_accept_cached จะไม่มีผลกับดิสก์แคช หากใช้แคชแบบรวม:
--noremote_upload_local_results จะทำให้มีการเขียนผลลัพธ์ลงในดิสก์แคช แต่ไม่อัปโหลดไปยังแคชระยะไกล
--noremote_accept_cached จะทำให้ Bazel ตรวจสอบผลลัพธ์ในดิสก์แคช แต่ไม่ใช่ในแคชระยะไกล
การดำเนินการ no-remote-exec สามารถไปยังดิสก์แคชได้
ดูรายละเอียดได้ที่ #8216
แท็ก:incompatible_change
- ค่าเริ่มต้นของ
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
: "เท็จ" -
หากตั้งค่าเป็น "จริง" Bazel จะใช้รหัสออกใหม่ 39 แทน 34 หากแคชระยะไกลกำจัด BLOB ระหว่างบิลด์
แท็ก:incompatible_change
- ค่าเริ่มต้นของ
--[no]remote_accept_cached
: "จริง" - กำหนดว่าจะยอมรับผลการดำเนินการที่แคชไว้จากระยะไกลหรือไม่
- ค่าเริ่มต้น
--remote_bytestream_uri_prefix=<a string>
: ดูรายละเอียด - ชื่อโฮสต์และชื่ออินสแตนซ์ที่จะใช้ใน bytesstream:// URI ที่เขียนลงในสตรีมเหตุการณ์ของบิลด์ ตัวเลือกนี้จะตั้งค่าได้เมื่อมีการดำเนินการบิลด์โดยใช้พร็อกซี ซึ่งทำให้ค่าของ --remote_executor และ --remote_instance_name ไม่ตรงกับชื่อมาตรฐานของบริการดำเนินการระยะไกลอีกต่อไป เมื่อไม่ได้ตั้งค่า ค่าเริ่มต้นจะเป็น "${ชื่อโฮสต์}/${instance_name}"
- ค่าเริ่มต้น
--remote_cache=<a string>
: ดูรายละเอียด - URI ของปลายทางการแคช สคีมาที่รองรับ ได้แก่ http, https, grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (UNIX Sockets) หากไม่ได้กำหนดสคีมาไว้ Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุสคีมา grpc://, http:// หรือ unix: เพื่อปิดใช้ TLS โปรดดู https://bazel.build/remote/caching
- รวมการใช้งานหลายรายการแล้ว
--remote_cache_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอแคช ดังนี้ --remote_cache_header=Name=Value คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- รวมการใช้งานหลายรายการแล้ว
--remote_default_exec_properties=<a 'name=value' assignment>
รายการ -
ตั้งค่าพร็อพเพอร์ตี้ exec เริ่มต้นเพื่อใช้เป็นแพลตฟอร์มการดำเนินการระยะไกล หากแพลตฟอร์มการดำเนินการยังไม่ได้ตั้งค่า exec_properties
แท็ก:affects_outputs
- ค่าเริ่มต้นของ
--remote_default_platform_properties=<a string>
: "" - ตั้งค่าพร็อพเพอร์ตี้แพลตฟอร์มเริ่มต้นที่จะตั้งค่าสำหรับ API การดำเนินการระยะไกล หากแพลตฟอร์มการดำเนินการยังไม่ได้ตั้งค่า Remote_execution_properties ไว้ ระบบจะใช้ค่านี้ด้วยหากเลือกแพลตฟอร์มโฮสต์เป็นแพลตฟอร์มการดำเนินการสำหรับการดำเนินการจากระยะไกล
- รวมการใช้งานหลายรายการแล้ว
--remote_downloader_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอเครื่องมือดาวน์โหลดระยะไกล: --remote_downloader_header=Name=Value คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- รวมการใช้งานหลายรายการแล้ว
--remote_exec_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอการดำเนินการ: --remote_exec_header=Name=Value คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- ค่าเริ่มต้นของ
--remote_execution_priority=<an integer>
: "0" - ลำดับความสำคัญของการดำเนินการที่จะดำเนินการจากระยะไกล ความหมายของค่าลำดับความสำคัญหนึ่งๆ จะขึ้นอยู่กับเซิร์ฟเวอร์
- ค่าเริ่มต้น
--remote_executor=<a string>
: ดูรายละเอียด - HOST หรือ HOST:PORT ของปลายทางการดำเนินการระยะไกล สคีมาที่รองรับคือ grpc, grpcs (grpc ที่เปิดใช้ TLS) และ Unix (UNIX Sockets) หากไม่ได้กำหนดสคีมาไว้ Bazel จะใช้ค่าเริ่มต้นเป็น grpcs ระบุ grpc:// หรือ unix: schema เพื่อปิดใช้ TLS
- ค่าเริ่มต้น
--remote_grpc_log=<a path>
: ดูรายละเอียด - หากระบุไว้ ระบบจะกำหนดเส้นทางไปยังไฟล์เพื่อบันทึกรายละเอียดที่เกี่ยวข้องกับการเรียกใช้ gRPC บันทึกนี้ประกอบด้วยลำดับของ com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry ที่ชื่อว่า ทำการ ทำการ ctrbufs ตามลำดับ โดยให้แต่ละข้อความนำหน้าด้วยตัวแปรที่แสดงถึงขนาดของข้อความ เป็นไฟล์ ctrbuf ที่ต่อเนื่องกันต่อไปนี้ ตามที่ดำเนินการโดยเมธอด LogEntry.writeDelimitedTo(ExportStream)
- รวมการใช้งานหลายรายการแล้ว
--remote_header=<a 'name=value' assignment>
รายการ - ระบุส่วนหัวที่จะรวมอยู่ในคำขอ: --remote_header=Name=Value คุณสามารถส่งส่วนหัวหลายรายการได้โดยระบุการตั้งค่าสถานะหลายครั้ง ระบบจะแปลงค่าหลายค่าสำหรับชื่อเดียวกันเป็นรายการที่คั่นด้วยคอมมา
- ค่าเริ่มต้นของ
--remote_instance_name=<a string>
: "" - ค่าที่จะส่งผ่านเป็นอินสแตนซ์_name ใน API การดำเนินการระยะไกล
- ค่าเริ่มต้นของ
--[no]remote_local_fallback
: "เท็จ" - กำหนดว่าจะกลับไปใช้กลยุทธ์การดำเนินการภายในเครื่องแบบสแตนด์อโลนหากการดำเนินการจากระยะไกลล้มเหลว
- ค่าเริ่มต้นของ
--remote_local_fallback_strategy=<a string>
: "ท้องถิ่น" - ไม่มีการดำเนินการ เลิกใช้งานไปแล้ว ดูรายละเอียดได้ที่ https://github.com/bazelbuild/bazel/issues/7480
- ค่าเริ่มต้นของ
--remote_max_connections=<an integer>
: "100" -
จำกัดจำนวนการเชื่อมต่อสูงสุดพร้อมกันไว้ที่แคช/ผู้ดำเนินการระยะไกล ค่าเริ่มต้นคือ 100 การตั้งค่านี้เป็น 0 หมายความว่าจะไม่มีข้อจำกัด
สำหรับแคชระยะไกลของ HTTP การเชื่อมต่อ TCP 1 รายการจะจัดการคำขอ 1 รายการต่อครั้ง ดังนั้น Bazel สามารถสร้างคำขอพร้อมกันถึง --remote_max_connections รายการ
สำหรับแคช/ไฟล์ดำเนินการระยะไกลของ gRPC ช่อง gRPC 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.>
: "5 วินาที" - การหน่วงเวลา Backoff สูงสุดระหว่างการลองใหม่จากระยะไกล หน่วยต่อไปนี้สามารถใช้ได้: วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
- ค่าเริ่มต้นของ
--remote_timeout=<An immutable length of time.>
: "60 วินาที" - ระยะเวลาสูงสุดในการรอการดำเนินการจากระยะไกลและการเรียกใช้แคช สำหรับแคช REST จะเป็นทั้งระยะหมดเวลาของการเชื่อมต่อและการอ่าน หน่วยต่อไปนี้สามารถใช้ได้: วัน (d), ชั่วโมง (h), นาที (m), วินาที (s) และมิลลิวินาที (ms) หากไม่ระบุหน่วย ระบบจะตีความค่าเป็นวินาที
- ค่าเริ่มต้นของ
--[no]remote_upload_local_results
: "จริง" - กำหนดว่าจะอัปโหลดผลการดำเนินการที่ดำเนินการในเครื่องไปยังแคชระยะไกลหรือไม่ หากรีโมตแคชรองรับและผู้ใช้ได้รับอนุญาตให้ดำเนินการ
- ค่าเริ่มต้นของ
--[no]remote_verify_downloads
: "จริง" - หากตั้งค่าเป็น "จริง" Bazel จะคำนวณผลรวมแฮชของการดาวน์โหลดจากระยะไกลทั้งหมด และทิ้งค่าที่แคชไว้จากระยะไกลหากไม่ตรงกับค่าที่คาดไว้
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้จัดหมวดหมู่:
- รวมการใช้งานหลายรายการแล้ว
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
รายการ - กำหนดค่าโปรแกรมช่วยข้อมูลเข้าสู่ระบบเพื่อใช้สำหรับเรียกข้อมูลเข้าสู่ระบบของการให้สิทธิ์สำหรับการดึงข้อมูลที่เก็บ การแคชและการดำเนินการจากระยะไกล รวมถึงบริการเหตุการณ์ของบิลด์ ข้อมูลเข้าสู่ระบบที่ผู้ช่วยเหลือมีให้จะมีความสำคัญเหนือกว่าข้อมูลรับรองที่ --google_default_credentials, --google_credentials, ไฟล์ .netrc หรือพารามิเตอร์ auth ไปยัง billing_ctx.download และ billing_ctx.download_and_extract นั้น อาจระบุได้หลายครั้งเพื่อตั้งค่าผู้ช่วยเหลือหลายราย ดูรายละเอียดได้ที่ https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md
- ค่าเริ่มต้นของ
--credential_helper_cache_duration=<An immutable length of time.>
: "30 นาที" - ระยะเวลาในการแคชข้อมูลเข้าสู่ระบบที่โปรแกรมช่วยรับรองข้อมูลเข้าสู่ระบบให้ไว้ การเรียกใช้ด้วยค่าที่แตกต่างกันจะปรับอายุการใช้งานของรายการที่มีอยู่ก่อนหน้า การส่งค่าเป็น 0 เพื่อล้างแคช คำสั่งสะอาดจะล้างแคชเสมอ โดยไม่คำนึงถึงแฟล็กนี้
- ค่าเริ่มต้นของ
--credential_helper_timeout=<An immutable length of time.>
: "10 วินาที" - กำหนดค่าระยะหมดเวลาสำหรับตัวช่วยข้อมูลเข้าสู่ระบบ ตัวช่วยข้อมูลเข้าสู่ระบบที่ไม่ตอบสนองภายในระยะหมดเวลานี้จะเรียกใช้ไม่สำเร็จ
- ค่าเริ่มต้น
--disk_cache=<a path>
: ดูรายละเอียด - เส้นทางไปยังไดเรกทอรีที่ Bazel อ่านและเขียนการดำเนินการ รวมถึงเอาต์พุตของการดำเนินการได้ แต่หากไม่มี ระบบจะสร้างไดเรกทอรีดังกล่าวขึ้นมา
- ค่าเริ่มต้นของ
--google_auth_scopes=<comma-separated list of options>
: "https://www.googleapis.com/auth/cloud-platform" - รายการขอบเขตการตรวจสอบสิทธิ์ Google Cloud ที่คั่นด้วยคอมมา
- ค่าเริ่มต้น
--google_credentials=<a string>
: ดูรายละเอียด - ระบุไฟล์ที่จะรับข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication
- ค่าเริ่มต้นของ
--[no]google_default_credentials
: "เท็จ" - ระบุว่าจะใช้ "ข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชันของ Google" สำหรับการตรวจสอบสิทธิ์หรือไม่ ดูรายละเอียดได้ที่ https://cloud.google.com/docs/authentication ปิดใช้โดยค่าเริ่มต้น
- ค่าเริ่มต้น
--grpc_keepalive_time=<An immutable length of time.>
: ดูรายละเอียด - กำหนดค่าคําสั่ง ping แบบ Keep-alive สำหรับการเชื่อมต่อ gRPC ขาออก หากตั้งค่านี้ Bazel จะส่งคำสั่ง ping หลังจากไม่มีการดำเนินการอ่านการเชื่อมต่อเป็นเวลานานกว่านี้ แต่เฉพาะในกรณีที่มีการเรียกใช้ gRPC ที่รอดำเนินการอย่างน้อย 1 รายการ เวลาจะถือว่าเป็นรายละเอียดที่ 2 จึงถือเป็นข้อผิดพลาดในการตั้งค่าที่น้อยกว่า 1 วินาที โดยค่าเริ่มต้น การใช้คำสั่ง ping แบบ Keep-alive จะปิดใช้อยู่ คุณควรประสานงานกับเจ้าของบริการก่อนเปิดใช้การตั้งค่านี้ ตัวอย่างเช่น หากต้องการตั้งค่า 30 วินาทีเป็น Flag นี้ ก็ควรจะเป็น --grpc_keepalive_time=30s
- ค่าเริ่มต้นของ
--grpc_keepalive_timeout=<An immutable length of time.>
: "20 วินาที" - กำหนดค่าระยะหมดเวลา Keep-alive สำหรับการเชื่อมต่อ gRPC ขาออก หากเปิดใช้คำสั่ง ping แบบ Keep-alive พร้อมกับ --grpc_keepalive_time จากนั้น Bazel จะหมดเวลาการเชื่อมต่อหากไม่มีการตอบกลับคำสั่ง ping หลังผ่านไประยะหนึ่ง เวลาจะถือว่าเป็นรายละเอียดที่ 2 จึงถือเป็นข้อผิดพลาดในการตั้งค่าที่น้อยกว่า 1 วินาที หากปิดใช้คำสั่ง ping แบบ Keep-alive อยู่ ระบบจะไม่สนใจการตั้งค่านี้
- รวมการใช้งานหลายรายการแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace"
- ค่าเริ่มต้น
--tls_certificate=<a string>
: ดูรายละเอียด - ระบุเส้นทางไปยังใบรับรอง TLS ที่เชื่อถือได้ให้ลงนามในใบรับรองเซิร์ฟเวอร์
- ค่าเริ่มต้น
--tls_client_certificate=<a string>
: ดูรายละเอียด - ระบุใบรับรองไคลเอ็นต์ TLS ที่จะใช้ โดยต้องระบุคีย์ไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
- ค่าเริ่มต้น
--tls_client_key=<a string>
: ดูรายละเอียด - ระบุคีย์ไคลเอ็นต์ TLS ที่จะใช้ นอกจากนี้ คุณยังต้องระบุใบรับรองไคลเอ็นต์เพื่อเปิดใช้การตรวจสอบสิทธิ์ไคลเอ็นต์ด้วย
ตัวเลือกเวอร์ชัน
- ตัวเลือกที่ปรากฏก่อนคำสั่งและถูกแยกวิเคราะห์โดยไคลเอ็นต์ ได้แก่
- รวมการใช้งานหลายรายการแล้ว
--distdir=<a path>
รายการ -
ตำแหน่งเพิ่มเติมในการค้นหาที่เก็บถาวรก่อนเข้าถึงเครือข่ายเพื่อดาวน์โหลด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_hardlinks
: "เท็จ" -
หากมีการตั้งค่า แคชที่เก็บจะฮาร์ดลิงก์ไฟล์ในกรณีที่พบแคช แทนที่จะคัดลอก โดยมีจุดประสงค์เพื่อประหยัดพื้นที่ในดิสก์
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้นของ
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "เท็จ" -
หากเป็น "จริง" ให้ใช้สตริงที่มาจาก URL ของการดาวน์โหลดที่เก็บเป็น Canonical_id หากไม่ได้ระบุ ซึ่งจะทำให้ URL มีการดาวน์โหลดอีกครั้ง แม้ว่าแคชจะมีการดาวน์โหลดที่มีแฮชเดียวกันก็ตาม ซึ่งสามารถใช้เพื่อยืนยันว่าการเปลี่ยนแปลง URL จะไม่ส่งผลให้แคชมาสก์ที่เก็บที่เสียหาย
แท็ก:loading_and_analysis
,experimental
- ค่าเริ่มต้นของ
--[no]experimental_repository_disable_download
: "เท็จ" -
หากมีการตั้งค่า ระบบจะไม่อนุญาตให้ดาวน์โหลดที่เก็บภายนอก
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_repository_downloader_retries=<an integer>
: "0" -
จำนวนครั้งสูงสุดในการลองแก้ไขข้อผิดพลาดในการดาวน์โหลดอีกครั้ง หากตั้งค่าเป็น 0 ระบบจะปิดใช้การลองใหม่
แท็ก:experimental
- ค่าเริ่มต้นของ
--experimental_scale_timeouts=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดในกฎที่เก็บ Starlark ตามปัจจัยนี้ วิธีนี้ทำให้ที่เก็บภายนอกทำงานได้ในเครื่องที่ทำงานช้ากว่าที่ผู้เขียนกฎคาดไว้โดยไม่ต้องเปลี่ยนซอร์สโค้ด
แท็ก:bazel_internal_configuration
,experimental
- ค่าเริ่มต้นของ
--http_timeout_scaling=<a double>
: "1.0" -
ปรับขนาดระยะหมดเวลาทั้งหมดที่เกี่ยวข้องกับการดาวน์โหลด HTTP ตามปัจจัยที่กำหนด
แท็ก:bazel_internal_configuration
- ค่าเริ่มต้น
--repository_cache=<a path>
: ดูรายละเอียด -
ระบุตำแหน่งแคชของค่าที่ดาวน์โหลดซึ่งได้รับระหว่างการดึงข้อมูลที่เก็บภายนอก สตริงว่างเป็นอาร์กิวเมนต์จะขอให้ปิดใช้แคช
แท็ก:bazel_internal_configuration
- ตัวเลือกที่ช่วยให้ผู้ใช้กำหนดค่าเอาต์พุตที่ต้องการ ซึ่งส่งผลต่อค่า ไม่ใช่ที่มีอยู่
- ค่าเริ่มต้นของ
--[no]gnu_format
: "เท็จ" -
หากมีการตั้งค่า ให้เขียนเวอร์ชันเป็น Stdout ตามแบบแผนที่อธิบายไว้ในมาตรฐาน GNU
แท็ก:affects_outputs
,execution
- ตัวเลือกที่ส่งผลต่อความเข้มงวดของ Bazel ในการบังคับใช้อินพุตการสร้างที่ถูกต้อง (คำจำกัดความของกฎ ชุดค่าผสมของแฟล็ก ฯลฯ)
- ค่าเริ่มต้นของ
--experimental_repository_hash_file=<a string>
: "" -
หากไม่ว่างเปล่า ให้ระบุไฟล์ที่มีค่าที่แก้ไขแล้ว ซึ่งควรยืนยันแฮชไดเรกทอรีที่เก็บ
แท็ก:affects_outputs
,experimental
- รวมการใช้งานหลายรายการแล้ว
--experimental_verify_repository_rules=<a string>
รายการ -
หากรายการกฎที่เก็บซึ่งควรยืนยันแฮชของไดเรกทอรีเอาต์พุต ระบบจะระบุไฟล์โดย --experimental_repository_hash_file
แท็ก:affects_outputs
,experimental
- ตัวเลือกนี้ส่งผลต่อความหมายของภาษา Starlark หรือ API ของบิลด์ที่เข้าถึงได้ด้วยการสร้างไฟล์ .bzl หรือไฟล์ WORKSPACE
- ค่าเริ่มต้นของ
--[no]experimental_allow_top_level_aspects_parameters
: "จริง" -
ไม่ดำเนินการ
แท็ก:no_op
,deprecated
,experimental
- ตัวเลือกที่เกี่ยวข้องกับเอาต์พุตและความหมายของ Bzlmod:
- รวมการใช้งานหลายรายการแล้ว
--allow_yanked_versions=<a string>
รายการ -
ระบุเวอร์ชันของโมดูลในรูปแบบ `<module1>@<version1>,<module2>@<version2>` ซึ่งจะอนุญาตให้ใช้ในกราฟการอ้างอิงที่แก้ไขแล้วแม้ว่าจะมีการประกาศว่าได้รับการแย้งในรีจิสทรีที่เป็นแหล่งที่มา (หากเว็บไซต์ไม่ได้มาจาก NonRegistryReplace) มิฉะนั้น เวอร์ชันที่ยัดเยียดจะทำให้ความละเอียดล้มเหลว นอกจากนี้ คุณยังกำหนดเวอร์ชัน yank ที่อนุญาตได้ด้วยตัวแปรสภาพแวดล้อม "BZLMOD_ALLOW_YANKED_VERSIONS" คุณสามารถปิดใช้งานการตรวจสอบนี้ได้โดยใช้คำหลัก "ทั้งหมด" (ไม่แนะนำ)
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_bazel_compatibility=<error, warning or off>
: "ข้อผิดพลาด" -
ตรวจสอบความเข้ากันได้ของเวอร์ชัน Bazel ของโมดูล Bazel ค่าที่ถูกต้องคือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ หรือ "ปิด" เพื่อปิดใช้การตรวจสอบ หรือ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบว่าข้อมูลไม่ตรงกัน
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--check_direct_dependencies=<off, warning or error>
: "คำเตือน" -
ตรวจสอบว่าทรัพยากร Dependency "bazel_dep" โดยตรงที่ประกาศในโมดูลรูทเป็นเวอร์ชันเดียวกับที่คุณได้รับในกราฟการอ้างอิงที่แก้ไขแล้วหรือไม่ ค่าที่ถูกต้องคือ "ปิด" เพื่อปิดใช้การตรวจสอบ "คำเตือน" เพื่อพิมพ์คำเตือนเมื่อตรวจพบที่ไม่ตรงกัน หรือ "ข้อผิดพลาด" เพื่อส่งต่อปัญหาไปยังการแก้ปัญหาไม่สำเร็จ
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--[no]ignore_dev_dependency
: "เท็จ" -
หากเป็น "จริง" Bazel จะไม่สนใจ "bazel_dep" และ "use_extension" ที่ประกาศเป็น "dev_dependency" ใน MODULE.bazel ของโมดูลรูท โปรดทราบว่าทรัพยากร Dependency ดังกล่าวจะถูกละเว้นใน MODULE.bazel เสมอ หากไม่ใช่โมดูลรูท โดยไม่คำนึงถึงค่าของแฟล็กนี้
แท็ก:loading_and_analysis
- ค่าเริ่มต้นของ
--lockfile_mode=<off, update or error>
: "ปิด" -
ระบุว่าจะใช้ Lockfile อย่างไรและจะใช้หรือไม่ ค่าที่ถูกต้องคือ "update" เพื่อใช้ Lockfile และอัปเดตเมื่อมีการเปลี่ยนแปลง "ข้อผิดพลาด" ให้ใช้ Lockfile แต่จะแสดงข้อผิดพลาดหากไม่ใช่เวอร์ชันล่าสุด หรือ "ปิด" เพื่ออ่านหรือเขียนไฟล์ล็อกทั้ง 2 ไฟล์
แท็ก: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
- ตัวเลือกที่ส่งผลต่อการพูดรายละเอียด รูปแบบ หรือตำแหน่งการบันทึกมีดังนี้
- ค่าเริ่มต้นของ
--[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") หรือ 2 รูปแบบ รูปแบบหนึ่งเพื่อจับคู่กับ และอีกแบบหนึ่งใช้เป็น URL แทนโดยมีการอ้างอิงย้อนกลับที่เริ่มจาก "$1" เป็นไปได้ที่คำสั่ง "rewrite" อาจมีผลลัพธ์ใน URL เดียวกันหลายรายการ และระบบจะส่ง URL เดียวกันนี้กลับไปหลายรายการสำหรับ URL เดียวกัน)
- ตัวเลือกเบ็ดเตล็ดที่ไม่ได้จัดหมวดหมู่:
- รวมการใช้งานหลายรายการแล้ว
--override_repository=<an equals-separated mapping of repository name to path>
รายการ - ลบล้างที่เก็บด้วยเส้นทางภายในในรูปแบบ <repository name>=<path> หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมบูรณ์ ระบบจะใช้เส้นทางนั้นตามที่เป็นอยู่ หากเส้นทางที่ระบุเป็นเส้นทางแบบสัมพัทธ์ จะสัมพันธ์กับไดเรกทอรีที่ใช้งานอยู่ปัจจุบัน หากเส้นทางที่ระบุขึ้นต้นด้วย "%workspace%" จะสัมพันธ์กับรูทพื้นที่ทำงาน ซึ่งเป็นเอาต์พุตของ "bazel info workspace"
แท็กเอฟเฟกต์ตัวเลือก
unknown |
ตัวเลือกนี้ไม่มีผลหรือไม่ทราบหรือไม่ได้ระบุ |
no_op |
ตัวเลือกนี้ไม่มีผลใดๆ เลย |
loses_incremental_state |
การเปลี่ยนแปลงค่าของตัวเลือกนี้อาจทำให้สูญเสียสถานะที่เพิ่มขึ้นอย่างมาก ซึ่งทำให้การสร้างช้าลง สถานะอาจหายไปเนื่องจากมีการรีสตาร์ทเซิร์ฟเวอร์หรือส่วนใหญ่กราฟทรัพยากร Dependency ใช้งานไม่ได้ |
changes_inputs |
ตัวเลือกนี้จะเปลี่ยนแปลงอินพุตที่ Bazel พิจารณาสำหรับบิลด์อยู่เสมอ เช่น ข้อจำกัดของระบบไฟล์ เวอร์ชันของที่เก็บ หรือตัวเลือกอื่นๆ |
affects_outputs |
ตัวเลือกนี้จะมีผลต่อเอาต์พุตของเบเซล แท็กนี้กว้างโดยเจตนา อาจรวมผลกระทบทางอ้อม และไม่ได้ระบุประเภทของผลลัพธ์ที่ได้รับผลกระทบ |
build_file_semantics |
ตัวเลือกนี้จะมีผลต่อความหมายของไฟล์ BUILD หรือ .bzl |
bazel_internal_configuration |
ตัวเลือกนี้ส่งผลต่อการตั้งค่าเครื่องจักรภายในแบบ Bazel แต่แท็กนี้จะไม่ทำให้อาร์ติแฟกต์ของบิลด์ได้รับผลกระทบ |
loading_and_analysis |
ตัวเลือกนี้ส่งผลต่อการโหลดและการวิเคราะห์ทรัพยากร Dependency และการสร้างกราฟการอ้างอิง |
execution |
โดยตัวเลือกนี้จะมีผลต่อระยะการดำเนินการ เช่น ตัวเลือกที่เกี่ยวข้องกับการทำแซนด์บ็อกซ์หรือการดำเนินการจากระยะไกล |
host_machine_resource_optimizations |
ตัวเลือกนี้จะทริกเกอร์การเพิ่มประสิทธิภาพที่อาจเป็นข้อมูลเฉพาะของเครื่อง และไม่รับประกันว่าจะทํางานได้ในทุกเครื่อง การเพิ่มประสิทธิภาพอาจมีข้อดีข้อเสียกับประสิทธิภาพด้านอื่นๆ เช่น ต้นทุนหน่วยความจำหรือ CPU |
eagerness_to_exit |
ตัวเลือกนี้จะเปลี่ยนวิธีที่ทำให้การทำงานล้มเหลวอย่างตั้งใจจะออกจากความล้มเหลว โดยมีตัวเลือกให้ดำเนินการต่อแม้จะดำเนินการไม่สำเร็จและการสิ้นสุดการเรียกใช้ |
bazel_monitoring |
ตัวเลือกนี้ใช้เพื่อตรวจสอบพฤติกรรมและประสิทธิภาพของเบเซล |
terminal_output |
ตัวเลือกนี้จะมีผลต่อเอาต์พุตเทอร์มินัลของ Bazel |
action_command_lines |
ตัวเลือกนี้จะเปลี่ยนอาร์กิวเมนต์บรรทัดคำสั่งของการดำเนินการบิลด์อย่างน้อย 1 รายการ |
test_runner |
ตัวเลือกนี้จะเปลี่ยนสภาพแวดล้อมผู้ทดสอบของบิลด์ |
แท็กข้อมูลเมตาตัวเลือก
experimental |
ตัวเลือกนี้จะทริกเกอร์ฟีเจอร์ทดลองโดยไม่มีการรับประกันฟังก์ชันการทำงาน |
incompatible_change |
ตัวเลือกนี้จะทริกเกอร์การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ ใช้ตัวเลือกนี้เพื่อทดสอบความพร้อมในการย้ายข้อมูลหรือรับสิทธิ์เข้าถึงฟีเจอร์ใหม่ก่อนใคร |
deprecated |
ตัวเลือกนี้เลิกใช้งานแล้ว ฟีเจอร์ที่ได้รับผลกระทบอาจเลิกใช้งานแล้วหรือเราแนะนำให้ใช้วิธีอื่นในการให้ข้อมูล |
explicit_in_output_path |
ตัวเลือกนี้มีการกล่าวถึงอย่างชัดเจนในไดเรกทอรีเอาต์พุต |