bazel [<startup options>] <command> [<args>]atau
bazel [<startup options>] <command> [<args>] -- [<target patterns>]Baca Panduan Pengguna untuk mengetahui sintaksis pola target.
Sintaksis Opsi
Opsi dapat diteruskan ke Bazel dengan berbagai cara. Opsi yang memerlukan nilai dapat diteruskan dengan tanda sama dengan atau spasi:
--<option>=<value> --<option> <value>Beberapa opsi memiliki bentuk pendek satu karakter; dalam hal ini, format pendek harus diteruskan dengan satu tanda hubung dan spasi.
-<short_form> <value>
Opsi Boolean dapat diaktifkan sebagai berikut:
--<option> --<option>=[true|yes|1]dan dinonaktifkan sebagai berikut:
--no<option> --<option>=[false|no|0]
Opsi tristate biasanya disetel ke otomatis secara default, dan dapat diaktifkan paksa sebagai berikut:
--<option>=[true|yes|1]atau dinonaktifkan secara paksa seperti berikut:
--no<option> --<option>=[false|no|0]
Perintah
analyze-profile |
Menganalisis data profil build. |
aquery |
Menganalisis target dan kueri yang ditentukan di grafik tindakan. |
build |
Mem-build target yang ditentukan. |
canonicalize-flags |
Melakukan kanonikalisasi daftar opsi bazel. |
clean |
Menghapus file output dan menghentikan server jika diinginkan. |
coverage |
Menghasilkan laporan cakupan kode untuk target pengujian yang ditentukan. |
cquery |
Memuat, menganalisis, dan membuat kueri target yang ditentukan dengan konfigurasi. |
dump |
Mengeluarkan status internal proses server bazel. |
fetch |
Mengambil repositori eksternal yang merupakan prasyarat untuk target. |
help |
Mencetak bantuan untuk perintah, atau indeks. |
info |
Menampilkan info runtime tentang server bazel. |
license |
Mencetak lisensi software ini. |
mobile-install |
Menginstal target ke perangkat seluler. |
mod |
Membuat kueri grafik dependensi eksternal Bzlmod |
print_action |
Mencetak argumen baris perintah untuk mengompilasi file. |
query |
Mengeksekusi kueri grafik dependensi. |
run |
Menjalankan target yang ditentukan. |
shutdown |
Menghentikan server bazel. |
sync |
Menyinkronkan semua repositori yang ditentukan dalam file Workspace |
test |
Membangun dan menjalankan target pengujian yang ditentukan. |
vendor |
Mengambil repositori eksternal ke dalam folder tertentu yang ditentukan oleh tanda --vendor_dir. |
version |
Mencetak informasi versi untuk bazel. |
Opsi Startup
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--[no]autodetect_server_javabase
default: "true"-
Jika --noautodetect_server_javabase diteruskan, Bazel tidak akan kembali ke JDK lokal untuk menjalankan server bazel, dan sebagai gantinya, keluar.
Tag:affects_outputs
,loses_incremental_state
--[no]batch
default: "salah"-
Jika disetel, Bazel akan dijalankan hanya sebagai proses klien tanpa server, bukan dalam mode klien/server standar. Hal ini tidak digunakan lagi dan akan dihapus. Sebaiknya matikan server secara eksplisit jika Anda ingin menghindari server yang terus ada.
Tag:loses_incremental_state
,bazel_internal_configuration
,deprecated
--[no]batch_cpu_scheduling
default: "salah"-
Hanya di Linux; gunakan penjadwalan CPU 'batch' untuk Blaze. Kebijakan ini berguna untuk beban kerja yang non-interaktif, tetapi tidak ingin menurunkan nilai yang bagus. Lihat 'man 2 sched_setscheduler'. Jika false, maka Bazel tidak melakukan panggilan sistem.
Tag:host_machine_resource_optimizations
--bazelrc=<path>
default: lihat deskripsi-
Lokasi file .bazelrc pengguna yang berisi nilai default opsi Bazel. {i>/dev/null<i} menunjukkan bahwa semua `--bazelrc`selanjutnya akan diabaikan, yang berguna untuk menonaktifkan pencarian file rc pengguna, misalnya dalam build rilis.
Opsi ini juga dapat ditentukan beberapa kali.
Misalnya, dengan `--bazelrc=x.rc --bazelrc=y.rc --bazelrc=/dev/null --bazelrc=z.rc`,
1) x.rc dan y.rc dibaca.
2) z.rc diabaikan karena {i>/dev/null<i} sebelumnya.
Jika tidak ditentukan, Bazel akan menggunakan file .bazelrc pertama yang ditemukan di dua lokasi berikut: direktori workspace, lalu direktori utama pengguna.
Catatan: opsi command line akan selalu menggantikan opsi apa pun di bazelrc.
Tag:changes_inputs
--[no]block_for_lock
default: "true"-
Jika --noblock_for_lock diteruskan, Bazel tidak menunggu selesainya perintah yang sedang berjalan, tetapi langsung keluar.
Tag:eagerness_to_exit
--[no]client_debug
default: "salah"-
Jika benar, catat informasi debug ke dalam log dari klien ke stderr. Mengubah opsi ini tidak akan menyebabkan server dimulai ulang.
Tag:affects_outputs
,bazel_monitoring
- Default
--connect_timeout_secs=<an integer>
: "30" -
Lamanya waktu tunggu klien untuk setiap upaya terhubung ke server
Tag:bazel_internal_configuration
--digest_function=<hash function>
default: lihat deskripsi-
Fungsi hash yang digunakan saat menghitung ringkasan file.
Tag:loses_incremental_state
,bazel_internal_configuration
--[no]expand_configs_in_place
default: "true"-
Mengubah perluasan flag --config untuk dilakukan secara langsung, bukan perluasan titik tetap antara opsi rc normal dan opsi yang ditentukan command line.
Tag:no_op
,deprecated
--failure_detail_out=<path>
default: lihat deskripsi-
Jika disetel, tentukan lokasi untuk menulis pesan protobuf kegagalan_detail jika server mengalami kegagalan dan tidak dapat melaporkannya melalui gRPC, seperti biasa. Jika tidak, lokasinya akan menjadi ${OUTPUT_BASE}/failure_detail.rawproto.
Tag:affects_outputs
,loses_incremental_state
--[no]home_rc
default: "true"-
Apakah ingin mencari file bazelrc rumah atau tidak di $HOME/.bazelrc
Tag:changes_inputs
--[no]idle_server_tasks
default: "true"-
Jalankan System.gc() saat server tidak ada aktivitas
Tag:loses_incremental_state
,host_machine_resource_optimizations
--[no]ignore_all_rc_files
default: "salah"-
Menonaktifkan semua file rc, terlepas dari nilai tanda modifikasi rc lainnya, meskipun tanda ini muncul kemudian dalam daftar opsi startup.
Tag:changes_inputs
- Default
--io_nice_level={-1,0,1,2,3,4,5,6,7}
: "-1" -
Hanya di Linux; tetapkan level dari 0-7 untuk penjadwalan IO upaya terbaik menggunakan panggilan sistem sys_ioprio_set. 0 adalah prioritas tertinggi, 7 adalah prioritas terendah. Penjadwal antisipatif hanya dapat memenuhi hingga prioritas 4. Jika ditetapkan ke nilai negatif, Bazel tidak melakukan panggilan sistem.
Tag:host_machine_resource_optimizations
- Default
--local_startup_timeout_secs=<an integer>
: "120" -
Durasi maksimum klien menunggu untuk terhubung ke server
Tag:bazel_internal_configuration
--macos_qos_class=<a string>
default: "default"-
Menetapkan class layanan QoS server bazel saat berjalan di macOS. Tanda ini tidak berpengaruh di semua platform lainnya, tetapi didukung untuk memastikan file rc dapat dibagikan di antara platform tersebut tanpa perubahan. Nilai yang memungkinkan adalah: interaktif pengguna, dimulai oleh pengguna, default, utilitas, dan latar belakang.
Tag:host_machine_resource_optimizations
--max_idle_secs=<integer>
default: "10800"-
Jumlah detik saat server build akan menunggu tidak ada aktivitas sebelum dinonaktifkan. Nol berarti server tidak akan pernah dimatikan. Opsi ini hanya dibaca saat server dimulai. Mengubah opsi ini tidak akan menyebabkan server dimulai ulang.
Tag:eagerness_to_exit
,loses_incremental_state
--output_base=<path>
default: lihat deskripsi-
Jika ditetapkan, menentukan lokasi output tempat semua output build akan ditulis. Jika tidak, lokasi akan menjadi ${OUTPUT_ROOT}/_blaze_${USER}/${MD5_OF_WORKSPACE_ROOT}. Catatan: Jika Anda menentukan opsi yang berbeda dari satu panggilan ke panggilan Bazel berikutnya untuk nilai ini, Anda mungkin akan memulai server Bazel tambahan yang baru. Bazel memulai dengan tepat satu server per basis output yang ditentukan. Biasanya ada satu basis output per ruang kerja - tetapi, dengan opsi ini, Anda dapat memiliki beberapa basis output per ruang kerja sehingga menjalankan beberapa build untuk klien yang sama di mesin yang sama secara serentak. Lihat bagian 'bantuan bazel' untuk mematikan server Bazel.
Tag:affects_outputs
,loses_incremental_state
--output_user_root=<path>
default: lihat deskripsi-
Direktori khusus pengguna yang digunakan untuk menulis semua output build; secara default, ini adalah fungsi $USER, tetapi dengan menentukan konstanta, output build dapat dibagikan di antara pengguna yang berkolaborasi.
Tag:affects_outputs
,loses_incremental_state
--[no]preemptible
default: "salah"-
Jika true (benar), perintah tersebut dapat di-preempt jika perintah lain dimulai.
Tag:eagerness_to_exit
--server_jvm_out=<path>
default: lihat deskripsi-
Lokasi untuk menulis output JVM server. Jika tidak disetel, lokasi default akan disetel ke output_base.
Tag:affects_outputs
,loses_incremental_state
--[no]shutdown_on_low_sys_mem
default: "salah"-
Jika max_idle_secs ditetapkan dan server build tidak ada aktivitas untuk sementara waktu, matikan server saat sistem hampir kehabisan RAM yang tersedia. Khusus Linux.
Tag:eagerness_to_exit
,loses_incremental_state
--[no]system_rc
default: "true"-
Apakah akan mencari bazelrc seluruh sistem atau tidak.
Tag:changes_inputs
--[no]unlimit_coredumps
default: "salah"-
Meningkatkan batas soft coredump ke batas keras agar coredump server (termasuk JVM) dan klien dapat dilakukan dalam kondisi umum. Tempelkan flag ini sekali ke bazelrc dan lupakan agar Anda mendapatkan coredump saat benar-benar mengalami kondisi yang memicunya.
Tag:bazel_internal_configuration
--[no]watchfs
default: "salah"-
Jika benar, Bagas akan mencoba menggunakan layanan file watch sistem operasi untuk menemukan perubahan lokal, dan bukan memindai setiap file untuk menemukan perubahan.
Tag:deprecated
--[no]windows_enable_symlinks
default: "salah"-
Jika true (benar), link simbolis sebenarnya akan dibuat di Windows, bukan penyalinan file. Mode developer Windows perlu diaktifkan dan Windows 10 versi 1703 atau yang lebih baru.
Tag:bazel_internal_configuration
--[no]workspace_rc
default: "true"-
Apakah ingin mencari file bazelrc workspace di $workspace/.bazelrc atau tidak
Tag:changes_inputs
- Opsi lain-lain, tidak dikategorikan lain.:
--host_jvm_args=<jvm_arg>
beberapa penggunaan diakumulasikan- Flag untuk diteruskan ke JVM yang menjalankan Blaze.
--host_jvm_debug
-
Opsi kemudahan untuk menambahkan beberapa flag startup JVM tambahan, yang menyebabkan JVM menunggu selama startup hingga Anda terhubung dari debugger yang sesuai dengan JDWP (seperti Eclipse) ke port 5005.
Diluaskan ke:
--host_jvm_args=-Xdebug
--host_jvm_args=-Xrunjdwp:transport=dt_socket,server=y,address=5005
--server_javabase=<jvm path>
default: ""- Jalur ke JVM yang digunakan untuk mengeksekusi Bazel itu sendiri.
Opsi Umum untuk semua Perintah
- Opsi yang mengontrol eksekusi build:
- Default
--experimental_ui_max_stdouterr_bytes=<an integer in (-1)-1073741819 range>
: "1048576" -
Ukuran maksimum file stdout / stderr yang akan dicetak ke konsol. -1 menyiratkan tidak ada batas.
Tag:execution
--[no]incompatible_remote_dangling_symlinks
default: "true"-
Jika disetel ke benar (true), symlink yang diupload ke cache disk atau jarak jauh akan diizinkan untuk menjuntai.
Tag:execution
,incompatible_change
--[no]incompatible_remote_symlinks
default: "true"-
Jika disetel ke benar (true), Bazel akan selalu mengupload symlink seperti itu ke cache disk atau jarak jauh. Jika tidak, symlink relatif yang tidak bergerak (dan hanya symlink) yang akan diupload sebagai file atau direktori yang dituju.
Tag:execution
,incompatible_change
- Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
--[no]incompatible_enable_proto_toolchain_resolution
default: "salah"-
Jika true (benar), aturan proto lang akan menentukan toolchain dari repositori rules_proto, rules_java, rules_cc.
Tag:loading_and_analysis
,incompatible_change
- Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, yang memengaruhi nilainya, bukan keberadaannya:
- Default
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
Jumlah maksimum file terbuka yang diizinkan selama upload artefak BEP.
Tag:affects_outputs
--remote_download_all
-
Mendownload semua output jarak jauh ke mesin lokal. Tanda ini adalah alias untuk --remote_download_outputs=all.
Diluaskan ke:
--remote_download_outputs=all
Tag:affects_outputs
--remote_download_minimal
-
Tidak mendownload output build jarak jauh ke mesin lokal. Tanda ini adalah alias untuk --remote_download_outputs=minimal.
Diluaskan ke:
--remote_download_outputs=minimal
Tag:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
default: "level atas"-
Jika disetel ke 'minimal', output build jarak jauh tidak akan didownload ke mesin lokal, kecuali output yang diperlukan oleh tindakan lokal. Jika disetel ke 'toplevel', perilakunya seperti'minimal' kecuali bahwa output target tingkat atas juga didownload ke mesin lokal. Kedua opsi tersebut dapat secara signifikan mengurangi waktu build jika bandwidth jaringan menjadi bottleneck.
Tag:affects_outputs
--remote_download_symlink_template=<a string>
default: ""-
Buat link simbolis, bukan mendownload output build jarak jauh ke mesin lokal. Target link simbolis dapat ditentukan dalam bentuk string template. String template ini masing-masing dapat berisi {hash} dan {size_bytes} yang diperluas ke hash objek dan ukurannya dalam byte. Link simbolis ini dapat, misalnya, mengarah ke sistem file FUSE yang memuat objek dari CAS sesuai permintaan.
Tag:affects_outputs
--remote_download_toplevel
-
Hanya mendownload output jarak jauh dari target level teratas ke mesin lokal. Tanda ini adalah alias untuk --remote_download_outputs=toplevel.
Diluaskan ke:
--remote_download_outputs=toplevel
Tag:affects_outputs
--repo_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan variabel lingkungan tambahan agar hanya tersedia untuk aturan repositori. Perlu diperhatikan bahwa aturan repositori tetap melihat lingkungan lengkap, tetapi dengan cara ini informasi konfigurasi dapat diteruskan ke repositori melalui opsi tanpa membatalkan validasi grafik tindakan.
Tag:action_command_lines
- Opsi yang memengaruhi seberapa ketat Bazel dalam menerapkan input build yang valid (definisi aturan, kombinasi flag, dll.):
--[no]check_bzl_visibility
default: "true"-
Jika dinonaktifkan, error visibilitas pemuatan .bzl didemosikan menjadi peringatan.
Tag:build_file_semantics
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]enable_bzlmod
default: "true"-
Jika true (benar), akan mengaktifkan sistem pengelolaan dependensi Bzlmod, yang lebih diutamakan daripada WORKSPACE. Lihat https://bazel.build/docs/bzlmod untuk informasi selengkapnya.
Tag:loading_and_analysis
--[no]enable_workspace
default: "true"-
Jika true (benar), mengaktifkan sistem WORKSPACE lama untuk dependensi eksternal. Lihat https://bazel.build/external/overview untuk mengetahui informasi selengkapnya.
Tag:loading_and_analysis
--[no]experimental_action_resource_set
default: "true"-
Jika ditetapkan ke true, ctx.actions.run() dan ctx.actions.run_shell() akan menerima parameter resource_set untuk eksekusi lokal. Jika tidak, default-nya akan menjadi 250 MB untuk memori dan 1 CPU.
Tag:execution
,build_file_semantics
,experimental
--[no]experimental_bzl_visibility
default: "true"-
Jika diaktifkan, akan menambahkan fungsi `Visibility()` yang dapat dipanggil oleh file .bzl selama evaluasi level teratas guna menyetel visibilitasnya untuk tujuan pernyataan load().
Tag:loading_and_analysis
,experimental
-
Jika disetel ke benar (true), atribut aturan dan metode Starlark API yang diperlukan untuk aturan cc_shared_library akan tersedia
Tag:build_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_disable_external_package
default: "salah"-
Jika disetel ke benar (true), //paket eksternal yang dibuat secara otomatis tidak akan tersedia lagi. Bazel masih tidak dapat mengurai file 'external/BUILD', tetapi glob yang menjangkau eksternal/ dari paket tanpa nama akan berfungsi.
Tag:loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_enable_android_migration_apis
default: "salah"-
Jika disetel ke benar (true), API yang diperlukan untuk mendukung migrasi Android Starlark akan diaktifkan.
Tag:build_file_semantics
--[no]experimental_enable_first_class_macros
default: "salah"-
Jika disetel ke benar (true), konfigurasi `macro()` untuk menentukan makro kelas satu.
Tag:build_file_semantics
--[no]experimental_enable_scl_dialect
default: "salah"-
Jika ditetapkan ke true, file .scl dapat digunakan dalam pernyataan load().
Tag:build_file_semantics
--[no]experimental_google_legacy_api
default: "salah"-
Jika ditetapkan ke true, menampilkan sejumlah bagian eksperimental dari API build Starlark yang berkaitan dengan kode lama Google.
Tag:loading_and_analysis
,experimental
--[no]experimental_isolated_extension_usages
default: "salah"-
Jika true (benar), aktifkan parameter <code>isolate</code> di fungsi <a href="https://bazel.build/rules/lib/globals/module#use_extension"><code>use_extension</code></a>.
Tag:loading_and_analysis
--[no]experimental_java_library_export
default: "salah"-
Jika diaktifkan, modul eksperimental_java_library_export_do_not_use akan tersedia.
Tag:loading_and_analysis
,incompatible_change
--[no]experimental_platforms_api
default: "salah"-
Jika disetel ke benar (true), sejumlah Starlark API terkait platform akan aktif dan berguna untuk proses debug.
Tag:loading_and_analysis
,experimental
--[no]experimental_repo_remote_exec
default: "salah"-
Jika ditetapkan ke true, repository_rule akan mendapatkan beberapa kemampuan eksekusi jarak jauh.
Tag:build_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_sibling_repository_layout
default: "salah"-
Jika disetel ke benar (true), repositori non-utama akan ditanam sebagai symlink ke repositori utama di root eksekusi. Artinya, semua repositori adalah turunan langsung dari direktori $output_base/execution_root. Ini memiliki efek samping membebaskan $output_base/execution_root/__main__/external untuk direktori 'eksternal' level teratas yang sebenarnya.
Tag:action_command_lines
,bazel_internal_configuration
,loading_and_analysis
,loses_incremental_state
,experimental
-
Jika ditetapkan ke true, tag akan diterapkan dari target ke persyaratan eksekusi tindakan; jika tidak, tag tidak akan disebarkan. Lihat https://github.com/bazelbuild/bazel/issues/8830 untuk mengetahui detailnya.
Tag:build_file_semantics
,experimental
--[no]incompatible_always_check_depset_elements
default: "true"-
Periksa validitas elemen yang ditambahkan ke dependensi, di semua konstruktor. Elemen harus tidak dapat diubah, tetapi secara historis konstruktor depset(direct=...) lupa memeriksa. Gunakan tule, bukan daftar dalam elemen dependensi. Lihat https://github.com/bazelbuild/bazel/issues/10313 untuk mengetahui detailnya.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_depset_for_libraries_to_link_getter
default: "true"-
Jika true (benar), Bazel tidak lagi menampilkan daftar dari linking_context.libraries_to_link, tetapi menampilkan depset.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_disable_objc_library_transition
default: "true"-
Nonaktifkan transisi kustom objc_library dan warisi dari target tingkat teratas
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_disable_starlark_host_transitions
default: "salah"-
Jika ditetapkan ke true, atribut aturan tidak dapat menetapkan 'cfg = "host"'. Sebagai gantinya, aturan harus menetapkan 'cfg = "exec"'.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_disable_target_default_provider_fields
default: "salah"-
Jika disetel ke benar (true), nonaktifkan kemampuan untuk mengakses penyedia pada objek 'target' melalui sintaksis kolom. Sebagai gantinya, gunakan sintaksis kunci-penyedia. Misalnya, sebagai ganti menggunakan `ctx.attr.dep.my_info` untuk mengakses `my_info` dari dalam fungsi implementasi aturan, gunakan `ctx.attr.dep[MyInfo]`. Lihat https://github.com/bazelbuild/bazel/issues/9014 untuk detailnya.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_disable_target_provider_fields
default: "salah"-
Jika disetel ke benar (true), nonaktifkan kemampuan untuk menggunakan penyedia default melalui sintaksis kolom. Sebagai gantinya, gunakan sintaksis kunci-penyedia. Misalnya, daripada menggunakan `ctx.attr.dep.files` untuk mengakses `file`, gunakan `ctx.attr.dep[DefaultInfo].files Lihat https://github.com/bazelbuild/bazel/issues/9014 untuk detailnya.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_empty_glob
default: "salah"-
Jika ditetapkan ke true, nilai default argumen `allow_empty` glob() adalah Salah.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_struct_provider_syntax
default: "salah"-
Jika ditetapkan ke true, fungsi implementasi aturan mungkin tidak menampilkan struct. Sebagai gantinya, daftar instance penyedia harus ditampilkan.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_enable_deprecated_label_apis
default: "true"-
Jika diaktifkan, API tertentu yang tidak digunakan lagi (native.repository_name, Label.workspace_name, Label.relative) dapat digunakan.
Tag:loading_and_analysis
--[no]incompatible_existing_rules_immutable_view
default: "true"-
Jika ditetapkan ke true, native.existing_rule dan native.existing_rules akan menampilkan objek tampilan ringan yang tidak dapat diubah, bukan dikte yang dapat diubah.
Tag:build_file_semantics
,loading_and_analysis
,incompatible_change
--[no]incompatible_fail_on_unknown_attributes
default: "true"-
Jika diaktifkan, target yang memiliki atribut tidak diketahui yang ditetapkan ke Tidak ada akan gagal.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_fix_package_group_reporoot_syntax
default: "true"-
Dalam atribut `packages` paket_group, ubah arti nilai "//..." untuk merujuk ke semua paket dalam repositori saat ini, bukan semua paket dalam repositori apa pun. Anda dapat menggunakan nilai khusus "public" sebagai pengganti "//..." untuk mendapatkan perilaku lama. Tanda ini mengharuskan --incompatible_package_group_has_public_syntax juga diaktifkan.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_java_common_parameters
default: "true"-
Jika ditetapkan ke true, parameter output_jar, dan host_javabase dalam pack_sources dan host_javabase dalam kompilasi akan dihapus.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_merge_fixed_and_default_shell_env
default: "true"-
Jika diaktifkan, tindakan yang didaftarkan dengan ctx.actions.run dan ctx.actions.run_shell dengan 'env' dan 'use_default_shell_env = True' yang ditentukan akan menggunakan lingkungan yang diperoleh dari lingkungan shell default dengan mengganti dengan nilai yang diteruskan ke 'env'. Jika dinonaktifkan, nilai 'env' akan diabaikan sepenuhnya dalam kasus ini.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_no_attr_license
default: "true"-
Jika ditetapkan ke true, nonaktifkan fungsi `attr.license`.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_no_implicit_file_export
default: "salah"-
Jika ditetapkan, file sumber (digunakan) akan bersifat pribadi paket, kecuali diekspor secara eksplisit. Lihat https://github.com/bazelbuild/proposals/blob/master/designs/2019-10-24-file- visibility.md
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_no_rule_outputs_param
default: "salah"-
Jika disetel ke benar (true), parameter `outputs` dari fungsi Starlark `rule()`.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_package_group_has_public_syntax
default: "true"-
Dalam atribut `packages` package_group, memungkinkan penulisan "public" atau "private" untuk merujuk masing-masing ke semua paket atau tidak ada paket sama sekali.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_require_linker_input_cc_api
default: "true"-
Jika ditetapkan ke true, aturan create_linking_context akan memerlukan linker_inputs, bukan libraries_to_link. Pengambil lama linking_context juga akan dinonaktifkan dan hanya linker_inputs yang akan tersedia.
Tag:build_file_semantics
,loading_and_analysis
,incompatible_change
--[no]incompatible_run_shell_command_string
default: "true"-
Jika ditetapkan ke true, parameter perintah actions.run_shell hanya akan menerima string
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_stop_exporting_build_file_path
default: "salah"-
Jika disetel ke benar (true), ctx.build_file_path yang tidak digunakan lagi tidak akan tersedia. Sebagai gantinya, Anda dapat menggunakan ctx.label.package + '/BUILD'.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_stop_exporting_language_modules
default: "salah"-
Jika diaktifkan, modul bahasa tertentu tertentu (seperti `cc_common`) tidak tersedia dalam file .bzl pengguna dan hanya dapat dipanggil dari repositori aturannya masing-masing.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_struct_has_no_methods
default: "true"-
Menonaktifkan metode to_json dan to_proto dari struct, yang mengotori namespace kolom struct. Sebagai gantinya, gunakan json.encode atau json.encode_indent untuk JSON, atau proto.encode_text untuk textproto.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_top_level_aspects_require_providers
default: "salah"-
Jika ditetapkan ke benar (true), aspek tingkat teratas akan mengikuti penyedia yang diperlukan dan hanya berjalan pada target tingkat teratas dengan penyedia aturan yang diiklankan memenuhi penyedia aspek yang diperlukan.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_unambiguous_label_stringification
default: "true"-
Jika benar, Bazel akan merangkai label @//foo:bar menjadi @//foo:bar, bukan //foo:bar. Ini hanya memengaruhi perilaku str(), operator %, dan seterusnya; perilaku repr() tidak berubah. Lihat https://github.com/bazelbuild/bazel/issues/15916 untuk informasi selengkapnya.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_use_cc_configure_from_rules_cc
default: "salah"-
Jika benar, Bazel tidak akan lagi mengizinkan penggunaan cc_configure dari @bazel_tools. Lihat https://github.com/bazelbuild/bazel/issues/10134 untuk mengetahui detail dan petunjuk migrasi.
Tag:loading_and_analysis
,incompatible_change
--max_computation_steps=<a long integer>
default: "0"-
Jumlah maksimum langkah komputasi Starlark yang dapat dijalankan oleh file BUILD (nol berarti tidak ada batas).
Tag:build_file_semantics
- Default
--nested_set_depth_limit=<an integer>
: "3500" -
Kedalaman maksimum grafik internal ke dependensi (juga dikenal sebagai NestedSet), yang jika di atasnya, konstruktor depset() akan gagal.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
--[no]heuristically_drop_nodes
default: "salah"-
Jika benar, Blaze akan menghapus node FileState dan DirectoryListingState setelah node File dan DirectoryListing terkait dilakukan untuk menghemat memori. Kami memperkirakan bahwa kecil kemungkinan node ini akan diperlukan lagi. Jika demikian, program ini akan mengevaluasi ulang mereka.
Tag:loses_incremental_state
--[no]incompatible_do_not_split_linking_cmdline
default: "true"-
Jika true (benar), Bazel tidak lagi mengubah flag command line yang digunakan untuk penautan, dan juga tidak secara selektif memutuskan flag mana yang diteruskan ke file parameter dan mana yang tidak. Lihat https://github.com/bazelbuild/bazel/issues/7670 untuk mengetahui detailnya.
Tag:loading_and_analysis
,incompatible_change
--[no]keep_state_after_build
default: "true"-
Jika salah, Blaze akan menghapus status dalam memori dari build ini saat build selesai. Build berikutnya tidak akan memiliki inkrementalitas apa pun sehubungan dengan build ini.
Tag:loses_incremental_state
--[no]track_incremental_state
default: "true"-
Jika salah, Blaze tidak akan mempertahankan data yang memungkinkan pembatalan dan evaluasi ulang pada build inkremental untuk menghemat memori di build ini. Build berikutnya tidak akan memiliki inkrementalitas apa pun sehubungan dengan build ini. Biasanya Anda ingin menentukan --batch saat menyetelnya ke false.
Tag:loses_incremental_state
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
--[no]announce_rc
default: "salah"-
Apakah akan mengumumkan opsi rc.
Tag:affects_outputs
--[no]attempt_to_print_relative_paths
default: "salah"-
Saat mencetak bagian lokasi pesan, coba gunakan jalur yang terkait dengan direktori ruang kerja atau salah satu direktori yang ditentukan oleh --package_path.
Tag:terminal_output
--bes_backend=<a string>
default: ""-
Menentukan endpoint backend layanan peristiwa build (BES) dalam format [SCHEME://]HOST[:PORT]. Setelan defaultnya adalah menonaktifkan upload BES. Skema yang didukung adalah grpc dan grpcs (grpc dengan TLS yang diaktifkan). Jika tidak ada skema yang diberikan, Bazel mengasumsikan grpcs.
Tag:affects_outputs
--[no]bes_check_preceding_lifecycle_events
default: "salah"-
Menetapkan kolom check_preceding_lifecycle_events_present pada PublishBuildToolEventStreamRequest yang memberi tahu BES untuk memeriksa apakah BES sebelumnya telah menerima peristiwa InvocationTryStarted dan BuildEnqueued yang cocok dengan peristiwa alat saat ini.
Tag:affects_outputs
--bes_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan-
Tentukan header dalam formulir NAME=VALUE yang akan disertakan dalam permintaan BES. Beberapa header dapat diteruskan dengan menentukan flag beberapa kali. Beberapa nilai untuk nama yang sama akan dikonversi menjadi daftar yang dipisahkan koma.
Tag:affects_outputs
--bes_instance_name=<a string>
default: lihat deskripsi-
Menentukan nama instance tempat BES akan mempertahankan BEP yang diupload. Nilai defaultnya adalah null.
Tag:affects_outputs
--bes_keywords=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Menentukan daftar kata kunci notifikasi yang akan ditambahkan ke kumpulan kata kunci default yang dipublikasikan ke BES ("command_name=<command_name> ", "protocol_name=BEP"). Default-nya tidak ada.
Tag:affects_outputs
--[no]bes_lifecycle_events
default: "true"-
Menentukan apakah akan memublikasikan peristiwa siklus proses BES. (ditetapkan secara default ke 'true').
Tag:affects_outputs
- Default
--bes_oom_finish_upload_timeout=<An immutable length of time.>
: "10m" -
Menentukan berapa lama bazel harus menunggu hingga upload BES/BEP selesai saat OOM. Flag ini memastikan penghentian saat JVM mengalami GC thrashing dan tidak dapat membuat progres pada thread pengguna.
Tag:bazel_monitoring
- Default
--bes_outerr_buffer_size=<an integer>
: "10240" -
Menentukan ukuran maksimal stdout atau stderr yang akan di-buffer di BEP, sebelum dilaporkan sebagai peristiwa progres. Penulisan individual masih dilaporkan dalam satu peristiwa, meskipun lebih besar dari nilai yang ditentukan hingga --bes_outerr_chunk_size.
Tag:affects_outputs
- Default
--bes_outerr_chunk_size=<an integer>
: "1048576" -
Menentukan ukuran maksimal stdout atau stderr yang akan dikirim ke BEP dalam satu pesan.
Tag:affects_outputs
--bes_proxy=<a string>
default: lihat deskripsi- Menghubungkan ke Layanan Peristiwa Build melalui proxy. Saat ini, flag ini hanya dapat digunakan untuk mengonfigurasi soket domain Unix (unix:/path/to/socket).
--bes_results_url=<a string>
default: ""-
Menentukan URL dasar tempat pengguna dapat melihat informasi yang di-streaming ke backend BES. Bazel akan menghasilkan URL yang ditambahkan oleh ID pemanggilan ke terminal.
Tag:terminal_output
--bes_system_keywords=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Menentukan daftar kata kunci notifikasi yang akan disertakan secara langsung, tanpa menyertakan awalan "user_keyword=" untuk kata kunci yang diberikan melalui --bes_keyword. Ditujukan untuk operator layanan Build yang menetapkan --bes_lifecycle_events=false dan menyertakan kata kunci saat memanggil PublishLifecycleEvent. Operator layanan build menggunakan flag ini harus mencegah pengguna mengganti nilai flag.
Tag:affects_outputs
--bes_timeout=<An immutable length of time.>
default: "0s"-
Menentukan berapa lama bazel harus menunggu hingga upload BES/BEP selesai setelah build dan pengujian selesai. Waktu tunggu yang valid adalah bilangan asli yang diikuti oleh unit: Hari (d), jam (h), menit (m), detik (s), dan milidetik (md). Nilai defaultnya adalah '0' yang berarti tidak ada waktu tunggu.
Tag:affects_outputs
--bes_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
default: "wait_for_upload_complete"-
Menentukan apakah upload Layanan Peristiwa Build harus memblokir penyelesaian build atau harus segera mengakhiri pemanggilan dan menyelesaikan upload di latar belakang. Baik 'wait_for_upload_complete' (default), 'nowait_for_upload_complete', atau 'filled_async'.
Tag:eagerness_to_exit
--build_event_binary_file=<a string>
default: ""-
Jika tidak kosong, tulis representasi biner yang dibatasi varint dari representasi protokol peristiwa build ke file tersebut. Opsi ini menyiratkan --bes_upload_mode=wait_for_upload_complete.
Tag:affects_outputs
--[no]build_event_binary_file_path_conversion
default: "true"-
Konversi jalur dalam representasi file biner dari protokol peristiwa build menjadi URI yang lebih valid secara global jika memungkinkan. Jika dinonaktifkan, skema uri file:// akan selalu digunakan
Tag:affects_outputs
--build_event_binary_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
default: "wait_for_upload_complete"-
Menentukan apakah upload Layanan Peristiwa Build untuk --build_event_binary_file harus memblokir penyelesaian build atau harus segera mengakhiri pemanggilan dan menyelesaikan upload di latar belakang. Baik 'wait_for_upload_complete' (default), 'nowait_for_upload_complete', atau 'filled_async'.
Tag:eagerness_to_exit
--build_event_json_file=<a string>
default: ""-
Jika tidak kosong, tulis serialisasi JSON dari protokol peristiwa build ke file tersebut. Opsi ini menyiratkan --bes_upload_mode=wait_for_upload_complete.
Tag:affects_outputs
--[no]build_event_json_file_path_conversion
default: "true"-
Konversi jalur dalam representasi file json dari protokol peristiwa build menjadi URI yang lebih valid secara global jika memungkinkan. Jika dinonaktifkan, skema uri file:// akan selalu digunakan
Tag:affects_outputs
--build_event_json_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
default: "wait_for_upload_complete"-
Menentukan apakah upload Layanan Peristiwa Build untuk --build_event_json_file harus memblokir penyelesaian build atau harus segera mengakhiri pemanggilan dan menyelesaikan upload di latar belakang. Baik 'wait_for_upload_complete' (default), 'nowait_for_upload_complete', atau 'filled_async'.
Tag:eagerness_to_exit
- Default
--build_event_max_named_set_of_file_entries=<an integer>
: "5000" -
Jumlah maksimum entri untuk satu peristiwa bernama_set_of_files; nilai yang lebih kecil dari 2 akan diabaikan dan pemisahan peristiwa tidak dilakukan. Ini dimaksudkan untuk membatasi ukuran peristiwa maksimum dalam protokol peristiwa build, meskipun tidak secara langsung mengontrol ukuran peristiwa. Ukuran peristiwa total adalah fungsi dari struktur set serta panjang file dan URI, yang mungkin pada akhirnya bergantung pada fungsi hash.
Tag:affects_outputs
--[no]build_event_publish_all_actions
default: "salah"-
Apakah semua tindakan harus dipublikasikan.
Tag:affects_outputs
--build_event_text_file=<a string>
default: ""-
Jika tidak kosong, tulis representasi tekstual dari protokol peristiwa build ke file tersebut
Tag:affects_outputs
--[no]build_event_text_file_path_conversion
default: "true"-
Konversi jalur dalam representasi file teks dari protokol peristiwa build menjadi URI yang lebih valid secara global jika memungkinkan. Jika dinonaktifkan, skema uri file:// akan selalu digunakan
Tag:affects_outputs
--build_event_text_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
default: "wait_for_upload_complete"-
Menentukan apakah upload Layanan Peristiwa Build untuk --build_event_text_file harus memblokir penyelesaian build atau harus segera mengakhiri pemanggilan dan menyelesaikan upload di latar belakang. Baik 'wait_for_upload_complete' (default), 'nowait_for_upload_complete', atau 'filled_async'.
Tag:eagerness_to_exit
- Default
--build_event_upload_max_retries=<an integer>
: "4" -
Frekuensi maksimum Bazel harus mencoba kembali mengupload peristiwa build.
Tag:bazel_internal_configuration
--[no]experimental_announce_profile_path
default: "salah"-
Jika diaktifkan, jalur profil JSON akan ditambahkan ke log.
Tag:bazel_monitoring
--[no]experimental_bep_target_summary
default: "salah"- Apakah akan memublikasikan peristiwa TargetSummary.
--[no]experimental_build_event_expand_filesets
default: "salah"-
Jika true (benar), luaskan Filesets di BEP saat menampilkan file output.
Tag:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
default: "salah"-
Jika true, selesaikan sepenuhnya symlink Fileset relatif di BEP saat menampilkan file output. Memerlukan --experimental_build_event_expand_filesets.
Tag:affects_outputs
- Default
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1s" -
Penundaan minimum awal untuk backoff eksponensial percobaan ulang saat upload BEP gagal. (eksponen: 1,6)
Tag:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
default: lihat deskripsi-
Memilih cara mengupload artefak yang dirujuk dalam protokol peristiwa build.
Tag:affects_outputs
--[no]experimental_collect_load_average_in_profiler
default: "true"-
Jika diaktifkan, profiler akan mengumpulkan rata-rata beban sistem secara keseluruhan.
Tag:bazel_monitoring
--[no]experimental_collect_pressure_stall_indicators
default: "salah"-
Jika diaktifkan, profiler akan mengumpulkan data PSI Linux.
Tag:bazel_monitoring
--[no]experimental_collect_resource_estimation
default: "salah"-
Jika diaktifkan, profiler akan mengumpulkan perkiraan penggunaan CPU dan memori untuk tindakan lokal.
Tag:bazel_monitoring
--[no]experimental_collect_system_network_usage
default: "salah"-
Jika diaktifkan, profiler akan mengumpulkan penggunaan jaringan sistem.
Tag:bazel_monitoring
--[no]experimental_collect_worker_data_in_profiler
default: "salah"-
Jika diaktifkan, profiler akan mengumpulkan data resource gabungan pekerja.
Tag:bazel_monitoring
--experimental_profile_additional_tasks=<phase, action, action_check, action_lock, action_release, action_update, action_complete, bzlmod, info, create_package, remote_execution, local_execution, scanner, local_parse, upload_time, remote_process_time, remote_queue, remote_setup, fetch, local_process_time, vfs_stat, vfs_dir, vfs_readlink, vfs_md5, vfs_xattr, vfs_delete, vfs_open, vfs_read, vfs_write, vfs_glob, vfs_vmfs_stat, vfs_vmfs_dir, vfs_vmfs_read, wait, thread_name, thread_sort_index, skyframe_eval, skyfunction, critical_path, critical_path_component, handle_gc_notification, action_counts, action_cache_counts, local_cpu_usage, system_cpu_usage, cpu_usage_estimation, local_memory_usage, system_memory_usage, memory_usage_estimation, system_network_up_usage, system_network_down_usage, workers_memory_usage, system_load_average, starlark_parser, starlark_user_fn, starlark_builtin_fn, starlark_user_compiled_fn, starlark_repository_fn, action_fs_staging, remote_cache_check, remote_download, remote_network, filesystem_traversal, worker_execution, worker_setup, worker_borrow, worker_working, worker_copying_outputs, credential_helper, pressure_stall_full_io, pressure_stall_full_memory, pressure_stall_some_io, pressure_stall_some_memory, pressure_stall_some_cpu, conflict_check, dynamic_lock, repository_fetch or unknown>
beberapa penggunaan diakumulasikan-
Menentukan tugas profil tambahan untuk disertakan dalam profil.
Tag:bazel_monitoring
--[no]experimental_profile_include_primary_output
default: "salah"-
Menyertakan atribut "out" tambahan dalam peristiwa tindakan yang berisi jalur eksekusi ke output utama tindakan.
Tag:bazel_monitoring
--[no]experimental_profile_include_target_label
default: "salah"-
Menyertakan label target dalam data profil JSON peristiwa tindakan.
Tag:bazel_monitoring
--[no]experimental_run_bep_event_include_residue
default: "salah"-
Apakah akan menyertakan residu command line dalam peristiwa build run yang mungkin berisi residu tersebut. Secara default, residu tidak disertakan dalam peristiwa build perintah run yang mungkin berisi residu tersebut.
Tag:affects_outputs
--[no]experimental_stream_log_file_uploads
default: "salah"-
Streaming file log yang diupload langsung ke penyimpanan jarak jauh, bukan menulisnya ke disk.
Tag:affects_outputs
--experimental_workspace_rules_log_file=<a path>
default: lihat deskripsi- Mencatat peristiwa Aturan Workspace tertentu ke dalam file ini sebagai proto WorkspaceEvent delimited.
--[no]generate_json_trace_profile
default: "otomatis"-
Jika diaktifkan, Bazel akan membuat profil build dan menulis profil format JSON ke dalam file di basis output. Lihat profil dengan memuat ke chrome://tracing. Secara default Bazel menulis profil untuk semua perintah dan kueri seperti build.
Tag:bazel_monitoring
--[no]heap_dump_on_oom
default: "salah"-
Apakah akan menghasilkan heap dump secara manual jika OOM ditampilkan (termasuk OOM manual karena mencapai --gc_thrashing_limits). Dump akan ditulis ke <output_base>/<invocation_id>.heapdump.hprof. Opsi ini secara efektif menggantikan -XX:+HeapDumpOnOutOfMemoryError, yang tidak berpengaruh untuk OOM manual.
Tag:bazel_monitoring
--[no]legacy_important_outputs
default: "true"-
Gunakan ini untuk menyembunyikan pembuatan kolom important_outputs lama di peristiwa TargetComplete. important_outputs diperlukan untuk integrasi Bazel ke ResultStore.
Tag:affects_outputs
--logging=<0 <= an integer <= 6>
default: "3"-
Level logging.
Tag:affects_outputs
--memory_profile=<a path>
default: lihat deskripsi-
Jika disetel, tulis data penggunaan memori ke file yang ditentukan di akhir fase dan heap stabil ke log master di akhir build.
Tag:bazel_monitoring
- Default
--memory_profile_stable_heap_parameters=<integers, separated by a comma expected in pairs>
: "1,0" -
Menyesuaikan komputasi heap stabil profil memori di akhir build. Harus berupa bilangan bulat dan genap yang dipisahkan oleh koma. Dalam setiap pasangan, bilangan bulat pertama adalah jumlah GC yang akan dilakukan. Bilangan bulat kedua dalam setiap pasangan adalah jumlah detik untuk menunggu antar-GC. Mis: 2,4,4,0 akan 2 GC dengan jeda 4 detik, diikuti oleh 4 GC dengan jeda nol detik
Tag:bazel_monitoring
--profile=<a path>
default: lihat deskripsi-
Jika ditetapkan, buat profil Bazel dan tulis data ke file yang ditentukan. Gunakan bazel analyze-profile untuk menganalisis profil.
Tag:bazel_monitoring
--[no]record_full_profiler_data
default: "salah"-
Secara default, profiler Bazel hanya akan merekam data gabungan untuk peristiwa yang cepat tetapi banyak (seperti membuat status file). Jika opsi ini diaktifkan, profiler akan merekam setiap peristiwa - menghasilkan data pembuatan profil yang lebih akurat, tetapi performa sangat tinggi. Opsi hanya berpengaruh jika --profile juga digunakan.
Tag:bazel_monitoring
--remote_print_execution_messages=<failure, success or all>
default: "kegagalan"-
Pilih waktu untuk mencetak pesan eksekusi jarak jauh. Nilai yang valid adalah `kegagalan`, untuk mencetak hanya jika gagal, `berhasil` untuk mencetak hanya jika berhasil, dan `all` untuk selalu mencetak.
Tag:terminal_output
--[no]slim_profile
default: "true"-
Mengurangi ukuran profil JSON dengan menggabungkan peristiwa jika profil menjadi terlalu besar.
Tag:bazel_monitoring
--starlark_cpu_profile=<a string>
default: ""-
Menulis profil pprof penggunaan CPU oleh semua thread Starlark ke dalam file yang ditentukan.
Tag:bazel_monitoring
--tool_tag=<a string>
default: ""-
Nama alat untuk mengatribusikan pemanggilan Bazel ini.
Tag:affects_outputs
,bazel_monitoring
--ui_event_filters=<Convert list of comma separated event kind to list of filters>
beberapa penggunaan diakumulasikan-
Menentukan peristiwa yang akan ditampilkan di UI. Anda dapat menambahkan atau menghapus acara ke acara default menggunakan awalan +/-, atau mengganti setelan default sepenuhnya dengan penetapan langsung. Kumpulan jenis peristiwa yang didukung mencakup INFO, DEBUG, ERROR, dan lainnya.
Tag:terminal_output
- Opsi caching dan eksekusi jarak jauh:
--experimental_circuit_breaker_strategy=<failure>
default: lihat deskripsi-
Menentukan strategi yang akan digunakan pemutus arus listrik. Strategi yang tersedia adalah "kegagalan". Pada nilai yang tidak valid untuk opsi, perilaku yang sama dengan opsi tidak ditetapkan.
Tag:execution
--[no]experimental_guard_against_concurrent_changes
default: "salah"- Nonaktifkan setelan ini untuk menonaktifkan pemeriksaan waktu atas file input suatu tindakan sebelum menguploadnya ke cache jarak jauh. Mungkin ada kasus di mana kernel Linux menunda penulisan file, yang dapat menyebabkan positif palsu (PP).
--[no]experimental_remote_cache_async
default: "salah"- Jika benar, I/O cache jarak jauh akan terjadi di latar belakang, bukan sebagai bagian dari spawn.
--experimental_remote_cache_compression_threshold=<an integer>
default: "0"- Ukuran blob minimum yang diperlukan untuk mengompresi/mendekompresi dengan zstd. Tidak efektif kecuali --remote_cache_compression disetel.
--[no]experimental_remote_cache_lease_extension
default: "salah"- Jika disetel ke benar (true), Bazel akan memperpanjang lease untuk output tindakan jarak jauh selama proses build dengan mengirimkan panggilan `FindMissingBlobs` secara berkala ke cache jarak jauh. Frekuensi ini didasarkan pada nilai `--experimental_remote_cache_ttl`.
- Default
--experimental_remote_cache_ttl=<An immutable length of time.>
: "3 jam" -
TTL minimal dari blob yang dijamin dalam cache jarak jauh setelah ringkasannya baru-baru ini dirujuk, misalnya oleh ActionResult atau FindMissingBlobs. Bazel melakukan beberapa pengoptimalan berdasarkan TTL blob, misalnya tidak berulang kali memanggil GetActionResult dalam build inkremental. Nilai harus ditetapkan sedikit lebih kecil dari TTL yang sebenarnya karena ada jeda antara saat server menampilkan ringkasan dan saat Bazel menerimanya.
Tag:execution
--experimental_remote_capture_corrupted_outputs=<a path>
default: lihat deskripsi- Jalur ke direktori tempat output yang rusak akan direkam.
--[no]experimental_remote_discard_merkle_trees
default: "true"- Jika disetel ke benar (true), hapus salinan pohon Merkle root input dan pemetaan input terkait dalam memori selama panggilan ke GetActionResult() dan Execute(). Tindakan ini akan mengurangi penggunaan memori secara signifikan, tetapi memerlukan Bazel untuk menghitung ulang jika cache jarak jauh tidak ditemukan dan dicoba ulang.
--experimental_remote_downloader=<a string>
default: lihat deskripsi- URI endpoint Remote Asset API, yang akan digunakan sebagai proxy download jarak jauh. Skema yang didukung adalah grpc, grpcs (grpc dengan TLS yang diaktifkan) dan unix (soket UNIX lokal). Jika tidak ada skema yang diberikan, Bazel akan ditetapkan secara default ke grpcs. Lihat: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
default: "salah"- Apakah akan beralih kembali ke downloader lokal jika downloader jarak jauh gagal.
--[no]experimental_remote_execution_keepalive
default: "salah"- Apakah akan menggunakan keepalive untuk panggilan eksekusi jarak jauh.
- Default
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
: "10" -
Menetapkan jumlah tingkat kegagalan yang diizinkan dalam persentase untuk jangka waktu tertentu setelah periode tersebut berhenti memanggil cache/eksekutor jarak jauh. Secara default, nilainya adalah 10. Menyetel ini ke 0 berarti tidak ada batasan.
Tag:execution
- Default
--experimental_remote_failure_window_interval=<An immutable length of time.>
: "60 dtk" -
Interval perhitungan tingkat kegagalan permintaan jarak jauh. Pada nilai nol atau negatif, durasi kegagalan dihitung seluruh durasi eksekusi.Unit berikut dapat digunakan: Hari (d), jam (h), menit (m), detik (dtk), dan milidetik (md). Jika unit dihilangkan, nilai akan ditafsirkan sebagai detik.
Tag:execution
--[no]experimental_remote_mark_tool_inputs
default: "salah"- Jika disetel ke benar (true), Bazel akan menandai input sebagai input alat untuk eksekutor jarak jauh. Ini dapat digunakan untuk mengimplementasikan pekerja persisten jarak jauh.
--[no]experimental_remote_merkle_tree_cache
default: "salah"- Jika ditetapkan ke true, penghitungan hierarki Merkle akan dicatat untuk meningkatkan kecepatan pemeriksaan cache jarak jauh. Jejak kaki memori cache dikontrol oleh --experimental_remote_merkle_tree_cache_size.
- Default
--experimental_remote_merkle_tree_cache_size=<a long integer>
: "1000" - Jumlah pohon Merkle yang akan direkam untuk meningkatkan kecepatan pemeriksaan cache jarak jauh. Meskipun cache secara otomatis dipangkas sesuai dengan penanganan soft reference Java, error kehabisan memori dapat terjadi jika disetel terlalu tinggi. Jika disetel ke 0, ukuran cache tidak terbatas. Nilai optimal bervariasi tergantung pada ukuran proyek. Default-nya adalah 1.000.
--experimental_remote_output_service=<a string>
default: lihat deskripsi- HOST atau HOST:PORT endpoint layanan output jarak jauh. Skema yang didukung adalah grpc, grpcs (grpc dengan TLS yang diaktifkan) dan unix (soket UNIX lokal). Jika tidak ada skema yang diberikan, Bazel akan ditetapkan secara default ke grpcs. Tentukan skema grpc:// atau unix: untuk menonaktifkan TLS.
--experimental_remote_output_service_output_path_prefix=<a string>
default: ""- Jalur tempat konten direktori output yang dikelola oleh --experimental_remote_output_service ditempatkan. Direktori output aktual yang digunakan oleh build akan menjadi turunan dari jalur ini dan ditentukan oleh layanan output.
--[no]experimental_remote_require_cached
default: "salah"- Jika disetel ke benar (true), terapkan bahwa semua tindakan yang dapat dijalankan dari jarak jauh akan di-cache, atau build akan gagal. Ini berguna untuk memecahkan masalah non-determinisme karena memungkinkan pemeriksaan apakah tindakan yang harus di-cache benar-benar di-cache tanpa memasukkan hasil baru ke dalam cache secara tidak benar.
--experimental_remote_scrubbing_config=<Converts to a Scrubber>
default: lihat deskripsi- Mengaktifkan penghapusan kunci cache jarak jauh dengan file konfigurasi yang disediakan, yang harus berupa buffering protokol dalam format teks (lihat src/main/protobuf/remote_scrubbing.proto). Fitur ini dimaksudkan untuk memfasilitasi berbagi cache jarak jauh/disk di antara tindakan yang dijalankan di platform yang berbeda tetapi menargetkan platform yang sama. Cara ini harus digunakan dengan sangat hati-hati, karena setelan yang tidak tepat dapat menyebabkan entri cache dibagikan secara tidak sengaja dan mengakibatkan build yang salah. Penggesekan tidak memengaruhi cara tindakan dieksekusi, hanya cara kunci cache jarak jauh/disk dihitung untuk tujuan mengambil atau menyimpan hasil tindakan. Tindakan yang digeser tidak kompatibel dengan eksekusi jarak jauh, dan akan selalu dijalankan secara lokal. Memodifikasi konfigurasi scrubbing tidak membatalkan output yang ada di sistem file lokal atau cache internal; build bersih diperlukan untuk mengeksekusi ulang tindakan yang terpengaruh. Agar berhasil menggunakan fitur ini, sebaiknya setel --host_platform khusus bersama dengan --experimental_platform_in_output_dir (untuk menormalkan awalan output) dan --incompatible_strict_action_env (untuk menormalisasi variabel lingkungan).
--[no]incompatible_remote_build_event_upload_respect_no_cache
default: "salah"- Tidak digunakan lagi. Tanpa pengoperasian. Gunakan --remote_build_event_upload=minimal sebagai gantinya.
--[no]incompatible_remote_downloader_send_all_headers
default: "true"-
Apakah akan mengirim semua nilai header multi-nilai ke downloader jarak jauh, bukan hanya yang pertama.
Tag:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
default: "salah"-
Jika disetel ke benar (true), jalur output akan relatif terhadap root input, bukan direktori yang berfungsi.
Tag:incompatible_change
--[no]incompatible_remote_results_ignore_disk
default: "true"-
Tanpa pengoperasian
Tag:incompatible_change
--[no]remote_accept_cached
default: "true"- Apakah akan menerima hasil tindakan yang di-cache dari jarak jauh.
--remote_build_event_upload=<all or minimal>
default: "minimal"- Jika ditetapkan ke 'all', semua output lokal yang dirujuk oleh BEP akan diupload ke cache jarak jauh. Jika disetel ke 'minimal', output lokal yang dirujuk oleh BEP tidak diupload ke cache jarak jauh, kecuali untuk file yang penting bagi konsumen BEP (misalnya log uji dan profil waktu). Skema bytestream:// selalu digunakan untuk uri file meskipun hilang dari cache jarak jauh. Default-nya adalah 'minimal'.
--remote_bytestream_uri_prefix=<a string>
default: lihat deskripsi- Nama host dan nama instance yang akan digunakan dalam URI bytestream:// yang ditulis ke dalam aliran peristiwa build. Opsi ini dapat disetel saat build dijalankan menggunakan proxy, yang menyebabkan nilai --remote_executor dan --remote_instance_name tidak lagi sesuai dengan nama kanonis layanan eksekusi jarak jauh. Jika tidak ditetapkan, defaultnya adalah "${nama host}/${instance_name}".
--remote_cache=<a string>
default: lihat deskripsi- URI dari endpoint caching. Skema yang didukung adalah http, https, grpc, grpcs (grpc dengan TLS yang diaktifkan) dan unix (soket UNIX lokal). Jika tidak ada skema yang diberikan, Bazel akan ditetapkan secara default ke grpcs. Tentukan skema grpc://, http://, atau unix: untuk menonaktifkan TLS. Lihat https://bazel.build/remote/caching
--[no]remote_cache_compression
default: "salah"- Jika diaktifkan, kompresi/dekompresi blob cache dengan zstd saat ukurannya setidaknya --experimental_remote_cache_compression_threshold.
--remote_cache_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan- Tentukan header yang akan disertakan dalam permintaan cache: --remote_cache_header=Name=Value. Beberapa header dapat diteruskan dengan menentukan flag beberapa kali. Beberapa nilai untuk nama yang sama akan dikonversi menjadi daftar yang dipisahkan koma.
--remote_default_exec_properties=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan-
Tetapkan properti exec default untuk digunakan sebagai platform eksekusi jarak jauh jika platform eksekusi belum menetapkan exec_properties.
Tag:affects_outputs
--remote_default_platform_properties=<a string>
default: ""- Tetapkan properti platform default agar ditetapkan untuk API eksekusi jarak jauh, jika platform eksekusi belum menetapkan remote_execution_properties. Nilai ini juga akan digunakan jika platform host dipilih sebagai platform eksekusi untuk eksekusi jarak jauh.
--remote_download_regex=<a valid Java regular expression>
beberapa penggunaan diakumulasikan-
Paksa output build jarak jauh yang jalurnya cocok dengan pola ini untuk didownload, terlepas dari --remote_download_outputs. Beberapa pola dapat ditentukan dengan mengulangi flag ini.
Tag:affects_outputs
--remote_downloader_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan- Tentukan header yang akan disertakan dalam permintaan downloader jarak jauh: --remote_downloader_header=Name=Value. Beberapa header dapat diteruskan dengan menentukan flag beberapa kali. Beberapa nilai untuk nama yang sama akan dikonversi menjadi daftar yang dipisahkan koma.
--remote_exec_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan- Tentukan header yang akan disertakan dalam permintaan eksekusi: --remote_exec_header=Name=Value. Beberapa header dapat diteruskan dengan menentukan flag beberapa kali. Beberapa nilai untuk nama yang sama akan dikonversi menjadi daftar yang dipisahkan koma.
--remote_execution_priority=<an integer>
default: "0"- Prioritas relatif tindakan yang akan dijalankan dari jarak jauh. Semantik nilai prioritas tertentu bergantung pada server.
--remote_executor=<a string>
default: lihat deskripsi- HOST atau HOST:PORT endpoint eksekusi jarak jauh. Skema yang didukung adalah grpc, grpcs (grpc dengan TLS yang diaktifkan) dan unix (soket UNIX lokal). Jika tidak ada skema yang diberikan, Bazel akan ditetapkan secara default ke grpcs. Tentukan skema grpc:// atau unix: untuk menonaktifkan TLS.
--remote_grpc_log=<a path>
default: lihat deskripsi- Jika ditentukan, jalur ke file untuk mencatat detail terkait panggilan gRPC. Log ini terdiri dari urutan protobuf com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry yang diserialisasi, dengan setiap pesan diawali oleh varint yang menunjukkan ukuran pesan protobuf serial berikut, seperti yang dilakukan oleh metode LogEntry.writeDelimitedTo(OutputStream).
--remote_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan- Tentukan header yang akan disertakan dalam permintaan: --remote_header=Name=Value. Beberapa header dapat diteruskan dengan menentukan flag beberapa kali. Beberapa nilai untuk nama yang sama akan dikonversi menjadi daftar yang dipisahkan koma.
--remote_instance_name=<a string>
default: ""- Nilai yang akan diteruskan sebagai instance_name di API eksekusi jarak jauh.
--[no]remote_local_fallback
default: "salah"- Apakah akan kembali ke strategi eksekusi lokal mandiri jika eksekusi jarak jauh gagal.
--remote_local_fallback_strategy=<a string>
default: "lokal"- Tanpa pengoperasian, tidak digunakan lagi. Lihat https://github.com/bazelbuild/bazel/issues/7480 untuk mengetahui detailnya.
- Default
--remote_max_connections=<an integer>
: "100" -
Batasi jumlah maksimum koneksi serentak ke cache/eksekutor jarak jauh. Secara default, nilainya adalah 100. Menyetel ini ke 0 berarti tidak ada batasan.
Untuk cache jarak jauh HTTP, satu koneksi TCP dapat menangani satu permintaan dalam satu waktu, sehingga Bazel dapat membuat hingga --remote_max_connections permintaan serentak.
Untuk cache/eksekutor jarak jauh gRPC, satu saluran gRPC biasanya dapat menangani 100+ permintaan serentak, sehingga Bazel dapat membuat sekitar `--remote_max_connections * 100` permintaan serentak.
Tag:host_machine_resource_optimizations
--remote_proxy=<a string>
default: lihat deskripsi- Hubungkan ke cache jarak jauh melalui proxy. Saat ini, flag ini hanya dapat digunakan untuk mengonfigurasi soket domain Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer>
default: "0"- Prioritas relatif tindakan jarak jauh yang akan disimpan dalam cache jarak jauh. Semantik nilai prioritas tertentu bergantung pada server.
- Default
--remote_retries=<an integer>
: "5" - Jumlah maksimum percobaan untuk mencoba kembali error sementara. Jika ditetapkan ke 0, percobaan ulang akan dinonaktifkan.
- Default
--remote_retry_max_delay=<An immutable length of time.>
: "5s" - Penundaan backoff maksimum di antara upaya percobaan ulang jarak jauh. Unit berikut dapat digunakan: Hari (d), jam (j), menit (m), detik (d), dan milidetik (md). Jika unit dihilangkan, nilai akan ditafsirkan sebagai detik.
- Default
--remote_timeout=<An immutable length of time.>
: "60 dtk" - Jumlah waktu maksimum untuk menunggu eksekusi jarak jauh dan panggilan cache. Untuk cache REST, ini adalah waktu tunggu koneksi dan waktu baca. Unit berikut dapat digunakan: Hari (d), jam (j), menit (m), detik (d), dan milidetik (md). Jika unit dihilangkan, nilai akan ditafsirkan sebagai detik.
--[no]remote_upload_local_results
default: "true"- Apakah akan mengupload hasil tindakan yang dijalankan secara lokal ke cache jarak jauh jika cache jarak jauh mendukungnya dan pengguna diizinkan untuk melakukannya.
--[no]remote_verify_downloads
default: "true"- Jika disetel ke benar (true), Bazel akan menghitung jumlah hash semua download jarak jauh dan menghapus nilai yang di-cache dari jarak jauh jika tidak cocok dengan nilai yang diharapkan.
- Opsi lain, yang tidak dikategorikan.:
--build_metadata=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan-
Pasangan string nilai kunci kustom yang akan disediakan dalam peristiwa build.
Tag:terminal_output
--color=<yes, no or auto>
default: "otomatis"- Gunakan kontrol terminal untuk mewarnai output.
--config=<a string>
beberapa penggunaan diakumulasikan- Memilih bagian konfigurasi tambahan dari file rc; untuk setiap <command>, Blaze juga akan mengambil opsi dari <command>:<config> jika bagian tersebut ada; jika bagian ini tidak ada dalam file .rc mana pun, Blaze akan gagal dengan error. Bagian konfigurasi dan kombinasi tanda yang setara terletak di file konfigurasi tools/*.blazerc.
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
beberapa penggunaan diakumulasikan- Mengonfigurasi helper kredensial yang sesuai dengan <a href="https://github.com/EngFlow/credential-helper-spec">Spesifikasi Bantuan Kredensial</a> yang akan digunakan untuk mengambil kredensial otorisasi untuk pengambilan repositori, cache dan eksekusi jarak jauh, serta layanan peristiwa build. Kredensial yang disediakan oleh helper lebih diutamakan daripada kredensial yang diberikan oleh `--google_default_credentials`, `--google_credentials`, file `.netrc`, atau parameter autentikasi ke `repository_ctx.download()` dan `repository_ctx.download_and_extract()`. Dapat ditentukan beberapa kali untuk menyiapkan beberapa helper. Lihat https://blog.engflow.com/2023/10/09/files-bazels-credential-helper/ untuk mendapatkan petunjuk.
- Default
--credential_helper_cache_duration=<An immutable length of time.>
: "30 mnt" - Durasi default untuk kredensial yang disediakan oleh helper kredensial akan di-cache jika helper tidak memberikannya saat masa berlaku kredensial berakhir.
- Default
--credential_helper_timeout=<An immutable length of time.>
: "10s" - Mengonfigurasi waktu tunggu untuk helper kredensial. Helper kredensial yang gagal merespons dalam waktu tunggu ini akan menggagalkan pemanggilan.
--curses=<yes, no or auto>
default: "otomatis"- Gunakan kontrol kursor terminal untuk meminimalkan output scroll.
--disk_cache=<a path>
default: lihat deskripsi- Jalur ke direktori tempat Bazel dapat membaca dan menulis tindakan dan output tindakan. Jika tidak ada, direktori akan dibuat.
--[no]enable_platform_specific_config
default: "salah"- Jika true (benar), Bazel akan mengambil baris konfigurasi khusus host OS dari file bazelrc. Misalnya, jika OS host adalah Linux dan Anda menjalankan bazel build, Bazel akan mengambil baris yang dimulai dengan build:linux. ID OS yang didukung adalah linux, macos, windows, freebsd, dan openbsd. Mengaktifkan tanda ini sama dengan menggunakan --config=linux di Linux, --config=windows di Windows, dll.
--[no]experimental_rule_extension_api
default: "salah"-
Aktifkan API ekstensi aturan eksperimental dan API subaturan
Tag:loading_and_analysis
,experimental
--[no]experimental_windows_watchfs
default: "salah"- Jika benar, dukungan Windows eksperimental untuk --watchfs akan diaktifkan. Jika tidak --watchfsis adalah non-op di Windows. Pastikan untuk mengaktifkan --watchfs juga.
--google_auth_scopes=<comma-separated list of options>
default: "https://www.googleapis.com/auth/cloud-platform"- Daftar cakupan autentikasi Google Cloud yang dipisahkan koma.
--google_credentials=<a string>
default: lihat deskripsi- Menentukan file yang akan diperoleh kredensial autentikasi. Lihat https://cloud.google.com/docs/authentication untuk mengetahui detailnya.
--[no]google_default_credentials
default: "salah"- Apakah akan menggunakan 'Kredensial Default Aplikasi Google' untuk autentikasi. Lihat https://cloud.google.com/docs/authentication untuk mengetahui detailnya. Dinonaktifkan secara default.
--grpc_keepalive_time=<An immutable length of time.>
default: lihat deskripsi- Mengonfigurasi ping keep-alive untuk koneksi gRPC keluar. Jika hal ini disetel, Bazel akan mengirim ping setelah sekian waktu tanpa operasi baca pada koneksi, tetapi hanya jika ada setidaknya satu panggilan gRPC yang tertunda. Waktu diperlakukan sebagai perincian kedua; jika menetapkan nilai kurang dari satu detik, akan menjadi error. Secara default, ping keep-alive dinonaktifkan. Anda harus berkoordinasi dengan pemilik layanan sebelum mengaktifkan setelan ini. Misalnya, untuk menetapkan nilai 30 detik ke tanda ini, nilai tersebut harus dilakukan karena --grpc_keepalive_time=30s
- Default
--grpc_keepalive_timeout=<An immutable length of time.>
: "20 dtk" - Mengonfigurasi waktu tunggu keep-alive untuk koneksi gRPC keluar. Jika ping keep-alive diaktifkan dengan --grpc_keepalive_time, maka Bazel akan kehabisan koneksi jika tidak menerima balasan ping setelah sekian waktu. Waktu diperlakukan sebagai perincian kedua; jika menetapkan nilai kurang dari satu detik, akan menjadi error. Jika ping keep-alive dinonaktifkan, setelan ini akan diabaikan.
--[no]incompatible_disable_non_executable_java_binary
default: "salah"-
Jika true, java_binary selalu dapat dieksekusi. Atribut create_executable akan dihapus.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_symlink_file_to_dir
default: "true"-
Tanpa pengoperasian.
Tag:loading_and_analysis
,incompatible_change
--[no]progress_in_terminal_title
default: "salah"- Tampilkan progres perintah di judul terminal. Berguna untuk melihat apa yang dilakukan bazel saat memiliki beberapa tab terminal.
--[no]show_progress
default: "true"- Menampilkan pesan progres selama proses build.
--show_progress_rate_limit=<a double>
default: "0,2"- Jumlah minimum detik antarpesan progres dalam output.
--[no]show_timestamps
default: "salah"- Menyertakan stempel waktu dalam pesan
--tls_certificate=<a string>
default: lihat deskripsi- Tentukan jalur ke sertifikat TLS yang dipercaya untuk menandatangani sertifikat server.
--tls_client_certificate=<a string>
default: lihat deskripsi- Tentukan sertifikat klien TLS yang akan digunakan; Anda juga harus memberikan kunci klien untuk mengaktifkan autentikasi klien.
--tls_client_key=<a string>
default: lihat deskripsi- Tentukan kunci klien TLS yang akan digunakan; Anda juga harus memberikan sertifikat klien untuk mengaktifkan autentikasi klien.
- Default
--ui_actions_shown=<an integer>
: "8" -
Jumlah tindakan serentak yang ditampilkan di status progres mendetail; setiap tindakan ditampilkan di baris terpisah. Status progres selalu menampilkan minimal satu, semua angka yang kurang dari 1 dipetakan ke 1.
Tag:terminal_output
--[no]watchfs
default: "salah"- Di Linux/macOS: Jika true (benar), bazel akan mencoba menggunakan layanan file watch sistem operasi untuk menemukan perubahan lokal, bukan memindai setiap file untuk menemukan perubahan. Pada Windows: tanda ini sekarang adalah non-op namun dapat diaktifkan bersama dengan --experimental_windows_watchfs. Di OS apa pun: Perilaku tidak terdefinisi jika ruang kerja Anda berada di sistem file jaringan, dan file diedit di komputer jarak jauh.
Opsi Analisis profil
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
default: "salah"-
Jika ditetapkan, cache repositori akan menerapkan hardlink pada file jika cache ditemukan, bukan menyalinnya. Hal ini dimaksudkan untuk menghemat kapasitas {i>disk<i}.
Tag:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
default: "0"-
Jumlah upaya maksimum untuk mencoba kembali error download. Jika ditetapkan ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark berdasarkan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi pada komputer yang lebih lambat dari yang diharapkan oleh pembuat aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_connector_attempts=<an integer>
: "8" -
Jumlah upaya maksimum untuk download http.
Tag:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
default: "0s"-
Waktu tunggu maksimum untuk percobaan ulang download http. Dengan nilai 0, tidak ada waktu tunggu maksimum yang ditentukan.
Tag:bazel_internal_configuration
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Skalakan semua waktu tunggu yang terkait dengan download http berdasarkan faktor yang diberikan
Tag:bazel_internal_configuration
--repository_cache=<a path>
default: lihat deskripsi-
Menentukan lokasi cache dari nilai yang didownload yang diperoleh selama pengambilan repositori eksternal. String kosong sebagai argumen meminta cache dinonaktifkan. Jika tidak, default '<output_user_root>/cache/repos/v1' akan digunakan
Tag:bazel_internal_configuration
--[no]repository_disable_download
default: "salah"-
Jika ditetapkan, mendownload menggunakan ctx.download{,_and_extract} tidak akan diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file arbitrer yang dapat dieksekusi yang mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang yang ditempati (0-100) dan di atas batas tersebut, GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika ditetapkan ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_depset_for_java_output_source_jars
default: "true"-
Tanpa pengoperasian.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]separate_aspect_deps
default: "true"-
Tanpa pengoperasian
Tag:no_op
- Opsi yang berkaitan dengan semantik dan output Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan yanked di registry tempatnya berasal (jika bukan berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yanked yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Periksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan jika ketidakcocokan terdeteksi.
Tag:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
default: "peringatan"-
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan dalam modul root adalah versi yang sama dengan yang Anda dapatkan dalam grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasikannya ke kegagalan resolusi.
Tag:loading_and_analysis
--[no]ignore_dev_dependency
default: "salah"-
Jika true (benar), Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan dalam MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "update"-
Menentukan bagaimana dan apakah menggunakan lockfile atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `error` untuk menggunakan lockfile tetapi menampilkan error jika file tidak diperbarui, atau `off` tidak membaca atau menulis ke lockfile.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <module name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan merupakan jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
--vendor_dir=<a path>
default: lihat deskripsi-
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat membangun. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "1 dtk:2,20 dtk:3,1 m:5" -
Batas yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlah berupa bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap generasi lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan dengan koma.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi ketika peristiwa GC penuh terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC kecil terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi saat peristiwa GC kecil terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan setidaknya berada pada ambang batas ini, status Skyframe sementara yang tidak perlu akan hilang. Menyesuaikan hal ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari GC thrashing, jika GC thrashing (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada menyusun ulang status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
--dump=<text or raw>
[-d
] default: lihat deskripsi-
menghasilkan dump data profil lengkap yang dapat dibaca manusia atau format 'raw' yang mudah dibaca manusia.
Tag:bazel_monitoring
--experimental_command_profile=<cpu, wall, alloc or lock>
default: lihat deskripsi- Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alokasi, atau kunci) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa di bawah direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; penggunaan dengan risiko Anda sendiri.
--[no]experimental_record_metrics_for_all_mnemonics
default: "salah"- Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika ada file yang telah diselesaikan yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi caching dan eksekusi jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file yang akan digunakan untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk cocok, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik mulai dari `$1`. Beberapa perintah `tulis ulang` untuk URL yang sama dapat diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
default: "otomatis"- Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dimulai ulang. Jika tidak, gunakan thread platform (yaitu thread OS) jika ditetapkan ke 'platform' atau thread virtual jika ditetapkan ke 'virtual'. Jika disetel ke 'auto', thread virtual akan digunakan jika tersedia (yaitu, berjalan di JDK 21+), jika tidak, thread pekerja tidak akan digunakan.
- Opsi lain, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <repositori name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
Opsi Kueri
Mewarisi semua opsi dari build.
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
default: "salah"-
Jika ditetapkan, cache repositori akan menerapkan hardlink pada file jika cache ditemukan, bukan menyalinnya. Hal ini dimaksudkan untuk menghemat kapasitas {i>disk<i}.
Tag:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
default: "0"-
Jumlah upaya maksimum untuk mencoba kembali error download. Jika ditetapkan ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark berdasarkan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi pada komputer yang lebih lambat dari yang diharapkan oleh pembuat aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_connector_attempts=<an integer>
: "8" -
Jumlah upaya maksimum untuk download http.
Tag:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
default: "0s"-
Waktu tunggu maksimum untuk percobaan ulang download http. Dengan nilai 0, tidak ada waktu tunggu maksimum yang ditentukan.
Tag:bazel_internal_configuration
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Skalakan semua waktu tunggu yang terkait dengan download http berdasarkan faktor yang diberikan
Tag:bazel_internal_configuration
--repository_cache=<a path>
default: lihat deskripsi-
Menentukan lokasi cache dari nilai yang didownload yang diperoleh selama pengambilan repositori eksternal. String kosong sebagai argumen meminta cache dinonaktifkan. Jika tidak, default '<output_user_root>/cache/repos/v1' akan digunakan
Tag:bazel_internal_configuration
--[no]repository_disable_download
default: "salah"-
Jika ditetapkan, mendownload menggunakan ctx.download{,_and_extract} tidak akan diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file arbitrer yang dapat dieksekusi yang mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang yang ditempati (0-100) dan di atas batas tersebut, GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika ditetapkan ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_depset_for_java_output_source_jars
default: "true"-
Tanpa pengoperasian.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]separate_aspect_deps
default: "true"-
Tanpa pengoperasian
Tag:no_op
- Opsi yang berkaitan dengan output kueri dan semantik:
--aspect_deps=<off, conservative or precise>
default: "konservatif"-
Cara me-resolve dependensi aspek jika format output adalah salah satu dari {xml,proto,record}. 'off' berarti tidak ada dependensi aspek yang diselesaikan, 'konservatif' (default) berarti semua dependensi aspek yang dideklarasikan akan ditambahkan terlepas dari apakah dependensi tersebut diberi class aturan dependensi langsung atau tidak, 'precise' berarti hanya aspek yang ditambahkan yang mungkin aktif berdasarkan class aturan dependensi langsung. Perhatikan bahwa mode presisi mengharuskan pemuatan paket lain untuk mengevaluasi satu target sehingga membuatnya lebih lambat daripada mode lainnya. Perhatikan juga bahwa mode yang tepat pun tidak sepenuhnya tepat: keputusan apakah akan menghitung suatu aspek ditentukan dalam fase analisis, yang tidak dijalankan selama 'kueri bazel'.
Tag:build_file_semantics
--[no]consistent_labels
default: "salah"-
Jika diaktifkan, setiap perintah kueri akan memunculkan label seolah-olah oleh fungsi <code>str</code> Starlark yang diterapkan ke instance <code>Label</code>. Hal ini berguna untuk alat yang perlu mencocokkan {i>output<i} dari berbagai perintah kueri dan/atau label yang dihasilkan oleh aturan. Jika tidak diaktifkan, pemformat output bebas memunculkan nama repositori yang jelas (relatif terhadap repositori utama) agar output lebih mudah dibaca.
Tag:terminal_output
--[no]experimental_explicit_aspects
default: "salah"-
kueri, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: tanpa pengoperasian (aspek selalu diikuti).
Tag:terminal_output
--[no]graph:factored
default: "true"-
Jika benar, grafik akan dimunculkan 'difaktorkan', yaitu node yang setara secara topologis akan digabungkan bersama dan labelnya akan digabungkan. Opsi ini hanya berlaku untuk --output=graph.
Tag:terminal_output
- Default
--graph:node_limit=<an integer>
: "512" -
Panjang maksimum string label untuk node grafik dalam output. Label yang lebih panjang akan dipotong; -1 berarti tidak ada pemotongan. Opsi ini hanya berlaku untuk --output=graph.
Tag:terminal_output
--[no]implicit_deps
default: "true"-
Jika diaktifkan, dependensi implisit akan disertakan dalam grafik dependensi tempat kueri dioperasikan. Dependensi implisit adalah dependensi yang tidak disebutkan secara eksplisit dalam file BUILD tetapi ditambahkan oleh bazel. Untuk cquery, opsi ini mengontrol pemfilteran toolchain yang di-resolve.
Tag:build_file_semantics
--[no]include_artifacts
default: "true"-
Mencakup nama input dan output tindakan dalam output (berpotensi besar).
Tag:terminal_output
--[no]include_aspects
default: "true"-
kueri, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: tanpa pengoperasian (aspek selalu diikuti).
Tag:terminal_output
--[no]include_commandline
default: "true"-
Mencakup konten command line tindakan dalam output (berpotensi besar).
Tag:terminal_output
--[no]include_file_write_contents
default: "salah"-
Menyertakan konten file untuk tindakan FileWrite, SourceSymlinkManifest, dan RepoMappingManifest (berpotensi besar).
Tag:terminal_output
--[no]include_param_files
default: "salah"-
Sertakan konten file parameter yang digunakan dalam perintah (berpotensi besar). Catatan: Mengaktifkan tanda ini akan otomatis mengaktifkan tanda --include_commandline.
Tag:terminal_output
--[no]include_scheduling_dependencies
default: "salah"-
Mencakup nama dependensi penjadwalan tindakan (berpotensi besar). Hanya berlaku jika --include_artifacts juga ditetapkan.
Tag:terminal_output
--[no]incompatible_package_group_includes_double_slash
default: "true"-
Jika diaktifkan, saat menghasilkan output atribut `packages` package_group, `//` awal tidak akan dihilangkan.
Tag:terminal_output
,incompatible_change
--[no]infer_universe_scope
default: "salah"-
Jika ditetapkan dan --universe_scope tidak ditetapkan, nilai --universe_scope akan disimpulkan sebagai daftar pola target unik dalam ekspresi kueri. Perhatikan bahwa nilai --universe_scope yang disimpulkan untuk ekspresi kueri yang menggunakan fungsi cakupan alam semesta (misalnya `allrdeps`) mungkin bukan yang Anda inginkan, jadi sebaiknya gunakan opsi ini hanya jika Anda tahu apa yang Anda lakukan. Lihat https://bazel.build/reference/query#sky-query untuk mengetahui detail dan contohnya. Jika --universe_scope ditetapkan, nilai opsi ini akan diabaikan. Catatan: opsi ini hanya berlaku untuk `query` (bukan `cquery`).
Tag:loading_and_analysis
--[no]line_terminator_null
default: "salah"-
Apakah setiap format dihentikan dengan \0, bukan baris baru.
Tag:terminal_output
--[no]nodep_deps
default: "true"-
Jika diaktifkan, dependensi dari atribut "nodep" akan disertakan dalam grafik dependensi yang digunakan untuk mengoperasikan kueri. Contoh umum atribut "nodep" adalah "visibilitas". Jalankan dan uraikan output `info build-language` untuk mempelajari semua atribut "nodep" dalam bahasa build.
Tag:build_file_semantics
--output=<a string>
default: "text"-
Format yang akan menampilkan hasil kueri. Nilai yang diizinkan untuk aquery adalah: text, textproto, proto, streaming_proto, jsonproto.
Tag:terminal_output
--[no]proto:default_values
default: "true"-
Jika true (benar), atribut yang nilainya tidak ditentukan secara eksplisit dalam file BUILD akan disertakan; jika tidak, atribut tersebut akan dihilangkan. Opsi ini berlaku untuk --output=proto
Tag:terminal_output
--[no]proto:definition_stack
default: "salah"-
Isi kolom proto definisi_stack, yang mencatat setiap instance aturan stack panggilan Starlark pada saat class aturan ditentukan.
Tag:terminal_output
--[no]proto:flatten_selects
default: "true"-
Jika diaktifkan, atribut yang dapat dikonfigurasi yang dibuat oleh select() akan diratakan. Untuk jenis daftar, representasi yang disatukan adalah daftar yang berisi setiap nilai peta yang dipilih dengan tepat satu kali. Jenis skalar diratakan menjadi null.
Tag:build_file_semantics
--[no]proto:include_attribute_source_aspects
default: "salah"-
Isi kolom proto source_aspect_name dari setiap Atribut dengan aspek sumber tempat atribut tersebut berasal (string kosong jika bukan).
Tag:terminal_output
--[no]proto:include_synthetic_attribute_hash
default: "salah"-
Apakah akan menghitung dan mengisi atribut $internal_attr_hash atau tidak.
Tag:terminal_output
--[no]proto:instantiation_stack
default: "salah"-
Isi stack panggilan pembuatan instance dari setiap aturan. Perhatikan bahwa stack harus ada
Tag:terminal_output
--[no]proto:locations
default: "true"-
Apakah akan menghasilkan informasi lokasi dalam output proto atau tidak.
Tag:terminal_output
- Default
--proto:output_rule_attrs=<comma-separated list of options>
: "all" -
Daftar atribut yang dipisahkan koma untuk disertakan dalam output. Setelan defaultnya adalah semua atribut. Setel ke string kosong agar tidak menghasilkan output atribut apa pun. Opsi ini berlaku untuk --output=proto.
Tag:terminal_output
--[no]proto:rule_inputs_and_outputs
default: "true"-
Apakah kolom rule_input dan rule_output mengisi atau tidak.
Tag:terminal_output
--query_file=<a string>
default: ""-
Jika ditetapkan, kueri akan membaca kueri dari file yang disebutkan di sini, bukan dari command line. Menentukan file di sini serta kueri command line merupakan suatu error.
Tag:changes_inputs
--[no]relative_locations
default: "salah"-
Jika true (benar), lokasi file BUILD dalam output xml dan proto akan bersifat relatif. Secara default, output lokasi adalah jalur absolut dan tidak akan konsisten di seluruh mesin. Anda dapat menyetel opsi ini ke benar (true) agar mendapatkan hasil yang konsisten di seluruh mesin.
Tag:terminal_output
--[no]skyframe_state
default: "salah"-
Tanpa melakukan analisis tambahan, hapus Grafik Tindakan saat ini dari Skyframe. Catatan: Menentukan target dengan --skyframe_state saat ini tidak didukung. Tanda ini hanya tersedia dengan --output=proto atau --output=textproto.
Tag:terminal_output
--[no]tool_deps
default: "true"-
Kueri: Jika dinonaktifkan, dependensi pada 'exec configuration' tidak akan disertakan dalam grafik dependensi tempat kueri dioperasikan. Edge dependensi 'exec configuration', seperti yang berasal dari aturan 'proto_library' apa pun ke Protocol Compiler, biasanya mengarah ke alat yang dieksekusi selama build, bukan bagian dari program 'target' yang sama.
Cquery: Jika dinonaktifkan, memfilter semua target yang dikonfigurasi yang melewati transisi eksekusi dari target tingkat teratas yang menemukan target yang dikonfigurasi ini. Artinya, jika target tingkat atas ada dalam konfigurasi target, hanya target yang dikonfigurasi dan dalam konfigurasi target yang akan ditampilkan. Jika target tingkat teratas berada dalam konfigurasi eksekusi, hanya target yang dikonfigurasi dengan eksekusi yang akan ditampilkan. Opsi ini TIDAK akan mengecualikan toolchain yang telah diselesaikan.
Tag:build_file_semantics
--universe_scope=<comma-separated list of options>
default: ""-
Kumpulan pola target yang dipisahkan koma (aditif dan pengurangan). Kueri dapat dilakukan di alam semesta yang ditentukan oleh penutupan transitif target yang ditentukan. Opsi ini digunakan untuk perintah kueri dan kueri.
Untuk cquery, input untuk opsi ini adalah target dari semua jawaban yang dibuat sehingga opsi ini dapat memengaruhi konfigurasi dan transisi. Jika opsi ini tidak ditentukan, target tingkat teratas dianggap sebagai target yang diuraikan dari ekspresi kueri. Catatan: Untuk cquery, tidak menentukan opsi ini dapat menyebabkan build rusak jika target yang diurai dari ekspresi kueri tidak dapat dibuat dengan opsi tingkat atas.
Tag:loading_and_analysis
- Opsi yang terkait dengan semantik dan output Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan yanked di registry tempatnya berasal (jika bukan berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yanked yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Periksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan jika ketidakcocokan terdeteksi.
Tag:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
default: "peringatan"-
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan dalam modul root adalah versi yang sama dengan yang Anda dapatkan dalam grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasikannya ke kegagalan resolusi.
Tag:loading_and_analysis
--[no]ignore_dev_dependency
default: "salah"-
Jika true (benar), Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan dalam MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "update"-
Menentukan bagaimana dan apakah menggunakan lockfile atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `error` untuk menggunakan lockfile tetapi menampilkan error jika file tidak diperbarui, atau `off` tidak membaca atau menulis ke lockfile.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <module name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan merupakan jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
--vendor_dir=<a path>
default: lihat deskripsi-
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat membangun. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "1 dtk:2,20 dtk:3,1 m:5" -
Batas yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlah berupa bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap generasi lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan dengan koma.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi ketika peristiwa GC penuh terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC kecil terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi saat peristiwa GC kecil terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan setidaknya berada pada ambang batas ini, status Skyframe sementara yang tidak perlu akan hilang. Menyesuaikan hal ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari GC thrashing, jika GC thrashing (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada menyusun ulang status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
--experimental_command_profile=<cpu, wall, alloc or lock>
default: lihat deskripsi- Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alokasi, atau kunci) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa di bawah direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; penggunaan dengan risiko Anda sendiri.
--[no]experimental_record_metrics_for_all_mnemonics
default: "salah"- Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika ada file yang telah diselesaikan yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi caching dan eksekusi jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file yang akan digunakan untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk cocok, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik mulai dari `$1`. Beberapa perintah `tulis ulang` untuk URL yang sama dapat diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
default: "otomatis"- Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dimulai ulang. Jika tidak, gunakan thread platform (yaitu thread OS) jika ditetapkan ke 'platform' atau thread virtual jika ditetapkan ke 'virtual'. Jika disetel ke 'auto', thread virtual akan digunakan jika tersedia (yaitu, berjalan di JDK 21+), jika tidak, thread pekerja tidak akan digunakan.
- Opsi lain, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <repositori name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut akan relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
- Opsi yang mengontrol eksekusi build:
--[no]experimental_inprocess_symlink_creation
default: "salah"-
Apakah akan melakukan panggilan sistem file langsung untuk membuat hierarki symlink
Tag:loading_and_analysis
,execution
,experimental
--[no]experimental_persistent_aar_extractor
default: "salah"-
Aktifkan ekstraktor aar persisten menggunakan pekerja.
Tag:execution
--[no]experimental_remotable_source_manifests
default: "salah"-
Apakah akan membuat tindakan manifes sumber dapat dipindahkan
Tag:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
default: "salah"-
Jika true, Bazel akan menjalankan cakupan pascapemrosesan untuk pengujian di spawn baru.
Tag:execution
--[no]experimental_strict_fileset_output
default: "salah"-
Jika opsi ini diaktifkan, kumpulan file akan memperlakukan semua artefak output sebagai file biasa. {i>Mockup <i}tidak akan melintasi direktori atau sensitif terhadap symlink.
Tag:execution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
default: ""-
Tambahkan atau hapus kunci dari info eksekusi tindakan berdasarkan mnemonik tindakan. Hanya berlaku untuk tindakan yang mendukung info eksekusi. Banyak tindakan umum yang mendukung info eksekusi, misalnya Genrule, CppCompile, Javac, StarlarkAction, TestRunner. Saat menentukan beberapa nilai, urutan penting karena banyak regex dapat berlaku untuk mnemonik yang sama.
Sintaks: "regex=[+-]key,regex=[+-]key,...".
Contoh:
'.*=+x,.*=-y,.*=+z' menambahkan 'x' dan 'z' ke, serta menghapus 'y' dari, info eksekusi untuk semua tindakan.
'Genrule=+require-x' menambahkan 'require-x' ke info eksekusi untuk semua tindakan Genrule.
'(?!Genrule).*=-require-x' menghapus 'require-x' dari info eksekusi untuk semua tindakan non-Genrule.
Tag:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Aktifkan tindakan dex dan desugar Android persisten menggunakan pekerja.
Diluaskan ke:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Tag:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Aktifkan pemroses resource Android persisten menggunakan pekerja.
Diluaskan ke:
--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
}--internal_persistent_busybox_tools
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_desugar
-
Aktifkan tindakan dex dan desugar Android multipleks yang persisten menggunakan pekerja.
Diluaskan ke:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Tag:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Aktifkan pemroses resource Android multipleks persisten menggunakan pekerja.
Diluaskan ke:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
}--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
-
Aktifkan alat Android persisten dan multipleks (dexing, desugaring, pemrosesan resource).
Diluaskan ke:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Tag:host_machine_resource_optimizations
,execution
--[no]use_target_platform_for_tests
default: "salah"-
Jika true (benar), Bazel akan menggunakan platform target untuk menjalankan pengujian, bukan grup eksekusi pengujian.
Tag:execution
- Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
--android_compiler=<a string>
default: lihat deskripsi-
Compiler target Android.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
default: "//external:android/crosstool"-
Lokasi compiler C++ yang digunakan untuk build Android.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
default: lihat deskripsi-
Target Android grte_top.
Tag:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
default: "android"-
Memilih penggabungan manifes yang akan digunakan untuk aturan android_binary. Tanda untuk membantu transisi ke penggabungan manifes Android dari penggabungan lama.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
default: ""-
Menetapkan platform yang digunakan target android_binary. Jika beberapa platform ditentukan, biner adalah APK gemuk, yang berisi biner native untuk setiap platform target yang ditentukan.
Tag:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
default: "@bazel_tools//tools/android:sdk"-
Menentukan platform/Android SDK yang digunakan untuk mem-build aplikasi Android.
Tag:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
default: "@bazel_tools//tools/cpp:toolchain"-
Label paket crosstool yang akan digunakan dalam aturan Apple dan Objc serta dependensinya.
Tag:loses_incremental_state
,changes_inputs
--cc_output_directory_tag=<a string>
default: ""-
Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.
Tag:affects_outputs
--compiler=<a string>
default: lihat deskripsi-
Compiler C++ yang akan digunakan untuk mengompilasi target.
Tag:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
default: "@bazel_tools//tools/test:lcov_merger"-
Lokasi biner yang digunakan untuk pascapemrosesan laporan cakupan mentah. Saat ini, file harus berupa grup file yang berisi satu file, yaitu biner. Default-nya adalah '//tools/test:lcov_merger'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
default: "@bazel_tools//tools/test:coverage_report_generator"-
Lokasi biner yang digunakan untuk membuat laporan cakupan. Saat ini, file harus berupa grup file yang berisi satu file, yaitu biner. Default-nya adalah '//tools/test:coverage_report_generator'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
default: "@bazel_tools//tools/test:coverage_support"-
Lokasi file dukungan yang diperlukan pada input setiap tindakan pengujian yang mengumpulkan cakupan kode. Default-nya adalah '//tools/test:coverage_support'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--custom_malloc=<a build target label>
default: lihat deskripsi-
Menentukan implementasi maloc kustom. Setelan ini mengganti atribut maloc dalam aturan build.
Tag:changes_inputs
,affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
beberapa penggunaan diakumulasikan-
Daftar ekspresi reguler yang dipisahkan koma, masing-masing jika perlu diawali dengan - (ekspresi negatif), ditetapkan (=) ke daftar target nilai batasan yang dipisahkan koma. Jika target tidak cocok dengan ekspresi negatif dan setidaknya satu ekspresi positif, resolusi toolchain-nya akan dijalankan seolah-olah telah mendeklarasikan nilai batasan sebagai batasan eksekusi. Contoh: //demo,-test=@platforms//cpus:x86_64 akan menambahkan 'x86_64' ke target mana pun di bawah //demo kecuali untuk yang namanya berisi 'test'.
Tag:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
default: "salah"-
Jika ditetapkan, tambahkan persyaratan eksekusi "require-xcode:{version}" ke setiap tindakan Xcode. Jika versi xcode memiliki label dengan tanda hubung, tambahkan juga persyaratan eksekusi "require-xcode-label:{version_label}".
Tag:loses_incremental_state
,loading_and_analysis
,execution
--[no]experimental_prefer_mutual_xcode
default: "true"-
Jika benar, gunakan Xcode terbaru yang tersedia secara lokal dan jarak jauh. Jika salah (false), atau jika tidak ada versi bersama yang tersedia, gunakan versi Xcode lokal yang dipilih melalui xcode-select.
Tag:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
default: ""-
Platform yang tersedia sebagai platform eksekusi untuk menjalankan tindakan. Platform dapat ditentukan berdasarkan target yang tepat, atau sebagai pola target. Platform ini akan dipertimbangkan sebelum yang dideklarasikan dalam file WORKSPACE oleh register_execution_platforms(). Opsi ini hanya dapat disetel satu kali; instance berikutnya akan mengganti setelan tanda sebelumnya.
Tag:execution
--extra_toolchains=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Aturan toolchain yang akan dipertimbangkan selama resolusi toolchain. Toolchain dapat ditentukan berdasarkan target yang tepat, atau sebagai pola target. Toolchain ini akan dipertimbangkan sebelum yang dideklarasikan dalam file WORKSPACE oleh register_toolchains().
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
default: lihat deskripsi-
Label ke library libc yang digunakan untuk check in. Nilai default dipilih oleh toolchain crosstool, dan Anda hampir tidak perlu menggantinya.
Tag:action_command_lines
,affects_outputs
--host_compiler=<a string>
default: lihat deskripsi-
Flag tanpa pengoperasian. Akan dihapus dalam rilis mendatang.
Tag:loading_and_analysis
,execution
--host_grte_top=<a label>
default: lihat deskripsi-
Jika ditentukan, setelan ini akan menggantikan direktori tingkat teratas libc (--grte_top) untuk konfigurasi eksekusi.
Tag:action_command_lines
,affects_outputs
--host_platform=<a build target label>
default: "@local_config_platform//:host"-
Label aturan platform yang menjelaskan sistem host.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
default: "true"-
Jika true (benar), Bazel tidak akan mengaktifkan fitur 'host' dan 'nonhost' di toolchain c++ (lihat https://github.com/bazelbuild/bazel/issues/7407 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
default: "true"-
Gunakan resolusi toolchain untuk memilih aturan Android SDK untuk Android (Starlark dan native)
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
default: "salah"-
Gunakan resolusi toolchain guna memilih Apple SDK untuk aturan Apple (Starlark dan native)
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
default: "true"-
Flag ini bersifat noop dan dijadwalkan untuk dihapus.
Tag:no_op
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
default: "true"-
Jika true (benar), Bazel tidak akan menautkan dependensi library ke seluruh arsip secara default (lihat https://github.com/bazelbuild/bazel/issues/7362 untuk mengetahui petunjuk migrasi).
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
default: "true"-
Flag ini bersifat noop dan dijadwalkan untuk dihapus.
Tag:no_op
,incompatible_change
--[no]incompatible_strip_executable_safely
default: "salah"-
Jika true, tindakan penghapusan untuk file yang dapat dieksekusi akan menggunakan flag -x, yang tidak melanggar resolusi simbol dinamis.
Tag:action_command_lines
,incompatible_change
-
Gunakan objek bersama antarmuka jika didukung oleh toolchain. Semua toolchain ELF saat ini mendukung setelan ini.
Tag:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Menentukan versi iOS SDK yang akan digunakan untuk membuat aplikasi iOS. Jika tidak ditentukan, versi SDK iOS default dari 'xcode_version' akan digunakan.
Tag:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Menentukan versi macOS SDK yang akan digunakan untuk mem-build aplikasi macOS. Jika tidak ditentukan, versi SDK macOS default dari 'xcode_version' akan digunakan.
Tag:loses_incremental_state
--minimum_os_version=<a string>
default: lihat deskripsi-
Versi OS minimum yang ditargetkan kompilasi Anda.
Tag:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
default: ""-
Lokasi file pemetaan yang menjelaskan platform yang akan digunakan jika tidak ada yang ditetapkan atau tanda yang akan ditetapkan ketika platform sudah ada. Harus terkait dengan root ruang kerja utama. Nilai defaultnya adalah 'platform_mappings' (file langsung di bawah root ruang kerja).
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
,immutable
--platforms=<a build target label>
default: ""-
Label aturan platform yang menjelaskan platform target untuk perintah saat ini.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
default: lihat deskripsi-
Tidak digunakan lagi, tanpa pengoperasian. Dinonaktifkan oleh `--incompatible_use_python_ toolchains`.
Tag:no_op
,deprecated
--python3_path=<a string>
default: lihat deskripsi-
Tidak digunakan lagi, tanpa pengoperasian. Dinonaktifkan oleh `--incompatible_use_python_ toolchains`.
Tag:no_op
,deprecated
--python_path=<a string>
default: lihat deskripsi-
Jalur absolut penafsir Python yang dipanggil untuk menjalankan target Python di platform target. Tidak digunakan lagi; dinonaktifkan oleh --incompatible_use_python_ toolchains.
Tag:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
default: lihat deskripsi-
Label py_runtime yang mewakili penafsir Python yang dipanggil untuk menjalankan target Python di platform target. Tidak digunakan lagi; dinonaktifkan oleh --incompatible_use_python_ toolchains.
Tag:loading_and_analysis
,affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Menentukan versi tvOS SDK yang akan digunakan untuk mem-build aplikasi tvOS. Jika tidak ditentukan, versi SDK tvOS default dari 'xcode_version' akan digunakan.
Tag:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Menentukan versi SDK watchOS yang akan digunakan untuk mem-build aplikasi watchOS. Jika tidak ditentukan, versi SDK watchOS default dari 'xcode_version' akan digunakan.
Tag:loses_incremental_state
--xcode_version=<a string>
default: lihat deskripsi-
Jika ditentukan, akan menggunakan Xcode dari versi yang ditentukan untuk tindakan build yang relevan. Jika tidak ditentukan, versi Xcode default eksekutor akan digunakan.
Tag:loses_incremental_state
--xcode_version_config=<a build target label>
default: "@bazel_tools//tools/cpp:host_xcodes"-
Label aturan xcode_config yang akan digunakan untuk memilih versi Xcode di konfigurasi build.
Tag:loses_incremental_state
,loading_and_analysis
- Opsi yang mengontrol output perintah:
--[no]apple_generate_dsym
default: "salah"-
Apakah akan menghasilkan file simbol debug(.dSYM).
Tag:affects_outputs
,action_command_lines
--[no]build_runfile_links
default: "true"-
Jika true (benar), buat forest symlink runfile untuk semua target. Jika false, tuliskan hanya saat diperlukan oleh tindakan lokal, uji, atau jalankan perintah.
Tag:affects_outputs
--[no]build_runfile_manifests
default: "true"-
Jika true (benar), menulis manifes runfile untuk semua target. Jika salah (false), hapus variabel tersebut. Pengujian lokal akan gagal dijalankan jika salah (false).
Tag:affects_outputs
--[no]build_test_dwp
default: "salah"-
Jika diaktifkan, saat mem-build pengujian C++ secara statis dan dengan fisi, file .dwp untuk biner pengujian juga akan otomatis dibuat.
Tag:loading_and_analysis
,affects_outputs
- Default
--cc_proto_library_header_suffixes=<comma-separated set of options>
: ".pb.h" -
Menetapkan akhiran file header yang dibuat oleh cc_proto_library.
Tag:affects_outputs
,loading_and_analysis
- Default
--cc_proto_library_source_suffixes=<comma-separated set of options>
: ".pb.cc" -
Menetapkan akhiran file sumber yang dibuat oleh cc_proto_library.
Tag:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
default: "salah"-
Menjalankan tindakan tambahan untuk versi Java API alternatif di proto_library.
Tag:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
default: "salah"-
Menjalankan tindakan tambahan untuk versi Java API alternatif di proto_library.
Tag:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
default: "salah"-
Simpan status fitur yang diaktifkan dan diminta sebagai output kompilasi.
Tag:affects_outputs
,experimental
--fission=<a set of compilation modes>
default: "tidak"-
Menentukan mode kompilasi yang menggunakan fisi untuk kompilasi dan link C++. Dapat berupa kombinasi {'fastbuild', 'dbg', 'opt'} atau nilai khusus 'yes' untuk mengaktifkan semua mode dan 'no' untuk menonaktifkan semua mode.
Tag:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
default: "true"-
Jika true (benar), aturan native akan menambahkan <code>DefaultInfo.files</code> dependensi data ke runfile-nya, yang cocok dengan perilaku yang direkomendasikan untuk aturan Starlark (https://bazel.build/extending/rules#runfiles_features_to_Hindari).
Tag:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
default: "true"-
Jika true, build runfile symlink forest untuk repositori eksternal dalam .runfiles/wsname/external/repo (selain .runfiles/repo).
Tag:affects_outputs
--[no]objc_generate_linkmap
default: "salah"-
Menentukan apakah akan membuat file peta link.
Tag:affects_outputs
--[no]save_temps
default: "salah"-
Jika disetel, output sementara dari gcc akan disimpan. Ini mencakup file .s (kode assembler), file .i (C yang diproses sebelumnya), dan file .ii (C++ yang diproses sebelumnya).
Tag:affects_outputs
- Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, tetapi memengaruhi nilainya, bukan keberadaannya:
--action_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi target. Variabel dapat ditetapkan berdasarkan nama, dalam hal ini nilai akan diambil dari lingkungan pemanggilan, atau oleh pasangan nama=nilai yang menetapkan nilai yang tidak bergantung pada lingkungan pemanggilan. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, nilai terbaru yang diperoleh, opsi untuk variabel yang berbeda akan diakumulasikan.
Tag:action_command_lines
--android_cpu=<a string>
default: "armeabi-v7a"-
CPU target Android.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
default: "true"-
Buat file data binding yang kompatibel dengan AndroidX. Ini hanya digunakan dengan databinding v2. Tanda ini tanpa pengoperasian.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
default: "true"-
Gunakan android databinding v2 dengan argumen 3.4.0. Tanda ini tanpa pengoperasian.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--android_dynamic_mode=<off, default or fully>
: "off" -
Menentukan apakah dependensi C++ aturan Android akan ditautkan secara dinamis ketika cc_binary tidak secara eksplisit membuat library bersama. 'default' berarti bazel akan memilih apakah akan menautkan secara dinamis. 'complete' berarti semua library akan ditautkan secara dinamis. 'off' berarti semua library akan ditautkan dalam sebagian besar mode statis.
Tag:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
default: "alfabet"-
Menetapkan urutan manifes yang diteruskan ke penggabungan manifes untuk biner Android. ALFABETIS berarti manifes diurutkan berdasarkan jalur relatif terhadap execroot. ALPHABETICAL_BY_CONFIGURATION berarti manifes diurutkan menurut jalur yang terkait dengan direktori konfigurasi dalam direktori output. DEPENDENSI berarti manifes diurutkan dengan setiap manifes library muncul sebelum manifes dependensinya.
Tag:action_command_lines
,execution
--[no]android_resource_shrinking
default: "salah"-
Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.
Tag:affects_outputs
,loading_and_analysis
--[no]build_python_zip
default: "otomatis"-
Buat zip python yang dapat dieksekusi; di Windows, nonaktif di platform lain
Tag:affects_outputs
--catalyst_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang memerlukan biner Apple Catalyst.
Tag:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
default: "salah"-
Jika ditentukan, Bazel akan menginstrumentasikan kode (menggunakan instrumentasi offline jika memungkinkan) dan akan mengumpulkan informasi cakupan selama pengujian. Hanya target yang cocok --instrumentation_filter yang akan terpengaruh. Biasanya opsi ini tidak boleh ditentukan secara langsung - perintah 'bazel scope' sebaiknya digunakan.
Tag:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] default: "fastbuild"-
Tentukan mode tempat biner akan dibangun. Nilai: 'fastbuild', 'dbg', 'opt'.
Tag:affects_outputs
,action_command_lines
--conlyopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke gcc saat mengompilasi file sumber C.
Tag:action_command_lines
,affects_outputs
--copt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke gcc.
Tag:action_command_lines
,affects_outputs
--cpu=<a string>
default: ""-
CPU target.
Tag:changes_inputs
,affects_outputs
--cs_fdo_absolute_path=<a string>
default: lihat deskripsi-
Menggunakan informasi profil CSFDO untuk mengoptimalkan kompilasi. Tentukan nama jalur absolut file zip yang berisi file profil, file profil LLVM mentah atau yang diindeks.
Tag:affects_outputs
--cs_fdo_instrument=<a string>
default: lihat deskripsi-
Membuat biner dengan instrumentasi FDO yang sensitif konteks. Dengan compiler Clang/LLVM, compiler ini juga menerima nama direktori tempat file profil mentah akan dibuang saat runtime.
Tag:affects_outputs
--cs_fdo_profile=<a build target label>
default: lihat deskripsi-
cs_fdo_profile yang mewakili profil sensitif konteks yang akan digunakan untuk pengoptimalan.
Tag:affects_outputs
--cxxopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke gcc saat mengompilasi file sumber C++.
Tag:action_command_lines
,affects_outputs
--define=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan-
Setiap opsi --define menentukan penetapan untuk variabel build. Dalam kasus beberapa nilai untuk suatu variabel, nilai terakhir yang akan menang.
Tag:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
default: "default"-
Menentukan apakah biner C++ akan ditautkan secara dinamis. 'default' berarti Bazel akan memilih apakah akan menautkan secara dinamis. 'complete' berarti semua library akan ditautkan secara dinamis. 'off' berarti semua library akan ditautkan dalam sebagian besar mode statis.
Tag:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
default: "true"-
Jika ditetapkan, penggunaan fdo_absolute_profile_path akan menimbulkan error.
Tag:affects_outputs
--[no]enable_runfiles
default: "otomatis"-
Aktifkan hierarki symlink runfiles; Secara default, fungsi ini nonaktif di Windows, di platform lain.
Tag:affects_outputs
--experimental_action_listener=<a build target label>
beberapa penggunaan diakumulasikan-
Tidak digunakan lagi demi aspek. Gunakan action_Listener untuk melampirkan extra_action ke tindakan build yang ada.
Tag:execution
,experimental
--[no]experimental_android_compress_java_resources
default: "salah"-
Kompresi resource Java dalam APK
Tag:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
default: "true"-
Gunakan databinding Android v2. Tanda ini tanpa pengoperasian.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
default: "salah"-
Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.
Tag:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
default: "salah"-
gunakan alat rex untuk menulis ulang file dex
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
default: "salah"-
Jika ditentukan, Bazel juga akan membuat informasi cakupan untuk file yang dihasilkan.
Tag:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
default: "-O0,-DDEBUG=1"-
Menggunakan string ini sebagai opsi compiler fastbuild objc.
Tag:action_command_lines
--[no]experimental_omitfp
default: "salah"-
Jika true (benar), gunakan libunwind untuk pelepasan stack (stack unwind), lalu kompilasi dengan -fomit-frame-pointer dan -fasync-unwind-tables.
Tag:action_command_lines
,affects_outputs
,experimental
- Default
--experimental_output_paths=<off, content or strip>
: "off" -
Model yang akan digunakan untuk tempat aturan hierarki output menulis output-nya, terutama untuk build multi-platform / multi-konfigurasi. Hal ini sangat eksperimental. Lihat https://github.com/bazelbuild/bazel/issues/6526 untuk mengetahui detailnya. Tindakan Starlark dapat digunakan dalam pemetaan jalur dengan menambahkan kunci 'supports-path-mapping' ke perintah 'execution_requirements'.
Tag:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
beberapa penggunaan diakumulasikan-
Setiap entri harus berupa label=value formulir dengan label merujuk ke platform dan nilai merupakan nama pendek yang diinginkan untuk digunakan di jalur output. Hanya digunakan jika --experimental_platform_in_output_dir benar. Memiliki prioritas penamaan tertinggi.
Tag:affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
default: "salah"-
Jika true (benar), nama pendek untuk platform target akan digunakan dalam nama direktori output, bukan CPU. Skema persisnya bersifat eksperimental dan dapat berubah sewaktu-waktu: Pertama, dalam kasus yang jarang terjadi, opsi --platforms tidak memiliki tepat satu nilai, hash opsi platform akan digunakan. Selanjutnya, jika ada nama pendek untuk platform saat ini yang didaftarkan oleh --experimental_override_name_platform_in_output_dir, maka nama pendek tersebut akan digunakan. Kemudian, jika --experimental_use_platforms_in_output_dir_legacy_heuristic ditetapkan, gunakan nama singkat berdasarkan Label platform saat ini. Akhirnya, {i>hash<i} dari opsi platform
digunakan sebagai upaya terakhir.
Tag:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
default: "salah"-
Jika ditentukan, Bazel akan membuat informasi peta cakupan llvm-cov, bukan gcov saat collect_code_coverage diaktifkan.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
default: "true"-
Harap gunakan tanda ini hanya sebagai bagian dari strategi migrasi atau pengujian yang disarankan. Perhatikan bahwa heuristik memiliki kekurangan yang telah diketahui, jadi sebaiknya migrasikan untuk hanya mengandalkan --experimental_override_name_platform_in_output_dir.
Tag:affects_outputs
,experimental
--fat_apk_cpu=<comma-separated set of options>
default: "armeabi-v7a"-
Menyetel opsi ini akan mengaktifkan APK lemak, yang berisi biner native untuk semua arsitektur target yang ditentukan, misalnya, --fat_apk_cpu=x86,armeabi-v7a. Jika flag ini ditentukan, maka --android_cpu diabaikan untuk dependensi aturan android_binary.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
default: "salah"-
Flag tanpa pengoperasian. Akan dihapus dalam rilis mendatang.
Tag:no_op
--fdo_instrument=<a string>
default: lihat deskripsi-
Membuat biner dengan instrumentasi FDO. Dengan compiler Clang/LLVM, compiler ini juga menerima nama direktori tempat file profil mentah akan dibuang saat runtime.
Tag:affects_outputs
--fdo_optimize=<a string>
default: lihat deskripsi-
Gunakan informasi profil FDO untuk mengoptimalkan kompilasi. Tentukan nama file zip yang berisi hierarki file .gcda, file afdo yang berisi profil otomatis, atau file profil LLVM. Tanda ini juga menerima file yang ditentukan sebagai label (mis. `//foo/bar:file.afdo` - Anda mungkin perlu menambahkan perintah `exports_files` ke paket terkait) dan label yang mengarah ke target `fdo_profile`. Tanda ini akan digantikan oleh aturan `fdo_profile`.
Tag:affects_outputs
--fdo_prefetch_hints=<a build target label>
default: lihat deskripsi-
Gunakan petunjuk pengambilan data cache.
Tag:affects_outputs
--fdo_profile=<a build target label>
default: lihat deskripsi-
fdo_profile yang mewakili profil yang akan digunakan untuk pengoptimalan.
Tag:affects_outputs
--features=<a string>
beberapa penggunaan diakumulasikan-
Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi target. Menentukan -<feature> akan menonaktifkan fitur. Fitur negatif selalu menggantikan fitur positif. Lihat juga --host_features
Tag:changes_inputs
,affects_outputs
--[no]force_pic
default: "salah"-
Jika diaktifkan, semua kompilasi C++ akan menghasilkan kode yang bergantung pada posisi ("-fPIC"), link akan lebih memilih library bawaan PIC daripada library non-PIC, dan link menghasilkan file yang dapat dieksekusi tanpa bergantung posisi ("-pie").
Tag:loading_and_analysis
,affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi eksekusi. Variabel dapat ditetapkan berdasarkan nama, dalam hal ini nilai akan diambil dari lingkungan pemanggilan, atau oleh pasangan nama=nilai yang menetapkan nilai yang tidak bergantung pada lingkungan pemanggilan. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, nilai terbaru yang diperoleh, opsi untuk variabel yang berbeda akan diakumulasikan.
Tag:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
default: "opt"-
Tentukan mode yang akan digunakan alat selama proses build. Nilai: 'fastbuild', 'dbg', 'opt'.
Tag:affects_outputs
,action_command_lines
--host_conlyopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke compiler C saat mengompilasi file sumber C (tetapi bukan C++) dalam konfigurasi exec.
Tag:action_command_lines
,affects_outputs
--host_copt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke compiler C untuk alat yang dibuat dalam konfigurasi exec.
Tag:action_command_lines
,affects_outputs
--host_cpu=<a string>
default: ""-
CPU host.
Tag:changes_inputs
,affects_outputs
--host_cxxopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke compiler C++ untuk alat yang dibuat dalam konfigurasi exec.
Tag:action_command_lines
,affects_outputs
--host_features=<a string>
beberapa penggunaan diakumulasikan-
Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi exec. Menentukan -<feature> akan menonaktifkan fitur. Fitur negatif selalu menggantikan fitur positif.
Tag:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
default: lihat deskripsi-
Mengganti versi Python untuk konfigurasi exec. Dapat berupa "PY2" atau "PY3".
Tag:loading_and_analysis
,affects_outputs
--host_linkopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke penaut saat menautkan alat dalam konfigurasi eksekusi.
Tag:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi macOS minimum yang kompatibel untuk target host. Jika tidak ditentukan, 'macos_sdk_version' akan digunakan.
Tag: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>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan secara selektif ke compiler C/C++ saat mengompilasi file tertentu dalam konfigurasi exec. Opsi ini dapat diteruskan beberapa kali. Sintaks: regex_filter@option_1,option_2,...,option_n. Di mana regex_filter adalah singkatan dari daftar pola sertakan dan kecualikan ekspresi reguler (Lihat juga --instrumentation_filter). option_1 menjadi option_n yang berarti opsi baris perintah arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ yang pertama digunakan untuk memisahkan string. Contoh: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 menambahkan opsi command line -O0 ke command line gcc dari semua file cc di //foo/ kecuali bar.cc.
Tag:action_command_lines
,affects_outputs
--[no]incompatible_auto_exec_groups
default: "salah"-
Jika diaktifkan, grup eksekusi akan otomatis dibuat untuk setiap toolchain yang digunakan oleh suatu aturan. Agar aturan ini berfungsi, perlu menentukan parameter `toolchain` pada tindakannya. Untuk informasi selengkapnya, lihat https://github.com/bazelbuild/bazel/issues/17134.
Tag:affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
default: "true"-
Jika true (benar), direktori genfiles akan dilipat ke dalam direktori tempat sampah.
Tag:affects_outputs
,incompatible_change
--[no]instrument_test_targets
default: "salah"-
Jika cakupan diaktifkan, tentukan apakah akan mempertimbangkan aturan pengujian instrumentasi. Jika ditetapkan, aturan pengujian yang disertakan oleh --instrumentation_filter akan diinstrumentasikan. Jika tidak, aturan pengujian selalu dikecualikan dari instrumentasi cakupan.
Tag:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
default: "-/javatests[/:],-/test/java[/:]"-
Jika cakupan diaktifkan, hanya aturan dengan nama yang disertakan oleh filter berbasis ekspresi reguler yang ditentukan yang akan diinstrumentasikan. Aturan yang diawali dengan '-' akan dikecualikan. Perhatikan bahwa hanya aturan non-pengujian yang diinstrumentasikan kecuali --instrument_test_targets diaktifkan.
Tag:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi iOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, 'ios_sdk_version' akan digunakan.
Tag:loses_incremental_state
--ios_multi_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk mem-build aplikasi ios_. Hasilnya adalah biner universal yang berisi semua arsitektur yang ditentukan.
Tag:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
default: "true"-
Tidak digunakan lagi, digantikan oleh --incompatible_remove_legacy_whole_archive (lihat https://github.com/bazelbuild/bazel/issues/7362 untuk mengetahui detailnya). Saat aktif, gunakan --whole-archive untuk aturan cc_binary yang memiliki linkshared=True dan linkstatic=True atau '-static' di linkopts. Ini hanya untuk kompatibilitas mundur. Alternatif yang lebih baik adalah menggunakan alwayslink=1 jika diperlukan.
Tag:action_command_lines
,affects_outputs
,deprecated
--linkopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke gcc saat menautkan.
Tag:action_command_lines
,affects_outputs
--ltobackendopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke langkah backend LTO (di bagian --features=thin_lto).
Tag:action_command_lines
,affects_outputs
--ltoindexopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke langkah pengindeksan LTO (pada --features=thin_lto).
Tag:action_command_lines
,affects_outputs
--macos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang akan digunakan untuk mem-build biner Apple macOS.
Tag:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi macOS minimum yang kompatibel untuk target. Jika tidak ditentukan, 'macos_sdk_version' akan digunakan.
Tag:loses_incremental_state
--memprof_profile=<a build target label>
default: lihat deskripsi-
Gunakan profil memprof.
Tag:affects_outputs
--[no]objc_debug_with_GLIBCXX
default: "salah"-
Jika disetel, dan mode kompilasi ditetapkan ke 'dbg', tentukan GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC, dan GLIBCPP_CONCEPT_CHECKS.
Tag:action_command_lines
--[no]objc_enable_binary_stripping
default: "salah"-
Apakah akan melakukan stripping simbol dan kode mati pada biner yang ditautkan. Pengupasan biner akan dilakukan jika tanda ini dan --compilation_mode=opt ditentukan.
Tag:action_command_lines
--objccopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke gcc saat mengompilasi file sumber Objective-C/C++.
Tag: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>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan secara selektif ke gcc saat mengompilasi file tertentu. Opsi ini dapat diteruskan beberapa kali. Sintaks: regex_filter@option_1,option_2,...,option_n. Di mana regex_filter adalah singkatan dari daftar pola sertakan dan kecualikan ekspresi reguler (Lihat juga --instrumentation_filter). option_1 menjadi option_n yang berarti opsi baris perintah arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ yang pertama digunakan untuk memisahkan string. Contoh: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 menambahkan opsi command line -O0 ke command line gcc dari semua file cc di //foo/ kecuali bar.cc.
Tag: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>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan secara selektif ke backend LTO (dalam --features=thin_lto) saat mengompilasi objek backend tertentu. Opsi ini dapat diteruskan beberapa kali. Sintaks: regex_filter@option_1,option_2,...,option_n. Di mana regex_filter merupakan singkatan dari daftar pola penyertaan dan kecualikan pola ekspresi reguler. options_1 menjadi option_n adalah singkatan dari opsi baris perintah arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ yang pertama digunakan untuk memisahkan string. Contoh: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 menambahkan opsi command line -O0 ke command line backend LTO dari semua file o di //foo/ kecuali bar.o.
Tag:action_command_lines
,affects_outputs
--platform_suffix=<a string>
default: lihat deskripsi-
Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.
Tag:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
default: lihat deskripsi-
Gunakan informasi profil Propeller untuk mengoptimalkan target build.Profil propeller harus terdiri dari minimal satu dari dua file, profil cc dan profil ld. Flag ini menerima label build yang harus merujuk pada file input profil propeller. Misalnya, file BUILD yang menentukan label, dalam a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Perintah ekspor_files mungkin harus ditambahkan ke paket yang sesuai agar file ini terlihat oleh Bazel. Opsi tersebut harus digunakan sebagai: --propeller_optimize=//a/b:propeller_profile
Tag:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
default: lihat deskripsi-
Nama jalur absolut file cc_profile untuk build yang Dioptimalkan untuk Propeller.
Tag:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
default: lihat deskripsi-
Nama jalur absolut file ld_profile untuk build yang Dioptimalkan untuk Propeller.
Tag:affects_outputs
--run_under=<a prefix in front of command>
default: lihat deskripsi-
Awalan yang akan disisipkan sebelum file yang dapat dieksekusi untuk perintah 'test' dan 'run'. Jika nilainya adalah 'foo -bar', dan command line eksekusi adalah 'test_binary -baz', command line terakhir adalah 'foo -bar test_binary -baz'.Ini juga dapat menjadi label untuk target yang dapat dieksekusi. Beberapa contohnya adalah: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Tag:action_command_lines
-
Jika benar, library native yang berisi fungsi identik akan dibagikan di antara target yang berbeda
Tag:loading_and_analysis
,affects_outputs
--[no]stamp
default: "salah"-
Stempel biner dengan tanggal, nama pengguna, nama host, informasi ruang kerja, dll.
Tag:affects_outputs
--strip=<always, sometimes or never>
default: "terkadang"-
Menentukan apakah akan menghapus biner dan library bersama (menggunakan "-Wl,--strip-debug"). Nilai {i>default<i} dari 'kadang-kadang' berarti strip iff --compilation_mode=fastbuild.
Tag:affects_outputs
--stripopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke strip saat membuat biner '<name>.stripped'.
Tag:action_command_lines
,affects_outputs
--tvos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang memerlukan biner Apple tvOS.
Tag:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi tvOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, 'tvos_sdk_version' akan digunakan.
Tag:loses_incremental_state
--visionos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang memerlukan biner Apple visionOS.
Tag:loses_incremental_state
,loading_and_analysis
--watchos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang memerlukan biner Apple watchOS.
Tag:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi watchOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, 'watchos_sdk_version' akan digunakan.
Tag:loses_incremental_state
--xbinary_fdo=<a build target label>
default: lihat deskripsi-
Menggunakan informasi profil XbinaryFDO untuk mengoptimalkan kompilasi. Tentukan nama profil lintas biner default. Jika opsi tersebut digunakan bersama dengan --fdo_instrument/--fdo_optimize/--fdo_profile, opsi tersebut akan selalu berlaku seolah-olah xbinary_fdo tidak pernah ditentukan.
Tag:affects_outputs
- Opsi yang memengaruhi seberapa ketat Bazel dalam menerapkan input build yang valid (definisi aturan, kombinasi flag, dll.):
--auto_cpu_environment_group=<a build target label>
default: ""-
Deklarasikan lingkungan_group yang akan digunakan untuk memetakan nilai CPU ke nilai target_environment secara otomatis.
Tag:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
default: "salah"-
Pastikan batasan pemberian lisensi yang diberlakukan oleh paket dependen tidak bertentangan dengan mode distribusi target yang dibuat. Secara default, lisensi tidak dicentang.
Tag:build_file_semantics
--[no]check_visibility
default: "true"-
Jika dinonaktifkan, error visibilitas dalam dependensi target akan didemosikan menjadi peringatan.
Tag:build_file_semantics
--[no]desugar_for_android
default: "true"-
Apakah akan mendesugar bytecode Java 8 sebelum melakukan dexing.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
default: "salah"-
Apakah akan menyertakan library Java 8 yang didukung dalam aplikasi untuk perangkat lama.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
default: "true"-
Memeriksa lingkungan yang kompatibel dengan setiap target dan melaporkan error jika ada target yang memiliki dependensi yang tidak mendukung lingkungan yang sama
Tag:build_file_semantics
--[no]experimental_check_desugar_deps
default: "true"-
Apakah akan memeriksa kembali desugaring yang benar pada tingkat biner Android.
Tag:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<off, warning or error>
default: "OFF"-
Jika diaktifkan, periksa apakah dependensi aar_import sudah lengkap. Penerapan ini dapat merusak build, atau hanya menghasilkan peringatan.
Tag:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
default: "default"-
Jika true (benar), periksa apakah target Java secara eksplisit mendeklarasikan semua target yang digunakan secara langsung sebagai dependensi.
Tag:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
default: "salah"-
Jika diaktifkan, periksa (hanya pengujian) untuk menemukan target prasyarat yang merupakan file output dengan mencari aturan yang menghasilkan hanya uji coba. Ini cocok dengan pemeriksaan visibilitas.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
default: "salah"-
Jika diaktifkan, pemeriksaan visibilitas juga berlaku untuk implementasi toolchain.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
default: "salah"-
Jika diaktifkan, penggunaan langsung aturan Android native akan dinonaktifkan. Gunakan aturan Android Starlark dari https://github.com/bazelbuild/rules_android
Tag:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
default: "salah"-
Tanpa pengoperasian. Disimpan di sini untuk kompatibilitas mundur.
Tag:eagerness_to_exit
,incompatible_change
--[no]incompatible_python_disable_py2
default: "true"-
Jika true (benar), menggunakan setelan Python 2 akan menyebabkan error. Ini termasuk python_version=PY2, srcs_version=PY2, dan srcs_version=PY2ONLY. Lihat https://github.com/bazelbuild/bazel/issues/15684 untuk informasi selengkapnya.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
default: "true"-
Flag ini bersifat noop dan dijadwalkan untuk dihapus.
Tag:no_op
,incompatible_change
--python_native_rules_allowlist=<a build target label>
default: lihat deskripsi-
Daftar yang diizinkan (target paket_grup) untuk digunakan saat menerapkan --incompatible_python_disallow_native_rules.
Tag:loading_and_analysis
--[no]strict_filesets
default: "salah"-
Jika opsi ini diaktifkan, kumpulan file yang melewati batas paket akan dilaporkan sebagai error.
Tag:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
default: "error"-
Kecuali NONAKTIF, memeriksa apakah target proto_library secara eksplisit mendeklarasikan semua target yang digunakan secara langsung sebagai dependensi.
Tag:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Default
--strict_public_imports=<off, warn, error, strict or default>
: "off" -
Kecuali NONAKTIF, akan memeriksa apakah target proto_library secara eksplisit mendeklarasikan semua target yang digunakan dalam 'impor publik' sebagai diekspor.
Tag:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
default: "salah"-
Jika true (benar), header yang ditemukan melalui jalur penyertaan sistem (-isystem) juga harus dideklarasikan.
Tag:loading_and_analysis
,eagerness_to_exit
--target_environment=<a build target label>
beberapa penggunaan diakumulasikan-
Mendeklarasikan lingkungan target build ini. Harus berupa referensi label ke aturan "lingkungan". Jika ditentukan, semua target tingkat teratas harus kompatibel dengan lingkungan ini.
Tag:changes_inputs
- Opsi yang memengaruhi output penandatanganan build:
- Default
--apk_signing_method=<v1, v2, v1_v2 or v4>
: "v1_v2" -
Implementasi yang akan digunakan untuk menandatangani APK
Tag:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
default: "true"-
Jika disetel, dan mode kompilasi tidak 'opt', aplikasi objc akan menyertakan hak debug saat menandatangani.
Tag:changes_inputs
--ios_signing_cert_name=<a string>
default: lihat deskripsi-
Nama sertifikat yang akan digunakan untuk penandatanganan iOS. Jika tidak disetel, perangkat akan kembali ke profil penyediaan. Dapat berupa preferensi identitas keychain sertifikat atau (substring) dari nama umum sertifikat, sesuai halaman utama codesign (SIGNING IDENTITIES).
Tag:action_command_lines
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_disallow_legacy_py_provider
default: "true"-
Tanpa pengoperasian, akan segera dihapus.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
default: "salah"-
Jika true (benar), larang atribut sdk_frameworks dan active_sdk_frameworks di objc_library danobjc_import.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
default: "salah"-
Jika true (benar), tetapkan nilai default ke benar (true) untuk atribut alwayslink di objc_library dan objc_import.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
default: "salah"-
Jika true (benar), error akan terjadi saat menggunakan aturan py_* bawaan; aturan rule_python harus digunakan. Lihat https://github.com/bazelbuild/bazel/issues/17773 untuk informasi selengkapnya dan petunjuk migrasi.
Tag:loading_and_analysis
,incompatible_change
- Opsi yang mengatur perilaku lingkungan pengujian atau runner pengujian:
--[no]allow_analysis_failures
default: "salah"-
Jika true (benar), kegagalan analisis target aturan akan menyebabkan propagasi target dari instance AnalysisFailureInfo yang berisi deskripsi error, bukan mengakibatkan kegagalan build.
Tag:loading_and_analysis
,experimental
- Default
--analysis_testing_deps_limit=<an integer>
: "2000" -
Menetapkan jumlah maksimum dependensi transitif melalui atribut aturan dengan transisi konfigurasi for_analysis_testing. Melebihi batas ini akan menyebabkan error aturan.
Tag:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
default: "salah"-
Jika kegagalan tindakan dex2oat yang sebenarnya akan menyebabkan build rusak, bukan mengeksekusi dex2oat selama runtime pengujian.
Tag:loading_and_analysis
,experimental
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g memory=10,30,60,100>
beberapa penggunaan diakumulasikan- Mengganti jumlah resource default untuk pengujian. Format yang diharapkan adalah <resource>=<value>. Jika satu angka positif ditetapkan sebagai <value>, resource default untuk semua ukuran pengujian akan diganti. Jika 4 angka yang dipisahkan koma ditentukan, angka tersebut akan menggantikan jumlah resource untuk masing-masing ukuran pengujian kecil, sedang, besar, dan sangat besar. Nilai juga bisa berupa HOST_RAM/HOST_CPU, secara opsional diikuti oleh [-|*]<float> (mis. memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4). Resource pengujian default yang ditentukan oleh flag ini diganti oleh resource eksplisit yang ditentukan dalam tag.
--[no]experimental_android_use_parallel_dex2oat
default: "salah"-
Gunakan dex2oat secara paralel untuk mempercepat android_test.
Tag:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
default: "salah"-
Mengaktifkan pemeriksaan kebocoran memori di target ios_test.
Tag:action_command_lines
--ios_simulator_device=<a string>
default: lihat deskripsi-
Perangkat yang akan disimulasikan saat menjalankan aplikasi iOS di simulator, misalnya 'iPhone 6'. Anda bisa mendapatkan daftar perangkat dengan menjalankan 'xcrun simctl list devicetypes' di mesin tempat simulator akan dijalankan.
Tag:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi iOS yang akan dijalankan pada simulator saat dijalankan atau diuji. Nilai ini diabaikan untuk aturan ios_test jika perangkat target ditentukan dalam aturan.
Tag:test_runner
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
beberapa penggunaan diakumulasikan- Menentukan jumlah waktu untuk menjalankan setiap pengujian. Jika salah satu upaya tersebut gagal karena alasan apa pun, seluruh pengujian akan dianggap gagal. Biasanya nilai yang ditentukan hanya berupa bilangan bulat. Contoh: --runs_per_test=3 akan menjalankan semua pengujian 3 kali. Sintaksis alternatif: regex_filter@runs_per_test. Di mana run_per_test merupakan singkatan dari nilai integer dan regex_filter adalah singkatan dari daftar yang mencakup dan mengecualikan pola ekspresi reguler (Lihat juga --instrumentation_filter). Contoh: --runs_per_test=//foo/.*,-//foo/bar/.*@3 menjalankan semua pengujian di //foo/ kecuali yang berada di bawah foo/bar tiga kali. Opsi ini dapat diteruskan beberapa kali. Argumen yang terakhir diteruskan yang cocok akan diprioritaskan. Jika tidak ada yang cocok, pengujian hanya akan dijalankan sekali.
--test_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan variabel lingkungan tambahan yang akan dimasukkan ke lingkungan runner pengujian. Variabel dapat ditentukan berdasarkan nama, dan nilainya akan dibaca dari lingkungan klien Bazel, atau berdasarkan pasangan nama=nilai. Opsi ini dapat digunakan beberapa kali untuk menentukan beberapa variabel. Hanya digunakan oleh perintah 'bazel test'.
Tag:test_runner
- Default
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - Mengganti nilai waktu tunggu pengujian default untuk waktu tunggu pengujian (dalam detik). Jika ditentukan, hanya satu nilai bilangan bulat positif yang akan mengganti semua kategori. Jika ditentukan 4 bilangan bulat yang dipisahkan koma, waktu tunggu tersebut akan menggantikan waktu tunggu untuk singkat, sedang, panjang, dan abadi (dalam urutan tersebut). Dalam kedua bentuk tersebut, nilai -1 akan memberi tahu blaze untuk menggunakan waktu tunggu defaultnya untuk kategori tersebut.
--[no]zip_undeclared_test_outputs
default: "true"-
Jika true (benar), output pengujian yang tidak dideklarasikan akan diarsipkan dalam file ZIP.
Tag:test_runner
- Opsi yang berkaitan dengan output kueri dan semantik:
--aspect_deps=<off, conservative or precise>
default: "konservatif"-
Cara me-resolve dependensi aspek jika format output adalah salah satu dari {xml,proto,record}. 'off' berarti tidak ada dependensi aspek yang diselesaikan, 'konservatif' (default) berarti semua dependensi aspek yang dideklarasikan akan ditambahkan terlepas dari apakah dependensi tersebut diberi class aturan dependensi langsung atau tidak, 'precise' berarti hanya aspek yang ditambahkan yang mungkin aktif berdasarkan class aturan dependensi langsung. Perhatikan bahwa mode presisi mengharuskan pemuatan paket lain untuk mengevaluasi satu target sehingga membuatnya lebih lambat daripada mode lainnya. Perhatikan juga bahwa mode yang tepat pun tidak sepenuhnya tepat: keputusan apakah akan menghitung suatu aspek ditentukan dalam fase analisis, yang tidak dijalankan selama 'kueri bazel'.
Tag:build_file_semantics
--[no]consistent_labels
default: "salah"-
Jika diaktifkan, setiap perintah kueri akan memunculkan label seolah-olah oleh fungsi <code>str</code> Starlark yang diterapkan ke instance <code>Label</code>. Hal ini berguna untuk alat yang perlu mencocokkan {i>output<i} dari berbagai perintah kueri dan/atau label yang dihasilkan oleh aturan. Jika tidak diaktifkan, pemformat output bebas memunculkan nama repositori yang jelas (relatif terhadap repositori utama) agar output lebih mudah dibaca.
Tag:terminal_output
--[no]experimental_explicit_aspects
default: "salah"-
kueri, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: tanpa pengoperasian (aspek selalu diikuti).
Tag:terminal_output
--[no]graph:factored
default: "true"-
Jika benar, grafik akan dimunculkan 'difaktorkan', yaitu node yang setara secara topologis akan digabungkan bersama dan labelnya akan digabungkan. Opsi ini hanya berlaku untuk --output=graph.
Tag:terminal_output
- Default
--graph:node_limit=<an integer>
: "512" -
Panjang maksimum string label untuk node grafik dalam output. Label yang lebih panjang akan dipotong; -1 berarti tidak ada pemotongan. Opsi ini hanya berlaku untuk --output=graph.
Tag:terminal_output
--[no]implicit_deps
default: "true"-
Jika diaktifkan, dependensi implisit akan disertakan dalam grafik dependensi tempat kueri dioperasikan. Dependensi implisit adalah dependensi yang tidak disebutkan secara eksplisit dalam file BUILD tetapi ditambahkan oleh bazel. Untuk cquery, opsi ini mengontrol pemfilteran toolchain yang di-resolve.
Tag:build_file_semantics
--[no]include_artifacts
default: "true"-
Mencakup nama input dan output tindakan dalam output (berpotensi besar).
Tag:terminal_output
--[no]include_aspects
default: "true"-
kueri, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: tanpa pengoperasian (aspek selalu diikuti).
Tag:terminal_output
--[no]include_commandline
default: "true"-
Mencakup konten command line tindakan dalam output (berpotensi besar).
Tag:terminal_output
--[no]include_file_write_contents
default: "salah"-
Menyertakan konten file untuk tindakan FileWrite, SourceSymlinkManifest, dan RepoMappingManifest (berpotensi besar).
Tag:terminal_output
--[no]include_param_files
default: "salah"-
Sertakan konten file parameter yang digunakan dalam perintah (berpotensi besar). Catatan: Mengaktifkan tanda ini akan otomatis mengaktifkan tanda --include_commandline.
Tag:terminal_output
--[no]include_scheduling_dependencies
default: "salah"-
Mencakup nama dependensi penjadwalan tindakan (berpotensi besar). Hanya berlaku jika --include_artifacts juga ditetapkan.
Tag:terminal_output
--[no]incompatible_package_group_includes_double_slash
default: "true"-
Jika diaktifkan, saat menghasilkan output atribut `packages` package_group, `//` awal tidak akan dihilangkan.
Tag:terminal_output
,incompatible_change
--[no]infer_universe_scope
default: "salah"-
Jika ditetapkan dan --universe_scope tidak ditetapkan, nilai --universe_scope akan disimpulkan sebagai daftar pola target unik dalam ekspresi kueri. Perhatikan bahwa nilai --universe_scope yang disimpulkan untuk ekspresi kueri yang menggunakan fungsi cakupan alam semesta (misalnya `allrdeps`) mungkin bukan yang Anda inginkan, jadi sebaiknya gunakan opsi ini hanya jika Anda tahu apa yang Anda lakukan. Lihat https://bazel.build/reference/query#sky-query untuk mengetahui detail dan contohnya. Jika --universe_scope ditetapkan, nilai opsi ini akan diabaikan. Catatan: opsi ini hanya berlaku untuk `query` (bukan `cquery`).
Tag:loading_and_analysis
--[no]line_terminator_null
default: "salah"-
Apakah setiap format dihentikan dengan \0, bukan baris baru.
Tag:terminal_output
--[no]nodep_deps
default: "true"-
Jika diaktifkan, dependensi dari atribut "nodep" akan disertakan dalam grafik dependensi yang digunakan untuk mengoperasikan kueri. Contoh umum atribut "nodep" adalah "visibilitas". Jalankan dan uraikan output `info build-language` untuk mempelajari semua atribut "nodep" dalam bahasa build.
Tag:build_file_semantics
--output=<a string>
default: "text"-
Format yang akan menampilkan hasil kueri. Nilai yang diizinkan untuk aquery adalah: text, textproto, proto, streaming_proto, jsonproto.
Tag:terminal_output
--[no]proto:default_values
default: "true"-
Jika true (benar), atribut yang nilainya tidak ditentukan secara eksplisit dalam file BUILD akan disertakan; jika tidak, atribut tersebut akan dihilangkan. Opsi ini berlaku untuk --output=proto
Tag:terminal_output
--[no]proto:definition_stack
default: "salah"-
Isi kolom proto definisi_stack, yang mencatat setiap instance aturan stack panggilan Starlark pada saat class aturan ditentukan.
Tag:terminal_output
--[no]proto:flatten_selects
default: "true"-
Jika diaktifkan, atribut yang dapat dikonfigurasi yang dibuat oleh select() akan diratakan. Untuk jenis daftar, representasi yang disatukan adalah daftar yang berisi setiap nilai peta yang dipilih dengan tepat satu kali. Jenis skalar diratakan menjadi null.
Tag:build_file_semantics
--[no]proto:include_attribute_source_aspects
default: "salah"-
Isi kolom proto source_aspect_name dari setiap Atribut dengan aspek sumber tempat atribut tersebut berasal (string kosong jika bukan).
Tag:terminal_output
--[no]proto:include_synthetic_attribute_hash
default: "salah"-
Apakah akan menghitung dan mengisi atribut $internal_attr_hash atau tidak.
Tag:terminal_output
--[no]proto:instantiation_stack
default: "salah"-
Isi stack panggilan pembuatan instance dari setiap aturan. Perhatikan bahwa stack harus ada
Tag:terminal_output
--[no]proto:locations
default: "true"-
Apakah akan menghasilkan informasi lokasi dalam output proto atau tidak.
Tag:terminal_output
- Default
--proto:output_rule_attrs=<comma-separated list of options>
: "all" -
Daftar atribut yang dipisahkan koma untuk disertakan dalam output. Setelan defaultnya adalah semua atribut. Setel ke string kosong agar tidak menghasilkan output atribut apa pun. Opsi ini berlaku untuk --output=proto.
Tag:terminal_output
--[no]proto:rule_inputs_and_outputs
default: "true"-
Apakah kolom rule_input dan rule_output mengisi atau tidak.
Tag:terminal_output
--query_file=<a string>
default: ""-
Jika ditetapkan, kueri akan membaca kueri dari file yang disebutkan di sini, bukan dari command line. Menentukan file di sini serta kueri command line merupakan suatu error.
Tag:changes_inputs
--[no]relative_locations
default: "salah"-
Jika true (benar), lokasi file BUILD dalam output xml dan proto akan bersifat relatif. Secara default, output lokasi adalah jalur absolut dan tidak akan konsisten di seluruh mesin. Anda dapat menyetel opsi ini ke benar (true) agar mendapatkan hasil yang konsisten di seluruh mesin.
Tag:terminal_output
--[no]skyframe_state
default: "salah"-
Tanpa melakukan analisis tambahan, hapus Grafik Tindakan saat ini dari Skyframe. Catatan: Menentukan target dengan --skyframe_state saat ini tidak didukung. Tanda ini hanya tersedia dengan --output=proto atau --output=textproto.
Tag:terminal_output
--[no]tool_deps
default: "true"-
Kueri: Jika dinonaktifkan, dependensi pada 'exec configuration' tidak akan disertakan dalam grafik dependensi tempat kueri dioperasikan. Edge dependensi 'exec configuration', seperti yang berasal dari aturan 'proto_library' apa pun ke Protocol Compiler, biasanya mengarah ke alat yang dieksekusi selama build, bukan bagian dari program 'target' yang sama.
Cquery: Jika dinonaktifkan, memfilter semua target yang dikonfigurasi yang melewati transisi eksekusi dari target tingkat teratas yang menemukan target yang dikonfigurasi ini. Artinya, jika target tingkat atas ada dalam konfigurasi target, hanya target yang dikonfigurasi dan dalam konfigurasi target yang akan ditampilkan. Jika target tingkat teratas berada dalam konfigurasi eksekusi, hanya target yang dikonfigurasi dengan eksekusi yang akan ditampilkan. Opsi ini TIDAK akan mengecualikan toolchain yang telah diselesaikan.
Tag:build_file_semantics
--universe_scope=<comma-separated list of options>
default: ""-
Kumpulan pola target yang dipisahkan koma (aditif dan pengurangan). Kueri dapat dilakukan di alam semesta yang ditentukan oleh penutupan transitif target yang ditentukan. Opsi ini digunakan untuk perintah kueri dan kueri.
Untuk cquery, input untuk opsi ini adalah target dari semua jawaban yang dibuat sehingga opsi ini dapat memengaruhi konfigurasi dan transisi. Jika opsi ini tidak ditentukan, target tingkat teratas dianggap sebagai target yang diuraikan dari ekspresi kueri. Catatan: Untuk cquery, tidak menentukan opsi ini dapat menyebabkan build rusak jika target yang diurai dari ekspresi kueri tidak dapat dibuat dengan opsi tingkat atas.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
--[no]experimental_filter_library_jar_with_program_jar
default: "salah"-
Filter ProGuard ProgramJar untuk menghapus class yang juga ada di LibraryJar.
Tag:action_command_lines
--[no]experimental_inmemory_dotd_files
default: "true"-
Jika diaktifkan, file .d C++ akan diteruskan dalam memori langsung dari node build jarak jauh, bukan ditulis ke disk.
Tag:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
default: "true"-
Jika diaktifkan, file dependensi (.jdeps) yang dihasilkan dari kompilasi Java akan diteruskan dalam memori langsung dari node build jarak jauh, bukan ditulis ke disk.
Tag:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_retain_test_configuration_across_testonly
default: "salah"-
Jika diaktifkan, --trim_test_configuration tidak akan memangkas konfigurasi pengujian untuk aturan yang ditandai sebagai testonly=1. Hal ini dimaksudkan untuk mengurangi masalah konflik tindakan ketika aturan non-pengujian bergantung pada aturan cc_test. Tidak berpengaruh jika --trim_test_configuration bernilai salah (false).
Tag:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
default: "salah"-
Jika diaktifkan, versi Starlark dari cc_import dapat digunakan.
Tag:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
default: "salah"-
Apakah akan mempersempit input ke kompilasi C/C++ dengan menguraikan baris #include dari file input. Hal ini dapat meningkatkan performa dan inkrementalitas dengan mengurangi ukuran hierarki input kompilasi. Namun, tindakan ini juga dapat merusak build karena pemindai penyertaan tidak sepenuhnya mengimplementasikan semantik preprosesor C. Secara khusus, fungsi ini tidak memahami perintah #include dinamis dan mengabaikan logika bersyarat praprosesor. Risiko ditanggung sendiri. Masalah apa pun yang terkait dengan laporan ini akan ditutup.
Tag:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
default: "true"-
Melakukan sebagian besar pekerjaan untuk dexing secara terpisah untuk setiap file Jar.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
default: "true"-
Jika ditetapkan, file .d yang dimunculkan oleh clang akan digunakan untuk memangkas kumpulan input yang diteruskan ke kompilasi objc.
Tag:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
default: "salah"-
Saat membuat target //a:a, header proses di semua target yang menjadi dependensi //a:a (jika pemrosesan header diaktifkan untuk toolchain).
Tag:execution
--[no]trim_test_configuration
default: "true"-
Jika diaktifkan, opsi terkait pengujian akan dihapus di bawah tingkat atas build. Jika flag ini aktif, pengujian tidak dapat dibuat sebagai dependensi aturan bukan pengujian, tetapi perubahan pada opsi terkait pengujian tidak akan menyebabkan aturan non-pengujian dianalisis ulang.
Tag:loading_and_analysis
,loses_incremental_state
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
default: "-.*"-
Mencetak informasi debug selama resolusi toolchain. Flag ini menggunakan ekspresi reguler, yang diperiksa berdasarkan jenis toolchain dan target tertentu untuk melihat mana yang akan di-debug. Beberapa regex dapat dipisahkan dengan koma, kemudian setiap regex diperiksa secara terpisah. Catatan: Output flag ini sangat kompleks dan kemungkinan hanya akan berguna bagi pakar dalam resolusi toolchain.
Tag:terminal_output
- Opsi yang menentukan atau mengubah input umum ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--flag_alias=<a 'name=value' flag alias>
beberapa penggunaan diakumulasikan-
Menetapkan nama singkat untuk flag Starlark. Dibutuhkan satu pasangan nilai kunci dalam bentuk "<key>=<value>" sebagai argumen.
Tag:changes_inputs
--[no]incompatible_default_to_explicit_init_py
default: "salah"-
Flag ini mengubah perilaku default sehingga file __init__.py tidak lagi dibuat secara otomatis di runfile target Python. Tepatnya, jika target py_binary atau py_test memiliki legacy_create_init yang disetel ke "auto" (default), ini diperlakukan sebagai false jika dan hanya jika tanda ini disetel. Lihat https://github.com/bazelbuild/bazel/issues/10076.
Tag:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
default: "true"-
Jika true (benar), target yang dibuat dalam konfigurasi Python 2 akan muncul pada root output yang menyertakan akhiran '-py2', sedangkan target yang dibuat untuk Python 3 akan muncul di root tanpa akhiran terkait Python. Ini berarti symlink praktis `bazel-bin` akan mengarah ke target Python 3, bukan Python 2. Jika mengaktifkan opsi ini, sebaiknya Anda juga mengaktifkan `--incompatible_py3_is_default`.
Tag:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
default: "true"-
Jika true, target `py_binary` dan `py_test` yang tidak menetapkan atribut `python_version` (atau `default_python_version`) akan ditetapkan secara default ke PY3, bukan PY2. Jika Anda menetapkan tanda ini, sebaiknya Anda juga menetapkan `--incompatible_py2_outputs_are_suffixed`.
Tag:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
default: "true"-
Jika disetel ke benar (true), aturan Python native yang dapat dieksekusi akan menggunakan runtime Python yang ditentukan oleh toolchain Python, bukan runtime yang diberikan oleh flag lama seperti --python_top.
Tag:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
default: lihat deskripsi-
Mode versi utama Python, baik `PY2` maupun `PY3`. Perhatikan bahwa hal ini diganti oleh target `py_binary` dan `py_test` (meskipun keduanya tidak menentukan versi secara eksplisit) sehingga biasanya tidak ada banyak alasan untuk menyediakan flag ini.
Tag:loading_and_analysis
,affects_outputs
- Opsi lain, yang tidak dikategorikan lain.:
--[no]cache_test_results
[-t
] default: "otomatis"- Jika disetel ke 'otomatis', Bazel akan menjalankan kembali pengujian jika dan hanya jika: (1) Bazel mendeteksi perubahan dalam pengujian atau dependensinya, (2) pengujian ditandai sebagai eksternal, (3) beberapa pengujian diminta dengan --runs_per_test, atau(4) pengujian sebelumnya gagal. Jika disetel ke 'ya', Bazel akan meng-cache semua hasil pengujian kecuali pengujian yang ditandai sebagai eksternal. Jika disetel ke 'tidak', Bazel tidak akan menyimpan hasil pengujian apa pun dalam cache.
--[no]experimental_cancel_concurrent_tests
default: "salah"-
Jika true (benar), Blaze akan membatalkan pengujian yang berjalan secara serentak pada saat pertama berhasil dijalankan. Parameter ini hanya berguna jika dikombinasikan dengan --runs_per_test_detects_flakes.
Tag:affects_outputs
,loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
default: "salah"-
Jika true (benar), Bazel akan mengambil seluruh direktori data cakupan untuk setiap pengujian selama cakupan dijalankan.
Tag:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
default: "salah"-
Jika benar, cakupan untuk clang akan menghasilkan laporan LCOV.
Tag:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
default: "true"- Apakah akan membuat peta header J2ObjC secara paralel dengan transpilasi J2ObjC.
--[no]experimental_j2objc_shorter_header_path
default: "salah"-
Apakah membuat dengan jalur header yang lebih pendek (menggunakan "_ios", bukan "_j2objc").
Tag:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
default: "javabuilder"- Memungkinkan classpath yang dikurangi untuk kompilasi Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
default: "salah"-
Batasi --experimental_run_android_lint_on_java_rules ke library yang kompatibel dengan Android.
Tag:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
default: "salah"-
Apakah akan memvalidasi sumber java_*.
Tag:affects_outputs
--[no]explicit_java_test_deps
default: "salah"- Secara eksplisit menentukan dependensi untuk JUnit atau Hamcrest dalam java_test, bukan secara tidak sengaja memperoleh dari dependensi TestRunner. Saat ini hanya berfungsi untuk Bagas.
--host_java_launcher=<a build target label>
default: lihat deskripsi- Peluncur Java yang digunakan oleh alat yang dieksekusi selama proses build.
--host_javacopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan untuk diteruskan ke javac saat mem-build alat yang dijalankan selama proses build.
--host_jvmopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan untuk diteruskan ke VM Java saat mem-build alat yang dijalankan selama proses build. Opsi ini akan ditambahkan ke opsi startup VM dari setiap target java_binary.
--[no]incompatible_check_sharding_support
default: "true"-
Jika benar, Bazel akan gagal dalam pengujian dengan sharding jika runner pengujian tidak menunjukkan bahwa runner pengujian mendukung sharding dengan menyentuh file di jalur di TEST_SHARD_STATUS_FILE. Jika bernilai salah, runner pengujian yang tidak mendukung sharding akan menyebabkan semua pengujian berjalan di setiap shard.
Tag:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
default: "true"-
Jika benar, pengujian eksklusif akan dijalankan dengan strategi yang di-sandbox. Tambahkan tag 'local' untuk memaksakan pengujian eksklusif yang dijalankan secara lokal
Tag:incompatible_change
--[no]incompatible_strict_action_env
default: "salah"-
Jika true (benar), Bazel akan menggunakan lingkungan dengan nilai statis untuk PATH dan tidak mewarisi LD_LIBRARY_PATH. Gunakan --action_env=ENV_VARIABLE jika Anda ingin mewarisi variabel lingkungan tertentu dari klien, namun perhatikan bahwa hal tersebut dapat mencegah penyimpanan cache lintas-pengguna jika cache bersama digunakan.
Tag:loading_and_analysis
,incompatible_change
--j2objc_translation_flags=<comma-separated list of options>
beberapa penggunaan diakumulasikan- Opsi tambahan untuk diteruskan ke alat J2ObjC.
--java_debug
-
Menyebabkan mesin virtual Java pada pengujian java menunggu koneksi dari debugger yang sesuai dengan JDWP (seperti jdb) sebelum memulai pengujian. Menyiratkan -test_output=streamed.
Diluaskan ke:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
default: "true"- Membuat informasi dependensi (untuk saat ini, classpath waktu kompilasi) per target Java.
--[no]java_header_compilation
default: "true"- Mengompilasi ijar langsung dari sumber.
--java_language_version=<a string>
default: ""- Versi bahasa Java
--java_launcher=<a build target label>
default: lihat deskripsi- Peluncur Java yang akan digunakan saat mem-build biner Java. Jika flag ini disetel ke string kosong, peluncur JDK akan digunakan. Atribut "peluncur" menggantikan tanda ini.
--java_runtime_version=<a string>
default: "local_jdk"- Versi runtime Java
--javacopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan untuk diteruskan ke javac.
--jvmopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan untuk diteruskan ke VM Java. Opsi ini akan ditambahkan ke opsi startup VM dari setiap target java_binary.
--legacy_main_dex_list_generator=<a build target label>
default: lihat deskripsi- Menentukan biner yang akan digunakan untuk membuat daftar class yang harus ada di dex utama saat mengompilasi multidex lama.
--optimizing_dexer=<a build target label>
default: lihat deskripsi- Menentukan biner yang akan digunakan untuk melakukan dexing tanpa sharding.
--plugin=<a build target label>
beberapa penggunaan diakumulasikan- Plugin yang akan digunakan dalam build. Saat ini berfungsi dengan java_plugin.
--proguard_top=<a build target label>
default: lihat deskripsi- Menentukan versi ProGuard yang akan digunakan untuk penghapusan kode saat mem-build biner Java.
--proto_compiler=<a build target label>
default: "@bazel_tools//tools/proto:protoc"-
Label compiler proto.
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
default: "@bazel_tools//tools/proto:cc_toolchain"-
Label proto_lang_ toolchain() yang menjelaskan cara mengompilasi proto C++
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
default: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Label proto_lang_toolchain() yang menjelaskan cara mengompilasi proto j2objc
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
default: "@bazel_tools//tools/proto:java_Tool"-
Label proto_lang_ toolchain() yang menjelaskan cara mengompilasi proto Java
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
default: "@bazel_tools//tools/proto:javalite_toolchain"-
Label proto_lang_ toolchain() yang menjelaskan cara mengompilasi proto JavaLite
Tag:affects_outputs
,loading_and_analysis
--protocopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke compiler protobuf.
Tag:affects_outputs
--[no]runs_per_test_detects_flakes
default: "salah"- Jika benar, shard apa pun dengan minimal satu percobaan/percobaan lulus dan minimal satu percobaan/percobaan gagal akan mendapatkan status FLAKY.
--shell_executable=<a path>
default: lihat deskripsi-
Jalur absolut ke shell yang dapat dieksekusi untuk digunakan oleh Bazel. Jika variabel ini tidak disetel, tetapi variabel lingkungan BAZEL_SH ditetapkan pada pemanggilan Bazel pertama (yang memulai server Bazel), Bazel akan menggunakannya. Jika tidak ada yang ditetapkan, Bazel menggunakan jalur default hard code tergantung pada sistem operasi tempatnya berjalan (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, lainnya: /bin/bash). Perhatikan bahwa menggunakan shell yang tidak kompatibel dengan bash dapat menyebabkan kegagalan build atau kegagalan runtime dari biner yang dihasilkan.
Tag:loading_and_analysis
--test_arg=<a string>
beberapa penggunaan diakumulasikan- Menentukan opsi dan argumen tambahan yang harus diteruskan ke pengujian yang dapat dieksekusi. Dapat digunakan beberapa kali untuk menentukan beberapa argumen. Jika beberapa pengujian dijalankan, masing-masing pengujian akan menerima argumen yang identik. Hanya digunakan oleh perintah 'bazel test'.
--test_filter=<a string>
default: lihat deskripsi- Menentukan filter untuk diteruskan ke framework pengujian. Digunakan untuk membatasi pengujian yang dijalankan. Perhatikan bahwa hal ini tidak memengaruhi target yang dibuat.
- Default
--test_result_expiration=<an integer>
: "-1" - Opsi ini tidak digunakan lagi dan tidak berpengaruh.
--[no]test_runner_fail_fast
default: "salah"- Opsi cepat diteruskan ke runner pengujian gagal. Runner pengujian harus menghentikan eksekusi setelah kegagalan pertama.
- Default
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
: "eksplisit" - Tentukan strategi untuk sharding pengujian: 'eksplisit' untuk hanya menggunakan sharding jika atribut BUILD 'shard_count' ada. 'dinonaktifkan' agar tidak pernah menggunakan sharding pengujian. 'forced=k' untuk menerapkan shard 'k' untuk pengujian terlepas dari atribut BUILD 'shard_count'.
--tool_java_language_version=<a string>
default: ""- Versi bahasa Java yang digunakan untuk menjalankan alat yang diperlukan selama proses build
--tool_java_runtime_version=<a string>
default: "remotejdk_11"- Versi runtime Java yang digunakan untuk menjalankan alat selama proses build
--[no]use_ijars
default: "true"- Jika diaktifkan, opsi ini akan menyebabkan kompilasi Java menggunakan jar antarmuka. Ini akan menghasilkan kompilasi inkremental yang lebih cepat, tetapi pesan error dapat berbeda.
Opsi Build
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
default: "salah"-
Jika ditetapkan, cache repositori akan menerapkan hardlink pada file jika cache ditemukan, bukan menyalinnya. Hal ini dimaksudkan untuk menghemat kapasitas {i>disk<i}.
Tag:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
default: "0"-
Jumlah upaya maksimum untuk mencoba kembali error download. Jika ditetapkan ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark berdasarkan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi pada komputer yang lebih lambat dari yang diharapkan oleh pembuat aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_connector_attempts=<an integer>
: "8" -
Jumlah upaya maksimum untuk download http.
Tag:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
default: "0s"-
Waktu tunggu maksimum untuk percobaan ulang download http. Dengan nilai 0, tidak ada waktu tunggu maksimum yang ditentukan.
Tag:bazel_internal_configuration
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Skalakan semua waktu tunggu yang terkait dengan download http berdasarkan faktor yang diberikan
Tag:bazel_internal_configuration
--repository_cache=<a path>
default: lihat deskripsi-
Menentukan lokasi cache dari nilai yang didownload yang diperoleh selama pengambilan repositori eksternal. String kosong sebagai argumen meminta cache dinonaktifkan. Jika tidak, default '<output_user_root>/cache/repos/v1' akan digunakan
Tag:bazel_internal_configuration
--[no]repository_disable_download
default: "salah"-
Jika ditetapkan, mendownload menggunakan ctx.download{,_and_extract} tidak akan diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file arbitrer yang dapat dieksekusi yang mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
--[no]check_up_to_date
default: "salah"-
Jangan menjalankan build, cukup periksa apakah build tersebut sudah yang terbaru. Jika semua target merupakan versi terbaru, build akan berhasil diselesaikan. Jika langkah perlu dijalankan, error akan dilaporkan dan build gagal.
Tag:execution
- Default
--dynamic_local_execution_delay=<an integer>
: "1000" -
Berapa milidetik seharusnya eksekusi lokal tertunda, jika eksekusi jarak jauh lebih cepat selama proses build setidaknya satu kali?
Tag:execution
,host_machine_resource_optimizations
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment>
beberapa penggunaan diakumulasikan-
Strategi lokal secara berurutan digunakan untuk mnemonik tertentu - strategi pertama yang berlaku akan digunakan. Misalnya, `worker,sandboxed` menjalankan tindakan yang mendukung pekerja persisten menggunakan strategi pekerja, dan tindakan lainnya menggunakan strategi dalam sandbox. Jika tidak ada mnemonik yang diberikan, daftar strategi akan digunakan sebagai pengganti untuk semua mnemonik. Daftar penggantian default adalah `worker,sandboxed`, atau`worker,sandboxed,standalone` jika `experimental_local_lockfree_output` disetel. Menggunakan [mnemonic=]local_strategy[,local_strategy,...]
Tag:execution
,host_machine_resource_optimizations
--dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment>
beberapa penggunaan diakumulasikan-
Strategi jarak jauh, agar dapat digunakan untuk mnemonik tertentu - strategi pertama yang berlaku akan digunakan. Jika tidak ada mnemonik yang diberikan, daftar strategi akan digunakan sebagai pengganti untuk semua mnemonik. Daftar penggantian default adalah `jarak jauh`, sehingga tanda ini biasanya tidak perlu disetel secara eksplisit. Perlu [mnemonic=]strategi_jarak jauh[,strategi_jarak jauh,...]
Tag:execution
,host_machine_resource_optimizations
--experimental_docker_image=<a string>
default: ""-
Tentukan nama image Docker (misalnya, "ubuntu:latest") yang harus digunakan untuk menjalankan tindakan dalam sandbox saat menggunakan strategi docker, dan tindakan tersebut belum memiliki atribut image container-nya di remote_execution_properties dalam deskripsi platform. Nilai flag ini diteruskan kata demi kata ke 'docker run', sehingga mendukung sintaksis dan mekanisme yang sama dengan Docker itu sendiri.
Tag:execution
--[no]experimental_docker_use_customized_images
default: "true"-
Jika diaktifkan, masukkan uid dan gid pengguna saat ini ke image Docker sebelum menggunakannya. Hal ini diperlukan jika build / pengujian Anda bergantung pada pengguna yang memiliki nama dan direktori beranda di dalam container. Fitur ini aktif secara default, tetapi Anda dapat menonaktifkannya jika fitur penyesuaian gambar otomatis tidak berfungsi atau Anda tahu bahwa Anda tidak memerlukannya.
Tag:execution
--[no]experimental_dynamic_exclude_tools
default: "true"-
Jika ditetapkan, target yang dibuat "untuk alat" tidak tunduk pada eksekusi dinamis. Target tersebut sangat tidak mungkin dibangun secara bertahap, sehingga tidak sepadan dengan siklus lokal yang dijalankan.
Tag:execution
,host_machine_resource_optimizations
--experimental_dynamic_local_load_factor=<a double>
default: "0"-
Mengontrol jumlah beban dari eksekusi dinamis yang akan dimasukkan di mesin lokal. Flag ini menyesuaikan jumlah tindakan dalam eksekusi dinamis yang akan kami jadwalkan secara serentak. Ini didasarkan pada jumlah CPU yang dianggap Blaze tersedia, yang dapat dikontrol dengan tanda --local_cpu_resources.
Jika flag ini bernilai 0, semua tindakan akan segera dijadwalkan secara lokal. Jika > 0, jumlah tindakan yang dijadwalkan secara lokal dibatasi oleh jumlah CPU yang tersedia. Jika < 1, faktor beban digunakan untuk mengurangi jumlah tindakan yang dijadwalkan secara lokal ketika jumlah tindakan yang menunggu untuk dijadwalkan tinggi. Hal ini mengurangi beban pada mesin lokal dalam kasus build bersih, di mana mesin lokal tidak terlalu berkontribusi.
Tag:execution
,host_machine_resource_optimizations
--experimental_dynamic_slow_remote_time=<An immutable length of time.>
default: "0"-
Jika >0, waktu tindakan yang dijalankan secara dinamis harus berjalan dari jarak jauh hanya sebelum kita memprioritaskan eksekusi lokalnya untuk menghindari waktu tunggu jarak jauh. Hal ini dapat menyembunyikan beberapa masalah pada sistem eksekusi jarak jauh. Jangan mengaktifkannya tanpa memantau masalah eksekusi jarak jauh.
Tag:execution
,host_machine_resource_optimizations
--[no]experimental_enable_docker_sandbox
default: "salah"-
Aktifkan sandbox berbasis Docker. Opsi ini tidak berpengaruh jika Docker tidak diinstal.
Tag:execution
- Default
--experimental_sandbox_async_tree_delete_idle_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "4" -
Jika 0, hapus hierarki sandbox segera setelah tindakan selesai (yang menyebabkan penyelesaian tindakan tertunda). Jika lebih besar dari nol, jalankan penghapusan bertiga tersebut pada pool thread asinkron yang memiliki ukuran 1 saat build berjalan dan bertambah ke ukuran yang ditentukan oleh flag ini saat server sedang tidak ada aktivitas.
Tag:host_machine_resource_optimizations
,execution
--experimental_sandbox_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
default: "0"-
Jika > 0, setiap sandbox Linux akan dibatasi sesuai jumlah memori yang ditentukan (dalam MB). Memerlukan cgroups v1 atau v2 dan izin untuk pengguna ke direktori cgroups.
Tag:execution
--[no]experimental_shrink_worker_pool
default: "salah"-
Jika diaktifkan, dapat menyusutkan kumpulan pekerja jika tekanan memori pekerja tinggi. Tanda ini hanya berfungsi jika tanda experiment_total_worker_memory_limit_mb diaktifkan.
Tag:execution
,host_machine_resource_optimizations
--[no]experimental_split_xml_generation
default: "true"-
Jika flag ini ditetapkan, dan tindakan pengujian tidak menghasilkan file test.xml, maka Bazel akan menggunakan tindakan terpisah untuk membuat file dummy test.xml yang berisi log pengujian. Jika tidak, Bazel akan menghasilkan test.xml sebagai bagian dari tindakan pengujian.
Tag:execution
--experimental_total_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
default: "0"-
Jika batas ini lebih besar dari nol pekerja tidak ada aktivitas dapat dihentikan jika total penggunaan memori semua pekerja melebihi batas.
Tag:execution
,host_machine_resource_optimizations
--[no]experimental_use_hermetic_linux_sandbox
default: "salah"-
Jika disetel ke benar (true), jangan memasang root, hanya pasang root yang disediakan dengan sandbox_add_mount_pair. File input akan dijadikan hardlink ke sandbox, bukan di-symlink dari sandbox. Jika file input tindakan berada di sistem file yang berbeda dengan sandbox, file input akan disalin.
Tag:execution
--[no]experimental_use_semaphore_for_jobs
default: "true"-
Jika disetel ke benar (true), gunakan juga semafor untuk membatasi jumlah tugas serentak.
Tag:host_machine_resource_optimizations
,execution
--[no]experimental_use_windows_sandbox
default: "salah"-
Gunakan sandbox Windows untuk menjalankan tindakan. Jika "yes", biner yang diberikan oleh --experimental_windows_sandbox_path harus valid dan sesuai dengan versi sandboxfs yang didukung. Jika "auto", biner mungkin hilang atau tidak kompatibel.
Tag:execution
--experimental_windows_sandbox_path=<a string>
default: "BazelSandbox.exe"-
Jalur ke biner sandbox Windows yang akan digunakan jika --experimental_use_windows_sandbox benar. Jika nama sederhana, gunakan biner pertama dari nama tersebut yang ditemukan dalam PATH.
Tag:execution
--experimental_worker_allowlist=<comma-separated set of options>
default: lihat deskripsi-
Jika tidak kosong, hanya izinkan penggunaan pekerja persisten dengan mnemonik kunci pekerja yang ditentukan.
Tag:execution
,host_machine_resource_optimizations
--[no]experimental_worker_as_resource
default: "true"-
Tanpa pengoperasian, akan segera dihapus.
Tag:no_op
--[no]experimental_worker_cancellation
default: "salah"-
Jika diaktifkan, Bazel dapat mengirimkan permintaan pembatalan ke pekerja yang mendukung mereka.
Tag:execution
--experimental_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
default: "0"-
Jika batas ini lebih besar dari nol, pekerja dapat dihentikan jika penggunaan memori pekerja melebihi batas. Jika tidak digunakan bersama dengan eksekusi dinamis dan `--experimental_dynamic_ignore_local_signals=9`, build Anda error.
Tag:execution
,host_machine_resource_optimizations
- Default
--experimental_worker_metrics_poll_interval=<An immutable length of time.>
: "5s" -
Interval antara mengumpulkan metrik pekerja dan kemungkinan upaya penghapusan. Tidak boleh secara efektif kurang dari 1 untuk alasan performa.
Tag:execution
,host_machine_resource_optimizations
--[no]experimental_worker_multiplex_sandboxing
default: "salah"-
Jika diaktifkan, pekerja multipleks akan di-sandbox menggunakan direktori sandbox terpisah per permintaan tugas. Hanya pekerja yang memiliki persyaratan eksekusi 'supports-multiplex-sandboxing' yang akan di-sandbox.
Tag:execution
--[no]experimental_worker_sandbox_hardening
default: "salah"-
Jika diaktifkan, pekerja akan dijalankan di sandbox yang telah melalui proses hardening, jika implementasinya mengizinkannya.
Tag:execution
--[no]experimental_worker_strict_flagfiles
default: "salah"-
Jika diaktifkan, argumen tindakan untuk pekerja yang tidak mengikuti spesifikasi pekerja akan menyebabkan error. Argumen pekerja harus memiliki tepat satu argumen @flagfile sebagai yang terakhir dari daftar argumennya.
Tag:execution
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang yang ditempati (0-100) dan di atas batas tersebut, GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika ditetapkan ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
--genrule_strategy=<comma-separated list of options>
default: ""-
Menentukan cara menjalankan genrules. Tanda ini akan dihentikan. Sebagai gantinya, gunakan --spawn_strategy=<value> untuk mengontrol semua tindakan atau --strategy=Genrule=<value> untuk mengontrol genrules saja.
Tag:execution
--high_priority_workers=<a string>
beberapa penggunaan diakumulasikan-
Tanpa pengoperasian, akan segera dihapus.
Tag:execution
--[no]incompatible_remote_dangling_symlinks
default: "true"-
Jika disetel ke benar (true), symlink yang diupload ke cache disk atau jarak jauh akan diizinkan untuk menjuntai.
Tag:execution
,incompatible_change
--[no]incompatible_remote_symlinks
default: "true"-
Jika disetel ke benar (true), Bazel akan selalu mengupload symlink seperti itu ke cache disk atau jarak jauh. Jika tidak, symlink relatif yang tidak bergerak (dan hanya symlink) yang akan diupload sebagai file atau direktori yang dituju.
Tag:execution
,incompatible_change
--[no]incompatible_sandbox_hermetic_tmp
default: "true"-
Jika disetel ke benar (true), setiap sandbox Linux akan memiliki direktori kosong khusus yang terpasang sebagai /tmp, bukan membagikan /tmp ke sistem file host. Gunakan --sandbox_add_mount_pair=/tmp untuk terus melihat /tmp host di semua sandbox.
Tag:execution
--[no]internal_spawn_scheduler
default: "salah"-
Opsi placeholder agar kita dapat mengetahui di Blaze apakah penjadwal spawn diaktifkan.
Tag:execution
,host_machine_resource_optimizations
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] default: "otomatis"-
Jumlah tugas serentak yang akan dijalankan. Memerlukan bilangan bulat, atau kata kunci ("otomatis", "HOST_CPUS", "HOST_RAM"), dapat diikuti dengan operasi ([-|*]<float>) misalnya, "otomatis", "HOST_CPUS*.5". Nilai harus antara 1 dan 5.000. Nilai di atas 2500 dapat menyebabkan masalah memori. "auto" menghitung {i>default<i} yang wajar
berdasarkan sumber daya {i>host<i}.
Tag:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] default: "salah"-
Lanjutkan sebanyak mungkin setelah error. Meskipun target yang gagal dan yang bergantung pada target tersebut tidak dapat dianalisis, prasyarat lain dari target tersebut dapat berupa.
Tag: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">
default: "otomatis"-
Jumlah thread paralel yang digunakan untuk fase pemuatan/analisis. Mengambil bilangan bulat, atau kata kunci ("otomatis", "HOST_CPUS", "HOST_RAM"), dapat diikuti dengan operasi ([-|*]<float>) misalnya, "otomatis", "HOST_CPUS*.5". "{i>auto" <i}menetapkan {i>default<i} yang wajar
berdasarkan sumber daya {i>host<i}. Minimal harus 1.
Tag:bazel_internal_configuration
--[no]reuse_sandbox_directories
default: "true"-
Jika ditetapkan ke benar (true), direktori yang digunakan oleh eksekusi non-pekerja dengan sandbox dapat digunakan kembali untuk menghindari biaya penyiapan yang tidak perlu.
Tag:host_machine_resource_optimizations
,execution
--sandbox_base=<a string>
default: ""-
Memungkinkan sandbox membuat direktori sandbox di bawah jalur ini. Tentukan jalur di tmpfs (seperti /run/shm) untuk kemungkinan meningkatkan performa saat build / pengujian Anda memiliki banyak file input. Catatan: Anda memerlukan RAM yang cukup dan ruang kosong pada tmpfs untuk menyimpan output dan file perantara yang dihasilkan dengan menjalankan tindakan.
Tag:host_machine_resource_optimizations
,execution
--[no]sandbox_explicit_pseudoterminal
default: "salah"-
Mengaktifkan pembuatan pseudoterminal untuk tindakan dalam sandbox secara eksplisit. Beberapa distribusi Linux mengharuskan id grup proses ke 'tty' di dalam sandbox agar pseudoterminal dapat berfungsi. Jika menyebabkan masalah, tanda ini dapat dinonaktifkan agar grup lain dapat digunakan.
Tag:execution
--sandbox_tmpfs_path=<an absolute path>
beberapa penggunaan diakumulasikan-
Untuk tindakan dalam sandbox, pasang direktori kosong yang dapat ditulis di jalur absolut ini (jika didukung oleh implementasi sandbox, abaikan sebaliknya).
Tag:host_machine_resource_optimizations
,execution
--[no]skip_incompatible_explicit_targets
default: "salah"-
Lewati target tidak kompatibel yang dicantumkan secara eksplisit di command line. Secara default, membuat target tersebut akan menghasilkan error, tetapi target tersebut akan dilewati tanpa pemberitahuan saat opsi ini diaktifkan. Lihat: https://bazel.build/extending/platforms#skipping-incompatible-targets
Tag:loading_and_analysis
--spawn_strategy=<comma-separated list of options>
default: ""-
Menentukan cara tindakan spawn dijalankan secara default. Menerima daftar strategi yang dipisahkan koma dari prioritas tertinggi hingga terendah. Untuk setiap tindakan, Bazel memilih strategi dengan prioritas tertinggi yang dapat menjalankan tindakan. Nilai defaultnya adalah "remote,worker,sandboxed,local". Lihat https://blog.bazel.build/2019/06/19/list-strategy.html untuk mengetahui detailnya.
Tag:execution
--strategy=<a '[name=]value1[,..,valueN]' assignment>
beberapa penggunaan diakumulasikan-
Menentukan cara mendistribusikan kompilasi tindakan spawn lainnya. Menerima daftar strategi yang dipisahkan koma dari prioritas tertinggi hingga terendah. Untuk setiap tindakan, Bazel memilih strategi dengan prioritas tertinggi yang dapat menjalankan tindakan. Nilai defaultnya adalah "remote,worker,sandboxed,local". Tanda ini mengganti nilai yang ditetapkan oleh --spawn_strategy (dan --genrule_strategy jika digunakan dengan Genrule mnemonic). Lihat https://blog.bazel.build/2019/06/19/list-strategy.html untuk mengetahui detailnya.
Tag:execution
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
beberapa penggunaan diakumulasikan-
Mengganti strategi spawn yang harus digunakan untuk menjalankan tindakan spawn yang memiliki deskripsi yang cocok dengan regex_filter tertentu. Lihat --per_file_copt untuk mengetahui detail pencocokan onregex_filter. regex_filter terakhir yang cocok dengan deskripsi akan digunakan. Opsi ini menggantikan tanda lain untuk menentukan strategi. Contoh: --strategy_regexp=//foo.*\.cc,-//foo/bar=local berarti menjalankan tindakan menggunakan strategi lokal jika deskripsinya cocok dengan //foo.*.cc, tetapi bukan //foo/bar. Contoh: --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed akan menjalankan 'Mengompilasi //foo/bar/baz' dengan strategi 'local', namun membalik urutan akan menjalankannya dengan 'sandbox'.
Tag:execution
--worker_extra_flag=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan-
Flag perintah tambahan yang akan diteruskan ke proses pekerja selain --persistent_worker, yang dikunci oleh mnemonic (misalnya --worker_extra_flag=Javac=--debug.
Tag: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">
beberapa penggunaan diakumulasikan-
Berapa banyak instance dari setiap jenis pekerja persisten yang dapat diluncurkan jika Anda menggunakan strategi 'pekerja'. Dapat ditentukan sebagai [name=value] untuk memberikan nilai per mnemonik yang berbeda. Batasnya didasarkan pada kunci pekerja, yang dibedakan berdasarkan mnemonik, serta berdasarkan flag dan lingkungan startup, sehingga dalam beberapa kasus mungkin lebih banyak pekerja per mnemonik daripada yang ditentukan oleh flag ini. Memerlukan bilangan bulat, atau kata kunci ("otomatis", "HOST_CPUS", "HOST_RAM"), dapat diikuti dengan operasi ([-|*]<float>) misalnya, "otomatis", "HOST_CPUS*.5". 'auto' menghitung nilai default yang wajar berdasarkan kapasitas mesin. "=value" menetapkan default untuk mnemonik yang tidak ditentukan.
Tag: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">
beberapa penggunaan diakumulasikan-
Berapa banyak WorkRequests yang dapat diterima proses pekerja multipleks secara paralel jika Anda menggunakan strategi 'pekerja' dengan --worker_multiplex. Dapat ditentukan sebagai [name=value] untuk memberikan nilai per mnemonik yang berbeda. Batasnya didasarkan pada kunci pekerja, yang dibedakan berdasarkan mnemonik, serta berdasarkan flag dan lingkungan startup, sehingga dalam beberapa kasus mungkin lebih banyak pekerja per mnemonik daripada yang ditentukan oleh flag ini. Memerlukan bilangan bulat, atau kata kunci ("otomatis", "HOST_CPUS", "HOST_RAM"), dapat diikuti dengan operasi ([-|*]<float>) misalnya, "otomatis", "HOST_CPUS*.5". 'auto' menghitung nilai default yang wajar berdasarkan kapasitas mesin. "=value" menetapkan default untuk mnemonik yang tidak ditentukan.
Tag:execution
,host_machine_resource_optimizations
--[no]worker_multiplex
default: "true"-
Jika diaktifkan, pekerja akan menggunakan multipleksing jika mereka mendukungnya.
Tag:execution
,host_machine_resource_optimizations
--[no]worker_quit_after_build
default: "salah"-
Jika diaktifkan, semua pekerja akan berhenti setelah proses build selesai.
Tag:execution
,host_machine_resource_optimizations
--[no]worker_sandboxing
default: "salah"-
Jika diaktifkan, pekerja akan dijalankan di lingkungan dalam sandbox.
Tag:execution
--[no]worker_verbose
default: "salah"- Jika diaktifkan, pesan panjang akan dicetak saat pekerja dimulai, penonaktifan, ...
- Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
--target_platform_fallback=<a string>
default: ""-
Opsi ini tidak digunakan lagi dan tidak berpengaruh.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
- Opsi yang mengontrol output perintah:
--[no]build
default: "true"-
Jalankan build; ini adalah perilaku yang biasa. Menentukan --nobuild menyebabkan build berhenti sebelum mengeksekusi tindakan build, menampilkan nol jika fase pemuatan dan analisis paket berhasil diselesaikan; mode ini berguna untuk menguji fase tersebut.
Tag:execution
,affects_outputs
--[no]experimental_use_validation_aspect
default: "salah"-
Apakah akan menjalankan tindakan validasi menggunakan aspek (untuk paralelisme dengan pengujian).
Tag:execution
,affects_outputs
--output_groups=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar nama grup output yang dipisahkan dengan koma, yang masing-masing dapat diawali dengan + atau -. Grup yang diawali dengan + akan ditambahkan ke kumpulan default grup output, sedangkan grup yang diawali dengan - akan dihapus dari kumpulan default. Jika setidaknya satu grup tidak diberi awalan, kumpulan default grup output akan dihilangkan. Misalnya, --output_groups=+foo,+bar membangun penyatuan dari set, foo, dan bar default, sedangkan --output_groups=foo,bar menggantikan set default sehingga hanya foo dan bar yang dibuat.
Tag:execution
,affects_outputs
--[no]run_validations
default: "true"-
Apakah akan menjalankan tindakan validasi sebagai bagian dari build. Lihat https://bazel.build/extending/rules#validation_actions
Tag:execution
,affects_outputs
- Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, yang memengaruhi nilainya, bukan keberadaannya:
--aspects=<comma-separated list of options>
beberapa penggunaan diakumulasikan- Daftar aspek yang dipisahkan koma yang akan diterapkan ke target tingkat teratas. Dalam daftar, jika aspek some_aspect menentukan penyedia aspek yang diperlukan melalui required_aspect_providers, some_aspect akan berjalan setelah setiap aspek yang disebutkan sebelumnya dalam daftar aspek dengan penyedia yang diiklankan memenuhi penyedia aspek yang diperlukan some_aspect. Selain itu, some_aspect akan berjalan setelah semua aspek yang diperlukan ditentukan oleh atribut required. some_aspect kemudian akan memiliki akses ke nilai penyedia aspek tersebut. <bzl-file-label>%<aspect_name>, misalnya '//tools:my_def.bzl%my_aspect', dengan 'my_aspect' adalah nilai level teratas dari file tools/my_def.bzl
- Default
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
Jumlah maksimum file terbuka yang diizinkan selama upload artefak BEP.
Tag:affects_outputs
--[no]experimental_convenience_symlinks
default: "normal"-
Tanda ini mengontrol cara symlink praktis (symlink yang muncul di ruang kerja setelah build) untuk dikelola. Nilai yang memungkinkan:
normal (default): Setiap jenis symlink kemudahan akan dibuat atau dihapus, sebagaimana ditentukan oleh build.
bersih: Semua symlink akan dihapus tanpa syarat.
abaikan: Symlink akan dibiarkan sendiri.
log_only: Membuat pesan log seolah-olah 'normal' diteruskan, tetapi sebenarnya tidak melakukan operasi sistem file apa pun (berguna untuk alat).
Perhatikan bahwa hanya symlink yang namanya dihasilkan oleh nilai --symlink_prefix saat ini yang dapat terpengaruh; jika awalan berubah, symlink yang sudah ada sebelumnya akan dibiarkan saja.
Tag:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
default: "salah"-
Flag ini mengontrol apakah kita akan memposting peristiwa buildKemudahanSymlinksIdentified ke BuildEventProtocol atau tidak. Jika nilainya benar, BuildEventProtocol akan memiliki entri untuk uniqueSymlinksIdentified, yang mencantumkan semua symlink praktis yang dibuat di ruang kerja Anda. Jika salah (false), entri minimarketSymlinksIdentified di BuildEventProtocol akan kosong.
Tag:affects_outputs
--remote_download_all
-
Mendownload semua output jarak jauh ke mesin lokal. Tanda ini adalah alias untuk --remote_download_outputs=all.
Diluaskan ke:
--remote_download_outputs=all
Tag:affects_outputs
--remote_download_minimal
-
Tidak mendownload output build jarak jauh ke mesin lokal. Tanda ini adalah alias untuk --remote_download_outputs=minimal.
Diluaskan ke:
--remote_download_outputs=minimal
Tag:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
default: "level atas"-
Jika disetel ke 'minimal', output build jarak jauh tidak akan didownload ke mesin lokal, kecuali output yang diperlukan oleh tindakan lokal. Jika disetel ke 'toplevel', perilakunya seperti'minimal' kecuali bahwa output target tingkat atas juga didownload ke mesin lokal. Kedua opsi tersebut dapat secara signifikan mengurangi waktu build jika bandwidth jaringan menjadi bottleneck.
Tag:affects_outputs
--remote_download_symlink_template=<a string>
default: ""-
Buat link simbolis, bukan mendownload output build jarak jauh ke mesin lokal. Target link simbolis dapat ditentukan dalam bentuk string template. String template ini masing-masing dapat berisi {hash} dan {size_bytes} yang diperluas ke hash objek dan ukurannya dalam byte. Link simbolis ini dapat, misalnya, mengarah ke sistem file FUSE yang memuat objek dari CAS sesuai permintaan.
Tag:affects_outputs
--remote_download_toplevel
-
Hanya mendownload output jarak jauh dari target level teratas ke mesin lokal. Tanda ini adalah alias untuk --remote_download_outputs=toplevel.
Diluaskan ke:
--remote_download_outputs=toplevel
Tag:affects_outputs
--symlink_prefix=<a string>
default: lihat deskripsi-
Awalan yang ditambahkan ke symlink praktis yang dibuat setelah build. Jika dihilangkan, nilai defaultnya adalah nama alat build yang diikuti dengan tanda hubung. Jika '/' diteruskan, tidak ada symlink yang dibuat dan tidak ada peringatan yang dimunculkan. Peringatan: fungsi khusus untuk '/' tidak akan digunakan lagi dalam waktu dekat; sebagai gantinya, gunakan --experimental_convenience_symlinks=ignore.
Tag:affects_outputs
- Opsi yang memengaruhi seberapa ketat Bazel dalam menerapkan input build yang valid (definisi aturan, kombinasi flag, dll.):
--[no]experimental_docker_privileged
default: "salah"-
Jika diaktifkan, Bazel akan meneruskan flag --privileged, ke 'docker run' saat menjalankan tindakan. Hal ini mungkin diperlukan oleh build Anda, tetapi juga dapat menyebabkan berkurangnya hermetisitas.
Tag:execution
--[no]experimental_sandboxfs_map_symlink_targets
default: "salah"-
Tanpa pengoperasian
Tag:host_machine_resource_optimizations
,execution
--[no]incompatible_legacy_local_fallback
default: "salah"-
Jika disetel ke benar (true), penggantian implisit lama akan diaktifkan dari strategi dengan sandbox ke strategi lokal. Tanda ini pada akhirnya akan ditetapkan secara default ke salah (false) dan kemudian menjadi tanpa pengoperasian. Sebagai gantinya, gunakan --strategy, --spawn_strategy, atau --dynamic_local_strategy untuk mengonfigurasi penggantian.
Tag:execution
,incompatible_change
--sandbox_add_mount_pair=<a single path or a 'source:target' pair>
beberapa penggunaan diakumulasikan-
Menambahkan pasangan jalur tambahan yang akan dipasang di sandbox.
Tag:execution
--sandbox_block_path=<a string>
beberapa penggunaan diakumulasikan-
Untuk tindakan yang di-sandbox, larang akses ke jalur ini.
Tag:execution
--[no]sandbox_default_allow_network
default: "true"-
Izinkan akses jaringan secara default untuk tindakan; setelan ini mungkin tidak berfungsi pada semua implementasi sandbox.
Tag:execution
--[no]sandbox_fake_hostname
default: "salah"-
Ubah nama host saat ini menjadi 'localhost' untuk tindakan dalam sandbox.
Tag:execution
--[no]sandbox_fake_username
default: "salah"-
Ubah nama pengguna saat ini menjadi 'nobody' untuk tindakan dalam sandbox.
Tag:execution
--sandbox_writable_path=<a string>
beberapa penggunaan diakumulasikan-
Untuk tindakan dalam sandbox, buat direktori yang ada dapat ditulis di sandbox (jika didukung oleh implementasi sandbox, abaikan jika tidak).
Tag:execution
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
default: "salah"-
Jika incompatible_enforce_config_setting_visi=false, berarti noop. Selain itu, jika tanda ini bernilai salah, config_setting apa pun yang tidak memiliki atribut visibilitas eksplisit akan menjadi //visibility:public. Jika tanda ini bernilai benar, config_setting mengikuti logika visibilitas yang sama seperti semua aturan lainnya. Lihat https://github.com/bazelbuild/bazel/issues/12933.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_depset_for_java_output_source_jars
default: "true"-
Tanpa pengoperasian.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
default: "true"-
Jika true, terapkan batasan visibilitas config_setting. Jika false, setiap config_setting terlihat oleh setiap target. Lihat https://github.com/bazelbuild/bazel/issues/12932.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]separate_aspect_deps
default: "true"-
Tanpa pengoperasian
Tag:no_op
- Opsi yang mengatur perilaku lingkungan pengujian atau runner pengujian:
--[no]check_tests_up_to_date
default: "salah"-
Jangan menjalankan pengujian, tetapi cukup periksa apakah pengujian tersebut sudah yang terbaru. Jika semua hasil pengujian merupakan yang terbaru, pengujian akan berhasil diselesaikan. Jika pengujian perlu dibuat atau dijalankan, error akan dilaporkan dan pengujian akan gagal. Opsi ini menyiratkan perilaku --check_up_to_date.
Tag:execution
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
beberapa penggunaan diakumulasikan-
Setiap pengujian akan dicoba ulang hingga jumlah yang ditentukan jika terjadi kegagalan pengujian. Pengujian yang memerlukan lebih dari satu upaya untuk lulus ditandai sebagai 'FLAKY' dalam ringkasan pengujian. Biasanya nilai yang ditentukan hanya berupa bilangan bulat atau string 'default'. Jika berupa bilangan bulat, semua pengujian akan dijalankan hingga N kali. Jika 'default', hanya satu upaya pengujian yang akan dibuat untuk pengujian reguler dan tiga untuk pengujian yang secara eksplisit ditandai sebagai tidak stabil oleh aturannya (atribut tidak stabil=1). Sintaksis alternatif: regex_filter@flaky_test_attempts. Di mana flaky_test_attempts seperti di atas dan regex_filter adalah singkatan dari daftar pola sertakan dan kecualikan ekspresi reguler (Lihat juga --runs_per_test ). Contoh: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 men-deflakes semua pengujian di //foo/ kecuali yang berada di bawah foo/bar tiga kali. Opsi ini dapat diteruskan beberapa kali. Argumen yang terakhir diteruskan yang cocok akan diprioritaskan. Jika tidak ada yang cocok, perilakunya adalah seolah-olah 'default' di atas.
Tag: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">
default: "otomatis"-
Jumlah maksimum tugas pengujian lokal yang akan dijalankan secara serentak. Memerlukan bilangan bulat, atau kata kunci ("otomatis", "HOST_CPUS", "HOST_RAM"), dapat diikuti dengan operasi ([-|*]<float>) misalnya, "otomatis", "HOST_CPUS*.5". 0 berarti resource lokal akan membatasi jumlah tugas pengujian lokal yang dijalankan secara serentak. Menetapkan nilai ini lebih besar daripada nilai untuk --jobs tidak akan efektif.
Tag:execution
--[no]test_keep_going
default: "true"-
Jika dinonaktifkan, pengujian yang tidak lulus akan menyebabkan seluruh build dihentikan. Secara default, semua pengujian dijalankan, meskipun beberapa pengujian tidak lulus.
Tag:execution
--test_strategy=<a string>
default: ""-
Menentukan strategi yang akan digunakan saat menjalankan pengujian.
Tag:execution
--test_tmpdir=<a path>
default: lihat deskripsi- Menentukan direktori sementara dasar untuk digunakan oleh 'bazel test'.
- Opsi yang berkaitan dengan output kueri dan semantik:
--[no]experimental_parallel_aquery_output
default: "true"- Tanpa pengoperasian.
- Opsi yang berkaitan dengan semantik dan output Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan yanked di registry tempatnya berasal (jika bukan berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yanked yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Periksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan jika ketidakcocokan terdeteksi.
Tag:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
default: "peringatan"-
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan dalam modul root adalah versi yang sama dengan yang Anda dapatkan dalam grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasikannya ke kegagalan resolusi.
Tag:loading_and_analysis
--[no]ignore_dev_dependency
default: "salah"-
Jika true (benar), Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan dalam MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "update"-
Menentukan bagaimana dan apakah menggunakan lockfile atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `error` untuk menggunakan lockfile tetapi menampilkan error jika file tidak diperbarui, atau `off` tidak membaca atau menulis ke lockfile.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <module name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan merupakan jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
--vendor_dir=<a path>
default: lihat deskripsi-
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat membangun. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--cache_computed_file_digests=<a long integer>
: "50000" - Jika lebih besar dari 0, konfigurasi Bazel akan meng-cache ringkasan file dalam memori berdasarkan metadatanya, bukan menghitung ulang ringkasan dari disk setiap kali diperlukan. Menyetel ini ke 0 akan memastikan ketepatan karena tidak semua perubahan file dapat dicatat dari metadata file. Jika bukan 0, angka tersebut menunjukkan ukuran cache karena jumlah ringkasan file yang akan di-cache.
--experimental_dynamic_ignore_local_signals=<a comma-separated list of signal numbers>
default: lihat deskripsi-
Mengambil daftar nomor sinyal OS. Jika cabang lokal dari eksekusi dinamis terhenti dengan salah satu sinyal ini, cabang jarak jauh akan diizinkan untuk menyelesaikannya. Untuk pekerja persisten, hal ini hanya memengaruhi sinyal yang menghentikan proses pekerja.
Tag:execution
--[no]experimental_enable_skyfocus
default: "salah"-
Jika true (benar), aktifkan penggunaan --experimental_working_set guna mengurangi jejak memori Bazel untuk build inkremental. Fitur ini dikenal sebagai Skyfocus.
Tag:host_machine_resource_optimizations
--experimental_working_set=<comma-separated list of options>
default: ""-
Working set untuk Skyfocus. Tetapkan sebagai jalur root-relatif ruang kerja yang dipisahkan koma. Ini adalah flag stateful. Penentuan set yang berfungsi akan mempertahankannya untuk pemanggilan berikutnya, hingga ditetapkan ulang dengan set baru.
Tag:host_machine_resource_optimizations
- Default
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "1 dtk:2,20 dtk:3,1 m:5" -
Batas yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlah berupa bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap generasi lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan dengan koma.
Tag:host_machine_resource_optimizations
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
default: "HOST_CPUS"-
Tetapkan secara eksplisit jumlah total core CPU lokal yang tersedia bagi Bazel untuk dibelanjakan pada tindakan build yang dijalankan secara lokal. Mengambil integer, atau "HOST_CPUS", secara opsional diikuti oleh [-|*]<float> (mis. HOST_CPUS*.5 untuk menggunakan setengah dari core CPU yang tersedia). Secara default, ("HOST_CPUS"), Bazel akan mengkueri konfigurasi sistem untuk memperkirakan jumlah core CPU yang tersedia.
Tag:host_machine_resource_optimizations
--local_extra_resources=<a named float, 'name=value'>
beberapa penggunaan diakumulasikan-
Menetapkan jumlah resource tambahan yang tersedia untuk Bazel. Mengambil pasangan string-float. Dapat digunakan beberapa kali untuk menentukan beberapa jenis resource tambahan. Bazel akan membatasi tindakan yang berjalan serentak berdasarkan resource tambahan yang tersedia dan resource tambahan yang diperlukan. Pengujian dapat menyatakan jumlah resource tambahan yang dibutuhkan dengan menggunakan tag format "resources:<resoucename>:<amount>". CPU, RAM, dan resource yang tersedia tidak dapat disetel dengan flag ini.
Tag:host_machine_resource_optimizations
--local_ram_resources=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
default: "HOST_RAM*,67"-
Tetapkan secara eksplisit jumlah total RAM host lokal (dalam MB) yang tersedia bagi Bazel untuk dibelanjakan pada tindakan build yang dijalankan secara lokal. Memerlukan integer, atau "HOST_RAM", secara opsional diikuti oleh [-|*]<float> (mis. HOST_RAM*.5 untuk menggunakan setengah RAM yang tersedia). Secara default, ("HOST_RAM*.67"), Bazel akan mengkueri konfigurasi sistem untuk memperkirakan jumlah RAM yang tersedia dan akan menggunakan 67%-nya.
Tag:host_machine_resource_optimizations
--local_resources=<a named double, 'name=value', where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
beberapa penggunaan diakumulasikan-
Menetapkan jumlah resource yang tersedia untuk Bazel. Membawa penetapan ke float atau HOST_RAM/HOST_CPUS, secara opsional diikuti oleh [-|*]<float> (mis. memory=HOST_RAM*.5 untuk menggunakan setengah RAM yang tersedia). Dapat digunakan beberapa kali untuk menentukan beberapa jenis resource. Bazel akan membatasi tindakan yang berjalan secara serentak berdasarkan resource yang tersedia dan resource yang diperlukan. Pengujian dapat menyatakan jumlah resource yang dibutuhkan dengan menggunakan tag format "resources:<resource name>:<amount>". Mengganti resource yang ditentukan oleh --local_{cpu|ram|extra}_resources.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi ketika peristiwa GC penuh terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC kecil terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi saat peristiwa GC kecil terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan setidaknya berada pada ambang batas ini, status Skyframe sementara yang tidak perlu akan hilang. Menyesuaikan hal ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari GC thrashing, jika GC thrashing (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada menyusun ulang status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
- Default
--build_event_upload_max_retries=<an integer>
: "4" -
Frekuensi maksimum Bazel harus mencoba kembali mengupload peristiwa build.
Tag:bazel_internal_configuration
--[no]debug_spawn_scheduler
default: "salah"--[no]experimental_bep_target_summary
default: "salah"- Apakah akan memublikasikan peristiwa TargetSummary.
--[no]experimental_build_event_expand_filesets
default: "salah"-
Jika true (benar), luaskan Filesets di BEP saat menampilkan file output.
Tag:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
default: "salah"-
Jika true, selesaikan sepenuhnya symlink Fileset relatif di BEP saat menampilkan file output. Memerlukan --experimental_build_event_expand_filesets.
Tag:affects_outputs
- Default
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1s" -
Penundaan minimum awal untuk backoff eksponensial percobaan ulang saat upload BEP gagal. (eksponen: 1,6)
Tag:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
default: lihat deskripsi-
Memilih cara mengupload artefak yang dirujuk dalam protokol peristiwa build.
Tag:affects_outputs
--[no]experimental_collect_local_sandbox_action_metrics
default: "true"-
Tanpa pengoperasian yang tidak digunakan lagi.
Tag:execution
--experimental_command_profile=<cpu, wall, alloc or lock>
default: lihat deskripsi- Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alokasi, atau kunci) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa di bawah direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; penggunaan dengan risiko Anda sendiri.
--[no]experimental_docker_verbose
default: "salah"-
Jika diaktifkan, Bazel akan mencetak pesan yang lebih panjang tentang strategi sandbox Docker.
Tag:execution
--[no]experimental_materialize_param_files_directly
default: "salah"-
Jika mewujud file parameter, lakukan dengan penulisan langsung ke disk.
Tag:execution
--[no]experimental_record_metrics_for_all_mnemonics
default: "salah"- Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
--experimental_repository_resolved_file=<a string>
default: ""-
Jika tidak kosong, tulis nilai Starlark dengan informasi yang telah diselesaikan dari semua aturan repositori Starlark yang dijalankan.
Tag:affects_outputs
--[no]experimental_run_bep_event_include_residue
default: "salah"-
Apakah akan menyertakan residu command line dalam peristiwa build run yang mungkin berisi residu tersebut. Secara default, residu tidak disertakan dalam peristiwa build perintah run yang mungkin berisi residu tersebut.
Tag:affects_outputs
- Default
--experimental_skyfocus_dump_keys=<none, count or verbose>
: "none" -
Untuk men-debug Skyfocus. Membuang SkyKeys yang difokuskan (root, leaf, dependensi terfokus, rdep terfokus).
Tag:terminal_output
--[no]experimental_skyfocus_dump_post_gc_stats
default: "salah"-
Untuk men-debug Skyfocus. Jika diaktifkan, picu GC manual sebelum/setelah berfokus untuk melaporkan pengurangan ukuran heap. Tindakan ini akan meningkatkan latensi Skyfocus.
Tag:terminal_output
--[no]experimental_stream_log_file_uploads
default: "salah"-
Streaming file log yang diupload langsung ke penyimpanan jarak jauh, bukan menulisnya ke disk.
Tag:affects_outputs
--explain=<a path>
default: lihat deskripsi-
Menyebabkan sistem build menjelaskan setiap langkah build yang dijalankan. Penjelasan ditulis ke file log yang ditentukan.
Tag:affects_outputs
--[no]ignore_unsupported_sandboxing
default: "salah"-
Jangan mencetak peringatan jika eksekusi dengan sandbox tidak didukung pada sistem ini.
Tag:terminal_output
--[no]legacy_important_outputs
default: "true"-
Gunakan ini untuk menyembunyikan pembuatan kolom important_outputs lama di peristiwa TargetComplete. important_outputs diperlukan untuk integrasi Bazel ke ResultStore.
Tag:affects_outputs
--[no]materialize_param_files
default: "salah"-
Menulis file parameter perantara ke hierarki output bahkan saat menggunakan eksekusi tindakan jarak jauh. Berguna saat men-debug tindakan. Hal ini tersirat oleh --subcommands dan --verbose_failures.
Tag:execution
--max_config_changes_to_show=<an integer>
default: "3"-
Saat menghapus cache analisis karena perubahan pada opsi build, cache analisis ditampilkan hingga jumlah nama opsi yang diubah. Jika angka yang diberikan adalah -1, semua opsi yang diubah akan ditampilkan.
Tag:terminal_output
- Default
--max_test_output_bytes=<an integer>
: "-1" -
Menentukan ukuran log per-pengujian maksimum yang dapat ditampilkan saat --test_output adalah 'errors' atau 'all'. Berguna untuk menghindari membebani output dengan output pengujian yang berisi terlalu banyak noise. Header pengujian disertakan dalam ukuran log. Nilai negatif menyiratkan tidak ada batas. Outputnya semuanya atau tidak ada sama sekali.
Tag:test_runner
,terminal_output
,execution
--output_filter=<a valid Java regular expression>
default: lihat deskripsi-
Hanya menampilkan peringatan dan output tindakan untuk aturan dengan nama yang cocok dengan ekspresi reguler yang disediakan.
Tag:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
default: "0"-
Jumlah detik untuk menunggu antarlaporan tentang tugas yang masih berjalan. Nilai default 0 berarti laporan pertama akan dicetak setelah 10 detik, lalu 30 detik dan setelah progres tersebut dilaporkan sekali setiap menit. Saat --curses diaktifkan, progres akan dilaporkan setiap detik.
Tag:affects_outputs
--remote_print_execution_messages=<failure, success or all>
default: "kegagalan"-
Pilih waktu untuk mencetak pesan eksekusi jarak jauh. Nilai yang valid adalah `kegagalan`, untuk mencetak hanya jika gagal, `berhasil` untuk mencetak hanya jika berhasil, dan `all` untuk selalu mencetak.
Tag:terminal_output
--[no]sandbox_debug
default: "salah"-
Mengaktifkan fitur proses debug untuk fitur sandbox. Hal ini mencakup dua hal: pertama, konten root sandbox tidak berubah setelah build; dan kedua, mencetak informasi proses debug tambahan saat eksekusi. Hal ini dapat membantu developer aturan Bazel atau Starlark mengalami kegagalan proses debug karena file input tidak ada, dll.
Tag:terminal_output
--show_result=<an integer>
default: "1"-
Menampilkan hasil build. Untuk setiap target, nyatakan apakah target diperbarui atau tidak, dan jika ya, daftar file output yang dibuat. File yang dicetak adalah {i>string<i} yang praktis untuk disalin+menempel ke {i>shell<i}, untuk mengeksekusinya.
Opsi ini memerlukan argumen bilangan bulat, yang merupakan jumlah nilai minimum target sehingga informasi hasil tidak dicetak. Dengan demikian, angka nol menyebabkan penyembunyian pesan dan MAX_INT menyebabkan pencetakan hasil selalu terjadi. Defaultnya adalah satu.
Jika tidak ada yang dibuat untuk target, hasilnya dapat dihilangkan agar output tetap berada di bawah nilai minimum.
Tag:affects_outputs
--[no]subcommands
[-s
] default: "salah"-
Menampilkan subperintah yang dijalankan selama proses build. Tanda terkait: --execution_log_json_file, --execution_log_binary_file (untuk logging subperintah ke file dalam format yang mudah digunakan untuk alat).
Tag:terminal_output
--test_output=<summary, errors, all or streamed>
default: "ringkasan"-
Menentukan mode output yang diinginkan. Nilai yang valid adalah 'summary' menjadi output hanya ringkasan status pengujian, 'errors' untuk juga mencetak log pengujian untuk pengujian yang gagal, 'all' untuk mencetak log untuk semua pengujian dan 'di-streaming' untuk menghasilkan log untuk semua pengujian secara real time (ini akan memaksa pengujian untuk dijalankan secara lokal satu per satu terlepas dari nilai --test_strategy).
Tag:test_runner
,terminal_output
,execution
--test_summary=<short, terse, detailed, none or testcase>
default: "short"-
Menentukan format ringkasan pengujian yang diinginkan. Nilai yang valid adalah 'short' untuk mencetak informasi hanya tentang pengujian yang dijalankan, 'terse', untuk mencetak informasi hanya tentang pengujian yang gagal yang dijalankan, 'mendetail' untuk mencetak informasi detail tentang kasus pengujian yang gagal, 'testcase' untuk mencetak ringkasan dalam resolusi kasus pengujian, jangan mencetak informasi detail tentang kasus pengujian yang gagal dan 'none' untuk menghilangkan ringkasan.
Tag:terminal_output
--[no]verbose_explanations
default: "salah"-
Meningkatkan panjang penjelasan yang dikeluarkan jika --explain diaktifkan. Tidak berpengaruh jika --explain tidak diaktifkan.
Tag:affects_outputs
--[no]verbose_failures
default: "salah"-
Jika perintah gagal, cetak command line lengkapnya.
Tag:terminal_output
- Opsi yang menentukan atau mengubah input umum ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--aspects_parameters=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan-
Menentukan nilai parameter aspek command line. Setiap nilai parameter ditentukan melalui <param_name>=<param_value>, misalnya 'my_param=my_val', dengan 'my_param' adalah parameter dari beberapa aspek dalam daftar --aspects atau diperlukan oleh sebuah aspek dalam daftar. Opsi ini dapat digunakan beberapa kali. Namun, Anda tidak boleh menetapkan nilai ke parameter yang sama lebih dari sekali.
Tag:loading_and_analysis
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika ada file yang tidak kosong, baca file yang telah ditentukan dan bukan file WORKSPACE
Tag:changes_inputs
--target_pattern_file=<a string>
default: ""-
Jika ditetapkan, build akan membaca pola dari file yang dinamai di sini, bukan dari command line. Menentukan file di sini serta pola command line merupakan suatu error.
Tag:changes_inputs
- Opsi caching dan eksekusi jarak jauh:
--experimental_circuit_breaker_strategy=<failure>
default: lihat deskripsi-
Menentukan strategi yang akan digunakan pemutus arus listrik. Strategi yang tersedia adalah "kegagalan". Pada nilai yang tidak valid untuk opsi, perilaku yang sama dengan opsi tidak ditetapkan.
Tag:execution
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file yang akan digunakan untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk cocok, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik mulai dari `$1`. Beberapa perintah `tulis ulang` untuk URL yang sama dapat diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
--[no]experimental_guard_against_concurrent_changes
default: "salah"- Nonaktifkan setelan ini untuk menonaktifkan pemeriksaan waktu atas file input suatu tindakan sebelum menguploadnya ke cache jarak jauh. Mungkin ada kasus di mana kernel Linux menunda penulisan file, yang dapat menyebabkan positif palsu (PP).
--[no]experimental_remote_cache_async
default: "salah"- Jika benar, I/O cache jarak jauh akan terjadi di latar belakang, bukan sebagai bagian dari spawn.
--experimental_remote_cache_compression_threshold=<an integer>
default: "0"- Ukuran blob minimum yang diperlukan untuk mengompresi/mendekompresi dengan zstd. Tidak efektif kecuali --remote_cache_compression disetel.
--experimental_remote_cache_eviction_retries=<an integer>
default: "0"-
Jumlah maksimum upaya percobaan ulang jika build mengalami error penghapusan cache jarak jauh. Nilai bukan nol secara implisit akan menetapkan --incompatible_remote_use_new_exit_code_for_lost_inputs ke true. ID pemanggilan baru akan dibuat untuk setiap percobaan. Jika Anda membuat ID panggilan dan memberikannya ke Bazel dengan --invocation_id, Anda tidak boleh menggunakan tanda ini. Sebagai gantinya, setel tanda --incompatible_remote_use_new_exit_code_for_lost_inputs dan periksa kode keluar 39.
Tag:execution
--[no]experimental_remote_cache_lease_extension
default: "salah"- Jika disetel ke benar (true), Bazel akan memperpanjang lease untuk output tindakan jarak jauh selama proses build dengan mengirimkan panggilan `FindMissingBlobs` secara berkala ke cache jarak jauh. Frekuensi ini didasarkan pada nilai `--experimental_remote_cache_ttl`.
- Default
--experimental_remote_cache_ttl=<An immutable length of time.>
: "3 jam" -
TTL minimal dari blob yang dijamin dalam cache jarak jauh setelah ringkasannya baru-baru ini dirujuk, misalnya oleh ActionResult atau FindMissingBlobs. Bazel melakukan beberapa pengoptimalan berdasarkan TTL blob, misalnya tidak berulang kali memanggil GetActionResult dalam build inkremental. Nilai harus ditetapkan sedikit lebih kecil dari TTL yang sebenarnya karena ada jeda antara saat server menampilkan ringkasan dan saat Bazel menerimanya.
Tag:execution
--experimental_remote_capture_corrupted_outputs=<a path>
default: lihat deskripsi- Jalur ke direktori tempat output yang rusak akan direkam.
--[no]experimental_remote_discard_merkle_trees
default: "true"- Jika disetel ke benar (true), hapus salinan pohon Merkle root input dan pemetaan input terkait dalam memori selama panggilan ke GetActionResult() dan Execute(). Tindakan ini akan mengurangi penggunaan memori secara signifikan, tetapi memerlukan Bazel untuk menghitung ulang jika cache jarak jauh tidak ditemukan dan dicoba ulang.
--experimental_remote_downloader=<a string>
default: lihat deskripsi- URI endpoint Remote Asset API, yang akan digunakan sebagai proxy download jarak jauh. Skema yang didukung adalah grpc, grpcs (grpc dengan TLS yang diaktifkan) dan unix (soket UNIX lokal). Jika tidak ada skema yang diberikan, Bazel akan ditetapkan secara default ke grpcs. Lihat: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
default: "salah"- Apakah akan beralih kembali ke downloader lokal jika downloader jarak jauh gagal.
--[no]experimental_remote_execution_keepalive
default: "salah"- Apakah akan menggunakan keepalive untuk panggilan eksekusi jarak jauh.
- Default
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
: "10" -
Menetapkan jumlah tingkat kegagalan yang diizinkan dalam persentase untuk jangka waktu tertentu setelah periode tersebut berhenti memanggil cache/eksekutor jarak jauh. Secara default, nilainya adalah 10. Menyetel ini ke 0 berarti tidak ada batasan.
Tag:execution
- Default
--experimental_remote_failure_window_interval=<An immutable length of time.>
: "60 dtk" -
Interval perhitungan tingkat kegagalan permintaan jarak jauh. Pada nilai nol atau negatif, durasi kegagalan dihitung seluruh durasi eksekusi.Unit berikut dapat digunakan: Hari (d), jam (h), menit (m), detik (dtk), dan milidetik (md). Jika unit dihilangkan, nilai akan ditafsirkan sebagai detik.
Tag:execution
--[no]experimental_remote_mark_tool_inputs
default: "salah"- Jika disetel ke benar (true), Bazel akan menandai input sebagai input alat untuk eksekutor jarak jauh. Ini dapat digunakan untuk mengimplementasikan pekerja persisten jarak jauh.
--[no]experimental_remote_merkle_tree_cache
default: "salah"- Jika ditetapkan ke true, penghitungan hierarki Merkle akan dicatat untuk meningkatkan kecepatan pemeriksaan cache jarak jauh. Jejak kaki memori cache dikontrol oleh --experimental_remote_merkle_tree_cache_size.
- Default
--experimental_remote_merkle_tree_cache_size=<a long integer>
: "1000" - Jumlah pohon Merkle yang akan direkam untuk meningkatkan kecepatan pemeriksaan cache jarak jauh. Meskipun cache secara otomatis dipangkas sesuai dengan penanganan soft reference Java, error kehabisan memori dapat terjadi jika disetel terlalu tinggi. Jika disetel ke 0, ukuran cache tidak terbatas. Nilai optimal bervariasi tergantung pada ukuran proyek. Default-nya adalah 1.000.
--experimental_remote_output_service=<a string>
default: lihat deskripsi- HOST atau HOST:PORT endpoint layanan output jarak jauh. Skema yang didukung adalah grpc, grpcs (grpc dengan TLS yang diaktifkan) dan unix (soket UNIX lokal). Jika tidak ada skema yang diberikan, Bazel akan ditetapkan secara default ke grpcs. Tentukan skema grpc:// atau unix: untuk menonaktifkan TLS.
--experimental_remote_output_service_output_path_prefix=<a string>
default: ""- Jalur tempat konten direktori output yang dikelola oleh --experimental_remote_output_service ditempatkan. Direktori output aktual yang digunakan oleh build akan menjadi turunan dari jalur ini dan ditentukan oleh layanan output.
--[no]experimental_remote_require_cached
default: "salah"- Jika disetel ke benar (true), terapkan bahwa semua tindakan yang dapat dijalankan dari jarak jauh akan di-cache, atau build akan gagal. Ini berguna untuk memecahkan masalah non-determinisme karena memungkinkan pemeriksaan apakah tindakan yang harus di-cache benar-benar di-cache tanpa memasukkan hasil baru ke dalam cache secara tidak benar.
--experimental_remote_scrubbing_config=<Converts to a Scrubber>
default: lihat deskripsi- Mengaktifkan penghapusan kunci cache jarak jauh dengan file konfigurasi yang disediakan, yang harus berupa buffering protokol dalam format teks (lihat src/main/protobuf/remote_scrubbing.proto). Fitur ini dimaksudkan untuk memfasilitasi berbagi cache jarak jauh/disk di antara tindakan yang dijalankan di platform yang berbeda tetapi menargetkan platform yang sama. Cara ini harus digunakan dengan sangat hati-hati, karena setelan yang tidak tepat dapat menyebabkan entri cache dibagikan secara tidak sengaja dan mengakibatkan build yang salah. Penggesekan tidak memengaruhi cara tindakan dieksekusi, hanya cara kunci cache jarak jauh/disk dihitung untuk tujuan mengambil atau menyimpan hasil tindakan. Tindakan yang digeser tidak kompatibel dengan eksekusi jarak jauh, dan akan selalu dijalankan secara lokal. Memodifikasi konfigurasi scrubbing tidak membatalkan output yang ada di sistem file lokal atau cache internal; build bersih diperlukan untuk mengeksekusi ulang tindakan yang terpengaruh. Agar berhasil menggunakan fitur ini, sebaiknya setel --host_platform khusus bersama dengan --experimental_platform_in_output_dir (untuk menormalkan awalan output) dan --incompatible_strict_action_env (untuk menormalisasi variabel lingkungan).
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
default: "otomatis"- Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dimulai ulang. Jika tidak, gunakan thread platform (yaitu thread OS) jika ditetapkan ke 'platform' atau thread virtual jika ditetapkan ke 'virtual'. Jika disetel ke 'auto', thread virtual akan digunakan jika tersedia (yaitu, berjalan di JDK 21+), jika tidak, thread pekerja tidak akan digunakan.
--[no]incompatible_remote_build_event_upload_respect_no_cache
default: "salah"- Tidak digunakan lagi. Tanpa pengoperasian. Gunakan --remote_build_event_upload=minimal sebagai gantinya.
--[no]incompatible_remote_downloader_send_all_headers
default: "true"-
Apakah akan mengirim semua nilai header multi-nilai ke downloader jarak jauh, bukan hanya yang pertama.
Tag:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
default: "salah"-
Jika disetel ke benar (true), jalur output akan relatif terhadap root input, bukan direktori yang berfungsi.
Tag:incompatible_change
--[no]incompatible_remote_results_ignore_disk
default: "true"-
Tanpa pengoperasian
Tag:incompatible_change
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
default: "true"-
Jika disetel ke benar (true), Bazel akan menggunakan kode keluar baru 39, bukan 34, jika cache jarak jauh mengeluarkan blob selama proses build.
Tag:incompatible_change
--[no]remote_accept_cached
default: "true"- Apakah akan menerima hasil tindakan yang di-cache dari jarak jauh.
--remote_build_event_upload=<all or minimal>
default: "minimal"- Jika ditetapkan ke 'all', semua output lokal yang dirujuk oleh BEP akan diupload ke cache jarak jauh. Jika disetel ke 'minimal', output lokal yang dirujuk oleh BEP tidak diupload ke cache jarak jauh, kecuali untuk file yang penting bagi konsumen BEP (misalnya log uji dan profil waktu). Skema bytestream:// selalu digunakan untuk uri file meskipun hilang dari cache jarak jauh. Default-nya adalah 'minimal'.
--remote_bytestream_uri_prefix=<a string>
default: lihat deskripsi- Nama host dan nama instance yang akan digunakan dalam URI bytestream:// yang ditulis ke dalam aliran peristiwa build. Opsi ini dapat disetel saat build dijalankan menggunakan proxy, yang menyebabkan nilai --remote_executor dan --remote_instance_name tidak lagi sesuai dengan nama kanonis layanan eksekusi jarak jauh. Jika tidak ditetapkan, defaultnya adalah "${nama host}/${instance_name}".
--remote_cache=<a string>
default: lihat deskripsi- URI dari endpoint caching. Skema yang didukung adalah http, https, grpc, grpcs (grpc dengan TLS yang diaktifkan) dan unix (soket UNIX lokal). Jika tidak ada skema yang diberikan, Bazel akan ditetapkan secara default ke grpcs. Tentukan skema grpc://, http://, atau unix: untuk menonaktifkan TLS. Lihat https://bazel.build/remote/caching
--[no]remote_cache_compression
default: "salah"- Jika diaktifkan, kompresi/dekompresi blob cache dengan zstd saat ukurannya setidaknya --experimental_remote_cache_compression_threshold.
--remote_cache_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan- Tentukan header yang akan disertakan dalam permintaan cache: --remote_cache_header=Name=Value. Beberapa header dapat diteruskan dengan menentukan flag beberapa kali. Beberapa nilai untuk nama yang sama akan dikonversi menjadi daftar yang dipisahkan koma.
--remote_default_exec_properties=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan-
Tetapkan properti exec default untuk digunakan sebagai platform eksekusi jarak jauh jika platform eksekusi belum menetapkan exec_properties.
Tag:affects_outputs
--remote_default_platform_properties=<a string>
default: ""- Tetapkan properti platform default agar ditetapkan untuk API eksekusi jarak jauh, jika platform eksekusi belum menetapkan remote_execution_properties. Nilai ini juga akan digunakan jika platform host dipilih sebagai platform eksekusi untuk eksekusi jarak jauh.
--remote_download_regex=<a valid Java regular expression>
beberapa penggunaan diakumulasikan-
Paksa output build jarak jauh yang jalurnya cocok dengan pola ini untuk didownload, terlepas dari --remote_download_outputs. Beberapa pola dapat ditentukan dengan mengulangi flag ini.
Tag:affects_outputs
--remote_downloader_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan- Tentukan header yang akan disertakan dalam permintaan downloader jarak jauh: --remote_downloader_header=Name=Value. Beberapa header dapat diteruskan dengan menentukan flag beberapa kali. Beberapa nilai untuk nama yang sama akan dikonversi menjadi daftar yang dipisahkan koma.
--remote_exec_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan- Tentukan header yang akan disertakan dalam permintaan eksekusi: --remote_exec_header=Name=Value. Beberapa header dapat diteruskan dengan menentukan flag beberapa kali. Beberapa nilai untuk nama yang sama akan dikonversi menjadi daftar yang dipisahkan koma.
--remote_execution_priority=<an integer>
default: "0"- Prioritas relatif tindakan yang akan dijalankan dari jarak jauh. Semantik nilai prioritas tertentu bergantung pada server.
--remote_executor=<a string>
default: lihat deskripsi- HOST atau HOST:PORT endpoint eksekusi jarak jauh. Skema yang didukung adalah grpc, grpcs (grpc dengan TLS yang diaktifkan) dan unix (soket UNIX lokal). Jika tidak ada skema yang diberikan, Bazel akan ditetapkan secara default ke grpcs. Tentukan skema grpc:// atau unix: untuk menonaktifkan TLS.
--remote_grpc_log=<a path>
default: lihat deskripsi- Jika ditentukan, jalur ke file untuk mencatat detail terkait panggilan gRPC. Log ini terdiri dari urutan protobuf com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry yang diserialisasi, dengan setiap pesan diawali oleh varint yang menunjukkan ukuran pesan protobuf serial berikut, seperti yang dilakukan oleh metode LogEntry.writeDelimitedTo(OutputStream).
--remote_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan- Tentukan header yang akan disertakan dalam permintaan: --remote_header=Name=Value. Beberapa header dapat diteruskan dengan menentukan flag beberapa kali. Beberapa nilai untuk nama yang sama akan dikonversi menjadi daftar yang dipisahkan koma.
--remote_instance_name=<a string>
default: ""- Nilai yang akan diteruskan sebagai instance_name di API eksekusi jarak jauh.
--[no]remote_local_fallback
default: "salah"- Apakah akan kembali ke strategi eksekusi lokal mandiri jika eksekusi jarak jauh gagal.
--remote_local_fallback_strategy=<a string>
default: "lokal"- Tanpa pengoperasian, tidak digunakan lagi. Lihat https://github.com/bazelbuild/bazel/issues/7480 untuk mengetahui detailnya.
- Default
--remote_max_connections=<an integer>
: "100" -
Batasi jumlah maksimum koneksi serentak ke cache/eksekutor jarak jauh. Secara default, nilainya adalah 100. Menyetel ini ke 0 berarti tidak ada batasan.
Untuk cache jarak jauh HTTP, satu koneksi TCP dapat menangani satu permintaan dalam satu waktu, sehingga Bazel dapat membuat hingga --remote_max_connections permintaan serentak.
Untuk cache/eksekutor jarak jauh gRPC, satu saluran gRPC biasanya dapat menangani 100+ permintaan serentak, sehingga Bazel dapat membuat sekitar `--remote_max_connections * 100` permintaan serentak.
Tag:host_machine_resource_optimizations
--remote_proxy=<a string>
default: lihat deskripsi- Hubungkan ke cache jarak jauh melalui proxy. Saat ini, flag ini hanya dapat digunakan untuk mengonfigurasi soket domain Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer>
default: "0"- Prioritas relatif tindakan jarak jauh yang akan disimpan dalam cache jarak jauh. Semantik nilai prioritas tertentu bergantung pada server.
- Default
--remote_retries=<an integer>
: "5" - Jumlah maksimum percobaan untuk mencoba kembali error sementara. Jika ditetapkan ke 0, percobaan ulang akan dinonaktifkan.
- Default
--remote_retry_max_delay=<An immutable length of time.>
: "5s" - Penundaan backoff maksimum di antara upaya percobaan ulang jarak jauh. Unit berikut dapat digunakan: Hari (d), jam (j), menit (m), detik (d), dan milidetik (md). Jika unit dihilangkan, nilai akan ditafsirkan sebagai detik.
- Default
--remote_timeout=<An immutable length of time.>
: "60 dtk" - Jumlah waktu maksimum untuk menunggu eksekusi jarak jauh dan panggilan cache. Untuk cache REST, ini adalah waktu tunggu koneksi dan waktu baca. Unit berikut dapat digunakan: Hari (d), jam (j), menit (m), detik (d), dan milidetik (md). Jika unit dihilangkan, nilai akan ditafsirkan sebagai detik.
--[no]remote_upload_local_results
default: "true"- Apakah akan mengupload hasil tindakan yang dijalankan secara lokal ke cache jarak jauh jika cache jarak jauh mendukungnya dan pengguna diizinkan untuk melakukannya.
--[no]remote_verify_downloads
default: "true"- Jika disetel ke benar (true), Bazel akan menghitung jumlah hash semua download jarak jauh dan menghapus nilai yang di-cache dari jarak jauh jika tidak cocok dengan nilai yang diharapkan.
- Opsi lain, yang tidak dikategorikan.:
--[no]allow_analysis_cache_discard
default: "true"-
Jika menghapus cache analisis karena perubahan pada sistem build, menyetel opsi ini ke salah (false) akan menyebabkan bazel keluar, bukan melanjutkan build. Opsi ini tidak berpengaruh jika 'discard_analysis_cache' juga ditetapkan.
Tag:eagerness_to_exit
- Default
--auto_output_filter=<none, all, packages or subpackages>
: "none" - Jika --output_filter tidak ditentukan, nilai untuk opsi ini akan digunakan untuk membuat filter secara otomatis. Nilai yang diizinkan adalah 'none' (tidak ada filter / tampilkan semuanya), 'all' (filter semuanya / tidak menampilkan apa pun), 'packages' (sertakan output dari aturan dalam paket yang disebutkan pada command line Blaze), dan 'sub-paket' (seperti 'packages', tetapi juga menyertakan sub-paket). Untuk nilai 'packages' dan 'subpackages' //java/foo dan //javatests/foo diperlakukan sebagai satu paket)'.
--[no]build_manual_tests
default: "salah"- Memaksa pembuatan target pengujian yang diberi tag 'manual'. Pengujian 'manual' dikecualikan dari pemrosesan. Opsi ini memaksanya untuk dibuat (tetapi tidak dieksekusi).
--build_tag_filters=<comma-separated list of options>
default: ""- Menentukan daftar tag yang dipisahkan koma. Secara opsional, setiap tag dapat diawali dengan '-' untuk menentukan tag yang dikecualikan. Hanya target tersebut yang akan dibuat yang berisi setidaknya satu tag yang disertakan dan tidak berisi tag yang dikecualikan. Opsi ini tidak memengaruhi serangkaian pengujian yang dijalankan dengan perintah 'test'; opsi tersebut diatur oleh opsi pemfilteran pengujian, misalnya '--test_tag_filters'
--[no]build_tests_only
default: "salah"- Jika ditentukan, hanya aturan *_test dan test_suite yang akan dibuat dan target lain yang ditentukan pada command line akan diabaikan. Secara default, semua yang diminta akan dibuat.
- Default
--combined_report=<none or lcov>
: "none" - Menentukan jenis laporan cakupan kumulatif yang diinginkan. Pada saat ini, hanya LCOV yang didukung.
--[no]compile_one_dependency
default: "salah"- Mengompilasi satu dependensi file argumen. Hal ini berguna untuk pemeriksaan sintaksis file sumber di IDE, misalnya, dengan membangun kembali satu target yang bergantung pada file sumber untuk mendeteksi error sedini mungkin dalam siklus edit/build/pengujian. Argumen ini memengaruhi penafsiran semua argumen non-flag; alih-alih menjadi target untuk build, argumen ini adalah nama file sumber. Target arbitrer yang bergantung pada nama file sumber akan dibuat untuk setiap nama file sumber.
--deleted_packages=<comma-separated list of package names>
beberapa penggunaan diakumulasikan- Daftar nama paket yang dipisahkan koma yang akan dianggap tidak ada oleh sistem build, meskipun jika paket tersebut terlihat di suatu tempat pada jalur paket. Gunakan opsi ini ketika menghapus sub-paket 'x/y' dari paket 'x' yang ada. Misalnya, setelah menghapus x/y/BUILD di klien Anda, sistem build mungkin akan mengeluh jika menemukan label '//x:y/z' jika label tersebut masih disediakan oleh entri package_path lain. Menentukan --deleted_packages x/y akan menghindari masalah ini.
--[no]discard_analysis_cache
default: "salah"- Hapus cache analisis segera setelah fase analisis selesai. Mengurangi penggunaan memori hingga ~10%, tetapi membuat build inkremental lebih lanjut lebih lambat.
--disk_cache=<a path>
default: lihat deskripsi- Jalur ke direktori tempat Bazel dapat membaca dan menulis tindakan dan output tindakan. Jika tidak ada, direktori akan dibuat.
--embed_label=<a one-line string>
default: ""- Menyematkan revisi kontrol sumber atau label rilis dalam biner
--execution_log_binary_file=<a path>
default: lihat deskripsi- Mencatat spawn yang dieksekusi ke dalam file ini sebagai proto SpawnExec yang dibatasi panjang, menurut src/main/protobuf/spawn.proto. Tanda terkait: --execution_log_json_file (format JSON teks; eksklusif bersama), --execution_log_sort (apakah akan mengurutkan log eksekusi), --subcommands (untuk menampilkan subperintah dalam output terminal).
--execution_log_json_file=<a path>
default: lihat deskripsi- Mencatat spawn yang dieksekusi ke dalam file ini sebagai representasi JSON yang dipisahkan baris baru dari proto SpawnExec, menurut src/main/protobuf/spawn.proto. Tanda terkait: --execution_log_binary_file (format protobuf biner; eksklusif bersama), --execution_log_sort (apakah akan mengurutkan log eksekusi), --subcommands (untuk menampilkan subperintah dalam output terminal).
--[no]execution_log_sort
default: "true"- Apakah akan mengurutkan log eksekusi, sehingga lebih mudah untuk membandingkan log di seluruh pemanggilan. Setel ke false untuk menghindari penggunaan CPU dan memori yang berpotensi signifikan di akhir pemanggilan, dengan mengorbankan produksi log dalam urutan eksekusi yang tidak deterministik. Hanya berlaku untuk format biner dan JSON; format yang ringkas tidak pernah diurutkan.
--[no]expand_test_suites
default: "true"-
Perluas target test_suite ke dalam pengujian konstituennya sebelum melakukan analisis. Jika tanda ini diaktifkan (default), pola target negatif akan diterapkan ke pengujian yang termasuk dalam rangkaian pengujian, jika tidak, pola target negatif tidak akan diterapkan. Menonaktifkan tanda ini berguna ketika aspek tingkat teratas diterapkan pada command line: lalu aspek tersebut dapat menganalisis target test_suite.
Tag:loading_and_analysis
--experimental_execution_log_compact_file=<a path>
default: lihat deskripsi- Mencatat spawn yang dieksekusi ke dalam file ini sebagai proto ExecLogEntry yang dibatasi panjang, menurut src/main/protobuf/spawn.proto. Seluruh file dikompresi zstd. Ini adalah format eksperimental yang masih dalam pengembangan aktif, dan dapat berubah kapan saja. Tanda terkait: --execution_log_binary_file (format protobuf biner; eksklusif bersama), --execution_log_json_file (format JSON teks; eksklusif bersama), --subcommands (untuk menampilkan subperintah dalam output terminal).
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
default: ""- Tidak digunakan lagi demi aspek. Memfilter kumpulan target untuk menjadwalkan extra_actions.
--[no]experimental_extra_action_top_level_only
default: "salah"- Tidak digunakan lagi demi aspek. Hanya menjadwalkan extra_actions untuk target tingkat teratas.
--experimental_spawn_scheduler
-
Aktifkan eksekusi dinamis dengan menjalankan tindakan secara lokal dan jarak jauh secara paralel. Bazel memunculkan setiap tindakan secara lokal dan dari jarak jauh, lalu memilih tindakan yang paling awal. Jika tindakan mendukung pekerja, tindakan lokal akan dijalankan dalam mode pekerja persisten. Guna mengaktifkan eksekusi dinamis untuk setiap mnemonik tindakan, gunakan tanda `--internal_spawn_scheduler` dan `--strategy=<mnemonic>=dynamic`.
Diluaskan ke:
--internal_spawn_scheduler
--spawn_strategy=dynamic
--[no]fetch
default: "true"- Mengizinkan perintah untuk mengambil dependensi eksternal. Jika disetel ke salah (false), perintah akan menggunakan versi dependensi yang di-cache, dan jika tidak ada, perintah tersebut akan gagal.
--[no]incompatible_dont_use_javasourceinfoprovider
default: "salah"-
Tanpa pengoperasian
Tag:incompatible_change
- Default
--local_termination_grace_seconds=<an integer>
: "15" - Waktu untuk menunggu antara penghentian proses lokal karena waktu tunggu habis dan penonaktifan secara paksa.
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <repositori name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--package_path=<colon-separated list of options>
default: "%workspace%"- Daftar yang dipisahkan titik dua berisi tempat mencari paket. Elemen yang dimulai dengan '%workspace%' akan relatif terhadap ruang kerja yang dicakup. Jika dihilangkan atau kosong, defaultnya adalah output 'bazel info default-package-path'.
--[no]show_loading_progress
default: "true"- Jika diaktifkan, akan menyebabkan Bazel mencetak pesan "Memuat paket:".
--test_lang_filters=<comma-separated list of options>
default: ""- Menentukan daftar bahasa pengujian yang dipisahkan koma. Secara opsional, setiap bahasa dapat diawali dengan '-' untuk menentukan bahasa yang dikecualikan. Hanya target pengujian yang akan ditemukan yang ditulis dalam bahasa tertentu. Nama yang digunakan untuk setiap bahasa harus sama dengan awalan bahasa di aturan *_test, misalnya salah satu dari 'cc', 'java', 'py', dll. Opsi ini memengaruhi perilaku --build_tests_only dan perintah pengujian.
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
default: ""- Menentukan daftar ukuran pengujian yang dipisahkan koma. Setiap ukuran dapat diawali dengan '-' untuk menentukan ukuran yang dikecualikan. Hanya target pengujian tersebut yang akan ditemukan berisi setidaknya satu ukuran yang disertakan dan tidak berisi ukuran yang dikecualikan. Opsi ini memengaruhi perilaku --build_tests_only dan perintah pengujian.
--test_tag_filters=<comma-separated list of options>
default: ""- Menentukan daftar tag pengujian yang dipisahkan koma. Secara opsional, setiap tag dapat diawali dengan '-' untuk menentukan tag yang dikecualikan. Hanya target pengujian tersebut yang akan ditemukan berisi setidaknya satu tag yang disertakan dan tidak berisi tag yang dikecualikan. Opsi ini memengaruhi perilaku --build_tests_only dan perintah pengujian.
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
default: ""- Menentukan daftar waktu tunggu pengujian yang dipisahkan koma. Setiap waktu tunggu dapat diawali dengan '-' untuk menentukan waktu tunggu yang dikecualikan. Hanya target pengujian tersebut yang akan ditemukan berisi setidaknya satu waktu tunggu yang disertakan dan tidak berisi waktu tunggu yang dikecualikan. Opsi ini memengaruhi perilaku --build_tests_only dan perintah pengujian.
--workspace_status_command=<path>
default: ""- Perintah yang dipanggil di awal build untuk memberikan informasi status tentang ruang kerja dalam bentuk key-value pair. Lihat Panduan Pengguna untuk spesifikasi lengkapnya. Lihat juga alat/buildstamp/get_workspace_status sebagai contohnya.
- Opsi yang mengontrol eksekusi build:
--[no]check_up_to_date
default: "salah"-
Jangan menjalankan build, cukup periksa apakah build tersebut sudah yang terbaru. Jika semua target merupakan versi terbaru, build akan berhasil diselesaikan. Jika langkah perlu dijalankan, error akan dilaporkan dan build gagal.
Tag:execution
--[no]experimental_inprocess_symlink_creation
default: "salah"-
Apakah akan melakukan panggilan sistem file langsung untuk membuat hierarki symlink
Tag:loading_and_analysis
,execution
,experimental
--[no]experimental_persistent_aar_extractor
default: "salah"-
Aktifkan ekstraktor aar persisten menggunakan pekerja.
Tag:execution
--[no]experimental_remotable_source_manifests
default: "salah"-
Apakah akan membuat tindakan manifes sumber dapat dipindahkan
Tag:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
default: "salah"-
Jika true, Bazel akan menjalankan cakupan pascapemrosesan untuk pengujian di spawn baru.
Tag:execution
--[no]experimental_split_xml_generation
default: "true"-
Jika flag ini ditetapkan, dan tindakan pengujian tidak menghasilkan file test.xml, maka Bazel akan menggunakan tindakan terpisah untuk membuat file dummy test.xml yang berisi log pengujian. Jika tidak, Bazel akan menghasilkan test.xml sebagai bagian dari tindakan pengujian.
Tag:execution
--[no]experimental_strict_fileset_output
default: "salah"-
Jika opsi ini diaktifkan, kumpulan file akan memperlakukan semua artefak output sebagai file biasa. {i>Mockup <i}tidak akan melintasi direktori atau sensitif terhadap symlink.
Tag:execution
--[no]experimental_use_semaphore_for_jobs
default: "true"-
Jika disetel ke benar (true), gunakan juga semafor untuk membatasi jumlah tugas serentak.
Tag:host_machine_resource_optimizations
,execution
--genrule_strategy=<comma-separated list of options>
default: ""-
Menentukan cara menjalankan genrules. Tanda ini akan dihentikan. Sebagai gantinya, gunakan --spawn_strategy=<value> untuk mengontrol semua tindakan atau --strategy=Genrule=<value> untuk mengontrol genrules saja.
Tag:execution
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] default: "otomatis"-
Jumlah tugas serentak yang akan dijalankan. Memerlukan bilangan bulat, atau kata kunci ("otomatis", "HOST_CPUS", "HOST_RAM"), dapat diikuti dengan operasi ([-|*]<float>) misalnya, "otomatis", "HOST_CPUS*.5". Nilai harus antara 1 dan 5.000. Nilai di atas 2500 dapat menyebabkan masalah memori. "auto" menghitung {i>default<i} yang wajar
berdasarkan sumber daya {i>host<i}.
Tag:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] default: "salah"-
Lanjutkan sebanyak mungkin setelah error. Meskipun target yang gagal dan yang bergantung pada target tersebut tidak dapat dianalisis, prasyarat lain dari target tersebut dapat berupa.
Tag: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">
default: "otomatis"-
Jumlah thread paralel yang digunakan untuk fase pemuatan/analisis. Mengambil bilangan bulat, atau kata kunci ("otomatis", "HOST_CPUS", "HOST_RAM"), dapat diikuti dengan operasi ([-|*]<float>) misalnya, "otomatis", "HOST_CPUS*.5". "{i>auto" <i}menetapkan {i>default<i} yang wajar
berdasarkan sumber daya {i>host<i}. Minimal harus 1.
Tag:bazel_internal_configuration
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
default: ""-
Tambahkan atau hapus kunci dari info eksekusi tindakan berdasarkan mnemonik tindakan. Hanya berlaku untuk tindakan yang mendukung info eksekusi. Banyak tindakan umum yang mendukung info eksekusi, misalnya Genrule, CppCompile, Javac, StarlarkAction, TestRunner. Saat menentukan beberapa nilai, urutan penting karena banyak regex dapat berlaku untuk mnemonik yang sama.
Sintaks: "regex=[+-]key,regex=[+-]key,...".
Contoh:
'.*=+x,.*=-y,.*=+z' menambahkan 'x' dan 'z' ke, serta menghapus 'y' dari, info eksekusi untuk semua tindakan.
'Genrule=+require-x' menambahkan 'require-x' ke info eksekusi untuk semua tindakan Genrule.
'(?!Genrule).*=-require-x' menghapus 'require-x' dari info eksekusi untuk semua tindakan non-Genrule.
Tag:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Aktifkan tindakan dex dan desugar Android persisten menggunakan pekerja.
Diluaskan ke:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Tag:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Aktifkan pemroses resource Android persisten menggunakan pekerja.
Diluaskan ke:
--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
}--internal_persistent_busybox_tools
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_desugar
-
Aktifkan tindakan dex dan desugar Android multipleks yang persisten menggunakan pekerja.
Diluaskan ke:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Tag:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Aktifkan pemroses resource Android multipleks persisten menggunakan pekerja.
Diluaskan ke:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
}--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
-
Aktifkan alat Android persisten dan multipleks (dexing, desugaring, pemrosesan resource).
Diluaskan ke:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Tag:host_machine_resource_optimizations
,execution
--[no]skip_incompatible_explicit_targets
default: "salah"-
Lewati target tidak kompatibel yang dicantumkan secara eksplisit di command line. Secara default, membuat target tersebut akan menghasilkan error, tetapi target tersebut akan dilewati tanpa pemberitahuan saat opsi ini diaktifkan. Lihat: https://bazel.build/extending/platforms#skipping-incompatible-targets
Tag:loading_and_analysis
--spawn_strategy=<comma-separated list of options>
default: ""-
Menentukan cara tindakan spawn dijalankan secara default. Menerima daftar strategi yang dipisahkan koma dari prioritas tertinggi hingga terendah. Untuk setiap tindakan, Bazel memilih strategi dengan prioritas tertinggi yang dapat menjalankan tindakan. Nilai defaultnya adalah "remote,worker,sandboxed,local". Lihat https://blog.bazel.build/2019/06/19/list-strategy.html untuk mengetahui detailnya.
Tag:execution
--strategy=<a '[name=]value1[,..,valueN]' assignment>
beberapa penggunaan diakumulasikan-
Menentukan cara mendistribusikan kompilasi tindakan spawn lainnya. Menerima daftar strategi yang dipisahkan koma dari prioritas tertinggi hingga terendah. Untuk setiap tindakan, Bazel memilih strategi dengan prioritas tertinggi yang dapat menjalankan tindakan. Nilai defaultnya adalah "remote,worker,sandboxed,local". Tanda ini mengganti nilai yang ditetapkan oleh --spawn_strategy (dan --genrule_strategy jika digunakan dengan Genrule mnemonic). Lihat https://blog.bazel.build/2019/06/19/list-strategy.html untuk mengetahui detailnya.
Tag:execution
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
beberapa penggunaan diakumulasikan-
Mengganti strategi spawn yang harus digunakan untuk menjalankan tindakan spawn yang memiliki deskripsi yang cocok dengan regex_filter tertentu. Lihat --per_file_copt untuk mengetahui detail pencocokan onregex_filter. regex_filter terakhir yang cocok dengan deskripsi akan digunakan. Opsi ini menggantikan tanda lain untuk menentukan strategi. Contoh: --strategy_regexp=//foo.*\.cc,-//foo/bar=local berarti menjalankan tindakan menggunakan strategi lokal jika deskripsinya cocok dengan //foo.*.cc, tetapi bukan //foo/bar. Contoh: --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed akan menjalankan 'Mengompilasi //foo/bar/baz' dengan strategi 'local', namun membalik urutan akan menjalankannya dengan 'sandbox'.
Tag:execution
--[no]use_target_platform_for_tests
default: "salah"-
Jika true (benar), Bazel akan menggunakan platform target untuk menjalankan pengujian, bukan grup eksekusi pengujian.
Tag:execution
- Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
--android_compiler=<a string>
default: lihat deskripsi-
Compiler target Android.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
default: "//external:android/crosstool"-
Lokasi compiler C++ yang digunakan untuk build Android.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
default: lihat deskripsi-
Target Android grte_top.
Tag:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
default: "android"-
Memilih penggabungan manifes yang akan digunakan untuk aturan android_binary. Tanda untuk membantu transisi ke penggabungan manifes Android dari penggabungan lama.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
default: ""-
Menetapkan platform yang digunakan target android_binary. Jika beberapa platform ditentukan, biner adalah APK gemuk, yang berisi biner native untuk setiap platform target yang ditentukan.
Tag:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
default: "@bazel_tools//tools/android:sdk"-
Menentukan platform/Android SDK yang digunakan untuk mem-build aplikasi Android.
Tag:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
default: "@bazel_tools//tools/cpp:toolchain"-
Label paket crosstool yang akan digunakan dalam aturan Apple dan Objc serta dependensinya.
Tag:loses_incremental_state
,changes_inputs
--cc_output_directory_tag=<a string>
default: ""-
Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.
Tag:affects_outputs
--compiler=<a string>
default: lihat deskripsi-
Compiler C++ yang akan digunakan untuk mengompilasi target.
Tag:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
default: "@bazel_tools//tools/test:lcov_merger"-
Lokasi biner yang digunakan untuk pascapemrosesan laporan cakupan mentah. Saat ini, file harus berupa grup file yang berisi satu file, yaitu biner. Default-nya adalah '//tools/test:lcov_merger'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
default: "@bazel_tools//tools/test:coverage_report_generator"-
Lokasi biner yang digunakan untuk membuat laporan cakupan. Saat ini, file harus berupa grup file yang berisi satu file, yaitu biner. Default-nya adalah '//tools/test:coverage_report_generator'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
default: "@bazel_tools//tools/test:coverage_support"-
Lokasi file dukungan yang diperlukan pada input setiap tindakan pengujian yang mengumpulkan cakupan kode. Default-nya adalah '//tools/test:coverage_support'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--custom_malloc=<a build target label>
default: lihat deskripsi-
Menentukan implementasi maloc kustom. Setelan ini mengganti atribut maloc dalam aturan build.
Tag:changes_inputs
,affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
beberapa penggunaan diakumulasikan-
Daftar ekspresi reguler yang dipisahkan koma, masing-masing jika perlu diawali dengan - (ekspresi negatif), ditetapkan (=) ke daftar target nilai batasan yang dipisahkan koma. Jika target tidak cocok dengan ekspresi negatif dan setidaknya satu ekspresi positif, resolusi toolchain-nya akan dijalankan seolah-olah telah mendeklarasikan nilai batasan sebagai batasan eksekusi. Contoh: //demo,-test=@platforms//cpus:x86_64 akan menambahkan 'x86_64' ke target mana pun di bawah //demo kecuali untuk yang namanya berisi 'test'.
Tag:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
default: "salah"-
Jika ditetapkan, tambahkan persyaratan eksekusi "require-xcode:{version}" ke setiap tindakan Xcode. Jika versi xcode memiliki label dengan tanda hubung, tambahkan juga persyaratan eksekusi "require-xcode-label:{version_label}".
Tag:loses_incremental_state
,loading_and_analysis
,execution
--[no]experimental_prefer_mutual_xcode
default: "true"-
Jika benar, gunakan Xcode terbaru yang tersedia secara lokal dan jarak jauh. Jika salah (false), atau jika tidak ada versi bersama yang tersedia, gunakan versi Xcode lokal yang dipilih melalui xcode-select.
Tag:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
default: ""-
Platform yang tersedia sebagai platform eksekusi untuk menjalankan tindakan. Platform dapat ditentukan berdasarkan target yang tepat, atau sebagai pola target. Platform ini akan dipertimbangkan sebelum yang dideklarasikan dalam file WORKSPACE oleh register_execution_platforms(). Opsi ini hanya dapat disetel satu kali; instance berikutnya akan mengganti setelan tanda sebelumnya.
Tag:execution
--extra_toolchains=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Aturan toolchain yang akan dipertimbangkan selama resolusi toolchain. Toolchain dapat ditentukan berdasarkan target yang tepat, atau sebagai pola target. Toolchain ini akan dipertimbangkan sebelum yang dideklarasikan dalam file WORKSPACE oleh register_toolchains().
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
default: lihat deskripsi-
Label ke library libc yang digunakan untuk check in. Nilai default dipilih oleh toolchain crosstool, dan Anda hampir tidak perlu menggantinya.
Tag:action_command_lines
,affects_outputs
--host_compiler=<a string>
default: lihat deskripsi-
Flag tanpa pengoperasian. Akan dihapus dalam rilis mendatang.
Tag:loading_and_analysis
,execution
--host_grte_top=<a label>
default: lihat deskripsi-
Jika ditentukan, setelan ini akan menggantikan direktori tingkat teratas libc (--grte_top) untuk konfigurasi eksekusi.
Tag:action_command_lines
,affects_outputs
--host_platform=<a build target label>
default: "@local_config_platform//:host"-
Label aturan platform yang menjelaskan sistem host.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
default: "true"-
Jika true (benar), Bazel tidak akan mengaktifkan fitur 'host' dan 'nonhost' di toolchain c++ (lihat https://github.com/bazelbuild/bazel/issues/7407 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
default: "true"-
Gunakan resolusi toolchain untuk memilih aturan Android SDK untuk Android (Starlark dan native)
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
default: "salah"-
Gunakan resolusi toolchain guna memilih Apple SDK untuk aturan Apple (Starlark dan native)
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
default: "true"-
Flag ini bersifat noop dan dijadwalkan untuk dihapus.
Tag:no_op
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
default: "true"-
Jika true (benar), Bazel tidak akan menautkan dependensi library ke seluruh arsip secara default (lihat https://github.com/bazelbuild/bazel/issues/7362 untuk mengetahui petunjuk migrasi).
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
default: "true"-
Flag ini bersifat noop dan dijadwalkan untuk dihapus.
Tag:no_op
,incompatible_change
--[no]incompatible_strip_executable_safely
default: "salah"-
Jika true, tindakan penghapusan untuk file yang dapat dieksekusi akan menggunakan flag -x, yang tidak melanggar resolusi simbol dinamis.
Tag:action_command_lines
,incompatible_change
-
Gunakan objek bersama antarmuka jika didukung oleh toolchain. Semua toolchain ELF saat ini mendukung setelan ini.
Tag:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Menentukan versi iOS SDK yang akan digunakan untuk membuat aplikasi iOS. Jika tidak ditentukan, versi SDK iOS default dari 'xcode_version' akan digunakan.
Tag:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Menentukan versi macOS SDK yang akan digunakan untuk mem-build aplikasi macOS. Jika tidak ditentukan, versi SDK macOS default dari 'xcode_version' akan digunakan.
Tag:loses_incremental_state
--minimum_os_version=<a string>
default: lihat deskripsi-
Versi OS minimum yang ditargetkan kompilasi Anda.
Tag:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
default: ""-
Lokasi file pemetaan yang menjelaskan platform yang akan digunakan jika tidak ada yang ditetapkan atau tanda yang akan ditetapkan ketika platform sudah ada. Harus terkait dengan root ruang kerja utama. Nilai defaultnya adalah 'platform_mappings' (file langsung di bawah root ruang kerja).
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
,immutable
--platforms=<a build target label>
default: ""-
Label aturan platform yang menjelaskan platform target untuk perintah saat ini.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
default: lihat deskripsi-
Tidak digunakan lagi, tanpa pengoperasian. Dinonaktifkan oleh `--incompatible_use_python_ toolchains`.
Tag:no_op
,deprecated
--python3_path=<a string>
default: lihat deskripsi-
Tidak digunakan lagi, tanpa pengoperasian. Dinonaktifkan oleh `--incompatible_use_python_ toolchains`.
Tag:no_op
,deprecated
--python_path=<a string>
default: lihat deskripsi-
Jalur absolut penafsir Python yang dipanggil untuk menjalankan target Python di platform target. Tidak digunakan lagi; dinonaktifkan oleh --incompatible_use_python_ toolchains.
Tag:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
default: lihat deskripsi-
Label py_runtime yang mewakili penafsir Python yang dipanggil untuk menjalankan target Python di platform target. Tidak digunakan lagi; dinonaktifkan oleh --incompatible_use_python_ toolchains.
Tag:loading_and_analysis
,affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Menentukan versi tvOS SDK yang akan digunakan untuk mem-build aplikasi tvOS. Jika tidak ditentukan, versi SDK tvOS default dari 'xcode_version' akan digunakan.
Tag:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Menentukan versi SDK watchOS yang akan digunakan untuk mem-build aplikasi watchOS. Jika tidak ditentukan, versi SDK watchOS default dari 'xcode_version' akan digunakan.
Tag:loses_incremental_state
--xcode_version=<a string>
default: lihat deskripsi-
Jika ditentukan, akan menggunakan Xcode dari versi yang ditentukan untuk tindakan build yang relevan. Jika tidak ditentukan, versi Xcode default eksekutor akan digunakan.
Tag:loses_incremental_state
--xcode_version_config=<a build target label>
default: "@bazel_tools//tools/cpp:host_xcodes"-
Label aturan xcode_config yang akan digunakan untuk memilih versi Xcode di konfigurasi build.
Tag:loses_incremental_state
,loading_and_analysis
- Opsi yang mengontrol output perintah:
--[no]apple_generate_dsym
default: "salah"-
Apakah akan menghasilkan file simbol debug(.dSYM).
Tag:affects_outputs
,action_command_lines
--[no]build
default: "true"-
Jalankan build; ini adalah perilaku yang biasa. Menentukan --nobuild menyebabkan build berhenti sebelum mengeksekusi tindakan build, menampilkan nol jika fase pemuatan dan analisis paket berhasil diselesaikan; mode ini berguna untuk menguji fase tersebut.
Tag:execution
,affects_outputs
--[no]build_runfile_links
default: "true"-
Jika true (benar), buat forest symlink runfile untuk semua target. Jika false, tuliskan hanya saat diperlukan oleh tindakan lokal, uji, atau jalankan perintah.
Tag:affects_outputs
--[no]build_runfile_manifests
default: "true"-
Jika true (benar), menulis manifes runfile untuk semua target. Jika salah (false), hapus variabel tersebut. Pengujian lokal akan gagal dijalankan jika salah (false).
Tag:affects_outputs
--[no]build_test_dwp
default: "salah"-
Jika diaktifkan, saat mem-build pengujian C++ secara statis dan dengan fisi, file .dwp untuk biner pengujian juga akan otomatis dibuat.
Tag:loading_and_analysis
,affects_outputs
- Default
--cc_proto_library_header_suffixes=<comma-separated set of options>
: ".pb.h" -
Menetapkan akhiran file header yang dibuat oleh cc_proto_library.
Tag:affects_outputs
,loading_and_analysis
- Default
--cc_proto_library_source_suffixes=<comma-separated set of options>
: ".pb.cc" -
Menetapkan akhiran file sumber yang dibuat oleh cc_proto_library.
Tag:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
default: "salah"-
Menjalankan tindakan tambahan untuk versi Java API alternatif di proto_library.
Tag:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
default: "salah"-
Menjalankan tindakan tambahan untuk versi Java API alternatif di proto_library.
Tag:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
default: "salah"-
Simpan status fitur yang diaktifkan dan diminta sebagai output kompilasi.
Tag:affects_outputs
,experimental
--[no]experimental_use_validation_aspect
default: "salah"-
Apakah akan menjalankan tindakan validasi menggunakan aspek (untuk paralelisme dengan pengujian).
Tag:execution
,affects_outputs
--fission=<a set of compilation modes>
default: "tidak"-
Menentukan mode kompilasi yang menggunakan fisi untuk kompilasi dan link C++. Dapat berupa kombinasi {'fastbuild', 'dbg', 'opt'} atau nilai khusus 'yes' untuk mengaktifkan semua mode dan 'no' untuk menonaktifkan semua mode.
Tag:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
default: "true"-
Jika true (benar), aturan native akan menambahkan <code>DefaultInfo.files</code> dependensi data ke runfile-nya, yang cocok dengan perilaku yang direkomendasikan untuk aturan Starlark (https://bazel.build/extending/rules#runfiles_features_to_Hindari).
Tag:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
default: "true"-
Jika true, build runfile symlink forest untuk repositori eksternal dalam .runfiles/wsname/external/repo (selain .runfiles/repo).
Tag:affects_outputs
--[no]objc_generate_linkmap
default: "salah"-
Menentukan apakah akan membuat file peta link.
Tag:affects_outputs
--output_groups=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar nama grup output yang dipisahkan dengan koma, yang masing-masing dapat diawali dengan + atau -. Grup yang diawali dengan + akan ditambahkan ke kumpulan default grup output, sedangkan grup yang diawali dengan - akan dihapus dari kumpulan default. Jika setidaknya satu grup tidak diberi awalan, kumpulan default grup output akan dihilangkan. Misalnya, --output_groups=+foo,+bar membangun penyatuan dari set, foo, dan bar default, sedangkan --output_groups=foo,bar menggantikan set default sehingga hanya foo dan bar yang dibuat.
Tag:execution
,affects_outputs
--[no]run_validations
default: "true"-
Apakah akan menjalankan tindakan validasi sebagai bagian dari build. Lihat https://bazel.build/extending/rules#validation_actions
Tag:execution
,affects_outputs
--[no]save_temps
default: "salah"-
Jika disetel, output sementara dari gcc akan disimpan. Ini mencakup file .s (kode assembler), file .i (C yang diproses sebelumnya), dan file .ii (C++ yang diproses sebelumnya).
Tag:affects_outputs
- Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, tetapi memengaruhi nilainya, bukan keberadaannya:
--action_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi target. Variabel dapat ditetapkan berdasarkan nama, dalam hal ini nilai akan diambil dari lingkungan pemanggilan, atau oleh pasangan nama=nilai yang menetapkan nilai yang tidak bergantung pada lingkungan pemanggilan. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, nilai terbaru yang diperoleh, opsi untuk variabel yang berbeda akan diakumulasikan.
Tag:action_command_lines
--android_cpu=<a string>
default: "armeabi-v7a"-
CPU target Android.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
default: "true"-
Buat file data binding yang kompatibel dengan AndroidX. Ini hanya digunakan dengan databinding v2. Tanda ini tanpa pengoperasian.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
default: "true"-
Gunakan android databinding v2 dengan argumen 3.4.0. Tanda ini tanpa pengoperasian.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--android_dynamic_mode=<off, default or fully>
: "off" -
Menentukan apakah dependensi C++ aturan Android akan ditautkan secara dinamis ketika cc_binary tidak secara eksplisit membuat library bersama. 'default' berarti bazel akan memilih apakah akan menautkan secara dinamis. 'complete' berarti semua library akan ditautkan secara dinamis. 'off' berarti semua library akan ditautkan dalam sebagian besar mode statis.
Tag:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
default: "alfabet"-
Menetapkan urutan manifes yang diteruskan ke penggabungan manifes untuk biner Android. ALFABETIS berarti manifes diurutkan berdasarkan jalur relatif terhadap execroot. ALPHABETICAL_BY_CONFIGURATION berarti manifes diurutkan menurut jalur yang terkait dengan direktori konfigurasi dalam direktori output. DEPENDENSI berarti manifes diurutkan dengan setiap manifes library muncul sebelum manifes dependensinya.
Tag:action_command_lines
,execution
--[no]android_resource_shrinking
default: "salah"-
Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.
Tag:affects_outputs
,loading_and_analysis
--aspects=<comma-separated list of options>
beberapa penggunaan diakumulasikan- Daftar aspek yang dipisahkan koma yang akan diterapkan ke target tingkat teratas. Dalam daftar, jika aspek some_aspect menentukan penyedia aspek yang diperlukan melalui required_aspect_providers, some_aspect akan berjalan setelah setiap aspek yang disebutkan sebelumnya dalam daftar aspek yang penyedia yang diiklankan memenuhi penyedia aspek yang diperlukan some_aspect. Selain itu, some_aspect akan berjalan setelah semua aspek yang diperlukan ditentukan oleh atribut required. some_aspect kemudian akan memiliki akses ke nilai penyedia aspek tersebut. <bzl-file-label>%<aspect_name>, misalnya '//tools:my_def.bzl%my_aspect', dengan 'my_aspect' adalah nilai level teratas dari file tools/my_def.bzl
--[no]build_python_zip
default: "otomatis"-
Buat zip python yang dapat dieksekusi; di Windows, nonaktif di platform lain
Tag:affects_outputs
--catalyst_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang memerlukan biner Apple Catalyst.
Tag:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
default: "salah"-
Jika ditentukan, Bazel akan menginstrumentasikan kode (menggunakan instrumentasi offline jika memungkinkan) dan akan mengumpulkan informasi cakupan selama pengujian. Hanya target yang cocok --instrumentation_filter yang akan terpengaruh. Biasanya opsi ini tidak boleh ditentukan secara langsung - perintah 'bazel scope' sebaiknya digunakan.
Tag:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] default: "fastbuild"-
Tentukan mode tempat biner akan dibangun. Nilai: 'fastbuild', 'dbg', 'opt'.
Tag:affects_outputs
,action_command_lines
--conlyopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke gcc saat mengompilasi file sumber C.
Tag:action_command_lines
,affects_outputs
--copt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke gcc.
Tag:action_command_lines
,affects_outputs
--cpu=<a string>
default: ""-
CPU target.
Tag:changes_inputs
,affects_outputs
--cs_fdo_absolute_path=<a string>
default: lihat deskripsi-
Menggunakan informasi profil CSFDO untuk mengoptimalkan kompilasi. Tentukan nama jalur absolut file zip yang berisi file profil, file profil LLVM mentah atau yang diindeks.
Tag:affects_outputs
--cs_fdo_instrument=<a string>
default: lihat deskripsi-
Membuat biner dengan instrumentasi FDO yang sensitif konteks. Dengan compiler Clang/LLVM, compiler ini juga menerima nama direktori tempat file profil mentah akan dibuang saat runtime.
Tag:affects_outputs
--cs_fdo_profile=<a build target label>
default: lihat deskripsi-
cs_fdo_profile yang mewakili profil sensitif konteks yang akan digunakan untuk pengoptimalan.
Tag:affects_outputs
--cxxopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke gcc saat mengompilasi file sumber C++.
Tag:action_command_lines
,affects_outputs
--define=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan-
Setiap opsi --define menentukan penetapan untuk variabel build. Dalam kasus beberapa nilai untuk suatu variabel, nilai terakhir yang akan menang.
Tag:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
default: "default"-
Menentukan apakah biner C++ akan ditautkan secara dinamis. 'default' berarti Bazel akan memilih apakah akan menautkan secara dinamis. 'complete' berarti semua library akan ditautkan secara dinamis. 'off' berarti semua library akan ditautkan dalam sebagian besar mode statis.
Tag:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
default: "true"-
Jika ditetapkan, penggunaan fdo_absolute_profile_path akan menimbulkan error.
Tag:affects_outputs
--[no]enable_runfiles
default: "otomatis"-
Aktifkan hierarki symlink runfiles; Secara default, fungsi ini nonaktif di Windows, di platform lain.
Tag:affects_outputs
--experimental_action_listener=<a build target label>
beberapa penggunaan diakumulasikan-
Tidak digunakan lagi demi aspek. Gunakan action_Listener untuk melampirkan extra_action ke tindakan build yang ada.
Tag:execution
,experimental
--[no]experimental_android_compress_java_resources
default: "salah"-
Kompresi resource Java dalam APK
Tag:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
default: "true"-
Gunakan databinding Android v2. Tanda ini tanpa pengoperasian.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
default: "salah"-
Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.
Tag:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
default: "salah"-
gunakan alat rex untuk menulis ulang file dex
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
default: "salah"-
Jika ditentukan, Bazel juga akan membuat informasi cakupan untuk file yang dihasilkan.
Tag:affects_outputs
--[no]experimental_convenience_symlinks
default: "normal"-
Tanda ini mengontrol cara symlink praktis (symlink yang muncul di ruang kerja setelah build) untuk dikelola. Nilai yang memungkinkan:
normal (default): Setiap jenis symlink kemudahan akan dibuat atau dihapus, sebagaimana ditentukan oleh build.
bersih: Semua symlink akan dihapus tanpa syarat.
abaikan: Symlink akan dibiarkan sendiri.
log_only: Membuat pesan log seolah-olah 'normal' diteruskan, tetapi sebenarnya tidak melakukan operasi sistem file apa pun (berguna untuk alat).
Perhatikan bahwa hanya symlink yang namanya dihasilkan oleh nilai --symlink_prefix saat ini yang dapat terpengaruh; jika awalan berubah, symlink yang sudah ada sebelumnya akan dibiarkan saja.
Tag:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
default: "salah"-
Flag ini mengontrol apakah kita akan memposting peristiwa buildKemudahanSymlinksIdentified ke BuildEventProtocol atau tidak. Jika nilainya benar, BuildEventProtocol akan memiliki entri untuk uniqueSymlinksIdentified, yang mencantumkan semua symlink praktis yang dibuat di ruang kerja Anda. Jika salah (false), entri minimarketSymlinksIdentified di BuildEventProtocol akan kosong.
Tag:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
default: "-O0,-DDEBUG=1"-
Menggunakan string ini sebagai opsi compiler fastbuild objc.
Tag:action_command_lines
--[no]experimental_omitfp
default: "salah"-
Jika true (benar), gunakan libunwind untuk pelepasan stack (stack unwind), lalu kompilasi dengan -fomit-frame-pointer dan -fasync-unwind-tables.
Tag:action_command_lines
,affects_outputs
,experimental
- Default
--experimental_output_paths=<off, content or strip>
: "off" -
Model yang akan digunakan untuk tempat aturan hierarki output menulis output-nya, terutama untuk build multi-platform / multi-konfigurasi. Hal ini sangat eksperimental. Lihat https://github.com/bazelbuild/bazel/issues/6526 untuk mengetahui detailnya. Tindakan Starlark dapat digunakan dalam pemetaan jalur dengan menambahkan kunci 'supports-path-mapping' ke perintah 'execution_requirements'.
Tag:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
beberapa penggunaan diakumulasikan-
Setiap entri harus berupa label=value formulir dengan label merujuk ke platform dan nilai merupakan nama pendek yang diinginkan untuk digunakan di jalur output. Hanya digunakan jika --experimental_platform_in_output_dir benar. Memiliki prioritas penamaan tertinggi.
Tag:affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
default: "salah"-
Jika true (benar), nama pendek untuk platform target akan digunakan dalam nama direktori output, bukan CPU. Skema persisnya bersifat eksperimental dan dapat berubah sewaktu-waktu: Pertama, dalam kasus yang jarang terjadi, opsi --platforms tidak memiliki tepat satu nilai, hash opsi platform akan digunakan. Selanjutnya, jika ada nama pendek untuk platform saat ini yang didaftarkan oleh --experimental_override_name_platform_in_output_dir, maka nama pendek tersebut akan digunakan. Kemudian, jika --experimental_use_platforms_in_output_dir_legacy_heuristic ditetapkan, gunakan nama singkat berdasarkan Label platform saat ini. Akhirnya, {i>hash<i} dari opsi platform
digunakan sebagai upaya terakhir.
Tag:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
default: "salah"-
Jika ditentukan, Bazel akan membuat informasi peta cakupan llvm-cov, bukan gcov saat collect_code_coverage diaktifkan.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
default: "true"-
Harap gunakan tanda ini hanya sebagai bagian dari strategi migrasi atau pengujian yang disarankan. Perhatikan bahwa heuristik memiliki kekurangan yang telah diketahui, jadi sebaiknya migrasikan untuk hanya mengandalkan --experimental_override_name_platform_in_output_dir.
Tag:affects_outputs
,experimental
--fat_apk_cpu=<comma-separated set of options>
default: "armeabi-v7a"-
Menyetel opsi ini akan mengaktifkan APK lemak, yang berisi biner native untuk semua arsitektur target yang ditentukan, misalnya, --fat_apk_cpu=x86,armeabi-v7a. Jika flag ini ditentukan, maka --android_cpu diabaikan untuk dependensi aturan android_binary.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
default: "salah"-
Flag tanpa pengoperasian. Akan dihapus dalam rilis mendatang.
Tag:no_op
--fdo_instrument=<a string>
default: lihat deskripsi-
Membuat biner dengan instrumentasi FDO. Dengan compiler Clang/LLVM, compiler ini juga menerima nama direktori tempat file profil mentah akan dibuang saat runtime.
Tag:affects_outputs
--fdo_optimize=<a string>
default: lihat deskripsi-
Gunakan informasi profil FDO untuk mengoptimalkan kompilasi. Tentukan nama file zip yang berisi hierarki file .gcda, file afdo yang berisi profil otomatis, atau file profil LLVM. Tanda ini juga menerima file yang ditentukan sebagai label (mis. `//foo/bar:file.afdo` - Anda mungkin perlu menambahkan perintah `exports_files` ke paket terkait) dan label yang mengarah ke target `fdo_profile`. Tanda ini akan digantikan oleh aturan `fdo_profile`.
Tag:affects_outputs
--fdo_prefetch_hints=<a build target label>
default: lihat deskripsi-
Gunakan petunjuk pengambilan data cache.
Tag:affects_outputs
--fdo_profile=<a build target label>
default: lihat deskripsi-
fdo_profile yang mewakili profil yang akan digunakan untuk pengoptimalan.
Tag:affects_outputs
--features=<a string>
beberapa penggunaan diakumulasikan-
Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi target. Menentukan -<feature> akan menonaktifkan fitur. Fitur negatif selalu menggantikan fitur positif. Lihat juga --host_features
Tag:changes_inputs
,affects_outputs
--[no]force_pic
default: "salah"-
Jika diaktifkan, semua kompilasi C++ akan menghasilkan kode yang bergantung pada posisi ("-fPIC"), link akan lebih memilih library bawaan PIC daripada library non-PIC, dan link menghasilkan file yang dapat dieksekusi tanpa bergantung posisi ("-pie").
Tag:loading_and_analysis
,affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi eksekusi. Variabel dapat ditetapkan berdasarkan nama, dalam hal ini nilai akan diambil dari lingkungan pemanggilan, atau oleh pasangan nama=nilai yang menetapkan nilai yang tidak bergantung pada lingkungan pemanggilan. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, nilai terbaru yang diperoleh, opsi untuk variabel yang berbeda akan diakumulasikan.
Tag:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
default: "opt"-
Tentukan mode yang akan digunakan alat selama proses build. Nilai: 'fastbuild', 'dbg', 'opt'.
Tag:affects_outputs
,action_command_lines
--host_conlyopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke compiler C saat mengompilasi file sumber C (tetapi bukan C++) dalam konfigurasi exec.
Tag:action_command_lines
,affects_outputs
--host_copt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke compiler C untuk alat yang dibuat dalam konfigurasi exec.
Tag:action_command_lines
,affects_outputs
--host_cpu=<a string>
default: ""-
CPU host.
Tag:changes_inputs
,affects_outputs
--host_cxxopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke compiler C++ untuk alat yang dibuat dalam konfigurasi exec.
Tag:action_command_lines
,affects_outputs
--host_features=<a string>
beberapa penggunaan diakumulasikan-
Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi exec. Menentukan -<feature> akan menonaktifkan fitur. Fitur negatif selalu menggantikan fitur positif.
Tag:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
default: lihat deskripsi-
Mengganti versi Python untuk konfigurasi exec. Dapat berupa "PY2" atau "PY3".
Tag:loading_and_analysis
,affects_outputs
--host_linkopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke penaut saat menautkan alat dalam konfigurasi eksekusi.
Tag:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi macOS minimum yang kompatibel untuk target host. Jika tidak ditentukan, 'macos_sdk_version' akan digunakan.
Tag: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>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan secara selektif ke compiler C/C++ saat mengompilasi file tertentu dalam konfigurasi exec. Opsi ini dapat diteruskan beberapa kali. Sintaks: regex_filter@option_1,option_2,...,option_n. Di mana regex_filter adalah singkatan dari daftar pola sertakan dan kecualikan ekspresi reguler (Lihat juga --instrumentation_filter). option_1 menjadi option_n yang berarti opsi baris perintah arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ yang pertama digunakan untuk memisahkan string. Contoh: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 menambahkan opsi command line -O0 ke command line gcc dari semua file cc di //foo/ kecuali bar.cc.
Tag:action_command_lines
,affects_outputs
--[no]incompatible_auto_exec_groups
default: "salah"-
Jika diaktifkan, grup eksekusi akan otomatis dibuat untuk setiap toolchain yang digunakan oleh suatu aturan. Agar aturan ini berfungsi, perlu menentukan parameter `toolchain` pada tindakannya. Untuk informasi selengkapnya, lihat https://github.com/bazelbuild/bazel/issues/17134.
Tag:affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
default: "true"-
Jika true (benar), direktori genfiles akan dilipat ke dalam direktori tempat sampah.
Tag:affects_outputs
,incompatible_change
--[no]instrument_test_targets
default: "salah"-
Jika cakupan diaktifkan, tentukan apakah akan mempertimbangkan aturan pengujian instrumentasi. Jika ditetapkan, aturan pengujian yang disertakan oleh --instrumentation_filter akan diinstrumentasikan. Jika tidak, aturan pengujian selalu dikecualikan dari instrumentasi cakupan.
Tag:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
default: "-/javatests[/:],-/test/java[/:]"-
Jika cakupan diaktifkan, hanya aturan dengan nama yang disertakan oleh filter berbasis ekspresi reguler yang ditentukan yang akan diinstrumentasikan. Aturan yang diawali dengan '-' akan dikecualikan. Perhatikan bahwa hanya aturan non-pengujian yang diinstrumentasikan kecuali --instrument_test_targets diaktifkan.
Tag:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi iOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, 'ios_sdk_version' akan digunakan.
Tag:loses_incremental_state
--ios_multi_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk mem-build aplikasi ios_. Hasilnya adalah biner universal yang berisi semua arsitektur yang ditentukan.
Tag:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
default: "true"-
Tidak digunakan lagi, digantikan oleh --incompatible_remove_legacy_whole_archive (lihat https://github.com/bazelbuild/bazel/issues/7362 untuk mengetahui detailnya). Saat aktif, gunakan --whole-archive untuk aturan cc_binary yang memiliki linkshared=True dan linkstatic=True atau '-static' di linkopts. Ini hanya untuk kompatibilitas mundur. Alternatif yang lebih baik adalah menggunakan alwayslink=1 jika diperlukan.
Tag:action_command_lines
,affects_outputs
,deprecated
--linkopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke gcc saat menautkan.
Tag:action_command_lines
,affects_outputs
--ltobackendopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke langkah backend LTO (di bagian --features=thin_lto).
Tag:action_command_lines
,affects_outputs
--ltoindexopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke langkah pengindeksan LTO (pada --features=thin_lto).
Tag:action_command_lines
,affects_outputs
--macos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang akan digunakan untuk mem-build biner Apple macOS.
Tag:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi macOS minimum yang kompatibel untuk target. Jika tidak ditentukan, 'macos_sdk_version' akan digunakan.
Tag:loses_incremental_state
--memprof_profile=<a build target label>
default: lihat deskripsi-
Gunakan profil memprof.
Tag:affects_outputs
--[no]objc_debug_with_GLIBCXX
default: "salah"-
Jika disetel, dan mode kompilasi ditetapkan ke 'dbg', tentukan GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC, dan GLIBCPP_CONCEPT_CHECKS.
Tag:action_command_lines
--[no]objc_enable_binary_stripping
default: "salah"-
Apakah akan melakukan stripping simbol dan kode mati pada biner yang ditautkan. Pengupasan biner akan dilakukan jika tanda ini dan --compilation_mode=opt ditentukan.
Tag:action_command_lines
--objccopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke gcc saat mengompilasi file sumber Objective-C/C++.
Tag: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>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan secara selektif ke gcc saat mengompilasi file tertentu. Opsi ini dapat diteruskan beberapa kali. Sintaks: regex_filter@option_1,option_2,...,option_n. Di mana regex_filter adalah singkatan dari daftar pola sertakan dan kecualikan ekspresi reguler (Lihat juga --instrumentation_filter). option_1 menjadi option_n yang berarti opsi baris perintah arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ yang pertama digunakan untuk memisahkan string. Contoh: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 menambahkan opsi command line -O0 ke command line gcc dari semua file cc di //foo/ kecuali bar.cc.
Tag: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>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan secara selektif ke backend LTO (dalam --features=thin_lto) saat mengompilasi objek backend tertentu. Opsi ini dapat diteruskan beberapa kali. Sintaks: regex_filter@option_1,option_2,...,option_n. Di mana regex_filter merupakan singkatan dari daftar pola penyertaan dan kecualikan pola ekspresi reguler. options_1 menjadi option_n adalah singkatan dari opsi baris perintah arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ yang pertama digunakan untuk memisahkan string. Contoh: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 menambahkan opsi command line -O0 ke command line backend LTO dari semua file o di //foo/ kecuali bar.o.
Tag:action_command_lines
,affects_outputs
--platform_suffix=<a string>
default: lihat deskripsi-
Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.
Tag:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
default: lihat deskripsi-
Gunakan informasi profil Propeller untuk mengoptimalkan target build.Profil propeller harus terdiri dari minimal satu dari dua file, profil cc dan profil ld. Flag ini menerima label build yang harus merujuk pada file input profil propeller. Misalnya, file BUILD yang menentukan label, dalam a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Perintah ekspor_files mungkin harus ditambahkan ke paket yang sesuai agar file ini terlihat oleh Bazel. Opsi tersebut harus digunakan sebagai: --propeller_optimize=//a/b:propeller_profile
Tag:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
default: lihat deskripsi-
Nama jalur absolut file cc_profile untuk build yang Dioptimalkan untuk Propeller.
Tag:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
default: lihat deskripsi-
Nama jalur absolut file ld_profile untuk build yang Dioptimalkan untuk Propeller.
Tag:affects_outputs
--run_under=<a prefix in front of command>
default: lihat deskripsi-
Awalan yang akan disisipkan sebelum file yang dapat dieksekusi untuk perintah 'test' dan 'run'. Jika nilainya adalah 'foo -bar', dan command line eksekusi adalah 'test_binary -baz', command line terakhir adalah 'foo -bar test_binary -baz'.Ini juga dapat menjadi label untuk target yang dapat dieksekusi. Beberapa contohnya adalah: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Tag:action_command_lines
-
Jika benar, library native yang berisi fungsi identik akan dibagikan di antara target yang berbeda
Tag:loading_and_analysis
,affects_outputs
--[no]stamp
default: "salah"-
Stempel biner dengan tanggal, nama pengguna, nama host, informasi ruang kerja, dll.
Tag:affects_outputs
--strip=<always, sometimes or never>
default: "terkadang"-
Menentukan apakah akan menghapus biner dan library bersama (menggunakan "-Wl,--strip-debug"). Nilai {i>default<i} dari 'kadang-kadang' berarti strip iff --compilation_mode=fastbuild.
Tag:affects_outputs
--stripopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke strip saat membuat biner '<name>.stripped'.
Tag:action_command_lines
,affects_outputs
--symlink_prefix=<a string>
default: lihat deskripsi-
Awalan yang ditambahkan ke symlink praktis yang dibuat setelah build. Jika dihilangkan, nilai defaultnya adalah nama alat build yang diikuti dengan tanda hubung. Jika '/' diteruskan, tidak ada symlink yang dibuat dan tidak ada peringatan yang dimunculkan. Peringatan: fungsi khusus untuk '/' tidak akan digunakan lagi dalam waktu dekat; sebagai gantinya, gunakan --experimental_convenience_symlinks=ignore.
Tag:affects_outputs
--tvos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang memerlukan biner Apple tvOS.
Tag:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi tvOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, 'tvos_sdk_version' akan digunakan.
Tag:loses_incremental_state
--visionos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang memerlukan biner Apple visionOS.
Tag:loses_incremental_state
,loading_and_analysis
--watchos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang memerlukan biner Apple watchOS.
Tag:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi watchOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, 'watchos_sdk_version' akan digunakan.
Tag:loses_incremental_state
--xbinary_fdo=<a build target label>
default: lihat deskripsi-
Menggunakan informasi profil XbinaryFDO untuk mengoptimalkan kompilasi. Tentukan nama profil lintas biner default. Jika opsi tersebut digunakan bersama dengan --fdo_instrument/--fdo_optimize/--fdo_profile, opsi tersebut akan selalu berlaku seolah-olah xbinary_fdo tidak pernah ditentukan.
Tag:affects_outputs
- Opsi yang memengaruhi seberapa ketat Bazel dalam menerapkan input build yang valid (definisi aturan, kombinasi flag, dll.):
--auto_cpu_environment_group=<a build target label>
default: ""-
Deklarasikan lingkungan_group yang akan digunakan untuk memetakan nilai CPU ke nilai target_environment secara otomatis.
Tag:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
default: "salah"-
Pastikan batasan pemberian lisensi yang diberlakukan oleh paket dependen tidak bertentangan dengan mode distribusi target yang dibuat. Secara default, lisensi tidak dicentang.
Tag:build_file_semantics
--[no]check_visibility
default: "true"-
Jika dinonaktifkan, error visibilitas dalam dependensi target akan didemosikan menjadi peringatan.
Tag:build_file_semantics
--[no]desugar_for_android
default: "true"-
Apakah akan mendesugar bytecode Java 8 sebelum melakukan dexing.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
default: "salah"-
Apakah akan menyertakan library Java 8 yang didukung dalam aplikasi untuk perangkat lama.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
default: "true"-
Memeriksa lingkungan yang kompatibel dengan setiap target dan melaporkan error jika ada target yang memiliki dependensi yang tidak mendukung lingkungan yang sama
Tag:build_file_semantics
--[no]experimental_check_desugar_deps
default: "true"-
Apakah akan memeriksa kembali desugaring yang benar pada tingkat biner Android.
Tag:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<off, warning or error>
default: "OFF"-
Jika diaktifkan, periksa apakah dependensi aar_import sudah lengkap. Penerapan ini dapat merusak build, atau hanya menghasilkan peringatan.
Tag:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
default: "default"-
Jika true (benar), periksa apakah target Java secara eksplisit mendeklarasikan semua target yang digunakan secara langsung sebagai dependensi.
Tag:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
default: "salah"-
Jika diaktifkan, periksa (hanya pengujian) untuk menemukan target prasyarat yang merupakan file output dengan mencari aturan yang menghasilkan hanya uji coba. Ini cocok dengan pemeriksaan visibilitas.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
default: "salah"-
Jika diaktifkan, pemeriksaan visibilitas juga berlaku untuk implementasi toolchain.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
default: "salah"-
Jika diaktifkan, penggunaan langsung aturan Android native akan dinonaktifkan. Gunakan aturan Android Starlark dari https://github.com/bazelbuild/rules_android
Tag:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
default: "salah"-
Tanpa pengoperasian. Disimpan di sini untuk kompatibilitas mundur.
Tag:eagerness_to_exit
,incompatible_change
--[no]incompatible_python_disable_py2
default: "true"-
Jika true (benar), menggunakan setelan Python 2 akan menyebabkan error. Ini termasuk python_version=PY2, srcs_version=PY2, dan srcs_version=PY2ONLY. Lihat https://github.com/bazelbuild/bazel/issues/15684 untuk informasi selengkapnya.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
default: "true"-
Flag ini bersifat noop dan dijadwalkan untuk dihapus.
Tag:no_op
,incompatible_change
--python_native_rules_allowlist=<a build target label>
default: lihat deskripsi-
Daftar yang diizinkan (target paket_grup) untuk digunakan saat menerapkan --incompatible_python_disallow_native_rules.
Tag:loading_and_analysis
--[no]strict_filesets
default: "salah"-
Jika opsi ini diaktifkan, kumpulan file yang melewati batas paket akan dilaporkan sebagai error.
Tag:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
default: "error"-
Kecuali NONAKTIF, memeriksa apakah target proto_library secara eksplisit mendeklarasikan semua target yang digunakan secara langsung sebagai dependensi.
Tag:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Default
--strict_public_imports=<off, warn, error, strict or default>
: "off" -
Kecuali NONAKTIF, akan memeriksa apakah target proto_library secara eksplisit mendeklarasikan semua target yang digunakan dalam 'impor publik' sebagai diekspor.
Tag:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
default: "salah"-
Jika true (benar), header yang ditemukan melalui jalur penyertaan sistem (-isystem) juga harus dideklarasikan.
Tag:loading_and_analysis
,eagerness_to_exit
--target_environment=<a build target label>
beberapa penggunaan diakumulasikan-
Mendeklarasikan lingkungan target build ini. Harus berupa referensi label ke aturan "lingkungan". Jika ditentukan, semua target tingkat teratas harus kompatibel dengan lingkungan ini.
Tag:changes_inputs
- Opsi yang memengaruhi output penandatanganan build:
- Default
--apk_signing_method=<v1, v2, v1_v2 or v4>
: "v1_v2" -
Implementasi yang akan digunakan untuk menandatangani APK
Tag:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
default: "true"-
Jika disetel, dan mode kompilasi tidak 'opt', aplikasi objc akan menyertakan hak debug saat menandatangani.
Tag:changes_inputs
--ios_signing_cert_name=<a string>
default: lihat deskripsi-
Nama sertifikat yang akan digunakan untuk penandatanganan iOS. Jika tidak disetel, perangkat akan kembali ke profil penyediaan. Dapat berupa preferensi identitas keychain sertifikat atau (substring) dari nama umum sertifikat, sesuai halaman utama codesign (SIGNING IDENTITIES).
Tag:action_command_lines
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
default: "salah"-
Jika incompatible_enforce_config_setting_visi=false, berarti noop. Selain itu, jika tanda ini bernilai salah, config_setting apa pun yang tidak memiliki atribut visibilitas eksplisit akan menjadi //visibility:public. Jika tanda ini bernilai benar, config_setting mengikuti logika visibilitas yang sama seperti semua aturan lainnya. Lihat https://github.com/bazelbuild/bazel/issues/12933.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_legacy_py_provider
default: "true"-
Tanpa pengoperasian, akan segera dihapus.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
default: "salah"-
Jika true (benar), larang atribut sdk_frameworks dan active_sdk_frameworks di objc_library danobjc_import.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
default: "true"-
Jika true, terapkan batasan visibilitas config_setting. Jika false, setiap config_setting terlihat oleh setiap target. Lihat https://github.com/bazelbuild/bazel/issues/12932.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
default: "salah"-
Jika true (benar), tetapkan nilai default ke benar (true) untuk atribut alwayslink di objc_library dan objc_import.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
default: "salah"-
Jika true (benar), error akan terjadi saat menggunakan aturan py_* bawaan; aturan rule_python harus digunakan. Lihat https://github.com/bazelbuild/bazel/issues/17773 untuk informasi selengkapnya dan petunjuk migrasi.
Tag:loading_and_analysis
,incompatible_change
- Opsi yang mengatur perilaku lingkungan pengujian atau runner pengujian:
--[no]allow_analysis_failures
default: "salah"-
Jika true (benar), kegagalan analisis target aturan akan menyebabkan propagasi target dari instance AnalysisFailureInfo yang berisi deskripsi error, bukan mengakibatkan kegagalan build.
Tag:loading_and_analysis
,experimental
- Default
--analysis_testing_deps_limit=<an integer>
: "2000" -
Menetapkan jumlah maksimum dependensi transitif melalui atribut aturan dengan transisi konfigurasi for_analysis_testing. Melebihi batas ini akan menyebabkan error aturan.
Tag:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
default: "salah"-
Jika kegagalan tindakan dex2oat yang sebenarnya akan menyebabkan build rusak, bukan mengeksekusi dex2oat selama runtime pengujian.
Tag:loading_and_analysis
,experimental
--[no]check_tests_up_to_date
default: "salah"-
Jangan menjalankan pengujian, tetapi cukup periksa apakah pengujian tersebut sudah yang terbaru. Jika semua hasil pengujian merupakan yang terbaru, pengujian akan berhasil diselesaikan. Jika pengujian perlu dibuat atau dijalankan, error akan dilaporkan dan pengujian akan gagal. Opsi ini menyiratkan perilaku --check_up_to_date.
Tag:execution
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g memory=10,30,60,100>
beberapa penggunaan diakumulasikan- Mengganti jumlah resource default untuk pengujian. Format yang diharapkan adalah <resource>=<value>. Jika satu angka positif ditetapkan sebagai <value>, resource default untuk semua ukuran pengujian akan diganti. Jika 4 angka yang dipisahkan koma ditentukan, angka tersebut akan menggantikan jumlah resource untuk masing-masing ukuran pengujian kecil, sedang, besar, dan sangat besar. Nilai juga bisa berupa HOST_RAM/HOST_CPU, secara opsional diikuti oleh [-|*]<float> (mis. memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4). Resource pengujian default yang ditentukan oleh flag ini diganti oleh resource eksplisit yang ditentukan dalam tag.
--[no]experimental_android_use_parallel_dex2oat
default: "salah"-
Gunakan dex2oat secara paralel untuk mempercepat android_test.
Tag: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>
beberapa penggunaan diakumulasikan-
Setiap pengujian akan dicoba ulang hingga jumlah yang ditentukan jika terjadi kegagalan pengujian. Pengujian yang memerlukan lebih dari satu upaya untuk lulus ditandai sebagai 'FLAKY' dalam ringkasan pengujian. Biasanya nilai yang ditentukan hanya berupa bilangan bulat atau string 'default'. Jika berupa bilangan bulat, semua pengujian akan dijalankan hingga N kali. Jika 'default', hanya satu upaya pengujian yang akan dibuat untuk pengujian reguler dan tiga untuk pengujian yang secara eksplisit ditandai sebagai tidak stabil oleh aturannya (atribut tidak stabil=1). Sintaksis alternatif: regex_filter@flaky_test_attempts. Di mana flaky_test_attempts seperti di atas dan regex_filter adalah singkatan dari daftar pola sertakan dan kecualikan ekspresi reguler (Lihat juga --runs_per_test ). Contoh: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 men-deflakes semua pengujian di //foo/ kecuali yang berada di bawah foo/bar tiga kali. Opsi ini dapat diteruskan beberapa kali. Argumen yang terakhir diteruskan yang cocok akan diprioritaskan. Jika tidak ada yang cocok, perilakunya adalah seolah-olah 'default' di atas.
Tag:execution
--[no]ios_memleaks
default: "salah"-
Mengaktifkan pemeriksaan kebocoran memori di target ios_test.
Tag:action_command_lines
--ios_simulator_device=<a string>
default: lihat deskripsi-
Perangkat yang akan disimulasikan saat menjalankan aplikasi iOS di simulator, misalnya 'iPhone 6'. Anda bisa mendapatkan daftar perangkat dengan menjalankan 'xcrun simctl list devicetypes' di mesin tempat simulator akan dijalankan.
Tag:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi iOS yang akan dijalankan pada simulator saat dijalankan atau diuji. Nilai ini diabaikan untuk aturan ios_test jika perangkat target ditentukan dalam aturan.
Tag: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">
default: "otomatis"-
Jumlah maksimum tugas pengujian lokal yang akan dijalankan secara serentak. Memerlukan bilangan bulat, atau kata kunci ("otomatis", "HOST_CPUS", "HOST_RAM"), dapat diikuti dengan operasi ([-|*]<float>) misalnya, "otomatis", "HOST_CPUS*.5". 0 berarti resource lokal akan membatasi jumlah tugas pengujian lokal yang dijalankan secara serentak. Menetapkan nilai ini lebih besar daripada nilai untuk --jobs tidak akan efektif.
Tag:execution
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
beberapa penggunaan diakumulasikan- Menentukan jumlah waktu untuk menjalankan setiap pengujian. Jika salah satu upaya tersebut gagal karena alasan apa pun, seluruh pengujian akan dianggap gagal. Biasanya nilai yang ditentukan hanya berupa bilangan bulat. Contoh: --runs_per_test=3 akan menjalankan semua pengujian 3 kali. Sintaksis alternatif: regex_filter@runs_per_test. Di mana run_per_test merupakan singkatan dari nilai integer dan regex_filter adalah singkatan dari daftar yang mencakup dan mengecualikan pola ekspresi reguler (Lihat juga --instrumentation_filter). Contoh: --runs_per_test=//foo/.*,-//foo/bar/.*@3 menjalankan semua pengujian di //foo/ kecuali yang berada di bawah foo/bar tiga kali. Opsi ini dapat diteruskan beberapa kali. Argumen yang terakhir diteruskan yang cocok akan diprioritaskan. Jika tidak ada yang cocok, pengujian hanya akan dijalankan sekali.
--test_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan variabel lingkungan tambahan yang akan dimasukkan ke lingkungan runner pengujian. Variabel dapat ditentukan berdasarkan nama, dan nilainya akan dibaca dari lingkungan klien Bazel, atau berdasarkan pasangan nama=nilai. Opsi ini dapat digunakan beberapa kali untuk menentukan beberapa variabel. Hanya digunakan oleh perintah 'bazel test'.
Tag:test_runner
--[no]test_keep_going
default: "true"-
Jika dinonaktifkan, pengujian yang tidak lulus akan menyebabkan seluruh build dihentikan. Secara default, semua pengujian dijalankan, meskipun beberapa pengujian tidak lulus.
Tag:execution
--test_strategy=<a string>
default: ""-
Menentukan strategi yang akan digunakan saat menjalankan pengujian.
Tag:execution
- Default
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - Mengganti nilai waktu tunggu pengujian default untuk waktu tunggu pengujian (dalam detik). Jika ditentukan, hanya satu nilai bilangan bulat positif yang akan mengganti semua kategori. Jika ditentukan 4 bilangan bulat yang dipisahkan koma, waktu tunggu tersebut akan menggantikan waktu tunggu untuk singkat, sedang, panjang, dan abadi (dalam urutan tersebut). Dalam kedua bentuk tersebut, nilai -1 akan memberi tahu blaze untuk menggunakan waktu tunggu defaultnya untuk kategori tersebut.
--test_tmpdir=<a path>
default: lihat deskripsi- Menentukan direktori sementara dasar untuk digunakan oleh 'bazel test'.
--[no]zip_undeclared_test_outputs
default: "true"-
Jika true (benar), output pengujian yang tidak dideklarasikan akan diarsipkan dalam file ZIP.
Tag:test_runner
- Opsi yang memicu pengoptimalan waktu build:
- Default
--cache_computed_file_digests=<a long integer>
: "50000" - Jika lebih besar dari 0, konfigurasi Bazel akan meng-cache ringkasan file dalam memori berdasarkan metadatanya, bukan menghitung ulang ringkasan dari disk setiap kali diperlukan. Menyetel ini ke 0 akan memastikan ketepatan karena tidak semua perubahan file dapat dicatat dari metadata file. Jika bukan 0, angka tersebut menunjukkan ukuran cache karena jumlah ringkasan file yang akan di-cache.
--[no]experimental_enable_skyfocus
default: "salah"-
Jika true (benar), aktifkan penggunaan --experimental_working_set guna mengurangi jejak memori Bazel untuk build inkremental. Fitur ini dikenal sebagai Skyfocus.
Tag:host_machine_resource_optimizations
--[no]experimental_filter_library_jar_with_program_jar
default: "salah"-
Filter ProGuard ProgramJar untuk menghapus class yang juga ada di LibraryJar.
Tag:action_command_lines
--[no]experimental_inmemory_dotd_files
default: "true"-
Jika diaktifkan, file .d C++ akan diteruskan dalam memori langsung dari node build jarak jauh, bukan ditulis ke disk.
Tag:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
default: "true"-
Jika diaktifkan, file dependensi (.jdeps) yang dihasilkan dari kompilasi Java akan diteruskan dalam memori langsung dari node build jarak jauh, bukan ditulis ke disk.
Tag:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_retain_test_configuration_across_testonly
default: "salah"-
Jika diaktifkan, --trim_test_configuration tidak akan memangkas konfigurasi pengujian untuk aturan yang ditandai sebagai testonly=1. Hal ini dimaksudkan untuk mengurangi masalah konflik tindakan ketika aturan non-pengujian bergantung pada aturan cc_test. Tidak berpengaruh jika --trim_test_configuration bernilai salah (false).
Tag:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
default: "salah"-
Jika diaktifkan, versi Starlark dari cc_import dapat digunakan.
Tag:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
default: "salah"-
Apakah akan mempersempit input ke kompilasi C/C++ dengan menguraikan baris #include dari file input. Hal ini dapat meningkatkan performa dan inkrementalitas dengan mengurangi ukuran hierarki input kompilasi. Namun, tindakan ini juga dapat merusak build karena pemindai penyertaan tidak sepenuhnya mengimplementasikan semantik preprosesor C. Secara khusus, fungsi ini tidak memahami perintah #include dinamis dan mengabaikan logika bersyarat praprosesor. Risiko ditanggung sendiri. Masalah apa pun yang terkait dengan laporan ini akan ditutup.
Tag:loading_and_analysis
,execution
,changes_inputs
--experimental_working_set=<comma-separated list of options>
default: ""-
Working set untuk Skyfocus. Tetapkan sebagai jalur root-relatif ruang kerja yang dipisahkan koma. Ini adalah flag stateful. Penentuan set yang berfungsi akan mempertahankannya untuk pemanggilan berikutnya, hingga ditetapkan ulang dengan set baru.
Tag:host_machine_resource_optimizations
--[no]incremental_dexing
default: "true"-
Melakukan sebagian besar pekerjaan untuk dexing secara terpisah untuk setiap file Jar.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
default: "HOST_CPUS"-
Tetapkan secara eksplisit jumlah total core CPU lokal yang tersedia bagi Bazel untuk dibelanjakan pada tindakan build yang dijalankan secara lokal. Mengambil integer, atau "HOST_CPUS", secara opsional diikuti oleh [-|*]<float> (mis. HOST_CPUS*.5 untuk menggunakan setengah dari core CPU yang tersedia). Secara default, ("HOST_CPUS"), Bazel akan mengkueri konfigurasi sistem untuk memperkirakan jumlah core CPU yang tersedia.
Tag:host_machine_resource_optimizations
--local_extra_resources=<a named float, 'name=value'>
beberapa penggunaan diakumulasikan-
Menetapkan jumlah resource tambahan yang tersedia untuk Bazel. Mengambil pasangan string-float. Dapat digunakan beberapa kali untuk menentukan beberapa jenis resource tambahan. Bazel akan membatasi tindakan yang berjalan serentak berdasarkan resource tambahan yang tersedia dan resource tambahan yang diperlukan. Pengujian dapat menyatakan jumlah resource tambahan yang dibutuhkan dengan menggunakan tag format "resources:<resoucename>:<amount>". CPU, RAM, dan resource yang tersedia tidak dapat disetel dengan flag ini.
Tag:host_machine_resource_optimizations
--local_ram_resources=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
default: "HOST_RAM*,67"-
Tetapkan secara eksplisit jumlah total RAM host lokal (dalam MB) yang tersedia bagi Bazel untuk dibelanjakan pada tindakan build yang dijalankan secara lokal. Memerlukan integer, atau "HOST_RAM", secara opsional diikuti oleh [-|*]<float> (mis. HOST_RAM*.5 untuk menggunakan setengah RAM yang tersedia). Secara default, ("HOST_RAM*.67"), Bazel akan mengkueri konfigurasi sistem untuk memperkirakan jumlah RAM yang tersedia dan akan menggunakan 67%-nya.
Tag:host_machine_resource_optimizations
--local_resources=<a named double, 'name=value', where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
beberapa penggunaan diakumulasikan-
Menetapkan jumlah resource yang tersedia untuk Bazel. Membawa penetapan ke float atau HOST_RAM/HOST_CPUS, secara opsional diikuti oleh [-|*]<float> (mis. memory=HOST_RAM*.5 untuk menggunakan setengah RAM yang tersedia). Dapat digunakan beberapa kali untuk menentukan beberapa jenis resource. Bazel akan membatasi tindakan yang berjalan secara serentak berdasarkan resource yang tersedia dan resource yang diperlukan. Pengujian dapat menyatakan jumlah resource yang dibutuhkan dengan menggunakan tag format "resources:<resource name>:<amount>". Mengganti resource yang ditentukan oleh --local_{cpu|ram|extra}_resources.
Tag:host_machine_resource_optimizations
--[no]objc_use_dotd_pruning
default: "true"-
Jika ditetapkan, file .d yang dimunculkan oleh clang akan digunakan untuk memangkas kumpulan input yang diteruskan ke kompilasi objc.
Tag:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
default: "salah"-
Saat membuat target //a:a, header proses di semua target yang menjadi dependensi //a:a (jika pemrosesan header diaktifkan untuk toolchain).
Tag:execution
--[no]trim_test_configuration
default: "true"-
Jika diaktifkan, opsi terkait pengujian akan dihapus di bawah tingkat atas build. Jika flag ini aktif, pengujian tidak dapat dibuat sebagai dependensi aturan bukan pengujian, tetapi perubahan pada opsi terkait pengujian tidak akan menyebabkan aturan non-pengujian dianalisis ulang.
Tag:loading_and_analysis
,loses_incremental_state
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
- Default
--build_event_upload_max_retries=<an integer>
: "4" -
Frekuensi maksimum Bazel harus mencoba kembali mengupload peristiwa build.
Tag:bazel_internal_configuration
--[no]experimental_bep_target_summary
default: "salah"- Apakah akan memublikasikan peristiwa TargetSummary.
--[no]experimental_build_event_expand_filesets
default: "salah"-
Jika true (benar), luaskan Filesets di BEP saat menampilkan file output.
Tag:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
default: "salah"-
Jika true, selesaikan sepenuhnya symlink Fileset relatif di BEP saat menampilkan file output. Memerlukan --experimental_build_event_expand_filesets.
Tag:affects_outputs
- Default
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1s" -
Penundaan minimum awal untuk backoff eksponensial percobaan ulang saat upload BEP gagal. (eksponen: 1,6)
Tag:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
default: lihat deskripsi-
Memilih cara mengupload artefak yang dirujuk dalam protokol peristiwa build.
Tag:affects_outputs
--[no]experimental_materialize_param_files_directly
default: "salah"-
Jika mewujud file parameter, lakukan dengan penulisan langsung ke disk.
Tag:execution
--[no]experimental_run_bep_event_include_residue
default: "salah"-
Apakah akan menyertakan residu command line dalam peristiwa build run yang mungkin berisi residu tersebut. Secara default, residu tidak disertakan dalam peristiwa build perintah run yang mungkin berisi residu tersebut.
Tag:affects_outputs
- Default
--experimental_skyfocus_dump_keys=<none, count or verbose>
: "none" -
Untuk men-debug Skyfocus. Membuang SkyKeys yang difokuskan (root, leaf, dependensi terfokus, rdep terfokus).
Tag:terminal_output
--[no]experimental_skyfocus_dump_post_gc_stats
default: "salah"-
Untuk men-debug Skyfocus. Jika diaktifkan, picu GC manual sebelum/setelah berfokus untuk melaporkan pengurangan ukuran heap. Tindakan ini akan meningkatkan latensi Skyfocus.
Tag:terminal_output
--[no]experimental_stream_log_file_uploads
default: "salah"-
Streaming file log yang diupload langsung ke penyimpanan jarak jauh, bukan menulisnya ke disk.
Tag:affects_outputs
--explain=<a path>
default: lihat deskripsi-
Menyebabkan sistem build menjelaskan setiap langkah build yang dijalankan. Penjelasan ditulis ke file log yang ditentukan.
Tag:affects_outputs
--[no]legacy_important_outputs
default: "true"-
Gunakan ini untuk menyembunyikan pembuatan kolom important_outputs lama di peristiwa TargetComplete. important_outputs diperlukan untuk integrasi Bazel ke ResultStore.
Tag:affects_outputs
--[no]materialize_param_files
default: "salah"-
Menulis file parameter perantara ke hierarki output bahkan saat menggunakan eksekusi tindakan jarak jauh. Berguna saat men-debug tindakan. Hal ini tersirat oleh --subcommands dan --verbose_failures.
Tag:execution
--max_config_changes_to_show=<an integer>
default: "3"-
Saat menghapus cache analisis karena perubahan pada opsi build, cache analisis ditampilkan hingga jumlah nama opsi yang diubah. Jika angka yang diberikan adalah -1, semua opsi yang diubah akan ditampilkan.
Tag:terminal_output
- Default
--max_test_output_bytes=<an integer>
: "-1" -
Menentukan ukuran log per-pengujian maksimum yang dapat ditampilkan saat --test_output adalah 'errors' atau 'all'. Berguna untuk menghindari membebani output dengan output pengujian yang berisi terlalu banyak noise. Header pengujian disertakan dalam ukuran log. Nilai negatif menyiratkan tidak ada batas. Outputnya semuanya atau tidak ada sama sekali.
Tag:test_runner
,terminal_output
,execution
--output_filter=<a valid Java regular expression>
default: lihat deskripsi-
Hanya menampilkan peringatan dan output tindakan untuk aturan dengan nama yang cocok dengan ekspresi reguler yang disediakan.
Tag:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
default: "0"-
Jumlah detik untuk menunggu antarlaporan tentang tugas yang masih berjalan. Nilai default 0 berarti laporan pertama akan dicetak setelah 10 detik, lalu 30 detik dan setelah progres tersebut dilaporkan sekali setiap menit. Saat --curses diaktifkan, progres akan dilaporkan setiap detik.
Tag:affects_outputs
--show_result=<an integer>
default: "1"-
Menampilkan hasil build. Untuk setiap target, nyatakan apakah target diperbarui atau tidak, dan jika ya, daftar file output yang dibuat. File yang dicetak adalah {i>string<i} yang praktis untuk disalin+menempel ke {i>shell<i}, untuk mengeksekusinya.
Opsi ini memerlukan argumen bilangan bulat, yang merupakan jumlah nilai minimum target sehingga informasi hasil tidak dicetak. Dengan demikian, angka nol menyebabkan penyembunyian pesan dan MAX_INT menyebabkan pencetakan hasil selalu terjadi. Defaultnya adalah satu.
Jika tidak ada yang dibuat untuk target, hasilnya dapat dihilangkan agar output tetap berada di bawah nilai minimum.
Tag:affects_outputs
--[no]subcommands
[-s
] default: "salah"-
Menampilkan subperintah yang dijalankan selama proses build. Tanda terkait: --execution_log_json_file, --execution_log_binary_file (untuk logging subperintah ke file dalam format yang mudah digunakan untuk alat).
Tag:terminal_output
--test_output=<summary, errors, all or streamed>
default: "ringkasan"-
Menentukan mode output yang diinginkan. Nilai yang valid adalah 'summary' menjadi output hanya ringkasan status pengujian, 'errors' untuk juga mencetak log pengujian untuk pengujian yang gagal, 'all' untuk mencetak log untuk semua pengujian dan 'di-streaming' untuk menghasilkan log untuk semua pengujian secara real time (ini akan memaksa pengujian untuk dijalankan secara lokal satu per satu terlepas dari nilai --test_strategy).
Tag:test_runner
,terminal_output
,execution
--test_summary=<short, terse, detailed, none or testcase>
default: "short"-
Menentukan format ringkasan pengujian yang diinginkan. Nilai yang valid adalah 'short' untuk mencetak informasi hanya tentang pengujian yang dijalankan, 'terse', untuk mencetak informasi hanya tentang pengujian yang gagal yang dijalankan, 'mendetail' untuk mencetak informasi detail tentang kasus pengujian yang gagal, 'testcase' untuk mencetak ringkasan dalam resolusi kasus pengujian, jangan mencetak informasi detail tentang kasus pengujian yang gagal dan 'none' untuk menghilangkan ringkasan.
Tag:terminal_output
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
default: "-.*"-
Mencetak informasi debug selama resolusi toolchain. Flag ini menggunakan ekspresi reguler, yang diperiksa berdasarkan jenis toolchain dan target tertentu untuk melihat mana yang akan di-debug. Beberapa regex dapat dipisahkan dengan koma, kemudian setiap regex diperiksa secara terpisah. Catatan: Output flag ini sangat kompleks dan kemungkinan hanya akan berguna bagi pakar dalam resolusi toolchain.
Tag:terminal_output
--[no]verbose_explanations
default: "salah"-
Meningkatkan panjang penjelasan yang dikeluarkan jika --explain diaktifkan. Tidak berpengaruh jika --explain tidak diaktifkan.
Tag:affects_outputs
--[no]verbose_failures
default: "salah"-
Jika perintah gagal, cetak command line lengkapnya.
Tag:terminal_output
- Opsi yang menentukan atau mengubah input umum ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--aspects_parameters=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan-
Menentukan nilai parameter aspek command line. Setiap nilai parameter ditentukan melalui <param_name>=<param_value>, misalnya 'my_param=my_val', dengan 'my_param' adalah parameter dari beberapa aspek dalam daftar --aspects atau diperlukan oleh sebuah aspek dalam daftar. Opsi ini dapat digunakan beberapa kali. Namun, Anda tidak boleh menetapkan nilai ke parameter yang sama lebih dari sekali.
Tag:loading_and_analysis
--flag_alias=<a 'name=value' flag alias>
beberapa penggunaan diakumulasikan-
Menetapkan nama singkat untuk flag Starlark. Dibutuhkan satu pasangan nilai kunci dalam bentuk "<key>=<value>" sebagai argumen.
Tag:changes_inputs
--[no]incompatible_default_to_explicit_init_py
default: "salah"-
Flag ini mengubah perilaku default sehingga file __init__.py tidak lagi dibuat secara otomatis di runfile target Python. Tepatnya, jika target py_binary atau py_test memiliki legacy_create_init yang disetel ke "auto" (default), ini diperlakukan sebagai false jika dan hanya jika tanda ini disetel. Lihat https://github.com/bazelbuild/bazel/issues/10076.
Tag:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
default: "true"-
Jika true (benar), target yang dibuat dalam konfigurasi Python 2 akan muncul pada root output yang menyertakan akhiran '-py2', sedangkan target yang dibuat untuk Python 3 akan muncul di root tanpa akhiran terkait Python. Ini berarti symlink praktis `bazel-bin` akan mengarah ke target Python 3, bukan Python 2. Jika mengaktifkan opsi ini, sebaiknya Anda juga mengaktifkan `--incompatible_py3_is_default`.
Tag:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
default: "true"-
Jika true, target `py_binary` dan `py_test` yang tidak menetapkan atribut `python_version` (atau `default_python_version`) akan ditetapkan secara default ke PY3, bukan PY2. Jika Anda menetapkan tanda ini, sebaiknya Anda juga menetapkan `--incompatible_py2_outputs_are_suffixed`.
Tag:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
default: "true"-
Jika disetel ke benar (true), aturan Python native yang dapat dieksekusi akan menggunakan runtime Python yang ditentukan oleh toolchain Python, bukan runtime yang diberikan oleh flag lama seperti --python_top.
Tag:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
default: lihat deskripsi-
Mode versi utama Python, baik `PY2` maupun `PY3`. Perhatikan bahwa hal ini diganti oleh target `py_binary` dan `py_test` (meskipun keduanya tidak menentukan versi secara eksplisit) sehingga biasanya tidak ada banyak alasan untuk menyediakan flag ini.
Tag:loading_and_analysis
,affects_outputs
--target_pattern_file=<a string>
default: ""-
Jika ditetapkan, build akan membaca pola dari file yang dinamai di sini, bukan dari command line. Menentukan file di sini serta pola command line merupakan suatu error.
Tag:changes_inputs
- Opsi caching dan eksekusi jarak jauh:
--experimental_remote_cache_eviction_retries=<an integer>
default: "0"-
Jumlah maksimum upaya percobaan ulang jika build mengalami error penghapusan cache jarak jauh. Nilai bukan nol secara implisit akan menetapkan --incompatible_remote_use_new_exit_code_for_lost_inputs ke true. ID pemanggilan baru akan dibuat untuk setiap percobaan. Jika Anda membuat ID panggilan dan memberikannya ke Bazel dengan --invocation_id, Anda tidak boleh menggunakan tanda ini. Sebagai gantinya, setel tanda --incompatible_remote_use_new_exit_code_for_lost_inputs dan periksa kode keluar 39.
Tag:execution
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
default: "true"-
Jika disetel ke benar (true), Bazel akan menggunakan kode keluar baru 39, bukan 34, jika cache jarak jauh mengeluarkan blob selama proses build.
Tag:incompatible_change
- Opsi lain, yang tidak dikategorikan.:
--[no]allow_analysis_cache_discard
default: "true"-
Jika menghapus cache analisis karena perubahan pada sistem build, menyetel opsi ini ke salah (false) akan menyebabkan bazel keluar, bukan melanjutkan build. Opsi ini tidak berpengaruh jika 'discard_analysis_cache' juga ditetapkan.
Tag:eagerness_to_exit
--[no]build_manual_tests
default: "salah"- Memaksa pembuatan target pengujian yang diberi tag 'manual'. Pengujian 'manual' dikecualikan dari pemrosesan. Opsi ini memaksanya untuk dibuat (tetapi tidak dieksekusi).
--build_tag_filters=<comma-separated list of options>
default: ""- Menentukan daftar tag yang dipisahkan koma. Secara opsional, setiap tag dapat diawali dengan '-' untuk menentukan tag yang dikecualikan. Hanya target tersebut yang akan dibuat yang berisi setidaknya satu tag yang disertakan dan tidak berisi tag yang dikecualikan. Opsi ini tidak memengaruhi serangkaian pengujian yang dijalankan dengan perintah 'test'; opsi tersebut diatur oleh opsi pemfilteran pengujian, misalnya '--test_tag_filters'
--[no]build_tests_only
default: "salah"- Jika ditentukan, hanya aturan *_test dan test_suite yang akan dibuat dan target lain yang ditentukan pada command line akan diabaikan. Secara default, semua yang diminta akan dibuat.
--[no]cache_test_results
[-t
] default: "otomatis"- Jika disetel ke 'otomatis', Bazel akan menjalankan kembali pengujian jika dan hanya jika: (1) Bazel mendeteksi perubahan dalam pengujian atau dependensinya, (2) pengujian ditandai sebagai eksternal, (3) beberapa pengujian diminta dengan --runs_per_test, atau(4) pengujian sebelumnya gagal. Jika disetel ke 'ya', Bazel akan meng-cache semua hasil pengujian kecuali pengujian yang ditandai sebagai eksternal. Jika disetel ke 'tidak', Bazel tidak akan menyimpan hasil pengujian apa pun dalam cache.
--[no]compile_one_dependency
default: "salah"- Mengompilasi satu dependensi file argumen. Hal ini berguna untuk pemeriksaan sintaksis file sumber di IDE, misalnya, dengan membangun kembali satu target yang bergantung pada file sumber untuk mendeteksi error sedini mungkin dalam siklus edit/build/pengujian. Argumen ini memengaruhi penafsiran semua argumen non-flag; alih-alih menjadi target untuk build, argumen ini adalah nama file sumber. Target arbitrer yang bergantung pada nama file sumber akan dibuat untuk setiap nama file sumber.
--deleted_packages=<comma-separated list of package names>
beberapa penggunaan diakumulasikan- Daftar nama paket yang dipisahkan koma yang akan dianggap tidak ada oleh sistem build, meskipun jika paket tersebut terlihat di suatu tempat pada jalur paket. Gunakan opsi ini ketika menghapus sub-paket 'x/y' dari paket 'x' yang ada. Misalnya, setelah menghapus x/y/BUILD di klien Anda, sistem build mungkin akan mengeluh jika menemukan label '//x:y/z' jika label tersebut masih disediakan oleh entri package_path lain. Menentukan --deleted_packages x/y akan menghindari masalah ini.
--[no]discard_analysis_cache
default: "salah"- Hapus cache analisis segera setelah fase analisis selesai. Mengurangi penggunaan memori hingga ~10%, tetapi membuat build inkremental lebih lanjut lebih lambat.
--execution_log_binary_file=<a path>
default: lihat deskripsi- Mencatat spawn yang dieksekusi ke dalam file ini sebagai proto SpawnExec yang dibatasi panjang, menurut src/main/protobuf/spawn.proto. Tanda terkait: --execution_log_json_file (format JSON teks; eksklusif bersama), --execution_log_sort (apakah akan mengurutkan log eksekusi), --subcommands (untuk menampilkan subperintah dalam output terminal).
--execution_log_json_file=<a path>
default: lihat deskripsi- Mencatat spawn yang dieksekusi ke dalam file ini sebagai representasi JSON yang dipisahkan baris baru dari proto SpawnExec, menurut src/main/protobuf/spawn.proto. Tanda terkait: --execution_log_binary_file (format protobuf biner; eksklusif bersama), --execution_log_sort (apakah akan mengurutkan log eksekusi), --subcommands (untuk menampilkan subperintah dalam output terminal).
--[no]execution_log_sort
default: "true"- Apakah akan mengurutkan log eksekusi, sehingga lebih mudah untuk membandingkan log di seluruh pemanggilan. Setel ke false untuk menghindari penggunaan CPU dan memori yang berpotensi signifikan di akhir pemanggilan, dengan mengorbankan produksi log dalam urutan eksekusi yang tidak deterministik. Hanya berlaku untuk format biner dan JSON; format yang ringkas tidak pernah diurutkan.
--[no]expand_test_suites
default: "true"-
Perluas target test_suite ke dalam pengujian konstituennya sebelum melakukan analisis. Jika tanda ini diaktifkan (default), pola target negatif akan diterapkan ke pengujian yang termasuk dalam rangkaian pengujian, jika tidak, pola target negatif tidak akan diterapkan. Menonaktifkan tanda ini berguna ketika aspek tingkat teratas diterapkan pada command line: lalu aspek tersebut dapat menganalisis target test_suite.
Tag:loading_and_analysis
--[no]experimental_cancel_concurrent_tests
default: "salah"-
Jika true (benar), Blaze akan membatalkan pengujian yang berjalan secara serentak pada saat pertama berhasil dijalankan. Parameter ini hanya berguna jika dikombinasikan dengan --runs_per_test_detects_flakes.
Tag:affects_outputs
,loading_and_analysis
--experimental_execution_log_compact_file=<a path>
default: lihat deskripsi- Mencatat spawn yang dieksekusi ke dalam file ini sebagai proto ExecLogEntry yang dibatasi panjang, menurut src/main/protobuf/spawn.proto. Seluruh file dikompresi zstd. Ini adalah format eksperimental yang masih dalam pengembangan aktif, dan dapat berubah kapan saja. Tanda terkait: --execution_log_binary_file (format protobuf biner; eksklusif bersama), --execution_log_json_file (format JSON teks; eksklusif bersama), --subcommands (untuk menampilkan subperintah dalam output terminal).
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
default: ""- Tidak digunakan lagi demi aspek. Memfilter kumpulan target untuk menjadwalkan extra_actions.
--[no]experimental_extra_action_top_level_only
default: "salah"- Tidak digunakan lagi demi aspek. Hanya menjadwalkan extra_actions untuk target tingkat teratas.
--[no]experimental_fetch_all_coverage_outputs
default: "salah"-
Jika true (benar), Bazel akan mengambil seluruh direktori data cakupan untuk setiap pengujian selama cakupan dijalankan.
Tag:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
default: "salah"-
Jika benar, cakupan untuk clang akan menghasilkan laporan LCOV.
Tag:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
default: "true"- Apakah akan membuat peta header J2ObjC secara paralel dengan transpilasi J2ObjC.
--[no]experimental_j2objc_shorter_header_path
default: "salah"-
Apakah membuat dengan jalur header yang lebih pendek (menggunakan "_ios", bukan "_j2objc").
Tag:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
default: "javabuilder"- Memungkinkan classpath yang dikurangi untuk kompilasi Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
default: "salah"-
Batasi --experimental_run_android_lint_on_java_rules ke library yang kompatibel dengan Android.
Tag:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
default: "salah"-
Apakah akan memvalidasi sumber java_*.
Tag:affects_outputs
--[no]explicit_java_test_deps
default: "salah"- Secara eksplisit menentukan dependensi untuk JUnit atau Hamcrest dalam java_test, bukan secara tidak sengaja memperoleh dari dependensi TestRunner. Saat ini hanya berfungsi untuk Bagas.
--[no]fetch
default: "true"- Mengizinkan perintah untuk mengambil dependensi eksternal. Jika disetel ke salah (false), perintah akan menggunakan versi dependensi yang di-cache, dan jika tidak ada, perintah tersebut akan gagal.
--host_java_launcher=<a build target label>
default: lihat deskripsi- Peluncur Java yang digunakan oleh alat yang dieksekusi selama proses build.
--host_javacopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan untuk diteruskan ke javac saat mem-build alat yang dijalankan selama proses build.
--host_jvmopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan untuk diteruskan ke VM Java saat mem-build alat yang dijalankan selama proses build. Opsi ini akan ditambahkan ke opsi startup VM dari setiap target java_binary.
--[no]incompatible_check_sharding_support
default: "true"-
Jika benar, Bazel akan gagal dalam pengujian dengan sharding jika runner pengujian tidak menunjukkan bahwa runner pengujian mendukung sharding dengan menyentuh file di jalur di TEST_SHARD_STATUS_FILE. Jika bernilai salah, runner pengujian yang tidak mendukung sharding akan menyebabkan semua pengujian berjalan di setiap shard.
Tag:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
default: "true"-
Jika benar, pengujian eksklusif akan dijalankan dengan strategi yang di-sandbox. Tambahkan tag 'local' untuk memaksakan pengujian eksklusif yang dijalankan secara lokal
Tag:incompatible_change
--[no]incompatible_strict_action_env
default: "salah"-
Jika true (benar), Bazel akan menggunakan lingkungan dengan nilai statis untuk PATH dan tidak mewarisi LD_LIBRARY_PATH. Gunakan --action_env=ENV_VARIABLE jika Anda ingin mewarisi variabel lingkungan tertentu dari klien, namun perhatikan bahwa hal tersebut dapat mencegah penyimpanan cache lintas-pengguna jika cache bersama digunakan.
Tag:loading_and_analysis
,incompatible_change
--j2objc_translation_flags=<comma-separated list of options>
beberapa penggunaan diakumulasikan- Opsi tambahan untuk diteruskan ke alat J2ObjC.
--java_debug
-
Menyebabkan mesin virtual Java pada pengujian java menunggu koneksi dari debugger yang sesuai dengan JDWP (seperti jdb) sebelum memulai pengujian. Menyiratkan -test_output=streamed.
Diluaskan ke:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
default: "true"- Membuat informasi dependensi (untuk saat ini, classpath waktu kompilasi) per target Java.
--[no]java_header_compilation
default: "true"- Mengompilasi ijar langsung dari sumber.
--java_language_version=<a string>
default: ""- Versi bahasa Java
--java_launcher=<a build target label>
default: lihat deskripsi- Peluncur Java yang akan digunakan saat mem-build biner Java. Jika flag ini disetel ke string kosong, peluncur JDK akan digunakan. Atribut "peluncur" menggantikan tanda ini.
--java_runtime_version=<a string>
default: "local_jdk"- Versi runtime Java
--javacopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan untuk diteruskan ke javac.
--jvmopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan untuk diteruskan ke VM Java. Opsi ini akan ditambahkan ke opsi startup VM dari setiap target java_binary.
--legacy_main_dex_list_generator=<a build target label>
default: lihat deskripsi- Menentukan biner yang akan digunakan untuk membuat daftar class yang harus ada di dex utama saat mengompilasi multidex lama.
- Default
--local_termination_grace_seconds=<an integer>
: "15" - Waktu untuk menunggu antara penghentian proses lokal karena waktu tunggu habis dan penonaktifan secara paksa.
--optimizing_dexer=<a build target label>
default: lihat deskripsi- Menentukan biner yang akan digunakan untuk melakukan dexing tanpa sharding.
--package_path=<colon-separated list of options>
default: "%workspace%"- Daftar yang dipisahkan titik dua berisi tempat mencari paket. Elemen yang dimulai dengan '%workspace%' akan relatif terhadap ruang kerja yang dicakup. Jika dihilangkan atau kosong, defaultnya adalah output 'bazel info default-package-path'.
--plugin=<a build target label>
beberapa penggunaan diakumulasikan- Plugin yang akan digunakan dalam build. Saat ini berfungsi dengan java_plugin.
--proguard_top=<a build target label>
default: lihat deskripsi- Menentukan versi ProGuard yang akan digunakan untuk penghapusan kode saat mem-build biner Java.
--proto_compiler=<a build target label>
default: "@bazel_tools//tools/proto:protoc"-
Label compiler proto.
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
default: "@bazel_tools//tools/proto:cc_toolchain"-
Label proto_lang_ toolchain() yang menjelaskan cara mengompilasi proto C++
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
default: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Label proto_lang_toolchain() yang menjelaskan cara mengompilasi proto j2objc
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
default: "@bazel_tools//tools/proto:java_Tool"-
Label proto_lang_ toolchain() yang menjelaskan cara mengompilasi proto Java
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
default: "@bazel_tools//tools/proto:javalite_toolchain"-
Label proto_lang_ toolchain() yang menjelaskan cara mengompilasi proto JavaLite
Tag:affects_outputs
,loading_and_analysis
--protocopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke compiler protobuf.
Tag:affects_outputs
--[no]runs_per_test_detects_flakes
default: "salah"- Jika benar, shard apa pun dengan minimal satu percobaan/percobaan lulus dan minimal satu percobaan/percobaan gagal akan mendapatkan status FLAKY.
--shell_executable=<a path>
default: lihat deskripsi-
Jalur absolut ke shell yang dapat dieksekusi untuk digunakan oleh Bazel. Jika variabel ini tidak disetel, tetapi variabel lingkungan BAZEL_SH ditetapkan pada pemanggilan Bazel pertama (yang memulai server Bazel), Bazel akan menggunakannya. Jika tidak ada yang ditetapkan, Bazel menggunakan jalur default hard code tergantung pada sistem operasi tempatnya berjalan (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, lainnya: /bin/bash). Perhatikan bahwa menggunakan shell yang tidak kompatibel dengan bash dapat menyebabkan kegagalan build atau kegagalan runtime dari biner yang dihasilkan.
Tag:loading_and_analysis
--[no]show_loading_progress
default: "true"- Jika diaktifkan, akan menyebabkan Bazel mencetak pesan "Memuat paket:".
--test_arg=<a string>
beberapa penggunaan diakumulasikan- Menentukan opsi dan argumen tambahan yang harus diteruskan ke pengujian yang dapat dieksekusi. Dapat digunakan beberapa kali untuk menentukan beberapa argumen. Jika beberapa pengujian dijalankan, masing-masing pengujian akan menerima argumen yang identik. Hanya digunakan oleh perintah 'bazel test'.
--test_filter=<a string>
default: lihat deskripsi- Menentukan filter untuk diteruskan ke framework pengujian. Digunakan untuk membatasi pengujian yang dijalankan. Perhatikan bahwa hal ini tidak memengaruhi target yang dibuat.
--test_lang_filters=<comma-separated list of options>
default: ""- Menentukan daftar bahasa pengujian yang dipisahkan koma. Secara opsional, setiap bahasa dapat diawali dengan '-' untuk menentukan bahasa yang dikecualikan. Hanya target pengujian yang akan ditemukan yang ditulis dalam bahasa tertentu. Nama yang digunakan untuk setiap bahasa harus sama dengan awalan bahasa di aturan *_test, misalnya salah satu dari 'cc', 'java', 'py', dll. Opsi ini memengaruhi perilaku --build_tests_only dan perintah pengujian.
- Default
--test_result_expiration=<an integer>
: "-1" - Opsi ini tidak digunakan lagi dan tidak berpengaruh.
--[no]test_runner_fail_fast
default: "salah"- Opsi cepat diteruskan ke runner pengujian gagal. Runner pengujian harus menghentikan eksekusi setelah kegagalan pertama.
- Default
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
: "eksplisit" - Tentukan strategi untuk sharding pengujian: 'eksplisit' untuk hanya menggunakan sharding jika atribut BUILD 'shard_count' ada. 'dinonaktifkan' agar tidak pernah menggunakan sharding pengujian. 'forced=k' untuk menerapkan shard 'k' untuk pengujian terlepas dari atribut BUILD 'shard_count'.
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
default: ""- Menentukan daftar ukuran pengujian yang dipisahkan koma. Setiap ukuran dapat diawali dengan '-' untuk menentukan ukuran yang dikecualikan. Hanya target pengujian tersebut yang akan ditemukan berisi setidaknya satu ukuran yang disertakan dan tidak berisi ukuran yang dikecualikan. Opsi ini memengaruhi perilaku --build_tests_only dan perintah pengujian.
--test_tag_filters=<comma-separated list of options>
default: ""- Menentukan daftar tag pengujian yang dipisahkan koma. Secara opsional, setiap tag dapat diawali dengan '-' untuk menentukan tag yang dikecualikan. Hanya target pengujian tersebut yang akan ditemukan berisi setidaknya satu tag yang disertakan dan tidak berisi tag yang dikecualikan. Opsi ini memengaruhi perilaku --build_tests_only dan perintah pengujian.
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
default: ""- Menentukan daftar waktu tunggu pengujian yang dipisahkan koma. Setiap waktu tunggu dapat diawali dengan '-' untuk menentukan waktu tunggu yang dikecualikan. Hanya target pengujian tersebut yang akan ditemukan berisi setidaknya satu waktu tunggu yang disertakan dan tidak berisi waktu tunggu yang dikecualikan. Opsi ini memengaruhi perilaku --build_tests_only dan perintah pengujian.
--tool_java_language_version=<a string>
default: ""- Versi bahasa Java yang digunakan untuk menjalankan alat yang diperlukan selama proses build
--tool_java_runtime_version=<a string>
default: "remotejdk_11"- Versi runtime Java yang digunakan untuk menjalankan alat selama proses build
--[no]use_ijars
default: "true"- Jika diaktifkan, opsi ini akan menyebabkan kompilasi Java menggunakan jar antarmuka. Ini akan menghasilkan kompilasi inkremental yang lebih cepat, tetapi pesan error dapat berbeda.
Opsi Kanonikalisasi tanda
Mewarisi semua opsi dari build.
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
default: "salah"-
Jika ditetapkan, cache repositori akan menerapkan hardlink pada file jika cache ditemukan, bukan menyalinnya. Hal ini dimaksudkan untuk menghemat kapasitas {i>disk<i}.
Tag:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
default: "0"-
Jumlah upaya maksimum untuk mencoba kembali error download. Jika ditetapkan ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark berdasarkan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi pada komputer yang lebih lambat dari yang diharapkan oleh pembuat aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_connector_attempts=<an integer>
: "8" -
Jumlah upaya maksimum untuk download http.
Tag:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
default: "0s"-
Waktu tunggu maksimum untuk percobaan ulang download http. Dengan nilai 0, tidak ada waktu tunggu maksimum yang ditentukan.
Tag:bazel_internal_configuration
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Skalakan semua waktu tunggu yang terkait dengan download http berdasarkan faktor yang diberikan
Tag:bazel_internal_configuration
--repository_cache=<a path>
default: lihat deskripsi-
Menentukan lokasi cache dari nilai yang didownload yang diperoleh selama pengambilan repositori eksternal. String kosong sebagai argumen meminta cache dinonaktifkan. Jika tidak, default '<output_user_root>/cache/repos/v1' akan digunakan
Tag:bazel_internal_configuration
--[no]repository_disable_download
default: "salah"-
Jika ditetapkan, mendownload menggunakan ctx.download{,_and_extract} tidak akan diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file arbitrer yang dapat dieksekusi yang mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang yang ditempati (0-100) dan di atas batas tersebut, GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika ditetapkan ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi yang mengontrol output perintah:
--[no]canonicalize_policy
default: "salah"-
Menampilkan kebijakan kanonis, setelah perluasan dan pemfilteran. Untuk menjaga agar output tetap bersih, argumen perintah kanonikalisasi TIDAK akan ditampilkan jika opsi ini disetel ke benar (true). Perhatikan bahwa perintah yang ditentukan oleh --for_command memengaruhi kebijakan yang difilter, dan jika tidak ada yang ditentukan, perintah default-nya adalah 'build'.
Tag:affects_outputs
,terminal_output
--[no]experimental_include_default_values
default: "true"-
Apakah opsi Starlark yang ditetapkan ke nilai defaultnya disertakan dalam output.
Tag:affects_outputs
,terminal_output
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
default: "salah"-
Jika incompatible_enforce_config_setting_visi=false, berarti noop. Selain itu, jika tanda ini bernilai salah, config_setting apa pun yang tidak memiliki atribut visibilitas eksplisit akan menjadi //visibility:public. Jika tanda ini bernilai benar, config_setting mengikuti logika visibilitas yang sama seperti semua aturan lainnya. Lihat https://github.com/bazelbuild/bazel/issues/12933.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_depset_for_java_output_source_jars
default: "true"-
Tanpa pengoperasian.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
default: "true"-
Jika true, terapkan batasan visibilitas config_setting. Jika false, setiap config_setting terlihat oleh setiap target. Lihat https://github.com/bazelbuild/bazel/issues/12932.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]separate_aspect_deps
default: "true"-
Tanpa pengoperasian
Tag:no_op
- Opsi yang berkaitan dengan semantik dan output Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan yanked di registry tempatnya berasal (jika bukan berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yanked yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Periksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan jika ketidakcocokan terdeteksi.
Tag:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
default: "peringatan"-
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan dalam modul root adalah versi yang sama dengan yang Anda dapatkan dalam grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasikannya ke kegagalan resolusi.
Tag:loading_and_analysis
--[no]ignore_dev_dependency
default: "salah"-
Jika true (benar), Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan dalam MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "update"-
Menentukan bagaimana dan apakah menggunakan lockfile atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `error` untuk menggunakan lockfile tetapi menampilkan error jika file tidak diperbarui, atau `off` tidak membaca atau menulis ke lockfile.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <module name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan merupakan jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
--vendor_dir=<a path>
default: lihat deskripsi-
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat membangun. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "1 dtk:2,20 dtk:3,1 m:5" -
Batas yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlah berupa bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap generasi lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan dengan koma.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi ketika peristiwa GC penuh terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC kecil terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi saat peristiwa GC kecil terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan setidaknya berada pada ambang batas ini, status Skyframe sementara yang tidak perlu akan hilang. Menyesuaikan hal ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari GC thrashing, jika GC thrashing (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada menyusun ulang status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
--experimental_command_profile=<cpu, wall, alloc or lock>
default: lihat deskripsi- Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alokasi, atau kunci) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa di bawah direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; penggunaan dengan risiko Anda sendiri.
--[no]experimental_record_metrics_for_all_mnemonics
default: "salah"- Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika ada file yang tidak kosong, baca file yang telah ditentukan dan bukan file WORKSPACE
Tag:changes_inputs
--for_command=<a string>
default: "build"-
Perintah yang menentukan opsi yang harus dikanonikalisasi.
Tag:affects_outputs
,terminal_output
--invocation_policy=<a string>
default: ""-
Menerapkan kebijakan pemanggilan ke opsi yang akan dikanonikalisasi.
Tag:affects_outputs
,terminal_output
- Opsi caching dan eksekusi jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file yang akan digunakan untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk cocok, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik mulai dari `$1`. Beberapa perintah `tulis ulang` untuk URL yang sama dapat diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
default: "otomatis"- Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dimulai ulang. Jika tidak, gunakan thread platform (yaitu thread OS) jika ditetapkan ke 'platform' atau thread virtual jika ditetapkan ke 'virtual'. Jika disetel ke 'auto', thread virtual akan digunakan jika tersedia (yaitu, berjalan di JDK 21+), jika tidak, thread pekerja tidak akan digunakan.
- Opsi lain, yang tidak dikategorikan.:
--deleted_packages=<comma-separated list of package names>
beberapa penggunaan diakumulasikan- Daftar nama paket yang dipisahkan koma yang akan dianggap tidak ada oleh sistem build, meskipun jika paket tersebut terlihat di suatu tempat pada jalur paket. Gunakan opsi ini ketika menghapus sub-paket 'x/y' dari paket 'x' yang ada. Misalnya, setelah menghapus x/y/BUILD di klien Anda, sistem build mungkin akan mengeluh jika menemukan label '//x:y/z' jika label tersebut masih disediakan oleh entri package_path lain. Menentukan --deleted_packages x/y akan menghindari masalah ini.
--[no]fetch
default: "true"- Mengizinkan perintah untuk mengambil dependensi eksternal. Jika disetel ke salah (false), perintah akan menggunakan versi dependensi yang di-cache, dan jika tidak ada, perintah tersebut akan gagal.
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <repositori name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--package_path=<colon-separated list of options>
default: "%workspace%"- Daftar yang dipisahkan titik dua berisi tempat mencari paket. Elemen yang dimulai dengan '%workspace%' akan relatif terhadap ruang kerja yang dicakup. Jika dihilangkan atau kosong, defaultnya adalah output 'bazel info default-package-path'.
--[no]show_loading_progress
default: "true"- Jika diaktifkan, akan menyebabkan Bazel mencetak pesan "Memuat paket:".
Opsi Bersihkan
Mewarisi semua opsi dari build.
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
default: "salah"-
Jika ditetapkan, cache repositori akan menerapkan hardlink pada file jika cache ditemukan, bukan menyalinnya. Hal ini dimaksudkan untuk menghemat kapasitas {i>disk<i}.
Tag:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
default: "0"-
Jumlah upaya maksimum untuk mencoba kembali error download. Jika ditetapkan ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark berdasarkan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi pada komputer yang lebih lambat dari yang diharapkan oleh pembuat aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_connector_attempts=<an integer>
: "8" -
Jumlah upaya maksimum untuk download http.
Tag:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
default: "0s"-
Waktu tunggu maksimum untuk percobaan ulang download http. Dengan nilai 0, tidak ada waktu tunggu maksimum yang ditentukan.
Tag:bazel_internal_configuration
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Skalakan semua waktu tunggu yang terkait dengan download http berdasarkan faktor yang diberikan
Tag:bazel_internal_configuration
--repository_cache=<a path>
default: lihat deskripsi-
Menentukan lokasi cache dari nilai yang didownload yang diperoleh selama pengambilan repositori eksternal. String kosong sebagai argumen meminta cache dinonaktifkan. Jika tidak, default '<output_user_root>/cache/repos/v1' akan digunakan
Tag:bazel_internal_configuration
--[no]repository_disable_download
default: "salah"-
Jika ditetapkan, mendownload menggunakan ctx.download{,_and_extract} tidak akan diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file arbitrer yang dapat dieksekusi yang mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang yang ditempati (0-100) dan di atas batas tersebut, GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika ditetapkan ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi yang mengontrol output perintah:
--[no]async
default: "salah"-
Jika true (benar), pembersihan output bersifat asinkron. Setelah selesai, perintah ini akan aman untuk menjalankan perintah baru di klien yang sama, meskipun penghapusan dapat berlanjut di latar belakang.
Tag:host_machine_resource_optimizations
--[no]expunge
default: "salah"-
Jika true (benar), clean akan menghapus seluruh hierarki yang berfungsi untuk instance bazel ini, yang mencakup semua file output sementara dan file build yang dibuat bazel, serta menghentikan server bazel jika sedang berjalan.
Tag:host_machine_resource_optimizations
--expunge_async
-
Jika ditentukan, clean secara asinkron akan menghapus seluruh hierarki yang berfungsi untuk instance bazel ini, yang mencakup semua file output sementara dan file build yang dibuat bazel, serta menghentikan server bazel jika sedang berjalan. Setelah selesai, perintah ini akan aman untuk menjalankan perintah baru di klien yang sama, meskipun penghapusan dapat berlanjut di latar belakang.
Diluaskan ke:
--expunge
--async
Tag:host_machine_resource_optimizations
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_depset_for_java_output_source_jars
default: "true"-
Tanpa pengoperasian.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]separate_aspect_deps
default: "true"-
Tanpa pengoperasian
Tag:no_op
- Opsi yang berkaitan dengan semantik dan output Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan yanked di registry tempatnya berasal (jika bukan berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yanked yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Periksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan jika ketidakcocokan terdeteksi.
Tag:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
default: "peringatan"-
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan dalam modul root adalah versi yang sama dengan yang Anda dapatkan dalam grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasikannya ke kegagalan resolusi.
Tag:loading_and_analysis
--[no]ignore_dev_dependency
default: "salah"-
Jika true (benar), Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan dalam MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "update"-
Menentukan bagaimana dan apakah menggunakan lockfile atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `error` untuk menggunakan lockfile tetapi menampilkan error jika file tidak diperbarui, atau `off` tidak membaca atau menulis ke lockfile.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <module name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan merupakan jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
--vendor_dir=<a path>
default: lihat deskripsi-
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat membangun. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "1 dtk:2,20 dtk:3,1 m:5" -
Batas yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlah berupa bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap generasi lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan dengan koma.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi ketika peristiwa GC penuh terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC kecil terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi saat peristiwa GC kecil terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan setidaknya berada pada ambang batas ini, status Skyframe sementara yang tidak perlu akan hilang. Menyesuaikan hal ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari GC thrashing, jika GC thrashing (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada menyusun ulang status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
--experimental_command_profile=<cpu, wall, alloc or lock>
default: lihat deskripsi- Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alokasi, atau kunci) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa di bawah direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; penggunaan dengan risiko Anda sendiri.
--[no]experimental_record_metrics_for_all_mnemonics
default: "salah"- Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika ada file yang telah diselesaikan yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi caching dan eksekusi jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file yang akan digunakan untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk cocok, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik mulai dari `$1`. Beberapa perintah `tulis ulang` untuk URL yang sama dapat diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
default: "otomatis"- Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dimulai ulang. Jika tidak, gunakan thread platform (yaitu thread OS) jika ditetapkan ke 'platform' atau thread virtual jika ditetapkan ke 'virtual'. Jika disetel ke 'auto', thread virtual akan digunakan jika tersedia (yaitu, berjalan di JDK 21+), jika tidak, thread pekerja tidak akan digunakan.
- Opsi lain, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <repositori name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
Opsi Konfigurasi
Opsi Cakupan
Mewarisi semua opsi dari test.
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
default: "salah"-
Jika ditetapkan, cache repositori akan menerapkan hardlink pada file jika cache ditemukan, bukan menyalinnya. Hal ini dimaksudkan untuk menghemat kapasitas {i>disk<i}.
Tag:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
default: "0"-
Jumlah upaya maksimum untuk mencoba kembali error download. Jika ditetapkan ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark berdasarkan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi pada komputer yang lebih lambat dari yang diharapkan oleh pembuat aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_connector_attempts=<an integer>
: "8" -
Jumlah upaya maksimum untuk download http.
Tag:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
default: "0s"-
Waktu tunggu maksimum untuk percobaan ulang download http. Dengan nilai 0, tidak ada waktu tunggu maksimum yang ditentukan.
Tag:bazel_internal_configuration
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Skalakan semua waktu tunggu yang terkait dengan download http berdasarkan faktor yang diberikan
Tag:bazel_internal_configuration
--repository_cache=<a path>
default: lihat deskripsi-
Menentukan lokasi cache dari nilai yang didownload yang diperoleh selama pengambilan repositori eksternal. String kosong sebagai argumen meminta cache dinonaktifkan. Jika tidak, default '<output_user_root>/cache/repos/v1' akan digunakan
Tag:bazel_internal_configuration
--[no]repository_disable_download
default: "salah"-
Jika ditetapkan, mendownload menggunakan ctx.download{,_and_extract} tidak akan diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file arbitrer yang dapat dieksekusi yang mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang yang ditempati (0-100) dan di atas batas tersebut, GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika ditetapkan ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_depset_for_java_output_source_jars
default: "true"-
Tanpa pengoperasian.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]separate_aspect_deps
default: "true"-
Tanpa pengoperasian
Tag:no_op
- Opsi yang berkaitan dengan semantik dan output Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan yanked di registry tempatnya berasal (jika bukan berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yanked yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Periksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan jika ketidakcocokan terdeteksi.
Tag:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
default: "peringatan"-
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan dalam modul root adalah versi yang sama dengan yang Anda dapatkan dalam grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasikannya ke kegagalan resolusi.
Tag:loading_and_analysis
--[no]ignore_dev_dependency
default: "salah"-
Jika true (benar), Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan dalam MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "update"-
Menentukan bagaimana dan apakah menggunakan lockfile atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `error` untuk menggunakan lockfile tetapi menampilkan error jika file tidak diperbarui, atau `off` tidak membaca atau menulis ke lockfile.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <module name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan merupakan jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
--vendor_dir=<a path>
default: lihat deskripsi-
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat membangun. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "1 dtk:2,20 dtk:3,1 m:5" -
Batas yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlah berupa bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap generasi lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan dengan koma.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi ketika peristiwa GC penuh terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC kecil terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi saat peristiwa GC kecil terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan setidaknya berada pada ambang batas ini, status Skyframe sementara yang tidak perlu akan hilang. Menyesuaikan hal ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari GC thrashing, jika GC thrashing (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada menyusun ulang status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
--experimental_command_profile=<cpu, wall, alloc or lock>
default: lihat deskripsi- Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alokasi, atau kunci) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa di bawah direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; penggunaan dengan risiko Anda sendiri.
--[no]experimental_record_metrics_for_all_mnemonics
default: "salah"- Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika ada file yang telah diselesaikan yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi caching dan eksekusi jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file yang akan digunakan untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk cocok, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik mulai dari `$1`. Beberapa perintah `tulis ulang` untuk URL yang sama dapat diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
default: "otomatis"- Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dimulai ulang. Jika tidak, gunakan thread platform (yaitu thread OS) jika ditetapkan ke 'platform' atau thread virtual jika ditetapkan ke 'virtual'. Jika disetel ke 'auto', thread virtual akan digunakan jika tersedia (yaitu, berjalan di JDK 21+), jika tidak, thread pekerja tidak akan digunakan.
- Opsi lain, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <repositori name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
Opsi Cquery
Mewarisi semua opsi dari test.
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
default: "salah"-
Jika ditetapkan, cache repositori akan menerapkan hardlink pada file jika cache ditemukan, bukan menyalinnya. Hal ini dimaksudkan untuk menghemat kapasitas {i>disk<i}.
Tag:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
default: "0"-
Jumlah upaya maksimum untuk mencoba kembali error download. Jika ditetapkan ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark berdasarkan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi pada komputer yang lebih lambat dari yang diharapkan oleh pembuat aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_connector_attempts=<an integer>
: "8" -
Jumlah upaya maksimum untuk download http.
Tag:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
default: "0s"-
Waktu tunggu maksimum untuk percobaan ulang download http. Dengan nilai 0, tidak ada waktu tunggu maksimum yang ditentukan.
Tag:bazel_internal_configuration
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Skalakan semua waktu tunggu yang terkait dengan download http berdasarkan faktor yang diberikan
Tag:bazel_internal_configuration
--repository_cache=<a path>
default: lihat deskripsi-
Menentukan lokasi cache dari nilai yang didownload yang diperoleh selama pengambilan repositori eksternal. String kosong sebagai argumen meminta cache dinonaktifkan. Jika tidak, default '<output_user_root>/cache/repos/v1' akan digunakan
Tag:bazel_internal_configuration
--[no]repository_disable_download
default: "salah"-
Jika ditetapkan, mendownload menggunakan ctx.download{,_and_extract} tidak akan diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file arbitrer yang dapat dieksekusi yang mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang yang ditempati (0-100) dan di atas batas tersebut, GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika ditetapkan ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_depset_for_java_output_source_jars
default: "true"-
Tanpa pengoperasian.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]separate_aspect_deps
default: "true"-
Tanpa pengoperasian
Tag:no_op
- Opsi yang berkaitan dengan output kueri dan semantik:
--aspect_deps=<off, conservative or precise>
default: "konservatif"-
Cara me-resolve dependensi aspek jika format output adalah salah satu dari {xml,proto,record}. 'off' berarti tidak ada dependensi aspek yang diselesaikan, 'konservatif' (default) berarti semua dependensi aspek yang dideklarasikan akan ditambahkan terlepas dari apakah dependensi tersebut diberi class aturan dependensi langsung atau tidak, 'precise' berarti hanya aspek yang ditambahkan yang mungkin aktif berdasarkan class aturan dependensi langsung. Perhatikan bahwa mode presisi mengharuskan pemuatan paket lain untuk mengevaluasi satu target sehingga membuatnya lebih lambat daripada mode lainnya. Perhatikan juga bahwa mode yang tepat pun tidak sepenuhnya tepat: keputusan apakah akan menghitung suatu aspek ditentukan dalam fase analisis, yang tidak dijalankan selama 'kueri bazel'.
Tag:build_file_semantics
--[no]consistent_labels
default: "salah"-
Jika diaktifkan, setiap perintah kueri akan memunculkan label seolah-olah oleh fungsi <code>str</code> Starlark yang diterapkan ke instance <code>Label</code>. Hal ini berguna untuk alat yang perlu mencocokkan {i>output<i} dari berbagai perintah kueri dan/atau label yang dihasilkan oleh aturan. Jika tidak diaktifkan, pemformat output bebas memunculkan nama repositori yang jelas (relatif terhadap repositori utama) agar output lebih mudah dibaca.
Tag:terminal_output
--[no]experimental_explicit_aspects
default: "salah"-
kueri, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: tanpa pengoperasian (aspek selalu diikuti).
Tag:terminal_output
--[no]graph:factored
default: "true"-
Jika benar, grafik akan dimunculkan 'difaktorkan', yaitu node yang setara secara topologis akan digabungkan bersama dan labelnya akan digabungkan. Opsi ini hanya berlaku untuk --output=graph.
Tag:terminal_output
- Default
--graph:node_limit=<an integer>
: "512" -
Panjang maksimum string label untuk node grafik dalam output. Label yang lebih panjang akan dipotong; -1 berarti tidak ada pemotongan. Opsi ini hanya berlaku untuk --output=graph.
Tag:terminal_output
--[no]implicit_deps
default: "true"-
Jika diaktifkan, dependensi implisit akan disertakan dalam grafik dependensi tempat kueri dioperasikan. Dependensi implisit adalah dependensi yang tidak disebutkan secara eksplisit dalam file BUILD tetapi ditambahkan oleh bazel. Untuk cquery, opsi ini mengontrol pemfilteran toolchain yang di-resolve.
Tag:build_file_semantics
--[no]include_aspects
default: "true"-
kueri, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: tanpa pengoperasian (aspek selalu diikuti).
Tag:terminal_output
--[no]incompatible_package_group_includes_double_slash
default: "true"-
Jika diaktifkan, saat menghasilkan output atribut `packages` package_group, `//` awal tidak akan dihilangkan.
Tag:terminal_output
,incompatible_change
--[no]infer_universe_scope
default: "salah"-
Jika ditetapkan dan --universe_scope tidak ditetapkan, nilai --universe_scope akan disimpulkan sebagai daftar pola target unik dalam ekspresi kueri. Perhatikan bahwa nilai --universe_scope yang disimpulkan untuk ekspresi kueri yang menggunakan fungsi cakupan alam semesta (misalnya `allrdeps`) mungkin bukan yang Anda inginkan, jadi sebaiknya gunakan opsi ini hanya jika Anda tahu apa yang Anda lakukan. Lihat https://bazel.build/reference/query#sky-query untuk mengetahui detail dan contohnya. Jika --universe_scope ditetapkan, nilai opsi ini akan diabaikan. Catatan: opsi ini hanya berlaku untuk `query` (bukan `cquery`).
Tag:loading_and_analysis
--[no]line_terminator_null
default: "salah"-
Apakah setiap format dihentikan dengan \0, bukan baris baru.
Tag:terminal_output
--[no]nodep_deps
default: "true"-
Jika diaktifkan, dependensi dari atribut "nodep" akan disertakan dalam grafik dependensi yang digunakan untuk mengoperasikan kueri. Contoh umum atribut "nodep" adalah "visibilitas". Jalankan dan uraikan output `info build-language` untuk mempelajari semua atribut "nodep" dalam bahasa build.
Tag:build_file_semantics
--output=<a string>
default: "label"-
Format yang akan digunakan untuk mencetak hasil kueri. Nilai yang diizinkan untuk cquery adalah: label, label_types, textproto, transisi, proto, downstream_proto, jsonproto. Jika memilih 'transitions', Anda juga harus menentukan opsi --transitions=(lite|full).
Tag:terminal_output
--[no]proto:default_values
default: "true"-
Jika true (benar), atribut yang nilainya tidak ditentukan secara eksplisit dalam file BUILD akan disertakan; jika tidak, atribut tersebut akan dihilangkan. Opsi ini berlaku untuk --output=proto
Tag:terminal_output
--[no]proto:definition_stack
default: "salah"-
Isi kolom proto definisi_stack, yang mencatat setiap instance aturan stack panggilan Starlark pada saat class aturan ditentukan.
Tag:terminal_output
--[no]proto:flatten_selects
default: "true"-
Jika diaktifkan, atribut yang dapat dikonfigurasi yang dibuat oleh select() akan diratakan. Untuk jenis daftar, representasi yang disatukan adalah daftar yang berisi setiap nilai peta yang dipilih dengan tepat satu kali. Jenis skalar diratakan menjadi null.
Tag:build_file_semantics
--[no]proto:include_attribute_source_aspects
default: "salah"-
Isi kolom proto source_aspect_name dari setiap Atribut dengan aspek sumber tempat atribut tersebut berasal (string kosong jika bukan).
Tag:terminal_output
--[no]proto:include_configurations
default: "true"-
jika diaktifkan, output proto akan menyertakan informasi tentang konfigurasi. Jika dinonaktifkan,format output proto cquery akan menyerupai format output kueri.
Tag:affects_outputs
--[no]proto:include_synthetic_attribute_hash
default: "salah"-
Apakah akan menghitung dan mengisi atribut $internal_attr_hash atau tidak.
Tag:terminal_output
--[no]proto:instantiation_stack
default: "salah"-
Isi stack panggilan pembuatan instance dari setiap aturan. Perhatikan bahwa stack harus ada
Tag:terminal_output
--[no]proto:locations
default: "true"-
Apakah akan menghasilkan informasi lokasi dalam output proto atau tidak.
Tag:terminal_output
- Default
--proto:output_rule_attrs=<comma-separated list of options>
: "all" -
Daftar atribut yang dipisahkan koma untuk disertakan dalam output. Setelan defaultnya adalah semua atribut. Setel ke string kosong agar tidak menghasilkan output atribut apa pun. Opsi ini berlaku untuk --output=proto.
Tag:terminal_output
--[no]proto:rule_inputs_and_outputs
default: "true"-
Apakah kolom rule_input dan rule_output mengisi atau tidak.
Tag:terminal_output
--query_file=<a string>
default: ""-
Jika ditetapkan, kueri akan membaca kueri dari file yang disebutkan di sini, bukan dari command line. Menentukan file di sini serta kueri command line merupakan suatu error.
Tag:changes_inputs
--[no]relative_locations
default: "salah"-
Jika true (benar), lokasi file BUILD dalam output xml dan proto akan bersifat relatif. Secara default, output lokasi adalah jalur absolut dan tidak akan konsisten di seluruh mesin. Anda dapat menyetel opsi ini ke benar (true) agar mendapatkan hasil yang konsisten di seluruh mesin.
Tag:terminal_output
- Default
--show_config_fragments=<off, direct or transitive>
: "off" -
Menampilkan fragmen konfigurasi yang diperlukan oleh aturan dan dependensi transitifnya. Hal ini dapat berguna untuk mengevaluasi seberapa banyak grafik target yang dikonfigurasi dapat dipangkas.
Tag:affects_outputs
--starlark:expr=<a string>
default: ""-
Ekspresi Starlark untuk memformat setiap target yang dikonfigurasi dalam mode --output=starlark cquery. Target yang dikonfigurasi terikat dengan 'target'. Jika --starlark:expr atau --starlark:file tidak ditetapkan, opsi ini akan ditetapkan secara default ke 'str(target.label)'. Menentukan --starlark:expr dan --starlark:file merupakan kesalahan.
Tag:terminal_output
--starlark:file=<a string>
default: ""-
Nama file yang menentukan fungsi Starlark yang disebut 'format', dari satu argumen, yang diterapkan ke setiap target yang dikonfigurasi untuk memformatnya sebagai string. Menentukan --starlark:expr dan --starlark:file merupakan kesalahan. Lihat bantuan untuk --output=starlark untuk detail tambahan.
Tag:terminal_output
--[no]tool_deps
default: "true"-
Kueri: Jika dinonaktifkan, dependensi pada 'exec configuration' tidak akan disertakan dalam grafik dependensi tempat kueri dioperasikan. Edge dependensi 'exec configuration', seperti yang berasal dari aturan 'proto_library' apa pun ke Protocol Compiler, biasanya mengarah ke alat yang dieksekusi selama build, bukan bagian dari program 'target' yang sama.
Cquery: Jika dinonaktifkan, memfilter semua target yang dikonfigurasi yang melewati transisi eksekusi dari target tingkat teratas yang menemukan target yang dikonfigurasi ini. Artinya, jika target tingkat atas ada dalam konfigurasi target, hanya target yang dikonfigurasi dan dalam konfigurasi target yang akan ditampilkan. Jika target tingkat teratas berada dalam konfigurasi eksekusi, hanya target yang dikonfigurasi dengan eksekusi yang akan ditampilkan. Opsi ini TIDAK akan mengecualikan toolchain yang telah diselesaikan.
Tag:build_file_semantics
- Default
--transitions=<full, lite or none>
: "none" -
Format yang digunakan cquery untuk mencetak informasi transisi.
Tag:affects_outputs
--universe_scope=<comma-separated list of options>
default: ""-
Kumpulan pola target yang dipisahkan koma (aditif dan pengurangan). Kueri dapat dilakukan di alam semesta yang ditentukan oleh penutupan transitif target yang ditentukan. Opsi ini digunakan untuk perintah kueri dan kueri.
Untuk cquery, input untuk opsi ini adalah target dari semua jawaban yang dibuat sehingga opsi ini dapat memengaruhi konfigurasi dan transisi. Jika opsi ini tidak ditentukan, target tingkat teratas dianggap sebagai target yang diuraikan dari ekspresi kueri. Catatan: Untuk cquery, tidak menentukan opsi ini dapat menyebabkan build rusak jika target yang diurai dari ekspresi kueri tidak dapat dibuat dengan opsi tingkat atas.
Tag:loading_and_analysis
- Opsi yang terkait dengan semantik dan output Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan yanked di registry tempatnya berasal (jika bukan berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yanked yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Periksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan jika ketidakcocokan terdeteksi.
Tag:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
default: "peringatan"-
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan dalam modul root adalah versi yang sama dengan yang Anda dapatkan dalam grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasikannya ke kegagalan resolusi.
Tag:loading_and_analysis
--[no]ignore_dev_dependency
default: "salah"-
Jika true (benar), Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan dalam MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "update"-
Menentukan bagaimana dan apakah menggunakan lockfile atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `error` untuk menggunakan lockfile tetapi menampilkan error jika file tidak diperbarui, atau `off` tidak membaca atau menulis ke lockfile.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <module name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan merupakan jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
--vendor_dir=<a path>
default: lihat deskripsi-
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat membangun. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "1 dtk:2,20 dtk:3,1 m:5" -
Batas yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlah berupa bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap generasi lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan dengan koma.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi ketika peristiwa GC penuh terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC kecil terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi saat peristiwa GC kecil terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan setidaknya berada pada ambang batas ini, status Skyframe sementara yang tidak perlu akan hilang. Menyesuaikan hal ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari GC thrashing, jika GC thrashing (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada menyusun ulang status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
--experimental_command_profile=<cpu, wall, alloc or lock>
default: lihat deskripsi- Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alokasi, atau kunci) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa di bawah direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; penggunaan dengan risiko Anda sendiri.
--[no]experimental_record_metrics_for_all_mnemonics
default: "salah"- Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika ada file yang telah diselesaikan yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi caching dan eksekusi jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file yang akan digunakan untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk cocok, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik mulai dari `$1`. Beberapa perintah `tulis ulang` untuk URL yang sama dapat diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
default: "otomatis"- Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dimulai ulang. Jika tidak, gunakan thread platform (yaitu thread OS) jika ditetapkan ke 'platform' atau thread virtual jika ditetapkan ke 'virtual'. Jika disetel ke 'auto', thread virtual akan digunakan jika tersedia (yaitu, berjalan di JDK 21+), jika tidak, thread pekerja tidak akan digunakan.
- Opsi lain, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <repositori name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut akan relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
- Opsi yang mengontrol eksekusi build:
--[no]experimental_inprocess_symlink_creation
default: "salah"-
Apakah akan melakukan panggilan sistem file langsung untuk membuat hierarki symlink
Tag:loading_and_analysis
,execution
,experimental
--[no]experimental_persistent_aar_extractor
default: "salah"-
Aktifkan ekstraktor aar persisten menggunakan pekerja.
Tag:execution
--[no]experimental_remotable_source_manifests
default: "salah"-
Apakah akan membuat tindakan manifes sumber dapat dipindahkan
Tag:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
default: "salah"-
Jika true, Bazel akan menjalankan cakupan pascapemrosesan untuk pengujian di spawn baru.
Tag:execution
--[no]experimental_strict_fileset_output
default: "salah"-
Jika opsi ini diaktifkan, kumpulan file akan memperlakukan semua artefak output sebagai file biasa. {i>Mockup <i}tidak akan melintasi direktori atau sensitif terhadap symlink.
Tag:execution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
default: ""-
Tambahkan atau hapus kunci dari info eksekusi tindakan berdasarkan mnemonik tindakan. Hanya berlaku untuk tindakan yang mendukung info eksekusi. Banyak tindakan umum yang mendukung info eksekusi, misalnya Genrule, CppCompile, Javac, StarlarkAction, TestRunner. Saat menentukan beberapa nilai, urutan penting karena banyak regex dapat berlaku untuk mnemonik yang sama.
Sintaks: "regex=[+-]key,regex=[+-]key,...".
Contoh:
'.*=+x,.*=-y,.*=+z' menambahkan 'x' dan 'z' ke, serta menghapus 'y' dari, info eksekusi untuk semua tindakan.
'Genrule=+require-x' menambahkan 'require-x' ke info eksekusi untuk semua tindakan Genrule.
'(?!Genrule).*=-require-x' menghapus 'require-x' dari info eksekusi untuk semua tindakan non-Genrule.
Tag:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Aktifkan tindakan dex dan desugar Android persisten menggunakan pekerja.
Diluaskan ke:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Tag:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Aktifkan pemroses resource Android persisten menggunakan pekerja.
Diluaskan ke:
--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
}--internal_persistent_busybox_tools
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_desugar
-
Aktifkan tindakan dex dan desugar Android multipleks yang persisten menggunakan pekerja.
Diluaskan ke:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Tag:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Aktifkan pemroses resource Android multipleks persisten menggunakan pekerja.
Diluaskan ke:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
}--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
-
Aktifkan alat Android persisten dan multipleks (dexing, desugaring, pemrosesan resource).
Diluaskan ke:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Tag:host_machine_resource_optimizations
,execution
--[no]use_target_platform_for_tests
default: "salah"-
Jika true (benar), Bazel akan menggunakan platform target untuk menjalankan pengujian, bukan grup eksekusi pengujian.
Tag:execution
- Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
--android_compiler=<a string>
default: lihat deskripsi-
Compiler target Android.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
default: "//external:android/crosstool"-
Lokasi compiler C++ yang digunakan untuk build Android.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
default: lihat deskripsi-
Target Android grte_top.
Tag:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
default: "android"-
Memilih penggabungan manifes yang akan digunakan untuk aturan android_binary. Tanda untuk membantu transisi ke penggabungan manifes Android dari penggabungan lama.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
default: ""-
Menetapkan platform yang digunakan target android_binary. Jika beberapa platform ditentukan, biner adalah APK gemuk, yang berisi biner native untuk setiap platform target yang ditentukan.
Tag:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
default: "@bazel_tools//tools/android:sdk"-
Menentukan platform/Android SDK yang digunakan untuk mem-build aplikasi Android.
Tag:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
default: "@bazel_tools//tools/cpp:toolchain"-
Label paket crosstool yang akan digunakan dalam aturan Apple dan Objc serta dependensinya.
Tag:loses_incremental_state
,changes_inputs
--cc_output_directory_tag=<a string>
default: ""-
Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.
Tag:affects_outputs
--compiler=<a string>
default: lihat deskripsi-
Compiler C++ yang akan digunakan untuk mengompilasi target.
Tag:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
default: "@bazel_tools//tools/test:lcov_merger"-
Lokasi biner yang digunakan untuk pascapemrosesan laporan cakupan mentah. Saat ini, file harus berupa grup file yang berisi satu file, yaitu biner. Default-nya adalah '//tools/test:lcov_merger'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
default: "@bazel_tools//tools/test:coverage_report_generator"-
Lokasi biner yang digunakan untuk membuat laporan cakupan. Saat ini, file harus berupa grup file yang berisi satu file, yaitu biner. Default-nya adalah '//tools/test:coverage_report_generator'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
default: "@bazel_tools//tools/test:coverage_support"-
Lokasi file dukungan yang diperlukan pada input setiap tindakan pengujian yang mengumpulkan cakupan kode. Default-nya adalah '//tools/test:coverage_support'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--custom_malloc=<a build target label>
default: lihat deskripsi-
Menentukan implementasi maloc kustom. Setelan ini mengganti atribut maloc dalam aturan build.
Tag:changes_inputs
,affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
beberapa penggunaan diakumulasikan-
Daftar ekspresi reguler yang dipisahkan koma, masing-masing jika perlu diawali dengan - (ekspresi negatif), ditetapkan (=) ke daftar target nilai batasan yang dipisahkan koma. Jika target tidak cocok dengan ekspresi negatif dan setidaknya satu ekspresi positif, resolusi toolchain-nya akan dijalankan seolah-olah telah mendeklarasikan nilai batasan sebagai batasan eksekusi. Contoh: //demo,-test=@platforms//cpus:x86_64 akan menambahkan 'x86_64' ke target mana pun di bawah //demo kecuali untuk yang namanya berisi 'test'.
Tag:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
default: "salah"-
Jika ditetapkan, tambahkan persyaratan eksekusi "require-xcode:{version}" ke setiap tindakan Xcode. Jika versi xcode memiliki label dengan tanda hubung, tambahkan juga persyaratan eksekusi "require-xcode-label:{version_label}".
Tag:loses_incremental_state
,loading_and_analysis
,execution
--[no]experimental_prefer_mutual_xcode
default: "true"-
Jika benar, gunakan Xcode terbaru yang tersedia secara lokal dan jarak jauh. Jika salah (false), atau jika tidak ada versi bersama yang tersedia, gunakan versi Xcode lokal yang dipilih melalui xcode-select.
Tag:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
default: ""-
Platform yang tersedia sebagai platform eksekusi untuk menjalankan tindakan. Platform dapat ditentukan berdasarkan target yang tepat, atau sebagai pola target. Platform ini akan dipertimbangkan sebelum yang dideklarasikan dalam file WORKSPACE oleh register_execution_platforms(). Opsi ini hanya dapat disetel satu kali; instance berikutnya akan mengganti setelan tanda sebelumnya.
Tag:execution
--extra_toolchains=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Aturan toolchain yang akan dipertimbangkan selama resolusi toolchain. Toolchain dapat ditentukan berdasarkan target yang tepat, atau sebagai pola target. Toolchain ini akan dipertimbangkan sebelum yang dideklarasikan dalam file WORKSPACE oleh register_toolchains().
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
default: lihat deskripsi-
Label ke library libc yang digunakan untuk check in. Nilai default dipilih oleh toolchain crosstool, dan Anda hampir tidak perlu menggantinya.
Tag:action_command_lines
,affects_outputs
--host_compiler=<a string>
default: lihat deskripsi-
Flag tanpa pengoperasian. Akan dihapus dalam rilis mendatang.
Tag:loading_and_analysis
,execution
--host_grte_top=<a label>
default: lihat deskripsi-
Jika ditentukan, setelan ini akan menggantikan direktori tingkat teratas libc (--grte_top) untuk konfigurasi eksekusi.
Tag:action_command_lines
,affects_outputs
--host_platform=<a build target label>
default: "@local_config_platform//:host"-
Label aturan platform yang menjelaskan sistem host.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
default: "true"-
Jika true (benar), Bazel tidak akan mengaktifkan fitur 'host' dan 'nonhost' di toolchain c++ (lihat https://github.com/bazelbuild/bazel/issues/7407 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
default: "true"-
Gunakan resolusi toolchain untuk memilih aturan Android SDK untuk Android (Starlark dan native)
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
default: "salah"-
Gunakan resolusi toolchain guna memilih Apple SDK untuk aturan Apple (Starlark dan native)
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
default: "true"-
Flag ini bersifat noop dan dijadwalkan untuk dihapus.
Tag:no_op
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
default: "true"-
Jika true (benar), Bazel tidak akan menautkan dependensi library ke seluruh arsip secara default (lihat https://github.com/bazelbuild/bazel/issues/7362 untuk mengetahui petunjuk migrasi).
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
default: "true"-
Flag ini bersifat noop dan dijadwalkan untuk dihapus.
Tag:no_op
,incompatible_change
--[no]incompatible_strip_executable_safely
default: "salah"-
Jika true, tindakan penghapusan untuk file yang dapat dieksekusi akan menggunakan flag -x, yang tidak melanggar resolusi simbol dinamis.
Tag:action_command_lines
,incompatible_change
-
Gunakan objek bersama antarmuka jika didukung oleh toolchain. Semua toolchain ELF saat ini mendukung setelan ini.
Tag:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Menentukan versi iOS SDK yang akan digunakan untuk membuat aplikasi iOS. Jika tidak ditentukan, versi SDK iOS default dari 'xcode_version' akan digunakan.
Tag:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Menentukan versi macOS SDK yang akan digunakan untuk mem-build aplikasi macOS. Jika tidak ditentukan, versi SDK macOS default dari 'xcode_version' akan digunakan.
Tag:loses_incremental_state
--minimum_os_version=<a string>
default: lihat deskripsi-
Versi OS minimum yang ditargetkan kompilasi Anda.
Tag:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
default: ""-
Lokasi file pemetaan yang menjelaskan platform yang akan digunakan jika tidak ada yang ditetapkan atau tanda yang akan ditetapkan ketika platform sudah ada. Harus terkait dengan root ruang kerja utama. Nilai defaultnya adalah 'platform_mappings' (file langsung di bawah root ruang kerja).
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
,immutable
--platforms=<a build target label>
default: ""-
Label aturan platform yang menjelaskan platform target untuk perintah saat ini.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
default: lihat deskripsi-
Tidak digunakan lagi, tanpa pengoperasian. Dinonaktifkan oleh `--incompatible_use_python_ toolchains`.
Tag:no_op
,deprecated
--python3_path=<a string>
default: lihat deskripsi-
Tidak digunakan lagi, tanpa pengoperasian. Dinonaktifkan oleh `--incompatible_use_python_ toolchains`.
Tag:no_op
,deprecated
--python_path=<a string>
default: lihat deskripsi-
Jalur absolut penafsir Python yang dipanggil untuk menjalankan target Python di platform target. Tidak digunakan lagi; dinonaktifkan oleh --incompatible_use_python_ toolchains.
Tag:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
default: lihat deskripsi-
Label py_runtime yang mewakili penafsir Python yang dipanggil untuk menjalankan target Python di platform target. Tidak digunakan lagi; dinonaktifkan oleh --incompatible_use_python_ toolchains.
Tag:loading_and_analysis
,affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Menentukan versi tvOS SDK yang akan digunakan untuk mem-build aplikasi tvOS. Jika tidak ditentukan, versi SDK tvOS default dari 'xcode_version' akan digunakan.
Tag:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Menentukan versi SDK watchOS yang akan digunakan untuk mem-build aplikasi watchOS. Jika tidak ditentukan, versi SDK watchOS default dari 'xcode_version' akan digunakan.
Tag:loses_incremental_state
--xcode_version=<a string>
default: lihat deskripsi-
Jika ditentukan, akan menggunakan Xcode dari versi yang ditentukan untuk tindakan build yang relevan. Jika tidak ditentukan, versi Xcode default eksekutor akan digunakan.
Tag:loses_incremental_state
--xcode_version_config=<a build target label>
default: "@bazel_tools//tools/cpp:host_xcodes"-
Label aturan xcode_config yang akan digunakan untuk memilih versi Xcode di konfigurasi build.
Tag:loses_incremental_state
,loading_and_analysis
- Opsi yang mengontrol output perintah:
--[no]apple_generate_dsym
default: "salah"-
Apakah akan menghasilkan file simbol debug(.dSYM).
Tag:affects_outputs
,action_command_lines
--[no]build_runfile_links
default: "true"-
Jika true (benar), buat forest symlink runfile untuk semua target. Jika false, tuliskan hanya saat diperlukan oleh tindakan lokal, uji, atau jalankan perintah.
Tag:affects_outputs
--[no]build_runfile_manifests
default: "true"-
Jika true (benar), menulis manifes runfile untuk semua target. Jika salah (false), hapus variabel tersebut. Pengujian lokal akan gagal dijalankan jika salah (false).
Tag:affects_outputs
--[no]build_test_dwp
default: "salah"-
Jika diaktifkan, saat mem-build pengujian C++ secara statis dan dengan fisi, file .dwp untuk biner pengujian juga akan otomatis dibuat.
Tag:loading_and_analysis
,affects_outputs
- Default
--cc_proto_library_header_suffixes=<comma-separated set of options>
: ".pb.h" -
Menetapkan akhiran file header yang dibuat oleh cc_proto_library.
Tag:affects_outputs
,loading_and_analysis
- Default
--cc_proto_library_source_suffixes=<comma-separated set of options>
: ".pb.cc" -
Menetapkan akhiran file sumber yang dibuat oleh cc_proto_library.
Tag:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
default: "salah"-
Menjalankan tindakan tambahan untuk versi Java API alternatif di proto_library.
Tag:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
default: "salah"-
Menjalankan tindakan tambahan untuk versi Java API alternatif di proto_library.
Tag:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
default: "salah"-
Simpan status fitur yang diaktifkan dan diminta sebagai output kompilasi.
Tag:affects_outputs
,experimental
--fission=<a set of compilation modes>
default: "tidak"-
Menentukan mode kompilasi yang menggunakan fisi untuk kompilasi dan link C++. Dapat berupa kombinasi {'fastbuild', 'dbg', 'opt'} atau nilai khusus 'yes' untuk mengaktifkan semua mode dan 'no' untuk menonaktifkan semua mode.
Tag:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
default: "true"-
Jika true (benar), aturan native akan menambahkan <code>DefaultInfo.files</code> dependensi data ke runfile-nya, yang cocok dengan perilaku yang direkomendasikan untuk aturan Starlark (https://bazel.build/extending/rules#runfiles_features_to_Hindari).
Tag:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
default: "true"-
Jika true, build runfile symlink forest untuk repositori eksternal dalam .runfiles/wsname/external/repo (selain .runfiles/repo).
Tag:affects_outputs
--[no]objc_generate_linkmap
default: "salah"-
Menentukan apakah akan membuat file peta link.
Tag:affects_outputs
--[no]save_temps
default: "salah"-
Jika disetel, output sementara dari gcc akan disimpan. Ini mencakup file .s (kode assembler), file .i (C yang diproses sebelumnya), dan file .ii (C++ yang diproses sebelumnya).
Tag:affects_outputs
- Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, tetapi memengaruhi nilainya, bukan keberadaannya:
--action_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi target. Variabel dapat ditetapkan berdasarkan nama, dalam hal ini nilai akan diambil dari lingkungan pemanggilan, atau oleh pasangan nama=nilai yang menetapkan nilai yang tidak bergantung pada lingkungan pemanggilan. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, nilai terbaru yang diperoleh, opsi untuk variabel yang berbeda akan diakumulasikan.
Tag:action_command_lines
--android_cpu=<a string>
default: "armeabi-v7a"-
CPU target Android.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
default: "true"-
Buat file data binding yang kompatibel dengan AndroidX. Ini hanya digunakan dengan databinding v2. Tanda ini tanpa pengoperasian.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
default: "true"-
Gunakan android databinding v2 dengan argumen 3.4.0. Tanda ini tanpa pengoperasian.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--android_dynamic_mode=<off, default or fully>
: "off" -
Menentukan apakah dependensi C++ aturan Android akan ditautkan secara dinamis ketika cc_binary tidak secara eksplisit membuat library bersama. 'default' berarti bazel akan memilih apakah akan menautkan secara dinamis. 'complete' berarti semua library akan ditautkan secara dinamis. 'off' berarti semua library akan ditautkan dalam sebagian besar mode statis.
Tag:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
default: "alfabet"-
Menetapkan urutan manifes yang diteruskan ke penggabungan manifes untuk biner Android. ALFABETIS berarti manifes diurutkan berdasarkan jalur relatif terhadap execroot. ALPHABETICAL_BY_CONFIGURATION berarti manifes diurutkan menurut jalur yang terkait dengan direktori konfigurasi dalam direktori output. DEPENDENSI berarti manifes diurutkan dengan setiap manifes library muncul sebelum manifes dependensinya.
Tag:action_command_lines
,execution
--[no]android_resource_shrinking
default: "salah"-
Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.
Tag:affects_outputs
,loading_and_analysis
--[no]build_python_zip
default: "otomatis"-
Buat zip python yang dapat dieksekusi; di Windows, nonaktif di platform lain
Tag:affects_outputs
--catalyst_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang memerlukan biner Apple Catalyst.
Tag:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
default: "salah"-
Jika ditentukan, Bazel akan menginstrumentasikan kode (menggunakan instrumentasi offline jika memungkinkan) dan akan mengumpulkan informasi cakupan selama pengujian. Hanya target yang cocok --instrumentation_filter yang akan terpengaruh. Biasanya opsi ini tidak boleh ditentukan secara langsung - perintah 'bazel scope' sebaiknya digunakan.
Tag:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] default: "fastbuild"-
Tentukan mode tempat biner akan dibangun. Nilai: 'fastbuild', 'dbg', 'opt'.
Tag:affects_outputs
,action_command_lines
--conlyopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke gcc saat mengompilasi file sumber C.
Tag:action_command_lines
,affects_outputs
--copt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke gcc.
Tag:action_command_lines
,affects_outputs
--cpu=<a string>
default: ""-
CPU target.
Tag:changes_inputs
,affects_outputs
--cs_fdo_absolute_path=<a string>
default: lihat deskripsi-
Menggunakan informasi profil CSFDO untuk mengoptimalkan kompilasi. Tentukan nama jalur absolut file zip yang berisi file profil, file profil LLVM mentah atau yang diindeks.
Tag:affects_outputs
--cs_fdo_instrument=<a string>
default: lihat deskripsi-
Membuat biner dengan instrumentasi FDO yang sensitif konteks. Dengan compiler Clang/LLVM, compiler ini juga menerima nama direktori tempat file profil mentah akan dibuang saat runtime.
Tag:affects_outputs
--cs_fdo_profile=<a build target label>
default: lihat deskripsi-
cs_fdo_profile yang mewakili profil sensitif konteks yang akan digunakan untuk pengoptimalan.
Tag:affects_outputs
--cxxopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke gcc saat mengompilasi file sumber C++.
Tag:action_command_lines
,affects_outputs
--define=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan-
Setiap opsi --define menentukan penetapan untuk variabel build. Dalam kasus beberapa nilai untuk suatu variabel, nilai terakhir yang akan menang.
Tag:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
default: "default"-
Menentukan apakah biner C++ akan ditautkan secara dinamis. 'default' berarti Bazel akan memilih apakah akan menautkan secara dinamis. 'complete' berarti semua library akan ditautkan secara dinamis. 'off' berarti semua library akan ditautkan dalam sebagian besar mode statis.
Tag:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
default: "true"-
Jika ditetapkan, penggunaan fdo_absolute_profile_path akan menimbulkan error.
Tag:affects_outputs
--[no]enable_runfiles
default: "otomatis"-
Aktifkan hierarki symlink runfiles; Secara default, fungsi ini nonaktif di Windows, di platform lain.
Tag:affects_outputs
--experimental_action_listener=<a build target label>
beberapa penggunaan diakumulasikan-
Tidak digunakan lagi demi aspek. Gunakan action_Listener untuk melampirkan extra_action ke tindakan build yang ada.
Tag:execution
,experimental
--[no]experimental_android_compress_java_resources
default: "salah"-
Kompresi resource Java dalam APK
Tag:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
default: "true"-
Gunakan databinding Android v2. Tanda ini tanpa pengoperasian.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
default: "salah"-
Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.
Tag:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
default: "salah"-
gunakan alat rex untuk menulis ulang file dex
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
default: "salah"-
Jika ditentukan, Bazel juga akan membuat informasi cakupan untuk file yang dihasilkan.
Tag:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
default: "-O0,-DDEBUG=1"-
Menggunakan string ini sebagai opsi compiler fastbuild objc.
Tag:action_command_lines
--[no]experimental_omitfp
default: "salah"-
Jika true (benar), gunakan libunwind untuk pelepasan stack (stack unwind), lalu kompilasi dengan -fomit-frame-pointer dan -fasync-unwind-tables.
Tag:action_command_lines
,affects_outputs
,experimental
- Default
--experimental_output_paths=<off, content or strip>
: "off" -
Model yang akan digunakan untuk tempat aturan hierarki output menulis output-nya, terutama untuk build multi-platform / multi-konfigurasi. Hal ini sangat eksperimental. Lihat https://github.com/bazelbuild/bazel/issues/6526 untuk mengetahui detailnya. Tindakan Starlark dapat digunakan dalam pemetaan jalur dengan menambahkan kunci 'supports-path-mapping' ke perintah 'execution_requirements'.
Tag:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
beberapa penggunaan diakumulasikan-
Setiap entri harus berupa label=value formulir dengan label merujuk ke platform dan nilai merupakan nama pendek yang diinginkan untuk digunakan di jalur output. Hanya digunakan jika --experimental_platform_in_output_dir benar. Memiliki prioritas penamaan tertinggi.
Tag:affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
default: "salah"-
Jika true (benar), nama pendek untuk platform target akan digunakan dalam nama direktori output, bukan CPU. Skema persisnya bersifat eksperimental dan dapat berubah sewaktu-waktu: Pertama, dalam kasus yang jarang terjadi, opsi --platforms tidak memiliki tepat satu nilai, hash opsi platform akan digunakan. Selanjutnya, jika ada nama pendek untuk platform saat ini yang didaftarkan oleh --experimental_override_name_platform_in_output_dir, maka nama pendek tersebut akan digunakan. Kemudian, jika --experimental_use_platforms_in_output_dir_legacy_heuristic ditetapkan, gunakan nama singkat berdasarkan Label platform saat ini. Akhirnya, {i>hash<i} dari opsi platform
digunakan sebagai upaya terakhir.
Tag:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
default: "salah"-
Jika ditentukan, Bazel akan membuat informasi peta cakupan llvm-cov, bukan gcov saat collect_code_coverage diaktifkan.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
default: "true"-
Harap gunakan tanda ini hanya sebagai bagian dari strategi migrasi atau pengujian yang disarankan. Perhatikan bahwa heuristik memiliki kekurangan yang telah diketahui, jadi sebaiknya migrasikan untuk hanya mengandalkan --experimental_override_name_platform_in_output_dir.
Tag:affects_outputs
,experimental
--fat_apk_cpu=<comma-separated set of options>
default: "armeabi-v7a"-
Menyetel opsi ini akan mengaktifkan APK lemak, yang berisi biner native untuk semua arsitektur target yang ditentukan, misalnya, --fat_apk_cpu=x86,armeabi-v7a. Jika flag ini ditentukan, maka --android_cpu diabaikan untuk dependensi aturan android_binary.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
default: "salah"-
Flag tanpa pengoperasian. Akan dihapus dalam rilis mendatang.
Tag:no_op
--fdo_instrument=<a string>
default: lihat deskripsi-
Membuat biner dengan instrumentasi FDO. Dengan compiler Clang/LLVM, compiler ini juga menerima nama direktori tempat file profil mentah akan dibuang saat runtime.
Tag:affects_outputs
--fdo_optimize=<a string>
default: lihat deskripsi-
Gunakan informasi profil FDO untuk mengoptimalkan kompilasi. Tentukan nama file zip yang berisi hierarki file .gcda, file afdo yang berisi profil otomatis, atau file profil LLVM. Tanda ini juga menerima file yang ditentukan sebagai label (mis. `//foo/bar:file.afdo` - Anda mungkin perlu menambahkan perintah `exports_files` ke paket terkait) dan label yang mengarah ke target `fdo_profile`. Tanda ini akan digantikan oleh aturan `fdo_profile`.
Tag:affects_outputs
--fdo_prefetch_hints=<a build target label>
default: lihat deskripsi-
Gunakan petunjuk pengambilan data cache.
Tag:affects_outputs
--fdo_profile=<a build target label>
default: lihat deskripsi-
fdo_profile yang mewakili profil yang akan digunakan untuk pengoptimalan.
Tag:affects_outputs
--features=<a string>
beberapa penggunaan diakumulasikan-
Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi target. Menentukan -<feature> akan menonaktifkan fitur. Fitur negatif selalu menggantikan fitur positif. Lihat juga --host_features
Tag:changes_inputs
,affects_outputs
--[no]force_pic
default: "salah"-
Jika diaktifkan, semua kompilasi C++ akan menghasilkan kode yang bergantung pada posisi ("-fPIC"), link akan lebih memilih library bawaan PIC daripada library non-PIC, dan link menghasilkan file yang dapat dieksekusi tanpa bergantung posisi ("-pie").
Tag:loading_and_analysis
,affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi eksekusi. Variabel dapat ditetapkan berdasarkan nama, dalam hal ini nilai akan diambil dari lingkungan pemanggilan, atau oleh pasangan nama=nilai yang menetapkan nilai yang tidak bergantung pada lingkungan pemanggilan. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, nilai terbaru yang diperoleh, opsi untuk variabel yang berbeda akan diakumulasikan.
Tag:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
default: "opt"-
Tentukan mode yang akan digunakan alat selama proses build. Nilai: 'fastbuild', 'dbg', 'opt'.
Tag:affects_outputs
,action_command_lines
--host_conlyopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke compiler C saat mengompilasi file sumber C (tetapi bukan C++) dalam konfigurasi exec.
Tag:action_command_lines
,affects_outputs
--host_copt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke compiler C untuk alat yang dibuat dalam konfigurasi exec.
Tag:action_command_lines
,affects_outputs
--host_cpu=<a string>
default: ""-
CPU host.
Tag:changes_inputs
,affects_outputs
--host_cxxopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke compiler C++ untuk alat yang dibuat dalam konfigurasi exec.
Tag:action_command_lines
,affects_outputs
--host_features=<a string>
beberapa penggunaan diakumulasikan-
Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi exec. Menentukan -<feature> akan menonaktifkan fitur. Fitur negatif selalu menggantikan fitur positif.
Tag:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
default: lihat deskripsi-
Mengganti versi Python untuk konfigurasi exec. Dapat berupa "PY2" atau "PY3".
Tag:loading_and_analysis
,affects_outputs
--host_linkopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke penaut saat menautkan alat dalam konfigurasi eksekusi.
Tag:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi macOS minimum yang kompatibel untuk target host. Jika tidak ditentukan, 'macos_sdk_version' akan digunakan.
Tag: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>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan secara selektif ke compiler C/C++ saat mengompilasi file tertentu dalam konfigurasi exec. Opsi ini dapat diteruskan beberapa kali. Sintaks: regex_filter@option_1,option_2,...,option_n. Di mana regex_filter adalah singkatan dari daftar pola sertakan dan kecualikan ekspresi reguler (Lihat juga --instrumentation_filter). option_1 menjadi option_n yang berarti opsi baris perintah arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ yang pertama digunakan untuk memisahkan string. Contoh: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 menambahkan opsi command line -O0 ke command line gcc dari semua file cc di //foo/ kecuali bar.cc.
Tag:action_command_lines
,affects_outputs
--[no]incompatible_auto_exec_groups
default: "salah"-
Jika diaktifkan, grup eksekusi akan otomatis dibuat untuk setiap toolchain yang digunakan oleh suatu aturan. Agar aturan ini berfungsi, perlu menentukan parameter `toolchain` pada tindakannya. Untuk informasi selengkapnya, lihat https://github.com/bazelbuild/bazel/issues/17134.
Tag:affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
default: "true"-
Jika true (benar), direktori genfiles akan dilipat ke dalam direktori tempat sampah.
Tag:affects_outputs
,incompatible_change
--[no]instrument_test_targets
default: "salah"-
Jika cakupan diaktifkan, tentukan apakah akan mempertimbangkan aturan pengujian instrumentasi. Jika ditetapkan, aturan pengujian yang disertakan oleh --instrumentation_filter akan diinstrumentasikan. Jika tidak, aturan pengujian selalu dikecualikan dari instrumentasi cakupan.
Tag:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
default: "-/javatests[/:],-/test/java[/:]"-
Jika cakupan diaktifkan, hanya aturan dengan nama yang disertakan oleh filter berbasis ekspresi reguler yang ditentukan yang akan diinstrumentasikan. Aturan yang diawali dengan '-' akan dikecualikan. Perhatikan bahwa hanya aturan non-pengujian yang diinstrumentasikan kecuali --instrument_test_targets diaktifkan.
Tag:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi iOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, 'ios_sdk_version' akan digunakan.
Tag:loses_incremental_state
--ios_multi_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk mem-build aplikasi ios_. Hasilnya adalah biner universal yang berisi semua arsitektur yang ditentukan.
Tag:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
default: "true"-
Tidak digunakan lagi, digantikan oleh --incompatible_remove_legacy_whole_archive (lihat https://github.com/bazelbuild/bazel/issues/7362 untuk mengetahui detailnya). Saat aktif, gunakan --whole-archive untuk aturan cc_binary yang memiliki linkshared=True dan linkstatic=True atau '-static' di linkopts. Ini hanya untuk kompatibilitas mundur. Alternatif yang lebih baik adalah menggunakan alwayslink=1 jika diperlukan.
Tag:action_command_lines
,affects_outputs
,deprecated
--linkopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke gcc saat menautkan.
Tag:action_command_lines
,affects_outputs
--ltobackendopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke langkah backend LTO (di bagian --features=thin_lto).
Tag:action_command_lines
,affects_outputs
--ltoindexopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke langkah pengindeksan LTO (pada --features=thin_lto).
Tag:action_command_lines
,affects_outputs
--macos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang akan digunakan untuk mem-build biner Apple macOS.
Tag:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi macOS minimum yang kompatibel untuk target. Jika tidak ditentukan, 'macos_sdk_version' akan digunakan.
Tag:loses_incremental_state
--memprof_profile=<a build target label>
default: lihat deskripsi-
Gunakan profil memprof.
Tag:affects_outputs
--[no]objc_debug_with_GLIBCXX
default: "salah"-
Jika disetel, dan mode kompilasi ditetapkan ke 'dbg', tentukan GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC, dan GLIBCPP_CONCEPT_CHECKS.
Tag:action_command_lines
--[no]objc_enable_binary_stripping
default: "salah"-
Apakah akan melakukan stripping simbol dan kode mati pada biner yang ditautkan. Pengupasan biner akan dilakukan jika tanda ini dan --compilation_mode=opt ditentukan.
Tag:action_command_lines
--objccopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke gcc saat mengompilasi file sumber Objective-C/C++.
Tag: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>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan secara selektif ke gcc saat mengompilasi file tertentu. Opsi ini dapat diteruskan beberapa kali. Sintaks: regex_filter@option_1,option_2,...,option_n. Di mana regex_filter adalah singkatan dari daftar pola sertakan dan kecualikan ekspresi reguler (Lihat juga --instrumentation_filter). option_1 menjadi option_n yang berarti opsi baris perintah arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ yang pertama digunakan untuk memisahkan string. Contoh: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 menambahkan opsi command line -O0 ke command line gcc dari semua file cc di //foo/ kecuali bar.cc.
Tag: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>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan secara selektif ke backend LTO (dalam --features=thin_lto) saat mengompilasi objek backend tertentu. Opsi ini dapat diteruskan beberapa kali. Sintaks: regex_filter@option_1,option_2,...,option_n. Di mana regex_filter merupakan singkatan dari daftar pola penyertaan dan kecualikan pola ekspresi reguler. options_1 menjadi option_n adalah singkatan dari opsi baris perintah arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ yang pertama digunakan untuk memisahkan string. Contoh: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 menambahkan opsi command line -O0 ke command line backend LTO dari semua file o di //foo/ kecuali bar.o.
Tag:action_command_lines
,affects_outputs
--platform_suffix=<a string>
default: lihat deskripsi-
Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.
Tag:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
default: lihat deskripsi-
Gunakan informasi profil Propeller untuk mengoptimalkan target build.Profil propeller harus terdiri dari minimal satu dari dua file, profil cc dan profil ld. Flag ini menerima label build yang harus merujuk pada file input profil propeller. Misalnya, file BUILD yang menentukan label, dalam a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Perintah ekspor_files mungkin harus ditambahkan ke paket yang sesuai agar file ini terlihat oleh Bazel. Opsi tersebut harus digunakan sebagai: --propeller_optimize=//a/b:propeller_profile
Tag:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
default: lihat deskripsi-
Nama jalur absolut file cc_profile untuk build yang Dioptimalkan untuk Propeller.
Tag:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
default: lihat deskripsi-
Nama jalur absolut file ld_profile untuk build yang Dioptimalkan untuk Propeller.
Tag:affects_outputs
--run_under=<a prefix in front of command>
default: lihat deskripsi-
Awalan yang akan disisipkan sebelum file yang dapat dieksekusi untuk perintah 'test' dan 'run'. Jika nilainya adalah 'foo -bar', dan command line eksekusi adalah 'test_binary -baz', command line terakhir adalah 'foo -bar test_binary -baz'.Ini juga dapat menjadi label untuk target yang dapat dieksekusi. Beberapa contohnya adalah: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Tag:action_command_lines
-
Jika benar, library native yang berisi fungsi identik akan dibagikan di antara target yang berbeda
Tag:loading_and_analysis
,affects_outputs
--[no]stamp
default: "salah"-
Stempel biner dengan tanggal, nama pengguna, nama host, informasi ruang kerja, dll.
Tag:affects_outputs
--strip=<always, sometimes or never>
default: "terkadang"-
Menentukan apakah akan menghapus biner dan library bersama (menggunakan "-Wl,--strip-debug"). Nilai {i>default<i} dari 'kadang-kadang' berarti strip iff --compilation_mode=fastbuild.
Tag:affects_outputs
--stripopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke strip saat membuat biner '<name>.stripped'.
Tag:action_command_lines
,affects_outputs
--tvos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang memerlukan biner Apple tvOS.
Tag:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi tvOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, 'tvos_sdk_version' akan digunakan.
Tag:loses_incremental_state
--visionos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang memerlukan biner Apple visionOS.
Tag:loses_incremental_state
,loading_and_analysis
--watchos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang memerlukan biner Apple watchOS.
Tag:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi watchOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, 'watchos_sdk_version' akan digunakan.
Tag:loses_incremental_state
--xbinary_fdo=<a build target label>
default: lihat deskripsi-
Menggunakan informasi profil XbinaryFDO untuk mengoptimalkan kompilasi. Tentukan nama profil lintas biner default. Jika opsi tersebut digunakan bersama dengan --fdo_instrument/--fdo_optimize/--fdo_profile, opsi tersebut akan selalu berlaku seolah-olah xbinary_fdo tidak pernah ditentukan.
Tag:affects_outputs
- Opsi yang memengaruhi seberapa ketat Bazel dalam menerapkan input build yang valid (definisi aturan, kombinasi flag, dll.):
--auto_cpu_environment_group=<a build target label>
default: ""-
Deklarasikan lingkungan_group yang akan digunakan untuk memetakan nilai CPU ke nilai target_environment secara otomatis.
Tag:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
default: "salah"-
Pastikan batasan pemberian lisensi yang diberlakukan oleh paket dependen tidak bertentangan dengan mode distribusi target yang dibuat. Secara default, lisensi tidak dicentang.
Tag:build_file_semantics
--[no]check_visibility
default: "true"-
Jika dinonaktifkan, error visibilitas dalam dependensi target akan didemosikan menjadi peringatan.
Tag:build_file_semantics
--[no]desugar_for_android
default: "true"-
Apakah akan mendesugar bytecode Java 8 sebelum melakukan dexing.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
default: "salah"-
Apakah akan menyertakan library Java 8 yang didukung dalam aplikasi untuk perangkat lama.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
default: "true"-
Memeriksa lingkungan yang kompatibel dengan setiap target dan melaporkan error jika ada target yang memiliki dependensi yang tidak mendukung lingkungan yang sama
Tag:build_file_semantics
--[no]experimental_check_desugar_deps
default: "true"-
Apakah akan memeriksa kembali desugaring yang benar pada tingkat biner Android.
Tag:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<off, warning or error>
default: "OFF"-
Jika diaktifkan, periksa apakah dependensi aar_import sudah lengkap. Penerapan ini dapat merusak build, atau hanya menghasilkan peringatan.
Tag:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
default: "default"-
Jika true (benar), periksa apakah target Java secara eksplisit mendeklarasikan semua target yang digunakan secara langsung sebagai dependensi.
Tag:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
default: "salah"-
Jika diaktifkan, periksa (hanya pengujian) untuk menemukan target prasyarat yang merupakan file output dengan mencari aturan yang menghasilkan hanya uji coba. Ini cocok dengan pemeriksaan visibilitas.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
default: "salah"-
Jika diaktifkan, pemeriksaan visibilitas juga berlaku untuk implementasi toolchain.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
default: "salah"-
Jika diaktifkan, penggunaan langsung aturan Android native akan dinonaktifkan. Gunakan aturan Android Starlark dari https://github.com/bazelbuild/rules_android
Tag:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
default: "salah"-
Tanpa pengoperasian. Disimpan di sini untuk kompatibilitas mundur.
Tag:eagerness_to_exit
,incompatible_change
--[no]incompatible_python_disable_py2
default: "true"-
Jika true (benar), menggunakan setelan Python 2 akan menyebabkan error. Ini termasuk python_version=PY2, srcs_version=PY2, dan srcs_version=PY2ONLY. Lihat https://github.com/bazelbuild/bazel/issues/15684 untuk informasi selengkapnya.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
default: "true"-
Flag ini bersifat noop dan dijadwalkan untuk dihapus.
Tag:no_op
,incompatible_change
--python_native_rules_allowlist=<a build target label>
default: lihat deskripsi-
Daftar yang diizinkan (target paket_grup) untuk digunakan saat menerapkan --incompatible_python_disallow_native_rules.
Tag:loading_and_analysis
--[no]strict_filesets
default: "salah"-
Jika opsi ini diaktifkan, kumpulan file yang melewati batas paket akan dilaporkan sebagai error.
Tag:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
default: "error"-
Kecuali NONAKTIF, memeriksa apakah target proto_library secara eksplisit mendeklarasikan semua target yang digunakan secara langsung sebagai dependensi.
Tag:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Default
--strict_public_imports=<off, warn, error, strict or default>
: "off" -
Kecuali NONAKTIF, akan memeriksa apakah target proto_library secara eksplisit mendeklarasikan semua target yang digunakan dalam 'impor publik' sebagai diekspor.
Tag:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
default: "salah"-
Jika true (benar), header yang ditemukan melalui jalur penyertaan sistem (-isystem) juga harus dideklarasikan.
Tag:loading_and_analysis
,eagerness_to_exit
--target_environment=<a build target label>
beberapa penggunaan diakumulasikan-
Mendeklarasikan lingkungan target build ini. Harus berupa referensi label ke aturan "lingkungan". Jika ditentukan, semua target tingkat teratas harus kompatibel dengan lingkungan ini.
Tag:changes_inputs
- Opsi yang memengaruhi output penandatanganan build:
- Default
--apk_signing_method=<v1, v2, v1_v2 or v4>
: "v1_v2" -
Implementasi yang akan digunakan untuk menandatangani APK
Tag:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
default: "true"-
Jika disetel, dan mode kompilasi tidak 'opt', aplikasi objc akan menyertakan hak debug saat menandatangani.
Tag:changes_inputs
--ios_signing_cert_name=<a string>
default: lihat deskripsi-
Nama sertifikat yang akan digunakan untuk penandatanganan iOS. Jika tidak disetel, perangkat akan kembali ke profil penyediaan. Dapat berupa preferensi identitas keychain sertifikat atau (substring) dari nama umum sertifikat, sesuai halaman utama codesign (SIGNING IDENTITIES).
Tag:action_command_lines
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_disallow_legacy_py_provider
default: "true"-
Tanpa pengoperasian, akan segera dihapus.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
default: "salah"-
Jika true (benar), larang atribut sdk_frameworks dan active_sdk_frameworks di objc_library danobjc_import.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
default: "salah"-
Jika true (benar), tetapkan nilai default ke benar (true) untuk atribut alwayslink di objc_library dan objc_import.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
default: "salah"-
Jika true (benar), error akan terjadi saat menggunakan aturan py_* bawaan; aturan rule_python harus digunakan. Lihat https://github.com/bazelbuild/bazel/issues/17773 untuk informasi selengkapnya dan petunjuk migrasi.
Tag:loading_and_analysis
,incompatible_change
- Opsi yang mengatur perilaku lingkungan pengujian atau runner pengujian:
--[no]allow_analysis_failures
default: "salah"-
Jika true (benar), kegagalan analisis target aturan akan menyebabkan propagasi target dari instance AnalysisFailureInfo yang berisi deskripsi error, bukan mengakibatkan kegagalan build.
Tag:loading_and_analysis
,experimental
- Default
--analysis_testing_deps_limit=<an integer>
: "2000" -
Menetapkan jumlah maksimum dependensi transitif melalui atribut aturan dengan transisi konfigurasi for_analysis_testing. Melebihi batas ini akan menyebabkan error aturan.
Tag:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
default: "salah"-
Jika kegagalan tindakan dex2oat yang sebenarnya akan menyebabkan build rusak, bukan mengeksekusi dex2oat selama runtime pengujian.
Tag:loading_and_analysis
,experimental
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g memory=10,30,60,100>
beberapa penggunaan diakumulasikan- Mengganti jumlah resource default untuk pengujian. Format yang diharapkan adalah <resource>=<value>. Jika satu angka positif ditetapkan sebagai <value>, resource default untuk semua ukuran pengujian akan diganti. Jika 4 angka yang dipisahkan koma ditentukan, angka tersebut akan menggantikan jumlah resource untuk masing-masing ukuran pengujian kecil, sedang, besar, dan sangat besar. Nilai juga bisa berupa HOST_RAM/HOST_CPU, secara opsional diikuti oleh [-|*]<float> (mis. memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4). Resource pengujian default yang ditentukan oleh flag ini diganti oleh resource eksplisit yang ditentukan dalam tag.
--[no]experimental_android_use_parallel_dex2oat
default: "salah"-
Gunakan dex2oat secara paralel untuk mempercepat android_test.
Tag:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
default: "salah"-
Mengaktifkan pemeriksaan kebocoran memori di target ios_test.
Tag:action_command_lines
--ios_simulator_device=<a string>
default: lihat deskripsi-
Perangkat yang akan disimulasikan saat menjalankan aplikasi iOS di simulator, misalnya 'iPhone 6'. Anda bisa mendapatkan daftar perangkat dengan menjalankan 'xcrun simctl list devicetypes' di mesin tempat simulator akan dijalankan.
Tag:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi iOS yang akan dijalankan pada simulator saat dijalankan atau diuji. Nilai ini diabaikan untuk aturan ios_test jika perangkat target ditentukan dalam aturan.
Tag:test_runner
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
beberapa penggunaan diakumulasikan- Menentukan jumlah waktu untuk menjalankan setiap pengujian. Jika salah satu upaya tersebut gagal karena alasan apa pun, seluruh pengujian akan dianggap gagal. Biasanya nilai yang ditentukan hanya berupa bilangan bulat. Contoh: --runs_per_test=3 akan menjalankan semua pengujian 3 kali. Sintaksis alternatif: regex_filter@runs_per_test. Di mana run_per_test merupakan singkatan dari nilai integer dan regex_filter adalah singkatan dari daftar yang mencakup dan mengecualikan pola ekspresi reguler (Lihat juga --instrumentation_filter). Contoh: --runs_per_test=//foo/.*,-//foo/bar/.*@3 menjalankan semua pengujian di //foo/ kecuali yang berada di bawah foo/bar tiga kali. Opsi ini dapat diteruskan beberapa kali. Argumen yang terakhir diteruskan yang cocok akan diprioritaskan. Jika tidak ada yang cocok, pengujian hanya akan dijalankan sekali.
--test_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan variabel lingkungan tambahan yang akan dimasukkan ke lingkungan runner pengujian. Variabel dapat ditentukan berdasarkan nama, dan nilainya akan dibaca dari lingkungan klien Bazel, atau berdasarkan pasangan nama=nilai. Opsi ini dapat digunakan beberapa kali untuk menentukan beberapa variabel. Hanya digunakan oleh perintah 'bazel test'.
Tag:test_runner
- Default
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - Mengganti nilai waktu tunggu pengujian default untuk waktu tunggu pengujian (dalam detik). Jika ditentukan, hanya satu nilai bilangan bulat positif yang akan mengganti semua kategori. Jika ditentukan 4 bilangan bulat yang dipisahkan koma, waktu tunggu tersebut akan menggantikan waktu tunggu untuk singkat, sedang, panjang, dan abadi (dalam urutan tersebut). Dalam kedua bentuk tersebut, nilai -1 akan memberi tahu blaze untuk menggunakan waktu tunggu defaultnya untuk kategori tersebut.
--[no]zip_undeclared_test_outputs
default: "true"-
Jika true (benar), output pengujian yang tidak dideklarasikan akan diarsipkan dalam file ZIP.
Tag:test_runner
- Opsi yang berkaitan dengan output kueri dan semantik:
--aspect_deps=<off, conservative or precise>
default: "konservatif"-
Cara me-resolve dependensi aspek jika format output adalah salah satu dari {xml,proto,record}. 'off' berarti tidak ada dependensi aspek yang diselesaikan, 'konservatif' (default) berarti semua dependensi aspek yang dideklarasikan akan ditambahkan terlepas dari apakah dependensi tersebut diberi class aturan dependensi langsung atau tidak, 'precise' berarti hanya aspek yang ditambahkan yang mungkin aktif berdasarkan class aturan dependensi langsung. Perhatikan bahwa mode presisi mengharuskan pemuatan paket lain untuk mengevaluasi satu target sehingga membuatnya lebih lambat daripada mode lainnya. Perhatikan juga bahwa mode yang tepat pun tidak sepenuhnya tepat: keputusan apakah akan menghitung suatu aspek ditentukan dalam fase analisis, yang tidak dijalankan selama 'kueri bazel'.
Tag:build_file_semantics
--[no]consistent_labels
default: "salah"-
Jika diaktifkan, setiap perintah kueri akan memunculkan label seolah-olah oleh fungsi <code>str</code> Starlark yang diterapkan ke instance <code>Label</code>. Hal ini berguna untuk alat yang perlu mencocokkan {i>output<i} dari berbagai perintah kueri dan/atau label yang dihasilkan oleh aturan. Jika tidak diaktifkan, pemformat output bebas memunculkan nama repositori yang jelas (relatif terhadap repositori utama) agar output lebih mudah dibaca.
Tag:terminal_output
--[no]experimental_explicit_aspects
default: "salah"-
kueri, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: tanpa pengoperasian (aspek selalu diikuti).
Tag:terminal_output
--[no]graph:factored
default: "true"-
Jika benar, grafik akan dimunculkan 'difaktorkan', yaitu node yang setara secara topologis akan digabungkan bersama dan labelnya akan digabungkan. Opsi ini hanya berlaku untuk --output=graph.
Tag:terminal_output
- Default
--graph:node_limit=<an integer>
: "512" -
Panjang maksimum string label untuk node grafik dalam output. Label yang lebih panjang akan dipotong; -1 berarti tidak ada pemotongan. Opsi ini hanya berlaku untuk --output=graph.
Tag:terminal_output
--[no]implicit_deps
default: "true"-
Jika diaktifkan, dependensi implisit akan disertakan dalam grafik dependensi tempat kueri dioperasikan. Dependensi implisit adalah dependensi yang tidak disebutkan secara eksplisit dalam file BUILD tetapi ditambahkan oleh bazel. Untuk cquery, opsi ini mengontrol pemfilteran toolchain yang di-resolve.
Tag:build_file_semantics
--[no]include_aspects
default: "true"-
kueri, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: tanpa pengoperasian (aspek selalu diikuti).
Tag:terminal_output
--[no]incompatible_package_group_includes_double_slash
default: "true"-
Jika diaktifkan, saat menghasilkan output atribut `packages` package_group, `//` awal tidak akan dihilangkan.
Tag:terminal_output
,incompatible_change
--[no]infer_universe_scope
default: "salah"-
Jika ditetapkan dan --universe_scope tidak ditetapkan, nilai --universe_scope akan disimpulkan sebagai daftar pola target unik dalam ekspresi kueri. Perhatikan bahwa nilai --universe_scope yang disimpulkan untuk ekspresi kueri yang menggunakan fungsi cakupan alam semesta (misalnya `allrdeps`) mungkin bukan yang Anda inginkan, jadi sebaiknya gunakan opsi ini hanya jika Anda tahu apa yang Anda lakukan. Lihat https://bazel.build/reference/query#sky-query untuk mengetahui detail dan contohnya. Jika --universe_scope ditetapkan, nilai opsi ini akan diabaikan. Catatan: opsi ini hanya berlaku untuk `query` (bukan `cquery`).
Tag:loading_and_analysis
--[no]line_terminator_null
default: "salah"-
Apakah setiap format dihentikan dengan \0, bukan baris baru.
Tag:terminal_output
--[no]nodep_deps
default: "true"-
Jika diaktifkan, dependensi dari atribut "nodep" akan disertakan dalam grafik dependensi yang digunakan untuk mengoperasikan kueri. Contoh umum atribut "nodep" adalah "visibilitas". Jalankan dan uraikan output `info build-language` untuk mempelajari semua atribut "nodep" dalam bahasa build.
Tag:build_file_semantics
--output=<a string>
default: "label"-
Format yang akan digunakan untuk mencetak hasil kueri. Nilai yang diizinkan untuk cquery adalah: label, label_types, textproto, transisi, proto, downstream_proto, jsonproto. Jika memilih 'transitions', Anda juga harus menentukan opsi --transitions=(lite|full).
Tag:terminal_output
--[no]proto:default_values
default: "true"-
Jika true (benar), atribut yang nilainya tidak ditentukan secara eksplisit dalam file BUILD akan disertakan; jika tidak, atribut tersebut akan dihilangkan. Opsi ini berlaku untuk --output=proto
Tag:terminal_output
--[no]proto:definition_stack
default: "salah"-
Isi kolom proto definisi_stack, yang mencatat setiap instance aturan stack panggilan Starlark pada saat class aturan ditentukan.
Tag:terminal_output
--[no]proto:flatten_selects
default: "true"-
Jika diaktifkan, atribut yang dapat dikonfigurasi yang dibuat oleh select() akan diratakan. Untuk jenis daftar, representasi yang disatukan adalah daftar yang berisi setiap nilai peta yang dipilih dengan tepat satu kali. Jenis skalar diratakan menjadi null.
Tag:build_file_semantics
--[no]proto:include_attribute_source_aspects
default: "salah"-
Isi kolom proto source_aspect_name dari setiap Atribut dengan aspek sumber tempat atribut tersebut berasal (string kosong jika bukan).
Tag:terminal_output
--[no]proto:include_configurations
default: "true"-
jika diaktifkan, output proto akan menyertakan informasi tentang konfigurasi. Jika dinonaktifkan,format output proto cquery akan menyerupai format output kueri.
Tag:affects_outputs
--[no]proto:include_synthetic_attribute_hash
default: "salah"-
Apakah akan menghitung dan mengisi atribut $internal_attr_hash atau tidak.
Tag:terminal_output
--[no]proto:instantiation_stack
default: "salah"-
Isi stack panggilan pembuatan instance dari setiap aturan. Perhatikan bahwa stack harus ada
Tag:terminal_output
--[no]proto:locations
default: "true"-
Apakah akan menghasilkan informasi lokasi dalam output proto atau tidak.
Tag:terminal_output
- Default
--proto:output_rule_attrs=<comma-separated list of options>
: "all" -
Daftar atribut yang dipisahkan koma untuk disertakan dalam output. Setelan defaultnya adalah semua atribut. Setel ke string kosong agar tidak menghasilkan output atribut apa pun. Opsi ini berlaku untuk --output=proto.
Tag:terminal_output
--[no]proto:rule_inputs_and_outputs
default: "true"-
Apakah kolom rule_input dan rule_output mengisi atau tidak.
Tag:terminal_output
--query_file=<a string>
default: ""-
Jika ditetapkan, kueri akan membaca kueri dari file yang disebutkan di sini, bukan dari command line. Menentukan file di sini serta kueri command line merupakan suatu error.
Tag:changes_inputs
--[no]relative_locations
default: "salah"-
Jika true (benar), lokasi file BUILD dalam output xml dan proto akan bersifat relatif. Secara default, output lokasi adalah jalur absolut dan tidak akan konsisten di seluruh mesin. Anda dapat menyetel opsi ini ke benar (true) agar mendapatkan hasil yang konsisten di seluruh mesin.
Tag:terminal_output
- Default
--show_config_fragments=<off, direct or transitive>
: "off" -
Menampilkan fragmen konfigurasi yang diperlukan oleh aturan dan dependensi transitifnya. Hal ini dapat berguna untuk mengevaluasi seberapa banyak grafik target yang dikonfigurasi dapat dipangkas.
Tag:affects_outputs
--starlark:expr=<a string>
default: ""-
Ekspresi Starlark untuk memformat setiap target yang dikonfigurasi dalam mode --output=starlark cquery. Target yang dikonfigurasi terikat dengan 'target'. Jika --starlark:expr atau --starlark:file tidak ditetapkan, opsi ini akan ditetapkan secara default ke 'str(target.label)'. Menentukan --starlark:expr dan --starlark:file merupakan kesalahan.
Tag:terminal_output
--starlark:file=<a string>
default: ""-
Nama file yang menentukan fungsi Starlark yang disebut 'format', dari satu argumen, yang diterapkan ke setiap target yang dikonfigurasi untuk memformatnya sebagai string. Menentukan --starlark:expr dan --starlark:file merupakan kesalahan. Lihat bantuan untuk --output=starlark untuk detail tambahan.
Tag:terminal_output
--[no]tool_deps
default: "true"-
Kueri: Jika dinonaktifkan, dependensi pada 'exec configuration' tidak akan disertakan dalam grafik dependensi tempat kueri dioperasikan. Edge dependensi 'exec configuration', seperti yang berasal dari aturan 'proto_library' apa pun ke Protocol Compiler, biasanya mengarah ke alat yang dieksekusi selama build, bukan bagian dari program 'target' yang sama.
Cquery: Jika dinonaktifkan, memfilter semua target yang dikonfigurasi yang melewati transisi eksekusi dari target tingkat teratas yang menemukan target yang dikonfigurasi ini. Artinya, jika target tingkat atas ada dalam konfigurasi target, hanya target yang dikonfigurasi dan dalam konfigurasi target yang akan ditampilkan. Jika target tingkat teratas berada dalam konfigurasi eksekusi, hanya target yang dikonfigurasi dengan eksekusi yang akan ditampilkan. Opsi ini TIDAK akan mengecualikan toolchain yang telah diselesaikan.
Tag:build_file_semantics
- Default
--transitions=<full, lite or none>
: "none" -
Format yang digunakan cquery untuk mencetak informasi transisi.
Tag:affects_outputs
--universe_scope=<comma-separated list of options>
default: ""-
Kumpulan pola target yang dipisahkan koma (aditif dan pengurangan). Kueri dapat dilakukan di alam semesta yang ditentukan oleh penutupan transitif target yang ditentukan. Opsi ini digunakan untuk perintah kueri dan kueri.
Untuk cquery, input untuk opsi ini adalah target dari semua jawaban yang dibuat sehingga opsi ini dapat memengaruhi konfigurasi dan transisi. Jika opsi ini tidak ditentukan, target tingkat teratas dianggap sebagai target yang diuraikan dari ekspresi kueri. Catatan: Untuk cquery, tidak menentukan opsi ini dapat menyebabkan build rusak jika target yang diurai dari ekspresi kueri tidak dapat dibuat dengan opsi tingkat atas.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
--[no]experimental_filter_library_jar_with_program_jar
default: "salah"-
Filter ProGuard ProgramJar untuk menghapus class yang juga ada di LibraryJar.
Tag:action_command_lines
--[no]experimental_inmemory_dotd_files
default: "true"-
Jika diaktifkan, file .d C++ akan diteruskan dalam memori langsung dari node build jarak jauh, bukan ditulis ke disk.
Tag:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
default: "true"-
Jika diaktifkan, file dependensi (.jdeps) yang dihasilkan dari kompilasi Java akan diteruskan dalam memori langsung dari node build jarak jauh, bukan ditulis ke disk.
Tag:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_retain_test_configuration_across_testonly
default: "salah"-
Jika diaktifkan, --trim_test_configuration tidak akan memangkas konfigurasi pengujian untuk aturan yang ditandai sebagai testonly=1. Hal ini dimaksudkan untuk mengurangi masalah konflik tindakan ketika aturan non-pengujian bergantung pada aturan cc_test. Tidak berpengaruh jika --trim_test_configuration bernilai salah (false).
Tag:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
default: "salah"-
Jika diaktifkan, versi Starlark dari cc_import dapat digunakan.
Tag:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
default: "salah"-
Apakah akan mempersempit input ke kompilasi C/C++ dengan menguraikan baris #include dari file input. Hal ini dapat meningkatkan performa dan inkrementalitas dengan mengurangi ukuran hierarki input kompilasi. Namun, tindakan ini juga dapat merusak build karena pemindai penyertaan tidak sepenuhnya mengimplementasikan semantik preprosesor C. Secara khusus, fungsi ini tidak memahami perintah #include dinamis dan mengabaikan logika bersyarat praprosesor. Risiko ditanggung sendiri. Masalah apa pun yang terkait dengan laporan ini akan ditutup.
Tag:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
default: "true"-
Melakukan sebagian besar pekerjaan untuk dexing secara terpisah untuk setiap file Jar.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
default: "true"-
Jika ditetapkan, file .d yang dimunculkan oleh clang akan digunakan untuk memangkas kumpulan input yang diteruskan ke kompilasi objc.
Tag:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
default: "salah"-
Saat membuat target //a:a, header proses di semua target yang menjadi dependensi //a:a (jika pemrosesan header diaktifkan untuk toolchain).
Tag:execution
--[no]trim_test_configuration
default: "true"-
Jika diaktifkan, opsi terkait pengujian akan dihapus di bawah tingkat atas build. Jika flag ini aktif, pengujian tidak dapat dibuat sebagai dependensi aturan bukan pengujian, tetapi perubahan pada opsi terkait pengujian tidak akan menyebabkan aturan non-pengujian dianalisis ulang.
Tag:loading_and_analysis
,loses_incremental_state
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
default: "-.*"-
Mencetak informasi debug selama resolusi toolchain. Flag ini menggunakan ekspresi reguler, yang diperiksa berdasarkan jenis toolchain dan target tertentu untuk melihat mana yang akan di-debug. Beberapa regex dapat dipisahkan dengan koma, kemudian setiap regex diperiksa secara terpisah. Catatan: Output flag ini sangat kompleks dan kemungkinan hanya akan berguna bagi pakar dalam resolusi toolchain.
Tag:terminal_output
- Opsi yang menentukan atau mengubah input umum ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--flag_alias=<a 'name=value' flag alias>
beberapa penggunaan diakumulasikan-
Menetapkan nama singkat untuk flag Starlark. Dibutuhkan satu pasangan nilai kunci dalam bentuk "<key>=<value>" sebagai argumen.
Tag:changes_inputs
--[no]incompatible_default_to_explicit_init_py
default: "salah"-
Flag ini mengubah perilaku default sehingga file __init__.py tidak lagi dibuat secara otomatis di runfile target Python. Tepatnya, jika target py_binary atau py_test memiliki legacy_create_init yang disetel ke "auto" (default), ini diperlakukan sebagai false jika dan hanya jika tanda ini disetel. Lihat https://github.com/bazelbuild/bazel/issues/10076.
Tag:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
default: "true"-
Jika true (benar), target yang dibuat dalam konfigurasi Python 2 akan muncul pada root output yang menyertakan akhiran '-py2', sedangkan target yang dibuat untuk Python 3 akan muncul di root tanpa akhiran terkait Python. Ini berarti symlink praktis `bazel-bin` akan mengarah ke target Python 3, bukan Python 2. Jika mengaktifkan opsi ini, sebaiknya Anda juga mengaktifkan `--incompatible_py3_is_default`.
Tag:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
default: "true"-
Jika true, target `py_binary` dan `py_test` yang tidak menetapkan atribut `python_version` (atau `default_python_version`) akan ditetapkan secara default ke PY3, bukan PY2. Jika Anda menetapkan tanda ini, sebaiknya Anda juga menetapkan `--incompatible_py2_outputs_are_suffixed`.
Tag:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
default: "true"-
Jika disetel ke benar (true), aturan Python native yang dapat dieksekusi akan menggunakan runtime Python yang ditentukan oleh toolchain Python, bukan runtime yang diberikan oleh flag lama seperti --python_top.
Tag:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
default: lihat deskripsi-
Mode versi utama Python, baik `PY2` maupun `PY3`. Perhatikan bahwa hal ini diganti oleh target `py_binary` dan `py_test` (meskipun keduanya tidak menentukan versi secara eksplisit) sehingga biasanya tidak ada banyak alasan untuk menyediakan flag ini.
Tag:loading_and_analysis
,affects_outputs
- Opsi lain, yang tidak dikategorikan lain.:
--[no]cache_test_results
[-t
] default: "otomatis"- Jika disetel ke 'otomatis', Bazel akan menjalankan kembali pengujian jika dan hanya jika: (1) Bazel mendeteksi perubahan dalam pengujian atau dependensinya, (2) pengujian ditandai sebagai eksternal, (3) beberapa pengujian diminta dengan --runs_per_test, atau(4) pengujian sebelumnya gagal. Jika disetel ke 'ya', Bazel akan meng-cache semua hasil pengujian kecuali pengujian yang ditandai sebagai eksternal. Jika disetel ke 'tidak', Bazel tidak akan menyimpan hasil pengujian apa pun dalam cache.
--[no]experimental_cancel_concurrent_tests
default: "salah"-
Jika true (benar), Blaze akan membatalkan pengujian yang berjalan secara serentak pada saat pertama berhasil dijalankan. Parameter ini hanya berguna jika dikombinasikan dengan --runs_per_test_detects_flakes.
Tag:affects_outputs
,loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
default: "salah"-
Jika true (benar), Bazel akan mengambil seluruh direktori data cakupan untuk setiap pengujian selama cakupan dijalankan.
Tag:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
default: "salah"-
Jika benar, cakupan untuk clang akan menghasilkan laporan LCOV.
Tag:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
default: "true"- Apakah akan membuat peta header J2ObjC secara paralel dengan transpilasi J2ObjC.
--[no]experimental_j2objc_shorter_header_path
default: "salah"-
Apakah membuat dengan jalur header yang lebih pendek (menggunakan "_ios", bukan "_j2objc").
Tag:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
default: "javabuilder"- Memungkinkan classpath yang dikurangi untuk kompilasi Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
default: "salah"-
Batasi --experimental_run_android_lint_on_java_rules ke library yang kompatibel dengan Android.
Tag:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
default: "salah"-
Apakah akan memvalidasi sumber java_*.
Tag:affects_outputs
--[no]explicit_java_test_deps
default: "salah"- Secara eksplisit menentukan dependensi untuk JUnit atau Hamcrest dalam java_test, bukan secara tidak sengaja memperoleh dari dependensi TestRunner. Saat ini hanya berfungsi untuk Bagas.
--host_java_launcher=<a build target label>
default: lihat deskripsi- Peluncur Java yang digunakan oleh alat yang dieksekusi selama proses build.
--host_javacopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan untuk diteruskan ke javac saat mem-build alat yang dijalankan selama proses build.
--host_jvmopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan untuk diteruskan ke VM Java saat mem-build alat yang dijalankan selama proses build. Opsi ini akan ditambahkan ke opsi startup VM dari setiap target java_binary.
--[no]incompatible_check_sharding_support
default: "true"-
Jika benar, Bazel akan gagal dalam pengujian dengan sharding jika runner pengujian tidak menunjukkan bahwa runner pengujian mendukung sharding dengan menyentuh file di jalur di TEST_SHARD_STATUS_FILE. Jika bernilai salah, runner pengujian yang tidak mendukung sharding akan menyebabkan semua pengujian berjalan di setiap shard.
Tag:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
default: "true"-
Jika benar, pengujian eksklusif akan dijalankan dengan strategi yang di-sandbox. Tambahkan tag 'local' untuk memaksakan pengujian eksklusif yang dijalankan secara lokal
Tag:incompatible_change
--[no]incompatible_strict_action_env
default: "salah"-
Jika true (benar), Bazel akan menggunakan lingkungan dengan nilai statis untuk PATH dan tidak mewarisi LD_LIBRARY_PATH. Gunakan --action_env=ENV_VARIABLE jika Anda ingin mewarisi variabel lingkungan tertentu dari klien, namun perhatikan bahwa hal tersebut dapat mencegah penyimpanan cache lintas-pengguna jika cache bersama digunakan.
Tag:loading_and_analysis
,incompatible_change
--j2objc_translation_flags=<comma-separated list of options>
beberapa penggunaan diakumulasikan- Opsi tambahan untuk diteruskan ke alat J2ObjC.
--java_debug
-
Menyebabkan mesin virtual Java pada pengujian java menunggu koneksi dari debugger yang sesuai dengan JDWP (seperti jdb) sebelum memulai pengujian. Menyiratkan -test_output=streamed.
Diluaskan ke:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
default: "true"- Membuat informasi dependensi (untuk saat ini, classpath waktu kompilasi) per target Java.
--[no]java_header_compilation
default: "true"- Mengompilasi ijar langsung dari sumber.
--java_language_version=<a string>
default: ""- Versi bahasa Java
--java_launcher=<a build target label>
default: lihat deskripsi- Peluncur Java yang akan digunakan saat mem-build biner Java. Jika flag ini disetel ke string kosong, peluncur JDK akan digunakan. Atribut "peluncur" menggantikan tanda ini.
--java_runtime_version=<a string>
default: "local_jdk"- Versi runtime Java
--javacopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan untuk diteruskan ke javac.
--jvmopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan untuk diteruskan ke VM Java. Opsi ini akan ditambahkan ke opsi startup VM dari setiap target java_binary.
--legacy_main_dex_list_generator=<a build target label>
default: lihat deskripsi- Menentukan biner yang akan digunakan untuk membuat daftar class yang harus ada di dex utama saat mengompilasi multidex lama.
--optimizing_dexer=<a build target label>
default: lihat deskripsi- Menentukan biner yang akan digunakan untuk melakukan dexing tanpa sharding.
--plugin=<a build target label>
beberapa penggunaan diakumulasikan- Plugin yang akan digunakan dalam build. Saat ini berfungsi dengan java_plugin.
--proguard_top=<a build target label>
default: lihat deskripsi- Menentukan versi ProGuard yang akan digunakan untuk penghapusan kode saat mem-build biner Java.
--proto_compiler=<a build target label>
default: "@bazel_tools//tools/proto:protoc"-
Label compiler proto.
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
default: "@bazel_tools//tools/proto:cc_toolchain"-
Label proto_lang_ toolchain() yang menjelaskan cara mengompilasi proto C++
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
default: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Label proto_lang_toolchain() yang menjelaskan cara mengompilasi proto j2objc
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
default: "@bazel_tools//tools/proto:java_Tool"-
Label proto_lang_ toolchain() yang menjelaskan cara mengompilasi proto Java
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
default: "@bazel_tools//tools/proto:javalite_toolchain"-
Label proto_lang_ toolchain() yang menjelaskan cara mengompilasi proto JavaLite
Tag:affects_outputs
,loading_and_analysis
--protocopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke compiler protobuf.
Tag:affects_outputs
--[no]runs_per_test_detects_flakes
default: "salah"- Jika benar, shard apa pun dengan minimal satu percobaan/percobaan lulus dan minimal satu percobaan/percobaan gagal akan mendapatkan status FLAKY.
--shell_executable=<a path>
default: lihat deskripsi-
Jalur absolut ke shell yang dapat dieksekusi untuk digunakan oleh Bazel. Jika variabel ini tidak disetel, tetapi variabel lingkungan BAZEL_SH ditetapkan pada pemanggilan Bazel pertama (yang memulai server Bazel), Bazel akan menggunakannya. Jika tidak ada yang ditetapkan, Bazel menggunakan jalur default hard code tergantung pada sistem operasi tempatnya berjalan (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, lainnya: /bin/bash). Perhatikan bahwa menggunakan shell yang tidak kompatibel dengan bash dapat menyebabkan kegagalan build atau kegagalan runtime dari biner yang dihasilkan.
Tag:loading_and_analysis
--test_arg=<a string>
beberapa penggunaan diakumulasikan- Menentukan opsi dan argumen tambahan yang harus diteruskan ke pengujian yang dapat dieksekusi. Dapat digunakan beberapa kali untuk menentukan beberapa argumen. Jika beberapa pengujian dijalankan, masing-masing pengujian akan menerima argumen yang identik. Hanya digunakan oleh perintah 'bazel test'.
--test_filter=<a string>
default: lihat deskripsi- Menentukan filter untuk diteruskan ke framework pengujian. Digunakan untuk membatasi pengujian yang dijalankan. Perhatikan bahwa hal ini tidak memengaruhi target yang dibuat.
- Default
--test_result_expiration=<an integer>
: "-1" - Opsi ini tidak digunakan lagi dan tidak berpengaruh.
--[no]test_runner_fail_fast
default: "salah"- Opsi cepat diteruskan ke runner pengujian gagal. Runner pengujian harus menghentikan eksekusi setelah kegagalan pertama.
- Default
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
: "eksplisit" - Tentukan strategi untuk sharding pengujian: 'eksplisit' untuk hanya menggunakan sharding jika atribut BUILD 'shard_count' ada. 'dinonaktifkan' agar tidak pernah menggunakan sharding pengujian. 'forced=k' untuk menerapkan shard 'k' untuk pengujian terlepas dari atribut BUILD 'shard_count'.
--tool_java_language_version=<a string>
default: ""- Versi bahasa Java yang digunakan untuk menjalankan alat yang diperlukan selama proses build
--tool_java_runtime_version=<a string>
default: "remotejdk_11"- Versi runtime Java yang digunakan untuk menjalankan alat selama proses build
--[no]use_ijars
default: "true"- Jika diaktifkan, opsi ini akan menyebabkan kompilasi Java menggunakan jar antarmuka. Ini akan menghasilkan kompilasi inkremental yang lebih cepat, tetapi pesan error dapat berbeda.
Opsi Dump
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
default: "salah"-
Jika ditetapkan, cache repositori akan menerapkan hardlink pada file jika cache ditemukan, bukan menyalinnya. Hal ini dimaksudkan untuk menghemat kapasitas {i>disk<i}.
Tag:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
default: "0"-
Jumlah upaya maksimum untuk mencoba kembali error download. Jika ditetapkan ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark berdasarkan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi pada komputer yang lebih lambat dari yang diharapkan oleh pembuat aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_connector_attempts=<an integer>
: "8" -
Jumlah upaya maksimum untuk download http.
Tag:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
default: "0s"-
Waktu tunggu maksimum untuk percobaan ulang download http. Dengan nilai 0, tidak ada waktu tunggu maksimum yang ditentukan.
Tag:bazel_internal_configuration
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Skalakan semua waktu tunggu yang terkait dengan download http berdasarkan faktor yang diberikan
Tag:bazel_internal_configuration
--repository_cache=<a path>
default: lihat deskripsi-
Menentukan lokasi cache dari nilai yang didownload yang diperoleh selama pengambilan repositori eksternal. String kosong sebagai argumen meminta cache dinonaktifkan. Jika tidak, default '<output_user_root>/cache/repos/v1' akan digunakan
Tag:bazel_internal_configuration
--[no]repository_disable_download
default: "salah"-
Jika ditetapkan, mendownload menggunakan ctx.download{,_and_extract} tidak akan diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file arbitrer yang dapat dieksekusi yang mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang yang ditempati (0-100) dan di atas batas tersebut, GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika ditetapkan ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi yang mengontrol output perintah:
--[no]action_cache
default: "salah"-
Menghapus konten cache tindakan.
Tag:bazel_monitoring
- Default
--memory=<none, shallow or deep>
: "none" -
Menghapus penggunaan memori node Skyframe tertentu.
Tag:bazel_monitoring
--memory_package=<a string>
default: lihat deskripsi-
Paket yang penggunaan memorinya harus dibuang.
Tag:bazel_monitoring
--memory_starlark_module=<a build target label>
default: lihat deskripsi-
Modul Starlark yang penggunaan memorinya harus dibuang.
Tag:bazel_monitoring
--[no]packages
default: "salah"-
Menghapus konten cache paket.
Tag:bazel_monitoring
--[no]rule_classes
default: "salah"-
Class aturan dump.
Tag:bazel_monitoring
--[no]rules
default: "salah"-
Aturan dump, termasuk jumlah dan penggunaan memori (jika memori dilacak).
Tag:bazel_monitoring
- Default
--skyframe=<off, summary, count, value, deps, rdeps or function_graph>
: "off" -
Grafik Dump Skyframe: 'off', 'summary', 'count', 'value', 'deps', 'rdeps', atau 'function_graph'.
Tag:bazel_monitoring
--skykey_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
default: ".*"-
Filter Regex untuk nama SkyKey ke output. Hanya digunakan dengan --skyframe=deps, rdeps, function_graph.
Tag:bazel_monitoring
--skylark_memory=<a string>
default: lihat deskripsi-
Mengeluarkan profil memori yang kompatibel dengan pprof ke jalur yang ditentukan. Untuk mempelajari lebih lanjut, lihat https://github.com/google/pprof.
Tag:bazel_monitoring
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_depset_for_java_output_source_jars
default: "true"-
Tanpa pengoperasian.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]separate_aspect_deps
default: "true"-
Tanpa pengoperasian
Tag:no_op
- Opsi yang berkaitan dengan semantik dan output Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan yanked di registry tempatnya berasal (jika bukan berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yanked yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Periksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan jika ketidakcocokan terdeteksi.
Tag:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
default: "peringatan"-
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan dalam modul root adalah versi yang sama dengan yang Anda dapatkan dalam grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasikannya ke kegagalan resolusi.
Tag:loading_and_analysis
--[no]ignore_dev_dependency
default: "salah"-
Jika true (benar), Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan dalam MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "update"-
Menentukan bagaimana dan apakah menggunakan lockfile atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `error` untuk menggunakan lockfile tetapi menampilkan error jika file tidak diperbarui, atau `off` tidak membaca atau menulis ke lockfile.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <module name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan merupakan jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
--vendor_dir=<a path>
default: lihat deskripsi-
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat membangun. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "1 dtk:2,20 dtk:3,1 m:5" -
Batas yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlah berupa bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap generasi lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan dengan koma.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi ketika peristiwa GC penuh terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC kecil terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi saat peristiwa GC kecil terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan setidaknya berada pada ambang batas ini, status Skyframe sementara yang tidak perlu akan hilang. Menyesuaikan hal ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari GC thrashing, jika GC thrashing (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada menyusun ulang status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
--experimental_command_profile=<cpu, wall, alloc or lock>
default: lihat deskripsi- Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alokasi, atau kunci) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa di bawah direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; penggunaan dengan risiko Anda sendiri.
--[no]experimental_record_metrics_for_all_mnemonics
default: "salah"- Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika ada file yang telah diselesaikan yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi caching dan eksekusi jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file yang akan digunakan untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk cocok, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik mulai dari `$1`. Beberapa perintah `tulis ulang` untuk URL yang sama dapat diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
default: "otomatis"- Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dimulai ulang. Jika tidak, gunakan thread platform (yaitu thread OS) jika ditetapkan ke 'platform' atau thread virtual jika ditetapkan ke 'virtual'. Jika disetel ke 'auto', thread virtual akan digunakan jika tersedia (yaitu, berjalan di JDK 21+), jika tidak, thread pekerja tidak akan digunakan.
- Opsi lain, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <repositori name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
Opsi Pengambilan
Mewarisi semua opsi dari test.
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
default: "salah"-
Jika ditetapkan, cache repositori akan menerapkan hardlink pada file jika cache ditemukan, bukan menyalinnya. Hal ini dimaksudkan untuk menghemat kapasitas {i>disk<i}.
Tag:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
default: "0"-
Jumlah upaya maksimum untuk mencoba kembali error download. Jika ditetapkan ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark berdasarkan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi pada komputer yang lebih lambat dari yang diharapkan oleh pembuat aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_connector_attempts=<an integer>
: "8" -
Jumlah upaya maksimum untuk download http.
Tag:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
default: "0s"-
Waktu tunggu maksimum untuk percobaan ulang download http. Dengan nilai 0, tidak ada waktu tunggu maksimum yang ditentukan.
Tag:bazel_internal_configuration
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Skalakan semua waktu tunggu yang terkait dengan download http berdasarkan faktor yang diberikan
Tag:bazel_internal_configuration
--repository_cache=<a path>
default: lihat deskripsi-
Menentukan lokasi cache dari nilai yang didownload yang diperoleh selama pengambilan repositori eksternal. String kosong sebagai argumen meminta cache dinonaktifkan. Jika tidak, default '<output_user_root>/cache/repos/v1' akan digunakan
Tag:bazel_internal_configuration
--[no]repository_disable_download
default: "salah"-
Jika ditetapkan, mendownload menggunakan ctx.download{,_and_extract} tidak akan diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file arbitrer yang dapat dieksekusi yang mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
--[no]all
default: "salah"-
Mengambil semua repositori eksternal yang diperlukan untuk membuat target atau repositori. Hanya berfungsi jika --enable_bzlmod aktif.
Tag:changes_inputs
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang yang ditempati (0-100) dan di atas batas tersebut, GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika ditetapkan ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
--[no]keep_going
[-k
] default: "salah"-
Lanjutkan sebanyak mungkin setelah error. Meskipun target yang gagal dan yang bergantung pada target tersebut tidak dapat dianalisis, prasyarat lain dari target tersebut dapat berupa.
Tag: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">
default: "otomatis"-
Jumlah thread paralel yang digunakan untuk fase pemuatan/analisis. Mengambil bilangan bulat, atau kata kunci ("otomatis", "HOST_CPUS", "HOST_RAM"), dapat diikuti dengan operasi ([-|*]<float>) misalnya, "otomatis", "HOST_CPUS*.5". "{i>auto" <i}menetapkan {i>default<i} yang wajar
berdasarkan sumber daya {i>host<i}. Minimal harus 1.
Tag:bazel_internal_configuration
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
default: "salah"-
Jika incompatible_enforce_config_setting_visi=false, berarti noop. Selain itu, jika tanda ini bernilai salah, config_setting apa pun yang tidak memiliki atribut visibilitas eksplisit akan menjadi //visibility:public. Jika tanda ini bernilai benar, config_setting mengikuti logika visibilitas yang sama seperti semua aturan lainnya. Lihat https://github.com/bazelbuild/bazel/issues/12933.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_depset_for_java_output_source_jars
default: "true"-
Tanpa pengoperasian.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
default: "true"-
Jika true, terapkan batasan visibilitas config_setting. Jika false, setiap config_setting terlihat oleh setiap target. Lihat https://github.com/bazelbuild/bazel/issues/12932.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]separate_aspect_deps
default: "true"-
Tanpa pengoperasian
Tag:no_op
- Opsi yang berkaitan dengan output kueri dan semantik:
--aspect_deps=<off, conservative or precise>
default: "konservatif"-
Cara me-resolve dependensi aspek jika format output adalah salah satu dari {xml,proto,record}. 'off' berarti tidak ada dependensi aspek yang diselesaikan, 'konservatif' (default) berarti semua dependensi aspek yang dideklarasikan akan ditambahkan terlepas dari apakah dependensi tersebut diberi class aturan dependensi langsung atau tidak, 'precise' berarti hanya aspek yang ditambahkan yang mungkin aktif berdasarkan class aturan dependensi langsung. Perhatikan bahwa mode presisi mengharuskan pemuatan paket lain untuk mengevaluasi satu target sehingga membuatnya lebih lambat daripada mode lainnya. Perhatikan juga bahwa mode yang tepat pun tidak sepenuhnya tepat: keputusan apakah akan menghitung suatu aspek ditentukan dalam fase analisis, yang tidak dijalankan selama 'kueri bazel'.
Tag:build_file_semantics
--[no]consistent_labels
default: "salah"-
Jika diaktifkan, setiap perintah kueri akan memunculkan label seolah-olah oleh fungsi <code>str</code> Starlark yang diterapkan ke instance <code>Label</code>. Hal ini berguna untuk alat yang perlu mencocokkan {i>output<i} dari berbagai perintah kueri dan/atau label yang dihasilkan oleh aturan. Jika tidak diaktifkan, pemformat output bebas memunculkan nama repositori yang jelas (relatif terhadap repositori utama) agar output lebih mudah dibaca.
Tag:terminal_output
--[no]experimental_explicit_aspects
default: "salah"-
kueri, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: tanpa pengoperasian (aspek selalu diikuti).
Tag:terminal_output
--[no]graph:factored
default: "true"-
Jika benar, grafik akan dimunculkan 'difaktorkan', yaitu node yang setara secara topologis akan digabungkan bersama dan labelnya akan digabungkan. Opsi ini hanya berlaku untuk --output=graph.
Tag:terminal_output
- Default
--graph:node_limit=<an integer>
: "512" -
Panjang maksimum string label untuk node grafik dalam output. Label yang lebih panjang akan dipotong; -1 berarti tidak ada pemotongan. Opsi ini hanya berlaku untuk --output=graph.
Tag:terminal_output
--[no]implicit_deps
default: "true"-
Jika diaktifkan, dependensi implisit akan disertakan dalam grafik dependensi tempat kueri dioperasikan. Dependensi implisit adalah dependensi yang tidak disebutkan secara eksplisit dalam file BUILD tetapi ditambahkan oleh bazel. Untuk cquery, opsi ini mengontrol pemfilteran toolchain yang di-resolve.
Tag:build_file_semantics
--[no]include_aspects
default: "true"-
kueri, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: tanpa pengoperasian (aspek selalu diikuti).
Tag:terminal_output
--[no]incompatible_package_group_includes_double_slash
default: "true"-
Jika diaktifkan, saat menghasilkan output atribut `packages` package_group, `//` awal tidak akan dihilangkan.
Tag:terminal_output
,incompatible_change
--[no]infer_universe_scope
default: "salah"-
Jika ditetapkan dan --universe_scope tidak ditetapkan, nilai --universe_scope akan disimpulkan sebagai daftar pola target unik dalam ekspresi kueri. Perhatikan bahwa nilai --universe_scope yang disimpulkan untuk ekspresi kueri yang menggunakan fungsi cakupan alam semesta (misalnya `allrdeps`) mungkin bukan yang Anda inginkan, jadi sebaiknya gunakan opsi ini hanya jika Anda tahu apa yang Anda lakukan. Lihat https://bazel.build/reference/query#sky-query untuk mengetahui detail dan contohnya. Jika --universe_scope ditetapkan, nilai opsi ini akan diabaikan. Catatan: opsi ini hanya berlaku untuk `query` (bukan `cquery`).
Tag:loading_and_analysis
--[no]line_terminator_null
default: "salah"-
Apakah setiap format dihentikan dengan \0, bukan baris baru.
Tag:terminal_output
--[no]nodep_deps
default: "true"-
Jika diaktifkan, dependensi dari atribut "nodep" akan disertakan dalam grafik dependensi yang digunakan untuk mengoperasikan kueri. Contoh umum atribut "nodep" adalah "visibilitas". Jalankan dan uraikan output `info build-language` untuk mempelajari semua atribut "nodep" dalam bahasa build.
Tag:build_file_semantics
--output=<a string>
default: "label"-
Format yang akan digunakan untuk mencetak hasil kueri. Nilai yang diizinkan untuk cquery adalah: label, label_types, textproto, transisi, proto, downstream_proto, jsonproto. Jika memilih 'transitions', Anda juga harus menentukan opsi --transitions=(lite|full).
Tag:terminal_output
--[no]proto:default_values
default: "true"-
Jika true (benar), atribut yang nilainya tidak ditentukan secara eksplisit dalam file BUILD akan disertakan; jika tidak, atribut tersebut akan dihilangkan. Opsi ini berlaku untuk --output=proto
Tag:terminal_output
--[no]proto:definition_stack
default: "salah"-
Isi kolom proto definisi_stack, yang mencatat setiap instance aturan stack panggilan Starlark pada saat class aturan ditentukan.
Tag:terminal_output
--[no]proto:flatten_selects
default: "true"-
Jika diaktifkan, atribut yang dapat dikonfigurasi yang dibuat oleh select() akan diratakan. Untuk jenis daftar, representasi yang disatukan adalah daftar yang berisi setiap nilai peta yang dipilih dengan tepat satu kali. Jenis skalar diratakan menjadi null.
Tag:build_file_semantics
--[no]proto:include_attribute_source_aspects
default: "salah"-
Isi kolom proto source_aspect_name dari setiap Atribut dengan aspek sumber tempat atribut tersebut berasal (string kosong jika bukan).
Tag:terminal_output
--[no]proto:include_configurations
default: "true"-
jika diaktifkan, output proto akan menyertakan informasi tentang konfigurasi. Jika dinonaktifkan,format output proto cquery akan menyerupai format output kueri.
Tag:affects_outputs
--[no]proto:include_synthetic_attribute_hash
default: "salah"-
Apakah akan menghitung dan mengisi atribut $internal_attr_hash atau tidak.
Tag:terminal_output
--[no]proto:instantiation_stack
default: "salah"-
Isi stack panggilan pembuatan instance dari setiap aturan. Perhatikan bahwa stack harus ada
Tag:terminal_output
--[no]proto:locations
default: "true"-
Apakah akan menghasilkan informasi lokasi dalam output proto atau tidak.
Tag:terminal_output
- Default
--proto:output_rule_attrs=<comma-separated list of options>
: "all" -
Daftar atribut yang dipisahkan koma untuk disertakan dalam output. Setelan defaultnya adalah semua atribut. Setel ke string kosong agar tidak menghasilkan output atribut apa pun. Opsi ini berlaku untuk --output=proto.
Tag:terminal_output
--[no]proto:rule_inputs_and_outputs
default: "true"-
Apakah kolom rule_input dan rule_output mengisi atau tidak.
Tag:terminal_output
--query_file=<a string>
default: ""-
Jika ditetapkan, kueri akan membaca kueri dari file yang disebutkan di sini, bukan dari command line. Menentukan file di sini serta kueri command line merupakan suatu error.
Tag:changes_inputs
--[no]relative_locations
default: "salah"-
Jika true (benar), lokasi file BUILD dalam output xml dan proto akan bersifat relatif. Secara default, output lokasi adalah jalur absolut dan tidak akan konsisten di seluruh mesin. Anda dapat menyetel opsi ini ke benar (true) agar mendapatkan hasil yang konsisten di seluruh mesin.
Tag:terminal_output
- Default
--show_config_fragments=<off, direct or transitive>
: "off" -
Menampilkan fragmen konfigurasi yang diperlukan oleh aturan dan dependensi transitifnya. Hal ini dapat berguna untuk mengevaluasi seberapa banyak grafik target yang dikonfigurasi dapat dipangkas.
Tag:affects_outputs
--starlark:expr=<a string>
default: ""-
Ekspresi Starlark untuk memformat setiap target yang dikonfigurasi dalam mode --output=starlark cquery. Target yang dikonfigurasi terikat dengan 'target'. Jika --starlark:expr atau --starlark:file tidak ditetapkan, opsi ini akan ditetapkan secara default ke 'str(target.label)'. Menentukan --starlark:expr dan --starlark:file merupakan kesalahan.
Tag:terminal_output
--starlark:file=<a string>
default: ""-
Nama file yang menentukan fungsi Starlark yang disebut 'format', dari satu argumen, yang diterapkan ke setiap target yang dikonfigurasi untuk memformatnya sebagai string. Menentukan --starlark:expr dan --starlark:file merupakan kesalahan. Lihat bantuan untuk --output=starlark untuk detail tambahan.
Tag:terminal_output
--[no]tool_deps
default: "true"-
Kueri: Jika dinonaktifkan, dependensi pada 'exec configuration' tidak akan disertakan dalam grafik dependensi tempat kueri dioperasikan. Edge dependensi 'exec configuration', seperti yang berasal dari aturan 'proto_library' apa pun ke Protocol Compiler, biasanya mengarah ke alat yang dieksekusi selama build, bukan bagian dari program 'target' yang sama.
Cquery: Jika dinonaktifkan, memfilter semua target yang dikonfigurasi yang melewati transisi eksekusi dari target tingkat teratas yang menemukan target yang dikonfigurasi ini. Artinya, jika target tingkat atas ada dalam konfigurasi target, hanya target yang dikonfigurasi dan dalam konfigurasi target yang akan ditampilkan. Jika target tingkat teratas berada dalam konfigurasi eksekusi, hanya target yang dikonfigurasi dengan eksekusi yang akan ditampilkan. Opsi ini TIDAK akan mengecualikan toolchain yang telah diselesaikan.
Tag:build_file_semantics
- Default
--transitions=<full, lite or none>
: "none" -
Format yang digunakan cquery untuk mencetak informasi transisi.
Tag:affects_outputs
--universe_scope=<comma-separated list of options>
default: ""-
Kumpulan pola target yang dipisahkan koma (aditif dan pengurangan). Kueri dapat dilakukan di alam semesta yang ditentukan oleh penutupan transitif target yang ditentukan. Opsi ini digunakan untuk perintah kueri dan kueri.
Untuk cquery, input untuk opsi ini adalah target dari semua jawaban yang dibuat sehingga opsi ini dapat memengaruhi konfigurasi dan transisi. Jika opsi ini tidak ditentukan, target tingkat teratas dianggap sebagai target yang diuraikan dari ekspresi kueri. Catatan: Untuk cquery, tidak menentukan opsi ini dapat menyebabkan build rusak jika target yang diurai dari ekspresi kueri tidak dapat dibuat dengan opsi tingkat atas.
Tag:loading_and_analysis
- Opsi yang terkait dengan semantik dan output Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan yanked di registry tempatnya berasal (jika bukan berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yanked yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Periksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan jika ketidakcocokan terdeteksi.
Tag:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
default: "peringatan"-
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan dalam modul root adalah versi yang sama dengan yang Anda dapatkan dalam grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasikannya ke kegagalan resolusi.
Tag:loading_and_analysis
--[no]configure
default: "salah"-
Hanya mengambil repositori yang ditandai sebagai 'konfigurasi' untuk tujuan konfigurasi sistem. Hanya berfungsi jika --enable_bzlmod aktif.
Tag:changes_inputs
--[no]force
default: "salah"-
Abaikan repositori yang ada jika ada dan ambil repositori lagi secara paksa. Hanya berfungsi jika --enable_bzlmod aktif.
Tag:changes_inputs
--[no]ignore_dev_dependency
default: "salah"-
Jika true (benar), Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan dalam MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "update"-
Menentukan bagaimana dan apakah menggunakan lockfile atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `error` untuk menggunakan lockfile tetapi menampilkan error jika file tidak diperbarui, atau `off` tidak membaca atau menulis ke lockfile.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <module name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan merupakan jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
--repo=<a string>
beberapa penggunaan diakumulasikan-
Hanya mengambil repositori yang ditentukan, yang dapat berupa {@apparent_repo_name} atau {@@canonical_repo_name}. Hanya berfungsi jika --enable_bzlmod aktif.
Tag:changes_inputs
--vendor_dir=<a path>
default: lihat deskripsi-
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat membangun. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "1 dtk:2,20 dtk:3,1 m:5" -
Batas yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlah berupa bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap generasi lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan dengan koma.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi ketika peristiwa GC penuh terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC kecil terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi saat peristiwa GC kecil terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan setidaknya berada pada ambang batas ini, status Skyframe sementara yang tidak perlu akan hilang. Menyesuaikan hal ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari GC thrashing, jika GC thrashing (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada menyusun ulang status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
--experimental_command_profile=<cpu, wall, alloc or lock>
default: lihat deskripsi- Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alokasi, atau kunci) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa di bawah direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; penggunaan dengan risiko Anda sendiri.
--[no]experimental_record_metrics_for_all_mnemonics
default: "salah"- Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
--experimental_repository_resolved_file=<a string>
default: ""-
Jika tidak kosong, tulis nilai Starlark dengan informasi yang telah diselesaikan dari semua aturan repositori Starlark yang dijalankan.
Tag:affects_outputs
- Opsi yang menentukan atau mengubah input umum ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika ada file yang telah diselesaikan yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi caching dan eksekusi jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file yang akan digunakan untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk cocok, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik mulai dari `$1`. Beberapa perintah `tulis ulang` untuk URL yang sama dapat diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
default: "otomatis"- Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dimulai ulang. Jika tidak, gunakan thread platform (yaitu thread OS) jika ditetapkan ke 'platform' atau thread virtual jika ditetapkan ke 'virtual'. Jika disetel ke 'auto', thread virtual akan digunakan jika tersedia (yaitu, berjalan di JDK 21+), jika tidak, thread pekerja tidak akan digunakan.
- Opsi lain, yang tidak dikategorikan.:
--deleted_packages=<comma-separated list of package names>
beberapa penggunaan diakumulasikan- Daftar nama paket yang dipisahkan koma yang akan dianggap tidak ada oleh sistem build, meskipun jika paket tersebut terlihat di suatu tempat pada jalur paket. Gunakan opsi ini ketika menghapus sub-paket 'x/y' dari paket 'x' yang ada. Misalnya, setelah menghapus x/y/BUILD di klien Anda, sistem build mungkin akan mengeluh jika menemukan label '//x:y/z' jika label tersebut masih disediakan oleh entri package_path lain. Menentukan --deleted_packages x/y akan menghindari masalah ini.
--[no]fetch
default: "true"- Mengizinkan perintah untuk mengambil dependensi eksternal. Jika disetel ke salah (false), perintah akan menggunakan versi dependensi yang di-cache, dan jika tidak ada, perintah tersebut akan gagal.
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <repositori name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--package_path=<colon-separated list of options>
default: "%workspace%"- Daftar yang dipisahkan titik dua berisi tempat mencari paket. Elemen yang dimulai dengan '%workspace%' akan relatif terhadap ruang kerja yang dicakup. Jika dihilangkan atau kosong, defaultnya adalah output 'bazel info default-package-path'.
--[no]show_loading_progress
default: "true"- Jika diaktifkan, akan menyebabkan Bazel mencetak pesan "Memuat paket:".
- Opsi yang mengontrol eksekusi build:
--[no]all
default: "salah"-
Mengambil semua repositori eksternal yang diperlukan untuk membuat target atau repositori. Hanya berfungsi jika --enable_bzlmod aktif.
Tag:changes_inputs
--[no]experimental_inprocess_symlink_creation
default: "salah"-
Apakah akan melakukan panggilan sistem file langsung untuk membuat hierarki symlink
Tag:loading_and_analysis
,execution
,experimental
--[no]experimental_persistent_aar_extractor
default: "salah"-
Aktifkan ekstraktor aar persisten menggunakan pekerja.
Tag:execution
--[no]experimental_remotable_source_manifests
default: "salah"-
Apakah akan membuat tindakan manifes sumber dapat dipindahkan
Tag:loading_and_analysis
,execution
,experimental
--[no]experimental_split_coverage_postprocessing
default: "salah"-
Jika true, Bazel akan menjalankan cakupan pascapemrosesan untuk pengujian di spawn baru.
Tag:execution
--[no]experimental_strict_fileset_output
default: "salah"-
Jika opsi ini diaktifkan, kumpulan file akan memperlakukan semua artefak output sebagai file biasa. {i>Mockup <i}tidak akan melintasi direktori atau sensitif terhadap symlink.
Tag:execution
--[no]keep_going
[-k
] default: "salah"-
Lanjutkan sebanyak mungkin setelah error. Meskipun target yang gagal dan yang bergantung pada target tersebut tidak dapat dianalisis, prasyarat lain dari target tersebut dapat berupa.
Tag: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">
default: "otomatis"-
Jumlah thread paralel yang digunakan untuk fase pemuatan/analisis. Mengambil bilangan bulat, atau kata kunci ("otomatis", "HOST_CPUS", "HOST_RAM"), dapat diikuti dengan operasi ([-|*]<float>) misalnya, "otomatis", "HOST_CPUS*.5". "{i>auto" <i}menetapkan {i>default<i} yang wajar
berdasarkan sumber daya {i>host<i}. Minimal harus 1.
Tag:bazel_internal_configuration
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
default: ""-
Tambahkan atau hapus kunci dari info eksekusi tindakan berdasarkan mnemonik tindakan. Hanya berlaku untuk tindakan yang mendukung info eksekusi. Banyak tindakan umum yang mendukung info eksekusi, misalnya Genrule, CppCompile, Javac, StarlarkAction, TestRunner. Saat menentukan beberapa nilai, urutan penting karena banyak regex dapat berlaku untuk mnemonik yang sama.
Sintaks: "regex=[+-]key,regex=[+-]key,...".
Contoh:
'.*=+x,.*=-y,.*=+z' menambahkan 'x' dan 'z' ke, serta menghapus 'y' dari, info eksekusi untuk semua tindakan.
'Genrule=+require-x' menambahkan 'require-x' ke info eksekusi untuk semua tindakan Genrule.
'(?!Genrule).*=-require-x' menghapus 'require-x' dari info eksekusi untuk semua tindakan non-Genrule.
Tag:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Aktifkan tindakan dex dan desugar Android persisten menggunakan pekerja.
Diluaskan ke:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Tag:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Aktifkan pemroses resource Android persisten menggunakan pekerja.
Diluaskan ke:
--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
}--internal_persistent_busybox_tools
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_desugar
-
Aktifkan tindakan dex dan desugar Android multipleks yang persisten menggunakan pekerja.
Diluaskan ke:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Tag:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Aktifkan pemroses resource Android multipleks persisten menggunakan pekerja.
Diluaskan ke:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
}--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
-
Aktifkan alat Android persisten dan multipleks (dexing, desugaring, pemrosesan resource).
Diluaskan ke:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Tag:host_machine_resource_optimizations
,execution
--[no]use_target_platform_for_tests
default: "salah"-
Jika true (benar), Bazel akan menggunakan platform target untuk menjalankan pengujian, bukan grup eksekusi pengujian.
Tag:execution
- Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
--android_compiler=<a string>
default: lihat deskripsi-
Compiler target Android.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
default: "//external:android/crosstool"-
Lokasi compiler C++ yang digunakan untuk build Android.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
default: lihat deskripsi-
Target Android grte_top.
Tag:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
default: "android"-
Memilih penggabungan manifes yang akan digunakan untuk aturan android_binary. Tanda untuk membantu transisi ke penggabungan manifes Android dari penggabungan lama.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_platforms=<a build target label>
default: ""-
Menetapkan platform yang digunakan target android_binary. Jika beberapa platform ditentukan, biner adalah APK gemuk, yang berisi biner native untuk setiap platform target yang ditentukan.
Tag:changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_sdk=<a build target label>
default: "@bazel_tools//tools/android:sdk"-
Menentukan platform/Android SDK yang digunakan untuk mem-build aplikasi Android.
Tag:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
default: "@bazel_tools//tools/cpp:toolchain"-
Label paket crosstool yang akan digunakan dalam aturan Apple dan Objc serta dependensinya.
Tag:loses_incremental_state
,changes_inputs
--cc_output_directory_tag=<a string>
default: ""-
Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.
Tag:affects_outputs
--compiler=<a string>
default: lihat deskripsi-
Compiler C++ yang akan digunakan untuk mengompilasi target.
Tag:loading_and_analysis
,execution
--coverage_output_generator=<a build target label>
default: "@bazel_tools//tools/test:lcov_merger"-
Lokasi biner yang digunakan untuk pascapemrosesan laporan cakupan mentah. Saat ini, file harus berupa grup file yang berisi satu file, yaitu biner. Default-nya adalah '//tools/test:lcov_merger'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
default: "@bazel_tools//tools/test:coverage_report_generator"-
Lokasi biner yang digunakan untuk membuat laporan cakupan. Saat ini, file harus berupa grup file yang berisi satu file, yaitu biner. Default-nya adalah '//tools/test:coverage_report_generator'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
default: "@bazel_tools//tools/test:coverage_support"-
Lokasi file dukungan yang diperlukan pada input setiap tindakan pengujian yang mengumpulkan cakupan kode. Default-nya adalah '//tools/test:coverage_support'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--custom_malloc=<a build target label>
default: lihat deskripsi-
Menentukan implementasi maloc kustom. Setelan ini mengganti atribut maloc dalam aturan build.
Tag:changes_inputs
,affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
beberapa penggunaan diakumulasikan-
Daftar ekspresi reguler yang dipisahkan koma, masing-masing jika perlu diawali dengan - (ekspresi negatif), ditetapkan (=) ke daftar target nilai batasan yang dipisahkan koma. Jika target tidak cocok dengan ekspresi negatif dan setidaknya satu ekspresi positif, resolusi toolchain-nya akan dijalankan seolah-olah telah mendeklarasikan nilai batasan sebagai batasan eksekusi. Contoh: //demo,-test=@platforms//cpus:x86_64 akan menambahkan 'x86_64' ke target mana pun di bawah //demo kecuali untuk yang namanya berisi 'test'.
Tag:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
default: "salah"-
Jika ditetapkan, tambahkan persyaratan eksekusi "require-xcode:{version}" ke setiap tindakan Xcode. Jika versi xcode memiliki label dengan tanda hubung, tambahkan juga persyaratan eksekusi "require-xcode-label:{version_label}".
Tag:loses_incremental_state
,loading_and_analysis
,execution
--[no]experimental_prefer_mutual_xcode
default: "true"-
Jika benar, gunakan Xcode terbaru yang tersedia secara lokal dan jarak jauh. Jika salah (false), atau jika tidak ada versi bersama yang tersedia, gunakan versi Xcode lokal yang dipilih melalui xcode-select.
Tag:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
default: ""-
Platform yang tersedia sebagai platform eksekusi untuk menjalankan tindakan. Platform dapat ditentukan berdasarkan target yang tepat, atau sebagai pola target. Platform ini akan dipertimbangkan sebelum yang dideklarasikan dalam file WORKSPACE oleh register_execution_platforms(). Opsi ini hanya dapat disetel satu kali; instance berikutnya akan mengganti setelan tanda sebelumnya.
Tag:execution
--extra_toolchains=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Aturan toolchain yang akan dipertimbangkan selama resolusi toolchain. Toolchain dapat ditentukan berdasarkan target yang tepat, atau sebagai pola target. Toolchain ini akan dipertimbangkan sebelum yang dideklarasikan dalam file WORKSPACE oleh register_toolchains().
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
--grte_top=<a label>
default: lihat deskripsi-
Label ke library libc yang digunakan untuk check in. Nilai default dipilih oleh toolchain crosstool, dan Anda hampir tidak perlu menggantinya.
Tag:action_command_lines
,affects_outputs
--host_compiler=<a string>
default: lihat deskripsi-
Flag tanpa pengoperasian. Akan dihapus dalam rilis mendatang.
Tag:loading_and_analysis
,execution
--host_grte_top=<a label>
default: lihat deskripsi-
Jika ditentukan, setelan ini akan menggantikan direktori tingkat teratas libc (--grte_top) untuk konfigurasi eksekusi.
Tag:action_command_lines
,affects_outputs
--host_platform=<a build target label>
default: "@local_config_platform//:host"-
Label aturan platform yang menjelaskan sistem host.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
default: "true"-
Jika true (benar), Bazel tidak akan mengaktifkan fitur 'host' dan 'nonhost' di toolchain c++ (lihat https://github.com/bazelbuild/bazel/issues/7407 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
default: "true"-
Gunakan resolusi toolchain untuk memilih aturan Android SDK untuk Android (Starlark dan native)
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
default: "salah"-
Gunakan resolusi toolchain guna memilih Apple SDK untuk aturan Apple (Starlark dan native)
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
default: "true"-
Flag ini bersifat noop dan dijadwalkan untuk dihapus.
Tag:no_op
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
default: "true"-
Jika true (benar), Bazel tidak akan menautkan dependensi library ke seluruh arsip secara default (lihat https://github.com/bazelbuild/bazel/issues/7362 untuk mengetahui petunjuk migrasi).
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
default: "true"-
Flag ini bersifat noop dan dijadwalkan untuk dihapus.
Tag:no_op
,incompatible_change
--[no]incompatible_strip_executable_safely
default: "salah"-
Jika true, tindakan penghapusan untuk file yang dapat dieksekusi akan menggunakan flag -x, yang tidak melanggar resolusi simbol dinamis.
Tag:action_command_lines
,incompatible_change
-
Gunakan objek bersama antarmuka jika didukung oleh toolchain. Semua toolchain ELF saat ini mendukung setelan ini.
Tag:loading_and_analysis
,affects_outputs
,affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Menentukan versi iOS SDK yang akan digunakan untuk membuat aplikasi iOS. Jika tidak ditentukan, versi SDK iOS default dari 'xcode_version' akan digunakan.
Tag:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Menentukan versi macOS SDK yang akan digunakan untuk mem-build aplikasi macOS. Jika tidak ditentukan, versi SDK macOS default dari 'xcode_version' akan digunakan.
Tag:loses_incremental_state
--minimum_os_version=<a string>
default: lihat deskripsi-
Versi OS minimum yang ditargetkan kompilasi Anda.
Tag:loading_and_analysis
,affects_outputs
--platform_mappings=<a relative path>
default: ""-
Lokasi file pemetaan yang menjelaskan platform yang akan digunakan jika tidak ada yang ditetapkan atau tanda yang akan ditetapkan ketika platform sudah ada. Harus terkait dengan root ruang kerja utama. Nilai defaultnya adalah 'platform_mappings' (file langsung di bawah root ruang kerja).
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
,immutable
--platforms=<a build target label>
default: ""-
Label aturan platform yang menjelaskan platform target untuk perintah saat ini.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
default: lihat deskripsi-
Tidak digunakan lagi, tanpa pengoperasian. Dinonaktifkan oleh `--incompatible_use_python_ toolchains`.
Tag:no_op
,deprecated
--python3_path=<a string>
default: lihat deskripsi-
Tidak digunakan lagi, tanpa pengoperasian. Dinonaktifkan oleh `--incompatible_use_python_ toolchains`.
Tag:no_op
,deprecated
--python_path=<a string>
default: lihat deskripsi-
Jalur absolut penafsir Python yang dipanggil untuk menjalankan target Python di platform target. Tidak digunakan lagi; dinonaktifkan oleh --incompatible_use_python_ toolchains.
Tag:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
default: lihat deskripsi-
Label py_runtime yang mewakili penafsir Python yang dipanggil untuk menjalankan target Python di platform target. Tidak digunakan lagi; dinonaktifkan oleh --incompatible_use_python_ toolchains.
Tag:loading_and_analysis
,affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Menentukan versi tvOS SDK yang akan digunakan untuk mem-build aplikasi tvOS. Jika tidak ditentukan, versi SDK tvOS default dari 'xcode_version' akan digunakan.
Tag:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Menentukan versi SDK watchOS yang akan digunakan untuk mem-build aplikasi watchOS. Jika tidak ditentukan, versi SDK watchOS default dari 'xcode_version' akan digunakan.
Tag:loses_incremental_state
--xcode_version=<a string>
default: lihat deskripsi-
Jika ditentukan, akan menggunakan Xcode dari versi yang ditentukan untuk tindakan build yang relevan. Jika tidak ditentukan, versi Xcode default eksekutor akan digunakan.
Tag:loses_incremental_state
--xcode_version_config=<a build target label>
default: "@bazel_tools//tools/cpp:host_xcodes"-
Label aturan xcode_config yang akan digunakan untuk memilih versi Xcode di konfigurasi build.
Tag:loses_incremental_state
,loading_and_analysis
- Opsi yang mengontrol output perintah:
--[no]apple_generate_dsym
default: "salah"-
Apakah akan menghasilkan file simbol debug(.dSYM).
Tag:affects_outputs
,action_command_lines
--[no]build_runfile_links
default: "true"-
Jika true (benar), buat forest symlink runfile untuk semua target. Jika false, tuliskan hanya saat diperlukan oleh tindakan lokal, uji, atau jalankan perintah.
Tag:affects_outputs
--[no]build_runfile_manifests
default: "true"-
Jika true (benar), menulis manifes runfile untuk semua target. Jika salah (false), hapus variabel tersebut. Pengujian lokal akan gagal dijalankan jika salah (false).
Tag:affects_outputs
--[no]build_test_dwp
default: "salah"-
Jika diaktifkan, saat mem-build pengujian C++ secara statis dan dengan fisi, file .dwp untuk biner pengujian juga akan otomatis dibuat.
Tag:loading_and_analysis
,affects_outputs
- Default
--cc_proto_library_header_suffixes=<comma-separated set of options>
: ".pb.h" -
Menetapkan akhiran file header yang dibuat oleh cc_proto_library.
Tag:affects_outputs
,loading_and_analysis
- Default
--cc_proto_library_source_suffixes=<comma-separated set of options>
: ".pb.cc" -
Menetapkan akhiran file sumber yang dibuat oleh cc_proto_library.
Tag:affects_outputs
,loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
default: "salah"-
Menjalankan tindakan tambahan untuk versi Java API alternatif di proto_library.
Tag:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_proto_extra_actions
default: "salah"-
Menjalankan tindakan tambahan untuk versi Java API alternatif di proto_library.
Tag:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_save_feature_state
default: "salah"-
Simpan status fitur yang diaktifkan dan diminta sebagai output kompilasi.
Tag:affects_outputs
,experimental
--fission=<a set of compilation modes>
default: "tidak"-
Menentukan mode kompilasi yang menggunakan fisi untuk kompilasi dan link C++. Dapat berupa kombinasi {'fastbuild', 'dbg', 'opt'} atau nilai khusus 'yes' untuk mengaktifkan semua mode dan 'no' untuk menonaktifkan semua mode.
Tag:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
default: "true"-
Jika true (benar), aturan native akan menambahkan <code>DefaultInfo.files</code> dependensi data ke runfile-nya, yang cocok dengan perilaku yang direkomendasikan untuk aturan Starlark (https://bazel.build/extending/rules#runfiles_features_to_Hindari).
Tag:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
default: "true"-
Jika true, build runfile symlink forest untuk repositori eksternal dalam .runfiles/wsname/external/repo (selain .runfiles/repo).
Tag:affects_outputs
--[no]objc_generate_linkmap
default: "salah"-
Menentukan apakah akan membuat file peta link.
Tag:affects_outputs
--[no]save_temps
default: "salah"-
Jika disetel, output sementara dari gcc akan disimpan. Ini mencakup file .s (kode assembler), file .i (C yang diproses sebelumnya), dan file .ii (C++ yang diproses sebelumnya).
Tag:affects_outputs
- Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, tetapi memengaruhi nilainya, bukan keberadaannya:
--action_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi target. Variabel dapat ditetapkan berdasarkan nama, dalam hal ini nilai akan diambil dari lingkungan pemanggilan, atau oleh pasangan nama=nilai yang menetapkan nilai yang tidak bergantung pada lingkungan pemanggilan. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, nilai terbaru yang diperoleh, opsi untuk variabel yang berbeda akan diakumulasikan.
Tag:action_command_lines
--android_cpu=<a string>
default: "armeabi-v7a"-
CPU target Android.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]android_databinding_use_androidx
default: "true"-
Buat file data binding yang kompatibel dengan AndroidX. Ini hanya digunakan dengan databinding v2. Tanda ini tanpa pengoperasian.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]android_databinding_use_v3_4_args
default: "true"-
Gunakan android databinding v2 dengan argumen 3.4.0. Tanda ini tanpa pengoperasian.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--android_dynamic_mode=<off, default or fully>
: "off" -
Menentukan apakah dependensi C++ aturan Android akan ditautkan secara dinamis ketika cc_binary tidak secara eksplisit membuat library bersama. 'default' berarti bazel akan memilih apakah akan menautkan secara dinamis. 'complete' berarti semua library akan ditautkan secara dinamis. 'off' berarti semua library akan ditautkan dalam sebagian besar mode statis.
Tag:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
default: "alfabet"-
Menetapkan urutan manifes yang diteruskan ke penggabungan manifes untuk biner Android. ALFABETIS berarti manifes diurutkan berdasarkan jalur relatif terhadap execroot. ALPHABETICAL_BY_CONFIGURATION berarti manifes diurutkan menurut jalur yang terkait dengan direktori konfigurasi dalam direktori output. DEPENDENSI berarti manifes diurutkan dengan setiap manifes library muncul sebelum manifes dependensinya.
Tag:action_command_lines
,execution
--[no]android_resource_shrinking
default: "salah"-
Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.
Tag:affects_outputs
,loading_and_analysis
--[no]build_python_zip
default: "otomatis"-
Buat zip python yang dapat dieksekusi; di Windows, nonaktif di platform lain
Tag:affects_outputs
--catalyst_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang memerlukan biner Apple Catalyst.
Tag:loses_incremental_state
,loading_and_analysis
--[no]collect_code_coverage
default: "salah"-
Jika ditentukan, Bazel akan menginstrumentasikan kode (menggunakan instrumentasi offline jika memungkinkan) dan akan mengumpulkan informasi cakupan selama pengujian. Hanya target yang cocok --instrumentation_filter yang akan terpengaruh. Biasanya opsi ini tidak boleh ditentukan secara langsung - perintah 'bazel scope' sebaiknya digunakan.
Tag:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] default: "fastbuild"-
Tentukan mode tempat biner akan dibangun. Nilai: 'fastbuild', 'dbg', 'opt'.
Tag:affects_outputs
,action_command_lines
--conlyopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke gcc saat mengompilasi file sumber C.
Tag:action_command_lines
,affects_outputs
--copt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke gcc.
Tag:action_command_lines
,affects_outputs
--cpu=<a string>
default: ""-
CPU target.
Tag:changes_inputs
,affects_outputs
--cs_fdo_absolute_path=<a string>
default: lihat deskripsi-
Menggunakan informasi profil CSFDO untuk mengoptimalkan kompilasi. Tentukan nama jalur absolut file zip yang berisi file profil, file profil LLVM mentah atau yang diindeks.
Tag:affects_outputs
--cs_fdo_instrument=<a string>
default: lihat deskripsi-
Membuat biner dengan instrumentasi FDO yang sensitif konteks. Dengan compiler Clang/LLVM, compiler ini juga menerima nama direktori tempat file profil mentah akan dibuang saat runtime.
Tag:affects_outputs
--cs_fdo_profile=<a build target label>
default: lihat deskripsi-
cs_fdo_profile yang mewakili profil sensitif konteks yang akan digunakan untuk pengoptimalan.
Tag:affects_outputs
--cxxopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke gcc saat mengompilasi file sumber C++.
Tag:action_command_lines
,affects_outputs
--define=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan-
Setiap opsi --define menentukan penetapan untuk variabel build. Dalam kasus beberapa nilai untuk suatu variabel, nilai terakhir yang akan menang.
Tag:changes_inputs
,affects_outputs
--dynamic_mode=<off, default or fully>
default: "default"-
Menentukan apakah biner C++ akan ditautkan secara dinamis. 'default' berarti Bazel akan memilih apakah akan menautkan secara dinamis. 'complete' berarti semua library akan ditautkan secara dinamis. 'off' berarti semua library akan ditautkan dalam sebagian besar mode statis.
Tag:loading_and_analysis
,affects_outputs
--[no]enable_fdo_profile_absolute_path
default: "true"-
Jika ditetapkan, penggunaan fdo_absolute_profile_path akan menimbulkan error.
Tag:affects_outputs
--[no]enable_runfiles
default: "otomatis"-
Aktifkan hierarki symlink runfiles; Secara default, fungsi ini nonaktif di Windows, di platform lain.
Tag:affects_outputs
--experimental_action_listener=<a build target label>
beberapa penggunaan diakumulasikan-
Tidak digunakan lagi demi aspek. Gunakan action_Listener untuk melampirkan extra_action ke tindakan build yang ada.
Tag:execution
,experimental
--[no]experimental_android_compress_java_resources
default: "salah"-
Kompresi resource Java dalam APK
Tag:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
default: "true"-
Gunakan databinding Android v2. Tanda ini tanpa pengoperasian.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_android_resource_shrinking
default: "salah"-
Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.
Tag:affects_outputs
,loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
default: "salah"-
gunakan alat rex untuk menulis ulang file dex
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]experimental_collect_code_coverage_for_generated_files
default: "salah"-
Jika ditentukan, Bazel juga akan membuat informasi cakupan untuk file yang dihasilkan.
Tag:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
default: "-O0,-DDEBUG=1"-
Menggunakan string ini sebagai opsi compiler fastbuild objc.
Tag:action_command_lines
--[no]experimental_omitfp
default: "salah"-
Jika true (benar), gunakan libunwind untuk pelepasan stack (stack unwind), lalu kompilasi dengan -fomit-frame-pointer dan -fasync-unwind-tables.
Tag:action_command_lines
,affects_outputs
,experimental
- Default
--experimental_output_paths=<off, content or strip>
: "off" -
Model yang akan digunakan untuk tempat aturan hierarki output menulis output-nya, terutama untuk build multi-platform / multi-konfigurasi. Hal ini sangat eksperimental. Lihat https://github.com/bazelbuild/bazel/issues/6526 untuk mengetahui detailnya. Tindakan Starlark dapat digunakan dalam pemetaan jalur dengan menambahkan kunci 'supports-path-mapping' ke perintah 'execution_requirements'.
Tag:loses_incremental_state
,bazel_internal_configuration
,affects_outputs
,execution
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
beberapa penggunaan diakumulasikan-
Setiap entri harus berupa label=value formulir dengan label merujuk ke platform dan nilai merupakan nama pendek yang diinginkan untuk digunakan di jalur output. Hanya digunakan jika --experimental_platform_in_output_dir benar. Memiliki prioritas penamaan tertinggi.
Tag:affects_outputs
,experimental
--[no]experimental_platform_in_output_dir
default: "salah"-
Jika true (benar), nama pendek untuk platform target akan digunakan dalam nama direktori output, bukan CPU. Skema persisnya bersifat eksperimental dan dapat berubah sewaktu-waktu: Pertama, dalam kasus yang jarang terjadi, opsi --platforms tidak memiliki tepat satu nilai, hash opsi platform akan digunakan. Selanjutnya, jika ada nama pendek untuk platform saat ini yang didaftarkan oleh --experimental_override_name_platform_in_output_dir, maka nama pendek tersebut akan digunakan. Kemudian, jika --experimental_use_platforms_in_output_dir_legacy_heuristic ditetapkan, gunakan nama singkat berdasarkan Label platform saat ini. Akhirnya, {i>hash<i} dari opsi platform
digunakan sebagai upaya terakhir.
Tag:affects_outputs
,experimental
--[no]experimental_use_llvm_covmap
default: "salah"-
Jika ditentukan, Bazel akan membuat informasi peta cakupan llvm-cov, bukan gcov saat collect_code_coverage diaktifkan.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
default: "true"-
Harap gunakan tanda ini hanya sebagai bagian dari strategi migrasi atau pengujian yang disarankan. Perhatikan bahwa heuristik memiliki kekurangan yang telah diketahui, jadi sebaiknya migrasikan untuk hanya mengandalkan --experimental_override_name_platform_in_output_dir.
Tag:affects_outputs
,experimental
--fat_apk_cpu=<comma-separated set of options>
default: "armeabi-v7a"-
Menyetel opsi ini akan mengaktifkan APK lemak, yang berisi biner native untuk semua arsitektur target yang ditentukan, misalnya, --fat_apk_cpu=x86,armeabi-v7a. Jika flag ini ditentukan, maka --android_cpu diabaikan untuk dependensi aturan android_binary.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]fat_apk_hwasan
default: "salah"-
Flag tanpa pengoperasian. Akan dihapus dalam rilis mendatang.
Tag:no_op
--fdo_instrument=<a string>
default: lihat deskripsi-
Membuat biner dengan instrumentasi FDO. Dengan compiler Clang/LLVM, compiler ini juga menerima nama direktori tempat file profil mentah akan dibuang saat runtime.
Tag:affects_outputs
--fdo_optimize=<a string>
default: lihat deskripsi-
Gunakan informasi profil FDO untuk mengoptimalkan kompilasi. Tentukan nama file zip yang berisi hierarki file .gcda, file afdo yang berisi profil otomatis, atau file profil LLVM. Tanda ini juga menerima file yang ditentukan sebagai label (mis. `//foo/bar:file.afdo` - Anda mungkin perlu menambahkan perintah `exports_files` ke paket terkait) dan label yang mengarah ke target `fdo_profile`. Tanda ini akan digantikan oleh aturan `fdo_profile`.
Tag:affects_outputs
--fdo_prefetch_hints=<a build target label>
default: lihat deskripsi-
Gunakan petunjuk pengambilan data cache.
Tag:affects_outputs
--fdo_profile=<a build target label>
default: lihat deskripsi-
fdo_profile yang mewakili profil yang akan digunakan untuk pengoptimalan.
Tag:affects_outputs
--features=<a string>
beberapa penggunaan diakumulasikan-
Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi target. Menentukan -<feature> akan menonaktifkan fitur. Fitur negatif selalu menggantikan fitur positif. Lihat juga --host_features
Tag:changes_inputs
,affects_outputs
--[no]force_pic
default: "salah"-
Jika diaktifkan, semua kompilasi C++ akan menghasilkan kode yang bergantung pada posisi ("-fPIC"), link akan lebih memilih library bawaan PIC daripada library non-PIC, dan link menghasilkan file yang dapat dieksekusi tanpa bergantung posisi ("-pie").
Tag:loading_and_analysis
,affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi eksekusi. Variabel dapat ditetapkan berdasarkan nama, dalam hal ini nilai akan diambil dari lingkungan pemanggilan, atau oleh pasangan nama=nilai yang menetapkan nilai yang tidak bergantung pada lingkungan pemanggilan. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, nilai terbaru yang diperoleh, opsi untuk variabel yang berbeda akan diakumulasikan.
Tag:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
default: "opt"-
Tentukan mode yang akan digunakan alat selama proses build. Nilai: 'fastbuild', 'dbg', 'opt'.
Tag:affects_outputs
,action_command_lines
--host_conlyopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke compiler C saat mengompilasi file sumber C (tetapi bukan C++) dalam konfigurasi exec.
Tag:action_command_lines
,affects_outputs
--host_copt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke compiler C untuk alat yang dibuat dalam konfigurasi exec.
Tag:action_command_lines
,affects_outputs
--host_cpu=<a string>
default: ""-
CPU host.
Tag:changes_inputs
,affects_outputs
--host_cxxopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke compiler C++ untuk alat yang dibuat dalam konfigurasi exec.
Tag:action_command_lines
,affects_outputs
--host_features=<a string>
beberapa penggunaan diakumulasikan-
Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi exec. Menentukan -<feature> akan menonaktifkan fitur. Fitur negatif selalu menggantikan fitur positif.
Tag:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
default: lihat deskripsi-
Mengganti versi Python untuk konfigurasi exec. Dapat berupa "PY2" atau "PY3".
Tag:loading_and_analysis
,affects_outputs
--host_linkopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke penaut saat menautkan alat dalam konfigurasi eksekusi.
Tag:action_command_lines
,affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi macOS minimum yang kompatibel untuk target host. Jika tidak ditentukan, 'macos_sdk_version' akan digunakan.
Tag: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>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan secara selektif ke compiler C/C++ saat mengompilasi file tertentu dalam konfigurasi exec. Opsi ini dapat diteruskan beberapa kali. Sintaks: regex_filter@option_1,option_2,...,option_n. Di mana regex_filter adalah singkatan dari daftar pola sertakan dan kecualikan ekspresi reguler (Lihat juga --instrumentation_filter). option_1 menjadi option_n yang berarti opsi baris perintah arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ yang pertama digunakan untuk memisahkan string. Contoh: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 menambahkan opsi command line -O0 ke command line gcc dari semua file cc di //foo/ kecuali bar.cc.
Tag:action_command_lines
,affects_outputs
--[no]incompatible_auto_exec_groups
default: "salah"-
Jika diaktifkan, grup eksekusi akan otomatis dibuat untuk setiap toolchain yang digunakan oleh suatu aturan. Agar aturan ini berfungsi, perlu menentukan parameter `toolchain` pada tindakannya. Untuk informasi selengkapnya, lihat https://github.com/bazelbuild/bazel/issues/17134.
Tag:affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
default: "true"-
Jika true (benar), direktori genfiles akan dilipat ke dalam direktori tempat sampah.
Tag:affects_outputs
,incompatible_change
--[no]instrument_test_targets
default: "salah"-
Jika cakupan diaktifkan, tentukan apakah akan mempertimbangkan aturan pengujian instrumentasi. Jika ditetapkan, aturan pengujian yang disertakan oleh --instrumentation_filter akan diinstrumentasikan. Jika tidak, aturan pengujian selalu dikecualikan dari instrumentasi cakupan.
Tag:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
default: "-/javatests[/:],-/test/java[/:]"-
Jika cakupan diaktifkan, hanya aturan dengan nama yang disertakan oleh filter berbasis ekspresi reguler yang ditentukan yang akan diinstrumentasikan. Aturan yang diawali dengan '-' akan dikecualikan. Perhatikan bahwa hanya aturan non-pengujian yang diinstrumentasikan kecuali --instrument_test_targets diaktifkan.
Tag:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi iOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, 'ios_sdk_version' akan digunakan.
Tag:loses_incremental_state
--ios_multi_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk mem-build aplikasi ios_. Hasilnya adalah biner universal yang berisi semua arsitektur yang ditentukan.
Tag:loses_incremental_state
,loading_and_analysis
--[no]legacy_whole_archive
default: "true"-
Tidak digunakan lagi, digantikan oleh --incompatible_remove_legacy_whole_archive (lihat https://github.com/bazelbuild/bazel/issues/7362 untuk mengetahui detailnya). Saat aktif, gunakan --whole-archive untuk aturan cc_binary yang memiliki linkshared=True dan linkstatic=True atau '-static' di linkopts. Ini hanya untuk kompatibilitas mundur. Alternatif yang lebih baik adalah menggunakan alwayslink=1 jika diperlukan.
Tag:action_command_lines
,affects_outputs
,deprecated
--linkopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke gcc saat menautkan.
Tag:action_command_lines
,affects_outputs
--ltobackendopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke langkah backend LTO (di bagian --features=thin_lto).
Tag:action_command_lines
,affects_outputs
--ltoindexopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke langkah pengindeksan LTO (pada --features=thin_lto).
Tag:action_command_lines
,affects_outputs
--macos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang akan digunakan untuk mem-build biner Apple macOS.
Tag:loses_incremental_state
,loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi macOS minimum yang kompatibel untuk target. Jika tidak ditentukan, 'macos_sdk_version' akan digunakan.
Tag:loses_incremental_state
--memprof_profile=<a build target label>
default: lihat deskripsi-
Gunakan profil memprof.
Tag:affects_outputs
--[no]objc_debug_with_GLIBCXX
default: "salah"-
Jika disetel, dan mode kompilasi ditetapkan ke 'dbg', tentukan GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC, dan GLIBCPP_CONCEPT_CHECKS.
Tag:action_command_lines
--[no]objc_enable_binary_stripping
default: "salah"-
Apakah akan melakukan stripping simbol dan kode mati pada biner yang ditautkan. Pengupasan biner akan dilakukan jika tanda ini dan --compilation_mode=opt ditentukan.
Tag:action_command_lines
--objccopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke gcc saat mengompilasi file sumber Objective-C/C++.
Tag: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>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan secara selektif ke gcc saat mengompilasi file tertentu. Opsi ini dapat diteruskan beberapa kali. Sintaks: regex_filter@option_1,option_2,...,option_n. Di mana regex_filter adalah singkatan dari daftar pola sertakan dan kecualikan ekspresi reguler (Lihat juga --instrumentation_filter). option_1 menjadi option_n yang berarti opsi baris perintah arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ yang pertama digunakan untuk memisahkan string. Contoh: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 menambahkan opsi command line -O0 ke command line gcc dari semua file cc di //foo/ kecuali bar.cc.
Tag: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>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan secara selektif ke backend LTO (dalam --features=thin_lto) saat mengompilasi objek backend tertentu. Opsi ini dapat diteruskan beberapa kali. Sintaks: regex_filter@option_1,option_2,...,option_n. Di mana regex_filter merupakan singkatan dari daftar pola penyertaan dan kecualikan pola ekspresi reguler. options_1 menjadi option_n adalah singkatan dari opsi baris perintah arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ yang pertama digunakan untuk memisahkan string. Contoh: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 menambahkan opsi command line -O0 ke command line backend LTO dari semua file o di //foo/ kecuali bar.o.
Tag:action_command_lines
,affects_outputs
--platform_suffix=<a string>
default: lihat deskripsi-
Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.
Tag:loses_incremental_state
,affects_outputs
,loading_and_analysis
--propeller_optimize=<a build target label>
default: lihat deskripsi-
Gunakan informasi profil Propeller untuk mengoptimalkan target build.Profil propeller harus terdiri dari minimal satu dari dua file, profil cc dan profil ld. Flag ini menerima label build yang harus merujuk pada file input profil propeller. Misalnya, file BUILD yang menentukan label, dalam a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Perintah ekspor_files mungkin harus ditambahkan ke paket yang sesuai agar file ini terlihat oleh Bazel. Opsi tersebut harus digunakan sebagai: --propeller_optimize=//a/b:propeller_profile
Tag:action_command_lines
,affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
default: lihat deskripsi-
Nama jalur absolut file cc_profile untuk build yang Dioptimalkan untuk Propeller.
Tag:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
default: lihat deskripsi-
Nama jalur absolut file ld_profile untuk build yang Dioptimalkan untuk Propeller.
Tag:affects_outputs
--run_under=<a prefix in front of command>
default: lihat deskripsi-
Awalan yang akan disisipkan sebelum file yang dapat dieksekusi untuk perintah 'test' dan 'run'. Jika nilainya adalah 'foo -bar', dan command line eksekusi adalah 'test_binary -baz', command line terakhir adalah 'foo -bar test_binary -baz'.Ini juga dapat menjadi label untuk target yang dapat dieksekusi. Beberapa contohnya adalah: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Tag:action_command_lines
-
Jika benar, library native yang berisi fungsi identik akan dibagikan di antara target yang berbeda
Tag:loading_and_analysis
,affects_outputs
--[no]stamp
default: "salah"-
Stempel biner dengan tanggal, nama pengguna, nama host, informasi ruang kerja, dll.
Tag:affects_outputs
--strip=<always, sometimes or never>
default: "terkadang"-
Menentukan apakah akan menghapus biner dan library bersama (menggunakan "-Wl,--strip-debug"). Nilai {i>default<i} dari 'kadang-kadang' berarti strip iff --compilation_mode=fastbuild.
Tag:affects_outputs
--stripopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke strip saat membuat biner '<name>.stripped'.
Tag:action_command_lines
,affects_outputs
--tvos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang memerlukan biner Apple tvOS.
Tag:loses_incremental_state
,loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi tvOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, 'tvos_sdk_version' akan digunakan.
Tag:loses_incremental_state
--visionos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang memerlukan biner Apple visionOS.
Tag:loses_incremental_state
,loading_and_analysis
--watchos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang memerlukan biner Apple watchOS.
Tag:loses_incremental_state
,loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi watchOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, 'watchos_sdk_version' akan digunakan.
Tag:loses_incremental_state
--xbinary_fdo=<a build target label>
default: lihat deskripsi-
Menggunakan informasi profil XbinaryFDO untuk mengoptimalkan kompilasi. Tentukan nama profil lintas biner default. Jika opsi tersebut digunakan bersama dengan --fdo_instrument/--fdo_optimize/--fdo_profile, opsi tersebut akan selalu berlaku seolah-olah xbinary_fdo tidak pernah ditentukan.
Tag:affects_outputs
- Opsi yang memengaruhi seberapa ketat Bazel dalam menerapkan input build yang valid (definisi aturan, kombinasi flag, dll.):
--auto_cpu_environment_group=<a build target label>
default: ""-
Deklarasikan lingkungan_group yang akan digunakan untuk memetakan nilai CPU ke nilai target_environment secara otomatis.
Tag:changes_inputs
,loading_and_analysis
,experimental
--[no]check_licenses
default: "salah"-
Pastikan batasan pemberian lisensi yang diberlakukan oleh paket dependen tidak bertentangan dengan mode distribusi target yang dibuat. Secara default, lisensi tidak dicentang.
Tag:build_file_semantics
--[no]check_visibility
default: "true"-
Jika dinonaktifkan, error visibilitas dalam dependensi target akan didemosikan menjadi peringatan.
Tag:build_file_semantics
--[no]desugar_for_android
default: "true"-
Apakah akan mendesugar bytecode Java 8 sebelum melakukan dexing.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]desugar_java8_libs
default: "salah"-
Apakah akan menyertakan library Java 8 yang didukung dalam aplikasi untuk perangkat lama.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[no]enforce_constraints
default: "true"-
Memeriksa lingkungan yang kompatibel dengan setiap target dan melaporkan error jika ada target yang memiliki dependensi yang tidak mendukung lingkungan yang sama
Tag:build_file_semantics
--[no]experimental_check_desugar_deps
default: "true"-
Apakah akan memeriksa kembali desugaring yang benar pada tingkat biner Android.
Tag:eagerness_to_exit
,loading_and_analysis
,experimental
--experimental_import_deps_checking=<off, warning or error>
default: "OFF"-
Jika diaktifkan, periksa apakah dependensi aar_import sudah lengkap. Penerapan ini dapat merusak build, atau hanya menghasilkan peringatan.
Tag:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
default: "default"-
Jika true (benar), periksa apakah target Java secara eksplisit mendeklarasikan semua target yang digunakan secara langsung sebagai dependensi.
Tag:build_file_semantics
,eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
default: "salah"-
Jika diaktifkan, periksa (hanya pengujian) untuk menemukan target prasyarat yang merupakan file output dengan mencari aturan yang menghasilkan hanya uji coba. Ini cocok dengan pemeriksaan visibilitas.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_check_visibility_for_toolchains
default: "salah"-
Jika diaktifkan, pemeriksaan visibilitas juga berlaku untuk implementasi toolchain.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_disable_native_android_rules
default: "salah"-
Jika diaktifkan, penggunaan langsung aturan Android native akan dinonaktifkan. Gunakan aturan Android Starlark dari https://github.com/bazelbuild/rules_android
Tag:eagerness_to_exit
,incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
default: "salah"-
Tanpa pengoperasian. Disimpan di sini untuk kompatibilitas mundur.
Tag:eagerness_to_exit
,incompatible_change
--[no]incompatible_python_disable_py2
default: "true"-
Jika true (benar), menggunakan setelan Python 2 akan menyebabkan error. Ini termasuk python_version=PY2, srcs_version=PY2, dan srcs_version=PY2ONLY. Lihat https://github.com/bazelbuild/bazel/issues/15684 untuk informasi selengkapnya.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
default: "true"-
Flag ini bersifat noop dan dijadwalkan untuk dihapus.
Tag:no_op
,incompatible_change
--python_native_rules_allowlist=<a build target label>
default: lihat deskripsi-
Daftar yang diizinkan (target paket_grup) untuk digunakan saat menerapkan --incompatible_python_disallow_native_rules.
Tag:loading_and_analysis
--[no]strict_filesets
default: "salah"-
Jika opsi ini diaktifkan, kumpulan file yang melewati batas paket akan dilaporkan sebagai error.
Tag:build_file_semantics
,eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
default: "error"-
Kecuali NONAKTIF, memeriksa apakah target proto_library secara eksplisit mendeklarasikan semua target yang digunakan secara langsung sebagai dependensi.
Tag:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Default
--strict_public_imports=<off, warn, error, strict or default>
: "off" -
Kecuali NONAKTIF, akan memeriksa apakah target proto_library secara eksplisit mendeklarasikan semua target yang digunakan dalam 'impor publik' sebagai diekspor.
Tag:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
default: "salah"-
Jika true (benar), header yang ditemukan melalui jalur penyertaan sistem (-isystem) juga harus dideklarasikan.
Tag:loading_and_analysis
,eagerness_to_exit
--target_environment=<a build target label>
beberapa penggunaan diakumulasikan-
Mendeklarasikan lingkungan target build ini. Harus berupa referensi label ke aturan "lingkungan". Jika ditentukan, semua target tingkat teratas harus kompatibel dengan lingkungan ini.
Tag:changes_inputs
- Opsi yang memengaruhi output penandatanganan build:
- Default
--apk_signing_method=<v1, v2, v1_v2 or v4>
: "v1_v2" -
Implementasi yang akan digunakan untuk menandatangani APK
Tag:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
default: "true"-
Jika disetel, dan mode kompilasi tidak 'opt', aplikasi objc akan menyertakan hak debug saat menandatangani.
Tag:changes_inputs
--ios_signing_cert_name=<a string>
default: lihat deskripsi-
Nama sertifikat yang akan digunakan untuk penandatanganan iOS. Jika tidak disetel, perangkat akan kembali ke profil penyediaan. Dapat berupa preferensi identitas keychain sertifikat atau (substring) dari nama umum sertifikat, sesuai halaman utama codesign (SIGNING IDENTITIES).
Tag:action_command_lines
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
default: "salah"-
Jika incompatible_enforce_config_setting_visi=false, berarti noop. Selain itu, jika tanda ini bernilai salah, config_setting apa pun yang tidak memiliki atribut visibilitas eksplisit akan menjadi //visibility:public. Jika tanda ini bernilai benar, config_setting mengikuti logika visibilitas yang sama seperti semua aturan lainnya. Lihat https://github.com/bazelbuild/bazel/issues/12933.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_legacy_py_provider
default: "true"-
Tanpa pengoperasian, akan segera dihapus.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
default: "salah"-
Jika true (benar), larang atribut sdk_frameworks dan active_sdk_frameworks di objc_library danobjc_import.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
default: "true"-
Jika true, terapkan batasan visibilitas config_setting. Jika false, setiap config_setting terlihat oleh setiap target. Lihat https://github.com/bazelbuild/bazel/issues/12932.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_objc_alwayslink_by_default
default: "salah"-
Jika true (benar), tetapkan nilai default ke benar (true) untuk atribut alwayslink di objc_library dan objc_import.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_python_disallow_native_rules
default: "salah"-
Jika true (benar), error akan terjadi saat menggunakan aturan py_* bawaan; aturan rule_python harus digunakan. Lihat https://github.com/bazelbuild/bazel/issues/17773 untuk informasi selengkapnya dan petunjuk migrasi.
Tag:loading_and_analysis
,incompatible_change
- Opsi yang mengatur perilaku lingkungan pengujian atau runner pengujian:
--[no]allow_analysis_failures
default: "salah"-
Jika true (benar), kegagalan analisis target aturan akan menyebabkan propagasi target dari instance AnalysisFailureInfo yang berisi deskripsi error, bukan mengakibatkan kegagalan build.
Tag:loading_and_analysis
,experimental
- Default
--analysis_testing_deps_limit=<an integer>
: "2000" -
Menetapkan jumlah maksimum dependensi transitif melalui atribut aturan dengan transisi konfigurasi for_analysis_testing. Melebihi batas ini akan menyebabkan error aturan.
Tag:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
default: "salah"-
Jika kegagalan tindakan dex2oat yang sebenarnya akan menyebabkan build rusak, bukan mengeksekusi dex2oat selama runtime pengujian.
Tag:loading_and_analysis
,experimental
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g memory=10,30,60,100>
beberapa penggunaan diakumulasikan- Mengganti jumlah resource default untuk pengujian. Format yang diharapkan adalah <resource>=<value>. Jika satu angka positif ditetapkan sebagai <value>, resource default untuk semua ukuran pengujian akan diganti. Jika 4 angka yang dipisahkan koma ditentukan, angka tersebut akan menggantikan jumlah resource untuk masing-masing ukuran pengujian kecil, sedang, besar, dan sangat besar. Nilai juga bisa berupa HOST_RAM/HOST_CPU, secara opsional diikuti oleh [-|*]<float> (mis. memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4). Resource pengujian default yang ditentukan oleh flag ini diganti oleh resource eksplisit yang ditentukan dalam tag.
--[no]experimental_android_use_parallel_dex2oat
default: "salah"-
Gunakan dex2oat secara paralel untuk mempercepat android_test.
Tag:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--[no]ios_memleaks
default: "salah"-
Mengaktifkan pemeriksaan kebocoran memori di target ios_test.
Tag:action_command_lines
--ios_simulator_device=<a string>
default: lihat deskripsi-
Perangkat yang akan disimulasikan saat menjalankan aplikasi iOS di simulator, misalnya 'iPhone 6'. Anda bisa mendapatkan daftar perangkat dengan menjalankan 'xcrun simctl list devicetypes' di mesin tempat simulator akan dijalankan.
Tag:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi iOS yang akan dijalankan pada simulator saat dijalankan atau diuji. Nilai ini diabaikan untuk aturan ios_test jika perangkat target ditentukan dalam aturan.
Tag:test_runner
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
beberapa penggunaan diakumulasikan- Menentukan jumlah waktu untuk menjalankan setiap pengujian. Jika salah satu upaya tersebut gagal karena alasan apa pun, seluruh pengujian akan dianggap gagal. Biasanya nilai yang ditentukan hanya berupa bilangan bulat. Contoh: --runs_per_test=3 akan menjalankan semua pengujian 3 kali. Sintaksis alternatif: regex_filter@runs_per_test. Di mana run_per_test merupakan singkatan dari nilai integer dan regex_filter adalah singkatan dari daftar yang mencakup dan mengecualikan pola ekspresi reguler (Lihat juga --instrumentation_filter). Contoh: --runs_per_test=//foo/.*,-//foo/bar/.*@3 menjalankan semua pengujian di //foo/ kecuali yang berada di bawah foo/bar tiga kali. Opsi ini dapat diteruskan beberapa kali. Argumen yang terakhir diteruskan yang cocok akan diprioritaskan. Jika tidak ada yang cocok, pengujian hanya akan dijalankan sekali.
--test_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan variabel lingkungan tambahan yang akan dimasukkan ke lingkungan runner pengujian. Variabel dapat ditentukan berdasarkan nama, dan nilainya akan dibaca dari lingkungan klien Bazel, atau berdasarkan pasangan nama=nilai. Opsi ini dapat digunakan beberapa kali untuk menentukan beberapa variabel. Hanya digunakan oleh perintah 'bazel test'.
Tag:test_runner
- Default
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - Mengganti nilai waktu tunggu pengujian default untuk waktu tunggu pengujian (dalam detik). Jika ditentukan, hanya satu nilai bilangan bulat positif yang akan mengganti semua kategori. Jika ditentukan 4 bilangan bulat yang dipisahkan koma, waktu tunggu tersebut akan menggantikan waktu tunggu untuk singkat, sedang, panjang, dan abadi (dalam urutan tersebut). Dalam kedua bentuk tersebut, nilai -1 akan memberi tahu blaze untuk menggunakan waktu tunggu defaultnya untuk kategori tersebut.
--[no]zip_undeclared_test_outputs
default: "true"-
Jika true (benar), output pengujian yang tidak dideklarasikan akan diarsipkan dalam file ZIP.
Tag:test_runner
- Opsi yang berkaitan dengan output kueri dan semantik:
--aspect_deps=<off, conservative or precise>
default: "konservatif"-
Cara me-resolve dependensi aspek jika format output adalah salah satu dari {xml,proto,record}. 'off' berarti tidak ada dependensi aspek yang diselesaikan, 'konservatif' (default) berarti semua dependensi aspek yang dideklarasikan akan ditambahkan terlepas dari apakah dependensi tersebut diberi class aturan dependensi langsung atau tidak, 'precise' berarti hanya aspek yang ditambahkan yang mungkin aktif berdasarkan class aturan dependensi langsung. Perhatikan bahwa mode presisi mengharuskan pemuatan paket lain untuk mengevaluasi satu target sehingga membuatnya lebih lambat daripada mode lainnya. Perhatikan juga bahwa mode yang tepat pun tidak sepenuhnya tepat: keputusan apakah akan menghitung suatu aspek ditentukan dalam fase analisis, yang tidak dijalankan selama 'kueri bazel'.
Tag:build_file_semantics
--[no]consistent_labels
default: "salah"-
Jika diaktifkan, setiap perintah kueri akan memunculkan label seolah-olah oleh fungsi <code>str</code> Starlark yang diterapkan ke instance <code>Label</code>. Hal ini berguna untuk alat yang perlu mencocokkan {i>output<i} dari berbagai perintah kueri dan/atau label yang dihasilkan oleh aturan. Jika tidak diaktifkan, pemformat output bebas memunculkan nama repositori yang jelas (relatif terhadap repositori utama) agar output lebih mudah dibaca.
Tag:terminal_output
--[no]experimental_explicit_aspects
default: "salah"-
kueri, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: tanpa pengoperasian (aspek selalu diikuti).
Tag:terminal_output
--[no]graph:factored
default: "true"-
Jika benar, grafik akan dimunculkan 'difaktorkan', yaitu node yang setara secara topologis akan digabungkan bersama dan labelnya akan digabungkan. Opsi ini hanya berlaku untuk --output=graph.
Tag:terminal_output
- Default
--graph:node_limit=<an integer>
: "512" -
Panjang maksimum string label untuk node grafik dalam output. Label yang lebih panjang akan dipotong; -1 berarti tidak ada pemotongan. Opsi ini hanya berlaku untuk --output=graph.
Tag:terminal_output
--[no]implicit_deps
default: "true"-
Jika diaktifkan, dependensi implisit akan disertakan dalam grafik dependensi tempat kueri dioperasikan. Dependensi implisit adalah dependensi yang tidak disebutkan secara eksplisit dalam file BUILD tetapi ditambahkan oleh bazel. Untuk cquery, opsi ini mengontrol pemfilteran toolchain yang di-resolve.
Tag:build_file_semantics
--[no]include_aspects
default: "true"-
kueri, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: tanpa pengoperasian (aspek selalu diikuti).
Tag:terminal_output
--[no]incompatible_package_group_includes_double_slash
default: "true"-
Jika diaktifkan, saat menghasilkan output atribut `packages` package_group, `//` awal tidak akan dihilangkan.
Tag:terminal_output
,incompatible_change
--[no]infer_universe_scope
default: "salah"-
Jika ditetapkan dan --universe_scope tidak ditetapkan, nilai --universe_scope akan disimpulkan sebagai daftar pola target unik dalam ekspresi kueri. Perhatikan bahwa nilai --universe_scope yang disimpulkan untuk ekspresi kueri yang menggunakan fungsi cakupan alam semesta (misalnya `allrdeps`) mungkin bukan yang Anda inginkan, jadi sebaiknya gunakan opsi ini hanya jika Anda tahu apa yang Anda lakukan. Lihat https://bazel.build/reference/query#sky-query untuk mengetahui detail dan contohnya. Jika --universe_scope ditetapkan, nilai opsi ini akan diabaikan. Catatan: opsi ini hanya berlaku untuk `query` (bukan `cquery`).
Tag:loading_and_analysis
--[no]line_terminator_null
default: "salah"-
Apakah setiap format dihentikan dengan \0, bukan baris baru.
Tag:terminal_output
--[no]nodep_deps
default: "true"-
Jika diaktifkan, dependensi dari atribut "nodep" akan disertakan dalam grafik dependensi yang digunakan untuk mengoperasikan kueri. Contoh umum atribut "nodep" adalah "visibilitas". Jalankan dan uraikan output `info build-language` untuk mempelajari semua atribut "nodep" dalam bahasa build.
Tag:build_file_semantics
--output=<a string>
default: "label"-
Format yang akan digunakan untuk mencetak hasil kueri. Nilai yang diizinkan untuk cquery adalah: label, label_types, textproto, transisi, proto, downstream_proto, jsonproto. Jika memilih 'transitions', Anda juga harus menentukan opsi --transitions=(lite|full).
Tag:terminal_output
--[no]proto:default_values
default: "true"-
Jika true (benar), atribut yang nilainya tidak ditentukan secara eksplisit dalam file BUILD akan disertakan; jika tidak, atribut tersebut akan dihilangkan. Opsi ini berlaku untuk --output=proto
Tag:terminal_output
--[no]proto:definition_stack
default: "salah"-
Isi kolom proto definisi_stack, yang mencatat setiap instance aturan stack panggilan Starlark pada saat class aturan ditentukan.
Tag:terminal_output
--[no]proto:flatten_selects
default: "true"-
Jika diaktifkan, atribut yang dapat dikonfigurasi yang dibuat oleh select() akan diratakan. Untuk jenis daftar, representasi yang disatukan adalah daftar yang berisi setiap nilai peta yang dipilih dengan tepat satu kali. Jenis skalar diratakan menjadi null.
Tag:build_file_semantics
--[no]proto:include_attribute_source_aspects
default: "salah"-
Isi kolom proto source_aspect_name dari setiap Atribut dengan aspek sumber tempat atribut tersebut berasal (string kosong jika bukan).
Tag:terminal_output
--[no]proto:include_configurations
default: "true"-
jika diaktifkan, output proto akan menyertakan informasi tentang konfigurasi. Jika dinonaktifkan,format output proto cquery akan menyerupai format output kueri.
Tag:affects_outputs
--[no]proto:include_synthetic_attribute_hash
default: "salah"-
Apakah akan menghitung dan mengisi atribut $internal_attr_hash atau tidak.
Tag:terminal_output
--[no]proto:instantiation_stack
default: "salah"-
Isi stack panggilan pembuatan instance dari setiap aturan. Perhatikan bahwa stack harus ada
Tag:terminal_output
--[no]proto:locations
default: "true"-
Apakah akan menghasilkan informasi lokasi dalam output proto atau tidak.
Tag:terminal_output
- Default
--proto:output_rule_attrs=<comma-separated list of options>
: "all" -
Daftar atribut yang dipisahkan koma untuk disertakan dalam output. Setelan defaultnya adalah semua atribut. Setel ke string kosong agar tidak menghasilkan output atribut apa pun. Opsi ini berlaku untuk --output=proto.
Tag:terminal_output
--[no]proto:rule_inputs_and_outputs
default: "true"-
Apakah kolom rule_input dan rule_output mengisi atau tidak.
Tag:terminal_output
--query_file=<a string>
default: ""-
Jika ditetapkan, kueri akan membaca kueri dari file yang disebutkan di sini, bukan dari command line. Menentukan file di sini serta kueri command line merupakan suatu error.
Tag:changes_inputs
--[no]relative_locations
default: "salah"-
Jika true (benar), lokasi file BUILD dalam output xml dan proto akan bersifat relatif. Secara default, output lokasi adalah jalur absolut dan tidak akan konsisten di seluruh mesin. Anda dapat menyetel opsi ini ke benar (true) agar mendapatkan hasil yang konsisten di seluruh mesin.
Tag:terminal_output
- Default
--show_config_fragments=<off, direct or transitive>
: "off" -
Menampilkan fragmen konfigurasi yang diperlukan oleh aturan dan dependensi transitifnya. Hal ini dapat berguna untuk mengevaluasi seberapa banyak grafik target yang dikonfigurasi dapat dipangkas.
Tag:affects_outputs
--starlark:expr=<a string>
default: ""-
Ekspresi Starlark untuk memformat setiap target yang dikonfigurasi dalam mode --output=starlark cquery. Target yang dikonfigurasi terikat dengan 'target'. Jika --starlark:expr atau --starlark:file tidak ditetapkan, opsi ini akan ditetapkan secara default ke 'str(target.label)'. Menentukan --starlark:expr dan --starlark:file merupakan kesalahan.
Tag:terminal_output
--starlark:file=<a string>
default: ""-
Nama file yang menentukan fungsi Starlark yang disebut 'format', dari satu argumen, yang diterapkan ke setiap target yang dikonfigurasi untuk memformatnya sebagai string. Menentukan --starlark:expr dan --starlark:file merupakan kesalahan. Lihat bantuan untuk --output=starlark untuk detail tambahan.
Tag:terminal_output
--[no]tool_deps
default: "true"-
Kueri: Jika dinonaktifkan, dependensi pada 'exec configuration' tidak akan disertakan dalam grafik dependensi tempat kueri dioperasikan. Edge dependensi 'exec configuration', seperti yang berasal dari aturan 'proto_library' apa pun ke Protocol Compiler, biasanya mengarah ke alat yang dieksekusi selama build, bukan bagian dari program 'target' yang sama.
Cquery: Jika dinonaktifkan, memfilter semua target yang dikonfigurasi yang melewati transisi eksekusi dari target tingkat teratas yang menemukan target yang dikonfigurasi ini. Artinya, jika target tingkat atas ada dalam konfigurasi target, hanya target yang dikonfigurasi dan dalam konfigurasi target yang akan ditampilkan. Jika target tingkat teratas berada dalam konfigurasi eksekusi, hanya target yang dikonfigurasi dengan eksekusi yang akan ditampilkan. Opsi ini TIDAK akan mengecualikan toolchain yang telah diselesaikan.
Tag:build_file_semantics
- Default
--transitions=<full, lite or none>
: "none" -
Format yang digunakan cquery untuk mencetak informasi transisi.
Tag:affects_outputs
--universe_scope=<comma-separated list of options>
default: ""-
Kumpulan pola target yang dipisahkan koma (aditif dan pengurangan). Kueri dapat dilakukan di alam semesta yang ditentukan oleh penutupan transitif target yang ditentukan. Opsi ini digunakan untuk perintah kueri dan kueri.
Untuk cquery, input untuk opsi ini adalah target dari semua jawaban yang dibuat sehingga opsi ini dapat memengaruhi konfigurasi dan transisi. Jika opsi ini tidak ditentukan, target tingkat teratas dianggap sebagai target yang diuraikan dari ekspresi kueri. Catatan: Untuk cquery, tidak menentukan opsi ini dapat menyebabkan build rusak jika target yang diurai dari ekspresi kueri tidak dapat dibuat dengan opsi tingkat atas.
Tag:loading_and_analysis
- Opsi yang terkait dengan semantik dan output Bzlmod:
--[no]configure
default: "salah"-
Hanya mengambil repositori yang ditandai sebagai 'konfigurasi' untuk tujuan konfigurasi sistem. Hanya berfungsi jika --enable_bzlmod aktif.
Tag:changes_inputs
--[no]force
default: "salah"-
Abaikan repositori yang ada jika ada dan ambil repositori lagi secara paksa. Hanya berfungsi jika --enable_bzlmod aktif.
Tag:changes_inputs
--repo=<a string>
beberapa penggunaan diakumulasikan-
Hanya mengambil repositori yang ditentukan, yang dapat berupa {@apparent_repo_name} atau {@@canonical_repo_name}. Hanya berfungsi jika --enable_bzlmod aktif.
Tag:changes_inputs
- Opsi yang memicu pengoptimalan waktu build:
--[no]experimental_filter_library_jar_with_program_jar
default: "salah"-
Filter ProGuard ProgramJar untuk menghapus class yang juga ada di LibraryJar.
Tag:action_command_lines
--[no]experimental_inmemory_dotd_files
default: "true"-
Jika diaktifkan, file .d C++ akan diteruskan dalam memori langsung dari node build jarak jauh, bukan ditulis ke disk.
Tag:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
default: "true"-
Jika diaktifkan, file dependensi (.jdeps) yang dihasilkan dari kompilasi Java akan diteruskan dalam memori langsung dari node build jarak jauh, bukan ditulis ke disk.
Tag:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_retain_test_configuration_across_testonly
default: "salah"-
Jika diaktifkan, --trim_test_configuration tidak akan memangkas konfigurasi pengujian untuk aturan yang ditandai sebagai testonly=1. Hal ini dimaksudkan untuk mengurangi masalah konflik tindakan ketika aturan non-pengujian bergantung pada aturan cc_test. Tidak berpengaruh jika --trim_test_configuration bernilai salah (false).
Tag:loading_and_analysis
,loses_incremental_state
--[no]experimental_starlark_cc_import
default: "salah"-
Jika diaktifkan, versi Starlark dari cc_import dapat digunakan.
Tag:loading_and_analysis
,experimental
--[no]experimental_unsupported_and_brittle_include_scanning
default: "salah"-
Apakah akan mempersempit input ke kompilasi C/C++ dengan menguraikan baris #include dari file input. Hal ini dapat meningkatkan performa dan inkrementalitas dengan mengurangi ukuran hierarki input kompilasi. Namun, tindakan ini juga dapat merusak build karena pemindai penyertaan tidak sepenuhnya mengimplementasikan semantik preprosesor C. Secara khusus, fungsi ini tidak memahami perintah #include dinamis dan mengabaikan logika bersyarat praprosesor. Risiko ditanggung sendiri. Masalah apa pun yang terkait dengan laporan ini akan ditutup.
Tag:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
default: "true"-
Melakukan sebagian besar pekerjaan untuk dexing secara terpisah untuk setiap file Jar.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
default: "true"-
Jika ditetapkan, file .d yang dimunculkan oleh clang akan digunakan untuk memangkas kumpulan input yang diteruskan ke kompilasi objc.
Tag:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
default: "salah"-
Saat membuat target //a:a, header proses di semua target yang menjadi dependensi //a:a (jika pemrosesan header diaktifkan untuk toolchain).
Tag:execution
--[no]trim_test_configuration
default: "true"-
Jika diaktifkan, opsi terkait pengujian akan dihapus di bawah tingkat atas build. Jika flag ini aktif, pengujian tidak dapat dibuat sebagai dependensi aturan bukan pengujian, tetapi perubahan pada opsi terkait pengujian tidak akan menyebabkan aturan non-pengujian dianalisis ulang.
Tag:loading_and_analysis
,loses_incremental_state
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
default: "-.*"-
Mencetak informasi debug selama resolusi toolchain. Flag ini menggunakan ekspresi reguler, yang diperiksa berdasarkan jenis toolchain dan target tertentu untuk melihat mana yang akan di-debug. Beberapa regex dapat dipisahkan dengan koma, kemudian setiap regex diperiksa secara terpisah. Catatan: Output flag ini sangat kompleks dan kemungkinan hanya akan berguna bagi pakar dalam resolusi toolchain.
Tag:terminal_output
- Opsi yang menentukan atau mengubah input umum ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--flag_alias=<a 'name=value' flag alias>
beberapa penggunaan diakumulasikan-
Menetapkan nama singkat untuk flag Starlark. Dibutuhkan satu pasangan nilai kunci dalam bentuk "<key>=<value>" sebagai argumen.
Tag:changes_inputs
--[no]incompatible_default_to_explicit_init_py
default: "salah"-
Flag ini mengubah perilaku default sehingga file __init__.py tidak lagi dibuat secara otomatis di runfile target Python. Tepatnya, jika target py_binary atau py_test memiliki legacy_create_init yang disetel ke "auto" (default), ini diperlakukan sebagai false jika dan hanya jika tanda ini disetel. Lihat https://github.com/bazelbuild/bazel/issues/10076.
Tag:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
default: "true"-
Jika true (benar), target yang dibuat dalam konfigurasi Python 2 akan muncul pada root output yang menyertakan akhiran '-py2', sedangkan target yang dibuat untuk Python 3 akan muncul di root tanpa akhiran terkait Python. Ini berarti symlink praktis `bazel-bin` akan mengarah ke target Python 3, bukan Python 2. Jika mengaktifkan opsi ini, sebaiknya Anda juga mengaktifkan `--incompatible_py3_is_default`.
Tag:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
default: "true"-
Jika true, target `py_binary` dan `py_test` yang tidak menetapkan atribut `python_version` (atau `default_python_version`) akan ditetapkan secara default ke PY3, bukan PY2. Jika Anda menetapkan tanda ini, sebaiknya Anda juga menetapkan `--incompatible_py2_outputs_are_suffixed`.
Tag:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
default: "true"-
Jika disetel ke benar (true), aturan Python native yang dapat dieksekusi akan menggunakan runtime Python yang ditentukan oleh toolchain Python, bukan runtime yang diberikan oleh flag lama seperti --python_top.
Tag:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
default: lihat deskripsi-
Mode versi utama Python, baik `PY2` maupun `PY3`. Perhatikan bahwa hal ini diganti oleh target `py_binary` dan `py_test` (meskipun keduanya tidak menentukan versi secara eksplisit) sehingga biasanya tidak ada banyak alasan untuk menyediakan flag ini.
Tag:loading_and_analysis
,affects_outputs
- Opsi lain, yang tidak dikategorikan lain.:
--[no]cache_test_results
[-t
] default: "otomatis"- Jika disetel ke 'otomatis', Bazel akan menjalankan kembali pengujian jika dan hanya jika: (1) Bazel mendeteksi perubahan dalam pengujian atau dependensinya, (2) pengujian ditandai sebagai eksternal, (3) beberapa pengujian diminta dengan --runs_per_test, atau(4) pengujian sebelumnya gagal. Jika disetel ke 'ya', Bazel akan meng-cache semua hasil pengujian kecuali pengujian yang ditandai sebagai eksternal. Jika disetel ke 'tidak', Bazel tidak akan menyimpan hasil pengujian apa pun dalam cache.
--deleted_packages=<comma-separated list of package names>
beberapa penggunaan diakumulasikan- Daftar nama paket yang dipisahkan koma yang akan dianggap tidak ada oleh sistem build, meskipun jika paket tersebut terlihat di suatu tempat pada jalur paket. Gunakan opsi ini ketika menghapus sub-paket 'x/y' dari paket 'x' yang ada. Misalnya, setelah menghapus x/y/BUILD di klien Anda, sistem build mungkin akan mengeluh jika menemukan label '//x:y/z' jika label tersebut masih disediakan oleh entri package_path lain. Menentukan --deleted_packages x/y akan menghindari masalah ini.
--[no]experimental_cancel_concurrent_tests
default: "salah"-
Jika true (benar), Blaze akan membatalkan pengujian yang berjalan secara serentak pada saat pertama berhasil dijalankan. Parameter ini hanya berguna jika dikombinasikan dengan --runs_per_test_detects_flakes.
Tag:affects_outputs
,loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
default: "salah"-
Jika true (benar), Bazel akan mengambil seluruh direktori data cakupan untuk setiap pengujian selama cakupan dijalankan.
Tag:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
default: "salah"-
Jika benar, cakupan untuk clang akan menghasilkan laporan LCOV.
Tag:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
default: "true"- Apakah akan membuat peta header J2ObjC secara paralel dengan transpilasi J2ObjC.
--[no]experimental_j2objc_shorter_header_path
default: "salah"-
Apakah membuat dengan jalur header yang lebih pendek (menggunakan "_ios", bukan "_j2objc").
Tag:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
default: "javabuilder"- Memungkinkan classpath yang dikurangi untuk kompilasi Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
default: "salah"-
Batasi --experimental_run_android_lint_on_java_rules ke library yang kompatibel dengan Android.
Tag:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
default: "salah"-
Apakah akan memvalidasi sumber java_*.
Tag:affects_outputs
--[no]explicit_java_test_deps
default: "salah"- Secara eksplisit menentukan dependensi untuk JUnit atau Hamcrest dalam java_test, bukan secara tidak sengaja memperoleh dari dependensi TestRunner. Saat ini hanya berfungsi untuk Bagas.
--[no]fetch
default: "true"- Mengizinkan perintah untuk mengambil dependensi eksternal. Jika disetel ke salah (false), perintah akan menggunakan versi dependensi yang di-cache, dan jika tidak ada, perintah tersebut akan gagal.
--host_java_launcher=<a build target label>
default: lihat deskripsi- Peluncur Java yang digunakan oleh alat yang dieksekusi selama proses build.
--host_javacopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan untuk diteruskan ke javac saat mem-build alat yang dijalankan selama proses build.
--host_jvmopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan untuk diteruskan ke VM Java saat mem-build alat yang dijalankan selama proses build. Opsi ini akan ditambahkan ke opsi startup VM dari setiap target java_binary.
--[no]incompatible_check_sharding_support
default: "true"-
Jika benar, Bazel akan gagal dalam pengujian dengan sharding jika runner pengujian tidak menunjukkan bahwa runner pengujian mendukung sharding dengan menyentuh file di jalur di TEST_SHARD_STATUS_FILE. Jika bernilai salah, runner pengujian yang tidak mendukung sharding akan menyebabkan semua pengujian berjalan di setiap shard.
Tag:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
default: "true"-
Jika benar, pengujian eksklusif akan dijalankan dengan strategi yang di-sandbox. Tambahkan tag 'local' untuk memaksakan pengujian eksklusif yang dijalankan secara lokal
Tag:incompatible_change
--[no]incompatible_strict_action_env
default: "salah"-
Jika true (benar), Bazel akan menggunakan lingkungan dengan nilai statis untuk PATH dan tidak mewarisi LD_LIBRARY_PATH. Gunakan --action_env=ENV_VARIABLE jika Anda ingin mewarisi variabel lingkungan tertentu dari klien, namun perhatikan bahwa hal tersebut dapat mencegah penyimpanan cache lintas-pengguna jika cache bersama digunakan.
Tag:loading_and_analysis
,incompatible_change
--j2objc_translation_flags=<comma-separated list of options>
beberapa penggunaan diakumulasikan- Opsi tambahan untuk diteruskan ke alat J2ObjC.
--java_debug
-
Menyebabkan mesin virtual Java pada pengujian java menunggu koneksi dari debugger yang sesuai dengan JDWP (seperti jdb) sebelum memulai pengujian. Menyiratkan -test_output=streamed.
Diluaskan ke:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
default: "true"- Membuat informasi dependensi (untuk saat ini, classpath waktu kompilasi) per target Java.
--[no]java_header_compilation
default: "true"- Mengompilasi ijar langsung dari sumber.
--java_language_version=<a string>
default: ""- Versi bahasa Java
--java_launcher=<a build target label>
default: lihat deskripsi- Peluncur Java yang akan digunakan saat mem-build biner Java. Jika flag ini disetel ke string kosong, peluncur JDK akan digunakan. Atribut "peluncur" menggantikan tanda ini.
--java_runtime_version=<a string>
default: "local_jdk"- Versi runtime Java
--javacopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan untuk diteruskan ke javac.
--jvmopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan untuk diteruskan ke VM Java. Opsi ini akan ditambahkan ke opsi startup VM dari setiap target java_binary.
--legacy_main_dex_list_generator=<a build target label>
default: lihat deskripsi- Menentukan biner yang akan digunakan untuk membuat daftar class yang harus ada di dex utama saat mengompilasi multidex lama.
--optimizing_dexer=<a build target label>
default: lihat deskripsi- Menentukan biner yang akan digunakan untuk melakukan dexing tanpa sharding.
--package_path=<colon-separated list of options>
default: "%workspace%"- Daftar yang dipisahkan titik dua berisi tempat mencari paket. Elemen yang dimulai dengan '%workspace%' akan relatif terhadap ruang kerja yang dicakup. Jika dihilangkan atau kosong, defaultnya adalah output 'bazel info default-package-path'.
--plugin=<a build target label>
beberapa penggunaan diakumulasikan- Plugin yang akan digunakan dalam build. Saat ini berfungsi dengan java_plugin.
--proguard_top=<a build target label>
default: lihat deskripsi- Menentukan versi ProGuard yang akan digunakan untuk penghapusan kode saat mem-build biner Java.
--proto_compiler=<a build target label>
default: "@bazel_tools//tools/proto:protoc"-
Label compiler proto.
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
default: "@bazel_tools//tools/proto:cc_toolchain"-
Label proto_lang_ toolchain() yang menjelaskan cara mengompilasi proto C++
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
default: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Label proto_lang_toolchain() yang menjelaskan cara mengompilasi proto j2objc
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
default: "@bazel_tools//tools/proto:java_Tool"-
Label proto_lang_ toolchain() yang menjelaskan cara mengompilasi proto Java
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
default: "@bazel_tools//tools/proto:javalite_toolchain"-
Label proto_lang_ toolchain() yang menjelaskan cara mengompilasi proto JavaLite
Tag:affects_outputs
,loading_and_analysis
--protocopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke compiler protobuf.
Tag:affects_outputs
--[no]runs_per_test_detects_flakes
default: "salah"- Jika benar, shard apa pun dengan minimal satu percobaan/percobaan lulus dan minimal satu percobaan/percobaan gagal akan mendapatkan status FLAKY.
--shell_executable=<a path>
default: lihat deskripsi-
Jalur absolut ke shell yang dapat dieksekusi untuk digunakan oleh Bazel. Jika variabel ini tidak disetel, tetapi variabel lingkungan BAZEL_SH ditetapkan pada pemanggilan Bazel pertama (yang memulai server Bazel), Bazel akan menggunakannya. Jika tidak ada yang ditetapkan, Bazel menggunakan jalur default hard code tergantung pada sistem operasi tempatnya berjalan (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, lainnya: /bin/bash). Perhatikan bahwa menggunakan shell yang tidak kompatibel dengan bash dapat menyebabkan kegagalan build atau kegagalan runtime dari biner yang dihasilkan.
Tag:loading_and_analysis
--[no]show_loading_progress
default: "true"- Jika diaktifkan, akan menyebabkan Bazel mencetak pesan "Memuat paket:".
--test_arg=<a string>
beberapa penggunaan diakumulasikan- Menentukan opsi dan argumen tambahan yang harus diteruskan ke pengujian yang dapat dieksekusi. Dapat digunakan beberapa kali untuk menentukan beberapa argumen. Jika beberapa pengujian dijalankan, masing-masing pengujian akan menerima argumen yang identik. Hanya digunakan oleh perintah 'bazel test'.
--test_filter=<a string>
default: lihat deskripsi- Menentukan filter untuk diteruskan ke framework pengujian. Digunakan untuk membatasi pengujian yang dijalankan. Perhatikan bahwa hal ini tidak memengaruhi target yang dibuat.
- Default
--test_result_expiration=<an integer>
: "-1" - Opsi ini tidak digunakan lagi dan tidak berpengaruh.
--[no]test_runner_fail_fast
default: "salah"- Opsi cepat diteruskan ke runner pengujian gagal. Runner pengujian harus menghentikan eksekusi setelah kegagalan pertama.
- Default
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
: "eksplisit" - Tentukan strategi untuk sharding pengujian: 'eksplisit' untuk hanya menggunakan sharding jika atribut BUILD 'shard_count' ada. 'dinonaktifkan' agar tidak pernah menggunakan sharding pengujian. 'forced=k' untuk menerapkan shard 'k' untuk pengujian terlepas dari atribut BUILD 'shard_count'.
--tool_java_language_version=<a string>
default: ""- Versi bahasa Java yang digunakan untuk menjalankan alat yang diperlukan selama proses build
--tool_java_runtime_version=<a string>
default: "remotejdk_11"- Versi runtime Java yang digunakan untuk menjalankan alat selama proses build
--[no]use_ijars
default: "true"- Jika diaktifkan, opsi ini akan menyebabkan kompilasi Java menggunakan jar antarmuka. Ini akan menghasilkan kompilasi inkremental yang lebih cepat, tetapi pesan error dapat berbeda.
Opsi Bantuan
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
default: "salah"-
Jika ditetapkan, cache repositori akan menerapkan hardlink pada file jika cache ditemukan, bukan menyalinnya. Hal ini dimaksudkan untuk menghemat kapasitas {i>disk<i}.
Tag:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
default: "0"-
Jumlah upaya maksimum untuk mencoba kembali error download. Jika ditetapkan ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark berdasarkan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi pada komputer yang lebih lambat dari yang diharapkan oleh pembuat aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_connector_attempts=<an integer>
: "8" -
Jumlah upaya maksimum untuk download http.
Tag:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
default: "0s"-
Waktu tunggu maksimum untuk percobaan ulang download http. Dengan nilai 0, tidak ada waktu tunggu maksimum yang ditentukan.
Tag:bazel_internal_configuration
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Skalakan semua waktu tunggu yang terkait dengan download http berdasarkan faktor yang diberikan
Tag:bazel_internal_configuration
--repository_cache=<a path>
default: lihat deskripsi-
Menentukan lokasi cache dari nilai yang didownload yang diperoleh selama pengambilan repositori eksternal. String kosong sebagai argumen meminta cache dinonaktifkan. Jika tidak, default '<output_user_root>/cache/repos/v1' akan digunakan
Tag:bazel_internal_configuration
--[no]repository_disable_download
default: "salah"-
Jika ditetapkan, mendownload menggunakan ctx.download{,_and_extract} tidak akan diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file arbitrer yang dapat dieksekusi yang mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang yang ditempati (0-100) dan di atas batas tersebut, GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika ditetapkan ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_depset_for_java_output_source_jars
default: "true"-
Tanpa pengoperasian.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]separate_aspect_deps
default: "true"-
Tanpa pengoperasian
Tag:no_op
- Opsi yang berkaitan dengan semantik dan output Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan yanked di registry tempatnya berasal (jika bukan berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yanked yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Periksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan jika ketidakcocokan terdeteksi.
Tag:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
default: "peringatan"-
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan dalam modul root adalah versi yang sama dengan yang Anda dapatkan dalam grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasikannya ke kegagalan resolusi.
Tag:loading_and_analysis
--[no]ignore_dev_dependency
default: "salah"-
Jika true (benar), Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan dalam MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "update"-
Menentukan bagaimana dan apakah menggunakan lockfile atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `error` untuk menggunakan lockfile tetapi menampilkan error jika file tidak diperbarui, atau `off` tidak membaca atau menulis ke lockfile.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <module name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan merupakan jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
--vendor_dir=<a path>
default: lihat deskripsi-
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat membangun. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "1 dtk:2,20 dtk:3,1 m:5" -
Batas yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlah berupa bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap generasi lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan dengan koma.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi ketika peristiwa GC penuh terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC kecil terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi saat peristiwa GC kecil terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan setidaknya berada pada ambang batas ini, status Skyframe sementara yang tidak perlu akan hilang. Menyesuaikan hal ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari GC thrashing, jika GC thrashing (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada menyusun ulang status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
--experimental_command_profile=<cpu, wall, alloc or lock>
default: lihat deskripsi- Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alokasi, atau kunci) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa di bawah direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; penggunaan dengan risiko Anda sendiri.
--[no]experimental_record_metrics_for_all_mnemonics
default: "salah"- Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
--help_verbosity=<long, medium or short>
default: "sedang"-
Pilih panjang perintah help.
Tag:terminal_output
--long
[-l
]-
Tampilkan deskripsi lengkap tiap opsi, bukan hanya namanya.
Diluaskan ke:
--help_verbosity=long
Tag:terminal_output
--short
-
Hanya tampilkan nama opsi, bukan jenis atau artinya.
Diluaskan ke:
--help_verbosity=short
Tag:terminal_output
- Opsi yang menentukan atau mengubah input umum ke perintah Bazel yang tidak termasuk dalam kategori lainnya.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika ada file yang telah diselesaikan yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi caching dan eksekusi jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file yang akan digunakan untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk cocok, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik mulai dari `$1`. Beberapa perintah `tulis ulang` untuk URL yang sama dapat diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
default: "otomatis"- Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dimulai ulang. Jika tidak, gunakan thread platform (yaitu thread OS) jika ditetapkan ke 'platform' atau thread virtual jika ditetapkan ke 'virtual'. Jika disetel ke 'auto', thread virtual akan digunakan jika tersedia (yaitu, berjalan di JDK 21+), jika tidak, thread pekerja tidak akan digunakan.
- Opsi lain, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <repositori name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
Opsi Info
Mewarisi semua opsi dari build.
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
default: "salah"-
Jika ditetapkan, cache repositori akan menerapkan hardlink pada file jika cache ditemukan, bukan menyalinnya. Hal ini dimaksudkan untuk menghemat kapasitas {i>disk<i}.
Tag:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
default: "0"-
Jumlah upaya maksimum untuk mencoba kembali error download. Jika ditetapkan ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark berdasarkan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi pada komputer yang lebih lambat dari yang diharapkan oleh pembuat aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_connector_attempts=<an integer>
: "8" -
Jumlah upaya maksimum untuk download http.
Tag:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
default: "0s"-
Waktu tunggu maksimum untuk percobaan ulang download http. Dengan nilai 0, tidak ada waktu tunggu maksimum yang ditentukan.
Tag:bazel_internal_configuration
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Skalakan semua waktu tunggu yang terkait dengan download http berdasarkan faktor yang diberikan
Tag:bazel_internal_configuration
--repository_cache=<a path>
default: lihat deskripsi-
Menentukan lokasi cache dari nilai yang didownload yang diperoleh selama pengambilan repositori eksternal. String kosong sebagai argumen meminta cache dinonaktifkan. Jika tidak, default '<output_user_root>/cache/repos/v1' akan digunakan
Tag:bazel_internal_configuration
--[no]repository_disable_download
default: "salah"-
Jika ditetapkan, mendownload menggunakan ctx.download{,_and_extract} tidak akan diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file arbitrer yang dapat dieksekusi yang mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang yang ditempati (0-100) dan di atas batas tersebut, GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika ditetapkan ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_depset_for_java_output_source_jars
default: "true"-
Tanpa pengoperasian.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]separate_aspect_deps
default: "true"-
Tanpa pengoperasian
Tag:no_op
- Opsi yang berkaitan dengan semantik dan output Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan yanked di registry tempatnya berasal (jika bukan berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yanked yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Periksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan jika ketidakcocokan terdeteksi.
Tag:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
default: "peringatan"-
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan dalam modul root adalah versi yang sama dengan yang Anda dapatkan dalam grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasikannya ke kegagalan resolusi.
Tag:loading_and_analysis
--[no]ignore_dev_dependency
default: "salah"-
Jika true (benar), Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan dalam MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "update"-
Menentukan bagaimana dan apakah menggunakan lockfile atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `error` untuk menggunakan lockfile tetapi menampilkan error jika file tidak diperbarui, atau `off` tidak membaca atau menulis ke lockfile.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <module name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan merupakan jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
--vendor_dir=<a path>
default: lihat deskripsi-
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat membangun. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "1 dtk:2,20 dtk:3,1 m:5" -
Batas yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlah berupa bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap generasi lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan dengan koma.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi ketika peristiwa GC penuh terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC kecil terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi saat peristiwa GC kecil terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan setidaknya berada pada ambang batas ini, status Skyframe sementara yang tidak perlu akan hilang. Menyesuaikan hal ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari GC thrashing, jika GC thrashing (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada menyusun ulang status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
--experimental_command_profile=<cpu, wall, alloc or lock>
default: lihat deskripsi- Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alokasi, atau kunci) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa di bawah direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; penggunaan dengan risiko Anda sendiri.
--[no]experimental_record_metrics_for_all_mnemonics
default: "salah"- Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
--[no]show_make_env
default: "salah"-
Sertakan lingkungan "Buat" dalam output.
Tag:affects_outputs
,terminal_output
- Opsi yang menentukan atau mengubah input umum ke perintah Bazel yang tidak termasuk dalam kategori lainnya.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika ada file yang telah diselesaikan yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi caching dan eksekusi jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file yang akan digunakan untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk cocok, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik mulai dari `$1`. Beberapa perintah `tulis ulang` untuk URL yang sama dapat diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
default: "otomatis"- Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dimulai ulang. Jika tidak, gunakan thread platform (yaitu thread OS) jika ditetapkan ke 'platform' atau thread virtual jika ditetapkan ke 'virtual'. Jika disetel ke 'auto', thread virtual akan digunakan jika tersedia (yaitu, berjalan di JDK 21+), jika tidak, thread pekerja tidak akan digunakan.
- Opsi lain, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <repositori name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
Opsi Lisensi
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
default: "salah"-
Jika ditetapkan, cache repositori akan menerapkan hardlink pada file jika cache ditemukan, bukan menyalinnya. Hal ini dimaksudkan untuk menghemat kapasitas {i>disk<i}.
Tag:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
default: "0"-
Jumlah upaya maksimum untuk mencoba kembali error download. Jika ditetapkan ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark berdasarkan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi pada komputer yang lebih lambat dari yang diharapkan oleh pembuat aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_connector_attempts=<an integer>
: "8" -
Jumlah upaya maksimum untuk download http.
Tag:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
default: "0s"-
Waktu tunggu maksimum untuk percobaan ulang download http. Dengan nilai 0, tidak ada waktu tunggu maksimum yang ditentukan.
Tag:bazel_internal_configuration
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Skalakan semua waktu tunggu yang terkait dengan download http berdasarkan faktor yang diberikan
Tag:bazel_internal_configuration
--repository_cache=<a path>
default: lihat deskripsi-
Menentukan lokasi cache dari nilai yang didownload yang diperoleh selama pengambilan repositori eksternal. String kosong sebagai argumen meminta cache dinonaktifkan. Jika tidak, default '<output_user_root>/cache/repos/v1' akan digunakan
Tag:bazel_internal_configuration
--[no]repository_disable_download
default: "salah"-
Jika ditetapkan, mendownload menggunakan ctx.download{,_and_extract} tidak akan diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file arbitrer yang dapat dieksekusi yang mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang yang ditempati (0-100) dan di atas batas tersebut, GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika ditetapkan ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_depset_for_java_output_source_jars
default: "true"-
Tanpa pengoperasian.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]separate_aspect_deps
default: "true"-
Tanpa pengoperasian
Tag:no_op
- Opsi yang berkaitan dengan semantik dan output Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan yanked di registry tempatnya berasal (jika bukan berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yanked yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Periksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan jika ketidakcocokan terdeteksi.
Tag:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
default: "peringatan"-
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan dalam modul root adalah versi yang sama dengan yang Anda dapatkan dalam grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasikannya ke kegagalan resolusi.
Tag:loading_and_analysis
--[no]ignore_dev_dependency
default: "salah"-
Jika true (benar), Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan dalam MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "update"-
Menentukan bagaimana dan apakah menggunakan lockfile atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `error` untuk menggunakan lockfile tetapi menampilkan error jika file tidak diperbarui, atau `off` tidak membaca atau menulis ke lockfile.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <module name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan merupakan jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
--vendor_dir=<a path>
default: lihat deskripsi-
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat membangun. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "1 dtk:2,20 dtk:3,1 m:5" -
Batas yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlah berupa bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap generasi lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan dengan koma.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi ketika peristiwa GC penuh terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC kecil terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi saat peristiwa GC kecil terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan setidaknya berada pada ambang batas ini, status Skyframe sementara yang tidak perlu akan hilang. Menyesuaikan hal ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari GC thrashing, jika GC thrashing (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada menyusun ulang status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
--experimental_command_profile=<cpu, wall, alloc or lock>
default: lihat deskripsi- Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alokasi, atau kunci) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa di bawah direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; penggunaan dengan risiko Anda sendiri.
--[no]experimental_record_metrics_for_all_mnemonics
default: "salah"- Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika ada file yang telah diselesaikan yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi caching dan eksekusi jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file yang akan digunakan untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk cocok, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik mulai dari `$1`. Beberapa perintah `tulis ulang` untuk URL yang sama dapat diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
default: "otomatis"- Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dimulai ulang. Jika tidak, gunakan thread platform (yaitu thread OS) jika ditetapkan ke 'platform' atau thread virtual jika ditetapkan ke 'virtual'. Jika disetel ke 'auto', thread virtual akan digunakan jika tersedia (yaitu, berjalan di JDK 21+), jika tidak, thread pekerja tidak akan digunakan.
- Opsi lain, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <repositori name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
Opsi Penginstalan Seluler
Mewarisi semua opsi dari build.
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
default: "salah"-
Jika ditetapkan, cache repositori akan menerapkan hardlink pada file jika cache ditemukan, bukan menyalinnya. Hal ini dimaksudkan untuk menghemat kapasitas {i>disk<i}.
Tag:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
default: "0"-
Jumlah upaya maksimum untuk mencoba kembali error download. Jika ditetapkan ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark berdasarkan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi pada komputer yang lebih lambat dari yang diharapkan oleh pembuat aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_connector_attempts=<an integer>
: "8" -
Jumlah upaya maksimum untuk download http.
Tag:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
default: "0s"-
Waktu tunggu maksimum untuk percobaan ulang download http. Dengan nilai 0, tidak ada waktu tunggu maksimum yang ditentukan.
Tag:bazel_internal_configuration
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Skalakan semua waktu tunggu yang terkait dengan download http berdasarkan faktor yang diberikan
Tag:bazel_internal_configuration
--repository_cache=<a path>
default: lihat deskripsi-
Menentukan lokasi cache dari nilai yang didownload yang diperoleh selama pengambilan repositori eksternal. String kosong sebagai argumen meminta cache dinonaktifkan. Jika tidak, default '<output_user_root>/cache/repos/v1' akan digunakan
Tag:bazel_internal_configuration
--[no]repository_disable_download
default: "salah"-
Jika ditetapkan, mendownload menggunakan ctx.download{,_and_extract} tidak akan diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file arbitrer yang dapat dieksekusi yang mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang yang ditempati (0-100) dan di atas batas tersebut, GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika ditetapkan ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
--mode=<classic, classic_internal_test_do_not_use or skylark>
default: "klasik"-
Pilih cara menjalankan penginstalan seluler. "klasik" menjalankan versi penginstalan seluler saat ini. "skylark" menggunakan versi Starlark baru, yang memiliki dukungan untuk android_test.
Tag:loading_and_analysis
,execution
,incompatible_change
- Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
--adb=<a string>
default: ""-
biner adb yang akan digunakan untuk perintah 'mobile-install'. Jika tidak ditentukan, perintah di Android SDK yang ditentukan oleh opsi command line --android_sdk (atau SDK default jika --android_sdk tidak ditentukan) akan digunakan.
Tag:changes_inputs
- Opsi yang mengontrol output perintah:
--[no]incremental
default: "salah"-
Apakah akan melakukan penginstalan inkremental. Jika benar, coba hindari pekerjaan tambahan yang tidak perlu dengan membaca status perangkat tempat kode akan diinstal dan menggunakan informasi tersebut untuk menghindari pekerjaan yang tidak perlu. Jika false (default), selalu lakukan penginstalan penuh.
Tag:loading_and_analysis
--[no]split_apks
default: "salah"-
Apakah akan menggunakan apk terpisah untuk menginstal dan mengupdate aplikasi di perangkat. Hanya berfungsi dengan perangkat dengan Marshmallow atau yang lebih baru
Tag:loading_and_analysis
,affects_outputs
- Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, sehingga memengaruhi nilainya, bukan keberadaannya:
--adb_arg=<a string>
beberapa penggunaan diakumulasikan-
Argumen tambahan untuk diteruskan ke adb. Biasanya digunakan untuk menentukan perangkat yang akan diinstal.
Tag:action_command_lines
--debug_app
-
Apakah menunggu debugger sebelum memulai aplikasi.
Diluaskan ke:
--start=DEBUG
Tag:execution
--device=<a string>
default: ""-
Nomor seri perangkat adb. Jika tidak ditentukan, perangkat pertama akan digunakan.
Tag:action_command_lines
--start=<no, cold, warm or debug>
default: "NO"-
Cara aplikasi harus dimulai setelah menginstalnya. Setel ke WARM untuk mempertahankan dan memulihkan status aplikasi saat penginstalan inkremental.
Tag:execution
--start_app
-
Apakah akan memulai aplikasi setelah menginstalnya.
Diluaskan ke:
--start=COLD
Tag:execution
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_depset_for_java_output_source_jars
default: "true"-
Tanpa pengoperasian.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]separate_aspect_deps
default: "true"-
Tanpa pengoperasian
Tag:no_op
- Opsi yang berkaitan dengan semantik dan output Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan yanked di registry tempatnya berasal (jika bukan berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yanked yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Periksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan jika ketidakcocokan terdeteksi.
Tag:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
default: "peringatan"-
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan dalam modul root adalah versi yang sama dengan yang Anda dapatkan dalam grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasikannya ke kegagalan resolusi.
Tag:loading_and_analysis
--[no]ignore_dev_dependency
default: "salah"-
Jika true (benar), Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan dalam MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "update"-
Menentukan bagaimana dan apakah menggunakan lockfile atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `error` untuk menggunakan lockfile tetapi menampilkan error jika file tidak diperbarui, atau `off` tidak membaca atau menulis ke lockfile.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <module name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan merupakan jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
--vendor_dir=<a path>
default: lihat deskripsi-
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat membangun. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "1 dtk:2,20 dtk:3,1 m:5" -
Batas yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlah berupa bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap generasi lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan dengan koma.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi ketika peristiwa GC penuh terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC kecil terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi saat peristiwa GC kecil terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan setidaknya berada pada ambang batas ini, status Skyframe sementara yang tidak perlu akan hilang. Menyesuaikan hal ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari GC thrashing, jika GC thrashing (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada menyusun ulang status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
--experimental_command_profile=<cpu, wall, alloc or lock>
default: lihat deskripsi- Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alokasi, atau kunci) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa di bawah direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; penggunaan dengan risiko Anda sendiri.
--[no]experimental_record_metrics_for_all_mnemonics
default: "salah"- Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
--incremental_install_verbosity=<a string>
default: ""-
Panjang untuk penginstalan inkremental. Tetapkan ke 1 untuk logging debug.
Tag:bazel_monitoring
- Opsi yang menentukan atau mengubah input umum ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika ada file yang telah diselesaikan yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi caching dan eksekusi jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file yang akan digunakan untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk cocok, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik mulai dari `$1`. Beberapa perintah `tulis ulang` untuk URL yang sama dapat diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
default: "otomatis"- Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dimulai ulang. Jika tidak, gunakan thread platform (yaitu thread OS) jika ditetapkan ke 'platform' atau thread virtual jika ditetapkan ke 'virtual'. Jika disetel ke 'auto', thread virtual akan digunakan jika tersedia (yaitu, berjalan di JDK 21+), jika tidak, thread pekerja tidak akan digunakan.
- Opsi lain, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <repositori name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
Opsi Mod
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
default: "salah"-
Jika ditetapkan, cache repositori akan menerapkan hardlink pada file jika cache ditemukan, bukan menyalinnya. Hal ini dimaksudkan untuk menghemat kapasitas {i>disk<i}.
Tag:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
default: "0"-
Jumlah upaya maksimum untuk mencoba kembali error download. Jika ditetapkan ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark berdasarkan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi pada komputer yang lebih lambat dari yang diharapkan oleh pembuat aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_connector_attempts=<an integer>
: "8" -
Jumlah upaya maksimum untuk download http.
Tag:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
default: "0s"-
Waktu tunggu maksimum untuk percobaan ulang download http. Dengan nilai 0, tidak ada waktu tunggu maksimum yang ditentukan.
Tag:bazel_internal_configuration
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Skalakan semua waktu tunggu yang terkait dengan download http berdasarkan faktor yang diberikan
Tag:bazel_internal_configuration
--repository_cache=<a path>
default: lihat deskripsi-
Menentukan lokasi cache dari nilai yang didownload yang diperoleh selama pengambilan repositori eksternal. String kosong sebagai argumen meminta cache dinonaktifkan. Jika tidak, default '<output_user_root>/cache/repos/v1' akan digunakan
Tag:bazel_internal_configuration
--[no]repository_disable_download
default: "salah"-
Jika ditetapkan, mendownload menggunakan ctx.download{,_and_extract} tidak akan diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file arbitrer yang dapat dieksekusi yang mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang yang ditempati (0-100) dan di atas batas tersebut, GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika ditetapkan ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
--[no]keep_going
[-k
] default: "salah"-
Lanjutkan sebanyak mungkin setelah error. Meskipun target yang gagal dan yang bergantung pada target tersebut tidak dapat dianalisis, prasyarat lain dari target tersebut dapat berupa.
Tag: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">
default: "otomatis"-
Jumlah thread paralel yang digunakan untuk fase pemuatan/analisis. Mengambil bilangan bulat, atau kata kunci ("otomatis", "HOST_CPUS", "HOST_RAM"), dapat diikuti dengan operasi ([-|*]<float>) misalnya, "otomatis", "HOST_CPUS*.5". "{i>auto" <i}menetapkan {i>default<i} yang wajar
berdasarkan sumber daya {i>host<i}. Minimal harus 1.
Tag:bazel_internal_configuration
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
default: "salah"-
Jika incompatible_enforce_config_setting_visi=false, berarti noop. Selain itu, jika tanda ini bernilai salah, config_setting apa pun yang tidak memiliki atribut visibilitas eksplisit akan menjadi //visibility:public. Jika tanda ini bernilai benar, config_setting mengikuti logika visibilitas yang sama seperti semua aturan lainnya. Lihat https://github.com/bazelbuild/bazel/issues/12933.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_depset_for_java_output_source_jars
default: "true"-
Tanpa pengoperasian.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
default: "true"-
Jika true, terapkan batasan visibilitas config_setting. Jika false, setiap config_setting terlihat oleh setiap target. Lihat https://github.com/bazelbuild/bazel/issues/12932.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]separate_aspect_deps
default: "true"-
Tanpa pengoperasian
Tag:no_op
- Opsi yang berkaitan dengan output dan semantik subperintah `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>
default: "<root>"-
Tentukan modul yang relatif terhadap tempat repositori target yang ditentukan akan diinterpretasikan.
Tag:terminal_output
--charset=<utf8 or ascii>
default: "utf8"-
Memilih himpunan karakter yang akan digunakan untuk hierarki. Hanya memengaruhi output teks. Nilai yang valid adalah "utf8" atau "ascii". Default-nya adalah "utf8"
Tag:terminal_output
--[no]cycles
default: "salah"-
Menunjukkan siklus dependensi di dalam hierarki yang ditampilkan, yang biasanya diabaikan secara default.
Tag:terminal_output
- Default
--depth=<an integer>
: "-1" -
Kedalaman tampilan maksimum hierarki dependensi. Misalnya, kedalaman 1 menampilkan dependensi langsung. Untuk tree, path, dan all_paths, defaultnya adalah Integer.MAX_VALUE, sedangkan untuk dependensi dan penjelasannya, defaultnya adalah 1 (hanya menampilkan dependensi langsung dari root selain daun target dan induknya).
Tag:terminal_output
--extension_filter=<a comma-separated list of <extension>s>
default: lihat deskripsi-
Hanya tampilkan penggunaan ekstensi modul ini dan repo yang dihasilkan oleh ekstensi tersebut jika masing-masing flag telah ditetapkan. Jika ditetapkan, grafik hasil hanya akan menyertakan jalur yang berisi modul yang menggunakan ekstensi yang ditentukan. Daftar kosong menonaktifkan filter, yang menentukan semua kemungkinan ekstensi secara efektif.
Tag:terminal_output
--extension_info=<hidden, usages, repos or all>
default: "tersembunyi"-
Tentukan seberapa detail tentang penggunaan ekstensi yang akan disertakan dalam hasil kueri. "Usages" hanya akan menampilkan nama ekstensi, "repos" juga akan menyertakan repositori yang diimpor dengan use_repo, dan "all" juga akan menampilkan repositori lain yang dibuat oleh ekstensi.
Tag:terminal_output
--extension_usages=<a comma-separated list of <module>s>
default: ""-
Menentukan modul yang penggunaan ekstensinya akan ditampilkan di kueri show_extension.
Tag:terminal_output
--from=<a comma-separated list of <module>s>
default: "<root>"-
Modul yang mulai digunakan untuk menampilkan kueri grafik dependensi. Periksa setiap deskripsi kueri untuk mengetahui semantik yang tepat. Default-nya adalah <root>.
Tag:terminal_output
--[no]include_builtin
default: "salah"-
Menyertakan modul bawaan dalam grafik dependensi. Dinonaktifkan secara default karena berisik.
Tag:terminal_output
--[no]include_unused
default: "salah"-
Kueri juga akan mempertimbangkan dan menampilkan modul yang tidak digunakan, yang tidak ada dalam grafik resolusi modul setelah pemilihan (karena adanya Pemilihan Versi Minimal atau aturan penggantian). Hal ini dapat memiliki efek yang berbeda untuk setiap jenis kueri, yaitu menyertakan jalur baru dalam perintah all_paths , atau dependensi tambahan dalam perintah explain.
Tag:terminal_output
--output=<text, json or graph>
default: "text"-
Format yang digunakan untuk mencetak hasil kueri. Nilai yang diizinkan untuk kueri adalah: teks, json, grafik
Tag:terminal_output
--[no]verbose
default: "salah"-
Kueri juga akan menampilkan alasan modul diselesaikan ke versi saat ini (jika diubah). Nilai defaultnya adalah benar (true) hanya untuk kueri penjelasan.
Tag:terminal_output
- Opsi yang berkaitan dengan semantik dan output Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan yanked di registry tempatnya berasal (jika bukan berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yanked yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Periksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan jika ketidakcocokan terdeteksi.
Tag:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
default: "peringatan"-
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan dalam modul root adalah versi yang sama dengan yang Anda dapatkan dalam grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasikannya ke kegagalan resolusi.
Tag:loading_and_analysis
--[no]ignore_dev_dependency
default: "salah"-
Jika true (benar), Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan dalam MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "update"-
Menentukan bagaimana dan apakah menggunakan lockfile atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `error` untuk menggunakan lockfile tetapi menampilkan error jika file tidak diperbarui, atau `off` tidak membaca atau menulis ke lockfile.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <module name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan merupakan jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
--vendor_dir=<a path>
default: lihat deskripsi-
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat membangun. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "1 dtk:2,20 dtk:3,1 m:5" -
Batas yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlah berupa bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap generasi lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan dengan koma.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi ketika peristiwa GC penuh terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC kecil terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi saat peristiwa GC kecil terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan setidaknya berada pada ambang batas ini, status Skyframe sementara yang tidak perlu akan hilang. Menyesuaikan hal ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari GC thrashing, jika GC thrashing (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada menyusun ulang status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
--experimental_command_profile=<cpu, wall, alloc or lock>
default: lihat deskripsi- Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alokasi, atau kunci) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa di bawah direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; penggunaan dengan risiko Anda sendiri.
--[no]experimental_record_metrics_for_all_mnemonics
default: "salah"- Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika ada file yang telah diselesaikan yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi caching dan eksekusi jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file yang akan digunakan untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk cocok, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik mulai dari `$1`. Beberapa perintah `tulis ulang` untuk URL yang sama dapat diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
default: "otomatis"- Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dimulai ulang. Jika tidak, gunakan thread platform (yaitu thread OS) jika ditetapkan ke 'platform' atau thread virtual jika ditetapkan ke 'virtual'. Jika disetel ke 'auto', thread virtual akan digunakan jika tersedia (yaitu, berjalan di JDK 21+), jika tidak, thread pekerja tidak akan digunakan.
- Opsi lain, yang tidak dikategorikan.:
--deleted_packages=<comma-separated list of package names>
beberapa penggunaan diakumulasikan- Daftar nama paket yang dipisahkan koma yang akan dianggap tidak ada oleh sistem build, meskipun jika paket tersebut terlihat di suatu tempat pada jalur paket. Gunakan opsi ini ketika menghapus sub-paket 'x/y' dari paket 'x' yang ada. Misalnya, setelah menghapus x/y/BUILD di klien Anda, sistem build mungkin akan mengeluh jika menemukan label '//x:y/z' jika label tersebut masih disediakan oleh entri package_path lain. Menentukan --deleted_packages x/y akan menghindari masalah ini.
--[no]fetch
default: "true"- Mengizinkan perintah untuk mengambil dependensi eksternal. Jika disetel ke salah (false), perintah akan menggunakan versi dependensi yang di-cache, dan jika tidak ada, perintah tersebut akan gagal.
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <repositori name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--package_path=<colon-separated list of options>
default: "%workspace%"- Daftar yang dipisahkan titik dua berisi tempat mencari paket. Elemen yang dimulai dengan '%workspace%' akan relatif terhadap ruang kerja yang dicakup. Jika dihilangkan atau kosong, defaultnya adalah output 'bazel info default-package-path'.
--[no]show_loading_progress
default: "true"- Jika diaktifkan, akan menyebabkan Bazel mencetak pesan "Memuat paket:".
Opsi Print_action
Mewarisi semua opsi dari build.
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
default: "salah"-
Jika ditetapkan, cache repositori akan menerapkan hardlink pada file jika cache ditemukan, bukan menyalinnya. Hal ini dimaksudkan untuk menghemat kapasitas {i>disk<i}.
Tag:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
default: "0"-
Jumlah upaya maksimum untuk mencoba kembali error download. Jika ditetapkan ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark berdasarkan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi pada komputer yang lebih lambat dari yang diharapkan oleh pembuat aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_connector_attempts=<an integer>
: "8" -
Jumlah upaya maksimum untuk download http.
Tag:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
default: "0s"-
Waktu tunggu maksimum untuk percobaan ulang download http. Dengan nilai 0, tidak ada waktu tunggu maksimum yang ditentukan.
Tag:bazel_internal_configuration
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Skalakan semua waktu tunggu yang terkait dengan download http berdasarkan faktor yang diberikan
Tag:bazel_internal_configuration
--repository_cache=<a path>
default: lihat deskripsi-
Menentukan lokasi cache dari nilai yang didownload yang diperoleh selama pengambilan repositori eksternal. String kosong sebagai argumen meminta cache dinonaktifkan. Jika tidak, default '<output_user_root>/cache/repos/v1' akan digunakan
Tag:bazel_internal_configuration
--[no]repository_disable_download
default: "salah"-
Jika ditetapkan, mendownload menggunakan ctx.download{,_and_extract} tidak akan diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file arbitrer yang dapat dieksekusi yang mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang yang ditempati (0-100) dan di atas batas tersebut, GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika ditetapkan ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_depset_for_java_output_source_jars
default: "true"-
Tanpa pengoperasian.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]separate_aspect_deps
default: "true"-
Tanpa pengoperasian
Tag:no_op
- Opsi yang berkaitan dengan semantik dan output Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan yanked di registry tempatnya berasal (jika bukan berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yanked yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Periksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan jika ketidakcocokan terdeteksi.
Tag:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
default: "peringatan"-
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan dalam modul root adalah versi yang sama dengan yang Anda dapatkan dalam grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasikannya ke kegagalan resolusi.
Tag:loading_and_analysis
--[no]ignore_dev_dependency
default: "salah"-
Jika true (benar), Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan dalam MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "update"-
Menentukan bagaimana dan apakah menggunakan lockfile atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `error` untuk menggunakan lockfile tetapi menampilkan error jika file tidak diperbarui, atau `off` tidak membaca atau menulis ke lockfile.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <module name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan merupakan jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
--vendor_dir=<a path>
default: lihat deskripsi-
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat membangun. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "1 dtk:2,20 dtk:3,1 m:5" -
Batas yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlah berupa bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap generasi lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan dengan koma.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi ketika peristiwa GC penuh terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC kecil terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi saat peristiwa GC kecil terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan setidaknya berada pada ambang batas ini, status Skyframe sementara yang tidak perlu akan hilang. Menyesuaikan hal ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari GC thrashing, jika GC thrashing (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada menyusun ulang status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
--experimental_command_profile=<cpu, wall, alloc or lock>
default: lihat deskripsi- Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alokasi, atau kunci) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa di bawah direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; penggunaan dengan risiko Anda sendiri.
--[no]experimental_record_metrics_for_all_mnemonics
default: "salah"- Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika ada file yang telah diselesaikan yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi caching dan eksekusi jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file yang akan digunakan untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk cocok, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik mulai dari `$1`. Beberapa perintah `tulis ulang` untuk URL yang sama dapat diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
default: "otomatis"- Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dimulai ulang. Jika tidak, gunakan thread platform (yaitu thread OS) jika ditetapkan ke 'platform' atau thread virtual jika ditetapkan ke 'virtual'. Jika disetel ke 'auto', thread virtual akan digunakan jika tersedia (yaitu, berjalan di JDK 21+), jika tidak, thread pekerja tidak akan digunakan.
- Opsi lain, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <repositori name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--print_action_mnemonics=<a string>
beberapa penggunaan diakumulasikan- Mencantumkan mnemonik untuk memfilter data print_action, tidak ada pemfilteran yang dilakukan jika dibiarkan kosong.
Opsi Kueri
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
default: "salah"-
Jika ditetapkan, cache repositori akan menerapkan hardlink pada file jika cache ditemukan, bukan menyalinnya. Hal ini dimaksudkan untuk menghemat kapasitas {i>disk<i}.
Tag:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
default: "0"-
Jumlah upaya maksimum untuk mencoba kembali error download. Jika ditetapkan ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark berdasarkan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi pada komputer yang lebih lambat dari yang diharapkan oleh pembuat aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_connector_attempts=<an integer>
: "8" -
Jumlah upaya maksimum untuk download http.
Tag:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
default: "0s"-
Waktu tunggu maksimum untuk percobaan ulang download http. Dengan nilai 0, tidak ada waktu tunggu maksimum yang ditentukan.
Tag:bazel_internal_configuration
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Skalakan semua waktu tunggu yang terkait dengan download http berdasarkan faktor yang diberikan
Tag:bazel_internal_configuration
--repository_cache=<a path>
default: lihat deskripsi-
Menentukan lokasi cache dari nilai yang didownload yang diperoleh selama pengambilan repositori eksternal. String kosong sebagai argumen meminta cache dinonaktifkan. Jika tidak, default '<output_user_root>/cache/repos/v1' akan digunakan
Tag:bazel_internal_configuration
--[no]repository_disable_download
default: "salah"-
Jika ditetapkan, mendownload menggunakan ctx.download{,_and_extract} tidak akan diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file arbitrer yang dapat dieksekusi yang mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang yang ditempati (0-100) dan di atas batas tersebut, GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika ditetapkan ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
--[no]keep_going
[-k
] default: "salah"-
Lanjutkan sebanyak mungkin setelah error. Meskipun target yang gagal dan yang bergantung pada target tersebut tidak dapat dianalisis, prasyarat lain dari target tersebut dapat berupa.
Tag: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">
default: "otomatis"-
Jumlah thread paralel yang digunakan untuk fase pemuatan/analisis. Mengambil bilangan bulat, atau kata kunci ("otomatis", "HOST_CPUS", "HOST_RAM"), dapat diikuti dengan operasi ([-|*]<float>) misalnya, "otomatis", "HOST_CPUS*.5". "{i>auto" <i}menetapkan {i>default<i} yang wajar
berdasarkan sumber daya {i>host<i}. Minimal harus 1.
Tag:bazel_internal_configuration
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
default: "salah"-
Jika incompatible_enforce_config_setting_visi=false, berarti noop. Selain itu, jika tanda ini bernilai salah, config_setting apa pun yang tidak memiliki atribut visibilitas eksplisit akan menjadi //visibility:public. Jika tanda ini bernilai benar, config_setting mengikuti logika visibilitas yang sama seperti semua aturan lainnya. Lihat https://github.com/bazelbuild/bazel/issues/12933.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_depset_for_java_output_source_jars
default: "true"-
Tanpa pengoperasian.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
default: "true"-
Jika true, terapkan batasan visibilitas config_setting. Jika false, setiap config_setting terlihat oleh setiap target. Lihat https://github.com/bazelbuild/bazel/issues/12932.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]separate_aspect_deps
default: "true"-
Tanpa pengoperasian
Tag:no_op
- Opsi yang berkaitan dengan output kueri dan semantik:
--aspect_deps=<off, conservative or precise>
default: "konservatif"-
Cara me-resolve dependensi aspek jika format output adalah salah satu dari {xml,proto,record}. 'off' berarti tidak ada dependensi aspek yang diselesaikan, 'konservatif' (default) berarti semua dependensi aspek yang dideklarasikan akan ditambahkan terlepas dari apakah dependensi tersebut diberi class aturan dependensi langsung atau tidak, 'precise' berarti hanya aspek yang ditambahkan yang mungkin aktif berdasarkan class aturan dependensi langsung. Perhatikan bahwa mode presisi mengharuskan pemuatan paket lain untuk mengevaluasi satu target sehingga membuatnya lebih lambat daripada mode lainnya. Perhatikan juga bahwa mode yang tepat pun tidak sepenuhnya tepat: keputusan apakah akan menghitung suatu aspek ditentukan dalam fase analisis, yang tidak dijalankan selama 'kueri bazel'.
Tag:build_file_semantics
--[no]consistent_labels
default: "salah"-
Jika diaktifkan, setiap perintah kueri akan memunculkan label seolah-olah oleh fungsi <code>str</code> Starlark yang diterapkan ke instance <code>Label</code>. Hal ini berguna untuk alat yang perlu mencocokkan {i>output<i} dari berbagai perintah kueri dan/atau label yang dihasilkan oleh aturan. Jika tidak diaktifkan, pemformat output bebas memunculkan nama repositori yang jelas (relatif terhadap repositori utama) agar output lebih mudah dibaca.
Tag:terminal_output
--[no]experimental_explicit_aspects
default: "salah"-
kueri, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: tanpa pengoperasian (aspek selalu diikuti).
Tag:terminal_output
--[no]experimental_graphless_query
default: "otomatis"-
Jika true (benar), menggunakan implementasi Kueri yang tidak membuat salinan grafik. Implementasi baru hanya mendukung --order_output=no, serta hanya subset pemformat output.
Tag:build_file_semantics
,eagerness_to_exit
- Default
--graph:conditional_edges_limit=<an integer>
: "4" -
Jumlah maksimum label kondisi yang akan ditampilkan. -1 berarti tidak ada pemotongan dan 0 berarti tidak ada anotasi. Opsi ini hanya berlaku untuk --output=graph.
Tag:terminal_output
--[no]graph:factored
default: "true"-
Jika benar, grafik akan dimunculkan 'difaktorkan', yaitu node yang setara secara topologis akan digabungkan bersama dan labelnya akan digabungkan. Opsi ini hanya berlaku untuk --output=graph.
Tag:terminal_output
- Default
--graph:node_limit=<an integer>
: "512" -
Panjang maksimum string label untuk node grafik dalam output. Label yang lebih panjang akan dipotong; -1 berarti tidak ada pemotongan. Opsi ini hanya berlaku untuk --output=graph.
Tag:terminal_output
--[no]implicit_deps
default: "true"-
Jika diaktifkan, dependensi implisit akan disertakan dalam grafik dependensi tempat kueri dioperasikan. Dependensi implisit adalah dependensi yang tidak disebutkan secara eksplisit dalam file BUILD tetapi ditambahkan oleh bazel. Untuk cquery, opsi ini mengontrol pemfilteran toolchain yang di-resolve.
Tag:build_file_semantics
--[no]include_aspects
default: "true"-
kueri, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: tanpa pengoperasian (aspek selalu diikuti).
Tag:terminal_output
--[no]incompatible_lexicographical_output
default: "true"-
Jika opsi ini disetel, urutkan --order_output=auto output dalam urutan leksikografis.
Tag:terminal_output
,incompatible_change
--[no]incompatible_package_group_includes_double_slash
default: "true"-
Jika diaktifkan, saat menghasilkan output atribut `packages` package_group, `//` awal tidak akan dihilangkan.
Tag:terminal_output
,incompatible_change
--[no]infer_universe_scope
default: "salah"-
Jika ditetapkan dan --universe_scope tidak ditetapkan, nilai --universe_scope akan disimpulkan sebagai daftar pola target unik dalam ekspresi kueri. Perhatikan bahwa nilai --universe_scope yang disimpulkan untuk ekspresi kueri yang menggunakan fungsi cakupan alam semesta (misalnya `allrdeps`) mungkin bukan yang Anda inginkan, jadi sebaiknya gunakan opsi ini hanya jika Anda tahu apa yang Anda lakukan. Lihat https://bazel.build/reference/query#sky-query untuk mengetahui detail dan contohnya. Jika --universe_scope ditetapkan, nilai opsi ini akan diabaikan. Catatan: opsi ini hanya berlaku untuk `query` (bukan `cquery`).
Tag:loading_and_analysis
--[no]line_terminator_null
default: "salah"-
Apakah setiap format dihentikan dengan \0, bukan baris baru.
Tag:terminal_output
--[no]nodep_deps
default: "true"-
Jika diaktifkan, dependensi dari atribut "nodep" akan disertakan dalam grafik dependensi yang digunakan untuk mengoperasikan kueri. Contoh umum atribut "nodep" adalah "visibilitas". Jalankan dan uraikan output `info build-language` untuk mempelajari semua atribut "nodep" dalam bahasa build.
Tag:build_file_semantics
--noorder_results
-
Menampilkan hasil dalam mode yang diurutkan berdasarkan dependensi (default) atau tidak berurutan. Output yang tidak diurutkan akan lebih cepat, tetapi hanya didukung jika --output bukan minrank, maxrank, atau graph.
Diluaskan ke:
--order_output=no
Tag:terminal_output
--null
-
Apakah setiap format dihentikan dengan \0, bukan baris baru.
Diluaskan ke:
--line_terminator_null=true
Tag:terminal_output
--order_output=<no, deps, auto or full>
default: "otomatis"-
Menampilkan hasil yang tidak diurutkan (tidak), diurutkan berdasarkan dependensi (dependensi), atau diurutkan sepenuhnya (lengkap). Defaultnya adalah 'auto', artinya hasilnya adalah output yang diurutkan berdasarkan dependensi atau diurutkan sepenuhnya, bergantung pada pemformat output (urutan dependensi untuk proto, minrank, maxrank, dan grafik, diurutkan sepenuhnya untuk semua yang lain). Jika output diurutkan sepenuhnya, node akan dicetak dalam urutan deterministik (total) sepenuhnya. Pertama, semua node diurutkan menurut abjad. Kemudian, setiap node dalam daftar digunakan sebagai awal penelusuran depth-first pasca-urutan, di mana tepi keluar ke node yang tidak dikunjungi akan dilalui sesuai urutan abjad dari node pengganti. Akhirnya, node dicetak kebalikan dari urutan kunjungannya.
Tag:terminal_output
--order_results
-
Menampilkan hasil dalam mode yang diurutkan berdasarkan dependensi (default) atau tidak berurutan. Output yang tidak diurutkan akan lebih cepat, tetapi hanya didukung jika --output bukan minrank, maxrank, atau graph.
Diluaskan ke:
--order_output=auto
Tag:terminal_output
--output=<a string>
default: "label"-
Format yang digunakan untuk mencetak hasil kueri. Nilai yang diizinkan untuk kueri adalah: build, graph, streaming_jsonproto, label, label_types, location, maxrank, minrank, package, proto, stream_proto, xml.
Tag:terminal_output
--[no]proto:default_values
default: "true"-
Jika true (benar), atribut yang nilainya tidak ditentukan secara eksplisit dalam file BUILD akan disertakan; jika tidak, atribut tersebut akan dihilangkan. Opsi ini berlaku untuk --output=proto
Tag:terminal_output
--[no]proto:definition_stack
default: "salah"-
Isi kolom proto definisi_stack, yang mencatat setiap instance aturan stack panggilan Starlark pada saat class aturan ditentukan.
Tag:terminal_output
--[no]proto:flatten_selects
default: "true"-
Jika diaktifkan, atribut yang dapat dikonfigurasi yang dibuat oleh select() akan diratakan. Untuk jenis daftar, representasi yang disatukan adalah daftar yang berisi setiap nilai peta yang dipilih dengan tepat satu kali. Jenis skalar diratakan menjadi null.
Tag:build_file_semantics
--[no]proto:include_attribute_source_aspects
default: "salah"-
Isi kolom proto source_aspect_name dari setiap Atribut dengan aspek sumber tempat atribut tersebut berasal (string kosong jika bukan).
Tag:terminal_output
--[no]proto:include_synthetic_attribute_hash
default: "salah"-
Apakah akan menghitung dan mengisi atribut $internal_attr_hash atau tidak.
Tag:terminal_output
--[no]proto:instantiation_stack
default: "salah"-
Isi stack panggilan pembuatan instance dari setiap aturan. Perhatikan bahwa stack harus ada
Tag:terminal_output
--[no]proto:locations
default: "true"-
Apakah akan menghasilkan informasi lokasi dalam output proto atau tidak.
Tag:terminal_output
- Default
--proto:output_rule_attrs=<comma-separated list of options>
: "all" -
Daftar atribut yang dipisahkan koma untuk disertakan dalam output. Setelan defaultnya adalah semua atribut. Setel ke string kosong agar tidak menghasilkan output atribut apa pun. Opsi ini berlaku untuk --output=proto.
Tag:terminal_output
--[no]proto:rule_inputs_and_outputs
default: "true"-
Apakah kolom rule_input dan rule_output mengisi atau tidak.
Tag:terminal_output
--query_file=<a string>
default: ""-
Jika ditetapkan, kueri akan membaca kueri dari file yang disebutkan di sini, bukan dari command line. Menentukan file di sini serta kueri command line merupakan suatu error.
Tag:changes_inputs
--[no]relative_locations
default: "salah"-
Jika true (benar), lokasi file BUILD dalam output xml dan proto akan bersifat relatif. Secara default, output lokasi adalah jalur absolut dan tidak akan konsisten di seluruh mesin. Anda dapat menyetel opsi ini ke benar (true) agar mendapatkan hasil yang konsisten di seluruh mesin.
Tag:terminal_output
--[no]strict_test_suite
default: "salah"-
Jika benar, ekspresi tests() akan memberikan error jika menemukan test_suite yang berisi target non-pengujian.
Tag:build_file_semantics
,eagerness_to_exit
--[no]tool_deps
default: "true"-
Kueri: Jika dinonaktifkan, dependensi pada 'exec configuration' tidak akan disertakan dalam grafik dependensi tempat kueri dioperasikan. Edge dependensi 'exec configuration', seperti yang berasal dari aturan 'proto_library' apa pun ke Protocol Compiler, biasanya mengarah ke alat yang dieksekusi selama build, bukan bagian dari program 'target' yang sama.
Cquery: Jika dinonaktifkan, memfilter semua target yang dikonfigurasi yang melewati transisi eksekusi dari target tingkat teratas yang menemukan target yang dikonfigurasi ini. Artinya, jika target tingkat atas ada dalam konfigurasi target, hanya target yang dikonfigurasi dan dalam konfigurasi target yang akan ditampilkan. Jika target tingkat teratas berada dalam konfigurasi eksekusi, hanya target yang dikonfigurasi dengan eksekusi yang akan ditampilkan. Opsi ini TIDAK akan mengecualikan toolchain yang telah diselesaikan.
Tag:build_file_semantics
--universe_scope=<comma-separated list of options>
default: ""-
Kumpulan pola target yang dipisahkan koma (aditif dan pengurangan). Kueri dapat dilakukan di alam semesta yang ditentukan oleh penutupan transitif target yang ditentukan. Opsi ini digunakan untuk perintah kueri dan kueri.
Untuk cquery, input untuk opsi ini adalah target dari semua jawaban yang dibuat sehingga opsi ini dapat memengaruhi konfigurasi dan transisi. Jika opsi ini tidak ditentukan, target tingkat teratas dianggap sebagai target yang diuraikan dari ekspresi kueri. Catatan: Untuk cquery, tidak menentukan opsi ini dapat menyebabkan build rusak jika target yang diurai dari ekspresi kueri tidak dapat dibuat dengan opsi tingkat atas.
Tag:loading_and_analysis
--[no]xml:default_values
default: "salah"-
Jika true (benar), atribut aturan yang nilainya tidak ditentukan secara eksplisit dalam file BUILD akan dicetak; jika tidak, atribut tersebut akan dihilangkan.
Tag:terminal_output
--[no]xml:line_numbers
default: "true"-
Jika true (benar), output XML berisi nomor baris. Menonaktifkan opsi ini dapat membuat perbedaan lebih mudah dibaca. Opsi ini hanya berlaku untuk --output=xml.
Tag:terminal_output
- Opsi yang terkait dengan semantik dan output Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan yanked di registry tempatnya berasal (jika bukan berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yanked yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Periksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan jika ketidakcocokan terdeteksi.
Tag:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
default: "peringatan"-
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan dalam modul root adalah versi yang sama dengan yang Anda dapatkan dalam grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasikannya ke kegagalan resolusi.
Tag:loading_and_analysis
--[no]ignore_dev_dependency
default: "salah"-
Jika true (benar), Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan dalam MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "update"-
Menentukan bagaimana dan apakah menggunakan lockfile atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `error` untuk menggunakan lockfile tetapi menampilkan error jika file tidak diperbarui, atau `off` tidak membaca atau menulis ke lockfile.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <module name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan merupakan jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
--vendor_dir=<a path>
default: lihat deskripsi-
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat membangun. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "1 dtk:2,20 dtk:3,1 m:5" -
Batas yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlah berupa bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap generasi lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan dengan koma.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi ketika peristiwa GC penuh terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC kecil terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi saat peristiwa GC kecil terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan setidaknya berada pada ambang batas ini, status Skyframe sementara yang tidak perlu akan hilang. Menyesuaikan hal ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari GC thrashing, jika GC thrashing (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada menyusun ulang status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
--experimental_command_profile=<cpu, wall, alloc or lock>
default: lihat deskripsi- Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alokasi, atau kunci) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa di bawah direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; penggunaan dengan risiko Anda sendiri.
--[no]experimental_record_metrics_for_all_mnemonics
default: "salah"- Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
--experimental_repository_resolved_file=<a string>
default: ""-
Jika tidak kosong, tulis nilai Starlark dengan informasi yang telah diselesaikan dari semua aturan repositori Starlark yang dijalankan.
Tag:affects_outputs
- Opsi yang menentukan atau mengubah input umum ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika ada file yang telah diselesaikan yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi caching dan eksekusi jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file yang akan digunakan untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk cocok, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik mulai dari `$1`. Beberapa perintah `tulis ulang` untuk URL yang sama dapat diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
default: "otomatis"- Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dimulai ulang. Jika tidak, gunakan thread platform (yaitu thread OS) jika ditetapkan ke 'platform' atau thread virtual jika ditetapkan ke 'virtual'. Jika disetel ke 'auto', thread virtual akan digunakan jika tersedia (yaitu, berjalan di JDK 21+), jika tidak, thread pekerja tidak akan digunakan.
- Opsi lain, yang tidak dikategorikan.:
--deleted_packages=<comma-separated list of package names>
beberapa penggunaan diakumulasikan- Daftar nama paket yang dipisahkan koma yang akan dianggap tidak ada oleh sistem build, meskipun jika paket tersebut terlihat di suatu tempat pada jalur paket. Gunakan opsi ini ketika menghapus sub-paket 'x/y' dari paket 'x' yang ada. Misalnya, setelah menghapus x/y/BUILD di klien Anda, sistem build mungkin akan mengeluh jika menemukan label '//x:y/z' jika label tersebut masih disediakan oleh entri package_path lain. Menentukan --deleted_packages x/y akan menghindari masalah ini.
--[no]fetch
default: "true"- Mengizinkan perintah untuk mengambil dependensi eksternal. Jika disetel ke salah (false), perintah akan menggunakan versi dependensi yang di-cache, dan jika tidak ada, perintah tersebut akan gagal.
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <repositori name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--package_path=<colon-separated list of options>
default: "%workspace%"- Daftar yang dipisahkan titik dua berisi tempat mencari paket. Elemen yang dimulai dengan '%workspace%' akan relatif terhadap ruang kerja yang dicakup. Jika dihilangkan atau kosong, defaultnya adalah output 'bazel info default-package-path'.
--[no]show_loading_progress
default: "true"- Jika diaktifkan, akan menyebabkan Bazel mencetak pesan "Memuat paket:".
Jalankan Opsi
Mewarisi semua opsi dari build.
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
default: "salah"-
Jika ditetapkan, cache repositori akan menerapkan hardlink pada file jika cache ditemukan, bukan menyalinnya. Hal ini dimaksudkan untuk menghemat kapasitas {i>disk<i}.
Tag:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
default: "0"-
Jumlah upaya maksimum untuk mencoba kembali error download. Jika ditetapkan ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark berdasarkan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi pada komputer yang lebih lambat dari yang diharapkan oleh pembuat aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_connector_attempts=<an integer>
: "8" -
Jumlah upaya maksimum untuk download http.
Tag:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
default: "0s"-
Waktu tunggu maksimum untuk percobaan ulang download http. Dengan nilai 0, tidak ada waktu tunggu maksimum yang ditentukan.
Tag:bazel_internal_configuration
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Skalakan semua waktu tunggu yang terkait dengan download http berdasarkan faktor yang diberikan
Tag:bazel_internal_configuration
--[no]portable_paths
default: "salah"-
Jika true (benar), sertakan jalur yang akan diganti di ExecRequest agar jalur yang dihasilkan menjadi portabel.
Tag:affects_outputs
--repository_cache=<a path>
default: lihat deskripsi-
Menentukan lokasi cache dari nilai yang didownload yang diperoleh selama pengambilan repositori eksternal. String kosong sebagai argumen meminta cache dinonaktifkan. Jika tidak, default '<output_user_root>/cache/repos/v1' akan digunakan
Tag:bazel_internal_configuration
--[no]repository_disable_download
default: "salah"-
Jika ditetapkan, mendownload menggunakan ctx.download{,_and_extract} tidak akan diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file arbitrer yang dapat dieksekusi yang mengakses Internet.
Tag:bazel_internal_configuration
--[no]run
default: "true"-
Jika salah, lewati langkah untuk menjalankan command line yang dibuat untuk target yang telah dibuat. Perhatikan bahwa flag ini diabaikan untuk semua build --script_path.
Tag:affects_outputs
- Opsi yang mengontrol eksekusi build:
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang yang ditempati (0-100) dan di atas batas tersebut, GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika ditetapkan ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, yang memengaruhi nilainya, bukan keberadaannya:
--script_path=<a path>
default: lihat deskripsi-
Jika ditetapkan, tulis skrip shell ke file tertentu yang memanggil target. Jika opsi ini disetel, target tidak akan dijalankan dari bazel. Gunakan 'bazel run --script_path=foo //foo && ./foo' untuk memanggil target '//foo' Ini berbeda dengan 'bazel run //foo' karena kunci bazel dilepas dan file yang dapat dieksekusi terhubung ke stdin terminal.
Tag:affects_outputs
,execution
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_depset_for_java_output_source_jars
default: "true"-
Tanpa pengoperasian.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]separate_aspect_deps
default: "true"-
Tanpa pengoperasian
Tag:no_op
- Opsi yang berkaitan dengan semantik dan output Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan yanked di registry tempatnya berasal (jika bukan berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yanked yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Periksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan jika ketidakcocokan terdeteksi.
Tag:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
default: "peringatan"-
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan dalam modul root adalah versi yang sama dengan yang Anda dapatkan dalam grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasikannya ke kegagalan resolusi.
Tag:loading_and_analysis
--[no]ignore_dev_dependency
default: "salah"-
Jika true (benar), Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan dalam MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "update"-
Menentukan bagaimana dan apakah menggunakan lockfile atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `error` untuk menggunakan lockfile tetapi menampilkan error jika file tidak diperbarui, atau `off` tidak membaca atau menulis ke lockfile.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <module name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan merupakan jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
--vendor_dir=<a path>
default: lihat deskripsi-
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat membangun. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "1 dtk:2,20 dtk:3,1 m:5" -
Batas yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlah berupa bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap generasi lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan dengan koma.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi ketika peristiwa GC penuh terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC kecil terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi saat peristiwa GC kecil terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan setidaknya berada pada ambang batas ini, status Skyframe sementara yang tidak perlu akan hilang. Menyesuaikan hal ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari GC thrashing, jika GC thrashing (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada menyusun ulang status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
--experimental_command_profile=<cpu, wall, alloc or lock>
default: lihat deskripsi- Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alokasi, atau kunci) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa di bawah direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; penggunaan dengan risiko Anda sendiri.
--[no]experimental_record_metrics_for_all_mnemonics
default: "salah"- Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika ada file yang telah diselesaikan yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi caching dan eksekusi jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file yang akan digunakan untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk cocok, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik mulai dari `$1`. Beberapa perintah `tulis ulang` untuk URL yang sama dapat diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
default: "otomatis"- Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dimulai ulang. Jika tidak, gunakan thread platform (yaitu thread OS) jika ditetapkan ke 'platform' atau thread virtual jika ditetapkan ke 'virtual'. Jika disetel ke 'auto', thread virtual akan digunakan jika tersedia (yaitu, berjalan di JDK 21+), jika tidak, thread pekerja tidak akan digunakan.
- Opsi lain, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <repositori name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
Opsi Penonaktifan
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
default: "salah"-
Jika ditetapkan, cache repositori akan menerapkan hardlink pada file jika cache ditemukan, bukan menyalinnya. Hal ini dimaksudkan untuk menghemat kapasitas {i>disk<i}.
Tag:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
default: "0"-
Jumlah upaya maksimum untuk mencoba kembali error download. Jika ditetapkan ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark berdasarkan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi pada komputer yang lebih lambat dari yang diharapkan oleh pembuat aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_connector_attempts=<an integer>
: "8" -
Jumlah upaya maksimum untuk download http.
Tag:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
default: "0s"-
Waktu tunggu maksimum untuk percobaan ulang download http. Dengan nilai 0, tidak ada waktu tunggu maksimum yang ditentukan.
Tag:bazel_internal_configuration
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Skalakan semua waktu tunggu yang terkait dengan download http berdasarkan faktor yang diberikan
Tag:bazel_internal_configuration
--repository_cache=<a path>
default: lihat deskripsi-
Menentukan lokasi cache dari nilai yang didownload yang diperoleh selama pengambilan repositori eksternal. String kosong sebagai argumen meminta cache dinonaktifkan. Jika tidak, default '<output_user_root>/cache/repos/v1' akan digunakan
Tag:bazel_internal_configuration
--[no]repository_disable_download
default: "salah"-
Jika ditetapkan, mendownload menggunakan ctx.download{,_and_extract} tidak akan diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file arbitrer yang dapat dieksekusi yang mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang yang ditempati (0-100) dan di atas batas tersebut, GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika ditetapkan ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi yang mengontrol output perintah:
--iff_heap_size_greater_than=<an integer>
default: "0"-
Jika bukan nol, penonaktifan hanya akan mematikan server jika total memori (dalam MB) yang digunakan oleh JVM melebihi nilai ini.
Tag:loses_incremental_state
,eagerness_to_exit
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_depset_for_java_output_source_jars
default: "true"-
Tanpa pengoperasian.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]separate_aspect_deps
default: "true"-
Tanpa pengoperasian
Tag:no_op
- Opsi yang berkaitan dengan semantik dan output Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan yanked di registry tempatnya berasal (jika bukan berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yanked yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Periksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan jika ketidakcocokan terdeteksi.
Tag:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
default: "peringatan"-
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan dalam modul root adalah versi yang sama dengan yang Anda dapatkan dalam grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasikannya ke kegagalan resolusi.
Tag:loading_and_analysis
--[no]ignore_dev_dependency
default: "salah"-
Jika true (benar), Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan dalam MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "update"-
Menentukan bagaimana dan apakah menggunakan lockfile atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `error` untuk menggunakan lockfile tetapi menampilkan error jika file tidak diperbarui, atau `off` tidak membaca atau menulis ke lockfile.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <module name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan merupakan jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
--vendor_dir=<a path>
default: lihat deskripsi-
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat membangun. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "1 dtk:2,20 dtk:3,1 m:5" -
Batas yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlah berupa bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap generasi lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan dengan koma.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi ketika peristiwa GC penuh terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC kecil terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi saat peristiwa GC kecil terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan setidaknya berada pada ambang batas ini, status Skyframe sementara yang tidak perlu akan hilang. Menyesuaikan hal ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari GC thrashing, jika GC thrashing (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada menyusun ulang status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
--experimental_command_profile=<cpu, wall, alloc or lock>
default: lihat deskripsi- Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alokasi, atau kunci) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa di bawah direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; penggunaan dengan risiko Anda sendiri.
--[no]experimental_record_metrics_for_all_mnemonics
default: "salah"- Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika ada file yang telah diselesaikan yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi caching dan eksekusi jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file yang akan digunakan untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk cocok, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik mulai dari `$1`. Beberapa perintah `tulis ulang` untuk URL yang sama dapat diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
default: "otomatis"- Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dimulai ulang. Jika tidak, gunakan thread platform (yaitu thread OS) jika ditetapkan ke 'platform' atau thread virtual jika ditetapkan ke 'virtual'. Jika disetel ke 'auto', thread virtual akan digunakan jika tersedia (yaitu, berjalan di JDK 21+), jika tidak, thread pekerja tidak akan digunakan.
- Opsi lain, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <repositori name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
Opsi Sinkronisasi
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
default: "salah"-
Jika ditetapkan, cache repositori akan menerapkan hardlink pada file jika cache ditemukan, bukan menyalinnya. Hal ini dimaksudkan untuk menghemat kapasitas {i>disk<i}.
Tag:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
default: "0"-
Jumlah upaya maksimum untuk mencoba kembali error download. Jika ditetapkan ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark berdasarkan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi pada komputer yang lebih lambat dari yang diharapkan oleh pembuat aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_connector_attempts=<an integer>
: "8" -
Jumlah upaya maksimum untuk download http.
Tag:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
default: "0s"-
Waktu tunggu maksimum untuk percobaan ulang download http. Dengan nilai 0, tidak ada waktu tunggu maksimum yang ditentukan.
Tag:bazel_internal_configuration
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Skalakan semua waktu tunggu yang terkait dengan download http berdasarkan faktor yang diberikan
Tag:bazel_internal_configuration
--repository_cache=<a path>
default: lihat deskripsi-
Menentukan lokasi cache dari nilai yang didownload yang diperoleh selama pengambilan repositori eksternal. String kosong sebagai argumen meminta cache dinonaktifkan. Jika tidak, default '<output_user_root>/cache/repos/v1' akan digunakan
Tag:bazel_internal_configuration
--[no]repository_disable_download
default: "salah"-
Jika ditetapkan, mendownload menggunakan ctx.download{,_and_extract} tidak akan diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file arbitrer yang dapat dieksekusi yang mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
--[no]configure
default: "Salah"-
Hanya menyinkronkan repositori yang ditandai sebagai 'konfigurasi' untuk tujuan konfigurasi sistem.
Tag:changes_inputs
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang yang ditempati (0-100) dan di atas batas tersebut, GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika ditetapkan ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
--[no]keep_going
[-k
] default: "salah"-
Lanjutkan sebanyak mungkin setelah error. Meskipun target yang gagal dan yang bergantung pada target tersebut tidak dapat dianalisis, prasyarat lain dari target tersebut dapat berupa.
Tag: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">
default: "otomatis"-
Jumlah thread paralel yang digunakan untuk fase pemuatan/analisis. Mengambil bilangan bulat, atau kata kunci ("otomatis", "HOST_CPUS", "HOST_RAM"), dapat diikuti dengan operasi ([-|*]<float>) misalnya, "otomatis", "HOST_CPUS*.5". "{i>auto" <i}menetapkan {i>default<i} yang wajar
berdasarkan sumber daya {i>host<i}. Minimal harus 1.
Tag:bazel_internal_configuration
--only=<a string>
beberapa penggunaan diakumulasikan-
Jika opsi ini diberikan, hanya sinkronkan repositori yang ditentukan dengan opsi ini. Tetap menganggap semua (atau semua konfigurasi yang mirip, dari --configure diberikan) usang.
Tag:changes_inputs
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
default: "salah"-
Jika incompatible_enforce_config_setting_visi=false, berarti noop. Selain itu, jika tanda ini bernilai salah, config_setting apa pun yang tidak memiliki atribut visibilitas eksplisit akan menjadi //visibility:public. Jika tanda ini bernilai benar, config_setting mengikuti logika visibilitas yang sama seperti semua aturan lainnya. Lihat https://github.com/bazelbuild/bazel/issues/12933.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_depset_for_java_output_source_jars
default: "true"-
Tanpa pengoperasian.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
default: "true"-
Jika true, terapkan batasan visibilitas config_setting. Jika false, setiap config_setting terlihat oleh setiap target. Lihat https://github.com/bazelbuild/bazel/issues/12932.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]separate_aspect_deps
default: "true"-
Tanpa pengoperasian
Tag:no_op
- Opsi yang berkaitan dengan semantik dan output Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan yanked di registry tempatnya berasal (jika bukan berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yanked yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Periksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan jika ketidakcocokan terdeteksi.
Tag:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
default: "peringatan"-
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan dalam modul root adalah versi yang sama dengan yang Anda dapatkan dalam grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasikannya ke kegagalan resolusi.
Tag:loading_and_analysis
--[no]ignore_dev_dependency
default: "salah"-
Jika true (benar), Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan dalam MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "update"-
Menentukan bagaimana dan apakah menggunakan lockfile atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `error` untuk menggunakan lockfile tetapi menampilkan error jika file tidak diperbarui, atau `off` tidak membaca atau menulis ke lockfile.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <module name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan merupakan jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
--vendor_dir=<a path>
default: lihat deskripsi-
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat membangun. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "1 dtk:2,20 dtk:3,1 m:5" -
Batas yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlah berupa bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap generasi lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan dengan koma.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi ketika peristiwa GC penuh terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC kecil terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi saat peristiwa GC kecil terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan setidaknya berada pada ambang batas ini, status Skyframe sementara yang tidak perlu akan hilang. Menyesuaikan hal ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari GC thrashing, jika GC thrashing (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada menyusun ulang status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
--experimental_command_profile=<cpu, wall, alloc or lock>
default: lihat deskripsi- Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alokasi, atau kunci) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa di bawah direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; penggunaan dengan risiko Anda sendiri.
--[no]experimental_record_metrics_for_all_mnemonics
default: "salah"- Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
--experimental_repository_resolved_file=<a string>
default: ""-
Jika tidak kosong, tulis nilai Starlark dengan informasi yang telah diselesaikan dari semua aturan repositori Starlark yang dijalankan.
Tag:affects_outputs
- Opsi yang menentukan atau mengubah input umum ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika ada file yang telah diselesaikan yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi caching dan eksekusi jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file yang akan digunakan untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk cocok, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik mulai dari `$1`. Beberapa perintah `tulis ulang` untuk URL yang sama dapat diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
default: "otomatis"- Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dimulai ulang. Jika tidak, gunakan thread platform (yaitu thread OS) jika ditetapkan ke 'platform' atau thread virtual jika ditetapkan ke 'virtual'. Jika disetel ke 'auto', thread virtual akan digunakan jika tersedia (yaitu, berjalan di JDK 21+), jika tidak, thread pekerja tidak akan digunakan.
- Opsi lain, yang tidak dikategorikan.:
--deleted_packages=<comma-separated list of package names>
beberapa penggunaan diakumulasikan- Daftar nama paket yang dipisahkan koma yang akan dianggap tidak ada oleh sistem build, meskipun jika paket tersebut terlihat di suatu tempat pada jalur paket. Gunakan opsi ini ketika menghapus sub-paket 'x/y' dari paket 'x' yang ada. Misalnya, setelah menghapus x/y/BUILD di klien Anda, sistem build mungkin akan mengeluh jika menemukan label '//x:y/z' jika label tersebut masih disediakan oleh entri package_path lain. Menentukan --deleted_packages x/y akan menghindari masalah ini.
--[no]fetch
default: "true"- Mengizinkan perintah untuk mengambil dependensi eksternal. Jika disetel ke salah (false), perintah akan menggunakan versi dependensi yang di-cache, dan jika tidak ada, perintah tersebut akan gagal.
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <repositori name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--package_path=<colon-separated list of options>
default: "%workspace%"- Daftar yang dipisahkan titik dua berisi tempat mencari paket. Elemen yang dimulai dengan '%workspace%' akan relatif terhadap ruang kerja yang dicakup. Jika dihilangkan atau kosong, defaultnya adalah output 'bazel info default-package-path'.
--[no]show_loading_progress
default: "true"- Jika diaktifkan, akan menyebabkan Bazel mencetak pesan "Memuat paket:".
Opsi Pengujian
Mewarisi semua opsi dari build.
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
default: "salah"-
Jika ditetapkan, cache repositori akan menerapkan hardlink pada file jika cache ditemukan, bukan menyalinnya. Hal ini dimaksudkan untuk menghemat kapasitas {i>disk<i}.
Tag:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
default: "0"-
Jumlah upaya maksimum untuk mencoba kembali error download. Jika ditetapkan ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark berdasarkan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi pada komputer yang lebih lambat dari yang diharapkan oleh pembuat aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_connector_attempts=<an integer>
: "8" -
Jumlah upaya maksimum untuk download http.
Tag:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
default: "0s"-
Waktu tunggu maksimum untuk percobaan ulang download http. Dengan nilai 0, tidak ada waktu tunggu maksimum yang ditentukan.
Tag:bazel_internal_configuration
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Skalakan semua waktu tunggu yang terkait dengan download http berdasarkan faktor yang diberikan
Tag:bazel_internal_configuration
--repository_cache=<a path>
default: lihat deskripsi-
Menentukan lokasi cache dari nilai yang didownload yang diperoleh selama pengambilan repositori eksternal. String kosong sebagai argumen meminta cache dinonaktifkan. Jika tidak, default '<output_user_root>/cache/repos/v1' akan digunakan
Tag:bazel_internal_configuration
--[no]repository_disable_download
default: "salah"-
Jika ditetapkan, mendownload menggunakan ctx.download{,_and_extract} tidak akan diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file arbitrer yang dapat dieksekusi yang mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang yang ditempati (0-100) dan di atas batas tersebut, GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika ditetapkan ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_depset_for_java_output_source_jars
default: "true"-
Tanpa pengoperasian.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]separate_aspect_deps
default: "true"-
Tanpa pengoperasian
Tag:no_op
- Opsi yang berkaitan dengan semantik dan output Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan yanked di registry tempatnya berasal (jika bukan berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yanked yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Periksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan jika ketidakcocokan terdeteksi.
Tag:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
default: "peringatan"-
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan dalam modul root adalah versi yang sama dengan yang Anda dapatkan dalam grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasikannya ke kegagalan resolusi.
Tag:loading_and_analysis
--[no]ignore_dev_dependency
default: "salah"-
Jika true (benar), Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan dalam MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "update"-
Menentukan bagaimana dan apakah menggunakan lockfile atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `error` untuk menggunakan lockfile tetapi menampilkan error jika file tidak diperbarui, atau `off` tidak membaca atau menulis ke lockfile.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <module name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan merupakan jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
--vendor_dir=<a path>
default: lihat deskripsi-
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat membangun. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "1 dtk:2,20 dtk:3,1 m:5" -
Batas yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlah berupa bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap generasi lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan dengan koma.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi ketika peristiwa GC penuh terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC kecil terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi saat peristiwa GC kecil terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan setidaknya berada pada ambang batas ini, status Skyframe sementara yang tidak perlu akan hilang. Menyesuaikan hal ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari GC thrashing, jika GC thrashing (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada menyusun ulang status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
--experimental_command_profile=<cpu, wall, alloc or lock>
default: lihat deskripsi- Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alokasi, atau kunci) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa di bawah direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; penggunaan dengan risiko Anda sendiri.
--[no]experimental_record_metrics_for_all_mnemonics
default: "salah"- Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
--[no]print_relative_test_log_paths
default: "salah"-
Jika true (benar), saat mencetak jalur ke log pengujian, gunakan jalur relatif yang memanfaatkan symlink praktis 'testlogs'. Catatan - Pemanggilan 'build'/'test'/etc berikutnya dengan konfigurasi berbeda dapat menyebabkan target symlink ini berubah, sehingga jalur yang dicetak sebelumnya tidak lagi berguna.
Tag:affects_outputs
--[no]test_verbose_timeout_warnings
default: "salah"-
Jika true, cetak peringatan tambahan saat waktu eksekusi uji yang sebenarnya tidak sesuai dengan waktu tunggu yang ditentukan oleh pengujian (baik tersirat maupun eksplisit).
Tag:affects_outputs
--[no]verbose_test_summary
default: "true"-
Jika benar, cetak informasi tambahan (waktu, jumlah operasi yang gagal, dll.) dalam ringkasan pengujian.
Tag:affects_outputs
- Opsi yang menentukan atau mengubah input umum ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika ada file yang telah diselesaikan yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi caching dan eksekusi jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file yang akan digunakan untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk cocok, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik mulai dari `$1`. Beberapa perintah `tulis ulang` untuk URL yang sama dapat diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
default: "otomatis"- Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dimulai ulang. Jika tidak, gunakan thread platform (yaitu thread OS) jika ditetapkan ke 'platform' atau thread virtual jika ditetapkan ke 'virtual'. Jika disetel ke 'auto', thread virtual akan digunakan jika tersedia (yaitu, berjalan di JDK 21+), jika tidak, thread pekerja tidak akan digunakan.
- Opsi lain, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <repositori name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
Opsi Vendor
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
default: "salah"-
Jika ditetapkan, cache repositori akan menerapkan hardlink pada file jika cache ditemukan, bukan menyalinnya. Hal ini dimaksudkan untuk menghemat kapasitas {i>disk<i}.
Tag:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
default: "0"-
Jumlah upaya maksimum untuk mencoba kembali error download. Jika ditetapkan ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark berdasarkan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi pada komputer yang lebih lambat dari yang diharapkan oleh pembuat aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_connector_attempts=<an integer>
: "8" -
Jumlah upaya maksimum untuk download http.
Tag:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
default: "0s"-
Waktu tunggu maksimum untuk percobaan ulang download http. Dengan nilai 0, tidak ada waktu tunggu maksimum yang ditentukan.
Tag:bazel_internal_configuration
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Skalakan semua waktu tunggu yang terkait dengan download http berdasarkan faktor yang diberikan
Tag:bazel_internal_configuration
--repository_cache=<a path>
default: lihat deskripsi-
Menentukan lokasi cache dari nilai yang didownload yang diperoleh selama pengambilan repositori eksternal. String kosong sebagai argumen meminta cache dinonaktifkan. Jika tidak, default '<output_user_root>/cache/repos/v1' akan digunakan
Tag:bazel_internal_configuration
--[no]repository_disable_download
default: "salah"-
Jika ditetapkan, mendownload menggunakan ctx.download{,_and_extract} tidak akan diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file arbitrer yang dapat dieksekusi yang mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang yang ditempati (0-100) dan di atas batas tersebut, GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika ditetapkan ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
--[no]keep_going
[-k
] default: "salah"-
Lanjutkan sebanyak mungkin setelah error. Meskipun target yang gagal dan yang bergantung pada target tersebut tidak dapat dianalisis, prasyarat lain dari target tersebut dapat berupa.
Tag: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">
default: "otomatis"-
Jumlah thread paralel yang digunakan untuk fase pemuatan/analisis. Mengambil bilangan bulat, atau kata kunci ("otomatis", "HOST_CPUS", "HOST_RAM"), dapat diikuti dengan operasi ([-|*]<float>) misalnya, "otomatis", "HOST_CPUS*.5". "{i>auto" <i}menetapkan {i>default<i} yang wajar
berdasarkan sumber daya {i>host<i}. Minimal harus 1.
Tag:bazel_internal_configuration
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility
default: "salah"-
Jika incompatible_enforce_config_setting_visi=false, berarti noop. Selain itu, jika tanda ini bernilai salah, config_setting apa pun yang tidak memiliki atribut visibilitas eksplisit akan menjadi //visibility:public. Jika tanda ini bernilai benar, config_setting mengikuti logika visibilitas yang sama seperti semua aturan lainnya. Lihat https://github.com/bazelbuild/bazel/issues/12933.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_depset_for_java_output_source_jars
default: "true"-
Tanpa pengoperasian.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
default: "true"-
Jika true, terapkan batasan visibilitas config_setting. Jika false, setiap config_setting terlihat oleh setiap target. Lihat https://github.com/bazelbuild/bazel/issues/12932.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]separate_aspect_deps
default: "true"-
Tanpa pengoperasian
Tag:no_op
- Opsi yang berkaitan dengan semantik dan output Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan yanked di registry tempatnya berasal (jika bukan berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yanked yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Periksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan jika ketidakcocokan terdeteksi.
Tag:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
default: "peringatan"-
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan dalam modul root adalah versi yang sama dengan yang Anda dapatkan dalam grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasikannya ke kegagalan resolusi.
Tag:loading_and_analysis
--[no]ignore_dev_dependency
default: "salah"-
Jika true (benar), Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan dalam MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "update"-
Menentukan bagaimana dan apakah menggunakan lockfile atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `error` untuk menggunakan lockfile tetapi menampilkan error jika file tidak diperbarui, atau `off` tidak membaca atau menulis ke lockfile.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <module name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan merupakan jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
--repo=<a string>
beberapa penggunaan diakumulasikan-
Hanya vendor yang memiliki repositori yang ditentukan, yang dapat berupa `@apparent_repo_name` atau `@@canonical_repo_name`. Opsi ini dapat ditetapkan beberapa kali
Tag:changes_inputs
--vendor_dir=<a path>
default: lihat deskripsi-
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat membangun. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "1 dtk:2,20 dtk:3,1 m:5" -
Batas yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlah berupa bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap generasi lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan dengan koma.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi ketika peristiwa GC penuh terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC kecil terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi saat peristiwa GC kecil terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan setidaknya berada pada ambang batas ini, status Skyframe sementara yang tidak perlu akan hilang. Menyesuaikan hal ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari GC thrashing, jika GC thrashing (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada menyusun ulang status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
--experimental_command_profile=<cpu, wall, alloc or lock>
default: lihat deskripsi- Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alokasi, atau kunci) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa di bawah direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; penggunaan dengan risiko Anda sendiri.
--[no]experimental_record_metrics_for_all_mnemonics
default: "salah"- Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika ada file yang telah diselesaikan yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi caching dan eksekusi jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file yang akan digunakan untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk cocok, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik mulai dari `$1`. Beberapa perintah `tulis ulang` untuk URL yang sama dapat diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
default: "otomatis"- Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dimulai ulang. Jika tidak, gunakan thread platform (yaitu thread OS) jika ditetapkan ke 'platform' atau thread virtual jika ditetapkan ke 'virtual'. Jika disetel ke 'auto', thread virtual akan digunakan jika tersedia (yaitu, berjalan di JDK 21+), jika tidak, thread pekerja tidak akan digunakan.
- Opsi lain, yang tidak dikategorikan.:
--deleted_packages=<comma-separated list of package names>
beberapa penggunaan diakumulasikan- Daftar nama paket yang dipisahkan koma yang akan dianggap tidak ada oleh sistem build, meskipun jika paket tersebut terlihat di suatu tempat pada jalur paket. Gunakan opsi ini ketika menghapus sub-paket 'x/y' dari paket 'x' yang ada. Misalnya, setelah menghapus x/y/BUILD di klien Anda, sistem build mungkin akan mengeluh jika menemukan label '//x:y/z' jika label tersebut masih disediakan oleh entri package_path lain. Menentukan --deleted_packages x/y akan menghindari masalah ini.
--[no]fetch
default: "true"- Mengizinkan perintah untuk mengambil dependensi eksternal. Jika disetel ke salah (false), perintah akan menggunakan versi dependensi yang di-cache, dan jika tidak ada, perintah tersebut akan gagal.
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <repositori name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--package_path=<colon-separated list of options>
default: "%workspace%"- Daftar yang dipisahkan titik dua berisi tempat mencari paket. Elemen yang dimulai dengan '%workspace%' akan relatif terhadap ruang kerja yang dicakup. Jika dihilangkan atau kosong, defaultnya adalah output 'bazel info default-package-path'.
--[no]show_loading_progress
default: "true"- Jika diaktifkan, akan menyebabkan Bazel mencetak pesan "Memuat paket:".
Opsi Versi
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
default: "salah"-
Jika ditetapkan, cache repositori akan menerapkan hardlink pada file jika cache ditemukan, bukan menyalinnya. Hal ini dimaksudkan untuk menghemat kapasitas {i>disk<i}.
Tag:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
default: "0"-
Jumlah upaya maksimum untuk mencoba kembali error download. Jika ditetapkan ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark berdasarkan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi pada komputer yang lebih lambat dari yang diharapkan oleh pembuat aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_connector_attempts=<an integer>
: "8" -
Jumlah upaya maksimum untuk download http.
Tag:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
default: "0s"-
Waktu tunggu maksimum untuk percobaan ulang download http. Dengan nilai 0, tidak ada waktu tunggu maksimum yang ditentukan.
Tag:bazel_internal_configuration
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Skalakan semua waktu tunggu yang terkait dengan download http berdasarkan faktor yang diberikan
Tag:bazel_internal_configuration
--repository_cache=<a path>
default: lihat deskripsi-
Menentukan lokasi cache dari nilai yang didownload yang diperoleh selama pengambilan repositori eksternal. String kosong sebagai argumen meminta cache dinonaktifkan. Jika tidak, default '<output_user_root>/cache/repos/v1' akan digunakan
Tag:bazel_internal_configuration
--[no]repository_disable_download
default: "salah"-
Jika ditetapkan, mendownload menggunakan ctx.download{,_and_extract} tidak akan diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file arbitrer yang dapat dieksekusi yang mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang yang ditempati (0-100) dan di atas batas tersebut, GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika ditetapkan ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, yang memengaruhi nilainya, bukan keberadaannya:
--[no]gnu_format
default: "salah"-
Jika ditetapkan, tulis versi ke stdout menggunakan konvensi yang dijelaskan dalam standar GNU.
Tag:affects_outputs
,execution
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_depset_for_java_output_source_jars
default: "true"-
Tanpa pengoperasian.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
default: "true"-
Tanpa pengoperasian
Tag:no_op
,incompatible_change
--[no]separate_aspect_deps
default: "true"-
Tanpa pengoperasian
Tag:no_op
- Opsi yang berkaitan dengan semantik dan output Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan yanked di registry tempatnya berasal (jika bukan berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yanked yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Periksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan jika ketidakcocokan terdeteksi.
Tag:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
default: "peringatan"-
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan dalam modul root adalah versi yang sama dengan yang Anda dapatkan dalam grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasikannya ke kegagalan resolusi.
Tag:loading_and_analysis
--[no]ignore_dev_dependency
default: "salah"-
Jika true (benar), Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan dalam MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "update"-
Menentukan bagaimana dan apakah menggunakan lockfile atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `error` untuk menggunakan lockfile tetapi menampilkan error jika file tidak diperbarui, atau `off` tidak membaca atau menulis ke lockfile.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <module name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan merupakan jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
--vendor_dir=<a path>
default: lihat deskripsi-
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat membangun. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
: "1 dtk:2,20 dtk:3,1 m:5" -
Batas yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlah berupa bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap generasi lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan dengan koma.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi ketika peristiwa GC penuh terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
: "2147483647" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan melebihi batas yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC kecil terjadi, status Skyframe sementara yang tidak perlu akan hilang, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas ini tercapai, status Skyframe tidak akan dihapus lagi saat peristiwa GC kecil terjadi dan batas persentase heap yang dipertahankan terlampaui.
Tag:host_machine_resource_optimizations
- Default
--skyframe_high_water_mark_threshold=<an integer>
: "85" -
Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi bahwa penggunaan persentase heap yang dipertahankan setidaknya berada pada ambang batas ini, status Skyframe sementara yang tidak perlu akan hilang. Menyesuaikan hal ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari GC thrashing, jika GC thrashing (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada menyusun ulang status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
--experimental_command_profile=<cpu, wall, alloc or lock>
default: lihat deskripsi- Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alokasi, atau kunci) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa di bawah direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; penggunaan dengan risiko Anda sendiri.
--[no]experimental_record_metrics_for_all_mnemonics
default: "salah"- Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika ada file yang telah diselesaikan yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi caching dan eksekusi jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file yang akan digunakan untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk cocok, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik mulai dari `$1`. Beberapa perintah `tulis ulang` untuk URL yang sama dapat diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
default: "otomatis"- Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dimulai ulang. Jika tidak, gunakan thread platform (yaitu thread OS) jika ditetapkan ke 'platform' atau thread virtual jika ditetapkan ke 'virtual'. Jika disetel ke 'auto', thread virtual akan digunakan jika tersedia (yaitu, berjalan di JDK 21+), jika tidak, thread pekerja tidak akan digunakan.
- Opsi lain, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <repositori name>=<path>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang ditentukan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root workspace, yang merupakan output dari `bazel info workspace`
Tag Efek Opsi
unknown |
Opsi ini memiliki efek yang tidak diketahui atau tidak terdokumentasi. |
no_op |
Opsi ini sama sekali tidak berpengaruh. |
loses_incremental_state |
Mengubah nilai opsi ini dapat menyebabkan hilangnya status inkremental secara signifikan, sehingga memperlambat build. Status dapat hilang karena server dimulai ulang atau pembatalan sebagian besar grafik dependensi. |
changes_inputs |
Opsi ini secara aktif mengubah input yang dipertimbangkan bazel untuk build, seperti pembatasan sistem file, versi repositori, atau opsi lainnya. |
affects_outputs |
Opsi ini memengaruhi output bazel. Tag ini sengaja dibuat luas, dapat menyertakan pengaruh transitif, dan tidak menentukan jenis output yang dipengaruhinya. |
build_file_semantics |
Opsi ini memengaruhi semantik file BUILD atau .bzl. |
bazel_internal_configuration |
Opsi ini memengaruhi setelan mesin internal bazel. Tag ini tidak dengan sendirinya berarti bahwa artefak build akan terpengaruh. |
loading_and_analysis |
Opsi ini memengaruhi pemuatan dan analisis dependensi, serta pembuatan grafik dependensi. |
execution |
Opsi ini memengaruhi fase eksekusi, seperti opsi yang terkait dengan sandbox atau eksekusi jarak jauh. |
host_machine_resource_optimizations |
Opsi ini memicu pengoptimalan yang mungkin spesifik per mesin dan tidak dijamin akan berfungsi di semua komputer. Pengoptimalan dapat mencakup kompromi dengan aspek performa lainnya, seperti biaya memori atau CPU. |
eagerness_to_exit |
Opsi ini mengubah seberapa cepat bazel akan keluar dari suatu kegagalan, dengan pilihan antara melanjutkan meskipun terjadi kegagalan dan mengakhiri pemanggilan. |
bazel_monitoring |
Opsi ini digunakan untuk memantau perilaku dan performa Bagas. |
terminal_output |
Opsi ini memengaruhi output terminal bazel. |
action_command_lines |
Opsi ini mengubah argumen command line dari satu atau beberapa tindakan build. |
test_runner |
Opsi ini mengubah lingkungan testrunner pada build. |
Tag Metadata Opsi
experimental |
Opsi ini memicu fitur eksperimental tanpa jaminan fungsinya. |
incompatible_change |
Opsi ini memicu perubahan yang dapat menyebabkan gangguan. Gunakan opsi ini untuk menguji kesiapan migrasi Anda atau mendapatkan akses awal ke fitur baru |
deprecated |
Opsi ini tidak digunakan lagi. Mungkin fitur yang terpengaruh sudah tidak digunakan lagi, atau ada metode lain untuk memberikan informasi lebih disukai. |
immutable |
Opsi ini tidak dapat diubah dalam transisi. |