bazel [<startup options>] <command> [<args>]atau
bazel [<startup options>] <command> [<args>] -- [<target patterns>]Lihat Panduan Pengguna untuk 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 singkat satu karakter; dalam hal ini, bentuk singkat 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 ditetapkan ke otomatis secara default, dan dapat diaktifkan secara paksa sebagai berikut:
--<option>=[true|yes|1]atau dinonaktifkan secara paksa sebagai berikut:
--no<option> --<option>=[false|no|0]
Perintah
analyze-profile |
Menganalisis data profil build. |
aquery |
Menganalisis target yang diberikan dan membuat kueri grafik tindakan. |
build |
Mem-build target yang ditentukan. |
canonicalize-flags |
Melakukan kanonikalisasi daftar opsi bazel. |
clean |
Menghapus file output dan secara opsional menghentikan server. |
coverage |
Membuat laporan cakupan kode untuk target pengujian yang ditentukan. |
cquery |
Memuat, menganalisis, dan membuat kueri target yang ditentukan dengan konfigurasi. |
dump |
Menghapus 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 command line untuk mengompilasi file. |
query |
Menjalankan kueri grafik dependensi. |
run |
Menjalankan target yang ditentukan. |
shutdown |
Menghentikan server bazel. |
sync |
Menyinkronkan semua repositori yang ditentukan di file Workspace |
test |
Membangun dan menjalankan target pengujian yang ditentukan. |
vendor |
Mengambil repositori eksternal ke dalam folder yang ditentukan oleh tanda --vendor_dir. |
version |
Mencetak informasi versi untuk bazel. |
Opsi Startup
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
- Default
--[no]autodetect_server_javabase
: "true" -
Jika --noautodetect_server_javabase diteruskan, Bazel tidak akan kembali ke JDK lokal untuk menjalankan server bazel, tetapi akan keluar.
Tag:affects_outputs
,loses_incremental_state
- Default
--[no]batch
: "false" -
Jika ditetapkan, Bazel akan dijalankan hanya sebagai proses klien tanpa server, bukan dalam mode klien/server standar. Opsi ini tidak digunakan lagi dan akan dihapus. Sebaiknya matikan server secara eksplisit jika Anda ingin menghindari server yang tertinggal.
Tag:loses_incremental_state
,bazel_internal_configuration
,deprecated
- Default
--[no]batch_cpu_scheduling
: "false" -
Hanya di Linux; gunakan penjadwalan CPU 'batch' untuk Blaze. Kebijakan ini berguna untuk beban kerja yang non-interaktif, tetapi tidak ingin menurunkan nilai nice-nya. Lihat 'man 2 sched_setscheduler'. Jika salah (false), Bazel tidak akan melakukan panggilan sistem.
Tag:host_machine_resource_optimizations
- Default
--bazelrc=<path>
: lihat deskripsi -
Lokasi file .bazelrc pengguna yang berisi nilai default opsi Bazel. /dev/null menunjukkan bahwa semua `--bazelrc`lebih lanjut akan diabaikan, yang berguna untuk menonaktifkan penelusuran 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 ruang kerja, lalu direktori beranda pengguna.
Catatan: opsi command line akan selalu menggantikan opsi apa pun di bazelrc.
Tag:changes_inputs
- Default
--[no]block_for_lock
: "true" -
Saat --noblock_for_lock diteruskan, Bazel tidak menunggu perintah yang berjalan untuk diselesaikan, tetapi langsung keluar.
Tag:eagerness_to_exit
- Default
--[no]client_debug
: "false" -
Jika benar, catat informasi debug 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" -
Durasi klien menunggu setiap upaya untuk terhubung ke server
Tag:bazel_internal_configuration
- Default
--digest_function=<hash function>
: lihat deskripsi -
Fungsi hash yang digunakan saat menghitung ringkasan file.
Tag:loses_incremental_state
,bazel_internal_configuration
- Default
--[no]expand_configs_in_place
: "true" -
Mengubah perluasan flag --config agar dilakukan di tempat, bukan perluasan titik tetap antara opsi rc normal dan opsi yang ditentukan command line.
Tag:no_op
,deprecated
- Default
--failure_detail_out=<path>
: lihat deskripsi -
Jika ditetapkan, menentukan lokasi untuk menulis pesan protobuf failure_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
- Default
--[no]home_rc
: "true" -
Apakah akan mencari file bazelrc rumah di $HOME/.bazelrc atau tidak
Tag:changes_inputs
- Default
--[no]idle_server_tasks
: "true" -
Menjalankan System.gc() saat server tidak ada aktivitas
Tag:loses_incremental_state
,host_machine_resource_optimizations
- Default
--[no]ignore_all_rc_files
: "false" -
Menonaktifkan semua file rc, terlepas dari nilai flag pengubah rc lainnya, meskipun flag ini muncul nanti 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 disetel ke nilai negatif, Bazel tidak akan melakukan panggilan sistem.
Tag:host_machine_resource_optimizations
- Default
--local_startup_timeout_secs=<an integer>
: "120" -
Jumlah waktu maksimum yang ditunggu klien untuk terhubung ke server
Tag:bazel_internal_configuration
- Default
--macos_qos_class=<a string>
: "default" -
Menetapkan class layanan QoS server bazel saat berjalan di macOS. Flag ini tidak berpengaruh pada semua platform lainnya, tetapi didukung untuk memastikan file rc dapat dibagikan di antara platform tersebut tanpa perubahan. Kemungkinan nilainya adalah: interaktif pengguna, dimulai pengguna, default, utilitas, dan latar belakang.
Tag:host_machine_resource_optimizations
- Default
--max_idle_secs=<integer>
: "10800" -
Jumlah detik server build akan menunggu tidak ada aktivitas sebelum dinonaktifkan. Nol berarti server tidak akan pernah dimatikan. Ini hanya dibaca saat server dimulai, mengubah opsi ini tidak akan menyebabkan server dimulai ulang.
Tag:eagerness_to_exit
,loses_incremental_state
- Default
--output_base=<path>
: lihat deskripsi -
Jika ditetapkan, menentukan lokasi output tempat semua output build akan ditulis. Jika tidak, lokasinya akan menjadi ${OUTPUT_ROOT}/_blaze_${USER}/${MD5_OF_WORKSPACE_ROOT}. Catatan: Jika Anda menentukan opsi yang berbeda dari satu ke pemanggilan Bazel berikutnya untuk nilai ini, Anda mungkin akan memulai server Bazel baru yang tambahan. Bazel memulai tepat satu server per basis output yang ditentukan. Biasanya, ada satu basis output per ruang kerja - namun, dengan opsi ini, Anda mungkin memiliki beberapa basis output per ruang kerja dan dengan demikian menjalankan beberapa build untuk klien yang sama pada mesin yang sama secara bersamaan. Lihat 'bazel help shutdown' tentang cara menonaktifkan server Bazel.
Tag:affects_outputs
,loses_incremental_state
- Default
--output_user_root=<path>
: lihat deskripsi -
Direktori khusus pengguna tempat semua output build ditulis; 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
- Default
--[no]preemptible
: "false" -
Jika benar, perintah dapat didahului jika perintah lain dimulai.
Tag:eagerness_to_exit
- Default
--server_jvm_out=<path>
: lihat deskripsi -
Lokasi untuk menulis output JVM server. Jika tidak disetel, setelan default adalah lokasi di output_base.
Tag:affects_outputs
,loses_incremental_state
- Default
--[no]shutdown_on_low_sys_mem
: "false" -
Jika max_idle_secs ditetapkan dan server build tidak ada aktivitas selama beberapa saat, matikan server saat RAM kosong sistem hampir habis. Khusus Linux.
Tag:eagerness_to_exit
,loses_incremental_state
- Default
--[no]system_rc
: "true" -
Apakah akan mencari bazelrc seluruh sistem atau tidak.
Tag:changes_inputs
- Default
--[no]unlimit_coredumps
: "false" -
Menaikkan batas coredump lunak ke batas keras untuk memungkinkan coredump server (termasuk JVM) dan klien dalam kondisi umum. Tempelkan flag ini di bazelrc Anda sekali dan lupakan sehingga Anda mendapatkan coredump saat benar-benar mengalami kondisi yang memicunya.
Tag:bazel_internal_configuration
- Default
--[no]watchfs
: "false" -
Jika true (benar), bazel akan mencoba menggunakan layanan file watch sistem operasi untuk mengetahui perubahan lokal, bukan memindai setiap file untuk menemukan perubahan.
Tag:deprecated
- Default
--[no]windows_enable_symlinks
: "false" -
Jika benar, link simbolis yang sebenarnya akan dibuat di Windows, bukan menyalin file. Memerlukan mode developer Windows yang diaktifkan dan Windows 10 versi 1703 atau yang lebih baru.
Tag:bazel_internal_configuration
- Default
--[no]workspace_rc
: "true" -
Apakah akan mencari file bazelrc ruang kerja di $workspace/.bazelrc atau tidak
Tag:changes_inputs
- Opsi lainnya, yang tidak dikategorikan.:
--host_jvm_args=<jvm_arg>
beberapa penggunaan diakumulasikan- Flag yang akan diteruskan ke JVM yang menjalankan Blaze.
--host_jvm_debug
-
Opsi praktis untuk menambahkan beberapa flag startup JVM tambahan, yang menyebabkan JVM menunggu selama startup hingga Anda terhubung dari debugger yang kompatibel dengan JDWP (seperti Eclipse) ke port 5005.
Diperluas ke:
--host_jvm_args=-Xdebug
--host_jvm_args=-Xrunjdwp:transport=dt_socket,server=y,address=5005
- Default
--host_jvm_profile=<profiler_name>
: "" - Opsi praktis untuk menambahkan beberapa flag startup JVM khusus profiler/debugger. Bazel memiliki daftar nilai yang diketahui yang dipetakan ke flag startup JVM yang di-hardcode, yang mungkin menelusuri beberapa jalur hardcode untuk file tertentu.
- Default
--server_javabase=<jvm path>
: "" - Jalur ke JVM yang digunakan untuk mengeksekusi Bazel itu sendiri.
Opsi yang Umum untuk semua Perintah
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
- Default
--http_connector_attempts=<an integer>
: "8" -
Jumlah maksimum percobaan untuk download http.
Tag:bazel_internal_configuration
- Default
--http_connector_retry_max_timeout=<An immutable length of time.>
: "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_max_parallel_downloads=<an integer>
: "8" -
Jumlah maksimum download http paralel.
Tag:bazel_internal_configuration
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Menskalakan semua waktu tunggu yang terkait dengan download http berdasarkan faktor yang diberikan
Tag:bazel_internal_configuration
- 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 berarti tidak ada batas.
Tag:execution
- Default
--[no]incompatible_remote_dangling_symlinks
: "true" -
Jika disetel ke benar (true), symlink yang diupload ke cache disk atau jarak jauh akan diizinkan untuk menumpuk.
Tag:execution
,incompatible_change
- Default
--[no]incompatible_remote_symlinks
: "true" -
Jika disetel ke true, Bazel akan selalu mengupload symlink ke cache disk atau jarak jauh. Jika tidak, symlink relatif yang tidak menggantung (dan hanya itu) akan diupload sebagai file atau direktori yang ditunjuknya.
Tag:execution
,incompatible_change
- Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
- Default
--[no]incompatible_enable_proto_toolchain_resolution
: "false" -
Jika true, aturan lang proto 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 komputer lokal. Tanda ini adalah alias untuk --remote_download_outputs=all.
Diperluas menjadi:
--remote_download_outputs=all
Tag:affects_outputs
--remote_download_minimal
-
Tidak mendownload output build jarak jauh ke komputer lokal. Flag ini adalah alias untuk --remote_download_outputs=minimal.
Diperluas menjadi:
--remote_download_outputs=minimal
Tag:affects_outputs
- Default
--remote_download_outputs=<all, minimal or toplevel>
: "toplevel" -
Jika disetel ke 'minimal', tidak akan mendownload output build jarak jauh ke mesin lokal, kecuali yang diperlukan oleh tindakan lokal. Jika disetel ke 'toplevel' berperilaku seperti'minimal', parameter ini juga akan mendownload output target level atas ke komputer lokal. Kedua opsi tersebut dapat mengurangi waktu build secara signifikan jika bandwidth jaringan menjadi bottleneck.
Tag:affects_outputs
- Default
--remote_download_symlink_template=<a string>
: "" -
Buat link simbolis, bukan mendownload output build jarak jauh ke komputer lokal. Target link simbolis dapat ditentukan dalam bentuk string template. String template ini dapat berisi {hash} dan {size_bytes} yang masing-masing diperluas ke hash objek dan ukuran dalam byte. Misalnya, link simbolis ini dapat 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 tingkat atas ke komputer lokal. Flag ini adalah alias untuk --remote_download_outputs=toplevel.
Diperluas menjadi:
--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. Perhatikan 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 menerapkan input build yang valid (definisi aturan, kombinasi tanda, dll.):
- Default
--[no]check_bzl_visibility
: "true" -
Jika dinonaktifkan, error visibilitas pemuatan .bzl akan diturunkan menjadi peringatan.
Tag:build_file_semantics
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
- Default
--[no]enable_bzlmod
: "true" -
Jika benar, mengaktifkan sistem pengelolaan dependensi Bzlmod, yang lebih diutamakan daripada WORKSPACE. Lihat https://bazel.build/docs/bzlmod untuk informasi selengkapnya.
Tag:loading_and_analysis
- Default
--[no]enable_workspace
: "true" -
Jika benar, sistem WORKSPACE lama akan diaktifkan untuk dependensi eksternal. Lihat https://bazel.build/external/overview untuk informasi selengkapnya.
Tag:loading_and_analysis
- Default
--[no]experimental_action_resource_set
: "true" -
Jika disetel ke benar (true), ctx.actions.run() dan ctx.actions.run_shell() akan menerima parameter resource_set untuk eksekusi lokal. Jika tidak, ukuran defaultnya adalah 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 file .bzl selama evaluasi tingkat atas untuk menetapkan visibilitasnya untuk tujuan pernyataan load().
Tag:loading_and_analysis
,experimental
-
Jika disetel ke benar, atribut aturan dan metode Starlark API yang diperlukan untuk aturan cc_shared_library akan tersedia
Tag:build_file_semantics
,loading_and_analysis
,experimental
- Default
--[no]experimental_cc_static_library
: "false" -
Jika disetel ke benar, atribut aturan dan metode Starlark API yang diperlukan untuk aturan cc_static_library akan tersedia
Tag:build_file_semantics
,loading_and_analysis
,experimental
- Default
--[no]experimental_disable_external_package
: "false" -
Jika disetel ke benar, paket //external yang dibuat otomatis tidak akan tersedia lagi. Bazel masih tidak akan dapat mengurai file 'external/BUILD', tetapi glob yang menjangkau external/ dari paket tanpa nama akan berfungsi.
Tag:loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]experimental_enable_android_migration_apis
: "false" -
Jika disetel ke benar (true), API yang diperlukan akan diaktifkan untuk mendukung migrasi Starlark Android.
Tag:build_file_semantics
- Default
--[no]experimental_enable_scl_dialect
: "false" -
Jika disetel ke true, file .scl dapat digunakan dalam pernyataan load().
Tag:build_file_semantics
- Default
--[no]experimental_google_legacy_api
: "false" -
Jika disetel ke benar (true), akan mengekspos sejumlah bagian eksperimental API build Starlark yang terkait dengan kode lama Google.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_isolated_extension_usages
: "false" -
Jika benar, parameter <code>isolate</code> akan diaktifkan dalam fungsi <a href="https://bazel.build/rules/lib/globals/module#use_extension"><code>use_extension</code></a>.
Tag:loading_and_analysis
- Default
--[no]experimental_java_library_export
: "false" -
Jika diaktifkan, modul experimental_java_library_export_do_not_use akan tersedia.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]experimental_platforms_api
: "false" -
Jika disetel ke benar (true), akan mengaktifkan sejumlah Starlark API terkait platform yang berguna untuk proses debug.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_repo_remote_exec
: "false" -
Jika ditetapkan ke benar (true), repository_rule akan mendapatkan beberapa kemampuan eksekusi jarak jauh.
Tag:build_file_semantics
,loading_and_analysis
,experimental
- Default
--[no]experimental_sibling_repository_layout
: "false" -
Jika ditetapkan ke benar, 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. Tindakan ini memiliki efek samping untuk mengosongkan $output_base/execution_root/__main__/external untuk direktori 'external' level atas yang sebenarnya.
Tag:action_command_lines
,bazel_internal_configuration
,loading_and_analysis
,loses_incremental_state
,experimental
-
Jika ditetapkan ke benar (true), tag akan disebarkan 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
- Default
--[no]incompatible_always_check_depset_elements
: "true" -
Memeriksa validitas elemen yang ditambahkan ke depset, di semua konstruktor. Elemen harus tidak dapat diubah, tetapi secara historis konstruktor depset(direct=...) lupa untuk diperiksa. Gunakan tuple, bukan daftar, dalam elemen depset. Lihat https://github.com/bazelbuild/bazel/issues/10313 untuk mengetahui detailnya.
Tag:build_file_semantics
,incompatible_change
- Default
--incompatible_autoload_externally=<comma-separated set of options>
: "" -
Daftar aturan (atau simbol lainnya) yang dipisahkan koma yang sebelumnya merupakan bagian dari Bazel dan sekarang akan diambil dari repositori eksternal masing-masing. Flag ini dimaksudkan untuk digunakan guna memfasilitasi migrasi aturan dari Bazel. Lihat juga https://github.com/bazelbuild/bazel/issues/23043.
Simbol yang dimuat otomatis dalam file berperilaku seolah-olah definisi bawaan Bazel-nya diganti dengan definisi baru kanonisnya di repositori eksternal. Untuk file BUILD, pada dasarnya ini berarti secara implisit menambahkan pernyataan load(). Untuk file .bzl, ini adalah pernyataan load() atau perubahan pada kolom objek `native`, bergantung pada apakah simbol yang dimuat otomatis adalah aturan.
Bazel mempertahankan daftar hardcoded dari semua simbol yang dapat dimuat otomatis; hanya simbol tersebut yang dapat muncul dalam tanda ini. Untuk setiap simbol, Bazel mengetahui lokasi definisi baru di repositori eksternal, serta sekumpulan repositori kasus khusus yang tidak boleh memuat otomatis untuk menghindari pembuatan siklus.
Item daftar "+foo" dalam tanda ini menyebabkan simbol foo dimuat secara otomatis, kecuali di repositori foo yang dikecualikan, yang berisi versi foo yang ditentukan Bazel yang masih tersedia.
Item daftar "foo" memicu pemuatan otomatis seperti di atas, tetapi versi foo yang ditentukan Bazel tidak tersedia untuk repositori yang dikecualikan. Hal ini memastikan bahwa repositori eksternal foo tidak bergantung pada implementasi Bazel lama untuk foo
Item daftar "-foo" tidak memicu pemuatan otomatis, tetapi membuat versi foo yang ditentukan Bazel tidak dapat diakses di seluruh ruang kerja. Metode ini digunakan untuk memvalidasi bahwa ruang kerja siap dihapus dari definisi foo dari Bazel.
Jika simbol tidak diberi nama dalam flag ini, simbol tersebut akan terus berfungsi seperti biasa -- tidak ada pemuatan otomatis yang dilakukan, dan versi yang ditentukan Bazel tidak akan disembunyikan. Untuk konfigurasi, lihat https://github.com/bazelbuild/bazel/blob/master/src/main/java/com/google/devtools/build/lib/packages/AutoloadSymbols.java Sebagai pintasan, seluruh repositori dapat digunakan, misalnya +@rules_python akan memuat otomatis semua aturan Python.
Tag:loses_incremental_state
,build_file_semantics
,incompatible_change
- Default
--[no]incompatible_depset_for_java_output_source_jars
: "true" -
Jika benar, Bazel tidak lagi menampilkan daftar dari java_info.java_output[0].source_jars, tetapi menampilkan depset.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_depset_for_libraries_to_link_getter
default: "true"-
Jika benar, Bazel tidak lagi menampilkan daftar dari linking_context.libraries_to_link, tetapi menampilkan depset.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_disable_objc_library_transition
: "true" -
Nonaktifkan transisi kustom objc_library dan warisi dari target tingkat atas
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_disable_starlark_host_transitions
: "false" -
Jika ditetapkan ke benar, atribut aturan tidak dapat menetapkan 'cfg = "host"'. Sebagai gantinya, aturan harus menetapkan 'cfg = "exec"'.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_disable_target_provider_fields
: "false" -
Jika disetel ke benar (true), nonaktifkan kemampuan untuk mengakses penyedia pada objek 'target' melalui sintaksis kolom. Sebagai gantinya, gunakan sintaksis kunci penyedia. Misalnya, gunakan `ctx.attr.dep[MyInfo]`, bukan `ctx.attr.dep.my_info` untuk mengakses `my_info` dari dalam fungsi implementasi aturan. Lihat https://github.com/bazelbuild/bazel/issues/9014 untuk mengetahui detailnya.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_disallow_empty_glob
: "false" -
Jika ditetapkan ke true, nilai default argumen `allow_empty` glob() adalah False.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_disallow_struct_provider_syntax
: "false" -
Jika disetel ke benar (true), fungsi penerapan aturan mungkin tidak menampilkan struct. Sebagai gantinya, metode ini harus menampilkan daftar instance penyedia.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_enable_deprecated_label_apis
: "true" -
Jika diaktifkan, API tertentu yang tidak digunakan lagi (native.repository_name, Label.workspace_name, Label.relative) dapat digunakan.
Tag:loading_and_analysis
- Default
--[no]incompatible_existing_rules_immutable_view
: "true" -
Jika ditetapkan ke true, native.existing_rule dan native.existing_rules akan menampilkan objek tampilan ringan yang tidak dapat diubah, bukan dict yang dapat diubah.
Tag:build_file_semantics
,loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_fail_on_unknown_attributes
: "true" -
Jika diaktifkan, target yang memiliki atribut tidak diketahui yang disetel ke None akan gagal.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_fix_package_group_reporoot_syntax
: "true" -
Dalam atribut `packages` package_group, ubah arti nilai "//..." untuk merujuk ke semua paket di repositori saat ini, bukan semua paket di repositori mana 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
- Default
--[no]incompatible_java_common_parameters
: "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
- Default
--[no]incompatible_merge_fixed_and_default_shell_env
: "true" -
Jika diaktifkan, tindakan yang terdaftar di ctx.actions.run dan ctx.actions.run_shell dengan nilai 'env' dan 'use_default_shell_env = True' akan menggunakan lingkungan yang diperoleh dari lingkungan shell default dengan mengganti dengan nilai yang diteruskan ke 'env'. Jika dinonaktifkan, nilai 'env' akan sepenuhnya diabaikan dalam kasus ini.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
default: "true"-
Jika disetel ke benar, API untuk membuat tindakan hanya tersedia di `ctx.actions`, bukan di `ctx`.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_no_attr_license
: "true" -
Jika disetel ke benar (true), fungsi `attr.license` akan dinonaktifkan.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_no_implicit_file_export
: "false" -
Jika ditetapkan, file sumber (digunakan) bersifat pribadi paket, kecuali jika diekspor secara eksplisit. Lihat https://github.com/bazelbuild/proposals/blob/master/designs/2019-10-24-file-visibility.md
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_no_implicit_watch_label
: "false" -
Jika benar, metode di <code>repository_ctx</code> yang diteruskan Label tidak akan lagi otomatis memantau file dalam label tersebut untuk mengetahui perubahan meskipun <code>watch = "no"</code>, dan <code>repository_ctx.path</code> tidak lagi menyebabkan jalur yang ditampilkan dipantau. Gunakan <code>repository_ctx.watch</code> sebagai gantinya.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_no_rule_outputs_param
: "false" -
Jika disetel ke benar (true), menonaktifkan parameter `outputs` dari fungsi Starlark `rule()`.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_objc_provider_remove_linking_info
: "false" -
Jika ditetapkan ke benar (true), API ObjcProvider untuk info penautan akan dihapus.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_package_group_has_public_syntax
: "true" -
Di atribut `packages` package_group, memungkinkan penulisan "public" atau "private" untuk merujuk ke semua paket atau tidak ada paket.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_require_linker_input_cc_api
: "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 disetel ke benar (true), parameter perintah actions.run_shell hanya akan menerima string
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_stop_exporting_language_modules
: "false" -
Jika diaktifkan, modul khusus bahasa tertentu (seperti `cc_common`) tidak tersedia dalam file .bzl pengguna dan hanya dapat dipanggil dari repositori aturan masing-masing.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_struct_has_no_methods
: "false" -
Menonaktifkan metode to_json dan to_proto dari struct, yang mencemari 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
- Default
--[no]incompatible_top_level_aspects_require_providers
: "false" -
Jika disetel ke benar (true), aspek tingkat teratas akan mematuhi penyedia yang diperlukan dan hanya berjalan pada target tingkat atas yang penyedia yang diiklankan aturannya memenuhi penyedia aspek yang diperlukan.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_unambiguous_label_stringification
: "true" -
Jika benar, Bazel akan mengubah 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 mengetahui informasi selengkapnya.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_use_cc_configure_from_rules_cc
: "false" -
Jika benar (true), 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
- Default
--[no]incompatible_use_plus_in_repo_names
: "false" -
Jika benar, menggunakan tanda plus (+) sebagai pemisah dalam nama repo kanonis, bukan tilde (~). Hal ini untuk mengatasi masalah performa yang parah di Windows; lihat https://github.com/bazelbuild/bazel/issues/22865 untuk mengetahui informasi selengkapnya.
Tag:loading_and_analysis
- Default
--[no]incompatible_visibility_private_attributes_at_definition
: "true" -
Jika disetel ke benar (true), visibilitas atribut aturan pribadi akan diperiksa sehubungan dengan definisi aturan, dengan kembali ke penggunaan aturan jika tidak terlihat.
Tag:build_file_semantics
,incompatible_change
- Default
--max_computation_steps=<a long integer>
: "0" -
Jumlah maksimum langkah komputasi Starlark yang dapat dieksekusi oleh file BUILD (nol berarti tidak ada batas).
Tag:build_file_semantics
- Default
--nested_set_depth_limit=<an integer>
: "3.500" - kedalaman maksimum grafik internal untuk depset (juga dikenal sebagai NestedSet), yang di atasnya konstruktor depset() akan gagal.
Tag:loading_and_analysis
- Default
--repositories_without_autoloads=<comma-separated set of options>
: "" -
Daftar repositori tambahan (di luar repositori hardcode yang diketahui Bazel) tempat autoload tidak akan ditambahkan. Ini biasanya berisi repositori yang secara transitif bergantung pada repositori yang dapat dimuat secara otomatis (dan karenanya berpotensi membuat siklus).
Tag:loses_incremental_state
,build_file_semantics
,incompatible_change
- Opsi yang memicu pengoptimalan waktu build:
- Default
--[no]heuristically_drop_nodes
: "false" -
Jika benar, Blaze akan menghapus node FileState dan DirectoryListingState setelah node File dan DirectoryListing terkait selesai untuk menghemat memori. Kami memperkirakan bahwa kecil kemungkinan node ini akan diperlukan lagi. Jika demikian, program akan mengevaluasinya kembali.
Tag:loses_incremental_state
- Default
--[no]incompatible_do_not_split_linking_cmdline
: "true" -
Jika benar, Bazel tidak lagi mengubah flag command line yang digunakan untuk penautan, dan juga tidak secara selektif memutuskan flag mana yang akan masuk ke file parameter dan mana yang tidak. Lihat https://github.com/bazelbuild/bazel/issues/7670 untuk mengetahui detailnya.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]keep_state_after_build
: "true" -
Jika salah, Blaze akan menghapus status in-memory dari build ini saat build selesai. Build berikutnya tidak akan memiliki inkrementalitas sehubungan dengan build ini.
Tag:loses_incremental_state
- Default
--[no]track_incremental_state
: "true" -
Jika salah, Blaze tidak akan mempertahankan data yang memungkinkan pembatalan validasi dan evaluasi ulang pada build inkremental untuk menghemat memori pada build ini. Build berikutnya tidak akan memiliki inkrementalitas sehubungan dengan build ini. Biasanya, Anda akan ingin menentukan --batch saat menetapkannya ke salah.
Tag:loses_incremental_state
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
- Default
--[no]announce_rc
: "false" -
Apakah akan mengumumkan opsi rc.
Tag:affects_outputs
- Default
--[no]attempt_to_print_relative_paths
: "false" -
Saat mencetak bagian lokasi pesan, coba gunakan jalur yang relatif terhadap direktori ruang kerja atau salah satu direktori yang ditentukan oleh --package_path.
Tag:terminal_output
- Default
--bes_backend=<a string>
: "" -
Menentukan endpoint backend layanan peristiwa build (BES) dalam bentuk [SCHEME://]HOST[:PORT]. Setelan defaultnya adalah menonaktifkan upload BES. Skema yang didukung adalah grpc dan grpcs (grpc dengan TLS diaktifkan). Jika tidak ada skema yang diberikan, Bazel akan mengasumsikan grpcs.
Tag:affects_outputs
- Default
--[no]bes_check_preceding_lifecycle_events
: "false" -
Menetapkan kolom check_preceding_lifecycle_events_present di PublishBuildToolEventStreamRequest yang memberi tahu BES untuk memeriksa apakah sebelumnya menerima peristiwa InvocationAttemptStarted dan BuildEnqueued yang cocok dengan peristiwa alat saat ini.
Tag:affects_outputs
--bes_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan-
Tentukan header dalam bentuk 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
- Default
--bes_instance_name=<a string>
: 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"). Setelan default-nya adalah tidak ada.
Tag:affects_outputs
- Default
--[no]bes_lifecycle_events
: "true" -
Menentukan apakah akan memublikasikan peristiwa siklus proses BES. (default-nya adalah 'true').
Tag:affects_outputs
- Default
--bes_oom_finish_upload_timeout=<An immutable length of time.>
: "10m" -
Menentukan berapa lama bazel harus menunggu upload BES/BEP selesai saat OOM. Flag ini memastikan penghentian saat JVM melakukan thrashing GC berat dan tidak dapat membuat progres di thread pengguna mana pun.
Tag:bazel_monitoring
- Default
--bes_outerr_buffer_size=<an integer>
: "10240" -
Menentukan ukuran maksimum stdout atau stderr yang akan dibuffer di BEP, sebelum dilaporkan sebagai peristiwa progres. Setiap operasi tulis 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
- Default
--bes_proxy=<a string>
: lihat deskripsi - Hubungkan ke Layanan Peristiwa Build melalui proxy. Saat ini, tanda ini hanya dapat digunakan untuk mengonfigurasi soket domain Unix (unix:/path/to/socket).
- Default
--bes_results_url=<a string>
: "" -
Menentukan URL dasar tempat pengguna dapat melihat informasi yang di-streaming ke backend BES. Bazel akan menampilkan URL yang ditambahkan oleh ID panggilan 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 awalan "user_keyword=" yang disertakan untuk kata kunci yang disediakan melalui --bes_keywords. Dimaksudkan untuk operator layanan Build yang menetapkan --bes_lifecycle_events=false dan menyertakan kata kunci saat memanggil PublishLifecycleEvent. Membuat operator layanan yang menggunakan tanda ini harus mencegah pengguna mengganti nilai tanda.
Tag:affects_outputs
- Default
--bes_timeout=<An immutable length of time.>
: "0" -
Menentukan berapa lama bazel harus menunggu upload BES/BEP selesai setelah build dan pengujian selesai. Waktu tunggu yang valid adalah bilangan asli yang diikuti dengan satuan: Hari (d), jam (h), menit (m), detik (s), dan milidetik (ms). Nilai defaultnya adalah '0' yang berarti tidak ada waktu tunggu.
Tag:affects_outputs
- Default
--bes_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
: "wait_for_upload_complete" -
Menentukan apakah upload Build Event Service harus memblokir penyelesaian build atau harus segera mengakhiri pemanggilan dan menyelesaikan upload di latar belakang. 'wait_for_upload_complete' (default), 'nowait_for_upload_complete', atau 'fully_async'.
Tag:eagerness_to_exit
- Default
--build_event_binary_file=<a string>
: "" -
Jika tidak kosong, tulis representasi biner yang dipisahkan 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"-
Mengonversi 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
- Default
--build_event_binary_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
: "wait_for_upload_complete" -
Menentukan apakah upload Build Event Service untuk --build_event_binary_file harus memblokir penyelesaian build atau harus segera mengakhiri pemanggilan dan menyelesaikan upload di latar belakang. 'wait_for_upload_complete' (default), 'nowait_for_upload_complete', atau 'fully_async'.
Tag:eagerness_to_exit
- Default
--build_event_json_file=<a string>
: "" -
Jika tidak kosong, tulis serialisasi JSON protokol peristiwa build ke file tersebut. Opsi ini menyiratkan --bes_upload_mode=wait_for_upload_complete.
Tag:affects_outputs
- Default
--[no]build_event_json_file_path_conversion
: "true" -
Konversikan 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
- Default
--build_event_json_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
: "wait_for_upload_complete" -
Menentukan apakah upload Build Event Service untuk --build_event_json_file harus memblokir penyelesaian build atau harus segera mengakhiri pemanggilan dan menyelesaikan upload di latar belakang. 'wait_for_upload_complete' (default), 'nowait_for_upload_complete', atau 'fully_async'.
Tag:eagerness_to_exit
- Default
--build_event_max_named_set_of_file_entries=<an integer>
: "-1" -
Jumlah entri maksimum untuk satu peristiwa bernama_set_of_files; nilai yang lebih kecil dari 2 akan diabaikan dan pemisahan peristiwa tidak dilakukan. Hal ini dimaksudkan untuk membatasi ukuran peristiwa maksimum dalam protokol peristiwa build, meskipun tidak secara langsung mengontrol ukuran peristiwa. Total ukuran peristiwa adalah fungsi dari struktur set serta panjang file dan URI, yang pada akhirnya mungkin bergantung pada fungsi hash.
Tag:affects_outputs
- Default
--[no]build_event_publish_all_actions
: "false" -
Apakah semua tindakan harus dipublikasikan.
Tag:affects_outputs
- Default
--build_event_text_file=<a string>
: "" -
Jika tidak kosong, tulis representasi tekstual protokol peristiwa build ke file tersebut
Tag:affects_outputs
--[no]build_event_text_file_path_conversion
default: "true"-
Konversikan jalur dalam representasi file teks protokol peristiwa build ke URI yang lebih valid secara global jika memungkinkan; jika dinonaktifkan, skema URI file:// akan selalu digunakan
Tag:affects_outputs
- Default
--build_event_text_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
: "wait_for_upload_complete" -
Menentukan apakah upload Build Event Service 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 'complete_async'.
Tag:eagerness_to_exit
- Default
--[no]experimental_announce_profile_path
: "false" -
Jika diaktifkan, akan menambahkan jalur profil JSON ke log.
Tag:bazel_monitoring
- Default
--[no]experimental_bep_target_summary
: "false" - Apakah akan memublikasikan peristiwa TargetSummary.
- Default
--[no]experimental_build_event_expand_filesets
: "false" -
Jika benar, luaskan Fileset di BEP saat menampilkan file output.
Tag:affects_outputs
- Default
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: "false" -
Jika true, selesaikan symlink Fileset relatif di BEP saat menyajikan file output. Memerlukan --experimental_build_event_expand_filesets.
Tag:affects_outputs
- Default
--experimental_build_event_upload_max_retries=<an integer>
: "4" -
Frekuensi maksimum Bazel harus mencoba mengupload peristiwa build lagi.
Tag:bazel_internal_configuration
- Default
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1s" -
Penundaan awal minimum untuk percobaan ulang backoff eksponensial saat upload BEP gagal. (eksponen: 1,6)
Tag:bazel_internal_configuration
- Default
--experimental_build_event_upload_strategy=<a string>
: lihat deskripsi -
Memilih cara mengupload artefak yang dirujuk dalam protokol peristiwa build.
Tag:affects_outputs
- Default
--[no]experimental_collect_load_average_in_profiler
: "true" -
Jika diaktifkan, profiler akan mengumpulkan beban rata-rata keseluruhan sistem.
Tag:bazel_monitoring
- Default
--[no]experimental_collect_pressure_stall_indicators
: "false" -
Jika diaktifkan, profiler akan mengumpulkan data PSI Linux.
Tag:bazel_monitoring
- Default
--[no]experimental_collect_resource_estimation
: "false" -
Jika diaktifkan, profiler akan mengumpulkan estimasi penggunaan CPU dan memori untuk tindakan lokal.
Tag:bazel_monitoring
- Default
--[no]experimental_collect_system_network_usage
: "false" -
Jika diaktifkan, profiler akan mengumpulkan penggunaan jaringan sistem.
Tag:bazel_monitoring
- Default
--[no]experimental_collect_worker_data_in_profiler
: "false" -
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_io, pressure_stall_memory, conflict_check, dynamic_lock, repository_fetch, repository_vendor or unknown>
beberapa penggunaan diakumulasikan-
Menentukan tugas profil tambahan yang akan disertakan dalam profil.
Tag:bazel_monitoring
- Default
--[no]experimental_profile_include_primary_output
: "false" -
Menyertakan atribut "out" tambahan dalam peristiwa tindakan yang berisi jalur eksekusi ke output utama tindakan.
Tag:bazel_monitoring
- Default
--[no]experimental_profile_include_target_label
: "false" -
Menyertakan label target dalam data profil JSON peristiwa tindakan.
Tag:bazel_monitoring
- Default
--[no]experimental_run_bep_event_include_residue
: "false" -
Apakah akan menyertakan residu command line dalam peristiwa build run yang dapat berisi residu. Secara default, residu tidak disertakan dalam peristiwa build perintah run yang dapat berisi residu.
Tag:affects_outputs
- Default
--[no]experimental_stream_log_file_uploads
: "false" -
Upload file log streaming langsung ke penyimpanan jarak jauh, bukan menulisnya ke disk.
Tag:affects_outputs
- Default
--experimental_workspace_rules_log_file=<a path>
: lihat deskripsi - Mencatat peristiwa Aturan Workspace tertentu ke dalam file ini sebagai proto WorkspaceEvent yang dipisahkan.
- Default
--[no]generate_json_trace_profile
: "otomatis" -
Jika diaktifkan, Bazel akan membuat profil build dan menulis profil berformat 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
- Default
--[no]heap_dump_on_oom
: "false" -
Apakah akan menampilkan dump heap 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
- Default
--[no]legacy_important_outputs
: "true" -
Gunakan ini untuk menyembunyikan pembuatan kolom important_outputs lama dalam peristiwa TargetComplete. important_outputs diperlukan untuk integrasi Bazel ke ResultStore.
Tag:affects_outputs
- Default
--logging=<0 <= an integer <= 6>
: "3" -
Level logging.
Tag:affects_outputs
- Default
--memory_profile=<a path>
: lihat deskripsi -
Jika ditetapkan, tulis data penggunaan memori ke file yang ditentukan pada 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 profil memori heap stabil di akhir build. Harus berupa bilangan bulat genap yang dipisahkan koma. Dalam setiap pasangan, integer pertama adalah jumlah GC yang harus dilakukan. Bilangan bulat kedua dalam setiap pasangan adalah jumlah detik yang harus ditunggu di antara GC. Contoh: 2,4,4,0 akan menjadi 2 GC dengan jeda 4 detik, diikuti dengan 4 GC dengan jeda nol detik
Tag:bazel_monitoring
- Default
--profile=<a path>
: lihat deskripsi -
Jika ditetapkan, buat profil Bazel dan tulis data ke file yang ditentukan. Gunakan bazel analyze-profile untuk menganalisis profil.
Tag:bazel_monitoring
- Default
--[no]record_full_profiler_data
: "false" -
Secara default, profiler Bazel hanya akan merekam data gabungan untuk peristiwa dengan cepat tetapi banyak (seperti membuat statistik file). Jika opsi ini diaktifkan, profiler akan merekam setiap peristiwa, sehingga menghasilkan data pembuatan profil yang lebih akurat, tetapi performa yang BESAR. Opsi hanya berpengaruh jika --profile juga digunakan.
Tag:bazel_monitoring
- Default
--remote_print_execution_messages=<failure, success or all>
: "kegagalan" -
Pilih kapan akan mencetak pesan eksekusi jarak jauh. Nilai yang valid adalah `gagal`. Untuk mencetak hanya saat gagal, `berhasil` mencetak hanya jika berhasil, dan `semua` untuk selalu mencetak.
Tag:terminal_output
- Default
--[no]slim_profile
: "true" -
Memperkecil ukuran profil JSON dengan menggabungkan peristiwa jika profil menjadi terlalu besar.
Tag:bazel_monitoring
- Default
--starlark_cpu_profile=<a string>
: "" -
Menuliskan profil pprof penggunaan CPU oleh semua thread Starlark ke dalam file yang ditentukan.
Tag:bazel_monitoring
- Default
--tool_tag=<a string>
: "" -
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 peristiwa ke peristiwa default menggunakan tanda +/- di awal, atau mengganti kumpulan 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:
- Default
--experimental_circuit_breaker_strategy=<failure>
: lihat deskripsi -
Menentukan strategi yang akan digunakan pemutus arus. Strategi yang tersedia adalah "failure". Pada nilai yang tidak valid untuk opsi, perilaku yang sama dengan opsi tidak ditetapkan.
Tag:execution
- Default
--[no]experimental_guard_against_concurrent_changes
: "false" - Nonaktifkan opsi ini untuk menonaktifkan pemeriksaan ctime file input tindakan sebelum menguploadnya ke cache jarak jauh. Mungkin ada kasus saat kernel Linux menunda penulisan file, yang dapat menyebabkan positif palsu.
- Default
--[no]experimental_remote_cache_async
: "false" - Jika benar, I/O cache jarak jauh akan terjadi di latar belakang, bukan sebagai bagian dari spawn.
- Default
--experimental_remote_cache_compression_threshold=<an integer>
: "0" - Ukuran blob minimum yang diperlukan untuk mengompresi/mendekompresi dengan zstd. Tidak efektif kecuali --remote_cache_compression ditetapkan.
- Default
--[no]experimental_remote_cache_lease_extension
: "false" - Jika disetel ke benar (true), Bazel akan memperpanjang sewa untuk output tindakan jarak jauh selama build dengan mengirimkan panggilan `FindMissingBlobs` secara berkala ke cache jarak jauh. Frekuensi didasarkan pada nilai `--experimental_remote_cache_ttl`.
- Default
--experimental_remote_cache_ttl=<An immutable length of time.>
: "3h" -
TTL blob minimum yang dijamin di 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 sebenarnya karena ada jeda antara saat server menampilkan ringkasan dan saat Bazel menerimanya.
Tag:execution
- Default
--experimental_remote_capture_corrupted_outputs=<a path>
: lihat deskripsi - Jalur ke direktori tempat output yang rusak akan diambil.
- Default
--[no]experimental_remote_discard_merkle_trees
: "false" - Jika disetel ke benar (true), hapus salinan hierarki Merkle root input dalam memori dan pemetaan input terkait selama panggilan ke GetActionResult() dan Execute(). Hal ini akan mengurangi penggunaan memori secara signifikan, tetapi Bazel harus menghitungnya ulang jika cache jarak jauh tidak ditemukan dan dicoba ulang.
- Default
--experimental_remote_downloader=<a string>
: lihat deskripsi - URI endpoint Remote Asset API, yang akan digunakan sebagai proxy download jarak jauh. Skema yang didukung adalah grpc, grpcs (grpc dengan TLS diaktifkan), dan unix (soket UNIX lokal). Jika tidak ada skema yang diberikan, Bazel akan menetapkan default ke grpcs. Lihat: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
- Default
--[no]experimental_remote_downloader_local_fallback
: "false" - Apakah akan kembali ke downloader lokal jika downloader jarak jauh gagal.
- Default
--[no]experimental_remote_execution_keepalive
: "false" - Apakah akan menggunakan keepalive untuk panggilan eksekusi jarak jauh.
- Default
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
: "10" -
Menetapkan jumlah rasio kegagalan yang diizinkan dalam persentase untuk jangka waktu tertentu, setelah itu cache/eksekutor jarak jauh berhenti memanggil. Secara default, nilainya adalah 10. Menetapkan nilai ini ke 0 berarti tidak ada batasan.
Tag:execution
- Default
--experimental_remote_failure_window_interval=<An immutable length of time.>
: "60 dtk" -
Interval saat rasio kegagalan permintaan jarak jauh dihitung. Pada nilai nol atau negatif, durasi kegagalan dihitung dari seluruh durasi eksekusi.Unit berikut dapat digunakan: Hari (d), jam (h), menit (m), detik (s), dan milidetik (ms). Jika unit dihilangkan, nilai akan ditafsirkan sebagai detik.
Tag:execution
- Default
--[no]experimental_remote_mark_tool_inputs
: "false" - Jika disetel ke benar (true), Bazel akan menandai input sebagai input alat untuk eksekutor jarak jauh. Ini dapat digunakan untuk menerapkan pekerja persisten jarak jauh.
- Default
--[no]experimental_remote_merkle_tree_cache
: "false" - Jika disetel ke true, penghitungan hierarki Merkle akan di-memonize untuk meningkatkan kecepatan pemeriksaan hit cache jarak jauh. Jejak memori cache dikontrol oleh --experimental_remote_merkle_tree_cache_size.
- Default
--experimental_remote_merkle_tree_cache_size=<a long integer>
: "1000" - Jumlah hierarki Merkle yang akan di-memo untuk meningkatkan kecepatan pemeriksaan hit 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 bergantung pada ukuran project. Nilai defaultnya adalah 1.000.
- Default
--experimental_remote_output_service=<a string>
: lihat deskripsi - HOST atau HOST:PORT endpoint layanan output jarak jauh. Skema yang didukung adalah grpc, grpcs (grpc dengan TLS diaktifkan), dan unix (soket UNIX lokal). Jika tidak ada skema yang diberikan, Bazel akan menetapkan default ke grpcs. Tentukan skema grpc:// atau unix: untuk menonaktifkan TLS.
- Default
--experimental_remote_output_service_output_path_prefix=<a string>
: "" - Jalur tempat konten direktori output yang dikelola oleh --experimental_remote_output_service ditempatkan. Direktori output aktual yang digunakan oleh build akan merupakan turunan dari jalur ini dan ditentukan oleh layanan output.
- Default
--[no]experimental_remote_require_cached
: "false" - Jika ditetapkan ke benar (true), pastikan semua tindakan yang dapat berjalan dari jarak jauh disimpan dalam cache, atau build akan gagal. Hal ini berguna untuk memecahkan masalah non-determinisme karena memungkinkan pemeriksaan apakah tindakan yang seharusnya di-cache benar-benar di-cache tanpa memasukkan hasil baru secara tidak sah ke dalam cache.
- Default
--experimental_remote_scrubbing_config=<Converts to a Scrubber>
: lihat deskripsi - Memungkinkan scrubbing 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 pembagian cache disk/jarak jauh di antara tindakan yang dijalankan di platform yang berbeda, tetapi menargetkan platform yang sama. Fitur ini harus digunakan dengan sangat hati-hati, karena setelan yang tidak tepat dapat menyebabkan pembagian entri cache secara tidak sengaja dan menghasilkan build yang salah. Pembersihan tidak memengaruhi cara tindakan dieksekusi, hanya cara kunci cache disk/jarak jauh dihitung untuk tujuan mengambil atau menyimpan hasil tindakan. Tindakan yang dihapus tidak kompatibel dengan eksekusi jarak jauh, dan akan selalu dieksekusi secara lokal. Mengubah konfigurasi scrubbing tidak membatalkan output yang ada dalam sistem file lokal atau cache internal; build bersih diperlukan untuk mengeksekusi kembali tindakan yang terpengaruh. Agar berhasil menggunakan fitur ini, sebaiknya tetapkan --host_platform kustom bersama dengan --experimental_platform_in_output_dir (untuk menormalisasi awalan output) dan --incompatible_strict_action_env (untuk menormalisasi variabel lingkungan).
- Default
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "false" - Tidak digunakan lagi. Tanpa pengoperasian. Gunakan --remote_build_event_upload=minimal sebagai gantinya.
- Default
--[no]incompatible_remote_downloader_send_all_headers
: "true" -
Apakah akan mengirim semua nilai header multinilai ke downloader jarak jauh, bukan hanya yang pertama.
Tag:incompatible_change
- Default
--[no]incompatible_remote_output_paths_relative_to_input_root
: "false" -
Jika disetel ke benar (true), jalur output relatif terhadap root input, bukan direktori kerja.
Tag:incompatible_change
--[no]incompatible_remote_results_ignore_disk
default: "true"-
Tanpa pengoperasian
Tag:incompatible_change
- Default
--[no]remote_accept_cached
: "true" - Apakah akan menerima hasil tindakan yang di-cache dari jarak jauh.
- Default
--remote_build_event_upload=<all or minimal>
: "minimal" - Jika disetel ke 'all', semua output lokal yang direferensikan oleh BEP akan diupload ke cache jarak jauh. Jika ditetapkan ke 'minimal', output lokal yang dirujuk oleh BEP tidak akan diupload ke cache jarak jauh, kecuali untuk file yang penting bagi konsumen BEP (misalnya, log pengujian dan profil pengaturan waktu). Skema bytestream:// selalu digunakan untuk URI file meskipun tidak ada di cache jarak jauh. Defaultnya adalah 'minimal'.
- Default
--remote_bytestream_uri_prefix=<a string>
: lihat deskripsi - Nama host dan nama instance yang akan digunakan dalam URI bytestream:// yang ditulis ke dalam aliran peristiwa build. Opsi ini dapat ditetapkan saat build dilakukan menggunakan proxy, yang menyebabkan nilai --remote_executor dan --remote_instance_name tidak lagi sesuai dengan nama kanonis layanan eksekusi jarak jauh. Jika tidak ditetapkan, setelan defaultnya adalah "${hostname}/${instance_name}".
- Default
--remote_cache=<a string>
: lihat deskripsi - URI endpoint penyimpanan dalam cache. Skema yang didukung adalah http, https, grpc, grpcs (grpc dengan TLS diaktifkan), dan unix (soket UNIX lokal). Jika tidak ada skema yang diberikan, Bazel akan menetapkan default ke grpcs. Tentukan grpc://, http://, atau unix: schema untuk menonaktifkan TLS. Lihat https://bazel.build/remote/caching
- Default
--[no]remote_cache_compression
: "false" - Jika diaktifkan, kompresi/dekompresi blob cache dengan zstd jika ukurannya minimal --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 tanda 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 yang akan digunakan sebagai platform eksekusi jarak jauh jika platform eksekusi belum menetapkan exec_properties.
Tag:affects_outputs
- Default
--remote_default_platform_properties=<a string>
: "" - Menetapkan properti platform default yang akan 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-
Memaksa output build jarak jauh yang jalurnya cocok dengan pola ini agar dapat 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 tanda beberapa kali. Beberapa nilai untuk nama yang sama akan dikonversi menjadi daftar yang dipisahkan koma.
- Default
--remote_execution_priority=<an integer>
: "0" - Prioritas relatif tindakan yang akan dijalankan dari jarak jauh. Semantik nilai prioritas tertentu bergantung pada server.
- Default
--remote_executor=<a string>
: lihat deskripsi - HOST atau HOST:PORT dari endpoint eksekusi jarak jauh. Skema yang didukung adalah grpc, grpc (GPC dengan TLS diaktifkan), dan unix (soket UNIX lokal). Jika tidak ada skema yang diberikan, Bazel akan menetapkan default ke grpcs. Tentukan skema grpc:// atau unix: untuk menonaktifkan TLS.
- Default
--remote_grpc_log=<a path>
: lihat deskripsi - Jika ditentukan, jalur ke file untuk mencatat detail terkait panggilan gRPC ke dalam log. Log ini terdiri dari urutan com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry protobuf dengan setiap pesan yang diawali dengan 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=Nama=Nilai. Beberapa header dapat diteruskan dengan menentukan flag beberapa kali. Beberapa nilai untuk nama yang sama akan dikonversi menjadi daftar yang dipisahkan koma.
- Default
--remote_instance_name=<a string>
: "" - Nilai yang akan diteruskan sebagai instance_name di API eksekusi jarak jauh.
- Default
--[no]remote_local_fallback
: "false" - Apakah akan kembali ke strategi eksekusi lokal mandiri jika eksekusi jarak jauh gagal.
- Default
--remote_local_fallback_strategy=<a string>
: "local" - Tidak ada operasi, tidak digunakan lagi. Lihat https://github.com/bazelbuild/bazel/issues/7480 untuk mengetahui detailnya.
- Default
--remote_max_connections=<an integer>
: "100" -
Membatasi jumlah maksimum koneksi serentak ke cache/eksekutor jarak jauh. Secara default, nilainya adalah 100. Menetapkan nilai 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 lebih dari 100 permintaan serentak, sehingga Bazel dapat membuat permintaan serentak `--remote_max_connections * 100`.
Tag:host_machine_resource_optimizations
- Default
--remote_proxy=<a string>
: lihat deskripsi - Hubungkan ke cache jarak jauh melalui proxy. Saat ini, tanda ini hanya dapat digunakan untuk mengonfigurasi soket domain Unix (unix:/path/to/socket).
- Default
--remote_result_cache_priority=<an integer>
: "0" - Prioritas relatif tindakan jarak jauh yang akan disimpan di cache jarak jauh. Semantik nilai prioritas tertentu bergantung pada server.
- Default
--remote_retries=<an integer>
: "5" - Jumlah maksimum upaya untuk mencoba ulang error sementara. Jika disetel 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 (h), menit (m), detik (s), dan milidetik (ms). Jika unit dihilangkan, nilai akan ditafsirkan sebagai detik.
- Default
--remote_timeout=<An immutable length of time.>
: "60s" - Jumlah waktu maksimum untuk menunggu eksekusi jarak jauh dan panggilan cache. Untuk REST cache, ini adalah waktu tunggu koneksi dan waktu baca. Unit berikut dapat digunakan: Hari (d), jam (h), menit (m), detik (s), dan milidetik (ms). Jika unit dihilangkan, nilai akan ditafsirkan sebagai detik.
- Default
--[no]remote_upload_local_results
: "true" - Apakah akan mengupload hasil tindakan yang dijalankan secara lokal ke cache jarak jauh jika cache jarak jauh mendukungnya dan pengguna telah diberi otorisasi untuk melakukannya.
--[no]remote_verify_downloads
default: "true"- Jika disetel ke benar, Bazel akan menghitung jumlah hash dari 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 diberikan dalam peristiwa build.
Tag:terminal_output
- Default
--color=<yes, no or auto>
: "auto" - Gunakan kontrol terminal untuk mewarnai output.
--config=<a string>
beberapa penggunaan diakumulasikan- Memilih bagian konfigurasi tambahan dari file rc; untuk setiap <command>, bagian ini juga mengambil opsi dari <command>:<config> jika bagian tersebut ada; jika bagian ini tidak ada dalam file .rc, Blaze akan gagal dengan error. Bagian konfigurasi dan kombinasi flag yang setara dengan bagian tersebut 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 Helper Kredensial</a> yang akan digunakan untuk mengambil kredensial otorisasi untuk pengambilan repositori, penyimpanan dalam cache dan eksekusi jarak jauh, serta layanan peristiwa build. Kredensial yang disediakan oleh helper lebih diutamakan daripada kredensial yang disediakan 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/configuring-bazels-credential-helper/ untuk mendapatkan petunjuk.
- Default
--credential_helper_cache_duration=<An immutable length of time.>
: "30 mnt" - Durasi default untuk menyimpan kredensial yang disediakan oleh helper kredensial dalam cache jika helper tidak memberikan kapan kredensial berakhir masa berlakunya.
- 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.
- Default
--curses=<yes, no or auto>
: "otomatis" - Gunakan kontrol kursor terminal untuk meminimalkan output scroll.
- Default
--disk_cache=<a path>
: lihat deskripsi - Jalur ke direktori tempat Bazel dapat membaca dan menulis tindakan serta output tindakan. Jika tidak ada, direktori akan dibuat.
- Default
--[no]enable_platform_specific_config
: "false" - Jika true (benar), Bazel akan mengambil baris konfigurasi khusus host OS dari file bazelrc. Misalnya, jika OS host adalah Linux dan Anda menjalankan build bazel, Bazel akan mengambil baris yang dimulai dengan build:linux. ID OS yang didukung adalah linux, macos, windows, freebsd, dan openbsd. Mengaktifkan flag ini setara dengan menggunakan --config=linux di Linux, --config=windows di Windows, dll.
- Default
--experimental_disk_cache_gc_idle_delay=<An immutable length of time.>
: "5m" - Durasi server harus tetap tidak ada aktivitas sebelum pembersihan sampah cache disk terjadi. Untuk menetapkan kebijakan pembersihan sampah memori, setel --experiment_disk_cache_gc_max_size dan/atau --Experimental_disk_cache_gc_max_age.
- Default
--experimental_disk_cache_gc_max_age=<An immutable length of time.>
: "0" - Jika ditetapkan ke nilai positif, cache disk akan dihapus secara berkala untuk menghapus entri yang lebih lama dari usia ini. Jika ditetapkan bersama dengan --experimental_disk_cache_gc_max_size, kedua kriteria akan diterapkan. Pembersihan sampah memori terjadi di latar belakang setelah server tidak ada aktivitas, seperti yang ditentukan oleh tanda --experiment_disk_cache_gc_idle_delay.
- Default
--experimental_disk_cache_gc_max_size=<a size in bytes, optionally followed by a K, M, G or T multiplier>
: "0" - Jika ditetapkan ke nilai positif, cache disk akan dihapus secara berkala agar tetap berada di bawah ukuran ini. Jika ditetapkan bersama dengan --experimental_disk_cache_gc_max_age, kedua kriteria akan diterapkan. Pengumpulan sampah terjadi di latar belakang setelah server menjadi tidak ada aktivitas, seperti yang ditentukan oleh flag --experimental_disk_cache_gc_idle_delay.
- Default
--[no]experimental_rule_extension_api
: "false" -
Mengaktifkan API ekstensi aturan dan API subaturan eksperimental
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_windows_watchfs
: "false" - Jika true (benar), dukungan Windows eksperimental untuk --watchfs akan diaktifkan. Jika tidak, --watchfs tidak akan berfungsi di Windows. Pastikan juga untuk mengaktifkan --watchfs.
- Default
--google_auth_scopes=<comma-separated list of options>
: "https://www.googleapis.com/auth/cloud-platform" - Daftar cakupan autentikasi Google Cloud yang dipisahkan koma.
- Default
--google_credentials=<a string>
: lihat deskripsi - Menentukan file tempat mendapatkan kredensial autentikasi. Lihat https://cloud.google.com/docs/authentication untuk mengetahui detailnya.
- Default
--[no]google_default_credentials
: "false" - Apakah akan menggunakan 'Kredensial Default Aplikasi Google' untuk autentikasi. Lihat https://cloud.google.com/docs/authentication untuk mengetahui detailnya. Dinonaktifkan secara default.
- Default
--grpc_keepalive_time=<An immutable length of time.>
: lihat deskripsi - Mengonfigurasi ping keep-alive untuk koneksi gRPC keluar. Jika 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; menetapkan nilai kurang dari satu detik merupakan kesalahan. 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, tindakan tersebut harus dilakukan seperti ini --grpc_keepalive_time=30s
- Default
--grpc_keepalive_timeout=<An immutable length of time.>
: "20s" - Mengonfigurasi waktu tunggu keep-alive untuk koneksi gRPC keluar. Jika ping keep-alive diaktifkan dengan --grpc_keepalive_time, Bazel akan menghentikan koneksi jika tidak menerima balasan ping setelah waktu ini. Waktu diperlakukan sebagai tingkat perincian kedua; menetapkan nilai kurang dari satu detik akan menyebabkan error. Jika ping tetap aktif dinonaktifkan, setelan ini akan diabaikan.
- Default
--[no]incompatible_disable_non_executable_java_binary
: "false" -
Jika benar, java_binary selalu dapat dieksekusi. Atribut create_executable akan dihapus.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_disallow_symlink_file_to_dir
: "true" -
Tanpa pengoperasian.
Tag:loading_and_analysis
,incompatible_change
- Default
--invocation_id=<a UUID>
: "" -
ID unik, dalam format UUID, untuk perintah yang sedang dijalankan. Jika ditentukan secara eksplisit, keunikan harus dipastikan oleh pemanggil. UUID dicetak ke stderr, BEP, dan protokol eksekusi jarak jauh.
Tag:bazel_monitoring
,bazel_internal_configuration
- Default
--[no]progress_in_terminal_title
: "false" - Menampilkan progres perintah di judul terminal. Berguna untuk melihat apa yang dilakukan bazel saat memiliki beberapa tab terminal.
- Default
--[no]show_progress
: "true" - Menampilkan pesan progres selama proses build.
- Default
--show_progress_rate_limit=<a double>
: "0,2" - Jumlah detik minimum antara pesan progres dalam output.
- Default
--[no]show_timestamps
: "false" - Menyertakan stempel waktu dalam pesan
- Default
--tls_certificate=<a string>
: lihat deskripsi - Tentukan jalur ke sertifikat TLS yang dipercaya untuk menandatangani sertifikat server.
- Default
--tls_client_certificate=<a string>
: lihat deskripsi - Tentukan sertifikat klien TLS yang akan digunakan; Anda juga harus menyediakan kunci klien untuk mengaktifkan autentikasi klien.
- Default
--tls_client_key=<a string>
: lihat deskripsi - Tentukan kunci klien TLS yang akan digunakan; Anda juga perlu 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 setidaknya satu, semua angka yang kurang dari 1 dipetakan ke 1.
Tag:terminal_output
- Default
--[no]watchfs
: "false" - Di Linux/macOS: Jika true (benar), bazel akan mencoba menggunakan layanan pemantauan file sistem operasi untuk perubahan lokal, bukan memindai setiap file untuk menemukan perubahan. Di Windows: flag ini saat ini tidak berfungsi, tetapi dapat diaktifkan bersama dengan --experimental_windows_watchfs. Di OS apa pun: Perilaku tidak ditentukan jika ruang kerja Anda berada di sistem file jaringan, dan file diedit di komputer jarak jauh.
Opsi Analyze-profile
- 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
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika ditetapkan, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Hal ini dimaksudkan untuk menghemat kapasitas disk.
Tag:bazel_internal_configuration
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi pada komputer yang lebih lambat daripada yang diharapkan oleh penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--[no]incompatible_disable_native_repo_rules
: "false" -
Jika salah, aturan repo native dapat digunakan di WORKSPACE; jika tidak, aturan repo Starlark harus digunakan. Aturan repo native mencakup local_repository, new_local_repository, local_config_platform, android_sdk_repository, dan android_ndk_repository.
Tag:bazel_internal_configuration
- Default
--repository_cache=<a path>
: lihat deskripsi -
Menentukan lokasi cache 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
- Default
--[no]repository_disable_download
: "false" -
Jika disetel, mendownload menggunakan ctx.download{,_and_extract} tidak diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file yang dapat dieksekusi arbitrer 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 tenur yang ditempati (0-100) dan di atas nilai tersebut GcThrashingDetector menganggap peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika disetel ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi yang terkait dengan output dan semantik 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 dideklarasikan dihapus di registry tempatnya berasal (jika tidak berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan kegagalan resolusi. Anda juga dapat menentukan versi yang ditarik yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel dari modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasinya ke kegagalan resolusi, `nonaktif` untuk menonaktifkan pemeriksaan, atau `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi.
Tag:loading_and_analysis
- Default
--check_direct_dependencies=<off, warning or error>
: "peringatan" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di modul root adalah versi yang sama dengan yang Anda dapatkan di grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `warning` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasinya ke kegagalan resolusi.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` di MODULE.bazel dari modul root. Perhatikan bahwa dependensi developer tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai tanda ini.
Tag:loading_and_analysis
- Default
--lockfile_mode=<off, update, refresh or error>
: "update" -
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `refresh` untuk memperbarui informasi yang dapat diubah (versi yang ditarik dan modul yang sebelumnya tidak ada) dari registry jarak jauh dari waktu ke waktu, `error` untuk menggunakan lockfile, tetapi menampilkan error jika tidak diperbarui, atau `off` untuk tidak membaca dari 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 <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutan ini penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
- Default
--vendor_dir=<a path>
: lihat deskripsi -
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalam atau menggunakannya saat mem-build. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
default: "1detik:2,20detik:3,1menit:5"-
Batas yang, jika tercapai, menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlahnya adalah bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang dengan masa berlaku (heap gen lama) tetap terisi setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan yang 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC minor terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat peristiwa GC minor terjadi dan nilai minimum 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 persentase heap yang dipertahankannya setidaknya mencapai nilai minimum ini, status Skyframe sementara yang tidak diperlukan akan dihapus. Menyesuaikan nilai ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari thrashing GC, ketika thrashing GC (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-
mengeluarkan dump data profil lengkap dalam format 'teks' yang dapat dibaca manusia atau format 'mentah' yang cocok untuk skrip.
Tag:affects_outputs
- Default
--experimental_command_profile=<cpu, wall, alloc or lock>
: lihat deskripsi - Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alloc, atau lock) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama sesuai jenis peristiwa di direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah pada masa mendatang untuk mendukung jenis profil atau format output tambahan; gunakan dengan risiko Anda sendiri.
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemoni dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemoni.
- Opsi yang menentukan atau mengubah input umum untuk perintah Bazel yang tidak termasuk dalam kategori lain.:
- Default
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Jika tidak kosong, baca file terselesaikan yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi cache dan eksekusi jarak jauh:
- Default
--experimental_downloader_config=<a string>
: lihat deskripsi - Menentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris-baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti oleh nama host (untuk `izinkan` dan `block`) atau dua pola, satu untuk dicocokkan, dan satu lagi untuk digunakan sebagai URL pengganti, dengan referensi kembali mulai dari `$1`. Ada kemungkinan beberapa perintah `rewrite` untuk URL yang sama akan diberikan, dan dalam hal ini beberapa URL akan diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
- Default
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Mode thread yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dihentikan. Jika tidak, gunakan thread pekerja virtual.
- Opsi lainnya, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
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
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika disetel, cache repositori akan melakukan hardlink pada file jika cache ditemukan, bukan menyalinnya. Tindakan ini dimaksudkan untuk menghemat kapasitas disk.
Tag:bazel_internal_configuration
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi pada komputer yang lebih lambat daripada yang diharapkan oleh penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--[no]incompatible_disable_native_repo_rules
: "false" -
Jika salah, aturan repo native dapat digunakan di WORKSPACE; jika tidak, aturan repo Starlark harus digunakan. Aturan repo native mencakup local_repository, new_local_repository, local_config_platform, android_sdk_repository, dan android_ndk_repository.
Tag:bazel_internal_configuration
- Default
--repository_cache=<a path>
: lihat deskripsi -
Menentukan lokasi cache 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
- Default
--[no]repository_disable_download
: "false" -
Jika ditetapkan, download menggunakan ctx.download{,_and_extract} tidak diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file yang dapat dieksekusi arbitrer 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 dengan masa berlaku yang terisi (0-100) yang di atas batasnya GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika disetel ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi yang terkait dengan output dan semantik kueri:
- Default
--aspect_deps=<off, conservative or precise>
: "konservatif" -
Cara me-resolve dependensi aspek saat format output adalah salah satu dari {xml,proto,record}. 'nonaktif' berarti tidak ada dependensi aspek yang di-resolve, 'konservatif' (default) berarti semua dependensi aspek yang dideklarasikan ditambahkan terlepas dari apakah dependensi tersebut diberi class aturan dependensi langsung, 'akurat' berarti hanya aspek yang mungkin aktif yang ditambahkan dengan class aturan dependensi langsung. Perhatikan bahwa mode presisi memerlukan pemuatan paket lain untuk mengevaluasi satu target sehingga membuatnya lebih lambat daripada mode lainnya. Perhatikan juga bahwa mode presisi pun tidak sepenuhnya presisi: keputusan apakah akan menghitung aspek atau tidak diputuskan dalam fase analisis, yang tidak dijalankan selama 'kueri bazel'.
Tag:build_file_semantics
- Default
--[no]consistent_labels
: "false" -
Jika diaktifkan, setiap perintah kueri akan menampilkan label seolah-olah oleh fungsi Starlark <code>str</code> yang diterapkan ke instance <code>Label</code>. Hal ini berguna untuk alat yang perlu mencocokkan output dari berbagai perintah kueri dan/atau label yang dikeluarkan oleh aturan. Jika tidak diaktifkan, pemformat output bebas memunculkan nama repositori yang jelas (relatif terhadap repositori utama), sehingga membuat output lebih mudah dibaca.
Tag:terminal_output
- Default
--[no]experimental_explicit_aspects
: "false" -
aquery, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: no-op (aspek selalu diikuti).
Tag:terminal_output
--[no]graph:factored
default: "true"-
Jika benar, grafik akan dimunculkan 'difaktorkan', yaitu node yang setara secara topologi akan digabungkan dan labelnya 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 terpotong; -1 berarti tidak ada pemotongan. Opsi ini hanya berlaku untuk --output=graph.
Tag:terminal_output
- Default
--[no]implicit_deps
: "true" -
Jika diaktifkan, dependensi implisit akan disertakan dalam grafik dependensi tempat kueri beroperasi. Dependensi implisit adalah dependensi yang tidak ditentukan 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"-
Menyertakan nama input dan output tindakan dalam output (berpotensi besar).
Tag:terminal_output
--[no]include_aspects
default: "true"-
query, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: no-op (aspek selalu diikuti).
Tag:terminal_output
- Default
--[no]include_commandline
: "true" -
Menyertakan konten baris perintah tindakan dalam output (berpotensi besar).
Tag:terminal_output
- Default
--[no]include_file_write_contents
: "false" -
Menyertakan konten file untuk tindakan FileWrite, SourceSymlinkManifest, dan RepoMappingManifest (kemungkinan besar).
Tag:terminal_output
- Default
--[no]include_param_files
: "false" -
Sertakan konten file parameter yang digunakan dalam perintah (kemungkinan besar). Catatan: Mengaktifkan flag ini akan otomatis mengaktifkan flag --include_commandline.
Tag:terminal_output
- Default
--[no]incompatible_package_group_includes_double_slash
: "true" -
Jika diaktifkan, saat menampilkan atribut `packages` package_group, `//` di awal tidak akan dihilangkan.
Tag:terminal_output
,incompatible_change
- Default
--[no]infer_universe_scope
: "false" -
Jika disetel dan --universe_scope tidak disetel, 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 Anda hanya boleh menggunakan opsi ini 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
- Default
--[no]line_terminator_null
: "false" -
Apakah setiap format diakhiri 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 untuk atribut "nodep" adalah "visibilitas". Jalankan dan uraikan output `info build-language` untuk mempelajari semua atribut "nodep" dalam bahasa build.
Tag:build_file_semantics
- Default
--output=<a string>
: "text" -
Format tempat hasil kueri akan dicetak. Nilai yang diizinkan untuk kueri adalah: text, textproto, proto, livestream_proto, jsonproto.
Tag:terminal_output
- Default
--[no]proto:default_values
: "true" -
Jika benar, atribut yang nilainya tidak ditentukan secara eksplisit dalam file BUILD akan disertakan; jika tidak, atribut akan dihilangkan. Opsi ini berlaku untuk --output=proto
Tag:terminal_output
- Default
--[no]proto:definition_stack
: "false" -
Isi kolom proto definition_stack, yang mencatat untuk setiap instance aturan, stack panggilan Starlark pada saat class aturan ditentukan.
Tag:terminal_output
- Default
--[no]proto:flatten_selects
: "true" -
Jika diaktifkan, atribut yang dapat dikonfigurasi yang dibuat oleh select() akan diratakan. Untuk jenis daftar, representasi yang diratakan adalah daftar yang berisi setiap nilai peta yang dipilih tepat sekali. Jenis skalar diratakan menjadi null.
Tag:build_file_semantics
- Default
--[no]proto:include_attribute_source_aspects
: "false" -
Isi kolom proto source_aspect_name dari setiap Atribut dengan aspek sumber asal atribut (string kosong jika tidak ada).
Tag:terminal_output
- Default
--[no]proto:include_synthetic_attribute_hash
: "false" -
Apakah akan menghitung dan mengisi atribut $internal_attr_hash atau tidak.
Tag:terminal_output
- Default
--[no]proto:instantiation_stack
: "false" -
Isi stack panggilan pembuatan instance dari setiap aturan. Perhatikan bahwa hal ini mengharuskan stack tersedia
Tag:terminal_output
- Default
--[no]proto:locations
: "true" -
Apakah akan menampilkan informasi lokasi dalam output proto atau tidak.
Tag:terminal_output
- Default
--proto:output_rule_attrs=<comma-separated list of options>
: "semua" -
Daftar atribut yang dipisahkan koma untuk disertakan dalam output. Setelan defaultnya adalah semua atribut. Tetapkan ke string kosong agar tidak menampilkan atribut apa pun. Opsi ini berlaku untuk --output=proto.
Tag:terminal_output
- Default
--[no]proto:rule_inputs_and_outputs
: "true" -
Apakah akan mengisi kolom rule_input dan rule_output atau tidak.
Tag:terminal_output
- Default
--query_file=<a string>
: "" -
Jika ditetapkan, kueri akan membaca kueri dari file bernama di sini, bukan pada command line. Menentukan file di sini serta kueri command line akan menyebabkan error.
Tag:changes_inputs
- Default
--[no]relative_locations
: "false" -
Jika 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 menetapkan opsi ini ke true untuk mendapatkan hasil yang konsisten di seluruh komputer.
Tag:terminal_output
- Default
--[no]skyframe_state
: "false" -
Tanpa melakukan analisis tambahan, buang Action Graph 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
- Default
--[no]tool_deps
: "true" -
Kueri: Jika dinonaktifkan, dependensi pada 'konfigurasi exec' tidak akan disertakan dalam grafik dependensi tempat kueri beroperasi. Edge dependensi 'konfigurasi exec', 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, akan memfilter semua target yang dikonfigurasi yang melintasi transisi eksekusi dari target tingkat teratas yang menemukan target yang dikonfigurasi ini. Artinya, jika target tingkat atas berada dalam konfigurasi target, hanya target yang dikonfigurasi juga dalam konfigurasi target yang akan ditampilkan. Jika target tingkat teratas berada dalam konfigurasi exec, hanya target yang dikonfigurasi exec yang akan ditampilkan. Opsi ini TIDAK akan mengecualikan toolchain yang telah di-resolve.
Tag:build_file_semantics
- Default
--universe_scope=<comma-separated list of options>
: "" -
Kumpulan pola target yang dipisahkan koma (aditif dan subtraktif). Kueri dapat dilakukan di alam semesta yang ditentukan oleh penutupan transitif target yang ditentukan. Opsi ini digunakan untuk perintah kueri dan kueri.
Untuk kueri, input ke opsi ini adalah target tempat semua jawaban dibuat, sehingga opsi ini dapat memengaruhi konfigurasi dan transisi. Jika opsi ini tidak ditentukan, target tingkat atas diasumsikan sebagai target yang diuraikan dari ekspresi kueri. Catatan: Untuk cquery, tidak menentukan opsi ini dapat menyebabkan build rusak jika target yang diuraikan dari ekspresi kueri tidak dapat dibuat dengan opsi tingkat atas.
Tag:loading_and_analysis
- Opsi yang terkait dengan output dan semantik 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 dideklarasikan dihapus di registry tempatnya berasal (jika tidak berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang ditarik yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Memeriksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasinya ke kegagalan resolusi, `nonaktif` untuk menonaktifkan pemeriksaan, atau `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi.
Tag:loading_and_analysis
- Default
--check_direct_dependencies=<off, warning or error>
: "peringatan" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di modul root adalah versi yang sama dengan yang Anda dapatkan di grafik dependensi yang di-resolve. Nilai yang valid adalah `nonaktif` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasinya ke kegagalan resolusi.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi developer tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai tanda ini.
Tag:loading_and_analysis
- Default
--lockfile_mode=<off, update, refresh or error>
: "update" -
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan mengupdatenya jika ada perubahan, `refresh` untuk memuat ulang informasi yang dapat diubah (versi yang ditarik dan modul yang sebelumnya tidak ada) dari registry jarak jauh dari waktu ke waktu, `error` untuk menggunakan file kunci, tetapi menampilkan error jika tidak terbaru, atau `off` untuk tidak membaca dari atau menulis ke file kunci.
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 <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut akan sesuai dengan direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutan ini penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
- Default
--vendor_dir=<a path>
: lihat deskripsi -
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalam atau menggunakannya saat mem-build. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
default: "1detik:2,20detik:3,1menit:5"-
Batas yang, jika tercapai, menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan period adalah durasi dan count adalah bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang dengan masa berlaku (heap gen lama) tetap terisi setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat 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 diperlukan akan dihapus hingga berkali-kali per panggilan. Default-nya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat peristiwa GC minor terjadi dan nilai minimum 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 penggunaan persentase heap yang dipertahankan setidaknya pada batas ini, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan. Dengan menyesuaikan hal ini, Anda dapat mengurangi dampak waktu berjalan dari thrashing GC, jika thrashing GC (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada merekonstruksi status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
- Default
--experimental_command_profile=<cpu, wall, alloc or lock>
: lihat deskripsi - Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alloc, atau lock) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama sesuai jenis peristiwa di direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah pada masa mendatang untuk mendukung jenis profil atau format output tambahan; gunakan dengan risiko Anda sendiri.
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemoni dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemoni.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
- Default
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Jika tidak kosong, baca file yang di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan penyimpanan dalam cache jarak jauh:
- Default
--experimental_downloader_config=<a string>
: lihat deskripsi - Menentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris-baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti oleh nama host (untuk `izinkan` dan `block`) atau dua pola, satu untuk dicocokkan, dan satu lagi untuk digunakan sebagai URL pengganti, dengan referensi kembali mulai dari `$1`. Ada kemungkinan beberapa perintah `rewrite` untuk URL yang sama akan diberikan, dan dalam hal ini beberapa URL akan diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
- Default
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Mode thread yang akan digunakan untuk pengambilan repo. Jika disetel ke 'off', tidak ada thread pekerja yang akan digunakan, dan pengambilan repo dapat dimulai ulang. Jika tidak, gunakan thread pekerja virtual.
- Opsi lainnya, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
- Opsi yang mengontrol eksekusi build:
- Default
--[no]experimental_inprocess_symlink_creation
: "false" -
Apakah akan membuat panggilan sistem file langsung untuk membuat hierarki symlink
Tag:loading_and_analysis
,execution
,experimental
- Default
--[no]experimental_persistent_aar_extractor
: "false" -
Aktifkan ekstraktor aar persisten menggunakan pekerja.
Tag:execution
- Default
--[no]experimental_remotable_source_manifests
: "false" -
Apakah akan membuat tindakan manifes sumber dapat diakses dari jarak jauh
Tag:loading_and_analysis
,execution
,experimental
- Default
--[no]experimental_split_coverage_postprocessing
: "false" -
Jika benar, Bazel akan menjalankan pascapemrosesan cakupan untuk pengujian dalam spawn baru.
Tag:execution
- Default
--[no]experimental_strict_fileset_output
: "false" -
Jika opsi ini diaktifkan, kumpulan file akan memperlakukan semua artefak output sebagai file biasa. Perintah ini tidak akan menjelajahi direktori atau sensitif terhadap symlink.
Tag:execution
- Default
--[no]incompatible_disallow_unsound_directory_outputs
: "true" -
Jika ditetapkan, tindakan untuk mewujudkan file output sebagai direktori akan mengalami error. Tidak memengaruhi direktori sumber. Lihat https://github.com/bazelbuild/bazel/issues/18646.
Tag:bazel_internal_configuration
,incompatible_change
- Default
--[no]incompatible_modify_execution_info_additive
: "false" -
Saat diaktifkan, penerusan beberapa tanda --modify_execution_info akan menjadi tambahan. Jika dinonaktifkan, hanya tanda terakhir yang akan dipertimbangkan.
Tag:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
beberapa penggunaan diakumulasikan-
Menambahkan atau menghapus kunci dari info eksekusi tindakan berdasarkan mnemoni 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 ekspresi reguler yang dapat diterapkan ke mnemoni yang sama.
Sintaksis: "regex=[+-]key,regex=[+-]key,...".
Contoh:
'.*=+x,.*=-y,.*=+z' menambahkan 'x' dan 'z' ke, dan menghapus 'y' dari, info eksekusi untuk semua tindakan.
'Genrule=+requires-x' menambahkan 'requires-x' ke info eksekusi untuk semua tindakan Genrule.
'(?!Genrule).*=-requires-x' menghapus 'requires-x' dari info eksekusi untuk semua tindakan non-Genrule.
Tag:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Mengaktifkan tindakan dex dan desugar Android persisten menggunakan pekerja.
Diperluas menjadi:
--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.
Diperluas menjadi:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
Tag:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Mengaktifkan tindakan dex dan desugar Android multipleks 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
-
Mengaktifkan 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
-
Mengaktifkan alat Android persisten dan multipleks (dexing, desugaring, pemrosesan resource).
Diperluas menjadi:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Tag:host_machine_resource_optimizations
,execution
- Default
--[no]use_target_platform_for_tests
: "false" -
Jika true (benar), Bazel akan menggunakan platform target untuk menjalankan pengujian, bukan grup exec pengujian.
Tag:execution
- Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
- Default
--android_compiler=<a string>
: 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
- Default
--android_grte_top=<a label>
: lihat deskripsi -
Target Android grte_top.
Tag:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Default
--android_manifest_merger=<legacy, android or force_android>
: "android" -
Memilih penggabungan manifes yang akan digunakan untuk aturan android_binary. Flag untuk membantu transisi ke penggabungan manifes Android dari penggabungan lama.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--android_platforms=<a build target label>
: "" -
Menetapkan platform yang digunakan target android_binary. Jika beberapa platform ditentukan, maka binernya 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 Android SDK/platform 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
- Default
--cc_output_directory_tag=<a string>
: "" -
Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.
Tag:affects_outputs
- Default
--compiler=<a string>
: 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. Grup file saat ini harus berupa grup file yang berisi satu file, yaitu biner. Defaultnya 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 ini 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. Setelan defaultnya adalah '//tools/test:coverage_support'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
default: "@bazel_tools//tools/cpp:toolchain"-
Label paket crosstool yang akan digunakan untuk mengompilasi kode C++.
Tag:loading_and_analysis
,changes_inputs
,affects_outputs
- Default
--custom_malloc=<a build target label>
: lihat deskripsi -
Menentukan implementasi malloc kustom. Setelan ini menggantikan atribut malloc 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, yang masing-masing secara opsional 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 apa pun di //demo kecuali target yang namanya berisi 'test'.
Tag:loading_and_analysis
- Default
--[no]experimental_include_xcode_execution_requirements
: "false" -
Jika ditetapkan, tambahkan persyaratan eksekusi "requires-xcode:{version}" ke setiap tindakan Xcode. Jika versi xcode memiliki label dengan tanda hubung, tambahkan juga persyaratan eksekusi "requires-xcode-label:{version_label}".
Tag:loses_incremental_state
,loading_and_analysis
,execution
- Default
--[no]experimental_prefer_mutual_xcode
: "true" -
Jika benar, gunakan Xcode terbaru yang tersedia secara lokal dan jarak jauh. Jika salah, atau jika tidak ada versi yang tersedia secara bersama, gunakan versi Xcode lokal yang dipilih melalui xcode-select.
Tag:loses_incremental_state
- Default
--extra_execution_platforms=<comma-separated list of options>
: "" -
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 dinyatakan dalam file WORKSPACE oleh register_execution_platforms(). Opsi ini hanya dapat ditetapkan sekali; instance berikutnya akan menggantikan 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
- Default
--grte_top=<a label>
: lihat deskripsi -
Label ke library libc yang di-check in. Nilai default dipilih oleh toolchain crosstool, dan Anda hampir tidak pernah perlu menggantinya.
Tag:action_command_lines
,affects_outputs
- Default
--host_compiler=<a string>
: lihat deskripsi -
Compiler C++ yang akan digunakan untuk kompilasi host. Nilai ini akan diabaikan jika --host_crosstool_top tidak ditetapkan.
Tag:loading_and_analysis
,execution
- Default
--host_crosstool_top=<a build target label>
: lihat deskripsi -
Secara default, opsi --crosstool_top dan --compiler juga digunakan untuk konfigurasi exec. Jika flag ini disediakan, Bazel akan menggunakan libc dan compiler default untuk crosstool_top yang diberikan.
Tag:loading_and_analysis
,changes_inputs
,affects_outputs
- Default
--host_grte_top=<a label>
: lihat deskripsi -
Jika ditentukan, setelan ini akan menggantikan direktori tingkat atas libc (--grte_top) untuk konfigurasi exec.
Tag:action_command_lines
,affects_outputs
--host_platform=<a build target label>
default: "@bazel_tools//tools:host_platform"-
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 Android SDK untuk aturan Android (Starlark dan native)
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_enable_apple_toolchain_resolution
: "false" -
Gunakan resolusi toolchain untuk memilih Apple SDK untuk aturan apple (Starlark dan native)
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
default: "true"-
Jika benar, Bazel tidak akan menggunakan kembali command line tindakan link C++ untuk command line pengindeksan lto (lihat https://github.com/bazelbuild/bazel/issues/6791 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_remove_legacy_whole_archive
: "true" -
Jika benar, Bazel tidak akan menautkan dependensi library sebagai seluruh arsip secara default (lihat https://github.com/bazelbuild/bazel/issues/7362 untuk mengetahui petunjuk migrasi).
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_require_ctx_in_configure_features
: "true" -
Jika benar, Bazel akan mewajibkan parameter 'ctx' ke cc_common.configure_features (lihat https://github.com/bazelbuild/bazel/issues/7793 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,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
- Default
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Menentukan versi iOS SDK yang akan digunakan untuk mem-build aplikasi iOS. Jika tidak ditentukan, gunakan versi SDK iOS default dari 'xcode_version'.
Tag:loses_incremental_state
- Default
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Menentukan versi macOS SDK yang akan digunakan untuk mem-build aplikasi macOS. Jika tidak ditentukan, gunakan versi macOS SDK default dari 'xcode_version'.
Tag:loses_incremental_state
- Default
--minimum_os_version=<a string>
: lihat deskripsi -
Versi OS minimum yang ditargetkan kompilasi Anda.
Tag:loading_and_analysis
,affects_outputs
- Default
--platform_mappings=<a relative path>
: "" - Lokasi file pemetaan yang menjelaskan platform mana yang akan digunakan jika tidak ada yang ditetapkan atau flag mana yang akan ditetapkan jika platform sudah ada. Harus relatif dengan root ruang kerja utama. Secara default, 'platform_mappings' (file langsung di bawah root ruang kerja).
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
- Default
--platforms=<a build target label>
: "" -
Label aturan platform yang menjelaskan platform target untuk perintah saat ini.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
- Default
--python2_path=<a string>
: lihat deskripsi -
Tidak digunakan lagi, tanpa pengoperasian. Dinonaktifkan oleh `--incompatible_use_python_ toolchains`.
Tag:no_op
,deprecated
- Default
--python3_path=<a string>
: lihat deskripsi -
Tidak digunakan lagi, tidak ada operasi. Dinonaktifkan oleh `--incompatible_use_python_toolchains`.
Tag:no_op
,deprecated
- Default
--python_path=<a string>
: lihat deskripsi -
Jalur absolut dari 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
- Default
--python_top=<a build target label>
: 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
- Default
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Menentukan versi tvOS SDK yang akan digunakan untuk membuat aplikasi tvOS. Jika tidak ditentukan, gunakan versi tvOS SDK default dari 'xcode_version'.
Tag:loses_incremental_state
- Default
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Menentukan versi SDK watchOS yang akan digunakan untuk membuat aplikasi watchOS. Jika tidak ditentukan, gunakan versi watchOS SDK default dari 'xcode_version'.
Tag:loses_incremental_state
- Default
--xcode_version=<a string>
: lihat deskripsi -
Jika ditentukan, menggunakan Xcode versi tertentu untuk tindakan build yang relevan. Jika tidak ditentukan, akan menggunakan versi default Xcode dari eksekutor.
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 dalam konfigurasi build.
Tag:loses_incremental_state
,loading_and_analysis
- Opsi yang mengontrol output perintah:
- Default
--[no]apple_generate_dsym
: "false" -
Apakah akan menghasilkan file simbol debug (.dSYM).
Tag:affects_outputs
,action_command_lines
- Default
--[no]build_runfile_links
: "true" -
Jika benar, build hutan symlink runfile untuk semua target. Jika salah (false), tulis hanya jika diperlukan oleh tindakan lokal, pengujian, atau perintah run.
Tag:affects_outputs
- Default
--[no]build_runfile_manifests
: "true" -
Jika benar, tulis manifes runfile untuk semua target. Jika salah (false), hapus. Pengujian lokal akan gagal dijalankan jika bernilai salah.
Tag:affects_outputs
- Default
--[no]build_test_dwp
: "false" -
Jika diaktifkan, saat mem-build pengujian C++ secara statis dan dengan fission, file .dwp untuk biner pengujian juga akan otomatis di-build.
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 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
- Default
--[no]experimental_proto_descriptor_sets_include_source_info
: "false" -
Menjalankan tindakan tambahan untuk versi API Java alternatif di proto_library.
Tag:affects_outputs
,loading_and_analysis
,experimental
- Default
--[no]experimental_proto_extra_actions
: "false" -
Menjalankan tindakan tambahan untuk versi API Java alternatif di proto_library.
Tag:affects_outputs
,loading_and_analysis
,experimental
- Default
--[no]experimental_save_feature_state
: "false" -
Menyimpan status fitur yang diaktifkan dan diminta sebagai output kompilasi.
Tag:affects_outputs
,experimental
- Default
--fission=<a set of compilation modes>
: "no" -
Menentukan mode kompilasi yang menggunakan fiksi untuk kompilasi dan link C++. Dapat berupa kombinasi dari {'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
- Default
--[no]incompatible_always_include_files_in_data
: "true" -
Jika 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_avoid).
Tag:affects_outputs
,incompatible_change
- Default
--[no]legacy_external_runfiles
: "true" -
Jika benar, build hutan symlink runfile untuk repositori eksternal di .runfiles/wsname/external/repo (selain .runfiles/repo).
Tag:affects_outputs
- Default
--[no]objc_generate_linkmap
: "false" -
Menentukan apakah akan membuat file linkmap.
Tag:affects_outputs
- Default
--[no]save_temps
: "false" -
Jika ditetapkan, output sementara dari gcc akan disimpan. Ini termasuk 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, yang 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 ditentukan berdasarkan nama, dalam hal ini nilai akan diambil dari lingkungan pemanggilan, atau dengan pasangan name=value yang menetapkan nilai secara independen dari lingkungan pemanggilan. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru akan digunakan, sedangkan opsi untuk variabel yang berbeda akan diakumulasikan.
Tag:action_command_lines
- Default
--android_cpu=<a string>
: "armeabi-v7a" -
CPU target Android.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--[no]android_databinding_use_androidx
: "true" -
Buat file data binding yang kompatibel dengan AndroidX. Ini hanya digunakan dengan databinding v2. Flag ini tidak melakukan operasi apa pun.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]android_databinding_use_v3_4_args
: "true" -
Gunakan android databinding v2 dengan argumen 3.4.0. Flag ini tidak melakukan operasi apa pun.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--android_dynamic_mode=<off, default or fully>
: "nonaktif" -
Menentukan apakah dependensi C++ dari aturan Android akan ditautkan secara dinamis saat cc_binary tidak membuat library bersama secara eksplisit. 'default' berarti bazel akan memilih apakah akan menautkan secara dinamis atau tidak. 'sepenuhnya' berarti semua library akan ditautkan secara dinamis. 'nonaktif' berarti semua library akan ditautkan dalam mode statis.
Tag:affects_outputs
,loading_and_analysis
- Default
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "alphabetical" -
Menetapkan urutan manifes yang diteruskan ke penggabungan manifes untuk biner Android. ALPHABETICAL berarti manifes diurutkan berdasarkan jalur relatif terhadap execroot. ALPHABETICAL_BY_CONFIGURATION berarti manifes diurutkan berdasarkan jalur yang relatif terhadap direktori konfigurasi dalam direktori output. DEPENDENCY berarti manifes diurutkan dengan manifes setiap library yang muncul sebelum manifes dependensinya.
Tag:action_command_lines
,execution
- Default
--[no]android_resource_shrinking
: "false" -
Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]build_python_zip
: "otomatis" -
Mem-build zip yang dapat dieksekusi python; aktif di Windows, nonaktif di platform lain
Tag:affects_outputs
--catalyst_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk mem-build biner Apple Catalyst.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--[no]collect_code_coverage
: "false" -
Jika ditentukan, Bazel akan melengkapi kode (menggunakan instrumentasi offline jika memungkinkan) dan akan mengumpulkan informasi cakupan selama pengujian. Hanya target yang cocok dengan --instrumentation_filter yang akan terpengaruh. Biasanya, opsi ini tidak boleh ditentukan secara langsung - perintah 'bazel coverage' harus digunakan.
Tag:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] default: "fastbuild"-
Menentukan mode tempat biner akan dibuat. 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 yang akan diteruskan ke gcc.
Tag:action_command_lines
,affects_outputs
- Default
--cpu=<a string>
: "" -
CPU target.
Tag:changes_inputs
,affects_outputs
- Default
--cs_fdo_absolute_path=<a string>
: lihat deskripsi -
Gunakan 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
- Default
--cs_fdo_instrument=<a string>
: lihat deskripsi -
Buat biner dengan instrumentasi FDO yang sensitif terhadap konteks. Dengan compiler Clang/LLVM, compiler ini juga menerima nama direktori tempat file profil mentah akan dibuang saat runtime.
Tag:affects_outputs
- Default
--cs_fdo_profile=<a build target label>
: 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.
Tag:changes_inputs
,affects_outputs
- Default
--dynamic_mode=<off, default or fully>
: "default" -
Menentukan apakah biner C++ akan ditautkan secara dinamis. 'default' berarti Bazel akan memilih apakah akan menautkan secara dinamis. 'sepenuhnya' berarti semua library akan ditautkan secara dinamis. 'nonaktif' berarti semua library akan ditautkan dalam mode statis.
Tag:loading_and_analysis
,affects_outputs
- Default
--[no]enable_fdo_profile_absolute_path
: "true" -
Jika ditetapkan, penggunaan fdo_absolute_profile_path akan menimbulkan error.
Tag:affects_outputs
- Default
--[no]enable_runfiles
: "otomatis" -
Mengaktifkan hierarki symlink runfiles; Secara default, fitur ini dinonaktifkan di Windows dan di platform lain.
Tag:affects_outputs
--experimental_action_listener=<a build target label>
beberapa penggunaan diakumulasikan-
Tidak digunakan lagi dan digantikan dengan aspek. Gunakan action_listener untuk melampirkan extra_action ke tindakan build yang ada.
Tag:execution
,experimental
- Default
--[no]experimental_android_compress_java_resources
: "false" -
Mengompresi resource Java dalam APK
Tag:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
default: "true"-
Gunakan android databinding v2. Flag ini tidak melakukan operasi apa pun.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]experimental_android_resource_shrinking
: "false" -
Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_android_rewrite_dexes_with_rex
: "false" -
menggunakan alat rex untuk menulis ulang file dex
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]experimental_collect_code_coverage_for_generated_files
: "false" -
Jika ditentukan, Bazel juga akan membuat informasi cakupan untuk file yang dihasilkan.
Tag:affects_outputs
- Default
--experimental_objc_fastbuild_options=<comma-separated list of options>
: "-O0,-DDEBUG=1" -
Menggunakan string ini sebagai opsi compiler fastbuild objc.
Tag:action_command_lines
- Default
--[no]experimental_omitfp
: "false" -
Jika benar, gunakan libunwind untuk unwinding stack, dan kompilasi dengan -fomit-frame-pointer dan -fasynchronous-unwind-tables.
Tag:action_command_lines
,affects_outputs
,experimental
- Default
--experimental_output_paths=<off, content or strip>
: "nonaktif" -
Model mana yang akan digunakan untuk tempat aturan hierarki output menulis outputnya, terutama untuk build multi-platform / multi-konfigurasi. Fitur ini sangat eksperimental. Lihat https://github.com/bazelbuild/bazel/issues/6526 untuk mengetahui detailnya. Tindakan Starlark dapat memilih untuk menggunakan pemetaan jalur dengan menambahkan kunci 'supports-path-mapping' ke kamus '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 dalam bentuk label=value dengan label merujuk ke platform dan nilai adalah nama singkat yang diinginkan untuk digunakan di jalur output. Hanya digunakan jika --experimental_platform_in_output_dir benar. Memiliki prioritas penamaan tertinggi.
Tag:affects_outputs
,experimental
- Default
--[no]experimental_platform_in_output_dir
: "false" -
Jika benar, nama singkat untuk platform target akan digunakan dalam nama direktori output, bukan CPU. Skema yang tepat bersifat eksperimental dan dapat berubah: Pertama, dalam kasus yang jarang terjadi, opsi --platforms tidak memiliki tepat satu nilai, hash opsi platform akan digunakan. Selanjutnya, jika nama singkat untuk platform saat ini terdaftar oleh --experimental_override_name_platform_in_output_dir, nama singkat tersebut akan digunakan. Kemudian, jika --experimental_use_platforms_in_output_dir_legacy_heuristic ditetapkan, gunakan nama singkat berdasarkan Label platform saat ini. Terakhir, hash opsi platform digunakan sebagai upaya terakhir.
Tag:affects_outputs
,experimental
- Default
--[no]experimental_use_llvm_covmap
: "false" -
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
- Default
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
: "true" -
Hanya gunakan tanda ini sebagai bagian dari strategi pengujian atau migrasi yang disarankan. Perhatikan bahwa heuristik memiliki kekurangan yang diketahui dan sebaiknya bermigrasi untuk mengandalkan --experimental_override_name_platform_in_output_dir saja.
Tag:affects_outputs
,experimental
- Default
--fat_apk_cpu=<comma-separated set of options>
: "armeabi-v7a" -
Menetapkan opsi ini akan mengaktifkan fat APK, yang berisi biner native untuk semua arsitektur target yang ditentukan, misalnya, --fat_apk_cpu=x86,armeabi-v7a. Jika flag ini ditentukan, --android_cpu akan diabaikan untuk dependensi aturan android_binary.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--[no]fat_apk_hwasan
: "false" -
Apakah akan membuat pemisahan HWASAN.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--fdo_instrument=<a string>
: lihat deskripsi -
Buat biner dengan instrumentasi FDO. Dengan compiler Clang/LLVM, compiler ini juga menerima nama direktori tempat file profil mentah akan di-dump saat runtime.
Tag:affects_outputs
- Default
--fdo_optimize=<a string>
: 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. Flag ini juga menerima file yang ditentukan sebagai label (misalnya, `//foo/bar:file.afdo` - Anda mungkin perlu menambahkan perintah `exports_files` ke paket yang sesuai) dan label yang mengarah ke target `fdo_profile`. Flag ini akan diganti oleh aturan `fdo_profile`.
Tag:affects_outputs
- Default
--fdo_prefetch_hints=<a build target label>
: lihat deskripsi -
Menggunakan petunjuk pengambilan data cache.
Tag:affects_outputs
- Default
--fdo_profile=<a build target label>
: 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 tersebut. Fitur negatif selalu menggantikan fitur positif. Lihat juga --host_features
Tag:changes_inputs
,affects_outputs
- Default
--[no]force_pic
: "false" -
Jika diaktifkan, semua kompilasi C++ akan menghasilkan kode yang tidak bergantung pada posisi ("-fPIC"), link lebih memilih library bawaan PIC daripada library non-PIC, dan link akan menghasilkan file yang dapat dieksekusi yang tidak bergantung pada 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 ditentukan berdasarkan nama, dalam hal ini nilai akan diambil dari lingkungan pemanggilan, atau dengan pasangan name=value yang menetapkan nilai secara independen dari lingkungan pemanggilan. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, yang terakhir menang, akumulasi opsi untuk berbagai variabel.
Tag:action_command_lines
- Default
--host_compilation_mode=<fastbuild, dbg or opt>
: "opt" -
Tentukan mode yang akan digunakan alat selama 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 untuk diteruskan ke compiler C untuk alat yang dibuat dalam konfigurasi exec.
Tag:action_command_lines
,affects_outputs
- Default
--host_cpu=<a string>
: "" -
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 di-build 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 di-build dalam konfigurasi exec. Menentukan -<feature> akan menonaktifkan fitur tersebut. Fitur negatif selalu menggantikan fitur positif.
Tag:changes_inputs
,affects_outputs
- Default
--host_force_python=<PY2 or PY3>
: 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 exec.
Tag:action_command_lines
,affects_outputs
- Default
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi macOS minimum yang kompatibel untuk target host. Jika tidak ditentukan, gunakan 'macos_sdk_version'.
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. Sintaksis: regex_filter@option_1,option_2,...,option_n. Dengan regex_filter adalah daftar pola ekspresi reguler yang disertakan dan dikecualikan (Lihat juga --instrumentation_filter). option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus diapit dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ pertama yang 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
--host_swiftcopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke swiftc untuk alat exec.
Tag:action_command_lines
,affects_outputs
- Default
--[no]incompatible_auto_exec_groups
: "false" -
Jika diaktifkan, grup eksekusi akan otomatis dibuat untuk setiap toolchain yang digunakan oleh aturan. Agar aturan ini berfungsi, aturan harus menentukan parameter `toolchain` pada tindakannya. Untuk mengetahui informasi selengkapnya, lihat https://github.com/bazelbuild/bazel/issues/17134.
Tag:affects_outputs
,incompatible_change
- Default
--[no]incompatible_merge_genfiles_directory
: "true" -
Jika true, direktori genfiles akan digabungkan ke dalam direktori bin.
Tag:affects_outputs
,incompatible_change
--[no]incompatible_use_host_features
default: "true"-
Jika benar, gunakan --features hanya untuk konfigurasi target dan --host_features untuk konfigurasi exec.
Tag:changes_inputs
,affects_outputs
,incompatible_change
- Default
--[no]instrument_test_targets
: "false" -
Saat cakupan diaktifkan, menentukan apakah akan mempertimbangkan untuk melakukan instrumentasi pada aturan pengujian. 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 diinstrumentasi. Aturan yang diawali dengan '-' akan dikecualikan. Perhatikan bahwa hanya aturan non-pengujian yang diinstrumentasikan, kecuali jika --instrument_test_targets diaktifkan.
Tag:affects_outputs
- Default
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi iOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'ios_sdk_version'.
Tag:loses_incremental_state
--ios_multi_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk mem-build ios_application. Hasilnya adalah biner universal yang berisi semua arsitektur yang ditentukan.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--[no]legacy_whole_archive
: "true" -
Tidak digunakan lagi, diganti dengan --incompatible_remove_legacy_whole_archive (lihat https://github.com/bazelbuild/bazel/issues/7362 untuk mengetahui detailnya). Jika 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 penautan.
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 (di bagian --features=thin_lto).
Tag:action_command_lines
,affects_outputs
--macos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk mem-build biner Apple macOS.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi macOS minimum yang kompatibel untuk target. Jika tidak ditentukan, gunakan 'macos_sdk_version'.
Tag:loses_incremental_state
- Default
--memprof_profile=<a build target label>
: lihat deskripsi -
Gunakan profil memprof.
Tag:affects_outputs
- Default
--[no]objc_debug_with_GLIBCXX
: "false" -
Jika kebijakan ini disetel, dan mode kompilasi disetel ke 'dbg', tentukan GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC, dan GLIBCPP_CONCEPT_CHECKS.
Tag:action_command_lines
- Default
--[no]objc_enable_binary_stripping
: "false" -
Apakah akan melakukan penghapusan simbol dan kode mati pada biner tertaut. Penghapusan biner akan dilakukan jika flag 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. Sintaksis: regex_filter@option_1,option_2,...,option_n. Dengan regex_filter adalah daftar pola ekspresi reguler yang disertakan dan dikecualikan (Lihat juga --instrumentation_filter). option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus diapit dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ pertama yang 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 (di bagian --features=thin_lto) saat mengompilasi objek backend tertentu. Opsi ini dapat diteruskan beberapa kali. Sintaksis: regex_filter@option_1,option_2,...,option_n. Dengan regex_filter adalah daftar pola ekspresi reguler yang disertakan dan dikecualikan. option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus diberi tanda kutip dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ pertama yang 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
- Default
--platform_suffix=<a string>
: lihat deskripsi -
Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.
Tag:loses_incremental_state
,affects_outputs
,loading_and_analysis
- Default
--propeller_optimize=<a build target label>
: lihat deskripsi -
Gunakan informasi profil Propeller untuk mengoptimalkan target build.Profil propeller harus terdiri dari minimal salah 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, di a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Perintah export_files mungkin harus ditambahkan ke paket yang sesuai agar file ini dapat dilihat oleh Bazel. Opsi ini harus digunakan sebagai: --propeller_optimize=//a/b:propeller_profile
Tag:action_command_lines
,affects_outputs
- Default
--propeller_optimize_absolute_cc_profile=<a string>
: lihat deskripsi -
Nama jalur absolut file cc_profile untuk build Propeller Optimized.
Tag:affects_outputs
- Default
--propeller_optimize_absolute_ld_profile=<a string>
: lihat deskripsi -
Nama jalur absolut file ld_profile untuk build yang Dioptimalkan dengan Propeller.
Tag:affects_outputs
- Default
--run_under=<a prefix in front of command>
: 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 terakhirnya adalah 'foo -bar test_binary -baz'. Baris ini juga bisa 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 yang identik akan dibagikan di antara target yang berbeda
Tag:loading_and_analysis
,affects_outputs
- Default
--[no]stamp
: "false" -
Menandai biner dengan tanggal, nama pengguna, nama host, informasi ruang kerja, dll.
Tag:affects_outputs
- Default
--strip=<always, sometimes or never>
: "terkadang" -
Menentukan apakah akan menghapus biner dan library bersama (menggunakan "-Wl,--strip-debug"). Nilai default 'sometimes' 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
--swiftcopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke kompilasi Swift.
Tag:action_command_lines
--tvos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk mem-build biner Apple tvOS.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi tvOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'tvos_sdk_version'.
Tag:loses_incremental_state
--visionos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang digunakan untuk membangun 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 untuk mem-build biner Apple watchOS.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi watchOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'watchos_sdk_version'.
Tag:loses_incremental_state
- Default
--xbinary_fdo=<a build target label>
: lihat deskripsi -
Gunakan informasi profil XbinaryFDO untuk mengoptimalkan kompilasi. Tentukan nama profil lintas biner default. Jika opsi 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 menerapkan input build yang valid (definisi aturan, kombinasi flag, dll.):
- Default
--auto_cpu_environment_group=<a build target label>
: "" -
Deklarasikan environment_group yang akan digunakan untuk memetakan nilai cpu ke nilai target_environment secara otomatis.
Tag:changes_inputs
,loading_and_analysis
,experimental
- Default
--[no]check_licenses
: "false" -
Pastikan batasan pemberian lisensi yang diberlakukan oleh paket dependen tidak bertentangan dengan mode distribusi target yang sedang dibuat. Secara default, lisensi tidak dicentang.
Tag:build_file_semantics
- Default
--[no]check_visibility
: "true" -
Jika dinonaktifkan, error visibilitas dalam dependensi target akan diturunkan menjadi peringatan.
Tag:build_file_semantics
- Default
--[no]desugar_for_android
: "true" -
Apakah akan mendesugar bytecode Java 8 sebelum melakukan dexing.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--[no]desugar_java8_libs
: "false" -
Apakah akan menyertakan library Java 8 yang didukung dalam aplikasi untuk perangkat lama.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]enforce_constraints
: "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
- Default
--[no]experimental_check_desugar_deps
: "true" -
Apakah akan memeriksa kembali desugaring yang benar di tingkat biner Android.
Tag:eagerness_to_exit
,loading_and_analysis
,experimental
- Default
--experimental_import_deps_checking=<off, warning or error>
: "OFF" -
Jika diaktifkan, periksa apakah dependensi aar_import sudah selesai. Penerapan ini dapat merusak build, atau hanya mengakibatkan peringatan.
Tag:loading_and_analysis
- Default
--experimental_one_version_enforcement=<off, warning or error>
: "NONAKTIF" -
Saat diaktifkan, terapkan agar aturan java_binary tidak boleh berisi lebih dari satu versi file class yang sama di classpath. Penerapan ini dapat merusak build, atau hanya dapat menghasilkan peringatan.
Tag:loading_and_analysis
- Default
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "default" -
Jika benar, memeriksa apakah target Java secara eksplisit mendeklarasikan semua target yang digunakan secara langsung sebagai dependensi.
Tag:build_file_semantics
,eagerness_to_exit
- Default
--[no]incompatible_check_testonly_for_output_files
: "false" -
Jika diaktifkan, periksa testonly untuk target prasyarat yang merupakan file output dengan mencari testonly aturan pembuatan. Ini cocok dengan pemeriksaan visibilitas.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_check_visibility_for_toolchains
: "false" -
Jika diaktifkan, pemeriksaan visibilitas juga berlaku untuk implementasi toolchain.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_disable_native_android_rules
: "false" -
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
- Default
--[no]incompatible_disable_native_apple_binary_rule
: "false" -
Tidak ada operasi. Dipertahankan di sini untuk kompatibilitas mundur.
Tag:eagerness_to_exit
,incompatible_change
- Default
--[no]incompatible_python_disable_py2
: "true" -
Jika benar, menggunakan setelan Python 2 akan menyebabkan error. Ini mencakup python_version=PY2, srcs_version=PY2, dan srcs_version=PY2ONLY. Lihat https://github.com/bazelbuild/bazel/issues/15684 untuk mengetahui informasi selengkapnya.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_validate_top_level_header_inclusions
: "true" -
Jika benar, Bazel juga akan memvalidasi penyertaan header direktori tingkat teratas (lihat https://github.com/bazelbuild/bazel/issues/10047 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]one_version_enforcement_on_java_tests
: "true" -
Jika diaktifkan, dan dengan experimental_one_version_enforcement ditetapkan ke nilai non-NONE, terapkan satu versi pada target java_test. Flag ini dapat dinonaktifkan untuk meningkatkan performa pengujian inkremental dengan mengorbankan potensi pelanggaran satu versi.
Tag:loading_and_analysis
- Default
--python_native_rules_allowlist=<a build target label>
: lihat deskripsi -
Daftar yang diizinkan (target paket_grup) untuk digunakan saat menerapkan --incompatible_python_disallow_native_rules.
Tag:loading_and_analysis
- Default
--[no]strict_filesets
: "false" -
Jika opsi ini diaktifkan, set file yang melintasi batas paket akan dilaporkan sebagai error.
Tag:build_file_semantics
,eagerness_to_exit
- Default
--strict_proto_deps=<off, warn, error, strict or default>
: "error" -
Kecuali jika 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>
: "nonaktif" -
Kecuali jika NONAKTIF, memeriksa apakah target proto_library secara eksplisit mendeklarasikan semua target yang digunakan di 'import public' sebagai diekspor.
Tag:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Default
--[no]strict_system_includes
: "false" -
Jika 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 ditetapkan, semua target tingkat atas 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
- Default
--[no]device_debug_entitlements
: "true" -
Jika ditetapkan, dan mode kompilasi bukan 'opt', aplikasi objc akan menyertakan hak debug saat menandatangani.
Tag:changes_inputs
- Default
--ios_signing_cert_name=<a string>
: lihat deskripsi -
Nama sertifikat yang akan digunakan untuk penandatanganan iOS. Jika tidak ditetapkan, akan kembali ke profil penyediaan. Mungkin merupakan preferensi identitas keychain sertifikat atau (substring) nama umum sertifikat, sesuai dengan halaman man codesign (IDENTITAS PENANDATANGANAN).
Tag:action_command_lines
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_disallow_legacy_py_provider
default: "true"-
Tidak ada operasi, akan segera dihapus.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_disallow_sdk_frameworks_attributes
: "false" -
Jika true (benar), larang atribut sdk_frameworks dan Open_sdk_frameworks di objc_library andobjc_import.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_objc_alwayslink_by_default
: "false" -
Jika benar, buat nilai default menjadi benar untuk atribut alwayslink di objc_library dan objc_import.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_python_disallow_native_rules
: "false" -
Jika benar (true), error akan terjadi saat menggunakan aturan py_* bawaan; sebagai gantinya, aturan rule_python harus digunakan. Lihat https://github.com/bazelbuild/bazel/issues/17773 untuk mendapatkan informasi dan petunjuk migrasi selengkapnya.
Tag:loading_and_analysis
,incompatible_change
- Opsi yang mengatur perilaku lingkungan pengujian atau runner pengujian:
- Default
--[no]allow_analysis_failures
: "false" -
Jika benar, kegagalan analisis target aturan akan menyebabkan penyebaran instance AnalysisFailureInfo yang berisi deskripsi error, bukan menyebabkan 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
- Default
--[no]break_build_on_parallel_dex2oat_failure
: "false" -
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- Ganti jumlah resource default untuk pengujian. Format yang diharapkan adalah <resource>=<value>. Jika satu angka positif ditentukan 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 dapat berupa HOST_RAM/HOST_CPU, yang secara opsional diikuti dengan [-|*]<float> (misalnya, 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.
- Default
--[no]experimental_android_use_parallel_dex2oat
: "false" -
Gunakan dex2oat secara paralel untuk mempercepat android_test.
Tag:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- Default
--[no]ios_memleaks
: "false" -
Mengaktifkan pemeriksaan kebocoran memori di target ios_test.
Tag:action_command_lines
- Default
--ios_simulator_device=<a string>
: 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 komputer tempat simulator akan dijalankan.
Tag:test_runner
- Default
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi iOS yang akan dijalankan di simulator saat menjalankan atau menguji. Hal 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 frekuensi untuk menjalankan setiap pengujian. Jika salah satu upaya tersebut gagal karena alasan apa pun, seluruh pengujian akan dianggap gagal. Biasanya, nilai yang ditentukan hanyalah bilangan bulat. Contoh: --runs_per_test=3 akan menjalankan semua pengujian 3 kali. Sintaksis alternatif: regex_filter@runs_per_test. Dengan runs_per_test adalah nilai bilangan bulat dan regex_filter adalah daftar pola ekspresi reguler yang disertakan dan dikecualikan (Lihat juga --instrumentation_filter). Contoh: --runs_per_test=//foo/.*,-//foo/bar/.*@3 menjalankan semua pengujian di //foo/ kecuali yang berada di foo/bar tiga kali. Opsi ini dapat diteruskan beberapa kali. Argumen yang terakhir diteruskan yang cocok akan diutamakan. Jika tidak ada yang cocok, pengujian hanya dijalankan sekali.
--test_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan variabel lingkungan tambahan untuk dimasukkan ke lingkungan runner pengujian. Variabel dapat ditentukan berdasarkan nama, dalam hal ini nilainya akan dibaca dari lingkungan klien Bazel, atau dengan pasangan name=value. 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 satu nilai bilangan bulat positif ditentukan, nilai tersebut akan menggantikan semua kategori. Jika 4 bilangan bulat yang dipisahkan koma ditentukan, bilangan tersebut akan mengganti waktu tunggu untuk singkat, sedang, lama, dan abadi (dalam urutan tersebut). Dalam kedua bentuk tersebut, nilai -1 akan memberi tahu blaze untuk menggunakan waktu tunggu defaultnya untuk kategori tersebut.
- Default
--[no]zip_undeclared_test_outputs
: "true" -
Jika true (benar), output pengujian yang tidak dideklarasikan akan diarsipkan dalam file ZIP.
Tag:test_runner
- Opsi yang terkait dengan output dan semantik kueri:
- Default
--aspect_deps=<off, conservative or precise>
: "konservatif" -
Cara mengatasi dependensi aspek jika format output adalah salah satu dari {xml,proto,record}. 'nonaktif' berarti tidak ada dependensi aspek yang di-resolve, 'konservatif' (default) berarti semua dependensi aspek yang dideklarasikan ditambahkan terlepas dari apakah dependensi tersebut diberi class aturan dependensi langsung, 'akurat' berarti hanya aspek yang mungkin aktif yang ditambahkan dengan class aturan dependensi langsung. Perhatikan bahwa mode presisi memerlukan pemuatan paket lain untuk mengevaluasi satu target sehingga membuatnya lebih lambat daripada mode lainnya. Perhatikan juga bahwa mode presisi pun tidak sepenuhnya presisi: keputusan apakah akan menghitung aspek atau tidak diputuskan dalam fase analisis, yang tidak dijalankan selama 'kueri bazel'.
Tag:build_file_semantics
- Default
--[no]consistent_labels
: "false" -
Jika diaktifkan, setiap perintah kueri akan menampilkan label seolah-olah oleh fungsi Starlark <code>str</code> yang diterapkan ke instance <code>Label</code>. Hal ini berguna untuk alat yang perlu mencocokkan output dari berbagai perintah kueri dan/atau label yang dikeluarkan oleh aturan. Jika tidak diaktifkan, pemformat output bebas untuk menampilkan nama repositori yang jelas (relatif terhadap repositori utama) untuk membuat output lebih mudah dibaca.
Tag:terminal_output
- Default
--[no]experimental_explicit_aspects
: "false" -
aquery, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: no-op (aspek selalu diikuti).
Tag:terminal_output
- Default
--[no]graph:factored
: "true" -
Jika benar, grafik akan dimunculkan 'difaktorkan', yaitu node yang setara secara topologi akan digabungkan dan labelnya 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 terpotong; -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 yang digunakan untuk mengoperasikan kueri. Dependensi implisit adalah dependensi yang tidak secara eksplisit ditentukan dalam file BUILD tetapi ditambahkan oleh bazel. Untuk kueri, opsi ini mengontrol pemfilteran toolchain yang telah di-resolve.
Tag:build_file_semantics
--[no]include_artifacts
default: "true"-
Menyertakan nama input dan output tindakan dalam output (berpotensi besar).
Tag:terminal_output
- Default
--[no]include_aspects
: "true" -
aquery, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: no-op (aspek selalu diikuti).
Tag:terminal_output
- Default
--[no]include_commandline
: "true" -
Menyertakan konten baris perintah tindakan dalam output (berpotensi besar).
Tag:terminal_output
- Default
--[no]include_file_write_contents
: "false" -
Sertakan konten file untuk tindakan FileWrite, SourceSymlinkManifest, dan RepoMappingManifest (berpotensi besar).
Tag:terminal_output
- Default
--[no]include_param_files
: "false" -
Sertakan konten file parameter yang digunakan dalam perintah (berpotensi besar). Catatan: Mengaktifkan flag ini akan otomatis mengaktifkan flag --include_commandline.
Tag:terminal_output
- Default
--[no]incompatible_package_group_includes_double_slash
: "true" -
Jika diaktifkan, saat menampilkan atribut `packages` package_group, `//` di awal tidak akan dihilangkan.
Tag:terminal_output
,incompatible_change
- Default
--[no]infer_universe_scope
: "false" -
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 Anda hanya boleh menggunakan opsi ini 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` (yaitu bukan `cquery`).
Tag:loading_and_analysis
- Default
--[no]line_terminator_null
: "false" -
Apakah setiap format diakhiri dengan \0, bukan baris baru.
Tag:terminal_output
--[no]nodep_deps
default: "true"-
Jika diaktifkan, dependensi dari atribut "nodep" akan disertakan dalam grafik dependensi tempat kueri beroperasi. Contoh umum untuk atribut "nodep" adalah "visibilitas". Jalankan dan uraikan output `info build-language` untuk mempelajari semua atribut "nodep" dalam bahasa build.
Tag:build_file_semantics
- Default
--output=<a string>
: "text" -
Format tempat hasil kueri akan dicetak. Nilai yang diizinkan untuk aquery adalah: text, textproto, proto, streamed_proto, jsonproto.
Tag:terminal_output
- Default
--[no]proto:default_values
: "true" -
Jika benar, atribut yang nilainya tidak ditentukan secara eksplisit dalam file BUILD akan disertakan; jika tidak, atribut akan dihilangkan. Opsi ini berlaku untuk --output=proto
Tag:terminal_output
- Default
--[no]proto:definition_stack
: "false" -
Isi kolom proto resolution_stack, yang mencatat stack panggilan Starlark untuk setiap instance aturan saat class aturan ditentukan.
Tag:terminal_output
- Default
--[no]proto:flatten_selects
: "true" -
Jika diaktifkan, atribut yang dapat dikonfigurasi yang dibuat oleh select() akan diratakan. Untuk jenis daftar, representasi yang diratakan adalah daftar yang berisi setiap nilai peta yang dipilih tepat sekali. Jenis skalar diratakan menjadi null.
Tag:build_file_semantics
- Default
--[no]proto:include_attribute_source_aspects
: "false" -
Isi kolom proto source_aspect_name dari setiap Atribut dengan aspek sumber asal atribut (string kosong jika tidak ada).
Tag:terminal_output
- Default
--[no]proto:include_synthetic_attribute_hash
: "false" -
Apakah akan menghitung dan mengisi atribut $internal_attr_hash atau tidak.
Tag:terminal_output
- Default
--[no]proto:instantiation_stack
: "false" -
Isi stack panggilan pembuatan instance dari setiap aturan. Perhatikan bahwa hal ini memerlukan stack untuk ada
Tag:terminal_output
- Default
--[no]proto:locations
: "true" -
Apakah akan menampilkan informasi lokasi dalam output proto.
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. Tetapkan ke string kosong agar tidak menampilkan atribut apa pun. Opsi ini berlaku untuk --output=proto.
Tag:terminal_output
- Default
--[no]proto:rule_inputs_and_outputs
: "true" -
Apakah akan mengisi kolom rule_input dan rule_output atau tidak.
Tag:terminal_output
- Default
--query_file=<a string>
: "" -
Jika ditetapkan, kueri akan membaca kueri dari file bernama di sini, bukan pada command line. Menentukan file di sini serta kueri command line akan menyebabkan error.
Tag:changes_inputs
- Default
--[no]relative_locations
: "false" -
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 komputer. Anda dapat menetapkan opsi ini ke true (benar) untuk memiliki hasil yang konsisten di seluruh komputer.
Tag:terminal_output
- Default
--[no]skyframe_state
: "false" -
Tanpa melakukan analisis tambahan, buang Action Graph 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
- Default
--[no]tool_deps
: "true" -
Kueri: Jika dinonaktifkan, dependensi pada 'konfigurasi exec' tidak akan disertakan dalam grafik dependensi yang mengoperasikan kueri. Edge dependensi 'konfigurasi exec', 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 dan melewati transisi eksekusi dari target level teratas yang menemukan target yang dikonfigurasi ini. Artinya, jika target tingkat atas berada dalam konfigurasi target, hanya target yang dikonfigurasi juga dalam konfigurasi target yang akan ditampilkan. Jika target tingkat teratas berada dalam konfigurasi exec, hanya target yang dikonfigurasi exec yang akan ditampilkan. Opsi ini TIDAK akan mengecualikan toolchain yang di-resolve.
Tag:build_file_semantics
- Default
--universe_scope=<comma-separated list of options>
: "" -
Kumpulan pola target yang dipisahkan koma (aditif dan subtraktif). Kueri dapat dilakukan di alam semesta yang ditentukan oleh penutupan transitif target yang ditentukan. Opsi ini digunakan untuk perintah kueri dan cquery.
Untuk kueri, input ke opsi ini adalah target tempat semua jawaban dibuat, sehingga opsi ini dapat memengaruhi konfigurasi dan transisi. Jika opsi ini tidak ditentukan, target tingkat atas diasumsikan sebagai target yang diuraikan dari ekspresi kueri. Catatan: Untuk cquery, tidak menentukan opsi ini dapat menyebabkan build rusak jika target yang diuraikan dari ekspresi kueri tidak dapat dibuat dengan opsi tingkat atas.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--[no]experimental_filter_library_jar_with_program_jar
: "false" -
Memfilter ProgramJar ProGuard untuk menghapus class yang juga ada di LibraryJar.
Tag:action_command_lines
- Default
--[no]experimental_inmemory_dotd_files
: "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
- Default
--[no]experimental_inmemory_jdeps_files
: "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
- Default
--[no]experimental_objc_include_scanning
: "false" -
Apakah akan melakukan pemindaian yang menyertakan C/C++ objektif.
Tag:loading_and_analysis
,execution
,changes_inputs
- Default
--[no]experimental_retain_test_configuration_across_testonly
: "false" -
Jika diaktifkan, --trim_test_configuration tidak akan memangkas konfigurasi pengujian untuk aturan yang ditandai testonly=1. Hal ini dimaksudkan untuk mengurangi masalah konflik tindakan saat aturan non-pengujian bergantung pada aturan cc_test. Tidak berpengaruh jika --trim_test_configuration bernilai salah (false).
Tag:loading_and_analysis
,loses_incremental_state
- Default
--[no]experimental_starlark_cc_import
: "false" -
Jika diaktifkan, cc_import versi Starlark dapat digunakan.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_unsupported_and_brittle_include_scanning
: "false" -
Apakah akan mempersempit input ke kompilasi C/C++ dengan mengurai baris #include dari file input. Hal ini dapat meningkatkan performa dan inkrementalitas dengan mengurangi ukuran hierarki input kompilasi. Namun, hal ini juga dapat merusak build karena pemindai include tidak sepenuhnya menerapkan semantik preprocessor C. Secara khusus, kode ini tidak memahami perintah #include dinamis dan mengabaikan logika bersyarat preprocessor. Gunakan dengan menanggung sendiri risikonya. Setiap masalah yang terkait dengan laporan ini yang diajukan 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
- Default
--[no]objc_use_dotd_pruning
: "true" -
Jika ditetapkan, file .d yang dikeluarkan oleh clang akan digunakan untuk memangkas kumpulan input yang diteruskan ke kompilasi objc.
Tag:changes_inputs
,loading_and_analysis
- Default
--[no]process_headers_in_dependencies
: "false" -
Saat mem-build //a:a target, header proses di semua target yang //a:a bergantung (jika pemrosesan header diaktifkan untuk toolchain).
Tag:execution
- Default
--[no]trim_test_configuration
: "true" -
Jika diaktifkan, opsi terkait pengujian akan dihapus di bawah tingkat teratas build. Jika tanda ini aktif, pengujian tidak dapat dibuat sebagai dependensi aturan non-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 tingkat perincian, format, atau lokasi logging:
- Default
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
Mencetak informasi debug selama resolusi toolchain. Flag tersebut menggunakan ekspresi reguler, yang diperiksa berdasarkan jenis toolchain dan target tertentu untuk mengetahui mana yang akan di-debug. Beberapa ekspresi reguler dapat dipisahkan dengan koma, lalu setiap ekspresi reguler akan 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 untuk perintah Bazel yang tidak termasuk dalam kategori lain:
--flag_alias=<a 'name=value' flag alias>
beberapa penggunaan diakumulasikan-
Menetapkan nama singkat untuk flag Starlark. Fungsi ini memerlukan satu pasangan nilai kunci dalam bentuk "<key>=<value>" sebagai argumen.
Tag:changes_inputs
- Default
--[no]incompatible_default_to_explicit_init_py
: "false" -
Flag ini mengubah perilaku default sehingga file __init__.py tidak lagi dibuat secara otomatis di runfile target Python. Tepatnya, saat target py_binary atau py_test menetapkan legacy_create_init ke "auto" (default), target dianggap salah jika dan hanya jika flag ini disetel. Lihat https://github.com/bazelbuild/bazel/issues/10076.
Tag:affects_outputs
,incompatible_change
- Default
--[no]incompatible_py2_outputs_are_suffixed
: "true" -
Jika benar, target yang di-build dalam konfigurasi Python 2 akan muncul di root output yang menyertakan akhiran '-py2', sedangkan target yang di-build untuk Python 3 akan muncul di root tanpa akhiran terkait Python. Ini berarti bahwa symlink praktis `bazel-bin` akan mengarah ke target Python 3, bukan Python 2. Jika Anda mengaktifkan opsi ini, sebaiknya aktifkan juga `--incompatible_py3_is_default`.
Tag:affects_outputs
,incompatible_change
- Default
--[no]incompatible_py3_is_default
: "true" -
Jika benar, 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 tetapkan juga `--incompatible_py2_outputs_are_suffixed`.
Tag:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
default: "true"-
Jika ditetapkan 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
- Default
--python_version=<PY2 or PY3>
: lihat deskripsi -
Mode versi utama Python, baik `PY2` maupun `PY3`. Perhatikan bahwa ini diganti oleh target `py_binary` dan `py_test` (meskipun tidak menentukan versi secara eksplisit) sehingga biasanya tidak ada banyak alasan untuk memberikan tanda ini.
Tag:loading_and_analysis
,affects_outputs
- Opsi lainnya, yang tidak dikategorikan.:
--[no]cache_test_results
[-t
] default: "auto"- 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 yang 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 'no', Bazel tidak akan menyimpan hasil pengujian dalam cache.
- Default
--[no]experimental_cancel_concurrent_tests
: "false" -
Jika benar, Blaze akan membatalkan pengujian yang berjalan secara serentak pada pengujian pertama yang berhasil. Opsi ini hanya berguna jika digunakan bersama --runs_per_test_detects_flakes.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_fetch_all_coverage_outputs
: "false" -
Jika benar, Bazel akan mengambil seluruh direktori data cakupan untuk setiap pengujian selama cakupan dijalankan.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_generate_llvm_lcov
: "false" -
Jika benar, cakupan untuk clang akan menghasilkan laporan LCOV.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_j2objc_header_map
: "true" - Apakah akan membuat peta header J2ObjC secara paralel dengan transpilasi J2ObjC.
- Default
--[no]experimental_j2objc_shorter_header_path
: "false" -
Apakah akan menghasilkan dengan jalur header yang lebih pendek (menggunakan "_ios", bukan "_j2objc").
Tag:affects_outputs
- Default
--experimental_java_classpath=<off, javabuilder or bazel>
: "javabuilder" - Mengaktifkan classpath pengurangan classpath untuk kompilasi Java.
- Default
--[no]experimental_limit_android_lint_to_android_constrained_java
: "false" -
Batasi -- experiment_run_android_lint_on_java_rules hanya untuk library yang kompatibel dengan Android.
Tag:affects_outputs
- Default
--[no]experimental_run_android_lint_on_java_rules
: "false" -
Apakah akan memvalidasi sumber java_*.
Tag:affects_outputs
- Default
--[no]explicit_java_test_deps
: "false" - Secara eksplisit menentukan dependensi ke JUnit atau Hamcrest dalam java_test, bukan mendapatkan secara tidak sengaja dari dependensi TestRunner. Saat ini hanya berfungsi untuk bazel.
- Default
--host_java_launcher=<a build target label>
: lihat deskripsi - Peluncur Java yang digunakan oleh alat yang dijalankan selama build.
--host_javacopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan untuk diteruskan ke javac saat mem-build alat yang dijalankan selama build.
--host_jvmopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke VM Java saat mem-build alat yang dieksekusi selama build. Opsi ini akan ditambahkan ke opsi startup VM dari setiap target java_binary.
- Default
--[no]incompatible_check_sharding_support
: "true" -
Jika benar, Bazel akan gagal dalam pengujian yang di-sharding jika runner pengujian tidak menunjukkan bahwa ia mendukung sharding dengan menyentuh file di jalur dalam TEST_SHARD_STATUS_FILE. Jika salah, runner pengujian yang tidak mendukung sharding akan menyebabkan semua pengujian berjalan di setiap shard.
Tag:incompatible_change
- Default
--[no]incompatible_exclusive_test_sandboxed
: "true" -
Jika benar, pengujian eksklusif akan berjalan dengan strategi sandbox. Menambahkan tag 'local' untuk memaksa pengujian eksklusif berjalan secara lokal
Tag:incompatible_change
- Default
--[no]incompatible_strict_action_env
: "false" -
Jika 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 spesifik dari klien, tetapi perhatikan bahwa hal itu dapat mencegah caching 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 yang akan diteruskan ke alat J2ObjC.
--java_debug
-
Menyebabkan mesin virtual Java pada pengujian java menunggu koneksi dari debugger yang mematuhi JDWP (seperti jdb) sebelum memulai pengujian. Menunjukkan -test_output=streamed.
Diluaskan menjadi:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
default: "true"- Buat informasi dependensi (untuk saat ini, classpath waktu kompilasi) per target Java.
- Default
--[no]java_header_compilation
: "true" - Mengompilasi ijar langsung dari sumber.
- Default
--java_language_version=<a string>
: "" - Versi bahasa Java
- Default
--java_launcher=<a build target label>
: lihat deskripsi - Peluncur Java yang akan digunakan saat mem-build biner Java. Jika tanda ini ditetapkan ke string kosong, peluncur JDK akan digunakan. Atribut "peluncur" mengganti tanda ini.
- Default
--java_runtime_version=<a string>
: "local_jdk" - Versi runtime Java
--javacopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke javac.
--jvmopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke VM Java. Opsi ini akan ditambahkan ke opsi startup VM setiap target java_binary.
- Default
--legacy_main_dex_list_generator=<a build target label>
: lihat deskripsi - Menentukan biner yang akan digunakan untuk membuat daftar class yang harus ada di dex utama saat mengompilasi multidex lama.
- Default
--optimizing_dexer=<a build target label>
: 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.
- Default
--proguard_top=<a build target label>
: lihat deskripsi - Menentukan versi ProGuard yang akan digunakan untuk penghapusan kode saat mem-build biner Java.
- Default
--proto_compiler=<a build target label>
: "@bazel_tools//tools/proto:protoc" -
Label proto-compiler.
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
- Default
--proto_toolchain_for_java=<a build target label>
: "@bazel_tools//tools/proto:java_toolchain" -
Label proto_lang_toolchain() yang menjelaskan cara mengompilasi proto Java
Tag:affects_outputs
,loading_and_analysis
- Default
--proto_toolchain_for_javalite=<a build target label>
: "@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 yang akan diteruskan ke compiler protobuf.
Tag:affects_outputs
- Default
--[no]runs_per_test_detects_flakes
: "false" - Jika benar, setiap shard yang setidaknya memiliki satu operasi/upaya yang berhasil dan setidaknya satu operasi/upaya yang gagal akan mendapatkan status FLAKY.
- Default
--shell_executable=<a path>
: lihat deskripsi -
Jalur absolut ke shell yang dapat dieksekusi untuk digunakan Bazel. Jika tidak ditetapkan, tetapi variabel lingkungan BAZEL_SH ditetapkan pada pemanggilan Bazel pertama (yang memulai server Bazel), Bazel akan menggunakannya. Jika tidak ada yang ditetapkan, Bazel akan menggunakan jalur default hard code bergantung pada sistem operasi tempatnya berjalan (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, semua lainnya: /bin/bash). Perhatikan bahwa penggunaan shell yang tidak kompatibel dengan bash dapat menyebabkan kegagalan build atau kegagalan runtime biner yang dihasilkan.
Tag:loading_and_analysis
--test_arg=<a string>
beberapa penggunaan diakumulasikan- Menentukan opsi dan argumen tambahan yang harus diteruskan ke file yang dapat dieksekusi pengujian. Dapat digunakan beberapa kali untuk menentukan beberapa argumen. Jika beberapa pengujian dijalankan, setiap pengujian akan menerima argumen yang sama. Hanya digunakan oleh perintah 'bazel test'.
- Default
--test_filter=<a string>
: lihat deskripsi - Menentukan filter untuk diteruskan ke framework pengujian. Digunakan untuk membatasi pengujian yang dijalankan. Perhatikan bahwa hal ini tidak memengaruhi target mana yang dibuat.
- Default
--test_result_expiration=<an integer>
: "-1" - Opsi ini tidak digunakan lagi dan tidak berpengaruh.
- Default
--[no]test_runner_fail_fast
: "false" - Teruskan opsi fail fast ke runner pengujian. 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>
: "explicit" - Menentukan strategi untuk sharding pengujian: 'explicit' untuk hanya menggunakan sharding jika atribut BUILD 'shard_count' ada. 'dinonaktifkan' untuk tidak pernah menggunakan sharding pengujian. 'forced=k' untuk menerapkan shard 'k' untuk pengujian, terlepas dari atribut BUILD 'shard_count'.
- Default
--tool_java_language_version=<a string>
: "" - Versi bahasa Java yang digunakan untuk menjalankan alat yang diperlukan selama proses build
- Default
--tool_java_runtime_version=<a string>
: "remotejdk_11" - Versi runtime Java yang digunakan untuk menjalankan alat selama build
- Default
--[no]use_ijars
: "true" - Jika diaktifkan, opsi ini akan menyebabkan kompilasi Java menggunakan jar antarmuka. Ini akan menghasilkan kompilasi inkremental yang lebih cepat, tetapi pesan error bisa 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
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika ditetapkan, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Hal ini dimaksudkan untuk menghemat kapasitas disk.
Tag:bazel_internal_configuration
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi pada komputer yang lebih lambat daripada yang diharapkan oleh penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--[no]incompatible_disable_native_repo_rules
: "false" -
Jika salah, aturan repo native dapat digunakan di WORKSPACE; jika tidak, aturan repo Starlark harus digunakan. Aturan repo native mencakup local_repository, new_local_repository, local_config_platform, android_sdk_repository, dan android_ndk_repository.
Tag:bazel_internal_configuration
- Default
--repository_cache=<a path>
: lihat deskripsi -
Menentukan lokasi cache 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
- Default
--[no]repository_disable_download
: "false" -
Jika disetel, mendownload menggunakan ctx.download{,_and_extract} tidak diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file yang dapat dieksekusi arbitrer yang mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--[no]check_up_to_date
: "false" -
Jangan lakukan build, cukup periksa apakah build sudah yang terbaru. Jika semua target sudah yang terbaru, build akan berhasil diselesaikan. Jika ada langkah yang perlu dijalankan, error akan dilaporkan dan build akan gagal.
Tag:execution
- Default
--dynamic_local_execution_delay=<an integer>
: "1000" -
Berapa milidetik penundaan eksekusi lokal, jika eksekusi jarak jauh lebih cepat selama build setidaknya sekali?
Tag:execution
,host_machine_resource_optimizations
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment>
beberapa penggunaan diakumulasikan-
Strategi lokal, secara berurutan, yang akan digunakan untuk mnemoni yang diberikan - strategi pertama yang berlaku akan digunakan. Misalnya, `worker,sandboxed` menjalankan tindakan yang mendukung pekerja persisten menggunakan strategi pekerja, dan semua yang lain menggunakan strategi dengan sandbox. Jika tidak ada mnemoni yang diberikan, daftar strategi akan digunakan sebagai pengganti untuk semua mnemoni. Daftar penggantian default adalah `worker,sandboxed`, atau`worker,sandboxed,standalone` jika `experimental_local_lockfree_output` ditetapkan. Perlu [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, secara berurutan, yang akan digunakan untuk mnemoni yang diberikan - strategi pertama yang berlaku akan digunakan. Jika tidak ada mnemoni yang diberikan, daftar strategi akan digunakan sebagai pengganti untuk semua mnemoni. Daftar penggantian default adalah `jarak jauh`, jadi tanda ini biasanya tidak perlu ditetapkan secara eksplisit. Mengambil [mnemonic=]remote_strategy[,remote_strategy,...]
Tag:execution
,host_machine_resource_optimizations
- Default
--experimental_docker_image=<a string>
: "" -
Tentukan nama image Docker (misalnya, "ubuntu:latest") yang harus digunakan untuk menjalankan tindakan dengan sandbox saat menggunakan strategi docker dan tindakan itu sendiri belum memiliki atribut image container 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
- Default
--[no]experimental_docker_use_customized_images
: "true" -
Jika diaktifkan, akan memasukkan uid dan gid pengguna saat ini ke dalam image Docker sebelum menggunakannya. 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
- Default
--[no]experimental_dynamic_exclude_tools
: "true" -
Jika ditetapkan, target yang dibuat "untuk alat" tidak akan dikenai eksekusi dinamis. Target tersebut sangat tidak mungkin dibuat secara bertahap sehingga tidak layak untuk menghabiskan siklus lokal.
Tag:execution
,host_machine_resource_optimizations
- Default
--experimental_dynamic_local_load_factor=<a double>
: "0" -
Mengontrol jumlah beban dari eksekusi dinamis yang akan ditempatkan di mesin lokal. Flag ini menyesuaikan jumlah tindakan dalam eksekusi dinamis yang akan kita jadwalkan secara serentak. Hal ini didasarkan pada jumlah CPU yang dianggap tersedia oleh Blaze, yang dapat dikontrol dengan flag --local_cpu_resources.
Jika tanda ini 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 jika jumlah tindakan yang menunggu penjadwalan tinggi. Hal ini mengurangi beban pada mesin lokal dalam kasus build bersih, saat mesin lokal tidak banyak berkontribusi.
Tag:execution
,host_machine_resource_optimizations
- Default
--experimental_dynamic_slow_remote_time=<An immutable length of time.>
: "0" -
Jika >0, waktu tindakan yang dijalankan secara dinamis harus dijalankan dari jarak jauh saja sebelum kita memprioritaskan eksekusi lokalnya untuk menghindari waktu tunggu jarak jauh. Hal ini dapat menyembunyikan beberapa masalah pada sistem eksekusi jarak jauh. Jangan aktifkan opsi ini tanpa pemantauan masalah eksekusi jarak jauh.
Tag:execution
,host_machine_resource_optimizations
- Default
--[no]experimental_enable_docker_sandbox
: "false" -
Mengaktifkan sandboxing berbasis Docker. Opsi ini tidak berpengaruh jika Docker tidak diinstal.
Tag:execution
- Default
--[no]experimental_inmemory_sandbox_stashes
: "false" -
Jika disetel ke true, konten sandbox yang disimpan untuk reuse_sandbox_directories akan dilacak dalam memori. Hal ini mengurangi jumlah I/O yang diperlukan selama penggunaan kembali. Bergantung pada build, flag ini dapat meningkatkan waktu tunggu. Bergantung pada build, tanda ini juga dapat menggunakan memori tambahan dalam jumlah yang signifikan.
Tag:host_machine_resource_optimizations
,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 tiga tersebut pada kumpulan thread asinkron yang memiliki ukuran 1 saat build berjalan dan bertambah hingga ukuran yang ditentukan oleh tanda ini saat server tidak ada aktivitas.
Tag:host_machine_resource_optimizations
,execution
- Default
--experimental_sandbox_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "0" -
Jika > 0, setiap sandbox Linux akan dibatasi ke jumlah memori yang ditentukan (dalam MB). Memerlukan cgroups v1 atau v2 dan izin bagi pengguna ke direktori cgroups.
Tag:execution
- Default
--[no]experimental_shrink_worker_pool
: "false" -
Jika diaktifkan, dapat memperkecil kumpulan pekerja jika tekanan memori pekerja tinggi. Tanda ini hanya berfungsi jika tanda eksperimental_total_worker_memory_limit_mb diaktifkan.
Tag:execution
,host_machine_resource_optimizations
- Default
--[no]experimental_split_xml_generation
: "true" -
Jika tanda ini ditetapkan, dan tindakan pengujian tidak menghasilkan file test.xml, Bazel akan menggunakan tindakan terpisah untuk membuat file test.xml dummy yang berisi log pengujian. Jika tidak, Bazel akan membuat test.xml sebagai bagian dari tindakan pengujian.
Tag:execution
- Default
--experimental_total_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "0" -
Jika batas ini lebih besar dari nol, pekerja yang tidak ada aktivitasnya mungkin akan dihentikan jika total penggunaan memori semua pekerja melebihi batas.
Tag:execution
,host_machine_resource_optimizations
- Default
--[no]experimental_use_hermetic_linux_sandbox
: "false" -
Jika disetel ke true, jangan pasang root, hanya pasang yang disediakan dengan sandbox_add_mount_pair. File input akan ditautkan 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
- Default
--[no]experimental_use_semaphore_for_jobs
: "true" -
Jika disetel ke benar, gunakan juga semaphore untuk membatasi jumlah tugas serentak.
Tag:host_machine_resource_optimizations
,execution
- Default
--[no]experimental_use_windows_sandbox
: "false" -
Gunakan sandbox Windows untuk menjalankan tindakan. Jika "yes", biner yang disediakan oleh --experimental_windows_sandbox_path harus valid dan sesuai dengan versi sandboxfs yang didukung. Jika "auto", biner mungkin tidak ada atau tidak kompatibel.
Tag:execution
- Default
--experimental_windows_sandbox_path=<a string>
: "BazelSandbox.exe" -
Jalur ke biner sandbox Windows yang akan digunakan jika --experimental_use_windows_sandbox bernilai benar. Jika nama sederhana, gunakan biner pertama dari nama tersebut yang ditemukan di PATH.
Tag:execution
- Default
--experimental_worker_allowlist=<comma-separated set of options>
: lihat deskripsi -
Jika tidak kosong, hanya izinkan penggunaan pekerja persisten dengan mnemoni kunci pekerja yang diberikan.
Tag:execution
,host_machine_resource_optimizations
- Default
--[no]experimental_worker_as_resource
: "true" -
Tidak ada pengoperasian, akan segera dihapus.
Tag:no_op
- Default
--[no]experimental_worker_cancellation
: "false" -
Jika diaktifkan, Bazel dapat mengirim permintaan pembatalan ke pekerja yang mendukungnya.
Tag:execution
- Default
--experimental_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "0" -
Jika batas ini lebih besar dari nol, worker mungkin akan dihentikan jika penggunaan memori worker melebihi batas. Jika tidak digunakan bersama dengan eksekusi dinamis dan `--experimental_dynamic_ignore_local_signals=9`, hal ini dapat membuat build Anda error.
Tag:execution
,host_machine_resource_optimizations
- Default
--experimental_worker_metrics_poll_interval=<An immutable length of time.>
: "5s" -
Interval antara pengumpulan metrik pekerja dan kemungkinan upaya penghapusan. Tidak boleh kurang dari 1 detik secara efektif karena alasan performa.
Tag:execution
,host_machine_resource_optimizations
- Default
--[no]experimental_worker_multiplex_sandboxing
: "false" -
Jika diaktifkan, pekerja multipleks akan di-sandbox, menggunakan direktori sandbox terpisah per permintaan pekerjaan. Hanya pekerja yang memiliki persyaratan eksekusi 'supports-multiplex-sandboxing' yang akan di-sandbox.
Tag:execution
- Default
--[no]experimental_worker_sandbox_hardening
: "false" -
Jika diaktifkan, pekerja akan dijalankan di sandbox yang di-harden, jika penerapan mengizinkannya.
Tag:execution
- Default
--[no]experimental_worker_strict_flagfiles
: "false" -
Jika diaktifkan, argumen tindakan untuk pekerja yang tidak mengikuti spesifikasi pekerja akan menyebabkan error. Argumen pekerja harus memiliki satu argumen @flagfile sebagai daftar argumen terakhir.
Tag:execution
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang dengan masa berlaku yang terisi (0-100) yang di atas batasnya GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika disetel ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Default
--genrule_strategy=<comma-separated list of options>
: "" -
Menentukan cara menjalankan genrules. Flag 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-
Tidak ada pengoperasian, akan segera dihapus.
Tag:execution
- Default
--[no]incompatible_remote_dangling_symlinks
: "true" -
Jika disetel ke true, symlink yang diupload ke cache disk atau jarak jauh diizinkan untuk menggantung.
Tag:execution
,incompatible_change
- Default
--[no]incompatible_remote_symlinks
: "true" -
Jika disetel ke true, Bazel akan selalu mengupload symlink ke cache disk atau jarak jauh. Jika tidak, symlink relatif yang tidak menggantung (dan hanya itu) akan diupload sebagai file atau direktori yang ditunjuknya.
Tag:execution
,incompatible_change
--[no]incompatible_sandbox_hermetic_tmp
default: "true"-
Jika disetel ke true, setiap sandbox Linux akan memiliki direktori kosong khusus yang dipasang sebagai /tmp, bukan berbagi /tmp dengan sistem file host. Gunakan --sandbox_add_mount_pair=/tmp untuk terus melihat /tmp host di semua sandbox.
Tag:execution
- Default
--[no]internal_spawn_scheduler
: "false" - 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. Mengambil bilangan bulat, atau kata kunci ("auto", "HOST_CPUS", "HOST_RAM"), secara opsional diikuti dengan operasi ([-|*]<float>) misalnya "auto", "HOST_CPUS*.5". Nilai harus antara 1 dan 5.000. Nilai di atas 2.500 dapat menyebabkan masalah memori. "auto" menghitung default yang wajar berdasarkan resource host.
Tag:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] default: "false"-
Lanjutkan sebanyak mungkin setelah terjadi error. Meskipun target yang gagal dan target yang bergantung pada target tersebut tidak dapat dianalisis, prasyarat lain dari target tersebut dapat menjadi prasyarat.
Tag:eagerness_to_exit
- Default
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "otomatis" -
Jumlah thread paralel yang akan digunakan untuk fase pemuatan/analisis.Mengambil bilangan bulat, atau kata kunci ("auto", "HOST_CPUS", "HOST_RAM"), secara opsional diikuti dengan operasi ([-|*]<float>) misalnya. "auto", "HOST_CPUS*.5". "auto" menetapkan default yang wajar berdasarkan resource host. Minimal harus 1.
Tag:bazel_internal_configuration
- Default
--[no]reuse_sandbox_directories
: "true" -
Jika disetel 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
- Default
--sandbox_base=<a string>
: "" -
Memungkinkan sandbox membuat direktori sandbox-nya di bawah jalur ini. Tentukan jalur di tmpfs (seperti /run/shm) untuk kemungkinan meningkatkan performa secara signifikan saat build / pengujian Anda memiliki banyak file input. Catatan: Anda memerlukan RAM dan ruang kosong yang cukup di tmpfs untuk menyimpan file output dan file perantara yang dihasilkan dengan menjalankan tindakan.
Tag:host_machine_resource_optimizations
,execution
- Default
--[no]sandbox_explicit_pseudoterminal
: "false" -
Aktifkan pembuatan pseudoterminal secara eksplisit untuk tindakan dalam sandbox. Beberapa distribusi Linux memerlukan penetapan ID grup proses ke 'tty' di dalam sandbox agar pseudoterminal dapat berfungsi. Jika hal ini menyebabkan masalah, tanda ini dapat dinonaktifkan agar grup lain dapat digunakan.
Tag:execution
--sandbox_tmpfs_path=<an absolute path>
beberapa penggunaan diakumulasikan-
Untuk tindakan dengan sandbox, pasang direktori kosong yang dapat ditulis di jalur absolut ini (jika didukung oleh implementasi sandbox, diabaikan jika tidak).
Tag:host_machine_resource_optimizations
,execution
- Default
--[no]skip_incompatible_explicit_targets
: "false" -
Lewati target yang tidak kompatibel yang tercantum secara eksplisit di command line. Secara default, mem-build target tersebut akan menghasilkan error, tetapi target tersebut akan dilewati secara otomatis saat opsi ini diaktifkan. Lihat: https://bazel.build/extending/platforms#skipping-incompatible-targets
Tag:loading_and_analysis
- Default
--spawn_strategy=<comma-separated list of options>
: "" -
Menentukan cara tindakan pembuatan 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 tersebut. 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 tersebut. Nilai defaultnya adalah "remote,worker,sandboxed,local". Flag ini menggantikan 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-
Ganti 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 tentang pencocokan regex_filter. regex_filter terakhir yang cocok dengan deskripsi akan digunakan. Opsi ini menggantikan flag 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 'Compiling //foo/bar/baz' dengan strategi 'local', tetapi membalikkan urutan akan menjalankannya dengan 'sandboxed'.
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-
Jumlah instance dari setiap jenis pekerja persisten yang dapat diluncurkan jika Anda menggunakan strategi 'pekerja'. Dapat ditentukan sebagai [name=value] untuk memberikan nilai yang berbeda per mnemoni. Batas ini didasarkan pada kunci pekerja, yang dibedakan berdasarkan mnemoni, tetapi juga pada flag dan lingkungan startup, sehingga dalam beberapa kasus, jumlah pekerja per mnemoni dapat lebih banyak daripada yang ditentukan flag ini. Mengambil bilangan bulat, atau kata kunci ("auto", "HOST_CPUS", "HOST_RAM"), secara opsional diikuti dengan operasi ([-|*]<float>), misalnya. "otomatis", "HOST_CPUS*.5". 'auto' menghitung 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-
Jumlah WorkRequest yang dapat diterima proses pekerja multipleks secara paralel jika Anda menggunakan strategi 'worker' dengan --worker_multiplex. Dapat ditentukan sebagai [name=value] untuk memberikan nilai yang berbeda per mnemoni. Batasnya didasarkan pada kunci pekerja, yang dibedakan berdasarkan mnemonik, tetapi juga pada lingkungan dan flag startup, sehingga dalam beberapa kasus mungkin ada lebih banyak pekerja per mnemonik daripada yang ditentukan oleh flag ini. Mengambil bilangan bulat, atau kata kunci ("auto", "HOST_CPUS", "HOST_RAM"), secara opsional diikuti dengan operasi ([-|*]<float>), misalnya. "auto", "HOST_CPUS*.5". 'auto' menghitung default yang wajar berdasarkan kapasitas mesin. "=value" menetapkan default untuk mnemoni yang tidak ditentukan.
Tag:execution
,host_machine_resource_optimizations
- Default
--[no]worker_multiplex
: "true" -
Jika diaktifkan, pekerja akan menggunakan multipleks jika mereka mendukungnya.
Tag:execution
,host_machine_resource_optimizations
- Default
--[no]worker_quit_after_build
: "false" -
Jika diaktifkan, semua pekerja akan berhenti setelah build selesai.
Tag:execution
,host_machine_resource_optimizations
- Default
--[no]worker_sandboxing
: "false" -
Jika diaktifkan, pekerja akan dijalankan di lingkungan dalam sandbox.
Tag:execution
- Default
--[no]worker_verbose
: "false" - Jika diaktifkan, pesan panjang akan dicetak saat worker dimulai, dimatikan, ...
- Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
- Default
--target_platform_fallback=<a string>
: "" -
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"-
Menjalankan build; ini adalah perilaku yang biasa. Menentukan --nobuild akan menyebabkan build berhenti sebelum menjalankan tindakan build, yang menampilkan nol jika fase pemuatan dan analisis paket berhasil diselesaikan; mode ini berguna untuk menguji fase tersebut.
Tag:execution
,affects_outputs
- Default
--[no]experimental_use_validation_aspect
: "false" -
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 koma, yang masing-masing secara opsional diawali dengan + atau -. Grup yang diawali dengan + ditambahkan ke kumpulan default grup output, sedangkan grup yang diawali dengan - akan dihapus dari kumpulan default. Jika setidaknya satu grup tidak diberi awalan, kumpulan grup output default akan dihapus. Misalnya, --output_groups=+foo,+bar mem-build gabungan kumpulan default, foo, dan bar, sedangkan --output_groups=foo,bar mengganti kumpulan default sehingga hanya foo dan bar yang di-build.
Tag:execution
,affects_outputs
- Default
--[no]run_validations
: "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 yang penyedianya yang diiklankan memenuhi penyedia aspek yang diperlukan some_aspect. Selain itu, some_aspect akan berjalan setelah semua aspek yang diperlukannya ditentukan oleh atribut requires. 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 tingkat 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
- Default
--[no]experimental_convenience_symlinks
: "normal" -
Tanda ini mengontrol cara pengelolaan symlink praktis (symlink yang muncul di ruang kerja setelah build). Nilai yang mungkin:
normal (default): Setiap jenis symlink praktis akan dibuat atau dihapus, seperti yang ditentukan oleh build.
clean: Semua symlink akan dihapus tanpa syarat.
abaikan: Symlink akan dibiarkan begitu saja.
log_only: Membuat pesan log seolah-olah 'normal' diteruskan, tetapi tidak benar-benar 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 tidak akan terpengaruh.
Tag:affects_outputs
- Default
--[no]experimental_convenience_symlinks_bep_event
: "false" -
Flag ini mengontrol apakah kita akan memposting build eventConvenienceSymlinksIdentified ke BuildEventProtocol atau tidak. Jika nilainya benar (true), BuildEventProtocol akan memiliki entri untuk convenienceSymlinksIdentified, yang mencantumkan semua symlink praktis yang dibuat di ruang kerja Anda. Jika salah (false), entri convenienceSymlinksIdentified di BuildEventProtocol akan kosong.
Tag:affects_outputs
--remote_download_all
-
Mendownload semua output jarak jauh ke komputer lokal. Flag ini adalah alias untuk --remote_download_outputs=all.
Diperluas menjadi:
--remote_download_outputs=all
Tag:affects_outputs
--remote_download_minimal
-
Tidak mendownload output build jarak jauh ke komputer lokal. Tanda ini adalah alias untuk --remote_download_outputs=minimal.
Diperluas menjadi:
--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 komputer lokal, kecuali yang diperlukan oleh tindakan lokal. Jika disetel ke 'toplevel' berperilaku seperti'minimal', parameter ini juga akan mendownload output target level atas ke komputer lokal. Kedua opsi tersebut dapat mengurangi waktu build secara signifikan jika bandwidth jaringan menjadi bottleneck.
Tag:affects_outputs
- Default
--remote_download_symlink_template=<a string>
: "" -
Buat link simbolis, bukan mendownload output build jarak jauh ke mesin lokal. Target link simbolis dapat ditentukan dalam bentuk string template. String template ini dapat berisi {hash} dan {size_bytes} yang diperluas ke hash objek dan ukuran dalam byte. Link simbolis ini, misalnya, dapat 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 tingkat atas ke komputer lokal. Flag ini adalah alias untuk --remote_download_outputs=toplevel.
Diperluas menjadi:
--remote_download_outputs=toplevel
Tag:affects_outputs
- Default
--symlink_prefix=<a string>
: lihat deskripsi -
Awalan yang ditambahkan ke salah satu 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 ditampilkan. Peringatan: fungsi khusus untuk '/' akan segera dihentikan; gunakan --experimental_convenience_symlinks=ignore sebagai gantinya.
Tag:affects_outputs
- Opsi yang memengaruhi seberapa ketat Bazel menerapkan input build yang valid (definisi aturan, kombinasi flag, dll.):
- Default
--[no]experimental_docker_privileged
: "false" -
Jika diaktifkan, Bazel akan meneruskan tanda --privileged ke 'docker run' saat menjalankan tindakan. Hal ini mungkin diperlukan oleh build Anda, tetapi juga dapat menyebabkan hermetisitas berkurang.
Tag:execution
- Default
--[no]experimental_sandboxfs_map_symlink_targets
: "false" -
Tanpa operasi
Tag:host_machine_resource_optimizations
,execution
- Default
--[no]incompatible_legacy_local_fallback
: "false" -
Jika disetel ke true, akan mengaktifkan penggantian implisit lama dari strategi sandbox ke lokal. Flag ini pada akhirnya akan ditetapkan secara default ke salah (false), lalu menjadi tidak aktif. 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-
Tambahkan pasangan jalur tambahan untuk dipasang di sandbox.
Tag:execution
--sandbox_block_path=<a string>
beberapa penggunaan diakumulasikan-
Untuk tindakan dengan sandbox, jangan izinkan akses ke jalur ini.
Tag:execution
- Default
--[no]sandbox_default_allow_network
: "true" -
Izinkan akses jaringan secara default untuk tindakan; hal ini mungkin tidak berfungsi dengan semua implementasi sandbox.
Tag:execution
- Default
--[no]sandbox_fake_hostname
: "false" -
Ubah nama host saat ini menjadi 'localhost' untuk tindakan dalam sandbox.
Tag:execution
- Default
--[no]sandbox_fake_username
: "false" -
Ubah nama pengguna saat ini menjadi 'nobody' untuk tindakan dengan sandbox.
Tag:execution
--sandbox_writable_path=<a string>
beberapa penggunaan diakumulasikan-
Untuk tindakan dengan sandbox, buat direktori yang ada dapat ditulis di sandbox (jika didukung oleh penerapan sandbox, diabaikan jika tidak).
Tag:execution
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
- Default
--[no]incompatible_config_setting_private_default_visibility
: "false" -
Jika incompatible_enforce_config_setting_visibility=false, ini adalah noop. Atau, jika tanda ini salah, config_setting apa pun tanpa atribut visibilitas eksplisit adalah //visibility:public. Jika tanda ini benar, config_setting akan mengikuti logika visibilitas yang sama dengan semua aturan lainnya. Lihat https://github.com/bazelbuild/bazel/issues/12933.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_enforce_config_setting_visibility
: "true" -
Jika benar, terapkan batasan visibilitas config_setting. Jika salah, setiap config_setting dapat dilihat oleh setiap target. Lihat https://github.com/bazelbuild/bazel/issues/12932.
Tag:loading_and_analysis
,incompatible_change
- Opsi yang mengatur perilaku lingkungan pengujian atau runner pengujian:
- Default
--[no]check_tests_up_to_date
: "false" -
Jangan jalankan pengujian, cukup periksa apakah pengujian tersebut sudah yang terbaru. Jika semua hasil pengujian sudah yang terbaru, pengujian akan berhasil diselesaikan. Jika ada pengujian yang 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 akan 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 dilakukan untuk pengujian reguler dan tiga untuk pengujian yang secara eksplisit ditandai sebagai tidak stabil oleh aturannya (atribut flaky=1). Sintaksis alternatif: regex_filter@flaky_test_attempts. Dengan flaky_test_attempts seperti di atas dan regex_filter adalah daftar pola ekspresi reguler yang disertakan dan dikecualikan (Lihat juga --runs_per_test). Contoh: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 deflakes semua pengujian di //foo/ kecuali di foo/bar tiga kali. Opsi ini dapat diteruskan beberapa kali. Argumen yang terakhir diteruskan yang cocok akan diutamakan. Jika tidak ada yang cocok, perilakunya akan seperti 'default' di atas.
Tag:execution
- Default
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Jumlah maksimum tugas pengujian lokal yang akan berjalan secara serentak. Mengambil bilangan bulat, atau kata kunci ("auto", "HOST_CPUS", "HOST_RAM"), secara opsional diikuti dengan operasi ([-|*]<float>), misalnya. "auto", "HOST_CPUS*.5". 0 berarti resource lokal akan membatasi jumlah tugas pengujian lokal yang berjalan secara serentak. Menetapkan nilai ini lebih besar dari nilai untuk --jobs tidak akan efektif.
Tag:execution
- Default
--[no]test_keep_going
: "true" -
Jika dinonaktifkan, pengujian yang tidak lulus akan menyebabkan seluruh build berhenti. Secara default, semua pengujian dijalankan, meskipun beberapa tidak lulus.
Tag:execution
- Default
--test_strategy=<a string>
: "" -
Menentukan strategi yang akan digunakan saat menjalankan pengujian.
Tag:execution
- Default
--test_tmpdir=<a path>
: lihat deskripsi - Menentukan direktori sementara dasar yang akan digunakan 'bazel test'.
- Opsi yang berkaitan dengan output kueri dan semantik:
- Default
--[no]experimental_parallel_aquery_output
: "true" - Tidak ada operasi.
- Opsi yang terkait dengan output dan semantik 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 dideklarasikan dihapus di registry tempatnya berasal (jika tidak 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 menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Memeriksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasinya ke kegagalan resolusi, `nonaktif` untuk menonaktifkan pemeriksaan, atau `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi.
Tag:loading_and_analysis
- Default
--check_direct_dependencies=<off, warning or error>
: "peringatan" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di modul root adalah versi yang sama dengan yang Anda dapatkan di grafik dependensi yang di-resolve. Nilai yang valid adalah `nonaktif` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasinya ke kegagalan resolusi.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika 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
- Default
--lockfile_mode=<off, update, refresh or error>
: "update" -
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan mengupdatenya jika ada perubahan, `refresh` untuk memuat ulang informasi yang dapat diubah (versi yang ditarik dan modul yang sebelumnya tidak ada) dari registry jarak jauh dari waktu ke waktu, `error` untuk menggunakan file kunci, tetapi menampilkan error jika tidak terbaru, atau `off` untuk tidak membaca dari atau menulis ke file kunci.
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 <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut akan sesuai dengan direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutan ini penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
- Default
--vendor_dir=<a path>
: lihat deskripsi -
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalam atau menggunakannya saat mem-build. 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, konfigurasikan Bazel untuk 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 ini menunjukkan ukuran cache sebagai jumlah ringkasan file yang akan di-cache.
- Default
--experimental_dynamic_ignore_local_signals=<a comma-separated list of signal numbers>
: lihat deskripsi -
Mengambil daftar nomor sinyal OS. Jika cabang lokal eksekusi dinamis dihentikan 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
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
default: "1detik:2,20detik:3,1menit:5"-
Batas yang, jika tercapai, menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan period adalah durasi dan count adalah bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang dengan masa berlaku (heap gen lama) tetap terisi setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan yang dipisahkan dengan koma.
Tag:host_machine_resource_optimizations
- Default
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
: "HOST_CPUS" -
Tetapkan secara eksplisit jumlah total core CPU lokal yang tersedia bagi Bazel untuk digunakan dalam tindakan build yang dijalankan secara lokal. Mengambil integer, atau "HOST_CPUS", secara opsional diikuti dengan [-|*]<float> (misalnya HOST_CPUS*.5 untuk menggunakan setengah 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-
Tetapkan jumlah resource tambahan yang tersedia untuk Bazel. Diambil dengan pasangan string-float. Dapat digunakan beberapa kali untuk menentukan beberapa jenis resource tambahan. Bazel akan membatasi tindakan yang dijalankan secara serentak berdasarkan sumber daya tambahan dan sumber daya tambahan yang diperlukan. Pengujian dapat mendeklarasikan jumlah resource tambahan yang diperlukan dengan menggunakan tag dalam format "resources:<resoucename>:<amount>". CPU, RAM, dan resource yang tersedia tidak dapat ditetapkan dengan flag ini.
Tag:host_machine_resource_optimizations
- Default
--local_ram_resources=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "HOST_RAM*.67" -
Tetapkan secara eksplisit jumlah total RAM host lokal (dalam MB) yang tersedia untuk Bazel untuk dibelanjakan pada tindakan build yang dijalankan secara lokal. Memerlukan bilangan bulat, atau "HOST_RAM", secara opsional diikuti oleh [-|*]<float> (misalnya HOST_RAM*.5 untuk menggunakan setengah RAM yang tersedia). Secara default, ("HOST_RAM*.67"), Bazel akan membuat kueri konfigurasi sistem untuk memperkirakan jumlah RAM yang tersedia dan akan menggunakan 67% darinya.
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-
Tetapkan jumlah resource yang tersedia untuk Bazel. Mengambil 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 mendeklarasikan jumlah resource yang diperlukan 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 diperlukan akan dihapus hingga beberapa kali per panggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC minor terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC minor tidak akan pernah memicu penurunan. Jika batas tersebut tercapai, status Skyframe tidak akan lagi diturunkan 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 penggunaan persentase heap yang dipertahankan setidaknya pada batas ini, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan. Dengan menyesuaikan hal ini, Anda dapat mengurangi dampak waktu berjalan dari thrashing GC, jika thrashing GC (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada merekonstruksi status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
- Default
--[no]debug_spawn_scheduler
: "false" - Default
--[no]experimental_bep_target_summary
: "false" - Apakah akan memublikasikan peristiwa TargetSummary.
- Default
--[no]experimental_build_event_expand_filesets
: "false" -
Jika true (benar), luaskan Fileset di BEP saat menyajikan file output.
Tag:affects_outputs
- Default
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: "false" -
Jika true, selesaikan symlink Fileset relatif di BEP saat menyajikan file output. Memerlukan --Eksperimental_build_event_expand_filesets.
Tag:affects_outputs
- Default
--experimental_build_event_upload_max_retries=<an integer>
: "4" -
Frekuensi maksimum Bazel harus mencoba mengupload peristiwa build lagi.
Tag:bazel_internal_configuration
- Default
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1s" -
Penundaan awal minimum untuk percobaan ulang backoff eksponensial saat upload BEP gagal. (eksponen: 1,6)
Tag:bazel_internal_configuration
- Default
--experimental_build_event_upload_strategy=<a string>
: lihat deskripsi -
Memilih cara mengupload artefak yang dirujuk dalam protokol peristiwa build.
Tag:affects_outputs
- Default
--[no]experimental_collect_local_sandbox_action_metrics
: "true" -
Tanpa pengoperasian yang tidak digunakan lagi.
Tag:execution
- Default
--experimental_command_profile=<cpu, wall, alloc or lock>
: lihat deskripsi - Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alloc, atau lock) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa pada direktori basis output. Sintaksis dan semantik tanda ini dapat berubah pada masa mendatang untuk mendukung jenis profil atau format output tambahan; gunakan dengan risiko Anda sendiri.
- Default
--[no]experimental_docker_verbose
: "false" -
Jika diaktifkan, Bazel akan mencetak pesan yang lebih panjang tentang strategi sandbox Docker.
Tag:execution
- Default
--[no]experimental_materialize_param_files_directly
: "false" -
Jika mewujudkan file parameter, lakukan dengan menulis langsung ke disk.
Tag:execution
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemoni dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemoni.
- Default
--experimental_repository_resolved_file=<a string>
: "" -
Jika tidak kosong, tulis nilai Starlark dengan informasi yang di-resolve dari semua aturan repositori Starlark yang dieksekusi.
Tag:affects_outputs
- Default
--[no]experimental_run_bep_event_include_residue
: "false" -
Apakah akan menyertakan residu command line dalam peristiwa build yang dijalankan yang dapat berisi residu. Secara default, residu tidak disertakan dalam peristiwa build perintah run yang dapat berisi residu.
Tag:affects_outputs
- Default
--[no]experimental_stream_log_file_uploads
: "false" -
Streaming file log yang diupload langsung ke penyimpanan jarak jauh, bukan menulisnya ke disk.
Tag:affects_outputs
- Default
--explain=<a path>
: lihat deskripsi -
Menyebabkan sistem build menjelaskan setiap langkah build yang dieksekusi. Penjelasan ditulis ke file log yang ditentukan.
Tag:affects_outputs
- Default
--[no]ignore_unsupported_sandboxing
: "false" -
Jangan cetak peringatan saat eksekusi dengan sandbox tidak didukung di sistem ini.
Tag:terminal_output
- Default
--[no]legacy_important_outputs
: "true" -
Gunakan ini untuk menyembunyikan pembuatan kolom important_outputs lama dalam peristiwa TargetComplete. important_outputs diperlukan untuk integrasi Bazel ke ResultStore.
Tag:affects_outputs
- Default
--[no]materialize_param_files
: "false" -
Menulis file parameter perantara ke hierarki output meskipun menggunakan eksekusi tindakan jarak jauh. Berguna saat men-debug tindakan. Hal ini tersirat oleh --subcommands dan --verbose_failures.
Tag:execution
- Default
--max_config_changes_to_show=<an integer>
: "3" -
Saat menghapus cache analisis karena perubahan pada opsi build, menampilkan hingga jumlah nama opsi yang diubah yang ditentukan. 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 maksimum per log pengujian yang dapat ditampilkan saat --test_output adalah 'errors' atau 'all'. Berguna untuk menghindari output yang berlebihan dengan output pengujian yang terlalu berisik. Header pengujian disertakan dalam ukuran log. Nilai negatif menyiratkan tidak ada batas. Outputnya adalah semua atau tidak sama sekali.
Tag:test_runner
,terminal_output
,execution
- Default
--output_filter=<a valid Java regular expression>
: lihat deskripsi -
Hanya menampilkan peringatan dan output tindakan untuk aturan dengan nama yang cocok dengan ekspresi reguler yang diberikan.
Tag:affects_outputs
- Default
--progress_report_interval=<an integer in 0-3600 range>
: "0" -
Jumlah detik yang diperlukan untuk menunggu di antara laporan 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. Jika --curses diaktifkan, progres akan dilaporkan setiap detik.
Tag:affects_outputs
- Default
--remote_print_execution_messages=<failure, success or all>
: "failure" -
Pilih kapan akan mencetak pesan eksekusi jarak jauh. Nilai yang valid adalah `failure`, untuk hanya mencetak saat gagal, `success` untuk hanya mencetak saat berhasil, dan `all` untuk selalu mencetak.
Tag:terminal_output
- Default
--[no]sandbox_debug
: "false" -
Mengaktifkan fitur proses debug untuk fitur sandbox. Hal ini mencakup dua hal: pertama, konten root sandbox tidak akan disentuh setelah build; dan kedua, mencetak informasi proses debug tambahan saat dieksekusi. Hal ini dapat membantu developer aturan Bazel atau Starlark dengan kegagalan proses debug karena file input tidak ada, dll.
Tag:terminal_output
- Default
--show_result=<an integer>
: "1" -
Menampilkan hasil build. Untuk setiap target, nyatakan apakah target tersebut diperbarui atau tidak, dan jika ya, daftar file output yang di-build. {i>File<i} yang dicetak adalah string yang mudah digunakan untuk menyalin+menempel ke {i>shell<i}, untuk mengeksekusinya.
Opsi ini memerlukan argumen bilangan bulat, yang merupakan jumlah nilai minimum target, yang informasi hasilnya tidak akan dicetak. Dengan demikian, nol menyebabkan pesan ditiadakan dan MAX_INT menyebabkan pencetakan hasil selalu terjadi. Defaultnya adalah satu.
Jika tidak ada yang di-build untuk target, hasilnya dapat dihilangkan agar output tetap berada di bawah nilai minimum.
Tag:affects_outputs
--[no]subcommands
[-s
] default: "false"-
Menampilkan subperintah yang dieksekusi selama build. Tanda terkait: --execution_log_json_file, --execution_log_binary_file (untuk logging subperintah ke file dalam format yang mudah digunakan).
Tag:terminal_output
- Default
--test_output=<summary, errors, all or streamed>
: "summary" -
Menentukan mode output yang diinginkan. Nilai yang valid adalah 'summary' untuk hanya menampilkan ringkasan status pengujian, 'errors' juga mencetak log pengujian untuk pengujian yang gagal, 'all' untuk mencetak log untuk semua pengujian, dan 'streaming' untuk menghasilkan log bagi 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
- Default
--test_summary=<short, terse, detailed, none or testcase>
: "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 tidak berhasil dijalankan, 'detailed' untuk mencetak informasi mendetail tentang kasus pengujian yang gagal, 'testcase' untuk mencetak ringkasan dalam resolusi kasus pengujian, tidak mencetak informasi mendetail tentang kasus pengujian yang gagal, dan 'none' untuk menghapus ringkasan.
Tag:terminal_output
- Default
--[no]verbose_explanations
: "false" -
Meningkatkan panjang penjelasan yang diberikan jika --explain diaktifkan. Tidak berpengaruh jika --explain tidak diaktifkan.
Tag:affects_outputs
- Default
--[no]verbose_failures
: "false" -
Jika perintah gagal, cetak command line lengkap.
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 beberapa aspek dalam daftar --aspects atau diperlukan oleh aspek dalam daftar. Opsi ini dapat digunakan beberapa kali. Namun, Anda tidak diizinkan menetapkan nilai ke parameter yang sama lebih dari sekali.
Tag:loading_and_analysis
- Default
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Jika tidak kosong, baca file yang di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Default
--target_pattern_file=<a string>
: "" -
Jika ditetapkan, build akan membaca pola dari file yang diberi nama di sini, bukan di command line. Menentukan file di sini serta pola command line akan menyebabkan error.
Tag:changes_inputs
- Opsi eksekusi dan penyimpanan dalam cache jarak jauh:
- Default
--experimental_circuit_breaker_strategy=<failure>
: lihat deskripsi -
Menentukan strategi yang akan digunakan pemutus arus. Strategi yang tersedia adalah "failure". Pada nilai yang tidak valid untuk opsi, perilaku yang sama dengan opsi tidak ditetapkan.
Tag:execution
- Default
--experimental_downloader_config=<a string>
: lihat deskripsi - Menentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris-baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti oleh nama host (untuk `izinkan` dan `block`) atau dua pola, satu untuk dicocokkan, dan satu lagi untuk digunakan sebagai URL pengganti, dengan referensi kembali mulai dari `$1`. Ada kemungkinan beberapa perintah `rewrite` untuk URL yang sama akan diberikan, dan dalam hal ini beberapa URL akan diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
- Default
--[no]experimental_guard_against_concurrent_changes
: "false" - Nonaktifkan opsi ini untuk menonaktifkan pemeriksaan ctime file input tindakan sebelum menguploadnya ke cache jarak jauh. Mungkin ada kasus saat kernel Linux menunda penulisan file, yang dapat menyebabkan positif palsu.
- Default
--[no]experimental_remote_cache_async
: "false" - Jika benar, I/O cache jarak jauh akan terjadi di latar belakang, bukan sebagai bagian dari spawn.
- Default
--experimental_remote_cache_compression_threshold=<an integer>
: "0" - Ukuran blob minimum yang diperlukan untuk mengompresi/mendekompresi dengan zstd. Tidak efektif kecuali jika --remote_cache_compression ditetapkan.
- Default
--experimental_remote_cache_eviction_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang jika build mengalami error cache jarak jauh sementara yang akan menyebabkan build gagal. Berlaku misalnya saat artefak dihapus dari cache jarak jauh, atau dalam kondisi kegagalan cache tertentu. Nilai yang bukan nol akan secara implisit menetapkan --incompatible_remote_use_new_exit_code_for_lost_inputs ke benar. ID pemanggilan baru akan dibuat untuk setiap upaya. Jika Anda membuat ID pemanggilan dan memberikannya ke Bazel dengan --invocation_id, Anda tidak boleh menggunakan flag ini. Sebagai gantinya, setel flag --incompatible_remote_use_new_exit_code_for_lost_inputs dan periksa kode keluar 39.
Tag:execution
- Default
--[no]experimental_remote_cache_lease_extension
: "false" - Jika disetel ke benar (true), Bazel akan memperpanjang lease untuk output tindakan jarak jauh selama build dengan mengirim panggilan `FindMissingBlobs` secara berkala ke cache jarak jauh. Frekuensi didasarkan pada nilai `--experimental_remote_cache_ttl`.
- Default
--experimental_remote_cache_ttl=<An immutable length of time.>
: "3j" -
TTL blob minimum yang dijamin di cache jarak jauh setelah ringkasannya baru-baru ini dirujuk, misalnya oleh ActionResult atau FindMissingBlobs. Bazel melakukan beberapa pengoptimalan berdasarkan TTL blob, misalnya tidak memanggil GetActionResult berulang kali dalam build inkremental. Nilai harus ditetapkan sedikit lebih kecil dari TTL sebenarnya karena ada jeda antara saat server menampilkan ringkasan dan saat Bazel menerimanya.
Tag:execution
- Default
--experimental_remote_capture_corrupted_outputs=<a path>
: lihat deskripsi - Jalur ke direktori tempat output yang rusak akan diambil.
- Default
--[no]experimental_remote_discard_merkle_trees
: "false" - Jika disetel ke benar, hapus salinan dalam memori dari hierarki Merkle root input dan pemetaan input terkait selama panggilan ke GetActionResult() dan Execute(). Hal ini mengurangi penggunaan memori secara signifikan, tetapi mengharuskan Bazel menghitung ulang setelah cache jarak jauh tidak ditemukan dan dicoba lagi.
- Default
--experimental_remote_downloader=<a string>
: lihat deskripsi - URI endpoint Remote Asset API, yang akan digunakan sebagai proxy download jarak jauh. Skema yang didukung adalah grpc, grpcs (grpc dengan TLS diaktifkan), dan unix (soket UNIX lokal). Jika tidak ada skema yang diberikan, Bazel akan menetapkan default ke grpcs. Lihat: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
- Default
--[no]experimental_remote_downloader_local_fallback
: "false" - Apakah akan kembali ke downloader lokal jika downloader jarak jauh gagal.
- Default
--[no]experimental_remote_execution_keepalive
: "false" - Apakah akan menggunakan keepalive untuk panggilan eksekusi jarak jauh.
- Default
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
: "10" -
Menetapkan jumlah rasio kegagalan yang diizinkan dalam persentase untuk jangka waktu tertentu, setelah itu cache/eksekutor jarak jauh berhenti memanggil. Secara default, nilainya adalah 10. Menetapkan nilai ini ke 0 berarti tidak ada batasan.
Tag:execution
- Default
--experimental_remote_failure_window_interval=<An immutable length of time.>
: "60 dtk" -
Interval saat rasio kegagalan permintaan jarak jauh dihitung. Pada nilai nol atau negatif, durasi kegagalan dihitung keseluruhan durasi eksekusi.Unit berikut dapat digunakan: Hari (d), jam (j), menit (m), detik (dtk), dan milidetik (md). Jika unit dihilangkan, nilai akan ditafsirkan sebagai detik.
Tag:execution
- Default
--[no]experimental_remote_mark_tool_inputs
: "false" - Jika disetel ke benar (true), Bazel akan menandai input sebagai input alat untuk eksekutor jarak jauh. Ini dapat digunakan untuk menerapkan pekerja persisten jarak jauh.
- Default
--[no]experimental_remote_merkle_tree_cache
: "false" - Jika disetel ke true, penghitungan hierarki Merkle akan di-memonize untuk meningkatkan kecepatan pemeriksaan hit cache jarak jauh. Jejak kaki memori pada cache dikontrol oleh --experiment_remote_merkle_tree_cache_size.
- Default
--experimental_remote_merkle_tree_cache_size=<a long integer>
: "1000" - Jumlah pohon Merkle yang akan dihafal untuk meningkatkan kecepatan pemeriksaan cache jarak jauh. Meskipun cache otomatis dipangkas sesuai dengan penanganan referensi soft oleh Java, error kehabisan memori dapat terjadi jika disetel terlalu tinggi. Jika disetel ke 0, ukuran cache tidak terbatas. Nilai optimal bervariasi bergantung pada ukuran project. Default-nya adalah 1.000.
- Default
--experimental_remote_output_service=<a string>
: lihat deskripsi - HOST atau HOST:PORT dari endpoint layanan output jarak jauh. Skema yang didukung adalah grpc, grpcs (grpc dengan TLS diaktifkan), dan unix (soket UNIX lokal). Jika tidak ada skema yang diberikan, Bazel akan menetapkan default ke grpcs. Tentukan skema grpc:// atau unix: untuk menonaktifkan TLS.
- Default
--experimental_remote_output_service_output_path_prefix=<a string>
: "" - Jalur tempat konten direktori output yang dikelola oleh --experimental_remote_output_service ditempatkan. Direktori output sebenarnya yang digunakan oleh build akan menjadi turunan dari jalur ini dan ditentukan oleh layanan output.
- Default
--[no]experimental_remote_require_cached
: "false" - Jika ditetapkan ke benar (true), pastikan semua tindakan yang dapat berjalan dari jarak jauh disimpan dalam cache, atau build akan gagal. Hal ini berguna untuk memecahkan masalah non-determinisme karena memungkinkan pemeriksaan apakah tindakan yang seharusnya di-cache benar-benar di-cache tanpa memasukkan hasil baru secara tidak sah ke dalam cache.
- Default
--experimental_remote_scrubbing_config=<Converts to a Scrubber>
: lihat deskripsi - Memungkinkan scrubbing 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 pembagian cache disk/jarak jauh di antara tindakan yang dijalankan di platform yang berbeda, tetapi menargetkan platform yang sama. Fitur ini harus digunakan dengan sangat hati-hati, karena setelan yang tidak tepat dapat menyebabkan pembagian entri cache secara tidak sengaja dan menghasilkan build yang salah. Pembersihan tidak memengaruhi cara tindakan dieksekusi, hanya cara kunci cache disk/jarak jauh dihitung untuk tujuan mengambil atau menyimpan hasil tindakan. Tindakan yang dihapus tidak kompatibel dengan eksekusi jarak jauh, dan akan selalu dieksekusi secara lokal. Mengubah konfigurasi pembersihan tidak akan 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 tetapkan --host_platform kustom bersama dengan --experimental_platform_in_output_dir (untuk menormalisasi awalan output) dan --incompatible_strict_action_env (untuk menormalisasi variabel lingkungan).
- Default
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Mode thread yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dihentikan. Jika tidak, gunakan thread pekerja virtual.
- Default
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "false" - Tidak digunakan lagi. Tidak ada operasi. Sebagai gantinya, gunakan --remote_build_event_upload=minimal.
--[no]incompatible_remote_downloader_send_all_headers
default: "true"-
Apakah akan mengirim semua nilai header multinilai ke downloader jarak jauh, bukan hanya yang pertama.
Tag:incompatible_change
- Default
--[no]incompatible_remote_output_paths_relative_to_input_root
: "false" -
Jika disetel ke benar (true), jalur output relatif terhadap root input, bukan direktori kerja.
Tag:incompatible_change
- Default
--[no]incompatible_remote_results_ignore_disk
: "true" -
Tag
tanpa operasi:incompatible_change
- Default
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
: "true" -
Jika kebijakan disetel ke benar (true), Bazel akan menggunakan kode keluar baru 39, bukan 34, jika error cache jarak jauh, termasuk penghapusan cache, menyebabkan build gagal.
Tag:incompatible_change
- Default
--[no]remote_accept_cached
: "true" - Apakah akan menerima hasil tindakan yang di-cache dari jarak jauh.
- Default
--remote_build_event_upload=<all or minimal>
: "minimal" - Jika disetel ke 'all', semua output lokal yang direferensikan oleh BEP akan diupload ke cache jarak jauh. Jika disetel ke 'minimal', output lokal yang dirujuk oleh BEP tidak akan diupload ke cache jarak jauh, kecuali file yang penting bagi konsumen BEP (misalnya log pengujian dan profil waktu). Skema bytestream:// selalu digunakan untuk uri file meskipun hilang dari cache jarak jauh. Nilai defaultnya adalah 'minimal'.
- Default
--remote_bytestream_uri_prefix=<a string>
: lihat deskripsi - Nama host dan nama instance yang akan digunakan dalam URI bytestream:// yang ditulis ke dalam aliran peristiwa build. Opsi ini dapat ditetapkan saat build dilakukan menggunakan proxy, yang menyebabkan nilai --remote_executor dan --remote_instance_name tidak lagi sesuai dengan nama kanonis layanan eksekusi jarak jauh. Jika tidak ditetapkan, setelan defaultnya adalah "${hostname}/${instance_name}".
- Default
--remote_cache=<a string>
: lihat deskripsi - URI endpoint penyimpanan dalam cache. Skema yang didukung adalah http, https, grpc, grpcs (grpc dengan TLS diaktifkan), dan unix (soket UNIX lokal). Jika tidak ada skema yang diberikan, Bazel akan menetapkan default ke grpcs. Tentukan grpc://, http://, atau unix: schema untuk menonaktifkan TLS. Lihat https://bazel.build/remote/caching
- Default
--[no]remote_cache_compression
: "false" - Jika diaktifkan, kompresi/dekompresi blob cache dengan zstd jika ukurannya minimal --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 yang akan digunakan sebagai platform eksekusi jarak jauh jika platform eksekusi belum menetapkan exec_properties.
Tag:affects_outputs
- Default
--remote_default_platform_properties=<a string>
: "" - Menetapkan properti platform default yang akan 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-
Memaksa output build jarak jauh yang jalurnya cocok dengan pola ini untuk didownload, terlepas dari --remote_download_outputs. Beberapa pola dapat ditentukan dengan mengulangi tanda 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.
- Default
--remote_execution_priority=<an integer>
: "0" - Prioritas relatif tindakan yang akan dijalankan dari jarak jauh. Semantik nilai prioritas tertentu bergantung pada server.
- Default
--remote_executor=<a string>
: lihat deskripsi - HOST atau HOST:PORT dari endpoint eksekusi jarak jauh. Skema yang didukung adalah grpc, grpcs (grpc dengan TLS diaktifkan), dan unix (soket UNIX lokal). Jika tidak ada skema yang diberikan, Bazel akan menetapkan default ke grpcs. Tentukan skema grpc:// atau unix: untuk menonaktifkan TLS.
- Default
--remote_grpc_log=<a path>
: 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 dengan varint yang menunjukkan ukuran pesan protobuf yang diserialisasi 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=Nama=Nilai. Beberapa header dapat diteruskan dengan menentukan tanda beberapa kali. Beberapa nilai untuk nama yang sama akan dikonversi menjadi daftar yang dipisahkan koma.
- Default
--remote_instance_name=<a string>
: "" - Nilai yang akan diteruskan sebagai instance_name di API eksekusi jarak jauh.
- Default
--[no]remote_local_fallback
: "false" - Apakah akan kembali ke strategi eksekusi lokal mandiri jika eksekusi jarak jauh gagal.
- Default
--remote_local_fallback_strategy=<a string>
: "local" - Tidak ada operasi, tidak digunakan lagi. Lihat https://github.com/bazelbuild/bazel/issues/7480 untuk mengetahui detailnya.
- Default
--remote_max_connections=<an integer>
: "100" -
Membatasi jumlah maksimum koneksi serentak ke cache/eksekutor jarak jauh. Secara default, nilainya adalah 100. Menetapkan nilai 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 lebih dari 100 permintaan serentak, sehingga Bazel dapat membuat sekitar `--remote_max_connections * 100` permintaan serentak.
Tag:host_machine_resource_optimizations
- Default
--remote_proxy=<a string>
: lihat deskripsi - Hubungkan ke cache jarak jauh melalui proxy. Saat ini, tanda ini hanya dapat digunakan untuk mengonfigurasi soket domain Unix (unix:/path/to/socket).
- Default
--remote_result_cache_priority=<an integer>
: "0" - Prioritas relatif tindakan jarak jauh yang akan disimpan di cache jarak jauh. Semantik nilai prioritas tertentu bergantung pada server.
- Default
--remote_retries=<an integer>
: "5" - Jumlah maksimum upaya untuk mencoba ulang error sementara. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
- Default
--remote_retry_max_delay=<An immutable length of time.>
: "5 dtk" - Penundaan backoff maksimum di antara upaya percobaan ulang jarak jauh. Unit berikut dapat digunakan: Hari (d), jam (h), menit (m), detik (s), dan milidetik (ms). 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 tunggu baca. Unit berikut dapat digunakan: Hari (d), jam (h), menit (m), detik (s), dan milidetik (ms). Jika unit dihilangkan, nilai akan ditafsirkan sebagai detik.
- Default
--[no]remote_upload_local_results
: "true" - Apakah akan mengupload hasil tindakan yang dieksekusi secara lokal ke cache jarak jauh jika cache jarak jauh mendukungnya dan pengguna diberi otorisasi untuk melakukannya.
- Default
--[no]remote_verify_downloads
: "true" - Jika disetel ke benar, Bazel akan menghitung jumlah hash dari semua download jarak jauh dan menghapus nilai yang di-cache dari jarak jauh jika tidak cocok dengan nilai yang diharapkan.
- Opsi lainnya, yang tidak dikategorikan.:
--[no]allow_analysis_cache_discard
default: "true"-
Jika menghapus cache analisis karena perubahan pada sistem build, menetapkan opsi ini ke salah 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 digunakan untuk membuat filter secara otomatis. Nilai yang diizinkan adalah 'none' (tidak memfilter apa pun / menampilkan semuanya), 'all' (memfilter semuanya / tidak menampilkan apa pun), 'packages' (menyertakan output dari aturan dalam paket yang disebutkan di command line Blaze), dan 'subpackages' (seperti 'packages', tetapi juga menyertakan subpaket). Untuk nilai 'packages' dan 'subpackages' //java/foo dan //javatests/foo diperlakukan sebagai satu paket)'.
- Default
--[no]build_manual_tests
: "false" - Memaksa target pengujian yang diberi tag 'manual' dibuat. Pengujian 'manual' dikecualikan dari pemrosesan. Opsi ini memaksanya untuk di-build (tetapi tidak dieksekusi).
- Default
--build_tag_filters=<comma-separated list of options>
: "" - Menentukan daftar tag yang dipisahkan koma. Setiap tag dapat diawali dengan '-' secara opsional untuk menentukan tag yang dikecualikan. Hanya target tersebut yang akan dibuat dengan setidaknya satu tag disertakan dan tidak berisi tag yang dikecualikan. Opsi ini tidak memengaruhi kumpulan pengujian yang dijalankan dengan perintah 'test'; opsi tersebut diatur oleh opsi pemfilteran pengujian, misalnya '--test_tag_filters'
- Default
--[no]build_tests_only
: "false" - Jika ditentukan, hanya aturan *_test dan test_suite yang akan dibuat dan target lain yang ditentukan di command line akan diabaikan. Secara default, semua yang diminta akan di-build.
- Default
--combined_report=<none or lcov>
: "none" - Menentukan jenis laporan cakupan kumulatif yang diinginkan. Saat ini, hanya LCOV yang didukung.
- Default
--[no]compile_one_dependency
: "false" - Mengompilasi satu dependensi dari file argumen. Hal ini berguna untuk memeriksa sintaksis file sumber di IDE, misalnya, dengan mem-build ulang satu target yang bergantung pada file sumber untuk mendeteksi error sedini mungkin dalam siklus edit/build/pengujian. Argumen ini memengaruhi cara semua argumen non-flag ditafsirkan; bukan target untuk mem-build, argumen ini adalah nama file sumber. Untuk setiap nama file sumber, target arbitrer yang bergantung padanya akan dibuat.
--deleted_packages=<comma-separated list of package names>
beberapa penggunaan diakumulasikan- Daftar nama paket yang dipisahkan koma yang dianggap tidak ada oleh sistem build, meskipun terlihat di suatu tempat di jalur paket. Gunakan opsi ini saat 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.
- Default
--[no]discard_analysis_cache
: "false" - Segera hapus cache analisis setelah fase analisis selesai. Mengurangi penggunaan memori sebesar ~10%, tetapi membuat build inkremental lebih lambat.
- Default
--disk_cache=<a path>
: lihat deskripsi - Jalur ke direktori tempat Bazel dapat membaca dan menulis tindakan serta output tindakan. Jika tidak ada, direktori akan dibuat.
- Default
--embed_label=<a one-line string>
: "" - Menyemat revisi kontrol sumber atau label rilis dalam biner
- Default
--execution_log_binary_file=<a path>
: lihat deskripsi - Buat log spawn yang dieksekusi ke dalam file ini sebagai proto SpawnExec yang dibatasi panjang, sesuai dengan src/main/protobuf/spawn.proto. Pilih --execution_log_compact_file, yang jauh lebih kecil dan lebih murah untuk dibuat. Flag terkait: --execution_log_compact_file (format ringkas; saling eksklusif), --execution_log_json_file (format JSON teks; saling eksklusif), --execution_log_sort (apakah akan mengurutkan log eksekusi), --subcommands (untuk menampilkan subperintah dalam output terminal).
- Default
--execution_log_compact_file=<a path>
: lihat deskripsi - Mencatat kemunculan yang dieksekusi ke dalam file ini sebagai proto ExecLogEntry yang dibatasi panjang, menurut src/main/protobuf/spawn.proto. Seluruh file dikompresi dengan zstd. Flag terkait: --execution_log_binary_file (format protobuf biner; saling eksklusif), --execution_log_json_file (format JSON teks; saling eksklusif), --subcommands (untuk menampilkan subperintah dalam output terminal).
- Default
--execution_log_json_file=<a path>
: lihat deskripsi - Mencatat spawn yang dieksekusi ke dalam file ini sebagai representasi JSON yang dibatasi baris baru dari proto SpawnExec, sesuai dengan src/main/protobuf/spawn.proto. Pilih --execution_log_compact_file, yang secara signifikan lebih kecil dan lebih murah untuk diproduksi. Flag terkait: --execution_log_compact_file (format ringkas; saling eksklusif), --execution_log_binary_file (format protobuf biner; saling eksklusif), --execution_log_sort (apakah akan mengurutkan log eksekusi), --subcommands (untuk menampilkan subperintah di output terminal).
--[no]execution_log_sort
default: "true"- Apakah akan mengurutkan log eksekusi, sehingga mempermudah perbandingan log di seluruh pemanggilan. Tetapkan ke salah untuk menghindari penggunaan CPU dan memori yang berpotensi signifikan di akhir pemanggilan, dengan mengorbankan pembuatan log dalam urutan eksekusi nondeterministik. Hanya berlaku untuk format biner dan JSON; format ringkas tidak pernah diurutkan.
- Default
--[no]expand_test_suites
: "true" -
Luaskan target test_suite ke dalam pengujian penyusunnya sebelum 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 saat aspek tingkat atas diterapkan di command line: kemudian, aspek tersebut dapat menganalisis target test_suite.
Tag:loading_and_analysis
- Default
--experimental_disk_cache_gc_idle_delay=<An immutable length of time.>
: "5m" - Durasi server harus tetap tidak ada aktivitas sebelum pembersihan sampah cache disk terjadi. Untuk menentukan kebijakan pembersihan sampah, tetapkan --experimental_disk_cache_gc_max_size dan/atau --experimental_disk_cache_gc_max_age.
- Default
--experimental_disk_cache_gc_max_age=<An immutable length of time.>
: "0" - Jika ditetapkan ke nilai positif, cache disk akan dihapus secara berkala untuk menghapus entri yang lebih lama dari usia ini. Jika ditetapkan bersama dengan --experimental_disk_cache_gc_max_size, kedua kriteria akan diterapkan. Pembersihan sampah memori terjadi di latar belakang setelah server tidak ada aktivitas, seperti yang ditentukan oleh tanda --experiment_disk_cache_gc_idle_delay.
- Default
--experimental_disk_cache_gc_max_size=<a size in bytes, optionally followed by a K, M, G or T multiplier>
: "0" - Jika ditetapkan ke nilai positif, cache disk akan dihapus secara berkala agar tetap berada di bawah ukuran ini. Jika ditetapkan bersama dengan --experimental_disk_cache_gc_max_age, kedua kriteria akan diterapkan. Pengumpulan sampah terjadi di latar belakang setelah server menjadi tidak ada aktivitas, seperti yang ditentukan oleh flag --experimental_disk_cache_gc_idle_delay.
- Default
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "" - Tidak digunakan lagi dan digantikan dengan aspek. Memfilter kumpulan target untuk menjadwalkan extra_actions.
- Default
--[no]experimental_extra_action_top_level_only
: "false" - Tidak digunakan lagi dan digantikan dengan aspek. Hanya menjadwalkan extra_actions untuk target tingkat teratas.
--experimental_spawn_scheduler
-
Mengaktifkan 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 lebih dulu diselesaikan. Jika tindakan mendukung pekerja, tindakan lokal akan dijalankan dalam mode pekerja persisten. Untuk mengaktifkan eksekusi dinamis untuk setiap mnemonic tindakan, gunakan flag `--internal_spawn_scheduler` dan `--strategy=<mnemonic>=dynamic`.
Diperluas ke:
--internal_spawn_scheduler
--spawn_strategy=dynamic
- Default
--[no]fetch
: "true" - Mengizinkan perintah mengambil dependensi eksternal. Jika disetel ke salah (false), perintah akan menggunakan versi dependensi yang di-cache, dan jika tidak ada, perintah akan gagal.
- Default
--[no]incompatible_dont_use_javasourceinfoprovider
: "false" -
Tanpa pengoperasian
Tag:incompatible_change
- Default
--local_termination_grace_seconds=<an integer>
: "15" - Waktu tunggu antara penghentian proses lokal karena waktu tunggu habis dan penghentian paksa.
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
- Default
--package_path=<colon-separated list of options>
: "%workspace%" - Daftar yang dipisahkan titik dua untuk tempat mencari paket. Elemen yang diawali dengan '%workspace%' bersifat relatif terhadap ruang kerja yang melingkupinya. Jika dihilangkan atau kosong, defaultnya adalah output 'bazel info default-package-path'.
- Default
--[no]show_loading_progress
: "true" - Jika diaktifkan, akan menyebabkan Bazel mencetak pesan "Loading package:".
- Default
--test_lang_filters=<comma-separated list of options>
: "" - Menentukan daftar bahasa pengujian yang dipisahkan koma. Setiap bahasa dapat diawali dengan '-' secara opsional untuk menentukan bahasa yang dikecualikan. Hanya target pengujian tersebut yang ditulis dalam bahasa yang ditentukan yang akan ditemukan. Nama yang digunakan untuk setiap bahasa harus sama dengan awalan bahasa dalam aturan *_test, misalnya salah satu dari 'cc', 'java', 'py', dll. Opsi ini memengaruhi perilaku --build_tests_only dan perintah pengujian.
- Default
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
: "" - Menentukan daftar ukuran pengujian yang dipisahkan koma. Setiap ukuran dapat secara opsional didahului dengan '-' untuk menentukan ukuran yang dikecualikan. Hanya target pengujian yang akan ditemukan yang berisi setidaknya satu ukuran yang disertakan dan tidak berisi ukuran yang dikecualikan. Opsi ini memengaruhi perilaku --build_tests_only dan perintah pengujian.
- Default
--test_tag_filters=<comma-separated list of options>
: "" - Menentukan daftar tag pengujian yang dipisahkan koma. Setiap tag dapat diawali dengan '-' secara opsional 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.
- Default
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
: "" - Menentukan daftar waktu tunggu pengujian yang dipisahkan koma. Setiap waktu tunggu dapat diawali dengan '-' secara opsional untuk menentukan waktu tunggu yang dikecualikan. Hanya target pengujian yang akan ditemukan yang berisi setidaknya satu waktu tunggu yang disertakan dan tidak berisi waktu tunggu yang dikecualikan. Opsi ini memengaruhi perilaku --build_tests_only dan perintah pengujian.
- Default
--workspace_status_command=<path>
: "" - Perintah yang dipanggil di awal build untuk memberikan informasi status tentang ruang kerja dalam bentuk key-value pair. Lihat Panduan Pengguna untuk mengetahui spesifikasi lengkap. Lihat juga tools/buildstamp/get_workspace_status untuk mengetahui contohnya.
- Opsi yang mengontrol eksekusi build:
- Default
--[no]check_up_to_date
: "false" -
Jangan menjalankan build, hanya periksa apakah build sudah yang terbaru. Jika semua target sudah yang terbaru, build akan berhasil diselesaikan. Jika ada langkah yang perlu dijalankan, error akan dilaporkan dan build akan gagal.
Tag:execution
- Default
--[no]experimental_inprocess_symlink_creation
: "false" -
Apakah akan membuat panggilan sistem file langsung untuk membuat hierarki symlink
Tag:loading_and_analysis
,execution
,experimental
- Default
--[no]experimental_persistent_aar_extractor
: "false" -
Aktifkan ekstraktor aar persisten menggunakan worker.
Tag:execution
- Default
--[no]experimental_remotable_source_manifests
: "false" -
Apakah akan membuat tindakan manifes sumber dapat diakses dari jarak jauh
Tag:loading_and_analysis
,execution
,experimental
- Default
--[no]experimental_split_coverage_postprocessing
: "false" -
Jika true (benar), Bazel akan menjalankan cakupan pascapemrosesan untuk pengujian pada spawn baru.
Tag:execution
- Default
--[no]experimental_split_xml_generation
: "true" -
Jika tanda ini ditetapkan, dan tindakan pengujian tidak menghasilkan file test.xml, Bazel akan menggunakan tindakan terpisah untuk menghasilkan file dummy test.xml yang berisi log pengujian. Jika tidak, Bazel akan membuat test.xml sebagai bagian dari tindakan pengujian.
Tag:execution
- Default
--[no]experimental_strict_fileset_output
: "false" -
Jika opsi ini diaktifkan, kumpulan file akan memperlakukan semua artefak output sebagai file biasa. Perintah ini tidak akan menjelajahi direktori atau sensitif terhadap symlink.
Tag:execution
- Default
--[no]experimental_use_semaphore_for_jobs
: "true" -
Jika ditetapkan ke benar, gunakan semafor tambahan untuk membatasi jumlah tugas serentak.
Tag:host_machine_resource_optimizations
,execution
- Default
--genrule_strategy=<comma-separated list of options>
: "" -
Menentukan cara menjalankan genrules. Tanda ini akan dihentikan secara bertahap. Sebagai gantinya, gunakan --spawn_strategy=<value> untuk mengontrol semua tindakan atau --strategy=Genrule=<value> untuk mengontrol genrule saja.
Tag:execution
- Default
--[no]incompatible_disallow_unsound_directory_outputs
: "true" -
Jika ditetapkan, akan terjadi error terhadap tindakan yang mewujudkan file output sebagai direktori. Tidak memengaruhi direktori sumber. Lihat https://github.com/bazelbuild/bazel/issues/18646.
Tag:bazel_internal_configuration
,incompatible_change
- Default
--[no]incompatible_modify_execution_info_additive
: "false" -
Saat diaktifkan, penerusan beberapa tanda --modify_execution_info akan menjadi tambahan. Jika dinonaktifkan, hanya tanda terakhir yang akan dipertimbangkan.
Tag:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] default: "auto"-
Jumlah tugas serentak yang akan dijalankan. Mengambil bilangan bulat, atau kata kunci ("auto", "HOST_CPUS", "HOST_RAM"), secara opsional diikuti dengan operasi ([-|*]<float>) misalnya "otomatis", "HOST_CPUS*.5". Nilai harus antara 1 dan 5.000. Nilai di atas 2.500 dapat menyebabkan masalah memori. "auto" menghitung default yang wajar berdasarkan resource host.
Tag:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] default: "false"-
Lanjutkan sebanyak mungkin setelah terjadi error. Meskipun target yang gagal dan target yang bergantung pada target tersebut tidak dapat dianalisis, prasyarat lain dari target tersebut dapat menjadi prasyarat.
Tag:eagerness_to_exit
- Default
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Jumlah thread paralel yang akan digunakan untuk fase pemuatan/analisis.Mengambil bilangan bulat, atau kata kunci ("auto", "HOST_CPUS", "HOST_RAM"), secara opsional diikuti dengan operasi ([-|*]<float>) misalnya. "auto", "HOST_CPUS*.5". "auto" menetapkan default yang wajar berdasarkan resource host. Minimal harus 1.
Tag:bazel_internal_configuration
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
beberapa penggunaan diakumulasikan-
Menambahkan atau menghapus tombol 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 menjadi penting karena banyak regex dapat berlaku pada mnemonik yang sama.
Sintaksis: "regex=[+-]key,regex=[+-]key,...".
Contoh:
'.*=+x,.*=-y,.*=+z' menambahkan 'x' dan 'z' ke, dan menghapus 'y' dari, info eksekusi untuk semua tindakan.
'Genrule=+requires-x' menambahkan 'requires-x' ke info eksekusi untuk semua tindakan Genrule.
'(?!Genrule).*=-memerlukan-x' menghapus 'memerlukan-x' dari info eksekusi untuk semua tindakan non-Genrule.
Tag:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Mengaktifkan tindakan dex dan desugar Android persisten menggunakan pekerja.
Diperluas menjadi:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Tag:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Mengaktifkan pemroses resource Android persisten menggunakan pekerja.
Diperluas menjadi:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
Tag:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Mengaktifkan tindakan dex dan desugar Android multipleks persisten menggunakan pekerja.
Diperluas menjadi:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Tag:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Mengaktifkan pemroses resource Android multipleks persisten menggunakan pekerja.
Diperluas menjadi:
--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
Tag:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Mengaktifkan alat Android yang persisten dan multipleks (dexing, desugaring, pemrosesan resource).
Diperluas menjadi:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Tag:host_machine_resource_optimizations
,execution
- Default
--[no]skip_incompatible_explicit_targets
: "false" -
Lewati target yang tidak kompatibel yang tercantum secara eksplisit di command line. Secara default, pembuatan target tersebut akan menghasilkan error, tetapi target tersebut akan otomatis dilewati saat opsi ini diaktifkan. Lihat: https://bazel.build/extending/platforms#skipping-incompatible-targets
Tag:loading_and_analysis
- Default
--spawn_strategy=<comma-separated list of options>
: "" -
Menentukan cara tindakan pembuatan 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 tersebut. 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 tersebut. Nilai defaultnya adalah "remote,worker,sandboxed,local". Flag ini menggantikan 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-
Ganti 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 tentang pencocokan regex_filter. regex_filter terakhir yang cocok dengan deskripsi akan digunakan. Opsi ini mengganti 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 tidak dengan //foo/bar. Contoh: --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed akan menjalankan 'Compiling //foo/bar/baz' dengan strategi 'local', tetapi membalikkan urutan akan menjalankannya dengan 'sandboxed'.
Tag:execution
- Default
--[no]use_target_platform_for_tests
: "false" -
Jika benar, Bazel akan menggunakan platform target untuk menjalankan pengujian, bukan grup eksekusi pengujian.
Tag:execution
- Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
- Default
--android_compiler=<a string>
: 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
- Default
--android_grte_top=<a label>
: lihat deskripsi -
Target Android grte_top.
Tag:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Default
--android_manifest_merger=<legacy, android or force_android>
: "android" -
Memilih penggabungan manifes yang akan digunakan untuk aturan android_binary. Flag untuk membantu transisi ke penggabungan manifes Android dari penggabungan lama.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--android_platforms=<a build target label>
: "" -
Menetapkan platform yang digunakan target android_binary. Jika beberapa platform ditentukan, biner adalah APK tebal, 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 Android SDK/platform 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
- Default
--cc_output_directory_tag=<a string>
: "" -
Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.
Tag:affects_outputs
- Default
--compiler=<a string>
: 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 memproses ulang laporan cakupan mentah. Grup file saat ini harus berupa grup file yang berisi satu file, yaitu biner. Nilai defaultnya 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 ini 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. Nilai defaultnya adalah '//tools/test:coverage_support'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
default: "@bazel_tools//tools/cpp:toolchain"-
Label paket crosstool yang akan digunakan untuk mengompilasi kode C++.
Tag:loading_and_analysis
,changes_inputs
,affects_outputs
- Default
--custom_malloc=<a build target label>
: lihat deskripsi -
Menentukan implementasi malloc kustom. Setelan ini mengganti atribut malloc 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 secara opsional 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 dilakukan seolah-olah telah mendeklarasikan nilai batasan sebagai batasan eksekusi. Contoh: //demo,-test=@platforms//cpus:x86_64 akan menambahkan 'x86_64' ke target apa pun di //demo kecuali target yang namanya berisi 'test'.
Tag:loading_and_analysis
- Default
--[no]experimental_include_xcode_execution_requirements
: "false" -
Jika ditetapkan, tambahkan persyaratan eksekusi "memerlukan-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, atau jika tidak ada versi yang tersedia secara bersama, gunakan versi Xcode lokal yang dipilih melalui xcode-select.
Tag:loses_incremental_state
- Default
--extra_execution_platforms=<comma-separated list of options>
: "" -
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 platform yang dideklarasikan dalam file WORKSPACE oleh register_execution_platforms(). Opsi ini hanya boleh ditetapkan 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
- Default
--grte_top=<a label>
: lihat deskripsi -
Label ke library libc yang di-check in. Nilai default dipilih oleh toolchain crosstool, dan Anda hampir tidak perlu menggantinya.
Tag:action_command_lines
,affects_outputs
- Default
--host_compiler=<a string>
: lihat deskripsi -
Compiler C++ yang akan digunakan untuk kompilasi host. Nilai ini akan diabaikan jika --host_crosstool_top tidak ditetapkan.
Tag:loading_and_analysis
,execution
- Default
--host_crosstool_top=<a build target label>
: lihat deskripsi -
Secara default, opsi --crosstool_top dan --compiler juga digunakan untuk konfigurasi exec. Jika flag ini disediakan, Bazel akan menggunakan libc dan compiler default untuk crosstool_top yang diberikan.
Tag:loading_and_analysis
,changes_inputs
,affects_outputs
- Default
--host_grte_top=<a label>
: lihat deskripsi -
Jika ditentukan, setelan ini akan menggantikan direktori tingkat atas libc (--grte_top) untuk konfigurasi exec.
Tag:action_command_lines
,affects_outputs
--host_platform=<a build target label>
default: "@bazel_tools//tools:host_platform"-
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 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
- Default
--[no]incompatible_enable_android_toolchain_resolution
: "true" -
Gunakan resolusi toolchain untuk memilih Android SDK untuk aturan Android (Starlark dan native)
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_enable_apple_toolchain_resolution
: "false" -
Gunakan resolusi toolchain untuk memilih Apple SDK untuk aturan apple (Starlark dan native)
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_make_thinlto_command_lines_standalone
: "true" -
Jika true (benar), Bazel tidak akan menggunakan kembali command line tindakan link C++ untuk mengindeks command line lto (lihat https://github.com/bazelbuild/bazel/issues/6791 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_remove_legacy_whole_archive
: "true" -
Jika benar, Bazel tidak akan menautkan dependensi library sebagai 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"-
Jika true (benar), Bazel akan memerlukan parameter 'ctx' ke cc_common.configure_features (lihat https://github.com/bazelbuild/bazel/issues/7793 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,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
- Default
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Menentukan versi iOS SDK yang akan digunakan untuk mem-build aplikasi iOS. Jika tidak ditentukan, akan menggunakan versi iOS SDK default dari 'xcode_version'.
Tag:loses_incremental_state
- Default
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Menentukan versi macOS SDK yang akan digunakan untuk mem-build aplikasi macOS. Jika tidak ditentukan, gunakan versi macOS SDK default dari 'xcode_version'.
Tag:loses_incremental_state
- Default
--minimum_os_version=<a string>
: lihat deskripsi -
Versi OS minimum yang ditargetkan kompilasi Anda.
Tag:loading_and_analysis
,affects_outputs
- Default
--platform_mappings=<a relative path>
: "" - Lokasi file pemetaan yang menjelaskan platform mana yang akan digunakan jika tidak ada yang ditetapkan atau flag mana yang akan ditetapkan jika platform sudah ada. Harus relatif terhadap root ruang kerja utama. Secara default, 'platform_mappings' (file langsung di bawah root ruang kerja).
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
- Default
--platforms=<a build target label>
: "" -
Label aturan platform yang menjelaskan platform target untuk perintah saat ini.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
- Default
--python2_path=<a string>
: lihat deskripsi -
Tidak digunakan lagi, tidak ada operasi. Dinonaktifkan oleh `--incompatible_use_python_toolchains`.
Tag:no_op
,deprecated
- Default
--python3_path=<a string>
: lihat deskripsi -
Tidak digunakan lagi, tidak ada operasi. Dinonaktifkan oleh `--incompatible_use_python_toolchains`.
Tag:no_op
,deprecated
- Default
--python_path=<a string>
: lihat deskripsi -
Jalur absolut penafsir Python yang dipanggil untuk menjalankan target Python pada platform target. Tidak digunakan lagi; dinonaktifkan oleh --incompatible_use_python_toolchains.
Tag:loading_and_analysis
,affects_outputs
- Default
--python_top=<a build target label>
: 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
- Default
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Menentukan versi tvOS SDK yang akan digunakan untuk mem-build aplikasi tvOS. Jika tidak ditentukan, versi SDK tvOS default akan digunakan dari 'xcode_version'.
Tag:loses_incremental_state
- Default
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Menentukan versi SDK watchOS yang akan digunakan untuk membuat aplikasi watchOS. Jika tidak ditentukan, gunakan versi watchOS SDK default dari 'xcode_version'.
Tag:loses_incremental_state
- Default
--xcode_version=<a string>
: lihat deskripsi -
Jika ditentukan, akan menggunakan Xcode versi tertentu untuk tindakan build yang relevan. Jika tidak ditentukan, akan menggunakan versi default Xcode dari eksekutor.
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 dalam konfigurasi build.
Tag:loses_incremental_state
,loading_and_analysis
- Opsi yang mengontrol output perintah:
- Default
--[no]apple_generate_dsym
: "false" -
Apakah akan membuat file simbol debug (.dSYM).
Tag:affects_outputs
,action_command_lines
- Default
--[no]build
: "true" -
Menjalankan build; ini adalah perilaku yang biasa. Menentukan --nobuild akan menyebabkan build berhenti sebelum menjalankan tindakan build, yang menampilkan nol jika fase pemuatan dan analisis paket berhasil diselesaikan; mode ini berguna untuk menguji fase tersebut.
Tag:execution
,affects_outputs
- Default
--[no]build_runfile_links
: "true" -
Jika true (benar), build hutan symlink runfiles untuk semua target. Jika salah (false), tulis hanya jika diperlukan oleh tindakan lokal, pengujian, atau perintah run.
Tag:affects_outputs
- Default
--[no]build_runfile_manifests
: "true" -
Jika benar, tulis manifes runfile untuk semua target. Jika salah (false), hapus. Pengujian lokal akan gagal dijalankan jika bernilai salah.
Tag:affects_outputs
- Default
--[no]build_test_dwp
: "false" -
Jika diaktifkan, saat mem-build pengujian C++ secara statis dan dengan fission, file .dwp untuk biner pengujian juga akan otomatis di-build.
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 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
- Default
--[no]experimental_proto_descriptor_sets_include_source_info
: "false" -
Menjalankan tindakan tambahan untuk versi API Java alternatif di proto_library.
Tag:affects_outputs
,loading_and_analysis
,experimental
- Default
--[no]experimental_proto_extra_actions
: "false" -
Menjalankan tindakan tambahan untuk versi API Java alternatif di proto_library.
Tag:affects_outputs
,loading_and_analysis
,experimental
- Default
--[no]experimental_save_feature_state
: "false" -
Menyimpan status fitur yang diaktifkan dan diminta sebagai output kompilasi.
Tag:affects_outputs
,experimental
- Default
--[no]experimental_use_validation_aspect
: "false" -
Apakah akan menjalankan tindakan validasi menggunakan aspek (untuk paralelisme dengan pengujian).
Tag:execution
,affects_outputs
- Default
--fission=<a set of compilation modes>
: "tidak" -
Menentukan mode kompilasi yang menggunakan fisi untuk kompilasi dan link C++. Dapat berupa kombinasi dari {'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
- Default
--[no]incompatible_always_include_files_in_data
: "true" -
Jika 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_avoid).
Tag:affects_outputs
,incompatible_change
- Default
--[no]legacy_external_runfiles
: "true" -
Jika true, bangun hutan symlink runfiles untuk repositori eksternal di bagian .runfiles/wsname/external/repo (selain .runfiles/repo).
Tag:affects_outputs
- Default
--[no]objc_generate_linkmap
: "false" -
Menentukan apakah akan membuat file linkmap.
Tag:affects_outputs
--output_groups=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar nama grup output yang dipisahkan koma, yang masing-masing secara opsional diawali dengan + atau -. Grup yang diawali dengan + ditambahkan ke kumpulan default grup output, sedangkan grup yang diawali dengan - akan dihapus dari kumpulan default. Jika setidaknya satu grup tidak diberi awalan, kumpulan grup output default akan dihapus. Misalnya, --output_groups=+foo,+bar mem-build gabungan kumpulan default, foo, dan bar, sedangkan --output_groups=foo,bar mengganti kumpulan default sehingga hanya foo dan bar yang di-build.
Tag:execution
,affects_outputs
- Default
--[no]run_validations
: "true" -
Apakah akan menjalankan tindakan validasi sebagai bagian dari build. Lihat https://bazel.build/extending/rules#validation_actions
Tag:execution
,affects_outputs
- Default
--[no]save_temps
: "false" -
Jika ditetapkan, output sementara dari gcc akan disimpan. Ini mencakup file .s (kode assembler), file .i (C++ yang telah diproses sebelumnya), dan file .ii (C++ yang telah diproses sebelumnya).
Tag:affects_outputs
- Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, memengaruhi nilainya, dibandingkan dengan 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 ditentukan berdasarkan nama, dalam hal ini nilai akan diambil dari lingkungan pemanggilan, atau dengan pasangan name=value yang menetapkan nilai secara independen dari lingkungan pemanggilan. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru akan digunakan, sedangkan opsi untuk variabel yang berbeda akan diakumulasikan.
Tag:action_command_lines
- Default
--android_cpu=<a string>
: "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. Flag ini tidak melakukan operasi apa pun.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]android_databinding_use_v3_4_args
: "true" -
Gunakan android databinding v2 dengan argumen 3.4.0. Flag ini tidak melakukan operasi apa pun.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--android_dynamic_mode=<off, default or fully>
: "nonaktif" -
Menentukan apakah dependensi C++ dari aturan Android akan ditautkan secara dinamis saat cc_binary tidak membuat library bersama secara eksplisit. 'default' berarti bazel akan memilih apakah akan menautkan secara dinamis. 'sepenuhnya' berarti semua library akan ditautkan secara dinamis. 'nonaktif' berarti semua library akan ditautkan dalam mode statis.
Tag:affects_outputs
,loading_and_analysis
- Default
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "alfabet" -
Menetapkan urutan manifes yang diteruskan ke penggabungan manifes untuk biner Android. ALFABETIS berarti manifes diurutkan berdasarkan jalur yang terkait dengan execroot. ALPHABETICAL_BY_CONFIGURATION berarti manifes diurutkan berdasarkan jalur yang relatif terhadap direktori konfigurasi dalam direktori output. DEPENDENCY berarti manifes diurutkan dengan manifes setiap library yang muncul sebelum manifes dependensinya.
Tag:action_command_lines
,execution
- Default
--[no]android_resource_shrinking
: "false" -
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 penyedianya yang diiklankan memenuhi penyedia aspek yang diperlukan some_aspect. Selain itu, some_aspect akan berjalan setelah semua aspek yang diperlukannya ditentukan oleh atribut requires. 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
--[no]build_python_zip
: "auto" -
Mem-build zip yang dapat dieksekusi python; aktif di Windows, nonaktif di platform lain
Tag:affects_outputs
--catalyst_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk mem-build biner Apple Catalyst.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--[no]collect_code_coverage
: "false" -
Jika ditentukan, Bazel akan mengumpulkan kode instrumen (menggunakan instrumentasi offline jika memungkinkan) dan akan mengumpulkan informasi cakupan selama pengujian. Hanya target yang cocok dengan --instrumentation_filter yang akan terpengaruh. Biasanya, opsi ini tidak boleh ditentukan secara langsung - perintah 'bazel coverage' harus digunakan.
Tag:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] default: "fastbuild"-
Menentukan mode tempat biner akan dibuat. 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
- Default
--cpu=<a string>
: "" -
CPU target.
Tag:changes_inputs
,affects_outputs
- Default
--cs_fdo_absolute_path=<a string>
: lihat deskripsi -
Gunakan 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
- Default
--cs_fdo_instrument=<a string>
: lihat deskripsi -
Buat biner dengan instrumentasi FDO yang sensitif terhadap konteks. Dengan compiler Clang/LLVM, compiler ini juga menerima nama direktori tempat file profil mentah akan dibuang saat runtime.
Tag:affects_outputs
- Default
--cs_fdo_profile=<a build target label>
: 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.
Tag:changes_inputs
,affects_outputs
- Default
--dynamic_mode=<off, default or fully>
: "default" -
Menentukan apakah biner C++ akan ditautkan secara dinamis. 'default' berarti Bazel akan memilih apakah akan menautkan secara dinamis. 'full' berarti semua library akan ditautkan secara dinamis. 'nonaktif' berarti semua library akan ditautkan dalam mode statis.
Tag:loading_and_analysis
,affects_outputs
- Default
--[no]enable_fdo_profile_absolute_path
: "true" -
Jika ditetapkan, penggunaan fdo_absolute_profile_path akan menimbulkan error.
Tag:affects_outputs
- Default
--[no]enable_runfiles
: "auto" -
Mengaktifkan hierarki symlink runfiles; Secara default, fitur ini dinonaktifkan di Windows dan di platform lain.
Tag:affects_outputs
--experimental_action_listener=<a build target label>
beberapa penggunaan diakumulasikan-
Tidak digunakan lagi dan digantikan dengan aspek. Gunakan action_listener untuk melampirkan extra_action ke tindakan build yang ada.
Tag:execution
,experimental
- Default
--[no]experimental_android_compress_java_resources
: "false" -
Kompresi resource Java di APK
Tag:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
default: "true"-
Gunakan android databinding v2. Flag ini tidak melakukan operasi apa pun.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]experimental_android_resource_shrinking
: "false" -
Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_android_rewrite_dexes_with_rex
: "false" -
menggunakan alat rex untuk menulis ulang file dex
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]experimental_collect_code_coverage_for_generated_files
: "false" -
Jika ditentukan, Bazel juga akan menghasilkan informasi cakupan pengumpulan untuk file yang dihasilkan.
Tag:affects_outputs
--[no]experimental_convenience_symlinks
default: "normal"-
Tanda ini mengontrol cara pengelolaan symlink praktis (symlink yang muncul di ruang kerja setelah build). Nilai yang memungkinkan:
normal (default): Setiap jenis symlink praktis akan dibuat atau dihapus, seperti yang ditentukan oleh build.
bersih: Semua symlink akan dihapus tanpa syarat.
ignore: Symlink tidak akan diubah.
log_only: Membuat pesan log seolah-olah 'normal' diteruskan, tetapi tidak benar-benar 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 tidak akan terpengaruh.
Tag:affects_outputs
- Default
--[no]experimental_convenience_symlinks_bep_event
: "false" -
Flag ini mengontrol apakah kita akan memposting build eventConvenienceSymlinksIdentified ke BuildEventProtocol atau tidak. Jika nilainya benar (true), BuildEventProtocol akan memiliki entri untuk convenienceSymlinksIdentified, yang mencantumkan semua symlink praktis yang dibuat di ruang kerja Anda. Jika salah (false), entri convenienceSymlinksIdentified di BuildEventProtocol akan kosong.
Tag:affects_outputs
- Default
--experimental_objc_fastbuild_options=<comma-separated list of options>
: "-O0,-DDEBUG=1" -
Menggunakan string ini sebagai opsi compiler fastbuild objc.
Tag:action_command_lines
- Default
--[no]experimental_omitfp
: "false" -
Jika true, gunakan libunwind untuk pelepasan stack, dan kompilasi dengan -fomit-frame-pointer dan -fasinkron-unwind-table.
Tag:action_command_lines
,affects_outputs
,experimental
- Default
--experimental_output_paths=<off, content or strip>
: "nonaktif" -
Model mana yang akan digunakan dan di mana aturan hierarki output menulis output-nya, terutama untuk build multi-platform / multi-konfigurasi. Fitur ini sangat eksperimental. Lihat https://github.com/bazelbuild/bazel/issues/6526 untuk mengetahui detailnya. Tindakan Starlark dapat memilih untuk menggunakan pemetaan jalur dengan menambahkan kunci 'supports-path-mapping' ke kamus '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 dalam bentuk label=value dengan label merujuk ke platform dan nilai adalah nama singkat yang diinginkan untuk digunakan di jalur output. Hanya digunakan jika --experimental_platform_in_output_dir bernilai benar. Memiliki prioritas penamaan tertinggi.
Tag:affects_outputs
,experimental
- Default
--[no]experimental_platform_in_output_dir
: "false" -
Jika benar, nama singkat untuk platform target akan digunakan dalam nama direktori output, bukan CPU. Skema yang tepat bersifat eksperimental dan dapat berubah: Pertama, dalam kasus yang jarang terjadi, opsi --platforms tidak memiliki tepat satu nilai, hash dari opsi platform akan digunakan. Selanjutnya, jika nama singkat untuk platform saat ini terdaftar oleh --experimental_override_name_platform_in_output_dir, nama singkat tersebut akan digunakan. Kemudian, jika --Experiment_use_platforms_in_output_dir_legacy_heuristic ditetapkan, gunakan nama pendek berdasarkan Label platform saat ini. Terakhir, hash opsi platform digunakan sebagai upaya terakhir.
Tag:affects_outputs
,experimental
- Default
--[no]experimental_use_llvm_covmap
: "false" -
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
- Default
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
: "true" -
Hanya gunakan tanda ini sebagai bagian dari strategi pengujian atau migrasi yang disarankan. Perhatikan bahwa heuristik memiliki kekurangan yang diketahui dan sebaiknya bermigrasi untuk mengandalkan --experimental_override_name_platform_in_output_dir saja.
Tag:affects_outputs
,experimental
- Default
--fat_apk_cpu=<comma-separated set of options>
: "armeabi-v7a" -
Menyetel opsi ini akan mengaktifkan APK gemuk, yang berisi biner native untuk semua arsitektur target yang ditentukan, misalnya, --fat_apk_cpu=x86,armeabi-v7a. Jika flag ini ditentukan, --android_cpu akan diabaikan untuk dependensi aturan android_binary.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--[no]fat_apk_hwasan
: "false" -
Apakah akan membuat pemisahan HWASAN.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--fdo_instrument=<a string>
: lihat deskripsi -
Buat biner dengan instrumentasi FDO. Dengan compiler Clang/LLVM, compiler ini juga menerima nama direktori tempat file profil mentah akan di-dump saat runtime.
Tag:affects_outputs
- Default
--fdo_optimize=<a string>
: 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. Flag ini juga menerima file yang ditentukan sebagai label (misalnya, `//foo/bar:file.afdo` - Anda mungkin perlu menambahkan perintah `exports_files` ke paket yang sesuai) dan label yang mengarah ke target `fdo_profile`. Flag ini akan diganti oleh aturan `fdo_profile`.
Tag:affects_outputs
- Default
--fdo_prefetch_hints=<a build target label>
: lihat deskripsi -
Gunakan petunjuk pengambilan data cache.
Tag:affects_outputs
- Default
--fdo_profile=<a build target label>
: 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 di-build dalam konfigurasi target. Menentukan -<feature> akan menonaktifkan fitur tersebut. Fitur negatif selalu menggantikan fitur positif. Lihat juga --host_features
Tag:changes_inputs
,affects_outputs
- Default
--[no]force_pic
: "false" -
Jika diaktifkan, semua kompilasi C++ akan menghasilkan kode yang tidak bergantung pada posisi ("-fPIC"), link lebih memilih library bawaan PIC daripada library non-PIC, dan link akan menghasilkan file yang dapat dieksekusi yang tidak bergantung pada 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 ditentukan berdasarkan nama, dalam hal ini nilai akan diambil dari lingkungan pemanggilan, atau dengan pasangan name=value yang menetapkan nilai yang terpisah dari lingkungan pemanggilan. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru akan digunakan, sedangkan opsi untuk variabel yang berbeda akan diakumulasikan.
Tag:action_command_lines
- Default
--host_compilation_mode=<fastbuild, dbg or opt>
: "opt" -
Tentukan mode yang akan digunakan alat selama 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 untuk diteruskan ke compiler C untuk alat yang dibuat dalam konfigurasi exec.
Tag:action_command_lines
,affects_outputs
- Default
--host_cpu=<a string>
: "" -
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 di-build 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 di-build dalam konfigurasi exec. Menentukan -<feature> akan menonaktifkan fitur tersebut. Fitur negatif selalu menggantikan fitur positif.
Tag:changes_inputs
,affects_outputs
- Default
--host_force_python=<PY2 or PY3>
: 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 exec.
Tag:action_command_lines
,affects_outputs
- Default
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi macOS minimum yang kompatibel untuk target host. Jika tidak ditentukan, gunakan 'macos_sdk_version'.
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. Sintaksis: filter_regex@opsi_1,opsi_2,...,opsi_n. Dengan regex_filter adalah daftar pola ekspresi reguler yang disertakan dan dikecualikan (Lihat juga --instrumentation_filter). option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus diapit dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ pertama yang 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
--host_swiftcopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke swiftc untuk alat exec.
Tag:action_command_lines
,affects_outputs
- Default
--[no]incompatible_auto_exec_groups
: "false" -
Jika diaktifkan, grup eksekusi akan otomatis dibuat untuk setiap toolchain yang digunakan oleh aturan. Agar aturan ini berfungsi, aturan harus menentukan parameter `toolchain` pada tindakannya. Untuk mengetahui informasi selengkapnya, lihat https://github.com/bazelbuild/bazel/issues/17134.
Tag:affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
default: "true"-
Jika true, direktori genfiles akan digabungkan ke dalam direktori bin.
Tag:affects_outputs
,incompatible_change
--[no]incompatible_use_host_features
default: "true"-
Jika benar, gunakan --features hanya untuk konfigurasi target dan --host_features untuk konfigurasi exec.
Tag:changes_inputs
,affects_outputs
,incompatible_change
- Default
--[no]instrument_test_targets
: "false" -
Saat cakupan diaktifkan, menentukan apakah akan mempertimbangkan untuk melakukan instrumentasi pada aturan pengujian. 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 diinstrumentasi. Sebagai gantinya, aturan yang diawali dengan '-' akan dikecualikan. Perhatikan bahwa hanya aturan non-pengujian yang diinstrumentasikan kecuali --instrument_test_targets diaktifkan.
Tag:affects_outputs
- Default
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi iOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'ios_sdk_version'.
Tag:loses_incremental_state
--ios_multi_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk membuat aplikasi ios_application. Hasilnya adalah biner universal yang berisi semua arsitektur yang ditentukan.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--[no]legacy_whole_archive
: "true" -
Tidak digunakan lagi, diganti dengan --incompatible_remove_legacy_whole_archive (lihat https://github.com/bazelbuild/bazel/issues/7362 untuk mengetahui detailnya). Jika 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 (di bagian --features=thin_lto).
Tag:action_command_lines
,affects_outputs
--macos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk mem-build biner Apple macOS.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi macOS minimum yang kompatibel untuk target. Jika tidak ditentukan, gunakan 'macos_sdk_version'.
Tag:loses_incremental_state
- Default
--memprof_profile=<a build target label>
: lihat deskripsi -
Gunakan profil memprof.
Tag:affects_outputs
- Default
--[no]objc_debug_with_GLIBCXX
: "false" -
Jika ditetapkan, dan mode kompilasi ditetapkan ke 'dbg', tentukan GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC, dan GLIBCPP_CONCEPT_CHECKS.
Tag:action_command_lines
- Default
--[no]objc_enable_binary_stripping
: "false" -
Apakah akan melakukan penghapusan simbol dan kode mati pada biner tertaut. Penghapusan 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. Sintaksis: regex_filter@option_1,option_2,...,option_n. Dengan regex_filter adalah daftar pola ekspresi reguler yang disertakan dan dikecualikan (Lihat juga --instrumentation_filter). option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus diapit dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ pertama yang 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 (di bagian --features=thin_lto) saat mengompilasi objek backend tertentu. Opsi ini dapat diteruskan beberapa kali. Sintaksis: regex_filter@option_1,option_2,...,option_n. Dengan regex_filter adalah daftar pola ekspresi reguler yang disertakan dan dikecualikan. option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus diapit dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ pertama yang 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
- Default
--platform_suffix=<a string>
: lihat deskripsi -
Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.
Tag:loses_incremental_state
,affects_outputs
,loading_and_analysis
- Default
--propeller_optimize=<a build target label>
: lihat deskripsi -
Gunakan informasi profil Propeller untuk mengoptimalkan target build.Profil propeller harus terdiri dari minimal salah satu dari dua file, profil cc dan profil ld. Flag ini menerima label build yang harus merujuk ke file input profil baling-baling. Misalnya, file BUILD yang menentukan label, di a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Perintah exports_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
- Default
--propeller_optimize_absolute_cc_profile=<a string>
: lihat deskripsi -
Nama jalur absolut file cc_profile untuk build yang Dioptimalkan dengan Propeller.
Tag:affects_outputs
- Default
--propeller_optimize_absolute_ld_profile=<a string>
: lihat deskripsi -
Nama jalur absolut file ld_profile untuk build Propeller Optimized.
Tag:affects_outputs
- Default
--run_under=<a prefix in front of command>
: 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', maka command line akhirnya adalah 'foo -bar test_binary -baz'.Ini juga dapat berupa label ke 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 true (benar), library native yang berisi fungsi identik akan digunakan bersama di antara target yang berbeda
Tag:loading_and_analysis
,affects_outputs
- Default
--[no]stamp
: "false" -
Menandai biner dengan tanggal, nama pengguna, nama host, informasi ruang kerja, dll.
Tag:affects_outputs
--strip=<always, sometimes or never>
default: "kadang-kadang"-
Menentukan apakah akan menghapus biner dan library bersama (menggunakan "-Wl,--strip-debug"). Nilai {i>default<i} 'kadang-kadang' berarti {i>strip iff<i} --compilation_mode=fastbuild.
Tag:affects_outputs
--stripopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan untuk dihapus saat membuat biner '<name>.stripped'.
Tag:action_command_lines
,affects_outputs
--swiftcopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke kompilasi Swift.
Tag:action_command_lines
- Default
--symlink_prefix=<a string>
: lihat deskripsi -
Awalan yang ditambahkan ke salah satu 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 ditampilkan. Peringatan: fungsi khusus untuk '/' tidak akan digunakan lagi dalam waktu dekat; sebagai gantinya, gunakan --experiment_concenience_symlinks=ignore.
Tag:affects_outputs
--tvos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk mem-build biner Apple tvOS.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi tvOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, akan menggunakan 'tvos_sdk_version'.
Tag:loses_incremental_state
--visionos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang digunakan untuk membangun 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 untuk mem-build biner Apple watchOS.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi watchOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'watchos_sdk_version'.
Tag:loses_incremental_state
- Default
--xbinary_fdo=<a build target label>
: lihat deskripsi -
Gunakan informasi profil XbinaryFDO untuk mengoptimalkan kompilasi. Tentukan nama profil lintas biner default. Jika opsi 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 menerapkan input build yang valid (definisi aturan, kombinasi flag, dll.):
- Default
--auto_cpu_environment_group=<a build target label>
: "" -
Deklarasikan environment_group yang akan digunakan untuk memetakan nilai cpu ke nilai target_environment secara otomatis.
Tag:changes_inputs
,loading_and_analysis
,experimental
- Default
--[no]check_licenses
: "false" -
Pastikan batasan pemberian lisensi yang diberlakukan oleh paket dependen tidak bertentangan dengan mode distribusi target yang sedang dibuat. Secara default, lisensi tidak dicentang.
Tag:build_file_semantics
- Default
--[no]check_visibility
: "true" -
Jika dinonaktifkan, error visibilitas dalam dependensi target akan diturunkan menjadi peringatan.
Tag:build_file_semantics
- Default
--[no]desugar_for_android
: "true" -
Apakah akan mendesugar bytecode Java 8 sebelum melakukan dexing.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--[no]desugar_java8_libs
: "false" -
Apakah akan menyertakan library Java 8 yang didukung dalam aplikasi untuk perangkat lama.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]enforce_constraints
: "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
- Default
--[no]experimental_check_desugar_deps
: "true" -
Apakah akan memeriksa ulang desugaring yang benar pada level biner Android.
Tag:eagerness_to_exit
,loading_and_analysis
,experimental
- Default
--experimental_import_deps_checking=<off, warning or error>
: "OFF" -
Jika diaktifkan, periksa apakah dependensi aar_import sudah selesai. Penerapan ini dapat merusak build, atau hanya dapat menghasilkan peringatan.
Tag:loading_and_analysis
- Default
--experimental_one_version_enforcement=<off, warning or error>
: "NONAKTIF" -
Jika diaktifkan, aturan java_binary tidak boleh berisi lebih dari satu versi file class yang sama di classpath. Penerapan ini dapat merusak build, atau hanya mengakibatkan peringatan.
Tag:loading_and_analysis
- Default
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "default" -
Jika benar, memeriksa apakah target Java secara eksplisit mendeklarasikan semua target yang digunakan secara langsung sebagai dependensi.
Tag:build_file_semantics
,eagerness_to_exit
- Default
--[no]incompatible_check_testonly_for_output_files
: "false" -
Jika diaktifkan, periksa hanya pengujian untuk target prasyarat yang merupakan file output dengan mencari pengujian aturan pembuatan saja. Hal ini cocok dengan pemeriksaan visibilitas.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_check_visibility_for_toolchains
: "false" -
Jika diaktifkan, pemeriksaan visibilitas juga berlaku untuk implementasi toolchain.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_disable_native_android_rules
: "false" -
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
- Default
--[no]incompatible_disable_native_apple_binary_rule
: "false" -
Tanpa pengoperasian. Tetap di sini untuk kompatibilitas mundur.
Tag:eagerness_to_exit
,incompatible_change
- Default
--[no]incompatible_python_disable_py2
: "true" -
Jika benar, menggunakan setelan Python 2 akan menyebabkan error. Ini mencakup 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
- Default
--[no]incompatible_validate_top_level_header_inclusions
: "true" -
Jika benar, Bazel juga akan memvalidasi penyertaan header direktori tingkat teratas (lihat https://github.com/bazelbuild/bazel/issues/10047 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,incompatible_change
--[no]one_version_enforcement_on_java_tests
default: "true"-
Jika diaktifkan, dan dengan experimental_one_version_enforcement ditetapkan ke nilai non-NONE, terapkan satu versi pada target java_test. Flag ini dapat dinonaktifkan untuk meningkatkan performa pengujian inkremental dengan mengorbankan potensi pelanggaran satu versi.
Tag:loading_and_analysis
- Default
--python_native_rules_allowlist=<a build target label>
: lihat deskripsi -
Daftar yang diizinkan (target package_group) yang akan digunakan saat menerapkan --incompatible_python_disallow_native_rules.
Tag:loading_and_analysis
- Default
--[no]strict_filesets
: "false" -
Jika opsi ini diaktifkan, set file yang melewati batas paket dilaporkan sebagai error.
Tag:build_file_semantics
,eagerness_to_exit
- Default
--strict_proto_deps=<off, warn, error, strict or default>
: "error" -
Kecuali NONAKTIF, periksa apakah target proto_library secara eksplisit mendeklarasikan semua target yang digunakan langsung sebagai dependensi.
Tag:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Default
--strict_public_imports=<off, warn, error, strict or default>
: "nonaktif" -
Kecuali jika NONAKTIF, memeriksa apakah target proto_library secara eksplisit mendeklarasikan semua target yang digunakan di 'import public' sebagai diekspor.
Tag:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Default
--[no]strict_system_includes
: "false" -
Jika 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 ditetapkan, semua target tingkat atas 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
- Default
--[no]device_debug_entitlements
: "true" -
Jika ditetapkan, dan mode kompilasi bukan 'opt', aplikasi objc akan menyertakan hak debug saat menandatangani.
Tag:changes_inputs
- Default
--ios_signing_cert_name=<a string>
: lihat deskripsi -
Nama sertifikat yang akan digunakan untuk penandatanganan iOS. Jika tidak ditetapkan, akan kembali ke profil penyediaan. Mungkin merupakan preferensi identitas keychain sertifikat atau (substring) nama umum sertifikat, sesuai dengan halaman man codesign (IDENTITAS PENANDATANGANAN).
Tag:action_command_lines
- Opsi ini memengaruhi semantik bahasa Starlark atau API build yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.
- Default
--[no]incompatible_config_setting_private_default_visibility
: "false" -
Jika incompatible_enforce_config_setting_visibility=false, ini adalah noop. Atau, jika tanda ini salah, config_setting apa pun tanpa atribut visibilitas eksplisit adalah //visibility:public. Jika tanda ini benar, config_setting akan mengikuti logika visibilitas yang sama dengan semua aturan lainnya. Lihat https://github.com/bazelbuild/bazel/issues/12933.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_disallow_legacy_py_provider
: "true" -
Tidak ada operasi, akan segera dihapus.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_disallow_sdk_frameworks_attributes
: "false" -
Jika benar, jangan izinkan atribut sdk_frameworks dan weak_sdk_frameworks di objc_library dan objc_import.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_enforce_config_setting_visibility
: "true" -
Jika true (benar), terapkan batasan visibilitas config_setting. Jika salah, setiap config_setting akan terlihat oleh setiap target. Lihat https://github.com/bazelbuild/bazel/issues/12932.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_objc_alwayslink_by_default
: "false" -
Jika benar, jadikan nilai default benar untuk atribut alwayslink di objc_library dan objc_import.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_python_disallow_native_rules
: "false" -
Jika benar, error akan terjadi saat menggunakan aturan py_* bawaan. Sebagai gantinya, aturan rule_python harus digunakan. Lihat https://github.com/bazelbuild/bazel/issues/17773 untuk mendapatkan informasi dan petunjuk migrasi selengkapnya.
Tag:loading_and_analysis
,incompatible_change
- Opsi yang mengatur perilaku lingkungan pengujian atau runner pengujian:
- Default
--[no]allow_analysis_failures
: "false" -
Jika benar, kegagalan analisis target aturan akan menyebabkan penyebaran instance AnalysisFailureInfo yang berisi deskripsi error, bukan menyebabkan 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
- Default
--[no]break_build_on_parallel_dex2oat_failure
: "false" -
Jika benar, kegagalan tindakan dex2oat akan menyebabkan build rusak, bukan menjalankan dex2oat selama runtime pengujian.
Tag:loading_and_analysis
,experimental
- Default
--[no]check_tests_up_to_date
: "false" -
Jangan jalankan pengujian, cukup periksa apakah pengujian tersebut sudah yang terbaru. Jika semua hasil pengujian sudah yang terbaru, pengujian akan berhasil diselesaikan. Jika ada pengujian yang 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- Ganti jumlah resource default untuk pengujian. Format yang diharapkan adalah <resource>=<value>. Jika satu angka positif ditentukan sebagai <value>, resource default untuk semua ukuran pengujian akan diganti. Jika 4 angka yang dipisahkan koma ditentukan, angka tersebut akan mengganti jumlah resource untuk ukuran pengujian kecil, sedang, besar, dan sangat besar. Nilai juga dapat berupa HOST_RAM/HOST_CPU, yang secara opsional diikuti dengan [-|*]<float> (misalnya, 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.
- Default
--[no]experimental_android_use_parallel_dex2oat
: "false" -
Gunakan dex2oat secara paralel untuk kemungkinan 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 percobaan untuk lulus ditandai sebagai 'FLEKSI' dalam ringkasan ujian. Biasanya, nilai yang ditentukan hanyalah bilangan bulat atau string 'default'. Jika berupa bilangan bulat, semua pengujian akan dijalankan hingga N kali. Jika 'default', hanya satu upaya pengujian yang akan dilakukan untuk pengujian reguler dan tiga untuk pengujian yang secara eksplisit ditandai sebagai tidak stabil oleh aturannya (atribut flaky=1). Sintaksis alternatif: regex_filter@flaky_test_attempts. Di mana flaky_test_attempts seperti di atas dan regex_filter merupakan singkatan dari include{i> <i}dan {i>excluded<i} pola ekspresi reguler (Lihat juga --runs_per_test). Contoh: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 akan menghapus semua pengujian di //foo/ kecuali yang berada di foo/bar tiga kali. Opsi ini dapat diteruskan beberapa kali. Argumen yang terakhir diteruskan yang cocok akan diutamakan. Jika tidak ada yang cocok, perilakunya akan seperti 'default' di atas.
Tag:execution
- Default
--[no]ios_memleaks
: "false" -
Mengaktifkan pemeriksaan kebocoran memori di target ios_test.
Tag:action_command_lines
- Default
--ios_simulator_device=<a string>
: 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 komputer tempat simulator akan dijalankan.
Tag:test_runner
- Default
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi iOS yang akan dijalankan pada simulator saat menjalankan atau melakukan pengujian. Hal ini diabaikan untuk aturan ios_test jika perangkat target ditentukan dalam aturan.
Tag:test_runner
- Default
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Jumlah maksimum tugas pengujian lokal yang akan berjalan secara serentak. Mengambil bilangan bulat, atau kata kunci ("auto", "HOST_CPUS", "HOST_RAM"), secara opsional diikuti dengan operasi ([-|*]<float>), misalnya. "auto", "HOST_CPUS*.5". 0 berarti resource lokal akan membatasi jumlah tugas pengujian lokal yang berjalan secara serentak. Menetapkan nilai ini lebih besar dari 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 frekuensi 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. Dengan runs_per_test adalah nilai bilangan bulat dan regex_filter adalah daftar pola ekspresi reguler yang disertakan dan dikecualikan (Lihat juga --instrumentation_filter). Contoh: --runs_per_test=//foo/.*,-//foo/bar/.*@3 menjalankan semua pengujian di //foo/ kecuali yang berada di foo/bar tiga kali. Opsi ini dapat diteruskan beberapa kali. Argumen yang terakhir diteruskan yang cocok akan diutamakan. Jika tidak ada yang cocok, pengujian hanya dijalankan sekali.
--test_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan variabel lingkungan tambahan yang akan dimasukkan ke dalam lingkungan runner pengujian. Variabel dapat ditentukan berdasarkan nama, dalam hal ini nilainya akan dibaca dari lingkungan klien Bazel, atau berdasarkan pasangan name=value. 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, setiap pengujian yang tidak lulus akan menyebabkan seluruh build berhenti. Secara default, semua pengujian dijalankan, meskipun beberapa tidak lulus.
Tag:execution
- Default
--test_strategy=<a string>
: "" -
Menentukan strategi yang akan digunakan saat menjalankan pengujian.
Tag:execution
- Default
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - Ganti nilai waktu tunggu pengujian default untuk waktu tunggu pengujian (dalam detik). Jika satu nilai bilangan bulat positif ditentukan, nilai tersebut akan menggantikan semua kategori. Jika 4 bilangan bulat yang dipisahkan koma ditentukan, bilangan bulat 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.
- Default
--test_tmpdir=<a path>
: lihat deskripsi - Menentukan direktori sementara dasar yang akan digunakan oleh 'pengujian bazel'.
- Default
--[no]zip_undeclared_test_outputs
: "true" -
Jika 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, konfigurasikan Bazel untuk meng-cache ringkasan file dalam memori berdasarkan metadatanya, bukan menghitung ulang ringkasan dari disk setiap kali diperlukan. Menetapkan nilai ini ke 0 akan memastikan kebenaran karena tidak semua perubahan file dapat dicatat dari metadata file. Jika bukan 0, angka ini menunjukkan ukuran cache sebagai jumlah ringkasan file yang akan di-cache.
- Default
--[no]experimental_filter_library_jar_with_program_jar
: "false" -
Memfilter ProGuard ProgramJar untuk menghapus class yang juga ada di LibraryJar.
Tag:action_command_lines
- Default
--[no]experimental_inmemory_dotd_files
: "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 di memori langsung dari node build jarak jauh, bukan ditulis ke disk.
Tag:loading_and_analysis
,execution
,affects_outputs
,experimental
- Default
--[no]experimental_objc_include_scanning
: "false" -
Apakah akan melakukan pemindaian untuk C/C++ objektif.
Tag:loading_and_analysis
,execution
,changes_inputs
- Default
--[no]experimental_retain_test_configuration_across_testonly
: "false" -
Jika diaktifkan, --trim_test_configuration tidak akan memangkas konfigurasi pengujian untuk aturan yang ditandai testonly=1. Hal ini dimaksudkan untuk mengurangi masalah konflik tindakan saat aturan non-pengujian bergantung pada aturan cc_test. Tidak berpengaruh jika --trim_test_configuration bernilai salah (false).
Tag:loading_and_analysis
,loses_incremental_state
- Default
--[no]experimental_starlark_cc_import
: "false" -
Jika diaktifkan, cc_import versi Starlark dapat digunakan.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_unsupported_and_brittle_include_scanning
: "false" -
Apakah akan mempersempit input ke kompilasi C/C++ dengan mengurai 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 include tidak sepenuhnya menerapkan semantik preprocessor C. Secara khusus, kode ini tidak memahami perintah #include dinamis dan mengabaikan logika bersyarat preprocessor. Risiko ditanggung sendiri. Masalah apa pun yang terkait dengan tanda ini yang diajukan akan ditutup.
Tag:loading_and_analysis
,execution
,changes_inputs
- Default
--[no]incremental_dexing
: "true" -
Melakukan sebagian besar pekerjaan untuk dexing secara terpisah untuk setiap file Jar.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
: "HOST_CPUS" -
Tetapkan secara eksplisit jumlah total core CPU lokal yang tersedia bagi Bazel untuk digunakan dalam tindakan build yang dijalankan secara lokal. Mengambil bilangan bulat, atau "HOST_CPUS", yang secara opsional diikuti dengan [-|*]<float> (misalnya, HOST_CPUS*.5 untuk menggunakan setengah 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-
Tetapkan 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 dijalankan secara serentak berdasarkan sumber daya tambahan dan sumber daya tambahan yang diperlukan. Pengujian dapat mendeklarasikan jumlah resource tambahan yang diperlukan dengan menggunakan tag format "resources:<resoucename>:<amount>". CPU, RAM, dan resource yang tersedia tidak dapat ditetapkan dengan flag ini.
Tag:host_machine_resource_optimizations
- Default
--local_ram_resources=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "HOST_RAM*.67" -
Tetapkan secara eksplisit jumlah total RAM host lokal (dalam MB) yang tersedia bagi Bazel untuk digunakan pada tindakan build yang dijalankan secara lokal. Mengambil bilangan bulat, atau "HOST_RAM", yang secara opsional diikuti dengan [-|*]<float> (misalnya, HOST_RAM*.5 untuk menggunakan setengah RAM yang tersedia). Secara default, ("HOST_RAM*.67"), Bazel akan membuat kueri konfigurasi sistem untuk memperkirakan jumlah RAM yang tersedia dan akan menggunakan 67% darinya.
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-
Tetapkan jumlah resource yang tersedia untuk Bazel. Menerima penetapan ke float atau HOST_RAM/HOST_CPUS, yang secara opsional diikuti dengan [-|*]<float> (misalnya, 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 mendeklarasikan jumlah resource yang diperlukan dengan menggunakan tag format "resources:<resource name>:<amount>". Mengganti resource yang ditentukan oleh --local_{cpu|ram|extra}_resources.
Tag:host_machine_resource_optimizations
- Default
--[no]objc_use_dotd_pruning
: "true" -
Jika ditetapkan, file .d yang dikeluarkan oleh clang akan digunakan untuk memangkas kumpulan input yang diteruskan ke kompilasi objc.
Tag:changes_inputs
,loading_and_analysis
- Default
--[no]process_headers_in_dependencies
: "false" -
Saat mem-build //a:a target, header proses di semua target yang //a:a bergantung (jika pemrosesan header diaktifkan untuk toolchain).
Tag:execution
- Default
--[no]trim_test_configuration
: "true" -
Jika diaktifkan, opsi terkait pengujian akan dihapus di bawah tingkat teratas build. Jika tanda ini aktif, pengujian tidak dapat dibuat sebagai dependensi aturan non-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 tingkat perincian, format, atau lokasi logging:
- Default
--[no]experimental_bep_target_summary
: "false" - Apakah akan memublikasikan peristiwa TargetSummary.
- Default
--[no]experimental_build_event_expand_filesets
: "false" -
Jika benar, luaskan Fileset di BEP saat menampilkan file output.
Tag:affects_outputs
- Default
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: "false" -
Jika benar, selesaikan symlink Fileset relatif di BEP saat menampilkan file output. Memerlukan --experimental_build_event_expand_filesets.
Tag:affects_outputs
- Default
--experimental_build_event_upload_max_retries=<an integer>
: "4" -
Frekuensi maksimum Bazel harus mencoba mengupload peristiwa build lagi.
Tag:bazel_internal_configuration
- Default
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1s" -
Penundaan awal minimum untuk percobaan ulang backoff eksponensial saat upload BEP gagal. (eksponen: 1,6)
Tag:bazel_internal_configuration
- Default
--experimental_build_event_upload_strategy=<a string>
: lihat deskripsi -
Memilih cara mengupload artefak yang dirujuk dalam protokol peristiwa build.
Tag:affects_outputs
- Default
--[no]experimental_materialize_param_files_directly
: "false" -
Jika mem-materialisasi file parameter, lakukan dengan penulisan langsung ke disk.
Tag:execution
- Default
--[no]experimental_run_bep_event_include_residue
: "false" -
Apakah akan menyertakan residu command line dalam peristiwa build run yang dapat berisi residu. Secara default, residu tidak disertakan dalam peristiwa build perintah run yang dapat berisi residu.
Tag:affects_outputs
- Default
--[no]experimental_stream_log_file_uploads
: "false" -
Upload file log streaming langsung ke penyimpanan jarak jauh, bukan menulisnya ke disk.
Tag:affects_outputs
- Default
--explain=<a path>
: lihat deskripsi -
Menyebabkan sistem build menjelaskan setiap langkah build yang dieksekusi. Penjelasan ditulis ke file log yang ditentukan.
Tag:affects_outputs
- Default
--[no]legacy_important_outputs
: "true" -
Gunakan ini untuk menyembunyikan pembuatan kolom important_outputs lama dalam peristiwa TargetComplete. important_outputs diperlukan untuk integrasi Bazel ke ResultStore.
Tag:affects_outputs
- Default
--[no]materialize_param_files
: "false" -
Menulis file parameter perantara ke hierarki output meskipun menggunakan eksekusi tindakan jarak jauh. Berguna saat men-debug tindakan. Hal ini tersirat oleh --subcommands dan --verbose_failures.
Tag:execution
- Default
--max_config_changes_to_show=<an integer>
: "3" -
Saat menghapus cache analisis karena perubahan pada opsi build, menampilkan hingga jumlah nama opsi yang diubah yang ditentukan. 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 maksimum per log pengujian yang dapat ditampilkan saat --test_output adalah 'errors' atau 'all'. Berguna untuk menghindari output yang berlebihan dengan output pengujian yang terlalu berisik. Header pengujian disertakan dalam ukuran log. Nilai negatif berarti tidak ada batas. Outputnya adalah semua atau tidak sama sekali.
Tag:test_runner
,terminal_output
,execution
- Default
--output_filter=<a valid Java regular expression>
: lihat deskripsi -
Hanya menampilkan peringatan dan output tindakan untuk aturan dengan nama yang cocok dengan ekspresi reguler yang diberikan.
Tag:affects_outputs
- Default
--progress_report_interval=<an integer in 0-3600 range>
: "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. Jika --curses diaktifkan, progres akan dilaporkan setiap detik.
Tag:affects_outputs
- Default
--show_result=<an integer>
: "1" -
Menampilkan hasil build. Untuk setiap target, nyatakan apakah target tersebut merupakan versi terbaru atau tidak, dan jika ya, buat daftar file output yang dibuat. File yang dicetak adalah string yang mudah untuk disalin+ditempel ke shell, untuk mengeksekusinya.
Opsi ini memerlukan argumen bilangan bulat, yang merupakan jumlah minimum target yang jika dilampaui, informasi hasilnya tidak akan dicetak. Dengan demikian, nol menyebabkan pesan ditiadakan dan MAX_INT menyebabkan pencetakan hasil selalu terjadi. Defaultnya adalah satu.
Jika tidak ada yang di-build untuk target, hasilnya dapat dihilangkan agar output tetap berada di bawah nilai minimum.
Tag:affects_outputs
--[no]subcommands
[-s
] default: "false"-
Menampilkan subperintah yang dieksekusi selama build. Flag terkait: --execution_log_json_file, --execution_log_binary_file (untuk mencatat subperintah ke file dalam format yang mudah digunakan alat).
Tag:terminal_output
--test_output=<summary, errors, all or streamed>
default: "ringkasan"-
Menentukan mode output yang diinginkan. Nilai yang valid adalah 'summary' untuk hanya menampilkan ringkasan status pengujian, 'errors' untuk juga mencetak log pengujian untuk pengujian yang gagal, 'all' untuk mencetak log untuk semua pengujian, dan 'streamed' untuk menampilkan log untuk semua pengujian secara real time (tindakan ini akan memaksa pengujian 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: "singkat"-
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 tidak berhasil dijalankan, 'detailed' untuk mencetak informasi mendetail tentang kasus pengujian yang gagal, 'testcase' untuk mencetak ringkasan dalam resolusi kasus pengujian, tidak mencetak informasi mendetail tentang kasus pengujian yang gagal, dan 'none' untuk menghapus ringkasan.
Tag:terminal_output
- Default
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
Mencetak informasi debug selama resolusi toolchain. Flag tersebut menggunakan ekspresi reguler, yang diperiksa berdasarkan jenis toolchain dan target tertentu untuk mengetahui mana yang akan di-debug. Beberapa ekspresi reguler dapat dipisahkan dengan koma, lalu setiap ekspresi reguler akan diperiksa secara terpisah. Catatan: Output flag ini sangat kompleks dan kemungkinan hanya akan berguna bagi pakar dalam resolusi toolchain.
Tag:terminal_output
- Default
--[no]verbose_explanations
: "false" -
Meningkatkan panjang penjelasan yang dikeluarkan jika --explain diaktifkan. Tidak berpengaruh jika --explain tidak diaktifkan.
Tag:affects_outputs
- Default
--[no]verbose_failures
: "false" -
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 aspek dalam daftar. Opsi ini dapat digunakan beberapa kali. Namun, Anda tidak diizinkan untuk 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. Fungsi ini memerlukan satu pasangan nilai kunci dalam bentuk "<key>=<value>" sebagai argumen.
Tag:changes_inputs
- Default
--[no]incompatible_default_to_explicit_init_py
: "false" -
Flag ini mengubah perilaku default sehingga file __init__.py tidak lagi dibuat secara otomatis di runfile target Python. Secara khusus, jika target py_binary atau py_test memiliki legacy_create_init yang ditetapkan ke "auto" (default), target tersebut akan diperlakukan sebagai salah jika dan hanya jika tanda ini ditetapkan. Lihat https://github.com/bazelbuild/bazel/issues/10076.
Tag:affects_outputs
,incompatible_change
- Default
--[no]incompatible_py2_outputs_are_suffixed
: "true" -
Jika benar, target yang di-build dalam konfigurasi Python 2 akan muncul di root output yang menyertakan akhiran '-py2', sedangkan target yang di-build untuk Python 3 akan muncul di root tanpa akhiran terkait Python. Ini berarti bahwa symlink praktis `bazel-bin` akan mengarah ke target Python 3, bukan Python 2. Jika Anda mengaktifkan opsi ini, sebaiknya aktifkan juga `--incompatible_py3_is_default`.
Tag:affects_outputs
,incompatible_change
- Default
--[no]incompatible_py3_is_default
: "true" -
Jika benar, 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 setel `--incompatible_py2_outputs_are_suffixed`.
Tag:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
default: "true"-
Jika ditetapkan 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
- Default
--python_version=<PY2 or PY3>
: lihat deskripsi -
Mode versi utama Python, baik `PY2` maupun `PY3`. Perhatikan bahwa ini diganti oleh target `py_binary` dan `py_test` (meskipun tidak menentukan versi secara eksplisit) sehingga biasanya tidak ada banyak alasan untuk memberikan tanda ini.
Tag:loading_and_analysis
,affects_outputs
- Default
--target_pattern_file=<a string>
: "" -
Jika ditetapkan, build akan membaca pola dari file yang diberi nama di sini, bukan di command line. Menentukan file di sini serta pola command line akan menyebabkan error.
Tag:changes_inputs
- Opsi eksekusi dan penyimpanan dalam cache jarak jauh:
- Default
--experimental_remote_cache_eviction_retries=<an integer>
: "0" -
Jumlah maksimum percobaan ulang jika build mengalami error cache jarak jauh sementara yang akan menggagalkan build. Berlaku misalnya saat artefak dihapus dari cache jarak jauh, atau dalam kondisi kegagalan cache tertentu. Nilai yang bukan nol akan secara implisit menetapkan --incompatible_remote_use_new_exit_code_for_lost_inputs ke benar. ID pemanggilan baru akan dibuat untuk setiap percobaan. Jika Anda membuat ID pemanggilan dan memberikannya ke Bazel dengan --invocation_id, Anda tidak boleh menggunakan flag ini. Sebagai gantinya, tetapkan flag --incompatible_remote_use_new_exit_code_for_lost_inputs dan periksa kode keluar 39.
Tag:execution
- Default
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
: "true" -
Jika ditetapkan ke benar, Bazel akan menggunakan kode keluar baru 39, bukan 34, jika error cache jarak jauh, termasuk penghapusan cache, menyebabkan build gagal.
Tag:incompatible_change
- Opsi lain, tidak dikategorikan.:
- Default
--[no]allow_analysis_cache_discard
: "true" -
Jika menghapus cache analisis karena perubahan pada sistem build, menetapkan opsi ini ke salah akan menyebabkan bazel keluar, bukan melanjutkan build. Opsi ini tidak berpengaruh jika 'discard_analysis_cache' juga ditetapkan.
Tag:eagerness_to_exit
- Default
--[no]build_manual_tests
: "false" - Memaksa target pengujian yang diberi tag 'manual' untuk di-build. Pengujian 'manual' dikecualikan dari pemrosesan. Opsi ini memaksa skrip tersebut untuk dibuat (tetapi tidak dijalankan).
- Default
--build_tag_filters=<comma-separated list of options>
: "" - Menentukan daftar tag yang dipisahkan koma. Setiap tag dapat diawali dengan '-' secara opsional untuk menentukan tag yang dikecualikan. Hanya target tersebut yang akan dibuat dengan setidaknya satu tag disertakan dan tidak berisi tag yang dikecualikan. Opsi ini tidak memengaruhi kumpulan pengujian yang dijalankan dengan perintah 'test'; opsi tersebut diatur oleh opsi pemfilteran pengujian, misalnya '--test_tag_filters'
- Default
--[no]build_tests_only
: "false" - 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 di-build.
--[no]cache_test_results
[-t
] default: "auto"- Jika ditetapkan ke 'auto', Bazel akan menjalankan ulang pengujian jika dan hanya jika: (1) Bazel mendeteksi perubahan dalam pengujian atau dependensinya, (2) pengujian ditandai sebagai eksternal, (3) beberapa pengujian dijalankan 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 'no', Bazel tidak akan menyimpan hasil pengujian dalam cache.
- Default
--[no]compile_one_dependency
: "false" - Kompilasi satu dependensi file argumen. Hal ini berguna untuk memeriksa sintaksis file sumber di IDE, misalnya, dengan mem-build ulang satu target yang bergantung pada file sumber untuk mendeteksi error sedini mungkin dalam siklus edit/build/pengujian. Argumen ini memengaruhi cara semua argumen non-flag ditafsirkan; bukan target untuk mem-build, argumen ini adalah nama file sumber. Untuk setiap nama file sumber, target arbitrer yang bergantung padanya akan dibuat.
--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 terlihat di suatu tempat pada jalur paket. Gunakan opsi ini saat menghapus subpaket '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 masih disediakan oleh entri package_path lain. Menentukan --dihapus_packages x/y untuk menghindari masalah ini.
- Default
--[no]discard_analysis_cache
: "false" - Segera hapus cache analisis setelah fase analisis selesai. Mengurangi penggunaan memori sebesar ~10%, tetapi membuat build inkremental lebih lambat.
- Default
--execution_log_binary_file=<a path>
: lihat deskripsi - Buat log spawn yang dieksekusi ke dalam file ini sebagai proto SpawnExec yang dibatasi panjang, sesuai dengan src/main/protobuf/spawn.proto. Pilih --execution_log_compact_file, yang jauh lebih kecil dan lebih murah untuk dibuat. Flag terkait: --execution_log_compact_file (format ringkas; saling eksklusif), --execution_log_json_file (format JSON teks; saling eksklusif), --execution_log_sort (apakah akan mengurutkan log eksekusi), --subcommands (untuk menampilkan subperintah dalam output terminal).
- Default
--execution_log_compact_file=<a path>
: lihat deskripsi - Buat log spawn yang dieksekusi ke dalam file ini sebagai proto ExecLogEntry yang dibatasi panjang, sesuai dengan src/main/protobuf/spawn.proto. Seluruh file dikompresi dengan zstd. Flag terkait: --execution_log_binary_file (format protobuf biner; saling eksklusif), --execution_log_json_file (format JSON teks; saling eksklusif), --subcommands (untuk menampilkan subperintah dalam output terminal).
- Default
--execution_log_json_file=<a path>
: lihat deskripsi - Mencatat spawn yang dieksekusi ke dalam file ini sebagai representasi JSON yang dibatasi baris baru dari proto SpawnExec, sesuai dengan src/main/protobuf/spawn.proto. Pilih --execution_log_compact_file, yang jauh lebih kecil dan lebih murah untuk dibuat. Flag terkait: --execution_log_compact_file (format ringkas; saling eksklusif), --execution_log_binary_file (format protobuf biner; saling eksklusif), --execution_log_sort (apakah akan mengurutkan log eksekusi), --subcommands (untuk menampilkan subperintah di output terminal).
- Default
--[no]execution_log_sort
: "true" - Apakah akan mengurutkan log eksekusi, sehingga mempermudah perbandingan log di seluruh pemanggilan. Tetapkan ke salah untuk menghindari penggunaan CPU dan memori yang berpotensi signifikan di akhir pemanggilan, dengan mengorbankan pembuatan log dalam urutan eksekusi nondeterministik. Hanya berlaku untuk format biner dan JSON; format ringkas tidak pernah diurutkan.
- Default
--[no]expand_test_suites
: "true" -
Luaskan target test_suite ke dalam pengujian penyusunnya sebelum 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 saat aspek tingkat atas diterapkan di command line: kemudian, aspek tersebut dapat menganalisis target test_suite.
Tag:loading_and_analysis
- Default
--[no]experimental_cancel_concurrent_tests
: "false" -
Jika benar, Blaze akan membatalkan pengujian yang berjalan secara serentak pada pengujian pertama yang berhasil. Opsi ini hanya berguna jika digunakan bersama --runs_per_test_detects_flakes.
Tag:affects_outputs
,loading_and_analysis
- Default
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "" - Tidak digunakan lagi dan digantikan dengan aspek. Memfilter kumpulan target untuk menjadwalkan extra_actions.
- Default
--[no]experimental_extra_action_top_level_only
: "false" - Tidak digunakan lagi dan digantikan dengan aspek. Hanya menjadwalkan extra_actions untuk target tingkat atas.
- Default
--[no]experimental_fetch_all_coverage_outputs
: "false" -
Jika benar, Bazel akan mengambil seluruh direktori data cakupan untuk setiap pengujian selama cakupan dijalankan.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_generate_llvm_lcov
: "false" -
Jika benar, cakupan untuk clang akan menghasilkan laporan LCOV.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_j2objc_header_map
: "true" - Apakah akan membuat peta header J2ObjC secara paralel dengan transpilasi J2ObjC.
- Default
--[no]experimental_j2objc_shorter_header_path
: "false" -
Apakah akan dibuat dengan jalur header yang lebih pendek (menggunakan "_ios", bukan "_j2objc").
Tag:affects_outputs
- Default
--experimental_java_classpath=<off, javabuilder or bazel>
: "javabuilder" - Mengaktifkan classpath yang dikurangi untuk kompilasi Java.
- Default
--[no]experimental_limit_android_lint_to_android_constrained_java
: "false" -
Membatasi --experimental_run_android_lint_on_java_rules ke library yang kompatibel dengan Android.
Tag:affects_outputs
- Default
--[no]experimental_run_android_lint_on_java_rules
: "false" -
Apakah akan memvalidasi sumber java_*.
Tag:affects_outputs
- Default
--[no]explicit_java_test_deps
: "false" - Secara eksplisit menentukan dependensi ke JUnit atau Hamcrest dalam java_test, bukan mendapatkan secara tidak sengaja dari dependensi TestRunner. Saat ini hanya berfungsi untuk bazel.
--[no]fetch
default: "true"- Mengizinkan perintah mengambil dependensi eksternal. Jika disetel ke salah (false), perintah akan menggunakan versi dependensi yang di-cache, dan jika tidak ada, perintah akan gagal.
- Default
--host_java_launcher=<a build target label>
: lihat deskripsi - Peluncur Java yang digunakan oleh alat yang dijalankan selama build.
--host_javacopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan untuk diteruskan ke javac saat mem-build alat yang dijalankan selama build.
--host_jvmopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke VM Java saat mem-build alat yang dieksekusi selama 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 yang di-sharding jika runner pengujian tidak menunjukkan bahwa ia mendukung sharding dengan menyentuh file di jalur dalam TEST_SHARD_STATUS_FILE. Jika salah, runner pengujian yang tidak mendukung sharding akan menyebabkan semua pengujian berjalan di setiap shard.
Tag:incompatible_change
- Default
--[no]incompatible_exclusive_test_sandboxed
: "true" -
Jika benar, pengujian eksklusif akan berjalan dengan strategi dalam sandbox. Menambahkan tag 'local' untuk memaksa pengujian eksklusif berjalan secara lokal
Tag:incompatible_change
- Default
--[no]incompatible_strict_action_env
: "false" -
Jika 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 spesifik dari klien, tetapi perhatikan bahwa hal itu dapat mencegah caching 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 mematuhi JDWP (seperti jdb) sebelum memulai pengujian. Menunjukkan -test_output=streamed.
Diluaskan menjadi:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
default: "true"- Buat informasi dependensi (untuk saat ini, classpath waktu kompilasi) per target Java.
- Default
--[no]java_header_compilation
: "true" - Mengompilasi ijar langsung dari sumber.
- Default
--java_language_version=<a string>
: "" - Versi bahasa Java
- Default
--java_launcher=<a build target label>
: lihat deskripsi - Peluncur Java yang akan digunakan saat mem-build biner Java. Jika tanda ini ditetapkan ke string kosong, peluncur JDK akan digunakan. Atribut "launcher" akan mengganti tanda ini.
- Default
--java_runtime_version=<a string>
: "local_jdk" - Versi runtime Java
--javacopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke javac.
--jvmopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke VM Java. Opsi ini akan ditambahkan ke opsi startup VM setiap target java_binary.
- Default
--legacy_main_dex_list_generator=<a build target label>
: 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 tunggu antara penghentian proses lokal karena waktu tunggu habis dan penonaktifan paksa.
- Default
--optimizing_dexer=<a build target label>
: 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 untuk mencari paket. Elemen yang diawali dengan '%workspace%' bersifat relatif terhadap ruang kerja yang melingkupinya. 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.
- Default
--proguard_top=<a build target label>
: lihat deskripsi - Menentukan versi ProGuard yang digunakan untuk penghapusan kode saat mem-build biner Java.
- Default
--proto_compiler=<a build target label>
: "@bazel_tools//tools/proto:protoc" -
Label proto-compiler.
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_toolchain"-
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 yang akan diteruskan ke compiler protobuf.
Tag:affects_outputs
- Default
--[no]runs_per_test_detects_flakes
: "false" - Jika benar, setiap shard yang setidaknya memiliki satu operasi/upaya yang berhasil dan setidaknya satu operasi/upaya yang gagal akan mendapatkan status FLAKY.
- Default
--shell_executable=<a path>
: lihat deskripsi -
Jalur absolut ke shell yang dapat dieksekusi untuk digunakan Bazel. Jika variabel ini tidak disetel, tetapi variabel lingkungan BAZEL_SH disetel pada pemanggilan Bazel pertama (yang memulai server Bazel), Bazel akan menggunakannya. Jika tidak ada yang ditetapkan, Bazel akan menggunakan jalur default hard code bergantung pada sistem operasi tempatnya berjalan (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, semua 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 "Loading package:".
--test_arg=<a string>
beberapa penggunaan diakumulasikan- Menentukan opsi dan argumen tambahan yang harus diteruskan ke file yang dapat dieksekusi pengujian. Dapat digunakan beberapa kali untuk menentukan beberapa argumen. Jika beberapa pengujian dijalankan, setiap pengujian akan menerima argumen yang sama. Hanya digunakan oleh perintah 'bazel test'.
- Default
--test_filter=<a string>
: lihat deskripsi - Menentukan filter untuk diteruskan ke framework pengujian. Digunakan untuk membatasi pengujian yang dijalankan. Perhatikan bahwa hal ini tidak memengaruhi target yang di-build.
- Default
--test_lang_filters=<comma-separated list of options>
: "" - Menentukan daftar bahasa pengujian yang dipisahkan koma. Setiap bahasa dapat secara opsional didahului dengan '-' untuk menentukan bahasa yang dikecualikan. Hanya target pengujian yang ditulis dalam bahasa yang ditentukan yang akan ditemukan. Nama yang digunakan untuk setiap bahasa harus sama dengan awalan bahasa dalam 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.
- Default
--[no]test_runner_fail_fast
: "false" - Teruskan opsi fail fast ke runner pengujian. 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>
: "explicit" - Menentukan strategi untuk sharding pengujian: 'explicit' 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'.
- Default
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
: "" - Menentukan daftar ukuran pengujian yang dipisahkan koma. Setiap ukuran dapat secara opsional didahului 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.
- Default
--test_tag_filters=<comma-separated list of options>
: "" - Menentukan daftar tag pengujian yang dipisahkan koma. Setiap tag dapat diawali dengan '-' secara opsional untuk menentukan tag yang dikecualikan. Hanya target pengujian yang berisi setidaknya satu tag yang disertakan dan tidak berisi tag yang dikecualikan yang akan ditemukan. Opsi ini memengaruhi perilaku --build_tests_only dan perintah pengujian.
- Default
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
: "" - Menentukan daftar waktu tunggu pengujian yang dipisahkan koma. Setiap waktu tunggu dapat secara opsional didahului dengan '-' untuk menentukan waktu tunggu yang dikecualikan. Hanya target pengujian yang akan ditemukan yang berisi setidaknya satu waktu tunggu yang disertakan dan tidak berisi waktu tunggu yang dikecualikan. Opsi ini memengaruhi perilaku --build_tests_only dan perintah pengujian.
- Default
--tool_java_language_version=<a string>
: "" - Versi bahasa Java yang digunakan untuk menjalankan alat yang diperlukan selama proses build
- Default
--tool_java_runtime_version=<a string>
: "remotejdk_11" - Versi runtime Java yang digunakan untuk menjalankan alat selama build
- Default
--[no]use_ijars
: "true" - Jika diaktifkan, opsi ini akan menyebabkan kompilasi Java menggunakan jar antarmuka. Hal ini akan menghasilkan kompilasi inkremental yang lebih cepat, tetapi pesan error dapat berbeda.
Opsi tanda kanonis
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
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika disetel, cache repositori akan melakukan hardlink pada file jika cache ditemukan, bukan menyalinnya. Tindakan ini dimaksudkan untuk menghemat kapasitas disk.
Tag:bazel_internal_configuration
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum percobaan error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--[no]incompatible_disable_native_repo_rules
: "false" -
Jika salah, aturan repo native dapat digunakan di WORKSPACE; jika tidak, aturan repo Starlark harus digunakan. Aturan repo native mencakup local_repository, new_local_repository, local_config_platform, android_sdk_repository, dan android_ndk_repository.
Tag:bazel_internal_configuration
- Default
--repository_cache=<a path>
: lihat deskripsi -
Menentukan lokasi cache 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
- Default
--[no]repository_disable_download
: "false" -
Jika ditetapkan, download menggunakan ctx.download{,_and_extract} tidak diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file yang dapat dieksekusi arbitrer 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 dengan masa berlaku yang terisi (0-100) yang di atas batasnya GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika disetel ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi yang mengontrol output perintah:
- Default
--[no]canonicalize_policy
: "false" -
Menampilkan kebijakan kanonis, setelah perluasan dan pemfilteran. Agar output tetap bersih, argumen perintah yang dikanonikasikan TIDAK akan ditampilkan jika opsi ini ditetapkan ke 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
- Default
--[no]experimental_include_default_values
: "false" -
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.:
- Default
--[no]incompatible_config_setting_private_default_visibility
: "false" -
Jika incompatible_enforce_config_setting_ visibility=false, berarti ini adalah noop. Selain itu, jika tanda ini salah, config_setting apa pun tanpa atribut visibilitas eksplisit adalah //visibility:public. Jika tanda ini benar, config_setting akan mengikuti logika visibilitas yang sama dengan semua aturan lainnya. Lihat https://github.com/bazelbuild/bazel/issues/12933.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_enforce_config_setting_visibility
: "true" -
Jika benar, terapkan batasan visibilitas config_setting. Jika salah, setiap config_setting akan terlihat oleh setiap target. Lihat https://github.com/bazelbuild/bazel/issues/12932.
Tag:loading_and_analysis
,incompatible_change
- Opsi yang terkait dengan output dan semantik 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 dideklarasikan dihapus di registry tempatnya berasal (jika tidak 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 menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Memeriksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasinya ke kegagalan resolusi, `nonaktif` untuk menonaktifkan pemeriksaan, atau `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi.
Tag:loading_and_analysis
- Default
--check_direct_dependencies=<off, warning or error>
: "peringatan" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di modul root adalah versi yang sama dengan yang Anda dapatkan di grafik dependensi yang di-resolve. Nilai yang valid adalah `nonaktif` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasinya ke kegagalan resolusi.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` di MODULE.bazel dari modul root. Perhatikan bahwa dependensi developer tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai tanda ini.
Tag:loading_and_analysis
- Default
--lockfile_mode=<off, update, refresh or error>
: "update" -
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan mengupdatenya jika ada perubahan, `refresh` untuk memuat ulang informasi yang dapat diubah (versi yang ditarik dan modul yang sebelumnya tidak ada) dari registry jarak jauh dari waktu ke waktu, `error` untuk menggunakan file kunci, tetapi menampilkan error jika tidak terbaru, atau `off` untuk tidak membaca dari atau menulis ke file kunci.
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 <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
--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 baru akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
- Default
--vendor_dir=<a path>
: lihat deskripsi -
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalam atau menggunakannya saat mem-build. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
default: "1detik:2,20detik:3,1menit:5"-
Batas yang, jika tercapai, menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan period adalah durasi dan count adalah bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap gen lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan yang 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 diperlukan akan dihapus hingga beberapa kali per panggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC minor terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC minor tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat peristiwa GC minor terjadi dan nilai minimum 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 penggunaan persentase heap yang dipertahankan setidaknya pada batas ini, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan. Dengan menyesuaikan hal ini, Anda dapat mengurangi dampak waktu berjalan dari thrashing GC, jika thrashing GC (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada merekonstruksi status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
- Default
--experimental_command_profile=<cpu, wall, alloc or lock>
: lihat deskripsi - Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alloc, atau lock) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa pada direktori basis output. Sintaksis dan semantik tanda ini dapat berubah pada masa mendatang untuk mendukung jenis profil atau format output tambahan; gunakan dengan risiko Anda sendiri.
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan dieksekusi terbanyak. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input umum untuk perintah Bazel yang tidak termasuk dalam kategori lain.:
- Default
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Jika tidak kosong, baca file terselesaikan yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Default
--for_command=<a string>
: "build" -
Perintah yang opsinya harus dikanonikalisasi.
Tag:affects_outputs
,terminal_output
- Default
--invocation_policy=<a string>
: "" -
Menerapkan kebijakan pemanggilan ke opsi yang akan dikanonikasikan.
Tag:affects_outputs
,terminal_output
- Opsi eksekusi dan penyimpanan dalam cache jarak jauh:
- Default
--experimental_downloader_config=<a string>
: lihat deskripsi - Menentukan file yang akan dikonfigurasi dengan downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali dengan perintah (`allow`, `block`, atau `rewrite`), diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk dicocokkan, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik yang dimulai dari `$1`. Anda dapat memberikan beberapa perintah `rewrite` untuk URL yang sama, dan dalam hal ini beberapa URL akan ditampilkan.
- Default
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Mode thread yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dihentikan. Jika tidak, gunakan thread pekerja virtual.
- Opsi lainnya, 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 terlihat di suatu tempat pada jalur paket. Gunakan opsi ini saat 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 masih disediakan oleh entri package_path lain. Menentukan --dihapus_packages x/y untuk menghindari masalah ini.
- Default
--[no]fetch
: "true" - Mengizinkan perintah mengambil dependensi eksternal. Jika kebijakan disetel ke salah (false), perintah akan menggunakan versi dependensi yang di-cache, dan jika tidak ada, perintah akan mengakibatkan kegagalan.
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root ruang kerja, yang merupakan output `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
- Default
--package_path=<colon-separated list of options>
: "%workspace%" - Daftar yang dipisahkan titik dua untuk tempat mencari paket. Elemen yang diawali dengan '%workspace%' bersifat relatif terhadap ruang kerja yang melingkupinya. Jika dihilangkan atau kosong, defaultnya adalah output dari 'bazel info default-package-path'.
- Default
--[no]show_loading_progress
: "true" - Jika diaktifkan, akan menyebabkan Bazel mencetak pesan "Loading package:".
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
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika disetel, cache repositori akan melakukan hardlink pada file jika cache ditemukan, bukan menyalinnya. Hal ini dimaksudkan untuk menghemat kapasitas disk.
Tag:bazel_internal_configuration
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum percobaan error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--[no]incompatible_disable_native_repo_rules
: "false" -
Jika salah, aturan repo native dapat digunakan di WORKSPACE; jika tidak, aturan repo Starlark harus digunakan. Aturan repo native mencakup local_repository, new_local_repository, local_config_platform, android_sdk_repository, dan android_ndk_repository.
Tag:bazel_internal_configuration
- Default
--repository_cache=<a path>
: lihat deskripsi -
Menentukan lokasi cache 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
- Default
--[no]repository_disable_download
: "false" -
Jika ditetapkan, download menggunakan ctx.download{,_and_extract} tidak diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file yang dapat dieksekusi arbitrer 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 dengan masa berlaku yang terisi (0-100) yang di atas batasnya GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika disetel ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi yang mengontrol output perintah:
- Default
--[no]async
: "false" -
Jika benar, pembersihan output bersifat asinkron. Setelah perintah ini selesai, Anda dapat menjalankan perintah baru di klien yang sama dengan aman, meskipun penghapusan mungkin berlanjut di latar belakang.
Tag:host_machine_resource_optimizations
- Default
--[no]expunge
: "false" -
Jika true, clean akan menghapus seluruh hierarki kerja untuk instance bazel ini, yang mencakup semua file output build dan sementara yang dibuat oleh bazel, serta menghentikan server bazel jika sedang berjalan.
Tag:host_machine_resource_optimizations
--expunge_async
-
Jika ditentukan, bersih akan menghapus seluruh hierarki kerja secara asinkron untuk instance bazel ini, yang mencakup semua file output sementara dan build yang dibuat bazel, serta menghentikan server bazel jika sedang berjalan. Setelah perintah ini selesai, Anda dapat menjalankan perintah baru di klien yang sama dengan aman, meskipun penghapusan mungkin berlanjut di latar belakang.
Diperluas menjadi:
--expunge
--async
Tag:host_machine_resource_optimizations
- Opsi yang terkait dengan output dan semantik 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 dideklarasikan dihapus di registry tempatnya berasal (jika tidak berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang ditarik yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Periksa kompatibilitas versi bazel dari modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasinya ke kegagalan resolusi, `nonaktif` untuk menonaktifkan pemeriksaan, atau `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi.
Tag:loading_and_analysis
- Default
--check_direct_dependencies=<off, warning or error>
: "peringatan" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di modul root adalah versi yang sama dengan yang Anda dapatkan di grafik dependensi yang di-resolve. Nilai yang valid adalah `nonaktif` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasinya ke kegagalan resolusi.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` di MODULE.bazel dari modul root. Perhatikan bahwa dependensi developer tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai tanda ini.
Tag:loading_and_analysis
- Default
--lockfile_mode=<off, update, refresh or error>
: "update" -
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan mengupdatenya jika ada perubahan, `refresh` untuk memuat ulang informasi yang dapat diubah (versi yang ditarik dan modul yang sebelumnya tidak ada) dari registry jarak jauh dari waktu ke waktu, `error` untuk menggunakan file kunci, tetapi menampilkan error jika tidak terbaru, atau `off` untuk tidak membaca dari atau menulis ke file kunci.
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 <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutan ini penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
- Default
--vendor_dir=<a path>
: lihat deskripsi -
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalam atau menggunakannya saat mem-build. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
default: "1detik:2,20detik:3,1menit:5"-
Batas yang, jika tercapai, menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan period adalah durasi dan count adalah bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap gen lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat 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 diperlukan akan dihapus hingga berkali-kali per panggilan. Default-nya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC minor tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat peristiwa GC minor terjadi dan nilai minimum 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 persentase heap yang dipertahankannya setidaknya mencapai nilai minimum ini, status Skyframe sementara yang tidak diperlukan akan dihapus. Dengan menyesuaikan hal ini, Anda dapat mengurangi dampak waktu berjalan dari thrashing GC, jika thrashing GC (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada merekonstruksi status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
- Default
--experimental_command_profile=<cpu, wall, alloc or lock>
: lihat deskripsi - Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alloc, atau lock) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama sesuai jenis peristiwa di direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah pada masa mendatang untuk mendukung jenis profil atau format output tambahan; gunakan dengan risiko Anda sendiri.
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemoni dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemoni.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
- Default
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Jika tidak kosong, baca file yang di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan penyimpanan dalam cache jarak jauh:
- Default
--experimental_downloader_config=<a string>
: lihat deskripsi - Menentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali dengan perintah (`allow`, `block`, atau `rewrite`), diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk dicocokkan, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik yang dimulai dari `$1`. Anda dapat memberikan beberapa perintah `rewrite` untuk URL yang sama, dan dalam hal ini beberapa URL akan ditampilkan.
- Default
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Mode thread yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dihentikan. Jika tidak, gunakan thread pekerja virtual.
- Opsi lainnya, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
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
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika ditetapkan, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Tindakan ini dimaksudkan untuk menghemat kapasitas disk.
Tag:bazel_internal_configuration
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum percobaan error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--[no]incompatible_disable_native_repo_rules
: "false" -
Jika salah, aturan repo native dapat digunakan di WORKSPACE; jika tidak, aturan repo Starlark harus digunakan. Aturan repo native mencakup local_repository, new_local_repository, local_config_platform, android_sdk_repository, dan android_ndk_repository.
Tag:bazel_internal_configuration
- Default
--repository_cache=<a path>
: lihat deskripsi -
Menentukan lokasi cache 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
- Default
--[no]repository_disable_download
: "false" -
Jika disetel, mendownload menggunakan ctx.download{,_and_extract} tidak diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file yang dapat dieksekusi arbitrer 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 tenur yang ditempati (0-100) dan di atas nilai tersebut GcThrashingDetector menganggap peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika disetel ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi yang terkait dengan output dan semantik 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 dideklarasikan dihapus di registry tempatnya berasal (jika tidak berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang ditarik yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Memeriksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasinya ke kegagalan resolusi, `nonaktif` untuk menonaktifkan pemeriksaan, atau `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi.
Tag:loading_and_analysis
- Default
--check_direct_dependencies=<off, warning or error>
: "peringatan" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di modul root adalah versi yang sama dengan yang Anda dapatkan di grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `warning` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasinya ke kegagalan resolusi.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` di MODULE.bazel dari modul root. Perhatikan bahwa dependensi developer tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai tanda ini.
Tag:loading_and_analysis
- Default
--lockfile_mode=<off, update, refresh or error>
: "update" -
Menentukan cara dan apakah kunci file digunakan atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan mengupdatenya jika ada perubahan, `refresh` untuk memuat ulang informasi yang dapat diubah (versi yang ditarik dan modul yang sebelumnya tidak ada) dari registry jarak jauh dari waktu ke waktu, `error` untuk menggunakan file kunci, tetapi menampilkan error jika tidak terbaru, atau `off` untuk tidak membaca dari atau menulis ke file kunci.
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 <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
--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 baru akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
- Default
--vendor_dir=<a path>
: lihat deskripsi -
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalam atau menggunakannya saat mem-build. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
default: "1detik:2,20detik:3,1menit:5"-
Batas yang, jika tercapai, menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlahnya adalah bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap gen lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti bahwa peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC minor terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC minor tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat peristiwa GC minor terjadi dan nilai minimum 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 persentase heap yang dipertahankannya setidaknya mencapai nilai minimum ini, status Skyframe sementara yang tidak diperlukan akan dihapus. Dengan menyesuaikan hal ini, Anda dapat mengurangi dampak waktu berjalan dari thrashing GC, jika thrashing GC (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada merekonstruksi status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
- Default
--experimental_command_profile=<cpu, wall, alloc or lock>
: lihat deskripsi - Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alloc, atau lock) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama sesuai jenis peristiwa di direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah pada masa mendatang untuk mendukung jenis profil atau format output tambahan; gunakan dengan risiko Anda sendiri.
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemoni dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input umum untuk perintah Bazel yang tidak termasuk dalam kategori lain.:
- Default
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Jika tidak kosong, baca file yang di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan penyimpanan dalam cache jarak jauh:
- Default
--experimental_downloader_config=<a string>
: lihat deskripsi - Menentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali dengan perintah (`allow`, `block`, atau `rewrite`), diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk dicocokkan, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik yang dimulai dari `$1`. Anda dapat memberikan beberapa perintah `rewrite` untuk URL yang sama, dan dalam hal ini beberapa URL akan ditampilkan.
- Default
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Mode thread yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dihentikan. Jika tidak, gunakan thread pekerja virtual.
- 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 <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
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
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika ditetapkan, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Hal ini dimaksudkan untuk menghemat kapasitas disk.
Tag:bazel_internal_configuration
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum percobaan error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--[no]incompatible_disable_native_repo_rules
: "false" -
Jika salah, aturan repo native dapat digunakan di WORKSPACE; jika tidak, aturan repo Starlark harus digunakan. Aturan repo native mencakup local_repository, new_local_repository, local_config_platform, android_sdk_repository, dan android_ndk_repository.
Tag:bazel_internal_configuration
- Default
--repository_cache=<a path>
: lihat deskripsi -
Menentukan lokasi cache 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
- Default
--[no]repository_disable_download
: "false" -
Jika ditetapkan, download menggunakan ctx.download{,_and_extract} tidak diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file yang dapat dieksekusi arbitrer 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 dengan masa berlaku yang terisi (0-100) yang di atas batasnya GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika disetel ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi yang berkaitan dengan output kueri dan semantik:
--aspect_deps=<off, conservative or precise>
default: "konservatif"-
Cara me-resolve dependensi aspek saat format output adalah salah satu dari {xml,proto,record}. 'nonaktif' berarti tidak ada dependensi aspek yang di-resolve, 'konservatif' (default) berarti semua dependensi aspek yang dideklarasikan ditambahkan terlepas dari apakah dependensi tersebut diberi class aturan dependensi langsung, 'akurat' berarti hanya aspek yang mungkin aktif yang ditambahkan dengan class aturan dependensi langsung. Perhatikan bahwa mode presisi memerlukan pemuatan paket lain untuk mengevaluasi satu target sehingga membuatnya lebih lambat daripada mode lainnya. Perhatikan juga bahwa mode presisi pun tidak sepenuhnya presisi: keputusan apakah akan menghitung aspek atau tidak diputuskan dalam fase analisis, yang tidak dijalankan selama 'kueri bazel'.
Tag:build_file_semantics
- Default
--[no]consistent_labels
: "false" -
Jika diaktifkan, setiap perintah kueri akan menampilkan label seolah-olah oleh fungsi Starlark <code>str</code> yang diterapkan ke instance <code>Label</code>. Hal ini berguna untuk alat yang perlu mencocokkan output dari berbagai perintah kueri dan/atau label yang dikeluarkan oleh aturan. Jika tidak diaktifkan, pemformat output bebas untuk menampilkan nama repositori yang jelas (relatif terhadap repositori utama) untuk membuat output lebih mudah dibaca.
Tag:terminal_output
- Default
--[no]experimental_explicit_aspects
: "false" -
aquery, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: no-op (aspek selalu diikuti).
Tag:terminal_output
- Default
--[no]graph:factored
: "true" -
Jika benar, grafik akan dimunculkan 'difaktorkan', yaitu node yang setara secara topologi akan digabungkan dan labelnya 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 terpotong; -1 berarti tidak ada pemotongan. Opsi ini hanya berlaku untuk --output=graph.
Tag:terminal_output
- Default
--[no]implicit_deps
: "true" -
Jika diaktifkan, dependensi implisit akan disertakan dalam grafik dependensi tempat kueri beroperasi. Dependensi implisit adalah dependensi yang tidak ditentukan secara eksplisit dalam file BUILD, tetapi ditambahkan oleh bazel. Untuk cquery, opsi ini mengontrol pemfilteran toolchain yang di-resolve.
Tag:build_file_semantics
- Default
--[no]include_aspects
: "true" -
aquery, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: no-op (aspek selalu diikuti).
Tag:terminal_output
- Default
--[no]incompatible_package_group_includes_double_slash
: "true" -
Jika diaktifkan, saat menampilkan atribut `packages` package_group, `//` di awal tidak akan dihilangkan.
Tag:terminal_output
,incompatible_change
- Default
--[no]infer_universe_scope
: "false" -
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 Anda hanya boleh menggunakan opsi ini 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` (yaitu bukan `cquery`).
Tag:loading_and_analysis
- Default
--[no]line_terminator_null
: "false" -
Apakah setiap format diakhiri dengan \0, bukan baris baru.
Tag:terminal_output
- Default
--[no]nodep_deps
: "true" -
Jika diaktifkan, dependensi dari atribut "nodep" akan disertakan dalam grafik dependensi tempat kueri beroperasi. 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
- Default
--output=<a string>
: "label" -
Format tempat hasil cquery akan dicetak. Nilai yang diizinkan untuk cquery adalah: label, label_kind, textproto, transitions, proto, streamed_proto, jsonproto. Jika memilih 'transitions', Anda juga harus menentukan opsi --transitions=(lite|full).
Tag:terminal_output
- Default
--[no]proto:default_values
: "true" -
Jika benar, atribut yang nilainya tidak ditentukan secara eksplisit dalam file BUILD akan disertakan; jika tidak, atribut akan dihilangkan. Opsi ini berlaku untuk --output=proto
Tag:terminal_output
- Default
--[no]proto:definition_stack
: "false" -
Isi kolom proto definition_stack, yang mencatat untuk setiap instance aturan, stack panggilan Starlark pada saat class aturan ditentukan.
Tag:terminal_output
- Default
--[no]proto:flatten_selects
: "true" -
Jika diaktifkan, atribut yang dapat dikonfigurasi yang dibuat oleh select() akan diratakan. Untuk jenis daftar, representasi yang diratakan adalah daftar yang berisi setiap nilai peta yang dipilih tepat sekali. Jenis skalar diratakan ke null.
Tag:build_file_semantics
- Default
--[no]proto:include_attribute_source_aspects
: "false" -
Isi kolom proto source_aspect_name dari setiap Atribut dengan aspek sumber asal atribut (string kosong jika tidak ada).
Tag:terminal_output
- Default
--[no]proto:include_configurations
: "true" -
jika diaktifkan, output proto akan menyertakan informasi tentang konfigurasi. Jika dinonaktifkan,format output proto cquery akan menyerupai format output kueri.
Tag:affects_outputs
- Default
--[no]proto:include_synthetic_attribute_hash
: "false" -
Apakah akan menghitung dan mengisi atribut $internal_attr_hash atau tidak.
Tag:terminal_output
- Default
--[no]proto:instantiation_stack
: "false" -
Isi stack panggilan pembuatan instance dari setiap aturan. Perhatikan bahwa hal ini memerlukan stack untuk ada
Tag:terminal_output
- Default
--[no]proto:locations
: "true" -
Apakah akan menampilkan informasi lokasi dalam output proto atau tidak.
Tag:terminal_output
- Default
--proto:output_rule_attrs=<comma-separated list of options>
: "semua" -
Daftar atribut yang dipisahkan koma untuk disertakan dalam output. Setelan defaultnya adalah semua atribut. Setel ke string kosong untuk tidak menghasilkan atribut apa pun. Opsi ini berlaku untuk --output=proto.
Tag:terminal_output
--[no]proto:rule_inputs_and_outputs
default: "true"-
Apakah akan mengisi kolom rule_input dan rule_output atau tidak.
Tag:terminal_output
- Default
--query_file=<a string>
: "" -
Jika ditetapkan, kueri akan membaca kueri dari file yang diberi nama di sini, bukan di command line. Menentukan file di sini serta kueri command line akan menyebabkan error.
Tag:changes_inputs
- Default
--[no]relative_locations
: "false" -
Jika 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 komputer. Anda dapat menetapkan opsi ini ke true untuk mendapatkan hasil yang konsisten di seluruh komputer.
Tag:terminal_output
- Default
--show_config_fragments=<off, direct or transitive>
: "nonaktif" -
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
- Default
--starlark:expr=<a string>
: "" -
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 ditentukan, opsi ini akan ditetapkan secara default ke 'str(target.label)'. Menentukan --starlark:expr dan --starlark:file merupakan error.
Tag:terminal_output
- Default
--starlark:file=<a string>
: "" -
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 error. Lihat bantuan untuk --output=starlark untuk mengetahui detail tambahan.
Tag:terminal_output
- Default
--[no]tool_deps
: "true" -
Kueri: Jika dinonaktifkan, dependensi pada 'konfigurasi exec' tidak akan disertakan dalam grafik dependensi tempat kueri beroperasi. Tepi dependensi 'konfigurasi exec', seperti yang berasal dari aturan 'proto_library' ke Compiler Protokol, biasanya mengarah ke alat yang dieksekusi selama build, bukan bagian dari program 'target' yang sama.
Cquery: Jika dinonaktifkan, akan memfilter semua target yang dikonfigurasi yang melintasi transisi eksekusi dari target tingkat teratas yang menemukan target yang dikonfigurasi ini. Artinya, jika target tingkat teratas berada dalam konfigurasi target, hanya target yang dikonfigurasi dan dalam konfigurasi target yang akan ditampilkan. Jika target tingkat teratas ada dalam konfigurasi exec, hanya target yang dikonfigurasi exec yang akan ditampilkan. Opsi ini TIDAK akan mengecualikan toolchain yang di-resolve.
Tag:build_file_semantics
- Default
--transitions=<full, lite or none>
: "none" -
Format tempat cquery akan mencetak informasi transisi.
Tag:affects_outputs
- Default
--universe_scope=<comma-separated list of options>
: "" -
Kumpulan pola target yang dipisahkan koma (aditif dan subtraktif). Kueri dapat dilakukan di alam semesta yang ditentukan oleh penutupan transitif target yang ditentukan. Opsi ini digunakan untuk perintah kueri dan kueri.
Untuk kueri, input ke opsi ini adalah target tempat semua jawaban dibuat, sehingga opsi ini dapat memengaruhi konfigurasi dan transisi. Jika opsi ini tidak ditentukan, target tingkat atas diasumsikan sebagai target yang diuraikan dari ekspresi kueri. Catatan: Untuk cquery, tidak menentukan opsi ini dapat menyebabkan build rusak jika target yang diuraikan dari ekspresi kueri tidak dapat dibuat dengan opsi tingkat atas.
Tag:loading_and_analysis
- Opsi yang terkait dengan output dan semantik 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 dideklarasikan dihapus di registry tempatnya berasal (jika tidak berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan kegagalan resolusi. Anda juga dapat menentukan versi yang ditarik yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Memeriksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan saat ketidakcocokan terdeteksi.
Tag:loading_and_analysis
- Default
--check_direct_dependencies=<off, warning or error>
: "peringatan" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di modul root adalah versi yang sama dengan yang Anda dapatkan di grafik dependensi yang di-resolve. Nilai yang valid adalah `nonaktif` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasinya ke kegagalan resolusi.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` di MODULE.bazel dari 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
- Default
--lockfile_mode=<off, update, refresh or error>
: "update" -
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan mengupdatenya jika ada perubahan, `refresh` untuk memuat ulang informasi yang dapat diubah (versi yang ditarik dan modul yang sebelumnya tidak ada) dari registry jarak jauh dari waktu ke waktu, `error` untuk menggunakan file kunci, tetapi menampilkan error jika tidak terbaru, atau `off` untuk tidak membaca dari atau menulis ke file kunci.
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 <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
--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 baru akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
- Default
--vendor_dir=<a path>
: lihat deskripsi -
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat mem-build. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
default: "1detik:2,20detik:3,1menit:5"-
Batas yang, jika tercapai, menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlahnya adalah bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang dengan masa berlaku (heap gen lama) tetap terisi setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan yang 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC minor terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas tersebut tercapai, status Skyframe tidak akan lagi diturunkan 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 penggunaan persentase heap yang dipertahankan setidaknya pada batas ini, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan. Dengan menyesuaikan hal ini, Anda dapat mengurangi dampak waktu berjalan dari thrashing GC, jika thrashing GC (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada merekonstruksi status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
- Default
--experimental_command_profile=<cpu, wall, alloc or lock>
: lihat deskripsi - Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alloc, atau lock) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama sesuai jenis peristiwa di direktori dasar output. Sintaksis dan semantik tanda ini mungkin berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; gunakan dengan risiko Anda sendiri.
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemoni dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemoni.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
- Default
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Jika tidak kosong, baca file yang di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan penyimpanan dalam cache jarak jauh:
- Default
--experimental_downloader_config=<a string>
: lihat deskripsi - Menentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali dengan perintah (`allow`, `block`, atau `rewrite`), diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk dicocokkan, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik yang dimulai dari `$1`. Anda dapat memberikan beberapa perintah `rewrite` untuk URL yang sama, dan dalam hal ini beberapa URL akan ditampilkan.
- Default
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Mode thread yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dihentikan. Jika tidak, gunakan thread pekerja virtual.
- Opsi lainnya, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
- Opsi yang mengontrol eksekusi build:
- Default
--[no]experimental_inprocess_symlink_creation
: "false" -
Apakah akan membuat panggilan sistem file langsung untuk membuat hierarki symlink
Tag:loading_and_analysis
,execution
,experimental
- Default
--[no]experimental_persistent_aar_extractor
: "false" -
Aktifkan ekstraktor aar persisten menggunakan worker.
Tag:execution
- Default
--[no]experimental_remotable_source_manifests
: "false" -
Apakah akan membuat tindakan manifes sumber dapat diakses dari jarak jauh
Tag:loading_and_analysis
,execution
,experimental
- Default
--[no]experimental_split_coverage_postprocessing
: "false" -
Jika true (benar), Bazel akan menjalankan cakupan pascapemrosesan untuk pengujian pada spawn baru.
Tag:execution
- Default
--[no]experimental_strict_fileset_output
: "false" -
Jika opsi ini diaktifkan, set file akan memperlakukan semua artefak output sebagai file reguler. Perintah ini tidak akan menjelajahi direktori atau sensitif terhadap symlink.
Tag:execution
- Default
--[no]incompatible_disallow_unsound_directory_outputs
: "true" -
Jika ditetapkan, tindakan untuk mewujudkan file output sebagai direktori akan mengalami error. Tidak memengaruhi direktori sumber. Lihat https://github.com/bazelbuild/bazel/issues/18646.
Tag:bazel_internal_configuration
,incompatible_change
- Default
--[no]incompatible_modify_execution_info_additive
: "false" -
Jika diaktifkan, meneruskan beberapa tanda --modify_execution_info bersifat tambahan. Jika dinonaktifkan, hanya tanda terakhir yang akan dipertimbangkan.
Tag:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
beberapa penggunaan diakumulasikan-
Menambahkan atau menghapus tombol 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 ekspresi reguler yang dapat diterapkan ke mnemoni yang sama.
Sintaksis: "regex=[+-]key,regex=[+-]key,...".
Contoh:
'.*=+x,.*=-y,.*=+z' menambahkan 'x' dan 'z' ke, dan menghapus 'y' dari, info eksekusi untuk semua tindakan.
'Genrule=+requires-x' menambahkan 'requires-x' ke info eksekusi untuk semua tindakan Genrule.
'(?!Genrule).*=-requires-x' menghapus 'requires-x' dari info eksekusi untuk semua tindakan non-Genrule.
Tag:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Mengaktifkan tindakan dex dan desugar Android persisten menggunakan pekerja.
Diperluas menjadi:
--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.
Diperluas menjadi:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
Tag:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Mengaktifkan tindakan dex dan desugar Android multipleks 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
-
Mengaktifkan pemroses resource Android multipleks persisten menggunakan pekerja.
Diperluas menjadi:
--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
Tag:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Mengaktifkan alat Android persisten dan multipleks (dexing, desugaring, pemrosesan resource).
Diperluas menjadi:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Tag:host_machine_resource_optimizations
,execution
- Default
--[no]use_target_platform_for_tests
: "false" -
Jika benar, Bazel akan menggunakan platform target untuk menjalankan pengujian, bukan grup eksekusi pengujian.
Tag:execution
- Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
- Default
--android_compiler=<a string>
: 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
- Default
--android_grte_top=<a label>
: lihat deskripsi -
Target Android grte_top.
Tag:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Default
--android_manifest_merger=<legacy, android or force_android>
: "android" -
Memilih penggabungan manifes yang akan digunakan untuk aturan android_binary. Flag untuk membantu transisi ke penggabungan manifes Android dari penggabungan lama.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--android_platforms=<a build target label>
: "" -
Menetapkan platform yang digunakan target android_binary. Jika beberapa platform ditentukan, biner adalah APK tebal, 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 Android SDK/platform 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
- Default
--cc_output_directory_tag=<a string>
: "" -
Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.
Tag:affects_outputs
- Default
--compiler=<a string>
: 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 ini harus berupa grup file yang berisi satu file, yaitu biner. Nilai defaultnya 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 ini 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. Nilai defaultnya adalah '//tools/test:coverage_support'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
default: "@bazel_tools//tools/cpp:toolchain"-
Label paket crosstool yang akan digunakan untuk mengompilasi kode C++.
Tag:loading_and_analysis
,changes_inputs
,affects_outputs
- Default
--custom_malloc=<a build target label>
: lihat deskripsi -
Menentukan implementasi malloc kustom. Setelan ini menggantikan atribut malloc 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 secara opsional 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 dilakukan seolah-olah telah mendeklarasikan nilai batasan sebagai batasan eksekusi. Contoh: //demo,-test=@platforms//cpus:x86_64 akan menambahkan 'x86_64' ke target apa pun di //demo kecuali target yang namanya berisi 'test'.
Tag:loading_and_analysis
- Default
--[no]experimental_include_xcode_execution_requirements
: "false" -
Jika ditetapkan, tambahkan persyaratan eksekusi "requires-xcode:{version}" ke setiap tindakan Xcode. Jika versi xcode memiliki label dengan tanda hubung, tambahkan juga persyaratan eksekusi "requires-xcode-label:{version_label}".
Tag:loses_incremental_state
,loading_and_analysis
,execution
- Default
--[no]experimental_prefer_mutual_xcode
: "true" -
Jika benar, gunakan Xcode terbaru yang tersedia secara lokal dan jarak jauh. Jika salah, atau jika tidak ada versi yang tersedia secara bersama, gunakan versi Xcode lokal yang dipilih melalui xcode-select.
Tag:loses_incremental_state
- Default
--extra_execution_platforms=<comma-separated list of options>
: "" -
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 dinyatakan dalam file WORKSPACE oleh register_execution_platforms(). Opsi ini hanya dapat ditetapkan sekali; instance berikutnya akan menggantikan 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
- Default
--grte_top=<a label>
: lihat deskripsi -
Label ke library libc yang di-check in. Nilai default dipilih oleh toolchain crosstool, dan Anda hampir tidak pernah perlu menggantinya.
Tag:action_command_lines
,affects_outputs
- Default
--host_compiler=<a string>
: lihat deskripsi -
Compiler C++ yang akan digunakan untuk kompilasi host. Nilai ini akan diabaikan jika --host_crosstool_top tidak ditetapkan.
Tag:loading_and_analysis
,execution
- Default
--host_crosstool_top=<a build target label>
: lihat deskripsi -
Secara default, opsi --crosstool_top dan --compiler juga digunakan untuk konfigurasi exec. Jika flag ini disediakan, Bazel akan menggunakan libc dan compiler default untuk crosstool_top yang diberikan.
Tag:loading_and_analysis
,changes_inputs
,affects_outputs
- Default
--host_grte_top=<a label>
: lihat deskripsi -
Jika ditentukan, setelan ini akan menggantikan direktori tingkat atas libc (--grte_top) untuk konfigurasi exec.
Tag:action_command_lines
,affects_outputs
--host_platform=<a build target label>
default: "@bazel_tools//tools:host_platform"-
Label aturan platform yang menjelaskan sistem host.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
- Default
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "true" -
Jika 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
- Default
--[no]incompatible_enable_android_toolchain_resolution
: "true" -
Gunakan resolusi toolchain untuk memilih Android SDK untuk aturan Android (Starlark dan native)
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_enable_apple_toolchain_resolution
: "false" -
Gunakan resolusi toolchain untuk memilih Apple SDK untuk aturan apple (Starlark dan native)
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_make_thinlto_command_lines_standalone
: "true" -
Jika benar, Bazel tidak akan menggunakan kembali command line tindakan link C++ untuk command line pengindeksan lto (lihat https://github.com/bazelbuild/bazel/issues/6791 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
default: "true"-
Jika benar, Bazel tidak akan menautkan dependensi library sebagai 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"-
Jika benar, Bazel akan mewajibkan parameter 'ctx' ke cc_common.configure_features (lihat https://github.com/bazelbuild/bazel/issues/7793 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,incompatible_change
-
Menggunakan objek bersama antarmuka jika didukung oleh toolchain. Semua toolchain ELF saat ini mendukung setelan ini.
Tag:loading_and_analysis
,affects_outputs
,affects_outputs
- Default
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Menentukan versi iOS SDK yang akan digunakan untuk mem-build aplikasi iOS. Jika tidak ditentukan, akan menggunakan versi iOS SDK default dari 'xcode_version'.
Tag:loses_incremental_state
- Default
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Menentukan versi SDK macOS yang akan digunakan untuk mem-build aplikasi macOS. Jika tidak ditentukan, gunakan versi SDK macOS default dari 'xcode_version'.
Tag:loses_incremental_state
- Default
--minimum_os_version=<a string>
: lihat deskripsi -
Versi OS minimum yang ditargetkan kompilasi Anda.
Tag:loading_and_analysis
,affects_outputs
- Default
--platform_mappings=<a relative path>
: "" - Lokasi file pemetaan yang menjelaskan platform mana yang akan digunakan jika tidak ada yang ditetapkan atau flag mana yang akan ditetapkan jika platform sudah ada. Harus relatif terhadap root ruang kerja utama. Default-nya adalah 'platform_mappings' (file langsung di bawah root ruang kerja).
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
- Default
--platforms=<a build target label>
: "" -
Label aturan platform yang menjelaskan platform target untuk perintah saat ini.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
- Default
--python2_path=<a string>
: lihat deskripsi -
Tidak digunakan lagi, tidak ada operasi. Dinonaktifkan oleh `--incompatible_use_python_toolchains`.
Tag:no_op
,deprecated
- Default
--python3_path=<a string>
: lihat deskripsi -
Tidak digunakan lagi, tidak ada operasi. Dinonaktifkan oleh `--incompatible_use_python_toolchains`.
Tag:no_op
,deprecated
- Default
--python_path=<a string>
: lihat deskripsi -
Jalur absolut penafsir Python yang dipanggil untuk menjalankan target Python pada platform target. Tidak digunakan lagi; dinonaktifkan oleh --incompatible_use_python_toolchains.
Tag:loading_and_analysis
,affects_outputs
- Default
--python_top=<a build target label>
: 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
- Default
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Menentukan versi tvOS SDK yang akan digunakan untuk mem-build aplikasi tvOS. Jika tidak ditentukan, gunakan versi tvOS SDK default dari 'xcode_version'.
Tag:loses_incremental_state
- Default
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Menentukan versi watchOS SDK yang akan digunakan untuk mem-build aplikasi watchOS. Jika tidak ditentukan, gunakan versi watchOS SDK default dari 'xcode_version'.
Tag:loses_incremental_state
- Default
--xcode_version=<a string>
: lihat deskripsi -
Jika ditentukan, akan menggunakan Xcode versi tertentu untuk tindakan build yang relevan. Jika tidak ditentukan, akan menggunakan versi default Xcode dari eksekutor.
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 dalam konfigurasi build.
Tag:loses_incremental_state
,loading_and_analysis
- Opsi yang mengontrol output perintah:
- Default
--[no]apple_generate_dsym
: "false" -
Apakah akan membuat file simbol debug (.dSYM).
Tag:affects_outputs
,action_command_lines
- Default
--[no]build_runfile_links
: "true" -
Jika benar, build hutan symlink runfile untuk semua target. Jika salah (false), tulis hanya jika diperlukan oleh tindakan lokal, pengujian, atau perintah run.
Tag:affects_outputs
- Default
--[no]build_runfile_manifests
: "true" -
Jika true, tulis manifes runfile untuk semua target. Jika salah (false), hapus. Pengujian lokal akan gagal dijalankan jika bernilai salah.
Tag:affects_outputs
- Default
--[no]build_test_dwp
: "false" -
Jika diaktifkan, saat membuat 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 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
- Default
--[no]experimental_proto_descriptor_sets_include_source_info
: "false" -
Menjalankan tindakan tambahan untuk versi Java API alternatif di proto_library.
Tag:affects_outputs
,loading_and_analysis
,experimental
- Default
--[no]experimental_proto_extra_actions
: "false" -
Menjalankan tindakan tambahan untuk versi Java API alternatif di proto_library.
Tag:affects_outputs
,loading_and_analysis
,experimental
- Default
--[no]experimental_save_feature_state
: "false" -
Menyimpan status fitur yang diaktifkan dan diminta sebagai output kompilasi.
Tag:affects_outputs
,experimental
- Default
--fission=<a set of compilation modes>
: "no" -
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 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_avoid).
Tag:affects_outputs
,incompatible_change
- Default
--[no]legacy_external_runfiles
: "true" -
Jika benar, build hutan symlink runfile untuk repositori eksternal di .runfiles/wsname/external/repo (selain .runfiles/repo).
Tag:affects_outputs
- Default
--[no]objc_generate_linkmap
: "false" -
Menentukan apakah akan membuat file linkmap.
Tag:affects_outputs
- Default
--[no]save_temps
: "false" -
Jika ditetapkan, output sementara dari gcc akan disimpan. Ini termasuk 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, yang 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 ditentukan berdasarkan nama, dalam hal ini nilai akan diambil dari lingkungan pemanggilan, atau dengan pasangan name=value yang menetapkan nilai secara independen dari lingkungan pemanggilan. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru akan digunakan, sedangkan opsi untuk variabel yang berbeda akan diakumulasikan.
Tag:action_command_lines
- Default
--android_cpu=<a string>
: "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. Flag ini tidak melakukan operasi apa pun.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]android_databinding_use_v3_4_args
: "true" -
Gunakan android databinding v2 dengan argumen 3.4.0. Flag ini tidak melakukan operasi apa pun.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--android_dynamic_mode=<off, default or fully>
: "nonaktif" -
Menentukan apakah dependensi C++ dari aturan Android akan ditautkan secara dinamis saat cc_binary tidak membuat library bersama secara eksplisit. 'default' berarti bazel akan memilih apakah akan menautkan secara dinamis. 'sepenuhnya' berarti semua library akan ditautkan secara dinamis. 'nonaktif' berarti semua library akan ditautkan dalam mode statis.
Tag:affects_outputs
,loading_and_analysis
- Default
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "alfabet" -
Menetapkan urutan manifes yang diteruskan ke penggabungan manifes untuk biner Android. ALPHABETICAL berarti manifes diurutkan berdasarkan jalur relatif terhadap execroot. ALPHABETICAL_BY_CONFIGURATION berarti manifes diurutkan berdasarkan jalur yang relatif terhadap direktori konfigurasi dalam direktori output. DEPENDENCY berarti manifes diurutkan dengan manifes setiap library yang muncul sebelum manifes dependensinya.
Tag:action_command_lines
,execution
- Default
--[no]android_resource_shrinking
: "false" -
Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]build_python_zip
: "otomatis" -
Buat zip yang dapat dieksekusi python; di Windows, nonaktifkan di platform lain
Tag:affects_outputs
--catalyst_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang digunakan untuk membangun biner Apple Catalyst.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--[no]collect_code_coverage
: "false" -
Jika ditentukan, Bazel akan melengkapi kode (menggunakan instrumentasi offline jika memungkinkan) dan akan mengumpulkan informasi cakupan selama pengujian. Hanya target yang cocok dengan --instrumentation_filter yang akan terpengaruh. Biasanya, opsi ini tidak boleh ditentukan secara langsung - perintah 'bazel coverage' harus digunakan.
Tag:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] default: "fastbuild"-
Menentukan mode tempat biner akan dibuat. 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 yang akan diteruskan ke gcc.
Tag:action_command_lines
,affects_outputs
- Default
--cpu=<a string>
: "" -
CPU target.
Tag:changes_inputs
,affects_outputs
- Default
--cs_fdo_absolute_path=<a string>
: lihat deskripsi -
Gunakan informasi profil CSFDO untuk mengoptimalkan kompilasi. Tentukan nama jalur absolut dari file ZIP yang berisi file profil, file profil LLVM mentah atau yang diindeks.
Tag:affects_outputs
- Default
--cs_fdo_instrument=<a string>
: lihat deskripsi -
Buat biner dengan instrumentasi FDO yang sensitif terhadap konteks. Dengan compiler Clang/LLVM, compiler ini juga menerima nama direktori tempat file profil mentah akan di-dump saat runtime.
Tag:affects_outputs
- Default
--cs_fdo_profile=<a build target label>
: 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.
Tag:changes_inputs
,affects_outputs
- Default
--dynamic_mode=<off, default or fully>
: "default" -
Menentukan apakah biner C++ akan ditautkan secara dinamis. 'default' berarti Bazel akan memilih apakah akan menautkan secara dinamis. 'full' berarti semua library akan ditautkan secara dinamis. 'off' berarti semua library akan ditautkan dalam sebagian besar mode statis.
Tag:loading_and_analysis
,affects_outputs
- Default
--[no]enable_fdo_profile_absolute_path
: "true" -
Jika ditetapkan, penggunaan fdo_absolute_profile_path akan menimbulkan error.
Tag:affects_outputs
- Default
--[no]enable_runfiles
: "auto" -
Mengaktifkan hierarki symlink runfile; Secara default, dinonaktifkan di Windows, diaktifkan di platform lain.
Tag:affects_outputs
--experimental_action_listener=<a build target label>
beberapa penggunaan diakumulasikan-
Tidak digunakan lagi dan digantikan dengan aspek. Gunakan action_listener untuk melampirkan extra_action ke tindakan build yang ada.
Tag:execution
,experimental
- Default
--[no]experimental_android_compress_java_resources
: "false" -
Mengompresi resource Java dalam APK
Tag:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_android_databinding_v2
default: "true"-
Menggunakan Android databinding v2. Flag ini tidak melakukan operasi apa pun.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]experimental_android_resource_shrinking
: "false" -
Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_android_rewrite_dexes_with_rex
: "false" -
menggunakan alat rex untuk menulis ulang file dex
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]experimental_collect_code_coverage_for_generated_files
: "false" -
Jika ditentukan, Bazel juga akan membuat informasi cakupan untuk file yang dihasilkan.
Tag:affects_outputs
- Default
--experimental_objc_fastbuild_options=<comma-separated list of options>
: "-O0,-DDEBUG=1" -
Menggunakan string ini sebagai opsi compiler fastbuild objc.
Tag:action_command_lines
- Default
--[no]experimental_omitfp
: "false" -
Jika true, gunakan libunwind untuk pelepasan stack, dan kompilasi dengan -fomit-frame-pointer dan -fasinkron-unwind-table.
Tag:action_command_lines
,affects_outputs
,experimental
- Default
--experimental_output_paths=<off, content or strip>
: "nonaktif" -
Model mana yang akan digunakan untuk tempat aturan hierarki output menulis outputnya, terutama untuk build multi-platform / multi-konfigurasi. Fitur ini sangat eksperimental. Lihat https://github.com/bazelbuild/bazel/issues/6526 untuk mengetahui detailnya. Tindakan Starlark dapat memilih untuk menggunakan pemetaan jalur dengan menambahkan kunci 'supports-path-mapping' ke kamus '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 mengacu ke platform dan nilai adalah nama pendek yang ingin digunakan di jalur output. Hanya digunakan jika --experimental_platform_in_output_dir benar. Memiliki prioritas penamaan tertinggi.
Tag:affects_outputs
,experimental
- Default
--[no]experimental_platform_in_output_dir
: "false" -
Jika benar, nama singkat untuk platform target akan digunakan dalam nama direktori output, bukan CPU. Skema yang tepat bersifat eksperimental dan dapat berubah: Pertama, dalam kasus yang jarang terjadi, opsi --platforms tidak memiliki tepat satu nilai, hash opsi platform akan digunakan. Selanjutnya, jika nama pendek untuk platform saat ini didaftarkan oleh -- experiments_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. Terakhir, hash opsi platform digunakan sebagai upaya terakhir.
Tag:affects_outputs
,experimental
- Default
--[no]experimental_use_llvm_covmap
: "false" -
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
- Default
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
: "true" -
Hanya gunakan tanda ini sebagai bagian dari strategi pengujian atau migrasi yang disarankan. Perhatikan bahwa heuristik memiliki kekurangan yang diketahui dan sebaiknya bermigrasi untuk mengandalkan --experimental_override_name_platform_in_output_dir saja.
Tag:affects_outputs
,experimental
- Default
--fat_apk_cpu=<comma-separated set of options>
: "armeabi-v7a" -
Menyetel opsi ini akan mengaktifkan APK gemuk, yang berisi biner native untuk semua arsitektur target yang ditentukan, misalnya, --fat_apk_cpu=x86,armeabi-v7a. Jika tanda ini ditentukan, --android_cpu diabaikan untuk dependensi aturan android_binary.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--[no]fat_apk_hwasan
: "false" -
Apakah akan membuat pemisahan HWASAN.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--fdo_instrument=<a string>
: lihat deskripsi -
Buat biner dengan instrumentasi FDO. Dengan compiler Clang/LLVM, compiler ini juga menerima nama direktori tempat file profil mentah akan di-dump saat runtime.
Tag:affects_outputs
- Default
--fdo_optimize=<a string>
: lihat deskripsi -
Menggunakan 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. Flag ini juga menerima file yang ditentukan sebagai label (misalnya, `//foo/bar:file.afdo` - Anda mungkin perlu menambahkan perintah `exports_files` ke paket yang sesuai) dan label yang mengarah ke target `fdo_profile`. Flag ini akan diganti oleh aturan `fdo_profile`.
Tag:affects_outputs
- Default
--fdo_prefetch_hints=<a build target label>
: lihat deskripsi -
Gunakan petunjuk pengambilan data cache.
Tag:affects_outputs
- Default
--fdo_profile=<a build target label>
: 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 di-build dalam konfigurasi target. Menentukan -<feature> akan menonaktifkan fitur tersebut. Fitur negatif selalu menggantikan fitur positif. Lihat juga --host_features
Tag:changes_inputs
,affects_outputs
- Default
--[no]force_pic
: "false" -
Jika diaktifkan, semua kompilasi C++ akan menghasilkan kode yang tidak bergantung pada posisi ("-fPIC"), link lebih memilih library bawaan PIC daripada library non-PIC, dan link akan menghasilkan file yang dapat dieksekusi yang tidak bergantung pada 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 ditentukan berdasarkan nama, dalam hal ini nilai akan diambil dari lingkungan pemanggilan, atau dengan pasangan name=value yang menetapkan nilai secara independen dari lingkungan pemanggilan. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru akan digunakan, sedangkan opsi untuk variabel yang berbeda akan diakumulasikan.
Tag:action_command_lines
- Default
--host_compilation_mode=<fastbuild, dbg or opt>
: "opt" -
Menentukan mode tempat alat yang digunakan selama proses build akan dibangun. 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 untuk diteruskan ke compiler C untuk alat yang dibangun dalam konfigurasi exec.
Tag:action_command_lines
,affects_outputs
- Default
--host_cpu=<a string>
: "" -
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 di-build 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 tersebut. Fitur negatif selalu menggantikan fitur positif.
Tag:changes_inputs
,affects_outputs
- Default
--host_force_python=<PY2 or PY3>
: 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 exec.
Tag:action_command_lines
,affects_outputs
- Default
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi macOS minimum yang kompatibel untuk target host. Jika tidak ditentukan, gunakan 'macos_sdk_version'.
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. Sintaksis: regex_filter@option_1,option_2,...,option_n. Dengan regex_filter adalah daftar pola ekspresi reguler yang disertakan dan dikecualikan (Lihat juga --instrumentation_filter). option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus diapit dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ pertama yang 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
--host_swiftcopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke swiftc untuk alat eksekusi.
Tag:action_command_lines
,affects_outputs
- Default
--[no]incompatible_auto_exec_groups
: "false" -
Jika diaktifkan, grup exec akan otomatis dibuat untuk setiap toolchain yang digunakan oleh aturan. Agar aturan ini berjalan, aturan ini harus menentukan parameter `toolchain` pada tindakannya. Untuk informasi selengkapnya, lihat https://github.com/bazelbuild/bazel/issues/17134.
Tag:affects_outputs
,incompatible_change
- Default
--[no]incompatible_merge_genfiles_directory
: "true" -
Jika true, direktori genfiles akan digabungkan ke dalam direktori bin.
Tag:affects_outputs
,incompatible_change
- Default
--[no]incompatible_use_host_features
: "true" -
Jika benar, gunakan --features hanya untuk konfigurasi target dan --host_features untuk konfigurasi exec.
Tag:changes_inputs
,affects_outputs
,incompatible_change
- Default
--[no]instrument_test_targets
: "false" -
Jika cakupan diaktifkan, tentukan apakah akan mempertimbangkan penggunaan 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 diinstrumentasi. Aturan yang diawali dengan '-' akan dikecualikan. Perhatikan bahwa hanya aturan non-pengujian yang diinstrumentasikan kecuali --instrument_test_targets diaktifkan.
Tag:affects_outputs
- Default
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi iOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'ios_sdk_version'.
Tag:loses_incremental_state
--ios_multi_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk membuat aplikasi ios_application. 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). Jika 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 penautan.
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 (di bagian --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 digunakan untuk membangun biner Apple macOS.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi macOS minimum yang kompatibel untuk target. Jika tidak ditentukan, gunakan 'macos_sdk_version'.
Tag:loses_incremental_state
- Default
--memprof_profile=<a build target label>
: lihat deskripsi -
Gunakan profil memprof.
Tag:affects_outputs
- Default
--[no]objc_debug_with_GLIBCXX
: "false" -
Jika kebijakan ini disetel, dan mode kompilasi disetel ke 'dbg', tentukan GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC, dan GLIBCPP_CONCEPT_CHECKS.
Tag:action_command_lines
- Default
--[no]objc_enable_binary_stripping
: "false" -
Apakah akan melakukan penghapusan simbol dan kode mati pada biner tertaut. Penghapusan biner akan dilakukan jika flag 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. Sintaksis: regex_filter@option_1,option_2,...,option_n. Di mana regex_filter adalah singkatan dari daftar menyertakan dan mengecualikan pola ekspresi reguler (Lihat juga --instrumentation_filter). option_1 ke options_n singkatan dari opsi baris perintah arbitrer. Jika opsi berisi koma, opsi tersebut harus diberi tanda kutip dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ pertama yang 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 (di bagian --features=thin_lto) saat mengompilasi objek backend tertentu. Opsi ini dapat diteruskan beberapa kali. Sintaksis: regex_filter@option_1,option_2,...,option_n. Dengan regex_filter adalah daftar pola ekspresi reguler yang disertakan dan dikecualikan. option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus diapit dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ pertama yang 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
- Default
--platform_suffix=<a string>
: lihat deskripsi -
Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.
Tag:loses_incremental_state
,affects_outputs
,loading_and_analysis
- Default
--propeller_optimize=<a build target label>
: lihat deskripsi -
Gunakan informasi profil Propeller untuk mengoptimalkan target build.Profil propeller harus terdiri dari minimal salah 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, di a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Perintah exports_files mungkin harus ditambahkan ke paket yang sesuai agar file ini terlihat oleh Bazel. Opsi ini harus digunakan sebagai: --propeller_optimize=//a/b:propeller_profile
Tag:action_command_lines
,affects_outputs
- Default
--propeller_optimize_absolute_cc_profile=<a string>
: lihat deskripsi -
Nama jalur absolut file cc_profile untuk build Propeller Optimized.
Tag:affects_outputs
- Default
--propeller_optimize_absolute_ld_profile=<a string>
: lihat deskripsi -
Nama jalur absolut file ld_profile untuk build Propeller Optimized.
Tag:affects_outputs
- Default
--run_under=<a prefix in front of command>
: 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', maka command line akhirnya adalah 'foo -bar test_binary -baz'.Ini juga dapat berupa label ke 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 yang identik akan dibagikan di antara target yang berbeda
Tag:loading_and_analysis
,affects_outputs
- Default
--[no]stamp
: "false" -
Menandai biner dengan tanggal, nama pengguna, nama host, informasi ruang kerja, dll.
Tag:affects_outputs
--strip=<always, sometimes or never>
default: "kadang-kadang"-
Menentukan apakah akan menghapus biner dan library bersama (menggunakan "-Wl,--strip-debug"). Nilai default 'sometimes' 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
--swiftcopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke kompilasi Swift.
Tag:action_command_lines
--tvos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk mem-build biner Apple tvOS.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi tvOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'tvos_sdk_version'.
Tag:loses_incremental_state
--visionos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang digunakan untuk membangun 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 untuk mem-build biner Apple watchOS.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi watchOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'watchos_sdk_version'.
Tag:loses_incremental_state
- Default
--xbinary_fdo=<a build target label>
: lihat deskripsi -
Gunakan informasi profil XbinaryFDO untuk mengoptimalkan kompilasi. Tentukan nama profil lintas biner default. Jika opsi 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 menerapkan input build yang valid (definisi aturan, kombinasi flag, dll.):
- Default
--auto_cpu_environment_group=<a build target label>
: "" -
Deklarasikan environment_group yang akan digunakan untuk memetakan nilai cpu ke nilai target_environment secara otomatis.
Tag:changes_inputs
,loading_and_analysis
,experimental
- Default
--[no]check_licenses
: "false" -
Pastikan batasan pemberian lisensi yang diberlakukan oleh paket dependen tidak bertentangan dengan mode distribusi target yang sedang dibuat. Secara default, lisensi tidak dicentang.
Tag:build_file_semantics
- Default
--[no]check_visibility
: "true" -
Jika dinonaktifkan, error visibilitas dalam dependensi target akan diturunkan menjadi peringatan.
Tag:build_file_semantics
- Default
--[no]desugar_for_android
: "true" -
Apakah akan mendesugar bytecode Java 8 sebelum melakukan dexing.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--[no]desugar_java8_libs
: "false" -
Apakah akan menyertakan library Java 8 yang didukung dalam aplikasi untuk perangkat lama.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]enforce_constraints
: "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
- Default
--[no]experimental_check_desugar_deps
: "true" -
Apakah akan memeriksa kembali desugaring yang benar di tingkat biner Android.
Tag:eagerness_to_exit
,loading_and_analysis
,experimental
- Default
--experimental_import_deps_checking=<off, warning or error>
: "NONAKTIF" -
Jika diaktifkan, periksa apakah dependensi aar_import sudah selesai. Penerapan ini dapat merusak build, atau hanya mengakibatkan peringatan.
Tag:loading_and_analysis
- Default
--experimental_one_version_enforcement=<off, warning or error>
: "NONAKTIF" -
Jika diaktifkan, aturan java_binary tidak boleh berisi lebih dari satu versi file class yang sama di classpath. Penerapan ini dapat merusak build, atau hanya dapat menghasilkan peringatan.
Tag:loading_and_analysis
- Default
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "default" -
Jika benar, akan periksa apakah target Java secara eksplisit mendeklarasikan semua target yang digunakan langsung sebagai dependensi.
Tag:build_file_semantics
,eagerness_to_exit
- Default
--[no]incompatible_check_testonly_for_output_files
: "false" -
Jika diaktifkan, periksa hanya pengujian untuk target prasyarat yang merupakan file output dengan mencari pengujian aturan pembuatan saja. Ini cocok dengan pemeriksaan visibilitas.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_check_visibility_for_toolchains
: "false" -
Jika diaktifkan, pemeriksaan visibilitas juga berlaku untuk implementasi toolchain.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_disable_native_android_rules
: "false" -
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
- Default
--[no]incompatible_disable_native_apple_binary_rule
: "false" -
Tidak ada operasi. Dipertahankan di sini untuk kompatibilitas mundur.
Tag:eagerness_to_exit
,incompatible_change
- Default
--[no]incompatible_python_disable_py2
: "true" -
Jika benar, menggunakan setelan Python 2 akan menyebabkan error. Ini mencakup python_version=PY2, srcs_version=PY2, dan srcs_version=PY2ONLY. Lihat https://github.com/bazelbuild/bazel/issues/15684 untuk mengetahui informasi selengkapnya.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_validate_top_level_header_inclusions
: "true" -
Jika benar, Bazel juga akan memvalidasi penyertaan header direktori tingkat teratas (lihat https://github.com/bazelbuild/bazel/issues/10047 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]one_version_enforcement_on_java_tests
: "true" -
Jika diaktifkan, dan dengan experiments_one_version_enforcement yang ditetapkan ke nilai non-NONE, terapkan satu versi di target java_test. Tanda ini dapat dinonaktifkan untuk meningkatkan performa pengujian tambahan dengan mengorbankan potensi pelanggaran satu versi.
Tag:loading_and_analysis
- Default
--python_native_rules_allowlist=<a build target label>
: lihat deskripsi -
Daftar yang diizinkan (target paket_grup) untuk digunakan saat menerapkan --incompatible_python_disallow_native_rules.
Tag:loading_and_analysis
- Default
--[no]strict_filesets
: "false" -
Jika opsi ini diaktifkan, set file yang melintasi batas paket akan dilaporkan sebagai error.
Tag:build_file_semantics
,eagerness_to_exit
- Default
--strict_proto_deps=<off, warn, error, strict or default>
: "error" -
Kecuali jika 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>
: "nonaktif" -
Kecuali jika NONAKTIF, memeriksa apakah target proto_library secara eksplisit mendeklarasikan semua target yang digunakan di 'import public' sebagai diekspor.
Tag:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Default
--[no]strict_system_includes
: "false" -
Jika 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 ditetapkan, semua target tingkat atas 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 digunakan untuk menandatangani APK
Tag:action_command_lines
,affects_outputs
,loading_and_analysis
- Default
--[no]device_debug_entitlements
: "true" -
Jika ditetapkan, dan mode kompilasi bukan 'opt', aplikasi objc akan menyertakan hak debug saat menandatangani.
Tag:changes_inputs
- Default
--ios_signing_cert_name=<a string>
: lihat deskripsi -
Nama sertifikat yang akan digunakan untuk penandatanganan iOS. Jika tidak ditetapkan, akan kembali ke profil penyediaan. Mungkin merupakan preferensi identitas keychain sertifikat atau (substring) nama umum sertifikat, sesuai dengan halaman man codesign (IDENTITAS PENANDATANGANAN).
Tag:action_command_lines
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
- Default
--[no]incompatible_disallow_legacy_py_provider
: "true" -
Tidak ada operasi, akan segera dihapus.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_disallow_sdk_frameworks_attributes
: "false" -
Jika benar, jangan izinkan atribut sdk_frameworks dan weak_sdk_frameworks di objc_library dan objc_import.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_objc_alwayslink_by_default
: "false" -
Jika benar, buat nilai default menjadi benar untuk atribut alwayslink di objc_library dan objc_import.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_python_disallow_native_rules
: "false" -
Jika benar (true), error akan terjadi saat menggunakan aturan py_* bawaan; sebagai gantinya, aturan rule_python harus digunakan. Lihat https://github.com/bazelbuild/bazel/issues/17773 untuk mengetahui informasi selengkapnya dan petunjuk migrasi.
Tag:loading_and_analysis
,incompatible_change
- Opsi yang mengatur perilaku lingkungan pengujian atau runner pengujian:
- Default
--[no]allow_analysis_failures
: "false" -
Jika benar, kegagalan analisis target aturan akan menyebabkan penyebaran instance AnalysisFailureInfo yang berisi deskripsi error, bukan menyebabkan 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
- Default
--[no]break_build_on_parallel_dex2oat_failure
: "false" -
Jika benar, kegagalan tindakan dex2oat akan menyebabkan build rusak, bukan menjalankan 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- Ganti jumlah resource default untuk pengujian. Format yang diharapkan adalah <resource>=<value>. Jika satu angka positif ditentukan sebagai <value>, angka tersebut akan mengganti resource default untuk semua ukuran pengujian. 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 dapat berupa HOST_RAM/HOST_CPU, yang secara opsional diikuti dengan [-|*]<float> (misalnya, 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.
- Default
--[no]experimental_android_use_parallel_dex2oat
: "false" -
Gunakan dex2oat secara paralel untuk mempercepat android_test.
Tag:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- Default
--[no]ios_memleaks
: "false" -
Mengaktifkan pemeriksaan kebocoran memori di target ios_test.
Tag:action_command_lines
- Default
--ios_simulator_device=<a string>
: 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 komputer tempat simulator akan dijalankan.
Tag:test_runner
- Default
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi iOS yang akan dijalankan di simulator saat menjalankan atau menguji. Hal 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 frekuensi untuk menjalankan setiap pengujian. Jika salah satu upaya tersebut gagal karena alasan apa pun, seluruh pengujian akan dianggap gagal. Biasanya, nilai yang ditentukan hanyalah bilangan bulat. Contoh: --runs_per_test=3 akan menjalankan semua pengujian 3 kali. Sintaksis alternatif: regex_filter@runs_per_test. Dengan runs_per_test adalah nilai bilangan bulat dan regex_filter adalah daftar pola ekspresi reguler yang disertakan dan dikecualikan (Lihat juga --instrumentation_filter). Contoh: --runs_per_test=//foo/.*,-//foo/bar/.*@3 menjalankan semua pengujian di //foo/ kecuali yang berada di foo/bar tiga kali. Opsi ini dapat diteruskan beberapa kali. Argumen yang terakhir diteruskan yang cocok akan diutamakan. Jika tidak ada yang cocok, pengujian hanya dijalankan sekali.
--test_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan variabel lingkungan tambahan yang akan dimasukkan ke dalam lingkungan runner pengujian. Variabel dapat ditentukan berdasarkan nama, dalam hal ini nilainya akan dibaca dari lingkungan klien Bazel, atau dengan pasangan name=value. 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" - Ganti nilai waktu tunggu pengujian default untuk waktu tunggu pengujian (dalam detik). Jika satu nilai bilangan bulat positif ditentukan, nilai tersebut akan menggantikan semua kategori. Jika 4 bilangan bulat yang dipisahkan koma ditentukan, bilangan bulat 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 benar, output pengujian yang tidak dideklarasikan akan diarsipkan dalam file zip.
Tag:test_runner
- Opsi yang terkait dengan output dan semantik kueri:
- Default
--aspect_deps=<off, conservative or precise>
: "konservatif" -
Cara me-resolve dependensi aspek saat format output adalah salah satu dari {xml,proto,record}. 'nonaktif' berarti tidak ada dependensi aspek yang di-resolve, 'konservatif' (default) berarti semua dependensi aspek yang dideklarasikan ditambahkan terlepas dari apakah dependensi tersebut diberi class aturan dependensi langsung, 'akurat' berarti hanya aspek yang mungkin aktif yang ditambahkan dengan class aturan dependensi langsung. Perhatikan bahwa mode presisi memerlukan pemuatan paket lain untuk mengevaluasi satu target sehingga membuatnya lebih lambat daripada mode lainnya. Perhatikan juga bahwa mode presisi pun tidak sepenuhnya presisi: keputusan apakah akan menghitung aspek atau tidak diputuskan dalam fase analisis, yang tidak dijalankan selama 'kueri bazel'.
Tag:build_file_semantics
- Default
--[no]consistent_labels
: "false" -
Jika diaktifkan, setiap perintah kueri akan menampilkan label seolah-olah oleh fungsi Starlark <code>str</code> yang diterapkan ke instance <code>Label</code>. Hal ini berguna untuk alat yang perlu mencocokkan output dari berbagai perintah kueri dan/atau label yang dikeluarkan oleh aturan. Jika tidak diaktifkan, pemformat output bebas untuk menampilkan nama repositori yang jelas (relatif terhadap repositori utama) untuk membuat output lebih mudah dibaca.
Tag:terminal_output
- Default
--[no]experimental_explicit_aspects
: "false" -
aquery, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: no-op (aspek selalu diikuti).
Tag:terminal_output
- Default
--[no]graph:factored
: "true" -
Jika benar, grafik akan dimunculkan 'difaktorkan', yaitu node yang setara secara topologi akan digabungkan dan labelnya 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 terpotong; -1 berarti tidak ada pemotongan. Opsi ini hanya berlaku untuk --output=graph.
Tag:terminal_output
- Default
--[no]implicit_deps
: "true" -
Jika diaktifkan, dependensi implisit akan disertakan dalam grafik dependensi tempat kueri beroperasi. Dependensi implisit adalah dependensi yang tidak ditentukan secara eksplisit dalam file BUILD, tetapi ditambahkan oleh bazel. Untuk kueri, opsi ini mengontrol pemfilteran toolchain yang telah di-resolve.
Tag:build_file_semantics
- Default
--[no]include_aspects
: "true" -
query, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: no-op (aspek selalu diikuti).
Tag:terminal_output
--[no]incompatible_package_group_includes_double_slash
default: "true"-
Jika diaktifkan, saat menampilkan atribut `packages` package_group, `//` di awal tidak akan dihilangkan.
Tag:terminal_output
,incompatible_change
- Default
--[no]infer_universe_scope
: "false" -
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 Anda hanya boleh menggunakan opsi ini 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` (yaitu bukan `cquery`).
Tag:loading_and_analysis
- Default
--[no]line_terminator_null
: "false" -
Apakah setiap format diakhiri dengan \0, bukan baris baru.
Tag:terminal_output
--[no]nodep_deps
default: "true"-
Jika diaktifkan, dependensi dari atribut "nodep" akan disertakan dalam grafik dependensi tempat kueri beroperasi. 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 tempat hasil cquery akan dicetak. Nilai yang diizinkan untuk cquery adalah: label, label_kind, textproto, transitions, proto, streamed_proto, jsonproto. Jika memilih 'transitions', Anda juga harus menentukan opsi --transitions=(lite|full).
Tag:terminal_output
- Default
--[no]proto:default_values
: "true" -
Jika 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
- Default
--[no]proto:definition_stack
: "false" -
Isi kolom proto resolution_stack, yang mencatat stack panggilan Starlark untuk setiap instance aturan saat class aturan ditentukan.
Tag:terminal_output
- Default
--[no]proto:flatten_selects
: "true" -
Jika diaktifkan, atribut yang dapat dikonfigurasi yang dibuat oleh select() akan diratakan. Untuk jenis daftar, representasi yang diratakan adalah daftar yang berisi setiap nilai peta yang dipilih tepat sekali. Jenis skalar diratakan menjadi null.
Tag:build_file_semantics
- Default
--[no]proto:include_attribute_source_aspects
: "false" -
Isi kolom proto source_aspect_name dari setiap Atribut dengan aspek sumber asal atribut (string kosong jika tidak ada).
Tag:terminal_output
- Default
--[no]proto:include_configurations
: "true" -
jika diaktifkan, output proto akan menyertakan informasi tentang konfigurasi. Jika dinonaktifkan,format output proto cquery akan menyerupai format output kueri.
Tag:affects_outputs
- Default
--[no]proto:include_synthetic_attribute_hash
: "false" -
Apakah akan menghitung dan mengisi atribut $internal_attr_hash atau tidak.
Tag:terminal_output
- Default
--[no]proto:instantiation_stack
: "false" -
Isi stack panggilan pembuatan instance dari setiap aturan. Perhatikan bahwa hal ini mengharuskan stack tersedia
Tag:terminal_output
- Default
--[no]proto:locations
: "true" -
Apakah akan menampilkan 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. Tetapkan ke string kosong agar tidak menampilkan atribut apa pun. Opsi ini berlaku untuk --output=proto.
Tag:terminal_output
- Default
--[no]proto:rule_inputs_and_outputs
: "true" -
Apakah akan mengisi kolom rule_input dan rule_output atau tidak.
Tag:terminal_output
- Default
--query_file=<a string>
: "" -
Jika ditetapkan, kueri akan membaca kueri dari file bernama di sini, bukan pada command line. Menentukan file di sini serta kueri command line akan menyebabkan error.
Tag:changes_inputs
- Default
--[no]relative_locations
: "false" -
Jika 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 komputer. Anda dapat menetapkan opsi ini ke true (benar) untuk memiliki hasil yang konsisten di seluruh komputer.
Tag:terminal_output
- Default
--show_config_fragments=<off, direct or transitive>
: "nonaktif" -
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
- Default
--starlark:expr=<a string>
: "" -
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 ditentukan, opsi ini akan ditetapkan secara default ke 'str(target.label)'. Menentukan --starlark:expr dan --starlark:file merupakan error.
Tag:terminal_output
- Default
--starlark:file=<a string>
: "" -
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 error. Lihat bantuan untuk --output=starlark untuk mengetahui detail tambahan.
Tag:terminal_output
- Default
--[no]tool_deps
: "true" -
Kueri: Jika dinonaktifkan, dependensi pada 'konfigurasi exec' tidak akan disertakan dalam grafik dependensi tempat kueri beroperasi. Tepi dependensi 'konfigurasi exec', seperti yang berasal dari aturan 'proto_library' ke Compiler Protokol, biasanya mengarah ke alat yang dieksekusi selama build, bukan bagian dari program 'target' yang sama.
Cquery: Jika dinonaktifkan, akan memfilter semua target yang dikonfigurasi yang melintasi transisi eksekusi dari target tingkat teratas yang menemukan target yang dikonfigurasi ini. Artinya, jika target tingkat atas berada dalam konfigurasi target, hanya target yang dikonfigurasi juga dalam konfigurasi target yang akan ditampilkan. Jika target tingkat teratas berada dalam konfigurasi exec, hanya target yang dikonfigurasi exec yang akan ditampilkan. Opsi ini TIDAK akan mengecualikan toolchain yang telah di-resolve.
Tag:build_file_semantics
- Default
--transitions=<full, lite or none>
: "none" -
Format tempat cquery akan mencetak informasi transisi.
Tag:affects_outputs
- Default
--universe_scope=<comma-separated list of options>
: "" -
Kumpulan pola target yang dipisahkan koma (aditif dan subtraktif). Kueri dapat dilakukan di alam semesta yang ditentukan oleh penutupan transitif target yang ditentukan. Opsi ini digunakan untuk perintah kueri dan kueri.
Untuk kueri, input ke opsi ini adalah target tempat semua jawaban dibuat, sehingga opsi ini dapat memengaruhi konfigurasi dan transisi. Jika opsi ini tidak ditentukan, target tingkat atas diasumsikan sebagai target yang diuraikan dari ekspresi kueri. Catatan: Untuk cquery, tidak menetapkan opsi ini dapat menyebabkan build rusak jika target yang diuraikan dari ekspresi kueri tidak dapat dibangun dengan opsi tingkat atas.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--[no]experimental_filter_library_jar_with_program_jar
: "false" -
Memfilter ProgramJar ProGuard untuk menghapus class yang juga ada di LibraryJar.
Tag:action_command_lines
- Default
--[no]experimental_inmemory_dotd_files
: "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
- Default
--[no]experimental_inmemory_jdeps_files
: "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
- Default
--[no]experimental_objc_include_scanning
: "false" -
Apakah akan melakukan pemindaian yang menyertakan C/C++ objektif.
Tag:loading_and_analysis
,execution
,changes_inputs
- Default
--[no]experimental_retain_test_configuration_across_testonly
: "false" -
Jika diaktifkan, --trim_test_configuration tidak akan memangkas konfigurasi pengujian untuk aturan yang ditandai testonly=1. Hal ini dimaksudkan untuk mengurangi masalah konflik tindakan saat aturan non-pengujian bergantung pada aturan cc_test. Tidak berpengaruh jika --trim_test_configuration salah.
Tag:loading_and_analysis
,loses_incremental_state
- Default
--[no]experimental_starlark_cc_import
: "false" -
Jika diaktifkan, cc_import versi Starlark dapat digunakan.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_unsupported_and_brittle_include_scanning
: "false" -
Apakah akan mempersempit input ke kompilasi C/C++ dengan mengurai 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 include tidak sepenuhnya menerapkan semantik preprocessor C. Secara khusus, kode ini tidak memahami perintah #include dinamis dan mengabaikan logika bersyarat preprocessor. Risiko ditanggung sendiri. Setiap masalah yang terkait dengan laporan ini yang diajukan 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
- Default
--[no]objc_use_dotd_pruning
: "true" -
Jika ditetapkan, file .d yang dikeluarkan oleh clang akan digunakan untuk memangkas kumpulan input yang diteruskan ke kompilasi objc.
Tag:changes_inputs
,loading_and_analysis
- Default
--[no]process_headers_in_dependencies
: "false" -
Saat mem-build target //a:a, proses header di semua target yang menjadi dependensi //a:a (jika pemrosesan header diaktifkan untuk toolchain).
Tag:execution
- Default
--[no]trim_test_configuration
: "true" -
Jika diaktifkan, opsi terkait pengujian akan dihapus di bawah tingkat teratas build. Jika tanda ini aktif, pengujian tidak dapat dibuat sebagai dependensi aturan non-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
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
Mencetak informasi debug selama resolusi toolchain. Flag ini menggunakan ekspresi reguler, yang diperiksa terhadap jenis toolchain dan target tertentu untuk melihat mana yang akan di-debug. Beberapa ekspresi reguler dapat dipisahkan dengan koma, lalu setiap ekspresi reguler akan 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. Fungsi ini memerlukan satu pasangan nilai kunci dalam bentuk "<key>=<value>" sebagai argumen.
Tag:changes_inputs
- Default
--[no]incompatible_default_to_explicit_init_py
: "false" -
Flag ini mengubah perilaku default sehingga file __init__.py tidak lagi dibuat secara otomatis di runfile target Python. Tepatnya, saat target py_binary atau py_test menetapkan legacy_create_init ke "auto" (default), target dianggap salah jika dan hanya jika flag 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 dibangun di konfigurasi Python 2 akan muncul di root output yang menyertakan akhiran '-py2', sedangkan target yang dibuat untuk Python 3 akan muncul di root tanpa akhiran terkait Python. Ini berarti bahwa symlink praktis `bazel-bin` akan mengarah ke target Python 3, bukan Python 2. Jika Anda mengaktifkan opsi ini, sebaiknya aktifkan `--incompatible_py3_is_default`.
Tag:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
default: "true"-
Jika benar, 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 tetapkan juga `--incompatible_py2_outputs_are_suffixed`.
Tag:loading_and_analysis
,affects_outputs
,incompatible_change
- Default
--[no]incompatible_use_python_toolchains
: "true" -
Jika ditetapkan 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
- Default
--python_version=<PY2 or PY3>
: lihat deskripsi -
Mode versi utama Python, baik `PY2` maupun `PY3`. Perhatikan bahwa ini diganti oleh target `py_binary` dan `py_test` (meskipun tidak menentukan versi secara eksplisit) sehingga biasanya tidak ada banyak alasan untuk memberikan tanda ini.
Tag:loading_and_analysis
,affects_outputs
- Opsi lainnya, yang tidak dikategorikan.:
--[no]cache_test_results
[-t
] default: "auto"- Jika ditetapkan ke 'auto', Bazel akan menjalankan ulang pengujian jika dan hanya jika: (1) Bazel mendeteksi perubahan dalam pengujian atau dependensinya, (2) pengujian ditandai sebagai eksternal, (3) beberapa pengujian dijalankan 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 'no', Bazel tidak akan menyimpan hasil pengujian dalam cache.
- Default
--[no]experimental_cancel_concurrent_tests
: "false" -
Jika true (benar), Blaze akan membatalkan secara serentak yang menjalankan pengujian saat pertama kali berhasil dijalankan. Opsi ini hanya berguna jika digunakan bersama --runs_per_test_detects_flakes.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_fetch_all_coverage_outputs
: "false" -
Jika benar, Bazel akan mengambil seluruh direktori data cakupan untuk setiap pengujian selama cakupan dijalankan.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_generate_llvm_lcov
: "false" -
Jika benar, cakupan untuk clang akan menghasilkan laporan LCOV.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_j2objc_header_map
: "true" - Apakah akan membuat peta header J2ObjC secara paralel dengan transpilasi J2ObjC.
- Default
--[no]experimental_j2objc_shorter_header_path
: "false" -
Apakah akan dibuat dengan jalur header yang lebih pendek (menggunakan "_ios", bukan "_j2objc").
Tag:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
default: "javabuilder"- Mengaktifkan classpath yang dikurangi untuk kompilasi Java.
- Default
--[no]experimental_limit_android_lint_to_android_constrained_java
: "false" -
Membatasi --experimental_run_android_lint_on_java_rules ke library yang kompatibel dengan Android.
Tag:affects_outputs
- Default
--[no]experimental_run_android_lint_on_java_rules
: "false" -
Apakah akan memvalidasi sumber java_*.
Tag:affects_outputs
- Default
--[no]explicit_java_test_deps
: "false" - Menentukan dependensi ke JUnit atau Hamcrest secara eksplisit dalam java_test, bukan secara tidak sengaja mendapatkannya dari deps TestRunner. Saat ini hanya berfungsi untuk bazel.
- Default
--host_java_launcher=<a build target label>
: lihat deskripsi - Peluncur Java yang digunakan oleh alat yang dieksekusi selama build.
--host_javacopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke javac saat mem-build alat yang dieksekusi selama build.
--host_jvmopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke VM Java saat mem-build alat yang dieksekusi selama 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 yang di-shard jika runner pengujian tidak menunjukkan bahwa pengujian tersebut mendukung sharding dengan menyentuh file di jalur di TEST_SHARD_STATUS_FILE. Jika salah, runner pengujian yang tidak mendukung sharding akan menyebabkan semua pengujian berjalan di setiap shard.
Tag:incompatible_change
- Default
--[no]incompatible_exclusive_test_sandboxed
: "true" -
Jika benar, pengujian eksklusif akan berjalan dengan strategi dalam sandbox. Menambahkan tag 'local' untuk memaksa pengujian eksklusif berjalan secara lokal
Tag:incompatible_change
- Default
--[no]incompatible_strict_action_env
: "false" -
Jika 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 spesifik dari klien, tetapi perhatikan bahwa hal itu dapat mencegah caching 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 yang akan diteruskan ke alat J2ObjC.
--java_debug
-
Menyebabkan mesin virtual Java pada pengujian java menunggu koneksi dari debugger yang mematuhi JDWP (seperti jdb) sebelum memulai pengujian. Menyiratkan -test_output=streamed.
Diperluas ke:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- Default
--[no]java_deps
: "true" - Buat informasi dependensi (untuk saat ini, classpath waktu kompilasi) per target Java.
--[no]java_header_compilation
default: "true"- Mengompilasi ijar langsung dari sumber.
- Default
--java_language_version=<a string>
: "" - Versi bahasa Java
- Default
--java_launcher=<a build target label>
: lihat deskripsi - Peluncur Java yang akan digunakan saat membangun biner Java. Jika tanda ini ditetapkan ke string kosong, peluncur JDK akan digunakan. Atribut "peluncur" mengganti tanda ini.
--java_runtime_version=<a string>
default: "local_jdk"- Versi runtime Java
--javacopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke javac.
--jvmopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke VM Java. Opsi ini akan ditambahkan ke opsi startup VM dari setiap target java_binary.
- Default
--legacy_main_dex_list_generator=<a build target label>
: lihat deskripsi - Menentukan biner yang akan digunakan untuk menghasilkan daftar class yang harus ada di dex utama saat mengompilasi multidex lama.
- Default
--optimizing_dexer=<a build target label>
: 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.
- Default
--proguard_top=<a build target label>
: lihat deskripsi - Menentukan versi ProGuard yang digunakan untuk penghapusan kode saat mem-build biner Java.
- Default
--proto_compiler=<a build target label>
: "@bazel_tools//tools/proto:protoc" -
Label proto-compiler.
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
- Default
--proto_toolchain_for_j2objc=<a build target label>
: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain" -
Label proto_lang_toolchain() yang menjelaskan cara mengompilasi proto j2objc
Tag:affects_outputs
,loading_and_analysis
- Default
--proto_toolchain_for_java=<a build target label>
: "@bazel_tools//tools/proto:java_toolchain" -
Label proto_lang_toolchain() yang menjelaskan cara mengompilasi proto Java
Tag:affects_outputs
,loading_and_analysis
- Default
--proto_toolchain_for_javalite=<a build target label>
: "@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 yang akan diteruskan ke compiler protobuf.
Tag:affects_outputs
- Default
--[no]runs_per_test_detects_flakes
: "false" - Jika true (benar), setiap shard dengan minimal satu run/percobaan yang lulus dan minimal satu run/percobaan gagal akan mendapatkan status FLAKY.
- Default
--shell_executable=<a path>
: lihat deskripsi -
Jalur absolut ke shell yang dapat dieksekusi untuk digunakan Bazel. Jika tidak ditetapkan, tetapi variabel lingkungan BAZEL_SH ditetapkan pada pemanggilan Bazel pertama (yang memulai server Bazel), Bazel akan menggunakannya. Jika tidak ada yang ditetapkan, Bazel akan menggunakan jalur default hard code bergantung pada sistem operasi tempatnya berjalan (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, semua 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 file yang dapat dieksekusi pengujian. Dapat digunakan beberapa kali untuk menentukan beberapa argumen. Jika beberapa pengujian dijalankan, masing-masing akan menerima argumen yang identik. Hanya digunakan oleh perintah 'bazel test'.
- Default
--test_filter=<a string>
: lihat deskripsi - Menentukan filter untuk diteruskan ke framework pengujian. Digunakan untuk membatasi pengujian yang dijalankan. Perhatikan bahwa hal ini tidak memengaruhi target yang di-build.
- Default
--test_result_expiration=<an integer>
: "-1" - Opsi ini tidak digunakan lagi dan tidak berpengaruh.
- Default
--[no]test_runner_fail_fast
: "false" - Teruskan opsi fail fast ke runner pengujian. 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>
: "explicit" - Menentukan strategi untuk sharding pengujian: 'explicit' untuk hanya menggunakan sharding jika atribut BUILD 'shard_count' ada. 'dinonaktifkan' untuk tidak pernah menggunakan sharding pengujian. 'forced=k' untuk menerapkan shard 'k' untuk pengujian, terlepas dari atribut BUILD 'shard_count'.
- Default
--tool_java_language_version=<a string>
: "" - Versi bahasa Java yang digunakan untuk menjalankan alat yang diperlukan selama build
- Default
--tool_java_runtime_version=<a string>
: "remotejdk_11" - Versi runtime Java yang digunakan untuk menjalankan alat selama build
- Default
--[no]use_ijars
: "true" - Jika diaktifkan, opsi ini akan menyebabkan kompilasi Java menggunakan jar antarmuka. Hal 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
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika disetel, cache repositori akan melakukan hardlink pada file jika cache ditemukan, bukan menyalinnya. Tindakan ini dimaksudkan untuk menghemat kapasitas disk.
Tag:bazel_internal_configuration
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--[no]incompatible_disable_native_repo_rules
: "false" -
Jika salah, aturan repo native dapat digunakan di WORKSPACE; jika tidak, aturan repo Starlark harus digunakan. Aturan repo native mencakup local_repository, new_local_repository, local_config_platform, android_sdk_repository, dan android_ndk_repository.
Tag:bazel_internal_configuration
- Default
--repository_cache=<a path>
: lihat deskripsi -
Menentukan lokasi cache 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
- Default
--[no]repository_disable_download
: "false" -
Jika disetel, mendownload menggunakan ctx.download{,_and_extract} tidak diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.Execute masih dapat menjalankan file arbitrer yang dapat mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang dengan masa berlaku yang terisi (0-100) yang di atas batasnya GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika disetel ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi yang mengontrol output perintah:
- Default
--[no]action_cache
: "false" -
Men-dump konten cache tindakan.
Tag:bazel_monitoring
- Default
--[no]packages
: "false" -
Men-dump konten cache paket.
Tag:bazel_monitoring
- Default
--[no]rule_classes
: "false" -
Men-dump class aturan.
Tag:bazel_monitoring
- Default
--[no]rules
: "false" -
Aturan dump, termasuk jumlah dan penggunaan memori (jika memori dilacak).
Tag:bazel_monitoring
- Default
--skyframe=<off, summary, count, deps or rdeps>
: "nonaktif" -
Hapus grafik Skyframe: 'off', 'summary', 'count', 'deps', atau 'rdeps'.
Tag:bazel_monitoring
- Default
--skykey_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: ".*" -
Filter ekspresi reguler nama SkyKey untuk output. Hanya digunakan dengan --skyframe=deps, rdeps.
Tag:bazel_monitoring
- Default
--skylark_memory=<a string>
: lihat deskripsi -
Men-dump profil memori yang kompatibel dengan pprof ke jalur yang ditentukan. Untuk mempelajari lebih lanjut, lihat https://github.com/google/pprof.
Tag:bazel_monitoring
- Opsi yang terkait dengan output dan semantik 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 dideklarasikan dihapus di registry tempatnya berasal (jika tidak berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang ditarik yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel dari modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasinya ke kegagalan resolusi, `nonaktif` untuk menonaktifkan pemeriksaan, atau `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi.
Tag:loading_and_analysis
- Default
--check_direct_dependencies=<off, warning or error>
: "peringatan" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di modul root adalah versi yang sama dengan yang Anda dapatkan di grafik dependensi yang di-resolve. Nilai yang valid adalah `nonaktif` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasinya ke kegagalan resolusi.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi developer tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai tanda ini.
Tag:loading_and_analysis
- Default
--lockfile_mode=<off, update, refresh or error>
: "update" -
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan mengupdatenya jika ada perubahan, `refresh` untuk memuat ulang informasi yang dapat diubah (versi yang ditarik dan modul yang sebelumnya tidak ada) dari registry jarak jauh dari waktu ke waktu, `error` untuk menggunakan file kunci, tetapi menampilkan error jika tidak terbaru, atau `off` untuk tidak membaca dari atau menulis ke file kunci.
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 <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
--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 baru akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
- Default
--vendor_dir=<a path>
: lihat deskripsi -
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat mem-build. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
default: "1detik:2,20detik:3,1menit:5"-
Batas yang, jika tercapai, menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan period adalah durasi dan count adalah bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang dengan masa berlaku (heap gen lama) tetap terisi setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti bahwa peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC minor terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC minor tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat peristiwa GC minor terjadi dan nilai minimum 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 penggunaan persentase heap yang dipertahankan setidaknya pada batas ini, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan. Dengan menyesuaikan hal ini, Anda dapat mengurangi dampak waktu berjalan dari thrashing GC, jika thrashing GC (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada merekonstruksi status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
- Default
--experimental_command_profile=<cpu, wall, alloc or lock>
: lihat deskripsi - Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alloc, atau lock) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama sesuai jenis peristiwa di direktori dasar output. Sintaksis dan semantik tanda ini mungkin berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; gunakan dengan risiko Anda sendiri.
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan dieksekusi terbanyak. Menyetel opsi ini akan menulis statistik untuk semua mnemoni.
- Opsi yang menentukan atau mengubah input umum untuk perintah Bazel yang tidak termasuk dalam kategori lain.:
- Default
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Jika tidak kosong, baca file yang di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan penyimpanan dalam cache jarak jauh:
- Default
--experimental_downloader_config=<a string>
: lihat deskripsi - Menentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali dengan perintah (`allow`, `block`, atau `rewrite`), diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk dicocokkan, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik yang dimulai dari `$1`. Anda dapat memberikan beberapa perintah `rewrite` untuk URL yang sama, dan dalam hal ini beberapa URL akan ditampilkan.
- Default
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Mode thread yang akan digunakan untuk pengambilan repo. Jika disetel ke 'off', tidak ada thread pekerja yang akan digunakan, dan pengambilan repo dapat dimulai ulang. Jika tidak, thread pekerja virtual akan digunakan.
- Opsi lainnya, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. 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 diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
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
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika ditetapkan, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Hal ini dimaksudkan untuk menghemat kapasitas disk.
Tag:bazel_internal_configuration
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--[no]incompatible_disable_native_repo_rules
: "false" -
Jika salah, aturan repo native dapat digunakan di WORKSPACE; jika tidak, aturan repo Starlark harus digunakan. Aturan repo native mencakup local_repository, new_local_repository, local_config_platform, android_sdk_repository, dan android_ndk_repository.
Tag:bazel_internal_configuration
- Default
--repository_cache=<a path>
: lihat deskripsi -
Menentukan lokasi cache 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
- Default
--[no]repository_disable_download
: "false" -
Jika ditetapkan, download menggunakan ctx.download{,_and_extract} tidak diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file yang dapat dieksekusi arbitrer yang mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--[no]all
: "false" -
Mengambil semua repositori eksternal yang diperlukan untuk mem-build target atau repositori apa pun. Ini adalah setelan default-nya jika tidak ada flag dan argumen lain yang disediakan. Hanya berfungsi jika --enable_bzlmod aktif.
Tag:changes_inputs
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang tenur yang ditempati (0-100) dan di atas nilai tersebut GcThrashingDetector menganggap peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika disetel ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
--[no]keep_going
[-k
] default: "false"-
Lanjutkan sebanyak mungkin setelah terjadi error. Meskipun target yang gagal dan target yang bergantung padanya tidak dapat dianalisis, prasyarat lain dari target ini dapat dianalisis.
Tag:eagerness_to_exit
- Default
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Jumlah thread paralel yang digunakan untuk fase pemuatan/analisis. Mengambil bilangan bulat, atau kata kunci ("otomatis", "HOST_CPUS", "HOST_RAM"), secara opsional diikuti dengan operasi ([-|*]<float>) misalnya "auto", "HOST_CPUS*.5". "auto" menetapkan default yang wajar berdasarkan resource host. Minimal harus 1.
Tag:bazel_internal_configuration
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
- Default
--[no]incompatible_config_setting_private_default_visibility
: "false" -
Jika incompatible_enforce_config_setting_ visibility=false, berarti ini adalah noop. Atau, jika tanda ini salah, config_setting apa pun tanpa atribut visibilitas eksplisit adalah //visibility:public. Jika tanda ini benar, config_setting akan mengikuti logika visibilitas yang sama dengan semua aturan lainnya. Lihat https://github.com/bazelbuild/bazel/issues/12933.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_enforce_config_setting_visibility
: "true" -
Jika true (benar), terapkan batasan visibilitas config_setting. Jika salah, setiap config_setting akan terlihat oleh setiap target. Lihat https://github.com/bazelbuild/bazel/issues/12932.
Tag:loading_and_analysis
,incompatible_change
- Opsi yang terkait dengan output dan semantik 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 dideklarasikan dihapus di registry tempatnya berasal (jika tidak berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang ditarik yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'semua' (tidak disarankan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Memeriksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan saat ketidakcocokan terdeteksi.
Tag:loading_and_analysis
- Default
--check_direct_dependencies=<off, warning or error>
: "peringatan" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di modul root adalah versi yang sama dengan yang Anda dapatkan di grafik dependensi yang di-resolve. Nilai yang valid adalah `nonaktif` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasinya ke kegagalan resolusi.
Tag:loading_and_analysis
- Default
--[no]configure
: "false" -
Hanya mengambil repositori yang ditandai sebagai 'konfigurasi' untuk tujuan konfigurasi sistem. Hanya berfungsi jika --enable_bzlmod aktif.
Tag:changes_inputs
- Default
--[no]force
: "false" -
Abaikan repositori yang ada jika ada dan paksa ambil repositori lagi. Hanya berfungsi jika --enable_bzlmod aktif.
Tag:changes_inputs
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` di MODULE.bazel dari modul root. Perhatikan bahwa dependensi developer tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai tanda ini.
Tag:loading_and_analysis
- Default
--lockfile_mode=<off, update, refresh or error>
: "update" -
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `refresh` untuk memperbarui informasi yang dapat diubah (versi yang ditarik dan modul yang sebelumnya tidak ada) dari registry jarak jauh dari waktu ke waktu, `error` untuk menggunakan lockfile, tetapi menampilkan error jika tidak diperbarui, atau `off` untuk tidak membaca dari 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 <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut akan sesuai dengan direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutan ini penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya 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
- Default
--vendor_dir=<a path>
: lihat deskripsi -
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalam atau menggunakannya saat mem-build. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
default: "1detik:2,20detik:3,1menit:5"-
Batasan yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel mengalami error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan period adalah durasi dan count adalah bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap gen lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan yang 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 diperlukan akan dihapus hingga beberapa kali per panggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC minor terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC minor tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat peristiwa GC minor terjadi dan nilai minimum 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 persentase heap yang dipertahankannya setidaknya mencapai nilai minimum ini, status Skyframe sementara yang tidak diperlukan akan dihapus. Dengan menyesuaikan hal ini, Anda dapat mengurangi dampak waktu berjalan dari thrashing GC, jika thrashing GC (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada merekonstruksi status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
- Default
--experimental_command_profile=<cpu, wall, alloc or lock>
: lihat deskripsi - Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alloc, atau lock) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama sesuai jenis peristiwa di direktori dasar output. Sintaksis dan semantik tanda ini mungkin berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; gunakan dengan risiko Anda sendiri.
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemoni dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemoni.
- Default
--experimental_repository_resolved_file=<a string>
: "" -
Jika tidak kosong, tulis nilai Starlark dengan informasi yang di-resolve dari semua aturan repositori Starlark yang dieksekusi.
Tag:affects_outputs
- Opsi yang menentukan atau mengubah input umum ke perintah Bazel yang tidak termasuk dalam kategori lain.:
- Default
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Jika tidak kosong, baca file yang di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan penyimpanan dalam cache jarak jauh:
- Default
--experimental_downloader_config=<a string>
: lihat deskripsi - Menentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali dengan perintah (`allow`, `block`, atau `rewrite`), diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk dicocokkan, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik yang dimulai dari `$1`. Anda dapat memberikan beberapa perintah `rewrite` untuk URL yang sama, dan dalam hal ini beberapa URL akan ditampilkan.
- Default
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Mode thread yang akan digunakan untuk pengambilan repo. Jika disetel ke 'off', tidak ada thread pekerja yang akan digunakan, dan pengambilan repo dapat dimulai ulang. Jika tidak, gunakan thread pekerja virtual.
- Opsi lainnya, 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 terlihat di suatu tempat pada jalur paket. Gunakan opsi ini saat menghapus subpaket '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 masih disediakan oleh entri package_path lain. Menentukan --deleted_packages x/y akan menghindari masalah ini.
- Default
--[no]fetch
: "true" - Mengizinkan perintah mengambil dependensi eksternal. Jika disetel ke salah (false), perintah akan menggunakan versi dependensi yang di-cache, dan jika tidak ada, perintah akan gagal.
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root ruang kerja, yang merupakan output `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
- Default
--package_path=<colon-separated list of options>
: "%workspace%" - Daftar yang dipisahkan titik dua untuk tempat mencari paket. Elemen yang diawali dengan '%workspace%' bersifat relatif terhadap ruang kerja yang melingkupinya. Jika dihilangkan atau kosong, defaultnya adalah output 'bazel info default-package-path'.
- Default
--[no]show_loading_progress
: "true" - Jika diaktifkan, akan menyebabkan Bazel mencetak pesan "Loading package:".
- Opsi yang mengontrol eksekusi build:
- Default
--[no]all
: "false" -
Mengambil semua repositori eksternal yang diperlukan untuk mem-build target atau repositori apa pun. Ini adalah setelan default-nya jika tidak ada flag dan argumen lain yang disediakan. Hanya berfungsi jika --enable_bzlmod aktif.
Tag:changes_inputs
- Default
--[no]experimental_inprocess_symlink_creation
: "false" -
Apakah akan membuat panggilan sistem file langsung untuk membuat hierarki symlink
Tag:loading_and_analysis
,execution
,experimental
- Default
--[no]experimental_persistent_aar_extractor
: "false" -
Aktifkan ekstraktor aar persisten menggunakan pekerja.
Tag:execution
- Default
--[no]experimental_remotable_source_manifests
: "false" -
Apakah akan membuat tindakan manifes sumber dapat diakses dari jarak jauh
Tag:loading_and_analysis
,execution
,experimental
- Default
--[no]experimental_split_coverage_postprocessing
: "false" -
Jika benar, Bazel akan menjalankan pascapemrosesan cakupan untuk pengujian dalam spawn baru.
Tag:execution
- Default
--[no]experimental_strict_fileset_output
: "false" -
Jika opsi ini diaktifkan, set file akan memperlakukan semua artefak output sebagai file reguler. Perintah ini tidak akan menjelajahi direktori atau sensitif terhadap symlink.
Tag:execution
- Default
--[no]incompatible_disallow_unsound_directory_outputs
: "true" -
Jika ditetapkan, tindakan untuk mewujudkan file output sebagai direktori akan mengalami error. Tidak memengaruhi direktori sumber. Lihat https://github.com/bazelbuild/bazel/issues/18646.
Tag:bazel_internal_configuration
,incompatible_change
- Default
--[no]incompatible_modify_execution_info_additive
: "false" -
Jika diaktifkan, meneruskan beberapa tanda --modify_execution_info bersifat tambahan. Jika dinonaktifkan, hanya tanda terakhir yang akan dipertimbangkan.
Tag:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
--[no]keep_going
[-k
] default: "false"-
Lanjutkan sebanyak mungkin setelah terjadi error. Meskipun target yang gagal dan target yang bergantung padanya tidak dapat dianalisis, prasyarat lain dari target ini dapat dianalisis.
Tag:eagerness_to_exit
- Default
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "otomatis" -
Jumlah thread paralel yang akan digunakan untuk fase pemuatan/analisis.Mengambil bilangan bulat, atau kata kunci ("auto", "HOST_CPUS", "HOST_RAM"), secara opsional diikuti dengan operasi ([-|*]<float>) misalnya. "auto", "HOST_CPUS*.5". "auto" menetapkan default yang wajar berdasarkan resource host. Minimal harus 1.
Tag:bazel_internal_configuration
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
beberapa penggunaan diakumulasikan-
Menambahkan atau menghapus kunci dari info eksekusi tindakan berdasarkan mnemoni 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 ekspresi reguler yang dapat diterapkan ke mnemoni yang sama.
Sintaksis: "regex=[+-]key,regex=[+-]key,...".
Contoh:
'.*=+x,.*=-y,.*=+z' menambahkan 'x' dan 'z' ke, dan menghapus 'y' dari, info eksekusi untuk semua tindakan.
'Genrule=+requires-x' menambahkan 'requires-x' ke info eksekusi untuk semua tindakan Genrule.
'(?!Genrule).*=-requires-x' menghapus 'requires-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 yang 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
-
Mengaktifkan pemroses resource Android persisten menggunakan pekerja.
Diperluas menjadi:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
Tag:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Mengaktifkan tindakan dex dan desugar Android multipleks persisten menggunakan pekerja.
Diperluas menjadi:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Tag:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Mengaktifkan 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
-
Mengaktifkan alat Android yang persisten dan multipleks (dexing, desugaring, pemrosesan resource).
Diperluas menjadi:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Tag:host_machine_resource_optimizations
,execution
- Default
--[no]use_target_platform_for_tests
: "false" -
Jika benar, Bazel akan menggunakan platform target untuk menjalankan pengujian, bukan grup eksekusi pengujian.
Tag:execution
- Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
- Default
--android_compiler=<a string>
: 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
- Default
--android_grte_top=<a label>
: 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. Flag untuk membantu transisi ke penggabungan manifes Android dari penggabungan lama.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--android_platforms=<a build target label>
: "" -
Menetapkan platform yang digunakan target android_binary. Jika beberapa platform ditentukan, biner adalah APK tebal, 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 Android SDK/platform 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
- Default
--cc_output_directory_tag=<a string>
: "" -
Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.
Tag:affects_outputs
- Default
--compiler=<a string>
: 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 ini harus berupa grup file yang berisi satu file, yaitu biner. Defaultnya 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 ini 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. Setelan defaultnya adalah '//tools/test:coverage_support'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
default: "@bazel_tools//tools/cpp:toolchain"-
Label paket crosstool yang akan digunakan untuk mengompilasi kode C++.
Tag:loading_and_analysis
,changes_inputs
,affects_outputs
- Default
--custom_malloc=<a build target label>
: lihat deskripsi -
Menentukan implementasi malloc kustom. Setelan ini menggantikan atribut malloc 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, yang masing-masing secara opsional 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 apa pun di bawah //demo kecuali untuk mereka yang namanya berisi 'test'.
Tag:loading_and_analysis
- Default
--[no]experimental_include_xcode_execution_requirements
: "false" -
Jika ditetapkan, tambahkan persyaratan eksekusi "requires-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
- Default
--[no]experimental_prefer_mutual_xcode
: "true" -
Jika true (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 pilihan xcode.
Tag:loses_incremental_state
- Default
--extra_execution_platforms=<comma-separated list of options>
: "" -
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 platform yang dideklarasikan dalam file WORKSPACE oleh register_execution_platforms(). Opsi ini hanya boleh ditetapkan 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
- Default
--grte_top=<a label>
: lihat deskripsi -
Label ke library libc yang di-check in. Nilai default dipilih oleh toolchain crosstool, dan Anda hampir tidak pernah perlu menggantinya.
Tag:action_command_lines
,affects_outputs
- Default
--host_compiler=<a string>
: lihat deskripsi -
Compiler C++ yang akan digunakan untuk kompilasi host. Nilai ini diabaikan jika --host_crosstool_top tidak ditetapkan.
Tag:loading_and_analysis
,execution
- Default
--host_crosstool_top=<a build target label>
: lihat deskripsi -
Secara default, opsi --crosstool_top dan --compiler juga digunakan untuk konfigurasi exec. Jika flag ini disediakan, Bazel akan menggunakan libc dan compiler default untuk crosstool_top yang diberikan.
Tag:loading_and_analysis
,changes_inputs
,affects_outputs
- Default
--host_grte_top=<a label>
: lihat deskripsi -
Jika ditentukan, setelan ini akan menggantikan direktori tingkat teratas libc (--grte_top) untuk konfigurasi exec.
Tag:action_command_lines
,affects_outputs
--host_platform=<a build target label>
default: "@bazel_tools//tools:host_platform"-
Label aturan platform yang menjelaskan sistem host.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
- Default
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "true" -
Jika 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
- Default
--[no]incompatible_enable_android_toolchain_resolution
: "true" -
Gunakan resolusi toolchain untuk memilih Android SDK untuk aturan Android (Starlark dan native)
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_enable_apple_toolchain_resolution
: "false" -
Gunakan resolusi toolchain untuk memilih Apple SDK untuk aturan apple (Starlark dan native)
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
default: "true"-
Jika benar, Bazel tidak akan menggunakan kembali command line tindakan link C++ untuk command line pengindeksan lto (lihat https://github.com/bazelbuild/bazel/issues/6791 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_remove_legacy_whole_archive
: "true" -
Jika true (benar), Bazel tidak akan menautkan dependensi library sebagai seluruh arsip secara default (lihat https://github.com/bazelbuild/bazel/issues/7362 untuk mengetahui petunjuk migrasi).
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_require_ctx_in_configure_features
: "true" -
Jika benar, Bazel akan mewajibkan parameter 'ctx' ke cc_common.configure_features (lihat https://github.com/bazelbuild/bazel/issues/7793 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,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
- Default
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Menentukan versi iOS SDK yang akan digunakan untuk mem-build aplikasi iOS. Jika tidak ditentukan, akan menggunakan versi iOS SDK default dari 'xcode_version'.
Tag:loses_incremental_state
- Default
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Menentukan versi macOS SDK yang akan digunakan untuk mem-build aplikasi macOS. Jika tidak ditentukan, gunakan versi macOS SDK default dari 'xcode_version'.
Tag:loses_incremental_state
- Default
--minimum_os_version=<a string>
: lihat deskripsi -
Versi OS minimum yang ditargetkan kompilasi Anda.
Tag:loading_and_analysis
,affects_outputs
- Default
--platform_mappings=<a relative path>
: "" - Lokasi file pemetaan yang menjelaskan platform mana yang akan digunakan jika tidak ada yang ditetapkan atau flag mana yang akan ditetapkan jika platform sudah ada. Harus relatif terhadap root ruang kerja utama. Secara default, 'platform_mappings' (file langsung di bawah root ruang kerja).
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
- Default
--platforms=<a build target label>
: "" -
Label aturan platform yang menjelaskan platform target untuk perintah saat ini.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
- Default
--python2_path=<a string>
: lihat deskripsi -
Tidak digunakan lagi, tanpa pengoperasian. Dinonaktifkan oleh `--incompatible_use_python_ toolchains`.
Tag:no_op
,deprecated
- Default
--python3_path=<a string>
: lihat deskripsi -
Tidak digunakan lagi, tidak ada operasi. Dinonaktifkan oleh `--incompatible_use_python_toolchains`.
Tag:no_op
,deprecated
- Default
--python_path=<a string>
: lihat deskripsi -
Jalur absolut dari 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
- Default
--python_top=<a build target label>
: 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
- Default
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Menentukan versi tvOS SDK yang akan digunakan untuk mem-build aplikasi tvOS. Jika tidak ditentukan, versi SDK tvOS default akan digunakan dari 'xcode_version'.
Tag:loses_incremental_state
- Default
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Menentukan versi watchOS SDK yang akan digunakan untuk mem-build aplikasi watchOS. Jika tidak ditentukan, Anda akan menggunakan versi SDK watchOS default dari 'xcode_version'.
Tag:loses_incremental_state
- Default
--xcode_version=<a string>
: lihat deskripsi -
Jika ditentukan, menggunakan Xcode versi tertentu untuk tindakan build yang relevan. Jika tidak ditentukan, akan menggunakan versi default Xcode dari eksekutor.
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 dalam konfigurasi build.
Tag:loses_incremental_state
,loading_and_analysis
- Opsi yang mengontrol output perintah:
- Default
--[no]apple_generate_dsym
: "false" -
Apakah akan membuat file simbol debug (.dSYM).
Tag:affects_outputs
,action_command_lines
--[no]build_runfile_links
default: "true"-
Jika benar, build hutan symlink runfile untuk semua target. Jika salah (false), tulis hanya jika diperlukan oleh tindakan lokal, pengujian, atau perintah run.
Tag:affects_outputs
- Default
--[no]build_runfile_manifests
: "true" -
Jika benar, tulis manifes runfile untuk semua target. Jika salah (false), hapus. Pengujian lokal akan gagal dijalankan jika salah (false).
Tag:affects_outputs
- Default
--[no]build_test_dwp
: "false" -
Jika diaktifkan, saat mem-build pengujian C++ secara statis dan dengan fission, file .dwp untuk biner pengujian juga akan otomatis di-build.
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 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
- Default
--[no]experimental_proto_descriptor_sets_include_source_info
: "false" -
Menjalankan tindakan tambahan untuk versi API Java alternatif di proto_library.
Tag:affects_outputs
,loading_and_analysis
,experimental
- Default
--[no]experimental_proto_extra_actions
: "false" -
Menjalankan tindakan tambahan untuk versi API Java alternatif di proto_library.
Tag:affects_outputs
,loading_and_analysis
,experimental
- Default
--[no]experimental_save_feature_state
: "false" -
Menyimpan status fitur yang diaktifkan dan diminta sebagai output kompilasi.
Tag:affects_outputs
,experimental
- Default
--fission=<a set of compilation modes>
: "no" -
Menentukan mode kompilasi yang menggunakan fiksi untuk kompilasi dan link C++. Dapat berupa kombinasi dari {'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 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_avoid).
Tag:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
default: "true"-
Jika benar, build hutan symlink runfile untuk repositori eksternal di .runfiles/wsname/external/repo (selain .runfiles/repo).
Tag:affects_outputs
- Default
--[no]objc_generate_linkmap
: "false" -
Menentukan apakah akan membuat file linkmap.
Tag:affects_outputs
- Default
--[no]save_temps
: "false" -
Jika ditetapkan, output sementara dari gcc akan disimpan. Ini termasuk 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, yang 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 ditentukan berdasarkan nama, dalam hal ini nilai akan diambil dari lingkungan pemanggilan, atau dengan pasangan name=value yang menetapkan nilai yang terpisah dari lingkungan pemanggilan. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, yang terakhir menang, akumulasi opsi untuk berbagai variabel.
Tag:action_command_lines
- Default
--android_cpu=<a string>
: "armeabi-v7a" -
CPU target Android.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--[no]android_databinding_use_androidx
: "true" -
Membuat file data binding yang kompatibel dengan AndroidX. Ini hanya digunakan dengan databinding v2. Tanda ini tidak dioperasikan.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]android_databinding_use_v3_4_args
: "true" -
Gunakan android databinding v2 dengan argumen 3.4.0. Tanda ini tidak dioperasikan.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--android_dynamic_mode=<off, default or fully>
: "nonaktif" -
Menentukan apakah dependensi C++ dari aturan Android akan ditautkan secara dinamis saat cc_binary tidak membuat library bersama secara eksplisit. 'default' berarti bazel akan memilih apakah akan menautkan secara dinamis. 'sepenuhnya' berarti semua library akan ditautkan secara dinamis. 'off' berarti semua library akan ditautkan dalam sebagian besar mode statis.
Tag:affects_outputs
,loading_and_analysis
- Default
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "alphabetical" -
Menetapkan urutan manifes yang diteruskan ke penggabungan manifes untuk biner Android. ALFABETIS berarti manifes diurutkan berdasarkan jalur yang terkait dengan execroot. ALPHABETICAL_BY_CONFIGURATION berarti manifes diurutkan berdasarkan jalur yang terkait dengan direktori konfigurasi dalam direktori output. DEPENDENCY berarti manifes diurutkan dengan manifes setiap library yang muncul sebelum manifes dependensinya.
Tag:action_command_lines
,execution
- Default
--[no]android_resource_shrinking
: "false" -
Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]build_python_zip
: "auto" -
Mem-build zip yang dapat dieksekusi python; aktif di Windows, nonaktif di platform lain
Tag:affects_outputs
--catalyst_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk mem-build biner Apple Catalyst.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--[no]collect_code_coverage
: "false" -
Jika ditentukan, Bazel akan melengkapi kode (menggunakan instrumentasi offline jika memungkinkan) dan akan mengumpulkan informasi cakupan selama pengujian. Hanya target yang cocok dengan --instrumentation_filter yang akan terpengaruh. Biasanya, opsi ini tidak boleh ditentukan secara langsung - perintah 'bazel coverage' harus 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 yang akan diteruskan ke gcc.
Tag:action_command_lines
,affects_outputs
- Default
--cpu=<a string>
: "" -
CPU target.
Tag:changes_inputs
,affects_outputs
- Default
--cs_fdo_absolute_path=<a string>
: lihat deskripsi -
Gunakan 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
- Default
--cs_fdo_instrument=<a string>
: lihat deskripsi -
Buat biner dengan instrumentasi FDO yang sensitif terhadap konteks. Dengan compiler Clang/LLVM, compiler ini juga menerima nama direktori tempat file profil mentah akan dibuang saat runtime.
Tag:affects_outputs
- Default
--cs_fdo_profile=<a build target label>
: 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.
Tag:changes_inputs
,affects_outputs
- Default
--dynamic_mode=<off, default or fully>
: "default" -
Menentukan apakah biner C++ akan ditautkan secara dinamis. 'default' berarti Bazel akan memilih apakah akan menautkan secara dinamis. 'full' berarti semua library akan ditautkan secara dinamis. 'off' berarti semua library akan ditautkan dalam sebagian besar mode statis.
Tag:loading_and_analysis
,affects_outputs
- Default
--[no]enable_fdo_profile_absolute_path
: "true" -
Jika ditetapkan, penggunaan fdo_absolute_profile_path akan menimbulkan error.
Tag:affects_outputs
- Default
--[no]enable_runfiles
: "otomatis" -
Mengaktifkan hierarki symlink runfile; Secara default, dinonaktifkan di Windows, diaktifkan 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 menambahkan extra_action ke tindakan build yang ada.
Tag:execution
,experimental
- Default
--[no]experimental_android_compress_java_resources
: "false" -
Mengompresi resource Java dalam APK
Tag:affects_outputs
,loading_and_analysis
,experimental
- Default
--[no]experimental_android_databinding_v2
: "true" -
Gunakan android databinding v2. Tanda ini tidak dioperasikan.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]experimental_android_resource_shrinking
: "false" -
Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_android_rewrite_dexes_with_rex
: "false" -
menggunakan alat rex untuk menulis ulang file dex
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]experimental_collect_code_coverage_for_generated_files
: "false" -
Jika ditentukan, Bazel juga akan menghasilkan informasi cakupan pengumpulan untuk file yang dihasilkan.
Tag:affects_outputs
- Default
--experimental_objc_fastbuild_options=<comma-separated list of options>
: "-O0,-DDEBUG=1" -
Menggunakan string ini sebagai opsi compiler fastbuild objc.
Tag:action_command_lines
- Default
--[no]experimental_omitfp
: "false" -
Jika benar, gunakan libunwind untuk unwinding stack, dan kompilasi dengan -fomit-frame-pointer dan -fasynchronous-unwind-tables.
Tag:action_command_lines
,affects_outputs
,experimental
- Default
--experimental_output_paths=<off, content or strip>
: "nonaktif" -
Model mana yang akan digunakan untuk tempat aturan hierarki output menulis outputnya, terutama untuk build multi-platform / multi-konfigurasi. Fitur ini sangat eksperimental. Lihat https://github.com/bazelbuild/bazel/issues/6526 untuk mengetahui detailnya. Tindakan Starlark dapat memilih untuk menggunakan pemetaan jalur dengan menambahkan kunci 'supports-path-mapping' ke kamus '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 dalam bentuk label=value dengan label merujuk ke platform dan nilai adalah nama singkat yang diinginkan untuk digunakan di jalur output. Hanya digunakan jika --experimental_platform_in_output_dir benar. Memiliki prioritas penamaan tertinggi.
Tag:affects_outputs
,experimental
- Default
--[no]experimental_platform_in_output_dir
: "false" -
Jika benar, nama singkat untuk platform target akan digunakan dalam nama direktori output, bukan CPU. Skema yang tepat bersifat eksperimental dan dapat berubah: Pertama, dalam kasus yang jarang terjadi, opsi --platforms tidak memiliki tepat satu nilai, hash dari opsi platform akan digunakan. Selanjutnya, jika nama pendek untuk platform saat ini didaftarkan oleh -- experiments_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. Terakhir, hash opsi platform digunakan sebagai upaya terakhir.
Tag:affects_outputs
,experimental
- Default
--[no]experimental_use_llvm_covmap
: "false" -
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
- Default
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
: "true" -
Hanya gunakan tanda ini sebagai bagian dari strategi pengujian atau migrasi yang disarankan. Perhatikan bahwa heuristik memiliki kekurangan yang diketahui dan sebaiknya bermigrasi untuk mengandalkan --experimental_override_name_platform_in_output_dir saja.
Tag:affects_outputs
,experimental
- Default
--fat_apk_cpu=<comma-separated set of options>
: "armeabi-v7a" -
Menyetel opsi ini akan mengaktifkan APK gemuk, yang berisi biner native untuk semua arsitektur target yang ditentukan, misalnya, --fat_apk_cpu=x86,armeabi-v7a. Jika tanda ini ditentukan, --android_cpu diabaikan untuk dependensi aturan android_binary.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--[no]fat_apk_hwasan
: "false" -
Apakah akan membuat pemisahan HWASAN.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--fdo_instrument=<a string>
: lihat deskripsi -
Buat biner dengan instrumentasi FDO. Dengan compiler Clang/LLVM, compiler ini juga menerima nama direktori tempat file profil mentah akan di-dump saat runtime.
Tag:affects_outputs
- Default
--fdo_optimize=<a string>
: 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 (misalnya `//foo/bar:file.afdo` - Anda mungkin perlu menambahkan perintah `exports_files` ke paket yang sesuai) dan label yang mengarah ke target `fdo_profile`. Flag ini akan diganti oleh aturan `fdo_profile`.
Tag:affects_outputs
- Default
--fdo_prefetch_hints=<a build target label>
: lihat deskripsi -
Gunakan petunjuk pengambilan data cache.
Tag:affects_outputs
- Default
--fdo_profile=<a build target label>
: 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 tersebut. Fitur negatif selalu menggantikan fitur positif. Lihat juga --host_features
Tag:changes_inputs
,affects_outputs
- Default
--[no]force_pic
: "false" -
Jika diaktifkan, semua kompilasi C++ akan menghasilkan kode yang tidak bergantung pada posisi ("-fPIC"), link lebih memilih library bawaan PIC daripada library non-PIC, dan link akan menghasilkan file yang dapat dieksekusi yang tidak bergantung pada 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 ditentukan berdasarkan nama, dalam hal ini nilai akan diambil dari lingkungan pemanggilan, atau dengan pasangan name=value yang menetapkan nilai secara independen dari lingkungan pemanggilan. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, yang terakhir menang, akumulasi opsi untuk berbagai variabel.
Tag:action_command_lines
- Default
--host_compilation_mode=<fastbuild, dbg or opt>
: "opt" -
Tentukan mode yang akan digunakan alat selama 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 untuk diteruskan ke compiler C untuk alat yang dibuat dalam konfigurasi exec.
Tag:action_command_lines
,affects_outputs
- Default
--host_cpu=<a string>
: "" -
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 di-build 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 tersebut. Fitur negatif selalu menggantikan fitur positif.
Tag:changes_inputs
,affects_outputs
- Default
--host_force_python=<PY2 or PY3>
: 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 exec.
Tag:action_command_lines
,affects_outputs
- Default
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi macOS minimum yang kompatibel untuk target host. Jika tidak ditentukan, gunakan 'macos_sdk_version'.
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. Sintaksis: regex_filter@option_1,option_2,...,option_n. Dengan regex_filter adalah daftar pola ekspresi reguler yang disertakan dan dikecualikan (Lihat juga --instrumentation_filter). option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus diapit dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ pertama yang 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
--host_swiftcopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke swiftc untuk alat eksekusi.
Tag:action_command_lines
,affects_outputs
- Default
--[no]incompatible_auto_exec_groups
: "false" -
Jika diaktifkan, grup eksekusi akan otomatis dibuat untuk setiap toolchain yang digunakan oleh aturan. Agar aturan ini berfungsi, aturan harus menentukan parameter `toolchain` pada tindakannya. Untuk mengetahui informasi selengkapnya, lihat https://github.com/bazelbuild/bazel/issues/17134.
Tag:affects_outputs
,incompatible_change
- Default
--[no]incompatible_merge_genfiles_directory
: "true" -
Jika true (benar), direktori genfiles akan dilipat ke dalam direktori bin.
Tag:affects_outputs
,incompatible_change
- Default
--[no]incompatible_use_host_features
: "true" -
Jika benar, gunakan --features hanya untuk konfigurasi target dan --host_features untuk konfigurasi exec.
Tag:changes_inputs
,affects_outputs
,incompatible_change
- Default
--[no]instrument_test_targets
: "false" -
Saat cakupan diaktifkan, menentukan apakah akan mempertimbangkan untuk melakukan instrumentasi pada aturan pengujian. 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 diinstrumentasi. Aturan yang diawali dengan '-' akan dikecualikan. Perhatikan bahwa hanya aturan non-pengujian yang diinstrumentasikan, kecuali jika --instrument_test_targets diaktifkan.
Tag:affects_outputs
- Default
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi iOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'ios_sdk_version'.
Tag:loses_incremental_state
--ios_multi_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk mem-build ios_application. Hasilnya adalah biner universal yang berisi semua arsitektur yang ditentukan.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--[no]legacy_whole_archive
: "true" -
Tidak digunakan lagi, diganti dengan --incompatible_remove_legacy_whole_archive (lihat https://github.com/bazelbuild/bazel/issues/7362 untuk mengetahui detailnya). Jika 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 penautan.
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 (di bagian --features=thin_lto).
Tag:action_command_lines
,affects_outputs
--macos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk mem-build biner Apple macOS.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi macOS minimum yang kompatibel untuk target. Jika tidak ditentukan, akan menggunakan 'macos_sdk_version'.
Tag:loses_incremental_state
- Default
--memprof_profile=<a build target label>
: lihat deskripsi -
Gunakan profil memprof.
Tag:affects_outputs
- Default
--[no]objc_debug_with_GLIBCXX
: "false" -
Jika kebijakan ini disetel, dan mode kompilasi disetel ke 'dbg', tentukan GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC, dan GLIBCPP_CONCEPT_CHECKS.
Tag:action_command_lines
- Default
--[no]objc_enable_binary_stripping
: "false" -
Apakah akan melakukan penghapusan simbol dan kode mati pada biner tertaut. Penghapusan biner akan dilakukan jika flag 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. Sintaksis: regex_filter@option_1,option_2,...,option_n. Dengan regex_filter adalah daftar pola ekspresi reguler yang disertakan dan dikecualikan (Lihat juga --instrumentation_filter). option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus diapit dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ pertama yang 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 (di bagian --features=thin_lto) saat mengompilasi objek backend tertentu. Opsi ini dapat diteruskan beberapa kali. Sintaksis: regex_filter@option_1,option_2,...,option_n. Dengan regex_filter adalah daftar pola ekspresi reguler yang disertakan dan dikecualikan. option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus diapit dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ pertama yang 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
- Default
--platform_suffix=<a string>
: lihat deskripsi -
Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.
Tag:loses_incremental_state
,affects_outputs
,loading_and_analysis
- Default
--propeller_optimize=<a build target label>
: lihat deskripsi -
Gunakan informasi profil Propeller untuk mengoptimalkan target build.Profil propeller harus terdiri dari minimal salah 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, di a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Perintah export_files mungkin harus ditambahkan ke paket yang sesuai agar file ini dapat dilihat oleh Bazel. Opsi ini harus digunakan sebagai: --propeller_optimize=//a/b:propeller_profile
Tag:action_command_lines
,affects_outputs
- Default
--propeller_optimize_absolute_cc_profile=<a string>
: lihat deskripsi -
Nama jalur absolut file cc_profile untuk build Propeller Optimized.
Tag:affects_outputs
- Default
--propeller_optimize_absolute_ld_profile=<a string>
: lihat deskripsi -
Nama jalur absolut file ld_profile untuk build Propeller Optimized.
Tag:affects_outputs
- Default
--run_under=<a prefix in front of command>
: 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', maka command line akhirnya adalah 'foo -bar test_binary -baz'.Ini juga dapat berupa label ke 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 true (benar), library native yang berisi fungsi identik akan digunakan bersama di antara target yang berbeda
Tag:loading_and_analysis
,affects_outputs
- Default
--[no]stamp
: "false" -
Biner stempel dengan tanggal, nama pengguna, nama host, informasi ruang kerja, dll.
Tag:affects_outputs
--strip=<always, sometimes or never>
default: "kadang-kadang"-
Menentukan apakah akan menghapus biner dan library bersama (menggunakan "-Wl,--strip-debug"). Nilai {i>default<i} 'kadang-kadang' berarti {i>strip iff<i} --compilation_mode=fastbuild.
Tag:affects_outputs
--stripopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan untuk dihapus saat membuat biner '<name>.stripped'.
Tag:action_command_lines
,affects_outputs
--swiftcopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke kompilasi Swift.
Tag:action_command_lines
--tvos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk mem-build biner Apple tvOS.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi tvOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'tvos_sdk_version'.
Tag:loses_incremental_state
--visionos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk mem-build biner visionOS Apple.
Tag:loses_incremental_state
,loading_and_analysis
--watchos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk mem-build biner Apple watchOS.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi watchOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'watchos_sdk_version'.
Tag:loses_incremental_state
- Default
--xbinary_fdo=<a build target label>
: lihat deskripsi -
Gunakan 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 menerapkan input build yang valid (definisi aturan, kombinasi flag, dll.):
- Default
--auto_cpu_environment_group=<a build target label>
: "" -
Deklarasikan environment_group yang akan digunakan untuk memetakan nilai CPU secara otomatis ke nilai target_environment.
Tag:changes_inputs
,loading_and_analysis
,experimental
- Default
--[no]check_licenses
: "false" -
Pastikan batasan pemberian lisensi yang diberlakukan oleh paket dependen tidak bertentangan dengan mode distribusi target yang sedang dibuat. Secara default, lisensi tidak dicentang.
Tag:build_file_semantics
- Default
--[no]check_visibility
: "true" -
Jika dinonaktifkan, error visibilitas dalam dependensi target akan didemosikan menjadi peringatan.
Tag:build_file_semantics
- Default
--[no]desugar_for_android
: "true" -
Apakah akan mendesugar bytecode Java 8 sebelum melakukan dexing.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--[no]desugar_java8_libs
: "false" -
Apakah akan menyertakan library Java 8 yang didukung dalam aplikasi untuk perangkat lama.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]enforce_constraints
: "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
- Default
--[no]experimental_check_desugar_deps
: "true" -
Apakah akan memeriksa ulang desugaring yang benar pada level biner Android.
Tag:eagerness_to_exit
,loading_and_analysis
,experimental
- Default
--experimental_import_deps_checking=<off, warning or error>
: "NONAKTIF" -
Jika diaktifkan, periksa apakah dependensi aar_import sudah selesai. Penerapan ini dapat merusak build, atau hanya dapat menghasilkan peringatan.
Tag:loading_and_analysis
- Default
--experimental_one_version_enforcement=<off, warning or error>
: "NONAKTIF" -
Jika diaktifkan, aturan java_binary tidak boleh berisi lebih dari satu versi file class yang sama di classpath. Penerapan ini dapat merusak build, atau hanya dapat menghasilkan peringatan.
Tag:loading_and_analysis
- Default
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "default" -
Jika benar, memeriksa apakah target Java secara eksplisit mendeklarasikan semua target yang digunakan secara langsung sebagai dependensi.
Tag:build_file_semantics
,eagerness_to_exit
- Default
--[no]incompatible_check_testonly_for_output_files
: "false" -
Jika diaktifkan, periksa testonly untuk target prasyarat yang merupakan file output dengan mencari testonly aturan pembuatan. Hal ini cocok dengan pemeriksaan visibilitas.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_check_visibility_for_toolchains
: "false" -
Jika diaktifkan, pemeriksaan visibilitas juga berlaku untuk implementasi toolchain.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_disable_native_android_rules
: "false" -
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
- Default
--[no]incompatible_disable_native_apple_binary_rule
: "false" -
Tidak ada operasi. Dipertahankan di sini untuk kompatibilitas mundur.
Tag:eagerness_to_exit
,incompatible_change
- Default
--[no]incompatible_python_disable_py2
: "true" -
Jika benar, menggunakan setelan Python 2 akan menyebabkan error. Ini mencakup 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
- Default
--[no]incompatible_validate_top_level_header_inclusions
: "true" -
Jika benar, Bazel juga akan memvalidasi penyertaan header direktori tingkat teratas (lihat https://github.com/bazelbuild/bazel/issues/10047 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]one_version_enforcement_on_java_tests
: "true" -
Jika diaktifkan, dan dengan experimental_one_version_enforcement ditetapkan ke nilai non-NONE, terapkan satu versi pada target java_test. Tanda ini dapat dinonaktifkan untuk meningkatkan performa pengujian tambahan dengan mengorbankan potensi pelanggaran satu versi.
Tag:loading_and_analysis
- Default
--python_native_rules_allowlist=<a build target label>
: lihat deskripsi -
Daftar yang diizinkan (target package_group) yang akan digunakan saat menerapkan --incompatible_python_disallow_native_rules.
Tag:loading_and_analysis
- Default
--[no]strict_filesets
: "false" -
Jika opsi ini diaktifkan, set file yang melintasi batas paket akan dilaporkan sebagai error.
Tag:build_file_semantics
,eagerness_to_exit
- Default
--strict_proto_deps=<off, warn, error, strict or default>
: "error" -
Kecuali jika 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>
: "nonaktif" -
Kecuali jika NONAKTIF, memeriksa apakah target proto_library secara eksplisit mendeklarasikan semua target yang digunakan di 'import public' sebagai diekspor.
Tag:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Default
--[no]strict_system_includes
: "false" -
Jika 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 ditetapkan, semua target tingkat atas 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
- Default
--[no]device_debug_entitlements
: "true" -
Jika ditetapkan, dan mode kompilasi tidak 'diikutsertakan', aplikasi objc akan menyertakan hak debug saat menandatangani.
Tag:changes_inputs
- Default
--ios_signing_cert_name=<a string>
: lihat deskripsi -
Nama sertifikat yang akan digunakan untuk penandatanganan iOS. Jika tidak ditetapkan, akan kembali ke profil penyediaan. Mungkin merupakan preferensi identitas keychain sertifikat atau (substring) nama umum sertifikat, sesuai dengan halaman man codesign (IDENTITAS PENANDATANGANAN).
Tag:action_command_lines
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
- Default
--[no]incompatible_config_setting_private_default_visibility
: "false" -
Jika incompatible_enforce_config_setting_visibility=false, ini adalah noop. Selain itu, jika tanda ini salah, config_setting apa pun tanpa atribut visibilitas eksplisit adalah //visibility:public. Jika tanda ini benar, config_setting akan mengikuti logika visibilitas yang sama seperti semua aturan lainnya. Lihat https://github.com/bazelbuild/bazel/issues/12933.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_disallow_legacy_py_provider
: "true" -
Tidak ada operasi, akan segera dihapus.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_disallow_sdk_frameworks_attributes
: "false" -
Jika benar, jangan izinkan atribut sdk_frameworks dan weak_sdk_frameworks di objc_library dan objc_import.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_enforce_config_setting_visibility
: "true" -
Jika benar, terapkan batasan visibilitas config_setting. Jika salah, setiap config_setting dapat dilihat oleh setiap target. Lihat https://github.com/bazelbuild/bazel/issues/12932.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_objc_alwayslink_by_default
: "false" -
Jika benar, jadikan nilai default benar untuk atribut alwayslink di objc_library dan objc_import.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_python_disallow_native_rules
: "false" -
Jika benar (true), error akan terjadi saat menggunakan aturan py_* bawaan; sebagai gantinya, aturan rule_python harus digunakan. Lihat https://github.com/bazelbuild/bazel/issues/17773 untuk mengetahui informasi selengkapnya dan petunjuk migrasi.
Tag:loading_and_analysis
,incompatible_change
- Opsi yang mengatur perilaku lingkungan pengujian atau runner pengujian:
- Default
--[no]allow_analysis_failures
: "false" -
Jika benar, kegagalan analisis target aturan akan menyebabkan penyebaran instance AnalysisFailureInfo yang berisi deskripsi error, bukan menyebabkan 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
- Default
--[no]break_build_on_parallel_dex2oat_failure
: "false" -
Jika benar, kegagalan tindakan dex2oat akan menyebabkan build rusak, bukan menjalankan 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- Ganti jumlah resource default untuk pengujian. Format yang diharapkan adalah <resource>=<value>. Jika satu angka positif ditentukan sebagai <value>, angka tersebut akan mengganti resource default untuk semua ukuran pengujian. Jika 4 angka yang dipisahkan koma ditentukan, angka tersebut akan mengganti jumlah resource untuk ukuran pengujian kecil, sedang, besar, dan sangat besar. Nilai juga bisa HOST_RAM/HOST_CPU, bisa juga diikuti oleh [-|*]<float> (misalnya 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.
- Default
--[no]experimental_android_use_parallel_dex2oat
: "false" -
Gunakan dex2oat secara paralel untuk mempercepat android_test.
Tag:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- Default
--[no]ios_memleaks
: "false" -
Aktifkan pemeriksaan kebocoran memori di target ios_test.
Tag:action_command_lines
- Default
--ios_simulator_device=<a string>
: 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 komputer tempat simulator akan dijalankan.
Tag:test_runner
- Default
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi iOS yang akan dijalankan di simulator saat menjalankan atau menguji. Hal 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 frekuensi untuk menjalankan setiap pengujian. Jika salah satu upaya tersebut gagal karena alasan apa pun, seluruh pengujian akan dianggap gagal. Biasanya, nilai yang ditentukan hanyalah bilangan bulat. Contoh: --runs_per_test=3 akan menjalankan semua pengujian 3 kali. Sintaks alternatif: regex_filter@runs_per_test. Dengan runs_per_test adalah nilai bilangan bulat dan regex_filter adalah daftar pola ekspresi reguler yang disertakan dan dikecualikan (Lihat juga --instrumentation_filter). Contoh: --runs_per_test=//foo/.*,-//foo/bar/.*@3 menjalankan semua pengujian di //foo/ kecuali di foo/bar tiga kali. Opsi ini dapat diteruskan beberapa kali. Argumen yang terakhir diteruskan yang cocok akan diutamakan. Jika tidak ada yang cocok, pengujian hanya dijalankan sekali.
--test_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan variabel lingkungan tambahan untuk dimasukkan ke lingkungan runner pengujian. Variabel dapat ditentukan berdasarkan nama, dalam hal ini nilainya akan dibaca dari lingkungan klien Bazel, atau dengan pasangan name=value. 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" - Ganti nilai waktu tunggu pengujian default untuk waktu tunggu pengujian (dalam detik). Jika satu nilai bilangan bulat positif ditentukan, nilai tersebut akan menggantikan semua kategori. Jika 4 bilangan bulat yang dipisahkan koma ditentukan, bilangan tersebut akan mengganti waktu tunggu untuk singkat, sedang, lama, dan abadi (dalam urutan tersebut). Dalam kedua bentuk tersebut, nilai -1 akan memberi tahu blaze untuk menggunakan waktu tunggu defaultnya untuk kategori tersebut.
- Default
--[no]zip_undeclared_test_outputs
: "true" -
Jika true (benar), output pengujian yang tidak dideklarasikan akan diarsipkan dalam file ZIP.
Tag:test_runner
- Opsi yang terkait dengan output dan semantik Bzlmod:
- Default
--[no]configure
: "false" -
Hanya mengambil repositori yang ditandai sebagai 'configure' untuk tujuan konfigurasi sistem. Hanya berfungsi jika --enable_bzlmod aktif.
Tag:changes_inputs
- Default
--[no]force
: "false" -
Abaikan repositori yang ada jika ada dan paksa ambil repositori lagi. 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:
- Default
--[no]experimental_filter_library_jar_with_program_jar
: "false" -
Memfilter ProgramJar ProGuard untuk menghapus class yang juga ada di LibraryJar.
Tag:action_command_lines
- Default
--[no]experimental_inmemory_dotd_files
: "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
- Default
--[no]experimental_inmemory_jdeps_files
: "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
- Default
--[no]experimental_objc_include_scanning
: "false" -
Apakah akan melakukan pemindaian yang menyertakan C/C++ objektif.
Tag:loading_and_analysis
,execution
,changes_inputs
- Default
--[no]experimental_retain_test_configuration_across_testonly
: "false" -
Jika diaktifkan, --trim_test_configuration tidak akan memangkas konfigurasi pengujian untuk aturan yang ditandai testonly=1. Hal ini dimaksudkan untuk mengurangi masalah konflik tindakan saat aturan non-pengujian bergantung pada aturan cc_test. Tidak berpengaruh jika --trim_test_configuration bernilai salah (false).
Tag:loading_and_analysis
,loses_incremental_state
- Default
--[no]experimental_starlark_cc_import
: "false" -
Jika diaktifkan, cc_import versi Starlark dapat digunakan.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_unsupported_and_brittle_include_scanning
: "false" -
Apakah akan mempersempit input ke kompilasi C/C++ dengan mengurai baris #include dari file input. Hal ini dapat meningkatkan performa dan inkrementalitas dengan mengurangi ukuran hierarki input kompilasi. Namun, hal ini juga dapat merusak build karena pemindai include tidak sepenuhnya menerapkan semantik preprocessor C. Secara khusus, perintah tersebut tidak memahami perintah #include dinamis dan mengabaikan logika kondisional preprocessor. Gunakan dengan menanggung sendiri risikonya. Setiap masalah yang terkait dengan laporan ini yang diajukan akan ditutup.
Tag:loading_and_analysis
,execution
,changes_inputs
- Default
--[no]incremental_dexing
: "true" -
Melakukan sebagian besar pekerjaan untuk dexing secara terpisah untuk setiap file Jar.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--[no]objc_use_dotd_pruning
: "true" -
Jika ditetapkan, file .d yang dikeluarkan oleh clang akan digunakan untuk memangkas kumpulan input yang diteruskan ke kompilasi objc.
Tag:changes_inputs
,loading_and_analysis
- Default
--[no]process_headers_in_dependencies
: "false" -
Saat mem-build target //a:a, proses header di semua target yang menjadi dependensi //a:a (jika pemrosesan header diaktifkan untuk toolchain).
Tag:execution
- Default
--[no]trim_test_configuration
: "true" -
Jika diaktifkan, opsi terkait pengujian akan dihapus di bawah tingkat teratas build. Jika tanda ini aktif, pengujian tidak dapat dibuat sebagai dependensi aturan non-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 tingkat perincian, format, atau lokasi logging:
- Default
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
Mencetak informasi debug selama resolusi toolchain. Flag ini menggunakan ekspresi reguler, yang diperiksa terhadap jenis toolchain dan target tertentu untuk melihat mana yang akan di-debug. Beberapa regex dapat dipisahkan dengan koma, lalu 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 untuk perintah Bazel yang tidak termasuk dalam kategori lain:
--flag_alias=<a 'name=value' flag alias>
beberapa penggunaan diakumulasikan-
Menetapkan nama singkat untuk flag Starlark. Fungsi ini memerlukan satu pasangan nilai kunci dalam bentuk "<key>=<value>" sebagai argumen.
Tag:changes_inputs
- Default
--[no]incompatible_default_to_explicit_init_py
: "false" -
Flag ini mengubah perilaku default sehingga file __init__.py tidak lagi dibuat secara otomatis di runfile target Python. Secara khusus, jika target py_binary atau py_test memiliki legacy_create_init yang ditetapkan ke "auto" (default), target tersebut akan diperlakukan sebagai salah jika dan hanya jika tanda ini ditetapkan. Lihat https://github.com/bazelbuild/bazel/issues/10076.
Tag:affects_outputs
,incompatible_change
- Default
--[no]incompatible_py2_outputs_are_suffixed
: "true" -
Jika benar, target yang di-build dalam konfigurasi Python 2 akan muncul di root output yang menyertakan akhiran '-py2', sedangkan target yang di-build untuk Python 3 akan muncul di root tanpa akhiran terkait Python. Ini berarti bahwa symlink praktis `bazel-bin` akan mengarah ke target Python 3, bukan Python 2. Jika Anda mengaktifkan opsi ini, sebaiknya aktifkan juga `--incompatible_py3_is_default`.
Tag:affects_outputs
,incompatible_change
- Default
--[no]incompatible_py3_is_default
: "true" -
Jika benar, 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 tetapkan juga `--incompatible_py2_outputs_are_suffixed`.
Tag:loading_and_analysis
,affects_outputs
,incompatible_change
- Default
--[no]incompatible_use_python_toolchains
: "true" -
Jika ditetapkan 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
- Default
--python_version=<PY2 or PY3>
: lihat deskripsi -
Mode versi utama Python, baik `PY2` maupun `PY3`. Perhatikan bahwa ini diganti oleh target `py_binary` dan `py_test` (meskipun tidak menentukan versi secara eksplisit) sehingga biasanya tidak ada banyak alasan untuk memberikan tanda ini.
Tag:loading_and_analysis
,affects_outputs
- Opsi lainnya, yang tidak dikategorikan.:
--[no]cache_test_results
[-t
] default: "auto"- 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 yang 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 terlihat di suatu tempat pada jalur paket. Gunakan opsi ini saat menghapus subpaket '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.
- Default
--[no]experimental_cancel_concurrent_tests
: "false" -
Jika benar, Blaze akan membatalkan pengujian yang berjalan secara serentak pada pengujian pertama yang berhasil. Opsi ini hanya berguna jika digunakan bersama --runs_per_test_detects_flakes.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_fetch_all_coverage_outputs
: "false" -
Jika benar, Bazel akan mengambil seluruh direktori data cakupan untuk setiap pengujian selama cakupan dijalankan.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_generate_llvm_lcov
: "false" -
Jika benar, cakupan untuk clang akan menghasilkan laporan LCOV.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_j2objc_header_map
: "true" - Apakah akan membuat peta header J2ObjC secara paralel dengan transpilasi J2ObjC.
- Default
--[no]experimental_j2objc_shorter_header_path
: "false" -
Apakah akan menghasilkan dengan jalur header yang lebih pendek (menggunakan "_ios", bukan "_j2objc").
Tag:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
default: "javabuilder"- Mengaktifkan classpath yang dikurangi untuk kompilasi Java.
- Default
--[no]experimental_limit_android_lint_to_android_constrained_java
: "false" -
Membatasi --experimental_run_android_lint_on_java_rules ke library yang kompatibel dengan Android.
Tag:affects_outputs
- Default
--[no]experimental_run_android_lint_on_java_rules
: "false" -
Apakah akan memvalidasi sumber java_*.
Tag:affects_outputs
- Default
--[no]explicit_java_test_deps
: "false" - Menentukan dependensi ke JUnit atau Hamcrest secara eksplisit dalam java_test, bukan secara tidak sengaja mendapatkannya dari deps TestRunner. Saat ini hanya berfungsi untuk bazel.
- Default
--[no]fetch
: "true" - Mengizinkan perintah mengambil dependensi eksternal. Jika disetel ke salah (false), perintah akan menggunakan versi dependensi yang di-cache, dan jika tidak ada, perintah akan gagal.
- Default
--host_java_launcher=<a build target label>
: lihat deskripsi - Peluncur Java yang digunakan oleh alat yang dieksekusi selama build.
--host_javacopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke javac saat mem-build alat yang dieksekusi selama build.
--host_jvmopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan untuk diteruskan ke VM Java saat membangun alat yang dijalankan selama build. Opsi ini akan ditambahkan ke opsi startup VM setiap target java_binary.
- Default
--[no]incompatible_check_sharding_support
: "true" -
Jika benar, Bazel akan gagal dalam pengujian yang di-shard jika runner pengujian tidak menunjukkan bahwa pengujian tersebut mendukung sharding dengan menyentuh file di jalur di TEST_SHARD_STATUS_FILE. Jika salah, runner pengujian yang tidak mendukung sharding akan menyebabkan semua pengujian berjalan di setiap shard.
Tag:incompatible_change
- Default
--[no]incompatible_exclusive_test_sandboxed
: "true" -
Jika benar, pengujian eksklusif akan berjalan dengan strategi sandbox. Tambahkan tag 'lokal' untuk memaksa pengujian eksklusif secara lokal
Tag:incompatible_change
- Default
--[no]incompatible_strict_action_env
: "false" -
Jika 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, tetapi perhatikan bahwa tindakan ini dapat mencegah penyimpanan dalam 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 yang akan diteruskan ke alat J2ObjC.
--java_debug
-
Menyebabkan mesin virtual Java pada pengujian java menunggu koneksi dari debugger yang mematuhi JDWP (seperti jdb) sebelum memulai pengujian. Menunjukkan -test_output=streamed.
Diluaskan menjadi:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
default: "true"- Buat informasi dependensi (untuk saat ini, classpath waktu kompilasi) per target Java.
- Default
--[no]java_header_compilation
: "true" - Mengompilasi ijar langsung dari sumber.
- Default
--java_language_version=<a string>
: "" - Versi bahasa Java
- Default
--java_launcher=<a build target label>
: lihat deskripsi - Peluncur Java yang akan digunakan saat mem-build biner Java. Jika tanda ini ditetapkan ke string kosong, peluncur JDK akan digunakan. Atribut "launcher" akan mengganti tanda ini.
--java_runtime_version=<a string>
default: "local_jdk"- Versi runtime Java
--javacopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke javac.
--jvmopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke VM Java. Opsi ini akan ditambahkan ke opsi startup VM setiap target java_binary.
- Default
--legacy_main_dex_list_generator=<a build target label>
: lihat deskripsi - Menentukan biner yang akan digunakan untuk membuat daftar class yang harus ada di dex utama saat mengompilasi multidex lama.
- Default
--optimizing_dexer=<a build target label>
: lihat deskripsi - Menentukan biner yang akan digunakan untuk melakukan dexing tanpa sharding.
- Default
--package_path=<colon-separated list of options>
: "%workspace%" - Daftar yang dipisahkan titik dua untuk mencari paket. Elemen yang diawali dengan '%workspace%' bersifat relatif terhadap ruang kerja yang melingkupinya. Jika dihilangkan atau kosong, defaultnya adalah output dari '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.
- Default
--proguard_top=<a build target label>
: lihat deskripsi - Menentukan versi ProGuard yang digunakan untuk penghapusan kode saat mem-build biner Java.
- Default
--proto_compiler=<a build target label>
: "@bazel_tools//tools/proto:protoc" -
Label proto-compiler.
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
- Default
--proto_toolchain_for_j2objc=<a build target label>
: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain" -
Label proto_lang_toolchain() yang menjelaskan cara mengompilasi proto j2objc
Tag:affects_outputs
,loading_and_analysis
- Default
--proto_toolchain_for_java=<a build target label>
: "@bazel_tools//tools/proto:java_toolchain" -
Label proto_lang_toolchain() yang menjelaskan cara mengompilasi proto Java
Tag:affects_outputs
,loading_and_analysis
- Default
--proto_toolchain_for_javalite=<a build target label>
: "@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
- Default
--[no]runs_per_test_detects_flakes
: "false" - Jika benar, setiap shard yang setidaknya memiliki satu operasi/upaya yang berhasil dan setidaknya satu operasi/upaya yang gagal akan mendapatkan status FLAKY.
- Default
--shell_executable=<a path>
: lihat deskripsi -
Jalur absolut ke shell yang dapat dieksekusi untuk digunakan Bazel. Jika tidak ditetapkan, tetapi variabel lingkungan BAZEL_SH ditetapkan pada pemanggilan Bazel pertama (yang memulai server Bazel), Bazel akan menggunakannya. Jika tidak ada yang ditetapkan, Bazel akan menggunakan jalur default hard code bergantung pada sistem operasi tempatnya berjalan (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, semua lainnya: /bin/bash). Perhatikan bahwa penggunaan shell yang tidak kompatibel dengan bash dapat menyebabkan kegagalan build atau kegagalan runtime biner yang dihasilkan.
Tag:loading_and_analysis
- Default
--[no]show_loading_progress
: "true" - Jika diaktifkan, Bazel akan mencetak pesan "Loading package:".
--test_arg=<a string>
beberapa penggunaan diakumulasikan- Menentukan opsi dan argumen tambahan yang harus diteruskan ke file yang dapat dieksekusi pengujian. Dapat digunakan beberapa kali untuk menentukan beberapa argumen. Jika beberapa pengujian dijalankan, setiap pengujian akan menerima argumen yang sama. Hanya digunakan oleh perintah 'bazel test'.
- Default
--test_filter=<a string>
: lihat deskripsi - Menentukan filter untuk diteruskan ke framework pengujian. Digunakan untuk membatasi pengujian yang dijalankan. Perhatikan bahwa hal ini tidak memengaruhi target yang di-build.
- Default
--test_result_expiration=<an integer>
: "-1" - Opsi ini tidak digunakan lagi dan tidak berpengaruh.
- Default
--[no]test_runner_fail_fast
: "false" - Teruskan opsi fail fast ke runner pengujian. Runner pengujian harus menghentikan eksekusi jika terjadi kegagalan pertama.
- Default
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
: "explicit" - Menentukan strategi untuk sharding pengujian: 'eksplisit' agar hanya menggunakan sharding jika atribut BUILD 'shard_count' ada. 'dinonaktifkan' untuk tidak pernah menggunakan sharding pengujian. 'forced=k' untuk menerapkan shard 'k' untuk pengujian, terlepas dari atribut BUILD 'shard_count'.
- Default
--tool_java_language_version=<a string>
: "" - Versi bahasa Java yang digunakan untuk menjalankan alat yang diperlukan selama proses build
- Default
--tool_java_runtime_version=<a string>
: "remotejdk_11" - Versi runtime Java yang digunakan untuk menjalankan alat selama build
- Default
--[no]use_ijars
: "true" - Jika diaktifkan, opsi ini akan menyebabkan kompilasi Java menggunakan jar antarmuka. Hal 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
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika disetel, cache repositori akan melakukan hardlink pada file jika cache ditemukan, bukan menyalinnya. Hal ini dimaksudkan untuk menghemat kapasitas disk.
Tag:bazel_internal_configuration
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi pada komputer yang lebih lambat daripada yang diharapkan oleh penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--[no]incompatible_disable_native_repo_rules
: "false" -
Jika salah, aturan repo native dapat digunakan di WORKSPACE; jika tidak, aturan repo Starlark harus digunakan. Aturan repo native mencakup local_repository, new_local_repository, local_config_platform, android_sdk_repository, dan android_ndk_repository.
Tag:bazel_internal_configuration
- Default
--repository_cache=<a path>
: lihat deskripsi -
Menentukan lokasi cache 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
- Default
--[no]repository_disable_download
: "false" -
Jika disetel, mendownload menggunakan ctx.download{,_and_extract} tidak diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file yang dapat dieksekusi arbitrer 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 dengan masa berlaku yang terisi (0-100) yang di atas batasnya GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika disetel ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi yang terkait dengan output dan semantik 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 jika versi modul tersebut dinyatakan diambil dari registry tempat asalnya (jika tidak berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang ditarik yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Memeriksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasinya ke kegagalan resolusi, `nonaktif` untuk menonaktifkan pemeriksaan, atau `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi.
Tag:loading_and_analysis
- Default
--check_direct_dependencies=<off, warning or error>
: "peringatan" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di modul root adalah versi yang sama dengan yang Anda dapatkan di grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `warning` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasinya ke kegagalan resolusi.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` di MODULE.bazel dari modul root. Perhatikan bahwa dependensi developer tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai tanda ini.
Tag:loading_and_analysis
- Default
--lockfile_mode=<off, update, refresh or error>
: "update" -
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan mengupdatenya jika ada perubahan, `refresh` untuk memuat ulang informasi yang dapat diubah (versi yang ditarik dan modul yang sebelumnya tidak ada) dari registry jarak jauh dari waktu ke waktu, `error` untuk menggunakan file kunci, tetapi menampilkan error jika tidak terbaru, atau `off` untuk tidak membaca dari atau menulis ke file kunci.
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 <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
--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 baru akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
- Default
--vendor_dir=<a path>
: lihat deskripsi -
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalam atau menggunakannya saat mem-build. 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" -
Batasan yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel mengalami error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlahnya adalah bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang dengan masa berlaku (heap gen lama) tetap terisi setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan yang 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC minor terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC minor tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat peristiwa GC minor terjadi dan nilai minimum 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 penggunaan persentase heap yang dipertahankan setidaknya pada batas ini, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan. Dengan menyesuaikan hal ini, Anda dapat mengurangi dampak waktu berjalan dari thrashing GC, jika thrashing GC (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada merekonstruksi status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
- Default
--experimental_command_profile=<cpu, wall, alloc or lock>
: lihat deskripsi - Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alloc, atau lock) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama sesuai jenis peristiwa di direktori dasar output. Sintaksis dan semantik tanda ini mungkin berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; gunakan dengan risiko Anda sendiri.
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemoni dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemoni.
- Default
--help_verbosity=<long, medium or short>
: "medium" -
Pilih panjang perintah bantuan.
Tag:affects_outputs
,terminal_output
--long
[-l
]-
Tampilkan deskripsi lengkap setiap opsi, bukan hanya namanya.
Diperluas menjadi:
--help_verbosity=long
Tag:affects_outputs
,terminal_output
--short
-
Hanya tampilkan nama opsi, bukan jenis atau artinya.
Diperluas menjadi:
--help_verbosity=short
Tag:affects_outputs
,terminal_output
- Opsi yang menentukan atau mengubah input umum ke perintah Bazel yang tidak termasuk dalam kategori lain.:
- Default
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Jika tidak kosong, baca file yang di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan penyimpanan dalam cache jarak jauh:
- Default
--experimental_downloader_config=<a string>
: lihat deskripsi - Menentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali dengan perintah (`allow`, `block`, atau `rewrite`), diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk dicocokkan, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik yang dimulai dari `$1`. Anda dapat memberikan beberapa perintah `rewrite` untuk URL yang sama, dan dalam hal ini beberapa URL akan ditampilkan.
- Default
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dihentikan. Jika tidak, gunakan thread pekerja virtual.
- Opsi lainnya, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
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
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika ditetapkan, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Tindakan ini dimaksudkan untuk menghemat kapasitas disk.
Tag:bazel_internal_configuration
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum percobaan error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--[no]incompatible_disable_native_repo_rules
: "false" -
Jika salah, aturan repo native dapat digunakan di WORKSPACE; jika tidak, aturan repo Starlark harus digunakan. Aturan repo native mencakup local_repository, new_local_repository, local_config_platform, android_sdk_repository, dan android_ndk_repository.
Tag:bazel_internal_configuration
- Default
--repository_cache=<a path>
: lihat deskripsi -
Menentukan lokasi cache 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
- Default
--[no]repository_disable_download
: "false" -
Jika ditetapkan, download menggunakan ctx.download{,_and_extract} tidak diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file yang dapat dieksekusi arbitrer 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 dengan masa berlaku yang terisi (0-100) yang di atas batasnya GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika disetel ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi yang terkait dengan output dan semantik 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 jika versi modul tersebut dinyatakan diambil dari registry tempat asalnya (jika tidak berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang ditarik yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Memeriksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasinya ke kegagalan resolusi, `nonaktif` untuk menonaktifkan pemeriksaan, atau `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi.
Tag:loading_and_analysis
- Default
--check_direct_dependencies=<off, warning or error>
: "peringatan" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di modul root adalah versi yang sama dengan yang Anda dapatkan di grafik dependensi yang di-resolve. Nilai yang valid adalah `nonaktif` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasinya ke kegagalan resolusi.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` di MODULE.bazel dari 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
- Default
--lockfile_mode=<off, update, refresh or error>
: "update" -
Menentukan cara dan apakah kunci file digunakan atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan mengupdatenya jika ada perubahan, `refresh` untuk memuat ulang informasi yang dapat diubah (versi yang ditarik dan modul yang sebelumnya tidak ada) dari registry jarak jauh dari waktu ke waktu, `error` untuk menggunakan file kunci, tetapi menampilkan error jika tidak terbaru, atau `off` untuk tidak membaca dari atau menulis ke file kunci.
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 <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut akan sesuai dengan direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root ruang kerja, yang merupakan output `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutan ini penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
- Default
--vendor_dir=<a path>
: lihat deskripsi -
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalam atau menggunakannya saat mem-build. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
default: "1detik:2,20detik:3,1menit:5"-
Batas yang, jika tercapai, menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan period adalah durasi dan count adalah bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang dengan masa berlaku (heap gen lama) tetap terisi setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC minor terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat peristiwa GC minor terjadi dan nilai minimum 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 penggunaan persentase heap yang dipertahankan setidaknya pada batas ini, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan. Dengan menyesuaikan hal ini, Anda dapat mengurangi dampak waktu berjalan dari thrashing GC, jika thrashing GC (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada merekonstruksi status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
- Default
--experimental_command_profile=<cpu, wall, alloc or lock>
: lihat deskripsi - Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alloc, atau lock) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama sesuai jenis peristiwa di direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah pada masa mendatang untuk mendukung jenis profil atau format output tambahan; gunakan dengan risiko Anda sendiri.
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemoni dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemoni.
- Default
--[no]show_make_env
: "false" -
Sertakan lingkungan "Make" dalam output.
Tag:affects_outputs
,terminal_output
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
- Default
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Jika tidak kosong, baca file yang di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan penyimpanan dalam cache jarak jauh:
- Default
--experimental_downloader_config=<a string>
: lihat deskripsi - Menentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali dengan perintah (`allow`, `block`, atau `rewrite`), diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk dicocokkan, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik yang dimulai dari `$1`. Anda dapat memberikan beberapa perintah `rewrite` untuk URL yang sama, dan dalam hal ini beberapa URL akan ditampilkan.
- Default
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Mode thread yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dihentikan. Jika tidak, gunakan thread pekerja virtual.
- Opsi lainnya, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
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
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika ditetapkan, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Tindakan ini dimaksudkan untuk menghemat kapasitas disk.
Tag:bazel_internal_configuration
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum percobaan error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi pada komputer yang lebih lambat daripada yang diharapkan oleh penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--[no]incompatible_disable_native_repo_rules
: "false" -
Jika salah, aturan repo native dapat digunakan di WORKSPACE; jika tidak, aturan repo Starlark harus digunakan. Aturan repo native mencakup local_repository, new_local_repository, local_config_platform, android_sdk_repository, dan android_ndk_repository.
Tag:bazel_internal_configuration
- Default
--repository_cache=<a path>
: lihat deskripsi -
Menentukan lokasi cache 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
- Default
--[no]repository_disable_download
: "false" -
Jika ditetapkan, download menggunakan ctx.download{,_and_extract} tidak diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file yang dapat dieksekusi arbitrer 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 dengan masa berlaku yang terisi (0-100) yang di atas batasnya GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika disetel ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi yang terkait dengan output dan semantik 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 dideklarasikan dihapus di registry tempatnya berasal (jika tidak 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 menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Memeriksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan saat ketidakcocokan terdeteksi.
Tag:loading_and_analysis
- Default
--check_direct_dependencies=<off, warning or error>
: "peringatan" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan dalam modul root adalah versi yang sama dengan yang Anda dapatkan dalam grafik dependensi di-resolve. Nilai yang valid adalah `nonaktif` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasinya ke kegagalan resolusi.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` di MODULE.bazel dari modul root. Perhatikan bahwa dependensi developer tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai tanda ini.
Tag:loading_and_analysis
- Default
--lockfile_mode=<off, update, refresh or error>
: "update" -
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `refresh` untuk memperbarui informasi yang dapat diubah (versi yang ditarik dan modul yang sebelumnya tidak ada) dari registry jarak jauh dari waktu ke waktu, `error` untuk menggunakan lockfile, tetapi menampilkan error jika tidak diperbarui, atau `off` untuk tidak membaca dari 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 <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut akan sesuai dengan direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutan ini penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
- Default
--vendor_dir=<a path>
: lihat deskripsi -
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalam atau menggunakannya saat mem-build. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
default: "1detik:2,20detik:3,1menit:5"-
Batas yang, jika tercapai, menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan period adalah durasi dan count adalah bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang dengan masa berlaku (heap gen lama) tetap terisi setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas tersebut tercapai, status Skyframe tidak akan lagi diturunkan saat 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 diperlukan akan dihapus hingga berkali-kali per panggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC minor tidak akan pernah memicu penurunan. Jika batas tersebut tercapai, status Skyframe tidak akan lagi diturunkan 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 penggunaan persentase heap yang dipertahankan setidaknya pada batas ini, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan. Dengan menyesuaikan hal ini, Anda dapat mengurangi dampak waktu berjalan dari thrashing GC, jika thrashing GC (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada merekonstruksi status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
- Default
--experimental_command_profile=<cpu, wall, alloc or lock>
: lihat deskripsi - Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alloc, atau lock) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa pada direktori basis output. Sintaksis dan semantik tanda ini dapat berubah pada masa mendatang untuk mendukung jenis profil atau format output tambahan; gunakan dengan risiko Anda sendiri.
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemoni dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemoni.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
- Default
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Jika tidak kosong, baca file yang di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan penyimpanan dalam cache jarak jauh:
- Default
--experimental_downloader_config=<a string>
: lihat deskripsi - Menentukan file yang akan dikonfigurasi dengan downloader jarak jauh. File ini terdiri dari baris-baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti oleh nama host (untuk `izinkan` dan `block`) atau dua pola, satu untuk dicocokkan, dan satu lagi untuk digunakan sebagai URL pengganti, dengan referensi kembali mulai dari `$1`. Ada kemungkinan beberapa perintah `rewrite` untuk URL yang sama akan diberikan, dan dalam hal ini beberapa URL akan diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
- Default
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "otomatis" - Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dihentikan. Jika tidak, gunakan thread pekerja virtual.
- Opsi lainnya, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
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
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika disetel, cache repositori akan melakukan hardlink pada file jika cache ditemukan, bukan menyalinnya. Tindakan ini dimaksudkan untuk menghemat kapasitas disk.
Tag:bazel_internal_configuration
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum percobaan error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--[no]incompatible_disable_native_repo_rules
: "false" -
Jika salah, aturan repo native dapat digunakan di WORKSPACE; jika tidak, aturan repo Starlark harus digunakan. Aturan repo native mencakup local_repository, new_local_repository, local_config_platform, android_sdk_repository, dan android_ndk_repository.
Tag:bazel_internal_configuration
- Default
--repository_cache=<a path>
: lihat deskripsi -
Menentukan lokasi cache 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
- Default
--[no]repository_disable_download
: "false" -
Jika disetel, mendownload menggunakan ctx.download{,_and_extract} tidak diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file yang dapat dieksekusi arbitrer 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 dengan masa berlaku yang terisi (0-100) yang di atas batasnya GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika disetel ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Default
--mode=<classic, classic_internal_test_do_not_use or skylark>
: "classic" -
Pilih cara menjalankan penginstalan seluler. "klasik" menjalankan versi instal 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:
- Default
--adb=<a string>
: ""
Biner adb -
yang akan digunakan untuk perintah 'mobile-install'. Jika tidak ditentukan, parameter di Android SDK yang ditentukan oleh opsi command line --android_sdk (atau SDK default jika --android_sdk tidak ditentukan) digunakan.
Tag:changes_inputs
- Opsi yang mengontrol output perintah:
- Default
--[no]incremental
: "false" -
Apakah akan melakukan penginstalan inkremental. Jika benar, cobalah untuk menghindari pekerjaan tambahan yang tidak perlu dengan membaca status perangkat tempat kode akan diinstal dan menggunakan informasi tersebut untuk menghindari pekerjaan yang tidak perlu. Jika salah (default), selalu lakukan penginstalan penuh.
Tag:loading_and_analysis
- Default
--[no]split_apks
: "false" -
Apakah akan menggunakan apk terpisah untuk menginstal dan mengupdate aplikasi di perangkat. Hanya berfungsi dengan perangkat yang menjalankan Marshmallow atau yang lebih baru
Tag:loading_and_analysis
,affects_outputs
- Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, yang memengaruhi nilainya, bukan keberadaannya:
--adb_arg=<a string>
beberapa penggunaan diakumulasikan-
Argumen tambahan untuk diteruskan ke adb. Biasanya digunakan untuk menentukan perangkat tempat penginstalan akan dilakukan.
Tag:action_command_lines
--debug_app
-
Apakah perlu menunggu debugger sebelum memulai aplikasi.
Diperluas ke:
--start=DEBUG
Tag:execution
- Default
--device=<a string>
: "" -
Nomor seri perangkat adb. Jika tidak ditentukan, perangkat pertama akan digunakan.
Tag:action_command_lines
- Default
--start=<no, cold, warm or debug>
: "NO" -
Bagaimana aplikasi harus dimulai setelah menginstalnya. Tetapkan ke WARM untuk mempertahankan dan memulihkan status aplikasi pada penginstalan inkremental.
Tag:execution
--start_app
-
Apakah akan memulai aplikasi setelah menginstalnya.
Diperluas menjadi:
--start=COLD
Tag:execution
- Opsi yang terkait dengan output dan semantik 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 dideklarasikan dihapus di registry tempatnya berasal (jika tidak berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang ditarik yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel dari modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan saat ketidakcocokan terdeteksi.
Tag:loading_and_analysis
- Default
--check_direct_dependencies=<off, warning or error>
: "peringatan" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di modul root adalah versi yang sama dengan yang Anda dapatkan di grafik dependensi yang di-resolve. Nilai yang valid adalah `nonaktif` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasinya ke kegagalan resolusi.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` di MODULE.bazel dari 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
- Default
--lockfile_mode=<off, update, refresh or error>
: "update" -
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan mengupdatenya jika ada perubahan, `refresh` untuk memuat ulang informasi yang dapat diubah (versi yang ditarik dan modul yang sebelumnya tidak ada) dari registry jarak jauh dari waktu ke waktu, `error` untuk menggunakan file kunci, tetapi menampilkan error jika tidak terbaru, atau `off` untuk tidak membaca dari atau menulis ke file kunci.
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 <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut akan sesuai dengan direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutan ini penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
- Default
--vendor_dir=<a path>
: lihat deskripsi -
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalam atau menggunakannya saat mem-build. 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, menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan period adalah durasi dan count adalah bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap gen lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dengan dipisahkan 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC minor terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC minor tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat peristiwa GC minor terjadi dan nilai minimum 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 penggunaan persentase heap yang dipertahankan setidaknya pada batas ini, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan. Dengan menyesuaikan hal ini, Anda dapat mengurangi dampak waktu berjalan dari thrashing GC, jika thrashing GC (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada merekonstruksi status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
- Default
--experimental_command_profile=<cpu, wall, alloc or lock>
: lihat deskripsi - Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alloc, atau lock) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama sesuai jenis peristiwa di direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah pada masa mendatang untuk mendukung jenis profil atau format output tambahan; gunakan dengan risiko Anda sendiri.
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan dieksekusi terbanyak. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
- Default
--incremental_install_verbosity=<a string>
: "" -
Verbositas untuk penginstalan inkremental. Setel ke 1 untuk logging debug.
Tag:bazel_monitoring
- Opsi yang menentukan atau mengubah input umum ke perintah Bazel yang tidak termasuk dalam kategori lain.:
- Default
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Jika tidak kosong, baca file yang di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan penyimpanan dalam cache jarak jauh:
- Default
--experimental_downloader_config=<a string>
: lihat deskripsi - Menentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris-baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti oleh nama host (untuk `izinkan` dan `block`) atau dua pola, satu untuk dicocokkan, dan satu lagi untuk digunakan sebagai URL pengganti, dengan referensi kembali mulai dari `$1`. Ada kemungkinan beberapa perintah `rewrite` untuk URL yang sama akan diberikan, dan dalam hal ini beberapa URL akan diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
- Default
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'off', tidak ada thread pekerja yang akan digunakan, dan pengambilan repo dapat dimulai ulang. Jika tidak, gunakan thread pekerja virtual.
- Opsi lainnya, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root ruang kerja, yang merupakan output `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
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
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika disetel, cache repositori akan melakukan hardlink pada file jika cache ditemukan, bukan menyalinnya. Tindakan ini dimaksudkan untuk menghemat kapasitas disk.
Tag:bazel_internal_configuration
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi pada komputer yang lebih lambat daripada yang diharapkan oleh penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--[no]incompatible_disable_native_repo_rules
: "false" -
Jika salah, aturan repo native dapat digunakan di WORKSPACE; jika tidak, aturan repo Starlark harus digunakan. Aturan repo native mencakup local_repository, new_local_repository, local_config_platform, android_sdk_repository, dan android_ndk_repository.
Tag:bazel_internal_configuration
- Default
--repository_cache=<a path>
: lihat deskripsi -
Menentukan lokasi cache 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
- Default
--[no]repository_disable_download
: "false" -
Jika disetel, mendownload menggunakan ctx.download{,_and_extract} tidak diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file yang dapat dieksekusi arbitrer 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 dengan masa berlaku yang terisi (0-100) yang di atas batasnya GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika disetel ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
--[no]keep_going
[-k
] default: "false"-
Lanjutkan sebanyak mungkin setelah terjadi error. Meskipun target yang gagal dan target yang bergantung padanya tidak dapat dianalisis, prasyarat lain dari target ini dapat dianalisis.
Tag:eagerness_to_exit
- Default
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Jumlah thread paralel yang akan digunakan untuk fase pemuatan/analisis.Mengambil bilangan bulat, atau kata kunci ("auto", "HOST_CPUS", "HOST_RAM"), secara opsional diikuti dengan operasi ([-|*]<float>) misalnya. "auto", "HOST_CPUS*.5". "auto" menetapkan setelan default yang wajar berdasarkan resource host. Minimal harus 1.
Tag:bazel_internal_configuration
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
- Default
--[no]incompatible_config_setting_private_default_visibility
: "false" -
Jika incompatible_enforce_config_setting_visibility=false, ini adalah noop. Atau, jika tanda ini salah, config_setting apa pun tanpa atribut visibilitas eksplisit adalah //visibility:public. Jika tanda ini benar, config_setting akan 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_enforce_config_setting_visibility
default: "true"-
Jika true (benar), terapkan batasan visibilitas config_setting. Jika salah, setiap config_setting akan terlihat oleh setiap target. Lihat https://github.com/bazelbuild/bazel/issues/12932.
Tag:loading_and_analysis
,incompatible_change
- Opsi yang terkait dengan output dan semantik subperintah `mod`:
- Default
--base_module=<"<root>" for the root module; <module>@<version> for a specific version of a module; <module> for all versions of a module; @<name> for a repo with the given apparent name; or @@<name> for a repo with the given canonical name>
: "<root>" -
Menentukan modul yang akan digunakan untuk menafsirkan repo target yang ditentukan.
Tag:terminal_output
- Default
--charset=<utf8 or ascii>
: "utf8" -
Memilih kumpulan karakter yang akan digunakan untuk hierarki. Hanya memengaruhi output teks. Nilai yang valid adalah "utf8" atau "ascii". Defaultnya adalah "utf8"
Tag:terminal_output
- Default
--[no]cycles
: "false" -
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. Kedalaman 1 menampilkan dependensi langsung, misalnya. Untuk hierarki, path, dan all_paths, defaultnya adalah Integer.MAX_VALUE, sedangkan untuk dependensi dan penjelasan, nilainya adalah 1 (hanya menampilkan dependensi langsung root selain daun target dan induknya).
Tag:terminal_output
- Default
--extension_filter=<a comma-separated list of <extension>s>
: lihat deskripsi -
Hanya menampilkan penggunaan ekstensi modul ini dan repo yang dihasilkan olehnya jika flag masing-masing ditetapkan. Jika ditetapkan, grafik hasil hanya akan menyertakan jalur yang berisi modul yang menggunakan ekstensi yang ditentukan. Daftar kosong akan menonaktifkan filter, sehingga secara efektif menentukan semua kemungkinan ekstensi.
Tag:terminal_output
--extension_info=<hidden, usages, repos or all>
default: "tersembunyi"-
Menentukan seberapa banyak detail tentang penggunaan ekstensi yang akan disertakan dalam hasil kueri. "Penggunaan" hanya akan menampilkan nama ekstensi, "repo" juga akan menyertakan repo yang diimpor dengan use_repo, dan "semua" juga akan menampilkan repositori lain yang dihasilkan oleh ekstensi.
Tag:terminal_output
- Default
--extension_usages=<a comma-separated list of <module>s>
: "" -
Menentukan modul yang penggunaan ekstensi-nya akan ditampilkan dalam kueri show_extension.
Tag:terminal_output
- Default
--from=<a comma-separated list of <module>s>
: "<root>" -
Modul tempat kueri grafik dependensi akan ditampilkan. Periksa deskripsi setiap kueri untuk mengetahui semantik yang tepat. Default-nya adalah <root>.
Tag:terminal_output
- Default
--[no]include_builtin
: "false" -
Sertakan modul bawaan dalam grafik dependensi. Dinonaktifkan secara default karena cukup berisik.
Tag:terminal_output
- Default
--[no]include_unused
: "false" -
Kueri juga akan mempertimbangkan dan menampilkan modul yang tidak digunakan, yang tidak ada dalam grafik resolusi modul setelah pemilihan (karena aturan Penggantian atau Pemilihan Versi Minimal). Cara ini bisa memiliki efek yang berbeda untuk setiap jenis kueri, yaitu menyertakan jalur baru dalam perintah all_paths, atau tambahan dependensi dalam perintah explain.
Tag:terminal_output
- Default
--output=<text, json or graph>
: "text" -
Format pencetakan hasil kueri. Nilai yang diizinkan untuk kueri adalah: text, json, graph
Tag:terminal_output
- Default
--[no]verbose
: "false" -
Kueri juga akan menampilkan alasan modul di-resolve ke versi saat ini (jika diubah). Nilai defaultnya adalah true (benar) hanya untuk kueri explain.
Tag:terminal_output
- Opsi yang terkait dengan output dan semantik 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 jika versi modul tersebut dinyatakan diambil dari registry tempat asalnya (jika tidak 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 menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel dari modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasinya ke kegagalan resolusi, `nonaktif` untuk menonaktifkan pemeriksaan, atau `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi.
Tag:loading_and_analysis
- Default
--check_direct_dependencies=<off, warning or error>
: "peringatan" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di modul root adalah versi yang sama dengan yang Anda dapatkan di grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `warning` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasinya ke kegagalan resolusi.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` di MODULE.bazel dari 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
- Default
--lockfile_mode=<off, update, refresh or error>
: "update" -
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan mengupdatenya jika ada perubahan, `refresh` untuk memuat ulang informasi yang dapat diubah (versi yang ditarik dan modul yang sebelumnya tidak ada) dari registry jarak jauh dari waktu ke waktu, `error` untuk menggunakan file kunci, tetapi menampilkan error jika tidak terbaru, atau `off` untuk tidak membaca dari atau menulis ke file kunci.
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 <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut akan sesuai dengan direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutan ini penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
- Default
--vendor_dir=<a path>
: lihat deskripsi -
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalam atau menggunakannya saat mem-build. 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, menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan period adalah durasi dan count adalah bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang dengan masa berlaku (heap gen lama) tetap terisi setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan yang 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC minor terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC minor tidak akan pernah memicu penurunan. Jika batas tersebut tercapai, status Skyframe tidak akan lagi diturunkan 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 persentase heap yang dipertahankannya setidaknya mencapai nilai minimum ini, status Skyframe sementara yang tidak diperlukan akan dihapus. Menyesuaikan nilai ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari thrashing GC, ketika thrashing GC (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
--experimental_command_profile=<cpu, wall, alloc or lock>
: lihat deskripsi - Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alloc, atau lock) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama sesuai jenis peristiwa di direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah pada masa mendatang untuk mendukung jenis profil atau format output tambahan; gunakan dengan risiko Anda sendiri.
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemoni dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemoni.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
- Default
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Jika tidak kosong, baca file yang di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan penyimpanan dalam cache jarak jauh:
- Default
--experimental_downloader_config=<a string>
: lihat deskripsi - Menentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris-baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti oleh nama host (untuk `izinkan` dan `block`) atau dua pola, satu untuk dicocokkan, dan satu lagi untuk digunakan sebagai URL pengganti, dengan referensi kembali mulai dari `$1`. Ada kemungkinan beberapa perintah `rewrite` untuk URL yang sama akan diberikan, dan dalam hal ini beberapa URL akan diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
- Default
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Mode thread yang akan digunakan untuk pengambilan repo. Jika disetel ke 'off', tidak ada thread pekerja yang akan digunakan, dan pengambilan repo dapat dimulai ulang. Jika tidak, gunakan thread pekerja virtual.
- 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 terlihat di suatu tempat pada jalur paket. Gunakan opsi ini saat menghapus subpaket '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 masih disediakan oleh entri package_path lain. Menentukan --deleted_packages x/y akan menghindari masalah ini.
- Default
--[no]fetch
: "true" - Mengizinkan perintah mengambil dependensi eksternal. Jika kebijakan disetel ke salah (false), perintah akan menggunakan versi dependensi yang di-cache, dan jika tidak ada, perintah akan mengakibatkan kegagalan.
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
- Default
--package_path=<colon-separated list of options>
: "%workspace%" - Daftar yang dipisahkan titik dua untuk mencari paket. Elemen yang diawali dengan '%workspace%' bersifat relatif terhadap ruang kerja yang melingkupinya. Jika dihilangkan atau kosong, defaultnya adalah output dari 'bazel info default-package-path'.
- Default
--[no]show_loading_progress
: "true" - Jika diaktifkan, akan menyebabkan Bazel mencetak pesan "Loading package:".
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
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika disetel, cache repositori akan melakukan hardlink pada file jika cache ditemukan, bukan menyalinnya. Tindakan ini dimaksudkan untuk menghemat kapasitas disk.
Tag:bazel_internal_configuration
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--[no]incompatible_disable_native_repo_rules
: "false" -
Jika salah, aturan repo native dapat digunakan di WORKSPACE; jika tidak, aturan repo Starlark harus digunakan. Aturan repo native mencakup local_repository, new_local_repository, local_config_platform, android_sdk_repository, dan android_ndk_repository.
Tag:bazel_internal_configuration
- Default
--repository_cache=<a path>
: lihat deskripsi -
Menentukan lokasi cache 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
- Default
--[no]repository_disable_download
: "false" -
Jika ditetapkan, download menggunakan ctx.download{,_and_extract} tidak diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file yang dapat dieksekusi arbitrer 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 dengan masa berlaku yang terisi (0-100) yang di atas batasnya GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika disetel ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi yang terkait dengan output dan semantik 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 dideklarasikan dihapus di registry tempatnya berasal (jika tidak berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang ditarik yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'semua' (tidak disarankan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Memeriksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasinya ke kegagalan resolusi, `nonaktif` untuk menonaktifkan pemeriksaan, atau `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi.
Tag:loading_and_analysis
- Default
--check_direct_dependencies=<off, warning or error>
: "peringatan" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di modul root adalah versi yang sama dengan yang Anda dapatkan di grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `warning` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasinya ke kegagalan resolusi.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` di MODULE.bazel dari 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
- Default
--lockfile_mode=<off, update, refresh or error>
: "update" -
Menentukan cara dan apakah kunci file digunakan atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `refresh` untuk memperbarui informasi yang dapat diubah (versi yang ditarik dan modul yang sebelumnya tidak ada) dari registry jarak jauh dari waktu ke waktu, `error` untuk menggunakan lockfile, tetapi menampilkan error jika tidak diperbarui, atau `off` untuk tidak membaca dari 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 <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
--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 baru akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
- Default
--vendor_dir=<a path>
: lihat deskripsi -
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat mem-build. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
default: "1detik:2,20detik:3,1menit:5"-
Batasan yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel mengalami error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan period adalah durasi dan count adalah bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap gen lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan yang 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC minor terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC minor tidak akan pernah memicu penurunan. Jika batas tersebut tercapai, status Skyframe tidak akan lagi diturunkan 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 penggunaan persentase heap yang dipertahankan setidaknya pada batas ini, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan. Dengan menyesuaikan hal ini, Anda dapat mengurangi dampak waktu berjalan dari thrashing GC, jika thrashing GC (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada merekonstruksi status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
- Default
--experimental_command_profile=<cpu, wall, alloc or lock>
: lihat deskripsi - Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alloc, atau lock) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama sesuai jenis peristiwa di direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah pada masa mendatang untuk mendukung jenis profil atau format output tambahan; gunakan dengan risiko Anda sendiri.
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemoni dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemoni.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
- Default
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Jika tidak kosong, baca file yang di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan penyimpanan dalam cache jarak jauh:
- Default
--experimental_downloader_config=<a string>
: lihat deskripsi - Menentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali dengan perintah (`allow`, `block`, atau `rewrite`), diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk dicocokkan, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik yang dimulai dari `$1`. Anda dapat memberikan beberapa perintah `rewrite` untuk URL yang sama, dan dalam hal ini beberapa URL akan ditampilkan.
- Default
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Mode thread yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dihentikan. Jika tidak, thread pekerja virtual akan digunakan.
- Opsi lainnya, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
--print_action_mnemonics=<a string>
beberapa penggunaan diakumulasikan- Mencantumkan mnemonik yang digunakan untuk memfilter data print_action, tidak akan terjadi pemfilteran 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
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika ditetapkan, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Tindakan ini dimaksudkan untuk menghemat kapasitas disk.
Tag:bazel_internal_configuration
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi pada komputer yang lebih lambat daripada yang diharapkan oleh penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--[no]incompatible_disable_native_repo_rules
: "false" -
Jika salah, aturan repo native dapat digunakan di WORKSPACE; jika tidak, aturan repo Starlark harus digunakan. Aturan repo native mencakup local_repository, new_local_repository, local_config_platform, android_sdk_repository, dan android_ndk_repository.
Tag:bazel_internal_configuration
- Default
--repository_cache=<a path>
: lihat deskripsi -
Menentukan lokasi cache 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
- Default
--[no]repository_disable_download
: "false" -
Jika ditetapkan, download menggunakan ctx.download{,_and_extract} tidak diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file yang dapat dieksekusi arbitrer 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 dengan masa berlaku yang terisi (0-100) yang di atas batasnya GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika disetel ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
--[no]keep_going
[-k
] default: "false"-
Lanjutkan sebanyak mungkin setelah terjadi error. Meskipun target yang gagal dan target yang bergantung padanya tidak dapat dianalisis, prasyarat lain dari target ini dapat dianalisis.
Tag:eagerness_to_exit
- Default
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Jumlah thread paralel yang akan digunakan untuk fase pemuatan/analisis.Mengambil bilangan bulat, atau kata kunci ("auto", "HOST_CPUS", "HOST_RAM"), secara opsional diikuti dengan operasi ([-|*]<float>) misalnya. "auto", "HOST_CPUS*.5". "auto" menetapkan default yang wajar berdasarkan resource host. Minimal harus 1.
Tag:bazel_internal_configuration
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
- Default
--[no]incompatible_config_setting_private_default_visibility
: "false" -
Jika incompatible_enforce_config_setting_visibility=false, ini adalah noop. Atau, jika tanda ini salah, config_setting apa pun tanpa atribut visibilitas eksplisit adalah //visibility:public. Jika tanda ini benar, config_setting akan mengikuti logika visibilitas yang sama seperti semua aturan lainnya. Lihat https://github.com/bazelbuild/bazel/issues/12933.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_enforce_config_setting_visibility
: "true" -
Jika benar, terapkan batasan visibilitas config_setting. Jika salah, setiap config_setting akan terlihat oleh setiap target. Lihat https://github.com/bazelbuild/bazel/issues/12932.
Tag:loading_and_analysis
,incompatible_change
- Opsi yang terkait dengan output kueri dan semantik:
- Default
--aspect_deps=<off, conservative or precise>
: "konservatif" -
Cara me-resolve dependensi aspek saat 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 ditambahkan terlepas dari apakah dependensi tersebut diberi class aturan dependensi langsung, 'precise' berarti hanya aspek tersebut yang ditambahkan yang mungkin aktif mengingat class aturan dependensi langsung. Perhatikan bahwa mode presisi memerlukan pemuatan paket lain untuk mengevaluasi satu target sehingga membuatnya lebih lambat daripada mode lainnya. Perhatikan juga bahwa mode presisi pun tidak sepenuhnya presisi: keputusan apakah akan menghitung aspek atau tidak diputuskan dalam fase analisis, yang tidak dijalankan selama 'kueri bazel'.
Tag:build_file_semantics
- Default
--[no]consistent_labels
: "false" -
Jika diaktifkan, setiap perintah kueri akan menampilkan label seolah-olah oleh fungsi Starlark <code>str</code> yang diterapkan ke instance <code>Label</code>. Hal ini berguna untuk alat yang perlu mencocokkan output dari berbagai perintah kueri dan/atau label yang dikeluarkan oleh aturan. Jika tidak diaktifkan, pemformat output bebas memunculkan nama repositori yang jelas (relatif terhadap repositori utama), sehingga membuat output lebih mudah dibaca.
Tag:terminal_output
- Default
--[no]experimental_explicit_aspects
: "false" -
aquery, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: no-op (aspek selalu diikuti).
Tag:terminal_output
- Default
--[no]experimental_graphless_query
: "otomatis" -
Jika true (benar), penerapan Kueri yang tidak membuat salinan grafik akan digunakan. Implementasi baru hanya mendukung --order_output=no, serta hanya sebagian dari 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 topologi akan digabungkan dan labelnya 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 terpotong; -1 berarti tidak ada pemotongan. Opsi ini hanya berlaku untuk --output=graph.
Tag:terminal_output
- Default
--[no]implicit_deps
: "true" -
Jika diaktifkan, dependensi implisit akan disertakan dalam grafik dependensi tempat kueri beroperasi. Dependensi implisit adalah dependensi yang tidak ditentukan secara eksplisit dalam file BUILD, tetapi ditambahkan oleh bazel. Untuk kueri, opsi ini mengontrol pemfilteran toolchain yang telah di-resolve.
Tag:build_file_semantics
- Default
--[no]include_aspects
: "true" -
aquery, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: no-op (aspek selalu diikuti).
Tag:terminal_output
- Default
--[no]incompatible_lexicographical_output
: "true" -
Jika opsi ini ditetapkan, urutkan output --order_output=auto dalam urutan leksikografis.
Tag:terminal_output
,incompatible_change
- Default
--[no]incompatible_package_group_includes_double_slash
: "true" -
Jika diaktifkan, saat menampilkan atribut `packages` package_group, `//` di awal tidak akan dihilangkan.
Tag:terminal_output
,incompatible_change
- Default
--[no]infer_universe_scope
: "false" -
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 Anda hanya boleh menggunakan opsi ini 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` (yaitu bukan `cquery`).
Tag:loading_and_analysis
- Default
--[no]line_terminator_null
: "false" -
Apakah setiap format diakhiri dengan \0, bukan baris baru.
Tag:terminal_output
- Default
--[no]nodep_deps
: "true" -
Jika diaktifkan, dependensi dari atribut "nodep" akan disertakan dalam grafik dependensi tempat kueri beroperasi. 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
-
Menghasilkan output dalam urutan dependensi (default) atau tidak teratur. Output yang tidak diurutkan lebih cepat, tetapi hanya didukung jika --output bukan minrank, maxrank, atau graph.
Diperluas menjadi:
--order_output=no
Tag:terminal_output
--null
-
Apakah setiap format diakhiri dengan \0, bukan baris baru.
Diperluas menjadi:
--line_terminator_null=true
Tag:terminal_output
- Default
--order_output=<no, deps, auto or full>
: "auto" -
Menampilkan hasil tanpa urutan (no), urutan dependensi (deps), atau urutan penuh (full). Defaultnya adalah 'auto', yang berarti hasil akan menghasilkan urutan dependensi atau urutan lengkap, bergantung pada pemformat output (urutan dependensi untuk proto, minrank, maxrank, dan grafik, urutan lengkap untuk semua yang lain). Jika output sepenuhnya diurutkan, node akan dicetak dalam urutan (total) yang sepenuhnya deterministik. Pertama, semua node diurutkan menurut abjad. Kemudian, setiap node dalam daftar digunakan sebagai awal penelusuran depth-first post-order, yaitu ketika tepi keluar ke node yang belum dikunjungi dilalui dalam urutan abjad node pengganti. Terakhir, node dicetak berbalik urutan kunjungannya.
Tag:terminal_output
--order_results
-
Menampilkan hasil dalam urutan dependensi (default) atau tidak berurutan. Output yang tidak berurutan lebih cepat tetapi hanya didukung jika --output bukan minrank, maxrank, atau grafik.
Diluaskan ke:
--order_output=auto
Tag:terminal_output
- Default
--output=<a string>
: "label" -
Format pencetakan hasil kueri. Nilai yang diizinkan untuk kueri adalah: build, graph, streamed_jsonproto, label, label_kind, location, maxrank, minrank, package, proto, streamed_proto, textproto, xml.
Tag:terminal_output
--[no]proto:default_values
default: "true"-
Jika benar, atribut yang nilainya tidak ditentukan secara eksplisit dalam file BUILD akan disertakan; jika tidak, atribut akan dihilangkan. Opsi ini berlaku untuk --output=proto
Tag:terminal_output
- Default
--[no]proto:definition_stack
: "false" -
Isi kolom proto definition_stack, yang mencatat untuk 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 diratakan adalah daftar yang berisi setiap nilai peta yang dipilih tepat sekali. Jenis skalar diratakan menjadi null.
Tag:build_file_semantics
- Default
--[no]proto:include_attribute_source_aspects
: "false" -
Isi kolom proto source_aspect_name dari setiap Atribut dengan aspek sumber asal atribut (string kosong jika tidak ada).
Tag:terminal_output
- Default
--[no]proto:include_synthetic_attribute_hash
: "false" -
Apakah akan menghitung dan mengisi atribut $internal_attr_hash atau tidak.
Tag:terminal_output
- Default
--[no]proto:instantiation_stack
: "false" -
Isi stack panggilan pembuatan instance dari setiap aturan. Perhatikan bahwa hal ini memerlukan stack untuk ada
Tag:terminal_output
- Default
--[no]proto:locations
: "true" -
Apakah akan menampilkan informasi lokasi dalam output proto atau tidak.
Tag:terminal_output
- Default
--proto:output_rule_attrs=<comma-separated list of options>
: "semua" -
Daftar atribut yang dipisahkan koma untuk disertakan dalam output. Setelan defaultnya adalah semua atribut. Tetapkan ke string kosong agar tidak menampilkan atribut apa pun. Opsi ini berlaku untuk --output=proto.
Tag:terminal_output
- Default
--[no]proto:rule_inputs_and_outputs
: "true" -
Apakah akan mengisi kolom rule_input dan rule_output atau tidak.
Tag:terminal_output
- Default
--query_file=<a string>
: "" -
Jika ditetapkan, kueri akan membaca kueri dari file yang diberi nama di sini, bukan di command line. Menentukan file di sini serta kueri command line akan menyebabkan error.
Tag:changes_inputs
- Default
--[no]relative_locations
: "false" -
Jika 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 komputer. Anda dapat menetapkan opsi ini ke true untuk mendapatkan hasil yang konsisten di seluruh komputer.
Tag:terminal_output
- Default
--[no]strict_test_suite
: "false" -
Jika benar, ekspresi tests() akan menampilkan error jika menemukan test_suite yang berisi target non-pengujian.
Tag:build_file_semantics
,eagerness_to_exit
- Default
--[no]tool_deps
: "true" -
Kueri: Jika dinonaktifkan, dependensi pada 'konfigurasi exec' tidak akan disertakan dalam grafik dependensi tempat kueri beroperasi. Tepi dependensi 'konfigurasi exec', seperti yang berasal dari aturan 'proto_library' ke Compiler Protokol, biasanya mengarah ke alat yang dieksekusi selama build, bukan bagian dari program 'target' yang sama.
Cquery: Jika dinonaktifkan, memfilter semua target yang dikonfigurasi dan melewati transisi eksekusi dari target level teratas yang menemukan target yang dikonfigurasi ini. Artinya, jika target tingkat atas berada dalam konfigurasi target, hanya target yang dikonfigurasi juga dalam konfigurasi target yang akan ditampilkan. Jika target tingkat teratas berada dalam konfigurasi exec, hanya target yang dikonfigurasi exec yang akan ditampilkan. Opsi ini TIDAK akan mengecualikan toolchain yang telah di-resolve.
Tag:build_file_semantics
- Default
--universe_scope=<comma-separated list of options>
: "" -
Kumpulan pola target yang dipisahkan koma (aditif dan subtraktif). Kueri dapat dilakukan di alam semesta yang ditentukan oleh penutupan transitif target yang ditentukan. Opsi ini digunakan untuk perintah kueri dan cquery.
Untuk cquery, input ke opsi ini adalah target tempat semua jawaban dibuat, sehingga opsi ini dapat memengaruhi konfigurasi dan transisi. Jika opsi ini tidak ditentukan, target tingkat atas diasumsikan sebagai target yang diuraikan dari ekspresi kueri. Catatan: Untuk cquery, tidak menetapkan opsi ini dapat menyebabkan build rusak jika target yang diuraikan dari ekspresi kueri tidak dapat dibangun dengan opsi tingkat atas.
Tag:loading_and_analysis
- Default
--[no]xml:default_values
: "false" -
Jika benar, atribut aturan yang nilainya tidak ditentukan secara eksplisit dalam file BUILD akan dicetak; jika tidak, atribut tersebut akan dihilangkan.
Tag:terminal_output
- Default
--[no]xml:line_numbers
: "true" -
Jika benar, output XML akan 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 output dan semantik 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 dideklarasikan dihapus di registry tempatnya berasal (jika tidak berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan kegagalan resolusi. Anda juga dapat menentukan versi yang ditarik yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Memeriksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasinya ke kegagalan resolusi, `nonaktif` untuk menonaktifkan pemeriksaan, atau `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi.
Tag:loading_and_analysis
- Default
--check_direct_dependencies=<off, warning or error>
: "peringatan" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di modul root adalah versi yang sama dengan yang Anda dapatkan di grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `warning` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasinya ke kegagalan resolusi.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` di MODULE.bazel dari 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
- Default
--lockfile_mode=<off, update, refresh or error>
: "update" -
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan mengupdatenya jika ada perubahan, `refresh` untuk memuat ulang informasi yang dapat diubah (versi yang ditarik dan modul yang sebelumnya tidak ada) dari registry jarak jauh dari waktu ke waktu, `error` untuk menggunakan file kunci, tetapi menampilkan error jika tidak terbaru, atau `off` untuk tidak membaca dari atau menulis ke file kunci.
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 <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut akan sesuai dengan direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
--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 baru akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
- Default
--vendor_dir=<a path>
: lihat deskripsi -
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalam atau menggunakannya saat mem-build. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
default: "1detik:2,20detik:3,1menit:5"-
Batas yang, jika tercapai, menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan period adalah durasi dan count adalah bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap gen lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan yang 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC minor terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC minor tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat peristiwa GC minor terjadi dan nilai minimum 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 penggunaan persentase heap yang dipertahankan setidaknya pada batas ini, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan. Menyesuaikan nilai ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari thrashing GC, ketika thrashing GC (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
--experimental_command_profile=<cpu, wall, alloc or lock>
: lihat deskripsi - Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alloc, atau lock) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama sesuai jenis peristiwa di direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah pada masa mendatang untuk mendukung jenis profil atau format output tambahan; gunakan dengan risiko Anda sendiri.
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemoni dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemoni.
- Default
--experimental_repository_resolved_file=<a string>
: "" -
Jika tidak kosong, tulis nilai Starlark dengan informasi yang 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.:
- Default
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Jika tidak kosong, baca file yang di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan penyimpanan dalam cache jarak jauh:
- Default
--experimental_downloader_config=<a string>
: lihat deskripsi - Menentukan file yang akan dikonfigurasi dengan downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali dengan perintah (`allow`, `block`, atau `rewrite`), diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk dicocokkan, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik yang dimulai dari `$1`. Anda dapat memberikan beberapa perintah `rewrite` untuk URL yang sama, dan dalam hal ini beberapa URL akan ditampilkan.
- Default
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "otomatis" - Mode thread yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dihentikan. Jika tidak, gunakan thread pekerja virtual.
- 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 terlihat di suatu tempat pada jalur paket. Gunakan opsi ini saat 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 masih disediakan oleh entri package_path lain. Menentukan --deleted_packages x/y akan menghindari masalah ini.
- Default
--[no]fetch
: "true" - Mengizinkan perintah mengambil dependensi eksternal. Jika kebijakan disetel ke salah (false), perintah akan menggunakan versi dependensi yang di-cache, dan jika tidak ada, perintah akan mengakibatkan kegagalan.
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
- Default
--package_path=<colon-separated list of options>
: "%workspace%" - Daftar yang dipisahkan titik dua untuk tempat mencari paket. Elemen yang diawali dengan '%workspace%' bersifat relatif terhadap ruang kerja yang melingkupinya. Jika dihilangkan atau kosong, defaultnya adalah output dari 'bazel info default-package-path'.
- Default
--[no]show_loading_progress
: "true" - Jika diaktifkan, akan menyebabkan Bazel mencetak pesan "Loading package:".
Opsi Jalankan
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
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika ditetapkan, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Tindakan ini dimaksudkan untuk menghemat kapasitas disk.
Tag:bazel_internal_configuration
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--[no]incompatible_disable_native_repo_rules
: "false" -
Jika salah, aturan repo native dapat digunakan di WORKSPACE; jika tidak, aturan repo Starlark harus digunakan. Aturan repo native mencakup local_repository, new_local_repository, local_config_platform, android_sdk_repository, dan android_ndk_repository.
Tag:bazel_internal_configuration
- Default
--repository_cache=<a path>
: lihat deskripsi -
Menentukan lokasi cache 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
- Default
--[no]repository_disable_download
: "false" -
Jika ditetapkan, download menggunakan ctx.download{,_and_extract} tidak diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.Execute masih dapat menjalankan file arbitrer yang dapat mengakses Internet.
Tag:bazel_internal_configuration
- Default
--[no]run
: "true" -
Jika salah, lewati menjalankan command line yang dibuat untuk target yang di-build.
Tag:affects_outputs
- Opsi yang mengontrol eksekusi build:
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang dengan masa berlaku yang terisi (0-100) yang di atas batasnya GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika disetel ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, yang memengaruhi nilainya, bukan keberadaannya:
- Default
--script_path=<a path>
: lihat deskripsi -
Jika ditetapkan, tulis skrip shell ke file tertentu yang memanggil target. Jika opsi ini ditetapkan, 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 dirilis dan file yang dapat dieksekusi terhubung ke stdin terminal.
Tag:affects_outputs
,execution
- Opsi yang terkait dengan output dan semantik 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 dideklarasikan dihapus di registry tempatnya berasal (jika tidak berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang ditarik yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel dari modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasikannya ke kegagalan resolusi, `off` untuk menonaktifkan pemeriksaan, atau `warning` untuk mencetak peringatan saat ketidakcocokan terdeteksi.
Tag:loading_and_analysis
- Default
--check_direct_dependencies=<off, warning or error>
: "peringatan" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di modul root adalah versi yang sama dengan yang Anda dapatkan di grafik dependensi yang di-resolve. Nilai yang valid adalah `off` untuk menonaktifkan pemeriksaan, `warning` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasinya ke kegagalan resolusi.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` di MODULE.bazel dari modul root. Perhatikan bahwa dependensi developer tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai tanda ini.
Tag:loading_and_analysis
- Default
--lockfile_mode=<off, update, refresh or error>
: "update" -
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan mengupdatenya jika ada perubahan, `refresh` untuk memuat ulang informasi yang dapat diubah (versi yang ditarik dan modul yang sebelumnya tidak ada) dari registry jarak jauh dari waktu ke waktu, `error` untuk menggunakan file kunci, tetapi menampilkan error jika tidak terbaru, atau `off` untuk tidak membaca dari atau menulis ke file kunci.
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 <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
--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 baru akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
- Default
--vendor_dir=<a path>
: lihat deskripsi -
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalam atau menggunakannya saat mem-build. 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, menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan period adalah durasi dan count adalah bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap gen lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan yang 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat 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 diperlukan akan dihapus hingga berkali-kali per panggilan. Default-nya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC minor tidak akan pernah memicu penurunan. Jika batas tersebut tercapai, status Skyframe tidak akan lagi diturunkan 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 penggunaan persentase heap yang dipertahankan setidaknya pada batas ini, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan. Menyesuaikan nilai ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari thrashing GC, ketika thrashing GC (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
--experimental_command_profile=<cpu, wall, alloc or lock>
: lihat deskripsi - Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alloc, atau lock) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama sesuai jenis peristiwa di direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah pada masa mendatang untuk mendukung jenis profil atau format output tambahan; gunakan dengan risiko Anda sendiri.
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan dieksekusi terbanyak. 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.:
- Default
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Jika tidak kosong, baca file yang di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan penyimpanan dalam cache jarak jauh:
- Default
--experimental_downloader_config=<a string>
: lihat deskripsi - Menentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali dengan perintah (`allow`, `block`, atau `rewrite`), diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk dicocokkan, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik yang dimulai dari `$1`. Anda dapat memberikan beberapa perintah `rewrite` untuk URL yang sama, dan dalam hal ini beberapa URL akan ditampilkan.
- Default
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Mode threading yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dihentikan. Jika tidak, thread pekerja virtual akan digunakan.
- Opsi lainnya, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
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
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika ditetapkan, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Tindakan ini dimaksudkan untuk menghemat kapasitas disk.
Tag:bazel_internal_configuration
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum percobaan error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--[no]incompatible_disable_native_repo_rules
: "false" -
Jika salah, aturan repo native dapat digunakan di WORKSPACE; jika tidak, aturan repo Starlark harus digunakan. Aturan repo native mencakup local_repository, new_local_repository, local_config_platform, android_sdk_repository, dan android_ndk_repository.
Tag:bazel_internal_configuration
- Default
--repository_cache=<a path>
: lihat deskripsi -
Menentukan lokasi cache 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
- Default
--[no]repository_disable_download
: "false" -
Jika ditetapkan, download menggunakan ctx.download{,_and_extract} tidak diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.Execute masih dapat menjalankan file arbitrer yang dapat mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang dengan masa berlaku yang terisi (0-100) yang di atas batasnya GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika disetel ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi yang mengontrol output perintah:
- Default
--iff_heap_size_greater_than=<an integer>
: "0" -
Jika bukan nol, shutdown hanya akan menonaktifkan server jika total memori (dalam MB) yang digunakan oleh JVM melebihi nilai ini.
Tag:loses_incremental_state
,eagerness_to_exit
- Opsi yang terkait dengan output dan semantik 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 dideklarasikan dihapus di registry tempatnya berasal (jika tidak berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan kegagalan resolusi. Anda juga dapat menentukan versi yang ditarik yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Periksa kompatibilitas versi bazel dari modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasinya ke kegagalan resolusi, `nonaktif` untuk menonaktifkan pemeriksaan, atau `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi.
Tag:loading_and_analysis
- Default
--check_direct_dependencies=<off, warning or error>
: "peringatan" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan dalam modul root adalah versi yang sama dengan yang Anda dapatkan dalam grafik dependensi di-resolve. Nilai yang valid adalah `nonaktif` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasinya ke kegagalan resolusi.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi developer tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai tanda ini.
Tag:loading_and_analysis
- Default
--lockfile_mode=<off, update, refresh or error>
: "update" -
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan mengupdatenya jika ada perubahan, `refresh` untuk memuat ulang informasi yang dapat diubah (versi yang ditarik dan modul yang sebelumnya tidak ada) dari registry jarak jauh dari waktu ke waktu, `error` untuk menggunakan file kunci, tetapi menampilkan error jika tidak terbaru, atau `off` untuk tidak membaca dari atau menulis ke file kunci.
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 <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutan ini penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
- Default
--vendor_dir=<a path>
: lihat deskripsi -
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalam atau menggunakannya saat mem-build. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
default: "1detik:2,20detik:3,1menit:5"-
Batasan yang, jika tercapai, akan menyebabkan GcThrashingDetector membuat Bazel mengalami error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan period adalah durasi dan count adalah bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang dengan masa berlaku (heap gen lama) tetap terisi setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan yang 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti bahwa peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC minor terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC minor tidak akan pernah memicu penurunan. Jika batas tersebut tercapai, status Skyframe tidak akan lagi diturunkan 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 penggunaan persentase heap yang dipertahankan setidaknya pada batas ini, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan. Menyesuaikan nilai ini dapat memungkinkan Anda mengurangi dampak waktu dinding dari thrashing GC, ketika thrashing GC (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
--experimental_command_profile=<cpu, wall, alloc or lock>
: lihat deskripsi - Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alloc, atau lock) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa pada direktori basis output. Sintaksis dan semantik tanda ini dapat berubah pada masa mendatang untuk mendukung jenis profil atau format output tambahan; gunakan dengan risiko Anda sendiri.
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemoni dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemoni.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
- Default
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Jika tidak kosong, baca file yang di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan penyimpanan dalam cache jarak jauh:
- Default
--experimental_downloader_config=<a string>
: lihat deskripsi - Menentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali dengan perintah (`allow`, `block`, atau `rewrite`), diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk dicocokkan, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik yang dimulai dari `$1`. Anda dapat memberikan beberapa perintah `rewrite` untuk URL yang sama, dan dalam hal ini beberapa URL akan ditampilkan.
- Default
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "otomatis" - Mode thread yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dihentikan. Jika tidak, thread pekerja virtual akan digunakan.
- Opsi lainnya, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
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
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika disetel, cache repositori akan melakukan hardlink pada file jika cache ditemukan, bukan menyalinnya. Hal ini dimaksudkan untuk menghemat kapasitas disk.
Tag:bazel_internal_configuration
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--[no]incompatible_disable_native_repo_rules
: "false" -
Jika salah, aturan repo native dapat digunakan di WORKSPACE; jika tidak, aturan repo Starlark harus digunakan. Aturan repo native mencakup local_repository, new_local_repository, local_config_platform, android_sdk_repository, dan android_ndk_repository.
Tag:bazel_internal_configuration
- Default
--repository_cache=<a path>
: lihat deskripsi -
Menentukan lokasi cache 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
- Default
--[no]repository_disable_download
: "false" -
Jika ditetapkan, download menggunakan ctx.download{,_and_extract} tidak diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file yang dapat dieksekusi arbitrer yang mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--[no]configure
: "Salah" -
Hanya repositori sinkronisasi yang ditandai sebagai 'konfigurasi' untuk tujuan konfigurasi sistem.
Tag:changes_inputs
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang dengan masa berlaku yang terisi (0-100) yang di atas batasnya GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika disetel ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
--[no]keep_going
[-k
] default: "false"-
Lanjutkan sebanyak mungkin setelah terjadi error. Meskipun target yang gagal dan target yang bergantung padanya tidak dapat dianalisis, prasyarat lain dari target ini dapat dianalisis.
Tag:eagerness_to_exit
- Default
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "otomatis" -
Jumlah thread paralel yang akan digunakan untuk fase pemuatan/analisis.Mengambil bilangan bulat, atau kata kunci ("auto", "HOST_CPUS", "HOST_RAM"), secara opsional diikuti dengan operasi ([-|*]<float>) misalnya. "auto", "HOST_CPUS*.5". "auto" menetapkan default yang wajar berdasarkan resource host. 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. Masih menganggap semua (atau semua yang mirip dengan konfigurasi, jika --configure diberikan) sudah usang.
Tag:changes_inputs
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
- Default
--[no]incompatible_config_setting_private_default_visibility
: "false" -
Jika incompatible_enforce_config_setting_visibility=false, ini adalah noop. Selain itu, jika tanda ini salah, config_setting apa pun tanpa atribut visibilitas eksplisit adalah //visibility:public. Jika tanda ini benar, config_setting akan mengikuti logika visibilitas yang sama dengan semua aturan lainnya. Lihat https://github.com/bazelbuild/bazel/issues/12933.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_enforce_config_setting_visibility
: "true" -
Jika benar, terapkan batasan visibilitas config_setting. Jika salah, setiap config_setting dapat dilihat oleh setiap target. Lihat https://github.com/bazelbuild/bazel/issues/12932.
Tag:loading_and_analysis
,incompatible_change
- Opsi yang terkait dengan output dan semantik 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 dideklarasikan dihapus di registry tempatnya berasal (jika tidak berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang ditarik yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Memeriksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasinya ke kegagalan resolusi, `nonaktif` untuk menonaktifkan pemeriksaan, atau `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi.
Tag:loading_and_analysis
- Default
--check_direct_dependencies=<off, warning or error>
: "peringatan" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di modul root adalah versi yang sama dengan yang Anda dapatkan di grafik dependensi yang di-resolve. Nilai yang valid adalah `nonaktif` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasinya ke kegagalan resolusi.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` di MODULE.bazel dari 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
- Default
--lockfile_mode=<off, update, refresh or error>
: "update" -
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan mengupdatenya jika ada perubahan, `refresh` untuk memuat ulang informasi yang dapat diubah (versi yang ditarik dan modul yang sebelumnya tidak ada) dari registry jarak jauh dari waktu ke waktu, `error` untuk menggunakan file kunci, tetapi menampilkan error jika tidak terbaru, atau `off` untuk tidak membaca dari atau menulis ke file kunci.
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 <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut akan sesuai dengan direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutan ini penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
- Default
--vendor_dir=<a path>
: lihat deskripsi -
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalamnya atau menggunakannya saat mem-build. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
default: "1detik:2,20detik:3,1menit:5"-
Batas yang, jika tercapai, menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlahnya adalah bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang dengan masa berlaku (heap gen lama) tetap terisi setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan yang 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas tersebut tercapai, status Skyframe tidak akan lagi diturunkan saat 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC minor terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Default-nya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas tersebut tercapai, status Skyframe tidak akan lagi diturunkan 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 penggunaan persentase heap yang dipertahankan setidaknya pada batas ini, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan. Dengan menyesuaikan hal ini, Anda dapat mengurangi dampak waktu berjalan dari thrashing GC, jika thrashing GC (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada merekonstruksi status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
- Default
--experimental_command_profile=<cpu, wall, alloc or lock>
: lihat deskripsi - Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alloc, atau lock) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa pada direktori basis output. Sintaksis dan semantik tanda ini dapat berubah pada masa mendatang untuk mendukung jenis profil atau format output tambahan; gunakan dengan risiko Anda sendiri.
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan dieksekusi terbanyak. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
- Default
--experimental_repository_resolved_file=<a string>
: "" -
Jika tidak kosong, tulis nilai Starlark dengan informasi yang di-resolve dari semua aturan repositori Starlark yang dieksekusi.
Tag:affects_outputs
- Opsi yang menentukan atau mengubah input umum ke perintah Bazel yang tidak termasuk dalam kategori lain.:
- Default
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Jika tidak kosong, baca file terselesaikan yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi cache dan eksekusi jarak jauh:
- Default
--experimental_downloader_config=<a string>
: lihat deskripsi - Menentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali dengan perintah (`allow`, `block`, atau `rewrite`), diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk dicocokkan, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik yang dimulai dari `$1`. Anda dapat memberikan beberapa perintah `rewrite` untuk URL yang sama, dan dalam hal ini beberapa URL akan ditampilkan.
- Default
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Mode thread yang akan digunakan untuk pengambilan repo. Jika disetel ke 'off', tidak ada thread pekerja yang akan digunakan, dan pengambilan repo dapat dimulai ulang. Jika tidak, gunakan thread pekerja virtual.
- Opsi lainnya, 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 terlihat di suatu tempat pada jalur paket. Gunakan opsi ini saat menghapus subpaket '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 masih disediakan oleh entri package_path lain. Menentukan --deleted_packages x/y akan menghindari masalah ini.
- Default
--[no]fetch
: "true" - Mengizinkan perintah mengambil dependensi eksternal. Jika disetel ke salah (false), perintah akan menggunakan versi dependensi yang di-cache, dan jika tidak ada, perintah akan gagal.
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
- Default
--package_path=<colon-separated list of options>
: "%workspace%" - Daftar yang dipisahkan titik dua untuk tempat mencari paket. Elemen yang diawali dengan '%workspace%' bersifat relatif terhadap ruang kerja yang melingkupinya. Jika dihilangkan atau kosong, defaultnya adalah output dari 'bazel info default-package-path'.
- Default
--[no]show_loading_progress
: "true" - Jika diaktifkan, akan menyebabkan Bazel mencetak pesan "Loading package:".
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
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika ditetapkan, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Hal ini dimaksudkan untuk menghemat kapasitas disk.
Tag:bazel_internal_configuration
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--[no]incompatible_disable_native_repo_rules
: "false" -
Jika salah, aturan repo native dapat digunakan di WORKSPACE; jika tidak, aturan repo Starlark harus digunakan. Aturan repo native mencakup local_repository, new_local_repository, local_config_platform, android_sdk_repository, dan android_ndk_repository.
Tag:bazel_internal_configuration
- Default
--repository_cache=<a path>
: lihat deskripsi -
Menentukan lokasi cache 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
- Default
--[no]repository_disable_download
: "false" -
Jika ditetapkan, download menggunakan ctx.download{,_and_extract} tidak diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file yang dapat dieksekusi arbitrer 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 dengan masa berlaku yang terisi (0-100) yang di atas batasnya GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika disetel ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi yang terkait dengan output dan semantik 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 dideklarasikan dihapus di registry tempatnya berasal (jika tidak berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang ditarik yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Memeriksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasinya ke kegagalan resolusi, `nonaktif` untuk menonaktifkan pemeriksaan, atau `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi.
Tag:loading_and_analysis
- Default
--check_direct_dependencies=<off, warning or error>
: "peringatan" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di modul root adalah versi yang sama dengan yang Anda dapatkan di grafik dependensi yang di-resolve. Nilai yang valid adalah `nonaktif` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasinya ke kegagalan resolusi.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` di MODULE.bazel dari modul root. Perhatikan bahwa dependensi developer tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai tanda ini.
Tag:loading_and_analysis
- Default
--lockfile_mode=<off, update, refresh or error>
: "update" -
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan mengupdatenya jika ada perubahan, `refresh` untuk memuat ulang informasi yang dapat diubah (versi yang ditarik dan modul yang sebelumnya tidak ada) dari registry jarak jauh dari waktu ke waktu, `error` untuk menggunakan file kunci, tetapi menampilkan error jika tidak terbaru, atau `off` untuk tidak membaca dari atau menulis ke file kunci.
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 <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutan ini penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
- Default
--vendor_dir=<a path>
: lihat deskripsi -
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalam atau menggunakannya saat mem-build. 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, menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan period adalah durasi dan count adalah bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang dengan masa berlaku (heap gen lama) tetap terisi setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan yang 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 diperlukan akan dihapus hingga beberapa kali per panggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas tersebut tercapai, status Skyframe tidak akan lagi diturunkan saat 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 diperlukan akan dihapus hingga berkali-kali per panggilan. Default-nya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat peristiwa GC minor terjadi dan nilai minimum 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 persentase heap yang dipertahankannya setidaknya mencapai nilai minimum ini, status Skyframe sementara yang tidak diperlukan akan dihapus. Dengan menyesuaikan hal ini, Anda dapat mengurangi dampak waktu berjalan dari thrashing GC, jika thrashing GC (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada merekonstruksi status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
- Default
--experimental_command_profile=<cpu, wall, alloc or lock>
: lihat deskripsi - Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alloc, atau lock) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama sesuai jenis peristiwa di direktori dasar output. Sintaksis dan semantik tanda ini mungkin berubah di masa mendatang untuk mendukung jenis profil atau format output tambahan; gunakan dengan risiko Anda sendiri.
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemoni dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemonik.
- Default
--[no]print_relative_test_log_paths
: "false" -
Jika benar, saat mencetak jalur ke log pengujian, gunakan jalur relatif yang menggunakan symlink praktis 'testlogs'. Catatan: - Pemanggilan 'build'/'test'/etc berikutnya dengan konfigurasi yang berbeda dapat menyebabkan target symlink ini berubah, sehingga jalur yang dicetak sebelumnya tidak lagi berguna.
Tag:affects_outputs
- Default
--[no]test_verbose_timeout_warnings
: "false" -
Jika true (benar), menampilkan 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 (pengaturan 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.:
- Default
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Jika tidak kosong, baca file yang di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan penyimpanan dalam cache jarak jauh:
- Default
--experimental_downloader_config=<a string>
: lihat deskripsi - Menentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris-baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti oleh nama host (untuk `izinkan` dan `block`) atau dua pola, satu untuk dicocokkan, dan satu lagi untuk digunakan sebagai URL pengganti, dengan referensi kembali mulai dari `$1`. Ada kemungkinan beberapa perintah `rewrite` untuk URL yang sama akan diberikan, dan dalam hal ini beberapa URL akan diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
- Default
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Mode thread yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dihentikan. Jika tidak, gunakan thread pekerja virtual.
- Opsi lainnya, yang tidak dikategorikan.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
Opsi Vendor
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
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika ditetapkan, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Tindakan ini dimaksudkan untuk menghemat kapasitas disk.
Tag:bazel_internal_configuration
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--[no]incompatible_disable_native_repo_rules
: "false" -
Jika salah, aturan repo native dapat digunakan di WORKSPACE; jika tidak, aturan repo Starlark harus digunakan. Aturan repo native mencakup local_repository, new_local_repository, local_config_platform, android_sdk_repository, dan android_ndk_repository.
Tag:bazel_internal_configuration
- Default
--repository_cache=<a path>
: lihat deskripsi -
Menentukan lokasi cache 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
- Default
--[no]repository_disable_download
: "false" -
Jika ditetapkan, download menggunakan ctx.download{,_and_extract} tidak diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.Execute masih dapat menjalankan file arbitrer yang dapat mengakses Internet.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--gc_thrashing_threshold=<an integer in 0-100 range>
: "100" -
Persentase ruang dengan masa berlaku yang terisi (0-100) yang di atas batasnya GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika disetel ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
--[no]keep_going
[-k
] default: "false"-
Lanjutkan sebanyak mungkin setelah terjadi error. Meskipun target yang gagal dan target yang bergantung padanya tidak dapat dianalisis, prasyarat lain dari target ini dapat dianalisis.
Tag:eagerness_to_exit
- Default
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Jumlah thread paralel yang akan digunakan untuk fase pemuatan/analisis.Mengambil bilangan bulat, atau kata kunci ("auto", "HOST_CPUS", "HOST_RAM"), secara opsional diikuti dengan operasi ([-|*]<float>) misalnya. "auto", "HOST_CPUS*.5". "auto" menetapkan default yang wajar berdasarkan resource host. Minimal harus 1.
Tag:bazel_internal_configuration
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
- Default
--[no]incompatible_config_setting_private_default_visibility
: "false" -
Jika incompatible_enforce_config_setting_ visibility=false, berarti ini adalah noop. Atau, jika tanda ini salah, config_setting apa pun tanpa atribut visibilitas eksplisit adalah //visibility:public. Jika tanda ini benar, config_setting akan mengikuti logika visibilitas yang sama dengan semua aturan lainnya. Lihat https://github.com/bazelbuild/bazel/issues/12933.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_enforce_config_setting_visibility
: "true" -
Jika true (benar), terapkan batasan visibilitas config_setting. Jika salah, setiap config_setting akan terlihat oleh setiap target. Lihat https://github.com/bazelbuild/bazel/issues/12932.
Tag:loading_and_analysis
,incompatible_change
- Opsi yang terkait dengan output dan semantik 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 jika versi modul tersebut dinyatakan diambil dari registry tempat asalnya (jika tidak berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan kegagalan resolusi. Anda juga dapat menentukan versi yang ditarik yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
default: "error"-
Periksa kompatibilitas versi bazel dari modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasinya ke kegagalan resolusi, `nonaktif` untuk menonaktifkan pemeriksaan, atau `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi.
Tag:loading_and_analysis
- Default
--check_direct_dependencies=<off, warning or error>
: "peringatan" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di modul root adalah versi yang sama dengan yang Anda dapatkan di grafik dependensi yang di-resolve. Nilai yang valid adalah `nonaktif` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasinya ke kegagalan resolusi.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi developer tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai tanda ini.
Tag:loading_and_analysis
- Default
--lockfile_mode=<off, update, refresh or error>
: "update" -
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `refresh` untuk memperbarui informasi yang dapat diubah (versi yang ditarik dan modul yang sebelumnya tidak ada) dari registry jarak jauh dari waktu ke waktu, `error` untuk menggunakan lockfile, tetapi menampilkan error jika tidak diperbarui, atau `off` untuk tidak membaca dari 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 <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutan ini penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
--repo=<a string>
beberapa penggunaan diakumulasikan-
Hanya vendor repositori yang ditentukan, yang dapat berupa `@apparent_repo_name` atau `@@canonical_repo_name`. Opsi ini dapat ditetapkan beberapa kali
Tag:changes_inputs
- Default
--vendor_dir=<a path>
: lihat deskripsi -
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalam atau menggunakannya saat mem-build. 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, menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan periode adalah durasi dan jumlahnya adalah bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang dengan masa berlaku (heap gen lama) tetap terisi setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan yang 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat 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 diperlukan akan dihapus hingga berkali-kali per panggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC minor tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat peristiwa GC minor terjadi dan nilai minimum 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 penggunaan persentase heap yang dipertahankan setidaknya pada batas ini, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan. Dengan menyesuaikan hal ini, Anda dapat mengurangi dampak waktu berjalan dari thrashing GC, jika thrashing GC (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada merekonstruksi status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
- Default
--experimental_command_profile=<cpu, wall, alloc or lock>
: lihat deskripsi - Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alloc, atau lock) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama berdasarkan jenis peristiwa pada direktori basis output. Sintaksis dan semantik tanda ini dapat berubah pada masa mendatang untuk mendukung jenis profil atau format output tambahan; gunakan dengan risiko Anda sendiri.
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemoni dengan jumlah tindakan yang dieksekusi terbesar. Menyetel opsi ini akan menulis statistik untuk semua mnemoni.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
- Default
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Jika tidak kosong, baca file yang di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan penyimpanan dalam cache jarak jauh:
- Default
--experimental_downloader_config=<a string>
: lihat deskripsi - Menentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali dengan perintah (`allow`, `block`, atau `rewrite`), diikuti dengan nama host (untuk `allow` dan `block`) atau dua pola, satu untuk dicocokkan, dan satu untuk digunakan sebagai URL pengganti, dengan referensi balik yang dimulai dari `$1`. Anda dapat memberikan beberapa perintah `rewrite` untuk URL yang sama, dan dalam hal ini beberapa URL akan ditampilkan.
- Default
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Mode thread yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dihentikan. Jika tidak, gunakan thread pekerja virtual.
- Opsi lainnya, yang tidak dikategorikan.:
--deleted_packages=<comma-separated list of package names>
beberapa penggunaan diakumulasikan- Daftar nama paket yang dipisahkan koma yang dianggap tidak ada oleh sistem build, meskipun terlihat di suatu tempat di jalur paket. Gunakan opsi ini saat menghapus subpaket '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 masih disediakan oleh entri package_path lain. Menentukan --deleted_packages x/y akan menghindari masalah ini.
- Default
--[no]fetch
: "true" - Mengizinkan perintah mengambil dependensi eksternal. Jika disetel ke salah (false), perintah akan menggunakan versi dependensi yang di-cache, dan jika tidak ada, perintah akan gagal.
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
- Default
--package_path=<colon-separated list of options>
: "%workspace%" - Daftar yang dipisahkan titik dua untuk mencari paket. Elemen yang diawali dengan '%workspace%' bersifat relatif terhadap ruang kerja yang melingkupinya. Jika dihilangkan atau kosong, defaultnya adalah output 'bazel info default-package-path'.
- Default
--[no]show_loading_progress
: "true" - Jika diaktifkan, akan menyebabkan Bazel mencetak pesan "Loading package:".
- Opsi yang mengontrol eksekusi build:
- Default
--[no]experimental_inprocess_symlink_creation
: "false" -
Apakah akan membuat panggilan sistem file langsung untuk membuat hierarki symlink
Tag:loading_and_analysis
,execution
,experimental
- Default
--[no]experimental_persistent_aar_extractor
: "false" -
Aktifkan ekstraktor aar persisten menggunakan pekerja.
Tag:execution
- Default
--[no]experimental_remotable_source_manifests
: "false" -
Apakah akan membuat tindakan manifes sumber dapat diakses dari jarak jauh
Tag:loading_and_analysis
,execution
,experimental
- Default
--[no]experimental_split_coverage_postprocessing
: "false" -
Jika true (benar), Bazel akan menjalankan cakupan pascapemrosesan untuk pengujian pada spawn baru.
Tag:execution
- Default
--[no]experimental_strict_fileset_output
: "false" -
Jika opsi ini diaktifkan, set file akan memperlakukan semua artefak output sebagai file reguler. Perintah ini tidak akan menjelajahi direktori atau sensitif terhadap symlink.
Tag:execution
- Default
--[no]incompatible_disallow_unsound_directory_outputs
: "true" -
Jika ditetapkan, tindakan untuk mewujudkan file output sebagai direktori akan mengalami error. Tidak memengaruhi direktori sumber. Lihat https://github.com/bazelbuild/bazel/issues/18646.
Tag:bazel_internal_configuration
,incompatible_change
- Default
--[no]incompatible_modify_execution_info_additive
: "false" -
Jika diaktifkan, meneruskan beberapa tanda --modify_execution_info bersifat tambahan. Jika dinonaktifkan, hanya tanda terakhir yang akan dipertimbangkan.
Tag:execution
,affects_outputs
,loading_and_analysis
,incompatible_change
--[no]keep_going
[-k
] default: "false"-
Lanjutkan sebanyak mungkin setelah terjadi error. Meskipun target yang gagal dan target yang bergantung padanya tidak dapat dianalisis, prasyarat lain dari target ini dapat dianalisis.
Tag:eagerness_to_exit
- Default
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "otomatis" -
Jumlah thread paralel yang akan digunakan untuk fase pemuatan/analisis.Mengambil bilangan bulat, atau kata kunci ("auto", "HOST_CPUS", "HOST_RAM"), secara opsional diikuti dengan operasi ([-|*]<float>) misalnya. "auto", "HOST_CPUS*.5". "auto" menetapkan default yang wajar berdasarkan resource host. Minimal harus 1.
Tag:bazel_internal_configuration
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
beberapa penggunaan diakumulasikan-
Menambahkan atau menghapus tombol 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 ekspresi reguler yang dapat diterapkan ke mnemoni yang sama.
Sintaksis: "regex=[+-]kunci,regex=[+-]kunci,...".
Contoh:
'.*=+x,.*=-y,.*=+z' menambahkan 'x' dan 'z' ke, dan menghapus 'y' dari, info eksekusi untuk semua tindakan.
'Genrule=+requires-x' menambahkan 'requires-x' ke info eksekusi untuk semua tindakan Genrule.
'(?!Genrule).*=-memerlukan-x' menghapus 'memerlukan-x' dari info eksekusi untuk semua tindakan non-Genrule.
Tag:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
Mengaktifkan 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.
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_desugar
-
Mengaktifkan tindakan dex dan desugar Android multipleks persisten menggunakan pekerja.
Diperluas menjadi:
--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.
Diperluas menjadi:
--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
Tag:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Mengaktifkan 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
- Default
--[no]use_target_platform_for_tests
: "false" -
Jika benar, Bazel akan menggunakan platform target untuk menjalankan pengujian, bukan grup eksekusi pengujian.
Tag:execution
- Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
- Default
--android_compiler=<a string>
: 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
- Default
--android_grte_top=<a label>
: lihat deskripsi -
Target Android grte_top.
Tag:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Default
--android_manifest_merger=<legacy, android or force_android>
: "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
- Default
--android_platforms=<a build target label>
: "" -
Menetapkan platform yang digunakan target android_binary. Jika beberapa platform ditentukan, biner adalah APK tebal, 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 Android SDK/platform 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
- Default
--cc_output_directory_tag=<a string>
: "" -
Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.
Tag:affects_outputs
- Default
--compiler=<a string>
: 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 memproses ulang laporan cakupan mentah. Saat ini, file ini harus berupa grup file yang berisi satu file, yaitu biner. Defaultnya 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 ini 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. Setelan defaultnya adalah '//tools/test:coverage_support'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
default: "@bazel_tools//tools/cpp:toolchain"-
Label paket crosstool yang akan digunakan untuk mengompilasi kode C++.
Tag:loading_and_analysis
,changes_inputs
,affects_outputs
- Default
--custom_malloc=<a build target label>
: lihat deskripsi -
Menentukan implementasi malloc kustom. Setelan ini mengganti atribut malloc 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, yang masing-masing secara opsional 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 dilakukan seolah-olah telah mendeklarasikan nilai batasan sebagai batasan eksekusi. Contoh: //demo,-test=@platforms//cpus:x86_64 akan menambahkan 'x86_64' ke target apa pun di //demo kecuali target yang namanya berisi 'test'.
Tag:loading_and_analysis
- Default
--[no]experimental_include_xcode_execution_requirements
: "false" -
Jika ditetapkan, tambahkan persyaratan eksekusi "requires-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, atau jika tidak ada versi yang tersedia secara bersama, gunakan versi Xcode lokal yang dipilih melalui xcode-select.
Tag:loses_incremental_state
- Default
--extra_execution_platforms=<comma-separated list of options>
: "" -
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 platform yang dideklarasikan dalam file WORKSPACE oleh register_execution_platforms(). Opsi ini hanya boleh ditetapkan 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
- Default
--grte_top=<a label>
: lihat deskripsi -
Label ke library libc yang di-check in. Nilai default dipilih oleh toolchain crosstool, dan Anda hampir tidak pernah perlu menggantinya.
Tag:action_command_lines
,affects_outputs
- Default
--host_compiler=<a string>
: lihat deskripsi -
Compiler C++ yang akan digunakan untuk kompilasi host. Nilai ini diabaikan jika --host_crosstool_top tidak ditetapkan.
Tag:loading_and_analysis
,execution
- Default
--host_crosstool_top=<a build target label>
: lihat deskripsi -
Secara default, opsi --crosstool_top dan --compiler juga digunakan untuk konfigurasi exec. Jika flag ini disediakan, Bazel akan menggunakan libc dan compiler default untuk crosstool_top yang diberikan.
Tag:loading_and_analysis
,changes_inputs
,affects_outputs
- Default
--host_grte_top=<a label>
: lihat deskripsi -
Jika ditentukan, setelan ini akan menggantikan direktori tingkat atas libc (--grte_top) untuk konfigurasi exec.
Tag:action_command_lines
,affects_outputs
--host_platform=<a build target label>
default: "@bazel_tools//tools:host_platform"-
Label aturan platform yang menjelaskan sistem host.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
- Default
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "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
- Default
--[no]incompatible_enable_android_toolchain_resolution
: "true" -
Gunakan resolusi toolchain untuk memilih Android SDK untuk aturan Android (Starlark dan native)
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_enable_apple_toolchain_resolution
: "false" -
Gunakan resolusi toolchain untuk memilih Apple SDK untuk aturan apple (Starlark dan native)
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_make_thinlto_command_lines_standalone
: "true" -
Jika true (benar), Bazel tidak akan menggunakan kembali command line tindakan link C++ untuk mengindeks command line lto (lihat https://github.com/bazelbuild/bazel/issues/6791 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_remove_legacy_whole_archive
: "true" -
Jika true (benar), Bazel tidak akan menautkan dependensi library sebagai seluruh arsip secara default (lihat https://github.com/bazelbuild/bazel/issues/7362 untuk mengetahui petunjuk migrasi).
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_require_ctx_in_configure_features
: "true" -
Jika benar, Bazel akan mewajibkan parameter 'ctx' ke cc_common.configure_features (lihat https://github.com/bazelbuild/bazel/issues/7793 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,incompatible_change
-
Menggunakan objek bersama antarmuka jika didukung oleh toolchain. Semua toolchain ELF saat ini mendukung setelan ini.
Tag:loading_and_analysis
,affects_outputs
,affects_outputs
- Default
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Menentukan versi iOS SDK yang akan digunakan untuk mem-build aplikasi iOS. Jika tidak ditentukan, gunakan versi SDK iOS default dari 'xcode_version'.
Tag:loses_incremental_state
- Default
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Menentukan versi macOS SDK yang akan digunakan untuk mem-build aplikasi macOS. Jika tidak ditentukan, gunakan versi SDK macOS default dari 'xcode_version'.
Tag:loses_incremental_state
- Default
--minimum_os_version=<a string>
: lihat deskripsi -
Versi OS minimum yang ditargetkan kompilasi Anda.
Tag:loading_and_analysis
,affects_outputs
- Default
--platform_mappings=<a relative path>
: "" - Lokasi file pemetaan yang menjelaskan platform mana yang akan digunakan jika tidak ada yang ditetapkan atau flag mana yang akan ditetapkan jika platform sudah ada. Harus relatif terhadap root ruang kerja utama. Secara default, 'platform_mappings' (file langsung di bawah root ruang kerja).
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
- Default
--platforms=<a build target label>
: "" -
Label aturan platform yang menjelaskan platform target untuk perintah saat ini.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
- Default
--python2_path=<a string>
: lihat deskripsi -
Tidak digunakan lagi, tidak ada operasi. Dinonaktifkan oleh `--incompatible_use_python_toolchains`.
Tag:no_op
,deprecated
- Default
--python3_path=<a string>
: lihat deskripsi -
Tidak digunakan lagi, tanpa pengoperasian. Dinonaktifkan oleh `--incompatible_use_python_ toolchains`.
Tag:no_op
,deprecated
- Default
--python_path=<a string>
: lihat deskripsi -
Jalur absolut dari 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
- Default
--python_top=<a build target label>
: 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
- Default
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Menentukan versi tvOS SDK yang akan digunakan untuk mem-build aplikasi tvOS. Jika tidak ditentukan, gunakan versi tvOS SDK default dari 'xcode_version'.
Tag:loses_incremental_state
- Default
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Menentukan versi watchOS SDK yang akan digunakan untuk mem-build aplikasi watchOS. Jika tidak ditentukan, gunakan versi watchOS SDK default dari 'xcode_version'.
Tag:loses_incremental_state
- Default
--xcode_version=<a string>
: lihat deskripsi -
Jika ditentukan, akan menggunakan Xcode versi tertentu untuk tindakan build yang relevan. Jika tidak ditentukan, akan menggunakan versi default Xcode dari eksekutor.
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 dalam konfigurasi build.
Tag:loses_incremental_state
,loading_and_analysis
- Opsi yang mengontrol output perintah:
- Default
--[no]apple_generate_dsym
: "false" -
Apakah akan membuat file simbol debug (.dSYM).
Tag:affects_outputs
,action_command_lines
- Default
--[no]build_runfile_links
: "true" -
Jika true (benar), build hutan symlink runfiles untuk semua target. Jika salah (false), tulis hanya jika diperlukan oleh tindakan lokal, pengujian, atau perintah run.
Tag:affects_outputs
- Default
--[no]build_runfile_manifests
: "true" -
Jika benar, tulis manifes runfile untuk semua target. Jika salah (false), hapus. Pengujian lokal akan gagal dijalankan jika bernilai salah.
Tag:affects_outputs
- Default
--[no]build_test_dwp
: "false" -
Jika diaktifkan, saat mem-build pengujian C++ secara statis dan dengan fission, file .dwp untuk biner pengujian juga akan otomatis di-build.
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 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
- Default
--[no]experimental_proto_descriptor_sets_include_source_info
: "false" -
Menjalankan tindakan tambahan untuk versi API Java alternatif di proto_library.
Tag:affects_outputs
,loading_and_analysis
,experimental
- Default
--[no]experimental_proto_extra_actions
: "false" -
Menjalankan tindakan tambahan untuk versi Java API alternatif di proto_library.
Tag:affects_outputs
,loading_and_analysis
,experimental
- Default
--[no]experimental_save_feature_state
: "false" -
Simpan status fitur yang diaktifkan dan diminta sebagai output kompilasi.
Tag:affects_outputs
,experimental
- Default
--fission=<a set of compilation modes>
: "no" -
Menentukan mode kompilasi yang menggunakan fiksi untuk kompilasi dan link C++. Dapat berupa kombinasi dari {'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
- Default
--[no]incompatible_always_include_files_in_data
: "true" -
Jika 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_avoid).
Tag:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
default: "true"-
Jika benar, build hutan symlink runfile untuk repositori eksternal di .runfiles/wsname/external/repo (selain .runfiles/repo).
Tag:affects_outputs
- Default
--[no]objc_generate_linkmap
: "false" -
Menentukan apakah akan membuat file peta link.
Tag:affects_outputs
- Default
--[no]save_temps
: "false" -
Jika ditetapkan, output sementara dari gcc akan disimpan. Ini mencakup file .s (kode assembler), file .i (C++ yang telah diproses sebelumnya), dan file .ii (C++ yang telah diproses sebelumnya).
Tag:affects_outputs
- Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, memengaruhi nilainya, dibandingkan dengan 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 ditentukan berdasarkan nama, dalam hal ini nilai akan diambil dari lingkungan pemanggilan, atau dengan pasangan name=value yang menetapkan nilai secara independen dari lingkungan pemanggilan. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru akan digunakan, sedangkan opsi untuk variabel yang berbeda akan diakumulasikan.
Tag:action_command_lines
- Default
--android_cpu=<a string>
: "armeabi-v7a" -
CPU target Android.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--[no]android_databinding_use_androidx
: "true" -
Buat file data binding yang kompatibel dengan AndroidX. Ini hanya digunakan dengan databinding v2. Flag ini tidak melakukan operasi apa pun.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]android_databinding_use_v3_4_args
: "true" -
Gunakan android databinding v2 dengan argumen 3.4.0. Flag ini tidak melakukan operasi apa pun.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--android_dynamic_mode=<off, default or fully>
: "nonaktif" -
Menentukan apakah dependensi C++ dari aturan Android akan ditautkan secara dinamis saat cc_binary tidak membuat library bersama secara eksplisit. 'default' berarti bazel akan memilih apakah akan menautkan secara dinamis. 'full' berarti semua library akan ditautkan secara dinamis. 'nonaktif' berarti semua library akan ditautkan dalam mode statis.
Tag:affects_outputs
,loading_and_analysis
- Default
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "alfabet" -
Menetapkan urutan manifes yang diteruskan ke penggabungan manifes untuk biner Android. ALPHABETICAL berarti manifes diurutkan berdasarkan jalur relatif terhadap execroot. ALPHABETICAL_BY_CONFIGURATION berarti manifes diurutkan berdasarkan jalur yang relatif terhadap direktori konfigurasi dalam direktori output. DEPENDENCY berarti manifes diurutkan dengan manifes setiap library yang muncul sebelum manifes dependensinya.
Tag:action_command_lines
,execution
- Default
--[no]android_resource_shrinking
: "false" -
Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]build_python_zip
: "otomatis" -
Mem-build zip yang dapat dieksekusi python; aktif di Windows, nonaktif di platform lain
Tag:affects_outputs
--catalyst_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk mem-build biner Apple Catalyst.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--[no]collect_code_coverage
: "false" -
Jika ditentukan, Bazel akan melengkapi kode (menggunakan instrumentasi offline jika memungkinkan) dan akan mengumpulkan informasi cakupan selama pengujian. Hanya target yang cocok dengan --instrumentation_filter yang akan terpengaruh. Biasanya, opsi ini tidak boleh ditentukan secara langsung - perintah 'bazel coverage' harus digunakan.
Tag:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] default: "fastbuild"-
Menentukan mode tempat biner akan dibuat. 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 yang akan diteruskan ke gcc.
Tag:action_command_lines
,affects_outputs
- Default
--cpu=<a string>
: "" -
CPU target.
Tag:changes_inputs
,affects_outputs
- Default
--cs_fdo_absolute_path=<a string>
: lihat deskripsi -
Menggunakan informasi profil CSFDO untuk mengoptimalkan kompilasi. Tentukan nama jalur absolut dari file ZIP yang berisi file profil, file profil LLVM mentah atau yang diindeks.
Tag:affects_outputs
- Default
--cs_fdo_instrument=<a string>
: lihat deskripsi -
Buat 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
- Default
--cs_fdo_profile=<a build target label>
: 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.
Tag:changes_inputs
,affects_outputs
- Default
--dynamic_mode=<off, default or fully>
: "default" -
Menentukan apakah biner C++ akan ditautkan secara dinamis. 'default' berarti Bazel akan memilih apakah akan menautkan secara dinamis. 'sepenuhnya' berarti semua library akan ditautkan secara dinamis. 'nonaktif' berarti semua library akan ditautkan dalam mode statis.
Tag:loading_and_analysis
,affects_outputs
- Default
--[no]enable_fdo_profile_absolute_path
: "true" -
Jika ditetapkan, penggunaan fdo_absolute_profile_path akan menyebabkan error.
Tag:affects_outputs
- Default
--[no]enable_runfiles
: "otomatis" -
Mengaktifkan hierarki symlink runfile; Secara default, dinonaktifkan di Windows, diaktifkan di platform lain.
Tag:affects_outputs
--experimental_action_listener=<a build target label>
beberapa penggunaan diakumulasikan-
Tidak digunakan lagi dan digantikan dengan aspek. Gunakan action_listener untuk melampirkan extra_action ke tindakan build yang ada.
Tag:execution
,experimental
- Default
--[no]experimental_android_compress_java_resources
: "false" -
Kompresi resource Java di APK
Tag:affects_outputs
,loading_and_analysis
,experimental
- Default
--[no]experimental_android_databinding_v2
: "true" -
Gunakan android databinding v2. Tanda ini tidak dioperasikan.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]experimental_android_resource_shrinking
: "false" -
Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_android_rewrite_dexes_with_rex
: "false" -
menggunakan alat rex untuk menulis ulang file dex
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]experimental_collect_code_coverage_for_generated_files
: "false" -
Jika ditentukan, Bazel juga akan menghasilkan informasi cakupan pengumpulan untuk file yang dihasilkan.
Tag:affects_outputs
- Default
--experimental_objc_fastbuild_options=<comma-separated list of options>
: "-O0,-DDEBUG=1" -
Menggunakan string ini sebagai opsi compiler fastbuild objc.
Tag:action_command_lines
- Default
--[no]experimental_omitfp
: "false" -
Jika benar, gunakan libunwind untuk unwinding stack, dan kompilasi dengan -fomit-frame-pointer dan -fasynchronous-unwind-tables.
Tag:action_command_lines
,affects_outputs
,experimental
- Default
--experimental_output_paths=<off, content or strip>
: "nonaktif" -
Model mana yang akan digunakan untuk tempat aturan hierarki output menulis outputnya, 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 memilih untuk menggunakan pemetaan jalur dengan menambahkan kunci 'supports-path-mapping' ke kamus '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 dalam bentuk label=value dengan label merujuk ke platform dan nilai adalah nama singkat yang diinginkan untuk digunakan di jalur output. Hanya digunakan jika --experimental_platform_in_output_dir benar. Memiliki prioritas penamaan tertinggi.
Tag:affects_outputs
,experimental
- Default
--[no]experimental_platform_in_output_dir
: "false" -
Jika benar, nama singkat untuk platform target akan digunakan dalam nama direktori output, bukan CPU. Skema yang tepat bersifat eksperimental dan dapat berubah: Pertama, dalam kasus yang jarang terjadi, opsi --platforms tidak memiliki tepat satu nilai, hash opsi platform akan digunakan. Selanjutnya, jika nama pendek untuk platform saat ini didaftarkan oleh -- experiments_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. Terakhir, hash opsi platform digunakan sebagai upaya terakhir.
Tag:affects_outputs
,experimental
- Default
--[no]experimental_use_llvm_covmap
: "false" -
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"-
Hanya gunakan tanda ini sebagai bagian dari strategi pengujian atau migrasi yang disarankan. Perhatikan bahwa heuristik memiliki kekurangan yang diketahui dan sebaiknya bermigrasi untuk mengandalkan --experimental_override_name_platform_in_output_dir saja.
Tag:affects_outputs
,experimental
- Default
--fat_apk_cpu=<comma-separated set of options>
: "armeabi-v7a" -
Menetapkan opsi ini akan mengaktifkan fat APK, yang berisi biner native untuk semua arsitektur target yang ditentukan, misalnya, --fat_apk_cpu=x86,armeabi-v7a. Jika flag ini ditentukan, --android_cpu akan diabaikan untuk dependensi aturan android_binary.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--[no]fat_apk_hwasan
: "false" -
Apakah akan membuat pemisahan HWASAN.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--fdo_instrument=<a string>
: lihat deskripsi -
Buat biner dengan instrumentasi FDO. Dengan compiler Clang/LLVM, compiler ini juga menerima nama direktori tempat file profil mentah akan di-dump saat runtime.
Tag:affects_outputs
- Default
--fdo_optimize=<a string>
: lihat deskripsi -
Menggunakan 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. Flag ini juga menerima file yang ditentukan sebagai label (misalnya, `//foo/bar:file.afdo` - Anda mungkin perlu menambahkan perintah `exports_files` ke paket yang sesuai) dan label yang mengarah ke target `fdo_profile`. Flag ini akan diganti oleh aturan `fdo_profile`.
Tag:affects_outputs
- Default
--fdo_prefetch_hints=<a build target label>
: lihat deskripsi -
Gunakan petunjuk pengambilan data cache.
Tag:affects_outputs
- Default
--fdo_profile=<a build target label>
: 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 tersebut. Fitur negatif selalu menggantikan fitur positif. Lihat juga --host_features
Tag:changes_inputs
,affects_outputs
- Default
--[no]force_pic
: "false" -
Jika diaktifkan, semua kompilasi C++ akan menghasilkan kode yang tidak bergantung posisi ("-fPIC"), link akan lebih memilih library bawaan PIC daripada library non-PIC, dan link akan menghasilkan file yang dapat dieksekusi yang tidak bergantung pada 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 ditentukan berdasarkan nama, dalam hal ini nilai akan diambil dari lingkungan pemanggilan, atau dengan pasangan name=value yang menetapkan nilai secara independen dari lingkungan pemanggilan. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru akan digunakan, sedangkan opsi untuk variabel yang berbeda akan diakumulasikan.
Tag:action_command_lines
- Default
--host_compilation_mode=<fastbuild, dbg or opt>
: "opt" -
Tentukan mode yang akan digunakan alat selama 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 untuk diteruskan ke compiler C untuk alat yang dibangun dalam konfigurasi exec.
Tag:action_command_lines
,affects_outputs
- Default
--host_cpu=<a string>
: "" -
CPU host.
Tag:changes_inputs
,affects_outputs
--host_cxxopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke compiler C++ untuk alat yang dibangun 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 di-build dalam konfigurasi exec. Menentukan -<feature> akan menonaktifkan fitur tersebut. Fitur negatif selalu menggantikan fitur positif.
Tag:changes_inputs
,affects_outputs
- Default
--host_force_python=<PY2 or PY3>
: 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 exec.
Tag:action_command_lines
,affects_outputs
- Default
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi macOS minimum yang kompatibel untuk target host. Jika tidak ditentukan, akan menggunakan 'macos_sdk_version'.
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. Sintaksis: regex_filter@option_1,option_2,...,option_n. Dengan regex_filter adalah daftar pola ekspresi reguler yang disertakan dan dikecualikan (Lihat juga --instrumentation_filter). option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus diapit dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ pertama yang 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
--host_swiftcopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke swiftc untuk alat eksekusi.
Tag:action_command_lines
,affects_outputs
- Default
--[no]incompatible_auto_exec_groups
: "false" -
Jika diaktifkan, grup eksekusi akan otomatis dibuat untuk setiap toolchain yang digunakan oleh aturan. Agar aturan ini berfungsi, aturan harus menentukan parameter `toolchain` pada tindakannya. Untuk mengetahui informasi selengkapnya, lihat https://github.com/bazelbuild/bazel/issues/17134.
Tag:affects_outputs
,incompatible_change
- Default
--[no]incompatible_merge_genfiles_directory
: "true" -
Jika true (benar), direktori genfiles akan dilipat ke dalam direktori bin.
Tag:affects_outputs
,incompatible_change
--[no]incompatible_use_host_features
default: "true"-
Jika benar, gunakan --features hanya untuk konfigurasi target dan --host_features untuk konfigurasi exec.
Tag:changes_inputs
,affects_outputs
,incompatible_change
- Default
--[no]instrument_test_targets
: "false" -
Saat cakupan diaktifkan, menentukan apakah akan mempertimbangkan untuk melakukan instrumentasi pada aturan pengujian. 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 jika --instrument_test_targets diaktifkan.
Tag:affects_outputs
- Default
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi iOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'ios_sdk_version'.
Tag:loses_incremental_state
--ios_multi_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk membuat aplikasi ios_application. 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, diganti dengan --incompatible_remove_legacy_whole_archive (lihat https://github.com/bazelbuild/bazel/issues/7362 untuk mengetahui detailnya). Jika 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 penautan.
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 (di bagian --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 digunakan untuk membangun biner Apple macOS.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi macOS minimum yang kompatibel untuk target. Jika tidak ditentukan, gunakan 'macos_sdk_version'.
Tag:loses_incremental_state
- Default
--memprof_profile=<a build target label>
: lihat deskripsi -
Gunakan profil memprof.
Tag:affects_outputs
- Default
--[no]objc_debug_with_GLIBCXX
: "false" -
Jika ditetapkan, dan mode kompilasi ditetapkan ke 'dbg', tentukan GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC, dan GLIBCPP_CONCEPT_CHECKS.
Tag:action_command_lines
- Default
--[no]objc_enable_binary_stripping
: "false" -
Apakah akan melakukan penghapusan simbol dan kode mati pada biner tertaut. Penghapusan biner akan dilakukan jika flag 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. Sintaksis: regex_filter@option_1,option_2,...,option_n. Dengan regex_filter adalah daftar pola ekspresi reguler yang disertakan dan dikecualikan (Lihat juga --instrumentation_filter). option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus diapit dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ pertama yang 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 (di bagian --features=thin_lto) saat mengompilasi objek backend tertentu. Opsi ini dapat diteruskan beberapa kali. Sintaksis: regex_filter@option_1,option_2,...,option_n. Dengan regex_filter adalah daftar pola ekspresi reguler yang disertakan dan dikecualikan. option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus diapit dengan garis miring terbalik. Opsi dapat berisi @. Hanya @ pertama yang 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
- Default
--platform_suffix=<a string>
: lihat deskripsi -
Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.
Tag:loses_incremental_state
,affects_outputs
,loading_and_analysis
- Default
--propeller_optimize=<a build target label>
: lihat deskripsi -
Gunakan informasi profil Propeller untuk mengoptimalkan target build.Profil propeller harus terdiri dari minimal salah satu dari dua file, profil cc dan profil ld. Flag ini menerima label build yang harus merujuk ke file input profil baling-baling. Misalnya, file BUILD yang menentukan label, di a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)Perintah exports_files mungkin harus ditambahkan ke paket yang sesuai agar file ini terlihat oleh Bazel. Opsi ini harus digunakan sebagai: --propeller_optimize=//a/b:propeller_profile
Tag:action_command_lines
,affects_outputs
- Default
--propeller_optimize_absolute_cc_profile=<a string>
: lihat deskripsi -
Nama jalur absolut file cc_profile untuk build Propeller Optimized.
Tag:affects_outputs
- Default
--propeller_optimize_absolute_ld_profile=<a string>
: lihat deskripsi -
Nama jalur absolut file ld_profile untuk build Propeller Optimized.
Tag:affects_outputs
- Default
--run_under=<a prefix in front of command>
: 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', maka command line akhirnya adalah 'foo -bar test_binary -baz'.Ini juga dapat berupa label ke 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 yang identik akan dibagikan di antara target yang berbeda
Tag:loading_and_analysis
,affects_outputs
- Default
--[no]stamp
: "false" -
Menandai biner dengan tanggal, nama pengguna, nama host, informasi ruang kerja, dll.
Tag:affects_outputs
--strip=<always, sometimes or never>
default: "kadang-kadang"-
Menentukan apakah akan menghapus biner dan library bersama (menggunakan "-Wl,--strip-debug"). Nilai default 'sometimes' 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
--swiftcopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke kompilasi Swift.
Tag:action_command_lines
--tvos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang digunakan untuk membangun biner Apple tvOS.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi tvOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'tvos_sdk_version'.
Tag:loses_incremental_state
--visionos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma yang digunakan untuk membangun 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 untuk mem-build biner Apple watchOS.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi watchOS minimum yang kompatibel untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'watchos_sdk_version'.
Tag:loses_incremental_state
- Default
--xbinary_fdo=<a build target label>
: lihat deskripsi -
Menggunakan informasi profil XbinaryFDO untuk mengoptimalkan kompilasi. Tentukan nama profil lintas biner default. Jika opsi 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 menerapkan input build yang valid (definisi aturan, kombinasi tanda, dll.):
- Default
--auto_cpu_environment_group=<a build target label>
: "" -
Deklarasikan environment_group yang akan digunakan untuk memetakan nilai cpu ke nilai target_environment secara otomatis.
Tag:changes_inputs
,loading_and_analysis
,experimental
- Default
--[no]check_licenses
: "false" -
Pastikan batasan pemberian lisensi yang diberlakukan oleh paket dependen tidak bertentangan dengan mode distribusi target yang sedang dibuat. Secara default, lisensi tidak dicentang.
Tag:build_file_semantics
--[no]check_visibility
default: "true"-
Jika dinonaktifkan, error visibilitas dalam dependensi target akan diturunkan 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
- Default
--[no]desugar_java8_libs
: "false" -
Apakah akan menyertakan library Java 8 yang didukung dalam aplikasi untuk perangkat lama.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]enforce_constraints
: "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
- Default
--[no]experimental_check_desugar_deps
: "true" -
Apakah akan memeriksa kembali desugaring yang benar di tingkat biner Android.
Tag:eagerness_to_exit
,loading_and_analysis
,experimental
- Default
--experimental_import_deps_checking=<off, warning or error>
: "OFF" -
Jika diaktifkan, periksa apakah dependensi aar_import sudah selesai. Penerapan ini dapat merusak build, atau hanya dapat menghasilkan peringatan.
Tag:loading_and_analysis
- Default
--experimental_one_version_enforcement=<off, warning or error>
: "NONAKTIF" -
Jika diaktifkan, aturan java_binary tidak boleh berisi lebih dari satu versi file class yang sama di classpath. Penerapan ini dapat merusak build, atau hanya mengakibatkan peringatan.
Tag:loading_and_analysis
- Default
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "default" -
Jika benar, memeriksa apakah target Java secara eksplisit mendeklarasikan semua target yang digunakan secara langsung sebagai dependensi.
Tag:build_file_semantics
,eagerness_to_exit
- Default
--[no]incompatible_check_testonly_for_output_files
: "false" -
Jika diaktifkan, periksa testonly untuk target prasyarat yang merupakan file output dengan mencari testonly aturan pembuatan. Hal ini cocok dengan pemeriksaan visibilitas.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_check_visibility_for_toolchains
: "false" -
Jika diaktifkan, pemeriksaan visibilitas juga berlaku untuk implementasi toolchain.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_disable_native_android_rules
: "false" -
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
- Default
--[no]incompatible_disable_native_apple_binary_rule
: "false" -
Tidak ada operasi. Dipertahankan di sini untuk kompatibilitas mundur.
Tag:eagerness_to_exit
,incompatible_change
- Default
--[no]incompatible_python_disable_py2
: "true" -
Jika benar, penggunaan setelan Python 2 akan menyebabkan error. Ini mencakup 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"-
Jika benar, Bazel juga akan memvalidasi penyertaan header direktori tingkat teratas (lihat https://github.com/bazelbuild/bazel/issues/10047 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]one_version_enforcement_on_java_tests
: "true" -
Jika diaktifkan, dan dengan experimental_one_version_enforcement ditetapkan ke nilai non-NONE, terapkan satu versi pada target java_test. Flag ini dapat dinonaktifkan untuk meningkatkan performa pengujian inkremental dengan mengorbankan potensi pelanggaran satu versi.
Tag:loading_and_analysis
- Default
--python_native_rules_allowlist=<a build target label>
: lihat deskripsi -
Daftar yang diizinkan (target package_group) yang akan digunakan saat menerapkan --incompatible_python_disallow_native_rules.
Tag:loading_and_analysis
- Default
--[no]strict_filesets
: "false" -
Jika opsi ini diaktifkan, set file yang melintasi batas paket akan dilaporkan sebagai error.
Tag:build_file_semantics
,eagerness_to_exit
- Default
--strict_proto_deps=<off, warn, error, strict or default>
: "error" -
Kecuali jika 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>
: "nonaktif" -
Kecuali jika NONAKTIF, memeriksa apakah target proto_library secara eksplisit mendeklarasikan semua target yang digunakan di 'import public' sebagai diekspor.
Tag:build_file_semantics
,eagerness_to_exit
,incompatible_change
- Default
--[no]strict_system_includes
: "false" -
Jika 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 ditetapkan, dan mode kompilasi bukan 'opt', aplikasi objc akan menyertakan hak debug saat menandatangani.
Tag:changes_inputs
- Default
--ios_signing_cert_name=<a string>
: lihat deskripsi -
Nama sertifikat yang akan digunakan untuk penandatanganan iOS. Jika tidak disetel, akan kembali ke profil penyediaan. Dapat berupa preferensi identitas keychain sertifikat atau (substring) dari nama umum sertifikat, sesuai dengan halaman manual codesign (SIGNING IDENTITIES).
Tag:action_command_lines
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
- Default
--[no]incompatible_config_setting_private_default_visibility
: "false" -
Jika incompatible_enforce_config_setting_visibility=false, ini adalah noop. Atau, jika tanda ini salah, config_setting apa pun tanpa atribut visibilitas eksplisit adalah //visibility:public. Jika tanda ini benar, config_setting akan mengikuti logika visibilitas yang sama dengan semua aturan lainnya. Lihat https://github.com/bazelbuild/bazel/issues/12933.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_disallow_legacy_py_provider
: "true" -
Tidak ada operasi, akan segera dihapus.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_disallow_sdk_frameworks_attributes
: "false" -
Jika benar, jangan izinkan atribut sdk_frameworks dan weak_sdk_frameworks di objc_library dan objc_import.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_enforce_config_setting_visibility
: "true" -
Jika benar, terapkan batasan visibilitas config_setting. Jika salah, setiap config_setting dapat dilihat oleh setiap target. Lihat https://github.com/bazelbuild/bazel/issues/12932.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_objc_alwayslink_by_default
: "false" -
Jika benar, buat nilai default menjadi benar untuk atribut alwayslink di objc_library dan objc_import.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_python_disallow_native_rules
: "false" -
Jika benar, error akan terjadi saat menggunakan aturan py_* bawaan. Sebagai gantinya, aturan rule_python harus digunakan. Lihat https://github.com/bazelbuild/bazel/issues/17773 untuk mendapatkan informasi dan petunjuk migrasi selengkapnya.
Tag:loading_and_analysis
,incompatible_change
- Opsi yang mengatur perilaku lingkungan pengujian atau runner pengujian:
- Default
--[no]allow_analysis_failures
: "false" -
Jika benar, kegagalan analisis target aturan akan menyebabkan penyebaran instance AnalysisFailureInfo yang berisi deskripsi error, bukan menyebabkan 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
- Default
--[no]break_build_on_parallel_dex2oat_failure
: "false" -
Jika benar, kegagalan tindakan dex2oat akan menyebabkan build rusak, bukan menjalankan 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- Ganti jumlah resource default untuk pengujian. Format yang diharapkan adalah <resource>=<value>. Jika satu angka positif ditentukan sebagai <value>, angka tersebut akan mengganti resource default untuk semua ukuran pengujian. Jika 4 angka yang dipisahkan koma ditentukan, angka tersebut akan mengganti jumlah resource untuk ukuran pengujian kecil, sedang, besar, dan sangat besar. Nilai juga bisa HOST_RAM/HOST_CPU, bisa juga 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.
- Default
--[no]experimental_android_use_parallel_dex2oat
: "false" -
Gunakan dex2oat secara paralel untuk kemungkinan mempercepat android_test.
Tag:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- Default
--[no]ios_memleaks
: "false" -
Aktifkan pemeriksaan kebocoran memori di target ios_test.
Tag:action_command_lines
- Default
--ios_simulator_device=<a string>
: 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 komputer tempat simulator akan dijalankan.
Tag:test_runner
- Default
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: lihat deskripsi -
Versi iOS yang akan dijalankan di simulator saat menjalankan atau menguji. Hal 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 frekuensi 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 adalah singkatan dari nilai bilangan bulat dan regex_filter adalah singkatan dari daftar pola sertakan dan kecualikan pola ekspresi reguler (Lihat juga --instrumentation_filter). Contoh: --runs_per_test=//foo/.*,-//foo/bar/.*@3 menjalankan semua pengujian di //foo/ kecuali yang berada di foo/bar tiga kali. Opsi ini dapat diteruskan beberapa kali. Argumen yang terakhir diteruskan yang cocok akan diutamakan. Jika tidak ada yang cocok, pengujian hanya dijalankan sekali.
--test_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan variabel lingkungan tambahan yang akan dimasukkan ke dalam lingkungan runner pengujian. Variabel dapat ditentukan berdasarkan nama, dalam hal ini nilainya akan dibaca dari lingkungan klien Bazel, atau dengan pasangan name=value. 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" - Ganti nilai waktu tunggu pengujian default untuk waktu tunggu pengujian (dalam detik). Jika satu nilai bilangan bulat positif ditentukan, nilai tersebut akan menggantikan semua kategori. Jika 4 bilangan bulat yang dipisahkan koma ditentukan, bilangan bulat tersebut akan menggantikan waktu tunggu untuk singkat, sedang, panjang, dan abadi (dalam urutan tersebut). Dalam kedua bentuk tersebut, nilai -1 memberi tahu blaze untuk menggunakan waktu tunggu default 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 terkait dengan output dan semantik Bzlmod:
--repo=<a string>
beberapa penggunaan diakumulasikan-
Hanya vendor repositori yang ditentukan, yang dapat berupa `@apparent_repo_name` atau `@@canonical_repo_name`. Opsi ini dapat disetel beberapa kali
Tag:changes_inputs
- Opsi yang memicu pengoptimalan waktu build:
- Default
--[no]experimental_filter_library_jar_with_program_jar
: "false" -
Memfilter ProgramJar ProGuard untuk menghapus class yang juga ada di LibraryJar.
Tag:action_command_lines
- Default
--[no]experimental_inmemory_dotd_files
: "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
- Default
--[no]experimental_inmemory_jdeps_files
: "true" -
Jika diaktifkan, file dependensi (.jdeps) yang dihasilkan dari kompilasi Java akan diteruskan di memori langsung dari node build jarak jauh, bukan ditulis ke disk.
Tag:loading_and_analysis
,execution
,affects_outputs
,experimental
- Default
--[no]experimental_objc_include_scanning
: "false" -
Apakah akan melakukan pemindaian yang menyertakan C/C++ objektif.
Tag:loading_and_analysis
,execution
,changes_inputs
- Default
--[no]experimental_retain_test_configuration_across_testonly
: "false" -
Jika diaktifkan, --trim_test_configuration tidak akan memangkas konfigurasi pengujian untuk aturan yang ditandai testonly=1. Hal ini dimaksudkan untuk mengurangi masalah konflik tindakan saat aturan non-pengujian bergantung pada aturan cc_test. Tidak berpengaruh jika --trim_test_configuration bernilai salah (false).
Tag:loading_and_analysis
,loses_incremental_state
- Default
--[no]experimental_starlark_cc_import
: "false" -
Jika diaktifkan, cc_import versi Starlark dapat digunakan.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_unsupported_and_brittle_include_scanning
: "false" -
Apakah akan mempersempit input ke kompilasi C/C++ dengan mengurai baris #include dari file input. Hal ini dapat meningkatkan performa dan inkrementalitas dengan mengurangi ukuran hierarki input kompilasi. Namun, hal ini juga dapat merusak build karena pemindai include tidak sepenuhnya menerapkan semantik preprocessor C. Secara khusus, kode ini tidak memahami perintah #include dinamis dan mengabaikan logika bersyarat preprocessor. Gunakan dengan menanggung sendiri risikonya. Setiap masalah yang terkait dengan laporan ini yang diajukan akan ditutup.
Tag:loading_and_analysis
,execution
,changes_inputs
- Default
--[no]incremental_dexing
: "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 dikeluarkan oleh clang akan digunakan untuk memangkas kumpulan input yang diteruskan ke kompilasi objc.
Tag:changes_inputs
,loading_and_analysis
- Default
--[no]process_headers_in_dependencies
: "false" -
Saat mem-build //a:a target, header proses di semua target yang //a:a bergantung (jika pemrosesan header diaktifkan untuk toolchain).
Tag:execution
- Default
--[no]trim_test_configuration
: "true" -
Jika diaktifkan, opsi terkait pengujian akan dihapus di bawah level teratas build. Jika tanda ini aktif, pengujian tidak dapat dibuat sebagai dependensi aturan non-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 tingkat perincian, format, atau lokasi logging:
- Default
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
Mencetak informasi debug selama resolusi toolchain. Flag ini menggunakan ekspresi reguler, yang diperiksa terhadap jenis toolchain dan target tertentu untuk melihat mana yang akan di-debug. Beberapa ekspresi reguler dapat dipisahkan dengan koma, lalu setiap ekspresi reguler akan 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 singkatan untuk flag Starlark. Fungsi ini memerlukan satu pasangan nilai kunci dalam bentuk "<key>=<value>" sebagai argumen.
Tag:changes_inputs
- Default
--[no]incompatible_default_to_explicit_init_py
: "false" -
Flag ini mengubah perilaku default sehingga file __init__.py tidak lagi dibuat secara otomatis di runfile target Python. Secara khusus, jika target py_binary atau py_test memiliki legacy_create_init yang ditetapkan ke "auto" (default), target tersebut akan diperlakukan sebagai salah jika dan hanya jika tanda ini ditetapkan. Lihat https://github.com/bazelbuild/bazel/issues/10076.
Tag:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
default: "true"-
Jika benar, target yang di-build dalam konfigurasi Python 2 akan muncul di root output yang menyertakan akhiran '-py2', sedangkan target yang di-build untuk Python 3 akan muncul di root tanpa akhiran terkait Python. Ini berarti bahwa symlink praktis `bazel-bin` akan mengarah ke target Python 3, bukan Python 2. Jika Anda mengaktifkan opsi ini, sebaiknya aktifkan `--incompatible_py3_is_default`.
Tag:affects_outputs
,incompatible_change
- Default
--[no]incompatible_py3_is_default
: "true" -
Jika benar, 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 setel `--incompatible_py2_outputs_are_suffixed`.
Tag:loading_and_analysis
,affects_outputs
,incompatible_change
- Default
--[no]incompatible_use_python_toolchains
: "true" -
Jika ditetapkan 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
- Default
--python_version=<PY2 or PY3>
: lihat deskripsi -
Mode versi utama Python, baik `PY2` maupun `PY3`. Perhatikan bahwa ini diganti oleh target `py_binary` dan `py_test` (meskipun tidak menentukan versi secara eksplisit) sehingga biasanya tidak ada banyak alasan untuk memberikan tanda ini.
Tag:loading_and_analysis
,affects_outputs
- Opsi lainnya, yang tidak dikategorikan.:
--[no]cache_test_results
[-t
] default: "auto"- Jika ditetapkan ke 'auto', Bazel akan menjalankan ulang pengujian jika dan hanya jika: (1) Bazel mendeteksi perubahan dalam pengujian atau dependensinya, (2) pengujian ditandai sebagai eksternal, (3) beberapa pengujian dijalankan 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 'no', Bazel tidak akan menyimpan hasil pengujian dalam cache.
--deleted_packages=<comma-separated list of package names>
beberapa penggunaan diakumulasikan- Daftar nama paket yang dipisahkan koma yang dianggap tidak ada oleh sistem build, meskipun terlihat di suatu tempat di jalur paket. Gunakan opsi ini saat menghapus subpaket '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 lainnya. Menentukan --deleted_packages x/y akan menghindari masalah ini.
- Default
--[no]experimental_cancel_concurrent_tests
: "false" -
Jika benar, Blaze akan membatalkan pengujian yang berjalan secara serentak pada pengujian pertama yang berhasil. Nilai ini hanya berguna jika digabungkan dengan --runs_per_test_detects_flakes.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_fetch_all_coverage_outputs
: "false" -
Jika benar, Bazel akan mengambil seluruh direktori data cakupan untuk setiap pengujian selama cakupan dijalankan.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_generate_llvm_lcov
: "false" -
Jika benar, cakupan untuk clang akan menghasilkan laporan LCOV.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_j2objc_header_map
: "true" - Apakah akan membuat peta header J2ObjC secara paralel dengan transpilasi J2ObjC.
- Default
--[no]experimental_j2objc_shorter_header_path
: "false" -
Apakah akan dibuat dengan jalur header yang lebih pendek (menggunakan "_ios", bukan "_j2objc").
Tag:affects_outputs
- Default
--experimental_java_classpath=<off, javabuilder or bazel>
: "javabuilder" - Mengaktifkan classpath yang dikurangi untuk kompilasi Java.
- Default
--[no]experimental_limit_android_lint_to_android_constrained_java
: "false" -
Membatasi --experimental_run_android_lint_on_java_rules ke library yang kompatibel dengan Android.
Tag:affects_outputs
- Default
--[no]experimental_run_android_lint_on_java_rules
: "false" -
Apakah akan memvalidasi sumber java_*.
Tag:affects_outputs
- Default
--[no]explicit_java_test_deps
: "false" - Menentukan dependensi ke JUnit atau Hamcrest secara eksplisit dalam java_test, bukan secara tidak sengaja mendapatkannya dari deps TestRunner. Saat ini hanya berfungsi untuk bazel.
- Default
--[no]fetch
: "true" - Mengizinkan perintah mengambil dependensi eksternal. Jika disetel ke salah (false), perintah akan menggunakan versi dependensi yang di-cache, dan jika tidak ada, perintah akan gagal.
- Default
--host_java_launcher=<a build target label>
: lihat deskripsi - Peluncur Java yang digunakan oleh alat yang dieksekusi selama build.
--host_javacopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan untuk diteruskan ke javac saat mem-build alat yang dijalankan selama build.
--host_jvmopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke VM Java saat mem-build alat yang dieksekusi selama build. Opsi ini akan ditambahkan ke opsi startup VM setiap target java_binary.
- Default
--[no]incompatible_check_sharding_support
: "true" -
Jika benar, Bazel akan gagal dalam pengujian yang di-shard jika runner pengujian tidak menunjukkan bahwa pengujian tersebut mendukung sharding dengan menyentuh file di jalur di TEST_SHARD_STATUS_FILE. Jika 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 berjalan dengan strategi sandbox. Menambahkan tag 'local' untuk memaksa pengujian eksklusif berjalan secara lokal
Tag:incompatible_change
- Default
--[no]incompatible_strict_action_env
: "false" -
Jika 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, tetapi perhatikan bahwa tindakan ini dapat mencegah penyimpanan dalam 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
-
Membuat virtual machine Java dari pengujian java menunggu koneksi dari debugger yang mematuhi JDWP (seperti jdb) sebelum memulai pengujian. Menunjukkan -test_output=streamed.
Diluaskan menjadi:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- Default
--[no]java_deps
: "true" - Buat informasi dependensi (untuk saat ini, classpath waktu kompilasi) per target Java.
- Default
--[no]java_header_compilation
: "true" - Mengompilasi ijar langsung dari sumber.
- Default
--java_language_version=<a string>
: "" - Versi bahasa Java
- Default
--java_launcher=<a build target label>
: lihat deskripsi - Peluncur Java yang akan digunakan saat mem-build biner Java. Jika tanda ini ditetapkan ke string kosong, peluncur JDK akan digunakan. Atribut "launcher" akan mengganti tanda ini.
- Default
--java_runtime_version=<a string>
: "local_jdk" - Versi runtime Java
--javacopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke javac.
--jvmopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan untuk diteruskan ke Java VM. Opsi ini akan ditambahkan ke opsi startup VM dari setiap target java_binary.
- Default
--legacy_main_dex_list_generator=<a build target label>
: lihat deskripsi - Menentukan biner yang akan digunakan untuk membuat daftar class yang harus ada di dex utama saat mengompilasi multidex lama.
- Default
--optimizing_dexer=<a build target label>
: lihat deskripsi - Menentukan biner yang akan digunakan untuk melakukan dexing tanpa sharding.
- Default
--package_path=<colon-separated list of options>
: "%workspace%" - Daftar yang dipisahkan titik dua untuk mencari paket. Elemen yang diawali dengan '%workspace%' bersifat relatif terhadap ruang kerja yang melingkupinya. Jika dihilangkan atau kosong, defaultnya adalah output dari '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.
- Default
--proguard_top=<a build target label>
: lihat deskripsi - Menentukan versi ProGuard yang akan digunakan untuk penghapusan kode saat mem-build biner Java.
- Default
--proto_compiler=<a build target label>
: "@bazel_tools//tools/proto:protoc" -
Label proto-compiler.
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
- Default
--proto_toolchain_for_j2objc=<a build target label>
: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain" -
Label proto_lang_toolchain() yang menjelaskan cara mengompilasi proto j2objc
Tag:affects_outputs
,loading_and_analysis
- Default
--proto_toolchain_for_java=<a build target label>
: "@bazel_tools//tools/proto:java_toolchain" -
Label proto_lang_toolchain() yang menjelaskan cara mengompilasi proto Java
Tag:affects_outputs
,loading_and_analysis
- Default
--proto_toolchain_for_javalite=<a build target label>
: "@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 yang akan diteruskan ke compiler protobuf.
Tag:affects_outputs
- Default
--[no]runs_per_test_detects_flakes
: "false" - Jika benar, setiap shard yang setidaknya memiliki satu operasi/upaya yang berhasil dan setidaknya satu operasi/upaya yang gagal akan mendapatkan status FLAKY.
- Default
--shell_executable=<a path>
: lihat deskripsi -
Jalur absolut ke shell yang dapat dieksekusi untuk digunakan Bazel. Jika tidak ditetapkan, tetapi variabel lingkungan BAZEL_SH ditetapkan pada pemanggilan Bazel pertama (yang memulai server Bazel), Bazel akan menggunakannya. Jika tidak ada yang diatur, Bazel menggunakan jalur {i>default<i} hard code tergantung pada sistem operasi yang digunakan (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, yang lainnya: /bin/bash). Perhatikan bahwa penggunaan shell yang tidak kompatibel dengan bash dapat menyebabkan kegagalan build atau kegagalan runtime biner yang dihasilkan.
Tag:loading_and_analysis
--[no]show_loading_progress
default: "true"- Jika diaktifkan, akan menyebabkan Bazel mencetak pesan "Loading package:".
--test_arg=<a string>
beberapa penggunaan diakumulasikan- Menentukan opsi dan argumen tambahan yang harus diteruskan ke file yang dapat dieksekusi pengujian. Dapat digunakan beberapa kali untuk menentukan beberapa argumen. Jika beberapa pengujian dijalankan, setiap pengujian akan menerima argumen yang sama. Hanya digunakan oleh perintah 'bazel test'.
- Default
--test_filter=<a string>
: lihat deskripsi - Menentukan filter untuk diteruskan ke framework pengujian. Digunakan untuk membatasi pengujian yang dijalankan. Perhatikan bahwa hal ini tidak memengaruhi target mana yang dibuat.
- Default
--test_result_expiration=<an integer>
: "-1" - Opsi ini tidak digunakan lagi dan tidak berpengaruh.
- Default
--[no]test_runner_fail_fast
: "false" - Opsi maju gagal pada runner pengujian. 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>
: "explicit" - Menentukan strategi untuk sharding pengujian: 'explicit' 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'.
- Default
--tool_java_language_version=<a string>
: "" - Versi bahasa Java yang digunakan untuk menjalankan alat yang diperlukan selama build
--tool_java_runtime_version=<a string>
default: "remotejdk_11"- Versi runtime Java yang digunakan untuk menjalankan alat selama build
- Default
--[no]use_ijars
: "true" - Jika diaktifkan, opsi ini akan menyebabkan kompilasi Java menggunakan jar antarmuka. Ini akan menghasilkan kompilasi inkremental yang lebih cepat, tetapi pesan error bisa berbeda.
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
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika disetel, cache repositori akan melakukan hardlink pada file jika cache ditemukan, bukan menyalinnya. Tindakan ini dimaksudkan untuk menghemat kapasitas disk.
Tag:bazel_internal_configuration
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--[no]incompatible_disable_native_repo_rules
: "false" -
Jika salah, aturan repo native dapat digunakan di WORKSPACE; jika tidak, aturan repo Starlark harus digunakan. Aturan repo native mencakup local_repository, new_local_repository, local_config_platform, android_sdk_repository, dan android_ndk_repository.
Tag:bazel_internal_configuration
- Default
--repository_cache=<a path>
: lihat deskripsi -
Menentukan lokasi cache 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
- Default
--[no]repository_disable_download
: "false" -
Jika ditetapkan, download menggunakan ctx.download{,_and_extract} tidak diizinkan selama pengambilan repositori. Perhatikan bahwa akses jaringan tidak sepenuhnya dinonaktifkan; ctx.execute masih dapat menjalankan file yang dapat dieksekusi arbitrer 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 dengan masa berlaku yang terisi (0-100) yang di atas batasnya GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika disetel ke 100, GcThrashingDetector akan dinonaktifkan.
Tag:host_machine_resource_optimizations
- Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, yang memengaruhi nilainya, bukan keberadaannya:
- Default
--[no]gnu_format
: "false" -
Jika ditetapkan, tulis versi ke stdout menggunakan konvensi yang dijelaskan dalam standar GNU.
Tag:affects_outputs
,execution
- Opsi yang terkait dengan output dan semantik 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 dideklarasikan dihapus di registry tempatnya berasal (jika tidak berasal dari NonRegistryOverride). Jika tidak, versi yang ditarik akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang ditarik yang diizinkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Memeriksa kompatibilitas versi bazel modul Bazel. Nilai yang valid adalah `error` untuk mengeskalasinya ke kegagalan resolusi, `nonaktif` untuk menonaktifkan pemeriksaan, atau `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi.
Tag:loading_and_analysis
- Default
--check_direct_dependencies=<off, warning or error>
: "peringatan" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di modul root adalah versi yang sama dengan yang Anda dapatkan di grafik dependensi yang di-resolve. Nilai yang valid adalah `nonaktif` untuk menonaktifkan pemeriksaan, `peringatan` untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau `error` untuk mengeskalasinya ke kegagalan resolusi.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` di MODULE.bazel dari modul root. Perhatikan bahwa dependensi developer tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai tanda ini.
Tag:loading_and_analysis
- Default
--lockfile_mode=<off, update, refresh or error>
: "update" -
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan lockfile dan memperbaruinya jika ada perubahan, `refresh` untuk memperbarui informasi yang dapat diubah (versi yang ditarik dan modul yang sebelumnya tidak ada) dari registry jarak jauh dari waktu ke waktu, `error` untuk menggunakan lockfile, tetapi menampilkan error jika tidak diperbarui, atau `off` untuk tidak membaca dari 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 <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan apa adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut bersifat relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutan ini penting: modul akan dicari di registry sebelumnya terlebih dahulu, dan hanya kembali ke registry berikutnya jika tidak ada di registry sebelumnya.
Tag:changes_inputs
- Default
--vendor_dir=<a path>
: lihat deskripsi -
Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalam atau menggunakannya saat mem-build. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
default: "1detik:2,20detik:3,1menit:5"-
Batas yang, jika tercapai, menyebabkan GcThrashingDetector membuat Bazel error dengan OOM. Setiap batas ditentukan sebagai <period>:<count> dengan period adalah durasi dan count adalah bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang tenured (heap gen lama) tetap ditempati setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan yang 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC penuh terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC penuh tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat 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 penggunaan persentase heap yang dipertahankan melebihi nilai minimum yang ditetapkan oleh --skyframe_high_water_mark_threshold, saat peristiwa GC minor terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga sebanyak ini per pemanggilan. Defaultnya adalah Integer.MAX_VALUE; secara efektif tidak terbatas. Nol berarti peristiwa GC minor tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihapus saat peristiwa GC minor terjadi dan nilai minimum 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 penggunaan persentase heap yang dipertahankan setidaknya pada batas ini, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan. Dengan menyesuaikan hal ini, Anda dapat mengurangi dampak waktu berjalan dari thrashing GC, jika thrashing GC (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada merekonstruksi status saat diperlukan.
Tag:host_machine_resource_optimizations
- Opsi yang memengaruhi panjang, format, atau lokasi logging:
- Default
--experimental_command_profile=<cpu, wall, alloc or lock>
: lihat deskripsi - Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alloc, atau lock) harus diberikan sebagai argumen. Profil ditulis ke file yang diberi nama sesuai jenis peristiwa di direktori dasar output. Sintaksis dan semantik tanda ini dapat berubah pada masa mendatang untuk mendukung jenis profil atau format output tambahan; gunakan dengan risiko Anda sendiri.
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemoni 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.:
- Default
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
Jika tidak kosong, baca file yang di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan penyimpanan dalam cache jarak jauh:
- Default
--experimental_downloader_config=<a string>
: lihat deskripsi - Menentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris-baris, yang masing-masing dimulai dengan perintah (`allow`, `block`, atau `rewrite`) diikuti oleh nama host (untuk `izinkan` dan `block`) atau dua pola, satu untuk dicocokkan, dan satu lagi untuk digunakan sebagai URL pengganti, dengan referensi kembali mulai dari `$1`. Ada kemungkinan beberapa perintah `rewrite` untuk URL yang sama akan diberikan, dan dalam hal ini beberapa URL akan diberikan, dan dalam hal ini beberapa URL akan ditampilkan.
- Default
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto>
: "auto" - Mode thread yang akan digunakan untuk pengambilan repo. Jika disetel ke 'nonaktif', tidak ada thread pekerja yang digunakan, dan pengambilan repo akan dihentikan. Jika tidak, thread pekerja virtual 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 <nama repositori>=<jalur>. 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 diberikan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root ruang kerja, yang merupakan output `bazel info workspace`. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.
Tag Efek Opsi
unknown |
Opsi ini memiliki efek yang tidak diketahui atau tidak terdokumentasi. |
no_op |
Opsi ini benar-benar tidak berpengaruh. |
loses_incremental_state |
Mengubah nilai opsi ini dapat menyebabkan hilangnya status inkremental secara signifikan, yang memperlambat build. Status dapat hilang karena server dimulai ulang atau karena sebagian besar grafik dependensi tidak valid. |
changes_inputs |
Opsi ini secara aktif mengubah input yang dipertimbangkan bazel untuk build, seperti batasan sistem file, versi repositori, atau opsi lainnya. |
affects_outputs |
Opsi ini memengaruhi output bazel. Tag ini sengaja dibuat luas, dapat mencakup pengaruh transitif, dan tidak menentukan jenis output yang terpengaruh. |
build_file_semantics |
Opsi ini memengaruhi semantik file BUILD atau .bzl. |
bazel_internal_configuration |
Opsi ini memengaruhi setelan mesin internal bazel. Tag ini tidak berarti bahwa artefak build terpengaruh. |
loading_and_analysis |
Opsi ini memengaruhi pemuatan dan analisis dependensi, serta pembangunan grafik dependensi. |
execution |
Opsi ini memengaruhi fase eksekusi, seperti sandboxing atau opsi terkait eksekusi jarak jauh. |
host_machine_resource_optimizations |
Opsi ini memicu pengoptimalan yang mungkin dikhususkan untuk 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 kegagalan, dengan pilihan antara melanjutkan meskipun terjadi kegagalan dan mengakhiri pemanggilan. |
bazel_monitoring |
Opsi ini digunakan untuk memantau perilaku dan performa bazel. |
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 build. |
Tag Metadata Opsi
experimental |
Opsi ini memicu fitur eksperimental tanpa jaminan fungsionalitas. |
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 tidak digunakan lagi, atau metode lain untuk memberikan informasi lebih disukai. |