コマンドライン リファレンス

bazel [<startup options>] <command> [<args>]
または
bazel [<startup options>] <command> [<args>] -- [<target patterns>]
ターゲット パターンの構文については、ユーザーガイドをご覧ください。

オプションの構文

オプションは、さまざまな方法で Bazel に渡すことができます。値を必要とするオプションは、等号またはスペースのいずれかを使用して渡すことができます。

--<option>=<value>
--<option> <value>
一部のオプションには 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 指定されたテスト ターゲットをビルドして実行します。
vendor フラグ --vendor_dir で指定された特定のフォルダに外部リポジトリを取得します。
version bazel のバージョン情報を出力します。

起動オプション

コマンドの前に表示され、クライアントによって解析されるオプション:
--[no]autodetect_server_javabase のデフォルト: "true"
--noautodetect_server_javabase が渡されると、Bazel は bazel サーバーを実行するためのローカル JDK にフォールバックせず、代わりに終了します。
タグ: affects_outputsloses_incremental_state
--[no]batch のデフォルト: "false"
設定すると、Bazel は標準のクライアント/サーバー モードではなく、サーバーのないクライアント プロセスとして実行されます。これは非推奨であり、削除される予定です。残存サーバーの使用を避けるには、サーバーを明示的にシャットダウンしてください。
タグ: loses_incremental_statebazel_internal_configurationdeprecated
--[no]batch_cpu_scheduling のデフォルト: "false"
Linux でのみ。Blaze にはバッチ CPU スケジューリングを使用します。このポリシーは、非インタラクティブだが、nice 値を下げたくないワークロードに役立ちます。「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_outputsbazel_monitoring
--connect_timeout_secs=<an integer> のデフォルト: 「30」
サーバーへの接続が試行されるたびにクライアントが待機する時間
タグ: bazel_internal_configuration
--digest_function=<hash function> のデフォルト: 説明を参照
ファイル ダイジェストの計算に使用するハッシュ関数。
タグ: loses_incremental_statebazel_internal_configuration
--[no]expand_configs_in_place のデフォルト: "true"
--config フラグの展開が、通常の rc オプションとコマンドライン指定オプションの間の固定小数点展開ではなく、インプレースで行われるように変更されました。
タグ: no_opdeprecated
--failure_detail_out=<path> のデフォルト: 説明を参照
設定すると、サーバーに障害が発生し、通常どおり gRPC 経由で報告できない場合に、failure_detail の protobuf メッセージを書き込む場所を指定します。それ以外の場合の場所は ${OUTPUT_BASE}/failure_detail.rawproto になります。
タグ: affects_outputsloses_incremental_state
--[no]home_rc のデフォルト: "true"
$HOME/.bazelrc でホーム bazelrc ファイルを検索するかどうか
タグ: changes_inputs
--[no]idle_server_tasks のデフォルト: "true"
サーバーがアイドル状態のときに System.gc() を実行する
タグ: loses_incremental_statehost_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 ファイルを共有できるようにサポートされています。有効な値は、ユーザー インタラクティブ、ユーザー開始型、デフォルト、ユーティリティ、バックグラウンドです。
タグ: host_machine_resource_optimizations
--max_idle_secs=<integer> のデフォルト: 「10800」
ビルドサーバーがシャットダウンするまでアイドリングを待機する秒数。ゼロは、サーバーがシャットダウンされないことを意味します。これはサーバーの起動時にのみ読み取られます。このオプションを変更しても、サーバーは再起動されません。
タグ: eagerness_to_exitloses_incremental_state
--output_base=<path> のデフォルト: 説明を参照
設定した場合、すべてのビルド出力を書き込む出力先を指定します。それ以外の場合の場所は ${OUTPUT_ROOT}/_blaze_${USER}/${MD5_OF_WORKSPACE_ROOT} になります。注: この値に対して、次に Bazel を呼び出すときに異なるオプションを指定した場合、新しい追加の Bazel サーバーを起動することになります。Bazel は、指定された出力ベースごとに 1 つのサーバーのみを起動します。通常、ワークスペースごとに 1 つの出力ベースがあります。ただし、このオプションでは、ワークスペースごとに複数の出力ベースがあるため、同じマシン上で同じクライアントの複数のビルドを同時に実行できます。Bazel サーバーをシャットダウンする方法については、「bazel help shutdown」をご覧ください。
タグ: affects_outputsloses_incremental_state
--output_user_root=<path> のデフォルト: 説明を参照
すべてのビルド出力が書き込まれるユーザー固有のディレクトリ。デフォルトでは $USER の関数ですが、定数を指定することで、共同作業するユーザー間でビルド出力を共有できます。
タグ: affects_outputsloses_incremental_state
--[no]preemptible のデフォルト: "false"
true の場合、別のコマンドの開始時にコマンドをプリエンプトできます。
タグ: eagerness_to_exit
--server_jvm_out=<path> のデフォルト: 説明を参照
サーバーの JVM の出力を書き込む場所。設定されていない場合、デフォルトで output_base のロケーションに設定されます。
タグ: affects_outputsloses_incremental_state
--[no]shutdown_on_low_sys_mem のデフォルト: "false"
max_idle_secs が設定されていて、ビルドサーバーがしばらくアイドル状態だった場合は、システムの空き RAM が少なくなったら、サーバーをシャットダウンします。Linux のみ。
タグ: eagerness_to_exitloses_incremental_state
--[no]system_rc のデフォルト: "true"
システム全体の bazelrc を検索するかどうかを指定します。
タグ: changes_inputs
--[no]unlimit_coredumps のデフォルト: "false"
一般的な条件下でサーバー(JVM を含む)とクライアントのコアダンプを可能にするために、ソフト コアダンプの上限をハードリミットまで引き上げます。このフラグを bazelrc に一度だけ指定したら忘れてしまい、それをトリガーする条件に実際に遭遇したときにコアダンプを取得できるようにします。
タグ: bazel_internal_configuration
--[no]watchfs のデフォルト: "false"
true の場合、bazel はすべてのファイルを変更用にスキャンするのではなく、ローカルの変更に対してオペレーティング システムのファイル監視サービスを使用しようとします。
タグ: deprecated
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
true に設定すると、リモート キャッシュまたはディスク キャッシュにアップロードされたシンボリック リンクはダングルできます。
タグ: executionincompatible_change
true に設定すると、Bazel は常にリモート キャッシュやディスク キャッシュにシンボリック リンクをアップロードします。それ以外の場合、ダングリングしていない相対シンボリック リンク(およびそれらのみ)が、そのリンクが指すファイルまたはディレクトリとしてアップロードされます。
タグ: executionincompatible_change
アクションの実行に使用するツールチェーンを構成するオプション:
--[no]incompatible_enable_proto_toolchain_resolution のデフォルト: "false"
true の場合、proto lang ルールによって、rules_proto、rules_java、rules_cc リポジトリのツールチェーンが定義されます。
タグ: loading_and_analysisincompatible_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
リモートビルドの出力をローカルマシンにダウンロードするのではなく、シンボリック リンクを作成します。シンボリック リンクのターゲットは、テンプレート文字列の形式で指定できます。このテンプレート文字列には、オブジェクトのハッシュに展開される {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 言語またはビルド API のセマンティクスに影響します。
--[no]enable_bzlmod のデフォルト: "true"
true の場合、Bzlmod 依存関係管理システムが有効になり、WORKSPACE よりも優先されます。詳細については、https://bazel.build/docs/bzlmod をご覧ください。
タグ: loading_and_analysis
--[no]enable_workspace のデフォルト: "true"
true の場合、外部依存関係に対して以前の WORKSPACE システムが有効になります。詳細については、https://bazel.build/external/overview をご覧ください。
タグ: loading_and_analysis
--[no]experimental_action_resource_set のデフォルト: "true"
true に設定すると、memcache.actions.run() と gsuite.actions.run_shell() は、ローカル実行用の resource_set パラメータを受け入れます。それ以外の場合、デフォルトでメモリに 250 MB、CPU が 1 つ使用されます。
タグ: executionbuild_file_semanticsexperimental
--[no]experimental_bzl_visibility のデフォルト: "true"
有効にすると、.bzl ファイルが最上位の評価中に呼び出す「visibility()」関数が追加され、load() ステートメント用の可視性が設定されます。
タグ: loading_and_analysisexperimental
--[no]experimental_cc_shared_library のデフォルト: "false"
true に設定すると、ルール cc_shared_library に必要なルール属性と Starlark API メソッドを使用できます
タグ: build_file_semanticsloading_and_analysisexperimental
--[no]experimental_disable_external_package のデフォルト: "false"
true に設定すると、自動生成された外部パッケージは使用できなくなります。Bazel は引き続きファイル「external/BUILD」を解析できませんが、名前のないパッケージから external/ にアクセスする glob は機能します。
タグ: loading_and_analysisloses_incremental_stateexperimental
--[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_analysisexperimental
--[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"
有効にすると、experiment_java_library_export_do_not_use モジュールが使用可能になります。
タグ: loading_and_analysisincompatible_change
--[no]experimental_platforms_api のデフォルト: "false"
true に設定すると、デバッグに役立つさまざまなプラットフォーム関連の Starlark API が有効になります。
タグ: loading_and_analysisexperimental
--[no]experimental_repo_remote_exec のデフォルト: "false"
true に設定すると、repository_rule にリモート実行機能が追加されます。
タグ: build_file_semanticsloading_and_analysisexperimental
--[no]experimental_sibling_repository_layout のデフォルト: "false"
true に設定すると、メイン以外のリポジトリは、実行ルートのメイン リポジトリへのシンボリック リンクとして植えられます。つまり、すべてのリポジトリは $output_base/execution_root ディレクトリの直接の子です。これには、副作用として $output_base/execution_root/__main__/external が実際の最上位の「external」ディレクトリ用に解放されます。
タグ: action_command_linesbazel_internal_configurationloading_and_analysisloses_incremental_stateexperimental
--[no]incompatible_allow_tags_propagation のデフォルト: "true"
true に設定した場合、タグはターゲットからアクションの実行要件に伝播されます。それ以外の場合、タグは伝播されません。詳細については、https://github.com/bazelbuild/bazel/issues/8830 をご覧ください。
タグ: build_file_semanticsexperimental
--[no]incompatible_always_check_depset_elements のデフォルト: "true"
すべてのコンストラクタで、依存関係に追加された要素の有効性を確認します。要素は不変である必要がありますが、これまでは depset(direct=...) コンストラクタがチェックするのを忘れていました。depset 要素でリストではなくタプルを使用する詳細については、https://github.com/bazelbuild/bazel/issues/10313 をご覧ください。
タグ: build_file_semanticsincompatible_change
--[no]incompatible_depset_for_java_output_source_jars のデフォルト: "true"
true の場合、Bazel は java_info.java_output[0].source_jars からのリストを返さず、代わりに depset を返します。
タグ: loading_and_analysisincompatible_change
true の場合、Bazel は linking_context.libraries_to_link からのリストを返さず、代わりに depset を返します。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_disable_objc_library_transition のデフォルト: "true"
objc_library のカスタム移行を無効にして、代わりに最上位のターゲットから継承する
タグ: build_file_semanticsincompatible_change
--[no]incompatible_disable_starlark_host_transitions のデフォルト: "false"
true に設定すると、ルールの属性で「cfg = "host"」を設定できません。代わりに、ルールで「cfg = "exec"」と設定する必要があります。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_disable_target_provider_fields のデフォルト: "false"
true に設定した場合、フィールド構文を使用して「target」オブジェクトに対するプロバイダにアクセスする機能が無効になります。代わりにプロバイダ キー構文を使用してください。たとえば、ルール実装関数内から `my_info` にアクセスするために `に=
タグ: build_file_semanticsincompatible_change
--[no]incompatible_disallow_empty_glob のデフォルト: "false"
true に設定した場合、glob() の allow_empty 引数のデフォルト値は False です。
タグ: build_file_semanticsincompatible_change
--[no]incompatible_disallow_struct_provider_syntax のデフォルト: "false"
true に設定すると、ルール実装関数で構造体が返されない可能性があります。代わりに、プロバイダ インスタンスのリストを返す必要があります。
タグ: build_file_semanticsincompatible_change
--[no]incompatible_enable_deprecated_label_apis のデフォルト: "true"
有効にすると、非推奨の特定の API(native.repository_name、Label.workspace_name、Label.relative)を使用できます。
タグ: loading_and_analysis
--[no]incompatible_existing_rules_immutable_view のデフォルト: "true"
true に設定すると、native.existing_rule と native.existing_rules は可変の辞書ではなく軽量の不変のビュー オブジェクトを返します。
タグ: build_file_semanticsloading_and_analysisincompatible_change
--[no]incompatible_fail_on_unknown_attributes のデフォルト: "true"
有効にすると、不明な属性が None に設定されているターゲットが失敗します。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_fix_package_group_reporoot_syntax のデフォルト: "true"
package_group の packages 属性で、値「//...」の意味を変更して、任意のリポジトリ内のすべてのパッケージではなく、現在のリポジトリ内のすべてのパッケージを参照するようにします。「//...」の代わりに特別な値「public」を使用すると、従来の動作を得ることができます。このフラグを使用するには、--compatibility_package_group_has_public_syntax も有効にする必要があります。
タグ: build_file_semanticsincompatible_change
--[no]incompatible_java_common_parameters のデフォルト: "true"
true に設定すると、pack_sources および host_javabase のコンパイルに含まれる output_jar パラメータと host_javabase パラメータがすべて削除されます。
タグ: build_file_semanticsincompatible_change
--[no]incompatible_merge_fixed_and_default_shell_env のデフォルト: "true"
有効にすると、「env」と「use_default_shell_env = True」の両方を指定した に無効になっている場合、「env」の値は完全に無視されます。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_new_actions_api のデフォルト: "true"
true に設定すると、アクションを作成する API は「に」でのみ利用可能で、「に」では使用できなくなります。
タグ: build_file_semanticsincompatible_change
--[no]incompatible_no_attr_license のデフォルト: "true"
true に設定すると、attr.license 関数が無効になります。
タグ: build_file_semanticsincompatible_change
--[no]incompatible_no_implicit_file_export のデフォルト: "false"
設定すると、明示的にエクスポートしない限り、(使用されている)ソースファイルはパッケージ プライベートになります。https://github.com/bazelbuild/proposals/blob/master/designs/2019-10-24-file-visibility.md をご覧ください
タグ: build_file_semanticsincompatible_change
--[no]incompatible_no_rule_outputs_param のデフォルト: "false"
true に設定すると、Starlark 関数の「rule()」の「outputs」パラメータが無効になります。
タグ: build_file_semanticsincompatible_change
--[no]incompatible_objc_provider_remove_linking_info のデフォルト: "false"
true に設定すると、ObjcProvider の情報をリンクするための API が削除されます。
タグ: build_file_semanticsincompatible_change
--[no]incompatible_package_group_has_public_syntax のデフォルト: "true"
package_group の packages 属性では、「public」または「private」と記述することで、すべてのパッケージを参照するか、またはパッケージを一切参照しないかを指定できます。
タグ: build_file_semanticsincompatible_change
--[no]incompatible_require_linker_input_cc_api のデフォルト: "true"
true に設定した場合、ルール create_linking_context には、library_to_link ではなく linker_inputs が必要になります。Linking_context の古いゲッターも無効になり、linker_inputs だけが利用可能になります。
タグ: build_file_semanticsloading_and_analysisincompatible_change
--[no]incompatible_run_shell_command_string のデフォルト: "true"
true に設定すると、actions.run_shell のコマンド パラメータは文字列のみを受け入れます
タグ: build_file_semanticsincompatible_change
--[no]incompatible_stop_exporting_language_modules のデフォルト: "false"
有効にすると、特定の言語固有のモジュール(`cc_common` など)がユーザーの .bzl ファイルで利用できなくなり、それぞれのルール リポジトリからしか呼び出されない場合があります。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_struct_has_no_methods のデフォルト: "false"
構造体フィールドの名前空間を汚染する、構造体の to_json メソッドと to_proto メソッドを無効にします。代わりに、JSON の場合は json.encode または json.encode_indent を使用し、textproto の場合は proto.encode_text を使用します。
タグ: build_file_semanticsincompatible_change
--[no]incompatible_top_level_aspects_require_providers のデフォルト: "false"
true に設定すると、トップレベルのアスペクトは必要なプロバイダを尊重し、ルールでアドバタイズされたプロバイダがアスペクトの必要なプロバイダを満たしているトップレベル ターゲットでのみ実行されます。
タグ: loading_and_analysisincompatible_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_analysisincompatible_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_analysisincompatible_change
--[no]incompatible_visibility_private_attributes_at_definition のデフォルト: "true"
true に設定すると、プライベート ルールの属性の公開設定がルールの定義に照らして確認され、表示されない場合はルールの使用にフォールバックします。
タグ: build_file_semanticsincompatible_change
--max_computation_steps=<a long integer> のデフォルト: 「0」
BUILD ファイルで実行できる Starlark 計算ステップの最大数(ゼロは制限なしを意味します)。
タグ: build_file_semantics
--nested_set_depth_limit=<an integer> のデフォルト: 「3500」
depset(NestedSet とも呼ばれます)の内部のグラフの最大深度。この深度を超えると、depset() コンストラクタは失敗します。
タグ: loading_and_analysis
ビルド時間の最適化をトリガーするオプション:
--[no]heuristically_drop_nodes のデフォルト: "false"
true の場合、Blaze は関連する FileState ノードと DirectoryListingState ノードを削除した後、メモリを節約するために FileState ノードと DirectoryListing ノードを削除します。これらのノードが再び必要になる可能性は低くなります。再評価の対象となった場合、プログラムは再評価を行います。
タグ: loses_incremental_state
--[no]incompatible_do_not_split_linking_cmdline のデフォルト: "true"
true の場合、Bazel はリンクに使用されるコマンドライン フラグを変更しなくなります。また、param ファイルに渡すフラグとそうでないフラグを選択的に決定することもできなくなります。詳細については、https://github.com/bazelbuild/bazel/issues/7670 をご覧ください。
タグ: loading_and_analysisincompatible_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_routine_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=<command_name> ", "protocol_name=BEP")。デフォルトは none です。
タグ: 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 のアップロードが完了するまでの Bazel の待機時間を指定します。このフラグを使用すると、JVM が重大な GC スラッシングを行い、どのユーザー スレッドでも進行できない場合に、確実に終了します。
タグ: bazel_monitoring
--bes_outerr_buffer_size=<an integer> のデフォルト: 「10240」
進行状況イベントとしてレポートされる前に、BEP でバッファリングされる stdout または stderr の最大サイズを指定します。個々の書き込みは、指定した値よりも大きい場合でも 1 つのイベントで報告されます(--bes_outerr_chunk_size まで)。
タグ: affects_outputs
--bes_outerr_chunk_size=<an integer> のデフォルト: 「1048576」
1 つのメッセージで BEP に送信する stdout または stderr の最大サイズを指定します。
タグ: affects_outputs
--bes_proxy=<a string> のデフォルト: 説明を参照
プロキシ経由でビルドイベント サービスに接続します。現在、このフラグは 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」
ビルドとテストが完了した後、Bazel が BES/BEP のアップロードが完了するまで待機する時間を指定します。有効なタイムアウトは、自然数の後に、日(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」
Build Event Service のアップロードでビルドの完了をブロックするか、呼び出しを直ちに終了してバックグラウンドでアップロードを完了するかを指定します。「wait_for_upload_complete」(デフォルト)、「nowait_for_upload_complete」、または「full_async」。
タグ: eagerness_to_exit
--build_event_binary_file=<a string> のデフォルト: ""
空でない場合は、ビルドイベント プロトコルの表現を変数で区切ったバイナリ表現をそのファイルに書き込みます。このオプションは、--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 の Build Event Service のアップロードでビルドの完了をブロックするか、呼び出しを直ちに終了してバックグラウンドでアップロードを完了するかを指定します。「wait_for_upload_complete」(デフォルト)、「nowait_for_upload_complete」、または「full_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」、または「full_async」。
タグ: eagerness_to_exit
--build_event_max_named_set_of_file_entries=<an integer> のデフォルト: 「-1」
1 つの named_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」、または「full_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
true の場合、出力ファイルを提示するときに、BEP 内の相対 Fileset シンボリック リンクを完全に解決します。--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, repository_fetch 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 に書き込まれます。このオプションは実質的に、手動 OOM には影響しません。-XX:+HeapDumpOnOutOfMemoryError に代わるものです。
タグ: bazel_monitoring
--[no]legacy_important_outputs のデフォルト: "true"
これを使用して、TargetComplete イベントで従来の重要な出力フィールドの生成を抑制します。Bazel から ResultStore への統合には、重要な出力値が必要です。
タグ: 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 は 2 つの GC で 4 秒間の一時停止を行い、その後 4 つの GC の一時停止は 0 秒です
タグ: bazel_monitoring
--profile=<a path> のデフォルト: 説明を参照
設定されている場合、Bazel をプロファイリングし、指定されたファイルにデータを書き込みます。bazel analyze-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_outputsbazel_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 は生成の一部として行われるのではなく、バックグラウンドで行われます。
--experimental_remote_cache_compression_threshold=<an integer> のデフォルト: 「0」
zstd で圧縮/解凍するために必要な最小 blob サイズ。--remote_cache_compression が設定されていない場合効果はありません。
--[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 のダイジェストが最近参照された後、その blob の保証される最小 TTL(ActionResult や FindMissingBlobs など)。Bazel は、blob の TTL に基づいていくつかの最適化を行います(増分ビルドで GetActionResult を繰り返し呼び出さないなど)。この値は、実際の TTL よりも少し小さい値に設定する必要があります。これは、サーバーがダイジェストを返してから、Bazel がダイジェストを受け取るまでに時間差があるためです。
タグ: 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 です。
--experimental_remote_output_service=<a string> のデフォルト: 説明を参照
リモート出力サービス エンドポイントの HOST または HOST:PORT。サポートされているスキーマは、grpc、grpcs(TLS が有効な grpcs)、unix(ローカル UNIX ソケット)です。スキーマが指定されていない場合、Bazel はデフォルトで grpcs になります。TLS を無効にするには、grpc:// または unix: スキーマを指定します。
--experimental_remote_output_service_output_path_prefix=<a string> のデフォルト: ""
--experimental_remote_output_service によって管理される出力ディレクトリの内容が配置されるパス。ビルドで使用される実際の出力ディレクトリは、このパスの子孫となり、出力サービスによって決まります。
--[no]experimental_remote_require_cached のデフォルト: "false"
true に設定した場合、リモートで実行できるすべてのアクションがキャッシュに保存され、それ以外の場合はビルドが失敗します。新しい結果を誤ってキャッシュに挿入することなく、キャッシュに保存すべきアクションが実際にキャッシュに保存されているかどうかを確認できるため、非決定論的問題のトラブルシューティングに役立ちます。
--experimental_remote_scrubbing_config=<Converts to a Scrubber> のデフォルト: 説明を参照
指定された構成ファイルによるリモート キャッシュキーのスクラブを有効にします。構成ファイルはテキスト形式のプロトコル バッファである必要があります(src/main/protobuf/remote_scrubbing.proto を参照)。 この機能は、同じプラットフォームをターゲットにしている異なるプラットフォームで実行されるアクション間で、リモート/ディスクキャッシュの共有を容易にすることを目的としています。不適切な設定を行うと、誤ってキャッシュ エントリが共有され、正しくビルドされない可能性があるため、使用する際は細心の注意を払ってください。 スクラブは、アクションの実行方法には影響しません。アクションの結果を取得または保存するためのリモート/ディスク キャッシュキーの計算方法にのみ影響します。スクラブされたアクションはリモート実行とは互換性がなく、常にローカルで実行されます。 スクラブ構成を変更しても、ローカル ファイル システムや内部キャッシュに存在する出力は無効になりません。影響を受けるアクションを再実行するには、クリーンなビルドが必要です。 この機能を適切に使用するには、カスタムの --host_platform を、-experimental_platform_in_output_dir(出力接頭辞を正規化するため)および --compatible_strict_action_env(環境変数を正規化するため)とともに設定することをおすすめします。
--[no]incompatible_remote_build_event_upload_respect_no_cache のデフォルト: "false"
非推奨。いいえ。代わりに --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"
NoOps
タグ: 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 になります。TLS を無効にするには、grpc://、http://、unix: スキーマを指定します。https://bazel.build/remote/caching をご覧ください。
--[no]remote_cache_compression のデフォルト: "false"
有効にすると、サイズが --experimental_remote_cache_compression_threshold 以上の場合に、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 valid Java regular expression> 回の使用が累積されています
--remote_download_outputs に関係なく、パスがこのパターンと一致するリモートビルド出力が強制的にダウンロードされます。このフラグを繰り返すことで、複数のパターンを指定できます。
タグ: 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 のシーケンスで構成され、各メッセージの前には、メソッド LogEntry.writeDelimitedTo(OutputStream) によって実行される、次のシリアル化された protobuf メッセージのサイズを示す変数が付加されています。
--remote_header=<a 'name=value' assignment> 回の使用が累積されています
リクエストに含めるヘッダーを指定する(--remote_header=Name=Value)。フラグを複数回指定することで、複数のヘッダーを渡すことができます。同じ名前の複数の値はカンマ区切りのリストに変換されます。
--remote_instance_name=<a string> のデフォルト: ""
Remote Execution 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> 回の使用が累積されています
追加の config セクションを rc ファイルから選択します。すべての <command> について、セクションが存在する場合は <command>:<config> からオプションも取得します。このセクションが .rc ファイル内に存在しない場合、Blaze はエラーで失敗します。これらと同等の構成セクションとフラグの組み合わせは、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.> 回の使用が累積されています
<a href="https://github.com/EngFlow/credential-helper-spec">Credential Helper Specification</a> に準拠した認証情報ヘルパーを構成して、リポジトリの取得、リモート キャッシュと実行、ビルドイベント サービスのための認証情報の取得に使用します。 ヘルパーによって提供される認証情報は、「--google_default_credentials」、「--google_credentials」、「.netrc」ファイル、または「repository_にく手順については、https://blog.engflow.com/2023/10/09/configure-bazels-credential-helper/ をご覧ください。
--credential_helper_cache_duration=<An immutable length of time.> のデフォルト: 「30m」
認証情報の有効期限が切れたときにヘルパーが提供しない場合に、認証情報ヘルパーによって提供された認証情報がキャッシュに保存されるデフォルトの期間。
--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 が 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_analysisexperimental
--[no]experimental_windows_watchfs のデフォルト: "false"
true の場合、--watchfs に対する試験運用版の Windows サポートが有効になります。それ以外の場合、--watchfsis は 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 は、接続で読み取りオペレーションがなかったこの時間が経過した後(ただし、保留中の gRPC 呼び出しが少なくとも 1 つある場合にのみ)ping を送信します。時間は秒単位として扱われます。1 秒未満の値を設定するとエラーになります。デフォルトでは、キープアライブ ping は無効になっています。この設定を有効にする前に、サービス オーナーと調整する必要があります。たとえば、このフラグに 30 秒の値を設定するには、次のように設定します。-grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.> のデフォルト: 「20s」
送信 gRPC 接続のキープアライブ タイムアウトを構成します。keep-alive ping が --grpc_keepalive_time ありで有効になっている場合、この時間が過ぎても Bazel が ping の応答を受信しないと、接続がタイムアウトします。時間は秒単位として扱われます。1 秒未満の値を設定するとエラーになります。キープアライブ ping が無効になっている場合、この設定は無視されます。
--[no]incompatible_disable_non_executable_java_binary のデフォルト: "false"
true の場合、java_binary は常に実行可能です。create_executable 属性は削除されます。
タグ: loading_and_analysisincompatible_change
NoOps。
タグ: loading_and_analysisincompatible_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 の場合: このフラグは現在、非演算ですが、--experimental_windows_watchfs と組み合わせて有効にできます。任意の OS 上: ワークスペースがネットワーク ファイル システム上にあり、ファイルがリモートマシン上で編集されている場合、動作は未定義になります。

分析プロファイルのオプション

コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path> 回の使用が累積されています
ネットワークにアクセスしてダウンロードする前にアーカイブを検索する場所の追加。
タグ: bazel_internal_configuration
設定すると、キャッシュ ヒットが発生した場合、リポジトリ キャッシュはファイルをコピーするのではなくハードリンクします。これはディスク容量を節約するためのものです。
タグ: bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer> のデフォルト: 「0」
ダウンロード エラーの再試行の最大試行回数。0 に設定すると、再試行が無効になります。
タグ: experimental
--experimental_scale_timeouts=<a double> のデフォルト: 「1.0」
Starlark リポジトリ ルールのすべてのタイムアウトを、この係数でスケーリングします。このようにして、ソースコードを変更することなく、ルール作成者の想定よりも遅いマシンで外部リポジトリを動作させることができます。
タグ: bazel_internal_configurationexperimental
--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
--[no]incompatible_disable_native_repo_rules のデフォルト: "false"
false の場合、ネイティブ リポジトリ ルールを WORKSPACE で使用できます。それ以外の場合は、代わりに Starlark リポジトリ ルールを使用する必要があります。ネイティブ リポジトリのルールには、local_repository、new_local_repository、local_config_platform、android_sdk_repository、android_ndk_repository があります。
タグ: bazel_internal_configuration
--repository_cache=<a path> のデフォルト: 説明を参照
外部リポジトリの取得中に取得されたダウンロード値のキャッシュの場所を指定します。引数として空の文字列を指定すると、キャッシュの無効化がリクエストされます。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます
タグ: bazel_internal_configuration
--[no]repository_disable_download のデフォルト: "false"
設定した場合、リポジトリの取得中に gke.download{,_and_extract} を使用したダウンロードは許可されません。ネットワーク アクセスは完全には無効にはなりません。インターネットにアクセスする任意の実行可能ファイルを gsuite.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, refresh or error> のデフォルト: "update"
ロックファイルの使用方法と使用方法を指定します。有効な値は、ロックファイルを使用して変更があった場合に更新する「update」、リモート レジストリから変更可能な情報(ヤンクされたバージョンや以前に欠落したモジュール)を随時更新する「refresh」、ロックファイルを使用するが最新でない場合にエラーをスローする「error」、ロックファイルの読み取り / 書き込みを行わない場合は「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
--vendor_dir=<a path> のデフォルト: 説明を参照
外部リポジトリをベンダーモードで保持するディレクトリを指定します。これは、外部リポジトリを取得する目的で、またはビルド中に外部リポジトリを使用するためです。パスは、絶対パスまたはワークスペース ディレクトリへの相対パスで指定できます。
タグ: loading_and_analysis
ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> のデフォルト: "1s:2,20s:3,1m:5"
上限に達すると、GcThrashingDetector が OOM を持つ Bazel をクラッシュさせます。各制限は、<period>:<count> として指定します。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 エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、GC イベントが完全に終了したときに不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、完全な GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、GC イベントが完全に発生し、保持されているヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> のデフォルト: 「2147483647」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、マイナー GC イベントの発生時に不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、マイナー GC イベントが発生して保持ヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: 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
--experimental_command_profile=<cpu, wall, alloc or lock> のデフォルト: 説明を参照
コマンドの実行中に Java フライト レコーダーのプロファイルを記録します。サポートされているプロファイリング イベントタイプ(cpu、wall、alloc、lock)のいずれかを引数として指定する必要があります。プロファイルは、出力ベース ディレクトリの下のイベントタイプに基づいて名前が付けられたファイルに書き込まれます。このフラグの構文とセマンティクスは、他のプロファイル タイプや出力形式をサポートするため今後変更される可能性があります。このフラグは自己責任で使用してください。
--[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` から始まります。同じ URL に対して複数の rewrite ディレクティブが返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto> のデフォルト: "auto"
リポジトリのフェッチに使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得は再起動の対象となります。それ以外の場合は、仮想ワーカー スレッドを使用します。
その他のカテゴリに該当しないその他のオプション:
--override_repository=<an equals-separated mapping of repository name to path> 回の使用が累積されています
リポジトリは、<リポジトリ名>=<パス> 形式のローカルパスでオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。指定したパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定したパスが「%workspace%」で始まる場合は、「bazel info workspace」の出力であるワークスペースのルートからの相対パスになります。

Aquery オプション

build からすべてのオプションを継承します。

コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path> 回の使用が累積されています
ネットワークにアクセスしてダウンロードする前にアーカイブを検索する場所の追加。
タグ: bazel_internal_configuration
設定すると、キャッシュ ヒットが発生した場合、リポジトリ キャッシュはファイルをコピーするのではなくハードリンクします。これはディスク容量を節約するためのものです。
タグ: bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer> のデフォルト: 「0」
ダウンロード エラーの再試行の最大試行回数。0 に設定すると、再試行が無効になります。
タグ: experimental
--experimental_scale_timeouts=<a double> のデフォルト: 「1.0」
Starlark リポジトリ ルールのすべてのタイムアウトを、この係数でスケーリングします。このようにして、ソースコードを変更することなく、ルール作成者の想定よりも遅いマシンで外部リポジトリを動作させることができます。
タグ: bazel_internal_configurationexperimental
--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
--[no]incompatible_disable_native_repo_rules のデフォルト: "false"
false の場合、ネイティブ リポジトリ ルールを WORKSPACE で使用できます。それ以外の場合は、代わりに Starlark リポジトリ ルールを使用する必要があります。ネイティブ リポジトリのルールには、local_repository、new_local_repository、local_config_platform、android_sdk_repository、android_ndk_repository があります。
タグ: bazel_internal_configuration
--repository_cache=<a path> のデフォルト: 説明を参照
外部リポジトリの取得中に取得されたダウンロード値のキャッシュの場所を指定します。引数として空の文字列を指定すると、キャッシュの無効化がリクエストされます。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます
タグ: bazel_internal_configuration
--[no]repository_disable_download のデフォルト: "false"
設定した場合、リポジトリの取得中に gke.download{,_and_extract} を使用したダウンロードは許可されません。ネットワーク アクセスは完全には無効にはなりません。インターネットにアクセスする任意の実行可能ファイルを gsuite.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」(デフォルト)は、直接依存関係のルールクラスが指定されているかどうかに関係なく、宣言されたすべてのアスペクト依存関係が追加されることを意味します。「precise」は、直接依存関係のルールクラスでアクティブになる可能性のあるアスペクトのみが追加されることを意味します。なお、高精度モードでは、1 つのターゲットを評価するために他のパッケージを読み込む必要があるため、他のモードよりも時間がかかります。また、正確なモードでさえも完全に正確というわけではありません。アスペクトを計算するかどうかの決定は、分析フェーズで決定され、「Bazel クエリ」中には実行されません。
タグ: build_file_semantics
--[no]consistent_labels のデフォルト: "false"
有効にすると、すべてのクエリコマンドは <code>Label</code> インスタンスに適用される Starlark <code>str</code> 関数と同様にラベルを出力します。これは、さまざまなクエリコマンドやルールによって出力されたラベルの出力を照合する必要があるツールに役立ちます。有効になっていない場合、出力フォーマッタは、出力を読みやすくするために(メイン リポジトリからの相対的な)明らかなリポジトリ名を自由に出力できます。
タグ: terminal_output
--[no]experimental_explicit_aspects のデフォルト: "false"
aquery, cquery: アスペクトで生成されたアクションを出力に含めるかどうかクエリ: no-op(アスペクトは常に従う)
タグ: 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: アスペクトで生成されたアクションを出力に含めるかどうかクエリ: 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"
コマンドで使用される param ファイルの内容(大きな可能性もあります)を含めます。注: このフラグを有効にすると、--include_commandline フラグが自動的に有効になります。
タグ: terminal_output
--[no]incompatible_package_group_includes_double_slash のデフォルト: "true"
有効にすると、package_group の `packages` 属性を出力するときに、先頭の `//` が省略されません。
タグ: terminal_outputincompatible_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"
クエリ結果を出力する形式。aquery で指定できる値は、text、textproto、proto、streamed_proto、jsonproto です。
タグ: terminal_output
--[no]proto:default_values のデフォルト: "true"
true の場合、値が明示的に指定されていない属性が含まれます。それ以外の場合は、省略されます。このオプションは --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> のデフォルト: ""
設定すると、query はコマンドラインではなく、ここで指定したファイルからクエリを読み取ります。ここにファイルとコマンドライン クエリを指定するとエラーになります。
タグ: 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"
クエリ: 無効にすると、「exec configuration」への依存関係は、クエリが動作する依存関係グラフに含まれません。任意の「proto_library」ルールからプロトコル コンパイラへの依存関係エッジなど、「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, refresh or error> のデフォルト: "update"
ロックファイルの使用方法と使用方法を指定します。有効な値は、ロックファイルを使用して変更があった場合に更新する「update」、リモート レジストリから変更可能な情報(ヤンクされたバージョンや以前に欠落したモジュール)を随時更新する「refresh」、ロックファイルを使用するが最新でない場合にエラーをスローする「error」、ロックファイルの読み取り / 書き込みを行わない場合は「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
--vendor_dir=<a path> のデフォルト: 説明を参照
外部リポジトリをベンダーモードで保持するディレクトリを指定します。これは、外部リポジトリを取得する目的で、またはビルド中に外部リポジトリを使用するためです。パスは、絶対パスまたはワークスペース ディレクトリへの相対パスで指定できます。
タグ: loading_and_analysis
ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> のデフォルト: "1s:2,20s:3,1m:5"
上限に達すると、GcThrashingDetector が OOM を持つ Bazel をクラッシュさせます。各制限は、<period>:<count> として指定します。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 エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、GC イベントが完全に終了したときに不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、完全な GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、GC イベントが完全に発生し、保持されているヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> のデフォルト: 「2147483647」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、マイナー GC イベントの発生時に不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、マイナー GC イベントが発生して保持ヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer> のデフォルト: 「85」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率がこのしきい値以上であることを検出した場合、不要な一時的な Skyframe 状態を破棄します。これを微調整すると、GC スラッシングが(i)この一時的な状態のメモリ使用量に起因しており、(ii)必要に応じて状態を再構築するよりもコストが高い場合に、GC スラッシングの経過時間への影響を軽減できます。
タグ: host_machine_resource_optimizations
ロギングの詳細度、形式、場所に影響するオプション:
--experimental_command_profile=<cpu, wall, alloc or lock> のデフォルト: 説明を参照
コマンドの実行中に Java フライト レコーダーのプロファイルを記録します。サポートされているプロファイリング イベントタイプ(cpu、wall、alloc、lock)のいずれかを引数として指定する必要があります。プロファイルは、出力ベース ディレクトリの下のイベントタイプに基づいて名前が付けられたファイルに書き込まれます。このフラグの構文とセマンティクスは、他のプロファイル タイプや出力形式をサポートするため今後変更される可能性があります。このフラグは自己責任で使用してください。
--[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` から始まります。同じ URL に対して複数の rewrite ディレクティブが返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto> のデフォルト: "auto"
リポジトリのフェッチに使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得は再起動の対象となります。それ以外の場合は、仮想ワーカー スレッドを使用します。
その他のカテゴリに該当しないその他のオプション:
--override_repository=<an equals-separated mapping of repository name to path> 回の使用が累積されています
リポジトリは、<リポジトリ名>=<パス> 形式のローカルパスでオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。指定したパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定したパスが「%workspace%」で始まる場合は、「bazel info workspace」の出力であるワークスペースのルートからの相対パスとなります。
ビルド実行を制御するオプション:
ファイル システムを直接呼び出してシンボリック リンク ツリーを作成するかどうか
タグ: loading_and_analysisexecutionexperimental
--[no]experimental_persistent_aar_extractor のデフォルト: "false"
ワーカーを使用して永続的な AAR エクストラクタを有効にします。
タグ: execution
--[no]experimental_remotable_source_manifests のデフォルト: "false"
ソース マニフェストのアクションをリモート可能にするかどうか
タグ: loading_and_analysisexecutionexperimental
--[no]experimental_split_coverage_postprocessing のデフォルト: "false"
true の場合、Bazel は新しい Spwn でテスト用のカバレッジ後処理を実行します。
タグ: execution
--[no]experimental_strict_fileset_output のデフォルト: "false"
このオプションを有効にすると、ファイルセットはすべての出力アーティファクトを通常のファイルとして扱います。ディレクトリを走査したり、シンボリック リンクの影響を受けたりしません。
タグ: execution
--[no]incompatible_disallow_unsound_directory_outputs のデフォルト: "true"
設定すると、出力ファイルをディレクトリとして実体化するアクションでエラーになります。ソース ディレクトリには影響しません。https://github.com/bazelbuild/bazel/issues/18646 をご覧ください。
タグ: bazel_internal_configurationincompatible_change
--[no]incompatible_modify_execution_info_additive のデフォルト: "false"
有効にすると、複数の --modify_execution_info フラグを渡すことで追加されます。無効にすると、最後のフラグのみが考慮されます。
タグ: executionaffects_outputsloading_and_analysisincompatible_change
--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」を削除します。
タグ: executionaffects_outputsloading_and_analysis
--persistent_android_dex_desugar
ワーカーを使用して、永続的な Android dex アクションと desugar アクションを有効にします。
展開先:
  --internal_persistent_android_dex_desugar
  --strategy=Desugar=worker
  --strategy=DexBuilder=worker

タグ: host_machine_resource_optimizationsexecution
--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=AARGenerator=worker--strategy=ProcessDatabinding=worker--strategy=GenerateDataBindingBaseClasses=workerhost_machine_resource_optimizationsexecution
--persistent_multiplex_android_dex_desugar
ワーカーを使用して、永続的な多重化された Android dex アクションと desugar アクションを有効にします。
展開先:
  --persistent_android_dex_desugar
  --internal_persistent_multiplex_android_dex_desugar

タグ: host_machine_resource_optimizationsexecution
--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-workerss
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers

--modify_execution_info=AARGenerator=+supports-multiplex-workershost_machine_resource_optimizationsexecution
--persistent_multiplex_android_tools
永続的な Android ツールと多重化された Android ツール(dex 変換、desugar、リソース処理)を有効にします。
展開先:
  --internal_persistent_multiplex_busybox_tools
  --persistent_multiplex_android_resource_processor
  --persistent_multiplex_android_dex_desugar

タグ: host_machine_resource_optimizationsexecution
--[no]use_target_platform_for_tests のデフォルト: "false"
true の場合、Bazel はテスト実行グループではなく、ターゲット プラットフォームを使用してテストを実行します。
タグ: execution
アクションの実行に使用するツールチェーンを構成するオプション:
--android_compiler=<a string> のデフォルト: 説明を参照
Android ターゲット コンパイラ。
タグ: affects_outputsloading_and_analysisloses_incremental_state
--android_crosstool_top=<a build target label> のデフォルト: 「//external:android/crosstool」
Android ビルドに使用される C++ コンパイラの場所。
タグ: affects_outputschanges_inputsloading_and_analysisloses_incremental_state
--android_grte_top=<a label> のデフォルト: 説明を参照
Android ターゲットの grte_top を指定します。
タグ: changes_inputsloading_and_analysisloses_incremental_state
--android_manifest_merger=<legacy, android or force_android> のデフォルト: "android"
android_binary ルールに使用するマニフェスト マージツールを選択します。従来のマージツールから Android マニフェスト マージツールへの移行をサポートするフラグ。
タグ: affects_outputsloading_and_analysisloses_incremental_state
--android_platforms=<a build target label> のデフォルト: ""
android_binary ターゲットが使用するプラットフォームを設定します。複数のプラットフォームが指定されている場合、バイナリはファット APK になります。この APK には、指定された各ターゲット プラットフォームのネイティブ バイナリが含まれています。
タグ: changes_inputsloading_and_analysisloses_incremental_state
--android_sdk=<a build target label> のデフォルト: "@bazel_tools//tools/android:sdk"
Android アプリのビルドに使用する Android SDK/プラットフォームを指定します。
タグ: changes_inputsloading_and_analysisloses_incremental_state
--apple_crosstool_top=<a build target label> デフォルト: "@bazel_tools//tools/cpp:ツールチェーン"
Apple ルールと Objc ルール、およびそれらの依存関係で使用されるクロスツール パッケージのラベル。
タグ: loses_incremental_statechanges_inputs
--cc_output_directory_tag=<a string> のデフォルト: ""
構成ディレクトリに追加する接尾辞を指定します。
タグ: affects_outputs
--compiler=<a string> のデフォルト: 説明を参照
ターゲットのコンパイルに使用する C++ コンパイラ。
タグ: loading_and_analysisexecution
--coverage_output_generator=<a build target label> のデフォルト: "@bazel_tools//tools/test:lcov_merger"
未加工のカバレッジ レポートの後処理に使用されるバイナリの場所。現在は、単一のファイル(バイナリ)を含むファイル グループである必要があります。デフォルトは「//tools/test:lcov_merger」です。
タグ: changes_inputsaffects_outputsloading_and_analysis
--coverage_report_generator=<a build target label> デフォルト: "@bazel_tools//tools/test:coverage_report_generator"
カバレッジ レポートの生成に使用されるバイナリの場所。現在は、単一のファイル(バイナリ)を含むファイル グループである必要があります。デフォルトは「//tools/test:coverage_report_generator」です。
タグ: changes_inputsaffects_outputsloading_and_analysis
--coverage_support=<a build target label> デフォルト: "@bazel_tools//tools/test:coverage_support"
コード カバレッジを収集するすべてのテスト アクションの入力で必要なサポート ファイルの場所。デフォルトは「//tools/test:coverage_support」です。
タグ: changes_inputsaffects_outputsloading_and_analysis
--crosstool_top=<a build target label> デフォルト: "@bazel_tools//tools/cpp:ツールチェーン"
C++ コードのコンパイルに使用されるクロスツール パッケージのラベル。
タグ: loading_and_analysischanges_inputsaffects_outputs
--custom_malloc=<a build target label> のデフォルト: 説明を参照
カスタム Maloc 実装を指定します。この設定は、ビルドルールの Maloc 属性をオーバーライドします。
タグ: changes_inputsaffects_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_stateloading_and_analysisexecution
--[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_ツールチェーン s() によって WORKSPACE ファイルで宣言されたものの前に考慮されます。
タグ: affects_outputschanges_inputsloading_and_analysis
--grte_top=<a label> のデフォルト: 説明を参照
チェックインされた libc ライブラリへのラベル。デフォルト値はクロスツール ツールチェーンによって選択されるため、オーバーライドする必要はほとんどありません。
タグ: action_command_linesaffects_outputs
--host_compiler=<a string> のデフォルト: 説明を参照
ホスト コンパイルに使用する C++ コンパイラ。--host_crosstool_top が設定されていない場合、無視されます。
タグ: loading_and_analysisexecution
--host_crosstool_top=<a build target label> のデフォルト: 説明を参照
デフォルトでは、exec 構成には --crosstool_top オプションと --compiler オプションも使用されます。このフラグを指定すると、Bazel は指定された crosstool_top に対してデフォルトの libc とコンパイラを使用します。
タグ: loading_and_analysischanges_inputsaffects_outputs
--host_grte_top=<a label> のデフォルト: 説明を参照
指定すると、exec 構成の libc 最上位ディレクトリ(--grte_top)がオーバーライドされます。
タグ: action_command_linesaffects_outputs
--host_platform=<a build target label> デフォルト: "@bazel_tools//tools:host_platform"
ホストシステムを記述するプラットフォーム ルールのラベル。
タグ: affects_outputschanges_inputsloading_and_analysis
--[no]incompatible_dont_enable_host_nonhost_crosstool_features のデフォルト: "true"
true の場合、Bazel は C++ ツールチェーンの「host」機能と「nonhost」機能を有効にしません(詳しくは、https://github.com/bazelbuild/bazel/issues/7407 をご覧ください)。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_enable_android_toolchain_resolution のデフォルト: "true"
ツールチェーン解決を使用して、Android ルール用の Android SDK を選択します(Starlark とネイティブ)
タグ: loading_and_analysisincompatible_change
--[no]incompatible_enable_apple_toolchain_resolution のデフォルト: "false"
ツールチェーン解決を使用して、apple ルール用の Apple SDK を選択します(Starlark とネイティブ)
タグ: loading_and_analysisincompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone のデフォルト: "true"
true の場合、Bazel は lto インデックス作成コマンドラインに C++ リンク アクション コマンドラインを再利用しません(詳しくは、https://github.com/bazelbuild/bazel/issues/6791 をご覧ください)。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_remove_legacy_whole_archive のデフォルト: "true"
true の場合、Bazel はデフォルトでライブラリの依存関係をアーカイブ全体としてリンクしません(移行手順については、https://github.com/bazelbuild/bazel/issues/7362 をご覧ください)。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_require_ctx_in_configure_features のデフォルト: "true"
true の場合、Bazel は cc_common.configure_features に 'gsuite' パラメータを必要とします(詳しくは、https://github.com/bazelbuild/bazel/issues/7793 をご覧ください)。
タグ: loading_and_analysisincompatible_change
--[no]interface_shared_objects のデフォルト: "true"
ツールチェーンでサポートされている場合は、インターフェース共有オブジェクトを使用します。現在、この設定はすべての ELF ツールチェーンでサポートされています。
タグ: loading_and_analysisaffects_outputsaffects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> のデフォルト: 説明を参照
iOS アプリのビルドに使用する iOS SDK のバージョンを指定します。指定しない場合は、「xcode_version」のデフォルトの iOS SDK バージョンが使用されます。
タグ: loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> のデフォルト: 説明を参照
macOS アプリケーションのビルドに使用する macOS SDK のバージョンを指定します。指定しない場合は、「xcode_version」のデフォルトの macOS SDK バージョンを使用します。
タグ: loses_incremental_state
--minimum_os_version=<a string> のデフォルト: 説明を参照
コンパイルの対象となる最小 OS バージョン。
タグ: loading_and_analysisaffects_outputs
--platform_mappings=<a relative path> のデフォルト: ""
マッピング ファイルの場所。プラットフォームが設定されていない場合に使用するプラットフォーム、またはプラットフォームがすでに存在する場合に設定するフラグを記述します。メインのワークスペースのルートからの相対パスにする必要があります。デフォルトは「platform_mappings」(ワークスペース ルートの直下にあるファイル)です。
タグ: affects_outputschanges_inputsloading_and_analysis
--platforms=<a build target label> のデフォルト: ""
現在のコマンドのターゲット プラットフォームを記述するプラットフォーム ルールのラベル。
タグ: affects_outputschanges_inputsloading_and_analysis
--python2_path=<a string> のデフォルト: 説明を参照
非推奨、NoOps。「--compatibility_use_python_ツールチェーン」によって無効。
タグ: no_opdeprecated
--python3_path=<a string> のデフォルト: 説明を参照
非推奨、NoOps。「--compatibility_use_python_ツールチェーン」によって無効。
タグ: no_opdeprecated
--python_path=<a string> のデフォルト: 説明を参照
ターゲット プラットフォームで Python ターゲットを実行するために呼び出される Python インタープリタの絶対パス。非推奨。--compatible_use_python_ツールチェーン s によって無効になっています。
タグ: loading_and_analysisaffects_outputs
--python_top=<a build target label> のデフォルト: 説明を参照
ターゲット プラットフォームで Python ターゲットを実行するために呼び出される Python インタープリタを表す py_runtime のラベル。非推奨。--compatible_use_python_ツールチェーン s によって無効になっています。
タグ: loading_and_analysisaffects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> のデフォルト: 説明を参照
tvOS アプリのビルドに使用する tvOS SDK のバージョンを指定します。指定しない場合は、「xcode_version」のデフォルトの tvOS SDK バージョンを使用します。
タグ: 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_stateloading_and_analysis
コマンドの出力を制御するオプション:
--[no]apple_generate_dsym のデフォルト: "false"
デバッグ シンボル(.dSYM)ファイルを生成するかどうかを指定します。
タグ: affects_outputsaction_command_lines
true の場合、すべてのターゲットのランファイル シンボリック リンク フォレストをビルドします。false の場合は、ローカル アクション、テスト、または実行コマンドで必要とされる場合にのみ書き込みます。
タグ: affects_outputs
--[no]build_runfile_manifests のデフォルト: "true"
true の場合、すべてのターゲットの runfile マニフェストを書き込みます。false の場合は省略します。false の場合、ローカルテストは実行に失敗します。
タグ: affects_outputs
--[no]build_test_dwp のデフォルト: "false"
有効にすると、C++ テストを静的かつ fission でビルドするときに、テストバイナリの .dwp ファイルも自動的にビルドされます。
タグ: loading_and_analysisaffects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options> のデフォルト: ".pb.h"
cc_proto_library が作成するヘッダー ファイルの接尾辞を設定します。
タグ: affects_outputsloading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options> のデフォルト: 「.pb.cc」
cc_proto_library が作成するソースファイルの接尾辞を設定します。
タグ: affects_outputsloading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info のデフォルト: "false"
proto_library で、代替 Java API バージョンの追加アクションを実行します。
タグ: affects_outputsloading_and_analysisexperimental
--[no]experimental_proto_extra_actions のデフォルト: "false"
proto_library で、代替 Java API バージョンの追加アクションを実行します。
タグ: affects_outputsloading_and_analysisexperimental
--[no]experimental_save_feature_state のデフォルト: "false"
有効化されリクエストされた機能の状態をコンパイルの出力として保存します。
タグ: affects_outputsexperimental
--fission=<a set of compilation modes> のデフォルト: 「no」
C++ コンパイルとリンクに分裂を使用するコンパイル モードを指定します。{'fastbuild', 'dbg', 'opt'} の任意の組み合わせにできます。すべてのモードを有効にする場合は 'yes'、すべてのモードを無効にする特殊な値 'no' にすることもできます。
タグ: loading_and_analysisaction_command_linesaffects_outputs
--[no]incompatible_always_include_files_in_data のデフォルト: "true"
true の場合、ネイティブ ルールによってデータ依存関係の <code>DefaultInfo.files</code> が実行ファイルに追加されます。これは、Starlark ルールの推奨動作(https://bazel.build/extending/rules#runfiles_features_to_avoid)と一致します。
タグ: affects_outputsincompatible_change
--[no]legacy_external_runfiles のデフォルト: "true"
true の場合、外部リポジトリのランファイル シンボリック リンク フォレストを(.runfiles/repo に加えて).runfiles/wsname/external/repo にビルドします。
タグ: 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_outputsloading_and_analysisloses_incremental_state
--[no]android_databinding_use_androidx のデフォルト: "true"
AndroidX 互換のデータ バインディング ファイルを生成します。これは、データ バインディング v2 でのみ使用されます。このフラグは機能しません。
タグ: affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[no]android_databinding_use_v3_4_args のデフォルト: "true"
Android データ バインディング v2 を 3.4.0 引数で使用します。このフラグは機能しません。
タグ: affects_outputsloading_and_analysisloses_incremental_stateexperimental
--android_dynamic_mode=<off, default or fully> のデフォルト: 「off」
cc_binary で共有ライブラリが明示的に作成されていない場合に、Android ルールの C++ 依存関係を動的にリンクするかどうかを指定します。「default」を選択すると、動的にリンクするかどうかが bazel によって選択されます。「complete」はすべてのライブラリが動的にリンクされることを意味します。「オフ」は、すべてのライブラリがほぼ静的モードでリンクされることを意味します。
タグ: affects_outputsloading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency> のデフォルト: 「alphabetical」
Android バイナリのマニフェスト マージツールに渡されるマニフェストの順序を設定します。ALPHABETICAL は、マニフェストが execroot からの相対パスで並べ替えられることを意味します。ALPHABETICAL_BY_CONFIGURATION は、出力ディレクトリ内の構成ディレクトリからの相対パスでマニフェストが並べ替えられることを意味します。DEPENDENCY は、各ライブラリのマニフェストが依存関係のマニフェストの前に来るようにマニフェストが並べ替えられることを意味します。
タグ: action_command_linesexecution
--[no]android_resource_shrinking のデフォルト: "false"
ProGuard を使用する android_binary APK のリソース圧縮を有効にします。
タグ: affects_outputsloading_and_analysis
--[no]build_python_zip のデフォルト: "auto"
Python の実行可能 zip をビルドします(Windows の場合はオフ、他のプラットフォームの場合はオフ)。
タグ: affects_outputs
--catalyst_cpus=<comma-separated list of options> 回の使用が累積されています
Apple Catalyst バイナリをビルドするアーキテクチャのカンマ区切りリスト。
タグ: loses_incremental_stateloading_and_analysis
--[no]collect_code_coverage のデフォルト: "false"
指定した場合、Bazel は(可能な場合はオフライン インストルメンテーションを使用して)コードをインストルメント化し、テスト中にカバレッジ情報を収集します。--instrumentation_filter に一致するターゲットのみが影響を受けます。通常、このオプションは直接指定せず、代わりに「bazelCoverage」コマンドを使用する必要があります。
タグ: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] デフォルト: "fastbuild"
バイナリをビルドするモードを指定します。値: fastbuild、dbg、opt。
タグ: affects_outputsaction_command_lines
--conlyopt=<a string> 回の使用が累積されています
C ソースファイルのコンパイル時に gcc に渡す追加オプション。
タグ: action_command_linesaffects_outputs
--copt=<a string> 回の使用が累積されています
gcc に渡す追加オプション。
タグ: action_command_linesaffects_outputs
--cpu=<a string> のデフォルト: ""
ターゲット CPU。
タグ: changes_inputsaffects_outputs
--cs_fdo_absolute_path=<a string> のデフォルト: 説明を参照
CSFDO のプロファイル情報を使用してコンパイルを最適化します。プロファイル ファイル(未加工またはインデックス付き LLVM プロファイル ファイル)を含む zip ファイルの絶対パス名を指定します。
タグ: 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_linesaffects_outputs
--define=<a 'name=value' assignment> 回の使用が累積されています
--define オプションごとにビルド変数の割り当てを指定します。
タグ: changes_inputsaffects_outputs
--dynamic_mode=<off, default or fully> のデフォルト: "default"
C++ バイナリを動的にリンクするかどうかを指定します。「default」を選択すると、Bazel が動的にリンクするかどうかを選択します。「complete」はすべてのライブラリが動的にリンクされることを意味します。「オフ」は、すべてのライブラリがほぼ静的モードでリンクされることを意味します。
タグ: loading_and_analysisaffects_outputs
--[no]enable_fdo_profile_absolute_path のデフォルト: "true"
設定すると、fdo_specific_profile_path を使用するとエラーが発生します。
タグ: affects_outputs
--[no]enable_runfiles のデフォルト: "auto"
runfiles シンボリック リンク ツリーを有効にする: Windows では、他のプラットフォームではデフォルトで無効になっています。
タグ: affects_outputs
--experimental_action_listener=<a build target label> 回の使用が累積されています
アスペクトを優先するため非推奨となりました。action_listener を使用して、既存のビルド アクションに extra_action をアタッチします。
タグ: executionexperimental
--[no]experimental_android_compress_java_resources のデフォルト: "false"
APK 内の Java リソースを圧縮する
タグ: affects_outputsloading_and_analysisexperimental
--[no]experimental_android_databinding_v2 のデフォルト: "true"
Android データ バインディング v2 を使用します。このフラグは機能しません。
タグ: affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[no]experimental_android_resource_shrinking のデフォルト: "false"
ProGuard を使用する android_binary APK のリソース圧縮を有効にします。
タグ: affects_outputsloading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex のデフォルト: "false"
rex ツールを使用して dex ファイルを書き換える
タグ: affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[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 と -fasynchronous-unwind-tables を使用してコンパイルします。
タグ: action_command_linesaffects_outputsexperimental
--experimental_output_paths=<off, content or strip> のデフォルト: 「off」
特にマルチプラットフォーム / マルチ構成のビルドの場合、出力ツリールールで出力を書き込む場所に使用するモデル。これは非常に試験運用版です。詳細については、https://github.com/bazelbuild/bazel/issues/6526 をご覧ください。Starlark のアクションでは、キー「supports-path-mapping」を「execution_requirements」辞書に追加することでパス マッピングを有効にできます。
タグ: loses_incremental_statebazel_internal_configurationaffects_outputsexecution
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment> 回の使用が累積されています
各エントリは label=value の形式にする必要があります。label はプラットフォームを表し、values は出力パスで使用する略称です。--experimental_platform_in_output_dir が true の場合にのみ使用されます。名前の優先順位が最も高い。
タグ: affects_outputsexperimental
--[no]experimental_platform_in_output_dir のデフォルト: "false"
true の場合、出力ディレクトリ名で CPU ではなくターゲット プラットフォームの略称が使用されます。正確なスキームは試験運用版であり、変更される可能性があります。まず、まれに、--platforms オプションの値が 1 つではない場合は、platforms オプションのハッシュが使用されます。次に、--experimental_override_name_platform_in_output_dir によって現在のプラットフォームの略称が登録されている場合は、その略称が使用されます。--experimental_use_platforms_in_output_dir_legacy_heuristic に設定されている場合は、現在のプラットフォーム ラベルに基づいた略称を使用します。最後に、プラットフォーム オプションのハッシュが最後の手段として使用されます。
タグ: affects_outputsexperimental
--[no]experimental_use_llvm_covmap のデフォルト: "false"
指定した場合、collect_code_coverage が有効なときに Bazel は gcov ではなく llvm-cov のカバレッジ マップ情報を生成します。
タグ: changes_inputsaffects_outputsloading_and_analysisexperimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic のデフォルト: "true"
このフラグは、推奨される移行戦略またはテスト戦略の一部としてのみ使用してください。ヒューリスティックには既知の欠陥があるため、--experimental_override_name_platform_in_output_dir のみを使用するよう移行することをおすすめします。
タグ: affects_outputsexperimental
--fat_apk_cpu=<comma-separated set of options> のデフォルト: 「armeabi-v7a」
このオプションを設定すると、指定されたすべてのターゲット アーキテクチャ(--fat_apk_cpu=x86,armeabi-v7a. このフラグを指定すると、android_binary ルールの依存関係について --android_cpu は無視されます。
タグ: affects_outputsloading_and_analysisloses_incremental_state
--[no]fat_apk_hwasan のデフォルト: "false"
HWASAN 分割を作成するかどうか。
タグ: affects_outputsloading_and_analysisloses_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_inputsaffects_outputs
--[no]force_pic のデフォルト: "false"
有効にすると、すべての C++ コンパイルで位置独立コード(「-fPIC」)が生成されます。リンクでは非 PIC ライブラリよりも PIC ビルド済みライブラリが優先され、リンクでは位置独立実行ファイル(「-pie」)が生成されます。
タグ: loading_and_analysisaffects_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_outputsaction_command_lines
--host_conlyopt=<a string> 回の使用が累積されています
exec 構成で C ソースファイル(C++ ではない)をコンパイルするときに C コンパイラに渡す追加オプション。
タグ: action_command_linesaffects_outputs
--host_copt=<a string> 回の使用が累積されています
exec 構成でビルドされたツールの C コンパイラに渡す追加オプション。
タグ: action_command_linesaffects_outputs
--host_cpu=<a string> のデフォルト: ""
ホストの CPU。
タグ: changes_inputsaffects_outputs
--host_cxxopt=<a string> 回の使用が累積されています
exec 構成でビルドされたツールの C++ コンパイラに渡す追加オプション。
タグ: action_command_linesaffects_outputs
--host_features=<a string> 回の使用が累積されています
指定された機能は、exec 構成で構築されたターゲットに対してデフォルトで有効または無効にされます。-<feature> を指定すると、この機能が無効になります。ネガティブな特徴は、ポジティブな特徴よりも常に優先されます。
タグ: changes_inputsaffects_outputs
--host_force_python=<PY2 or PY3> のデフォルト: 説明を参照
実行構成の Python バージョンをオーバーライドします。「PY2」または「PY3」のいずれかです。
タグ: loading_and_analysisaffects_outputs
--host_linkopt=<a string> 回の使用が累積されています
実行構成でツールをリンクする際にリンカーに渡す追加オプション。
タグ: action_command_linesaffects_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_nここで、regex_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_linesaffects_outputs
--host_swiftcopt=<a string> 回の使用が累積されています
実行ツールのために swiftc に渡す追加オプション。
タグ: action_command_linesaffects_outputs
--[no]incompatible_auto_exec_groups のデフォルト: "false"
有効にすると、ルールで使用されるツールチェーンごとに実行グループが自動的に作成されます。そのためには、ルールのアクションに「ツールチェーン」パラメータを指定する必要があります。詳細については、https://github.com/bazelbuild/bazel/issues/17134 をご覧ください。
タグ: affects_outputsincompatible_change
--[no]incompatible_merge_genfiles_directory のデフォルト: "true"
true の場合、genfiles ディレクトリが bin ディレクトリに折りたたみられます。
タグ: affects_outputsincompatible_change
--[no]incompatible_use_host_features のデフォルト: "true"
true の場合、ターゲット構成にのみ --features を使用し、実行構成に --host_features を使用します。
タグ: changes_inputsaffects_outputsincompatible_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_stateloading_and_analysis
--[no]legacy_whole_archive のデフォルト: "true"
非推奨となり、--compatible_remove_legacy_whole_archive に置き換えられました(詳しくは、https://github.com/bazelbuild/bazel/issues/7362 をご覧ください)。オンにした場合、linkshared=True と linkopts に linkstatic=True または「-static」のいずれかが指定されている cc_binary ルールに対して --whole-archive を使用します。これは下位互換性のためだけのものです。より適切な代替策は、必要に応じて常時リンク=1 を使用することです。
タグ: action_command_linesaffects_outputsdeprecated
--linkopt=<a string> 回の使用が累積されています
リンク時に gcc に渡す追加オプション。
タグ: action_command_linesaffects_outputs
--ltobackendopt=<a string> 回の使用が累積されています
LTO バックエンド ステップに渡す追加オプション(--features=thin_lto の下)。
タグ: action_command_linesaffects_outputs
--ltoindexopt=<a string> 回の使用が累積されています
LTO のインデックス登録ステップに渡す追加オプション(--features=thin_lto の下)。
タグ: action_command_linesaffects_outputs
--macos_cpus=<comma-separated list of options> 回の使用が累積されています
Apple macOS バイナリをビルドするアーキテクチャのカンマ区切りリスト。
タグ: loses_incremental_stateloading_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_nここで、regex_filter は正規表現パターンを含むリストと除外するパターンのリストを表します(-instrumentation_filter もご覧ください)。option_1 から option_n は任意のコマンドライン オプションを表します。オプションにカンマが含まれる場合は、バックスラッシュで囲む必要があります。オプションには @ を含めることができます。最初の @ のみが文字列の分割に使用されます。例: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 は、//foo/ 内のすべての cc ファイル(bar.cc を除く)の gcc コマンドラインに -O0 コマンドラインオプションを追加します。
タグ: action_command_linesaffects_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> 回の使用が累積されています
特定のバックエンド オブジェクトをコンパイルするときに、(--features=thin_lto にある)LTO バックエンドに選択的に渡す追加のオプション。このオプションは複数回渡すことができます。構文: regex_filter@option_1,option_2,...,option_nここで regex_filter は正規表現パターンのリストを表し、option_1 から option_n は任意のコマンドライン オプションを表します。オプションにカンマが含まれる場合は、バックスラッシュで囲む必要があります。オプションには @ を含めることができます。最初の @ のみが文字列の分割に使用されます。例: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 は、//foo/ 内のすべての o ファイル(bar.o を除く)の LTO バックエンドコマンドラインに -O0 コマンドラインオプションを追加します。
タグ: action_command_lines, affects_outputs
--platform_suffix=<a string> のデフォルト: 説明を参照
構成ディレクトリに追加する接尾辞を指定します。
タグ: loses_incremental_stateaffects_outputsloading_and_analysis
--propeller_optimize=<a build target label> のデフォルト: 説明を参照
Propeller のプロファイル情報を使用して、ビルド ターゲットを最適化します。Propeller のプロファイルは、cc プロファイルと ld プロファイルの 2 つのファイルのうち少なくとも 1 つで構成する必要があります。このフラグには、プロペラ プロファイル入力ファイルを参照する必要があるビルドラベルを指定できます。たとえば、a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",) でラベルを定義する BUILD ファイルでは、Bazel でファイルを可視化できるように、対応するパッケージにディレクティブを追加する必要があります。このオプションは次のように使用する必要があります。--propeller_optimize=//a/b:propeller_profile
タグ: action_command_linesaffects_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
--[no]share_native_deps のデフォルト: "true"
true の場合、同じ機能を含むネイティブ ライブラリが複数のターゲット間で共有されます
タグ: loading_and_analysisaffects_outputs
--[no]stamp のデフォルト: "false"
日付、ユーザー名、ホスト名、ワークスペース情報などを含むバイナリをスタンプします。
タグ: affects_outputs
--strip=<always, sometimes or never> のデフォルト: 「発生することがある」
バイナリと共有ライブラリを削除するかどうかを指定します(「-Wl、--strip-debug」を使用)。「nottimes」のデフォルト値は、--compile_mode=fastbuild のみを削除します。
タグ: affects_outputs
--stripopt=<a string> 回の使用が累積されています
「<name>.stripped」バイナリの生成時に削除に渡す追加オプション。
タグ: action_command_linesaffects_outputs
--swiftcopt=<a string> 回の使用が累積されています
Swift コンパイルに渡す追加オプション。
タグ: action_command_lines
--tvos_cpus=<comma-separated list of options> 回の使用が累積されています
Apple tvOS バイナリをビルドするアーキテクチャのカンマ区切りのリスト。
タグ: loses_incremental_stateloading_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_stateloading_and_analysis
--watchos_cpus=<comma-separated list of options> 回の使用が累積されています
Apple watchOS バイナリをビルドする対象アーキテクチャのカンマ区切りリスト。
タグ: loses_incremental_stateloading_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_inputsloading_and_analysisexperimental
--[no]check_licenses のデフォルト: "false"
依存パッケージによるライセンスの制約が、ビルド中のターゲットの配布モードと競合していないことを確認してください。デフォルトでは、ライセンスはチェックされていません。
タグ: build_file_semantics
--[no]check_visibility のデフォルト: "true"
無効にすると、ターゲット依存関係の可視性エラーは警告に降格されます。
タグ: build_file_semantics
--[no]desugar_for_android のデフォルト: "true"
dex 変換の前に Java 8 バイトコードを desugar するかどうか。
タグ: affects_outputsloading_and_analysisloses_incremental_state
--[no]desugar_java8_libs のデフォルト: "false"
レガシー デバイス向けのアプリにサポートされている Java 8 ライブラリを含めるかどうかを指定します。
タグ: affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[no]enforce_constraints のデフォルト: "true"
各ターゲットが対応している環境を確認し、ターゲットに同じ環境をサポートしていない依存関係がある場合はエラーを報告します
タグ: build_file_semantics
--[no]experimental_check_desugar_deps のデフォルト: "true"
Android バイナリレベルで正しい desugar を再確認するかどうか。
タグ: eagerness_to_exitloading_and_analysisexperimental
--experimental_import_deps_checking=<off, warning or error> のデフォルト: 「OFF」
有効にすると、aar_import の依存関係が完了しているかどうかを確認します。この適用により、ビルドが中断されたり、警告が表示されたりする場合があります。
タグ: loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default> のデフォルト: "default"
true の場合、Java ターゲットが、直接使用されるすべてのターゲットを依存関係として明示的に宣言していることを確認します。
タグ: build_file_semanticseagerness_to_exit
--[no]incompatible_check_testonly_for_output_files のデフォルト: "false"
有効になっている場合は、生成ルールの testonly を検索して、出力ファイルである前提条件ターゲットについて testonly をチェックします。これは公開設定の確認と一致します。
タグ: build_file_semanticsincompatible_change
--[no]incompatible_check_visibility_for_toolchains のデフォルト: "false"
有効にすると、ツールチェーンの実装にも可視性チェックが適用されます。
タグ: build_file_semanticsincompatible_change
--[no]incompatible_disable_native_android_rules のデフォルト: "false"
有効にすると、ネイティブ Android ルールの直接使用が無効になります。https://github.com/bazelbuild/rules_android にある Starlark Android ルールを使用してください
タグ: eagerness_to_exitincompatible_change
--[no]incompatible_disable_native_apple_binary_rule のデフォルト: "false"
NoOps。下位互換性のためにここに保持されています。
タグ: eagerness_to_exitincompatible_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_analysisincompatible_change
--[no]incompatible_validate_top_level_header_inclusions のデフォルト: "true"
true の場合、Bazel はトップレベル ディレクトリ ヘッダーの包含も検証します(詳しくは、https://github.com/bazelbuild/bazel/issues/10047 をご覧ください)。
タグ: loading_and_analysisincompatible_change
--python_native_rules_allowlist=<a build target label> のデフォルト: 説明を参照
--compatibility_python_disallow_native_rules を適用するときに使用する許可リスト(package_group ターゲット)。
タグ: loading_and_analysis
--[no]strict_filesets のデフォルト: "false"
このオプションを有効にすると、パッケージの境界を越えるファイルセットがエラーとして報告されます。
タグ: build_file_semanticseagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default> のデフォルト: "error"
オフの場合を除き、proto_library ターゲットが、直接使用されるすべてのターゲットを依存関係として明示的に宣言していることを確認します。
タグ: build_file_semanticseagerness_to_exitincompatible_change
--strict_public_imports=<off, warn, error, strict or default> のデフォルト: 「off」
オフの場合を除き、「import public」で使用されるすべてのターゲットが、proto_library ターゲットでエクスポート済みとして明示的に宣言されていることを確認します。
タグ: build_file_semanticseagerness_to_exitincompatible_change
--[no]strict_system_includes のデフォルト: "false"
true の場合、システム インクルード パス(-isystem)を通じて検出されたヘッダーも宣言する必要があります。
タグ: loading_and_analysiseagerness_to_exit
--target_environment=<a build target label> 回の使用が累積されています
このビルドのターゲット環境を宣言します。「環境」ルールへのラベル参照にする必要があります。指定する場合、すべてのトップレベル ターゲットがこの環境と互換性がある必要があります。
タグ: changes_inputs
ビルドの署名出力に影響するオプション:
--apk_signing_method=<v1, v2, v1_v2 or v4> のデフォルト: "v1_v2"
APK の署名に使用する実装
タグ: action_command_linesaffects_outputsloading_and_analysis
--[no]device_debug_entitlements のデフォルト: "true"
設定されている場合、コンパイル モードが「opt」でない場合、objc アプリは署名時にデバッグ資格を含めます。
タグ: changes_inputs
--ios_signing_cert_name=<a string> のデフォルト: 説明を参照
iOS 署名に使用する証明書名。設定しない場合、プロビジョニング プロファイルにフォールバックします。証明書のキーチェーン ID 設定、または共同署名の man ページ(署名 ID)に従って証明書の共通名の(部分文字列)を指定できます。
タグ: action_command_lines
このオプションは、BUILD ファイル、.bzl ファイル、WORKSPACE ファイルからアクセス可能な Starlark 言語またはビルド API のセマンティクスに影響します。
--[no]incompatible_disallow_legacy_py_provider のデフォルト: "true"
NoOps(オペレーションなし)はまもなく削除されます。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes のデフォルト: "false"
true の場合、objc_library と objc_import で sdk_frameworks 属性と weak_sdk_frameworks 属性を禁止します。
タグ: build_file_semanticsincompatible_change
true の場合、objc_library と objc_import の alwayslink 属性のデフォルト値を true にします。
タグ: build_file_semanticsincompatible_change
--[no]incompatible_python_disallow_native_rules のデフォルト: "false"
true の場合、組み込みの py_* ルールを使用するとエラーが発生します。代わりに、rule_python ルールを使用する必要があります。詳細と移行手順については、https://github.com/bazelbuild/bazel/issues/17773 をご覧ください。
タグ: loading_and_analysisincompatible_change
テスト環境またはテストランナーの動作を管理するオプション:
--[no]allow_analysis_failures のデフォルト: "false"
true の場合、ルール ターゲットの分析が失敗すると、ビルド失敗ではなく、エラーの説明を含む AnalysisFailureInfo のインスタンスがターゲットに伝播されます。
タグ: loading_and_analysisexperimental
--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_analysisexperimental
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g. memory=10,30,60,100> 回の使用が累積されています
テストのデフォルトのリソース量をオーバーライドします。想定される形式は <resource>=<value> です。1 つの正の数値を <value> として指定すると、すべてのテストサイズのデフォルトのリソースがオーバーライドされます。4 つのカンマ区切りの数値を指定すると、テストサイズの小、中、大、巨大それぞれのリソース量がオーバーライドされます。値は HOST_RAM または HOST_CPU で、オプションで [-|*]<float> が後に続く場合もあります(例: memory=HOST_RAM*.1, HOST_RAM*.2, HOST_RAM*.3, HOST_RAM*.4)。このフラグで指定されたデフォルトのテストリソースは、タグで指定された明示的なリソースによってオーバーライドされます。
--[no]experimental_android_use_parallel_dex2oat のデフォルト: "false"
dex2oat を並行して使用すると、android_test を高速化できます。
タグ: loading_and_analysishost_machine_resource_optimizationsexperimental
--[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_test。run_per_test は整数値を表し、regex_filter は包含および除外正規表現パターンのリストを表します(--instrumentation_filter もご覧ください)。例: --runs_per_test=//foo/.*,-//foo/bar/.*@3 は、foo/bar の下にあるテストを除く //foo/内のすべてのテストを 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」(デフォルト)は、直接依存関係のルールクラスが指定されているかどうかに関係なく、宣言されたすべてのアスペクト依存関係が追加されることを意味します。「precise」は、直接依存関係のルールクラスでアクティブになる可能性のあるアスペクトのみが追加されることを意味します。なお、高精度モードでは、1 つのターゲットを評価するために他のパッケージを読み込む必要があるため、他のモードよりも時間がかかります。また、正確なモードでさえも完全に正確というわけではありません。アスペクトを計算するかどうかの決定は、分析フェーズで決定され、「Bazel クエリ」中には実行されません。
タグ: build_file_semantics
--[no]consistent_labels のデフォルト: "false"
有効にすると、すべてのクエリコマンドは <code>Label</code> インスタンスに適用される Starlark <code>str</code> 関数と同様にラベルを出力します。これは、さまざまなクエリコマンドやルールによって出力されたラベルの出力を照合する必要があるツールに役立ちます。有効になっていない場合、出力フォーマッタは、出力を読みやすくするために(メイン リポジトリからの相対的な)明らかなリポジトリ名を自由に出力できます。
タグ: terminal_output
--[no]experimental_explicit_aspects のデフォルト: "false"
aquery, cquery: アスペクトで生成されたアクションを出力に含めるかどうかクエリ: no-op(アスペクトは常に従う)
タグ: 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: アスペクトで生成されたアクションを出力に含めるかどうかクエリ: 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"
コマンドで使用される param ファイルの内容(大きな可能性もあります)を含めます。注: このフラグを有効にすると、--include_commandline フラグが自動的に有効になります。
タグ: terminal_output
--[no]incompatible_package_group_includes_double_slash のデフォルト: "true"
有効にすると、package_group の `packages` 属性を出力するときに、先頭の `//` が省略されません。
タグ: terminal_outputincompatible_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"
クエリ結果を出力する形式。aquery で指定できる値は、text、textproto、proto、streamed_proto、jsonproto です。
タグ: terminal_output
--[no]proto:default_values のデフォルト: "true"
true の場合、値が明示的に指定されていない属性が含まれます。それ以外の場合は、省略されます。このオプションは --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> のデフォルト: ""
設定すると、query はコマンドラインではなく、ここで指定したファイルからクエリを読み取ります。ここにファイルとコマンドライン クエリを指定するとエラーになります。
タグ: 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"
クエリ: 無効にすると、「exec configuration」への依存関係は、クエリが動作する依存関係グラフに含まれません。任意の「proto_library」ルールからプロトコル コンパイラへの依存関係エッジなど、「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_analysisexecutionaffects_outputsexperimental
--[no]experimental_inmemory_jdeps_files のデフォルト: "true"
有効にすると、Java コンパイルで生成された依存関係(.jdeps)ファイルは、ディスクに書き込まれるのではなく、リモート ビルドノードからメモリ内で直接渡されます。
タグ: loading_and_analysisexecutionaffects_outputsexperimental
--[no]experimental_objc_include_scanning のデフォルト: "false"
目的の C/C++ のインクルード スキャンを実行するかどうか。
タグ: loading_and_analysisexecutionchanges_inputs
--[no]experimental_retain_test_configuration_across_testonly のデフォルト: "false"
--trim_test_configuration を有効にすると、testonly=1 とマークされたルールのテスト設定はトリミングされません。これは、テスト以外のルールが cc_test ルールに依存している場合に、アクションの競合の問題を減らすためです。--trim_test_configuration が false の場合は効果がありません。
タグ: loading_and_analysisloses_incremental_state
--[no]experimental_starlark_cc_import のデフォルト: "false"
有効にすると、Starlark バージョンの cc_import を使用できます。
タグ: loading_and_analysisexperimental
--[no]experimental_unsupported_and_brittle_include_scanning のデフォルト: "false"
入力ファイルの #include 行を解析して C/C++ コンパイルへの入力を絞り込むかどうかを指定します。これにより、コンパイル入力ツリーのサイズを小さくすることで、パフォーマンスとインクリメンタリティを向上させることができます。ただし、インクルード スキャナは C プリプロセッサ セマンティクスを完全には実装していないため、ビルドが破損する可能性もあります。特に、動的な #include ディレクティブは認識されず、プリプロセッサの条件付きロジックは無視されます。自己責任で使用してください。このフラグに関連する問題はすべてクローズされます。
タグ: loading_and_analysisexecutionchanges_inputs
--[no]incremental_dexing のデフォルト: "true"
ほとんどの処理は、Jar ファイルごとに個別に dex 変換を行います。
タグ: affects_outputsloading_and_analysisloses_incremental_state
--[no]objc_use_dotd_pruning のデフォルト: "true"
設定すると、clang によって出力された .d ファイルを使用して、objc コンパイルに渡される入力のセットがプルーニングされます。
タグ: changes_inputsloading_and_analysis
--[no]process_headers_in_dependencies のデフォルト: "false"
ターゲット //a:a をビルドするときに、//a:a が依存するすべてのターゲットでヘッダーを処理します(ツールチェーンでヘッダー処理が有効になっている場合)。
タグ: execution
--[no]trim_test_configuration のデフォルト: "true"
有効にすると、ビルドのトップレベルの下でテスト関連のオプションが消去されます。このフラグを有効にすると、テストを非テストルールの依存関係としてビルドすることはできませんが、テスト関連のオプションを変更してもテスト以外のルールが再分析されることはありません。
タグ: loading_and_analysisloses_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 ターゲットの runfile で __init__.py ファイルが自動的に作成されないようにします。正確には、py_binary または py_test のターゲットで legacy_create_init が「auto」(デフォルト)に設定されている場合、このフラグが設定されている場合にのみ false として扱われます。https://github.com/bazelbuild/bazel/issues/10076 をご覧ください。
タグ: affects_outputsincompatible_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_outputsincompatible_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_analysisaffects_outputsincompatible_change
--[no]incompatible_use_python_toolchains のデフォルト: "true"
true に設定すると、実行可能なネイティブの Python ルールは、--python_top などの以前のフラグで指定されたランタイムではなく、Python ツールチェーンで指定された Python ランタイムを使用します。
タグ: loading_and_analysisincompatible_change
--python_version=<PY2 or PY3> のデフォルト: 説明を参照
Python メジャー バージョン モード(PY2 または PY3)。これは py_binary ターゲットと py_test ターゲットによってオーバーライドされるため(バージョンを明示的に指定していない場合でも)、通常はこのフラグを指定する理由はほとんどありません。
タグ: loading_and_analysisaffects_outputs
その他のオプション(特に分類されていない)。
--[no]cache_test_results [-t] デフォルト: "auto"
「auto」に設定すると、(1)Bazel がテストまたはその依存関係の変更を検出した、(2)テストが外部としてマークされている、(3)複数のテスト実行が --runs_per_test でリクエストされた、(4)テストが失敗した場合にのみ、Bazel はテストを再実行します。「yes」に設定した場合、Bazel は「外部」とマークされたテストを除くすべてのテスト結果をキャッシュに保存します。「no」に設定した場合、Bazel はテスト結果をキャッシュに保存しません。
--[no]experimental_cancel_concurrent_tests のデフォルト: "false"
true の場合、Blaze は最初に正常に実行された際に同時に実行中のテストをキャンセルします。これは、--runs_per_test_detects_flakes と組み合わせた場合にのみ有効です。
タグ: affects_outputsloading_and_analysis
--[no]experimental_fetch_all_coverage_outputs のデフォルト: "false"
true の場合、Bazel はカバレッジの実行中にテストごとにカバレッジ データ ディレクトリ全体を取得します。
タグ: affects_outputsloading_and_analysis
--[no]experimental_generate_llvm_lcov のデフォルト: "false"
true の場合、clang のカバレッジにより LCOV レポートが生成されます。
タグ: affects_outputsloading_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_analysisincompatible_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_outputsloading_and_analysis
--proto_toolchain_for_cc=<a build target label> のデフォルト: "@bazel_tools//tools/proto:cc_ツールチェーン"
C++ proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル。
タグ: affects_outputsloading_and_analysis
--proto_toolchain_for_j2objc=<a build target label> のデフォルト: "@bazel_tools//tools/j2objc:j2objc_proto_ツールチェーン"
j2objc proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル。
タグ: affects_outputsloading_and_analysis
--proto_toolchain_for_java=<a build target label> のデフォルト: "@bazel_tools//tools/proto:java_ツールチェーン"
Java proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル
タグ: affects_outputsloading_and_analysis
--proto_toolchain_for_javalite=<a build target label> のデフォルト: "@bazel_tools//tools/proto:javalite_ツールチェーン"
JavaLite proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル。
タグ: affects_outputsloading_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> のデフォルト: 「AutoML」
テストのシャーディングの戦略を指定します。「shard_count」BUILD 属性が存在する場合にのみシャーディングを使用する「明示的な」を指定します。テストのシャーディングを使用しないように「disabled」に設定します。「forced=k」は、「shard_count」ビルド属性に関係なく、テスト用の「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
設定すると、キャッシュ ヒットが発生した場合、リポジトリ キャッシュはファイルをコピーするのではなくハードリンクします。これはディスク容量を節約するためのものです。
タグ: bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer> のデフォルト: 「0」
ダウンロード エラーの再試行の最大試行回数。0 に設定すると、再試行が無効になります。
タグ: experimental
--experimental_scale_timeouts=<a double> のデフォルト: 「1.0」
Starlark リポジトリ ルールのすべてのタイムアウトを、この係数でスケーリングします。このようにして、ソースコードを変更することなく、ルール作成者の想定よりも遅いマシンで外部リポジトリを動作させることができます。
タグ: bazel_internal_configurationexperimental
--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
--[no]incompatible_disable_native_repo_rules のデフォルト: "false"
false の場合、ネイティブ リポジトリ ルールを WORKSPACE で使用できます。それ以外の場合は、代わりに Starlark リポジトリ ルールを使用する必要があります。ネイティブ リポジトリのルールには、local_repository、new_local_repository、local_config_platform、android_sdk_repository、android_ndk_repository があります。
タグ: bazel_internal_configuration
--repository_cache=<a path> のデフォルト: 説明を参照
外部リポジトリの取得中に取得されたダウンロード値のキャッシュの場所を指定します。引数として空の文字列を指定すると、キャッシュの無効化がリクエストされます。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます
タグ: bazel_internal_configuration
--[no]repository_disable_download のデフォルト: "false"
設定した場合、リポジトリの取得中に gke.download{,_and_extract} を使用したダウンロードは許可されません。ネットワーク アクセスは完全には無効にはなりません。インターネットにアクセスする任意の実行可能ファイルを gsuite.execute で実行できます。
タグ: bazel_internal_configuration
ビルド実行を制御するオプション:
--[no]check_up_to_date のデフォルト: "false"
ビルドは実行せず、最新版かどうかを確認するだけです。すべてのターゲットが最新である場合、ビルドは正常に完了します。実行する必要があるステップがある場合は、エラーが報告され、ビルドは失敗します。
タグ: execution
--dynamic_local_execution_delay=<an integer> のデフォルト: 「1000」
ビルド中のリモート実行が 1 回以上速くなった場合、ローカル実行を何ミリ秒遅延する必要がありますか?
タグ: executionhost_machine_resource_optimizations
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment> 回の使用が累積されています
特定のニモニックで使用するために順番にローカル戦略 - 最初に適用可能な戦略が使用されます。たとえば、「worker,sandboxed」は、ワーカー戦略を使用して永続ワーカーをサポートするアクションを実行し、その他のすべてのアクションはサンドボックス戦略を使用して実行します。ニーモニックが指定されていない場合は、戦略のリストがすべてのニーモニックのフォールバックとして使用されます。「experimental_local_lockfree_output」が設定されている場合、デフォルトのフォールバック リストは「worker,sandboxed」または「worker,sandboxed,スタンドアロン」です。[mnemonic=]local_strategy[,local_strategy,...] を使用します。
タグ: executionhost_machine_resource_optimizations
--dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment> 回の使用が累積されています
リモート戦略は、指定されたニモニックに使用するために順番に、最初に適用可能な戦略が使用されます。ニーモニックが指定されていない場合は、戦略のリストがすべてのニーモニックのフォールバックとして使用されます。デフォルトのフォールバック リストは `remote` であるため、通常、このフラグを明示的に設定する必要はありません。[mnemonic=]remote_strategy[,remote_strategy,...] が使用されます。
タグ: executionhost_machine_resource_optimizations
--experimental_docker_image=<a string> のデフォルト: ""
Docker イメージ名(例: ubuntu:latest)を指定します。これは、Docker 戦略を使用して、プラットフォームの説明の 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"
設定すると、「ツール用」のビルドターゲットは動的実行の対象になりません。このようなターゲットは段階的に構築される可能性が非常に低いため、ローカル サイクルに投資する価値がありません。
タグ: executionhost_machine_resource_optimizations
--experimental_dynamic_local_load_factor=<a double> のデフォルト: 「0」
動的実行によってローカルマシンにかかる負荷を制御します。このフラグは、動的実行で同時にスケジュールするアクションの数を調整します。これは、Blaze が使用可能と判断した CPU の数に基づいており、--local_cpu_resources フラグを使用して制御できます。 このフラグが 0 の場合、すべてのアクションが直ちにローカルでスケジュールされます。0 より大きい場合、ローカルでスケジュールされるアクションの数は、使用可能な CPU の数によって制限されます。1 未満の場合、スケジューリングを待機しているアクションの数が多くなったときに、負荷係数を使用してローカルでスケジュールされるアクションの数を減らします。これにより、クリーンビルドのケースではローカルマシンの負荷が軽減されます。このケースでは、ローカルマシンはあまり関与しません。
タグ: executionhost_machine_resource_optimizations
--experimental_dynamic_slow_remote_time=<An immutable length of time.> のデフォルト: 「0」
0 より大きい場合、リモート タイムアウトを回避するため、動的に実行されるアクションをリモートでのみ実行してから、ローカル実行を優先する必要があります。これにより、リモート実行システムの問題の一部が隠れてしまう可能性があります。リモート実行の問題をモニタリングすることなく、これを有効にしないでください。
タグ: executionhost_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_optimizationsexecution
--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"
有効にすると、ワーカーメモリの負荷が高い場合にワーカープールを縮小できます。このフラグは、フラグ experiment_total_worker_memory_limit_mb が有効な場合にのみ機能します。
タグ: executionhost_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」
この上限が 0 より大きい場合、すべてのワーカーの合計メモリ使用量が上限を超えると、アイドル状態のワーカーが強制終了される可能性があります。
タグ: executionhost_machine_resource_optimizations
--[no]experimental_use_hermetic_linux_sandbox のデフォルト: "false"
true に設定した場合、root をマウントせず、sandbox_add_mount_pair で指定されたもののみをマウントします。入力ファイルは、サンドボックスからシンボリック リンクされるのではなく、サンドボックスにハードリンクされます。アクションの入力ファイルがサンドボックスとは異なるファイル システムにある場合、入力ファイルがコピーされます。
タグ: execution
--[no]experimental_use_semaphore_for_jobs のデフォルト: "true"
true に設定した場合は、さらにセマフォを使用して同時実行ジョブの数を制限します。
タグ: host_machine_resource_optimizationsexecution
--[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> のデフォルト: 説明を参照
空でない場合は、指定されたワーカーキーのニーモニックを持つ永続ワーカーのみの使用を許可します。
タグ: executionhost_machine_resource_optimizations
--[no]experimental_worker_as_resource のデフォルト: "true"
NoOps(オペレーションなし)はまもなく削除されます。
タグ: 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」と一緒に使用しないと、ビルドがクラッシュする可能性があります。
タグ: executionhost_machine_resource_optimizations
--experimental_worker_metrics_poll_interval=<An immutable length of time.> のデフォルト: 「5s」
ワーカー指標の収集からエビクションの試行までの間隔。パフォーマンス上の理由から、実質的に 1 秒未満にする必要があります。
タグ: executionhost_machine_resource_optimizations
--[no]experimental_worker_multiplex_sandboxing のデフォルト: "false"
有効にすると、Multiplex ワーカーがサンドボックス化され、作業リクエストごとに個別のサンドボックス ディレクトリが使用されます。「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> 回の使用が累積されています
NoOps(オペレーションなし)はまもなく削除されます。
タグ: execution
true に設定すると、リモート キャッシュまたはディスク キャッシュにアップロードされたシンボリック リンクはダングルできます。
タグ: executionincompatible_change
true に設定すると、Bazel は常にリモート キャッシュやディスク キャッシュにシンボリック リンクをアップロードします。それ以外の場合、ダングリングしていない相対シンボリック リンク(およびそれらのみ)が、そのリンクが指すファイルまたはディレクトリとしてアップロードされます。
タグ: executionincompatible_change
--[no]incompatible_sandbox_hermetic_tmp のデフォルト: "true"
true に設定すると、Linux サンドボックスごとに専用の空のディレクトリが /tmp としてマウントされます。/tmp がホストのファイル システムと共有されることはありません。--sandbox_add_mount_pair=/tmp を使用して、すべてのサンドボックスでホストの /tmp を引き続き確認します。
タグ: execution
--[no]internal_spawn_scheduler のデフォルト: "false"
Spawn スケジューラが有効かどうかを Blaze で判断するためのプレースホルダ オプション。
タグ: executionhost_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] デフォルト: "auto"
実行する同時実行ジョブの数。整数またはキーワード("auto"、"HOST_CPUS"、"HOST_RAM")を取り、必要に応じてその後に演算([-|*]<float>)が続きます(例:"auto"、"HOST_CPUS*.5" のように指定します。値は 1 ~ 5,000 の範囲で指定してください。値が 2,500 を超えると、メモリの問題が発生する可能性があります。「auto」に設定すると、ホストリソースに基づいて適切なデフォルト値が計算されます。
タグ: host_machine_resource_optimizationsexecution
--[no]keep_going [-k] デフォルト: "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_optimizationsexecution
--sandbox_base=<a string> のデフォルト: ""
サンドボックスはこのパスの下にサンドボックス ディレクトリを作成します。ビルドやテストで多数の入力ファイルがある場合にパフォーマンスを大幅に改善できるように、tmpfs 上のパス(/run/shm など)を指定します。注: アクションの実行によって生成された出力ファイルと中間ファイルを保持するには、tmpfs に十分な RAM と空き容量が必要です。
タグ: host_machine_resource_optimizationsexecution
--[no]sandbox_explicit_pseudoterminal のデフォルト: "false"
サンドボックス化されたアクション用の疑似ターミナルの作成を明示的に有効にします。一部の Linux ディストリビューションでは、擬似ターミナルが機能するために、サンドボックス内でプロセスのグループ ID を「tty」に設定する必要があります。これが問題の原因である場合は、このフラグを無効にして、他のグループを使用できるようにします。
タグ: execution
--sandbox_tmpfs_path=<an absolute path> 回の使用が累積されています
サンドボックス化されたアクションでは、この絶対パスに空の書き込み可能なディレクトリをマウントします(サンドボックス化の実装でサポートされている場合は無視され、それ以外の場合は無視されます)。
タグ: host_machine_resource_optimizationsexecution
--[no]skip_incompatible_explicit_targets のデフォルト: "false"
コマンドラインで明示的にリストされている互換性のないターゲットはスキップします。このようなターゲットをビルドすると、デフォルトではエラーになりますが、このオプションを有効にすると通知なくスキップされます。参照: https://bazel.build/extending/platforms#skipping-compatible-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> 回の使用が累積されています
他の Spawn アクションのコンパイルを分散する方法を指定します。優先度が最も高いものから低いものの順に、戦略をカンマで区切ったリストを指定できます。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 に一致する説明を持つスポーン アクションの実行に使用するスポーン戦略をオーバーライドします。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)です。
タグ: executionhost_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」は、指定されていないニーモニックのデフォルトを設定します。
タグ: executionhost_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」は、指定されていないニーモニックのデフォルトを設定します。
タグ: executionhost_machine_resource_optimizations
--[no]worker_multiplex のデフォルト: "true"
有効にすると、ワーカーは多重化を使用します(サポートしている場合)。
タグ: executionhost_machine_resource_optimizations
--[no]worker_quit_after_build のデフォルト: "false"
有効にすると、ビルドの完了後にすべてのワーカーが終了します。
タグ: executionhost_machine_resource_optimizations
--[no]worker_sandboxing のデフォルト: "false"
有効にすると、ワーカーはサンドボックス環境で実行されます。
タグ: execution
--[no]worker_verbose のデフォルト: "false"
有効にすると、ワーカーの開始時やシャットダウン時などに詳細メッセージが出力されます。
アクションの実行に使用するツールチェーンを構成するオプション:
--target_platform_fallback=<a string> のデフォルト: ""
このオプションは非推奨になっており、効果はありません。
タグ: affects_outputschanges_inputsloading_and_analysis
コマンドの出力を制御するオプション:
--[no]build のデフォルト: "true"
ビルドを実行します。これは通常の動作です。--nobuild を指定すると、ビルド アクションを実行する前にビルドが停止し、パッケージの読み込みと分析のフェーズが正常に完了するとゼロが返されます。このモードは、これらのフェーズをテストする場合に便利です。
タグ: executionaffects_outputs
--[no]experimental_use_validation_aspect のデフォルト: "false"
アスペクトを使用して検証アクションを実行するかどうかを指定します(テストとの並列処理用)。
タグ: executionaffects_outputs
--output_groups=<comma-separated list of options> 回の使用が累積されています
カンマ区切りの出力グループ名のリスト。それぞれの先頭に + または - が付加されます。接頭辞 + のグループはデフォルトの出力グループに追加され、- のグループはデフォルトのセットから削除されます。接頭辞が付いていないグループが 1 つもない場合、デフォルトの出力グループ セットは省略されます。たとえば、--output_groups=+foo,+bar はデフォルト セット、foo、bar の結合を構築し、--output_groups=foo,bar はデフォルト セットをオーバーライドして、foo と bar のみがビルドされるようにします。
タグ: executionaffects_outputs
--[no]run_validations のデフォルト: "true"
ビルドの一部として検証アクションを実行するかどうかを指定します。https://bazel.build/extending/rules#validation_actions
タグ: executionaffects_outputs
ユーザーが目的の出力を構成し、その出力の有無ではなく値に影響を与えるオプション:
--aspects=<comma-separated list of options> 回の使用が累積されています
トップレベル ターゲットに適用されるアスペクトのカンマ区切りのリスト。リストで、アスペクト some_aspect が required_aspect_providers を介して必須のアスペクト プロバイダを指定している場合、アスペクト リスト内ですでに言及されているすべてのアスペクトの後に some_aspect が実行され、アドバタイズされたプロバイダが some_aspect の必須のアスペクト プロバイダを満たしている。さらに、some_aspect は require 属性で指定されたすべての必須アスペクトの後に実行されます。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
このフラグは、コンビニエンス シンボリック リンク(ビルド後にワークスペースに表示されるシンボリック リンク)の管理方法を制御します。可能な値: normal(デフォルト): コンビニエンスの各種類のシンボリック リンクが、ビルドによって作成または削除されます。 clean: すべてのシンボリック リンクが無条件に削除されます。ignore: シンボリック リンクが残ります。log_only: 「normal」が渡されたかのようにログメッセージを生成しますが、実際にはファイルシステム オペレーションは実行しません(ツールの場合に役立ちます)。 影響を受けるのは、--symlink_prefix の現在の値によって名前が生成されたシンボリック リンクのみです。接頭辞が変更されても、既存のシンボリック リンクはそのまま残ります。
タグ: affects_outputs
このフラグは、ビルド イベント ConvenienceSymlinksIdentified を 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
リモートビルドの出力をローカルマシンにダウンロードするのではなく、シンボリック リンクを作成します。シンボリック リンクのターゲットは、テンプレート文字列の形式で指定できます。このテンプレート文字列には、オブジェクトのハッシュに展開される {hash} と {size_bytes} が含まれることがあります。サイズはそれぞれバイト単位になります。これらのシンボリック リンクは、たとえば CAS からオンデマンドでオブジェクトを読み込む FUSE ファイル システムを指す場合があります。
タグ: affects_outputs
--remote_download_toplevel
最上位のターゲットのリモート出力のみをローカルマシンにダウンロードします。このフラグは、--remote_download_outputs=toplevel のエイリアスです。
展開先:
  --remote_download_outputs=toplevel

タグ: affects_outputs
ビルド後に作成されるコンビニエンス シンボリック リンクの先頭に付加される接頭辞。省略した場合のデフォルト値は、ビルドツールの名前の後にハイフンを付けたものです。「/」が渡されると、シンボリック リンクは作成されず、警告も出力されません。警告: 「/」の特別な機能はまもなく非推奨になります。代わりに --experimental_convenience_symlinks=ignore を使用してください。
タグ: affects_outputs
Bazel による有効なビルド入力の適用度合いに影響するオプション(ルール定義、フラグの組み合わせなど):
--[no]experimental_docker_privileged のデフォルト: "false"
有効にすると、Bazel はアクションの実行時に --privileged フラグを「docker run」に渡します。ビルドでこれが必要になる場合もありますが、密閉性が低下する可能性もあります。
タグ: execution
NoOps
タグ: host_machine_resource_optimizationsexecution
--[no]incompatible_legacy_local_fallback のデフォルト: "false"
true に設定すると、サンドボックス化からローカル戦略への従来の暗黙的なフォールバックが有効になります。このフラグは最終的にデフォルトで false になり、NoOps になります。フォールバックを構成するには、--strategy、--spawn_strategy、または --dynamic_local_strategy を使用します。
タグ: executionincompatible_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 言語またはビルド API のセマンティクスに影響します。
--[no]incompatible_config_setting_private_default_visibility のデフォルト: "false"
Compatibility_enforce_config_setting_visibility=false は、NoOps です。それ以外の場合、このフラグが false の場合、明示的な公開設定属性のない config_setting はすべて //visibility:public です。このフラグが true の場合、config_setting は他のすべてのルールと同じ公開設定ロジックに従います。https://github.com/bazelbuild/bazel/issues/12933 をご覧ください。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_enforce_config_setting_visibility のデフォルト: "true"
true の場合、config_setting の公開設定制限を適用します。false の場合、すべての config_setting がすべてのターゲットに表示されます。https://github.com/bazelbuild/bazel/issues/12932 をご覧ください。
タグ: loading_and_analysisincompatible_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> 回の使用が累積されています
テストに不合格となった場合、各テストは指定された回数まで再試行されます。複数回の合格が求められたテストは、テストの概要で「FLAKY」と表示されます。通常、指定される値は単なる整数または文字列「default」です。整数の場合、すべてのテストは最大 N 回実行されます。「default」の場合、通常のテストに対しては 1 回だけテストが試行され、ルール(flaky=1 属性)によって「不安定」とマークされたテストは 3 回試行されます。別の構文: regex_filter@flaky_test_attempts。ここで、flaky_test_attempts は上記のとおり、regex_filter は include および除外正規表現パターンのリストを表します(--runs_per_test もご覧ください)。例: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 は、foo/bar の下のテストを除く //foo/内のすべてのテストをデフレークします。このオプションは複数回渡すことができます。最後に渡された引数のうち、一致するものが優先されます。何も一致しない場合、上記の「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"
NoOps。
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, refresh or error> のデフォルト: "update"
ロックファイルの使用方法と使用方法を指定します。有効な値は、ロックファイルを使用して変更があった場合に更新する「update」、リモート レジストリから変更可能な情報(ヤンクされたバージョンや以前に欠落したモジュール)を随時更新する「refresh」、ロックファイルを使用するが最新でない場合にエラーをスローする「error」、ロックファイルの読み取り / 書き込みを行わない場合は「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
--vendor_dir=<a path> のデフォルト: 説明を参照
外部リポジトリをベンダーモードで保持するディレクトリを指定します。これは、外部リポジトリを取得する目的で、またはビルド中に外部リポジトリを使用するためです。パスは、絶対パスまたはワークスペース ディレクトリへの相対パスで指定できます。
タグ: loading_and_analysis
ビルド時間の最適化をトリガーするオプション:
--cache_computed_file_digests=<a long integer> のデフォルト: 「50000」
0 より大きい場合、必要になるたびにディスクからダイジェストを再計算するのではなく、メタデータに基づいてファイル ダイジェストをメモリにキャッシュするように Bazel を構成します。これを 0 に設定すると、すべてのファイルの変更がファイルのメタデータから把握できるわけではないため、正確性が保証されます。0 以外の場合、この値は、キャッシュするファイル ダイジェストの数としてキャッシュのサイズを示します。
--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 は正の整数です。<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 コアの半分を使用します)。デフォルト(「HOST_CPUS」)、Bazel はシステム構成に対してクエリを実行し、使用可能な 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> を続けます(例:HOST_RAM*.5 のように指定して、使用可能な RAM の半分を使用します)。デフォルトで(「HOST_RAM*.67」)、Bazel はシステム構成をクエリして使用可能な RAM の量を推定し、その 67% を使用します。
タグ: host_machine_resource_optimizations
--local_resources=<a named double, 'name=value', where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> 回の使用が累積されています
Bazel で使用可能なリソース数を設定します。float または HOST_RAM/HOST_CPUS に代入し、必要に応じて [-|*]<float> を続けます(例: 利用可能な RAM の半分を使用するには、memory=HOST_RAM*.5)。複数回使用して複数のタイプのリソースを指定できます。Bazel は、使用可能なリソースと必要なリソースに基づいて、同時に実行するアクションを制限します。テストでは、resources:<resource name>:<amount> 形式のタグを使用して、必要なリソースの量を宣言できます。--local_{cpu|ram|extra}_resources で指定されたリソースをオーバーライドします。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_full_gc_drops_per_invocation=<an integer, >= 0> のデフォルト: 「2147483647」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、GC イベントが完全に終了したときに不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、完全な GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、GC イベントが完全に発生し、保持されているヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> のデフォルト: 「2147483647」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、マイナー GC イベントの発生時に不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、マイナー GC イベントが発生して保持ヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: 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
true の場合、出力ファイルを提示するときに、BEP 内の相対 Fileset シンボリック リンクを完全に解決します。--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"
NoOps のサポートが終了しました。
タグ: execution
--experimental_command_profile=<cpu, wall, alloc or lock> のデフォルト: 説明を参照
コマンドの実行中に Java フライト レコーダーのプロファイルを記録します。サポートされているプロファイリング イベントタイプ(cpu、wall、alloc、lock)のいずれかを引数として指定する必要があります。プロファイルは、出力ベース ディレクトリの下のイベントタイプに基づいて名前が付けられたファイルに書き込まれます。このフラグの構文とセマンティクスは、他のプロファイル タイプや出力形式をサポートするため今後変更される可能性があります。このフラグは自己責任で使用してください。
--[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 への統合には、重要な出力値が必要です。
タグ: 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」のときに出力できるテストログあたりの最大サイズを指定します。過度にノイズの多いテスト出力で出力が過負荷にならないようにする場合に便利です。テストヘッダーはログサイズに含まれます。負の値は上限なしを意味します。出力は「all」か「No」です。
タグ: test_runnerterminal_outputexecution
--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] デフォルト: "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_runnerterminal_outputexecution
--test_summary=<short, terse, detailed, none or testcase> のデフォルト: "short"
テストサマリーに必要な形式を指定します。有効な値は、実行されたテストに関する情報のみを表示する「short」、実行に失敗したテストに関する情報のみを表示する「terse」、失敗したテストケースに関する詳細情報を出力する「detailed」、テストケースの解決でサマリーを出力する「testcase」、失敗したテストケースに関する詳細情報を出力しない「none」、サマリーを省略する場合は「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` から始まります。同じ URL に対して複数の rewrite ディレクティブが返される場合があります。
--[no]experimental_guard_against_concurrent_changes のデフォルト: "false"
これをオフにすると、アクションをリモート キャッシュにアップロードする前にアクションの入力ファイルの ctime をチェックできなくなります。Linux カーネルがファイルの書き込みを遅延し、偽陽性になることがあります。
--[no]experimental_remote_cache_async のデフォルト: "false"
true の場合、リモート キャッシュ I/O は生成の一部として行われるのではなく、バックグラウンドで行われます。
--experimental_remote_cache_compression_threshold=<an integer> のデフォルト: 「0」
zstd で圧縮/解凍するために必要な最小 blob サイズ。--remote_cache_compression が設定されていない場合効果はありません。
--experimental_remote_cache_eviction_retries=<an integer> のデフォルト: 「0」
ビルドでリモート キャッシュ エビクション エラーが発生した場合の再試行の最大試行回数。ゼロ以外の値を指定すると、--compatibility_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 のダイジェストが最近参照された後、その blob の保証される最小 TTL(ActionResult や FindMissingBlobs など)。Bazel は、blob の TTL に基づいていくつかの最適化を行います(増分ビルドで GetActionResult を繰り返し呼び出さないなど)。この値は、実際の TTL よりも少し小さい値に設定する必要があります。これは、サーバーがダイジェストを返してから、Bazel がダイジェストを受け取るまでに時間差があるためです。
タグ: 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 です。
--experimental_remote_output_service=<a string> のデフォルト: 説明を参照
リモート出力サービス エンドポイントの HOST または HOST:PORT。サポートされているスキーマは、grpc、grpcs(TLS が有効な grpcs)、unix(ローカル UNIX ソケット)です。スキーマが指定されていない場合、Bazel はデフォルトで grpcs になります。TLS を無効にするには、grpc:// または unix: スキーマを指定します。
--experimental_remote_output_service_output_path_prefix=<a string> のデフォルト: ""
--experimental_remote_output_service によって管理される出力ディレクトリの内容が配置されるパス。ビルドで使用される実際の出力ディレクトリは、このパスの子孫となり、出力サービスによって決まります。
--[no]experimental_remote_require_cached のデフォルト: "false"
true に設定した場合、リモートで実行できるすべてのアクションがキャッシュに保存され、それ以外の場合はビルドが失敗します。新しい結果を誤ってキャッシュに挿入することなく、キャッシュに保存すべきアクションが実際にキャッシュに保存されているかどうかを確認できるため、非決定論的問題のトラブルシューティングに役立ちます。
--experimental_remote_scrubbing_config=<Converts to a Scrubber> のデフォルト: 説明を参照
指定された構成ファイルによるリモート キャッシュキーのスクラブを有効にします。構成ファイルはテキスト形式のプロトコル バッファである必要があります(src/main/protobuf/remote_scrubbing.proto を参照)。 この機能は、同じプラットフォームをターゲットにしている異なるプラットフォームで実行されるアクション間で、リモート/ディスクキャッシュの共有を容易にすることを目的としています。不適切な設定を行うと、誤ってキャッシュ エントリが共有され、正しくビルドされない可能性があるため、使用する際は細心の注意を払ってください。 スクラブは、アクションの実行方法には影響しません。アクションの結果を取得または保存するためのリモート/ディスク キャッシュキーの計算方法にのみ影響します。スクラブされたアクションはリモート実行とは互換性がなく、常にローカルで実行されます。 スクラブ構成を変更しても、ローカル ファイル システムや内部キャッシュに存在する出力は無効になりません。影響を受けるアクションを再実行するには、クリーンなビルドが必要です。 この機能を適切に使用するには、カスタムの --host_platform を、-experimental_platform_in_output_dir(出力接頭辞を正規化するため)および --compatible_strict_action_env(環境変数を正規化するため)とともに設定することをおすすめします。
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto> のデフォルト: "auto"
リポジトリのフェッチに使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得は再起動の対象となります。それ以外の場合は、仮想ワーカー スレッドを使用します。
--[no]incompatible_remote_build_event_upload_respect_no_cache のデフォルト: "false"
非推奨。いいえ。代わりに --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"
NoOps
タグ: 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 になります。TLS を無効にするには、grpc://、http://、unix: スキーマを指定します。https://bazel.build/remote/caching をご覧ください。
--[no]remote_cache_compression のデフォルト: "false"
有効にすると、サイズが --experimental_remote_cache_compression_threshold 以上の場合に、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 valid Java regular expression> 回の使用が累積されています
--remote_download_outputs に関係なく、パスがこのパターンと一致するリモートビルド出力が強制的にダウンロードされます。このフラグを繰り返すことで、複数のパターンを指定できます。
タグ: 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 のシーケンスで構成され、各メッセージの前には、メソッド LogEntry.writeDelimitedTo(OutputStream) によって実行される、次のシリアル化された protobuf メッセージのサイズを示す変数が付加されています。
--remote_header=<a 'name=value' assignment> 回の使用が累積されています
リクエストに含めるヘッダーを指定する(--remote_header=Name=Value)。フラグを複数回指定することで、複数のヘッダーを渡すことができます。同じ名前の複数の値はカンマ区切りのリストに変換されます。
--remote_instance_name=<a string> のデフォルト: ""
Remote Execution 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> のデフォルト: 「none」
--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> のデフォルト: 「none」
必要な累積カバレッジ レポートのタイプを指定します。現時点では 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 に従って、実行された生成を、長さで区切られた SpawnExec proto としてこのファイルに記録します。関連フラグ: --execution_log_json_file(テキスト JSON 形式、相互に排他的)、--execution_log_sort(実行ログを並べ替えるかどうか)、--subcommands(ターミナル出力にサブコマンドを表示)。
--execution_log_json_file=<a path> のデフォルト: 説明を参照
src/main/protobuf/spawn.proto に従って、実行された生成を、SpawnExec proto の改行区切りの JSON 表現としてこのファイルに記録します。関連フラグ: --execution_log_binary_file(バイナリ protobuf 形式、相互に排他的)、--execution_log_sort(実行ログを並べ替えるかどうか)、--subcommands(ターミナル出力にサブコマンドを表示)。
--[no]execution_log_sort のデフォルト: "true"
呼び出し間でログを比較しやすくするために、実行ログを並べ替えるかどうかを指定します。false に設定すると、呼び出し終了時に CPU とメモリが大量に使用される可能性がありますが、非決定的な実行順序でログが生成されます。バイナリ形式と JSON 形式にのみ適用されます。コンパクト形式では並べ替えられません。
--[no]expand_test_suites のデフォルト: "true"
分析の前に test_suite ターゲットを構成テストに展開します。このフラグがオンになっている場合(デフォルト)、テストスイートに属するテストには否定的なターゲット パターンが適用されます。それ以外の場合は適用されません。このフラグをオフにすると、トップレベルのアスペクトがコマンドラインで適用される場合に、test_suite ターゲットを分析できるようになるため便利です。
タグ: loading_and_analysis
--experimental_execution_log_compact_file=<a path> のデフォルト: 説明を参照
src/main/protobuf/spawn.proto に従って、実行された生成を、長さで区切られた ExecLogEntry proto としてこのファイルに記録します。ファイル全体が zstd で圧縮されます。これは現在開発中の試験運用中の形式であり、随時変更される可能性があります。関連フラグ: --execution_log_binary_file(バイナリ protobuf 形式、相互に排他的)、--execution_log_json_file(JSON テキスト形式、相互に排他的)、--subcommands(ターミナル出力にサブコマンドを表示)。
--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]fetch のデフォルト: "true"
コマンドが外部依存関係を取得できるようにします。false に設定すると、依存関係のキャッシュ バージョンが使用されます。依存関係が存在しない場合は、コマンドが失敗します。
--[no]incompatible_dont_use_javasourceinfoprovider のデフォルト: "false"
NoOps
タグ: incompatible_change
--local_termination_grace_seconds=<an integer> のデフォルト: 「15」
タイムアウトによるローカル プロセスの終了から強制的にシャットダウンまでの待機時間。
--override_repository=<an equals-separated mapping of repository name to 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
ファイル システムを直接呼び出してシンボリック リンク ツリーを作成するかどうか
タグ: loading_and_analysisexecutionexperimental
--[no]experimental_persistent_aar_extractor のデフォルト: "false"
ワーカーを使用して永続的な AAR エクストラクタを有効にします。
タグ: execution
--[no]experimental_remotable_source_manifests のデフォルト: "false"
ソース マニフェストのアクションをリモート可能にするかどうか
タグ: loading_and_analysisexecutionexperimental
--[no]experimental_split_coverage_postprocessing のデフォルト: "false"
true の場合、Bazel は新しい Spwn でテスト用のカバレッジ後処理を実行します。
タグ: 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 のデフォルト: "true"
true に設定した場合は、さらにセマフォを使用して同時実行ジョブの数を制限します。
タグ: host_machine_resource_optimizationsexecution
--genrule_strategy=<comma-separated list of options> のデフォルト: ""
genrules の実行方法を指定します。このフラグは段階的に廃止されます。代わりに、すべてのアクションを制御する場合は --spawn_strategy=<value>、genrules のみを制御する場合は --strategy=Genrule=<value> を使用します。
タグ: execution
--[no]incompatible_disallow_unsound_directory_outputs のデフォルト: "true"
設定すると、出力ファイルをディレクトリとして実体化するアクションでエラーになります。ソース ディレクトリには影響しません。https://github.com/bazelbuild/bazel/issues/18646 をご覧ください。
タグ: bazel_internal_configurationincompatible_change
--[no]incompatible_modify_execution_info_additive のデフォルト: "false"
有効にすると、複数の --modify_execution_info フラグを渡すことで追加されます。無効にすると、最後のフラグのみが考慮されます。
タグ: executionaffects_outputsloading_and_analysisincompatible_change
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> [-j] デフォルト: "auto"
実行する同時実行ジョブの数。整数またはキーワード("auto"、"HOST_CPUS"、"HOST_RAM")を取り、必要に応じてその後に演算([-|*]<float>)が続きます(例:"auto"、"HOST_CPUS*.5" のように指定します。値は 1 ~ 5,000 の範囲で指定してください。値が 2,500 を超えると、メモリの問題が発生する可能性があります。「auto」に設定すると、ホストリソースに基づいて適切なデフォルト値が計算されます。
タグ: host_machine_resource_optimizationsexecution
--[no]keep_going [-k] デフォルト: "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」を削除します。
タグ: executionaffects_outputsloading_and_analysis
--persistent_android_dex_desugar
ワーカーを使用して、永続的な Android dex アクションと desugar アクションを有効にします。
展開先:
  --internal_persistent_android_dex_desugar
  --strategy=Desugar=worker
  --strategy=DexBuilder=worker

タグ: host_machine_resource_optimizationsexecution
--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=AARGenerator=worker--strategy=ProcessDatabinding=worker--strategy=GenerateDataBindingBaseClasses=workerhost_machine_resource_optimizationsexecution
--persistent_multiplex_android_dex_desugar
ワーカーを使用して、永続的な多重化された Android dex アクションと desugar アクションを有効にします。
展開先:
  --persistent_android_dex_desugar
  --internal_persistent_multiplex_android_dex_desugar

タグ: host_machine_resource_optimizationsexecution
--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-workerss
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers

--modify_execution_info=AARGenerator=+supports-multiplex-workershost_machine_resource_optimizationsexecution
--persistent_multiplex_android_tools
永続的な Android ツールと多重化された Android ツール(dex 変換、desugar、リソース処理)を有効にします。
展開先:
  --internal_persistent_multiplex_busybox_tools
  --persistent_multiplex_android_resource_processor
  --persistent_multiplex_android_dex_desugar

タグ: host_machine_resource_optimizationsexecution
--[no]skip_incompatible_explicit_targets のデフォルト: "false"
コマンドラインで明示的にリストされている互換性のないターゲットはスキップします。このようなターゲットをビルドすると、デフォルトではエラーになりますが、このオプションを有効にすると通知なくスキップされます。参照: https://bazel.build/extending/platforms#skipping-compatible-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> 回の使用が累積されています
他の Spawn アクションのコンパイルを分散する方法を指定します。優先度が最も高いものから低いものの順に、戦略をカンマで区切ったリストを指定できます。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 に一致する説明を持つスポーン アクションの実行に使用するスポーン戦略をオーバーライドします。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_outputsloading_and_analysisloses_incremental_state
--android_crosstool_top=<a build target label> のデフォルト: 「//external:android/crosstool」
Android ビルドに使用される C++ コンパイラの場所。
タグ: affects_outputschanges_inputsloading_and_analysisloses_incremental_state
--android_grte_top=<a label> のデフォルト: 説明を参照
Android ターゲットの grte_top を指定します。
タグ: changes_inputsloading_and_analysisloses_incremental_state
--android_manifest_merger=<legacy, android or force_android> のデフォルト: "android"
android_binary ルールに使用するマニフェスト マージツールを選択します。従来のマージツールから Android マニフェスト マージツールへの移行をサポートするフラグ。
タグ: affects_outputsloading_and_analysisloses_incremental_state
--android_platforms=<a build target label> のデフォルト: ""
android_binary ターゲットが使用するプラットフォームを設定します。複数のプラットフォームが指定されている場合、バイナリはファット APK になります。この APK には、指定された各ターゲット プラットフォームのネイティブ バイナリが含まれています。
タグ: changes_inputsloading_and_analysisloses_incremental_state
--android_sdk=<a build target label> のデフォルト: "@bazel_tools//tools/android:sdk"
Android アプリのビルドに使用する Android SDK/プラットフォームを指定します。
タグ: changes_inputsloading_and_analysisloses_incremental_state
--apple_crosstool_top=<a build target label> デフォルト: "@bazel_tools//tools/cpp:ツールチェーン"
Apple ルールと Objc ルール、およびそれらの依存関係で使用されるクロスツール パッケージのラベル。
タグ: loses_incremental_statechanges_inputs
--cc_output_directory_tag=<a string> のデフォルト: ""
構成ディレクトリに追加する接尾辞を指定します。
タグ: affects_outputs
--compiler=<a string> のデフォルト: 説明を参照
ターゲットのコンパイルに使用する C++ コンパイラ。
タグ: loading_and_analysisexecution
--coverage_output_generator=<a build target label> のデフォルト: "@bazel_tools//tools/test:lcov_merger"
未加工のカバレッジ レポートの後処理に使用されるバイナリの場所。現在は、単一のファイル(バイナリ)を含むファイル グループである必要があります。デフォルトは「//tools/test:lcov_merger」です。
タグ: changes_inputsaffects_outputsloading_and_analysis
--coverage_report_generator=<a build target label> デフォルト: "@bazel_tools//tools/test:coverage_report_generator"
カバレッジ レポートの生成に使用されるバイナリの場所。現在は、単一のファイル(バイナリ)を含むファイル グループである必要があります。デフォルトは「//tools/test:coverage_report_generator」です。
タグ: changes_inputsaffects_outputsloading_and_analysis
--coverage_support=<a build target label> デフォルト: "@bazel_tools//tools/test:coverage_support"
コード カバレッジを収集するすべてのテスト アクションの入力で必要なサポート ファイルの場所。デフォルトは「//tools/test:coverage_support」です。
タグ: changes_inputsaffects_outputsloading_and_analysis
--crosstool_top=<a build target label> デフォルト: "@bazel_tools//tools/cpp:ツールチェーン"
C++ コードのコンパイルに使用されるクロスツール パッケージのラベル。
タグ: loading_and_analysischanges_inputsaffects_outputs
--custom_malloc=<a build target label> のデフォルト: 説明を参照
カスタム Maloc 実装を指定します。この設定は、ビルドルールの Maloc 属性をオーバーライドします。
タグ: changes_inputsaffects_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_stateloading_and_analysisexecution
--[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_ツールチェーン s() によって WORKSPACE ファイルで宣言されたものの前に考慮されます。
タグ: affects_outputschanges_inputsloading_and_analysis
--grte_top=<a label> のデフォルト: 説明を参照
チェックインされた libc ライブラリへのラベル。デフォルト値はクロスツール ツールチェーンによって選択されるため、オーバーライドする必要はほとんどありません。
タグ: action_command_linesaffects_outputs
--host_compiler=<a string> のデフォルト: 説明を参照
ホスト コンパイルに使用する C++ コンパイラ。--host_crosstool_top が設定されていない場合、無視されます。
タグ: loading_and_analysisexecution
--host_crosstool_top=<a build target label> のデフォルト: 説明を参照
デフォルトでは、exec 構成には --crosstool_top オプションと --compiler オプションも使用されます。このフラグを指定すると、Bazel は指定された crosstool_top に対してデフォルトの libc とコンパイラを使用します。
タグ: loading_and_analysischanges_inputsaffects_outputs
--host_grte_top=<a label> のデフォルト: 説明を参照
指定すると、exec 構成の libc 最上位ディレクトリ(--grte_top)がオーバーライドされます。
タグ: action_command_linesaffects_outputs
--host_platform=<a build target label> デフォルト: "@bazel_tools//tools:host_platform"
ホストシステムを記述するプラットフォーム ルールのラベル。
タグ: affects_outputschanges_inputsloading_and_analysis
--[no]incompatible_dont_enable_host_nonhost_crosstool_features のデフォルト: "true"
true の場合、Bazel は C++ ツールチェーンの「host」機能と「nonhost」機能を有効にしません(詳しくは、https://github.com/bazelbuild/bazel/issues/7407 をご覧ください)。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_enable_android_toolchain_resolution のデフォルト: "true"
ツールチェーン解決を使用して、Android ルール用の Android SDK を選択します(Starlark とネイティブ)
タグ: loading_and_analysisincompatible_change
--[no]incompatible_enable_apple_toolchain_resolution のデフォルト: "false"
ツールチェーン解決を使用して、apple ルール用の Apple SDK を選択します(Starlark とネイティブ)
タグ: loading_and_analysisincompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone のデフォルト: "true"
true の場合、Bazel は lto インデックス作成コマンドラインに C++ リンク アクション コマンドラインを再利用しません(詳しくは、https://github.com/bazelbuild/bazel/issues/6791 をご覧ください)。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_remove_legacy_whole_archive のデフォルト: "true"
true の場合、Bazel はデフォルトでライブラリの依存関係をアーカイブ全体としてリンクしません(移行手順については、https://github.com/bazelbuild/bazel/issues/7362 をご覧ください)。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_require_ctx_in_configure_features のデフォルト: "true"
true の場合、Bazel は cc_common.configure_features に 'gsuite' パラメータを必要とします(詳しくは、https://github.com/bazelbuild/bazel/issues/7793 をご覧ください)。
タグ: loading_and_analysisincompatible_change
--[no]interface_shared_objects のデフォルト: "true"
ツールチェーンでサポートされている場合は、インターフェース共有オブジェクトを使用します。現在、この設定はすべての ELF ツールチェーンでサポートされています。
タグ: loading_and_analysisaffects_outputsaffects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> のデフォルト: 説明を参照
iOS アプリのビルドに使用する iOS SDK のバージョンを指定します。指定しない場合は、「xcode_version」のデフォルトの iOS SDK バージョンが使用されます。
タグ: loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> のデフォルト: 説明を参照
macOS アプリケーションのビルドに使用する macOS SDK のバージョンを指定します。指定しない場合は、「xcode_version」のデフォルトの macOS SDK バージョンを使用します。
タグ: loses_incremental_state
--minimum_os_version=<a string> のデフォルト: 説明を参照
コンパイルの対象となる最小 OS バージョン。
タグ: loading_and_analysisaffects_outputs
--platform_mappings=<a relative path> のデフォルト: ""
マッピング ファイルの場所。プラットフォームが設定されていない場合に使用するプラットフォーム、またはプラットフォームがすでに存在する場合に設定するフラグを記述します。メインのワークスペースのルートからの相対パスにする必要があります。デフォルトは「platform_mappings」(ワークスペース ルートの直下にあるファイル)です。
タグ: affects_outputschanges_inputsloading_and_analysis
--platforms=<a build target label> のデフォルト: ""
現在のコマンドのターゲット プラットフォームを記述するプラットフォーム ルールのラベル。
タグ: affects_outputschanges_inputsloading_and_analysis
--python2_path=<a string> のデフォルト: 説明を参照
非推奨、NoOps。「--compatibility_use_python_ツールチェーン」によって無効。
タグ: no_opdeprecated
--python3_path=<a string> のデフォルト: 説明を参照
非推奨、NoOps。「--compatibility_use_python_ツールチェーン」によって無効。
タグ: no_opdeprecated
--python_path=<a string> のデフォルト: 説明を参照
ターゲット プラットフォームで Python ターゲットを実行するために呼び出される Python インタープリタの絶対パス。非推奨。--compatible_use_python_ツールチェーン s によって無効になっています。
タグ: loading_and_analysisaffects_outputs
--python_top=<a build target label> のデフォルト: 説明を参照
ターゲット プラットフォームで Python ターゲットを実行するために呼び出される Python インタープリタを表す py_runtime のラベル。非推奨。--compatible_use_python_ツールチェーン s によって無効になっています。
タグ: loading_and_analysisaffects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> のデフォルト: 説明を参照
tvOS アプリのビルドに使用する tvOS SDK のバージョンを指定します。指定しない場合は、「xcode_version」のデフォルトの tvOS SDK バージョンを使用します。
タグ: 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_stateloading_and_analysis
コマンドの出力を制御するオプション:
--[no]apple_generate_dsym のデフォルト: "false"
デバッグ シンボル(.dSYM)ファイルを生成するかどうかを指定します。
タグ: affects_outputsaction_command_lines
--[no]build のデフォルト: "true"
ビルドを実行します。これは通常の動作です。--nobuild を指定すると、ビルド アクションを実行する前にビルドが停止し、パッケージの読み込みと分析のフェーズが正常に完了するとゼロが返されます。このモードは、これらのフェーズをテストする場合に便利です。
タグ: executionaffects_outputs
true の場合、すべてのターゲットのランファイル シンボリック リンク フォレストをビルドします。false の場合は、ローカル アクション、テスト、または実行コマンドで必要とされる場合にのみ書き込みます。
タグ: affects_outputs
--[no]build_runfile_manifests のデフォルト: "true"
true の場合、すべてのターゲットの runfile マニフェストを書き込みます。false の場合は省略します。false の場合、ローカルテストは実行に失敗します。
タグ: affects_outputs
--[no]build_test_dwp のデフォルト: "false"
有効にすると、C++ テストを静的かつ fission でビルドするときに、テストバイナリの .dwp ファイルも自動的にビルドされます。
タグ: loading_and_analysisaffects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options> のデフォルト: ".pb.h"
cc_proto_library が作成するヘッダー ファイルの接尾辞を設定します。
タグ: affects_outputsloading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options> のデフォルト: 「.pb.cc」
cc_proto_library が作成するソースファイルの接尾辞を設定します。
タグ: affects_outputsloading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info のデフォルト: "false"
proto_library で、代替 Java API バージョンの追加アクションを実行します。
タグ: affects_outputsloading_and_analysisexperimental
--[no]experimental_proto_extra_actions のデフォルト: "false"
proto_library で、代替 Java API バージョンの追加アクションを実行します。
タグ: affects_outputsloading_and_analysisexperimental
--[no]experimental_save_feature_state のデフォルト: "false"
有効化されリクエストされた機能の状態をコンパイルの出力として保存します。
タグ: affects_outputsexperimental
--[no]experimental_use_validation_aspect のデフォルト: "false"
アスペクトを使用して検証アクションを実行するかどうかを指定します(テストとの並列処理用)。
タグ: executionaffects_outputs
--fission=<a set of compilation modes> のデフォルト: 「no」
C++ コンパイルとリンクに分裂を使用するコンパイル モードを指定します。{'fastbuild', 'dbg', 'opt'} の任意の組み合わせにできます。すべてのモードを有効にする場合は 'yes'、すべてのモードを無効にする特殊な値 'no' にすることもできます。
タグ: loading_and_analysisaction_command_linesaffects_outputs
--[no]incompatible_always_include_files_in_data のデフォルト: "true"
true の場合、ネイティブ ルールによってデータ依存関係の <code>DefaultInfo.files</code> が実行ファイルに追加されます。これは、Starlark ルールの推奨動作(https://bazel.build/extending/rules#runfiles_features_to_avoid)と一致します。
タグ: affects_outputsincompatible_change
--[no]legacy_external_runfiles のデフォルト: "true"
true の場合、外部リポジトリのランファイル シンボリック リンク フォレストを(.runfiles/repo に加えて).runfiles/wsname/external/repo にビルドします。
タグ: 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 のみがビルドされるようにします。
タグ: executionaffects_outputs
--[no]run_validations のデフォルト: "true"
ビルドの一部として検証アクションを実行するかどうかを指定します。https://bazel.build/extending/rules#validation_actions をご覧ください。
タグ: executionaffects_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_outputsloading_and_analysisloses_incremental_state
--[no]android_databinding_use_androidx のデフォルト: "true"
AndroidX 互換のデータ バインディング ファイルを生成します。これは、データ バインディング v2 でのみ使用されます。このフラグは機能しません。
タグ: affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[no]android_databinding_use_v3_4_args のデフォルト: "true"
Android データ バインディング v2 を 3.4.0 引数で使用します。このフラグは機能しません。
タグ: affects_outputsloading_and_analysisloses_incremental_stateexperimental
--android_dynamic_mode=<off, default or fully> のデフォルト: 「off」
cc_binary で共有ライブラリが明示的に作成されていない場合に、Android ルールの C++ 依存関係を動的にリンクするかどうかを指定します。「default」を選択すると、動的にリンクするかどうかが bazel によって選択されます。「complete」はすべてのライブラリが動的にリンクされることを意味します。「オフ」は、すべてのライブラリがほぼ静的モードでリンクされることを意味します。
タグ: affects_outputsloading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency> のデフォルト: 「alphabetical」
Android バイナリのマニフェスト マージツールに渡されるマニフェストの順序を設定します。ALPHABETICAL は、マニフェストが execroot からの相対パスで並べ替えられることを意味します。ALPHABETICAL_BY_CONFIGURATION は、出力ディレクトリ内の構成ディレクトリからの相対パスでマニフェストが並べ替えられることを意味します。DEPENDENCY は、各ライブラリのマニフェストが依存関係のマニフェストの前に来るようにマニフェストが並べ替えられることを意味します。
タグ: action_command_linesexecution
--[no]android_resource_shrinking のデフォルト: "false"
ProGuard を使用する android_binary APK のリソース圧縮を有効にします。
タグ: affects_outputsloading_and_analysis
--aspects=<comma-separated list of options> 回の使用が累積されています
トップレベル ターゲットに適用されるアスペクトのカンマ区切りのリスト。リストで、アスペクト some_aspect が required_aspect_providers を介して必須のアスペクト プロバイダを指定している場合、アスペクト リスト内ですでに言及されているすべてのアスペクトの後に some_aspect が実行され、アドバタイズされたプロバイダが some_aspect の必須のアスペクト プロバイダを満たしている。さらに、some_aspect は require 属性で指定されたすべての必須アスペクトの後に実行されます。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_stateloading_and_analysis
--[no]collect_code_coverage のデフォルト: "false"
指定した場合、Bazel は(可能な場合はオフライン インストルメンテーションを使用して)コードをインストルメント化し、テスト中にカバレッジ情報を収集します。--instrumentation_filter に一致するターゲットのみが影響を受けます。通常、このオプションは直接指定せず、代わりに「bazelCoverage」コマンドを使用する必要があります。
タグ: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] デフォルト: "fastbuild"
バイナリをビルドするモードを指定します。値: fastbuild、dbg、opt。
タグ: affects_outputsaction_command_lines
--conlyopt=<a string> 回の使用が累積されています
C ソースファイルのコンパイル時に gcc に渡す追加オプション。
タグ: action_command_linesaffects_outputs
--copt=<a string> 回の使用が累積されています
gcc に渡す追加オプション。
タグ: action_command_linesaffects_outputs
--cpu=<a string> のデフォルト: ""
ターゲット CPU。
タグ: changes_inputsaffects_outputs
--cs_fdo_absolute_path=<a string> のデフォルト: 説明を参照
CSFDO のプロファイル情報を使用してコンパイルを最適化します。プロファイル ファイル(未加工またはインデックス付き LLVM プロファイル ファイル)を含む zip ファイルの絶対パス名を指定します。
タグ: 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_linesaffects_outputs
--define=<a 'name=value' assignment> 回の使用が累積されています
--define オプションごとにビルド変数の割り当てを指定します。
タグ: changes_inputsaffects_outputs
--dynamic_mode=<off, default or fully> のデフォルト: "default"
C++ バイナリを動的にリンクするかどうかを指定します。「default」を選択すると、Bazel が動的にリンクするかどうかを選択します。「complete」はすべてのライブラリが動的にリンクされることを意味します。「オフ」は、すべてのライブラリがほぼ静的モードでリンクされることを意味します。
タグ: loading_and_analysisaffects_outputs
--[no]enable_fdo_profile_absolute_path のデフォルト: "true"
設定すると、fdo_specific_profile_path を使用するとエラーが発生します。
タグ: affects_outputs
--[no]enable_runfiles のデフォルト: "auto"
runfiles シンボリック リンク ツリーを有効にする: Windows では、他のプラットフォームではデフォルトで無効になっています。
タグ: affects_outputs
--experimental_action_listener=<a build target label> 回の使用が累積されています
アスペクトを優先するため非推奨となりました。action_listener を使用して、既存のビルド アクションに extra_action をアタッチします。
タグ: executionexperimental
--[no]experimental_android_compress_java_resources のデフォルト: "false"
APK 内の Java リソースを圧縮する
タグ: affects_outputsloading_and_analysisexperimental
--[no]experimental_android_databinding_v2 のデフォルト: "true"
Android データ バインディング v2 を使用します。このフラグは機能しません。
タグ: affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[no]experimental_android_resource_shrinking のデフォルト: "false"
ProGuard を使用する android_binary APK のリソース圧縮を有効にします。
タグ: affects_outputsloading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex のデフォルト: "false"
rex ツールを使用して dex ファイルを書き換える
タグ: affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[no]experimental_collect_code_coverage_for_generated_files のデフォルト: "false"
指定した場合、Bazel は生成されたファイルの収集カバレッジ情報も生成します。
タグ: affects_outputs
このフラグは、コンビニエンス シンボリック リンク(ビルド後にワークスペースに表示されるシンボリック リンク)の管理方法を制御します。可能な値: normal(デフォルト): コンビニエンスの各種類のシンボリック リンクが、ビルドによって作成または削除されます。 clean: すべてのシンボリック リンクが無条件に削除されます。ignore: シンボリック リンクが残ります。log_only: 「normal」が渡されたかのようにログメッセージを生成しますが、実際にはファイルシステム オペレーションは実行しません(ツールの場合に役立ちます)。 影響を受けるのは、--symlink_prefix の現在の値によって名前が生成されたシンボリック リンクのみです。接頭辞が変更されても、既存のシンボリック リンクはそのまま残ります。
タグ: affects_outputs
このフラグは、ビルド イベント ConvenienceSymlinksIdentified を 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 と -fasynchronous-unwind-tables を使用してコンパイルします。
タグ: action_command_linesaffects_outputsexperimental
--experimental_output_paths=<off, content or strip> のデフォルト: 「off」
特にマルチプラットフォーム / マルチ構成のビルドの場合、出力ツリールールで出力を書き込む場所に使用するモデル。これは非常に試験運用版です。詳細については、https://github.com/bazelbuild/bazel/issues/6526 をご覧ください。Starlark のアクションでは、キー「supports-path-mapping」を「execution_requirements」辞書に追加することでパス マッピングを有効にできます。
タグ: loses_incremental_statebazel_internal_configurationaffects_outputsexecution
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment> 回の使用が累積されています
各エントリは label=value の形式にする必要があります。label はプラットフォームを表し、values は出力パスで使用する略称です。--experimental_platform_in_output_dir が true の場合にのみ使用されます。名前の優先順位が最も高い。
タグ: affects_outputsexperimental
--[no]experimental_platform_in_output_dir のデフォルト: "false"
true の場合、出力ディレクトリ名で CPU ではなくターゲット プラットフォームの略称が使用されます。正確なスキームは試験運用版であり、変更される可能性があります。まず、まれに、--platforms オプションの値が 1 つではない場合は、platforms オプションのハッシュが使用されます。次に、--experimental_override_name_platform_in_output_dir によって現在のプラットフォームの略称が登録されている場合は、その略称が使用されます。--experimental_use_platforms_in_output_dir_legacy_heuristic に設定されている場合は、現在のプラットフォーム ラベルに基づいた略称を使用します。最後に、プラットフォーム オプションのハッシュが最後の手段として使用されます。
タグ: affects_outputsexperimental
--[no]experimental_use_llvm_covmap のデフォルト: "false"
指定した場合、collect_code_coverage が有効なときに Bazel は gcov ではなく llvm-cov のカバレッジ マップ情報を生成します。
タグ: changes_inputsaffects_outputsloading_and_analysisexperimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic のデフォルト: "true"
このフラグは、推奨される移行戦略またはテスト戦略の一部としてのみ使用してください。ヒューリスティックには既知の欠陥があるため、--experimental_override_name_platform_in_output_dir のみを使用するよう移行することをおすすめします。
タグ: affects_outputsexperimental
--fat_apk_cpu=<comma-separated set of options> のデフォルト: 「armeabi-v7a」
このオプションを設定すると、指定されたすべてのターゲット アーキテクチャ(--fat_apk_cpu=x86,armeabi-v7a. このフラグを指定すると、android_binary ルールの依存関係について --android_cpu は無視されます。
タグ: affects_outputsloading_and_analysisloses_incremental_state
--[no]fat_apk_hwasan のデフォルト: "false"
HWASAN 分割を作成するかどうか。
タグ: affects_outputsloading_and_analysisloses_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_inputsaffects_outputs
--[no]force_pic のデフォルト: "false"
有効にすると、すべての C++ コンパイルで位置独立コード(「-fPIC」)が生成されます。リンクでは非 PIC ライブラリよりも PIC ビルド済みライブラリが優先され、リンクでは位置独立実行ファイル(「-pie」)が生成されます。
タグ: loading_and_analysisaffects_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_outputsaction_command_lines
--host_conlyopt=<a string> 回の使用が累積されています
exec 構成で C ソースファイル(C++ ではない)をコンパイルするときに C コンパイラに渡す追加オプション。
タグ: action_command_linesaffects_outputs
--host_copt=<a string> 回の使用が累積されています
exec 構成でビルドされたツールの C コンパイラに渡す追加オプション。
タグ: action_command_linesaffects_outputs
--host_cpu=<a string> のデフォルト: ""
ホストの CPU。
タグ: changes_inputsaffects_outputs
--host_cxxopt=<a string> 回の使用が累積されています
exec 構成でビルドされたツールの C++ コンパイラに渡す追加オプション。
タグ: action_command_linesaffects_outputs
--host_features=<a string> 回の使用が累積されています
指定された機能は、exec 構成で構築されたターゲットに対してデフォルトで有効または無効にされます。-<feature> を指定すると、この機能が無効になります。ネガティブな特徴は、ポジティブな特徴よりも常に優先されます。
タグ: changes_inputsaffects_outputs
--host_force_python=<PY2 or PY3> のデフォルト: 説明を参照
実行構成の Python バージョンをオーバーライドします。「PY2」または「PY3」のいずれかです。
タグ: loading_and_analysisaffects_outputs
--host_linkopt=<a string> 回の使用が累積されています
実行構成でツールをリンクする際にリンカーに渡す追加オプション。
タグ: action_command_linesaffects_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_nここで、regex_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_linesaffects_outputs
--host_swiftcopt=<a string> 回の使用が累積されています
実行ツールのために swiftc に渡す追加オプション。
タグ: action_command_linesaffects_outputs
--[no]incompatible_auto_exec_groups のデフォルト: "false"
有効にすると、ルールで使用されるツールチェーンごとに実行グループが自動的に作成されます。そのためには、ルールのアクションに「ツールチェーン」パラメータを指定する必要があります。詳細については、https://github.com/bazelbuild/bazel/issues/17134 をご覧ください。
タグ: affects_outputsincompatible_change
--[no]incompatible_merge_genfiles_directory のデフォルト: "true"
true の場合、genfiles ディレクトリが bin ディレクトリに折りたたみられます。
タグ: affects_outputsincompatible_change
--[no]incompatible_use_host_features のデフォルト: "true"
true の場合、ターゲット構成にのみ --features を使用し、実行構成に --host_features を使用します。
タグ: changes_inputsaffects_outputsincompatible_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_stateloading_and_analysis
--[no]legacy_whole_archive のデフォルト: "true"
非推奨となり、--compatible_remove_legacy_whole_archive に置き換えられました(詳しくは、https://github.com/bazelbuild/bazel/issues/7362 をご覧ください)。オンにした場合、linkshared=True と linkopts に linkstatic=True または「-static」のいずれかが指定されている cc_binary ルールに対して --whole-archive を使用します。これは下位互換性のためだけのものです。より適切な代替策は、必要に応じて常時リンク=1 を使用することです。
タグ: action_command_linesaffects_outputsdeprecated
--linkopt=<a string> 回の使用が累積されています
リンク時に gcc に渡す追加オプション。
タグ: action_command_linesaffects_outputs
--ltobackendopt=<a string> 回の使用が累積されています
LTO バックエンド ステップに渡す追加オプション(--features=thin_lto の下)。
タグ: action_command_linesaffects_outputs
--ltoindexopt=<a string> 回の使用が累積されています
LTO のインデックス登録ステップに渡す追加オプション(--features=thin_lto の下)。
タグ: action_command_linesaffects_outputs
--macos_cpus=<comma-separated list of options> 回の使用が累積されています
Apple macOS バイナリをビルドするアーキテクチャのカンマ区切りリスト。
タグ: loses_incremental_stateloading_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_nここで、regex_filter は正規表現パターンを含むリストと除外するパターンのリストを表します(-instrumentation_filter もご覧ください)。option_1 から option_n は任意のコマンドライン オプションを表します。オプションにカンマが含まれる場合は、バックスラッシュで囲む必要があります。オプションには @ を含めることができます。最初の @ のみが文字列の分割に使用されます。例: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 は、//foo/ 内のすべての cc ファイル(bar.cc を除く)の gcc コマンドラインに -O0 コマンドラインオプションを追加します。
タグ: action_command_linesaffects_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> 回の使用が累積されています
特定のバックエンド オブジェクトをコンパイルするときに、(--features=thin_lto にある)LTO バックエンドに選択的に渡す追加のオプション。このオプションは複数回渡すことができます。構文: regex_filter@option_1,option_2,...,option_nここで regex_filter は正規表現パターンのリストを表し、option_1 から option_n は任意のコマンドライン オプションを表します。オプションにカンマが含まれる場合は、バックスラッシュで囲む必要があります。オプションには @ を含めることができます。最初の @ のみが文字列の分割に使用されます。例: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 は、//foo/ 内のすべての o ファイル(bar.o を除く)の LTO バックエンドコマンドラインに -O0 コマンドラインオプションを追加します。
タグ: action_command_lines, affects_outputs
--platform_suffix=<a string> のデフォルト: 説明を参照
構成ディレクトリに追加する接尾辞を指定します。
タグ: loses_incremental_stateaffects_outputsloading_and_analysis
--propeller_optimize=<a build target label> のデフォルト: 説明を参照
Propeller のプロファイル情報を使用して、ビルド ターゲットを最適化します。Propeller のプロファイルは、cc プロファイルと ld プロファイルの 2 つのファイルのうち少なくとも 1 つで構成する必要があります。このフラグには、プロペラ プロファイル入力ファイルを参照する必要があるビルドラベルを指定できます。たとえば、a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",) でラベルを定義する BUILD ファイルでは、Bazel でファイルを可視化できるように、対応するパッケージにディレクティブを追加する必要があります。このオプションは次のように使用する必要があります。--propeller_optimize=//a/b:propeller_profile
タグ: action_command_linesaffects_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
--[no]share_native_deps のデフォルト: "true"
true の場合、同じ機能を含むネイティブ ライブラリが複数のターゲット間で共有されます
タグ: loading_and_analysisaffects_outputs
--[no]stamp のデフォルト: "false"
日付、ユーザー名、ホスト名、ワークスペース情報などを含むバイナリをスタンプします。
タグ: affects_outputs
--strip=<always, sometimes or never> のデフォルト: 「発生することがある」
バイナリと共有ライブラリを削除するかどうかを指定します(「-Wl、--strip-debug」を使用)。「nottimes」のデフォルト値は、--compile_mode=fastbuild のみを削除します。
タグ: affects_outputs
--stripopt=<a string> 回の使用が累積されています
「<name>.stripped」バイナリの生成時に削除に渡す追加オプション。
タグ: action_command_linesaffects_outputs
--swiftcopt=<a string> 回の使用が累積されています
Swift コンパイルに渡す追加オプション。
タグ: action_command_lines
ビルド後に作成されるコンビニエンス シンボリック リンクの先頭に付加される接頭辞。省略した場合のデフォルト値は、ビルドツールの名前の後にハイフンを付けたものです。「/」が渡されると、シンボリック リンクは作成されず、警告も出力されません。警告: 「/」の特別な機能はまもなく非推奨になります。代わりに --experimental_convenience_symlinks=ignore を使用してください。
タグ: affects_outputs
--tvos_cpus=<comma-separated list of options> 回の使用が累積されています
Apple tvOS バイナリをビルドするアーキテクチャのカンマ区切りのリスト。
タグ: loses_incremental_stateloading_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_stateloading_and_analysis
--watchos_cpus=<comma-separated list of options> 回の使用が累積されています
Apple watchOS バイナリをビルドする対象アーキテクチャのカンマ区切りリスト。
タグ: loses_incremental_stateloading_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_inputsloading_and_analysisexperimental
--[no]check_licenses のデフォルト: "false"
依存パッケージによるライセンスの制約が、ビルド中のターゲットの配布モードと競合していないことを確認してください。デフォルトでは、ライセンスはチェックされていません。
タグ: build_file_semantics
--[no]check_visibility のデフォルト: "true"
無効にすると、ターゲット依存関係の可視性エラーは警告に降格されます。
タグ: build_file_semantics
--[no]desugar_for_android のデフォルト: "true"
dex 変換の前に Java 8 バイトコードを desugar するかどうか。
タグ: affects_outputsloading_and_analysisloses_incremental_state
--[no]desugar_java8_libs のデフォルト: "false"
レガシー デバイス向けのアプリにサポートされている Java 8 ライブラリを含めるかどうかを指定します。
タグ: affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[no]enforce_constraints のデフォルト: "true"
各ターゲットが対応している環境を確認し、ターゲットに同じ環境をサポートしていない依存関係がある場合はエラーを報告します
タグ: build_file_semantics
--[no]experimental_check_desugar_deps のデフォルト: "true"
Android バイナリレベルで正しい desugar を再確認するかどうか。
タグ: eagerness_to_exitloading_and_analysisexperimental
--experimental_import_deps_checking=<off, warning or error> のデフォルト: 「OFF」
有効にすると、aar_import の依存関係が完了しているかどうかを確認します。この適用により、ビルドが中断されたり、警告が表示されたりする場合があります。
タグ: loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default> のデフォルト: "default"
true の場合、Java ターゲットが、直接使用されるすべてのターゲットを依存関係として明示的に宣言していることを確認します。
タグ: build_file_semanticseagerness_to_exit
--[no]incompatible_check_testonly_for_output_files のデフォルト: "false"
有効になっている場合は、生成ルールの testonly を検索して、出力ファイルである前提条件ターゲットについて testonly をチェックします。これは公開設定の確認と一致します。
タグ: build_file_semanticsincompatible_change
--[no]incompatible_check_visibility_for_toolchains のデフォルト: "false"
有効にすると、ツールチェーンの実装にも可視性チェックが適用されます。
タグ: build_file_semanticsincompatible_change
--[no]incompatible_disable_native_android_rules のデフォルト: "false"
有効にすると、ネイティブ Android ルールの直接使用が無効になります。https://github.com/bazelbuild/rules_android にある Starlark Android ルールを使用してください
タグ: eagerness_to_exitincompatible_change
--[no]incompatible_disable_native_apple_binary_rule のデフォルト: "false"
NoOps。下位互換性のためにここに保持されています。
タグ: eagerness_to_exitincompatible_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_analysisincompatible_change
--[no]incompatible_validate_top_level_header_inclusions のデフォルト: "true"
true の場合、Bazel はトップレベル ディレクトリ ヘッダーの包含も検証します(詳しくは、https://github.com/bazelbuild/bazel/issues/10047 をご覧ください)。
タグ: loading_and_analysisincompatible_change
--python_native_rules_allowlist=<a build target label> のデフォルト: 説明を参照
--compatibility_python_disallow_native_rules を適用するときに使用する許可リスト(package_group ターゲット)。
タグ: loading_and_analysis
--[no]strict_filesets のデフォルト: "false"
このオプションを有効にすると、パッケージの境界を越えるファイルセットがエラーとして報告されます。
タグ: build_file_semanticseagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default> のデフォルト: "error"
オフの場合を除き、proto_library ターゲットが、直接使用されるすべてのターゲットを依存関係として明示的に宣言していることを確認します。
タグ: build_file_semanticseagerness_to_exitincompatible_change
--strict_public_imports=<off, warn, error, strict or default> のデフォルト: 「off」
オフの場合を除き、「import public」で使用されるすべてのターゲットが、proto_library ターゲットでエクスポート済みとして明示的に宣言されていることを確認します。
タグ: build_file_semanticseagerness_to_exitincompatible_change
--[no]strict_system_includes のデフォルト: "false"
true の場合、システム インクルード パス(-isystem)を通じて検出されたヘッダーも宣言する必要があります。
タグ: loading_and_analysiseagerness_to_exit
--target_environment=<a build target label> 回の使用が累積されています
このビルドのターゲット環境を宣言します。「環境」ルールへのラベル参照にする必要があります。指定する場合、すべてのトップレベル ターゲットがこの環境と互換性がある必要があります。
タグ: changes_inputs
ビルドの署名出力に影響するオプション:
--apk_signing_method=<v1, v2, v1_v2 or v4> のデフォルト: "v1_v2"
APK の署名に使用する実装
タグ: action_command_linesaffects_outputsloading_and_analysis
--[no]device_debug_entitlements のデフォルト: "true"
設定されている場合、コンパイル モードが「opt」でない場合、objc アプリは署名時にデバッグ資格を含めます。
タグ: changes_inputs
--ios_signing_cert_name=<a string> のデフォルト: 説明を参照
iOS 署名に使用する証明書名。設定しない場合、プロビジョニング プロファイルにフォールバックします。証明書のキーチェーン ID 設定、または共同署名の man ページ(署名 ID)に従って証明書の共通名の(部分文字列)を指定できます。
タグ: action_command_lines
このオプションは、BUILD ファイル、.bzl ファイル、WORKSPACE ファイルからアクセス可能な Starlark 言語またはビルド API のセマンティクスに影響します。
--[no]incompatible_config_setting_private_default_visibility のデフォルト: "false"
Compatibility_enforce_config_setting_visibility=false は、NoOps です。それ以外の場合、このフラグが false の場合、明示的な公開設定属性のない config_setting はすべて //visibility:public です。このフラグが true の場合、config_setting は他のすべてのルールと同じ公開設定ロジックに従います。https://github.com/bazelbuild/bazel/issues/12933 をご覧ください。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_disallow_legacy_py_provider のデフォルト: "true"
NoOps(オペレーションなし)はまもなく削除されます。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes のデフォルト: "false"
true の場合、objc_library と objc_import で sdk_frameworks 属性と weak_sdk_frameworks 属性を禁止します。
タグ: build_file_semanticsincompatible_change
--[no]incompatible_enforce_config_setting_visibility のデフォルト: "true"
true の場合、config_setting の公開設定制限を適用します。false の場合、すべての config_setting がすべてのターゲットに表示されます。https://github.com/bazelbuild/bazel/issues/12932 をご覧ください。
タグ: loading_and_analysisincompatible_change
true の場合、objc_library と objc_import の alwayslink 属性のデフォルト値を true にします。
タグ: build_file_semanticsincompatible_change
--[no]incompatible_python_disallow_native_rules のデフォルト: "false"
true の場合、組み込みの py_* ルールを使用するとエラーが発生します。代わりに、rule_python ルールを使用する必要があります。詳細と移行手順については、https://github.com/bazelbuild/bazel/issues/17773 をご覧ください。
タグ: loading_and_analysisincompatible_change
テスト環境またはテストランナーの動作を管理するオプション:
--[no]allow_analysis_failures のデフォルト: "false"
true の場合、ルール ターゲットの分析が失敗すると、ビルド失敗ではなく、エラーの説明を含む AnalysisFailureInfo のインスタンスがターゲットに伝播されます。
タグ: loading_and_analysisexperimental
--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_analysisexperimental
--[no]check_tests_up_to_date のデフォルト: "false"
テストは実行せず、最新のものかどうかを確認するだけです。すべてのテスト結果が最新であれば、テストは正常に完了します。テストのビルドまたは実行が必要な場合、エラーが報告され、テストは失敗します。このオプションは、--check_up_to_date の動作を暗黙的に示唆します。
タグ: execution
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g. memory=10,30,60,100> 回の使用が累積されています
テストのデフォルトのリソース量をオーバーライドします。想定される形式は <resource>=<value> です。1 つの正の数値を <value> として指定すると、すべてのテストサイズのデフォルトのリソースがオーバーライドされます。4 つのカンマ区切りの数値を指定すると、テストサイズの小、中、大、巨大それぞれのリソース量がオーバーライドされます。値は HOST_RAM または HOST_CPU で、オプションで [-|*]<float> が後に続く場合もあります(例: memory=HOST_RAM*.1, HOST_RAM*.2, HOST_RAM*.3, HOST_RAM*.4)。このフラグで指定されたデフォルトのテストリソースは、タグで指定された明示的なリソースによってオーバーライドされます。
--[no]experimental_android_use_parallel_dex2oat のデフォルト: "false"
dex2oat を並行して使用すると、android_test を高速化できます。
タグ: loading_and_analysishost_machine_resource_optimizationsexperimental
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once> 回の使用が累積されています
テストに不合格となった場合、各テストは指定された回数まで再試行されます。複数回の合格が求められたテストは、テストの概要で「FLAKY」と表示されます。通常、指定される値は単なる整数または文字列「default」です。整数の場合、すべてのテストは最大 N 回実行されます。「default」の場合、通常のテストに対しては 1 回だけテストが試行され、ルール(flaky=1 属性)によって「不安定」とマークされたテストは 3 回試行されます。別の構文: regex_filter@flaky_test_attempts。ここで、flaky_test_attempts は上記のとおり、regex_filter は include および除外正規表現パターンのリストを表します(--runs_per_test もご覧ください)。例: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 は、foo/bar の下のテストを除く //foo/内のすべてのテストをデフレークします。このオプションは複数回渡すことができます。最後に渡された引数のうち、一致するものが優先されます。何も一致しない場合、上記の「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_test。run_per_test は整数値を表し、regex_filter は包含および除外正規表現パターンのリストを表します(--instrumentation_filter もご覧ください)。例: --runs_per_test=//foo/.*,-//foo/bar/.*@3 は、foo/bar の下にあるテストを除く //foo/内のすべてのテストを 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
ビルド時間の最適化をトリガーするオプション:
--cache_computed_file_digests=<a long integer> のデフォルト: 「50000」
0 より大きい場合、必要になるたびにディスクからダイジェストを再計算するのではなく、メタデータに基づいてファイル ダイジェストをメモリにキャッシュするように Bazel を構成します。これを 0 に設定すると、すべてのファイルの変更がファイルのメタデータから把握できるわけではないため、正確性が保証されます。0 以外の場合、この値は、キャッシュするファイル ダイジェストの数としてキャッシュのサイズを示します。
--[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_analysisexecutionaffects_outputsexperimental
--[no]experimental_inmemory_jdeps_files のデフォルト: "true"
有効にすると、Java コンパイルで生成された依存関係(.jdeps)ファイルは、ディスクに書き込まれるのではなく、リモート ビルドノードからメモリ内で直接渡されます。
タグ: loading_and_analysisexecutionaffects_outputsexperimental
--[no]experimental_objc_include_scanning のデフォルト: "false"
目的の C/C++ のインクルード スキャンを実行するかどうか。
タグ: loading_and_analysisexecutionchanges_inputs
--[no]experimental_retain_test_configuration_across_testonly のデフォルト: "false"
--trim_test_configuration を有効にすると、testonly=1 とマークされたルールのテスト設定はトリミングされません。これは、テスト以外のルールが cc_test ルールに依存している場合に、アクションの競合の問題を減らすためです。--trim_test_configuration が false の場合は効果がありません。
タグ: loading_and_analysisloses_incremental_state
--[no]experimental_starlark_cc_import のデフォルト: "false"
有効にすると、Starlark バージョンの cc_import を使用できます。
タグ: loading_and_analysisexperimental
--[no]experimental_unsupported_and_brittle_include_scanning のデフォルト: "false"
入力ファイルの #include 行を解析して C/C++ コンパイルへの入力を絞り込むかどうかを指定します。これにより、コンパイル入力ツリーのサイズを小さくすることで、パフォーマンスとインクリメンタリティを向上させることができます。ただし、インクルード スキャナは C プリプロセッサ セマンティクスを完全には実装していないため、ビルドが破損する可能性もあります。特に、動的な #include ディレクティブは認識されず、プリプロセッサの条件付きロジックは無視されます。自己責任で使用してください。このフラグに関連する問題はすべてクローズされます。
タグ: loading_and_analysisexecutionchanges_inputs
--[no]incremental_dexing のデフォルト: "true"
ほとんどの処理は、Jar ファイルごとに個別に dex 変換を行います。
タグ: affects_outputsloading_and_analysisloses_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 コアの半分を使用します)。デフォルト(「HOST_CPUS」)、Bazel はシステム構成に対してクエリを実行し、使用可能な 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> を続けます(例:HOST_RAM*.5 のように指定して、使用可能な RAM の半分を使用します)。デフォルトで(「HOST_RAM*.67」)、Bazel はシステム構成をクエリして使用可能な RAM の量を推定し、その 67% を使用します。
タグ: host_machine_resource_optimizations
--local_resources=<a named double, 'name=value', where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> 回の使用が累積されています
Bazel で使用可能なリソース数を設定します。float または HOST_RAM/HOST_CPUS に代入し、必要に応じて [-|*]<float> を続けます(例: 利用可能な RAM の半分を使用するには、memory=HOST_RAM*.5)。複数回使用して複数のタイプのリソースを指定できます。Bazel は、使用可能なリソースと必要なリソースに基づいて、同時に実行するアクションを制限します。テストでは、resources:<resource name>:<amount> 形式のタグを使用して、必要なリソースの量を宣言できます。--local_{cpu|ram|extra}_resources で指定されたリソースをオーバーライドします。
タグ: host_machine_resource_optimizations
--[no]objc_use_dotd_pruning のデフォルト: "true"
設定すると、clang によって出力された .d ファイルを使用して、objc コンパイルに渡される入力のセットがプルーニングされます。
タグ: changes_inputsloading_and_analysis
--[no]process_headers_in_dependencies のデフォルト: "false"
ターゲット //a:a をビルドするときに、//a:a が依存するすべてのターゲットでヘッダーを処理します(ツールチェーンでヘッダー処理が有効になっている場合)。
タグ: execution
--[no]trim_test_configuration のデフォルト: "true"
有効にすると、ビルドのトップレベルの下でテスト関連のオプションが消去されます。このフラグを有効にすると、テストを非テストルールの依存関係としてビルドすることはできませんが、テスト関連のオプションを変更してもテスト以外のルールが再分析されることはありません。
タグ: loading_and_analysisloses_incremental_state
ロギングの詳細度、形式、場所に影響するオプション:
--[no]experimental_bep_target_summary のデフォルト: "false"
TargetSummary イベントを公開するかどうか。
--[no]experimental_build_event_expand_filesets のデフォルト: "false"
true の場合、出力ファイルを提示するときに BEP でファイルセットを展開します。
タグ: affects_outputs
true の場合、出力ファイルを提示するときに、BEP 内の相対 Fileset シンボリック リンクを完全に解決します。--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 への統合には、重要な出力値が必要です。
タグ: 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」のときに出力できるテストログあたりの最大サイズを指定します。過度にノイズの多いテスト出力で出力が過負荷にならないようにする場合に便利です。テストヘッダーはログサイズに含まれます。負の値は上限なしを意味します。出力は「all」か「No」です。
タグ: test_runnerterminal_outputexecution
--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] デフォルト: "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_runnerterminal_outputexecution
--test_summary=<short, terse, detailed, none or testcase> のデフォルト: "short"
テストサマリーに必要な形式を指定します。有効な値は、実行されたテストに関する情報のみを表示する「short」、実行に失敗したテストに関する情報のみを表示する「terse」、失敗したテストケースに関する詳細情報を出力する「detailed」、テストケースの解決でサマリーを出力する「testcase」、失敗したテストケースに関する詳細情報を出力しない「none」、サマリーを省略する場合は「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 ターゲットの runfile で __init__.py ファイルが自動的に作成されないようにします。正確には、py_binary または py_test のターゲットで legacy_create_init が「auto」(デフォルト)に設定されている場合、このフラグが設定されている場合にのみ false として扱われます。https://github.com/bazelbuild/bazel/issues/10076 をご覧ください。
タグ: affects_outputsincompatible_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_outputsincompatible_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_analysisaffects_outputsincompatible_change
--[no]incompatible_use_python_toolchains のデフォルト: "true"
true に設定すると、実行可能なネイティブの Python ルールは、--python_top などの以前のフラグで指定されたランタイムではなく、Python ツールチェーンで指定された Python ランタイムを使用します。
タグ: loading_and_analysisincompatible_change
--python_version=<PY2 or PY3> のデフォルト: 説明を参照
Python メジャー バージョン モード(PY2 または PY3)。これは py_binary ターゲットと py_test ターゲットによってオーバーライドされるため(バージョンを明示的に指定していない場合でも)、通常はこのフラグを指定する理由はほとんどありません。
タグ: loading_and_analysisaffects_outputs
--target_pattern_file=<a string> のデフォルト: ""
設定すると、ビルドはコマンドラインではなく、ここで指定したファイルからパターンを読み取ります。ファイルとコマンドライン パターンをここに指定すると、エラーになります。
タグ: changes_inputs
リモート キャッシュと実行のオプション:
--experimental_remote_cache_eviction_retries=<an integer> のデフォルト: 「0」
ビルドでリモート キャッシュ エビクション エラーが発生した場合の再試行の最大試行回数。ゼロ以外の値を指定すると、--compatibility_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] デフォルト: "auto"
「auto」に設定すると、(1)Bazel がテストまたはその依存関係の変更を検出した、(2)テストが外部としてマークされている、(3)複数のテスト実行が --runs_per_test でリクエストされた、(4)テストが失敗した場合にのみ、Bazel はテストを再実行します。「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 に従って、実行された生成を、長さで区切られた SpawnExec proto としてこのファイルに記録します。関連フラグ: --execution_log_json_file(テキスト JSON 形式、相互に排他的)、--execution_log_sort(実行ログを並べ替えるかどうか)、--subcommands(ターミナル出力にサブコマンドを表示)。
--execution_log_json_file=<a path> のデフォルト: 説明を参照
src/main/protobuf/spawn.proto に従って、実行された生成を、SpawnExec proto の改行区切りの JSON 表現としてこのファイルに記録します。関連フラグ: --execution_log_binary_file(バイナリ protobuf 形式、相互に排他的)、--execution_log_sort(実行ログを並べ替えるかどうか)、--subcommands(ターミナル出力にサブコマンドを表示)。
--[no]execution_log_sort のデフォルト: "true"
呼び出し間でログを比較しやすくするために、実行ログを並べ替えるかどうかを指定します。false に設定すると、呼び出し終了時に CPU とメモリが大量に使用される可能性がありますが、非決定的な実行順序でログが生成されます。バイナリ形式と JSON 形式にのみ適用されます。コンパクト形式では並べ替えられません。
--[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_outputsloading_and_analysis
--experimental_execution_log_compact_file=<a path> のデフォルト: 説明を参照
src/main/protobuf/spawn.proto に従って、実行された生成を、長さで区切られた ExecLogEntry proto としてこのファイルに記録します。ファイル全体が zstd で圧縮されます。これは現在開発中の試験運用中の形式であり、随時変更される可能性があります。関連フラグ: --execution_log_binary_file(バイナリ protobuf 形式、相互に排他的)、--execution_log_json_file(JSON テキスト形式、相互に排他的)、--subcommands(ターミナル出力にサブコマンドを表示)。
--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_outputsloading_and_analysis
--[no]experimental_generate_llvm_lcov のデフォルト: "false"
true の場合、clang のカバレッジにより LCOV レポートが生成されます。
タグ: affects_outputsloading_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 でのみ使用できます。
--[no]fetch のデフォルト: "true"
コマンドが外部依存関係を取得できるようにします。false に設定すると、依存関係のキャッシュ バージョンが使用されます。依存関係が存在しない場合は、コマンドが失敗します。
--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_analysisincompatible_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_outputsloading_and_analysis
--proto_toolchain_for_cc=<a build target label> のデフォルト: "@bazel_tools//tools/proto:cc_ツールチェーン"
C++ proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル。
タグ: affects_outputsloading_and_analysis
--proto_toolchain_for_j2objc=<a build target label> のデフォルト: "@bazel_tools//tools/j2objc:j2objc_proto_ツールチェーン"
j2objc proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル。
タグ: affects_outputsloading_and_analysis
--proto_toolchain_for_java=<a build target label> のデフォルト: "@bazel_tools//tools/proto:java_ツールチェーン"
Java proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル
タグ: affects_outputsloading_and_analysis
--proto_toolchain_for_javalite=<a build target label> のデフォルト: "@bazel_tools//tools/proto:javalite_ツールチェーン"
JavaLite proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル。
タグ: affects_outputsloading_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> のデフォルト: 「AutoML」
テストのシャーディングの戦略を指定します。「shard_count」BUILD 属性が存在する場合にのみシャーディングを使用する「明示的な」を指定します。テストのシャーディングを使用しないように「disabled」に設定します。「forced=k」は、「shard_count」ビルド属性に関係なく、テスト用の「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 が使用されます。これにより増分コンパイルが高速化されますが、エラー メッセージが異なる場合があります。

正規化フラグのオプション

build からすべてのオプションを継承します。

コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path> 回の使用が累積されています
ネットワークにアクセスしてダウンロードする前にアーカイブを検索する場所の追加。
タグ: bazel_internal_configuration
設定すると、キャッシュ ヒットが発生した場合、リポジトリ キャッシュはファイルをコピーするのではなくハードリンクします。これはディスク容量を節約するためのものです。
タグ: bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer> のデフォルト: 「0」
ダウンロード エラーの再試行の最大試行回数。0 に設定すると、再試行が無効になります。
タグ: experimental
--experimental_scale_timeouts=<a double> のデフォルト: 「1.0」
Starlark リポジトリ ルールのすべてのタイムアウトを、この係数でスケーリングします。このようにして、ソースコードを変更することなく、ルール作成者の想定よりも遅いマシンで外部リポジトリを動作させることができます。
タグ: bazel_internal_configurationexperimental
--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
--[no]incompatible_disable_native_repo_rules のデフォルト: "false"
false の場合、ネイティブ リポジトリ ルールを WORKSPACE で使用できます。それ以外の場合は、代わりに Starlark リポジトリ ルールを使用する必要があります。ネイティブ リポジトリのルールには、local_repository、new_local_repository、local_config_platform、android_sdk_repository、android_ndk_repository があります。
タグ: bazel_internal_configuration
--repository_cache=<a path> のデフォルト: 説明を参照
外部リポジトリの取得中に取得されたダウンロード値のキャッシュの場所を指定します。引数として空の文字列を指定すると、キャッシュの無効化がリクエストされます。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます
タグ: bazel_internal_configuration
--[no]repository_disable_download のデフォルト: "false"
設定した場合、リポジトリの取得中に gke.download{,_and_extract} を使用したダウンロードは許可されません。ネットワーク アクセスは完全には無効にはなりません。インターネットにアクセスする任意の実行可能ファイルを gsuite.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_outputsterminal_output
--[no]experimental_include_default_values のデフォルト: "false"
デフォルト値に設定された Starlark オプションが出力に含まれるかどうか。
タグ: affects_outputsterminal_output
このオプションは、BUILD ファイル、.bzl ファイル、WORKSPACE ファイルからアクセス可能な Starlark 言語またはビルド API のセマンティクスに影響します。
--[no]incompatible_config_setting_private_default_visibility のデフォルト: "false"
Compatibility_enforce_config_setting_visibility=false は、NoOps です。それ以外の場合、このフラグが false の場合、明示的な公開設定属性のない config_setting はすべて //visibility:public です。このフラグが true の場合、config_setting は他のすべてのルールと同じ公開設定ロジックに従います。https://github.com/bazelbuild/bazel/issues/12933 をご覧ください。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_enforce_config_setting_visibility のデフォルト: "true"
true の場合、config_setting の公開設定制限を適用します。false の場合、すべての config_setting がすべてのターゲットに表示されます。https://github.com/bazelbuild/bazel/issues/12932 をご覧ください。
タグ: loading_and_analysisincompatible_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, refresh or error> のデフォルト: "update"
ロックファイルの使用方法と使用方法を指定します。有効な値は、ロックファイルを使用して変更があった場合に更新する「update」、リモート レジストリから変更可能な情報(ヤンクされたバージョンや以前に欠落したモジュール)を随時更新する「refresh」、ロックファイルを使用するが最新でない場合にエラーをスローする「error」、ロックファイルの読み取り / 書き込みを行わない場合は「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
--vendor_dir=<a path> のデフォルト: 説明を参照
外部リポジトリをベンダーモードで保持するディレクトリを指定します。これは、外部リポジトリを取得する目的で、またはビルド中に外部リポジトリを使用するためです。パスは、絶対パスまたはワークスペース ディレクトリへの相対パスで指定できます。
タグ: loading_and_analysis
ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> のデフォルト: "1s:2,20s:3,1m:5"
上限に達すると、GcThrashingDetector が OOM を持つ Bazel をクラッシュさせます。各制限は、<period>:<count> として指定します。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 エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、GC イベントが完全に終了したときに不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、完全な GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、GC イベントが完全に発生し、保持されているヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> のデフォルト: 「2147483647」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、マイナー GC イベントの発生時に不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、マイナー GC イベントが発生して保持ヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer> のデフォルト: 「85」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率がこのしきい値以上であることを検出した場合、不要な一時的な Skyframe 状態を破棄します。これを微調整すると、GC スラッシングが(i)この一時的な状態のメモリ使用量に起因しており、(ii)必要に応じて状態を再構築するよりもコストが高い場合に、GC スラッシングの経過時間への影響を軽減できます。
タグ: host_machine_resource_optimizations
ロギングの詳細度、形式、場所に影響するオプション:
--experimental_command_profile=<cpu, wall, alloc or lock> のデフォルト: 説明を参照
コマンドの実行中に Java フライト レコーダーのプロファイルを記録します。サポートされているプロファイリング イベントタイプ(cpu、wall、alloc、lock)のいずれかを引数として指定する必要があります。プロファイルは、出力ベース ディレクトリの下のイベントタイプに基づいて名前が付けられたファイルに書き込まれます。このフラグの構文とセマンティクスは、他のプロファイル タイプや出力形式をサポートするため今後変更される可能性があります。このフラグは自己責任で使用してください。
--[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_outputsterminal_output
--invocation_policy=<a string> のデフォルト: ""
正規化するオプションに呼び出しポリシーを適用します。
タグ: affects_outputsterminal_output
リモート キャッシュと実行オプション:
--experimental_downloader_config=<a string> のデフォルト: 説明を参照
リモート ダウンローダの構成に使用するファイルを指定します。このファイルは行で構成され、各行の先頭にはディレクティブ(`allow`、`block`、`rewrite`)があり、その後にホスト名(`allow` と `block`)または 2 つのパターン(1 つは照合するパターン、もう 1 つは代替 URL として使用)があり、後方参照は `$1` から始まります。同じ URL に対して複数の rewrite ディレクティブが返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto> のデフォルト: "auto"
リポジトリのフェッチに使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得は再起動の対象となります。それ以外の場合は、仮想ワーカー スレッドを使用します。
その他のカテゴリに該当しないその他のオプション:
--deleted_packages=<comma-separated list of package names> 回の使用が累積されています
パッケージパスのどこかに表示されている場合でも、ビルドシステムが存在しないと見なすパッケージ名のカンマ区切りリスト。 このオプションは、既存のパッケージ「x」のサブパッケージ「x/y」を削除する場合に使用します。たとえば、クライアントで x/y/BUILD を削除した後でも、別の package_path エントリで指定されていれば、ビルドシステムで「//x:y/z」というラベルが検出されるとエラーが表示されることがあります。--deleted_packages x/y を指定すると、この問題を回避できます。
--[no]fetch のデフォルト: "true"
コマンドが外部依存関係を取得できるようにします。false に設定すると、依存関係のキャッシュ バージョンが使用されます。依存関係が存在しない場合は、コマンドが失敗します。
--override_repository=<an equals-separated mapping of repository name to 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
設定すると、キャッシュ ヒットが発生した場合、リポジトリ キャッシュはファイルをコピーするのではなくハードリンクします。これはディスク容量を節約するためのものです。
タグ: bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer> のデフォルト: 「0」
ダウンロード エラーの再試行の最大試行回数。0 に設定すると、再試行が無効になります。
タグ: experimental
--experimental_scale_timeouts=<a double> のデフォルト: 「1.0」
Starlark リポジトリ ルールのすべてのタイムアウトを、この係数でスケーリングします。このようにして、ソースコードを変更することなく、ルール作成者の想定よりも遅いマシンで外部リポジトリを動作させることができます。
タグ: bazel_internal_configurationexperimental
--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
--[no]incompatible_disable_native_repo_rules のデフォルト: "false"
false の場合、ネイティブ リポジトリ ルールを WORKSPACE で使用できます。それ以外の場合は、代わりに Starlark リポジトリ ルールを使用する必要があります。ネイティブ リポジトリのルールには、local_repository、new_local_repository、local_config_platform、android_sdk_repository、android_ndk_repository があります。
タグ: bazel_internal_configuration
--repository_cache=<a path> のデフォルト: 説明を参照
外部リポジトリの取得中に取得されたダウンロード値のキャッシュの場所を指定します。引数として空の文字列を指定すると、キャッシュの無効化がリクエストされます。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます
タグ: bazel_internal_configuration
--[no]repository_disable_download のデフォルト: "false"
設定した場合、リポジトリの取得中に gke.download{,_and_extract} を使用したダウンロードは許可されません。ネットワーク アクセスは完全には無効にはなりません。インターネットにアクセスする任意の実行可能ファイルを gsuite.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 の場合、Clean は、この 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, refresh or error> のデフォルト: "update"
ロックファイルの使用方法と使用方法を指定します。有効な値は、ロックファイルを使用して変更があった場合に更新する「update」、リモート レジストリから変更可能な情報(ヤンクされたバージョンや以前に欠落したモジュール)を随時更新する「refresh」、ロックファイルを使用するが最新でない場合にエラーをスローする「error」、ロックファイルの読み取り / 書き込みを行わない場合は「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
--vendor_dir=<a path> のデフォルト: 説明を参照
外部リポジトリをベンダーモードで保持するディレクトリを指定します。これは、外部リポジトリを取得する目的で、またはビルド中に外部リポジトリを使用するためです。パスは、絶対パスまたはワークスペース ディレクトリへの相対パスで指定できます。
タグ: loading_and_analysis
ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> のデフォルト: "1s:2,20s:3,1m:5"
上限に達すると、GcThrashingDetector が OOM を持つ Bazel をクラッシュさせます。各制限は、<period>:<count> として指定します。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 エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、GC イベントが完全に終了したときに不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、完全な GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、GC イベントが完全に発生し、保持されているヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> のデフォルト: 「2147483647」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、マイナー GC イベントの発生時に不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、マイナー GC イベントが発生して保持ヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer> のデフォルト: 「85」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率がこのしきい値以上であることを検出した場合、不要な一時的な Skyframe 状態を破棄します。これを微調整すると、GC スラッシングが(i)この一時的な状態のメモリ使用量に起因しており、(ii)必要に応じて状態を再構築するよりもコストが高い場合に、GC スラッシングの経過時間への影響を軽減できます。
タグ: host_machine_resource_optimizations
ロギングの詳細度、形式、場所に影響するオプション:
--experimental_command_profile=<cpu, wall, alloc or lock> のデフォルト: 説明を参照
コマンドの実行中に Java フライト レコーダーのプロファイルを記録します。サポートされているプロファイリング イベントタイプ(cpu、wall、alloc、lock)のいずれかを引数として指定する必要があります。プロファイルは、出力ベース ディレクトリの下のイベントタイプに基づいて名前が付けられたファイルに書き込まれます。このフラグの構文とセマンティクスは、他のプロファイル タイプや出力形式をサポートするため今後変更される可能性があります。このフラグは自己責任で使用してください。
--[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` から始まります。同じ URL に対して複数の rewrite ディレクティブが返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto> のデフォルト: "auto"
リポジトリのフェッチに使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得は再起動の対象となります。それ以外の場合は、仮想ワーカー スレッドを使用します。
その他のカテゴリに該当しないその他のオプション:
--override_repository=<an equals-separated mapping of repository name to path> 回の使用が累積されています
リポジトリは、<リポジトリ名>=<パス> 形式のローカルパスでオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。指定したパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定したパスが「%workspace%」で始まる場合は、「bazel info workspace」の出力であるワークスペースのルートからの相対パスになります。

構成オプション

カバレッジ オプション

test のすべてのオプションを継承します。

コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path> 回の使用が累積されています
ネットワークにアクセスしてダウンロードする前にアーカイブを検索する場所の追加。
タグ: bazel_internal_configuration
設定すると、キャッシュ ヒットが発生した場合、リポジトリ キャッシュはファイルをコピーするのではなくハードリンクします。これはディスク容量を節約するためのものです。
タグ: bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer> のデフォルト: 「0」
ダウンロード エラーの再試行の最大試行回数。0 に設定すると、再試行が無効になります。
タグ: experimental
--experimental_scale_timeouts=<a double> のデフォルト: 「1.0」
Starlark リポジトリ ルールのすべてのタイムアウトを、この係数でスケーリングします。このようにして、ソースコードを変更することなく、ルール作成者の想定よりも遅いマシンで外部リポジトリを動作させることができます。
タグ: bazel_internal_configurationexperimental
--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
--[no]incompatible_disable_native_repo_rules のデフォルト: "false"
false の場合、ネイティブ リポジトリ ルールを WORKSPACE で使用できます。それ以外の場合は、代わりに Starlark リポジトリ ルールを使用する必要があります。ネイティブ リポジトリのルールには、local_repository、new_local_repository、local_config_platform、android_sdk_repository、android_ndk_repository があります。
タグ: bazel_internal_configuration
--repository_cache=<a path> のデフォルト: 説明を参照
外部リポジトリの取得中に取得されたダウンロード値のキャッシュの場所を指定します。引数として空の文字列を指定すると、キャッシュの無効化がリクエストされます。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます
タグ: bazel_internal_configuration
--[no]repository_disable_download のデフォルト: "false"
設定した場合、リポジトリの取得中に gke.download{,_and_extract} を使用したダウンロードは許可されません。ネットワーク アクセスは完全には無効にはなりません。インターネットにアクセスする任意の実行可能ファイルを gsuite.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, refresh or error> のデフォルト: "update"
ロックファイルの使用方法と使用方法を指定します。有効な値は、ロックファイルを使用して変更があった場合に更新する「update」、リモート レジストリから変更可能な情報(ヤンクされたバージョンや以前に欠落したモジュール)を随時更新する「refresh」、ロックファイルを使用するが最新でない場合にエラーをスローする「error」、ロックファイルの読み取り / 書き込みを行わない場合は「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
--vendor_dir=<a path> のデフォルト: 説明を参照
外部リポジトリをベンダーモードで保持するディレクトリを指定します。これは、外部リポジトリを取得する目的で、またはビルド中に外部リポジトリを使用するためです。パスは、絶対パスまたはワークスペース ディレクトリへの相対パスで指定できます。
タグ: loading_and_analysis
ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> のデフォルト: "1s:2,20s:3,1m:5"
上限に達すると、GcThrashingDetector が OOM を持つ Bazel をクラッシュさせます。各制限は、<period>:<count> として指定します。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 エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、GC イベントが完全に終了したときに不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、完全な GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、GC イベントが完全に発生し、保持されているヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> のデフォルト: 「2147483647」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、マイナー GC イベントの発生時に不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、マイナー GC イベントが発生して保持ヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer> のデフォルト: 「85」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率がこのしきい値以上であることを検出した場合、不要な一時的な Skyframe 状態を破棄します。これを微調整すると、GC スラッシングが(i)この一時的な状態のメモリ使用量に起因しており、(ii)必要に応じて状態を再構築するよりもコストが高い場合に、GC スラッシングの経過時間への影響を軽減できます。
タグ: host_machine_resource_optimizations
ロギングの詳細度、形式、場所に影響するオプション:
--experimental_command_profile=<cpu, wall, alloc or lock> のデフォルト: 説明を参照
コマンドの実行中に Java フライト レコーダーのプロファイルを記録します。サポートされているプロファイリング イベントタイプ(cpu、wall、alloc、lock)のいずれかを引数として指定する必要があります。プロファイルは、出力ベース ディレクトリの下のイベントタイプに基づいて名前が付けられたファイルに書き込まれます。このフラグの構文とセマンティクスは、他のプロファイル タイプや出力形式をサポートするため今後変更される可能性があります。このフラグは自己責任で使用してください。
--[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` から始まります。同じ URL に対して複数の rewrite ディレクティブが返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto> のデフォルト: "auto"
リポジトリのフェッチに使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得は再起動の対象となります。それ以外の場合は、仮想ワーカー スレッドを使用します。
その他のカテゴリに該当しないその他のオプション:
--override_repository=<an equals-separated mapping of repository name to path> 回の使用が累積されています
リポジトリは、<リポジトリ名>=<パス> 形式のローカルパスでオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。指定したパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定したパスが「%workspace%」で始まる場合は、「bazel info workspace」の出力であるワークスペースのルートからの相対パスになります。

Cquery のオプション

test のすべてのオプションを継承します。

コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path> 回の使用が累積されています
ネットワークにアクセスしてダウンロードする前にアーカイブを検索する場所の追加。
タグ: bazel_internal_configuration
設定すると、キャッシュ ヒットが発生した場合、リポジトリ キャッシュはファイルをコピーするのではなくハードリンクします。これはディスク容量を節約するためのものです。
タグ: bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer> のデフォルト: 「0」
ダウンロード エラーの再試行の最大試行回数。0 に設定すると、再試行が無効になります。
タグ: experimental
--experimental_scale_timeouts=<a double> のデフォルト: 「1.0」
Starlark リポジトリ ルールのすべてのタイムアウトを、この係数でスケーリングします。このようにして、ソースコードを変更することなく、ルール作成者の想定よりも遅いマシンで外部リポジトリを動作させることができます。
タグ: bazel_internal_configurationexperimental
--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
--[no]incompatible_disable_native_repo_rules のデフォルト: "false"
false の場合、ネイティブ リポジトリ ルールを WORKSPACE で使用できます。それ以外の場合は、代わりに Starlark リポジトリ ルールを使用する必要があります。ネイティブ リポジトリのルールには、local_repository、new_local_repository、local_config_platform、android_sdk_repository、android_ndk_repository があります。
タグ: bazel_internal_configuration
--repository_cache=<a path> のデフォルト: 説明を参照
外部リポジトリの取得中に取得されたダウンロード値のキャッシュの場所を指定します。引数として空の文字列を指定すると、キャッシュの無効化がリクエストされます。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます
タグ: bazel_internal_configuration
--[no]repository_disable_download のデフォルト: "false"
設定した場合、リポジトリの取得中に gke.download{,_and_extract} を使用したダウンロードは許可されません。ネットワーク アクセスは完全には無効にはなりません。インターネットにアクセスする任意の実行可能ファイルを gsuite.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」(デフォルト)は、直接依存関係のルールクラスが指定されているかどうかに関係なく、宣言されたすべてのアスペクト依存関係が追加されることを意味します。「precise」は、直接依存関係のルールクラスでアクティブになる可能性のあるアスペクトのみが追加されることを意味します。なお、高精度モードでは、1 つのターゲットを評価するために他のパッケージを読み込む必要があるため、他のモードよりも時間がかかります。また、正確なモードでさえも完全に正確というわけではありません。アスペクトを計算するかどうかの決定は、分析フェーズで決定され、「Bazel クエリ」中には実行されません。
タグ: build_file_semantics
--[no]consistent_labels のデフォルト: "false"
有効にすると、すべてのクエリコマンドは <code>Label</code> インスタンスに適用される Starlark <code>str</code> 関数と同様にラベルを出力します。これは、さまざまなクエリコマンドやルールによって出力されたラベルの出力を照合する必要があるツールに役立ちます。有効になっていない場合、出力フォーマッタは、出力を読みやすくするために(メイン リポジトリからの相対的な)明らかなリポジトリ名を自由に出力できます。
タグ: terminal_output
--[no]experimental_explicit_aspects のデフォルト: "false"
aquery, cquery: アスペクトで生成されたアクションを出力に含めるかどうかクエリ: no-op(アスペクトは常に従う)
タグ: 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: アスペクトで生成されたアクションを出力に含めるかどうかクエリ: no-op(アスペクトは常に従う)
タグ: terminal_output
--[no]incompatible_package_group_includes_double_slash のデフォルト: "true"
有効にすると、package_group の `packages` 属性を出力するときに、先頭の `//` が省略されません。
タグ: terminal_outputincompatible_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=(lite|full) オプションも指定する必要があります。
タグ: terminal_output
--[no]proto:default_values のデフォルト: "true"
true の場合、値が明示的に指定されていない属性が含まれます。それ以外の場合は、省略されます。このオプションは --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> のデフォルト: ""
設定すると、query はコマンドラインではなく、ここで指定したファイルからクエリを読み取ります。ここにファイルとコマンドライン クエリを指定するとエラーになります。
タグ: 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 式。構成されたターゲットは「target」にバインドされています。--starlark:expr と --starlark:file のどちらも指定されていない場合、このオプションはデフォルトで「str(target.label)」になります。--starlark:expr と --starlark:file の両方を指定するとエラーになります。
タグ: terminal_output
--starlark:file=<a string> のデフォルト: ""
1 つの引数の「format」という Starlark 関数を定義するファイルの名前。文字列としてフォーマットするために各構成済みターゲットに適用されます。--starlark:expr と --starlark:file の両方を指定するとエラーになります。詳細については、--output=starlark のヘルプをご覧ください。
タグ: terminal_output
--[no]tool_deps のデフォルト: "true"
クエリ: 無効にすると、「exec configuration」への依存関係は、クエリが動作する依存関係グラフに含まれません。任意の「proto_library」ルールからプロトコル コンパイラへの依存関係エッジなど、「exec 構成」依存関係エッジは、通常、同じ「ターゲット」プログラムの一部ではなく、ビルド中に実行されるツールを指しています。Cquery: 無効にすると、構成済みのターゲットを検出した最上位のターゲットから、実行遷移をまたぐ構成済みのターゲットがすべて除外されます。つまり、最上位のターゲットがターゲット構成にある場合は、同じターゲット構成にも構成されたターゲットのみが返されます。最上位のターゲットが exec 構成に含まれている場合は、exec 構成のターゲットのみが返されます。このオプションでは、解決済みのツールチェーンは除外されません。
タグ: build_file_semantics
--transitions=<full, lite or none> のデフォルト: 「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, refresh or error> のデフォルト: "update"
ロックファイルの使用方法と使用方法を指定します。有効な値は、ロックファイルを使用して変更があった場合に更新する「update」、リモート レジストリから変更可能な情報(ヤンクされたバージョンや以前に欠落したモジュール)を随時更新する「refresh」、ロックファイルを使用するが最新でない場合にエラーをスローする「error」、ロックファイルの読み取り / 書き込みを行わない場合は「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
--vendor_dir=<a path> のデフォルト: 説明を参照
外部リポジトリをベンダーモードで保持するディレクトリを指定します。これは、外部リポジトリを取得する目的で、またはビルド中に外部リポジトリを使用するためです。パスは、絶対パスまたはワークスペース ディレクトリへの相対パスで指定できます。
タグ: loading_and_analysis
ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> のデフォルト: "1s:2,20s:3,1m:5"
上限に達すると、GcThrashingDetector が OOM を持つ Bazel をクラッシュさせます。各制限は、<period>:<count> として指定します。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 エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、GC イベントが完全に終了したときに不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、完全な GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、GC イベントが完全に発生し、保持されているヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> のデフォルト: 「2147483647」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、マイナー GC イベントの発生時に不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、マイナー GC イベントが発生して保持ヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer> のデフォルト: 「85」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率がこのしきい値以上であることを検出した場合、不要な一時的な Skyframe 状態を破棄します。これを微調整すると、GC スラッシングが(i)この一時的な状態のメモリ使用量に起因しており、(ii)必要に応じて状態を再構築するよりもコストが高い場合に、GC スラッシングの経過時間への影響を軽減できます。
タグ: host_machine_resource_optimizations
ロギングの詳細度、形式、場所に影響するオプション:
--experimental_command_profile=<cpu, wall, alloc or lock> のデフォルト: 説明を参照
コマンドの実行中に Java フライト レコーダーのプロファイルを記録します。サポートされているプロファイリング イベントタイプ(cpu、wall、alloc、lock)のいずれかを引数として指定する必要があります。プロファイルは、出力ベース ディレクトリの下のイベントタイプに基づいて名前が付けられたファイルに書き込まれます。このフラグの構文とセマンティクスは、他のプロファイル タイプや出力形式をサポートするため今後変更される可能性があります。このフラグは自己責任で使用してください。
--[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` から始まります。同じ URL に対して複数の rewrite ディレクティブが返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto> のデフォルト: "auto"
リポジトリのフェッチに使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得は再起動の対象となります。それ以外の場合は、仮想ワーカー スレッドを使用します。
その他のカテゴリに該当しないその他のオプション:
--override_repository=<an equals-separated mapping of repository name to path> 回の使用が累積されています
リポジトリは、<リポジトリ名>=<パス> 形式のローカルパスでオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。指定したパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定したパスが「%workspace%」で始まる場合は、「bazel info workspace」の出力であるワークスペースのルートからの相対パスとなります。
ビルド実行を制御するオプション:
ファイル システムを直接呼び出してシンボリック リンク ツリーを作成するかどうか
タグ: loading_and_analysisexecutionexperimental
--[no]experimental_persistent_aar_extractor のデフォルト: "false"
ワーカーを使用して永続的な AAR エクストラクタを有効にします。
タグ: execution
--[no]experimental_remotable_source_manifests のデフォルト: "false"
ソース マニフェストのアクションをリモート可能にするかどうか
タグ: loading_and_analysisexecutionexperimental
--[no]experimental_split_coverage_postprocessing のデフォルト: "false"
true の場合、Bazel は新しい Spwn でテスト用のカバレッジ後処理を実行します。
タグ: execution
--[no]experimental_strict_fileset_output のデフォルト: "false"
このオプションを有効にすると、ファイルセットはすべての出力アーティファクトを通常のファイルとして扱います。ディレクトリを走査したり、シンボリック リンクの影響を受けたりしません。
タグ: execution
--[no]incompatible_disallow_unsound_directory_outputs のデフォルト: "true"
設定すると、出力ファイルをディレクトリとして実体化するアクションでエラーになります。ソース ディレクトリには影響しません。https://github.com/bazelbuild/bazel/issues/18646 をご覧ください。
タグ: bazel_internal_configurationincompatible_change
--[no]incompatible_modify_execution_info_additive のデフォルト: "false"
有効にすると、複数の --modify_execution_info フラグを渡すことで追加されます。無効にすると、最後のフラグのみが考慮されます。
タグ: executionaffects_outputsloading_and_analysisincompatible_change
--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」を削除します。
タグ: executionaffects_outputsloading_and_analysis
--persistent_android_dex_desugar
ワーカーを使用して、永続的な Android dex アクションと desugar アクションを有効にします。
展開先:
  --internal_persistent_android_dex_desugar
  --strategy=Desugar=worker
  --strategy=DexBuilder=worker

タグ: host_machine_resource_optimizationsexecution
--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=AARGenerator=worker--strategy=ProcessDatabinding=worker--strategy=GenerateDataBindingBaseClasses=workerhost_machine_resource_optimizationsexecution
--persistent_multiplex_android_dex_desugar
ワーカーを使用して、永続的な多重化された Android dex アクションと desugar アクションを有効にします。
展開先:
  --persistent_android_dex_desugar
  --internal_persistent_multiplex_android_dex_desugar

タグ: host_machine_resource_optimizationsexecution
--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-workerss
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers

--modify_execution_info=AARGenerator=+supports-multiplex-workershost_machine_resource_optimizationsexecution
--persistent_multiplex_android_tools
永続的な Android ツールと多重化された Android ツール(dex 変換、desugar、リソース処理)を有効にします。
展開先:
  --internal_persistent_multiplex_busybox_tools
  --persistent_multiplex_android_resource_processor
  --persistent_multiplex_android_dex_desugar

タグ: host_machine_resource_optimizationsexecution
--[no]use_target_platform_for_tests のデフォルト: "false"
true の場合、Bazel はテスト実行グループではなく、ターゲット プラットフォームを使用してテストを実行します。
タグ: execution
アクションの実行に使用するツールチェーンを構成するオプション:
--android_compiler=<a string> のデフォルト: 説明を参照
Android ターゲット コンパイラ。
タグ: affects_outputsloading_and_analysisloses_incremental_state
--android_crosstool_top=<a build target label> のデフォルト: 「//external:android/crosstool」
Android ビルドに使用される C++ コンパイラの場所。
タグ: affects_outputschanges_inputsloading_and_analysisloses_incremental_state
--android_grte_top=<a label> のデフォルト: 説明を参照
Android ターゲットの grte_top を指定します。
タグ: changes_inputsloading_and_analysisloses_incremental_state
--android_manifest_merger=<legacy, android or force_android> のデフォルト: "android"
android_binary ルールに使用するマニフェスト マージツールを選択します。従来のマージツールから Android マニフェスト マージツールへの移行をサポートするフラグ。
タグ: affects_outputsloading_and_analysisloses_incremental_state
--android_platforms=<a build target label> のデフォルト: ""
android_binary ターゲットが使用するプラットフォームを設定します。複数のプラットフォームが指定されている場合、バイナリはファット APK になります。この APK には、指定された各ターゲット プラットフォームのネイティブ バイナリが含まれています。
タグ: changes_inputsloading_and_analysisloses_incremental_state
--android_sdk=<a build target label> のデフォルト: "@bazel_tools//tools/android:sdk"
Android アプリのビルドに使用する Android SDK/プラットフォームを指定します。
タグ: changes_inputsloading_and_analysisloses_incremental_state
--apple_crosstool_top=<a build target label> デフォルト: "@bazel_tools//tools/cpp:ツールチェーン"
Apple ルールと Objc ルール、およびそれらの依存関係で使用されるクロスツール パッケージのラベル。
タグ: loses_incremental_statechanges_inputs
--cc_output_directory_tag=<a string> のデフォルト: ""
構成ディレクトリに追加する接尾辞を指定します。
タグ: affects_outputs
--compiler=<a string> のデフォルト: 説明を参照
ターゲットのコンパイルに使用する C++ コンパイラ。
タグ: loading_and_analysisexecution
--coverage_output_generator=<a build target label> のデフォルト: "@bazel_tools//tools/test:lcov_merger"
未加工のカバレッジ レポートの後処理に使用されるバイナリの場所。現在は、単一のファイル(バイナリ)を含むファイル グループである必要があります。デフォルトは「//tools/test:lcov_merger」です。
タグ: changes_inputsaffects_outputsloading_and_analysis
--coverage_report_generator=<a build target label> デフォルト: "@bazel_tools//tools/test:coverage_report_generator"
カバレッジ レポートの生成に使用されるバイナリの場所。現在は、単一のファイル(バイナリ)を含むファイル グループである必要があります。デフォルトは「//tools/test:coverage_report_generator」です。
タグ: changes_inputsaffects_outputsloading_and_analysis
--coverage_support=<a build target label> デフォルト: "@bazel_tools//tools/test:coverage_support"
コード カバレッジを収集するすべてのテスト アクションの入力で必要なサポート ファイルの場所。デフォルトは「//tools/test:coverage_support」です。
タグ: changes_inputsaffects_outputsloading_and_analysis
--crosstool_top=<a build target label> デフォルト: "@bazel_tools//tools/cpp:ツールチェーン"
C++ コードのコンパイルに使用されるクロスツール パッケージのラベル。
タグ: loading_and_analysischanges_inputsaffects_outputs
--custom_malloc=<a build target label> のデフォルト: 説明を参照
カスタム Maloc 実装を指定します。この設定は、ビルドルールの Maloc 属性をオーバーライドします。
タグ: changes_inputsaffects_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_stateloading_and_analysisexecution
--[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_ツールチェーン s() によって WORKSPACE ファイルで宣言されたものの前に考慮されます。
タグ: affects_outputschanges_inputsloading_and_analysis
--grte_top=<a label> のデフォルト: 説明を参照
チェックインされた libc ライブラリへのラベル。デフォルト値はクロスツール ツールチェーンによって選択されるため、オーバーライドする必要はほとんどありません。
タグ: action_command_linesaffects_outputs
--host_compiler=<a string> のデフォルト: 説明を参照
ホスト コンパイルに使用する C++ コンパイラ。--host_crosstool_top が設定されていない場合、無視されます。
タグ: loading_and_analysisexecution
--host_crosstool_top=<a build target label> のデフォルト: 説明を参照
デフォルトでは、exec 構成には --crosstool_top オプションと --compiler オプションも使用されます。このフラグを指定すると、Bazel は指定された crosstool_top に対してデフォルトの libc とコンパイラを使用します。
タグ: loading_and_analysischanges_inputsaffects_outputs
--host_grte_top=<a label> のデフォルト: 説明を参照
指定すると、exec 構成の libc 最上位ディレクトリ(--grte_top)がオーバーライドされます。
タグ: action_command_linesaffects_outputs
--host_platform=<a build target label> デフォルト: "@bazel_tools//tools:host_platform"
ホストシステムを記述するプラットフォーム ルールのラベル。
タグ: affects_outputschanges_inputsloading_and_analysis
--[no]incompatible_dont_enable_host_nonhost_crosstool_features のデフォルト: "true"
true の場合、Bazel は C++ ツールチェーンの「host」機能と「nonhost」機能を有効にしません(詳しくは、https://github.com/bazelbuild/bazel/issues/7407 をご覧ください)。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_enable_android_toolchain_resolution のデフォルト: "true"
ツールチェーン解決を使用して、Android ルール用の Android SDK を選択します(Starlark とネイティブ)
タグ: loading_and_analysisincompatible_change
--[no]incompatible_enable_apple_toolchain_resolution のデフォルト: "false"
ツールチェーン解決を使用して、apple ルール用の Apple SDK を選択します(Starlark とネイティブ)
タグ: loading_and_analysisincompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone のデフォルト: "true"
true の場合、Bazel は lto インデックス作成コマンドラインに C++ リンク アクション コマンドラインを再利用しません(詳しくは、https://github.com/bazelbuild/bazel/issues/6791 をご覧ください)。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_remove_legacy_whole_archive のデフォルト: "true"
true の場合、Bazel はデフォルトでライブラリの依存関係をアーカイブ全体としてリンクしません(移行手順については、https://github.com/bazelbuild/bazel/issues/7362 をご覧ください)。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_require_ctx_in_configure_features のデフォルト: "true"
true の場合、Bazel は cc_common.configure_features に 'gsuite' パラメータを必要とします(詳しくは、https://github.com/bazelbuild/bazel/issues/7793 をご覧ください)。
タグ: loading_and_analysisincompatible_change
--[no]interface_shared_objects のデフォルト: "true"
ツールチェーンでサポートされている場合は、インターフェース共有オブジェクトを使用します。現在、この設定はすべての ELF ツールチェーンでサポートされています。
タグ: loading_and_analysisaffects_outputsaffects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> のデフォルト: 説明を参照
iOS アプリのビルドに使用する iOS SDK のバージョンを指定します。指定しない場合は、「xcode_version」のデフォルトの iOS SDK バージョンが使用されます。
タグ: loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> のデフォルト: 説明を参照
macOS アプリケーションのビルドに使用する macOS SDK のバージョンを指定します。指定しない場合は、「xcode_version」のデフォルトの macOS SDK バージョンを使用します。
タグ: loses_incremental_state
--minimum_os_version=<a string> のデフォルト: 説明を参照
コンパイルの対象となる最小 OS バージョン。
タグ: loading_and_analysisaffects_outputs
--platform_mappings=<a relative path> のデフォルト: ""
マッピング ファイルの場所。プラットフォームが設定されていない場合に使用するプラットフォーム、またはプラットフォームがすでに存在する場合に設定するフラグを記述します。メインのワークスペースのルートからの相対パスにする必要があります。デフォルトは「platform_mappings」(ワークスペース ルートの直下にあるファイル)です。
タグ: affects_outputschanges_inputsloading_and_analysis
--platforms=<a build target label> のデフォルト: ""
現在のコマンドのターゲット プラットフォームを記述するプラットフォーム ルールのラベル。
タグ: affects_outputschanges_inputsloading_and_analysis
--python2_path=<a string> のデフォルト: 説明を参照
非推奨、NoOps。「--compatibility_use_python_ツールチェーン」によって無効。
タグ: no_opdeprecated
--python3_path=<a string> のデフォルト: 説明を参照
非推奨、NoOps。「--compatibility_use_python_ツールチェーン」によって無効。
タグ: no_opdeprecated
--python_path=<a string> のデフォルト: 説明を参照
ターゲット プラットフォームで Python ターゲットを実行するために呼び出される Python インタープリタの絶対パス。非推奨。--compatible_use_python_ツールチェーン s によって無効になっています。
タグ: loading_and_analysisaffects_outputs
--python_top=<a build target label> のデフォルト: 説明を参照
ターゲット プラットフォームで Python ターゲットを実行するために呼び出される Python インタープリタを表す py_runtime のラベル。非推奨。--compatible_use_python_ツールチェーン s によって無効になっています。
タグ: loading_and_analysisaffects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> のデフォルト: 説明を参照
tvOS アプリのビルドに使用する tvOS SDK のバージョンを指定します。指定しない場合は、「xcode_version」のデフォルトの tvOS SDK バージョンを使用します。
タグ: 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_stateloading_and_analysis
コマンドの出力を制御するオプション:
--[no]apple_generate_dsym のデフォルト: "false"
デバッグ シンボル(.dSYM)ファイルを生成するかどうかを指定します。
タグ: affects_outputsaction_command_lines
true の場合、すべてのターゲットのランファイル シンボリック リンク フォレストをビルドします。false の場合は、ローカル アクション、テスト、または実行コマンドで必要とされる場合にのみ書き込みます。
タグ: affects_outputs
--[no]build_runfile_manifests のデフォルト: "true"
true の場合、すべてのターゲットの runfile マニフェストを書き込みます。false の場合は省略します。false の場合、ローカルテストは実行に失敗します。
タグ: affects_outputs
--[no]build_test_dwp のデフォルト: "false"
有効にすると、C++ テストを静的かつ fission でビルドするときに、テストバイナリの .dwp ファイルも自動的にビルドされます。
タグ: loading_and_analysisaffects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options> のデフォルト: ".pb.h"
cc_proto_library が作成するヘッダー ファイルの接尾辞を設定します。
タグ: affects_outputsloading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options> のデフォルト: 「.pb.cc」
cc_proto_library が作成するソースファイルの接尾辞を設定します。
タグ: affects_outputsloading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info のデフォルト: "false"
proto_library で、代替 Java API バージョンの追加アクションを実行します。
タグ: affects_outputsloading_and_analysisexperimental
--[no]experimental_proto_extra_actions のデフォルト: "false"
proto_library で、代替 Java API バージョンの追加アクションを実行します。
タグ: affects_outputsloading_and_analysisexperimental
--[no]experimental_save_feature_state のデフォルト: "false"
有効化されリクエストされた機能の状態をコンパイルの出力として保存します。
タグ: affects_outputsexperimental
--fission=<a set of compilation modes> のデフォルト: 「no」
C++ コンパイルとリンクに分裂を使用するコンパイル モードを指定します。{'fastbuild', 'dbg', 'opt'} の任意の組み合わせにできます。すべてのモードを有効にする場合は 'yes'、すべてのモードを無効にする特殊な値 'no' にすることもできます。
タグ: loading_and_analysisaction_command_linesaffects_outputs
--[no]incompatible_always_include_files_in_data のデフォルト: "true"
true の場合、ネイティブ ルールによってデータ依存関係の <code>DefaultInfo.files</code> が実行ファイルに追加されます。これは、Starlark ルールの推奨動作(https://bazel.build/extending/rules#runfiles_features_to_avoid)と一致します。
タグ: affects_outputsincompatible_change
--[no]legacy_external_runfiles のデフォルト: "true"
true の場合、外部リポジトリのランファイル シンボリック リンク フォレストを(.runfiles/repo に加えて).runfiles/wsname/external/repo にビルドします。
タグ: 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_outputsloading_and_analysisloses_incremental_state
--[no]android_databinding_use_androidx のデフォルト: "true"
AndroidX 互換のデータ バインディング ファイルを生成します。これは、データ バインディング v2 でのみ使用されます。このフラグは機能しません。
タグ: affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[no]android_databinding_use_v3_4_args のデフォルト: "true"
Android データ バインディング v2 を 3.4.0 引数で使用します。このフラグは機能しません。
タグ: affects_outputsloading_and_analysisloses_incremental_stateexperimental
--android_dynamic_mode=<off, default or fully> のデフォルト: 「off」
cc_binary で共有ライブラリが明示的に作成されていない場合に、Android ルールの C++ 依存関係を動的にリンクするかどうかを指定します。「default」を選択すると、動的にリンクするかどうかが bazel によって選択されます。「complete」はすべてのライブラリが動的にリンクされることを意味します。「オフ」は、すべてのライブラリがほぼ静的モードでリンクされることを意味します。
タグ: affects_outputsloading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency> のデフォルト: 「alphabetical」
Android バイナリのマニフェスト マージツールに渡されるマニフェストの順序を設定します。ALPHABETICAL は、マニフェストが execroot からの相対パスで並べ替えられることを意味します。ALPHABETICAL_BY_CONFIGURATION は、出力ディレクトリ内の構成ディレクトリからの相対パスでマニフェストが並べ替えられることを意味します。DEPENDENCY は、各ライブラリのマニフェストが依存関係のマニフェストの前に来るようにマニフェストが並べ替えられることを意味します。
タグ: action_command_linesexecution
--[no]android_resource_shrinking のデフォルト: "false"
ProGuard を使用する android_binary APK のリソース圧縮を有効にします。
タグ: affects_outputsloading_and_analysis
--[no]build_python_zip のデフォルト: "auto"
Python の実行可能 zip をビルドします(Windows の場合はオフ、他のプラットフォームの場合はオフ)。
タグ: affects_outputs
--catalyst_cpus=<comma-separated list of options> 回の使用が累積されています
Apple Catalyst バイナリをビルドするアーキテクチャのカンマ区切りリスト。
タグ: loses_incremental_stateloading_and_analysis
--[no]collect_code_coverage のデフォルト: "false"
指定した場合、Bazel は(可能な場合はオフライン インストルメンテーションを使用して)コードをインストルメント化し、テスト中にカバレッジ情報を収集します。--instrumentation_filter に一致するターゲットのみが影響を受けます。通常、このオプションは直接指定せず、代わりに「bazelCoverage」コマンドを使用する必要があります。
タグ: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] デフォルト: "fastbuild"
バイナリをビルドするモードを指定します。値: fastbuild、dbg、opt。
タグ: affects_outputsaction_command_lines
--conlyopt=<a string> 回の使用が累積されています
C ソースファイルのコンパイル時に gcc に渡す追加オプション。
タグ: action_command_linesaffects_outputs
--copt=<a string> 回の使用が累積されています
gcc に渡す追加オプション。
タグ: action_command_linesaffects_outputs
--cpu=<a string> のデフォルト: ""
ターゲット CPU。
タグ: changes_inputsaffects_outputs
--cs_fdo_absolute_path=<a string> のデフォルト: 説明を参照
CSFDO のプロファイル情報を使用してコンパイルを最適化します。プロファイル ファイル(未加工またはインデックス付き LLVM プロファイル ファイル)を含む zip ファイルの絶対パス名を指定します。
タグ: 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_linesaffects_outputs
--define=<a 'name=value' assignment> 回の使用が累積されています
--define オプションごとにビルド変数の割り当てを指定します。
タグ: changes_inputsaffects_outputs
--dynamic_mode=<off, default or fully> のデフォルト: "default"
C++ バイナリを動的にリンクするかどうかを指定します。「default」を選択すると、Bazel が動的にリンクするかどうかを選択します。「complete」はすべてのライブラリが動的にリンクされることを意味します。「オフ」は、すべてのライブラリがほぼ静的モードでリンクされることを意味します。
タグ: loading_and_analysisaffects_outputs
--[no]enable_fdo_profile_absolute_path のデフォルト: "true"
設定すると、fdo_specific_profile_path を使用するとエラーが発生します。
タグ: affects_outputs
--[no]enable_runfiles のデフォルト: "auto"
runfiles シンボリック リンク ツリーを有効にする: Windows では、他のプラットフォームではデフォルトで無効になっています。
タグ: affects_outputs
--experimental_action_listener=<a build target label> 回の使用が累積されています
アスペクトを優先するため非推奨となりました。action_listener を使用して、既存のビルド アクションに extra_action をアタッチします。
タグ: executionexperimental
--[no]experimental_android_compress_java_resources のデフォルト: "false"
APK 内の Java リソースを圧縮する
タグ: affects_outputsloading_and_analysisexperimental
--[no]experimental_android_databinding_v2 のデフォルト: "true"
Android データ バインディング v2 を使用します。このフラグは機能しません。
タグ: affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[no]experimental_android_resource_shrinking のデフォルト: "false"
ProGuard を使用する android_binary APK のリソース圧縮を有効にします。
タグ: affects_outputsloading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex のデフォルト: "false"
rex ツールを使用して dex ファイルを書き換える
タグ: affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[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 と -fasynchronous-unwind-tables を使用してコンパイルします。
タグ: action_command_linesaffects_outputsexperimental
--experimental_output_paths=<off, content or strip> のデフォルト: 「off」
特にマルチプラットフォーム / マルチ構成のビルドの場合、出力ツリールールで出力を書き込む場所に使用するモデル。これは非常に試験運用版です。詳細については、https://github.com/bazelbuild/bazel/issues/6526 をご覧ください。Starlark のアクションでは、キー「supports-path-mapping」を「execution_requirements」辞書に追加することでパス マッピングを有効にできます。
タグ: loses_incremental_statebazel_internal_configurationaffects_outputsexecution
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment> 回の使用が累積されています
各エントリは label=value の形式にする必要があります。label はプラットフォームを表し、values は出力パスで使用する略称です。--experimental_platform_in_output_dir が true の場合にのみ使用されます。名前の優先順位が最も高い。
タグ: affects_outputsexperimental
--[no]experimental_platform_in_output_dir のデフォルト: "false"
true の場合、出力ディレクトリ名で CPU ではなくターゲット プラットフォームの略称が使用されます。正確なスキームは試験運用版であり、変更される可能性があります。まず、まれに、--platforms オプションの値が 1 つではない場合は、platforms オプションのハッシュが使用されます。次に、--experimental_override_name_platform_in_output_dir によって現在のプラットフォームの略称が登録されている場合は、その略称が使用されます。--experimental_use_platforms_in_output_dir_legacy_heuristic に設定されている場合は、現在のプラットフォーム ラベルに基づいた略称を使用します。最後に、プラットフォーム オプションのハッシュが最後の手段として使用されます。
タグ: affects_outputsexperimental
--[no]experimental_use_llvm_covmap のデフォルト: "false"
指定した場合、collect_code_coverage が有効なときに Bazel は gcov ではなく llvm-cov のカバレッジ マップ情報を生成します。
タグ: changes_inputsaffects_outputsloading_and_analysisexperimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic のデフォルト: "true"
このフラグは、推奨される移行戦略またはテスト戦略の一部としてのみ使用してください。ヒューリスティックには既知の欠陥があるため、--experimental_override_name_platform_in_output_dir のみを使用するよう移行することをおすすめします。
タグ: affects_outputsexperimental
--fat_apk_cpu=<comma-separated set of options> のデフォルト: 「armeabi-v7a」
このオプションを設定すると、指定されたすべてのターゲット アーキテクチャ(--fat_apk_cpu=x86,armeabi-v7a. このフラグを指定すると、android_binary ルールの依存関係について --android_cpu は無視されます。
タグ: affects_outputsloading_and_analysisloses_incremental_state
--[no]fat_apk_hwasan のデフォルト: "false"
HWASAN 分割を作成するかどうか。
タグ: affects_outputsloading_and_analysisloses_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_inputsaffects_outputs
--[no]force_pic のデフォルト: "false"
有効にすると、すべての C++ コンパイルで位置独立コード(「-fPIC」)が生成されます。リンクでは非 PIC ライブラリよりも PIC ビルド済みライブラリが優先され、リンクでは位置独立実行ファイル(「-pie」)が生成されます。
タグ: loading_and_analysisaffects_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_outputsaction_command_lines
--host_conlyopt=<a string> 回の使用が累積されています
exec 構成で C ソースファイル(C++ ではない)をコンパイルするときに C コンパイラに渡す追加オプション。
タグ: action_command_linesaffects_outputs
--host_copt=<a string> 回の使用が累積されています
exec 構成でビルドされたツールの C コンパイラに渡す追加オプション。
タグ: action_command_linesaffects_outputs
--host_cpu=<a string> のデフォルト: ""
ホストの CPU。
タグ: changes_inputsaffects_outputs
--host_cxxopt=<a string> 回の使用が累積されています
exec 構成でビルドされたツールの C++ コンパイラに渡す追加オプション。
タグ: action_command_linesaffects_outputs
--host_features=<a string> 回の使用が累積されています
指定された機能は、exec 構成で構築されたターゲットに対してデフォルトで有効または無効にされます。-<feature> を指定すると、この機能が無効になります。ネガティブな特徴は、ポジティブな特徴よりも常に優先されます。
タグ: changes_inputsaffects_outputs
--host_force_python=<PY2 or PY3> のデフォルト: 説明を参照
実行構成の Python バージョンをオーバーライドします。「PY2」または「PY3」のいずれかです。
タグ: loading_and_analysisaffects_outputs
--host_linkopt=<a string> 回の使用が累積されています
実行構成でツールをリンクする際にリンカーに渡す追加オプション。
タグ: action_command_linesaffects_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_nここで、regex_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_linesaffects_outputs
--host_swiftcopt=<a string> 回の使用が累積されています
実行ツールのために swiftc に渡す追加オプション。
タグ: action_command_linesaffects_outputs
--[no]incompatible_auto_exec_groups のデフォルト: "false"
有効にすると、ルールで使用されるツールチェーンごとに実行グループが自動的に作成されます。そのためには、ルールのアクションに「ツールチェーン」パラメータを指定する必要があります。詳細については、https://github.com/bazelbuild/bazel/issues/17134 をご覧ください。
タグ: affects_outputsincompatible_change
--[no]incompatible_merge_genfiles_directory のデフォルト: "true"
true の場合、genfiles ディレクトリが bin ディレクトリに折りたたみられます。
タグ: affects_outputsincompatible_change
--[no]incompatible_use_host_features のデフォルト: "true"
true の場合、ターゲット構成にのみ --features を使用し、実行構成に --host_features を使用します。
タグ: changes_inputsaffects_outputsincompatible_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_stateloading_and_analysis
--[no]legacy_whole_archive のデフォルト: "true"
非推奨となり、--compatible_remove_legacy_whole_archive に置き換えられました(詳しくは、https://github.com/bazelbuild/bazel/issues/7362 をご覧ください)。オンにした場合、linkshared=True と linkopts に linkstatic=True または「-static」のいずれかが指定されている cc_binary ルールに対して --whole-archive を使用します。これは下位互換性のためだけのものです。より適切な代替策は、必要に応じて常時リンク=1 を使用することです。
タグ: action_command_linesaffects_outputsdeprecated
--linkopt=<a string> 回の使用が累積されています
リンク時に gcc に渡す追加オプション。
タグ: action_command_linesaffects_outputs
--ltobackendopt=<a string> 回の使用が累積されています
LTO バックエンド ステップに渡す追加オプション(--features=thin_lto の下)。
タグ: action_command_linesaffects_outputs
--ltoindexopt=<a string> 回の使用が累積されています
LTO のインデックス登録ステップに渡す追加オプション(--features=thin_lto の下)。
タグ: action_command_linesaffects_outputs
--macos_cpus=<comma-separated list of options> 回の使用が累積されています
Apple macOS バイナリをビルドするアーキテクチャのカンマ区切りリスト。
タグ: loses_incremental_stateloading_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_nここで、regex_filter は正規表現パターンを含むリストと除外するパターンのリストを表します(-instrumentation_filter もご覧ください)。option_1 から option_n は任意のコマンドライン オプションを表します。オプションにカンマが含まれる場合は、バックスラッシュで囲む必要があります。オプションには @ を含めることができます。最初の @ のみが文字列の分割に使用されます。例: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 は、//foo/ 内のすべての cc ファイル(bar.cc を除く)の gcc コマンドラインに -O0 コマンドラインオプションを追加します。
タグ: action_command_linesaffects_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> 回の使用が累積されています
特定のバックエンド オブジェクトをコンパイルするときに、(--features=thin_lto にある)LTO バックエンドに選択的に渡す追加のオプション。このオプションは複数回渡すことができます。構文: regex_filter@option_1,option_2,...,option_nここで regex_filter は正規表現パターンのリストを表し、option_1 から option_n は任意のコマンドライン オプションを表します。オプションにカンマが含まれる場合は、バックスラッシュで囲む必要があります。オプションには @ を含めることができます。最初の @ のみが文字列の分割に使用されます。例: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 は、//foo/ 内のすべての o ファイル(bar.o を除く)の LTO バックエンドコマンドラインに -O0 コマンドラインオプションを追加します。
タグ: action_command_lines, affects_outputs
--platform_suffix=<a string> のデフォルト: 説明を参照
構成ディレクトリに追加する接尾辞を指定します。
タグ: loses_incremental_stateaffects_outputsloading_and_analysis
--propeller_optimize=<a build target label> のデフォルト: 説明を参照
Propeller のプロファイル情報を使用して、ビルド ターゲットを最適化します。Propeller のプロファイルは、cc プロファイルと ld プロファイルの 2 つのファイルのうち少なくとも 1 つで構成する必要があります。このフラグには、プロペラ プロファイル入力ファイルを参照する必要があるビルドラベルを指定できます。たとえば、a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",) でラベルを定義する BUILD ファイルでは、Bazel でファイルを可視化できるように、対応するパッケージにディレクティブを追加する必要があります。このオプションは次のように使用する必要があります。--propeller_optimize=//a/b:propeller_profile
タグ: action_command_linesaffects_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
--[no]share_native_deps のデフォルト: "true"
true の場合、同じ機能を含むネイティブ ライブラリが複数のターゲット間で共有されます
タグ: loading_and_analysisaffects_outputs
--[no]stamp のデフォルト: "false"
日付、ユーザー名、ホスト名、ワークスペース情報などを含むバイナリをスタンプします。
タグ: affects_outputs
--strip=<always, sometimes or never> のデフォルト: 「発生することがある」
バイナリと共有ライブラリを削除するかどうかを指定します(「-Wl、--strip-debug」を使用)。「nottimes」のデフォルト値は、--compile_mode=fastbuild のみを削除します。
タグ: affects_outputs
--stripopt=<a string> 回の使用が累積されています
「<name>.stripped」バイナリの生成時に削除に渡す追加オプション。
タグ: action_command_linesaffects_outputs
--swiftcopt=<a string> 回の使用が累積されています
Swift コンパイルに渡す追加オプション。
タグ: action_command_lines
--tvos_cpus=<comma-separated list of options> 回の使用が累積されています
Apple tvOS バイナリをビルドするアーキテクチャのカンマ区切りのリスト。
タグ: loses_incremental_stateloading_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_stateloading_and_analysis
--watchos_cpus=<comma-separated list of options> 回の使用が累積されています
Apple watchOS バイナリをビルドする対象アーキテクチャのカンマ区切りリスト。
タグ: loses_incremental_stateloading_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_inputsloading_and_analysisexperimental
--[no]check_licenses のデフォルト: "false"
依存パッケージによるライセンスの制約が、ビルド中のターゲットの配布モードと競合していないことを確認してください。デフォルトでは、ライセンスはチェックされていません。
タグ: build_file_semantics
--[no]check_visibility のデフォルト: "true"
無効にすると、ターゲット依存関係の可視性エラーは警告に降格されます。
タグ: build_file_semantics
--[no]desugar_for_android のデフォルト: "true"
dex 変換の前に Java 8 バイトコードを desugar するかどうか。
タグ: affects_outputsloading_and_analysisloses_incremental_state
--[no]desugar_java8_libs のデフォルト: "false"
レガシー デバイス向けのアプリにサポートされている Java 8 ライブラリを含めるかどうかを指定します。
タグ: affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[no]enforce_constraints のデフォルト: "true"
各ターゲットが対応している環境を確認し、ターゲットに同じ環境をサポートしていない依存関係がある場合はエラーを報告します
タグ: build_file_semantics
--[no]experimental_check_desugar_deps のデフォルト: "true"
Android バイナリレベルで正しい desugar を再確認するかどうか。
タグ: eagerness_to_exitloading_and_analysisexperimental
--experimental_import_deps_checking=<off, warning or error> のデフォルト: 「OFF」
有効にすると、aar_import の依存関係が完了しているかどうかを確認します。この適用により、ビルドが中断されたり、警告が表示されたりする場合があります。
タグ: loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default> のデフォルト: "default"
true の場合、Java ターゲットが、直接使用されるすべてのターゲットを依存関係として明示的に宣言していることを確認します。
タグ: build_file_semanticseagerness_to_exit
--[no]incompatible_check_testonly_for_output_files のデフォルト: "false"
有効になっている場合は、生成ルールの testonly を検索して、出力ファイルである前提条件ターゲットについて testonly をチェックします。これは公開設定の確認と一致します。
タグ: build_file_semanticsincompatible_change
--[no]incompatible_check_visibility_for_toolchains のデフォルト: "false"
有効にすると、ツールチェーンの実装にも可視性チェックが適用されます。
タグ: build_file_semanticsincompatible_change
--[no]incompatible_disable_native_android_rules のデフォルト: "false"
有効にすると、ネイティブ Android ルールの直接使用が無効になります。https://github.com/bazelbuild/rules_android にある Starlark Android ルールを使用してください
タグ: eagerness_to_exitincompatible_change
--[no]incompatible_disable_native_apple_binary_rule のデフォルト: "false"
NoOps。下位互換性のためにここに保持されています。
タグ: eagerness_to_exitincompatible_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_analysisincompatible_change
--[no]incompatible_validate_top_level_header_inclusions のデフォルト: "true"
true の場合、Bazel はトップレベル ディレクトリ ヘッダーの包含も検証します(詳しくは、https://github.com/bazelbuild/bazel/issues/10047 をご覧ください)。
タグ: loading_and_analysisincompatible_change
--python_native_rules_allowlist=<a build target label> のデフォルト: 説明を参照
--compatibility_python_disallow_native_rules を適用するときに使用する許可リスト(package_group ターゲット)。
タグ: loading_and_analysis
--[no]strict_filesets のデフォルト: "false"
このオプションを有効にすると、パッケージの境界を越えるファイルセットがエラーとして報告されます。
タグ: build_file_semanticseagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default> のデフォルト: "error"
オフの場合を除き、proto_library ターゲットが、直接使用されるすべてのターゲットを依存関係として明示的に宣言していることを確認します。
タグ: build_file_semanticseagerness_to_exitincompatible_change
--strict_public_imports=<off, warn, error, strict or default> のデフォルト: 「off」
オフの場合を除き、「import public」で使用されるすべてのターゲットが、proto_library ターゲットでエクスポート済みとして明示的に宣言されていることを確認します。
タグ: build_file_semanticseagerness_to_exitincompatible_change
--[no]strict_system_includes のデフォルト: "false"
true の場合、システム インクルード パス(-isystem)を通じて検出されたヘッダーも宣言する必要があります。
タグ: loading_and_analysiseagerness_to_exit
--target_environment=<a build target label> 回の使用が累積されています
このビルドのターゲット環境を宣言します。「環境」ルールへのラベル参照にする必要があります。指定する場合、すべてのトップレベル ターゲットがこの環境と互換性がある必要があります。
タグ: changes_inputs
ビルドの署名出力に影響するオプション:
--apk_signing_method=<v1, v2, v1_v2 or v4> のデフォルト: "v1_v2"
APK の署名に使用する実装
タグ: action_command_linesaffects_outputsloading_and_analysis
--[no]device_debug_entitlements のデフォルト: "true"
設定されている場合、コンパイル モードが「opt」でない場合、objc アプリは署名時にデバッグ資格を含めます。
タグ: changes_inputs
--ios_signing_cert_name=<a string> のデフォルト: 説明を参照
iOS 署名に使用する証明書名。設定しない場合、プロビジョニング プロファイルにフォールバックします。証明書のキーチェーン ID 設定、または共同署名の man ページ(署名 ID)に従って証明書の共通名の(部分文字列)を指定できます。
タグ: action_command_lines
このオプションは、BUILD ファイル、.bzl ファイル、WORKSPACE ファイルからアクセス可能な Starlark 言語またはビルド API のセマンティクスに影響します。
--[no]incompatible_disallow_legacy_py_provider のデフォルト: "true"
NoOps(オペレーションなし)はまもなく削除されます。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes のデフォルト: "false"
true の場合、objc_library と objc_import で sdk_frameworks 属性と weak_sdk_frameworks 属性を禁止します。
タグ: build_file_semanticsincompatible_change
true の場合、objc_library と objc_import の alwayslink 属性のデフォルト値を true にします。
タグ: build_file_semanticsincompatible_change
--[no]incompatible_python_disallow_native_rules のデフォルト: "false"
true の場合、組み込みの py_* ルールを使用するとエラーが発生します。代わりに、rule_python ルールを使用する必要があります。詳細と移行手順については、https://github.com/bazelbuild/bazel/issues/17773 をご覧ください。
タグ: loading_and_analysisincompatible_change
テスト環境またはテストランナーの動作を管理するオプション:
--[no]allow_analysis_failures のデフォルト: "false"
true の場合、ルール ターゲットの分析が失敗すると、ビルド失敗ではなく、エラーの説明を含む AnalysisFailureInfo のインスタンスがターゲットに伝播されます。
タグ: loading_and_analysisexperimental
--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_analysisexperimental
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g. memory=10,30,60,100> 回の使用が累積されています
テストのデフォルトのリソース量をオーバーライドします。想定される形式は <resource>=<value> です。1 つの正の数値を <value> として指定すると、すべてのテストサイズのデフォルトのリソースがオーバーライドされます。4 つのカンマ区切りの数値を指定すると、テストサイズの小、中、大、巨大それぞれのリソース量がオーバーライドされます。値は HOST_RAM または HOST_CPU で、オプションで [-|*]<float> が後に続く場合もあります(例: memory=HOST_RAM*.1, HOST_RAM*.2, HOST_RAM*.3, HOST_RAM*.4)。このフラグで指定されたデフォルトのテストリソースは、タグで指定された明示的なリソースによってオーバーライドされます。
--[no]experimental_android_use_parallel_dex2oat のデフォルト: "false"
dex2oat を並行して使用すると、android_test を高速化できます。
タグ: loading_and_analysishost_machine_resource_optimizationsexperimental
--[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_test。run_per_test は整数値を表し、regex_filter は包含および除外正規表現パターンのリストを表します(--instrumentation_filter もご覧ください)。例: --runs_per_test=//foo/.*,-//foo/bar/.*@3 は、foo/bar の下にあるテストを除く //foo/内のすべてのテストを 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」(デフォルト)は、直接依存関係のルールクラスが指定されているかどうかに関係なく、宣言されたすべてのアスペクト依存関係が追加されることを意味します。「precise」は、直接依存関係のルールクラスでアクティブになる可能性のあるアスペクトのみが追加されることを意味します。なお、高精度モードでは、1 つのターゲットを評価するために他のパッケージを読み込む必要があるため、他のモードよりも時間がかかります。また、正確なモードでさえも完全に正確というわけではありません。アスペクトを計算するかどうかの決定は、分析フェーズで決定され、「Bazel クエリ」中には実行されません。
タグ: build_file_semantics
--[no]consistent_labels のデフォルト: "false"
有効にすると、すべてのクエリコマンドは <code>Label</code> インスタンスに適用される Starlark <code>str</code> 関数と同様にラベルを出力します。これは、さまざまなクエリコマンドやルールによって出力されたラベルの出力を照合する必要があるツールに役立ちます。有効になっていない場合、出力フォーマッタは、出力を読みやすくするために(メイン リポジトリからの相対的な)明らかなリポジトリ名を自由に出力できます。
タグ: terminal_output
--[no]experimental_explicit_aspects のデフォルト: "false"
aquery, cquery: アスペクトで生成されたアクションを出力に含めるかどうかクエリ: no-op(アスペクトは常に従う)
タグ: 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: アスペクトで生成されたアクションを出力に含めるかどうかクエリ: no-op(アスペクトは常に従う)
タグ: terminal_output
--[no]incompatible_package_group_includes_double_slash のデフォルト: "true"
有効にすると、package_group の `packages` 属性を出力するときに、先頭の `//` が省略されません。
タグ: terminal_outputincompatible_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=(lite|full) オプションも指定する必要があります。
タグ: terminal_output
--[no]proto:default_values のデフォルト: "true"
true の場合、値が明示的に指定されていない属性が含まれます。それ以外の場合は、省略されます。このオプションは --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> のデフォルト: ""
設定すると、query はコマンドラインではなく、ここで指定したファイルからクエリを読み取ります。ここにファイルとコマンドライン クエリを指定するとエラーになります。
タグ: 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 式。構成されたターゲットは「target」にバインドされています。--starlark:expr と --starlark:file のどちらも指定されていない場合、このオプションはデフォルトで「str(target.label)」になります。--starlark:expr と --starlark:file の両方を指定するとエラーになります。
タグ: terminal_output
--starlark:file=<a string> のデフォルト: ""
1 つの引数の「format」という Starlark 関数を定義するファイルの名前。文字列としてフォーマットするために各構成済みターゲットに適用されます。--starlark:expr と --starlark:file の両方を指定するとエラーになります。詳細については、--output=starlark のヘルプをご覧ください。
タグ: terminal_output
--[no]tool_deps のデフォルト: "true"
クエリ: 無効にすると、「exec configuration」への依存関係は、クエリが動作する依存関係グラフに含まれません。任意の「proto_library」ルールからプロトコル コンパイラへの依存関係エッジなど、「exec 構成」依存関係エッジは、通常、同じ「ターゲット」プログラムの一部ではなく、ビルド中に実行されるツールを指しています。Cquery: 無効にすると、構成済みのターゲットを検出した最上位のターゲットから、実行遷移をまたぐ構成済みのターゲットがすべて除外されます。つまり、最上位のターゲットがターゲット構成にある場合は、同じターゲット構成にも構成されたターゲットのみが返されます。最上位のターゲットが exec 構成に含まれている場合は、exec 構成のターゲットのみが返されます。このオプションでは、解決済みのツールチェーンは除外されません。
タグ: build_file_semantics
--transitions=<full, lite or none> のデフォルト: 「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_analysisexecutionaffects_outputsexperimental
--[no]experimental_inmemory_jdeps_files のデフォルト: "true"
有効にすると、Java コンパイルで生成された依存関係(.jdeps)ファイルは、ディスクに書き込まれるのではなく、リモート ビルドノードからメモリ内で直接渡されます。
タグ: loading_and_analysisexecutionaffects_outputsexperimental
--[no]experimental_objc_include_scanning のデフォルト: "false"
目的の C/C++ のインクルード スキャンを実行するかどうか。
タグ: loading_and_analysisexecutionchanges_inputs
--[no]experimental_retain_test_configuration_across_testonly のデフォルト: "false"
--trim_test_configuration を有効にすると、testonly=1 とマークされたルールのテスト設定はトリミングされません。これは、テスト以外のルールが cc_test ルールに依存している場合に、アクションの競合の問題を減らすためです。--trim_test_configuration が false の場合は効果がありません。
タグ: loading_and_analysisloses_incremental_state
--[no]experimental_starlark_cc_import のデフォルト: "false"
有効にすると、Starlark バージョンの cc_import を使用できます。
タグ: loading_and_analysisexperimental
--[no]experimental_unsupported_and_brittle_include_scanning のデフォルト: "false"
入力ファイルの #include 行を解析して C/C++ コンパイルへの入力を絞り込むかどうかを指定します。これにより、コンパイル入力ツリーのサイズを小さくすることで、パフォーマンスとインクリメンタリティを向上させることができます。ただし、インクルード スキャナは C プリプロセッサ セマンティクスを完全には実装していないため、ビルドが破損する可能性もあります。特に、動的な #include ディレクティブは認識されず、プリプロセッサの条件付きロジックは無視されます。自己責任で使用してください。このフラグに関連する問題はすべてクローズされます。
タグ: loading_and_analysisexecutionchanges_inputs
--[no]incremental_dexing のデフォルト: "true"
ほとんどの処理は、Jar ファイルごとに個別に dex 変換を行います。
タグ: affects_outputsloading_and_analysisloses_incremental_state
--[no]objc_use_dotd_pruning のデフォルト: "true"
設定すると、clang によって出力された .d ファイルを使用して、objc コンパイルに渡される入力のセットがプルーニングされます。
タグ: changes_inputsloading_and_analysis
--[no]process_headers_in_dependencies のデフォルト: "false"
ターゲット //a:a をビルドするときに、//a:a が依存するすべてのターゲットでヘッダーを処理します(ツールチェーンでヘッダー処理が有効になっている場合)。
タグ: execution
--[no]trim_test_configuration のデフォルト: "true"
有効にすると、ビルドのトップレベルの下でテスト関連のオプションが消去されます。このフラグを有効にすると、テストを非テストルールの依存関係としてビルドすることはできませんが、テスト関連のオプションを変更してもテスト以外のルールが再分析されることはありません。
タグ: loading_and_analysisloses_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 ターゲットの runfile で __init__.py ファイルが自動的に作成されないようにします。正確には、py_binary または py_test のターゲットで legacy_create_init が「auto」(デフォルト)に設定されている場合、このフラグが設定されている場合にのみ false として扱われます。https://github.com/bazelbuild/bazel/issues/10076 をご覧ください。
タグ: affects_outputsincompatible_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_outputsincompatible_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_analysisaffects_outputsincompatible_change
--[no]incompatible_use_python_toolchains のデフォルト: "true"
true に設定すると、実行可能なネイティブの Python ルールは、--python_top などの以前のフラグで指定されたランタイムではなく、Python ツールチェーンで指定された Python ランタイムを使用します。
タグ: loading_and_analysisincompatible_change
--python_version=<PY2 or PY3> のデフォルト: 説明を参照
Python メジャー バージョン モード(PY2 または PY3)。これは py_binary ターゲットと py_test ターゲットによってオーバーライドされるため(バージョンを明示的に指定していない場合でも)、通常はこのフラグを指定する理由はほとんどありません。
タグ: loading_and_analysisaffects_outputs
その他のオプション(特に分類されていない)。
--[no]cache_test_results [-t] デフォルト: "auto"
「auto」に設定すると、(1)Bazel がテストまたはその依存関係の変更を検出した、(2)テストが外部としてマークされている、(3)複数のテスト実行が --runs_per_test でリクエストされた、(4)テストが失敗した場合にのみ、Bazel はテストを再実行します。「yes」に設定した場合、Bazel は「外部」とマークされたテストを除くすべてのテスト結果をキャッシュに保存します。「no」に設定した場合、Bazel はテスト結果をキャッシュに保存しません。
--[no]experimental_cancel_concurrent_tests のデフォルト: "false"
true の場合、Blaze は最初に正常に実行された際に同時に実行中のテストをキャンセルします。これは、--runs_per_test_detects_flakes と組み合わせた場合にのみ有効です。
タグ: affects_outputsloading_and_analysis
--[no]experimental_fetch_all_coverage_outputs のデフォルト: "false"
true の場合、Bazel はカバレッジの実行中にテストごとにカバレッジ データ ディレクトリ全体を取得します。
タグ: affects_outputsloading_and_analysis
--[no]experimental_generate_llvm_lcov のデフォルト: "false"
true の場合、clang のカバレッジにより LCOV レポートが生成されます。
タグ: affects_outputsloading_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_analysisincompatible_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_outputsloading_and_analysis
--proto_toolchain_for_cc=<a build target label> のデフォルト: "@bazel_tools//tools/proto:cc_ツールチェーン"
C++ proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル。
タグ: affects_outputsloading_and_analysis
--proto_toolchain_for_j2objc=<a build target label> のデフォルト: "@bazel_tools//tools/j2objc:j2objc_proto_ツールチェーン"
j2objc proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル。
タグ: affects_outputsloading_and_analysis
--proto_toolchain_for_java=<a build target label> のデフォルト: "@bazel_tools//tools/proto:java_ツールチェーン"
Java proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル
タグ: affects_outputsloading_and_analysis
--proto_toolchain_for_javalite=<a build target label> のデフォルト: "@bazel_tools//tools/proto:javalite_ツールチェーン"
JavaLite proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル。
タグ: affects_outputsloading_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> のデフォルト: 「AutoML」
テストのシャーディングの戦略を指定します。「shard_count」BUILD 属性が存在する場合にのみシャーディングを使用する「明示的な」を指定します。テストのシャーディングを使用しないように「disabled」に設定します。「forced=k」は、「shard_count」ビルド属性に関係なく、テスト用の「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
設定すると、キャッシュ ヒットが発生した場合、リポジトリ キャッシュはファイルをコピーするのではなくハードリンクします。これはディスク容量を節約するためのものです。
タグ: bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer> のデフォルト: 「0」
ダウンロード エラーの再試行の最大試行回数。0 に設定すると、再試行が無効になります。
タグ: experimental
--experimental_scale_timeouts=<a double> のデフォルト: 「1.0」
Starlark リポジトリ ルールのすべてのタイムアウトを、この係数でスケーリングします。このようにして、ソースコードを変更することなく、ルール作成者の想定よりも遅いマシンで外部リポジトリを動作させることができます。
タグ: bazel_internal_configurationexperimental
--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
--[no]incompatible_disable_native_repo_rules のデフォルト: "false"
false の場合、ネイティブ リポジトリ ルールを WORKSPACE で使用できます。それ以外の場合は、代わりに Starlark リポジトリ ルールを使用する必要があります。ネイティブ リポジトリのルールには、local_repository、new_local_repository、local_config_platform、android_sdk_repository、android_ndk_repository があります。
タグ: bazel_internal_configuration
--repository_cache=<a path> のデフォルト: 説明を参照
外部リポジトリの取得中に取得されたダウンロード値のキャッシュの場所を指定します。引数として空の文字列を指定すると、キャッシュの無効化がリクエストされます。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます
タグ: bazel_internal_configuration
--[no]repository_disable_download のデフォルト: "false"
設定した場合、リポジトリの取得中に gke.download{,_and_extract} を使用したダウンロードは許可されません。ネットワーク アクセスは完全には無効にはなりません。インターネットにアクセスする任意の実行可能ファイルを gsuite.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, refresh or error> のデフォルト: "update"
ロックファイルの使用方法と使用方法を指定します。有効な値は、ロックファイルを使用して変更があった場合に更新する「update」、リモート レジストリから変更可能な情報(ヤンクされたバージョンや以前に欠落したモジュール)を随時更新する「refresh」、ロックファイルを使用するが最新でない場合にエラーをスローする「error」、ロックファイルの読み取り / 書き込みを行わない場合は「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
--vendor_dir=<a path> のデフォルト: 説明を参照
外部リポジトリをベンダーモードで保持するディレクトリを指定します。これは、外部リポジトリを取得する目的で、またはビルド中に外部リポジトリを使用するためです。パスは、絶対パスまたはワークスペース ディレクトリへの相対パスで指定できます。
タグ: loading_and_analysis
ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> のデフォルト: "1s:2,20s:3,1m:5"
上限に達すると、GcThrashingDetector が OOM を持つ Bazel をクラッシュさせます。各制限は、<period>:<count> として指定します。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 エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、GC イベントが完全に終了したときに不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、完全な GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、GC イベントが完全に発生し、保持されているヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> のデフォルト: 「2147483647」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、マイナー GC イベントの発生時に不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、マイナー GC イベントが発生して保持ヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer> のデフォルト: 「85」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率がこのしきい値以上であることを検出した場合、不要な一時的な Skyframe 状態を破棄します。これを微調整すると、GC スラッシングが(i)この一時的な状態のメモリ使用量に起因しており、(ii)必要に応じて状態を再構築するよりもコストが高い場合に、GC スラッシングの経過時間への影響を軽減できます。
タグ: host_machine_resource_optimizations
ロギングの詳細度、形式、場所に影響するオプション:
--experimental_command_profile=<cpu, wall, alloc or lock> のデフォルト: 説明を参照
コマンドの実行中に Java フライト レコーダーのプロファイルを記録します。サポートされているプロファイリング イベントタイプ(cpu、wall、alloc、lock)のいずれかを引数として指定する必要があります。プロファイルは、出力ベース ディレクトリの下のイベントタイプに基づいて名前が付けられたファイルに書き込まれます。このフラグの構文とセマンティクスは、他のプロファイル タイプや出力形式をサポートするため今後変更される可能性があります。このフラグは自己責任で使用してください。
--[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` から始まります。同じ URL に対して複数の rewrite ディレクティブが返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto> のデフォルト: "auto"
リポジトリのフェッチに使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得は再起動の対象となります。それ以外の場合は、仮想ワーカー スレッドを使用します。
その他のカテゴリに該当しないその他のオプション:
--override_repository=<an equals-separated mapping of repository name to path> 回の使用が累積されています
リポジトリは、<リポジトリ名>=<パス> 形式のローカルパスでオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。指定したパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定したパスが「%workspace%」で始まる場合は、「bazel info workspace」の出力であるワークスペースのルートからの相対パスになります。

取得オプション

test のすべてのオプションを継承します。

コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path> 回の使用が累積されています
ネットワークにアクセスしてダウンロードする前にアーカイブを検索する場所の追加。
タグ: bazel_internal_configuration
設定すると、キャッシュ ヒットが発生した場合、リポジトリ キャッシュはファイルをコピーするのではなくハードリンクします。これはディスク容量を節約するためのものです。
タグ: bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer> のデフォルト: 「0」
ダウンロード エラーの再試行の最大試行回数。0 に設定すると、再試行が無効になります。
タグ: experimental
--experimental_scale_timeouts=<a double> のデフォルト: 「1.0」
Starlark リポジトリ ルールのすべてのタイムアウトを、この係数でスケーリングします。このようにして、ソースコードを変更することなく、ルール作成者の想定よりも遅いマシンで外部リポジトリを動作させることができます。
タグ: bazel_internal_configurationexperimental
--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
--[no]incompatible_disable_native_repo_rules のデフォルト: "false"
false の場合、ネイティブ リポジトリ ルールを WORKSPACE で使用できます。それ以外の場合は、代わりに Starlark リポジトリ ルールを使用する必要があります。ネイティブ リポジトリのルールには、local_repository、new_local_repository、local_config_platform、android_sdk_repository、android_ndk_repository があります。
タグ: bazel_internal_configuration
--repository_cache=<a path> のデフォルト: 説明を参照
外部リポジトリの取得中に取得されたダウンロード値のキャッシュの場所を指定します。引数として空の文字列を指定すると、キャッシュの無効化がリクエストされます。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます
タグ: bazel_internal_configuration
--[no]repository_disable_download のデフォルト: "false"
設定した場合、リポジトリの取得中に gke.download{,_and_extract} を使用したダウンロードは許可されません。ネットワーク アクセスは完全には無効にはなりません。インターネットにアクセスする任意の実行可能ファイルを gsuite.execute で実行できます。
タグ: bazel_internal_configuration
ビルド実行を制御するオプション:
--[no]all のデフォルト: "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] デフォルト: "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 言語またはビルド API のセマンティクスに影響します。
--[no]incompatible_config_setting_private_default_visibility のデフォルト: "false"
Compatibility_enforce_config_setting_visibility=false は、NoOps です。それ以外の場合、このフラグが false の場合、明示的な公開設定属性のない config_setting はすべて //visibility:public です。このフラグが true の場合、config_setting は他のすべてのルールと同じ公開設定ロジックに従います。https://github.com/bazelbuild/bazel/issues/12933 をご覧ください。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_enforce_config_setting_visibility のデフォルト: "true"
true の場合、config_setting の公開設定制限を適用します。false の場合、すべての config_setting がすべてのターゲットに表示されます。https://github.com/bazelbuild/bazel/issues/12932 をご覧ください。
タグ: loading_and_analysisincompatible_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]configure のデフォルト: "false"
システム構成を目的として「構成」とマークされたリポジトリのみを取得します。--enable_bzlmod がオンになっている場合にのみ機能します。
タグ: changes_inputs
--[no]force のデフォルト: "false"
既存のリポジトリがある場合は無視して、リポジトリを強制的に再度取得します。--enable_bzlmod がオンになっている場合にのみ機能します。
タグ: changes_inputs
--[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, refresh or error> のデフォルト: "update"
ロックファイルの使用方法と使用方法を指定します。有効な値は、ロックファイルを使用して変更があった場合に更新する「update」、リモート レジストリから変更可能な情報(ヤンクされたバージョンや以前に欠落したモジュール)を随時更新する「refresh」、ロックファイルを使用するが最新でない場合にエラーをスローする「error」、ロックファイルの読み取り / 書き込みを行わない場合は「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
--repo=<a string> 回の使用が累積されています
指定されたリポジトリ({@apparent_repo_name} または {@@canonical_repo_name})のみを取得します。--enable_bzlmod がオンになっている場合にのみ機能します。
タグ: changes_inputs
--vendor_dir=<a path> のデフォルト: 説明を参照
外部リポジトリをベンダーモードで保持するディレクトリを指定します。これは、外部リポジトリを取得する目的で、またはビルド中に外部リポジトリを使用するためです。パスは、絶対パスまたはワークスペース ディレクトリへの相対パスで指定できます。
タグ: loading_and_analysis
ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> のデフォルト: "1s:2,20s:3,1m:5"
上限に達すると、GcThrashingDetector が OOM を持つ Bazel をクラッシュさせます。各制限は、<period>:<count> として指定します。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 エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、GC イベントが完全に終了したときに不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、完全な GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、GC イベントが完全に発生し、保持されているヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> のデフォルト: 「2147483647」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、マイナー GC イベントの発生時に不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、マイナー GC イベントが発生して保持ヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer> のデフォルト: 「85」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率がこのしきい値以上であることを検出した場合、不要な一時的な Skyframe 状態を破棄します。これを微調整すると、GC スラッシングが(i)この一時的な状態のメモリ使用量に起因しており、(ii)必要に応じて状態を再構築するよりもコストが高い場合に、GC スラッシングの経過時間への影響を軽減できます。
タグ: host_machine_resource_optimizations
ロギングの詳細度、形式、場所に影響するオプション:
--experimental_command_profile=<cpu, wall, alloc or lock> のデフォルト: 説明を参照
コマンドの実行中に Java フライト レコーダーのプロファイルを記録します。サポートされているプロファイリング イベントタイプ(cpu、wall、alloc、lock)のいずれかを引数として指定する必要があります。プロファイルは、出力ベース ディレクトリの下のイベントタイプに基づいて名前が付けられたファイルに書き込まれます。このフラグの構文とセマンティクスは、他のプロファイル タイプや出力形式をサポートするため今後変更される可能性があります。このフラグは自己責任で使用してください。
--[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` から始まります。同じ URL に対して複数の rewrite ディレクティブが返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto> のデフォルト: "auto"
リポジトリのフェッチに使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得は再起動の対象となります。それ以外の場合は、仮想ワーカー スレッドを使用します。
その他のカテゴリに該当しないその他のオプション:
--deleted_packages=<comma-separated list of package names> 回の使用が累積されています
パッケージパスのどこかに表示されている場合でも、ビルドシステムが存在しないと見なすパッケージ名のカンマ区切りリスト。 このオプションは、既存のパッケージ「x」のサブパッケージ「x/y」を削除する場合に使用します。たとえば、クライアントで x/y/BUILD を削除した後でも、別の package_path エントリで指定されていれば、ビルドシステムで「//x:y/z」というラベルが検出されるとエラーが表示されることがあります。--deleted_packages x/y を指定すると、この問題を回避できます。
--[no]fetch のデフォルト: "true"
コマンドが外部依存関係を取得できるようにします。false に設定すると、依存関係のキャッシュ バージョンが使用されます。依存関係が存在しない場合は、コマンドが失敗します。
--override_repository=<an equals-separated mapping of repository name to 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:」というメッセージを出力します。
ビルド実行を制御するオプション:
--[no]all のデフォルト: "false"
ターゲットまたはリポジトリのビルドに必要なすべての外部リポジトリを取得します。--enable_bzlmod がオンになっている場合にのみ機能します。
タグ: changes_inputs
ファイル システムを直接呼び出してシンボリック リンク ツリーを作成するかどうか
タグ: loading_and_analysisexecutionexperimental
--[no]experimental_persistent_aar_extractor のデフォルト: "false"
ワーカーを使用して永続的な AAR エクストラクタを有効にします。
タグ: execution
--[no]experimental_remotable_source_manifests のデフォルト: "false"
ソース マニフェストのアクションをリモート可能にするかどうか
タグ: loading_and_analysisexecutionexperimental
--[no]experimental_split_coverage_postprocessing のデフォルト: "false"
true の場合、Bazel は新しい Spwn でテスト用のカバレッジ後処理を実行します。
タグ: execution
--[no]experimental_strict_fileset_output のデフォルト: "false"
このオプションを有効にすると、ファイルセットはすべての出力アーティファクトを通常のファイルとして扱います。ディレクトリを走査したり、シンボリック リンクの影響を受けたりしません。
タグ: execution
--[no]incompatible_disallow_unsound_directory_outputs のデフォルト: "true"
設定すると、出力ファイルをディレクトリとして実体化するアクションでエラーになります。ソース ディレクトリには影響しません。https://github.com/bazelbuild/bazel/issues/18646 をご覧ください。
タグ: bazel_internal_configurationincompatible_change
--[no]incompatible_modify_execution_info_additive のデフォルト: "false"
有効にすると、複数の --modify_execution_info フラグを渡すことで追加されます。無効にすると、最後のフラグのみが考慮されます。
タグ: executionaffects_outputsloading_and_analysisincompatible_change
--[no]keep_going [-k] デフォルト: "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」を削除します。
タグ: executionaffects_outputsloading_and_analysis
--persistent_android_dex_desugar
ワーカーを使用して、永続的な Android dex アクションと desugar アクションを有効にします。
展開先:
  --internal_persistent_android_dex_desugar
  --strategy=Desugar=worker
  --strategy=DexBuilder=worker

タグ: host_machine_resource_optimizationsexecution
--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=AARGenerator=worker--strategy=ProcessDatabinding=worker--strategy=GenerateDataBindingBaseClasses=workerhost_machine_resource_optimizationsexecution
--persistent_multiplex_android_dex_desugar
ワーカーを使用して、永続的な多重化された Android dex アクションと desugar アクションを有効にします。
展開先:
  --persistent_android_dex_desugar
  --internal_persistent_multiplex_android_dex_desugar

タグ: host_machine_resource_optimizationsexecution
--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-workerss
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers

--modify_execution_info=AARGenerator=+supports-multiplex-workershost_machine_resource_optimizationsexecution
--persistent_multiplex_android_tools
永続的な Android ツールと多重化された Android ツール(dex 変換、desugar、リソース処理)を有効にします。
展開先:
  --internal_persistent_multiplex_busybox_tools
  --persistent_multiplex_android_resource_processor
  --persistent_multiplex_android_dex_desugar

タグ: host_machine_resource_optimizationsexecution
--[no]use_target_platform_for_tests のデフォルト: "false"
true の場合、Bazel はテスト実行グループではなく、ターゲット プラットフォームを使用してテストを実行します。
タグ: execution
アクションの実行に使用するツールチェーンを構成するオプション:
--android_compiler=<a string> のデフォルト: 説明を参照
Android ターゲット コンパイラ。
タグ: affects_outputsloading_and_analysisloses_incremental_state
--android_crosstool_top=<a build target label> のデフォルト: 「//external:android/crosstool」
Android ビルドに使用される C++ コンパイラの場所。
タグ: affects_outputschanges_inputsloading_and_analysisloses_incremental_state
--android_grte_top=<a label> のデフォルト: 説明を参照
Android ターゲットの grte_top を指定します。
タグ: changes_inputsloading_and_analysisloses_incremental_state
--android_manifest_merger=<legacy, android or force_android> のデフォルト: "android"
android_binary ルールに使用するマニフェスト マージツールを選択します。従来のマージツールから Android マニフェスト マージツールへの移行をサポートするフラグ。
タグ: affects_outputsloading_and_analysisloses_incremental_state
--android_platforms=<a build target label> のデフォルト: ""
android_binary ターゲットが使用するプラットフォームを設定します。複数のプラットフォームが指定されている場合、バイナリはファット APK になります。この APK には、指定された各ターゲット プラットフォームのネイティブ バイナリが含まれています。
タグ: changes_inputsloading_and_analysisloses_incremental_state
--android_sdk=<a build target label> のデフォルト: "@bazel_tools//tools/android:sdk"
Android アプリのビルドに使用する Android SDK/プラットフォームを指定します。
タグ: changes_inputsloading_and_analysisloses_incremental_state
--apple_crosstool_top=<a build target label> デフォルト: "@bazel_tools//tools/cpp:ツールチェーン"
Apple ルールと Objc ルール、およびそれらの依存関係で使用されるクロスツール パッケージのラベル。
タグ: loses_incremental_statechanges_inputs
--cc_output_directory_tag=<a string> のデフォルト: ""
構成ディレクトリに追加する接尾辞を指定します。
タグ: affects_outputs
--compiler=<a string> のデフォルト: 説明を参照
ターゲットのコンパイルに使用する C++ コンパイラ。
タグ: loading_and_analysisexecution
--coverage_output_generator=<a build target label> のデフォルト: "@bazel_tools//tools/test:lcov_merger"
未加工のカバレッジ レポートの後処理に使用されるバイナリの場所。現在は、単一のファイル(バイナリ)を含むファイル グループである必要があります。デフォルトは「//tools/test:lcov_merger」です。
タグ: changes_inputsaffects_outputsloading_and_analysis
--coverage_report_generator=<a build target label> デフォルト: "@bazel_tools//tools/test:coverage_report_generator"
カバレッジ レポートの生成に使用されるバイナリの場所。現在は、単一のファイル(バイナリ)を含むファイル グループである必要があります。デフォルトは「//tools/test:coverage_report_generator」です。
タグ: changes_inputsaffects_outputsloading_and_analysis
--coverage_support=<a build target label> デフォルト: "@bazel_tools//tools/test:coverage_support"
コード カバレッジを収集するすべてのテスト アクションの入力で必要なサポート ファイルの場所。デフォルトは「//tools/test:coverage_support」です。
タグ: changes_inputsaffects_outputsloading_and_analysis
--crosstool_top=<a build target label> デフォルト: "@bazel_tools//tools/cpp:ツールチェーン"
C++ コードのコンパイルに使用されるクロスツール パッケージのラベル。
タグ: loading_and_analysischanges_inputsaffects_outputs
--custom_malloc=<a build target label> のデフォルト: 説明を参照
カスタム Maloc 実装を指定します。この設定は、ビルドルールの Maloc 属性をオーバーライドします。
タグ: changes_inputsaffects_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_stateloading_and_analysisexecution
--[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_ツールチェーン s() によって WORKSPACE ファイルで宣言されたものの前に考慮されます。
タグ: affects_outputschanges_inputsloading_and_analysis
--grte_top=<a label> のデフォルト: 説明を参照
チェックインされた libc ライブラリへのラベル。デフォルト値はクロスツール ツールチェーンによって選択されるため、オーバーライドする必要はほとんどありません。
タグ: action_command_linesaffects_outputs
--host_compiler=<a string> のデフォルト: 説明を参照
ホスト コンパイルに使用する C++ コンパイラ。--host_crosstool_top が設定されていない場合、無視されます。
タグ: loading_and_analysisexecution
--host_crosstool_top=<a build target label> のデフォルト: 説明を参照
デフォルトでは、exec 構成には --crosstool_top オプションと --compiler オプションも使用されます。このフラグを指定すると、Bazel は指定された crosstool_top に対してデフォルトの libc とコンパイラを使用します。
タグ: loading_and_analysischanges_inputsaffects_outputs
--host_grte_top=<a label> のデフォルト: 説明を参照
指定すると、exec 構成の libc 最上位ディレクトリ(--grte_top)がオーバーライドされます。
タグ: action_command_linesaffects_outputs
--host_platform=<a build target label> デフォルト: "@bazel_tools//tools:host_platform"
ホストシステムを記述するプラットフォーム ルールのラベル。
タグ: affects_outputschanges_inputsloading_and_analysis
--[no]incompatible_dont_enable_host_nonhost_crosstool_features のデフォルト: "true"
true の場合、Bazel は C++ ツールチェーンの「host」機能と「nonhost」機能を有効にしません(詳しくは、https://github.com/bazelbuild/bazel/issues/7407 をご覧ください)。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_enable_android_toolchain_resolution のデフォルト: "true"
ツールチェーン解決を使用して、Android ルール用の Android SDK を選択します(Starlark とネイティブ)
タグ: loading_and_analysisincompatible_change
--[no]incompatible_enable_apple_toolchain_resolution のデフォルト: "false"
ツールチェーン解決を使用して、apple ルール用の Apple SDK を選択します(Starlark とネイティブ)
タグ: loading_and_analysisincompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone のデフォルト: "true"
true の場合、Bazel は lto インデックス作成コマンドラインに C++ リンク アクション コマンドラインを再利用しません(詳しくは、https://github.com/bazelbuild/bazel/issues/6791 をご覧ください)。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_remove_legacy_whole_archive のデフォルト: "true"
true の場合、Bazel はデフォルトでライブラリの依存関係をアーカイブ全体としてリンクしません(移行手順については、https://github.com/bazelbuild/bazel/issues/7362 をご覧ください)。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_require_ctx_in_configure_features のデフォルト: "true"
true の場合、Bazel は cc_common.configure_features に 'gsuite' パラメータを必要とします(詳しくは、https://github.com/bazelbuild/bazel/issues/7793 をご覧ください)。
タグ: loading_and_analysisincompatible_change
--[no]interface_shared_objects のデフォルト: "true"
ツールチェーンでサポートされている場合は、インターフェース共有オブジェクトを使用します。現在、この設定はすべての ELF ツールチェーンでサポートされています。
タグ: loading_and_analysisaffects_outputsaffects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> のデフォルト: 説明を参照
iOS アプリのビルドに使用する iOS SDK のバージョンを指定します。指定しない場合は、「xcode_version」のデフォルトの iOS SDK バージョンが使用されます。
タグ: loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> のデフォルト: 説明を参照
macOS アプリケーションのビルドに使用する macOS SDK のバージョンを指定します。指定しない場合は、「xcode_version」のデフォルトの macOS SDK バージョンを使用します。
タグ: loses_incremental_state
--minimum_os_version=<a string> のデフォルト: 説明を参照
コンパイルの対象となる最小 OS バージョン。
タグ: loading_and_analysisaffects_outputs
--platform_mappings=<a relative path> のデフォルト: ""
マッピング ファイルの場所。プラットフォームが設定されていない場合に使用するプラットフォーム、またはプラットフォームがすでに存在する場合に設定するフラグを記述します。メインのワークスペースのルートからの相対パスにする必要があります。デフォルトは「platform_mappings」(ワークスペース ルートの直下にあるファイル)です。
タグ: affects_outputschanges_inputsloading_and_analysis
--platforms=<a build target label> のデフォルト: ""
現在のコマンドのターゲット プラットフォームを記述するプラットフォーム ルールのラベル。
タグ: affects_outputschanges_inputsloading_and_analysis
--python2_path=<a string> のデフォルト: 説明を参照
非推奨、NoOps。「--compatibility_use_python_ツールチェーン」によって無効。
タグ: no_opdeprecated
--python3_path=<a string> のデフォルト: 説明を参照
非推奨、NoOps。「--compatibility_use_python_ツールチェーン」によって無効。
タグ: no_opdeprecated
--python_path=<a string> のデフォルト: 説明を参照
ターゲット プラットフォームで Python ターゲットを実行するために呼び出される Python インタープリタの絶対パス。非推奨。--compatible_use_python_ツールチェーン s によって無効になっています。
タグ: loading_and_analysisaffects_outputs
--python_top=<a build target label> のデフォルト: 説明を参照
ターゲット プラットフォームで Python ターゲットを実行するために呼び出される Python インタープリタを表す py_runtime のラベル。非推奨。--compatible_use_python_ツールチェーン s によって無効になっています。
タグ: loading_and_analysisaffects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> のデフォルト: 説明を参照
tvOS アプリのビルドに使用する tvOS SDK のバージョンを指定します。指定しない場合は、「xcode_version」のデフォルトの tvOS SDK バージョンを使用します。
タグ: 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_stateloading_and_analysis
コマンドの出力を制御するオプション:
--[no]apple_generate_dsym のデフォルト: "false"
デバッグ シンボル(.dSYM)ファイルを生成するかどうかを指定します。
タグ: affects_outputsaction_command_lines
true の場合、すべてのターゲットのランファイル シンボリック リンク フォレストをビルドします。false の場合は、ローカル アクション、テスト、または実行コマンドで必要とされる場合にのみ書き込みます。
タグ: affects_outputs
--[no]build_runfile_manifests のデフォルト: "true"
true の場合、すべてのターゲットの runfile マニフェストを書き込みます。false の場合は省略します。false の場合、ローカルテストは実行に失敗します。
タグ: affects_outputs
--[no]build_test_dwp のデフォルト: "false"
有効にすると、C++ テストを静的かつ fission でビルドするときに、テストバイナリの .dwp ファイルも自動的にビルドされます。
タグ: loading_and_analysisaffects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options> のデフォルト: ".pb.h"
cc_proto_library が作成するヘッダー ファイルの接尾辞を設定します。
タグ: affects_outputsloading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options> のデフォルト: 「.pb.cc」
cc_proto_library が作成するソースファイルの接尾辞を設定します。
タグ: affects_outputsloading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info のデフォルト: "false"
proto_library で、代替 Java API バージョンの追加アクションを実行します。
タグ: affects_outputsloading_and_analysisexperimental
--[no]experimental_proto_extra_actions のデフォルト: "false"
proto_library で、代替 Java API バージョンの追加アクションを実行します。
タグ: affects_outputsloading_and_analysisexperimental
--[no]experimental_save_feature_state のデフォルト: "false"
有効化されリクエストされた機能の状態をコンパイルの出力として保存します。
タグ: affects_outputsexperimental
--fission=<a set of compilation modes> のデフォルト: 「no」
C++ コンパイルとリンクに分裂を使用するコンパイル モードを指定します。{'fastbuild', 'dbg', 'opt'} の任意の組み合わせにできます。すべてのモードを有効にする場合は 'yes'、すべてのモードを無効にする特殊な値 'no' にすることもできます。
タグ: loading_and_analysisaction_command_linesaffects_outputs
--[no]incompatible_always_include_files_in_data のデフォルト: "true"
true の場合、ネイティブ ルールによってデータ依存関係の <code>DefaultInfo.files</code> が実行ファイルに追加されます。これは、Starlark ルールの推奨動作(https://bazel.build/extending/rules#runfiles_features_to_avoid)と一致します。
タグ: affects_outputsincompatible_change
--[no]legacy_external_runfiles のデフォルト: "true"
true の場合、外部リポジトリのランファイル シンボリック リンク フォレストを(.runfiles/repo に加えて).runfiles/wsname/external/repo にビルドします。
タグ: 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_outputsloading_and_analysisloses_incremental_state
--[no]android_databinding_use_androidx のデフォルト: "true"
AndroidX 互換のデータ バインディング ファイルを生成します。これは、データ バインディング v2 でのみ使用されます。このフラグは機能しません。
タグ: affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[no]android_databinding_use_v3_4_args のデフォルト: "true"
Android データ バインディング v2 を 3.4.0 引数で使用します。このフラグは機能しません。
タグ: affects_outputsloading_and_analysisloses_incremental_stateexperimental
--android_dynamic_mode=<off, default or fully> のデフォルト: 「off」
cc_binary で共有ライブラリが明示的に作成されていない場合に、Android ルールの C++ 依存関係を動的にリンクするかどうかを指定します。「default」を選択すると、動的にリンクするかどうかが bazel によって選択されます。「complete」はすべてのライブラリが動的にリンクされることを意味します。「オフ」は、すべてのライブラリがほぼ静的モードでリンクされることを意味します。
タグ: affects_outputsloading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency> のデフォルト: 「alphabetical」
Android バイナリのマニフェスト マージツールに渡されるマニフェストの順序を設定します。ALPHABETICAL は、マニフェストが execroot からの相対パスで並べ替えられることを意味します。ALPHABETICAL_BY_CONFIGURATION は、出力ディレクトリ内の構成ディレクトリからの相対パスでマニフェストが並べ替えられることを意味します。DEPENDENCY は、各ライブラリのマニフェストが依存関係のマニフェストの前に来るようにマニフェストが並べ替えられることを意味します。
タグ: action_command_linesexecution
--[no]android_resource_shrinking のデフォルト: "false"
ProGuard を使用する android_binary APK のリソース圧縮を有効にします。
タグ: affects_outputsloading_and_analysis
--[no]build_python_zip のデフォルト: "auto"
Python の実行可能 zip をビルドします(Windows の場合はオフ、他のプラットフォームの場合はオフ)。
タグ: affects_outputs
--catalyst_cpus=<comma-separated list of options> 回の使用が累積されています
Apple Catalyst バイナリをビルドするアーキテクチャのカンマ区切りリスト。
タグ: loses_incremental_stateloading_and_analysis
--[no]collect_code_coverage のデフォルト: "false"
指定した場合、Bazel は(可能な場合はオフライン インストルメンテーションを使用して)コードをインストルメント化し、テスト中にカバレッジ情報を収集します。--instrumentation_filter に一致するターゲットのみが影響を受けます。通常、このオプションは直接指定せず、代わりに「bazelCoverage」コマンドを使用する必要があります。
タグ: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] デフォルト: "fastbuild"
バイナリをビルドするモードを指定します。値: fastbuild、dbg、opt。
タグ: affects_outputsaction_command_lines
--conlyopt=<a string> 回の使用が累積されています
C ソースファイルのコンパイル時に gcc に渡す追加オプション。
タグ: action_command_linesaffects_outputs
--copt=<a string> 回の使用が累積されています
gcc に渡す追加オプション。
タグ: action_command_linesaffects_outputs
--cpu=<a string> のデフォルト: ""
ターゲット CPU。
タグ: changes_inputsaffects_outputs
--cs_fdo_absolute_path=<a string> のデフォルト: 説明を参照
CSFDO のプロファイル情報を使用してコンパイルを最適化します。プロファイル ファイル(未加工またはインデックス付き LLVM プロファイル ファイル)を含む zip ファイルの絶対パス名を指定します。
タグ: 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_linesaffects_outputs
--define=<a 'name=value' assignment> 回の使用が累積されています
--define オプションごとにビルド変数の割り当てを指定します。
タグ: changes_inputsaffects_outputs
--dynamic_mode=<off, default or fully> のデフォルト: "default"
C++ バイナリを動的にリンクするかどうかを指定します。「default」を選択すると、Bazel が動的にリンクするかどうかを選択します。「complete」はすべてのライブラリが動的にリンクされることを意味します。「オフ」は、すべてのライブラリがほぼ静的モードでリンクされることを意味します。
タグ: loading_and_analysisaffects_outputs
--[no]enable_fdo_profile_absolute_path のデフォルト: "true"
設定すると、fdo_specific_profile_path を使用するとエラーが発生します。
タグ: affects_outputs
--[no]enable_runfiles のデフォルト: "auto"
runfiles シンボリック リンク ツリーを有効にする: Windows では、他のプラットフォームではデフォルトで無効になっています。
タグ: affects_outputs
--experimental_action_listener=<a build target label> 回の使用が累積されています
アスペクトを優先するため非推奨となりました。action_listener を使用して、既存のビルド アクションに extra_action をアタッチします。
タグ: executionexperimental
--[no]experimental_android_compress_java_resources のデフォルト: "false"
APK 内の Java リソースを圧縮する
タグ: affects_outputsloading_and_analysisexperimental
--[no]experimental_android_databinding_v2 のデフォルト: "true"
Android データ バインディング v2 を使用します。このフラグは機能しません。
タグ: affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[no]experimental_android_resource_shrinking のデフォルト: "false"
ProGuard を使用する android_binary APK のリソース圧縮を有効にします。
タグ: affects_outputsloading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex のデフォルト: "false"
rex ツールを使用して dex ファイルを書き換える
タグ: affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[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 と -fasynchronous-unwind-tables を使用してコンパイルします。
タグ: action_command_linesaffects_outputsexperimental
--experimental_output_paths=<off, content or strip> のデフォルト: 「off」
特にマルチプラットフォーム / マルチ構成のビルドの場合、出力ツリールールで出力を書き込む場所に使用するモデル。これは非常に試験運用版です。詳細については、https://github.com/bazelbuild/bazel/issues/6526 をご覧ください。Starlark のアクションでは、キー「supports-path-mapping」を「execution_requirements」辞書に追加することでパス マッピングを有効にできます。
タグ: loses_incremental_statebazel_internal_configurationaffects_outputsexecution
--experimental_override_name_platform_in_output_dir=<a 'label=value' assignment> 回の使用が累積されています
各エントリは label=value の形式にする必要があります。label はプラットフォームを表し、values は出力パスで使用する略称です。--experimental_platform_in_output_dir が true の場合にのみ使用されます。名前の優先順位が最も高い。
タグ: affects_outputsexperimental
--[no]experimental_platform_in_output_dir のデフォルト: "false"
true の場合、出力ディレクトリ名で CPU ではなくターゲット プラットフォームの略称が使用されます。正確なスキームは試験運用版であり、変更される可能性があります。まず、まれに、--platforms オプションの値が 1 つではない場合は、platforms オプションのハッシュが使用されます。次に、--experimental_override_name_platform_in_output_dir によって現在のプラットフォームの略称が登録されている場合は、その略称が使用されます。--experimental_use_platforms_in_output_dir_legacy_heuristic に設定されている場合は、現在のプラットフォーム ラベルに基づいた略称を使用します。最後に、プラットフォーム オプションのハッシュが最後の手段として使用されます。
タグ: affects_outputsexperimental
--[no]experimental_use_llvm_covmap のデフォルト: "false"
指定した場合、collect_code_coverage が有効なときに Bazel は gcov ではなく llvm-cov のカバレッジ マップ情報を生成します。
タグ: changes_inputsaffects_outputsloading_and_analysisexperimental
--[no]experimental_use_platforms_in_output_dir_legacy_heuristic のデフォルト: "true"
このフラグは、推奨される移行戦略またはテスト戦略の一部としてのみ使用してください。ヒューリスティックには既知の欠陥があるため、--experimental_override_name_platform_in_output_dir のみを使用するよう移行することをおすすめします。
タグ: affects_outputsexperimental
--fat_apk_cpu=<comma-separated set of options> のデフォルト: 「armeabi-v7a」
このオプションを設定すると、指定されたすべてのターゲット アーキテクチャ(--fat_apk_cpu=x86,armeabi-v7a. このフラグを指定すると、android_binary ルールの依存関係について --android_cpu は無視されます。
タグ: affects_outputsloading_and_analysisloses_incremental_state
--[no]fat_apk_hwasan のデフォルト: "false"
HWASAN 分割を作成するかどうか。
タグ: affects_outputsloading_and_analysisloses_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_inputsaffects_outputs
--[no]force_pic のデフォルト: "false"
有効にすると、すべての C++ コンパイルで位置独立コード(「-fPIC」)が生成されます。リンクでは非 PIC ライブラリよりも PIC ビルド済みライブラリが優先され、リンクでは位置独立実行ファイル(「-pie」)が生成されます。
タグ: loading_and_analysisaffects_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_outputsaction_command_lines
--host_conlyopt=<a string> 回の使用が累積されています
exec 構成で C ソースファイル(C++ ではない)をコンパイルするときに C コンパイラに渡す追加オプション。
タグ: action_command_linesaffects_outputs
--host_copt=<a string> 回の使用が累積されています
exec 構成でビルドされたツールの C コンパイラに渡す追加オプション。
タグ: action_command_linesaffects_outputs
--host_cpu=<a string> のデフォルト: ""
ホストの CPU。
タグ: changes_inputsaffects_outputs
--host_cxxopt=<a string> 回の使用が累積されています
exec 構成でビルドされたツールの C++ コンパイラに渡す追加オプション。
タグ: action_command_linesaffects_outputs
--host_features=<a string> 回の使用が累積されています
指定された機能は、exec 構成で構築されたターゲットに対してデフォルトで有効または無効にされます。-<feature> を指定すると、この機能が無効になります。ネガティブな特徴は、ポジティブな特徴よりも常に優先されます。
タグ: changes_inputsaffects_outputs
--host_force_python=<PY2 or PY3> のデフォルト: 説明を参照
実行構成の Python バージョンをオーバーライドします。「PY2」または「PY3」のいずれかです。
タグ: loading_and_analysisaffects_outputs
--host_linkopt=<a string> 回の使用が累積されています
実行構成でツールをリンクする際にリンカーに渡す追加オプション。
タグ: action_command_linesaffects_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_nここで、regex_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_linesaffects_outputs
--host_swiftcopt=<a string> 回の使用が累積されています
実行ツールのために swiftc に渡す追加オプション。
タグ: action_command_linesaffects_outputs
--[no]incompatible_auto_exec_groups のデフォルト: "false"
有効にすると、ルールで使用されるツールチェーンごとに実行グループが自動的に作成されます。そのためには、ルールのアクションに「ツールチェーン」パラメータを指定する必要があります。詳細については、https://github.com/bazelbuild/bazel/issues/17134 をご覧ください。
タグ: affects_outputsincompatible_change
--[no]incompatible_merge_genfiles_directory のデフォルト: "true"
true の場合、genfiles ディレクトリが bin ディレクトリに折りたたみられます。
タグ: affects_outputsincompatible_change
--[no]incompatible_use_host_features のデフォルト: "true"
true の場合、ターゲット構成にのみ --features を使用し、実行構成に --host_features を使用します。
タグ: changes_inputsaffects_outputsincompatible_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_stateloading_and_analysis
--[no]legacy_whole_archive のデフォルト: "true"
非推奨となり、--compatible_remove_legacy_whole_archive に置き換えられました(詳しくは、https://github.com/bazelbuild/bazel/issues/7362 をご覧ください)。オンにした場合、linkshared=True と linkopts に linkstatic=True または「-static」のいずれかが指定されている cc_binary ルールに対して --whole-archive を使用します。これは下位互換性のためだけのものです。より適切な代替策は、必要に応じて常時リンク=1 を使用することです。
タグ: action_command_linesaffects_outputsdeprecated
--linkopt=<a string> 回の使用が累積されています
リンク時に gcc に渡す追加オプション。
タグ: action_command_linesaffects_outputs
--ltobackendopt=<a string> 回の使用が累積されています
LTO バックエンド ステップに渡す追加オプション(--features=thin_lto の下)。
タグ: action_command_linesaffects_outputs
--ltoindexopt=<a string> 回の使用が累積されています
LTO のインデックス登録ステップに渡す追加オプション(--features=thin_lto の下)。
タグ: action_command_linesaffects_outputs
--macos_cpus=<comma-separated list of options> 回の使用が累積されています
Apple macOS バイナリをビルドするアーキテクチャのカンマ区切りリスト。
タグ: loses_incremental_stateloading_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_nここで、regex_filter は正規表現パターンを含むリストと除外するパターンのリストを表します(-instrumentation_filter もご覧ください)。option_1 から option_n は任意のコマンドライン オプションを表します。オプションにカンマが含まれる場合は、バックスラッシュで囲む必要があります。オプションには @ を含めることができます。最初の @ のみが文字列の分割に使用されます。例: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 は、//foo/ 内のすべての cc ファイル(bar.cc を除く)の gcc コマンドラインに -O0 コマンドラインオプションを追加します。
タグ: action_command_linesaffects_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> 回の使用が累積されています
特定のバックエンド オブジェクトをコンパイルするときに、(--features=thin_lto にある)LTO バックエンドに選択的に渡す追加のオプション。このオプションは複数回渡すことができます。構文: regex_filter@option_1,option_2,...,option_nここで regex_filter は正規表現パターンのリストを表し、option_1 から option_n は任意のコマンドライン オプションを表します。オプションにカンマが含まれる場合は、バックスラッシュで囲む必要があります。オプションには @ を含めることができます。最初の @ のみが文字列の分割に使用されます。例: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 は、//foo/ 内のすべての o ファイル(bar.o を除く)の LTO バックエンドコマンドラインに -O0 コマンドラインオプションを追加します。
タグ: action_command_lines, affects_outputs
--platform_suffix=<a string> のデフォルト: 説明を参照
構成ディレクトリに追加する接尾辞を指定します。
タグ: loses_incremental_stateaffects_outputsloading_and_analysis
--propeller_optimize=<a build target label> のデフォルト: 説明を参照
Propeller のプロファイル情報を使用して、ビルド ターゲットを最適化します。Propeller のプロファイルは、cc プロファイルと ld プロファイルの 2 つのファイルのうち少なくとも 1 つで構成する必要があります。このフラグには、プロペラ プロファイル入力ファイルを参照する必要があるビルドラベルを指定できます。たとえば、a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",) でラベルを定義する BUILD ファイルでは、Bazel でファイルを可視化できるように、対応するパッケージにディレクティブを追加する必要があります。このオプションは次のように使用する必要があります。--propeller_optimize=//a/b:propeller_profile
タグ: action_command_linesaffects_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
--[no]share_native_deps のデフォルト: "true"
true の場合、同じ機能を含むネイティブ ライブラリが複数のターゲット間で共有されます
タグ: loading_and_analysisaffects_outputs
--[no]stamp のデフォルト: "false"
日付、ユーザー名、ホスト名、ワークスペース情報などを含むバイナリをスタンプします。
タグ: affects_outputs
--strip=<always, sometimes or never> のデフォルト: 「発生することがある」
バイナリと共有ライブラリを削除するかどうかを指定します(「-Wl、--strip-debug」を使用)。「nottimes」のデフォルト値は、--compile_mode=fastbuild のみを削除します。
タグ: affects_outputs
--stripopt=<a string> 回の使用が累積されています
「<name>.stripped」バイナリの生成時に削除に渡す追加オプション。
タグ: action_command_linesaffects_outputs
--swiftcopt=<a string> 回の使用が累積されています
Swift コンパイルに渡す追加オプション。
タグ: action_command_lines
--tvos_cpus=<comma-separated list of options> 回の使用が累積されています
Apple tvOS バイナリをビルドするアーキテクチャのカンマ区切りのリスト。
タグ: loses_incremental_stateloading_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_stateloading_and_analysis
--watchos_cpus=<comma-separated list of options> 回の使用が累積されています
Apple watchOS バイナリをビルドする対象アーキテクチャのカンマ区切りリスト。
タグ: loses_incremental_stateloading_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_inputsloading_and_analysisexperimental
--[no]check_licenses のデフォルト: "false"
依存パッケージによるライセンスの制約が、ビルド中のターゲットの配布モードと競合していないことを確認してください。デフォルトでは、ライセンスはチェックされていません。
タグ: build_file_semantics
--[no]check_visibility のデフォルト: "true"
無効にすると、ターゲット依存関係の可視性エラーは警告に降格されます。
タグ: build_file_semantics
--[no]desugar_for_android のデフォルト: "true"
dex 変換の前に Java 8 バイトコードを desugar するかどうか。
タグ: affects_outputsloading_and_analysisloses_incremental_state
--[no]desugar_java8_libs のデフォルト: "false"
レガシー デバイス向けのアプリにサポートされている Java 8 ライブラリを含めるかどうかを指定します。
タグ: affects_outputsloading_and_analysisloses_incremental_stateexperimental
--[no]enforce_constraints のデフォルト: "true"
各ターゲットが対応している環境を確認し、ターゲットに同じ環境をサポートしていない依存関係がある場合はエラーを報告します
タグ: build_file_semantics
--[no]experimental_check_desugar_deps のデフォルト: "true"
Android バイナリレベルで正しい desugar を再確認するかどうか。
タグ: eagerness_to_exitloading_and_analysisexperimental
--experimental_import_deps_checking=<off, warning or error> のデフォルト: 「OFF」
有効にすると、aar_import の依存関係が完了しているかどうかを確認します。この適用により、ビルドが中断されたり、警告が表示されたりする場合があります。
タグ: loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default> のデフォルト: "default"
true の場合、Java ターゲットが、直接使用されるすべてのターゲットを依存関係として明示的に宣言していることを確認します。
タグ: build_file_semanticseagerness_to_exit
--[no]incompatible_check_testonly_for_output_files のデフォルト: "false"
有効になっている場合は、生成ルールの testonly を検索して、出力ファイルである前提条件ターゲットについて testonly をチェックします。これは公開設定の確認と一致します。
タグ: build_file_semanticsincompatible_change
--[no]incompatible_check_visibility_for_toolchains のデフォルト: "false"
有効にすると、ツールチェーンの実装にも可視性チェックが適用されます。
タグ: build_file_semanticsincompatible_change
--[no]incompatible_disable_native_android_rules のデフォルト: "false"
有効にすると、ネイティブ Android ルールの直接使用が無効になります。https://github.com/bazelbuild/rules_android にある Starlark Android ルールを使用してください
タグ: eagerness_to_exitincompatible_change
--[no]incompatible_disable_native_apple_binary_rule のデフォルト: "false"
NoOps。下位互換性のためにここに保持されています。
タグ: eagerness_to_exitincompatible_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_analysisincompatible_change
--[no]incompatible_validate_top_level_header_inclusions のデフォルト: "true"
true の場合、Bazel はトップレベル ディレクトリ ヘッダーの包含も検証します(詳しくは、https://github.com/bazelbuild/bazel/issues/10047 をご覧ください)。
タグ: loading_and_analysisincompatible_change
--python_native_rules_allowlist=<a build target label> のデフォルト: 説明を参照
--compatibility_python_disallow_native_rules を適用するときに使用する許可リスト(package_group ターゲット)。
タグ: loading_and_analysis
--[no]strict_filesets のデフォルト: "false"
このオプションを有効にすると、パッケージの境界を越えるファイルセットがエラーとして報告されます。
タグ: build_file_semanticseagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default> のデフォルト: "error"
オフの場合を除き、proto_library ターゲットが、直接使用されるすべてのターゲットを依存関係として明示的に宣言していることを確認します。
タグ: build_file_semanticseagerness_to_exitincompatible_change
--strict_public_imports=<off, warn, error, strict or default> のデフォルト: 「off」
オフの場合を除き、「import public」で使用されるすべてのターゲットが、proto_library ターゲットでエクスポート済みとして明示的に宣言されていることを確認します。
タグ: build_file_semanticseagerness_to_exitincompatible_change
--[no]strict_system_includes のデフォルト: "false"
true の場合、システム インクルード パス(-isystem)を通じて検出されたヘッダーも宣言する必要があります。
タグ: loading_and_analysiseagerness_to_exit
--target_environment=<a build target label> 回の使用が累積されています
このビルドのターゲット環境を宣言します。「環境」ルールへのラベル参照にする必要があります。指定する場合、すべてのトップレベル ターゲットがこの環境と互換性がある必要があります。
タグ: changes_inputs
ビルドの署名出力に影響するオプション:
--apk_signing_method=<v1, v2, v1_v2 or v4> のデフォルト: "v1_v2"
APK の署名に使用する実装
タグ: action_command_linesaffects_outputsloading_and_analysis
--[no]device_debug_entitlements のデフォルト: "true"
設定されている場合、コンパイル モードが「opt」でない場合、objc アプリは署名時にデバッグ資格を含めます。
タグ: changes_inputs
--ios_signing_cert_name=<a string> のデフォルト: 説明を参照
iOS 署名に使用する証明書名。設定しない場合、プロビジョニング プロファイルにフォールバックします。証明書のキーチェーン ID 設定、または共同署名の man ページ(署名 ID)に従って証明書の共通名の(部分文字列)を指定できます。
タグ: action_command_lines
このオプションは、BUILD ファイル、.bzl ファイル、WORKSPACE ファイルからアクセス可能な Starlark 言語またはビルド API のセマンティクスに影響します。
--[no]incompatible_config_setting_private_default_visibility のデフォルト: "false"
Compatibility_enforce_config_setting_visibility=false は、NoOps です。それ以外の場合、このフラグが false の場合、明示的な公開設定属性のない config_setting はすべて //visibility:public です。このフラグが true の場合、config_setting は他のすべてのルールと同じ公開設定ロジックに従います。https://github.com/bazelbuild/bazel/issues/12933 をご覧ください。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_disallow_legacy_py_provider のデフォルト: "true"
NoOps(オペレーションなし)はまもなく削除されます。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes のデフォルト: "false"
true の場合、objc_library と objc_import で sdk_frameworks 属性と weak_sdk_frameworks 属性を禁止します。
タグ: build_file_semanticsincompatible_change
--[no]incompatible_enforce_config_setting_visibility のデフォルト: "true"
true の場合、config_setting の公開設定制限を適用します。false の場合、すべての config_setting がすべてのターゲットに表示されます。https://github.com/bazelbuild/bazel/issues/12932 をご覧ください。
タグ: loading_and_analysisincompatible_change
true の場合、objc_library と objc_import の alwayslink 属性のデフォルト値を true にします。
タグ: build_file_semanticsincompatible_change
--[no]incompatible_python_disallow_native_rules のデフォルト: "false"
true の場合、組み込みの py_* ルールを使用するとエラーが発生します。代わりに、rule_python ルールを使用する必要があります。詳細と移行手順については、https://github.com/bazelbuild/bazel/issues/17773 をご覧ください。
タグ: loading_and_analysisincompatible_change
テスト環境またはテストランナーの動作を管理するオプション:
--[no]allow_analysis_failures のデフォルト: "false"
true の場合、ルール ターゲットの分析が失敗すると、ビルド失敗ではなく、エラーの説明を含む AnalysisFailureInfo のインスタンスがターゲットに伝播されます。
タグ: loading_and_analysisexperimental
--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_analysisexperimental
--default_test_resources=<a resource name followed by equal and 1 float or 4 float, e.g. memory=10,30,60,100> 回の使用が累積されています
テストのデフォルトのリソース量をオーバーライドします。想定される形式は <resource>=<value> です。1 つの正の数値を <value> として指定すると、すべてのテストサイズのデフォルトのリソースがオーバーライドされます。4 つのカンマ区切りの数値を指定すると、テストサイズの小、中、大、巨大それぞれのリソース量がオーバーライドされます。値は HOST_RAM または HOST_CPU で、オプションで [-|*]<float> が後に続く場合もあります(例: memory=HOST_RAM*.1, HOST_RAM*.2, HOST_RAM*.3, HOST_RAM*.4)。このフラグで指定されたデフォルトのテストリソースは、タグで指定された明示的なリソースによってオーバーライドされます。
--[no]experimental_android_use_parallel_dex2oat のデフォルト: "false"
dex2oat を並行して使用すると、android_test を高速化できます。
タグ: loading_and_analysishost_machine_resource_optimizationsexperimental
--[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_test。run_per_test は整数値を表し、regex_filter は包含および除外正規表現パターンのリストを表します(--instrumentation_filter もご覧ください)。例: --runs_per_test=//foo/.*,-//foo/bar/.*@3 は、foo/bar の下にあるテストを除く //foo/内のすべてのテストを 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
Bzlmod の出力とセマンティクスに関連するオプション:
--[no]configure のデフォルト: "false"
システム構成を目的として「構成」とマークされたリポジトリのみを取得します。--enable_bzlmod がオンになっている場合にのみ機能します。
タグ: changes_inputs
--[no]force のデフォルト: "false"
既存のリポジトリがある場合は無視して、リポジトリを強制的に再度取得します。--enable_bzlmod がオンになっている場合にのみ機能します。
タグ: changes_inputs
--repo=<a string> 回の使用が累積されています
指定されたリポジトリ({@apparent_repo_name} または {@@canonical_repo_name})のみを取得します。--enable_bzlmod がオンになっている場合にのみ機能します。
タグ: changes_inputs
ビルド時間の最適化をトリガーするオプション:
--[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_analysisexecutionaffects_outputsexperimental
--[no]experimental_inmemory_jdeps_files のデフォルト: "true"
有効にすると、Java コンパイルで生成された依存関係(.jdeps)ファイルは、ディスクに書き込まれるのではなく、リモート ビルドノードからメモリ内で直接渡されます。
タグ: loading_and_analysisexecutionaffects_outputsexperimental
--[no]experimental_objc_include_scanning のデフォルト: "false"
目的の C/C++ のインクルード スキャンを実行するかどうか。
タグ: loading_and_analysisexecutionchanges_inputs
--[no]experimental_retain_test_configuration_across_testonly のデフォルト: "false"
--trim_test_configuration を有効にすると、testonly=1 とマークされたルールのテスト設定はトリミングされません。これは、テスト以外のルールが cc_test ルールに依存している場合に、アクションの競合の問題を減らすためです。--trim_test_configuration が false の場合は効果がありません。
タグ: loading_and_analysisloses_incremental_state
--[no]experimental_starlark_cc_import のデフォルト: "false"
有効にすると、Starlark バージョンの cc_import を使用できます。
タグ: loading_and_analysisexperimental
--[no]experimental_unsupported_and_brittle_include_scanning のデフォルト: "false"
入力ファイルの #include 行を解析して C/C++ コンパイルへの入力を絞り込むかどうかを指定します。これにより、コンパイル入力ツリーのサイズを小さくすることで、パフォーマンスとインクリメンタリティを向上させることができます。ただし、インクルード スキャナは C プリプロセッサ セマンティクスを完全には実装していないため、ビルドが破損する可能性もあります。特に、動的な #include ディレクティブは認識されず、プリプロセッサの条件付きロジックは無視されます。自己責任で使用してください。このフラグに関連する問題はすべてクローズされます。
タグ: loading_and_analysisexecutionchanges_inputs
--[no]incremental_dexing のデフォルト: "true"
ほとんどの処理は、Jar ファイルごとに個別に dex 変換を行います。
タグ: affects_outputsloading_and_analysisloses_incremental_state
--[no]objc_use_dotd_pruning のデフォルト: "true"
設定すると、clang によって出力された .d ファイルを使用して、objc コンパイルに渡される入力のセットがプルーニングされます。
タグ: changes_inputsloading_and_analysis
--[no]process_headers_in_dependencies のデフォルト: "false"
ターゲット //a:a をビルドするときに、//a:a が依存するすべてのターゲットでヘッダーを処理します(ツールチェーンでヘッダー処理が有効になっている場合)。
タグ: execution
--[no]trim_test_configuration のデフォルト: "true"
有効にすると、ビルドのトップレベルの下でテスト関連のオプションが消去されます。このフラグを有効にすると、テストを非テストルールの依存関係としてビルドすることはできませんが、テスト関連のオプションを変更してもテスト以外のルールが再分析されることはありません。
タグ: loading_and_analysisloses_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 ターゲットの runfile で __init__.py ファイルが自動的に作成されないようにします。正確には、py_binary または py_test のターゲットで legacy_create_init が「auto」(デフォルト)に設定されている場合、このフラグが設定されている場合にのみ false として扱われます。https://github.com/bazelbuild/bazel/issues/10076 をご覧ください。
タグ: affects_outputsincompatible_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_outputsincompatible_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_analysisaffects_outputsincompatible_change
--[no]incompatible_use_python_toolchains のデフォルト: "true"
true に設定すると、実行可能なネイティブの Python ルールは、--python_top などの以前のフラグで指定されたランタイムではなく、Python ツールチェーンで指定された Python ランタイムを使用します。
タグ: loading_and_analysisincompatible_change
--python_version=<PY2 or PY3> のデフォルト: 説明を参照
Python メジャー バージョン モード(PY2 または PY3)。これは py_binary ターゲットと py_test ターゲットによってオーバーライドされるため(バージョンを明示的に指定していない場合でも)、通常はこのフラグを指定する理由はほとんどありません。
タグ: loading_and_analysisaffects_outputs
その他のオプション(特に分類されていない)。
--[no]cache_test_results [-t] デフォルト: "auto"
「auto」に設定すると、(1)Bazel がテストまたはその依存関係の変更を検出した、(2)テストが外部としてマークされている、(3)複数のテスト実行が --runs_per_test でリクエストされた、(4)テストが失敗した場合にのみ、Bazel はテストを再実行します。「yes」に設定した場合、Bazel は「外部」とマークされたテストを除くすべてのテスト結果をキャッシュに保存します。「no」に設定した場合、Bazel はテスト結果をキャッシュに保存しません。
--deleted_packages=<comma-separated list of package names> 回の使用が累積されています
パッケージパスのどこかに表示されている場合でも、ビルドシステムが存在しないと見なすパッケージ名のカンマ区切りリスト。 このオプションは、既存のパッケージ「x」のサブパッケージ「x/y」を削除する場合に使用します。たとえば、クライアントで x/y/BUILD を削除した後でも、別の package_path エントリで指定されていれば、ビルドシステムで「//x:y/z」というラベルが検出されるとエラーが表示されることがあります。--deleted_packages x/y を指定すると、この問題を回避できます。
--[no]experimental_cancel_concurrent_tests のデフォルト: "false"
true の場合、Blaze は最初に正常に実行された際に同時に実行中のテストをキャンセルします。これは、--runs_per_test_detects_flakes と組み合わせた場合にのみ有効です。
タグ: affects_outputsloading_and_analysis
--[no]experimental_fetch_all_coverage_outputs のデフォルト: "false"
true の場合、Bazel はカバレッジの実行中にテストごとにカバレッジ データ ディレクトリ全体を取得します。
タグ: affects_outputsloading_and_analysis
--[no]experimental_generate_llvm_lcov のデフォルト: "false"
true の場合、clang のカバレッジにより LCOV レポートが生成されます。
タグ: affects_outputsloading_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 でのみ使用できます。
--[no]fetch のデフォルト: "true"
コマンドが外部依存関係を取得できるようにします。false に設定すると、依存関係のキャッシュ バージョンが使用されます。依存関係が存在しない場合は、コマンドが失敗します。
--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_analysisincompatible_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 変換を実行するために使用するバイナリを指定します。
--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_outputsloading_and_analysis
--proto_toolchain_for_cc=<a build target label> のデフォルト: "@bazel_tools//tools/proto:cc_ツールチェーン"
C++ proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル。
タグ: affects_outputsloading_and_analysis
--proto_toolchain_for_j2objc=<a build target label> のデフォルト: "@bazel_tools//tools/j2objc:j2objc_proto_ツールチェーン"
j2objc proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル。
タグ: affects_outputsloading_and_analysis
--proto_toolchain_for_java=<a build target label> のデフォルト: "@bazel_tools//tools/proto:java_ツールチェーン"
Java proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル
タグ: affects_outputsloading_and_analysis
--proto_toolchain_for_javalite=<a build target label> のデフォルト: "@bazel_tools//tools/proto:javalite_ツールチェーン"
JavaLite proto のコンパイル方法を記述する proto_lang_ツールチェーン() のラベル。
タグ: affects_outputsloading_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_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> のデフォルト: 「AutoML」
テストのシャーディングの戦略を指定します。「shard_count」BUILD 属性が存在する場合にのみシャーディングを使用する「明示的な」を指定します。テストのシャーディングを使用しないように「disabled」に設定します。「forced=k」は、「shard_count」ビルド属性に関係なく、テスト用の「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
設定すると、キャッシュ ヒットが発生した場合、リポジトリ キャッシュはファイルをコピーするのではなくハードリンクします。これはディスク容量を節約するためのものです。
タグ: bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer> のデフォルト: 「0」
ダウンロード エラーの再試行の最大試行回数。0 に設定すると、再試行が無効になります。
タグ: experimental
--experimental_scale_timeouts=<a double> のデフォルト: 「1.0」
Starlark リポジトリ ルールのすべてのタイムアウトを、この係数でスケーリングします。このようにして、ソースコードを変更することなく、ルール作成者の想定よりも遅いマシンで外部リポジトリを動作させることができます。
タグ: bazel_internal_configurationexperimental
--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
--[no]incompatible_disable_native_repo_rules のデフォルト: "false"
false の場合、ネイティブ リポジトリ ルールを WORKSPACE で使用できます。それ以外の場合は、代わりに Starlark リポジトリ ルールを使用する必要があります。ネイティブ リポジトリのルールには、local_repository、new_local_repository、local_config_platform、android_sdk_repository、android_ndk_repository があります。
タグ: bazel_internal_configuration
--repository_cache=<a path> のデフォルト: 説明を参照
外部リポジトリの取得中に取得されたダウンロード値のキャッシュの場所を指定します。引数として空の文字列を指定すると、キャッシュの無効化がリクエストされます。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます
タグ: bazel_internal_configuration
--[no]repository_disable_download のデフォルト: "false"
設定した場合、リポジトリの取得中に gke.download{,_and_extract} を使用したダウンロードは許可されません。ネットワーク アクセスは完全には無効にはなりません。インターネットにアクセスする任意の実行可能ファイルを gsuite.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, refresh or error> のデフォルト: "update"
ロックファイルの使用方法と使用方法を指定します。有効な値は、ロックファイルを使用して変更があった場合に更新する「update」、リモート レジストリから変更可能な情報(ヤンクされたバージョンや以前に欠落したモジュール)を随時更新する「refresh」、ロックファイルを使用するが最新でない場合にエラーをスローする「error」、ロックファイルの読み取り / 書き込みを行わない場合は「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
--vendor_dir=<a path> のデフォルト: 説明を参照
外部リポジトリをベンダーモードで保持するディレクトリを指定します。これは、外部リポジトリを取得する目的で、またはビルド中に外部リポジトリを使用するためです。パスは、絶対パスまたはワークスペース ディレクトリへの相対パスで指定できます。
タグ: loading_and_analysis
ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> のデフォルト: "1s:2,20s:3,1m:5"
上限に達すると、GcThrashingDetector が OOM を持つ Bazel をクラッシュさせます。各制限は、<period>:<count> として指定します。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 エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、GC イベントが完全に終了したときに不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、完全な GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、GC イベントが完全に発生し、保持されているヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> のデフォルト: 「2147483647」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、マイナー GC イベントの発生時に不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、マイナー GC イベントが発生して保持ヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer> のデフォルト: 「85」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率がこのしきい値以上であることを検出した場合、不要な一時的な Skyframe 状態を破棄します。これを微調整すると、GC スラッシングが(i)この一時的な状態のメモリ使用量に起因しており、(ii)必要に応じて状態を再構築するよりもコストが高い場合に、GC スラッシングの経過時間への影響を軽減できます。
タグ: host_machine_resource_optimizations
ロギングの詳細度、形式、場所に影響するオプション:
--experimental_command_profile=<cpu, wall, alloc or lock> のデフォルト: 説明を参照
コマンドの実行中に Java フライト レコーダーのプロファイルを記録します。サポートされているプロファイリング イベントタイプ(cpu、wall、alloc、lock)のいずれかを引数として指定する必要があります。プロファイルは、出力ベース ディレクトリの下のイベントタイプに基づいて名前が付けられたファイルに書き込まれます。このフラグの構文とセマンティクスは、他のプロファイル タイプや出力形式をサポートするため今後変更される可能性があります。このフラグは自己責任で使用してください。
--[no]experimental_record_metrics_for_all_mnemonics のデフォルト: "false"
デフォルトでは、アクション タイプの数は、実行されたアクションが最も多い 20 個のニーモニックに制限されています。このオプションを設定すると、すべてのニーモニックの統計情報が書き込まれます。
--help_verbosity=<long, medium or short> のデフォルト: "medium"
help コマンドの詳細度を選択します。
タグ: affects_outputsterminal_output
--long [-l]
名前だけでなく、各オプションの詳細な説明を表示する。
展開先:
  --help_verbosity=long

タグ: affects_outputsterminal_output
--short
オプションの名前のみを表示し、型や意味は表示しない。
展開先:
  --help_verbosity=short

タグ: affects_outputsterminal_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` から始まります。同じ URL に対して複数の rewrite ディレクティブが返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto> のデフォルト: "auto"
リポジトリのフェッチに使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得は再起動の対象となります。それ以外の場合は、仮想ワーカー スレッドを使用します。
その他のカテゴリに該当しないその他のオプション:
--override_repository=<an equals-separated mapping of repository name to path> 回の使用が累積されています
リポジトリは、<リポジトリ名>=<パス> 形式のローカルパスでオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。指定したパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定したパスが「%workspace%」で始まる場合は、「bazel info workspace」の出力であるワークスペースのルートからの相対パスになります。

情報オプション

build からすべてのオプションを継承します。

コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path> 回の使用が累積されています
ネットワークにアクセスしてダウンロードする前にアーカイブを検索する場所の追加。
タグ: bazel_internal_configuration
設定すると、キャッシュ ヒットが発生した場合、リポジトリ キャッシュはファイルをコピーするのではなくハードリンクします。これはディスク容量を節約するためのものです。
タグ: bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer> のデフォルト: 「0」
ダウンロード エラーの再試行の最大試行回数。0 に設定すると、再試行が無効になります。
タグ: experimental
--experimental_scale_timeouts=<a double> のデフォルト: 「1.0」
Starlark リポジトリ ルールのすべてのタイムアウトを、この係数でスケーリングします。このようにして、ソースコードを変更することなく、ルール作成者の想定よりも遅いマシンで外部リポジトリを動作させることができます。
タグ: bazel_internal_configurationexperimental
--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
--[no]incompatible_disable_native_repo_rules のデフォルト: "false"
false の場合、ネイティブ リポジトリ ルールを WORKSPACE で使用できます。それ以外の場合は、代わりに Starlark リポジトリ ルールを使用する必要があります。ネイティブ リポジトリのルールには、local_repository、new_local_repository、local_config_platform、android_sdk_repository、android_ndk_repository があります。
タグ: bazel_internal_configuration
--repository_cache=<a path> のデフォルト: 説明を参照
外部リポジトリの取得中に取得されたダウンロード値のキャッシュの場所を指定します。引数として空の文字列を指定すると、キャッシュの無効化がリクエストされます。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます
タグ: bazel_internal_configuration
--[no]repository_disable_download のデフォルト: "false"
設定した場合、リポジトリの取得中に gke.download{,_and_extract} を使用したダウンロードは許可されません。ネットワーク アクセスは完全には無効にはなりません。インターネットにアクセスする任意の実行可能ファイルを gsuite.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, refresh or error> のデフォルト: "update"
ロックファイルの使用方法と使用方法を指定します。有効な値は、ロックファイルを使用して変更があった場合に更新する「update」、リモート レジストリから変更可能な情報(ヤンクされたバージョンや以前に欠落したモジュール)を随時更新する「refresh」、ロックファイルを使用するが最新でない場合にエラーをスローする「error」、ロックファイルの読み取り / 書き込みを行わない場合は「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
--vendor_dir=<a path> のデフォルト: 説明を参照
外部リポジトリをベンダーモードで保持するディレクトリを指定します。これは、外部リポジトリを取得する目的で、またはビルド中に外部リポジトリを使用するためです。パスは、絶対パスまたはワークスペース ディレクトリへの相対パスで指定できます。
タグ: loading_and_analysis
ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> のデフォルト: "1s:2,20s:3,1m:5"
上限に達すると、GcThrashingDetector が OOM を持つ Bazel をクラッシュさせます。各制限は、<period>:<count> として指定します。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 エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、GC イベントが完全に終了したときに不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、完全な GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、GC イベントが完全に発生し、保持されているヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> のデフォルト: 「2147483647」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、マイナー GC イベントの発生時に不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、マイナー GC イベントが発生して保持ヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer> のデフォルト: 「85」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率がこのしきい値以上であることを検出した場合、不要な一時的な Skyframe 状態を破棄します。これを微調整すると、GC スラッシングが(i)この一時的な状態のメモリ使用量に起因しており、(ii)必要に応じて状態を再構築するよりもコストが高い場合に、GC スラッシングの経過時間への影響を軽減できます。
タグ: host_machine_resource_optimizations
ロギングの詳細度、形式、場所に影響するオプション:
--experimental_command_profile=<cpu, wall, alloc or lock> のデフォルト: 説明を参照
コマンドの実行中に Java フライト レコーダーのプロファイルを記録します。サポートされているプロファイリング イベントタイプ(cpu、wall、alloc、lock)のいずれかを引数として指定する必要があります。プロファイルは、出力ベース ディレクトリの下のイベントタイプに基づいて名前が付けられたファイルに書き込まれます。このフラグの構文とセマンティクスは、他のプロファイル タイプや出力形式をサポートするため今後変更される可能性があります。このフラグは自己責任で使用してください。
--[no]experimental_record_metrics_for_all_mnemonics のデフォルト: "false"
デフォルトでは、アクション タイプの数は、実行されたアクションが最も多い 20 個のニーモニックに制限されています。このオプションを設定すると、すべてのニーモニックの統計情報が書き込まれます。
--[no]show_make_env のデフォルト: "false"
出力に「Make」環境を含めます。
タグ: affects_outputsterminal_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` から始まります。同じ URL に対して複数の rewrite ディレクティブが返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto> のデフォルト: "auto"
リポジトリのフェッチに使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得は再起動の対象となります。それ以外の場合は、仮想ワーカー スレッドを使用します。
その他のカテゴリに該当しないその他のオプション:
--override_repository=<an equals-separated mapping of repository name to path> 回の使用が累積されています
リポジトリは、<リポジトリ名>=<パス> 形式のローカルパスでオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。指定したパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定したパスが「%workspace%」で始まる場合は、「bazel info workspace」の出力であるワークスペースのルートからの相対パスになります。

ライセンス オプション

コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path> 回の使用が累積されています
ネットワークにアクセスしてダウンロードする前にアーカイブを検索する場所の追加。
タグ: bazel_internal_configuration
設定すると、キャッシュ ヒットが発生した場合、リポジトリ キャッシュはファイルをコピーするのではなくハードリンクします。これはディスク容量を節約するためのものです。
タグ: bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer> のデフォルト: 「0」
ダウンロード エラーの再試行の最大試行回数。0 に設定すると、再試行が無効になります。
タグ: experimental
--experimental_scale_timeouts=<a double> のデフォルト: 「1.0」
Starlark リポジトリ ルールのすべてのタイムアウトを、この係数でスケーリングします。このようにして、ソースコードを変更することなく、ルール作成者の想定よりも遅いマシンで外部リポジトリを動作させることができます。
タグ: bazel_internal_configurationexperimental
--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
--[no]incompatible_disable_native_repo_rules のデフォルト: "false"
false の場合、ネイティブ リポジトリ ルールを WORKSPACE で使用できます。それ以外の場合は、代わりに Starlark リポジトリ ルールを使用する必要があります。ネイティブ リポジトリのルールには、local_repository、new_local_repository、local_config_platform、android_sdk_repository、android_ndk_repository があります。
タグ: bazel_internal_configuration
--repository_cache=<a path> のデフォルト: 説明を参照
外部リポジトリの取得中に取得されたダウンロード値のキャッシュの場所を指定します。引数として空の文字列を指定すると、キャッシュの無効化がリクエストされます。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます
タグ: bazel_internal_configuration
--[no]repository_disable_download のデフォルト: "false"
設定した場合、リポジトリの取得中に gke.download{,_and_extract} を使用したダウンロードは許可されません。ネットワーク アクセスは完全には無効にはなりません。インターネットにアクセスする任意の実行可能ファイルを gsuite.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, refresh or error> のデフォルト: "update"
ロックファイルの使用方法と使用方法を指定します。有効な値は、ロックファイルを使用して変更があった場合に更新する「update」、リモート レジストリから変更可能な情報(ヤンクされたバージョンや以前に欠落したモジュール)を随時更新する「refresh」、ロックファイルを使用するが最新でない場合にエラーをスローする「error」、ロックファイルの読み取り / 書き込みを行わない場合は「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
--vendor_dir=<a path> のデフォルト: 説明を参照
外部リポジトリをベンダーモードで保持するディレクトリを指定します。これは、外部リポジトリを取得する目的で、またはビルド中に外部リポジトリを使用するためです。パスは、絶対パスまたはワークスペース ディレクトリへの相対パスで指定できます。
タグ: loading_and_analysis
ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> のデフォルト: "1s:2,20s:3,1m:5"
上限に達すると、GcThrashingDetector が OOM を持つ Bazel をクラッシュさせます。各制限は、<period>:<count> として指定します。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 エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、GC イベントが完全に終了したときに不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、完全な GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、GC イベントが完全に発生し、保持されているヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> のデフォルト: 「2147483647」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、マイナー GC イベントの発生時に不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、マイナー GC イベントが発生して保持ヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer> のデフォルト: 「85」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率がこのしきい値以上であることを検出した場合、不要な一時的な Skyframe 状態を破棄します。これを微調整すると、GC スラッシングが(i)この一時的な状態のメモリ使用量に起因しており、(ii)必要に応じて状態を再構築するよりもコストが高い場合に、GC スラッシングの経過時間への影響を軽減できます。
タグ: host_machine_resource_optimizations
ロギングの詳細度、形式、場所に影響するオプション:
--experimental_command_profile=<cpu, wall, alloc or lock> のデフォルト: 説明を参照
コマンドの実行中に Java フライト レコーダーのプロファイルを記録します。サポートされているプロファイリング イベントタイプ(cpu、wall、alloc、lock)のいずれかを引数として指定する必要があります。プロファイルは、出力ベース ディレクトリの下のイベントタイプに基づいて名前が付けられたファイルに書き込まれます。このフラグの構文とセマンティクスは、他のプロファイル タイプや出力形式をサポートするため今後変更される可能性があります。このフラグは自己責任で使用してください。
--[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` から始まります。同じ URL に対して複数の rewrite ディレクティブが返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto> のデフォルト: "auto"
リポジトリのフェッチに使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得は再起動の対象となります。それ以外の場合は、仮想ワーカー スレッドを使用します。
その他のカテゴリに該当しないその他のオプション:
--override_repository=<an equals-separated mapping of repository name to path> 回の使用が累積されています
リポジトリは、<リポジトリ名>=<パス> 形式のローカルパスでオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。指定したパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定したパスが「%workspace%」で始まる場合は、「bazel info workspace」の出力であるワークスペースのルートからの相対パスになります。

モバイル インストール オプション

build からすべてのオプションを継承します。

コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path> 回の使用が累積されています
ネットワークにアクセスしてダウンロードする前にアーカイブを検索する場所の追加。
タグ: bazel_internal_configuration
設定すると、キャッシュ ヒットが発生した場合、リポジトリ キャッシュはファイルをコピーするのではなくハードリンクします。これはディスク容量を節約するためのものです。
タグ: bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer> のデフォルト: 「0」
ダウンロード エラーの再試行の最大試行回数。0 に設定すると、再試行が無効になります。
タグ: experimental
--experimental_scale_timeouts=<a double> のデフォルト: 「1.0」
Starlark リポジトリ ルールのすべてのタイムアウトを、この係数でスケーリングします。このようにして、ソースコードを変更することなく、ルール作成者の想定よりも遅いマシンで外部リポジトリを動作させることができます。
タグ: bazel_internal_configurationexperimental
--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
--[no]incompatible_disable_native_repo_rules のデフォルト: "false"
false の場合、ネイティブ リポジトリ ルールを WORKSPACE で使用できます。それ以外の場合は、代わりに Starlark リポジトリ ルールを使用する必要があります。ネイティブ リポジトリのルールには、local_repository、new_local_repository、local_config_platform、android_sdk_repository、android_ndk_repository があります。
タグ: bazel_internal_configuration
--repository_cache=<a path> のデフォルト: 説明を参照
外部リポジトリの取得中に取得されたダウンロード値のキャッシュの場所を指定します。引数として空の文字列を指定すると、キャッシュの無効化がリクエストされます。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます
タグ: bazel_internal_configuration
--[no]repository_disable_download のデフォルト: "false"
設定した場合、リポジトリの取得中に gke.download{,_and_extract} を使用したダウンロードは許可されません。ネットワーク アクセスは完全には無効にはなりません。インターネットにアクセスする任意の実行可能ファイルを gsuite.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_analysisexecutionincompatible_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_analysisaffects_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, refresh or error> のデフォルト: "update"
ロックファイルの使用方法と使用方法を指定します。有効な値は、ロックファイルを使用して変更があった場合に更新する「update」、リモート レジストリから変更可能な情報(ヤンクされたバージョンや以前に欠落したモジュール)を随時更新する「refresh」、ロックファイルを使用するが最新でない場合にエラーをスローする「error」、ロックファイルの読み取り / 書き込みを行わない場合は「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
--vendor_dir=<a path> のデフォルト: 説明を参照
外部リポジトリをベンダーモードで保持するディレクトリを指定します。これは、外部リポジトリを取得する目的で、またはビルド中に外部リポジトリを使用するためです。パスは、絶対パスまたはワークスペース ディレクトリへの相対パスで指定できます。
タグ: loading_and_analysis
ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> のデフォルト: "1s:2,20s:3,1m:5"
上限に達すると、GcThrashingDetector が OOM を持つ Bazel をクラッシュさせます。各制限は、<period>:<count> として指定します。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 エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、GC イベントが完全に終了したときに不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、完全な GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、GC イベントが完全に発生し、保持されているヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> のデフォルト: 「2147483647」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、マイナー GC イベントの発生時に不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、マイナー GC イベントが発生して保持ヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer> のデフォルト: 「85」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率がこのしきい値以上であることを検出した場合、不要な一時的な Skyframe 状態を破棄します。これを微調整すると、GC スラッシングが(i)この一時的な状態のメモリ使用量に起因しており、(ii)必要に応じて状態を再構築するよりもコストが高い場合に、GC スラッシングの経過時間への影響を軽減できます。
タグ: host_machine_resource_optimizations
ロギングの詳細度、形式、場所に影響するオプション:
--experimental_command_profile=<cpu, wall, alloc or lock> のデフォルト: 説明を参照
コマンドの実行中に Java フライト レコーダーのプロファイルを記録します。サポートされているプロファイリング イベントタイプ(cpu、wall、alloc、lock)のいずれかを引数として指定する必要があります。プロファイルは、出力ベース ディレクトリの下のイベントタイプに基づいて名前が付けられたファイルに書き込まれます。このフラグの構文とセマンティクスは、他のプロファイル タイプや出力形式をサポートするため今後変更される可能性があります。このフラグは自己責任で使用してください。
--[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` から始まります。同じ URL に対して複数の rewrite ディレクティブが返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto> のデフォルト: "auto"
リポジトリのフェッチに使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得は再起動の対象となります。それ以外の場合は、仮想ワーカー スレッドを使用します。
その他のカテゴリに該当しないその他のオプション:
--override_repository=<an equals-separated mapping of repository name to path> 回の使用が累積されています
リポジトリは、<リポジトリ名>=<パス> 形式のローカルパスでオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。指定したパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定したパスが「%workspace%」で始まる場合は、「bazel info workspace」の出力であるワークスペースのルートからの相対パスになります。

MOD オプション

コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path> 回の使用が累積されています
ネットワークにアクセスしてダウンロードする前にアーカイブを検索する場所の追加。
タグ: bazel_internal_configuration
設定すると、キャッシュ ヒットが発生した場合、リポジトリ キャッシュはファイルをコピーするのではなくハードリンクします。これはディスク容量を節約するためのものです。
タグ: bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer> のデフォルト: 「0」
ダウンロード エラーの再試行の最大試行回数。0 に設定すると、再試行が無効になります。
タグ: experimental
--experimental_scale_timeouts=<a double> のデフォルト: 「1.0」
Starlark リポジトリ ルールのすべてのタイムアウトを、この係数でスケーリングします。このようにして、ソースコードを変更することなく、ルール作成者の想定よりも遅いマシンで外部リポジトリを動作させることができます。
タグ: bazel_internal_configurationexperimental
--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
--[no]incompatible_disable_native_repo_rules のデフォルト: "false"
false の場合、ネイティブ リポジトリ ルールを WORKSPACE で使用できます。それ以外の場合は、代わりに Starlark リポジトリ ルールを使用する必要があります。ネイティブ リポジトリのルールには、local_repository、new_local_repository、local_config_platform、android_sdk_repository、android_ndk_repository があります。
タグ: bazel_internal_configuration
--repository_cache=<a path> のデフォルト: 説明を参照
外部リポジトリの取得中に取得されたダウンロード値のキャッシュの場所を指定します。引数として空の文字列を指定すると、キャッシュの無効化がリクエストされます。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます
タグ: bazel_internal_configuration
--[no]repository_disable_download のデフォルト: "false"
設定した場合、リポジトリの取得中に gke.download{,_and_extract} を使用したダウンロードは許可されません。ネットワーク アクセスは完全には無効にはなりません。インターネットにアクセスする任意の実行可能ファイルを gsuite.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] デフォルト: "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 言語またはビルド API のセマンティクスに影響します。
--[no]incompatible_config_setting_private_default_visibility のデフォルト: "false"
Compatibility_enforce_config_setting_visibility=false は、NoOps です。それ以外の場合、このフラグが false の場合、明示的な公開設定属性のない config_setting はすべて //visibility:public です。このフラグが true の場合、config_setting は他のすべてのルールと同じ公開設定ロジックに従います。https://github.com/bazelbuild/bazel/issues/12933 をご覧ください。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_enforce_config_setting_visibility のデフォルト: "true"
true の場合、config_setting の公開設定制限を適用します。false の場合、すべての config_setting がすべてのターゲットに表示されます。https://github.com/bazelbuild/bazel/issues/12932 をご覧ください。
タグ: loading_and_analysisincompatible_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 と説明のデフォルトは 1 です(ターゲットのリーフとその親以外のルートの直接依存関係のみが表示されます)。
タグ: terminal_output
--extension_filter=<a comma-separated list of <extension>s> のデフォルト: 説明を参照
これらのモジュール拡張機能の用途と、それらの拡張機能によって生成されたリポジトリ(それぞれのフラグが設定されている場合)のみを表示します。設定すると、指定した拡張機能を使用するモジュールを含むパスのみが結果のグラフに含まれます。空のリストを使用するとフィルタが無効になり、有効なすべての拡張機能が実質的に指定されます。
タグ: terminal_output
--extension_info=<hidden, usages, repos or all> のデフォルト: 「hidden」
クエリ結果に含める拡張機能の使用状況の詳細を指定します。「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 コマンドに新しいパスを含めたり、describe コマンドに追加の依存関係を指定したりするなど、クエリタイプごとに異なる影響を及ぼす可能性があります。
タグ: terminal_output
--output=<text, json or graph> のデフォルト: "text"
クエリ結果を出力する形式。クエリに使用できる値は、text、json、 graph です。
タグ: 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, refresh or error> のデフォルト: "update"
ロックファイルの使用方法と使用方法を指定します。有効な値は、ロックファイルを使用して変更があった場合に更新する「update」、リモート レジストリから変更可能な情報(ヤンクされたバージョンや以前に欠落したモジュール)を随時更新する「refresh」、ロックファイルを使用するが最新でない場合にエラーをスローする「error」、ロックファイルの読み取り / 書き込みを行わない場合は「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
--vendor_dir=<a path> のデフォルト: 説明を参照
外部リポジトリをベンダーモードで保持するディレクトリを指定します。これは、外部リポジトリを取得する目的で、またはビルド中に外部リポジトリを使用するためです。パスは、絶対パスまたはワークスペース ディレクトリへの相対パスで指定できます。
タグ: loading_and_analysis
ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> のデフォルト: "1s:2,20s:3,1m:5"
上限に達すると、GcThrashingDetector が OOM を持つ Bazel をクラッシュさせます。各制限は、<period>:<count> として指定します。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 エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、GC イベントが完全に終了したときに不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、完全な GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、GC イベントが完全に発生し、保持されているヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> のデフォルト: 「2147483647」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、マイナー GC イベントの発生時に不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、マイナー GC イベントが発生して保持ヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer> のデフォルト: 「85」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率がこのしきい値以上であることを検出した場合、不要な一時的な Skyframe 状態を破棄します。これを微調整すると、GC スラッシングが(i)この一時的な状態のメモリ使用量に起因しており、(ii)必要に応じて状態を再構築するよりもコストが高い場合に、GC スラッシングの経過時間への影響を軽減できます。
タグ: host_machine_resource_optimizations
ロギングの詳細度、形式、場所に影響するオプション:
--experimental_command_profile=<cpu, wall, alloc or lock> のデフォルト: 説明を参照
コマンドの実行中に Java フライト レコーダーのプロファイルを記録します。サポートされているプロファイリング イベントタイプ(cpu、wall、alloc、lock)のいずれかを引数として指定する必要があります。プロファイルは、出力ベース ディレクトリの下のイベントタイプに基づいて名前が付けられたファイルに書き込まれます。このフラグの構文とセマンティクスは、他のプロファイル タイプや出力形式をサポートするため今後変更される可能性があります。このフラグは自己責任で使用してください。
--[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` から始まります。同じ URL に対して複数の rewrite ディレクティブが返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto> のデフォルト: "auto"
リポジトリのフェッチに使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得は再起動の対象となります。それ以外の場合は、仮想ワーカー スレッドを使用します。
その他のカテゴリに該当しないその他のオプション:
--deleted_packages=<comma-separated list of package names> 回の使用が累積されています
パッケージパスのどこかに表示されている場合でも、ビルドシステムが存在しないと見なすパッケージ名のカンマ区切りリスト。 このオプションは、既存のパッケージ「x」のサブパッケージ「x/y」を削除する場合に使用します。たとえば、クライアントで x/y/BUILD を削除した後でも、別の package_path エントリで指定されていれば、ビルドシステムで「//x:y/z」というラベルが検出されるとエラーが表示されることがあります。--deleted_packages x/y を指定すると、この問題を回避できます。
--[no]fetch のデフォルト: "true"
コマンドが外部依存関係を取得できるようにします。false に設定すると、依存関係のキャッシュ バージョンが使用されます。依存関係が存在しない場合は、コマンドが失敗します。
--override_repository=<an equals-separated mapping of repository name to 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
設定すると、キャッシュ ヒットが発生した場合、リポジトリ キャッシュはファイルをコピーするのではなくハードリンクします。これはディスク容量を節約するためのものです。
タグ: bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer> のデフォルト: 「0」
ダウンロード エラーの再試行の最大試行回数。0 に設定すると、再試行が無効になります。
タグ: experimental
--experimental_scale_timeouts=<a double> のデフォルト: 「1.0」
Starlark リポジトリ ルールのすべてのタイムアウトを、この係数でスケーリングします。このようにして、ソースコードを変更することなく、ルール作成者の想定よりも遅いマシンで外部リポジトリを動作させることができます。
タグ: bazel_internal_configurationexperimental
--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
--[no]incompatible_disable_native_repo_rules のデフォルト: "false"
false の場合、ネイティブ リポジトリ ルールを WORKSPACE で使用できます。それ以外の場合は、代わりに Starlark リポジトリ ルールを使用する必要があります。ネイティブ リポジトリのルールには、local_repository、new_local_repository、local_config_platform、android_sdk_repository、android_ndk_repository があります。
タグ: bazel_internal_configuration
--repository_cache=<a path> のデフォルト: 説明を参照
外部リポジトリの取得中に取得されたダウンロード値のキャッシュの場所を指定します。引数として空の文字列を指定すると、キャッシュの無効化がリクエストされます。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます
タグ: bazel_internal_configuration
--[no]repository_disable_download のデフォルト: "false"
設定した場合、リポジトリの取得中に gke.download{,_and_extract} を使用したダウンロードは許可されません。ネットワーク アクセスは完全には無効にはなりません。インターネットにアクセスする任意の実行可能ファイルを gsuite.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, refresh or error> のデフォルト: "update"
ロックファイルの使用方法と使用方法を指定します。有効な値は、ロックファイルを使用して変更があった場合に更新する「update」、リモート レジストリから変更可能な情報(ヤンクされたバージョンや以前に欠落したモジュール)を随時更新する「refresh」、ロックファイルを使用するが最新でない場合にエラーをスローする「error」、ロックファイルの読み取り / 書き込みを行わない場合は「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
--vendor_dir=<a path> のデフォルト: 説明を参照
外部リポジトリをベンダーモードで保持するディレクトリを指定します。これは、外部リポジトリを取得する目的で、またはビルド中に外部リポジトリを使用するためです。パスは、絶対パスまたはワークスペース ディレクトリへの相対パスで指定できます。
タグ: loading_and_analysis
ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> のデフォルト: "1s:2,20s:3,1m:5"
上限に達すると、GcThrashingDetector が OOM を持つ Bazel をクラッシュさせます。各制限は、<period>:<count> として指定します。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 エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、GC イベントが完全に終了したときに不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、完全な GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、GC イベントが完全に発生し、保持されているヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> のデフォルト: 「2147483647」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、マイナー GC イベントの発生時に不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、マイナー GC イベントが発生して保持ヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer> のデフォルト: 「85」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率がこのしきい値以上であることを検出した場合、不要な一時的な Skyframe 状態を破棄します。これを微調整すると、GC スラッシングが(i)この一時的な状態のメモリ使用量に起因しており、(ii)必要に応じて状態を再構築するよりもコストが高い場合に、GC スラッシングの経過時間への影響を軽減できます。
タグ: host_machine_resource_optimizations
ロギングの詳細度、形式、場所に影響するオプション:
--experimental_command_profile=<cpu, wall, alloc or lock> のデフォルト: 説明を参照
コマンドの実行中に Java フライト レコーダーのプロファイルを記録します。サポートされているプロファイリング イベントタイプ(cpu、wall、alloc、lock)のいずれかを引数として指定する必要があります。プロファイルは、出力ベース ディレクトリの下のイベントタイプに基づいて名前が付けられたファイルに書き込まれます。このフラグの構文とセマンティクスは、他のプロファイル タイプや出力形式をサポートするため今後変更される可能性があります。このフラグは自己責任で使用してください。
--[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` から始まります。同じ URL に対して複数の rewrite ディレクティブが返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto> のデフォルト: "auto"
リポジトリのフェッチに使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得は再起動の対象となります。それ以外の場合は、仮想ワーカー スレッドを使用します。
その他のカテゴリに該当しないその他のオプション:
--override_repository=<an equals-separated mapping of repository name to path> 回の使用が累積されています
リポジトリは、<リポジトリ名>=<パス> 形式のローカルパスでオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。指定したパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定したパスが「%workspace%」で始まる場合は、「bazel info workspace」の出力であるワークスペースのルートからの相対パスとなります。
--print_action_mnemonics=<a string> 回の使用が累積されています
print_action データをフィルタするためのニモニックを一覧表示します。空のままにすると、フィルタリングは行われません。

クエリ オプション

コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path> 回の使用が累積されています
ネットワークにアクセスしてダウンロードする前にアーカイブを検索する場所の追加。
タグ: bazel_internal_configuration
設定すると、キャッシュ ヒットが発生した場合、リポジトリ キャッシュはファイルをコピーするのではなくハードリンクします。これはディスク容量を節約するためのものです。
タグ: bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer> のデフォルト: 「0」
ダウンロード エラーの再試行の最大試行回数。0 に設定すると、再試行が無効になります。
タグ: experimental
--experimental_scale_timeouts=<a double> のデフォルト: 「1.0」
Starlark リポジトリ ルールのすべてのタイムアウトを、この係数でスケーリングします。このようにして、ソースコードを変更することなく、ルール作成者の想定よりも遅いマシンで外部リポジトリを動作させることができます。
タグ: bazel_internal_configurationexperimental
--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
--[no]incompatible_disable_native_repo_rules のデフォルト: "false"
false の場合、ネイティブ リポジトリ ルールを WORKSPACE で使用できます。それ以外の場合は、代わりに Starlark リポジトリ ルールを使用する必要があります。ネイティブ リポジトリのルールには、local_repository、new_local_repository、local_config_platform、android_sdk_repository、android_ndk_repository があります。
タグ: bazel_internal_configuration
--repository_cache=<a path> のデフォルト: 説明を参照
外部リポジトリの取得中に取得されたダウンロード値のキャッシュの場所を指定します。引数として空の文字列を指定すると、キャッシュの無効化がリクエストされます。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます
タグ: bazel_internal_configuration
--[no]repository_disable_download のデフォルト: "false"
設定した場合、リポジトリの取得中に gke.download{,_and_extract} を使用したダウンロードは許可されません。ネットワーク アクセスは完全には無効にはなりません。インターネットにアクセスする任意の実行可能ファイルを gsuite.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] デフォルト: "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 言語またはビルド API のセマンティクスに影響します。
--[no]incompatible_config_setting_private_default_visibility のデフォルト: "false"
Compatibility_enforce_config_setting_visibility=false は、NoOps です。それ以外の場合、このフラグが false の場合、明示的な公開設定属性のない config_setting はすべて //visibility:public です。このフラグが true の場合、config_setting は他のすべてのルールと同じ公開設定ロジックに従います。https://github.com/bazelbuild/bazel/issues/12933 をご覧ください。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_enforce_config_setting_visibility のデフォルト: "true"
true の場合、config_setting の公開設定制限を適用します。false の場合、すべての config_setting がすべてのターゲットに表示されます。https://github.com/bazelbuild/bazel/issues/12932 をご覧ください。
タグ: loading_and_analysisincompatible_change
クエリの出力とセマンティクスに関連するオプション:
--aspect_deps=<off, conservative or precise> のデフォルト: 「conservative」
出力形式が {xml,proto,record} のいずれかである場合に、アスペクトの依存関係を解決する方法。「off」はアスペクト依存関係が解決されないことを意味します。「conservative」(デフォルト)は、直接依存関係のルールクラスが指定されているかどうかに関係なく、宣言されたすべてのアスペクト依存関係が追加されることを意味します。「precise」は、直接依存関係のルールクラスでアクティブになる可能性のあるアスペクトのみが追加されることを意味します。なお、高精度モードでは、1 つのターゲットを評価するために他のパッケージを読み込む必要があるため、他のモードよりも時間がかかります。また、正確なモードでさえも完全に正確というわけではありません。アスペクトを計算するかどうかの決定は、分析フェーズで決定され、「Bazel クエリ」中には実行されません。
タグ: build_file_semantics
--[no]consistent_labels のデフォルト: "false"
有効にすると、すべてのクエリコマンドは <code>Label</code> インスタンスに適用される Starlark <code>str</code> 関数と同様にラベルを出力します。これは、さまざまなクエリコマンドやルールによって出力されたラベルの出力を照合する必要があるツールに役立ちます。有効になっていない場合、出力フォーマッタは、出力を読みやすくするために(メイン リポジトリからの相対的な)明らかなリポジトリ名を自由に出力できます。
タグ: terminal_output
--[no]experimental_explicit_aspects のデフォルト: "false"
aquery, cquery: アスペクトで生成されたアクションを出力に含めるかどうかクエリ: no-op(アスペクトは常に従う)
タグ: terminal_output
--[no]experimental_graphless_query のデフォルト: "auto"
true の場合、グラフのコピーを作成しないクエリ実装を使用します。新しい実装では、--order_output=no のみと、出力フォーマッタのサブセットのみがサポートされます。
タグ: build_file_semanticseagerness_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: アスペクトで生成されたアクションを出力に含めるかどうかクエリ: no-op(アスペクトは常に従う)
タグ: terminal_output
--[no]incompatible_lexicographical_output のデフォルト: "true"
このオプションを設定すると、--order_output=auto の出力が辞書順に並べ替えられます。
タグ: terminal_outputincompatible_change
--[no]incompatible_package_group_includes_double_slash のデフォルト: "true"
有効にすると、package_group の `packages` 属性を出力するときに、先頭の `//` が省略されません。
タグ: terminal_outputincompatible_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)、または完全順序(完全)の結果を出力します。デフォルトは「auto」です。つまり、結果は出力フォーマッタ(proto、minrank、maxrank、グラフでは依存関係順、それ以外は完全に順序付け)に応じて、依存関係順または完全順序のいずれかで出力されます。出力が完全に順序付けられている場合、ノードは完全に決定論的な(合計)順序で出力されます。まず、すべてのノードがアルファベット順に並べ替えられます。その後、リスト内の各ノードは、アクセスされていないノードへの送信エッジが後続ノードのアルファベット順に走査される、後順深度優先探索の開始として使用されます。最後に、ノードはアクセスされた順序と逆方向に出力されます。
タグ: 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 の場合、値が明示的に指定されていない属性が含まれます。それ以外の場合は、省略されます。このオプションは --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> のデフォルト: ""
設定すると、query はコマンドラインではなく、ここで指定したファイルからクエリを読み取ります。ここにファイルとコマンドライン クエリを指定するとエラーになります。
タグ: changes_inputs
--[no]relative_locations のデフォルト: "false"
true の場合、xml 出力と proto 出力の BUILD ファイルの場所は相対的になります。デフォルトでは、ロケーションの出力は絶対パスであり、マシン間で一貫性はありません。このオプションを true に設定すると、すべてのマシンで一貫した結果が得られます。
タグ: terminal_output
--[no]strict_test_suite のデフォルト: "false"
true の場合、テスト以外のターゲットを含む test_suite が検出されると、tests() 式はエラーを返します。
タグ: build_file_semanticseagerness_to_exit
--[no]tool_deps のデフォルト: "true"
クエリ: 無効にすると、「exec configuration」への依存関係は、クエリが動作する依存関係グラフに含まれません。任意の「proto_library」ルールからプロトコル コンパイラへの依存関係エッジなど、「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, refresh or error> のデフォルト: "update"
ロックファイルの使用方法と使用方法を指定します。有効な値は、ロックファイルを使用して変更があった場合に更新する「update」、リモート レジストリから変更可能な情報(ヤンクされたバージョンや以前に欠落したモジュール)を随時更新する「refresh」、ロックファイルを使用するが最新でない場合にエラーをスローする「error」、ロックファイルの読み取り / 書き込みを行わない場合は「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
--vendor_dir=<a path> のデフォルト: 説明を参照
外部リポジトリをベンダーモードで保持するディレクトリを指定します。これは、外部リポジトリを取得する目的で、またはビルド中に外部リポジトリを使用するためです。パスは、絶対パスまたはワークスペース ディレクトリへの相対パスで指定できます。
タグ: loading_and_analysis
ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> のデフォルト: "1s:2,20s:3,1m:5"
上限に達すると、GcThrashingDetector が OOM を持つ Bazel をクラッシュさせます。各制限は、<period>:<count> として指定します。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 エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、GC イベントが完全に終了したときに不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、完全な GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、GC イベントが完全に発生し、保持されているヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> のデフォルト: 「2147483647」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、マイナー GC イベントの発生時に不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、マイナー GC イベントが発生して保持ヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer> のデフォルト: 「85」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率がこのしきい値以上であることを検出した場合、不要な一時的な Skyframe 状態を破棄します。これを微調整すると、GC スラッシングが(i)この一時的な状態のメモリ使用量に起因しており、(ii)必要に応じて状態を再構築するよりもコストが高い場合に、GC スラッシングの経過時間への影響を軽減できます。
タグ: host_machine_resource_optimizations
ロギングの詳細度、形式、場所に影響するオプション:
--experimental_command_profile=<cpu, wall, alloc or lock> のデフォルト: 説明を参照
コマンドの実行中に Java フライト レコーダーのプロファイルを記録します。サポートされているプロファイリング イベントタイプ(cpu、wall、alloc、lock)のいずれかを引数として指定する必要があります。プロファイルは、出力ベース ディレクトリの下のイベントタイプに基づいて名前が付けられたファイルに書き込まれます。このフラグの構文とセマンティクスは、他のプロファイル タイプや出力形式をサポートするため今後変更される可能性があります。このフラグは自己責任で使用してください。
--[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` から始まります。同じ URL に対して複数の rewrite ディレクティブが返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto> のデフォルト: "auto"
リポジトリのフェッチに使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得は再起動の対象となります。それ以外の場合は、仮想ワーカー スレッドを使用します。
その他のカテゴリに該当しないその他のオプション:
--deleted_packages=<comma-separated list of package names> 回の使用が累積されています
パッケージパスのどこかに表示されている場合でも、ビルドシステムが存在しないと見なすパッケージ名のカンマ区切りリスト。 このオプションは、既存のパッケージ「x」のサブパッケージ「x/y」を削除する場合に使用します。たとえば、クライアントで x/y/BUILD を削除した後でも、別の package_path エントリで指定されていれば、ビルドシステムで「//x:y/z」というラベルが検出されるとエラーが表示されることがあります。--deleted_packages x/y を指定すると、この問題を回避できます。
--[no]fetch のデフォルト: "true"
コマンドが外部依存関係を取得できるようにします。false に設定すると、依存関係のキャッシュ バージョンが使用されます。依存関係が存在しない場合は、コマンドが失敗します。
--override_repository=<an equals-separated mapping of repository name to 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
設定すると、キャッシュ ヒットが発生した場合、リポジトリ キャッシュはファイルをコピーするのではなくハードリンクします。これはディスク容量を節約するためのものです。
タグ: bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer> のデフォルト: 「0」
ダウンロード エラーの再試行の最大試行回数。0 に設定すると、再試行が無効になります。
タグ: experimental
--experimental_scale_timeouts=<a double> のデフォルト: 「1.0」
Starlark リポジトリ ルールのすべてのタイムアウトを、この係数でスケーリングします。このようにして、ソースコードを変更することなく、ルール作成者の想定よりも遅いマシンで外部リポジトリを動作させることができます。
タグ: bazel_internal_configurationexperimental
--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
--[no]incompatible_disable_native_repo_rules のデフォルト: "false"
false の場合、ネイティブ リポジトリ ルールを WORKSPACE で使用できます。それ以外の場合は、代わりに Starlark リポジトリ ルールを使用する必要があります。ネイティブ リポジトリのルールには、local_repository、new_local_repository、local_config_platform、android_sdk_repository、android_ndk_repository があります。
タグ: bazel_internal_configuration
--repository_cache=<a path> のデフォルト: 説明を参照
外部リポジトリの取得中に取得されたダウンロード値のキャッシュの場所を指定します。引数として空の文字列を指定すると、キャッシュの無効化がリクエストされます。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます
タグ: bazel_internal_configuration
--[no]repository_disable_download のデフォルト: "false"
設定した場合、リポジトリの取得中に gke.download{,_and_extract} を使用したダウンロードは許可されません。ネットワーク アクセスは完全には無効にはなりません。インターネットにアクセスする任意の実行可能ファイルを gsuite.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_outputsexecution
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, refresh or error> のデフォルト: "update"
ロックファイルの使用方法と使用方法を指定します。有効な値は、ロックファイルを使用して変更があった場合に更新する「update」、リモート レジストリから変更可能な情報(ヤンクされたバージョンや以前に欠落したモジュール)を随時更新する「refresh」、ロックファイルを使用するが最新でない場合にエラーをスローする「error」、ロックファイルの読み取り / 書き込みを行わない場合は「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
--vendor_dir=<a path> のデフォルト: 説明を参照
外部リポジトリをベンダーモードで保持するディレクトリを指定します。これは、外部リポジトリを取得する目的で、またはビルド中に外部リポジトリを使用するためです。パスは、絶対パスまたはワークスペース ディレクトリへの相対パスで指定できます。
タグ: loading_and_analysis
ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> のデフォルト: "1s:2,20s:3,1m:5"
上限に達すると、GcThrashingDetector が OOM を持つ Bazel をクラッシュさせます。各制限は、<period>:<count> として指定します。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 エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、GC イベントが完全に終了したときに不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、完全な GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、GC イベントが完全に発生し、保持されているヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> のデフォルト: 「2147483647」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、マイナー GC イベントの発生時に不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、マイナー GC イベントが発生して保持ヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer> のデフォルト: 「85」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率がこのしきい値以上であることを検出した場合、不要な一時的な Skyframe 状態を破棄します。これを微調整すると、GC スラッシングが(i)この一時的な状態のメモリ使用量に起因しており、(ii)必要に応じて状態を再構築するよりもコストが高い場合に、GC スラッシングの経過時間への影響を軽減できます。
タグ: host_machine_resource_optimizations
ロギングの詳細度、形式、場所に影響するオプション:
--experimental_command_profile=<cpu, wall, alloc or lock> のデフォルト: 説明を参照
コマンドの実行中に Java フライト レコーダーのプロファイルを記録します。サポートされているプロファイリング イベントタイプ(cpu、wall、alloc、lock)のいずれかを引数として指定する必要があります。プロファイルは、出力ベース ディレクトリの下のイベントタイプに基づいて名前が付けられたファイルに書き込まれます。このフラグの構文とセマンティクスは、他のプロファイル タイプや出力形式をサポートするため今後変更される可能性があります。このフラグは自己責任で使用してください。
--[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` から始まります。同じ URL に対して複数の rewrite ディレクティブが返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto> のデフォルト: "auto"
リポジトリのフェッチに使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得は再起動の対象となります。それ以外の場合は、仮想ワーカー スレッドを使用します。
その他のカテゴリに該当しないその他のオプション:
--override_repository=<an equals-separated mapping of repository name to path> 回の使用が累積されています
リポジトリは、<リポジトリ名>=<パス> 形式のローカルパスでオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。指定したパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定したパスが「%workspace%」で始まる場合は、「bazel info workspace」の出力であるワークスペースのルートからの相対パスになります。

シャットダウン オプション

コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path> 回の使用が累積されています
ネットワークにアクセスしてダウンロードする前にアーカイブを検索する場所の追加。
タグ: bazel_internal_configuration
設定すると、キャッシュ ヒットが発生した場合、リポジトリ キャッシュはファイルをコピーするのではなくハードリンクします。これはディスク容量を節約するためのものです。
タグ: bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer> のデフォルト: 「0」
ダウンロード エラーの再試行の最大試行回数。0 に設定すると、再試行が無効になります。
タグ: experimental
--experimental_scale_timeouts=<a double> のデフォルト: 「1.0」
Starlark リポジトリ ルールのすべてのタイムアウトを、この係数でスケーリングします。このようにして、ソースコードを変更することなく、ルール作成者の想定よりも遅いマシンで外部リポジトリを動作させることができます。
タグ: bazel_internal_configurationexperimental
--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
--[no]incompatible_disable_native_repo_rules のデフォルト: "false"
false の場合、ネイティブ リポジトリ ルールを WORKSPACE で使用できます。それ以外の場合は、代わりに Starlark リポジトリ ルールを使用する必要があります。ネイティブ リポジトリのルールには、local_repository、new_local_repository、local_config_platform、android_sdk_repository、android_ndk_repository があります。
タグ: bazel_internal_configuration
--repository_cache=<a path> のデフォルト: 説明を参照
外部リポジトリの取得中に取得されたダウンロード値のキャッシュの場所を指定します。引数として空の文字列を指定すると、キャッシュの無効化がリクエストされます。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます
タグ: bazel_internal_configuration
--[no]repository_disable_download のデフォルト: "false"
設定した場合、リポジトリの取得中に gke.download{,_and_extract} を使用したダウンロードは許可されません。ネットワーク アクセスは完全には無効にはなりません。インターネットにアクセスする任意の実行可能ファイルを gsuite.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」
0 以外の値の場合、JVM によって消費された合計メモリ(MB 単位)がこの値を超えた場合にのみ、shutdown によってサーバーがシャットダウンされます。
タグ: loses_incremental_stateeagerness_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, refresh or error> のデフォルト: "update"
ロックファイルの使用方法と使用方法を指定します。有効な値は、ロックファイルを使用して変更があった場合に更新する「update」、リモート レジストリから変更可能な情報(ヤンクされたバージョンや以前に欠落したモジュール)を随時更新する「refresh」、ロックファイルを使用するが最新でない場合にエラーをスローする「error」、ロックファイルの読み取り / 書き込みを行わない場合は「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
--vendor_dir=<a path> のデフォルト: 説明を参照
外部リポジトリをベンダーモードで保持するディレクトリを指定します。これは、外部リポジトリを取得する目的で、またはビルド中に外部リポジトリを使用するためです。パスは、絶対パスまたはワークスペース ディレクトリへの相対パスで指定できます。
タグ: loading_and_analysis
ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> のデフォルト: "1s:2,20s:3,1m:5"
上限に達すると、GcThrashingDetector が OOM を持つ Bazel をクラッシュさせます。各制限は、<period>:<count> として指定します。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 エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、GC イベントが完全に終了したときに不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、完全な GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、GC イベントが完全に発生し、保持されているヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> のデフォルト: 「2147483647」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、マイナー GC イベントの発生時に不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、マイナー GC イベントが発生して保持ヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer> のデフォルト: 「85」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率がこのしきい値以上であることを検出した場合、不要な一時的な Skyframe 状態を破棄します。これを微調整すると、GC スラッシングが(i)この一時的な状態のメモリ使用量に起因しており、(ii)必要に応じて状態を再構築するよりもコストが高い場合に、GC スラッシングの経過時間への影響を軽減できます。
タグ: host_machine_resource_optimizations
ロギングの詳細度、形式、場所に影響するオプション:
--experimental_command_profile=<cpu, wall, alloc or lock> のデフォルト: 説明を参照
コマンドの実行中に Java フライト レコーダーのプロファイルを記録します。サポートされているプロファイリング イベントタイプ(cpu、wall、alloc、lock)のいずれかを引数として指定する必要があります。プロファイルは、出力ベース ディレクトリの下のイベントタイプに基づいて名前が付けられたファイルに書き込まれます。このフラグの構文とセマンティクスは、他のプロファイル タイプや出力形式をサポートするため今後変更される可能性があります。このフラグは自己責任で使用してください。
--[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` から始まります。同じ URL に対して複数の rewrite ディレクティブが返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto> のデフォルト: "auto"
リポジトリのフェッチに使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得は再起動の対象となります。それ以外の場合は、仮想ワーカー スレッドを使用します。
その他のカテゴリに該当しないその他のオプション:
--override_repository=<an equals-separated mapping of repository name to path> 回の使用が累積されています
リポジトリは、<リポジトリ名>=<パス> 形式のローカルパスでオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。指定したパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定したパスが「%workspace%」で始まる場合は、「bazel info workspace」の出力であるワークスペースのルートからの相対パスになります。

同期オプション

コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path> 回の使用が累積されています
ネットワークにアクセスしてダウンロードする前にアーカイブを検索する場所の追加。
タグ: bazel_internal_configuration
設定すると、キャッシュ ヒットが発生した場合、リポジトリ キャッシュはファイルをコピーするのではなくハードリンクします。これはディスク容量を節約するためのものです。
タグ: bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer> のデフォルト: 「0」
ダウンロード エラーの再試行の最大試行回数。0 に設定すると、再試行が無効になります。
タグ: experimental
--experimental_scale_timeouts=<a double> のデフォルト: 「1.0」
Starlark リポジトリ ルールのすべてのタイムアウトを、この係数でスケーリングします。このようにして、ソースコードを変更することなく、ルール作成者の想定よりも遅いマシンで外部リポジトリを動作させることができます。
タグ: bazel_internal_configurationexperimental
--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
--[no]incompatible_disable_native_repo_rules のデフォルト: "false"
false の場合、ネイティブ リポジトリ ルールを WORKSPACE で使用できます。それ以外の場合は、代わりに Starlark リポジトリ ルールを使用する必要があります。ネイティブ リポジトリのルールには、local_repository、new_local_repository、local_config_platform、android_sdk_repository、android_ndk_repository があります。
タグ: bazel_internal_configuration
--repository_cache=<a path> のデフォルト: 説明を参照
外部リポジトリの取得中に取得されたダウンロード値のキャッシュの場所を指定します。引数として空の文字列を指定すると、キャッシュの無効化がリクエストされます。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます
タグ: bazel_internal_configuration
--[no]repository_disable_download のデフォルト: "false"
設定した場合、リポジトリの取得中に gke.download{,_and_extract} を使用したダウンロードは許可されません。ネットワーク アクセスは完全には無効にはなりません。インターネットにアクセスする任意の実行可能ファイルを gsuite.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] デフォルト: "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> 回の使用が累積されています
このオプションを指定すると、このオプションで指定されたリポジトリのみを同期します。それでも、すべて(またはすべての config-like の --configure が指定されている)は古いものであると考えてください。
タグ: changes_inputs
このオプションは、BUILD ファイル、.bzl ファイル、WORKSPACE ファイルからアクセス可能な Starlark 言語またはビルド API のセマンティクスに影響します。
--[no]incompatible_config_setting_private_default_visibility のデフォルト: "false"
Compatibility_enforce_config_setting_visibility=false は、NoOps です。それ以外の場合、このフラグが false の場合、明示的な公開設定属性のない config_setting はすべて //visibility:public です。このフラグが true の場合、config_setting は他のすべてのルールと同じ公開設定ロジックに従います。https://github.com/bazelbuild/bazel/issues/12933 をご覧ください。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_enforce_config_setting_visibility のデフォルト: "true"
true の場合、config_setting の公開設定制限を適用します。false の場合、すべての config_setting がすべてのターゲットに表示されます。https://github.com/bazelbuild/bazel/issues/12932 をご覧ください。
タグ: loading_and_analysisincompatible_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, refresh or error> のデフォルト: "update"
ロックファイルの使用方法と使用方法を指定します。有効な値は、ロックファイルを使用して変更があった場合に更新する「update」、リモート レジストリから変更可能な情報(ヤンクされたバージョンや以前に欠落したモジュール)を随時更新する「refresh」、ロックファイルを使用するが最新でない場合にエラーをスローする「error」、ロックファイルの読み取り / 書き込みを行わない場合は「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
--vendor_dir=<a path> のデフォルト: 説明を参照
外部リポジトリをベンダーモードで保持するディレクトリを指定します。これは、外部リポジトリを取得する目的で、またはビルド中に外部リポジトリを使用するためです。パスは、絶対パスまたはワークスペース ディレクトリへの相対パスで指定できます。
タグ: loading_and_analysis
ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> のデフォルト: "1s:2,20s:3,1m:5"
上限に達すると、GcThrashingDetector が OOM を持つ Bazel をクラッシュさせます。各制限は、<period>:<count> として指定します。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 エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、GC イベントが完全に終了したときに不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、完全な GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、GC イベントが完全に発生し、保持されているヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> のデフォルト: 「2147483647」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、マイナー GC イベントの発生時に不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、マイナー GC イベントが発生して保持ヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer> のデフォルト: 「85」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率がこのしきい値以上であることを検出した場合、不要な一時的な Skyframe 状態を破棄します。これを微調整すると、GC スラッシングが(i)この一時的な状態のメモリ使用量に起因しており、(ii)必要に応じて状態を再構築するよりもコストが高い場合に、GC スラッシングの経過時間への影響を軽減できます。
タグ: host_machine_resource_optimizations
ロギングの詳細度、形式、場所に影響するオプション:
--experimental_command_profile=<cpu, wall, alloc or lock> のデフォルト: 説明を参照
コマンドの実行中に Java フライト レコーダーのプロファイルを記録します。サポートされているプロファイリング イベントタイプ(cpu、wall、alloc、lock)のいずれかを引数として指定する必要があります。プロファイルは、出力ベース ディレクトリの下のイベントタイプに基づいて名前が付けられたファイルに書き込まれます。このフラグの構文とセマンティクスは、他のプロファイル タイプや出力形式をサポートするため今後変更される可能性があります。このフラグは自己責任で使用してください。
--[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` から始まります。同じ URL に対して複数の rewrite ディレクティブが返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto> のデフォルト: "auto"
リポジトリのフェッチに使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得は再起動の対象となります。それ以外の場合は、仮想ワーカー スレッドを使用します。
その他のカテゴリに該当しないその他のオプション:
--deleted_packages=<comma-separated list of package names> 回の使用が累積されています
パッケージパスのどこかに表示されている場合でも、ビルドシステムが存在しないと見なすパッケージ名のカンマ区切りリスト。 このオプションは、既存のパッケージ「x」のサブパッケージ「x/y」を削除する場合に使用します。たとえば、クライアントで x/y/BUILD を削除した後でも、別の package_path エントリで指定されていれば、ビルドシステムで「//x:y/z」というラベルが検出されるとエラーが表示されることがあります。--deleted_packages x/y を指定すると、この問題を回避できます。
--[no]fetch のデフォルト: "true"
コマンドが外部依存関係を取得できるようにします。false に設定すると、依存関係のキャッシュ バージョンが使用されます。依存関係が存在しない場合は、コマンドが失敗します。
--override_repository=<an equals-separated mapping of repository name to 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
設定すると、キャッシュ ヒットが発生した場合、リポジトリ キャッシュはファイルをコピーするのではなくハードリンクします。これはディスク容量を節約するためのものです。
タグ: bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer> のデフォルト: 「0」
ダウンロード エラーの再試行の最大試行回数。0 に設定すると、再試行が無効になります。
タグ: experimental
--experimental_scale_timeouts=<a double> のデフォルト: 「1.0」
Starlark リポジトリ ルールのすべてのタイムアウトを、この係数でスケーリングします。このようにして、ソースコードを変更することなく、ルール作成者の想定よりも遅いマシンで外部リポジトリを動作させることができます。
タグ: bazel_internal_configurationexperimental
--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
--[no]incompatible_disable_native_repo_rules のデフォルト: "false"
false の場合、ネイティブ リポジトリ ルールを WORKSPACE で使用できます。それ以外の場合は、代わりに Starlark リポジトリ ルールを使用する必要があります。ネイティブ リポジトリのルールには、local_repository、new_local_repository、local_config_platform、android_sdk_repository、android_ndk_repository があります。
タグ: bazel_internal_configuration
--repository_cache=<a path> のデフォルト: 説明を参照
外部リポジトリの取得中に取得されたダウンロード値のキャッシュの場所を指定します。引数として空の文字列を指定すると、キャッシュの無効化がリクエストされます。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます
タグ: bazel_internal_configuration
--[no]repository_disable_download のデフォルト: "false"
設定した場合、リポジトリの取得中に gke.download{,_and_extract} を使用したダウンロードは許可されません。ネットワーク アクセスは完全には無効にはなりません。インターネットにアクセスする任意の実行可能ファイルを gsuite.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, refresh or error> のデフォルト: "update"
ロックファイルの使用方法と使用方法を指定します。有効な値は、ロックファイルを使用して変更があった場合に更新する「update」、リモート レジストリから変更可能な情報(ヤンクされたバージョンや以前に欠落したモジュール)を随時更新する「refresh」、ロックファイルを使用するが最新でない場合にエラーをスローする「error」、ロックファイルの読み取り / 書き込みを行わない場合は「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
--vendor_dir=<a path> のデフォルト: 説明を参照
外部リポジトリをベンダーモードで保持するディレクトリを指定します。これは、外部リポジトリを取得する目的で、またはビルド中に外部リポジトリを使用するためです。パスは、絶対パスまたはワークスペース ディレクトリへの相対パスで指定できます。
タグ: loading_and_analysis
ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> のデフォルト: "1s:2,20s:3,1m:5"
上限に達すると、GcThrashingDetector が OOM を持つ Bazel をクラッシュさせます。各制限は、<period>:<count> として指定します。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 エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、GC イベントが完全に終了したときに不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、完全な GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、GC イベントが完全に発生し、保持されているヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> のデフォルト: 「2147483647」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、マイナー GC イベントの発生時に不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、マイナー GC イベントが発生して保持ヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer> のデフォルト: 「85」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率がこのしきい値以上であることを検出した場合、不要な一時的な Skyframe 状態を破棄します。これを微調整すると、GC スラッシングが(i)この一時的な状態のメモリ使用量に起因しており、(ii)必要に応じて状態を再構築するよりもコストが高い場合に、GC スラッシングの経過時間への影響を軽減できます。
タグ: host_machine_resource_optimizations
ロギングの詳細度、形式、場所に影響するオプション:
--experimental_command_profile=<cpu, wall, alloc or lock> のデフォルト: 説明を参照
コマンドの実行中に Java フライト レコーダーのプロファイルを記録します。サポートされているプロファイリング イベントタイプ(cpu、wall、alloc、lock)のいずれかを引数として指定する必要があります。プロファイルは、出力ベース ディレクトリの下のイベントタイプに基づいて名前が付けられたファイルに書き込まれます。このフラグの構文とセマンティクスは、他のプロファイル タイプや出力形式をサポートするため今後変更される可能性があります。このフラグは自己責任で使用してください。
--[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` から始まります。同じ URL に対して複数の rewrite ディレクティブが返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto> のデフォルト: "auto"
リポジトリのフェッチに使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得は再起動の対象となります。それ以外の場合は、仮想ワーカー スレッドを使用します。
その他のカテゴリに該当しないその他のオプション:
--override_repository=<an equals-separated mapping of repository name to path> 回の使用が累積されています
リポジトリは、<リポジトリ名>=<パス> 形式のローカルパスでオーバーライドします。指定したパスが絶対パスの場合は、そのまま使用されます。指定したパスが相対パスの場合は、現在の作業ディレクトリを基準とする相対パスになります。指定したパスが「%workspace%」で始まる場合は、「bazel info workspace」の出力であるワークスペースのルートからの相対パスになります。

ベンダー オプション

コマンドの前に表示され、クライアントによって解析されるオプション:
--distdir=<a path> 回の使用が累積されています
ネットワークにアクセスしてダウンロードする前にアーカイブを検索する場所の追加。
タグ: bazel_internal_configuration
設定すると、キャッシュ ヒットが発生した場合、リポジトリ キャッシュはファイルをコピーするのではなくハードリンクします。これはディスク容量を節約するためのものです。
タグ: bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer> のデフォルト: 「0」
ダウンロード エラーの再試行の最大試行回数。0 に設定すると、再試行が無効になります。
タグ: experimental
--experimental_scale_timeouts=<a double> のデフォルト: 「1.0」
Starlark リポジトリ ルールのすべてのタイムアウトを、この係数でスケーリングします。このようにして、ソースコードを変更することなく、ルール作成者の想定よりも遅いマシンで外部リポジトリを動作させることができます。
タグ: bazel_internal_configurationexperimental
--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
--[no]incompatible_disable_native_repo_rules のデフォルト: "false"
false の場合、ネイティブ リポジトリ ルールを WORKSPACE で使用できます。それ以外の場合は、代わりに Starlark リポジトリ ルールを使用する必要があります。ネイティブ リポジトリのルールには、local_repository、new_local_repository、local_config_platform、android_sdk_repository、android_ndk_repository があります。
タグ: bazel_internal_configuration
--repository_cache=<a path> のデフォルト: 説明を参照
外部リポジトリの取得中に取得されたダウンロード値のキャッシュの場所を指定します。引数として空の文字列を指定すると、キャッシュの無効化がリクエストされます。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます
タグ: bazel_internal_configuration
--[no]repository_disable_download のデフォルト: "false"
設定した場合、リポジトリの取得中に gke.download{,_and_extract} を使用したダウンロードは許可されません。ネットワーク アクセスは完全には無効にはなりません。インターネットにアクセスする任意の実行可能ファイルを gsuite.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] デフォルト: "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 言語またはビルド API のセマンティクスに影響します。
--[no]incompatible_config_setting_private_default_visibility のデフォルト: "false"
Compatibility_enforce_config_setting_visibility=false は、NoOps です。それ以外の場合、このフラグが false の場合、明示的な公開設定属性のない config_setting はすべて //visibility:public です。このフラグが true の場合、config_setting は他のすべてのルールと同じ公開設定ロジックに従います。https://github.com/bazelbuild/bazel/issues/12933 をご覧ください。
タグ: loading_and_analysisincompatible_change
--[no]incompatible_enforce_config_setting_visibility のデフォルト: "true"
true の場合、config_setting の公開設定制限を適用します。false の場合、すべての config_setting がすべてのターゲットに表示されます。https://github.com/bazelbuild/bazel/issues/12932 をご覧ください。
タグ: loading_and_analysisincompatible_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, refresh or error> のデフォルト: "update"
ロックファイルの使用方法と使用方法を指定します。有効な値は、ロックファイルを使用して変更があった場合に更新する「update」、リモート レジストリから変更可能な情報(ヤンクされたバージョンや以前に欠落したモジュール)を随時更新する「refresh」、ロックファイルを使用するが最新でない場合にエラーをスローする「error」、ロックファイルの読み取り / 書き込みを行わない場合は「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
--repo=<a string> 回の使用が累積されています
指定されたリポジトリ(「@apparent_repo_name」または「@@canonical_repo_name」のいずれか)を提供するベンダーのみ。このオプションは複数回設定できます。
タグ: changes_inputs
--vendor_dir=<a path> のデフォルト: 説明を参照
外部リポジトリをベンダーモードで保持するディレクトリを指定します。これは、外部リポジトリを取得する目的で、またはビルド中に外部リポジトリを使用するためです。パスは、絶対パスまたはワークスペース ディレクトリへの相対パスで指定できます。
タグ: loading_and_analysis
ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> のデフォルト: "1s:2,20s:3,1m:5"
上限に達すると、GcThrashingDetector が OOM を持つ Bazel をクラッシュさせます。各制限は、<period>:<count> として指定します。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 エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、GC イベントが完全に終了したときに不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、完全な GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、GC イベントが完全に発生し、保持されているヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> のデフォルト: 「2147483647」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、マイナー GC イベントの発生時に不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、マイナー GC イベントが発生して保持ヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer> のデフォルト: 「85」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率がこのしきい値以上であることを検出した場合、不要な一時的な Skyframe 状態を破棄します。これを微調整すると、GC スラッシングが(i)この一時的な状態のメモリ使用量に起因しており、(ii)必要に応じて状態を再構築するよりもコストが高い場合に、GC スラッシングの経過時間への影響を軽減できます。
タグ: host_machine_resource_optimizations
ロギングの詳細度、形式、場所に影響するオプション:
--experimental_command_profile=<cpu, wall, alloc or lock> のデフォルト: 説明を参照
コマンドの実行中に Java フライト レコーダーのプロファイルを記録します。サポートされているプロファイリング イベントタイプ(cpu、wall、alloc、lock)のいずれかを引数として指定する必要があります。プロファイルは、出力ベース ディレクトリの下のイベントタイプに基づいて名前が付けられたファイルに書き込まれます。このフラグの構文とセマンティクスは、他のプロファイル タイプや出力形式をサポートするため今後変更される可能性があります。このフラグは自己責任で使用してください。
--[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` から始まります。同じ URL に対して複数の rewrite ディレクティブが返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto> のデフォルト: "auto"
リポジトリのフェッチに使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得は再起動の対象となります。それ以外の場合は、仮想ワーカー スレッドを使用します。
その他のカテゴリに該当しないその他のオプション:
--deleted_packages=<comma-separated list of package names> 回の使用が累積されています
パッケージパスのどこかに表示されている場合でも、ビルドシステムが存在しないと見なすパッケージ名のカンマ区切りリスト。 このオプションは、既存のパッケージ「x」のサブパッケージ「x/y」を削除する場合に使用します。たとえば、クライアントで x/y/BUILD を削除した後でも、別の package_path エントリで指定されていれば、ビルドシステムで「//x:y/z」というラベルが検出されるとエラーが表示されることがあります。--deleted_packages x/y を指定すると、この問題を回避できます。
--[no]fetch のデフォルト: "true"
コマンドが外部依存関係を取得できるようにします。false に設定すると、依存関係のキャッシュ バージョンが使用されます。依存関係が存在しない場合は、コマンドが失敗します。
--override_repository=<an equals-separated mapping of repository name to 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
設定すると、キャッシュ ヒットが発生した場合、リポジトリ キャッシュはファイルをコピーするのではなくハードリンクします。これはディスク容量を節約するためのものです。
タグ: bazel_internal_configuration
--experimental_repository_downloader_retries=<an integer> のデフォルト: 「0」
ダウンロード エラーの再試行の最大試行回数。0 に設定すると、再試行が無効になります。
タグ: experimental
--experimental_scale_timeouts=<a double> のデフォルト: 「1.0」
Starlark リポジトリ ルールのすべてのタイムアウトを、この係数でスケーリングします。このようにして、ソースコードを変更することなく、ルール作成者の想定よりも遅いマシンで外部リポジトリを動作させることができます。
タグ: bazel_internal_configurationexperimental
--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
--[no]incompatible_disable_native_repo_rules のデフォルト: "false"
false の場合、ネイティブ リポジトリ ルールを WORKSPACE で使用できます。それ以外の場合は、代わりに Starlark リポジトリ ルールを使用する必要があります。ネイティブ リポジトリのルールには、local_repository、new_local_repository、local_config_platform、android_sdk_repository、android_ndk_repository があります。
タグ: bazel_internal_configuration
--repository_cache=<a path> のデフォルト: 説明を参照
外部リポジトリの取得中に取得されたダウンロード値のキャッシュの場所を指定します。引数として空の文字列を指定すると、キャッシュの無効化がリクエストされます。それ以外の場合は、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます
タグ: bazel_internal_configuration
--[no]repository_disable_download のデフォルト: "false"
設定した場合、リポジトリの取得中に gke.download{,_and_extract} を使用したダウンロードは許可されません。ネットワーク アクセスは完全には無効にはなりません。インターネットにアクセスする任意の実行可能ファイルを gsuite.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_outputsexecution
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, refresh or error> のデフォルト: "update"
ロックファイルの使用方法と使用方法を指定します。有効な値は、ロックファイルを使用して変更があった場合に更新する「update」、リモート レジストリから変更可能な情報(ヤンクされたバージョンや以前に欠落したモジュール)を随時更新する「refresh」、ロックファイルを使用するが最新でない場合にエラーをスローする「error」、ロックファイルの読み取り / 書き込みを行わない場合は「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
--vendor_dir=<a path> のデフォルト: 説明を参照
外部リポジトリをベンダーモードで保持するディレクトリを指定します。これは、外部リポジトリを取得する目的で、またはビルド中に外部リポジトリを使用するためです。パスは、絶対パスまたはワークスペース ディレクトリへの相対パスで指定できます。
タグ: loading_and_analysis
ビルド時間の最適化をトリガーするオプション:
--gc_thrashing_limits=<comma separated pairs of <period>:<count>> のデフォルト: "1s:2,20s:3,1m:5"
上限に達すると、GcThrashingDetector が OOM を持つ Bazel をクラッシュさせます。各制限は、<period>:<count> として指定します。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 エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、GC イベントが完全に終了したときに不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、完全な GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、GC イベントが完全に発生し、保持されているヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_minor_gc_drops_per_invocation=<an integer, >= 0> のデフォルト: 「2147483647」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率が --skyframe_high_water_mark_threshold で設定されたしきい値を超えたことを検出すると、マイナー GC イベントの発生時に不要な一時的な Skyframe 状態をドロップします(呼び出しごとにこの回数まで)。デフォルトは Integer.MAX_VALUE で、事実上無制限です。ゼロは、マイナー GC イベントによってドロップがトリガーされないことを意味します。この上限に達すると、マイナー GC イベントが発生して保持ヒープの割合のしきい値を超えても、Skyframe の状態が破棄されなくなります。
タグ: host_machine_resource_optimizations
--skyframe_high_water_mark_threshold=<an integer> のデフォルト: 「85」
Bazel の内部 Skyframe エンジンの詳細構成を示すフラグ。Bazel は、保持されているヒープ使用率がこのしきい値以上であることを検出した場合、不要な一時的な Skyframe 状態を破棄します。これを微調整すると、GC スラッシングが(i)この一時的な状態のメモリ使用量に起因しており、(ii)必要に応じて状態を再構築するよりもコストが高い場合に、GC スラッシングの経過時間への影響を軽減できます。
タグ: host_machine_resource_optimizations
ロギングの詳細度、形式、場所に影響するオプション:
--experimental_command_profile=<cpu, wall, alloc or lock> のデフォルト: 説明を参照
コマンドの実行中に Java フライト レコーダーのプロファイルを記録します。サポートされているプロファイリング イベントタイプ(cpu、wall、alloc、lock)のいずれかを引数として指定する必要があります。プロファイルは、出力ベース ディレクトリの下のイベントタイプに基づいて名前が付けられたファイルに書き込まれます。このフラグの構文とセマンティクスは、他のプロファイル タイプや出力形式をサポートするため今後変更される可能性があります。このフラグは自己責任で使用してください。
--[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` から始まります。同じ URL に対して複数の rewrite ディレクティブが返される場合があります。
--experimental_worker_for_repo_fetching=<off, platform, virtual or auto> のデフォルト: "auto"
リポジトリのフェッチに使用するスレッドモード。「off」に設定すると、ワーカー スレッドは使用されず、リポジトリの取得は再起動の対象となります。それ以外の場合は、仮想ワーカー スレッドを使用します。
その他のカテゴリに該当しないその他のオプション:
--override_repository=<an equals-separated mapping of repository name to 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 このオプションは、ビルドの testrunner 環境を変更します。

オプション メタデータ タグ

experimental このオプションは試験運用版の機能をトリガーしますが、機能性は保証されません。
incompatible_change このオプションを使用すると、互換性を破る変更がトリガーされます。このオプションを使用して、移行の準備状況をテストしたり、新機能に早期アクセスしたりできます。
deprecated このオプションは非推奨となりました。その機能が影響する機能が非推奨になっているか、別の方法で情報を提供する方法が推奨されている可能性があります。