Referensi Command-Line

bazel [<startup options>] <command> [<args>]
atau
bazel [<startup options>] <command> [<args>] -- [<target patterns>]
Lihat Panduan Pengguna untuk mengetahui sintaksis pola target.

Sintaksis Opsi

Opsi dapat diteruskan ke Bazel dengan berbagai cara. Opsi yang memerlukan nilai dapat diteruskan dengan tanda sama dengan atau spasi:

--<option>=<value>
--<option> <value>
Beberapa opsi memiliki bentuk 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 tiga status biasanya disetel 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

aquery Menganalisis target yang diberikan dan mengkueri grafik tindakan.
build Membangun target yang ditentukan.
canonicalize-flags Mengubah daftar opsi bazel menjadi kanonis.
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 Mencatat 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 Menargetkan penginstalan 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.
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:
--[no]autodetect_server_javabase default: "true"

Jika --noautodetect_server_javabase diteruskan, Bazel tidak akan beralih kembali ke JDK lokal untuk menjalankan server bazel, melainkan akan keluar.

Tag: affects_outputs, loses_incremental_state

--[no]batch default: "false"

Jika disetel, Bazel akan dijalankan hanya sebagai proses klien tanpa server, bukan dalam mode klien/server standar. Tindakan ini tidak digunakan lagi dan akan dihapus. Sebaiknya matikan server secara eksplisit jika Anda ingin menghindari server yang masih aktif.

Tag: loses_incremental_state, bazel_internal_configuration, deprecated

--[no]batch_cpu_scheduling default: "false"

Hanya di Linux; gunakan penjadwalan CPU 'batch' untuk Blaze. Kebijakan ini berguna untuk workload yang tidak interaktif, tetapi tidak ingin menurunkan nilai bagusnya. Lihat 'man 2 sched_setscheduler'. Jika salah (false), Bazel tidak melakukan panggilan sistem.

Tag: host_machine_resource_optimizations

Penggunaan --bazelrc=<path> beberapa kali akan diakumulasikan

Lokasi file .bazelrc pengguna yang berisi nilai default opsi Bazel. /dev/null menunjukkan bahwa semua --bazelrc berikutnya 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 /dev/null sebelumnya. Jika tidak ditentukan, Bazel akan menggunakan file .bazelrc pertama yang ditemukannya 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

--[no]block_for_lock default: "true"

Jika --noblock_for_lock diteruskan, Bazel tidak menunggu hingga perintah yang sedang berjalan selesai, tetapi akan langsung keluar.

Tag: eagerness_to_exit

--[no]client_debug default: "false"

Jika benar, catat informasi debug dari klien ke stderr. Mengubah opsi ini tidak akan menyebabkan server dimulai ulang.

Tag: affects_outputs, bazel_monitoring

--connect_timeout_secs=<an integer> default: "30"

Jumlah waktu yang ditunggu klien untuk setiap upaya terhubung ke server

Tag: bazel_internal_configuration

--digest_function=<hash function> default: lihat deskripsi

Fungsi hash yang akan digunakan saat menghitung ringkasan file.

Tag: loses_incremental_state, bazel_internal_configuration

--experimental_cgroup_parent=<path> default: lihat deskripsi

Cgroup tempat memulai server bazel sebagai jalur absolut. Proses server akan dimulai di cgroup yang ditentukan untuk setiap pengontrol yang didukung. Misalnya, jika nilai flag ini adalah /build/bazel dan pengontrol CPU dan memori masing-masing di-mount di /sys/fs/cgroup/cpu dan /sys/fs/cgroup/memory, server akan dimulai di cgroup /sys/fs/cgroup/cpu/build/bazel dan /sys/fs/cgroup/memory/build/bazel.Ini bukan error jika cgroup yang ditentukan tidak dapat ditulis untuk satu atau beberapa pengontrol. Opsi ini tidak berpengaruh pada platform yang tidak mendukung cgroup.

Tag: bazel_monitoring, execution

--[no]experimental_run_in_user_cgroup default: "false"

Jika benar (true), server Bazel akan dijalankan dengan systemd-run, dan pengguna akan memiliki cgroup. Flag ini hanya berlaku di Linux.

Tag: bazel_monitoring, execution

--extra_classpath=<a string> default: ""

Daftar entri classpath yang dipisahkan dengan titik dua untuk ditambahkan ke classpath server Bazel.

Tag: bazel_internal_configuration

--failure_detail_out=<path> default: 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 adalah ${OUTPUT_BASE}/failure_detail.rawproto.

Tag: affects_outputs, loses_incremental_state

--[no]home_rc default: "true"

Apakah akan mencari file bazelrc beranda di $HOME/.bazelrc

Tag: changes_inputs

--[no]idle_server_tasks default: "true"

Menjalankan System.gc() saat server tidak ada aktivitas

Tag: loses_incremental_state, host_machine_resource_optimizations

--[no]ignore_all_rc_files default: "false"

Menonaktifkan semua file rc, terlepas dari nilai flag pengubah rc lainnya, meskipun flag ini muncul kemudian dalam daftar opsi startup.

Tag: changes_inputs

--io_nice_level={-1,0,1,2,3,4,5,6,7} default: "-1"

Hanya di Linux; menetapkan tingkat 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 mematuhi hingga prioritas 4. Jika disetel ke nilai negatif, Bazel tidak akan melakukan panggilan sistem.

Tag: host_machine_resource_optimizations

--local_startup_timeout_secs=<an integer> default: "120"

Jumlah waktu maksimum yang ditunggu klien untuk terhubung ke server

Tag: bazel_internal_configuration

--macos_qos_class=<a string> default: "default"

Menetapkan class layanan QoS server bazel saat berjalan di macOS. Flag ini tidak berpengaruh pada semua platform lainnya, tetapi didukung untuk memastikan file rc dapat dibagikan di antara platform tersebut tanpa perubahan. Nilai yang mungkin 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 dalam status tidak ada aktivitas sebelum dinonaktifkan. Nol berarti server tidak akan pernah dimatikan. Opsi ini hanya dibaca saat server dimulai, mengubah opsi ini tidak akan menyebabkan server dimulai ulang.

Tag: eagerness_to_exit, loses_incremental_state

--output_base=<path> default: lihat deskripsi

Jika disetel, menentukan lokasi output tempat semua output build akan ditulis. Jika tidak, lokasinya adalah ${OUTPUT_ROOT}/blaze${USER}/${MD5_OF_WORKSPACE_ROOT}. Catatan: Jika Anda menentukan opsi yang berbeda dari satu pemanggilan Bazel ke pemanggilan Bazel berikutnya untuk nilai ini, Anda kemungkinan akan memulai server Bazel baru tambahan. Bazel memulai tepat satu server per dasar output yang ditentukan. Biasanya ada satu dasar output per ruang kerja. Namun, dengan opsi ini, Anda dapat memiliki beberapa dasar output per ruang kerja dan dengan demikian menjalankan beberapa build untuk klien yang sama di mesin yang sama secara bersamaan. Lihat 'bazel help shutdown' tentang cara menonaktifkan server Bazel.

Tag: affects_outputs, loses_incremental_state

--output_user_root=<path> default: 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

--[no]preemptible default: "false"

Jika benar (true), perintah dapat didahului jika perintah lain dimulai.

Tag: eagerness_to_exit

--[no]quiet default: "false"

Jika benar (true), tidak ada pesan informasi yang dikeluarkan di konsol, hanya error. Mengubah opsi ini tidak akan menyebabkan server dimulai ulang.

Tag: affects_outputs, bazel_monitoring

--server_jvm_out=<path> default: lihat deskripsi

Lokasi untuk menulis output JVM server. Jika tidak ditetapkan, secara default akan ditetapkan ke lokasi di output_base.

Tag: affects_outputs, loses_incremental_state

--[no]shutdown_on_low_sys_mem default: "false"

Jika max_idle_secs disetel dan server build telah tidak aktif selama beberapa waktu, nonaktifkan server saat sistem kekurangan RAM kosong. Khusus Linux dan MacOS.

Tag: eagerness_to_exit, loses_incremental_state

--[no]system_rc default: "true"

Apakah akan mencari bazelrc di seluruh sistem atau tidak.

Tag: changes_inputs

--[no]unlimit_coredumps default: "false"

Menaikkan batas coredump sementara ke batas keras untuk memungkinkan coredump server (termasuk JVM) dan klien dalam kondisi umum. Tempelkan tanda ini di bazelrc Anda sekali saja dan lupakan, sehingga Anda akan mendapatkan coredump saat benar-benar menemukan kondisi yang memicunya.

Tag: bazel_internal_configuration

Jika benar, tautan simbolis nyata akan dibuat di Windows, bukan penyalinan file. Memerlukan mode developer Windows diaktifkan dan Windows 10 versi 1703 atau yang lebih baru.

Tag: bazel_internal_configuration

--[no]workspace_rc default: "true"

Apakah akan mencari file bazelrc ruang kerja di $workspace/.bazelrc

Tag: changes_inputs

Opsi eksekusi dan caching jarak jauh:
--[no]experimental_remote_repo_contents_cache default: "false"

Jika diaktifkan, cache jarak jauh akan digunakan untuk menyimpan hasil aturan repositori yang dapat direproduksi. Jika aturan repositori perlu dievaluasi dan hasilnya sudah ada di cache jarak jauh, konten repositori akan disimpan dalam sistem file dalam memori dan hanya didownload jika diperlukan, baik oleh Bazel itu sendiri maupun tindakan yang berjalan secara lokal.

Tag: loading_and_analysis

Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
Penggunaan --host_jvm_args=<jvm_arg> beberapa kali akan diakumulasikan

Flag yang akan diteruskan ke JVM yang menjalankan Blaze.

--host_jvm_debug

Opsi praktis untuk menambahkan beberapa tanda peluncuran JVM tambahan, yang menyebabkan JVM menunggu selama peluncuran hingga Anda terhubung dari debugger yang kompatibel dengan JDWP (seperti Eclipse) ke port 5005.

Meluas menjadi:
  --host_jvm_args=-agentlib:jdwp=transport=dt_socket,server=y,address=5005

--server_javabase=<jvm path> default: ""

Jalur ke JVM yang digunakan untuk menjalankan Bazel itu sendiri.

Opsi Umum untuk semua Perintah

Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
Penggunaan --distdir=<a path> beberapa kali akan diakumulasikan

Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.

Tag: bazel_internal_configuration

Jika disetel, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Tindakan ini dimaksudkan untuk menghemat ruang disk.

Tag: bazel_internal_configuration

--experimental_repository_downloader_retries=<an integer> default: "5"

Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.

Tag: experimental

--experimental_scale_timeouts=<a double> default: "1.0"

Menskalakan semua waktu tunggu dalam aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber

Tag: bazel_internal_configuration, experimental

--http_connector_attempts=<an integer> default: "8"

Jumlah maksimum upaya untuk download http.

Tag: bazel_internal_configuration

--http_connector_retry_max_timeout=<An immutable length of time.> default: "0s"

Waktu tunggu maksimum untuk percobaan ulang download http. Dengan nilai 0, tidak ada maksimum waktu tunggu yang ditentukan.

Tag: bazel_internal_configuration

--http_max_parallel_downloads=<an integer> default: "8"

Jumlah maksimum download http paralel.

Tag: bazel_internal_configuration

--http_timeout_scaling=<a double> default: "1.0"

Menskalakan semua waktu tunggu terkait download http dengan faktor yang diberikan

Tag: bazel_internal_configuration

--repo_contents_cache=<a path> default: lihat deskripsi

Menentukan lokasi cache konten repo, yang berisi direktori repo yang diambil dan dapat dibagikan di seluruh ruang kerja. String kosong sebagai argumen meminta agar cache konten repo dinonaktifkan, jika tidak, nilai default {--repository_cache}/contents akan digunakan. Perhatikan bahwa ini berarti menyetel --repository_cache= secara default akan menonaktifkan cache konten repo juga, kecuali jika --repo_contents_cache={some_path} juga disetel.

Tag: bazel_internal_configuration

--repo_contents_cache_gc_idle_delay=<An immutable length of time.> default: "5m"

Menentukan durasi waktu server harus tetap tidak ada aktivitas sebelum pengumpulan sampah terjadi ke cache konten repo.

Tag: bazel_internal_configuration

--repo_contents_cache_gc_max_age=<An immutable length of time.> default: "14d"

Menentukan berapa lama entri dalam cache konten repo dapat tetap tidak digunakan sebelum dikumpulkan sampah. Jika disetel ke nol, hanya entri duplikat yang akan dikumpulkan sampah.

Tag: bazel_internal_configuration

--repository_cache=<a path> default: lihat deskripsi

Menentukan lokasi cache nilai yang didownload yang diperoleh selama pengambilan repositori eksternal. String kosong sebagai argumen meminta agar cache dinonaktifkan, atau default {--output_user_root}/cache/repos/v1 akan digunakan.

Tag: bazel_internal_configuration

--[no]repository_disable_download default: "false"

Jika disetel, 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:
--experimental_ui_max_stdouterr_bytes=<an integer in (-1)-1073741819 range> default: "1048576"

Ukuran maksimum file stdout / stderr yang akan dicetak ke konsol. -1 berarti tidak ada batas.

Tag: execution

--gc_churning_threshold=<an integer in 0-100 range> default: "100"

Pada titik mana pun setelah pemanggilan berjalan setidaknya selama satu menit, jika Blaze telah menghabiskan setidaknya persentase waktu dinding pemanggilan ini untuk melakukan GC penuh, Blaze akan berhenti dan gagal dengan OOM. Nilai 100 secara efektif berarti tidak pernah menyerah karena alasan ini.

Tag: host_machine_resource_optimizations

--gc_churning_threshold_if_multiple_top_level_targets=<an integer> default: "-1"

Jika disetel ke nilai dalam [0, 100] dan ini adalah perintah yang mengambil target tingkat teratas (misalnya, build, tetapi bukan kueri) dan ada beberapa target tingkat teratas tersebut, akan menggantikan --gc_churning_threshold. Berguna untuk mengonfigurasi perilaku OOM yang lebih agresif (yaitu nilai yang lebih rendah daripada --gc_churning_threshold) saat ada beberapa target tingkat teratas sehingga pemanggil Bazel dapat membagi dan mencoba lagi sambil tetap memiliki perilaku yang kurang agresif saat ada satu target tingkat teratas.

Tag: host_machine_resource_optimizations

--gc_thrashing_threshold=<an integer in 0-100 range> default: "100"

Persen ruang yang ditempati (0-100) di atasnya GcThrashingDetector mempertimbangkan peristiwa tekanan memori terhadap batasnya (--gc_thrashing_limits). Jika disetel ke 100, GcThrashingDetector akan dinonaktifkan.

Tag: host_machine_resource_optimizations

Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
--[no]incompatible_enable_proto_toolchain_resolution default: "false"

Jika benar, aturan bahasa proto menentukan toolchain dari repositori protobuf.

Tag: loading_and_analysis, incompatible_change

Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, yang memengaruhi nilainya, bukan keberadaannya:
--bep_maximum_open_remote_upload_files=<an integer> default: "-1"

Jumlah maksimum file terbuka yang diizinkan selama upload artefak BEP.

Tag: affects_outputs

--[no]experimental_strict_repo_env default: "false"

Jika benar, aturan repositori dan ekstensi modul hanya akan mewarisi PATH, PATHEXT (di Windows), dan variabel lingkungan yang ditentukan secara eksplisit oleh --repo_env.

Perhatikan bahwa jika --incompatible_repo_env_ignores_action_env bernilai benar (true), --action_env=NAME=VALUE juga akan disertakan.

Tag: loading_and_analysis, experimental

--[no]incompatible_repo_env_ignores_action_env default: "true"

Jika benar (true), <code>--action_env=NAME=VALUE</code> tidak akan lagi memengaruhi lingkungan aturan repositori dan ekstensi modul.

Tag: loading_and_analysis, incompatible_change

--remote_download_all

Mendownload semua output jarak jauh ke komputer lokal. Flag ini adalah alias untuk --remote_download_outputs=all.

Meluas 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.

Meluas menjadi:
  --remote_download_outputs=minimal

Tag: affects_outputs

--remote_download_outputs=<all, minimal or toplevel> default: "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', akan berperilaku seperti 'minimal', tetapi juga mendownload output target tingkat teratas ke komputer lokal. Kedua opsi dapat mengurangi waktu build secara signifikan jika bandwidth jaringan menjadi hambatan.

Tag: affects_outputs

Daripada mendownload output build jarak jauh ke komputer lokal, buat link simbolis. Target link simbolis dapat ditentukan dalam bentuk string template. String template ini dapat berisi {hash} dan {size_bytes} yang masing-masing diperluas menjadi 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 level teratas ke komputer lokal. Flag ini adalah alias untuk --remote_download_outputs=toplevel.

Meluas menjadi:
  --remote_download_outputs=toplevel

Tag: affects_outputs

Penggunaan --repo_env=<a 'name[=value]' assignment with an optional value part or the special syntax '=name' to unset a variable> beberapa kali akan diakumulasikan

Menentukan variabel lingkungan tambahan yang hanya tersedia untuk aturan repositori. Perhatikan bahwa aturan repositori tetap melihat lingkungan lengkap, tetapi dengan cara ini, variabel dapat ditetapkan melalui flag command line dan entri <code>.bazelrc</code>. Sintaksis khusus <code>=NAME</code> dapat digunakan untuk membatalkan setelan variabel secara eksplisit. String <code>%bazel_workspace%</code> dalam nilai akan diganti dengan jalur absolut ruang kerja seperti yang dicetak oleh <code>bazel info workspace</code>.

Tag: action_command_lines

Opsi yang memengaruhi seberapa ketat Bazel menerapkan input build yang valid (definisi aturan, kombinasi tanda, dll.):
--[no]allow_experimental_loads default: "false"

Jika diaktifkan, hanya mengeluarkan peringatan, bukan error untuk pemuatan .bzls eksperimental.

Tag: build_file_semantics

--[no]check_bzl_visibility default: "true"

Jika dinonaktifkan, error visibilitas pemuatan .bzl akan diturunkan menjadi peringatan.

Tag: build_file_semantics

--[no]incompatible_enforce_starlark_utf8 default: "warning"

Jika diaktifkan (atau disetel ke 'error'), akan gagal jika file Starlark tidak dienkode UTF-8. Jika disetel ke 'warning', akan memunculkan peringatan. Jika disetel ke 'nonaktif', Bazel mengasumsikan bahwa file Starlark dienkode UTF-8, tetapi tidak memverifikasi asumsi ini. Perhatikan bahwa file Starlark yang tidak berenkode UTF-8 dapat menyebabkan Bazel berperilaku tidak konsisten.

Tag: loading_and_analysis, incompatible_change

Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]experimental_bzl_visibility default: "true"

Jika diaktifkan, menambahkan fungsi visibility() yang dapat dipanggil oleh file .bzl selama evaluasi tingkat teratas untuk menetapkan visibilitasnya untuk tujuan pernyataan load().

Tag: loading_and_analysis, experimental

--[no]experimental_cc_shared_library default: "false"

Jika disetel ke benar (true), atribut aturan dan metode Starlark API yang diperlukan untuk aturan cc_shared_library akan tersedia

Tag: build_file_semantics, loading_and_analysis, experimental

--[no]experimental_disable_external_package default: "false"

Jika disetel ke benar (true), paket //eksternal yang dibuat otomatis tidak akan tersedia lagi. Bazel tetap tidak dapat mengurai file 'external/BUILD', tetapi glob yang menjangkau external/ dari paket yang tidak disebutkan namanya akan berfungsi.

Tag: loading_and_analysis, loses_incremental_state, experimental

--[no]experimental_dormant_deps default: "false"

Jika ditetapkan ke benar (true), attr.label(materializer=), attr(for_dependency_resolution=), attr.dormant_label(), attr.dormant_label_list(), dan rule(for_dependency_resolution=) diizinkan.

Tag: build_file_semantics, experimental

--[no]experimental_enable_android_migration_apis default: "false"

Jika disetel ke benar (true), akan mengaktifkan API yang diperlukan untuk mendukung migrasi Android Starlark.

Tag: build_file_semantics

--[no]experimental_enable_first_class_macros default: "true"

Jika disetel ke benar (true), akan mengaktifkan konstruksi macro() untuk menentukan makro simbolis.

Tag: build_file_semantics

--[no]experimental_enable_scl_dialect default: "true"

Jika disetel ke benar (true), file .scl dapat digunakan dalam pernyataan load().

Tag: build_file_semantics

--[no]experimental_enable_starlark_set default: "true"

Jika benar (true), aktifkan jenis data set dan konstruktor set() di Starlark.

Tag: build_file_semantics, experimental

--[no]experimental_google_legacy_api default: "false"

Jika disetel ke benar (true), akan mengekspos sejumlah bagian eksperimental dari Starlark Build API yang berkaitan dengan kode lama Google.

Tag: loading_and_analysis, experimental

--[no]experimental_isolated_extension_usages default: "false"

Jika benar (true), mengaktifkan parameter <code>isolate</code> dalam fungsi <a href="https://bazel.build/rules/lib/globals/module#use_extension"><code>use_extension</code></a>.

Tag: loading_and_analysis

--[no]experimental_platforms_api default: "false"

Jika disetel ke benar (true), akan mengaktifkan sejumlah API Starlark terkait platform yang berguna untuk proses debug.

Tag: loading_and_analysis, experimental

--[no]experimental_repo_remote_exec default: "false"

Jika disetel ke benar (true), repository_rule akan mendapatkan beberapa kemampuan eksekusi jarak jauh.

Tag: build_file_semantics, loading_and_analysis, experimental

--[no]experimental_repository_ctx_execute_wasm default: "false"

Jika benar (true), metode repository_ctx load_wasm dan execute_wasm akan diaktifkan.

Tag: loading_and_analysis, experimental

--[no]experimental_sibling_repository_layout default: "false"

Jika disetel ke benar (true), repositori non-utama akan ditanam sebagai symlink ke repositori utama di root eksekusi. Artinya, semua repositori adalah turunan langsung dari direktori $output_base/execution_root. Hal ini memiliki efek samping mengosongkan $output_base/execution_root/main/external untuk direktori 'external' tingkat teratas yang sebenarnya.

Tag: action_command_lines, bazel_internal_configuration, loading_and_analysis, loses_incremental_state, experimental

--[no]experimental_single_package_toolchain_binding default: "false"

Jika diaktifkan, fungsi register_toolchain mungkin tidak menyertakan pola target yang dapat merujuk ke lebih dari satu paket.

Tag: loading_and_analysis, incompatible_change

--[no]experimental_starlark_type_checking default: "false"

Mengaktifkan pemeriksaan jenis dalam file dan fungsi yang berisi anotasi jenis atau sintaksis terkait. (Jika tanda ini dinonaktifkan, Bazel akan lebih toleran terhadap jenis yang tidak valid dalam anotasi jenis.)

Tag: loading_and_analysis, experimental

--[no]experimental_starlark_type_syntax default: "true"

Mengaktifkan anotasi jenis dan sintaksis terkait. Lokasi file yang diizinkan lebih dibatasi oleh --experimental_starlark_types_allowed_paths.

Tag: loading_and_analysis, experimental

--experimental_starlark_types_allowed_paths=<comma-separated list of options> default: ""

Daftar awalan Label kanonis yang diizinkan untuk anotasi jenis Starlark.

Tag: loading_and_analysis, experimental

--[no]force_starlark_stack_trace default: "false"

Jika --force_starlark_stack_trace=true, stack trace Starlark akan selalu dicetak dari panggilan ke fail(), termasuk yang biasanya disembunyikan dengan fail(..., stack_trace = False)

Tag: loading_and_analysis

--[no]incompatible_allow_tags_propagation default: "true"

Jika disetel ke benar (true), tag akan diteruskan dari target ke persyaratan eksekusi tindakan; jika tidak, tag tidak akan diteruskan. Lihat https://github.com/bazelbuild/bazel/issues/8830 untuk mengetahui detailnya.

Tag: build_file_semantics, experimental

--[no]incompatible_always_check_depset_elements default: "true"

Periksa validitas elemen yang ditambahkan ke depsets, di semua konstruktor. Elemen harus bersifat immutable, tetapi secara historis konstruktor depset(direct=...) lupa untuk memeriksa. Gunakan tuple, bukan daftar dalam elemen depset. Lihat https://github.com/bazelbuild/bazel/issues/10313 untuk mengetahui detailnya.

Tag: build_file_semantics, incompatible_change

--incompatible_autoload_externally=<comma-separated set of options> default: ""

Daftar aturan (atau simbol lain) yang dipisahkan koma yang sebelumnya merupakan bagian dari Bazel dan kini 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 digantikan oleh definisi kanonis barunya di repositori eksternal. Untuk file BUILD, ini pada dasarnya berarti menambahkan pernyataan load() secara implisit. Untuk file .bzl, ini bisa berupa pernyataan load() atau perubahan pada kolom objek native, bergantung pada apakah simbol yang dimuat otomatis adalah aturan. Bazel menyimpan daftar semua simbol yang dapat dimuat otomatis yang dikodekan secara permanen; hanya simbol tersebut yang dapat muncul di tanda ini. Untuk setiap simbol, Bazel mengetahui lokasi definisi baru di repositori eksternal, serta serangkaian repositori khusus yang tidak boleh memuatnya secara otomatis untuk menghindari pembuatan siklus. Item daftar "+foo" dalam tanda ini menyebabkan simbol foo dimuat otomatis, kecuali di repositori foo yang dikecualikan, yang di dalamnya versi foo yang ditentukan Bazel 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 dari foo Item daftar "-foo" tidak memicu pemuatan otomatis apa pun, tetapi membuat versi foo yang ditentukan Bazel tidak dapat diakses di seluruh ruang kerja. Ini digunakan untuk memvalidasi bahwa ruang kerja siap untuk menghapus definisi foo dari Bazel. Jika simbol tidak diberi nama dalam tanda ini, simbol akan terus berfungsi seperti biasa -- tidak ada pemuatan otomatis yang dilakukan, dan versi yang ditentukan Bazel tidak dihentikan. 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 juga dapat digunakan, misalnya +@rules_python akan memuat otomatis semua aturan Python.

Tag: loses_incremental_state, build_file_semantics, incompatible_change

--[no]incompatible_disable_autoloads_in_main_repo default: "true"

Mengontrol apakah pemuatan otomatis (ditetapkan oleh --incompatible_autoload_externally) diaktifkan di repositori utama. Jika diaktifkan, aturan (atau simbol lain) yang sebelumnya merupakan bagian dari Bazel harus memiliki pernyataan pemuatan. Gunakan buildifier untuk menambahkannya.

Tag: loading_and_analysis, incompatible_change

--[no]incompatible_disable_objc_library_transition default: "true"

Menonaktifkan transisi kustom objc_library dan mewarisi dari target tingkat teratas (No-op di Bazel)

Tag: build_file_semantics, incompatible_change

--[no]incompatible_disable_starlark_host_transitions default: "false"

Jika disetel ke benar (true), atribut aturan tidak dapat menyetel 'cfg = "host"'. Sebagai gantinya, aturan harus menetapkan 'cfg = "exec"'.

Tag: loading_and_analysis, incompatible_change

--[no]incompatible_disable_target_default_provider_fields default: "false"

Jika disetel ke benar (true), nonaktifkan kemampuan untuk menggunakan penyedia default melalui sintaksis kolom. Gunakan sintaksis provider-key. Misalnya, alih-alih menggunakan ctx.attr.dep.files untuk mengakses files, gunakan `ctx.attr.dep[DefaultInfo].files Lihat https://github.com/bazelbuild/bazel/issues/9014 untuk mengetahui detailnya.

Tag: build_file_semantics, incompatible_change

--incompatible_disable_transitions_on=<comma-separated set of options> default: ""

Daftar tanda yang dipisahkan koma yang tidak dapat digunakan dalam input atau output transisi.

Tag: loading_and_analysis, incompatible_change, non_configurable

--[no]incompatible_disallow_ctx_resolve_tools default: "true"

Jika disetel ke benar (true), panggilan API ctx.resolve_tools yang tidak digunakan lagi akan selalu gagal. Penggunaan API ini harus diganti dengan argumen yang dapat dieksekusi atau alat ke ctx.actions.run atau ctx.actions.run_shell.

Tag: loading_and_analysis, incompatible_change

--[no]incompatible_disallow_empty_glob default: "true"

Jika disetel ke benar (true), nilai default argumen allow_empty dari glob() adalah Salah (False).

Tag: build_file_semantics, incompatible_change

--[no]incompatible_enable_deprecated_label_apis default: "true"

Jika diaktifkan, API tertentu yang sudah tidak digunakan lagi (native.repository_name, Label.workspace_name, Label.relative) dapat digunakan.

Tag: loading_and_analysis

--[no]incompatible_fail_on_unknown_attributes default: "true"

Jika diaktifkan, target yang memiliki atribut tidak diketahui yang disetel ke None akan gagal.

Tag: loading_and_analysis, incompatible_change

--[no]incompatible_fix_package_group_reporoot_syntax default: "true"

Dalam atribut packages package_group, mengubah 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. Flag ini mengharuskan --incompatible_package_group_has_public_syntax juga diaktifkan.

Tag: build_file_semantics, incompatible_change

--[no]incompatible_locations_prefers_executable default: "true"

Apakah target yang menyediakan file yang dapat dieksekusi diperluas ke file yang dapat dieksekusi, bukan file di <code>DefaultInfo.files</code> di bawah perluasan $(locations ...), jika jumlah file bukan 1.

Tag: loading_and_analysis, incompatible_change

--[no]incompatible_no_attr_license default: "true"

Jika disetel ke benar (true), fungsi attr.license akan dinonaktifkan.

Tag: build_file_semantics, incompatible_change

--[no]incompatible_no_implicit_file_export default: "false"

Jika disetel, file sumber (yang digunakan) bersifat pribadi dalam 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

--[no]incompatible_no_implicit_watch_label default: "true"

Jika benar, metode pada <code>repository_ctx</code> yang meneruskan Label tidak akan lagi otomatis memantau perubahan file dengan label tersebut 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

--[no]incompatible_no_rule_outputs_param default: "false"

Jika disetel ke benar (true), parameter outputs dari fungsi Starlark rule() akan dinonaktifkan.

Tag: build_file_semantics, incompatible_change

--[no]incompatible_package_group_has_public_syntax default: "true"

Pada atribut packages package_group, Anda dapat menulis "public" atau "private" untuk merujuk ke semua paket atau tidak ada paket.

Tag: build_file_semantics, incompatible_change

--[no]incompatible_resolve_select_keys_eagerly default: "false"

Jika diaktifkan, kunci string dalam dict yang diteruskan ke select() dalam file .bzl akan segera diselesaikan ke Label relatif terhadap file, bukan ditafsirkan relatif terhadap file BUILD yang akhirnya dimuat.

Tag: 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

--[no]incompatible_simplify_unconditional_selects_in_rule_attrs default: "true"

Jika benar, sederhanakan atribut aturan yang dapat dikonfigurasi yang hanya berisi pilihan tanpa syarat; misalnya, jika ["a"] + select("//conditions:default", ["b"]) ditetapkan ke atribut aturan, atribut tersebut akan disimpan sebagai ["a", "b"]. Opsi ini tidak memengaruhi atribut makro simbolis atau nilai default atribut.

Tag: build_file_semantics, incompatible_change

--[no]incompatible_stop_exporting_build_file_path default: "false"

Jika disetel ke benar (true), ctx.build_file_path yang tidak digunakan lagi tidak akan tersedia. ctx.label.package + '/BUILD' dapat digunakan sebagai gantinya.

Tag: loading_and_analysis, incompatible_change

--[no]incompatible_stop_exporting_language_modules default: "false"

Jika diaktifkan, modul khusus bahasa tertentu (seperti cc_common) tidak tersedia di file .bzl pengguna dan hanya dapat dipanggil dari repositori aturan masing-masing.

Tag: loading_and_analysis, incompatible_change

--[no]incompatible_unambiguous_label_stringification default: "true"

Jika benar, Bazel akan mengubah label @//foo:bar menjadi string @//foo:bar, bukan //foo:bar. Hal ini hanya memengaruhi perilaku str(), operator %, dan sebagainya; perilaku repr() tidak berubah. Lihat https://github.com/bazelbuild/bazel/issues/15916 untuk mengetahui informasi selengkapnya.

Tag: loading_and_analysis, incompatible_change

--[no]incompatible_use_cc_configure_from_rules_cc default: "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

--max_computation_steps=<a long integer> default: "0"

Jumlah maksimum langkah komputasi Starlark yang dapat dieksekusi oleh file BUILD (nol berarti tidak ada batasan).

Tag: build_file_semantics

--nested_set_depth_limit=<an integer> default: "3500"

Kedalaman maksimum grafik internal ke depset (juga dikenal sebagai NestedSet), yang di atasnya konstruktor depset() akan gagal.

Tag: loading_and_analysis

--repositories_without_autoloads=<comma-separated set of options> default: ""

Daftar repositori tambahan (di luar repositori yang dikodekan secara permanen yang diketahui Bazel) tempat pemuatan otomatis tidak boleh ditambahkan. Biasanya, file ini berisi repositori yang bergantung secara transitif pada repositori yang dapat dimuat secara otomatis (dan yang oleh karena itu berpotensi membuat siklus).

Tag: loses_incremental_state, build_file_semantics, incompatible_change

Opsi yang terkait dengan output dan semantik Bzlmod:
Penggunaan --allow_yanked_versions=<a string> beberapa kali akan diakumulasikan

Menentukan versi modul dalam bentuk {module1}@{version1},module2@{version2} yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan dibatalkan di registry tempat versi tersebut berasal (jika versi tersebut tidak berasal dari NonRegistryOverride). Jika tidak, versi yang dibatalkan akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang tidak diizinkan dengan variabel lingkungan BZLMOD_ALLOW_YANKED_VERSIONS. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci all (tidak disarankan).

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 meningkatkannya menjadi kegagalan penyelesaian, off untuk menonaktifkan pemeriksaan, atau warning untuk mencetak peringatan saat ketidakcocokan terdeteksi.

Tag: loading_and_analysis

--check_direct_dependencies=<off, warning or error> default: "warning"

Periksa apakah dependensi bazel_dep langsung yang dideklarasikan dalam modul root adalah versi yang sama dengan yang Anda dapatkan dalam grafik dependensi yang diselesaikan. Nilai yang valid adalah off untuk menonaktifkan pemeriksaan, warning untuk mencetak peringatan saat ketidakcocokan terdeteksi, atau error untuk meningkatkannya menjadi kegagalan penyelesaian.

Tag: loading_and_analysis

--[no]ignore_dev_dependency default: "false"

Jika benar, Bazel akan mengabaikan bazel_dep dan use_extension yang dideklarasikan sebagai dev_dependency di MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan dalam 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 memperbaruinya jika ada perubahan, refresh untuk memperbarui informasi yang dapat diubah (versi yang dibatalkan dan modul yang sebelumnya tidak ada) dari registry jarak jauh dari waktu ke waktu, error untuk menggunakan file kunci, tetapi menampilkan error jika file tersebut tidak terbaru, atau off untuk tidak membaca atau menulis ke file kunci.

Tag: loading_and_analysis

Penggunaan --module_mirrors=<a '[name=]value1[,..,valueN]' assignment> beberapa kali akan diakumulasikan

Menentukan URL tempat URL sumber modul Bazel dapat ditemukan, selain dan lebih diutamakan daripada URL mirror yang disediakan oleh registry. Flag ini dapat ditentukan per-registry menggunakan sintaksis --module_mirrors=<registry>=<mirror1>[,<mirror2>,...] (misalnya, --module_mirrors=https://bcr.bazel.build=https://mirror.example.com). Setelan ini juga dapat ditentukan sebagai daftar URL mirror yang dipisahkan koma dan berlaku untuk semua registri yang tidak memiliki daftar eksplisit (misalnya, --module_mirrors=https://mirror1,https://mirror2). Tetapkan ini ke nilai kosong untuk menonaktifkan penggunaan mirror yang tidak ditentukan oleh registri. Penggunaan flag ini selanjutnya akan menggantikan penggunaan sebelumnya dengan registri yang sama (atau tidak ada). Set default mirror dapat berubah dari waktu ke waktu, tetapi semua download dari mirror diverifikasi oleh hash yang disimpan dalam registry (dan dengan demikian disematkan oleh lockfile).

Tag: loading_and_analysis

Penggunaan --override_module=<an equals-separated mapping of module name to path> beberapa kali akan diakumulasikan

Ganti modul dengan jalur lokal dalam bentuk {module name}={path}. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan 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 dari bazel info workspace. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.

Penggunaan --registry=<a string> beberapa kali akan diakumulasikan

Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari terlebih dahulu di registry sebelumnya, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry sebelumnya.

Tag: changes_inputs

--vendor_dir=<a path> default: lihat deskripsi

Menentukan direktori yang harus menyimpan repositori eksternal dalam mode vendor, baik untuk tujuan mengambilnya ke dalam direktori tersebut atau menggunakannya saat membangun. Jalur dapat ditentukan sebagai jalur absolut atau jalur yang terkait dengan direktori ruang kerja.

Tag: loading_and_analysis

Opsi yang memicu pengoptimalan waktu build:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> default: "1s:2,20s:3,1m:5"

Membatasi yang, jika tercapai, akan menyebabkan GcThrashingDetector mengalami error pada Bazel dengan OOM. Setiap batas ditentukan sebagai <periode>:<jumlah> dengan periode adalah durasi dan jumlah adalah bilangan bulat positif. Jika lebih dari --gc_thrashing_threshold persen ruang yang sudah dialokasikan (heap gen lama) tetap terisi setelah <count> GC penuh berturut-turut dalam <period>, OOM akan dipicu. Beberapa batas dapat ditentukan dan dipisahkan dengan koma.

Tag: host_machine_resource_optimizations

--[no]heuristically_drop_nodes default: "false"

Jika benar, Blaze akan menghapus node FileState dan DirectoryListingState setelah node File dan DirectoryListing terkait selesai untuk menghemat memori. Kami memperkirakan bahwa node ini tidak akan diperlukan lagi. Jika demikian, program akan mengevaluasi ulang.

Tag: loses_incremental_state

--[no]incompatible_do_not_split_linking_cmdline default: "true"

Jika benar (true), Bazel tidak lagi mengubah tanda command line yang digunakan untuk menghubungkan, dan juga tidak secara selektif memutuskan tanda mana yang masuk ke file param dan mana yang tidak. Lihat https://github.com/bazelbuild/bazel/issues/7670 untuk mengetahui detailnya.

Tag: loading_and_analysis, incompatible_change

--[no]keep_state_after_build default: "true"

Jika salah (false), Blaze akan menghapus status dalam memori dari build ini saat build selesai. Build berikutnya tidak akan memiliki inkrementalitas sehubungan dengan build ini.

Tag: loses_incremental_state

--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0> default: "10"

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 beberapa kali per pemanggilan. Defaultnya adalah 10. 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 tersebut terlampaui.

Tag: host_machine_resource_optimizations

--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> default: "10"

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 kecil terjadi, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan, hingga beberapa kali per pemanggilan. Defaultnya adalah 10. Nol berarti peristiwa GC kecil tidak akan pernah memicu penurunan. Jika batas tercapai, status Skyframe tidak akan lagi dihilangkan saat peristiwa GC kecil terjadi dan batas persentase heap yang dipertahankan tersebut terlampaui.

Tag: host_machine_resource_optimizations

--skyframe_high_water_mark_threshold=<an integer> default: "85"

Flag untuk konfigurasi lanjutan mesin Skyframe internal Bazel. Jika Bazel mendeteksi penggunaan persentase heap yang dipertahankan setidaknya berada di batas ini, Bazel akan menghapus status Skyframe sementara yang tidak diperlukan. Mengubah setelan ini dapat membantu Anda mengurangi dampak waktu nyata dari thrashing GC, saat thrashing GC (i) disebabkan oleh penggunaan memori status sementara ini dan (ii) lebih mahal daripada merekonstitusi status saat diperlukan.

Tag: host_machine_resource_optimizations

--[no]track_incremental_state default: "true"

Jika salah (false), Blaze tidak akan mempertahankan data yang memungkinkan pembatalan 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 menyetel ini ke salah (false).

Tag: loses_incremental_state

Opsi yang memengaruhi panjang respons, format, atau lokasi logging:
--[no]announce_rc default: "false"

Apakah akan mengumumkan opsi rc.

Tag: affects_outputs

--[no]attempt_to_print_relative_paths default: "false"

Saat mencetak bagian lokasi pesan, coba gunakan jalur relatif ke direktori ruang kerja atau salah satu direktori yang ditentukan oleh --package_path.

Tag: terminal_output

--bes_backend=<a string> default: ""

Menentukan endpoint backend layanan peristiwa build (BES) dalam 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

--[no]bes_check_preceding_lifecycle_events default: "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

Penggunaan --bes_header=<a 'name=value' assignment> beberapa kali akan diakumulasikan

Tentukan header dalam bentuk NAME=VALUE yang akan disertakan dalam permintaan BES. Beberapa header dapat diteruskan dengan menentukan tanda beberapa kali. Beberapa nilai untuk nama yang sama akan dikonversi menjadi daftar yang dipisahkan koma.

Tag: affects_outputs

--bes_instance_name=<a string> default: lihat deskripsi

Menentukan nama instance yang digunakan BES untuk menyimpan BEP yang diupload. Nilai defaultnya adalah null.

Tag: affects_outputs

Penggunaan --bes_keywords=<comma-separated list of options> beberapa kali akan 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). Defaultnya adalah tidak ada.

Tag: affects_outputs

--[no]bes_lifecycle_events default: "true"

Menentukan apakah akan memublikasikan peristiwa siklus proses BES. (defaultnya adalah 'true').

Tag: affects_outputs

--bes_oom_finish_upload_timeout=<An immutable length of time.> default: "10m"

Menentukan berapa lama bazel harus menunggu hingga upload BES/BEP selesai saat OOMing. Flag ini memastikan penghentian saat JVM mengalami thrashing GC parah dan tidak dapat memproses thread pengguna.

Tag: bazel_monitoring

--bes_outerr_buffer_size=<an integer> default: "10240"

Menentukan ukuran maksimal stdout atau stderr yang akan di-buffer di BEP, sebelum dilaporkan sebagai peristiwa progres. Penulisan individual masih dilaporkan dalam satu peristiwa, meskipun lebih besar dari nilai yang ditentukan hingga --bes_outerr_chunk_size.

Tag: affects_outputs

--bes_outerr_chunk_size=<an integer> default: "1048576"

Menentukan ukuran maksimal stdout atau stderr yang akan dikirim ke BEP dalam satu pesan.

Tag: affects_outputs

--bes_proxy=<a string> default: lihat deskripsi

Hubungkan ke Layanan Peristiwa Build melalui proxy. Saat ini, tanda ini hanya dapat digunakan untuk mengonfigurasi soket domain Unix (unix:/path/to/socket).

--bes_results_url=<a string> default: ""

Menentukan URL dasar tempat pengguna dapat melihat informasi yang di-streaming ke backend BES. Bazel akan menampilkan URL yang ditambahkan oleh ID pemanggilan ke terminal.

Tag: terminal_output

Penggunaan --bes_system_keywords=<comma-separated list of options> beberapa kali akan diakumulasikan

Menentukan daftar kata kunci notifikasi yang akan disertakan secara langsung, tanpa awalan user_keyword= yang disertakan untuk kata kunci yang diberikan melalui --bes_keywords. Ditujukan untuk operator layanan Build yang menetapkan --bes_lifecycle_events=false dan menyertakan kata kunci saat memanggil PublishLifecycleEvent. Operator layanan build yang menggunakan tanda ini harus mencegah pengguna mengganti nilai tanda.

Tag: affects_outputs

--bes_timeout=<An immutable length of time.> default: "0s"

Menentukan berapa lama bazel harus menunggu hingga upload BES/BEP selesai setelah build dan pengujian selesai. Waktu tunggu yang valid adalah bilangan asli yang diikuti dengan unit: Hari (d), jam (h), menit (m), detik (s), dan milidetik (ms). Nilai defaultnya adalah 0 yang berarti tidak ada waktu tunggu.

Tag: affects_outputs

--bes_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async> default: "wait_for_upload_complete"

Menentukan apakah upload Build Event Service harus memblokir penyelesaian build atau harus mengakhiri pemanggilan segera dan menyelesaikan upload di latar belakang.

  • wait_for_upload_complete: memblokir di akhir pemanggilan saat ini hingga semua peristiwa (termasuk peristiwa siklus proses jika berlaku) diupload dan dikonfirmasi oleh backend.
  • nowait_for_upload_complete: memblokir di awal pemanggilan berikutnya hingga semua peristiwa (termasuk peristiwa siklus proses jika berlaku) diupload dan dikonfirmasi oleh backend.
  • fully_async: memblokir di awal pemanggilan berikutnya hingga semua peristiwa diupload, tetapi tidak menunggu konfirmasi. Peristiwa dapat hilang jika terjadi kegagalan (sementara) dan backend dapat melaporkan aliran sebagai tidak lengkap dalam mode ini. Tidak ada jaminan bahwa peristiwa siklus proses FinishInvocationAttempt atau FinishBuild akan dikirim.

Tag: eagerness_to_exit

--build_event_binary_file=<a string> default: ""

Jika tidak kosong, tulis representasi biner yang dibatasi varint dari representasi protokol peristiwa build ke file tersebut. Opsi ini menyiratkan --bes_upload_mode=wait_for_upload_complete.

Tag: affects_outputs

--[no]build_event_binary_file_path_conversion default: "true"

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

--build_event_binary_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async> default: "wait_for_upload_complete"

Menentukan apakah upload Build Event Service untuk --build_event_binary_file harus memblokir penyelesaian build atau harus mengakhiri pemanggilan segera dan menyelesaikan upload di latar belakang. wait_for_upload_complete (default), nowait_for_upload_complete, atau fully_async.

Tag: eagerness_to_exit

--build_event_json_file=<a string> default: ""

Jika tidak kosong, tulis serialisasi JSON dari protokol peristiwa build ke file tersebut. Opsi ini menyiratkan --bes_upload_mode=wait_for_upload_complete.

Tag: affects_outputs

--[no]build_event_json_file_path_conversion default: "true"

Mengonversi jalur dalam representasi file JSON dari protokol peristiwa build menjadi URI yang lebih valid secara global jika memungkinkan; jika dinonaktifkan, skema URI file:// akan selalu digunakan

Tag: affects_outputs

--build_event_json_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async> default: "wait_for_upload_complete"

Menentukan apakah upload Build Event Service untuk --build_event_json_file harus memblokir penyelesaian build atau harus mengakhiri pemanggilan segera dan menyelesaikan upload di latar belakang. wait_for_upload_complete (default), nowait_for_upload_complete, atau fully_async.

Tag: eagerness_to_exit

--build_event_max_named_set_of_file_entries=<an integer> default: "5000"

Jumlah maksimum entri untuk satu peristiwa named_set_of_files; nilai yang lebih kecil dari 2 akan diabaikan dan tidak ada pemisahan peristiwa yang dilakukan. Tujuannya adalah untuk membatasi ukuran peristiwa maksimum dalam protokol peristiwa build, meskipun tidak mengontrol ukuran peristiwa secara langsung. Ukuran total peristiwa adalah fungsi dari struktur set serta panjang file dan URI, yang pada gilirannya dapat bergantung pada fungsi hash.

Tag: affects_outputs

--[no]build_event_publish_all_actions default: "false"

Apakah semua tindakan harus dipublikasikan.

Tag: affects_outputs

--build_event_text_file=<a string> default: ""

Jika tidak kosong, tulis representasi tekstual protokol peristiwa build ke file tersebut

Tag: affects_outputs

--[no]build_event_text_file_path_conversion default: "true"

Mengonversi jalur dalam representasi file teks dari protokol peristiwa build menjadi URI yang lebih valid secara global jika memungkinkan; jika dinonaktifkan, skema URI file:// akan selalu digunakan

Tag: affects_outputs

--build_event_text_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async> default: "wait_for_upload_complete"

Menentukan apakah upload Build Event Service untuk --build_event_text_file harus memblokir penyelesaian build atau harus mengakhiri pemanggilan segera dan menyelesaikan upload di latar belakang. wait_for_upload_complete (default), nowait_for_upload_complete, atau fully_async.

Tag: eagerness_to_exit

--build_event_upload_max_retries=<an integer> default: "4"

Jumlah maksimum percobaan ulang Bazel untuk mengupload peristiwa build.

Tag: bazel_internal_configuration

--[no]experimental_bep_target_summary default: "false"

Apakah akan memublikasikan peristiwa TargetSummary.

--[no]experimental_build_event_expand_filesets default: "false"

Jika benar, luaskan Fileset di BEP saat menampilkan file output.

Tag: affects_outputs

Penggunaan --experimental_build_event_output_group_mode=<an output group name followed by an OutputGroupFileMode, e.g. default=both> beberapa kali akan diakumulasikan

Tentukan cara file grup output akan ditampilkan dalam peristiwa BEP TargetComplete/AspectComplete. Nilai adalah penetapan nama grup output ke salah satu dari NAMED_SET_OF_FILES_ONLY, INLINE_ONLY, atau BOTH. Nilai defaultnya adalah NAMED_SET_OF_FILES_ONLY. Jika grup output diulang, nilai akhir yang akan muncul akan digunakan. Nilai default menetapkan mode untuk artefak cakupan ke BOTH: --experimental_build_event_output_group_mode=baseline.lcov=both

Tag: affects_outputs

--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.> default: "1s"

Penundaan awal minimum untuk percobaan ulang backoff eksponensial saat upload BEP gagal. (eksponen: 1,6)

Tag: bazel_internal_configuration

--experimental_build_event_upload_strategy=<a string> default: lihat deskripsi

Memilih cara mengupload artefak yang dirujuk dalam protokol peristiwa build. Di Bazel, opsi yang valid mencakup local dan remote. Nilai defaultnya adalah local.

Tag: affects_outputs

--[no]experimental_collect_load_average_in_profiler default: "true"

Jika diaktifkan, profiler akan mengumpulkan rata-rata beban keseluruhan sistem.

Tag: bazel_monitoring

--[no]experimental_collect_pressure_stall_indicators default: "false"

Jika diaktifkan, profiler akan mengumpulkan data PSI Linux.

Tag: bazel_monitoring

--[no]experimental_collect_resource_estimation default: "false"

Jika diaktifkan, profiler akan mengumpulkan estimasi penggunaan CPU dan memori untuk tindakan lokal.

Tag: bazel_monitoring

--[no]experimental_collect_skyframe_counts_in_profiler default: "false"

Jika diaktifkan, profiler akan mengumpulkan jumlah SkyFunction dalam grafik Skyframe dari waktu ke waktu untuk jenis fungsi utama, seperti target yang dikonfigurasi dan eksekusi tindakan. Mungkin berdampak pada performa karena mengunjungi SELURUH grafik Skyframe pada setiap unit waktu pembuatan profil. Jangan gunakan flag ini dengan pengukuran yang mementingkan performa.

Tag: bazel_monitoring

--[no]experimental_collect_system_network_usage default: "true"

Jika diaktifkan, profiler akan mengumpulkan penggunaan jaringan sistem.

Tag: bazel_monitoring

--[no]experimental_collect_worker_data_in_profiler default: "true"

Jika diaktifkan, profiler akan mengumpulkan data resource gabungan pekerja.

Tag: bazel_monitoring

--experimental_command_profile=<cpu, wall, alloc or lock> default: lihat deskripsi

Merekam profil Java Flight Recorder selama durasi perintah. Salah satu jenis peristiwa pembuatan profil yang didukung (cpu, wall, alloc, atau lock) harus diberikan sebagai argumen. Profil ditulis ke file yang dinamai 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.

Penggunaan --experimental_profile_additional_tasks=<phase, action, discover_inputs, action_check, action_lock, action_update, action_complete, action_rewinding, bzlmod, info, create_package, remote_execution, local_execution, scanner, local_parse, upload_time, remote_process_time, remote_queue, remote_setup, fetch, local_process_time, vfs_stat, vfs_dir, vfs_readlink, vfs_md5, vfs_xattr, vfs_delete, vfs_open, vfs_read, vfs_write, vfs_glob, vfs_vmfs_stat, vfs_vmfs_dir, vfs_vmfs_read, wait, thread_name, thread_sort_index, skyframe_eval, skyfunction, critical_path, critical_path_component, handle_gc_notification, local_action_counts, starlark_parser, starlark_user_fn, starlark_builtin_fn, starlark_user_compiled_fn, starlark_repository_fn, starlark_thread_context, 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, conflict_check, dynamic_lock, repository_fetch, repository_vendor, repo_cache_gc_wait, spawn_log, rpc, skycache, wasm_load, wasm_exec or unknown> beberapa kali akan diakumulasikan

Menentukan tugas profil tambahan yang akan disertakan dalam profil.

Tag: bazel_monitoring

--[no]experimental_profile_include_primary_output default: "false"

Mencakup atribut "out" tambahan dalam peristiwa tindakan yang berisi jalur exec ke output utama tindakan.

Tag: bazel_monitoring

--[no]experimental_profile_include_target_configuration default: "false"

Menyertakan hash konfigurasi target dalam data profil JSON peristiwa tindakan.

Tag: bazel_monitoring

--[no]experimental_profile_include_target_label default: "false"

Menyertakan label target dalam data profil JSON peristiwa tindakan.

Tag: bazel_monitoring

--[no]experimental_record_metrics_for_all_mnemonics default: "false"

Mengontrol output BEP ActionSummary dan BuildGraphMetrics, membatasi jumlah mnemonik dalam ActionData dan jumlah entri yang dilaporkan dalam BuildGraphMetrics.AspectCount/RuleClassCount. Secara default, jumlah jenis dibatasi hingga 20 teratas, berdasarkan jumlah tindakan yang dijalankan untuk ActionData, dan instance untuk RuleClass dan Asepcts. Menetapkan opsi ini akan menulis statistik untuk semua mnemonik, class aturan, dan aspek.

--[no]experimental_record_skyframe_metrics default: "false"

Mengontrol output BEP BuildGraphMetrics, termasuk metrik Skyframe yang mahal untuk dihitung tentang Skykeys, RuleClasses, dan Aspects.Jika tanda ini disetel ke salah (false), BuildGraphMetrics.rule_count dan aspectfields tidak akan diisi di BEP.

--[no]experimental_run_bep_event_include_residue default: "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

--[no]experimental_stream_log_file_uploads default: "false"

Mengupload file log streaming langsung ke penyimpanan jarak jauh, bukan menuliskannya ke disk.

Tag: affects_outputs

--experimental_workspace_rules_log_file=<a path> default: lihat deskripsi

Mencatat peristiwa Aturan Workspace tertentu ke dalam file ini sebagai proto WorkspaceEvent yang dibatasi.

--[no]generate_json_trace_profile default: "auto"

Jika diaktifkan, Bazel akan membuat profil build dan menulis profil format JSON ke dalam file di dasar output. Lihat profil dengan memuatnya ke chrome://tracing. Secara default, Bazel menulis profil untuk semua perintah dan kueri seperti build.

Tag: bazel_monitoring

--[no]heap_dump_on_oom default: "false"

Apakah akan menghasilkan dump heap secara manual jika terjadi OOM (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

--jvm_heap_histogram_internal_object_pattern=<a valid Java regular expression> default: "jdk\.internal\.vm\.Filler.+"

Regex untuk mengganti logika pencocokan pengumpulan memori heap JVM JDK21+. Kami mengandalkan detail implementasi GC G1 internal yang tidak stabil untuk mendapatkan metrik memori yang bersih. Opsi ini memungkinkan kami beradaptasi dengan perubahan dalam implementasi internal tersebut tanpa harus menunggu rilis biner. Diteruskan ke JDK Matcher.find()

--[no]legacy_important_outputs default: "false"

Gunakan ini untuk menekan pembuatan kolom important_outputs lama di peristiwa TargetComplete. important_outputs diperlukan untuk integrasi Bazel ke ResultStore/BTX.

Tag: affects_outputs

--logging=<0 <= an integer <= 6> default: "3"

Level logging.

Tag: affects_outputs

--memory_profile=<a path> default: lihat deskripsi

Jika disetel, tulis data penggunaan memori ke file yang ditentukan di akhir fase dan heap stabil ke log utama di akhir build.

Tag: bazel_monitoring

--memory_profile_stable_heap_parameters=<integers, separated by a comma expected in pairs> default: "1,0"

Sesuaikan komputasi profil memori heap stabil di akhir build. Harus berupa bilangan bulat genap yang dipisahkan dengan koma. Dalam setiap pasangan, bilangan bulat pertama adalah jumlah GC yang akan dilakukan. Bilangan bulat kedua dalam setiap pasangan adalah jumlah detik untuk menunggu di antara GC. Contoh: 2,4,4,0 akan menghasilkan 2 GC dengan jeda 4 detik, diikuti dengan 4 GC dengan jeda nol detik

Tag: bazel_monitoring

--profile=<a path> default: lihat deskripsi

Jika disetel, profil Bazel dan tulis data ke file yang ditentukan. Lihat https://bazel.build/advanced/performance/json-trace-profile untuk mengetahui informasi selengkapnya.

Tag: bazel_monitoring

--profiles_to_retain=<an integer> default: "5"

Jumlah profil yang akan dipertahankan dalam basis output. Jika ada lebih dari jumlah profil ini di dasar output, profil terlama akan dihapus hingga totalnya berada di bawah batas.

Tag: bazel_monitoring

--[no]record_full_profiler_data default: "false"

Secara default, profiler Bazel hanya akan merekam data gabungan untuk peristiwa yang cepat tetapi banyak (seperti statting file). Jika opsi ini diaktifkan, profiler akan merekam setiap peristiwa - sehingga menghasilkan data pembuatan profil yang lebih akurat, tetapi berdampak BESAR pada performa. Opsi hanya berlaku jika --profile juga digunakan.

Tag: bazel_monitoring

--[no]redirect_local_instrumentation_output_writes default: "false"

Jika benar dan didukung, output instrumentasi akan dialihkan untuk ditulis secara lokal di komputer yang berbeda dengan tempat bazel berjalan.

Tag: bazel_monitoring

--remote_print_execution_messages=<failure, success or all> default: "failure"

Pilih kapan pesan eksekusi jarak jauh akan dicetak. Nilai yang valid adalah failure, untuk mencetak hanya jika gagal, success untuk mencetak hanya jika berhasil, dan all untuk selalu mencetak.

Tag: terminal_output

--[no]slim_profile default: "true"

Memperkecil ukuran profil JSON dengan menggabungkan peristiwa jika profil terlalu besar.

Tag: bazel_monitoring

--starlark_cpu_profile=<a string> default: ""

Menulis profil pprof penggunaan CPU oleh semua thread Starlark ke dalam file yang ditentukan.

Tag: bazel_monitoring

--tool_tag=<a string> default: ""

Nama alat untuk mengatribusikan pemanggilan Bazel ini.

Tag: affects_outputs, bazel_monitoring

Penggunaan --ui_event_filters=<Convert list of comma separated event kind to list of filters> beberapa kali akan diakumulasikan

Menentukan peristiwa mana yang akan ditampilkan di UI. Anda dapat menambahkan atau menghapus acara ke acara default menggunakan +/- di awal, atau mengganti sepenuhnya set default dengan penetapan langsung. Kumpulan jenis peristiwa yang didukung mencakup INFO, DEBUG, ERROR, dan lainnya.

Tag: terminal_output

--[no]write_command_log default: "false"

Apakah akan menulis file command.log atau tidak

Tag: bazel_monitoring

Opsi eksekusi dan caching jarak jauh:
Penggunaan --downloader_config=<a path> beberapa kali akan diakumulasikan

Tentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing dimulai dengan direktif (allow, block, atau rewrite) yang 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. Beberapa direktif rewrite untuk URL yang sama dapat diberikan, dan dalam hal ini beberapa URL akan ditampilkan.

--experimental_circuit_breaker_strategy=<failure> default: lihat deskripsi

Menentukan strategi yang akan digunakan untuk pemutus sirkuit. Strategi yang tersedia adalah "kegagalan". Jika nilai opsi tidak valid, perilakunya sama seperti opsi tidak ditetapkan.

Tag: execution

--experimental_remote_cache_compression_threshold=<an integer> default: "100"

Ukuran blob minimum yang diperlukan untuk mengompresi/mendekompresi dengan zstd. Tidak efektif kecuali jika --remote_cache_compression ditetapkan.

--[no]experimental_remote_cache_lease_extension default: "false"

Jika disetel ke benar (true), Bazel akan memperpanjang masa berlaku 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.

--experimental_remote_cache_ttl=<An immutable length of time.> default: "3h"

TTL minimal yang dijamin untuk blob 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

--experimental_remote_capture_corrupted_outputs=<a path> default: lihat deskripsi

Jalur ke direktori tempat output yang rusak akan direkam.

--[no]experimental_remote_discard_merkle_trees default: "true"

Jika disetel ke benar (true), hapus salinan dalam memori dari pohon Merkle input root dan pemetaan input terkait selama panggilan ke GetActionResult() dan Execute(). Hal ini mengurangi penggunaan memori secara signifikan, tetapi mengharuskan Bazel menghitung ulang salinan tersebut saat terjadi error cache jarak jauh dan percobaan ulang.

--experimental_remote_downloader=<a string> default: lihat deskripsi

URI endpoint Remote Asset API, yang akan digunakan sebagai proxy download jarak jauh. Skema yang didukung adalah grpc, grpcs (grpc dengan TLS diaktifkan), dan unix (soket UNIX lokal). Jika tidak ada skema yang diberikan, Bazel akan menggunakan grpcs secara default. Lihat: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto

--[no]experimental_remote_downloader_local_fallback default: "false"

Apakah akan kembali ke downloader lokal jika downloader jarak jauh gagal.

--[no]experimental_remote_downloader_propagate_credentials default: "false"

Apakah akan menyebarkan kredensial dari netrc dan credential helper ke server downloader jarak jauh. Implementasi server harus mendukung kualifikasi http_header_url:<url-index>:<header-key> baru dengan <url-index> adalah posisi berbasis 0 dari URL di dalam kolom uris FetchBlobRequest. Header khusus URL harus lebih diutamakan daripada header global.

--experimental_remote_failure_rate_threshold=<an integer in 0-100 range> default: "10"

Menetapkan jumlah tingkat kegagalan yang diizinkan dalam persentase untuk jangka waktu tertentu setelah itu berhenti memanggil cache/pelaksana jarak jauh. Secara default, nilainya adalah 10. Jika disetel ke 0, tidak ada batasan.

Tag: execution

--experimental_remote_failure_window_interval=<An immutable length of time.> default: "60s"

Interval saat tingkat kegagalan permintaan jarak jauh dihitung. Jika nilai nol atau negatif, durasi kegagalan dihitung selama durasi eksekusi.Unit berikut dapat digunakan: Hari (d), jam (h), menit (m), detik (s), dan milidetik (ms). Jika unit tidak disertakan, nilai akan ditafsirkan sebagai detik.

Tag: execution

--[no]experimental_remote_mark_tool_inputs default: "false"

Jika disetel ke benar (true), Bazel akan menandai input sebagai input alat untuk eksekutor jarak jauh. Hal ini dapat digunakan untuk menerapkan pekerja persisten jarak jauh.

--experimental_remote_output_service=<a string> default: lihat deskripsi

HOST atau HOST:PORT endpoint layanan output jarak jauh. Skema yang didukung adalah grpc, grpcs (grpc dengan TLS diaktifkan), dan unix (soket UNIX lokal). Jika tidak ada skema yang diberikan, Bazel akan menggunakan grpcs secara default. Tentukan skema grpc:// atau unix: untuk menonaktifkan TLS.

--experimental_remote_output_service_output_path_prefix=<a string> default: ""

Jalur tempat konten direktori output yang dikelola oleh --experimental_remote_output_service ditempatkan. Direktori output sebenarnya yang digunakan oleh build akan menjadi turunan dari jalur ini dan ditentukan oleh layanan output.

--[no]experimental_remote_require_cached default: "false"

Jika disetel ke benar (true), terapkan agar semua tindakan yang dapat dijalankan dari jarak jauh di-cache, atau gagal membangun. Hal ini berguna untuk memecahkan masalah non-deterministik karena memungkinkan pemeriksaan apakah tindakan yang harus di-cache benar-benar di-cache tanpa secara keliru menyuntikkan hasil baru ke dalam cache.

--experimental_remote_scrubbing_config=<Converts to a Scrubber> default: lihat deskripsi

Mengaktifkan penghapusan kunci cache jarak jauh dengan file konfigurasi yang diberikan, yang harus berupa buffer protokol dalam format teks (lihat src/main/protobuf/remote_scrubbing.proto).

Fitur ini dimaksudkan untuk memfasilitasi berbagi cache disk/jarak jauh antara tindakan yang dieksekusi di platform yang berbeda, tetapi menargetkan platform yang sama. Fitur ini harus digunakan dengan sangat hati-hati, karena setelan yang tidak tepat dapat menyebabkan berbagi entri cache yang tidak disengaja dan menghasilkan build yang salah.

Menyaring tidak memengaruhi cara tindakan dieksekusi, hanya cara kunci cache disk/jaraknya dihitung untuk tujuan mengambil atau menyimpan hasil tindakan. Tindakan yang dibersihkan tidak kompatibel dengan eksekusi jarak jauh, dan akan selalu dieksekusi secara lokal.

Memodifikasi konfigurasi scrubbing tidak membatalkan output yang ada di sistem file lokal atau cache internal; build bersih diperlukan untuk mengeksekusi ulang tindakan yang terpengaruh.

Agar berhasil menggunakan fitur ini, Anda sebaiknya menetapkan --host_platform kustom bersama dengan --experimental_platform_in_output_dir (untuk menormalisasi awalan output).

Default --[no]guard_against_concurrent_changes: "lite"

Tetapkan ini ke 'full' untuk mengaktifkan pemeriksaan ctime semua file input tindakan sebelum menguploadnya ke cache jarak jauh. Mungkin ada kasus saat kernel Linux menunda penulisan file, yang dapat menyebabkan positif palsu. Defaultnya adalah 'lite', yang hanya memeriksa file sumber di repositori utama. Menyetelnya ke 'nonaktif' akan menonaktifkan semua pemeriksaan. Hal ini tidak direkomendasikan, karena cache dapat tercemar saat file sumber diubah saat tindakan yang mengambilnya sebagai input sedang dieksekusi.

Tag: execution

--[no]remote_accept_cached default: "true"

Apakah akan menerima hasil tindakan yang di-cache dari jarak jauh.

--remote_build_event_upload=<all or minimal> default: "minimal"

Jika disetel ke 'all', semua output lokal yang dirujuk oleh BEP akan diupload ke cache jarak jauh. Jika disetel ke 'minimal', output lokal yang dirujuk oleh BEP tidak diupload ke cache jarak jauh, kecuali untuk file yang penting bagi konsumen BEP (misalnya, log pengujian dan profil pengaturan waktu). Skema bytestream:// selalu digunakan untuk URI file meskipun file tersebut tidak ada di cache jarak jauh. Nilai defaultnya adalah 'minimal'.

--remote_bytestream_uri_prefix=<a string> default: lihat deskripsi

Nama host dan nama instance yang akan digunakan dalam URI bytestream:// yang ditulis ke dalam aliran peristiwa build. Opsi ini dapat 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 disetel, defaultnya adalah "${hostname}/${instance_name}".

--remote_cache=<a string> default: lihat deskripsi

URI endpoint caching. 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 menggunakan grpcs secara default. Tentukan skema grpc://, http://, atau unix: untuk menonaktifkan TLS. Lihat https://bazel.build/remote/caching

--[no]remote_cache_async default: "true"

Jika benar, upload hasil tindakan ke disk atau cache jarak jauh akan terjadi di latar belakang, bukan memblokir penyelesaian tindakan. Beberapa tindakan tidak kompatibel dengan upload di latar belakang, dan mungkin tetap memblokir meskipun tanda ini disetel.

--[no]remote_cache_compression default: "false"

Jika diaktifkan, kompres/dekompresi blob cache dengan zstd jika ukurannya minimal --experimental_remote_cache_compression_threshold.

Penggunaan --remote_cache_header=<a 'name=value' assignment> beberapa kali akan 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.

Penggunaan --remote_default_exec_properties=<a 'name=value' assignment> beberapa kali akan diakumulasikan

Menetapkan properti eksekusi default yang akan digunakan sebagai platform eksekusi jarak jauh jika platform eksekusi belum menetapkan exec_properties.

Tag: affects_outputs

Penggunaan --remote_download_regex=<a valid Java regular expression> beberapa kali akan diakumulasikan

Memaksa output build jarak jauh yang jalur filenya cocok dengan pola ini untuk didownload, terlepas dari --remote_download_outputs. Beberapa pola dapat ditentukan dengan mengulangi tanda ini.

Tag: affects_outputs

Penggunaan --remote_downloader_header=<a 'name=value' assignment> beberapa kali akan diakumulasikan

Tentukan header yang akan disertakan dalam permintaan pengunduh jarak jauh: --remote_downloader_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.

Penggunaan --remote_exec_header=<a 'name=value' assignment> beberapa kali akan 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.

--remote_execution_priority=<an integer> default: "0"

Prioritas relatif tindakan yang akan dieksekusi dari jarak jauh. Semantik nilai prioritas tertentu bergantung pada server.

--remote_executor=<a string> default: lihat deskripsi

HOST atau HOST:PORT endpoint eksekusi jarak jauh. Skema yang didukung adalah grpc, grpcs (grpc dengan TLS diaktifkan), dan unix (soket UNIX lokal). Jika tidak ada skema yang diberikan, Bazel akan menggunakan grpcs secara default. Tentukan skema grpc:// atau unix: untuk menonaktifkan TLS.

--remote_grpc_log=<a path> default: lihat deskripsi

Jika ditentukan, jalur ke file untuk mencatat detail terkait panggilan gRPC. Log ini terdiri dari urutan protobuf com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry yang diserialisasi dengan setiap pesan yang diawali dengan varint yang menunjukkan ukuran pesan protobuf yang diserialisasi berikutnya, seperti yang dilakukan oleh metode LogEntry.writeDelimitedTo(OutputStream).

Penggunaan --remote_header=<a 'name=value' assignment> beberapa kali akan diakumulasikan

Tentukan header yang akan disertakan dalam permintaan: --remote_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_instance_name=<a string> default: ""

Nilai yang akan diteruskan sebagai instance_name di API eksekusi jarak jauh.

--[no]remote_local_fallback default: "false"

Apakah akan melakukan fallback ke strategi eksekusi lokal mandiri jika eksekusi jarak jauh gagal.

--remote_local_fallback_strategy=<a string> default: "local"

Tidak digunakan lagi. Lihat https://github.com/bazelbuild/bazel/issues/7480 untuk mengetahui detailnya.

--remote_max_concurrency_per_connection=<an integer> default: "100"

Batasi jumlah maksimum permintaan serentak per koneksi gRPC. Secara default, nilainya adalah 100.

Tag: host_machine_resource_optimizations

--remote_max_connections=<an integer> default: "100"

Membatasi jumlah maksimum koneksi serentak ke cache/pelaksana jarak jauh. Secara default, nilainya adalah 100. Jika disetel ke 0, 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/pelaksana jarak jauh gRPC, satu saluran gRPC biasanya dapat menangani 100+ permintaan serentak (dikontrol oleh --remote_max_concurrency_per_connection), sehingga Bazel dapat membuat sekitar --remote_max_connections * 100 permintaan serentak.

Tag: host_machine_resource_optimizations

--remote_proxy=<a string> default: lihat deskripsi

Hubungkan ke cache jarak jauh melalui proxy. Saat ini, tanda ini hanya dapat digunakan untuk mengonfigurasi soket domain Unix (unix:/path/to/socket).

--remote_result_cache_priority=<an integer> default: "0"

Prioritas relatif tindakan jarak jauh yang akan disimpan dalam cache jarak jauh. Semantik nilai prioritas tertentu bergantung pada server.

--remote_retries=<an integer> default: "5"

Jumlah maksimum upaya untuk mencoba ulang error sementara. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.

--remote_retry_max_delay=<An immutable length of time.> default: "5s"

Penundaan backoff maksimum antara upaya percobaan ulang jarak jauh. Unit berikut dapat digunakan: Hari (d), jam (h), menit (m), detik (s), dan milidetik (ms). Jika unit tidak disertakan, nilai akan ditafsirkan sebagai detik.

--remote_timeout=<An immutable length of time.> default: "60s"

Jumlah waktu maksimum untuk menunggu eksekusi jarak jauh dan panggilan cache. Untuk cache REST, ini adalah waktu tunggu koneksi dan baca. Unit berikut dapat digunakan: Hari (d), jam (h), menit (m), detik (s), dan milidetik (ms). Jika unit tidak disertakan, nilai akan ditafsirkan sebagai detik.

--[no]remote_upload_local_results default: "true"

Apakah akan mengupload hasil tindakan yang dieksekusi secara lokal ke cache jarak jauh jika cache jarak jauh mendukungnya dan pengguna diizinkan untuk melakukannya.

--[no]remote_verify_downloads default: "true"

Jika disetel ke benar (true), Bazel akan menghitung jumlah hash semua download jarak jauh dan membuang nilai yang di-cache dari jarak jauh jika tidak cocok dengan nilai yang diharapkan.

Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
Penggunaan --build_metadata=<a 'name=value' assignment> beberapa kali akan diakumulasikan

Pasangan string nilai kunci kustom yang akan diberikan dalam peristiwa build.

Tag: terminal_output

--color=<yes, no or auto> default: "auto"

Gunakan kontrol terminal untuk mewarnai output.

Penggunaan --config=<a string> beberapa kali akan diakumulasikan

Memilih bagian konfigurasi tambahan dari file rc; untuk setiap <command>, opsi juga ditarik dari <command>:<config> jika bagian tersebut ada; jika bagian ini tidak ada di file .rc mana pun, Blaze akan gagal dengan error. Bagian konfigurasi dan kombinasi flag yang setara dengannya terletak di file konfigurasi tools/*.blazerc.

Penggunaan --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 kali akan diakumulasikan

Mengonfigurasi helper kredensial yang sesuai dengan Spesifikasi Helper Kredensial untuk digunakan dalam mengambil kredensial otorisasi untuk pengambilan repositori, caching 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 auth ke repository_ctx.download() dan repository_ctx.download_and_extract().

Dapat ditentukan beberapa kali untuk menyiapkan beberapa helper.

Lihat Mengonfigurasi Credential Helper Bazel - Blog Engflow untuk mengetahui petunjuknya.

--credential_helper_cache_duration=<An immutable length of time.> default: "30m"

Berapa lama kredensial di-cache jika helper kredensial tidak menampilkan waktu habis masa berlaku. Mengubah nilai flag ini akan menghapus cache.

--credential_helper_timeout=<An immutable length of time.> default: "10s"

Mengonfigurasi waktu tunggu untuk helper kredensial.

Helper kredensial yang gagal merespons dalam waktu tunggu ini akan menyebabkan kegagalan pemanggilan.

--curses=<yes, no or auto> default: "auto"

Gunakan kontrol kursor terminal untuk meminimalkan output scrolling.

--disk_cache=<a path> default: lihat deskripsi

Jalur ke direktori tempat Bazel dapat membaca dan menulis tindakan serta output tindakan. Jika tidak ada, direktori akan dibuat.

--[no]enable_platform_specific_config default: "false"

Jika benar, Bazel akan mengambil baris konfigurasi khusus OS host 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 tanda ini sama dengan menggunakan --config=linux di Linux, --config=windows di Windows, dll.

--experimental_action_cache_gc_idle_delay=<An immutable length of time.> default: "5m"

Durasi server harus tetap tidak ada aktivitas sebelum pengumpulan sampah cache tindakan dicoba. Tidak efektif kecuali --experimental_action_cache_gc_max_age bukan nol.

Tag: host_machine_resource_optimizations

--experimental_action_cache_gc_max_age=<An immutable length of time.> default: "0"

Jika disetel ke nilai bukan nol, cache tindakan akan secara berkala dikumpulkan sampah untuk menghapus entri yang lebih lama dari usia ini. Pengumpulan sampah terjadi di latar belakang setelah server menjadi tidak aktif, sebagaimana ditentukan oleh tanda --experimental_action_cache_gc_idle_delay dan --experimental_action_cache_gc_threshold.

Tag: host_machine_resource_optimizations

--experimental_action_cache_gc_threshold=<an integer in 0-100 range> default: "10"

Persentase entri cache tindakan usang yang diperlukan agar pembersihan sampah memori dipicu. Tidak efektif kecuali --experimental_action_cache_gc_max_age bukan nol.

Tag: host_machine_resource_optimizations

--experimental_disk_cache_gc_idle_delay=<An immutable length of time.> default: "5m"

Durasi server harus tetap tidak ada aktivitas sebelum pengumpulan sampah cache disk terjadi. Untuk menentukan kebijakan pengumpulan sampah, tetapkan --experimental_disk_cache_gc_max_size dan/atau --experimental_disk_cache_gc_max_age.

--experimental_disk_cache_gc_max_age=<An immutable length of time.> default: "0"

Jika disetel ke nilai positif, cache disk akan dibersihkan sampah memori 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. Pengumpulan sampah terjadi di latar belakang setelah server menjadi tidak aktif, sebagaimana ditentukan oleh tanda --experimental_disk_cache_gc_idle_delay.

--experimental_disk_cache_gc_max_size=<a size in bytes, optionally followed by a K, M, G or T multiplier> default: "0"

Jika disetel ke nilai positif, cache disk akan secara berkala dikumpulkan sampah untuk tetap berada di bawah ukuran ini. Jika disetel bersama dengan --experimental_disk_cache_gc_max_age, kedua kriteria akan diterapkan. Pengumpulan sampah terjadi di latar belakang setelah server menjadi tidak aktif, sebagaimana ditentukan oleh tanda --experimental_disk_cache_gc_idle_delay.

--[no]experimental_enable_thread_dump default: "false"

Apakah akan mengaktifkan thread dump atau tidak. Jika benar, Bazel akan mencatat status semua thread (termasuk thread virtual) ke file setiap --experimental_thread_dump_interval, atau setelah eksekusi tindakan tidak aktif selama --experimental_thread_dump_action_execution_inactivity_duration. Dump akan ditulis ke direktori <output_base>/server/thread_dumps/.

Tag: bazel_monitoring

Default --experimental_install_base_gc_max_age=<An immutable length of time.>: "30d"

Berapa lama basis penginstalan tidak boleh digunakan sebelum memenuhi syarat untuk pengumpulan sampah. Jika bukan nol, server akan mencoba mengumpulkan sampah basis penginstalan lain saat tidak ada aktivitas.

Tag: host_machine_resource_optimizations

--[no]experimental_rule_extension_api default: "true"

Mengaktifkan API ekstensi aturan eksperimental dan API subaturan

Tag: loading_and_analysis, experimental

--experimental_thread_dump_action_execution_inactivity_duration=<An immutable length of time.> default: "0"

Buang thread saat eksekusi tindakan tidak aktif selama durasi ini. Jika nol, tidak ada dump thread yang ditulis untuk eksekusi tindakan yang tidak aktif.

Tag: bazel_monitoring

--experimental_thread_dump_interval=<An immutable length of time.> default: "0"

Seberapa sering thread harus di-dump secara berkala. Jika nol, tidak ada dump thread yang ditulis secara berkala.

Tag: bazel_monitoring

--[no]experimental_windows_watchfs default: "false"

Jika benar (true), dukungan Windows eksperimental untuk --watchfs akan diaktifkan. Jika tidak, --watchfs adalah non-op di Windows. Pastikan untuk mengaktifkan --watchfs juga.

--google_auth_scopes=<comma-separated list of options> default: "https://www.googleapis.com/auth/cloud-platform"

Daftar cakupan autentikasi Google Cloud yang dipisahkan koma.

--google_credentials=<a string> default: lihat deskripsi

Menentukan file untuk mendapatkan kredensial autentikasi. Lihat https://cloud.google.com/docs/authentication untuk mengetahui detailnya.

--[no]google_default_credentials default: "false"

Apakah akan menggunakan 'Kredensial Default Aplikasi Google' untuk autentikasi. Lihat Metode autentikasi di Google - Google Cloud untuk mengetahui detailnya. Dinonaktifkan secara default.

--grpc_keepalive_time=<An immutable length of time.> default: "60s"

Mengonfigurasi ping keep-alive untuk koneksi gRPC keluar. Jika disetel, Bazel akan mengirimkan ping setelah tidak ada operasi baca pada koneksi selama jangka waktu ini, tetapi hanya jika ada setidaknya satu panggilan gRPC yang tertunda. Nilai 0 akan menonaktifkan keep-alive.

--grpc_keepalive_timeout=<An immutable length of time.> default: "20s"

Mengonfigurasi waktu tunggu tetap aktif untuk koneksi gRPC keluar. Jika ping tetap aktif diaktifkan dengan --grpc_keepalive_time, Bazel akan menghentikan koneksi jika tidak menerima respons ping setelah jangka waktu ini. Waktu diperlakukan sebagai perincian detik; error jika menetapkan nilai kurang dari satu detik. Jika ping keep-alive dinonaktifkan, setelan ini akan diabaikan.

--[no]incompatible_disable_non_executable_java_binary default: "false"

Jika benar, java_binary selalu dapat dieksekusi. Atribut create_executable dihapus.

Tag: loading_and_analysis, incompatible_change

Penggunaan --inject_repository=<an equals-separated mapping of repository name to path> beberapa kali akan diakumulasikan

Menambahkan repositori baru dengan jalur lokal dalam bentuk {repository name}={path}. Tindakan ini hanya berlaku dengan --enable_bzlmod dan setara dengan menambahkan local_repository yang sesuai ke file MODULE.bazel modul root melalui use_repo_rule. 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 dari bazel info workspace. Jika jalur yang diberikan kosong, hapus injeksi sebelumnya.

--invocation_id=<a UUID> default: ""

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

Penggunaan --override_repository=<an equals-separated mapping of repository name to path> beberapa kali akan diakumulasikan

Ganti repositori dengan jalur lokal dalam bentuk {repository name}={path}, dengan nama repositori dapat berupa nama kanonis atau nama yang terlihat dari sudut pandang repositori utama.

Perhatikan bahwa jika tanda ini digunakan untuk mengganti repositori modul, perubahan pada file MODULE.bazel tidak akan efektif jika modul diperoleh dari registry. Sebagai gantinya, gunakan --override_module untuk tujuan tersebut.

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 dari bazel info workspace. Jika jalur yang diberikan kosong, hapus penggantian sebelumnya.

--[no]progress_in_terminal_title default: "false"

Menampilkan progres perintah di judul terminal. Berguna untuk melihat apa yang dilakukan bazel saat memiliki beberapa tab terminal.

--[no]show_progress default: "true"

Menampilkan pesan progres selama build.

--show_progress_rate_limit=<a double> default: "0.2"

Jumlah minimum detik antara pesan progres dalam output.

--[no]show_timestamps default: "false"

Menyertakan stempel waktu dalam pesan

--tls_certificate=<a string> default: lihat deskripsi

Tentukan jalur ke sertifikat TLS yang dipercaya untuk menandatangani sertifikat server.

--tls_client_certificate=<a string> default: lihat deskripsi

Tentukan sertifikat klien TLS yang akan digunakan; Anda juga perlu memberikan kunci klien untuk mengaktifkan autentikasi klien.

--tls_client_key=<a string> default: lihat deskripsi

Tentukan kunci klien TLS yang akan digunakan; Anda juga perlu memberikan sertifikat klien untuk mengaktifkan autentikasi klien.

--ui_actions_shown=<an integer> default: "8"

Jumlah tindakan serentak yang ditampilkan di status progres mendetail; setiap tindakan ditampilkan di baris terpisah. Status progres selalu menampilkan setidaknya satu, semua angka kurang dari 1 dipetakan ke 1.

Tag: terminal_output

--[no]watchfs default: "false"

Di Linux/macOS: Jika benar (true), bazel akan mencoba menggunakan layanan pemantauan file sistem operasi untuk perubahan lokal, bukan memindai setiap file untuk mencari perubahan. Di Windows: saat ini tanda ini tidak beroperasi, tetapi dapat diaktifkan bersama dengan --experimental_windows_watchfs. Di OS apa pun: Perilakunya tidak ditentukan jika ruang kerja Anda berada di sistem file jaringan, dan file diedit di mesin jarak jauh.

Opsi Aquery

Mewarisi semua opsi dari build.

Opsi yang terkait dengan output dan semantik kueri:
--aspect_deps=<off, conservative or precise> default: "conservative" (konservatif)

Cara menyelesaikan dependensi aspek saat format output adalah salah satu dari {xml,proto,record}. 'off' berarti tidak ada dependensi aspek yang diselesaikan, 'conservative' (default) berarti semua dependensi aspek yang dideklarasikan ditambahkan terlepas dari apakah dependensi tersebut diberi class aturan dependensi langsung, 'precise' berarti hanya aspek yang mungkin aktif yang ditambahkan mengingat class aturan dependensi langsung. Perhatikan bahwa mode presisi memerlukan pemuatan paket lain untuk mengevaluasi satu target sehingga lebih lambat daripada mode lainnya. Perhatikan juga bahwa meskipun mode presisi tidak sepenuhnya presisi: keputusan apakah akan menghitung aspek diputuskan dalam fase analisis, yang tidak dijalankan selama 'bazel query'.

Tag: build_file_semantics

--[no]consistent_labels default: "false"

Jika diaktifkan, setiap perintah kueri akan memancarkan label seolah-olah dengan fungsi <code>str</code> Starlark 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 dapat memancarkan nama repositori yang jelas (relatif terhadap repositori utama) untuk membuat output lebih mudah dibaca.

Tag: terminal_output

--[no]experimental_explicit_aspects default: "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 dikeluarkan 'terfaktor', yaitu node yang setara secara topologi akan digabungkan dan labelnya digabungkan. Opsi ini hanya berlaku untuk --output=graph.

Tag: terminal_output

--graph:node_limit=<an integer> default: "512"

Panjang maksimum string label untuk node grafik dalam output. Label yang lebih panjang akan dipotong; -1 berarti tidak ada pemotongan. Opsi ini hanya berlaku untuk --output=graph.

Tag: terminal_output

--[no]implicit_deps default: "true"

Jika diaktifkan, dependensi implisit akan disertakan dalam grafik dependensi tempat kueri 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 telah diselesaikan.

Tag: build_file_semantics

--[no]include_artifacts default: "true"

Mencakup nama input dan output tindakan dalam output (berpotensi besar).

Tag: terminal_output

--[no]include_aspects default: "true"

aquery, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: no-op (aspek selalu diikuti).

Tag: terminal_output

--[no]include_commandline default: "true"

Mencakup konten baris perintah tindakan dalam output (berpotensi besar).

Tag: terminal_output

--[no]include_file_write_contents default: "false"

Sertakan konten file untuk tindakan FileWrite, SourceSymlinkManifest, dan RepoMappingManifest (berpotensi besar).

Tag: terminal_output

--[no]include_param_files default: "false"

Sertakan konten file param yang digunakan dalam perintah (berpotensi besar). Catatan: Mengaktifkan flag ini akan otomatis mengaktifkan flag --include_commandline.

Tag: terminal_output

--[no]include_pruned_inputs default: "true"

Mencakup input tindakan yang dipangkas selama eksekusi tindakan. Hanya memengaruhi tindakan yang menemukan input dan telah dieksekusi dalam pemanggilan sebelumnya. Hanya berlaku jika --include_artifacts juga ditetapkan.

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

--[no]infer_universe_scope default: "false"

Jika ditetapkan dan --universe_scope tidak ditetapkan, maka 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 semesta (misalnya,allrdeps) mungkin tidak sesuai dengan 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

--[no]line_terminator_null default: "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 "visibility". Jalankan dan uraikan output info build-language untuk mempelajari semua atribut "nodep" dalam bahasa build.

Tag: build_file_semantics

--output=<a string> default: "text"

Format hasil aquery yang akan dicetak. Nilai yang diizinkan untuk aquery adalah: text, textproto, proto, streamed_proto, jsonproto.

Tag: terminal_output

--output_file=<a string> default: ""

Jika ditentukan, hasil kueri akan ditulis langsung ke file ini, dan tidak ada yang akan dicetak ke aliran output standar (stdout) Bazel. Dalam tolok ukur, hal ini umumnya lebih cepat daripada <code>bazel query > file</code>.

Tag: terminal_output

--[no]proto:default_values default: "true"

Jika benar (true), atribut yang nilainya tidak ditentukan secara eksplisit dalam file BUILD akan disertakan; jika tidak, atribut tersebut akan dihilangkan. Opsi ini berlaku untuk --output=proto

Tag: terminal_output

--[no]proto:definition_stack default: "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 satu kali. Jenis skalar diratakan menjadi null.

Tag: build_file_semantics

--[no]proto:include_attribute_source_aspects default: "false"

Isi kolom proto source_aspect_name setiap Atribut dengan aspek sumber yang berasal dari atribut tersebut (string kosong jika tidak ada).

Tag: terminal_output

--[no]proto:include_starlark_rule_env default: "true"

Gunakan lingkungan starlark dalam nilai atribut $internal_attr_hash yang dihasilkan. Hal ini memastikan bahwa definisi aturan starlark (dan impor transitifnya) adalah bagian dari ID ini.

Tag: terminal_output

--[no]proto:include_synthetic_attribute_hash default: "false"

Apakah akan menghitung dan mengisi atribut $internal_attr_hash atau tidak.

Tag: terminal_output

--[no]proto:instantiation_stack default: "false"

Mengisi stack panggilan instansiasi setiap aturan. Perhatikan bahwa hal ini memerlukan kehadiran stack

Tag: terminal_output

--[no]proto:locations default: "true"

Apakah akan menampilkan informasi lokasi dalam output proto atau tidak.

Tag: terminal_output

--proto:output_rule_attrs=<comma-separated list of options> default: "all"

Daftar atribut yang dipisahkan koma untuk disertakan dalam output. Secara default, semua atribut akan ditampilkan. Setel ke string kosong agar tidak menampilkan atribut apa pun. Opsi ini berlaku untuk --output=proto.

Tag: terminal_output

--[no]proto:rule_classes default: "false"

Isi kolom rule_class_key setiap aturan; dan untuk aturan pertama dengan rule_class_key tertentu, isi juga kolom proto rule_class_info-nya. Kolom rule_class_key secara unik mengidentifikasi class aturan, dan kolom rule_class_info adalah definisi API class aturan berformat Stardoc.

Tag: terminal_output

--[no]proto:rule_inputs_and_outputs default: "true"

Apakah kolom rule_input dan rule_output akan diisi atau tidak.

Tag: terminal_output

--query_file=<a string> default: ""

Jika disetel, kueri akan membaca kueri dari file yang diberi nama di sini, bukan di command line. Menentukan file di sini serta kueri command line adalah suatu kesalahan.

Tag: changes_inputs

--[no]relative_locations default: "false"

Jika benar (true), 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 menyetel opsi ini ke benar (true) untuk mendapatkan hasil yang konsisten di seluruh perangkat.

Tag: terminal_output

--[no]skyframe_state default: "false"

Tanpa melakukan analisis tambahan, buang Action Graph saat ini dari Skyframe. Catatan: Menentukan target dengan --skyframe_state saat ini tidak didukung. Flag ini hanya tersedia dengan --output=proto atau --output=textproto.

Tag: terminal_output

--[no]tool_deps default: "true"

Kueri: Jika dinonaktifkan, dependensi pada 'konfigurasi exec' tidak akan disertakan dalam grafik dependensi yang digunakan kueri. Edge dependensi 'konfigurasi exec', seperti yang berasal dari aturan 'proto_library' ke Pengompilasi Protokol, biasanya mengarah ke alat yang dijalankan 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 ada dalam konfigurasi target, hanya target yang dikonfigurasi yang juga ada 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 diselesaikan.

Tag: build_file_semantics

--universe_scope=<comma-separated list of options> default: ""

Kumpulan pola target yang dipisahkan koma (aditif dan subtraktif). Kueri dapat dilakukan di 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 yang digunakan untuk membuat semua jawaban, sehingga opsi ini dapat memengaruhi konfigurasi dan transisi. Jika opsi ini tidak ditentukan, target tingkat teratas 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 dibangun dengan opsi tingkat teratas.

Tag: loading_and_analysis

Opsi yang mengontrol eksekusi build:
--[no]experimental_persistent_aar_extractor default: "false"

Aktifkan pengekstrak aar persisten menggunakan pekerja.

Tag: execution, experimental

--[no]experimental_remotable_source_manifests default: "false"

Apakah tindakan manifes sumber dapat dilakukan dari jarak jauh

Tag: loading_and_analysis, execution, experimental

--[no]experimental_split_coverage_postprocessing default: "false"

Jika benar, Bazel akan menjalankan pemrosesan pasca-cakupan untuk pengujian di proses baru.

Tag: execution, experimental

--[no]experimental_strict_fileset_output default: "false"

Jika opsi ini diaktifkan, set file akan memperlakukan semua artefak output sebagai file biasa. File tidak akan melintasi direktori atau sensitif terhadap symlink.

Tag: execution, experimental

--[no]incompatible_modify_execution_info_additive default: "true"

Jika diaktifkan, meneruskan beberapa tanda --modify_execution_info bersifat aditif. Jika dinonaktifkan, hanya tanda terakhir yang akan dipertimbangkan.

Tag: execution, affects_outputs, loading_and_analysis, incompatible_change

Penggunaan --modify_execution_info=<regex=[+-]key,regex=[+-]key,...> beberapa kali akan diakumulasikan

Menambahkan atau menghapus kunci dari info eksekusi tindakan berdasarkan mnemonik tindakan. Hanya berlaku untuk tindakan yang mendukung info eksekusi. Banyak tindakan umum yang mendukung info eksekusi, misalnya Genrule, CppCompile, Javac, StarlarkAction, TestRunner. Saat menentukan beberapa nilai, urutan penting karena banyak ekspresi reguler dapat berlaku untuk mnemonik yang sama.

Sintaksis: regex=[+-]key,regex=[+-]key,....

Contoh:

  • .*=+x,.*=-y,.*=+z menambahkan x dan z ke, serta 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 persisten menggunakan pekerja.

Meluas 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 dengan menggunakan pekerja.

Meluas 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

Aktifkan tindakan desugar dan dex Android multiplex persisten menggunakan pekerja.

Meluas 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 yang di-multiplex secara persisten menggunakan pekerja.

Diluaskan 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

Aktifkan alat Android persisten dan yang di-multiplex (dexing, desugaring, pemrosesan resource).

Meluas menjadi:
  --internal_persistent_multiplex_busybox_tools
  --persistent_multiplex_android_resource_processor
  --persistent_multiplex_android_dex_desugar

Tag: host_machine_resource_optimizations, execution

--[no]use_target_platform_for_tests default: "false"

Jika benar (true), gunakan platform target untuk menjalankan pengujian, bukan grup eksekusi pengujian.

Tag: execution

Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
--android_compiler=<a string> default: lihat deskripsi

Compiler target Android.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state

--android_manifest_merger=<legacy, android or force_android> default: "android"

Memilih penggabung manifes yang akan digunakan untuk aturan android_binary. Flag untuk membantu transisi ke penggabung manifes Android dari penggabung lama.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state

--android_platforms=<a build target label> default: ""

Menetapkan platform yang digunakan oleh target android_binary. Jika beberapa platform ditentukan, maka biner adalah APK gemuk, yang berisi biner native untuk setiap platform target yang ditentukan.

Tag: changes_inputs, loading_and_analysis, loses_incremental_state

--cc_output_directory_tag=<a string> default: ""

Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.

Tag: affects_outputs

--compiler=<a string> default: lihat deskripsi

Compiler C++ yang akan digunakan untuk mengompilasi target.

Tag: loading_and_analysis, execution

--coverage_output_generator=<a build target label> default: "@bazel_tools//tools/test:lcov_merger"

Lokasi biner yang digunakan untuk memproses laporan cakupan mentah. Target ini harus berupa biner. Default-nya adalah @bazel_tools//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. Target ini harus berupa biner. Default-nya adalah @bazel_tools//tools/test:coverage_report_generator.

Tag: changes_inputs, affects_outputs, loading_and_analysis

--coverage_support=<a build target label> default: "@bazel_tools//tools/test:coverage_support"

Lokasi file dukungan yang diperlukan pada input setiap tindakan pengujian yang mengumpulkan cakupan kode. Default-nya adalah //tools/test:coverage_support.

Tag: changes_inputs, affects_outputs, loading_and_analysis

--custom_malloc=<a build target label> default: lihat deskripsi

Menentukan implementasi malloc kustom. Setelan ini menggantikan atribut malloc dalam aturan build.

Tag: changes_inputs, affects_outputs

--[no]experimental_include_xcode_execution_requirements default: "false"

Jika disetel, tambahkan persyaratan eksekusi "requires-xcode:{version}" ke setiap tindakan Xcode. Jika versi Xcode memiliki label bergaris hubung, tambahkan juga persyaratan eksekusi "requires-xcode-label:{version_label}".

Tag: loses_incremental_state, loading_and_analysis, execution, experimental

--[no]experimental_prefer_mutual_xcode default: "true"

Jika benar, gunakan Xcode terbaru yang tersedia secara lokal dan jarak jauh. Jika salah (false), atau jika tidak ada versi yang tersedia bersama, gunakan versi Xcode lokal yang dipilih melalui xcode-select.

Tag: loses_incremental_state, experimental

--extra_execution_platforms=<comma-separated list of options> default: ""

Platform yang tersedia sebagai platform eksekusi untuk menjalankan tindakan. Platform dapat ditentukan berdasarkan target yang tepat, atau sebagai pola target. Platform ini akan dipertimbangkan sebelum platform yang dideklarasikan dalam file WORKSPACE oleh register_execution_platforms(). Opsi ini hanya dapat ditetapkan satu kali; instance selanjutnya akan menggantikan setelan tanda sebelumnya.

Tag: execution

Penggunaan --extra_toolchains=<comma-separated list of options> beberapa kali akan diakumulasikan

Aturan toolchain yang akan dipertimbangkan selama penyelesaian toolchain. Rangkaian alat dapat ditentukan berdasarkan target yang persis, atau sebagai pola target. Rangkaian alat ini akan dipertimbangkan sebelum rangkaian alat yang dideklarasikan dalam file WORKSPACE oleh register_toolchains().

Tag: affects_outputs, changes_inputs, loading_and_analysis

--grte_top=<a label> default: lihat deskripsi

Label untuk library libc yang di-check in. Nilai default dipilih oleh toolchain crosstool, dan Anda hampir tidak perlu menggantinya.

Tag: action_command_lines, affects_outputs

--host_compiler=<a string> default: lihat deskripsi

Flag tanpa pengoperasian. Akan dihapus dalam rilis mendatang.

Tag: loading_and_analysis, execution

--host_grte_top=<a label> default: lihat deskripsi

Jika ditentukan, setelan ini akan menggantikan direktori tingkat teratas libc (--grte_top) untuk konfigurasi 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_bazel_test_exec_run_under default: "true"

Jika diaktifkan, bazel test --run_under=//:runner akan membuat //:runner dalam konfigurasi exec. Jika dinonaktifkan, //:runner akan dibuat dalam konfigurasi target. Bazel menjalankan pengujian di mesin eksekusi, sehingga yang pertama lebih tepat. Hal ini tidak memengaruhi bazel run, yang selalu membangun --run_under=//foo dalam konfigurasi target.

Tag: affects_outputs, incompatible_change

--[no]incompatible_builtin_objc_strip_action default: "true"

Apakah akan memancarkan tindakan penghapusan sebagai bagian dari penautan objc.

Tag: action_command_lines, incompatible_change

--[no]incompatible_dont_enable_host_nonhost_crosstool_features default: "true"

Jika benar (true), 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_apple_toolchain_resolution default: "false"

Menggunakan penyelesaian toolchain untuk memilih Apple SDK untuk aturan Apple (Starlark dan native)

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_strip_executable_safely default: "false"

Jika benar, tindakan penghapusan untuk file yang dapat dieksekusi akan menggunakan flag -x, yang tidak merusak resolusi simbol dinamis.

Tag: action_command_lines, incompatible_change

--[no]interface_shared_objects default: "true"

Gunakan objek bersama antarmuka jika didukung oleh toolchain. Semua toolchain ELF saat ini mendukung setelan ini.

Tag: loading_and_analysis, affects_outputs, affects_outputs

--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Menentukan versi iOS SDK yang akan digunakan untuk membangun aplikasi iOS. Jika tidak ditentukan, akan menggunakan versi iOS SDK default dari 'xcode_version'.

Tag: loses_incremental_state

--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Menentukan versi macOS SDK yang akan digunakan untuk membangun aplikasi macOS. Jika tidak ditentukan, akan menggunakan versi SDK macOS default dari 'xcode_version'.

Tag: loses_incremental_state

--minimum_os_version=<a string> default: lihat deskripsi

Versi OS minimum yang ditargetkan kompilasi Anda.

Tag: loading_and_analysis, affects_outputs

--platform_mappings=<a main workspace-relative path> default: ""

Lokasi file pemetaan yang menjelaskan platform mana yang akan digunakan jika tidak ada yang ditetapkan atau tanda mana yang akan ditetapkan jika platform sudah ada. Harus relatif terhadap root ruang kerja utama. Defaultnya adalah platform_mappings (file langsung di bawah root ruang kerja).

Tag: affects_outputs, changes_inputs, loading_and_analysis, non_configurable

--platforms=<a build target label> default: ""

Label aturan platform yang menjelaskan platform target untuk perintah saat ini.

Tag: affects_outputs, changes_inputs, loading_and_analysis

--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Menentukan versi tvOS SDK yang akan digunakan untuk membangun aplikasi tvOS. Jika tidak ditentukan, gunakan versi tvOS SDK default dari 'xcode_version'.

Tag: loses_incremental_state

--[no]use_platforms_in_apple_crosstool_transition default: "false"

Membuat apple_crosstool_transition kembali menggunakan nilai flag --platforms, bukan --cpu lama jika diperlukan.

Tag: loading_and_analysis

--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Menentukan versi watchOS SDK yang akan digunakan untuk membangun aplikasi watchOS. Jika tidak ditentukan, akan menggunakan versi SDK watchOS default dari 'xcode_version'.

Tag: loses_incremental_state

--xcode_version=<a string> default: lihat deskripsi

Jika ditentukan, gunakan Xcode versi tertentu untuk tindakan build yang relevan. Jika tidak ditentukan, akan menggunakan Xcode versi default executor.

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:
--[no]apple_generate_dsym default: "false"

Apakah akan membuat file simbol debug (.dSYM).

Tag: affects_outputs, action_command_lines

Jika benar, bangun hutan symlink runfile untuk semua target. Jika salah (false), tulis hanya jika diperlukan oleh perintah tindakan, pengujian, atau jalankan lokal.

Tag: affects_outputs

--[no]build_runfile_manifests default: "true"

Jika benar, tulis manifes file yang dapat dijalankan untuk semua target. Jika salah (false), hapus. Pengujian lokal akan gagal dijalankan jika salah (false).

Tag: affects_outputs

--[no]build_test_dwp default: "false"

Jika diaktifkan, saat membuat pengujian C++ secara statis dan dengan fission, file .dwp untuk biner pengujian juga akan dibuat secara otomatis.

Tag: loading_and_analysis, affects_outputs

--cc_proto_library_header_suffixes=<comma-separated set of options> default: ".pb.h"

Menetapkan sufiks 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

--[no]experimental_proto_descriptor_sets_include_source_info default: "false"

Menjalankan tindakan tambahan untuk versi API Java alternatif dalam proto_library.

Tag: affects_outputs, loading_and_analysis, experimental

--[no]experimental_save_feature_state default: "false"

Simpan status fitur yang diaktifkan dan diminta sebagai output kompilasi.

Tag: affects_outputs, experimental

--fission=<a set of compilation modes> default: "no"

Menentukan mode kompilasi mana yang menggunakan fusi 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 DefaultInfo.files dependensi data ke runfilenya, yang cocok dengan perilaku yang direkomendasikan untuk aturan Starlark (fitur runfiles yang harus dihindari).

Tag: affects_outputs, incompatible_change

--[no]incompatible_compact_repo_mapping_manifest default: "true"

Jika diaktifkan, file {binary}.repo_mapping memancarkan pemetaan repo ekstensi modul hanya sekali, bukan sekali untuk setiap repo yang dihasilkan oleh ekstensi yang berkontribusi pada runfile.

Tag: affects_outputs, incompatible_change

--incompatible_disable_select_on=<comma-separated set of options> default: ""

Daftar tanda yang penggunaannya di select() dinonaktifkan.

Tag: loading_and_analysis, incompatible_change, non_configurable

--[no]incompatible_filegroup_runfiles_for_data default: "true"

Jika benar (true), runfile target yang tercantum dalam atribut srcs tersedia untuk target yang menggunakan filegroup sebagai dependensi data.

Tag: incompatible_change

--[no]objc_generate_linkmap default: "false"

Menentukan apakah akan membuat file linkmap atau tidak.

Tag: affects_outputs

--[no]save_temps default: "false"

Jika disetel, output sementara dari gcc akan disimpan. File 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, yang memengaruhi nilainya, bukan keberadaannya:
Penggunaan --action_env=<a 'name[=value]' assignment with an optional value part or the special syntax '=name' to unset a variable> beberapa kali akan diakumulasikan

Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi target. Variabel dapat ditentukan oleh name, yang dalam hal ini nilai akan diambil dari lingkungan pemanggilan, oleh pasangan name=value yang menetapkan nilai secara independen dari lingkungan pemanggilan, atau oleh =name, yang membatalkan setel variabel dengan nama tersebut. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru yang akan digunakan, opsi untuk variabel yang berbeda akan terakumulasi.

Perhatikan bahwa kecuali --incompatible_repo_env_ignores_action_env benar (true), semua pasangan name=value akan tersedia untuk aturan repositori.

Tag: action_command_lines

--allowed_cpu_values=<comma-separated set of options> default: ""

Nilai yang diizinkan untuk flag --cpu.

Tag: changes_inputs, affects_outputs

--[no]android_databinding_use_androidx default: "true"

Buat file data binding yang kompatibel dengan AndroidX. Ini hanya digunakan dengan databinding v2. Flag ini adalah no-op.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state, experimental

--[no]android_databinding_use_v3_4_args default: "true"

Gunakan android databinding v2 dengan argumen 3.4.0. Flag ini adalah no-op.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state, experimental

--android_dynamic_mode=<off, default or fully> default: "nonaktif"

Menentukan apakah dependensi C++ 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. 'fully' berarti semua library akan ditautkan secara dinamis. 'off' berarti semua library akan ditautkan dalam mode sebagian besar statis.

Tag: affects_outputs, loading_and_analysis

--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency> default: "alphabetical"

Menetapkan urutan manifes yang diteruskan ke penggabung manifes untuk biner Android. ALPHABETICAL berarti manifes diurutkan berdasarkan jalur relatif terhadap execroot. ALPHABETICAL_BY_CONFIGURATION berarti manifes diurutkan berdasarkan jalur relatif ke direktori konfigurasi dalam direktori output. DEPENDENCY berarti manifes diurutkan dengan manifes setiap library yang mendahului manifes dependensinya.

Tag: action_command_lines, execution

--[no]android_resource_shrinking default: "false"

Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.

Tag: affects_outputs, loading_and_analysis

--[no]build_python_zip default: "auto"

Membangun zip yang dapat dieksekusi python; aktif di Windows, nonaktif di platform lain

Tag: affects_outputs

Penggunaan --catalyst_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membangun biner Apple Catalyst.

Tag: loses_incremental_state, loading_and_analysis

--[no]collect_code_coverage default: "false"

Jika ditentukan, Bazel akan menginstrumentasi 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 pembuatan biner. Nilai: fastbuild, dbg, opt.

Tag: affects_outputs, action_command_lines

Penggunaan --conlyopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber C.

Tag: action_command_lines, affects_outputs

Penggunaan --copt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke gcc.

Tag: action_command_lines, affects_outputs

--cpu=<a string> default: ""

Tidak digunakan lagi: tanda ini tidak digunakan secara internal oleh Blaze meskipun ada pemetaan platform lama untuk memungkinkan kompatibilitas mundur. Jangan gunakan flag ini, tetapi gunakan --platforms dengan definisi platform yang sesuai.

Tag: changes_inputs, affects_outputs

--cs_fdo_absolute_path=<a string> default: lihat deskripsi

Menggunakan informasi profil CSFDO untuk mengoptimalkan kompilasi. Tentukan nama jalur absolut file zip yang berisi file profil, file profil LLVM mentah atau terindeks.

Tag: affects_outputs

--cs_fdo_instrument=<a string> default: lihat deskripsi

Buat biner dengan instrumentasi FDO yang sensitif terhadap konteks. Dengan compiler Clang/LLVM, opsi ini juga menerima nama direktori tempat file profil mentah akan di-dump saat runtime.

Tag: affects_outputs

--cs_fdo_profile=<a build target label> default: lihat deskripsi

cs_fdo_profile yang merepresentasikan profil sensitif konteks yang akan digunakan untuk pengoptimalan.

Tag: affects_outputs

Penggunaan --cxxopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber C++.

Tag: action_command_lines, affects_outputs

Penggunaan --define=<a 'name=value' assignment> beberapa kali akan diakumulasikan

Setiap opsi --define menentukan penetapan untuk variabel build. Jika ada beberapa nilai untuk variabel, nilai terakhir yang akan digunakan.

Tag: changes_inputs, affects_outputs

--dynamic_mode=<off, default or fully> default: "default"

Menentukan apakah biner C++ akan ditautkan secara dinamis. 'default' berarti Bazel akan memilih apakah akan menautkan secara dinamis. 'fully' berarti semua library akan ditautkan secara dinamis. 'off' berarti semua library akan ditautkan dalam mode sebagian besar statis.

Tag: loading_and_analysis, affects_outputs

--[no]enable_propeller_optimize_absolute_paths default: "true"

Jika disetel, penggunaan jalur absolut untuk pengoptimalan baling-baling akan memunculkan error.

Tag: affects_outputs

--[no]enable_remaining_fdo_absolute_paths default: "true"

Jika disetel, penggunaan jalur absolut untuk FDO akan memunculkan error.

Tag: affects_outputs

--[no]enable_runfiles default: "auto"

Aktifkan hierarki symlink runfile; Secara default, opsi ini nonaktif di Windows, dan aktif di platform lain.

Tag: affects_outputs

Penggunaan --exec_aspects=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar aspek yang dipisahkan koma untuk diterapkan ke target yang dikonfigurasi exec, terlepas dari apakah target tersebut adalah target tingkat teratas atau bukan. Fitur ini bersifat eksperimental dan dapat berubah.

Tag: loading_and_analysis

Penggunaan --experimental_action_listener=<a build target label> beberapa kali akan diakumulasikan

Tidak digunakan lagi dan digantikan dengan aspek. Gunakan action_listener untuk melampirkan extra_action ke tindakan build yang ada.

Tag: execution, experimental

--[no]experimental_android_compress_java_resources default: "false"

Mengompresi resource Java di APK

Tag: affects_outputs, loading_and_analysis, experimental

--[no]experimental_android_databinding_v2 default: "true"

Gunakan android databinding v2. Flag ini adalah no-op.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state, experimental

--[no]experimental_android_resource_shrinking default: "false"

Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.

Tag: affects_outputs, loading_and_analysis, experimental

--[no]experimental_android_rewrite_dexes_with_rex default: "false"

menggunakan alat rex untuk menulis ulang file dex

Tag: affects_outputs, loading_and_analysis, loses_incremental_state, experimental

--[no]experimental_collect_code_coverage_for_generated_files default: "false"

Jika ditentukan, Bazel juga akan membuat informasi cakupan pengumpulan untuk file yang dihasilkan.

Tag: affects_outputs, experimental

--experimental_objc_fastbuild_options=<comma-separated list of options> default: "-O0,-DDEBUG=1"

Menggunakan string ini sebagai opsi compiler fastbuild objc.

Tag: action_command_lines

--[no]experimental_omitfp default: "false"

Jika benar, gunakan libunwind untuk pelepasan stack, dan kompilasi dengan -fomit-frame-pointer dan -fasynchronous-unwind-tables.

Tag: action_command_lines, affects_outputs, experimental

--experimental_output_paths=<off or strip> default: "nonaktif"

Model mana yang akan digunakan untuk tempat aturan menulis outputnya di pohon output, terutama untuk build multi-platform / multi-konfigurasi. Fitur ini sangat eksperimental. Lihat GH-6526 untuk mengetahui detailnya. Tindakan Starlark dapat memilih untuk menggunakan pemetaan jalur dengan menambahkan kunci supports-path-mapping ke dict execution_requirements.

Tag: loses_incremental_state, bazel_internal_configuration, affects_outputs, execution

Penggunaan --experimental_override_platform_cpu_name=<a 'label=value' assignment> beberapa kali akan diakumulasikan

Setiap entri harus dalam bentuk label=value dengan label mengacu pada platform dan nilai adalah nama singkat yang diinginkan untuk menggantikan nama CPU platform di $(TARGET_CPU) variabel make dan jalur output. Hanya digunakan jika --experimental_platform_in_output_dir, --incompatible_target_cpu_from_platform, atau --incompatible_bep_cpu_from_platform benar. Memiliki prioritas penamaan tertinggi.

Tag: affects_outputs, experimental

--[no]experimental_platform_in_output_dir default: "Otomatis"

Jika benar (true), nama singkat untuk platform target akan digunakan dalam nama direktori output, bukan CPU. Skema yang tepat bersifat eksperimental dan dapat berubah:

  1. Pertama, jika opsi --platforms tidak memiliki tepat satu nilai, hash opsi platform akan digunakan.
  2. Selanjutnya, jika ada nama pendek untuk platform saat ini yang didaftarkan oleh --experimental_override_name_platform_in_output_dir, nama pendek tersebut akan digunakan.
  3. Kemudian, jika --experimental_use_platforms_in_output_dir_legacy_heuristic disetel, gunakan nama pendek berdasarkan Label platform saat ini.
  4. Terakhir, hash opsi platform digunakan sebagai upaya terakhir.

Tag: affects_outputs, experimental

--[no]experimental_use_llvm_covmap default: "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"

Gunakan tanda ini hanya sebagai bagian dari strategi pengujian atau migrasi yang disarankan. Perhatikan bahwa heuristik memiliki kekurangan yang diketahui dan disarankan untuk bermigrasi agar hanya mengandalkan --experimental_override_name_platform_in_output_dir.

Tag: affects_outputs, experimental

--fdo_instrument=<a string> default: lihat deskripsi

Buat biner dengan instrumentasi FDO. Dengan compiler Clang/LLVM, opsi ini juga menerima nama direktori tempat file profil mentah akan di-dump saat runtime.

Tag: affects_outputs

--fdo_optimize=<a string> default: lihat deskripsi

Gunakan informasi profil FDO untuk mengoptimalkan kompilasi. Tentukan nama file zip yang berisi struktur 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 direktif exports_files ke paket yang sesuai) dan label yang mengarah ke target fdo_profile. Flag ini akan digantikan oleh aturan fdo_profile.

Tag: affects_outputs

--fdo_prefetch_hints=<a build target label> default: lihat deskripsi

Gunakan petunjuk pengambilan data cache.

Tag: affects_outputs

--fdo_profile=<a build target label> default: lihat deskripsi

fdo_profile yang merepresentasikan profil yang akan digunakan untuk pengoptimalan.

Tag: affects_outputs

Penggunaan --features=<a string> beberapa kali akan diakumulasikan

Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi target. Menentukan -{feature} akan menonaktifkan fitur ini. Fitur negatif selalu menggantikan fitur positif. Lihat juga --host_features.

Tag: changes_inputs, affects_outputs

--[no]force_pic default: "false"

Jika diaktifkan, semua kompilasi C++ menghasilkan kode yang independen dari posisi ("-fPIC"), link lebih memilih library bawaan PIC daripada library non-PIC, dan link menghasilkan file yang dapat dieksekusi yang independen dari posisi ("-pie").

Tag: loading_and_analysis, affects_outputs

Penggunaan --host_action_env=<a 'name[=value]' assignment with an optional value part or the special syntax '=name' to unset a variable> beberapa kali akan diakumulasikan

Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi eksekusi. Variabel dapat ditentukan oleh name, yang dalam hal ini nilai akan diambil dari lingkungan pemanggilan, oleh pasangan name=value yang menetapkan nilai secara independen dari lingkungan pemanggilan, atau oleh =name, yang membatalkan setel variabel dengan nama tersebut. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru yang akan digunakan, opsi untuk variabel yang berbeda akan diakumulasikan.

Tag: action_command_lines

--host_compilation_mode=<fastbuild, dbg or opt> default: "opt"

Tentukan mode alat yang digunakan selama build akan dibuat. Nilai: fastbuild, dbg, opt.

Tag: affects_outputs, action_command_lines

Penggunaan --host_conlyopt=<a string> beberapa kali akan 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

Penggunaan --host_copt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke compiler C untuk alat yang dibuat dalam konfigurasi exec.

Tag: action_command_lines, affects_outputs

--host_cpu=<a string> default: ""

CPU host.

Tag: changes_inputs, affects_outputs

Penggunaan --host_cxxopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke compiler C++ untuk alat yang dibuat dalam konfigurasi exec.

Tag: action_command_lines, affects_outputs

Penggunaan --host_features=<a string> beberapa kali akan diakumulasikan

Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi exec. Menentukan -{feature} akan menonaktifkan fitur ini. Fitur negatif selalu menggantikan fitur positif.

Tag: changes_inputs, affects_outputs

Penggunaan --host_linkopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke linker saat menautkan alat dalam konfigurasi exec.

Tag: action_command_lines, affects_outputs

--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi macOS yang kompatibel minimum untuk target host. Jika tidak ditentukan, gunakan 'macos_sdk_version'.

Tag: loses_incremental_state

Penggunaan --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 kali akan diakumulasikan

Opsi tambahan untuk meneruskan 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 untuk disertakan dan dikecualikan (Lihat juga --instrumentation_filter). option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip 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 semua file cc di //foo/ kecuali bar.cc.

Tag: action_command_lines, affects_outputs

--[no]incompatible_auto_exec_groups default: "false"

Jika diaktifkan, grup exec akan otomatis dibuat untuk setiap toolchain yang digunakan oleh aturan. Agar aturan ini berfungsi, aturan perlu menentukan parameter toolchain pada tindakannya. Untuk mengetahui informasi selengkapnya, lihat GH-17134.

Tag: affects_outputs, incompatible_change

--[no]incompatible_merge_genfiles_directory default: "true"

Jika benar, direktori genfiles akan dilipat ke dalam direktori bin.

Tag: affects_outputs, incompatible_change

--[no]incompatible_target_cpu_from_platform default: "true"

Jika ditentukan, nilai batasan CPU (@platforms//cpu:cpu) dari platform target digunakan untuk menetapkan variabel make $(TARGET_CPU).

Tag: loading_and_analysis, incompatible_change

--[no]instrument_test_targets default: "false"

Jika cakupan diaktifkan, tentukan apakah akan mempertimbangkan aturan pengujian instrumentasi. Jika disetel, aturan pengujian yang disertakan oleh --instrumentation_filter akan diinstrumen. Jika tidak, aturan pengujian akan 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 regex 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

--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi iOS yang kompatibel minimum untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'ios_sdk_version'.

Tag: loses_incremental_state

Penggunaan --ios_multi_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membangun 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 diaktifkan, 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

Penggunaan --linkopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke gcc saat menautkan.

Tag: action_command_lines, affects_outputs

Penggunaan --ltobackendopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke langkah backend LTO (di bagian --features=thin_lto).

Tag: action_command_lines, affects_outputs

Penggunaan --ltoindexopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke langkah pengindeksan LTO (di bagian --features=thin_lto).

Tag: action_command_lines, affects_outputs

Penggunaan --macos_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membangun biner Apple macOS.

Tag: loses_incremental_state, loading_and_analysis

--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi macOS yang kompatibel minimum untuk target. Jika tidak ditentukan, gunakan 'macos_sdk_version'.

Tag: loses_incremental_state

--memprof_profile=<a build target label> default: lihat deskripsi

Gunakan profil memprof.

Tag: affects_outputs

--[no]objc_debug_with_GLIBCXX default: "false"

Jika ditetapkan, dan mode kompilasi ditetapkan ke 'dbg', tentukan GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC, dan GLIBCPP_CONCEPT_CHECKS.

Tag: action_command_lines

--[no]objc_enable_binary_stripping default: "false"

Apakah akan melakukan penghapusan simbol dan kode tidak terpakai pada biner yang ditautkan. Pelepasan biner akan dilakukan jika tanda ini dan --compilation_mode=opt ditentukan.

Tag: action_command_lines

Penggunaan --objccopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber Objective-C/C++.

Tag: action_command_lines

Penggunaan --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 kali akan diakumulasikan

Opsi tambahan untuk meneruskan 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 untuk disertakan dan dikecualikan (Lihat juga --instrumentation_filter). option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip 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 semua file cc di //foo/ kecuali bar.cc.

Tag: action_command_lines, affects_outputs

Penggunaan --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 kali akan diakumulasikan

Opsi tambahan untuk meneruskan secara selektif ke backend LTO (di bawah --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 untuk menyertakan dan mengecualikan. option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip 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

--platform_suffix=<a string> default: lihat deskripsi

Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.

Tag: loses_incremental_state, affects_outputs, loading_and_analysis

--propeller_optimize=<a build target label> default: lihat deskripsi

Gunakan informasi profil Propeller untuk mengoptimalkan target build.Profil Propeller harus terdiri dari setidaknya salah satu dari dua file, yaitu profil cc dan profil ld. Flag ini menerima label build yang harus merujuk ke 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",)Direktif exports_files mungkin harus ditambahkan ke paket yang sesuai agar file ini dapat dilihat oleh Bazel. Opsi harus digunakan sebagai: --propeller_optimize=//a/b:propeller_profile

Tag: action_command_lines, affects_outputs

--propeller_optimize_absolute_cc_profile=<a string> default: lihat deskripsi

Nama jalur absolut file cc_profile untuk build yang Dioptimalkan Propeller.

Tag: affects_outputs

--propeller_optimize_absolute_ld_profile=<a string> default: lihat deskripsi

Nama jalur absolut file ld_profile untuk build yang Dioptimalkan Propeller.

Tag: affects_outputs

--run_under=<a prefix in front of command> default: lihat deskripsi

Awalan yang akan disisipkan sebelum file yang dapat dieksekusi untuk perintah test dan run. Jika nilainya foo -bar, dan command line eksekusinya adalah test_binary -baz, maka command line terakhirnya adalah foo -bar test_binary -baz. Ini juga dapat berupa label untuk target yang dapat dieksekusi. Contohnya antara lain:

  • valgrind
  • strace
  • strace -c
  • valgrind --quiet --num-callers=20
  • //package:target
  • //package:target --options

Tag: action_command_lines

--[no]share_native_deps default: "true"

Jika benar, library native yang berisi fungsi identik akan dibagikan di antara target yang berbeda

Tag: loading_and_analysis, affects_outputs

--[no]stamp default: "false"

Membubuhi stempel biner dengan tanggal, nama pengguna, nama host, informasi ruang kerja, dll.

Tag: affects_outputs

Default --strip=<always, sometimes or never>: "sometimes" (kadang-kadang)

Menentukan apakah akan menghapus biner dan library bersama (menggunakan "-Wl,--strip-debug"). Nilai default 'sometimes' berarti hapus jika --compilation_mode=fastbuild.

Tag: affects_outputs

Penggunaan --stripopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke strip saat membuat biner '<name>.stripped'.

Tag: action_command_lines, affects_outputs

Penggunaan --tvos_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membuat biner Apple tvOS.

Tag: loses_incremental_state, loading_and_analysis

--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi tvOS kompatibel minimum untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'tvos_sdk_version'.

Tag: loses_incremental_state

Penggunaan --visionos_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membuat biner Apple visionOS.

Tag: loses_incremental_state, loading_and_analysis

Penggunaan --watchos_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membangun biner Apple watchOS.

Tag: loses_incremental_state, loading_and_analysis

--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi watchOS yang kompatibel minimum untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'watchos_sdk_version'.

Tag: loses_incremental_state

--xbinary_fdo=<a build target label> default: lihat deskripsi

Gunakan informasi profil XbinaryFDO untuk mengoptimalkan kompilasi. Tentukan nama profil biner silang default. Jika opsi ini 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.):
--[no]check_visibility default: "true"

Jika dinonaktifkan, error visibilitas dalam dependensi target akan diturunkan menjadi peringatan.

Tag: build_file_semantics, non_configurable

--[no]desugar_for_android default: "true"

Apakah akan melakukan desugar bytecode Java 8 sebelum dexing.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state

--[no]desugar_java8_libs default: "false"

Apakah akan menyertakan library Java 8 yang didukung dalam aplikasi untuk perangkat lama.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state, experimental

--[no]enforce_constraints default: "true"

Memeriksa lingkungan yang kompatibel dengan setiap target dan melaporkan error jika ada target yang memiliki dependensi yang tidak mendukung lingkungan yang sama

Tag: build_file_semantics

--[no]experimental_check_desugar_deps default: "true"

Apakah akan memeriksa kembali desugaring yang benar pada tingkat biner Android.

Tag: eagerness_to_exit, loading_and_analysis, experimental

--[no]experimental_enforce_transitive_visibility default: "false"

Jika benar (true), aktifkan package()s untuk menyetel atribut transitive_visibility guna membatasi paket mana yang dapat bergantung padanya.

Tag: build_file_semantics, experimental

--experimental_one_version_enforcement=<off, warning or error> default: "OFF"

Jika diaktifkan, memastikan bahwa aturan java_binary tidak boleh berisi lebih dari satu versi file class yang sama di classpath. Penerapan ini dapat merusak build, atau hanya menghasilkan peringatan.

Tag: loading_and_analysis

--experimental_strict_java_deps=<off, warn, error, strict or default> default: "default"

Jika benar, periksa apakah target Java secara eksplisit mendeklarasikan semua target yang digunakan secara langsung sebagai dependensi.

Tag: build_file_semantics, eagerness_to_exit

--[no]incompatible_check_testonly_for_output_files default: "false"

Jika diaktifkan, periksa testonly untuk target prasyarat yang merupakan file output dengan mencari testonly dari aturan pembuatan. Tindakan ini cocok dengan pemeriksaan visibilitas.

Tag: build_file_semantics, incompatible_change

--[no]incompatible_disable_native_android_rules default: "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

--[no]incompatible_disable_native_apple_binary_rule default: "false"

No-op. Dipertahankan di sini untuk kompatibilitas mundur.

Tag: eagerness_to_exit, incompatible_change

--[no]one_version_enforcement_on_java_tests default: "true"

Jika diaktifkan, dan dengan experimental_one_version_enforcement ditetapkan ke nilai selain NONE, terapkan satu versi pada target java_test. Flag ini dapat dinonaktifkan untuk meningkatkan performa pengujian inkremental dengan mengorbankan potensi pelanggaran satu versi yang terlewat.

Tag: loading_and_analysis

--python_native_rules_allowlist=<a build target label> default: lihat deskripsi

Daftar yang diizinkan (target package_group) untuk digunakan saat menerapkan --incompatible_python_disallow_native_rules.

Tag: loading_and_analysis

--[no]strict_filesets default: "false"

Jika opsi ini diaktifkan, set file yang melintasi batas paket akan dilaporkan sebagai error.

Tag: build_file_semantics, eagerness_to_exit

--strict_proto_deps=<off, warn, error, strict or default> default: "error"

Kecuali jika OFF, 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

--strict_public_imports=<off, warn, error, strict or default> default: "nonaktif"

Kecuali OFF, memeriksa apakah target proto_library secara eksplisit mendeklarasikan semua target yang digunakan dalam 'import public' sebagai diekspor.

Tag: build_file_semantics, eagerness_to_exit, incompatible_change

--[no]strict_system_includes default: "false"

Jika benar, header yang ditemukan melalui jalur sertakan sistem (-isystem) juga harus dideklarasikan.

Tag: loading_and_analysis, eagerness_to_exit

Penggunaan --target_environment=<a build target label> beberapa kali akan diakumulasikan

Mendeklarasikan lingkungan target build ini. Harus berupa referensi label ke aturan environment. Jika ditentukan, semua target tingkat teratas harus kompatibel dengan lingkungan ini.

Lihat juga --platforms.

Tag: changes_inputs

Opsi yang memengaruhi output penandatanganan build:
--apk_signing_method=<v1, v2, v1_v2 or v4> default: "v1_v2"

Implementasi yang akan digunakan untuk menandatangani APK

Tag: action_command_lines, affects_outputs, loading_and_analysis

--[no]device_debug_entitlements default: "true"

Jika disetel, dan mode kompilasi bukan 'opt', aplikasi objc akan menyertakan hak debug saat menandatangani.

Tag: changes_inputs

--ios_signing_cert_name=<a string> default: lihat deskripsi

Nama sertifikat yang akan digunakan untuk penandatanganan iOS. Jika tidak disetel, akan kembali ke profil penyediaan. Dapat berupa preferensi identitas keychain sertifikat atau (substring) 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.:
--[no]incompatible_disallow_sdk_frameworks_attributes default: "false"

Jika benar, atribut sdk_frameworks dan weak_sdk_frameworks tidak diizinkan dalam objc_library dan objc_import.

Tag: build_file_semantics, incompatible_change

Jika benar, jadikan nilai default benar untuk atribut alwayslink di objc_library dan objc_import.

Tag: build_file_semantics, incompatible_change

--[no]incompatible_python_disallow_native_rules default: "false"

Jika benar (true), terjadi error saat menggunakan aturan py_* bawaan; sebagai gantinya, aturan rule_python harus digunakan. Lihat https://github.com/bazelbuild/bazel/issues/17773 untuk mengetahui informasi dan petunjuk migrasi selengkapnya.

Tag: loading_and_analysis, incompatible_change

Opsi yang mengatur perilaku lingkungan pengujian atau pelaksana pengujian:
--[no]allow_analysis_failures default: "false"

Jika benar (true), kegagalan analisis target aturan akan menyebabkan propagasi target instance AnalysisFailureInfo yang berisi deskripsi error, bukan menyebabkan kegagalan build.

Tag: loading_and_analysis, experimental

--analysis_testing_deps_limit=<an integer> default: "2000"

Menetapkan jumlah maksimum dependensi transitif melalui atribut aturan dengan transisi konfigurasi for_analysis_testing. Melebihi batas ini akan menyebabkan error aturan.

Tag: loading_and_analysis

--[no]break_build_on_parallel_dex2oat_failure default: "false"

Jika benar, kegagalan tindakan dex2oat akan menyebabkan build rusak, bukan menjalankan dex2oat selama runtime pengujian.

Tag: loading_and_analysis, experimental

Penggunaan --default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g memory=10,30,60,100> beberapa kali akan diakumulasikan

Ganti jumlah resource default untuk pengujian. Format yang diharapkan adalah {resource}={value}. Jika satu angka positif ditentukan sebagai {value}, angka tersebut akan menggantikan resource default untuk semua ukuran pengujian. Jika 4 angka yang dipisahkan koma ditentukan, angka tersebut akan menggantikan jumlah resource untuk ukuran pengujian small, medium, large, enormous. Nilai juga dapat berupa HOST_RAM/HOST_CPU, yang secara opsional diikuti oleh [-|*]{float} (mis. memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4). Resource pengujian default yang ditentukan oleh tanda ini digantikan oleh resource eksplisit yang ditentukan dalam tag.

--[no]experimental_android_use_parallel_dex2oat default: "false"

Gunakan dex2oat secara paralel untuk mempercepat android_test.

Tag: loading_and_analysis, host_machine_resource_optimizations, experimental

--[no]ios_memleaks default: "false"

Mengaktifkan pemeriksaan kebocoran memori di target ios_test.

Tag: action_command_lines

--ios_simulator_device=<a string> default: lihat deskripsi

Perangkat yang akan disimulasikan saat menjalankan aplikasi iOS di simulator, misalnya 'iPhone 6'. Anda bisa mendapatkan daftar perangkat dengan menjalankan 'xcrun simctl list devicetypes' di komputer tempat simulator akan dijalankan.

Tag: test_runner

--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi iOS yang akan dijalankan di simulator saat menjalankan atau menguji. Setelan ini diabaikan untuk aturan ios_test jika perangkat target ditentukan dalam aturan.

Tag: test_runner

Penggunaan --runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once> beberapa kali akan diakumulasikan

Menentukan jumlah waktu untuk menjalankan setiap pengujian. Jika salah satu upaya tersebut gagal karena alasan apa pun, seluruh pengujian dianggap gagal. Biasanya, nilai yang ditentukan hanyalah bilangan bulat.

Contoh: --runs_per_test=3 akan menjalankan semua pengujian sebanyak 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 sertakan dan kecualikan (Lihat juga --instrumentation_filter).

Contoh: --runs_per_test=//foo/.*,-//foo/bar/.*@3 menjalankan semua pengujian di //foo/ kecuali pengujian di //foo/bar sebanyak tiga kali. Opsi ini dapat diteruskan beberapa kali. Argumen yang paling baru diteruskan yang cocok akan diutamakan. Jika tidak ada yang cocok, pengujian hanya dijalankan satu kali.

Penggunaan --test_env=<a 'name[=value]' assignment with an optional value part or the special syntax '=name' to unset a variable> beberapa kali akan diakumulasikan

Menentukan variabel lingkungan tambahan yang akan dimasukkan ke dalam lingkungan pelaksana pengujian. Variabel dapat ditentukan oleh name, yang dalam hal ini nilainya akan dibaca dari lingkungan klien Bazel, atau oleh pasangan name=value. Variabel yang ditetapkan sebelumnya dapat dibatalkan melalui =name. Opsi ini dapat digunakan beberapa kali untuk menentukan beberapa variabel. Hanya digunakan oleh perintah 'bazel test'.

Tag: test_runner

--test_timeout=<a single integer or comma-separated list of 4 integers> default: "-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 short, moderate, long, dan eternal (dalam urutan tersebut). Dalam bentuk apa pun, nilai -1 memberi tahu Blaze untuk menggunakan waktu tunggu defaultnya untuk kategori tersebut.

--[no]zip_undeclared_test_outputs default: "false"

Jika benar, output pengujian yang tidak dideklarasikan akan diarsipkan dalam file zip.

Tag: test_runner

Opsi yang memicu pengoptimalan waktu build:
--[no]cc_dotd_files default: "true"

Apakah akan membuat dan menganalisis file .d.

Tag: loading_and_analysis, execution, changes_inputs

--[no]cc_include_scanning default: "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 pohon input kompilasi. Namun, hal ini juga dapat merusak build karena pemindai include tidak sepenuhnya menerapkan semantik praprosesor C. Khususnya, alat ini tidak memahami direktif #include dinamis dan mengabaikan logika bersyarat praprosesor. Gunakan dengan menanggung sendiri risikonya. Setiap masalah terkait tanda ini yang diajukan akan ditutup. Di Google, build Anda kemungkinan besar akan gagal tanpa tanda ini.

Tag: loading_and_analysis, execution, changes_inputs, experimental

--[no]experimental_filter_library_jar_with_program_jar default: "false"

Memfilter ProgramJar ProGuard untuk menghapus class yang juga ada di LibraryJar.

Tag: action_command_lines, experimental

--[no]experimental_inmemory_dotd_files default: "true"

Jika diaktifkan, file .d C++ akan diteruskan dalam memori langsung dari node build jarak jauh, bukan ditulis ke disk.

Tag: loading_and_analysis, execution, affects_outputs, experimental

--[no]experimental_inmemory_jdeps_files default: "true"

Jika diaktifkan, file dependensi (.jdeps) yang dihasilkan dari kompilasi Java akan diteruskan dalam memori langsung dari node build jarak jauh, bukan ditulis ke disk.

Tag: loading_and_analysis, execution, affects_outputs, experimental

--[no]experimental_retain_test_configuration_across_testonly default: "false"

Jika diaktifkan, --trim_test_configuration tidak akan memangkas konfigurasi pengujian untuk aturan yang ditandai dengan testonly=1. Tindakan ini dimaksudkan untuk mengurangi masalah konflik tindakan saat aturan non-pengujian bergantung pada aturan cc_test. Tidak berpengaruh jika --trim_test_configuration adalah false.

Tag: loading_and_analysis, loses_incremental_state, experimental

--[no]experimental_unsupported_and_brittle_include_scanning default: "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 pohon input kompilasi. Namun, hal ini juga dapat merusak build karena pemindai include tidak sepenuhnya menerapkan semantik praprosesor C. Khususnya, alat ini tidak memahami direktif #include dinamis dan mengabaikan logika bersyarat praprosesor. Gunakan dengan menanggung sendiri risikonya. Setiap masalah terkait tanda ini yang diajukan akan ditutup. Di Google, build Anda kemungkinan besar akan gagal tanpa tanda ini.

Tag: loading_and_analysis, execution, changes_inputs, experimental

--[no]incremental_dexing default: "true"

Melakukan sebagian besar pekerjaan dexing secara terpisah untuk setiap file Jar.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state

--[no]objc_use_dotd_pruning default: "true"

Jika disetel, file .d yang dikeluarkan oleh clang akan digunakan untuk memangkas set input yang diteruskan ke kompilasi objc.

Tag: changes_inputs, loading_and_analysis

--[no]process_headers_in_dependencies default: "false"

Saat membuat target //a:a, proses header di semua target yang bergantung pada //a:a (jika pemrosesan header diaktifkan untuk toolchain).

Tag: execution

--[no]trim_test_configuration default: "true"

Jika diaktifkan, opsi terkait pengujian akan dihapus di bawah tingkat 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 respons, format, atau lokasi logging:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> default: "-.*"

Mencetak informasi debug selama penyelesaian toolchain. Flag ini menggunakan regex, 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 penyelesaian toolchain.

Tag: terminal_output

--[no]verbose_visibility_errors default: "false"

Jika diaktifkan, error visibilitas akan menyertakan informasi diagnostik tambahan.

Tag: build_file_semantics, non_configurable

Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
Penggunaan --flag_alias=<a 'name=value' flag alias> beberapa kali akan diakumulasikan

Menetapkan nama singkat untuk tanda Starlark. Fungsi ini mengambil satu pasangan nilai kunci dalam bentuk {key}={value} sebagai argumen.

Tag: changes_inputs, non_configurable

--[no]incompatible_default_to_explicit_init_py default: "false"

Flag ini mengubah perilaku default sehingga file init.py tidak lagi dibuat secara otomatis di runfile target Python. Secara tepatnya, saat target py_binary atau py_test memiliki legacy_create_init yang disetel ke "auto" (default), target tersebut akan dianggap salah (false) jika dan hanya jika tanda ini disetel. Lihat https://github.com/bazelbuild/bazel/issues/10076.

Tag: affects_outputs, incompatible_change

Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
--[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 external,
  3. Beberapa uji coba diminta dengan --runs_per_test, atau
  4. Pengujian sebelumnya gagal. Jika ditetapkan ke yes, Bazel akan menyimpan dalam cache semua hasil pengujian kecuali pengujian yang ditandai sebagai external. Jika disetel ke no, Bazel tidak menyimpan hasil pengujian dalam cache.
Default --[no]experimental_cancel_concurrent_tests: "never" (tidak pernah)

Jika on_failed atau on_passed, Blaze akan membatalkan pengujian yang berjalan secara serentak pada pengujian pertama yang berhasil dengan hasil tersebut. Ini hanya berguna jika digunakan bersama --runs_per_test_detects_flakes.

Tag: affects_outputs, loading_and_analysis, experimental

--[no]experimental_fetch_all_coverage_outputs default: "false"

Jika benar (true), Bazel akan mengambil seluruh direktori data cakupan untuk setiap pengujian selama cakupan berjalan.

Tag: affects_outputs, loading_and_analysis, experimental

--[no]experimental_generate_llvm_lcov default: "false"

Jika benar (true), cakupan untuk clang akan menghasilkan laporan LCOV.

Tag: affects_outputs, loading_and_analysis, experimental

--experimental_java_classpath=<off, javabuilder, bazel or bazel_no_fallback> default: "bazel"

Mengaktifkan classpath yang dikurangi untuk kompilasi Java.

--[no]experimental_run_android_lint_on_java_rules default: "false"

Apakah akan memvalidasi sumber java_*.

Tag: affects_outputs, experimental

--[no]explicit_java_test_deps default: "false"

Menentukan dependensi ke JUnit atau Hamcrest secara eksplisit di java_test, bukan secara tidak sengaja diperoleh dari deps TestRunner. Saat ini hanya berfungsi untuk bazel.

--host_java_launcher=<a build target label> default: lihat deskripsi

Peluncur Java yang digunakan oleh alat yang dijalankan selama build.

Penggunaan --host_javacopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke javac saat membangun alat yang dieksekusi selama build.

Penggunaan --host_jvmopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke VM Java saat membuat 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 peluncur pengujian tidak menunjukkan bahwa peluncur tersebut mendukung sharding dengan menyentuh file di jalur dalam TEST_SHARD_STATUS_FILE. Jika salah (false), peluncuran 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 (true), pengujian eksklusif akan berjalan dengan strategi sandbox. Tambahkan tag local untuk memaksa pengujian eksklusif dijalankan secara lokal

Tag: incompatible_change

--[no]incompatible_strict_action_env default: "true"

Jika benar, Bazel 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 penyiapan cache lintas pengguna jika cache bersama digunakan.

Tag: loading_and_analysis, incompatible_change

Penggunaan --j2objc_translation_flags=<comma-separated list of options> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke alat J2ObjC.

--java_debug

Menyebabkan virtual machine Java dari pengujian Java menunggu koneksi dari debugger yang kompatibel dengan JDWP (seperti jdb) sebelum memulai pengujian. Menyiratkan -test_output=streamed.

Meluas 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.

--[no]java_header_compilation default: "true"

Kompilasi ijar langsung dari sumber.

--java_language_version=<a string> default: ""

Versi bahasa Java

--java_launcher=<a build target label> default: lihat deskripsi

Peluncur Java yang akan digunakan saat membangun biner Java. Jika tanda ini disetel ke string kosong, peluncur JDK akan digunakan. Atribut "peluncur" menggantikan tanda ini.

--java_runtime_version=<a string> default: "local_jdk"

Versi runtime Java

Penggunaan --javacopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke javac.

Penggunaan --jvmopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke VM Java. Opsi ini akan ditambahkan ke opsi startup VM dari setiap target java_binary.

--legacy_main_dex_list_generator=<a build target label> default: lihat deskripsi

Menentukan biner yang akan digunakan untuk membuat daftar class yang harus ada di dex utama saat mengompilasi multidex lama.

--optimizing_dexer=<a build target label> default: lihat deskripsi

Menentukan biner yang akan digunakan untuk melakukan dexing tanpa sharding.

Penggunaan --plugin=<a build target label> beberapa kali akan diakumulasikan

Plugin yang akan digunakan dalam build. Saat ini berfungsi dengan java_plugin.

--proguard_top=<a build target label> default: lihat deskripsi

Menentukan versi ProGuard yang akan digunakan untuk penghapusan kode saat membangun biner Java.

--proto_compiler=<a build target label> default: "@bazel_tools//tools/proto:protoc"

Label proto-compiler.

Tag: affects_outputs, loading_and_analysis

--[no]proto_profile default: "true"

Apakah akan meneruskan profile_path ke compiler proto.

Tag: affects_outputs, loading_and_analysis

--proto_profile_path=<a build target label> default: lihat deskripsi

Profil yang akan diteruskan ke compiler proto sebagai profile_path. Jika tidak disetel, tetapi --proto_profile adalah benar (default), menyimpulkan jalur dari --fdo_optimize.

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

Penggunaan --protocopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke compiler protobuf.

Tag: affects_outputs

--[no]runs_per_test_detects_flakes default: "false"

Jika benar (true), setiap shard yang setidaknya satu kali lulus dan setidaknya satu kali gagal akan mendapatkan status TIDAK STABIL (FLAKY).

--shell_executable=<a path> default: lihat deskripsi

Jalur absolut ke shell yang dapat dieksekusi untuk digunakan Bazel. Jika tidak disetel, tetapi variabel lingkungan BAZEL_SH disetel pada pemanggilan Bazel pertama (yang memulai server Bazel), Bazel akan menggunakannya. Jika keduanya tidak ditetapkan, Bazel akan menggunakan jalur default yang dikodekan secara permanen, bergantung pada sistem operasi yang dijalankannya;

  • Windows: c:/msys64/usr/bin/bash.exe
  • FreeBSD: /usr/local/bin/bash
  • 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

Penggunaan --test_arg=<a string> beberapa kali akan 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 identik. Hanya digunakan oleh perintah bazel test.

--test_filter=<a string> default: lihat deskripsi

Menentukan filter untuk diteruskan ke framework pengujian. Digunakan untuk membatasi pengujian yang dijalankan. Perhatikan bahwa hal ini tidak memengaruhi target yang dibuat.

--test_result_expiration=<an integer> default: "-1"

Opsi ini tidak digunakan lagi dan tidak berpengaruh.

--[no]test_runner_fail_fast default: "false"

Meneruskan opsi fail fast ke runner pengujian. Runner pengujian harus menghentikan eksekusi saat kegagalan pertama terjadi.

--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce> default: "explicit"

Tentukan strategi untuk sharding pengujian:

  • explicit untuk hanya menggunakan sharding jika atribut shard_count BUILD ada.
  • disabled agar tidak pernah menggunakan sharding pengujian.
  • forced=k untuk menerapkan shard k untuk pengujian, terlepas dari atribut shard_count BUILD.
--tool_java_language_version=<a string> default: ""

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 mengeksekusi alat selama build

--[no]use_ijars default: "true"

Jika diaktifkan, opsi ini menyebabkan kompilasi Java menggunakan jar antarmuka. Hal ini akan menghasilkan kompilasi inkremental yang lebih cepat, tetapi pesan error dapat berbeda.

Opsi Build

Opsi yang mengontrol eksekusi build:
--[no]allow_one_action_on_resource_unavailable default: "true"

Jika disetel, izinkan setidaknya satu tindakan berjalan meskipun resource tidak mencukupi atau tidak tersedia.

Tag: execution

Penggunaan --allowed_strategies_by_exec_platform=<a '<Label>=value[,value]' assignment> beberapa kali akan diakumulasikan

Filter menghasilkan strategi berdasarkan platform eksekusi tanpa memengaruhi urutan. Contoh:

common --spawn_strategy=remote,sandboxed,worker,local
common --strategy=Genrule=local
common --allowed_strategies_by_exec_platform=@platforms//host:host=local,sandboxed,worker
common --allowed_strategies_by_exec_platform=//:linux_amd64=remote

Dengan opsi di atas:

  • Tindakan yang dikonfigurasi untuk platform host akan diberi remote,sandboxed,worker.
  • Tindakan yang dikonfigurasi untuk platform //:linux_amd64 akan diberi remote.
  • Tindakan yang dikonfigurasi untuk platform //:linux_amd64 dengan mnemonik Genrule tidak akan diberi strategi dan gagal di-spawn.

Tag: execution

--[no]check_up_to_date default: "false"

Jangan lakukan build, cukup periksa apakah sudah diupdate. Jika semua target sudah terbaru, build akan berhasil diselesaikan. Jika ada langkah yang perlu dieksekusi, error akan dilaporkan dan build akan gagal.

Tag: execution

Default --dynamic_local_execution_delay=<an integer>: "1000"

Berapa milidetik eksekusi lokal harus ditunda, jika eksekusi jarak jauh lebih cepat selama build setidaknya sekali?

Tag: execution, host_machine_resource_optimizations

Penggunaan --dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment> beberapa kali akan diakumulasikan

Strategi lokal, secara berurutan, untuk digunakan pada mnemonik tertentu - strategi pertama yang berlaku akan digunakan. Misalnya, worker,sandboxed menjalankan tindakan yang mendukung pekerja persisten menggunakan strategi pekerja, dan semua tindakan lainnya menggunakan strategi sandbox. Jika tidak ada mnemonik yang diberikan, daftar strategi akan digunakan sebagai penggantian untuk semua mnemonik. Daftar penggantian default adalah worker,sandboxed, atauworker,sandboxed,standalone jika experimental_local_lockfree_output disetel. Mengambil [mnemonic=]local_strategy[,local_strategy,...]

Tag: execution, host_machine_resource_optimizations

Penggunaan --dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment> beberapa kali akan diakumulasikan

Strategi jarak jauh, secara berurutan, untuk digunakan pada mnemonik tertentu - strategi pertama yang berlaku akan digunakan. Jika tidak ada mnemonik yang diberikan, daftar strategi akan digunakan sebagai penggantian untuk semua mnemonik. Daftar penggantian default adalah remote, sehingga biasanya tanda ini tidak perlu ditetapkan secara eksplisit. Menerima [mnemonic=]remote_strategy[,remote_strategy,...]

Tag: execution, host_machine_resource_optimizations

--[no]experimental_async_execution default: "false"

Jika disetel ke benar (true), Bazel diizinkan untuk menjalankan tindakan dalam thread virtual. Jumlah tindakan yang sedang berlangsung masih dibatasi dengan --jobs.

Tag: host_machine_resource_optimizations, execution, incompatible_change

--experimental_async_execution_max_concurrent_actions=<an integer> default: "5000"

Jumlah tindakan serentak maksimum yang akan dijalankan dengan eksekusi asinkron. Jika nilainya kurang dari --jobs, nilai tersebut akan ditetapkan menjadi --jobs.

Tag: host_machine_resource_optimizations, execution

--experimental_docker_image=<a string> default: ""

Tentukan nama image Docker (misalnya, "ubuntu:latest") yang akan digunakan untuk mengeksekusi tindakan sandbox saat menggunakan strategi docker dan tindakan itu sendiri belum memiliki atribut container-image di exec_properties dalam deskripsi platform. Nilai flag ini diteruskan secara verbatim ke 'docker run', sehingga mendukung sintaksis dan mekanisme yang sama dengan Docker itu sendiri.

Tag: execution

--[no]experimental_docker_use_customized_images default: "true"

Jika diaktifkan, akan menyuntikkan uid dan gid pengguna saat ini ke dalam image Docker sebelum menggunakannya. Hal ini diperlukan jika build / pengujian Anda bergantung pada pengguna yang memiliki nama dan direktori beranda di dalam penampung. Fitur ini aktif secara default, tetapi Anda dapat menonaktifkannya jika fitur penyesuaian gambar otomatis tidak berfungsi dalam kasus Anda atau Anda tahu bahwa Anda tidak memerlukannya.

Tag: execution

--[no]experimental_dynamic_exclude_tools default: "true"

Jika ditetapkan, target yang dibuat "untuk alat" tidak tunduk pada eksekusi dinamis. Target tersebut sangat kecil kemungkinannya dibangun secara inkremental sehingga tidak layak untuk menghabiskan siklus lokal.

Tag: execution, host_machine_resource_optimizations

--experimental_dynamic_local_load_factor=<a double> default: "0"

Mengontrol seberapa banyak beban dari eksekusi dinamis yang akan ditempatkan di komputer lokal. Flag ini menyesuaikan jumlah tindakan dalam eksekusi dinamis yang akan kita jadwalkan secara serentak. Ini didasarkan pada jumlah CPU yang dianggap tersedia oleh Blaze, yang dapat dikontrol dengan tanda --local_resources=cpu=. Jika tanda ini adalah 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 saat jumlah tindakan yang menunggu untuk dijadwalkan tinggi. Hal ini mengurangi beban pada mesin lokal dalam kasus build bersih, di mana mesin lokal tidak banyak berkontribusi.

Tag: execution, host_machine_resource_optimizations

--experimental_dynamic_slow_remote_time=<An immutable length of time.> default: "0"

Jika >0, waktu tindakan yang dijalankan secara dinamis harus dijalankan hanya dari jarak jauh sebelum kami 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 memantau masalah eksekusi jarak jauh.

Tag: execution, host_machine_resource_optimizations

--[no]experimental_enable_docker_sandbox default: "false"

Aktifkan sandbox berbasis Docker. Opsi ini tidak berpengaruh jika Docker tidak diinstal.

Tag: execution

--[no]experimental_inmemory_sandbox_stashes default: "false"

Jika disetel ke benar (true), konten sandbox yang disimpan untuk reuse_sandbox_directories akan dilacak dalam memori. Hal ini mengurangi jumlah I/O yang diperlukan selama penggunaan ulang. Bergantung pada build, tanda ini dapat meningkatkan waktu dinding. Bergantung pada build, tanda ini juga dapat menggunakan sejumlah besar memori tambahan.

Tag: host_machine_resource_optimizations, execution

--experimental_sandbox_async_tree_delete_idle_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> default: "4"

Jika 0, sandbox akan dihapus segera setelah tindakan selesai, sehingga menghalangi penyelesaian tindakan. Jika lebih besar dari 0, sandbox akan dihapus secara asinkron di latar belakang tanpa memblokir penyelesaian tindakan. Penghapusan asinkron menggunakan satu thread saat perintah sedang berjalan, tetapi akan menggunakan sebanyak mungkin thread sesuai nilai flag ini setelah server tidak ada aktivitas. Setel ke auto untuk menggunakan thread sebanyak jumlah CPU. Penonaktifan server akan memblokir penghapusan asinkron yang tertunda.

Tag: host_machine_resource_optimizations, execution

--experimental_sandbox_enforce_resources_regexp=<a valid Java regular expression> default: ""

Jika benar, tindakan yang mnemoniknya cocok dengan regex input akan menerapkan permintaan resource sebagai batas, menggantikan nilai --experimental_sandbox_limits, jika jenis resource mendukungnya. Misalnya, pengujian yang mendeklarasikan cpu:3 dan resources:memory:10, akan berjalan dengan maksimal 3 CPU dan memori 10 megabyte.

Tag: execution

Penggunaan --experimental_sandbox_limits=<a named double, 'name=value', where value is an integer, or a keyword ("HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "HOST_CPUS", "HOST_CPUS*.5"> beberapa kali akan diakumulasikan

Jika > 0, setiap sandbox Linux akan dibatasi hingga jumlah yang diberikan untuk resource yang ditentukan. Memerlukan --incompatible_use_new_cgroup_implementation dan menggantikan --experimental_sandbox_memory_limit_mb. Memerlukan cgroup v1 atau v2 dan izin bagi pengguna ke direktori cgroup.

Tag: execution

--experimental_sandbox_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.> default: "0"

Jika > 0, setiap sandbox Linux akan dibatasi hingga jumlah memori yang diberikan (dalam MB). Memerlukan cgroup v1 atau v2 dan izin bagi pengguna ke direktori cgroup.

Tag: execution

--[no]experimental_shrink_worker_pool default: "false"

Jika diaktifkan, dapat mengecilkan worker pool jika tekanan memori pekerja tinggi. Flag ini hanya berfungsi jika flag experimental_total_worker_memory_limit_mb diaktifkan.

Tag: execution, host_machine_resource_optimizations

--experimental_total_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.> default: "0"

Jika batas ini lebih besar dari nol, pekerja yang tidak aktif mungkin akan dihentikan jika total penggunaan memori semua pekerja melebihi batas.

Tag: execution, host_machine_resource_optimizations

--[no]experimental_use_hermetic_linux_sandbox default: "false"

Jika disetel ke benar (true), jangan pasang root, hanya pasang apa yang disediakan dengan sandbox_add_mount_pair. File input akan ditautkan secara permanen ke sandbox, bukan ditautkan secara simbolis dari sandbox. Jika file input tindakan berada di sistem file yang berbeda dengan sandbox, file input akan disalin.

Tag: execution

--[no]experimental_use_windows_sandbox default: "false"

Gunakan sandbox Windows untuk menjalankan tindakan. Jika "ya", 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

--experimental_windows_sandbox_path=<a string> default: "BazelSandbox.exe"

Jalur ke biner sandbox Windows yang akan digunakan saat --experimental_use_windows_sandbox bernilai benar (true). Jika nama tidak memiliki ekstensi, gunakan biner pertama dari nama tersebut yang ditemukan di PATH.

Tag: execution

--experimental_worker_allowlist=<comma-separated set of options> default: lihat deskripsi

Jika tidak kosong, hanya izinkan penggunaan pekerja persisten dengan mnemonik kunci pekerja yang diberikan.

Tag: execution, host_machine_resource_optimizations

--[no]experimental_worker_cancellation default: "false"

Jika diaktifkan, Bazel dapat mengirim permintaan pembatalan ke pekerja yang mendukungnya.

Tag: execution

--experimental_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.> default: "0"

Jika batas ini lebih besar dari nol, pekerja mungkin akan dihentikan jika penggunaan memori pekerja melebihi batas. Jika tidak digunakan bersama dengan eksekusi dinamis dan --experimental_dynamic_ignore_local_signals=9, build Anda dapat error.

Tag: execution, host_machine_resource_optimizations

--experimental_worker_metrics_poll_interval=<An immutable length of time.> default: "5s"

Interval antara pengumpulan metrik pekerja dan kemungkinan upaya pengusiran. Tidak boleh kurang dari 1 detik karena alasan performa.

Tag: execution, host_machine_resource_optimizations

--[no]experimental_worker_multiplex_sandboxing default: "false"

Jika diaktifkan, pekerja multiplex dengan persyaratan eksekusi 'supports-multiplex-sandboxing' akan berjalan di lingkungan dalam sandbox, menggunakan direktori sandbox terpisah per permintaan kerja. Pekerja multiplex dengan persyaratan eksekusi selalu di-sandbox saat berjalan di bawah strategi eksekusi dinamis, terlepas dari tanda ini.

Tag: execution

--[no]experimental_worker_sandbox_hardening default: "false"

Jika diaktifkan, pekerja akan dijalankan di sandbox yang diperkuat, jika penerapan memungkinkan. Jika penguatan diaktifkan, direktori tmp akan berbeda untuk setiap pekerja.

Tag: execution

Penggunaan --experimental_worker_sandbox_inmemory_tracking=<a string> beberapa kali akan diakumulasikan

Mnemonic kunci pekerja yang konten direktori sandbox-nya dilacak dalam memori. Hal ini dapat meningkatkan performa build dengan biaya penggunaan memori tambahan. Hanya memengaruhi pekerja sandbox. Dapat ditentukan beberapa kali untuk mnemonik yang berbeda.

Tag: execution

--[no]experimental_worker_strict_flagfiles default: "false"

Jika diaktifkan, argumen tindakan untuk pekerja yang tidak mengikuti spesifikasi pekerja akan menyebabkan error. Argumen pekerja harus memiliki tepat satu argumen @flagfile sebagai argumen terakhir dalam daftar argumennya.

Tag: execution

--genrule_strategy=<comma-separated list of options> default: ""

Tentukan cara menjalankan genrules. Flag ini akan dihentikan. Sebagai gantinya, gunakan --spawn_strategy=<value> untuk mengontrol semua tindakan atau --strategy=Genrule=<value> untuk mengontrol genrule saja.

Tag: execution

--[no]incompatible_use_new_cgroup_implementation default: "true"

Jika benar, gunakan implementasi baru untuk cgroup. Implementasi lama hanya mendukung pengontrol memori dan mengabaikan nilai --experimental_sandbox_limits.

Tag: execution

--[no]internal_spawn_scheduler default: "true"

Opsi placeholder sehingga 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: "auto"

Jumlah tugas serentak yang akan dijalankan. Mengambil bilangan bulat, atau kata kunci ("auto", "HOST_CPUS", "HOST_RAM"), yang secara opsional diikuti dengan operasi ([-|]<float>), misalnya. "auto", "HOST_CPUS.5". Nilai harus antara 1 dan 5000. 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 padanya tidak dapat dianalisis, prasyarat lain dari target ini dapat dianalisis.

Tag: eagerness_to_exit

--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> default: "auto"

Jumlah thread paralel yang akan digunakan untuk fase pemuatan/analisis.Menggunakan bilangan bulat, atau kata kunci ("auto", "HOST_CPUS", "HOST_RAM"), yang 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

--[no]reuse_sandbox_directories default: "true"

Jika disetel ke benar (true), direktori yang digunakan oleh eksekusi non-worker yang di-sandbox dapat digunakan kembali untuk menghindari biaya penyiapan yang tidak perlu.

Tag: host_machine_resource_optimizations, execution

--sandbox_base=<a string> default: ""

Memungkinkan sandbox membuat direktori sandbox-nya di bawah jalur ini. Tentukan jalur di tmpfs (seperti /run/shm) untuk 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 perantara yang dihasilkan dengan menjalankan tindakan.

Tag: host_machine_resource_optimizations, execution

--[no]sandbox_enable_loopback_device default: "true"

Jika benar (true), perangkat loopback akan disiapkan di namespace jaringan linux-sandbox untuk tindakan lokal.

Tag: execution

--[no]sandbox_explicit_pseudoterminal default: "false"

Aktifkan secara eksplisit pembuatan pseudoterminal untuk tindakan yang di-sandbox. Beberapa distribusi Linux mengharuskan setelan 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

Penggunaan --sandbox_tmpfs_path=<an absolute path> beberapa kali akan diakumulasikan

Untuk tindakan yang di-sandbox, pasang direktori kosong yang dapat ditulis di jalur absolut ini (jika didukung oleh implementasi sandbox, jika tidak, akan diabaikan).

Tag: host_machine_resource_optimizations, execution

--[no]skip_incompatible_explicit_targets default: "false"

Lewati target yang tidak kompatibel yang tercantum secara eksplisit di command line. Secara default, membangun target tersebut akan menghasilkan error, tetapi target tersebut akan dilewati tanpa pemberitahuan jika opsi ini diaktifkan. Lihat: Melewati target yang tidak kompatibel

Tag: loading_and_analysis

--spawn_strategy=<comma-separated list of options> default: ""

Tentukan cara tindakan spawn dieksekusi 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

Penggunaan --strategy=<a '[name=]value1[,..,valueN]' assignment> beberapa kali akan diakumulasikan

Tentukan cara mendistribusikan kompilasi tindakan pembuatan 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 mnemonik). Lihat https://blog.bazel.build/2019/06/19/list-strategy.html untuk mengetahui detailnya.

Tag: execution

Penggunaan --strategy_regexp=<a '<RegexFilter>=value[,value]' assignment> beberapa kali akan 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 tidak cocok 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

Penggunaan --worker_extra_flag=<a 'name=value' assignment> beberapa kali akan diakumulasikan

Flag perintah tambahan yang akan diteruskan ke proses pekerja selain --persistent_worker, yang dikelompokkan berdasarkan mnemonik (misalnya, --worker_extra_flag=Javac=--debug.

Tag: execution, host_machine_resource_optimizations

Penggunaan --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 kali akan diakumulasikan

Jumlah instance setiap jenis pekerja persisten yang dapat diluncurkan jika Anda menggunakan strategi 'worker'. Dapat ditentukan sebagai [name=value] untuk memberikan nilai yang berbeda per mnemonik. Batas ini didasarkan pada kunci pekerja, yang dibedakan berdasarkan mnemonik, tetapi juga pada flag dan lingkungan saat startup, sehingga dalam beberapa kasus, jumlah pekerja per mnemonik dapat lebih banyak daripada yang ditentukan oleh flag ini. Mengambil bilangan bulat, atau kata kunci ("auto", "HOST_CPUS", "HOST_RAM"), yang secara opsional diikuti dengan operasi ([-|]<float>), misalnya. "auto", "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

Penggunaan --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 kali akan diakumulasikan

Jumlah WorkRequest yang dapat diterima oleh proses worker multiplex secara paralel jika Anda menggunakan strategi 'worker' dengan --worker_multiplex. Dapat ditentukan sebagai [name=value] untuk memberikan nilai yang berbeda per mnemonik. Batas ini didasarkan pada kunci pekerja, yang dibedakan berdasarkan mnemonik, tetapi juga pada flag dan lingkungan saat startup, sehingga dalam beberapa kasus, jumlah pekerja per mnemonik dapat lebih banyak daripada yang ditentukan oleh flag ini. Mengambil bilangan bulat, atau kata kunci ("auto", "HOST_CPUS", "HOST_RAM"), yang secara opsional diikuti dengan operasi ([-|]<float>), misalnya. "auto", "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

--[no]worker_multiplex default: "true"

Jika diaktifkan, pekerja akan menggunakan multiplexing jika mereka mendukungnya.

Tag: execution, host_machine_resource_optimizations

--[no]worker_quit_after_build default: "false"

Jika diaktifkan, semua pekerja akan keluar setelah build selesai.

Tag: execution, host_machine_resource_optimizations

--[no]worker_sandboxing default: "false"

Jika diaktifkan, pekerja singleplex akan berjalan di lingkungan sandbox. Pekerja simpleks selalu di-sandbox saat berjalan di bawah strategi eksekusi dinamis, terlepas dari tanda ini.

Tag: execution

--[no]worker_verbose default: "false"

Jika diaktifkan, mencetak pesan verbose saat pekerja dimulai, dimatikan, ...

Opsi yang mengontrol output perintah:
--[no]build default: "true"

Jalankan build; ini adalah perilaku yang biasa. Menentukan --nobuild akan menyebabkan build berhenti sebelum menjalankan tindakan build, menampilkan nol jika fase pemuatan dan analisis paket berhasil diselesaikan; mode ini berguna untuk menguji fase tersebut.

Tag: execution, affects_outputs

--[no]experimental_use_validation_aspect default: "false"

Apakah akan menjalankan tindakan validasi menggunakan aspek (untuk paralelisme dengan pengujian).

Tag: execution, affects_outputs

Penggunaan --output_groups=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar nama grup output yang dipisahkan koma, yang masing-masing secara opsional diawali dengan + atau -. Grup yang diawali dengan + ditambahkan ke set grup output default, sedangkan grup yang diawali dengan - dihapus dari set default. Jika setidaknya satu grup tidak memiliki awalan, set default grup output akan dihilangkan. Misalnya, --output_groups=+foo,+bar membangun gabungan set default, foo, dan bar, sementara --output_groups=foo,bar menggantikan set default sehingga hanya foo dan bar yang dibangun.

Tag: execution, affects_outputs

--[no]run_validations default: "true"

Apakah akan menjalankan tindakan validasi sebagai bagian dari build. Lihat Tindakan Validasi.

Tag: execution, affects_outputs

--serialized_frontier_profile=<a string> default: ""

Membuat dump profil byte frontier yang diserialkan. Menentukan jalur output.

Tag: bazel_monitoring

Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, yang memengaruhi nilainya, bukan keberadaannya:
Penggunaan --aspects=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar aspek yang dipisahkan koma untuk diterapkan ke target tingkat teratas. Dalam daftar, jika aspek some_aspect menentukan penyedia aspek yang diperlukan melalui required_aspect_providers, some_aspect akan berjalan setelah setiap aspek yang disebutkan sebelumnya dalam daftar aspek yang penyedia yang diiklankannya memenuhi penyedia aspek yang diperlukan some_aspect. Selain itu, some_aspect akan berjalan setelah semua aspek yang diperlukan 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.

--bep_maximum_open_remote_upload_files=<an integer> default: "-1"

Jumlah maksimum file terbuka yang diizinkan selama upload artefak BEP.

Tag: affects_outputs

Flag ini mengontrol cara symlink praktis (symlink yang muncul di ruang kerja setelah build) akan dikelola. Kemungkinan nilai:

  • normal (default): Setiap jenis symlink praktis akan dibuat atau dihapus, sebagaimana ditentukan oleh build.
  • clean: Semua symlink akan dihapus tanpa syarat.
  • ignore: Symlink tidak akan dibuat atau dibersihkan.
  • log_only: Buat pesan log seolah-olah normal diteruskan, tetapi sebenarnya tidak melakukan operasi sistem file apa pun (berguna untuk alat).

Perhatikan bahwa hanya symlink yang namanya dibuat oleh nilai --symlink_prefix saat ini yang dapat terpengaruh; jika awalan berubah, symlink yang sudah ada sebelumnya tidak akan terpengaruh.

Tag: affects_outputs

Flag ini mengontrol apakah kami akan memposting peristiwa build ConvenienceSymlinksIdentified ke Protokol Peristiwa Build atau tidak. Jika nilainya benar (true), BEP akan memiliki entri untuk convenienceSymlinksIdentified, yang mencantumkan semua link simbolis praktis yang dibuat di ruang kerja Anda. Jika salah (false), entri convenienceSymlinksIdentified di BEP 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.

Meluas 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.

Meluas menjadi:
  --remote_download_outputs=minimal

Tag: affects_outputs

--remote_download_outputs=<all, minimal or toplevel> default: "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', akan berperilaku seperti 'minimal', tetapi juga mendownload output target tingkat teratas ke komputer lokal. Kedua opsi dapat mengurangi waktu build secara signifikan jika bandwidth jaringan menjadi hambatan.

Tag: affects_outputs

Daripada mendownload output build jarak jauh ke komputer lokal, buat link simbolis. Target link simbolis dapat ditentukan dalam bentuk string template. String template ini dapat berisi {hash} dan {size_bytes} yang masing-masing diperluas menjadi 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 level teratas ke komputer lokal. Flag ini adalah alias untuk --remote_download_outputs=toplevel.

Meluas menjadi:
  --remote_download_outputs=toplevel

Tag: affects_outputs

Awalan yang ditambahkan ke salah satu symlink praktis yang dibuat setelah build. Jika dihilangkan, nilai defaultnya adalah nama alat build diikuti dengan tanda hubung. Jika / diteruskan, tidak ada symlink yang dibuat dan tidak ada peringatan yang dikeluarkan. 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 tanda, dll.):
--[no]experimental_docker_privileged default: "false"

Jika diaktifkan, Bazel akan meneruskan tanda --privileged ke 'docker run' saat menjalankan tindakan. Hal ini mungkin diperlukan oleh build Anda, tetapi juga dapat mengurangi keakuratan.

Tag: execution

Tanpa pengoperasian

Tag: host_machine_resource_optimizations, execution

Penggunaan --sandbox_add_mount_pair=<a single path or a 'source:target' pair> beberapa kali akan diakumulasikan

Tambahkan pasangan jalur tambahan untuk dipasang di sandbox.

Tag: execution

Penggunaan --sandbox_block_path=<a string> beberapa kali akan diakumulasikan

Untuk tindakan sandbox, jangan izinkan akses ke jalur ini.

Tag: execution

--[no]sandbox_default_allow_network default: "true"

Mengizinkan akses jaringan secara default untuk tindakan; hal ini mungkin tidak berfungsi dengan semua penerapan sandbox.

Tag: execution

--[no]sandbox_fake_hostname default: "false"

Ubah nama host saat ini menjadi 'localhost' untuk tindakan sandbox.

Tag: execution

--[no]sandbox_fake_username default: "false"

Ubah nama pengguna saat ini menjadi 'nobody' untuk tindakan yang di-sandbox.

Tag: execution

Penggunaan --sandbox_writable_path=<a string> beberapa kali akan diakumulasikan

Untuk tindakan kotak pasir, buat direktori yang ada dapat ditulis di kotak pasir (jika didukung oleh penerapan kotak pasir, jika tidak, akan diabaikan).

Tag: execution

Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility default: "false"

Jika incompatible_enforce_config_setting_visibility=false, ini adalah no-op. Jika tidak, jika tanda ini salah (false), setiap config_setting tanpa atribut visibilitas eksplisit adalah //visibility:public. Jika tanda ini benar (true), 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 benar (true), terapkan batasan visibilitas config_setting. Jika salah (false), 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 pelaksana pengujian:
--[no]check_tests_up_to_date default: "false"

Jangan jalankan pengujian, cukup periksa apakah sudah yang terbaru. Jika semua hasil pengujian sudah terbaru, pengujian akan berhasil diselesaikan. Jika ada pengujian yang perlu dibuat atau dieksekusi, error akan dilaporkan dan pengujian akan gagal. Opsi ini menyiratkan perilaku --check_up_to_date.

Tag: execution

Penggunaan --flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once> beberapa kali akan diakumulasikan

Setiap pengujian akan dicoba lagi hingga jumlah yang ditentukan jika terjadi kegagalan pengujian. Pengujian yang memerlukan lebih dari satu upaya untuk lulus ditandai sebagai 'TIDAK STABIL' dalam ringkasan pengujian. 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 upaya untuk pengujian yang ditandai secara eksplisit 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 untuk disertakan dan dikecualikan (Lihat juga --runs_per_test). Contoh: --flaky_test_attempts=//foo/.,-//foo/bar/.@3 akan menghilangkan semua pengujian di //foo/ kecuali yang ada di foo/bar sebanyak tiga kali. Opsi ini dapat diteruskan beberapa kali. Argumen yang baru saja diteruskan dan cocok akan diutamakan. Jika tidak ada yang cocok, perilaku akan sama seperti 'default' di atas.

Tag: execution

--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> default: "auto"

Jumlah maksimum tugas pengujian lokal yang akan dijalankan secara serentak. Mengambil bilangan bulat, atau kata kunci ("auto", "HOST_CPUS", "HOST_RAM"), yang secara opsional diikuti dengan operasi ([-|]<float>), misalnya. "auto", "HOST_CPUS.5". 0 berarti resource lokal akan membatasi jumlah tugas pengujian lokal yang dapat dijalankan secara serentak. Menetapkan nilai ini lebih besar dari nilai untuk --jobs tidak akan berpengaruh.

Tag: execution

--[no]test_keep_going default: "true"

Jika dinonaktifkan, pengujian yang tidak lulus akan menyebabkan seluruh build berhenti. Secara default, semua pengujian dijalankan, meskipun beberapa pengujian tidak lulus.

Tag: execution

--test_strategy=<a string> default: ""

Menentukan strategi yang akan digunakan saat menjalankan pengujian.

Tag: execution

--test_tmpdir=<a path> default: lihat deskripsi

Menentukan direktori sementara dasar yang akan digunakan 'bazel test'.

Opsi yang memicu pengoptimalan waktu build:
--cache_computed_file_digests=<a long integer> default: "50000"

Jika lebih besar dari 0, mengonfigurasi Bazel untuk menyimpan ringkasan file dalam cache di memori berdasarkan metadata file, bukan menghitung ulang ringkasan dari disk setiap kali diperlukan. Menetapkan nilai ini ke 0 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.

--experimental_active_directories=<comma-separated list of options> default: ""

Direktori aktif untuk Skyfocus dan caching analisis jarak jauh. Tentukan sebagai jalur relatif root ruang kerja yang dipisahkan koma. Ini adalah flag stateful. Menentukan satu setelan akan mempertahankannya untuk pemanggilan berikutnya, hingga setelan tersebut didefinisikan ulang dengan setelan baru.

Tag: host_machine_resource_optimizations

--[no]experimental_cpu_load_scheduling default: "false"

Mengaktifkan penjadwalan eksekusi lokal eksperimental berdasarkan beban CPU, bukan estimasi tindakan satu per satu. Penjadwalan eksperimental telah menunjukkan manfaat besar pada build lokal besar di mesin yang canggih dengan sejumlah besar core. Sebaiknya gunakan dengan --local_resources=cpu=HOST_CPUS

Tag: execution

--experimental_dynamic_ignore_local_signals=<a comma-separated list of signal numbers> default: lihat deskripsi

Menggunakan daftar nomor sinyal OS. Jika cabang lokal eksekusi dinamis dihentikan dengan salah satu sinyal ini, cabang jarak jauh akan diizinkan untuk menyelesaikan eksekusi. Untuk pekerja persisten, hal ini hanya memengaruhi sinyal yang menghentikan proses pekerja.

Tag: execution

--[no]experimental_enable_skyfocus default: "false"

Jika benar, aktifkan penggunaan --experimental_active_directories untuk mengurangi jejak memori Bazel untuk build inkremental. Fitur ini dikenal sebagai Skyfocus.

Tag: host_machine_resource_optimizations

Penggunaan --local_resources=<a named double, 'name=value', where value is an integer, or a keyword ("HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "HOST_CPUS", "HOST_CPUS*.5"> beberapa kali akan diakumulasikan

Tetapkan jumlah resource yang tersedia untuk Bazel. Menerima penetapan ke float atau HOST_RAM/HOST_CPUS, yang secara opsional diikuti dengan [-|]<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 dibutuhkan dengan menggunakan tag berformat "resources:<resource name>:<amount>".

Tag: host_machine_resource_optimizations

Opsi yang memengaruhi panjang respons, format, atau lokasi logging:
--build_event_upload_max_retries=<an integer> default: "4"

Jumlah maksimum percobaan ulang Bazel untuk mengupload peristiwa build.

Tag: bazel_internal_configuration

--[no]debug_spawn_scheduler default: "false"
--[no]experimental_bep_target_summary default: "false"

Apakah akan memublikasikan peristiwa TargetSummary.

--[no]experimental_build_event_expand_filesets default: "false"

Jika benar, luaskan Fileset di BEP saat menampilkan file output.

Tag: affects_outputs

Penggunaan --experimental_build_event_output_group_mode=<an output group name followed by an OutputGroupFileMode, e.g. default=both> beberapa kali akan diakumulasikan

Tentukan cara file grup output akan ditampilkan dalam peristiwa BEP TargetComplete/AspectComplete. Nilai adalah penetapan nama grup output ke salah satu dari NAMED_SET_OF_FILES_ONLY, INLINE_ONLY, atau BOTH. Nilai defaultnya adalah NAMED_SET_OF_FILES_ONLY. Jika grup output diulang, nilai akhir yang akan muncul akan digunakan. Nilai default menetapkan mode untuk artefak cakupan ke BOTH: --experimental_build_event_output_group_mode=baseline.lcov=both

Tag: affects_outputs

--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.> default: "1s"

Penundaan awal minimum untuk percobaan ulang backoff eksponensial saat upload BEP gagal. (eksponen: 1,6)

Tag: bazel_internal_configuration

--experimental_build_event_upload_strategy=<a string> default: lihat deskripsi

Memilih cara mengupload artefak yang dirujuk dalam protokol peristiwa build. Di Bazel, opsi yang valid mencakup local dan remote. Nilai defaultnya adalah local.

Tag: affects_outputs

--[no]experimental_docker_verbose default: "false"

Jika diaktifkan, Bazel akan mencetak pesan yang lebih panjang tentang strategi sandbox Docker.

Tag: execution

--experimental_frontier_violation_check=<strict, warn or disabled_for_testing> default: "strict"

Strategi untuk menangani potensi ketidakakuratan dari perubahan di luar batas (yaitu di luar direktori aktif)

Tag: eagerness_to_exit

--[no]experimental_frontier_violation_verbose default: "false"

Jika benar (true), Bazel akan mencetak petunjuk untuk memperbaiki pelanggaran Skycache

Tag: terminal_output

--[no]experimental_materialize_param_files_directly default: "false"

Jika mematerialisasi file param, lakukan dengan penulisan langsung ke disk.

Tag: execution

--[no]experimental_run_bep_event_include_residue default: "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 --experimental_skyfocus_dump_keys=<none, count or verbose>: "none"

Untuk proses debug Skyfocus. Membuang SkyKey yang difokuskan (root, leaf, dependensi yang difokuskan, dependensi terbalik yang difokuskan).

Tag: terminal_output

--[no]experimental_skyfocus_dump_post_gc_stats default: "false"

Untuk proses debug Skyfocus. Jika diaktifkan, picu GC manual sebelum/sesudah fokus untuk melaporkan pengurangan ukuran heap. Tindakan ini akan meningkatkan latensi Skyfocus.

Tag: terminal_output

--[no]experimental_stream_log_file_uploads default: "false"

Mengupload file log streaming langsung ke penyimpanan jarak jauh, bukan menuliskannya ke disk.

Tag: affects_outputs

--explain=<a path> default: lihat deskripsi

Menyebabkan sistem build menjelaskan setiap langkah build yang dieksekusi. Penjelasan ditulis ke file log yang ditentukan.

Tag: affects_outputs

--[no]legacy_important_outputs default: "false"

Gunakan ini untuk menekan pembuatan kolom important_outputs lama di peristiwa TargetComplete. important_outputs diperlukan untuk integrasi Bazel ke ResultStore/BTX.

Tag: affects_outputs

--[no]materialize_param_files default: "false"

Menulis file parameter perantara ke struktur output meskipun menggunakan eksekusi atau caching tindakan jarak jauh. Berguna saat men-debug tindakan. Hal ini tersirat oleh --subcommands dan --verbose_failures.

Tag: execution

--max_config_changes_to_show=<an integer> default: "3"

Saat menghapus cache analisis karena perubahan pada opsi build, akan menampilkan hingga jumlah nama opsi yang berubah yang ditentukan. Jika angka yang diberikan adalah -1, semua opsi yang diubah akan ditampilkan.

Tag: terminal_output

--max_test_output_bytes=<an integer> default: "-1"

Menentukan ukuran maksimum per log pengujian yang dapat dikeluarkan 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

--output_filter=<a valid Java regular expression> default: lihat deskripsi

Hanya menampilkan output peringatan dan tindakan untuk aturan dengan nama yang cocok dengan ekspresi reguler yang diberikan.

Tag: affects_outputs

--progress_report_interval=<an integer in 0-3600 range> default: "0"

Jumlah detik 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 itu progres dilaporkan setiap menit. Jika --curses diaktifkan, progres dilaporkan setiap detik.

Tag: affects_outputs

--remote_analysis_json_log=<a string> default: lihat deskripsi

Jika disetel, file JSON akan ditulis ke lokasi ini yang berisi log mendetail tentang perilaku caching analisis jarak jauh. Ditafsirkan sebagai jalur relatif terhadap direktori kerja saat ini.

Tag: bazel_monitoring

--remote_print_execution_messages=<failure, success or all> default: "failure"

Pilih kapan pesan eksekusi jarak jauh akan dicetak. Nilai yang valid adalah failure, untuk mencetak hanya jika gagal, success untuk mencetak hanya jika berhasil, dan all untuk selalu mencetak.

Tag: terminal_output

--[no]sandbox_debug default: "false"

Mengaktifkan fitur proses debug untuk fitur kotak pasir. Hal ini mencakup dua hal: pertama, konten root sandbox tidak berubah setelah build; dan kedua, mencetak informasi debug tambahan saat eksekusi. Hal ini dapat membantu developer aturan Bazel atau Starlark dalam men-debug kegagalan karena file input yang tidak ada, dll.

Tag: terminal_output

--show_result=<an integer> default: "1"

Tampilkan hasil build. Untuk setiap target, nyatakan apakah target tersebut telah diperbarui atau tidak, dan jika ya, daftar file output yang dibuat. File yang dicetak adalah string yang mudah disalin+ditempel ke shell, untuk dieksekusi.

Opsi ini memerlukan argumen bilangan bulat, yaitu jumlah minimum target yang di atasnya informasi hasil tidak dicetak. Dengan demikian, nol menyebabkan penekanan pesan dan MAX_INT menyebabkan hasil selalu dicetak. Nilai defaultnya adalah satu.

Jika tidak ada yang dibuat untuk target, hasilnya dapat dihilangkan agar output tidak melebihi nilai minimum.

Tag: affects_outputs

--[no]subcommands [-s] default: "false"

Menampilkan subperintah yang dijalankan selama build. Flag terkait: --execution_log_json_file, --execution_log_binary_file (untuk mencatat subperintah ke file dalam format yang kompatibel dengan alat).

Tag: terminal_output

--test_output=<summary, errors, all or streamed> default: "summary"

Menentukan mode output yang diinginkan. Nilai yang valid adalah 'summary' untuk menampilkan hanya ringkasan status pengujian, 'errors' untuk mencetak log pengujian juga 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: "short"

Menentukan format ringkasan pengujian yang diinginkan. Nilai yang valid adalah 'short' untuk mencetak informasi hanya tentang pengujian yang dijalankan, 'terse' untuk mencetak informasi hanya tentang pengujian yang gagal dijalankan, 'detailed' untuk mencetak informasi mendetail tentang kasus pengujian yang gagal, 'testcase' untuk mencetak ringkasan dalam penyelesaian kasus pengujian, tidak mencetak informasi mendetail tentang kasus pengujian yang gagal, dan 'none' untuk menghilangkan ringkasan.

Tag: terminal_output

--[no]verbose_failures default: "false"

Jika perintah gagal, cetak command line lengkap.

Tag: terminal_output

Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
Penggunaan --aspects_parameters=<a 'name=value' assignment> beberapa kali akan 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 menetapkan nilai ke parameter yang sama lebih dari sekali.

Tag: loading_and_analysis

--target_pattern_file=<a string> default: ""

Jika disetel, build akan membaca pola dari file yang dinamai di sini, bukan di command line. Menentukan file di sini serta pola command line adalah suatu kesalahan.

Tag: changes_inputs

Opsi eksekusi dan caching jarak jauh:
--experimental_circuit_breaker_strategy=<failure> default: lihat deskripsi

Menentukan strategi yang akan digunakan untuk pemutus sirkuit. Strategi yang tersedia adalah "kegagalan". Jika nilai opsi tidak valid, perilakunya sama seperti opsi tidak ditetapkan.

Tag: execution

--experimental_remote_cache_compression_threshold=<an integer> default: "100"

Ukuran blob minimum yang diperlukan untuk mengompresi/mendekompresi dengan zstd. Tidak efektif kecuali jika --remote_cache_compression ditetapkan.

--experimental_remote_cache_eviction_retries=<an integer> default: "5"

Jumlah maksimum upaya percobaan ulang jika build mengalami error cache jarak jauh sementara yang akan menyebabkan build gagal. Berlaku misalnya saat artefak dikeluarkan dari cache jarak jauh, atau dalam kondisi kegagalan cache tertentu. ID pemanggilan baru akan dibuat untuk setiap upaya.

Tag: execution

--[no]experimental_remote_cache_lease_extension default: "false"

Jika disetel ke benar (true), Bazel akan memperpanjang masa berlaku 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.

--experimental_remote_cache_ttl=<An immutable length of time.> default: "3h"

TTL minimal yang dijamin untuk blob 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

--experimental_remote_capture_corrupted_outputs=<a path> default: lihat deskripsi

Jalur ke direktori tempat output yang rusak akan direkam.

--[no]experimental_remote_discard_merkle_trees default: "true"

Jika disetel ke benar (true), hapus salinan dalam memori dari pohon Merkle input root dan pemetaan input terkait selama panggilan ke GetActionResult() dan Execute(). Hal ini mengurangi penggunaan memori secara signifikan, tetapi mengharuskan Bazel menghitung ulang salinan tersebut saat terjadi error cache jarak jauh dan percobaan ulang.

--experimental_remote_downloader=<a string> default: lihat deskripsi

URI endpoint Remote Asset API, yang akan digunakan sebagai proxy download jarak jauh. Skema yang didukung adalah grpc, grpcs (grpc dengan TLS diaktifkan), dan unix (soket UNIX lokal). Jika tidak ada skema yang diberikan, Bazel akan menggunakan grpcs secara default. Lihat: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto

--[no]experimental_remote_downloader_local_fallback default: "false"

Apakah akan kembali ke downloader lokal jika downloader jarak jauh gagal.

--[no]experimental_remote_downloader_propagate_credentials default: "false"

Apakah akan menyebarkan kredensial dari netrc dan credential helper ke server downloader jarak jauh. Implementasi server harus mendukung kualifikasi http_header_url:<url-index>:<header-key> baru dengan <url-index> adalah posisi berbasis 0 dari URL di dalam kolom uris FetchBlobRequest. Header khusus URL harus lebih diutamakan daripada header global.

--experimental_remote_failure_rate_threshold=<an integer in 0-100 range> default: "10"

Menetapkan jumlah tingkat kegagalan yang diizinkan dalam persentase untuk jangka waktu tertentu setelah itu berhenti memanggil cache/pelaksana jarak jauh. Secara default, nilainya adalah 10. Jika disetel ke 0, tidak ada batasan.

Tag: execution

--experimental_remote_failure_window_interval=<An immutable length of time.> default: "60s"

Interval saat tingkat kegagalan permintaan jarak jauh dihitung. Jika nilai nol atau negatif, durasi kegagalan dihitung selama durasi eksekusi.Unit berikut dapat digunakan: Hari (d), jam (h), menit (m), detik (s), dan milidetik (ms). Jika unit tidak disertakan, nilai akan ditafsirkan sebagai detik.

Tag: execution

--[no]experimental_remote_mark_tool_inputs default: "false"

Jika disetel ke benar (true), Bazel akan menandai input sebagai input alat untuk eksekutor jarak jauh. Hal ini dapat digunakan untuk menerapkan pekerja persisten jarak jauh.

--experimental_remote_output_service=<a string> default: lihat deskripsi

HOST atau HOST:PORT endpoint layanan output jarak jauh. Skema yang didukung adalah grpc, grpcs (grpc dengan TLS diaktifkan), dan unix (soket UNIX lokal). Jika tidak ada skema yang diberikan, Bazel akan menggunakan grpcs secara default. Tentukan skema grpc:// atau unix: untuk menonaktifkan TLS.

--experimental_remote_output_service_output_path_prefix=<a string> default: ""

Jalur tempat konten direktori output yang dikelola oleh --experimental_remote_output_service ditempatkan. Direktori output sebenarnya yang digunakan oleh build akan menjadi turunan dari jalur ini dan ditentukan oleh layanan output.

--[no]experimental_remote_require_cached default: "false"

Jika disetel ke benar (true), terapkan agar semua tindakan yang dapat dijalankan dari jarak jauh di-cache, atau gagal membangun. Hal ini berguna untuk memecahkan masalah non-deterministik karena memungkinkan pemeriksaan apakah tindakan yang harus di-cache benar-benar di-cache tanpa secara keliru menyuntikkan hasil baru ke dalam cache.

--experimental_remote_scrubbing_config=<Converts to a Scrubber> default: lihat deskripsi

Mengaktifkan penghapusan kunci cache jarak jauh dengan file konfigurasi yang diberikan, yang harus berupa buffer protokol dalam format teks (lihat src/main/protobuf/remote_scrubbing.proto).

Fitur ini dimaksudkan untuk memfasilitasi berbagi cache disk/jarak jauh antara tindakan yang dieksekusi di platform yang berbeda, tetapi menargetkan platform yang sama. Fitur ini harus digunakan dengan sangat hati-hati, karena setelan yang tidak tepat dapat menyebabkan berbagi entri cache yang tidak disengaja dan menghasilkan build yang salah.

Menyaring tidak memengaruhi cara tindakan dieksekusi, hanya cara kunci cache disk/jaraknya dihitung untuk tujuan mengambil atau menyimpan hasil tindakan. Tindakan yang dibersihkan tidak kompatibel dengan eksekusi jarak jauh, dan akan selalu dieksekusi secara lokal.

Memodifikasi konfigurasi scrubbing tidak membatalkan output yang ada di sistem file lokal atau cache internal; build bersih diperlukan untuk mengeksekusi ulang tindakan yang terpengaruh.

Agar berhasil menggunakan fitur ini, Anda sebaiknya menetapkan --host_platform kustom bersama dengan --experimental_platform_in_output_dir (untuk menormalisasi awalan output).

Default --[no]guard_against_concurrent_changes: "lite"

Tetapkan ini ke 'full' untuk mengaktifkan pemeriksaan ctime semua file input tindakan sebelum menguploadnya ke cache jarak jauh. Mungkin ada kasus saat kernel Linux menunda penulisan file, yang dapat menyebabkan positif palsu. Defaultnya adalah 'lite', yang hanya memeriksa file sumber di repositori utama. Menyetelnya ke 'nonaktif' akan menonaktifkan semua pemeriksaan. Hal ini tidak direkomendasikan, karena cache dapat tercemar saat file sumber diubah saat tindakan yang mengambilnya sebagai input sedang dieksekusi.

Tag: execution

--[no]remote_accept_cached default: "true"

Apakah akan menerima hasil tindakan yang di-cache dari jarak jauh.

--remote_build_event_upload=<all or minimal> default: "minimal"

Jika disetel ke 'all', semua output lokal yang dirujuk oleh BEP akan diupload ke cache jarak jauh. Jika disetel ke 'minimal', output lokal yang dirujuk oleh BEP tidak diupload ke cache jarak jauh, kecuali untuk file yang penting bagi konsumen BEP (misalnya, log pengujian dan profil pengaturan waktu). Skema bytestream:// selalu digunakan untuk URI file meskipun file tersebut tidak ada di cache jarak jauh. Nilai defaultnya adalah 'minimal'.

--remote_bytestream_uri_prefix=<a string> default: lihat deskripsi

Nama host dan nama instance yang akan digunakan dalam URI bytestream:// yang ditulis ke dalam aliran peristiwa build. Opsi ini dapat 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 disetel, defaultnya adalah "${hostname}/${instance_name}".

--remote_cache=<a string> default: lihat deskripsi

URI endpoint caching. 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 menggunakan grpcs secara default. Tentukan skema grpc://, http://, atau unix: untuk menonaktifkan TLS. Lihat https://bazel.build/remote/caching

--[no]remote_cache_async default: "true"

Jika benar, upload hasil tindakan ke disk atau cache jarak jauh akan terjadi di latar belakang, bukan memblokir penyelesaian tindakan. Beberapa tindakan tidak kompatibel dengan upload di latar belakang, dan mungkin tetap memblokir meskipun tanda ini disetel.

--[no]remote_cache_compression default: "false"

Jika diaktifkan, kompres/dekompresi blob cache dengan zstd jika ukurannya minimal --experimental_remote_cache_compression_threshold.

Penggunaan --remote_cache_header=<a 'name=value' assignment> beberapa kali akan 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.

Penggunaan --remote_default_exec_properties=<a 'name=value' assignment> beberapa kali akan diakumulasikan

Menetapkan properti eksekusi default yang akan digunakan sebagai platform eksekusi jarak jauh jika platform eksekusi belum menetapkan exec_properties.

Tag: affects_outputs

Penggunaan --remote_download_regex=<a valid Java regular expression> beberapa kali akan diakumulasikan

Memaksa output build jarak jauh yang jalur filenya cocok dengan pola ini untuk didownload, terlepas dari --remote_download_outputs. Beberapa pola dapat ditentukan dengan mengulangi tanda ini.

Tag: affects_outputs

Penggunaan --remote_downloader_header=<a 'name=value' assignment> beberapa kali akan diakumulasikan

Tentukan header yang akan disertakan dalam permintaan pengunduh jarak jauh: --remote_downloader_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.

Penggunaan --remote_exec_header=<a 'name=value' assignment> beberapa kali akan 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.

--remote_execution_priority=<an integer> default: "0"

Prioritas relatif tindakan yang akan dieksekusi dari jarak jauh. Semantik nilai prioritas tertentu bergantung pada server.

--remote_executor=<a string> default: lihat deskripsi

HOST atau HOST:PORT endpoint eksekusi jarak jauh. Skema yang didukung adalah grpc, grpcs (grpc dengan TLS diaktifkan), dan unix (soket UNIX lokal). Jika tidak ada skema yang diberikan, Bazel akan menggunakan grpcs secara default. Tentukan skema grpc:// atau unix: untuk menonaktifkan TLS.

--remote_grpc_log=<a path> default: lihat deskripsi

Jika ditentukan, jalur ke file untuk mencatat detail terkait panggilan gRPC. Log ini terdiri dari urutan protobuf com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry yang diserialisasi dengan setiap pesan yang diawali dengan varint yang menunjukkan ukuran pesan protobuf yang diserialisasi berikutnya, seperti yang dilakukan oleh metode LogEntry.writeDelimitedTo(OutputStream).

Penggunaan --remote_header=<a 'name=value' assignment> beberapa kali akan diakumulasikan

Tentukan header yang akan disertakan dalam permintaan: --remote_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_instance_name=<a string> default: ""

Nilai yang akan diteruskan sebagai instance_name di API eksekusi jarak jauh.

--[no]remote_local_fallback default: "false"

Apakah akan melakukan fallback ke strategi eksekusi lokal mandiri jika eksekusi jarak jauh gagal.

--remote_local_fallback_strategy=<a string> default: "local"

Tidak digunakan lagi. Lihat https://github.com/bazelbuild/bazel/issues/7480 untuk mengetahui detailnya.

--remote_max_concurrency_per_connection=<an integer> default: "100"

Batasi jumlah maksimum permintaan serentak per koneksi gRPC. Secara default, nilainya adalah 100.

Tag: host_machine_resource_optimizations

--remote_max_connections=<an integer> default: "100"

Membatasi jumlah maksimum koneksi serentak ke cache/pelaksana jarak jauh. Secara default, nilainya adalah 100. Jika disetel ke 0, 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/pelaksana jarak jauh gRPC, satu saluran gRPC biasanya dapat menangani 100+ permintaan serentak (dikontrol oleh --remote_max_concurrency_per_connection), sehingga Bazel dapat membuat sekitar --remote_max_connections * 100 permintaan serentak.

Tag: host_machine_resource_optimizations

--remote_proxy=<a string> default: lihat deskripsi

Hubungkan ke cache jarak jauh melalui proxy. Saat ini, tanda ini hanya dapat digunakan untuk mengonfigurasi soket domain Unix (unix:/path/to/socket).

--remote_result_cache_priority=<an integer> default: "0"

Prioritas relatif tindakan jarak jauh yang akan disimpan dalam cache jarak jauh. Semantik nilai prioritas tertentu bergantung pada server.

--remote_retries=<an integer> default: "5"

Jumlah maksimum upaya untuk mencoba ulang error sementara. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.

--remote_retry_max_delay=<An immutable length of time.> default: "5s"

Penundaan backoff maksimum antara upaya percobaan ulang jarak jauh. Unit berikut dapat digunakan: Hari (d), jam (h), menit (m), detik (s), dan milidetik (ms). Jika unit tidak disertakan, nilai akan ditafsirkan sebagai detik.

--remote_timeout=<An immutable length of time.> default: "60s"

Jumlah waktu maksimum untuk menunggu eksekusi jarak jauh dan panggilan cache. Untuk cache REST, ini adalah waktu tunggu koneksi dan baca. Unit berikut dapat digunakan: Hari (d), jam (h), menit (m), detik (s), dan milidetik (ms). Jika unit tidak disertakan, nilai akan ditafsirkan sebagai detik.

--[no]remote_upload_local_results default: "true"

Apakah akan mengupload hasil tindakan yang dieksekusi secara lokal ke cache jarak jauh jika cache jarak jauh mendukungnya dan pengguna diizinkan untuk melakukannya.

--[no]remote_verify_downloads default: "true"

Jika disetel ke benar (true), Bazel akan menghitung jumlah hash semua download jarak jauh dan membuang nilai yang di-cache dari jarak jauh jika tidak cocok dengan nilai yang diharapkan.

Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
--[no]allow_analysis_cache_discard default: "true"

Jika membuang cache analisis karena perubahan pada sistem build, menyetel opsi ini ke salah (false) akan menyebabkan bazel keluar, bukan melanjutkan build. Opsi ini tidak berpengaruh jika --discard_analysis_cache juga ditetapkan.

Tag: eagerness_to_exit

Default --auto_output_filter=<none, all, packages or subpackages>: "none"

Jika --output_filter tidak ditentukan, nilai untuk opsi ini akan digunakan untuk membuat filter secara otomatis. Nilai yang diizinkan adalah 'none' (tidak 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)'.

--[no]build_manual_tests default: "false"

Memaksa target pengujian yang diberi tag 'manual' untuk dibangun. Pengujian 'manual' dikecualikan dari pemrosesan. Opsi ini memaksanya untuk dibangun (tetapi tidak dieksekusi).

--build_tag_filters=<comma-separated list of options> default: ""

Menentukan daftar tag yang dipisahkan koma. Setiap tag dapat diawali dengan '-' untuk menentukan tag yang dikecualikan. Hanya target yang berisi setidaknya satu tag yang disertakan dan tidak berisi tag yang dikecualikan yang akan dibuat. Opsi ini tidak memengaruhi kumpulan pengujian yang dijalankan dengan perintah 'test'; pengujian tersebut diatur oleh opsi pemfilteran pengujian, misalnya '--test_tag_filters'

--[no]build_tests_only default: "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 dibuat.

--combined_report=<none or lcov> default: "lcov"

Menentukan jenis laporan cakupan kumulatif yang diinginkan. Saat ini, hanya LCOV yang didukung.

--[no]compile_one_dependency default: "false"

Kompilasi satu dependensi file argumen. Hal ini berguna untuk memeriksa sintaksis file sumber di IDE, misalnya, dengan membangun kembali satu target yang bergantung pada file sumber untuk mendeteksi error sedini mungkin dalam siklus pengeditan/build/pengujian. Argumen ini memengaruhi cara semua argumen non-flag ditafsirkan; alih-alih menjadi target untuk dibangun, argumen tersebut adalah nama file sumber. Untuk setiap nama file sumber, target arbitrer yang bergantung padanya akan dibuat.

Penggunaan --deleted_packages=<comma-separated list of package names> beberapa kali akan diakumulasikan

Daftar nama paket yang dipisahkan koma yang akan dianggap tidak ada oleh sistem build, meskipun paket tersebut 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 menampilkan error jika menemukan label '//x:y/z' jika label tersebut masih disediakan oleh entri package_path lain. Menentukan --deleted_packages x/y akan menghindari masalah ini.

--[no]discard_analysis_cache default: "false"

Buang cache analisis segera setelah fase analisis selesai. Mengurangi penggunaan memori sebesar ~10%, tetapi membuat build inkremental lebih lambat.

--disk_cache=<a path> default: lihat deskripsi

Jalur ke direktori tempat Bazel dapat membaca dan menulis tindakan serta output tindakan. Jika tidak ada, direktori akan dibuat.

--embed_label=<a one-line string> default: ""

Menyematkan revisi kontrol sumber atau label rilis dalam biner

--execution_log_binary_file=<a path> default: lihat deskripsi

Mencatat spawn yang dieksekusi ke dalam file ini sebagai proto SpawnExec yang dibatasi panjangnya, sesuai dengan src/main/protobuf/spawn.proto. Lebih baik gunakan --execution_log_compact_file, yang ukurannya 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).

--execution_log_compact_file=<a path> default: lihat deskripsi

Mencatat spawn yang dieksekusi ke dalam file ini sebagai proto ExecLogEntry yang dibatasi panjangnya, sesuai dengan src/main/protobuf/spawn.proto. Seluruh file dikompresi zstd. Flag terkait: --execution_log_binary_file (format protobuf biner; eksklusif), --execution_log_json_file (format JSON teks; eksklusif), --subcommands (untuk menampilkan subperintah dalam output terminal).

--execution_log_json_file=<a path> default: lihat deskripsi

Mencatat spawn yang dieksekusi ke dalam file ini sebagai representasi JSON SpawnExec protos yang dibatasi baris baru, sesuai dengan src/main/protobuf/spawn.proto. Lebih baik gunakan --execution_log_compact_file, yang ukurannya jauh lebih kecil dan lebih murah untuk dibuat. Flag terkait: --execution_log_compact_file (format ringkas; eksklusif), --execution_log_binary_file (format protobuf biner; eksklusif), --execution_log_sort (apakah akan mengurutkan log eksekusi), --subcommands (untuk menampilkan subperintah dalam output terminal).

--[no]execution_log_sort default: "true"

Apakah akan mengurutkan log eksekusi, sehingga mempermudah perbandingan log di seluruh pemanggilan. Setel ke salah (false) untuk menghindari penggunaan CPU dan memori yang berpotensi signifikan di akhir pemanggilan, dengan biaya menghasilkan log dalam urutan eksekusi non-deterministik. Hanya berlaku untuk format biner dan JSON; format ringkas tidak pernah diurutkan.

--[no]expand_test_suites default: "true"

Perluas target test_suite ke dalam pengujian penyusunnya sebelum analisis. Jika tanda ini diaktifkan (default), pola target negatif akan berlaku untuk pengujian yang termasuk dalam rangkaian pengujian, jika tidak, pola target negatif tidak akan berlaku. Menonaktifkan tanda ini berguna saat aspek tingkat teratas diterapkan di command line: lalu, aspek tersebut dapat menganalisis target test_suite.

Tag: loading_and_analysis

--experimental_disk_cache_gc_idle_delay=<An immutable length of time.> default: "5m"

Durasi server harus tetap tidak ada aktivitas sebelum pengumpulan sampah cache disk terjadi. Untuk menentukan kebijakan pengumpulan sampah, tetapkan --experimental_disk_cache_gc_max_size dan/atau --experimental_disk_cache_gc_max_age.

--experimental_disk_cache_gc_max_age=<An immutable length of time.> default: "0"

Jika disetel ke nilai positif, cache disk akan dibersihkan sampah memori 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. Pengumpulan sampah terjadi di latar belakang setelah server menjadi tidak aktif, sebagaimana ditentukan oleh tanda --experimental_disk_cache_gc_idle_delay.

--experimental_disk_cache_gc_max_size=<a size in bytes, optionally followed by a K, M, G or T multiplier> default: "0"

Jika disetel ke nilai positif, cache disk akan secara berkala dikumpulkan sampah untuk tetap berada di bawah ukuran ini. Jika disetel bersama dengan --experimental_disk_cache_gc_max_age, kedua kriteria akan diterapkan. Pengumpulan sampah terjadi di latar belakang setelah server menjadi tidak aktif, sebagaimana ditentukan oleh tanda --experimental_disk_cache_gc_idle_delay.

--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> default: ""

Tidak digunakan lagi dan digantikan dengan aspek. Memfilter kumpulan target untuk menjadwalkan extra_actions.

--[no]experimental_extra_action_top_level_only default: "false"

Tidak digunakan lagi dan digantikan dengan aspek. Hanya menjadwalkan extra_actions untuk target tingkat teratas.

--experimental_spawn_scheduler

Aktifkan eksekusi dinamis dengan menjalankan tindakan secara paralel di lokal dan jarak jauh. Bazel memunculkan setiap tindakan secara lokal dan jarak jauh, lalu memilih tindakan yang selesai terlebih dahulu. Jika tindakan mendukung pekerja, tindakan lokal akan dijalankan dalam mode pekerja persisten. Untuk mengaktifkan eksekusi dinamis untuk mnemonik tindakan individual, gunakan tanda --internal_spawn_scheduler dan --strategy=<mnemonic>=dynamic.

Meluas menjadi:
  --internal_spawn_scheduler
  --spawn_strategy=dynamic

--[no]fetch default: "true"

Mengizinkan perintah untuk mengambil dependensi eksternal. Jika disetel ke salah (false), perintah akan menggunakan versi dependensi yang di-cache, dan jika tidak ada, perintah akan gagal.

--local_termination_grace_seconds=<an integer> default: "15"

Waktu tunggu antara menghentikan proses lokal karena waktu tunggu berakhir dan mematikannya secara paksa.

--package_path=<colon-separated list of options> default: "%workspace%"

Daftar tempat untuk mencari paket yang dipisahkan dengan titik dua. Elemen yang diawali dengan '%workspace%' bersifat relatif terhadap ruang kerja yang melampirkannya. Jika tidak ada atau kosong, defaultnya adalah output 'bazel info default-package-path'.

--[no]show_loading_progress default: "true"

Jika diaktifkan, Bazel akan mencetak pesan "Loading package:".

--test_lang_filters=<comma-separated list of options> default: ""

Menentukan daftar bahasa pengujian yang dipisahkan koma. Setiap bahasa dapat secara opsional diawali 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.

--test_size_filters=<comma-separated list of values: small, medium, large, or enormous> default: ""

Menentukan daftar ukuran pengujian yang dipisahkan koma. Setiap ukuran dapat secara opsional diawali dengan '-' untuk menentukan ukuran yang dikecualikan. Hanya target pengujian yang berisi setidaknya satu ukuran yang disertakan dan tidak berisi ukuran yang dikecualikan yang akan ditemukan. Opsi ini memengaruhi perilaku --build_tests_only dan perintah pengujian.

--test_tag_filters=<comma-separated list of options> default: ""

Menentukan daftar tag pengujian yang dipisahkan koma. Setiap tag dapat diawali dengan '-' 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.

--test_timeout_filters=<comma-separated list of values: short, moderate, long, or eternal> default: ""

Menentukan daftar waktu tunggu pengujian yang dipisahkan koma. Setiap waktu tunggu dapat secara opsional diawali 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.

--workspace_status_command=<path> default: ""

Perintah yang dipanggil di awal build untuk memberikan informasi status tentang ruang kerja dalam bentuk key/value pair. Lihat Panduan Pengguna untuk mengetahui spesifikasi lengkapnya. Lihat juga tools/buildstamp/get_workspace_status untuk melihat contohnya.

Opsi yang mengontrol eksekusi build:
--[no]experimental_persistent_aar_extractor default: "false"

Aktifkan pengekstrak aar persisten menggunakan pekerja.

Tag: execution, experimental

--[no]experimental_remotable_source_manifests default: "false"

Apakah tindakan manifes sumber dapat dilakukan dari jarak jauh

Tag: loading_and_analysis, execution, experimental

--[no]experimental_split_coverage_postprocessing default: "false"

Jika benar, Bazel akan menjalankan pemrosesan pasca-cakupan untuk pengujian di proses baru.

Tag: execution, experimental

--[no]experimental_strict_fileset_output default: "false"

Jika opsi ini diaktifkan, set file akan memperlakukan semua artefak output sebagai file biasa. File tidak akan melintasi direktori atau sensitif terhadap symlink.

Tag: execution, experimental

--[no]incompatible_modify_execution_info_additive default: "true"

Jika diaktifkan, meneruskan beberapa tanda --modify_execution_info bersifat aditif. Jika dinonaktifkan, hanya tanda terakhir yang akan dipertimbangkan.

Tag: execution, affects_outputs, loading_and_analysis, incompatible_change

Penggunaan --modify_execution_info=<regex=[+-]key,regex=[+-]key,...> beberapa kali akan diakumulasikan

Menambahkan atau menghapus kunci dari info eksekusi tindakan berdasarkan mnemonik tindakan. Hanya berlaku untuk tindakan yang mendukung info eksekusi. Banyak tindakan umum yang mendukung info eksekusi, misalnya Genrule, CppCompile, Javac, StarlarkAction, TestRunner. Saat menentukan beberapa nilai, urutan penting karena banyak ekspresi reguler dapat berlaku untuk mnemonik yang sama.

Sintaksis: regex=[+-]key,regex=[+-]key,....

Contoh:

  • .*=+x,.*=-y,.*=+z menambahkan x dan z ke, serta 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 persisten menggunakan pekerja.

Meluas 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 dengan menggunakan pekerja.

Meluas 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

Aktifkan tindakan desugar dan dex Android multiplex persisten menggunakan pekerja.

Meluas 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 yang di-multiplex secara persisten menggunakan pekerja.

Diluaskan 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

Aktifkan alat Android persisten dan yang di-multiplex (dexing, desugaring, pemrosesan resource).

Meluas menjadi:
  --internal_persistent_multiplex_busybox_tools
  --persistent_multiplex_android_resource_processor
  --persistent_multiplex_android_dex_desugar

Tag: host_machine_resource_optimizations, execution

--[no]use_target_platform_for_tests default: "false"

Jika benar (true), gunakan platform target untuk menjalankan pengujian, bukan grup eksekusi pengujian.

Tag: execution

Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
--android_compiler=<a string> default: lihat deskripsi

Compiler target Android.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state

--android_manifest_merger=<legacy, android or force_android> default: "android"

Memilih penggabung manifes yang akan digunakan untuk aturan android_binary. Flag untuk membantu transisi ke penggabung manifes Android dari penggabung lama.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state

--android_platforms=<a build target label> default: ""

Menetapkan platform yang digunakan oleh target android_binary. Jika beberapa platform ditentukan, maka biner adalah APK gemuk, yang berisi biner native untuk setiap platform target yang ditentukan.

Tag: changes_inputs, loading_and_analysis, loses_incremental_state

--cc_output_directory_tag=<a string> default: ""

Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.

Tag: affects_outputs

--compiler=<a string> default: lihat deskripsi

Compiler C++ yang akan digunakan untuk mengompilasi target.

Tag: loading_and_analysis, execution

--coverage_output_generator=<a build target label> default: "@bazel_tools//tools/test:lcov_merger"

Lokasi biner yang digunakan untuk memproses laporan cakupan mentah. Target ini harus berupa biner. Default-nya adalah @bazel_tools//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. Target ini harus berupa biner. Default-nya adalah @bazel_tools//tools/test:coverage_report_generator.

Tag: changes_inputs, affects_outputs, loading_and_analysis

--coverage_support=<a build target label> default: "@bazel_tools//tools/test:coverage_support"

Lokasi file dukungan yang diperlukan pada input setiap tindakan pengujian yang mengumpulkan cakupan kode. Default-nya adalah //tools/test:coverage_support.

Tag: changes_inputs, affects_outputs, loading_and_analysis

--custom_malloc=<a build target label> default: lihat deskripsi

Menentukan implementasi malloc kustom. Setelan ini menggantikan atribut malloc dalam aturan build.

Tag: changes_inputs, affects_outputs

--[no]experimental_include_xcode_execution_requirements default: "false"

Jika disetel, tambahkan persyaratan eksekusi "requires-xcode:{version}" ke setiap tindakan Xcode. Jika versi Xcode memiliki label bergaris hubung, tambahkan juga persyaratan eksekusi "requires-xcode-label:{version_label}".

Tag: loses_incremental_state, loading_and_analysis, execution, experimental

--[no]experimental_prefer_mutual_xcode default: "true"

Jika benar, gunakan Xcode terbaru yang tersedia secara lokal dan jarak jauh. Jika salah (false), atau jika tidak ada versi yang tersedia bersama, gunakan versi Xcode lokal yang dipilih melalui xcode-select.

Tag: loses_incremental_state, experimental

--extra_execution_platforms=<comma-separated list of options> default: ""

Platform yang tersedia sebagai platform eksekusi untuk menjalankan tindakan. Platform dapat ditentukan berdasarkan target yang tepat, atau sebagai pola target. Platform ini akan dipertimbangkan sebelum platform yang dideklarasikan dalam file WORKSPACE oleh register_execution_platforms(). Opsi ini hanya dapat ditetapkan satu kali; instance selanjutnya akan menggantikan setelan tanda sebelumnya.

Tag: execution

Penggunaan --extra_toolchains=<comma-separated list of options> beberapa kali akan diakumulasikan

Aturan toolchain yang akan dipertimbangkan selama penyelesaian toolchain. Rangkaian alat dapat ditentukan berdasarkan target yang persis, atau sebagai pola target. Rangkaian alat ini akan dipertimbangkan sebelum rangkaian alat yang dideklarasikan dalam file WORKSPACE oleh register_toolchains().

Tag: affects_outputs, changes_inputs, loading_and_analysis

--grte_top=<a label> default: lihat deskripsi

Label untuk library libc yang di-check in. Nilai default dipilih oleh toolchain crosstool, dan Anda hampir tidak perlu menggantinya.

Tag: action_command_lines, affects_outputs

--host_compiler=<a string> default: lihat deskripsi

Flag tanpa pengoperasian. Akan dihapus dalam rilis mendatang.

Tag: loading_and_analysis, execution

--host_grte_top=<a label> default: lihat deskripsi

Jika ditentukan, setelan ini akan menggantikan direktori tingkat teratas libc (--grte_top) untuk konfigurasi 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_bazel_test_exec_run_under default: "true"

Jika diaktifkan, bazel test --run_under=//:runner akan membuat //:runner dalam konfigurasi exec. Jika dinonaktifkan, //:runner akan dibuat dalam konfigurasi target. Bazel menjalankan pengujian di mesin eksekusi, sehingga yang pertama lebih tepat. Hal ini tidak memengaruhi bazel run, yang selalu membangun --run_under=//foo dalam konfigurasi target.

Tag: affects_outputs, incompatible_change

--[no]incompatible_builtin_objc_strip_action default: "true"

Apakah akan memancarkan tindakan penghapusan sebagai bagian dari penautan objc.

Tag: action_command_lines, incompatible_change

--[no]incompatible_dont_enable_host_nonhost_crosstool_features default: "true"

Jika benar (true), 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_apple_toolchain_resolution default: "false"

Menggunakan penyelesaian toolchain untuk memilih Apple SDK untuk aturan Apple (Starlark dan native)

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_strip_executable_safely default: "false"

Jika benar, tindakan penghapusan untuk file yang dapat dieksekusi akan menggunakan flag -x, yang tidak merusak resolusi simbol dinamis.

Tag: action_command_lines, incompatible_change

--[no]interface_shared_objects default: "true"

Gunakan objek bersama antarmuka jika didukung oleh toolchain. Semua toolchain ELF saat ini mendukung setelan ini.

Tag: loading_and_analysis, affects_outputs, affects_outputs

--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Menentukan versi iOS SDK yang akan digunakan untuk membangun aplikasi iOS. Jika tidak ditentukan, akan menggunakan versi iOS SDK default dari 'xcode_version'.

Tag: loses_incremental_state

--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Menentukan versi macOS SDK yang akan digunakan untuk membangun aplikasi macOS. Jika tidak ditentukan, akan menggunakan versi SDK macOS default dari 'xcode_version'.

Tag: loses_incremental_state

--minimum_os_version=<a string> default: lihat deskripsi

Versi OS minimum yang ditargetkan kompilasi Anda.

Tag: loading_and_analysis, affects_outputs

--platform_mappings=<a main workspace-relative path> default: ""

Lokasi file pemetaan yang menjelaskan platform mana yang akan digunakan jika tidak ada yang ditetapkan atau tanda mana yang akan ditetapkan jika platform sudah ada. Harus relatif terhadap root ruang kerja utama. Defaultnya adalah platform_mappings (file langsung di bawah root ruang kerja).

Tag: affects_outputs, changes_inputs, loading_and_analysis, non_configurable

--platforms=<a build target label> default: ""

Label aturan platform yang menjelaskan platform target untuk perintah saat ini.

Tag: affects_outputs, changes_inputs, loading_and_analysis

--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Menentukan versi tvOS SDK yang akan digunakan untuk membangun aplikasi tvOS. Jika tidak ditentukan, gunakan versi tvOS SDK default dari 'xcode_version'.

Tag: loses_incremental_state

--[no]use_platforms_in_apple_crosstool_transition default: "false"

Membuat apple_crosstool_transition kembali menggunakan nilai flag --platforms, bukan --cpu lama jika diperlukan.

Tag: loading_and_analysis

--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Menentukan versi watchOS SDK yang akan digunakan untuk membangun aplikasi watchOS. Jika tidak ditentukan, akan menggunakan versi SDK watchOS default dari 'xcode_version'.

Tag: loses_incremental_state

--xcode_version=<a string> default: lihat deskripsi

Jika ditentukan, gunakan Xcode versi tertentu untuk tindakan build yang relevan. Jika tidak ditentukan, akan menggunakan Xcode versi default executor.

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:
--[no]apple_generate_dsym default: "false"

Apakah akan membuat file simbol debug (.dSYM).

Tag: affects_outputs, action_command_lines

Jika benar, bangun hutan symlink runfile untuk semua target. Jika salah (false), tulis hanya jika diperlukan oleh perintah tindakan, pengujian, atau jalankan lokal.

Tag: affects_outputs

--[no]build_runfile_manifests default: "true"

Jika benar, tulis manifes file yang dapat dijalankan untuk semua target. Jika salah (false), hapus. Pengujian lokal akan gagal dijalankan jika salah (false).

Tag: affects_outputs

--[no]build_test_dwp default: "false"

Jika diaktifkan, saat membuat pengujian C++ secara statis dan dengan fission, file .dwp untuk biner pengujian juga akan dibuat secara otomatis.

Tag: loading_and_analysis, affects_outputs

--cc_proto_library_header_suffixes=<comma-separated set of options> default: ".pb.h"

Menetapkan sufiks 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

--[no]experimental_proto_descriptor_sets_include_source_info default: "false"

Menjalankan tindakan tambahan untuk versi API Java alternatif dalam proto_library.

Tag: affects_outputs, loading_and_analysis, experimental

--[no]experimental_save_feature_state default: "false"

Simpan status fitur yang diaktifkan dan diminta sebagai output kompilasi.

Tag: affects_outputs, experimental

--fission=<a set of compilation modes> default: "no"

Menentukan mode kompilasi mana yang menggunakan fusi 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 DefaultInfo.files dependensi data ke runfilenya, yang cocok dengan perilaku yang direkomendasikan untuk aturan Starlark (fitur runfiles yang harus dihindari).

Tag: affects_outputs, incompatible_change

--[no]incompatible_compact_repo_mapping_manifest default: "true"

Jika diaktifkan, file {binary}.repo_mapping memancarkan pemetaan repo ekstensi modul hanya sekali, bukan sekali untuk setiap repo yang dihasilkan oleh ekstensi yang berkontribusi pada runfile.

Tag: affects_outputs, incompatible_change

--incompatible_disable_select_on=<comma-separated set of options> default: ""

Daftar tanda yang penggunaannya di select() dinonaktifkan.

Tag: loading_and_analysis, incompatible_change, non_configurable

--[no]incompatible_filegroup_runfiles_for_data default: "true"

Jika benar (true), runfile target yang tercantum dalam atribut srcs tersedia untuk target yang menggunakan filegroup sebagai dependensi data.

Tag: incompatible_change

--[no]objc_generate_linkmap default: "false"

Menentukan apakah akan membuat file linkmap atau tidak.

Tag: affects_outputs

--[no]save_temps default: "false"

Jika disetel, output sementara dari gcc akan disimpan. File 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, yang memengaruhi nilainya, bukan keberadaannya:
Penggunaan --action_env=<a 'name[=value]' assignment with an optional value part or the special syntax '=name' to unset a variable> beberapa kali akan diakumulasikan

Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi target. Variabel dapat ditentukan oleh name, yang dalam hal ini nilai akan diambil dari lingkungan pemanggilan, oleh pasangan name=value yang menetapkan nilai secara independen dari lingkungan pemanggilan, atau oleh =name, yang membatalkan setel variabel dengan nama tersebut. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru yang akan digunakan, opsi untuk variabel yang berbeda akan terakumulasi.

Perhatikan bahwa kecuali --incompatible_repo_env_ignores_action_env benar (true), semua pasangan name=value akan tersedia untuk aturan repositori.

Tag: action_command_lines

--allowed_cpu_values=<comma-separated set of options> default: ""

Nilai yang diizinkan untuk flag --cpu.

Tag: changes_inputs, affects_outputs

--[no]android_databinding_use_androidx default: "true"

Buat file data binding yang kompatibel dengan AndroidX. Ini hanya digunakan dengan databinding v2. Flag ini adalah no-op.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state, experimental

--[no]android_databinding_use_v3_4_args default: "true"

Gunakan android databinding v2 dengan argumen 3.4.0. Flag ini adalah no-op.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state, experimental

--android_dynamic_mode=<off, default or fully> default: "nonaktif"

Menentukan apakah dependensi C++ 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. 'fully' berarti semua library akan ditautkan secara dinamis. 'off' berarti semua library akan ditautkan dalam mode sebagian besar statis.

Tag: affects_outputs, loading_and_analysis

--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency> default: "alphabetical"

Menetapkan urutan manifes yang diteruskan ke penggabung manifes untuk biner Android. ALPHABETICAL berarti manifes diurutkan berdasarkan jalur relatif terhadap execroot. ALPHABETICAL_BY_CONFIGURATION berarti manifes diurutkan berdasarkan jalur relatif ke direktori konfigurasi dalam direktori output. DEPENDENCY berarti manifes diurutkan dengan manifes setiap library yang mendahului manifes dependensinya.

Tag: action_command_lines, execution

--[no]android_resource_shrinking default: "false"

Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.

Tag: affects_outputs, loading_and_analysis

--[no]build_python_zip default: "auto"

Membangun zip yang dapat dieksekusi python; aktif di Windows, nonaktif di platform lain

Tag: affects_outputs

Penggunaan --catalyst_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membangun biner Apple Catalyst.

Tag: loses_incremental_state, loading_and_analysis

--[no]collect_code_coverage default: "false"

Jika ditentukan, Bazel akan menginstrumentasi 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 pembuatan biner. Nilai: fastbuild, dbg, opt.

Tag: affects_outputs, action_command_lines

Penggunaan --conlyopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber C.

Tag: action_command_lines, affects_outputs

Penggunaan --copt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke gcc.

Tag: action_command_lines, affects_outputs

--cpu=<a string> default: ""

Tidak digunakan lagi: tanda ini tidak digunakan secara internal oleh Blaze meskipun ada pemetaan platform lama untuk memungkinkan kompatibilitas mundur. Jangan gunakan flag ini, tetapi gunakan --platforms dengan definisi platform yang sesuai.

Tag: changes_inputs, affects_outputs

--cs_fdo_absolute_path=<a string> default: lihat deskripsi

Menggunakan informasi profil CSFDO untuk mengoptimalkan kompilasi. Tentukan nama jalur absolut file zip yang berisi file profil, file profil LLVM mentah atau terindeks.

Tag: affects_outputs

--cs_fdo_instrument=<a string> default: lihat deskripsi

Buat biner dengan instrumentasi FDO yang sensitif terhadap konteks. Dengan compiler Clang/LLVM, opsi ini juga menerima nama direktori tempat file profil mentah akan di-dump saat runtime.

Tag: affects_outputs

--cs_fdo_profile=<a build target label> default: lihat deskripsi

cs_fdo_profile yang merepresentasikan profil sensitif konteks yang akan digunakan untuk pengoptimalan.

Tag: affects_outputs

Penggunaan --cxxopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber C++.

Tag: action_command_lines, affects_outputs

Penggunaan --define=<a 'name=value' assignment> beberapa kali akan diakumulasikan

Setiap opsi --define menentukan penetapan untuk variabel build. Jika ada beberapa nilai untuk variabel, nilai terakhir yang akan digunakan.

Tag: changes_inputs, affects_outputs

--dynamic_mode=<off, default or fully> default: "default"

Menentukan apakah biner C++ akan ditautkan secara dinamis. 'default' berarti Bazel akan memilih apakah akan menautkan secara dinamis. 'fully' berarti semua library akan ditautkan secara dinamis. 'off' berarti semua library akan ditautkan dalam mode sebagian besar statis.

Tag: loading_and_analysis, affects_outputs

--[no]enable_propeller_optimize_absolute_paths default: "true"

Jika disetel, penggunaan jalur absolut untuk pengoptimalan baling-baling akan memunculkan error.

Tag: affects_outputs

--[no]enable_remaining_fdo_absolute_paths default: "true"

Jika disetel, penggunaan jalur absolut untuk FDO akan memunculkan error.

Tag: affects_outputs

--[no]enable_runfiles default: "auto"

Aktifkan hierarki symlink runfile; Secara default, opsi ini nonaktif di Windows, dan aktif di platform lain.

Tag: affects_outputs

Penggunaan --exec_aspects=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar aspek yang dipisahkan koma untuk diterapkan ke target yang dikonfigurasi exec, terlepas dari apakah target tersebut adalah target tingkat teratas atau bukan. Fitur ini bersifat eksperimental dan dapat berubah.

Tag: loading_and_analysis

Penggunaan --experimental_action_listener=<a build target label> beberapa kali akan diakumulasikan

Tidak digunakan lagi dan digantikan dengan aspek. Gunakan action_listener untuk melampirkan extra_action ke tindakan build yang ada.

Tag: execution, experimental

--[no]experimental_android_compress_java_resources default: "false"

Mengompresi resource Java di APK

Tag: affects_outputs, loading_and_analysis, experimental

--[no]experimental_android_databinding_v2 default: "true"

Gunakan android databinding v2. Flag ini adalah no-op.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state, experimental

--[no]experimental_android_resource_shrinking default: "false"

Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.

Tag: affects_outputs, loading_and_analysis, experimental

--[no]experimental_android_rewrite_dexes_with_rex default: "false"

menggunakan alat rex untuk menulis ulang file dex

Tag: affects_outputs, loading_and_analysis, loses_incremental_state, experimental

--[no]experimental_collect_code_coverage_for_generated_files default: "false"

Jika ditentukan, Bazel juga akan membuat informasi cakupan pengumpulan untuk file yang dihasilkan.

Tag: affects_outputs, experimental

--experimental_objc_fastbuild_options=<comma-separated list of options> default: "-O0,-DDEBUG=1"

Menggunakan string ini sebagai opsi compiler fastbuild objc.

Tag: action_command_lines

--[no]experimental_omitfp default: "false"

Jika benar, gunakan libunwind untuk pelepasan stack, dan kompilasi dengan -fomit-frame-pointer dan -fasynchronous-unwind-tables.

Tag: action_command_lines, affects_outputs, experimental

--experimental_output_paths=<off or strip> default: "nonaktif"

Model mana yang akan digunakan untuk tempat aturan menulis outputnya di pohon output, terutama untuk build multi-platform / multi-konfigurasi. Fitur ini sangat eksperimental. Lihat GH-6526 untuk mengetahui detailnya. Tindakan Starlark dapat memilih untuk menggunakan pemetaan jalur dengan menambahkan kunci supports-path-mapping ke dict execution_requirements.

Tag: loses_incremental_state, bazel_internal_configuration, affects_outputs, execution

Penggunaan --experimental_override_platform_cpu_name=<a 'label=value' assignment> beberapa kali akan diakumulasikan

Setiap entri harus dalam bentuk label=value dengan label mengacu pada platform dan nilai adalah nama singkat yang diinginkan untuk menggantikan nama CPU platform di $(TARGET_CPU) variabel make dan jalur output. Hanya digunakan jika --experimental_platform_in_output_dir, --incompatible_target_cpu_from_platform, atau --incompatible_bep_cpu_from_platform benar. Memiliki prioritas penamaan tertinggi.

Tag: affects_outputs, experimental

--[no]experimental_platform_in_output_dir default: "Otomatis"

Jika benar (true), nama singkat untuk platform target akan digunakan dalam nama direktori output, bukan CPU. Skema yang tepat bersifat eksperimental dan dapat berubah:

  1. Pertama, jika opsi --platforms tidak memiliki tepat satu nilai, hash opsi platform akan digunakan.
  2. Selanjutnya, jika ada nama pendek untuk platform saat ini yang didaftarkan oleh --experimental_override_name_platform_in_output_dir, nama pendek tersebut akan digunakan.
  3. Kemudian, jika --experimental_use_platforms_in_output_dir_legacy_heuristic disetel, gunakan nama pendek berdasarkan Label platform saat ini.
  4. Terakhir, hash opsi platform digunakan sebagai upaya terakhir.

Tag: affects_outputs, experimental

--[no]experimental_use_llvm_covmap default: "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"

Gunakan tanda ini hanya sebagai bagian dari strategi pengujian atau migrasi yang disarankan. Perhatikan bahwa heuristik memiliki kekurangan yang diketahui dan disarankan untuk bermigrasi agar hanya mengandalkan --experimental_override_name_platform_in_output_dir.

Tag: affects_outputs, experimental

--fdo_instrument=<a string> default: lihat deskripsi

Buat biner dengan instrumentasi FDO. Dengan compiler Clang/LLVM, opsi ini juga menerima nama direktori tempat file profil mentah akan di-dump saat runtime.

Tag: affects_outputs

--fdo_optimize=<a string> default: lihat deskripsi

Gunakan informasi profil FDO untuk mengoptimalkan kompilasi. Tentukan nama file zip yang berisi struktur 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 direktif exports_files ke paket yang sesuai) dan label yang mengarah ke target fdo_profile. Flag ini akan digantikan oleh aturan fdo_profile.

Tag: affects_outputs

--fdo_prefetch_hints=<a build target label> default: lihat deskripsi

Gunakan petunjuk pengambilan data cache.

Tag: affects_outputs

--fdo_profile=<a build target label> default: lihat deskripsi

fdo_profile yang merepresentasikan profil yang akan digunakan untuk pengoptimalan.

Tag: affects_outputs

Penggunaan --features=<a string> beberapa kali akan diakumulasikan

Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi target. Menentukan -{feature} akan menonaktifkan fitur ini. Fitur negatif selalu menggantikan fitur positif. Lihat juga --host_features.

Tag: changes_inputs, affects_outputs

--[no]force_pic default: "false"

Jika diaktifkan, semua kompilasi C++ menghasilkan kode yang independen dari posisi ("-fPIC"), link lebih memilih library bawaan PIC daripada library non-PIC, dan link menghasilkan file yang dapat dieksekusi yang independen dari posisi ("-pie").

Tag: loading_and_analysis, affects_outputs

Penggunaan --host_action_env=<a 'name[=value]' assignment with an optional value part or the special syntax '=name' to unset a variable> beberapa kali akan diakumulasikan

Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi eksekusi. Variabel dapat ditentukan oleh name, yang dalam hal ini nilai akan diambil dari lingkungan pemanggilan, oleh pasangan name=value yang menetapkan nilai secara independen dari lingkungan pemanggilan, atau oleh =name, yang membatalkan setel variabel dengan nama tersebut. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru yang akan digunakan, opsi untuk variabel yang berbeda akan terakumulasi.

Tag: action_command_lines

--host_compilation_mode=<fastbuild, dbg or opt> default: "opt"

Tentukan mode alat yang digunakan selama build akan dibuat. Nilai: fastbuild, dbg, opt.

Tag: affects_outputs, action_command_lines

Penggunaan --host_conlyopt=<a string> beberapa kali akan 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

Penggunaan --host_copt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke compiler C untuk alat yang dibuat dalam konfigurasi exec.

Tag: action_command_lines, affects_outputs

--host_cpu=<a string> default: ""

CPU host.

Tag: changes_inputs, affects_outputs

Penggunaan --host_cxxopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke compiler C++ untuk alat yang dibuat dalam konfigurasi exec.

Tag: action_command_lines, affects_outputs

Penggunaan --host_features=<a string> beberapa kali akan diakumulasikan

Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi exec. Menentukan -{feature} akan menonaktifkan fitur ini. Fitur negatif selalu menggantikan fitur positif.

Tag: changes_inputs, affects_outputs

Penggunaan --host_linkopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke linker saat menautkan alat dalam konfigurasi exec.

Tag: action_command_lines, affects_outputs

--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi macOS yang kompatibel minimum untuk target host. Jika tidak ditentukan, gunakan 'macos_sdk_version'.

Tag: loses_incremental_state

Penggunaan --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 kali akan diakumulasikan

Opsi tambahan untuk meneruskan 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 untuk disertakan dan dikecualikan (Lihat juga --instrumentation_filter). option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip 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 semua file cc di //foo/ kecuali bar.cc.

Tag: action_command_lines, affects_outputs

--[no]incompatible_auto_exec_groups default: "false"

Jika diaktifkan, grup exec akan otomatis dibuat untuk setiap toolchain yang digunakan oleh aturan. Agar aturan ini berfungsi, aturan perlu menentukan parameter toolchain pada tindakannya. Untuk mengetahui informasi selengkapnya, lihat GH-17134.

Tag: affects_outputs, incompatible_change

--[no]incompatible_merge_genfiles_directory default: "true"

Jika benar, direktori genfiles akan dilipat ke dalam direktori bin.

Tag: affects_outputs, incompatible_change

--[no]incompatible_target_cpu_from_platform default: "true"

Jika ditentukan, nilai batasan CPU (@platforms//cpu:cpu) dari platform target digunakan untuk menetapkan variabel make $(TARGET_CPU).

Tag: loading_and_analysis, incompatible_change

--[no]instrument_test_targets default: "false"

Jika cakupan diaktifkan, tentukan apakah akan mempertimbangkan aturan pengujian instrumentasi. Jika disetel, aturan pengujian yang disertakan oleh --instrumentation_filter akan diinstrumen. Jika tidak, aturan pengujian akan 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 regex 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

--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi iOS yang kompatibel minimum untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'ios_sdk_version'.

Tag: loses_incremental_state

Penggunaan --ios_multi_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membangun 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 diaktifkan, 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

Penggunaan --linkopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke gcc saat menautkan.

Tag: action_command_lines, affects_outputs

Penggunaan --ltobackendopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke langkah backend LTO (di bagian --features=thin_lto).

Tag: action_command_lines, affects_outputs

Penggunaan --ltoindexopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke langkah pengindeksan LTO (di bagian --features=thin_lto).

Tag: action_command_lines, affects_outputs

Penggunaan --macos_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membangun biner Apple macOS.

Tag: loses_incremental_state, loading_and_analysis

--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi macOS yang kompatibel minimum untuk target. Jika tidak ditentukan, gunakan 'macos_sdk_version'.

Tag: loses_incremental_state

--memprof_profile=<a build target label> default: lihat deskripsi

Gunakan profil memprof.

Tag: affects_outputs

--[no]objc_debug_with_GLIBCXX default: "false"

Jika ditetapkan, dan mode kompilasi ditetapkan ke 'dbg', tentukan GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC, dan GLIBCPP_CONCEPT_CHECKS.

Tag: action_command_lines

--[no]objc_enable_binary_stripping default: "false"

Apakah akan melakukan penghapusan simbol dan kode tidak terpakai pada biner yang ditautkan. Pelepasan biner akan dilakukan jika tanda ini dan --compilation_mode=opt ditentukan.

Tag: action_command_lines

Penggunaan --objccopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber Objective-C/C++.

Tag: action_command_lines

Penggunaan --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 kali akan diakumulasikan

Opsi tambahan untuk meneruskan 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 untuk disertakan dan dikecualikan (Lihat juga --instrumentation_filter). option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip 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 semua file cc di //foo/ kecuali bar.cc.

Tag: action_command_lines, affects_outputs

Penggunaan --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 kali akan diakumulasikan

Opsi tambahan untuk meneruskan secara selektif ke backend LTO (di bawah --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 untuk menyertakan dan mengecualikan. option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip 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

--platform_suffix=<a string> default: lihat deskripsi

Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.

Tag: loses_incremental_state, affects_outputs, loading_and_analysis

--propeller_optimize=<a build target label> default: lihat deskripsi

Gunakan informasi profil Propeller untuk mengoptimalkan target build.Profil Propeller harus terdiri dari setidaknya salah satu dari dua file, yaitu profil cc dan profil ld. Flag ini menerima label build yang harus merujuk ke 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",)Direktif exports_files mungkin harus ditambahkan ke paket yang sesuai agar file ini dapat dilihat oleh Bazel. Opsi harus digunakan sebagai: --propeller_optimize=//a/b:propeller_profile

Tag: action_command_lines, affects_outputs

--propeller_optimize_absolute_cc_profile=<a string> default: lihat deskripsi

Nama jalur absolut file cc_profile untuk build yang Dioptimalkan Propeller.

Tag: affects_outputs

--propeller_optimize_absolute_ld_profile=<a string> default: lihat deskripsi

Nama jalur absolut file ld_profile untuk build yang Dioptimalkan Propeller.

Tag: affects_outputs

--run_under=<a prefix in front of command> default: lihat deskripsi

Awalan yang akan disisipkan sebelum file yang dapat dieksekusi untuk perintah test dan run. Jika nilainya foo -bar, dan command line eksekusinya adalah test_binary -baz, maka command line terakhirnya adalah foo -bar test_binary -baz. Ini juga dapat berupa label untuk target yang dapat dieksekusi. Contohnya antara lain:

  • valgrind
  • strace
  • strace -c
  • valgrind --quiet --num-callers=20
  • //package:target
  • //package:target --options

Tag: action_command_lines

--[no]share_native_deps default: "true"

Jika benar, library native yang berisi fungsi identik akan dibagikan di antara target yang berbeda

Tag: loading_and_analysis, affects_outputs

--[no]stamp default: "false"

Membubuhi stempel biner dengan tanggal, nama pengguna, nama host, informasi ruang kerja, dll.

Tag: affects_outputs

Default --strip=<always, sometimes or never>: "sometimes" (kadang-kadang)

Menentukan apakah akan menghapus biner dan library bersama (menggunakan "-Wl,--strip-debug"). Nilai default 'sometimes' berarti hapus jika --compilation_mode=fastbuild.

Tag: affects_outputs

Penggunaan --stripopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke strip saat membuat biner '<name>.stripped'.

Tag: action_command_lines, affects_outputs

Penggunaan --tvos_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membuat biner Apple tvOS.

Tag: loses_incremental_state, loading_and_analysis

--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi tvOS kompatibel minimum untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'tvos_sdk_version'.

Tag: loses_incremental_state

Penggunaan --visionos_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membuat biner Apple visionOS.

Tag: loses_incremental_state, loading_and_analysis

Penggunaan --watchos_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membangun biner Apple watchOS.

Tag: loses_incremental_state, loading_and_analysis

--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi watchOS yang kompatibel minimum untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'watchos_sdk_version'.

Tag: loses_incremental_state

--xbinary_fdo=<a build target label> default: lihat deskripsi

Gunakan informasi profil XbinaryFDO untuk mengoptimalkan kompilasi. Tentukan nama profil biner silang default. Jika opsi ini 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.):
--[no]check_visibility default: "true"

Jika dinonaktifkan, error visibilitas dalam dependensi target akan diturunkan menjadi peringatan.

Tag: build_file_semantics, non_configurable

--[no]desugar_for_android default: "true"

Apakah akan melakukan desugar bytecode Java 8 sebelum dexing.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state

--[no]desugar_java8_libs default: "false"

Apakah akan menyertakan library Java 8 yang didukung dalam aplikasi untuk perangkat lama.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state, experimental

--[no]enforce_constraints default: "true"

Memeriksa lingkungan yang kompatibel dengan setiap target dan melaporkan error jika ada target yang memiliki dependensi yang tidak mendukung lingkungan yang sama

Tag: build_file_semantics

--[no]experimental_check_desugar_deps default: "true"

Apakah akan memeriksa kembali desugaring yang benar pada tingkat biner Android.

Tag: eagerness_to_exit, loading_and_analysis, experimental

--[no]experimental_enforce_transitive_visibility default: "false"

Jika benar (true), aktifkan package()s untuk menyetel atribut transitive_visibility guna membatasi paket mana yang dapat bergantung padanya.

Tag: build_file_semantics, experimental

--experimental_one_version_enforcement=<off, warning or error> default: "OFF"

Jika diaktifkan, memastikan bahwa aturan java_binary tidak boleh berisi lebih dari satu versi file class yang sama di classpath. Penerapan ini dapat merusak build, atau hanya menghasilkan peringatan.

Tag: loading_and_analysis

--experimental_strict_java_deps=<off, warn, error, strict or default> default: "default"

Jika benar, periksa apakah target Java secara eksplisit mendeklarasikan semua target yang digunakan secara langsung sebagai dependensi.

Tag: build_file_semantics, eagerness_to_exit

--[no]incompatible_check_testonly_for_output_files default: "false"

Jika diaktifkan, periksa testonly untuk target prasyarat yang merupakan file output dengan mencari testonly dari aturan pembuatan. Tindakan ini cocok dengan pemeriksaan visibilitas.

Tag: build_file_semantics, incompatible_change

--[no]incompatible_disable_native_android_rules default: "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

--[no]incompatible_disable_native_apple_binary_rule default: "false"

No-op. Dipertahankan di sini untuk kompatibilitas mundur.

Tag: eagerness_to_exit, incompatible_change

--[no]one_version_enforcement_on_java_tests default: "true"

Jika diaktifkan, dan dengan experimental_one_version_enforcement ditetapkan ke nilai selain NONE, terapkan satu versi pada target java_test. Flag ini dapat dinonaktifkan untuk meningkatkan performa pengujian inkremental dengan mengorbankan potensi pelanggaran satu versi yang terlewat.

Tag: loading_and_analysis

--python_native_rules_allowlist=<a build target label> default: lihat deskripsi

Daftar yang diizinkan (target package_group) untuk digunakan saat menerapkan --incompatible_python_disallow_native_rules.

Tag: loading_and_analysis

--[no]strict_filesets default: "false"

Jika opsi ini diaktifkan, set file yang melintasi batas paket akan dilaporkan sebagai error.

Tag: build_file_semantics, eagerness_to_exit

--strict_proto_deps=<off, warn, error, strict or default> default: "error"

Kecuali jika OFF, 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

--strict_public_imports=<off, warn, error, strict or default> default: "nonaktif"

Kecuali OFF, memeriksa apakah target proto_library secara eksplisit mendeklarasikan semua target yang digunakan dalam 'import public' sebagai diekspor.

Tag: build_file_semantics, eagerness_to_exit, incompatible_change

--[no]strict_system_includes default: "false"

Jika benar, header yang ditemukan melalui jalur sertakan sistem (-isystem) juga harus dideklarasikan.

Tag: loading_and_analysis, eagerness_to_exit

Penggunaan --target_environment=<a build target label> beberapa kali akan diakumulasikan

Mendeklarasikan lingkungan target build ini. Harus berupa referensi label ke aturan environment. Jika ditentukan, semua target tingkat teratas harus kompatibel dengan lingkungan ini.

Lihat juga --platforms.

Tag: changes_inputs

Opsi yang memengaruhi output penandatanganan build:
--apk_signing_method=<v1, v2, v1_v2 or v4> default: "v1_v2"

Implementasi yang akan digunakan untuk menandatangani APK

Tag: action_command_lines, affects_outputs, loading_and_analysis

--[no]device_debug_entitlements default: "true"

Jika disetel, dan mode kompilasi bukan 'opt', aplikasi objc akan menyertakan hak debug saat menandatangani.

Tag: changes_inputs

--ios_signing_cert_name=<a string> default: lihat deskripsi

Nama sertifikat yang akan digunakan untuk penandatanganan iOS. Jika tidak disetel, akan kembali ke profil penyediaan. Dapat berupa preferensi identitas keychain sertifikat atau (substring) 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.:
--[no]incompatible_disallow_sdk_frameworks_attributes default: "false"

Jika benar, atribut sdk_frameworks dan weak_sdk_frameworks tidak diizinkan dalam objc_library dan objc_import.

Tag: build_file_semantics, incompatible_change

Jika benar, jadikan nilai default benar untuk atribut alwayslink di objc_library dan objc_import.

Tag: build_file_semantics, incompatible_change

--[no]incompatible_python_disallow_native_rules default: "false"

Jika benar (true), terjadi error saat menggunakan aturan py_* bawaan; sebagai gantinya, aturan rule_python harus digunakan. Lihat https://github.com/bazelbuild/bazel/issues/17773 untuk mengetahui informasi dan petunjuk migrasi selengkapnya.

Tag: loading_and_analysis, incompatible_change

Opsi yang mengatur perilaku lingkungan pengujian atau pelaksana pengujian:
--[no]allow_analysis_failures default: "false"

Jika benar (true), kegagalan analisis target aturan akan menyebabkan propagasi target instance AnalysisFailureInfo yang berisi deskripsi error, bukan menyebabkan kegagalan build.

Tag: loading_and_analysis, experimental

--analysis_testing_deps_limit=<an integer> default: "2000"

Menetapkan jumlah maksimum dependensi transitif melalui atribut aturan dengan transisi konfigurasi for_analysis_testing. Melebihi batas ini akan menyebabkan error aturan.

Tag: loading_and_analysis

--[no]break_build_on_parallel_dex2oat_failure default: "false"

Jika benar, kegagalan tindakan dex2oat akan menyebabkan build rusak, bukan menjalankan dex2oat selama runtime pengujian.

Tag: loading_and_analysis, experimental

Penggunaan --default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g memory=10,30,60,100> beberapa kali akan diakumulasikan

Ganti jumlah resource default untuk pengujian. Format yang diharapkan adalah {resource}={value}. Jika satu angka positif ditentukan sebagai {value}, angka tersebut akan menggantikan resource default untuk semua ukuran pengujian. Jika 4 angka yang dipisahkan koma ditentukan, angka tersebut akan menggantikan jumlah resource untuk ukuran pengujian small, medium, large, enormous. Nilai juga dapat berupa HOST_RAM/HOST_CPU, yang secara opsional diikuti oleh [-|*]{float} (mis. memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4). Resource pengujian default yang ditentukan oleh tanda ini digantikan oleh resource eksplisit yang ditentukan dalam tag.

--[no]experimental_android_use_parallel_dex2oat default: "false"

Gunakan dex2oat secara paralel untuk mempercepat android_test.

Tag: loading_and_analysis, host_machine_resource_optimizations, experimental

--[no]ios_memleaks default: "false"

Mengaktifkan pemeriksaan kebocoran memori di target ios_test.

Tag: action_command_lines

--ios_simulator_device=<a string> default: lihat deskripsi

Perangkat yang akan disimulasikan saat menjalankan aplikasi iOS di simulator, misalnya 'iPhone 6'. Anda bisa mendapatkan daftar perangkat dengan menjalankan 'xcrun simctl list devicetypes' di komputer tempat simulator akan dijalankan.

Tag: test_runner

--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi iOS yang akan dijalankan di simulator saat menjalankan atau menguji. Setelan ini diabaikan untuk aturan ios_test jika perangkat target ditentukan dalam aturan.

Tag: test_runner

Penggunaan --runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once> beberapa kali akan diakumulasikan

Menentukan jumlah waktu untuk menjalankan setiap pengujian. Jika salah satu upaya tersebut gagal karena alasan apa pun, seluruh pengujian dianggap gagal. Biasanya, nilai yang ditentukan hanyalah bilangan bulat.

Contoh: --runs_per_test=3 akan menjalankan semua pengujian sebanyak 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 sertakan dan kecualikan (Lihat juga --instrumentation_filter).

Contoh: --runs_per_test=//foo/.*,-//foo/bar/.*@3 menjalankan semua pengujian di //foo/ kecuali pengujian di //foo/bar sebanyak tiga kali. Opsi ini dapat diteruskan beberapa kali. Argumen yang paling baru diteruskan yang cocok akan diutamakan. Jika tidak ada yang cocok, pengujian hanya dijalankan satu kali.

Penggunaan --test_env=<a 'name[=value]' assignment with an optional value part or the special syntax '=name' to unset a variable> beberapa kali akan diakumulasikan

Menentukan variabel lingkungan tambahan yang akan dimasukkan ke dalam lingkungan pelaksana pengujian. Variabel dapat ditentukan oleh name, yang dalam hal ini nilainya akan dibaca dari lingkungan klien Bazel, atau oleh pasangan name=value. Variabel yang ditetapkan sebelumnya dapat dibatalkan melalui =name. Opsi ini dapat digunakan beberapa kali untuk menentukan beberapa variabel. Hanya digunakan oleh perintah 'bazel test'.

Tag: test_runner

--test_timeout=<a single integer or comma-separated list of 4 integers> default: "-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 short, moderate, long, dan eternal (dalam urutan tersebut). Dalam bentuk apa pun, nilai -1 memberi tahu Blaze untuk menggunakan waktu tunggu defaultnya untuk kategori tersebut.

--[no]zip_undeclared_test_outputs default: "false"

Jika benar, output pengujian yang tidak dideklarasikan akan diarsipkan dalam file zip.

Tag: test_runner

Opsi yang memicu pengoptimalan waktu build:
--[no]cc_dotd_files default: "true"

Apakah akan membuat dan menganalisis file .d.

Tag: loading_and_analysis, execution, changes_inputs

--[no]cc_include_scanning default: "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 pohon input kompilasi. Namun, hal ini juga dapat merusak build karena pemindai include tidak sepenuhnya menerapkan semantik praprosesor C. Khususnya, alat ini tidak memahami direktif #include dinamis dan mengabaikan logika bersyarat praprosesor. Gunakan dengan menanggung sendiri risikonya. Setiap masalah terkait tanda ini yang diajukan akan ditutup. Di Google, build Anda kemungkinan besar akan gagal tanpa tanda ini.

Tag: loading_and_analysis, execution, changes_inputs, experimental

--[no]experimental_filter_library_jar_with_program_jar default: "false"

Memfilter ProgramJar ProGuard untuk menghapus class yang juga ada di LibraryJar.

Tag: action_command_lines, experimental

--[no]experimental_inmemory_dotd_files default: "true"

Jika diaktifkan, file .d C++ akan diteruskan dalam memori langsung dari node build jarak jauh, bukan ditulis ke disk.

Tag: loading_and_analysis, execution, affects_outputs, experimental

--[no]experimental_inmemory_jdeps_files default: "true"

Jika diaktifkan, file dependensi (.jdeps) yang dihasilkan dari kompilasi Java akan diteruskan dalam memori langsung dari node build jarak jauh, bukan ditulis ke disk.

Tag: loading_and_analysis, execution, affects_outputs, experimental

--[no]experimental_retain_test_configuration_across_testonly default: "false"

Jika diaktifkan, --trim_test_configuration tidak akan memangkas konfigurasi pengujian untuk aturan yang ditandai dengan testonly=1. Tindakan ini dimaksudkan untuk mengurangi masalah konflik tindakan saat aturan non-pengujian bergantung pada aturan cc_test. Tidak berpengaruh jika --trim_test_configuration adalah false.

Tag: loading_and_analysis, loses_incremental_state, experimental

--[no]experimental_unsupported_and_brittle_include_scanning default: "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 pohon input kompilasi. Namun, hal ini juga dapat merusak build karena pemindai include tidak sepenuhnya menerapkan semantik praprosesor C. Khususnya, alat ini tidak memahami direktif #include dinamis dan mengabaikan logika bersyarat praprosesor. Gunakan dengan menanggung sendiri risikonya. Setiap masalah terkait tanda ini yang diajukan akan ditutup. Di Google, build Anda kemungkinan besar akan gagal tanpa tanda ini.

Tag: loading_and_analysis, execution, changes_inputs, experimental

--[no]incremental_dexing default: "true"

Melakukan sebagian besar pekerjaan dexing secara terpisah untuk setiap file Jar.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state

--[no]objc_use_dotd_pruning default: "true"

Jika disetel, file .d yang dikeluarkan oleh clang akan digunakan untuk memangkas set input yang diteruskan ke kompilasi objc.

Tag: changes_inputs, loading_and_analysis

--[no]process_headers_in_dependencies default: "false"

Saat membuat target //a:a, proses header di semua target yang bergantung pada //a:a (jika pemrosesan header diaktifkan untuk toolchain).

Tag: execution

--[no]trim_test_configuration default: "true"

Jika diaktifkan, opsi terkait pengujian akan dihapus di bawah tingkat 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 respons, format, atau lokasi logging:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> default: "-.*"

Mencetak informasi debug selama penyelesaian toolchain. Flag ini menggunakan regex, 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 penyelesaian toolchain.

Tag: terminal_output

--[no]verbose_visibility_errors default: "false"

Jika diaktifkan, error visibilitas akan menyertakan informasi diagnostik tambahan.

Tag: build_file_semantics, non_configurable

Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
Penggunaan --flag_alias=<a 'name=value' flag alias> beberapa kali akan diakumulasikan

Menetapkan nama singkat untuk flag Starlark. Fungsi ini mengambil satu pasangan nilai kunci dalam bentuk {key}={value} sebagai argumen.

Tag: changes_inputs, non_configurable

--[no]incompatible_default_to_explicit_init_py default: "false"

Flag ini mengubah perilaku default sehingga file init.py tidak lagi dibuat secara otomatis di runfile target Python. Secara tepatnya, saat target py_binary atau py_test memiliki legacy_create_init yang disetel ke "auto" (default), target tersebut akan dianggap salah (false) jika dan hanya jika tanda ini disetel. Lihat https://github.com/bazelbuild/bazel/issues/10076.

Tag: affects_outputs, incompatible_change

Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
--[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 external,
  3. Beberapa uji coba diminta dengan --runs_per_test, atau
  4. Pengujian sebelumnya gagal. Jika ditetapkan ke yes, Bazel akan menyimpan dalam cache semua hasil pengujian kecuali pengujian yang ditandai sebagai external. Jika disetel ke no, Bazel tidak menyimpan hasil pengujian dalam cache.
Default --[no]experimental_cancel_concurrent_tests: "never" (tidak pernah)

Jika on_failed atau on_passed, Blaze akan membatalkan pengujian yang berjalan secara serentak pada pengujian pertama yang berhasil dengan hasil tersebut. Ini hanya berguna jika digunakan bersama --runs_per_test_detects_flakes.

Tag: affects_outputs, loading_and_analysis, experimental

--[no]experimental_fetch_all_coverage_outputs default: "false"

Jika benar (true), Bazel akan mengambil seluruh direktori data cakupan untuk setiap pengujian selama cakupan berjalan.

Tag: affects_outputs, loading_and_analysis, experimental

--[no]experimental_generate_llvm_lcov default: "false"

Jika benar (true), cakupan untuk clang akan menghasilkan laporan LCOV.

Tag: affects_outputs, loading_and_analysis, experimental

--experimental_java_classpath=<off, javabuilder, bazel or bazel_no_fallback> default: "bazel"

Mengaktifkan classpath yang dikurangi untuk kompilasi Java.

--[no]experimental_run_android_lint_on_java_rules default: "false"

Apakah akan memvalidasi sumber java_*.

Tag: affects_outputs, experimental

--[no]explicit_java_test_deps default: "false"

Menentukan dependensi ke JUnit atau Hamcrest secara eksplisit di java_test, bukan secara tidak sengaja diperoleh dari deps TestRunner. Saat ini hanya berfungsi untuk bazel.

--host_java_launcher=<a build target label> default: lihat deskripsi

Peluncur Java yang digunakan oleh alat yang dijalankan selama build.

Penggunaan --host_javacopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke javac saat membangun alat yang dieksekusi selama build.

Penggunaan --host_jvmopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke VM Java saat membuat 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 peluncur pengujian tidak menunjukkan bahwa peluncur tersebut mendukung sharding dengan menyentuh file di jalur dalam TEST_SHARD_STATUS_FILE. Jika salah (false), peluncuran 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 (true), pengujian eksklusif akan berjalan dengan strategi sandbox. Tambahkan tag local untuk memaksa pengujian eksklusif dijalankan secara lokal

Tag: incompatible_change

--[no]incompatible_strict_action_env default: "true"

Jika benar, Bazel 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 penyiapan cache lintas pengguna jika cache bersama digunakan.

Tag: loading_and_analysis, incompatible_change

Penggunaan --j2objc_translation_flags=<comma-separated list of options> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke alat J2ObjC.

--java_debug

Menyebabkan virtual machine Java dari pengujian Java menunggu koneksi dari debugger yang kompatibel dengan JDWP (seperti jdb) sebelum memulai pengujian. Menyiratkan -test_output=streamed.

Meluas 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.

--[no]java_header_compilation default: "true"

Kompilasi ijar langsung dari sumber.

--java_language_version=<a string> default: ""

Versi bahasa Java

--java_launcher=<a build target label> default: lihat deskripsi

Peluncur Java yang akan digunakan saat membangun biner Java. Jika tanda ini disetel ke string kosong, peluncur JDK akan digunakan. Atribut "peluncur" menggantikan tanda ini.

--java_runtime_version=<a string> default: "local_jdk"

Versi runtime Java

Penggunaan --javacopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke javac.

Penggunaan --jvmopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke VM Java. Opsi ini akan ditambahkan ke opsi startup VM dari setiap target java_binary.

--legacy_main_dex_list_generator=<a build target label> default: lihat deskripsi

Menentukan biner yang akan digunakan untuk membuat daftar class yang harus ada di dex utama saat mengompilasi multidex lama.

--optimizing_dexer=<a build target label> default: lihat deskripsi

Menentukan biner yang akan digunakan untuk melakukan dexing tanpa sharding.

Penggunaan --plugin=<a build target label> beberapa kali akan diakumulasikan

Plugin yang akan digunakan dalam build. Saat ini berfungsi dengan java_plugin.

--proguard_top=<a build target label> default: lihat deskripsi

Menentukan versi ProGuard yang akan digunakan untuk penghapusan kode saat membangun biner Java.

--proto_compiler=<a build target label> default: "@bazel_tools//tools/proto:protoc"

Label proto-compiler.

Tag: affects_outputs, loading_and_analysis

--[no]proto_profile default: "true"

Apakah akan meneruskan profile_path ke compiler proto.

Tag: affects_outputs, loading_and_analysis

--proto_profile_path=<a build target label> default: lihat deskripsi

Profil yang akan diteruskan ke compiler proto sebagai profile_path. Jika tidak disetel, tetapi --proto_profile adalah benar (default), menyimpulkan jalur dari --fdo_optimize.

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

Penggunaan --protocopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke compiler protobuf.

Tag: affects_outputs

--[no]runs_per_test_detects_flakes default: "false"

Jika benar (true), setiap shard yang setidaknya satu kali lulus dan setidaknya satu kali gagal akan mendapatkan status TIDAK STABIL (FLAKY).

--shell_executable=<a path> default: lihat deskripsi

Jalur absolut ke shell yang dapat dieksekusi untuk digunakan Bazel. Jika tidak disetel, tetapi variabel lingkungan BAZEL_SH disetel pada pemanggilan Bazel pertama (yang memulai server Bazel), Bazel akan menggunakannya. Jika keduanya tidak ditetapkan, Bazel akan menggunakan jalur default yang dikodekan secara permanen, bergantung pada sistem operasi yang dijalankannya;

  • Windows: c:/msys64/usr/bin/bash.exe
  • FreeBSD: /usr/local/bin/bash
  • 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

Penggunaan --test_arg=<a string> beberapa kali akan 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 identik. Hanya digunakan oleh perintah bazel test.

--test_filter=<a string> default: lihat deskripsi

Menentukan filter untuk diteruskan ke framework pengujian. Digunakan untuk membatasi pengujian yang dijalankan. Perhatikan bahwa hal ini tidak memengaruhi target yang dibuat.

--test_result_expiration=<an integer> default: "-1"

Opsi ini tidak digunakan lagi dan tidak berpengaruh.

--[no]test_runner_fail_fast default: "false"

Meneruskan opsi fail fast ke runner pengujian. Runner pengujian harus menghentikan eksekusi saat kegagalan pertama terjadi.

--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce> default: "explicit"

Tentukan strategi untuk sharding pengujian:

  • explicit untuk hanya menggunakan sharding jika atribut shard_count BUILD ada.
  • disabled agar tidak pernah menggunakan sharding pengujian.
  • forced=k untuk menerapkan shard k untuk pengujian, terlepas dari atribut shard_count BUILD.
--tool_java_language_version=<a string> default: ""

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 mengeksekusi alat selama build

--[no]use_ijars default: "true"

Jika diaktifkan, opsi ini menyebabkan kompilasi Java menggunakan jar antarmuka. Hal ini akan menghasilkan kompilasi inkremental yang lebih cepat, tetapi pesan error dapat berbeda.

Opsi Canonicalize-flags

Mewarisi semua opsi dari build.

Opsi yang mengontrol output perintah:
--[no]canonicalize_policy default: "false"

Menampilkan kebijakan kanonis, setelah perluasan dan pemfilteran. Agar output tetap bersih, argumen perintah yang dikanonisasi TIDAK akan ditampilkan jika opsi ini disetel ke benar (true). Perhatikan bahwa perintah yang ditentukan oleh --for_command memengaruhi kebijakan yang difilter, dan jika tidak ada yang ditentukan, perintah defaultnya adalah 'build'.

Tag: affects_outputs, terminal_output

--[no]experimental_include_default_values default: "true"

Apakah opsi Starlark yang ditetapkan ke nilai defaultnya disertakan dalam output.

Tag: affects_outputs, terminal_output

Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility default: "false"

Jika incompatible_enforce_config_setting_visibility=false, ini adalah no-op. Jika tidak, jika tanda ini salah (false), setiap config_setting tanpa atribut visibilitas eksplisit adalah //visibility:public. Jika tanda ini benar (true), 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 benar (true), terapkan batasan visibilitas config_setting. Jika salah (false), setiap config_setting dapat dilihat oleh setiap target. Lihat https://github.com/bazelbuild/bazel/issues/12932.

Tag: loading_and_analysis, incompatible_change

Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--for_command=<a string> default: "build"

Perintah yang opsinya harus dikanonikalisasi.

Tag: affects_outputs, terminal_output

--invocation_policy=<a string> default: ""

Menerapkan kebijakan pemanggilan ke opsi yang akan dikanonisasi.

Tag: affects_outputs, terminal_output

Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
Penggunaan --deleted_packages=<comma-separated list of package names> beberapa kali akan diakumulasikan

Daftar nama paket yang dipisahkan koma yang akan dianggap tidak ada oleh sistem build, meskipun paket tersebut 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 menampilkan error jika menemukan label '//x:y/z' jika label tersebut masih disediakan oleh entri package_path lain. Menentukan --deleted_packages x/y akan menghindari masalah ini.

--[no]fetch default: "true"

Mengizinkan perintah untuk mengambil dependensi eksternal. Jika disetel ke salah (false), perintah akan menggunakan versi dependensi yang di-cache, dan jika tidak ada, perintah akan gagal.

--package_path=<colon-separated list of options> default: "%workspace%"

Daftar tempat untuk mencari paket yang dipisahkan dengan titik dua. Elemen yang diawali dengan '%workspace%' bersifat relatif terhadap ruang kerja yang melampirkannya. Jika tidak ada atau kosong, defaultnya adalah output 'bazel info default-package-path'.

--[no]show_loading_progress default: "true"

Jika diaktifkan, Bazel akan mencetak pesan "Loading package:".

Opsi Pembersihan

Mewarisi semua opsi dari build.

Opsi yang mengontrol output perintah:
--[no]async default: "false"

Jika benar, pembersihan output bersifat asinkron. Setelah perintah ini selesai, Anda dapat menjalankan perintah baru di klien yang sama dengan aman, meskipun penghapusan dapat berlanjut di latar belakang.

Tag: host_machine_resource_optimizations

--[no]expunge default: "false"

Jika benar, clean akan menghapus seluruh pohon kerja untuk instance bazel ini, yang mencakup semua file output build dan sementara yang dibuat bazel, serta menghentikan server bazel jika sedang berjalan.

Tag: host_machine_resource_optimizations

--expunge_async

Jika ditentukan, clean akan menghapus seluruh pohon kerja untuk instance bazel ini secara asinkron, yang mencakup semua file output build dan sementara 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 dapat berlanjut di latar belakang.

Meluas menjadi:
  --expunge
  --async

Tag: host_machine_resource_optimizations

Opsi Konfigurasi

Opsi Cakupan

Mewarisi semua opsi dari test.

Opsi Cquery

Mewarisi semua opsi dari test.

Opsi yang terkait dengan output dan semantik kueri:
--aspect_deps=<off, conservative or precise> default: "conservative" (konservatif)

Cara menyelesaikan dependensi aspek saat format output adalah salah satu dari {xml,proto,record}. 'off' berarti tidak ada dependensi aspek yang diselesaikan, 'conservative' (default) berarti semua dependensi aspek yang dideklarasikan ditambahkan terlepas dari apakah dependensi tersebut diberi class aturan dependensi langsung, 'precise' berarti hanya aspek yang mungkin aktif yang ditambahkan mengingat class aturan dependensi langsung. Perhatikan bahwa mode presisi memerlukan pemuatan paket lain untuk mengevaluasi satu target sehingga lebih lambat daripada mode lainnya. Perhatikan juga bahwa meskipun mode presisi tidak sepenuhnya presisi: keputusan apakah akan menghitung aspek diputuskan dalam fase analisis, yang tidak dijalankan selama 'bazel query'.

Tag: build_file_semantics

--[no]consistent_labels default: "false"

Jika diaktifkan, setiap perintah kueri akan memancarkan label seolah-olah dengan fungsi <code>str</code> Starlark 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 dapat memancarkan nama repositori yang jelas (relatif terhadap repositori utama) untuk membuat output lebih mudah dibaca.

Tag: terminal_output

--[no]experimental_explicit_aspects default: "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 dikeluarkan 'terfaktor', yaitu node yang setara secara topologi akan digabungkan dan labelnya digabungkan. Opsi ini hanya berlaku untuk --output=graph.

Tag: terminal_output

--graph:node_limit=<an integer> default: "512"

Panjang maksimum string label untuk node grafik dalam output. Label yang lebih panjang akan dipotong; -1 berarti tidak ada pemotongan. Opsi ini hanya berlaku untuk --output=graph.

Tag: terminal_output

--[no]implicit_deps default: "true"

Jika diaktifkan, dependensi implisit akan disertakan dalam grafik dependensi tempat kueri 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 telah diselesaikan.

Tag: build_file_semantics

--[no]include_aspects default: "true"

aquery, 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

--[no]infer_universe_scope default: "false"

Jika ditetapkan dan --universe_scope tidak ditetapkan, maka 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 semesta (misalnya,allrdeps) mungkin tidak sesuai dengan 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

--[no]line_terminator_null default: "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 "visibility". 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 hasil cquery yang akan dicetak. Nilai yang diizinkan untuk cquery adalah: label, label_kind, textproto, transitions, proto, streamed_proto, jsonproto. Jika memilih 'transisi', Anda juga harus menentukan opsi --transitions=(lite|full).

Tag: terminal_output

--output_file=<a string> default: ""

Jika ditentukan, hasil kueri akan ditulis langsung ke file ini, dan tidak ada yang akan dicetak ke aliran output standar (stdout) Bazel. Dalam tolok ukur, hal ini umumnya lebih cepat daripada <code>bazel query > file</code>.

Tag: terminal_output

--[no]proto:default_values default: "true"

Jika benar (true), atribut yang nilainya tidak ditentukan secara eksplisit dalam file BUILD akan disertakan; jika tidak, atribut tersebut akan dihilangkan. Opsi ini berlaku untuk --output=proto

Tag: terminal_output

--[no]proto:definition_stack default: "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 satu kali. Jenis skalar diratakan menjadi null.

Tag: build_file_semantics

--[no]proto:include_attribute_source_aspects default: "false"

Isi kolom proto source_aspect_name setiap Atribut dengan aspek sumber yang berasal dari atribut tersebut (string kosong jika tidak ada).

Tag: terminal_output

--[no]proto:include_configurations default: "true"

Jika diaktifkan, output proto akan menyertakan informasi tentang konfigurasi. Jika dinonaktifkan,format output cquery proto menyerupai format output kueri.

Tag: affects_outputs

--[no]proto:include_starlark_rule_env default: "true"

Gunakan lingkungan starlark dalam nilai atribut $internal_attr_hash yang dihasilkan. Hal ini memastikan bahwa definisi aturan starlark (dan impor transitifnya) adalah bagian dari ID ini.

Tag: terminal_output

--[no]proto:include_synthetic_attribute_hash default: "false"

Apakah akan menghitung dan mengisi atribut $internal_attr_hash atau tidak.

Tag: terminal_output

--[no]proto:instantiation_stack default: "false"

Mengisi stack panggilan instansiasi setiap aturan. Perhatikan bahwa hal ini memerlukan kehadiran stack

Tag: terminal_output

--[no]proto:locations default: "true"

Apakah akan menampilkan informasi lokasi dalam output proto atau tidak.

Tag: terminal_output

--proto:output_rule_attrs=<comma-separated list of options> default: "all"

Daftar atribut yang dipisahkan koma untuk disertakan dalam output. Secara default, semua atribut akan ditampilkan. Setel ke string kosong agar tidak menampilkan atribut apa pun. Opsi ini berlaku untuk --output=proto.

Tag: terminal_output

--[no]proto:rule_classes default: "false"

Isi kolom rule_class_key setiap aturan; dan untuk aturan pertama dengan rule_class_key tertentu, isi juga kolom proto rule_class_info-nya. Kolom rule_class_key secara unik mengidentifikasi class aturan, dan kolom rule_class_info adalah definisi API class aturan berformat Stardoc.

Tag: terminal_output

--[no]proto:rule_inputs_and_outputs default: "true"

Apakah kolom rule_input dan rule_output akan diisi atau tidak.

Tag: terminal_output

--query_file=<a string> default: ""

Jika disetel, kueri akan membaca kueri dari file yang diberi nama di sini, bukan di command line. Menentukan file di sini serta kueri command line adalah suatu kesalahan.

Tag: changes_inputs

--[no]relative_locations default: "false"

Jika benar (true), 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 menyetel opsi ini ke benar (true) untuk mendapatkan hasil yang konsisten di seluruh perangkat.

Tag: terminal_output

--show_config_fragments=<off, direct or transitive> default: "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

--starlark:expr=<a string> default: ""

Ekspresi Starlark untuk memformat setiap target yang dikonfigurasi dalam mode --output=starlark cquery. Target yang dikonfigurasi terikat ke 'target'. Jika --starlark:expr maupun --starlark:file tidak ditentukan, opsi ini akan ditetapkan secara default ke 'str(target.label)'. Terjadi error jika Anda menentukan --starlark:expr dan --starlark:file.

Tag: terminal_output

--starlark:file=<a string> default: ""

Nama file yang menentukan fungsi Starlark bernama 'format', dengan satu argumen, yang diterapkan ke setiap target yang dikonfigurasi untuk memformatnya sebagai string. Terjadi error jika Anda menentukan --starlark:expr dan --starlark:file. Lihat bantuan untuk --output=starlark untuk mengetahui detail tambahan.

Tag: terminal_output

--[no]tool_deps default: "true"

Kueri: Jika dinonaktifkan, dependensi pada 'konfigurasi exec' tidak akan disertakan dalam grafik dependensi yang digunakan kueri. Edge dependensi 'konfigurasi exec', seperti yang berasal dari aturan 'proto_library' ke Pengompilasi Protokol, biasanya mengarah ke alat yang dijalankan 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 ada dalam konfigurasi target, hanya target yang dikonfigurasi yang juga ada 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 diselesaikan.

Tag: build_file_semantics

Default --transitions=<full, lite or none>: "none"

Format yang akan digunakan cquery untuk mencetak informasi transisi.

Tag: affects_outputs

--universe_scope=<comma-separated list of options> default: ""

Kumpulan pola target yang dipisahkan koma (aditif dan subtraktif). Kueri dapat dilakukan di 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 yang digunakan untuk membuat semua jawaban, sehingga opsi ini dapat memengaruhi konfigurasi dan transisi. Jika opsi ini tidak ditentukan, target tingkat teratas 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 dibangun dengan opsi tingkat teratas.

Tag: loading_and_analysis

Opsi yang mengontrol eksekusi build:
--[no]experimental_persistent_aar_extractor default: "false"

Aktifkan pengekstrak aar persisten menggunakan pekerja.

Tag: execution, experimental

--[no]experimental_remotable_source_manifests default: "false"

Apakah tindakan manifes sumber dapat dilakukan dari jarak jauh

Tag: loading_and_analysis, execution, experimental

--[no]experimental_split_coverage_postprocessing default: "false"

Jika benar, Bazel akan menjalankan pemrosesan pasca-cakupan untuk pengujian di proses baru.

Tag: execution, experimental

--[no]experimental_strict_fileset_output default: "false"

Jika opsi ini diaktifkan, set file akan memperlakukan semua artefak output sebagai file biasa. File tidak akan melintasi direktori atau sensitif terhadap symlink.

Tag: execution, experimental

--[no]incompatible_modify_execution_info_additive default: "true"

Jika diaktifkan, meneruskan beberapa tanda --modify_execution_info bersifat aditif. Jika dinonaktifkan, hanya tanda terakhir yang akan dipertimbangkan.

Tag: execution, affects_outputs, loading_and_analysis, incompatible_change

Penggunaan --modify_execution_info=<regex=[+-]key,regex=[+-]key,...> beberapa kali akan diakumulasikan

Menambahkan atau menghapus kunci dari info eksekusi tindakan berdasarkan mnemonik tindakan. Hanya berlaku untuk tindakan yang mendukung info eksekusi. Banyak tindakan umum yang mendukung info eksekusi, misalnya Genrule, CppCompile, Javac, StarlarkAction, TestRunner. Saat menentukan beberapa nilai, urutan penting karena banyak ekspresi reguler dapat berlaku untuk mnemonik yang sama.

Sintaksis: regex=[+-]key,regex=[+-]key,....

Contoh:

  • .*=+x,.*=-y,.*=+z menambahkan x dan z ke, serta 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 persisten menggunakan pekerja.

Meluas 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 dengan menggunakan pekerja.

Meluas 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

Aktifkan tindakan desugar dan dex Android multiplex persisten menggunakan pekerja.

Meluas 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 yang di-multiplex secara persisten menggunakan pekerja.

Diluaskan 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

Aktifkan alat Android persisten dan yang di-multiplex (dexing, desugaring, pemrosesan resource).

Meluas menjadi:
  --internal_persistent_multiplex_busybox_tools
  --persistent_multiplex_android_resource_processor
  --persistent_multiplex_android_dex_desugar

Tag: host_machine_resource_optimizations, execution

--[no]use_target_platform_for_tests default: "false"

Jika benar (true), gunakan platform target untuk menjalankan pengujian, bukan grup eksekusi pengujian.

Tag: execution

Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
--android_compiler=<a string> default: lihat deskripsi

Compiler target Android.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state

--android_manifest_merger=<legacy, android or force_android> default: "android"

Memilih penggabung manifes yang akan digunakan untuk aturan android_binary. Flag untuk membantu transisi ke penggabung manifes Android dari penggabung lama.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state

--android_platforms=<a build target label> default: ""

Menetapkan platform yang digunakan oleh target android_binary. Jika beberapa platform ditentukan, maka biner adalah APK gemuk, yang berisi biner native untuk setiap platform target yang ditentukan.

Tag: changes_inputs, loading_and_analysis, loses_incremental_state

--cc_output_directory_tag=<a string> default: ""

Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.

Tag: affects_outputs

--compiler=<a string> default: lihat deskripsi

Compiler C++ yang akan digunakan untuk mengompilasi target.

Tag: loading_and_analysis, execution

--coverage_output_generator=<a build target label> default: "@bazel_tools//tools/test:lcov_merger"

Lokasi biner yang digunakan untuk memproses laporan cakupan mentah. Target ini harus berupa biner. Default-nya adalah @bazel_tools//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. Target ini harus berupa biner. Default-nya adalah @bazel_tools//tools/test:coverage_report_generator.

Tag: changes_inputs, affects_outputs, loading_and_analysis

--coverage_support=<a build target label> default: "@bazel_tools//tools/test:coverage_support"

Lokasi file dukungan yang diperlukan pada input setiap tindakan pengujian yang mengumpulkan cakupan kode. Default-nya adalah //tools/test:coverage_support.

Tag: changes_inputs, affects_outputs, loading_and_analysis

--custom_malloc=<a build target label> default: lihat deskripsi

Menentukan implementasi malloc kustom. Setelan ini menggantikan atribut malloc dalam aturan build.

Tag: changes_inputs, affects_outputs

--[no]experimental_include_xcode_execution_requirements default: "false"

Jika disetel, tambahkan persyaratan eksekusi "requires-xcode:{version}" ke setiap tindakan Xcode. Jika versi Xcode memiliki label bergaris hubung, tambahkan juga persyaratan eksekusi "requires-xcode-label:{version_label}".

Tag: loses_incremental_state, loading_and_analysis, execution, experimental

--[no]experimental_prefer_mutual_xcode default: "true"

Jika benar, gunakan Xcode terbaru yang tersedia secara lokal dan jarak jauh. Jika salah (false), atau jika tidak ada versi yang tersedia bersama, gunakan versi Xcode lokal yang dipilih melalui xcode-select.

Tag: loses_incremental_state, experimental

--extra_execution_platforms=<comma-separated list of options> default: ""

Platform yang tersedia sebagai platform eksekusi untuk menjalankan tindakan. Platform dapat ditentukan berdasarkan target yang tepat, atau sebagai pola target. Platform ini akan dipertimbangkan sebelum platform yang dideklarasikan dalam file WORKSPACE oleh register_execution_platforms(). Opsi ini hanya dapat ditetapkan satu kali; instance selanjutnya akan menggantikan setelan tanda sebelumnya.

Tag: execution

Penggunaan --extra_toolchains=<comma-separated list of options> beberapa kali akan diakumulasikan

Aturan toolchain yang akan dipertimbangkan selama penyelesaian toolchain. Rangkaian alat dapat ditentukan berdasarkan target yang persis, atau sebagai pola target. Rangkaian alat ini akan dipertimbangkan sebelum rangkaian alat yang dideklarasikan dalam file WORKSPACE oleh register_toolchains().

Tag: affects_outputs, changes_inputs, loading_and_analysis

--grte_top=<a label> default: lihat deskripsi

Label untuk library libc yang di-check in. Nilai default dipilih oleh toolchain crosstool, dan Anda hampir tidak perlu menggantinya.

Tag: action_command_lines, affects_outputs

--host_compiler=<a string> default: lihat deskripsi

Flag tanpa pengoperasian. Akan dihapus dalam rilis mendatang.

Tag: loading_and_analysis, execution

--host_grte_top=<a label> default: lihat deskripsi

Jika ditentukan, setelan ini akan menggantikan direktori tingkat teratas libc (--grte_top) untuk konfigurasi 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_bazel_test_exec_run_under default: "true"

Jika diaktifkan, bazel test --run_under=//:runner akan membuat //:runner dalam konfigurasi exec. Jika dinonaktifkan, //:runner akan dibuat dalam konfigurasi target. Bazel menjalankan pengujian di mesin eksekusi, sehingga yang pertama lebih tepat. Hal ini tidak memengaruhi bazel run, yang selalu membangun --run_under=//foo dalam konfigurasi target.

Tag: affects_outputs, incompatible_change

--[no]incompatible_builtin_objc_strip_action default: "true"

Apakah akan memancarkan tindakan penghapusan sebagai bagian dari penautan objc.

Tag: action_command_lines, incompatible_change

--[no]incompatible_dont_enable_host_nonhost_crosstool_features default: "true"

Jika benar (true), 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_apple_toolchain_resolution default: "false"

Menggunakan penyelesaian toolchain untuk memilih Apple SDK untuk aturan Apple (Starlark dan native)

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_strip_executable_safely default: "false"

Jika benar, tindakan penghapusan untuk file yang dapat dieksekusi akan menggunakan flag -x, yang tidak merusak resolusi simbol dinamis.

Tag: action_command_lines, incompatible_change

--[no]interface_shared_objects default: "true"

Gunakan objek bersama antarmuka jika didukung oleh toolchain. Semua toolchain ELF saat ini mendukung setelan ini.

Tag: loading_and_analysis, affects_outputs, affects_outputs

--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Menentukan versi iOS SDK yang akan digunakan untuk membangun aplikasi iOS. Jika tidak ditentukan, akan menggunakan versi iOS SDK default dari 'xcode_version'.

Tag: loses_incremental_state

--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Menentukan versi macOS SDK yang akan digunakan untuk membangun aplikasi macOS. Jika tidak ditentukan, akan menggunakan versi SDK macOS default dari 'xcode_version'.

Tag: loses_incremental_state

--minimum_os_version=<a string> default: lihat deskripsi

Versi OS minimum yang ditargetkan kompilasi Anda.

Tag: loading_and_analysis, affects_outputs

--platform_mappings=<a main workspace-relative path> default: ""

Lokasi file pemetaan yang menjelaskan platform mana yang akan digunakan jika tidak ada yang ditetapkan atau tanda mana yang akan ditetapkan jika platform sudah ada. Harus relatif terhadap root ruang kerja utama. Defaultnya adalah platform_mappings (file langsung di bawah root ruang kerja).

Tag: affects_outputs, changes_inputs, loading_and_analysis, non_configurable

--platforms=<a build target label> default: ""

Label aturan platform yang menjelaskan platform target untuk perintah saat ini.

Tag: affects_outputs, changes_inputs, loading_and_analysis

--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Menentukan versi tvOS SDK yang akan digunakan untuk membangun aplikasi tvOS. Jika tidak ditentukan, gunakan versi tvOS SDK default dari 'xcode_version'.

Tag: loses_incremental_state

--[no]use_platforms_in_apple_crosstool_transition default: "false"

Membuat apple_crosstool_transition kembali menggunakan nilai flag --platforms, bukan --cpu lama jika diperlukan.

Tag: loading_and_analysis

--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Menentukan versi watchOS SDK yang akan digunakan untuk membangun aplikasi watchOS. Jika tidak ditentukan, akan menggunakan versi SDK watchOS default dari 'xcode_version'.

Tag: loses_incremental_state

--xcode_version=<a string> default: lihat deskripsi

Jika ditentukan, gunakan Xcode versi tertentu untuk tindakan build yang relevan. Jika tidak ditentukan, akan menggunakan Xcode versi default executor.

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:
--[no]apple_generate_dsym default: "false"

Apakah akan membuat file simbol debug (.dSYM).

Tag: affects_outputs, action_command_lines

Jika benar, bangun hutan symlink runfile untuk semua target. Jika salah (false), tulis hanya jika diperlukan oleh perintah tindakan, pengujian, atau jalankan lokal.

Tag: affects_outputs

--[no]build_runfile_manifests default: "true"

Jika benar, tulis manifes file yang dapat dijalankan untuk semua target. Jika salah (false), hapus. Pengujian lokal akan gagal dijalankan jika salah (false).

Tag: affects_outputs

--[no]build_test_dwp default: "false"

Jika diaktifkan, saat membuat pengujian C++ secara statis dan dengan fission, file .dwp untuk biner pengujian juga akan dibuat secara otomatis.

Tag: loading_and_analysis, affects_outputs

--cc_proto_library_header_suffixes=<comma-separated set of options> default: ".pb.h"

Menetapkan sufiks 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

--[no]experimental_proto_descriptor_sets_include_source_info default: "false"

Menjalankan tindakan tambahan untuk versi API Java alternatif dalam proto_library.

Tag: affects_outputs, loading_and_analysis, experimental

--[no]experimental_save_feature_state default: "false"

Simpan status fitur yang diaktifkan dan diminta sebagai output kompilasi.

Tag: affects_outputs, experimental

--fission=<a set of compilation modes> default: "no"

Menentukan mode kompilasi mana yang menggunakan fusi 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 DefaultInfo.files dependensi data ke runfilenya, yang cocok dengan perilaku yang direkomendasikan untuk aturan Starlark (fitur runfiles yang harus dihindari).

Tag: affects_outputs, incompatible_change

--[no]incompatible_compact_repo_mapping_manifest default: "true"

Jika diaktifkan, file {binary}.repo_mapping memancarkan pemetaan repo ekstensi modul hanya sekali, bukan sekali untuk setiap repo yang dihasilkan oleh ekstensi yang berkontribusi pada runfile.

Tag: affects_outputs, incompatible_change

--incompatible_disable_select_on=<comma-separated set of options> default: ""

Daftar tanda yang penggunaannya di select() dinonaktifkan.

Tag: loading_and_analysis, incompatible_change, non_configurable

--[no]incompatible_filegroup_runfiles_for_data default: "true"

Jika benar (true), runfile target yang tercantum dalam atribut srcs tersedia untuk target yang menggunakan filegroup sebagai dependensi data.

Tag: incompatible_change

--[no]objc_generate_linkmap default: "false"

Menentukan apakah akan membuat file linkmap atau tidak.

Tag: affects_outputs

--[no]save_temps default: "false"

Jika disetel, output sementara dari gcc akan disimpan. File 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, yang memengaruhi nilainya, bukan keberadaannya:
Penggunaan --action_env=<a 'name[=value]' assignment with an optional value part or the special syntax '=name' to unset a variable> beberapa kali akan diakumulasikan

Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi target. Variabel dapat ditentukan oleh name, yang dalam hal ini nilai akan diambil dari lingkungan pemanggilan, oleh pasangan name=value yang menetapkan nilai secara independen dari lingkungan pemanggilan, atau oleh =name, yang membatalkan setel variabel dengan nama tersebut. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru yang akan digunakan, opsi untuk variabel yang berbeda akan terakumulasi.

Perhatikan bahwa kecuali --incompatible_repo_env_ignores_action_env benar (true), semua pasangan name=value akan tersedia untuk aturan repositori.

Tag: action_command_lines

--allowed_cpu_values=<comma-separated set of options> default: ""

Nilai yang diizinkan untuk flag --cpu.

Tag: changes_inputs, affects_outputs

--[no]android_databinding_use_androidx default: "true"

Buat file data binding yang kompatibel dengan AndroidX. Ini hanya digunakan dengan databinding v2. Flag ini adalah no-op.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state, experimental

--[no]android_databinding_use_v3_4_args default: "true"

Gunakan android databinding v2 dengan argumen 3.4.0. Flag ini adalah no-op.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state, experimental

--android_dynamic_mode=<off, default or fully> default: "nonaktif"

Menentukan apakah dependensi C++ 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. 'fully' berarti semua library akan ditautkan secara dinamis. 'off' berarti semua library akan ditautkan dalam mode sebagian besar statis.

Tag: affects_outputs, loading_and_analysis

--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency> default: "alphabetical"

Menetapkan urutan manifes yang diteruskan ke penggabung manifes untuk biner Android. ALPHABETICAL berarti manifes diurutkan berdasarkan jalur relatif terhadap execroot. ALPHABETICAL_BY_CONFIGURATION berarti manifes diurutkan berdasarkan jalur relatif ke direktori konfigurasi dalam direktori output. DEPENDENCY berarti manifes diurutkan dengan manifes setiap library yang mendahului manifes dependensinya.

Tag: action_command_lines, execution

--[no]android_resource_shrinking default: "false"

Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.

Tag: affects_outputs, loading_and_analysis

--[no]build_python_zip default: "auto"

Membangun zip yang dapat dieksekusi python; aktif di Windows, nonaktif di platform lain

Tag: affects_outputs

Penggunaan --catalyst_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membangun biner Apple Catalyst.

Tag: loses_incremental_state, loading_and_analysis

--[no]collect_code_coverage default: "false"

Jika ditentukan, Bazel akan menginstrumentasi 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 pembuatan biner. Nilai: fastbuild, dbg, opt.

Tag: affects_outputs, action_command_lines

Penggunaan --conlyopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber C.

Tag: action_command_lines, affects_outputs

Penggunaan --copt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke gcc.

Tag: action_command_lines, affects_outputs

--cpu=<a string> default: ""

Tidak digunakan lagi: tanda ini tidak digunakan secara internal oleh Blaze meskipun ada pemetaan platform lama untuk memungkinkan kompatibilitas mundur. Jangan gunakan flag ini, tetapi gunakan --platforms dengan definisi platform yang sesuai.

Tag: changes_inputs, affects_outputs

--cs_fdo_absolute_path=<a string> default: lihat deskripsi

Gunakan informasi profil CSFDO untuk mengoptimalkan kompilasi. Tentukan nama jalur absolut file zip yang berisi file profil, file profil LLVM mentah atau terindeks.

Tag: affects_outputs

--cs_fdo_instrument=<a string> default: lihat deskripsi

Buat biner dengan instrumentasi FDO yang sensitif terhadap konteks. Dengan compiler Clang/LLVM, opsi ini juga menerima nama direktori tempat file profil mentah akan di-dump saat runtime.

Tag: affects_outputs

--cs_fdo_profile=<a build target label> default: lihat deskripsi

cs_fdo_profile yang merepresentasikan profil sensitif konteks yang akan digunakan untuk pengoptimalan.

Tag: affects_outputs

Penggunaan --cxxopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber C++.

Tag: action_command_lines, affects_outputs

Penggunaan --define=<a 'name=value' assignment> beberapa kali akan diakumulasikan

Setiap opsi --define menentukan penetapan untuk variabel build. Jika ada beberapa nilai untuk variabel, nilai terakhir yang akan digunakan.

Tag: changes_inputs, affects_outputs

--dynamic_mode=<off, default or fully> default: "default"

Menentukan apakah biner C++ akan ditautkan secara dinamis. 'default' berarti Bazel akan memilih apakah akan menautkan secara dinamis. 'fully' berarti semua library akan ditautkan secara dinamis. 'off' berarti semua library akan ditautkan dalam mode sebagian besar statis.

Tag: loading_and_analysis, affects_outputs

--[no]enable_propeller_optimize_absolute_paths default: "true"

Jika disetel, penggunaan jalur absolut untuk pengoptimalan baling-baling akan memunculkan error.

Tag: affects_outputs

--[no]enable_remaining_fdo_absolute_paths default: "true"

Jika disetel, penggunaan jalur absolut untuk FDO akan memunculkan error.

Tag: affects_outputs

--[no]enable_runfiles default: "auto"

Aktifkan hierarki symlink runfile; Secara default, opsi ini nonaktif di Windows, dan aktif di platform lain.

Tag: affects_outputs

Penggunaan --exec_aspects=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar aspek yang dipisahkan koma untuk diterapkan ke target yang dikonfigurasi exec, terlepas dari apakah target tersebut adalah target tingkat teratas atau bukan. Fitur ini bersifat eksperimental dan dapat berubah.

Tag: loading_and_analysis

Penggunaan --experimental_action_listener=<a build target label> beberapa kali akan diakumulasikan

Tidak digunakan lagi dan digantikan dengan aspek. Gunakan action_listener untuk melampirkan extra_action ke tindakan build yang ada.

Tag: execution, experimental

--[no]experimental_android_compress_java_resources default: "false"

Mengompresi resource Java di APK

Tag: affects_outputs, loading_and_analysis, experimental

--[no]experimental_android_databinding_v2 default: "true"

Gunakan android databinding v2. Flag ini adalah no-op.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state, experimental

--[no]experimental_android_resource_shrinking default: "false"

Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.

Tag: affects_outputs, loading_and_analysis, experimental

--[no]experimental_android_rewrite_dexes_with_rex default: "false"

menggunakan alat rex untuk menulis ulang file dex

Tag: affects_outputs, loading_and_analysis, loses_incremental_state, experimental

--[no]experimental_collect_code_coverage_for_generated_files default: "false"

Jika ditentukan, Bazel juga akan membuat informasi cakupan pengumpulan untuk file yang dihasilkan.

Tag: affects_outputs, experimental

--experimental_objc_fastbuild_options=<comma-separated list of options> default: "-O0,-DDEBUG=1"

Menggunakan string ini sebagai opsi compiler fastbuild objc.

Tag: action_command_lines

--[no]experimental_omitfp default: "false"

Jika benar, gunakan libunwind untuk pelepasan stack, dan kompilasi dengan -fomit-frame-pointer dan -fasynchronous-unwind-tables.

Tag: action_command_lines, affects_outputs, experimental

--experimental_output_paths=<off or strip> default: "nonaktif"

Model mana yang akan digunakan untuk tempat aturan menulis outputnya di pohon output, terutama untuk build multi-platform / multi-konfigurasi. Fitur ini sangat eksperimental. Lihat GH-6526 untuk mengetahui detailnya. Tindakan Starlark dapat memilih untuk menggunakan pemetaan jalur dengan menambahkan kunci supports-path-mapping ke dict execution_requirements.

Tag: loses_incremental_state, bazel_internal_configuration, affects_outputs, execution

Penggunaan --experimental_override_platform_cpu_name=<a 'label=value' assignment> beberapa kali akan diakumulasikan

Setiap entri harus dalam bentuk label=value dengan label mengacu pada platform dan nilai adalah nama singkat yang diinginkan untuk menggantikan nama CPU platform di $(TARGET_CPU) variabel make dan jalur output. Hanya digunakan jika --experimental_platform_in_output_dir, --incompatible_target_cpu_from_platform, atau --incompatible_bep_cpu_from_platform benar. Memiliki prioritas penamaan tertinggi.

Tag: affects_outputs, experimental

--[no]experimental_platform_in_output_dir default: "Otomatis"

Jika benar (true), nama singkat untuk platform target akan digunakan dalam nama direktori output, bukan CPU. Skema yang tepat bersifat eksperimental dan dapat berubah:

  1. Pertama, jika opsi --platforms tidak memiliki tepat satu nilai, hash opsi platform akan digunakan.
  2. Selanjutnya, jika ada nama pendek untuk platform saat ini yang didaftarkan oleh --experimental_override_name_platform_in_output_dir, nama pendek tersebut akan digunakan.
  3. Kemudian, jika --experimental_use_platforms_in_output_dir_legacy_heuristic disetel, gunakan nama pendek berdasarkan Label platform saat ini.
  4. Terakhir, hash opsi platform digunakan sebagai upaya terakhir.

Tag: affects_outputs, experimental

--[no]experimental_use_llvm_covmap default: "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"

Gunakan tanda ini hanya sebagai bagian dari strategi pengujian atau migrasi yang disarankan. Perhatikan bahwa heuristik memiliki kekurangan yang diketahui dan disarankan untuk bermigrasi agar hanya mengandalkan --experimental_override_name_platform_in_output_dir.

Tag: affects_outputs, experimental

--fdo_instrument=<a string> default: lihat deskripsi

Buat biner dengan instrumentasi FDO. Dengan compiler Clang/LLVM, opsi ini juga menerima nama direktori tempat file profil mentah akan di-dump saat runtime.

Tag: affects_outputs

--fdo_optimize=<a string> default: lihat deskripsi

Gunakan informasi profil FDO untuk mengoptimalkan kompilasi. Tentukan nama file zip yang berisi struktur 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 direktif exports_files ke paket yang sesuai) dan label yang mengarah ke target fdo_profile. Flag ini akan digantikan oleh aturan fdo_profile.

Tag: affects_outputs

--fdo_prefetch_hints=<a build target label> default: lihat deskripsi

Gunakan petunjuk pengambilan data cache.

Tag: affects_outputs

--fdo_profile=<a build target label> default: lihat deskripsi

fdo_profile yang merepresentasikan profil yang akan digunakan untuk pengoptimalan.

Tag: affects_outputs

Penggunaan --features=<a string> beberapa kali akan diakumulasikan

Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi target. Menentukan -{feature} akan menonaktifkan fitur ini. Fitur negatif selalu menggantikan fitur positif. Lihat juga --host_features.

Tag: changes_inputs, affects_outputs

--[no]force_pic default: "false"

Jika diaktifkan, semua kompilasi C++ akan menghasilkan kode yang independen dari posisi ("-fPIC"), link lebih memilih library bawaan PIC daripada library non-PIC, dan link menghasilkan file yang dapat dieksekusi yang independen dari posisi ("-pie").

Tag: loading_and_analysis, affects_outputs

Penggunaan --host_action_env=<a 'name[=value]' assignment with an optional value part or the special syntax '=name' to unset a variable> beberapa kali akan diakumulasikan

Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi eksekusi. Variabel dapat ditentukan oleh name, yang dalam hal ini nilai akan diambil dari lingkungan pemanggilan, oleh pasangan name=value yang menetapkan nilai secara independen dari lingkungan pemanggilan, atau oleh =name, yang membatalkan setel variabel dengan nama tersebut. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru yang akan digunakan, opsi untuk variabel yang berbeda akan diakumulasikan.

Tag: action_command_lines

--host_compilation_mode=<fastbuild, dbg or opt> default: "opt"

Tentukan mode alat yang digunakan selama build akan dibuat. Nilai: fastbuild, dbg, opt.

Tag: affects_outputs, action_command_lines

Penggunaan --host_conlyopt=<a string> beberapa kali akan 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

Penggunaan --host_copt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke compiler C untuk alat yang dibuat dalam konfigurasi exec.

Tag: action_command_lines, affects_outputs

--host_cpu=<a string> default: ""

CPU host.

Tag: changes_inputs, affects_outputs

Penggunaan --host_cxxopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke compiler C++ untuk alat yang dibuat dalam konfigurasi exec.

Tag: action_command_lines, affects_outputs

Penggunaan --host_features=<a string> beberapa kali akan diakumulasikan

Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi exec. Menentukan -{feature} akan menonaktifkan fitur ini. Fitur negatif selalu menggantikan fitur positif.

Tag: changes_inputs, affects_outputs

Penggunaan --host_linkopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke linker saat menautkan alat dalam konfigurasi exec.

Tag: action_command_lines, affects_outputs

--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi macOS yang kompatibel minimum untuk target host. Jika tidak ditentukan, gunakan 'macos_sdk_version'.

Tag: loses_incremental_state

Penggunaan --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 kali akan diakumulasikan

Opsi tambahan untuk meneruskan 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 untuk disertakan dan dikecualikan (Lihat juga --instrumentation_filter). option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip 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 semua file cc di //foo/ kecuali bar.cc.

Tag: action_command_lines, affects_outputs

--[no]incompatible_auto_exec_groups default: "false"

Jika diaktifkan, grup exec akan otomatis dibuat untuk setiap toolchain yang digunakan oleh aturan. Agar aturan ini berfungsi, aturan perlu menentukan parameter toolchain pada tindakannya. Untuk mengetahui informasi selengkapnya, lihat GH-17134.

Tag: affects_outputs, incompatible_change

--[no]incompatible_merge_genfiles_directory default: "true"

Jika benar, direktori genfiles akan dilipat ke dalam direktori bin.

Tag: affects_outputs, incompatible_change

--[no]incompatible_target_cpu_from_platform default: "true"

Jika ditentukan, nilai batasan CPU (@platforms//cpu:cpu) dari platform target digunakan untuk menetapkan variabel make $(TARGET_CPU).

Tag: loading_and_analysis, incompatible_change

--[no]instrument_test_targets default: "false"

Jika cakupan diaktifkan, tentukan apakah akan mempertimbangkan aturan pengujian instrumentasi. Jika disetel, aturan pengujian yang disertakan oleh --instrumentation_filter akan diinstrumen. Jika tidak, aturan pengujian akan 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 regex 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

--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi iOS yang kompatibel minimum untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'ios_sdk_version'.

Tag: loses_incremental_state

Penggunaan --ios_multi_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membangun 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 diaktifkan, 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

Penggunaan --linkopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke gcc saat menautkan.

Tag: action_command_lines, affects_outputs

Penggunaan --ltobackendopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke langkah backend LTO (di bagian --features=thin_lto).

Tag: action_command_lines, affects_outputs

Penggunaan --ltoindexopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke langkah pengindeksan LTO (di bagian --features=thin_lto).

Tag: action_command_lines, affects_outputs

Penggunaan --macos_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membangun biner Apple macOS.

Tag: loses_incremental_state, loading_and_analysis

--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi macOS yang kompatibel minimum untuk target. Jika tidak ditentukan, gunakan 'macos_sdk_version'.

Tag: loses_incremental_state

--memprof_profile=<a build target label> default: lihat deskripsi

Gunakan profil memprof.

Tag: affects_outputs

--[no]objc_debug_with_GLIBCXX default: "false"

Jika ditetapkan, dan mode kompilasi ditetapkan ke 'dbg', tentukan GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC, dan GLIBCPP_CONCEPT_CHECKS.

Tag: action_command_lines

--[no]objc_enable_binary_stripping default: "false"

Apakah akan melakukan penghapusan simbol dan kode tidak terpakai pada biner yang ditautkan. Pelepasan biner akan dilakukan jika tanda ini dan --compilation_mode=opt ditentukan.

Tag: action_command_lines

Penggunaan --objccopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber Objective-C/C++.

Tag: action_command_lines

Penggunaan --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 kali akan diakumulasikan

Opsi tambahan untuk meneruskan 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 untuk disertakan dan dikecualikan (Lihat juga --instrumentation_filter). option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip 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 semua file cc di //foo/ kecuali bar.cc.

Tag: action_command_lines, affects_outputs

Penggunaan --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 kali akan diakumulasikan

Opsi tambahan untuk meneruskan secara selektif ke backend LTO (di bawah --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 untuk menyertakan dan mengecualikan. option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip 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

--platform_suffix=<a string> default: lihat deskripsi

Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.

Tag: loses_incremental_state, affects_outputs, loading_and_analysis

--propeller_optimize=<a build target label> default: lihat deskripsi

Gunakan informasi profil Propeller untuk mengoptimalkan target build.Profil Propeller harus terdiri dari setidaknya salah satu dari dua file, yaitu profil cc dan profil ld. Flag ini menerima label build yang harus merujuk ke 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",)Direktif exports_files mungkin harus ditambahkan ke paket yang sesuai agar file ini dapat dilihat oleh Bazel. Opsi harus digunakan sebagai: --propeller_optimize=//a/b:propeller_profile

Tag: action_command_lines, affects_outputs

--propeller_optimize_absolute_cc_profile=<a string> default: lihat deskripsi

Nama jalur absolut file cc_profile untuk build yang Dioptimalkan Propeller.

Tag: affects_outputs

--propeller_optimize_absolute_ld_profile=<a string> default: lihat deskripsi

Nama jalur absolut file ld_profile untuk build yang Dioptimalkan Propeller.

Tag: affects_outputs

--run_under=<a prefix in front of command> default: lihat deskripsi

Awalan yang akan disisipkan sebelum file yang dapat dieksekusi untuk perintah test dan run. Jika nilainya foo -bar, dan command line eksekusinya adalah test_binary -baz, maka command line terakhirnya adalah foo -bar test_binary -baz. Ini juga dapat berupa label untuk target yang dapat dieksekusi. Contohnya antara lain:

  • valgrind
  • strace
  • strace -c
  • valgrind --quiet --num-callers=20
  • //package:target
  • //package:target --options

Tag: action_command_lines

--[no]share_native_deps default: "true"

Jika benar, library native yang berisi fungsi identik akan dibagikan di antara target yang berbeda

Tag: loading_and_analysis, affects_outputs

--[no]stamp default: "false"

Membubuhi stempel biner dengan tanggal, nama pengguna, nama host, informasi ruang kerja, dll.

Tag: affects_outputs

Default --strip=<always, sometimes or never>: "sometimes" (kadang-kadang)

Menentukan apakah akan menghapus biner dan library bersama (menggunakan "-Wl,--strip-debug"). Nilai default 'sometimes' berarti hapus jika --compilation_mode=fastbuild.

Tag: affects_outputs

Penggunaan --stripopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke strip saat membuat biner '<name>.stripped'.

Tag: action_command_lines, affects_outputs

Penggunaan --tvos_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membuat biner Apple tvOS.

Tag: loses_incremental_state, loading_and_analysis

--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi tvOS kompatibel minimum untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'tvos_sdk_version'.

Tag: loses_incremental_state

Penggunaan --visionos_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membuat biner Apple visionOS.

Tag: loses_incremental_state, loading_and_analysis

Penggunaan --watchos_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membangun biner Apple watchOS.

Tag: loses_incremental_state, loading_and_analysis

--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi watchOS yang kompatibel minimum untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'watchos_sdk_version'.

Tag: loses_incremental_state

--xbinary_fdo=<a build target label> default: lihat deskripsi

Gunakan informasi profil XbinaryFDO untuk mengoptimalkan kompilasi. Tentukan nama profil biner silang default. Jika opsi ini 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.):
--[no]check_visibility default: "true"

Jika dinonaktifkan, error visibilitas dalam dependensi target akan diturunkan menjadi peringatan.

Tag: build_file_semantics, non_configurable

--[no]desugar_for_android default: "true"

Apakah akan melakukan desugar bytecode Java 8 sebelum dexing.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state

--[no]desugar_java8_libs default: "false"

Apakah akan menyertakan library Java 8 yang didukung dalam aplikasi untuk perangkat lama.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state, experimental

--[no]enforce_constraints default: "true"

Memeriksa lingkungan yang kompatibel dengan setiap target dan melaporkan error jika ada target yang memiliki dependensi yang tidak mendukung lingkungan yang sama

Tag: build_file_semantics

--[no]experimental_check_desugar_deps default: "true"

Apakah akan memeriksa kembali desugaring yang benar pada tingkat biner Android.

Tag: eagerness_to_exit, loading_and_analysis, experimental

--[no]experimental_enforce_transitive_visibility default: "false"

Jika benar (true), aktifkan package()s untuk menyetel atribut transitive_visibility guna membatasi paket mana yang dapat bergantung padanya.

Tag: build_file_semantics, experimental

--experimental_one_version_enforcement=<off, warning or error> default: "OFF"

Jika diaktifkan, memastikan bahwa aturan java_binary tidak boleh berisi lebih dari satu versi file class yang sama di classpath. Penerapan ini dapat merusak build, atau hanya menghasilkan peringatan.

Tag: loading_and_analysis

--experimental_strict_java_deps=<off, warn, error, strict or default> default: "default"

Jika benar, periksa apakah target Java secara eksplisit mendeklarasikan semua target yang digunakan secara langsung sebagai dependensi.

Tag: build_file_semantics, eagerness_to_exit

--[no]incompatible_check_testonly_for_output_files default: "false"

Jika diaktifkan, periksa testonly untuk target prasyarat yang merupakan file output dengan mencari testonly dari aturan pembuatan. Tindakan ini cocok dengan pemeriksaan visibilitas.

Tag: build_file_semantics, incompatible_change

--[no]incompatible_disable_native_android_rules default: "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

--[no]incompatible_disable_native_apple_binary_rule default: "false"

No-op. Dipertahankan di sini untuk kompatibilitas mundur.

Tag: eagerness_to_exit, incompatible_change

--[no]one_version_enforcement_on_java_tests default: "true"

Jika diaktifkan, dan dengan experimental_one_version_enforcement ditetapkan ke nilai selain NONE, terapkan satu versi pada target java_test. Flag ini dapat dinonaktifkan untuk meningkatkan performa pengujian inkremental dengan mengorbankan potensi pelanggaran satu versi yang terlewat.

Tag: loading_and_analysis

--python_native_rules_allowlist=<a build target label> default: lihat deskripsi

Daftar yang diizinkan (target package_group) untuk digunakan saat menerapkan --incompatible_python_disallow_native_rules.

Tag: loading_and_analysis

--[no]strict_filesets default: "false"

Jika opsi ini diaktifkan, set file yang melintasi batas paket akan dilaporkan sebagai error.

Tag: build_file_semantics, eagerness_to_exit

--strict_proto_deps=<off, warn, error, strict or default> default: "error"

Kecuali jika OFF, 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

--strict_public_imports=<off, warn, error, strict or default> default: "nonaktif"

Kecuali OFF, memeriksa apakah target proto_library secara eksplisit mendeklarasikan semua target yang digunakan dalam 'import public' sebagai diekspor.

Tag: build_file_semantics, eagerness_to_exit, incompatible_change

--[no]strict_system_includes default: "false"

Jika benar, header yang ditemukan melalui jalur sertakan sistem (-isystem) juga harus dideklarasikan.

Tag: loading_and_analysis, eagerness_to_exit

Penggunaan --target_environment=<a build target label> beberapa kali akan diakumulasikan

Mendeklarasikan lingkungan target build ini. Harus berupa referensi label ke aturan environment. Jika ditentukan, semua target tingkat teratas harus kompatibel dengan lingkungan ini.

Lihat juga --platforms.

Tag: changes_inputs

Opsi yang memengaruhi output penandatanganan build:
--apk_signing_method=<v1, v2, v1_v2 or v4> default: "v1_v2"

Implementasi yang akan digunakan untuk menandatangani APK

Tag: action_command_lines, affects_outputs, loading_and_analysis

--[no]device_debug_entitlements default: "true"

Jika disetel, dan mode kompilasi bukan 'opt', aplikasi objc akan menyertakan hak debug saat menandatangani.

Tag: changes_inputs

--ios_signing_cert_name=<a string> default: lihat deskripsi

Nama sertifikat yang akan digunakan untuk penandatanganan iOS. Jika tidak disetel, akan kembali ke profil penyediaan. Dapat berupa preferensi identitas keychain sertifikat atau (substring) 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.:
--[no]incompatible_disallow_sdk_frameworks_attributes default: "false"

Jika benar, atribut sdk_frameworks dan weak_sdk_frameworks tidak diizinkan dalam objc_library dan objc_import.

Tag: build_file_semantics, incompatible_change

Jika benar, jadikan nilai default benar untuk atribut alwayslink di objc_library dan objc_import.

Tag: build_file_semantics, incompatible_change

--[no]incompatible_python_disallow_native_rules default: "false"

Jika benar (true), terjadi error saat menggunakan aturan py_* bawaan; sebagai gantinya, aturan rule_python harus digunakan. Lihat https://github.com/bazelbuild/bazel/issues/17773 untuk mengetahui informasi dan petunjuk migrasi selengkapnya.

Tag: loading_and_analysis, incompatible_change

Opsi yang mengatur perilaku lingkungan pengujian atau pelaksana pengujian:
--[no]allow_analysis_failures default: "false"

Jika benar (true), kegagalan analisis target aturan akan menyebabkan propagasi target instance AnalysisFailureInfo yang berisi deskripsi error, bukan menyebabkan kegagalan build.

Tag: loading_and_analysis, experimental

--analysis_testing_deps_limit=<an integer> default: "2000"

Menetapkan jumlah maksimum dependensi transitif melalui atribut aturan dengan transisi konfigurasi for_analysis_testing. Melebihi batas ini akan menyebabkan error aturan.

Tag: loading_and_analysis

--[no]break_build_on_parallel_dex2oat_failure default: "false"

Jika benar, kegagalan tindakan dex2oat akan menyebabkan build rusak, bukan menjalankan dex2oat selama runtime pengujian.

Tag: loading_and_analysis, experimental

Penggunaan --default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g memory=10,30,60,100> beberapa kali akan diakumulasikan

Ganti jumlah resource default untuk pengujian. Format yang diharapkan adalah {resource}={value}. Jika satu angka positif ditentukan sebagai {value}, angka tersebut akan menggantikan resource default untuk semua ukuran pengujian. Jika 4 angka yang dipisahkan koma ditentukan, angka tersebut akan menggantikan jumlah resource untuk ukuran pengujian small, medium, large, enormous. Nilai juga dapat berupa HOST_RAM/HOST_CPU, yang secara opsional diikuti oleh [-|*]{float} (mis. memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4). Resource pengujian default yang ditentukan oleh tanda ini digantikan oleh resource eksplisit yang ditentukan dalam tag.

--[no]experimental_android_use_parallel_dex2oat default: "false"

Gunakan dex2oat secara paralel untuk mempercepat android_test.

Tag: loading_and_analysis, host_machine_resource_optimizations, experimental

--[no]ios_memleaks default: "false"

Mengaktifkan pemeriksaan kebocoran memori di target ios_test.

Tag: action_command_lines

--ios_simulator_device=<a string> default: lihat deskripsi

Perangkat yang akan disimulasikan saat menjalankan aplikasi iOS di simulator, misalnya 'iPhone 6'. Anda bisa mendapatkan daftar perangkat dengan menjalankan 'xcrun simctl list devicetypes' di komputer tempat simulator akan dijalankan.

Tag: test_runner

--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi iOS yang akan dijalankan di simulator saat menjalankan atau menguji. Setelan ini diabaikan untuk aturan ios_test jika perangkat target ditentukan dalam aturan.

Tag: test_runner

Penggunaan --runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once> beberapa kali akan diakumulasikan

Menentukan jumlah waktu untuk menjalankan setiap pengujian. Jika salah satu upaya tersebut gagal karena alasan apa pun, seluruh pengujian dianggap gagal. Biasanya, nilai yang ditentukan hanyalah bilangan bulat.

Contoh: --runs_per_test=3 akan menjalankan semua pengujian sebanyak 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 sertakan dan kecualikan (Lihat juga --instrumentation_filter).

Contoh: --runs_per_test=//foo/.*,-//foo/bar/.*@3 menjalankan semua pengujian di //foo/ kecuali pengujian di //foo/bar sebanyak tiga kali. Opsi ini dapat diteruskan beberapa kali. Argumen yang paling baru diteruskan yang cocok akan diutamakan. Jika tidak ada yang cocok, pengujian hanya dijalankan satu kali.

Penggunaan --test_env=<a 'name[=value]' assignment with an optional value part or the special syntax '=name' to unset a variable> beberapa kali akan diakumulasikan

Menentukan variabel lingkungan tambahan yang akan dimasukkan ke dalam lingkungan pelaksana pengujian. Variabel dapat ditentukan oleh name, yang dalam hal ini nilainya akan dibaca dari lingkungan klien Bazel, atau oleh pasangan name=value. Variabel yang ditetapkan sebelumnya dapat dibatalkan melalui =name. Opsi ini dapat digunakan beberapa kali untuk menentukan beberapa variabel. Hanya digunakan oleh perintah 'bazel test'.

Tag: test_runner

--test_timeout=<a single integer or comma-separated list of 4 integers> default: "-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 short, moderate, long, dan eternal (dalam urutan tersebut). Dalam bentuk apa pun, nilai -1 memberi tahu Blaze untuk menggunakan waktu tunggu defaultnya untuk kategori tersebut.

--[no]zip_undeclared_test_outputs default: "false"

Jika benar, output pengujian yang tidak dideklarasikan akan diarsipkan dalam file zip.

Tag: test_runner

Opsi yang memicu pengoptimalan waktu build:
--[no]cc_dotd_files default: "true"

Apakah akan membuat dan menganalisis file .d.

Tag: loading_and_analysis, execution, changes_inputs

--[no]cc_include_scanning default: "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 pohon input kompilasi. Namun, hal ini juga dapat merusak build karena pemindai include tidak sepenuhnya menerapkan semantik praprosesor C. Khususnya, alat ini tidak memahami direktif #include dinamis dan mengabaikan logika bersyarat praprosesor. Gunakan dengan menanggung sendiri risikonya. Setiap masalah terkait tanda ini yang diajukan akan ditutup. Di Google, build Anda kemungkinan besar akan gagal tanpa tanda ini.

Tag: loading_and_analysis, execution, changes_inputs, experimental

--[no]experimental_filter_library_jar_with_program_jar default: "false"

Memfilter ProgramJar ProGuard untuk menghapus class yang juga ada di LibraryJar.

Tag: action_command_lines, experimental

--[no]experimental_inmemory_dotd_files default: "true"

Jika diaktifkan, file .d C++ akan diteruskan dalam memori langsung dari node build jarak jauh, bukan ditulis ke disk.

Tag: loading_and_analysis, execution, affects_outputs, experimental

--[no]experimental_inmemory_jdeps_files default: "true"

Jika diaktifkan, file dependensi (.jdeps) yang dihasilkan dari kompilasi Java akan diteruskan dalam memori langsung dari node build jarak jauh, bukan ditulis ke disk.

Tag: loading_and_analysis, execution, affects_outputs, experimental

--[no]experimental_retain_test_configuration_across_testonly default: "false"

Jika diaktifkan, --trim_test_configuration tidak akan memangkas konfigurasi pengujian untuk aturan yang ditandai dengan testonly=1. Tindakan ini dimaksudkan untuk mengurangi masalah konflik tindakan saat aturan non-pengujian bergantung pada aturan cc_test. Tidak berpengaruh jika --trim_test_configuration adalah false.

Tag: loading_and_analysis, loses_incremental_state, experimental

--[no]experimental_unsupported_and_brittle_include_scanning default: "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 pohon input kompilasi. Namun, hal ini juga dapat merusak build karena pemindai include tidak sepenuhnya menerapkan semantik praprosesor C. Khususnya, alat ini tidak memahami direktif #include dinamis dan mengabaikan logika bersyarat praprosesor. Gunakan dengan menanggung sendiri risikonya. Setiap masalah terkait tanda ini yang diajukan akan ditutup. Di Google, build Anda kemungkinan besar akan gagal tanpa tanda ini.

Tag: loading_and_analysis, execution, changes_inputs, experimental

--[no]incremental_dexing default: "true"

Melakukan sebagian besar pekerjaan dexing secara terpisah untuk setiap file Jar.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state

--[no]objc_use_dotd_pruning default: "true"

Jika disetel, file .d yang dikeluarkan oleh clang akan digunakan untuk memangkas set input yang diteruskan ke kompilasi objc.

Tag: changes_inputs, loading_and_analysis

--[no]process_headers_in_dependencies default: "false"

Saat membuat target //a:a, proses header di semua target yang bergantung pada //a:a (jika pemrosesan header diaktifkan untuk toolchain).

Tag: execution

--[no]trim_test_configuration default: "true"

Jika diaktifkan, opsi terkait pengujian akan dihapus di bawah tingkat 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 respons, format, atau lokasi logging:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> default: "-.*"

Mencetak informasi debug selama penyelesaian toolchain. Flag ini menggunakan regex, 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 penyelesaian toolchain.

Tag: terminal_output

--[no]verbose_visibility_errors default: "false"

Jika diaktifkan, error visibilitas akan menyertakan informasi diagnostik tambahan.

Tag: build_file_semantics, non_configurable

Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
Penggunaan --flag_alias=<a 'name=value' flag alias> beberapa kali akan diakumulasikan

Menetapkan nama singkat untuk flag Starlark. Fungsi ini mengambil satu pasangan nilai kunci dalam bentuk {key}={value} sebagai argumen.

Tag: changes_inputs, non_configurable

--[no]incompatible_default_to_explicit_init_py default: "false"

Flag ini mengubah perilaku default sehingga file init.py tidak lagi dibuat secara otomatis di runfile target Python. Secara tepatnya, saat target py_binary atau py_test memiliki legacy_create_init yang disetel ke "auto" (default), target tersebut akan dianggap salah (false) jika dan hanya jika tanda ini disetel. Lihat https://github.com/bazelbuild/bazel/issues/10076.

Tag: affects_outputs, incompatible_change

Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
--[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 external,
  3. Beberapa uji coba diminta dengan --runs_per_test, atau
  4. Pengujian sebelumnya gagal. Jika ditetapkan ke yes, Bazel akan menyimpan dalam cache semua hasil pengujian kecuali pengujian yang ditandai sebagai external. Jika disetel ke no, Bazel tidak menyimpan hasil pengujian dalam cache.
Default --[no]experimental_cancel_concurrent_tests: "never" (tidak pernah)

Jika on_failed atau on_passed, Blaze akan membatalkan pengujian yang berjalan secara serentak pada pengujian pertama yang berhasil dengan hasil tersebut. Ini hanya berguna jika digunakan bersama --runs_per_test_detects_flakes.

Tag: affects_outputs, loading_and_analysis, experimental

--[no]experimental_fetch_all_coverage_outputs default: "false"

Jika benar (true), Bazel akan mengambil seluruh direktori data cakupan untuk setiap pengujian selama cakupan berjalan.

Tag: affects_outputs, loading_and_analysis, experimental

--[no]experimental_generate_llvm_lcov default: "false"

Jika benar (true), cakupan untuk clang akan menghasilkan laporan LCOV.

Tag: affects_outputs, loading_and_analysis, experimental

--experimental_java_classpath=<off, javabuilder, bazel or bazel_no_fallback> default: "bazel"

Mengaktifkan classpath yang dikurangi untuk kompilasi Java.

--[no]experimental_run_android_lint_on_java_rules default: "false"

Apakah akan memvalidasi sumber java_*.

Tag: affects_outputs, experimental

--[no]explicit_java_test_deps default: "false"

Menentukan dependensi ke JUnit atau Hamcrest secara eksplisit di java_test, bukan secara tidak sengaja diperoleh dari deps TestRunner. Saat ini hanya berfungsi untuk bazel.

--host_java_launcher=<a build target label> default: lihat deskripsi

Peluncur Java yang digunakan oleh alat yang dijalankan selama build.

Penggunaan --host_javacopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke javac saat membangun alat yang dieksekusi selama build.

Penggunaan --host_jvmopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke VM Java saat membuat 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 peluncur pengujian tidak menunjukkan bahwa peluncur tersebut mendukung sharding dengan menyentuh file di jalur dalam TEST_SHARD_STATUS_FILE. Jika salah (false), peluncuran 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 (true), pengujian eksklusif akan berjalan dengan strategi sandbox. Tambahkan tag local untuk memaksa pengujian eksklusif dijalankan secara lokal

Tag: incompatible_change

--[no]incompatible_strict_action_env default: "true"

Jika benar, Bazel 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 penyiapan cache lintas pengguna jika cache bersama digunakan.

Tag: loading_and_analysis, incompatible_change

Penggunaan --j2objc_translation_flags=<comma-separated list of options> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke alat J2ObjC.

--java_debug

Menyebabkan virtual machine Java dari pengujian Java menunggu koneksi dari debugger yang kompatibel dengan JDWP (seperti jdb) sebelum memulai pengujian. Menyiratkan -test_output=streamed.

Meluas 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.

--[no]java_header_compilation default: "true"

Kompilasi ijar langsung dari sumber.

--java_language_version=<a string> default: ""

Versi bahasa Java

--java_launcher=<a build target label> default: lihat deskripsi

Peluncur Java yang akan digunakan saat membangun biner Java. Jika tanda ini disetel ke string kosong, peluncur JDK akan digunakan. Atribut "peluncur" menggantikan tanda ini.

--java_runtime_version=<a string> default: "local_jdk"

Versi runtime Java

Penggunaan --javacopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke javac.

Penggunaan --jvmopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke VM Java. Opsi ini akan ditambahkan ke opsi startup VM dari setiap target java_binary.

--legacy_main_dex_list_generator=<a build target label> default: lihat deskripsi

Menentukan biner yang akan digunakan untuk membuat daftar class yang harus ada di dex utama saat mengompilasi multidex lama.

--optimizing_dexer=<a build target label> default: lihat deskripsi

Menentukan biner yang akan digunakan untuk melakukan dexing tanpa sharding.

Penggunaan --plugin=<a build target label> beberapa kali akan diakumulasikan

Plugin yang akan digunakan dalam build. Saat ini berfungsi dengan java_plugin.

--proguard_top=<a build target label> default: lihat deskripsi

Menentukan versi ProGuard yang akan digunakan untuk penghapusan kode saat membangun biner Java.

--proto_compiler=<a build target label> default: "@bazel_tools//tools/proto:protoc"

Label proto-compiler.

Tag: affects_outputs, loading_and_analysis

--[no]proto_profile default: "true"

Apakah akan meneruskan profile_path ke compiler proto.

Tag: affects_outputs, loading_and_analysis

--proto_profile_path=<a build target label> default: lihat deskripsi

Profil yang akan diteruskan ke compiler proto sebagai profile_path. Jika tidak disetel, tetapi --proto_profile adalah benar (default), menyimpulkan jalur dari --fdo_optimize.

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

Penggunaan --protocopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke compiler protobuf.

Tag: affects_outputs

--[no]runs_per_test_detects_flakes default: "false"

Jika benar (true), setiap shard yang setidaknya satu kali lulus dan setidaknya satu kali gagal akan mendapatkan status TIDAK STABIL (FLAKY).

--shell_executable=<a path> default: lihat deskripsi

Jalur absolut ke shell yang dapat dieksekusi untuk digunakan Bazel. Jika tidak disetel, tetapi variabel lingkungan BAZEL_SH disetel pada pemanggilan Bazel pertama (yang memulai server Bazel), Bazel akan menggunakannya. Jika keduanya tidak ditetapkan, Bazel akan menggunakan jalur default yang dikodekan secara permanen, bergantung pada sistem operasi yang dijalankannya;

  • Windows: c:/msys64/usr/bin/bash.exe
  • FreeBSD: /usr/local/bin/bash
  • 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

Penggunaan --test_arg=<a string> beberapa kali akan 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 identik. Hanya digunakan oleh perintah bazel test.

--test_filter=<a string> default: lihat deskripsi

Menentukan filter untuk diteruskan ke framework pengujian. Digunakan untuk membatasi pengujian yang dijalankan. Perhatikan bahwa hal ini tidak memengaruhi target yang dibuat.

--test_result_expiration=<an integer> default: "-1"

Opsi ini tidak digunakan lagi dan tidak berpengaruh.

--[no]test_runner_fail_fast default: "false"

Meneruskan opsi fail fast ke runner pengujian. Runner pengujian harus menghentikan eksekusi saat kegagalan pertama terjadi.

--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce> default: "explicit"

Tentukan strategi untuk sharding pengujian:

  • explicit untuk hanya menggunakan sharding jika atribut shard_count BUILD ada.
  • disabled agar tidak pernah menggunakan sharding pengujian.
  • forced=k untuk menerapkan shard k untuk pengujian, terlepas dari atribut shard_count BUILD.
--tool_java_language_version=<a string> default: ""

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 mengeksekusi alat selama build

--[no]use_ijars default: "true"

Jika diaktifkan, opsi ini menyebabkan kompilasi Java menggunakan jar antarmuka. Hal ini akan menghasilkan kompilasi inkremental yang lebih cepat, tetapi pesan error dapat berbeda.

Opsi Dump

Opsi yang mengontrol output perintah:
--[no]action_cache default: "false"

Membuang konten cache tindakan.

Tag: bazel_monitoring

--memory=<memory mode> default: lihat deskripsi

Mencatat penggunaan memori node Skyframe tertentu.

Tag: bazel_monitoring

--[no]packages default: "false"

Buang konten cache paket.

Tag: bazel_monitoring

--[no]rule_classes default: "false"

Buang class aturan.

Tag: bazel_monitoring

--[no]rules default: "false"

Aturan dump, termasuk jumlah dan penggunaan memori (jika memori dilacak).

Tag: bazel_monitoring

--skyframe=<off, summary, count, value, deps, rdeps, function_graph, active_directories or active_directories_frontier_deps> default: "nonaktif"

Buang grafik Skyframe.

Tag: bazel_monitoring

--skykey_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> default: ".*"

Filter regex nama SkyKey yang akan ditampilkan. Hanya digunakan dengan --skyframe=deps, rdeps, function_graph.

Tag: bazel_monitoring

--skylark_memory=<a string> default: lihat deskripsi

Mengekspor profil memori yang kompatibel dengan pprof ke jalur yang ditentukan. Untuk mempelajari lebih lanjut, lihat https://github.com/google/pprof.

Tag: bazel_monitoring

Opsi Pengambilan

Mewarisi semua opsi dari test.

Opsi yang mengontrol eksekusi build:
--[no]all default: "false"

Mengambil semua repositori eksternal yang diperlukan untuk membangun target atau repositori apa pun. Ini adalah default jika tidak ada flag dan argumen lain yang diberikan. Hanya berfungsi saat --enable_bzlmod aktif.

Tag: changes_inputs

--[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

--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> default: "auto"

Jumlah thread paralel yang akan digunakan untuk fase pemuatan/analisis.Menggunakan bilangan bulat, atau kata kunci ("auto", "HOST_CPUS", "HOST_RAM"), yang 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.:
--[no]incompatible_config_setting_private_default_visibility default: "false"

Jika incompatible_enforce_config_setting_visibility=false, ini adalah no-op. Jika tidak, jika tanda ini salah (false), setiap config_setting tanpa atribut visibilitas eksplisit adalah //visibility:public. Jika tanda ini benar (true), 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 benar (true), terapkan batasan visibilitas config_setting. Jika salah (false), 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:
--[no]configure default: "false"

Hanya mengambil repositori yang ditandai sebagai configure untuk tujuan konfigurasi sistem. Hanya berfungsi saat --enable_bzlmod aktif.

Tag: changes_inputs

--[no]force default: "false"

Abaikan repositori yang ada jika ada dan paksa pengambilan repositori lagi. Hanya berfungsi jika --enable_bzlmod aktif.

Tag: changes_inputs

Penggunaan --repo=<a string> beberapa kali akan 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 lain-lain, yang tidak dikategorikan di tempat lain.:
Penggunaan --deleted_packages=<comma-separated list of package names> beberapa kali akan diakumulasikan

Daftar nama paket yang dipisahkan koma yang akan dianggap tidak ada oleh sistem build, meskipun paket tersebut 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 menampilkan error jika menemukan label '//x:y/z' jika label tersebut masih disediakan oleh entri package_path lain. Menentukan --deleted_packages x/y akan menghindari masalah ini.

--[no]fetch default: "true"

Mengizinkan perintah untuk mengambil dependensi eksternal. Jika disetel ke salah (false), perintah akan menggunakan versi dependensi yang di-cache, dan jika tidak ada, perintah akan gagal.

--package_path=<colon-separated list of options> default: "%workspace%"

Daftar tempat untuk mencari paket yang dipisahkan dengan titik dua. Elemen yang diawali dengan '%workspace%' bersifat relatif terhadap ruang kerja yang melampirkannya. Jika tidak ada atau kosong, defaultnya adalah output 'bazel info default-package-path'.

--[no]show_loading_progress default: "true"

Jika diaktifkan, Bazel akan mencetak pesan "Loading package:".

Opsi yang mengontrol eksekusi build:
--[no]experimental_persistent_aar_extractor default: "false"

Aktifkan pengekstrak aar persisten menggunakan pekerja.

Tag: execution, experimental

--[no]experimental_remotable_source_manifests default: "false"

Apakah tindakan manifes sumber dapat dilakukan dari jarak jauh

Tag: loading_and_analysis, execution, experimental

--[no]experimental_split_coverage_postprocessing default: "false"

Jika benar, Bazel akan menjalankan pemrosesan pasca-cakupan untuk pengujian di proses baru.

Tag: execution, experimental

--[no]experimental_strict_fileset_output default: "false"

Jika opsi ini diaktifkan, set file akan memperlakukan semua artefak output sebagai file biasa. File tidak akan melintasi direktori atau sensitif terhadap symlink.

Tag: execution, experimental

--[no]incompatible_modify_execution_info_additive default: "true"

Jika diaktifkan, meneruskan beberapa tanda --modify_execution_info bersifat aditif. Jika dinonaktifkan, hanya tanda terakhir yang akan dipertimbangkan.

Tag: execution, affects_outputs, loading_and_analysis, incompatible_change

Penggunaan --modify_execution_info=<regex=[+-]key,regex=[+-]key,...> beberapa kali akan diakumulasikan

Menambahkan atau menghapus kunci dari info eksekusi tindakan berdasarkan mnemonik tindakan. Hanya berlaku untuk tindakan yang mendukung info eksekusi. Banyak tindakan umum yang mendukung info eksekusi, misalnya Genrule, CppCompile, Javac, StarlarkAction, TestRunner. Saat menentukan beberapa nilai, urutan penting karena banyak ekspresi reguler dapat berlaku untuk mnemonik yang sama.

Sintaksis: regex=[+-]key,regex=[+-]key,....

Contoh:

  • .*=+x,.*=-y,.*=+z menambahkan x dan z ke, serta 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 persisten menggunakan pekerja.

Meluas 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 dengan menggunakan pekerja.

Meluas 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

Aktifkan tindakan desugar dan dex Android multiplex persisten menggunakan pekerja.

Meluas 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 yang di-multiplex secara persisten menggunakan pekerja.

Diluaskan 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

Aktifkan alat Android persisten dan yang di-multiplex (dexing, desugaring, pemrosesan resource).

Meluas menjadi:
  --internal_persistent_multiplex_busybox_tools
  --persistent_multiplex_android_resource_processor
  --persistent_multiplex_android_dex_desugar

Tag: host_machine_resource_optimizations, execution

--[no]use_target_platform_for_tests default: "false"

Jika benar (true), gunakan platform target untuk menjalankan pengujian, bukan grup eksekusi pengujian.

Tag: execution

Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
--android_compiler=<a string> default: lihat deskripsi

Compiler target Android.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state

--android_manifest_merger=<legacy, android or force_android> default: "android"

Memilih penggabung manifes yang akan digunakan untuk aturan android_binary. Flag untuk membantu transisi ke penggabung manifes Android dari penggabung lama.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state

--android_platforms=<a build target label> default: ""

Menetapkan platform yang digunakan oleh target android_binary. Jika beberapa platform ditentukan, maka biner adalah APK gemuk, yang berisi biner native untuk setiap platform target yang ditentukan.

Tag: changes_inputs, loading_and_analysis, loses_incremental_state

--cc_output_directory_tag=<a string> default: ""

Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.

Tag: affects_outputs

--compiler=<a string> default: lihat deskripsi

Compiler C++ yang akan digunakan untuk mengompilasi target.

Tag: loading_and_analysis, execution

--coverage_output_generator=<a build target label> default: "@bazel_tools//tools/test:lcov_merger"

Lokasi biner yang digunakan untuk memproses laporan cakupan mentah. Target ini harus berupa biner. Default-nya adalah @bazel_tools//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. Target ini harus berupa biner. Default-nya adalah @bazel_tools//tools/test:coverage_report_generator.

Tag: changes_inputs, affects_outputs, loading_and_analysis

--coverage_support=<a build target label> default: "@bazel_tools//tools/test:coverage_support"

Lokasi file dukungan yang diperlukan pada input setiap tindakan pengujian yang mengumpulkan cakupan kode. Default-nya adalah //tools/test:coverage_support.

Tag: changes_inputs, affects_outputs, loading_and_analysis

--custom_malloc=<a build target label> default: lihat deskripsi

Menentukan implementasi malloc kustom. Setelan ini menggantikan atribut malloc dalam aturan build.

Tag: changes_inputs, affects_outputs

--[no]experimental_include_xcode_execution_requirements default: "false"

Jika disetel, tambahkan persyaratan eksekusi "requires-xcode:{version}" ke setiap tindakan Xcode. Jika versi Xcode memiliki label bergaris hubung, tambahkan juga persyaratan eksekusi "requires-xcode-label:{version_label}".

Tag: loses_incremental_state, loading_and_analysis, execution, experimental

--[no]experimental_prefer_mutual_xcode default: "true"

Jika benar, gunakan Xcode terbaru yang tersedia secara lokal dan jarak jauh. Jika salah (false), atau jika tidak ada versi yang tersedia bersama, gunakan versi Xcode lokal yang dipilih melalui xcode-select.

Tag: loses_incremental_state, experimental

--extra_execution_platforms=<comma-separated list of options> default: ""

Platform yang tersedia sebagai platform eksekusi untuk menjalankan tindakan. Platform dapat ditentukan berdasarkan target yang tepat, atau sebagai pola target. Platform ini akan dipertimbangkan sebelum platform yang dideklarasikan dalam file WORKSPACE oleh register_execution_platforms(). Opsi ini hanya dapat ditetapkan satu kali; instance selanjutnya akan menggantikan setelan tanda sebelumnya.

Tag: execution

Penggunaan --extra_toolchains=<comma-separated list of options> beberapa kali akan diakumulasikan

Aturan toolchain yang akan dipertimbangkan selama penyelesaian toolchain. Rangkaian alat dapat ditentukan berdasarkan target yang persis, atau sebagai pola target. Rangkaian alat ini akan dipertimbangkan sebelum rangkaian alat yang dideklarasikan dalam file WORKSPACE oleh register_toolchains().

Tag: affects_outputs, changes_inputs, loading_and_analysis

--grte_top=<a label> default: lihat deskripsi

Label untuk library libc yang di-check in. Nilai default dipilih oleh toolchain crosstool, dan Anda hampir tidak perlu menggantinya.

Tag: action_command_lines, affects_outputs

--host_compiler=<a string> default: lihat deskripsi

Flag tanpa pengoperasian. Akan dihapus dalam rilis mendatang.

Tag: loading_and_analysis, execution

--host_grte_top=<a label> default: lihat deskripsi

Jika ditentukan, setelan ini akan menggantikan direktori tingkat teratas libc (--grte_top) untuk konfigurasi 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_bazel_test_exec_run_under default: "true"

Jika diaktifkan, bazel test --run_under=//:runner akan membuat //:runner dalam konfigurasi exec. Jika dinonaktifkan, //:runner akan dibuat dalam konfigurasi target. Bazel menjalankan pengujian di mesin eksekusi, sehingga yang pertama lebih tepat. Hal ini tidak memengaruhi bazel run, yang selalu membangun --run_under=//foo dalam konfigurasi target.

Tag: affects_outputs, incompatible_change

--[no]incompatible_builtin_objc_strip_action default: "true"

Apakah akan memancarkan tindakan penghapusan sebagai bagian dari penautan objc.

Tag: action_command_lines, incompatible_change

--[no]incompatible_dont_enable_host_nonhost_crosstool_features default: "true"

Jika benar (true), 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_apple_toolchain_resolution default: "false"

Menggunakan penyelesaian toolchain untuk memilih Apple SDK untuk aturan Apple (Starlark dan native)

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_strip_executable_safely default: "false"

Jika benar, tindakan penghapusan untuk file yang dapat dieksekusi akan menggunakan flag -x, yang tidak merusak resolusi simbol dinamis.

Tag: action_command_lines, incompatible_change

--[no]interface_shared_objects default: "true"

Gunakan objek bersama antarmuka jika didukung oleh toolchain. Semua toolchain ELF saat ini mendukung setelan ini.

Tag: loading_and_analysis, affects_outputs, affects_outputs

--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Menentukan versi iOS SDK yang akan digunakan untuk membangun aplikasi iOS. Jika tidak ditentukan, akan menggunakan versi iOS SDK default dari 'xcode_version'.

Tag: loses_incremental_state

--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Menentukan versi macOS SDK yang akan digunakan untuk membangun aplikasi macOS. Jika tidak ditentukan, akan menggunakan versi SDK macOS default dari 'xcode_version'.

Tag: loses_incremental_state

--minimum_os_version=<a string> default: lihat deskripsi

Versi OS minimum yang ditargetkan kompilasi Anda.

Tag: loading_and_analysis, affects_outputs

--platform_mappings=<a main workspace-relative path> default: ""

Lokasi file pemetaan yang menjelaskan platform mana yang akan digunakan jika tidak ada yang ditetapkan atau tanda mana yang akan ditetapkan jika platform sudah ada. Harus relatif terhadap root ruang kerja utama. Defaultnya adalah platform_mappings (file langsung di bawah root ruang kerja).

Tag: affects_outputs, changes_inputs, loading_and_analysis, non_configurable

--platforms=<a build target label> default: ""

Label aturan platform yang menjelaskan platform target untuk perintah saat ini.

Tag: affects_outputs, changes_inputs, loading_and_analysis

--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Menentukan versi tvOS SDK yang akan digunakan untuk membangun aplikasi tvOS. Jika tidak ditentukan, gunakan versi tvOS SDK default dari 'xcode_version'.

Tag: loses_incremental_state

--[no]use_platforms_in_apple_crosstool_transition default: "false"

Membuat apple_crosstool_transition kembali menggunakan nilai flag --platforms, bukan --cpu lama jika diperlukan.

Tag: loading_and_analysis

--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Menentukan versi watchOS SDK yang akan digunakan untuk membangun aplikasi watchOS. Jika tidak ditentukan, akan menggunakan versi SDK watchOS default dari 'xcode_version'.

Tag: loses_incremental_state

--xcode_version=<a string> default: lihat deskripsi

Jika ditentukan, gunakan Xcode versi tertentu untuk tindakan build yang relevan. Jika tidak ditentukan, akan menggunakan Xcode versi default executor.

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:
--[no]apple_generate_dsym default: "false"

Apakah akan membuat file simbol debug (.dSYM).

Tag: affects_outputs, action_command_lines

Jika benar, bangun hutan symlink runfile untuk semua target. Jika salah (false), tulis hanya jika diperlukan oleh perintah tindakan, pengujian, atau jalankan lokal.

Tag: affects_outputs

--[no]build_runfile_manifests default: "true"

Jika benar, tulis manifes file yang dapat dijalankan untuk semua target. Jika salah (false), hapus. Pengujian lokal akan gagal dijalankan jika salah (false).

Tag: affects_outputs

--[no]build_test_dwp default: "false"

Jika diaktifkan, saat membuat pengujian C++ secara statis dan dengan fission, file .dwp untuk biner pengujian juga akan dibuat secara otomatis.

Tag: loading_and_analysis, affects_outputs

--cc_proto_library_header_suffixes=<comma-separated set of options> default: ".pb.h"

Menetapkan sufiks 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

--[no]experimental_proto_descriptor_sets_include_source_info default: "false"

Menjalankan tindakan tambahan untuk versi API Java alternatif dalam proto_library.

Tag: affects_outputs, loading_and_analysis, experimental

--[no]experimental_save_feature_state default: "false"

Simpan status fitur yang diaktifkan dan diminta sebagai output kompilasi.

Tag: affects_outputs, experimental

--fission=<a set of compilation modes> default: "no"

Menentukan mode kompilasi mana yang menggunakan fusi 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 DefaultInfo.files dependensi data ke runfilenya, yang cocok dengan perilaku yang direkomendasikan untuk aturan Starlark (fitur runfiles yang harus dihindari).

Tag: affects_outputs, incompatible_change

--[no]incompatible_compact_repo_mapping_manifest default: "true"

Jika diaktifkan, file {binary}.repo_mapping memancarkan pemetaan repo ekstensi modul hanya sekali, bukan sekali untuk setiap repo yang dihasilkan oleh ekstensi yang berkontribusi pada runfile.

Tag: affects_outputs, incompatible_change

--incompatible_disable_select_on=<comma-separated set of options> default: ""

Daftar tanda yang penggunaannya di select() dinonaktifkan.

Tag: loading_and_analysis, incompatible_change, non_configurable

--[no]incompatible_filegroup_runfiles_for_data default: "true"

Jika benar (true), runfile target yang tercantum dalam atribut srcs tersedia untuk target yang menggunakan filegroup sebagai dependensi data.

Tag: incompatible_change

--[no]objc_generate_linkmap default: "false"

Menentukan apakah akan membuat file linkmap atau tidak.

Tag: affects_outputs

--[no]save_temps default: "false"

Jika disetel, output sementara dari gcc akan disimpan. File 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, yang memengaruhi nilainya, bukan keberadaannya:
Penggunaan --action_env=<a 'name[=value]' assignment with an optional value part or the special syntax '=name' to unset a variable> beberapa kali akan diakumulasikan

Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi target. Variabel dapat ditentukan oleh name, yang dalam hal ini nilai akan diambil dari lingkungan pemanggilan, oleh pasangan name=value yang menetapkan nilai secara independen dari lingkungan pemanggilan, atau oleh =name, yang membatalkan setel variabel dengan nama tersebut. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru yang akan digunakan, opsi untuk variabel yang berbeda akan terakumulasi.

Perhatikan bahwa kecuali --incompatible_repo_env_ignores_action_env benar (true), semua pasangan name=value akan tersedia untuk aturan repositori.

Tag: action_command_lines

--allowed_cpu_values=<comma-separated set of options> default: ""

Nilai yang diizinkan untuk flag --cpu.

Tag: changes_inputs, affects_outputs

--[no]android_databinding_use_androidx default: "true"

Buat file data binding yang kompatibel dengan AndroidX. Ini hanya digunakan dengan databinding v2. Flag ini adalah no-op.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state, experimental

--[no]android_databinding_use_v3_4_args default: "true"

Gunakan android databinding v2 dengan argumen 3.4.0. Flag ini adalah no-op.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state, experimental

--android_dynamic_mode=<off, default or fully> default: "nonaktif"

Menentukan apakah dependensi C++ 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. 'fully' berarti semua library akan ditautkan secara dinamis. 'off' berarti semua library akan ditautkan dalam mode sebagian besar statis.

Tag: affects_outputs, loading_and_analysis

--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency> default: "alphabetical"

Menetapkan urutan manifes yang diteruskan ke penggabung manifes untuk biner Android. ALPHABETICAL berarti manifes diurutkan berdasarkan jalur relatif terhadap execroot. ALPHABETICAL_BY_CONFIGURATION berarti manifes diurutkan berdasarkan jalur relatif ke direktori konfigurasi dalam direktori output. DEPENDENCY berarti manifes diurutkan dengan manifes setiap library yang mendahului manifes dependensinya.

Tag: action_command_lines, execution

--[no]android_resource_shrinking default: "false"

Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.

Tag: affects_outputs, loading_and_analysis

--[no]build_python_zip default: "auto"

Membangun zip yang dapat dieksekusi python; aktif di Windows, nonaktif di platform lain

Tag: affects_outputs

Penggunaan --catalyst_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membangun biner Apple Catalyst.

Tag: loses_incremental_state, loading_and_analysis

--[no]collect_code_coverage default: "false"

Jika ditentukan, Bazel akan menginstrumentasi 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 pembuatan biner. Nilai: fastbuild, dbg, opt.

Tag: affects_outputs, action_command_lines

Penggunaan --conlyopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber C.

Tag: action_command_lines, affects_outputs

Penggunaan --copt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke gcc.

Tag: action_command_lines, affects_outputs

--cpu=<a string> default: ""

Tidak digunakan lagi: tanda ini tidak digunakan secara internal oleh Blaze meskipun ada pemetaan platform lama untuk memungkinkan kompatibilitas mundur. Jangan gunakan flag ini, tetapi gunakan --platforms dengan definisi platform yang sesuai.

Tag: changes_inputs, affects_outputs

--cs_fdo_absolute_path=<a string> default: lihat deskripsi

Menggunakan informasi profil CSFDO untuk mengoptimalkan kompilasi. Tentukan nama jalur absolut file zip yang berisi file profil, file profil LLVM mentah atau terindeks.

Tag: affects_outputs

--cs_fdo_instrument=<a string> default: lihat deskripsi

Buat biner dengan instrumentasi FDO yang sensitif terhadap konteks. Dengan compiler Clang/LLVM, opsi ini juga menerima nama direktori tempat file profil mentah akan di-dump saat runtime.

Tag: affects_outputs

--cs_fdo_profile=<a build target label> default: lihat deskripsi

cs_fdo_profile yang merepresentasikan profil sensitif konteks yang akan digunakan untuk pengoptimalan.

Tag: affects_outputs

Penggunaan --cxxopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber C++.

Tag: action_command_lines, affects_outputs

Penggunaan --define=<a 'name=value' assignment> beberapa kali akan diakumulasikan

Setiap opsi --define menentukan penetapan untuk variabel build. Jika ada beberapa nilai untuk variabel, nilai terakhir yang akan digunakan.

Tag: changes_inputs, affects_outputs

--dynamic_mode=<off, default or fully> default: "default"

Menentukan apakah biner C++ akan ditautkan secara dinamis. 'default' berarti Bazel akan memilih apakah akan menautkan secara dinamis. 'fully' berarti semua library akan ditautkan secara dinamis. 'off' berarti semua library akan ditautkan dalam mode sebagian besar statis.

Tag: loading_and_analysis, affects_outputs

--[no]enable_propeller_optimize_absolute_paths default: "true"

Jika disetel, penggunaan jalur absolut untuk pengoptimalan baling-baling akan memunculkan error.

Tag: affects_outputs

--[no]enable_remaining_fdo_absolute_paths default: "true"

Jika disetel, penggunaan jalur absolut untuk FDO akan memunculkan error.

Tag: affects_outputs

--[no]enable_runfiles default: "auto"

Aktifkan hierarki symlink runfile; Secara default, opsi ini nonaktif di Windows, dan aktif di platform lain.

Tag: affects_outputs

Penggunaan --exec_aspects=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar aspek yang dipisahkan koma untuk diterapkan ke target yang dikonfigurasi exec, terlepas dari apakah target tersebut adalah target tingkat teratas atau bukan. Fitur ini bersifat eksperimental dan dapat berubah.

Tag: loading_and_analysis

Penggunaan --experimental_action_listener=<a build target label> beberapa kali akan diakumulasikan

Tidak digunakan lagi dan digantikan dengan aspek. Gunakan action_listener untuk melampirkan extra_action ke tindakan build yang ada.

Tag: execution, experimental

--[no]experimental_android_compress_java_resources default: "false"

Mengompresi resource Java di APK

Tag: affects_outputs, loading_and_analysis, experimental

--[no]experimental_android_databinding_v2 default: "true"

Gunakan android databinding v2. Flag ini adalah no-op.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state, experimental

--[no]experimental_android_resource_shrinking default: "false"

Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.

Tag: affects_outputs, loading_and_analysis, experimental

--[no]experimental_android_rewrite_dexes_with_rex default: "false"

menggunakan alat rex untuk menulis ulang file dex

Tag: affects_outputs, loading_and_analysis, loses_incremental_state, experimental

--[no]experimental_collect_code_coverage_for_generated_files default: "false"

Jika ditentukan, Bazel juga akan membuat informasi cakupan pengumpulan untuk file yang dihasilkan.

Tag: affects_outputs, experimental

--experimental_objc_fastbuild_options=<comma-separated list of options> default: "-O0,-DDEBUG=1"

Menggunakan string ini sebagai opsi compiler fastbuild objc.

Tag: action_command_lines

--[no]experimental_omitfp default: "false"

Jika benar, gunakan libunwind untuk pelepasan stack, dan kompilasi dengan -fomit-frame-pointer dan -fasynchronous-unwind-tables.

Tag: action_command_lines, affects_outputs, experimental

--experimental_output_paths=<off or strip> default: "nonaktif"

Model mana yang akan digunakan untuk tempat aturan menulis outputnya di pohon output, terutama untuk build multi-platform / multi-konfigurasi. Fitur ini sangat eksperimental. Lihat GH-6526 untuk mengetahui detailnya. Tindakan Starlark dapat memilih untuk menggunakan pemetaan jalur dengan menambahkan kunci supports-path-mapping ke dict execution_requirements.

Tag: loses_incremental_state, bazel_internal_configuration, affects_outputs, execution

Penggunaan --experimental_override_platform_cpu_name=<a 'label=value' assignment> beberapa kali akan diakumulasikan

Setiap entri harus dalam bentuk label=value dengan label mengacu pada platform dan nilai adalah nama singkat yang diinginkan untuk menggantikan nama CPU platform di $(TARGET_CPU) variabel make dan jalur output. Hanya digunakan jika --experimental_platform_in_output_dir, --incompatible_target_cpu_from_platform, atau --incompatible_bep_cpu_from_platform benar. Memiliki prioritas penamaan tertinggi.

Tag: affects_outputs, experimental

--[no]experimental_platform_in_output_dir default: "Otomatis"

Jika benar (true), nama singkat untuk platform target akan digunakan dalam nama direktori output, bukan CPU. Skema yang tepat bersifat eksperimental dan dapat berubah:

  1. Pertama, jika opsi --platforms tidak memiliki tepat satu nilai, hash opsi platform akan digunakan.
  2. Selanjutnya, jika ada nama pendek untuk platform saat ini yang didaftarkan oleh --experimental_override_name_platform_in_output_dir, nama pendek tersebut akan digunakan.
  3. Kemudian, jika --experimental_use_platforms_in_output_dir_legacy_heuristic disetel, gunakan nama pendek berdasarkan Label platform saat ini.
  4. Terakhir, hash opsi platform digunakan sebagai upaya terakhir.

Tag: affects_outputs, experimental

--[no]experimental_use_llvm_covmap default: "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"

Gunakan tanda ini hanya sebagai bagian dari strategi pengujian atau migrasi yang disarankan. Perhatikan bahwa heuristik memiliki kekurangan yang diketahui dan disarankan untuk bermigrasi agar hanya mengandalkan --experimental_override_name_platform_in_output_dir.

Tag: affects_outputs, experimental

--fdo_instrument=<a string> default: lihat deskripsi

Buat biner dengan instrumentasi FDO. Dengan compiler Clang/LLVM, opsi ini juga menerima nama direktori tempat file profil mentah akan di-dump saat runtime.

Tag: affects_outputs

--fdo_optimize=<a string> default: lihat deskripsi

Gunakan informasi profil FDO untuk mengoptimalkan kompilasi. Tentukan nama file zip yang berisi struktur 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 direktif exports_files ke paket yang sesuai) dan label yang mengarah ke target fdo_profile. Flag ini akan digantikan oleh aturan fdo_profile.

Tag: affects_outputs

--fdo_prefetch_hints=<a build target label> default: lihat deskripsi

Gunakan petunjuk pengambilan data cache.

Tag: affects_outputs

--fdo_profile=<a build target label> default: lihat deskripsi

fdo_profile yang merepresentasikan profil yang akan digunakan untuk pengoptimalan.

Tag: affects_outputs

Penggunaan --features=<a string> beberapa kali akan diakumulasikan

Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi target. Menentukan -{feature} akan menonaktifkan fitur ini. Fitur negatif selalu menggantikan fitur positif. Lihat juga --host_features.

Tag: changes_inputs, affects_outputs

--[no]force_pic default: "false"

Jika diaktifkan, semua kompilasi C++ menghasilkan kode yang independen dari posisi ("-fPIC"), link lebih memilih library bawaan PIC daripada library non-PIC, dan link menghasilkan file yang dapat dieksekusi yang independen dari posisi ("-pie").

Tag: loading_and_analysis, affects_outputs

Penggunaan --host_action_env=<a 'name[=value]' assignment with an optional value part or the special syntax '=name' to unset a variable> beberapa kali akan diakumulasikan

Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi eksekusi. Variabel dapat ditentukan oleh name, yang dalam hal ini nilai akan diambil dari lingkungan pemanggilan, oleh pasangan name=value yang menetapkan nilai secara independen dari lingkungan pemanggilan, atau oleh =name, yang membatalkan setel variabel dengan nama tersebut. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru yang akan digunakan, opsi untuk variabel yang berbeda akan diakumulasikan.

Tag: action_command_lines

--host_compilation_mode=<fastbuild, dbg or opt> default: "opt"

Tentukan mode alat yang digunakan selama build akan dibuat. Nilai: fastbuild, dbg, opt.

Tag: affects_outputs, action_command_lines

Penggunaan --host_conlyopt=<a string> beberapa kali akan 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

Penggunaan --host_copt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke compiler C untuk alat yang dibuat dalam konfigurasi exec.

Tag: action_command_lines, affects_outputs

--host_cpu=<a string> default: ""

CPU host.

Tag: changes_inputs, affects_outputs

Penggunaan --host_cxxopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke compiler C++ untuk alat yang dibuat dalam konfigurasi exec.

Tag: action_command_lines, affects_outputs

Penggunaan --host_features=<a string> beberapa kali akan diakumulasikan

Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi exec. Menentukan -{feature} akan menonaktifkan fitur ini. Fitur negatif selalu menggantikan fitur positif.

Tag: changes_inputs, affects_outputs

Penggunaan --host_linkopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke linker saat menautkan alat dalam konfigurasi exec.

Tag: action_command_lines, affects_outputs

--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi macOS yang kompatibel minimum untuk target host. Jika tidak ditentukan, gunakan 'macos_sdk_version'.

Tag: loses_incremental_state

Penggunaan --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 kali akan diakumulasikan

Opsi tambahan untuk meneruskan 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 untuk disertakan dan dikecualikan (Lihat juga --instrumentation_filter). option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip 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 semua file cc di //foo/ kecuali bar.cc.

Tag: action_command_lines, affects_outputs

--[no]incompatible_auto_exec_groups default: "false"

Jika diaktifkan, grup exec akan otomatis dibuat untuk setiap toolchain yang digunakan oleh aturan. Agar aturan ini berfungsi, aturan perlu menentukan parameter toolchain pada tindakannya. Untuk mengetahui informasi selengkapnya, lihat GH-17134.

Tag: affects_outputs, incompatible_change

--[no]incompatible_merge_genfiles_directory default: "true"

Jika benar, direktori genfiles akan dilipat ke dalam direktori bin.

Tag: affects_outputs, incompatible_change

--[no]incompatible_target_cpu_from_platform default: "true"

Jika ditentukan, nilai batasan CPU (@platforms//cpu:cpu) dari platform target digunakan untuk menetapkan variabel make $(TARGET_CPU).

Tag: loading_and_analysis, incompatible_change

--[no]instrument_test_targets default: "false"

Jika cakupan diaktifkan, tentukan apakah akan mempertimbangkan aturan pengujian instrumentasi. Jika disetel, aturan pengujian yang disertakan oleh --instrumentation_filter akan diinstrumen. Jika tidak, aturan pengujian akan 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 regex 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

--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi iOS yang kompatibel minimum untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'ios_sdk_version'.

Tag: loses_incremental_state

Penggunaan --ios_multi_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membangun 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 diaktifkan, 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

Penggunaan --linkopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke gcc saat menautkan.

Tag: action_command_lines, affects_outputs

Penggunaan --ltobackendopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke langkah backend LTO (di bagian --features=thin_lto).

Tag: action_command_lines, affects_outputs

Penggunaan --ltoindexopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke langkah pengindeksan LTO (di bagian --features=thin_lto).

Tag: action_command_lines, affects_outputs

Penggunaan --macos_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membangun biner Apple macOS.

Tag: loses_incremental_state, loading_and_analysis

--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi macOS yang kompatibel minimum untuk target. Jika tidak ditentukan, gunakan 'macos_sdk_version'.

Tag: loses_incremental_state

--memprof_profile=<a build target label> default: lihat deskripsi

Gunakan profil memprof.

Tag: affects_outputs

--[no]objc_debug_with_GLIBCXX default: "false"

Jika ditetapkan, dan mode kompilasi ditetapkan ke 'dbg', tentukan GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC, dan GLIBCPP_CONCEPT_CHECKS.

Tag: action_command_lines

--[no]objc_enable_binary_stripping default: "false"

Apakah akan melakukan penghapusan simbol dan kode tidak terpakai pada biner yang ditautkan. Pelepasan biner akan dilakukan jika tanda ini dan --compilation_mode=opt ditentukan.

Tag: action_command_lines

Penggunaan --objccopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber Objective-C/C++.

Tag: action_command_lines

Penggunaan --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 kali akan diakumulasikan

Opsi tambahan untuk meneruskan 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 untuk disertakan dan dikecualikan (Lihat juga --instrumentation_filter). option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip 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 semua file cc di //foo/ kecuali bar.cc.

Tag: action_command_lines, affects_outputs

Penggunaan --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 kali akan diakumulasikan

Opsi tambahan untuk meneruskan secara selektif ke backend LTO (di bawah --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 untuk menyertakan dan mengecualikan. option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip 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

--platform_suffix=<a string> default: lihat deskripsi

Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.

Tag: loses_incremental_state, affects_outputs, loading_and_analysis

--propeller_optimize=<a build target label> default: lihat deskripsi

Gunakan informasi profil Propeller untuk mengoptimalkan target build.Profil Propeller harus terdiri dari setidaknya salah satu dari dua file, yaitu profil cc dan profil ld. Flag ini menerima label build yang harus merujuk ke 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",)Direktif exports_files mungkin harus ditambahkan ke paket yang sesuai agar file ini dapat dilihat oleh Bazel. Opsi harus digunakan sebagai: --propeller_optimize=//a/b:propeller_profile

Tag: action_command_lines, affects_outputs

--propeller_optimize_absolute_cc_profile=<a string> default: lihat deskripsi

Nama jalur absolut file cc_profile untuk build yang Dioptimalkan Propeller.

Tag: affects_outputs

--propeller_optimize_absolute_ld_profile=<a string> default: lihat deskripsi

Nama jalur absolut file ld_profile untuk build yang Dioptimalkan Propeller.

Tag: affects_outputs

--run_under=<a prefix in front of command> default: lihat deskripsi

Awalan yang akan disisipkan sebelum file yang dapat dieksekusi untuk perintah test dan run. Jika nilainya foo -bar, dan command line eksekusinya adalah test_binary -baz, maka command line terakhirnya adalah foo -bar test_binary -baz. Ini juga dapat berupa label untuk target yang dapat dieksekusi. Contohnya antara lain:

  • valgrind
  • strace
  • strace -c
  • valgrind --quiet --num-callers=20
  • //package:target
  • //package:target --options

Tag: action_command_lines

--[no]share_native_deps default: "true"

Jika benar, library native yang berisi fungsi identik akan dibagikan di antara target yang berbeda

Tag: loading_and_analysis, affects_outputs

--[no]stamp default: "false"

Membubuhi stempel biner dengan tanggal, nama pengguna, nama host, informasi ruang kerja, dll.

Tag: affects_outputs

Default --strip=<always, sometimes or never>: "sometimes" (kadang-kadang)

Menentukan apakah akan menghapus biner dan library bersama (menggunakan "-Wl,--strip-debug"). Nilai default 'sometimes' berarti hapus jika --compilation_mode=fastbuild.

Tag: affects_outputs

Penggunaan --stripopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke strip saat membuat biner '<name>.stripped'.

Tag: action_command_lines, affects_outputs

Penggunaan --tvos_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membuat biner Apple tvOS.

Tag: loses_incremental_state, loading_and_analysis

--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi tvOS kompatibel minimum untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'tvos_sdk_version'.

Tag: loses_incremental_state

Penggunaan --visionos_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membuat biner Apple visionOS.

Tag: loses_incremental_state, loading_and_analysis

Penggunaan --watchos_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membangun biner Apple watchOS.

Tag: loses_incremental_state, loading_and_analysis

--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi watchOS yang kompatibel minimum untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'watchos_sdk_version'.

Tag: loses_incremental_state

--xbinary_fdo=<a build target label> default: lihat deskripsi

Gunakan informasi profil XbinaryFDO untuk mengoptimalkan kompilasi. Tentukan nama profil biner silang default. Jika opsi ini 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.):
--[no]check_visibility default: "true"

Jika dinonaktifkan, error visibilitas dalam dependensi target akan diturunkan menjadi peringatan.

Tag: build_file_semantics, non_configurable

--[no]desugar_for_android default: "true"

Apakah akan melakukan desugar bytecode Java 8 sebelum dexing.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state

--[no]desugar_java8_libs default: "false"

Apakah akan menyertakan library Java 8 yang didukung dalam aplikasi untuk perangkat lama.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state, experimental

--[no]enforce_constraints default: "true"

Memeriksa lingkungan yang kompatibel dengan setiap target dan melaporkan error jika ada target yang memiliki dependensi yang tidak mendukung lingkungan yang sama

Tag: build_file_semantics

--[no]experimental_check_desugar_deps default: "true"

Apakah akan memeriksa kembali desugaring yang benar pada tingkat biner Android.

Tag: eagerness_to_exit, loading_and_analysis, experimental

--[no]experimental_enforce_transitive_visibility default: "false"

Jika benar (true), aktifkan package()s untuk menyetel atribut transitive_visibility guna membatasi paket mana yang dapat bergantung padanya.

Tag: build_file_semantics, experimental

--experimental_one_version_enforcement=<off, warning or error> default: "OFF"

Jika diaktifkan, memastikan bahwa aturan java_binary tidak boleh berisi lebih dari satu versi file class yang sama di classpath. Penerapan ini dapat merusak build, atau hanya menghasilkan peringatan.

Tag: loading_and_analysis

--experimental_strict_java_deps=<off, warn, error, strict or default> default: "default"

Jika benar, periksa apakah target Java secara eksplisit mendeklarasikan semua target yang digunakan secara langsung sebagai dependensi.

Tag: build_file_semantics, eagerness_to_exit

--[no]incompatible_check_testonly_for_output_files default: "false"

Jika diaktifkan, periksa testonly untuk target prasyarat yang merupakan file output dengan mencari testonly dari aturan pembuatan. Tindakan ini cocok dengan pemeriksaan visibilitas.

Tag: build_file_semantics, incompatible_change

--[no]incompatible_disable_native_android_rules default: "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

--[no]incompatible_disable_native_apple_binary_rule default: "false"

No-op. Dipertahankan di sini untuk kompatibilitas mundur.

Tag: eagerness_to_exit, incompatible_change

--[no]one_version_enforcement_on_java_tests default: "true"

Jika diaktifkan, dan dengan experimental_one_version_enforcement ditetapkan ke nilai selain NONE, terapkan satu versi pada target java_test. Flag ini dapat dinonaktifkan untuk meningkatkan performa pengujian inkremental dengan mengorbankan potensi pelanggaran satu versi yang terlewat.

Tag: loading_and_analysis

--python_native_rules_allowlist=<a build target label> default: lihat deskripsi

Daftar yang diizinkan (target package_group) untuk digunakan saat menerapkan --incompatible_python_disallow_native_rules.

Tag: loading_and_analysis

--[no]strict_filesets default: "false"

Jika opsi ini diaktifkan, set file yang melintasi batas paket akan dilaporkan sebagai error.

Tag: build_file_semantics, eagerness_to_exit

--strict_proto_deps=<off, warn, error, strict or default> default: "error"

Kecuali jika OFF, 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

--strict_public_imports=<off, warn, error, strict or default> default: "nonaktif"

Kecuali OFF, memeriksa apakah target proto_library secara eksplisit mendeklarasikan semua target yang digunakan dalam 'import public' sebagai diekspor.

Tag: build_file_semantics, eagerness_to_exit, incompatible_change

--[no]strict_system_includes default: "false"

Jika benar, header yang ditemukan melalui jalur sertakan sistem (-isystem) juga harus dideklarasikan.

Tag: loading_and_analysis, eagerness_to_exit

Penggunaan --target_environment=<a build target label> beberapa kali akan diakumulasikan

Mendeklarasikan lingkungan target build ini. Harus berupa referensi label ke aturan environment. Jika ditentukan, semua target tingkat teratas harus kompatibel dengan lingkungan ini.

Lihat juga --platforms.

Tag: changes_inputs

Opsi yang memengaruhi output penandatanganan build:
--apk_signing_method=<v1, v2, v1_v2 or v4> default: "v1_v2"

Implementasi yang akan digunakan untuk menandatangani APK

Tag: action_command_lines, affects_outputs, loading_and_analysis

--[no]device_debug_entitlements default: "true"

Jika disetel, dan mode kompilasi bukan 'opt', aplikasi objc akan menyertakan hak debug saat menandatangani.

Tag: changes_inputs

--ios_signing_cert_name=<a string> default: lihat deskripsi

Nama sertifikat yang akan digunakan untuk penandatanganan iOS. Jika tidak disetel, akan kembali ke profil penyediaan. Dapat berupa preferensi identitas keychain sertifikat atau (substring) 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.:
--[no]incompatible_disallow_sdk_frameworks_attributes default: "false"

Jika benar, atribut sdk_frameworks dan weak_sdk_frameworks tidak diizinkan dalam objc_library dan objc_import.

Tag: build_file_semantics, incompatible_change

Jika benar, jadikan nilai default benar untuk atribut alwayslink di objc_library dan objc_import.

Tag: build_file_semantics, incompatible_change

--[no]incompatible_python_disallow_native_rules default: "false"

Jika benar (true), terjadi error saat menggunakan aturan py_* bawaan; sebagai gantinya, aturan rule_python harus digunakan. Lihat https://github.com/bazelbuild/bazel/issues/17773 untuk mengetahui informasi dan petunjuk migrasi selengkapnya.

Tag: loading_and_analysis, incompatible_change

Opsi yang mengatur perilaku lingkungan pengujian atau pelaksana pengujian:
--[no]allow_analysis_failures default: "false"

Jika benar (true), kegagalan analisis target aturan akan menyebabkan propagasi target instance AnalysisFailureInfo yang berisi deskripsi error, bukan menyebabkan kegagalan build.

Tag: loading_and_analysis, experimental

--analysis_testing_deps_limit=<an integer> default: "2000"

Menetapkan jumlah maksimum dependensi transitif melalui atribut aturan dengan transisi konfigurasi for_analysis_testing. Melebihi batas ini akan menyebabkan error aturan.

Tag: loading_and_analysis

--[no]break_build_on_parallel_dex2oat_failure default: "false"

Jika benar, kegagalan tindakan dex2oat akan menyebabkan build rusak, bukan menjalankan dex2oat selama runtime pengujian.

Tag: loading_and_analysis, experimental

Penggunaan --default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g memory=10,30,60,100> beberapa kali akan diakumulasikan

Ganti jumlah resource default untuk pengujian. Format yang diharapkan adalah {resource}={value}. Jika satu angka positif ditentukan sebagai {value}, angka tersebut akan menggantikan resource default untuk semua ukuran pengujian. Jika 4 angka yang dipisahkan koma ditentukan, angka tersebut akan menggantikan jumlah resource untuk ukuran pengujian small, medium, large, enormous. Nilai juga dapat berupa HOST_RAM/HOST_CPU, yang secara opsional diikuti oleh [-|*]{float} (mis. memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4). Resource pengujian default yang ditentukan oleh tanda ini digantikan oleh resource eksplisit yang ditentukan dalam tag.

--[no]experimental_android_use_parallel_dex2oat default: "false"

Gunakan dex2oat secara paralel untuk mempercepat android_test.

Tag: loading_and_analysis, host_machine_resource_optimizations, experimental

--[no]ios_memleaks default: "false"

Mengaktifkan pemeriksaan kebocoran memori di target ios_test.

Tag: action_command_lines

--ios_simulator_device=<a string> default: lihat deskripsi

Perangkat yang akan disimulasikan saat menjalankan aplikasi iOS di simulator, misalnya 'iPhone 6'. Anda bisa mendapatkan daftar perangkat dengan menjalankan 'xcrun simctl list devicetypes' di komputer tempat simulator akan dijalankan.

Tag: test_runner

--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi iOS yang akan dijalankan di simulator saat menjalankan atau menguji. Setelan ini diabaikan untuk aturan ios_test jika perangkat target ditentukan dalam aturan.

Tag: test_runner

Penggunaan --runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once> beberapa kali akan diakumulasikan

Menentukan jumlah waktu untuk menjalankan setiap pengujian. Jika salah satu upaya tersebut gagal karena alasan apa pun, seluruh pengujian dianggap gagal. Biasanya, nilai yang ditentukan hanyalah bilangan bulat.

Contoh: --runs_per_test=3 akan menjalankan semua pengujian sebanyak 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 sertakan dan kecualikan (Lihat juga --instrumentation_filter).

Contoh: --runs_per_test=//foo/.*,-//foo/bar/.*@3 menjalankan semua pengujian di //foo/ kecuali pengujian di //foo/bar sebanyak tiga kali. Opsi ini dapat diteruskan beberapa kali. Argumen yang paling baru diteruskan yang cocok akan diutamakan. Jika tidak ada yang cocok, pengujian hanya dijalankan satu kali.

Penggunaan --test_env=<a 'name[=value]' assignment with an optional value part or the special syntax '=name' to unset a variable> beberapa kali akan diakumulasikan

Menentukan variabel lingkungan tambahan yang akan dimasukkan ke dalam lingkungan pelaksana pengujian. Variabel dapat ditentukan oleh name, yang dalam hal ini nilainya akan dibaca dari lingkungan klien Bazel, atau oleh pasangan name=value. Variabel yang ditetapkan sebelumnya dapat dibatalkan melalui =name. Opsi ini dapat digunakan beberapa kali untuk menentukan beberapa variabel. Hanya digunakan oleh perintah 'bazel test'.

Tag: test_runner

--test_timeout=<a single integer or comma-separated list of 4 integers> default: "-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 short, moderate, long, dan eternal (dalam urutan tersebut). Dalam bentuk apa pun, nilai -1 memberi tahu Blaze untuk menggunakan waktu tunggu defaultnya untuk kategori tersebut.

--[no]zip_undeclared_test_outputs default: "false"

Jika benar, output pengujian yang tidak dideklarasikan akan diarsipkan dalam file zip.

Tag: test_runner

Opsi yang memicu pengoptimalan waktu build:
--[no]cc_dotd_files default: "true"

Apakah akan membuat dan menganalisis file .d.

Tag: loading_and_analysis, execution, changes_inputs

--[no]cc_include_scanning default: "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 pohon input kompilasi. Namun, hal ini juga dapat merusak build karena pemindai include tidak sepenuhnya menerapkan semantik praprosesor C. Khususnya, alat ini tidak memahami direktif #include dinamis dan mengabaikan logika bersyarat praprosesor. Gunakan dengan menanggung sendiri risikonya. Setiap masalah terkait tanda ini yang diajukan akan ditutup. Di Google, build Anda kemungkinan besar akan gagal tanpa tanda ini.

Tag: loading_and_analysis, execution, changes_inputs, experimental

--[no]experimental_filter_library_jar_with_program_jar default: "false"

Memfilter ProgramJar ProGuard untuk menghapus class yang juga ada di LibraryJar.

Tag: action_command_lines, experimental

--[no]experimental_inmemory_dotd_files default: "true"

Jika diaktifkan, file .d C++ akan diteruskan dalam memori langsung dari node build jarak jauh, bukan ditulis ke disk.

Tag: loading_and_analysis, execution, affects_outputs, experimental

--[no]experimental_inmemory_jdeps_files default: "true"

Jika diaktifkan, file dependensi (.jdeps) yang dihasilkan dari kompilasi Java akan diteruskan dalam memori langsung dari node build jarak jauh, bukan ditulis ke disk.

Tag: loading_and_analysis, execution, affects_outputs, experimental

--[no]experimental_retain_test_configuration_across_testonly default: "false"

Jika diaktifkan, --trim_test_configuration tidak akan memangkas konfigurasi pengujian untuk aturan yang ditandai dengan testonly=1. Tindakan ini dimaksudkan untuk mengurangi masalah konflik tindakan saat aturan non-pengujian bergantung pada aturan cc_test. Tidak berpengaruh jika --trim_test_configuration adalah false.

Tag: loading_and_analysis, loses_incremental_state, experimental

--[no]experimental_unsupported_and_brittle_include_scanning default: "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 pohon input kompilasi. Namun, hal ini juga dapat merusak build karena pemindai include tidak sepenuhnya menerapkan semantik praprosesor C. Khususnya, alat ini tidak memahami direktif #include dinamis dan mengabaikan logika bersyarat praprosesor. Gunakan dengan menanggung sendiri risikonya. Setiap masalah terkait tanda ini yang diajukan akan ditutup. Di Google, build Anda kemungkinan besar akan gagal tanpa tanda ini.

Tag: loading_and_analysis, execution, changes_inputs, experimental

--[no]incremental_dexing default: "true"

Melakukan sebagian besar pekerjaan dexing secara terpisah untuk setiap file Jar.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state

--[no]objc_use_dotd_pruning default: "true"

Jika disetel, file .d yang dikeluarkan oleh clang akan digunakan untuk memangkas set input yang diteruskan ke kompilasi objc.

Tag: changes_inputs, loading_and_analysis

--[no]process_headers_in_dependencies default: "false"

Saat membuat target //a:a, proses header di semua target yang bergantung pada //a:a (jika pemrosesan header diaktifkan untuk toolchain).

Tag: execution

--[no]trim_test_configuration default: "true"

Jika diaktifkan, opsi terkait pengujian akan dihapus di bawah tingkat 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 respons, format, atau lokasi logging:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> default: "-.*"

Mencetak informasi debug selama penyelesaian toolchain. Flag ini menggunakan regex, 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 penyelesaian toolchain.

Tag: terminal_output

--[no]verbose_visibility_errors default: "false"

Jika diaktifkan, error visibilitas akan menyertakan informasi diagnostik tambahan.

Tag: build_file_semantics, non_configurable

Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
Penggunaan --flag_alias=<a 'name=value' flag alias> beberapa kali akan diakumulasikan

Menetapkan nama singkat untuk flag Starlark. Fungsi ini mengambil satu pasangan nilai kunci dalam bentuk {key}={value} sebagai argumen.

Tag: changes_inputs, non_configurable

--[no]incompatible_default_to_explicit_init_py default: "false"

Flag ini mengubah perilaku default sehingga file init.py tidak lagi dibuat secara otomatis di runfile target Python. Secara tepatnya, saat target py_binary atau py_test memiliki legacy_create_init yang disetel ke "auto" (default), target tersebut akan dianggap salah (false) jika dan hanya jika tanda ini disetel. Lihat https://github.com/bazelbuild/bazel/issues/10076.

Tag: affects_outputs, incompatible_change

Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
--[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 external,
  3. Beberapa uji coba diminta dengan --runs_per_test, atau
  4. Pengujian sebelumnya gagal. Jika ditetapkan ke yes, Bazel akan menyimpan dalam cache semua hasil pengujian kecuali pengujian yang ditandai sebagai external. Jika disetel ke no, Bazel tidak menyimpan hasil pengujian dalam cache.
Default --[no]experimental_cancel_concurrent_tests: "never" (tidak pernah)

Jika on_failed atau on_passed, Blaze akan membatalkan pengujian yang berjalan secara serentak pada pengujian pertama yang berhasil dengan hasil tersebut. Ini hanya berguna jika digunakan bersama --runs_per_test_detects_flakes.

Tag: affects_outputs, loading_and_analysis, experimental

--[no]experimental_fetch_all_coverage_outputs default: "false"

Jika benar (true), Bazel akan mengambil seluruh direktori data cakupan untuk setiap pengujian selama cakupan berjalan.

Tag: affects_outputs, loading_and_analysis, experimental

--[no]experimental_generate_llvm_lcov default: "false"

Jika benar (true), cakupan untuk clang akan menghasilkan laporan LCOV.

Tag: affects_outputs, loading_and_analysis, experimental

--experimental_java_classpath=<off, javabuilder, bazel or bazel_no_fallback> default: "bazel"

Mengaktifkan classpath yang dikurangi untuk kompilasi Java.

--[no]experimental_run_android_lint_on_java_rules default: "false"

Apakah akan memvalidasi sumber java_*.

Tag: affects_outputs, experimental

--[no]explicit_java_test_deps default: "false"

Menentukan dependensi ke JUnit atau Hamcrest secara eksplisit di java_test, bukan secara tidak sengaja diperoleh dari deps TestRunner. Saat ini hanya berfungsi untuk bazel.

--host_java_launcher=<a build target label> default: lihat deskripsi

Peluncur Java yang digunakan oleh alat yang dijalankan selama build.

Penggunaan --host_javacopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke javac saat membangun alat yang dieksekusi selama build.

Penggunaan --host_jvmopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke VM Java saat membuat 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 peluncur pengujian tidak menunjukkan bahwa peluncur tersebut mendukung sharding dengan menyentuh file di jalur dalam TEST_SHARD_STATUS_FILE. Jika salah (false), peluncuran 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 (true), pengujian eksklusif akan berjalan dengan strategi sandbox. Tambahkan tag local untuk memaksa pengujian eksklusif dijalankan secara lokal

Tag: incompatible_change

--[no]incompatible_strict_action_env default: "true"

Jika benar, Bazel 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 penyiapan cache lintas pengguna jika cache bersama digunakan.

Tag: loading_and_analysis, incompatible_change

Penggunaan --j2objc_translation_flags=<comma-separated list of options> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke alat J2ObjC.

--java_debug

Menyebabkan virtual machine Java dari pengujian Java menunggu koneksi dari debugger yang kompatibel dengan JDWP (seperti jdb) sebelum memulai pengujian. Menyiratkan -test_output=streamed.

Meluas 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.

--[no]java_header_compilation default: "true"

Kompilasi ijar langsung dari sumber.

--java_language_version=<a string> default: ""

Versi bahasa Java

--java_launcher=<a build target label> default: lihat deskripsi

Peluncur Java yang akan digunakan saat membangun biner Java. Jika tanda ini disetel ke string kosong, peluncur JDK akan digunakan. Atribut "peluncur" menggantikan tanda ini.

--java_runtime_version=<a string> default: "local_jdk"

Versi runtime Java

Penggunaan --javacopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke javac.

Penggunaan --jvmopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke VM Java. Opsi ini akan ditambahkan ke opsi startup VM dari setiap target java_binary.

--legacy_main_dex_list_generator=<a build target label> default: lihat deskripsi

Menentukan biner yang akan digunakan untuk membuat daftar class yang harus ada di dex utama saat mengompilasi multidex lama.

--optimizing_dexer=<a build target label> default: lihat deskripsi

Menentukan biner yang akan digunakan untuk melakukan dexing tanpa sharding.

Penggunaan --plugin=<a build target label> beberapa kali akan diakumulasikan

Plugin yang akan digunakan dalam build. Saat ini berfungsi dengan java_plugin.

--proguard_top=<a build target label> default: lihat deskripsi

Menentukan versi ProGuard yang akan digunakan untuk penghapusan kode saat membangun biner Java.

--proto_compiler=<a build target label> default: "@bazel_tools//tools/proto:protoc"

Label proto-compiler.

Tag: affects_outputs, loading_and_analysis

--[no]proto_profile default: "true"

Apakah akan meneruskan profile_path ke compiler proto.

Tag: affects_outputs, loading_and_analysis

--proto_profile_path=<a build target label> default: lihat deskripsi

Profil yang akan diteruskan ke compiler proto sebagai profile_path. Jika tidak disetel, tetapi --proto_profile adalah benar (default), menyimpulkan jalur dari --fdo_optimize.

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

Penggunaan --protocopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke compiler protobuf.

Tag: affects_outputs

--[no]runs_per_test_detects_flakes default: "false"

Jika benar (true), setiap shard yang setidaknya satu kali lulus dan setidaknya satu kali gagal akan mendapatkan status TIDAK STABIL (FLAKY).

--shell_executable=<a path> default: lihat deskripsi

Jalur absolut ke shell yang dapat dieksekusi untuk digunakan Bazel. Jika tidak disetel, tetapi variabel lingkungan BAZEL_SH disetel pada pemanggilan Bazel pertama (yang memulai server Bazel), Bazel akan menggunakannya. Jika keduanya tidak ditetapkan, Bazel akan menggunakan jalur default yang dikodekan secara permanen, bergantung pada sistem operasi yang dijalankannya;

  • Windows: c:/msys64/usr/bin/bash.exe
  • FreeBSD: /usr/local/bin/bash
  • 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

Penggunaan --test_arg=<a string> beberapa kali akan 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 identik. Hanya digunakan oleh perintah bazel test.

--test_filter=<a string> default: lihat deskripsi

Menentukan filter untuk diteruskan ke framework pengujian. Digunakan untuk membatasi pengujian yang dijalankan. Perhatikan bahwa hal ini tidak memengaruhi target yang dibuat.

--test_result_expiration=<an integer> default: "-1"

Opsi ini tidak digunakan lagi dan tidak berpengaruh.

--[no]test_runner_fail_fast default: "false"

Meneruskan opsi fail fast ke runner pengujian. Runner pengujian harus menghentikan eksekusi saat kegagalan pertama terjadi.

--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce> default: "explicit"

Tentukan strategi untuk sharding pengujian:

  • explicit untuk hanya menggunakan sharding jika atribut shard_count BUILD ada.
  • disabled agar tidak pernah menggunakan sharding pengujian.
  • forced=k untuk menerapkan shard k untuk pengujian, terlepas dari atribut shard_count BUILD.
--tool_java_language_version=<a string> default: ""

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 mengeksekusi alat selama build

--[no]use_ijars default: "true"

Jika diaktifkan, opsi ini menyebabkan kompilasi Java menggunakan jar antarmuka. Hal ini akan menghasilkan kompilasi inkremental yang lebih cepat, tetapi pesan error dapat berbeda.

Opsi Bantuan

Opsi yang memengaruhi panjang respons, format, atau lokasi logging:
--help_verbosity=<long, medium or short> default: "medium"

Pilih kejelasan perintah bantuan.

Tag: terminal_output

--long [-l]

Tampilkan deskripsi lengkap setiap opsi, bukan hanya namanya.

Meluas menjadi:
  --help_verbosity=long

Tag: terminal_output

--short

Hanya tampilkan nama opsi, bukan jenis atau artinya.

Meluas menjadi:
  --help_verbosity=short

Tag: terminal_output

Opsi Info

Mewarisi semua opsi dari build.

Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, yang memengaruhi nilainya, bukan keberadaannya:
--info_output_type=<stdout or response_proto> default: "stdout"

Jika stdout, hasilnya langsung dicetak ke konsol. Jika response_proto, hasil perintah info dikemas dalam ekstensi respons.

Tag: affects_outputs, terminal_output

Opsi yang memengaruhi panjang respons, format, atau lokasi logging:
--[no]show_make_env default: "false"

Sertakan lingkungan "Make" dalam output.

Tag: affects_outputs, terminal_output

Opsi Lisensi

Opsi Penginstalan Seluler

Mewarisi semua opsi dari build.

Opsi yang mengontrol eksekusi build:
--mode=<classic, classic_internal_test_do_not_use or skylark> default: "skylark"

Flag tanpa efek yang tidak digunakan lagi. Hanya mode skylark yang masih didukung.

Tag: loading_and_analysis, execution, incompatible_change

Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
--adb=<a string> default: ""

Biner adb yang akan digunakan untuk perintah 'mobile-install'. Jika tidak ditentukan, SDK di Android SDK yang ditentukan oleh opsi command line --android_sdk_channel (atau SDK default jika --android_sdk_channel tidak ditentukan) akan digunakan.

Tag: changes_inputs

Opsi yang mengontrol output perintah:
--[no]incremental default: "false"

Apakah akan melakukan penginstalan inkremental. Jika benar, coba hindari pekerjaan tambahan yang tidak perlu dengan membaca status perangkat tempat kode akan diinstal dan menggunakan informasi tersebut untuk menghindari pekerjaan yang tidak perlu. Jika salah (false) (default), selalu lakukan penginstalan penuh.

Tag: loading_and_analysis

--[no]split_apks default: "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:
Penggunaan --adb_arg=<a string> beberapa kali akan diakumulasikan

Argumen tambahan untuk diteruskan ke adb. Biasanya digunakan untuk menetapkan perangkat yang akan diinstal.

Tag: action_command_lines

--debug_app

Apakah akan menunggu debugger sebelum memulai aplikasi.

Meluas menjadi:
  --start=DEBUG

Tag: execution

--device=<a string> default: ""

Nomor seri perangkat adb. Jika tidak ditentukan, perangkat pertama akan digunakan.

Tag: action_command_lines

--start=<no, cold, warm or debug> default: "NO"

Cara aplikasi harus dimulai setelah menginstalnya. Setel ke WARM untuk mempertahankan dan memulihkan status aplikasi pada penginstalan inkremental.

Tag: execution

--start_app

Apakah akan memulai aplikasi setelah menginstalnya.

Meluas menjadi:
  --start=COLD

Tag: execution

Opsi yang memengaruhi panjang respons, format, atau lokasi logging:
--incremental_install_verbosity=<a string> default: ""

Tingkat kejelasan untuk penginstalan inkremental. Setel ke 1 untuk logging debug.

Tag: bazel_monitoring

Opsi Modifikasi

Opsi yang mengontrol eksekusi build:
--[no]experimental_remotable_source_manifests default: "false"

Apakah tindakan manifes sumber dapat dilakukan dari jarak jauh

Tag: loading_and_analysis, execution, experimental

--[no]experimental_strict_fileset_output default: "false"

Jika opsi ini diaktifkan, set file akan memperlakukan semua artefak output sebagai file biasa. File tidak akan melintasi direktori atau sensitif terhadap symlink.

Tag: execution, experimental

--[no]incompatible_modify_execution_info_additive default: "true"

Jika diaktifkan, meneruskan beberapa tanda --modify_execution_info bersifat aditif. Jika dinonaktifkan, hanya tanda terakhir yang akan dipertimbangkan.

Tag: execution, affects_outputs, loading_and_analysis, incompatible_change

--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> default: "auto"

Jumlah thread paralel yang akan digunakan untuk fase pemuatan/analisis.Menggunakan bilangan bulat, atau kata kunci ("auto", "HOST_CPUS", "HOST_RAM"), yang 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

Penggunaan --modify_execution_info=<regex=[+-]key,regex=[+-]key,...> beberapa kali akan diakumulasikan

Menambahkan atau menghapus kunci dari info eksekusi tindakan berdasarkan mnemonik tindakan. Hanya berlaku untuk tindakan yang mendukung info eksekusi. Banyak tindakan umum yang mendukung info eksekusi, misalnya Genrule, CppCompile, Javac, StarlarkAction, TestRunner. Saat menentukan beberapa nilai, urutan penting karena banyak ekspresi reguler dapat berlaku untuk mnemonik yang sama.

Sintaksis: regex=[+-]key,regex=[+-]key,....

Contoh:

  • .*=+x,.*=-y,.*=+z menambahkan x dan z ke, serta 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

--[no]use_target_platform_for_tests default: "false"

Jika benar (true), gunakan platform target untuk menjalankan pengujian, bukan grup eksekusi pengujian.

Tag: execution

Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
--[no]incompatible_bazel_test_exec_run_under default: "true"

Jika diaktifkan, bazel test --run_under=//:runner akan membuat //:runner dalam konfigurasi exec. Jika dinonaktifkan, //:runner akan dibuat dalam konfigurasi target. Bazel menjalankan pengujian di mesin eksekusi, sehingga yang pertama lebih tepat. Hal ini tidak memengaruhi bazel run, yang selalu membangun --run_under=//foo dalam konfigurasi target.

Tag: affects_outputs, incompatible_change

Opsi yang mengontrol output perintah:

Jika benar, bangun hutan symlink runfile untuk semua target. Jika salah (false), tulis hanya jika diperlukan oleh perintah tindakan, pengujian, atau jalankan lokal.

Tag: affects_outputs

--[no]build_runfile_manifests default: "true"

Jika benar, tulis manifes file yang dapat dijalankan untuk semua target. Jika salah (false), hapus. Pengujian lokal akan gagal dijalankan jika salah (false).

Tag: affects_outputs

--[no]incompatible_always_include_files_in_data default: "true"

Jika benar, aturan native akan menambahkan DefaultInfo.files dependensi data ke runfilenya, yang cocok dengan perilaku yang direkomendasikan untuk aturan Starlark (fitur runfiles yang harus dihindari).

Tag: affects_outputs, incompatible_change

--[no]incompatible_compact_repo_mapping_manifest default: "true"

Jika diaktifkan, file {binary}.repo_mapping memancarkan pemetaan repo ekstensi modul hanya sekali, bukan sekali untuk setiap repo yang dihasilkan oleh ekstensi yang berkontribusi pada runfile.

Tag: affects_outputs, incompatible_change

--incompatible_disable_select_on=<comma-separated set of options> default: ""

Daftar tanda yang penggunaannya di select() dinonaktifkan.

Tag: loading_and_analysis, incompatible_change, non_configurable

--[no]incompatible_filegroup_runfiles_for_data default: "true"

Jika benar (true), runfile target yang tercantum dalam atribut srcs tersedia untuk target yang menggunakan filegroup sebagai dependensi data.

Tag: incompatible_change

Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, yang memengaruhi nilainya, bukan keberadaannya:
Penggunaan --action_env=<a 'name[=value]' assignment with an optional value part or the special syntax '=name' to unset a variable> beberapa kali akan diakumulasikan

Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi target. Variabel dapat ditentukan oleh name, yang dalam hal ini nilai akan diambil dari lingkungan pemanggilan, oleh pasangan name=value yang menetapkan nilai secara independen dari lingkungan pemanggilan, atau oleh =name, yang membatalkan setel variabel dengan nama tersebut. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru yang akan digunakan, opsi untuk variabel yang berbeda akan terakumulasi.

Perhatikan bahwa kecuali --incompatible_repo_env_ignores_action_env benar (true), semua pasangan name=value akan tersedia untuk aturan repositori.

Tag: action_command_lines

--allowed_cpu_values=<comma-separated set of options> default: ""

Nilai yang diizinkan untuk flag --cpu.

Tag: changes_inputs, affects_outputs

--[no]collect_code_coverage default: "false"

Jika ditentukan, Bazel akan menginstrumentasi 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 pembuatan biner. Nilai: fastbuild, dbg, opt.

Tag: affects_outputs, action_command_lines

--cpu=<a string> default: ""

Tidak digunakan lagi: tanda ini tidak digunakan secara internal oleh Blaze meskipun ada pemetaan platform lama untuk memungkinkan kompatibilitas mundur. Jangan gunakan flag ini, tetapi gunakan --platforms dengan definisi platform yang sesuai.

Tag: changes_inputs, affects_outputs

Penggunaan --define=<a 'name=value' assignment> beberapa kali akan diakumulasikan

Setiap opsi --define menentukan penetapan untuk variabel build. Jika ada beberapa nilai untuk variabel, nilai terakhir yang akan digunakan.

Tag: changes_inputs, affects_outputs

--[no]enable_runfiles default: "auto"

Aktifkan hierarki symlink runfile; Secara default, opsi ini nonaktif di Windows, dan aktif di platform lain.

Tag: affects_outputs

Penggunaan --exec_aspects=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar aspek yang dipisahkan koma untuk diterapkan ke target yang dikonfigurasi exec, terlepas dari apakah target tersebut adalah target tingkat teratas atau bukan. Fitur ini bersifat eksperimental dan dapat berubah.

Tag: loading_and_analysis

Penggunaan --experimental_action_listener=<a build target label> beberapa kali akan diakumulasikan

Tidak digunakan lagi dan digantikan dengan aspek. Gunakan action_listener untuk melampirkan extra_action ke tindakan build yang ada.

Tag: execution, experimental

--[no]experimental_collect_code_coverage_for_generated_files default: "false"

Jika ditentukan, Bazel juga akan membuat informasi cakupan pengumpulan untuk file yang dihasilkan.

Tag: affects_outputs, experimental

--experimental_output_paths=<off or strip> default: "nonaktif"

Model mana yang akan digunakan untuk tempat aturan menulis outputnya di pohon output, terutama untuk build multi-platform / multi-konfigurasi. Fitur ini sangat eksperimental. Lihat GH-6526 untuk mengetahui detailnya. Tindakan Starlark dapat memilih untuk menggunakan pemetaan jalur dengan menambahkan kunci supports-path-mapping ke dict execution_requirements.

Tag: loses_incremental_state, bazel_internal_configuration, affects_outputs, execution

Penggunaan --experimental_override_platform_cpu_name=<a 'label=value' assignment> beberapa kali akan diakumulasikan

Setiap entri harus dalam bentuk label=value dengan label mengacu pada platform dan nilai adalah nama singkat yang diinginkan untuk menggantikan nama CPU platform di $(TARGET_CPU) variabel make dan jalur output. Hanya digunakan jika --experimental_platform_in_output_dir, --incompatible_target_cpu_from_platform, atau --incompatible_bep_cpu_from_platform benar. Memiliki prioritas penamaan tertinggi.

Tag: affects_outputs, experimental

--[no]experimental_platform_in_output_dir default: "Otomatis"

Jika benar (true), nama singkat untuk platform target akan digunakan dalam nama direktori output, bukan CPU. Skema yang tepat bersifat eksperimental dan dapat berubah:

  1. Pertama, jika opsi --platforms tidak memiliki tepat satu nilai, hash opsi platform akan digunakan.
  2. Selanjutnya, jika ada nama pendek untuk platform saat ini yang didaftarkan oleh --experimental_override_name_platform_in_output_dir, nama pendek tersebut akan digunakan.
  3. Kemudian, jika --experimental_use_platforms_in_output_dir_legacy_heuristic disetel, gunakan nama pendek berdasarkan Label platform saat ini.
  4. Terakhir, hash opsi platform digunakan sebagai upaya terakhir.

Tag: affects_outputs, experimental

--[no]experimental_use_platforms_in_output_dir_legacy_heuristic default: "true"

Gunakan tanda ini hanya sebagai bagian dari strategi pengujian atau migrasi yang disarankan. Perhatikan bahwa heuristik memiliki kekurangan yang diketahui dan disarankan untuk bermigrasi agar hanya mengandalkan --experimental_override_name_platform_in_output_dir.

Tag: affects_outputs, experimental

Penggunaan --features=<a string> beberapa kali akan diakumulasikan

Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi target. Menentukan -{feature} akan menonaktifkan fitur ini. Fitur negatif selalu menggantikan fitur positif. Lihat juga --host_features.

Tag: changes_inputs, affects_outputs

Penggunaan --host_action_env=<a 'name[=value]' assignment with an optional value part or the special syntax '=name' to unset a variable> beberapa kali akan diakumulasikan

Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi eksekusi. Variabel dapat ditentukan oleh name, yang dalam hal ini nilai akan diambil dari lingkungan pemanggilan, oleh pasangan name=value yang menetapkan nilai secara independen dari lingkungan pemanggilan, atau oleh =name, yang membatalkan setel variabel dengan nama tersebut. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru yang akan digunakan, opsi untuk variabel yang berbeda akan diakumulasikan.

Tag: action_command_lines

--host_compilation_mode=<fastbuild, dbg or opt> default: "opt"

Tentukan mode alat yang digunakan selama build akan dibuat. Nilai: fastbuild, dbg, opt.

Tag: affects_outputs, action_command_lines

--host_cpu=<a string> default: ""

CPU host.

Tag: changes_inputs, affects_outputs

Penggunaan --host_features=<a string> beberapa kali akan diakumulasikan

Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi exec. Menentukan -{feature} akan menonaktifkan fitur ini. Fitur negatif selalu menggantikan fitur positif.

Tag: changes_inputs, affects_outputs

--[no]incompatible_auto_exec_groups default: "false"

Jika diaktifkan, grup exec akan otomatis dibuat untuk setiap toolchain yang digunakan oleh aturan. Agar aturan ini berfungsi, aturan perlu menentukan parameter toolchain pada tindakannya. Untuk mengetahui informasi selengkapnya, lihat GH-17134.

Tag: affects_outputs, incompatible_change

--[no]incompatible_merge_genfiles_directory default: "true"

Jika benar, direktori genfiles akan dilipat ke dalam direktori bin.

Tag: affects_outputs, incompatible_change

--[no]incompatible_target_cpu_from_platform default: "true"

Jika ditentukan, nilai batasan CPU (@platforms//cpu:cpu) dari platform target digunakan untuk menetapkan variabel make $(TARGET_CPU).

Tag: loading_and_analysis, incompatible_change

--[no]instrument_test_targets default: "false"

Jika cakupan diaktifkan, tentukan apakah akan mempertimbangkan aturan pengujian instrumentasi. Jika disetel, aturan pengujian yang disertakan oleh --instrumentation_filter akan diinstrumen. Jika tidak, aturan pengujian akan 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 regex 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

--platform_suffix=<a string> default: lihat deskripsi

Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.

Tag: loses_incremental_state, affects_outputs, loading_and_analysis

--run_under=<a prefix in front of command> default: lihat deskripsi

Awalan yang akan disisipkan sebelum file yang dapat dieksekusi untuk perintah test dan run. Jika nilainya foo -bar, dan command line eksekusinya adalah test_binary -baz, maka command line terakhirnya adalah foo -bar test_binary -baz. Ini juga dapat berupa label untuk target yang dapat dieksekusi. Contohnya antara lain:

  • valgrind
  • strace
  • strace -c
  • valgrind --quiet --num-callers=20
  • //package:target
  • //package:target --options

Tag: action_command_lines

--[no]stamp default: "false"

Membubuhi stempel biner dengan tanggal, nama pengguna, nama host, informasi ruang kerja, dll.

Tag: affects_outputs

Opsi yang memengaruhi seberapa ketat Bazel menerapkan input build yang valid (definisi aturan, kombinasi tanda, dll.):
--[no]check_visibility default: "true"

Jika dinonaktifkan, error visibilitas dalam dependensi target akan diturunkan menjadi peringatan.

Tag: build_file_semantics, non_configurable

--[no]enforce_constraints default: "true"

Memeriksa lingkungan yang kompatibel dengan setiap target dan melaporkan error jika ada target yang memiliki dependensi yang tidak mendukung lingkungan yang sama

Tag: build_file_semantics

--[no]experimental_enforce_transitive_visibility default: "false"

Jika benar (true), aktifkan package()s untuk menyetel atribut transitive_visibility guna membatasi paket mana yang dapat bergantung padanya.

Tag: build_file_semantics, experimental

--[no]incompatible_check_testonly_for_output_files default: "false"

Jika diaktifkan, periksa testonly untuk target prasyarat yang merupakan file output dengan mencari testonly dari aturan pembuatan. Tindakan ini cocok dengan pemeriksaan visibilitas.

Tag: build_file_semantics, incompatible_change

--[no]strict_filesets default: "false"

Jika opsi ini diaktifkan, set file yang melintasi batas paket akan dilaporkan sebagai error.

Tag: build_file_semantics, eagerness_to_exit

Penggunaan --target_environment=<a build target label> beberapa kali akan diakumulasikan

Mendeklarasikan lingkungan target build ini. Harus berupa referensi label ke aturan environment. Jika ditentukan, semua target tingkat teratas harus kompatibel dengan lingkungan ini.

Lihat juga --platforms.

Tag: changes_inputs

Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility default: "false"

Jika incompatible_enforce_config_setting_visibility=false, ini adalah no-op. Jika tidak, jika tanda ini salah (false), setiap config_setting tanpa atribut visibilitas eksplisit adalah //visibility:public. Jika tanda ini benar (true), 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 benar (true), terapkan batasan visibilitas config_setting. Jika salah (false), 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 pelaksana pengujian:
--[no]allow_analysis_failures default: "false"

Jika benar (true), kegagalan analisis target aturan akan menyebabkan propagasi target instance AnalysisFailureInfo yang berisi deskripsi error, bukan menyebabkan kegagalan build.

Tag: loading_and_analysis, experimental

--analysis_testing_deps_limit=<an integer> default: "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

Opsi yang terkait dengan output dan semantik subperintah `mod`:
--[no]all_repos default: "false"

Untuk mod show_repo: menampilkan semua repo di seluruh ruang kerja.

Tag: terminal_output

--[no]all_visible_repos default: "false"

Untuk mod show_repo: menampilkan semua repositori yang terlihat oleh modul dasar yang dipilih, dengan nama yang jelas.

Tag: terminal_output

--base_module=<"<root>" for the root module; <module>@<version> for a specific version of a module; <module> for all versions of a module; @<name> for a repo with the given apparent name; or @@<name> for a repo with the given canonical name> default: "<root>"

Tentukan modul yang relatif terhadap repositori target yang ditentukan akan ditafsirkan.

Tag: terminal_output

--charset=<utf8 or ascii> default: "utf8"

Memilih set karakter yang akan digunakan untuk hierarki. Hanya memengaruhi output teks. Nilai yang valid adalah utf8 atau ascii. Default-nya adalah utf8

Tag: terminal_output

--[no]cycles default: "true"

Menunjukkan siklus dependensi di dalam hierarki yang ditampilkan.

Tag: terminal_output

--depth=<an integer> default: "-1"

Kedalaman tampilan maksimum pohon dependensi. Kedalaman 1 menampilkan dependensi langsung, misalnya. Untuk tree, path, dan all_paths, defaultnya adalah Integer.MAX_VALUE, sedangkan untuk deps dan explain, defaultnya adalah 1 (hanya menampilkan dependensi langsung dari root selain target daun dan induknya).

Tag: terminal_output

--extension_filter=<a comma-separated list of <extension>s> default: lihat deskripsi

Hanya tampilkan penggunaan ekstensi modul ini dan repositori yang dibuat olehnya jika tanda masing-masing ditetapkan. Jika disetel, grafik hasil hanya akan menyertakan jalur yang berisi modul 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: "hidden"

Tentukan seberapa banyak detail tentang penggunaan ekstensi yang akan disertakan dalam hasil kueri.

  • hidden tidak akan menampilkan informasi ekstensi apa pun.
  • usages hanya akan menampilkan nama ekstensi.
  • repos juga akan menyertakan repositori yang diimpor dengan use_repo.
  • all juga akan menampilkan repositori lain yang dibuat oleh ekstensi.

Tag: terminal_output

--extension_usages=<a comma-separated list of <module>s> default: ""

Tentukan modul yang penggunaan ekstensinya akan ditampilkan dalam kueri show_extension.

Tag: terminal_output

--from=<a comma-separated list of <module>s> default: "<root>"

Modul yang menjadi titik awal kueri grafik dependensi akan ditampilkan. Periksa deskripsi setiap kueri untuk mengetahui semantik yang tepat. Default-nya adalah <root>.

Tag: terminal_output

--[no]include_builtin default: "false"

Sertakan modul bawaan dalam grafik dependensi. Dinonaktifkan secara default karena cukup berisik.

Tag: terminal_output

--[no]include_unused default: "false"

Kueri juga akan mempertimbangkan dan menampilkan modul yang tidak digunakan, yang tidak ada dalam grafik penyelesaian modul setelah pemilihan (karena aturan Pemilihan Versi Minimal atau penggantian). Hal ini dapat memiliki efek yang berbeda untuk setiap jenis kueri, yaitu menyertakan jalur baru dalam perintah all_paths, atau dependensi tambahan dalam perintah explain.

Tag: terminal_output

--output=<text, json or graph> default: "text"

Format hasil kueri yang akan dicetak. Nilai yang diizinkan untuk kueri adalah: text, json, graph.

Tag: terminal_output

--[no]verbose default: "false"

Kueri juga akan menampilkan alasan mengapa modul diselesaikan ke versi saat ini (jika diubah). Nilai defaultnya adalah benar (true) hanya untuk kueri penjelasan.

Tag: terminal_output

Opsi yang memengaruhi panjang respons, format, atau lokasi logging:
--[no]verbose_visibility_errors default: "false"

Jika diaktifkan, error visibilitas akan menyertakan informasi diagnostik tambahan.

Tag: build_file_semantics, non_configurable

Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
Penggunaan --flag_alias=<a 'name=value' flag alias> beberapa kali akan diakumulasikan

Menetapkan nama singkat untuk flag Starlark. Fungsi ini mengambil satu pasangan nilai kunci dalam bentuk {key}={value} sebagai argumen.

Tag: changes_inputs, non_configurable

Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
Penggunaan --deleted_packages=<comma-separated list of package names> beberapa kali akan diakumulasikan

Daftar nama paket yang dipisahkan koma yang akan dianggap tidak ada oleh sistem build, meskipun paket tersebut 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 menampilkan error jika menemukan label '//x:y/z' jika label tersebut masih disediakan oleh entri package_path lain. Menentukan --deleted_packages x/y akan menghindari masalah ini.

--[no]fetch default: "true"

Mengizinkan perintah untuk mengambil dependensi eksternal. Jika disetel ke salah (false), perintah akan menggunakan versi dependensi yang di-cache, dan jika tidak ada, perintah akan gagal.

--package_path=<colon-separated list of options> default: "%workspace%"

Daftar tempat untuk mencari paket yang dipisahkan dengan titik dua. Elemen yang diawali dengan '%workspace%' bersifat relatif terhadap ruang kerja yang melampirkannya. Jika tidak ada atau kosong, defaultnya adalah output 'bazel info default-package-path'.

--[no]show_loading_progress default: "true"

Jika diaktifkan, Bazel akan mencetak pesan "Loading package:".

Mewarisi semua opsi dari build.

Opsi lain-lain, yang tidak dikategorikan.:

Mencantumkan mnemonik yang akan digunakan untuk memfilter data print_action, tidak ada pemfilteran yang dilakukan jika dibiarkan kosong.

Opsi Kueri

Opsi yang mengontrol eksekusi build:
--[no]experimental_remotable_source_manifests default: "false"

Apakah tindakan manifes sumber dapat dilakukan dari jarak jauh

Tag: loading_and_analysis, execution, experimental

--[no]experimental_strict_fileset_output default: "false"

Jika opsi ini diaktifkan, set file akan memperlakukan semua artefak output sebagai file biasa. File tidak akan melintasi direktori atau sensitif terhadap symlink.

Tag: execution, experimental

--[no]incompatible_modify_execution_info_additive default: "true"

Jika diaktifkan, meneruskan beberapa tanda --modify_execution_info bersifat aditif. 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

--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> default: "auto"

Jumlah thread paralel yang akan digunakan untuk fase pemuatan/analisis.Menggunakan bilangan bulat, atau kata kunci ("auto", "HOST_CPUS", "HOST_RAM"), yang 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

Penggunaan --modify_execution_info=<regex=[+-]key,regex=[+-]key,...> beberapa kali akan diakumulasikan

Menambahkan atau menghapus kunci dari info eksekusi tindakan berdasarkan mnemonik tindakan. Hanya berlaku untuk tindakan yang mendukung info eksekusi. Banyak tindakan umum yang mendukung info eksekusi, misalnya Genrule, CppCompile, Javac, StarlarkAction, TestRunner. Saat menentukan beberapa nilai, urutan penting karena banyak ekspresi reguler dapat berlaku untuk mnemonik yang sama.

Sintaksis: regex=[+-]key,regex=[+-]key,....

Contoh:

  • .*=+x,.*=-y,.*=+z menambahkan x dan z ke, serta 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

--[no]use_target_platform_for_tests default: "false"

Jika benar (true), gunakan platform target untuk menjalankan pengujian, bukan grup eksekusi pengujian.

Tag: execution

Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
--[no]incompatible_bazel_test_exec_run_under default: "true"

Jika diaktifkan, bazel test --run_under=//:runner akan membuat //:runner dalam konfigurasi exec. Jika dinonaktifkan, //:runner akan dibuat dalam konfigurasi target. Bazel menjalankan pengujian di mesin eksekusi, sehingga yang pertama lebih tepat. Hal ini tidak memengaruhi bazel run, yang selalu membangun --run_under=//foo dalam konfigurasi target.

Tag: affects_outputs, incompatible_change

Opsi yang mengontrol output perintah:

Jika benar, bangun hutan symlink runfile untuk semua target. Jika salah (false), tulis hanya jika diperlukan oleh perintah tindakan, pengujian, atau jalankan lokal.

Tag: affects_outputs

--[no]build_runfile_manifests default: "true"

Jika benar, tulis manifes file yang dapat dijalankan untuk semua target. Jika salah (false), hapus. Pengujian lokal akan gagal dijalankan jika salah (false).

Tag: affects_outputs

--[no]incompatible_always_include_files_in_data default: "true"

Jika benar, aturan native akan menambahkan DefaultInfo.files dependensi data ke runfilenya, yang cocok dengan perilaku yang direkomendasikan untuk aturan Starlark (fitur runfiles yang harus dihindari).

Tag: affects_outputs, incompatible_change

--[no]incompatible_compact_repo_mapping_manifest default: "true"

Jika diaktifkan, file {binary}.repo_mapping memancarkan pemetaan repo ekstensi modul hanya sekali, bukan sekali untuk setiap repo yang dihasilkan oleh ekstensi yang berkontribusi pada runfile.

Tag: affects_outputs, incompatible_change

--incompatible_disable_select_on=<comma-separated set of options> default: ""

Daftar tanda yang penggunaannya di select() dinonaktifkan.

Tag: loading_and_analysis, incompatible_change, non_configurable

--[no]incompatible_filegroup_runfiles_for_data default: "true"

Jika benar (true), runfile target yang tercantum dalam atribut srcs tersedia untuk target yang menggunakan filegroup sebagai dependensi data.

Tag: incompatible_change

Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, yang memengaruhi nilainya, bukan keberadaannya:
Penggunaan --action_env=<a 'name[=value]' assignment with an optional value part or the special syntax '=name' to unset a variable> beberapa kali akan diakumulasikan

Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi target. Variabel dapat ditentukan oleh name, yang dalam hal ini nilai akan diambil dari lingkungan pemanggilan, oleh pasangan name=value yang menetapkan nilai secara independen dari lingkungan pemanggilan, atau oleh =name, yang membatalkan setel variabel dengan nama tersebut. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru yang akan digunakan, opsi untuk variabel yang berbeda akan terakumulasi.

Perhatikan bahwa kecuali --incompatible_repo_env_ignores_action_env benar (true), semua pasangan name=value akan tersedia untuk aturan repositori.

Tag: action_command_lines

--allowed_cpu_values=<comma-separated set of options> default: ""

Nilai yang diizinkan untuk flag --cpu.

Tag: changes_inputs, affects_outputs

--[no]collect_code_coverage default: "false"

Jika ditentukan, Bazel akan menginstrumentasi 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 pembuatan biner. Nilai: fastbuild, dbg, opt.

Tag: affects_outputs, action_command_lines

--cpu=<a string> default: ""

Tidak digunakan lagi: tanda ini tidak digunakan secara internal oleh Blaze meskipun ada pemetaan platform lama untuk memungkinkan kompatibilitas mundur. Jangan gunakan flag ini, tetapi gunakan --platforms dengan definisi platform yang sesuai.

Tag: changes_inputs, affects_outputs

Penggunaan --define=<a 'name=value' assignment> beberapa kali akan diakumulasikan

Setiap opsi --define menentukan penetapan untuk variabel build. Jika ada beberapa nilai untuk variabel, nilai terakhir yang akan digunakan.

Tag: changes_inputs, affects_outputs

--[no]enable_runfiles default: "auto"

Aktifkan hierarki symlink runfile; Secara default, opsi ini nonaktif di Windows, dan aktif di platform lain.

Tag: affects_outputs

Penggunaan --exec_aspects=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar aspek yang dipisahkan koma untuk diterapkan ke target yang dikonfigurasi exec, terlepas dari apakah target tersebut adalah target tingkat teratas atau bukan. Fitur ini bersifat eksperimental dan dapat berubah.

Tag: loading_and_analysis

Penggunaan --experimental_action_listener=<a build target label> beberapa kali akan diakumulasikan

Tidak digunakan lagi dan digantikan dengan aspek. Gunakan action_listener untuk melampirkan extra_action ke tindakan build yang ada.

Tag: execution, experimental

--[no]experimental_collect_code_coverage_for_generated_files default: "false"

Jika ditentukan, Bazel juga akan membuat informasi cakupan pengumpulan untuk file yang dihasilkan.

Tag: affects_outputs, experimental

--experimental_output_paths=<off or strip> default: "nonaktif"

Model mana yang akan digunakan untuk tempat aturan menulis outputnya di pohon output, terutama untuk build multi-platform / multi-konfigurasi. Fitur ini sangat eksperimental. Lihat GH-6526 untuk mengetahui detailnya. Tindakan Starlark dapat memilih untuk menggunakan pemetaan jalur dengan menambahkan kunci supports-path-mapping ke dict execution_requirements.

Tag: loses_incremental_state, bazel_internal_configuration, affects_outputs, execution

Penggunaan --experimental_override_platform_cpu_name=<a 'label=value' assignment> beberapa kali akan diakumulasikan

Setiap entri harus dalam bentuk label=value dengan label mengacu pada platform dan nilai adalah nama singkat yang diinginkan untuk menggantikan nama CPU platform di $(TARGET_CPU) variabel make dan jalur output. Hanya digunakan jika --experimental_platform_in_output_dir, --incompatible_target_cpu_from_platform, atau --incompatible_bep_cpu_from_platform benar. Memiliki prioritas penamaan tertinggi.

Tag: affects_outputs, experimental

--[no]experimental_platform_in_output_dir default: "Otomatis"

Jika benar (true), nama singkat untuk platform target akan digunakan dalam nama direktori output, bukan CPU. Skema yang tepat bersifat eksperimental dan dapat berubah:

  1. Pertama, jika opsi --platforms tidak memiliki tepat satu nilai, hash opsi platform akan digunakan.
  2. Selanjutnya, jika ada nama pendek untuk platform saat ini yang didaftarkan oleh --experimental_override_name_platform_in_output_dir, nama pendek tersebut akan digunakan.
  3. Kemudian, jika --experimental_use_platforms_in_output_dir_legacy_heuristic disetel, gunakan nama pendek berdasarkan Label platform saat ini.
  4. Terakhir, hash opsi platform digunakan sebagai upaya terakhir.

Tag: affects_outputs, experimental

--[no]experimental_use_platforms_in_output_dir_legacy_heuristic default: "true"

Gunakan tanda ini hanya sebagai bagian dari strategi pengujian atau migrasi yang disarankan. Perhatikan bahwa heuristik memiliki kekurangan yang diketahui dan disarankan untuk bermigrasi agar hanya mengandalkan --experimental_override_name_platform_in_output_dir.

Tag: affects_outputs, experimental

Penggunaan --features=<a string> beberapa kali akan diakumulasikan

Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi target. Menentukan -{feature} akan menonaktifkan fitur ini. Fitur negatif selalu menggantikan fitur positif. Lihat juga --host_features.

Tag: changes_inputs, affects_outputs

Penggunaan --host_action_env=<a 'name[=value]' assignment with an optional value part or the special syntax '=name' to unset a variable> beberapa kali akan diakumulasikan

Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi eksekusi. Variabel dapat ditentukan oleh name, yang dalam hal ini nilai akan diambil dari lingkungan pemanggilan, oleh pasangan name=value yang menetapkan nilai secara independen dari lingkungan pemanggilan, atau oleh =name, yang membatalkan setel variabel dengan nama tersebut. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru yang akan digunakan, opsi untuk variabel yang berbeda akan terakumulasi.

Tag: action_command_lines

--host_compilation_mode=<fastbuild, dbg or opt> default: "opt"

Tentukan mode alat yang digunakan selama build akan dibuat. Nilai: fastbuild, dbg, opt.

Tag: affects_outputs, action_command_lines

--host_cpu=<a string> default: ""

CPU host.

Tag: changes_inputs, affects_outputs

Penggunaan --host_features=<a string> beberapa kali akan diakumulasikan

Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi exec. Menentukan -{feature} akan menonaktifkan fitur ini. Fitur negatif selalu menggantikan fitur positif.

Tag: changes_inputs, affects_outputs

--[no]incompatible_auto_exec_groups default: "false"

Jika diaktifkan, grup exec akan otomatis dibuat untuk setiap toolchain yang digunakan oleh aturan. Agar aturan ini berfungsi, aturan perlu menentukan parameter toolchain pada tindakannya. Untuk mengetahui informasi selengkapnya, lihat GH-17134.

Tag: affects_outputs, incompatible_change

--[no]incompatible_merge_genfiles_directory default: "true"

Jika benar, direktori genfiles akan dilipat ke dalam direktori bin.

Tag: affects_outputs, incompatible_change

--[no]incompatible_target_cpu_from_platform default: "true"

Jika ditentukan, nilai batasan CPU (@platforms//cpu:cpu) dari platform target digunakan untuk menetapkan variabel make $(TARGET_CPU).

Tag: loading_and_analysis, incompatible_change

--[no]instrument_test_targets default: "false"

Jika cakupan diaktifkan, tentukan apakah akan mempertimbangkan aturan pengujian instrumentasi. Jika disetel, aturan pengujian yang disertakan oleh --instrumentation_filter akan diinstrumen. Jika tidak, aturan pengujian akan 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 regex 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

--platform_suffix=<a string> default: lihat deskripsi

Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.

Tag: loses_incremental_state, affects_outputs, loading_and_analysis

--run_under=<a prefix in front of command> default: lihat deskripsi

Awalan yang akan disisipkan sebelum file yang dapat dieksekusi untuk perintah test dan run. Jika nilainya foo -bar, dan command line eksekusinya adalah test_binary -baz, maka command line terakhirnya adalah foo -bar test_binary -baz. Ini juga dapat berupa label untuk target yang dapat dieksekusi. Contohnya antara lain:

  • valgrind
  • strace
  • strace -c
  • valgrind --quiet --num-callers=20
  • //package:target
  • //package:target --options

Tag: action_command_lines

--[no]stamp default: "false"

Membubuhi stempel biner dengan tanggal, nama pengguna, nama host, informasi ruang kerja, dll.

Tag: affects_outputs

Opsi yang memengaruhi seberapa ketat Bazel menerapkan input build yang valid (definisi aturan, kombinasi tanda, dll.):
--[no]check_visibility default: "true"

Jika dinonaktifkan, error visibilitas dalam dependensi target akan diturunkan menjadi peringatan.

Tag: build_file_semantics, non_configurable

--[no]enforce_constraints default: "true"

Memeriksa lingkungan yang kompatibel dengan setiap target dan melaporkan error jika ada target yang memiliki dependensi yang tidak mendukung lingkungan yang sama

Tag: build_file_semantics

--[no]experimental_enforce_transitive_visibility default: "false"

Jika benar (true), aktifkan package()s untuk menyetel atribut transitive_visibility guna membatasi paket mana yang dapat bergantung padanya.

Tag: build_file_semantics, experimental

--[no]incompatible_check_testonly_for_output_files default: "false"

Jika diaktifkan, periksa testonly untuk target prasyarat yang merupakan file output dengan mencari testonly dari aturan pembuatan. Tindakan ini cocok dengan pemeriksaan visibilitas.

Tag: build_file_semantics, incompatible_change

--[no]strict_filesets default: "false"

Jika opsi ini diaktifkan, set file yang melintasi batas paket akan dilaporkan sebagai error.

Tag: build_file_semantics, eagerness_to_exit

Penggunaan --target_environment=<a build target label> beberapa kali akan diakumulasikan

Mendeklarasikan lingkungan target build ini. Harus berupa referensi label ke aturan environment. Jika ditentukan, semua target tingkat teratas harus kompatibel dengan lingkungan ini.

Lihat juga --platforms.

Tag: changes_inputs

Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]incompatible_config_setting_private_default_visibility default: "false"

Jika incompatible_enforce_config_setting_visibility=false, ini adalah no-op. Jika tidak, jika tanda ini salah (false), setiap config_setting tanpa atribut visibilitas eksplisit adalah //visibility:public. Jika tanda ini benar (true), 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 benar (true), terapkan batasan visibilitas config_setting. Jika salah (false), 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 pelaksana pengujian:
--[no]allow_analysis_failures default: "false"

Jika benar (true), kegagalan analisis target aturan akan menyebabkan propagasi target instance AnalysisFailureInfo yang berisi deskripsi error, bukan menyebabkan kegagalan build.

Tag: loading_and_analysis, experimental

--analysis_testing_deps_limit=<an integer> default: "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

Opsi yang terkait dengan output dan semantik kueri:
--aspect_deps=<off, conservative or precise> default: "conservative" (konservatif)

Cara menyelesaikan dependensi aspek saat format output adalah salah satu dari {xml,proto,record}. 'off' berarti tidak ada dependensi aspek yang diselesaikan, 'conservative' (default) berarti semua dependensi aspek yang dideklarasikan ditambahkan terlepas dari apakah dependensi tersebut diberi class aturan dependensi langsung, 'precise' berarti hanya aspek yang mungkin aktif yang ditambahkan mengingat class aturan dependensi langsung. Perhatikan bahwa mode presisi memerlukan pemuatan paket lain untuk mengevaluasi satu target sehingga lebih lambat daripada mode lainnya. Perhatikan juga bahwa meskipun mode presisi tidak sepenuhnya presisi: keputusan apakah akan menghitung aspek diputuskan dalam fase analisis, yang tidak dijalankan selama 'bazel query'.

Tag: build_file_semantics

--[no]consistent_labels default: "false"

Jika diaktifkan, setiap perintah kueri akan memancarkan label seolah-olah dengan fungsi <code>str</code> Starlark 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 dapat memancarkan nama repositori yang jelas (relatif terhadap repositori utama) untuk membuat output lebih mudah dibaca.

Tag: terminal_output

--[no]experimental_explicit_aspects default: "false"

aquery, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: no-op (aspek selalu diikuti).

Tag: terminal_output

--[no]experimental_graphless_query default: "auto"

Jika benar, menggunakan implementasi Kueri yang tidak membuat salinan grafik. Implementasi baru hanya mendukung --order_output=no, serta hanya sebagian kecil pemformat output.

Tag: build_file_semantics, eagerness_to_exit

--graph:conditional_edges_limit=<an integer> default: "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 dikeluarkan 'terfaktor', yaitu node yang setara secara topologi akan digabungkan dan labelnya digabungkan. Opsi ini hanya berlaku untuk --output=graph.

Tag: terminal_output

--graph:node_limit=<an integer> default: "512"

Panjang maksimum string label untuk node grafik dalam output. Label yang lebih panjang akan dipotong; -1 berarti tidak ada pemotongan. Opsi ini hanya berlaku untuk --output=graph.

Tag: terminal_output

--[no]implicit_deps default: "true"

Jika diaktifkan, dependensi implisit akan disertakan dalam grafik dependensi tempat kueri 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 telah diselesaikan.

Tag: build_file_semantics

--[no]include_aspects default: "true"

aquery, cquery: apakah akan menyertakan tindakan yang dihasilkan aspek dalam output. query: no-op (aspek selalu diikuti).

Tag: terminal_output

--[no]incompatible_lexicographical_output default: "true"

Jika opsi ini disetel, akan mengurutkan output --order_output=auto dalam urutan leksikografis.

Tag: terminal_output, incompatible_change

--[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

--[no]infer_universe_scope default: "false"

Jika ditetapkan dan --universe_scope tidak ditetapkan, maka 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 semesta (misalnya,allrdeps) mungkin tidak sesuai dengan 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

--[no]line_terminator_null default: "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 "visibility". 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 berurutan. Output yang tidak berurutan lebih cepat, tetapi hanya didukung jika --output bukan minrank, maxrank, atau graph.

Meluas menjadi:
  --order_output=no

Tag: terminal_output

--null

Apakah setiap format diakhiri dengan \0, bukan baris baru.

Meluas menjadi:
  --line_terminator_null=true

Tag: terminal_output

--order_output=<no, deps, auto or full> default: "auto"

Menghasilkan output yang tidak berurutan (no), berurutan berdasarkan dependensi (deps), atau berurutan sepenuhnya (full). Nilai defaultnya adalah 'auto', yang berarti hasil ditampilkan dalam urutan dependensi atau urutan penuh, bergantung pada pemformat output (urutan dependensi untuk proto, minrank, maxrank, dan graph, urutan penuh untuk yang lainnya). Jika output diurutkan sepenuhnya, node akan dicetak dalam urutan yang sepenuhnya deterministik (total). Pertama, semua node diurutkan menurut abjad. Kemudian, setiap node dalam daftar digunakan sebagai awal penelusuran depth-first post-order yang melintasi tepi keluar ke node yang belum dikunjungi dalam urutan abjad node penerus. Terakhir, node dicetak dalam urutan terbalik dari urutan saat dikunjungi.

Tag: terminal_output

--order_results

Menghasilkan output dalam urutan dependensi (default) atau tidak berurutan. Output yang tidak berurutan lebih cepat, tetapi hanya didukung jika --output bukan minrank, maxrank, atau graph.

Meluas menjadi:
  --order_output=auto

Tag: terminal_output

--output=<a string> default: "label"

Format hasil kueri yang akan dicetak. Nilai yang diizinkan untuk kueri adalah: build, graph, streamed_jsonproto, label, label_kind, location, maxrank, minrank, package, proto, streamed_proto, xml.

Tag: terminal_output

--output_file=<a string> default: ""

Jika ditentukan, hasil kueri akan ditulis langsung ke file ini, dan tidak ada yang akan dicetak ke aliran output standar (stdout) Bazel. Dalam tolok ukur, hal ini umumnya lebih cepat daripada <code>bazel query > file</code>.

Tag: terminal_output

--[no]proto:default_values default: "true"

Jika benar (true), atribut yang nilainya tidak ditentukan secara eksplisit dalam file BUILD akan disertakan; jika tidak, atribut tersebut akan dihilangkan. Opsi ini berlaku untuk --output=proto

Tag: terminal_output

--[no]proto:definition_stack default: "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 satu kali. Jenis skalar diratakan menjadi null.

Tag: build_file_semantics

--[no]proto:include_attribute_source_aspects default: "false"

Isi kolom proto source_aspect_name setiap Atribut dengan aspek sumber yang berasal dari atribut tersebut (string kosong jika tidak ada).

Tag: terminal_output

--[no]proto:include_starlark_rule_env default: "true"

Gunakan lingkungan starlark dalam nilai atribut $internal_attr_hash yang dihasilkan. Hal ini memastikan bahwa definisi aturan starlark (dan impor transitifnya) adalah bagian dari ID ini.

Tag: terminal_output

--[no]proto:include_synthetic_attribute_hash default: "false"

Apakah akan menghitung dan mengisi atribut $internal_attr_hash atau tidak.

Tag: terminal_output

--[no]proto:instantiation_stack default: "false"

Mengisi stack panggilan instansiasi setiap aturan. Perhatikan bahwa hal ini memerlukan kehadiran stack

Tag: terminal_output

--[no]proto:locations default: "true"

Apakah akan menampilkan informasi lokasi dalam output proto atau tidak.

Tag: terminal_output

--proto:output_rule_attrs=<comma-separated list of options> default: "all"

Daftar atribut yang dipisahkan koma untuk disertakan dalam output. Secara default, semua atribut akan ditampilkan. Setel ke string kosong agar tidak menampilkan atribut apa pun. Opsi ini berlaku untuk --output=proto.

Tag: terminal_output

--[no]proto:rule_classes default: "false"

Isi kolom rule_class_key setiap aturan; dan untuk aturan pertama dengan rule_class_key tertentu, isi juga kolom proto rule_class_info-nya. Kolom rule_class_key secara unik mengidentifikasi class aturan, dan kolom rule_class_info adalah definisi API class aturan berformat Stardoc.

Tag: terminal_output

--[no]proto:rule_inputs_and_outputs default: "true"

Apakah kolom rule_input dan rule_output akan diisi atau tidak.

Tag: terminal_output

--query_file=<a string> default: ""

Jika disetel, kueri akan membaca kueri dari file yang diberi nama di sini, bukan di command line. Menentukan file di sini serta kueri command line adalah suatu kesalahan.

Tag: changes_inputs

--[no]relative_locations default: "false"

Jika benar (true), 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 menyetel opsi ini ke benar (true) untuk mendapatkan hasil yang konsisten di seluruh perangkat.

Tag: terminal_output

--[no]strict_test_suite default: "false"

Jika benar, ekspresi tests() akan memberikan error jika menemukan test_suite yang berisi target non-pengujian.

Tag: build_file_semantics, eagerness_to_exit

--[no]tool_deps default: "true"

Kueri: Jika dinonaktifkan, dependensi pada 'konfigurasi exec' tidak akan disertakan dalam grafik dependensi yang digunakan kueri. Edge dependensi 'konfigurasi exec', seperti yang berasal dari aturan 'proto_library' ke Pengompilasi Protokol, biasanya mengarah ke alat yang dijalankan 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 ada dalam konfigurasi target, hanya target yang dikonfigurasi yang juga ada 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 diselesaikan.

Tag: build_file_semantics

--universe_scope=<comma-separated list of options> default: ""

Kumpulan pola target yang dipisahkan koma (aditif dan subtraktif). Kueri dapat dilakukan di 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 yang digunakan untuk membuat semua jawaban, sehingga opsi ini dapat memengaruhi konfigurasi dan transisi. Jika opsi ini tidak ditentukan, target tingkat teratas 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 dibangun dengan opsi tingkat teratas.

Tag: loading_and_analysis

--[no]xml:default_values default: "false"

Jika benar (true), atribut aturan yang nilainya tidak ditentukan secara eksplisit dalam file BUILD akan dicetak; jika tidak, atribut tersebut akan dihilangkan.

Tag: terminal_output

--[no]xml:line_numbers default: "true"

Jika benar (true), output XML berisi nomor baris. Menonaktifkan opsi ini dapat membuat perbedaan lebih mudah dibaca. Opsi ini hanya berlaku untuk --output=xml.

Tag: terminal_output

Opsi yang memengaruhi panjang respons, format, atau lokasi logging:
--[no]verbose_visibility_errors default: "false"

Jika diaktifkan, error visibilitas akan menyertakan informasi diagnostik tambahan.

Tag: build_file_semantics, non_configurable

Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
Penggunaan --flag_alias=<a 'name=value' flag alias> beberapa kali akan diakumulasikan

Menetapkan nama singkat untuk flag Starlark. Fungsi ini mengambil satu pasangan nilai kunci dalam bentuk {key}={value} sebagai argumen.

Tag: changes_inputs, non_configurable

Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
Penggunaan --deleted_packages=<comma-separated list of package names> beberapa kali akan diakumulasikan

Daftar nama paket yang dipisahkan koma yang akan dianggap tidak ada oleh sistem build, meskipun paket tersebut 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 menampilkan error jika menemukan label '//x:y/z' jika label tersebut masih disediakan oleh entri package_path lain. Menentukan --deleted_packages x/y akan menghindari masalah ini.

--[no]fetch default: "true"

Mengizinkan perintah untuk mengambil dependensi eksternal. Jika disetel ke salah (false), perintah akan menggunakan versi dependensi yang di-cache, dan jika tidak ada, perintah akan gagal.

--package_path=<colon-separated list of options> default: "%workspace%"

Daftar tempat untuk mencari paket yang dipisahkan dengan titik dua. Elemen yang diawali dengan '%workspace%' bersifat relatif terhadap ruang kerja yang melampirkannya. Jika tidak ada atau kosong, defaultnya adalah output 'bazel info default-package-path'.

--[no]show_loading_progress default: "true"

Jika diaktifkan, Bazel akan mencetak pesan "Loading package:".

Opsi Jalankan

Mewarisi semua opsi dari build.

Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--[no]portable_paths default: "false"

Jika benar, menyertakan jalur yang akan diganti dalam ExecRequest untuk membuat jalur yang dihasilkan dapat digunakan di tempat lain.

Tag: affects_outputs

--[no]run default: "true"

Jika salah (false), lewati menjalankan command line yang dibuat untuk target yang di-build. Perhatikan bahwa tanda ini diabaikan untuk semua build --script_path.

Tag: affects_outputs

Penggunaan --run_env=<a 'name[=value]' assignment with an optional value part or the special syntax '=name' to unset a variable> beberapa kali akan diakumulasikan

Menentukan kumpulan variabel lingkungan yang tersedia untuk target yang akan dijalankan. Variabel dapat ditentukan berdasarkan nama, yang dalam hal ini nilai akan diambil dari lingkungan pemanggilan, berdasarkan pasangan <code>name=value</code> yang menetapkan nilai secara independen dari lingkungan pemanggilan, atau berdasarkan <code>=name</code>, yang membatalkan setel variabel dengan nama tersebut. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru yang akan digunakan, opsi untuk variabel yang berbeda akan terakumulasi. Perhatikan bahwa target yang dieksekusi umumnya akan melihat lingkungan lengkap host, kecuali untuk variabel yang telah dibatalkan secara eksplisit.

Tag: affects_outputs

--[no]run_in_cwd default: "false"

Jika benar, menjalankan target di direktori kerja saat ini, bukan di hierarki runfile.

Tag: affects_outputs

Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, yang memengaruhi nilainya, bukan keberadaannya:
--script_path=<a path> default: lihat deskripsi

Jika disetel, tulis skrip shell ke file tertentu yang memanggil target. Jika opsi ini disetel, target tidak dijalankan dari bazel. Gunakan 'bazel run --script_path=foo //foo && ./foo' untuk memanggil target '//foo'. Perintah ini berbeda dengan 'bazel run //foo' karena kunci bazel dilepaskan dan file yang dapat dieksekusi terhubung ke stdin terminal.

Tag: affects_outputs, execution

Opsi yang memengaruhi panjang respons, format, atau lokasi logging:
--[no]omit_run_args default: "true"

Menentukan apakah argumen yang diteruskan ke target yang dapat dijalankan akan dihilangkan dari output karena alasan privasi. Jika disetel ke benar (true), output tidak akan berisi argumen yang diteruskan ke target. Jika disetel ke salah (false), output akan berisi argumen yang diteruskan ke target.

Tag: terminal_output

Opsi Penutupan

Opsi yang mengontrol output perintah:
--iff_heap_size_greater_than=<an integer> default: "0"

Jika bukan nol, server hanya akan dimatikan jika total memori (dalam MB) yang digunakan oleh JVM melebihi nilai ini.

Tag: loses_incremental_state, eagerness_to_exit

Opsi Pengujian

Mewarisi semua opsi dari build.

Opsi yang memengaruhi panjang respons, format, atau lokasi logging:
--[no]print_relative_test_log_paths default: "false"

Jika benar, saat mencetak jalur ke log pengujian, gunakan jalur relatif yang menggunakan link simbolis praktis 'testlogs'. Catatan - Pemanggilan 'build'/'test'/dll. berikutnya dengan konfigurasi yang berbeda dapat menyebabkan target symlink ini berubah, sehingga jalur yang dicetak sebelumnya tidak lagi berguna.

Tag: affects_outputs

--[no]test_verbose_timeout_warnings default: "false"

Jika benar (true), cetak peringatan tambahan saat waktu eksekusi pengujian sebenarnya tidak cocok dengan waktu tunggu yang ditentukan oleh pengujian (baik tersirat maupun eksplisit).

Tag: affects_outputs

--[no]verbose_test_summary default: "true"

Jika benar (true), cetak informasi tambahan (waktu, jumlah eksekusi yang gagal, dll.) dalam ringkasan pengujian.

Tag: affects_outputs

Opsi Vendor

Mewarisi semua opsi dari test.

Opsi yang mengontrol eksekusi build:
--[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

--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> default: "auto"

Jumlah thread paralel yang akan digunakan untuk fase pemuatan/analisis.Menggunakan bilangan bulat, atau kata kunci ("auto", "HOST_CPUS", "HOST_RAM"), yang 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.:
--[no]incompatible_config_setting_private_default_visibility default: "false"

Jika incompatible_enforce_config_setting_visibility=false, ini adalah no-op. Jika tidak, jika tanda ini salah (false), setiap config_setting tanpa atribut visibilitas eksplisit adalah //visibility:public. Jika tanda ini benar (true), 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 benar (true), terapkan batasan visibilitas config_setting. Jika salah (false), 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:
Penggunaan --repo=<a string> beberapa kali akan 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 lain-lain, yang tidak dikategorikan di tempat lain.:
Penggunaan --deleted_packages=<comma-separated list of package names> beberapa kali akan diakumulasikan

Daftar nama paket yang dipisahkan koma yang akan dianggap tidak ada oleh sistem build, meskipun paket tersebut 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 menampilkan error jika menemukan label '//x:y/z' jika label tersebut masih disediakan oleh entri package_path lain. Menentukan --deleted_packages x/y akan menghindari masalah ini.

--[no]fetch default: "true"

Mengizinkan perintah untuk mengambil dependensi eksternal. Jika disetel ke salah (false), perintah akan menggunakan versi dependensi yang di-cache, dan jika tidak ada, perintah akan gagal.

--package_path=<colon-separated list of options> default: "%workspace%"

Daftar tempat untuk mencari paket yang dipisahkan dengan titik dua. Elemen yang diawali dengan '%workspace%' bersifat relatif terhadap ruang kerja yang melampirkannya. Jika tidak ada atau kosong, defaultnya adalah output 'bazel info default-package-path'.

--[no]show_loading_progress default: "true"

Jika diaktifkan, Bazel akan mencetak pesan "Loading package:".

Opsi yang mengontrol eksekusi build:
--[no]experimental_persistent_aar_extractor default: "false"

Aktifkan pengekstrak aar persisten menggunakan pekerja.

Tag: execution, experimental

--[no]experimental_remotable_source_manifests default: "false"

Apakah tindakan manifes sumber dapat dilakukan dari jarak jauh

Tag: loading_and_analysis, execution, experimental

--[no]experimental_split_coverage_postprocessing default: "false"

Jika benar, Bazel akan menjalankan pemrosesan pasca-cakupan untuk pengujian di proses baru.

Tag: execution, experimental

--[no]experimental_strict_fileset_output default: "false"

Jika opsi ini diaktifkan, set file akan memperlakukan semua artefak output sebagai file biasa. File tidak akan melintasi direktori atau sensitif terhadap symlink.

Tag: execution, experimental

--[no]incompatible_modify_execution_info_additive default: "true"

Jika diaktifkan, meneruskan beberapa tanda --modify_execution_info bersifat aditif. Jika dinonaktifkan, hanya tanda terakhir yang akan dipertimbangkan.

Tag: execution, affects_outputs, loading_and_analysis, incompatible_change

Penggunaan --modify_execution_info=<regex=[+-]key,regex=[+-]key,...> beberapa kali akan diakumulasikan

Menambahkan atau menghapus kunci dari info eksekusi tindakan berdasarkan mnemonik tindakan. Hanya berlaku untuk tindakan yang mendukung info eksekusi. Banyak tindakan umum yang mendukung info eksekusi, misalnya Genrule, CppCompile, Javac, StarlarkAction, TestRunner. Saat menentukan beberapa nilai, urutan penting karena banyak ekspresi reguler dapat berlaku untuk mnemonik yang sama.

Sintaksis: regex=[+-]key,regex=[+-]key,....

Contoh:

  • .*=+x,.*=-y,.*=+z menambahkan x dan z ke, serta 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 persisten menggunakan pekerja.

Meluas 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 dengan menggunakan pekerja.

Meluas 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

Aktifkan tindakan desugar dan dex Android multiplex persisten menggunakan pekerja.

Meluas 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 yang di-multiplex secara persisten menggunakan pekerja.

Diluaskan 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

Aktifkan alat Android persisten dan yang di-multiplex (dexing, desugaring, pemrosesan resource).

Meluas menjadi:
  --internal_persistent_multiplex_busybox_tools
  --persistent_multiplex_android_resource_processor
  --persistent_multiplex_android_dex_desugar

Tag: host_machine_resource_optimizations, execution

--[no]use_target_platform_for_tests default: "false"

Jika benar (true), gunakan platform target untuk menjalankan pengujian, bukan grup eksekusi pengujian.

Tag: execution

Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
--android_compiler=<a string> default: lihat deskripsi

Compiler target Android.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state

--android_manifest_merger=<legacy, android or force_android> default: "android"

Memilih penggabung manifes yang akan digunakan untuk aturan android_binary. Flag untuk membantu transisi ke penggabung manifes Android dari penggabung lama.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state

--android_platforms=<a build target label> default: ""

Menetapkan platform yang digunakan oleh target android_binary. Jika beberapa platform ditentukan, maka biner adalah APK gemuk, yang berisi biner native untuk setiap platform target yang ditentukan.

Tag: changes_inputs, loading_and_analysis, loses_incremental_state

--cc_output_directory_tag=<a string> default: ""

Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.

Tag: affects_outputs

--compiler=<a string> default: lihat deskripsi

Compiler C++ yang akan digunakan untuk mengompilasi target.

Tag: loading_and_analysis, execution

--coverage_output_generator=<a build target label> default: "@bazel_tools//tools/test:lcov_merger"

Lokasi biner yang digunakan untuk memproses laporan cakupan mentah. Target ini harus berupa biner. Default-nya adalah @bazel_tools//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. Target ini harus berupa biner. Default-nya adalah @bazel_tools//tools/test:coverage_report_generator.

Tag: changes_inputs, affects_outputs, loading_and_analysis

--coverage_support=<a build target label> default: "@bazel_tools//tools/test:coverage_support"

Lokasi file dukungan yang diperlukan pada input setiap tindakan pengujian yang mengumpulkan cakupan kode. Default-nya adalah //tools/test:coverage_support.

Tag: changes_inputs, affects_outputs, loading_and_analysis

--custom_malloc=<a build target label> default: lihat deskripsi

Menentukan implementasi malloc kustom. Setelan ini menggantikan atribut malloc dalam aturan build.

Tag: changes_inputs, affects_outputs

--[no]experimental_include_xcode_execution_requirements default: "false"

Jika disetel, tambahkan persyaratan eksekusi "requires-xcode:{version}" ke setiap tindakan Xcode. Jika versi Xcode memiliki label bergaris hubung, tambahkan juga persyaratan eksekusi "requires-xcode-label:{version_label}".

Tag: loses_incremental_state, loading_and_analysis, execution, experimental

--[no]experimental_prefer_mutual_xcode default: "true"

Jika benar, gunakan Xcode terbaru yang tersedia secara lokal dan jarak jauh. Jika salah (false), atau jika tidak ada versi yang tersedia bersama, gunakan versi Xcode lokal yang dipilih melalui xcode-select.

Tag: loses_incremental_state, experimental

--extra_execution_platforms=<comma-separated list of options> default: ""

Platform yang tersedia sebagai platform eksekusi untuk menjalankan tindakan. Platform dapat ditentukan berdasarkan target yang tepat, atau sebagai pola target. Platform ini akan dipertimbangkan sebelum platform yang dideklarasikan dalam file WORKSPACE oleh register_execution_platforms(). Opsi ini hanya dapat ditetapkan satu kali; instance selanjutnya akan menggantikan setelan tanda sebelumnya.

Tag: execution

Penggunaan --extra_toolchains=<comma-separated list of options> beberapa kali akan diakumulasikan

Aturan toolchain yang akan dipertimbangkan selama penyelesaian toolchain. Rangkaian alat dapat ditentukan berdasarkan target yang persis, atau sebagai pola target. Rangkaian alat ini akan dipertimbangkan sebelum rangkaian alat yang dideklarasikan dalam file WORKSPACE oleh register_toolchains().

Tag: affects_outputs, changes_inputs, loading_and_analysis

--grte_top=<a label> default: lihat deskripsi

Label untuk library libc yang di-check in. Nilai default dipilih oleh toolchain crosstool, dan Anda hampir tidak perlu menggantinya.

Tag: action_command_lines, affects_outputs

--host_compiler=<a string> default: lihat deskripsi

Flag tanpa pengoperasian. Akan dihapus dalam rilis mendatang.

Tag: loading_and_analysis, execution

--host_grte_top=<a label> default: lihat deskripsi

Jika ditentukan, setelan ini akan menggantikan direktori tingkat teratas libc (--grte_top) untuk konfigurasi 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_bazel_test_exec_run_under default: "true"

Jika diaktifkan, bazel test --run_under=//:runner akan membuat //:runner dalam konfigurasi exec. Jika dinonaktifkan, //:runner akan dibuat dalam konfigurasi target. Bazel menjalankan pengujian di mesin eksekusi, sehingga yang pertama lebih tepat. Hal ini tidak memengaruhi bazel run, yang selalu membangun --run_under=//foo dalam konfigurasi target.

Tag: affects_outputs, incompatible_change

--[no]incompatible_builtin_objc_strip_action default: "true"

Apakah akan memancarkan tindakan penghapusan sebagai bagian dari penautan objc.

Tag: action_command_lines, incompatible_change

--[no]incompatible_dont_enable_host_nonhost_crosstool_features default: "true"

Jika benar (true), 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_apple_toolchain_resolution default: "false"

Menggunakan penyelesaian toolchain untuk memilih Apple SDK untuk aturan Apple (Starlark dan native)

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_strip_executable_safely default: "false"

Jika benar, tindakan penghapusan untuk file yang dapat dieksekusi akan menggunakan flag -x, yang tidak merusak resolusi simbol dinamis.

Tag: action_command_lines, incompatible_change

--[no]interface_shared_objects default: "true"

Gunakan objek bersama antarmuka jika didukung oleh toolchain. Semua toolchain ELF saat ini mendukung setelan ini.

Tag: loading_and_analysis, affects_outputs, affects_outputs

--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Menentukan versi iOS SDK yang akan digunakan untuk membangun aplikasi iOS. Jika tidak ditentukan, akan menggunakan versi iOS SDK default dari 'xcode_version'.

Tag: loses_incremental_state

--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Menentukan versi macOS SDK yang akan digunakan untuk membangun aplikasi macOS. Jika tidak ditentukan, akan menggunakan versi SDK macOS default dari 'xcode_version'.

Tag: loses_incremental_state

--minimum_os_version=<a string> default: lihat deskripsi

Versi OS minimum yang ditargetkan kompilasi Anda.

Tag: loading_and_analysis, affects_outputs

--platform_mappings=<a main workspace-relative path> default: ""

Lokasi file pemetaan yang menjelaskan platform mana yang akan digunakan jika tidak ada yang ditetapkan atau tanda mana yang akan ditetapkan jika platform sudah ada. Harus relatif terhadap root ruang kerja utama. Defaultnya adalah platform_mappings (file langsung di bawah root ruang kerja).

Tag: affects_outputs, changes_inputs, loading_and_analysis, non_configurable

--platforms=<a build target label> default: ""

Label aturan platform yang menjelaskan platform target untuk perintah saat ini.

Tag: affects_outputs, changes_inputs, loading_and_analysis

--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Menentukan versi tvOS SDK yang akan digunakan untuk membangun aplikasi tvOS. Jika tidak ditentukan, gunakan versi tvOS SDK default dari 'xcode_version'.

Tag: loses_incremental_state

--[no]use_platforms_in_apple_crosstool_transition default: "false"

Membuat apple_crosstool_transition kembali menggunakan nilai flag --platforms, bukan --cpu lama jika diperlukan.

Tag: loading_and_analysis

--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Menentukan versi watchOS SDK yang akan digunakan untuk membangun aplikasi watchOS. Jika tidak ditentukan, akan menggunakan versi SDK watchOS default dari 'xcode_version'.

Tag: loses_incremental_state

--xcode_version=<a string> default: lihat deskripsi

Jika ditentukan, gunakan Xcode versi tertentu untuk tindakan build yang relevan. Jika tidak ditentukan, akan menggunakan Xcode versi default executor.

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:
--[no]apple_generate_dsym default: "false"

Apakah akan membuat file simbol debug (.dSYM).

Tag: affects_outputs, action_command_lines

Jika benar, bangun hutan symlink runfile untuk semua target. Jika salah (false), tulis hanya jika diperlukan oleh perintah tindakan, pengujian, atau jalankan lokal.

Tag: affects_outputs

--[no]build_runfile_manifests default: "true"

Jika benar, tulis manifes file yang dapat dijalankan untuk semua target. Jika salah (false), hapus. Pengujian lokal akan gagal dijalankan jika salah (false).

Tag: affects_outputs

--[no]build_test_dwp default: "false"

Jika diaktifkan, saat membuat pengujian C++ secara statis dan dengan fission, file .dwp untuk biner pengujian juga akan dibuat secara otomatis.

Tag: loading_and_analysis, affects_outputs

--cc_proto_library_header_suffixes=<comma-separated set of options> default: ".pb.h"

Menetapkan sufiks 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

--[no]experimental_proto_descriptor_sets_include_source_info default: "false"

Menjalankan tindakan tambahan untuk versi API Java alternatif dalam proto_library.

Tag: affects_outputs, loading_and_analysis, experimental

--[no]experimental_save_feature_state default: "false"

Simpan status fitur yang diaktifkan dan diminta sebagai output kompilasi.

Tag: affects_outputs, experimental

--fission=<a set of compilation modes> default: "no"

Menentukan mode kompilasi mana yang menggunakan fusi 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 DefaultInfo.files dependensi data ke runfilenya, yang cocok dengan perilaku yang direkomendasikan untuk aturan Starlark (fitur runfiles yang harus dihindari).

Tag: affects_outputs, incompatible_change

--[no]incompatible_compact_repo_mapping_manifest default: "true"

Jika diaktifkan, file {binary}.repo_mapping memancarkan pemetaan repo ekstensi modul hanya sekali, bukan sekali untuk setiap repo yang dihasilkan oleh ekstensi yang berkontribusi pada runfile.

Tag: affects_outputs, incompatible_change

--incompatible_disable_select_on=<comma-separated set of options> default: ""

Daftar tanda yang penggunaannya di select() dinonaktifkan.

Tag: loading_and_analysis, incompatible_change, non_configurable

--[no]incompatible_filegroup_runfiles_for_data default: "true"

Jika benar (true), runfile target yang tercantum dalam atribut srcs tersedia untuk target yang menggunakan filegroup sebagai dependensi data.

Tag: incompatible_change

--[no]objc_generate_linkmap default: "false"

Menentukan apakah akan membuat file linkmap atau tidak.

Tag: affects_outputs

--[no]save_temps default: "false"

Jika disetel, output sementara dari gcc akan disimpan. File 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, yang memengaruhi nilainya, bukan keberadaannya:
Penggunaan --action_env=<a 'name[=value]' assignment with an optional value part or the special syntax '=name' to unset a variable> beberapa kali akan diakumulasikan

Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi target. Variabel dapat ditentukan oleh name, yang dalam hal ini nilai akan diambil dari lingkungan pemanggilan, oleh pasangan name=value yang menetapkan nilai secara independen dari lingkungan pemanggilan, atau oleh =name, yang membatalkan setel variabel dengan nama tersebut. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru yang akan digunakan, opsi untuk variabel yang berbeda akan terakumulasi.

Perhatikan bahwa kecuali --incompatible_repo_env_ignores_action_env benar (true), semua pasangan name=value akan tersedia untuk aturan repositori.

Tag: action_command_lines

--allowed_cpu_values=<comma-separated set of options> default: ""

Nilai yang diizinkan untuk flag --cpu.

Tag: changes_inputs, affects_outputs

--[no]android_databinding_use_androidx default: "true"

Buat file data binding yang kompatibel dengan AndroidX. Ini hanya digunakan dengan databinding v2. Flag ini adalah no-op.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state, experimental

--[no]android_databinding_use_v3_4_args default: "true"

Gunakan android databinding v2 dengan argumen 3.4.0. Flag ini adalah no-op.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state, experimental

--android_dynamic_mode=<off, default or fully> default: "nonaktif"

Menentukan apakah dependensi C++ 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. 'fully' berarti semua library akan ditautkan secara dinamis. 'off' berarti semua library akan ditautkan dalam mode sebagian besar statis.

Tag: affects_outputs, loading_and_analysis

--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency> default: "alphabetical"

Menetapkan urutan manifes yang diteruskan ke penggabung manifes untuk biner Android. ALPHABETICAL berarti manifes diurutkan berdasarkan jalur relatif terhadap execroot. ALPHABETICAL_BY_CONFIGURATION berarti manifes diurutkan berdasarkan jalur relatif ke direktori konfigurasi dalam direktori output. DEPENDENCY berarti manifes diurutkan dengan manifes setiap library yang mendahului manifes dependensinya.

Tag: action_command_lines, execution

--[no]android_resource_shrinking default: "false"

Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.

Tag: affects_outputs, loading_and_analysis

--[no]build_python_zip default: "auto"

Membangun zip yang dapat dieksekusi python; aktif di Windows, nonaktif di platform lain

Tag: affects_outputs

Penggunaan --catalyst_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membangun biner Apple Catalyst.

Tag: loses_incremental_state, loading_and_analysis

--[no]collect_code_coverage default: "false"

Jika ditentukan, Bazel akan menginstrumentasi 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 pembuatan biner. Nilai: fastbuild, dbg, opt.

Tag: affects_outputs, action_command_lines

Penggunaan --conlyopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber C.

Tag: action_command_lines, affects_outputs

Penggunaan --copt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke gcc.

Tag: action_command_lines, affects_outputs

--cpu=<a string> default: ""

Tidak digunakan lagi: tanda ini tidak digunakan secara internal oleh Blaze meskipun ada pemetaan platform lama untuk memungkinkan kompatibilitas mundur. Jangan gunakan flag ini, tetapi gunakan --platforms dengan definisi platform yang sesuai.

Tag: changes_inputs, affects_outputs

--cs_fdo_absolute_path=<a string> default: lihat deskripsi

Menggunakan informasi profil CSFDO untuk mengoptimalkan kompilasi. Tentukan nama jalur absolut file zip yang berisi file profil, file profil LLVM mentah atau terindeks.

Tag: affects_outputs

--cs_fdo_instrument=<a string> default: lihat deskripsi

Buat biner dengan instrumentasi FDO yang sensitif terhadap konteks. Dengan compiler Clang/LLVM, opsi ini juga menerima nama direktori tempat file profil mentah akan di-dump saat runtime.

Tag: affects_outputs

--cs_fdo_profile=<a build target label> default: lihat deskripsi

cs_fdo_profile yang merepresentasikan profil sensitif konteks yang akan digunakan untuk pengoptimalan.

Tag: affects_outputs

Penggunaan --cxxopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber C++.

Tag: action_command_lines, affects_outputs

Penggunaan --define=<a 'name=value' assignment> beberapa kali akan diakumulasikan

Setiap opsi --define menentukan penetapan untuk variabel build. Jika ada beberapa nilai untuk variabel, nilai terakhir yang akan digunakan.

Tag: changes_inputs, affects_outputs

--dynamic_mode=<off, default or fully> default: "default"

Menentukan apakah biner C++ akan ditautkan secara dinamis. 'default' berarti Bazel akan memilih apakah akan menautkan secara dinamis. 'fully' berarti semua library akan ditautkan secara dinamis. 'off' berarti semua library akan ditautkan dalam mode sebagian besar statis.

Tag: loading_and_analysis, affects_outputs

--[no]enable_propeller_optimize_absolute_paths default: "true"

Jika disetel, penggunaan jalur absolut untuk pengoptimalan baling-baling akan memunculkan error.

Tag: affects_outputs

--[no]enable_remaining_fdo_absolute_paths default: "true"

Jika disetel, penggunaan jalur absolut untuk FDO akan memunculkan error.

Tag: affects_outputs

--[no]enable_runfiles default: "auto"

Aktifkan hierarki symlink runfile; Secara default, opsi ini nonaktif di Windows, dan aktif di platform lain.

Tag: affects_outputs

Penggunaan --exec_aspects=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar aspek yang dipisahkan koma untuk diterapkan ke target yang dikonfigurasi exec, terlepas dari apakah target tersebut adalah target tingkat teratas atau bukan. Fitur ini bersifat eksperimental dan dapat berubah.

Tag: loading_and_analysis

Penggunaan --experimental_action_listener=<a build target label> beberapa kali akan diakumulasikan

Tidak digunakan lagi dan digantikan dengan aspek. Gunakan action_listener untuk melampirkan extra_action ke tindakan build yang ada.

Tag: execution, experimental

--[no]experimental_android_compress_java_resources default: "false"

Mengompresi resource Java di APK

Tag: affects_outputs, loading_and_analysis, experimental

--[no]experimental_android_databinding_v2 default: "true"

Gunakan android databinding v2. Flag ini adalah no-op.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state, experimental

--[no]experimental_android_resource_shrinking default: "false"

Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.

Tag: affects_outputs, loading_and_analysis, experimental

--[no]experimental_android_rewrite_dexes_with_rex default: "false"

menggunakan alat rex untuk menulis ulang file dex

Tag: affects_outputs, loading_and_analysis, loses_incremental_state, experimental

--[no]experimental_collect_code_coverage_for_generated_files default: "false"

Jika ditentukan, Bazel juga akan membuat informasi cakupan pengumpulan untuk file yang dihasilkan.

Tag: affects_outputs, experimental

--experimental_objc_fastbuild_options=<comma-separated list of options> default: "-O0,-DDEBUG=1"

Menggunakan string ini sebagai opsi compiler fastbuild objc.

Tag: action_command_lines

--[no]experimental_omitfp default: "false"

Jika benar, gunakan libunwind untuk pelepasan stack, dan kompilasi dengan -fomit-frame-pointer dan -fasynchronous-unwind-tables.

Tag: action_command_lines, affects_outputs, experimental

--experimental_output_paths=<off or strip> default: "nonaktif"

Model mana yang akan digunakan untuk tempat aturan menulis outputnya di pohon output, terutama untuk build multi-platform / multi-konfigurasi. Fitur ini sangat eksperimental. Lihat GH-6526 untuk mengetahui detailnya. Tindakan Starlark dapat memilih untuk menggunakan pemetaan jalur dengan menambahkan kunci supports-path-mapping ke dict execution_requirements.

Tag: loses_incremental_state, bazel_internal_configuration, affects_outputs, execution

Penggunaan --experimental_override_platform_cpu_name=<a 'label=value' assignment> beberapa kali akan diakumulasikan

Setiap entri harus dalam bentuk label=value dengan label mengacu pada platform dan nilai adalah nama singkat yang diinginkan untuk menggantikan nama CPU platform di $(TARGET_CPU) variabel make dan jalur output. Hanya digunakan jika --experimental_platform_in_output_dir, --incompatible_target_cpu_from_platform, atau --incompatible_bep_cpu_from_platform benar. Memiliki prioritas penamaan tertinggi.

Tag: affects_outputs, experimental

--[no]experimental_platform_in_output_dir default: "Otomatis"

Jika benar (true), nama singkat untuk platform target akan digunakan dalam nama direktori output, bukan CPU. Skema yang tepat bersifat eksperimental dan dapat berubah:

  1. Pertama, jika opsi --platforms tidak memiliki tepat satu nilai, hash opsi platform akan digunakan.
  2. Selanjutnya, jika ada nama pendek untuk platform saat ini yang didaftarkan oleh --experimental_override_name_platform_in_output_dir, nama pendek tersebut akan digunakan.
  3. Kemudian, jika --experimental_use_platforms_in_output_dir_legacy_heuristic disetel, gunakan nama pendek berdasarkan Label platform saat ini.
  4. Terakhir, hash opsi platform digunakan sebagai upaya terakhir.

Tag: affects_outputs, experimental

--[no]experimental_use_llvm_covmap default: "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"

Gunakan tanda ini hanya sebagai bagian dari strategi pengujian atau migrasi yang disarankan. Perhatikan bahwa heuristik memiliki kekurangan yang diketahui dan disarankan untuk bermigrasi agar hanya mengandalkan --experimental_override_name_platform_in_output_dir.

Tag: affects_outputs, experimental

--fdo_instrument=<a string> default: lihat deskripsi

Buat biner dengan instrumentasi FDO. Dengan compiler Clang/LLVM, opsi ini juga menerima nama direktori tempat file profil mentah akan di-dump saat runtime.

Tag: affects_outputs

--fdo_optimize=<a string> default: lihat deskripsi

Gunakan informasi profil FDO untuk mengoptimalkan kompilasi. Tentukan nama file zip yang berisi struktur 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 direktif exports_files ke paket yang sesuai) dan label yang mengarah ke target fdo_profile. Flag ini akan digantikan oleh aturan fdo_profile.

Tag: affects_outputs

--fdo_prefetch_hints=<a build target label> default: lihat deskripsi

Gunakan petunjuk pengambilan data cache.

Tag: affects_outputs

--fdo_profile=<a build target label> default: lihat deskripsi

fdo_profile yang merepresentasikan profil yang akan digunakan untuk pengoptimalan.

Tag: affects_outputs

Penggunaan --features=<a string> beberapa kali akan diakumulasikan

Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi target. Menentukan -{feature} akan menonaktifkan fitur ini. Fitur negatif selalu menggantikan fitur positif. Lihat juga --host_features.

Tag: changes_inputs, affects_outputs

--[no]force_pic default: "false"

Jika diaktifkan, semua kompilasi C++ akan menghasilkan kode yang independen dari posisi ("-fPIC"), link lebih memilih library bawaan PIC daripada library non-PIC, dan link menghasilkan file yang dapat dieksekusi yang independen dari posisi ("-pie").

Tag: loading_and_analysis, affects_outputs

Penggunaan --host_action_env=<a 'name[=value]' assignment with an optional value part or the special syntax '=name' to unset a variable> beberapa kali akan diakumulasikan

Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi eksekusi. Variabel dapat ditentukan oleh name, yang dalam hal ini nilai akan diambil dari lingkungan pemanggilan, oleh pasangan name=value yang menetapkan nilai secara independen dari lingkungan pemanggilan, atau oleh =name, yang membatalkan setel variabel dengan nama tersebut. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru yang akan digunakan, opsi untuk variabel yang berbeda akan terakumulasi.

Tag: action_command_lines

--host_compilation_mode=<fastbuild, dbg or opt> default: "opt"

Tentukan mode alat yang digunakan selama build akan dibuat. Nilai: fastbuild, dbg, opt.

Tag: affects_outputs, action_command_lines

Penggunaan --host_conlyopt=<a string> beberapa kali akan 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

Penggunaan --host_copt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke compiler C untuk alat yang dibuat dalam konfigurasi exec.

Tag: action_command_lines, affects_outputs

--host_cpu=<a string> default: ""

CPU host.

Tag: changes_inputs, affects_outputs

Penggunaan --host_cxxopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke compiler C++ untuk alat yang dibuat dalam konfigurasi exec.

Tag: action_command_lines, affects_outputs

Penggunaan --host_features=<a string> beberapa kali akan diakumulasikan

Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi exec. Menentukan -{feature} akan menonaktifkan fitur ini. Fitur negatif selalu menggantikan fitur positif.

Tag: changes_inputs, affects_outputs

Penggunaan --host_linkopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke linker saat menautkan alat dalam konfigurasi exec.

Tag: action_command_lines, affects_outputs

--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi macOS yang kompatibel minimum untuk target host. Jika tidak ditentukan, gunakan 'macos_sdk_version'.

Tag: loses_incremental_state

Penggunaan --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 kali akan diakumulasikan

Opsi tambahan untuk meneruskan 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 untuk disertakan dan dikecualikan (Lihat juga --instrumentation_filter). option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip 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 semua file cc di //foo/ kecuali bar.cc.

Tag: action_command_lines, affects_outputs

--[no]incompatible_auto_exec_groups default: "false"

Jika diaktifkan, grup exec akan otomatis dibuat untuk setiap toolchain yang digunakan oleh aturan. Agar aturan ini berfungsi, aturan perlu menentukan parameter toolchain pada tindakannya. Untuk mengetahui informasi selengkapnya, lihat GH-17134.

Tag: affects_outputs, incompatible_change

--[no]incompatible_merge_genfiles_directory default: "true"

Jika benar, direktori genfiles akan dilipat ke dalam direktori bin.

Tag: affects_outputs, incompatible_change

--[no]incompatible_target_cpu_from_platform default: "true"

Jika ditentukan, nilai batasan CPU (@platforms//cpu:cpu) dari platform target digunakan untuk menetapkan variabel make $(TARGET_CPU).

Tag: loading_and_analysis, incompatible_change

--[no]instrument_test_targets default: "false"

Jika cakupan diaktifkan, tentukan apakah akan mempertimbangkan aturan pengujian instrumentasi. Jika disetel, aturan pengujian yang disertakan oleh --instrumentation_filter akan diinstrumen. Jika tidak, aturan pengujian akan 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 regex 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

--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi iOS yang kompatibel minimum untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'ios_sdk_version'.

Tag: loses_incremental_state

Penggunaan --ios_multi_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membangun 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 diaktifkan, 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

Penggunaan --linkopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke gcc saat menautkan.

Tag: action_command_lines, affects_outputs

Penggunaan --ltobackendopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke langkah backend LTO (di bagian --features=thin_lto).

Tag: action_command_lines, affects_outputs

Penggunaan --ltoindexopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke langkah pengindeksan LTO (di bagian --features=thin_lto).

Tag: action_command_lines, affects_outputs

Penggunaan --macos_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membangun biner Apple macOS.

Tag: loses_incremental_state, loading_and_analysis

--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi macOS yang kompatibel minimum untuk target. Jika tidak ditentukan, gunakan 'macos_sdk_version'.

Tag: loses_incremental_state

--memprof_profile=<a build target label> default: lihat deskripsi

Gunakan profil memprof.

Tag: affects_outputs

--[no]objc_debug_with_GLIBCXX default: "false"

Jika ditetapkan, dan mode kompilasi ditetapkan ke 'dbg', tentukan GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC, dan GLIBCPP_CONCEPT_CHECKS.

Tag: action_command_lines

--[no]objc_enable_binary_stripping default: "false"

Apakah akan melakukan penghapusan simbol dan kode tidak terpakai pada biner yang ditautkan. Pelepasan biner akan dilakukan jika tanda ini dan --compilation_mode=opt ditentukan.

Tag: action_command_lines

Penggunaan --objccopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber Objective-C/C++.

Tag: action_command_lines

Penggunaan --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 kali akan diakumulasikan

Opsi tambahan untuk meneruskan 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 untuk disertakan dan dikecualikan (Lihat juga --instrumentation_filter). option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip 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 semua file cc di //foo/ kecuali bar.cc.

Tag: action_command_lines, affects_outputs

Penggunaan --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 kali akan diakumulasikan

Opsi tambahan untuk meneruskan secara selektif ke backend LTO (di bawah --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 untuk menyertakan dan mengecualikan. option_1 hingga option_n adalah opsi command line arbitrer. Jika opsi berisi koma, opsi tersebut harus dikutip 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

--platform_suffix=<a string> default: lihat deskripsi

Menentukan akhiran yang akan ditambahkan ke direktori konfigurasi.

Tag: loses_incremental_state, affects_outputs, loading_and_analysis

--propeller_optimize=<a build target label> default: lihat deskripsi

Gunakan informasi profil Propeller untuk mengoptimalkan target build.Profil Propeller harus terdiri dari setidaknya salah satu dari dua file, yaitu profil cc dan profil ld. Flag ini menerima label build yang harus merujuk ke 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",)Direktif exports_files mungkin harus ditambahkan ke paket yang sesuai agar file ini dapat dilihat oleh Bazel. Opsi harus digunakan sebagai: --propeller_optimize=//a/b:propeller_profile

Tag: action_command_lines, affects_outputs

--propeller_optimize_absolute_cc_profile=<a string> default: lihat deskripsi

Nama jalur absolut file cc_profile untuk build yang Dioptimalkan Propeller.

Tag: affects_outputs

--propeller_optimize_absolute_ld_profile=<a string> default: lihat deskripsi

Nama jalur absolut file ld_profile untuk build yang Dioptimalkan Propeller.

Tag: affects_outputs

--run_under=<a prefix in front of command> default: lihat deskripsi

Awalan yang akan disisipkan sebelum file yang dapat dieksekusi untuk perintah test dan run. Jika nilainya foo -bar, dan command line eksekusinya adalah test_binary -baz, maka command line terakhirnya adalah foo -bar test_binary -baz. Ini juga dapat berupa label untuk target yang dapat dieksekusi. Contohnya antara lain:

  • valgrind
  • strace
  • strace -c
  • valgrind --quiet --num-callers=20
  • //package:target
  • //package:target --options

Tag: action_command_lines

--[no]share_native_deps default: "true"

Jika benar, library native yang berisi fungsi identik akan dibagikan di antara target yang berbeda

Tag: loading_and_analysis, affects_outputs

--[no]stamp default: "false"

Membubuhi stempel biner dengan tanggal, nama pengguna, nama host, informasi ruang kerja, dll.

Tag: affects_outputs

Default --strip=<always, sometimes or never>: "sometimes" (kadang-kadang)

Menentukan apakah akan menghapus biner dan library bersama (menggunakan "-Wl,--strip-debug"). Nilai default 'sometimes' berarti hapus jika --compilation_mode=fastbuild.

Tag: affects_outputs

Penggunaan --stripopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke strip saat membuat biner '<name>.stripped'.

Tag: action_command_lines, affects_outputs

Penggunaan --tvos_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membuat biner Apple tvOS.

Tag: loses_incremental_state, loading_and_analysis

--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi tvOS kompatibel minimum untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'tvos_sdk_version'.

Tag: loses_incremental_state

Penggunaan --visionos_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membuat biner Apple visionOS.

Tag: loses_incremental_state, loading_and_analysis

Penggunaan --watchos_cpus=<comma-separated list of options> beberapa kali akan diakumulasikan

Daftar arsitektur yang dipisahkan koma untuk membangun biner Apple watchOS.

Tag: loses_incremental_state, loading_and_analysis

--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi watchOS yang kompatibel minimum untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'watchos_sdk_version'.

Tag: loses_incremental_state

--xbinary_fdo=<a build target label> default: lihat deskripsi

Gunakan informasi profil XbinaryFDO untuk mengoptimalkan kompilasi. Tentukan nama profil biner silang default. Jika opsi ini 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.):
--[no]check_visibility default: "true"

Jika dinonaktifkan, error visibilitas dalam dependensi target akan diturunkan menjadi peringatan.

Tag: build_file_semantics, non_configurable

--[no]desugar_for_android default: "true"

Apakah akan melakukan desugar bytecode Java 8 sebelum dexing.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state

--[no]desugar_java8_libs default: "false"

Apakah akan menyertakan library Java 8 yang didukung dalam aplikasi untuk perangkat lama.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state, experimental

--[no]enforce_constraints default: "true"

Memeriksa lingkungan yang kompatibel dengan setiap target dan melaporkan error jika ada target yang memiliki dependensi yang tidak mendukung lingkungan yang sama

Tag: build_file_semantics

--[no]experimental_check_desugar_deps default: "true"

Apakah akan memeriksa kembali desugaring yang benar pada tingkat biner Android.

Tag: eagerness_to_exit, loading_and_analysis, experimental

--[no]experimental_enforce_transitive_visibility default: "false"

Jika benar (true), aktifkan package()s untuk menyetel atribut transitive_visibility guna membatasi paket mana yang dapat bergantung padanya.

Tag: build_file_semantics, experimental

--experimental_one_version_enforcement=<off, warning or error> default: "OFF"

Jika diaktifkan, memastikan bahwa aturan java_binary tidak boleh berisi lebih dari satu versi file class yang sama di classpath. Penerapan ini dapat merusak build, atau hanya menghasilkan peringatan.

Tag: loading_and_analysis

--experimental_strict_java_deps=<off, warn, error, strict or default> default: "default"

Jika benar, periksa apakah target Java secara eksplisit mendeklarasikan semua target yang digunakan secara langsung sebagai dependensi.

Tag: build_file_semantics, eagerness_to_exit

--[no]incompatible_check_testonly_for_output_files default: "false"

Jika diaktifkan, periksa testonly untuk target prasyarat yang merupakan file output dengan mencari testonly dari aturan pembuatan. Tindakan ini cocok dengan pemeriksaan visibilitas.

Tag: build_file_semantics, incompatible_change

--[no]incompatible_disable_native_android_rules default: "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

--[no]incompatible_disable_native_apple_binary_rule default: "false"

No-op. Dipertahankan di sini untuk kompatibilitas mundur.

Tag: eagerness_to_exit, incompatible_change

--[no]one_version_enforcement_on_java_tests default: "true"

Jika diaktifkan, dan dengan experimental_one_version_enforcement ditetapkan ke nilai selain NONE, terapkan satu versi pada target java_test. Flag ini dapat dinonaktifkan untuk meningkatkan performa pengujian inkremental dengan mengorbankan potensi pelanggaran satu versi yang terlewat.

Tag: loading_and_analysis

--python_native_rules_allowlist=<a build target label> default: lihat deskripsi

Daftar yang diizinkan (target package_group) untuk digunakan saat menerapkan --incompatible_python_disallow_native_rules.

Tag: loading_and_analysis

--[no]strict_filesets default: "false"

Jika opsi ini diaktifkan, set file yang melintasi batas paket akan dilaporkan sebagai error.

Tag: build_file_semantics, eagerness_to_exit

--strict_proto_deps=<off, warn, error, strict or default> default: "error"

Kecuali jika OFF, 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

--strict_public_imports=<off, warn, error, strict or default> default: "nonaktif"

Kecuali OFF, memeriksa apakah target proto_library secara eksplisit mendeklarasikan semua target yang digunakan dalam 'import public' sebagai diekspor.

Tag: build_file_semantics, eagerness_to_exit, incompatible_change

--[no]strict_system_includes default: "false"

Jika benar, header yang ditemukan melalui jalur sertakan sistem (-isystem) juga harus dideklarasikan.

Tag: loading_and_analysis, eagerness_to_exit

Penggunaan --target_environment=<a build target label> beberapa kali akan diakumulasikan

Mendeklarasikan lingkungan target build ini. Harus berupa referensi label ke aturan environment. Jika ditentukan, semua target tingkat teratas harus kompatibel dengan lingkungan ini.

Lihat juga --platforms.

Tag: changes_inputs

Opsi yang memengaruhi output penandatanganan build:
--apk_signing_method=<v1, v2, v1_v2 or v4> default: "v1_v2"

Implementasi yang akan digunakan untuk menandatangani APK

Tag: action_command_lines, affects_outputs, loading_and_analysis

--[no]device_debug_entitlements default: "true"

Jika disetel, dan mode kompilasi bukan 'opt', aplikasi objc akan menyertakan hak debug saat menandatangani.

Tag: changes_inputs

--ios_signing_cert_name=<a string> default: lihat deskripsi

Nama sertifikat yang akan digunakan untuk penandatanganan iOS. Jika tidak disetel, akan kembali ke profil penyediaan. Dapat berupa preferensi identitas keychain sertifikat atau (substring) 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.:
--[no]incompatible_disallow_sdk_frameworks_attributes default: "false"

Jika benar, atribut sdk_frameworks dan weak_sdk_frameworks tidak diizinkan dalam objc_library dan objc_import.

Tag: build_file_semantics, incompatible_change

Jika benar, jadikan nilai default benar untuk atribut alwayslink di objc_library dan objc_import.

Tag: build_file_semantics, incompatible_change

--[no]incompatible_python_disallow_native_rules default: "false"

Jika benar (true), terjadi error saat menggunakan aturan py_* bawaan; sebagai gantinya, aturan rule_python harus digunakan. Lihat https://github.com/bazelbuild/bazel/issues/17773 untuk mengetahui informasi dan petunjuk migrasi selengkapnya.

Tag: loading_and_analysis, incompatible_change

Opsi yang mengatur perilaku lingkungan pengujian atau pelaksana pengujian:
--[no]allow_analysis_failures default: "false"

Jika benar (true), kegagalan analisis target aturan akan menyebabkan propagasi target instance AnalysisFailureInfo yang berisi deskripsi error, bukan menyebabkan kegagalan build.

Tag: loading_and_analysis, experimental

--analysis_testing_deps_limit=<an integer> default: "2000"

Menetapkan jumlah maksimum dependensi transitif melalui atribut aturan dengan transisi konfigurasi for_analysis_testing. Melebihi batas ini akan menyebabkan error aturan.

Tag: loading_and_analysis

--[no]break_build_on_parallel_dex2oat_failure default: "false"

Jika benar, kegagalan tindakan dex2oat akan menyebabkan build rusak, bukan menjalankan dex2oat selama runtime pengujian.

Tag: loading_and_analysis, experimental

Penggunaan --default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g memory=10,30,60,100> beberapa kali akan diakumulasikan

Ganti jumlah resource default untuk pengujian. Format yang diharapkan adalah {resource}={value}. Jika satu angka positif ditentukan sebagai {value}, angka tersebut akan menggantikan resource default untuk semua ukuran pengujian. Jika 4 angka yang dipisahkan koma ditentukan, angka tersebut akan menggantikan jumlah resource untuk ukuran pengujian small, medium, large, enormous. Nilai juga dapat berupa HOST_RAM/HOST_CPU, yang secara opsional diikuti oleh [-|*]{float} (mis. memory=HOST_RAM*.1,HOST_RAM*.2,HOST_RAM*.3,HOST_RAM*.4). Resource pengujian default yang ditentukan oleh tanda ini digantikan oleh resource eksplisit yang ditentukan dalam tag.

--[no]experimental_android_use_parallel_dex2oat default: "false"

Gunakan dex2oat secara paralel untuk mempercepat android_test.

Tag: loading_and_analysis, host_machine_resource_optimizations, experimental

--[no]ios_memleaks default: "false"

Mengaktifkan pemeriksaan kebocoran memori di target ios_test.

Tag: action_command_lines

--ios_simulator_device=<a string> default: lihat deskripsi

Perangkat yang akan disimulasikan saat menjalankan aplikasi iOS di simulator, misalnya 'iPhone 6'. Anda bisa mendapatkan daftar perangkat dengan menjalankan 'xcrun simctl list devicetypes' di komputer tempat simulator akan dijalankan.

Tag: test_runner

--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> default: lihat deskripsi

Versi iOS yang akan dijalankan di simulator saat menjalankan atau menguji. Setelan ini diabaikan untuk aturan ios_test jika perangkat target ditentukan dalam aturan.

Tag: test_runner

Penggunaan --runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once> beberapa kali akan diakumulasikan

Menentukan jumlah waktu untuk menjalankan setiap pengujian. Jika salah satu upaya tersebut gagal karena alasan apa pun, seluruh pengujian dianggap gagal. Biasanya, nilai yang ditentukan hanyalah bilangan bulat.

Contoh: --runs_per_test=3 akan menjalankan semua pengujian sebanyak 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 sertakan dan kecualikan (Lihat juga --instrumentation_filter).

Contoh: --runs_per_test=//foo/.*,-//foo/bar/.*@3 menjalankan semua pengujian di //foo/ kecuali pengujian di //foo/bar sebanyak tiga kali. Opsi ini dapat diteruskan beberapa kali. Argumen yang paling baru diteruskan yang cocok akan diutamakan. Jika tidak ada yang cocok, pengujian hanya dijalankan satu kali.

Penggunaan --test_env=<a 'name[=value]' assignment with an optional value part or the special syntax '=name' to unset a variable> beberapa kali akan diakumulasikan

Menentukan variabel lingkungan tambahan yang akan dimasukkan ke dalam lingkungan pelaksana pengujian. Variabel dapat ditentukan oleh name, yang dalam hal ini nilainya akan dibaca dari lingkungan klien Bazel, atau oleh pasangan name=value. Variabel yang ditetapkan sebelumnya dapat dibatalkan melalui =name. Opsi ini dapat digunakan beberapa kali untuk menentukan beberapa variabel. Hanya digunakan oleh perintah 'bazel test'.

Tag: test_runner

--test_timeout=<a single integer or comma-separated list of 4 integers> default: "-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 short, moderate, long, dan eternal (dalam urutan tersebut). Dalam bentuk apa pun, nilai -1 memberi tahu Blaze untuk menggunakan waktu tunggu defaultnya untuk kategori tersebut.

--[no]zip_undeclared_test_outputs default: "false"

Jika benar, output pengujian yang tidak dideklarasikan akan diarsipkan dalam file zip.

Tag: test_runner

Opsi yang memicu pengoptimalan waktu build:
--[no]cc_dotd_files default: "true"

Apakah akan membuat dan menganalisis file .d.

Tag: loading_and_analysis, execution, changes_inputs

--[no]cc_include_scanning default: "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 pohon input kompilasi. Namun, hal ini juga dapat merusak build karena pemindai include tidak sepenuhnya menerapkan semantik praprosesor C. Khususnya, alat ini tidak memahami direktif #include dinamis dan mengabaikan logika bersyarat praprosesor. Gunakan dengan menanggung sendiri risikonya. Setiap masalah terkait tanda ini yang diajukan akan ditutup. Di Google, build Anda kemungkinan besar akan gagal tanpa tanda ini.

Tag: loading_and_analysis, execution, changes_inputs, experimental

--[no]experimental_filter_library_jar_with_program_jar default: "false"

Memfilter ProgramJar ProGuard untuk menghapus class yang juga ada di LibraryJar.

Tag: action_command_lines, experimental

--[no]experimental_inmemory_dotd_files default: "true"

Jika diaktifkan, file .d C++ akan diteruskan dalam memori langsung dari node build jarak jauh, bukan ditulis ke disk.

Tag: loading_and_analysis, execution, affects_outputs, experimental

--[no]experimental_inmemory_jdeps_files default: "true"

Jika diaktifkan, file dependensi (.jdeps) yang dihasilkan dari kompilasi Java akan diteruskan dalam memori langsung dari node build jarak jauh, bukan ditulis ke disk.

Tag: loading_and_analysis, execution, affects_outputs, experimental

--[no]experimental_retain_test_configuration_across_testonly default: "false"

Jika diaktifkan, --trim_test_configuration tidak akan memangkas konfigurasi pengujian untuk aturan yang ditandai dengan testonly=1. Tindakan ini dimaksudkan untuk mengurangi masalah konflik tindakan saat aturan non-pengujian bergantung pada aturan cc_test. Tidak berpengaruh jika --trim_test_configuration adalah false.

Tag: loading_and_analysis, loses_incremental_state, experimental

--[no]experimental_unsupported_and_brittle_include_scanning default: "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 pohon input kompilasi. Namun, hal ini juga dapat merusak build karena pemindai include tidak sepenuhnya menerapkan semantik praprosesor C. Khususnya, alat ini tidak memahami direktif #include dinamis dan mengabaikan logika bersyarat praprosesor. Gunakan dengan menanggung sendiri risikonya. Setiap masalah terkait tanda ini yang diajukan akan ditutup. Di Google, build Anda kemungkinan besar akan gagal tanpa tanda ini.

Tag: loading_and_analysis, execution, changes_inputs, experimental

--[no]incremental_dexing default: "true"

Melakukan sebagian besar pekerjaan dexing secara terpisah untuk setiap file Jar.

Tag: affects_outputs, loading_and_analysis, loses_incremental_state

--[no]objc_use_dotd_pruning default: "true"

Jika disetel, file .d yang dikeluarkan oleh clang akan digunakan untuk memangkas set input yang diteruskan ke kompilasi objc.

Tag: changes_inputs, loading_and_analysis

--[no]process_headers_in_dependencies default: "false"

Saat membuat target //a:a, proses header di semua target yang bergantung pada //a:a (jika pemrosesan header diaktifkan untuk toolchain).

Tag: execution

--[no]trim_test_configuration default: "true"

Jika diaktifkan, opsi terkait pengujian akan dihapus di bawah tingkat 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 respons, format, atau lokasi logging:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> default: "-.*"

Mencetak informasi debug selama penyelesaian toolchain. Flag ini menggunakan regex, 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 penyelesaian toolchain.

Tag: terminal_output

--[no]verbose_visibility_errors default: "false"

Jika diaktifkan, error visibilitas akan menyertakan informasi diagnostik tambahan.

Tag: build_file_semantics, non_configurable

Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
Penggunaan --flag_alias=<a 'name=value' flag alias> beberapa kali akan diakumulasikan

Menetapkan nama singkat untuk tanda Starlark. Fungsi ini mengambil satu pasangan nilai kunci dalam bentuk {key}={value} sebagai argumen.

Tag: changes_inputs, non_configurable

--[no]incompatible_default_to_explicit_init_py default: "false"

Flag ini mengubah perilaku default sehingga file init.py tidak lagi dibuat secara otomatis di runfile target Python. Secara tepatnya, saat target py_binary atau py_test memiliki legacy_create_init yang disetel ke "auto" (default), target tersebut akan dianggap salah (false) jika dan hanya jika tanda ini disetel. Lihat https://github.com/bazelbuild/bazel/issues/10076.

Tag: affects_outputs, incompatible_change

Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
--[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 external,
  3. Beberapa uji coba diminta dengan --runs_per_test, atau
  4. Pengujian sebelumnya gagal. Jika ditetapkan ke yes, Bazel akan menyimpan dalam cache semua hasil pengujian kecuali pengujian yang ditandai sebagai external. Jika disetel ke no, Bazel tidak menyimpan hasil pengujian dalam cache.
Default --[no]experimental_cancel_concurrent_tests: "never" (tidak pernah)

Jika on_failed atau on_passed, Blaze akan membatalkan pengujian yang berjalan secara serentak pada pengujian pertama yang berhasil dengan hasil tersebut. Ini hanya berguna jika digunakan bersama --runs_per_test_detects_flakes.

Tag: affects_outputs, loading_and_analysis, experimental

--[no]experimental_fetch_all_coverage_outputs default: "false"

Jika benar (true), Bazel akan mengambil seluruh direktori data cakupan untuk setiap pengujian selama cakupan berjalan.

Tag: affects_outputs, loading_and_analysis, experimental

--[no]experimental_generate_llvm_lcov default: "false"

Jika benar (true), cakupan untuk clang akan menghasilkan laporan LCOV.

Tag: affects_outputs, loading_and_analysis, experimental

--experimental_java_classpath=<off, javabuilder, bazel or bazel_no_fallback> default: "bazel"

Mengaktifkan classpath yang dikurangi untuk kompilasi Java.

--[no]experimental_run_android_lint_on_java_rules default: "false"

Apakah akan memvalidasi sumber java_*.

Tag: affects_outputs, experimental

--[no]explicit_java_test_deps default: "false"

Menentukan dependensi ke JUnit atau Hamcrest secara eksplisit di java_test, bukan secara tidak sengaja diperoleh dari deps TestRunner. Saat ini hanya berfungsi untuk bazel.

--host_java_launcher=<a build target label> default: lihat deskripsi

Peluncur Java yang digunakan oleh alat yang dijalankan selama build.

Penggunaan --host_javacopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke javac saat membangun alat yang dieksekusi selama build.

Penggunaan --host_jvmopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke VM Java saat membuat 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 peluncur pengujian tidak menunjukkan bahwa peluncur tersebut mendukung sharding dengan menyentuh file di jalur dalam TEST_SHARD_STATUS_FILE. Jika salah (false), peluncuran 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 (true), pengujian eksklusif akan berjalan dengan strategi sandbox. Tambahkan tag local untuk memaksa pengujian eksklusif dijalankan secara lokal

Tag: incompatible_change

--[no]incompatible_strict_action_env default: "true"

Jika benar, Bazel 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 penyiapan cache lintas pengguna jika cache bersama digunakan.

Tag: loading_and_analysis, incompatible_change

Penggunaan --j2objc_translation_flags=<comma-separated list of options> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke alat J2ObjC.

--java_debug

Menyebabkan virtual machine Java dari pengujian Java menunggu koneksi dari debugger yang kompatibel dengan JDWP (seperti jdb) sebelum memulai pengujian. Menyiratkan -test_output=streamed.

Meluas 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.

--[no]java_header_compilation default: "true"

Kompilasi ijar langsung dari sumber.

--java_language_version=<a string> default: ""

Versi bahasa Java

--java_launcher=<a build target label> default: lihat deskripsi

Peluncur Java yang akan digunakan saat membangun biner Java. Jika tanda ini disetel ke string kosong, peluncur JDK akan digunakan. Atribut "peluncur" menggantikan tanda ini.

--java_runtime_version=<a string> default: "local_jdk"

Versi runtime Java

Penggunaan --javacopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke javac.

Penggunaan --jvmopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan untuk diteruskan ke VM Java. Opsi ini akan ditambahkan ke opsi startup VM dari setiap target java_binary.

--legacy_main_dex_list_generator=<a build target label> default: lihat deskripsi

Menentukan biner yang akan digunakan untuk membuat daftar class yang harus ada di dex utama saat mengompilasi multidex lama.

--optimizing_dexer=<a build target label> default: lihat deskripsi

Menentukan biner yang akan digunakan untuk melakukan dexing tanpa sharding.

Penggunaan --plugin=<a build target label> beberapa kali akan diakumulasikan

Plugin yang akan digunakan dalam build. Saat ini berfungsi dengan java_plugin.

--proguard_top=<a build target label> default: lihat deskripsi

Menentukan versi ProGuard yang akan digunakan untuk penghapusan kode saat membangun biner Java.

--proto_compiler=<a build target label> default: "@bazel_tools//tools/proto:protoc"

Label proto-compiler.

Tag: affects_outputs, loading_and_analysis

--[no]proto_profile default: "true"

Apakah akan meneruskan profile_path ke compiler proto.

Tag: affects_outputs, loading_and_analysis

--proto_profile_path=<a build target label> default: lihat deskripsi

Profil yang akan diteruskan ke compiler proto sebagai profile_path. Jika tidak disetel, tetapi --proto_profile adalah benar (default), menyimpulkan jalur dari --fdo_optimize.

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

Penggunaan --protocopt=<a string> beberapa kali akan diakumulasikan

Opsi tambahan yang akan diteruskan ke compiler protobuf.

Tag: affects_outputs

--[no]runs_per_test_detects_flakes default: "false"

Jika benar (true), setiap shard yang setidaknya satu kali lulus dan setidaknya satu kali gagal akan mendapatkan status TIDAK STABIL (FLAKY).

--shell_executable=<a path> default: lihat deskripsi

Jalur absolut ke shell yang dapat dieksekusi untuk digunakan Bazel. Jika tidak disetel, tetapi variabel lingkungan BAZEL_SH disetel pada pemanggilan Bazel pertama (yang memulai server Bazel), Bazel akan menggunakannya. Jika keduanya tidak ditetapkan, Bazel akan menggunakan jalur default yang dikodekan secara permanen, bergantung pada sistem operasi yang dijalankannya;

  • Windows: c:/msys64/usr/bin/bash.exe
  • FreeBSD: /usr/local/bin/bash
  • 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

Penggunaan --test_arg=<a string> beberapa kali akan 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 identik. Hanya digunakan oleh perintah bazel test.

--test_filter=<a string> default: lihat deskripsi

Menentukan filter untuk diteruskan ke framework pengujian. Digunakan untuk membatasi pengujian yang dijalankan. Perhatikan bahwa hal ini tidak memengaruhi target yang dibuat.

--test_result_expiration=<an integer> default: "-1"

Opsi ini tidak digunakan lagi dan tidak berpengaruh.

--[no]test_runner_fail_fast default: "false"

Meneruskan opsi fail fast ke runner pengujian. Runner pengujian harus menghentikan eksekusi saat kegagalan pertama terjadi.

--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce> default: "explicit"

Tentukan strategi untuk sharding pengujian:

  • explicit untuk hanya menggunakan sharding jika atribut shard_count BUILD ada.
  • disabled agar tidak pernah menggunakan sharding pengujian.
  • forced=k untuk menerapkan shard k untuk pengujian, terlepas dari atribut shard_count BUILD.
--tool_java_language_version=<a string> default: ""

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 mengeksekusi alat selama build

--[no]use_ijars default: "true"

Jika diaktifkan, opsi ini menyebabkan kompilasi Java menggunakan jar antarmuka. Hal ini akan menghasilkan kompilasi inkremental yang lebih cepat, tetapi pesan error dapat berbeda.

Opsi Versi

Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, yang memengaruhi nilainya, bukan keberadaannya:
--[no]gnu_format default: "false"

Jika ditetapkan, tulis versi ke stdout menggunakan konvensi yang dijelaskan dalam standar GNU.

Tag: affects_outputs, execution

Tag Efek Opsi

unknown Opsi ini memiliki efek yang tidak diketahui atau tidak terdokumentasi.
no_op Opsi ini sama sekali tidak berpengaruh.
loses_incremental_state Mengubah nilai opsi ini dapat menyebabkan hilangnya status inkremental yang signifikan, yang memperlambat build. Status dapat hilang karena server dimulai ulang atau karena pembatalan validasi sebagian besar grafik dependensi.
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 efek transitif, dan tidak menentukan jenis output yang dipengaruhinya.
build_file_semantics Opsi ini memengaruhi semantik file BUILD atau .bzl.
bazel_internal_configuration Opsi ini memengaruhi setelan mekanisme internal bazel. Tag ini sendiri tidak berarti artefak build terpengaruh.
loading_and_analysis Opsi ini memengaruhi pemuatan dan analisis dependensi, serta pembuatan grafik dependensi.
execution Opsi ini memengaruhi fase eksekusi, seperti opsi terkait eksekusi jarak jauh atau sandbox.
host_machine_resource_optimizations Opsi ini memicu pengoptimalan yang mungkin khusus untuk mesin dan tidak dijamin berfungsi di semua mesin. 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 sudah tidak digunakan lagi, atau metode lain untuk memberikan informasi lebih disukai.
non_configurable Opsi ini tidak dapat diubah dalam transisi atau digunakan dalam pernyataan select().