bazel [<startup options>] <command> [<args>]または
bazel [<startup options>] <command> [<args>] -- [<target patterns>]ターゲット パターンの構文については、ユーザーガイドをご覧ください。
オプションの構文
オプションはさまざまな方法で Bazel に渡すことができます。値を必要とするオプションは、等号またはスペースを使用して渡すことができます。
--<option>=<value> --<option> <value>一部のオプションでは短文が 1 つしかありません。その場合、短文は 1 つのダッシュとスペース 1 つを使用して渡す必要があります。
-<short_form> <value>
ブール値オプションは次のように有効にできます。
--<option> --<option>=[true|yes|1]無効にするには、次の操作を行います。
--no<option> --<option>=[false|no|0]
通常、3 段階のオプションはデフォルトで自動に設定され、次のようにして強制的に有効にできます。
--<option>=[true|yes|1]または、次のように強制的に無効にできます。
--no<option> --<option>=[false|no|0]
コマンド
analyze-profile |
ビルド プロファイル データを分析します。 |
aquery |
指定されたターゲットを分析し、アクション グラフをクエリします。 |
build |
指定されたターゲットをビルドします。 |
canonicalize-flags |
bazel オプションのリストを正規化します。 |
clean |
出力ファイルを削除し、必要に応じてサーバーを停止します。 |
coverage |
指定されたテスト ターゲットのコード カバレッジ レポートを生成します。 |
cquery |
構成とともに指定されたターゲットを読み込み、分析し、クエリを実行します。 |
dump |
bazel サーバー プロセスの内部状態をダンプします。 |
fetch |
ターゲットの前提条件である外部リポジトリを取得します。 |
help |
コマンドまたはインデックスのヘルプを出力します。 |
info |
bazel サーバーに関するランタイム情報を表示します。 |
license |
このソフトウェアのライセンスを出力します。 |
mobile-install |
モバイル デバイスにターゲットをインストールします。 |
mod |
Bzlmod 外部依存関係グラフにクエリを実行します。 |
print_action |
ファイルをコンパイルするためのコマンドライン引数を出力します。 |
query |
依存関係グラフのクエリを実行します。 |
run |
指定されたターゲットを実行します。 |
shutdown |
bazel サーバーを停止します。 |
sync |
ワークスペース ファイルで指定されたすべてのリポジトリを同期します。 |
test |
指定されたテスト ターゲットをビルドして実行します。 |
version |
bazel のバージョン情報を出力します。 |
起動オプション
- コマンドの前に表示され、クライアントによって解析されるオプション:
--[no]autodetect_server_javabase
のデフォルト: 「true」-
--noautodetect_server_javabase が渡されると、Bazel は bazel サーバーを実行するためのローカル JDK にフォールバックせず、代わりに終了します。
タグ:affects_outputs
、loses_incremental_state
--[no]batch
デフォルト: 「false」-
設定すると、Bazel は標準のクライアント/サーバー モードではなく、サーバーを使用せずに単なるクライアント プロセスとして実行されます。これは非推奨となったため、今後削除されます。サーバーが残らないようにしたい場合は、明示的にサーバーをシャットダウンすることをおすすめします。
タグ:loses_incremental_state
、bazel_internal_configuration
、deprecated
--[no]batch_cpu_scheduling
デフォルト: 「false」-
Linux の場合のみ。Blaze には「バッチ」CPU スケジューリングを使用します。このポリシーは、非対話型だが、その素晴らしい値を下げたくないワークロードに役立ちます。「man 2 sched_setscheduler」をご覧ください。false の場合、Bazel はシステムコールを実行しません。
タグ:host_machine_resource_optimizations
--bazelrc=<path>
デフォルト: 説明を参照-
Bazel オプションのデフォルト値を含むユーザー .bazelrc ファイルの場所。/dev/null は、それ以降のすべての「--bazelrc」が無視されることを示します。リリースビルドなどで、ユーザー RC ファイルの検索を無効にする場合に役立ちます。
このオプションは複数回指定することもできます。たとえば、「--bazelrc=x.rc --bazelrc=y.rc --bazelrc=/dev/null --bazelrc=z.rc」と指定すると、1)x.rc と y.rc が読み取られます。
2)以前の /dev/null のために z.rc が無視される。
指定しない場合、Bazel はワークスペース ディレクトリ、ユーザーのホーム ディレクトリの 2 つの場所で、最初に見つかった .bazelrc ファイルを使用します。
注: コマンドライン オプションは常に bazelrc のすべてのオプションよりも優先されます。
タグ:changes_inputs
--[no]block_for_lock
のデフォルト: 「true」-
--noblock_for_lock が渡されると、Bazel は実行中のコマンドの完了を待機せず、すぐに終了します。
タグ:eagerness_to_exit
--[no]client_debug
デフォルト: 「false」-
true の場合、クライアントからのデバッグ情報を stderr に記録します。このオプションを変更しても、サーバーは再起動されません。
タグ:affects_outputs
、bazel_monitoring
--connect_timeout_secs=<an integer>
のデフォルト: 「30」-
サーバーへの接続を試みるまでクライアントが待機する時間
タグ:bazel_internal_configuration
--[no]expand_configs_in_place
のデフォルト: 「true」-
通常の rc オプションとコマンドラインで指定されたオプションの間の固定小数点拡張とは異なり、--config フラグの拡張をインプレースで行われるように変更しました。
タグ:no_op
、deprecated
--failure_detail_out=<path>
デフォルト: 説明を参照-
設定すると、サーバーで障害が発生し、通常どおり gRPC 経由で報告できない場合に、failure_detail protobuf メッセージを書き込む場所を指定します。それ以外の場合、ロケーションは ${OUTPUT_BASE}/failure_detail.rawproto になります。
タグ:affects_outputs
、loses_incremental_state
--[no]home_rc
のデフォルト: 「true」- $HOME/.bazelrc でホーム bazelrc ファイルを検索するかどうか
タグ:changes_inputs
--[no]idle_server_tasks
のデフォルト: 「true」-
サーバーがアイドル状態のときに System.gc() を実行する
タグ:loses_incremental_state
、host_machine_resource_optimizations
--[no]ignore_all_rc_files
デフォルト: 「false」-
他の rc 変更フラグが起動オプションのリストで後から追加されている場合でも、それらの値に関係なく、すべての RC ファイルを無効にします。
タグ:changes_inputs
--io_nice_level={-1,0,1,2,3,4,5,6,7}
デフォルト: 「-1」-
Linux の場合のみ。sys_ioprio_set システムコールを使用して、ベスト エフォート IO スケジューリングのレベルを 0 ~ 7 に設定します。0 の優先度が最も高く、7 の優先度が最も低くなります。予測スケジューラは、優先度 4 までしか尊重できません。負の値に設定すると、Bazel はシステムコールを実行しません。
タグ:host_machine_resource_optimizations
--local_startup_timeout_secs=<an integer>
のデフォルト: 「120」-
サーバーがサーバーへの接続を待機する最長時間
タグ:bazel_internal_configuration
--macos_qos_class=<a string>
デフォルト: 「default」-
macOS で実行する場合の bazel サーバーの QoS サービスクラスを設定します。このフラグは他のすべてのプラットフォームには効果がありませんが、変更なしで rc ファイルを共有できるようにサポートされています。有効な値は、user-interactive、user-initiated、default、utility、background です。
タグ:host_machine_resource_optimizations
--max_idle_secs=<integer>
のデフォルト: 「10800」-
ビルドサーバーがアイドル状態になってからシャットダウンするまでの待機時間(秒)。ゼロは、サーバーがシャットダウンされないことを意味します。これはサーバー起動時にのみ読み取られます。このオプションを変更してもサーバーは再起動されません。
タグ:eagerness_to_exit
、loses_incremental_state
--output_base=<path>
デフォルト: 説明を参照-
設定すると、すべてのビルド出力を書き込む出力場所を指定します。それ以外の場合、ロケーションは ${OUTPUT_ROOT}/_blaze_${USER}/${MD5_OF_WORKSPACE_ROOT} です。注: この値に対して、次の Bazel 呼び出しで異なるオプションを指定した場合は、新しい追加の Bazel サーバーを起動する可能性があります。Bazel は、指定された出力ベースごとに 1 つのサーバーを起動します。通常、ワークスペースごとに 1 つの出力ベースがあります。ただし、このオプションを使用すると、ワークスペースごとに複数の出力ベースがあるため、同じマシン上の同じクライアントの複数のビルドを同時に実行できます。Bazel サーバーをシャットダウンする方法については、「bazel のヘルプ シャットダウン」をご覧ください。
タグ:affects_outputs
、loses_incremental_state
--output_user_root=<path>
デフォルト: 説明を参照-
すべてのビルド出力が書き込まれるユーザー固有のディレクトリ。デフォルトでは $USER の関数ですが、定数を指定すると、共同作業しているユーザー間でビルド出力を共有できます。
タグ:affects_outputs
、loses_incremental_state
--[no]preemptible
デフォルト: 「false」-
true の場合、別のコマンドが開始された場合に、コマンドをプリエンプトできます。
タグ:eagerness_to_exit
--server_jvm_out=<path>
デフォルト: 説明を参照-
サーバーの JVM の出力を書き込む場所。設定しない場合、デフォルトで output_base 内の場所が使用されます。
タグ:affects_outputs
、loses_incremental_state
--[no]shutdown_on_low_sys_mem
デフォルト: 「false」-
max_idle_secs が設定され、ビルドサーバーがしばらくアイドル状態であった場合は、システムの RAM が少なくなったらサーバーをシャットダウンします。Linux のみ。
タグ:eagerness_to_exit
、loses_incremental_state
--[no]system_rc
のデフォルト: 「true」-
システム全体の bazelrc を検索するかどうかを指定します。
タグ:changes_inputs
--[no]unlimit_coredumps
デフォルト: 「false」-
ソフトコアダンプの上限をハードリミットまで引き上げて、一般的な条件下でサーバー(JVM を含む)とクライアントのコアダンプを実行できるようにします。このフラグを bazelrc に一度だけ設定すれば、それを忘れて、トリガーする条件に実際に遭遇したときにコアダンプを取得できます。
タグ:bazel_internal_configuration
--[no]watchfs
デフォルト: 「false」-
true の場合、bazel はすべてのファイルの変更をスキャンする代わりに、ローカルの変更に対してオペレーティング システムのファイル監視サービスを使用しようとします。
タグ:deprecated
--[no]windows_enable_symlinks
デフォルト: 「false」-
true の場合、Windows でファイルのコピーではなく実際のシンボリック リンクが作成されます。Windows デベロッパー モードを有効にし、Windows 10 バージョン 1703 以降が必要です。
タグ:bazel_internal_configuration
--[no]workspace_rc
のデフォルト: 「true」- $workspace/.bazelrc でワークスペースの bazelrc ファイルを検索するかどうか
タグ:changes_inputs
- その他の項目(その他の分類なし):
--host_jvm_args=<jvm_arg>
件の複数回の使用が累積される- Blaze を実行する JVM に渡すフラグ。
--host_jvm_debug
-
JVM 起動フラグを追加するための便利なオプションです。JDWP 準拠のデバッガ(Eclipse など)からポート 5005 に接続するまで、JVM は起動時に待機します。
展開後:
--host_jvm_args=-Xdebug
--host_jvm_args=-Xrunjdwp:transport=dt_socket,server=y,address=5005
--host_jvm_profile=<profiler_name>
のデフォルト: ""- プロファイラ/デバッガ固有の JVM 起動フラグを追加できる便利なオプション。Bazel には既知の値のリストがあり、これはハードコードされた JVM 起動フラグにマッピングされます。場合によっては、ハードコードされたパスで特定のファイルが検索される可能性があります。
--server_javabase=<jvm path>
のデフォルト: ""- Bazel 自体の実行に使用される JVM のパス。
すべてのコマンドに共通するオプション
- ビルド実行を制御するオプション:
--experimental_ui_max_stdouterr_bytes=<an integer in (-1)-1073741819 range>
(デフォルト): 「1048576」-
コンソールに出力される stdout / stderr ファイルの最大サイズ。-1 は制限がないことを意味します。
タグ:execution
--[no]incompatible_remote_dangling_symlinks
のデフォルト: 「true」-
true に設定し、--compatible_remote_symlinks も true に設定した場合、アクションの出力内のシンボリック リンクがぶら下がります。
タグ:execution
、incompatible_change
--[no]incompatible_remote_symlinks
のデフォルト: 「true」-
true に設定すると、Bazel はリモート キャッシュ/実行プロトコルで、アクション出力でのシンボリック リンクを表します。それ以外の場合は、シンボリック リンクが後続し、ファイルまたはディレクトリとして表されます。詳しくは #6631 をご覧ください。
タグ:execution
、incompatible_change
- アクションの実行に使用するツールチェーンを構成するオプション:
--[no]incompatible_enable_proto_toolchain_resolution
デフォルト: 「false」-
true の場合、proto lang ルールが rules_proto、rules_java、rules_cc リポジトリのツールチェーンを定義します。
タグ:loading_and_analysis
、incompatible_change
- 目的の出力をユーザーが構成できるオプション(その存在ではなく、その値に影響を与えるもの):
--bep_maximum_open_remote_upload_files=<an integer>
デフォルト: 「-1」-
BEP アーティファクトのアップロード中に許可されるオープン ファイルの最大数。
タグ:affects_outputs
--remote_download_all
-
すべてのリモート出力をローカルマシンにダウンロードします。このフラグは --remote_download_outputs=all のエイリアスです。
次のように展開:
--remote_download_outputs=all
タグ:affects_outputs
--remote_download_minimal
-
リモートビルドの出力をローカルマシンにダウンロードしません。このフラグは --remote_download_outputs=minimal のエイリアスです。
次のように展開:
--remote_download_outputs=minimal
タグ:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
のデフォルト: 「toplevel」-
「minimal」に設定した場合、ローカル アクションに必要な出力以外のリモートビルド出力はローカルマシンにダウンロードされません。「toplevel」に設定すると、最上位レベルのターゲットの出力もローカルマシンにダウンロードされることを除き、「minimal」のように動作します。どちらのオプションも、ネットワーク帯域幅がボトルネックである場合には、ビルド時間を大幅に短縮できます。
タグ:affects_outputs
--remote_download_symlink_template=<a string>
のデフォルト: ""-
リモートビルドの出力をローカルマシンにダウンロードするのではなく、シンボリック リンクを作成します。シンボリック リンクのターゲットは、テンプレート文字列の形式で指定できます。このテンプレート文字列には {hash} と {size_bytes} が含まれ、それぞれオブジェクトのハッシュとバイト単位のサイズに展開されます。これらのシンボリック リンクは、たとえば、オンデマンドで CAS からオブジェクトを読み込む FUSE ファイル システムを指すことができます。
タグ:affects_outputs
--remote_download_toplevel
-
最上位ターゲットのリモート出力のみをローカルマシンにダウンロードします。このフラグは --remote_download_outputs=toplevel のエイリアスです。
次のように展開:
--remote_download_outputs=toplevel
タグ:affects_outputs
--repo_env=<a 'name=value' assignment with an optional value part>
件の複数回の使用が累積される-
リポジトリ ルールでのみ使用できる追加の環境変数を指定します。いずれにしてもリポジトリ ルールでは環境全体を参照できますが、この方法では、アクション グラフを無効にすることなく、オプションを使用して構成情報をリポジトリに渡すことができます。
タグ:action_command_lines
- Bazel が有効なビルド入力を厳密に適用するかどうかに影響するオプション(ルール定義、フラグの組み合わせなど):
--[no]check_bzl_visibility
のデフォルト: 「true」-
無効にすると、.bzl 読み込みの公開設定エラーが警告に降格されます。
タグ:build_file_semantics
- このオプションは、BUILD ファイル、.bzl ファイル、WORKSPACE ファイルからアクセス可能な Starlark 言語または Build API のセマンティクスに影響します。
--[no]enable_bzlmod
のデフォルト: 「true」-
true の場合、Bzlmod 依存関係管理システムが有効になり、WORKSPACE よりも優先されます。詳細については、https://bazel.build/docs/bzlmod をご覧ください。
タグ:loading_and_analysis
--[no]experimental_action_resource_set
のデフォルト: 「true」-
true に設定すると、hangouts.actions.run() と resourcemanager.actions.run_shell() は、ローカルでの実行のために resource_set パラメータを受け入れます。それ以外の場合、デフォルトでメモリ 250 MB、CPU 1 が使用されます。
タグ:execution
、build_file_semantics
、experimental
--[no]experimental_bzl_visibility
のデフォルト: 「true」-
有効にすると、「visibility()」関数が追加されます。.bzl ファイルは、最上位の評価中に、load() ステートメントの目的で可視性を設定するために呼び出すことができます。
タグ:loading_and_analysis
、experimental
-
true に設定すると、cc_shared_library ルールに必要なルール属性と Starlark API メソッドを使用できるようになります
タグ:build_file_semantics
、loading_and_analysis
、experimental
--[no]experimental_disable_external_package
デフォルト: 「false」-
true に設定すると、自動生成された外部パッケージは使用できなくなります。Bazel は引き続きファイル「external/BUILD」を解析できませんが、名前のないパッケージから external/ にアクセスする glob は機能します。
タグ:loading_and_analysis
、loses_incremental_state
、experimental
--[no]experimental_enable_android_migration_apis
デフォルト: 「false」-
true に設定すると、Android Starlark の移行のサポートに必要な API が有効になります。
タグ:build_file_semantics
--[no]experimental_enable_scl_dialect
デフォルト: 「false」-
true に設定すると、load() ステートメントで .scl ファイルを使用できます。
タグ:build_file_semantics
--[no]experimental_google_legacy_api
デフォルト: 「false」-
true に設定すると、Google の以前のコードに関連する、Starlark ビルド API のいくつかの試験運用版が公開されます。
タグ:loading_and_analysis
、experimental
--[no]experimental_isolated_extension_usages
デフォルト: 「false」-
true の場合、<a href="https://bazel.build/rules/lib/globals/module#use_extension"><code>use_extension</code></a> 関数の<code>isolate</code> パラメータを有効にします。
タグ:loading_and_analysis
--[no]experimental_java_library_export
デフォルト: 「false」-
有効にすると、experimental_java_library_export_do_not_use モジュールが使用可能になります。
タグ:loading_and_analysis
、incompatible_change
--[no]experimental_platforms_api
デフォルト: 「false」-
true に設定すると、デバッグに役立つプラットフォーム関連のさまざまな Starlark API が有効になります。
タグ:loading_and_analysis
、experimental
--[no]experimental_repo_remote_exec
デフォルト: 「false」-
true に設定すると、repository_rule は一部のリモート実行機能を取得します。
タグ:build_file_semantics
、loading_and_analysis
、experimental
--[no]experimental_sibling_repository_layout
デフォルト: 「false」-
true に設定すると、メイン以外のリポジトリが、実行ルートにメイン リポジトリへのシンボリック リンクとして植えられます。つまり、すべてのリポジトリは $output_base/execution_root ディレクトリの直接の子になります。そうすると、実際の最上位の「external」ディレクトリ用に $output_base/execution_root/__main__/external が解放されるという副作用があります。
タグ:action_command_lines
、bazel_internal_configuration
、loading_and_analysis
、loses_incremental_state
、experimental
-
true に設定すると、タグはターゲットからアクションの実行要件に伝播されます。そうでない場合、タグは伝播されません。詳しくは、https://github.com/bazelbuild/bazel/issues/8830 をご覧ください。
タグ:build_file_semantics
、experimental
--[no]incompatible_always_check_depset_elements
のデフォルト: 「true」-
すべてのコンストラクタで、depset に追加された要素の有効性を確認します。要素は不変である必要がありますが、以前は depset(direct=...) コンストラクタがチェックし忘れていました。depset 要素でリストの代わりにタプルを使用します。詳細については、https://github.com/bazelbuild/bazel/issues/10313 をご覧ください。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_depset_for_java_output_source_jars
のデフォルト: 「true」-
true の場合、Bazel は java_info.java_output[0].source_jars からのリストを返さなくなりましたが、代わりに depset を返します。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_depset_for_libraries_to_link_getter
のデフォルト: 「true」-
true の場合、Bazel は linking_context.libraries_to_link からリストを返さなくなりましたが、代わりに depset を返します。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_disable_objc_library_transition
のデフォルト: 「true」-
objc_library のカスタム移行を無効にして、代わりに最上位のターゲットから継承する
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_disable_starlark_host_transitions
デフォルト: 「false」-
true に設定すると、ルール属性で 'cfg = "host"' を設定できません。代わりに「cfg = "exec"」を設定してください。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_disable_target_provider_fields
デフォルト: 「false」-
true に設定すると、「target」オブジェクトのプロバイダにフィールド構文を介してアクセスする機能が無効になります。代わりに provider-key 構文を使用してください。たとえば、ルール実装関数内から "my_info" にアクセスするために "setIamPolicy.attr.dep.my_info" を使用する代わりに、"setIamPolicy.attr.dep[MyInfo]" を使用します。詳細については、https://github.com/bazelbuild/bazel/issues/9014 をご覧ください。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_disallow_empty_glob
デフォルト: 「false」-
true に設定すると、glob() の「allow_empty」引数のデフォルト値が False になります。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_disallow_struct_provider_syntax
デフォルト: 「false」-
true に設定すると、ルール実装関数は構造体を返しません。代わりに、プロバイダ インスタンスのリストを返す必要があります。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_existing_rules_immutable_view
のデフォルト: 「true」-
true に設定すると、native.existing_rule と native.existing_rules は、可変の辞書ではなく軽量の不変ビュー オブジェクトを返します。
タグ:build_file_semantics
、loading_and_analysis
、incompatible_change
--[no]incompatible_fail_on_unknown_attributes
のデフォルト: 「true」-
有効にすると、不明な属性が [なし] に設定されているターゲットは失敗します。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_fix_package_group_reporoot_syntax
のデフォルト: 「true」-
package_group の「packages」属性で値「//...」の意味が変更され、任意のリポジトリ内のすべてのパッケージではなく、現在のリポジトリ内のすべてのパッケージが参照されるようになります。「//...」の代わりに特別な値「public」を使用すると、以前の動作を取得できます。このフラグを使用するには、--compatible_package_group_has_public_syntax も有効にする必要があります。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_java_common_parameters
のデフォルト: 「true」-
true に設定すると、compile の pack_sources と host_javabase の output_jar パラメータと host_javabase パラメータがすべて削除されます。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_merge_fixed_and_default_shell_env
のデフォルト: 「true」-
有効にすると、「env」と「use_default_shell_env = True」の両方を指定して resourcemanager.actions.run と resourcemanager.actions.run_shell で登録されたアクションで、「env」に渡される値をオーバーライドすることで、デフォルトのシェル環境から取得した環境が使用されます。無効にすると、この場合の「env」の値は完全に無視されます。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_new_actions_api
のデフォルト: 「true」-
true に設定すると、アクションを作成する API は「resourcemanager.actions」でのみ使用できます。「setIamPolicy」では使用できません。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_no_attr_license
のデフォルト: 「true」-
true に設定すると、「attr.license」関数が無効になります。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_no_implicit_file_export
デフォルト: 「false」-
設定すると、(使用中)ソースファイルは、明示的にエクスポートされない限りパッケージ プライベートになります。https://github.com/bazelbuild/proposals/blob/master/designs/2019-10-24-file-visibility.md をご覧ください
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_no_rule_outputs_param
デフォルト: 「false」-
true に設定すると、Starlark 関数の「rule()」の「outputs」パラメータが無効になります。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_objc_provider_remove_linking_info
デフォルト: 「false」-
true に設定すると、情報をリンクするための ObjcProvider の API が削除されます。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_package_group_has_public_syntax
のデフォルト: 「true」-
package_group の packages 属性で、「public」または「private」を記述すると、それぞれすべてのパッケージを参照するか、まったく参照しないかを指定できます。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_require_linker_input_cc_api
のデフォルト: 「true」-
true に設定すると、create_linking_context ルールで library_to_link ではなく linker_inputs が必要になります。Linking_context の古いゲッターも無効になり、linker_inputs だけが利用可能になります。
タグ:build_file_semantics
、loading_and_analysis
、incompatible_change
--[no]incompatible_run_shell_command_string
のデフォルト: 「true」-
true に設定すると、actions.run_shell のコマンド パラメータは文字列のみを受け入れます。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_stop_exporting_language_modules
デフォルト: 「false」-
有効にすると、特定の言語固有のモジュール(「cc_common」など)はユーザーの .bzl ファイルで使用できなくなり、それぞれのルール リポジトリからのみ呼び出すことができます。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_struct_has_no_methods
デフォルト: 「false」-
構造体の to_json メソッドと to_proto メソッドを無効にします。これにより、構造体フィールドの名前空間が汚染されます。代わりに、JSON には json.encode または json.encode_indent を使用し、textproto には proto.encode_text を使用してください。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_top_level_aspects_require_providers
デフォルト: 「false」-
true に設定すると、トップレベル アスペクトは、必要なプロバイダを尊重し、ルールのアドバタイズされたプロバイダがアスペクトの必須プロバイダを満たしているトップレベル ターゲットでのみ実行されます。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_unambiguous_label_stringification
のデフォルト: 「true」-
true の場合、Bazel はラベル @//foo:bar を //foo:bar ではなく @//foo:bar に文字列化します。これは str() や % 演算子などの動作にのみ影響し、repr() の動作は変更されません。詳しくは、https://github.com/bazelbuild/bazel/issues/15916 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_use_cc_configure_from_rules_cc
デフォルト: 「false」-
true の場合、Bazel では @bazel_tools からの cc_configure の使用ができなくなります。詳細と移行手順については、https://github.com/bazelbuild/bazel/issues/10134 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
のデフォルト: 「true」-
true に設定すると、ルールの定義に関して非公開ルールの属性の公開設定がチェックされ、表示されていない場合はルールの使用にフォールバックします。
タグ:build_file_semantics
、incompatible_change
--max_computation_steps=<a long integer>
のデフォルト: 「0」-
BUILD ファイルで実行できる Starlark 計算ステップの最大数(ゼロは制限なし)。
タグ:build_file_semantics
--nested_set_depth_limit=<an integer>
のデフォルト: 「3500」-
依存関係セット(NestedSet)の内部のグラフの最大深度。これを超えると、depset() コンストラクタが失敗します。
タグ:loading_and_analysis
- ビルド時間の最適化をトリガーするオプション:
--[no]heuristically_drop_nodes
デフォルト: 「false」-
true の場合、関連するファイル ノードと DirectoryListing ノードの処理が完了すると、Blaze はメモリ節約のために FileState ノードと DirectoryListingState ノードを削除します。これらのノードが再び必要になる可能性は低くなります。満たしている場合、プログラムによって再評価されます。
タグ:loses_incremental_state
--[no]incompatible_do_not_split_linking_cmdline
のデフォルト: 「true」-
true の場合、Bazel はリンクに使用されるコマンドライン フラグを変更しなくなります。また、パラメータ ファイルにどのフラグを含めるかを選択的に決定することもなくなります。詳細については、https://github.com/bazelbuild/bazel/issues/7670 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]keep_state_after_build
のデフォルト: 「true」-
false の場合、Blaze はビルド終了時に、このビルドのインメモリ状態を破棄します。以降のビルドでは、これに関するインクリメンタリティは発生しません。
タグ:loses_incremental_state
--[no]track_incremental_state
のデフォルト: 「true」-
false の場合、Blaze は、このビルドのメモリを節約するために、増分ビルドでの無効化と再評価を可能にするデータを保持しません。以降のビルドでは、これに関するインクリメンタリティはありません。通常は、これを false に設定するときは --batch を指定します。
タグ:loses_incremental_state
- ロギングの詳細度、形式、場所に影響するオプション:
--[no]announce_rc
デフォルト: 「false」-
RC オプションを通知するかどうかを指定します。
タグ:affects_outputs
--[no]attempt_to_print_relative_paths
デフォルト: 「false」-
メッセージの場所部分を出力する場合、ワークスペース ディレクトリまたは --package_path で指定されたいずれかのディレクトリへの相対パスを指定してみてください。
タグ:terminal_output
--bes_backend=<a string>
のデフォルト: ""-
ビルド イベント サービス(BES)のバックエンド エンドポイントを [SCHEME://]HOST[:PORT] の形式で指定します。デフォルトでは、BES アップロードは無効になっています。サポートされているスキームは gRPC と gRPC(TLS が有効になっている gRPC)です。スキームが指定されていない場合、Bazel は grpc を想定します。
タグ:affects_outputs
--[no]bes_check_preceding_lifecycle_events
デフォルト: 「false」-
PublishBuildToolEventStreamRequest にフィールド check_preceding_lifecycle_events_present を設定します。このフィールドは、現在のツール イベントに一致する InvocationAttemptStarted イベントと BuildEnqueued イベントを過去に受信したかどうかをチェックするよう BES に指示します。
タグ:affects_outputs
--bes_header=<a 'name=value' assignment>
件の複数回の使用が累積される-
BES リクエストに含めるヘッダーを NAME=VALUE 形式で指定します。フラグを複数回指定すると、複数のヘッダーを渡すことができます。同じ名前の複数の値は、カンマ区切りのリストに変換されます。
タグ:affects_outputs
--bes_instance_name=<a string>
デフォルト: 説明を参照-
アップロードされた BEP を BES が保持するインスタンス名を指定します。デフォルトは null です。
タグ:affects_outputs
--bes_keywords=<comma-separated list of options>
件の複数回の使用が累積される-
BES に公開されるデフォルトのキーワード セットに追加する通知キーワードのリストを指定します(「command_name=<コマンド名>」、「protocol_name=BEP」)。デフォルトはなしです。
タグ:affects_outputs
--[no]bes_lifecycle_events
のデフォルト: 「true」-
BES ライフサイクル イベントを公開するかどうかを指定します。(デフォルトは「true」)。
タグ:affects_outputs
--bes_oom_finish_upload_timeout=<An immutable length of time.>
のデフォルト: 「10m」-
OOM の実行中に BES/BEP のアップロードが完了するまでバゼルが待機する時間を指定します。このフラグは、JVM が著しく GC スラッシングを行い、どのユーザー スレッドでも進行できない場合に、確実に終了させます。
タグ:bazel_monitoring
--bes_outerr_buffer_size=<an integer>
のデフォルト: 「10240」-
進行状況イベントとして報告される前に、BEP でバッファリングする stdout または stderr の最大サイズを指定します。個々の書き込みは、--bes_outerr_chunk_size までの指定値より大きくても、引き続き 1 つのイベントで報告されます。
タグ:affects_outputs
--bes_outerr_chunk_size=<an integer>
(デフォルト): 「1048576」-
単一のメッセージで BEP に送信する stdout または stderr の最大サイズを指定します。
タグ:affects_outputs
--bes_proxy=<a string>
デフォルト: 説明を参照- プロキシ経由で Build Event Service に接続します。現在、このフラグは Unix ドメイン ソケット(unix:/path/to/socket)を構成する場合にのみ使用できます。
--bes_results_url=<a string>
のデフォルト: ""-
BES バックエンドにストリーミングされた情報をユーザーが閲覧できるベース URL を指定します。Bazel は、呼び出し ID が付加された URL をターミナルに出力します。
タグ:terminal_output
--bes_system_keywords=<comma-separated list of options>
件の複数回の使用が累積される-
直接含める通知キーワードのリストを指定します。--bes_keyword で指定されたキーワードには「user_keyword=」接頭辞は含まれません。--bes_lifecycle_events=false を設定し、PublishLifecycleEvent の呼び出し時にキーワードを指定する Build サービス オペレータを対象としています。このフラグを使用してサービス オペレータを構築すると、ユーザーがフラグの値をオーバーライドできないようにする必要があります。
タグ:affects_outputs
--bes_timeout=<An immutable length of time.>
のデフォルト: 「0s」-
ビルドとテストが完了した後、BES/BEP のアップロードが完了するまで bazel が待機する時間を指定します。有効なタイムアウトは、自然数の後に単位(日(d)、時間(h)、分(m)、秒(s)、ミリ秒(ms))が続く))です。デフォルト値は「0」で、タイムアウトがないことを意味します。
タグ:affects_outputs
--bes_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
のデフォルト: 「wait_for_upload_complete」-
ビルドイベント サービスのアップロードでビルド完了をブロックするか、呼び出しをすぐに終了してバックグラウンドでアップロードを完了するかを指定します。wait_for_upload_complete(デフォルト)、nowait_for_upload_complete、Fully_async のいずれか。
タグ:eagerness_to_exit
--build_event_binary_file=<a string>
のデフォルト: ""-
空でない場合は、ビルドイベント プロトコルの表現の varint 区切りバイナリ表現をそのファイルに書き込みます。このオプションは --bes_upload_mode=wait_for_upload_complete を示します。
タグ:affects_outputs
--[no]build_event_binary_file_path_conversion
のデフォルト: 「true」-
可能な限り、ビルドイベント プロトコルのバイナリ ファイル表現内のパスを、よりグローバルに有効な URI に変換します。無効にした場合は、file:// URI スキームが常に使用されます
タグ:affects_outputs
--build_event_binary_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
のデフォルト: 「wait_for_upload_complete」-
--build_event_binary_file のビルドイベント サービスでビルド完了をブロックするか、呼び出しをすぐに終了してバックグラウンドでアップロードを完了するかを指定します。wait_for_upload_complete(デフォルト)、nowait_for_upload_complete、Fully_async のいずれか。
タグ:eagerness_to_exit
--build_event_json_file=<a string>
のデフォルト: ""-
空でない場合は、このファイルにビルドイベント プロトコルの JSON シリアル化を書き込みます。このオプションは --bes_upload_mode=wait_for_upload_complete を示します。
タグ:affects_outputs
--[no]build_event_json_file_path_conversion
のデフォルト: 「true」-
ビルドイベント プロトコルの JSON ファイル表現内のパスを、可能な限り、よりグローバルに有効な URI に変換します。無効にした場合は、file:// URI スキームが常に使用されます
タグ:affects_outputs
--build_event_json_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
のデフォルト: 「wait_for_upload_complete」-
--build_event_json_file のビルドイベント サービスでビルド完了をブロックするか、呼び出しをすぐに終了してバックグラウンドでアップロードを完了するかを指定します。wait_for_upload_complete(デフォルト)、nowait_for_upload_complete、Fully_async のいずれか。
タグ:eagerness_to_exit
--build_event_max_named_set_of_file_entries=<an integer>
デフォルト: 「-1」-
1 つの name_set_of_files イベントの最大エントリ数。2 未満の値は無視され、イベント分割は行われません。これは、ビルドイベント プロトコルの最大イベントサイズを制限することを目的としていますが、イベントサイズを直接制御するものではありません。イベントの合計サイズは、セットの構造に加えて、ファイルと URI の長さにもよりますが、ハッシュ関数によって決まる場合があります。
タグ:affects_outputs
--[no]build_event_publish_all_actions
デフォルト: 「false」-
すべてのアクションを公開するかどうか。
タグ:affects_outputs
--build_event_text_file=<a string>
のデフォルト: ""-
空でない場合は、ビルドイベント プロトコルのテキスト表現をそのファイルに書き込みます。
タグ:affects_outputs
--[no]build_event_text_file_path_conversion
のデフォルト: 「true」-
可能な限り、ビルド イベント プロトコルのテキスト ファイル表現のパスを、よりグローバルに有効な URI に変換します。無効にした場合は、file:// URI スキームが常に使用されます
タグ:affects_outputs
--build_event_text_file_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
のデフォルト: 「wait_for_upload_complete」-
--build_event_text_file のビルドイベント サービスでビルド完了をブロックするか、呼び出しをすぐに終了してバックグラウンドでアップロードを完了するかを指定します。wait_for_upload_complete(デフォルト)、nowait_for_upload_complete、Fully_async のいずれか。
タグ:eagerness_to_exit
--[no]experimental_announce_profile_path
デフォルト: 「false」-
有効にすると、JSON プロファイルのパスがログに追加されます。
タグ:bazel_monitoring
--[no]experimental_bep_target_summary
デフォルト: 「false」- TargetSummary イベントを公開するかどうか。
--[no]experimental_build_event_expand_filesets
デフォルト: 「false」-
true の場合、出力ファイルを提示するときに、BEP でファイルセットを展開します。
タグ:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
デフォルト: 「false」-
true の場合、出力ファイルを表示するときに、BEP の相対ファイルセット シンボリック リンクを完全に解決します。--experimental_build_event_expand_filesets が必要です。
タグ:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
のデフォルト: 「4」-
Bazel がビルドイベントのアップロードを再試行する最大回数。
タグ:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
のデフォルト: 「1s」-
BEP のアップロードが失敗した場合の指数バックオフの再試行の最小遅延。(指数: 1.6)
タグ:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
デフォルト: 説明を参照-
ビルドイベント プロトコルで参照されるアーティファクトをアップロードする方法を選択します。
タグ:affects_outputs
--[no]experimental_collect_load_average_in_profiler
のデフォルト: 「true」-
有効にすると、プロファイラはシステムの全体的な負荷の平均を収集します。
タグ:bazel_monitoring
--[no]experimental_collect_pressure_stall_indicators
デフォルト: 「false」-
有効にすると、プロファイラは Linux PSI データを収集します。
タグ:bazel_monitoring
--[no]experimental_collect_resource_estimation
デフォルト: 「false」-
有効にすると、プロファイラはローカル アクションの CPU とメモリの推定使用量を収集します。
タグ:bazel_monitoring
--[no]experimental_collect_system_network_usage
デフォルト: 「false」-
有効にすると、プロファイラはシステムのネットワーク使用量を収集します。
タグ:bazel_monitoring
--[no]experimental_collect_worker_data_in_profiler
デフォルト: 「false」-
有効にすると、プロファイラはワーカーの集計リソースデータを収集します。
タグ:bazel_monitoring
--experimental_profile_additional_tasks=<phase, action, action_check, action_lock, action_release, action_update, action_complete, bzlmod, info, create_package, remote_execution, local_execution, scanner, local_parse, upload_time, remote_process_time, remote_queue, remote_setup, fetch, local_process_time, vfs_stat, vfs_dir, vfs_readlink, vfs_md5, vfs_xattr, vfs_delete, vfs_open, vfs_read, vfs_write, vfs_glob, vfs_vmfs_stat, vfs_vmfs_dir, vfs_vmfs_read, wait, thread_name, thread_sort_index, skyframe_eval, skyfunction, critical_path, critical_path_component, handle_gc_notification, action_counts, action_cache_counts, local_cpu_usage, system_cpu_usage, cpu_usage_estimation, local_memory_usage, system_memory_usage, memory_usage_estimation, system_network_up_usage, system_network_down_usage, workers_memory_usage, system_load_average, starlark_parser, starlark_user_fn, starlark_builtin_fn, starlark_user_compiled_fn, starlark_repository_fn, action_fs_staging, remote_cache_check, remote_download, remote_network, filesystem_traversal, worker_execution, worker_setup, worker_borrow, worker_working, worker_copying_outputs, credential_helper, pressure_stall_io, pressure_stall_memory, conflict_check, dynamic_lock or unknown>
件の複数回の使用が累積される-
プロファイルに含める追加のプロファイル タスクを指定します。
タグ:bazel_monitoring
--[no]experimental_profile_include_primary_output
デフォルト: 「false」-
アクション イベントに、アクションのプライマリ出力への実行パスを含む「out」属性が追加されます。
タグ:bazel_monitoring
--[no]experimental_profile_include_target_label
デフォルト: 「false」-
アクション イベントの JSON プロファイル データにターゲット ラベルが含まれます。
タグ:bazel_monitoring
--[no]experimental_run_bep_event_include_residue
デフォルト: 「false」-
実行ビルドイベントにコマンドラインの残差を含めるかどうかを指定します。デフォルトでは、残留物を含む可能性のある実行コマンドのビルドイベントに残留物は含まれません。
タグ:affects_outputs
--[no]experimental_stream_log_file_uploads
デフォルト: 「false」-
ログファイルをディスクに書き込むのではなく、リモート ストレージに直接アップロードする。
タグ:affects_outputs
--experimental_workspace_rules_log_file=<a path>
デフォルト: 説明を参照- 特定の Workspace ルール イベントを、区切りの WorkspaceEvent proto としてこのファイルに記録します。
--[no]generate_json_trace_profile
のデフォルト: "auto"-
有効にすると、Bazel はビルドをプロファイリングし、JSON 形式のプロファイルを出力ベース内のファイルに書き込みます。chrome://tracing に読み込んでプロファイルを表示します。デフォルトでは、Bazel はビルドに似たすべてのコマンドとクエリのプロファイルを書き込みます。
タグ:bazel_monitoring
--[no]heap_dump_on_oom
デフォルト: 「false」-
OOM がスローされた場合にヒープダンプを手動で出力するかどうか(--gc_thrashing_limits に達したことによる手動 OOM を含む)。ダンプは <output_base>/<invocation_id>.heapdump.hprof に書き込まれます。このオプションは実質的に、-XX:+HeapDumpOnOutOfMemoryError に代わるもので、手動 OOM には影響しません。
タグ:bazel_monitoring
--[no]legacy_important_outputs
のデフォルト: 「true」-
これを使用して、TargetComplete イベントで以前の重要な出力フィールドの生成を抑制します。Bazel と ResultStore の統合には、重要_outputs が必要です。
タグ:affects_outputs
--logging=<0 <= an integer <= 6>
のデフォルト: 「3」-
ロギングレベル。
タグ:affects_outputs
--memory_profile=<a path>
デフォルト: 説明を参照-
設定した場合、フェーズ終了時に指定されたファイルにメモリ使用量データを書き込み、ビルドの終了時に安定したヒープをマスターログに書き込みます。
タグ:bazel_monitoring
--memory_profile_stable_heap_parameters=<integers, separated by a comma expected in pairs>
のデフォルト: 「1,0」-
ビルドの終了時に、メモリ プロファイルでの安定ヒープの計算を調整します。または偶数個の整数をカンマで区切る必要があります。各ペアで、最初の整数は実行する GC の数です。各ペアの 2 番目の整数は、GC 間の待機時間(秒)です。例: 2、4、4、0 に設定すると、4 秒間の一時停止で 2 GC が発生し、その後ゼロ秒の一時停止で 4 つの GC が実行されます。
タグ:bazel_monitoring
--profile=<a path>
デフォルト: 説明を参照-
設定すると、Bazel をプロファイリングし、指定されたファイルにデータを書き込みます。bazelanalyze-profile を使用してプロファイルを分析します。
タグ:bazel_monitoring
--[no]record_full_profiler_data
デフォルト: 「false」-
デフォルトでは、Bazel プロファイラは、高速かつ多数のイベント(ファイルの記述など)の集計データのみを記録します。このオプションを有効にすると、プロファイラは各イベントを記録するため、より正確なプロファイリング データが得られますが、パフォーマンスに大きな影響が生じます。オプションは、--profile も使用した場合にのみ有効です。
タグ:bazel_monitoring
--remote_print_execution_messages=<failure, success or all>
のデフォルト: "failure"-
リモート実行メッセージを出力するタイミングを選択します。有効な値は「failure」で、失敗時にのみ出力します。「success」は成功した場合のみを出力し、「all」は常に出力します。
タグ:terminal_output
--[no]slim_profile
のデフォルト: 「true」-
プロファイルが大きくなりすぎた場合は、イベントを統合して JSON プロファイルのサイズを小さくします。
タグ:bazel_monitoring
--starlark_cpu_profile=<a string>
のデフォルト: ""-
すべての Starlark スレッドによる CPU 使用率の pprof プロファイルを、指定されたファイルに書き込みます。
タグ:bazel_monitoring
--tool_tag=<a string>
のデフォルト: ""-
この Bazel 呼び出しを関連付けるツール名。
タグ:affects_outputs
、bazel_monitoring
--ui_event_filters=<Convert list of comma separated event kind to list of filters>
件の複数回の使用が累積される-
UI に表示するイベントを指定します。先頭に +/- を使用してデフォルトのイベントにイベントを追加または削除したり、直接割り当てでデフォルトのセットを完全にオーバーライドしたりできます。サポートされているイベントの種類には、INFO、DEBUG、ERROR などがあります。
タグ:terminal_output
- リモート キャッシュと実行オプション:
--experimental_circuit_breaker_strategy=<failure>
デフォルト: 説明を参照-
回路ブレーカーで使用する戦略を指定します。利用可能な戦略は「失敗」です。オプションの値が無効な場合、オプションが設定されていないのと同じ動作になります。
タグ:execution
--[no]experimental_guard_against_concurrent_changes
デフォルト: 「false」- この機能をオフにすると、リモート キャッシュにアップロードする前にアクションの入力ファイルの ctime を確認できなくなります。Linux カーネルがファイルの書き込みを遅延させ、誤検出の原因になることがあります。
--[no]experimental_remote_cache_async
デフォルト: 「false」- true の場合、リモート キャッシュ I/O は Spawn の一環として行われるのではなく、バックグラウンドで発生します。
--[no]experimental_remote_cache_lease_extension
デフォルト: 「false」- true に設定すると、Bazel はビルド中にリモート アクションの出力のリースを延長し、「FindMissingBlobs」呼び出しをリモート キャッシュに定期的に送信します。頻度は「--experimental_remote_cache_ttl」の値に基づきます。
--experimental_remote_cache_ttl=<An immutable length of time.>
のデフォルト: "3h"-
ダイジェストが最近参照されたリモート キャッシュ内の blob の最小 TTL は、ActionResult や FindMissingBlobs などによって保証されます。Bazel は、blob の TTL に基づいていくつかの最適化を行います。たとえば、増分ビルドで GetActionResult を繰り返し呼び出すことはありません。この値は、サーバーがダイジェストを返すタイミングと Bazel がダイジェストを受信するタイミングの間にギャップがあるため、実際の TTL より少し小さい値に設定する必要があります。
タグ:execution
--experimental_remote_capture_corrupted_outputs=<a path>
デフォルト: 説明を参照- 破損した出力のキャプチャ先となるディレクトリへのパス。
--[no]experimental_remote_discard_merkle_trees
デフォルト: 「false」- true に設定すると、GetActionResult() と Execute() の呼び出し中に、入力ルートのマークルツリーのメモリ内コピーと関連する入力マッピングを破棄します。これによりメモリ使用量が大幅に削減されますが、リモート キャッシュミスや再試行時に Bazel による再計算が必要になります。
--experimental_remote_downloader=<a string>
デフォルト: 説明を参照- リモート ダウンロード プロキシとして使用する Remote Asset API エンドポイント URI。サポートされているスキーマは、grpc、grpcs(TLS が有効になっている grpcs、unix ローカル UNIX ソケット)です。スキーマが指定されていない場合、Bazel はデフォルトで grpcs になります。参照: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
デフォルト: 「false」- リモート ダウンローダが失敗した場合にローカル ダウンローダにフォールバックするかどうか。
--[no]experimental_remote_execution_keepalive
デフォルト: 「false」- リモート実行呼び出しにキープアライブを使用するかどうかを指定します。
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
のデフォルト: 「10」-
特定の時間枠で許容される失敗率をパーセンテージで設定します。この期間が経過するとリモート キャッシュ/エグゼキュータの呼び出しは停止します。デフォルト値は 10 です。これを 0 に設定すると、制限なしになります。
タグ:execution
--experimental_remote_failure_window_interval=<An immutable length of time.>
のデフォルト: 「60s」-
リモート リクエストの失敗率を計算する間隔。ゼロまたは負の値の場合、失敗時間は実行時間全体として計算されます。日(d)、時間(h)、分(m)、秒(s)、ミリ秒(ms)の単位を使用できます。単位を省略すると、値は秒と解釈されます。
タグ:execution
--[no]experimental_remote_mark_tool_inputs
デフォルト: 「false」- true に設定すると、Bazel はリモート エグゼキュータのツール入力として入力をマークします。これを使用して、リモート永続ワーカーを実装できます。
--[no]experimental_remote_merkle_tree_cache
デフォルト: 「false」- true に設定すると、リモート キャッシュ ヒットのチェック速度を向上させるために、マークルツリー計算がメモされます。キャッシュのメモリ フットプリントは --experimental_remote_merkle_tree_cache_size によって制御されます。
--experimental_remote_merkle_tree_cache_size=<a long integer>
のデフォルト: 「1000」- リモート キャッシュ ヒットのチェック速度を向上させるために記憶するマークルツリーの数。キャッシュは Java のソフト参照の処理に従って自動的にプルーニングされますが、設定値が大きすぎるとメモリ不足エラーが発生することがあります。0 に設定した場合、キャッシュ サイズは無制限になります。最適な値はプロジェクトの規模によって異なります。デフォルトは 1,000 です。
--[no]experimental_remote_require_cached
デフォルト: 「false」- true に設定すると、リモートで実行されるすべてのアクションがキャッシュに保存されます。そうでない場合は、ビルドが失敗します。キャッシュに保存すべきアクションがキャッシュに誤って挿入されることなく、実際にキャッシュに保存されるかどうかを確認できるため、非決定性に関する問題のトラブルシューティングに役立ちます。
--experimental_remote_scrubbing_config=<Converts to a Scrubber>
デフォルト: 説明を参照- 指定された構成ファイル(テキスト形式の ScrubbingConfig プロトコル バッファ)でのリモート キャッシュキーのスクラブを有効にします。 この機能は、異なるプラットフォームで実行されるものの、同じプラットフォームを対象とするアクション間でリモート キャッシュやディスク キャッシュの共有を容易にすることを目的としています。不適切な設定を行うと、キャッシュ エントリが誤って共有され、誤ったビルドにつながる可能性があるため、慎重に使用してください。 スクラブはアクションの実行方法には影響せず、アクションの結果を取得または保存するためにリモート/ディスク キャッシュキーがどのように計算されるかにのみ影響します。リモート実行と組み合わせて使用することはできません。スクラブ設定を変更しても、ローカル ファイルシステムや内部キャッシュに存在する出力は無効になりません。影響を受けるアクションを再実行するには、クリーンビルドが必要です。 この機能を適切に使用するには、カスタムの --host_platform を、--experimental_platform_in_output_dir(出力プレフィックスを正規化)および --compatible_strict_action_env(環境変数を正規化)とともに設定することをおすすめします。
--[no]incompatible_remote_build_event_upload_respect_no_cache
デフォルト: 「false」- 非推奨。NoOps。代わりに --remote_build_event_upload=minimal を使用してください。
--[no]incompatible_remote_downloader_send_all_headers
のデフォルト: 「true」-
複数値を持つヘッダーのすべての値を、最初のだけでなくリモート ダウンローダーに送信するかどうかを指定します。
タグ:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
デフォルト: 「false」-
true に設定すると、出力パスは作業ディレクトリではなく入力ルートを基準とする相対パスになります。
タグ:incompatible_change
--[no]incompatible_remote_results_ignore_disk
のデフォルト: 「true」-
No-op
タグ:incompatible_change
--[no]remote_accept_cached
のデフォルト: 「true」- リモートのキャッシュに保存されたアクションの結果を受け入れるかどうかを指定します。
--remote_build_event_upload=<all or minimal>
のデフォルト: "minimal"- 「all」に設定すると、BEP によって参照されるすべてのローカル出力がリモート キャッシュにアップロードされます。 「minimal」に設定した場合、BEP で参照されるローカル出力は、BEP の使用者にとって重要なファイル(テストログやタイミング プロファイルなど)を除き、リモート キャッシュにアップロードされません。リモート キャッシュにない場合でも、ファイルの URI には bytestream:// スキームが常に使用されます。 デフォルトは「minimal」です。
--remote_bytestream_uri_prefix=<a string>
デフォルト: 説明を参照- ビルド イベント ストリームに書き込まれる bytestream:// URI で使用されるホスト名とインスタンス名。プロキシを使用してビルドを実行するときにこのオプションを設定できます。これにより、--remote_executor と --remote_instance_name の値がリモート実行サービスの正規名に対応しなくなります。設定しない場合、デフォルトで「${hostname}/${instance_name}」になります。
--remote_cache=<a string>
デフォルト: 説明を参照- キャッシュ エンドポイントの URI。サポートされているスキーマは、http、https、grpc、grpcs(TLS を有効にした grpcs、unix(ローカル UNIX ソケット)です。スキーマが指定されていない場合、Bazel はデフォルトで grpcs になります。grpc://、http://、または unix: スキーマを指定して TLS を無効にします。https://bazel.build/remote/caching をご覧ください。
--[no]remote_cache_compression
デフォルト: 「false」- 有効にすると、zstd を使用してキャッシュ blob を圧縮/解凍します。
--remote_cache_header=<a 'name=value' assignment>
件の複数回の使用が累積される- キャッシュ リクエストに含めるヘッダーを指定します(--remote_cache_header=Name=Value)。フラグを複数回指定すると、複数のヘッダーを渡すことができます。同じ名前の複数の値は、カンマ区切りのリストに変換されます。
--remote_default_exec_properties=<a 'name=value' assignment>
件の複数回の使用が累積される-
実行プラットフォームで exec_properties が設定されていない場合に、リモート実行プラットフォームとして使用するデフォルトの exec プロパティを設定します。
タグ:affects_outputs
--remote_default_platform_properties=<a string>
のデフォルト: ""- 実行プラットフォームが remote_execution_properties を設定していない場合は、リモート実行 API に設定するデフォルトのプラットフォーム プロパティを設定します。この値は、ホスト プラットフォームがリモート実行の実行プラットフォームとして選択されている場合にも使用されます。
--remote_download_regex=<a string>
件の複数回の使用が累積される-
指定された正規表現に一致するアーティファクトを Bazel に強制的にダウンロードします。バイトのないビルド(または内部の同等のもの)と組み合わせて使用し、ローカルで必要になる可能性がある特定のアーティファクト(IDE のサポートなど)をクライアントがリクエストできるようにします。このフラグを繰り返すことで、複数の正規表現を指定できます。
タグ:affects_outputs
--remote_downloader_header=<a 'name=value' assignment>
件の複数回の使用が累積される- リモート ダウンローダ リクエストに含めるヘッダーを指定します(--remote_downloader_header=Name=Value)。フラグを複数回指定すると、複数のヘッダーを渡すことができます。同じ名前の複数の値は、カンマ区切りのリストに変換されます。
--remote_exec_header=<a 'name=value' assignment>
件の複数回の使用が累積される- 実行リクエストに含めるヘッダーを指定します(--remote_exec_header=Name=Value)。フラグを複数回指定すると、複数のヘッダーを渡すことができます。同じ名前の複数の値は、カンマ区切りのリストに変換されます。
--remote_execution_priority=<an integer>
のデフォルト: 「0」- リモートで実行されるアクションの相対的な優先度。特定の優先度の値のセマンティクスは、サーバーによって異なります。
--remote_executor=<a string>
デフォルト: 説明を参照- リモート実行エンドポイントの HOST または HOST:PORT。サポートされているスキーマは、grpc、grpcs(TLS が有効になっている grpcs、unix ローカル UNIX ソケット)です。スキーマが指定されていない場合、Bazel はデフォルトで grpcs になります。TLS を無効にするには、grpc:// または unix: スキーマを指定します。
--remote_grpc_log=<a path>
デフォルト: 説明を参照- 指定する場合、gRPC 呼び出しに関する詳細を記録するファイルのパス。このログは、シリアル化された com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry protobuf のシーケンスで構成されており、各メッセージの前には、次のシリアル化された protobuf メッセージのサイズを示す varint が付加されています。これは、メソッド LogEntry.writeDelimitedTo(OutputStream) によって実行されます。
--remote_header=<a 'name=value' assignment>
件の複数回の使用が累積される- リクエストに含めるヘッダーを指定します(--remote_header=Name=Value)。フラグを複数回指定すると、複数のヘッダーを渡すことができます。同じ名前の複数の値は、カンマ区切りのリストに変換されます。
--remote_instance_name=<a string>
のデフォルト: ""- リモート実行 API で instance_name として渡す値。
--[no]remote_local_fallback
デフォルト: 「false」- リモート実行が失敗した場合に、スタンドアロンのローカル実行戦略にフォールバックするかどうか。
--remote_local_fallback_strategy=<a string>
のデフォルト: 「local」- NoOps、非推奨。詳細については、https://github.com/bazelbuild/bazel/issues/7480 をご覧ください。
--remote_max_connections=<an integer>
のデフォルト: 「100」-
リモート キャッシュ/エグゼキュータへの同時接続の最大数を制限します。デフォルト値は 100 です。これを 0 に設定すると、制限なしになります。HTTP リモート キャッシュの場合、1 つの TCP 接続で一度に 1 つのリクエストを処理できるため、Bazel では最大 --remote_max_connections の同時リクエストが可能です。gRPC リモート キャッシュ/エグゼキュータの場合、1 つの gRPC チャネルで通常 100 件以上の同時リクエストを処理できるため、Bazel では「--remote_max_connections * 100」程度の同時リクエストを実行できます。
タグ:host_machine_resource_optimizations
--remote_proxy=<a string>
デフォルト: 説明を参照- プロキシ経由でリモート キャッシュに接続します。現在、このフラグは Unix ドメイン ソケット(unix:/path/to/socket)を構成する場合にのみ使用できます。
--remote_result_cache_priority=<an integer>
のデフォルト: 「0」- リモート キャッシュに保存されるリモート アクションの相対的な優先度。特定の優先度の値のセマンティクスは、サーバーによって異なります。
--remote_retries=<an integer>
のデフォルト: 「5」- 一時的なエラーの再試行の最大回数。0 に設定した場合、再試行は無効になります。
--remote_retry_max_delay=<An immutable length of time.>
のデフォルト: 「5s」- リモートでの再試行間の最大バックオフ遅延。使用できる単位は、日(d)、時間(h)、分(m)、秒(s)、ミリ秒(ms)です。単位を省略すると、値は秒と解釈されます。
--remote_timeout=<An immutable length of time.>
のデフォルト: 「60s」- リモート実行およびキャッシュ呼び出しを待機する最大時間。REST キャッシュの場合、これは接続タイムアウトと読み取りタイムアウトの両方です。使用できる単位は、日(d)、時間(h)、分(m)、秒(s)、ミリ秒(ms)です。単位を省略すると、値は秒と解釈されます。
--[no]remote_upload_local_results
のデフォルト: 「true」- リモート キャッシュがサポートされていて、ユーザーにその権限が付与されている場合、ローカルで実行したアクションの結果をリモート キャッシュにアップロードするかどうかを指定します。
--[no]remote_verify_downloads
のデフォルト: 「true」- true に設定すると、Bazel はリモート ダウンロードのすべてのハッシュ合計を計算し、想定値と一致しない場合、リモート キャッシュに保存された値を破棄します。
- その他のカテゴリ(特に分類されていないもの):
--build_metadata=<a 'name=value' assignment>
件の複数回の使用が累積される-
ビルドイベントで指定するカスタム Key-Value 文字列ペア。
タグ:terminal_output
--color=<yes, no or auto>
のデフォルト: "auto"- ターミナル コントロールを使用して出力を色付けします。
--config=<a string>
件の複数回の使用が累積される- rc ファイルから追加の構成セクションを選択します。すべての <command> について、そのようなセクションが存在する場合は <command>:<config> からもオプションを取得します。このセクションが存在しない場合、Blaze はエラーで失敗します。config セクションとフラグの組み合わせは、 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.>
件の複数回の使用が累積される- リポジトリの取得、リモート キャッシュと実行、ビルドイベント サービスの認可認証情報の取得に使用する認証情報ヘルパーを構成します。 ヘルパーによって提供される認証情報は、--google_default_credentials、--google_credentials、.netrc ファイル、または repository_resourcemanager.download および repository_setIamPolicy.download_and_extract に対する auth パラメータで指定された認証情報よりも優先されます。 複数回指定して複数のヘルパーを設定することもできます。 詳細については、https://github.com/bazelbuild/proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md をご覧ください。
--credential_helper_cache_duration=<An immutable length of time.>
のデフォルト: 「30m」- 認証情報ヘルパーによって提供される認証情報がキャッシュに保存される期間。を呼び出すと、既存のエントリの存続期間が調整されます。0 を渡してキャッシュを消去します。clean コマンドは、このフラグに関係なく常にキャッシュをクリアします。
--credential_helper_timeout=<An immutable length of time.>
のデフォルト: 「10s」- 認証情報ヘルパーのタイムアウトを構成します。このタイムアウト内に応答しない認証情報ヘルパーは、呼び出しに失敗します。
--curses=<yes, no or auto>
のデフォルト: "auto"- ターミナル カーソル コントロールを使用して、スクロール出力を最小化します。
--disk_cache=<a path>
デフォルト: 説明を参照- Bazel がアクションとアクション出力の読み取りと書き込みを行うことができるディレクトリのパス。ディレクトリが存在しない場合は作成されます。
--[no]enable_platform_specific_config
デフォルト: 「false」- true の場合、Bazel は bazelrc ファイルからホスト OS 固有の構成行を選択します。たとえば、ホスト OS が Linux で bazel ビルドを実行すると、Bazel は build:linux で始まる行を選択します。サポートされている OS 識別子は、linux、macos、windows、freebsd、openbsd です。このフラグを有効にすると、Linux では --config=linux、Windows では --config=windows などを使用した場合と同じ結果になります。
--[no]experimental_rule_extension_api
デフォルト: 「false」-
試験運用版のルール拡張 API とサブルール API を有効にする
タグ:loading_and_analysis
、experimental
--[no]experimental_windows_watchfs
デフォルト: 「false」- true の場合、--watchfs の試験運用版の Windows サポートが有効になります。それ以外の場合、--watchfs は Windows では動作しません。--watchfs も必ず有効にしてください。
--google_auth_scopes=<comma-separated list of options>
: https://www.googleapis.com/auth/cloud-platform- Google Cloud 認証スコープのカンマ区切りリスト。
--google_credentials=<a string>
デフォルト: 説明を参照- 認証情報の取得元ファイルを指定します。詳細については、https://cloud.google.com/docs/authentication をご覧ください。
--[no]google_default_credentials
デフォルト: 「false」- 認証に「Google アプリケーションのデフォルト認証情報」を使用するかどうかを指定します。詳細については、https://cloud.google.com/docs/authentication をご覧ください。デフォルトで無効。
--grpc_keepalive_time=<An immutable length of time.>
デフォルト: 説明を参照- 送信 gRPC 接続のキープアライブ ping を構成します。これが設定されている場合、この時間の経過後に接続で読み取りオペレーションが行われないと、Bazel は ping を送信します。ただし、保留中の gRPC 呼び出しが 1 つ以上ある場合に限られます。時刻は秒単位で処理されます。1 秒未満の値を設定するとエラーになります。デフォルトでは、キープアライブ ping は無効になっています。この設定を有効にする前に、サービス オーナーと調整する必要があります。たとえば、このフラグに 30 秒の値を設定するには、--grpc_keepalive_time=30s のようにする必要があります。
--grpc_keepalive_timeout=<An immutable length of time.>
のデフォルト: 「20s」- 送信 gRPC 接続のキープアライブ タイムアウトを構成します。キープアライブ ping が --grpc_keepalive_time で有効になっている場合、この時間を超えて ping 応答を受信しないと、Bazel は接続をタイムアウトします。時刻は秒単位で処理されます。1 秒未満の値を設定するとエラーになります。キープアライブ ping が無効になっている場合、この設定は無視されます。
--[no]incompatible_disable_non_executable_java_binary
デフォルト: 「false」-
true の場合、java_binary は常に実行可能です。create_executable 属性は削除されます。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_disallow_symlink_file_to_dir
のデフォルト: 「true」-
オペレーションなし
タグ:loading_and_analysis
、incompatible_change
--[no]progress_in_terminal_title
デフォルト: 「false」- ターミナルのタイトルでコマンドの進行状況を表示します。複数のターミナルタブがあるときに bazel が何を行っているかを確認するのに便利です。
--[no]show_progress
のデフォルト: 「true」- ビルド中に進行状況メッセージを表示します。
--show_progress_rate_limit=<a double>
のデフォルト: 0.2- 出力における進行状況メッセージ間の最小秒数。
--[no]show_timestamps
デフォルト: 「false」- メッセージにタイムスタンプを含める
--tls_certificate=<a string>
デフォルト: 説明を参照- サーバー証明書への署名で信頼できる TLS 証明書のパスを指定します。
--tls_client_certificate=<a string>
デフォルト: 説明を参照- 使用する TLS クライアント証明書を指定します。クライアント認証を有効にするためのクライアント キーも指定する必要があります。
--tls_client_key=<a string>
デフォルト: 説明を参照- 使用する TLS クライアント キーを指定します。クライアント認証を有効にするためのクライアント証明書も指定する必要があります。
--ui_actions_shown=<an integer>
のデフォルト: 「8」-
詳細な進行状況バーに表示される同時実行アクションの数。各アクションは個別の行に表示されます。進行状況バーには少なくとも 1 つが常に表示され、1 未満のすべての数値は 1 にマッピングされます。
タグ:terminal_output
--[no]watchfs
デフォルト: 「false」- Linux/macOS の場合: true の場合、bazel はすべてのファイルで変更をスキャンする代わりに、ローカルの変更についてオペレーティング システムのファイル監視サービスを使用しようとします。Windows の場合: このフラグは現在非 op ですが、--experimental_windows_watchfs と組み合わせて有効にすることもできます。すべての OS の場合: ワークスペースがネットワーク ファイル システム上にあり、ファイルがリモートマシンで編集されている場合、動作は未定義になります。
Analyze-profile オプション
- コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path>
件の複数回の使用が累積される-
ネットワークにアクセスしてダウンロードする前に、アーカイブを検索できる場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
デフォルト: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュでファイルがコピーされずにハードリンクされます。これはディスク容量を節約することが目的です。
タグ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
のデフォルト: 「0」-
ダウンロード エラーの再試行の最大回数。0 に設定した場合、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: 1.0-
この要素に基づいて、Starlark リポジトリ ルールのすべてのタイムアウトをスケールします。これにより、ソースコードを変更せずに、ルール作成者の期待よりも低速なマシンで外部リポジトリを動作させることができます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
のデフォルト: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: 「0s」-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にした場合、タイムアウトの最大値は定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: 1.0-
HTTP ダウンロードに関連するすべてのタイムアウトを、指定された係数でスケーリングする
タグ:bazel_internal_configuration
--repository_cache=<a path>
デフォルト: 説明を参照-
外部リポジトリの取得中に取得された、ダウンロードした値のキャッシュ ロケーションを指定します。引数として空の文字列は、キャッシュの無効化をリクエストします。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
デフォルト: 「false」-
設定すると、リポジトリの取得中に resourcemanager.download{,_and_extract} を使用してダウンロードできなくなります。ネットワーク アクセスは完全に無効にされているわけではありません。インターネットにアクセスする任意の実行可能ファイルを resourcemanager.execute で実行することは可能です。
タグ:bazel_internal_configuration
- ビルド実行を制御するオプション:
--gc_thrashing_threshold=<an integer in 0-100 range>
のデフォルト: 「100」-
GcThrashingDetector がメモリ プレッシャー イベントを上限(--gc_thrashing_limits)と比較して考慮する、在職期間の占有スペースの割合(0 ~ 100)。100 に設定すると、GcThrashingDetector は無効になります。
タグ:host_machine_resource_optimizations
- Bzlmod の出力とセマンティクスに関連するオプション:
--allow_yanked_versions=<a string>
件の複数回の使用が累積される-
モジュール バージョンを「<module1>@<version1>,<module2>@<version2>」の形式で指定しました。これは、モジュール バージョンが元のレジストリでヤンクされていると宣言されていても(NonRegistryOverride からのものではない場合)、解決済みの依存関係グラフで許可します。そうしないと、バージョンをアンクすると解決が失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可するヤンク バージョンを定義することもできます。このチェックを無効にするには、キーワード「all」を使用します(非推奨)。
タグ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
デフォルト: "error"-
Bazel モジュールの bazel バージョン互換性を確認します。有効な値は、エラーを解決失敗にエスカレーションする場合は「error」、チェックを無効にする場合は「off」、不一致が検出されたときに警告を出力する場合は「warning」です。
タグ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
のデフォルト: 「warning」-
ルート モジュールで宣言されている直接的な「bazel_dep」依存関係が、解決された依存関係グラフで表示されるバージョンと同じかどうかを確認します。有効な値は、チェックを無効にする「off」、不一致が検出されたときに警告を出力する「warning」、解決失敗にエスカレーションする場合は「error」です。
タグ:loading_and_analysis
--[no]ignore_dev_dependency
デフォルト: 「false」-
true の場合、Bazel は、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」を無視します。これらの dev の依存関係は、このフラグの値に関係なく、ルート モジュールでない場合、MODULE.bazel では常に無視されることに注意してください。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: 「update」-
ロックファイルを使用する方法と使用するかどうかを指定します。有効な値は、「update」でロックファイルを使用し、変更がある場合に「error」を指定します。「error」はロックファイルを使用しますが、最新でない場合はエラーをスローします。「off」はロックファイルの読み取りも書き込みも行わない「off」です。
タグ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
件の複数回の使用が累積される- <モジュール名>=<パス> という形式のローカルパスでモジュールをオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。相対パスの場合は、現在の作業ディレクトリからの相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--registry=<a string>
件の複数回の使用が累積される-
Bazel モジュールの依存関係の検索に使用するレジストリを指定します。順序は重要です。モジュールは最初に以前のレジストリで検索され、以前のレジストリからモジュールが見つからなくなった場合にのみ、後のレジストリにフォールバックします。
タグ:changes_inputs
- ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
デフォルト: 「1s:2,20s:3,1m:5」-
上限に達すると GcThrashingDetector が OOM で Bazel をクラッシュさせる上限。各制限は、<period>:<count> の形式で指定します。[期間] は期間、[カウント] は正の整数です。<period> で <count> 回連続してフル GC を実行した後、残存容量(旧世代ヒープ)の --gc_thrashing_threshold パーセントを超える領域が占有されている場合、OOM がトリガーされます。複数の上限を指定する場合は、カンマで区切ってください。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出した場合、完全な GC イベントが発生したときに、不要な一時的な Skyframe の状態を呼び出しごとにこの回数まで破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、完全な GC イベントがドロップをトリガーしないことを意味します。上限に達すると、フル GC イベントが発生して保持されるヒープの割合のしきい値を超えたときに、スカイフレームの状態がドロップされなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出すると、マイナー GC イベントが発生したときに不要な一時的な Skyframe 状態を(呼び出しごとにこの回数まで)破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。上限に達すると、マイナー GC イベントが発生して保持されるヒープの割合のしきい値を超えても、スカイフレームの状態は破棄されなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
のデフォルト: 「85」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。Bazel は、保持されているヒープの割合がこのしきい値以上であることを検出すると、不要な一時的な Skyframe 状態を削除します。これを微調整することで、GC スラッシングが(i)この一時的な状態のメモリ使用量によって発生し、(ii)必要なときに状態の再構築よりもコストが高くなる場合に、GC スラッシングの経過時間への影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
- ロギングの詳細度、形式、場所に影響するオプション:
--dump=<text or raw>
[-d
] デフォルト: 説明を参照-
完全なプロファイル データダンプを、人が読める「テキスト」形式またはスクリプトが理解しやすい「raw」形式で出力します。
タグ:affects_outputs
--[no]experimental_command_profile
デフォルト: 「false」- Java フライト レコーダーの CPU プロファイルを、出力ベース ディレクトリにある profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプや出力形式をサポートするために今後変更される可能性があります。ご自身の責任のもとで使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
デフォルト: 「false」- デフォルトでは、アクション タイプの数は、実行されるアクションの数が最も多い 20 個のニーモニックに限定されています。このオプションを設定すると、すべてのニーモニックの統計情報が書き込まれます。
- 他のカテゴリに当てはまらない Bazel コマンドへの汎用入力を指定または変更するオプション。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: ""-
空でない場合は、WORKSPACE ファイルではなく、指定された解決済みファイルを読み取ります。
タグ:changes_inputs
- リモート キャッシュと実行オプション:
--experimental_downloader_config=<a string>
デフォルト: 説明を参照- リモート ダウンローダーを構成するファイルを指定します。このファイルは複数の行で構成され、各行はディレクティブ(「allow」、「block」、「rewrite」)で始まり、その後にホスト名(「allow」と「block」のそれぞれ)または 2 つのパターン(1 つは照合され、もう 1 つは代替 URL として使用)が続きます。後方参照は「$1」から始まります。複数の「rewrite」ディレクティブが返される場合があります。同じ URL の場合は、複数の URL が返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: 「off」- リポジトリの取得に使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、「platform」に設定されている場合はプラットフォーム スレッド(OS スレッド)を使用し、「virtual」に設定されている場合は仮想スレッドを使用します。
- その他のカテゴリ(特に分類されていないもの):
--override_repository=<an equals-separated mapping of repository name to path>
件の複数回の使用が累積される- リポジトリは、<repository name>=<path> という形式のローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスがそのまま使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
Aquery オプション
build からすべてのオプションを継承します。
- コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path>
件の複数回の使用が累積される-
ネットワークにアクセスしてダウンロードする前に、アーカイブを検索できる場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
デフォルト: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュでファイルがコピーされずにハードリンクされます。これはディスク容量を節約することが目的です。
タグ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
のデフォルト: 「0」-
ダウンロード エラーの再試行の最大回数。0 に設定した場合、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: 1.0-
この要素に基づいて、Starlark リポジトリ ルールのすべてのタイムアウトをスケールします。これにより、ソースコードを変更せずに、ルール作成者の期待よりも低速なマシンで外部リポジトリを動作させることができます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
のデフォルト: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: 「0s」-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にした場合、タイムアウトの最大値は定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: 1.0-
HTTP ダウンロードに関連するすべてのタイムアウトを、指定された係数でスケーリングする
タグ:bazel_internal_configuration
--repository_cache=<a path>
デフォルト: 説明を参照-
外部リポジトリの取得中に取得された、ダウンロードした値のキャッシュ ロケーションを指定します。引数として空の文字列は、キャッシュの無効化をリクエストします。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
デフォルト: 「false」-
設定すると、リポジトリの取得中に resourcemanager.download{,_and_extract} を使用してダウンロードできなくなります。ネットワーク アクセスは完全に無効にされているわけではありません。インターネットにアクセスする任意の実行可能ファイルを resourcemanager.execute で実行することは可能です。
タグ:bazel_internal_configuration
- ビルド実行を制御するオプション:
--gc_thrashing_threshold=<an integer in 0-100 range>
のデフォルト: 「100」-
GcThrashingDetector がメモリ プレッシャー イベントを上限(--gc_thrashing_limits)と比較して考慮する、在職期間の占有スペースの割合(0 ~ 100)。100 に設定すると、GcThrashingDetector は無効になります。
タグ:host_machine_resource_optimizations
- クエリの出力とセマンティクスに関連するオプション:
--aspect_deps=<off, conservative or precise>
のデフォルト: "conservative"-
出力形式が {xml,proto,record} のいずれかの場合に、アスペクトの依存関係を解決する方法。「off」は、アスペクトの依存関係が解決されないことを意味します。「conservative」(デフォルト)は、宣言されたすべてのアスペクト依存関係が、直接的な依存関係のルールクラスが与えられるかどうかにかかわらず、追加されることを意味します。「正確」は、直接的な依存関係のルールクラスが与えられている可能性のあるアスペクトのみが追加されることを意味します。高精度モードでは、1 つのターゲットを評価するために他のパッケージを読み込む必要があるため、他のモードよりも遅くなります。また、精密モードであっても完全に正確というわけではありません。アスペクトを計算するかどうかは、分析フェーズで決定され、bazel クエリでは実行されません。
タグ:build_file_semantics
--[no]consistent_labels
デフォルト: 「false」-
有効にすると、すべてのクエリコマンドは、<code>Label</code> インスタンスに適用された Starlark <code>str</code> 関数であるかのようにラベルを出力します。これは、さまざまなクエリ コマンドの出力やルールによって発行されたラベルを照合する必要があるツールに便利です。有効になっていない場合、出力フォーマッタは、出力を読みやすくするために、明らかなリポジトリ名(メイン リポジトリからの相対名)を自由に出力できます。
タグ:terminal_output
--[no]graph:factored
のデフォルト: 「true」-
true の場合、グラフは「因数分解された」状態で出力されます。つまり、トポロジ的に同等のノードがマージされ、それらのラベルが連結されます。このオプションは --output=graph にのみ適用されます。
タグ:terminal_output
--graph:node_limit=<an integer>
のデフォルト: 「512」-
出力内のグラフノードのラベル文字列の最大長。長いラベルは切り捨てられます。-1 を指定すると、切り捨てられません。このオプションは --output=graph にのみ適用されます。
タグ:terminal_output
--[no]implicit_deps
のデフォルト: 「true」-
有効にすると、クエリが実行される依存関係グラフに暗黙的な依存関係が含まれます。暗黙的な依存関係とは、BUILD ファイルで明示的に指定されていないものの、bazel によって追加された依存関係のことです。cquery の場合、解決されたツールチェーンのフィルタリングを制御します。
タグ:build_file_semantics
--[no]include_artifacts
のデフォルト: 「true」-
出力内のアクション入力と出力の名前を含みます(サイズが大きい可能性があります)。
タグ:terminal_output
--[no]include_aspects
のデフォルト: 「true」-
aquery、cquery: アスペクトによって生成されたアクションを出力に含めるかどうか。query: no-op(アスペクトは常に追跡されます)。
タグ:terminal_output
--[no]include_commandline
のデフォルト: 「true」-
出力にアクション コマンドラインの内容が含まれます(サイズが大きくなる場合もあります)。
タグ:terminal_output
--[no]include_file_write_contents
デフォルト: 「false」-
FileWrite、SourceSymlinkManifest、RepoMappingManifest の各アクションのファイル コンテンツを含めます(サイズが大きくなる場合もあります)。
タグ:terminal_output
--[no]include_param_files
デフォルト: 「false」-
コマンドで使用されるパラメータ ファイルの内容を含めます(サイズが大きくなる場合もあります)。注: このフラグを有効にすると、--include_commandline フラグが自動的に有効になります。
タグ:terminal_output
--[no]incompatible_package_group_includes_double_slash
のデフォルト: 「true」-
有効にすると、package_group の「packages」属性を出力するときに、先頭の「//」は省略されません。
タグ:terminal_output
、incompatible_change
--[no]infer_universe_scope
デフォルト: 「false」-
設定されていて、--universe_scope が設定されていない場合、--universe_scope の値は、クエリ式内の一意のターゲット パターンのリストとして推定されます。ユニバース スコープの関数(allrdeps など)を使用するクエリ式で推測される --universe_scope の値は、望ましくない可能性があるので、実行する処理がわかっている場合にのみ、このオプションを使用してください。詳細と例については、https://bazel.build/reference/query#sky-query をご覧ください。--universe_scope が設定されている場合、このオプションの値は無視されます。注: このオプションは「query」にのみ適用されます(つまり、「cquery」には適用されません)。
タグ:loading_and_analysis
--[no]line_terminator_null
デフォルト: 「false」-
各形式が改行ではなく \0 で終了しているかどうか。
タグ:terminal_output
--[no]nodep_deps
のデフォルト: 「true」-
有効にすると、"nodep" 属性からの依存関係が、クエリを操作する依存関係グラフに含まれます。「nodep」属性の一般的な例としては、「visibility」があります。「info build-language」の出力を実行して解析し、ビルド言語のすべての「nodep」属性を確認します。
タグ:build_file_semantics
--output=<a string>
のデフォルト: "text"-
クエリの結果を表示する形式。クエリで使用できる値は、text、textproto、proto、streamed_proto、jsonproto です。
タグ:terminal_output
--[no]proto:default_values
のデフォルト: 「true」-
true の場合、BUILD ファイルで値が明示的に指定されていない属性が含まれます。それ以外の場合は省略されます。このオプションは --output=proto に適用されます。
タグ:terminal_output
--[no]proto:definition_stack
デフォルト: 「false」-
Definition_stack proto フィールドに、ルールのクラスが定義された時点の Starlark コールスタックをルール インスタンスごとに記録します。
タグ:terminal_output
--[no]proto:flatten_selects
のデフォルト: 「true」-
有効にすると、select() によって作成された構成可能な属性がフラット化されます。リストタイプの場合、フラット表現は、セレクトマップの各値を 1 回だけ含むリストです。スカラー型は null にフラット化されます。
タグ:build_file_semantics
--[no]proto:include_attribute_source_aspects
デフォルト: 「false」-
各属性の source_aspect_name proto フィールドに、属性の取得元であるソースのアスペクトを入力します(そうでない場合は空の文字列)。
タグ:terminal_output
--[no]proto:include_synthetic_attribute_hash
デフォルト: 「false」- $internal_attr_hash 属性を計算して入力するかどうかを指定します。
タグ:terminal_output
--[no]proto:instantiation_stack
デフォルト: 「false」-
各ルールのインスタンス化コールスタックにデータを入力します。これを行うには、スタックが存在する必要があります。
タグ:terminal_output
--[no]proto:locations
のデフォルト: 「true」-
proto 出力で位置情報を出力するかどうか。
タグ:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
のデフォルト: 「all」-
出力に含める属性のカンマ区切りリスト。デフォルトはすべての属性です。属性を出力しない場合は、空の文字列に設定します。このオプションは --output=proto に適用できます。
タグ:terminal_output
--[no]proto:rule_inputs_and_outputs
のデフォルト: 「true」-
rule_input と rule_output の各フィールドにデータを入力するかどうかを指定します。
タグ:terminal_output
--query_file=<a string>
のデフォルト: ""-
設定すると、クエリはコマンドラインではなく、ここで指定したファイルからクエリを読み取ります。ここでファイルを指定してコマンドライン クエリを指定するとエラーになります。
タグ:changes_inputs
--[no]relative_locations
デフォルト: 「false」-
true の場合、xml 出力と proto 出力での BUILD ファイルの場所は相対的になります。デフォルトでは、場所の出力は絶対パスであり、マシン間で一貫していません。このオプションを true に設定すると、マシン全体で一貫した結果が得られます。
タグ:terminal_output
--[no]skyframe_state
デフォルト: 「false」-
追加分析を行わずに、現在のアクション グラフを Skyframe からダンプします。注: 現時点では、--skyframe_state でターゲットを指定することはサポートされていません。このフラグは、--output=proto または --output=textproto でのみ使用できます。
タグ:terminal_output
--[no]tool_deps
のデフォルト: 「true」-
クエリ: 無効にすると、クエリの実行対象となる依存関係グラフに「実行構成」の依存関係は含まれません。「proto_library」ルールから Protocol Compiler までの「exec 構成」依存関係エッジは通常、同じ「ターゲット」プログラムの一部ではなく、ビルド中に実行されたツールを指します。
Cquery: 無効にすると、この構成済みターゲットを検出した最上位ターゲットから実行移行を通過する構成済みターゲットがすべて除外されます。つまり、最上位のターゲットがターゲット構成に含まれている場合は、そのターゲット構成にも構成済みのターゲットのみが返されます。最上位のターゲットが exec 構成に含まれている場合は、exec 構成のターゲットのみが返されます。このオプションは、解決済みのツールチェーンを除外しません。
タグ:build_file_semantics
--universe_scope=<comma-separated list of options>
のデフォルト: ""-
カンマ区切りのターゲット パターンのセット(加法と減算)。クエリは、指定されたターゲットの推移的クロージャで定義されたユニバースで実行できます。このオプションは、query コマンドと cquery コマンドで使用されます。cquery の場合、このオプションに入力する値はすべての回答がビルドされるターゲットとなるため、このオプションは構成や遷移に影響する可能性があります。このオプションが指定されていない場合、トップレベル ターゲットはクエリ式から解析されたターゲットと見なされます。注: cquery でこのオプションを指定しないと、クエリ式から解析されたターゲットがトップレベル オプションでビルドできない場合、ビルドが中断されることがあります。
タグ:loading_and_analysis
- Bzlmod の出力とセマンティクスに関連するオプション:
--allow_yanked_versions=<a string>
件の複数回の使用が累積される-
モジュール バージョンを「<module1>@<version1>,<module2>@<version2>」の形式で指定しました。これは、モジュール バージョンが元のレジストリでヤンクされていると宣言されていても(NonRegistryOverride からのものではない場合)、解決済みの依存関係グラフで許可します。そうしないと、バージョンをアンクすると解決が失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可するヤンク バージョンを定義することもできます。このチェックを無効にするには、キーワード「all」を使用します(非推奨)。
タグ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
デフォルト: "error"-
Bazel モジュールの bazel バージョン互換性を確認します。有効な値は、エラーを解決失敗にエスカレーションする場合は「error」、チェックを無効にする場合は「off」、不一致が検出されたときに警告を出力する場合は「warning」です。
タグ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
のデフォルト: 「warning」-
ルート モジュールで宣言されている直接的な「bazel_dep」依存関係が、解決された依存関係グラフで表示されるバージョンと同じかどうかを確認します。有効な値は、チェックを無効にする「off」、不一致が検出されたときに警告を出力する「warning」、解決失敗にエスカレーションする場合は「error」です。
タグ:loading_and_analysis
--[no]ignore_dev_dependency
デフォルト: 「false」-
true の場合、Bazel は、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」を無視します。これらの dev の依存関係は、このフラグの値に関係なく、ルート モジュールでない場合、MODULE.bazel では常に無視されることに注意してください。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: 「update」-
ロックファイルを使用する方法と使用するかどうかを指定します。有効な値は、「update」でロックファイルを使用し、変更がある場合に「error」を指定します。「error」はロックファイルを使用しますが、最新でない場合はエラーをスローします。「off」はロックファイルの読み取りも書き込みも行わない「off」です。
タグ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
件の複数回の使用が累積される- <モジュール名>=<パス> という形式のローカルパスでモジュールをオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。相対パスの場合は、現在の作業ディレクトリからの相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--registry=<a string>
件の複数回の使用が累積される-
Bazel モジュールの依存関係の検索に使用するレジストリを指定します。順序は重要です。モジュールは最初に以前のレジストリで検索され、以前のレジストリからモジュールが見つからなくなった場合にのみ、後のレジストリにフォールバックします。
タグ:changes_inputs
- ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
デフォルト: 「1s:2,20s:3,1m:5」-
上限に達すると GcThrashingDetector が OOM で Bazel をクラッシュさせる上限。各制限は、<period>:<count> の形式で指定します。[期間] は期間、[カウント] は正の整数です。<period> で <count> 回連続してフル GC を実行した後、残存容量(旧世代ヒープ)の --gc_thrashing_threshold パーセントを超える領域が占有されている場合、OOM がトリガーされます。複数の上限を指定する場合は、カンマで区切ってください。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出した場合、完全な GC イベントが発生したときに、不要な一時的な Skyframe の状態を呼び出しごとにこの回数まで破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、完全な GC イベントがドロップをトリガーしないことを意味します。上限に達すると、フル GC イベントが発生して保持されるヒープの割合のしきい値を超えたときに、スカイフレームの状態がドロップされなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出すると、マイナー GC イベントが発生したときに不要な一時的な Skyframe 状態を(呼び出しごとにこの回数まで)破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。上限に達すると、マイナー GC イベントが発生して保持されるヒープの割合のしきい値を超えても、スカイフレームの状態は破棄されなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
のデフォルト: 「85」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。Bazel は、保持されているヒープの割合がこのしきい値以上であることを検出すると、不要な一時的な Skyframe 状態を削除します。これを微調整することで、GC スラッシングが(i)この一時的な状態のメモリ使用量によって発生し、(ii)必要なときに状態の再構築よりもコストが高くなる場合に、GC スラッシングの経過時間への影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
- ロギングの詳細度、形式、場所に影響するオプション:
--[no]experimental_command_profile
デフォルト: 「false」- Java フライト レコーダーの CPU プロファイルを、出力ベース ディレクトリにある profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプや出力形式をサポートするために今後変更される可能性があります。ご自身の責任のもとで使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
デフォルト: 「false」- デフォルトでは、アクション タイプの数は、実行されるアクションの数が最も多い 20 個のニーモニックに限定されています。このオプションを設定すると、すべてのニーモニックの統計情報が書き込まれます。
- 他のカテゴリに当てはまらない Bazel コマンドへの汎用入力を指定または変更するオプション。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: ""-
空でない場合は、WORKSPACE ファイルではなく、指定された解決済みファイルを読み取ります。
タグ:changes_inputs
- リモート キャッシュと実行オプション:
--experimental_downloader_config=<a string>
デフォルト: 説明を参照- リモート ダウンローダーを構成するファイルを指定します。このファイルは複数の行で構成され、各行はディレクティブ(「allow」、「block」、「rewrite」)で始まり、その後にホスト名(「allow」と「block」のそれぞれ)または 2 つのパターン(1 つは照合され、もう 1 つは代替 URL として使用)が続きます。後方参照は「$1」から始まります。複数の「rewrite」ディレクティブが返される場合があります。同じ URL の場合は、複数の URL が返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: 「off」- リポジトリの取得に使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、「platform」に設定されている場合はプラットフォーム スレッド(OS スレッド)を使用し、「virtual」に設定されている場合は仮想スレッドを使用します。
- その他のカテゴリ(特に分類されていないもの):
--override_repository=<an equals-separated mapping of repository name to path>
件の複数回の使用が累積される- リポジトリは、<repository name>=<path> という形式のローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスがそのまま使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定したパスが「%workspace%」で始まる場合は、ワークスペースのルートからの相対パス(「bazel info workspace」の出力)になります
- ビルド実行を制御するオプション:
--[no]experimental_inprocess_symlink_creation
デフォルト: 「false」-
直接ファイル システム呼び出しを行ってシンボリック リンク ツリーを作成するかどうか
タグ:loading_and_analysis
、execution
、experimental
--[no]experimental_persistent_aar_extractor
デフォルト: 「false」-
ワーカーを使用して永続 AAR エクストラクタを有効にします。
タグ:execution
--[no]experimental_remotable_source_manifests
デフォルト: 「false」-
ソース マニフェストのアクションをリモート可能にするかどうか
タグ:loading_and_analysis
、execution
、experimental
--[no]experimental_split_coverage_postprocessing
デフォルト: 「false」-
true の場合、Bazel は新しい Spawn でテストのためにカバレッジの後処理を実行します。
タグ:execution
--[no]experimental_strict_fileset_output
デフォルト: 「false」-
このオプションを有効にすると、ファイルセットはすべての出力アーティファクトを通常のファイルとして扱います。ディレクトリを移動したり、シンボリック リンクの影響を受けたりすることはありません。
タグ:execution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
のデフォルト: ""-
アクションのニーモニックに基づいて、アクションの実行情報からキーを追加または削除します。実行情報をサポートするアクションにのみ適用されます。Genrule、CppCompile、Javac、StarlarkAction、TestRunner など、多くの一般的なアクションが実行情報をサポートしています。複数の値を指定する場合、多くの正規表現が同じニーモニックに適用される可能性があるため、順序が重要です。構文: "regex=[+-]key,regex=[+-]key,..."。
例: '.*=+x,.*=-y,.*=+z' は、すべてのアクションの実行情報に「x」と「z」を追加し、実行情報から「y」を削除します。
「Genrule=+requires-x」は、すべての Genrule アクションの実行情報に「requires-x」を追加します。
「(?!Genrule).*=-requires-x」は、Genrule 以外のすべてのアクションの実行情報から「requires-x」を削除します。
タグ:execution
、affects_outputs
、loading_and_analysis
--persistent_android_dex_desugar
-
ワーカーを使用して、永続的な Android dex および desugar アクションを有効にします。
次のように展開します。
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
タグ:host_machine_resource_optimizations
、execution
--persistent_android_resource_processor
-
ワーカーを使用して、永続的な Android リソース プロセッサを有効にします。
次のように展開:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_desugar
-
ワーカーを使用して、永続的な多重化された Android dex アクションと desugar アクションを有効にします。
展開先:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
タグ:host_machine_resource_optimizations
、execution
--persistent_multiplex_android_resource_processor
-
ワーカーを使用して、永続的な多重化された Android リソース プロセッサを有効にします。
次のように拡張:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
-
永続的な多重化 Android ツール(dex 変換、脱糖、リソース処理)を有効にします。
次のように展開します。
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
タグ:host_machine_resource_optimizations
、execution
--[no]use_target_platform_for_tests
デフォルト: 「false」-
true の場合、Bazel はテスト実行グループではなく、ターゲット プラットフォームを使用してテストを実行します。
タグ:execution
- アクションの実行に使用するツールチェーンを構成するオプション:
--android_compiler=<a string>
デフォルト: 説明を参照-
Android ターゲット コンパイラ。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--android_crosstool_top=<a build target label>
のデフォルト: 「//external:android/crosstool」-
Android ビルドに使用される C++ コンパイラの場所。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
、loses_incremental_state
--android_grte_top=<a label>
デフォルト: 説明を参照-
Android ターゲット grte_top。
タグ:changes_inputs
、loading_and_analysis
、loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
のデフォルト: 「android」-
android_binary ルールに使用するマニフェスト マージを選択します。以前のマージから Android マニフェスト マージに移行するためのフラグ。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--android_platforms=<a build target label>
のデフォルト: ""-
android_binary ターゲットが使用するプラットフォームを設定します。複数のプラットフォームが指定されている場合、バイナリはファット APK になります。これには、指定した各ターゲット プラットフォームのネイティブ バイナリが含まれます。
タグ:changes_inputs
、loading_and_analysis
、loses_incremental_state
--android_sdk=<a build target label>
のデフォルト: "@bazel_tools//tools/android:sdk"-
Android アプリのビルドに使用する Android SDK/プラットフォームを指定します。
タグ:changes_inputs
、loading_and_analysis
、loses_incremental_state
--apple_crosstool_top=<a build target label>
のデフォルト: "@bazel_tools//tools/cpp:ツールチェーン"-
Apple と Objc のルールとその依存関係で使用される crosstool パッケージのラベル。
タグ:loses_incremental_state
、changes_inputs
--cc_output_directory_tag=<a string>
のデフォルト: ""-
構成ディレクトリに追加する接尾辞を指定します。
タグ:affects_outputs
--compiler=<a string>
デフォルト: 説明を参照-
ターゲットのコンパイルに使用する C++ コンパイラ。
タグ:loading_and_analysis
、execution
--coverage_output_generator=<a build target label>
のデフォルト: "@bazel_tools//tools/test:lcov_merger"-
未処理のカバレッジ レポートの後処理に使用されるバイナリの場所。これは現在は、単一のファイル(バイナリ)を含むファイル グループである必要があります。デフォルトは「//tools/test:lcov_merger」です。
タグ:changes_inputs
、affects_outputs
、loading_and_analysis
--coverage_report_generator=<a build target label>
デフォルト: "@bazel_tools//tools/test:coverage_report_generator"-
カバレッジ レポートの生成に使用されるバイナリの場所。これは現在は、単一のファイル(バイナリ)を含むファイル グループである必要があります。デフォルトは「//tools/test:coverage_report_generator」です。
タグ:changes_inputs
、affects_outputs
、loading_and_analysis
--coverage_support=<a build target label>
デフォルト: "@bazel_tools//tools/test:coverage_support"-
コード カバレッジを収集するすべてのテスト アクションの入力で必要となるサポート ファイルの場所。デフォルトは「//tools/test:coverage_support」です。
タグ:changes_inputs
、affects_outputs
、loading_and_analysis
--crosstool_top=<a build target label>
のデフォルト: "@bazel_tools//tools/cpp:ツールチェーン"-
C++ コードのコンパイルに使用されるクロスツール パッケージのラベル。
タグ:loading_and_analysis
、changes_inputs
、affects_outputs
--custom_malloc=<a build target label>
デフォルト: 説明を参照-
カスタムの malloc 実装を指定します。この設定は、ビルドルールの malloc 属性をオーバーライドします。
タグ:changes_inputs
、affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
件の複数回の使用が累積される-
正規表現のカンマ区切りのリスト。接頭辞として -(負の式)を付けることもできます。正規表現は、カンマ区切りの制約値ターゲットのリストに「=」を代入します。ターゲットが負の式と一致せず、少なくとも 1 つの正の式と一致した場合、制約値を実行制約として宣言した場合と同様に、ツールチェーンの解決が実行されます。例: //demo,-test=@platforms//cpus:x86_64 を指定すると、//demo の下のすべてのターゲットに 'x86_64' が追加されます。ただし、名前に「test」が含まれるものは除きます。
タグ:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
デフォルト: 「false」-
設定した場合は、すべての Xcode アクションに "requires-xcode:{version}" 実行要件を追加します。xcode バージョンにハイフン付きのラベルがある場合は、「requires-xcode-label:{version_label}」実行要件も追加します。
タグ:loses_incremental_state
、loading_and_analysis
、execution
--[no]experimental_prefer_mutual_xcode
のデフォルト: 「true」-
true の場合、ローカルとリモートの両方で利用可能な最新の Xcode を使用します。false の場合、または相互利用可能なバージョンがない場合は、xcode-select で選択したローカルの Xcode バージョンを使用します。
タグ:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
のデフォルト: ""-
アクションを実行するための実行プラットフォームとして利用可能なプラットフォーム。プラットフォームは、正確なターゲットで、またはターゲット パターンとして指定できます。これらのプラットフォームは、register_execution_platforms() によって WORKSPACE ファイルで宣言されたプラットフォームより先に検討されます。このオプションは 1 回だけ設定できます。後のインスタンスは以前のフラグ設定をオーバーライドします。
タグ:execution
--extra_toolchains=<comma-separated list of options>
件の複数回の使用が累積される-
ツールチェーンの解決時に考慮されるツールチェーン ルール。ツールチェーンは正確なターゲットで指定することも、ターゲット パターンとして指定することもできます。これらのツールチェーンは、register_chains() によって WORKSPACE ファイルで宣言されたツールチェーンより先に考慮されます。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
--grte_top=<a label>
デフォルト: 説明を参照-
チェックインされた libc ライブラリのラベル。デフォルト値はクロスツール ツールチェーンによって選択されるため、オーバーライドする必要はほとんどありません。
タグ:action_command_lines
、affects_outputs
--host_compiler=<a string>
デフォルト: 説明を参照-
ホスト コンパイルに使用する C++ コンパイラ。--host_crosstool_top が設定されていない場合は無視されます。
タグ:loading_and_analysis
、execution
--host_crosstool_top=<a build target label>
デフォルト: 説明を参照-
デフォルトでは、exec 構成にも --crosstool_top オプションと --compiler オプションが使用されます。このフラグを指定すると、Bazel は指定された Crosstool_top に対してデフォルトの libc とコンパイラを使用します。
タグ:loading_and_analysis
、changes_inputs
、affects_outputs
--host_grte_top=<a label>
デフォルト: 説明を参照-
指定すると、実行構成の libc 最上位ディレクトリ(--grte_top)がオーバーライドされます。
タグ:action_command_lines
、affects_outputs
--host_platform=<a build target label>
デフォルト: "@local_config_platform//:host"-
ホストシステムを記述するプラットフォーム ルールのラベル。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
のデフォルト: 「true」-
true の場合、Bazel は c++ ツールチェーンの「ホスト」機能と「非ホスト」機能を有効にしません(詳しくは、https://github.com/bazelbuild/bazel/issues/7407 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
のデフォルト: 「true」-
ツールチェーン解決を使用して、Android ルール用の Android SDK(Starlark およびネイティブ)を選択します
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
デフォルト: 「false」-
ツールチェーン解決を使用して、Apple のルール(Starlark とネイティブ)用の Apple SDK を選択します。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
のデフォルト: 「true」-
true の場合、Bazel は lto インデックス コマンドラインに C++ リンク アクション コマンドラインを再利用しません(詳しくは、https://github.com/bazelbuild/bazel/issues/6791 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_remove_legacy_whole_archive
のデフォルト: 「true」-
true の場合、Bazel は、デフォルトでライブラリの依存関係全体をアーカイブとしてリンクしません(移行手順については、https://github.com/bazelbuild/bazel/issues/7362 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_require_ctx_in_configure_features
のデフォルト: 「true」-
true の場合、Bazel では、cc_common.configure_features で「setIamPolicy」パラメータが必要になります(詳しくは、https://github.com/bazelbuild/bazel/issues/7793 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
-
ツールチェーンでサポートされている場合は、インターフェース共有オブジェクトを使用します。現在、この設定はすべての ELF ツールチェーンでサポートされています。
タグ:loading_and_analysis
、affects_outputs
、affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
iOS アプリのビルドに使用する iOS SDK のバージョンを指定します。指定しない場合は、デフォルトの iOS SDK バージョン「xcode_version」を使用します。
タグ:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
macOS アプリケーションのビルドに使用する macOS SDK のバージョンを指定します。指定しない場合は、デフォルトの macOS SDK バージョン「xcode_version」を使用します。
タグ:loses_incremental_state
--minimum_os_version=<a string>
デフォルト: 説明を参照-
コンパイルの対象とする最小 OS バージョン。
タグ:loading_and_analysis
、affects_outputs
--platform_mappings=<a relative path>
のデフォルト: ""-
プラットフォームが設定されていない場合は使用するプラットフォーム、すでにプラットフォームが存在する場合は設定するフラグを記述するマッピング ファイルの場所。メイン ワークスペースのルートからの相対パスにする必要があります。デフォルトは「platform_mappings」(ワークスペースのルートの直下にあるファイル)に設定されています。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
--platforms=<a build target label>
のデフォルト: ""-
現在のコマンドのターゲット プラットフォームを記述するプラットフォーム ルールのラベル。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
--python2_path=<a string>
デフォルト: 説明を参照-
非推奨、No-op。「--compatible_use_python_chains」により無効になります。
タグ:no_op
、deprecated
--python3_path=<a string>
デフォルト: 説明を参照-
非推奨、No-op。「--compatible_use_python_chains」により無効になります。
タグ:no_op
、deprecated
--python_path=<a string>
デフォルト: 説明を参照-
ターゲット プラットフォームで Python ターゲットを実行するために呼び出される Python インタープリタの絶対パス。非推奨。--compatible_use_python_ツールチェーン s によって無効にされています。
タグ:loading_and_analysis
、affects_outputs
--python_top=<a build target label>
デフォルト: 説明を参照-
ターゲット プラットフォームで Python ターゲットを実行するために呼び出される Python インタープリタを表す py_runtime のラベル。非推奨。--compatible_use_python_ツールチェーン s によって無効にされています。
タグ:loading_and_analysis
、affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
tvOS アプリのビルドに使用する tvOS SDK のバージョンを指定します。指定しない場合は、デフォルトの tvOS SDK バージョン「xcode_version」を使用します。
タグ:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
watchOS アプリのビルドに使用する watchOS SDK のバージョンを指定します。指定しない場合は、「xcode_version」のデフォルトの watchOS SDK バージョンを使用します。
タグ:loses_incremental_state
--xcode_version=<a string>
デフォルト: 説明を参照-
指定すると、指定したバージョンの Xcode が関連するビルド アクションに使用されます。指定しない場合は、エグゼキュータのデフォルト バージョンの Xcode を使用します。
タグ:loses_incremental_state
--xcode_version_config=<a build target label>
デフォルト: "@bazel_tools//tools/cpp:host_xcodes"-
ビルド構成で Xcode バージョンの選択に使用される xcode_config ルールのラベル。
タグ:loses_incremental_state
、loading_and_analysis
- コマンドの出力を制御するオプション:
--[no]apple_generate_dsym
デフォルト: 「false」-
デバッグ シンボル(.dSYM)ファイルを生成するかどうかを指定します。
タグ:affects_outputs
、action_command_lines
--[no]build_runfile_links
のデフォルト: 「true」-
true の場合、すべてのターゲットに runfile のシンボリック リンク フォレストをビルドします。false の場合、ローカル アクション、テスト、または実行コマンドで必要な場合にのみ書き込みます。
タグ:affects_outputs
--[no]build_runfile_manifests
のデフォルト: 「true」-
true の場合、すべてのターゲットの runfile マニフェストを書き込みます。false の場合は省略します。false の場合、ローカルテストは実行できません。
タグ:affects_outputs
--[no]build_test_dwp
デフォルト: 「false」-
有効にすると、C++ テストを静的かつ分割してビルドするときに、テストバイナリの .dwp ファイルも自動的にビルドされます。
タグ:loading_and_analysis
、affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
のデフォルト: ".pb.h"-
cc_proto_library が作成するヘッダー ファイルの接尾辞を設定します。
タグ:affects_outputs
、loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
のデフォルト: 「.pb.cc」-
cc_proto_library が作成するソースファイルの接尾辞を設定します。
タグ:affects_outputs
、loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
デフォルト: 「false」-
proto_library の代替 Java API バージョンに対して、追加のアクションを実行します。
タグ:affects_outputs
、loading_and_analysis
、experimental
--[no]experimental_proto_extra_actions
デフォルト: 「false」-
proto_library の代替 Java API バージョンに対して、追加のアクションを実行します。
タグ:affects_outputs
、loading_and_analysis
、experimental
--[no]experimental_save_feature_state
デフォルト: 「false」-
有効な機能とリクエストされた機能の状態を、コンパイルの出力として保存します。
タグ:affects_outputs
、experimental
--fission=<a set of compilation modes>
(デフォルト): 「no」-
C++ のコンパイルとリンクに分断を使用するコンパイル モードを指定します。{'fastbuild'、'dbg'、'opt'}、またはすべてのモードを有効にする場合は 'yes'、すべてのモードを無効にする場合は 'no' を任意に組み合わせることができます。
タグ:loading_and_analysis
、action_command_lines
、affects_outputs
--[no]incompatible_always_include_files_in_data
のデフォルト: 「true」-
true の場合、ネイティブ ルールは、データ依存関係の <code>DefaultInfo.files</code> を runfile に追加します。これは Starlark ルールの推奨動作(https://bazel.build/extending/rules#runfiles_features_to_avoid)と同じです。
タグ:affects_outputs
、incompatible_change
--[no]legacy_external_runfiles
のデフォルト: 「true」-
true の場合、(.runfiles/repo に加えて).runfiles/wsname/external/repo の下に外部リポジトリの runfile シンボリック リンク フォレストを作成します。
タグ:affects_outputs
--[no]objc_generate_linkmap
デフォルト: 「false」-
リンクマップ ファイルを生成するかどうかを指定します。
タグ:affects_outputs
--[no]save_temps
デフォルト: 「false」-
設定すると、gcc からの一時的な出力が保存されます。これには、.s ファイル(アセンブラ コード)、.i ファイル(前処理された C)、.ii ファイル(前処理された C++)が含まれます。
タグ:affects_outputs
- 目的の出力をユーザーが構成できるオプション(その存在とは無関係に、目的の出力に影響を与えます):
--action_env=<a 'name=value' assignment with an optional value part>
件の複数回の使用が累積される-
ターゲット構成でのアクションで使用できる環境変数のセットを指定します。変数は、名前で指定することも(この場合、値は呼び出し環境から取得されます)か、または名前=値のペア(呼び出し環境とは無関係に値を設定する)で指定できます。このオプションは複数回使用できます。同じ変数に対して指定されたオプションの場合は、最新の優先対象が使用され、異なる変数のオプションが蓄積されます。
タグ:action_command_lines
--android_cpu=<a string>
のデフォルト: 「armeabi-v7a」-
Android のターゲット CPU。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--[no]android_databinding_use_androidx
のデフォルト: 「true」-
AndroidX 互換のデータ バインディング ファイルを生成する。これはデータ バインディング v2 でのみ使用されます。このフラグは no-op です。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--[no]android_databinding_use_v3_4_args
のデフォルト: 「true」-
Android databinding v2 と 3.4.0 引数を使用します。このフラグは no-op です。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--android_dynamic_mode=<off, default or fully>
のデフォルト: 「off」-
cc_binary が共有ライブラリを明示的に作成しない場合に、Android ルールの C++ 依存関係を動的にリンクするかどうかを決定します。「default」は、bazel が動的にリンクするかどうかを選択することを意味します。「Fully」は、すべてのライブラリが動的にリンクされることを意味します。「off」は、すべてのライブラリがほぼ静的モードでリンクされることを意味します。
タグ:affects_outputs
、loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
のデフォルト: "alphabetical"-
Android バイナリのマニフェスト マージツールに渡されるマニフェストの順序を設定します。ALPHABETICAL は、マニフェストが execroot からの相対パスによって並べ替えられることを意味します。ALPHABETICAL_BY_CONFIGURATION は、マニフェストが出力ディレクトリ内の構成ディレクトリを基準とする相対パスで並べ替えられることを意味します。DEPENDENCY は、各ライブラリのマニフェストがその依存関係のマニフェストの前に配置される状態でマニフェストが並べられることを意味します。
タグ:action_command_lines
、execution
--[no]android_resource_shrinking
デフォルト: 「false」- ProGuard を使用する android_binary APK のリソース圧縮を有効にします。
タグ:affects_outputs
、loading_and_analysis
--[no]build_python_zip
のデフォルト: "auto"-
Python 実行可能ファイル zip をビルドする(Windows では実行、他のプラットフォームではオフ)
タグ:affects_outputs
--catalyst_cpus=<comma-separated list of options>
件の複数回の使用が累積される-
Apple Catalyst バイナリをビルドするアーキテクチャのカンマ区切りリスト。
タグ:loses_incremental_state
、loading_and_analysis
--[no]collect_code_coverage
デフォルト: 「false」-
指定すると、Bazel はコードをインストルメント化し(可能であればオフラインのインストルメンテーションを使用)、テスト中にカバレッジ情報を収集します。--instrumentation_filter に一致するターゲットのみが影響を受けます。通常、このオプションは直接指定しないでください。代わりに「bazelcoverage」コマンドを使用してください。
タグ:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] default: "fastbuild"-
バイナリがビルドされるモードを指定します。値: fastbuild、dbg、opt。
タグ:affects_outputs
、action_command_lines
--conlyopt=<a string>
件の複数回の使用が累積される-
C ソースファイルのコンパイル時に gcc に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--copt=<a string>
件の複数回の使用が累積される-
gcc に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--cpu=<a string>
のデフォルト: ""-
ターゲット CPU。
タグ:changes_inputs
、affects_outputs
--cs_fdo_absolute_path=<a string>
デフォルト: 説明を参照-
CSFDO プロファイル情報を使用してコンパイルを最適化します。プロファイル ファイルを含む zip ファイルの絶対パス名(未加工の LLVM プロファイル ファイルまたはインデックス登録された LLVM プロファイル ファイル)を指定します。
タグ:affects_outputs
--cs_fdo_instrument=<a string>
デフォルト: 説明を参照-
コンテキスト センシティブな FDO 計測を使用してバイナリを生成します。Clang/LLVM コンパイラでは、実行時に未加工プロファイル ファイルがダンプされるディレクトリ名も受け入れます。
タグ:affects_outputs
--cs_fdo_profile=<a build target label>
デフォルト: 説明を参照-
最適化に使用されるコンテキスト依存プロファイルを表す cs_fdo_profile。
タグ:affects_outputs
--cxxopt=<a string>
件の複数回の使用が累積される-
C++ ソースファイルのコンパイル時に gcc に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--define=<a 'name=value' assignment>
件の複数回の使用が累積される-
各 --define オプションは、ビルド変数の割り当てを指定します。
タグ:changes_inputs
、affects_outputs
--dynamic_mode=<off, default or fully>
デフォルト: 「default」-
C++ バイナリを動的にリンクするかどうかを決定します。「default」は、Bazel が動的にリンクするかどうかを選択することを意味します。「Fully」は、すべてのライブラリが動的にリンクされることを意味します。「off」は、すべてのライブラリがほぼ静的モードでリンクされることを意味します。
タグ:loading_and_analysis
、affects_outputs
--[no]enable_fdo_profile_absolute_path
のデフォルト: 「true」-
設定した場合、fdo_absolute_profile_path を使用するとエラーになります。
タグ:affects_outputs
--[no]enable_runfiles
のデフォルト: "auto"-
runfiles シンボリック リンク ツリーを有効にします。Windows ではデフォルトではオフになっており、他のプラットフォームでは無効になっています。
タグ:affects_outputs
--experimental_action_listener=<a build target label>
件の複数回の使用が累積される-
アスペクトを優先して非推奨となりました。action_listener を使用して、extra_action を既存のビルド アクションにアタッチします。
タグ:execution
、experimental
--[no]experimental_android_compress_java_resources
デフォルト: 「false」-
APK 内の Java リソースを圧縮する
タグ:affects_outputs
、loading_and_analysis
、experimental
--[no]experimental_android_databinding_v2
のデフォルト: 「true」-
Android データ バインディング v2 を使用します。このフラグは no-op です。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--[no]experimental_android_resource_shrinking
デフォルト: 「false」- ProGuard を使用する android_binary APK のリソース圧縮を有効にします。
タグ:affects_outputs
、loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
デフォルト: 「false」-
rex ツールを使用して dex ファイルを書き換える
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--[no]experimental_collect_code_coverage_for_generated_files
デフォルト: 「false」-
指定すると、Bazel は生成されたファイルの収集カバレッジ情報も生成します。
タグ:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
デフォルト: "-O0,-DDEBUG=1"-
これらの文字列を objc fastbuild コンパイラ オプションとして使用します。
タグ:action_command_lines
--[no]experimental_omitfp
デフォルト: 「false」-
true の場合、スタックのアンワインドに libunwind を使用し、-fomit-frame-pointer と -fasync-unwind-tables を使用してコンパイルします。
タグ:action_command_lines
、affects_outputs
、experimental
--experimental_output_paths=<off, content or strip>
のデフォルト: 「off」-
特にマルチプラットフォーム / マルチ構成のビルドで、出力ツリーのルールのどこに出力を書き込むかに使用するモデル。これは非常に試験運用中です。詳細については、https://github.com/bazelbuild/bazel/issues/6526 をご覧ください。Starlark のアクションは、キー「supports-path-mapping」を「execution_requirements」辞書に追加することで、パスマッピングにオプトインできます。
タグ:loses_incremental_state
、bazel_internal_configuration
、affects_outputs
、execution
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
件の複数回の使用が累積される-
各エントリは label=value の形式にする必要があります。label はプラットフォームを指し、values は出力パスで使用する省略名です。--experimental_platform_in_output_dir が true の場合にのみ使用されます。命名の優先度が最も高い。
タグ:affects_outputs
、experimental
--[no]experimental_platform_in_output_dir
デフォルト: 「false」-
true の場合、出力ディレクトリ名に CPU ではなくターゲット プラットフォームの短縮名が使用されます。正確なスキームは試験運用中で、変更される可能性があります。まず、--platforms オプションに値が 1 つしかないというまれなケースとして、platform オプションのハッシュが使用されます。次に、現在のプラットフォームの略称が --experimental_override_name_platform_in_output_dir によって登録された場合は、その短縮名が使用されます。次に、--experimental_use_platforms_in_output_dir_legacy_heuristic が設定されている場合、現在のプラットフォーム ラベルに基づく略称を使用します。最後に、プラットフォーム オプションのハッシュが最後の手段として使用されます。
タグ:affects_outputs
、experimental
--[no]experimental_use_llvm_covmap
デフォルト: 「false」-
指定すると、collect_code_coverage が有効になっている場合、Bazel は gcov ではなく llvm-cov カバレッジ マップ情報を生成します。
タグ:changes_inputs
、affects_outputs
、loading_and_analysis
、experimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
のデフォルト: 「true」-
このフラグは、提案する移行またはテスト戦略の一部としてのみ使用してください。このヒューリスティックには既知の欠陥があるため、--experimental_override_name_platform_in_output_dir のみに依存するように移行することをおすすめします。
タグ:affects_outputs
、experimental
--fat_apk_cpu=<comma-separated set of options>
のデフォルト: 「armeabi-v7a」-
このオプションを設定すると、ファット APK が有効になります。これには、指定したすべてのターゲット アーキテクチャ(例:--fat_apk_cpu=x86,armeabi-v7a. このフラグを指定すると、android_binary ルールの依存関係で --android_cpu は無視されます。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--[no]fat_apk_hwasan
デフォルト: 「false」-
HWASAN 分割を作成するかどうかを指定します。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--fdo_instrument=<a string>
デフォルト: 説明を参照-
FDO インストルメンテーションを使用してバイナリを生成します。Clang/LLVM コンパイラでは、実行時に未加工プロファイル ファイルがダンプされるディレクトリ名も受け入れます。
タグ:affects_outputs
--fdo_optimize=<a string>
デフォルト: 説明を参照-
FDO プロファイル情報を使用してコンパイルを最適化します。.gcda ファイルツリーを含む zip ファイル、自動プロファイルを含む afdo ファイル、または LLVM プロファイル ファイルの名前を指定します。このフラグは、ラベルとして指定されたファイル(例: 「//foo/bar:file.afdo」で、対応するパッケージに「exports_files」ディレクティブを追加する必要が生じる場合があります)や、「fdo_profile」ターゲットを指すラベルも受け入れます。このフラグは「fdo_profile」ルールよりも優先されます。
タグ:affects_outputs
--fdo_prefetch_hints=<a build target label>
デフォルト: 説明を参照-
キャッシュ プリフェッチのヒントを使用します。
タグ:affects_outputs
--fdo_profile=<a build target label>
デフォルト: 説明を参照-
最適化に使用するプロファイルを表す fdo_profile。
タグ:affects_outputs
--features=<a string>
件の複数回の使用が累積される-
指定された機能は、ターゲット構成でビルドされたターゲットに対してデフォルトで有効または無効になります。-<feature> を指定すると、対象物が無効になります。否定的な特徴は常に肯定的な特徴より優先されます。--host_features もご覧ください。
タグ:changes_inputs
、affects_outputs
--[no]force_pic
デフォルト: 「false」-
有効にすると、すべての C++ コンパイルは位置非依存コード(「-fPIC」)を生成します。リンクは非 PC ライブラリよりも PIC ビルド済みライブラリを優先し、リンクは位置独立実行ファイル(「-pie」)を生成します。
タグ:loading_and_analysis
、affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
件の複数回の使用が累積される-
実行構成のアクションで使用できる環境変数のセットを指定します。変数は、名前で指定することも(この場合、値は呼び出し環境から取得されます)か、または名前=値のペア(呼び出し環境とは無関係に値を設定する)で指定できます。このオプションは複数回使用できます。同じ変数に対して指定されたオプションの場合は、最新の優先対象が使用され、異なる変数のオプションが蓄積されます。
タグ:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
のデフォルト: "opt"-
ビルド中に使用するツールがビルドされるモードを指定します。値: fastbuild、dbg、opt。
タグ:affects_outputs
、action_command_lines
--host_conlyopt=<a string>
件の複数回の使用が累積される-
exec 構成で C(C++ は除く)ソースファイルをコンパイルする際に C コンパイラに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--host_copt=<a string>
件の複数回の使用が累積される-
exec 構成でビルドされるツールのために C コンパイラに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--host_cpu=<a string>
のデフォルト: ""-
ホスト CPU。
タグ:changes_inputs
、affects_outputs
--host_cxxopt=<a string>
件の複数回の使用が累積される-
exec 構成でビルドされたツールのために C++ コンパイラに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--host_features=<a string>
件の複数回の使用が累積される-
指定された機能は、exec 構成でビルドされたターゲットに対してデフォルトで有効または無効になります。-<feature> を指定すると、対象物が無効になります。否定的な特徴は常に肯定的な特徴より優先されます。
タグ:changes_inputs
、affects_outputs
--host_force_python=<PY2 or PY3>
デフォルト: 説明を参照-
exec 構成の Python バージョンをオーバーライドします。「PY2」または「PY3」のいずれかです。
タグ:loading_and_analysis
、affects_outputs
--host_linkopt=<a string>
件の複数回の使用が累積される-
exec 構成でツールをリンクするときにリンカーに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
ホスト ターゲットに対応する macOS の最小バージョン。指定しない場合は「macos_sdk_version」を使用します。
タグ:loses_incremental_state
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
件の複数回の使用が累積される-
exec 構成で特定のファイルをコンパイルするときに、C/C++ コンパイラに選択的に渡す追加のオプション。このオプションは複数回渡すことができます。構文: regex_filter@option_1,option_2,...,option_nregex_filter は、包含および除外する正規表現パターンのリストを表します(--instrumentation_filter も参照)。option_1 から option_n は任意のコマンドライン オプションを表します。オプションにカンマが含まれる場合は、バックスラッシュで囲む必要があります。オプションには @ を含めることができます。文字列の分割には最初の @ のみが使用されます。例: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 は、//foo/ 内のすべての cc ファイル(bar.cc を除く)で gcc コマンドラインに -O0 コマンドライン オプションを追加します。
タグ:action_command_lines
、affects_outputs
--host_swiftcopt=<a string>
件の複数回の使用が累積される-
実行ツールで swiftc に渡す追加オプション。
タグ:action_command_lines
、affects_outputs
--[no]incompatible_auto_exec_groups
デフォルト: 「false」-
有効にすると、ルールで使用されるツールチェーンごとに exec グループが自動的に作成されます。これを機能させるには、ルールのアクションに「ツールチェーン」パラメータを指定する必要があります。詳細については、https://github.com/bazelbuild/bazel/issues/17134 をご覧ください。
タグ:affects_outputs
、incompatible_change
--[no]incompatible_merge_genfiles_directory
のデフォルト: 「true」-
true の場合、genfiles ディレクトリは bin ディレクトリに組み込まれます。
タグ:affects_outputs
、incompatible_change
--[no]incompatible_use_host_features
のデフォルト: 「true」-
true の場合、ターゲット構成にのみ --features を使用し、実行可能ファイル構成には --host_features を使用します。
タグ:changes_inputs
、affects_outputs
、incompatible_change
--[no]instrument_test_targets
デフォルト: 「false」-
カバレッジが有効な場合、インストルメンテーション テストルールを検討するかどうかを指定します。設定すると、--instrumentation_filter に含まれるテストルールがインストルメント化されます。それ以外の場合、テストルールは常にカバレッジ インストルメンテーションから除外されます。
タグ:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
デフォルト: "-/javatests[/:],-/test/java[/:]"-
カバレッジを有効にすると、指定した正規表現ベースのフィルタに含まれる名前を持つルールのみがインストルメント化されます。代わりに「-」で始まるルールは除外されます。--instrument_test_targets が有効になっていない限り、テスト以外のルールのみがインストルメント化されることに注意してください。
タグ:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
ターゲット シミュレータおよびデバイスに対応する最小の iOS バージョン。指定しない場合は、「ios_sdk_version」が使用されます。
タグ:loses_incremental_state
--ios_multi_cpus=<comma-separated list of options>
件の複数回の使用が累積される-
ios_application のビルドに使用するアーキテクチャのカンマ区切りリスト。その結果、指定されたすべてのアーキテクチャを含むユニバーサル バイナリが生成されます。
タグ:loses_incremental_state
、loading_and_analysis
--[no]legacy_whole_archive
のデフォルト: 「true」-
非推奨。代わりに --compatible_remove_legacy_whole_archive を使用します(詳しくは https://github.com/bazelbuild/bazel/issues/7362 をご覧ください)。オンにすると、linkshared=True と linkstatic=True または「-static」のいずれかが linkopts に設定されている cc_binary ルールに --whole-archive が使用されます。これは下位互換性用です。より適切な選択肢は、必要な場合に alwayslink=1 を使用することです。
タグ:action_command_lines
、affects_outputs
、deprecated
--linkopt=<a string>
件の複数回の使用が累積される-
リンク時に gcc に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--ltobackendopt=<a string>
件の複数回の使用が累積される-
LTO バックエンド ステップ(--features=thin_lto の下)に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--ltoindexopt=<a string>
件の複数回の使用が累積される-
LTO のインデックス登録ステップ(--features=thin_lto の下)に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--macos_cpus=<comma-separated list of options>
件の複数回の使用が累積される- Apple macOS バイナリをビルドするためのアーキテクチャのカンマ区切りリスト。
タグ:loses_incremental_state
、loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
ターゲットに対応する macOS の最小バージョン。指定しない場合は「macos_sdk_version」を使用します。
タグ:loses_incremental_state
--memprof_profile=<a build target label>
デフォルト: 説明を参照-
memprof プロファイルを使用する。
タグ:affects_outputs
--[no]objc_debug_with_GLIBCXX
デフォルト: 「false」-
設定されていて、コンパイル モードが「dbg」に設定されている場合、GLIBCXX_DEBUG、GLIBCXX_DEBUG_PEDANTIC、GLIBCPP_CONCEPT_CHECKS を定義します。
タグ:action_command_lines
--[no]objc_enable_binary_stripping
デフォルト: 「false」-
リンクされたバイナリでシンボルとデッドコードのストリップを実行するかどうかを指定します。このフラグと --compile_mode=opt の両方を指定すると、バイナリ ストリップが実行されます。
タグ:action_command_lines
--objccopt=<a string>
件の複数回の使用が累積される-
Objective-C/C++ ソースファイルのコンパイル時に gcc に渡す追加のオプション。
タグ:action_command_lines
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
件の複数回の使用が累積される-
特定のファイルをコンパイルするときに選択的に gcc に渡す追加のオプション。このオプションは複数回渡すことができます。構文: regex_filter@option_1,option_2,...,option_nregex_filter は、包含および除外する正規表現パターンのリストを表します(--instrumentation_filter も参照)。option_1 から option_n は任意のコマンドライン オプションを表します。オプションにカンマが含まれる場合は、バックスラッシュで囲む必要があります。オプションには @ を含めることができます。文字列の分割には最初の @ のみが使用されます。例: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 は、//foo/ 内に存在する bar.cc を除くすべての cc ファイルの gcc コマンドラインに、-O0 コマンドライン オプションを追加します。
タグ:action_command_lines
、affects_outputs
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
件の複数回の使用が累積される-
特定のバックエンド オブジェクトをコンパイルするときに、選択的に LTO バックエンド(--features=thin_lto の下)に渡す追加のオプション。このオプションは複数回渡すことができます。構文: regex_filter@option_1,option_2,...,option_nregex_filter は、包含および除外する正規表現パターンのリストです。option_1 から option_n は任意のコマンドライン オプションを表します。オプションにカンマが含まれる場合は、バックスラッシュで囲む必要があります。オプションには @ を含めることができます。文字列の分割には最初の @ のみが使用されます。例: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 は、//foo/ 内の、bar.o を除くすべての o ファイルの LTO バックエンド コマンドラインに -O0 コマンドライン オプションを追加します。
タグ:action_command_lines
、affects_outputs
--platform_suffix=<a string>
デフォルト: 説明を参照-
構成ディレクトリに追加する接尾辞を指定します。
タグ:loses_incremental_state
、affects_outputs
、loading_and_analysis
--propeller_optimize=<a build target label>
デフォルト: 説明を参照-
Propeller プロファイル情報を使用して、ビルド ターゲットを最適化します。Propeller プロファイルは、cc プロファイルと ld プロファイルの 2 つのファイルのうち少なくとも 1 つで構成されている必要があります。このフラグには、Propeller プロファイルの入力ファイルを参照する必要があるビルドラベルを指定します。たとえば、ラベルを定義する BUILD ファイル(a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",) )を Bazel の場合、対応するパッケージに Bazel ディレクティブを追加してこれらのファイルを表示する必要があります。このオプションは次のように使用する必要があります: --propeller_optimize=//a/b:propeller_profile
タグ:action_command_lines
、affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
デフォルト: 説明を参照-
Propeller Optimized ビルドの cc_profile ファイルのパスの絶対パス名。
タグ:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
デフォルト: 説明を参照-
Propeller Optimized ビルドの ld_profile ファイルの絶対パス名。
タグ:affects_outputs
--run_under=<a prefix in front of command>
デフォルト: 説明を参照-
「test」コマンドと「run」コマンドの実行可能ファイルの前に挿入する接頭辞。値が「foo -bar」で、実行コマンドラインが「test_binary -baz」の場合、最後のコマンドラインは「foo -bar test_binary -baz」になります。これは、実行可能ターゲットのラベルにすることもできます。たとえば、「valgrind」、「strace」、「strace -c」、「valgrind --quiet --num-callers=20」、「//package:target」、「//package:target --options」などが挙げられます。
タグ:action_command_lines
-
true の場合、同じ機能を含むネイティブ ライブラリが、異なるターゲット間で共有されます
タグ:loading_and_analysis
、affects_outputs
--[no]stamp
デフォルト: 「false」-
日付、ユーザー名、ホスト名、ワークスペース情報などでバイナリをスタンプします。
タグ:affects_outputs
--strip=<always, sometimes or never>
(デフォルト): 「時々」-
バイナリと共有ライブラリを除去するかどうかを指定します(「-Wl,--strip-debug」を使用)。デフォルト値の「sometimes」は、--compile_mode=fastbuild の場合を除いて削除されます。
タグ:affects_outputs
--stripopt=<a string>
件の複数回の使用が累積される-
「<name>.stripped」バイナリを生成する際にストリップに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--swiftcopt=<a string>
件の複数回の使用が累積される-
Swift コンパイルに渡す追加オプションです。
タグ:action_command_lines
--tvos_cpus=<comma-separated list of options>
件の複数回の使用が累積される- Apple tvOS バイナリをビルドするためのアーキテクチャのカンマ区切りリスト。
タグ:loses_incremental_state
、loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
ターゲット シミュレータとデバイスに対応する最小の tvOS バージョン。指定しない場合は「tvos_sdk_version」を使用します。
タグ:loses_incremental_state
--visionos_cpus=<comma-separated list of options>
件の複数回の使用が累積される- Apple VisionOS バイナリをビルドするためのアーキテクチャのカンマ区切りリスト。
タグ:loses_incremental_state
、loading_and_analysis
--watchos_cpus=<comma-separated list of options>
件の複数回の使用が累積される- Apple watchOS バイナリをビルドするためのアーキテクチャのカンマ区切りリスト。
タグ:loses_incremental_state
、loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
ターゲット シミュレータとデバイスに対応する最小互換の watchOS バージョン。指定しない場合は、「watchos_sdk_version」を使用します。
タグ:loses_incremental_state
--xbinary_fdo=<a build target label>
デフォルト: 説明を参照-
XbinaryFDO プロファイル情報を使用してコンパイルを最適化します。デフォルトのクロスバイナリ プロファイルの名前を指定します。このオプションを --fdo_instrument/--fdo_optimize/--fdo_profile とともに使用すると、xbinary_fdo が指定されていない場合と同じように常にこれらのオプションが優先されます。
タグ:affects_outputs
- Bazel が有効なビルド入力を厳密に適用するかどうかに影響するオプション(ルール定義、フラグの組み合わせなど):
--auto_cpu_environment_group=<a build target label>
のデフォルト: ""-
CPU 値を target_environment 値に自動的にマッピングするために使用する environment_group を宣言します。
タグ:changes_inputs
、loading_and_analysis
、experimental
--[no]check_licenses
デフォルト: 「false」-
依存パッケージによって課されるライセンスの制約が、ビルドされるターゲットの配布モードと競合していないことを確認します。デフォルトでは、ライセンスはオンになっています。
タグ:build_file_semantics
--[no]check_visibility
のデフォルト: 「true」-
無効にすると、ターゲット依存関係のエラーが警告に降格されます。
タグ:build_file_semantics
--[no]desugar_for_android
のデフォルト: 「true」-
dex 変換する前に Java 8 バイトコードを脱糖するかどうか。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--[no]desugar_java8_libs
デフォルト: 「false」-
レガシー デバイスのアプリにサポートされている Java 8 ライブラリを含めるかどうかを指定します。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--[no]enforce_constraints
のデフォルト: 「true」-
各ターゲットと互換性がある環境を確認し、同じ環境をサポートしていない依存関係がターゲットに含まれている場合はエラーを報告します。
タグ:build_file_semantics
--[no]experimental_check_desugar_deps
のデフォルト: 「true」-
Android バイナリレベルで正しい脱糖を再チェックするかどうか。
タグ:eagerness_to_exit
、loading_and_analysis
、experimental
--experimental_import_deps_checking=<off, warning or error>
のデフォルト: 「オフ」-
有効にすると、aar_import の依存関係が完全かどうかを確認します。この適用により、ビルドが中断するだけでなく、警告が表示される場合もあります。
タグ:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
デフォルト: 「default」-
true の場合、Java ターゲットで直接使用されるすべてのターゲットが依存関係として明示的に宣言されていることを確認します。
タグ:build_file_semantics
、eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
デフォルト: 「false」-
有効にすると、生成ルールの testonly を検索して、出力ファイルである前提条件のターゲットを testonly としてチェックします。これは可視性チェックと一致します。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_check_visibility_for_toolchains
デフォルト: 「false」-
有効にすると、可視性チェックはツールチェーンの実装にも適用されます。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_disable_native_android_rules
デフォルト: 「false」-
有効にすると、Android のネイティブ ルールの直接使用が無効になります。https://github.com/bazelbuild/rules_android にある Starlark Android ルールを使用してください
タグ:eagerness_to_exit
、incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
デフォルト: 「false」-
処理なし。下位互換性のためにここに保持します。
タグ:eagerness_to_exit
、incompatible_change
--[no]incompatible_python_disable_py2
のデフォルト: 「true」-
true の場合、Python 2 の設定を使用するとエラーが発生します。これには python_version=PY2、srcs_version=PY2、および srcs_version=PY2ONLY が含まれます。詳しくは、https://github.com/bazelbuild/bazel/issues/15684 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
のデフォルト: 「true」-
true の場合、Bazel はトップレベルのディレクトリ ヘッダーの包含も検証します(詳しくは、https://github.com/bazelbuild/bazel/issues/10047 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--python_native_rules_allowlist=<a build target label>
デフォルト: 説明を参照-
--compatible_python_disallow_native_rules を適用する際に使用する許可リスト(package_group ターゲット)。
タグ:loading_and_analysis
--[no]strict_filesets
デフォルト: 「false」-
このオプションを有効にすると、パッケージの境界を超えるファイルセットがエラーとして報告されます。
タグ:build_file_semantics
、eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
デフォルト: "error"-
OFF の場合を除き、proto_library ターゲットが、直接使用されるすべてのターゲットを依存関係として明示的に宣言していることを確認します。
タグ:build_file_semantics
、eagerness_to_exit
、incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
のデフォルト: 「off」-
OFF の場合を除き、proto_library ターゲットが、「import public」で使用されるすべてのターゲットを、エクスポート済みとして明示的に宣言していることを確認します。
タグ:build_file_semantics
、eagerness_to_exit
、incompatible_change
--[no]strict_system_includes
デフォルト: 「false」-
true の場合、システムのインクルード パス(-isystem)で検出されたヘッダーも宣言する必要があります。
タグ:loading_and_analysis
、eagerness_to_exit
--target_environment=<a build target label>
件の複数回の使用が累積される-
このビルドのターゲット環境を宣言します。「環境」ルールへのラベル参照にする必要があります。指定する場合、すべてのトップレベル ターゲットはこの環境と互換性を持つ必要があります。
タグ:changes_inputs
- ビルドの署名出力に影響するオプション:
--apk_signing_method=<v1, v2, v1_v2 or v4>
のデフォルト: 「v1_v2」-
APK の署名に使用する実装
タグ:action_command_lines
、affects_outputs
、loading_and_analysis
--[no]device_debug_entitlements
のデフォルト: 「true」-
設定されていて、コンパイル モードが「opt」でない場合、objc アプリは署名時にデバッグ利用資格を含めます。
タグ:changes_inputs
--ios_signing_cert_name=<a string>
デフォルト: 説明を参照-
iOS 署名に使用する証明書の名前。設定されていない場合、プロビジョニング プロファイルにフォールバックします。証明書のキーチェーン ID 設定、またはコードサインのマニュアル ページ(署名 ID)に基づく証明書の共通名(部分文字列)の場合もあります。
タグ:action_command_lines
- このオプションは、BUILD ファイル、.bzl ファイル、WORKSPACE ファイルからアクセス可能な Starlark 言語または Build API のセマンティクスに影響します。
--[no]incompatible_disallow_legacy_py_provider
のデフォルト: 「true」-
No-op、まもなく削除されます。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
デフォルト: 「false」-
true の場合、objc_library と objc_import の sdk_frameworks 属性と weak_sdk_frameworks の属性を禁止します。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_objc_alwayslink_by_default
デフォルト: 「false」-
true の場合、objc_library と objc_import の alwayslink 属性のデフォルト値を true にします。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_python_disallow_native_rules
デフォルト: 「false」-
true の場合、組み込みの py_* ルールの使用時にエラーが発生します。代わりに rule_python ルールを使用する必要があります。詳細と移行手順については、https://github.com/bazelbuild/bazel/issues/17773 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
- テスト環境またはテストランナーの動作を制御するオプション:
--[no]allow_analysis_failures
デフォルト: 「false」-
true の場合、ルール ターゲットの分析が失敗すると、ビルドは失敗するのではなく、エラーの説明を含む AnalysisFailureInfo のインスタンスが伝播されます。
タグ:loading_and_analysis
、experimental
--analysis_testing_deps_limit=<an integer>
デフォルト: 「2000」-
for_analysis_testing 構成の移行に関するルール属性を介して、推移的依存関係の最大数を設定します。この上限を超えると、ルールエラーが発生します。
タグ:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
デフォルト: 「false」-
真の dex2oat アクションが失敗すると、テスト実行時に dex2oat を実行する代わりにビルドが中断されます。
タグ:loading_and_analysis
、experimental
--[no]experimental_android_use_parallel_dex2oat
デフォルト: 「false」-
dex2oat を並行して使用すると、android_test が高速化される場合があります。
タグ:loading_and_analysis
、host_machine_resource_optimizations
、experimental
--[no]ios_memleaks
デフォルト: 「false」-
ios_test ターゲットでのメモリリークのチェックを有効化。
タグ:action_command_lines
--ios_simulator_device=<a string>
デフォルト: 説明を参照-
シミュレータで iOS アプリを実行するときにシミュレートするデバイス(例: iPhone 6)。シミュレータが実行されるマシンで「xcrun simctl list devicetypes」を実行すると、デバイスのリストを取得できます。
タグ:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
実行またはテストの際にシミュレータで実行する iOS のバージョン。対象デバイスがルールで指定されている場合、ios_test ルールでは無視されます。
タグ:test_runner
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
件の複数回の使用が累積される- 各テストを実行する回数を指定します。いずれかの試行がなんらかの理由で不合格になった場合は、テスト全体が不合格と見なされます。通常、指定される値は整数のみです。例: --runs_per_test=3 と指定すると、すべてのテストが 3 回実行されます。別の構文: regex_filter@runs_per_testrun_per_test は整数値、regex_filter は正規表現パターンのリストです(--instrumentation_filter も参照)。例: --runs_per_test=//foo/.*,-//foo/bar/.*@3 を指定すると、//foo/ 内のテストのうち、foo/bar の下にあるものを除くすべてのテストを 3 回実行します。このオプションは複数回渡すことができます。最後に渡された引数のうち、一致したものが優先されます。一致するものがない場合、テストは 1 回だけ実行されます。
--test_env=<a 'name=value' assignment with an optional value part>
件の複数回の使用が累積される-
テストランナー環境に挿入する追加の環境変数を指定します。変数は名前で指定できます。この場合、値は Bazel クライアント環境から読み取られます。また、name=value のペアで指定することもできます。このオプションを複数回使用して、複数の変数を指定できます。「bazel test」コマンドでのみ使用されます。
タグ:test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
デフォルト: 「-1」- テストのタイムアウトのデフォルトのテスト タイムアウト値(秒単位)をオーバーライドします。正の整数値を 1 つだけ指定すると、すべてのカテゴリがオーバーライドされます。4 つのカンマ区切りの整数を指定すると、short、Moderate、long、eternal のタイムアウトが(この順序で)オーバーライドされます。どちらの形式でも、値を -1 にすると、そのカテゴリに対してデフォルトのタイムアウトを使用するように Blaze に指示します。
--[no]zip_undeclared_test_outputs
のデフォルト: 「true」-
true の場合、宣言されていないテスト出力が zip ファイルにアーカイブされます。
タグ:test_runner
- クエリの出力とセマンティクスに関連するオプション:
--aspect_deps=<off, conservative or precise>
のデフォルト: "conservative"-
出力形式が {xml,proto,record} のいずれかの場合に、アスペクトの依存関係を解決する方法。「off」は、アスペクトの依存関係が解決されないことを意味します。「conservative」(デフォルト)は、宣言されたすべてのアスペクト依存関係が、直接的な依存関係のルールクラスが与えられるかどうかにかかわらず、追加されることを意味します。「正確」は、直接的な依存関係のルールクラスが与えられている可能性のあるアスペクトのみが追加されることを意味します。高精度モードでは、1 つのターゲットを評価するために他のパッケージを読み込む必要があるため、他のモードよりも遅くなります。また、精密モードであっても完全に正確というわけではありません。アスペクトを計算するかどうかは、分析フェーズで決定され、bazel クエリでは実行されません。
タグ:build_file_semantics
--[no]consistent_labels
デフォルト: 「false」-
有効にすると、すべてのクエリコマンドは、<code>Label</code> インスタンスに適用された Starlark <code>str</code> 関数であるかのようにラベルを出力します。これは、さまざまなクエリ コマンドの出力やルールによって発行されたラベルを照合する必要があるツールに便利です。有効になっていない場合、出力フォーマッタは、出力を読みやすくするために、明らかなリポジトリ名(メイン リポジトリからの相対名)を自由に出力できます。
タグ:terminal_output
--[no]graph:factored
のデフォルト: 「true」-
true の場合、グラフは「因数分解された」状態で出力されます。つまり、トポロジ的に同等のノードがマージされ、それらのラベルが連結されます。このオプションは --output=graph にのみ適用されます。
タグ:terminal_output
--graph:node_limit=<an integer>
のデフォルト: 「512」-
出力内のグラフノードのラベル文字列の最大長。長いラベルは切り捨てられます。-1 を指定すると、切り捨てられません。このオプションは --output=graph にのみ適用されます。
タグ:terminal_output
--[no]implicit_deps
のデフォルト: 「true」-
有効にすると、クエリが実行される依存関係グラフに暗黙的な依存関係が含まれます。暗黙的な依存関係とは、BUILD ファイルで明示的に指定されていないものの、bazel によって追加された依存関係のことです。cquery の場合、解決されたツールチェーンのフィルタリングを制御します。
タグ:build_file_semantics
--[no]include_artifacts
のデフォルト: 「true」-
出力内のアクション入力と出力の名前を含みます(サイズが大きい可能性があります)。
タグ:terminal_output
--[no]include_aspects
のデフォルト: 「true」-
aquery、cquery: アスペクトによって生成されたアクションを出力に含めるかどうか。query: no-op(アスペクトは常に追跡されます)。
タグ:terminal_output
--[no]include_commandline
のデフォルト: 「true」-
出力にアクション コマンドラインの内容が含まれます(サイズが大きくなる場合もあります)。
タグ:terminal_output
--[no]include_file_write_contents
デフォルト: 「false」-
FileWrite、SourceSymlinkManifest、RepoMappingManifest の各アクションのファイル コンテンツを含めます(サイズが大きくなる場合もあります)。
タグ:terminal_output
--[no]include_param_files
デフォルト: 「false」-
コマンドで使用されるパラメータ ファイルの内容を含めます(サイズが大きくなる場合もあります)。注: このフラグを有効にすると、--include_commandline フラグが自動的に有効になります。
タグ:terminal_output
--[no]incompatible_package_group_includes_double_slash
のデフォルト: 「true」-
有効にすると、package_group の「packages」属性を出力するときに、先頭の「//」は省略されません。
タグ:terminal_output
、incompatible_change
--[no]infer_universe_scope
デフォルト: 「false」-
設定されていて、--universe_scope が設定されていない場合、--universe_scope の値は、クエリ式内の一意のターゲット パターンのリストとして推定されます。ユニバース スコープの関数(allrdeps など)を使用するクエリ式で推測される --universe_scope の値は、望ましくない可能性があるので、実行する処理がわかっている場合にのみ、このオプションを使用してください。詳細と例については、https://bazel.build/reference/query#sky-query をご覧ください。--universe_scope が設定されている場合、このオプションの値は無視されます。注: このオプションは「query」にのみ適用されます(つまり、「cquery」には適用されません)。
タグ:loading_and_analysis
--[no]line_terminator_null
デフォルト: 「false」-
各形式が改行ではなく \0 で終了しているかどうか。
タグ:terminal_output
--[no]nodep_deps
のデフォルト: 「true」-
有効にすると、"nodep" 属性からの依存関係が、クエリを操作する依存関係グラフに含まれます。「nodep」属性の一般的な例としては、「visibility」があります。「info build-language」の出力を実行して解析し、ビルド言語のすべての「nodep」属性を確認します。
タグ:build_file_semantics
--output=<a string>
のデフォルト: "text"-
クエリの結果を表示する形式。クエリで使用できる値は、text、textproto、proto、streamed_proto、jsonproto です。
タグ:terminal_output
--[no]proto:default_values
のデフォルト: 「true」-
true の場合、BUILD ファイルで値が明示的に指定されていない属性が含まれます。それ以外の場合は省略されます。このオプションは --output=proto に適用されます。
タグ:terminal_output
--[no]proto:definition_stack
デフォルト: 「false」-
Definition_stack proto フィールドに、ルールのクラスが定義された時点の Starlark コールスタックをルール インスタンスごとに記録します。
タグ:terminal_output
--[no]proto:flatten_selects
のデフォルト: 「true」-
有効にすると、select() によって作成された構成可能な属性がフラット化されます。リストタイプの場合、フラット表現は、セレクトマップの各値を 1 回だけ含むリストです。スカラー型は null にフラット化されます。
タグ:build_file_semantics
--[no]proto:include_attribute_source_aspects
デフォルト: 「false」-
各属性の source_aspect_name proto フィールドに、属性の取得元であるソースのアスペクトを入力します(そうでない場合は空の文字列)。
タグ:terminal_output
--[no]proto:include_synthetic_attribute_hash
デフォルト: 「false」- $internal_attr_hash 属性を計算して入力するかどうかを指定します。
タグ:terminal_output
--[no]proto:instantiation_stack
デフォルト: 「false」-
各ルールのインスタンス化コールスタックにデータを入力します。これを行うには、スタックが存在する必要があります。
タグ:terminal_output
--[no]proto:locations
のデフォルト: 「true」-
proto 出力で位置情報を出力するかどうか。
タグ:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
のデフォルト: 「all」-
出力に含める属性のカンマ区切りリスト。デフォルトはすべての属性です。属性を出力しない場合は、空の文字列に設定します。このオプションは --output=proto に適用できます。
タグ:terminal_output
--[no]proto:rule_inputs_and_outputs
のデフォルト: 「true」-
rule_input と rule_output の各フィールドにデータを入力するかどうかを指定します。
タグ:terminal_output
--query_file=<a string>
のデフォルト: ""-
設定すると、クエリはコマンドラインではなく、ここで指定したファイルからクエリを読み取ります。ここでファイルを指定してコマンドライン クエリを指定するとエラーになります。
タグ:changes_inputs
--[no]relative_locations
デフォルト: 「false」-
true の場合、xml 出力と proto 出力での BUILD ファイルの場所は相対的になります。デフォルトでは、場所の出力は絶対パスであり、マシン間で一貫していません。このオプションを true に設定すると、マシン全体で一貫した結果が得られます。
タグ:terminal_output
--[no]skyframe_state
デフォルト: 「false」-
追加分析を行わずに、現在のアクション グラフを Skyframe からダンプします。注: 現時点では、--skyframe_state でターゲットを指定することはサポートされていません。このフラグは、--output=proto または --output=textproto でのみ使用できます。
タグ:terminal_output
--[no]tool_deps
のデフォルト: 「true」-
クエリ: 無効にすると、クエリの実行対象となる依存関係グラフに「実行構成」の依存関係は含まれません。「proto_library」ルールから Protocol Compiler までの「exec 構成」依存関係エッジは通常、同じ「ターゲット」プログラムの一部ではなく、ビルド中に実行されたツールを指します。
Cquery: 無効にすると、この構成済みターゲットを検出した最上位ターゲットから実行移行を通過する構成済みターゲットがすべて除外されます。つまり、最上位のターゲットがターゲット構成に含まれている場合は、そのターゲット構成にも構成済みのターゲットのみが返されます。最上位のターゲットが exec 構成に含まれている場合は、exec 構成のターゲットのみが返されます。このオプションは、解決済みのツールチェーンを除外しません。
タグ:build_file_semantics
--universe_scope=<comma-separated list of options>
のデフォルト: ""-
カンマ区切りのターゲット パターンのセット(加法と減算)。クエリは、指定されたターゲットの推移的クロージャで定義されたユニバースで実行できます。このオプションは、query コマンドと cquery コマンドで使用されます。cquery の場合、このオプションに入力する値はすべての回答がビルドされるターゲットとなるため、このオプションは構成や遷移に影響する可能性があります。このオプションが指定されていない場合、トップレベル ターゲットはクエリ式から解析されたターゲットと見なされます。注: cquery でこのオプションを指定しないと、クエリ式から解析されたターゲットがトップレベル オプションでビルドできない場合、ビルドが中断されることがあります。
タグ:loading_and_analysis
- ビルド時間の最適化をトリガーするオプション:
--[no]experimental_filter_library_jar_with_program_jar
デフォルト: 「false」-
ProGuard ProgramJar をフィルタリングして、LibraryJar にも存在するクラスを削除します。
タグ:action_command_lines
--[no]experimental_inmemory_dotd_files
のデフォルト: 「true」-
有効にすると、C++ .d ファイルはディスクに書き込むのではなく、リモートビルドノードから直接メモリ内に渡されます。
タグ:loading_and_analysis
、execution
、affects_outputs
、experimental
--[no]experimental_inmemory_jdeps_files
のデフォルト: 「true」-
有効にすると、Java コンパイルで生成された依存関係(.jdeps)ファイルは、ディスクに書き込まれるのではなく、リモートビルドノードから直接メモリ内に渡されます。
タグ:loading_and_analysis
、execution
、affects_outputs
、experimental
--[no]experimental_objc_include_scanning
デフォルト: 「false」-
目的の C/C++ のスキャンを実行するかどうか。
タグ:loading_and_analysis
、execution
、changes_inputs
--[no]experimental_retain_test_configuration_across_testonly
デフォルト: 「false」-
有効にすると、--trim_test_configuration は testonly=1 とマークされたルールのテスト構成をトリミングしません。これは、テスト以外のルールが cc_test ルールに依存している場合のアクションの競合の問題を軽減するためです。--trim_test_configuration が false の場合は効果はありません。
タグ:loading_and_analysis
、loses_incremental_state
--[no]experimental_starlark_cc_import
デフォルト: 「false」-
有効にすると、Starlark バージョンの cc_import を使用できます。
タグ:loading_and_analysis
、experimental
--[no]experimental_unsupported_and_brittle_include_scanning
デフォルト: 「false」-
入力ファイルの #include 行を解析して入力を C/C++ コンパイルに絞り込むかどうかを指定します。これにより、コンパイルの入力ツリーのサイズを縮小することで、パフォーマンスとインクリメンタリティを改善できます。ただし、インクルード スキャナは C プリプロセッサのセマンティクスを完全に実装していないため、ビルドが中断される可能性があります。特に、動的な #include ディレクティブは認識されず、プリプロセッサの条件付きロジックは無視されます。自己責任で使用してください。このフラグに関して報告された問題はクローズされます。
タグ:loading_and_analysis
、execution
、changes_inputs
--[no]incremental_dexing
のデフォルト: 「true」-
dex 変換のほとんどの作業は、Jar ファイルごとに個別に行います。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--[no]objc_use_dotd_pruning
のデフォルト: 「true」-
設定すると、clang が出力した .d ファイルが、objc コンパイルに渡される入力のセットをプルーニングするために使用されます。
タグ:changes_inputs
、loading_and_analysis
--[no]process_headers_in_dependencies
デフォルト: 「false」-
ターゲット //a:a をビルドする際、//a:a が依存するすべてのターゲットのヘッダーを処理します(ツールチェーンでヘッダー処理が有効になっている場合)。
タグ:execution
--[no]trim_test_configuration
のデフォルト: 「true」-
有効にすると、ビルドのトップレベルの下にあるテスト関連のオプションがクリアされます。このフラグを有効にすると、テスト以外のルールの依存関係としてテストをビルドすることはできませんが、テスト関連のオプションを変更してもテスト以外のルールが再分析されることはありません。
タグ:loading_and_analysis
、loses_incremental_state
- ロギングの詳細度、形式、場所に影響するオプション:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
のデフォルト: "-.*"-
ツールチェーンの解決時にデバッグ情報を出力します。このフラグは正規表現を使用します。正規表現は、デバッグ対象を確認するためにツールチェーン タイプおよび特定のターゲットと照合されます。複数の正規表現をコンマで区切ると、それぞれの正規表現が個別にチェックされます。注: このフラグの出力は非常に複雑で、ツールチェーンの解決に携わる専門家にのみ役立つ可能性があります。
タグ:terminal_output
- 他のカテゴリに当てはまらない Bazel コマンドへの汎用入力を指定または変更するオプション。
--flag_alias=<a 'name=value' flag alias>
件の複数回の使用が累積される-
Starlark フラグの省略名を設定します。引数として「<key>=<value>」形式の 1 つの Key-Value ペアを取ります。
タグ:changes_inputs
--[no]incompatible_default_to_explicit_init_py
デフォルト: 「false」-
このフラグはデフォルトの動作を変更し、Python ターゲットの実行ファイルで __init__.py ファイルが自動的に作成されなくなります。正確には、py_binary または py_test のターゲットで legacy_create_init が「auto」(デフォルト)に設定されている場合、このフラグが設定されている場合にのみ false として扱われます。https://github.com/bazelbuild/bazel/issues/10076 をご覧ください。
タグ:affects_outputs
、incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
のデフォルト: 「true」-
true の場合、Python 2 の構成でビルドされたターゲットは、接尾辞「-py2」を含む出力ルートの下に表示されます。Python 3 用にビルドされたターゲットは、Python 関連の接尾辞がないルートに表示されます。つまり、「bazel-bin」という便利なシンボリック リンクが、Python 2 ではなく Python 3 のターゲットを指すようになります。このオプションを有効にする場合は、「--compatible_py3_is_default」も有効にすることをおすすめします。
タグ:affects_outputs
、incompatible_change
--[no]incompatible_py3_is_default
のデフォルト: 「true」-
true の場合、「python_version」(または「default_python_version」)属性が設定されていない「py_binary」および「py_test」ターゲットはデフォルトで PY2 ではなく PY3 に設定されます。このフラグを設定する場合は、「--compatible_py2_outputs_are_suffixed」も設定することをおすすめします。
タグ:loading_and_analysis
、affects_outputs
、incompatible_change
--[no]incompatible_use_python_toolchains
のデフォルト: 「true」-
true に設定すると、実行可能なネイティブ Python ルールは、以前のフラグ(--python_top など)で指定されたランタイムではなく、Python ツールチェーンで指定された Python ランタイムを使用します。
タグ:loading_and_analysis
、incompatible_change
--python_version=<PY2 or PY3>
デフォルト: 説明を参照-
Python メジャー バージョン モードです。「PY2」または「PY3」のいずれかです。これは、(バージョンを明示的に指定していなくても)「py_binary」および「py_test」のターゲットによってオーバーライドされるため、このフラグを指定する理由は通常あまりありません。
タグ:loading_and_analysis
、affects_outputs
- その他のオプション(特に分類されていないもの):
--[no]cache_test_results
[-t
] default: "auto"- 「auto」に設定すると、次の場合にのみ、Bazel がテストを再実行します。(1)Bazel がテストまたはその依存関係の変更を検出した、(2)テストが外部としてマークされている、(3)--runs_per_test で複数のテスト実行がリクエストされた、(4)以前にテストが失敗した。「yes」に設定すると、Bazel は外部としてマークされたテストを除くすべてのテスト結果をキャッシュに保存します。「no」に設定した場合、Bazel はテスト結果をキャッシュに保存しません。
--[no]experimental_cancel_concurrent_tests
デフォルト: 「false」-
true の場合、Blaze は最初に成功した実行時に、同時に実行されているテストをキャンセルします。これは、--runs_per_test_detects_flakes と組み合わせた場合にのみ有用です。
タグ:affects_outputs
、loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
デフォルト: 「false」-
true の場合、Bazel はカバレッジの実行中に、各テストでカバレッジ データ ディレクトリ全体を取得します。
タグ:affects_outputs
、loading_and_analysis
--[no]experimental_generate_llvm_lcov
デフォルト: 「false」-
true の場合、clang のカバレッジにより LCOV レポートが生成されます。
タグ:affects_outputs
、loading_and_analysis
--[no]experimental_j2objc_header_map
のデフォルト: 「true」- J2ObjC のトランスパイルと並行して J2ObjC ヘッダーマップを生成するかどうかを指定します。
--[no]experimental_j2objc_shorter_header_path
デフォルト: 「false」-
短いヘッダーパスで生成するかどうか(_j2objc ではなく _ios を使用します)。
タグ:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
のデフォルト: 「javabuilder」- Java コンパイルのクラスパスを削減できます。
--[no]experimental_limit_android_lint_to_android_constrained_java
デフォルト: 「false」-
--experimental_run_android_lint_on_java_rules を Android 互換ライブラリに制限します。
タグ:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
デフォルト: 「false」-
java_* ソースを検証するかどうかを指定します。
タグ:affects_outputs
--[no]explicit_java_test_deps
デフォルト: 「false」- TestRunner の依存関係を誤って取得するのではなく、java_test で JUnit または Hamcrest への依存関係を明示的に指定します。現在は bazel でのみ機能します。
--host_java_launcher=<a build target label>
デフォルト: 説明を参照- ビルド時に実行されるツールで使用される Java ランチャー。
--host_javacopt=<a string>
件の複数回の使用が累積される- ビルドで実行されるツールをビルドするときに javac に渡す追加オプション。
--host_jvmopt=<a string>
件の複数回の使用が累積される- ビルド時に実行されるツールをビルドするときに Java VM に渡す追加のオプション。これらのオプションは、各 java_binary ターゲットの VM 起動オプションに追加されます。
--[no]incompatible_check_sharding_support
のデフォルト: 「true」-
true の場合、テストランナーが TEST_SHARD_STATUS_FILE のパスにあるファイルをタップしてシャーディングをサポートしていることを示していない場合、Bazel はシャーディングされたテストに失敗します。false の場合、シャーディングをサポートしていないテストランナーによって、各シャードですべてのテストが実行されます。
タグ:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
のデフォルト: 「true」-
true の場合、サンドボックス化された戦略で排他的なテストが実行されます。排他的なテストをローカルで強制的に実行するには、「local」タグを追加します。
タグ:incompatible_change
--[no]incompatible_strict_action_env
デフォルト: 「false」-
true の場合、Bazel は PATH に静的な値を持つ環境を使用し、LD_LIBRARY_PATH を継承しません。クライアントから特定の環境変数を継承する場合は --action_env=ENV_VARIABLE を使用しますが、共有キャッシュを使用している場合に共有すると、ユーザー間のキャッシュ保存が妨げられる可能性があります。
タグ:loading_and_analysis
、incompatible_change
--j2objc_translation_flags=<comma-separated list of options>
件の複数回の使用が累積される- J2ObjC ツールに渡す追加オプション。
--java_debug
-
Java テストの Java 仮想マシンで、JDWP 準拠のデバッガ(jdb など)からの接続を待ってからテストを開始します。-test_output=streamed を意味します。
拡張後:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
のデフォルト: 「true」- Java ターゲットごとに依存関係情報を生成します(現時点ではコンパイル時クラスパス)。
--[no]java_header_compilation
のデフォルト: 「true」- ソースから直接 ijar をコンパイルします。
--java_language_version=<a string>
のデフォルト: ""- Java 言語バージョン
--java_launcher=<a build target label>
デフォルト: 説明を参照- Java バイナリをビルドするときに使用する Java ランチャー。このフラグを空の文字列に設定すると、JDK ランチャーが使用されます。「launcher」属性はこのフラグをオーバーライドします。
--java_runtime_version=<a string>
のデフォルト: 「local_jdk」- Java ランタイム バージョン
--javacopt=<a string>
件の複数回の使用が累積される- javac に渡す追加オプション。
--jvmopt=<a string>
件の複数回の使用が累積される- Java VM に渡す追加オプション。これらのオプションは、各 java_binary ターゲットの VM 起動オプションに追加されます。
--legacy_main_dex_list_generator=<a build target label>
デフォルト: 説明を参照- 以前の Multidex をコンパイルする際にメイン dex に含める必要があるクラスのリストを生成するために使用するバイナリを指定します。
--optimizing_dexer=<a build target label>
デフォルト: 説明を参照- シャーディングなしの dex 変換に使用するバイナリを指定します。
--plugin=<a build target label>
件の複数回の使用が累積される- ビルドで使用するプラグイン。現在は java_plugin で機能します。
--proguard_top=<a build target label>
デフォルト: 説明を参照- Java バイナリをビルドするときにコードの削除に使用する ProGuard のバージョンを指定します。
--proto_compiler=<a build target label>
デフォルト: "@bazel_tools//tools/proto:protoc"-
プロトコル コンパイラのラベル。
タグ:affects_outputs
、loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
のデフォルト: "@bazel_tools//tools/proto:cc_chain"-
C++ proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル
タグ:affects_outputs
、loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
のデフォルト: "@bazel_tools//tools/j2objc:j2objc_proto_ツールチェーン"-
j2objc proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル
タグ:affects_outputs
、loading_and_analysis
--proto_toolchain_for_java=<a build target label>
のデフォルト: "@bazel_tools//tools/proto:java_ツールチェーン"-
Java proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル
タグ:affects_outputs
、loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
デフォルト: "@bazel_tools//tools/proto:javalite_ツールチェーン"-
JavaLite proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル
タグ:affects_outputs
、loading_and_analysis
--protocopt=<a string>
件の複数回の使用が累積される-
protobuf コンパイラに渡す追加オプション。
タグ:affects_outputs
--[no]runs_per_test_detects_flakes
デフォルト: 「false」- true の場合、1 つ以上の実行/試行が成功し、1 つ以上の実行/試行が失敗したシャードは、FLAKY ステータスになります。
--shell_executable=<a path>
デフォルト: 説明を参照-
Bazel が使用するシェル実行可能ファイルへの絶対パス。未設定で、最初の Bazel 呼び出し(Bazel サーバーを起動する)で BAZEL_SH 環境変数が設定されていると、Bazel ではその値が使用されます。どちらも設定されていない場合、Bazel は実行されているオペレーティング システムに応じてハードコードされたデフォルト パスを使用します(Windows: c:/tools/msys64/usr/bin/bash.exe、FreeBSD: /usr/local/bin/bash、その他: /bin/bash)。bash と互換性のないシェルを使用すると、生成されたバイナリのビルドエラーやランタイム エラーが発生する可能性があります。
タグ:loading_and_analysis
--test_arg=<a string>
件の複数回の使用が累積される- テスト実行可能ファイルに渡す必要がある追加のオプションと引数を指定します。複数回使用して、複数の引数を指定できます。複数のテストが実行される場合、それぞれは同じ引数を受け取ります。「bazel test」コマンドでのみ使用されます。
--test_filter=<a string>
デフォルト: 説明を参照- テスト フレームワークに転送するフィルタを指定します。実行するテストを制限するために使用します。これは、ビルドされるターゲットには影響しません。
--test_result_expiration=<an integer>
デフォルト: 「-1」- このオプションは非推奨であり、機能しません。
--[no]test_runner_fail_fast
デフォルト: 「false」- テストランナーにフェイル ファスト オプションを転送する。テストランナーは、最初の失敗時に実行を停止する必要があります。
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
のデフォルト: "explicit"- テストのシャーディング戦略を指定します。「shard_count」の BUILD 属性が存在する場合にのみシャーディングを使用するには、「明示的」を指定します。テストのシャーディングを使用しない場合。「シャード_count」の BUILD 属性に関係なく「k」シャードをテストに強制適用する「forced=k」。
--tool_java_language_version=<a string>
のデフォルト: ""- ビルドで必要なツールの実行に使用される Java 言語のバージョン
--tool_java_runtime_version=<a string>
のデフォルト: "remotejdk_11"- ビルド中にツールを実行するために使用される Java ランタイム バージョン
--[no]use_ijars
のデフォルト: 「true」- 有効にすると、Java コンパイルでインターフェース JAR が使用されます。増分コンパイルは高速になりますが、エラー メッセージが異なる場合があります。
ビルド オプション
- コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path>
件の複数回の使用が累積される-
ネットワークにアクセスしてダウンロードする前に、アーカイブを検索できる場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
デフォルト: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュでファイルがコピーされずにハードリンクされます。これはディスク容量を節約することが目的です。
タグ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
のデフォルト: 「0」-
ダウンロード エラーの再試行の最大回数。0 に設定した場合、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: 1.0-
この要素に基づいて、Starlark リポジトリ ルールのすべてのタイムアウトをスケールします。これにより、ソースコードを変更せずに、ルール作成者の期待よりも低速なマシンで外部リポジトリを動作させることができます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
のデフォルト: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: 「0s」-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にした場合、タイムアウトの最大値は定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: 1.0-
HTTP ダウンロードに関連するすべてのタイムアウトを、指定された係数でスケーリングする
タグ:bazel_internal_configuration
--repository_cache=<a path>
デフォルト: 説明を参照-
外部リポジトリの取得中に取得された、ダウンロードした値のキャッシュ ロケーションを指定します。引数として空の文字列は、キャッシュの無効化をリクエストします。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
デフォルト: 「false」-
設定すると、リポジトリの取得中に resourcemanager.download{,_and_extract} を使用してダウンロードできなくなります。ネットワーク アクセスは完全に無効にされているわけではありません。インターネットにアクセスする任意の実行可能ファイルを resourcemanager.execute で実行することは可能です。
タグ:bazel_internal_configuration
- ビルド実行を制御するオプション:
--[no]check_up_to_date
デフォルト: 「false」-
ビルドは実行せず、ビルドが最新かどうか確認してください。すべてのターゲットが最新の状態であれば、ビルドは正常に完了します。実行する必要があるステップがあるとエラーが報告され、ビルドは失敗します。
タグ:execution
--dynamic_local_execution_delay=<an integer>
のデフォルト: 「1000」-
ビルド中にリモート実行が 1 回以上高速化された場合、ローカル実行を何ミリ秒遅らせる必要がありますか?
タグ:execution
、host_machine_resource_optimizations
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment>
件の複数回の使用が累積される-
特定のニーモニックで使用するローカル戦略 - 最初に適用可能な戦略が使用されます。たとえば「worker,sandboxed」は、ワーカー戦略を使用して永続的なワーカーをサポートするアクションを実行し、他のすべてのアクションはサンドボックス戦略を使用するアクションを実行します。ニーモニックが指定されていない場合は、戦略のリストがすべてのニーモニックの代替として使用されます。「experimental_local_lockfree_output」が設定されている場合、デフォルトのフォールバック リストは「worker,sandboxed」または「worker,sandboxed,simple」です。[mnemonic=]local_strategy[,local_strategy,...] を取る
タグ:execution
、host_machine_resource_optimizations
--dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment>
件の複数回の使用が累積される-
指定したニーモニックで使用するリモート戦略。最初に適用可能な戦略が使用されます。ニーモニックが指定されていない場合は、戦略のリストがすべてのニーモニックの代替として使用されます。デフォルトのフォールバック リストは「remote」であるため、通常はこのフラグを明示的に設定する必要はありません。[mnemonic=]remote_strategy[,remote_strategy,...] を使用します。
タグ:execution
、host_machine_resource_optimizations
--experimental_docker_image=<a string>
のデフォルト: ""-
Docker 戦略を使用している場合にサンドボックス化されたアクションの実行に使用する Docker イメージ名(「ubuntu:latest」など)を指定します。アクション自体のプラットフォームの説明の Remote_execution_properties に container-image 属性が含まれていないことを確認してください。このフラグの値は docker run にそのまま渡されるため、Docker 自体と同じ構文とメカニズムがサポートされます。
タグ:execution
--[no]experimental_docker_use_customized_images
のデフォルト: 「true」-
有効にすると、現在のユーザーの uid と gid を Docker イメージに挿入してから使用します。これは、ビルド / テストにおいて、ユーザーがコンテナ内に名前とホーム ディレクトリを持っていることに依存している場合に必要になります。これはデフォルトでオンになっていますが、画像の自動カスタマイズ機能がケースで動作しない場合や、その必要がないことがわかっている場合は、無効にできます。
タグ:execution
--[no]experimental_dynamic_exclude_tools
のデフォルト: 「true」-
設定した場合、「ツール用」のビルドターゲットは動的実行の対象になりません。このようなターゲットが段階的に構築されることはほとんどないため、ローカル サイクルを費やす価値はありません。
タグ:execution
、host_machine_resource_optimizations
--experimental_dynamic_local_load_factor=<a double>
のデフォルト: 「0」-
動的実行によってローカルマシンにかかる負荷の量を制御します。このフラグは、同時にスケジュールする動的実行のアクションの数を調整します。これは、Blaze が使用可能とみなす CPU の数に基づいています。この数は、--local_cpu_resources フラグで制御できます。このフラグが 0 の場合、すべてのアクションはローカルで直ちにスケジュールされます。0 より大きい場合、ローカルでスケジュールされるアクションの数は、使用可能な CPU の数によって制限されます。1 未満の場合、スケジュール待ちのアクション数が多い場合に、ローカルにスケジュールされるアクションの数を減らすために、負荷係数が使用されます。これにより、ローカルマシンのあまり貢献しないクリーンビルドの場合に、ローカルマシンの負荷が軽減されます。
タグ:execution
、host_machine_resource_optimizations
--experimental_dynamic_slow_remote_time=<An immutable length of time.>
のデフォルト: 「0」-
0 より大きい場合、リモート タイムアウトを避けるためにローカル実行を優先する前に、動的実行アクションをリモートのみで実行する必要があります。これにより、リモート実行システムの一部の問題が隠れてしまう場合があります。リモート実行の問題をモニタリングすることなく、これをオンにしないでください。
タグ:execution
、host_machine_resource_optimizations
--[no]experimental_enable_docker_sandbox
デフォルト: 「false」-
Docker ベースのサンドボックスを有効にします。Docker がインストールされていない場合、このオプションは無効です。
タグ:execution
--experimental_sandbox_async_tree_delete_idle_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
のデフォルト: 「4」-
0 の場合、アクションが完了したらすぐにサンドボックス ツリーを削除します(これにより、アクションの完了が遅れます)。ゼロより大きい場合、ビルドの実行中にサイズが 1 の非同期スレッドプールで、このような 3 つのスレッドの削除を実行します。このプールは、サーバーがアイドル状態のときにこのフラグで指定されたサイズまで増加します。
タグ:host_machine_resource_optimizations
、execution
--experimental_sandbox_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
のデフォルト: 「0」-
0 より大きい場合、各 Linux サンドボックスは指定されたメモリ量(MB 単位)に制限されます。cgroups v1 または v2 と、cgroups ディレクトリに対するユーザーの権限が必要です。
タグ:execution
--[no]experimental_shrink_worker_pool
デフォルト: 「false」-
有効にすると、ワーカーメモリの負荷が高い場合にワーカープールを縮小できます。このフラグは、experimental_total_worker_memory_limit_mb が有効になっている場合にのみ機能します。
タグ:execution
、host_machine_resource_optimizations
--[no]experimental_split_xml_generation
のデフォルト: 「true」-
このフラグが設定され、テスト アクションで test.xml ファイルが生成されない場合、Bazel は別のアクションを使用して、テストログを含むダミーの test.xml ファイルを生成します。それ以外の場合、Bazel はテスト アクションの一部として test.xml を生成します。
タグ:execution
--experimental_total_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
のデフォルト: 「0」-
この上限がゼロより大きい場合、すべてのワーカーの合計メモリ使用量が上限を超えると、アイドル状態のワーカーが強制終了される可能性があります。
タグ:execution
、host_machine_resource_optimizations
--[no]experimental_use_hermetic_linux_sandbox
デフォルト: 「false」-
true に設定すると、root をマウントせず、sandbox_add_mount_pair で指定されたもののみをマウントします。入力ファイルは、サンドボックスからシンボリック リンクされるのではなく、サンドボックスにハードリンクされます。アクション入力ファイルがサンドボックスと異なるファイルシステムに配置されている場合は、入力ファイルがコピーされます。
タグ:execution
--[no]experimental_use_semaphore_for_jobs
デフォルト: 「false」-
true に設定すると、さらにセマフォを使用して同時実行ジョブの数を制限します。
タグ:host_machine_resource_optimizations
、execution
--[no]experimental_use_windows_sandbox
デフォルト: 「false」-
Windows サンドボックスを使用してアクションを実行します。「yes」の場合、--experimental_windows_sandbox_path によって提供されるバイナリは有効であり、サポートされているバージョンの sandboxfs に対応している必要があります。「auto」の場合、バイナリが存在しないか、互換性がない可能性があります。
タグ:execution
--experimental_windows_sandbox_path=<a string>
のデフォルト: 「BazelSandbox.exe」-
--experimental_use_windows_sandbox が true の場合に使用する Windows サンドボックス バイナリへのパス。単純な名前の場合は、PATH で検出されたその名前の最初のバイナリを使用します。
タグ:execution
--experimental_worker_allowlist=<comma-separated set of options>
デフォルト: 説明を参照-
空でない場合は、指定されたワーカーキーのニーモニックを持つ永続ワーカーのみの使用を許可します。
タグ:execution
、host_machine_resource_optimizations
--[no]experimental_worker_as_resource
のデフォルト: 「true」-
No-op、まもなく削除されます。
タグ:no_op
--[no]experimental_worker_cancellation
デフォルト: 「false」-
有効にすると、Bazel はサポートしているワーカーにキャンセル リクエストを送信できます。
タグ:execution
--experimental_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
のデフォルト: 「0」-
この上限がゼロより大きい場合、ワーカーのメモリ使用量が上限を超えると、ワーカーが強制終了される可能性があります。動的実行と「--experimental_dynamic_ignore_local_signals=9」を併用しないと、ビルドがクラッシュする可能性があります。
タグ:execution
、host_machine_resource_optimizations
--experimental_worker_metrics_poll_interval=<An immutable length of time.>
のデフォルト: 「5s」-
ワーカー指標を収集してからエビクションを試行する間隔。パフォーマンス上の理由から、事実上 1 秒未満にすることはできません。
タグ:execution
、host_machine_resource_optimizations
--[no]experimental_worker_multiplex_sandboxing
デフォルト: 「false」-
有効にすると、Multiplex ワーカーはサンドボックス化され、WorkRequest ごとに個別のサンドボックス ディレクトリが使用されます。実行要件が「supports-multiplex-sandboxing」であるワーカーのみがサンドボックス化されます。
タグ:execution
--[no]experimental_worker_sandbox_hardening
デフォルト: 「false」-
有効にすると、ワーカーは強化されたサンドボックスで実行されます(実装で許可されている場合)。
タグ:execution
--[no]experimental_worker_strict_flagfiles
デフォルト: 「false」-
有効にすると、ワーカー仕様に従っていないワーカーのアクション引数を使用すると、エラーが発生します。ワーカーの引数には、引数リストの最後の引数として @flagfile 引数が 1 つだけ必要です。
タグ:execution
--gc_thrashing_threshold=<an integer in 0-100 range>
のデフォルト: 「100」-
GcThrashingDetector がメモリ プレッシャー イベントを上限(--gc_thrashing_limits)と比較して考慮する、在職期間の占有スペースの割合(0 ~ 100)。100 に設定すると、GcThrashingDetector は無効になります。
タグ:host_machine_resource_optimizations
--genrule_strategy=<comma-separated list of options>
のデフォルト: ""-
genrules の実行方法を指定します。このフラグは段階的に廃止される予定です。代わりに、すべてのアクションを制御するには --spawn_strategy=<value> を使用し、genrules のみを制御するには --strategy=Genrule=<value> を使用します。
タグ:execution
--high_priority_workers=<a string>
件の複数回の使用が累積される-
No-op、まもなく削除されます。
タグ:execution
--[no]incompatible_remote_dangling_symlinks
のデフォルト: 「true」-
true に設定し、--compatible_remote_symlinks も true に設定した場合、アクションの出力内のシンボリック リンクがぶら下がります。
タグ:execution
、incompatible_change
--[no]incompatible_remote_symlinks
のデフォルト: 「true」-
true に設定すると、Bazel はリモート キャッシュ/実行プロトコルで、アクション出力でのシンボリック リンクを表します。それ以外の場合は、シンボリック リンクが後続し、ファイルまたはディレクトリとして表されます。詳しくは #6631 をご覧ください。
タグ:execution
、incompatible_change
--[no]incompatible_sandbox_hermetic_tmp
のデフォルト: 「true」-
true に設定すると、Linux サンドボックスごとに専用の空のディレクトリが /tmp としてマウントされます。/tmp がホストのファイル システムと共有されることはありません。すべてのサンドボックスでホストの/tmp を引き続き表示するには、--sandbox_add_mount_pair=/tmp を使用します。
タグ:execution
--[no]internal_spawn_scheduler
デフォルト: 「false」-
スケジューラ オプションが有効かどうかを Blaze に伝えるためのプレースホルダ オプション。
タグ:execution
、host_machine_resource_optimizations
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] default: "auto"-
実行するジョブの数。整数またはキーワード ("auto", "HOST_CPUS", "HOST_RAM") を取り、必要に応じて演算([-|*]<float>)を続けます。例:"auto"、"HOST_CPUS*.5" となります。値は 1 ~ 5,000 にする必要があります。2,500 を超える値は、メモリの問題を引き起こす可能性があります。「auto」は、ホストリソースに基づいて妥当なデフォルトを計算します。
タグ:host_machine_resource_optimizations
、execution
--[no]keep_going
[-k
] default: "false"-
エラー発生後は、できるだけ続行してください。失敗したターゲットとそれに依存するターゲットは分析できませんが、これらのターゲットの他の前提条件は分析できます。
タグ:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
のデフォルト: "auto"-
読み込み/分析フェーズに使用する並列スレッドの数。整数またはキーワード("auto"、"HOST_CPUS"、"HOST_RAM")を受け取ります。その後に必要に応じて演算([-|*]<float>)が続きます。例:"auto"、"HOST_CPUS*.5" となります。「auto」は、ホストリソースに基づいて妥当なデフォルトを設定します。1 以上の値を指定してください。
タグ:bazel_internal_configuration
--[no]reuse_sandbox_directories
のデフォルト: 「true」-
true に設定すると、サンドボックス化された非ワーカー実行で使用されるディレクトリが再利用され、不要な設定コストが回避されます。
タグ:host_machine_resource_optimizations
、execution
--sandbox_base=<a string>
のデフォルト: ""-
サンドボックスでこのパスの下にサンドボックス ディレクトリを作成できます。ビルド /テストに多数の入力ファイルがある場合にパフォーマンスを大幅に向上させるには、tmpfs のパス(/run / shm など)を指定します。注: tmpfs には、アクションの実行によって生成された出力ファイルと中間ファイルを保持するのに十分な RAM と空き容量が必要です。
タグ:host_machine_resource_optimizations
、execution
--[no]sandbox_explicit_pseudoterminal
デフォルト: 「false」-
サンドボックス化されたアクション用の疑似ターミナルの作成を明示的に有効にします。一部の Linux ディストリビューションでは、疑似ターミナルが機能するためには、サンドボックス内でプロセスのグループ ID を「tty」に設定する必要があります。これが問題の原因である場合は、このフラグを無効にして、他のグループを使用できるようにします。
タグ:execution
--sandbox_tmpfs_path=<an absolute path>
件の複数回の使用が累積される-
サンドボックス化されたアクションの場合は、この絶対パスに空の書き込み可能なディレクトリをマウントします(サンドボックス化の実装でサポートされている場合、それ以外の場合は無視されます)。
タグ:host_machine_resource_optimizations
、execution
--[no]skip_incompatible_explicit_targets
デフォルト: 「false」-
コマンドラインに明示的にリストされている互換性のないターゲットをスキップします。デフォルトでは、このようなターゲットをビルドするとエラーが発生しますが、このオプションを有効にすると通知なくスキップされます。参照: https://bazel.build/extending/platforms#skipping-compatibility-targets
タグ:loading_and_analysis
--spawn_strategy=<comma-separated list of options>
のデフォルト: ""-
生成アクションのデフォルトの実行方法を指定します。優先度が高い方から低い方の戦略のカンマ区切りリストを指定できます。Bazel は、アクションごとに、そのアクションを実行できる優先度が最も高い戦略を選択します。デフォルト値は「remote,worker,sandboxed,local」です。詳細については、https://blog.bazel.build/2019/06/19/list-strategy.html をご覧ください。
タグ:execution
--strategy=<a '[name=]value1[,..,valueN]' assignment>
件の複数回の使用が累積される-
他のスポーン アクションのコンパイルを配布する方法を指定します。優先度が高い方から低い方の戦略のカンマ区切りリストを指定できます。Bazel は、アクションごとに、そのアクションを実行できる優先度が最も高い戦略を選択します。デフォルト値は「remote,worker,sandboxed,local」です。このフラグは、--spawn_strategy(および mnemonic Genrule で使用する場合は --genrule_strategy)によって設定された値をオーバーライドします。詳細については、https://blog.bazel.build/2019/06/19/list-strategy.html をご覧ください。
タグ:execution
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
件の複数回の使用が累積される-
特定の regex_filter と一致する説明を持つ生成アクションを実行するために使用する Spawn 戦略をオーバーライドします。regex_filter マッチングの詳細については、--per_file_copt をご覧ください。説明に一致する最後の regex_filter が使用されます。このオプションは、戦略を指定する他のフラグをオーバーライドします。例: --strategy_regexp=//foo.*\.cc,-//foo/bar=local は、その説明が //foo.*.cc に一致し、//foo/bar には一致しない場合に、ローカル戦略を使用してアクションを実行することを意味します。例: --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed の場合、「local」戦略を使用して「Compiling //foo/bar/baz」が実行されますが、順序を逆にすると「sandboxed」で実行されます。
タグ:execution
--worker_extra_flag=<a 'name=value' assignment>
件の複数回の使用が累積される-
ニーモニックをキーにした --persistent_worker に加えて、ワーカー プロセスに渡される追加のコマンドフラグ(例: --worker_extra_flag=Javac=--debug
タグ:execution
、host_machine_resource_optimizations
--worker_max_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
件の複数回の使用が累積される-
「ワーカー」戦略を使用した場合に起動できる各永続ワーカーのインスタンス数。[name=value] と指定して、ニーモニックごとに異なる値を指定することもできます。上限はワーカーキーに基づいており、これはニーモニックだけでなく、起動フラグと環境によっても異なります。そのため、ニーモニックごとのワーカーが、このフラグで指定されている数よりも多くなる場合があります。整数またはキーワード ("auto", "HOST_CPUS", "HOST_RAM") を取り、必要に応じて演算([-|*]<float>)を続けます。例:"auto"、"HOST_CPUS*.5" となります。「auto」は、マシンの容量に基づいて妥当なデフォルトを計算します。「=value」は、指定していないニーモニックのデフォルトを設定します。
タグ:execution
、host_machine_resource_optimizations
--worker_max_multiplex_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
件の複数回の使用が累積される-
--worker_multiplex を指定して「worker」戦略を使用した場合に、Multiplex ワーカー プロセスが並行して受信できる WorkRequest の数。[name=value] と指定して、ニーモニックごとに異なる値を指定することもできます。上限はワーカーキーに基づいており、これはニーモニックだけでなく、起動フラグと環境によっても異なります。そのため、ニーモニックごとのワーカーが、このフラグで指定されている数よりも多くなる場合があります。整数またはキーワード ("auto", "HOST_CPUS", "HOST_RAM") を取り、必要に応じて演算([-|*]<float>)を続けます。例:"auto"、"HOST_CPUS*.5" となります。「auto」は、マシンの容量に基づいて妥当なデフォルトを計算します。「=value」は、指定していないニーモニックのデフォルトを設定します。
タグ:execution
、host_machine_resource_optimizations
--[no]worker_multiplex
のデフォルト: 「true」-
有効にすると、ワーカーで多重化がサポートされていれば、多重化が使用されます。
タグ:execution
、host_machine_resource_optimizations
--[no]worker_quit_after_build
デフォルト: 「false」-
有効にすると、ビルドの完了後にすべてのワーカーが終了します。
タグ:execution
、host_machine_resource_optimizations
--[no]worker_sandboxing
デフォルト: 「false」-
有効にすると、ワーカーはサンドボックス環境で実行されます。
タグ:execution
--[no]worker_verbose
デフォルト: 「false」- 有効にすると、ワーカーの起動やシャットダウンなどの際に詳細なメッセージを出力します。
- アクションの実行に使用するツールチェーンを構成するオプション:
--target_platform_fallback=<a string>
のデフォルト: ""-
このオプションは非推奨であり、機能しません。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
- コマンドの出力を制御するオプション:
--[no]build
のデフォルト: 「true」-
ビルドを実行します。この動作は通常の動作です。--nobuild を指定すると、ビルド アクションを実行する前にビルドが停止し、パッケージの読み込みフェーズと分析フェーズが正常に完了した場合はゼロが返されます。このモードは、これらのフェーズをテストする場合に役立ちます。
タグ:execution
、affects_outputs
--[no]experimental_use_validation_aspect
デフォルト: 「false」-
アスペクトを使用して検証アクションを実行するかどうかを指定します(テストとの並列処理のため)。
タグ:execution
、affects_outputs
--output_groups=<comma-separated list of options>
件の複数回の使用が累積される-
出力グループ名のカンマ区切りのリスト。それぞれに接頭辞として「+」または「-」が付加されます。「+」で始まるグループはデフォルトの出力グループに追加され、「-」で始まるグループはデフォルトのセットから削除されます。接頭辞が付加されていないグループが少なくとも 1 つある場合、出力グループのデフォルト セットは省略されます。たとえば、--output_groups=+foo,+bar はデフォルト セット foo と bar を結合したものをビルドし、--output_groups=foo,bar は foo と bar のみがビルドされるようにデフォルト セットをオーバーライドします。
タグ:execution
、affects_outputs
--[no]run_validations
のデフォルト: 「true」-
ビルドの一環として検証アクションを実行するかどうかを指定します。https://bazel.build/extending/rules#validation_actions をご覧ください。
タグ:execution
、affects_outputs
- 目的の出力をユーザーが構成できるオプション(その存在ではなく、その値に影響するオプション):
--aspects=<comma-separated list of options>
件の複数回の使用が累積される- 最上位のターゲットに適用するアスペクトのカンマ区切りリスト。リストで、some_aspect が required_aspect_providers を介して必要なアスペクト プロバイダを指定する場合、some_aspect は、アドバタイズされたプロバイダが some_aspect の必要なアスペクト プロバイダを満たすアスペクト リスト内で事前に言及されたすべてのアスペクトの後に実行されます。さらに、some_aspect は required 属性で指定されたすべての必須アスペクトの後に実行されます。これにより、some_aspect がそれらのアスペクトのプロバイダの値にアクセスできるようになります。<bzl-file-label>%<aspect_name>(例: 「//tools:my_def.bzl%my_aspect」)。「my_aspect」はファイル tools/my_def.bzl の最上位の値です。
--bep_maximum_open_remote_upload_files=<an integer>
デフォルト: 「-1」-
BEP アーティファクトのアップロード中に許可されるオープン ファイルの最大数。
タグ:affects_outputs
--[no]experimental_convenience_symlinks
のデフォルト: 「normal」-
このフラグは、便利なシンボリック リンク(ビルド後のワークスペースに表示されるシンボリック リンク)の管理方法を制御します。指定可能な値: normal(デフォルト): 各種類の便利なシンボリック リンクが作成、削除されます。ビルドの決定に従います。
clean: すべてのシンボリック リンクを無条件に削除します。
ignore: Symlink はそのまま残ります。log_only: 「normal」が渡されたかのようにログメッセージを生成しますが、実際にはファイルシステム オペレーションは実行しません(ツールに役立ちます)。
影響を受けるのは、--symlink_prefix の現在の値によって名前が生成されるシンボリック リンクのみです。接頭辞が変更された場合、既存のシンボリック リンクはそのまま残ります。
タグ:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
デフォルト: 「false」-
このフラグは、ビルド eventConvenienceSymlinksIdentified を BuildEventProtocol に送信するかどうかを制御します。この値が true の場合、BuildEventProtocol にはコンビニエンス SymlinksIdentified のエントリがあり、ワークスペースに作成されたコンビニエンス シンボリック リンクがすべてリストされます。false の場合、BuildEventProtocol のコンビニエンス SymlinksIdentified エントリは空になります。
タグ:affects_outputs
--remote_download_all
-
すべてのリモート出力をローカルマシンにダウンロードします。このフラグは --remote_download_outputs=all のエイリアスです。
次のように展開:
--remote_download_outputs=all
タグ:affects_outputs
--remote_download_minimal
-
リモートビルドの出力をローカルマシンにダウンロードしません。このフラグは --remote_download_outputs=minimal のエイリアスです。
次のように展開:
--remote_download_outputs=minimal
タグ:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
のデフォルト: 「toplevel」-
「minimal」に設定した場合、ローカル アクションに必要な出力以外のリモートビルド出力はローカルマシンにダウンロードされません。「toplevel」に設定すると、最上位レベルのターゲットの出力もローカルマシンにダウンロードされることを除き、「minimal」のように動作します。どちらのオプションも、ネットワーク帯域幅がボトルネックである場合には、ビルド時間を大幅に短縮できます。
タグ:affects_outputs
--remote_download_symlink_template=<a string>
のデフォルト: ""-
リモートビルドの出力をローカルマシンにダウンロードするのではなく、シンボリック リンクを作成します。シンボリック リンクのターゲットは、テンプレート文字列の形式で指定できます。このテンプレート文字列には {hash} と {size_bytes} が含まれ、それぞれオブジェクトのハッシュとバイト単位のサイズに展開されます。これらのシンボリック リンクは、たとえば、オンデマンドで CAS からオブジェクトを読み込む FUSE ファイル システムを指すことができます。
タグ:affects_outputs
--remote_download_toplevel
-
最上位ターゲットのリモート出力のみをローカルマシンにダウンロードします。このフラグは --remote_download_outputs=toplevel のエイリアスです。
次のように展開:
--remote_download_outputs=toplevel
タグ:affects_outputs
--symlink_prefix=<a string>
デフォルト: 説明を参照-
ビルド後に作成される便利なシンボリック リンクのいずれかの先頭に付加される接頭辞です。省略した場合、デフォルト値はビルドツールの名前の後にハイフンを付けたものになります。「/」を渡すと、シンボリック リンクは作成されず、警告も出力されません。警告: 「/」の特別な機能はまもなくサポート終了となります。代わりに --experimental_convenience_symlinks=ignore を使用してください。
タグ:affects_outputs
- Bazel が有効なビルド入力を厳密に適用するかどうかに影響するオプション(ルール定義、フラグの組み合わせなど):
--[no]experimental_docker_privileged
デフォルト: 「false」-
有効にすると、Bazel はアクションの実行時に --privileged フラグを「docker run」に渡します。これはビルドで必要になる場合がありますが、密閉性が低下する可能性もあります。
タグ:execution
--[no]experimental_sandboxfs_map_symlink_targets
デフォルト: 「false」-
No-op
タグ:host_machine_resource_optimizations
、execution
--[no]incompatible_legacy_local_fallback
デフォルト: 「false」-
true に設定すると、サンドボックス化からローカル戦略への従来の暗黙的なフォールバックが有効になります。このフラグは最終的には false に設定され、その後 no-op になります。代わりに、--strategy、--spawn_strategy、または --dynamic_local_strategy を使用して、フォールバックを構成します。
タグ:execution
、incompatible_change
--sandbox_add_mount_pair=<a single path or a 'source:target' pair>
件の複数回の使用が累積される-
サンドボックスにマウントするパスペアを追加します。
タグ:execution
--sandbox_block_path=<a string>
件の複数回の使用が累積される-
サンドボックス化されたアクションの場合、このパスへのアクセスを禁止します。
タグ:execution
--[no]sandbox_default_allow_network
のデフォルト: 「true」-
アクションに対するネットワーク アクセスをデフォルトで許可します。これはすべてのサンドボックス実装で機能しない場合があります。
タグ:execution
--[no]sandbox_fake_hostname
デフォルト: 「false」-
サンドボックス化されたアクションを使用するために、現在のホスト名を「localhost」に変更します。
タグ:execution
--[no]sandbox_fake_username
デフォルト: 「false」-
サンドボックス化されたアクションを使用する現在のユーザー名を「nobody」に変更します。
タグ:execution
--sandbox_writable_path=<a string>
件の複数回の使用が累積される-
サンドボックス化されたアクションでは、既存のディレクトリをサンドボックス内で書き込み可能にします(サンドボックス化の実装でサポートされている場合、それ以外の場合は無視します)。
タグ:execution
- このオプションは、BUILD ファイル、.bzl ファイル、WORKSPACE ファイルからアクセス可能な Starlark 言語または Build API のセマンティクスに影響します。
--[no]incompatible_config_setting_private_default_visibility
デフォルト: 「false」-
compatible_enforce_config_setting_visibility=false の場合、何も追加されません。このフラグが false の場合、明示的な可視性属性のない config_setting は //visibility:public です。このフラグが true の場合、config_setting は他のすべてのルールと同じ可視性ロジックに従います。https://github.com/bazelbuild/bazel/issues/12933 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_enforce_config_setting_visibility
のデフォルト: 「true」-
true の場合、config_setting 公開設定の制限を適用します。false の場合、すべての config_setting がすべてのターゲットに表示されます。https://github.com/bazelbuild/bazel/issues/12932 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
- テスト環境またはテストランナーの動作を制御するオプション:
--[no]check_tests_up_to_date
デフォルト: 「false」-
テストは実行せず、結果が最新かどうか確認してください。すべてのテスト結果が最新であれば、テストは正常に完了します。テストのビルドまたは実行が必要な場合、エラーが報告され、テストは失敗します。このオプションは --check_up_to_date の動作を示します。
タグ:execution
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
件の複数回の使用が累積される-
各テストは、テストが失敗した場合、指定された回数まで再試行されます。2 回以上の試行が必要なテストは、テストサマリーに「FLAKY」と表示されます。通常、指定される値は整数または文字列「default」です。整数の場合は、すべてのテストが N 回まで実行されます。「default」に設定すると、通常のテストでは 1 回だけテストが試行され、ルール(flaky=1 属性)によって明示的に不安定とマークされたテストでは 3 回試行されます。別の構文: regex_filter@flaky_test_attemptsここで、flaky_test_attempts は上記のとおりで、regex_filter は、包含および除外する正規表現パターンのリストを表します(--runs_per_test も参照)。例: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 は、//foo/ 内にあるテストのうち、foo/bar の下にあるものを除くすべてのテストを 3 回デフレークします。このオプションは複数回渡すことができます。最後に渡された引数のうち、一致したものが優先されます。一致するものがない場合は、上記の「default」と同じ動作になります。
タグ:execution
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
のデフォルト: "auto"-
同時に実行するローカルテストジョブの最大数。整数またはキーワード ("auto", "HOST_CPUS", "HOST_RAM") を取り、必要に応じて演算([-|*]<float>)を続けます。例:"auto"、"HOST_CPUS*.5" となります。0 に設定すると、同時に実行するローカルテストジョブの数がローカル リソースによって制限されます。--jobs よりも大きい値を設定しても効果はありません。
タグ:execution
--[no]test_keep_going
のデフォルト: 「true」-
無効にすると、テストに合格しなかった場合にビルド全体が停止します。デフォルトでは、一部のテストに合格しなかった場合でも、すべてのテストが実行されます。
タグ:execution
--test_strategy=<a string>
のデフォルト: ""-
テスト実行時に使用する戦略を指定します。
タグ:execution
--test_tmpdir=<a path>
デフォルト: 説明を参照- 「bazel test」で使用するベース一時ディレクトリを指定します。
- クエリの出力とセマンティクスに関連するオプションは次のとおりです。
--[no]experimental_parallel_aquery_output
のデフォルト: 「true」- No-op。
- Bzlmod の出力とセマンティクスに関連するオプション:
--allow_yanked_versions=<a string>
件の複数回の使用が累積される-
モジュール バージョンを「<module1>@<version1>,<module2>@<version2>」の形式で指定しました。これは、モジュール バージョンが元のレジストリでヤンクされていると宣言されていても(NonRegistryOverride からのものではない場合)、解決済みの依存関係グラフで許可します。そうしないと、バージョンをアンクすると解決が失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可するヤンク バージョンを定義することもできます。このチェックを無効にするには、キーワード「all」を使用します(非推奨)。
タグ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
デフォルト: "error"-
Bazel モジュールの bazel バージョン互換性を確認します。有効な値は、エラーを解決失敗にエスカレーションする場合は「error」、チェックを無効にする場合は「off」、不一致が検出されたときに警告を出力する場合は「warning」です。
タグ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
のデフォルト: 「warning」-
ルート モジュールで宣言されている直接的な「bazel_dep」依存関係が、解決された依存関係グラフで表示されるバージョンと同じかどうかを確認します。有効な値は、チェックを無効にする「off」、不一致が検出されたときに警告を出力する「warning」、解決失敗にエスカレーションする場合は「error」です。
タグ:loading_and_analysis
--[no]ignore_dev_dependency
デフォルト: 「false」-
true の場合、Bazel は、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」を無視します。これらの dev の依存関係は、このフラグの値に関係なく、ルート モジュールでない場合、MODULE.bazel では常に無視されることに注意してください。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: 「update」-
ロックファイルを使用する方法と使用するかどうかを指定します。有効な値は、「update」でロックファイルを使用し、変更がある場合に「error」を指定します。「error」はロックファイルを使用しますが、最新でない場合はエラーをスローします。「off」はロックファイルの読み取りも書き込みも行わない「off」です。
タグ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
件の複数回の使用が累積される- <モジュール名>=<パス> という形式のローカルパスでモジュールをオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。相対パスの場合は、現在の作業ディレクトリからの相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--registry=<a string>
件の複数回の使用が累積される-
Bazel モジュールの依存関係の検索に使用するレジストリを指定します。順序は重要です。モジュールは最初に以前のレジストリで検索され、以前のレジストリからモジュールが見つからなくなった場合にのみ、後のレジストリにフォールバックします。
タグ:changes_inputs
- ビルド時間の最適化をトリガーするオプション:
--experimental_dynamic_ignore_local_signals=<a comma-separated list of signal numbers>
デフォルト: 説明を参照-
OS シグナル番号のリストを受け取ります。動的実行のローカル ブランチがこれらのシグナルのいずれかで強制終了されると、代わりにリモート ブランチの終了が許可されます。永続ワーカーの場合、これはワーカー プロセスを強制終了するシグナルにのみ影響します。
タグ:execution
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
デフォルト: 「1s:2,20s:3,1m:5」-
上限に達すると GcThrashingDetector が OOM で Bazel をクラッシュさせる上限。各制限は、<period>:<count> の形式で指定します。[期間] は期間、[カウント] は正の整数です。<period> で <count> 回連続してフル GC を実行した後、残存容量(旧世代ヒープ)の --gc_thrashing_threshold パーセントを超える領域が占有されている場合、OOM がトリガーされます。複数の上限を指定する場合は、カンマで区切ってください。
タグ:host_machine_resource_optimizations
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
のデフォルト: "HOST_CPUS"-
ローカルで実行されるビルド アクションに Bazel が使用できるローカル CPU コアの合計数を明示的に設定します。整数または "HOST_CPUS" を取り、必要に応じて [-|*]<float> が続きます(例:HOST_CPUS*.5 を指定すると、使用可能な CPU コアの半分が使用されます。デフォルトでは、Bazel (「HOST_CPUS」)はシステム構成を照会して、使用可能な CPU コア数を推定します。
タグ:host_machine_resource_optimizations
--local_extra_resources=<a named float, 'name=value'>
件の複数回の使用が累積される-
Bazel で使用できる追加リソースの数を設定します。文字列と浮動小数点のペアを取ります。複数回使用して、複数のタイプの追加のリソースを指定できます。Bazel は、利用可能な追加リソースと必要な追加リソースに基づいて、同時実行アクションを制限します。テストでは、「resources:<resoucename>:<amount>」形式のタグを使用して、追加で必要なリソースの量を宣言できます。使用可能な CPU、RAM、リソースをこのフラグで設定することはできません。
タグ:host_machine_resource_optimizations
--local_ram_resources=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
のデフォルト: "HOST_RAM*.67"-
ローカルで実行されるビルド アクションに Bazel が使用できるローカルホスト RAM の合計容量(MB 単位)を明示的に設定します。整数または "HOST_RAM" を取ります。必要に応じてその後に [-|*]<float> が続きます(例:使用可能な RAM の半分を使用する場合は HOST_RAM*.5 を使用します)。デフォルト("HOST_RAM*.67")では、Bazel はシステム構成を照会して使用可能な RAM の量を推定し、その 67% を使用します。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出した場合、完全な GC イベントが発生したときに、不要な一時的な Skyframe の状態を呼び出しごとにこの回数まで破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、完全な GC イベントがドロップをトリガーしないことを意味します。上限に達すると、フル GC イベントが発生して保持されるヒープの割合のしきい値を超えたときに、スカイフレームの状態がドロップされなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出すると、マイナー GC イベントが発生したときに不要な一時的な Skyframe 状態を(呼び出しごとにこの回数まで)破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。上限に達すると、マイナー GC イベントが発生して保持されるヒープの割合のしきい値を超えても、スカイフレームの状態は破棄されなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
のデフォルト: 「85」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。Bazel は、保持されているヒープの割合がこのしきい値以上であることを検出すると、不要な一時的な Skyframe 状態を削除します。これを微調整することで、GC スラッシングが(i)この一時的な状態のメモリ使用量によって発生し、(ii)必要なときに状態の再構築よりもコストが高くなる場合に、GC スラッシングの経過時間への影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
- ロギングの詳細度、形式、場所に影響するオプション:
--[no]debug_spawn_scheduler
デフォルト: 「false」--[no]experimental_bep_target_summary
デフォルト: 「false」- TargetSummary イベントを公開するかどうか。
--[no]experimental_build_event_expand_filesets
デフォルト: 「false」-
true の場合、出力ファイルを提示するときに、BEP でファイルセットを展開します。
タグ:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
デフォルト: 「false」-
true の場合、出力ファイルを表示するときに、BEP の相対ファイルセット シンボリック リンクを完全に解決します。--experimental_build_event_expand_filesets が必要です。
タグ:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
のデフォルト: 「4」-
Bazel がビルドイベントのアップロードを再試行する最大回数。
タグ:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
のデフォルト: 「1s」-
BEP のアップロードが失敗した場合の指数バックオフの再試行の最小遅延。(指数: 1.6)
タグ:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
デフォルト: 説明を参照-
ビルドイベント プロトコルで参照されるアーティファクトをアップロードする方法を選択します。
タグ:affects_outputs
--[no]experimental_collect_local_sandbox_action_metrics
のデフォルト: 「true」-
no-op を非推奨にしました。
タグ:execution
--[no]experimental_command_profile
デフォルト: 「false」- Java フライト レコーダーの CPU プロファイルを、出力ベース ディレクトリにある profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプや出力形式をサポートするために今後変更される可能性があります。ご自身の責任のもとで使用してください。
--[no]experimental_docker_verbose
デフォルト: 「false」-
有効にすると、Bazel は Docker サンドボックス戦略に関する詳細なメッセージを出力します。
タグ:execution
--[no]experimental_materialize_param_files_directly
デフォルト: 「false」-
パラメータ ファイルを実体化する場合は、ディスクに直接書き込みます。
タグ:execution
--[no]experimental_record_metrics_for_all_mnemonics
デフォルト: 「false」- デフォルトでは、アクション タイプの数は、実行されるアクションの数が最も多い 20 個のニーモニックに限定されています。このオプションを設定すると、すべてのニーモニックの統計情報が書き込まれます。
--experimental_repository_resolved_file=<a string>
のデフォルト: ""-
空でない場合は、実行されたすべての Starlark リポジトリ ルールの解決された情報を含む Starlark 値を書き込みます。
タグ:affects_outputs
--[no]experimental_run_bep_event_include_residue
デフォルト: 「false」-
実行ビルドイベントにコマンドラインの残差を含めるかどうかを指定します。デフォルトでは、残留物を含む可能性のある実行コマンドのビルドイベントに残留物は含まれません。
タグ:affects_outputs
--[no]experimental_stream_log_file_uploads
デフォルト: 「false」-
ログファイルをディスクに書き込むのではなく、リモート ストレージに直接アップロードする。
タグ:affects_outputs
--explain=<a path>
デフォルト: 説明を参照-
実行されたビルドの各ステップをビルドシステムに説明させます。説明は指定したログファイルに書き込まれます。
タグ:affects_outputs
--[no]ignore_unsupported_sandboxing
デフォルト: 「false」-
このシステムでサンドボックス化の実行がサポートされていない場合は、警告を出力しません。
タグ:terminal_output
--[no]legacy_important_outputs
のデフォルト: 「true」-
これを使用して、TargetComplete イベントで以前の重要な出力フィールドの生成を抑制します。Bazel と ResultStore の統合には、重要_outputs が必要です。
タグ:affects_outputs
--[no]materialize_param_files
デフォルト: 「false」-
リモート アクション実行を使用している場合でも、中間パラメータ ファイルを出力ツリーに書き込みます。アクションをデバッグする場合に便利です。これは、--subcommands と --verbose_failures によって暗黙的に指定されます。
タグ:execution
--max_config_changes_to_show=<an integer>
のデフォルト: 「3」-
ビルド オプションの変更により分析キャッシュを破棄する場合、変更されたオプション名が指定された数まで表示されます。指定した数値が -1 の場合、変更されたすべてのオプションが表示されます。
タグ:terminal_output
--max_test_output_bytes=<an integer>
デフォルト: 「-1」-
--test_output が「errors」または「all」の場合に出力できる、テストごとのログの最大サイズを指定します。ノイズが過度に多いテスト出力で過剰な出力にならないようにする場合に便利です。テストヘッダーはログサイズに含まれます。負の値は制限がないことを意味します。出力は、オール オア ナッシングになります。
タグ:test_runner
、terminal_output
、execution
--output_filter=<a valid Java regular expression>
デフォルト: 説明を参照-
指定した正規表現に一致する名前のルールの警告とアクション出力のみが表示されます。
タグ:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
のデフォルト: 「0」-
実行中のジョブに関するレポートの間隔(秒)。デフォルト値の 0 は、10 秒後に最初のレポートが印刷され、その後 30 秒後にその進捗状況が 1 分ごとに報告されることを意味します。--curses が有効になっている場合、進行状況が 1 秒ごとに報告されます。
タグ:affects_outputs
--remote_print_execution_messages=<failure, success or all>
のデフォルト: "failure"-
リモート実行メッセージを出力するタイミングを選択します。有効な値は「failure」で、失敗時にのみ出力します。「success」は成功した場合のみを出力し、「all」は常に出力します。
タグ:terminal_output
--[no]sandbox_debug
デフォルト: 「false」-
サンドボックス機能のデバッグ機能を有効にします。これには 2 つのことが含まれます。1 つ目は、サンドボックスのルート コンテンツがビルド後に変更されないことです。2 つ目は、実行時に追加のデバッグ情報が出力されるという点です。Bazel または Starlark ルールのデベロッパーは、入力ファイルの欠落などが原因でデバッグが失敗する場合に役立ちます。
タグ:terminal_output
--show_result=<an integer>
のデフォルト: 「1」-
ビルドの結果を表示します。ターゲットごとに、それが最新かどうかを記載し、最新の場合はビルドされた出力ファイルのリストを記載します。出力されたファイルは、シェルにコピー&ペーストして実行するために便利な文字列です。このオプションには整数の引数が必要です。整数引数は、ターゲットのしきい値(しきい値を超えると、結果情報は出力されません)となります。したがって、ゼロを指定するとメッセージが抑制され、MAX_INT を指定すると結果が出力されます。デフォルトは 1 です。ターゲットに対して何もビルドされていない場合は、出力がしきい値を下回るように、結果が省略されることがあります。
タグ:affects_outputs
--[no]subcommands
[-s
] default: "false"-
ビルド中に実行されたサブコマンドを表示します。関連フラグ: --execution_log_json_file、--execution_log_binary_file(ツールに適した形式でサブコマンドをファイルに記録する場合)
タグ:terminal_output
--test_output=<summary, errors, all or streamed>
デフォルト: 「summary」-
目的の出力モードを指定します。有効な値は、「summary」はテスト ステータスの概要のみを出力し、「errors」は失敗したテストのテストログも出力、「all」はすべてのテストのログをリアルタイムで出力します。「streamed」はすべてのテストのログをリアルタイムに出力します(--test_strategy 値に関係なく、テストが一度に 1 つずつローカルに実行されます)。
タグ:test_runner
、terminal_output
、execution
--test_summary=<short, terse, detailed, none or testcase>
のデフォルト: 「short」-
テストサマリーの形式を指定します。有効な値は、「short」は実行されたテストに関する情報のみを出力し、「terse」は実行されたテストの失敗したテストの情報のみを出力し、「detailed」は失敗したテストケースの詳細情報を出力します。「testcase」は失敗したテストケースの詳細情報を出力しません。「none」は概要を省略します。
タグ:terminal_output
--[no]verbose_explanations
デフォルト: 「false」-
--explain が有効になっている場合に発行される説明の詳細度を高めます。--explain が有効になっていない場合は機能しません。
タグ:affects_outputs
--[no]verbose_failures
デフォルト: 「false」-
コマンドが失敗した場合は、コマンドライン全体を出力します。
タグ:terminal_output
- 他のカテゴリに当てはまらない Bazel コマンドへの汎用入力を指定または変更するオプション。
--aspects_parameters=<a 'name=value' assignment>
件の複数回の使用が累積される-
コマンドライン アスペクト パラメータの値を指定します。各パラメータ値は、<param_name>=<param_value> で指定されます。例: 'my_param=my_val'。'my_param' は --aspects リストのアスペクトのパラメータか、リストのアスペクトで必須です。このオプションは複数回使用できます。ただし、同じパラメータに値を複数回割り当てることはできません。
タグ:loading_and_analysis
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: ""-
空でない場合は、WORKSPACE ファイルではなく、指定された解決済みファイルを読み取ります。
タグ:changes_inputs
--target_pattern_file=<a string>
のデフォルト: ""-
設定すると、ビルドはコマンドラインではなく、ここで指定したファイルからパターンを読み取ります。コマンドライン パターンを指定したり、ここでファイルを指定するとエラーになります。
タグ:changes_inputs
- リモート キャッシュと実行のオプション:
--experimental_circuit_breaker_strategy=<failure>
デフォルト: 説明を参照-
回路ブレーカーで使用する戦略を指定します。利用可能な戦略は「失敗」です。オプションの値が無効な場合、オプションが設定されていないのと同じ動作になります。
タグ:execution
--experimental_downloader_config=<a string>
デフォルト: 説明を参照- リモート ダウンローダーを構成するファイルを指定します。このファイルは複数の行で構成され、各行はディレクティブ(「allow」、「block」、「rewrite」)で始まり、その後にホスト名(「allow」と「block」のそれぞれ)または 2 つのパターン(1 つは照合され、もう 1 つは代替 URL として使用)が続きます。後方参照は「$1」から始まります。複数の「rewrite」ディレクティブが返される場合があります。同じ URL の場合は、複数の URL が返される場合があります。
--[no]experimental_guard_against_concurrent_changes
デフォルト: 「false」- この機能をオフにすると、リモート キャッシュにアップロードする前にアクションの入力ファイルの ctime を確認できなくなります。Linux カーネルがファイルの書き込みを遅延させ、誤検出の原因になることがあります。
--[no]experimental_remote_cache_async
デフォルト: 「false」- true の場合、リモート キャッシュ I/O は Spawn の一環として行われるのではなく、バックグラウンドで発生します。
--experimental_remote_cache_eviction_retries=<an integer>
のデフォルト: 「0」-
ビルドでリモート キャッシュ エビクション エラーが発生した場合の再試行の最大回数。ゼロ以外の値を指定すると、暗黙的に --compatible_remote_use_new_exit_code_for_lost_inputs を true に設定します。試行ごとに新しい呼び出し ID が生成されます。呼び出し ID を生成し、--invocation_id を指定して Bazel に指定する場合は、このフラグを使用しないでください。代わりに、フラグ --compatible_remote_use_new_exit_code_for_lost_inputs を設定し、終了コード 39 を確認します。
タグ:execution
--[no]experimental_remote_cache_lease_extension
デフォルト: 「false」- true に設定すると、Bazel はビルド中にリモート アクションの出力のリースを延長し、「FindMissingBlobs」呼び出しをリモート キャッシュに定期的に送信します。頻度は「--experimental_remote_cache_ttl」の値に基づきます。
--experimental_remote_cache_ttl=<An immutable length of time.>
のデフォルト: "3h"-
ダイジェストが最近参照されたリモート キャッシュ内の blob の最小 TTL は、ActionResult や FindMissingBlobs などによって保証されます。Bazel は、blob の TTL に基づいていくつかの最適化を行います。たとえば、増分ビルドで GetActionResult を繰り返し呼び出すことはありません。この値は、サーバーがダイジェストを返すタイミングと Bazel がダイジェストを受信するタイミングの間にギャップがあるため、実際の TTL より少し小さい値に設定する必要があります。
タグ:execution
--experimental_remote_capture_corrupted_outputs=<a path>
デフォルト: 説明を参照- 破損した出力のキャプチャ先となるディレクトリへのパス。
--[no]experimental_remote_discard_merkle_trees
デフォルト: 「false」- true に設定すると、GetActionResult() と Execute() の呼び出し中に、入力ルートのマークルツリーのメモリ内コピーと関連する入力マッピングを破棄します。これによりメモリ使用量が大幅に削減されますが、リモート キャッシュミスや再試行時に Bazel による再計算が必要になります。
--experimental_remote_downloader=<a string>
デフォルト: 説明を参照- リモート ダウンロード プロキシとして使用する Remote Asset API エンドポイント URI。サポートされているスキーマは、grpc、grpcs(TLS が有効になっている grpcs、unix ローカル UNIX ソケット)です。スキーマが指定されていない場合、Bazel はデフォルトで grpcs になります。参照: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_downloader_local_fallback
デフォルト: 「false」- リモート ダウンローダが失敗した場合にローカル ダウンローダにフォールバックするかどうか。
--[no]experimental_remote_execution_keepalive
デフォルト: 「false」- リモート実行呼び出しにキープアライブを使用するかどうかを指定します。
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
のデフォルト: 「10」-
特定の時間枠で許容される失敗率をパーセンテージで設定します。この期間が経過するとリモート キャッシュ/エグゼキュータの呼び出しは停止します。デフォルト値は 10 です。これを 0 に設定すると、制限なしになります。
タグ:execution
--experimental_remote_failure_window_interval=<An immutable length of time.>
のデフォルト: 「60s」-
リモート リクエストの失敗率を計算する間隔。ゼロまたは負の値の場合、失敗時間は実行時間全体として計算されます。日(d)、時間(h)、分(m)、秒(s)、ミリ秒(ms)の単位を使用できます。単位を省略すると、値は秒と解釈されます。
タグ:execution
--[no]experimental_remote_mark_tool_inputs
デフォルト: 「false」- true に設定すると、Bazel はリモート エグゼキュータのツール入力として入力をマークします。これを使用して、リモート永続ワーカーを実装できます。
--[no]experimental_remote_merkle_tree_cache
デフォルト: 「false」- true に設定すると、リモート キャッシュ ヒットのチェック速度を向上させるために、マークルツリー計算がメモされます。キャッシュのメモリ フットプリントは --experimental_remote_merkle_tree_cache_size によって制御されます。
--experimental_remote_merkle_tree_cache_size=<a long integer>
のデフォルト: 「1000」- リモート キャッシュ ヒットのチェック速度を向上させるために記憶するマークルツリーの数。キャッシュは Java のソフト参照の処理に従って自動的にプルーニングされますが、設定値が大きすぎるとメモリ不足エラーが発生することがあります。0 に設定した場合、キャッシュ サイズは無制限になります。最適な値はプロジェクトの規模によって異なります。デフォルトは 1,000 です。
--[no]experimental_remote_require_cached
デフォルト: 「false」- true に設定すると、リモートで実行されるすべてのアクションがキャッシュに保存されます。そうでない場合は、ビルドが失敗します。キャッシュに保存すべきアクションがキャッシュに誤って挿入されることなく、実際にキャッシュに保存されるかどうかを確認できるため、非決定性に関する問題のトラブルシューティングに役立ちます。
--experimental_remote_scrubbing_config=<Converts to a Scrubber>
デフォルト: 説明を参照- 指定された構成ファイル(テキスト形式の ScrubbingConfig プロトコル バッファ)でのリモート キャッシュキーのスクラブを有効にします。 この機能は、異なるプラットフォームで実行されるものの、同じプラットフォームを対象とするアクション間でリモート キャッシュやディスク キャッシュの共有を容易にすることを目的としています。不適切な設定を行うと、キャッシュ エントリが誤って共有され、誤ったビルドにつながる可能性があるため、慎重に使用してください。 スクラブはアクションの実行方法には影響せず、アクションの結果を取得または保存するためにリモート/ディスク キャッシュキーがどのように計算されるかにのみ影響します。リモート実行と組み合わせて使用することはできません。スクラブ設定を変更しても、ローカル ファイルシステムや内部キャッシュに存在する出力は無効になりません。影響を受けるアクションを再実行するには、クリーンビルドが必要です。 この機能を適切に使用するには、カスタムの --host_platform を、--experimental_platform_in_output_dir(出力プレフィックスを正規化)および --compatible_strict_action_env(環境変数を正規化)とともに設定することをおすすめします。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: 「off」- リポジトリの取得に使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、「platform」に設定されている場合はプラットフォーム スレッド(OS スレッド)を使用し、「virtual」に設定されている場合は仮想スレッドを使用します。
--[no]incompatible_remote_build_event_upload_respect_no_cache
デフォルト: 「false」- 非推奨。NoOps。代わりに --remote_build_event_upload=minimal を使用してください。
--[no]incompatible_remote_downloader_send_all_headers
のデフォルト: 「true」-
複数値を持つヘッダーのすべての値を、最初のだけでなくリモート ダウンローダーに送信するかどうかを指定します。
タグ:incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root
デフォルト: 「false」-
true に設定すると、出力パスは作業ディレクトリではなく入力ルートを基準とする相対パスになります。
タグ:incompatible_change
--[no]incompatible_remote_results_ignore_disk
のデフォルト: 「true」-
No-op
タグ:incompatible_change
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
のデフォルト: 「true」-
true に設定すると、ビルド中にリモート キャッシュが blob を削除すると、Bazel は 34 ではなく新しい終了コード 39 を使用します。
タグ:incompatible_change
--[no]remote_accept_cached
のデフォルト: 「true」- リモートのキャッシュに保存されたアクションの結果を受け入れるかどうかを指定します。
--remote_build_event_upload=<all or minimal>
のデフォルト: "minimal"- 「all」に設定すると、BEP によって参照されるすべてのローカル出力がリモート キャッシュにアップロードされます。 「minimal」に設定した場合、BEP で参照されるローカル出力は、BEP の使用者にとって重要なファイル(テストログやタイミング プロファイルなど)を除き、リモート キャッシュにアップロードされません。リモート キャッシュにない場合でも、ファイルの URI には bytestream:// スキームが常に使用されます。 デフォルトは「minimal」です。
--remote_bytestream_uri_prefix=<a string>
デフォルト: 説明を参照- ビルド イベント ストリームに書き込まれる bytestream:// URI で使用されるホスト名とインスタンス名。プロキシを使用してビルドを実行するときにこのオプションを設定できます。これにより、--remote_executor と --remote_instance_name の値がリモート実行サービスの正規名に対応しなくなります。設定しない場合、デフォルトで「${hostname}/${instance_name}」になります。
--remote_cache=<a string>
デフォルト: 説明を参照- キャッシュ エンドポイントの URI。サポートされているスキーマは、http、https、grpc、grpcs(TLS を有効にした grpcs、unix(ローカル UNIX ソケット)です。スキーマが指定されていない場合、Bazel はデフォルトで grpcs になります。grpc://、http://、または unix: スキーマを指定して TLS を無効にします。https://bazel.build/remote/caching をご覧ください。
--[no]remote_cache_compression
デフォルト: 「false」- 有効にすると、zstd を使用してキャッシュ blob を圧縮/解凍します。
--remote_cache_header=<a 'name=value' assignment>
件の複数回の使用が累積される- キャッシュ リクエストに含めるヘッダーを指定します(--remote_cache_header=Name=Value)。フラグを複数回指定すると、複数のヘッダーを渡すことができます。同じ名前の複数の値は、カンマ区切りのリストに変換されます。
--remote_default_exec_properties=<a 'name=value' assignment>
件の複数回の使用が累積される-
実行プラットフォームで exec_properties が設定されていない場合に、リモート実行プラットフォームとして使用するデフォルトの exec プロパティを設定します。
タグ:affects_outputs
--remote_default_platform_properties=<a string>
のデフォルト: ""- 実行プラットフォームが remote_execution_properties を設定していない場合は、リモート実行 API に設定するデフォルトのプラットフォーム プロパティを設定します。この値は、ホスト プラットフォームがリモート実行の実行プラットフォームとして選択されている場合にも使用されます。
--remote_download_regex=<a string>
件の複数回の使用が累積される-
指定された正規表現に一致するアーティファクトを Bazel に強制的にダウンロードします。バイトのないビルド(または内部の同等のもの)と組み合わせて使用し、ローカルで必要になる可能性がある特定のアーティファクト(IDE のサポートなど)をクライアントがリクエストできるようにします。このフラグを繰り返すことで、複数の正規表現を指定できます。
タグ:affects_outputs
--remote_downloader_header=<a 'name=value' assignment>
件の複数回の使用が累積される- リモート ダウンローダ リクエストに含めるヘッダーを指定します(--remote_downloader_header=Name=Value)。フラグを複数回指定すると、複数のヘッダーを渡すことができます。同じ名前の複数の値は、カンマ区切りのリストに変換されます。
--remote_exec_header=<a 'name=value' assignment>
件の複数回の使用が累積される- 実行リクエストに含めるヘッダーを指定します(--remote_exec_header=Name=Value)。フラグを複数回指定すると、複数のヘッダーを渡すことができます。同じ名前の複数の値は、カンマ区切りのリストに変換されます。
--remote_execution_priority=<an integer>
のデフォルト: 「0」- リモートで実行されるアクションの相対的な優先度。特定の優先度の値のセマンティクスは、サーバーによって異なります。
--remote_executor=<a string>
デフォルト: 説明を参照- リモート実行エンドポイントの HOST または HOST:PORT。サポートされているスキーマは、grpc、grpcs(TLS が有効になっている grpcs、unix ローカル UNIX ソケット)です。スキーマが指定されていない場合、Bazel はデフォルトで grpcs になります。TLS を無効にするには、grpc:// または unix: スキーマを指定します。
--remote_grpc_log=<a path>
デフォルト: 説明を参照- 指定する場合、gRPC 呼び出しに関する詳細を記録するファイルのパス。このログは、シリアル化された com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry protobuf のシーケンスで構成されており、各メッセージの前には、次のシリアル化された protobuf メッセージのサイズを示す varint が付加されています。これは、メソッド LogEntry.writeDelimitedTo(OutputStream) によって実行されます。
--remote_header=<a 'name=value' assignment>
件の複数回の使用が累積される- リクエストに含めるヘッダーを指定します(--remote_header=Name=Value)。フラグを複数回指定すると、複数のヘッダーを渡すことができます。同じ名前の複数の値は、カンマ区切りのリストに変換されます。
--remote_instance_name=<a string>
のデフォルト: ""- リモート実行 API で instance_name として渡す値。
--[no]remote_local_fallback
デフォルト: 「false」- リモート実行が失敗した場合に、スタンドアロンのローカル実行戦略にフォールバックするかどうか。
--remote_local_fallback_strategy=<a string>
のデフォルト: 「local」- NoOps、非推奨。詳細については、https://github.com/bazelbuild/bazel/issues/7480 をご覧ください。
--remote_max_connections=<an integer>
のデフォルト: 「100」-
リモート キャッシュ/エグゼキュータへの同時接続の最大数を制限します。デフォルト値は 100 です。これを 0 に設定すると、制限なしになります。HTTP リモート キャッシュの場合、1 つの TCP 接続で一度に 1 つのリクエストを処理できるため、Bazel では最大 --remote_max_connections の同時リクエストが可能です。gRPC リモート キャッシュ/エグゼキュータの場合、1 つの gRPC チャネルで通常 100 件以上の同時リクエストを処理できるため、Bazel では「--remote_max_connections * 100」程度の同時リクエストを実行できます。
タグ:host_machine_resource_optimizations
--remote_proxy=<a string>
デフォルト: 説明を参照- プロキシ経由でリモート キャッシュに接続します。現在、このフラグは Unix ドメイン ソケット(unix:/path/to/socket)を構成する場合にのみ使用できます。
--remote_result_cache_priority=<an integer>
のデフォルト: 「0」- リモート キャッシュに保存されるリモート アクションの相対的な優先度。特定の優先度の値のセマンティクスは、サーバーによって異なります。
--remote_retries=<an integer>
のデフォルト: 「5」- 一時的なエラーの再試行の最大回数。0 に設定した場合、再試行は無効になります。
--remote_retry_max_delay=<An immutable length of time.>
のデフォルト: 「5s」- リモートでの再試行間の最大バックオフ遅延。使用できる単位は、日(d)、時間(h)、分(m)、秒(s)、ミリ秒(ms)です。単位を省略すると、値は秒と解釈されます。
--remote_timeout=<An immutable length of time.>
のデフォルト: 「60s」- リモート実行およびキャッシュ呼び出しを待機する最大時間。REST キャッシュの場合、これは接続タイムアウトと読み取りタイムアウトの両方です。使用できる単位は、日(d)、時間(h)、分(m)、秒(s)、ミリ秒(ms)です。単位を省略すると、値は秒と解釈されます。
--[no]remote_upload_local_results
のデフォルト: 「true」- リモート キャッシュがサポートされていて、ユーザーにその権限が付与されている場合、ローカルで実行したアクションの結果をリモート キャッシュにアップロードするかどうかを指定します。
--[no]remote_verify_downloads
のデフォルト: 「true」- true に設定すると、Bazel はリモート ダウンロードのすべてのハッシュ合計を計算し、想定値と一致しない場合、リモート キャッシュに保存された値を破棄します。
- その他のカテゴリ(特に分類されていないもの):
--[no]allow_analysis_cache_discard
のデフォルト: 「true」-
ビルドシステムの変更により分析キャッシュを破棄する場合、このオプションを false に設定すると、ビルドを続行せずに bazel が終了します。「discard_analysis_cache」も設定されている場合、このオプションは無視されます。
タグ:eagerness_to_exit
--auto_output_filter=<none, all, packages or subpackages>
のデフォルト: 「なし」- --output_filter が指定されていない場合、このオプションの値に基づいてフィルタが自動的に作成されます。指定できる値は、「none」(フィルタなし / すべてを表示)、「all」(すべてフィルタ / 何も表示せず)、「packages」(Blaze コマンドラインで言及されているパッケージのルールからの出力を含む)、「subpackages」(例: 「packages」、ただしサブパッケージも含む)です。「packages」と「subpackages」の値の場合、//java/foo と //javatests/foo は 1 つのパッケージとして扱われます)。
--[no]build_manual_tests
デフォルト: 「false」- 「manual」タグが付いたテスト ターゲットを強制的にビルドします。「手動」テストは処理から除外されます。このオプションは、ビルドを強制します(実行はされません)。
--build_tag_filters=<comma-separated list of options>
のデフォルト: ""- タグのカンマ区切りリストを指定します。必要に応じて各タグの前に「-」を付けると、除外するタグを指定できます。含まれるタグが 1 つ以上含み、除外されたタグを含まないターゲットのみが構築されます。このオプションは、「test」コマンドで実行される一連のテストには影響しません。「--test_tag_filters」などのテスト フィルタリング オプションによって決まります。
--[no]build_tests_only
デフォルト: 「false」- 指定すると、*_test ルールと test_suite ルールのみがビルドされ、コマンドラインで指定された他のターゲットは無視されます。デフォルトでは、リクエストされたものがすべてビルドされます。
--combined_report=<none or lcov>
のデフォルト: 「なし」- 目的の累積カバレッジ レポートタイプを指定します。現時点では LCOV のみがサポートされています。
--[no]compile_one_dependency
デフォルト: 「false」- 引数ファイルの単一の依存関係をコンパイルします。これは、IDE でソースファイルの構文チェックを行う場合に便利です。たとえば、編集/ビルド/テストのサイクルでできるだけ早くエラーを検出するために、ソースファイルに依存する単一のターゲットを再ビルドします。この引数は、フラグ以外のすべての引数の解釈方法に影響します。ビルドのターゲットになるのではなく、ソースファイル名になります。ソースファイル名ごとに、そのファイル名に依存する任意のターゲットがビルドされます。
--deleted_packages=<comma-separated list of package names>
件の複数回の使用が累積される- パッケージ名のカンマ区切りリスト。パッケージパス上のどこかに表示されていても、ビルドシステムによって存在しないと判断されます。 既存のパッケージ「x」のサブパッケージ「x/y」を削除する場合は、このオプションを使用します。たとえば、クライアントで x/y/BUILD を削除した後、別の package_path エントリによってラベル「//x:y/z」が見つかると、ビルドシステムからエラーが発生することがあります。--deleted_packages x/y を指定すると、この問題を回避できます。
--[no]discard_analysis_cache
デフォルト: 「false」- 分析フェーズが完了したら、すぐに分析キャッシュを破棄します。メモリ使用量は約 10% 削減されますが、それ以上の増分ビルドは遅くなります。
--disk_cache=<a path>
デフォルト: 説明を参照- Bazel がアクションとアクション出力の読み取りと書き込みを行うことができるディレクトリのパス。ディレクトリが存在しない場合は作成されます。
--embed_label=<a one-line string>
のデフォルト: ""- ソース管理のリビジョンまたはリリースラベルをバイナリに埋め込む
--execution_log_binary_file=<a path>
デフォルト: 説明を参照- 実行されたスポーンを、src/main/protobuf/spawn.proto に沿って区切りの Spawn proto としてこのファイルに記録します。関連フラグ: --execution_log_json_file(テキスト JSON 形式、相互に排他的)、--execution_log_sort(実行ログを並べ替えるかどうか)、--subcommands(ターミナル出力にサブコマンドを表示する場合)。
--execution_log_json_file=<a path>
デフォルト: 説明を参照- 実行されたスポーンを、src/main/protobuf/spawn.proto に従って、区切りの Spawn proto の JSON 表現としてこのファイルに記録します。関連フラグ: --execution_log_binary_file(バイナリ protobuf 形式、相互に排他的)、--execution_log_sort(実行ログを並べ替えるかどうか)、--subcommands(ターミナル出力にサブコマンドを表示する場合)。
--[no]execution_log_sort
のデフォルト: 「true」- 呼び出し間でログを簡単に比較できるように、実行ログを並べ替えるかどうか。false に設定すると、非決定的な実行順序でログが生成されますが、呼び出しの終了時に CPU とメモリの大幅な使用量が増える可能性があります。
--[no]expand_test_suites
のデフォルト: 「true」-
分析前に、test_suite ターゲットをその構成要素テストに展開します。このフラグがオン(デフォルト)の場合、テストスイートに属するテストにネガティブ ターゲット パターンが適用されます。そうでない場合、適用されません。このフラグをオフにすると、コマンドラインでトップレベルの要素が適用されると、test_suite ターゲットを分析できます。
タグ:loading_and_analysis
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
のデフォルト: ""- アスペクトを優先して非推奨となりました。extra_actions をスケジュールするターゲットのセットをフィルタします。
--[no]experimental_extra_action_top_level_only
デフォルト: 「false」- アスペクトを優先して非推奨となりました。最上位のターゲットに対してのみ、extra_actions をスケジュールします。
--experimental_spawn_scheduler
-
ローカルとリモートでアクションを並列に実行することで、動的実行を有効にします。Bazel は各アクションをローカルとリモートで生成し、最初に完了したアクションを選択します。アクションがワーカーをサポートしている場合、ローカル アクションは永続的なワーカーモードで実行されます。個々のアクション ニーモニックの動的実行を有効にするには、代わりに「--internal_spawn_scheduler」と「--strategy=<mnemonic>=dynamic」フラグを使用します。
展開後:
--internal_spawn_scheduler
--spawn_strategy=dynamic
--[no]incompatible_dont_use_javasourceinfoprovider
デフォルト: 「false」-
No-op
タグ:incompatible_change
--local_termination_grace_seconds=<an integer>
のデフォルト: 「15」- タイムアウトによりローカル プロセスを終了してから強制的にシャットダウンするまでの待機時間。
--override_repository=<an equals-separated mapping of repository name to path>
件の複数回の使用が累積される- リポジトリは、<repository name>=<path> という形式のローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスがそのまま使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--package_path=<colon-separated list of options>
のデフォルト: 「%workspace%」- パッケージを検索する場所をコロンで区切ったリスト。「%workspace%」で始まる要素は、それを含むワークスペースからの相対値です。省略するか空の場合、デフォルトは「bazel info default-package-path」の出力です。
--[no]show_loading_progress
のデフォルト: 「true」- 有効にすると、Bazel から「Loading package:」というメッセージが表示されます。
--test_lang_filters=<comma-separated list of options>
のデフォルト: ""- テスト言語のカンマ区切りリストを指定します。各言語の前に「-」を付けることで、除外する言語を指定できます(省略可)。指定した言語で記述されたテスト ターゲットのみが検出されます。各言語に使用する名前は、*_test ルールの言語接頭辞と同じにする必要があります(「cc」、「java」、「py」など)。このオプションは、--build_tests_only の動作とテストコマンドに影響します。
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
のデフォルト: ""- テストサイズのカンマ区切りリストを指定します。必要に応じて各サイズの先頭に「-」を付けると、除外するサイズを指定できます。含まれるサイズが 1 つ以上含まれ、除外したサイズが含まれていないテスト ターゲットのみが検出されます。このオプションは、--build_tests_only の動作とテストコマンドに影響します。
--test_tag_filters=<comma-separated list of options>
のデフォルト: ""- テストタグのカンマ区切りリストを指定します。必要に応じて各タグの前に「-」を付けると、除外するタグを指定できます。含まれるタグが 1 つ以上含み、除外されたタグを含まないテスト ターゲットのみが検出されます。このオプションは、--build_tests_only の動作とテストコマンドに影響します。
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
のデフォルト: ""- テストのタイムアウトのカンマ区切りリストを指定します。必要に応じて、各タイムアウトの前に「-」を付けると、除外するタイムアウトを指定できます。含まれるタイムアウトが 1 つ以上含まれ、除外されたタイムアウトを含まないテスト ターゲットのみが検出されます。このオプションは、--build_tests_only の動作とテストコマンドに影響します。
--workspace_status_command=<path>
のデフォルト: ""- ワークスペースに関するステータス情報を Key-Value ペアの形式で提供する、ビルドの開始時に呼び出されるコマンド。完全な仕様については、ユーザーズマニュアルをご覧ください。例については、 tools/buildstamp/get_workspace_status をご覧ください。
- ビルド実行を制御するオプション:
--[no]check_up_to_date
デフォルト: 「false」-
ビルドは実行せず、ビルドが最新かどうか確認してください。すべてのターゲットが最新の状態であれば、ビルドは正常に完了します。実行する必要があるステップがあるとエラーが報告され、ビルドは失敗します。
タグ:execution
--[no]experimental_inprocess_symlink_creation
デフォルト: 「false」-
直接ファイル システム呼び出しを行ってシンボリック リンク ツリーを作成するかどうか
タグ:loading_and_analysis
、execution
、experimental
--[no]experimental_persistent_aar_extractor
デフォルト: 「false」-
ワーカーを使用して永続 AAR エクストラクタを有効にします。
タグ:execution
--[no]experimental_remotable_source_manifests
デフォルト: 「false」-
ソース マニフェストのアクションをリモート可能にするかどうか
タグ:loading_and_analysis
、execution
、experimental
--[no]experimental_split_coverage_postprocessing
デフォルト: 「false」-
true の場合、Bazel は新しい Spawn でテストのためにカバレッジの後処理を実行します。
タグ:execution
--[no]experimental_split_xml_generation
のデフォルト: 「true」-
このフラグが設定され、テスト アクションで test.xml ファイルが生成されない場合、Bazel は別のアクションを使用して、テストログを含むダミーの test.xml ファイルを生成します。それ以外の場合、Bazel はテスト アクションの一部として test.xml を生成します。
タグ:execution
--[no]experimental_strict_fileset_output
デフォルト: 「false」-
このオプションを有効にすると、ファイルセットはすべての出力アーティファクトを通常のファイルとして扱います。ディレクトリを移動したり、シンボリック リンクの影響を受けたりすることはありません。
タグ:execution
--[no]experimental_use_semaphore_for_jobs
デフォルト: 「false」-
true に設定すると、さらにセマフォを使用して同時実行ジョブの数を制限します。
タグ:host_machine_resource_optimizations
、execution
--genrule_strategy=<comma-separated list of options>
のデフォルト: ""-
genrules の実行方法を指定します。このフラグは段階的に廃止される予定です。代わりに、すべてのアクションを制御するには --spawn_strategy=<value> を使用し、genrules のみを制御するには --strategy=Genrule=<value> を使用します。
タグ: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"-
実行するジョブの数。整数またはキーワード ("auto", "HOST_CPUS", "HOST_RAM") を取り、必要に応じて演算([-|*]<float>)を続けます。例:"auto"、"HOST_CPUS*.5" となります。値は 1 ~ 5,000 にする必要があります。2,500 を超える値は、メモリの問題を引き起こす可能性があります。「auto」は、ホストリソースに基づいて妥当なデフォルトを計算します。
タグ:host_machine_resource_optimizations
、execution
--[no]keep_going
[-k
] default: "false"-
エラー発生後は、できるだけ続行してください。失敗したターゲットとそれに依存するターゲットは分析できませんが、これらのターゲットの他の前提条件は分析できます。
タグ:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
のデフォルト: "auto"-
読み込み/分析フェーズに使用する並列スレッドの数。整数またはキーワード("auto"、"HOST_CPUS"、"HOST_RAM")を受け取ります。その後に必要に応じて演算([-|*]<float>)が続きます。例:"auto"、"HOST_CPUS*.5" となります。「auto」は、ホストリソースに基づいて妥当なデフォルトを設定します。1 以上の値を指定してください。
タグ:bazel_internal_configuration
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
のデフォルト: ""-
アクションのニーモニックに基づいて、アクションの実行情報からキーを追加または削除します。実行情報をサポートするアクションにのみ適用されます。Genrule、CppCompile、Javac、StarlarkAction、TestRunner など、多くの一般的なアクションが実行情報をサポートしています。複数の値を指定する場合、多くの正規表現が同じニーモニックに適用される可能性があるため、順序が重要です。構文: "regex=[+-]key,regex=[+-]key,..."。
例: '.*=+x,.*=-y,.*=+z' は、すべてのアクションの実行情報に「x」と「z」を追加し、実行情報から「y」を削除します。
「Genrule=+requires-x」は、すべての Genrule アクションの実行情報に「requires-x」を追加します。
「(?!Genrule).*=-requires-x」は、Genrule 以外のすべてのアクションの実行情報から「requires-x」を削除します。
タグ:execution
、affects_outputs
、loading_and_analysis
--persistent_android_dex_desugar
-
ワーカーを使用して、永続的な Android dex および desugar アクションを有効にします。
次のように展開します。
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
タグ:host_machine_resource_optimizations
、execution
--persistent_android_resource_processor
-
ワーカーを使用して、永続的な Android リソース プロセッサを有効にします。
次のように展開:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_desugar
-
ワーカーを使用して、永続的な多重化された Android dex アクションと desugar アクションを有効にします。
展開先:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
タグ:host_machine_resource_optimizations
、execution
--persistent_multiplex_android_resource_processor
-
ワーカーを使用して、永続的な多重化された Android リソース プロセッサを有効にします。
次のように拡張:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
-
永続的な多重化 Android ツール(dex 変換、脱糖、リソース処理)を有効にします。
次のように展開します。
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
タグ:host_machine_resource_optimizations
、execution
--[no]skip_incompatible_explicit_targets
デフォルト: 「false」-
コマンドラインに明示的にリストされている互換性のないターゲットをスキップします。デフォルトでは、このようなターゲットをビルドするとエラーが発生しますが、このオプションを有効にすると通知なくスキップされます。参照: https://bazel.build/extending/platforms#skipping-compatibility-targets
タグ:loading_and_analysis
--spawn_strategy=<comma-separated list of options>
のデフォルト: ""-
生成アクションのデフォルトの実行方法を指定します。優先度が高い方から低い方の戦略のカンマ区切りリストを指定できます。Bazel は、アクションごとに、そのアクションを実行できる優先度が最も高い戦略を選択します。デフォルト値は「remote,worker,sandboxed,local」です。詳細については、https://blog.bazel.build/2019/06/19/list-strategy.html をご覧ください。
タグ:execution
--strategy=<a '[name=]value1[,..,valueN]' assignment>
件の複数回の使用が累積される-
他のスポーン アクションのコンパイルを配布する方法を指定します。優先度が高い方から低い方の戦略のカンマ区切りリストを指定できます。Bazel は、アクションごとに、そのアクションを実行できる優先度が最も高い戦略を選択します。デフォルト値は「remote,worker,sandboxed,local」です。このフラグは、--spawn_strategy(および mnemonic Genrule で使用する場合は --genrule_strategy)によって設定された値をオーバーライドします。詳細については、https://blog.bazel.build/2019/06/19/list-strategy.html をご覧ください。
タグ:execution
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
件の複数回の使用が累積される-
特定の regex_filter と一致する説明を持つ生成アクションを実行するために使用する Spawn 戦略をオーバーライドします。regex_filter マッチングの詳細については、--per_file_copt をご覧ください。説明に一致する最後の regex_filter が使用されます。このオプションは、戦略を指定する他のフラグをオーバーライドします。例: --strategy_regexp=//foo.*\.cc,-//foo/bar=local は、その説明が //foo.*.cc に一致し、//foo/bar には一致しない場合に、ローカル戦略を使用してアクションを実行することを意味します。例: --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed の場合、「local」戦略を使用して「Compiling //foo/bar/baz」が実行されますが、順序を逆にすると「sandboxed」で実行されます。
タグ:execution
--[no]use_target_platform_for_tests
デフォルト: 「false」-
true の場合、Bazel はテスト実行グループではなく、ターゲット プラットフォームを使用してテストを実行します。
タグ:execution
- アクションの実行に使用するツールチェーンを構成するオプション:
--android_compiler=<a string>
デフォルト: 説明を参照-
Android ターゲット コンパイラ。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--android_crosstool_top=<a build target label>
のデフォルト: 「//external:android/crosstool」-
Android ビルドに使用される C++ コンパイラの場所。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
、loses_incremental_state
--android_grte_top=<a label>
デフォルト: 説明を参照-
Android ターゲット grte_top。
タグ:changes_inputs
、loading_and_analysis
、loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
のデフォルト: 「android」-
android_binary ルールに使用するマニフェスト マージを選択します。以前のマージから Android マニフェスト マージに移行するためのフラグ。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--android_platforms=<a build target label>
のデフォルト: ""-
android_binary ターゲットが使用するプラットフォームを設定します。複数のプラットフォームが指定されている場合、バイナリはファット APK になります。これには、指定した各ターゲット プラットフォームのネイティブ バイナリが含まれます。
タグ:changes_inputs
、loading_and_analysis
、loses_incremental_state
--android_sdk=<a build target label>
のデフォルト: "@bazel_tools//tools/android:sdk"-
Android アプリのビルドに使用する Android SDK/プラットフォームを指定します。
タグ:changes_inputs
、loading_and_analysis
、loses_incremental_state
--apple_crosstool_top=<a build target label>
のデフォルト: "@bazel_tools//tools/cpp:ツールチェーン"-
Apple と Objc のルールとその依存関係で使用される crosstool パッケージのラベル。
タグ:loses_incremental_state
、changes_inputs
--cc_output_directory_tag=<a string>
のデフォルト: ""-
構成ディレクトリに追加する接尾辞を指定します。
タグ:affects_outputs
--compiler=<a string>
デフォルト: 説明を参照-
ターゲットのコンパイルに使用する C++ コンパイラ。
タグ:loading_and_analysis
、execution
--coverage_output_generator=<a build target label>
のデフォルト: "@bazel_tools//tools/test:lcov_merger"-
未処理のカバレッジ レポートの後処理に使用されるバイナリの場所。これは現在は、単一のファイル(バイナリ)を含むファイル グループである必要があります。デフォルトは「//tools/test:lcov_merger」です。
タグ:changes_inputs
、affects_outputs
、loading_and_analysis
--coverage_report_generator=<a build target label>
デフォルト: "@bazel_tools//tools/test:coverage_report_generator"-
カバレッジ レポートの生成に使用されるバイナリの場所。これは現在は、単一のファイル(バイナリ)を含むファイル グループである必要があります。デフォルトは「//tools/test:coverage_report_generator」です。
タグ:changes_inputs
、affects_outputs
、loading_and_analysis
--coverage_support=<a build target label>
デフォルト: "@bazel_tools//tools/test:coverage_support"-
コード カバレッジを収集するすべてのテスト アクションの入力で必要となるサポート ファイルの場所。デフォルトは「//tools/test:coverage_support」です。
タグ:changes_inputs
、affects_outputs
、loading_and_analysis
--crosstool_top=<a build target label>
のデフォルト: "@bazel_tools//tools/cpp:ツールチェーン"-
C++ コードのコンパイルに使用されるクロスツール パッケージのラベル。
タグ:loading_and_analysis
、changes_inputs
、affects_outputs
--custom_malloc=<a build target label>
デフォルト: 説明を参照-
カスタムの malloc 実装を指定します。この設定は、ビルドルールの malloc 属性をオーバーライドします。
タグ:changes_inputs
、affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
件の複数回の使用が累積される-
正規表現のカンマ区切りのリスト。接頭辞として -(負の式)を付けることもできます。正規表現は、カンマ区切りの制約値ターゲットのリストに「=」を代入します。ターゲットが負の式と一致せず、少なくとも 1 つの正の式と一致した場合、制約値を実行制約として宣言した場合と同様に、ツールチェーンの解決が実行されます。例: //demo,-test=@platforms//cpus:x86_64 を指定すると、//demo の下のすべてのターゲットに 'x86_64' が追加されます。ただし、名前に「test」が含まれるものは除きます。
タグ:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
デフォルト: 「false」-
設定した場合は、すべての Xcode アクションに "requires-xcode:{version}" 実行要件を追加します。xcode バージョンにハイフン付きのラベルがある場合は、「requires-xcode-label:{version_label}」実行要件も追加します。
タグ:loses_incremental_state
、loading_and_analysis
、execution
--[no]experimental_prefer_mutual_xcode
のデフォルト: 「true」-
true の場合、ローカルとリモートの両方で利用可能な最新の Xcode を使用します。false の場合、または相互利用可能なバージョンがない場合は、xcode-select で選択したローカルの Xcode バージョンを使用します。
タグ:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
のデフォルト: ""-
アクションを実行するための実行プラットフォームとして利用可能なプラットフォーム。プラットフォームは、正確なターゲットで、またはターゲット パターンとして指定できます。これらのプラットフォームは、register_execution_platforms() によって WORKSPACE ファイルで宣言されたプラットフォームより先に検討されます。このオプションは 1 回だけ設定できます。後のインスタンスは以前のフラグ設定をオーバーライドします。
タグ:execution
--extra_toolchains=<comma-separated list of options>
件の複数回の使用が累積される-
ツールチェーンの解決時に考慮されるツールチェーン ルール。ツールチェーンは正確なターゲットで指定することも、ターゲット パターンとして指定することもできます。これらのツールチェーンは、register_chains() によって WORKSPACE ファイルで宣言されたツールチェーンより先に考慮されます。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
--grte_top=<a label>
デフォルト: 説明を参照-
チェックインされた libc ライブラリのラベル。デフォルト値はクロスツール ツールチェーンによって選択されるため、オーバーライドする必要はほとんどありません。
タグ:action_command_lines
、affects_outputs
--host_compiler=<a string>
デフォルト: 説明を参照-
ホスト コンパイルに使用する C++ コンパイラ。--host_crosstool_top が設定されていない場合は無視されます。
タグ:loading_and_analysis
、execution
--host_crosstool_top=<a build target label>
デフォルト: 説明を参照-
デフォルトでは、exec 構成にも --crosstool_top オプションと --compiler オプションが使用されます。このフラグを指定すると、Bazel は指定された Crosstool_top に対してデフォルトの libc とコンパイラを使用します。
タグ:loading_and_analysis
、changes_inputs
、affects_outputs
--host_grte_top=<a label>
デフォルト: 説明を参照-
指定すると、実行構成の libc 最上位ディレクトリ(--grte_top)がオーバーライドされます。
タグ:action_command_lines
、affects_outputs
--host_platform=<a build target label>
デフォルト: "@local_config_platform//:host"-
ホストシステムを記述するプラットフォーム ルールのラベル。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
のデフォルト: 「true」-
true の場合、Bazel は c++ ツールチェーンの「ホスト」機能と「非ホスト」機能を有効にしません(詳しくは、https://github.com/bazelbuild/bazel/issues/7407 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
のデフォルト: 「true」-
ツールチェーン解決を使用して、Android ルール用の Android SDK(Starlark およびネイティブ)を選択します
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
デフォルト: 「false」-
ツールチェーン解決を使用して、Apple のルール(Starlark とネイティブ)用の Apple SDK を選択します。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
のデフォルト: 「true」-
true の場合、Bazel は lto インデックス コマンドラインに C++ リンク アクション コマンドラインを再利用しません(詳しくは、https://github.com/bazelbuild/bazel/issues/6791 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_remove_legacy_whole_archive
のデフォルト: 「true」-
true の場合、Bazel は、デフォルトでライブラリの依存関係全体をアーカイブとしてリンクしません(移行手順については、https://github.com/bazelbuild/bazel/issues/7362 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_require_ctx_in_configure_features
のデフォルト: 「true」-
true の場合、Bazel では、cc_common.configure_features で「setIamPolicy」パラメータが必要になります(詳しくは、https://github.com/bazelbuild/bazel/issues/7793 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
-
ツールチェーンでサポートされている場合は、インターフェース共有オブジェクトを使用します。現在、この設定はすべての ELF ツールチェーンでサポートされています。
タグ:loading_and_analysis
、affects_outputs
、affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
iOS アプリのビルドに使用する iOS SDK のバージョンを指定します。指定しない場合は、デフォルトの iOS SDK バージョン「xcode_version」を使用します。
タグ:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
macOS アプリケーションのビルドに使用する macOS SDK のバージョンを指定します。指定しない場合は、デフォルトの macOS SDK バージョン「xcode_version」を使用します。
タグ:loses_incremental_state
--minimum_os_version=<a string>
デフォルト: 説明を参照-
コンパイルの対象とする最小 OS バージョン。
タグ:loading_and_analysis
、affects_outputs
--platform_mappings=<a relative path>
のデフォルト: ""-
プラットフォームが設定されていない場合は使用するプラットフォーム、すでにプラットフォームが存在する場合は設定するフラグを記述するマッピング ファイルの場所。メイン ワークスペースのルートからの相対パスにする必要があります。デフォルトは「platform_mappings」(ワークスペースのルートの直下にあるファイル)に設定されています。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
--platforms=<a build target label>
のデフォルト: ""-
現在のコマンドのターゲット プラットフォームを記述するプラットフォーム ルールのラベル。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
--python2_path=<a string>
デフォルト: 説明を参照-
非推奨、No-op。「--compatible_use_python_chains」により無効になります。
タグ:no_op
、deprecated
--python3_path=<a string>
デフォルト: 説明を参照-
非推奨、No-op。「--compatible_use_python_chains」により無効になります。
タグ:no_op
、deprecated
--python_path=<a string>
デフォルト: 説明を参照-
ターゲット プラットフォームで Python ターゲットを実行するために呼び出される Python インタープリタの絶対パス。非推奨。--compatible_use_python_ツールチェーン s によって無効にされています。
タグ:loading_and_analysis
、affects_outputs
--python_top=<a build target label>
デフォルト: 説明を参照-
ターゲット プラットフォームで Python ターゲットを実行するために呼び出される Python インタープリタを表す py_runtime のラベル。非推奨。--compatible_use_python_ツールチェーン s によって無効にされています。
タグ:loading_and_analysis
、affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
tvOS アプリのビルドに使用する tvOS SDK のバージョンを指定します。指定しない場合は、デフォルトの tvOS SDK バージョン「xcode_version」を使用します。
タグ:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
watchOS アプリのビルドに使用する watchOS SDK のバージョンを指定します。指定しない場合は、「xcode_version」のデフォルトの watchOS SDK バージョンを使用します。
タグ:loses_incremental_state
--xcode_version=<a string>
デフォルト: 説明を参照-
指定すると、指定したバージョンの Xcode が関連するビルド アクションに使用されます。指定しない場合は、エグゼキュータのデフォルト バージョンの Xcode を使用します。
タグ:loses_incremental_state
--xcode_version_config=<a build target label>
デフォルト: "@bazel_tools//tools/cpp:host_xcodes"-
ビルド構成で Xcode バージョンの選択に使用される xcode_config ルールのラベル。
タグ:loses_incremental_state
、loading_and_analysis
- コマンドの出力を制御するオプション:
--[no]apple_generate_dsym
デフォルト: 「false」-
デバッグ シンボル(.dSYM)ファイルを生成するかどうかを指定します。
タグ:affects_outputs
、action_command_lines
--[no]build
のデフォルト: 「true」-
ビルドを実行します。この動作は通常の動作です。--nobuild を指定すると、ビルド アクションを実行する前にビルドが停止し、パッケージの読み込みフェーズと分析フェーズが正常に完了した場合はゼロが返されます。このモードは、これらのフェーズをテストする場合に役立ちます。
タグ:execution
、affects_outputs
--[no]build_runfile_links
のデフォルト: 「true」-
true の場合、すべてのターゲットに runfile のシンボリック リンク フォレストをビルドします。false の場合、ローカル アクション、テスト、または実行コマンドで必要な場合にのみ書き込みます。
タグ:affects_outputs
--[no]build_runfile_manifests
のデフォルト: 「true」-
true の場合、すべてのターゲットの runfile マニフェストを書き込みます。false の場合は省略します。false の場合、ローカルテストは実行できません。
タグ:affects_outputs
--[no]build_test_dwp
デフォルト: 「false」-
有効にすると、C++ テストを静的かつ分割してビルドするときに、テストバイナリの .dwp ファイルも自動的にビルドされます。
タグ:loading_and_analysis
、affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
のデフォルト: ".pb.h"-
cc_proto_library が作成するヘッダー ファイルの接尾辞を設定します。
タグ:affects_outputs
、loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
のデフォルト: 「.pb.cc」-
cc_proto_library が作成するソースファイルの接尾辞を設定します。
タグ:affects_outputs
、loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
デフォルト: 「false」-
proto_library の代替 Java API バージョンに対して、追加のアクションを実行します。
タグ:affects_outputs
、loading_and_analysis
、experimental
--[no]experimental_proto_extra_actions
デフォルト: 「false」-
proto_library の代替 Java API バージョンに対して、追加のアクションを実行します。
タグ:affects_outputs
、loading_and_analysis
、experimental
--[no]experimental_save_feature_state
デフォルト: 「false」-
有効な機能とリクエストされた機能の状態を、コンパイルの出力として保存します。
タグ:affects_outputs
、experimental
--[no]experimental_use_validation_aspect
デフォルト: 「false」-
アスペクトを使用して検証アクションを実行するかどうかを指定します(テストとの並列処理のため)。
タグ:execution
、affects_outputs
--fission=<a set of compilation modes>
(デフォルト): 「no」-
C++ のコンパイルとリンクに分断を使用するコンパイル モードを指定します。{'fastbuild'、'dbg'、'opt'}、またはすべてのモードを有効にする場合は 'yes'、すべてのモードを無効にする場合は 'no' を任意に組み合わせることができます。
タグ:loading_and_analysis
、action_command_lines
、affects_outputs
--[no]incompatible_always_include_files_in_data
のデフォルト: 「true」-
true の場合、ネイティブ ルールは、データ依存関係の <code>DefaultInfo.files</code> を runfile に追加します。これは Starlark ルールの推奨動作(https://bazel.build/extending/rules#runfiles_features_to_avoid)と同じです。
タグ:affects_outputs
、incompatible_change
--[no]legacy_external_runfiles
のデフォルト: 「true」-
true の場合、(.runfiles/repo に加えて).runfiles/wsname/external/repo の下に外部リポジトリの runfile シンボリック リンク フォレストを作成します。
タグ:affects_outputs
--[no]objc_generate_linkmap
デフォルト: 「false」-
リンクマップ ファイルを生成するかどうかを指定します。
タグ:affects_outputs
--output_groups=<comma-separated list of options>
件の複数回の使用が累積される-
出力グループ名のカンマ区切りのリスト。それぞれに接頭辞として「+」または「-」が付加されます。「+」で始まるグループはデフォルトの出力グループに追加され、「-」で始まるグループはデフォルトのセットから削除されます。接頭辞が付加されていないグループが少なくとも 1 つある場合、出力グループのデフォルト セットは省略されます。たとえば、--output_groups=+foo,+bar はデフォルト セット foo と bar を結合したものをビルドし、--output_groups=foo,bar は foo と bar のみがビルドされるようにデフォルト セットをオーバーライドします。
タグ:execution
、affects_outputs
--[no]run_validations
のデフォルト: 「true」-
ビルドの一環として検証アクションを実行するかどうかを指定します。https://bazel.build/extending/rules#validation_actions をご覧ください。
タグ:execution
、affects_outputs
--[no]save_temps
デフォルト: 「false」-
設定すると、gcc からの一時的な出力が保存されます。これには、.s ファイル(アセンブラ コード)、.i ファイル(前処理された C)、.ii ファイル(前処理された C++)が含まれます。
タグ:affects_outputs
- 目的の出力をユーザーが構成できるオプション(その存在とは無関係に、目的の出力に影響を与えます):
--action_env=<a 'name=value' assignment with an optional value part>
件の複数回の使用が累積される-
ターゲット構成でのアクションで使用できる環境変数のセットを指定します。変数は、名前で指定することも(この場合、値は呼び出し環境から取得されます)か、または名前=値のペア(呼び出し環境とは無関係に値を設定する)で指定できます。このオプションは複数回使用できます。同じ変数に対して指定されたオプションの場合は、最新の優先対象が使用され、異なる変数のオプションが蓄積されます。
タグ:action_command_lines
--android_cpu=<a string>
のデフォルト: 「armeabi-v7a」-
Android のターゲット CPU。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--[no]android_databinding_use_androidx
のデフォルト: 「true」-
AndroidX 互換のデータ バインディング ファイルを生成する。これはデータ バインディング v2 でのみ使用されます。このフラグは no-op です。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--[no]android_databinding_use_v3_4_args
のデフォルト: 「true」-
Android databinding v2 と 3.4.0 引数を使用します。このフラグは no-op です。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--android_dynamic_mode=<off, default or fully>
のデフォルト: 「off」-
cc_binary が共有ライブラリを明示的に作成しない場合に、Android ルールの C++ 依存関係を動的にリンクするかどうかを決定します。「default」は、bazel が動的にリンクするかどうかを選択することを意味します。「Fully」は、すべてのライブラリが動的にリンクされることを意味します。「off」は、すべてのライブラリがほぼ静的モードでリンクされることを意味します。
タグ:affects_outputs
、loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
のデフォルト: "alphabetical"-
Android バイナリのマニフェスト マージツールに渡されるマニフェストの順序を設定します。ALPHABETICAL は、マニフェストが execroot からの相対パスによって並べ替えられることを意味します。ALPHABETICAL_BY_CONFIGURATION は、マニフェストが出力ディレクトリ内の構成ディレクトリを基準とする相対パスで並べ替えられることを意味します。DEPENDENCY は、各ライブラリのマニフェストがその依存関係のマニフェストの前に配置される状態でマニフェストが並べられることを意味します。
タグ:action_command_lines
、execution
--[no]android_resource_shrinking
デフォルト: 「false」- ProGuard を使用する android_binary APK のリソース圧縮を有効にします。
タグ:affects_outputs
、loading_and_analysis
--aspects=<comma-separated list of options>
件の複数回の使用が累積される- 最上位のターゲットに適用するアスペクトのカンマ区切りリスト。リストで、some_aspect が required_aspect_providers を介して必要なアスペクト プロバイダを指定する場合、some_aspect は、アドバタイズされたプロバイダが some_aspect の必要なアスペクト プロバイダを満たすアスペクト リスト内で事前に言及されたすべてのアスペクトの後に実行されます。さらに、some_aspect は required 属性で指定されたすべての必須アスペクトの後に実行されます。これにより、some_aspect がそれらのアスペクトのプロバイダの値にアクセスできるようになります。<bzl-file-label>%<aspect_name>(例: 「//tools:my_def.bzl%my_aspect」)。「my_aspect」はファイル tools/my_def.bzl の最上位の値です。
--[no]build_python_zip
のデフォルト: "auto"-
Python 実行可能ファイル zip をビルドする(Windows では実行、他のプラットフォームではオフ)
タグ:affects_outputs
--catalyst_cpus=<comma-separated list of options>
件の複数回の使用が累積される-
Apple Catalyst バイナリをビルドするアーキテクチャのカンマ区切りリスト。
タグ:loses_incremental_state
、loading_and_analysis
--[no]collect_code_coverage
デフォルト: 「false」-
指定すると、Bazel はコードをインストルメント化し(可能であればオフラインのインストルメンテーションを使用)、テスト中にカバレッジ情報を収集します。--instrumentation_filter に一致するターゲットのみが影響を受けます。通常、このオプションは直接指定しないでください。代わりに「bazelcoverage」コマンドを使用してください。
タグ:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] default: "fastbuild"-
バイナリがビルドされるモードを指定します。値: fastbuild、dbg、opt。
タグ:affects_outputs
、action_command_lines
--conlyopt=<a string>
件の複数回の使用が累積される-
C ソースファイルのコンパイル時に gcc に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--copt=<a string>
件の複数回の使用が累積される-
gcc に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--cpu=<a string>
のデフォルト: ""-
ターゲット CPU。
タグ:changes_inputs
、affects_outputs
--cs_fdo_absolute_path=<a string>
デフォルト: 説明を参照-
CSFDO プロファイル情報を使用してコンパイルを最適化します。プロファイル ファイルを含む zip ファイルの絶対パス名(未加工の LLVM プロファイル ファイルまたはインデックス登録された LLVM プロファイル ファイル)を指定します。
タグ:affects_outputs
--cs_fdo_instrument=<a string>
デフォルト: 説明を参照-
コンテキスト センシティブな FDO 計測を使用してバイナリを生成します。Clang/LLVM コンパイラでは、実行時に未加工プロファイル ファイルがダンプされるディレクトリ名も受け入れます。
タグ:affects_outputs
--cs_fdo_profile=<a build target label>
デフォルト: 説明を参照-
最適化に使用されるコンテキスト依存プロファイルを表す cs_fdo_profile。
タグ:affects_outputs
--cxxopt=<a string>
件の複数回の使用が累積される-
C++ ソースファイルのコンパイル時に gcc に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--define=<a 'name=value' assignment>
件の複数回の使用が累積される-
各 --define オプションは、ビルド変数の割り当てを指定します。
タグ:changes_inputs
、affects_outputs
--dynamic_mode=<off, default or fully>
デフォルト: 「default」-
C++ バイナリを動的にリンクするかどうかを決定します。「default」は、Bazel が動的にリンクするかどうかを選択することを意味します。「Fully」は、すべてのライブラリが動的にリンクされることを意味します。「off」は、すべてのライブラリがほぼ静的モードでリンクされることを意味します。
タグ:loading_and_analysis
、affects_outputs
--[no]enable_fdo_profile_absolute_path
のデフォルト: 「true」-
設定した場合、fdo_absolute_profile_path を使用するとエラーになります。
タグ:affects_outputs
--[no]enable_runfiles
のデフォルト: "auto"-
runfiles シンボリック リンク ツリーを有効にします。Windows ではデフォルトではオフになっており、他のプラットフォームでは無効になっています。
タグ:affects_outputs
--experimental_action_listener=<a build target label>
件の複数回の使用が累積される-
アスペクトを優先して非推奨となりました。action_listener を使用して、extra_action を既存のビルド アクションにアタッチします。
タグ:execution
、experimental
--[no]experimental_android_compress_java_resources
デフォルト: 「false」-
APK 内の Java リソースを圧縮する
タグ:affects_outputs
、loading_and_analysis
、experimental
--[no]experimental_android_databinding_v2
のデフォルト: 「true」-
Android データ バインディング v2 を使用します。このフラグは no-op です。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--[no]experimental_android_resource_shrinking
デフォルト: 「false」- ProGuard を使用する android_binary APK のリソース圧縮を有効にします。
タグ:affects_outputs
、loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
デフォルト: 「false」-
rex ツールを使用して dex ファイルを書き換える
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--[no]experimental_collect_code_coverage_for_generated_files
デフォルト: 「false」-
指定すると、Bazel は生成されたファイルの収集カバレッジ情報も生成します。
タグ:affects_outputs
--[no]experimental_convenience_symlinks
のデフォルト: 「normal」-
このフラグは、便利なシンボリック リンク(ビルド後のワークスペースに表示されるシンボリック リンク)の管理方法を制御します。指定可能な値: normal(デフォルト): 各種類の便利なシンボリック リンクが作成、削除されます。ビルドの決定に従います。
clean: すべてのシンボリック リンクを無条件に削除します。
ignore: Symlink はそのまま残ります。log_only: 「normal」が渡されたかのようにログメッセージを生成しますが、実際にはファイルシステム オペレーションは実行しません(ツールに役立ちます)。
影響を受けるのは、--symlink_prefix の現在の値によって名前が生成されるシンボリック リンクのみです。接頭辞が変更された場合、既存のシンボリック リンクはそのまま残ります。
タグ:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
デフォルト: 「false」-
このフラグは、ビルド eventConvenienceSymlinksIdentified を BuildEventProtocol に送信するかどうかを制御します。この値が true の場合、BuildEventProtocol にはコンビニエンス SymlinksIdentified のエントリがあり、ワークスペースに作成されたコンビニエンス シンボリック リンクがすべてリストされます。false の場合、BuildEventProtocol のコンビニエンス SymlinksIdentified エントリは空になります。
タグ:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
デフォルト: "-O0,-DDEBUG=1"-
これらの文字列を objc fastbuild コンパイラ オプションとして使用します。
タグ:action_command_lines
--[no]experimental_omitfp
デフォルト: 「false」-
true の場合、スタックのアンワインドに libunwind を使用し、-fomit-frame-pointer と -fasync-unwind-tables を使用してコンパイルします。
タグ:action_command_lines
、affects_outputs
、experimental
--experimental_output_paths=<off, content or strip>
のデフォルト: 「off」-
特にマルチプラットフォーム / マルチ構成のビルドで、出力ツリーのルールのどこに出力を書き込むかに使用するモデル。これは非常に試験運用中です。詳細については、https://github.com/bazelbuild/bazel/issues/6526 をご覧ください。Starlark のアクションは、キー「supports-path-mapping」を「execution_requirements」辞書に追加することで、パスマッピングにオプトインできます。
タグ:loses_incremental_state
、bazel_internal_configuration
、affects_outputs
、execution
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
件の複数回の使用が累積される-
各エントリは label=value の形式にする必要があります。label はプラットフォームを指し、values は出力パスで使用する省略名です。--experimental_platform_in_output_dir が true の場合にのみ使用されます。命名の優先度が最も高い。
タグ:affects_outputs
、experimental
--[no]experimental_platform_in_output_dir
デフォルト: 「false」-
true の場合、出力ディレクトリ名に CPU ではなくターゲット プラットフォームの短縮名が使用されます。正確なスキームは試験運用中で、変更される可能性があります。まず、--platforms オプションに値が 1 つしかないというまれなケースとして、platform オプションのハッシュが使用されます。次に、現在のプラットフォームの略称が --experimental_override_name_platform_in_output_dir によって登録された場合は、その短縮名が使用されます。次に、--experimental_use_platforms_in_output_dir_legacy_heuristic が設定されている場合、現在のプラットフォーム ラベルに基づく略称を使用します。最後に、プラットフォーム オプションのハッシュが最後の手段として使用されます。
タグ:affects_outputs
、experimental
--[no]experimental_use_llvm_covmap
デフォルト: 「false」-
指定すると、collect_code_coverage が有効になっている場合、Bazel は gcov ではなく llvm-cov カバレッジ マップ情報を生成します。
タグ:changes_inputs
、affects_outputs
、loading_and_analysis
、experimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
のデフォルト: 「true」-
このフラグは、提案する移行またはテスト戦略の一部としてのみ使用してください。このヒューリスティックには既知の欠陥があるため、--experimental_override_name_platform_in_output_dir のみに依存するように移行することをおすすめします。
タグ:affects_outputs
、experimental
--fat_apk_cpu=<comma-separated set of options>
のデフォルト: 「armeabi-v7a」-
このオプションを設定すると、ファット APK が有効になります。これには、指定したすべてのターゲット アーキテクチャ(例:--fat_apk_cpu=x86,armeabi-v7a. このフラグを指定すると、android_binary ルールの依存関係で --android_cpu は無視されます。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--[no]fat_apk_hwasan
デフォルト: 「false」-
HWASAN 分割を作成するかどうかを指定します。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--fdo_instrument=<a string>
デフォルト: 説明を参照-
FDO インストルメンテーションを使用してバイナリを生成します。Clang/LLVM コンパイラでは、実行時に未加工プロファイル ファイルがダンプされるディレクトリ名も受け入れます。
タグ:affects_outputs
--fdo_optimize=<a string>
デフォルト: 説明を参照-
FDO プロファイル情報を使用してコンパイルを最適化します。.gcda ファイルツリーを含む zip ファイル、自動プロファイルを含む afdo ファイル、または LLVM プロファイル ファイルの名前を指定します。このフラグは、ラベルとして指定されたファイル(例: 「//foo/bar:file.afdo」で、対応するパッケージに「exports_files」ディレクティブを追加する必要が生じる場合があります)や、「fdo_profile」ターゲットを指すラベルも受け入れます。このフラグは「fdo_profile」ルールよりも優先されます。
タグ:affects_outputs
--fdo_prefetch_hints=<a build target label>
デフォルト: 説明を参照-
キャッシュ プリフェッチのヒントを使用します。
タグ:affects_outputs
--fdo_profile=<a build target label>
デフォルト: 説明を参照-
最適化に使用するプロファイルを表す fdo_profile。
タグ:affects_outputs
--features=<a string>
件の複数回の使用が累積される-
指定された機能は、ターゲット構成でビルドされたターゲットに対してデフォルトで有効または無効になります。-<feature> を指定すると、対象物が無効になります。否定的な特徴は常に肯定的な特徴より優先されます。--host_features もご覧ください。
タグ:changes_inputs
、affects_outputs
--[no]force_pic
デフォルト: 「false」-
有効にすると、すべての C++ コンパイルは位置非依存コード(「-fPIC」)を生成します。リンクは非 PC ライブラリよりも PIC ビルド済みライブラリを優先し、リンクは位置独立実行ファイル(「-pie」)を生成します。
タグ:loading_and_analysis
、affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
件の複数回の使用が累積される-
実行構成のアクションで使用できる環境変数のセットを指定します。変数は、名前で指定することも(この場合、値は呼び出し環境から取得されます)か、または名前=値のペア(呼び出し環境とは無関係に値を設定する)で指定できます。このオプションは複数回使用できます。同じ変数に対して指定されたオプションの場合は、最新の優先対象が使用され、異なる変数のオプションが蓄積されます。
タグ:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
のデフォルト: "opt"-
ビルド中に使用するツールがビルドされるモードを指定します。値: fastbuild、dbg、opt。
タグ:affects_outputs
、action_command_lines
--host_conlyopt=<a string>
件の複数回の使用が累積される-
exec 構成で C(C++ は除く)ソースファイルをコンパイルする際に C コンパイラに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--host_copt=<a string>
件の複数回の使用が累積される-
exec 構成でビルドされるツールのために C コンパイラに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--host_cpu=<a string>
のデフォルト: ""-
ホスト CPU。
タグ:changes_inputs
、affects_outputs
--host_cxxopt=<a string>
件の複数回の使用が累積される-
exec 構成でビルドされたツールのために C++ コンパイラに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--host_features=<a string>
件の複数回の使用が累積される-
指定された機能は、exec 構成でビルドされたターゲットに対してデフォルトで有効または無効になります。-<feature> を指定すると、対象物が無効になります。否定的な特徴は常に肯定的な特徴より優先されます。
タグ:changes_inputs
、affects_outputs
--host_force_python=<PY2 or PY3>
デフォルト: 説明を参照-
exec 構成の Python バージョンをオーバーライドします。「PY2」または「PY3」のいずれかです。
タグ:loading_and_analysis
、affects_outputs
--host_linkopt=<a string>
件の複数回の使用が累積される-
exec 構成でツールをリンクするときにリンカーに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
ホスト ターゲットに対応する macOS の最小バージョン。指定しない場合は「macos_sdk_version」を使用します。
タグ:loses_incremental_state
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
件の複数回の使用が累積される-
exec 構成で特定のファイルをコンパイルするときに、C/C++ コンパイラに選択的に渡す追加のオプション。このオプションは複数回渡すことができます。構文: regex_filter@option_1,option_2,...,option_nregex_filter は、包含および除外する正規表現パターンのリストを表します(--instrumentation_filter も参照)。option_1 から option_n は任意のコマンドライン オプションを表します。オプションにカンマが含まれる場合は、バックスラッシュで囲む必要があります。オプションには @ を含めることができます。文字列の分割には最初の @ のみが使用されます。例: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 は、//foo/ 内のすべての cc ファイル(bar.cc を除く)で gcc コマンドラインに -O0 コマンドライン オプションを追加します。
タグ:action_command_lines
、affects_outputs
--host_swiftcopt=<a string>
件の複数回の使用が累積される-
実行ツールで swiftc に渡す追加オプション。
タグ:action_command_lines
、affects_outputs
--[no]incompatible_auto_exec_groups
デフォルト: 「false」-
有効にすると、ルールで使用されるツールチェーンごとに exec グループが自動的に作成されます。これを機能させるには、ルールのアクションに「ツールチェーン」パラメータを指定する必要があります。詳細については、https://github.com/bazelbuild/bazel/issues/17134 をご覧ください。
タグ:affects_outputs
、incompatible_change
--[no]incompatible_merge_genfiles_directory
のデフォルト: 「true」-
true の場合、genfiles ディレクトリは bin ディレクトリに組み込まれます。
タグ:affects_outputs
、incompatible_change
--[no]incompatible_use_host_features
のデフォルト: 「true」-
true の場合、ターゲット構成にのみ --features を使用し、実行可能ファイル構成には --host_features を使用します。
タグ:changes_inputs
、affects_outputs
、incompatible_change
--[no]instrument_test_targets
デフォルト: 「false」-
カバレッジが有効な場合、インストルメンテーション テストルールを検討するかどうかを指定します。設定すると、--instrumentation_filter に含まれるテストルールがインストルメント化されます。それ以外の場合、テストルールは常にカバレッジ インストルメンテーションから除外されます。
タグ:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
デフォルト: "-/javatests[/:],-/test/java[/:]"-
カバレッジを有効にすると、指定した正規表現ベースのフィルタに含まれる名前を持つルールのみがインストルメント化されます。代わりに「-」で始まるルールは除外されます。--instrument_test_targets が有効になっていない限り、テスト以外のルールのみがインストルメント化されることに注意してください。
タグ:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
ターゲット シミュレータおよびデバイスに対応する最小の iOS バージョン。指定しない場合は、「ios_sdk_version」が使用されます。
タグ:loses_incremental_state
--ios_multi_cpus=<comma-separated list of options>
件の複数回の使用が累積される-
ios_application のビルドに使用するアーキテクチャのカンマ区切りリスト。その結果、指定されたすべてのアーキテクチャを含むユニバーサル バイナリが生成されます。
タグ:loses_incremental_state
、loading_and_analysis
--[no]legacy_whole_archive
のデフォルト: 「true」-
非推奨。代わりに --compatible_remove_legacy_whole_archive を使用します(詳しくは https://github.com/bazelbuild/bazel/issues/7362 をご覧ください)。オンにすると、linkshared=True と linkstatic=True または「-static」のいずれかが linkopts に設定されている cc_binary ルールに --whole-archive が使用されます。これは下位互換性用です。より適切な選択肢は、必要な場合に alwayslink=1 を使用することです。
タグ:action_command_lines
、affects_outputs
、deprecated
--linkopt=<a string>
件の複数回の使用が累積される-
リンク時に gcc に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--ltobackendopt=<a string>
件の複数回の使用が累積される-
LTO バックエンド ステップ(--features=thin_lto の下)に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--ltoindexopt=<a string>
件の複数回の使用が累積される-
LTO のインデックス登録ステップ(--features=thin_lto の下)に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--macos_cpus=<comma-separated list of options>
件の複数回の使用が累積される- Apple macOS バイナリをビルドするためのアーキテクチャのカンマ区切りリスト。
タグ:loses_incremental_state
、loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
ターゲットに対応する macOS の最小バージョン。指定しない場合は「macos_sdk_version」を使用します。
タグ:loses_incremental_state
--memprof_profile=<a build target label>
デフォルト: 説明を参照-
memprof プロファイルを使用する。
タグ:affects_outputs
--[no]objc_debug_with_GLIBCXX
デフォルト: 「false」-
設定されていて、コンパイル モードが「dbg」に設定されている場合、GLIBCXX_DEBUG、GLIBCXX_DEBUG_PEDANTIC、GLIBCPP_CONCEPT_CHECKS を定義します。
タグ:action_command_lines
--[no]objc_enable_binary_stripping
デフォルト: 「false」-
リンクされたバイナリでシンボルとデッドコードのストリップを実行するかどうかを指定します。このフラグと --compile_mode=opt の両方を指定すると、バイナリ ストリップが実行されます。
タグ:action_command_lines
--objccopt=<a string>
件の複数回の使用が累積される-
Objective-C/C++ ソースファイルのコンパイル時に gcc に渡す追加のオプション。
タグ:action_command_lines
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
件の複数回の使用が累積される-
特定のファイルをコンパイルするときに選択的に gcc に渡す追加のオプション。このオプションは複数回渡すことができます。構文: regex_filter@option_1,option_2,...,option_nregex_filter は、包含および除外する正規表現パターンのリストを表します(--instrumentation_filter も参照)。option_1 から option_n は任意のコマンドライン オプションを表します。オプションにカンマが含まれる場合は、バックスラッシュで囲む必要があります。オプションには @ を含めることができます。文字列の分割には最初の @ のみが使用されます。例: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 は、//foo/ 内に存在する bar.cc を除くすべての cc ファイルの gcc コマンドラインに、-O0 コマンドライン オプションを追加します。
タグ:action_command_lines
、affects_outputs
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
件の複数回の使用が累積される-
特定のバックエンド オブジェクトをコンパイルするときに、選択的に LTO バックエンド(--features=thin_lto の下)に渡す追加のオプション。このオプションは複数回渡すことができます。構文: regex_filter@option_1,option_2,...,option_nregex_filter は、包含および除外する正規表現パターンのリストです。option_1 から option_n は任意のコマンドライン オプションを表します。オプションにカンマが含まれる場合は、バックスラッシュで囲む必要があります。オプションには @ を含めることができます。文字列の分割には最初の @ のみが使用されます。例: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 は、//foo/ 内の、bar.o を除くすべての o ファイルの LTO バックエンド コマンドラインに -O0 コマンドライン オプションを追加します。
タグ:action_command_lines
、affects_outputs
--platform_suffix=<a string>
デフォルト: 説明を参照-
構成ディレクトリに追加する接尾辞を指定します。
タグ:loses_incremental_state
、affects_outputs
、loading_and_analysis
--propeller_optimize=<a build target label>
デフォルト: 説明を参照-
Propeller プロファイル情報を使用して、ビルド ターゲットを最適化します。Propeller プロファイルは、cc プロファイルと ld プロファイルの 2 つのファイルのうち少なくとも 1 つで構成されている必要があります。このフラグには、Propeller プロファイルの入力ファイルを参照する必要があるビルドラベルを指定します。たとえば、ラベルを定義する BUILD ファイル(a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",) )を Bazel の場合、対応するパッケージに Bazel ディレクティブを追加してこれらのファイルを表示する必要があります。このオプションは次のように使用する必要があります: --propeller_optimize=//a/b:propeller_profile
タグ:action_command_lines
、affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
デフォルト: 説明を参照-
Propeller Optimized ビルドの cc_profile ファイルのパスの絶対パス名。
タグ:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
デフォルト: 説明を参照-
Propeller Optimized ビルドの ld_profile ファイルの絶対パス名。
タグ:affects_outputs
--run_under=<a prefix in front of command>
デフォルト: 説明を参照-
「test」コマンドと「run」コマンドの実行可能ファイルの前に挿入する接頭辞。値が「foo -bar」で、実行コマンドラインが「test_binary -baz」の場合、最後のコマンドラインは「foo -bar test_binary -baz」になります。これは、実行可能ターゲットのラベルにすることもできます。たとえば、「valgrind」、「strace」、「strace -c」、「valgrind --quiet --num-callers=20」、「//package:target」、「//package:target --options」などが挙げられます。
タグ:action_command_lines
-
true の場合、同じ機能を含むネイティブ ライブラリが、異なるターゲット間で共有されます
タグ:loading_and_analysis
、affects_outputs
--[no]stamp
デフォルト: 「false」-
日付、ユーザー名、ホスト名、ワークスペース情報などでバイナリをスタンプします。
タグ:affects_outputs
--strip=<always, sometimes or never>
(デフォルト): 「時々」-
バイナリと共有ライブラリを除去するかどうかを指定します(「-Wl,--strip-debug」を使用)。デフォルト値の「sometimes」は、--compile_mode=fastbuild の場合を除いて削除されます。
タグ:affects_outputs
--stripopt=<a string>
件の複数回の使用が累積される-
「<name>.stripped」バイナリを生成する際にストリップに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--swiftcopt=<a string>
件の複数回の使用が累積される-
Swift コンパイルに渡す追加オプションです。
タグ:action_command_lines
--symlink_prefix=<a string>
デフォルト: 説明を参照-
ビルド後に作成される便利なシンボリック リンクのいずれかの先頭に付加される接頭辞です。省略した場合、デフォルト値はビルドツールの名前の後にハイフンを付けたものになります。「/」を渡すと、シンボリック リンクは作成されず、警告も出力されません。警告: 「/」の特別な機能はまもなくサポート終了となります。代わりに --experimental_convenience_symlinks=ignore を使用してください。
タグ:affects_outputs
--tvos_cpus=<comma-separated list of options>
件の複数回の使用が累積される- Apple tvOS バイナリをビルドするためのアーキテクチャのカンマ区切りリスト。
タグ:loses_incremental_state
、loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
ターゲット シミュレータとデバイスに対応する最小の tvOS バージョン。指定しない場合は「tvos_sdk_version」を使用します。
タグ:loses_incremental_state
--visionos_cpus=<comma-separated list of options>
件の複数回の使用が累積される- Apple VisionOS バイナリをビルドするためのアーキテクチャのカンマ区切りリスト。
タグ:loses_incremental_state
、loading_and_analysis
--watchos_cpus=<comma-separated list of options>
件の複数回の使用が累積される- Apple watchOS バイナリをビルドするためのアーキテクチャのカンマ区切りリスト。
タグ:loses_incremental_state
、loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
ターゲット シミュレータとデバイスに対応する最小互換の watchOS バージョン。指定しない場合は、「watchos_sdk_version」を使用します。
タグ:loses_incremental_state
--xbinary_fdo=<a build target label>
デフォルト: 説明を参照-
XbinaryFDO プロファイル情報を使用してコンパイルを最適化します。デフォルトのクロスバイナリ プロファイルの名前を指定します。このオプションを --fdo_instrument/--fdo_optimize/--fdo_profile とともに使用すると、xbinary_fdo が指定されていない場合と同じように常にこれらのオプションが優先されます。
タグ:affects_outputs
- Bazel が有効なビルド入力を厳密に適用するかどうかに影響するオプション(ルール定義、フラグの組み合わせなど):
--auto_cpu_environment_group=<a build target label>
のデフォルト: ""-
CPU 値を target_environment 値に自動的にマッピングするために使用する environment_group を宣言します。
タグ:changes_inputs
、loading_and_analysis
、experimental
--[no]check_licenses
デフォルト: 「false」-
依存パッケージによって課されるライセンスの制約が、ビルドされるターゲットの配布モードと競合していないことを確認します。デフォルトでは、ライセンスはオンになっています。
タグ:build_file_semantics
--[no]check_visibility
のデフォルト: 「true」-
無効にすると、ターゲット依存関係のエラーが警告に降格されます。
タグ:build_file_semantics
--[no]desugar_for_android
のデフォルト: 「true」-
dex 変換する前に Java 8 バイトコードを脱糖するかどうか。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--[no]desugar_java8_libs
デフォルト: 「false」-
レガシー デバイスのアプリにサポートされている Java 8 ライブラリを含めるかどうかを指定します。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--[no]enforce_constraints
のデフォルト: 「true」-
各ターゲットと互換性がある環境を確認し、同じ環境をサポートしていない依存関係がターゲットに含まれている場合はエラーを報告します。
タグ:build_file_semantics
--[no]experimental_check_desugar_deps
のデフォルト: 「true」-
Android バイナリレベルで正しい脱糖を再チェックするかどうか。
タグ:eagerness_to_exit
、loading_and_analysis
、experimental
--experimental_import_deps_checking=<off, warning or error>
のデフォルト: 「オフ」-
有効にすると、aar_import の依存関係が完全かどうかを確認します。この適用により、ビルドが中断するだけでなく、警告が表示される場合もあります。
タグ:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
デフォルト: 「default」-
true の場合、Java ターゲットで直接使用されるすべてのターゲットが依存関係として明示的に宣言されていることを確認します。
タグ:build_file_semantics
、eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
デフォルト: 「false」-
有効にすると、生成ルールの testonly を検索して、出力ファイルである前提条件のターゲットを testonly としてチェックします。これは可視性チェックと一致します。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_check_visibility_for_toolchains
デフォルト: 「false」-
有効にすると、可視性チェックはツールチェーンの実装にも適用されます。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_disable_native_android_rules
デフォルト: 「false」-
有効にすると、Android のネイティブ ルールの直接使用が無効になります。https://github.com/bazelbuild/rules_android にある Starlark Android ルールを使用してください
タグ:eagerness_to_exit
、incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
デフォルト: 「false」-
処理なし。下位互換性のためにここに保持します。
タグ:eagerness_to_exit
、incompatible_change
--[no]incompatible_python_disable_py2
のデフォルト: 「true」-
true の場合、Python 2 の設定を使用するとエラーが発生します。これには python_version=PY2、srcs_version=PY2、および srcs_version=PY2ONLY が含まれます。詳しくは、https://github.com/bazelbuild/bazel/issues/15684 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
のデフォルト: 「true」-
true の場合、Bazel はトップレベルのディレクトリ ヘッダーの包含も検証します(詳しくは、https://github.com/bazelbuild/bazel/issues/10047 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--python_native_rules_allowlist=<a build target label>
デフォルト: 説明を参照-
--compatible_python_disallow_native_rules を適用する際に使用する許可リスト(package_group ターゲット)。
タグ:loading_and_analysis
--[no]strict_filesets
デフォルト: 「false」-
このオプションを有効にすると、パッケージの境界を超えるファイルセットがエラーとして報告されます。
タグ:build_file_semantics
、eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
デフォルト: "error"-
OFF の場合を除き、proto_library ターゲットが、直接使用されるすべてのターゲットを依存関係として明示的に宣言していることを確認します。
タグ:build_file_semantics
、eagerness_to_exit
、incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
のデフォルト: 「off」-
OFF の場合を除き、proto_library ターゲットが、「import public」で使用されるすべてのターゲットを、エクスポート済みとして明示的に宣言していることを確認します。
タグ:build_file_semantics
、eagerness_to_exit
、incompatible_change
--[no]strict_system_includes
デフォルト: 「false」-
true の場合、システムのインクルード パス(-isystem)で検出されたヘッダーも宣言する必要があります。
タグ:loading_and_analysis
、eagerness_to_exit
--target_environment=<a build target label>
件の複数回の使用が累積される-
このビルドのターゲット環境を宣言します。「環境」ルールへのラベル参照にする必要があります。指定する場合、すべてのトップレベル ターゲットはこの環境と互換性を持つ必要があります。
タグ:changes_inputs
- ビルドの署名出力に影響するオプション:
--apk_signing_method=<v1, v2, v1_v2 or v4>
のデフォルト: 「v1_v2」-
APK の署名に使用する実装
タグ:action_command_lines
、affects_outputs
、loading_and_analysis
--[no]device_debug_entitlements
のデフォルト: 「true」-
設定されていて、コンパイル モードが「opt」でない場合、objc アプリは署名時にデバッグ利用資格を含めます。
タグ:changes_inputs
--ios_signing_cert_name=<a string>
デフォルト: 説明を参照-
iOS 署名に使用する証明書の名前。設定されていない場合、プロビジョニング プロファイルにフォールバックします。証明書のキーチェーン ID 設定、またはコードサインのマニュアル ページ(署名 ID)に基づく証明書の共通名(部分文字列)の場合もあります。
タグ:action_command_lines
- このオプションは、BUILD ファイル、.bzl ファイル、WORKSPACE ファイルからアクセス可能な Starlark 言語または Build API のセマンティクスに影響します。
--[no]incompatible_config_setting_private_default_visibility
デフォルト: 「false」-
compatible_enforce_config_setting_visibility=false の場合、何も追加されません。このフラグが false の場合、明示的な可視性属性のない config_setting は //visibility:public です。このフラグが true の場合、config_setting は他のすべてのルールと同じ可視性ロジックに従います。https://github.com/bazelbuild/bazel/issues/12933 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_disallow_legacy_py_provider
のデフォルト: 「true」-
No-op、まもなく削除されます。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
デフォルト: 「false」-
true の場合、objc_library と objc_import の sdk_frameworks 属性と weak_sdk_frameworks の属性を禁止します。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_enforce_config_setting_visibility
のデフォルト: 「true」-
true の場合、config_setting 公開設定の制限を適用します。false の場合、すべての config_setting がすべてのターゲットに表示されます。https://github.com/bazelbuild/bazel/issues/12932 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_objc_alwayslink_by_default
デフォルト: 「false」-
true の場合、objc_library と objc_import の alwayslink 属性のデフォルト値を true にします。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_python_disallow_native_rules
デフォルト: 「false」-
true の場合、組み込みの py_* ルールの使用時にエラーが発生します。代わりに rule_python ルールを使用する必要があります。詳細と移行手順については、https://github.com/bazelbuild/bazel/issues/17773 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
- テスト環境またはテストランナーの動作を制御するオプション:
--[no]allow_analysis_failures
デフォルト: 「false」-
true の場合、ルール ターゲットの分析が失敗すると、ビルドは失敗するのではなく、エラーの説明を含む AnalysisFailureInfo のインスタンスが伝播されます。
タグ:loading_and_analysis
、experimental
--analysis_testing_deps_limit=<an integer>
デフォルト: 「2000」-
for_analysis_testing 構成の移行に関するルール属性を介して、推移的依存関係の最大数を設定します。この上限を超えると、ルールエラーが発生します。
タグ:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
デフォルト: 「false」-
真の dex2oat アクションが失敗すると、テスト実行時に dex2oat を実行する代わりにビルドが中断されます。
タグ:loading_and_analysis
、experimental
--[no]check_tests_up_to_date
デフォルト: 「false」-
テストは実行せず、結果が最新かどうか確認してください。すべてのテスト結果が最新であれば、テストは正常に完了します。テストのビルドまたは実行が必要な場合、エラーが報告され、テストは失敗します。このオプションは --check_up_to_date の動作を示します。
タグ:execution
--[no]experimental_android_use_parallel_dex2oat
デフォルト: 「false」-
dex2oat を並行して使用すると、android_test が高速化される場合があります。
タグ:loading_and_analysis
、host_machine_resource_optimizations
、experimental
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
件の複数回の使用が累積される-
各テストは、テストが失敗した場合、指定された回数まで再試行されます。2 回以上の試行が必要なテストは、テストサマリーに「FLAKY」と表示されます。通常、指定される値は整数または文字列「default」です。整数の場合は、すべてのテストが N 回まで実行されます。「default」に設定すると、通常のテストでは 1 回だけテストが試行され、ルール(flaky=1 属性)によって明示的に不安定とマークされたテストでは 3 回試行されます。別の構文: regex_filter@flaky_test_attemptsここで、flaky_test_attempts は上記のとおりで、regex_filter は、包含および除外する正規表現パターンのリストを表します(--runs_per_test も参照)。例: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 は、//foo/ 内にあるテストのうち、foo/bar の下にあるものを除くすべてのテストを 3 回デフレークします。このオプションは複数回渡すことができます。最後に渡された引数のうち、一致したものが優先されます。一致するものがない場合は、上記の「default」と同じ動作になります。
タグ:execution
--[no]ios_memleaks
デフォルト: 「false」-
ios_test ターゲットでのメモリリークのチェックを有効化。
タグ:action_command_lines
--ios_simulator_device=<a string>
デフォルト: 説明を参照-
シミュレータで iOS アプリを実行するときにシミュレートするデバイス(例: iPhone 6)。シミュレータが実行されるマシンで「xcrun simctl list devicetypes」を実行すると、デバイスのリストを取得できます。
タグ:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
実行またはテストの際にシミュレータで実行する iOS のバージョン。対象デバイスがルールで指定されている場合、ios_test ルールでは無視されます。
タグ:test_runner
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
のデフォルト: "auto"-
同時に実行するローカルテストジョブの最大数。整数またはキーワード ("auto", "HOST_CPUS", "HOST_RAM") を取り、必要に応じて演算([-|*]<float>)を続けます。例:"auto"、"HOST_CPUS*.5" となります。0 に設定すると、同時に実行するローカルテストジョブの数がローカル リソースによって制限されます。--jobs よりも大きい値を設定しても効果はありません。
タグ:execution
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
件の複数回の使用が累積される- 各テストを実行する回数を指定します。いずれかの試行がなんらかの理由で不合格になった場合は、テスト全体が不合格と見なされます。通常、指定される値は整数のみです。例: --runs_per_test=3 と指定すると、すべてのテストが 3 回実行されます。別の構文: regex_filter@runs_per_testrun_per_test は整数値、regex_filter は正規表現パターンのリストです(--instrumentation_filter も参照)。例: --runs_per_test=//foo/.*,-//foo/bar/.*@3 を指定すると、//foo/ 内のテストのうち、foo/bar の下にあるものを除くすべてのテストを 3 回実行します。このオプションは複数回渡すことができます。最後に渡された引数のうち、一致したものが優先されます。一致するものがない場合、テストは 1 回だけ実行されます。
--test_env=<a 'name=value' assignment with an optional value part>
件の複数回の使用が累積される-
テストランナー環境に挿入する追加の環境変数を指定します。変数は名前で指定できます。この場合、値は Bazel クライアント環境から読み取られます。また、name=value のペアで指定することもできます。このオプションを複数回使用して、複数の変数を指定できます。「bazel test」コマンドでのみ使用されます。
タグ:test_runner
--[no]test_keep_going
のデフォルト: 「true」-
無効にすると、テストに合格しなかった場合にビルド全体が停止します。デフォルトでは、一部のテストに合格しなかった場合でも、すべてのテストが実行されます。
タグ:execution
--test_strategy=<a string>
のデフォルト: ""-
テスト実行時に使用する戦略を指定します。
タグ:execution
--test_timeout=<a single integer or comma-separated list of 4 integers>
デフォルト: 「-1」- テストのタイムアウトのデフォルトのテスト タイムアウト値(秒単位)をオーバーライドします。正の整数値を 1 つだけ指定すると、すべてのカテゴリがオーバーライドされます。4 つのカンマ区切りの整数を指定すると、short、Moderate、long、eternal のタイムアウトが(この順序で)オーバーライドされます。どちらの形式でも、値を -1 にすると、そのカテゴリに対してデフォルトのタイムアウトを使用するように Blaze に指示します。
--test_tmpdir=<a path>
デフォルト: 説明を参照- 「bazel test」で使用するベース一時ディレクトリを指定します。
--[no]zip_undeclared_test_outputs
のデフォルト: 「true」-
true の場合、宣言されていないテスト出力が zip ファイルにアーカイブされます。
タグ:test_runner
- ビルド時間の最適化をトリガーするオプション:
--[no]experimental_filter_library_jar_with_program_jar
デフォルト: 「false」-
ProGuard ProgramJar をフィルタリングして、LibraryJar にも存在するクラスを削除します。
タグ:action_command_lines
--[no]experimental_inmemory_dotd_files
のデフォルト: 「true」-
有効にすると、C++ .d ファイルはディスクに書き込むのではなく、リモートビルドノードから直接メモリ内に渡されます。
タグ:loading_and_analysis
、execution
、affects_outputs
、experimental
--[no]experimental_inmemory_jdeps_files
のデフォルト: 「true」-
有効にすると、Java コンパイルで生成された依存関係(.jdeps)ファイルは、ディスクに書き込まれるのではなく、リモートビルドノードから直接メモリ内に渡されます。
タグ:loading_and_analysis
、execution
、affects_outputs
、experimental
--[no]experimental_objc_include_scanning
デフォルト: 「false」-
目的の C/C++ のスキャンを実行するかどうか。
タグ:loading_and_analysis
、execution
、changes_inputs
--[no]experimental_retain_test_configuration_across_testonly
デフォルト: 「false」-
有効にすると、--trim_test_configuration は testonly=1 とマークされたルールのテスト構成をトリミングしません。これは、テスト以外のルールが cc_test ルールに依存している場合のアクションの競合の問題を軽減するためです。--trim_test_configuration が false の場合は効果はありません。
タグ:loading_and_analysis
、loses_incremental_state
--[no]experimental_starlark_cc_import
デフォルト: 「false」-
有効にすると、Starlark バージョンの cc_import を使用できます。
タグ:loading_and_analysis
、experimental
--[no]experimental_unsupported_and_brittle_include_scanning
デフォルト: 「false」-
入力ファイルの #include 行を解析して入力を C/C++ コンパイルに絞り込むかどうかを指定します。これにより、コンパイルの入力ツリーのサイズを縮小することで、パフォーマンスとインクリメンタリティを改善できます。ただし、インクルード スキャナは C プリプロセッサのセマンティクスを完全に実装していないため、ビルドが中断される可能性があります。特に、動的な #include ディレクティブは認識されず、プリプロセッサの条件付きロジックは無視されます。自己責任で使用してください。このフラグに関して報告された問題はクローズされます。
タグ:loading_and_analysis
、execution
、changes_inputs
--[no]incremental_dexing
のデフォルト: 「true」-
dex 変換のほとんどの作業は、Jar ファイルごとに個別に行います。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
のデフォルト: "HOST_CPUS"-
ローカルで実行されるビルド アクションに Bazel が使用できるローカル CPU コアの合計数を明示的に設定します。整数または "HOST_CPUS" を取り、必要に応じて [-|*]<float> が続きます(例:HOST_CPUS*.5 を指定すると、使用可能な CPU コアの半分が使用されます。デフォルトでは、Bazel (「HOST_CPUS」)はシステム構成を照会して、使用可能な CPU コア数を推定します。
タグ:host_machine_resource_optimizations
--local_extra_resources=<a named float, 'name=value'>
件の複数回の使用が累積される-
Bazel で使用できる追加リソースの数を設定します。文字列と浮動小数点のペアを取ります。複数回使用して、複数のタイプの追加のリソースを指定できます。Bazel は、利用可能な追加リソースと必要な追加リソースに基づいて、同時実行アクションを制限します。テストでは、「resources:<resoucename>:<amount>」形式のタグを使用して、追加で必要なリソースの量を宣言できます。使用可能な CPU、RAM、リソースをこのフラグで設定することはできません。
タグ:host_machine_resource_optimizations
--local_ram_resources=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
のデフォルト: "HOST_RAM*.67"-
ローカルで実行されるビルド アクションに Bazel が使用できるローカルホスト RAM の合計容量(MB 単位)を明示的に設定します。整数または "HOST_RAM" を取ります。必要に応じてその後に [-|*]<float> が続きます(例:使用可能な RAM の半分を使用する場合は HOST_RAM*.5 を使用します)。デフォルト("HOST_RAM*.67")では、Bazel はシステム構成を照会して使用可能な RAM の量を推定し、その 67% を使用します。
タグ:host_machine_resource_optimizations
--[no]objc_use_dotd_pruning
のデフォルト: 「true」-
設定すると、clang が出力した .d ファイルが、objc コンパイルに渡される入力のセットをプルーニングするために使用されます。
タグ:changes_inputs
、loading_and_analysis
--[no]process_headers_in_dependencies
デフォルト: 「false」-
ターゲット //a:a をビルドする際、//a:a が依存するすべてのターゲットのヘッダーを処理します(ツールチェーンでヘッダー処理が有効になっている場合)。
タグ:execution
--[no]trim_test_configuration
のデフォルト: 「true」-
有効にすると、ビルドのトップレベルの下にあるテスト関連のオプションがクリアされます。このフラグを有効にすると、テスト以外のルールの依存関係としてテストをビルドすることはできませんが、テスト関連のオプションを変更してもテスト以外のルールが再分析されることはありません。
タグ:loading_and_analysis
、loses_incremental_state
- ロギングの詳細度、形式、場所に影響するオプション:
--[no]experimental_bep_target_summary
デフォルト: 「false」- TargetSummary イベントを公開するかどうか。
--[no]experimental_build_event_expand_filesets
デフォルト: 「false」-
true の場合、出力ファイルを提示するときに、BEP でファイルセットを展開します。
タグ:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
デフォルト: 「false」-
true の場合、出力ファイルを表示するときに、BEP の相対ファイルセット シンボリック リンクを完全に解決します。--experimental_build_event_expand_filesets が必要です。
タグ:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
のデフォルト: 「4」-
Bazel がビルドイベントのアップロードを再試行する最大回数。
タグ:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
のデフォルト: 「1s」-
BEP のアップロードが失敗した場合の指数バックオフの再試行の最小遅延。(指数: 1.6)
タグ:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
デフォルト: 説明を参照-
ビルドイベント プロトコルで参照されるアーティファクトをアップロードする方法を選択します。
タグ:affects_outputs
--[no]experimental_materialize_param_files_directly
デフォルト: 「false」-
パラメータ ファイルを実体化する場合は、ディスクに直接書き込みます。
タグ:execution
--[no]experimental_run_bep_event_include_residue
デフォルト: 「false」-
実行ビルドイベントにコマンドラインの残差を含めるかどうかを指定します。デフォルトでは、残留物を含む可能性のある実行コマンドのビルドイベントに残留物は含まれません。
タグ:affects_outputs
--[no]experimental_stream_log_file_uploads
デフォルト: 「false」-
ログファイルをディスクに書き込むのではなく、リモート ストレージに直接アップロードする。
タグ:affects_outputs
--explain=<a path>
デフォルト: 説明を参照-
実行されたビルドの各ステップをビルドシステムに説明させます。説明は指定したログファイルに書き込まれます。
タグ:affects_outputs
--[no]legacy_important_outputs
のデフォルト: 「true」-
これを使用して、TargetComplete イベントで以前の重要な出力フィールドの生成を抑制します。Bazel と ResultStore の統合には、重要_outputs が必要です。
タグ:affects_outputs
--[no]materialize_param_files
デフォルト: 「false」-
リモート アクション実行を使用している場合でも、中間パラメータ ファイルを出力ツリーに書き込みます。アクションをデバッグする場合に便利です。これは、--subcommands と --verbose_failures によって暗黙的に指定されます。
タグ:execution
--max_config_changes_to_show=<an integer>
のデフォルト: 「3」-
ビルド オプションの変更により分析キャッシュを破棄する場合、変更されたオプション名が指定された数まで表示されます。指定した数値が -1 の場合、変更されたすべてのオプションが表示されます。
タグ:terminal_output
--max_test_output_bytes=<an integer>
デフォルト: 「-1」-
--test_output が「errors」または「all」の場合に出力できる、テストごとのログの最大サイズを指定します。ノイズが過度に多いテスト出力で過剰な出力にならないようにする場合に便利です。テストヘッダーはログサイズに含まれます。負の値は制限がないことを意味します。出力は、オール オア ナッシングになります。
タグ:test_runner
、terminal_output
、execution
--output_filter=<a valid Java regular expression>
デフォルト: 説明を参照-
指定した正規表現に一致する名前のルールの警告とアクション出力のみが表示されます。
タグ:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
のデフォルト: 「0」-
実行中のジョブに関するレポートの間隔(秒)。デフォルト値の 0 は、10 秒後に最初のレポートが印刷され、その後 30 秒後にその進捗状況が 1 分ごとに報告されることを意味します。--curses が有効になっている場合、進行状況が 1 秒ごとに報告されます。
タグ:affects_outputs
--show_result=<an integer>
のデフォルト: 「1」-
ビルドの結果を表示します。ターゲットごとに、それが最新かどうかを記載し、最新の場合はビルドされた出力ファイルのリストを記載します。出力されたファイルは、シェルにコピー&ペーストして実行するために便利な文字列です。このオプションには整数の引数が必要です。整数引数は、ターゲットのしきい値(しきい値を超えると、結果情報は出力されません)となります。したがって、ゼロを指定するとメッセージが抑制され、MAX_INT を指定すると結果が出力されます。デフォルトは 1 です。ターゲットに対して何もビルドされていない場合は、出力がしきい値を下回るように、結果が省略されることがあります。
タグ:affects_outputs
--[no]subcommands
[-s
] default: "false"-
ビルド中に実行されたサブコマンドを表示します。関連フラグ: --execution_log_json_file、--execution_log_binary_file(ツールに適した形式でサブコマンドをファイルに記録する場合)
タグ:terminal_output
--test_output=<summary, errors, all or streamed>
デフォルト: 「summary」-
目的の出力モードを指定します。有効な値は、「summary」はテスト ステータスの概要のみを出力し、「errors」は失敗したテストのテストログも出力、「all」はすべてのテストのログをリアルタイムで出力します。「streamed」はすべてのテストのログをリアルタイムに出力します(--test_strategy 値に関係なく、テストが一度に 1 つずつローカルに実行されます)。
タグ:test_runner
、terminal_output
、execution
--test_summary=<short, terse, detailed, none or testcase>
のデフォルト: 「short」-
テストサマリーの形式を指定します。有効な値は、「short」は実行されたテストに関する情報のみを出力し、「terse」は実行されたテストの失敗したテストの情報のみを出力し、「detailed」は失敗したテストケースの詳細情報を出力します。「testcase」は失敗したテストケースの詳細情報を出力しません。「none」は概要を省略します。
タグ:terminal_output
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
のデフォルト: "-.*"-
ツールチェーンの解決時にデバッグ情報を出力します。このフラグは正規表現を使用します。正規表現は、デバッグ対象を確認するためにツールチェーン タイプおよび特定のターゲットと照合されます。複数の正規表現をコンマで区切ると、それぞれの正規表現が個別にチェックされます。注: このフラグの出力は非常に複雑で、ツールチェーンの解決に携わる専門家にのみ役立つ可能性があります。
タグ:terminal_output
--[no]verbose_explanations
デフォルト: 「false」-
--explain が有効になっている場合に発行される説明の詳細度を高めます。--explain が有効になっていない場合は機能しません。
タグ:affects_outputs
--[no]verbose_failures
デフォルト: 「false」-
コマンドが失敗した場合は、コマンドライン全体を出力します。
タグ:terminal_output
- 他のカテゴリに当てはまらない Bazel コマンドへの汎用入力を指定または変更するオプション。
--aspects_parameters=<a 'name=value' assignment>
件の複数回の使用が累積される-
コマンドライン アスペクト パラメータの値を指定します。各パラメータ値は、<param_name>=<param_value> で指定されます。例: 'my_param=my_val'。'my_param' は --aspects リストのアスペクトのパラメータか、リストのアスペクトで必須です。このオプションは複数回使用できます。ただし、同じパラメータに値を複数回割り当てることはできません。
タグ:loading_and_analysis
--flag_alias=<a 'name=value' flag alias>
件の複数回の使用が累積される-
Starlark フラグの省略名を設定します。引数として「<key>=<value>」形式の 1 つの Key-Value ペアを取ります。
タグ:changes_inputs
--[no]incompatible_default_to_explicit_init_py
デフォルト: 「false」-
このフラグはデフォルトの動作を変更し、Python ターゲットの実行ファイルで __init__.py ファイルが自動的に作成されなくなります。正確には、py_binary または py_test のターゲットで legacy_create_init が「auto」(デフォルト)に設定されている場合、このフラグが設定されている場合にのみ false として扱われます。https://github.com/bazelbuild/bazel/issues/10076 をご覧ください。
タグ:affects_outputs
、incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
のデフォルト: 「true」-
true の場合、Python 2 の構成でビルドされたターゲットは、接尾辞「-py2」を含む出力ルートの下に表示されます。Python 3 用にビルドされたターゲットは、Python 関連の接尾辞がないルートに表示されます。つまり、「bazel-bin」という便利なシンボリック リンクが、Python 2 ではなく Python 3 のターゲットを指すようになります。このオプションを有効にする場合は、「--compatible_py3_is_default」も有効にすることをおすすめします。
タグ:affects_outputs
、incompatible_change
--[no]incompatible_py3_is_default
のデフォルト: 「true」-
true の場合、「python_version」(または「default_python_version」)属性が設定されていない「py_binary」および「py_test」ターゲットはデフォルトで PY2 ではなく PY3 に設定されます。このフラグを設定する場合は、「--compatible_py2_outputs_are_suffixed」も設定することをおすすめします。
タグ:loading_and_analysis
、affects_outputs
、incompatible_change
--[no]incompatible_use_python_toolchains
のデフォルト: 「true」-
true に設定すると、実行可能なネイティブ Python ルールは、以前のフラグ(--python_top など)で指定されたランタイムではなく、Python ツールチェーンで指定された Python ランタイムを使用します。
タグ:loading_and_analysis
、incompatible_change
--python_version=<PY2 or PY3>
デフォルト: 説明を参照-
Python メジャー バージョン モードです。「PY2」または「PY3」のいずれかです。これは、(バージョンを明示的に指定していなくても)「py_binary」および「py_test」のターゲットによってオーバーライドされるため、このフラグを指定する理由は通常あまりありません。
タグ:loading_and_analysis
、affects_outputs
--target_pattern_file=<a string>
のデフォルト: ""-
設定すると、ビルドはコマンドラインではなく、ここで指定したファイルからパターンを読み取ります。コマンドライン パターンを指定したり、ここでファイルを指定するとエラーになります。
タグ:changes_inputs
- リモート キャッシュと実行のオプション:
--experimental_remote_cache_eviction_retries=<an integer>
のデフォルト: 「0」-
ビルドでリモート キャッシュ エビクション エラーが発生した場合の再試行の最大回数。ゼロ以外の値を指定すると、暗黙的に --compatible_remote_use_new_exit_code_for_lost_inputs を true に設定します。試行ごとに新しい呼び出し ID が生成されます。呼び出し ID を生成し、--invocation_id を指定して Bazel に指定する場合は、このフラグを使用しないでください。代わりに、フラグ --compatible_remote_use_new_exit_code_for_lost_inputs を設定し、終了コード 39 を確認します。
タグ:execution
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
のデフォルト: 「true」-
true に設定すると、ビルド中にリモート キャッシュが blob を削除すると、Bazel は 34 ではなく新しい終了コード 39 を使用します。
タグ:incompatible_change
- その他のオプション(特に分類されていないもの):
--[no]allow_analysis_cache_discard
のデフォルト: 「true」-
ビルドシステムの変更により分析キャッシュを破棄する場合、このオプションを false に設定すると、ビルドを続行せずに bazel が終了します。「discard_analysis_cache」も設定されている場合、このオプションは無視されます。
タグ:eagerness_to_exit
--[no]build_manual_tests
デフォルト: 「false」- 「manual」タグが付いたテスト ターゲットを強制的にビルドします。「手動」テストは処理から除外されます。このオプションは、ビルドを強制します(実行はされません)。
--build_tag_filters=<comma-separated list of options>
のデフォルト: ""- タグのカンマ区切りリストを指定します。必要に応じて各タグの前に「-」を付けると、除外するタグを指定できます。含まれるタグが 1 つ以上含み、除外されたタグを含まないターゲットのみが構築されます。このオプションは、「test」コマンドで実行される一連のテストには影響しません。「--test_tag_filters」などのテスト フィルタリング オプションによって決まります。
--[no]build_tests_only
デフォルト: 「false」- 指定すると、*_test ルールと test_suite ルールのみがビルドされ、コマンドラインで指定された他のターゲットは無視されます。デフォルトでは、リクエストされたものがすべてビルドされます。
--[no]cache_test_results
[-t
] default: "auto"- 「auto」に設定すると、次の場合にのみ、Bazel がテストを再実行します。(1)Bazel がテストまたはその依存関係の変更を検出した、(2)テストが外部としてマークされている、(3)--runs_per_test で複数のテスト実行がリクエストされた、(4)以前にテストが失敗した。「yes」に設定すると、Bazel は外部としてマークされたテストを除くすべてのテスト結果をキャッシュに保存します。「no」に設定した場合、Bazel はテスト結果をキャッシュに保存しません。
--[no]compile_one_dependency
デフォルト: 「false」- 引数ファイルの単一の依存関係をコンパイルします。これは、IDE でソースファイルの構文チェックを行う場合に便利です。たとえば、編集/ビルド/テストのサイクルでできるだけ早くエラーを検出するために、ソースファイルに依存する単一のターゲットを再ビルドします。この引数は、フラグ以外のすべての引数の解釈方法に影響します。ビルドのターゲットになるのではなく、ソースファイル名になります。ソースファイル名ごとに、そのファイル名に依存する任意のターゲットがビルドされます。
--deleted_packages=<comma-separated list of package names>
件の複数回の使用が累積される- パッケージ名のカンマ区切りリスト。パッケージパス上のどこかに表示されていても、ビルドシステムによって存在しないと判断されます。 既存のパッケージ「x」のサブパッケージ「x/y」を削除する場合は、このオプションを使用します。たとえば、クライアントで x/y/BUILD を削除した後、別の package_path エントリによってラベル「//x:y/z」が見つかると、ビルドシステムからエラーが発生することがあります。--deleted_packages x/y を指定すると、この問題を回避できます。
--[no]discard_analysis_cache
デフォルト: 「false」- 分析フェーズが完了したら、すぐに分析キャッシュを破棄します。メモリ使用量は約 10% 削減されますが、それ以上の増分ビルドは遅くなります。
--execution_log_binary_file=<a path>
デフォルト: 説明を参照- 実行されたスポーンを、src/main/protobuf/spawn.proto に沿って区切りの Spawn proto としてこのファイルに記録します。関連フラグ: --execution_log_json_file(テキスト JSON 形式、相互に排他的)、--execution_log_sort(実行ログを並べ替えるかどうか)、--subcommands(ターミナル出力にサブコマンドを表示する場合)。
--execution_log_json_file=<a path>
デフォルト: 説明を参照- 実行されたスポーンを、src/main/protobuf/spawn.proto に従って、区切りの Spawn proto の JSON 表現としてこのファイルに記録します。関連フラグ: --execution_log_binary_file(バイナリ protobuf 形式、相互に排他的)、--execution_log_sort(実行ログを並べ替えるかどうか)、--subcommands(ターミナル出力にサブコマンドを表示する場合)。
--[no]execution_log_sort
のデフォルト: 「true」- 呼び出し間でログを簡単に比較できるように、実行ログを並べ替えるかどうか。false に設定すると、非決定的な実行順序でログが生成されますが、呼び出しの終了時に CPU とメモリの大幅な使用量が増える可能性があります。
--[no]expand_test_suites
のデフォルト: 「true」-
分析前に、test_suite ターゲットをその構成要素テストに展開します。このフラグがオン(デフォルト)の場合、テストスイートに属するテストにネガティブ ターゲット パターンが適用されます。そうでない場合、適用されません。このフラグをオフにすると、コマンドラインでトップレベルの要素が適用されると、test_suite ターゲットを分析できます。
タグ:loading_and_analysis
--[no]experimental_cancel_concurrent_tests
デフォルト: 「false」-
true の場合、Blaze は最初に成功した実行時に、同時に実行されているテストをキャンセルします。これは、--runs_per_test_detects_flakes と組み合わせた場合にのみ有用です。
タグ:affects_outputs
、loading_and_analysis
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
のデフォルト: ""- アスペクトを優先して非推奨となりました。extra_actions をスケジュールするターゲットのセットをフィルタします。
--[no]experimental_extra_action_top_level_only
デフォルト: 「false」- アスペクトを優先して非推奨となりました。最上位のターゲットに対してのみ、extra_actions をスケジュールします。
--[no]experimental_fetch_all_coverage_outputs
デフォルト: 「false」-
true の場合、Bazel はカバレッジの実行中に、各テストでカバレッジ データ ディレクトリ全体を取得します。
タグ:affects_outputs
、loading_and_analysis
--[no]experimental_generate_llvm_lcov
デフォルト: 「false」-
true の場合、clang のカバレッジにより LCOV レポートが生成されます。
タグ:affects_outputs
、loading_and_analysis
--[no]experimental_j2objc_header_map
のデフォルト: 「true」- J2ObjC のトランスパイルと並行して J2ObjC ヘッダーマップを生成するかどうかを指定します。
--[no]experimental_j2objc_shorter_header_path
デフォルト: 「false」-
短いヘッダーパスで生成するかどうか(_j2objc ではなく _ios を使用します)。
タグ:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
のデフォルト: 「javabuilder」- Java コンパイルのクラスパスを削減できます。
--[no]experimental_limit_android_lint_to_android_constrained_java
デフォルト: 「false」-
--experimental_run_android_lint_on_java_rules を Android 互換ライブラリに制限します。
タグ:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
デフォルト: 「false」-
java_* ソースを検証するかどうかを指定します。
タグ:affects_outputs
--[no]explicit_java_test_deps
デフォルト: 「false」- TestRunner の依存関係を誤って取得するのではなく、java_test で JUnit または Hamcrest への依存関係を明示的に指定します。現在は bazel でのみ機能します。
--host_java_launcher=<a build target label>
デフォルト: 説明を参照- ビルド時に実行されるツールで使用される Java ランチャー。
--host_javacopt=<a string>
件の複数回の使用が累積される- ビルドで実行されるツールをビルドするときに javac に渡す追加オプション。
--host_jvmopt=<a string>
件の複数回の使用が累積される- ビルド時に実行されるツールをビルドするときに Java VM に渡す追加のオプション。これらのオプションは、各 java_binary ターゲットの VM 起動オプションに追加されます。
--[no]incompatible_check_sharding_support
のデフォルト: 「true」-
true の場合、テストランナーが TEST_SHARD_STATUS_FILE のパスにあるファイルをタップしてシャーディングをサポートしていることを示していない場合、Bazel はシャーディングされたテストに失敗します。false の場合、シャーディングをサポートしていないテストランナーによって、各シャードですべてのテストが実行されます。
タグ:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
のデフォルト: 「true」-
true の場合、サンドボックス化された戦略で排他的なテストが実行されます。排他的なテストをローカルで強制的に実行するには、「local」タグを追加します。
タグ:incompatible_change
--[no]incompatible_strict_action_env
デフォルト: 「false」-
true の場合、Bazel は PATH に静的な値を持つ環境を使用し、LD_LIBRARY_PATH を継承しません。クライアントから特定の環境変数を継承する場合は --action_env=ENV_VARIABLE を使用しますが、共有キャッシュを使用している場合に共有すると、ユーザー間のキャッシュ保存が妨げられる可能性があります。
タグ:loading_and_analysis
、incompatible_change
--j2objc_translation_flags=<comma-separated list of options>
件の複数回の使用が累積される- J2ObjC ツールに渡す追加オプション。
--java_debug
-
Java テストの Java 仮想マシンで、JDWP 準拠のデバッガ(jdb など)からの接続を待ってからテストを開始します。-test_output=streamed を意味します。
拡張後:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
のデフォルト: 「true」- Java ターゲットごとに依存関係情報を生成します(現時点ではコンパイル時クラスパス)。
--[no]java_header_compilation
のデフォルト: 「true」- ソースから直接 ijar をコンパイルします。
--java_language_version=<a string>
のデフォルト: ""- Java 言語バージョン
--java_launcher=<a build target label>
デフォルト: 説明を参照- Java バイナリをビルドするときに使用する Java ランチャー。このフラグを空の文字列に設定すると、JDK ランチャーが使用されます。「launcher」属性はこのフラグをオーバーライドします。
--java_runtime_version=<a string>
のデフォルト: 「local_jdk」- Java ランタイム バージョン
--javacopt=<a string>
件の複数回の使用が累積される- javac に渡す追加オプション。
--jvmopt=<a string>
件の複数回の使用が累積される- Java VM に渡す追加オプション。これらのオプションは、各 java_binary ターゲットの VM 起動オプションに追加されます。
--legacy_main_dex_list_generator=<a build target label>
デフォルト: 説明を参照- 以前の Multidex をコンパイルする際にメイン dex に含める必要があるクラスのリストを生成するために使用するバイナリを指定します。
--local_termination_grace_seconds=<an integer>
のデフォルト: 「15」- タイムアウトによりローカル プロセスを終了してから強制的にシャットダウンするまでの待機時間。
--optimizing_dexer=<a build target label>
デフォルト: 説明を参照- シャーディングなしの dex 変換に使用するバイナリを指定します。
--package_path=<colon-separated list of options>
のデフォルト: 「%workspace%」- パッケージを検索する場所をコロンで区切ったリスト。「%workspace%」で始まる要素は、それを含むワークスペースからの相対値です。省略するか空の場合、デフォルトは「bazel info default-package-path」の出力です。
--plugin=<a build target label>
件の複数回の使用が累積される- ビルドで使用するプラグイン。現在は java_plugin で機能します。
--proguard_top=<a build target label>
デフォルト: 説明を参照- Java バイナリをビルドするときにコードの削除に使用する ProGuard のバージョンを指定します。
--proto_compiler=<a build target label>
デフォルト: "@bazel_tools//tools/proto:protoc"-
プロトコル コンパイラのラベル。
タグ:affects_outputs
、loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
のデフォルト: "@bazel_tools//tools/proto:cc_chain"-
C++ proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル
タグ:affects_outputs
、loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
のデフォルト: "@bazel_tools//tools/j2objc:j2objc_proto_ツールチェーン"-
j2objc proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル
タグ:affects_outputs
、loading_and_analysis
--proto_toolchain_for_java=<a build target label>
のデフォルト: "@bazel_tools//tools/proto:java_ツールチェーン"-
Java proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル
タグ:affects_outputs
、loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
デフォルト: "@bazel_tools//tools/proto:javalite_ツールチェーン"-
JavaLite proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル
タグ:affects_outputs
、loading_and_analysis
--protocopt=<a string>
件の複数回の使用が累積される-
protobuf コンパイラに渡す追加オプション。
タグ:affects_outputs
--[no]runs_per_test_detects_flakes
デフォルト: 「false」- true の場合、1 つ以上の実行/試行が成功し、1 つ以上の実行/試行が失敗したシャードは、FLAKY ステータスになります。
--shell_executable=<a path>
デフォルト: 説明を参照-
Bazel が使用するシェル実行可能ファイルへの絶対パス。未設定で、最初の Bazel 呼び出し(Bazel サーバーを起動する)で BAZEL_SH 環境変数が設定されていると、Bazel ではその値が使用されます。どちらも設定されていない場合、Bazel は実行されているオペレーティング システムに応じてハードコードされたデフォルト パスを使用します(Windows: c:/tools/msys64/usr/bin/bash.exe、FreeBSD: /usr/local/bin/bash、その他: /bin/bash)。bash と互換性のないシェルを使用すると、生成されたバイナリのビルドエラーやランタイム エラーが発生する可能性があります。
タグ:loading_and_analysis
--[no]show_loading_progress
のデフォルト: 「true」- 有効にすると、Bazel から「Loading package:」というメッセージが表示されます。
--test_arg=<a string>
件の複数回の使用が累積される- テスト実行可能ファイルに渡す必要がある追加のオプションと引数を指定します。複数回使用して、複数の引数を指定できます。複数のテストが実行される場合、それぞれは同じ引数を受け取ります。「bazel test」コマンドでのみ使用されます。
--test_filter=<a string>
デフォルト: 説明を参照- テスト フレームワークに転送するフィルタを指定します。実行するテストを制限するために使用します。これは、ビルドされるターゲットには影響しません。
--test_lang_filters=<comma-separated list of options>
のデフォルト: ""- テスト言語のカンマ区切りリストを指定します。各言語の前に「-」を付けることで、除外する言語を指定できます(省略可)。指定した言語で記述されたテスト ターゲットのみが検出されます。各言語に使用する名前は、*_test ルールの言語接頭辞と同じにする必要があります(「cc」、「java」、「py」など)。このオプションは、--build_tests_only の動作とテストコマンドに影響します。
--test_result_expiration=<an integer>
デフォルト: 「-1」- このオプションは非推奨であり、機能しません。
--[no]test_runner_fail_fast
デフォルト: 「false」- テストランナーにフェイル ファスト オプションを転送する。テストランナーは、最初の失敗時に実行を停止する必要があります。
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
のデフォルト: "explicit"- テストのシャーディング戦略を指定します。「shard_count」の BUILD 属性が存在する場合にのみシャーディングを使用するには、「明示的」を指定します。テストのシャーディングを使用しない場合。「シャード_count」の BUILD 属性に関係なく「k」シャードをテストに強制適用する「forced=k」。
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
のデフォルト: ""- テストサイズのカンマ区切りリストを指定します。必要に応じて各サイズの先頭に「-」を付けると、除外するサイズを指定できます。含まれるサイズが 1 つ以上含まれ、除外したサイズが含まれていないテスト ターゲットのみが検出されます。このオプションは、--build_tests_only の動作とテストコマンドに影響します。
--test_tag_filters=<comma-separated list of options>
のデフォルト: ""- テストタグのカンマ区切りリストを指定します。必要に応じて各タグの前に「-」を付けると、除外するタグを指定できます。含まれるタグが 1 つ以上含み、除外されたタグを含まないテスト ターゲットのみが検出されます。このオプションは、--build_tests_only の動作とテストコマンドに影響します。
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
のデフォルト: ""- テストのタイムアウトのカンマ区切りリストを指定します。必要に応じて、各タイムアウトの前に「-」を付けると、除外するタイムアウトを指定できます。含まれるタイムアウトが 1 つ以上含まれ、除外されたタイムアウトを含まないテスト ターゲットのみが検出されます。このオプションは、--build_tests_only の動作とテストコマンドに影響します。
--tool_java_language_version=<a string>
のデフォルト: ""- ビルドで必要なツールの実行に使用される Java 言語のバージョン
--tool_java_runtime_version=<a string>
のデフォルト: "remotejdk_11"- ビルド中にツールを実行するために使用される Java ランタイム バージョン
--[no]use_ijars
のデフォルト: 「true」- 有効にすると、Java コンパイルでインターフェース JAR が使用されます。増分コンパイルは高速になりますが、エラー メッセージが異なる場合があります。
Canonicalize-flags オプション
build からすべてのオプションを継承します。
- コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path>
件の複数回の使用が累積される-
ネットワークにアクセスしてダウンロードする前に、アーカイブを検索できる場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
デフォルト: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュでファイルがコピーされずにハードリンクされます。これはディスク容量を節約することが目的です。
タグ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
のデフォルト: 「0」-
ダウンロード エラーの再試行の最大回数。0 に設定した場合、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: 1.0-
この要素に基づいて、Starlark リポジトリ ルールのすべてのタイムアウトをスケールします。これにより、ソースコードを変更せずに、ルール作成者の期待よりも低速なマシンで外部リポジトリを動作させることができます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
のデフォルト: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: 「0s」-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にした場合、タイムアウトの最大値は定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: 1.0-
HTTP ダウンロードに関連するすべてのタイムアウトを、指定された係数でスケーリングする
タグ:bazel_internal_configuration
--repository_cache=<a path>
デフォルト: 説明を参照-
外部リポジトリの取得中に取得された、ダウンロードした値のキャッシュ ロケーションを指定します。引数として空の文字列は、キャッシュの無効化をリクエストします。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
デフォルト: 「false」-
設定すると、リポジトリの取得中に resourcemanager.download{,_and_extract} を使用してダウンロードできなくなります。ネットワーク アクセスは完全に無効にされているわけではありません。インターネットにアクセスする任意の実行可能ファイルを resourcemanager.execute で実行することは可能です。
タグ:bazel_internal_configuration
- ビルド実行を制御するオプション:
--gc_thrashing_threshold=<an integer in 0-100 range>
のデフォルト: 「100」-
GcThrashingDetector がメモリ プレッシャー イベントを上限(--gc_thrashing_limits)と比較して考慮する、在職期間の占有スペースの割合(0 ~ 100)。100 に設定すると、GcThrashingDetector は無効になります。
タグ:host_machine_resource_optimizations
- コマンドの出力を制御するオプション:
--[no]canonicalize_policy
デフォルト: 「false」-
展開とフィルタリングの後に、正規ポリシーを出力します。出力をクリーンに保つために、このオプションを true に設定すると、正規化されたコマンド引数は表示されません。--for_command で指定されたコマンドはフィルタされたポリシーに影響します。指定しない場合、デフォルトのコマンドは「build」です。
タグ:affects_outputs
、terminal_output
--[no]experimental_include_default_values
デフォルト: 「false」-
デフォルト値に設定された Starlark オプションを出力に含めるかどうかを指定します。
タグ:affects_outputs
、terminal_output
- このオプションは、BUILD ファイル、.bzl ファイル、WORKSPACE ファイルからアクセス可能な Starlark 言語のセマンティクスまたは Build API のセマンティクスに影響します。
--[no]incompatible_config_setting_private_default_visibility
デフォルト: 「false」-
compatible_enforce_config_setting_visibility=false の場合、何も追加されません。このフラグが false の場合、明示的な可視性属性のない config_setting は //visibility:public です。このフラグが true の場合、config_setting は他のすべてのルールと同じ可視性ロジックに従います。https://github.com/bazelbuild/bazel/issues/12933 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_enforce_config_setting_visibility
のデフォルト: 「true」-
true の場合、config_setting 公開設定の制限を適用します。false の場合、すべての config_setting がすべてのターゲットに表示されます。https://github.com/bazelbuild/bazel/issues/12932 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
- Bzlmod の出力とセマンティクスに関連するオプション:
--allow_yanked_versions=<a string>
件の複数回の使用が累積される-
モジュール バージョンを「<module1>@<version1>,<module2>@<version2>」の形式で指定しました。これは、モジュール バージョンが元のレジストリでヤンクされていると宣言されていても(NonRegistryOverride からのものではない場合)、解決済みの依存関係グラフで許可します。そうしないと、バージョンをアンクすると解決が失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可するヤンク バージョンを定義することもできます。このチェックを無効にするには、キーワード「all」を使用します(非推奨)。
タグ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
デフォルト: "error"-
Bazel モジュールの bazel バージョン互換性を確認します。有効な値は、エラーを解決失敗にエスカレーションする場合は「error」、チェックを無効にする場合は「off」、不一致が検出されたときに警告を出力する場合は「warning」です。
タグ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
のデフォルト: 「warning」-
ルート モジュールで宣言されている直接的な「bazel_dep」依存関係が、解決された依存関係グラフで表示されるバージョンと同じかどうかを確認します。有効な値は、チェックを無効にする「off」、不一致が検出されたときに警告を出力する「warning」、解決失敗にエスカレーションする場合は「error」です。
タグ:loading_and_analysis
--[no]ignore_dev_dependency
デフォルト: 「false」-
true の場合、Bazel は、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」を無視します。これらの dev の依存関係は、このフラグの値に関係なく、ルート モジュールでない場合、MODULE.bazel では常に無視されることに注意してください。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: 「update」-
ロックファイルを使用する方法と使用するかどうかを指定します。有効な値は、「update」でロックファイルを使用し、変更がある場合に「error」を指定します。「error」はロックファイルを使用しますが、最新でない場合はエラーをスローします。「off」はロックファイルの読み取りも書き込みも行わない「off」です。
タグ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
件の複数回の使用が累積される- <モジュール名>=<パス> という形式のローカルパスでモジュールをオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。相対パスの場合は、現在の作業ディレクトリからの相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--registry=<a string>
件の複数回の使用が累積される-
Bazel モジュールの依存関係の検索に使用するレジストリを指定します。順序は重要です。モジュールは最初に以前のレジストリで検索され、以前のレジストリからモジュールが見つからなくなった場合にのみ、後のレジストリにフォールバックします。
タグ:changes_inputs
- ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
デフォルト: 「1s:2,20s:3,1m:5」-
上限に達すると GcThrashingDetector が OOM で Bazel をクラッシュさせる上限。各制限は、<period>:<count> の形式で指定します。[期間] は期間、[カウント] は正の整数です。<period> で <count> 回連続してフル GC を実行した後、残存容量(旧世代ヒープ)の --gc_thrashing_threshold パーセントを超える領域が占有されている場合、OOM がトリガーされます。複数の上限を指定する場合は、カンマで区切ってください。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出した場合、完全な GC イベントが発生したときに、不要な一時的な Skyframe の状態を呼び出しごとにこの回数まで破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、完全な GC イベントがドロップをトリガーしないことを意味します。上限に達すると、フル GC イベントが発生して保持されるヒープの割合のしきい値を超えたときに、スカイフレームの状態がドロップされなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出すると、マイナー GC イベントが発生したときに不要な一時的な Skyframe 状態を(呼び出しごとにこの回数まで)破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。上限に達すると、マイナー GC イベントが発生して保持されるヒープの割合のしきい値を超えても、スカイフレームの状態は破棄されなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
のデフォルト: 「85」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。Bazel は、保持されているヒープの割合がこのしきい値以上であることを検出すると、不要な一時的な Skyframe 状態を削除します。これを微調整することで、GC スラッシングが(i)この一時的な状態のメモリ使用量によって発生し、(ii)必要なときに状態の再構築よりもコストが高くなる場合に、GC スラッシングの経過時間への影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
- ロギングの詳細度、形式、場所に影響するオプション:
--[no]experimental_command_profile
デフォルト: 「false」- Java フライト レコーダーの CPU プロファイルを、出力ベース ディレクトリにある profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプや出力形式をサポートするために今後変更される可能性があります。ご自身の責任のもとで使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
デフォルト: 「false」- デフォルトでは、アクション タイプの数は、実行されるアクションの数が最も多い 20 個のニーモニックに限定されています。このオプションを設定すると、すべてのニーモニックの統計情報が書き込まれます。
- 他のカテゴリに当てはまらない Bazel コマンドへの汎用入力を指定または変更するオプション。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: ""-
空でない場合は、WORKSPACE ファイルではなく、指定された解決済みファイルを読み取ります。
タグ:changes_inputs
--for_command=<a string>
のデフォルト: "build"-
オプションを正規化するコマンド。
タグ:affects_outputs
、terminal_output
--invocation_policy=<a string>
のデフォルト: ""-
正規化するオプションに呼び出しポリシーを適用します。
タグ:affects_outputs
、terminal_output
- リモート キャッシュと実行のオプション:
--experimental_downloader_config=<a string>
デフォルト: 説明を参照- リモート ダウンローダーを構成するファイルを指定します。このファイルは複数の行で構成され、各行はディレクティブ(「allow」、「block」、「rewrite」)で始まり、その後にホスト名(「allow」と「block」のそれぞれ)または 2 つのパターン(1 つは照合され、もう 1 つは代替 URL として使用)が続きます。後方参照は「$1」から始まります。複数の「rewrite」ディレクティブが返される場合があります。同じ URL の場合は、複数の URL が返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: 「off」- リポジトリの取得に使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、「platform」に設定されている場合はプラットフォーム スレッド(OS スレッド)を使用し、「virtual」に設定されている場合は仮想スレッドを使用します。
- その他のカテゴリ(特に分類されていないもの):
--deleted_packages=<comma-separated list of package names>
件の複数回の使用が累積される- パッケージ名のカンマ区切りリスト。パッケージパス上のどこかに表示されていても、ビルドシステムによって存在しないと判断されます。 既存のパッケージ「x」のサブパッケージ「x/y」を削除する場合は、このオプションを使用します。たとえば、クライアントで x/y/BUILD を削除した後、別の package_path エントリによってラベル「//x:y/z」が見つかると、ビルドシステムからエラーが発生することがあります。--deleted_packages x/y を指定すると、この問題を回避できます。
--override_repository=<an equals-separated mapping of repository name to path>
件の複数回の使用が累積される- リポジトリは、<repository name>=<path> という形式のローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスがそのまま使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--package_path=<colon-separated list of options>
のデフォルト: 「%workspace%」- パッケージを検索する場所をコロンで区切ったリスト。「%workspace%」で始まる要素は、それを含むワークスペースからの相対値です。省略するか空の場合、デフォルトは「bazel info default-package-path」の出力です。
--[no]show_loading_progress
のデフォルト: 「true」- 有効にすると、Bazel から「Loading package:」というメッセージが表示されます。
クリーニング オプション
build からすべてのオプションを継承します。
- コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path>
件の複数回の使用が累積される-
ネットワークにアクセスしてダウンロードする前に、アーカイブを検索できる場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
デフォルト: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュでファイルがコピーされずにハードリンクされます。これはディスク容量を節約することが目的です。
タグ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
のデフォルト: 「0」-
ダウンロード エラーの再試行の最大回数。0 に設定した場合、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: 1.0-
この要素に基づいて、Starlark リポジトリ ルールのすべてのタイムアウトをスケールします。これにより、ソースコードを変更せずに、ルール作成者の期待よりも低速なマシンで外部リポジトリを動作させることができます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
のデフォルト: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: 「0s」-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にした場合、タイムアウトの最大値は定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: 1.0-
HTTP ダウンロードに関連するすべてのタイムアウトを、指定された係数でスケーリングする
タグ:bazel_internal_configuration
--repository_cache=<a path>
デフォルト: 説明を参照-
外部リポジトリの取得中に取得された、ダウンロードした値のキャッシュ ロケーションを指定します。引数として空の文字列は、キャッシュの無効化をリクエストします。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
デフォルト: 「false」-
設定すると、リポジトリの取得中に resourcemanager.download{,_and_extract} を使用してダウンロードできなくなります。ネットワーク アクセスは完全に無効にされているわけではありません。インターネットにアクセスする任意の実行可能ファイルを resourcemanager.execute で実行することは可能です。
タグ:bazel_internal_configuration
- ビルド実行を制御するオプション:
--gc_thrashing_threshold=<an integer in 0-100 range>
のデフォルト: 「100」-
GcThrashingDetector がメモリ プレッシャー イベントを上限(--gc_thrashing_limits)と比較して考慮する、在職期間の占有スペースの割合(0 ~ 100)。100 に設定すると、GcThrashingDetector は無効になります。
タグ:host_machine_resource_optimizations
- コマンドの出力を制御するオプション:
--[no]async
デフォルト: 「false」-
true の場合、出力クリーニングは非同期で行われます。このコマンドが完了したら、バックグラウンドで削除が続行されても、同じクライアントで新しいコマンドを実行しても安全です。
タグ:host_machine_resource_optimizations
--[no]expunge
デフォルト: 「false」-
true の場合、cle は bazel インスタンスの作業ツリー全体(bazel が作成したすべての一時出力ファイルとビルド出力ファイルを含む)を削除し、bazel サーバーが実行されている場合は停止します。
タグ:host_machine_resource_optimizations
--expunge_async
-
これを指定すると、Clean は bazel インスタンスの作業ツリー全体(bazel が作成したすべての一時ファイルとビルド出力ファイルを含む)を非同期で削除し、bazel サーバーが実行されている場合は停止します。このコマンドが完了したら、バックグラウンドで削除が続行されても、同じクライアントで新しいコマンドを実行しても安全です。
次のように展開します。
--expunge
--async
タグ:host_machine_resource_optimizations
- Bzlmod の出力とセマンティクスに関連するオプション:
--allow_yanked_versions=<a string>
件の複数回の使用が累積される-
モジュール バージョンを「<module1>@<version1>,<module2>@<version2>」の形式で指定しました。これは、モジュール バージョンが元のレジストリでヤンクされていると宣言されていても(NonRegistryOverride からのものではない場合)、解決済みの依存関係グラフで許可します。そうしないと、バージョンをアンクすると解決が失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可するヤンク バージョンを定義することもできます。このチェックを無効にするには、キーワード「all」を使用します(非推奨)。
タグ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
デフォルト: "error"-
Bazel モジュールの bazel バージョン互換性を確認します。有効な値は、エラーを解決失敗にエスカレーションする場合は「error」、チェックを無効にする場合は「off」、不一致が検出されたときに警告を出力する場合は「warning」です。
タグ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
のデフォルト: 「warning」-
ルート モジュールで宣言されている直接的な「bazel_dep」依存関係が、解決された依存関係グラフで表示されるバージョンと同じかどうかを確認します。有効な値は、チェックを無効にする「off」、不一致が検出されたときに警告を出力する「warning」、解決失敗にエスカレーションする場合は「error」です。
タグ:loading_and_analysis
--[no]ignore_dev_dependency
デフォルト: 「false」-
true の場合、Bazel は、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」を無視します。これらの dev の依存関係は、このフラグの値に関係なく、ルート モジュールでない場合、MODULE.bazel では常に無視されることに注意してください。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: 「update」-
ロックファイルを使用する方法と使用するかどうかを指定します。有効な値は、「update」でロックファイルを使用し、変更がある場合に「error」を指定します。「error」はロックファイルを使用しますが、最新でない場合はエラーをスローします。「off」はロックファイルの読み取りも書き込みも行わない「off」です。
タグ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
件の複数回の使用が累積される- <モジュール名>=<パス> という形式のローカルパスでモジュールをオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。相対パスの場合は、現在の作業ディレクトリからの相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--registry=<a string>
件の複数回の使用が累積される-
Bazel モジュールの依存関係の検索に使用するレジストリを指定します。順序は重要です。モジュールは最初に以前のレジストリで検索され、以前のレジストリからモジュールが見つからなくなった場合にのみ、後のレジストリにフォールバックします。
タグ:changes_inputs
- ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
デフォルト: 「1s:2,20s:3,1m:5」-
上限に達すると GcThrashingDetector が OOM で Bazel をクラッシュさせる上限。各制限は、<period>:<count> の形式で指定します。[期間] は期間、[カウント] は正の整数です。<period> で <count> 回連続してフル GC を実行した後、残存容量(旧世代ヒープ)の --gc_thrashing_threshold パーセントを超える領域が占有されている場合、OOM がトリガーされます。複数の上限を指定する場合は、カンマで区切ってください。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出した場合、完全な GC イベントが発生したときに、不要な一時的な Skyframe の状態を呼び出しごとにこの回数まで破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、完全な GC イベントがドロップをトリガーしないことを意味します。上限に達すると、フル GC イベントが発生して保持されるヒープの割合のしきい値を超えたときに、スカイフレームの状態がドロップされなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出すると、マイナー GC イベントが発生したときに不要な一時的な Skyframe 状態を(呼び出しごとにこの回数まで)破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。上限に達すると、マイナー GC イベントが発生して保持されるヒープの割合のしきい値を超えても、スカイフレームの状態は破棄されなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
のデフォルト: 「85」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。Bazel は、保持されているヒープの割合がこのしきい値以上であることを検出すると、不要な一時的な Skyframe 状態を削除します。これを微調整することで、GC スラッシングが(i)この一時的な状態のメモリ使用量によって発生し、(ii)必要なときに状態の再構築よりもコストが高くなる場合に、GC スラッシングの経過時間への影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
- ロギングの詳細度、形式、場所に影響するオプション:
--[no]experimental_command_profile
デフォルト: 「false」- Java フライト レコーダーの CPU プロファイルを、出力ベース ディレクトリにある profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプや出力形式をサポートするために今後変更される可能性があります。ご自身の責任のもとで使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
デフォルト: 「false」- デフォルトでは、アクション タイプの数は、実行されるアクションの数が最も多い 20 個のニーモニックに限定されています。このオプションを設定すると、すべてのニーモニックの統計情報が書き込まれます。
- 他のカテゴリに当てはまらない Bazel コマンドへの汎用入力を指定または変更するオプション。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: ""-
空でない場合は、WORKSPACE ファイルではなく、指定された解決済みファイルを読み取ります。
タグ:changes_inputs
- リモート キャッシュと実行オプション:
--experimental_downloader_config=<a string>
デフォルト: 説明を参照- リモート ダウンローダーを構成するファイルを指定します。このファイルは複数の行で構成され、各行はディレクティブ(「allow」、「block」、「rewrite」)で始まり、その後にホスト名(「allow」と「block」のそれぞれ)または 2 つのパターン(1 つは照合され、もう 1 つは代替 URL として使用)が続きます。後方参照は「$1」から始まります。複数の「rewrite」ディレクティブが返される場合があります。同じ URL の場合は、複数の URL が返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: 「off」- リポジトリの取得に使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、「platform」に設定されている場合はプラットフォーム スレッド(OS スレッド)を使用し、「virtual」に設定されている場合は仮想スレッドを使用します。
- その他のカテゴリ(特に分類されていないもの):
--override_repository=<an equals-separated mapping of repository name to path>
件の複数回の使用が累積される- リポジトリは、<repository name>=<path> という形式のローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスがそのまま使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
構成オプション
通信可能範囲のオプション
test からすべてのオプションを継承します。
- コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path>
件の複数回の使用が累積される-
ネットワークにアクセスしてダウンロードする前に、アーカイブを検索できる場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
デフォルト: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュでファイルがコピーされずにハードリンクされます。これはディスク容量を節約することが目的です。
タグ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
のデフォルト: 「0」-
ダウンロード エラーの再試行の最大回数。0 に設定した場合、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: 1.0-
この要素に基づいて、Starlark リポジトリ ルールのすべてのタイムアウトをスケールします。これにより、ソースコードを変更せずに、ルール作成者の期待よりも低速なマシンで外部リポジトリを動作させることができます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
のデフォルト: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: 「0s」-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にした場合、タイムアウトの最大値は定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: 1.0-
HTTP ダウンロードに関連するすべてのタイムアウトを、指定された係数でスケーリングする
タグ:bazel_internal_configuration
--repository_cache=<a path>
デフォルト: 説明を参照-
外部リポジトリの取得中に取得された、ダウンロードした値のキャッシュ ロケーションを指定します。引数として空の文字列は、キャッシュの無効化をリクエストします。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
デフォルト: 「false」-
設定すると、リポジトリの取得中に resourcemanager.download{,_and_extract} を使用してダウンロードできなくなります。ネットワーク アクセスは完全に無効にされているわけではありません。インターネットにアクセスする任意の実行可能ファイルを resourcemanager.execute で実行することは可能です。
タグ:bazel_internal_configuration
- ビルド実行を制御するオプション:
--gc_thrashing_threshold=<an integer in 0-100 range>
のデフォルト: 「100」-
GcThrashingDetector がメモリ プレッシャー イベントを上限(--gc_thrashing_limits)と比較して考慮する、在職期間の占有スペースの割合(0 ~ 100)。100 に設定すると、GcThrashingDetector は無効になります。
タグ:host_machine_resource_optimizations
- Bzlmod の出力とセマンティクスに関連するオプション:
--allow_yanked_versions=<a string>
件の複数回の使用が累積される-
モジュール バージョンを「<module1>@<version1>,<module2>@<version2>」の形式で指定しました。これは、モジュール バージョンが元のレジストリでヤンクされていると宣言されていても(NonRegistryOverride からのものではない場合)、解決済みの依存関係グラフで許可します。そうしないと、バージョンをアンクすると解決が失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可するヤンク バージョンを定義することもできます。このチェックを無効にするには、キーワード「all」を使用します(非推奨)。
タグ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
デフォルト: "error"-
Bazel モジュールの bazel バージョン互換性を確認します。有効な値は、エラーを解決失敗にエスカレーションする場合は「error」、チェックを無効にする場合は「off」、不一致が検出されたときに警告を出力する場合は「warning」です。
タグ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
のデフォルト: 「warning」-
ルート モジュールで宣言されている直接的な「bazel_dep」依存関係が、解決された依存関係グラフで表示されるバージョンと同じかどうかを確認します。有効な値は、チェックを無効にする「off」、不一致が検出されたときに警告を出力する「warning」、解決失敗にエスカレーションする場合は「error」です。
タグ:loading_and_analysis
--[no]ignore_dev_dependency
デフォルト: 「false」-
true の場合、Bazel は、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」を無視します。これらの dev の依存関係は、このフラグの値に関係なく、ルート モジュールでない場合、MODULE.bazel では常に無視されることに注意してください。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: 「update」-
ロックファイルを使用する方法と使用するかどうかを指定します。有効な値は、「update」でロックファイルを使用し、変更がある場合に「error」を指定します。「error」はロックファイルを使用しますが、最新でない場合はエラーをスローします。「off」はロックファイルの読み取りも書き込みも行わない「off」です。
タグ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
件の複数回の使用が累積される- <モジュール名>=<パス> という形式のローカルパスでモジュールをオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。相対パスの場合は、現在の作業ディレクトリからの相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--registry=<a string>
件の複数回の使用が累積される-
Bazel モジュールの依存関係の検索に使用するレジストリを指定します。順序は重要です。モジュールは最初に以前のレジストリで検索され、以前のレジストリからモジュールが見つからなくなった場合にのみ、後のレジストリにフォールバックします。
タグ:changes_inputs
- ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
デフォルト: 「1s:2,20s:3,1m:5」-
上限に達すると GcThrashingDetector が OOM で Bazel をクラッシュさせる上限。各制限は、<period>:<count> の形式で指定します。[期間] は期間、[カウント] は正の整数です。<period> で <count> 回連続してフル GC を実行した後、残存容量(旧世代ヒープ)の --gc_thrashing_threshold パーセントを超える領域が占有されている場合、OOM がトリガーされます。複数の上限を指定する場合は、カンマで区切ってください。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出した場合、完全な GC イベントが発生したときに、不要な一時的な Skyframe の状態を呼び出しごとにこの回数まで破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、完全な GC イベントがドロップをトリガーしないことを意味します。上限に達すると、フル GC イベントが発生して保持されるヒープの割合のしきい値を超えたときに、スカイフレームの状態がドロップされなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出すると、マイナー GC イベントが発生したときに不要な一時的な Skyframe 状態を(呼び出しごとにこの回数まで)破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。上限に達すると、マイナー GC イベントが発生して保持されるヒープの割合のしきい値を超えても、スカイフレームの状態は破棄されなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
のデフォルト: 「85」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。Bazel は、保持されているヒープの割合がこのしきい値以上であることを検出すると、不要な一時的な Skyframe 状態を削除します。これを微調整することで、GC スラッシングが(i)この一時的な状態のメモリ使用量によって発生し、(ii)必要なときに状態の再構築よりもコストが高くなる場合に、GC スラッシングの経過時間への影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
- ロギングの詳細度、形式、場所に影響するオプション:
--[no]experimental_command_profile
デフォルト: 「false」- Java フライト レコーダーの CPU プロファイルを、出力ベース ディレクトリにある profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプや出力形式をサポートするために今後変更される可能性があります。ご自身の責任のもとで使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
デフォルト: 「false」- デフォルトでは、アクション タイプの数は、実行されるアクションの数が最も多い 20 個のニーモニックに限定されています。このオプションを設定すると、すべてのニーモニックの統計情報が書き込まれます。
- 他のカテゴリに当てはまらない Bazel コマンドへの汎用入力を指定または変更するオプション。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: ""-
空でない場合は、WORKSPACE ファイルではなく、指定された解決済みファイルを読み取ります。
タグ:changes_inputs
- リモート キャッシュと実行オプション:
--experimental_downloader_config=<a string>
デフォルト: 説明を参照- リモート ダウンローダーを構成するファイルを指定します。このファイルは複数の行で構成され、各行はディレクティブ(「allow」、「block」、「rewrite」)で始まり、その後にホスト名(「allow」と「block」のそれぞれ)または 2 つのパターン(1 つは照合され、もう 1 つは代替 URL として使用)が続きます。後方参照は「$1」から始まります。複数の「rewrite」ディレクティブが返される場合があります。同じ URL の場合は、複数の URL が返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: 「off」- リポジトリの取得に使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、「platform」に設定されている場合はプラットフォーム スレッド(OS スレッド)を使用し、「virtual」に設定されている場合は仮想スレッドを使用します。
- その他のカテゴリ(特に分類されていないもの):
--override_repository=<an equals-separated mapping of repository name to path>
件の複数回の使用が累積される- リポジトリは、<repository name>=<path> という形式のローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスがそのまま使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
Cquery オプション
test からすべてのオプションを継承します。
- コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path>
件の複数回の使用が累積される-
ネットワークにアクセスしてダウンロードする前に、アーカイブを検索できる場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
デフォルト: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュでファイルがコピーされずにハードリンクされます。これはディスク容量を節約することが目的です。
タグ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
のデフォルト: 「0」-
ダウンロード エラーの再試行の最大回数。0 に設定した場合、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: 1.0-
この要素に基づいて、Starlark リポジトリ ルールのすべてのタイムアウトをスケールします。これにより、ソースコードを変更せずに、ルール作成者の期待よりも低速なマシンで外部リポジトリを動作させることができます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
のデフォルト: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: 「0s」-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にした場合、タイムアウトの最大値は定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: 1.0-
HTTP ダウンロードに関連するすべてのタイムアウトを、指定された係数でスケーリングする
タグ:bazel_internal_configuration
--repository_cache=<a path>
デフォルト: 説明を参照-
外部リポジトリの取得中に取得された、ダウンロードした値のキャッシュ ロケーションを指定します。引数として空の文字列は、キャッシュの無効化をリクエストします。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
デフォルト: 「false」-
設定すると、リポジトリの取得中に resourcemanager.download{,_and_extract} を使用してダウンロードできなくなります。ネットワーク アクセスは完全に無効にされているわけではありません。インターネットにアクセスする任意の実行可能ファイルを resourcemanager.execute で実行することは可能です。
タグ:bazel_internal_configuration
- ビルド実行を制御するオプション:
--gc_thrashing_threshold=<an integer in 0-100 range>
のデフォルト: 「100」-
GcThrashingDetector がメモリ プレッシャー イベントを上限(--gc_thrashing_limits)と比較して考慮する、在職期間の占有スペースの割合(0 ~ 100)。100 に設定すると、GcThrashingDetector は無効になります。
タグ:host_machine_resource_optimizations
- クエリの出力とセマンティクスに関連するオプション:
--aspect_deps=<off, conservative or precise>
のデフォルト: "conservative"-
出力形式が {xml,proto,record} のいずれかの場合に、アスペクトの依存関係を解決する方法。「off」は、アスペクトの依存関係が解決されないことを意味します。「conservative」(デフォルト)は、宣言されたすべてのアスペクト依存関係が、直接的な依存関係のルールクラスが与えられるかどうかにかかわらず、追加されることを意味します。「正確」は、直接的な依存関係のルールクラスが与えられている可能性のあるアスペクトのみが追加されることを意味します。高精度モードでは、1 つのターゲットを評価するために他のパッケージを読み込む必要があるため、他のモードよりも遅くなります。また、精密モードであっても完全に正確というわけではありません。アスペクトを計算するかどうかは、分析フェーズで決定され、bazel クエリでは実行されません。
タグ:build_file_semantics
--[no]consistent_labels
デフォルト: 「false」-
有効にすると、すべてのクエリコマンドは、<code>Label</code> インスタンスに適用された Starlark <code>str</code> 関数であるかのようにラベルを出力します。これは、さまざまなクエリ コマンドの出力やルールによって発行されたラベルを照合する必要があるツールに便利です。有効になっていない場合、出力フォーマッタは、出力を読みやすくするために、明らかなリポジトリ名(メイン リポジトリからの相対名)を自由に出力できます。
タグ:terminal_output
--[no]graph:factored
のデフォルト: 「true」-
true の場合、グラフは「因数分解された」状態で出力されます。つまり、トポロジ的に同等のノードがマージされ、それらのラベルが連結されます。このオプションは --output=graph にのみ適用されます。
タグ:terminal_output
--graph:node_limit=<an integer>
のデフォルト: 「512」-
出力内のグラフノードのラベル文字列の最大長。長いラベルは切り捨てられます。-1 を指定すると、切り捨てられません。このオプションは --output=graph にのみ適用されます。
タグ:terminal_output
--[no]implicit_deps
のデフォルト: 「true」-
有効にすると、クエリが実行される依存関係グラフに暗黙的な依存関係が含まれます。暗黙的な依存関係とは、BUILD ファイルで明示的に指定されていないものの、bazel によって追加された依存関係のことです。cquery の場合、解決されたツールチェーンのフィルタリングを制御します。
タグ:build_file_semantics
--[no]include_aspects
のデフォルト: 「true」-
aquery、cquery: アスペクトによって生成されたアクションを出力に含めるかどうか。query: no-op(アスペクトは常に追跡されます)。
タグ:terminal_output
--[no]incompatible_package_group_includes_double_slash
のデフォルト: 「true」-
有効にすると、package_group の「packages」属性を出力するときに、先頭の「//」は省略されません。
タグ:terminal_output
、incompatible_change
--[no]infer_universe_scope
デフォルト: 「false」-
設定されていて、--universe_scope が設定されていない場合、--universe_scope の値は、クエリ式内の一意のターゲット パターンのリストとして推定されます。ユニバース スコープの関数(allrdeps など)を使用するクエリ式で推測される --universe_scope の値は、望ましくない可能性があるので、実行する処理がわかっている場合にのみ、このオプションを使用してください。詳細と例については、https://bazel.build/reference/query#sky-query をご覧ください。--universe_scope が設定されている場合、このオプションの値は無視されます。注: このオプションは「query」にのみ適用されます(つまり、「cquery」には適用されません)。
タグ:loading_and_analysis
--[no]line_terminator_null
デフォルト: 「false」-
各形式が改行ではなく \0 で終了しているかどうか。
タグ:terminal_output
--[no]nodep_deps
のデフォルト: 「true」-
有効にすると、"nodep" 属性からの依存関係が、クエリを操作する依存関係グラフに含まれます。「nodep」属性の一般的な例としては、「visibility」があります。「info build-language」の出力を実行して解析し、ビルド言語のすべての「nodep」属性を確認します。
タグ:build_file_semantics
--output=<a string>
のデフォルト: 「label」-
cquery の結果が出力される形式。cquery に使用できる値は、label、label_kind、textproto、transitions、proto、streamed_proto、jsonproto です。「transitions」を選択する場合は、--transitions=(lite|full) オプションも指定する必要があります。
タグ:terminal_output
--[no]proto:default_values
のデフォルト: 「true」-
true の場合、BUILD ファイルで値が明示的に指定されていない属性が含まれます。それ以外の場合は省略されます。このオプションは --output=proto に適用されます。
タグ:terminal_output
--[no]proto:definition_stack
デフォルト: 「false」-
Definition_stack proto フィールドに、ルールのクラスが定義された時点の Starlark コールスタックをルール インスタンスごとに記録します。
タグ:terminal_output
--[no]proto:flatten_selects
のデフォルト: 「true」-
有効にすると、select() によって作成された構成可能な属性がフラット化されます。リストタイプの場合、フラット表現は、セレクトマップの各値を 1 回だけ含むリストです。スカラー型は null にフラット化されます。
タグ:build_file_semantics
--[no]proto:include_attribute_source_aspects
デフォルト: 「false」-
各属性の source_aspect_name proto フィールドに、属性の取得元であるソースのアスペクトを入力します(そうでない場合は空の文字列)。
タグ:terminal_output
--[no]proto:include_configurations
のデフォルト: 「true」- を有効にすると、proto 出力に構成に関する情報が含まれます。無効にすると、cquery proto の出力形式はクエリの出力形式と同様になります。
タグ:affects_outputs
--[no]proto:include_synthetic_attribute_hash
デフォルト: 「false」- $internal_attr_hash 属性を計算して入力するかどうかを指定します。
タグ:terminal_output
--[no]proto:instantiation_stack
デフォルト: 「false」-
各ルールのインスタンス化コールスタックにデータを入力します。これを行うには、スタックが存在する必要があります。
タグ:terminal_output
--[no]proto:locations
のデフォルト: 「true」-
proto 出力で位置情報を出力するかどうか。
タグ:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
のデフォルト: 「all」-
出力に含める属性のカンマ区切りリスト。デフォルトはすべての属性です。属性を出力しない場合は、空の文字列に設定します。このオプションは --output=proto に適用できます。
タグ:terminal_output
--[no]proto:rule_inputs_and_outputs
のデフォルト: 「true」-
rule_input と rule_output の各フィールドにデータを入力するかどうかを指定します。
タグ:terminal_output
--query_file=<a string>
のデフォルト: ""-
設定すると、クエリはコマンドラインではなく、ここで指定したファイルからクエリを読み取ります。ここでファイルを指定してコマンドライン クエリを指定するとエラーになります。
タグ:changes_inputs
--[no]relative_locations
デフォルト: 「false」-
true の場合、xml 出力と proto 出力での BUILD ファイルの場所は相対的になります。デフォルトでは、場所の出力は絶対パスであり、マシン間で一貫していません。このオプションを true に設定すると、マシン全体で一貫した結果が得られます。
タグ:terminal_output
--show_config_fragments=<off, direct or transitive>
のデフォルト: 「off」-
ルールに必要な構成フラグメントとその推移的な依存関係が表示されます。これは、構成したターゲット グラフをどの程度トリミングできるかを評価する際に役立ちます。
タグ:affects_outputs
--starlark:expr=<a string>
のデフォルト: ""-
構成された各ターゲットを cquery の --output=starlark モードでフォーマットするための Starlark 式。構成されたターゲットは「ターゲット」にバインドされます。--starlark:expr も --starlark:file も指定されていない場合、このオプションはデフォルトで「str(target.label)」になります。--starlark:expr と --starlark:file の両方を指定するとエラーになります。
タグ:terminal_output
--starlark:file=<a string>
のデフォルト: ""-
「format」という Starlark 関数を定義する 1 つの引数の名前。文字列としてフォーマットするために、構成済みの各ターゲットに適用されます。--starlark:expr と --starlark:file の両方を指定するとエラーになります。詳細については、--output=starlark のヘルプをご覧ください。
タグ:terminal_output
--[no]tool_deps
のデフォルト: 「true」-
クエリ: 無効にすると、クエリの実行対象となる依存関係グラフに「実行構成」の依存関係は含まれません。「proto_library」ルールから Protocol Compiler までの「exec 構成」依存関係エッジは通常、同じ「ターゲット」プログラムの一部ではなく、ビルド中に実行されたツールを指します。
Cquery: 無効にすると、この構成済みターゲットを検出した最上位ターゲットから実行移行を通過する構成済みターゲットがすべて除外されます。つまり、最上位のターゲットがターゲット構成に含まれている場合は、そのターゲット構成にも構成済みのターゲットのみが返されます。最上位のターゲットが exec 構成に含まれている場合は、exec 構成のターゲットのみが返されます。このオプションは、解決済みのツールチェーンを除外しません。
タグ:build_file_semantics
--transitions=<full, lite or none>
のデフォルト: 「なし」-
cquery が遷移情報を出力する形式。
タグ:affects_outputs
--universe_scope=<comma-separated list of options>
のデフォルト: ""-
カンマ区切りのターゲット パターンのセット(加法と減算)。クエリは、指定されたターゲットの推移的クロージャで定義されたユニバースで実行できます。このオプションは、query コマンドと cquery コマンドで使用されます。cquery の場合、このオプションに入力する値はすべての回答がビルドされるターゲットとなるため、このオプションは構成や遷移に影響する可能性があります。このオプションが指定されていない場合、トップレベル ターゲットはクエリ式から解析されたターゲットと見なされます。注: cquery でこのオプションを指定しないと、クエリ式から解析されたターゲットがトップレベル オプションでビルドできない場合、ビルドが中断されることがあります。
タグ:loading_and_analysis
- Bzlmod の出力とセマンティクスに関連するオプション:
--allow_yanked_versions=<a string>
件の複数回の使用が累積される-
モジュール バージョンを「<module1>@<version1>,<module2>@<version2>」の形式で指定しました。これは、モジュール バージョンが元のレジストリでヤンクされていると宣言されていても(NonRegistryOverride からのものではない場合)、解決済みの依存関係グラフで許可します。そうしないと、バージョンをアンクすると解決が失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可するヤンク バージョンを定義することもできます。このチェックを無効にするには、キーワード「all」を使用します(非推奨)。
タグ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
デフォルト: "error"-
Bazel モジュールの bazel バージョン互換性を確認します。有効な値は、エラーを解決失敗にエスカレーションする場合は「error」、チェックを無効にする場合は「off」、不一致が検出されたときに警告を出力する場合は「warning」です。
タグ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
のデフォルト: 「warning」-
ルート モジュールで宣言されている直接的な「bazel_dep」依存関係が、解決された依存関係グラフで表示されるバージョンと同じかどうかを確認します。有効な値は、チェックを無効にする「off」、不一致が検出されたときに警告を出力する「warning」、解決失敗にエスカレーションする場合は「error」です。
タグ:loading_and_analysis
--[no]ignore_dev_dependency
デフォルト: 「false」-
true の場合、Bazel は、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」を無視します。これらの dev の依存関係は、このフラグの値に関係なく、ルート モジュールでない場合、MODULE.bazel では常に無視されることに注意してください。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: 「update」-
ロックファイルを使用する方法と使用するかどうかを指定します。有効な値は、「update」でロックファイルを使用し、変更がある場合に「error」を指定します。「error」はロックファイルを使用しますが、最新でない場合はエラーをスローします。「off」はロックファイルの読み取りも書き込みも行わない「off」です。
タグ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
件の複数回の使用が累積される- <モジュール名>=<パス> という形式のローカルパスでモジュールをオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。相対パスの場合は、現在の作業ディレクトリからの相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--registry=<a string>
件の複数回の使用が累積される-
Bazel モジュールの依存関係の検索に使用するレジストリを指定します。順序は重要です。モジュールは最初に以前のレジストリで検索され、以前のレジストリからモジュールが見つからなくなった場合にのみ、後のレジストリにフォールバックします。
タグ:changes_inputs
- ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
デフォルト: 「1s:2,20s:3,1m:5」-
上限に達すると GcThrashingDetector が OOM で Bazel をクラッシュさせる上限。各制限は、<period>:<count> の形式で指定します。[期間] は期間、[カウント] は正の整数です。<period> で <count> 回連続してフル GC を実行した後、残存容量(旧世代ヒープ)の --gc_thrashing_threshold パーセントを超える領域が占有されている場合、OOM がトリガーされます。複数の上限を指定する場合は、カンマで区切ってください。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出した場合、完全な GC イベントが発生したときに、不要な一時的な Skyframe の状態を呼び出しごとにこの回数まで破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、完全な GC イベントがドロップをトリガーしないことを意味します。上限に達すると、フル GC イベントが発生して保持されるヒープの割合のしきい値を超えたときに、スカイフレームの状態がドロップされなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出すると、マイナー GC イベントが発生したときに不要な一時的な Skyframe 状態を(呼び出しごとにこの回数まで)破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。上限に達すると、マイナー GC イベントが発生して保持されるヒープの割合のしきい値を超えても、スカイフレームの状態は破棄されなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
のデフォルト: 「85」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。Bazel は、保持されているヒープの割合がこのしきい値以上であることを検出すると、不要な一時的な Skyframe 状態を削除します。これを微調整することで、GC スラッシングが(i)この一時的な状態のメモリ使用量によって発生し、(ii)必要なときに状態の再構築よりもコストが高くなる場合に、GC スラッシングの経過時間への影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
- ロギングの詳細度、形式、場所に影響するオプション:
--[no]experimental_command_profile
デフォルト: 「false」- Java フライト レコーダーの CPU プロファイルを、出力ベース ディレクトリにある profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプや出力形式をサポートするために今後変更される可能性があります。ご自身の責任のもとで使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
デフォルト: 「false」- デフォルトでは、アクション タイプの数は、実行されるアクションの数が最も多い 20 個のニーモニックに限定されています。このオプションを設定すると、すべてのニーモニックの統計情報が書き込まれます。
- 他のカテゴリに当てはまらない Bazel コマンドへの汎用入力を指定または変更するオプション。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: ""-
空でない場合は、WORKSPACE ファイルではなく、指定された解決済みファイルを読み取ります。
タグ:changes_inputs
- リモート キャッシュと実行オプション:
--experimental_downloader_config=<a string>
デフォルト: 説明を参照- リモート ダウンローダーを構成するファイルを指定します。このファイルは複数の行で構成され、各行はディレクティブ(「allow」、「block」、「rewrite」)で始まり、その後にホスト名(「allow」と「block」のそれぞれ)または 2 つのパターン(1 つは照合され、もう 1 つは代替 URL として使用)が続きます。後方参照は「$1」から始まります。複数の「rewrite」ディレクティブが返される場合があります。同じ URL の場合は、複数の URL が返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: 「off」- リポジトリの取得に使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、「platform」に設定されている場合はプラットフォーム スレッド(OS スレッド)を使用し、「virtual」に設定されている場合は仮想スレッドを使用します。
- その他のカテゴリ(特に分類されていないもの):
--override_repository=<an equals-separated mapping of repository name to path>
件の複数回の使用が累積される- リポジトリは、<repository name>=<path> という形式のローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスがそのまま使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定したパスが「%workspace%」で始まる場合は、ワークスペースのルートからの相対パス(「bazel info workspace」の出力)になります
- ビルド実行を制御するオプション:
--[no]experimental_inprocess_symlink_creation
デフォルト: 「false」-
直接ファイル システム呼び出しを行ってシンボリック リンク ツリーを作成するかどうか
タグ:loading_and_analysis
、execution
、experimental
--[no]experimental_persistent_aar_extractor
デフォルト: 「false」-
ワーカーを使用して永続 AAR エクストラクタを有効にします。
タグ:execution
--[no]experimental_remotable_source_manifests
デフォルト: 「false」-
ソース マニフェストのアクションをリモート可能にするかどうか
タグ:loading_and_analysis
、execution
、experimental
--[no]experimental_split_coverage_postprocessing
デフォルト: 「false」-
true の場合、Bazel は新しい Spawn でテストのためにカバレッジの後処理を実行します。
タグ:execution
--[no]experimental_strict_fileset_output
デフォルト: 「false」-
このオプションを有効にすると、ファイルセットはすべての出力アーティファクトを通常のファイルとして扱います。ディレクトリを移動したり、シンボリック リンクの影響を受けたりすることはありません。
タグ:execution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
のデフォルト: ""-
アクションのニーモニックに基づいて、アクションの実行情報からキーを追加または削除します。実行情報をサポートするアクションにのみ適用されます。Genrule、CppCompile、Javac、StarlarkAction、TestRunner など、多くの一般的なアクションが実行情報をサポートしています。複数の値を指定する場合、多くの正規表現が同じニーモニックに適用される可能性があるため、順序が重要です。構文: "regex=[+-]key,regex=[+-]key,..."。
例: '.*=+x,.*=-y,.*=+z' は、すべてのアクションの実行情報に「x」と「z」を追加し、実行情報から「y」を削除します。
「Genrule=+requires-x」は、すべての Genrule アクションの実行情報に「requires-x」を追加します。
「(?!Genrule).*=-requires-x」は、Genrule 以外のすべてのアクションの実行情報から「requires-x」を削除します。
タグ:execution
、affects_outputs
、loading_and_analysis
--persistent_android_dex_desugar
-
ワーカーを使用して、永続的な Android dex および desugar アクションを有効にします。
次のように展開します。
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
タグ:host_machine_resource_optimizations
、execution
--persistent_android_resource_processor
-
ワーカーを使用して、永続的な Android リソース プロセッサを有効にします。
次のように展開:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=Aapt2Optimize=worker
--strategy=AARGenerator=worker
--strategy=ProcessDatabinding=worker
--strategy=GenerateDataBindingBaseClasses=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_desugar
-
ワーカーを使用して、永続的な多重化された Android dex アクションと desugar アクションを有効にします。
展開先:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
タグ:host_machine_resource_optimizations
、execution
--persistent_multiplex_android_resource_processor
-
ワーカーを使用して、永続的な多重化された Android リソース プロセッサを有効にします。
次のように拡張:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
-
永続的な多重化 Android ツール(dex 変換、脱糖、リソース処理)を有効にします。
次のように展開します。
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
タグ:host_machine_resource_optimizations
、execution
--[no]use_target_platform_for_tests
デフォルト: 「false」-
true の場合、Bazel はテスト実行グループではなく、ターゲット プラットフォームを使用してテストを実行します。
タグ:execution
- アクションの実行に使用するツールチェーンを構成するオプション:
--android_compiler=<a string>
デフォルト: 説明を参照-
Android ターゲット コンパイラ。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--android_crosstool_top=<a build target label>
のデフォルト: 「//external:android/crosstool」-
Android ビルドに使用される C++ コンパイラの場所。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
、loses_incremental_state
--android_grte_top=<a label>
デフォルト: 説明を参照-
Android ターゲット grte_top。
タグ:changes_inputs
、loading_and_analysis
、loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
のデフォルト: 「android」-
android_binary ルールに使用するマニフェスト マージを選択します。以前のマージから Android マニフェスト マージに移行するためのフラグ。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--android_platforms=<a build target label>
のデフォルト: ""-
android_binary ターゲットが使用するプラットフォームを設定します。複数のプラットフォームが指定されている場合、バイナリはファット APK になります。これには、指定した各ターゲット プラットフォームのネイティブ バイナリが含まれます。
タグ:changes_inputs
、loading_and_analysis
、loses_incremental_state
--android_sdk=<a build target label>
のデフォルト: "@bazel_tools//tools/android:sdk"-
Android アプリのビルドに使用する Android SDK/プラットフォームを指定します。
タグ:changes_inputs
、loading_and_analysis
、loses_incremental_state
--apple_crosstool_top=<a build target label>
のデフォルト: "@bazel_tools//tools/cpp:ツールチェーン"-
Apple と Objc のルールとその依存関係で使用される crosstool パッケージのラベル。
タグ:loses_incremental_state
、changes_inputs
--cc_output_directory_tag=<a string>
のデフォルト: ""-
構成ディレクトリに追加する接尾辞を指定します。
タグ:affects_outputs
--compiler=<a string>
デフォルト: 説明を参照-
ターゲットのコンパイルに使用する C++ コンパイラ。
タグ:loading_and_analysis
、execution
--coverage_output_generator=<a build target label>
のデフォルト: "@bazel_tools//tools/test:lcov_merger"-
未処理のカバレッジ レポートの後処理に使用されるバイナリの場所。これは現在は、単一のファイル(バイナリ)を含むファイル グループである必要があります。デフォルトは「//tools/test:lcov_merger」です。
タグ:changes_inputs
、affects_outputs
、loading_and_analysis
--coverage_report_generator=<a build target label>
デフォルト: "@bazel_tools//tools/test:coverage_report_generator"-
カバレッジ レポートの生成に使用されるバイナリの場所。これは現在は、単一のファイル(バイナリ)を含むファイル グループである必要があります。デフォルトは「//tools/test:coverage_report_generator」です。
タグ:changes_inputs
、affects_outputs
、loading_and_analysis
--coverage_support=<a build target label>
デフォルト: "@bazel_tools//tools/test:coverage_support"-
コード カバレッジを収集するすべてのテスト アクションの入力で必要となるサポート ファイルの場所。デフォルトは「//tools/test:coverage_support」です。
タグ:changes_inputs
、affects_outputs
、loading_and_analysis
--crosstool_top=<a build target label>
のデフォルト: "@bazel_tools//tools/cpp:ツールチェーン"-
C++ コードのコンパイルに使用されるクロスツール パッケージのラベル。
タグ:loading_and_analysis
、changes_inputs
、affects_outputs
--custom_malloc=<a build target label>
デフォルト: 説明を参照-
カスタムの malloc 実装を指定します。この設定は、ビルドルールの malloc 属性をオーバーライドします。
タグ:changes_inputs
、affects_outputs
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
件の複数回の使用が累積される-
正規表現のカンマ区切りのリスト。接頭辞として -(負の式)を付けることもできます。正規表現は、カンマ区切りの制約値ターゲットのリストに「=」を代入します。ターゲットが負の式と一致せず、少なくとも 1 つの正の式と一致した場合、制約値を実行制約として宣言した場合と同様に、ツールチェーンの解決が実行されます。例: //demo,-test=@platforms//cpus:x86_64 を指定すると、//demo の下のすべてのターゲットに 'x86_64' が追加されます。ただし、名前に「test」が含まれるものは除きます。
タグ:loading_and_analysis
--[no]experimental_include_xcode_execution_requirements
デフォルト: 「false」-
設定した場合は、すべての Xcode アクションに "requires-xcode:{version}" 実行要件を追加します。xcode バージョンにハイフン付きのラベルがある場合は、「requires-xcode-label:{version_label}」実行要件も追加します。
タグ:loses_incremental_state
、loading_and_analysis
、execution
--[no]experimental_prefer_mutual_xcode
のデフォルト: 「true」-
true の場合、ローカルとリモートの両方で利用可能な最新の Xcode を使用します。false の場合、または相互利用可能なバージョンがない場合は、xcode-select で選択したローカルの Xcode バージョンを使用します。
タグ:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
のデフォルト: ""-
アクションを実行するための実行プラットフォームとして利用可能なプラットフォーム。プラットフォームは、正確なターゲットで、またはターゲット パターンとして指定できます。これらのプラットフォームは、register_execution_platforms() によって WORKSPACE ファイルで宣言されたプラットフォームより先に検討されます。このオプションは 1 回だけ設定できます。後のインスタンスは以前のフラグ設定をオーバーライドします。
タグ:execution
--extra_toolchains=<comma-separated list of options>
件の複数回の使用が累積される-
ツールチェーンの解決時に考慮されるツールチェーン ルール。ツールチェーンは正確なターゲットで指定することも、ターゲット パターンとして指定することもできます。これらのツールチェーンは、register_chains() によって WORKSPACE ファイルで宣言されたツールチェーンより先に考慮されます。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
--grte_top=<a label>
デフォルト: 説明を参照-
チェックインされた libc ライブラリのラベル。デフォルト値はクロスツール ツールチェーンによって選択されるため、オーバーライドする必要はほとんどありません。
タグ:action_command_lines
、affects_outputs
--host_compiler=<a string>
デフォルト: 説明を参照-
ホスト コンパイルに使用する C++ コンパイラ。--host_crosstool_top が設定されていない場合は無視されます。
タグ:loading_and_analysis
、execution
--host_crosstool_top=<a build target label>
デフォルト: 説明を参照-
デフォルトでは、exec 構成にも --crosstool_top オプションと --compiler オプションが使用されます。このフラグを指定すると、Bazel は指定された Crosstool_top に対してデフォルトの libc とコンパイラを使用します。
タグ:loading_and_analysis
、changes_inputs
、affects_outputs
--host_grte_top=<a label>
デフォルト: 説明を参照-
指定すると、実行構成の libc 最上位ディレクトリ(--grte_top)がオーバーライドされます。
タグ:action_command_lines
、affects_outputs
--host_platform=<a build target label>
デフォルト: "@local_config_platform//:host"-
ホストシステムを記述するプラットフォーム ルールのラベル。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
のデフォルト: 「true」-
true の場合、Bazel は c++ ツールチェーンの「ホスト」機能と「非ホスト」機能を有効にしません(詳しくは、https://github.com/bazelbuild/bazel/issues/7407 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
のデフォルト: 「true」-
ツールチェーン解決を使用して、Android ルール用の Android SDK(Starlark およびネイティブ)を選択します
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
デフォルト: 「false」-
ツールチェーン解決を使用して、Apple のルール(Starlark とネイティブ)用の Apple SDK を選択します。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
のデフォルト: 「true」-
true の場合、Bazel は lto インデックス コマンドラインに C++ リンク アクション コマンドラインを再利用しません(詳しくは、https://github.com/bazelbuild/bazel/issues/6791 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_remove_legacy_whole_archive
のデフォルト: 「true」-
true の場合、Bazel は、デフォルトでライブラリの依存関係全体をアーカイブとしてリンクしません(移行手順については、https://github.com/bazelbuild/bazel/issues/7362 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_require_ctx_in_configure_features
のデフォルト: 「true」-
true の場合、Bazel では、cc_common.configure_features で「setIamPolicy」パラメータが必要になります(詳しくは、https://github.com/bazelbuild/bazel/issues/7793 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
-
ツールチェーンでサポートされている場合は、インターフェース共有オブジェクトを使用します。現在、この設定はすべての ELF ツールチェーンでサポートされています。
タグ:loading_and_analysis
、affects_outputs
、affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
iOS アプリのビルドに使用する iOS SDK のバージョンを指定します。指定しない場合は、デフォルトの iOS SDK バージョン「xcode_version」を使用します。
タグ:loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
macOS アプリケーションのビルドに使用する macOS SDK のバージョンを指定します。指定しない場合は、デフォルトの macOS SDK バージョン「xcode_version」を使用します。
タグ:loses_incremental_state
--minimum_os_version=<a string>
デフォルト: 説明を参照-
コンパイルの対象とする最小 OS バージョン。
タグ:loading_and_analysis
、affects_outputs
--platform_mappings=<a relative path>
のデフォルト: ""-
プラットフォームが設定されていない場合は使用するプラットフォーム、すでにプラットフォームが存在する場合は設定するフラグを記述するマッピング ファイルの場所。メイン ワークスペースのルートからの相対パスにする必要があります。デフォルトは「platform_mappings」(ワークスペースのルートの直下にあるファイル)に設定されています。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
--platforms=<a build target label>
のデフォルト: ""-
現在のコマンドのターゲット プラットフォームを記述するプラットフォーム ルールのラベル。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
--python2_path=<a string>
デフォルト: 説明を参照-
非推奨、No-op。「--compatible_use_python_chains」により無効になります。
タグ:no_op
、deprecated
--python3_path=<a string>
デフォルト: 説明を参照-
非推奨、No-op。「--compatible_use_python_chains」により無効になります。
タグ:no_op
、deprecated
--python_path=<a string>
デフォルト: 説明を参照-
ターゲット プラットフォームで Python ターゲットを実行するために呼び出される Python インタープリタの絶対パス。非推奨。--compatible_use_python_ツールチェーン s によって無効にされています。
タグ:loading_and_analysis
、affects_outputs
--python_top=<a build target label>
デフォルト: 説明を参照-
ターゲット プラットフォームで Python ターゲットを実行するために呼び出される Python インタープリタを表す py_runtime のラベル。非推奨。--compatible_use_python_ツールチェーン s によって無効にされています。
タグ:loading_and_analysis
、affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
tvOS アプリのビルドに使用する tvOS SDK のバージョンを指定します。指定しない場合は、デフォルトの tvOS SDK バージョン「xcode_version」を使用します。
タグ:loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
watchOS アプリのビルドに使用する watchOS SDK のバージョンを指定します。指定しない場合は、「xcode_version」のデフォルトの watchOS SDK バージョンを使用します。
タグ:loses_incremental_state
--xcode_version=<a string>
デフォルト: 説明を参照-
指定すると、指定したバージョンの Xcode が関連するビルド アクションに使用されます。指定しない場合は、エグゼキュータのデフォルト バージョンの Xcode を使用します。
タグ:loses_incremental_state
--xcode_version_config=<a build target label>
デフォルト: "@bazel_tools//tools/cpp:host_xcodes"-
ビルド構成で Xcode バージョンの選択に使用される xcode_config ルールのラベル。
タグ:loses_incremental_state
、loading_and_analysis
- コマンドの出力を制御するオプション:
--[no]apple_generate_dsym
デフォルト: 「false」-
デバッグ シンボル(.dSYM)ファイルを生成するかどうかを指定します。
タグ:affects_outputs
、action_command_lines
--[no]build_runfile_links
のデフォルト: 「true」-
true の場合、すべてのターゲットに runfile のシンボリック リンク フォレストをビルドします。false の場合、ローカル アクション、テスト、または実行コマンドで必要な場合にのみ書き込みます。
タグ:affects_outputs
--[no]build_runfile_manifests
のデフォルト: 「true」-
true の場合、すべてのターゲットの runfile マニフェストを書き込みます。false の場合は省略します。false の場合、ローカルテストは実行できません。
タグ:affects_outputs
--[no]build_test_dwp
デフォルト: 「false」-
有効にすると、C++ テストを静的かつ分割してビルドするときに、テストバイナリの .dwp ファイルも自動的にビルドされます。
タグ:loading_and_analysis
、affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
のデフォルト: ".pb.h"-
cc_proto_library が作成するヘッダー ファイルの接尾辞を設定します。
タグ:affects_outputs
、loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
のデフォルト: 「.pb.cc」-
cc_proto_library が作成するソースファイルの接尾辞を設定します。
タグ:affects_outputs
、loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
デフォルト: 「false」-
proto_library の代替 Java API バージョンに対して、追加のアクションを実行します。
タグ:affects_outputs
、loading_and_analysis
、experimental
--[no]experimental_proto_extra_actions
デフォルト: 「false」-
proto_library の代替 Java API バージョンに対して、追加のアクションを実行します。
タグ:affects_outputs
、loading_and_analysis
、experimental
--[no]experimental_save_feature_state
デフォルト: 「false」-
有効な機能とリクエストされた機能の状態を、コンパイルの出力として保存します。
タグ:affects_outputs
、experimental
--fission=<a set of compilation modes>
(デフォルト): 「no」-
C++ のコンパイルとリンクに分断を使用するコンパイル モードを指定します。{'fastbuild'、'dbg'、'opt'}、またはすべてのモードを有効にする場合は 'yes'、すべてのモードを無効にする場合は 'no' を任意に組み合わせることができます。
タグ:loading_and_analysis
、action_command_lines
、affects_outputs
--[no]incompatible_always_include_files_in_data
のデフォルト: 「true」-
true の場合、ネイティブ ルールは、データ依存関係の <code>DefaultInfo.files</code> を runfile に追加します。これは Starlark ルールの推奨動作(https://bazel.build/extending/rules#runfiles_features_to_avoid)と同じです。
タグ:affects_outputs
、incompatible_change
--[no]legacy_external_runfiles
のデフォルト: 「true」-
true の場合、(.runfiles/repo に加えて).runfiles/wsname/external/repo の下に外部リポジトリの runfile シンボリック リンク フォレストを作成します。
タグ:affects_outputs
--[no]objc_generate_linkmap
デフォルト: 「false」-
リンクマップ ファイルを生成するかどうかを指定します。
タグ:affects_outputs
--[no]save_temps
デフォルト: 「false」-
設定すると、gcc からの一時的な出力が保存されます。これには、.s ファイル(アセンブラ コード)、.i ファイル(前処理された C)、.ii ファイル(前処理された C++)が含まれます。
タグ:affects_outputs
- 目的の出力をユーザーが構成できるオプション(その存在とは無関係に、目的の出力に影響を与えます):
--action_env=<a 'name=value' assignment with an optional value part>
件の複数回の使用が累積される-
ターゲット構成でのアクションで使用できる環境変数のセットを指定します。変数は、名前で指定することも(この場合、値は呼び出し環境から取得されます)か、または名前=値のペア(呼び出し環境とは無関係に値を設定する)で指定できます。このオプションは複数回使用できます。同じ変数に対して指定されたオプションの場合は、最新の優先対象が使用され、異なる変数のオプションが蓄積されます。
タグ:action_command_lines
--android_cpu=<a string>
のデフォルト: 「armeabi-v7a」-
Android のターゲット CPU。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--[no]android_databinding_use_androidx
のデフォルト: 「true」-
AndroidX 互換のデータ バインディング ファイルを生成する。これはデータ バインディング v2 でのみ使用されます。このフラグは no-op です。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--[no]android_databinding_use_v3_4_args
のデフォルト: 「true」-
Android databinding v2 と 3.4.0 引数を使用します。このフラグは no-op です。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--android_dynamic_mode=<off, default or fully>
のデフォルト: 「off」-
cc_binary が共有ライブラリを明示的に作成しない場合に、Android ルールの C++ 依存関係を動的にリンクするかどうかを決定します。「default」は、bazel が動的にリンクするかどうかを選択することを意味します。「Fully」は、すべてのライブラリが動的にリンクされることを意味します。「off」は、すべてのライブラリがほぼ静的モードでリンクされることを意味します。
タグ:affects_outputs
、loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
のデフォルト: "alphabetical"-
Android バイナリのマニフェスト マージツールに渡されるマニフェストの順序を設定します。ALPHABETICAL は、マニフェストが execroot からの相対パスによって並べ替えられることを意味します。ALPHABETICAL_BY_CONFIGURATION は、マニフェストが出力ディレクトリ内の構成ディレクトリを基準とする相対パスで並べ替えられることを意味します。DEPENDENCY は、各ライブラリのマニフェストがその依存関係のマニフェストの前に配置される状態でマニフェストが並べられることを意味します。
タグ:action_command_lines
、execution
--[no]android_resource_shrinking
デフォルト: 「false」- ProGuard を使用する android_binary APK のリソース圧縮を有効にします。
タグ:affects_outputs
、loading_and_analysis
--[no]build_python_zip
のデフォルト: "auto"-
Python 実行可能ファイル zip をビルドする(Windows では実行、他のプラットフォームではオフ)
タグ:affects_outputs
--catalyst_cpus=<comma-separated list of options>
件の複数回の使用が累積される-
Apple Catalyst バイナリをビルドするアーキテクチャのカンマ区切りリスト。
タグ:loses_incremental_state
、loading_and_analysis
--[no]collect_code_coverage
デフォルト: 「false」-
指定すると、Bazel はコードをインストルメント化し(可能であればオフラインのインストルメンテーションを使用)、テスト中にカバレッジ情報を収集します。--instrumentation_filter に一致するターゲットのみが影響を受けます。通常、このオプションは直接指定しないでください。代わりに「bazelcoverage」コマンドを使用してください。
タグ:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] default: "fastbuild"-
バイナリがビルドされるモードを指定します。値: fastbuild、dbg、opt。
タグ:affects_outputs
、action_command_lines
--conlyopt=<a string>
件の複数回の使用が累積される-
C ソースファイルのコンパイル時に gcc に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--copt=<a string>
件の複数回の使用が累積される-
gcc に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--cpu=<a string>
のデフォルト: ""-
ターゲット CPU。
タグ:changes_inputs
、affects_outputs
--cs_fdo_absolute_path=<a string>
デフォルト: 説明を参照-
CSFDO プロファイル情報を使用してコンパイルを最適化します。プロファイル ファイルを含む zip ファイルの絶対パス名(未加工の LLVM プロファイル ファイルまたはインデックス登録された LLVM プロファイル ファイル)を指定します。
タグ:affects_outputs
--cs_fdo_instrument=<a string>
デフォルト: 説明を参照-
コンテキスト センシティブな FDO 計測を使用してバイナリを生成します。Clang/LLVM コンパイラでは、実行時に未加工プロファイル ファイルがダンプされるディレクトリ名も受け入れます。
タグ:affects_outputs
--cs_fdo_profile=<a build target label>
デフォルト: 説明を参照-
最適化に使用されるコンテキスト依存プロファイルを表す cs_fdo_profile。
タグ:affects_outputs
--cxxopt=<a string>
件の複数回の使用が累積される-
C++ ソースファイルのコンパイル時に gcc に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--define=<a 'name=value' assignment>
件の複数回の使用が累積される-
各 --define オプションは、ビルド変数の割り当てを指定します。
タグ:changes_inputs
、affects_outputs
--dynamic_mode=<off, default or fully>
デフォルト: 「default」-
C++ バイナリを動的にリンクするかどうかを決定します。「default」は、Bazel が動的にリンクするかどうかを選択することを意味します。「Fully」は、すべてのライブラリが動的にリンクされることを意味します。「off」は、すべてのライブラリがほぼ静的モードでリンクされることを意味します。
タグ:loading_and_analysis
、affects_outputs
--[no]enable_fdo_profile_absolute_path
のデフォルト: 「true」-
設定した場合、fdo_absolute_profile_path を使用するとエラーになります。
タグ:affects_outputs
--[no]enable_runfiles
のデフォルト: "auto"-
runfiles シンボリック リンク ツリーを有効にします。Windows ではデフォルトではオフになっており、他のプラットフォームでは無効になっています。
タグ:affects_outputs
--experimental_action_listener=<a build target label>
件の複数回の使用が累積される-
アスペクトを優先して非推奨となりました。action_listener を使用して、extra_action を既存のビルド アクションにアタッチします。
タグ:execution
、experimental
--[no]experimental_android_compress_java_resources
デフォルト: 「false」-
APK 内の Java リソースを圧縮する
タグ:affects_outputs
、loading_and_analysis
、experimental
--[no]experimental_android_databinding_v2
のデフォルト: 「true」-
Android データ バインディング v2 を使用します。このフラグは no-op です。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--[no]experimental_android_resource_shrinking
デフォルト: 「false」- ProGuard を使用する android_binary APK のリソース圧縮を有効にします。
タグ:affects_outputs
、loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
デフォルト: 「false」-
rex ツールを使用して dex ファイルを書き換える
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--[no]experimental_collect_code_coverage_for_generated_files
デフォルト: 「false」-
指定すると、Bazel は生成されたファイルの収集カバレッジ情報も生成します。
タグ:affects_outputs
--experimental_objc_fastbuild_options=<comma-separated list of options>
デフォルト: "-O0,-DDEBUG=1"-
これらの文字列を objc fastbuild コンパイラ オプションとして使用します。
タグ:action_command_lines
--[no]experimental_omitfp
デフォルト: 「false」-
true の場合、スタックのアンワインドに libunwind を使用し、-fomit-frame-pointer と -fasync-unwind-tables を使用してコンパイルします。
タグ:action_command_lines
、affects_outputs
、experimental
--experimental_output_paths=<off, content or strip>
のデフォルト: 「off」-
特にマルチプラットフォーム / マルチ構成のビルドで、出力ツリーのルールのどこに出力を書き込むかに使用するモデル。これは非常に試験運用中です。詳細については、https://github.com/bazelbuild/bazel/issues/6526 をご覧ください。Starlark のアクションは、キー「supports-path-mapping」を「execution_requirements」辞書に追加することで、パスマッピングにオプトインできます。
タグ:loses_incremental_state
、bazel_internal_configuration
、affects_outputs
、execution
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment>
件の複数回の使用が累積される-
各エントリは label=value の形式にする必要があります。label はプラットフォームを指し、values は出力パスで使用する省略名です。--experimental_platform_in_output_dir が true の場合にのみ使用されます。命名の優先度が最も高い。
タグ:affects_outputs
、experimental
--[no]experimental_platform_in_output_dir
デフォルト: 「false」-
true の場合、出力ディレクトリ名に CPU ではなくターゲット プラットフォームの短縮名が使用されます。正確なスキームは試験運用中で、変更される可能性があります。まず、--platforms オプションに値が 1 つしかないというまれなケースとして、platform オプションのハッシュが使用されます。次に、現在のプラットフォームの略称が --experimental_override_name_platform_in_output_dir によって登録された場合は、その短縮名が使用されます。次に、--experimental_use_platforms_in_output_dir_legacy_heuristic が設定されている場合、現在のプラットフォーム ラベルに基づく略称を使用します。最後に、プラットフォーム オプションのハッシュが最後の手段として使用されます。
タグ:affects_outputs
、experimental
--[no]experimental_use_llvm_covmap
デフォルト: 「false」-
指定すると、collect_code_coverage が有効になっている場合、Bazel は gcov ではなく llvm-cov カバレッジ マップ情報を生成します。
タグ:changes_inputs
、affects_outputs
、loading_and_analysis
、experimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic
のデフォルト: 「true」-
このフラグは、提案する移行またはテスト戦略の一部としてのみ使用してください。このヒューリスティックには既知の欠陥があるため、--experimental_override_name_platform_in_output_dir のみに依存するように移行することをおすすめします。
タグ:affects_outputs
、experimental
--fat_apk_cpu=<comma-separated set of options>
のデフォルト: 「armeabi-v7a」-
このオプションを設定すると、ファット APK が有効になります。これには、指定したすべてのターゲット アーキテクチャ(例:--fat_apk_cpu=x86,armeabi-v7a. このフラグを指定すると、android_binary ルールの依存関係で --android_cpu は無視されます。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--[no]fat_apk_hwasan
デフォルト: 「false」-
HWASAN 分割を作成するかどうかを指定します。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--fdo_instrument=<a string>
デフォルト: 説明を参照-
FDO インストルメンテーションを使用してバイナリを生成します。Clang/LLVM コンパイラでは、実行時に未加工プロファイル ファイルがダンプされるディレクトリ名も受け入れます。
タグ:affects_outputs
--fdo_optimize=<a string>
デフォルト: 説明を参照-
FDO プロファイル情報を使用してコンパイルを最適化します。.gcda ファイルツリーを含む zip ファイル、自動プロファイルを含む afdo ファイル、または LLVM プロファイル ファイルの名前を指定します。このフラグは、ラベルとして指定されたファイル(例: 「//foo/bar:file.afdo」で、対応するパッケージに「exports_files」ディレクティブを追加する必要が生じる場合があります)や、「fdo_profile」ターゲットを指すラベルも受け入れます。このフラグは「fdo_profile」ルールよりも優先されます。
タグ:affects_outputs
--fdo_prefetch_hints=<a build target label>
デフォルト: 説明を参照-
キャッシュ プリフェッチのヒントを使用します。
タグ:affects_outputs
--fdo_profile=<a build target label>
デフォルト: 説明を参照-
最適化に使用するプロファイルを表す fdo_profile。
タグ:affects_outputs
--features=<a string>
件の複数回の使用が累積される-
指定された機能は、ターゲット構成でビルドされたターゲットに対してデフォルトで有効または無効になります。-<feature> を指定すると、対象物が無効になります。否定的な特徴は常に肯定的な特徴より優先されます。--host_features もご覧ください。
タグ:changes_inputs
、affects_outputs
--[no]force_pic
デフォルト: 「false」-
有効にすると、すべての C++ コンパイルは位置非依存コード(「-fPIC」)を生成します。リンクは非 PC ライブラリよりも PIC ビルド済みライブラリを優先し、リンクは位置独立実行ファイル(「-pie」)を生成します。
タグ:loading_and_analysis
、affects_outputs
--host_action_env=<a 'name=value' assignment with an optional value part>
件の複数回の使用が累積される-
実行構成のアクションで使用できる環境変数のセットを指定します。変数は、名前で指定することも(この場合、値は呼び出し環境から取得されます)か、または名前=値のペア(呼び出し環境とは無関係に値を設定する)で指定できます。このオプションは複数回使用できます。同じ変数に対して指定されたオプションの場合は、最新の優先対象が使用され、異なる変数のオプションが蓄積されます。
タグ:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
のデフォルト: "opt"-
ビルド中に使用するツールがビルドされるモードを指定します。値: fastbuild、dbg、opt。
タグ:affects_outputs
、action_command_lines
--host_conlyopt=<a string>
件の複数回の使用が累積される-
exec 構成で C(C++ は除く)ソースファイルをコンパイルする際に C コンパイラに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--host_copt=<a string>
件の複数回の使用が累積される-
exec 構成でビルドされるツールのために C コンパイラに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--host_cpu=<a string>
のデフォルト: ""-
ホスト CPU。
タグ:changes_inputs
、affects_outputs
--host_cxxopt=<a string>
件の複数回の使用が累積される-
exec 構成でビルドされたツールのために C++ コンパイラに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--host_features=<a string>
件の複数回の使用が累積される-
指定された機能は、exec 構成でビルドされたターゲットに対してデフォルトで有効または無効になります。-<feature> を指定すると、対象物が無効になります。否定的な特徴は常に肯定的な特徴より優先されます。
タグ:changes_inputs
、affects_outputs
--host_force_python=<PY2 or PY3>
デフォルト: 説明を参照-
exec 構成の Python バージョンをオーバーライドします。「PY2」または「PY3」のいずれかです。
タグ:loading_and_analysis
、affects_outputs
--host_linkopt=<a string>
件の複数回の使用が累積される-
exec 構成でツールをリンクするときにリンカーに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
ホスト ターゲットに対応する macOS の最小バージョン。指定しない場合は「macos_sdk_version」を使用します。
タグ:loses_incremental_state
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
件の複数回の使用が累積される-
exec 構成で特定のファイルをコンパイルするときに、C/C++ コンパイラに選択的に渡す追加のオプション。このオプションは複数回渡すことができます。構文: regex_filter@option_1,option_2,...,option_nregex_filter は、包含および除外する正規表現パターンのリストを表します(--instrumentation_filter も参照)。option_1 から option_n は任意のコマンドライン オプションを表します。オプションにカンマが含まれる場合は、バックスラッシュで囲む必要があります。オプションには @ を含めることができます。文字列の分割には最初の @ のみが使用されます。例: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 は、//foo/ 内のすべての cc ファイル(bar.cc を除く)で gcc コマンドラインに -O0 コマンドライン オプションを追加します。
タグ:action_command_lines
、affects_outputs
--host_swiftcopt=<a string>
件の複数回の使用が累積される-
実行ツールで swiftc に渡す追加オプション。
タグ:action_command_lines
、affects_outputs
--[no]incompatible_auto_exec_groups
デフォルト: 「false」-
有効にすると、ルールで使用されるツールチェーンごとに exec グループが自動的に作成されます。これを機能させるには、ルールのアクションに「ツールチェーン」パラメータを指定する必要があります。詳細については、https://github.com/bazelbuild/bazel/issues/17134 をご覧ください。
タグ:affects_outputs
、incompatible_change
--[no]incompatible_merge_genfiles_directory
のデフォルト: 「true」-
true の場合、genfiles ディレクトリは bin ディレクトリに組み込まれます。
タグ:affects_outputs
、incompatible_change
--[no]incompatible_use_host_features
のデフォルト: 「true」-
true の場合、ターゲット構成にのみ --features を使用し、実行可能ファイル構成には --host_features を使用します。
タグ:changes_inputs
、affects_outputs
、incompatible_change
--[no]instrument_test_targets
デフォルト: 「false」-
カバレッジが有効な場合、インストルメンテーション テストルールを検討するかどうかを指定します。設定すると、--instrumentation_filter に含まれるテストルールがインストルメント化されます。それ以外の場合、テストルールは常にカバレッジ インストルメンテーションから除外されます。
タグ:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
デフォルト: "-/javatests[/:],-/test/java[/:]"-
カバレッジを有効にすると、指定した正規表現ベースのフィルタに含まれる名前を持つルールのみがインストルメント化されます。代わりに「-」で始まるルールは除外されます。--instrument_test_targets が有効になっていない限り、テスト以外のルールのみがインストルメント化されることに注意してください。
タグ:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
ターゲット シミュレータおよびデバイスに対応する最小の iOS バージョン。指定しない場合は、「ios_sdk_version」が使用されます。
タグ:loses_incremental_state
--ios_multi_cpus=<comma-separated list of options>
件の複数回の使用が累積される-
ios_application のビルドに使用するアーキテクチャのカンマ区切りリスト。その結果、指定されたすべてのアーキテクチャを含むユニバーサル バイナリが生成されます。
タグ:loses_incremental_state
、loading_and_analysis
--[no]legacy_whole_archive
のデフォルト: 「true」-
非推奨。代わりに --compatible_remove_legacy_whole_archive を使用します(詳しくは https://github.com/bazelbuild/bazel/issues/7362 をご覧ください)。オンにすると、linkshared=True と linkstatic=True または「-static」のいずれかが linkopts に設定されている cc_binary ルールに --whole-archive が使用されます。これは下位互換性用です。より適切な選択肢は、必要な場合に alwayslink=1 を使用することです。
タグ:action_command_lines
、affects_outputs
、deprecated
--linkopt=<a string>
件の複数回の使用が累積される-
リンク時に gcc に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--ltobackendopt=<a string>
件の複数回の使用が累積される-
LTO バックエンド ステップ(--features=thin_lto の下)に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--ltoindexopt=<a string>
件の複数回の使用が累積される-
LTO のインデックス登録ステップ(--features=thin_lto の下)に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--macos_cpus=<comma-separated list of options>
件の複数回の使用が累積される- Apple macOS バイナリをビルドするためのアーキテクチャのカンマ区切りリスト。
タグ:loses_incremental_state
、loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
ターゲットに対応する macOS の最小バージョン。指定しない場合は「macos_sdk_version」を使用します。
タグ:loses_incremental_state
--memprof_profile=<a build target label>
デフォルト: 説明を参照-
memprof プロファイルを使用する。
タグ:affects_outputs
--[no]objc_debug_with_GLIBCXX
デフォルト: 「false」-
設定されていて、コンパイル モードが「dbg」に設定されている場合、GLIBCXX_DEBUG、GLIBCXX_DEBUG_PEDANTIC、GLIBCPP_CONCEPT_CHECKS を定義します。
タグ:action_command_lines
--[no]objc_enable_binary_stripping
デフォルト: 「false」-
リンクされたバイナリでシンボルとデッドコードのストリップを実行するかどうかを指定します。このフラグと --compile_mode=opt の両方を指定すると、バイナリ ストリップが実行されます。
タグ:action_command_lines
--objccopt=<a string>
件の複数回の使用が累積される-
Objective-C/C++ ソースファイルのコンパイル時に gcc に渡す追加のオプション。
タグ:action_command_lines
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
件の複数回の使用が累積される-
特定のファイルをコンパイルするときに選択的に gcc に渡す追加のオプション。このオプションは複数回渡すことができます。構文: regex_filter@option_1,option_2,...,option_nregex_filter は、包含および除外する正規表現パターンのリストを表します(--instrumentation_filter も参照)。option_1 から option_n は任意のコマンドライン オプションを表します。オプションにカンマが含まれる場合は、バックスラッシュで囲む必要があります。オプションには @ を含めることができます。文字列の分割には最初の @ のみが使用されます。例: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 は、//foo/ 内に存在する bar.cc を除くすべての cc ファイルの gcc コマンドラインに、-O0 コマンドライン オプションを追加します。
タグ:action_command_lines
、affects_outputs
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
件の複数回の使用が累積される-
特定のバックエンド オブジェクトをコンパイルするときに、選択的に LTO バックエンド(--features=thin_lto の下)に渡す追加のオプション。このオプションは複数回渡すことができます。構文: regex_filter@option_1,option_2,...,option_nregex_filter は、包含および除外する正規表現パターンのリストです。option_1 から option_n は任意のコマンドライン オプションを表します。オプションにカンマが含まれる場合は、バックスラッシュで囲む必要があります。オプションには @ を含めることができます。文字列の分割には最初の @ のみが使用されます。例: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 は、//foo/ 内の、bar.o を除くすべての o ファイルの LTO バックエンド コマンドラインに -O0 コマンドライン オプションを追加します。
タグ:action_command_lines
、affects_outputs
--platform_suffix=<a string>
デフォルト: 説明を参照-
構成ディレクトリに追加する接尾辞を指定します。
タグ:loses_incremental_state
、affects_outputs
、loading_and_analysis
--propeller_optimize=<a build target label>
デフォルト: 説明を参照-
Propeller プロファイル情報を使用して、ビルド ターゲットを最適化します。Propeller プロファイルは、cc プロファイルと ld プロファイルの 2 つのファイルのうち少なくとも 1 つで構成されている必要があります。このフラグには、Propeller プロファイルの入力ファイルを参照する必要があるビルドラベルを指定します。たとえば、ラベルを定義する BUILD ファイル(a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",) )を Bazel の場合、対応するパッケージに Bazel ディレクティブを追加してこれらのファイルを表示する必要があります。このオプションは次のように使用する必要があります: --propeller_optimize=//a/b:propeller_profile
タグ:action_command_lines
、affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
デフォルト: 説明を参照-
Propeller Optimized ビルドの cc_profile ファイルのパスの絶対パス名。
タグ:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
デフォルト: 説明を参照-
Propeller Optimized ビルドの ld_profile ファイルの絶対パス名。
タグ:affects_outputs
--run_under=<a prefix in front of command>
デフォルト: 説明を参照-
「test」コマンドと「run」コマンドの実行可能ファイルの前に挿入する接頭辞。値が「foo -bar」で、実行コマンドラインが「test_binary -baz」の場合、最後のコマンドラインは「foo -bar test_binary -baz」になります。これは、実行可能ターゲットのラベルにすることもできます。たとえば、「valgrind」、「strace」、「strace -c」、「valgrind --quiet --num-callers=20」、「//package:target」、「//package:target --options」などが挙げられます。
タグ:action_command_lines
-
true の場合、同じ機能を含むネイティブ ライブラリが、異なるターゲット間で共有されます
タグ:loading_and_analysis
、affects_outputs
--[no]stamp
デフォルト: 「false」-
日付、ユーザー名、ホスト名、ワークスペース情報などでバイナリをスタンプします。
タグ:affects_outputs
--strip=<always, sometimes or never>
(デフォルト): 「時々」-
バイナリと共有ライブラリを除去するかどうかを指定します(「-Wl,--strip-debug」を使用)。デフォルト値の「sometimes」は、--compile_mode=fastbuild の場合を除いて削除されます。
タグ:affects_outputs
--stripopt=<a string>
件の複数回の使用が累積される-
「<name>.stripped」バイナリを生成する際にストリップに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--swiftcopt=<a string>
件の複数回の使用が累積される-
Swift コンパイルに渡す追加オプションです。
タグ:action_command_lines
--tvos_cpus=<comma-separated list of options>
件の複数回の使用が累積される- Apple tvOS バイナリをビルドするためのアーキテクチャのカンマ区切りリスト。
タグ:loses_incremental_state
、loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
ターゲット シミュレータとデバイスに対応する最小の tvOS バージョン。指定しない場合は「tvos_sdk_version」を使用します。
タグ:loses_incremental_state
--visionos_cpus=<comma-separated list of options>
件の複数回の使用が累積される- Apple VisionOS バイナリをビルドするためのアーキテクチャのカンマ区切りリスト。
タグ:loses_incremental_state
、loading_and_analysis
--watchos_cpus=<comma-separated list of options>
件の複数回の使用が累積される- Apple watchOS バイナリをビルドするためのアーキテクチャのカンマ区切りリスト。
タグ:loses_incremental_state
、loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
ターゲット シミュレータとデバイスに対応する最小互換の watchOS バージョン。指定しない場合は、「watchos_sdk_version」を使用します。
タグ:loses_incremental_state
--xbinary_fdo=<a build target label>
デフォルト: 説明を参照-
XbinaryFDO プロファイル情報を使用してコンパイルを最適化します。デフォルトのクロスバイナリ プロファイルの名前を指定します。このオプションを --fdo_instrument/--fdo_optimize/--fdo_profile とともに使用すると、xbinary_fdo が指定されていない場合と同じように常にこれらのオプションが優先されます。
タグ:affects_outputs
- Bazel が有効なビルド入力を厳密に適用するかどうかに影響するオプション(ルール定義、フラグの組み合わせなど):
--auto_cpu_environment_group=<a build target label>
のデフォルト: ""-
CPU 値を target_environment 値に自動的にマッピングするために使用する environment_group を宣言します。
タグ:changes_inputs
、loading_and_analysis
、experimental
--[no]check_licenses
デフォルト: 「false」-
依存パッケージによって課されるライセンスの制約が、ビルドされるターゲットの配布モードと競合していないことを確認します。デフォルトでは、ライセンスはオンになっています。
タグ:build_file_semantics
--[no]check_visibility
のデフォルト: 「true」-
無効にすると、ターゲット依存関係のエラーが警告に降格されます。
タグ:build_file_semantics
--[no]desugar_for_android
のデフォルト: 「true」-
dex 変換する前に Java 8 バイトコードを脱糖するかどうか。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--[no]desugar_java8_libs
デフォルト: 「false」-
レガシー デバイスのアプリにサポートされている Java 8 ライブラリを含めるかどうかを指定します。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--[no]enforce_constraints
のデフォルト: 「true」-
各ターゲットと互換性がある環境を確認し、同じ環境をサポートしていない依存関係がターゲットに含まれている場合はエラーを報告します。
タグ:build_file_semantics
--[no]experimental_check_desugar_deps
のデフォルト: 「true」-
Android バイナリレベルで正しい脱糖を再チェックするかどうか。
タグ:eagerness_to_exit
、loading_and_analysis
、experimental
--experimental_import_deps_checking=<off, warning or error>
のデフォルト: 「オフ」-
有効にすると、aar_import の依存関係が完全かどうかを確認します。この適用により、ビルドが中断するだけでなく、警告が表示される場合もあります。
タグ:loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default>
デフォルト: 「default」-
true の場合、Java ターゲットで直接使用されるすべてのターゲットが依存関係として明示的に宣言されていることを確認します。
タグ:build_file_semantics
、eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
デフォルト: 「false」-
有効にすると、生成ルールの testonly を検索して、出力ファイルである前提条件のターゲットを testonly としてチェックします。これは可視性チェックと一致します。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_check_visibility_for_toolchains
デフォルト: 「false」-
有効にすると、可視性チェックはツールチェーンの実装にも適用されます。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_disable_native_android_rules
デフォルト: 「false」-
有効にすると、Android のネイティブ ルールの直接使用が無効になります。https://github.com/bazelbuild/rules_android にある Starlark Android ルールを使用してください
タグ:eagerness_to_exit
、incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
デフォルト: 「false」-
処理なし。下位互換性のためにここに保持します。
タグ:eagerness_to_exit
、incompatible_change
--[no]incompatible_python_disable_py2
のデフォルト: 「true」-
true の場合、Python 2 の設定を使用するとエラーが発生します。これには python_version=PY2、srcs_version=PY2、および srcs_version=PY2ONLY が含まれます。詳しくは、https://github.com/bazelbuild/bazel/issues/15684 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
のデフォルト: 「true」-
true の場合、Bazel はトップレベルのディレクトリ ヘッダーの包含も検証します(詳しくは、https://github.com/bazelbuild/bazel/issues/10047 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--python_native_rules_allowlist=<a build target label>
デフォルト: 説明を参照-
--compatible_python_disallow_native_rules を適用する際に使用する許可リスト(package_group ターゲット)。
タグ:loading_and_analysis
--[no]strict_filesets
デフォルト: 「false」-
このオプションを有効にすると、パッケージの境界を超えるファイルセットがエラーとして報告されます。
タグ:build_file_semantics
、eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
デフォルト: "error"-
OFF の場合を除き、proto_library ターゲットが、直接使用されるすべてのターゲットを依存関係として明示的に宣言していることを確認します。
タグ:build_file_semantics
、eagerness_to_exit
、incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
のデフォルト: 「off」-
OFF の場合を除き、proto_library ターゲットが、「import public」で使用されるすべてのターゲットを、エクスポート済みとして明示的に宣言していることを確認します。
タグ:build_file_semantics
、eagerness_to_exit
、incompatible_change
--[no]strict_system_includes
デフォルト: 「false」-
true の場合、システムのインクルード パス(-isystem)で検出されたヘッダーも宣言する必要があります。
タグ:loading_and_analysis
、eagerness_to_exit
--target_environment=<a build target label>
件の複数回の使用が累積される-
このビルドのターゲット環境を宣言します。「環境」ルールへのラベル参照にする必要があります。指定する場合、すべてのトップレベル ターゲットはこの環境と互換性を持つ必要があります。
タグ:changes_inputs
- ビルドの署名出力に影響するオプション:
--apk_signing_method=<v1, v2, v1_v2 or v4>
のデフォルト: 「v1_v2」-
APK の署名に使用する実装
タグ:action_command_lines
、affects_outputs
、loading_and_analysis
--[no]device_debug_entitlements
のデフォルト: 「true」-
設定されていて、コンパイル モードが「opt」でない場合、objc アプリは署名時にデバッグ利用資格を含めます。
タグ:changes_inputs
--ios_signing_cert_name=<a string>
デフォルト: 説明を参照-
iOS 署名に使用する証明書の名前。設定されていない場合、プロビジョニング プロファイルにフォールバックします。証明書のキーチェーン ID 設定、またはコードサインのマニュアル ページ(署名 ID)に基づく証明書の共通名(部分文字列)の場合もあります。
タグ:action_command_lines
- このオプションは、BUILD ファイル、.bzl ファイル、WORKSPACE ファイルからアクセス可能な Starlark 言語または Build API のセマンティクスに影響します。
--[no]incompatible_disallow_legacy_py_provider
のデフォルト: 「true」-
No-op、まもなく削除されます。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
デフォルト: 「false」-
true の場合、objc_library と objc_import の sdk_frameworks 属性と weak_sdk_frameworks の属性を禁止します。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_objc_alwayslink_by_default
デフォルト: 「false」-
true の場合、objc_library と objc_import の alwayslink 属性のデフォルト値を true にします。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_python_disallow_native_rules
デフォルト: 「false」-
true の場合、組み込みの py_* ルールの使用時にエラーが発生します。代わりに rule_python ルールを使用する必要があります。詳細と移行手順については、https://github.com/bazelbuild/bazel/issues/17773 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
- テスト環境またはテストランナーの動作を制御するオプション:
--[no]allow_analysis_failures
デフォルト: 「false」-
true の場合、ルール ターゲットの分析が失敗すると、ビルドは失敗するのではなく、エラーの説明を含む AnalysisFailureInfo のインスタンスが伝播されます。
タグ:loading_and_analysis
、experimental
--analysis_testing_deps_limit=<an integer>
デフォルト: 「2000」-
for_analysis_testing 構成の移行に関するルール属性を介して、推移的依存関係の最大数を設定します。この上限を超えると、ルールエラーが発生します。
タグ:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
デフォルト: 「false」-
真の dex2oat アクションが失敗すると、テスト実行時に dex2oat を実行する代わりにビルドが中断されます。
タグ:loading_and_analysis
、experimental
--[no]experimental_android_use_parallel_dex2oat
デフォルト: 「false」-
dex2oat を並行して使用すると、android_test が高速化される場合があります。
タグ:loading_and_analysis
、host_machine_resource_optimizations
、experimental
--[no]ios_memleaks
デフォルト: 「false」-
ios_test ターゲットでのメモリリークのチェックを有効化。
タグ:action_command_lines
--ios_simulator_device=<a string>
デフォルト: 説明を参照-
シミュレータで iOS アプリを実行するときにシミュレートするデバイス(例: iPhone 6)。シミュレータが実行されるマシンで「xcrun simctl list devicetypes」を実行すると、デバイスのリストを取得できます。
タグ:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
デフォルト: 説明を参照-
実行またはテストの際にシミュレータで実行する iOS のバージョン。対象デバイスがルールで指定されている場合、ios_test ルールでは無視されます。
タグ:test_runner
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
件の複数回の使用が累積される- 各テストを実行する回数を指定します。いずれかの試行がなんらかの理由で不合格になった場合は、テスト全体が不合格と見なされます。通常、指定される値は整数のみです。例: --runs_per_test=3 と指定すると、すべてのテストが 3 回実行されます。別の構文: regex_filter@runs_per_testrun_per_test は整数値、regex_filter は正規表現パターンのリストです(--instrumentation_filter も参照)。例: --runs_per_test=//foo/.*,-//foo/bar/.*@3 を指定すると、//foo/ 内のテストのうち、foo/bar の下にあるものを除くすべてのテストを 3 回実行します。このオプションは複数回渡すことができます。最後に渡された引数のうち、一致したものが優先されます。一致するものがない場合、テストは 1 回だけ実行されます。
--test_env=<a 'name=value' assignment with an optional value part>
件の複数回の使用が累積される-
テストランナー環境に挿入する追加の環境変数を指定します。変数は名前で指定できます。この場合、値は Bazel クライアント環境から読み取られます。また、name=value のペアで指定することもできます。このオプションを複数回使用して、複数の変数を指定できます。「bazel test」コマンドでのみ使用されます。
タグ:test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
デフォルト: 「-1」- テストのタイムアウトのデフォルトのテスト タイムアウト値(秒単位)をオーバーライドします。正の整数値を 1 つだけ指定すると、すべてのカテゴリがオーバーライドされます。4 つのカンマ区切りの整数を指定すると、short、Moderate、long、eternal のタイムアウトが(この順序で)オーバーライドされます。どちらの形式でも、値を -1 にすると、そのカテゴリに対してデフォルトのタイムアウトを使用するように Blaze に指示します。
--[no]zip_undeclared_test_outputs
のデフォルト: 「true」-
true の場合、宣言されていないテスト出力が zip ファイルにアーカイブされます。
タグ:test_runner
- クエリの出力とセマンティクスに関連するオプション:
--aspect_deps=<off, conservative or precise>
のデフォルト: "conservative"-
出力形式が {xml,proto,record} のいずれかの場合に、アスペクトの依存関係を解決する方法。「off」は、アスペクトの依存関係が解決されないことを意味します。「conservative」(デフォルト)は、宣言されたすべてのアスペクト依存関係が、直接的な依存関係のルールクラスが与えられるかどうかにかかわらず、追加されることを意味します。「正確」は、直接的な依存関係のルールクラスが与えられている可能性のあるアスペクトのみが追加されることを意味します。高精度モードでは、1 つのターゲットを評価するために他のパッケージを読み込む必要があるため、他のモードよりも遅くなります。また、精密モードであっても完全に正確というわけではありません。アスペクトを計算するかどうかは、分析フェーズで決定され、bazel クエリでは実行されません。
タグ:build_file_semantics
--[no]consistent_labels
デフォルト: 「false」-
有効にすると、すべてのクエリコマンドは、<code>Label</code> インスタンスに適用された Starlark <code>str</code> 関数であるかのようにラベルを出力します。これは、さまざまなクエリ コマンドの出力やルールによって発行されたラベルを照合する必要があるツールに便利です。有効になっていない場合、出力フォーマッタは、出力を読みやすくするために、明らかなリポジトリ名(メイン リポジトリからの相対名)を自由に出力できます。
タグ:terminal_output
--[no]graph:factored
のデフォルト: 「true」-
true の場合、グラフは「因数分解された」状態で出力されます。つまり、トポロジ的に同等のノードがマージされ、それらのラベルが連結されます。このオプションは --output=graph にのみ適用されます。
タグ:terminal_output
--graph:node_limit=<an integer>
のデフォルト: 「512」-
出力内のグラフノードのラベル文字列の最大長。長いラベルは切り捨てられます。-1 を指定すると、切り捨てられません。このオプションは --output=graph にのみ適用されます。
タグ:terminal_output
--[no]implicit_deps
のデフォルト: 「true」-
有効にすると、クエリが実行される依存関係グラフに暗黙的な依存関係が含まれます。暗黙的な依存関係とは、BUILD ファイルで明示的に指定されていないものの、bazel によって追加された依存関係のことです。cquery の場合、解決されたツールチェーンのフィルタリングを制御します。
タグ:build_file_semantics
--[no]include_aspects
のデフォルト: 「true」-
aquery、cquery: アスペクトによって生成されたアクションを出力に含めるかどうか。query: no-op(アスペクトは常に追跡されます)。
タグ:terminal_output
--[no]incompatible_package_group_includes_double_slash
のデフォルト: 「true」-
有効にすると、package_group の「packages」属性を出力するときに、先頭の「//」は省略されません。
タグ:terminal_output
、incompatible_change
--[no]infer_universe_scope
デフォルト: 「false」-
設定されていて、--universe_scope が設定されていない場合、--universe_scope の値は、クエリ式内の一意のターゲット パターンのリストとして推定されます。ユニバース スコープの関数(allrdeps など)を使用するクエリ式で推測される --universe_scope の値は、望ましくない可能性があるので、実行する処理がわかっている場合にのみ、このオプションを使用してください。詳細と例については、https://bazel.build/reference/query#sky-query をご覧ください。--universe_scope が設定されている場合、このオプションの値は無視されます。注: このオプションは「query」にのみ適用されます(つまり、「cquery」には適用されません)。
タグ:loading_and_analysis
--[no]line_terminator_null
デフォルト: 「false」-
各形式が改行ではなく \0 で終了しているかどうか。
タグ:terminal_output
--[no]nodep_deps
のデフォルト: 「true」-
有効にすると、"nodep" 属性からの依存関係が、クエリを操作する依存関係グラフに含まれます。「nodep」属性の一般的な例としては、「visibility」があります。「info build-language」の出力を実行して解析し、ビルド言語のすべての「nodep」属性を確認します。
タグ:build_file_semantics
--output=<a string>
のデフォルト: 「label」-
cquery の結果が出力される形式。cquery に使用できる値は、label、label_kind、textproto、transitions、proto、streamed_proto、jsonproto です。「transitions」を選択する場合は、--transitions=(lite|full) オプションも指定する必要があります。
タグ:terminal_output
--[no]proto:default_values
のデフォルト: 「true」-
true の場合、BUILD ファイルで値が明示的に指定されていない属性が含まれます。それ以外の場合は省略されます。このオプションは --output=proto に適用されます。
タグ:terminal_output
--[no]proto:definition_stack
デフォルト: 「false」-
Definition_stack proto フィールドに、ルールのクラスが定義された時点の Starlark コールスタックをルール インスタンスごとに記録します。
タグ:terminal_output
--[no]proto:flatten_selects
のデフォルト: 「true」-
有効にすると、select() によって作成された構成可能な属性がフラット化されます。リストタイプの場合、フラット表現は、セレクトマップの各値を 1 回だけ含むリストです。スカラー型は null にフラット化されます。
タグ:build_file_semantics
--[no]proto:include_attribute_source_aspects
デフォルト: 「false」-
各属性の source_aspect_name proto フィールドに、属性の取得元であるソースのアスペクトを入力します(そうでない場合は空の文字列)。
タグ:terminal_output
--[no]proto:include_configurations
のデフォルト: 「true」- を有効にすると、proto 出力に構成に関する情報が含まれます。無効にすると、cquery proto の出力形式はクエリの出力形式と同様になります。
タグ:affects_outputs
--[no]proto:include_synthetic_attribute_hash
デフォルト: 「false」- $internal_attr_hash 属性を計算して入力するかどうかを指定します。
タグ:terminal_output
--[no]proto:instantiation_stack
デフォルト: 「false」-
各ルールのインスタンス化コールスタックにデータを入力します。これを行うには、スタックが存在する必要があります。
タグ:terminal_output
--[no]proto:locations
のデフォルト: 「true」-
proto 出力で位置情報を出力するかどうか。
タグ:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
のデフォルト: 「all」-
出力に含める属性のカンマ区切りリスト。デフォルトはすべての属性です。属性を出力しない場合は、空の文字列に設定します。このオプションは --output=proto に適用できます。
タグ:terminal_output
--[no]proto:rule_inputs_and_outputs
のデフォルト: 「true」-
rule_input と rule_output の各フィールドにデータを入力するかどうかを指定します。
タグ:terminal_output
--query_file=<a string>
のデフォルト: ""-
設定すると、クエリはコマンドラインではなく、ここで指定したファイルからクエリを読み取ります。ここでファイルを指定してコマンドライン クエリを指定するとエラーになります。
タグ:changes_inputs
--[no]relative_locations
デフォルト: 「false」-
true の場合、xml 出力と proto 出力での BUILD ファイルの場所は相対的になります。デフォルトでは、場所の出力は絶対パスであり、マシン間で一貫していません。このオプションを true に設定すると、マシン全体で一貫した結果が得られます。
タグ:terminal_output
--show_config_fragments=<off, direct or transitive>
のデフォルト: 「off」-
ルールに必要な構成フラグメントとその推移的な依存関係が表示されます。これは、構成したターゲット グラフをどの程度トリミングできるかを評価する際に役立ちます。
タグ:affects_outputs
--starlark:expr=<a string>
のデフォルト: ""-
構成された各ターゲットを cquery の --output=starlark モードでフォーマットするための Starlark 式。構成されたターゲットは「ターゲット」にバインドされます。--starlark:expr も --starlark:file も指定されていない場合、このオプションはデフォルトで「str(target.label)」になります。--starlark:expr と --starlark:file の両方を指定するとエラーになります。
タグ:terminal_output
--starlark:file=<a string>
のデフォルト: ""-
「format」という Starlark 関数を定義する 1 つの引数の名前。文字列としてフォーマットするために、構成済みの各ターゲットに適用されます。--starlark:expr と --starlark:file の両方を指定するとエラーになります。詳細については、--output=starlark のヘルプをご覧ください。
タグ:terminal_output
--[no]tool_deps
のデフォルト: 「true」-
クエリ: 無効にすると、クエリの実行対象となる依存関係グラフに「実行構成」の依存関係は含まれません。「proto_library」ルールから Protocol Compiler までの「exec 構成」依存関係エッジは通常、同じ「ターゲット」プログラムの一部ではなく、ビルド中に実行されたツールを指します。
Cquery: 無効にすると、この構成済みターゲットを検出した最上位ターゲットから実行移行を通過する構成済みターゲットがすべて除外されます。つまり、最上位のターゲットがターゲット構成に含まれている場合は、そのターゲット構成にも構成済みのターゲットのみが返されます。最上位のターゲットが exec 構成に含まれている場合は、exec 構成のターゲットのみが返されます。このオプションは、解決済みのツールチェーンを除外しません。
タグ:build_file_semantics
--transitions=<full, lite or none>
のデフォルト: 「なし」-
cquery が遷移情報を出力する形式。
タグ:affects_outputs
--universe_scope=<comma-separated list of options>
のデフォルト: ""-
カンマ区切りのターゲット パターンのセット(加法と減算)。クエリは、指定されたターゲットの推移的クロージャで定義されたユニバースで実行できます。このオプションは、query コマンドと cquery コマンドで使用されます。cquery の場合、このオプションに入力する値はすべての回答がビルドされるターゲットとなるため、このオプションは構成や遷移に影響する可能性があります。このオプションが指定されていない場合、トップレベル ターゲットはクエリ式から解析されたターゲットと見なされます。注: cquery でこのオプションを指定しないと、クエリ式から解析されたターゲットがトップレベル オプションでビルドできない場合、ビルドが中断されることがあります。
タグ:loading_and_analysis
- ビルド時間の最適化をトリガーするオプション:
--[no]experimental_filter_library_jar_with_program_jar
デフォルト: 「false」-
ProGuard ProgramJar をフィルタリングして、LibraryJar にも存在するクラスを削除します。
タグ:action_command_lines
--[no]experimental_inmemory_dotd_files
のデフォルト: 「true」-
有効にすると、C++ .d ファイルはディスクに書き込むのではなく、リモートビルドノードから直接メモリ内に渡されます。
タグ:loading_and_analysis
、execution
、affects_outputs
、experimental
--[no]experimental_inmemory_jdeps_files
のデフォルト: 「true」-
有効にすると、Java コンパイルで生成された依存関係(.jdeps)ファイルは、ディスクに書き込まれるのではなく、リモートビルドノードから直接メモリ内に渡されます。
タグ:loading_and_analysis
、execution
、affects_outputs
、experimental
--[no]experimental_objc_include_scanning
デフォルト: 「false」-
目的の C/C++ のスキャンを実行するかどうか。
タグ:loading_and_analysis
、execution
、changes_inputs
--[no]experimental_retain_test_configuration_across_testonly
デフォルト: 「false」-
有効にすると、--trim_test_configuration は testonly=1 とマークされたルールのテスト構成をトリミングしません。これは、テスト以外のルールが cc_test ルールに依存している場合のアクションの競合の問題を軽減するためです。--trim_test_configuration が false の場合は効果はありません。
タグ:loading_and_analysis
、loses_incremental_state
--[no]experimental_starlark_cc_import
デフォルト: 「false」-
有効にすると、Starlark バージョンの cc_import を使用できます。
タグ:loading_and_analysis
、experimental
--[no]experimental_unsupported_and_brittle_include_scanning
デフォルト: 「false」-
入力ファイルの #include 行を解析して入力を C/C++ コンパイルに絞り込むかどうかを指定します。これにより、コンパイルの入力ツリーのサイズを縮小することで、パフォーマンスとインクリメンタリティを改善できます。ただし、インクルード スキャナは C プリプロセッサのセマンティクスを完全に実装していないため、ビルドが中断される可能性があります。特に、動的な #include ディレクティブは認識されず、プリプロセッサの条件付きロジックは無視されます。自己責任で使用してください。このフラグに関して報告された問題はクローズされます。
タグ:loading_and_analysis
、execution
、changes_inputs
--[no]incremental_dexing
のデフォルト: 「true」-
dex 変換のほとんどの作業は、Jar ファイルごとに個別に行います。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--[no]objc_use_dotd_pruning
のデフォルト: 「true」-
設定すると、clang が出力した .d ファイルが、objc コンパイルに渡される入力のセットをプルーニングするために使用されます。
タグ:changes_inputs
、loading_and_analysis
--[no]process_headers_in_dependencies
デフォルト: 「false」-
ターゲット //a:a をビルドする際、//a:a が依存するすべてのターゲットのヘッダーを処理します(ツールチェーンでヘッダー処理が有効になっている場合)。
タグ:execution
--[no]trim_test_configuration
のデフォルト: 「true」-
有効にすると、ビルドのトップレベルの下にあるテスト関連のオプションがクリアされます。このフラグを有効にすると、テスト以外のルールの依存関係としてテストをビルドすることはできませんが、テスト関連のオプションを変更してもテスト以外のルールが再分析されることはありません。
タグ:loading_and_analysis
、loses_incremental_state
- ロギングの詳細度、形式、場所に影響するオプション:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
のデフォルト: "-.*"-
ツールチェーンの解決時にデバッグ情報を出力します。このフラグは正規表現を使用します。正規表現は、デバッグ対象を確認するためにツールチェーン タイプおよび特定のターゲットと照合されます。複数の正規表現をコンマで区切ると、それぞれの正規表現が個別にチェックされます。注: このフラグの出力は非常に複雑で、ツールチェーンの解決に携わる専門家にのみ役立つ可能性があります。
タグ:terminal_output
- 他のカテゴリに当てはまらない Bazel コマンドへの汎用入力を指定または変更するオプション。
--flag_alias=<a 'name=value' flag alias>
件の複数回の使用が累積される-
Starlark フラグの省略名を設定します。引数として「<key>=<value>」形式の 1 つの Key-Value ペアを取ります。
タグ:changes_inputs
--[no]incompatible_default_to_explicit_init_py
デフォルト: 「false」-
このフラグはデフォルトの動作を変更し、Python ターゲットの実行ファイルで __init__.py ファイルが自動的に作成されなくなります。正確には、py_binary または py_test のターゲットで legacy_create_init が「auto」(デフォルト)に設定されている場合、このフラグが設定されている場合にのみ false として扱われます。https://github.com/bazelbuild/bazel/issues/10076 をご覧ください。
タグ:affects_outputs
、incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
のデフォルト: 「true」-
true の場合、Python 2 の構成でビルドされたターゲットは、接尾辞「-py2」を含む出力ルートの下に表示されます。Python 3 用にビルドされたターゲットは、Python 関連の接尾辞がないルートに表示されます。つまり、「bazel-bin」という便利なシンボリック リンクが、Python 2 ではなく Python 3 のターゲットを指すようになります。このオプションを有効にする場合は、「--compatible_py3_is_default」も有効にすることをおすすめします。
タグ:affects_outputs
、incompatible_change
--[no]incompatible_py3_is_default
のデフォルト: 「true」-
true の場合、「python_version」(または「default_python_version」)属性が設定されていない「py_binary」および「py_test」ターゲットはデフォルトで PY2 ではなく PY3 に設定されます。このフラグを設定する場合は、「--compatible_py2_outputs_are_suffixed」も設定することをおすすめします。
タグ:loading_and_analysis
、affects_outputs
、incompatible_change
--[no]incompatible_use_python_toolchains
のデフォルト: 「true」-
true に設定すると、実行可能なネイティブ Python ルールは、以前のフラグ(--python_top など)で指定されたランタイムではなく、Python ツールチェーンで指定された Python ランタイムを使用します。
タグ:loading_and_analysis
、incompatible_change
--python_version=<PY2 or PY3>
デフォルト: 説明を参照-
Python メジャー バージョン モードです。「PY2」または「PY3」のいずれかです。これは、(バージョンを明示的に指定していなくても)「py_binary」および「py_test」のターゲットによってオーバーライドされるため、このフラグを指定する理由は通常あまりありません。
タグ:loading_and_analysis
、affects_outputs
- その他のオプション(特に分類されていないもの):
--[no]cache_test_results
[-t
] default: "auto"- 「auto」に設定すると、次の場合にのみ、Bazel がテストを再実行します。(1)Bazel がテストまたはその依存関係の変更を検出した、(2)テストが外部としてマークされている、(3)--runs_per_test で複数のテスト実行がリクエストされた、(4)以前にテストが失敗した。「yes」に設定すると、Bazel は外部としてマークされたテストを除くすべてのテスト結果をキャッシュに保存します。「no」に設定した場合、Bazel はテスト結果をキャッシュに保存しません。
--[no]experimental_cancel_concurrent_tests
デフォルト: 「false」-
true の場合、Blaze は最初に成功した実行時に、同時に実行されているテストをキャンセルします。これは、--runs_per_test_detects_flakes と組み合わせた場合にのみ有用です。
タグ:affects_outputs
、loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
デフォルト: 「false」-
true の場合、Bazel はカバレッジの実行中に、各テストでカバレッジ データ ディレクトリ全体を取得します。
タグ:affects_outputs
、loading_and_analysis
--[no]experimental_generate_llvm_lcov
デフォルト: 「false」-
true の場合、clang のカバレッジにより LCOV レポートが生成されます。
タグ:affects_outputs
、loading_and_analysis
--[no]experimental_j2objc_header_map
のデフォルト: 「true」- J2ObjC のトランスパイルと並行して J2ObjC ヘッダーマップを生成するかどうかを指定します。
--[no]experimental_j2objc_shorter_header_path
デフォルト: 「false」-
短いヘッダーパスで生成するかどうか(_j2objc ではなく _ios を使用します)。
タグ:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
のデフォルト: 「javabuilder」- Java コンパイルのクラスパスを削減できます。
--[no]experimental_limit_android_lint_to_android_constrained_java
デフォルト: 「false」-
--experimental_run_android_lint_on_java_rules を Android 互換ライブラリに制限します。
タグ:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
デフォルト: 「false」-
java_* ソースを検証するかどうかを指定します。
タグ:affects_outputs
--[no]explicit_java_test_deps
デフォルト: 「false」- TestRunner の依存関係を誤って取得するのではなく、java_test で JUnit または Hamcrest への依存関係を明示的に指定します。現在は bazel でのみ機能します。
--host_java_launcher=<a build target label>
デフォルト: 説明を参照- ビルド時に実行されるツールで使用される Java ランチャー。
--host_javacopt=<a string>
件の複数回の使用が累積される- ビルドで実行されるツールをビルドするときに javac に渡す追加オプション。
--host_jvmopt=<a string>
件の複数回の使用が累積される- ビルド時に実行されるツールをビルドするときに Java VM に渡す追加のオプション。これらのオプションは、各 java_binary ターゲットの VM 起動オプションに追加されます。
--[no]incompatible_check_sharding_support
のデフォルト: 「true」-
true の場合、テストランナーが TEST_SHARD_STATUS_FILE のパスにあるファイルをタップしてシャーディングをサポートしていることを示していない場合、Bazel はシャーディングされたテストに失敗します。false の場合、シャーディングをサポートしていないテストランナーによって、各シャードですべてのテストが実行されます。
タグ:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
のデフォルト: 「true」-
true の場合、サンドボックス化された戦略で排他的なテストが実行されます。排他的なテストをローカルで強制的に実行するには、「local」タグを追加します。
タグ:incompatible_change
--[no]incompatible_strict_action_env
デフォルト: 「false」-
true の場合、Bazel は PATH に静的な値を持つ環境を使用し、LD_LIBRARY_PATH を継承しません。クライアントから特定の環境変数を継承する場合は --action_env=ENV_VARIABLE を使用しますが、共有キャッシュを使用している場合に共有すると、ユーザー間のキャッシュ保存が妨げられる可能性があります。
タグ:loading_and_analysis
、incompatible_change
--j2objc_translation_flags=<comma-separated list of options>
件の複数回の使用が累積される- J2ObjC ツールに渡す追加オプション。
--java_debug
-
Java テストの Java 仮想マシンで、JDWP 準拠のデバッガ(jdb など)からの接続を待ってからテストを開始します。-test_output=streamed を意味します。
拡張後:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
のデフォルト: 「true」- Java ターゲットごとに依存関係情報を生成します(現時点ではコンパイル時クラスパス)。
--[no]java_header_compilation
のデフォルト: 「true」- ソースから直接 ijar をコンパイルします。
--java_language_version=<a string>
のデフォルト: ""- Java 言語バージョン
--java_launcher=<a build target label>
デフォルト: 説明を参照- Java バイナリをビルドするときに使用する Java ランチャー。このフラグを空の文字列に設定すると、JDK ランチャーが使用されます。「launcher」属性はこのフラグをオーバーライドします。
--java_runtime_version=<a string>
のデフォルト: 「local_jdk」- Java ランタイム バージョン
--javacopt=<a string>
件の複数回の使用が累積される- javac に渡す追加オプション。
--jvmopt=<a string>
件の複数回の使用が累積される- Java VM に渡す追加オプション。これらのオプションは、各 java_binary ターゲットの VM 起動オプションに追加されます。
--legacy_main_dex_list_generator=<a build target label>
デフォルト: 説明を参照- 以前の Multidex をコンパイルする際にメイン dex に含める必要があるクラスのリストを生成するために使用するバイナリを指定します。
--optimizing_dexer=<a build target label>
デフォルト: 説明を参照- シャーディングなしの dex 変換に使用するバイナリを指定します。
--plugin=<a build target label>
件の複数回の使用が累積される- ビルドで使用するプラグイン。現在は java_plugin で機能します。
--proguard_top=<a build target label>
デフォルト: 説明を参照- Java バイナリをビルドするときにコードの削除に使用する ProGuard のバージョンを指定します。
--proto_compiler=<a build target label>
デフォルト: "@bazel_tools//tools/proto:protoc"-
プロトコル コンパイラのラベル。
タグ:affects_outputs
、loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
のデフォルト: "@bazel_tools//tools/proto:cc_chain"-
C++ proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル
タグ:affects_outputs
、loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
のデフォルト: "@bazel_tools//tools/j2objc:j2objc_proto_ツールチェーン"-
j2objc proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル
タグ:affects_outputs
、loading_and_analysis
--proto_toolchain_for_java=<a build target label>
のデフォルト: "@bazel_tools//tools/proto:java_ツールチェーン"-
Java proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル
タグ:affects_outputs
、loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
デフォルト: "@bazel_tools//tools/proto:javalite_ツールチェーン"-
JavaLite proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル
タグ:affects_outputs
、loading_and_analysis
--protocopt=<a string>
件の複数回の使用が累積される-
protobuf コンパイラに渡す追加オプション。
タグ:affects_outputs
--[no]runs_per_test_detects_flakes
デフォルト: 「false」- true の場合、1 つ以上の実行/試行が成功し、1 つ以上の実行/試行が失敗したシャードは、FLAKY ステータスになります。
--shell_executable=<a path>
デフォルト: 説明を参照-
Bazel が使用するシェル実行可能ファイルへの絶対パス。未設定で、最初の Bazel 呼び出し(Bazel サーバーを起動する)で BAZEL_SH 環境変数が設定されていると、Bazel ではその値が使用されます。どちらも設定されていない場合、Bazel は実行されているオペレーティング システムに応じてハードコードされたデフォルト パスを使用します(Windows: c:/tools/msys64/usr/bin/bash.exe、FreeBSD: /usr/local/bin/bash、その他: /bin/bash)。bash と互換性のないシェルを使用すると、生成されたバイナリのビルドエラーやランタイム エラーが発生する可能性があります。
タグ:loading_and_analysis
--test_arg=<a string>
件の複数回の使用が累積される- テスト実行可能ファイルに渡す必要がある追加のオプションと引数を指定します。複数回使用して、複数の引数を指定できます。複数のテストが実行される場合、それぞれは同じ引数を受け取ります。「bazel test」コマンドでのみ使用されます。
--test_filter=<a string>
デフォルト: 説明を参照- テスト フレームワークに転送するフィルタを指定します。実行するテストを制限するために使用します。これは、ビルドされるターゲットには影響しません。
--test_result_expiration=<an integer>
デフォルト: 「-1」- このオプションは非推奨であり、機能しません。
--[no]test_runner_fail_fast
デフォルト: 「false」- テストランナーにフェイル ファスト オプションを転送する。テストランナーは、最初の失敗時に実行を停止する必要があります。
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
のデフォルト: "explicit"- テストのシャーディング戦略を指定します。「shard_count」の BUILD 属性が存在する場合にのみシャーディングを使用するには、「明示的」を指定します。テストのシャーディングを使用しない場合。「シャード_count」の BUILD 属性に関係なく「k」シャードをテストに強制適用する「forced=k」。
--tool_java_language_version=<a string>
のデフォルト: ""- ビルドで必要なツールの実行に使用される Java 言語のバージョン
--tool_java_runtime_version=<a string>
のデフォルト: "remotejdk_11"- ビルド中にツールを実行するために使用される Java ランタイム バージョン
--[no]use_ijars
のデフォルト: 「true」- 有効にすると、Java コンパイルでインターフェース JAR が使用されます。増分コンパイルは高速になりますが、エラー メッセージが異なる場合があります。
ダンプ オプション
- コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path>
件の複数回の使用が累積される-
ネットワークにアクセスしてダウンロードする前に、アーカイブを検索できる場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
デフォルト: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュでファイルがコピーされずにハードリンクされます。これはディスク容量を節約することが目的です。
タグ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
のデフォルト: 「0」-
ダウンロード エラーの再試行の最大回数。0 に設定した場合、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: 1.0-
この要素に基づいて、Starlark リポジトリ ルールのすべてのタイムアウトをスケールします。これにより、ソースコードを変更せずに、ルール作成者の期待よりも低速なマシンで外部リポジトリを動作させることができます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
のデフォルト: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: 「0s」-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にした場合、タイムアウトの最大値は定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: 1.0-
HTTP ダウンロードに関連するすべてのタイムアウトを、指定された係数でスケーリングする
タグ:bazel_internal_configuration
--repository_cache=<a path>
デフォルト: 説明を参照-
外部リポジトリの取得中に取得された、ダウンロードした値のキャッシュ ロケーションを指定します。引数として空の文字列は、キャッシュの無効化をリクエストします。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
デフォルト: 「false」-
設定すると、リポジトリの取得中に resourcemanager.download{,_and_extract} を使用してダウンロードできなくなります。ネットワーク アクセスは完全に無効にされているわけではありません。インターネットにアクセスする任意の実行可能ファイルを resourcemanager.execute で実行することは可能です。
タグ:bazel_internal_configuration
- ビルド実行を制御するオプション:
--gc_thrashing_threshold=<an integer in 0-100 range>
のデフォルト: 「100」-
GcThrashingDetector がメモリ プレッシャー イベントを上限(--gc_thrashing_limits)と比較して考慮する、在職期間の占有スペースの割合(0 ~ 100)。100 に設定すると、GcThrashingDetector は無効になります。
タグ:host_machine_resource_optimizations
- コマンドの出力を制御するオプション:
--[no]action_cache
デフォルト: 「false」-
ダンプ アクション キャッシュのコンテンツ。
タグ:bazel_monitoring
--[no]packages
デフォルト: 「false」-
パッケージ キャッシュのコンテンツをダンプします。
タグ:bazel_monitoring
--[no]rule_classes
デフォルト: 「false」-
ダンプルールクラス。
タグ:bazel_monitoring
--[no]rules
デフォルト: 「false」-
カウントやメモリ使用量などのダンプルール(メモリをトラッキングしている場合)。
タグ:bazel_monitoring
--skyframe=<off, summary, count, deps or rdeps>
のデフォルト: 「off」-
ダンプ スカイフレーム グラフ: 「off」、「summary」、「count」、「deps」、「rdeps」。
タグ:bazel_monitoring
--skykey_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
のデフォルト: ".*"-
出力する SkyKey 名の正規表現フィルタ。--skyframe=deps、rdeps とともに使用します。
タグ:bazel_monitoring
--skylark_memory=<a string>
デフォルト: 説明を参照-
pprof 互換メモリ プロファイルを、指定されたパスにダンプします。詳しくは、https://github.com/google/pprof をご覧ください。
タグ:bazel_monitoring
- Bzlmod の出力とセマンティクスに関連するオプション:
--allow_yanked_versions=<a string>
件の複数回の使用が累積される-
モジュール バージョンを「<module1>@<version1>,<module2>@<version2>」の形式で指定しました。これは、モジュール バージョンが元のレジストリでヤンクされていると宣言されていても(NonRegistryOverride からのものではない場合)、解決済みの依存関係グラフで許可します。そうしないと、バージョンをアンクすると解決が失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可するヤンク バージョンを定義することもできます。このチェックを無効にするには、キーワード「all」を使用します(非推奨)。
タグ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
デフォルト: "error"-
Bazel モジュールの bazel バージョン互換性を確認します。有効な値は、エラーを解決失敗にエスカレーションする場合は「error」、チェックを無効にする場合は「off」、不一致が検出されたときに警告を出力する場合は「warning」です。
タグ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
のデフォルト: 「warning」-
ルート モジュールで宣言されている直接的な「bazel_dep」依存関係が、解決された依存関係グラフで表示されるバージョンと同じかどうかを確認します。有効な値は、チェックを無効にする「off」、不一致が検出されたときに警告を出力する「warning」、解決失敗にエスカレーションする場合は「error」です。
タグ:loading_and_analysis
--[no]ignore_dev_dependency
デフォルト: 「false」-
true の場合、Bazel は、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」を無視します。これらの dev の依存関係は、このフラグの値に関係なく、ルート モジュールでない場合、MODULE.bazel では常に無視されることに注意してください。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: 「update」-
ロックファイルを使用する方法と使用するかどうかを指定します。有効な値は、「update」でロックファイルを使用し、変更がある場合に「error」を指定します。「error」はロックファイルを使用しますが、最新でない場合はエラーをスローします。「off」はロックファイルの読み取りも書き込みも行わない「off」です。
タグ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
件の複数回の使用が累積される- <モジュール名>=<パス> という形式のローカルパスでモジュールをオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。相対パスの場合は、現在の作業ディレクトリからの相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--registry=<a string>
件の複数回の使用が累積される-
Bazel モジュールの依存関係の検索に使用するレジストリを指定します。順序は重要です。モジュールは最初に以前のレジストリで検索され、以前のレジストリからモジュールが見つからなくなった場合にのみ、後のレジストリにフォールバックします。
タグ:changes_inputs
- ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
デフォルト: 「1s:2,20s:3,1m:5」-
上限に達すると GcThrashingDetector が OOM で Bazel をクラッシュさせる上限。各制限は、<period>:<count> の形式で指定します。[期間] は期間、[カウント] は正の整数です。<period> で <count> 回連続してフル GC を実行した後、残存容量(旧世代ヒープ)の --gc_thrashing_threshold パーセントを超える領域が占有されている場合、OOM がトリガーされます。複数の上限を指定する場合は、カンマで区切ってください。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出した場合、完全な GC イベントが発生したときに、不要な一時的な Skyframe の状態を呼び出しごとにこの回数まで破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、完全な GC イベントがドロップをトリガーしないことを意味します。上限に達すると、フル GC イベントが発生して保持されるヒープの割合のしきい値を超えたときに、スカイフレームの状態がドロップされなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出すると、マイナー GC イベントが発生したときに不要な一時的な Skyframe 状態を(呼び出しごとにこの回数まで)破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。上限に達すると、マイナー GC イベントが発生して保持されるヒープの割合のしきい値を超えても、スカイフレームの状態は破棄されなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
のデフォルト: 「85」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。Bazel は、保持されているヒープの割合がこのしきい値以上であることを検出すると、不要な一時的な Skyframe 状態を削除します。これを微調整することで、GC スラッシングが(i)この一時的な状態のメモリ使用量によって発生し、(ii)必要なときに状態の再構築よりもコストが高くなる場合に、GC スラッシングの経過時間への影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
- ロギングの詳細度、形式、場所に影響するオプション:
--[no]experimental_command_profile
デフォルト: 「false」- Java フライト レコーダーの CPU プロファイルを、出力ベース ディレクトリにある profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプや出力形式をサポートするために今後変更される可能性があります。ご自身の責任のもとで使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
デフォルト: 「false」- デフォルトでは、アクション タイプの数は、実行されるアクションの数が最も多い 20 個のニーモニックに限定されています。このオプションを設定すると、すべてのニーモニックの統計情報が書き込まれます。
- 他のカテゴリに当てはまらない Bazel コマンドへの汎用入力を指定または変更するオプション。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: ""-
空でない場合は、WORKSPACE ファイルではなく、指定された解決済みファイルを読み取ります。
タグ:changes_inputs
- リモート キャッシュと実行オプション:
--experimental_downloader_config=<a string>
デフォルト: 説明を参照- リモート ダウンローダーを構成するファイルを指定します。このファイルは複数の行で構成され、各行はディレクティブ(「allow」、「block」、「rewrite」)で始まり、その後にホスト名(「allow」と「block」のそれぞれ)または 2 つのパターン(1 つは照合され、もう 1 つは代替 URL として使用)が続きます。後方参照は「$1」から始まります。複数の「rewrite」ディレクティブが返される場合があります。同じ URL の場合は、複数の URL が返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: 「off」- リポジトリの取得に使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、「platform」に設定されている場合はプラットフォーム スレッド(OS スレッド)を使用し、「virtual」に設定されている場合は仮想スレッドを使用します。
- その他のカテゴリ(特に分類されていないもの):
--override_repository=<an equals-separated mapping of repository name to path>
件の複数回の使用が累積される- リポジトリは、<repository name>=<path> という形式のローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスがそのまま使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
取得オプション
- コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path>
件の複数回の使用が累積される-
ネットワークにアクセスしてダウンロードする前に、アーカイブを検索できる場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
デフォルト: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュでファイルがコピーされずにハードリンクされます。これはディスク容量を節約することが目的です。
タグ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
のデフォルト: 「0」-
ダウンロード エラーの再試行の最大回数。0 に設定した場合、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: 1.0-
この要素に基づいて、Starlark リポジトリ ルールのすべてのタイムアウトをスケールします。これにより、ソースコードを変更せずに、ルール作成者の期待よりも低速なマシンで外部リポジトリを動作させることができます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
のデフォルト: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: 「0s」-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にした場合、タイムアウトの最大値は定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: 1.0-
HTTP ダウンロードに関連するすべてのタイムアウトを、指定された係数でスケーリングする
タグ:bazel_internal_configuration
--repository_cache=<a path>
デフォルト: 説明を参照-
外部リポジトリの取得中に取得された、ダウンロードした値のキャッシュ ロケーションを指定します。引数として空の文字列は、キャッシュの無効化をリクエストします。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
デフォルト: 「false」-
設定すると、リポジトリの取得中に resourcemanager.download{,_and_extract} を使用してダウンロードできなくなります。ネットワーク アクセスは完全に無効にされているわけではありません。インターネットにアクセスする任意の実行可能ファイルを resourcemanager.execute で実行することは可能です。
タグ:bazel_internal_configuration
- ビルド実行を制御するオプション:
--[no]all
デフォルト: 「false」-
ターゲットまたはリポジトリのビルドに必要なすべての外部リポジトリを取得します。--enable_bzlmod がオンになっている場合にのみ機能します。
タグ:changes_inputs
--[no]configure
デフォルト: 「false」-
システム構成のために「configure」とマークされているリポジトリのみを取得します。--enable_bzlmod がオンになっている場合にのみ機能します。
タグ:changes_inputs
--[no]force
デフォルト: 「false」-
既存のリポジトリ(存在する場合)を無視し、リポジトリを再度強制的に取得します。--enable_bzlmod がオンになっている場合にのみ機能します。
タグ:changes_inputs
--gc_thrashing_threshold=<an integer in 0-100 range>
のデフォルト: 「100」-
GcThrashingDetector がメモリ プレッシャー イベントを上限(--gc_thrashing_limits)と比較して考慮する、在職期間の占有スペースの割合(0 ~ 100)。100 に設定すると、GcThrashingDetector は無効になります。
タグ:host_machine_resource_optimizations
--[no]keep_going
[-k
] default: "false"-
エラー発生後は、できるだけ続行してください。失敗したターゲットとそれに依存するターゲットは分析できませんが、これらのターゲットの他の前提条件は分析できます。
タグ:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
のデフォルト: "auto"-
読み込み/分析フェーズに使用する並列スレッドの数。整数またはキーワード("auto"、"HOST_CPUS"、"HOST_RAM")を受け取ります。その後に必要に応じて演算([-|*]<float>)が続きます。例:"auto"、"HOST_CPUS*.5" となります。「auto」は、ホストリソースに基づいて妥当なデフォルトを設定します。1 以上の値を指定してください。
タグ:bazel_internal_configuration
--repo=<a string>
件の複数回の使用が累積される-
指定されたリポジトリ({@apparent_repo_name} または {@@canonical_repo_name} のいずれか)のみを取得します。--enable_bzlmod がオンになっている場合にのみ機能します。
タグ:changes_inputs
- このオプションは、BUILD ファイル、.bzl ファイル、WORKSPACE ファイルからアクセス可能な Starlark 言語または Build API のセマンティクスに影響します。
--[no]incompatible_config_setting_private_default_visibility
デフォルト: 「false」-
compatible_enforce_config_setting_visibility=false の場合、何も追加されません。このフラグが false の場合、明示的な可視性属性のない config_setting は //visibility:public です。このフラグが true の場合、config_setting は他のすべてのルールと同じ可視性ロジックに従います。https://github.com/bazelbuild/bazel/issues/12933 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_enforce_config_setting_visibility
のデフォルト: 「true」-
true の場合、config_setting 公開設定の制限を適用します。false の場合、すべての config_setting がすべてのターゲットに表示されます。https://github.com/bazelbuild/bazel/issues/12932 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
- Bzlmod の出力とセマンティクスに関連するオプション:
--allow_yanked_versions=<a string>
件の複数回の使用が累積される-
モジュール バージョンを「<module1>@<version1>,<module2>@<version2>」の形式で指定しました。これは、モジュール バージョンが元のレジストリでヤンクされていると宣言されていても(NonRegistryOverride からのものではない場合)、解決済みの依存関係グラフで許可します。そうしないと、バージョンをアンクすると解決が失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可するヤンク バージョンを定義することもできます。このチェックを無効にするには、キーワード「all」を使用します(非推奨)。
タグ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
デフォルト: "error"-
Bazel モジュールの bazel バージョン互換性を確認します。有効な値は、エラーを解決失敗にエスカレーションする場合は「error」、チェックを無効にする場合は「off」、不一致が検出されたときに警告を出力する場合は「warning」です。
タグ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
のデフォルト: 「warning」-
ルート モジュールで宣言されている直接的な「bazel_dep」依存関係が、解決された依存関係グラフで表示されるバージョンと同じかどうかを確認します。有効な値は、チェックを無効にする「off」、不一致が検出されたときに警告を出力する「warning」、解決失敗にエスカレーションする場合は「error」です。
タグ:loading_and_analysis
--[no]ignore_dev_dependency
デフォルト: 「false」-
true の場合、Bazel は、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」を無視します。これらの dev の依存関係は、このフラグの値に関係なく、ルート モジュールでない場合、MODULE.bazel では常に無視されることに注意してください。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: 「update」-
ロックファイルを使用する方法と使用するかどうかを指定します。有効な値は、「update」でロックファイルを使用し、変更がある場合に「error」を指定します。「error」はロックファイルを使用しますが、最新でない場合はエラーをスローします。「off」はロックファイルの読み取りも書き込みも行わない「off」です。
タグ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
件の複数回の使用が累積される- <モジュール名>=<パス> という形式のローカルパスでモジュールをオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。相対パスの場合は、現在の作業ディレクトリからの相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--registry=<a string>
件の複数回の使用が累積される-
Bazel モジュールの依存関係の検索に使用するレジストリを指定します。順序は重要です。モジュールは最初に以前のレジストリで検索され、以前のレジストリからモジュールが見つからなくなった場合にのみ、後のレジストリにフォールバックします。
タグ:changes_inputs
- ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
デフォルト: 「1s:2,20s:3,1m:5」-
上限に達すると GcThrashingDetector が OOM で Bazel をクラッシュさせる上限。各制限は、<period>:<count> の形式で指定します。[期間] は期間、[カウント] は正の整数です。<period> で <count> 回連続してフル GC を実行した後、残存容量(旧世代ヒープ)の --gc_thrashing_threshold パーセントを超える領域が占有されている場合、OOM がトリガーされます。複数の上限を指定する場合は、カンマで区切ってください。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出した場合、完全な GC イベントが発生したときに、不要な一時的な Skyframe の状態を呼び出しごとにこの回数まで破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、完全な GC イベントがドロップをトリガーしないことを意味します。上限に達すると、フル GC イベントが発生して保持されるヒープの割合のしきい値を超えたときに、スカイフレームの状態がドロップされなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出すると、マイナー GC イベントが発生したときに不要な一時的な Skyframe 状態を(呼び出しごとにこの回数まで)破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。上限に達すると、マイナー GC イベントが発生して保持されるヒープの割合のしきい値を超えても、スカイフレームの状態は破棄されなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
のデフォルト: 「85」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。Bazel は、保持されているヒープの割合がこのしきい値以上であることを検出すると、不要な一時的な Skyframe 状態を削除します。これを微調整することで、GC スラッシングが(i)この一時的な状態のメモリ使用量によって発生し、(ii)必要なときに状態の再構築よりもコストが高くなる場合に、GC スラッシングの経過時間への影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
- ロギングの詳細度、形式、場所に影響するオプション:
--[no]experimental_command_profile
デフォルト: 「false」- Java フライト レコーダーの CPU プロファイルを、出力ベース ディレクトリにある profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプや出力形式をサポートするために今後変更される可能性があります。ご自身の責任のもとで使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
デフォルト: 「false」- デフォルトでは、アクション タイプの数は、実行されるアクションの数が最も多い 20 個のニーモニックに限定されています。このオプションを設定すると、すべてのニーモニックの統計情報が書き込まれます。
--experimental_repository_resolved_file=<a string>
のデフォルト: ""-
空でない場合は、実行されたすべての Starlark リポジトリ ルールの解決された情報を含む Starlark 値を書き込みます。
タグ:affects_outputs
- 他のカテゴリに当てはまらない Bazel コマンドへの汎用入力を指定または変更するオプション。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: ""-
空でない場合は、WORKSPACE ファイルではなく、指定された解決済みファイルを読み取ります。
タグ:changes_inputs
- リモート キャッシュと実行オプション:
--experimental_downloader_config=<a string>
デフォルト: 説明を参照- リモート ダウンローダーを構成するファイルを指定します。このファイルは複数の行で構成され、各行はディレクティブ(「allow」、「block」、「rewrite」)で始まり、その後にホスト名(「allow」と「block」のそれぞれ)または 2 つのパターン(1 つは照合され、もう 1 つは代替 URL として使用)が続きます。後方参照は「$1」から始まります。複数の「rewrite」ディレクティブが返される場合があります。同じ URL の場合は、複数の URL が返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: 「off」- リポジトリの取得に使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、「platform」に設定されている場合はプラットフォーム スレッド(OS スレッド)を使用し、「virtual」に設定されている場合は仮想スレッドを使用します。
- その他のカテゴリ(特に分類されていないもの):
--deleted_packages=<comma-separated list of package names>
件の複数回の使用が累積される- パッケージ名のカンマ区切りリスト。パッケージパス上のどこかに表示されていても、ビルドシステムによって存在しないと判断されます。 既存のパッケージ「x」のサブパッケージ「x/y」を削除する場合は、このオプションを使用します。たとえば、クライアントで x/y/BUILD を削除した後、別の package_path エントリによってラベル「//x:y/z」が見つかると、ビルドシステムからエラーが発生することがあります。--deleted_packages x/y を指定すると、この問題を回避できます。
--override_repository=<an equals-separated mapping of repository name to path>
件の複数回の使用が累積される- リポジトリは、<repository name>=<path> という形式のローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスがそのまま使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--package_path=<colon-separated list of options>
のデフォルト: 「%workspace%」- パッケージを検索する場所をコロンで区切ったリスト。「%workspace%」で始まる要素は、それを含むワークスペースからの相対値です。省略するか空の場合、デフォルトは「bazel info default-package-path」の出力です。
--[no]show_loading_progress
のデフォルト: 「true」- 有効にすると、Bazel から「Loading package:」というメッセージが表示されます。
ヘルプ オプション
- コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path>
件の複数回の使用が累積される-
ネットワークにアクセスしてダウンロードする前に、アーカイブを検索できる場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
デフォルト: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュでファイルがコピーされずにハードリンクされます。これはディスク容量を節約することが目的です。
タグ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
のデフォルト: 「0」-
ダウンロード エラーの再試行の最大回数。0 に設定した場合、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: 1.0-
この要素に基づいて、Starlark リポジトリ ルールのすべてのタイムアウトをスケールします。これにより、ソースコードを変更せずに、ルール作成者の期待よりも低速なマシンで外部リポジトリを動作させることができます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
のデフォルト: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: 「0s」-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にした場合、タイムアウトの最大値は定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: 1.0-
HTTP ダウンロードに関連するすべてのタイムアウトを、指定された係数でスケーリングする
タグ:bazel_internal_configuration
--repository_cache=<a path>
デフォルト: 説明を参照-
外部リポジトリの取得中に取得された、ダウンロードした値のキャッシュ ロケーションを指定します。引数として空の文字列は、キャッシュの無効化をリクエストします。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
デフォルト: 「false」-
設定すると、リポジトリの取得中に resourcemanager.download{,_and_extract} を使用してダウンロードできなくなります。ネットワーク アクセスは完全に無効にされているわけではありません。インターネットにアクセスする任意の実行可能ファイルを resourcemanager.execute で実行することは可能です。
タグ:bazel_internal_configuration
- ビルド実行を制御するオプション:
--gc_thrashing_threshold=<an integer in 0-100 range>
のデフォルト: 「100」-
GcThrashingDetector がメモリ プレッシャー イベントを上限(--gc_thrashing_limits)と比較して考慮する、在職期間の占有スペースの割合(0 ~ 100)。100 に設定すると、GcThrashingDetector は無効になります。
タグ:host_machine_resource_optimizations
- Bzlmod の出力とセマンティクスに関連するオプション:
--allow_yanked_versions=<a string>
件の複数回の使用が累積される-
モジュール バージョンを「<module1>@<version1>,<module2>@<version2>」の形式で指定しました。これは、モジュール バージョンが元のレジストリでヤンクされていると宣言されていても(NonRegistryOverride からのものではない場合)、解決済みの依存関係グラフで許可します。そうしないと、バージョンをアンクすると解決が失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可するヤンク バージョンを定義することもできます。このチェックを無効にするには、キーワード「all」を使用します(非推奨)。
タグ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
デフォルト: "error"-
Bazel モジュールの bazel バージョン互換性を確認します。有効な値は、エラーを解決失敗にエスカレーションする場合は「error」、チェックを無効にする場合は「off」、不一致が検出されたときに警告を出力する場合は「warning」です。
タグ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
のデフォルト: 「warning」-
ルート モジュールで宣言されている直接的な「bazel_dep」依存関係が、解決された依存関係グラフで表示されるバージョンと同じかどうかを確認します。有効な値は、チェックを無効にする「off」、不一致が検出されたときに警告を出力する「warning」、解決失敗にエスカレーションする場合は「error」です。
タグ:loading_and_analysis
--[no]ignore_dev_dependency
デフォルト: 「false」-
true の場合、Bazel は、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」を無視します。これらの dev の依存関係は、このフラグの値に関係なく、ルート モジュールでない場合、MODULE.bazel では常に無視されることに注意してください。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: 「update」-
ロックファイルを使用する方法と使用するかどうかを指定します。有効な値は、「update」でロックファイルを使用し、変更がある場合に「error」を指定します。「error」はロックファイルを使用しますが、最新でない場合はエラーをスローします。「off」はロックファイルの読み取りも書き込みも行わない「off」です。
タグ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
件の複数回の使用が累積される- <モジュール名>=<パス> という形式のローカルパスでモジュールをオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。相対パスの場合は、現在の作業ディレクトリからの相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--registry=<a string>
件の複数回の使用が累積される-
Bazel モジュールの依存関係の検索に使用するレジストリを指定します。順序は重要です。モジュールは最初に以前のレジストリで検索され、以前のレジストリからモジュールが見つからなくなった場合にのみ、後のレジストリにフォールバックします。
タグ:changes_inputs
- ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
デフォルト: 「1s:2,20s:3,1m:5」-
上限に達すると GcThrashingDetector が OOM で Bazel をクラッシュさせる上限。各制限は、<period>:<count> の形式で指定します。[期間] は期間、[カウント] は正の整数です。<period> で <count> 回連続してフル GC を実行した後、残存容量(旧世代ヒープ)の --gc_thrashing_threshold パーセントを超える領域が占有されている場合、OOM がトリガーされます。複数の上限を指定する場合は、カンマで区切ってください。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出した場合、完全な GC イベントが発生したときに、不要な一時的な Skyframe の状態を呼び出しごとにこの回数まで破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、完全な GC イベントがドロップをトリガーしないことを意味します。上限に達すると、フル GC イベントが発生して保持されるヒープの割合のしきい値を超えたときに、スカイフレームの状態がドロップされなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出すると、マイナー GC イベントが発生したときに不要な一時的な Skyframe 状態を(呼び出しごとにこの回数まで)破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。上限に達すると、マイナー GC イベントが発生して保持されるヒープの割合のしきい値を超えても、スカイフレームの状態は破棄されなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
のデフォルト: 「85」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。Bazel は、保持されているヒープの割合がこのしきい値以上であることを検出すると、不要な一時的な Skyframe 状態を削除します。これを微調整することで、GC スラッシングが(i)この一時的な状態のメモリ使用量によって発生し、(ii)必要なときに状態の再構築よりもコストが高くなる場合に、GC スラッシングの経過時間への影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
- ロギングの詳細度、形式、場所に影響するオプション:
--[no]experimental_command_profile
デフォルト: 「false」- Java フライト レコーダーの CPU プロファイルを、出力ベース ディレクトリにある profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプや出力形式をサポートするために今後変更される可能性があります。ご自身の責任のもとで使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
デフォルト: 「false」- デフォルトでは、アクション タイプの数は、実行されるアクションの数が最も多い 20 個のニーモニックに限定されています。このオプションを設定すると、すべてのニーモニックの統計情報が書き込まれます。
--help_verbosity=<long, medium or short>
のデフォルト: 「medium」-
ヘルプコマンドの詳細レベルを選択します。
タグ:affects_outputs
、terminal_output
--long
[-l
]-
各オプションの名前だけでなく、詳しい説明を表示します。
展開先:
--help_verbosity=long
タグ:affects_outputs
、terminal_output
--short
-
オプションの名前のみを表示し、タイプや意味は表示されません。
展開:
--help_verbosity=short
タグ:affects_outputs
、terminal_output
- 他のカテゴリに当てはまらない Bazel コマンドへの汎用入力を指定または変更するオプション。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: ""-
空でない場合は、WORKSPACE ファイルではなく、指定された解決済みファイルを読み取ります。
タグ:changes_inputs
- リモート キャッシュと実行オプション:
--experimental_downloader_config=<a string>
デフォルト: 説明を参照- リモート ダウンローダーを構成するファイルを指定します。このファイルは複数の行で構成され、各行はディレクティブ(「allow」、「block」、「rewrite」)で始まり、その後にホスト名(「allow」と「block」のそれぞれ)または 2 つのパターン(1 つは照合され、もう 1 つは代替 URL として使用)が続きます。後方参照は「$1」から始まります。複数の「rewrite」ディレクティブが返される場合があります。同じ URL の場合は、複数の URL が返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: 「off」- リポジトリの取得に使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、「platform」に設定されている場合はプラットフォーム スレッド(OS スレッド)を使用し、「virtual」に設定されている場合は仮想スレッドを使用します。
- その他のカテゴリ(特に分類されていないもの):
--override_repository=<an equals-separated mapping of repository name to path>
件の複数回の使用が累積される- リポジトリは、<repository name>=<path> という形式のローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスがそのまま使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
情報オプション
build からすべてのオプションを継承します。
- コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path>
件の複数回の使用が累積される-
ネットワークにアクセスしてダウンロードする前に、アーカイブを検索できる場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
デフォルト: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュでファイルがコピーされずにハードリンクされます。これはディスク容量を節約することが目的です。
タグ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
のデフォルト: 「0」-
ダウンロード エラーの再試行の最大回数。0 に設定した場合、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: 1.0-
この要素に基づいて、Starlark リポジトリ ルールのすべてのタイムアウトをスケールします。これにより、ソースコードを変更せずに、ルール作成者の期待よりも低速なマシンで外部リポジトリを動作させることができます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
のデフォルト: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: 「0s」-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にした場合、タイムアウトの最大値は定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: 1.0-
HTTP ダウンロードに関連するすべてのタイムアウトを、指定された係数でスケーリングする
タグ:bazel_internal_configuration
--repository_cache=<a path>
デフォルト: 説明を参照-
外部リポジトリの取得中に取得された、ダウンロードした値のキャッシュ ロケーションを指定します。引数として空の文字列は、キャッシュの無効化をリクエストします。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
デフォルト: 「false」-
設定すると、リポジトリの取得中に resourcemanager.download{,_and_extract} を使用してダウンロードできなくなります。ネットワーク アクセスは完全に無効にされているわけではありません。インターネットにアクセスする任意の実行可能ファイルを resourcemanager.execute で実行することは可能です。
タグ:bazel_internal_configuration
- ビルド実行を制御するオプション:
--gc_thrashing_threshold=<an integer in 0-100 range>
のデフォルト: 「100」-
GcThrashingDetector がメモリ プレッシャー イベントを上限(--gc_thrashing_limits)と比較して考慮する、在職期間の占有スペースの割合(0 ~ 100)。100 に設定すると、GcThrashingDetector は無効になります。
タグ:host_machine_resource_optimizations
- Bzlmod の出力とセマンティクスに関連するオプション:
--allow_yanked_versions=<a string>
件の複数回の使用が累積される-
モジュール バージョンを「<module1>@<version1>,<module2>@<version2>」の形式で指定しました。これは、モジュール バージョンが元のレジストリでヤンクされていると宣言されていても(NonRegistryOverride からのものではない場合)、解決済みの依存関係グラフで許可します。そうしないと、バージョンをアンクすると解決が失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可するヤンク バージョンを定義することもできます。このチェックを無効にするには、キーワード「all」を使用します(非推奨)。
タグ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
デフォルト: "error"-
Bazel モジュールの bazel バージョン互換性を確認します。有効な値は、エラーを解決失敗にエスカレーションする場合は「error」、チェックを無効にする場合は「off」、不一致が検出されたときに警告を出力する場合は「warning」です。
タグ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
のデフォルト: 「warning」-
ルート モジュールで宣言されている直接的な「bazel_dep」依存関係が、解決された依存関係グラフで表示されるバージョンと同じかどうかを確認します。有効な値は、チェックを無効にする「off」、不一致が検出されたときに警告を出力する「warning」、解決失敗にエスカレーションする場合は「error」です。
タグ:loading_and_analysis
--[no]ignore_dev_dependency
デフォルト: 「false」-
true の場合、Bazel は、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」を無視します。これらの dev の依存関係は、このフラグの値に関係なく、ルート モジュールでない場合、MODULE.bazel では常に無視されることに注意してください。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: 「update」-
ロックファイルを使用する方法と使用するかどうかを指定します。有効な値は、「update」でロックファイルを使用し、変更がある場合に「error」を指定します。「error」はロックファイルを使用しますが、最新でない場合はエラーをスローします。「off」はロックファイルの読み取りも書き込みも行わない「off」です。
タグ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
件の複数回の使用が累積される- <モジュール名>=<パス> という形式のローカルパスでモジュールをオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。相対パスの場合は、現在の作業ディレクトリからの相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--registry=<a string>
件の複数回の使用が累積される-
Bazel モジュールの依存関係の検索に使用するレジストリを指定します。順序は重要です。モジュールは最初に以前のレジストリで検索され、以前のレジストリからモジュールが見つからなくなった場合にのみ、後のレジストリにフォールバックします。
タグ:changes_inputs
- ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
デフォルト: 「1s:2,20s:3,1m:5」-
上限に達すると GcThrashingDetector が OOM で Bazel をクラッシュさせる上限。各制限は、<period>:<count> の形式で指定します。[期間] は期間、[カウント] は正の整数です。<period> で <count> 回連続してフル GC を実行した後、残存容量(旧世代ヒープ)の --gc_thrashing_threshold パーセントを超える領域が占有されている場合、OOM がトリガーされます。複数の上限を指定する場合は、カンマで区切ってください。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出した場合、完全な GC イベントが発生したときに、不要な一時的な Skyframe の状態を呼び出しごとにこの回数まで破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、完全な GC イベントがドロップをトリガーしないことを意味します。上限に達すると、フル GC イベントが発生して保持されるヒープの割合のしきい値を超えたときに、スカイフレームの状態がドロップされなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出すると、マイナー GC イベントが発生したときに不要な一時的な Skyframe 状態を(呼び出しごとにこの回数まで)破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。上限に達すると、マイナー GC イベントが発生して保持されるヒープの割合のしきい値を超えても、スカイフレームの状態は破棄されなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
のデフォルト: 「85」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。Bazel は、保持されているヒープの割合がこのしきい値以上であることを検出すると、不要な一時的な Skyframe 状態を削除します。これを微調整することで、GC スラッシングが(i)この一時的な状態のメモリ使用量によって発生し、(ii)必要なときに状態の再構築よりもコストが高くなる場合に、GC スラッシングの経過時間への影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
- ロギングの詳細度、形式、場所に影響するオプション:
--[no]experimental_command_profile
デフォルト: 「false」- Java フライト レコーダーの CPU プロファイルを、出力ベース ディレクトリにある profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプや出力形式をサポートするために今後変更される可能性があります。ご自身の責任のもとで使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
デフォルト: 「false」- デフォルトでは、アクション タイプの数は、実行されるアクションの数が最も多い 20 個のニーモニックに限定されています。このオプションを設定すると、すべてのニーモニックの統計情報が書き込まれます。
--[no]show_make_env
デフォルト: 「false」-
出力に「Make」環境を含めます。
タグ:affects_outputs
、terminal_output
- 他のカテゴリに当てはまらない Bazel コマンドへの汎用入力を指定または変更するオプション。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: ""-
空でない場合は、WORKSPACE ファイルではなく、指定された解決済みファイルを読み取ります。
タグ:changes_inputs
- リモート キャッシュと実行オプション:
--experimental_downloader_config=<a string>
デフォルト: 説明を参照- リモート ダウンローダーを構成するファイルを指定します。このファイルは複数の行で構成され、各行はディレクティブ(「allow」、「block」、「rewrite」)で始まり、その後にホスト名(「allow」と「block」のそれぞれ)または 2 つのパターン(1 つは照合され、もう 1 つは代替 URL として使用)が続きます。後方参照は「$1」から始まります。複数の「rewrite」ディレクティブが返される場合があります。同じ URL の場合は、複数の URL が返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: 「off」- リポジトリの取得に使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、「platform」に設定されている場合はプラットフォーム スレッド(OS スレッド)を使用し、「virtual」に設定されている場合は仮想スレッドを使用します。
- その他のカテゴリ(特に分類されていないもの):
--override_repository=<an equals-separated mapping of repository name to path>
件の複数回の使用が累積される- リポジトリは、<repository name>=<path> という形式のローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスがそのまま使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
ライセンス オプション
- コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path>
件の複数回の使用が累積される-
ネットワークにアクセスしてダウンロードする前に、アーカイブを検索できる場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
デフォルト: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュでファイルがコピーされずにハードリンクされます。これはディスク容量を節約することが目的です。
タグ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
のデフォルト: 「0」-
ダウンロード エラーの再試行の最大回数。0 に設定した場合、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: 1.0-
この要素に基づいて、Starlark リポジトリ ルールのすべてのタイムアウトをスケールします。これにより、ソースコードを変更せずに、ルール作成者の期待よりも低速なマシンで外部リポジトリを動作させることができます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
のデフォルト: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: 「0s」-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にした場合、タイムアウトの最大値は定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: 1.0-
HTTP ダウンロードに関連するすべてのタイムアウトを、指定された係数でスケーリングする
タグ:bazel_internal_configuration
--repository_cache=<a path>
デフォルト: 説明を参照-
外部リポジトリの取得中に取得された、ダウンロードした値のキャッシュ ロケーションを指定します。引数として空の文字列は、キャッシュの無効化をリクエストします。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
デフォルト: 「false」-
設定すると、リポジトリの取得中に resourcemanager.download{,_and_extract} を使用してダウンロードできなくなります。ネットワーク アクセスは完全に無効にされているわけではありません。インターネットにアクセスする任意の実行可能ファイルを resourcemanager.execute で実行することは可能です。
タグ:bazel_internal_configuration
- ビルド実行を制御するオプション:
--gc_thrashing_threshold=<an integer in 0-100 range>
のデフォルト: 「100」-
GcThrashingDetector がメモリ プレッシャー イベントを上限(--gc_thrashing_limits)と比較して考慮する、在職期間の占有スペースの割合(0 ~ 100)。100 に設定すると、GcThrashingDetector は無効になります。
タグ:host_machine_resource_optimizations
- Bzlmod の出力とセマンティクスに関連するオプション:
--allow_yanked_versions=<a string>
件の複数回の使用が累積される-
モジュール バージョンを「<module1>@<version1>,<module2>@<version2>」の形式で指定しました。これは、モジュール バージョンが元のレジストリでヤンクされていると宣言されていても(NonRegistryOverride からのものではない場合)、解決済みの依存関係グラフで許可します。そうしないと、バージョンをアンクすると解決が失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可するヤンク バージョンを定義することもできます。このチェックを無効にするには、キーワード「all」を使用します(非推奨)。
タグ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
デフォルト: "error"-
Bazel モジュールの bazel バージョン互換性を確認します。有効な値は、エラーを解決失敗にエスカレーションする場合は「error」、チェックを無効にする場合は「off」、不一致が検出されたときに警告を出力する場合は「warning」です。
タグ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
のデフォルト: 「warning」-
ルート モジュールで宣言されている直接的な「bazel_dep」依存関係が、解決された依存関係グラフで表示されるバージョンと同じかどうかを確認します。有効な値は、チェックを無効にする「off」、不一致が検出されたときに警告を出力する「warning」、解決失敗にエスカレーションする場合は「error」です。
タグ:loading_and_analysis
--[no]ignore_dev_dependency
デフォルト: 「false」-
true の場合、Bazel は、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」を無視します。これらの dev の依存関係は、このフラグの値に関係なく、ルート モジュールでない場合、MODULE.bazel では常に無視されることに注意してください。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: 「update」-
ロックファイルを使用する方法と使用するかどうかを指定します。有効な値は、「update」でロックファイルを使用し、変更がある場合に「error」を指定します。「error」はロックファイルを使用しますが、最新でない場合はエラーをスローします。「off」はロックファイルの読み取りも書き込みも行わない「off」です。
タグ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
件の複数回の使用が累積される- <モジュール名>=<パス> という形式のローカルパスでモジュールをオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。相対パスの場合は、現在の作業ディレクトリからの相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--registry=<a string>
件の複数回の使用が累積される-
Bazel モジュールの依存関係の検索に使用するレジストリを指定します。順序は重要です。モジュールは最初に以前のレジストリで検索され、以前のレジストリからモジュールが見つからなくなった場合にのみ、後のレジストリにフォールバックします。
タグ:changes_inputs
- ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
デフォルト: 「1s:2,20s:3,1m:5」-
上限に達すると GcThrashingDetector が OOM で Bazel をクラッシュさせる上限。各制限は、<period>:<count> の形式で指定します。[期間] は期間、[カウント] は正の整数です。<period> で <count> 回連続してフル GC を実行した後、残存容量(旧世代ヒープ)の --gc_thrashing_threshold パーセントを超える領域が占有されている場合、OOM がトリガーされます。複数の上限を指定する場合は、カンマで区切ってください。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出した場合、完全な GC イベントが発生したときに、不要な一時的な Skyframe の状態を呼び出しごとにこの回数まで破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、完全な GC イベントがドロップをトリガーしないことを意味します。上限に達すると、フル GC イベントが発生して保持されるヒープの割合のしきい値を超えたときに、スカイフレームの状態がドロップされなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出すると、マイナー GC イベントが発生したときに不要な一時的な Skyframe 状態を(呼び出しごとにこの回数まで)破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。上限に達すると、マイナー GC イベントが発生して保持されるヒープの割合のしきい値を超えても、スカイフレームの状態は破棄されなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
のデフォルト: 「85」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。Bazel は、保持されているヒープの割合がこのしきい値以上であることを検出すると、不要な一時的な Skyframe 状態を削除します。これを微調整することで、GC スラッシングが(i)この一時的な状態のメモリ使用量によって発生し、(ii)必要なときに状態の再構築よりもコストが高くなる場合に、GC スラッシングの経過時間への影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
- ロギングの詳細度、形式、場所に影響するオプション:
--[no]experimental_command_profile
デフォルト: 「false」- Java フライト レコーダーの CPU プロファイルを、出力ベース ディレクトリにある profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプや出力形式をサポートするために今後変更される可能性があります。ご自身の責任のもとで使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
デフォルト: 「false」- デフォルトでは、アクション タイプの数は、実行されるアクションの数が最も多い 20 個のニーモニックに限定されています。このオプションを設定すると、すべてのニーモニックの統計情報が書き込まれます。
- 他のカテゴリに当てはまらない Bazel コマンドへの汎用入力を指定または変更するオプション。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: ""-
空でない場合は、WORKSPACE ファイルではなく、指定された解決済みファイルを読み取ります。
タグ:changes_inputs
- リモート キャッシュと実行オプション:
--experimental_downloader_config=<a string>
デフォルト: 説明を参照- リモート ダウンローダーを構成するファイルを指定します。このファイルは複数の行で構成され、各行はディレクティブ(「allow」、「block」、「rewrite」)で始まり、その後にホスト名(「allow」と「block」のそれぞれ)または 2 つのパターン(1 つは照合され、もう 1 つは代替 URL として使用)が続きます。後方参照は「$1」から始まります。複数の「rewrite」ディレクティブが返される場合があります。同じ URL の場合は、複数の URL が返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: 「off」- リポジトリの取得に使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、「platform」に設定されている場合はプラットフォーム スレッド(OS スレッド)を使用し、「virtual」に設定されている場合は仮想スレッドを使用します。
- その他のカテゴリ(特に分類されていないもの):
--override_repository=<an equals-separated mapping of repository name to path>
件の複数回の使用が累積される- リポジトリは、<repository name>=<path> という形式のローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスがそのまま使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
モバイル インストール オプション
build からすべてのオプションを継承します。
- コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path>
件の複数回の使用が累積される-
ネットワークにアクセスしてダウンロードする前に、アーカイブを検索できる場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
デフォルト: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュでファイルがコピーされずにハードリンクされます。これはディスク容量を節約することが目的です。
タグ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
のデフォルト: 「0」-
ダウンロード エラーの再試行の最大回数。0 に設定した場合、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: 1.0-
この要素に基づいて、Starlark リポジトリ ルールのすべてのタイムアウトをスケールします。これにより、ソースコードを変更せずに、ルール作成者の期待よりも低速なマシンで外部リポジトリを動作させることができます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
のデフォルト: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: 「0s」-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にした場合、タイムアウトの最大値は定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: 1.0-
HTTP ダウンロードに関連するすべてのタイムアウトを、指定された係数でスケーリングする
タグ:bazel_internal_configuration
--repository_cache=<a path>
デフォルト: 説明を参照-
外部リポジトリの取得中に取得された、ダウンロードした値のキャッシュ ロケーションを指定します。引数として空の文字列は、キャッシュの無効化をリクエストします。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
デフォルト: 「false」-
設定すると、リポジトリの取得中に resourcemanager.download{,_and_extract} を使用してダウンロードできなくなります。ネットワーク アクセスは完全に無効にされているわけではありません。インターネットにアクセスする任意の実行可能ファイルを resourcemanager.execute で実行することは可能です。
タグ:bazel_internal_configuration
- ビルド実行を制御するオプション:
--gc_thrashing_threshold=<an integer in 0-100 range>
のデフォルト: 「100」-
GcThrashingDetector がメモリ プレッシャー イベントを上限(--gc_thrashing_limits)と比較して考慮する、在職期間の占有スペースの割合(0 ~ 100)。100 に設定すると、GcThrashingDetector は無効になります。
タグ:host_machine_resource_optimizations
--mode=<classic, classic_internal_test_do_not_use or skylark>
のデフォルト: 「classic」-
モバイル インストールの実行方法を選択してください。「classic」はモバイル インストールの現在のバージョンを実行します。「skylark」は android_test をサポートする新しいバージョンの Starlark を使用します。
タグ:loading_and_analysis
、execution
、incompatible_change
- アクションの実行に使用するツールチェーンを構成するオプション:
--adb=<a string>
のデフォルト: ""-
「mobile-install」コマンドで使用する adb バイナリ。指定しない場合は、--android_sdk コマンドライン オプションで指定された Android SDK 内の SDK(--android_sdk が指定されていない場合はデフォルトの SDK)が使用されます。
タグ:changes_inputs
- コマンドの出力を制御するオプション:
--[no]incremental
デフォルト: 「false」-
増分インストールを行うかどうか。true の場合、コードをインストールするデバイスの状態を読み取り、その情報を使用して不要な作業を回避することで、不要な追加作業を回避してください。false(デフォルト)の場合、常にフルインストールを実行します。
タグ:loading_and_analysis
--[no]split_apks
デフォルト: 「false」-
デバイス上でのアプリのインストールと更新に、分割 APK を使用するかどうかを指定します。Marshmallow 以降を搭載したデバイスでのみ動作します。
タグ:loading_and_analysis
、affects_outputs
- 目的の出力をユーザーが設定できるようにするオプション(その存在ではなく、その値に影響するオプション):
--adb_arg=<a string>
件の複数回の使用が累積される- adb に渡す追加の引数。通常はインストール先のデバイスを指定するために使用されます。
タグ:action_command_lines
--debug_app
-
アプリを起動する前にデバッガを待つかどうかを指定します。
次のように展開します。
--start=DEBUG
タグ:execution
--device=<a string>
のデフォルト: ""-
adb デバイスのシリアル番号。指定しない場合、最初のデバイスが使用されます。
タグ:action_command_lines
--start=<no, cold, warm or debug>
のデフォルト: 「NO」-
インストール後にアプリを起動する方法。増分インストール時にアプリの状態を保持、復元するには、WARM に設定します。
タグ:execution
--start_app
-
アプリをインストールした後にアプリを起動するかどうかを指定します。
次のように展開:
--start=COLD
タグ:execution
- Bzlmod の出力とセマンティクスに関連するオプション:
--allow_yanked_versions=<a string>
件の複数回の使用が累積される-
モジュール バージョンを「<module1>@<version1>,<module2>@<version2>」の形式で指定しました。これは、モジュール バージョンが元のレジストリでヤンクされていると宣言されていても(NonRegistryOverride からのものではない場合)、解決済みの依存関係グラフで許可します。そうしないと、バージョンをアンクすると解決が失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可するヤンク バージョンを定義することもできます。このチェックを無効にするには、キーワード「all」を使用します(非推奨)。
タグ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
デフォルト: "error"-
Bazel モジュールの bazel バージョン互換性を確認します。有効な値は、エラーを解決失敗にエスカレーションする場合は「error」、チェックを無効にする場合は「off」、不一致が検出されたときに警告を出力する場合は「warning」です。
タグ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
のデフォルト: 「warning」-
ルート モジュールで宣言されている直接的な「bazel_dep」依存関係が、解決された依存関係グラフで表示されるバージョンと同じかどうかを確認します。有効な値は、チェックを無効にする「off」、不一致が検出されたときに警告を出力する「warning」、解決失敗にエスカレーションする場合は「error」です。
タグ:loading_and_analysis
--[no]ignore_dev_dependency
デフォルト: 「false」-
true の場合、Bazel は、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」を無視します。これらの dev の依存関係は、このフラグの値に関係なく、ルート モジュールでない場合、MODULE.bazel では常に無視されることに注意してください。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: 「update」-
ロックファイルを使用する方法と使用するかどうかを指定します。有効な値は、「update」でロックファイルを使用し、変更がある場合に「error」を指定します。「error」はロックファイルを使用しますが、最新でない場合はエラーをスローします。「off」はロックファイルの読み取りも書き込みも行わない「off」です。
タグ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
件の複数回の使用が累積される- <モジュール名>=<パス> という形式のローカルパスでモジュールをオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。相対パスの場合は、現在の作業ディレクトリからの相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--registry=<a string>
件の複数回の使用が累積される-
Bazel モジュールの依存関係の検索に使用するレジストリを指定します。順序は重要です。モジュールは最初に以前のレジストリで検索され、以前のレジストリからモジュールが見つからなくなった場合にのみ、後のレジストリにフォールバックします。
タグ:changes_inputs
- ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
デフォルト: 「1s:2,20s:3,1m:5」-
上限に達すると GcThrashingDetector が OOM で Bazel をクラッシュさせる上限。各制限は、<period>:<count> の形式で指定します。[期間] は期間、[カウント] は正の整数です。<period> で <count> 回連続してフル GC を実行した後、残存容量(旧世代ヒープ)の --gc_thrashing_threshold パーセントを超える領域が占有されている場合、OOM がトリガーされます。複数の上限を指定する場合は、カンマで区切ってください。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出した場合、完全な GC イベントが発生したときに、不要な一時的な Skyframe の状態を呼び出しごとにこの回数まで破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、完全な GC イベントがドロップをトリガーしないことを意味します。上限に達すると、フル GC イベントが発生して保持されるヒープの割合のしきい値を超えたときに、スカイフレームの状態がドロップされなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出すると、マイナー GC イベントが発生したときに不要な一時的な Skyframe 状態を(呼び出しごとにこの回数まで)破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。上限に達すると、マイナー GC イベントが発生して保持されるヒープの割合のしきい値を超えても、スカイフレームの状態は破棄されなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
のデフォルト: 「85」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。Bazel は、保持されているヒープの割合がこのしきい値以上であることを検出すると、不要な一時的な Skyframe 状態を削除します。これを微調整することで、GC スラッシングが(i)この一時的な状態のメモリ使用量によって発生し、(ii)必要なときに状態の再構築よりもコストが高くなる場合に、GC スラッシングの経過時間への影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
- ロギングの詳細度、形式、場所に影響するオプション:
--[no]experimental_command_profile
デフォルト: 「false」- Java フライト レコーダーの CPU プロファイルを、出力ベース ディレクトリにある profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプや出力形式をサポートするために今後変更される可能性があります。ご自身の責任のもとで使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
デフォルト: 「false」- デフォルトでは、アクション タイプの数は、実行されるアクションの数が最も多い 20 個のニーモニックに限定されています。このオプションを設定すると、すべてのニーモニックの統計情報が書き込まれます。
--incremental_install_verbosity=<a string>
のデフォルト: ""-
増分インストールの詳細。デバッグ ロギングの場合は 1 に設定します。
タグ:bazel_monitoring
- 他のカテゴリに当てはまらない Bazel コマンドへの汎用入力を指定または変更するオプション。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: ""-
空でない場合は、WORKSPACE ファイルではなく、指定された解決済みファイルを読み取ります。
タグ:changes_inputs
- リモート キャッシュと実行オプション:
--experimental_downloader_config=<a string>
デフォルト: 説明を参照- リモート ダウンローダーを構成するファイルを指定します。このファイルは複数の行で構成され、各行はディレクティブ(「allow」、「block」、「rewrite」)で始まり、その後にホスト名(「allow」と「block」のそれぞれ)または 2 つのパターン(1 つは照合され、もう 1 つは代替 URL として使用)が続きます。後方参照は「$1」から始まります。複数の「rewrite」ディレクティブが返される場合があります。同じ URL の場合は、複数の URL が返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: 「off」- リポジトリの取得に使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、「platform」に設定されている場合はプラットフォーム スレッド(OS スレッド)を使用し、「virtual」に設定されている場合は仮想スレッドを使用します。
- その他のカテゴリ(特に分類されていないもの):
--override_repository=<an equals-separated mapping of repository name to path>
件の複数回の使用が累積される- リポジトリは、<repository name>=<path> という形式のローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスがそのまま使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
MOD オプション
- コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path>
件の複数回の使用が累積される-
ネットワークにアクセスしてダウンロードする前に、アーカイブを検索できる場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
デフォルト: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュでファイルがコピーされずにハードリンクされます。これはディスク容量を節約することが目的です。
タグ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
のデフォルト: 「0」-
ダウンロード エラーの再試行の最大回数。0 に設定した場合、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: 1.0-
この要素に基づいて、Starlark リポジトリ ルールのすべてのタイムアウトをスケールします。これにより、ソースコードを変更せずに、ルール作成者の期待よりも低速なマシンで外部リポジトリを動作させることができます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
のデフォルト: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: 「0s」-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にした場合、タイムアウトの最大値は定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: 1.0-
HTTP ダウンロードに関連するすべてのタイムアウトを、指定された係数でスケーリングする
タグ:bazel_internal_configuration
--repository_cache=<a path>
デフォルト: 説明を参照-
外部リポジトリの取得中に取得された、ダウンロードした値のキャッシュ ロケーションを指定します。引数として空の文字列は、キャッシュの無効化をリクエストします。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
デフォルト: 「false」-
設定すると、リポジトリの取得中に resourcemanager.download{,_and_extract} を使用してダウンロードできなくなります。ネットワーク アクセスは完全に無効にされているわけではありません。インターネットにアクセスする任意の実行可能ファイルを resourcemanager.execute で実行することは可能です。
タグ:bazel_internal_configuration
- ビルド実行を制御するオプション:
--gc_thrashing_threshold=<an integer in 0-100 range>
のデフォルト: 「100」-
GcThrashingDetector がメモリ プレッシャー イベントを上限(--gc_thrashing_limits)と比較して考慮する、在職期間の占有スペースの割合(0 ~ 100)。100 に設定すると、GcThrashingDetector は無効になります。
タグ:host_machine_resource_optimizations
--[no]keep_going
[-k
] default: "false"-
エラー発生後は、できるだけ続行してください。失敗したターゲットとそれに依存するターゲットは分析できませんが、これらのターゲットの他の前提条件は分析できます。
タグ:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
のデフォルト: "auto"-
読み込み/分析フェーズに使用する並列スレッドの数。整数またはキーワード("auto"、"HOST_CPUS"、"HOST_RAM")を受け取ります。その後に必要に応じて演算([-|*]<float>)が続きます。例:"auto"、"HOST_CPUS*.5" となります。「auto」は、ホストリソースに基づいて妥当なデフォルトを設定します。1 以上の値を指定してください。
タグ:bazel_internal_configuration
- このオプションは、BUILD ファイル、.bzl ファイル、WORKSPACE ファイルからアクセス可能な Starlark 言語または Build API のセマンティクスに影響します。
--[no]incompatible_config_setting_private_default_visibility
デフォルト: 「false」-
compatible_enforce_config_setting_visibility=false の場合、何も追加されません。このフラグが false の場合、明示的な可視性属性のない config_setting は //visibility:public です。このフラグが true の場合、config_setting は他のすべてのルールと同じ可視性ロジックに従います。https://github.com/bazelbuild/bazel/issues/12933 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_enforce_config_setting_visibility
のデフォルト: 「true」-
true の場合、config_setting 公開設定の制限を適用します。false の場合、すべての config_setting がすべてのターゲットに表示されます。https://github.com/bazelbuild/bazel/issues/12932 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
- 「mod」サブコマンドの出力とセマンティクスに関連するオプション:
--base_module=<"<root>" for the root module; <module>@<version> for a specific version of a module; <module> for all versions of a module; @<name> for a repo with the given apparent name; or @@<name> for a repo with the given canonical name>
デフォルト: "<root>"-
指定したターゲット リポジトリが解釈される相対モジュールを指定します。
タグ:terminal_output
--charset=<utf8 or ascii>
のデフォルト: "utf8"-
ツリーに使用する文字セットを選択します。テキスト出力にのみ影響します。有効な値は「utf8」または「ascii」です。デフォルトは utf8 です。
タグ:terminal_output
--[no]cycles
デフォルト: 「false」-
表示されるツリー内の依存関係サイクルを示しますが、通常、デフォルトでは無視されます。
タグ:terminal_output
--depth=<an integer>
デフォルト: 「-1」-
依存関係ツリーの最大表示深度。たとえば、深度が 1 の場合、直接的な依存関係が表示されます。tree、path、all_paths の場合、デフォルトで Integer.MAX_VALUE になり、deps と Explain のデフォルトが 1 になります(ターゲットのリーフとその親のほかに、ルートの直接の依存関係のみが表示されます)。
タグ:terminal_output
--extension_filter=<a comma-separated list of <extension>s>
デフォルト: 説明を参照-
これらのモジュール拡張機能の使用状況と、それらによって生成されたリポジトリのみを表示します(対応するフラグが設定されている場合)。設定すると、結果グラフには指定した拡張機能を使用するモジュールを含むパスのみが含まれます。空のリストを指定するとフィルタが無効になり、使用可能なすべての拡張機能が実質的に指定されます。
タグ:terminal_output
--extension_info=<hidden, usages, repos or all>
のデフォルト: 「非表示」-
クエリ結果に含める拡張機能の使用状況に関する詳細を指定します。[Usages] には拡張機能の名前のみが表示され、[repos] には use_repo でインポートされたリポジトリも含まれます。[all] には、拡張機能によって生成された他のリポジトリも表示されます。
タグ:terminal_output
--extension_usages=<a comma-separated list of <module>s>
のデフォルト: ""-
show_extension クエリに拡張機能の使用状況を表示するモジュールを指定します。
タグ:terminal_output
--from=<a comma-separated list of <module>s>
デフォルト: "<root>"-
依存関係グラフのクエリが表示される最初のモジュール。正確なセマンティクスについては、各クエリの説明を確認してください。デフォルトは <root> です。
タグ:terminal_output
--[no]include_builtin
デフォルト: 「false」-
依存関係グラフに組み込みモジュールを含めます。ノイズが多いため、デフォルトで無効になっています。
タグ:terminal_output
--[no]include_unused
デフォルト: 「false」-
クエリは、(最小バージョンの選択またはオーバーライド ルールにより)選択後にモジュール解決グラフに存在しない未使用のモジュールも考慮して表示します。クエリの種類ごとに異なる効果があります(all_paths コマンドに新しいパスを追加する、Explain コマンドに別の依存先を追加するなど)。
タグ:terminal_output
--output=<text, json or graph>
のデフォルト: "text"-
クエリ結果の形式。クエリで使用できる値は、テキスト、JSON、グラフです。
タグ:terminal_output
--[no]verbose
デフォルト: 「false」-
クエリには、モジュールが現在のバージョンに解決された理由(変更されている場合)も表示されます。デフォルトは、Explain クエリの場合のみ true です。
タグ:terminal_output
- Bzlmod の出力とセマンティクスに関連するオプション:
--allow_yanked_versions=<a string>
件の複数回の使用が累積される-
モジュール バージョンを「<module1>@<version1>,<module2>@<version2>」の形式で指定しました。これは、モジュール バージョンが元のレジストリでヤンクされていると宣言されていても(NonRegistryOverride からのものではない場合)、解決済みの依存関係グラフで許可します。そうしないと、バージョンをアンクすると解決が失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可するヤンク バージョンを定義することもできます。このチェックを無効にするには、キーワード「all」を使用します(非推奨)。
タグ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
デフォルト: "error"-
Bazel モジュールの bazel バージョン互換性を確認します。有効な値は、エラーを解決失敗にエスカレーションする場合は「error」、チェックを無効にする場合は「off」、不一致が検出されたときに警告を出力する場合は「warning」です。
タグ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
のデフォルト: 「warning」-
ルート モジュールで宣言されている直接的な「bazel_dep」依存関係が、解決された依存関係グラフで表示されるバージョンと同じかどうかを確認します。有効な値は、チェックを無効にする「off」、不一致が検出されたときに警告を出力する「warning」、解決失敗にエスカレーションする場合は「error」です。
タグ:loading_and_analysis
--[no]ignore_dev_dependency
デフォルト: 「false」-
true の場合、Bazel は、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」を無視します。これらの dev の依存関係は、このフラグの値に関係なく、ルート モジュールでない場合、MODULE.bazel では常に無視されることに注意してください。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: 「update」-
ロックファイルを使用する方法と使用するかどうかを指定します。有効な値は、「update」でロックファイルを使用し、変更がある場合に「error」を指定します。「error」はロックファイルを使用しますが、最新でない場合はエラーをスローします。「off」はロックファイルの読み取りも書き込みも行わない「off」です。
タグ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
件の複数回の使用が累積される- <モジュール名>=<パス> という形式のローカルパスでモジュールをオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。相対パスの場合は、現在の作業ディレクトリからの相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--registry=<a string>
件の複数回の使用が累積される-
Bazel モジュールの依存関係の検索に使用するレジストリを指定します。順序は重要です。モジュールは最初に以前のレジストリで検索され、以前のレジストリからモジュールが見つからなくなった場合にのみ、後のレジストリにフォールバックします。
タグ:changes_inputs
- ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
デフォルト: 「1s:2,20s:3,1m:5」-
上限に達すると GcThrashingDetector が OOM で Bazel をクラッシュさせる上限。各制限は、<period>:<count> の形式で指定します。[期間] は期間、[カウント] は正の整数です。<period> で <count> 回連続してフル GC を実行した後、残存容量(旧世代ヒープ)の --gc_thrashing_threshold パーセントを超える領域が占有されている場合、OOM がトリガーされます。複数の上限を指定する場合は、カンマで区切ってください。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出した場合、完全な GC イベントが発生したときに、不要な一時的な Skyframe の状態を呼び出しごとにこの回数まで破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、完全な GC イベントがドロップをトリガーしないことを意味します。上限に達すると、フル GC イベントが発生して保持されるヒープの割合のしきい値を超えたときに、スカイフレームの状態がドロップされなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出すると、マイナー GC イベントが発生したときに不要な一時的な Skyframe 状態を(呼び出しごとにこの回数まで)破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。上限に達すると、マイナー GC イベントが発生して保持されるヒープの割合のしきい値を超えても、スカイフレームの状態は破棄されなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
のデフォルト: 「85」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。Bazel は、保持されているヒープの割合がこのしきい値以上であることを検出すると、不要な一時的な Skyframe 状態を削除します。これを微調整することで、GC スラッシングが(i)この一時的な状態のメモリ使用量によって発生し、(ii)必要なときに状態の再構築よりもコストが高くなる場合に、GC スラッシングの経過時間への影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
- ロギングの詳細度、形式、場所に影響するオプション:
--[no]experimental_command_profile
デフォルト: 「false」- Java フライト レコーダーの CPU プロファイルを、出力ベース ディレクトリにある profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプや出力形式をサポートするために今後変更される可能性があります。ご自身の責任のもとで使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
デフォルト: 「false」- デフォルトでは、アクション タイプの数は、実行されるアクションの数が最も多い 20 個のニーモニックに限定されています。このオプションを設定すると、すべてのニーモニックの統計情報が書き込まれます。
- 他のカテゴリに当てはまらない Bazel コマンドへの汎用入力を指定または変更するオプション。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: ""-
空でない場合は、WORKSPACE ファイルではなく、指定された解決済みファイルを読み取ります。
タグ:changes_inputs
- リモート キャッシュと実行オプション:
--experimental_downloader_config=<a string>
デフォルト: 説明を参照- リモート ダウンローダーを構成するファイルを指定します。このファイルは複数の行で構成され、各行はディレクティブ(「allow」、「block」、「rewrite」)で始まり、その後にホスト名(「allow」と「block」のそれぞれ)または 2 つのパターン(1 つは照合され、もう 1 つは代替 URL として使用)が続きます。後方参照は「$1」から始まります。複数の「rewrite」ディレクティブが返される場合があります。同じ URL の場合は、複数の URL が返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: 「off」- リポジトリの取得に使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、「platform」に設定されている場合はプラットフォーム スレッド(OS スレッド)を使用し、「virtual」に設定されている場合は仮想スレッドを使用します。
- その他のカテゴリ(特に分類されていないもの):
--deleted_packages=<comma-separated list of package names>
件の複数回の使用が累積される- パッケージ名のカンマ区切りリスト。パッケージパス上のどこかに表示されていても、ビルドシステムによって存在しないと判断されます。 既存のパッケージ「x」のサブパッケージ「x/y」を削除する場合は、このオプションを使用します。たとえば、クライアントで x/y/BUILD を削除した後、別の package_path エントリによってラベル「//x:y/z」が見つかると、ビルドシステムからエラーが発生することがあります。--deleted_packages x/y を指定すると、この問題を回避できます。
--override_repository=<an equals-separated mapping of repository name to path>
件の複数回の使用が累積される- リポジトリは、<repository name>=<path> という形式のローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスがそのまま使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--package_path=<colon-separated list of options>
のデフォルト: 「%workspace%」- パッケージを検索する場所をコロンで区切ったリスト。「%workspace%」で始まる要素は、それを含むワークスペースからの相対値です。省略するか空の場合、デフォルトは「bazel info default-package-path」の出力です。
--[no]show_loading_progress
のデフォルト: 「true」- 有効にすると、Bazel から「Loading package:」というメッセージが表示されます。
print_action オプション
build からすべてのオプションを継承します。
- コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path>
件の複数回の使用が累積される-
ネットワークにアクセスしてダウンロードする前に、アーカイブを検索できる場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
デフォルト: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュでファイルがコピーされずにハードリンクされます。これはディスク容量を節約することが目的です。
タグ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
のデフォルト: 「0」-
ダウンロード エラーの再試行の最大回数。0 に設定した場合、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: 1.0-
この要素に基づいて、Starlark リポジトリ ルールのすべてのタイムアウトをスケールします。これにより、ソースコードを変更せずに、ルール作成者の期待よりも低速なマシンで外部リポジトリを動作させることができます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
のデフォルト: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: 「0s」-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にした場合、タイムアウトの最大値は定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: 1.0-
HTTP ダウンロードに関連するすべてのタイムアウトを、指定された係数でスケーリングする
タグ:bazel_internal_configuration
--repository_cache=<a path>
デフォルト: 説明を参照-
外部リポジトリの取得中に取得された、ダウンロードした値のキャッシュ ロケーションを指定します。引数として空の文字列は、キャッシュの無効化をリクエストします。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
デフォルト: 「false」-
設定すると、リポジトリの取得中に resourcemanager.download{,_and_extract} を使用してダウンロードできなくなります。ネットワーク アクセスは完全に無効にされているわけではありません。インターネットにアクセスする任意の実行可能ファイルを resourcemanager.execute で実行することは可能です。
タグ:bazel_internal_configuration
- ビルド実行を制御するオプション:
--gc_thrashing_threshold=<an integer in 0-100 range>
のデフォルト: 「100」-
GcThrashingDetector がメモリ プレッシャー イベントを上限(--gc_thrashing_limits)と比較して考慮する、在職期間の占有スペースの割合(0 ~ 100)。100 に設定すると、GcThrashingDetector は無効になります。
タグ:host_machine_resource_optimizations
- Bzlmod の出力とセマンティクスに関連するオプション:
--allow_yanked_versions=<a string>
件の複数回の使用が累積される-
モジュール バージョンを「<module1>@<version1>,<module2>@<version2>」の形式で指定しました。これは、モジュール バージョンが元のレジストリでヤンクされていると宣言されていても(NonRegistryOverride からのものではない場合)、解決済みの依存関係グラフで許可します。そうしないと、バージョンをアンクすると解決が失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可するヤンク バージョンを定義することもできます。このチェックを無効にするには、キーワード「all」を使用します(非推奨)。
タグ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
デフォルト: "error"-
Bazel モジュールの bazel バージョン互換性を確認します。有効な値は、エラーを解決失敗にエスカレーションする場合は「error」、チェックを無効にする場合は「off」、不一致が検出されたときに警告を出力する場合は「warning」です。
タグ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
のデフォルト: 「warning」-
ルート モジュールで宣言されている直接的な「bazel_dep」依存関係が、解決された依存関係グラフで表示されるバージョンと同じかどうかを確認します。有効な値は、チェックを無効にする「off」、不一致が検出されたときに警告を出力する「warning」、解決失敗にエスカレーションする場合は「error」です。
タグ:loading_and_analysis
--[no]ignore_dev_dependency
デフォルト: 「false」-
true の場合、Bazel は、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」を無視します。これらの dev の依存関係は、このフラグの値に関係なく、ルート モジュールでない場合、MODULE.bazel では常に無視されることに注意してください。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: 「update」-
ロックファイルを使用する方法と使用するかどうかを指定します。有効な値は、「update」でロックファイルを使用し、変更がある場合に「error」を指定します。「error」はロックファイルを使用しますが、最新でない場合はエラーをスローします。「off」はロックファイルの読み取りも書き込みも行わない「off」です。
タグ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
件の複数回の使用が累積される- <モジュール名>=<パス> という形式のローカルパスでモジュールをオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。相対パスの場合は、現在の作業ディレクトリからの相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--registry=<a string>
件の複数回の使用が累積される-
Bazel モジュールの依存関係の検索に使用するレジストリを指定します。順序は重要です。モジュールは最初に以前のレジストリで検索され、以前のレジストリからモジュールが見つからなくなった場合にのみ、後のレジストリにフォールバックします。
タグ:changes_inputs
- ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
デフォルト: 「1s:2,20s:3,1m:5」-
上限に達すると GcThrashingDetector が OOM で Bazel をクラッシュさせる上限。各制限は、<period>:<count> の形式で指定します。[期間] は期間、[カウント] は正の整数です。<period> で <count> 回連続してフル GC を実行した後、残存容量(旧世代ヒープ)の --gc_thrashing_threshold パーセントを超える領域が占有されている場合、OOM がトリガーされます。複数の上限を指定する場合は、カンマで区切ってください。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出した場合、完全な GC イベントが発生したときに、不要な一時的な Skyframe の状態を呼び出しごとにこの回数まで破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、完全な GC イベントがドロップをトリガーしないことを意味します。上限に達すると、フル GC イベントが発生して保持されるヒープの割合のしきい値を超えたときに、スカイフレームの状態がドロップされなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出すると、マイナー GC イベントが発生したときに不要な一時的な Skyframe 状態を(呼び出しごとにこの回数まで)破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。上限に達すると、マイナー GC イベントが発生して保持されるヒープの割合のしきい値を超えても、スカイフレームの状態は破棄されなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
のデフォルト: 「85」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。Bazel は、保持されているヒープの割合がこのしきい値以上であることを検出すると、不要な一時的な Skyframe 状態を削除します。これを微調整することで、GC スラッシングが(i)この一時的な状態のメモリ使用量によって発生し、(ii)必要なときに状態の再構築よりもコストが高くなる場合に、GC スラッシングの経過時間への影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
- ロギングの詳細度、形式、場所に影響するオプション:
--[no]experimental_command_profile
デフォルト: 「false」- Java フライト レコーダーの CPU プロファイルを、出力ベース ディレクトリにある profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプや出力形式をサポートするために今後変更される可能性があります。ご自身の責任のもとで使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
デフォルト: 「false」- デフォルトでは、アクション タイプの数は、実行されるアクションの数が最も多い 20 個のニーモニックに限定されています。このオプションを設定すると、すべてのニーモニックの統計情報が書き込まれます。
- 他のカテゴリに当てはまらない Bazel コマンドへの汎用入力を指定または変更するオプション。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: ""-
空でない場合は、WORKSPACE ファイルではなく、指定された解決済みファイルを読み取ります。
タグ:changes_inputs
- リモート キャッシュと実行オプション:
--experimental_downloader_config=<a string>
デフォルト: 説明を参照- リモート ダウンローダーを構成するファイルを指定します。このファイルは複数の行で構成され、各行はディレクティブ(「allow」、「block」、「rewrite」)で始まり、その後にホスト名(「allow」と「block」のそれぞれ)または 2 つのパターン(1 つは照合され、もう 1 つは代替 URL として使用)が続きます。後方参照は「$1」から始まります。複数の「rewrite」ディレクティブが返される場合があります。同じ URL の場合は、複数の URL が返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: 「off」- リポジトリの取得に使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、「platform」に設定されている場合はプラットフォーム スレッド(OS スレッド)を使用し、「virtual」に設定されている場合は仮想スレッドを使用します。
- その他のカテゴリ(特に分類されていないもの):
--override_repository=<an equals-separated mapping of repository name to path>
件の複数回の使用が累積される- リポジトリは、<repository name>=<path> という形式のローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスがそのまま使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--print_action_mnemonics=<a string>
件の複数回の使用が累積される- print_action データをフィルタするニーモニックをリストします。空のままにすると、フィルタリングは行われません。
クエリ オプション
- コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path>
件の複数回の使用が累積される-
ネットワークにアクセスしてダウンロードする前に、アーカイブを検索できる場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
デフォルト: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュでファイルがコピーされずにハードリンクされます。これはディスク容量を節約することが目的です。
タグ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
のデフォルト: 「0」-
ダウンロード エラーの再試行の最大回数。0 に設定した場合、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: 1.0-
この要素に基づいて、Starlark リポジトリ ルールのすべてのタイムアウトをスケールします。これにより、ソースコードを変更せずに、ルール作成者の期待よりも低速なマシンで外部リポジトリを動作させることができます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
のデフォルト: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: 「0s」-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にした場合、タイムアウトの最大値は定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: 1.0-
HTTP ダウンロードに関連するすべてのタイムアウトを、指定された係数でスケーリングする
タグ:bazel_internal_configuration
--repository_cache=<a path>
デフォルト: 説明を参照-
外部リポジトリの取得中に取得された、ダウンロードした値のキャッシュ ロケーションを指定します。引数として空の文字列は、キャッシュの無効化をリクエストします。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
デフォルト: 「false」-
設定すると、リポジトリの取得中に resourcemanager.download{,_and_extract} を使用してダウンロードできなくなります。ネットワーク アクセスは完全に無効にされているわけではありません。インターネットにアクセスする任意の実行可能ファイルを resourcemanager.execute で実行することは可能です。
タグ:bazel_internal_configuration
- ビルド実行を制御するオプション:
--gc_thrashing_threshold=<an integer in 0-100 range>
のデフォルト: 「100」-
GcThrashingDetector がメモリ プレッシャー イベントを上限(--gc_thrashing_limits)と比較して考慮する、在職期間の占有スペースの割合(0 ~ 100)。100 に設定すると、GcThrashingDetector は無効になります。
タグ:host_machine_resource_optimizations
--[no]keep_going
[-k
] default: "false"-
エラー発生後は、できるだけ続行してください。失敗したターゲットとそれに依存するターゲットは分析できませんが、これらのターゲットの他の前提条件は分析できます。
タグ:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
のデフォルト: "auto"-
読み込み/分析フェーズに使用する並列スレッドの数。整数またはキーワード("auto"、"HOST_CPUS"、"HOST_RAM")を受け取ります。その後に必要に応じて演算([-|*]<float>)が続きます。例:"auto"、"HOST_CPUS*.5" となります。「auto」は、ホストリソースに基づいて妥当なデフォルトを設定します。1 以上の値を指定してください。
タグ:bazel_internal_configuration
- このオプションは、BUILD ファイル、.bzl ファイル、WORKSPACE ファイルからアクセス可能な Starlark 言語または Build API のセマンティクスに影響します。
--[no]incompatible_config_setting_private_default_visibility
デフォルト: 「false」-
compatible_enforce_config_setting_visibility=false の場合、何も追加されません。このフラグが false の場合、明示的な可視性属性のない config_setting は //visibility:public です。このフラグが true の場合、config_setting は他のすべてのルールと同じ可視性ロジックに従います。https://github.com/bazelbuild/bazel/issues/12933 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_enforce_config_setting_visibility
のデフォルト: 「true」-
true の場合、config_setting 公開設定の制限を適用します。false の場合、すべての config_setting がすべてのターゲットに表示されます。https://github.com/bazelbuild/bazel/issues/12932 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
- クエリの出力とセマンティクスに関連するオプション:
--aspect_deps=<off, conservative or precise>
のデフォルト: "conservative"-
出力形式が {xml,proto,record} のいずれかの場合に、アスペクトの依存関係を解決する方法。「off」は、アスペクトの依存関係が解決されないことを意味します。「conservative」(デフォルト)は、宣言されたすべてのアスペクト依存関係が、直接的な依存関係のルールクラスが与えられるかどうかにかかわらず、追加されることを意味します。「正確」は、直接的な依存関係のルールクラスが与えられている可能性のあるアスペクトのみが追加されることを意味します。高精度モードでは、1 つのターゲットを評価するために他のパッケージを読み込む必要があるため、他のモードよりも遅くなります。また、精密モードであっても完全に正確というわけではありません。アスペクトを計算するかどうかは、分析フェーズで決定され、bazel クエリでは実行されません。
タグ:build_file_semantics
--[no]consistent_labels
デフォルト: 「false」-
有効にすると、すべてのクエリコマンドは、<code>Label</code> インスタンスに適用された Starlark <code>str</code> 関数であるかのようにラベルを出力します。これは、さまざまなクエリ コマンドの出力やルールによって発行されたラベルを照合する必要があるツールに便利です。有効になっていない場合、出力フォーマッタは、出力を読みやすくするために、明らかなリポジトリ名(メイン リポジトリからの相対名)を自由に出力できます。
タグ:terminal_output
--[no]experimental_graphless_query
のデフォルト: "auto"-
true の場合、グラフのコピーを作成しないクエリ実装を使用します。新しい実装では、--order_output=no と、出力フォーマッタのサブセットのみがサポートされます。
タグ:build_file_semantics
、eagerness_to_exit
--graph:conditional_edges_limit=<an integer>
のデフォルト: 「4」-
表示する条件ラベルの最大数。-1 は切り捨てなし、0 はアノテーションなしを意味します。このオプションは --output=graph にのみ適用されます。
タグ:terminal_output
--[no]graph:factored
のデフォルト: 「true」-
true の場合、グラフは「因数分解された」状態で出力されます。つまり、トポロジ的に同等のノードがマージされ、それらのラベルが連結されます。このオプションは --output=graph にのみ適用されます。
タグ:terminal_output
--graph:node_limit=<an integer>
のデフォルト: 「512」-
出力内のグラフノードのラベル文字列の最大長。長いラベルは切り捨てられます。-1 を指定すると、切り捨てられません。このオプションは --output=graph にのみ適用されます。
タグ:terminal_output
--[no]implicit_deps
のデフォルト: 「true」-
有効にすると、クエリが実行される依存関係グラフに暗黙的な依存関係が含まれます。暗黙的な依存関係とは、BUILD ファイルで明示的に指定されていないものの、bazel によって追加された依存関係のことです。cquery の場合、解決されたツールチェーンのフィルタリングを制御します。
タグ:build_file_semantics
--[no]include_aspects
のデフォルト: 「true」-
aquery、cquery: アスペクトによって生成されたアクションを出力に含めるかどうか。query: no-op(アスペクトは常に追跡されます)。
タグ:terminal_output
--[no]incompatible_lexicographical_output
のデフォルト: 「true」-
このオプションを設定すると、--order_output=auto 出力を辞書順で並べ替えます。
タグ:terminal_output
、incompatible_change
--[no]incompatible_package_group_includes_double_slash
のデフォルト: 「true」-
有効にすると、package_group の「packages」属性を出力するときに、先頭の「//」は省略されません。
タグ:terminal_output
、incompatible_change
--[no]infer_universe_scope
デフォルト: 「false」-
設定されていて、--universe_scope が設定されていない場合、--universe_scope の値は、クエリ式内の一意のターゲット パターンのリストとして推定されます。ユニバース スコープの関数(allrdeps など)を使用するクエリ式で推測される --universe_scope の値は、望ましくない可能性があるので、実行する処理がわかっている場合にのみ、このオプションを使用してください。詳細と例については、https://bazel.build/reference/query#sky-query をご覧ください。--universe_scope が設定されている場合、このオプションの値は無視されます。注: このオプションは「query」にのみ適用されます(つまり、「cquery」には適用されません)。
タグ:loading_and_analysis
--[no]line_terminator_null
デフォルト: 「false」-
各形式が改行ではなく \0 で終了しているかどうか。
タグ:terminal_output
--[no]nodep_deps
のデフォルト: 「true」-
有効にすると、"nodep" 属性からの依存関係が、クエリを操作する依存関係グラフに含まれます。「nodep」属性の一般的な例としては、「visibility」があります。「info build-language」の出力を実行して解析し、ビルド言語のすべての「nodep」属性を確認します。
タグ:build_file_semantics
--noorder_results
-
結果を依存関係順(デフォルト)または順序なしで出力します。順序なしの出力は高速ですが、--output が minrank、maxrank、または graph ではない場合にのみサポートされます。
次のように展開:
--order_output=no
タグ:terminal_output
--null
-
各形式が改行ではなく \0 で終了しているかどうか。
次のように展開:
--line_terminator_null=true
タグ:terminal_output
--order_output=<no, deps, auto or full>
のデフォルト: "auto"-
順序なし(no)、依存関係の順序あり(deps)、完全に順序あり(full)の結果を出力します。デフォルトは「auto」です。つまり、出力フォーマッタ(proto、minrank、maxrank、graph では依存関係順、その他はすべて完全に順序付け)に応じて、結果が依存関係順または完全順序付きで出力されます。出力が完全に順序付けされると、ノードは完全に確定的な(合計)順序で出力されます。まず、すべてのノードがアルファベット順に並べ替えられます。その後、リスト内の各ノードが、順序順の深さ優先検索の開始として使用され、訪問していないノードへの送信エッジが、後続のノードのアルファベット順でトラバースされます。最後に、ノードはアクセスされた順序とは逆に出力されます。
タグ:terminal_output
--order_results
-
結果を依存関係順(デフォルト)または順序なしで出力します。順序なしの出力は高速ですが、--output が minrank、maxrank、または graph ではない場合にのみサポートされます。
次のように展開:
--order_output=auto
タグ:terminal_output
--output=<a string>
のデフォルト: 「label」-
クエリ結果の形式。クエリで使用できる値は、build、graph、streamed_jsonproto、label、label_kind、location、maxrank、minrank、package、proto、streamed_proto、textproto、xml です。
タグ:terminal_output
--[no]proto:default_values
のデフォルト: 「true」-
true の場合、BUILD ファイルで値が明示的に指定されていない属性が含まれます。それ以外の場合は省略されます。このオプションは --output=proto に適用されます。
タグ:terminal_output
--[no]proto:definition_stack
デフォルト: 「false」-
Definition_stack proto フィールドに、ルールのクラスが定義された時点の Starlark コールスタックをルール インスタンスごとに記録します。
タグ:terminal_output
--[no]proto:flatten_selects
のデフォルト: 「true」-
有効にすると、select() によって作成された構成可能な属性がフラット化されます。リストタイプの場合、フラット表現は、セレクトマップの各値を 1 回だけ含むリストです。スカラー型は null にフラット化されます。
タグ:build_file_semantics
--[no]proto:include_attribute_source_aspects
デフォルト: 「false」-
各属性の source_aspect_name proto フィールドに、属性の取得元であるソースのアスペクトを入力します(そうでない場合は空の文字列)。
タグ:terminal_output
--[no]proto:include_synthetic_attribute_hash
デフォルト: 「false」- $internal_attr_hash 属性を計算して入力するかどうかを指定します。
タグ:terminal_output
--[no]proto:instantiation_stack
デフォルト: 「false」-
各ルールのインスタンス化コールスタックにデータを入力します。これを行うには、スタックが存在する必要があります。
タグ:terminal_output
--[no]proto:locations
のデフォルト: 「true」-
proto 出力で位置情報を出力するかどうか。
タグ:terminal_output
--proto:output_rule_attrs=<comma-separated list of options>
のデフォルト: 「all」-
出力に含める属性のカンマ区切りリスト。デフォルトはすべての属性です。属性を出力しない場合は、空の文字列に設定します。このオプションは --output=proto に適用できます。
タグ:terminal_output
--[no]proto:rule_inputs_and_outputs
のデフォルト: 「true」-
rule_input と rule_output の各フィールドにデータを入力するかどうかを指定します。
タグ:terminal_output
--query_file=<a string>
のデフォルト: ""-
設定すると、クエリはコマンドラインではなく、ここで指定したファイルからクエリを読み取ります。ここでファイルを指定してコマンドライン クエリを指定するとエラーになります。
タグ:changes_inputs
--[no]relative_locations
デフォルト: 「false」-
true の場合、xml 出力と proto 出力での BUILD ファイルの場所は相対的になります。デフォルトでは、場所の出力は絶対パスであり、マシン間で一貫していません。このオプションを true に設定すると、マシン全体で一貫した結果が得られます。
タグ:terminal_output
--[no]strict_test_suite
デフォルト: 「false」-
true の場合、テスト以外のターゲットを含む test_suite を検出した場合、tests() 式はエラーになります。
タグ:build_file_semantics
、eagerness_to_exit
--[no]tool_deps
のデフォルト: 「true」-
クエリ: 無効にすると、クエリの実行対象となる依存関係グラフに「実行構成」の依存関係は含まれません。「proto_library」ルールから Protocol Compiler までの「exec 構成」依存関係エッジは通常、同じ「ターゲット」プログラムの一部ではなく、ビルド中に実行されたツールを指します。
Cquery: 無効にすると、この構成済みターゲットを検出した最上位ターゲットから実行移行を通過する構成済みターゲットがすべて除外されます。つまり、最上位のターゲットがターゲット構成に含まれている場合は、そのターゲット構成にも構成済みのターゲットのみが返されます。最上位のターゲットが exec 構成に含まれている場合は、exec 構成のターゲットのみが返されます。このオプションは、解決済みのツールチェーンを除外しません。
タグ:build_file_semantics
--universe_scope=<comma-separated list of options>
のデフォルト: ""-
カンマ区切りのターゲット パターンのセット(加法と減算)。クエリは、指定されたターゲットの推移的クロージャで定義されたユニバースで実行できます。このオプションは、query コマンドと cquery コマンドで使用されます。cquery の場合、このオプションに入力する値はすべての回答がビルドされるターゲットとなるため、このオプションは構成や遷移に影響する可能性があります。このオプションが指定されていない場合、トップレベル ターゲットはクエリ式から解析されたターゲットと見なされます。注: cquery でこのオプションを指定しないと、クエリ式から解析されたターゲットがトップレベル オプションでビルドできない場合、ビルドが中断されることがあります。
タグ:loading_and_analysis
--[no]xml:default_values
デフォルト: 「false」-
true の場合、BUILD ファイルで値が明示的に指定されていないルール属性が出力されます。それ以外の場合は省略されます。
タグ:terminal_output
--[no]xml:line_numbers
のデフォルト: 「true」-
true の場合、XML 出力に行番号が含まれます。このオプションを無効にすると、差分が読みやすくなります。このオプションは --output=xml にのみ適用されます。
タグ:terminal_output
- Bzlmod の出力とセマンティクスに関連するオプション:
--allow_yanked_versions=<a string>
件の複数回の使用が累積される-
モジュール バージョンを「<module1>@<version1>,<module2>@<version2>」の形式で指定しました。これは、モジュール バージョンが元のレジストリでヤンクされていると宣言されていても(NonRegistryOverride からのものではない場合)、解決済みの依存関係グラフで許可します。そうしないと、バージョンをアンクすると解決が失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可するヤンク バージョンを定義することもできます。このチェックを無効にするには、キーワード「all」を使用します(非推奨)。
タグ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
デフォルト: "error"-
Bazel モジュールの bazel バージョン互換性を確認します。有効な値は、エラーを解決失敗にエスカレーションする場合は「error」、チェックを無効にする場合は「off」、不一致が検出されたときに警告を出力する場合は「warning」です。
タグ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
のデフォルト: 「warning」-
ルート モジュールで宣言されている直接的な「bazel_dep」依存関係が、解決された依存関係グラフで表示されるバージョンと同じかどうかを確認します。有効な値は、チェックを無効にする「off」、不一致が検出されたときに警告を出力する「warning」、解決失敗にエスカレーションする場合は「error」です。
タグ:loading_and_analysis
--[no]ignore_dev_dependency
デフォルト: 「false」-
true の場合、Bazel は、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」を無視します。これらの dev の依存関係は、このフラグの値に関係なく、ルート モジュールでない場合、MODULE.bazel では常に無視されることに注意してください。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: 「update」-
ロックファイルを使用する方法と使用するかどうかを指定します。有効な値は、「update」でロックファイルを使用し、変更がある場合に「error」を指定します。「error」はロックファイルを使用しますが、最新でない場合はエラーをスローします。「off」はロックファイルの読み取りも書き込みも行わない「off」です。
タグ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
件の複数回の使用が累積される- <モジュール名>=<パス> という形式のローカルパスでモジュールをオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。相対パスの場合は、現在の作業ディレクトリからの相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--registry=<a string>
件の複数回の使用が累積される-
Bazel モジュールの依存関係の検索に使用するレジストリを指定します。順序は重要です。モジュールは最初に以前のレジストリで検索され、以前のレジストリからモジュールが見つからなくなった場合にのみ、後のレジストリにフォールバックします。
タグ:changes_inputs
- ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
デフォルト: 「1s:2,20s:3,1m:5」-
上限に達すると GcThrashingDetector が OOM で Bazel をクラッシュさせる上限。各制限は、<period>:<count> の形式で指定します。[期間] は期間、[カウント] は正の整数です。<period> で <count> 回連続してフル GC を実行した後、残存容量(旧世代ヒープ)の --gc_thrashing_threshold パーセントを超える領域が占有されている場合、OOM がトリガーされます。複数の上限を指定する場合は、カンマで区切ってください。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出した場合、完全な GC イベントが発生したときに、不要な一時的な Skyframe の状態を呼び出しごとにこの回数まで破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、完全な GC イベントがドロップをトリガーしないことを意味します。上限に達すると、フル GC イベントが発生して保持されるヒープの割合のしきい値を超えたときに、スカイフレームの状態がドロップされなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出すると、マイナー GC イベントが発生したときに不要な一時的な Skyframe 状態を(呼び出しごとにこの回数まで)破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。上限に達すると、マイナー GC イベントが発生して保持されるヒープの割合のしきい値を超えても、スカイフレームの状態は破棄されなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
のデフォルト: 「85」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。Bazel は、保持されているヒープの割合がこのしきい値以上であることを検出すると、不要な一時的な Skyframe 状態を削除します。これを微調整することで、GC スラッシングが(i)この一時的な状態のメモリ使用量によって発生し、(ii)必要なときに状態の再構築よりもコストが高くなる場合に、GC スラッシングの経過時間への影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
- ロギングの詳細度、形式、場所に影響するオプション:
--[no]experimental_command_profile
デフォルト: 「false」- Java フライト レコーダーの CPU プロファイルを、出力ベース ディレクトリにある profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプや出力形式をサポートするために今後変更される可能性があります。ご自身の責任のもとで使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
デフォルト: 「false」- デフォルトでは、アクション タイプの数は、実行されるアクションの数が最も多い 20 個のニーモニックに限定されています。このオプションを設定すると、すべてのニーモニックの統計情報が書き込まれます。
--experimental_repository_resolved_file=<a string>
のデフォルト: ""-
空でない場合は、実行されたすべての Starlark リポジトリ ルールの解決された情報を含む Starlark 値を書き込みます。
タグ:affects_outputs
- 他のカテゴリに当てはまらない Bazel コマンドへの汎用入力を指定または変更するオプション。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: ""-
空でない場合は、WORKSPACE ファイルではなく、指定された解決済みファイルを読み取ります。
タグ:changes_inputs
- リモート キャッシュと実行オプション:
--experimental_downloader_config=<a string>
デフォルト: 説明を参照- リモート ダウンローダーを構成するファイルを指定します。このファイルは複数の行で構成され、各行はディレクティブ(「allow」、「block」、「rewrite」)で始まり、その後にホスト名(「allow」と「block」のそれぞれ)または 2 つのパターン(1 つは照合され、もう 1 つは代替 URL として使用)が続きます。後方参照は「$1」から始まります。複数の「rewrite」ディレクティブが返される場合があります。同じ URL の場合は、複数の URL が返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: 「off」- リポジトリの取得に使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、「platform」に設定されている場合はプラットフォーム スレッド(OS スレッド)を使用し、「virtual」に設定されている場合は仮想スレッドを使用します。
- その他のカテゴリ(特に分類されていないもの):
--deleted_packages=<comma-separated list of package names>
件の複数回の使用が累積される- パッケージ名のカンマ区切りリスト。パッケージパス上のどこかに表示されていても、ビルドシステムによって存在しないと判断されます。 既存のパッケージ「x」のサブパッケージ「x/y」を削除する場合は、このオプションを使用します。たとえば、クライアントで x/y/BUILD を削除した後、別の package_path エントリによってラベル「//x:y/z」が見つかると、ビルドシステムからエラーが発生することがあります。--deleted_packages x/y を指定すると、この問題を回避できます。
--override_repository=<an equals-separated mapping of repository name to path>
件の複数回の使用が累積される- リポジトリは、<repository name>=<path> という形式のローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスがそのまま使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--package_path=<colon-separated list of options>
のデフォルト: 「%workspace%」- パッケージを検索する場所をコロンで区切ったリスト。「%workspace%」で始まる要素は、それを含むワークスペースからの相対値です。省略するか空の場合、デフォルトは「bazel info default-package-path」の出力です。
--[no]show_loading_progress
のデフォルト: 「true」- 有効にすると、Bazel から「Loading package:」というメッセージが表示されます。
実行オプション
build からすべてのオプションを継承します。
- コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path>
件の複数回の使用が累積される-
ネットワークにアクセスしてダウンロードする前に、アーカイブを検索できる場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
デフォルト: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュでファイルがコピーされずにハードリンクされます。これはディスク容量を節約することが目的です。
タグ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
のデフォルト: 「0」-
ダウンロード エラーの再試行の最大回数。0 に設定した場合、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: 1.0-
この要素に基づいて、Starlark リポジトリ ルールのすべてのタイムアウトをスケールします。これにより、ソースコードを変更せずに、ルール作成者の期待よりも低速なマシンで外部リポジトリを動作させることができます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
のデフォルト: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: 「0s」-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にした場合、タイムアウトの最大値は定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: 1.0-
HTTP ダウンロードに関連するすべてのタイムアウトを、指定された係数でスケーリングする
タグ:bazel_internal_configuration
--repository_cache=<a path>
デフォルト: 説明を参照-
外部リポジトリの取得中に取得された、ダウンロードした値のキャッシュ ロケーションを指定します。引数として空の文字列は、キャッシュの無効化をリクエストします。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
デフォルト: 「false」-
設定すると、リポジトリの取得中に resourcemanager.download{,_and_extract} を使用してダウンロードできなくなります。ネットワーク アクセスは完全に無効にされているわけではありません。インターネットにアクセスする任意の実行可能ファイルを resourcemanager.execute で実行することは可能です。
タグ:bazel_internal_configuration
--[no]run
のデフォルト: 「true」-
false の場合、ビルドされたターゲット用に作成されたコマンドラインの実行をスキップします。
タグ:affects_outputs
- ビルド実行を制御するオプション:
--gc_thrashing_threshold=<an integer in 0-100 range>
のデフォルト: 「100」-
GcThrashingDetector がメモリ プレッシャー イベントを上限(--gc_thrashing_limits)と比較して考慮する、在職期間の占有スペースの割合(0 ~ 100)。100 に設定すると、GcThrashingDetector は無効になります。
タグ:host_machine_resource_optimizations
- 目的の出力をユーザーが構成できるオプション(その存在ではなく、その値に影響する)。
--script_path=<a path>
デフォルト: 説明を参照-
設定すると、ターゲットを呼び出す指定されたファイルにシェル スクリプトが書き込まれます。このオプションを設定した場合、ターゲットは bazel から実行されません。「bazel run --script_path=foo //foo && ./foo」を使用してターゲット「//foo」を呼び出します。これは、bazel ロックが解放され、実行可能ファイルがターミナルの stdin に接続されるという点で、「bazel run //foo」とは異なります。
タグ:affects_outputs
、execution
- Bzlmod の出力とセマンティクスに関連するオプション:
--allow_yanked_versions=<a string>
件の複数回の使用が累積される-
モジュール バージョンを「<module1>@<version1>,<module2>@<version2>」の形式で指定しました。これは、モジュール バージョンが元のレジストリでヤンクされていると宣言されていても(NonRegistryOverride からのものではない場合)、解決済みの依存関係グラフで許可します。そうしないと、バージョンをアンクすると解決が失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可するヤンク バージョンを定義することもできます。このチェックを無効にするには、キーワード「all」を使用します(非推奨)。
タグ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
デフォルト: "error"-
Bazel モジュールの bazel バージョン互換性を確認します。有効な値は、エラーを解決失敗にエスカレーションする場合は「error」、チェックを無効にする場合は「off」、不一致が検出されたときに警告を出力する場合は「warning」です。
タグ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
のデフォルト: 「warning」-
ルート モジュールで宣言されている直接的な「bazel_dep」依存関係が、解決された依存関係グラフで表示されるバージョンと同じかどうかを確認します。有効な値は、チェックを無効にする「off」、不一致が検出されたときに警告を出力する「warning」、解決失敗にエスカレーションする場合は「error」です。
タグ:loading_and_analysis
--[no]ignore_dev_dependency
デフォルト: 「false」-
true の場合、Bazel は、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」を無視します。これらの dev の依存関係は、このフラグの値に関係なく、ルート モジュールでない場合、MODULE.bazel では常に無視されることに注意してください。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: 「update」-
ロックファイルを使用する方法と使用するかどうかを指定します。有効な値は、「update」でロックファイルを使用し、変更がある場合に「error」を指定します。「error」はロックファイルを使用しますが、最新でない場合はエラーをスローします。「off」はロックファイルの読み取りも書き込みも行わない「off」です。
タグ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
件の複数回の使用が累積される- <モジュール名>=<パス> という形式のローカルパスでモジュールをオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。相対パスの場合は、現在の作業ディレクトリからの相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--registry=<a string>
件の複数回の使用が累積される-
Bazel モジュールの依存関係の検索に使用するレジストリを指定します。順序は重要です。モジュールは最初に以前のレジストリで検索され、以前のレジストリからモジュールが見つからなくなった場合にのみ、後のレジストリにフォールバックします。
タグ:changes_inputs
- ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
デフォルト: 「1s:2,20s:3,1m:5」-
上限に達すると GcThrashingDetector が OOM で Bazel をクラッシュさせる上限。各制限は、<period>:<count> の形式で指定します。[期間] は期間、[カウント] は正の整数です。<period> で <count> 回連続してフル GC を実行した後、残存容量(旧世代ヒープ)の --gc_thrashing_threshold パーセントを超える領域が占有されている場合、OOM がトリガーされます。複数の上限を指定する場合は、カンマで区切ってください。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出した場合、完全な GC イベントが発生したときに、不要な一時的な Skyframe の状態を呼び出しごとにこの回数まで破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、完全な GC イベントがドロップをトリガーしないことを意味します。上限に達すると、フル GC イベントが発生して保持されるヒープの割合のしきい値を超えたときに、スカイフレームの状態がドロップされなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出すると、マイナー GC イベントが発生したときに不要な一時的な Skyframe 状態を(呼び出しごとにこの回数まで)破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。上限に達すると、マイナー GC イベントが発生して保持されるヒープの割合のしきい値を超えても、スカイフレームの状態は破棄されなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
のデフォルト: 「85」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。Bazel は、保持されているヒープの割合がこのしきい値以上であることを検出すると、不要な一時的な Skyframe 状態を削除します。これを微調整することで、GC スラッシングが(i)この一時的な状態のメモリ使用量によって発生し、(ii)必要なときに状態の再構築よりもコストが高くなる場合に、GC スラッシングの経過時間への影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
- ロギングの詳細度、形式、場所に影響するオプション:
--[no]experimental_command_profile
デフォルト: 「false」- Java フライト レコーダーの CPU プロファイルを、出力ベース ディレクトリにある profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプや出力形式をサポートするために今後変更される可能性があります。ご自身の責任のもとで使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
デフォルト: 「false」- デフォルトでは、アクション タイプの数は、実行されるアクションの数が最も多い 20 個のニーモニックに限定されています。このオプションを設定すると、すべてのニーモニックの統計情報が書き込まれます。
- 他のカテゴリに当てはまらない Bazel コマンドへの汎用入力を指定または変更するオプション。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: ""-
空でない場合は、WORKSPACE ファイルではなく、指定された解決済みファイルを読み取ります。
タグ:changes_inputs
- リモート キャッシュと実行オプション:
--experimental_downloader_config=<a string>
デフォルト: 説明を参照- リモート ダウンローダーを構成するファイルを指定します。このファイルは複数の行で構成され、各行はディレクティブ(「allow」、「block」、「rewrite」)で始まり、その後にホスト名(「allow」と「block」のそれぞれ)または 2 つのパターン(1 つは照合され、もう 1 つは代替 URL として使用)が続きます。後方参照は「$1」から始まります。複数の「rewrite」ディレクティブが返される場合があります。同じ URL の場合は、複数の URL が返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: 「off」- リポジトリの取得に使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、「platform」に設定されている場合はプラットフォーム スレッド(OS スレッド)を使用し、「virtual」に設定されている場合は仮想スレッドを使用します。
- その他のカテゴリ(特に分類されていないもの):
--override_repository=<an equals-separated mapping of repository name to path>
件の複数回の使用が累積される- リポジトリは、<repository name>=<path> という形式のローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスがそのまま使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
シャットダウン オプション
- コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path>
件の複数回の使用が累積される-
ネットワークにアクセスしてダウンロードする前に、アーカイブを検索できる場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
デフォルト: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュでファイルがコピーされずにハードリンクされます。これはディスク容量を節約することが目的です。
タグ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
のデフォルト: 「0」-
ダウンロード エラーの再試行の最大回数。0 に設定した場合、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: 1.0-
この要素に基づいて、Starlark リポジトリ ルールのすべてのタイムアウトをスケールします。これにより、ソースコードを変更せずに、ルール作成者の期待よりも低速なマシンで外部リポジトリを動作させることができます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
のデフォルト: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: 「0s」-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にした場合、タイムアウトの最大値は定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: 1.0-
HTTP ダウンロードに関連するすべてのタイムアウトを、指定された係数でスケーリングする
タグ:bazel_internal_configuration
--repository_cache=<a path>
デフォルト: 説明を参照-
外部リポジトリの取得中に取得された、ダウンロードした値のキャッシュ ロケーションを指定します。引数として空の文字列は、キャッシュの無効化をリクエストします。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
デフォルト: 「false」-
設定すると、リポジトリの取得中に resourcemanager.download{,_and_extract} を使用してダウンロードできなくなります。ネットワーク アクセスは完全に無効にされているわけではありません。インターネットにアクセスする任意の実行可能ファイルを resourcemanager.execute で実行することは可能です。
タグ:bazel_internal_configuration
- ビルド実行を制御するオプション:
--gc_thrashing_threshold=<an integer in 0-100 range>
のデフォルト: 「100」-
GcThrashingDetector がメモリ プレッシャー イベントを上限(--gc_thrashing_limits)と比較して考慮する、在職期間の占有スペースの割合(0 ~ 100)。100 に設定すると、GcThrashingDetector は無効になります。
タグ:host_machine_resource_optimizations
- コマンドの出力を制御するオプション:
--iff_heap_size_greater_than=<an integer>
のデフォルト: 「0」-
ゼロ以外の場合、JVM が消費する合計メモリ(MB 単位)がこの値を超える場合にのみ、シャットダウンによってサーバーがシャットダウンされます。
タグ:loses_incremental_state
、eagerness_to_exit
- Bzlmod の出力とセマンティクスに関連するオプション:
--allow_yanked_versions=<a string>
件の複数回の使用が累積される-
モジュール バージョンを「<module1>@<version1>,<module2>@<version2>」の形式で指定しました。これは、モジュール バージョンが元のレジストリでヤンクされていると宣言されていても(NonRegistryOverride からのものではない場合)、解決済みの依存関係グラフで許可します。そうしないと、バージョンをアンクすると解決が失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可するヤンク バージョンを定義することもできます。このチェックを無効にするには、キーワード「all」を使用します(非推奨)。
タグ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
デフォルト: "error"-
Bazel モジュールの bazel バージョン互換性を確認します。有効な値は、エラーを解決失敗にエスカレーションする場合は「error」、チェックを無効にする場合は「off」、不一致が検出されたときに警告を出力する場合は「warning」です。
タグ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
のデフォルト: 「warning」-
ルート モジュールで宣言されている直接的な「bazel_dep」依存関係が、解決された依存関係グラフで表示されるバージョンと同じかどうかを確認します。有効な値は、チェックを無効にする「off」、不一致が検出されたときに警告を出力する「warning」、解決失敗にエスカレーションする場合は「error」です。
タグ:loading_and_analysis
--[no]ignore_dev_dependency
デフォルト: 「false」-
true の場合、Bazel は、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」を無視します。これらの dev の依存関係は、このフラグの値に関係なく、ルート モジュールでない場合、MODULE.bazel では常に無視されることに注意してください。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: 「update」-
ロックファイルを使用する方法と使用するかどうかを指定します。有効な値は、「update」でロックファイルを使用し、変更がある場合に「error」を指定します。「error」はロックファイルを使用しますが、最新でない場合はエラーをスローします。「off」はロックファイルの読み取りも書き込みも行わない「off」です。
タグ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
件の複数回の使用が累積される- <モジュール名>=<パス> という形式のローカルパスでモジュールをオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。相対パスの場合は、現在の作業ディレクトリからの相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--registry=<a string>
件の複数回の使用が累積される-
Bazel モジュールの依存関係の検索に使用するレジストリを指定します。順序は重要です。モジュールは最初に以前のレジストリで検索され、以前のレジストリからモジュールが見つからなくなった場合にのみ、後のレジストリにフォールバックします。
タグ:changes_inputs
- ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
デフォルト: 「1s:2,20s:3,1m:5」-
上限に達すると GcThrashingDetector が OOM で Bazel をクラッシュさせる上限。各制限は、<period>:<count> の形式で指定します。[期間] は期間、[カウント] は正の整数です。<period> で <count> 回連続してフル GC を実行した後、残存容量(旧世代ヒープ)の --gc_thrashing_threshold パーセントを超える領域が占有されている場合、OOM がトリガーされます。複数の上限を指定する場合は、カンマで区切ってください。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出した場合、完全な GC イベントが発生したときに、不要な一時的な Skyframe の状態を呼び出しごとにこの回数まで破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、完全な GC イベントがドロップをトリガーしないことを意味します。上限に達すると、フル GC イベントが発生して保持されるヒープの割合のしきい値を超えたときに、スカイフレームの状態がドロップされなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出すると、マイナー GC イベントが発生したときに不要な一時的な Skyframe 状態を(呼び出しごとにこの回数まで)破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。上限に達すると、マイナー GC イベントが発生して保持されるヒープの割合のしきい値を超えても、スカイフレームの状態は破棄されなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
のデフォルト: 「85」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。Bazel は、保持されているヒープの割合がこのしきい値以上であることを検出すると、不要な一時的な Skyframe 状態を削除します。これを微調整することで、GC スラッシングが(i)この一時的な状態のメモリ使用量によって発生し、(ii)必要なときに状態の再構築よりもコストが高くなる場合に、GC スラッシングの経過時間への影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
- ロギングの詳細度、形式、場所に影響するオプション:
--[no]experimental_command_profile
デフォルト: 「false」- Java フライト レコーダーの CPU プロファイルを、出力ベース ディレクトリにある profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプや出力形式をサポートするために今後変更される可能性があります。ご自身の責任のもとで使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
デフォルト: 「false」- デフォルトでは、アクション タイプの数は、実行されるアクションの数が最も多い 20 個のニーモニックに限定されています。このオプションを設定すると、すべてのニーモニックの統計情報が書き込まれます。
- 他のカテゴリに当てはまらない Bazel コマンドへの汎用入力を指定または変更するオプション。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: ""-
空でない場合は、WORKSPACE ファイルではなく、指定された解決済みファイルを読み取ります。
タグ:changes_inputs
- リモート キャッシュと実行オプション:
--experimental_downloader_config=<a string>
デフォルト: 説明を参照- リモート ダウンローダーを構成するファイルを指定します。このファイルは複数の行で構成され、各行はディレクティブ(「allow」、「block」、「rewrite」)で始まり、その後にホスト名(「allow」と「block」のそれぞれ)または 2 つのパターン(1 つは照合され、もう 1 つは代替 URL として使用)が続きます。後方参照は「$1」から始まります。複数の「rewrite」ディレクティブが返される場合があります。同じ URL の場合は、複数の URL が返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: 「off」- リポジトリの取得に使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、「platform」に設定されている場合はプラットフォーム スレッド(OS スレッド)を使用し、「virtual」に設定されている場合は仮想スレッドを使用します。
- その他のカテゴリ(特に分類されていないもの):
--override_repository=<an equals-separated mapping of repository name to path>
件の複数回の使用が累積される- リポジトリは、<repository name>=<path> という形式のローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスがそのまま使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
同期オプション
- コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path>
件の複数回の使用が累積される-
ネットワークにアクセスしてダウンロードする前に、アーカイブを検索できる場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
デフォルト: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュでファイルがコピーされずにハードリンクされます。これはディスク容量を節約することが目的です。
タグ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
のデフォルト: 「0」-
ダウンロード エラーの再試行の最大回数。0 に設定した場合、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: 1.0-
この要素に基づいて、Starlark リポジトリ ルールのすべてのタイムアウトをスケールします。これにより、ソースコードを変更せずに、ルール作成者の期待よりも低速なマシンで外部リポジトリを動作させることができます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
のデフォルト: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: 「0s」-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にした場合、タイムアウトの最大値は定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: 1.0-
HTTP ダウンロードに関連するすべてのタイムアウトを、指定された係数でスケーリングする
タグ:bazel_internal_configuration
--repository_cache=<a path>
デフォルト: 説明を参照-
外部リポジトリの取得中に取得された、ダウンロードした値のキャッシュ ロケーションを指定します。引数として空の文字列は、キャッシュの無効化をリクエストします。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
デフォルト: 「false」-
設定すると、リポジトリの取得中に resourcemanager.download{,_and_extract} を使用してダウンロードできなくなります。ネットワーク アクセスは完全に無効にされているわけではありません。インターネットにアクセスする任意の実行可能ファイルを resourcemanager.execute で実行することは可能です。
タグ:bazel_internal_configuration
- ビルド実行を制御するオプション:
--[no]configure
のデフォルト: 「False」-
システム構成のために「構成」とマークされたリポジトリのみを同期します。
タグ:changes_inputs
--gc_thrashing_threshold=<an integer in 0-100 range>
のデフォルト: 「100」-
GcThrashingDetector がメモリ プレッシャー イベントを上限(--gc_thrashing_limits)と比較して考慮する、在職期間の占有スペースの割合(0 ~ 100)。100 に設定すると、GcThrashingDetector は無効になります。
タグ:host_machine_resource_optimizations
--[no]keep_going
[-k
] default: "false"-
エラー発生後は、できるだけ続行してください。失敗したターゲットとそれに依存するターゲットは分析できませんが、これらのターゲットの他の前提条件は分析できます。
タグ:eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
のデフォルト: "auto"-
読み込み/分析フェーズに使用する並列スレッドの数。整数またはキーワード("auto"、"HOST_CPUS"、"HOST_RAM")を受け取ります。その後に必要に応じて演算([-|*]<float>)が続きます。例:"auto"、"HOST_CPUS*.5" となります。「auto」は、ホストリソースに基づいて妥当なデフォルトを設定します。1 以上の値を指定してください。
タグ:bazel_internal_configuration
--only=<a string>
件の複数回の使用が累積される-
このオプションが指定されている場合、このオプションで指定されたリポジトリのみを同期します。それでも、すべて(または、--configure のすべて(またはすべての Configure-like )が提供される)が古くなったとみなします。
タグ:changes_inputs
- このオプションは、BUILD ファイル、.bzl ファイル、WORKSPACE ファイルからアクセス可能な Starlark 言語または Build API のセマンティクスに影響します。
--[no]incompatible_config_setting_private_default_visibility
デフォルト: 「false」-
compatible_enforce_config_setting_visibility=false の場合、何も追加されません。このフラグが false の場合、明示的な可視性属性のない config_setting は //visibility:public です。このフラグが true の場合、config_setting は他のすべてのルールと同じ可視性ロジックに従います。https://github.com/bazelbuild/bazel/issues/12933 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_enforce_config_setting_visibility
のデフォルト: 「true」-
true の場合、config_setting 公開設定の制限を適用します。false の場合、すべての config_setting がすべてのターゲットに表示されます。https://github.com/bazelbuild/bazel/issues/12932 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
- Bzlmod の出力とセマンティクスに関連するオプション:
--allow_yanked_versions=<a string>
件の複数回の使用が累積される-
モジュール バージョンを「<module1>@<version1>,<module2>@<version2>」の形式で指定しました。これは、モジュール バージョンが元のレジストリでヤンクされていると宣言されていても(NonRegistryOverride からのものではない場合)、解決済みの依存関係グラフで許可します。そうしないと、バージョンをアンクすると解決が失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可するヤンク バージョンを定義することもできます。このチェックを無効にするには、キーワード「all」を使用します(非推奨)。
タグ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
デフォルト: "error"-
Bazel モジュールの bazel バージョン互換性を確認します。有効な値は、エラーを解決失敗にエスカレーションする場合は「error」、チェックを無効にする場合は「off」、不一致が検出されたときに警告を出力する場合は「warning」です。
タグ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
のデフォルト: 「warning」-
ルート モジュールで宣言されている直接的な「bazel_dep」依存関係が、解決された依存関係グラフで表示されるバージョンと同じかどうかを確認します。有効な値は、チェックを無効にする「off」、不一致が検出されたときに警告を出力する「warning」、解決失敗にエスカレーションする場合は「error」です。
タグ:loading_and_analysis
--[no]ignore_dev_dependency
デフォルト: 「false」-
true の場合、Bazel は、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」を無視します。これらの dev の依存関係は、このフラグの値に関係なく、ルート モジュールでない場合、MODULE.bazel では常に無視されることに注意してください。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: 「update」-
ロックファイルを使用する方法と使用するかどうかを指定します。有効な値は、「update」でロックファイルを使用し、変更がある場合に「error」を指定します。「error」はロックファイルを使用しますが、最新でない場合はエラーをスローします。「off」はロックファイルの読み取りも書き込みも行わない「off」です。
タグ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
件の複数回の使用が累積される- <モジュール名>=<パス> という形式のローカルパスでモジュールをオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。相対パスの場合は、現在の作業ディレクトリからの相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--registry=<a string>
件の複数回の使用が累積される-
Bazel モジュールの依存関係の検索に使用するレジストリを指定します。順序は重要です。モジュールは最初に以前のレジストリで検索され、以前のレジストリからモジュールが見つからなくなった場合にのみ、後のレジストリにフォールバックします。
タグ:changes_inputs
- ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
デフォルト: 「1s:2,20s:3,1m:5」-
上限に達すると GcThrashingDetector が OOM で Bazel をクラッシュさせる上限。各制限は、<period>:<count> の形式で指定します。[期間] は期間、[カウント] は正の整数です。<period> で <count> 回連続してフル GC を実行した後、残存容量(旧世代ヒープ)の --gc_thrashing_threshold パーセントを超える領域が占有されている場合、OOM がトリガーされます。複数の上限を指定する場合は、カンマで区切ってください。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出した場合、完全な GC イベントが発生したときに、不要な一時的な Skyframe の状態を呼び出しごとにこの回数まで破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、完全な GC イベントがドロップをトリガーしないことを意味します。上限に達すると、フル GC イベントが発生して保持されるヒープの割合のしきい値を超えたときに、スカイフレームの状態がドロップされなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出すると、マイナー GC イベントが発生したときに不要な一時的な Skyframe 状態を(呼び出しごとにこの回数まで)破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。上限に達すると、マイナー GC イベントが発生して保持されるヒープの割合のしきい値を超えても、スカイフレームの状態は破棄されなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
のデフォルト: 「85」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。Bazel は、保持されているヒープの割合がこのしきい値以上であることを検出すると、不要な一時的な Skyframe 状態を削除します。これを微調整することで、GC スラッシングが(i)この一時的な状態のメモリ使用量によって発生し、(ii)必要なときに状態の再構築よりもコストが高くなる場合に、GC スラッシングの経過時間への影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
- ロギングの詳細度、形式、場所に影響するオプション:
--[no]experimental_command_profile
デフォルト: 「false」- Java フライト レコーダーの CPU プロファイルを、出力ベース ディレクトリにある profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプや出力形式をサポートするために今後変更される可能性があります。ご自身の責任のもとで使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
デフォルト: 「false」- デフォルトでは、アクション タイプの数は、実行されるアクションの数が最も多い 20 個のニーモニックに限定されています。このオプションを設定すると、すべてのニーモニックの統計情報が書き込まれます。
--experimental_repository_resolved_file=<a string>
のデフォルト: ""-
空でない場合は、実行されたすべての Starlark リポジトリ ルールの解決された情報を含む Starlark 値を書き込みます。
タグ:affects_outputs
- 他のカテゴリに当てはまらない Bazel コマンドへの汎用入力を指定または変更するオプション。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: ""-
空でない場合は、WORKSPACE ファイルではなく、指定された解決済みファイルを読み取ります。
タグ:changes_inputs
- リモート キャッシュと実行オプション:
--experimental_downloader_config=<a string>
デフォルト: 説明を参照- リモート ダウンローダーを構成するファイルを指定します。このファイルは複数の行で構成され、各行はディレクティブ(「allow」、「block」、「rewrite」)で始まり、その後にホスト名(「allow」と「block」のそれぞれ)または 2 つのパターン(1 つは照合され、もう 1 つは代替 URL として使用)が続きます。後方参照は「$1」から始まります。複数の「rewrite」ディレクティブが返される場合があります。同じ URL の場合は、複数の URL が返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: 「off」- リポジトリの取得に使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、「platform」に設定されている場合はプラットフォーム スレッド(OS スレッド)を使用し、「virtual」に設定されている場合は仮想スレッドを使用します。
- その他のカテゴリ(特に分類されていないもの):
--deleted_packages=<comma-separated list of package names>
件の複数回の使用が累積される- パッケージ名のカンマ区切りリスト。パッケージパス上のどこかに表示されていても、ビルドシステムによって存在しないと判断されます。 既存のパッケージ「x」のサブパッケージ「x/y」を削除する場合は、このオプションを使用します。たとえば、クライアントで x/y/BUILD を削除した後、別の package_path エントリによってラベル「//x:y/z」が見つかると、ビルドシステムからエラーが発生することがあります。--deleted_packages x/y を指定すると、この問題を回避できます。
--override_repository=<an equals-separated mapping of repository name to path>
件の複数回の使用が累積される- リポジトリは、<repository name>=<path> という形式のローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスがそのまま使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--package_path=<colon-separated list of options>
のデフォルト: 「%workspace%」- パッケージを検索する場所をコロンで区切ったリスト。「%workspace%」で始まる要素は、それを含むワークスペースからの相対値です。省略するか空の場合、デフォルトは「bazel info default-package-path」の出力です。
--[no]show_loading_progress
のデフォルト: 「true」- 有効にすると、Bazel から「Loading package:」というメッセージが表示されます。
テスト オプション
build からすべてのオプションを継承します。
- コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path>
件の複数回の使用が累積される-
ネットワークにアクセスしてダウンロードする前に、アーカイブを検索できる場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
デフォルト: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュでファイルがコピーされずにハードリンクされます。これはディスク容量を節約することが目的です。
タグ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
のデフォルト: 「0」-
ダウンロード エラーの再試行の最大回数。0 に設定した場合、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: 1.0-
この要素に基づいて、Starlark リポジトリ ルールのすべてのタイムアウトをスケールします。これにより、ソースコードを変更せずに、ルール作成者の期待よりも低速なマシンで外部リポジトリを動作させることができます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
のデフォルト: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: 「0s」-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にした場合、タイムアウトの最大値は定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: 1.0-
HTTP ダウンロードに関連するすべてのタイムアウトを、指定された係数でスケーリングする
タグ:bazel_internal_configuration
--repository_cache=<a path>
デフォルト: 説明を参照-
外部リポジトリの取得中に取得された、ダウンロードした値のキャッシュ ロケーションを指定します。引数として空の文字列は、キャッシュの無効化をリクエストします。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
デフォルト: 「false」-
設定すると、リポジトリの取得中に resourcemanager.download{,_and_extract} を使用してダウンロードできなくなります。ネットワーク アクセスは完全に無効にされているわけではありません。インターネットにアクセスする任意の実行可能ファイルを resourcemanager.execute で実行することは可能です。
タグ:bazel_internal_configuration
- ビルド実行を制御するオプション:
--gc_thrashing_threshold=<an integer in 0-100 range>
のデフォルト: 「100」-
GcThrashingDetector がメモリ プレッシャー イベントを上限(--gc_thrashing_limits)と比較して考慮する、在職期間の占有スペースの割合(0 ~ 100)。100 に設定すると、GcThrashingDetector は無効になります。
タグ:host_machine_resource_optimizations
- Bzlmod の出力とセマンティクスに関連するオプション:
--allow_yanked_versions=<a string>
件の複数回の使用が累積される-
モジュール バージョンを「<module1>@<version1>,<module2>@<version2>」の形式で指定しました。これは、モジュール バージョンが元のレジストリでヤンクされていると宣言されていても(NonRegistryOverride からのものではない場合)、解決済みの依存関係グラフで許可します。そうしないと、バージョンをアンクすると解決が失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可するヤンク バージョンを定義することもできます。このチェックを無効にするには、キーワード「all」を使用します(非推奨)。
タグ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
デフォルト: "error"-
Bazel モジュールの bazel バージョン互換性を確認します。有効な値は、エラーを解決失敗にエスカレーションする場合は「error」、チェックを無効にする場合は「off」、不一致が検出されたときに警告を出力する場合は「warning」です。
タグ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
のデフォルト: 「warning」-
ルート モジュールで宣言されている直接的な「bazel_dep」依存関係が、解決された依存関係グラフで表示されるバージョンと同じかどうかを確認します。有効な値は、チェックを無効にする「off」、不一致が検出されたときに警告を出力する「warning」、解決失敗にエスカレーションする場合は「error」です。
タグ:loading_and_analysis
--[no]ignore_dev_dependency
デフォルト: 「false」-
true の場合、Bazel は、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」を無視します。これらの dev の依存関係は、このフラグの値に関係なく、ルート モジュールでない場合、MODULE.bazel では常に無視されることに注意してください。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: 「update」-
ロックファイルを使用する方法と使用するかどうかを指定します。有効な値は、「update」でロックファイルを使用し、変更がある場合に「error」を指定します。「error」はロックファイルを使用しますが、最新でない場合はエラーをスローします。「off」はロックファイルの読み取りも書き込みも行わない「off」です。
タグ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
件の複数回の使用が累積される- <モジュール名>=<パス> という形式のローカルパスでモジュールをオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。相対パスの場合は、現在の作業ディレクトリからの相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--registry=<a string>
件の複数回の使用が累積される-
Bazel モジュールの依存関係の検索に使用するレジストリを指定します。順序は重要です。モジュールは最初に以前のレジストリで検索され、以前のレジストリからモジュールが見つからなくなった場合にのみ、後のレジストリにフォールバックします。
タグ:changes_inputs
- ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
デフォルト: 「1s:2,20s:3,1m:5」-
上限に達すると GcThrashingDetector が OOM で Bazel をクラッシュさせる上限。各制限は、<period>:<count> の形式で指定します。[期間] は期間、[カウント] は正の整数です。<period> で <count> 回連続してフル GC を実行した後、残存容量(旧世代ヒープ)の --gc_thrashing_threshold パーセントを超える領域が占有されている場合、OOM がトリガーされます。複数の上限を指定する場合は、カンマで区切ってください。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出した場合、完全な GC イベントが発生したときに、不要な一時的な Skyframe の状態を呼び出しごとにこの回数まで破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、完全な GC イベントがドロップをトリガーしないことを意味します。上限に達すると、フル GC イベントが発生して保持されるヒープの割合のしきい値を超えたときに、スカイフレームの状態がドロップされなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出すると、マイナー GC イベントが発生したときに不要な一時的な Skyframe 状態を(呼び出しごとにこの回数まで)破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。上限に達すると、マイナー GC イベントが発生して保持されるヒープの割合のしきい値を超えても、スカイフレームの状態は破棄されなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
のデフォルト: 「85」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。Bazel は、保持されているヒープの割合がこのしきい値以上であることを検出すると、不要な一時的な Skyframe 状態を削除します。これを微調整することで、GC スラッシングが(i)この一時的な状態のメモリ使用量によって発生し、(ii)必要なときに状態の再構築よりもコストが高くなる場合に、GC スラッシングの経過時間への影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
- ロギングの詳細度、形式、場所に影響するオプション:
--[no]experimental_command_profile
デフォルト: 「false」- Java フライト レコーダーの CPU プロファイルを、出力ベース ディレクトリにある profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプや出力形式をサポートするために今後変更される可能性があります。ご自身の責任のもとで使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
デフォルト: 「false」- デフォルトでは、アクション タイプの数は、実行されるアクションの数が最も多い 20 個のニーモニックに限定されています。このオプションを設定すると、すべてのニーモニックの統計情報が書き込まれます。
--[no]print_relative_test_log_paths
デフォルト: 「false」-
true の場合、パスをテストログに出力するときに、「testlogs」コンビニエンス シンボリック リンクを使用する相対パスを使用します。注 - 後から別の設定で build や test などの呼び出しを行うと、このシンボリック リンクのターゲットが変更され、以前に出力されたパスは有用ではなくなりました。
タグ:affects_outputs
--[no]test_verbose_timeout_warnings
デフォルト: 「false」-
true の場合、実際のテスト実行時間がテストで定義されたタイムアウト(暗黙的か明示的かを問わず)と一致しない場合、追加の警告が出力されます。
タグ:affects_outputs
--[no]verbose_test_summary
のデフォルト: 「true」-
true の場合、テストサマリーに追加情報(タイミング、失敗した実行の数など)を出力します。
タグ:affects_outputs
- 他のカテゴリに当てはまらない Bazel コマンドへの汎用入力を指定または変更するオプション。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: ""-
空でない場合は、WORKSPACE ファイルではなく、指定された解決済みファイルを読み取ります。
タグ:changes_inputs
- リモート キャッシュと実行オプション:
--experimental_downloader_config=<a string>
デフォルト: 説明を参照- リモート ダウンローダーを構成するファイルを指定します。このファイルは複数の行で構成され、各行はディレクティブ(「allow」、「block」、「rewrite」)で始まり、その後にホスト名(「allow」と「block」のそれぞれ)または 2 つのパターン(1 つは照合され、もう 1 つは代替 URL として使用)が続きます。後方参照は「$1」から始まります。複数の「rewrite」ディレクティブが返される場合があります。同じ URL の場合は、複数の URL が返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: 「off」- リポジトリの取得に使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、「platform」に設定されている場合はプラットフォーム スレッド(OS スレッド)を使用し、「virtual」に設定されている場合は仮想スレッドを使用します。
- その他のカテゴリ(特に分類されていないもの):
--override_repository=<an equals-separated mapping of repository name to path>
件の複数回の使用が累積される- リポジトリは、<repository name>=<path> という形式のローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスがそのまま使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
バージョンのオプション
- コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path>
件の複数回の使用が累積される-
ネットワークにアクセスしてダウンロードする前に、アーカイブを検索できる場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
デフォルト: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュでファイルがコピーされずにハードリンクされます。これはディスク容量を節約することが目的です。
タグ:bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer>
のデフォルト: 「0」-
ダウンロード エラーの再試行の最大回数。0 に設定した場合、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: 1.0-
この要素に基づいて、Starlark リポジトリ ルールのすべてのタイムアウトをスケールします。これにより、ソースコードを変更せずに、ルール作成者の期待よりも低速なマシンで外部リポジトリを動作させることができます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
のデフォルト: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: 「0s」-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にした場合、タイムアウトの最大値は定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: 1.0-
HTTP ダウンロードに関連するすべてのタイムアウトを、指定された係数でスケーリングする
タグ:bazel_internal_configuration
--repository_cache=<a path>
デフォルト: 説明を参照-
外部リポジトリの取得中に取得された、ダウンロードした値のキャッシュ ロケーションを指定します。引数として空の文字列は、キャッシュの無効化をリクエストします。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
デフォルト: 「false」-
設定すると、リポジトリの取得中に resourcemanager.download{,_and_extract} を使用してダウンロードできなくなります。ネットワーク アクセスは完全に無効にされているわけではありません。インターネットにアクセスする任意の実行可能ファイルを resourcemanager.execute で実行することは可能です。
タグ:bazel_internal_configuration
- ビルド実行を制御するオプション:
--gc_thrashing_threshold=<an integer in 0-100 range>
のデフォルト: 「100」-
GcThrashingDetector がメモリ プレッシャー イベントを上限(--gc_thrashing_limits)と比較して考慮する、在職期間の占有スペースの割合(0 ~ 100)。100 に設定すると、GcThrashingDetector は無効になります。
タグ:host_machine_resource_optimizations
- 目的の出力をユーザーが構成できるオプション(その存在ではなく、その値に影響する)。
--[no]gnu_format
デフォルト: 「false」-
設定した場合は、GNU 標準に記載されている規則に従って、バージョンを stdout に書き込みます。
タグ:affects_outputs
、execution
- Bzlmod の出力とセマンティクスに関連するオプション:
--allow_yanked_versions=<a string>
件の複数回の使用が累積される-
モジュール バージョンを「<module1>@<version1>,<module2>@<version2>」の形式で指定しました。これは、モジュール バージョンが元のレジストリでヤンクされていると宣言されていても(NonRegistryOverride からのものではない場合)、解決済みの依存関係グラフで許可します。そうしないと、バージョンをアンクすると解決が失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可するヤンク バージョンを定義することもできます。このチェックを無効にするには、キーワード「all」を使用します(非推奨)。
タグ:loading_and_analysis
--check_bazel_compatibility=<error, warning or off>
デフォルト: "error"-
Bazel モジュールの bazel バージョン互換性を確認します。有効な値は、エラーを解決失敗にエスカレーションする場合は「error」、チェックを無効にする場合は「off」、不一致が検出されたときに警告を出力する場合は「warning」です。
タグ:loading_and_analysis
--check_direct_dependencies=<off, warning or error>
のデフォルト: 「warning」-
ルート モジュールで宣言されている直接的な「bazel_dep」依存関係が、解決された依存関係グラフで表示されるバージョンと同じかどうかを確認します。有効な値は、チェックを無効にする「off」、不一致が検出されたときに警告を出力する「warning」、解決失敗にエスカレーションする場合は「error」です。
タグ:loading_and_analysis
--[no]ignore_dev_dependency
デフォルト: 「false」-
true の場合、Bazel は、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」を無視します。これらの dev の依存関係は、このフラグの値に関係なく、ルート モジュールでない場合、MODULE.bazel では常に無視されることに注意してください。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: 「update」-
ロックファイルを使用する方法と使用するかどうかを指定します。有効な値は、「update」でロックファイルを使用し、変更がある場合に「error」を指定します。「error」はロックファイルを使用しますが、最新でない場合はエラーをスローします。「off」はロックファイルの読み取りも書き込みも行わない「off」です。
タグ:loading_and_analysis
--override_module=<an equals-separated mapping of module name to path>
件の複数回の使用が累積される- <モジュール名>=<パス> という形式のローカルパスでモジュールをオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。相対パスの場合は、現在の作業ディレクトリからの相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
--registry=<a string>
件の複数回の使用が累積される-
Bazel モジュールの依存関係の検索に使用するレジストリを指定します。順序は重要です。モジュールは最初に以前のレジストリで検索され、以前のレジストリからモジュールが見つからなくなった場合にのみ、後のレジストリにフォールバックします。
タグ:changes_inputs
- ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>>
デフォルト: 「1s:2,20s:3,1m:5」-
上限に達すると GcThrashingDetector が OOM で Bazel をクラッシュさせる上限。各制限は、<period>:<count> の形式で指定します。[期間] は期間、[カウント] は正の整数です。<period> で <count> 回連続してフル GC を実行した後、残存容量(旧世代ヒープ)の --gc_thrashing_threshold パーセントを超える領域が占有されている場合、OOM がトリガーされます。複数の上限を指定する場合は、カンマで区切ってください。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出した場合、完全な GC イベントが発生したときに、不要な一時的な Skyframe の状態を呼び出しごとにこの回数まで破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、完全な GC イベントがドロップをトリガーしないことを意味します。上限に達すると、フル GC イベントが発生して保持されるヒープの割合のしきい値を超えたときに、スカイフレームの状態がドロップされなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0>
のデフォルト: 「2147483647」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。保持されているヒープの割合が --skyframe_high_water_mark_threshold で設定されたしきい値を超えていることを Bazel が検出すると、マイナー GC イベントが発生したときに不要な一時的な Skyframe 状態を(呼び出しごとにこの回数まで)破棄します。デフォルトは Integer.MAX_VALUE で、実質的に無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。上限に達すると、マイナー GC イベントが発生して保持されるヒープの割合のしきい値を超えても、スカイフレームの状態は破棄されなくなります。
タグ:host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer>
のデフォルト: 「85」-
Bazel の内部 SkyFrame エンジンの高度な構成を示すフラグ。Bazel は、保持されているヒープの割合がこのしきい値以上であることを検出すると、不要な一時的な Skyframe 状態を削除します。これを微調整することで、GC スラッシングが(i)この一時的な状態のメモリ使用量によって発生し、(ii)必要なときに状態の再構築よりもコストが高くなる場合に、GC スラッシングの経過時間への影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
- ロギングの詳細度、形式、場所に影響するオプション:
--[no]experimental_command_profile
デフォルト: 「false」- Java フライト レコーダーの CPU プロファイルを、出力ベース ディレクトリにある profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプや出力形式をサポートするために今後変更される可能性があります。ご自身の責任のもとで使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
デフォルト: 「false」- デフォルトでは、アクション タイプの数は、実行されるアクションの数が最も多い 20 個のニーモニックに限定されています。このオプションを設定すると、すべてのニーモニックの統計情報が書き込まれます。
- 他のカテゴリに当てはまらない Bazel コマンドへの汎用入力を指定または変更するオプション。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: ""-
空でない場合は、WORKSPACE ファイルではなく、指定された解決済みファイルを読み取ります。
タグ:changes_inputs
- リモート キャッシュと実行オプション:
--experimental_downloader_config=<a string>
デフォルト: 説明を参照- リモート ダウンローダーを構成するファイルを指定します。このファイルは複数の行で構成され、各行はディレクティブ(「allow」、「block」、「rewrite」)で始まり、その後にホスト名(「allow」と「block」のそれぞれ)または 2 つのパターン(1 つは照合され、もう 1 つは代替 URL として使用)が続きます。後方参照は「$1」から始まります。複数の「rewrite」ディレクティブが返される場合があります。同じ URL の場合は、複数の URL が返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: 「off」- リポジトリの取得に使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、「platform」に設定されている場合はプラットフォーム スレッド(OS スレッド)を使用し、「virtual」に設定されている場合は仮想スレッドを使用します。
- その他のカテゴリ(特に分類されていないもの):
--override_repository=<an equals-separated mapping of repository name to path>
件の複数回の使用が累積される- リポジトリは、<repository name>=<path> という形式のローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスがそのまま使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定されたパスが「%workspace%」で始まる場合、ワークスペースのルートからの相対パス、「bazel info workspace」の出力です。
オプション エフェクト タグ
unknown |
このオプションの効果は不明であるか、文書化されていません。 |
no_op |
このオプションを選択しても効果はありません。 |
loses_incremental_state |
このオプションの値を変更すると、増分状態が大幅に失われ、ビルドの速度が低下する可能性があります。サーバーの再起動や依存関係グラフの大部分の無効化が原因で、状態が失われる可能性があります。 |
changes_inputs |
このオプションは、ファイルシステムの制限、リポジトリのバージョン、その他のオプションなど、bazel がビルドで考慮する入力を積極的に変更します。 |
affects_outputs |
このオプションは bazel の出力に影響します。このタグは意図的に広く、推移的な影響を含めることができます。影響を受ける出力のタイプは指定しません。 |
build_file_semantics |
このオプションは、BUILD ファイルまたは .bzl ファイルのセマンティクスに影響します。 |
bazel_internal_configuration |
このオプションは、bazel 内部のマシンの設定に影響します。このタグは、それ自体はビルド アーティファクトに影響するわけではありません。 |
loading_and_analysis |
このオプションは、依存関係の読み込みと分析、依存関係グラフの作成に影響します。 |
execution |
このオプションは、サンドボックス化やリモート実行関連のオプションなど、実行フェーズに影響します。 |
host_machine_resource_optimizations |
このオプションは、マシン固有である可能性があり、すべてのマシンで動作する保証はありません。この最適化には、メモリや CPU の費用など、パフォーマンスの他の側面とのトレードオフが含まれることがあります。 |
eagerness_to_exit |
このオプションにより、bazel が失敗から終了するときに、失敗しても続行するか呼び出しを終了するかの選択肢が広がります。 |
bazel_monitoring |
このオプションは、bazel の動作とパフォーマンスをモニタリングするために使用されます。 |
terminal_output |
このオプションは bazel のターミナル出力に影響します。 |
action_command_lines |
このオプションは、1 つ以上のビルド アクションのコマンドライン引数を変更します。 |
test_runner |
このオプションは、ビルドのテストランナー環境を変更します。 |
オプション メタデータのタグ
experimental |
このオプションでは、機能が保証されない試験運用版の機能がトリガーされます。 |
incompatible_change |
このオプションは、互換性を破る変更をトリガーします。このオプションを使用して、移行の準備状況をテストしたり、新機能の早期アクセスを利用したりできます |
deprecated |
このオプションは非推奨となりました。影響を受ける機能が非推奨になった場合や、情報を指定する別の方法が推奨される場合があります。 |