bazel [<startup options>] <command> [<args>]
bazel [<startup options>] <command> [<args>] -- [<target patterns>]
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>
-<short_form> <value>
Opsi boolean dapat diaktifkan sebagai berikut:
--<option> --<option>=[true|yes|1]
--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]
--no<option> --<option>=[false|no|0]
Perintah
analyze-profile |
Menganalisis data profil build. |
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. |
sync |
Menyinkronkan semua repositori yang ditentukan dalam file ruang kerja |
test |
Membangun dan menjalankan target pengujian yang ditentukan. |
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 keluar.
Tag:affects_outputs
,loses_incremental_state
- Default
--[no]batch
: "false" -
Jika disetel, Bazel akan dijalankan sebagai proses klien saja 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
- Default
--[no]batch_cpu_scheduling
: "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
--bazelrc=<path>
default: lihat deskripsi-
Lokasi file .bazelrc pengguna yang berisi nilai default opsi Bazel. /dev/null menunjukkan bahwa semua `--bazelrc`selanjutnya 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 akan menunggu perintah yang sedang berjalan selesai, tetapi akan langsung keluar.
Tag:eagerness_to_exit
- Default
--[no]client_debug
: "false" -
Jika benar, catat informasi debug dari klien ke stderr. Mengubah opsi ini tidak akan menyebabkan server dimulai ulang.
Tag:affects_outputs
,bazel_monitoring
- Default
--connect_timeout_secs=<an integer>
: "30" -
Jumlah waktu yang ditunggu klien untuk setiap upaya terhubung ke server
Tag:bazel_internal_configuration
--[no]expand_configs_in_place
default: "true"-
Mengubah perluasan tanda --config agar dilakukan di tempat, bukan dalam perluasan titik tetap antara opsi rc normal dan opsi yang ditentukan command line.
Tag:no_op
,deprecated
--failure_detail_out=<path>
default: lihat deskripsi-
Jika 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 utama di $HOME/.bazelrc atau tidak
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
- Default
--[no]ignore_all_rc_files
: "false" -
Menonaktifkan semua file rc, terlepas dari nilai flag pengubah rc lainnya, meskipun flag ini muncul di urutan berikutnya dalam daftar opsi startup.
Tag:changes_inputs
- Default
--io_nice_level={-1,0,1,2,3,4,5,6,7}
: "-1" -
Hanya di Linux; tetapkan level dari 0-7 untuk penjadwalan I/O 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: user-interactive, user-initiated, default, utility, dan background.
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 basis 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
- Default
--[no]preemptible
: "false" -
Jika benar (true), perintah dapat didahului jika perintah lain dimulai.
Tag:eagerness_to_exit
--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
- Default
--[no]shutdown_on_low_sys_mem
: "false" -
Jika max_idle_secs disetel dan server build telah tidak aktif selama beberapa waktu, nonaktifkan server saat sistem kekurangan RAM kosong. Khusus Linux.
Tag:eagerness_to_exit
,loses_incremental_state
--[no]system_rc
default: "true"-
Apakah akan mencari bazelrc di seluruh sistem atau tidak.
Tag:changes_inputs
- Default
--[no]unlimit_coredumps
: "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
- Default
--[no]watchfs
: "false" -
Jika benar, bazel akan mencoba menggunakan layanan pemantauan file sistem operasi untuk perubahan lokal, bukan memindai setiap file untuk mencari perubahan.
Tag:deprecated
- Default
--[no]windows_enable_symlinks
: "false" -
Jika benar, link simbolis sebenarnya 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 lain-lain, yang tidak dikategorikan.:
--host_jvm_args=<jvm_arg>
beberapa penggunaan diakumulasikan- Flag yang akan diteruskan ke JVM yang menjalankan Blaze.
--host_jvm_debug
-
Opsi praktis untuk menambahkan beberapa 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=-Xdebug
--host_jvm_args=-Xrunjdwp:transport=dt_socket,server=y,address=5005
--host_jvm_profile=<profiler_name>
default: ""- Opsi praktis untuk menambahkan beberapa tanda peluncuran JVM khusus profiler/debugger. Bazel memiliki daftar nilai yang diketahui yang dipetakan ke flag startup JVM yang dikodekan secara permanen, yang mungkin menelusuri beberapa jalur yang dikodekan secara permanen untuk file tertentu.
--server_javabase=<jvm path>
default: ""- Jalur ke JVM yang digunakan untuk menjalankan Bazel itu sendiri.
Opsi Umum untuk semua Perintah
- Opsi yang mengontrol eksekusi build:
- Default
--experimental_oom_more_eagerly_threshold=<an integer>
: "100" -
Jika tanda ini disetel ke nilai kurang dari 100, Bazel akan mengalami OOM jika, setelah dua GC penuh, lebih dari persentase heap (gen lama) ini masih ditempati.
Tag:host_machine_resource_optimizations
- Default
--experimental_ui_max_stdouterr_bytes=<an integer in (-1)-1073741819 range>
: "1048576" -
Ukuran maksimum file stdout / stderr yang akan dicetak ke konsol. -1 berarti tidak ada batas.
Tag:execution
- Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
- Default
--[no]incompatible_enable_proto_toolchain_resolution
: "false" -
Jika benar, aturan bahasa proto menentukan toolchain dari repositori rules_proto, rules_java, rules_cc.
Tag:loading_and_analysis
,incompatible_change
- Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, yang memengaruhi nilainya, bukan keberadaannya:
--repo_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan variabel lingkungan tambahan yang hanya tersedia untuk aturan repositori. Perhatikan bahwa aturan repositori tetap melihat seluruh lingkungan, tetapi dengan cara ini, informasi konfigurasi dapat diteruskan ke repositori melalui opsi tanpa membatalkan grafik tindakan.
Tag:action_command_lines
- Opsi yang memengaruhi seberapa ketat Bazel menerapkan input build yang valid (definisi aturan, kombinasi tanda, dll.):
--[no]check_bzl_visibility
default: "true"-
Jika dinonaktifkan, error visibilitas pemuatan .bzl akan diturunkan menjadi peringatan.
Tag:build_file_semantics
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
- Default
--[no]enable_bzlmod
: "false" -
Jika benar (true), mengaktifkan sistem pengelolaan dependensi Bzlmod, yang lebih diprioritaskan daripada WORKSPACE. Lihat https://bazel.build/docs/bzlmod untuk mengetahui informasi selengkapnya.
Tag:loading_and_analysis
--[no]experimental_action_resource_set
default: "true"-
Jika disetel ke benar (true), ctx.actions.run() dan ctx.actions.run_shell() akan menerima parameter resource_set untuk eksekusi lokal. Jika tidak, secara default akan ditetapkan ke 250 MB untuk memori dan 1 CPU.
Tag:execution
,build_file_semantics
,experimental
-
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]experimental_analysis_test_call
default: "true"-
Jika disetel ke benar (true), panggilan native analysis_test akan tersedia.
Tag:loading_and_analysis
,build_file_semantics
,experimental
--[no]experimental_bzl_visibility
default: "true"-
Jika diaktifkan, menambahkan fungsi `visibility()` yang dapat dipanggil file .bzl selama evaluasi tingkat atas untuk menetapkan visibilitasnya untuk tujuan pernyataan load().
Tag:loading_and_analysis
,experimental
-
Jika disetel ke benar (true), atribut aturan dan metode Starlark API yang diperlukan untuk aturan cc_shared_library akan tersedia
Tag:build_file_semantics
,loading_and_analysis
,experimental
- Default
--[no]experimental_disable_external_package
: "false" -
Jika disetel ke benar, 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
- Default
--[no]experimental_enable_android_migration_apis
: "false" -
Jika disetel ke benar (true), akan mengaktifkan API yang diperlukan untuk mendukung migrasi Android Starlark.
Tag:build_file_semantics
- Default
--[no]experimental_get_fixed_configured_action_env
: "false" -
Jika diaktifkan, action.env juga akan menampilkan variabel lingkungan tetap yang ditentukan melalui konfigurasi fitur.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_google_legacy_api
: "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
- Default
--[no]experimental_isolated_extension_usages
: "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_lazy_template_expansion
default: "true"-
Jika disetel ke benar (true), ctx.actions.expand_template() menerima parameter TemplateDict untuk evaluasi tertunda nilai penggantian.
Tag:execution
,build_file_semantics
,experimental
- Default
--[no]experimental_platforms_api
: "false" -
Jika disetel ke benar (true), akan mengaktifkan sejumlah API Starlark terkait platform yang berguna untuk proses debug.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_repo_remote_exec
: "false" -
Jika disetel ke benar (true), repository_rule akan mendapatkan beberapa kemampuan eksekusi jarak jauh.
Tag:build_file_semantics
,loading_and_analysis
,experimental
- Default
--[no]experimental_sibling_repository_layout
: "false" -
Jika 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]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
--[no]incompatible_depset_for_libraries_to_link_getter
default: "true"-
Jika benar, Bazel tidak lagi menampilkan daftar dari linking_context.libraries_to_link, tetapi menampilkan depset.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_disable_objc_library_transition
: "false" -
Nonaktifkan transisi kustom objc_library dan mewarisi dari target tingkat teratas
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_disable_starlark_host_transitions
: "false" -
Jika disetel ke benar (true), atribut aturan tidak dapat menetapkan 'cfg = "host"'. Sebagai gantinya, aturan harus menetapkan 'cfg = "exec"'.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_disable_target_provider_fields
: "false" -
Jika disetel ke benar (true), nonaktifkan kemampuan untuk mengakses penyedia pada objek 'target' melalui sintaksis kolom. Gunakan sintaksis provider-key. Misalnya, alih-alih menggunakan `ctx.attr.dep.my_info` untuk mengakses `my_info` dari dalam fungsi penerapan aturan, gunakan `ctx.attr.dep[MyInfo]`. Lihat https://github.com/bazelbuild/bazel/issues/9014 untuk mengetahui detailnya.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_disallow_empty_glob
: "false" -
Jika disetel ke benar (true), nilai default argumen `allow_empty` dari glob() adalah Salah (False).
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_disallow_legacy_javainfo
default: "true"-
Tidak digunakan lagi. No-op.
Tags:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_disallow_struct_provider_syntax
: "false" -
Jika disetel ke benar (true), fungsi penerapan aturan mungkin tidak menampilkan struct. Sebagai gantinya, metode ini harus menampilkan daftar instance penyedia.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_enable_deprecated_label_apis
default: "true"-
Jika diaktifkan, API tertentu yang tidak digunakan lagi (native.repository_name, Label.workspace_name, Label.relative) dapat digunakan.
Tag:loading_and_analysis
--[no]incompatible_existing_rules_immutable_view
default: "true"-
Jika disetel ke benar (true), native.existing_rule dan native.existing_rules akan menampilkan objek tampilan ringan yang tidak dapat diubah, bukan dict yang dapat diubah.
Tag:build_file_semantics
,loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_fail_on_unknown_attributes
: "false" -
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 "//..." agar 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_java_common_parameters
default: "true"-
Jika disetel ke benar (true), parameter output_jar, dan host_javabase di pack_sources serta host_javabase di compile akan dihapus.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_merge_fixed_and_default_shell_env
: "false" -
Jika diaktifkan, tindakan yang terdaftar dengan ctx.actions.run dan ctx.actions.run_shell dengan 'env' dan 'use_default_shell_env = True' yang ditentukan akan menggunakan lingkungan yang diperoleh dari lingkungan shell default dengan mengganti nilai yang diteruskan ke 'env'. Jika dinonaktifkan, nilai 'env' akan sepenuhnya diabaikan dalam kasus ini.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_new_actions_api
default: "true"-
Jika disetel ke benar (true), API untuk membuat tindakan hanya tersedia di `ctx.actions`, bukan di `ctx`.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_no_attr_license
default: "true"-
Jika disetel ke benar (true), menonaktifkan fungsi `attr.license`.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_no_implicit_file_export
: "false" -
Jika disetel, file sumber (yang digunakan) bersifat khusus paket kecuali jika diekspor secara eksplisit. Lihat https://github.com/bazelbuild/proposals/blob/master/designs/2019-10-24-file-visibility.md
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_no_rule_outputs_param
: "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"-
Di atribut `packages` package_group, memungkinkan penulisan "public" atau "private" untuk merujuk ke semua paket atau tidak ada paket.
Tag:build_file_semantics
,incompatible_change
--[no]incompatible_require_linker_input_cc_api
default: "true"-
Jika disetel ke benar, aturan create_linking_context akan memerlukan linker_inputs, bukan libraries_to_link. Pengambil lama linking_context juga akan dinonaktifkan dan hanya linker_inputs yang akan tersedia.
Tag:build_file_semantics
,loading_and_analysis
,incompatible_change
--[no]incompatible_run_shell_command_string
default: "true"-
Jika disetel ke benar (true), parameter perintah actions.run_shell hanya akan menerima string
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_stop_exporting_language_modules
: "false" -
Jika diaktifkan, modul khusus bahasa tertentu (seperti `cc_common`) tidak tersedia di file .bzl pengguna dan hanya dapat dipanggil dari repositori aturan masing-masing.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_struct_has_no_methods
: "false" -
Menonaktifkan metode to_json dan to_proto dari struct, yang mencemari namespace kolom struct. Sebagai gantinya, gunakan json.encode atau json.encode_indent untuk JSON, atau proto.encode_text untuk textproto.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_top_level_aspects_require_providers
: "false" -
Jika disetel ke benar (true), aspek tingkat teratas akan mematuhi penyedia yang diperlukan dan hanya berjalan pada target tingkat teratas yang penyedia yang diiklankan dalam aturannya memenuhi penyedia yang diperlukan dalam aspek.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_unambiguous_label_stringification
default: "true"-
Jika benar (true), 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
- Default
--[no]incompatible_use_cc_configure_from_rules_cc
: "false" -
Jika benar, Bazel tidak akan lagi mengizinkan penggunaan cc_configure dari @bazel_tools. Lihat https://github.com/bazelbuild/bazel/issues/10134 untuk mengetahui detail dan petunjuk migrasi.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
default: "true"-
Jika disetel ke benar (true), visibilitas atribut aturan pribadi diperiksa sehubungan dengan definisi aturan, dan akan kembali ke penggunaan aturan jika tidak terlihat.
Tag:build_file_semantics
,incompatible_change
- Default
--max_computation_steps=<a long integer>
: "0" -
Jumlah maksimum langkah komputasi Starlark yang dapat dieksekusi oleh file BUILD (nol berarti tidak ada batas).
Tag:build_file_semantics
- Default
--nested_set_depth_limit=<an integer>
: "3500" -
Kedalaman maksimum grafik internal ke depset (juga dikenal sebagai NestedSet), yang jika terlampaui, konstruktor depset() akan gagal.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
--[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_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 kejelasan, format, atau lokasi logging:
- Default
--[no]announce_rc
: "false" -
Apakah akan mengumumkan opsi rc.
Tag:affects_outputs
- Default
--[no]attempt_to_print_relative_paths
: "false" -
Saat mencetak bagian lokasi pesan, coba gunakan jalur 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
- Default
--[no]bes_check_preceding_lifecycle_events
: "false" -
Menetapkan kolom check_preceding_lifecycle_events_present di PublishBuildToolEventStreamRequest yang memberi tahu BES untuk memeriksa apakah sebelumnya menerima peristiwa InvocationAttemptStarted dan BuildEnqueued yang cocok dengan peristiwa alat saat ini.
Tag:affects_outputs
--bes_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan-
Tentukan header dalam bentuk NAME=VALUE yang akan disertakan dalam permintaan BES. Beberapa header dapat diteruskan dengan menentukan 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
--bes_keywords=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Menentukan daftar kata kunci notifikasi yang akan ditambahkan ke kumpulan kata kunci default yang dipublikasikan ke BES ("command_name=<command_name> ", "protocol_name=BEP"). Default-nya 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 terjadi OOM. Flag ini memastikan penghentian saat JVM mengalami thrashing GC parah dan tidak dapat memproses thread pengguna.
Tag:bazel_monitoring
- Default
--bes_outerr_buffer_size=<an integer>
: "10240" -
Menentukan ukuran maksimal stdout atau stderr yang akan di-buffer di BEP, sebelum dilaporkan sebagai peristiwa progres. Penulisan individual masih dilaporkan dalam satu peristiwa, meskipun lebih besar dari nilai yang ditentukan hingga --bes_outerr_chunk_size.
Tag:affects_outputs
- Default
--bes_outerr_chunk_size=<an integer>
: "1048576" -
Menentukan ukuran maksimum stdout atau stderr yang akan dikirim ke BEP dalam satu pesan.
Tag:affects_outputs
--bes_proxy=<a string>
default: lihat deskripsi- Hubungkan ke Build Event Service 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
- Default
--bes_timeout=<An immutable length of time.>
: "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 satuan: Hari (d), jam (h), menit (m), detik (s), dan milidetik (ms). Nilai defaultnya adalah '0' yang berarti tidak ada waktu tunggu.
Tag:affects_outputs
--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_json_file=<a string>
default: ""-
Jika tidak kosong, tulis serialisasi JSON dari protokol peristiwa build ke file tersebut.
Tag:affects_outputs
--[no]build_event_json_file_path_conversion
default: "true"-
Konversi jalur dalam representasi file json dari protokol peristiwa build ke URI yang lebih valid secara global jika memungkinkan; jika dinonaktifkan, skema uri file:// akan selalu digunakan
Tag:affects_outputs
- Default
--build_event_max_named_set_of_file_entries=<an integer>
: "-1" -
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. Tindakan ini ditujukan untuk membatasi ukuran peristiwa maksimum dalam protokol peristiwa build, meskipun tidak secara langsung mengontrol ukuran peristiwa. Ukuran total peristiwa adalah fungsi dari struktur set serta panjang file dan URI, yang pada gilirannya dapat bergantung pada fungsi hash.
Tag:affects_outputs
- Default
--[no]build_event_publish_all_actions
: "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"-
Konversi jalur dalam representasi file teks dari protokol peristiwa build ke URI yang lebih valid secara global jika memungkinkan; jika dinonaktifkan, skema uri file:// akan selalu digunakan
Tag:affects_outputs
- Default
--[no]experimental_announce_profile_path
: "false" -
Jika diaktifkan, akan menambahkan jalur profil JSON ke log.
Tag:affects_outputs
,bazel_monitoring
- Default
--[no]experimental_bep_target_summary
: "false" - Apakah akan memublikasikan peristiwa TargetSummary.
- Default
--[no]experimental_build_event_expand_filesets
: "false" -
Jika benar, luaskan Kumpulan File di BEP saat menampilkan file output.
Tag:affects_outputs
- Default
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: "false" -
Jika benar (true), selesaikan sepenuhnya link simbolis Fileset relatif di BEP saat menampilkan file output. Memerlukan --experimental_build_event_expand_filesets.
Tag:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
default: "4"-
Jumlah maksimum percobaan ulang yang harus dilakukan Bazel saat mengupload peristiwa build.
Tag:bazel_internal_configuration
- Default
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1 detik" -
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.
Tag:affects_outputs
--experimental_profile_additional_tasks=<phase, action, action_check, action_lock, action_release, action_update, action_complete, bzlmod, info, create_package, remote_execution, local_execution, scanner, local_parse, upload_time, process_time, remote_queue, remote_setup, fetch, vfs_stat, vfs_dir, vfs_readlink, vfs_md5, vfs_xattr, vfs_delete, vfs_open, vfs_read, vfs_write, vfs_glob, vfs_vmfs_stat, vfs_vmfs_dir, vfs_vmfs_read, wait, thread_name, thread_sort_index, skyframe_eval, skyfunction, critical_path, critical_path_component, handle_gc_notification, action_counts, local_cpu_usage, system_cpu_usage, local_memory_usage, system_memory_usage, system_network_up_usage, system_network_down_usage, workers_memory_usage, system_load_average, starlark_parser, starlark_user_fn, starlark_builtin_fn, starlark_user_compiled_fn, starlark_repository_fn, action_fs_staging, remote_cache_check, remote_download, remote_network, filesystem_traversal, worker_execution, worker_setup, worker_borrow, worker_working, worker_copying_outputs, credential_helper or unknown>
beberapa penggunaan diakumulasikan-
Menentukan tugas profil tambahan yang akan disertakan dalam profil.
Tag:affects_outputs
,bazel_monitoring
- Default
--[no]experimental_profile_include_primary_output
: "false" -
Menyertakan atribut "out" tambahan dalam peristiwa tindakan yang berisi jalur eksekusi ke output utama tindakan.
Tag:affects_outputs
,bazel_monitoring
- Default
--[no]experimental_profile_include_target_label
: "false" -
Mencakup label target dalam data profil JSON peristiwa tindakan.
Tag:affects_outputs
,bazel_monitoring
- Default
--[no]experimental_stream_log_file_uploads
: "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.
- Default
--[no]generate_json_trace_profile
: "auto" -
Jika diaktifkan, Bazel akan membuat profil build dan menulis profil berformat 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:affects_outputs
,bazel_monitoring
- Default
--[no]heap_dump_on_oom
: "false" -
Apakah akan menghasilkan dump heap secara manual jika terjadi OOM (termasuk OOM karena --experimental_oom_more_eagerly_threshold). Dump akan ditulis ke <output_base>/<invocation_id>.heapdump.hprof. Opsi ini secara efektif menggantikan -XX:+HeapDumpOnOutOfMemoryError, yang tidak berpengaruh karena OOM ditangkap dan dialihkan ke Runtime#halt.
Tag:bazel_monitoring
--[no]legacy_important_outputs
default: "true"-
Gunakan ini untuk menekan pembuatan kolom important_outputs lama di peristiwa TargetComplete. important_outputs diperlukan untuk integrasi Bazel ke ResultStore.
Tag:affects_outputs
- Default
--logging=<0 <= an integer <= 6>
: "3" -
Tingkat 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:affects_outputs
,bazel_monitoring
- Default
--memory_profile_stable_heap_parameters=<integers, separated by a comma expected in pairs>
: "1,0" -
Menyesuaikan penghitungan profil memori untuk 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 melakukan 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. Gunakan bazel analyze-profile untuk menganalisis profil.
Tag:affects_outputs
,bazel_monitoring
--[no]slim_profile
default: "true"-
Memperkecil ukuran profil JSON dengan menggabungkan peristiwa jika profil menjadi terlalu besar.
Tag:affects_outputs
,bazel_monitoring
--starlark_cpu_profile=<a string>
default: ""-
Menulis profil pprof penggunaan CPU oleh semua thread Starlark ke dalam file yang ditentukan.
Tag:bazel_monitoring
--tool_tag=<a string>
default: ""-
Nama alat untuk mengatribusikan pemanggilan Bazel ini.
Tag:affects_outputs
,bazel_monitoring
--ui_event_filters=<Convert list of comma separated event kind to list of filters>
beberapa penggunaan diakumulasikan-
Menentukan peristiwa 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
- Opsi lain-lain, yang tidak dikategorikan.:
--build_metadata=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan-
Pasangan string nilai kunci kustom yang akan diberikan dalam peristiwa build.
Tag:terminal_output
- Default
--color=<yes, no or auto>
: "auto" - Gunakan kontrol terminal untuk mewarnai output.
--config=<a string>
beberapa penggunaan diakumulasikan- Memilih bagian konfigurasi tambahan dari file rc; untuk setiap <command>, opsi juga ditarik dari <command>:<config> jika bagian tersebut ada; jika bagian ini tidak ada dalam file .rc, Blaze akan gagal dengan error. Bagian konfigurasi dan kombinasi flag yang setara dengannya terletak di file konfigurasi tools/*.blazerc.
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
beberapa penggunaan diakumulasikan- Mengonfigurasi helper kredensial yang akan digunakan untuk 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 https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md untuk mengetahui detailnya.
- Default
--credential_helper_cache_duration=<An immutable length of time.>
: "30m" - Durasi kredensial yang disediakan oleh helper kredensial di-cache. Memanggil dengan nilai yang berbeda akan menyesuaikan masa aktif entri yang sudah ada; teruskan nol untuk menghapus cache. Perintah clean selalu menghapus cache, terlepas dari tanda ini.
--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.
- Default
--curses=<yes, no or auto>
: "auto" - Gunakan kontrol kursor terminal untuk meminimalkan output scrolling.
- Default
--[no]enable_platform_specific_config
: "false" - Jika benar (true), 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 setara dengan menggunakan --config=linux di Linux, --config=windows di Windows, dll.
- Default
--[no]experimental_skymeld_ui
: "false" -
Menampilkan progres analisis dan fase eksekusi saat keduanya berjalan secara bersamaan.
Tag:terminal_output
- Default
--[no]experimental_windows_watchfs
: "false" - Jika benar (true), dukungan Windows eksperimental untuk --watchfs akan diaktifkan. Jika tidak, --watchfs adalah non-op di Windows. Pastikan juga untuk mengaktifkan --watchfs.
--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.
- Default
--[no]google_default_credentials
: "false" - Apakah akan menggunakan 'Kredensial Default Aplikasi Google' untuk autentikasi. Lihat https://cloud.google.com/docs/authentication untuk mengetahui detailnya. Dinonaktifkan secara default.
--grpc_keepalive_time=<An immutable length of time.>
default: lihat deskripsi- 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. Waktu diperlakukan sebagai perincian detik; error jika menetapkan nilai kurang dari satu detik. Secara default, ping keep-alive dinonaktifkan. Anda harus berkoordinasi dengan pemilik layanan sebelum mengaktifkan setelan ini. Misalnya, untuk menetapkan nilai 30 detik ke tanda ini, Anda harus melakukannya seperti ini --grpc_keepalive_time=30s
- Default
--grpc_keepalive_timeout=<An immutable length of time.>
: "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 balasan ping setelah jangka waktu ini. Waktu diperlakukan sebagai perincian detik; error jika menetapkan nilai kurang dari satu detik. Jika ping tetap aktif dinonaktifkan, setelan ini akan diabaikan.
--[no]incompatible_disallow_symlink_file_to_dir
default: "true"-
Jika disetel ke benar (true), `ctx.actions.symlink` tidak akan mengizinkan pembuatan link simbolis file ke dalam direktori.
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_rule_name_parameter
default: "true"-
Jika disetel ke benar (true), `rule` tidak dapat dipanggil dengan parameter `name`.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]progress_in_terminal_title
: "false" - Menampilkan progres perintah di judul terminal. Berguna untuk melihat apa yang dilakukan bazel saat memiliki beberapa tab terminal.
--[no]show_progress
default: "true"- Menampilkan pesan progres selama build.
- Default
--show_progress_rate_limit=<a double>
: "0.2" - Jumlah minimum detik antara pesan progres dalam output.
- Default
--[no]show_timestamps
: "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.
- Default
--ui_actions_shown=<an integer>
: "8" -
Jumlah tindakan serentak yang ditampilkan di status progres mendetail; setiap tindakan ditampilkan di baris terpisah. Status progres selalu menampilkan setidaknya satu, semua angka kurang dari 1 dipetakan ke 1.
Tag:terminal_output
- Default
--[no]watchfs
: "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: Perilaku tidak ditentukan jika ruang kerja Anda berada di sistem file jaringan, dan file diedit di mesin jarak jauh.
Opsi Analyze-profile
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika disetel, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Tindakan ini dimaksudkan untuk menghemat ruang disk.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Jika benar, gunakan string yang berasal dari URL download repositori sebagai canonical_id jika tidak ditentukan. Hal ini menyebabkan perubahan pada URL menghasilkan download ulang meskipun cache berisi download dengan hash yang sama. Hal ini dapat digunakan untuk memverifikasi bahwa perubahan URL tidak menyebabkan repositori yang rusak ditutupi oleh cache.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_repository_disable_download
: "false" -
Jika disetel, mendownload repositori eksternal tidak diizinkan.
Tag:experimental
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Menskalakan semua waktu tunggu terkait download http dengan faktor yang diberikan
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.
Tag:bazel_internal_configuration
- Opsi yang memengaruhi seberapa ketat Bazel menerapkan input build yang valid (definisi aturan, kombinasi tanda, dll.):
--experimental_repository_hash_file=<a string>
default: ""-
Jika tidak kosong, menentukan file yang berisi nilai yang telah diselesaikan, yang akan digunakan untuk memverifikasi hash direktori repositori
Tag:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
beberapa penggunaan diakumulasikan-
Jika daftar aturan repositori yang hash direktori outputnya harus diverifikasi, asalkan file ditentukan oleh --experimental_repository_hash_file.
Tag:affects_outputs
,experimental
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
default: "true"-
No-op
Tag:no_op
,deprecated
,experimental
- Opsi yang terkait dengan output dan semantik Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan ditarik di registry tempat modul tersebut berasal (jika modul tersebut tidak berasal dari NonRegistryOverride). Jika tidak, versi yang dibatalkan akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang diizinkan untuk dibatalkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel 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
- Default
--check_direct_dependencies=<off, warning or error>
: "warning" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di 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 meningkatkan ketidakcocokan menjadi kegagalan penyelesaian.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "nonaktif"-
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan memperbaruinya jika ada perubahan, `error` untuk menggunakan file kunci tetapi menampilkan error jika file tersebut tidak terbaru, atau `off` agar tidak membaca dari atau menulis ke file kunci.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut 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`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari terlebih dahulu di registry awal, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry awal.
Tag:changes_inputs
- Opsi yang memengaruhi kejelasan, format, atau lokasi logging:
--dump=<text or raw>
[-d
] default: lihat deskripsi-
menampilkan dump data profil lengkap dalam format 'text' yang mudah dibaca atau format 'raw' yang kompatibel dengan skrip.
Tag:affects_outputs
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dijalankan terbesar. Menetapkan opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika tidak kosong, baca file yang telah di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan caching jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali 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.
- Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`
Opsi Aquery
Mewarisi semua opsi dari build.
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika disetel, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Tindakan ini dimaksudkan untuk menghemat ruang disk.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Jika benar, gunakan string yang berasal dari URL download repositori sebagai canonical_id jika tidak ditentukan. Hal ini menyebabkan perubahan pada URL menghasilkan download ulang meskipun cache berisi download dengan hash yang sama. Hal ini dapat digunakan untuk memverifikasi bahwa perubahan URL tidak menyebabkan repositori yang rusak ditutupi oleh cache.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_repository_disable_download
: "false" -
Jika disetel, mendownload repositori eksternal tidak diizinkan.
Tag:experimental
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Menskalakan semua waktu tunggu terkait download http dengan faktor yang diberikan
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.
Tag:bazel_internal_configuration
- Opsi yang memengaruhi seberapa ketat Bazel menerapkan input build yang valid (definisi aturan, kombinasi tanda, dll.):
--experimental_repository_hash_file=<a string>
default: ""-
Jika tidak kosong, menentukan file yang berisi nilai yang telah diselesaikan, yang akan digunakan untuk memverifikasi hash direktori repositori
Tag:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
beberapa penggunaan diakumulasikan-
Jika daftar aturan repositori yang hash direktori outputnya harus diverifikasi, asalkan file ditentukan oleh --experimental_repository_hash_file.
Tag:affects_outputs
,experimental
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
default: "true"-
No-op
Tag:no_op
,deprecated
,experimental
- Opsi yang terkait dengan output dan semantik kueri:
- Default
--aspect_deps=<off, conservative or precise>
: "konservatif" -
Cara mengatasi 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 berdasarkan 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
- Default
--[no]consistent_labels
: "false" -
Jika diaktifkan, setiap perintah kueri akan menghasilkan 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 perintah kueri dan/atau label yang berbeda yang dikeluarkan oleh aturan. Jika tidak diaktifkan, pemformat output bebas memancarkan nama repositori yang jelas (relatif terhadap repositori utama) untuk membuat output lebih mudah dibaca.
Tag:terminal_output
--[no]deduplicate_depsets
default: "true"-
Menghapus duplikat turunan non-leaf dari dep_set_of_files dalam output proto/textproto/JSON akhir. Tindakan ini tidak menghapus duplikat depset yang tidak memiliki induk langsung yang sama. Hal ini tidak memengaruhi daftar efektif akhir artefak input tindakan.
Tag:terminal_output
--[no]graph:factored
default: "true"-
Jika benar (true), 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
- Default
--graph:node_limit=<an integer>
: "512" -
Panjang maksimum string label untuk node grafik dalam output. Label yang lebih panjang akan dipotong; -1 berarti tidak ada pemotongan. Opsi ini hanya berlaku untuk --output=graph.
Tag:terminal_output
--[no]implicit_deps
default: "true"-
Jika diaktifkan, dependensi implisit akan disertakan dalam grafik dependensi tempat kueri 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
- Default
--[no]include_file_write_contents
: "false" -
Sertakan konten file untuk tindakan FileWrite dan SourceSymlinkManifest (berpotensi besar).
Tag:terminal_output
- Default
--[no]include_param_files
: "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]incompatible_display_source_file_location
default: "true"-
Benar secara default, menampilkan target file sumber. Jika benar (true), menampilkan lokasi baris 1 file sumber dalam output lokasi. Flag ini hanya ada untuk tujuan migrasi.
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
- Default
--[no]infer_universe_scope
: "false" -
Jika disetel dan --universe_scope tidak disetel, 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 harus menggunakan opsi ini hanya jika Anda tahu apa yang Anda lakukan. Lihat https://bazel.build/reference/query#sky-query untuk mengetahui detail dan contohnya. Jika --universe_scope ditetapkan, nilai opsi ini akan diabaikan. Catatan: opsi ini hanya berlaku untuk `query` (yaitu, bukan `cquery`).
Tag:loading_and_analysis
- Default
--[no]line_terminator_null
: "false" -
Apakah setiap format diakhiri dengan \0, bukan baris baru.
Tag:terminal_output
--[no]nodep_deps
default: "true"-
Jika diaktifkan, dependensi dari atribut "nodep" akan disertakan dalam grafik dependensi tempat kueri beroperasi. Contoh umum atribut "nodep" adalah "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, jsonproto.
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
- Default
--[no]proto:definition_stack
: "false" -
Isi kolom proto definition_stack, yang mencatat untuk setiap instance aturan, stack panggilan Starlark pada saat class aturan ditentukan.
Tag:terminal_output
--[no]proto:flatten_selects
default: "true"-
Jika diaktifkan, atribut yang dapat dikonfigurasi yang dibuat oleh select() akan diratakan. Untuk jenis daftar, representasi yang diratakan adalah daftar yang berisi setiap nilai peta pilihan tepat satu kali. Jenis skalar diratakan menjadi null.
Tag:build_file_semantics
- Default
--[no]proto:include_synthetic_attribute_hash
: "false" -
Apakah atribut $internal_attr_hash akan dihitung dan diisi atau tidak.
Tag:terminal_output
- Default
--[no]proto:instantiation_stack
: "false" -
Isi stack panggilan instansiasi setiap aturan. Perhatikan bahwa hal ini mengharuskan stack ada
Tag:terminal_output
--[no]proto:locations
default: "true"-
Apakah akan menampilkan informasi lokasi dalam output proto atau tidak.
Tag:terminal_output
- Default
--proto:output_rule_attrs=<comma-separated list of options>
: "all" -
Daftar atribut yang dipisahkan koma untuk disertakan dalam output. 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_inputs_and_outputs
default: "true"-
Apakah akan mengisi kolom rule_input dan rule_output 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
- Default
--[no]relative_locations
: "false" -
Jika benar, lokasi file BUILD dalam output xml dan proto akan bersifat relatif. Secara default, output lokasi adalah jalur absolut dan tidak akan konsisten di seluruh komputer. Anda dapat menyetel opsi ini ke benar (true) untuk mendapatkan hasil yang konsisten di seluruh perangkat.
Tag:terminal_output
- Default
--[no]skyframe_state
: "false" -
Tanpa melakukan analisis tambahan, buang Action Graph saat ini dari Skyframe. Catatan: Menentukan target dengan --skyframe_state saat ini tidak didukung. Flag ini hanya tersedia dengan --output=proto atau --output=textproto.
Tag:terminal_output
--[no]tool_deps
default: "true"-
Kueri: Jika dinonaktifkan, dependensi pada target 'konfigurasi host' atau 'eksekusi' tidak akan disertakan dalam grafik dependensi yang digunakan kueri. Edge dependensi 'konfigurasi host', seperti yang berasal dari aturan 'proto_library' ke Pengompilasi Protokol, biasanya mengarah ke alat yang dieksekusi selama build, bukan bagian dari program 'target' yang sama.
Cquery: Jika dinonaktifkan, akan memfilter semua target yang dikonfigurasi yang melintasi transisi host atau 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 ada dalam konfigurasi host, hanya target yang dikonfigurasi host 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 atas diasumsikan sebagai target yang diuraikan dari ekspresi kueri. Catatan: Untuk cquery, tidak menentukan opsi ini dapat menyebabkan build rusak jika target yang diuraikan dari ekspresi kueri tidak dapat dibangun dengan opsi tingkat teratas.
Tag:loading_and_analysis
- Opsi yang terkait dengan output dan semantik Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan ditarik di registry tempat modul tersebut berasal (jika modul tersebut tidak berasal dari NonRegistryOverride). Jika tidak, versi yang dibatalkan akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang diizinkan untuk dibatalkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel 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
- Default
--check_direct_dependencies=<off, warning or error>
: "warning" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di 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 meningkatkan ketidakcocokan menjadi kegagalan penyelesaian.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "nonaktif"-
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan memperbaruinya jika ada perubahan, `error` untuk menggunakan file kunci tetapi menampilkan error jika file tersebut tidak terbaru, atau `off` agar tidak membaca dari atau menulis ke file kunci.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut 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`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari terlebih dahulu di registry awal, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry awal.
Tag:changes_inputs
- Opsi yang memengaruhi kejelasan, format, atau lokasi logging:
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dijalankan terbesar. Menetapkan opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika tidak kosong, baca file yang telah di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan caching jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali 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.
- Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`
- Opsi yang mengontrol eksekusi build:
- Default
--[no]experimental_inprocess_symlink_creation
: "false" -
Apakah akan melakukan panggilan sistem file langsung untuk membuat struktur symlink
Tag:loading_and_analysis
,execution
,experimental
- Default
--[no]experimental_remotable_source_manifests
: "false" -
Apakah akan membuat tindakan manifes sumber dapat dilakukan dari jarak jauh
Tag:loading_and_analysis
,execution
,experimental
- Default
--[no]experimental_split_coverage_postprocessing
: "false" -
Jika benar (true), Bazel akan menjalankan pasca-pemrosesan cakupan untuk pengujian di proses baru.
Tag:execution
- Default
--[no]experimental_strict_fileset_output
: "false" -
Jika opsi ini diaktifkan, kumpulan file akan memperlakukan semua artefak output sebagai file reguler. File tersebut tidak akan melintasi direktori atau peka terhadap symlink.
Tag:execution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
default: ""-
Menambahkan atau menghapus kunci dari info eksekusi tindakan berdasarkan mnemonik tindakan. Hanya berlaku untuk tindakan yang mendukung info eksekusi. Banyak tindakan umum 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.
Diperluas menjadi:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Tag:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Aktifkan pemroses resource Android persisten menggunakan pekerja.
Diperluas menjadi:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
Tag:
host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Aktifkan tindakan dex dan desugar Android multiplex persisten menggunakan pekerja.
Diperluas menjadi:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Tag:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Aktifkan pemroses resource Android multiplex persisten dengan menggunakan pekerja.
Diperluas menjadi:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Tag:
host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Aktifkan alat Android persisten dan multiplex (dexing, desugaring, pemrosesan resource).
Diperluas menjadi:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Tag:host_machine_resource_optimizations
,execution
- Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
--android_compiler=<a string>
default: lihat deskripsi-
Compiler target Android.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
default: "//external:android/crosstool"-
Lokasi compiler C++ yang digunakan untuk build Android.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
default: lihat deskripsi-
Target Android grte_top.
Tag:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Default
--android_manifest_merger=<legacy, android or force_android>
: "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
--android_sdk=<a build target label>
default: "@bazel_tools//tools/android:sdk"-
Menentukan SDK/platform Android yang digunakan untuk membuat aplikasi Android.
Tag:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_compiler=<a string>
default: lihat deskripsi-
Compiler target Apple. Berguna untuk memilih varian toolchain (misalnya, xcode-beta).
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
default: "@bazel_tools//tools/cpp:toolchain"-
Label paket crosstool yang akan digunakan dalam aturan Apple dan Objc serta dependensinya.
Tag:loses_incremental_state
,changes_inputs
--apple_grte_top=<a build target label>
default: lihat deskripsi-
Target Apple grte_top.
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
,explicit_in_output_path
--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. Saat ini, ini harus berupa grup file yang berisi satu file, yaitu biner. Nilai defaultnya adalah '//tools/test:lcov_merger'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
default: "@bazel_tools//tools/test:coverage_report_generator"-
Lokasi biner yang digunakan untuk membuat laporan cakupan. Saat ini, ini harus berupa grup file yang berisi satu file, yaitu biner. Defaultnya adalah '//tools/test:coverage_report_generator'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
default: "@bazel_tools//tools/test:coverage_support"-
Lokasi file pendukung yang diperlukan pada input setiap tindakan pengujian yang mengumpulkan cakupan kode. Nilai defaultnya adalah '//tools/test:coverage_support'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
default: "@bazel_tools//tools/cpp:toolchain"-
Label paket crosstool yang akan digunakan untuk mengompilasi kode C++.
Tag:loading_and_analysis
,changes_inputs
,affects_outputs
--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
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
beberapa penggunaan diakumulasikan-
Daftar ekspresi reguler yang dipisahkan koma, yang masing-masing secara opsional diawali dengan - (ekspresi negatif), ditetapkan (=) ke daftar target nilai batasan yang dipisahkan koma. Jika target tidak cocok dengan ekspresi negatif dan cocok dengan setidaknya satu ekspresi positif, resolusi toolchain-nya akan dilakukan seolah-olah target telah menyatakan nilai batasan sebagai batasan eksekusi. Contoh: //demo,-test=@platforms//cpus:x86_64 akan menambahkan 'x86_64' ke target apa pun di bagian //demo, kecuali target yang namanya berisi 'test'.
Tag:loading_and_analysis
--[no]experimental_enable_objc_cc_deps
default: "true"-
Memungkinkan aturan objc_* bergantung pada cc_library dan menyebabkan dependensi objc apa pun dibangun dengan --cpu yang ditetapkan ke "ios_<--ios_cpu>" untuk nilai apa pun di --ios_multi_cpu.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]experimental_include_xcode_execution_requirements
: "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
--[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
--extra_execution_platforms=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
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().
Tag:execution
--extra_toolchains=<comma-separated list of options>
beberapa penggunaan 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 ke library libc yang di-check in. Nilai default dipilih oleh toolchain crosstool, dan Anda hampir tidak perlu menggantinya.
Tag:action_command_lines
,affects_outputs
--host_compiler=<a string>
default: lihat deskripsi-
Compiler C++ yang akan digunakan untuk kompilasi host. Argumen ini diabaikan jika --host_crosstool_top tidak ditetapkan.
Tag:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
default: lihat deskripsi-
Secara default, opsi --crosstool_top dan --compiler juga digunakan untuk konfigurasi host. Jika tanda ini diberikan, Bazel akan menggunakan libc dan compiler default untuk crosstool_top yang diberikan.
Tag:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
default: lihat deskripsi-
Jika ditentukan, setelan ini akan menggantikan direktori tingkat teratas libc (--grte_top) untuk konfigurasi host.
Tag:action_command_lines
,affects_outputs
--host_platform=<a build target label>
default: ""-
Label aturan platform yang menjelaskan sistem host.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set
default: "true"-
Jika benar (true), Bazel tidak akan mengizinkan penentuan expand_if_all_available di flag_sets (lihat https://github.com/bazelbuild/bazel/issues/7008 untuk mengetahui petunjuk migrasi).
Tag:loading_and_analysis
,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
- Default
--[no]incompatible_enable_android_toolchain_resolution
: "false" -
Gunakan penyelesaian toolchain untuk memilih Android SDK untuk aturan Android (Starlark dan native)
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_enable_apple_toolchain_resolution
: "false" -
Gunakan penyelesaian toolchain untuk memilih Apple SDK untuk aturan Apple (Starlark dan native)
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
default: "true"-
Jika benar (true), Bazel tidak akan menggunakan kembali command line tindakan link C++ untuk command line pengindeksan LTO (lihat https://github.com/bazelbuild/bazel/issues/6791 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
default: "true"-
Jika benar (true), Bazel akan menampilkan error saat atribut cc_toolchain.cpu dan cc_toolchain.compiler ditetapkan (lihat https://github.com/bazelbuild/bazel/issues/7075 untuk mengetahui petunjuk migrasi).
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
default: "true"-
Jika benar, Bazel tidak akan menautkan dependensi library sebagai seluruh arsip secara default (lihat https://github.com/bazelbuild/bazel/issues/7362 untuk mengetahui petunjuk migrasi).
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
default: "true"-
Jika benar (true), Bazel akan memerlukan parameter 'ctx' di cc_common.configure_features (lihat https://github.com/bazelbuild/bazel/issues/7793 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,incompatible_change
-
Gunakan objek bersama antarmuka jika didukung oleh toolchain. Semua toolchain ELF saat ini mendukung setelan ini.
Tag:loading_and_analysis
,affects_outputs
,affects_outputs
--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, gunakan 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 relative path>
default: ""-
Lokasi file pemetaan yang menjelaskan platform mana yang akan digunakan jika tidak ada yang ditetapkan atau flag mana yang akan ditetapkan jika platform sudah ada. Harus relatif terhadap root ruang kerja utama. Secara default adalah 'platform_mappings' (file langsung di bawah root ruang kerja).
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
default: ""-
Label aturan platform yang menjelaskan platform target untuk perintah saat ini.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
default: lihat deskripsi-
Tidak digunakan lagi, tidak ada operasi. Dinonaktifkan oleh `--incompatible_use_python_toolchains`.
Tag:no_op
,deprecated
--python3_path=<a string>
default: lihat deskripsi-
Tidak digunakan lagi, tidak ada operasi. Dinonaktifkan oleh `--incompatible_use_python_toolchains`.
Tag:no_op
,deprecated
--python_path=<a string>
default: lihat deskripsi-
Jalur absolut interpreter Python yang dipanggil untuk menjalankan target Python di platform target. Tidak digunakan lagi; dinonaktifkan oleh --incompatible_use_python_toolchains.
Tag:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
default: lihat deskripsi-
Label py_runtime yang merepresentasikan penafsir Python yang dipanggil untuk menjalankan target Python di platform target. Tidak digunakan lagi; dinonaktifkan oleh --incompatible_use_python_toolchains.
Tag:loading_and_analysis
,affects_outputs
--target_platform_fallback=<a build target label>
default: "@local_config_platform//:host"-
Label aturan platform yang harus digunakan jika tidak ada platform target yang ditetapkan dan tidak ada pemetaan platform yang cocok dengan kumpulan flag 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
--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, gunakan 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:
- Default
--[no]apple_enable_auto_dsym_dbg
: "false" -
Apakah akan memaksa mengaktifkan pembuatan file simbol debug (.dSYM) untuk build dbg.
Tag:affects_outputs
,action_command_lines
- Default
--[no]apple_generate_dsym
: "false" -
Apakah akan membuat file simbol debug (.dSYM).
Tag:affects_outputs
,action_command_lines
--[no]build_runfile_links
default: "true"-
Jika benar, bangun hutan symlink file yang dapat dijalankan untuk semua target. Jika salah (false), tulis hanya manifes jika memungkinkan.
Tag:affects_outputs
--[no]build_runfile_manifests
default: "true"-
Jika benar, tulis manifes file yang dapat dijalankan untuk semua target. Jika salah (false), hilangkan. Pengujian lokal akan gagal dijalankan jika salah (false).
Tag:affects_outputs
- Default
--[no]build_test_dwp
: "false" -
Jika diaktifkan, saat membuat pengujian C++ secara statis dan dengan fusi, file .dwp untuk biner pengujian juga akan dibuat secara otomatis.
Tag:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated list of options>
default: ".pb.h"-
Menetapkan awalan file header yang dibuat oleh cc_proto_library.
Tag:affects_outputs
,loading_and_analysis
- Default
--cc_proto_library_source_suffixes=<comma-separated list of options>
: ".pb.cc" -
Menetapkan awalan file sumber yang dibuat oleh cc_proto_library.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_proto_descriptor_sets_include_source_info
: "false" -
Menjalankan tindakan tambahan untuk versi API Java alternatif di proto_library.
Tag:affects_outputs
,loading_and_analysis
,experimental
- Default
--[no]experimental_proto_extra_actions
: "false" -
Menjalankan tindakan tambahan untuk versi API Java alternatif di proto_library.
Tag:affects_outputs
,loading_and_analysis
,experimental
- Default
--[no]experimental_save_feature_state
: "false" -
Simpan status fitur yang diaktifkan dan diminta sebagai output kompilasi.
Tag:affects_outputs
,experimental
- Default
--fission=<a set of compilation modes>
: "no" -
Menentukan mode kompilasi mana yang menggunakan fisi untuk kompilasi dan link C++. Dapat berupa kombinasi {'fastbuild', 'dbg', 'opt'} atau nilai khusus 'yes' untuk mengaktifkan semua mode dan 'no' untuk menonaktifkan semua mode.
Tag:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
default: "true"-
Jika benar (true), aturan native akan menambahkan <code>DefaultInfo.files</code> dependensi data ke runfile-nya, yang cocok dengan perilaku yang direkomendasikan untuk aturan Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Tag:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
default: "true"-
Jika benar (true), buat hutan symlink runfile untuk repositori eksternal di bawah .runfiles/wsname/external/repo (selain .runfiles/repo).
Tag:affects_outputs
- Default
--[no]objc_generate_linkmap
: "false" -
Menentukan apakah akan membuat file linkmap.
Tag:affects_outputs
- Default
--[no]save_temps
: "false" -
Jika disetel, output sementara dari gcc akan disimpan. Ini mencakup file .s (kode assembler), file .i (C yang telah diproses awal), dan file .ii (C++ yang telah diproses awal).
Tag:affects_outputs
- Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, yang memengaruhi nilainya, bukan keberadaannya:
--action_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi target. Variabel dapat ditentukan berdasarkan nama, yang dalam hal ini nilainya akan diambil dari lingkungan pemanggilan, atau berdasarkan pasangan nama=nilai yang menetapkan nilai secara terpisah dari lingkungan pemanggilan. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru yang akan berlaku, opsi untuk variabel yang berbeda akan terakumulasi.
Tag:action_command_lines
--android_cpu=<a string>
default: "armeabi-v7a"-
CPU target Android.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--[no]android_databinding_use_androidx
: "false" -
Buat file data binding yang kompatibel dengan AndroidX. Ini hanya digunakan dengan databinding v2.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]android_databinding_use_v3_4_args
: "false" -
Gunakan pengikatan data Android v2 dengan argumen 3.4.0
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
- Default
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "alphabetical" (alfabetis) -
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
- Default
--[no]android_resource_shrinking
: "false" -
Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.
Tag:affects_outputs
,loading_and_analysis
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, visionos, watchos, tvos, macos or catalyst>
beberapa penggunaan diakumulasikan-
Tentukan mode bitcode Apple untuk langkah kompilasi yang menargetkan arsitektur perangkat. Nilai memiliki bentuk '[platform=]mode', dengan platform (yang harus berupa 'ios', 'macos', 'tvos', atau 'watchos') bersifat opsional. Jika disediakan, mode bitcode diterapkan khusus untuk platform tersebut; jika tidak ada, mode bitcode diterapkan untuk semua platform. Modenya harus 'none', 'embedded_markers', atau 'embedded'. Opsi ini dapat diberikan beberapa kali.
Tag:loses_incremental_state
- Default
--[no]build_python_zip
: "auto" -
Bangun zip yang dapat dieksekusi Python; aktif di Windows, nonaktif di platform lain
Tag:affects_outputs
--catalyst_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk membangun biner Apple Catalyst.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--[no]collect_code_coverage
: "false" -
Jika ditentukan, Bazel akan melengkapi kode (menggunakan instrumentasi offline jika memungkinkan) dan akan mengumpulkan informasi cakupan selama pengujian. Hanya target yang cocok dengan --instrumentation_filter yang akan terpengaruh. Biasanya opsi ini tidak boleh ditentukan secara langsung - perintah 'bazel coverage' harus digunakan.
Tag:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] default: "fastbuild"-
Tentukan mode pembuatan biner. Nilai: 'fastbuild', 'dbg', 'opt'.
Tag:affects_outputs
,action_command_lines
,explicit_in_output_path
--conlyopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber C.
Tag:action_command_lines
,affects_outputs
--copt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc.
Tag:action_command_lines
,affects_outputs
--cpu=<a string>
default: ""-
CPU target.
Tag:changes_inputs
,affects_outputs
,explicit_in_output_path
--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
--cxxopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber C++.
Tag:action_command_lines
,affects_outputs
--define=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan-
Setiap opsi --define menentukan penetapan untuk variabel build.
Tag:changes_inputs
,affects_outputs
--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_fdo_profile_absolute_path
default: "true"-
Jika disetel, penggunaan fdo_absolute_profile_path akan menimbulkan error.
Tag:affects_outputs
- Default
--[no]enable_runfiles
: "auto" -
Aktifkan hierarki symlink runfile; Secara default, fitur ini nonaktif di Windows, dan aktif di platform lain.
Tag:affects_outputs
--experimental_action_listener=<a build target label>
beberapa penggunaan diakumulasikan-
Tidak digunakan lagi dan digantikan dengan aspek. Gunakan action_listener untuk melampirkan extra_action ke tindakan build yang ada.
Tag:execution
,experimental
- Default
--[no]experimental_android_compress_java_resources
: "false" -
Memadatkan resource Java di APK
Tag:affects_outputs
,loading_and_analysis
,experimental
- Default
--[no]experimental_android_databinding_v2
: "false" -
Menggunakan databinding v2 Android
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]experimental_android_resource_shrinking
: "false" -
Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_android_rewrite_dexes_with_rex
: "false" -
menggunakan alat rex untuk menulis ulang file dex
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]experimental_collect_code_coverage_for_generated_files
: "false" -
Jika ditentukan, Bazel juga akan membuat informasi cakupan pengumpulan untuk file yang dihasilkan.
Tag:affects_outputs
- Default
--experimental_objc_fastbuild_options=<comma-separated list of options>
: "-O0,-DDEBUG=1" -
Menggunakan string ini sebagai opsi compiler fastbuild objc.
Tag:action_command_lines
- Default
--[no]experimental_omitfp
: "false" -
Jika benar, gunakan libunwind untuk pelepasan stack, dan kompilasi dengan -fomit-frame-pointer dan -fasynchronous-unwind-tables.
Tag:action_command_lines
,affects_outputs
,experimental
- Default
--[no]experimental_platform_in_output_dir
: "false" -
Jika benar (true), platform target akan digunakan dalam nama direktori output, bukan CPU.
Tag:affects_outputs
,experimental
- Default
--[no]experimental_use_llvm_covmap
: "false" -
Jika ditentukan, Bazel akan membuat informasi peta cakupan llvm-cov, bukan gcov, saat collect_code_coverage diaktifkan.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--fat_apk_cpu=<comma-separated list of options>
default: "armeabi-v7a"-
Menetapkan opsi ini akan mengaktifkan fat APK, yang berisi biner native untuk semua arsitektur target yang ditentukan, misalnya, --fat_apk_cpu=x86,armeabi-v7a. Jika tanda ini ditentukan, --android_cpu akan diabaikan untuk dependensi aturan android_binary.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--[no]fat_apk_hwasan
: "false" -
Apakah akan membuat pemisahan HWASAN.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--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
--features=<a string>
beberapa penggunaan diakumulasikan-
Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi target. Menentukan -<fitur> akan menonaktifkan fitur tersebut. Fitur negatif selalu menggantikan fitur positif. Lihat juga --host_features
Tag:changes_inputs
,affects_outputs
- Default
--[no]force_pic
: "false" -
Jika diaktifkan, semua kompilasi C++ menghasilkan kode independen posisi ("-fPIC"), link lebih memilih library bawaan PIC daripada library non-PIC, dan link menghasilkan executable independen posisi ("-pie").
Tag:loading_and_analysis
,affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi host atau eksekusi. Variabel dapat ditentukan berdasarkan nama, yang dalam hal ini nilainya akan diambil dari lingkungan pemanggilan, atau berdasarkan pasangan nama=nilai yang menetapkan nilai secara terpisah dari lingkungan pemanggilan. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru yang akan berlaku, opsi untuk variabel yang berbeda akan terakumulasi.
Tag:action_command_lines
- Default
--host_compilation_mode=<fastbuild, dbg or opt>
: "opt" -
Tentukan mode alat yang digunakan selama build akan di-build. Nilai: 'fastbuild', 'dbg', 'opt'.
Tag:affects_outputs
,action_command_lines
--host_conlyopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber C untuk alat host.
Tag:action_command_lines
,affects_outputs
--host_copt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc untuk alat host.
Tag:action_command_lines
,affects_outputs
--host_cpu=<a string>
default: ""-
CPU host.
Tag:changes_inputs
,affects_outputs
--host_cxxopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc untuk alat host.
Tag:action_command_lines
,affects_outputs
--host_features=<a string>
beberapa penggunaan diakumulasikan-
Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi exec. Menentukan -<fitur> akan menonaktifkan fitur tersebut. Fitur negatif selalu menggantikan fitur positif.
Tag:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
default: lihat deskripsi-
Menggantikan versi Python untuk konfigurasi host. Dapat berupa "PY2" atau "PY3".
Tag:loading_and_analysis
,affects_outputs
--host_linkopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc saat menautkan alat host.
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
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan secara selektif ke compiler C/C++ saat mengompilasi file tertentu dalam konfigurasi host atau 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
--host_swiftcopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke swiftc untuk alat host.
Tag:action_command_lines
,affects_outputs
--[no]incompatible_avoid_conflict_dlls
default: "true"-
Jika diaktifkan, semua library yang ditautkan secara dinamis (DLL) C++ yang dihasilkan oleh cc_library di Windows akan diganti namanya menjadi name_{hash}.dll, dengan hash dihitung berdasarkan RepositoryName dan jalur paket DLL. Opsi ini berguna saat Anda memiliki satu paket yang bergantung pada beberapa cc_library dengan nama yang sama (misalnya //foo/bar1:utils dan //foo/bar2:utils).
Tag:loading_and_analysis
,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
- Default
--[no]incompatible_use_host_features
: "false" -
Jika benar (true), gunakan --features hanya untuk konfigurasi target dan --host_features untuk konfigurasi exec.
Tag:changes_inputs
,affects_outputs
,incompatible_change
--[no]incompatible_use_platforms_repo_for_constraints
default: "true"-
Jika benar (true), setelan batasan dari @bazel_tools akan dihapus.
Tag:affects_outputs
,incompatible_change
- Default
--[no]instrument_test_targets
: "false" -
Jika cakupan diaktifkan, tentukan apakah akan mempertimbangkan aturan pengujian instrumentasi. Jika ditetapkan, aturan pengujian yang disertakan oleh --instrumentation_filter akan diinstrumentasi. 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 diinstrumentasi. Aturan yang diawali dengan '-' akan dikecualikan. Perhatikan bahwa hanya aturan non-pengujian yang diinstrumentasi 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
--ios_multi_cpus=<comma-separated list of options>
beberapa penggunaan 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
--linkopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc saat menautkan.
Tag:action_command_lines
,affects_outputs
--ltobackendopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke langkah backend LTO (di bagian --features=thin_lto).
Tag:action_command_lines
,affects_outputs
--ltoindexopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke langkah pengindeksan LTO (di bagian --features=thin_lto).
Tag:action_command_lines
,affects_outputs
--macos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk membuat 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
- Default
--[no]objc_debug_with_GLIBCXX
: "false" -
Jika ditetapkan, dan mode kompilasi ditetapkan ke 'dbg', tentukan GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC, dan GLIBCPP_CONCEPT_CHECKS.
Tag:action_command_lines
- Default
--[no]objc_enable_binary_stripping
: "false" -
Apakah akan melakukan penghapusan simbol dan kode tidak terpakai pada biner yang ditautkan. Penyusutan biner akan dilakukan jika tanda ini dan --compilation_mode=opt ditentukan.
Tag:action_command_lines
--objccopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber Objective-C/C++.
Tag:action_command_lines
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk 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 dari semua file cc di //foo/ kecuali bar.cc.
Tag:action_command_lines
,affects_outputs
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk meneruskan secara selektif ke backend LTO (di bagian --features=thin_lto) saat mengompilasi objek backend tertentu. Opsi ini dapat diteruskan beberapa kali. Sintaksis: regex_filter@option_1,option_2,...,option_n. Dengan regex_filter adalah daftar pola ekspresi reguler 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 adalah 'foo -bar', dan command line eksekusinya adalah 'test_binary -baz', maka command line akhirnya adalah 'foo -bar test_binary -baz'.Ini juga dapat berupa label ke target yang dapat dieksekusi. Beberapa contohnya adalah: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Tag:action_command_lines
-
Jika benar (true), library native yang berisi fungsi identik akan dibagikan di antara target yang berbeda
Tag:loading_and_analysis
,affects_outputs
- Default
--[no]stamp
: "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
--stripopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke strip saat membuat biner '<name>.stripped'.
Tag:action_command_lines
,affects_outputs
--swiftcopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke kompilasi Swift.
Tag:action_command_lines
--tvos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk membangun 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 yang kompatibel minimum untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'tvos_sdk_version'.
Tag:loses_incremental_state
--visionos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk membuat biner Apple visionOS.
Tag:loses_incremental_state
,loading_and_analysis
--watchos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk membuat 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.):
--auto_cpu_environment_group=<a build target label>
default: ""-
Nyatakan environment_group yang akan digunakan untuk memetakan nilai cpu secara otomatis ke nilai target_environment.
Tag:changes_inputs
,loading_and_analysis
,experimental
- Default
--[no]check_licenses
: "false" -
Pastikan batasan pemberian lisensi yang diterapkan oleh paket dependen tidak bertentangan dengan mode distribusi target yang sedang dibuat. Secara default, lisensi tidak diperiksa.
Tag:build_file_semantics
--[no]check_visibility
default: "true"-
Jika dinonaktifkan, error visibilitas dalam dependensi target diturunkan menjadi peringatan.
Tag:build_file_semantics
--[no]desugar_for_android
default: "true"-
Apakah akan melakukan desugar bytecode Java 8 sebelum dexing.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--[no]desugar_java8_libs
: "false" -
Apakah akan menyertakan library Java 8 yang didukung dalam aplikasi untuk perangkat lama.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[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
- Default
--[no]experimental_allow_android_library_deps_without_srcs
: "false" -
Flag untuk membantu transisi dari mengizinkan ke tidak mengizinkan aturan android_library tanpa srcs dengan deps. Depot perlu dibersihkan untuk meluncurkan fitur ini secara default.
Tag:eagerness_to_exit
,loading_and_analysis
--[no]experimental_check_desugar_deps
default: "true"-
Apakah akan memeriksa kembali desugaring yang benar di tingkat biner Android.
Tag:eagerness_to_exit
,loading_and_analysis
,experimental
- Default
--experimental_import_deps_checking=<off, warning or error>
: "NONAKTIF" -
Jika diaktifkan, periksa apakah dependensi aar_import sudah selesai. Penerapan ini dapat merusak build, atau hanya 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
- Default
--[no]incompatible_check_testonly_for_output_files
: "false" -
Jika diaktifkan, periksa testonly untuk target prasyarat yang merupakan file output dengan mencari testonly aturan pembuatan. Tindakan ini cocok dengan pemeriksaan visibilitas.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_disable_native_android_rules
: "false" -
Jika diaktifkan, penggunaan langsung aturan Android native akan dinonaktifkan. Gunakan aturan Android Starlark dari https://github.com/bazelbuild/rules_android
Tag:eagerness_to_exit
,incompatible_change
- Default
--[no]incompatible_disable_native_apple_binary_rule
: "false" -
No-op. Dipertahankan di sini untuk kompatibilitas mundur.
Tag:eagerness_to_exit
,incompatible_change
--[no]incompatible_force_strict_header_check_from_starlark
default: "true"-
Jika diaktifkan, tetapkan pemeriksaan header ketat di Starlark API
Tag:loading_and_analysis
,changes_inputs
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
default: "true"-
Jika benar (true), Bazel juga akan memvalidasi penyertaan header direktori tingkat teratas (lihat https://github.com/bazelbuild/bazel/issues/10047 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]strict_filesets
: "false" -
Jika opsi ini diaktifkan, set file yang melintasi batas paket akan dilaporkan sebagai error. Fungsi ini tidak berfungsi jika check_fileset_dependencies_recursively dinonaktifkan.
Tag:build_file_semantics
,eagerness_to_exit
- Default
--strict_proto_deps=<off, warn, error, strict or 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 jika 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
- Default
--[no]strict_system_includes
: "false" -
Jika benar, header yang ditemukan melalui jalur sertakan sistem (-isystem) juga harus dideklarasikan.
Tag:loading_and_analysis
,eagerness_to_exit
--target_environment=<a build target label>
beberapa penggunaan diakumulasikan-
Mendeklarasikan lingkungan target build ini. Harus berupa referensi label ke aturan "lingkungan". Jika ditentukan, semua target tingkat teratas harus kompatibel dengan lingkungan ini.
Tag:changes_inputs
- Opsi yang memengaruhi output penandatanganan build:
- Default
--apk_signing_method=<v1, v2, v1_v2 or v4>
: "v1_v2" -
Implementasi yang akan digunakan untuk menandatangani APK
Tag:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
default: "true"-
Jika disetel, dan mode kompilasi bukan 'opt', aplikasi objc akan menyertakan hak istimewa 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_legacy_py_provider
default: "true"-
No-op, akan segera dihapus.
Tag:loading_and_analysis
,incompatible_change
- Opsi yang mengatur perilaku lingkungan pengujian atau pelaksana pengujian:
- Default
--[no]allow_analysis_failures
: "false" -
Jika benar (true), kegagalan analisis target aturan akan menyebabkan propagasi instance AnalysisFailureInfo yang berisi deskripsi error target, bukan menyebabkan kegagalan build.
Tag:loading_and_analysis
,experimental
- Default
--analysis_testing_deps_limit=<an integer>
: "2000" -
Menetapkan jumlah maksimum dependensi transitif melalui atribut aturan dengan transisi konfigurasi for_analysis_testing. Melebihi batas ini akan menyebabkan error aturan.
Tag:loading_and_analysis
- Default
--[no]break_build_on_parallel_dex2oat_failure
: "false" -
Jika benar, kegagalan tindakan dex2oat akan menyebabkan build rusak, bukan menjalankan dex2oat selama runtime pengujian.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_android_use_parallel_dex2oat
: "false" -
Gunakan dex2oat secara paralel untuk mempercepat android_test.
Tag:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- Default
--[no]ios_memleaks
: "false" -
Aktifkan pemeriksaan kebocoran memori dalam 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
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
beberapa penggunaan diakumulasikan- Menentukan berapa kali setiap pengujian akan dijalankan. Jika salah satu upaya tersebut gagal karena alasan apa pun, seluruh pengujian akan dianggap gagal. Biasanya, nilai yang ditentukan hanyalah bilangan bulat. Contoh: --runs_per_test=3 akan menjalankan semua pengujian 3 kali. Sintaksis alternatif: regex_filter@runs_per_test. Dengan runs_per_test adalah nilai bilangan bulat dan regex_filter adalah daftar pola ekspresi reguler yang disertakan dan dikecualikan (Lihat juga --instrumentation_filter). Contoh: --runs_per_test=//foo/.*,-//foo/bar/.*@3 menjalankan semua pengujian di //foo/ kecuali yang 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, pengujian hanya dijalankan satu kali.
--test_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan variabel lingkungan tambahan yang akan dimasukkan ke dalam lingkungan runner pengujian. Variabel dapat ditentukan berdasarkan nama, yang dalam hal ini nilainya akan dibaca dari lingkungan klien Bazel, atau berdasarkan pasangan name=value. Opsi ini dapat digunakan beberapa kali untuk menentukan beberapa variabel. Hanya digunakan oleh perintah 'bazel test'.
Tag:test_runner
- Default
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - Ganti nilai waktu tunggu pengujian default untuk waktu tunggu pengujian (dalam detik). Jika satu nilai bilangan bulat positif ditentukan, nilai tersebut akan menggantikan semua kategori. Jika 4 bilangan bulat yang dipisahkan koma ditentukan, bilangan bulat tersebut akan menggantikan waktu tunggu untuk pendek, sedang, panjang, dan abadi (dalam urutan tersebut). Dalam bentuk apa pun, nilai -1 memberi tahu Blaze untuk menggunakan waktu tunggu defaultnya untuk kategori tersebut.
--tvos_simulator_device=<a string>
default: lihat deskripsi-
Perangkat yang akan disimulasikan saat menjalankan aplikasi tvOS di simulator, misalnya 'Apple TV 1080p'. Anda bisa mendapatkan daftar perangkat dengan menjalankan 'xcrun simctl list devicetypes' di komputer tempat simulator akan dijalankan.
Tag:test_runner
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi tvOS yang akan dijalankan di simulator saat menjalankan atau menguji.
Tag:test_runner
--watchos_simulator_device=<a string>
default: lihat deskripsi-
Perangkat yang akan disimulasikan saat menjalankan aplikasi watchOS di simulator, misalnya 'Apple Watch - 38 mm'. Anda bisa mendapatkan daftar perangkat dengan menjalankan 'xcrun simctl list devicetypes' di komputer tempat simulator akan dijalankan.
Tag:test_runner
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi watchOS yang akan dijalankan di simulator saat menjalankan atau menguji.
Tag:test_runner
--[no]zip_undeclared_test_outputs
default: "true"-
Jika benar, output pengujian yang tidak dideklarasikan akan diarsipkan dalam file zip.
Tag:test_runner
- Opsi yang terkait dengan output dan semantik kueri:
- Default
--aspect_deps=<off, conservative or precise>
: "konservatif" -
Cara mengatasi 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 berdasarkan 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
- Default
--[no]consistent_labels
: "false" -
Jika diaktifkan, setiap perintah kueri akan menghasilkan 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 perintah kueri dan/atau label yang berbeda yang dikeluarkan oleh aturan. Jika tidak diaktifkan, pemformat output bebas memancarkan nama repositori yang jelas (relatif terhadap repositori utama) untuk membuat output lebih mudah dibaca.
Tag:terminal_output
--[no]deduplicate_depsets
default: "true"-
Menghapus duplikat turunan non-leaf dari dep_set_of_files dalam output proto/textproto/JSON akhir. Tindakan ini tidak menghapus duplikat depset yang tidak memiliki induk langsung yang sama. Hal ini tidak memengaruhi daftar efektif akhir artefak input tindakan.
Tag:terminal_output
--[no]graph:factored
default: "true"-
Jika benar (true), 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
- Default
--graph:node_limit=<an integer>
: "512" -
Panjang maksimum string label untuk node grafik dalam output. Label yang lebih panjang akan dipotong; -1 berarti tidak ada pemotongan. Opsi ini hanya berlaku untuk --output=graph.
Tag:terminal_output
--[no]implicit_deps
default: "true"-
Jika diaktifkan, dependensi implisit akan disertakan dalam grafik dependensi tempat kueri 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
- Default
--[no]include_file_write_contents
: "false" -
Sertakan konten file untuk tindakan FileWrite dan SourceSymlinkManifest (berpotensi besar).
Tag:terminal_output
- Default
--[no]include_param_files
: "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]incompatible_display_source_file_location
default: "true"-
Benar secara default, menampilkan target file sumber. Jika benar (true), menampilkan lokasi baris 1 file sumber dalam output lokasi. Flag ini hanya ada untuk tujuan migrasi.
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
- Default
--[no]infer_universe_scope
: "false" -
Jika disetel dan --universe_scope tidak disetel, 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 harus menggunakan opsi ini hanya jika Anda tahu apa yang Anda lakukan. Lihat https://bazel.build/reference/query#sky-query untuk mengetahui detail dan contohnya. Jika --universe_scope ditetapkan, nilai opsi ini akan diabaikan. Catatan: opsi ini hanya berlaku untuk `query` (yaitu, bukan `cquery`).
Tag:loading_and_analysis
- Default
--[no]line_terminator_null
: "false" -
Apakah setiap format diakhiri dengan \0, bukan baris baru.
Tag:terminal_output
--[no]nodep_deps
default: "true"-
Jika diaktifkan, dependensi dari atribut "nodep" akan disertakan dalam grafik dependensi tempat kueri beroperasi. Contoh umum atribut "nodep" adalah "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, jsonproto.
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
- Default
--[no]proto:definition_stack
: "false" -
Isi kolom proto definition_stack, yang mencatat untuk setiap instance aturan, stack panggilan Starlark pada saat class aturan ditentukan.
Tag:terminal_output
--[no]proto:flatten_selects
default: "true"-
Jika diaktifkan, atribut yang dapat dikonfigurasi yang dibuat oleh select() akan diratakan. Untuk jenis daftar, representasi yang diratakan adalah daftar yang berisi setiap nilai peta pilihan tepat satu kali. Jenis skalar diratakan menjadi null.
Tag:build_file_semantics
- Default
--[no]proto:include_synthetic_attribute_hash
: "false" -
Apakah atribut $internal_attr_hash akan dihitung dan diisi atau tidak.
Tag:terminal_output
- Default
--[no]proto:instantiation_stack
: "false" -
Isi stack panggilan instansiasi setiap aturan. Perhatikan bahwa hal ini mengharuskan stack ada
Tag:terminal_output
--[no]proto:locations
default: "true"-
Apakah akan menampilkan informasi lokasi dalam output proto atau tidak.
Tag:terminal_output
- Default
--proto:output_rule_attrs=<comma-separated list of options>
: "all" -
Daftar atribut yang dipisahkan koma untuk disertakan dalam output. 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_inputs_and_outputs
default: "true"-
Apakah akan mengisi kolom rule_input dan rule_output 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
- Default
--[no]relative_locations
: "false" -
Jika benar, lokasi file BUILD dalam output xml dan proto akan bersifat relatif. Secara default, output lokasi adalah jalur absolut dan tidak akan konsisten di seluruh komputer. Anda dapat menyetel opsi ini ke benar (true) untuk mendapatkan hasil yang konsisten di seluruh perangkat.
Tag:terminal_output
- Default
--[no]skyframe_state
: "false" -
Tanpa melakukan analisis tambahan, buang Action Graph saat ini dari Skyframe. Catatan: Menentukan target dengan --skyframe_state saat ini tidak didukung. Flag ini hanya tersedia dengan --output=proto atau --output=textproto.
Tag:terminal_output
--[no]tool_deps
default: "true"-
Kueri: Jika dinonaktifkan, dependensi pada target 'konfigurasi host' atau 'eksekusi' tidak akan disertakan dalam grafik dependensi yang digunakan kueri. Edge dependensi 'konfigurasi host', seperti yang berasal dari aturan 'proto_library' ke Pengompilasi Protokol, biasanya mengarah ke alat yang dieksekusi selama build, bukan bagian dari program 'target' yang sama.
Cquery: Jika dinonaktifkan, akan memfilter semua target yang dikonfigurasi yang melintasi transisi host atau 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 ada dalam konfigurasi host, hanya target yang dikonfigurasi host 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 atas diasumsikan sebagai target yang diuraikan dari ekspresi kueri. Catatan: Untuk cquery, tidak menentukan opsi ini dapat menyebabkan build rusak jika target yang diuraikan dari ekspresi kueri tidak dapat dibangun dengan opsi tingkat teratas.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--[no]collapse_duplicate_defines
: "false" -
Jika diaktifkan, --define yang berlebihan akan dihapus lebih awal dalam build. Hal ini menghindari hilangnya cache analisis yang tidak perlu untuk jenis build yang setara tertentu.
Tag:loading_and_analysis
,loses_incremental_state
- Default
--[no]experimental_filter_library_jar_with_program_jar
: "false" -
Memfilter ProGuard ProgramJar untuk menghapus semua class yang juga ada di LibraryJar.
Tag:action_command_lines
--[no]experimental_inmemory_dotd_files
default: "true"-
Jika diaktifkan, file .d C++ akan diteruskan dalam memori langsung dari node build jarak jauh, bukan ditulis ke disk.
Tag:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
default: "true"-
Jika diaktifkan, file dependensi (.jdeps) yang dihasilkan dari kompilasi Java akan diteruskan dalam memori langsung dari node build jarak jauh, bukan ditulis ke disk.
Tag:loading_and_analysis
,execution
,affects_outputs
,experimental
- Default
--[no]experimental_objc_include_scanning
: "false" -
Apakah akan melakukan pemindaian include untuk Objective C/C++.
Tag:loading_and_analysis
,execution
,changes_inputs
- Default
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
: "false" -
Jika diaktifkan, fitur parse_headers tidak membuat tindakan kompilasi header terpisah jika sumber dengan nama dasar yang sama ditemukan di target yang sama.
Tag:loading_and_analysis
,affects_outputs
- Default
--[no]experimental_retain_test_configuration_across_testonly
: "false" -
Jika diaktifkan, --trim_test_configuration tidak akan memangkas konfigurasi pengujian untuk aturan yang ditandai dengan testonly=1. Hal ini dimaksudkan untuk mengurangi masalah konflik tindakan saat aturan non-pengujian bergantung pada aturan cc_test. Tidak berpengaruh jika --trim_test_configuration adalah false.
Tag:loading_and_analysis
,loses_incremental_state
- Default
--[no]experimental_starlark_cc_import
: "false" -
Jika diaktifkan, cc_import versi Starlark dapat digunakan.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_unsupported_and_brittle_include_scanning
: "false" -
Apakah akan mempersempit input ke kompilasi C/C++ dengan mengurai baris #include dari file input. Hal ini dapat meningkatkan performa dan inkrementalitas dengan mengurangi ukuran pohon input kompilasi. Namun, hal ini juga dapat merusak build karena pemindai include tidak sepenuhnya menerapkan semantik praprosesor C. Khususnya, tidak memahami direktif #include dinamis dan mengabaikan logika bersyarat praprosesor. Gunakan dengan menanggung sendiri risikonya. Setiap masalah terkait tanda ini yang diajukan akan ditutup.
Tag:loading_and_analysis
,execution
,changes_inputs
--[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 kumpulan input yang diteruskan ke kompilasi objc.
Tag:changes_inputs
,loading_and_analysis
- Default
--[no]process_headers_in_dependencies
: "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
--[no]use_singlejar_apkbuilder
default: "true"-
Opsi ini tidak digunakan lagi. Sekarang menjadi no-op dan akan segera dihapus.
Tag:loading_and_analysis
- Opsi yang memengaruhi kejelasan, format, atau lokasi logging:
- Default
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
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
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--flag_alias=<a 'name=value' flag alias>
beberapa penggunaan diakumulasikan-
Menetapkan nama singkat untuk flag Starlark. Fungsi ini mengambil satu pasangan nilai kunci dalam bentuk "<key>=<value>" sebagai argumen.
Tag:changes_inputs
- Default
--[no]incompatible_default_to_explicit_init_py
: "false" -
Flag ini mengubah perilaku default sehingga file __init__.py tidak lagi dibuat secara otomatis di file yang dapat dijalankan dari target Python. 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
--[no]incompatible_py2_outputs_are_suffixed
default: "true"-
Jika benar (true), target yang dibuat dalam konfigurasi Python 2 akan muncul di bawah root output yang menyertakan akhiran '-py2', sedangkan target yang dibuat untuk Python 3 akan muncul di root tanpa akhiran terkait Python. Artinya, link simbolis praktis `bazel-bin` akan mengarah ke target Python 3, bukan Python 2. Jika Anda mengaktifkan opsi ini, sebaiknya aktifkan juga `--incompatible_py3_is_default`.
Tag:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
default: "true"-
Jika benar, target `py_binary` dan `py_test` yang tidak menetapkan atribut `python_version` (atau `default_python_version`) akan ditetapkan secara default ke PY3, bukan PY2. Jika Anda menyetel tanda ini, sebaiknya setel juga `--incompatible_py2_outputs_are_suffixed`.
Tag:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
default: "true"-
Jika disetel ke benar (true), aturan Python native yang dapat dieksekusi akan menggunakan runtime Python yang ditentukan oleh toolchain Python, bukan runtime yang diberikan oleh flag lama seperti --python_top.
Tag:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
default: lihat deskripsi-
Mode versi utama Python, baik `PY2` atau `PY3`. Perhatikan bahwa ini digantikan oleh target `py_binary` dan `py_test` (meskipun tidak secara eksplisit menentukan versi) sehingga biasanya tidak ada banyak alasan untuk memberikan tanda ini.
Tag:loading_and_analysis
,affects_outputs
,explicit_in_output_path
- Opsi lain-lain, yang tidak dikategorikan.:
--[no]cache_test_results
[-t
] default: "auto"- Jika disetel ke 'auto', Bazel akan menjalankan ulang pengujian jika dan hanya jika: (1) Bazel mendeteksi perubahan dalam pengujian atau dependensinya, (2) pengujian ditandai sebagai eksternal, (3) beberapa eksekusi pengujian diminta dengan --runs_per_test, atau(4) pengujian sebelumnya gagal. Jika disetel ke 'yes', Bazel akan menyimpan dalam cache semua hasil pengujian kecuali untuk pengujian yang ditandai sebagai eksternal. Jika disetel ke 'no', Bazel tidak akan menyimpan hasil pengujian dalam cache.
- Default
--[no]experimental_cancel_concurrent_tests
: "false" -
Jika benar, Blaze akan membatalkan pengujian yang berjalan secara bersamaan pada pengujian pertama yang berhasil. Opsi ini hanya berguna jika dikombinasikan dengan --runs_per_test_detects_flakes.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_fetch_all_coverage_outputs
: "false" -
Jika benar (true), Bazel akan mengambil seluruh direktori data cakupan untuk setiap pengujian selama menjalankan cakupan.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_generate_llvm_lcov
: "false" -
Jika benar (true), cakupan untuk clang akan menghasilkan laporan LCOV.
Tag:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
default: "true"- Apakah akan membuat peta header J2ObjC secara paralel dengan transpilasi J2ObjC.
- Default
--[no]experimental_j2objc_shorter_header_path
: "false" -
Apakah akan membuat dengan jalur header yang lebih pendek (menggunakan "_ios" dan bukan "_j2objc").
Tag:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
default: "javabuilder"- Mengaktifkan classpath yang dikurangi untuk kompilasi Java.
- Default
--[no]experimental_limit_android_lint_to_android_constrained_java
: "false" -
Batasi --experimental_run_android_lint_on_java_rules ke library yang kompatibel dengan Android.
Tag:affects_outputs
- Default
--[no]experimental_run_android_lint_on_java_rules
: "false" -
Apakah akan memvalidasi sumber java_*.
Tag:affects_outputs
- Default
--[no]explicit_java_test_deps
: "false" - Tentukan dependensi ke JUnit atau Hamcrest secara eksplisit dalam 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 dieksekusi selama build.
--host_javacopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke javac saat membuat alat yang dieksekusi selama build.
--host_jvmopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke Java VM saat membuat alat yang dieksekusi selama build. Opsi ini akan ditambahkan ke opsi startup VM dari setiap target java_binary.
- Default
--[no]incompatible_check_sharding_support
: "false" -
Jika benar, Bazel akan gagal dalam pengujian yang di-shard jika peluncur pengujian tidak menunjukkan bahwa peluncur mendukung sharding dengan menyentuh file di jalur dalam TEST_SHARD_STATUS_FILE. Jika salah (false), peluncur pengujian yang tidak mendukung sharding akan menyebabkan semua pengujian berjalan di setiap shard.
Tag:incompatible_change
- Default
--[no]incompatible_exclusive_test_sandboxed
: "false" -
Jika benar, pengujian eksklusif akan berjalan dengan strategi sandbox. Tambahkan tag 'local' untuk menjalankan pengujian eksklusif secara lokal
Tag:incompatible_change
- Default
--[no]incompatible_strict_action_env
: "false" -
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 penyimpanan cache lintas pengguna jika cache bersama digunakan.
Tag:loading_and_analysis
,incompatible_change
--j2objc_translation_flags=<comma-separated list of options>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke alat J2ObjC.
--java_debug
-
Menyebabkan mesin virtual 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"- Membuat informasi dependensi (untuk saat ini, classpath waktu kompilasi) per target Java.
--[no]java_header_compilation
default: "true"- Kompilasi ijar langsung dari sumber.
- Default
--java_language_version=<a string>
: "8" - 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.
- Default
--java_runtime_version=<a string>
: "local_jdk" - Versi runtime Java
--javacopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke javac.
--jvmopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke VM Java. Opsi ini akan ditambahkan ke opsi startup VM 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.
--plugin=<a build target label>
beberapa penggunaan diakumulasikan- Plugin yang akan digunakan dalam build. Saat ini berfungsi dengan java_plugin.
--proguard_top=<a build target label>
default: lihat deskripsi- Menentukan versi ProGuard yang akan digunakan untuk penghapusan kode saat membangun biner Java.
--proto_compiler=<a build target label>
default: "@bazel_tools//tools/proto:protoc"-
Label proto-compiler.
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
default: "@bazel_tools//tools/proto:cc_toolchain"-
Label proto_lang_toolchain() yang menjelaskan cara mengompilasi proto C++
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
default: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Label proto_lang_toolchain() yang menjelaskan cara mengompilasi proto j2objc
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
default: "@bazel_tools//tools/proto:java_toolchain"-
Label proto_lang_toolchain() yang menjelaskan cara mengompilasi proto Java
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
default: "@bazel_tools//tools/proto:javalite_toolchain"-
Label proto_lang_toolchain() yang menjelaskan cara mengompilasi proto JavaLite
Tag:affects_outputs
,loading_and_analysis
--protocopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke compiler protobuf.
Tag:affects_outputs
- Default
--[no]runs_per_test_detects_flakes
: "false" - Jika benar, setiap shard yang setidaknya satu kali lulus dan setidaknya satu kali gagal akan mendapatkan status 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 tidak ada yang ditetapkan, Bazel akan menggunakan jalur default yang dikodekan secara permanen, bergantung pada sistem operasi yang dijalankannya (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, semua sistem operasi lainnya: /bin/bash). Perhatikan bahwa penggunaan shell yang tidak kompatibel dengan bash dapat menyebabkan kegagalan build atau kegagalan runtime biner yang dihasilkan.
Tag:loading_and_analysis
--test_arg=<a string>
beberapa penggunaan diakumulasikan- Menentukan opsi dan argumen tambahan yang harus diteruskan ke file yang dapat dieksekusi untuk 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.
- Default
--test_result_expiration=<an integer>
: "-1" - Opsi ini tidak digunakan lagi dan tidak berpengaruh.
- Default
--[no]test_runner_fail_fast
: "false" - Meneruskan opsi gagal cepat ke runner pengujian. Runner pengujian harus menghentikan eksekusi saat kegagalan pertama terjadi.
--test_sharding_strategy=<explicit or disabled>
default: "explicit"- Tentukan strategi untuk sharding pengujian: 'explicit' untuk hanya menggunakan sharding jika atribut BUILD 'shard_count' ada. 'disabled' agar tidak pernah menggunakan sharding pengujian.
- Default
--tool_java_language_version=<a string>
: "8" - Versi bahasa Java yang digunakan untuk menjalankan alat yang diperlukan selama build
--tool_java_runtime_version=<a string>
default: "remotejdk_11"- Versi runtime Java yang digunakan untuk menjalankan alat selama build
--[no]use_ijars
default: "true"- Jika diaktifkan, opsi ini akan menyebabkan kompilasi Java menggunakan jar antarmuka. Hal ini akan menghasilkan kompilasi inkremental yang lebih cepat, tetapi pesan error dapat berbeda.
Opsi Build
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika disetel, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Tindakan ini dimaksudkan untuk menghemat ruang disk.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Jika benar, gunakan string yang berasal dari URL download repositori sebagai canonical_id jika tidak ditentukan. Hal ini menyebabkan perubahan pada URL menghasilkan download ulang meskipun cache berisi download dengan hash yang sama. Hal ini dapat digunakan untuk memverifikasi bahwa perubahan URL tidak menyebabkan repositori yang rusak ditutupi oleh cache.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_repository_disable_download
: "false" -
Jika disetel, mendownload repositori eksternal tidak diizinkan.
Tag:experimental
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Menskalakan semua waktu tunggu terkait download http dengan faktor yang diberikan
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.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--[no]check_up_to_date
: "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 banyak milidetik eksekusi lokal harus ditunda, jika eksekusi jarak jauh lebih cepat selama build setidaknya satu kali?
Tag:execution
,host_machine_resource_optimizations
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment>
beberapa penggunaan diakumulasikan-
Strategi lokal, secara berurutan, yang akan digunakan untuk mnemonik tertentu. Meneruskan 'local' sebagai mnemonik akan menetapkan default untuk mnemonik yang tidak ditentukan. Mengambil [mnemonic=]local_strategy[,local_strategy,...]
Tag:execution
,host_machine_resource_optimizations
--dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment>
beberapa penggunaan diakumulasikan-
Strategi jarak jauh yang akan digunakan untuk mnemonik tertentu. Meneruskan 'remote' sebagai mnemonik akan menetapkan default untuk mnemonik yang tidak ditentukan. Menerima [mnemonic=]remote_strategy[,remote_strategy,...]
Tag:execution
,host_machine_resource_optimizations
--experimental_docker_image=<a string>
default: ""-
Tentukan nama image Docker (misalnya, "ubuntu:latest") yang harus digunakan untuk menjalankan tindakan sandbox saat menggunakan strategi docker dan tindakan itu sendiri belum memiliki atribut container-image di remote_execution_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
- Default
--experimental_dynamic_local_load_factor=<a double>
: "0" -
Mengontrol seberapa banyak beban dari eksekusi dinamis yang ditempatkan di komputer lokal. Flag ini menyesuaikan jumlah tindakan dalam eksekusi dinamis yang akan kita jadwalkan secara bersamaan. Ini didasarkan pada jumlah CPU yang dianggap tersedia oleh Blaze, yang dapat dikontrol dengan tanda --local_cpu_resources.
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
- Default
--experimental_dynamic_slow_remote_time=<An immutable length of time.>
: "0" -
Jika >0, waktu tindakan yang dijalankan secara dinamis harus dijalankan khusus 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
- Default
--[no]experimental_enable_docker_sandbox
: "false" -
Aktifkan sandbox berbasis Docker. Opsi ini tidak berpengaruh jika Docker tidak diinstal.
Tag:execution
--experimental_persistent_javac
-
Aktifkan compiler Java persisten eksperimental.
Diperluas menjadi:
--strategy=Javac=worker
--strategy=JavaIjar=local
--strategy=JavaDeployJar=local
--strategy=JavaSourceJar=local
--strategy=Turbine=local
Tag:execution
,host_machine_resource_optimizations
- Default
--experimental_sandbox_async_tree_delete_idle_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "0" -
Jika 0, hapus struktur sandbox segera setelah tindakan selesai (menyebabkan penyelesaian tindakan tertunda). Jika lebih besar dari nol, hapus tiga tersebut pada kumpulan thread asinkron yang berukuran 1 saat build sedang berjalan dan bertambah menjadi ukuran yang ditentukan oleh tanda ini saat server tidak ada aktivitas.
Tag:host_machine_resource_optimizations
,execution
--experimental_sandboxfs_path=<a string>
default: "sandboxfs"-
Jalur ke biner sandboxfs yang akan digunakan saat --experimental_use_sandboxfs bernilai benar (true). Jika nama tidak memiliki ekstensi, gunakan biner pertama dari nama tersebut yang ditemukan di PATH.
Tag:host_machine_resource_optimizations
,execution
--[no]experimental_split_xml_generation
default: "true"-
Jika tanda ini disetel, dan tindakan pengujian tidak menghasilkan file test.xml, Bazel akan menggunakan tindakan terpisah untuk menghasilkan file test.xml dummy yang berisi log pengujian. Jika tidak, Bazel akan membuat test.xml sebagai bagian dari tindakan pengujian.
Tag:execution
- Default
--experimental_total_worker_memory_limit_mb=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "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
- Default
--[no]experimental_use_hermetic_linux_sandbox
: "false" -
Jika disetel ke benar (true), jangan pasang root, hanya pasang apa yang disediakan dengan sandbox_add_mount_pair. File input akan ditautkan keras ke sandbox, bukan ditautkan simbolis dari sandbox. Jika file input tindakan berada di sistem file yang berbeda dengan sandbox, file input akan disalin.
Tag:execution
- Default
--[no]experimental_use_sandboxfs
: "false" -
Gunakan sandboxfs untuk membuat direktori execroot tindakan, bukan membuat hierarki symlink. Jika "yes", biner yang disediakan oleh --experimental_sandboxfs_path harus valid dan sesuai dengan sandboxfs versi yang didukung. Jika "auto", biner mungkin tidak ada atau tidak kompatibel.
Tag:host_machine_resource_optimizations
,execution
- Default
--[no]experimental_use_windows_sandbox
: "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.
--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.
- Default
--[no]experimental_worker_as_resource
: "false" -
Jika diaktifkan, pekerja diperoleh sebagai resource dari ResourceManager.
Tag:execution
,host_machine_resource_optimizations
- Default
--[no]experimental_worker_cancellation
: "false" -
Jika diaktifkan, Bazel dapat mengirim permintaan pembatalan ke pekerja yang mendukungnya.
Tag:execution
--[no]experimental_worker_multiplex
default: "true"-
Jika diaktifkan, pekerja yang mendukung fitur multiplexing eksperimental akan menggunakan fitur tersebut.
Tag:execution
,host_machine_resource_optimizations
- Default
--[no]experimental_worker_multiplex_sandboxing
: "false" -
Jika diaktifkan, pekerja multiplex akan di-sandbox, menggunakan direktori sandbox terpisah per permintaan kerja. Hanya pekerja yang memiliki persyaratan eksekusi 'supports-multiplex-sandboxing' yang akan di-sandbox.
Tag:execution
- Default
--[no]experimental_worker_strict_flagfiles
: "false" -
Jika diaktifkan, argumen tindakan untuk pekerja yang tidak mengikuti spesifikasi pekerja akan menyebabkan error. Argumen pekerja harus memiliki 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
--high_priority_workers=<a string>
beberapa penggunaan diakumulasikan-
Mnemonik pekerja yang akan dijalankan dengan prioritas tinggi. Saat pekerja prioritas tinggi berjalan, semua pekerja lainnya akan dibatasi.
Tag:execution
--[no]incompatible_remote_dangling_symlinks
default: "true"-
Jika disetel ke benar (true) dan --incompatible_remote_symlinks juga benar (true), symlink dalam output tindakan diizinkan untuk tidak memiliki tujuan.
Tag:execution
,incompatible_change
--[no]incompatible_remote_symlinks
default: "true"-
Jika disetel ke benar (true), Bazel akan merepresentasikan symlink dalam output tindakan di protokol eksekusi/penyimpanan dalam cache jarak jauh. Jika tidak, symlink akan diikuti dan ditampilkan sebagai file atau direktori. Lihat #6631 untuk mengetahui detailnya.
Tag:execution
,incompatible_change
- Default
--[no]incompatible_sandbox_hermetic_tmp
: "false" -
Jika disetel ke benar (true), setiap sandbox Linux akan memiliki direktori kosong khusus yang dipasang sebagai /tmp, bukan berbagi /tmp dengan sistem file host. Gunakan --sandbox_add_mount_pair=/tmp agar tetap melihat /tmp host di semua sandbox.
Tag:execution
- Default
--[no]internal_spawn_scheduler
: "false" -
Opsi placeholder agar kita dapat mengetahui di Blaze apakah penjadwal spawn diaktifkan.
Tag:execution
,host_machine_resource_optimizations
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] default: "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
- Default
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Jumlah thread paralel yang akan digunakan untuk fase pemuatan/analisis.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
- Default
--[no]reuse_sandbox_directories
: "false" -
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
- Default
--[no]sandbox_explicit_pseudoterminal
: "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
--sandbox_tmpfs_path=<an absolute path>
beberapa penggunaan diakumulasikan-
Untuk tindakan dalam kotak pasir, pasang direktori kosong yang dapat ditulis di jalur absolut ini (jika didukung oleh implementasi kotak pasir, jika tidak, akan diabaikan).
Tag:host_machine_resource_optimizations
,execution
--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
--strategy=<a '[name=]value1[,..,valueN]' assignment>
beberapa penggunaan diakumulasikan-
Tentukan cara mendistribusikan kompilasi tindakan turunan 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
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
beberapa penggunaan diakumulasikan-
Mengganti strategi spawn yang harus digunakan untuk mengeksekusi tindakan spawn yang memiliki deskripsi yang cocok dengan regex_filter tertentu. Lihat --per_file_copt untuk mengetahui detail tentang pencocokan regex_filter. regex_filter pertama 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
--worker_extra_flag=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan-
Flag perintah tambahan yang akan diteruskan ke proses pekerja selain --persistent_worker, yang dikunci oleh mnemonik (misalnya, --worker_extra_flag=Javac=--debug.
Tag:execution
,host_machine_resource_optimizations
--worker_max_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
beberapa penggunaan diakumulasikan-
Jumlah instance proses pekerja (seperti compiler Java persisten) yang dapat diluncurkan jika Anda menggunakan strategi 'pekerja'. Dapat ditentukan sebagai [name=value] untuk memberikan nilai yang berbeda per mnemonik pekerja. 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
--worker_max_multiplex_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
beberapa penggunaan diakumulasikan-
Jumlah WorkRequest yang dapat diterima oleh proses pekerja multiplex secara paralel jika Anda menggunakan strategi 'worker' dengan --experimental_worker_multiplex. Dapat ditentukan sebagai [name=value] untuk memberikan nilai yang berbeda per mnemonik pekerja. 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
- Default
--[no]worker_quit_after_build
: "false" -
Jika diaktifkan, semua pekerja akan keluar setelah build selesai.
Tag:execution
,host_machine_resource_optimizations
- Default
--[no]worker_sandboxing
: "false" -
Jika diaktifkan, pekerja akan dieksekusi di lingkungan sandbox.
Tag:execution
- Default
--[no]worker_verbose
: "false" - Jika diaktifkan, mencetak pesan verbose saat pekerja dimulai, dimatikan, ...
- Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
- Default
--[no]incompatible_disable_runtimes_filegroups
: "false" -
No-op yang tidak digunakan lagi.
Tag:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
--[no]incompatible_dont_emit_static_libgcc
default: "true"-
No-op yang tidak digunakan lagi.
Tag:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
--[no]incompatible_linkopts_in_user_link_flags
default: "true"-
No-op yang tidak digunakan lagi.
Tag:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
- Opsi yang mengontrol output perintah:
--[no]build
default: "true"-
Jalankan build; ini adalah perilaku 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_run_validations
default: "true"-
Gunakan --run_validations sebagai gantinya.
Tag:execution
,affects_outputs
- Default
--[no]experimental_use_validation_aspect
: "false" -
Apakah akan menjalankan tindakan validasi menggunakan aspek (untuk paralelisme dengan pengujian).
Tag:execution
,affects_outputs
--output_groups=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar nama grup output yang dipisahkan koma, yang masing-masing secara opsional diawali dengan + atau -. Grup yang diawali dengan + ditambahkan ke kumpulan grup output default, sedangkan grup yang diawali dengan - dihapus dari kumpulan 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, sedangkan --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 https://bazel.build/rules/rules#validation_actions
Tag:execution
,affects_outputs
- Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, yang memengaruhi nilainya, bukan keberadaannya:
--aspects=<comma-separated list of options>
beberapa penggunaan diakumulasikan- Daftar aspek yang dipisahkan koma 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 tingkat teratas dari file tools/my_def.bzl
- Default
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
Jumlah maksimum file terbuka yang diizinkan selama upload artefak BEP.
Tag:affects_outputs
--[no]experimental_convenience_symlinks
default: "normal"-
Flag ini mengontrol cara pengelolaan symlink praktis (symlink yang muncul di ruang kerja setelah build). 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 diubah.
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
- Default
--[no]experimental_convenience_symlinks_bep_event
: "false" -
Flag ini mengontrol apakah kita akan memposting build eventConvenienceSymlinksIdentified ke BuildEventProtocol atau tidak. Jika nilainya benar (true), BuildEventProtocol akan memiliki entri untuk convenienceSymlinksIdentified, yang mencantumkan semua symlink praktis yang dibuat di ruang kerja Anda. Jika salah (false), entri convenienceSymlinksIdentified di BuildEventProtocol akan kosong.
Tag:affects_outputs
--experimental_multi_cpu=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Tidak digunakan lagi. No-op.
Tags:affects_outputs
,experimental
--remote_download_minimal
-
Tidak mendownload output build jarak jauh ke komputer lokal. Flag ini adalah pintasan untuk flag: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata, dan --remote_download_outputs=minimal.
Meluas menjadi:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
Tag:affects_outputs
- Default
--remote_download_outputs=<all, minimal or toplevel>
: "all" -
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', kecuali juga mendownload output target tingkat teratas ke komputer lokal. Kedua opsi ini dapat mengurangi waktu build secara signifikan jika bandwidth jaringan menjadi hambatan.
Tag:affects_outputs
--remote_download_symlink_template=<a string>
default: ""-
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 tingkat teratas ke komputer lokal. Flag ini adalah pintasan untuk flag: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata, dan --remote_download_outputs=toplevel.
Meluas menjadi:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
Tag:affects_outputs
--symlink_prefix=<a string>
default: lihat deskripsi-
Awalan yang ditambahkan ke salah satu symlink praktis yang dibuat setelah build. Jika tidak disertakan, nilai defaultnya adalah nama alat build yang 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.):
- Default
--[no]experimental_docker_privileged
: "false" -
Jika diaktifkan, Bazel akan meneruskan tanda --privileged ke 'docker run' saat menjalankan tindakan. Hal ini mungkin diperlukan oleh build Anda, tetapi juga dapat mengurangi keakuratan.
Tag:execution
--experimental_repository_hash_file=<a string>
default: ""-
Jika tidak kosong, menentukan file yang berisi nilai yang telah diselesaikan, yang akan digunakan untuk memverifikasi hash direktori repositori
Tag:affects_outputs
,experimental
- Default
--[no]experimental_sandboxfs_map_symlink_targets
: "false" -
Jika benar (true), memetakan target link simbolis yang ditentukan sebagai input tindakan ke sandbox. Fitur ini ada semata-mata untuk mengatasi aturan yang bermasalah yang tidak melakukannya sendiri dan harus dihapus setelah semua aturan tersebut diperbaiki.
Tag:host_machine_resource_optimizations
,execution
--experimental_verify_repository_rules=<a string>
beberapa penggunaan diakumulasikan-
Jika daftar aturan repositori yang hash direktori outputnya harus diverifikasi, asalkan file ditentukan oleh --experimental_repository_hash_file.
Tag:affects_outputs
,experimental
--[no]incompatible_legacy_local_fallback
default: "true"-
Jika disetel ke benar (true), mengaktifkan penggantian implisit lama dari strategi lokal ke sandbox. Pada akhirnya, tanda ini akan menjadi salah (false) secara default, lalu menjadi tidak beroperasi (no-op). Gunakan --strategy, --spawn_strategy, atau --dynamic_local_strategy untuk mengonfigurasi penggantian.
Tag:execution
,incompatible_change
--sandbox_add_mount_pair=<a single path or a 'source:target' pair>
beberapa penggunaan diakumulasikan-
Tambahkan pasangan jalur tambahan untuk dipasang di sandbox.
Tag:execution
--sandbox_block_path=<a string>
beberapa penggunaan diakumulasikan-
Untuk tindakan sandbox, jangan izinkan akses ke jalur ini.
Tag:execution
--[no]sandbox_default_allow_network
default: "true"- Izinkan akses jaringan secara default untuk tindakan; hal ini mungkin tidak berfungsi dengan semua penerapan sandbox.
- Default
--[no]sandbox_fake_hostname
: "false" -
Mengubah nama host saat ini menjadi 'localhost' untuk tindakan sandbox.
Tag:execution
- Default
--[no]sandbox_fake_username
: "false" -
Ubah nama pengguna saat ini menjadi 'nobody' untuk tindakan sandbox.
Tag:execution
--sandbox_writable_path=<a string>
beberapa penggunaan diakumulasikan-
Untuk tindakan kotak pasir, buat direktori yang ada dapat ditulis di kotak pasir (jika didukung oleh penerapan kotak pasir, diabaikan jika tidak).
Tag:execution
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
default: "true"-
No-op
Tag:no_op
,deprecated
,experimental
- Default
--[no]incompatible_config_setting_private_default_visibility
: "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:
- Default
--[no]check_tests_up_to_date
: "false" -
Jangan jalankan pengujian, cukup periksa apakah sudah diupdate. 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
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
beberapa penggunaan diakumulasikan-
Setiap pengujian akan dicoba 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 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
- Default
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Jumlah maksimum tugas pengujian lokal yang akan 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 bersamaan. Menetapkan nilai ini lebih besar dari nilai untuk --jobs tidak akan berpengaruh.
Tag:execution
--[no]test_keep_going
default: "true"-
Jika dinonaktifkan, setiap pengujian yang tidak lulus akan menyebabkan seluruh build berhenti. Secara default, semua pengujian dijalankan, meskipun beberapa 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 oleh 'bazel test'.
- Opsi yang terkait dengan output dan semantik Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan ditarik di registry tempat modul tersebut berasal (jika modul tersebut tidak berasal dari NonRegistryOverride). Jika tidak, versi yang dibatalkan akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang diizinkan untuk dibatalkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel 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
- Default
--check_direct_dependencies=<off, warning or error>
: "warning" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di 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 meningkatkan ketidakcocokan menjadi kegagalan penyelesaian.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "nonaktif"-
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan memperbaruinya jika ada perubahan, `error` untuk menggunakan file kunci tetapi menampilkan error jika file tersebut tidak terbaru, atau `off` agar tidak membaca dari atau menulis ke file kunci.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut 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`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari terlebih dahulu di registry awal, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry awal.
Tag:changes_inputs
- Opsi yang memengaruhi kejelasan, format, atau lokasi logging:
- Default
--[no]announce
: "false" -
Tidak digunakan lagi. No-op.
Tag:affects_outputs
- Default
--[no]debug_spawn_scheduler
: "false" - Default
--[no]experimental_bep_target_summary
: "false" - Apakah akan memublikasikan peristiwa TargetSummary.
- Default
--[no]experimental_build_event_expand_filesets
: "false" -
Jika benar, luaskan Kumpulan File di BEP saat menampilkan file output.
Tag:affects_outputs
- Default
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: "false" -
Jika benar (true), selesaikan sepenuhnya link simbolis Fileset relatif di BEP saat menampilkan file output. Memerlukan --experimental_build_event_expand_filesets.
Tag:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
default: "4"-
Jumlah maksimum percobaan ulang yang harus dilakukan Bazel saat mengupload peristiwa build.
Tag:bazel_internal_configuration
- Default
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1 detik" -
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.
Tag:affects_outputs
--[no]experimental_collect_local_sandbox_action_metrics
default: "true"-
Jika diaktifkan, statistik eksekusi (seperti waktu pengguna dan sistem) dicatat untuk tindakan yang dieksekusi secara lokal yang menggunakan sandbox
Tag:execution
- Default
--[no]experimental_docker_verbose
: "false" -
Jika diaktifkan, Bazel akan mencetak pesan yang lebih panjang tentang strategi sandbox Docker.
Tag:execution
- Default
--[no]experimental_materialize_param_files_directly
: "false" -
Jika mematerialisasi file param, lakukan dengan penulisan langsung ke disk.
Tag:execution
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dijalankan terbesar. Menetapkan opsi ini akan menulis statistik untuk semua mnemonik.
--experimental_repository_resolved_file=<a string>
default: ""-
Jika tidak kosong, tulis nilai Starlark dengan informasi yang telah diselesaikan dari semua aturan repositori Starlark yang dieksekusi.
Tag:affects_outputs
- Default
--[no]experimental_stream_log_file_uploads
: "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: "true"-
Gunakan ini untuk menekan pembuatan kolom important_outputs lama di peristiwa TargetComplete. important_outputs diperlukan untuk integrasi Bazel ke ResultStore.
Tag:affects_outputs
- Default
--[no]materialize_param_files
: "false" -
Menulis file parameter perantara ke struktur output meskipun menggunakan eksekusi tindakan jarak jauh. Berguna saat men-debug tindakan. Hal ini tersirat oleh --subcommands dan --verbose_failures.
Tag:execution
- Default
--max_config_changes_to_show=<an integer>
: "3" -
Saat menghapus cache analisis karena perubahan pada opsi build, 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
- Default
--max_test_output_bytes=<an integer>
: "-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 peringatan untuk aturan dengan nama yang cocok dengan ekspresi reguler yang diberikan.
Tag:affects_outputs
- Default
--progress_report_interval=<an integer in 0-3600 range>
: "0" -
Jumlah detik 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 akan dilaporkan setiap detik.
Tag:affects_outputs
- Default
--remote_print_execution_messages=<failure, success or all>
: "failure" -
Pilih waktu untuk mencetak pesan eksekusi jarak jauh. Nilai yang valid adalah `failure` untuk mencetak hanya pada kegagalan, `success` untuk mencetak hanya pada keberhasilan, dan `all` untuk selalu mencetak.
Tag:terminal_output
- Default
--[no]sandbox_debug
: "false" -
Mengaktifkan fitur proses debug untuk fitur sandbox. Hal ini mencakup dua hal: pertama, konten root sandbox dibiarkan tidak berubah setelah build (dan jika sandboxfs digunakan, sistem file dibiarkan ter-mount); 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
- Default
--show_result=<an integer>
: "1" -
Tampilkan hasil build. Untuk setiap target, nyatakan apakah target tersebut telah diupdate 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, yang merupakan jumlah target minimum yang jika terlampaui, informasi hasil tidak akan dicetak. Jadi, nol menyebabkan penekanan pesan dan MAX_INT menyebabkan hasil selalu dicetak. Defaultnya adalah satu.
Tag:affects_outputs
--[no]subcommands
[-s
] default: "false"-
Menampilkan subperintah yang dieksekusi selama build. Flag terkait: --execution_log_json_file, --execution_log_binary_file (untuk mencatat subperintah ke file dalam format yang kompatibel dengan alat).
Tag:terminal_output
- Default
--test_output=<summary, errors, all or streamed>
: "summary" -
Menentukan mode output yang diinginkan. Nilai yang valid adalah 'summary' untuk menampilkan hanya ringkasan status pengujian, 'errors' untuk juga mencetak log pengujian untuk pengujian yang gagal, 'all' untuk mencetak log untuk semua pengujian, dan 'streamed' untuk menampilkan log untuk semua pengujian secara real time (tindakan ini akan memaksa pengujian dijalankan secara lokal satu per satu, terlepas dari nilai --test_strategy).
Tag:test_runner
,terminal_output
,execution
--test_summary=<short, terse, detailed, none or testcase>
default: "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
- Default
--[no]verbose_explanations
: "false" -
Meningkatkan panjang penjelasan yang diberikan jika --explain diaktifkan. Tidak berpengaruh jika --explain tidak diaktifkan.
Tag:affects_outputs
- Default
--[no]verbose_failures
: "false" -
Jika perintah gagal, cetak command line lengkap.
Tag:terminal_output
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--aspects_parameters=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan-
Menentukan nilai parameter aspek command line. Setiap nilai parameter ditentukan melalui <param_name>=<param_value>, misalnya 'my_param=my_val' dengan 'my_param' adalah parameter dari beberapa aspek dalam daftar --aspects atau diperlukan oleh aspek dalam daftar. Opsi ini dapat digunakan beberapa kali. Namun, Anda tidak diizinkan menetapkan nilai ke parameter yang sama lebih dari sekali.
Tag:loading_and_analysis
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika tidak kosong, baca file yang telah diselesaikan yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
--target_pattern_file=<a string>
default: ""-
Jika disetel, build akan membaca pola dari file yang diberi nama 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 pemutus sirkuit. Strategi yang tersedia adalah "kegagalan". Jika nilai opsi tidak valid, perilakunya sama seperti jika opsi tidak ditetapkan.
Tag:execution
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali 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.
- Default
--[no]experimental_guard_against_concurrent_changes
: "false" - Nonaktifkan opsi ini untuk menonaktifkan pemeriksaan ctime file input tindakan sebelum menguploadnya ke cache jarak jauh. Mungkin ada kasus saat kernel Linux menunda penulisan file, yang dapat menyebabkan positif palsu.
- Default
--experimental_remote_build_event_upload=<all or minimal>
: "all" - 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 'all'.
- Default
--[no]experimental_remote_cache_async
: "false" - Jika benar, I/O cache jarak jauh akan terjadi di latar belakang, bukan sebagai bagian dari proses spawn.
- Default
--[no]experimental_remote_cache_compression
: "false" - Jika diaktifkan, kompres/dekompresi blob cache dengan zstd.
- Default
--experimental_remote_cache_eviction_retries=<an integer>
: "0" -
Jumlah maksimum upaya percobaan ulang jika build mengalami error penghapusan cache jarak jauh. Nilai selain nol akan secara implisit menyetel --incompatible_remote_use_new_exit_code_for_lost_inputs ke benar (true). ID pemanggilan baru akan dibuat untuk setiap percobaan. Jika Anda membuat ID pemanggilan dan memberikannya ke Bazel dengan --invocation_id, Anda tidak boleh menggunakan tanda ini. Sebagai gantinya, tetapkan tanda --incompatible_remote_use_new_exit_code_for_lost_inputs dan periksa kode keluar 39.
Tag:execution
--experimental_remote_capture_corrupted_outputs=<a path>
default: lihat deskripsi- Jalur ke direktori tempat output yang rusak akan diambil.
- Default
--[no]experimental_remote_discard_merkle_trees
: "false" - Jika disetel ke benar (true), buang 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 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
- Default
--[no]experimental_remote_downloader_local_fallback
: "false" - Apakah akan kembali ke downloader lokal jika downloader jarak jauh gagal.
- Default
--[no]experimental_remote_execution_keepalive
: "false" - Apakah akan menggunakan keep-alive untuk panggilan eksekusi jarak jauh.
- Default
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
: "10" -
Menetapkan jumlah tingkat kegagalan yang diizinkan dalam persentase untuk jangka waktu tertentu setelah itu berhenti memanggil cache/pelaksana jarak jauh. Secara default, nilainya adalah 10. Jika disetel ke 0, tidak ada batasan.
Tag:execution
- Default
--experimental_remote_failure_window_interval=<An immutable length of time.>
: "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 satuan tidak disertakan, nilai akan ditafsirkan sebagai detik.
Tag:execution
- Default
--[no]experimental_remote_mark_tool_inputs
: "false" - Jika disetel ke benar (true), Bazel akan menandai input sebagai input alat untuk eksekutor jarak jauh. Hal ini dapat digunakan untuk menerapkan pekerja persisten jarak jauh.
- Default
--[no]experimental_remote_merkle_tree_cache
: "false" - Jika disetel ke benar (true), perhitungan pohon Merkle akan di-memoize untuk meningkatkan kecepatan pemeriksaan hit cache jarak jauh. Jejak memori cache dikontrol oleh --experimental_remote_merkle_tree_cache_size.
- Default
--experimental_remote_merkle_tree_cache_size=<a long integer>
: "1000" - Jumlah pohon Merkle yang akan di-memoize untuk meningkatkan kecepatan pemeriksaan hit cache jarak jauh. Meskipun cache dipangkas secara otomatis sesuai dengan penanganan referensi lemah Java, error kehabisan memori dapat terjadi jika ditetapkan terlalu tinggi. Jika disetel ke 0, ukuran cache tidak terbatas. Nilai optimal bervariasi bergantung pada ukuran project. Default-nya adalah 1.000.
- Default
--[no]experimental_remote_require_cached
: "false" - Jika disetel ke benar (true), pastikan semua tindakan yang dapat dijalankan dari jarak jauh di-cache, atau build akan gagal. 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.
- Default
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "false" - Jika disetel ke benar (true), output yang dirujuk oleh BEP tidak diupload ke cache jarak jauh jika tindakan pembuatan tidak dapat di-cache dari jarak jauh.
--[no]incompatible_remote_downloader_send_all_headers
default: "true"-
Apakah akan mengirim semua nilai header multinilai ke downloader jarak jauh, bukan hanya yang pertama.
Tag:incompatible_change
- Default
--[no]incompatible_remote_output_paths_relative_to_input_root
: "false" -
Jika disetel ke benar (true), jalur output bersifat relatif terhadap root input, bukan direktori kerja.
Tag:incompatible_change
--[no]incompatible_remote_results_ignore_disk
default: "true"-
Jika disetel ke benar, --noremote_upload_local_results dan --noremote_accept_cached tidak akan berlaku untuk cache disk. Jika cache gabungan digunakan:
--noremote_upload_local_results akan menyebabkan hasil ditulis ke cache disk, tetapi tidak diupload ke cache jarak jauh.
--noremote_accept_cached akan menyebabkan Bazel memeriksa hasil di cache disk, tetapi tidak di cache jarak jauh.
Tindakan no-remote-exec dapat mengakses cache disk.
Lihat #8216 untuk mengetahui detailnya.
Tag:incompatible_change
- Default
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
: "false" -
Jika disetel ke benar (true), Bazel akan menggunakan kode keluar baru 39, bukan 34, jika cache jarak jauh mengeluarkan blob selama build.
Tag:incompatible_change
--[no]remote_accept_cached
default: "true"- Apakah akan menerima hasil tindakan yang di-cache dari jarak jauh.
--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
--remote_cache_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan- Tentukan header yang akan disertakan dalam permintaan cache: --remote_cache_header=Name=Value. Beberapa header dapat diteruskan dengan menentukan tanda beberapa kali. Beberapa nilai untuk nama yang sama akan dikonversi menjadi daftar yang dipisahkan koma.
--remote_default_exec_properties=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan-
Menetapkan properti exec default yang akan digunakan sebagai platform eksekusi jarak jauh jika platform eksekusi belum menetapkan exec_properties.
Tag:affects_outputs
--remote_default_platform_properties=<a string>
default: ""- Menetapkan properti platform default yang akan ditetapkan untuk API eksekusi jarak jauh, jika platform eksekusi belum menetapkan remote_execution_properties. Nilai ini juga akan digunakan jika platform host dipilih sebagai platform eksekusi untuk eksekusi jarak jauh.
--remote_downloader_header=<a 'name=value' assignment>
beberapa penggunaan 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.
--remote_exec_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan- Tentukan header yang akan disertakan dalam permintaan eksekusi: --remote_exec_header=Name=Value. Beberapa header dapat diteruskan dengan menentukan tanda beberapa kali. Beberapa nilai untuk nama yang sama akan dikonversi menjadi daftar yang dipisahkan koma.
- Default
--remote_execution_priority=<an integer>
: "0" - Prioritas relatif tindakan yang akan 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).
--remote_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan- Tentukan header yang akan disertakan dalam permintaan: --remote_header=Name=Value. Beberapa header dapat diteruskan dengan menentukan 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.
- Default
--[no]remote_local_fallback
: "false" - Apakah akan beralih kembali ke strategi eksekusi lokal mandiri jika eksekusi jarak jauh gagal.
- Default
--remote_local_fallback_strategy=<a string>
: "local" - No-op, tidak digunakan lagi. Lihat https://github.com/bazelbuild/bazel/issues/7480 untuk mengetahui detailnya.
- Default
--remote_max_connections=<an integer>
: "100" -
Batasi jumlah maksimum koneksi serentak ke cache/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/executor jarak jauh gRPC, satu saluran gRPC biasanya dapat menangani 100+ permintaan serentak, sehingga Bazel dapat membuat sekitar `--remote_max_connections * 100` permintaan serentak.
Tag:host_machine_resource_optimizations
--remote_proxy=<a string>
default: lihat deskripsi- Hubungkan ke cache jarak jauh melalui proxy. Saat ini, tanda ini hanya dapat digunakan untuk mengonfigurasi soket domain Unix (unix:/path/to/socket).
- Default
--remote_result_cache_priority=<an integer>
: "0" - Prioritas relatif tindakan jarak jauh yang akan disimpan 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 satuan tidak disertakan, nilai akan ditafsirkan sebagai detik.
- Default
--remote_timeout=<An immutable length of time.>
: "60s" - Jumlah waktu maksimum untuk menunggu panggilan cache dan eksekusi jarak jauh. 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 satuan 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)'.
- Default
--[no]build_manual_tests
: "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 secara opsional 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'
- Default
--[no]build_tests_only
: "false" - Jika ditentukan, hanya aturan *_test dan test_suite yang akan dibuat dan target lain yang ditentukan di command line akan diabaikan. Secara default, semua yang diminta akan dibuat.
- Default
--combined_report=<none or lcov>
: "none" - Menentukan jenis laporan cakupan kumulatif yang diinginkan. Saat ini, hanya LCOV yang didukung.
- Default
--[no]compile_one_dependency
: "false" - 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.
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
beberapa penggunaan diakumulasikan- Mengonfigurasi helper kredensial yang akan digunakan untuk 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 https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md untuk mengetahui detailnya.
- Default
--credential_helper_cache_duration=<An immutable length of time.>
: "30m" - Durasi kredensial yang disediakan oleh helper kredensial di-cache. Memanggil dengan nilai yang berbeda akan menyesuaikan masa aktif entri yang sudah ada; teruskan nol untuk menghapus cache. Perintah clean selalu menghapus cache, terlepas dari tanda ini.
--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.
--deleted_packages=<comma-separated list of package names>
default: ""- 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.
- Default
--[no]discard_analysis_cache
: "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 Spawn yang dibatasi, sesuai dengan src/main/protobuf/spawn.proto. Log pertama-tama ditulis tanpa diurutkan, lalu di akhir pemanggilan, diurutkan dalam urutan yang stabil (dapat menggunakan banyak CPU dan memori). Flag terkait: --execution_log_json_file (format json teks yang diurutkan), --experimental_execution_log_file (format protobuf biner yang tidak diurutkan), --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 dari proto Spawn yang dibatasi, sesuai dengan src/main/protobuf/spawn.proto. Log pertama-tama ditulis tanpa diurutkan, lalu di akhir pemanggilan, diurutkan dalam urutan yang stabil (dapat menggunakan banyak CPU dan memori). Flag terkait: Flag terkait: --execution_log_binary_file (format protobuf biner yang diurutkan), --experimental_execution_log_file (format protobuf biner yang tidak diurutkan), --subcommands (untuk menampilkan subperintah dalam output terminal).
--[no]execution_log_sort
default: "true"- Apakah akan mengurutkan log eksekusi. Setel ke false untuk meningkatkan performa memori, dengan mengorbankan pembuatan log dalam urutan non-deterministik.
--[no]expand_test_suites
default: "true"-
Perluas target test_suite menjadi pengujian konstituennya 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_execution_log_file=<a path>
default: lihat deskripsi- Mencatat spawn yang dieksekusi ke dalam file ini sebagai proto Spawn yang dibatasi, sesuai dengan src/main/protobuf/spawn.proto. File ini ditulis sesuai urutan eksekusi Spawns. Flag terkait: --execution_log_binary_file (format protobuf biner yang diurutkan), --execution_log_json_file (format json teks yang diurutkan), --subcommands (untuk menampilkan subperintah dalam output terminal).
- Default
--[no]experimental_execution_log_spawn_metrics
: "false" - Sertakan metrik spawn dalam log spawn yang dieksekusi.
--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.
- Default
--[no]experimental_extra_action_top_level_only
: "false" - Tidak digunakan lagi dan digantikan dengan aspek. Hanya menjadwalkan extra_actions untuk target tingkat teratas.
--[no]experimental_prioritize_local_actions
default: "true"-
Jika disetel, tindakan yang hanya dapat dijalankan secara lokal akan diberi kesempatan pertama untuk mendapatkan resource, pekerja yang dijalankan secara dinamis akan mendapatkan kesempatan kedua, dan tindakan mandiri yang dijalankan secara dinamis akan mendapatkan kesempatan terakhir.
Tag:execution
--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
--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.
- Default
--[no]google_default_credentials
: "false" - Apakah akan menggunakan 'Kredensial Default Aplikasi Google' untuk autentikasi. Lihat https://cloud.google.com/docs/authentication untuk mengetahui detailnya. Dinonaktifkan secara default.
--grpc_keepalive_time=<An immutable length of time.>
default: lihat deskripsi- 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. Waktu diperlakukan sebagai perincian detik; error jika menetapkan nilai kurang dari satu detik. Secara default, ping keep-alive dinonaktifkan. Anda harus berkoordinasi dengan pemilik layanan sebelum mengaktifkan setelan ini. Misalnya, untuk menetapkan nilai 30 detik ke tanda ini, Anda harus melakukannya seperti ini --grpc_keepalive_time=30s
- Default
--grpc_keepalive_timeout=<An immutable length of time.>
: "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 balasan ping setelah jangka waktu ini. Waktu diperlakukan sebagai perincian detik; error jika menetapkan nilai kurang dari satu detik. Jika ping tetap aktif dinonaktifkan, setelan ini akan diabaikan.
- Default
--[no]ignore_unsupported_sandboxing
: "false" - Jangan mencetak peringatan jika eksekusi dalam sandbox tidak didukung di sistem ini.
- Default
--[no]incompatible_dont_use_javasourceinfoprovider
: "false" -
No-op
Tag:incompatible_change
- Default
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
: "HOST_CPUS" - Tetapkan secara eksplisit jumlah total core CPU lokal yang tersedia untuk Bazel yang akan digunakan pada tindakan build yang dieksekusi secara lokal. Mengambil bilangan bulat, atau "HOST_CPUS", yang secara opsional diikuti dengan [-|*]<float> (mis. HOST_CPUS*.5 untuk menggunakan setengah dari core CPU yang tersedia).Secara default, ("HOST_CPUS"), Bazel akan mengkueri konfigurasi sistem untuk memperkirakan jumlah core CPU yang tersedia.
--local_extra_resources=<a named float, 'name=value'>
beberapa penggunaan diakumulasikan- Tetapkan jumlah resource tambahan yang tersedia untuk Bazel. Menerima pasangan string-float. Dapat digunakan beberapa kali untuk menentukan beberapa jenis resource tambahan. Bazel akan membatasi tindakan yang berjalan secara serentak berdasarkan resource tambahan yang tersedia dan resource tambahan yang diperlukan. Pengujian dapat mendeklarasikan jumlah resource tambahan yang dibutuhkan dengan menggunakan tag berformat "resources:<resoucename>:<amount>". CPU, RAM, dan resource yang tersedia tidak dapat ditetapkan dengan tanda ini.
- Default
--local_ram_resources=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "HOST_RAM*.67" - Tetapkan secara eksplisit jumlah total RAM host lokal (dalam MB) yang tersedia untuk Bazel untuk dibelanjakan pada tindakan build yang dieksekusi secara lokal. Mengambil bilangan bulat, atau "HOST_RAM", yang secara opsional diikuti dengan [-|*]<float> (mis. HOST_RAM*.5 untuk menggunakan setengah RAM yang tersedia). Secara default, ("HOST_RAM*.67"), Bazel akan membuat kueri konfigurasi sistem untuk memperkirakan jumlah RAM yang tersedia dan akan menggunakan 67% dari jumlah tersebut.
- Default
--local_termination_grace_seconds=<an integer>
: "15" - Waktu tunggu antara menghentikan proses lokal karena waktu tunggu habis dan mematikannya secara paksa.
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan 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`
- Default
--package_path=<colon-separated list of options>
: "%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 akan ditemukan yang berisi setidaknya satu ukuran yang disertakan dan tidak berisi ukuran yang dikecualikan. Opsi ini memengaruhi perilaku --build_tests_only dan perintah pengujian.
--test_tag_filters=<comma-separated list of options>
default: ""- Menentukan daftar tag pengujian yang dipisahkan koma. Setiap tag dapat secara opsional 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.
--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.
--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 contohnya.
- Opsi yang mengontrol eksekusi build:
- Default
--[no]check_up_to_date
: "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
--[no]experimental_inprocess_symlink_creation
: "false" -
Apakah akan melakukan panggilan sistem file langsung untuk membuat struktur symlink
Tag:loading_and_analysis
,execution
,experimental
- Default
--[no]experimental_remotable_source_manifests
: "false" -
Apakah akan membuat tindakan manifes sumber dapat dilakukan dari jarak jauh
Tag:loading_and_analysis
,execution
,experimental
- Default
--[no]experimental_split_coverage_postprocessing
: "false" -
Jika benar (true), Bazel akan menjalankan pasca-pemrosesan cakupan untuk pengujian di proses baru.
Tag:execution
--[no]experimental_split_xml_generation
default: "true"-
Jika tanda ini disetel, dan tindakan pengujian tidak menghasilkan file test.xml, Bazel akan menggunakan tindakan terpisah untuk menghasilkan file test.xml dummy yang berisi log pengujian. Jika tidak, Bazel akan membuat test.xml sebagai bagian dari tindakan pengujian.
Tag:execution
- Default
--[no]experimental_strict_fileset_output
: "false" -
Jika opsi ini diaktifkan, kumpulan file akan memperlakukan semua artefak output sebagai file reguler. File tersebut tidak akan melintasi direktori atau peka terhadap symlink.
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
--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
- Default
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Jumlah thread paralel yang akan digunakan untuk fase pemuatan/analisis.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
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
default: ""-
Menambahkan atau menghapus kunci dari info eksekusi tindakan berdasarkan mnemonik tindakan. Hanya berlaku untuk tindakan yang mendukung info eksekusi. Banyak tindakan umum 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.
Diperluas menjadi:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Tag:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Aktifkan pemroses resource Android persisten menggunakan pekerja.
Diperluas menjadi:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
Tag:
host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Aktifkan tindakan dex dan desugar Android multiplex persisten menggunakan pekerja.
Diperluas menjadi:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Tag:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Aktifkan pemroses resource Android multiplex persisten dengan menggunakan pekerja.
Diperluas menjadi:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Tag:
host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Aktifkan alat Android persisten dan multiplex (dexing, desugaring, pemrosesan resource).
Diperluas menjadi:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Tag:host_machine_resource_optimizations
,execution
--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
--strategy=<a '[name=]value1[,..,valueN]' assignment>
beberapa penggunaan diakumulasikan-
Tentukan cara mendistribusikan kompilasi tindakan turunan 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
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
beberapa penggunaan diakumulasikan-
Mengganti strategi spawn yang harus digunakan untuk mengeksekusi tindakan spawn yang memiliki deskripsi yang cocok dengan regex_filter tertentu. Lihat --per_file_copt untuk mengetahui detail tentang pencocokan regex_filter. regex_filter pertama 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
- Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
--android_compiler=<a string>
default: lihat deskripsi-
Compiler target Android.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
default: "//external:android/crosstool"-
Lokasi compiler C++ yang digunakan untuk build Android.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
default: lihat deskripsi-
Target Android grte_top.
Tag:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Default
--android_manifest_merger=<legacy, android or force_android>
: "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
--android_sdk=<a build target label>
default: "@bazel_tools//tools/android:sdk"-
Menentukan SDK/platform Android yang digunakan untuk membuat aplikasi Android.
Tag:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_compiler=<a string>
default: lihat deskripsi-
Compiler target Apple. Berguna untuk memilih varian toolchain (misalnya, xcode-beta).
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
default: "@bazel_tools//tools/cpp:toolchain"-
Label paket crosstool yang akan digunakan dalam aturan Apple dan Objc serta dependensinya.
Tag:loses_incremental_state
,changes_inputs
--apple_grte_top=<a build target label>
default: lihat deskripsi-
Target Apple grte_top.
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
,explicit_in_output_path
--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. Saat ini, ini harus berupa grup file yang berisi satu file, yaitu biner. Nilai defaultnya adalah '//tools/test:lcov_merger'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
default: "@bazel_tools//tools/test:coverage_report_generator"-
Lokasi biner yang digunakan untuk membuat laporan cakupan. Saat ini, ini harus berupa grup file yang berisi satu file, yaitu biner. Defaultnya adalah '//tools/test:coverage_report_generator'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
default: "@bazel_tools//tools/test:coverage_support"-
Lokasi file pendukung yang diperlukan pada input setiap tindakan pengujian yang mengumpulkan cakupan kode. Nilai defaultnya adalah '//tools/test:coverage_support'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
default: "@bazel_tools//tools/cpp:toolchain"-
Label paket crosstool yang akan digunakan untuk mengompilasi kode C++.
Tag:loading_and_analysis
,changes_inputs
,affects_outputs
--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
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
beberapa penggunaan diakumulasikan-
Daftar ekspresi reguler yang dipisahkan koma, yang masing-masing secara opsional diawali dengan - (ekspresi negatif), ditetapkan (=) ke daftar target nilai batasan yang dipisahkan koma. Jika target tidak cocok dengan ekspresi negatif dan cocok dengan setidaknya satu ekspresi positif, resolusi toolchain-nya akan dilakukan seolah-olah target telah menyatakan nilai batasan sebagai batasan eksekusi. Contoh: //demo,-test=@platforms//cpus:x86_64 akan menambahkan 'x86_64' ke target apa pun di bagian //demo, kecuali target yang namanya berisi 'test'.
Tag:loading_and_analysis
--[no]experimental_enable_objc_cc_deps
default: "true"-
Memungkinkan aturan objc_* bergantung pada cc_library dan menyebabkan dependensi objc apa pun dibangun dengan --cpu yang ditetapkan ke "ios_<--ios_cpu>" untuk nilai apa pun di --ios_multi_cpu.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]experimental_include_xcode_execution_requirements
: "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
--[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
--extra_execution_platforms=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
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().
Tag:execution
--extra_toolchains=<comma-separated list of options>
beberapa penggunaan 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 ke library libc yang di-check in. Nilai default dipilih oleh toolchain crosstool, dan Anda hampir tidak perlu menggantinya.
Tag:action_command_lines
,affects_outputs
--host_compiler=<a string>
default: lihat deskripsi-
Compiler C++ yang akan digunakan untuk kompilasi host. Argumen ini diabaikan jika --host_crosstool_top tidak ditetapkan.
Tag:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
default: lihat deskripsi-
Secara default, opsi --crosstool_top dan --compiler juga digunakan untuk konfigurasi host. Jika tanda ini diberikan, Bazel akan menggunakan libc dan compiler default untuk crosstool_top yang diberikan.
Tag:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
default: lihat deskripsi-
Jika ditentukan, setelan ini akan menggantikan direktori tingkat teratas libc (--grte_top) untuk konfigurasi host.
Tag:action_command_lines
,affects_outputs
--host_platform=<a build target label>
default: ""-
Label aturan platform yang menjelaskan sistem host.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set
default: "true"-
Jika benar (true), Bazel tidak akan mengizinkan penentuan expand_if_all_available di flag_sets (lihat https://github.com/bazelbuild/bazel/issues/7008 untuk mengetahui petunjuk migrasi).
Tag:loading_and_analysis
,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
- Default
--[no]incompatible_enable_android_toolchain_resolution
: "false" -
Gunakan penyelesaian toolchain untuk memilih Android SDK untuk aturan Android (Starlark dan native)
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_enable_apple_toolchain_resolution
: "false" -
Gunakan penyelesaian toolchain untuk memilih Apple SDK untuk aturan Apple (Starlark dan native)
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
default: "true"-
Jika benar (true), Bazel tidak akan menggunakan kembali command line tindakan link C++ untuk command line pengindeksan LTO (lihat https://github.com/bazelbuild/bazel/issues/6791 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
default: "true"-
Jika benar (true), Bazel akan menampilkan error saat atribut cc_toolchain.cpu dan cc_toolchain.compiler ditetapkan (lihat https://github.com/bazelbuild/bazel/issues/7075 untuk mengetahui petunjuk migrasi).
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
default: "true"-
Jika benar, Bazel tidak akan menautkan dependensi library sebagai seluruh arsip secara default (lihat https://github.com/bazelbuild/bazel/issues/7362 untuk mengetahui petunjuk migrasi).
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
default: "true"-
Jika benar (true), Bazel akan memerlukan parameter 'ctx' di cc_common.configure_features (lihat https://github.com/bazelbuild/bazel/issues/7793 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,incompatible_change
-
Gunakan objek bersama antarmuka jika didukung oleh toolchain. Semua toolchain ELF saat ini mendukung setelan ini.
Tag:loading_and_analysis
,affects_outputs
,affects_outputs
--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, gunakan 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 relative path>
default: ""-
Lokasi file pemetaan yang menjelaskan platform mana yang akan digunakan jika tidak ada yang ditetapkan atau flag mana yang akan ditetapkan jika platform sudah ada. Harus relatif terhadap root ruang kerja utama. Secara default adalah 'platform_mappings' (file langsung di bawah root ruang kerja).
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
default: ""-
Label aturan platform yang menjelaskan platform target untuk perintah saat ini.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
default: lihat deskripsi-
Tidak digunakan lagi, tidak ada operasi. Dinonaktifkan oleh `--incompatible_use_python_toolchains`.
Tag:no_op
,deprecated
--python3_path=<a string>
default: lihat deskripsi-
Tidak digunakan lagi, tidak ada operasi. Dinonaktifkan oleh `--incompatible_use_python_toolchains`.
Tag:no_op
,deprecated
--python_path=<a string>
default: lihat deskripsi-
Jalur absolut interpreter Python yang dipanggil untuk menjalankan target Python di platform target. Tidak digunakan lagi; dinonaktifkan oleh --incompatible_use_python_toolchains.
Tag:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
default: lihat deskripsi-
Label py_runtime yang merepresentasikan penafsir Python yang dipanggil untuk menjalankan target Python di platform target. Tidak digunakan lagi; dinonaktifkan oleh --incompatible_use_python_toolchains.
Tag:loading_and_analysis
,affects_outputs
--target_platform_fallback=<a build target label>
default: "@local_config_platform//:host"-
Label aturan platform yang harus digunakan jika tidak ada platform target yang ditetapkan dan tidak ada pemetaan platform yang cocok dengan kumpulan flag 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
--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, gunakan 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:
- Default
--[no]apple_enable_auto_dsym_dbg
: "false" -
Apakah akan memaksa mengaktifkan pembuatan file simbol debug (.dSYM) untuk build dbg.
Tag:affects_outputs
,action_command_lines
- Default
--[no]apple_generate_dsym
: "false" -
Apakah akan membuat file simbol debug (.dSYM).
Tag:affects_outputs
,action_command_lines
--[no]build
default: "true"-
Jalankan build; ini adalah perilaku 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]build_runfile_links
default: "true"-
Jika benar, bangun hutan symlink file yang dapat dijalankan untuk semua target. Jika salah (false), tulis hanya manifes jika memungkinkan.
Tag:affects_outputs
--[no]build_runfile_manifests
default: "true"-
Jika benar, tulis manifes file yang dapat dijalankan untuk semua target. Jika salah (false), hilangkan. Pengujian lokal akan gagal dijalankan jika salah (false).
Tag:affects_outputs
- Default
--[no]build_test_dwp
: "false" -
Jika diaktifkan, saat membuat pengujian C++ secara statis dan dengan fusi, file .dwp untuk biner pengujian juga akan dibuat secara otomatis.
Tag:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated list of options>
default: ".pb.h"-
Menetapkan awalan file header yang dibuat oleh cc_proto_library.
Tag:affects_outputs
,loading_and_analysis
- Default
--cc_proto_library_source_suffixes=<comma-separated list of options>
: ".pb.cc" -
Menetapkan awalan file sumber yang dibuat oleh cc_proto_library.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_proto_descriptor_sets_include_source_info
: "false" -
Menjalankan tindakan tambahan untuk versi API Java alternatif di proto_library.
Tag:affects_outputs
,loading_and_analysis
,experimental
- Default
--[no]experimental_proto_extra_actions
: "false" -
Menjalankan tindakan tambahan untuk versi API Java alternatif di proto_library.
Tag:affects_outputs
,loading_and_analysis
,experimental
--[no]experimental_run_validations
default: "true"-
Gunakan --run_validations sebagai gantinya.
Tag:execution
,affects_outputs
- Default
--[no]experimental_save_feature_state
: "false" -
Simpan status fitur yang diaktifkan dan diminta sebagai output kompilasi.
Tag:affects_outputs
,experimental
- Default
--[no]experimental_use_validation_aspect
: "false" -
Apakah akan menjalankan tindakan validasi menggunakan aspek (untuk paralelisme dengan pengujian).
Tag:execution
,affects_outputs
- Default
--fission=<a set of compilation modes>
: "no" -
Menentukan mode kompilasi mana yang menggunakan fisi untuk kompilasi dan link C++. Dapat berupa kombinasi {'fastbuild', 'dbg', 'opt'} atau nilai khusus 'yes' untuk mengaktifkan semua mode dan 'no' untuk menonaktifkan semua mode.
Tag:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
default: "true"-
Jika benar (true), aturan native akan menambahkan <code>DefaultInfo.files</code> dependensi data ke runfile-nya, yang cocok dengan perilaku yang direkomendasikan untuk aturan Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Tag:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
default: "true"-
Jika benar (true), buat hutan symlink runfile untuk repositori eksternal di bawah .runfiles/wsname/external/repo (selain .runfiles/repo).
Tag:affects_outputs
- Default
--[no]objc_generate_linkmap
: "false" -
Menentukan apakah akan membuat file linkmap.
Tag:affects_outputs
--output_groups=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar nama grup output yang dipisahkan koma, yang masing-masing secara opsional diawali dengan + atau -. Grup yang diawali dengan + ditambahkan ke kumpulan grup output default, sedangkan grup yang diawali dengan - dihapus dari kumpulan 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, sedangkan --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 https://bazel.build/rules/rules#validation_actions
Tag:execution
,affects_outputs
- Default
--[no]save_temps
: "false" -
Jika disetel, output sementara dari gcc akan disimpan. Ini mencakup file .s (kode assembler), file .i (C yang telah diproses awal), dan file .ii (C++ yang telah diproses awal).
Tag:affects_outputs
- Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, yang memengaruhi nilainya, bukan keberadaannya:
--action_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi target. Variabel dapat ditentukan berdasarkan nama, yang dalam hal ini nilainya akan diambil dari lingkungan pemanggilan, atau berdasarkan pasangan nama=nilai yang menetapkan nilai secara terpisah dari lingkungan pemanggilan. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru yang akan berlaku, opsi untuk variabel yang berbeda akan terakumulasi.
Tag:action_command_lines
--android_cpu=<a string>
default: "armeabi-v7a"-
CPU target Android.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--[no]android_databinding_use_androidx
: "false" -
Buat file data binding yang kompatibel dengan AndroidX. Ini hanya digunakan dengan databinding v2.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]android_databinding_use_v3_4_args
: "false" -
Gunakan pengikatan data Android v2 dengan argumen 3.4.0
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
- Default
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "alphabetical" (alfabetis) -
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
- Default
--[no]android_resource_shrinking
: "false" -
Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.
Tag:affects_outputs
,loading_and_analysis
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, visionos, watchos, tvos, macos or catalyst>
beberapa penggunaan diakumulasikan-
Tentukan mode bitcode Apple untuk langkah kompilasi yang menargetkan arsitektur perangkat. Nilai memiliki bentuk '[platform=]mode', dengan platform (yang harus berupa 'ios', 'macos', 'tvos', atau 'watchos') bersifat opsional. Jika disediakan, mode bitcode diterapkan khusus untuk platform tersebut; jika tidak ada, mode bitcode diterapkan untuk semua platform. Modenya harus 'none', 'embedded_markers', atau 'embedded'. Opsi ini dapat diberikan beberapa kali.
Tag:loses_incremental_state
--aspects=<comma-separated list of options>
beberapa penggunaan 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 tingkat teratas dari file tools/my_def.bzl
- Default
--[no]build_python_zip
: "auto" -
Bangun zip yang dapat dieksekusi Python; aktif di Windows, nonaktif di platform lain
Tag:affects_outputs
--catalyst_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk membangun biner Apple Catalyst.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--[no]collect_code_coverage
: "false" -
Jika ditentukan, Bazel akan melengkapi kode (menggunakan instrumentasi offline jika memungkinkan) dan akan mengumpulkan informasi cakupan selama pengujian. Hanya target yang cocok dengan --instrumentation_filter yang akan terpengaruh. Biasanya opsi ini tidak boleh ditentukan secara langsung - perintah 'bazel coverage' harus digunakan.
Tag:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] default: "fastbuild"-
Tentukan mode pembuatan biner. Nilai: 'fastbuild', 'dbg', 'opt'.
Tag:affects_outputs
,action_command_lines
,explicit_in_output_path
--conlyopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber C.
Tag:action_command_lines
,affects_outputs
--copt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc.
Tag:action_command_lines
,affects_outputs
--cpu=<a string>
default: ""-
CPU target.
Tag:changes_inputs
,affects_outputs
,explicit_in_output_path
--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
--cxxopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber C++.
Tag:action_command_lines
,affects_outputs
--define=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan-
Setiap opsi --define menentukan penetapan untuk variabel build.
Tag:changes_inputs
,affects_outputs
--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_fdo_profile_absolute_path
default: "true"-
Jika disetel, penggunaan fdo_absolute_profile_path akan menimbulkan error.
Tag:affects_outputs
- Default
--[no]enable_runfiles
: "auto" -
Aktifkan hierarki symlink runfile; Secara default, fitur ini nonaktif di Windows, dan aktif di platform lain.
Tag:affects_outputs
--experimental_action_listener=<a build target label>
beberapa penggunaan diakumulasikan-
Tidak digunakan lagi dan digantikan dengan aspek. Gunakan action_listener untuk melampirkan extra_action ke tindakan build yang ada.
Tag:execution
,experimental
- Default
--[no]experimental_android_compress_java_resources
: "false" -
Memadatkan resource Java di APK
Tag:affects_outputs
,loading_and_analysis
,experimental
- Default
--[no]experimental_android_databinding_v2
: "false" -
Menggunakan databinding v2 Android
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]experimental_android_resource_shrinking
: "false" -
Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_android_rewrite_dexes_with_rex
: "false" -
menggunakan alat rex untuk menulis ulang file dex
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]experimental_collect_code_coverage_for_generated_files
: "false" -
Jika ditentukan, Bazel juga akan membuat informasi cakupan pengumpulan untuk file yang dihasilkan.
Tag:affects_outputs
--[no]experimental_convenience_symlinks
default: "normal"-
Flag ini mengontrol cara pengelolaan symlink praktis (symlink yang muncul di ruang kerja setelah build). 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 diubah.
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
- Default
--[no]experimental_convenience_symlinks_bep_event
: "false" -
Flag ini mengontrol apakah kita akan memposting build eventConvenienceSymlinksIdentified ke BuildEventProtocol atau tidak. Jika nilainya benar (true), BuildEventProtocol akan memiliki entri untuk convenienceSymlinksIdentified, yang mencantumkan semua symlink praktis yang dibuat di ruang kerja Anda. Jika salah (false), entri convenienceSymlinksIdentified di BuildEventProtocol akan kosong.
Tag:affects_outputs
--experimental_multi_cpu=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Tidak digunakan lagi. No-op.
Tags:affects_outputs
,experimental
- Default
--experimental_objc_fastbuild_options=<comma-separated list of options>
: "-O0,-DDEBUG=1" -
Menggunakan string ini sebagai opsi compiler fastbuild objc.
Tag:action_command_lines
- Default
--[no]experimental_omitfp
: "false" -
Jika benar, gunakan libunwind untuk pelepasan stack, dan kompilasi dengan -fomit-frame-pointer dan -fasynchronous-unwind-tables.
Tag:action_command_lines
,affects_outputs
,experimental
- Default
--[no]experimental_platform_in_output_dir
: "false" -
Jika benar (true), platform target akan digunakan dalam nama direktori output, bukan CPU.
Tag:affects_outputs
,experimental
- Default
--[no]experimental_use_llvm_covmap
: "false" -
Jika ditentukan, Bazel akan membuat informasi peta cakupan llvm-cov, bukan gcov, saat collect_code_coverage diaktifkan.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--fat_apk_cpu=<comma-separated list of options>
default: "armeabi-v7a"-
Menetapkan opsi ini akan mengaktifkan fat APK, yang berisi biner native untuk semua arsitektur target yang ditentukan, misalnya, --fat_apk_cpu=x86,armeabi-v7a. Jika tanda ini ditentukan, --android_cpu akan diabaikan untuk dependensi aturan android_binary.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--[no]fat_apk_hwasan
: "false" -
Apakah akan membuat pemisahan HWASAN.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--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
--features=<a string>
beberapa penggunaan diakumulasikan-
Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi target. Menentukan -<fitur> akan menonaktifkan fitur tersebut. Fitur negatif selalu menggantikan fitur positif. Lihat juga --host_features
Tag:changes_inputs
,affects_outputs
- Default
--[no]force_pic
: "false" -
Jika diaktifkan, semua kompilasi C++ menghasilkan kode independen posisi ("-fPIC"), link lebih memilih library bawaan PIC daripada library non-PIC, dan link menghasilkan executable independen posisi ("-pie").
Tag:loading_and_analysis
,affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi host atau eksekusi. Variabel dapat ditentukan berdasarkan nama, yang dalam hal ini nilainya akan diambil dari lingkungan pemanggilan, atau berdasarkan pasangan nama=nilai yang menetapkan nilai secara terpisah dari lingkungan pemanggilan. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru yang akan berlaku, opsi untuk variabel yang berbeda akan terakumulasi.
Tag:action_command_lines
- Default
--host_compilation_mode=<fastbuild, dbg or opt>
: "opt" -
Tentukan mode alat yang digunakan selama build akan di-build. Nilai: 'fastbuild', 'dbg', 'opt'.
Tag:affects_outputs
,action_command_lines
--host_conlyopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber C untuk alat host.
Tag:action_command_lines
,affects_outputs
--host_copt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc untuk alat host.
Tag:action_command_lines
,affects_outputs
--host_cpu=<a string>
default: ""-
CPU host.
Tag:changes_inputs
,affects_outputs
--host_cxxopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc untuk alat host.
Tag:action_command_lines
,affects_outputs
--host_features=<a string>
beberapa penggunaan diakumulasikan-
Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi exec. Menentukan -<fitur> akan menonaktifkan fitur tersebut. Fitur negatif selalu menggantikan fitur positif.
Tag:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
default: lihat deskripsi-
Menggantikan versi Python untuk konfigurasi host. Dapat berupa "PY2" atau "PY3".
Tag:loading_and_analysis
,affects_outputs
--host_linkopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc saat menautkan alat host.
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
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan secara selektif ke compiler C/C++ saat mengompilasi file tertentu dalam konfigurasi host atau 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
--host_swiftcopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke swiftc untuk alat host.
Tag:action_command_lines
,affects_outputs
--[no]incompatible_avoid_conflict_dlls
default: "true"-
Jika diaktifkan, semua library yang ditautkan secara dinamis (DLL) C++ yang dihasilkan oleh cc_library di Windows akan diganti namanya menjadi name_{hash}.dll, dengan hash dihitung berdasarkan RepositoryName dan jalur paket DLL. Opsi ini berguna saat Anda memiliki satu paket yang bergantung pada beberapa cc_library dengan nama yang sama (misalnya //foo/bar1:utils dan //foo/bar2:utils).
Tag:loading_and_analysis
,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
- Default
--[no]incompatible_use_host_features
: "false" -
Jika benar (true), gunakan --features hanya untuk konfigurasi target dan --host_features untuk konfigurasi exec.
Tag:changes_inputs
,affects_outputs
,incompatible_change
--[no]incompatible_use_platforms_repo_for_constraints
default: "true"-
Jika benar (true), setelan batasan dari @bazel_tools akan dihapus.
Tag:affects_outputs
,incompatible_change
- Default
--[no]instrument_test_targets
: "false" -
Jika cakupan diaktifkan, tentukan apakah akan mempertimbangkan aturan pengujian instrumentasi. Jika ditetapkan, aturan pengujian yang disertakan oleh --instrumentation_filter akan diinstrumentasi. 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 diinstrumentasi. Aturan yang diawali dengan '-' akan dikecualikan. Perhatikan bahwa hanya aturan non-pengujian yang diinstrumentasi 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
--ios_multi_cpus=<comma-separated list of options>
beberapa penggunaan 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
--linkopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc saat menautkan.
Tag:action_command_lines
,affects_outputs
--ltobackendopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke langkah backend LTO (di bagian --features=thin_lto).
Tag:action_command_lines
,affects_outputs
--ltoindexopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke langkah pengindeksan LTO (di bagian --features=thin_lto).
Tag:action_command_lines
,affects_outputs
--macos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk membuat 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
- Default
--[no]objc_debug_with_GLIBCXX
: "false" -
Jika ditetapkan, dan mode kompilasi ditetapkan ke 'dbg', tentukan GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC, dan GLIBCPP_CONCEPT_CHECKS.
Tag:action_command_lines
- Default
--[no]objc_enable_binary_stripping
: "false" -
Apakah akan melakukan penghapusan simbol dan kode tidak terpakai pada biner yang ditautkan. Penyusutan biner akan dilakukan jika tanda ini dan --compilation_mode=opt ditentukan.
Tag:action_command_lines
--objccopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber Objective-C/C++.
Tag:action_command_lines
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk 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 dari semua file cc di //foo/ kecuali bar.cc.
Tag:action_command_lines
,affects_outputs
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk meneruskan secara selektif ke backend LTO (di bagian --features=thin_lto) saat mengompilasi objek backend tertentu. Opsi ini dapat diteruskan beberapa kali. Sintaksis: regex_filter@option_1,option_2,...,option_n. Dengan regex_filter adalah daftar pola ekspresi reguler 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 adalah 'foo -bar', dan command line eksekusinya adalah 'test_binary -baz', maka command line akhirnya adalah 'foo -bar test_binary -baz'.Ini juga dapat berupa label ke target yang dapat dieksekusi. Beberapa contohnya adalah: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Tag:action_command_lines
-
Jika benar (true), library native yang berisi fungsi identik akan dibagikan di antara target yang berbeda
Tag:loading_and_analysis
,affects_outputs
- Default
--[no]stamp
: "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
--stripopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke strip saat membuat biner '<name>.stripped'.
Tag:action_command_lines
,affects_outputs
--swiftcopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke kompilasi Swift.
Tag:action_command_lines
--symlink_prefix=<a string>
default: lihat deskripsi-
Awalan yang ditambahkan ke salah satu symlink praktis yang dibuat setelah build. Jika tidak disertakan, nilai defaultnya adalah nama alat build yang 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
--tvos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk membangun 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 yang kompatibel minimum untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'tvos_sdk_version'.
Tag:loses_incremental_state
--visionos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk membuat biner Apple visionOS.
Tag:loses_incremental_state
,loading_and_analysis
--watchos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk membuat 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.):
--auto_cpu_environment_group=<a build target label>
default: ""-
Nyatakan environment_group yang akan digunakan untuk memetakan nilai cpu secara otomatis ke nilai target_environment.
Tag:changes_inputs
,loading_and_analysis
,experimental
- Default
--[no]check_licenses
: "false" -
Pastikan batasan pemberian lisensi yang diterapkan oleh paket dependen tidak bertentangan dengan mode distribusi target yang sedang dibuat. Secara default, lisensi tidak diperiksa.
Tag:build_file_semantics
--[no]check_visibility
default: "true"-
Jika dinonaktifkan, error visibilitas dalam dependensi target diturunkan menjadi peringatan.
Tag:build_file_semantics
--[no]desugar_for_android
default: "true"-
Apakah akan melakukan desugar bytecode Java 8 sebelum dexing.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--[no]desugar_java8_libs
: "false" -
Apakah akan menyertakan library Java 8 yang didukung dalam aplikasi untuk perangkat lama.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[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
- Default
--[no]experimental_allow_android_library_deps_without_srcs
: "false" -
Flag untuk membantu transisi dari mengizinkan ke tidak mengizinkan aturan android_library tanpa srcs dengan deps. Depot perlu dibersihkan untuk meluncurkan fitur ini secara default.
Tag:eagerness_to_exit
,loading_and_analysis
--[no]experimental_check_desugar_deps
default: "true"-
Apakah akan memeriksa kembali desugaring yang benar di tingkat biner Android.
Tag:eagerness_to_exit
,loading_and_analysis
,experimental
- Default
--experimental_import_deps_checking=<off, warning or error>
: "NONAKTIF" -
Jika diaktifkan, periksa apakah dependensi aar_import sudah selesai. Penerapan ini dapat merusak build, atau hanya 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
- Default
--[no]incompatible_check_testonly_for_output_files
: "false" -
Jika diaktifkan, periksa testonly untuk target prasyarat yang merupakan file output dengan mencari testonly aturan pembuatan. Tindakan ini cocok dengan pemeriksaan visibilitas.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_disable_native_android_rules
: "false" -
Jika diaktifkan, penggunaan langsung aturan Android native akan dinonaktifkan. Gunakan aturan Android Starlark dari https://github.com/bazelbuild/rules_android
Tag:eagerness_to_exit
,incompatible_change
- Default
--[no]incompatible_disable_native_apple_binary_rule
: "false" -
No-op. Dipertahankan di sini untuk kompatibilitas mundur.
Tag:eagerness_to_exit
,incompatible_change
--[no]incompatible_force_strict_header_check_from_starlark
default: "true"-
Jika diaktifkan, tetapkan pemeriksaan header ketat di Starlark API
Tag:loading_and_analysis
,changes_inputs
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
default: "true"-
Jika benar (true), Bazel juga akan memvalidasi penyertaan header direktori tingkat teratas (lihat https://github.com/bazelbuild/bazel/issues/10047 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]strict_filesets
: "false" -
Jika opsi ini diaktifkan, set file yang melintasi batas paket akan dilaporkan sebagai error. Fungsi ini tidak berfungsi jika check_fileset_dependencies_recursively dinonaktifkan.
Tag:build_file_semantics
,eagerness_to_exit
- Default
--strict_proto_deps=<off, warn, error, strict or 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 jika 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
- Default
--[no]strict_system_includes
: "false" -
Jika benar, header yang ditemukan melalui jalur sertakan sistem (-isystem) juga harus dideklarasikan.
Tag:loading_and_analysis
,eagerness_to_exit
--target_environment=<a build target label>
beberapa penggunaan diakumulasikan-
Mendeklarasikan lingkungan target build ini. Harus berupa referensi label ke aturan "lingkungan". Jika ditentukan, semua target tingkat teratas harus kompatibel dengan lingkungan ini.
Tag:changes_inputs
- Opsi yang memengaruhi output penandatanganan build:
- Default
--apk_signing_method=<v1, v2, v1_v2 or v4>
: "v1_v2" -
Implementasi yang akan digunakan untuk menandatangani APK
Tag:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
default: "true"-
Jika disetel, dan mode kompilasi bukan 'opt', aplikasi objc akan menyertakan hak istimewa 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.:
- Default
--[no]incompatible_config_setting_private_default_visibility
: "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_disallow_legacy_py_provider
default: "true"-
No-op, akan segera dihapus.
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:
- Default
--[no]allow_analysis_failures
: "false" -
Jika benar (true), kegagalan analisis target aturan akan menyebabkan propagasi instance AnalysisFailureInfo yang berisi deskripsi error target, bukan menyebabkan kegagalan build.
Tag:loading_and_analysis
,experimental
- Default
--analysis_testing_deps_limit=<an integer>
: "2000" -
Menetapkan jumlah maksimum dependensi transitif melalui atribut aturan dengan transisi konfigurasi for_analysis_testing. Melebihi batas ini akan menyebabkan error aturan.
Tag:loading_and_analysis
- Default
--[no]break_build_on_parallel_dex2oat_failure
: "false" -
Jika benar, kegagalan tindakan dex2oat akan menyebabkan build rusak, bukan menjalankan dex2oat selama runtime pengujian.
Tag:loading_and_analysis
,experimental
- Default
--[no]check_tests_up_to_date
: "false" -
Jangan jalankan pengujian, cukup periksa apakah sudah diupdate. 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
- Default
--[no]experimental_android_use_parallel_dex2oat
: "false" -
Gunakan dex2oat secara paralel untuk mempercepat android_test.
Tag:loading_and_analysis
,host_machine_resource_optimizations
,experimental
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
beberapa penggunaan diakumulasikan-
Setiap pengujian akan dicoba 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 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
- Default
--[no]ios_memleaks
: "false" -
Aktifkan pemeriksaan kebocoran memori dalam 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
- Default
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Jumlah maksimum tugas pengujian lokal yang akan 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 bersamaan. Menetapkan nilai ini lebih besar dari nilai untuk --jobs tidak akan berpengaruh.
Tag:execution
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
beberapa penggunaan diakumulasikan- Menentukan berapa kali setiap pengujian akan dijalankan. Jika salah satu upaya tersebut gagal karena alasan apa pun, seluruh pengujian akan dianggap gagal. Biasanya, nilai yang ditentukan hanyalah bilangan bulat. Contoh: --runs_per_test=3 akan menjalankan semua pengujian 3 kali. Sintaksis alternatif: regex_filter@runs_per_test. Dengan runs_per_test adalah nilai bilangan bulat dan regex_filter adalah daftar pola ekspresi reguler yang disertakan dan dikecualikan (Lihat juga --instrumentation_filter). Contoh: --runs_per_test=//foo/.*,-//foo/bar/.*@3 menjalankan semua pengujian di //foo/ kecuali yang 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, pengujian hanya dijalankan satu kali.
--test_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan variabel lingkungan tambahan yang akan dimasukkan ke dalam lingkungan runner pengujian. Variabel dapat ditentukan berdasarkan nama, yang dalam hal ini nilainya akan dibaca dari lingkungan klien Bazel, atau berdasarkan pasangan name=value. Opsi ini dapat digunakan beberapa kali untuk menentukan beberapa variabel. Hanya digunakan oleh perintah 'bazel test'.
Tag:test_runner
--[no]test_keep_going
default: "true"-
Jika dinonaktifkan, setiap pengujian yang tidak lulus akan menyebabkan seluruh build berhenti. Secara default, semua pengujian dijalankan, meskipun beberapa pengujian tidak lulus.
Tag:execution
--test_strategy=<a string>
default: ""-
Menentukan strategi yang akan digunakan saat menjalankan pengujian.
Tag:execution
- Default
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - 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 pendek, sedang, panjang, dan abadi (dalam urutan tersebut). Dalam bentuk apa pun, nilai -1 memberi tahu Blaze untuk menggunakan waktu tunggu defaultnya untuk kategori tersebut.
--test_tmpdir=<a path>
default: lihat deskripsi- Menentukan direktori sementara dasar yang akan digunakan oleh 'bazel test'.
--tvos_simulator_device=<a string>
default: lihat deskripsi-
Perangkat yang akan disimulasikan saat menjalankan aplikasi tvOS di simulator, misalnya 'Apple TV 1080p'. Anda bisa mendapatkan daftar perangkat dengan menjalankan 'xcrun simctl list devicetypes' di komputer tempat simulator akan dijalankan.
Tag:test_runner
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi tvOS yang akan dijalankan di simulator saat menjalankan atau menguji.
Tag:test_runner
--watchos_simulator_device=<a string>
default: lihat deskripsi-
Perangkat yang akan disimulasikan saat menjalankan aplikasi watchOS di simulator, misalnya 'Apple Watch - 38 mm'. Anda bisa mendapatkan daftar perangkat dengan menjalankan 'xcrun simctl list devicetypes' di komputer tempat simulator akan dijalankan.
Tag:test_runner
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi watchOS yang akan dijalankan di simulator saat menjalankan atau menguji.
Tag:test_runner
--[no]zip_undeclared_test_outputs
default: "true"-
Jika benar, output pengujian yang tidak dideklarasikan akan diarsipkan dalam file zip.
Tag:test_runner
- Opsi yang memicu pengoptimalan waktu build:
- Default
--[no]collapse_duplicate_defines
: "false" -
Jika diaktifkan, --define yang berlebihan akan dihapus lebih awal dalam build. Hal ini menghindari hilangnya cache analisis yang tidak perlu untuk jenis build yang setara tertentu.
Tag:loading_and_analysis
,loses_incremental_state
- Default
--[no]experimental_filter_library_jar_with_program_jar
: "false" -
Memfilter ProGuard ProgramJar untuk menghapus semua class yang juga ada di LibraryJar.
Tag:action_command_lines
--[no]experimental_inmemory_dotd_files
default: "true"-
Jika diaktifkan, file .d C++ akan diteruskan dalam memori langsung dari node build jarak jauh, bukan ditulis ke disk.
Tag:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
default: "true"-
Jika diaktifkan, file dependensi (.jdeps) yang dihasilkan dari kompilasi Java akan diteruskan dalam memori langsung dari node build jarak jauh, bukan ditulis ke disk.
Tag:loading_and_analysis
,execution
,affects_outputs
,experimental
- Default
--[no]experimental_objc_include_scanning
: "false" -
Apakah akan melakukan pemindaian include untuk Objective C/C++.
Tag:loading_and_analysis
,execution
,changes_inputs
- Default
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
: "false" -
Jika diaktifkan, fitur parse_headers tidak membuat tindakan kompilasi header terpisah jika sumber dengan nama dasar yang sama ditemukan di target yang sama.
Tag:loading_and_analysis
,affects_outputs
- Default
--[no]experimental_retain_test_configuration_across_testonly
: "false" -
Jika diaktifkan, --trim_test_configuration tidak akan memangkas konfigurasi pengujian untuk aturan yang ditandai dengan testonly=1. Hal ini dimaksudkan untuk mengurangi masalah konflik tindakan saat aturan non-pengujian bergantung pada aturan cc_test. Tidak berpengaruh jika --trim_test_configuration adalah false.
Tag:loading_and_analysis
,loses_incremental_state
- Default
--[no]experimental_starlark_cc_import
: "false" -
Jika diaktifkan, cc_import versi Starlark dapat digunakan.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_unsupported_and_brittle_include_scanning
: "false" -
Apakah akan mempersempit input ke kompilasi C/C++ dengan mengurai baris #include dari file input. Hal ini dapat meningkatkan performa dan inkrementalitas dengan mengurangi ukuran pohon input kompilasi. Namun, hal ini juga dapat merusak build karena pemindai include tidak sepenuhnya menerapkan semantik praprosesor C. Khususnya, tidak memahami direktif #include dinamis dan mengabaikan logika bersyarat praprosesor. Gunakan dengan menanggung sendiri risikonya. Setiap masalah terkait tanda ini yang diajukan akan ditutup.
Tag:loading_and_analysis
,execution
,changes_inputs
--[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 kumpulan input yang diteruskan ke kompilasi objc.
Tag:changes_inputs
,loading_and_analysis
- Default
--[no]process_headers_in_dependencies
: "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
--[no]use_singlejar_apkbuilder
default: "true"-
Opsi ini tidak digunakan lagi. Sekarang menjadi no-op dan akan segera dihapus.
Tag:loading_and_analysis
- Opsi yang memengaruhi kejelasan, format, atau lokasi logging:
- Default
--[no]announce
: "false" -
Tidak digunakan lagi. No-op.
Tag:affects_outputs
- Default
--[no]experimental_bep_target_summary
: "false" - Apakah akan memublikasikan peristiwa TargetSummary.
- Default
--[no]experimental_build_event_expand_filesets
: "false" -
Jika benar, luaskan Kumpulan File di BEP saat menampilkan file output.
Tag:affects_outputs
- Default
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: "false" -
Jika benar (true), selesaikan sepenuhnya link simbolis Fileset relatif di BEP saat menampilkan file output. Memerlukan --experimental_build_event_expand_filesets.
Tag:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
default: "4"-
Jumlah maksimum percobaan ulang yang harus dilakukan Bazel saat mengupload peristiwa build.
Tag:bazel_internal_configuration
- Default
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1 detik" -
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.
Tag:affects_outputs
- Default
--[no]experimental_materialize_param_files_directly
: "false" -
Jika mematerialisasi file param, lakukan dengan penulisan langsung ke disk.
Tag:execution
- Default
--[no]experimental_stream_log_file_uploads
: "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: "true"-
Gunakan ini untuk menekan pembuatan kolom important_outputs lama di peristiwa TargetComplete. important_outputs diperlukan untuk integrasi Bazel ke ResultStore.
Tag:affects_outputs
- Default
--[no]materialize_param_files
: "false" -
Menulis file parameter perantara ke struktur output meskipun menggunakan eksekusi tindakan jarak jauh. Berguna saat men-debug tindakan. Hal ini tersirat oleh --subcommands dan --verbose_failures.
Tag:execution
- Default
--max_config_changes_to_show=<an integer>
: "3" -
Saat menghapus cache analisis karena perubahan pada opsi build, 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
- Default
--max_test_output_bytes=<an integer>
: "-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 peringatan untuk aturan dengan nama yang cocok dengan ekspresi reguler yang diberikan.
Tag:affects_outputs
- Default
--progress_report_interval=<an integer in 0-3600 range>
: "0" -
Jumlah detik 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 akan dilaporkan setiap detik.
Tag:affects_outputs
- Default
--show_result=<an integer>
: "1" -
Tampilkan hasil build. Untuk setiap target, nyatakan apakah target tersebut telah diupdate 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, yang merupakan jumlah target minimum yang jika terlampaui, informasi hasil tidak akan dicetak. Jadi, nol menyebabkan penekanan pesan dan MAX_INT menyebabkan hasil selalu dicetak. Defaultnya adalah satu.
Tag:affects_outputs
--[no]subcommands
[-s
] default: "false"-
Menampilkan subperintah yang dieksekusi selama build. Flag terkait: --execution_log_json_file, --execution_log_binary_file (untuk mencatat subperintah ke file dalam format yang kompatibel dengan alat).
Tag:terminal_output
- Default
--test_output=<summary, errors, all or streamed>
: "summary" -
Menentukan mode output yang diinginkan. Nilai yang valid adalah 'summary' untuk menampilkan hanya ringkasan status pengujian, 'errors' untuk juga mencetak log pengujian untuk pengujian yang gagal, 'all' untuk mencetak log untuk semua pengujian, dan 'streamed' untuk menampilkan log untuk semua pengujian secara real time (tindakan ini akan memaksa pengujian dijalankan secara lokal satu per satu, terlepas dari nilai --test_strategy).
Tag:test_runner
,terminal_output
,execution
--test_summary=<short, terse, detailed, none or testcase>
default: "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
- Default
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
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
- Default
--[no]verbose_explanations
: "false" -
Meningkatkan panjang penjelasan yang diberikan jika --explain diaktifkan. Tidak berpengaruh jika --explain tidak diaktifkan.
Tag:affects_outputs
- Default
--[no]verbose_failures
: "false" -
Jika perintah gagal, cetak command line lengkap.
Tag:terminal_output
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--aspects_parameters=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan-
Menentukan nilai parameter aspek command line. Setiap nilai parameter ditentukan melalui <param_name>=<param_value>, misalnya 'my_param=my_val' dengan 'my_param' adalah parameter dari beberapa aspek dalam daftar --aspects atau diperlukan oleh aspek dalam daftar. Opsi ini dapat digunakan beberapa kali. Namun, Anda tidak diizinkan menetapkan nilai ke parameter yang sama lebih dari sekali.
Tag:loading_and_analysis
--flag_alias=<a 'name=value' flag alias>
beberapa penggunaan diakumulasikan-
Menetapkan nama singkat untuk flag Starlark. Fungsi ini mengambil satu pasangan nilai kunci dalam bentuk "<key>=<value>" sebagai argumen.
Tag:changes_inputs
- Default
--[no]incompatible_default_to_explicit_init_py
: "false" -
Flag ini mengubah perilaku default sehingga file __init__.py tidak lagi dibuat secara otomatis di file yang dapat dijalankan dari target Python. 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
--[no]incompatible_py2_outputs_are_suffixed
default: "true"-
Jika benar (true), target yang dibuat dalam konfigurasi Python 2 akan muncul di bawah root output yang menyertakan akhiran '-py2', sedangkan target yang dibuat untuk Python 3 akan muncul di root tanpa akhiran terkait Python. Artinya, link simbolis praktis `bazel-bin` akan mengarah ke target Python 3, bukan Python 2. Jika Anda mengaktifkan opsi ini, sebaiknya aktifkan juga `--incompatible_py3_is_default`.
Tag:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
default: "true"-
Jika benar, target `py_binary` dan `py_test` yang tidak menetapkan atribut `python_version` (atau `default_python_version`) akan ditetapkan secara default ke PY3, bukan PY2. Jika Anda menyetel tanda ini, sebaiknya setel juga `--incompatible_py2_outputs_are_suffixed`.
Tag:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
default: "true"-
Jika disetel ke benar (true), aturan Python native yang dapat dieksekusi akan menggunakan runtime Python yang ditentukan oleh toolchain Python, bukan runtime yang diberikan oleh flag lama seperti --python_top.
Tag:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
default: lihat deskripsi-
Mode versi utama Python, baik `PY2` atau `PY3`. Perhatikan bahwa ini digantikan oleh target `py_binary` dan `py_test` (meskipun tidak secara eksplisit menentukan versi) sehingga biasanya tidak ada banyak alasan untuk memberikan tanda ini.
Tag:loading_and_analysis
,affects_outputs
,explicit_in_output_path
--target_pattern_file=<a string>
default: ""-
Jika disetel, build akan membaca pola dari file yang diberi nama 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:
- Default
--experimental_remote_cache_eviction_retries=<an integer>
: "0" -
Jumlah maksimum upaya percobaan ulang jika build mengalami error penghapusan cache jarak jauh. Nilai selain nol akan secara implisit menyetel --incompatible_remote_use_new_exit_code_for_lost_inputs ke benar (true). ID pemanggilan baru akan dibuat untuk setiap percobaan. Jika Anda membuat ID pemanggilan dan memberikannya ke Bazel dengan --invocation_id, Anda tidak boleh menggunakan tanda ini. Sebagai gantinya, tetapkan tanda --incompatible_remote_use_new_exit_code_for_lost_inputs dan periksa kode keluar 39.
Tag:execution
- Opsi lain-lain, yang tidak dikategorikan.:
--[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
--[no]build_manual_tests
: "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 secara opsional 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'
- Default
--[no]build_tests_only
: "false" - Jika ditentukan, hanya aturan *_test dan test_suite yang akan dibuat dan target lain yang ditentukan di command line akan diabaikan. Secara default, semua yang diminta akan dibuat.
--[no]cache_test_results
[-t
] default: "auto"- Jika disetel ke 'auto', Bazel akan menjalankan ulang pengujian jika dan hanya jika: (1) Bazel mendeteksi perubahan dalam pengujian atau dependensinya, (2) pengujian ditandai sebagai eksternal, (3) beberapa eksekusi pengujian diminta dengan --runs_per_test, atau(4) pengujian sebelumnya gagal. Jika disetel ke 'yes', Bazel akan menyimpan dalam cache semua hasil pengujian kecuali untuk pengujian yang ditandai sebagai eksternal. Jika disetel ke 'no', Bazel tidak akan menyimpan hasil pengujian dalam cache.
- Default
--[no]compile_one_dependency
: "false" - Kompilasi satu dependensi file argumen. Hal ini berguna untuk memeriksa sintaksis file sumber di IDE, misalnya, dengan 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.
--deleted_packages=<comma-separated list of package names>
default: ""- 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.
- Default
--[no]discard_analysis_cache
: "false" - Buang cache analisis segera setelah fase analisis selesai. Mengurangi penggunaan memori sebesar ~10%, tetapi membuat build inkremental lebih lambat.
--execution_log_binary_file=<a path>
default: lihat deskripsi- Mencatat spawn yang dieksekusi ke dalam file ini sebagai proto Spawn yang dibatasi, sesuai dengan src/main/protobuf/spawn.proto. Log pertama-tama ditulis tanpa diurutkan, lalu di akhir pemanggilan, diurutkan dalam urutan yang stabil (dapat menggunakan banyak CPU dan memori). Flag terkait: --execution_log_json_file (format json teks yang diurutkan), --experimental_execution_log_file (format protobuf biner yang tidak diurutkan), --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 dari proto Spawn yang dibatasi, sesuai dengan src/main/protobuf/spawn.proto. Log pertama-tama ditulis tanpa diurutkan, lalu di akhir pemanggilan, diurutkan dalam urutan yang stabil (dapat menggunakan banyak CPU dan memori). Flag terkait: Flag terkait: --execution_log_binary_file (format protobuf biner yang diurutkan), --experimental_execution_log_file (format protobuf biner yang tidak diurutkan), --subcommands (untuk menampilkan subperintah dalam output terminal).
--[no]execution_log_sort
default: "true"- Apakah akan mengurutkan log eksekusi. Setel ke false untuk meningkatkan performa memori, dengan mengorbankan pembuatan log dalam urutan non-deterministik.
--[no]expand_test_suites
default: "true"-
Perluas target test_suite menjadi pengujian konstituennya 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
- Default
--[no]experimental_cancel_concurrent_tests
: "false" -
Jika benar, Blaze akan membatalkan pengujian yang berjalan secara bersamaan pada pengujian pertama yang berhasil. Opsi ini hanya berguna jika dikombinasikan dengan --runs_per_test_detects_flakes.
Tag:affects_outputs
,loading_and_analysis
--experimental_execution_log_file=<a path>
default: lihat deskripsi- Mencatat spawn yang dieksekusi ke dalam file ini sebagai proto Spawn yang dibatasi, sesuai dengan src/main/protobuf/spawn.proto. File ini ditulis sesuai urutan eksekusi Spawns. Flag terkait: --execution_log_binary_file (format protobuf biner yang diurutkan), --execution_log_json_file (format json teks yang diurutkan), --subcommands (untuk menampilkan subperintah dalam output terminal).
- Default
--[no]experimental_execution_log_spawn_metrics
: "false" - Sertakan metrik spawn dalam log spawn yang dieksekusi.
--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.
- Default
--[no]experimental_extra_action_top_level_only
: "false" - Tidak digunakan lagi dan digantikan dengan aspek. Hanya menjadwalkan extra_actions untuk target tingkat teratas.
- Default
--[no]experimental_fetch_all_coverage_outputs
: "false" -
Jika benar (true), Bazel akan mengambil seluruh direktori data cakupan untuk setiap pengujian selama menjalankan cakupan.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_generate_llvm_lcov
: "false" -
Jika benar (true), cakupan untuk clang akan menghasilkan laporan LCOV.
Tag:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
default: "true"- Apakah akan membuat peta header J2ObjC secara paralel dengan transpilasi J2ObjC.
- Default
--[no]experimental_j2objc_shorter_header_path
: "false" -
Apakah akan membuat dengan jalur header yang lebih pendek (menggunakan "_ios" dan bukan "_j2objc").
Tag:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
default: "javabuilder"- Mengaktifkan classpath yang dikurangi untuk kompilasi Java.
- Default
--[no]experimental_limit_android_lint_to_android_constrained_java
: "false" -
Batasi --experimental_run_android_lint_on_java_rules ke library yang kompatibel dengan Android.
Tag:affects_outputs
--[no]experimental_prioritize_local_actions
default: "true"-
Jika disetel, tindakan yang hanya dapat dijalankan secara lokal akan diberi kesempatan pertama untuk mendapatkan resource, pekerja yang dijalankan secara dinamis akan mendapatkan kesempatan kedua, dan tindakan mandiri yang dijalankan secara dinamis akan mendapatkan kesempatan terakhir.
Tag:execution
- Default
--[no]experimental_run_android_lint_on_java_rules
: "false" -
Apakah akan memvalidasi sumber java_*.
Tag:affects_outputs
- Default
--[no]explicit_java_test_deps
: "false" - Tentukan dependensi ke JUnit atau Hamcrest secara eksplisit dalam 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 dieksekusi selama build.
--host_javacopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke javac saat membuat alat yang dieksekusi selama build.
--host_jvmopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke Java VM saat membuat alat yang dieksekusi selama build. Opsi ini akan ditambahkan ke opsi startup VM dari setiap target java_binary.
- Default
--[no]incompatible_check_sharding_support
: "false" -
Jika benar, Bazel akan gagal dalam pengujian yang di-shard jika peluncur pengujian tidak menunjukkan bahwa peluncur mendukung sharding dengan menyentuh file di jalur dalam TEST_SHARD_STATUS_FILE. Jika salah (false), peluncur pengujian yang tidak mendukung sharding akan menyebabkan semua pengujian berjalan di setiap shard.
Tag:incompatible_change
- Default
--[no]incompatible_exclusive_test_sandboxed
: "false" -
Jika benar, pengujian eksklusif akan berjalan dengan strategi sandbox. Tambahkan tag 'local' untuk menjalankan pengujian eksklusif secara lokal
Tag:incompatible_change
- Default
--[no]incompatible_strict_action_env
: "false" -
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 penyimpanan cache lintas pengguna jika cache bersama digunakan.
Tag:loading_and_analysis
,incompatible_change
--j2objc_translation_flags=<comma-separated list of options>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke alat J2ObjC.
--java_debug
-
Menyebabkan mesin virtual 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"- Membuat informasi dependensi (untuk saat ini, classpath waktu kompilasi) per target Java.
--[no]java_header_compilation
default: "true"- Kompilasi ijar langsung dari sumber.
- Default
--java_language_version=<a string>
: "8" - 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.
- Default
--java_runtime_version=<a string>
: "local_jdk" - Versi runtime Java
--javacopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke javac.
--jvmopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke VM Java. Opsi ini akan ditambahkan ke opsi startup VM dari setiap target java_binary.
--legacy_main_dex_list_generator=<a build target label>
default: lihat deskripsi- Menentukan biner yang akan digunakan untuk membuat daftar class yang harus ada di dex utama saat mengompilasi multidex lama.
- Default
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
: "HOST_CPUS" - Tetapkan secara eksplisit jumlah total core CPU lokal yang tersedia untuk Bazel yang akan digunakan pada tindakan build yang dieksekusi secara lokal. Mengambil bilangan bulat, atau "HOST_CPUS", yang secara opsional diikuti dengan [-|*]<float> (mis. HOST_CPUS*.5 untuk menggunakan setengah dari core CPU yang tersedia).Secara default, ("HOST_CPUS"), Bazel akan mengkueri konfigurasi sistem untuk memperkirakan jumlah core CPU yang tersedia.
--local_extra_resources=<a named float, 'name=value'>
beberapa penggunaan diakumulasikan- Tetapkan jumlah resource tambahan yang tersedia untuk Bazel. Menerima pasangan string-float. Dapat digunakan beberapa kali untuk menentukan beberapa jenis resource tambahan. Bazel akan membatasi tindakan yang berjalan secara serentak berdasarkan resource tambahan yang tersedia dan resource tambahan yang diperlukan. Pengujian dapat mendeklarasikan jumlah resource tambahan yang dibutuhkan dengan menggunakan tag berformat "resources:<resoucename>:<amount>". CPU, RAM, dan resource yang tersedia tidak dapat ditetapkan dengan tanda ini.
- Default
--local_ram_resources=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "HOST_RAM*.67" - Tetapkan secara eksplisit jumlah total RAM host lokal (dalam MB) yang tersedia untuk Bazel untuk dibelanjakan pada tindakan build yang dieksekusi secara lokal. Mengambil bilangan bulat, atau "HOST_RAM", yang secara opsional diikuti dengan [-|*]<float> (mis. HOST_RAM*.5 untuk menggunakan setengah RAM yang tersedia). Secara default, ("HOST_RAM*.67"), Bazel akan membuat kueri konfigurasi sistem untuk memperkirakan jumlah RAM yang tersedia dan akan menggunakan 67% dari jumlah tersebut.
- Default
--local_termination_grace_seconds=<an integer>
: "15" - Waktu tunggu antara menghentikan proses lokal karena waktu tunggu habis dan mematikannya secara paksa.
- Default
--package_path=<colon-separated list of options>
: "%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'.
--plugin=<a build target label>
beberapa penggunaan diakumulasikan- Plugin yang akan digunakan dalam build. Saat ini berfungsi dengan java_plugin.
--proguard_top=<a build target label>
default: lihat deskripsi- Menentukan versi ProGuard yang akan digunakan untuk penghapusan kode saat membangun biner Java.
--proto_compiler=<a build target label>
default: "@bazel_tools//tools/proto:protoc"-
Label proto-compiler.
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
default: "@bazel_tools//tools/proto:cc_toolchain"-
Label proto_lang_toolchain() yang menjelaskan cara mengompilasi proto C++
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
default: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Label proto_lang_toolchain() yang menjelaskan cara mengompilasi proto j2objc
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
default: "@bazel_tools//tools/proto:java_toolchain"-
Label proto_lang_toolchain() yang menjelaskan cara mengompilasi proto Java
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
default: "@bazel_tools//tools/proto:javalite_toolchain"-
Label proto_lang_toolchain() yang menjelaskan cara mengompilasi proto JavaLite
Tag:affects_outputs
,loading_and_analysis
--protocopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke compiler protobuf.
Tag:affects_outputs
- Default
--[no]runs_per_test_detects_flakes
: "false" - Jika benar, setiap shard yang setidaknya satu kali lulus dan setidaknya satu kali gagal akan mendapatkan status 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 tidak ada yang ditetapkan, Bazel akan menggunakan jalur default yang dikodekan secara permanen, bergantung pada sistem operasi yang dijalankannya (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, semua sistem operasi lainnya: /bin/bash). Perhatikan bahwa penggunaan shell yang tidak kompatibel dengan bash dapat menyebabkan kegagalan build atau kegagalan runtime biner yang dihasilkan.
Tag:loading_and_analysis
--[no]show_loading_progress
default: "true"- Jika diaktifkan, Bazel akan mencetak pesan "Loading package:".
--test_arg=<a string>
beberapa penggunaan diakumulasikan- Menentukan opsi dan argumen tambahan yang harus diteruskan ke file yang dapat dieksekusi untuk 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_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.
- Default
--test_result_expiration=<an integer>
: "-1" - Opsi ini tidak digunakan lagi dan tidak berpengaruh.
- Default
--[no]test_runner_fail_fast
: "false" - Meneruskan opsi gagal cepat ke runner pengujian. Runner pengujian harus menghentikan eksekusi saat kegagalan pertama terjadi.
--test_sharding_strategy=<explicit or disabled>
default: "explicit"- Tentukan strategi untuk sharding pengujian: 'explicit' untuk hanya menggunakan sharding jika atribut BUILD 'shard_count' ada. 'disabled' agar tidak pernah menggunakan sharding 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 akan ditemukan yang berisi setidaknya satu ukuran yang disertakan dan tidak berisi ukuran yang dikecualikan. Opsi ini memengaruhi perilaku --build_tests_only dan perintah pengujian.
--test_tag_filters=<comma-separated list of options>
default: ""- Menentukan daftar tag pengujian yang dipisahkan koma. Setiap tag dapat secara opsional 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.
- Default
--tool_java_language_version=<a string>
: "8" - Versi bahasa Java yang digunakan untuk menjalankan alat yang diperlukan selama build
--tool_java_runtime_version=<a string>
default: "remotejdk_11"- Versi runtime Java yang digunakan untuk menjalankan alat selama build
--[no]use_ijars
default: "true"- Jika diaktifkan, opsi ini akan menyebabkan kompilasi Java menggunakan jar antarmuka. Hal ini akan menghasilkan kompilasi inkremental yang lebih cepat, tetapi pesan error dapat berbeda.
Opsi Canonicalize-flags
Mewarisi semua opsi dari build.
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika disetel, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Tindakan ini dimaksudkan untuk menghemat ruang disk.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Jika benar, gunakan string yang berasal dari URL download repositori sebagai canonical_id jika tidak ditentukan. Hal ini menyebabkan perubahan pada URL menghasilkan download ulang meskipun cache berisi download dengan hash yang sama. Hal ini dapat digunakan untuk memverifikasi bahwa perubahan URL tidak menyebabkan repositori yang rusak ditutupi oleh cache.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_repository_disable_download
: "false" -
Jika disetel, mendownload repositori eksternal tidak diizinkan.
Tag:experimental
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Menskalakan semua waktu tunggu terkait download http dengan faktor yang diberikan
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.
Tag:bazel_internal_configuration
- Opsi yang mengontrol output perintah:
- Default
--[no]canonicalize_policy
: "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
- Default
--[no]show_warnings
: "false" -
Output parser warnings to standard error (e.g. for conflicting flag options).
Tag:affects_outputs
,terminal_output
- Opsi yang memengaruhi seberapa ketat Bazel menerapkan input build yang valid (definisi aturan, kombinasi tanda, dll.):
--experimental_repository_hash_file=<a string>
default: ""-
Jika tidak kosong, menentukan file yang berisi nilai yang telah diselesaikan, yang akan digunakan untuk memverifikasi hash direktori repositori
Tag:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
beberapa penggunaan diakumulasikan-
Jika daftar aturan repositori yang hash direktori outputnya harus diverifikasi, asalkan file ditentukan oleh --experimental_repository_hash_file.
Tag:affects_outputs
,experimental
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
default: "true"-
No-op
Tag:no_op
,deprecated
,experimental
- Default
--[no]incompatible_config_setting_private_default_visibility
: "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:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan ditarik di registry tempat modul tersebut berasal (jika modul tersebut tidak berasal dari NonRegistryOverride). Jika tidak, versi yang dibatalkan akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang diizinkan untuk dibatalkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel 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
- Default
--check_direct_dependencies=<off, warning or error>
: "warning" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di 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 meningkatkan ketidakcocokan menjadi kegagalan penyelesaian.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "nonaktif"-
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan memperbaruinya jika ada perubahan, `error` untuk menggunakan file kunci tetapi menampilkan error jika file tersebut tidak terbaru, atau `off` agar tidak membaca dari atau menulis ke file kunci.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut 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`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari terlebih dahulu di registry awal, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry awal.
Tag:changes_inputs
- Opsi yang memengaruhi kejelasan, format, atau lokasi logging:
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dijalankan terbesar. Menetapkan opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika tidak kosong, baca file yang telah diselesaikan yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Default
--for_command=<a string>
: "build" -
Perintah yang opsinya harus dikanonisasi.
Tag:affects_outputs
,terminal_output
--invocation_policy=<a string>
default: ""-
Menerapkan kebijakan pemanggilan ke opsi yang akan dikanonisasi.
Tag:affects_outputs
,terminal_output
- Opsi caching dan eksekusi jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali 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.
- Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
--deleted_packages=<comma-separated list of package names>
default: ""- 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.
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`
- Default
--package_path=<colon-separated list of options>
: "%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 muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika disetel, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Tindakan ini dimaksudkan untuk menghemat ruang disk.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Jika benar, gunakan string yang berasal dari URL download repositori sebagai canonical_id jika tidak ditentukan. Hal ini menyebabkan perubahan pada URL menghasilkan download ulang meskipun cache berisi download dengan hash yang sama. Hal ini dapat digunakan untuk memverifikasi bahwa perubahan URL tidak menyebabkan repositori yang rusak ditutupi oleh cache.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_repository_disable_download
: "false" -
Jika disetel, mendownload repositori eksternal tidak diizinkan.
Tag:experimental
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Menskalakan semua waktu tunggu terkait download http dengan faktor yang diberikan
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.
Tag:bazel_internal_configuration
- Opsi yang mengontrol output perintah:
- Default
--[no]async
: "false" -
Jika benar, pembersihan output bersifat asinkron. Setelah perintah ini selesai, Anda dapat menjalankan perintah baru di klien yang sama dengan aman, meskipun penghapusan dapat berlanjut di latar belakang.
Tag:host_machine_resource_optimizations
- Default
--[no]expunge
: "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 secara asinkron untuk instance bazel ini, yang mencakup semua file sementara dan output build yang dibuat bazel, serta menghentikan server bazel jika sedang berjalan. Setelah perintah ini selesai, Anda dapat menjalankan perintah baru di klien yang sama dengan aman, meskipun penghapusan dapat berlanjut di latar belakang.
Meluas menjadi:
--expunge
--async
Tag:host_machine_resource_optimizations
- Default
--[no]remove_all_convenience_symlinks
: "false" -
Jika benar, semua link simbolis di ruang kerja dengan awalan symlink_prefix akan dihapus. Tanpa tanda ini, hanya symlink dengan akhiran yang telah ditentukan sebelumnya yang dibersihkan.
Tag:affects_outputs
- Opsi yang memengaruhi seberapa ketat Bazel menerapkan input build yang valid (definisi aturan, kombinasi tanda, dll.):
--experimental_repository_hash_file=<a string>
default: ""-
Jika tidak kosong, menentukan file yang berisi nilai yang telah diselesaikan, yang akan digunakan untuk memverifikasi hash direktori repositori
Tag:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
beberapa penggunaan diakumulasikan-
Jika daftar aturan repositori yang hash direktori outputnya harus diverifikasi, asalkan file ditentukan oleh --experimental_repository_hash_file.
Tag:affects_outputs
,experimental
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
default: "true"-
No-op
Tag:no_op
,deprecated
,experimental
- Opsi yang terkait dengan output dan semantik Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan ditarik di registry tempat modul tersebut berasal (jika modul tersebut tidak berasal dari NonRegistryOverride). Jika tidak, versi yang dibatalkan akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang diizinkan untuk dibatalkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel 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
- Default
--check_direct_dependencies=<off, warning or error>
: "warning" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di 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 meningkatkan ketidakcocokan menjadi kegagalan penyelesaian.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "nonaktif"-
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan memperbaruinya jika ada perubahan, `error` untuk menggunakan file kunci tetapi menampilkan error jika file tersebut tidak terbaru, atau `off` agar tidak membaca dari atau menulis ke file kunci.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut 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`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari terlebih dahulu di registry awal, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry awal.
Tag:changes_inputs
- Opsi yang memengaruhi kejelasan, format, atau lokasi logging:
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dijalankan terbesar. Menetapkan opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika tidak kosong, baca file yang telah di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan caching jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali 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.
- Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`
Opsi Konfigurasi
Opsi Cakupan
Mewarisi semua opsi dari test.
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
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
- Default
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Jika benar, gunakan string yang berasal dari URL download repositori sebagai canonical_id jika tidak ditentukan. Hal ini menyebabkan perubahan pada URL menghasilkan download ulang meskipun cache berisi download dengan hash yang sama. Hal ini dapat digunakan untuk memverifikasi bahwa perubahan URL tidak menyebabkan repositori yang rusak ditutupi oleh cache.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_repository_disable_download
: "false" -
Jika disetel, mendownload repositori eksternal tidak diizinkan.
Tag:experimental
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Menskalakan semua waktu tunggu terkait download http dengan faktor yang diberikan
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.
Tag:bazel_internal_configuration
- Opsi yang memengaruhi seberapa ketat Bazel menerapkan input build yang valid (definisi aturan, kombinasi tanda, dll.):
--experimental_repository_hash_file=<a string>
default: ""-
Jika tidak kosong, menentukan file yang berisi nilai yang telah diselesaikan, yang akan digunakan untuk memverifikasi hash direktori repositori
Tag:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
beberapa penggunaan diakumulasikan-
Jika daftar aturan repositori yang hash direktori outputnya harus diverifikasi, asalkan file ditentukan oleh --experimental_repository_hash_file.
Tag:affects_outputs
,experimental
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
default: "true"-
No-op
Tag:no_op
,deprecated
,experimental
- Opsi yang terkait dengan output dan semantik Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan ditarik di registry tempat modul tersebut berasal (jika modul tersebut tidak berasal dari NonRegistryOverride). Jika tidak, versi yang dibatalkan akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang diizinkan untuk dibatalkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel 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
- Default
--check_direct_dependencies=<off, warning or error>
: "warning" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di 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 meningkatkan ketidakcocokan menjadi kegagalan penyelesaian.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "nonaktif"-
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan memperbaruinya jika ada perubahan, `error` untuk menggunakan file kunci tetapi menampilkan error jika file tersebut tidak terbaru, atau `off` agar tidak membaca dari atau menulis ke file kunci.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut 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`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari terlebih dahulu di registry awal, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry awal.
Tag:changes_inputs
- Opsi yang memengaruhi kejelasan, format, atau lokasi logging:
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dijalankan terbesar. Menetapkan opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika tidak kosong, baca file yang telah di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan caching jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali 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.
- Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`
Opsi Cquery
Mewarisi semua opsi dari test.
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
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
- Default
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Jika benar, gunakan string yang berasal dari URL download repositori sebagai canonical_id jika tidak ditentukan. Hal ini menyebabkan perubahan pada URL menghasilkan download ulang meskipun cache berisi download dengan hash yang sama. Hal ini dapat digunakan untuk memverifikasi bahwa perubahan URL tidak menyebabkan repositori yang rusak ditutupi oleh cache.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_repository_disable_download
: "false" -
Jika disetel, mendownload repositori eksternal tidak diizinkan.
Tag:experimental
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Menskalakan semua waktu tunggu terkait download http dengan faktor yang diberikan
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.
Tag:bazel_internal_configuration
- Opsi yang memengaruhi seberapa ketat Bazel menerapkan input build yang valid (definisi aturan, kombinasi tanda, dll.):
--experimental_repository_hash_file=<a string>
default: ""-
Jika tidak kosong, menentukan file yang berisi nilai yang telah diselesaikan, yang akan digunakan untuk memverifikasi hash direktori repositori
Tag:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
beberapa penggunaan diakumulasikan-
Jika daftar aturan repositori yang hash direktori outputnya harus diverifikasi, asalkan file ditentukan oleh --experimental_repository_hash_file.
Tag:affects_outputs
,experimental
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
default: "true"-
No-op
Tag:no_op
,deprecated
,experimental
- Opsi yang terkait dengan output dan semantik kueri:
- Default
--aspect_deps=<off, conservative or precise>
: "konservatif" -
Cara mengatasi 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 berdasarkan 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
- Default
--[no]consistent_labels
: "false" -
Jika diaktifkan, setiap perintah kueri akan menghasilkan 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 perintah kueri dan/atau label yang berbeda yang dikeluarkan oleh aturan. Jika tidak diaktifkan, pemformat output bebas memancarkan nama repositori yang jelas (relatif terhadap repositori utama) untuk membuat output lebih mudah dibaca.
Tag:terminal_output
--[no]graph:factored
default: "true"-
Jika benar (true), 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
- Default
--graph:node_limit=<an integer>
: "512" -
Panjang maksimum string label untuk node grafik dalam output. Label yang lebih panjang akan dipotong; -1 berarti tidak ada pemotongan. Opsi ini hanya berlaku untuk --output=graph.
Tag:terminal_output
--[no]implicit_deps
default: "true"-
Jika diaktifkan, dependensi implisit akan disertakan dalam grafik dependensi tempat kueri 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_display_source_file_location
default: "true"-
Benar secara default, menampilkan target file sumber. Jika benar (true), menampilkan lokasi baris 1 file sumber dalam output lokasi. Flag ini hanya ada untuk tujuan migrasi.
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
- Default
--[no]infer_universe_scope
: "false" -
Jika disetel dan --universe_scope tidak disetel, 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 harus menggunakan opsi ini hanya jika Anda tahu apa yang Anda lakukan. Lihat https://bazel.build/reference/query#sky-query untuk mengetahui detail dan contohnya. Jika --universe_scope ditetapkan, nilai opsi ini akan diabaikan. Catatan: opsi ini hanya berlaku untuk `query` (yaitu, bukan `cquery`).
Tag:loading_and_analysis
- Default
--[no]line_terminator_null
: "false" -
Apakah setiap format diakhiri dengan \0, bukan baris baru.
Tag:terminal_output
--[no]nodep_deps
default: "true"-
Jika diaktifkan, dependensi dari atribut "nodep" akan disertakan dalam grafik dependensi tempat kueri beroperasi. Contoh umum atribut "nodep" adalah "visibility". Jalankan dan uraikan output `info build-language` untuk mempelajari semua atribut "nodep" dalam bahasa build.
Tag:build_file_semantics
- Default
--output=<a string>
: "label" -
Format hasil cquery yang akan dicetak. Nilai yang diizinkan untuk cquery adalah: label, label_kind, textproto, transitions, proto, jsonproto. Jika memilih 'transisi', Anda juga harus menentukan opsi --transitions=(lite|full).
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
- Default
--[no]proto:definition_stack
: "false" -
Isi kolom proto definition_stack, yang mencatat untuk setiap instance aturan, stack panggilan Starlark pada saat class aturan ditentukan.
Tag:terminal_output
--[no]proto:flatten_selects
default: "true"-
Jika diaktifkan, atribut yang dapat dikonfigurasi yang dibuat oleh select() akan diratakan. Untuk jenis daftar, representasi yang diratakan adalah daftar yang berisi setiap nilai peta pilihan tepat satu kali. Jenis skalar diratakan menjadi null.
Tag:build_file_semantics
--[no]proto:include_configurations
default: "true"-
Jika diaktifkan, output proto akan menyertakan informasi tentang konfigurasi. Jika dinonaktifkan,format output proto cquery menyerupai format output kueri.
Tag:affects_outputs
- Default
--[no]proto:include_synthetic_attribute_hash
: "false" -
Apakah atribut $internal_attr_hash akan dihitung dan diisi atau tidak.
Tag:terminal_output
- Default
--[no]proto:instantiation_stack
: "false" -
Isi stack panggilan instansiasi setiap aturan. Perhatikan bahwa hal ini mengharuskan stack ada
Tag:terminal_output
--[no]proto:locations
default: "true"-
Apakah akan menampilkan informasi lokasi dalam output proto atau tidak.
Tag:terminal_output
- Default
--proto:output_rule_attrs=<comma-separated list of options>
: "all" -
Daftar atribut yang dipisahkan koma untuk disertakan dalam output. 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_inputs_and_outputs
default: "true"-
Apakah akan mengisi kolom rule_input dan rule_output 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
- Default
--[no]relative_locations
: "false" -
Jika benar, lokasi file BUILD dalam output xml dan proto akan bersifat relatif. Secara default, output lokasi adalah jalur absolut dan tidak akan konsisten di seluruh komputer. Anda dapat 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 menentukan --starlark:expr dan --starlark:file.
Tag:terminal_output
--starlark:file=<a string>
default: ""-
Nama file yang menentukan fungsi Starlark yang disebut 'format', dengan satu argumen, yang diterapkan ke setiap target yang dikonfigurasi untuk memformatnya sebagai string. Terjadi error jika 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 target 'konfigurasi host' atau 'eksekusi' tidak akan disertakan dalam grafik dependensi yang digunakan kueri. Edge dependensi 'konfigurasi host', seperti yang berasal dari aturan 'proto_library' ke Pengompilasi Protokol, biasanya mengarah ke alat yang dieksekusi selama build, bukan bagian dari program 'target' yang sama.
Cquery: Jika dinonaktifkan, akan memfilter semua target yang dikonfigurasi yang melintasi transisi host atau 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 ada dalam konfigurasi host, hanya target yang dikonfigurasi host 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 atas diasumsikan sebagai target yang diuraikan dari ekspresi kueri. Catatan: Untuk cquery, tidak menentukan opsi ini dapat menyebabkan build rusak jika target yang diuraikan dari ekspresi kueri tidak dapat dibangun dengan opsi tingkat teratas.
Tag:loading_and_analysis
- Opsi yang terkait dengan output dan semantik Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan ditarik di registry tempat modul tersebut berasal (jika modul tersebut tidak berasal dari NonRegistryOverride). Jika tidak, versi yang dibatalkan akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang diizinkan untuk dibatalkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel 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
- Default
--check_direct_dependencies=<off, warning or error>
: "warning" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di 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 meningkatkan ketidakcocokan menjadi kegagalan penyelesaian.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "nonaktif"-
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan memperbaruinya jika ada perubahan, `error` untuk menggunakan file kunci tetapi menampilkan error jika file tersebut tidak terbaru, atau `off` agar tidak membaca dari atau menulis ke file kunci.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut 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`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari terlebih dahulu di registry awal, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry awal.
Tag:changes_inputs
- Opsi yang memengaruhi kejelasan, format, atau lokasi logging:
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dijalankan terbesar. Menetapkan opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika tidak kosong, baca file yang telah di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan caching jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali 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.
- Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`
- Opsi yang mengontrol eksekusi build:
- Default
--[no]experimental_inprocess_symlink_creation
: "false" -
Apakah akan melakukan panggilan sistem file langsung untuk membuat struktur symlink
Tag:loading_and_analysis
,execution
,experimental
- Default
--[no]experimental_remotable_source_manifests
: "false" -
Apakah akan membuat tindakan manifes sumber dapat dilakukan dari jarak jauh
Tag:loading_and_analysis
,execution
,experimental
- Default
--[no]experimental_split_coverage_postprocessing
: "false" -
Jika benar (true), Bazel akan menjalankan pasca-pemrosesan cakupan untuk pengujian di proses baru.
Tag:execution
- Default
--[no]experimental_strict_fileset_output
: "false" -
Jika opsi ini diaktifkan, kumpulan file akan memperlakukan semua artefak output sebagai file reguler. File tersebut tidak akan melintasi direktori atau peka terhadap symlink.
Tag:execution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
default: ""-
Menambahkan atau menghapus kunci dari info eksekusi tindakan berdasarkan mnemonik tindakan. Hanya berlaku untuk tindakan yang mendukung info eksekusi. Banyak tindakan umum 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.
Diperluas menjadi:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
Tag:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
Aktifkan pemroses resource Android persisten menggunakan pekerja.
Diperluas menjadi:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
Tag:
host_machine_resource_optimizations
,execution
--persistent_multiplex_android_dex_desugar
-
Aktifkan tindakan dex dan desugar Android multiplex persisten menggunakan pekerja.
Diperluas menjadi:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
Tag:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
Aktifkan pemroses resource Android multiplex persisten dengan menggunakan pekerja.
Diperluas menjadi:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
Tag:
host_machine_resource_optimizations
,execution
--persistent_multiplex_android_tools
-
Aktifkan alat Android persisten dan multiplex (dexing, desugaring, pemrosesan resource).
Diperluas menjadi:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
Tag:host_machine_resource_optimizations
,execution
- Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
--android_compiler=<a string>
default: lihat deskripsi-
Compiler target Android.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--android_crosstool_top=<a build target label>
default: "//external:android/crosstool"-
Lokasi compiler C++ yang digunakan untuk build Android.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
--android_grte_top=<a label>
default: lihat deskripsi-
Target Android grte_top.
Tag:changes_inputs
,loading_and_analysis
,loses_incremental_state
- Default
--android_manifest_merger=<legacy, android or force_android>
: "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
--android_sdk=<a build target label>
default: "@bazel_tools//tools/android:sdk"-
Menentukan SDK/platform Android yang digunakan untuk membuat aplikasi Android.
Tag:changes_inputs
,loading_and_analysis
,loses_incremental_state
--apple_compiler=<a string>
default: lihat deskripsi-
Compiler target Apple. Berguna untuk memilih varian toolchain (misalnya, xcode-beta).
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--apple_crosstool_top=<a build target label>
default: "@bazel_tools//tools/cpp:toolchain"-
Label paket crosstool yang akan digunakan dalam aturan Apple dan Objc serta dependensinya.
Tag:loses_incremental_state
,changes_inputs
--apple_grte_top=<a build target label>
default: lihat deskripsi-
Target Apple grte_top.
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
,explicit_in_output_path
--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. Saat ini, ini harus berupa grup file yang berisi satu file, yaitu biner. Nilai defaultnya adalah '//tools/test:lcov_merger'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
default: "@bazel_tools//tools/test:coverage_report_generator"-
Lokasi biner yang digunakan untuk membuat laporan cakupan. Saat ini, ini harus berupa grup file yang berisi satu file, yaitu biner. Defaultnya adalah '//tools/test:coverage_report_generator'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
default: "@bazel_tools//tools/test:coverage_support"-
Lokasi file pendukung yang diperlukan pada input setiap tindakan pengujian yang mengumpulkan cakupan kode. Nilai defaultnya adalah '//tools/test:coverage_support'.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
--crosstool_top=<a build target label>
default: "@bazel_tools//tools/cpp:toolchain"-
Label paket crosstool yang akan digunakan untuk mengompilasi kode C++.
Tag:loading_and_analysis
,changes_inputs
,affects_outputs
--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
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
beberapa penggunaan diakumulasikan-
Daftar ekspresi reguler yang dipisahkan koma, yang masing-masing secara opsional diawali dengan - (ekspresi negatif), ditetapkan (=) ke daftar target nilai batasan yang dipisahkan koma. Jika target tidak cocok dengan ekspresi negatif dan cocok dengan setidaknya satu ekspresi positif, resolusi toolchain-nya akan dilakukan seolah-olah target telah menyatakan nilai batasan sebagai batasan eksekusi. Contoh: //demo,-test=@platforms//cpus:x86_64 akan menambahkan 'x86_64' ke target apa pun di bagian //demo, kecuali target yang namanya berisi 'test'.
Tag:loading_and_analysis
--[no]experimental_enable_objc_cc_deps
default: "true"-
Memungkinkan aturan objc_* bergantung pada cc_library dan menyebabkan dependensi objc apa pun dibangun dengan --cpu yang ditetapkan ke "ios_<--ios_cpu>" untuk nilai apa pun di --ios_multi_cpu.
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]experimental_include_xcode_execution_requirements
: "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
--[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
--extra_execution_platforms=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
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().
Tag:execution
--extra_toolchains=<comma-separated list of options>
beberapa penggunaan 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 ke library libc yang di-check in. Nilai default dipilih oleh toolchain crosstool, dan Anda hampir tidak perlu menggantinya.
Tag:action_command_lines
,affects_outputs
--host_compiler=<a string>
default: lihat deskripsi-
Compiler C++ yang akan digunakan untuk kompilasi host. Argumen ini diabaikan jika --host_crosstool_top tidak ditetapkan.
Tag:loading_and_analysis
,execution
--host_crosstool_top=<a build target label>
default: lihat deskripsi-
Secara default, opsi --crosstool_top dan --compiler juga digunakan untuk konfigurasi host. Jika tanda ini diberikan, Bazel akan menggunakan libc dan compiler default untuk crosstool_top yang diberikan.
Tag:loading_and_analysis
,changes_inputs
,affects_outputs
--host_grte_top=<a label>
default: lihat deskripsi-
Jika ditentukan, setelan ini akan menggantikan direktori tingkat teratas libc (--grte_top) untuk konfigurasi host.
Tag:action_command_lines
,affects_outputs
--host_platform=<a build target label>
default: ""-
Label aturan platform yang menjelaskan sistem host.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set
default: "true"-
Jika benar (true), Bazel tidak akan mengizinkan penentuan expand_if_all_available di flag_sets (lihat https://github.com/bazelbuild/bazel/issues/7008 untuk mengetahui petunjuk migrasi).
Tag:loading_and_analysis
,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
- Default
--[no]incompatible_enable_android_toolchain_resolution
: "false" -
Gunakan penyelesaian toolchain untuk memilih Android SDK untuk aturan Android (Starlark dan native)
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]incompatible_enable_apple_toolchain_resolution
: "false" -
Gunakan penyelesaian toolchain untuk memilih Apple SDK untuk aturan Apple (Starlark dan native)
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
default: "true"-
Jika benar (true), Bazel tidak akan menggunakan kembali command line tindakan link C++ untuk command line pengindeksan LTO (lihat https://github.com/bazelbuild/bazel/issues/6791 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
default: "true"-
Jika benar (true), Bazel akan menampilkan error saat atribut cc_toolchain.cpu dan cc_toolchain.compiler ditetapkan (lihat https://github.com/bazelbuild/bazel/issues/7075 untuk mengetahui petunjuk migrasi).
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_legacy_whole_archive
default: "true"-
Jika benar, Bazel tidak akan menautkan dependensi library sebagai seluruh arsip secara default (lihat https://github.com/bazelbuild/bazel/issues/7362 untuk mengetahui petunjuk migrasi).
Tag:loading_and_analysis
,incompatible_change
--[no]incompatible_require_ctx_in_configure_features
default: "true"-
Jika benar (true), Bazel akan memerlukan parameter 'ctx' di cc_common.configure_features (lihat https://github.com/bazelbuild/bazel/issues/7793 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,incompatible_change
-
Gunakan objek bersama antarmuka jika didukung oleh toolchain. Semua toolchain ELF saat ini mendukung setelan ini.
Tag:loading_and_analysis
,affects_outputs
,affects_outputs
--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, gunakan 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 relative path>
default: ""-
Lokasi file pemetaan yang menjelaskan platform mana yang akan digunakan jika tidak ada yang ditetapkan atau flag mana yang akan ditetapkan jika platform sudah ada. Harus relatif terhadap root ruang kerja utama. Secara default adalah 'platform_mappings' (file langsung di bawah root ruang kerja).
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
default: ""-
Label aturan platform yang menjelaskan platform target untuk perintah saat ini.
Tag:affects_outputs
,changes_inputs
,loading_and_analysis
--python2_path=<a string>
default: lihat deskripsi-
Tidak digunakan lagi, tidak ada operasi. Dinonaktifkan oleh `--incompatible_use_python_toolchains`.
Tag:no_op
,deprecated
--python3_path=<a string>
default: lihat deskripsi-
Tidak digunakan lagi, tidak ada operasi. Dinonaktifkan oleh `--incompatible_use_python_toolchains`.
Tag:no_op
,deprecated
--python_path=<a string>
default: lihat deskripsi-
Jalur absolut interpreter Python yang dipanggil untuk menjalankan target Python di platform target. Tidak digunakan lagi; dinonaktifkan oleh --incompatible_use_python_toolchains.
Tag:loading_and_analysis
,affects_outputs
--python_top=<a build target label>
default: lihat deskripsi-
Label py_runtime yang merepresentasikan penafsir Python yang dipanggil untuk menjalankan target Python di platform target. Tidak digunakan lagi; dinonaktifkan oleh --incompatible_use_python_toolchains.
Tag:loading_and_analysis
,affects_outputs
--target_platform_fallback=<a build target label>
default: "@local_config_platform//:host"-
Label aturan platform yang harus digunakan jika tidak ada platform target yang ditetapkan dan tidak ada pemetaan platform yang cocok dengan kumpulan flag 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
--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, gunakan 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:
- Default
--[no]apple_enable_auto_dsym_dbg
: "false" -
Apakah akan memaksa mengaktifkan pembuatan file simbol debug (.dSYM) untuk build dbg.
Tag:affects_outputs
,action_command_lines
- Default
--[no]apple_generate_dsym
: "false" -
Apakah akan membuat file simbol debug (.dSYM).
Tag:affects_outputs
,action_command_lines
--[no]build_runfile_links
default: "true"-
Jika benar, bangun hutan symlink file yang dapat dijalankan untuk semua target. Jika salah (false), tulis hanya manifes jika memungkinkan.
Tag:affects_outputs
--[no]build_runfile_manifests
default: "true"-
Jika benar, tulis manifes file yang dapat dijalankan untuk semua target. Jika salah (false), hilangkan. Pengujian lokal akan gagal dijalankan jika salah (false).
Tag:affects_outputs
- Default
--[no]build_test_dwp
: "false" -
Jika diaktifkan, saat membuat pengujian C++ secara statis dan dengan fusi, file .dwp untuk biner pengujian juga akan dibuat secara otomatis.
Tag:loading_and_analysis
,affects_outputs
--cc_proto_library_header_suffixes=<comma-separated list of options>
default: ".pb.h"-
Menetapkan awalan file header yang dibuat oleh cc_proto_library.
Tag:affects_outputs
,loading_and_analysis
- Default
--cc_proto_library_source_suffixes=<comma-separated list of options>
: ".pb.cc" -
Menetapkan awalan file sumber yang dibuat oleh cc_proto_library.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_proto_descriptor_sets_include_source_info
: "false" -
Menjalankan tindakan tambahan untuk versi API Java alternatif di proto_library.
Tag:affects_outputs
,loading_and_analysis
,experimental
- Default
--[no]experimental_proto_extra_actions
: "false" -
Menjalankan tindakan tambahan untuk versi API Java alternatif di proto_library.
Tag:affects_outputs
,loading_and_analysis
,experimental
- Default
--[no]experimental_save_feature_state
: "false" -
Simpan status fitur yang diaktifkan dan diminta sebagai output kompilasi.
Tag:affects_outputs
,experimental
- Default
--fission=<a set of compilation modes>
: "no" -
Menentukan mode kompilasi mana yang menggunakan fisi untuk kompilasi dan link C++. Dapat berupa kombinasi {'fastbuild', 'dbg', 'opt'} atau nilai khusus 'yes' untuk mengaktifkan semua mode dan 'no' untuk menonaktifkan semua mode.
Tag:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]incompatible_always_include_files_in_data
default: "true"-
Jika benar (true), aturan native akan menambahkan <code>DefaultInfo.files</code> dependensi data ke runfile-nya, yang cocok dengan perilaku yang direkomendasikan untuk aturan Starlark (https://bazel.build/extending/rules#runfiles_features_to_avoid).
Tag:affects_outputs
,incompatible_change
--[no]legacy_external_runfiles
default: "true"-
Jika benar (true), buat hutan symlink runfile untuk repositori eksternal di bawah .runfiles/wsname/external/repo (selain .runfiles/repo).
Tag:affects_outputs
- Default
--[no]objc_generate_linkmap
: "false" -
Menentukan apakah akan membuat file linkmap.
Tag:affects_outputs
- Default
--[no]save_temps
: "false" -
Jika disetel, output sementara dari gcc akan disimpan. Ini mencakup file .s (kode assembler), file .i (C yang telah diproses awal), dan file .ii (C++ yang telah diproses awal).
Tag:affects_outputs
- Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, yang memengaruhi nilainya, bukan keberadaannya:
--action_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi target. Variabel dapat ditentukan berdasarkan nama, yang dalam hal ini nilainya akan diambil dari lingkungan pemanggilan, atau berdasarkan pasangan nama=nilai yang menetapkan nilai secara terpisah dari lingkungan pemanggilan. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru yang akan berlaku, opsi untuk variabel yang berbeda akan terakumulasi.
Tag:action_command_lines
--android_cpu=<a string>
default: "armeabi-v7a"-
CPU target Android.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--[no]android_databinding_use_androidx
: "false" -
Buat file data binding yang kompatibel dengan AndroidX. Ini hanya digunakan dengan databinding v2.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]android_databinding_use_v3_4_args
: "false" -
Gunakan pengikatan data Android v2 dengan argumen 3.4.0
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
- Default
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
: "alphabetical" (alfabetis) -
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
- Default
--[no]android_resource_shrinking
: "false" -
Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.
Tag:affects_outputs
,loading_and_analysis
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, visionos, watchos, tvos, macos or catalyst>
beberapa penggunaan diakumulasikan-
Tentukan mode bitcode Apple untuk langkah kompilasi yang menargetkan arsitektur perangkat. Nilai memiliki bentuk '[platform=]mode', dengan platform (yang harus berupa 'ios', 'macos', 'tvos', atau 'watchos') bersifat opsional. Jika disediakan, mode bitcode diterapkan khusus untuk platform tersebut; jika tidak ada, mode bitcode diterapkan untuk semua platform. Modenya harus 'none', 'embedded_markers', atau 'embedded'. Opsi ini dapat diberikan beberapa kali.
Tag:loses_incremental_state
- Default
--[no]build_python_zip
: "auto" -
Bangun zip yang dapat dieksekusi Python; aktif di Windows, nonaktif di platform lain
Tag:affects_outputs
--catalyst_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk membangun biner Apple Catalyst.
Tag:loses_incremental_state
,loading_and_analysis
- Default
--[no]collect_code_coverage
: "false" -
Jika ditentukan, Bazel akan melengkapi kode (menggunakan instrumentasi offline jika memungkinkan) dan akan mengumpulkan informasi cakupan selama pengujian. Hanya target yang cocok dengan --instrumentation_filter yang akan terpengaruh. Biasanya opsi ini tidak boleh ditentukan secara langsung - perintah 'bazel coverage' harus digunakan.
Tag:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] default: "fastbuild"-
Tentukan mode pembuatan biner. Nilai: 'fastbuild', 'dbg', 'opt'.
Tag:affects_outputs
,action_command_lines
,explicit_in_output_path
--conlyopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber C.
Tag:action_command_lines
,affects_outputs
--copt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc.
Tag:action_command_lines
,affects_outputs
--cpu=<a string>
default: ""-
CPU target.
Tag:changes_inputs
,affects_outputs
,explicit_in_output_path
--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
--cxxopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber C++.
Tag:action_command_lines
,affects_outputs
--define=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan-
Setiap opsi --define menentukan penetapan untuk variabel build.
Tag:changes_inputs
,affects_outputs
--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_fdo_profile_absolute_path
default: "true"-
Jika disetel, penggunaan fdo_absolute_profile_path akan menimbulkan error.
Tag:affects_outputs
- Default
--[no]enable_runfiles
: "auto" -
Aktifkan hierarki symlink runfile; Secara default, fitur ini nonaktif di Windows, dan aktif di platform lain.
Tag:affects_outputs
--experimental_action_listener=<a build target label>
beberapa penggunaan diakumulasikan-
Tidak digunakan lagi dan digantikan dengan aspek. Gunakan action_listener untuk melampirkan extra_action ke tindakan build yang ada.
Tag:execution
,experimental
- Default
--[no]experimental_android_compress_java_resources
: "false" -
Memadatkan resource Java di APK
Tag:affects_outputs
,loading_and_analysis
,experimental
- Default
--[no]experimental_android_databinding_v2
: "false" -
Menggunakan databinding v2 Android
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]experimental_android_resource_shrinking
: "false" -
Mengaktifkan penyingkatan resource untuk APK android_binary yang menggunakan ProGuard.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_android_rewrite_dexes_with_rex
: "false" -
menggunakan alat rex untuk menulis ulang file dex
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- Default
--[no]experimental_collect_code_coverage_for_generated_files
: "false" -
Jika ditentukan, Bazel juga akan membuat informasi cakupan pengumpulan untuk file yang dihasilkan.
Tag:affects_outputs
- Default
--experimental_objc_fastbuild_options=<comma-separated list of options>
: "-O0,-DDEBUG=1" -
Menggunakan string ini sebagai opsi compiler fastbuild objc.
Tag:action_command_lines
- Default
--[no]experimental_omitfp
: "false" -
Jika benar, gunakan libunwind untuk pelepasan stack, dan kompilasi dengan -fomit-frame-pointer dan -fasynchronous-unwind-tables.
Tag:action_command_lines
,affects_outputs
,experimental
- Default
--[no]experimental_platform_in_output_dir
: "false" -
Jika benar (true), platform target akan digunakan dalam nama direktori output, bukan CPU.
Tag:affects_outputs
,experimental
- Default
--[no]experimental_use_llvm_covmap
: "false" -
Jika ditentukan, Bazel akan membuat informasi peta cakupan llvm-cov, bukan gcov, saat collect_code_coverage diaktifkan.
Tag:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
--fat_apk_cpu=<comma-separated list of options>
default: "armeabi-v7a"-
Menetapkan opsi ini akan mengaktifkan fat APK, yang berisi biner native untuk semua arsitektur target yang ditentukan, misalnya, --fat_apk_cpu=x86,armeabi-v7a. Jika tanda ini ditentukan, --android_cpu akan diabaikan untuk dependensi aturan android_binary.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--[no]fat_apk_hwasan
: "false" -
Apakah akan membuat pemisahan HWASAN.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
--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
--features=<a string>
beberapa penggunaan diakumulasikan-
Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi target. Menentukan -<fitur> akan menonaktifkan fitur tersebut. Fitur negatif selalu menggantikan fitur positif. Lihat juga --host_features
Tag:changes_inputs
,affects_outputs
- Default
--[no]force_pic
: "false" -
Jika diaktifkan, semua kompilasi C++ menghasilkan kode independen posisi ("-fPIC"), link lebih memilih library bawaan PIC daripada library non-PIC, dan link menghasilkan executable independen posisi ("-pie").
Tag:loading_and_analysis
,affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan kumpulan variabel lingkungan yang tersedia untuk tindakan dengan konfigurasi host atau eksekusi. Variabel dapat ditentukan berdasarkan nama, yang dalam hal ini nilainya akan diambil dari lingkungan pemanggilan, atau berdasarkan pasangan nama=nilai yang menetapkan nilai secara terpisah dari lingkungan pemanggilan. Opsi ini dapat digunakan beberapa kali; untuk opsi yang diberikan untuk variabel yang sama, opsi terbaru yang akan berlaku, opsi untuk variabel yang berbeda akan terakumulasi.
Tag:action_command_lines
- Default
--host_compilation_mode=<fastbuild, dbg or opt>
: "opt" -
Tentukan mode alat yang digunakan selama build akan di-build. Nilai: 'fastbuild', 'dbg', 'opt'.
Tag:affects_outputs
,action_command_lines
--host_conlyopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber C untuk alat host.
Tag:action_command_lines
,affects_outputs
--host_copt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc untuk alat host.
Tag:action_command_lines
,affects_outputs
--host_cpu=<a string>
default: ""-
CPU host.
Tag:changes_inputs
,affects_outputs
--host_cxxopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc untuk alat host.
Tag:action_command_lines
,affects_outputs
--host_features=<a string>
beberapa penggunaan diakumulasikan-
Fitur yang diberikan akan diaktifkan atau dinonaktifkan secara default untuk target yang dibuat dalam konfigurasi exec. Menentukan -<fitur> akan menonaktifkan fitur tersebut. Fitur negatif selalu menggantikan fitur positif.
Tag:changes_inputs
,affects_outputs
--host_force_python=<PY2 or PY3>
default: lihat deskripsi-
Menggantikan versi Python untuk konfigurasi host. Dapat berupa "PY2" atau "PY3".
Tag:loading_and_analysis
,affects_outputs
--host_linkopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc saat menautkan alat host.
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
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan secara selektif ke compiler C/C++ saat mengompilasi file tertentu dalam konfigurasi host atau 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
--host_swiftcopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke swiftc untuk alat host.
Tag:action_command_lines
,affects_outputs
--[no]incompatible_avoid_conflict_dlls
default: "true"-
Jika diaktifkan, semua library yang ditautkan secara dinamis (DLL) C++ yang dihasilkan oleh cc_library di Windows akan diganti namanya menjadi name_{hash}.dll, dengan hash dihitung berdasarkan RepositoryName dan jalur paket DLL. Opsi ini berguna saat Anda memiliki satu paket yang bergantung pada beberapa cc_library dengan nama yang sama (misalnya //foo/bar1:utils dan //foo/bar2:utils).
Tag:loading_and_analysis
,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
- Default
--[no]incompatible_use_host_features
: "false" -
Jika benar (true), gunakan --features hanya untuk konfigurasi target dan --host_features untuk konfigurasi exec.
Tag:changes_inputs
,affects_outputs
,incompatible_change
--[no]incompatible_use_platforms_repo_for_constraints
default: "true"-
Jika benar (true), setelan batasan dari @bazel_tools akan dihapus.
Tag:affects_outputs
,incompatible_change
- Default
--[no]instrument_test_targets
: "false" -
Jika cakupan diaktifkan, tentukan apakah akan mempertimbangkan aturan pengujian instrumentasi. Jika ditetapkan, aturan pengujian yang disertakan oleh --instrumentation_filter akan diinstrumentasi. 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 diinstrumentasi. Aturan yang diawali dengan '-' akan dikecualikan. Perhatikan bahwa hanya aturan non-pengujian yang diinstrumentasi 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
--ios_multi_cpus=<comma-separated list of options>
beberapa penggunaan 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
--linkopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc saat menautkan.
Tag:action_command_lines
,affects_outputs
--ltobackendopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke langkah backend LTO (di bagian --features=thin_lto).
Tag:action_command_lines
,affects_outputs
--ltoindexopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk diteruskan ke langkah pengindeksan LTO (di bagian --features=thin_lto).
Tag:action_command_lines
,affects_outputs
--macos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk membuat 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
- Default
--[no]objc_debug_with_GLIBCXX
: "false" -
Jika ditetapkan, dan mode kompilasi ditetapkan ke 'dbg', tentukan GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC, dan GLIBCPP_CONCEPT_CHECKS.
Tag:action_command_lines
- Default
--[no]objc_enable_binary_stripping
: "false" -
Apakah akan melakukan penghapusan simbol dan kode tidak terpakai pada biner yang ditautkan. Penyusutan biner akan dilakukan jika tanda ini dan --compilation_mode=opt ditentukan.
Tag:action_command_lines
--objccopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke gcc saat mengompilasi file sumber Objective-C/C++.
Tag:action_command_lines
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk 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 dari semua file cc di //foo/ kecuali bar.cc.
Tag:action_command_lines
,affects_outputs
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
beberapa penggunaan diakumulasikan-
Opsi tambahan untuk meneruskan secara selektif ke backend LTO (di bagian --features=thin_lto) saat mengompilasi objek backend tertentu. Opsi ini dapat diteruskan beberapa kali. Sintaksis: regex_filter@option_1,option_2,...,option_n. Dengan regex_filter adalah daftar pola ekspresi reguler 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 adalah 'foo -bar', dan command line eksekusinya adalah 'test_binary -baz', maka command line akhirnya adalah 'foo -bar test_binary -baz'.Ini juga dapat berupa label ke target yang dapat dieksekusi. Beberapa contohnya adalah: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target --options'.
Tag:action_command_lines
-
Jika benar (true), library native yang berisi fungsi identik akan dibagikan di antara target yang berbeda
Tag:loading_and_analysis
,affects_outputs
- Default
--[no]stamp
: "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
--stripopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke strip saat membuat biner '<name>.stripped'.
Tag:action_command_lines
,affects_outputs
--swiftcopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke kompilasi Swift.
Tag:action_command_lines
--tvos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk membangun 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 yang kompatibel minimum untuk simulator dan perangkat target. Jika tidak ditentukan, gunakan 'tvos_sdk_version'.
Tag:loses_incremental_state
--visionos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk membuat biner Apple visionOS.
Tag:loses_incremental_state
,loading_and_analysis
--watchos_cpus=<comma-separated list of options>
beberapa penggunaan diakumulasikan-
Daftar arsitektur yang dipisahkan koma untuk membuat 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.):
--auto_cpu_environment_group=<a build target label>
default: ""-
Nyatakan environment_group yang akan digunakan untuk memetakan nilai cpu secara otomatis ke nilai target_environment.
Tag:changes_inputs
,loading_and_analysis
,experimental
- Default
--[no]check_licenses
: "false" -
Pastikan batasan pemberian lisensi yang diterapkan oleh paket dependen tidak bertentangan dengan mode distribusi target yang sedang dibuat. Secara default, lisensi tidak diperiksa.
Tag:build_file_semantics
--[no]check_visibility
default: "true"-
Jika dinonaktifkan, error visibilitas dalam dependensi target diturunkan menjadi peringatan.
Tag:build_file_semantics
--[no]desugar_for_android
default: "true"-
Apakah akan melakukan desugar bytecode Java 8 sebelum dexing.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
- Default
--[no]desugar_java8_libs
: "false" -
Apakah akan menyertakan library Java 8 yang didukung dalam aplikasi untuk perangkat lama.
Tag:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
--[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
- Default
--[no]experimental_allow_android_library_deps_without_srcs
: "false" -
Flag untuk membantu transisi dari mengizinkan ke tidak mengizinkan aturan android_library tanpa srcs dengan deps. Depot perlu dibersihkan untuk meluncurkan fitur ini secara default.
Tag:eagerness_to_exit
,loading_and_analysis
--[no]experimental_check_desugar_deps
default: "true"-
Apakah akan memeriksa kembali desugaring yang benar di tingkat biner Android.
Tag:eagerness_to_exit
,loading_and_analysis
,experimental
- Default
--experimental_import_deps_checking=<off, warning or error>
: "NONAKTIF" -
Jika diaktifkan, periksa apakah dependensi aar_import sudah selesai. Penerapan ini dapat merusak build, atau hanya 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
- Default
--[no]incompatible_check_testonly_for_output_files
: "false" -
Jika diaktifkan, periksa testonly untuk target prasyarat yang merupakan file output dengan mencari testonly aturan pembuatan. Tindakan ini cocok dengan pemeriksaan visibilitas.
Tag:build_file_semantics
,incompatible_change
- Default
--[no]incompatible_disable_native_android_rules
: "false" -
Jika diaktifkan, penggunaan langsung aturan Android native akan dinonaktifkan. Gunakan aturan Android Starlark dari https://github.com/bazelbuild/rules_android
Tag:eagerness_to_exit
,incompatible_change
- Default
--[no]incompatible_disable_native_apple_binary_rule
: "false" -
No-op. Dipertahankan di sini untuk kompatibilitas mundur.
Tag:eagerness_to_exit
,incompatible_change
--[no]incompatible_force_strict_header_check_from_starlark
default: "true"-
Jika diaktifkan, tetapkan pemeriksaan header ketat di Starlark API
Tag:loading_and_analysis
,changes_inputs
,incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
default: "true"-
Jika benar (true), Bazel juga akan memvalidasi penyertaan header direktori tingkat teratas (lihat https://github.com/bazelbuild/bazel/issues/10047 untuk mengetahui informasi selengkapnya).
Tag:loading_and_analysis
,incompatible_change
- Default
--[no]strict_filesets
: "false" -
Jika opsi ini diaktifkan, set file yang melintasi batas paket akan dilaporkan sebagai error. Fungsi ini tidak berfungsi jika check_fileset_dependencies_recursively dinonaktifkan.
Tag:build_file_semantics
,eagerness_to_exit
- Default
--strict_proto_deps=<off, warn, error, strict or 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 jika 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
- Default
--[no]strict_system_includes
: "false" -
Jika benar, header yang ditemukan melalui jalur sertakan sistem (-isystem) juga harus dideklarasikan.
Tag:loading_and_analysis
,eagerness_to_exit
--target_environment=<a build target label>
beberapa penggunaan diakumulasikan-
Mendeklarasikan lingkungan target build ini. Harus berupa referensi label ke aturan "lingkungan". Jika ditentukan, semua target tingkat teratas harus kompatibel dengan lingkungan ini.
Tag:changes_inputs
- Opsi yang memengaruhi output penandatanganan build:
- Default
--apk_signing_method=<v1, v2, v1_v2 or v4>
: "v1_v2" -
Implementasi yang akan digunakan untuk menandatangani APK
Tag:action_command_lines
,affects_outputs
,loading_and_analysis
--[no]device_debug_entitlements
default: "true"-
Jika disetel, dan mode kompilasi bukan 'opt', aplikasi objc akan menyertakan hak istimewa 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_legacy_py_provider
default: "true"-
No-op, akan segera dihapus.
Tag:loading_and_analysis
,incompatible_change
- Opsi yang mengatur perilaku lingkungan pengujian atau pelaksana pengujian:
- Default
--[no]allow_analysis_failures
: "false" -
Jika benar (true), kegagalan analisis target aturan akan menyebabkan propagasi instance AnalysisFailureInfo yang berisi deskripsi error target, bukan menyebabkan kegagalan build.
Tag:loading_and_analysis
,experimental
- Default
--analysis_testing_deps_limit=<an integer>
: "2000" -
Menetapkan jumlah maksimum dependensi transitif melalui atribut aturan dengan transisi konfigurasi for_analysis_testing. Melebihi batas ini akan menyebabkan error aturan.
Tag:loading_and_analysis
- Default
--[no]break_build_on_parallel_dex2oat_failure
: "false" -
Jika benar, kegagalan tindakan dex2oat akan menyebabkan build rusak, bukan menjalankan dex2oat selama runtime pengujian.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_android_use_parallel_dex2oat
: "false" -
Gunakan dex2oat secara paralel untuk mempercepat android_test.
Tag:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- Default
--[no]ios_memleaks
: "false" -
Aktifkan pemeriksaan kebocoran memori dalam 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
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
beberapa penggunaan diakumulasikan- Menentukan berapa kali setiap pengujian akan dijalankan. Jika salah satu upaya tersebut gagal karena alasan apa pun, seluruh pengujian akan dianggap gagal. Biasanya, nilai yang ditentukan hanyalah bilangan bulat. Contoh: --runs_per_test=3 akan menjalankan semua pengujian 3 kali. Sintaksis alternatif: regex_filter@runs_per_test. Dengan runs_per_test adalah nilai bilangan bulat dan regex_filter adalah daftar pola ekspresi reguler yang disertakan dan dikecualikan (Lihat juga --instrumentation_filter). Contoh: --runs_per_test=//foo/.*,-//foo/bar/.*@3 menjalankan semua pengujian di //foo/ kecuali yang 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, pengujian hanya dijalankan satu kali.
--test_env=<a 'name=value' assignment with an optional value part>
beberapa penggunaan diakumulasikan-
Menentukan variabel lingkungan tambahan yang akan dimasukkan ke dalam lingkungan runner pengujian. Variabel dapat ditentukan berdasarkan nama, yang dalam hal ini nilainya akan dibaca dari lingkungan klien Bazel, atau berdasarkan pasangan name=value. Opsi ini dapat digunakan beberapa kali untuk menentukan beberapa variabel. Hanya digunakan oleh perintah 'bazel test'.
Tag:test_runner
- Default
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - Ganti nilai waktu tunggu pengujian default untuk waktu tunggu pengujian (dalam detik). Jika satu nilai bilangan bulat positif ditentukan, nilai tersebut akan menggantikan semua kategori. Jika 4 bilangan bulat yang dipisahkan koma ditentukan, bilangan bulat tersebut akan menggantikan waktu tunggu untuk pendek, sedang, panjang, dan abadi (dalam urutan tersebut). Dalam bentuk apa pun, nilai -1 memberi tahu Blaze untuk menggunakan waktu tunggu defaultnya untuk kategori tersebut.
--tvos_simulator_device=<a string>
default: lihat deskripsi-
Perangkat yang akan disimulasikan saat menjalankan aplikasi tvOS di simulator, misalnya 'Apple TV 1080p'. Anda bisa mendapatkan daftar perangkat dengan menjalankan 'xcrun simctl list devicetypes' di komputer tempat simulator akan dijalankan.
Tag:test_runner
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi tvOS yang akan dijalankan di simulator saat menjalankan atau menguji.
Tag:test_runner
--watchos_simulator_device=<a string>
default: lihat deskripsi-
Perangkat yang akan disimulasikan saat menjalankan aplikasi watchOS di simulator, misalnya 'Apple Watch - 38 mm'. Anda bisa mendapatkan daftar perangkat dengan menjalankan 'xcrun simctl list devicetypes' di komputer tempat simulator akan dijalankan.
Tag:test_runner
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
default: lihat deskripsi-
Versi watchOS yang akan dijalankan di simulator saat menjalankan atau menguji.
Tag:test_runner
--[no]zip_undeclared_test_outputs
default: "true"-
Jika benar, output pengujian yang tidak dideklarasikan akan diarsipkan dalam file zip.
Tag:test_runner
- Opsi yang terkait dengan output dan semantik kueri:
- Default
--aspect_deps=<off, conservative or precise>
: "konservatif" -
Cara mengatasi 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 berdasarkan 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
- Default
--[no]consistent_labels
: "false" -
Jika diaktifkan, setiap perintah kueri akan menghasilkan 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 perintah kueri dan/atau label yang berbeda yang dikeluarkan oleh aturan. Jika tidak diaktifkan, pemformat output bebas memancarkan nama repositori yang jelas (relatif terhadap repositori utama) untuk membuat output lebih mudah dibaca.
Tag:terminal_output
--[no]graph:factored
default: "true"-
Jika benar (true), 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
- Default
--graph:node_limit=<an integer>
: "512" -
Panjang maksimum string label untuk node grafik dalam output. Label yang lebih panjang akan dipotong; -1 berarti tidak ada pemotongan. Opsi ini hanya berlaku untuk --output=graph.
Tag:terminal_output
--[no]implicit_deps
default: "true"-
Jika diaktifkan, dependensi implisit akan disertakan dalam grafik dependensi tempat kueri 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_display_source_file_location
default: "true"-
Benar secara default, menampilkan target file sumber. Jika benar (true), menampilkan lokasi baris 1 file sumber dalam output lokasi. Flag ini hanya ada untuk tujuan migrasi.
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
- Default
--[no]infer_universe_scope
: "false" -
Jika disetel dan --universe_scope tidak disetel, 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 harus menggunakan opsi ini hanya jika Anda tahu apa yang Anda lakukan. Lihat https://bazel.build/reference/query#sky-query untuk mengetahui detail dan contohnya. Jika --universe_scope ditetapkan, nilai opsi ini akan diabaikan. Catatan: opsi ini hanya berlaku untuk `query` (yaitu, bukan `cquery`).
Tag:loading_and_analysis
- Default
--[no]line_terminator_null
: "false" -
Apakah setiap format diakhiri dengan \0, bukan baris baru.
Tag:terminal_output
--[no]nodep_deps
default: "true"-
Jika diaktifkan, dependensi dari atribut "nodep" akan disertakan dalam grafik dependensi tempat kueri beroperasi. Contoh umum atribut "nodep" adalah "visibility". Jalankan dan uraikan output `info build-language` untuk mempelajari semua atribut "nodep" dalam bahasa build.
Tag:build_file_semantics
- Default
--output=<a string>
: "label" -
Format hasil cquery yang akan dicetak. Nilai yang diizinkan untuk cquery adalah: label, label_kind, textproto, transitions, proto, jsonproto. Jika memilih 'transisi', Anda juga harus menentukan opsi --transitions=(lite|full).
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
- Default
--[no]proto:definition_stack
: "false" -
Isi kolom proto definition_stack, yang mencatat untuk setiap instance aturan, stack panggilan Starlark pada saat class aturan ditentukan.
Tag:terminal_output
--[no]proto:flatten_selects
default: "true"-
Jika diaktifkan, atribut yang dapat dikonfigurasi yang dibuat oleh select() akan diratakan. Untuk jenis daftar, representasi yang diratakan adalah daftar yang berisi setiap nilai peta pilihan tepat satu kali. Jenis skalar diratakan menjadi null.
Tag:build_file_semantics
--[no]proto:include_configurations
default: "true"-
Jika diaktifkan, output proto akan menyertakan informasi tentang konfigurasi. Jika dinonaktifkan,format output proto cquery menyerupai format output kueri.
Tag:affects_outputs
- Default
--[no]proto:include_synthetic_attribute_hash
: "false" -
Apakah atribut $internal_attr_hash akan dihitung dan diisi atau tidak.
Tag:terminal_output
- Default
--[no]proto:instantiation_stack
: "false" -
Isi stack panggilan instansiasi setiap aturan. Perhatikan bahwa hal ini mengharuskan stack ada
Tag:terminal_output
--[no]proto:locations
default: "true"-
Apakah akan menampilkan informasi lokasi dalam output proto atau tidak.
Tag:terminal_output
- Default
--proto:output_rule_attrs=<comma-separated list of options>
: "all" -
Daftar atribut yang dipisahkan koma untuk disertakan dalam output. 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_inputs_and_outputs
default: "true"-
Apakah akan mengisi kolom rule_input dan rule_output 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
- Default
--[no]relative_locations
: "false" -
Jika benar, lokasi file BUILD dalam output xml dan proto akan bersifat relatif. Secara default, output lokasi adalah jalur absolut dan tidak akan konsisten di seluruh komputer. Anda dapat 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 menentukan --starlark:expr dan --starlark:file.
Tag:terminal_output
--starlark:file=<a string>
default: ""-
Nama file yang menentukan fungsi Starlark yang disebut 'format', dengan satu argumen, yang diterapkan ke setiap target yang dikonfigurasi untuk memformatnya sebagai string. Terjadi error jika 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 target 'konfigurasi host' atau 'eksekusi' tidak akan disertakan dalam grafik dependensi yang digunakan kueri. Edge dependensi 'konfigurasi host', seperti yang berasal dari aturan 'proto_library' ke Pengompilasi Protokol, biasanya mengarah ke alat yang dieksekusi selama build, bukan bagian dari program 'target' yang sama.
Cquery: Jika dinonaktifkan, akan memfilter semua target yang dikonfigurasi yang melintasi transisi host atau 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 ada dalam konfigurasi host, hanya target yang dikonfigurasi host 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 atas diasumsikan sebagai target yang diuraikan dari ekspresi kueri. Catatan: Untuk cquery, tidak menentukan opsi ini dapat menyebabkan build rusak jika target yang diuraikan dari ekspresi kueri tidak dapat dibangun dengan opsi tingkat teratas.
Tag:loading_and_analysis
- Opsi yang memicu pengoptimalan waktu build:
- Default
--[no]collapse_duplicate_defines
: "false" -
Jika diaktifkan, --define yang berlebihan akan dihapus lebih awal dalam build. Hal ini menghindari hilangnya cache analisis yang tidak perlu untuk jenis build yang setara tertentu.
Tag:loading_and_analysis
,loses_incremental_state
- Default
--[no]experimental_filter_library_jar_with_program_jar
: "false" -
Memfilter ProGuard ProgramJar untuk menghapus semua class yang juga ada di LibraryJar.
Tag:action_command_lines
--[no]experimental_inmemory_dotd_files
default: "true"-
Jika diaktifkan, file .d C++ akan diteruskan dalam memori langsung dari node build jarak jauh, bukan ditulis ke disk.
Tag:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
default: "true"-
Jika diaktifkan, file dependensi (.jdeps) yang dihasilkan dari kompilasi Java akan diteruskan dalam memori langsung dari node build jarak jauh, bukan ditulis ke disk.
Tag:loading_and_analysis
,execution
,affects_outputs
,experimental
- Default
--[no]experimental_objc_include_scanning
: "false" -
Apakah akan melakukan pemindaian include untuk Objective C/C++.
Tag:loading_and_analysis
,execution
,changes_inputs
- Default
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
: "false" -
Jika diaktifkan, fitur parse_headers tidak membuat tindakan kompilasi header terpisah jika sumber dengan nama dasar yang sama ditemukan di target yang sama.
Tag:loading_and_analysis
,affects_outputs
- Default
--[no]experimental_retain_test_configuration_across_testonly
: "false" -
Jika diaktifkan, --trim_test_configuration tidak akan memangkas konfigurasi pengujian untuk aturan yang ditandai dengan testonly=1. Hal ini dimaksudkan untuk mengurangi masalah konflik tindakan saat aturan non-pengujian bergantung pada aturan cc_test. Tidak berpengaruh jika --trim_test_configuration adalah false.
Tag:loading_and_analysis
,loses_incremental_state
- Default
--[no]experimental_starlark_cc_import
: "false" -
Jika diaktifkan, cc_import versi Starlark dapat digunakan.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_unsupported_and_brittle_include_scanning
: "false" -
Apakah akan mempersempit input ke kompilasi C/C++ dengan mengurai baris #include dari file input. Hal ini dapat meningkatkan performa dan inkrementalitas dengan mengurangi ukuran pohon input kompilasi. Namun, hal ini juga dapat merusak build karena pemindai include tidak sepenuhnya menerapkan semantik praprosesor C. Khususnya, tidak memahami direktif #include dinamis dan mengabaikan logika bersyarat praprosesor. Gunakan dengan menanggung sendiri risikonya. Setiap masalah terkait tanda ini yang diajukan akan ditutup.
Tag:loading_and_analysis
,execution
,changes_inputs
--[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 kumpulan input yang diteruskan ke kompilasi objc.
Tag:changes_inputs
,loading_and_analysis
- Default
--[no]process_headers_in_dependencies
: "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
--[no]use_singlejar_apkbuilder
default: "true"-
Opsi ini tidak digunakan lagi. Sekarang menjadi no-op dan akan segera dihapus.
Tag:loading_and_analysis
- Opsi yang memengaruhi kejelasan, format, atau lokasi logging:
- Default
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
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
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--flag_alias=<a 'name=value' flag alias>
beberapa penggunaan diakumulasikan-
Menetapkan nama singkat untuk flag Starlark. Fungsi ini mengambil satu pasangan nilai kunci dalam bentuk "<key>=<value>" sebagai argumen.
Tag:changes_inputs
- Default
--[no]incompatible_default_to_explicit_init_py
: "false" -
Flag ini mengubah perilaku default sehingga file __init__.py tidak lagi dibuat secara otomatis di file yang dapat dijalankan dari target Python. 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
--[no]incompatible_py2_outputs_are_suffixed
default: "true"-
Jika benar (true), target yang dibuat dalam konfigurasi Python 2 akan muncul di bawah root output yang menyertakan akhiran '-py2', sedangkan target yang dibuat untuk Python 3 akan muncul di root tanpa akhiran terkait Python. Artinya, link simbolis praktis `bazel-bin` akan mengarah ke target Python 3, bukan Python 2. Jika Anda mengaktifkan opsi ini, sebaiknya aktifkan juga `--incompatible_py3_is_default`.
Tag:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
default: "true"-
Jika benar, target `py_binary` dan `py_test` yang tidak menetapkan atribut `python_version` (atau `default_python_version`) akan ditetapkan secara default ke PY3, bukan PY2. Jika Anda menyetel tanda ini, sebaiknya setel juga `--incompatible_py2_outputs_are_suffixed`.
Tag:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
default: "true"-
Jika disetel ke benar (true), aturan Python native yang dapat dieksekusi akan menggunakan runtime Python yang ditentukan oleh toolchain Python, bukan runtime yang diberikan oleh flag lama seperti --python_top.
Tag:loading_and_analysis
,incompatible_change
--python_version=<PY2 or PY3>
default: lihat deskripsi-
Mode versi utama Python, baik `PY2` atau `PY3`. Perhatikan bahwa ini digantikan oleh target `py_binary` dan `py_test` (meskipun tidak secara eksplisit menentukan versi) sehingga biasanya tidak ada banyak alasan untuk memberikan tanda ini.
Tag:loading_and_analysis
,affects_outputs
,explicit_in_output_path
- Opsi lain-lain, yang tidak dikategorikan.:
--[no]cache_test_results
[-t
] default: "auto"- Jika disetel ke 'auto', Bazel akan menjalankan ulang pengujian jika dan hanya jika: (1) Bazel mendeteksi perubahan dalam pengujian atau dependensinya, (2) pengujian ditandai sebagai eksternal, (3) beberapa eksekusi pengujian diminta dengan --runs_per_test, atau(4) pengujian sebelumnya gagal. Jika disetel ke 'yes', Bazel akan menyimpan dalam cache semua hasil pengujian kecuali untuk pengujian yang ditandai sebagai eksternal. Jika disetel ke 'no', Bazel tidak akan menyimpan hasil pengujian dalam cache.
- Default
--[no]experimental_cancel_concurrent_tests
: "false" -
Jika benar, Blaze akan membatalkan pengujian yang berjalan secara bersamaan pada pengujian pertama yang berhasil. Opsi ini hanya berguna jika dikombinasikan dengan --runs_per_test_detects_flakes.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_fetch_all_coverage_outputs
: "false" -
Jika benar (true), Bazel akan mengambil seluruh direktori data cakupan untuk setiap pengujian selama menjalankan cakupan.
Tag:affects_outputs
,loading_and_analysis
- Default
--[no]experimental_generate_llvm_lcov
: "false" -
Jika benar (true), cakupan untuk clang akan menghasilkan laporan LCOV.
Tag:affects_outputs
,loading_and_analysis
--[no]experimental_j2objc_header_map
default: "true"- Apakah akan membuat peta header J2ObjC secara paralel dengan transpilasi J2ObjC.
- Default
--[no]experimental_j2objc_shorter_header_path
: "false" -
Apakah akan membuat dengan jalur header yang lebih pendek (menggunakan "_ios" dan bukan "_j2objc").
Tag:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
default: "javabuilder"- Mengaktifkan classpath yang dikurangi untuk kompilasi Java.
- Default
--[no]experimental_limit_android_lint_to_android_constrained_java
: "false" -
Batasi --experimental_run_android_lint_on_java_rules ke library yang kompatibel dengan Android.
Tag:affects_outputs
- Default
--[no]experimental_run_android_lint_on_java_rules
: "false" -
Apakah akan memvalidasi sumber java_*.
Tag:affects_outputs
- Default
--[no]explicit_java_test_deps
: "false" - Tentukan dependensi ke JUnit atau Hamcrest secara eksplisit dalam 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 dieksekusi selama build.
--host_javacopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke javac saat membuat alat yang dieksekusi selama build.
--host_jvmopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke Java VM saat membuat alat yang dieksekusi selama build. Opsi ini akan ditambahkan ke opsi startup VM dari setiap target java_binary.
- Default
--[no]incompatible_check_sharding_support
: "false" -
Jika benar, Bazel akan gagal dalam pengujian yang di-shard jika peluncur pengujian tidak menunjukkan bahwa peluncur mendukung sharding dengan menyentuh file di jalur dalam TEST_SHARD_STATUS_FILE. Jika salah (false), peluncur pengujian yang tidak mendukung sharding akan menyebabkan semua pengujian berjalan di setiap shard.
Tag:incompatible_change
- Default
--[no]incompatible_exclusive_test_sandboxed
: "false" -
Jika benar, pengujian eksklusif akan berjalan dengan strategi sandbox. Tambahkan tag 'local' untuk menjalankan pengujian eksklusif secara lokal
Tag:incompatible_change
- Default
--[no]incompatible_strict_action_env
: "false" -
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 penyimpanan cache lintas pengguna jika cache bersama digunakan.
Tag:loading_and_analysis
,incompatible_change
--j2objc_translation_flags=<comma-separated list of options>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke alat J2ObjC.
--java_debug
-
Menyebabkan mesin virtual 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"- Membuat informasi dependensi (untuk saat ini, classpath waktu kompilasi) per target Java.
--[no]java_header_compilation
default: "true"- Kompilasi ijar langsung dari sumber.
- Default
--java_language_version=<a string>
: "8" - 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.
- Default
--java_runtime_version=<a string>
: "local_jdk" - Versi runtime Java
--javacopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke javac.
--jvmopt=<a string>
beberapa penggunaan diakumulasikan- Opsi tambahan yang akan diteruskan ke VM Java. Opsi ini akan ditambahkan ke opsi startup VM 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.
--plugin=<a build target label>
beberapa penggunaan diakumulasikan- Plugin yang akan digunakan dalam build. Saat ini berfungsi dengan java_plugin.
--proguard_top=<a build target label>
default: lihat deskripsi- Menentukan versi ProGuard yang akan digunakan untuk penghapusan kode saat membangun biner Java.
--proto_compiler=<a build target label>
default: "@bazel_tools//tools/proto:protoc"-
Label proto-compiler.
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
default: "@bazel_tools//tools/proto:cc_toolchain"-
Label proto_lang_toolchain() yang menjelaskan cara mengompilasi proto C++
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
default: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
Label proto_lang_toolchain() yang menjelaskan cara mengompilasi proto j2objc
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_java=<a build target label>
default: "@bazel_tools//tools/proto:java_toolchain"-
Label proto_lang_toolchain() yang menjelaskan cara mengompilasi proto Java
Tag:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
default: "@bazel_tools//tools/proto:javalite_toolchain"-
Label proto_lang_toolchain() yang menjelaskan cara mengompilasi proto JavaLite
Tag:affects_outputs
,loading_and_analysis
--protocopt=<a string>
beberapa penggunaan diakumulasikan-
Opsi tambahan yang akan diteruskan ke compiler protobuf.
Tag:affects_outputs
- Default
--[no]runs_per_test_detects_flakes
: "false" - Jika benar, setiap shard yang setidaknya satu kali lulus dan setidaknya satu kali gagal akan mendapatkan status 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 tidak ada yang ditetapkan, Bazel akan menggunakan jalur default yang dikodekan secara permanen, bergantung pada sistem operasi yang dijalankannya (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, semua sistem operasi lainnya: /bin/bash). Perhatikan bahwa penggunaan shell yang tidak kompatibel dengan bash dapat menyebabkan kegagalan build atau kegagalan runtime biner yang dihasilkan.
Tag:loading_and_analysis
--test_arg=<a string>
beberapa penggunaan diakumulasikan- Menentukan opsi dan argumen tambahan yang harus diteruskan ke file yang dapat dieksekusi untuk 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.
- Default
--test_result_expiration=<an integer>
: "-1" - Opsi ini tidak digunakan lagi dan tidak berpengaruh.
- Default
--[no]test_runner_fail_fast
: "false" - Meneruskan opsi gagal cepat ke runner pengujian. Runner pengujian harus menghentikan eksekusi saat kegagalan pertama terjadi.
--test_sharding_strategy=<explicit or disabled>
default: "explicit"- Tentukan strategi untuk sharding pengujian: 'explicit' untuk hanya menggunakan sharding jika atribut BUILD 'shard_count' ada. 'disabled' agar tidak pernah menggunakan sharding pengujian.
- Default
--tool_java_language_version=<a string>
: "8" - Versi bahasa Java yang digunakan untuk menjalankan alat yang diperlukan selama build
--tool_java_runtime_version=<a string>
default: "remotejdk_11"- Versi runtime Java yang digunakan untuk menjalankan alat selama build
--[no]use_ijars
default: "true"- Jika diaktifkan, opsi ini akan menyebabkan kompilasi Java menggunakan jar antarmuka. Hal ini akan menghasilkan kompilasi inkremental yang lebih cepat, tetapi pesan error dapat berbeda.
Opsi Dump
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika disetel, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Tindakan ini dimaksudkan untuk menghemat ruang disk.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Jika benar, gunakan string yang berasal dari URL download repositori sebagai canonical_id jika tidak ditentukan. Hal ini menyebabkan perubahan pada URL menghasilkan download ulang meskipun cache berisi download dengan hash yang sama. Hal ini dapat digunakan untuk memverifikasi bahwa perubahan URL tidak menyebabkan repositori yang rusak ditutupi oleh cache.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_repository_disable_download
: "false" -
Jika disetel, mendownload repositori eksternal tidak diizinkan.
Tag:experimental
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Menskalakan semua waktu tunggu terkait download http dengan faktor yang diberikan
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.
Tag:bazel_internal_configuration
- Opsi yang mengontrol output perintah:
- Default
--[no]action_cache
: "false" -
Membuang konten cache tindakan.
Tag:bazel_monitoring
- Default
--[no]packages
: "false" -
Buang konten cache paket.
Tag:bazel_monitoring
- Default
--[no]rule_classes
: "false" -
Buang class aturan.
Tag:bazel_monitoring
- Default
--[no]rules
: "false" -
Aturan dump, termasuk jumlah dan penggunaan memori (jika memori dilacak).
Tag:bazel_monitoring
--skyframe=<off, summary, count, deps or rdeps>
default: "nonaktif"-
Buang grafik Skyframe: 'nonaktif', 'ringkasan', 'jumlah', 'deps', atau 'rdeps'.
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.
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 yang memengaruhi seberapa ketat Bazel menerapkan input build yang valid (definisi aturan, kombinasi tanda, dll.):
--experimental_repository_hash_file=<a string>
default: ""-
Jika tidak kosong, menentukan file yang berisi nilai yang telah diselesaikan, yang akan digunakan untuk memverifikasi hash direktori repositori
Tag:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
beberapa penggunaan diakumulasikan-
Jika daftar aturan repositori yang hash direktori outputnya harus diverifikasi, asalkan file ditentukan oleh --experimental_repository_hash_file.
Tag:affects_outputs
,experimental
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
default: "true"-
No-op
Tag:no_op
,deprecated
,experimental
- Opsi yang terkait dengan output dan semantik Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan ditarik di registry tempat modul tersebut berasal (jika modul tersebut tidak berasal dari NonRegistryOverride). Jika tidak, versi yang dibatalkan akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang diizinkan untuk dibatalkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel 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
- Default
--check_direct_dependencies=<off, warning or error>
: "warning" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di 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 meningkatkan ketidakcocokan menjadi kegagalan penyelesaian.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "nonaktif"-
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan memperbaruinya jika ada perubahan, `error` untuk menggunakan file kunci tetapi menampilkan error jika file tersebut tidak terbaru, atau `off` agar tidak membaca dari atau menulis ke file kunci.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut 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`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari terlebih dahulu di registry awal, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry awal.
Tag:changes_inputs
- Opsi yang memengaruhi kejelasan, format, atau lokasi logging:
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dijalankan terbesar. Menetapkan opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika tidak kosong, baca file yang telah di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan caching jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali 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.
- Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`
Opsi Pengambilan
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika disetel, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Tindakan ini dimaksudkan untuk menghemat ruang disk.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Jika benar, gunakan string yang berasal dari URL download repositori sebagai canonical_id jika tidak ditentukan. Hal ini menyebabkan perubahan pada URL menghasilkan download ulang meskipun cache berisi download dengan hash yang sama. Hal ini dapat digunakan untuk memverifikasi bahwa perubahan URL tidak menyebabkan repositori yang rusak ditutupi oleh cache.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_repository_disable_download
: "false" -
Jika disetel, mendownload repositori eksternal tidak diizinkan.
Tag:experimental
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Menskalakan semua waktu tunggu terkait download http dengan faktor yang diberikan
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.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
--[no]incompatible_remote_dangling_symlinks
default: "true"-
Jika disetel ke benar (true) dan --incompatible_remote_symlinks juga benar (true), symlink dalam output tindakan diizinkan untuk tidak memiliki tujuan.
Tag:execution
,incompatible_change
--[no]incompatible_remote_symlinks
default: "true"-
Jika disetel ke benar (true), Bazel akan merepresentasikan symlink dalam output tindakan di protokol eksekusi/penyimpanan dalam cache jarak jauh. Jika tidak, symlink akan diikuti dan ditampilkan sebagai file atau direktori. Lihat #6631 untuk mengetahui detailnya.
Tag:execution
,incompatible_change
--[no]keep_going
[-k
] default: "false"-
Lanjutkan sebanyak mungkin setelah terjadi error. Meskipun target yang gagal dan target yang bergantung padanya tidak dapat dianalisis, prasyarat lain dari target ini dapat dianalisis.
Tag:eagerness_to_exit
- Default
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "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 yang memungkinkan pengguna mengonfigurasi output yang diinginkan, yang memengaruhi nilainya, bukan keberadaannya:
- Default
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
Jumlah maksimum file terbuka yang diizinkan selama upload artefak BEP.
Tag:affects_outputs
--remote_download_minimal
-
Tidak mendownload output build jarak jauh ke komputer lokal. Flag ini adalah pintasan untuk flag: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata, dan --remote_download_outputs=minimal.
Meluas menjadi:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
Tag:affects_outputs
- Default
--remote_download_outputs=<all, minimal or toplevel>
: "all" -
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', kecuali juga mendownload output target tingkat teratas ke komputer lokal. Kedua opsi ini dapat mengurangi waktu build secara signifikan jika bandwidth jaringan menjadi hambatan.
Tag:affects_outputs
--remote_download_symlink_template=<a string>
default: ""-
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 tingkat teratas ke komputer lokal. Flag ini adalah pintasan untuk flag: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata, dan --remote_download_outputs=toplevel.
Diperluas menjadi:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
Tag:affects_outputs
- Opsi yang memengaruhi seberapa ketat Bazel menerapkan input build yang valid (definisi aturan, kombinasi tanda, dll.):
--experimental_repository_hash_file=<a string>
default: ""-
Jika tidak kosong, menentukan file yang berisi nilai yang telah diselesaikan, yang akan digunakan untuk memverifikasi hash direktori repositori
Tag:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
beberapa penggunaan diakumulasikan-
Jika daftar aturan repositori yang hash direktori outputnya harus diverifikasi, asalkan file ditentukan oleh --experimental_repository_hash_file.
Tag:affects_outputs
,experimental
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
default: "true"-
No-op
Tag:no_op
,deprecated
,experimental
- Default
--[no]incompatible_config_setting_private_default_visibility
: "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:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan ditarik di registry tempat modul tersebut berasal (jika modul tersebut tidak berasal dari NonRegistryOverride). Jika tidak, versi yang dibatalkan akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang diizinkan untuk dibatalkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel 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
- Default
--check_direct_dependencies=<off, warning or error>
: "warning" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di 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 meningkatkan ketidakcocokan menjadi kegagalan penyelesaian.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "nonaktif"-
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan memperbaruinya jika ada perubahan, `error` untuk menggunakan file kunci tetapi menampilkan error jika file tersebut tidak terbaru, atau `off` agar tidak membaca dari atau menulis ke file kunci.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut 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`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari terlebih dahulu di registry awal, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry awal.
Tag:changes_inputs
- Opsi yang memengaruhi kejelasan, format, atau lokasi logging:
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dijalankan terbesar. Menetapkan opsi ini akan menulis statistik untuk semua mnemonik.
--experimental_repository_resolved_file=<a string>
default: ""-
Jika tidak kosong, tulis nilai Starlark dengan informasi yang telah diselesaikan dari semua aturan repositori Starlark yang dieksekusi.
Tag:affects_outputs
- Default
--remote_print_execution_messages=<failure, success or all>
: "failure" -
Pilih waktu untuk mencetak pesan eksekusi jarak jauh. Nilai yang valid adalah `failure` untuk mencetak hanya pada kegagalan, `success` untuk mencetak hanya pada keberhasilan, dan `all` untuk selalu mencetak.
Tag:terminal_output
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika tidak kosong, baca file yang telah di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan caching jarak jauh:
--experimental_circuit_breaker_strategy=<failure>
default: lihat deskripsi-
Menentukan strategi yang akan digunakan pemutus sirkuit. Strategi yang tersedia adalah "kegagalan". Jika nilai opsi tidak valid, perilakunya sama seperti jika opsi tidak ditetapkan.
Tag:execution
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali 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.
- Default
--[no]experimental_guard_against_concurrent_changes
: "false" - Nonaktifkan opsi ini untuk menonaktifkan pemeriksaan ctime file input tindakan sebelum menguploadnya ke cache jarak jauh. Mungkin ada kasus saat kernel Linux menunda penulisan file, yang dapat menyebabkan positif palsu.
- Default
--experimental_remote_build_event_upload=<all or minimal>
: "all" - 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 'all'.
- Default
--[no]experimental_remote_cache_async
: "false" - Jika benar, I/O cache jarak jauh akan terjadi di latar belakang, bukan sebagai bagian dari proses spawn.
- Default
--[no]experimental_remote_cache_compression
: "false" - Jika diaktifkan, kompres/dekompresi blob cache dengan zstd.
--experimental_remote_capture_corrupted_outputs=<a path>
default: lihat deskripsi- Jalur ke direktori tempat output yang rusak akan diambil.
- Default
--[no]experimental_remote_discard_merkle_trees
: "false" - Jika disetel ke benar (true), buang 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 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
- Default
--[no]experimental_remote_downloader_local_fallback
: "false" - Apakah akan kembali ke downloader lokal jika downloader jarak jauh gagal.
- Default
--[no]experimental_remote_execution_keepalive
: "false" - Apakah akan menggunakan keep-alive untuk panggilan eksekusi jarak jauh.
- Default
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
: "10" -
Menetapkan jumlah tingkat kegagalan yang diizinkan dalam persentase untuk jangka waktu tertentu setelah itu berhenti memanggil cache/pelaksana jarak jauh. Secara default, nilainya adalah 10. Jika disetel ke 0, tidak ada batasan.
Tag:execution
- Default
--experimental_remote_failure_window_interval=<An immutable length of time.>
: "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 satuan tidak disertakan, nilai akan ditafsirkan sebagai detik.
Tag:execution
- Default
--[no]experimental_remote_mark_tool_inputs
: "false" - Jika disetel ke benar (true), Bazel akan menandai input sebagai input alat untuk eksekutor jarak jauh. Hal ini dapat digunakan untuk menerapkan pekerja persisten jarak jauh.
- Default
--[no]experimental_remote_merkle_tree_cache
: "false" - Jika disetel ke benar (true), perhitungan pohon Merkle akan di-memoize untuk meningkatkan kecepatan pemeriksaan hit cache jarak jauh. Jejak memori cache dikontrol oleh --experimental_remote_merkle_tree_cache_size.
- Default
--experimental_remote_merkle_tree_cache_size=<a long integer>
: "1000" - Jumlah pohon Merkle yang akan di-memoize untuk meningkatkan kecepatan pemeriksaan hit cache jarak jauh. Meskipun cache dipangkas secara otomatis sesuai dengan penanganan referensi lemah Java, error kehabisan memori dapat terjadi jika ditetapkan terlalu tinggi. Jika disetel ke 0, ukuran cache tidak terbatas. Nilai optimal bervariasi bergantung pada ukuran project. Default-nya adalah 1.000.
- Default
--[no]experimental_remote_require_cached
: "false" - Jika disetel ke benar (true), pastikan semua tindakan yang dapat dijalankan dari jarak jauh di-cache, atau build akan gagal. 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.
- Default
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "false" - Jika disetel ke benar (true), output yang dirujuk oleh BEP tidak diupload ke cache jarak jauh jika tindakan pembuatan tidak dapat di-cache dari jarak jauh.
--[no]incompatible_remote_downloader_send_all_headers
default: "true"-
Apakah akan mengirim semua nilai header multinilai ke downloader jarak jauh, bukan hanya yang pertama.
Tag:incompatible_change
- Default
--[no]incompatible_remote_output_paths_relative_to_input_root
: "false" -
Jika disetel ke benar (true), jalur output bersifat relatif terhadap root input, bukan direktori kerja.
Tag:incompatible_change
--[no]incompatible_remote_results_ignore_disk
default: "true"-
Jika disetel ke benar, --noremote_upload_local_results dan --noremote_accept_cached tidak akan berlaku untuk cache disk. Jika cache gabungan digunakan:
--noremote_upload_local_results akan menyebabkan hasil ditulis ke cache disk, tetapi tidak diupload ke cache jarak jauh.
--noremote_accept_cached akan menyebabkan Bazel memeriksa hasil di cache disk, tetapi tidak di cache jarak jauh.
Tindakan no-remote-exec dapat mengakses cache disk.
Lihat #8216 untuk mengetahui detailnya.
Tag:incompatible_change
- Default
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
: "false" -
Jika disetel ke benar (true), Bazel akan menggunakan kode keluar baru 39, bukan 34, jika cache jarak jauh mengeluarkan blob selama build.
Tag:incompatible_change
--[no]remote_accept_cached
default: "true"- Apakah akan menerima hasil tindakan yang di-cache dari jarak jauh.
--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
--remote_cache_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan- Tentukan header yang akan disertakan dalam permintaan cache: --remote_cache_header=Name=Value. Beberapa header dapat diteruskan dengan menentukan tanda beberapa kali. Beberapa nilai untuk nama yang sama akan dikonversi menjadi daftar yang dipisahkan koma.
--remote_default_exec_properties=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan-
Menetapkan properti exec default yang akan digunakan sebagai platform eksekusi jarak jauh jika platform eksekusi belum menetapkan exec_properties.
Tag:affects_outputs
--remote_default_platform_properties=<a string>
default: ""- Menetapkan properti platform default yang akan ditetapkan untuk API eksekusi jarak jauh, jika platform eksekusi belum menetapkan remote_execution_properties. Nilai ini juga akan digunakan jika platform host dipilih sebagai platform eksekusi untuk eksekusi jarak jauh.
--remote_downloader_header=<a 'name=value' assignment>
beberapa penggunaan 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.
--remote_exec_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan- Tentukan header yang akan disertakan dalam permintaan eksekusi: --remote_exec_header=Name=Value. Beberapa header dapat diteruskan dengan menentukan tanda beberapa kali. Beberapa nilai untuk nama yang sama akan dikonversi menjadi daftar yang dipisahkan koma.
- Default
--remote_execution_priority=<an integer>
: "0" - Prioritas relatif tindakan yang akan 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).
--remote_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan- Tentukan header yang akan disertakan dalam permintaan: --remote_header=Name=Value. Beberapa header dapat diteruskan dengan menentukan 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.
- Default
--[no]remote_local_fallback
: "false" - Apakah akan beralih kembali ke strategi eksekusi lokal mandiri jika eksekusi jarak jauh gagal.
- Default
--remote_local_fallback_strategy=<a string>
: "local" - No-op, tidak digunakan lagi. Lihat https://github.com/bazelbuild/bazel/issues/7480 untuk mengetahui detailnya.
- Default
--remote_max_connections=<an integer>
: "100" -
Batasi jumlah maksimum koneksi serentak ke cache/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/executor jarak jauh gRPC, satu saluran gRPC biasanya dapat menangani 100+ permintaan serentak, sehingga Bazel dapat membuat sekitar `--remote_max_connections * 100` permintaan serentak.
Tag:host_machine_resource_optimizations
--remote_proxy=<a string>
default: lihat deskripsi- Hubungkan ke cache jarak jauh melalui proxy. Saat ini, tanda ini hanya dapat digunakan untuk mengonfigurasi soket domain Unix (unix:/path/to/socket).
- Default
--remote_result_cache_priority=<an integer>
: "0" - Prioritas relatif tindakan jarak jauh yang akan disimpan 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 satuan tidak disertakan, nilai akan ditafsirkan sebagai detik.
- Default
--remote_timeout=<An immutable length of time.>
: "60s" - Jumlah waktu maksimum untuk menunggu panggilan cache dan eksekusi jarak jauh. 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 satuan 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.:
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
beberapa penggunaan diakumulasikan- Mengonfigurasi helper kredensial yang akan digunakan untuk 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 https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md untuk mengetahui detailnya.
- Default
--credential_helper_cache_duration=<An immutable length of time.>
: "30m" - Durasi kredensial yang disediakan oleh helper kredensial di-cache. Memanggil dengan nilai yang berbeda akan menyesuaikan masa aktif entri yang sudah ada; teruskan nol untuk menghapus cache. Perintah clean selalu menghapus cache, terlepas dari tanda ini.
--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.
--deleted_packages=<comma-separated list of package names>
default: ""- 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.
--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.
--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.
- Default
--[no]google_default_credentials
: "false" - Apakah akan menggunakan 'Kredensial Default Aplikasi Google' untuk autentikasi. Lihat https://cloud.google.com/docs/authentication untuk mengetahui detailnya. Dinonaktifkan secara default.
--grpc_keepalive_time=<An immutable length of time.>
default: lihat deskripsi- 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. Waktu diperlakukan sebagai perincian detik; error jika menetapkan nilai kurang dari satu detik. Secara default, ping keep-alive dinonaktifkan. Anda harus berkoordinasi dengan pemilik layanan sebelum mengaktifkan setelan ini. Misalnya, untuk menetapkan nilai 30 detik ke tanda ini, Anda harus melakukannya seperti ini --grpc_keepalive_time=30s
- Default
--grpc_keepalive_timeout=<An immutable length of time.>
: "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 balasan ping setelah jangka waktu ini. Waktu diperlakukan sebagai perincian detik; error jika menetapkan nilai kurang dari satu detik. Jika ping tetap aktif dinonaktifkan, setelan ini akan diabaikan.
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`
- Default
--package_path=<colon-separated list of options>
: "%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:".
--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.
Opsi Bantuan
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika disetel, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Tindakan ini dimaksudkan untuk menghemat ruang disk.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Jika benar, gunakan string yang berasal dari URL download repositori sebagai canonical_id jika tidak ditentukan. Hal ini menyebabkan perubahan pada URL menghasilkan download ulang meskipun cache berisi download dengan hash yang sama. Hal ini dapat digunakan untuk memverifikasi bahwa perubahan URL tidak menyebabkan repositori yang rusak ditutupi oleh cache.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_repository_disable_download
: "false" -
Jika disetel, mendownload repositori eksternal tidak diizinkan.
Tag:experimental
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Menskalakan semua waktu tunggu terkait download http dengan faktor yang diberikan
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.
Tag:bazel_internal_configuration
- Opsi yang memengaruhi seberapa ketat Bazel menerapkan input build yang valid (definisi aturan, kombinasi tanda, dll.):
--experimental_repository_hash_file=<a string>
default: ""-
Jika tidak kosong, menentukan file yang berisi nilai yang telah diselesaikan, yang akan digunakan untuk memverifikasi hash direktori repositori
Tag:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
beberapa penggunaan diakumulasikan-
Jika daftar aturan repositori yang hash direktori outputnya harus diverifikasi, asalkan file ditentukan oleh --experimental_repository_hash_file.
Tag:affects_outputs
,experimental
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
default: "true"-
No-op
Tag:no_op
,deprecated
,experimental
- Opsi yang terkait dengan output dan semantik Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan ditarik di registry tempat modul tersebut berasal (jika modul tersebut tidak berasal dari NonRegistryOverride). Jika tidak, versi yang dibatalkan akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang diizinkan untuk dibatalkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel 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
- Default
--check_direct_dependencies=<off, warning or error>
: "warning" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di 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 meningkatkan ketidakcocokan menjadi kegagalan penyelesaian.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "nonaktif"-
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan memperbaruinya jika ada perubahan, `error` untuk menggunakan file kunci tetapi menampilkan error jika file tersebut tidak terbaru, atau `off` agar tidak membaca dari atau menulis ke file kunci.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut 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`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari terlebih dahulu di registry awal, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry awal.
Tag:changes_inputs
- Opsi yang memengaruhi kejelasan, format, atau lokasi logging:
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dijalankan terbesar. Menetapkan opsi ini akan menulis statistik untuk semua mnemonik.
- Default
--help_verbosity=<long, medium or short>
: "medium" -
Pilih kejelasan perintah bantuan.
Tag:affects_outputs
,terminal_output
--long
[-l
]-
Tampilkan deskripsi lengkap setiap opsi, bukan hanya namanya.
Diperluas menjadi:
--help_verbosity=long
Tag:affects_outputs
,terminal_output
--short
-
Tampilkan hanya nama opsi, bukan jenis atau artinya.
Diperluas menjadi:
--help_verbosity=short
Tag:affects_outputs
,terminal_output
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika tidak kosong, baca file yang telah di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan caching jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali 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.
- Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`
Opsi Info
Mewarisi semua opsi dari build.
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
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
- Default
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Jika benar, gunakan string yang berasal dari URL download repositori sebagai canonical_id jika tidak ditentukan. Hal ini menyebabkan perubahan pada URL menghasilkan download ulang meskipun cache berisi download dengan hash yang sama. Hal ini dapat digunakan untuk memverifikasi bahwa perubahan URL tidak menyebabkan repositori yang rusak ditutupi oleh cache.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_repository_disable_download
: "false" -
Jika disetel, mendownload repositori eksternal tidak diizinkan.
Tag:experimental
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Menskalakan semua waktu tunggu terkait download http dengan faktor yang diberikan
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.
Tag:bazel_internal_configuration
- Opsi yang memengaruhi seberapa ketat Bazel menerapkan input build yang valid (definisi aturan, kombinasi tanda, dll.):
--experimental_repository_hash_file=<a string>
default: ""-
Jika tidak kosong, menentukan file yang berisi nilai yang telah diselesaikan, yang akan digunakan untuk memverifikasi hash direktori repositori
Tag:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
beberapa penggunaan diakumulasikan-
Jika daftar aturan repositori yang hash direktori outputnya harus diverifikasi, asalkan file ditentukan oleh --experimental_repository_hash_file.
Tag:affects_outputs
,experimental
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
default: "true"-
No-op
Tag:no_op
,deprecated
,experimental
- Opsi yang terkait dengan output dan semantik Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan ditarik di registry tempat modul tersebut berasal (jika modul tersebut tidak berasal dari NonRegistryOverride). Jika tidak, versi yang dibatalkan akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang diizinkan untuk dibatalkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel 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
- Default
--check_direct_dependencies=<off, warning or error>
: "warning" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di 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 meningkatkan ketidakcocokan menjadi kegagalan penyelesaian.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "nonaktif"-
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan memperbaruinya jika ada perubahan, `error` untuk menggunakan file kunci tetapi menampilkan error jika file tersebut tidak terbaru, atau `off` agar tidak membaca dari atau menulis ke file kunci.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut 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`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari terlebih dahulu di registry awal, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry awal.
Tag:changes_inputs
- Opsi yang memengaruhi kejelasan, format, atau lokasi logging:
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dijalankan terbesar. Menetapkan opsi ini akan menulis statistik untuk semua mnemonik.
- Default
--[no]show_make_env
: "false" -
Sertakan lingkungan "Make" dalam output.
Tag:affects_outputs
,terminal_output
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika tidak kosong, baca file yang telah di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan caching jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali 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.
- Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`
Opsi Lisensi
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
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
- Default
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Jika benar, gunakan string yang berasal dari URL download repositori sebagai canonical_id jika tidak ditentukan. Hal ini menyebabkan perubahan pada URL menghasilkan download ulang meskipun cache berisi download dengan hash yang sama. Hal ini dapat digunakan untuk memverifikasi bahwa perubahan URL tidak menyebabkan repositori yang rusak ditutupi oleh cache.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_repository_disable_download
: "false" -
Jika disetel, mendownload repositori eksternal tidak diizinkan.
Tag:experimental
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Menskalakan semua waktu tunggu terkait download http dengan faktor yang diberikan
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.
Tag:bazel_internal_configuration
- Opsi yang memengaruhi seberapa ketat Bazel menerapkan input build yang valid (definisi aturan, kombinasi tanda, dll.):
--experimental_repository_hash_file=<a string>
default: ""-
Jika tidak kosong, menentukan file yang berisi nilai yang telah diselesaikan, yang akan digunakan untuk memverifikasi hash direktori repositori
Tag:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
beberapa penggunaan diakumulasikan-
Jika daftar aturan repositori yang hash direktori outputnya harus diverifikasi, asalkan file ditentukan oleh --experimental_repository_hash_file.
Tag:affects_outputs
,experimental
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
default: "true"-
No-op
Tag:no_op
,deprecated
,experimental
- Opsi yang terkait dengan output dan semantik Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan ditarik di registry tempat modul tersebut berasal (jika modul tersebut tidak berasal dari NonRegistryOverride). Jika tidak, versi yang dibatalkan akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang diizinkan untuk dibatalkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel 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
- Default
--check_direct_dependencies=<off, warning or error>
: "warning" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di 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 meningkatkan ketidakcocokan menjadi kegagalan penyelesaian.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "nonaktif"-
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan memperbaruinya jika ada perubahan, `error` untuk menggunakan file kunci tetapi menampilkan error jika file tersebut tidak terbaru, atau `off` agar tidak membaca dari atau menulis ke file kunci.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut 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`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari terlebih dahulu di registry awal, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry awal.
Tag:changes_inputs
- Opsi yang memengaruhi kejelasan, format, atau lokasi logging:
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dijalankan terbesar. Menetapkan opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika tidak kosong, baca file yang telah di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan caching jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali 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.
- Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`
Opsi Penginstalan Seluler
Mewarisi semua opsi dari build.
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
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
- Default
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Jika benar, gunakan string yang berasal dari URL download repositori sebagai canonical_id jika tidak ditentukan. Hal ini menyebabkan perubahan pada URL menghasilkan download ulang meskipun cache berisi download dengan hash yang sama. Hal ini dapat digunakan untuk memverifikasi bahwa perubahan URL tidak menyebabkan repositori yang rusak ditutupi oleh cache.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_repository_disable_download
: "false" -
Jika disetel, mendownload repositori eksternal tidak diizinkan.
Tag:experimental
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Menskalakan semua waktu tunggu terkait download http dengan faktor yang diberikan
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.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--mode=<classic, classic_internal_test_do_not_use or skylark>
: "klasik" -
Pilih cara menjalankan penginstalan seluler. "classic" menjalankan versi penginstalan seluler saat ini. "skylark" menggunakan versi Starlark baru, yang memiliki dukungan untuk android_test.
Tag:loading_and_analysis
,execution
,incompatible_change
- Opsi yang mengonfigurasi toolchain yang digunakan untuk eksekusi tindakan:
--adb=<a string>
default: ""-
biner adb yang akan digunakan untuk perintah 'mobile-install'. Jika tidak ditentukan, SDK yang ada di Android SDK yang ditentukan oleh opsi command line --android_sdk (atau SDK default jika --android_sdk tidak ditentukan) akan digunakan.
Tag:changes_inputs
- Opsi yang mengontrol output perintah:
- Default
--[no]incremental
: "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 (default), selalu lakukan penginstalan penuh.
Tag:loading_and_analysis
- Default
--[no]split_apks
: "false" -
Apakah akan menggunakan APK terpisah untuk menginstal dan mengupdate aplikasi di perangkat. Hanya berfungsi dengan perangkat yang menjalankan Marshmallow atau yang lebih baru
Tag:loading_and_analysis
,affects_outputs
- Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, yang memengaruhi nilainya, bukan keberadaannya:
--adb_arg=<a string>
beberapa penggunaan diakumulasikan-
Argumen tambahan untuk diteruskan ke adb. Biasanya digunakan untuk menetapkan perangkat yang akan diinstal.
Tag:action_command_lines
--debug_app
-
Apakah akan menunggu debugger sebelum memulai aplikasi.
Diperluas menjadi:
--start=DEBUG
Tag:execution
--device=<a string>
default: ""-
Nomor seri perangkat adb. Jika tidak ditentukan, perangkat pertama akan digunakan.
Tag:action_command_lines
- Default
--start=<no, cold, warm or debug>
: "TIDAK" -
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.
Diperluas menjadi:
--start=COLD
Tag:execution
- Opsi yang memengaruhi seberapa ketat Bazel menerapkan input build yang valid (definisi aturan, kombinasi tanda, dll.):
--experimental_repository_hash_file=<a string>
default: ""-
Jika tidak kosong, menentukan file yang berisi nilai yang telah diselesaikan, yang akan digunakan untuk memverifikasi hash direktori repositori
Tag:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
beberapa penggunaan diakumulasikan-
Jika daftar aturan repositori yang hash direktori outputnya harus diverifikasi, asalkan file ditentukan oleh --experimental_repository_hash_file.
Tag:affects_outputs
,experimental
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
default: "true"-
No-op
Tag:no_op
,deprecated
,experimental
- Opsi yang terkait dengan output dan semantik Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan ditarik di registry tempat modul tersebut berasal (jika modul tersebut tidak berasal dari NonRegistryOverride). Jika tidak, versi yang dibatalkan akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang diizinkan untuk dibatalkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel 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
- Default
--check_direct_dependencies=<off, warning or error>
: "warning" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di 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 meningkatkan ketidakcocokan menjadi kegagalan penyelesaian.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "nonaktif"-
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan memperbaruinya jika ada perubahan, `error` untuk menggunakan file kunci tetapi menampilkan error jika file tersebut tidak terbaru, atau `off` agar tidak membaca dari atau menulis ke file kunci.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut 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`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari terlebih dahulu di registry awal, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry awal.
Tag:changes_inputs
- Opsi yang memengaruhi kejelasan, format, atau lokasi logging:
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dijalankan terbesar. Menetapkan opsi ini akan menulis statistik untuk semua mnemonik.
--incremental_install_verbosity=<a string>
default: ""-
Tingkat kejelasan untuk penginstalan inkremental. Setel ke 1 untuk logging debug.
Tag:bazel_monitoring
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika tidak kosong, baca file yang telah di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan caching jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali 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.
- Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`
Opsi Modifikasi
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika disetel, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Tindakan ini dimaksudkan untuk menghemat ruang disk.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Jika benar, gunakan string yang berasal dari URL download repositori sebagai canonical_id jika tidak ditentukan. Hal ini menyebabkan perubahan pada URL menghasilkan download ulang meskipun cache berisi download dengan hash yang sama. Hal ini dapat digunakan untuk memverifikasi bahwa perubahan URL tidak menyebabkan repositori yang rusak ditutupi oleh cache.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_repository_disable_download
: "false" -
Jika disetel, mendownload repositori eksternal tidak diizinkan.
Tag:experimental
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Menskalakan semua waktu tunggu terkait download http dengan faktor yang diberikan
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.
Tag:bazel_internal_configuration
- 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
- Default
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
Jumlah thread paralel yang akan digunakan untuk fase pemuatan/analisis.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 yang memengaruhi seberapa ketat Bazel menerapkan input build yang valid (definisi aturan, kombinasi tanda, dll.):
--experimental_repository_hash_file=<a string>
default: ""-
Jika tidak kosong, menentukan file yang berisi nilai yang telah diselesaikan, yang akan digunakan untuk memverifikasi hash direktori repositori
Tag:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
beberapa penggunaan diakumulasikan-
Jika daftar aturan repositori yang hash direktori outputnya harus diverifikasi, asalkan file ditentukan oleh --experimental_repository_hash_file.
Tag:affects_outputs
,experimental
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
default: "true"-
No-op
Tag:no_op
,deprecated
,experimental
- Default
--[no]incompatible_config_setting_private_default_visibility
: "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 subperintah `mod`:
- Default
--base_module=<"<root>" for the root module; <module>@<version> for a specific version of a module; <module> for all versions of a module; @<name> for a repo with the given apparent name; or @@<name> for a repo with the given canonical name>
: "<root>" -
Tentukan modul yang relatif terhadap repositori target yang ditentukan akan ditafsirkan.
Tag:terminal_output
--charset=<utf8 or ascii>
default: "utf8"-
Memilih himpunan karakter yang akan digunakan untuk hierarki. Hanya memengaruhi output teks. Nilai yang valid adalah "utf8" atau "ascii". Defaultnya adalah "utf8"
Tag:terminal_output
- Default
--[no]cycles
: "false" -
Menunjukkan siklus dependensi di dalam hierarki yang ditampilkan, yang biasanya diabaikan secara default.
Tag:terminal_output
- Default
--depth=<an integer>
: "-1" -
Kedalaman tampilan maksimum pohon dependensi. Kedalaman 1 menampilkan dependensi langsung, misalnya. Untuk tree, path, dan all_paths, nilai defaultnya adalah Integer.MAX_VALUE, sedangkan untuk deps dan explain, nilai defaultnya adalah 1 (hanya menampilkan deps langsung dari root selain target leaf dan induknya).
Tag:terminal_output
--extension_filter=<a comma-separated list of <extension>s>
default: lihat deskripsi-
Hanya menampilkan 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
- Default
--extension_info=<hidden, usages, repos or all>
: "hidden" -
Tentukan seberapa banyak detail tentang penggunaan ekstensi yang akan disertakan dalam hasil kueri. "Penggunaan" hanya akan menampilkan nama ekstensi, "repos" juga akan menyertakan repositori yang diimpor dengan use_repo, dan "semua" 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
- Default
--from=<a comma-separated list of <module>s>
: "<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
- Default
--[no]include_builtin
: "false" -
Menyertakan modul bawaan dalam grafik dependensi. Dinonaktifkan secara default karena cukup berisik.
Tag:terminal_output
- Default
--[no]include_unused
: "false" -
Kueri juga akan mempertimbangkan dan menampilkan modul yang tidak digunakan, yang tidak ada dalam grafik penyelesaian modul setelah pemilihan (karena Pemilihan Versi Minimal atau aturan penggantian). Hal ini dapat memiliki efek yang berbeda untuk setiap jenis kueri, yaitu menyertakan jalur baru dalam perintah all_paths, atau dependensi tambahan dalam perintah explain.
Tag:terminal_output
--output=<text, json or graph>
default: "text"-
Format hasil kueri yang akan dicetak. Nilai yang diizinkan untuk kueri adalah: text, json, graph
Tag:terminal_output
- Default
--[no]verbose
: "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 terkait dengan output dan semantik Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan ditarik di registry tempat modul tersebut berasal (jika modul tersebut tidak berasal dari NonRegistryOverride). Jika tidak, versi yang dibatalkan akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang diizinkan untuk dibatalkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel 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
- Default
--check_direct_dependencies=<off, warning or error>
: "warning" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di 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 meningkatkan ketidakcocokan menjadi kegagalan penyelesaian.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "nonaktif"-
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan memperbaruinya jika ada perubahan, `error` untuk menggunakan file kunci tetapi menampilkan error jika file tersebut tidak terbaru, atau `off` agar tidak membaca dari atau menulis ke file kunci.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut 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`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari terlebih dahulu di registry awal, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry awal.
Tag:changes_inputs
- Opsi yang memengaruhi kejelasan, format, atau lokasi logging:
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dijalankan terbesar. Menetapkan opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika tidak kosong, baca file yang telah di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan caching jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali 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.
- Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
--deleted_packages=<comma-separated list of package names>
default: ""- 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.
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`
- Default
--package_path=<colon-separated list of options>
: "%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 Print_action
Mewarisi semua opsi dari build.
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika disetel, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Tindakan ini dimaksudkan untuk menghemat ruang disk.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Jika benar, gunakan string yang berasal dari URL download repositori sebagai canonical_id jika tidak ditentukan. Hal ini menyebabkan perubahan pada URL menghasilkan download ulang meskipun cache berisi download dengan hash yang sama. Hal ini dapat digunakan untuk memverifikasi bahwa perubahan URL tidak menyebabkan repositori yang rusak ditutupi oleh cache.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_repository_disable_download
: "false" -
Jika disetel, mendownload repositori eksternal tidak diizinkan.
Tag:experimental
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Menskalakan semua waktu tunggu terkait download http dengan faktor yang diberikan
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.
Tag:bazel_internal_configuration
- Opsi yang memengaruhi seberapa ketat Bazel menerapkan input build yang valid (definisi aturan, kombinasi tanda, dll.):
--experimental_repository_hash_file=<a string>
default: ""-
Jika tidak kosong, menentukan file yang berisi nilai yang telah diselesaikan, yang akan digunakan untuk memverifikasi hash direktori repositori
Tag:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
beberapa penggunaan diakumulasikan-
Jika daftar aturan repositori yang hash direktori outputnya harus diverifikasi, asalkan file ditentukan oleh --experimental_repository_hash_file.
Tag:affects_outputs
,experimental
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
default: "true"-
No-op
Tag:no_op
,deprecated
,experimental
- Opsi yang terkait dengan output dan semantik Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan ditarik di registry tempat modul tersebut berasal (jika modul tersebut tidak berasal dari NonRegistryOverride). Jika tidak, versi yang dibatalkan akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang diizinkan untuk dibatalkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel 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
- Default
--check_direct_dependencies=<off, warning or error>
: "warning" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di 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 meningkatkan ketidakcocokan menjadi kegagalan penyelesaian.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "nonaktif"-
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan memperbaruinya jika ada perubahan, `error` untuk menggunakan file kunci tetapi menampilkan error jika file tersebut tidak terbaru, atau `off` agar tidak membaca dari atau menulis ke file kunci.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut 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`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari terlebih dahulu di registry awal, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry awal.
Tag:changes_inputs
- Opsi yang memengaruhi kejelasan, format, atau lokasi logging:
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dijalankan terbesar. Menetapkan opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika tidak kosong, baca file yang telah di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan caching jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali 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.
- Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`
--print_action_mnemonics=<a string>
beberapa penggunaan diakumulasikan- Mencantumkan mnemonik yang akan digunakan untuk memfilter data print_action, tidak ada pemfilteran yang dilakukan jika dibiarkan kosong.
Opsi Kueri
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
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
- Default
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Jika benar, gunakan string yang berasal dari URL download repositori sebagai canonical_id jika tidak ditentukan. Hal ini menyebabkan perubahan pada URL menghasilkan download ulang meskipun cache berisi download dengan hash yang sama. Hal ini dapat digunakan untuk memverifikasi bahwa perubahan URL tidak menyebabkan repositori yang rusak ditutupi oleh cache.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_repository_disable_download
: "false" -
Jika disetel, mendownload repositori eksternal tidak diizinkan.
Tag:experimental
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Menskalakan semua waktu tunggu terkait download http dengan faktor yang diberikan
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.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
--[no]incompatible_remote_dangling_symlinks
default: "true"-
Jika disetel ke benar (true) dan --incompatible_remote_symlinks juga benar (true), symlink dalam output tindakan diizinkan untuk tidak memiliki tujuan.
Tag:execution
,incompatible_change
--[no]incompatible_remote_symlinks
default: "true"-
Jika disetel ke benar (true), Bazel akan merepresentasikan symlink dalam output tindakan di protokol eksekusi/penyimpanan dalam cache jarak jauh. Jika tidak, symlink akan diikuti dan ditampilkan sebagai file atau direktori. Lihat #6631 untuk mengetahui detailnya.
Tag:execution
,incompatible_change
--[no]keep_going
[-k
] default: "false"-
Lanjutkan sebanyak mungkin setelah terjadi error. Meskipun target yang gagal dan target yang bergantung padanya tidak dapat dianalisis, prasyarat lain dari target ini dapat dianalisis.
Tag:eagerness_to_exit
- Default
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "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 yang memungkinkan pengguna mengonfigurasi output yang diinginkan, yang memengaruhi nilainya, bukan keberadaannya:
- Default
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
Jumlah maksimum file terbuka yang diizinkan selama upload artefak BEP.
Tag:affects_outputs
--remote_download_minimal
-
Tidak mendownload output build jarak jauh ke komputer lokal. Flag ini adalah pintasan untuk flag: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata, dan --remote_download_outputs=minimal.
Meluas menjadi:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
Tag:affects_outputs
- Default
--remote_download_outputs=<all, minimal or toplevel>
: "all" -
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', kecuali juga mendownload output target tingkat teratas ke komputer lokal. Kedua opsi ini dapat mengurangi waktu build secara signifikan jika bandwidth jaringan menjadi hambatan.
Tag:affects_outputs
--remote_download_symlink_template=<a string>
default: ""-
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 tingkat teratas ke komputer lokal. Flag ini adalah pintasan untuk flag: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata, dan --remote_download_outputs=toplevel.
Diperluas menjadi:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
Tag:affects_outputs
- Opsi yang memengaruhi seberapa ketat Bazel menerapkan input build yang valid (definisi aturan, kombinasi tanda, dll.):
--experimental_repository_hash_file=<a string>
default: ""-
Jika tidak kosong, menentukan file yang berisi nilai yang telah diselesaikan, yang akan digunakan untuk memverifikasi hash direktori repositori
Tag:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
beberapa penggunaan diakumulasikan-
Jika daftar aturan repositori yang hash direktori outputnya harus diverifikasi, asalkan file ditentukan oleh --experimental_repository_hash_file.
Tag:affects_outputs
,experimental
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
default: "true"-
No-op
Tag:no_op
,deprecated
,experimental
- Default
--[no]incompatible_config_setting_private_default_visibility
: "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 kueri:
- Default
--aspect_deps=<off, conservative or precise>
: "konservatif" -
Cara mengatasi 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 berdasarkan 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
- Default
--[no]consistent_labels
: "false" -
Jika diaktifkan, setiap perintah kueri akan menghasilkan 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 perintah kueri dan/atau label yang berbeda yang dikeluarkan oleh aturan. Jika tidak diaktifkan, pemformat output bebas memancarkan nama repositori yang jelas (relatif terhadap repositori utama) untuk membuat output lebih mudah dibaca.
Tag:terminal_output
- Default
--[no]experimental_graphless_query
: "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 (true), 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
- Default
--graph:node_limit=<an integer>
: "512" -
Panjang maksimum string label untuk node grafik dalam output. Label yang lebih panjang akan dipotong; -1 berarti tidak ada pemotongan. Opsi ini hanya berlaku untuk --output=graph.
Tag:terminal_output
--[no]implicit_deps
default: "true"-
Jika diaktifkan, dependensi implisit akan disertakan dalam grafik dependensi tempat kueri 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_display_source_file_location
default: "true"-
Benar secara default, menampilkan target file sumber. Jika benar (true), menampilkan lokasi baris 1 file sumber dalam output lokasi. Flag ini hanya ada untuk tujuan migrasi.
Tag:terminal_output
,incompatible_change
--[no]incompatible_lexicographical_output
default: "true"-
Jika opsi ini disetel, output --order_output=auto akan diurutkan 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
- Default
--[no]infer_universe_scope
: "false" -
Jika disetel dan --universe_scope tidak disetel, 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 harus menggunakan opsi ini hanya jika Anda tahu apa yang Anda lakukan. Lihat https://bazel.build/reference/query#sky-query untuk mengetahui detail dan contohnya. Jika --universe_scope ditetapkan, nilai opsi ini akan diabaikan. Catatan: opsi ini hanya berlaku untuk `query` (yaitu, bukan `cquery`).
Tag:loading_and_analysis
- Default
--[no]line_terminator_null
: "false" -
Apakah setiap format diakhiri dengan \0, bukan baris baru.
Tag:terminal_output
--[no]nodep_deps
default: "true"-
Jika diaktifkan, dependensi dari atribut "nodep" akan disertakan dalam grafik dependensi tempat kueri beroperasi. Contoh umum atribut "nodep" adalah "visibility". Jalankan dan uraikan output `info build-language` untuk mempelajari semua atribut "nodep" dalam bahasa build.
Tag:build_file_semantics
--noorder_results
-
Menampilkan hasil dalam urutan yang bergantung (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
- Default
--order_output=<no, deps, auto or full>
: "auto" -
Menghasilkan output yang tidak berurutan (tidak), 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
-
Menampilkan hasil dalam urutan yang bergantung (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
- Default
--output=<a string>
: "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, xml.
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
- Default
--[no]proto:definition_stack
: "false" -
Isi kolom proto definition_stack, yang mencatat untuk setiap instance aturan, stack panggilan Starlark pada saat class aturan ditentukan.
Tag:terminal_output
--[no]proto:flatten_selects
default: "true"-
Jika diaktifkan, atribut yang dapat dikonfigurasi yang dibuat oleh select() akan diratakan. Untuk jenis daftar, representasi yang diratakan adalah daftar yang berisi setiap nilai peta pilihan tepat satu kali. Jenis skalar diratakan menjadi null.
Tag:build_file_semantics
- Default
--[no]proto:include_synthetic_attribute_hash
: "false" -
Apakah atribut $internal_attr_hash akan dihitung dan diisi atau tidak.
Tag:terminal_output
- Default
--[no]proto:instantiation_stack
: "false" -
Isi stack panggilan instansiasi setiap aturan. Perhatikan bahwa hal ini mengharuskan stack ada
Tag:terminal_output
--[no]proto:locations
default: "true"-
Apakah akan menampilkan informasi lokasi dalam output proto atau tidak.
Tag:terminal_output
- Default
--proto:output_rule_attrs=<comma-separated list of options>
: "all" -
Daftar atribut yang dipisahkan koma untuk disertakan dalam output. 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_inputs_and_outputs
default: "true"-
Apakah akan mengisi kolom rule_input dan rule_output 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
- Default
--[no]relative_locations
: "false" -
Jika benar, lokasi file BUILD dalam output xml dan proto akan bersifat relatif. Secara default, output lokasi adalah jalur absolut dan tidak akan konsisten di seluruh komputer. Anda dapat menyetel opsi ini ke benar (true) untuk mendapatkan hasil yang konsisten di seluruh perangkat.
Tag:terminal_output
- Default
--[no]strict_test_suite
: "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 target 'konfigurasi host' atau 'eksekusi' tidak akan disertakan dalam grafik dependensi yang digunakan kueri. Edge dependensi 'konfigurasi host', seperti yang berasal dari aturan 'proto_library' ke Pengompilasi Protokol, biasanya mengarah ke alat yang dieksekusi selama build, bukan bagian dari program 'target' yang sama.
Cquery: Jika dinonaktifkan, akan memfilter semua target yang dikonfigurasi yang melintasi transisi host atau 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 ada dalam konfigurasi host, hanya target yang dikonfigurasi host 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 atas diasumsikan sebagai target yang diuraikan dari ekspresi kueri. Catatan: Untuk cquery, tidak menentukan opsi ini dapat menyebabkan build rusak jika target yang diuraikan dari ekspresi kueri tidak dapat dibangun dengan opsi tingkat teratas.
Tag:loading_and_analysis
- Default
--[no]xml:default_values
: "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, output XML berisi nomor baris. Menonaktifkan opsi ini dapat membuat perbedaan lebih mudah dibaca. Opsi ini hanya berlaku untuk --output=xml.
Tag:terminal_output
- Opsi yang terkait dengan output dan semantik Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan ditarik di registry tempat modul tersebut berasal (jika modul tersebut tidak berasal dari NonRegistryOverride). Jika tidak, versi yang dibatalkan akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang diizinkan untuk dibatalkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel 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
- Default
--check_direct_dependencies=<off, warning or error>
: "warning" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di 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 meningkatkan ketidakcocokan menjadi kegagalan penyelesaian.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "nonaktif"-
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan memperbaruinya jika ada perubahan, `error` untuk menggunakan file kunci tetapi menampilkan error jika file tersebut tidak terbaru, atau `off` agar tidak membaca dari atau menulis ke file kunci.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut 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`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari terlebih dahulu di registry awal, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry awal.
Tag:changes_inputs
- Opsi yang memengaruhi kejelasan, format, atau lokasi logging:
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dijalankan terbesar. Menetapkan opsi ini akan menulis statistik untuk semua mnemonik.
--experimental_repository_resolved_file=<a string>
default: ""-
Jika tidak kosong, tulis nilai Starlark dengan informasi yang telah diselesaikan dari semua aturan repositori Starlark yang dieksekusi.
Tag:affects_outputs
- Default
--remote_print_execution_messages=<failure, success or all>
: "failure" -
Pilih waktu untuk mencetak pesan eksekusi jarak jauh. Nilai yang valid adalah `failure` untuk mencetak hanya pada kegagalan, `success` untuk mencetak hanya pada keberhasilan, dan `all` untuk selalu mencetak.
Tag:terminal_output
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika tidak kosong, baca file yang telah di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan caching jarak jauh:
--experimental_circuit_breaker_strategy=<failure>
default: lihat deskripsi-
Menentukan strategi yang akan digunakan pemutus sirkuit. Strategi yang tersedia adalah "kegagalan". Jika nilai opsi tidak valid, perilakunya sama seperti jika opsi tidak ditetapkan.
Tag:execution
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali 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.
- Default
--[no]experimental_guard_against_concurrent_changes
: "false" - Nonaktifkan opsi ini untuk menonaktifkan pemeriksaan ctime file input tindakan sebelum menguploadnya ke cache jarak jauh. Mungkin ada kasus saat kernel Linux menunda penulisan file, yang dapat menyebabkan positif palsu.
- Default
--experimental_remote_build_event_upload=<all or minimal>
: "all" - 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 'all'.
- Default
--[no]experimental_remote_cache_async
: "false" - Jika benar, I/O cache jarak jauh akan terjadi di latar belakang, bukan sebagai bagian dari proses spawn.
- Default
--[no]experimental_remote_cache_compression
: "false" - Jika diaktifkan, kompres/dekompresi blob cache dengan zstd.
--experimental_remote_capture_corrupted_outputs=<a path>
default: lihat deskripsi- Jalur ke direktori tempat output yang rusak akan diambil.
- Default
--[no]experimental_remote_discard_merkle_trees
: "false" - Jika disetel ke benar (true), buang 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 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
- Default
--[no]experimental_remote_downloader_local_fallback
: "false" - Apakah akan kembali ke downloader lokal jika downloader jarak jauh gagal.
- Default
--[no]experimental_remote_execution_keepalive
: "false" - Apakah akan menggunakan keep-alive untuk panggilan eksekusi jarak jauh.
- Default
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
: "10" -
Menetapkan jumlah tingkat kegagalan yang diizinkan dalam persentase untuk jangka waktu tertentu setelah itu berhenti memanggil cache/pelaksana jarak jauh. Secara default, nilainya adalah 10. Jika disetel ke 0, tidak ada batasan.
Tag:execution
- Default
--experimental_remote_failure_window_interval=<An immutable length of time.>
: "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 satuan tidak disertakan, nilai akan ditafsirkan sebagai detik.
Tag:execution
- Default
--[no]experimental_remote_mark_tool_inputs
: "false" - Jika disetel ke benar (true), Bazel akan menandai input sebagai input alat untuk eksekutor jarak jauh. Hal ini dapat digunakan untuk menerapkan pekerja persisten jarak jauh.
- Default
--[no]experimental_remote_merkle_tree_cache
: "false" - Jika disetel ke benar (true), perhitungan pohon Merkle akan di-memoize untuk meningkatkan kecepatan pemeriksaan hit cache jarak jauh. Jejak memori cache dikontrol oleh --experimental_remote_merkle_tree_cache_size.
- Default
--experimental_remote_merkle_tree_cache_size=<a long integer>
: "1000" - Jumlah pohon Merkle yang akan di-memoize untuk meningkatkan kecepatan pemeriksaan hit cache jarak jauh. Meskipun cache dipangkas secara otomatis sesuai dengan penanganan referensi lemah Java, error kehabisan memori dapat terjadi jika ditetapkan terlalu tinggi. Jika disetel ke 0, ukuran cache tidak terbatas. Nilai optimal bervariasi bergantung pada ukuran project. Default-nya adalah 1.000.
- Default
--[no]experimental_remote_require_cached
: "false" - Jika disetel ke benar (true), pastikan semua tindakan yang dapat dijalankan dari jarak jauh di-cache, atau build akan gagal. 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.
- Default
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "false" - Jika disetel ke benar (true), output yang dirujuk oleh BEP tidak diupload ke cache jarak jauh jika tindakan pembuatan tidak dapat di-cache dari jarak jauh.
--[no]incompatible_remote_downloader_send_all_headers
default: "true"-
Apakah akan mengirim semua nilai header multinilai ke downloader jarak jauh, bukan hanya yang pertama.
Tag:incompatible_change
- Default
--[no]incompatible_remote_output_paths_relative_to_input_root
: "false" -
Jika disetel ke benar (true), jalur output bersifat relatif terhadap root input, bukan direktori kerja.
Tag:incompatible_change
--[no]incompatible_remote_results_ignore_disk
default: "true"-
Jika disetel ke benar, --noremote_upload_local_results dan --noremote_accept_cached tidak akan berlaku untuk cache disk. Jika cache gabungan digunakan:
--noremote_upload_local_results akan menyebabkan hasil ditulis ke cache disk, tetapi tidak diupload ke cache jarak jauh.
--noremote_accept_cached akan menyebabkan Bazel memeriksa hasil di cache disk, tetapi tidak di cache jarak jauh.
Tindakan no-remote-exec dapat mengakses cache disk.
Lihat #8216 untuk mengetahui detailnya.
Tag:incompatible_change
- Default
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
: "false" -
Jika disetel ke benar (true), Bazel akan menggunakan kode keluar baru 39, bukan 34, jika cache jarak jauh mengeluarkan blob selama build.
Tag:incompatible_change
--[no]remote_accept_cached
default: "true"- Apakah akan menerima hasil tindakan yang di-cache dari jarak jauh.
--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
--remote_cache_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan- Tentukan header yang akan disertakan dalam permintaan cache: --remote_cache_header=Name=Value. Beberapa header dapat diteruskan dengan menentukan tanda beberapa kali. Beberapa nilai untuk nama yang sama akan dikonversi menjadi daftar yang dipisahkan koma.
--remote_default_exec_properties=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan-
Menetapkan properti exec default yang akan digunakan sebagai platform eksekusi jarak jauh jika platform eksekusi belum menetapkan exec_properties.
Tag:affects_outputs
--remote_default_platform_properties=<a string>
default: ""- Menetapkan properti platform default yang akan ditetapkan untuk API eksekusi jarak jauh, jika platform eksekusi belum menetapkan remote_execution_properties. Nilai ini juga akan digunakan jika platform host dipilih sebagai platform eksekusi untuk eksekusi jarak jauh.
--remote_downloader_header=<a 'name=value' assignment>
beberapa penggunaan 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.
--remote_exec_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan- Tentukan header yang akan disertakan dalam permintaan eksekusi: --remote_exec_header=Name=Value. Beberapa header dapat diteruskan dengan menentukan tanda beberapa kali. Beberapa nilai untuk nama yang sama akan dikonversi menjadi daftar yang dipisahkan koma.
- Default
--remote_execution_priority=<an integer>
: "0" - Prioritas relatif tindakan yang akan 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).
--remote_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan- Tentukan header yang akan disertakan dalam permintaan: --remote_header=Name=Value. Beberapa header dapat diteruskan dengan menentukan 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.
- Default
--[no]remote_local_fallback
: "false" - Apakah akan beralih kembali ke strategi eksekusi lokal mandiri jika eksekusi jarak jauh gagal.
- Default
--remote_local_fallback_strategy=<a string>
: "local" - No-op, tidak digunakan lagi. Lihat https://github.com/bazelbuild/bazel/issues/7480 untuk mengetahui detailnya.
- Default
--remote_max_connections=<an integer>
: "100" -
Batasi jumlah maksimum koneksi serentak ke cache/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/executor jarak jauh gRPC, satu saluran gRPC biasanya dapat menangani 100+ permintaan serentak, sehingga Bazel dapat membuat sekitar `--remote_max_connections * 100` permintaan serentak.
Tag:host_machine_resource_optimizations
--remote_proxy=<a string>
default: lihat deskripsi- Hubungkan ke cache jarak jauh melalui proxy. Saat ini, tanda ini hanya dapat digunakan untuk mengonfigurasi soket domain Unix (unix:/path/to/socket).
- Default
--remote_result_cache_priority=<an integer>
: "0" - Prioritas relatif tindakan jarak jauh yang akan disimpan 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 satuan tidak disertakan, nilai akan ditafsirkan sebagai detik.
- Default
--remote_timeout=<An immutable length of time.>
: "60s" - Jumlah waktu maksimum untuk menunggu panggilan cache dan eksekusi jarak jauh. 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 satuan 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.:
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
beberapa penggunaan diakumulasikan- Mengonfigurasi helper kredensial yang akan digunakan untuk 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 https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md untuk mengetahui detailnya.
- Default
--credential_helper_cache_duration=<An immutable length of time.>
: "30m" - Durasi kredensial yang disediakan oleh helper kredensial di-cache. Memanggil dengan nilai yang berbeda akan menyesuaikan masa aktif entri yang sudah ada; teruskan nol untuk menghapus cache. Perintah clean selalu menghapus cache, terlepas dari tanda ini.
--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.
--deleted_packages=<comma-separated list of package names>
default: ""- 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.
--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.
--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.
- Default
--[no]google_default_credentials
: "false" - Apakah akan menggunakan 'Kredensial Default Aplikasi Google' untuk autentikasi. Lihat https://cloud.google.com/docs/authentication untuk mengetahui detailnya. Dinonaktifkan secara default.
--grpc_keepalive_time=<An immutable length of time.>
default: lihat deskripsi- 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. Waktu diperlakukan sebagai perincian detik; error jika menetapkan nilai kurang dari satu detik. Secara default, ping keep-alive dinonaktifkan. Anda harus berkoordinasi dengan pemilik layanan sebelum mengaktifkan setelan ini. Misalnya, untuk menetapkan nilai 30 detik ke tanda ini, Anda harus melakukannya seperti ini --grpc_keepalive_time=30s
- Default
--grpc_keepalive_timeout=<An immutable length of time.>
: "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 balasan ping setelah jangka waktu ini. Waktu diperlakukan sebagai perincian detik; error jika menetapkan nilai kurang dari satu detik. Jika ping tetap aktif dinonaktifkan, setelan ini akan diabaikan.
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`
- Default
--package_path=<colon-separated list of options>
: "%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:".
--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.
Opsi Jalankan
Mewarisi semua opsi dari build.
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika disetel, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Tindakan ini dimaksudkan untuk menghemat ruang disk.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Jika benar, gunakan string yang berasal dari URL download repositori sebagai canonical_id jika tidak ditentukan. Hal ini menyebabkan perubahan pada URL menghasilkan download ulang meskipun cache berisi download dengan hash yang sama. Hal ini dapat digunakan untuk memverifikasi bahwa perubahan URL tidak menyebabkan repositori yang rusak ditutupi oleh cache.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_repository_disable_download
: "false" -
Jika disetel, mendownload repositori eksternal tidak diizinkan.
Tag:experimental
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Menskalakan semua waktu tunggu terkait download http dengan faktor yang diberikan
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.
Tag:bazel_internal_configuration
- 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 seberapa ketat Bazel menerapkan input build yang valid (definisi aturan, kombinasi flag, dll.):
--experimental_repository_hash_file=<a string>
default: ""-
Jika tidak kosong, menentukan file yang berisi nilai yang telah diselesaikan, yang akan digunakan untuk memverifikasi hash direktori repositori
Tag:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
beberapa penggunaan diakumulasikan-
Jika daftar aturan repositori yang hash direktori outputnya harus diverifikasi, asalkan file ditentukan oleh --experimental_repository_hash_file.
Tag:affects_outputs
,experimental
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
default: "true"-
No-op
Tag:no_op
,deprecated
,experimental
- Opsi yang terkait dengan output dan semantik Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan ditarik di registry tempat modul tersebut berasal (jika modul tersebut tidak berasal dari NonRegistryOverride). Jika tidak, versi yang dibatalkan akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang diizinkan untuk dibatalkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel 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
- Default
--check_direct_dependencies=<off, warning or error>
: "warning" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di 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 meningkatkan ketidakcocokan menjadi kegagalan penyelesaian.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "nonaktif"-
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan memperbaruinya jika ada perubahan, `error` untuk menggunakan file kunci tetapi menampilkan error jika file tersebut tidak terbaru, atau `off` agar tidak membaca dari atau menulis ke file kunci.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut 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`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari terlebih dahulu di registry awal, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry awal.
Tag:changes_inputs
- Opsi yang memengaruhi kejelasan, format, atau lokasi logging:
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dijalankan terbesar. Menetapkan opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika tidak kosong, baca file yang telah di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan caching jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali 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.
- Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`
Opsi Mematikan
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika disetel, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Tindakan ini dimaksudkan untuk menghemat ruang disk.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Jika benar, gunakan string yang berasal dari URL download repositori sebagai canonical_id jika tidak ditentukan. Hal ini menyebabkan perubahan pada URL menghasilkan download ulang meskipun cache berisi download dengan hash yang sama. Hal ini dapat digunakan untuk memverifikasi bahwa perubahan URL tidak menyebabkan repositori yang rusak ditutupi oleh cache.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_repository_disable_download
: "false" -
Jika disetel, mendownload repositori eksternal tidak diizinkan.
Tag:experimental
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Menskalakan semua waktu tunggu terkait download http dengan faktor yang diberikan
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.
Tag:bazel_internal_configuration
- Opsi yang mengontrol output perintah:
- Default
--iff_heap_size_greater_than=<an integer>
: "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 yang memengaruhi seberapa ketat Bazel menerapkan input build yang valid (definisi aturan, kombinasi tanda, dll.):
--experimental_repository_hash_file=<a string>
default: ""-
Jika tidak kosong, menentukan file yang berisi nilai yang telah diselesaikan, yang akan digunakan untuk memverifikasi hash direktori repositori
Tag:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
beberapa penggunaan diakumulasikan-
Jika daftar aturan repositori yang hash direktori outputnya harus diverifikasi, asalkan file ditentukan oleh --experimental_repository_hash_file.
Tag:affects_outputs
,experimental
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
default: "true"-
No-op
Tag:no_op
,deprecated
,experimental
- Opsi yang terkait dengan output dan semantik Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan ditarik di registry tempat modul tersebut berasal (jika modul tersebut tidak berasal dari NonRegistryOverride). Jika tidak, versi yang dibatalkan akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang diizinkan untuk dibatalkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel 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
- Default
--check_direct_dependencies=<off, warning or error>
: "warning" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di 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 meningkatkan ketidakcocokan menjadi kegagalan penyelesaian.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "nonaktif"-
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan memperbaruinya jika ada perubahan, `error` untuk menggunakan file kunci tetapi menampilkan error jika file tersebut tidak terbaru, atau `off` agar tidak membaca dari atau menulis ke file kunci.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut 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`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari terlebih dahulu di registry awal, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry awal.
Tag:changes_inputs
- Opsi yang memengaruhi kejelasan, format, atau lokasi logging:
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dijalankan terbesar. Menetapkan opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika tidak kosong, baca file yang telah di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan caching jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali 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.
- Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`
Opsi Sinkronisasi
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
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
- Default
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Jika benar, gunakan string yang berasal dari URL download repositori sebagai canonical_id jika tidak ditentukan. Hal ini menyebabkan perubahan pada URL menghasilkan download ulang meskipun cache berisi download dengan hash yang sama. Hal ini dapat digunakan untuk memverifikasi bahwa perubahan URL tidak menyebabkan repositori yang rusak ditutupi oleh cache.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_repository_disable_download
: "false" -
Jika disetel, mendownload repositori eksternal tidak diizinkan.
Tag:experimental
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Menskalakan semua waktu tunggu terkait download http dengan faktor yang diberikan
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.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
- Default
--[no]configure
: "False" -
Hanya sinkronkan repositori yang ditandai sebagai 'configure' untuk tujuan konfigurasi sistem.
Tag:changes_inputs
--[no]incompatible_remote_dangling_symlinks
default: "true"-
Jika disetel ke benar (true) dan --incompatible_remote_symlinks juga benar (true), symlink dalam output tindakan diizinkan untuk tidak memiliki tujuan.
Tag:execution
,incompatible_change
--[no]incompatible_remote_symlinks
default: "true"-
Jika disetel ke benar (true), Bazel akan merepresentasikan symlink dalam output tindakan di protokol eksekusi/penyimpanan dalam cache jarak jauh. Jika tidak, symlink akan diikuti dan ditampilkan sebagai file atau direktori. Lihat #6631 untuk mengetahui detailnya.
Tag:execution
,incompatible_change
--[no]keep_going
[-k
] default: "false"-
Lanjutkan sebanyak mungkin setelah terjadi error. Meskipun target yang gagal dan target yang bergantung padanya tidak dapat dianalisis, prasyarat lain dari target ini dapat dianalisis.
Tag:eagerness_to_exit
- Default
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "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
--only=<a string>
beberapa penggunaan diakumulasikan-
Jika opsi ini diberikan, hanya sinkronkan repositori yang ditentukan dengan opsi ini. Tetap menganggap semua (atau semua yang seperti configure, jika --configure diberikan) sudah usang.
Tag:changes_inputs
- Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, yang memengaruhi nilainya, bukan keberadaannya:
- Default
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
Jumlah maksimum file terbuka yang diizinkan selama upload artefak BEP.
Tag:affects_outputs
--remote_download_minimal
-
Tidak mendownload output build jarak jauh ke komputer lokal. Flag ini adalah pintasan untuk flag: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata, dan --remote_download_outputs=minimal.
Meluas menjadi:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
Tag:affects_outputs
- Default
--remote_download_outputs=<all, minimal or toplevel>
: "all" -
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', kecuali juga mendownload output target tingkat teratas ke komputer lokal. Kedua opsi ini dapat mengurangi waktu build secara signifikan jika bandwidth jaringan menjadi hambatan.
Tag:affects_outputs
--remote_download_symlink_template=<a string>
default: ""-
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 tingkat teratas ke komputer lokal. Flag ini adalah pintasan untuk flag: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata, dan --remote_download_outputs=toplevel.
Diperluas menjadi:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
Tag:affects_outputs
- Opsi yang memengaruhi seberapa ketat Bazel menerapkan input build yang valid (definisi aturan, kombinasi tanda, dll.):
--experimental_repository_hash_file=<a string>
default: ""-
Jika tidak kosong, menentukan file yang berisi nilai yang telah diselesaikan, yang akan digunakan untuk memverifikasi hash direktori repositori
Tag:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
beberapa penggunaan diakumulasikan-
Jika daftar aturan repositori yang hash direktori outputnya harus diverifikasi, asalkan file ditentukan oleh --experimental_repository_hash_file.
Tag:affects_outputs
,experimental
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
default: "true"-
No-op
Tag:no_op
,deprecated
,experimental
- Default
--[no]incompatible_config_setting_private_default_visibility
: "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:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan ditarik di registry tempat modul tersebut berasal (jika modul tersebut tidak berasal dari NonRegistryOverride). Jika tidak, versi yang dibatalkan akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang diizinkan untuk dibatalkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel 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
- Default
--check_direct_dependencies=<off, warning or error>
: "warning" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di 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 meningkatkan ketidakcocokan menjadi kegagalan penyelesaian.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "nonaktif"-
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan memperbaruinya jika ada perubahan, `error` untuk menggunakan file kunci tetapi menampilkan error jika file tersebut tidak terbaru, atau `off` agar tidak membaca dari atau menulis ke file kunci.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut 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`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari terlebih dahulu di registry awal, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry awal.
Tag:changes_inputs
- Opsi yang memengaruhi kejelasan, format, atau lokasi logging:
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dijalankan terbesar. Menetapkan opsi ini akan menulis statistik untuk semua mnemonik.
--experimental_repository_resolved_file=<a string>
default: ""-
Jika tidak kosong, tulis nilai Starlark dengan informasi yang telah diselesaikan dari semua aturan repositori Starlark yang dieksekusi.
Tag:affects_outputs
- Default
--remote_print_execution_messages=<failure, success or all>
: "failure" -
Pilih waktu untuk mencetak pesan eksekusi jarak jauh. Nilai yang valid adalah `failure` untuk mencetak hanya pada kegagalan, `success` untuk mencetak hanya pada keberhasilan, dan `all` untuk selalu mencetak.
Tag:terminal_output
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika tidak kosong, baca file yang telah di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan caching jarak jauh:
--experimental_circuit_breaker_strategy=<failure>
default: lihat deskripsi-
Menentukan strategi yang akan digunakan pemutus sirkuit. Strategi yang tersedia adalah "kegagalan". Jika nilai opsi tidak valid, perilakunya sama seperti jika opsi tidak ditetapkan.
Tag:execution
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali 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.
- Default
--[no]experimental_guard_against_concurrent_changes
: "false" - Nonaktifkan opsi ini untuk menonaktifkan pemeriksaan ctime file input tindakan sebelum menguploadnya ke cache jarak jauh. Mungkin ada kasus saat kernel Linux menunda penulisan file, yang dapat menyebabkan positif palsu.
- Default
--experimental_remote_build_event_upload=<all or minimal>
: "all" - 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 'all'.
- Default
--[no]experimental_remote_cache_async
: "false" - Jika benar, I/O cache jarak jauh akan terjadi di latar belakang, bukan sebagai bagian dari proses spawn.
- Default
--[no]experimental_remote_cache_compression
: "false" - Jika diaktifkan, kompres/dekompresi blob cache dengan zstd.
--experimental_remote_capture_corrupted_outputs=<a path>
default: lihat deskripsi- Jalur ke direktori tempat output yang rusak akan diambil.
- Default
--[no]experimental_remote_discard_merkle_trees
: "false" - Jika disetel ke benar (true), buang 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 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
- Default
--[no]experimental_remote_downloader_local_fallback
: "false" - Apakah akan kembali ke downloader lokal jika downloader jarak jauh gagal.
- Default
--[no]experimental_remote_execution_keepalive
: "false" - Apakah akan menggunakan keep-alive untuk panggilan eksekusi jarak jauh.
- Default
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
: "10" -
Menetapkan jumlah tingkat kegagalan yang diizinkan dalam persentase untuk jangka waktu tertentu setelah itu berhenti memanggil cache/pelaksana jarak jauh. Secara default, nilainya adalah 10. Jika disetel ke 0, tidak ada batasan.
Tag:execution
- Default
--experimental_remote_failure_window_interval=<An immutable length of time.>
: "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 satuan tidak disertakan, nilai akan ditafsirkan sebagai detik.
Tag:execution
- Default
--[no]experimental_remote_mark_tool_inputs
: "false" - Jika disetel ke benar (true), Bazel akan menandai input sebagai input alat untuk eksekutor jarak jauh. Hal ini dapat digunakan untuk menerapkan pekerja persisten jarak jauh.
- Default
--[no]experimental_remote_merkle_tree_cache
: "false" - Jika disetel ke benar (true), perhitungan pohon Merkle akan di-memoize untuk meningkatkan kecepatan pemeriksaan hit cache jarak jauh. Jejak memori cache dikontrol oleh --experimental_remote_merkle_tree_cache_size.
- Default
--experimental_remote_merkle_tree_cache_size=<a long integer>
: "1000" - Jumlah pohon Merkle yang akan di-memoize untuk meningkatkan kecepatan pemeriksaan hit cache jarak jauh. Meskipun cache dipangkas secara otomatis sesuai dengan penanganan referensi lemah Java, error kehabisan memori dapat terjadi jika ditetapkan terlalu tinggi. Jika disetel ke 0, ukuran cache tidak terbatas. Nilai optimal bervariasi bergantung pada ukuran project. Default-nya adalah 1.000.
- Default
--[no]experimental_remote_require_cached
: "false" - Jika disetel ke benar (true), pastikan semua tindakan yang dapat dijalankan dari jarak jauh di-cache, atau build akan gagal. 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.
- Default
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "false" - Jika disetel ke benar (true), output yang dirujuk oleh BEP tidak diupload ke cache jarak jauh jika tindakan pembuatan tidak dapat di-cache dari jarak jauh.
--[no]incompatible_remote_downloader_send_all_headers
default: "true"-
Apakah akan mengirim semua nilai header multinilai ke downloader jarak jauh, bukan hanya yang pertama.
Tag:incompatible_change
- Default
--[no]incompatible_remote_output_paths_relative_to_input_root
: "false" -
Jika disetel ke benar (true), jalur output bersifat relatif terhadap root input, bukan direktori kerja.
Tag:incompatible_change
--[no]incompatible_remote_results_ignore_disk
default: "true"-
Jika disetel ke benar, --noremote_upload_local_results dan --noremote_accept_cached tidak akan berlaku untuk cache disk. Jika cache gabungan digunakan:
--noremote_upload_local_results akan menyebabkan hasil ditulis ke cache disk, tetapi tidak diupload ke cache jarak jauh.
--noremote_accept_cached akan menyebabkan Bazel memeriksa hasil di cache disk, tetapi tidak di cache jarak jauh.
Tindakan no-remote-exec dapat mengakses cache disk.
Lihat #8216 untuk mengetahui detailnya.
Tag:incompatible_change
- Default
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
: "false" -
Jika disetel ke benar (true), Bazel akan menggunakan kode keluar baru 39, bukan 34, jika cache jarak jauh mengeluarkan blob selama build.
Tag:incompatible_change
--[no]remote_accept_cached
default: "true"- Apakah akan menerima hasil tindakan yang di-cache dari jarak jauh.
--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
--remote_cache_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan- Tentukan header yang akan disertakan dalam permintaan cache: --remote_cache_header=Name=Value. Beberapa header dapat diteruskan dengan menentukan tanda beberapa kali. Beberapa nilai untuk nama yang sama akan dikonversi menjadi daftar yang dipisahkan koma.
--remote_default_exec_properties=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan-
Menetapkan properti exec default yang akan digunakan sebagai platform eksekusi jarak jauh jika platform eksekusi belum menetapkan exec_properties.
Tag:affects_outputs
--remote_default_platform_properties=<a string>
default: ""- Menetapkan properti platform default yang akan ditetapkan untuk API eksekusi jarak jauh, jika platform eksekusi belum menetapkan remote_execution_properties. Nilai ini juga akan digunakan jika platform host dipilih sebagai platform eksekusi untuk eksekusi jarak jauh.
--remote_downloader_header=<a 'name=value' assignment>
beberapa penggunaan 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.
--remote_exec_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan- Tentukan header yang akan disertakan dalam permintaan eksekusi: --remote_exec_header=Name=Value. Beberapa header dapat diteruskan dengan menentukan tanda beberapa kali. Beberapa nilai untuk nama yang sama akan dikonversi menjadi daftar yang dipisahkan koma.
- Default
--remote_execution_priority=<an integer>
: "0" - Prioritas relatif tindakan yang akan 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).
--remote_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan- Tentukan header yang akan disertakan dalam permintaan: --remote_header=Name=Value. Beberapa header dapat diteruskan dengan menentukan 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.
- Default
--[no]remote_local_fallback
: "false" - Apakah akan beralih kembali ke strategi eksekusi lokal mandiri jika eksekusi jarak jauh gagal.
- Default
--remote_local_fallback_strategy=<a string>
: "local" - No-op, tidak digunakan lagi. Lihat https://github.com/bazelbuild/bazel/issues/7480 untuk mengetahui detailnya.
- Default
--remote_max_connections=<an integer>
: "100" -
Batasi jumlah maksimum koneksi serentak ke cache/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/executor jarak jauh gRPC, satu saluran gRPC biasanya dapat menangani 100+ permintaan serentak, sehingga Bazel dapat membuat sekitar `--remote_max_connections * 100` permintaan serentak.
Tag:host_machine_resource_optimizations
--remote_proxy=<a string>
default: lihat deskripsi- Hubungkan ke cache jarak jauh melalui proxy. Saat ini, tanda ini hanya dapat digunakan untuk mengonfigurasi soket domain Unix (unix:/path/to/socket).
- Default
--remote_result_cache_priority=<an integer>
: "0" - Prioritas relatif tindakan jarak jauh yang akan disimpan 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 satuan tidak disertakan, nilai akan ditafsirkan sebagai detik.
- Default
--remote_timeout=<An immutable length of time.>
: "60s" - Jumlah waktu maksimum untuk menunggu panggilan cache dan eksekusi jarak jauh. 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 satuan 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.:
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
beberapa penggunaan diakumulasikan- Mengonfigurasi helper kredensial yang akan digunakan untuk 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 https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md untuk mengetahui detailnya.
- Default
--credential_helper_cache_duration=<An immutable length of time.>
: "30m" - Durasi kredensial yang disediakan oleh helper kredensial di-cache. Memanggil dengan nilai yang berbeda akan menyesuaikan masa aktif entri yang sudah ada; teruskan nol untuk menghapus cache. Perintah clean selalu menghapus cache, terlepas dari tanda ini.
--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.
--deleted_packages=<comma-separated list of package names>
default: ""- 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.
--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.
--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.
- Default
--[no]google_default_credentials
: "false" - Apakah akan menggunakan 'Kredensial Default Aplikasi Google' untuk autentikasi. Lihat https://cloud.google.com/docs/authentication untuk mengetahui detailnya. Dinonaktifkan secara default.
--grpc_keepalive_time=<An immutable length of time.>
default: lihat deskripsi- 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. Waktu diperlakukan sebagai perincian detik; error jika menetapkan nilai kurang dari satu detik. Secara default, ping keep-alive dinonaktifkan. Anda harus berkoordinasi dengan pemilik layanan sebelum mengaktifkan setelan ini. Misalnya, untuk menetapkan nilai 30 detik ke tanda ini, Anda harus melakukannya seperti ini --grpc_keepalive_time=30s
- Default
--grpc_keepalive_timeout=<An immutable length of time.>
: "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 balasan ping setelah jangka waktu ini. Waktu diperlakukan sebagai perincian detik; error jika menetapkan nilai kurang dari satu detik. Jika ping tetap aktif dinonaktifkan, setelan ini akan diabaikan.
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`
- Default
--package_path=<colon-separated list of options>
: "%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:".
--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.
Opsi Pengujian
Mewarisi semua opsi dari build.
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika disetel, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Tindakan ini dimaksudkan untuk menghemat ruang disk.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Jika benar, gunakan string yang berasal dari URL download repositori sebagai canonical_id jika tidak ditentukan. Hal ini menyebabkan perubahan pada URL menghasilkan download ulang meskipun cache berisi download dengan hash yang sama. Hal ini dapat digunakan untuk memverifikasi bahwa perubahan URL tidak menyebabkan repositori yang rusak ditutupi oleh cache.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_repository_disable_download
: "false" -
Jika disetel, mendownload repositori eksternal tidak diizinkan.
Tag:experimental
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Menskalakan semua waktu tunggu terkait download http dengan faktor yang diberikan
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.
Tag:bazel_internal_configuration
- Opsi yang mengontrol eksekusi build:
--[no]incompatible_remote_dangling_symlinks
default: "true"-
Jika disetel ke benar (true) dan --incompatible_remote_symlinks juga benar (true), symlink dalam output tindakan diizinkan untuk tidak memiliki tujuan.
Tag:execution
,incompatible_change
--[no]incompatible_remote_symlinks
default: "true"-
Jika disetel ke benar (true), Bazel akan merepresentasikan symlink dalam output tindakan di protokol eksekusi/penyimpanan dalam cache jarak jauh. Jika tidak, symlink akan diikuti dan ditampilkan sebagai file atau direktori. Lihat #6631 untuk mengetahui detailnya.
Tag:execution
,incompatible_change
- Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, yang memengaruhi nilainya, bukan keberadaannya:
- Default
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
Jumlah maksimum file terbuka yang diizinkan selama upload artefak BEP.
Tag:affects_outputs
--remote_download_minimal
-
Tidak mendownload output build jarak jauh ke komputer lokal. Flag ini adalah pintasan untuk flag: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata, dan --remote_download_outputs=minimal.
Meluas menjadi:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=minimal
Tag:affects_outputs
- Default
--remote_download_outputs=<all, minimal or toplevel>
: "all" -
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', kecuali juga mendownload output target tingkat teratas ke komputer lokal. Kedua opsi ini dapat mengurangi waktu build secara signifikan jika bandwidth jaringan menjadi hambatan.
Tag:affects_outputs
--remote_download_symlink_template=<a string>
default: ""-
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 tingkat teratas ke komputer lokal. Flag ini adalah pintasan untuk flag: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files, --experimental_action_cache_store_output_metadata, dan --remote_download_outputs=toplevel.
Diperluas menjadi:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--experimental_action_cache_store_output_metadata
--remote_download_outputs=toplevel
Tag:affects_outputs
- Opsi yang memengaruhi seberapa ketat Bazel menerapkan input build yang valid (definisi aturan, kombinasi tanda, dll.):
--experimental_repository_hash_file=<a string>
default: ""-
Jika tidak kosong, menentukan file yang berisi nilai yang telah diselesaikan, yang akan digunakan untuk memverifikasi hash direktori repositori
Tag:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
beberapa penggunaan diakumulasikan-
Jika daftar aturan repositori yang hash direktori outputnya harus diverifikasi, asalkan file ditentukan oleh --experimental_repository_hash_file.
Tag:affects_outputs
,experimental
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
default: "true"-
No-op
Tag:no_op
,deprecated
,experimental
- Opsi yang terkait dengan output dan semantik Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan ditarik di registry tempat modul tersebut berasal (jika modul tersebut tidak berasal dari NonRegistryOverride). Jika tidak, versi yang dibatalkan akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang diizinkan untuk dibatalkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel 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
- Default
--check_direct_dependencies=<off, warning or error>
: "warning" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di 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 meningkatkan ketidakcocokan menjadi kegagalan penyelesaian.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "nonaktif"-
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan memperbaruinya jika ada perubahan, `error` untuk menggunakan file kunci tetapi menampilkan error jika file tersebut tidak terbaru, atau `off` agar tidak membaca dari atau menulis ke file kunci.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut 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`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari terlebih dahulu di registry awal, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry awal.
Tag:changes_inputs
- Opsi yang memengaruhi kejelasan, format, atau lokasi logging:
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dijalankan terbesar. Menetapkan opsi ini akan menulis statistik untuk semua mnemonik.
- Default
--[no]print_relative_test_log_paths
: "false" -
Jika benar, saat mencetak jalur ke log pengujian, gunakan jalur relatif yang menggunakan 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
- Default
--remote_print_execution_messages=<failure, success or all>
: "failure" -
Pilih waktu untuk mencetak pesan eksekusi jarak jauh. Nilai yang valid adalah `failure` untuk mencetak hanya pada kegagalan, `success` untuk mencetak hanya pada keberhasilan, dan `all` untuk selalu mencetak.
Tag:terminal_output
- Default
--[no]test_verbose_timeout_warnings
: "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 yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika tidak kosong, baca file yang telah di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan caching jarak jauh:
--experimental_circuit_breaker_strategy=<failure>
default: lihat deskripsi-
Menentukan strategi yang akan digunakan pemutus sirkuit. Strategi yang tersedia adalah "kegagalan". Jika nilai opsi tidak valid, perilakunya sama seperti jika opsi tidak ditetapkan.
Tag:execution
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali 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.
- Default
--[no]experimental_guard_against_concurrent_changes
: "false" - Nonaktifkan opsi ini untuk menonaktifkan pemeriksaan ctime file input tindakan sebelum menguploadnya ke cache jarak jauh. Mungkin ada kasus saat kernel Linux menunda penulisan file, yang dapat menyebabkan positif palsu.
- Default
--experimental_remote_build_event_upload=<all or minimal>
: "all" - 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 'all'.
- Default
--[no]experimental_remote_cache_async
: "false" - Jika benar, I/O cache jarak jauh akan terjadi di latar belakang, bukan sebagai bagian dari proses spawn.
- Default
--[no]experimental_remote_cache_compression
: "false" - Jika diaktifkan, kompres/dekompresi blob cache dengan zstd.
--experimental_remote_capture_corrupted_outputs=<a path>
default: lihat deskripsi- Jalur ke direktori tempat output yang rusak akan diambil.
- Default
--[no]experimental_remote_discard_merkle_trees
: "false" - Jika disetel ke benar (true), buang 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 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
- Default
--[no]experimental_remote_downloader_local_fallback
: "false" - Apakah akan kembali ke downloader lokal jika downloader jarak jauh gagal.
- Default
--[no]experimental_remote_execution_keepalive
: "false" - Apakah akan menggunakan keep-alive untuk panggilan eksekusi jarak jauh.
- Default
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
: "10" -
Menetapkan jumlah tingkat kegagalan yang diizinkan dalam persentase untuk jangka waktu tertentu setelah itu berhenti memanggil cache/pelaksana jarak jauh. Secara default, nilainya adalah 10. Jika disetel ke 0, tidak ada batasan.
Tag:execution
- Default
--experimental_remote_failure_window_interval=<An immutable length of time.>
: "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 satuan tidak disertakan, nilai akan ditafsirkan sebagai detik.
Tag:execution
- Default
--[no]experimental_remote_mark_tool_inputs
: "false" - Jika disetel ke benar (true), Bazel akan menandai input sebagai input alat untuk eksekutor jarak jauh. Hal ini dapat digunakan untuk menerapkan pekerja persisten jarak jauh.
- Default
--[no]experimental_remote_merkle_tree_cache
: "false" - Jika disetel ke benar (true), perhitungan pohon Merkle akan di-memoize untuk meningkatkan kecepatan pemeriksaan hit cache jarak jauh. Jejak memori cache dikontrol oleh --experimental_remote_merkle_tree_cache_size.
- Default
--experimental_remote_merkle_tree_cache_size=<a long integer>
: "1000" - Jumlah pohon Merkle yang akan di-memoize untuk meningkatkan kecepatan pemeriksaan hit cache jarak jauh. Meskipun cache dipangkas secara otomatis sesuai dengan penanganan referensi lemah Java, error kehabisan memori dapat terjadi jika ditetapkan terlalu tinggi. Jika disetel ke 0, ukuran cache tidak terbatas. Nilai optimal bervariasi bergantung pada ukuran project. Default-nya adalah 1.000.
- Default
--[no]experimental_remote_require_cached
: "false" - Jika disetel ke benar (true), pastikan semua tindakan yang dapat dijalankan dari jarak jauh di-cache, atau build akan gagal. 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.
- Default
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "false" - Jika disetel ke benar (true), output yang dirujuk oleh BEP tidak diupload ke cache jarak jauh jika tindakan pembuatan tidak dapat di-cache dari jarak jauh.
--[no]incompatible_remote_downloader_send_all_headers
default: "true"-
Apakah akan mengirim semua nilai header multinilai ke downloader jarak jauh, bukan hanya yang pertama.
Tag:incompatible_change
- Default
--[no]incompatible_remote_output_paths_relative_to_input_root
: "false" -
Jika disetel ke benar (true), jalur output bersifat relatif terhadap root input, bukan direktori kerja.
Tag:incompatible_change
--[no]incompatible_remote_results_ignore_disk
default: "true"-
Jika disetel ke benar, --noremote_upload_local_results dan --noremote_accept_cached tidak akan berlaku untuk cache disk. Jika cache gabungan digunakan:
--noremote_upload_local_results akan menyebabkan hasil ditulis ke cache disk, tetapi tidak diupload ke cache jarak jauh.
--noremote_accept_cached akan menyebabkan Bazel memeriksa hasil di cache disk, tetapi tidak di cache jarak jauh.
Tindakan no-remote-exec dapat mengakses cache disk.
Lihat #8216 untuk mengetahui detailnya.
Tag:incompatible_change
- Default
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
: "false" -
Jika disetel ke benar (true), Bazel akan menggunakan kode keluar baru 39, bukan 34, jika cache jarak jauh mengeluarkan blob selama build.
Tag:incompatible_change
--[no]remote_accept_cached
default: "true"- Apakah akan menerima hasil tindakan yang di-cache dari jarak jauh.
--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
--remote_cache_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan- Tentukan header yang akan disertakan dalam permintaan cache: --remote_cache_header=Name=Value. Beberapa header dapat diteruskan dengan menentukan tanda beberapa kali. Beberapa nilai untuk nama yang sama akan dikonversi menjadi daftar yang dipisahkan koma.
--remote_default_exec_properties=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan-
Menetapkan properti exec default yang akan digunakan sebagai platform eksekusi jarak jauh jika platform eksekusi belum menetapkan exec_properties.
Tag:affects_outputs
--remote_default_platform_properties=<a string>
default: ""- Menetapkan properti platform default yang akan ditetapkan untuk API eksekusi jarak jauh, jika platform eksekusi belum menetapkan remote_execution_properties. Nilai ini juga akan digunakan jika platform host dipilih sebagai platform eksekusi untuk eksekusi jarak jauh.
--remote_downloader_header=<a 'name=value' assignment>
beberapa penggunaan 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.
--remote_exec_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan- Tentukan header yang akan disertakan dalam permintaan eksekusi: --remote_exec_header=Name=Value. Beberapa header dapat diteruskan dengan menentukan tanda beberapa kali. Beberapa nilai untuk nama yang sama akan dikonversi menjadi daftar yang dipisahkan koma.
- Default
--remote_execution_priority=<an integer>
: "0" - Prioritas relatif tindakan yang akan 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).
--remote_header=<a 'name=value' assignment>
beberapa penggunaan diakumulasikan- Tentukan header yang akan disertakan dalam permintaan: --remote_header=Name=Value. Beberapa header dapat diteruskan dengan menentukan 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.
- Default
--[no]remote_local_fallback
: "false" - Apakah akan beralih kembali ke strategi eksekusi lokal mandiri jika eksekusi jarak jauh gagal.
- Default
--remote_local_fallback_strategy=<a string>
: "local" - No-op, tidak digunakan lagi. Lihat https://github.com/bazelbuild/bazel/issues/7480 untuk mengetahui detailnya.
- Default
--remote_max_connections=<an integer>
: "100" -
Batasi jumlah maksimum koneksi serentak ke cache/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/executor jarak jauh gRPC, satu saluran gRPC biasanya dapat menangani 100+ permintaan serentak, sehingga Bazel dapat membuat sekitar `--remote_max_connections * 100` permintaan serentak.
Tag:host_machine_resource_optimizations
--remote_proxy=<a string>
default: lihat deskripsi- Hubungkan ke cache jarak jauh melalui proxy. Saat ini, tanda ini hanya dapat digunakan untuk mengonfigurasi soket domain Unix (unix:/path/to/socket).
- Default
--remote_result_cache_priority=<an integer>
: "0" - Prioritas relatif tindakan jarak jauh yang akan disimpan 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 satuan tidak disertakan, nilai akan ditafsirkan sebagai detik.
- Default
--remote_timeout=<An immutable length of time.>
: "60s" - Jumlah waktu maksimum untuk menunggu panggilan cache dan eksekusi jarak jauh. 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 satuan 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.:
--credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
beberapa penggunaan diakumulasikan- Mengonfigurasi helper kredensial yang akan digunakan untuk 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 https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md untuk mengetahui detailnya.
- Default
--credential_helper_cache_duration=<An immutable length of time.>
: "30m" - Durasi kredensial yang disediakan oleh helper kredensial di-cache. Memanggil dengan nilai yang berbeda akan menyesuaikan masa aktif entri yang sudah ada; teruskan nol untuk menghapus cache. Perintah clean selalu menghapus cache, terlepas dari tanda ini.
--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.
--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.
--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.
- Default
--[no]google_default_credentials
: "false" - Apakah akan menggunakan 'Kredensial Default Aplikasi Google' untuk autentikasi. Lihat https://cloud.google.com/docs/authentication untuk mengetahui detailnya. Dinonaktifkan secara default.
--grpc_keepalive_time=<An immutable length of time.>
default: lihat deskripsi- 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. Waktu diperlakukan sebagai perincian detik; error jika menetapkan nilai kurang dari satu detik. Secara default, ping keep-alive dinonaktifkan. Anda harus berkoordinasi dengan pemilik layanan sebelum mengaktifkan setelan ini. Misalnya, untuk menetapkan nilai 30 detik ke tanda ini, Anda harus melakukannya seperti ini --grpc_keepalive_time=30s
- Default
--grpc_keepalive_timeout=<An immutable length of time.>
: "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 balasan ping setelah jangka waktu ini. Waktu diperlakukan sebagai perincian detik; error jika menetapkan nilai kurang dari satu detik. Jika ping tetap aktif dinonaktifkan, setelan ini akan diabaikan.
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`
--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.
Opsi Versi
- Opsi yang muncul sebelum perintah dan diuraikan oleh klien:
--distdir=<a path>
beberapa penggunaan diakumulasikan-
Tempat tambahan untuk menelusuri arsip sebelum mengakses jaringan untuk mendownloadnya.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_hardlinks
: "false" -
Jika disetel, cache repositori akan membuat hardlink file jika terjadi hit cache, bukan menyalin. Tindakan ini dimaksudkan untuk menghemat ruang disk.
Tag:bazel_internal_configuration
- Default
--[no]experimental_repository_cache_urls_as_default_canonical_id
: "false" -
Jika benar, gunakan string yang berasal dari URL download repositori sebagai canonical_id jika tidak ditentukan. Hal ini menyebabkan perubahan pada URL menghasilkan download ulang meskipun cache berisi download dengan hash yang sama. Hal ini dapat digunakan untuk memverifikasi bahwa perubahan URL tidak menyebabkan repositori yang rusak ditutupi oleh cache.
Tag:loading_and_analysis
,experimental
- Default
--[no]experimental_repository_disable_download
: "false" -
Jika disetel, mendownload repositori eksternal tidak diizinkan.
Tag:experimental
- Default
--experimental_repository_downloader_retries=<an integer>
: "0" -
Jumlah maksimum upaya untuk mencoba ulang error download. Jika disetel ke 0, percobaan ulang akan dinonaktifkan.
Tag:experimental
- Default
--experimental_scale_timeouts=<a double>
: "1.0" -
Menskalakan semua waktu tunggu di aturan repositori Starlark dengan faktor ini. Dengan cara ini, repositori eksternal dapat dibuat agar berfungsi di komputer yang lebih lambat dari yang diharapkan penulis aturan, tanpa mengubah kode sumber
Tag:bazel_internal_configuration
,experimental
- Default
--http_timeout_scaling=<a double>
: "1.0" -
Menskalakan semua waktu tunggu terkait download http dengan faktor yang diberikan
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.
Tag:bazel_internal_configuration
- Opsi yang memungkinkan pengguna mengonfigurasi output yang diinginkan, yang memengaruhi nilainya, bukan keberadaannya:
- Default
--[no]gnu_format
: "false" -
Jika disetel, tulis versi ke stdout menggunakan konvensi yang dijelaskan dalam standar GNU.
Tag:affects_outputs
,execution
- Opsi yang memengaruhi seberapa ketat Bazel menerapkan input build yang valid (definisi aturan, kombinasi flag, dll.):
--experimental_repository_hash_file=<a string>
default: ""-
Jika tidak kosong, menentukan file yang berisi nilai yang telah diselesaikan, yang akan digunakan untuk memverifikasi hash direktori repositori
Tag:affects_outputs
,experimental
--experimental_verify_repository_rules=<a string>
beberapa penggunaan diakumulasikan-
Jika daftar aturan repositori yang hash direktori outputnya harus diverifikasi, asalkan file ditentukan oleh --experimental_repository_hash_file.
Tag:affects_outputs
,experimental
- Opsi ini memengaruhi semantik bahasa Starlark atau build API yang dapat diakses oleh file BUILD, file .bzl, atau file WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters
default: "true"-
No-op
Tag:no_op
,deprecated
,experimental
- Opsi yang terkait dengan output dan semantik Bzlmod:
--allow_yanked_versions=<a string>
beberapa penggunaan diakumulasikan-
Menentukan versi modul dalam bentuk `<module1>@<version1>,<module2>@<version2>` yang akan diizinkan dalam grafik dependensi yang di-resolve meskipun dinyatakan ditarik di registry tempat modul tersebut berasal (jika modul tersebut tidak berasal dari NonRegistryOverride). Jika tidak, versi yang dibatalkan akan menyebabkan resolusi gagal. Anda juga dapat menentukan versi yang diizinkan untuk dibatalkan dengan variabel lingkungan `BZLMOD_ALLOW_YANKED_VERSIONS`. Anda dapat menonaktifkan pemeriksaan ini dengan menggunakan kata kunci 'all' (tidak direkomendasikan).
Tag:loading_and_analysis
- Default
--check_bazel_compatibility=<error, warning or off>
: "error" -
Periksa kompatibilitas versi bazel 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
- Default
--check_direct_dependencies=<off, warning or error>
: "warning" -
Periksa apakah dependensi `bazel_dep` langsung yang dideklarasikan di 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 meningkatkan ketidakcocokan menjadi kegagalan penyelesaian.
Tag:loading_and_analysis
- Default
--[no]ignore_dev_dependency
: "false" -
Jika benar, Bazel akan mengabaikan `bazel_dep` dan `use_extension` yang dideklarasikan sebagai `dev_dependency` dalam MODULE.bazel modul root. Perhatikan bahwa dependensi dev tersebut selalu diabaikan di MODULE.bazel jika bukan modul root, terlepas dari nilai flag ini.
Tag:loading_and_analysis
--lockfile_mode=<off, update or error>
default: "nonaktif"-
Menentukan cara dan apakah akan menggunakan file kunci atau tidak. Nilai yang valid adalah `update` untuk menggunakan file kunci dan memperbaruinya jika ada perubahan, `error` untuk menggunakan file kunci tetapi menampilkan error jika file tersebut tidak terbaru, atau `off` agar tidak membaca dari atau menulis ke file kunci.
Tag:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
beberapa penggunaan diakumulasikan- Ganti modul dengan jalur lokal dalam bentuk <nama modul>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut 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`
--registry=<a string>
beberapa penggunaan diakumulasikan-
Menentukan registry yang akan digunakan untuk menemukan dependensi modul Bazel. Urutannya penting: modul akan dicari terlebih dahulu di registry awal, dan hanya akan kembali ke registry berikutnya jika tidak ada di registry awal.
Tag:changes_inputs
- Opsi yang memengaruhi kejelasan, format, atau lokasi logging:
- Default
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - Secara default, jumlah jenis tindakan dibatasi hingga 20 mnemonik dengan jumlah tindakan yang dijalankan terbesar. Menetapkan opsi ini akan menulis statistik untuk semua mnemonik.
- Opsi yang menentukan atau mengubah input generik ke perintah Bazel yang tidak termasuk dalam kategori lain.:
--experimental_resolved_file_instead_of_workspace=<a string>
default: ""-
Jika tidak kosong, baca file yang telah di-resolve yang ditentukan, bukan file WORKSPACE
Tag:changes_inputs
- Opsi eksekusi dan caching jarak jauh:
--experimental_downloader_config=<a string>
default: lihat deskripsi- Tentukan file untuk mengonfigurasi downloader jarak jauh. File ini terdiri dari baris, yang masing-masing diawali 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.
- Opsi lain-lain, yang tidak dikategorikan di tempat lain.:
--override_repository=<an equals-separated mapping of repository name to path>
beberapa penggunaan diakumulasikan- Ganti repositori dengan jalur lokal dalam bentuk <nama repositori>=<jalur>. Jika jalur yang diberikan adalah jalur absolut, jalur tersebut akan digunakan sebagaimana adanya. Jika jalur yang diberikan adalah jalur relatif, jalur tersebut relatif terhadap direktori kerja saat ini. Jika jalur yang diberikan dimulai dengan '%workspace%, jalur tersebut relatif terhadap root ruang kerja, yang merupakan output dari `bazel info workspace`
Tag Efek Opsi
unknown |
Opsi ini memiliki efek yang tidak diketahui atau tidak terdokumentasi. |
no_op |
Opsi ini sama sekali tidak berpengaruh. |
loses_incremental_state |
Mengubah nilai opsi ini dapat menyebabkan hilangnya status inkremental 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 sandbox atau eksekusi jarak jauh. |
host_machine_resource_optimizations |
Opsi ini memicu pengoptimalan yang mungkin khusus untuk mesin tertentu 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. |
explicit_in_output_path |
Opsi ini disebutkan secara eksplisit di direktori output. |