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]
通常、トライステート オプションはデフォルトで自動に設定されます。また、次のように強制的に有効にすることもできます。
--<option>=[true|yes|1]または強制的に無効にします。
--no<option> --<option>=[false|no|0]
コマンド
analyze-profile |
ビルド プロファイル データを分析します。 |
aquery |
指定されたターゲットを分析してアクション グラフをクエリします。 |
build |
指定されたターゲットをビルドします。 |
canonicalize-flags |
バゼル オプションのリストを正規化します。 |
clean |
出力ファイルを削除し、必要に応じてサーバーを停止します。 |
coverage |
指定したテスト ターゲットのコード カバレッジ レポートを生成します。 |
cquery |
指定されたターゲットを構成とともに読み込み、分析、クエリします。 |
dump |
bazel サーバー プロセスの内部状態をダンプします。 |
fetch |
ターゲットの前提条件である外部リポジトリを取得します。 |
help |
コマンドまたはインデックスのヘルプを出力します。 |
info |
bazel サーバーに関するランタイム情報を表示します。 |
license |
このソフトウェアのライセンスを出力します。 |
mobile-install |
モバイル デバイスにターゲットをインストールします。 |
modquery |
Bzlmod 外部依存関係グラフをクエリする |
print_action |
ファイルをコンパイルするためのコマンドライン引数を出力します。 |
query |
依存関係グラフクエリを実行します。 |
run |
指定されたターゲットを実行します。 |
shutdown |
bazel サーバーを停止します。 |
sync |
ワークスペース ファイルで指定されているすべてのリポジトリを同期します。 |
test |
指定したテスト ターゲットをビルドして実行します。 |
version |
bazel のバージョン情報を出力します。 |
起動オプション
- コマンドの前に表示され、クライアントによって解析されるオプション:
--[no]autodetect_server_javabase
のデフォルト: "true"-
--noautodetect_server_javabase が渡されると、Bazel は bazel サーバーを実行するためのローカル JDK にフォールバックせず、代わりに終了します。
タグ:affects_outputs
、loses_incremental_state
--[no]batch
: 「false」-
設定すると、Bazel は標準のクライアント/サーバーモードではなく、サーバーなしでクライアント プロセスとして実行されます。これは非推奨であり、削除される予定です。サーバーを存続させたくない場合は、サーバーを明示的にシャットダウンすることをおすすめします。
タグ:loses_incremental_state
、bazel_internal_configuration
、deprecated
--[no]batch_cpu_scheduling
: 「false」-
Linux のみ。Blaze には「バッチ」CPU スケジューリングを使用します。このポリシーは、インタラクティブではないものの価値を低下させたくないワークロードに役立ちます。「man 2 sched_setscheduler」をご覧ください。false の場合、Bazel はシステムコールを行いません。
タグ:host_machine_resource_optimizations
--bazelrc=<path>
: 説明を表示-
Bazel オプションのデフォルト値を含むユーザー .bazelrc ファイルの場所。/dev/null は、以降のすべての「--bazelrc」が無視されることを示します。これは、リリースビルドなどでユーザー rc ファイルの検索を無効にするのに便利です。このオプションは、複数回指定することもできます。たとえば、--bazelrc=x.rc --bazelrc=y.rc --bazelrc=/dev/null --bazelrc=z.rc の場合、1) x.rc と y.rc が読み取られます。
2)前の /dev/null のため、z.rc は無視される
指定されていない場合、Bazel は 2 つの場所(ワークスペース ディレクトリ、ユーザーのホーム ディレクトリ)で最初に検出された .bazelrc ファイルを使用します。
注: コマンドライン オプションは、bazelrc のすべてのオプションよりも優先されます。
タグ:changes_inputs
--[no]block_for_lock
のデフォルト: "true"- --noblock_for_lock が渡された場合、Bazel は実行中のコマンドの完了を待たずに、すぐに終了します。
タグ:eagerness_to_exit
--[no]client_debug
: 「false」-
true の場合、クライアントから stderr にデバッグ情報をログに記録する。このオプションを変更しても、サーバーは再起動しません。
タグ:affects_outputs
、bazel_monitoring
--connect_timeout_secs=<an integer>
: 「30」-
クライアントがサーバーに接続するたびに待機する時間
タグ:bazel_internal_configuration
--[no]expand_configs_in_place
のデフォルト: "true"-
--rc フラグの拡張をインプレースで変更しました。通常の rc オプションとコマンドライン指定オプションの間の固定ポイント展開とは対照的です。
タグ:no_op
、deprecated
--failure_detail_out=<path>
: 説明を表示-
設定すると、サーバーで障害が発生し、gRPC 経由で報告できない場合は、failure_detail protobuf メッセージを書き込む場所を指定します。それ以外の場合、ロケーションは ${OUTPUT_BASE}/failure_detail.rawproto になります。
タグ:affects_outputs
、loses_incremental_state
--[no]home_rc
のデフォルト: "true"- $HOME/.bazelrc でホーム bazelrc ファイルを検索するかどうかを指定します。
タグ:changes_inputs
--[no]idle_server_tasks
のデフォルト: "true"-
サーバーがアイドル状態のときに System.gc() を実行する
タグ:loses_incremental_state
、host_machine_resource_optimizations
--[no]ignore_all_rc_files
: 「false」- 他の rc-modify フラグの値に関係なく、すべての rc ファイルを無効にします。これらのフラグが起動オプションのリストで後から指定されていても無効になります。
タグ:changes_inputs
--io_nice_level={-1,0,1,2,3,4,5,6,7}
のデフォルト: "-1"-
Linux のみ。sys_ioprio_set システム呼び出しを使用してベスト エフォート型の IO スケジューリングのレベルを 0 ~ 7 から設定します。0 の優先度が最も高く、7 が最も低い値です。予測スケジューラは、優先度 4 までを尊重できます。負の値に設定すると、Bazel はシステムコールを実行しません。
タグ:host_machine_resource_optimizations
--local_startup_timeout_secs=<an integer>
: 「120」-
クライアントがサーバーへの接続を待機する最大時間
タグ:bazel_internal_configuration
--macos_qos_class=<a string>
デフォルト: "default"-
macOS で実行する際の bazel サーバーの QoS サービスクラスを設定します。このフラグは他のすべてのプラットフォームには影響しませんが、rc ファイルを変更せずに共有できるようにサポートされています。有効な値は、user-interactive、user-initiated、default、utilization、background です。
タグ:host_machine_resource_optimizations
--max_idle_secs=<integer>
: 「10800」-
ビルドサーバーがアイドル状態で待機してからシャットダウンする秒数。ゼロは、サーバーがシャットダウンされることを意味しません。これはサーバー起動時にのみ読み取られます。このオプションを変更しても、サーバーは再起動されません。
タグ:eagerness_to_exit
、loses_incremental_state
--output_base=<path>
: 説明を表示-
設定した場合、すべてのビルド出力を書き込む出力場所を指定します。それ以外の場合は、ロケーションは ${OUTPUT_ROOT}/_blaze_${USER}/${MD5_OF_WORKSPACE_ROOT} になります。注: この値に対して 1 つ後の Bazel 呼び出しに異なるオプションを指定すると、新しい Bazel サーバーが起動される可能性があります。Bazel は、指定された出力ベースごとに 1 つのサーバーを起動します。通常、ワークスペースごとに 1 つの出力ベースがありますが、このオプションでは、ワークスペースごとに複数の出力ベースを使用して、同じマシン上で同じクライアントについて複数のビルドを同時に実行できます。Bazel サーバーをシャットダウンする方法については、「bazel help shutdown」をご覧ください。
タグ:affects_outputs
、loses_incremental_state
--output_user_root=<path>
: 説明を表示- すべてのビルド出力が書き込まれるユーザー固有のディレクトリ。デフォルトでは、これは $USER の関数ですが、定数を指定することで、コラボレーション ユーザー間でビルド出力を共有できます。
タグ:affects_outputs
、loses_incremental_state
--[no]preemptible
: 「false」-
true の場合、別のコマンドが開始されると、コマンドをプリエンプトできます。
タグ:eagerness_to_exit
--server_jvm_out=<path>
: 説明を表示-
サーバーの JVM の出力を書き込む場所。設定しない場合、デフォルトで output_base のロケーションになります。
タグ:affects_outputs
、loses_incremental_state
--[no]shutdown_on_low_sys_mem
: 「false」-
max_idle_secs が設定され、ビルドサーバーがしばらくアイドル状態だった場合、システムの RAM が不足しているためにサーバーをシャットダウンします。Linux のみ。
タグ:eagerness_to_exit
、loses_incremental_state
--[no]system_rc
のデフォルト: "true"- システム全体の bazelrc を探すかどうか。
タグ:changes_inputs
--[no]unlimit_coredumps
: 「false」-
ソフトコア ダンプのハードリミットをハードリミットに引き上げて、共通の条件下でサーバー(JVM を含む)とクライアントのコアダンプを利用できるようにします。このフラグを bazelrc に 1 回貼り付けて、そのことを忘れてしまい、トリガーされる条件が実際に発生した場合にコアダンプが返されるようにします。
タグ:bazel_internal_configuration
--[no]watchfs
: 「false」-
true の場合、bazel は、変更がないかすべてのファイルをスキャンするのではなく、オペレーティング システムのファイル ウォッチサービスを使用してローカルの変更を試みます。
タグ:deprecated
--[no]windows_enable_symlinks
: 「false」-
true の場合、ファイルのコピーではなく、実際のシンボリック リンクが Windows で作成されます。Windows デベロッパー モードを有効にし、Windows 10 バージョン 1703 以降が必要です。
タグ:bazel_internal_configuration
--[no]workspace_rc
のデフォルト: "true"- $workspace/.bazelrc にあるワークスペースの bazelrc ファイルを探すかどうかを指定します。
タグ:changes_inputs
- その他(その他):
- 複数の
--host_jvm_args=<jvm_arg>
が累計されます - Blaze を実行する JVM に渡すフラグ。
--host_jvm_debug
-
JVM 起動フラグを追加するための便利なオプション。これにより、JDWP 準拠のデバッガ(Eclipse など)からポート 5005 に接続するまで、JVM が起動時に待機します。
以下に展開:
--host_jvm_args=-Xdebug
--host_jvm_args=-Xrunjdwp:transport=dt_socket,server=y,address=5005
--host_jvm_profile=<profiler_name>
のデフォルト: "- プロファイラ/デバッガ固有の JVM 起動フラグを追加するための便利なオプション。Bazel には、ハードコードされた JVM 起動フラグにマッピングされる既知の値のリストがあり、特定のファイルについてハードコードされたパスを検索できます。
--server_javabase=<jvm path>
のデフォルト: "- Bazel 自体の実行に使用される JVM のパス。
すべてのコマンドに共通するオプション
- ビルドの実行を制御するオプション:
--experimental_ui_max_stdouterr_bytes=<an integer in (-1)-1073741819 range>
: 「1048576」-
コンソールに出力される stdout / stderr ファイルの最大サイズ。-1 は制限がないことを意味します。
タグ:execution
--[no]incompatible_remote_dangling_symlinks
のデフォルト: "true"-
true に設定すると、--compatibility_remote_symlinks も true に設定すると、アクション出力のシンボリック リンクがぶら下がります。
タグ:execution
、incompatible_change
--[no]incompatible_remote_symlinks
のデフォルト: "true"-
true に設定すると、Bazel はリモート キャッシュ/実行プロトコルのアクション出力でシンボリック リンクを表します。それ以外の場合は、シンボリック リンクがフォローされ、ファイルまたはディレクトリとして表されます。詳しくは #6631 をご覧ください。
タグ:execution
、incompatible_change
- 存在するのではなく、ユーザーが意図する出力を構成し、その値に影響を及ぼすオプションです。
--bep_maximum_open_remote_upload_files=<an integer>
のデフォルト: "-1"-
BEP アーティファクトのアップロード中に許可される最大オープン ファイル数。
タグ:affects_outputs
--remote_download_minimal
-
リモートビルドの出力をローカルマシンにダウンロードしません。このフラグは、フラグ --action_cache_store_output_metadata、--experimental_inmemory_jdeps_files、--experimental_inmemory_dotd_files、--remote_download_outputs=minimal のショートカットです。
以下に展開:
--nobuild_runfile_links
--action_cache_store_output_metadata
--remote_download_outputs=minimal
タグ:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
: 「すべて」-
「minimal」に設定した場合、ローカルビルドに必要なリモートビルド出力がローカルマシンにダウンロードされません。「toplevel」に設定すると、トップレベル ターゲットの出力もローカルマシンにダウンロードされる点を除いて「minimal」と同じように動作します。どちらの方法でも、ネットワーク帯域幅がボトルネックになるとビルド時間が大幅に短縮されます。
タグ:affects_outputs
--remote_download_symlink_template=<a string>
のデフォルト: "-
リモートビルドの出力をローカルマシンにダウンロードするのではなく、シンボリック リンクを作成します。シンボリック リンクのターゲットは、テンプレート文字列の形式で指定できます。このテンプレート文字列には {hash} と {size_bytes} が含まれ、それぞれオブジェクトのハッシュとサイズ(バイト単位)に展開されます。たとえば、これらのシンボリック リンクは、オンデマンドで CAS からオブジェクトを読み込む FUSE ファイル システムを指す場合があります。
タグ:affects_outputs
--remote_download_toplevel
-
最上位ターゲットのリモート出力のみをローカルマシンにダウンロードします。このフラグは、--action_cache_store_output_metadata、--experimental_inmemory_jdeps_files、--experimental_inmemory_dotd_files、--remote_download_outputs=toplevel フラグのショートカットです。
以下に展開:
--action_cache_store_output_metadata
--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
--[no]enable_bzlmod
: 「false」-
true の場合、WORKSPACE よりも優先される Bzlmod 依存関係管理システムを有効にします。詳細については、https://bazel.build/docs/bzlmod をご覧ください。
タグ:loading_and_analysis
--[no]experimental_action_resource_set
のデフォルト: "true"-
true に設定すると、ctx.actions.run() と ctx.actions.run_shell() は、ローカル実行用の resource_set パラメータを受け入れます。それ以外の場合、メモリと 1 CPU はデフォルトで 250 MB になります。
タグ:execution
、build_file_semantics
、experimental
-
true に設定すると、タグはターゲットからアクションの実行要件に伝播されます。それ以外の場合、タグは伝播されません。詳しくは、https://github.com/bazelbuild/bazel/issues/8830 をご覧ください。
タグ:build_file_semantics
、experimental
--[no]experimental_analysis_test_call
のデフォルト: "true"-
true に設定すると、analysis_test ネイティブ呼び出しを使用できます。
タグ:loading_and_analysis
、build_file_semantics
、experimental
--[no]experimental_bzl_visibility
のデフォルト: "true"-
有効な場合、トップレベル評価で .bzl ファイルが呼び出す visibility() 関数を追加して、load() ステートメントのために可視性を設定します。
タグ:loading_and_analysis
、experimental
-
true に設定すると、ルール cc_shared_library に必要なルール属性と Starlark API メソッドが使用可能になります。
タグ:build_file_semantics
、loading_and_analysis
、experimental
--[no]experimental_disable_external_package
: 「false」-
true に設定すると、自動生成された外部パッケージは使用できなくなります。Bazel は引き続きファイル「external/BUILD」を解析できませんが、名前のないパッケージから external/ にアクセスする glob は機能します。
タグ:loading_and_analysis
、loses_incremental_state
、experimental
--[no]experimental_enable_android_migration_apis
: 「false」-
true に設定すると、Android Starlark の移行のサポートに必要な API が有効になります。
タグ:build_file_semantics
--[no]experimental_enable_scl_dialect
: 「false」-
true に設定すると、load() ステートメントで .scl ファイルを使用できます。
タグ:build_file_semantics
--[no]experimental_get_fixed_configured_action_env
: 「false」-
有効にすると、action.env は機能構成で指定された固定環境変数も返します。
タグ:loading_and_analysis
、experimental
--[no]experimental_google_legacy_api
: 「false」-
true に設定すると、Google の以前のコードに関連する Starlark ビルド API の試験運用版が公開されます。
タグ:loading_and_analysis
、experimental
--[no]experimental_java_library_export
: 「false」-
有効にすると、experimental_java_library_export_do_not_use モジュールを使用できます。
タグ:loading_and_analysis
、incompatible_change
--[no]experimental_lazy_template_expansion
のデフォルト: "true"-
true に設定すると、ctx.actions.expand_template() は、置換値の遅延評価のために TemplateDict パラメータを受け入れます。
タグ:execution
、build_file_semantics
、experimental
--[no]experimental_platforms_api
: 「false」-
true に設定すると、デバッグに役立つプラットフォーム関連の Starlark API が有効になります。
タグ:loading_and_analysis
、experimental
--[no]experimental_repo_remote_exec
: 「false」-
true に設定すると、repository_rule はリモート実行機能を取得します。
タグ:build_file_semantics
、loading_and_analysis
、experimental
--[no]experimental_sibling_repository_layout
: 「false」-
true に設定すると、メイン以外のリポジトリは、実行ルートのメイン リポジトリへのシンボリック リンクとして配置されます。つまり、すべてのリポジトリは $output_base/execution_root ディレクトリの直接の子です。これにより、実際の出力の「外部」ディレクトリ用に $output_base/execution_root/__main__/external が解放されます。
タグ:action_command_lines
、bazel_internal_configuration
、loading_and_analysis
、loses_incremental_state
、experimental
--[no]incompatible_always_check_depset_elements
のデフォルト: "true"-
すべてのコンストラクタで、depset に追加された要素の有効性を確認します。要素は不変である必要がありますが、歴史的に depset(direct=...) コンストラクタはチェックするのを忘れていました。depset 要素内でリストの代わりにタプルを使用します。詳しくは、https://github.com/bazelbuild/bazel/issues/10313 をご覧ください。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_depset_for_libraries_to_link_getter
のデフォルト: "true"-
true の場合、Bazel は Linking_context.libraries_to_link からリストを返しなくなり、代わりに depset を返します。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_disable_starlark_host_transitions
: 「false」-
true に設定すると、ルールの属性で「cfg = "host"」を設定できなくなります。代わりに「cfg = "exec"」に設定する必要があります。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_disable_target_provider_fields
: 「false」-
true に設定すると、フィールド構文を介して「ターゲット」オブジェクトのプロバイダにアクセスする機能が無効になります。代わりにプロバイダキー構文を使用してください。例えば、
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_disallow_empty_glob
: 「false」-
true に設定すると、glob() の「allow_empty」引数のデフォルト値は False になります。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_disallow_legacy_javainfo
のデフォルト: "true"-
非推奨。No-op。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_disallow_struct_provider_syntax
: 「false」-
true に設定すると、ルール実装関数から構造体が返されない場合があります。代わりに、プロバイダ インスタンスのリストを返す必要があります。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_existing_rules_immutable_view
のデフォルト: "true"-
true に設定すると、native.existing_rule と native.existing_rules が、変更可能なディクショナリではなく、軽量の不変ビュー オブジェクトを返します。
タグ:build_file_semantics
、loading_and_analysis
、incompatible_change
--[no]incompatible_fix_package_group_reporoot_syntax
のデフォルト: "true"-
package_group の package パッケージ属性では値「//...」の意味が変更され、任意のリポジトリ内のすべてのパッケージではなく、現在のリポジトリのすべてのパッケージを参照します。「//...」の代わりに特別な「public」を使用して、以前の動作を取得できます。このフラグでは、--compatible_package_group_has_public_syntax も有効にする必要があります。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_java_common_parameters
のデフォルト: "true"-
true に設定すると、pack_sources と host_javabase のコンパイル パラメータの output_jar、host_javabase のパラメータがすべて削除されます。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_new_actions_api
のデフォルト: "true"-
true に設定すると、アクションを作成する API は「ctx.actions」でのみ使用できます。「ctx」では使用できません。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_no_attr_license
のデフォルト: "true"-
true に設定すると、関数「attr.license」が無効になります。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_no_implicit_file_export
: 「false」-
設定した場合、(使用される)ソースファイルは、明示的にエクスポートされない限り、パッケージ プライベートになります。https://github.com/bazelbuild/Proposals/blob/master/designs/2019-10-24-file-visibility.md を参照
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_no_rule_outputs_param
: 「false」-
true に設定すると、Starlark 関数の「rule()」関数の「outputs」パラメータが無効になります。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_package_group_has_public_syntax
のデフォルト: "true"-
package_group 属性の "packages" 属性では、すべてのパッケージを参照するように "public" または "private" を記述できます。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_require_linker_input_cc_api
のデフォルト: "true"-
true に設定すると、ルール create_linking_context で libraries_to_link ではなく linker_inputs が必要になります。linking_context の古いゲッターも無効になり、linker_inputs のみが使用できるようになります。
タグ:build_file_semantics
、loading_and_analysis
、incompatible_change
--[no]incompatible_run_shell_command_string
のデフォルト: "true"-
true に設定すると、actions.run_shell のコマンド パラメータは文字列として受け入れられます。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_stop_exporting_language_modules
: 「false」-
有効にすると、特定の言語固有のモジュール(cc_common など)がユーザーの .bzl ファイル内で使用できなくなり、それぞれのルール リポジトリからしか呼び出せなくなります。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_struct_has_no_methods
: 「false」-
構造体フィールドの名前空間を汚染する、構造体の to_json および to_proto メソッドを無効にします。代わりに、json.encode または JSON の場合は json.encode_strict を、textproto の場合は proto.encode_text を使用してください。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_top_level_aspects_require_providers
: 「false」-
true に設定すると、トップレベルのアスペクトは必要なプロバイダを尊重し、ルールのアドバタイズされたプロバイダがアスペクトの必要なプロバイダを満たすトップレベル ターゲットでのみ実行されます。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_unambiguous_label_stringification
のデフォルト: "true"-
true の場合、Bazel はラベル @//foo:bar を @foo:bar ではなく @//foo:bar に文字列化します。これは str() や % 演算子などの動作にのみ影響し、repr() の動作は変更されません。詳しくは、https://github.com/bazelbuild/bazel/issues/15916 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_use_cc_configure_from_rules_cc
: 「false」-
true に設定すると、@bazel_tools の cc_configure を Bazel で使用できなくなります。詳細と移行手順については、https://github.com/bazelbuild/bazel/issues/10134 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition
: 「false」-
true に設定すると、プライベート ルール属性の公開設定は、ルールの使用状況ではなくルールの定義に基づいてチェックされます。
タグ:build_file_semantics
、incompatible_change
--max_computation_steps=<a long integer>
のデフォルト: "0"-
BUILD ファイルで実行可能な Starlark 計算ステップの最大数(0 は制限がないことを意味します)。
タグ:build_file_semantics
--nested_set_depth_limit=<an integer>
: 「3500」-
depset(内部で NestedSet とも呼ばれます)の内部のグラフの最大深度。これを超えると depset() コンストラクタは失敗します。
タグ:loading_and_analysis
- ビルド時間の最適化をトリガーするオプション:
--[no]heuristically_drop_nodes
: 「false」-
true の場合、Blaze は、Filestore と DirectoryListing の関連ノードがメモリを節約するために行うと、FileState と DirectoryListingState のノードを削除します。これらのノードが再度必要になる可能性は低くなります。再評価された場合、プログラムは再評価します。
タグ:loses_incremental_state
--[no]incompatible_do_not_split_linking_cmdline
のデフォルト: "true"-
true の場合、Bazel はリンクに使用されるコマンドライン フラグを変更しなくなります。また、パラメータ ファイルに送信されるフラグとそれ以外のフラグを選択的に決定することはありません。詳しくは、https://github.com/bazelbuild/bazel/issues/7670 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]keep_state_after_build
のデフォルト: "true"-
false の場合、ビルドが終了すると、Blaze はこのビルドからインメモリ状態を破棄します。以降のビルドでは、このバージョンに対するインクリメンタリティは発生しません。
タグ:loses_incremental_state
--[no]track_incremental_state
のデフォルト: "true"-
false の場合、Blaze は、このビルドのメモリを節約するために、増分ビルドで無効化と再評価を可能にするデータを保持しません。以降のビルドでは、このビルドに対するインクリメンタリティは発生しません。通常は、これを false に設定するときに --batch を指定します。
タグ:loses_incremental_state
- ロギングの詳細度、形式、場所に影響するオプション:
--[no]announce_rc
: 「false」-
RC オプションをアナウンスするかどうか。
タグ:affects_outputs
--[no]attempt_to_print_relative_paths
: 「false」-
メッセージのロケーション部分を出力するときに、ワークスペース ディレクトリまたは --package_path で指定されたディレクトリのいずれかを基準とする相対パスを使用します。
タグ:terminal_output
--bes_backend=<a string>
のデフォルト: "- ビルドイベント サービス(BES)バックエンド エンドポイントを [SCHEME://]HOST[:PORT] の形式で指定します。デフォルトでは、BES アップロードは無効になっています。サポートされているスキームは grpc と grpcs(TLS が有効な grpc)です。スキームが指定されていない場合、Bazel は grpc を想定します。
タグ:affects_outputs
--[no]bes_check_preceding_lifecycle_events
: 「false」-
PublishBuildToolEventStreamRequest にフィールド check_preceding_lifecycle_events_present を設定し、現在のツールイベントに一致する InvocationAttemptStarted イベントと BuildEnqueued イベントを以前に受信したかどうかを BES に指示します。
タグ:affects_outputs
- 複数の
--bes_header=<a 'name=value' assignment>
が累計されます -
BES リクエストに含める NAME=VALUE 形式のヘッダーを指定します。フラグを複数回指定することで、複数のヘッダーを渡すことができます。同じ名前を持つ複数の値は、カンマ区切りのリストに変換されます。
タグ:affects_outputs
--bes_instance_name=<a string>
: 説明を表示-
アップロードされた BEP を BES で保持するインスタンス名を指定します。デフォルトは null です。
タグ:affects_outputs
- 複数の
--bes_keywords=<comma-separated list of options>
が累計されます -
BES に公開されるデフォルトのキーワード セットを追加する通知キーワードのリストを指定します(“command_name=<command_name>", "protocol_name=BEP")。デフォルトはなしです。
タグ:affects_outputs
--[no]bes_lifecycle_events
のデフォルト: "true"-
BES ライフサイクル イベントを公開するかどうかを指定します。(デフォルトは true)。
タグ:affects_outputs
--bes_oom_finish_upload_timeout=<An immutable length of time.>
: 「10m」-
OOM 中に BES/BEP のアップロードが完了するまで、Bazel が待機する時間を指定します。このフラグは、JVM が深刻な GC スラッシングが発生し、ユーザー スレッドで進行できない場合の終了を確実にします。
タグ:bazel_monitoring
--bes_outerr_buffer_size=<an integer>
のデフォルト: "10240"-
進行状況イベントとして報告される前に、BEP でバッファリングされる stdout または stderr の最大サイズを指定します。--bes_outerr_chunk_size で指定された値より大きい場合でも、個々の書き込みは 1 つのイベントでレポートされます。
タグ:affects_outputs
--bes_outerr_chunk_size=<an integer>
: 「1048576」-
1 つのメッセージで BEP に送信する stdout または stderr の最大サイズを指定します。
タグ:affects_outputs
--bes_proxy=<a string>
: 説明を表示- プロキシを介して Build Event Service に接続します。現在、このフラグは Unix ドメイン ソケット(unix:/path/to/socket)の構成にのみ使用できます。
--bes_results_url=<a string>
のデフォルト: "-
ユーザーが BES バックエンドにストリーミングされた情報を表示できるベース URL を指定します。Bazel は、呼び出し ID が付加された URL をターミナルに出力します。
タグ:terminal_output
- 複数の
--bes_system_keywords=<comma-separated list of options>
が累計されます -
--bes_keywords を通じて指定されたキーワードに「user_keyword="」という接頭辞を含めずに、直接含める通知キーワードのリストを指定します。--bes_lifecycle_events=false を設定し、PublishLifecycleEvent を呼び出すときにキーワードを含めるビルド サービス オペレーターを対象としています。このフラグを使用するビルド サービス オペレーターは、ユーザーがフラグ値をオーバーライドできないようにする必要があります。
タグ:affects_outputs
--bes_timeout=<An immutable length of time.>
のデフォルト: "0s"-
ビルドとテストの完了後に BES/BEP のアップロードが完了するまで、Bazel を待機する時間を指定します。有効なタイムアウトは、自然数の後に単位が続きます。日(d)、時間(h)、分(m)、秒(s)、ミリ秒(ms)です。デフォルト値は「0」です。つまり、タイムアウトはありません。
タグ:affects_outputs
--bes_upload_mode=<wait_for_upload_complete, nowait_for_upload_complete or fully_async>
のデフォルト: "wait_for_upload_complete"-
ビルド イベント サービスのアップロードでビルド完了をブロックするか、呼び出しをすぐに終了してバックグラウンドでアップロードを完了するかを指定します。'wait_for_upload_complete'(デフォルト)、'nowait_for_upload_complete'、または 'fully_async'。
タグ:eagerness_to_exit
--build_event_binary_file=<a string>
のデフォルト: "-
空でない場合、ビルドイベント プロトコルの表現の可変区切りバイナリ表現をそのファイルに書き込みます。このオプションは、--bes_upload_mode=wait_for_upload_complete を意味します。
タグ:affects_outputs
--[no]build_event_binary_file_path_conversion
のデフォルト: "true"-
ビルド イベント プロトコルのバイナリ ファイル表現のパスを、可能な限りグローバルに有効な URI に変換します。無効にすると、常に file:// uri スキームが使用されます。
タグ:affects_outputs
--build_event_json_file=<a string>
のデフォルト: "-
空でない場合は、ビルドイベント プロトコルの JSON シリアル化をそのファイルに書き込みます。
タグ:affects_outputs
--[no]build_event_json_file_path_conversion
のデフォルト: "true"- ビルド イベント プロトコルの json ファイル表現のパスを、可能な限りグローバルに有効な URI に変換します。無効にすると、常に file:// uri スキームが使用されます。
タグ:affects_outputs
--build_event_max_named_set_of_file_entries=<an integer>
のデフォルト: "-1"-
1 つの name_set_of_files イベントのエントリの最大数。2 未満の値は無視され、イベント分割は行われません。これは、イベントサイズを直接制御するものではなく、ビルドイベント プロトコルの最大イベントサイズを制限するためのものです。イベントの合計サイズは、セットの構造とファイルの長さ、URI の関数であり、ハッシュ関数によって異なる場合があります。
タグ:affects_outputs
--[no]build_event_publish_all_actions
: 「false」- すべてのアクションを公開するかどうかを指定します。
タグ:affects_outputs
--build_event_text_file=<a string>
のデフォルト: "-
空でない場合、ビルドイベント プロトコルのテキスト表現をそのファイルに書き込みます。
タグ:affects_outputs
--[no]build_event_text_file_path_conversion
のデフォルト: "true"- ビルド イベント プロトコルのテキスト ファイル表現のパスを、可能な限りグローバルに有効な URI に変換します。無効にすると、常に file:// uri スキームが使用されます。
タグ:affects_outputs
--[no]experimental_announce_profile_path
: 「false」-
有効にすると、JSON プロファイルパスがログに追加されます。
タグ:bazel_monitoring
--[no]experimental_bep_target_summary
: 「false」- TargetSummary イベントを公開するかどうかを指定します。
--[no]experimental_build_event_expand_filesets
: 「false」-
true の場合、出力ファイルを表示するときに BEP のファイルセットを展開します。
タグ:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: 「false」-
true の場合、出力ファイルを表示する際に、BEP 内の相対ファイルセット シンボリック リンクを完全に解決します。--experimental_build_event_expand_filesets が必要です。
タグ:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
: 「4」-
Bazel がビルドイベントのアップロードを再試行する最大回数。
タグ:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
のデフォルト: 「1s」-
BEP のアップロードが失敗した場合の指数バックオフの再試行の最小遅延。(指数: 1.6)
タグ:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
: 説明を表示- ビルドイベント プロトコルで参照されるアーティファクトをアップロードする方法を選択します。
タグ:affects_outputs
--[no]experimental_collect_load_average_in_profiler
のデフォルト: "true"-
有効にすると、プロファイラはシステムの全体的な負荷の平均を収集します。
タグ:bazel_monitoring
--[no]experimental_collect_pressure_stall_indicators
: 「false」-
有効にした場合、プロファイラは Linux PSI データを収集します。
タグ:bazel_monitoring
--[no]experimental_collect_resource_estimation
: 「false」-
有効になっている場合、プロファイラがローカル アクションの CPU とメモリの使用量の見積もりを収集します。
タグ:bazel_monitoring
--[no]experimental_collect_system_network_usage
: 「false」-
有効にした場合、プロファイラはシステムのネットワーク使用状況を収集します。
タグ:bazel_monitoring
--[no]experimental_collect_worker_data_in_profiler
: 「false」-
有効にすると、プロファイラがワーカーの集計リソースデータを収集します。
タグ:bazel_monitoring
- 複数の
--experimental_profile_additional_tasks=<phase, action, action_check, action_lock, action_release, action_update, action_complete, info, create_package, remote_execution, local_execution, scanner, local_parse, upload_time, process_time, remote_queue, remote_setup, fetch, vfs_stat, vfs_dir, vfs_readlink, vfs_md5, vfs_xattr, vfs_delete, vfs_open, vfs_read, vfs_write, vfs_glob, vfs_vmfs_stat, vfs_vmfs_dir, vfs_vmfs_read, wait, thread_name, thread_sort_index, skyframe_eval, skyfunction, critical_path, critical_path_component, handle_gc_notification, action_counts, 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, dynamic_lock or unknown>
が累計されます -
プロフィールに含める追加のプロフィール タスクを指定します。
タグ:bazel_monitoring
--[no]experimental_profile_include_primary_output
: 「false」- アクションのプライマリ出力への実行パスを含むアクション イベントに、追加の「out」属性が含まれています。
タグ:bazel_monitoring
--[no]experimental_profile_include_target_label
: 「false」- アクション イベントの JSON プロファイル データにターゲット ラベルが含まれます。
タグ:bazel_monitoring
--[no]experimental_stream_log_file_uploads
: 「false」-
ログファイルがディスクに書き込まれるのではなく、リモート ストレージに直接アップロードされます。
タグ:affects_outputs
--experimental_workspace_rules_log_file=<a path>
: 説明を表示- 特定の Workspace ルール イベントをこのファイルで、区切り文字として WorkspaceEvent proto としてロギングします。
--[no]generate_json_trace_profile
: 「自動」-
有効にすると、Bazel はビルドをプロファイリングし、出力ベースのファイルに JSON 形式のプロファイルを書き込みます。chrome://tracing に読み込んでプロファイルを表示デフォルトでは、Bazel はビルドのようなコマンドとクエリすべてのプロファイルを書き込みます。
タグ:bazel_monitoring
--[no]heap_dump_on_oom
: 「false」-
OOM がスローされたときにヒープダンプを手動で出力するかどうかを指定します(--experimental_oom_more_eagerly_threshold による OOM を含む)。ダンプは <output_base>/<invocation_id>.heapdump.hprof に書き込まれます。このオプションは、-XX:+HeapDumpOnOutOfMemoryError を効果的に置き換えます。OOM がキャッチされて Runtime#halt にリダイレクトされるため、効果はありません。
タグ:bazel_monitoring
--[no]legacy_important_outputs
のデフォルト: "true"-
このパラメータを使用して、TargetComplete イベントで従来の有効期間が長い有効期間フィールドの抑制を図ります。Bazel と ResultStore の統合には、required_outputs が必要です。
タグ:affects_outputs
--logging=<0 <= an integer <= 6>
: 「3」-
ロギングレベル。
タグ:affects_outputs
--memory_profile=<a path>
: 説明を表示-
設定した場合、フェーズ終了時に指定ファイルにメモリ使用量データを書き込み、ビルドの最後にマスターヒープに安定ヒープを書き込みます。
タグ:bazel_monitoring
--memory_profile_stable_heap_parameters=<integers, separated by a comma expected in pairs>
のデフォルト: "1,0"- ビルドの最後にメモリ プロファイルの安定ヒープの計算を調整します。整数の偶数を指定します。カンマで区切る必要があります。各ペアの最初の整数は、実行する GC の数を表します。各ペアの 2 番目の整数は、GC 間で待機する秒数です。例: 2、4、4、0 は 2 個の GC、4 秒間の一時停止、その後に 0 秒間の一時停止の 4 つの GC が含まれます。
タグ:bazel_monitoring
--profile=<a path>
: 説明を表示-
設定した場合、Bazel をプロファイリングして、指定したファイルにデータを書き込みます。bazelanalyze-profile を使用してプロファイルを分析します。
タグ:bazel_monitoring
--[no]record_full_profiler_data
: 「false」-
デフォルトでは、Bazel プロファイラは高速かつ多数のイベント(ファイルの出力など)用に集計データのみを記録します。このオプションを有効にすると、プロファイラが各イベントを記録するため、プロファイリング データはより正確になりますが、パフォーマンスが低下します。このオプションは、--profile も使用された場合にのみ有効になります。
タグ:bazel_monitoring
--remote_print_execution_messages=<failure, success or all>
のデフォルト: 「失敗」-
リモート実行メッセージを出力するタイミングを選択します。有効な値は「failure」、失敗時にのみ出力する場合は「success」、成功時にのみ出力する場合は「success」、常に出力する場合は「all」です。
タグ:terminal_output
--[no]slim_profile
のデフォルト: "true"- プロファイルが大きすぎる場合にイベントをマージして、JSON プロファイルのサイズを縮小します。
タグ:bazel_monitoring
--starlark_cpu_profile=<a string>
のデフォルト: "-
すべての Starlark スレッドによる CPU 使用率の pprof プロファイルを、指定したファイルに書き込みます。
タグ:bazel_monitoring
--tool_tag=<a string>
のデフォルト: "-
この Bazel 呼び出しを関連付けるツール名。
タグ:affects_outputs
、bazel_monitoring
- 複数の
--ui_event_filters=<Convert list of comma separated event kind to list of filters>
が累計されます -
UI に表示するイベントを指定します。デフォルトの + または - を使用してイベントをデフォルトのイベントとの間で追加または削除したり、直接割り当てでデフォルトのセットを完全にオーバーライドしたりできます。サポートされているイベントの種類には、INFO、DEBUG、ERROR などがあります。
タグ:terminal_output
- リモートオプション キャッシュ
--experimental_circuit_breaker_strategy=<failure>
: 説明を表示-
回路ブレーカーで使用する戦略を指定します。使用できる戦略は「失敗」です。オプションに無効な値を指定すると、オプションと同じ動作が設定されます。
タグ:execution
--[no]experimental_guard_against_concurrent_changes
: 「false」- この設定をオフにすると、リモート キャッシュにアップロードする前に、アクションの入力ファイルの確認を無効にすることができます。Linux カーネルがファイルの書き込みを遅延させ、誤検出を引き起こす場合があります。
--[no]experimental_remote_cache_async
: 「false」- true の場合、リモート キャッシュ I/O は、スポーンの一部として行われるのではなく、バックグラウンドで行われます。
--experimental_remote_cache_ttl=<An immutable length of time.>
のデフォルト: 「3h」-
ActionResult や FindMissingBlob などによって、ダイジェストが最近参照された後のリモート キャッシュ内の blob の最小限の TTL が保証されます。Bazel は、blob の TTL に基づいて、複数の最適化を行います。たとえば、増分ビルドで GetActionResult を繰り返し呼び出すことはありません。この値は、サーバーがダイジェストを返す時点と Bazel がダイジェストを受け取る時点の間に時間差があるため、実際の TTL よりわずかに小さい値に設定する必要があります。
タグ:execution
--experimental_remote_capture_corrupted_outputs=<a path>
: 説明を表示- 破損した出力をキャプチャするディレクトリのパス。
--[no]experimental_remote_discard_merkle_trees
: 「false」- true に設定すると、GetActionResult() および Execute() の呼び出し中に、入力ルートのマークルツリーと関連する入力マッピングのメモリ内コピーが破棄されます。これにより、メモリ使用量が大幅に削減されますが、リモート キャッシュのミスまたは再試行時に Bazel が再計算する必要があります。
--experimental_remote_downloader=<a string>
: 説明を表示- リモート ダウンロード プロキシとして使用する Remote Asset API エンドポイント URI。サポートされているスキーマは、grpc、grpcs(TLS が有効な grpc)、UNIX(ローカルの UNIX ソケット)です。スキーマが指定されていない場合、Bazel はデフォルトで grpcs になります。https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto を参照してください。
--[no]experimental_remote_downloader_local_fallback
: 「false」- リモート ダウンローダーが失敗した場合にローカル ダウンローダーにフォールバックするかどうか。
--[no]experimental_remote_execution_keepalive
: 「false」- リモート実行呼び出しにキープアライブを使用するかどうか。
--experimental_remote_failure_rate_threshold=<an integer in 0-100 range>
: 「10」- 特定の時間枠について、リモート キャッシュ/エグゼキュータへの呼び出しを停止するまでの許容許容障害率をパーセンテージで設定します。デフォルト値は 10 です。0 に設定すると、制限はありません。
タグ:execution
--experimental_remote_failure_window_interval=<An immutable length of time.>
のデフォルト: 「60s」-
リモート リクエストの失敗率を計算する間隔。ゼロまたは負の値の場合、失敗期間は実行期間全体に対して計算されます。日数(d)、時間(h)、分(m)、秒(s)、ミリ秒(ms)を使用できます。単位を省略すると、値は秒とみなされます。
タグ:execution
--[no]experimental_remote_mark_tool_inputs
: 「false」- true に設定すると、Bazel は入力をリモート エグゼキュータのツール入力としてマークします。これを使用して、リモート永続ワーカーを実装できます。
--[no]experimental_remote_merkle_tree_cache
: 「false」- true に設定すると、リモート キャッシュ ヒットチェックの速度を改善するために、マークルツリーの計算が記憶されます。キャッシュのメモリ フットプリントは --experimental_remote_merkle_tree_cache_size によって制御されます。
--experimental_remote_merkle_tree_cache_size=<a long integer>
: 「1000」- リモート キャッシュ ヒットチェックの速度を改善するために記憶するマークルツリーの数。キャッシュは、Java によるソフト参照の処理に従って自動的にプルーニングされますが、設定された値が高すぎると、メモリ不足エラーが発生する可能性があります。0 に設定すると、キャッシュ サイズが無制限になります。最適な値はプロジェクトの規模によって異なります。デフォルトは 1,000 です。
--[no]incompatible_remote_build_event_upload_respect_no_cache
: 「false」- 非推奨。機能しません。代わりに --remote_build_event_upload=minimal を使用してください。
--[no]incompatible_remote_disallow_symlink_in_tree_artifact
のデフォルト: "true"-
true に設定すると、リモートから実行されたアクションは、相対シンボリック リンクを含むツリー アーティファクトを生成できません。このフラグに関係なく、絶対シンボリック リンクは使用できません。
タグ:execution
、incompatible_change
--[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"-
true に設定すると、--noremote_upload_local_results と --noremote_accept_cached は、ディスク キャッシュに適用されません。--disk_cache と --remote_cache の両方が設定されている場合(複合キャッシュ):
--noremote_upload_local_results により、結果はディスク キャッシュに書き込まれますが、リモート キャッシュにはアップロードされません。
--noremote_accept_cached は、Bazel によるディスク キャッシュの結果の確認は行いますが、リモート キャッシュの結果は確認しません。
no-remote-exec アクションがディスク キャッシュにヒットする可能性があります。詳しくは #8216 をご覧ください。
タグ:incompatible_change
--[no]remote_accept_cached
のデフォルト: "true"- リモートでキャッシュに保存されたアクションの結果を受け入れるかどうか。
--remote_build_event_upload=<all or minimal>
のデフォルト: "minimal"- 「all」に設定すると、BEP によって参照されるすべてのローカル出力がリモート キャッシュにアップロードされます。 「minimal」に設定すると、BEP によって参照されるローカル出力はリモート キャッシュにアップロードされません。ただし、BEP を使用する重要なファイル(テストログ、タイミング プロファイルなど)は除きます。リモート キャッシュにファイルがない場合でも、bytestream:// スキームは常にファイルの URI に使用されます。デフォルトは「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 が有効な grpc)と UNIX(ローカルの UNIX ソケット)です。スキーマが指定されていない場合、Bazel はデフォルトで grpcs になります。TLS を無効にするには、grpc://、http://、または unix: スキーマを指定します。https://bazel.build/remote/caching を参照してください。
--[no]remote_cache_compression
: 「false」- 有効にすると、zstd を使用してキャッシュ blob を圧縮/解凍します。
- 複数の
--remote_cache_header=<a 'name=value' assignment>
が累計されます - キャッシュ リクエストに含めるヘッダーを指定します(--remote_cache_header=Name=Value)。フラグを複数回指定することで、複数のヘッダーを渡すことができます。同じ名前を持つ複数の値は、カンマ区切りのリストに変換されます。
- 複数の
--remote_default_exec_properties=<a 'name=value' assignment>
が累計されます - 実行プラットフォームで exec_properties が設定されていない場合は、リモート実行プラットフォームとして使用するデフォルトの exec プロパティを設定します。
タグ:affects_outputs
--remote_default_platform_properties=<a string>
のデフォルト: "- 実行プラットフォームに remote_execution_properties が設定されていない場合、リモート実行 API のデフォルトのプラットフォーム プロパティを設定します。この値は、ホスト実行プラットフォームがリモート実行の実行プラットフォームとして選択された場合にも使用されます。
- 複数の
--remote_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 が有効な grpc)、UNIX(ローカルの UNIX ソケット)です。スキーマが指定されていない場合、Bazel はデフォルトで grpcs になります。TLS を無効にするには、grpc:// または unix: スキーマを指定します。
--remote_grpc_log=<a path>
: 説明を表示- 指定した場合、gRPC 呼び出しに関連する詳細情報をログに記録するファイルのパス。このログは、シリアル化された com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry protobuf のシーケンスで構成されており、各メッセージには、次のシリアル化された protobuf メッセージのサイズを示す varint が接頭辞として付加されています(メソッド LogLog.writeDelimitedTo(OutputStream) によって実行されます)。
- 複数の
--remote_header=<a 'name=value' assignment>
が累計されます - リクエストに含めるヘッダーを指定します(--remote_header=Name=Value)。フラグを複数回指定することで、複数のヘッダーを渡すことができます。同じ名前を持つ複数の値は、カンマ区切りのリストに変換されます。
--remote_instance_name=<a string>
のデフォルト: "- リモート実行 API で instance_name として渡す値。
--[no]remote_local_fallback
: 「false」- リモート実行が失敗した場合にスタンドアロンのローカル実行戦略にフォールバックするかどうか。
--remote_local_fallback_strategy=<a string>
のデフォルト: "local"- NoOps は非推奨です。詳しくは、https://github.com/bazelbuild/bazel/issues/7480 をご覧ください。
--remote_max_connections=<an integer>
: 「100」-
リモート キャッシュ/エグゼキュータへの同時接続の最大数を制限します。デフォルト値は 100 です。0 に設定すると、制限はありません。
HTTP リモート キャッシュの場合、1 つの TCP 接続で一度に 1 つのリクエストを処理できるため、Bazel は最大 ---remote_max_connections の同時リクエストを行うことができます。gRPC リモート キャッシュ/エグゼキュータの場合、1 つの gRPC チャネルで 100 を超える同時リクエストを処理できるため、Bazel は約 ----remote_max_connections × 100 の同時リクエストを処理できます。
タグ:host_machine_resource_optimizations
--remote_proxy=<a string>
: 説明を表示- プロキシを介してリモート キャッシュに接続します。現在、このフラグは Unix ドメイン ソケット(unix:/path/to/socket)の構成にのみ使用できます。
--remote_result_cache_priority=<an integer>
のデフォルト: "0"- リモート キャッシュに格納されるリモート アクションの相対的な優先度。特定の優先度値のセマンティクスはサーバーによって異なります。
--remote_retries=<an integer>
: 「5」- 一時的なエラーを再試行する最大回数。0 に設定すると、再試行は無効になります。
--remote_retry_max_delay=<An immutable length of time.>
のデフォルト: 「5s」- リモート再試行間の最大バックオフ遅延。使用できる単位は、日(d)、時間(h)、分(m)、秒(s)、ミリ秒(ms)です。単位を省略すると、値は秒とみなされます。
--remote_timeout=<An immutable length of time.>
のデフォルト: 「60s」- リモート実行とキャッシュ呼び出しを待機する最大時間。REST キャッシュの場合、これは接続タイムアウトと読み取りタイムアウトの両方です。使用できる単位は、日(d)、時間(h)、分(m)、秒(s)、ミリ秒(ms)です。単位を省略すると、値は秒とみなされます。
--[no]remote_upload_local_results
のデフォルト: "true"- リモートで実行され、ユーザーが権限が付与されている場合に、ローカルで実行されたアクションの結果をリモート キャッシュにアップロードするかどうかを指定します。
--[no]remote_verify_downloads
のデフォルト: "true"- true に設定すると、Bazel はすべてのリモート ダウンロードのハッシュの合計を計算し、リモートにキャッシュされた値が想定値と一致しない場合は破棄します。
- その他のオプション: 特に分類しない場合。
- 複数の
--build_metadata=<a 'name=value' assignment>
が累計されます - ビルドイベントで指定するカスタムの Key-Value 文字列ペアです。
タグ:terminal_output
--color=<yes, no or auto>
: 「自動」- ターミナル コントロールを使用して、出力に色を付けます。
- 複数の
--config=<a string>
が累計されます - rc ファイルから追加の config セクションを選択します。<command> ごとに、<command>:<config> からオプションが取り込まれます(このセクションが .rc ファイルに存在しない場合、Blaze はエラーになります)。同等の構成セクションとフラグの組み合わせは、tools/*.blazerc 構成ファイルにあります。
--curses=<yes, no or auto>
: 「自動」- ターミナルのカーソル コントロールを使用して、スクロール出力を最小限に抑えます。
--disk_cache=<a path>
: 説明を表示- Bazel がアクションとアクション出力の読み取りと書き込みを行えるディレクトリのパス。ディレクトリが存在しない場合は、作成されます。
--[no]enable_platform_specific_config
: 「false」- true の場合、Bazel は bazelrc ファイルから host-OS 固有の構成行を選択します。たとえば、ホスト OS が Linux で bazel build を実行すると、Bazel は build:linux で始まる行を取得します。サポートされている OS ID は、Linux、macos、windows、freebsd、openbsd です。このフラグを有効にすると、Linux では --config=linux、Windows では --config=windows を使用する場合と同等になります。
- 複数の
--experimental_credential_helper=<Path to a credential helper. It may be absolute, relative to the PATH environment variable, or %workspace%-relative. The path be optionally prefixed by a scope followed by an '='. The scope is a domain name, optionally with a single leading '*' wildcard component. A helper applies to URIs matching its scope, with more specific scopes preferred. If a helper has no scope, it applies to every URI.>
が累計されます - リポジトリの取得、リモート キャッシュと実行、ビルド イベント サービスの認証情報を取得するために使用する認証ヘルパーを構成します。 ヘルパーから提供された認証情報は、--google_default_credentials、--google_credentials、.netrc ファイル、または repository_ctx.download と repository_ctx.download_and_extract の auth パラメータで提供される認証情報よりも優先されます。 複数のヘルパーを設定するために複数回指定できます。詳しくは、https://github.com/bazelbuild/Proposals/blob/main/designs/2022-06-07-bazel-credential-helpers.md をご覧ください。
--experimental_credential_helper_cache_duration=<An immutable length of time.>
: 「30m」- 認証情報ヘルパーから提供された認証情報がキャッシュに保存される期間。 別の値で呼び出すと、既存のエントリの存続期間が調整されます。キャッシュをクリアするには、ゼロを渡します。クリーン コマンドでは、このフラグに関係なく、常にキャッシュがクリアされます。
--experimental_credential_helper_timeout=<An immutable length of time.>
のデフォルト: 「10s」- 認証ヘルパーのタイムアウトを構成します。 認証情報ヘルパーがこのタイムアウト内に応答しなかった場合、呼び出しは失敗します。
--[no]experimental_skymeld_ui
: 「false」-
分析フェーズと実行フェーズの両方の進行状況(実行と同時に実行された場合)を表示します。
タグ:terminal_output
--[no]experimental_windows_watchfs
: 「false」- true の場合、--watchfs に対する試験運用版の Windows サポートは有効になっています。それ以外の場合、Windows では --watchfsis no-op。--watchfs も有効にします。
--google_auth_scopes=<comma-separated list of options>
のデフォルト: https://www.googleapis.com/auth/cloud-platform- Google Cloud 認証スコープのカンマ区切りリスト。
--google_credentials=<a string>
: 説明を表示- 認証情報を取得するファイルを指定します。詳しくは、https://cloud.google.com/docs/authentication をご覧ください。
--[no]google_default_credentials
: 「false」- 認証に「Google アプリケーションのデフォルト認証情報」を使用するかどうかを指定します。詳しくは、https://cloud.google.com/docs/authentication をご覧ください。デフォルトで無効。
--grpc_keepalive_time=<An immutable length of time.>
: 説明を表示- gRPC 送信接続のキープアライブ ping を構成します。これが設定されている場合、Bazel は接続に対して読み取りオペレーションが行われない時間が経過すると ping を送信しますが、保留中の gRPC 呼び出しが 1 つ以上ある場合に限られます。時間の設定は 1 秒未満です。1 秒未満の値を設定するとエラーになります。デフォルトでは、キープアライブ ping は無効になっています。この設定を有効にする前に、サービス オーナーと調整してください。たとえば、このフラグに 30 秒の値を設定するには、--grpc_keepalive_time=30s を使用します。
--grpc_keepalive_timeout=<An immutable length of time.>
: 「20 秒」- gRPC 送信接続のキープアライブ タイムアウトを構成します。キープアライブ ping が --grpc_keepalive_time で有効になっている場合、この期間が経過した後に ping が返信されない場合は、Bazel で接続がタイムアウトします。時間の設定は 1 秒未満です。1 秒未満の値を設定するとエラーになります。キープアライブ ping が無効になっている場合、この設定は無視されます。
--[no]incompatible_disallow_symlink_file_to_dir
のデフォルト: "true"-
true に設定すると、「ctx.actions.symlink」はファイルをディレクトリにシンボリック リンクできないようにします。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_remove_rule_name_parameter
のデフォルト: "true"-
true に設定すると、「name」パラメータで「rule」を呼び出すことができません。
タグ:loading_and_analysis
、incompatible_change
--[no]progress_in_terminal_title
: 「false」- ターミナルのタイトルにコマンドの進行状況を表示します。複数のターミナルタブがある場合に、Bazel の動作を確認するのに役立ちます。
--[no]show_progress
のデフォルト: "true"- ビルド中の進行状況メッセージを表示します。
--show_progress_rate_limit=<a double>
: 0.2- 出力内の進行状況メッセージ間の最小秒数。
--[no]show_timestamps
: 「false」- メッセージにタイムスタンプを含める
--tls_certificate=<a string>
: 説明を表示- サーバー証明書への署名が信頼できる TLS 証明書へのパスを指定します。
--tls_client_certificate=<a string>
: 説明を表示- 使用する TLS クライアント証明書を指定します。クライアント認証を有効にするには、クライアント キーも指定する必要があります。
--tls_client_key=<a string>
: 説明を表示- 使用する TLS クライアント鍵を指定します。クライアント認証を有効にする場合は、クライアント証明書も指定する必要があります。
--ui_actions_shown=<an integer>
: 「8」-
詳細の進行状況バーに表示される同時アクションの数です。各アクションは個別の行に表示されます。進行状況バーには常に 1 つ以上のフィールドが表示され、1 未満の数値はすべて 1 にマッピングされます。
タグ:terminal_output
--[no]watchfs
: 「false」- Linux/macOS: true の場合、bazel は、変更がないかすべてのファイルをスキャンするのではなく、オペレーティング システムのファイル ウォッチサービスを使用してローカルの変更を試みます。Windows の場合: このフラグは現在 NOP ではありませんが、--experimental_windows_watchfs と組み合わせて使用できます。任意の OS: ワークスペースがネットワーク ファイル システム上にあり、ファイルがリモートマシンで編集されている場合、動作は未定義になります。
分析プロファイルのオプション
- コマンドの前に表示され、クライアントによって解析されるオプション:
- 複数の
--distdir=<a path>
が累計されます -
ネットワークにアクセスする前にアーカイブを検索できる追加の場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュはコピーではなくファイルをハードリンクします。これはディスク容量を節約することを目的としています。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
: 「false」-
true の場合、指定されていない場合は、リポジトリのダウンロードの URL から派生した文字列を canonical_id として使用します。これにより、キャッシュにハッシュが同じであっても、URL が変更されると再ダウンロードが発生します。これを使用して、URL の変更によって破損したリポジトリがキャッシュによってマスクされないことを確認できます。
タグ:loading_and_analysis
、experimental
--experimental_repository_downloader_retries=<an integer>
のデフォルト: "0"-
ダウンロード エラーを再試行する最大回数。0 に設定すると、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: "1.0"-
この要因により、Starlark リポジトリ ルールのすべてのタイムアウトをスケーリングします。このように、ソースコードを変更しなくても、ルールの作成者が想定したよりも遅いマシンで外部リポジトリを作成できます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: "0s"-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にすると、タイムアウトは定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: "1.0"-
特定の要因による HTTP ダウンロードに関連するすべてのタイムアウトをスケーリングします。
タグ:bazel_internal_configuration
--repository_cache=<a path>
: 説明を表示-
外部リポジトリの取得時に取得した、ダウンロードした値のキャッシュの場所を指定します。引数に空の文字列がある場合は、キャッシュの無効化をリクエストします。そうでなければ、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
: 「false」-
設定した場合、ctx.download{,_and_extract} を使用したダウンロードはリポジトリの取得時に許可されません。なお、ネットワーク アクセスが完全に無効というわけではなく、ctx.execute はインターネットにアクセスする任意の実行可能ファイルを実行します。
タグ:bazel_internal_configuration
- ビルド実行を制御するオプション:
--experimental_oom_more_eagerly_threshold=<an integer in 0-100 range>
: 「100」-
このフラグが 100 より小さい値に設定されている場合、2 つの完全な GC の後も(この古い世代の)ヒープの占有率がこの割合を超えると、Bazel は OOM を行います。タグ:
host_machine_resource_optimizations
- Bazel による有効なビルド入力の厳格化に影響するオプション(ルール定義、フラグの組み合わせなど)
--experimental_repository_hash_file=<a string>
のデフォルト: "-
空でない場合、リポジトリ ディレクトリのハッシュを検証する必要がある値を含むファイルを指定します。
タグ:affects_outputs
、experimental
- 複数の
--experimental_verify_repository_rules=<a string>
が累計されます -
出力ディレクトリのハッシュを検証する必要があるリポジトリ ルールのリストの場合、ファイルは --experimental_repository_hash_file で指定します。
タグ:affects_outputs
、experimental
--[no]experimental_allow_top_level_aspects_parameters
のデフォルト: "true"-
No-op
タグ:no_op
、deprecated
、experimental
- 複数の
--allow_yanked_versions=<a string>
が累計されます -
モジュール バージョンは、発生元であるレジストリで(NonRegistryOverride のもの以外から)yanked が宣言されている場合でも、解決された依存関係グラフで許可する「<module1>@<version1>,<module2>@<version2>」の形式で指定します。そうしないと、ジャンクされたバージョンが原因で解決に失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可される yanked バージョンを定義することもできます。このチェックを無効にするには、キーワード「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 の場合、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」は無視されます。このフラグの値に関係なく、MODULE.bazel がルート モジュールでない場合、これらの dev 依存関係は常に無視されます。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: "off"-
ロックファイルを使用するかどうかを指定します。有効な値は、lockfile を使用して更新する場合は「update」、変更がある場合は「lock」、最新ではない場合はエラーをスローし、lockfile からの読み取りと書き込みを行わない場合は「off」です。
タグ:loading_and_analysis
- 複数の
--override_module=<an equals-separated mapping of module name to path>
が累計されます - <module name>=<path> の形式のローカルパスでモジュールをオーバーライドします。指定されたパスが絶対パスである場合、そのパスが使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリへの相対パスになります。パスが %workspace% で始まる場合は、ワークスペースのルート(「bazel info workspace」の出力)への相対パスになります。
- 複数の
--registry=<a string>
が累計されます -
Bazel モジュールの依存関係を見つけるために使用するレジストリを指定します。順序は重要です。つまり、最初に古いレジストリでモジュールが検索され、以前のレジストリに欠落している場合にのみ、後続のレジストリにフォールバックします。
タグ:changes_inputs
--experimental_gc_thrashing_limits=<comma separated pairs of <period>:<count>>
のデフォルト: "-
到達した場合、GcThrashingDetector が OOM で Bazel をクラッシュさせる制限。それぞれの上限は <period>:<count> と指定します。period は期間、count は正の整数です。<period> 内に <count> 個の連続した GC が続くと、在室スペース(古い世代のヒープ)の --experimental_oom_more_eagerly_threshold パーセントを超えると、OOM がトリガーされます。複数の上限をカンマ区切りで指定できます。
タグ:host_machine_resource_optimizations
--[no]gc_thrashing_limits_retained_heap_limiter_mutually_exclusive
のデフォルト: "true"-
true の場合、空でない --experimental_gc_thrashing_limits を指定すると、RetainedHeapLimiter が非アクティブになり、GcThrashingDetector と相互に排他的になります。false に設定すると、同じコマンドで両方ともアクティブになります。
タグ: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 で設定されたしきい値を超えたことを検出した場合、呼び出しごとに最大回数の不完全な一時的な 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 状態を削除します。これを微調整することで、(i)GC スラッシングが(i)この一時的な状態のメモリ使用に起因し、(ii)必要になったときに状態を再構築するよりもコストが高くなる場合に、GC スラッシングのウォールタイムの影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
--dump=<text or raw>
[-d
] デフォルト: 説明を参照してください- は、人間が読み取れる「テキスト」形式またはスクリプト フレンドリーな「未加工」形式で、完全なプロファイル データダンプを出力します。
タグ:affects_outputs
--[no]experimental_command_profile
: 「false」- Java Flight Recorder の CPU プロファイルを出力ベース ディレクトリの profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプまたは出力形式をサポートするように将来変更される場合があります。自己責任で使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
: 「false」- デフォルトでは、アクション タイプの数は、実行されているアクションの数が最も多い 20 ニーモニックに制限されます。このオプションを設定すると、すべての覚え書きの統計情報が書き込まれます。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: "-
空白でない場合は、WORKSPACE ファイルではなく指定された解決済みファイルを読み込みます。
タグ:changes_inputs
--experimental_downloader_config=<a string>
: 説明を表示- リモート ダウンローダを構成するファイルを指定します。このファイルは、各行がディレクティブ(allow、block、rewrite)で始まり、その後にホスト名(allow と block)または 2 つのパターン(一致するもの、代替 URL として使用するもの)が続きます。$1 で始まるバック参照、つまり、複数の URL の REC ディレクティブによって試行できます。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: "off"- リポジトリの取得に使用するスレッドモード。「off」に設定した場合、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、プラットフォーム スレッド(OS スレッドなど)を「platform」に設定するか、仮想スレッドを「virtual」に設定します。
- 複数の
--override_repository=<an equals-separated mapping of repository name to path>
が累計されます - リポジトリを <リポジトリ名>=<パス> の形式でローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスが使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリへの相対パスになります。指定したパスが %workspace% で始まる場合は、ワークスペースのルート(`bazel info workspace`の出力)に対する相対パスになります。
- 複数の
--distdir=<a path>
が累計されます -
ネットワークにアクセスする前にアーカイブを検索できる追加の場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュはコピーではなくファイルをハードリンクします。これはディスク容量を節約することを目的としています。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
: 「false」-
true の場合、指定されていない場合は、リポジトリのダウンロードの URL から派生した文字列を canonical_id として使用します。これにより、キャッシュにハッシュが同じであっても、URL が変更されると再ダウンロードが発生します。これを使用して、URL の変更によって破損したリポジトリがキャッシュによってマスクされないことを確認できます。
タグ:loading_and_analysis
、experimental
--experimental_repository_downloader_retries=<an integer>
のデフォルト: "0"-
ダウンロード エラーを再試行する最大回数。0 に設定すると、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: "1.0"-
この要因により、Starlark リポジトリ ルールのすべてのタイムアウトをスケーリングします。このように、ソースコードを変更しなくても、ルールの作成者が想定したよりも遅いマシンで外部リポジトリを作成できます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: "0s"-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にすると、タイムアウトは定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: "1.0"-
特定の要因による HTTP ダウンロードに関連するすべてのタイムアウトをスケーリングします。
タグ:bazel_internal_configuration
--repository_cache=<a path>
: 説明を表示-
外部リポジトリの取得時に取得した、ダウンロードした値のキャッシュの場所を指定します。引数に空の文字列がある場合は、キャッシュの無効化をリクエストします。そうでなければ、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
: 「false」-
設定した場合、ctx.download{,_and_extract} を使用したダウンロードはリポジトリの取得時に許可されません。なお、ネットワーク アクセスが完全に無効というわけではなく、ctx.execute はインターネットにアクセスする任意の実行可能ファイルを実行します。
タグ:bazel_internal_configuration
--experimental_oom_more_eagerly_threshold=<an integer in 0-100 range>
: 「100」-
このフラグが 100 より小さい値に設定されている場合、2 つの完全な GC の後も(この古い世代の)ヒープの占有率がこの割合を超えると、Bazel は OOM を行います。タグ:
host_machine_resource_optimizations
--experimental_repository_hash_file=<a string>
のデフォルト: "-
空でない場合、リポジトリ ディレクトリのハッシュを検証する必要がある値を含むファイルを指定します。
タグ:affects_outputs
、experimental
- 複数の
--experimental_verify_repository_rules=<a string>
が累計されます -
出力ディレクトリのハッシュを検証する必要があるリポジトリ ルールのリストの場合、ファイルは --experimental_repository_hash_file で指定します。
タグ:affects_outputs
、experimental
--[no]experimental_allow_top_level_aspects_parameters
のデフォルト: "true"-
No-op
タグ:no_op
、deprecated
、experimental
--aspect_deps=<off, conservative or precise>
デフォルト: 「慎重」-
出力形式が {xml,proto,record} の場合にアスペクトの依存関係を解決する方法。「off」は、アスペクトの依存関係が解決されないことを意味します。「aservative」(デフォルト)は、直接的な依存関係のルールクラスが与えられているかどうかに関係なく、宣言されたすべてのアスペクトの依存関係が追加されることを意味します。「recise」は、直接的な依存関係のルールクラスに対してアクティブである可能性があるそれらのアスペクトのみが追加されることを意味します。正確なモードでは、1 つのターゲットを評価するには他のパッケージを読み込む必要があるため、他のモードよりも遅くなります。また、正確なモードでなくても、完全に正確というわけではありません。アスペクトを計算するかどうかは、分析フェーズで決まります。分析フェーズは、「bazel query」の実行時には実行されません。
タグ:build_file_semantics
--[no]deduplicate_depsets
のデフォルト: "true"-
最終的な proto/textproto/json 出力で、dep_set_of_files のリーフ以外の子の重複を除去します。即時の親を共有しないデップの重複除去は除去されません。これは、アクションの入力アーティファクトの最終的な有効なリストには影響しません。
タグ:terminal_output
--[no]experimental_parallel_aquery_output
: 「false」- クエリ proto/textproto の出力を並行して記述するかどうか。他の出力形式では何も処理されません。
--[no]graph:factored
のデフォルト: "true"-
true の場合、グラフは「因数分解」されます。つまり、トポロジ的に同等のノードは結合され、そのラベルが連結されます。このオプションは、--output=graph にのみ適用されます。
タグ:terminal_output
--graph:node_limit=<an integer>
のデフォルト: "512"-
出力内のグラフノードのラベル文字列の最大長。長いラベルは切り捨てられます。-1 を指定すると、切り捨てられません。このオプションは、--output=graph にのみ適用されます。
タグ:terminal_output
--[no]implicit_deps
のデフォルト: "true"-
有効にすると、クエリが動作する依存関係グラフに暗黙的な依存関係が含まれます。暗黙的な依存関係とは、BUILD ファイルで明示的に指定されておらず、bazel によって追加されている依存関係です。cquery の場合、このオプションは解決済みのツールチェーンのフィルタリングを制御します。
タグ:build_file_semantics
--[no]include_artifacts
のデフォルト: "true"- 出力にアクションの入力と出力の名前が含まれます(サイズが大きい可能性があります)。
タグ:terminal_output
--[no]include_aspects
のデフォルト: "true"- aquery, cquery: アスペクトで生成されたアクションを出力に含めるかどうか。query: no-op(アスペクトは必ず従います)。
タグ:terminal_output
--[no]include_commandline
のデフォルト: "true"- 出力にアクション コマンドラインの内容が含まれます(サイズが大きい可能性があります)。
タグ:terminal_output
--[no]include_file_write_contents
: 「false」-
FileWrite アクションと SourceSymlinkManifest アクション(サイズが大きくなる可能性があります)のファイルの内容を含めます。
タグ:terminal_output
--[no]include_param_files
: 「false」-
コマンドで使用されるパラメータ ファイルの内容を含めます(大きくなる可能性があります)。注: このフラグを有効にすると、--include_commandline フラグが自動的に有効になります。
タグ:terminal_output
--[no]incompatible_display_source_file_location
のデフォルト: "true"-
デフォルトでは true であり、ソースファイルのターゲットが表示されます。true の場合、場所の出力にソースファイルの 1 行目の場所を表示します。このフラグは移行の目的でのみ存在します。
タグ:terminal_output
、incompatible_change
--[no]incompatible_package_group_includes_double_slash
のデフォルト: "true"-
有効にすると、package_group の 'packages' 属性の出力時に、先頭の `//` が省略されません。
タグ:terminal_output
、incompatible_change
--[no]infer_universe_scope
: 「false」-
設定されていて --universe_scope が設定されていない場合、クエリ式の一意のターゲット パターンのリストとして --universe_scope の値が推定されます。ユニバース スコープ関数(allrdeps など)を使用するクエリ式に対して推測された --universe_scope 値は、望ましくない場合があります。そのため、このオプションは使用する処理がわかっている場合にのみ使用してください。詳細と例については、https://bazel.build/reference/query#sky-query をご覧ください。--universe_scope が設定されている場合、このオプションの値は無視されます。注: このオプションは「query」にのみ適用されます(つまり「cquery」には適用されません)。
タグ:loading_and_analysis
--[no]line_terminator_null
: 「false」- 各形式が改行ではなく \0 で終結しているかどうか。
タグ:terminal_output
--[no]nodep_deps
のデフォルト: "true"-
有効にすると、「nodep」属性の依存関係は、クエリが動作する依存関係グラフに含まれます。「nodep」属性の一般的な例は「visibility」です。「info build-language」の出力を実行して解析し、ビルド言語のすべての「nodep」属性を確認します。
タグ:build_file_semantics
--output=<a string>
のデフォルト: "text"-
クエリ結果を出力する形式。aquery で使用できる値は、text、textproto、proto、streamed_proto、jsonproto です。
タグ:terminal_output
--[no]proto:default_values
のデフォルト: "true"-
true の場合、値が BUILD ファイルで明示的に指定されていない属性は無視されます。このオプションは、--output=proto に適用できます。
タグ:terminal_output
--[no]proto:definition_stack
: 「false」-
define_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>
: 「すべて」-
出力に含める属性のカンマ区切りのリスト。デフォルトはすべての属性です。属性を出力しない場合は、空の文字列に設定します。このオプションは --output=proto に適用できます。
タグ:terminal_output
--[no]proto:rule_inputs_and_outputs
のデフォルト: "true"-
rule_input フィールドと rule_output フィールドに値を設定するかどうかを指定します。
タグ:terminal_output
--query_file=<a string>
のデフォルト: "-
設定すると、クエリはコマンドラインではなくここで指定したファイルから読み込まれます。ここでは、ファイルとコマンドライン クエリを指定するとエラーが発生します。
タグ:changes_inputs
--[no]relative_locations
: 「false」-
true の場合、xml と proto の出力に含まれる BUILD ファイルの場所は相対パスになります。デフォルトでは、ロケーション出力は絶対パスで、マシン間で一貫していません。このオプションを true に設定すると、マシン間で一貫した結果を得ることができます。
タグ:terminal_output
--[no]skyframe_state
: 「false」-
追加の分析を行わずに、現在のアクション グラフを Skyframe からダンプします。注: 現在、--skyframe_state を使用してターゲットを指定することはできません。このフラグは、--output=proto または --output=textproto でのみ使用できます。
タグ:terminal_output
--[no]tool_deps
のデフォルト: "true"-
クエリ: 無効の場合、「exec 構成」への依存関係はクエリが動作する依存関係グラフには含まれません。「exec 構成」の依存関係のエッジ(プロトコル コンパイラの「proto_library」ルールなど)は、通常、同じ「ターゲット」プログラムの一部ではなく、ビルド中に実行されるツールを参照します。
Cquery: 無効に設定した場合、この構成ターゲットを検出した最上位ターゲットから、実行遷移を超えるすべての構成ターゲットが除外されます。つまり、トップレベルのターゲットがターゲット構成にある場合、ターゲット構成でも構成済みのターゲットのみが返されます。トップレベル ターゲットが exec 構成に含まれている場合は、exec 構成ターゲットのみが返されます。このオプションでは、解決済みのツールチェーンは除外されません。
タグ:build_file_semantics
--universe_scope=<comma-separated list of options>
のデフォルト: "-
対象のパターン(追加と減算)のカンマ区切りのセット。クエリは、指定したターゲットの推移的な閉鎖によって定義されるユニバースで実行できます。このオプションは、クエリコマンドと cquery コマンドで使用されます。cquery の場合、このオプションへの入力はすべての回答の基となるターゲットであるため、このオプションは構成と遷移に影響を与える可能性があります。このオプションが指定されていない場合、トップレベル ターゲットはクエリ式から解析されたターゲットとみなされます。注: cquery でこのオプションを指定しないと、クエリ式から解析されたターゲットがトップレベル オプションでビルドできない場合、ビルドが破損する可能性があります。
タグ:loading_and_analysis
- 複数の
--allow_yanked_versions=<a string>
が累計されます -
モジュール バージョンは、発生元であるレジストリで(NonRegistryOverride のもの以外から)yanked が宣言されている場合でも、解決された依存関係グラフで許可する「<module1>@<version1>,<module2>@<version2>」の形式で指定します。そうしないと、ジャンクされたバージョンが原因で解決に失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可される yanked バージョンを定義することもできます。このチェックを無効にするには、キーワード「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 の場合、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」は無視されます。このフラグの値に関係なく、MODULE.bazel がルート モジュールでない場合、これらの dev 依存関係は常に無視されます。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: "off"-
ロックファイルを使用するかどうかを指定します。有効な値は、lockfile を使用して更新する場合は「update」、変更がある場合は「lock」、最新ではない場合はエラーをスローし、lockfile からの読み取りと書き込みを行わない場合は「off」です。
タグ:loading_and_analysis
- 複数の
--override_module=<an equals-separated mapping of module name to path>
が累計されます - <module name>=<path> の形式のローカルパスでモジュールをオーバーライドします。指定されたパスが絶対パスである場合、そのパスが使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリへの相対パスになります。パスが %workspace% で始まる場合は、ワークスペースのルート(「bazel info workspace」の出力)への相対パスになります。
- 複数の
--registry=<a string>
が累計されます -
Bazel モジュールの依存関係を見つけるために使用するレジストリを指定します。順序は重要です。つまり、最初に古いレジストリでモジュールが検索され、以前のレジストリに欠落している場合にのみ、後続のレジストリにフォールバックします。
タグ:changes_inputs
--experimental_gc_thrashing_limits=<comma separated pairs of <period>:<count>>
のデフォルト: "-
到達した場合、GcThrashingDetector が OOM で Bazel をクラッシュさせる制限。それぞれの上限は <period>:<count> と指定します。period は期間、count は正の整数です。<period> 内に <count> 個の連続した GC が続くと、在室スペース(古い世代のヒープ)の --experimental_oom_more_eagerly_threshold パーセントを超えると、OOM がトリガーされます。複数の上限をカンマ区切りで指定できます。
タグ:host_machine_resource_optimizations
--[no]gc_thrashing_limits_retained_heap_limiter_mutually_exclusive
のデフォルト: "true"-
true の場合、空でない --experimental_gc_thrashing_limits を指定すると、RetainedHeapLimiter が非アクティブになり、GcThrashingDetector と相互に排他的になります。false に設定すると、同じコマンドで両方ともアクティブになります。
タグ: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 で設定されたしきい値を超えたことを検出した場合、呼び出しごとに最大回数の不完全な一時的な 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 状態を削除します。これを微調整することで、(i)GC スラッシングが(i)この一時的な状態のメモリ使用に起因し、(ii)必要になったときに状態を再構築するよりもコストが高くなる場合に、GC スラッシングのウォールタイムの影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
--[no]experimental_command_profile
: 「false」- Java Flight Recorder の CPU プロファイルを出力ベース ディレクトリの profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプまたは出力形式をサポートするように将来変更される場合があります。自己責任で使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
: 「false」- デフォルトでは、アクション タイプの数は、実行されているアクションの数が最も多い 20 ニーモニックに制限されます。このオプションを設定すると、すべての覚え書きの統計情報が書き込まれます。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: "-
空白でない場合は、WORKSPACE ファイルではなく指定された解決済みファイルを読み込みます。
タグ:changes_inputs
--experimental_downloader_config=<a string>
: 説明を表示- リモート ダウンローダを構成するファイルを指定します。このファイルは、各行がディレクティブ(allow、block、rewrite)で始まり、その後にホスト名(allow と block)または 2 つのパターン(一致するもの、代替 URL として使用するもの)が続きます。$1 で始まるバック参照、つまり、複数の URL の REC ディレクティブによって試行できます。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: "off"- リポジトリの取得に使用するスレッドモード。「off」に設定した場合、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、プラットフォーム スレッド(OS スレッドなど)を「platform」に設定するか、仮想スレッドを「virtual」に設定します。
- 複数の
--override_repository=<an equals-separated mapping of repository name to path>
が累計されます - リポジトリを <リポジトリ名>=<パス> の形式でローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスが使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリへの相対パスになります。パスが %workspace% で始まる場合は、ワークスペースのルート(bazel info workspace)の出力に対する相対パスになります。
--[no]experimental_inprocess_symlink_creation
: 「false」- シンボリック ツリーを作成するためにファイル システムを直接呼び出すかどうか。
タグ:loading_and_analysis
、execution
、experimental
--[no]experimental_remotable_source_manifests
: 「false」-
ソース マニフェストのアクションをリモート可能にするかどうか
タグ:loading_and_analysis
、execution
、experimental
--[no]experimental_split_coverage_postprocessing
: 「false」-
true の場合、Bazel は新しいスポーンでテストのためにカバレッジ後処理を実行します。
タグ:execution
--[no]experimental_strict_fileset_output
: 「false」-
このオプションを有効にすると、ファイルセットはすべての出力アーティファクトを通常のファイルとして扱います。ディレクトリを走査したり、シンボリック リンクに敏感だったりすることはありません。
タグ:execution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
のデフォルト: "-
アクションの覚え方に基づいて、アクションの実行情報に対してキーを追加または削除します。実行情報をサポートするアクションにのみ適用されます。一般的なアクションの多くには、実行情報がサポートされています(Genrule、CppCompile、Javac、StarlarkAction、TestRunner など)。複数の正規表現を指定する場合は、同じ正規表現に多くの正規表現が適用される可能性があるため、順序が重要です。構文: "regex=[+-]key,regex=[+-]key,..."例:
.*=+x,.*=-y,.*=+z「Genrule=+requires-x」は、すべての Genrule アクションの実行情報に「requires-x」を追加します。
'??Genrule).*=-requires-x' により、すべての Genrule 以外のアクションの実行情報から「requires-x」が削除されます。
タグ:execution
、affects_outputs
、loading_and_analysis
--persistent_android_dex_desugar
-
ワーカーを使用して永続的な Android dex と desugar のアクションを有効にします。
以下に展開:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
タグ:host_machine_resource_optimizations
、execution
--persistent_android_resource_processor
- ワーカーを使用して、永続的な Android リソース プロセッサを有効にします。
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--internal_persistent_busybox_tools
2{1/1}--strategy=Aapt2Optimize=worker
1{1/1}--strategy=AARGenerator=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_desugar
- ワーカーを使用して、永続的な多重化 Android dex と desugar アクションを有効にします。
以下に展開:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
タグ:host_machine_resource_optimizations
、execution
--persistent_multiplex_android_resource_processor
-
ワーカーを使用して、永続的な多重化 Android リソース プロセッサを有効にします。
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--persistent_android_resource_processor
2{1/1}--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
1{1/2}--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
- 永続的で多重化した Android ツール(dex 変換、脱糖、リソース処理)を有効にします。
以下に展開:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
タグ:host_machine_resource_optimizations
、execution
--[no]use_target_platform_for_tests
: 「false」-
true の場合、Bazel はテスト実行グループではなく、ターゲット プラットフォームを使用してテストを実行します。
タグ:execution
--android_compiler=<a string>
: 説明を表示-
Android ターゲット コンパイラ。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--android_crosstool_top=<a build target label>
のデフォルト: "//external:android/crosstool"-
Android ビルドに使用される C++ コンパイラの場所。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
、loses_incremental_state
--android_grte_top=<a label>
: 説明を表示-
Android ターゲット grte_top。
タグ:changes_inputs
、loading_and_analysis
、loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
のデフォルト: "android"-
android_binary ルールに使用するマニフェスト マージツールを選択します。レガシーのマージツールから Android マニフェストのマージツールへの移行に役立つフラグ。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--android_platforms=<a build target label>
のデフォルト: "-
android_binary ターゲットが使用するプラットフォームを設定します。複数のプラットフォームが指定されている場合、バイナリはファット APK であり、指定された各ターゲット プラットフォームのネイティブ バイナリが含まれています。
タグ:changes_inputs
、loading_and_analysis
、loses_incremental_state
--android_sdk=<a build target label>
のデフォルト: "@bazel_tools//tools/android:sdk"- Android アプリのビルドに使用する Android SDK/プラットフォームを指定します。
タグ:changes_inputs
、loading_and_analysis
、loses_incremental_state
--apple_compiler=<a string>
: 説明を表示-
Apple ターゲット コンパイラ。ツールチェーンのバリアント(xcode-beta など)を選択する場合に役立ちます。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--apple_crosstool_top=<a build target label>
のデフォルト: "@bazel_tools//tools/cpp:ツールチェーン"-
Apple ルールと Objc ルール、およびその依存関係で使用される crosstool パッケージのラベル。
タグ:loses_incremental_state
、changes_inputs
--apple_grte_top=<a build target label>
: 説明を表示-
Apple ターゲット grte_top。
タグ:changes_inputs
、loading_and_analysis
、loses_incremental_state
--cc_output_directory_tag=<a string>
のデフォルト: "- 構成ディレクトリに追加するサフィックスを指定します。
タグ:affects_outputs
、explicit_in_output_path
--compiler=<a string>
: 説明を表示-
ターゲットのコンパイルに使用する C++ コンパイラ。
タグ:loading_and_analysis
、execution
--coverage_output_generator=<a build target label>
のデフォルト: "@bazel_tools//tools/test:lcov_merger"- 未加工のカバレッジ レポートの後処理に使用されるバイナリの場所。現在は、単一のファイル(バイナリ)を含むファイル グループである必要があります。デフォルトは「//tools/test:lcov_merger」です。
タグ:changes_inputs
、affects_outputs
、loading_and_analysis
--coverage_report_generator=<a build target label>
のデフォルト: "@bazel_tools//tools/test:coverage_report_generator"-
カバレッジ レポートの生成に使用されるバイナリの場所。現在は、単一のファイル(バイナリ)を含むファイル グループである必要があります。デフォルトは「//tools/test:coverage_report_generator」です。
タグ:changes_inputs
、affects_outputs
、loading_and_analysis
--coverage_support=<a build target label>
のデフォルト: "@bazel_tools//tools/test:coverage_support"-
コード カバレッジを収集するすべてのテスト アクションの入力に必要なサポート ファイルの場所。デフォルトは「//tools/test:coverage_support」です。
タグ:changes_inputs
、affects_outputs
、loading_and_analysis
--crosstool_top=<a build target label>
のデフォルト: "@bazel_tools//tools/cpp:ツールチェーン"-
C++ コードのコンパイルに使用する crosstool パッケージのラベル。
タグ:loading_and_analysis
、changes_inputs
、affects_outputs
--custom_malloc=<a build target label>
: 説明を表示-
malloc のカスタム実装を指定します。この設定により、ビルドルールの malloc 属性がオーバーライドされます。
タグ:changes_inputs
、affects_outputs
- 複数の
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
が累計されます -
カンマ区切りの正規表現のリスト。先頭に -(負の式)を付加し、制約値のターゲットのカンマ区切りのリストに代入します。ターゲットが負の式に一致せず、少なくとも 1 つの正の式に一致する場合、ツールチェーンの解決は、制約の値を実行の制約として宣言した場合と同様に実行されます。例: //demo,-test=@platforms//cpus:x86_64 は、名前に 'test' が含まれているものを除き、//demo の下にあるすべてのターゲットに 'x86_64' を追加します。
タグ:loading_and_analysis
--[no]experimental_enable_objc_cc_deps
のデフォルト: "true"-
ob_c_* ルールを cc_library に依存させ、--ios_multi_cpu の値に対して --cpu を "ios_<--ios_cpu" に設定してすべての objc 依存関係をビルドできます。
タグ:loading_and_analysis
、incompatible_change
--[no]experimental_include_xcode_execution_requirements
: 「false」-
設定した場合、Xcode のすべてのアクションに「requires-xcode:{version}」の実行要件を追加します。xcode バージョンにハイフンが使用されている場合は、requires-xcode-label:{version_label} の実行要件も追加します。
タグ:loses_incremental_state
、loading_and_analysis
、execution
--[no]experimental_prefer_mutual_xcode
のデフォルト: "true"-
true の場合、ローカルとリモートの両方で利用可能な最新の Xcode を使用します。false であるか、相互利用可能なバージョンがない場合は、xcode-select を介して選択されたローカル Xcode バージョンを使用します。
タグ:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
のデフォルト: "-
アクションの実行プラットフォームとして使用可能なプラットフォーム。プラットフォームは、正確なターゲットによって、またはターゲット パターンとして指定できます。これらのプラットフォームは、register_execution_platforms() によって WORKSPACE ファイルで宣言されたものよりも先に考慮されます。このオプションは 1 回だけ設定できます。後のインスタンスは以前のフラグ設定をオーバーライドします。
タグ:execution
- 複数の
--extra_toolchains=<comma-separated list of options>
が累計されます -
ツールチェーンの解決で考慮されるツールチェーン ルール。ツールチェーンは、正確なターゲットまたはターゲット パターンとして指定できます。これらのツールチェーンは、register_artifacts() によって WORKSPACE ファイルで宣言される前に適用されます。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
--grte_top=<a label>
: 説明を表示-
チェックインされた libc ライブラリに対するラベル。デフォルト値は crosstool ツールチェーンによって選択されるため、オーバーライドする必要はありません。
タグ:action_command_lines
、affects_outputs
--host_compiler=<a string>
: 説明を表示-
ホスト コンパイルに使用する C++ コンパイラ。--host_crosstool_top が設定されていない場合は無視されます。
タグ:loading_and_analysis
、execution
--host_crosstool_top=<a build target label>
: 説明を表示-
デフォルトでは、exec 構成に --crosstool_top オプションと --compiler オプションも使用されます。このフラグを指定すると、Bazel は指定された crosstool_top にデフォルトの libc とコンパイラを使用します。
タグ:loading_and_analysis
、changes_inputs
、affects_outputs
--host_grte_top=<a label>
: 説明を表示-
指定すると、exec 構成用の libc 最上位ディレクトリ(--grte_top)がオーバーライドされます。
タグ:action_command_lines
、affects_outputs
--host_platform=<a build target label>
のデフォルト: "@local_config_platform//:host"-
ホストシステムを説明するプラットフォーム ルールのラベル。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set
のデフォルト: "true"-
true の場合、Bazel は flag_sets に expand_if_all_available を指定します(移行手順については https://github.com/bazelbuild/bazel/issues/7008 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
のデフォルト: "true"-
true の場合、Bazel は c++ ツールチェーンで「host」機能と「nonhost」機能を有効にしません(詳細については https://github.com/bazelbuild/bazel/issues/7407 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
: 「false」-
ツールチェーンの解決を使用して Android SDK for Android ルールを選択する(Starlark とネイティブ)
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
: 「false」-
ツールチェーンの解決を使用して、Apple SDK 用の Apple SDK(Starlark とネイティブ)を選択します。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
のデフォルト: "true"-
true の場合、Bazel は lto インデックス登録コマンドラインで C++ リンク アクション コマンドラインを再利用しません(詳細については https://github.com/bazelbuild/bazel/issues/6791 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_objc_linking_info_migration
のデフォルト: "true"-
true の場合、ObjC 組み込みルールは、ObjcProvider ではなく CcInfo からリンク情報を取得します。詳細と移行情報については、https://github.com/bazelbuild/bazel/issues/16939 をご覧ください。
タグ:loading_and_analysis
、changes_inputs
、incompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
のデフォルト: "true"-
true の場合、cc_ツールチェーン.cpu 属性と cc_ツールチェーン.compiler 属性が設定されている場合、Bazel はエラーになります(移行手順については https://github.com/bazelbuild/bazel/issues/7075 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_remove_legacy_whole_archive
のデフォルト: "true"-
true の場合、Bazel はデフォルトではライブラリの依存関係全体をアーカイブにリンクしません(移行手順については https://github.com/bazelbuild/bazel/issues/7362 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_require_ctx_in_configure_features
のデフォルト: "true"-
true の場合、Bazel では cc_common.configure_features に 'ctx' パラメータを指定する必要があります(詳細については https://github.com/bazelbuild/bazel/issues/7793 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
-
ツールチェーンでサポートされている場合は、インターフェース共有オブジェクトを使用します。現在は、すべての ELF ツールチェーンでこの設定がサポートされています。
タグ:loading_and_analysis
、affects_outputs
、affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
iOS アプリのビルドに使用する iOS SDK のバージョンを指定します。指定しない場合は、「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_analysis
、affects_outputs
--platform_mappings=<a relative path>
のデフォルト: "-
プラットフォーム ファイルが未設定の場合に使用するプラットフォーム、またはプラットフォームがすでに存在するときに設定するフラグを記述するマッピング ファイルの場所。メインのワークスペースのルートからの相対パスを指定する必要があります。デフォルトは「platform_mappings」です(ワークスペース ルートの直下にあるファイル)。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
--platforms=<a build target label>
のデフォルト: "-
現在のコマンドのターゲット プラットフォームを示すプラットフォーム ルールのラベル。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
--python2_path=<a string>
: 説明を表示-
非推奨。no-op。「--compatible_use_python_ツールチェーン」により無効になっています。
タグ:no_op
、deprecated
--python3_path=<a string>
: 説明を表示-
非推奨。no-op。「--compatible_use_python_ツールチェーン」により無効になっています。
タグ:no_op
、deprecated
--python_path=<a string>
: 説明を表示-
ターゲット プラットフォームで Python ターゲットを実行するために呼び出される Python インタープリタの絶対パス。非推奨。--compatible_use_python_ツールチェーン s により無効にされました。
タグ:loading_and_analysis
、affects_outputs
--python_top=<a build target label>
: 説明を表示-
ターゲット プラットフォームで Python ターゲットを実行するために呼び出された Python インタープリタを表す py_runtime のラベル。非推奨。--compatible_use_python_ツールチェーン s により無効にされました。
タグ:loading_and_analysis
、affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
tvOS アプリのビルドに使用する tvOS SDK のバージョンを指定します。指定しない場合は、「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_state
、loading_and_analysis
--[no]apple_enable_auto_dsym_dbg
: 「false」-
dbg ビルドのデバッグ シンボル(.dSYM)ファイルの生成を強制的に有効にするかどうかを指定します。
タグ:affects_outputs
、action_command_lines
--[no]apple_generate_dsym
: 「false」- デバッグ シンボル(.dSYM)ファイルを生成するかどうか。
タグ:affects_outputs
、action_command_lines
--[no]build_runfile_links
のデフォルト: "true"-
true の場合、すべてのターゲットのランファイル シンボリック フォレストがビルドされます。false の場合、可能であればマニフェストのみを書き込みます。
タグ:affects_outputs
--[no]build_runfile_manifests
のデフォルト: "true"-
true の場合、すべてのターゲットの runfiles マニフェストを書き込みます。false の場合は省略します。false の場合、ローカルテストの実行は失敗します。
タグ:affects_outputs
--[no]build_test_dwp
: 「false」-
有効にすると、C++ テストを静的にビルドし、分割すると、テストバイナリの .dwp ファイルも自動的にビルドされます。
タグ:loading_and_analysis
、affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
のデフォルト: ".pb.h"-
cc_proto_library が作成するヘッダー ファイルの接頭辞を設定します。
タグ:affects_outputs
、loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
: 「.pb.cc」-
cc_proto_library が作成するソースファイルの接頭辞を設定します。
タグ:affects_outputs
、loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
: 「false」- proto_library で、代替 Java API バージョンの追加アクションを実行します。
タグ:affects_outputs
、loading_and_analysis
、experimental
--[no]experimental_proto_extra_actions
: 「false」- proto_library で、代替 Java API バージョンの追加アクションを実行します。
タグ:affects_outputs
、loading_and_analysis
、experimental
--[no]experimental_save_feature_state
: 「false」-
コンパイル済みの状態とリクエストされた機能をコンパイルの出力として保存します。
タグ:affects_outputs
、experimental
--fission=<a set of compilation modes>
のデフォルト: "no"-
C++ のコンパイルとリンクに分割を使用するコンパイル モードを指定します。'fastbuild'、'dbg'、'opt'}、またはすべてのモードを有効にする場合は「yes」、すべてのモードを無効にする場合は「no」の任意の組み合わせを指定できます。
タグ:loading_and_analysis
、action_command_lines
、affects_outputs
--[no]incompatible_always_include_files_in_data
のデフォルト: "true"-
true の場合、ネイティブ ルールはデータ依存関係の <code>DefaultInfo.files</code> を Runfile に追加します。これは Starlark ルールの推奨動作(https://bazel.build/extending/rules#runfiles_features_to_avoid)と一致します。
タグ:affects_outputs
、incompatible_change
--[no]legacy_external_runfiles
のデフォルト: "true"-
true の場合、.runfiles/repo に加えて、.runfiles/wsname/external/repo の下にある外部リポジトリ用の runfiles symlink フォレストを作成します。
タグ: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>
が累計されます -
ターゲット構成のアクションで使用可能な環境変数のセットを指定します。変数は、名前で指定できます。名前の場合、値は呼び出し環境から取得されるか、name=value ペアによって呼び出し環境とは別に値が設定されます。このオプションは複数回使用できます。同じ変数に指定されたオプションの場合、最新の変数が優先され、異なる変数のオプションが累積されます。
タグ:action_command_lines
--android_cpu=<a string>
のデフォルト: "armeabi-v7a"-
Android ターゲット CPU。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--[no]android_databinding_use_androidx
: 「false」-
AndroidX 互換のデータ バインディング ファイルを生成します。これは、databinding v2 でのみ使用されます。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--[no]android_databinding_use_v3_4_args
: 「false」-
3.4.0 引数で android databinding v2 を使用する
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--android_dynamic_mode=<off, default or fully>
のデフォルト: "off"-
cc_binary が共有ライブラリを明示的に作成していない場合に、Android ルールの C++ 依存関係を動的にリンクするかどうかを指定します。「default」は、bazel が動的にリンクするかどうかを選択することを意味します。「fully」は、すべてのライブラリが動的にリンクされることを意味します。「オフ」は、すべてのライブラリがほぼ静的モードでリンクされることを意味します。
タグ:affects_outputs
、loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
のデフォルト: "alphabetical"-
Android バイナリのマニフェスト マージツールに渡されるマニフェストの順序を設定します。ALPHABETICAL は、マニフェストが execroot への相対パスで並べ替えられることを意味します。ALPHABETICAL_BY_CONFIGURATION は、出力ディレクトリ内の構成ディレクトリを基準とする相対パスとしてマニフェストが並べ替えられていることを意味します。DEPENDENCY は、各ライブラリのマニフェストがその依存関係のマニフェストよりも前に来る順序で並べられることを意味します。
タグ:action_command_lines
、execution
--[no]android_resource_shrinking
: 「false」- ProGuard を使用する android_binary APK のリソース圧縮を有効にします。
タグ:affects_outputs
、loading_and_analysis
--[no]build_python_zip
: 「自動」-
Python 実行可能 zip をビルドします。Windows の場合、他のプラットフォームは除きます。
タグ:affects_outputs
- 複数の
--catalyst_cpus=<comma-separated list of options>
が累計されます - Apple Catalyst バイナリをビルドするアーキテクチャのカンマ区切りのリスト。
タグ:loses_incremental_state
、loading_and_analysis
--[no]collect_code_coverage
: 「false」-
指定すると、Bazel はコードをインストルメント化し(可能な場合、オフラインのインストルメンテーションを使用)、テスト中にカバレッジ情報を収集します。--instrumentation_filter に一致するターゲットのみが影響を受けます。通常、このオプションは直接指定せず、代わりに「bazelCoverage」コマンドを使用してください。
タグ:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] デフォルト: "fastbuild"-
バイナリが組み込まれるモードを指定します。値: fast'、'dbg'、'opt'。
タグ:affects_outputs
、action_command_lines
、explicit_in_output_path
- 複数の
--conlyopt=<a string>
が累計されます -
C ソースファイルをコンパイルするときに gcc に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
- 複数の
--copt=<a string>
が累計されます -
gcc に渡す追加オプション。
タグ:action_command_lines
、affects_outputs
--cpu=<a string>
のデフォルト: "-
ターゲット CPU。
タグ:changes_inputs
、affects_outputs
、explicit_in_output_path
--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_lines
、affects_outputs
- 複数の
--define=<a 'name=value' assignment>
が累計されます - 各 --define オプションは、ビルド変数の割り当てを指定します。
タグ:changes_inputs
、affects_outputs
--dynamic_mode=<off, default or fully>
デフォルト: "default"-
C++ バイナリを動的にリンクするかどうかを指定します。「default」は、Bazel が動的にリンクするかどうかを選択することを意味します。「fully」は、すべてのライブラリが動的にリンクされることを意味します。「オフ」は、すべてのライブラリがほぼ静的モードでリンクされることを意味します。
タグ:loading_and_analysis
、affects_outputs
--[no]enable_fdo_profile_absolute_path
のデフォルト: "true"-
設定した場合、fdo_absolute_profile_path を使用するとエラーが発生します。
タグ:affects_outputs
--[no]enable_runfiles
: 「自動」-
runfiles シンボリック リンク ツリーを有効にします。デフォルトでは、Windows、その他のプラットフォームでは無効になっています。
タグ:affects_outputs
- 複数の
--experimental_action_listener=<a build target label>
が累計されます -
いくつかの側面を重視して非推奨になりました。action_listener を使用して、エクストラアクションを既存のビルド アクションに接続します。
タグ:execution
、experimental
--[no]experimental_android_compress_java_resources
: 「false」-
APK で Java リソースを圧縮する
タグ:affects_outputs
、loading_and_analysis
、experimental
--[no]experimental_android_databinding_v2
: 「false」-
android databinding v2 を使用する
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--[no]experimental_android_resource_shrinking
: 「false」- ProGuard を使用する android_binary APK のリソース圧縮を有効にします。
タグ:affects_outputs
、loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
: 「false」-
rex ツールを使用して dex ファイルを書き換えます。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--experimental_objc_fastbuild_options=<comma-separated list of options>
のデフォルト: "-O0,-DDEBUG=1"-
これらの文字列を objc fastbuild コンパイラ オプションとして使用します。
タグ:action_command_lines
--[no]experimental_omitfp
: 「false」-
true の場合、スタックのアンワインドに libunwind を使用し、-fomit-frame-pointer と -fasync-unwind-tables を使用してコンパイルします。
タグ:action_command_lines
、affects_outputs
、experimental
--[no]experimental_platform_in_output_dir
: 「false」-
true の場合、ターゲット プラットフォームは CPU ではなく出力ディレクトリ名で使用されます。
タグ:affects_outputs
、experimental
--[no]experimental_use_llvm_covmap
: 「false」-
指定すると、Bazel は collect_code_coverage を有効にしたときに gcov ではなく llvm-cov カバレッジ マップ情報を生成します。
タグ:changes_inputs
、affects_outputs
、loading_and_analysis
、experimental
--fat_apk_cpu=<comma-separated set of options>
のデフォルト: "armeabi-v7a"-
このオプションを設定すると、太った APK が有効になります。これには、指定したすべてのターゲット アーキテクチャ(--fat_apk_cpu=x86,armeabi-v7a、このフラグを指定すると、android_binary ルールの依存関係で --android_cpu は無視されます。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--[no]fat_apk_hwasan
: 「false」-
HWASAN 分割を作成するかどうかを指定します。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--fdo_instrument=<a string>
: 説明を表示-
FDO インストルメンテーションでバイナリを生成する。Clang/LLVM コンパイラでは、生のプロファイル ファイルが実行時にダンプされるディレクトリ名も受け入れます。
タグ:affects_outputs
--fdo_optimize=<a string>
: 説明を表示-
FDO プロファイル情報を使用してコンパイルを最適化します。.gcda ファイルツリーを含む zip ファイルの名前、自動プロファイルを含む afdo ファイル、または LLVM プロファイル ファイルの名前を指定します。このフラグには、ラベルとして指定されたファイル(例: `//foo/bar:file.afdo` - 対応するパッケージに `exports_files` ディレクティブを追加する)と `fdo_profile` ターゲットを指すラベルを受け付けます。このフラグは fdo_profile ルールに置き換えられます。
タグ:affects_outputs
--fdo_prefetch_hints=<a build target label>
: 説明を表示-
キャッシュ プリフェッチのヒントを使用します。
タグ:affects_outputs
--fdo_profile=<a build target label>
: 説明を表示- 最適化に使用するプロファイルを表す fdo_profile。
タグ:affects_outputs
- 複数の
--features=<a string>
が累計されます -
指定された機能は、ターゲット構成で構築されたターゲットに対してデフォルトで有効または無効にされます。「-feature>」を指定すると、その特徴が無効になります。ネガティブな特徴は常にポジティブな特徴をオーバーライドします。--host_features もご覧ください。
タグ:changes_inputs
、affects_outputs
--[no]force_pic
: 「false」-
有効にすると、すべての C++ コンパイルが位置に依存しないコード(「-fPIC」)を生成し、リンクが非 PIC ライブラリよりも PIC ビルド済みライブラリを優先して、リンクが位置に依存しない実行可能ファイル(「-pie」)を生成するようになります。
タグ:loading_and_analysis
、affects_outputs
- 複数の
--host_action_env=<a 'name=value' assignment with an optional value part>
が累計されます - 実行構成を含むアクションで使用できる環境変数のセットを指定します。変数は、名前で指定できます。名前の場合、値は呼び出し環境から取得されるか、name=value ペアによって呼び出し環境とは別に値が設定されます。このオプションは複数回使用できます。同じ変数に指定されたオプションの場合、最新の変数が優先され、異なる変数のオプションが累積されます。
タグ:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
: 「opt」-
ビルド中に使用するツールが組み込まれるモードを指定します。値: fast'、'dbg'、'opt'。
タグ:affects_outputs
、action_command_lines
- 複数の
--host_conlyopt=<a string>
が累計されます -
実行構成で C(ただし C++ ではない)ソースファイルをコンパイルするときに、C コンパイラに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
- 複数の
--host_copt=<a string>
が累計されます -
exec 構成に組み込まれたツールについて、C コンパイラに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--host_cpu=<a string>
のデフォルト: "- ホスト CPU。
タグ:changes_inputs
、affects_outputs
- 複数の
--host_cxxopt=<a string>
が累計されます -
exec 構成に組み込まれたツール用に C++ コンパイラに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
- 複数の
--host_features=<a string>
が累計されます -
特定の機能はデフォルトで、exec 構成に組み込まれたターゲットで有効または無効にします。「-feature>」を指定すると、その特徴が無効になります。ネガティブな特徴は常にポジティブな特徴をオーバーライドします。
タグ:changes_inputs
、affects_outputs
--host_force_python=<PY2 or PY3>
: 説明を表示-
exec 構成の Python バージョンをオーバーライドします。「PY2」または「PY3」を指定できます。
タグ:loading_and_analysis
、affects_outputs
- 複数の
--host_linkopt=<a string>
が累計されます -
exec 構成のツールをリンクする際にリンカーに渡す追加オプション。
タグ:action_command_lines
、affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
ホスト ターゲットの最小互換 macOS バージョン。指定しない場合は、「macos_sdk_version」を使用します。
タグ:loses_incremental_state
- 複数の
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
が累計されます -
exec 構成内の特定のファイルをコンパイルする際に、C/C++ コンパイラに選択的に渡す追加オプション。このオプションは複数回渡すことができます。構文: regex_filter@option_1、option_2,...、option_n。regex_filter は、正規表現の包含リストと除外リストを表します(--instrumentation_filter も参照)。option_1 から option_n は任意のコマンドライン オプションを表します。オプションにカンマを含める場合は、バックスラッシュで囲む必要があります。オプションには @ を含めることができます。最初の @ のみが文字列の分割に使用されます。例: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 では、-O0 コマンドライン オプションを、bar.cc 以外の //foo/ にあるすべての cc ファイルの gcc コマンドラインに追加します。
タグ:action_command_lines
、affects_outputs
- 複数の
--host_swiftcopt=<a string>
が累計されます -
exec ツールに swiftc に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--[no]incompatible_auto_exec_groups
: 「false」-
有効にすると、ルールで使用されるツールチェーンごとに exec グループが自動的に作成されます。そのためには、ルールのアクションで「ツールチェーン」パラメータを指定する必要があります。詳細については、https://github.com/bazelbuild/bazel/issues/17134 をご覧ください。
タグ:affects_outputs
、incompatible_change
--[no]incompatible_avoid_conflict_dlls
のデフォルト: "true"-
有効にすると、Windows の cc_library によって生成されたすべての C++ ダイナミック リンク ライブラリ(DLL)の名前が name_hash.dll に変わり、リポジトリ名および DLL のパッケージパスに基づいてハッシュが計算されます。このオプションは、同じ名前の複数の cc_library に依存する 1 つのパッケージ(例: //foo/bar1:utils と //foo/bar2:utils)がある場合に役立ちます。
タグ:loading_and_analysis
、affects_outputs
、incompatible_change
--[no]incompatible_merge_genfiles_directory
のデフォルト: "true"-
true の場合、genfiles ディレクトリは bin ディレクトリに折りたたまれています。
タグ:affects_outputs
、incompatible_change
--[no]incompatible_use_host_features
: 「false」-
true の場合、ターゲット構成にのみ --features を使用し、exec 構成には --host_features を使用します。
タグ:changes_inputs
、affects_outputs
、incompatible_change
--[no]instrument_test_targets
: 「false」-
カバレッジが有効な場合、テストルールのインストルメンテーションを考慮するかどうかを指定します。設定すると、--instrumentation_filter に含まれるテストルールは計測可能になります。それ以外の場合、テストルールは常にカバレッジ計測から除外されます。
タグ:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-/javatests[/:],-/test/java[/:]"-
一致が有効になっている場合、指定した正規表現ベースのフィルタを含む名前のルールのみが計測対象となります。「-」で始まるルールは除外されます。--instrument_test_targets が有効になっていない限り、テスト以外のルールのみがインストルメント化されることに注意してください。
タグ:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
ターゲット設定のシミュレータとデバイスに対応する iOS の最小バージョン。指定しない場合は「ios_sdk_version」を使用します。
タグ:loses_incremental_state
- 複数の
--ios_multi_cpus=<comma-separated list of options>
が累計されます -
ios_application をビルドするアーキテクチャのカンマ区切りのリスト。その結果、指定したすべてのアーキテクチャを含むユニバーサル バイナリが生成されます。
タグ:loses_incremental_state
、loading_and_analysis
--[no]legacy_whole_archive
のデフォルト: "true"-
非推奨。--compatible_remove_legacy_whole_archive に置き換えられました(詳細は https://github.com/bazelbuild/bazel/issues/7362 を参照)。オンの場合、linkshared=True で、linkopt で linkstatic=True または「-static」を持つ cc_binary ルールに --whole-archive を使用します。これは下位互換性のためにのみ使用されます。必要に応じて、alwayslink=1 を使用することをおすすめします。
タグ:action_command_lines
、affects_outputs
、deprecated
- 複数の
--linkopt=<a string>
が累計されます -
リンク時に gcc に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
- 複数の
--ltobackendopt=<a string>
が累計されます -
LTO バックエンド ステップに渡す追加オプション(--features=thin_lto の下)。
タグ:action_command_lines
、affects_outputs
- 複数の
--ltoindexopt=<a string>
が累計されます -
LTO インデックス登録ステップに渡すオプション(--features=thin_lto の下)です。
タグ:action_command_lines
、affects_outputs
- 複数の
--macos_cpus=<comma-separated list of options>
が累計されます - Apple macOS バイナリをビルドするアーキテクチャのカンマ区切りのリスト。
タグ:loses_incremental_state
、loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
移行先の macOS の最小バージョン。指定しない場合は、「macos_sdk_version」を使用します。
タグ:loses_incremental_state
--[no]objc_debug_with_GLIBCXX
: 「false」-
設定済みで、コンパイル モードを「dbg」に設定した場合は、GLIBCXX_DEBUG、GLIBCXX_DEBUG_PEDANTIC、GLIBCPP_CONCEPT_CHECKS を定義します。
タグ:action_command_lines
--[no]objc_enable_binary_stripping
: 「false」-
リンクされたバイナリに対してシンボルとデッドコードのストリッピングを実行するかどうか。このフラグと --compilation_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 0 コマンドライン オプションを、bar/cc 以外の //foo/ にあるすべての cc ファイルの gcc コマンドラインに追加します。
タグ:action_command_lines
、affects_outputs
- 複数の
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
が累計されます -
特定のバックエンド オブジェクトをコンパイルするときに、LTO バックエンドを選択的に渡すオプションを追加しました(--features=thin_lto の下)。このオプションは複数回渡すことができます。構文: regex_filter@option_1、option_2,...、option_n。regex_filter は、正規表現の包含と除外のリストを表します。option_1 から option_n は任意のコマンドライン オプションを表します。オプションにカンマを含める場合は、バックスラッシュで囲む必要があります。オプションには @ を含めることができます。最初の @ のみが文字列の分割に使用されます。例: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 は、bar/o を除くすべての o ファイルの LTO バックエンド コマンドラインに -O0 コマンドライン オプションを追加します。
タグ:
action_command_lines
、affects_outputs
--platform_suffix=<a string>
: 説明を表示- 構成ディレクトリに追加するサフィックスを指定します。
タグ:loses_incremental_state
、affects_outputs
、loading_and_analysis
--propeller_optimize=<a build target label>
: 説明を表示-
プロペラ プロファイルの情報を使用して、ビルド ターゲットを最適化します。プロペラ プロファイルは、cc プロファイルと ld プロファイルのうち少なくとも 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_lines
、affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
: 説明を表示- プロペラ最適化ビルドの cc_profile ファイルの絶対パス名。
タグ:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
: 説明を表示- プロペラ最適化ビルドの ld_profile ファイルの絶対パス名。
タグ:affects_outputs
--run_under=<a prefix in front of command>
: 説明を表示-
「test」および「run」コマンドの実行可能ファイルの前に挿入する接頭辞。値が「foo -bar」で、実行コマンドラインが「test_binary -baz」の場合、最終的なコマンドラインは「foo -bar test_binary -baz」です。これは、実行可能ターゲットのラベルにすることもできます。例: 'valgrind'、'strace'、'strace -c'、'valgrind --quiet --num-callers=20'、'//package:target'、'//package:target --options'
タグ:action_command_lines
-
true の場合、同じ機能を含むネイティブ ライブラリが複数のターゲット間で共有されます。
タグ:loading_and_analysis
、affects_outputs
--[no]stamp
: 「false」-
日付、ユーザー名、ホスト名、ワークスペース情報などを含むバイナリをスタンプします。
タグ:affects_outputs
--strip=<always, sometimes or never>
のデフォルト: 「時には」-
バイナリと共有共有ライブラリを削除するかどうかを指定します(「-Wl,--strip-debug」を使用)。デフォルト値「sometimes」は、trip iff --compilation_mode=fastbuild を意味します。
タグ:affects_outputs
- 複数の
--stripopt=<a string>
が累計されます -
「<name>.stripped」バイナリを生成するときにストリップに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
- 複数の
--swiftcopt=<a string>
が累計されます - Swift コンパイルに渡す追加オプション。
タグ:action_command_lines
- 複数の
--tvos_cpus=<comma-separated list of options>
が累計されます - Apple tvOS バイナリをビルドするアーキテクチャのカンマ区切りのリスト。
タグ:loses_incremental_state
、loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
ターゲット シミュレータとデバイスに対応する最小の tvOS バージョン。指定しない場合は、「tvos_sdk_version」を使用します。
タグ:loses_incremental_state
- 複数の
--watchos_cpus=<comma-separated list of options>
が累計されます - Apple WatchOS バイナリをビルドするアーキテクチャのカンマ区切りのリスト。
タグ:loses_incremental_state
、loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
ターゲット シミュレータとデバイスに対応する WatchOS の最小バージョン。指定しない場合、「watchos_sdk_version」が使用されます。
タグ:loses_incremental_state
--xbinary_fdo=<a build target label>
: 説明を表示-
XbinaryFDO プロファイル情報を使用してコンパイルを最適化します。デフォルトのクロスバイナリ プロファイルの名前を指定します。オプションを --fdo_instrument/--fdo_optimize/--fdo_profile と併用すると、xbinary_fdo が指定されていないかのように、このオプションが常に優先されます。
タグ:affects_outputs
--auto_cpu_environment_group=<a build target label>
のデフォルト: "-
CPU 値を target_environment 値に自動的にマッピングするために使用する environment_group を宣言します。
タグ:changes_inputs
、loading_and_analysis
、experimental
--[no]check_licenses
: 「false」-
依存パッケージによって課されるライセンスの制約が、ビルドされるターゲットの配布モードと競合しないことを確認します。デフォルトでは、ライセンスはチェックされません。
タグ:build_file_semantics
--[no]check_visibility
のデフォルト: "true"-
無効にした場合、ターゲット依存関係の可視性エラーは警告に降格されます。
タグ:build_file_semantics
--[no]desugar_for_android
のデフォルト: "true"- dex 変換の前に Java 8 バイトコードを脱糖するかどうか。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--[no]desugar_java8_libs
: 「false」-
レガシー デバイスのアプリでサポートされる Java 8 ライブラリを含めるかどうか。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--[no]enforce_constraints
のデフォルト: "true"-
各ターゲットが互換性のある環境を確認し、同じ環境をサポートしない依存関係が含まれている場合はエラーを報告します。
タグ:build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs
: 「false」-
srcs-less android_library ルールを deps 付きで許可しないように遷移するフラグです。デフォルトでは、このリポジトリを展開してクリーンアップする必要があります。
タグ:eagerness_to_exit
、loading_and_analysis
--[no]experimental_check_desugar_deps
のデフォルト: "true"- Android バイナリレベルで正しい脱糖を再確認するかどうか。
タグ:eagerness_to_exit
、loading_and_analysis
、experimental
--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_semantics
、eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
: 「false」-
有効にすると、生成ルールのテスト専用を検索することで、出力ファイルである前提条件のターゲットが testonly にチェックされます。これは公開設定の確認と一致します。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_check_visibility_for_toolchains
: 「false」-
有効にすると、ツールチェーン実装にも可視性チェックが適用されます。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_disable_native_android_rules
: 「false」-
有効にすると、ネイティブ Android ルールの直接使用が無効になります。https://github.com/bazelbuild/rules_android の Starlark Android ルールを使用してください。
タグ:eagerness_to_exit
、incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
: 「false」-
いいえ。下位互換性のために、ここに残しておきます。
タグ:eagerness_to_exit
、incompatible_change
--[no]incompatible_force_strict_header_check_from_starlark
のデフォルト: "true"-
有効にすると、Starlark API で厳密なヘッダーのチェックを設定します。
タグ:loading_and_analysis
、changes_inputs
、incompatible_change
--[no]incompatible_python_disable_py2
のデフォルト: "true"-
true の場合、Python 2 の設定を使用するとエラーが発生します。これには、python_version=PY2、srcs_version=PY2、srcs_version=PY2ONLY が含まれます。詳しくは、https://github.com/bazelbuild/bazel/issues/15684 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
のデフォルト: "true"-
true の場合、Bazel は最上位のディレクトリ ヘッダーも検証します(詳細については https://github.com/bazelbuild/bazel/issues/10047 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--python_native_rules_allowlist=<a build target label>
: 説明を表示-
--compatible_python_disallow_native_rules を適用するときに使用する許可リスト(package_group ターゲット)。
タグ:loading_and_analysis
--[no]strict_filesets
: 「false」-
このオプションを有効にすると、パッケージの境界を超えるファイルセットがエラーとして報告されます。check_fileset_ dependencies_recursative が無効になっている場合、これは機能しません。
タグ:build_file_semantics
、eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
のデフォルト: "error"-
オフの場合を除いて、proto_library ターゲットは、直接使用されているすべてのターゲットを依存関係として明示的に宣言していることを確認します。
タグ:build_file_semantics
、eagerness_to_exit
、incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
のデフォルト: "off"-
オフの場合以外は、proto_library ターゲットが「import public」で使用されるすべてのターゲットを明示的にエクスポート済みとして宣言していることを確認します。
タグ:build_file_semantics
、eagerness_to_exit
、incompatible_change
--[no]strict_system_includes
: 「false」-
true の場合、system include パス(-isystem)にあるヘッダーも宣言する必要があります。
タグ:loading_and_analysis
、eagerness_to_exit
- 複数の
--target_environment=<a build target label>
が累計されます - このビルドのターゲット環境を宣言します。「環境」ルールを参照するラベルを指定する必要があります。指定する場合、トップレベル ターゲットはすべてこの環境に対応している必要があります。
タグ:changes_inputs
--apk_signing_method=<v1, v2, v1_v2 or v4>
のデフォルト: "v1_v2"-
APK の署名に使用する実装
タグ:action_command_lines
、affects_outputs
、loading_and_analysis
--[no]device_debug_entitlements
のデフォルト: "true"-
設定されていて、コンパイル モードが「opt」でない場合、署名時に objc アプリにデバッグ資格が含まれます。
タグ:changes_inputs
--ios_signing_cert_name=<a string>
: 説明を表示-
iOS 署名に使用する証明書名。設定しない場合、プロビジョニング プロファイルにフォールバックします。コード署名のマニュアル ページ(ID IDITITIES)に基づき、証明書のキーチェーン ID 設定または証明書の共通名(部分文字列)を指定できます。
タグ:action_command_lines
--[no]incompatible_disallow_legacy_py_provider
のデフォルト: "true"-
No-op はまもなく削除されます。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
: 「false」-
true の場合、objc_library および objc_import で sdk_frameworks 属性と weak_sdk_frameworks 属性を禁止します。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_objc_alwayslink_by_default
: 「false」-
true の場合、objc_library および objc_import の alwayslink 属性のデフォルト値を true にします。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_python_disallow_native_rules
: 「false」-
true の場合、組み込みの py_* ルールを使用するとエラーが発生します。代わりに、rule_python ルールを使用してください。詳細と移行手順については、https://github.com/bazelbuild/bazel/issues/17773 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]allow_analysis_failures
: 「false」-
true の場合、ルール ターゲットの分析に失敗すると、ビルドエラーになるのではなく、エラーの説明を含む AnalysisFailureInfo のインスタンスがターゲットに伝播されます。
タグ:loading_and_analysis
、experimental
--analysis_testing_deps_limit=<an integer>
: 「2000」-
for_analysis_testing 構成遷移でルール属性を介して推移的依存関係の最大数を設定します。この上限を超えると、ルールエラーが発生します。
タグ:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
: 「false」-
正しい dex2oat アクションが失敗すると、テスト ランタイム中に dex2oat が実行されるのではなく、ビルドが破損します。
タグ:loading_and_analysis
、experimental
--[no]experimental_android_use_parallel_dex2oat
: 「false」-
dex_oat を並行して使用すると、android_test が高速化される可能性があります。
タグ:loading_and_analysis
、host_machine_resource_optimizations
、experimental
--[no]ios_memleaks
: 「false」- ios_test ターゲットでのメモリリークの確認を有効にします。
タグ:action_command_lines
--ios_simulator_device=<a string>
: 説明を表示-
シミュレータで iOS アプリの実行時にシミュレートするデバイス(iPhone 6 など)。デバイスのリストを取得するには、シミュレータを実行するマシンで「xcrun simctl list devicetypes」を実行します。
タグ:test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
実行中またはテスト時にシミュレータで実行する iOS のバージョン。ルールで対象デバイスが指定されている場合、ios_test ルールでは無視されます。
タグ:test_runner
- 複数の
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
が累計されます - 各テストを実行する回数を指定します。いずれかの理由でなんらかの試行が失敗した場合は、テスト全体が不合格とみなされます。通常、指定する値は単なる整数です。例: --runs_per_test=3 はすべてのテストを 3 回実行します。代替構文: regex_filter@runs_per_testrun_per_test は整数値を表し、regex_filter は正規表現パターンの追加と除外のリストを表します(--instrumentation_filter も参照)。例: --runs_per_test=//foo/.*、-//foo/bar/.*@3 は、foo/bar 下にあるテストを除くすべてのテストを //foo/で 3 回実行します。このオプションは複数回渡すことができます。最も最近渡された、一致する引数が優先されます。一致するものがない場合、テストは 1 回だけ実行されます。
- 複数の
--test_env=<a 'name=value' assignment with an optional value part>
が累計されます - テストランナー環境に挿入する追加の環境変数を指定します。変数は、名前により指定できます。名前を指定すると、Bazel クライアント環境または名前 / 値のペアから値が読み取られます。このオプションは、複数の変数を指定するために複数回使用できます。「bazel test」コマンドでのみ使用されます。
タグ:test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers>
のデフォルト: "-1"- テストのタイムアウトのデフォルトのテスト タイムアウト値(秒単位)をオーバーライドします。正の整数値を 1 つ指定すると、すべてのカテゴリがオーバーライドされます。4 つのカンマ区切りの整数を指定した場合は、short、medium、long、eternal のタイムアウトがこの順序でオーバーライドされます。どちらの形式でも -1 の値は、そのカテゴリのデフォルトのタイムアウトを使用するように Blaze に指示します。
--tvos_simulator_device=<a string>
: 説明を表示-
シミュレータで tvOS アプリを実行する際にシミュレートするデバイス(「Apple TV 1080p」など)。デバイスのリストを取得するには、シミュレータを実行するマシンで「xcrun simctl list devicetypes」を実行します。
タグ:test_runner
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
実行中またはテスト時にシミュレータで実行する tvOS のバージョン。
タグ:test_runner
--watchos_simulator_device=<a string>
: 説明を表示-
シミュレータでスマートウォッチ OS アプリケーションを実行したときにシミュレートするデバイス(「Apple Watch - 38mm」など)。デバイスのリストを取得するには、シミュレータを実行するマシンで「xcrun simctl list devicetypes」を実行します。
タグ:test_runner
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
実行中またはテスト時にシミュレータで実行する watchOS のバージョン。
タグ:test_runner
--[no]zip_undeclared_test_outputs
のデフォルト: "true"-
true の場合、宣言されていないテスト出力が zip ファイルにアーカイブされます。
タグ:test_runner
--aspect_deps=<off, conservative or precise>
デフォルト: 「慎重」-
出力形式が {xml,proto,record} の場合にアスペクトの依存関係を解決する方法。「off」は、アスペクトの依存関係が解決されないことを意味します。「aservative」(デフォルト)は、直接的な依存関係のルールクラスが与えられているかどうかに関係なく、宣言されたすべてのアスペクトの依存関係が追加されることを意味します。「recise」は、直接的な依存関係のルールクラスに対してアクティブである可能性があるそれらのアスペクトのみが追加されることを意味します。正確なモードでは、1 つのターゲットを評価するには他のパッケージを読み込む必要があるため、他のモードよりも遅くなります。また、正確なモードでなくても、完全に正確というわけではありません。アスペクトを計算するかどうかは、分析フェーズで決まります。分析フェーズは、「bazel query」の実行時には実行されません。
タグ:build_file_semantics
--[no]deduplicate_depsets
のデフォルト: "true"-
最終的な proto/textproto/json 出力で、dep_set_of_files のリーフ以外の子の重複を除去します。即時の親を共有しないデップの重複除去は除去されません。これは、アクションの入力アーティファクトの最終的な有効なリストには影響しません。
タグ:terminal_output
--[no]experimental_parallel_aquery_output
: 「false」- クエリ proto/textproto の出力を並行して記述するかどうか。他の出力形式では何も処理されません。
--[no]graph:factored
のデフォルト: "true"-
true の場合、グラフは「因数分解」されます。つまり、トポロジ的に同等のノードは結合され、そのラベルが連結されます。このオプションは、--output=graph にのみ適用されます。
タグ:terminal_output
--graph:node_limit=<an integer>
のデフォルト: "512"-
出力内のグラフノードのラベル文字列の最大長。長いラベルは切り捨てられます。-1 を指定すると、切り捨てられません。このオプションは、--output=graph にのみ適用されます。
タグ:terminal_output
--[no]implicit_deps
のデフォルト: "true"-
有効にすると、クエリが動作する依存関係グラフに暗黙的な依存関係が含まれます。暗黙的な依存関係とは、BUILD ファイルで明示的に指定されておらず、bazel によって追加されている依存関係です。cquery の場合、このオプションは解決済みのツールチェーンのフィルタリングを制御します。
タグ:build_file_semantics
--[no]include_artifacts
のデフォルト: "true"- 出力にアクションの入力と出力の名前が含まれます(サイズが大きい可能性があります)。
タグ:terminal_output
--[no]include_aspects
のデフォルト: "true"- aquery, cquery: アスペクトで生成されたアクションを出力に含めるかどうか。query: no-op(アスペクトは必ず従います)。
タグ:terminal_output
--[no]include_commandline
のデフォルト: "true"- 出力にアクション コマンドラインの内容が含まれます(サイズが大きい可能性があります)。
タグ:terminal_output
--[no]include_file_write_contents
: 「false」-
FileWrite アクションと SourceSymlinkManifest アクション(サイズが大きくなる可能性があります)のファイルの内容を含めます。
タグ:terminal_output
--[no]include_param_files
: 「false」-
コマンドで使用されるパラメータ ファイルの内容を含めます(大きくなる可能性があります)。注: このフラグを有効にすると、--include_commandline フラグが自動的に有効になります。
タグ:terminal_output
--[no]incompatible_display_source_file_location
のデフォルト: "true"-
デフォルトでは true であり、ソースファイルのターゲットが表示されます。true の場合、場所の出力にソースファイルの 1 行目の場所を表示します。このフラグは移行の目的でのみ存在します。
タグ:terminal_output
、incompatible_change
--[no]incompatible_package_group_includes_double_slash
のデフォルト: "true"-
有効にすると、package_group の 'packages' 属性の出力時に、先頭の `//` が省略されません。
タグ:terminal_output
、incompatible_change
--[no]infer_universe_scope
: 「false」-
設定されていて --universe_scope が設定されていない場合、クエリ式の一意のターゲット パターンのリストとして --universe_scope の値が推定されます。ユニバース スコープ関数(allrdeps など)を使用するクエリ式に対して推測された --universe_scope 値は、望ましくない場合があります。そのため、このオプションは使用する処理がわかっている場合にのみ使用してください。詳細と例については、https://bazel.build/reference/query#sky-query をご覧ください。--universe_scope が設定されている場合、このオプションの値は無視されます。注: このオプションは「query」にのみ適用されます(つまり「cquery」には適用されません)。
タグ:loading_and_analysis
--[no]line_terminator_null
: 「false」- 各形式が改行ではなく \0 で終結しているかどうか。
タグ:terminal_output
--[no]nodep_deps
のデフォルト: "true"-
有効にすると、「nodep」属性の依存関係は、クエリが動作する依存関係グラフに含まれます。「nodep」属性の一般的な例は「visibility」です。「info build-language」の出力を実行して解析し、ビルド言語のすべての「nodep」属性を確認します。
タグ:build_file_semantics
--output=<a string>
のデフォルト: "text"-
クエリ結果を出力する形式。aquery で使用できる値は、text、textproto、proto、streamed_proto、jsonproto です。
タグ:terminal_output
--[no]proto:default_values
のデフォルト: "true"-
true の場合、値が BUILD ファイルで明示的に指定されていない属性は無視されます。このオプションは、--output=proto に適用できます。
タグ:terminal_output
--[no]proto:definition_stack
: 「false」-
define_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>
: 「すべて」-
出力に含める属性のカンマ区切りのリスト。デフォルトはすべての属性です。属性を出力しない場合は、空の文字列に設定します。このオプションは --output=proto に適用できます。
タグ:terminal_output
--[no]proto:rule_inputs_and_outputs
のデフォルト: "true"-
rule_input フィールドと rule_output フィールドに値を設定するかどうかを指定します。
タグ:terminal_output
--query_file=<a string>
のデフォルト: "-
設定すると、クエリはコマンドラインではなくここで指定したファイルから読み込まれます。ここでは、ファイルとコマンドライン クエリを指定するとエラーが発生します。
タグ:changes_inputs
--[no]relative_locations
: 「false」-
true の場合、xml と proto の出力に含まれる BUILD ファイルの場所は相対パスになります。デフォルトでは、ロケーション出力は絶対パスで、マシン間で一貫していません。このオプションを true に設定すると、マシン間で一貫した結果を得ることができます。
タグ:terminal_output
--[no]skyframe_state
: 「false」-
追加の分析を行わずに、現在のアクション グラフを Skyframe からダンプします。注: 現在、--skyframe_state を使用してターゲットを指定することはできません。このフラグは、--output=proto または --output=textproto でのみ使用できます。
タグ:terminal_output
--[no]tool_deps
のデフォルト: "true"-
クエリ: 無効の場合、「exec 構成」への依存関係はクエリが動作する依存関係グラフには含まれません。「exec 構成」の依存関係のエッジ(プロトコル コンパイラの「proto_library」ルールなど)は、通常、同じ「ターゲット」プログラムの一部ではなく、ビルド中に実行されるツールを参照します。
Cquery: 無効に設定した場合、この構成ターゲットを検出した最上位ターゲットから、実行遷移を超えるすべての構成ターゲットが除外されます。つまり、トップレベルのターゲットがターゲット構成にある場合、ターゲット構成でも構成済みのターゲットのみが返されます。トップレベル ターゲットが exec 構成に含まれている場合は、exec 構成ターゲットのみが返されます。このオプションでは、解決済みのツールチェーンは除外されません。
タグ:build_file_semantics
--universe_scope=<comma-separated list of options>
のデフォルト: "-
対象のパターン(追加と減算)のカンマ区切りのセット。クエリは、指定したターゲットの推移的な閉鎖によって定義されるユニバースで実行できます。このオプションは、クエリコマンドと cquery コマンドで使用されます。cquery の場合、このオプションへの入力はすべての回答の基となるターゲットであるため、このオプションは構成と遷移に影響を与える可能性があります。このオプションが指定されていない場合、トップレベル ターゲットはクエリ式から解析されたターゲットとみなされます。注: cquery でこのオプションを指定しないと、クエリ式から解析されたターゲットがトップレベル オプションでビルドできない場合、ビルドが破損する可能性があります。
タグ:loading_and_analysis
--[no]collapse_duplicate_defines
のデフォルト: "true"-
有効にすると、冗長な --define がビルドの早期から削除されます。これにより、特定の種類の同等のビルドで分析キャッシュが不必要に失われるのを防ぐことができます。
タグ:loading_and_analysis
、loses_incremental_state
--[no]experimental_filter_library_jar_with_program_jar
: 「false」-
ProGuardJJar をフィルタして、LibraryJar 内にもあるクラスをすべて削除します。
タグ:action_command_lines
--[no]experimental_inmemory_dotd_files
のデフォルト: "true"-
有効にすると、C++ .d ファイルはディスクに書き込まれるのではなく、リモートビルドノードから直接メモリ内で渡されます。
タグ:loading_and_analysis
、execution
、affects_outputs
、experimental
--[no]experimental_inmemory_jdeps_files
のデフォルト: "true"-
有効にすると、Java コンパイルから生成された依存関係(.jdeps)ファイルがディスクに書き込まれるのではなく、リモートビルドノードから直接メモリ内で渡されます。
タグ:loading_and_analysis
、execution
、affects_outputs
、experimental
--[no]experimental_objc_include_scanning
: 「false」-
対象 C/C++ のインクルード スキャンを行うかどうかを指定します。
タグ:loading_and_analysis
、execution
、changes_inputs
--[no]experimental_retain_test_configuration_across_testonly
: 「false」-
有効にすると、--trim_test_configuration は testonly=1 とマークされたルールのテスト構成をカットしません。これは、テスト以外のルールが cc_test ルールに依存している場合に、アクションの競合の問題を減らすことを目的としています。--trim_test_configuration が false の場合、効果はありません。
タグ:loading_and_analysis
、loses_incremental_state
--[no]experimental_starlark_cc_import
: 「false」-
有効にすると、Starlark バージョンの cc_import を使用できます。
タグ:loading_and_analysis
、experimental
--[no]experimental_unsupported_and_brittle_include_scanning
: 「false」-
入力ファイルの #include 行を解析し、C/C++ コンパイルへの入力を絞り込むかどうかを指定します。これにより、コンパイル入力ツリーのサイズを小さくすることでパフォーマンスとインクリメンタリティを改善できます。ただし、インクルード スキャナは C プリプロセッサのセマンティクスを完全には実装していないため、ビルドが壊れる可能性もあります。特に、動的な #include ディレクティブは理解されず、プリプロセッサの条件付きロジックは無視されます。自己責任で使用してください。提出したこのフラグに関連する問題はすべてクローズされます。
タグ:loading_and_analysis
、execution
、changes_inputs
--[no]incremental_dexing
のデフォルト: "true"- ほとんどの Jar ファイルごとに dex 変換を行うためのほとんどの作業を行います。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--[no]objc_use_dotd_pruning
のデフォルト: "true"-
設定した場合、clang が出力する .d ファイルを使用して、objc コンパイルに渡される入力セットがプルーニングされます。
タグ:changes_inputs
、loading_and_analysis
--[no]process_headers_in_dependencies
: 「false」-
ターゲット //a:a をビルドする際、//a:a が依存するすべてのターゲット内のヘッダーを処理します(ツールチェーンでヘッダー処理が有効になっている場合)。
タグ:execution
--[no]trim_test_configuration
のデフォルト: "true"-
有効にすると、テスト関連のオプションはビルドの最上位の下にクリアされます。このフラグが有効な場合、テストをテスト以外のルールの依存関係としてテストすることはできません。ただし、テスト関連オプションを変更しても、テスト以外のルールが再分析されることはありません。
タグ:loading_and_analysis
、loses_incremental_state
--[no]use_singlejar_apkbuilder
のデフォルト: "true"-
このオプションは非推奨となりました。これは NoOps であり、まもなく削除されます。
タグ:loading_and_analysis
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*"-
ツールチェーンの解決中にデバッグ情報を出力します。このフラグは正規表現を受け取り、ツールチェーン タイプと特定のターゲットに対してチェックして、デバッグ対象を確認します。複数の正規表現がある場合はカンマで区切ります。各正規表現を個別にチェックします。注: このフラグの出力は非常に複雑であり、ツールチェーンの解決の専門家にのみ役立つ可能性があります。
タグ:terminal_output
- 複数の
--flag_alias=<a 'name=value' flag alias>
が累計されます -
Starlark フラグの省略名を設定します。「<key>=<value>」という形式の単一の Key-Value ペアを引数として受け取ります。
タグ:changes_inputs
--[no]incompatible_default_to_explicit_init_py
: 「false」-
このフラグはデフォルトの動作を変更して、Python ターゲットのランファイル内で __init__.py ファイルが自動的に作成されないようにします。正確には、py_binary または py_test ターゲットで legacy_create_init が「auto」(デフォルト)に設定されている場合、このフラグが設定されている場合にのみ false として扱われます。https://github.com/bazelbuild/bazel/issues/10076 をご覧ください。
タグ:affects_outputs
、incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
のデフォルト: "true"-
true の場合、Python 2 構成でビルドされたターゲットは、接尾辞「-py2」を含む出力ルートの下に表示され、Python 3 用に作成されたターゲットは、Python 関連の接尾辞のないルートに表示されます。つまり、bazel-bin という便利なシンボリック シンボリック リンクは、Python 2 ではなく Python 3 のターゲットを指します。このオプションを有効にする場合は、「--compatibility_py3_is_default」も有効にすることをおすすめします。
タグ:affects_outputs
、incompatible_change
--[no]incompatible_py3_is_default
のデフォルト: "true"-
true の場合、`python_version`(または `default_python_version`)属性を設定していない `py_binary` と `py_test` ターゲットは、デフォルトで PY2 ではなく PY3 になります。このフラグを設定する場合は、----compatible_py2_outputs_are_suffixed` も設定することをおすすめします。
タグ:loading_and_analysis
、affects_outputs
、incompatible_change
--[no]incompatible_use_python_toolchains
のデフォルト: "true"-
true に設定すると、実行可能なネイティブ Python ルールでは、--python_top などのレガシーフラグで指定されたランタイムではなく、Python ツールチェーンで指定された Python ランタイムが使用されます。
タグ:loading_and_analysis
、incompatible_change
--python_version=<PY2 or PY3>
: 説明を表示-
Python のメジャー バージョン モード。「PY2」または「PY3」。「py_binary」ターゲットと「py_test」ターゲットでオーバーライドされます。バージョンを明示的に指定していない場合でも、このフラグを指定する理由は通常あまりありません。
タグ:loading_and_analysis
、affects_outputs
、explicit_in_output_path
--[no]cache_test_results
[-t
] デフォルト: "auto"- auto に設定すると、Bazel は(1)Bazel がテストまたはその依存関係の変更を検出した場合、(2)テストが外部としてマークされている場合、(3)以前に複数のテスト実行が --runs_per_test でリクエストされたか、(4)テストに失敗した場合にのみ、テストを再実行します。「yes」に設定すると、外部としてマークされたテストを除くすべてのテスト結果が Bazel によってキャッシュに保存されます。「no」に設定すると、Bazel はテスト結果をキャッシュに保存しません。
--[no]experimental_cancel_concurrent_tests
: 「false」-
true の場合、Blaze は初回実行に成功したときに同時実行中のテストをキャンセルします。これは --runs_per_test_detects_flakes と組み合わせた場合にのみ有効です。
タグ:affects_outputs
、loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs
: 「false」-
true の場合、Bazel はカバレッジ実行中に、テストごとにカバレッジ データ ディレクトリ全体を取得します。
タグ:affects_outputs
、loading_and_analysis
--[no]experimental_generate_llvm_lcov
: 「false」-
true の場合、clang が LCOV カバレッジの対象となります。
タグ:affects_outputs
、loading_and_analysis
--[no]experimental_j2objc_header_map
のデフォルト: "true"- J2ObjC のトランスパイルと並行して J2ObjC ヘッダー マップを生成するかどうか。
--[no]experimental_j2objc_shorter_header_path
: 「false」-
ヘッダーパスを短くして生成するかどうか(「_j2objc」ではなく「_ios」)。
タグ:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
のデフォルト: "javabuilder"- Java コンパイルのクラスパスを削減できます。
--[no]experimental_limit_android_lint_to_android_constrained_java
: 「false」-
--experimental_run_android_lint_on_java_rules を Android 互換ライブラリに制限します。
タグ:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
: 「false」-
java_* のソースを検証するかどうかを指定します。
タグ:affects_outputs
--[no]explicit_java_test_deps
: 「false」- TestRunner の依存関係から誤って取得するのではなく、java_test で JUnit または Hamcrest への依存関係を明示的に指定します。現在のところ、bazel の場合のみ機能します。
--host_java_launcher=<a build target label>
: 説明を表示- ビルド時に実行されるツールで使用される Java ランチャー。
- 複数の
--host_javacopt=<a string>
が累計されます - ビルド時に実行されるツールをビルドするときに javac に渡す追加のオプション。
- 複数の
--host_jvmopt=<a string>
が累計されます - ビルド時に実行されるツールをビルドするときに Java VM に渡す追加のオプション。これらのオプションは、各 java_binary ターゲットの VM 起動オプションに追加されます。
--[no]incompatible_check_sharding_support
のデフォルト: "true"-
true の場合、TEST_SHARD_STATUS_FILE のパスにあるファイルをタップしてシャーディングをサポートしていることをテストランナーが示していない場合、Bazel はシャーディングされたテストに失敗します。false の場合、シャーディングをサポートしていないテストランナーは、各シャードで実行されるすべてのテストを実行します。
タグ:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
のデフォルト: "true"-
true の場合、サンドボックス化された戦略で排他的テストが実行されます。「local」タグを追加して、ローカルで排他的テストを強制的に実行します。
タグ:incompatible_change
--[no]incompatible_strict_action_env
: 「false」-
true の場合、Bazel は PATH に静的な値が設定された環境を使用し、LD_LIBRARY_PATH を継承しません。クライアントから特定の環境変数を継承する場合は --action_env=ENV_VARIABLE を使用しますが、継承すると、共有キャッシュを使用している場合にユーザー間のキャッシュが防止される可能性があります。
タグ:loading_and_analysis
、incompatible_change
- 複数の
--j2objc_translation_flags=<comma-separated list of options>
が累計されます - J2ObjC ツールに渡す追加のオプション。
--java_debug
-
Java テストの Java 仮想マシンで、JDWP 準拠のデバッガ(jdb など)からの接続を待機してからテストを開始します。暗黙的に -test_output=streamed となります。
以下に展開:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
のデフォルト: "true"- Java ターゲットごとに依存関係情報(現時点ではコンパイル時クラスパス)を生成します。
--[no]java_header_compilation
のデフォルト: "true"- ソースから ijar を直接コンパイルします。
--java_language_version=<a string>
のデフォルト: "- Java 言語バージョン
--java_launcher=<a build target label>
: 説明を表示- Java バイナリをビルドするときに使用する Java ランチャー。このフラグを空の文字列に設定すると、JDK ランチャーが使用されます。このフラグは「ランチャー」属性によってオーバーライドされます。
--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"-
proto-compiler のラベル。
タグ:affects_outputs
、loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
のデフォルト: "@bazel_tools//tools/proto:cc_ツールチェーン"-
C++ proto のコンパイル方法を示す proto_lang_ツールチェーン() のラベル
タグ:affects_outputs
、loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
のデフォルト: "@bazel_tools//tools/j2objc:j2objc_proto_ツールチェーン"-
j2objc proto のコンパイル方法を示す proto_lang_ツールチェーン() のラベル
タグ:affects_outputs
、loading_and_analysis
--proto_toolchain_for_java=<a build target label>
のデフォルト: "@bazel_tools//tools/proto:java_ツールチェーン"- Java proto のコンパイル方法を示す proto_lang_ツールチェーン() のラベル
タグ:affects_outputs
、loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
のデフォルト: "@bazel_tools//tools/proto:javalite_ツールチェーン"- JavaLite proto のコンパイル方法を示す proto_lang_ツールチェーン() のラベル
タグ:affects_outputs
、loading_and_analysis
- 複数の
--protocopt=<a string>
が累計されます -
protobuf コンパイラに渡す追加オプション。
タグ:affects_outputs
--[no]runs_per_test_detects_flakes
: 「false」- true の場合、1 つ以上の実行/試行が成功し、1 つ以上の実行/試行が失敗したシャードは、FLAKY ステータスになります。
--shell_executable=<a path>
: 説明を表示-
Bazel が使用するシェル実行可能ファイルの絶対パス。これが設定されていない場合、BAZEL_SH 環境変数が Bazel の最初の呼び出し(Bazel サーバーを起動する)で設定されている場合、Bazel はそれを使用します。どちらも設定されていない場合、Bazel はオペレーティング システムに応じてハードコードされたデフォルト パスを使用します(Windows: c:/tools/msys64/usr/bin/bash.exe、FreeBSD: /usr/local/bin/bash、その他: /bin/bash)。bash と互換性のないシェルを使用すると、生成されたバイナリのビルドエラーやランタイム エラーが発生する可能性があります。
タグ:loading_and_analysis
- 複数の
--test_arg=<a string>
が累計されます - テストの実行可能ファイルに渡す追加のオプションと引数を指定します。複数の引数を指定するには、複数回使用できます。複数のテストが実行される場合、各テストは同一の引数を受け取ります。「bazel test」コマンドでのみ使用されます。
--test_filter=<a string>
: 説明を表示- テスト フレームワークに転送するフィルタを指定します。テストの実行を制限するために使用します。なお、これはビルドされるターゲットには影響しません。
--test_result_expiration=<an integer>
のデフォルト: "-1"- このオプションは非推奨であり、効果はありません。
--[no]test_runner_fail_fast
: 「false」- フォワード ファスト オプションをテストランナーに転送します。テストランナーは、最初の失敗時に実行を停止する必要があります。
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
: 「露骨な表現」- テストのシャーディング戦略を指定: 「explicit」: 「shard_count」の BUILD 属性が存在する場合のみ、シャーディングを使用します。テスト シャーディングを使用しないようにするには、「無効」にします。'shard_count' BUILD 属性に関係なく、「forced=k」を指定するとテストに「k」シャードが適用されます。
--tool_java_language_version=<a string>
のデフォルト: "- ビルド時に必要なツールを実行するために使用される Java 言語バージョン
--tool_java_runtime_version=<a string>
: "remotejdk_11"- ビルド時にツールを実行するために使用される Java ランタイム バージョン
--[no]use_ijars
のデフォルト: "true"- 有効にすると、このオプションにより Java コンパイルでインターフェース JAR が使用されます。これにより、増分コンパイルは速くなりますが、エラー メッセージが異なることがあります。
- 複数の
--distdir=<a path>
が累計されます -
ネットワークにアクセスする前にアーカイブを検索できる追加の場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュはコピーではなくファイルをハードリンクします。これはディスク容量を節約することを目的としています。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
: 「false」-
true の場合、指定されていない場合は、リポジトリのダウンロードの URL から派生した文字列を canonical_id として使用します。これにより、キャッシュにハッシュが同じであっても、URL が変更されると再ダウンロードが発生します。これを使用して、URL の変更によって破損したリポジトリがキャッシュによってマスクされないことを確認できます。
タグ:loading_and_analysis
、experimental
--experimental_repository_downloader_retries=<an integer>
のデフォルト: "0"-
ダウンロード エラーを再試行する最大回数。0 に設定すると、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: "1.0"-
この要因により、Starlark リポジトリ ルールのすべてのタイムアウトをスケーリングします。このように、ソースコードを変更しなくても、ルールの作成者が想定したよりも遅いマシンで外部リポジトリを作成できます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: "0s"-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にすると、タイムアウトは定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: "1.0"-
特定の要因による HTTP ダウンロードに関連するすべてのタイムアウトをスケーリングします。
タグ:bazel_internal_configuration
--repository_cache=<a path>
: 説明を表示-
外部リポジトリの取得時に取得した、ダウンロードした値のキャッシュの場所を指定します。引数に空の文字列がある場合は、キャッシュの無効化をリクエストします。そうでなければ、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
: 「false」-
設定した場合、ctx.download{,_and_extract} を使用したダウンロードはリポジトリの取得時に許可されません。なお、ネットワーク アクセスが完全に無効というわけではなく、ctx.execute はインターネットにアクセスする任意の実行可能ファイルを実行します。
タグ:bazel_internal_configuration
--[no]check_up_to_date
: 「false」-
ビルドを実行しないでください。ビルドが最新かどうかを確認してください。すべてのターゲットが最新の状態の場合、ビルドは正常に完了しています。いずれかのステップを実行する必要がある場合、エラーが報告され、ビルドが失敗します。
タグ:execution
--dynamic_local_execution_delay=<an integer>
: 「1000」- ビルド中にリモート実行が少なくとも 1 回、高速化された場合、ローカル実行を何ミリ秒遅延させるか。
タグ:execution
、host_machine_resource_optimizations
- 複数の
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment>
が累計されます -
特定の覚え方のために、ローカル戦略を最初に順番に使用。最初に適用される戦略が使用されます。たとえば、「worker,sandboxed」は、ワーカー戦略を使用する永続ワーカーをサポートするアクションと、サンドボックス戦略を使用する他のすべてのワーカーをサポートするアクションを実行します。説明が記載されていない場合は、戦略のリストがすべての覚え方の代替として使用されます。デフォルトのフォールバック リストは、「experimental_local_lockfree_output」が設定されている場合、「worker、sandboxed」または「worker、sandboxed、standalone」です。[mnemonic=]local_strategy[,local_strategy,...]
タグ:execution
、host_machine_resource_optimizations
- 複数の
--dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment>
が累計されます -
この略語に使うリモート戦略を、順番に順番に並べていきます。1 つ目は最初に適用した戦略です。説明が記載されていない場合は、戦略のリストがすべての覚え方の代替として使用されます。デフォルトのフォールバック リストは「remote」であるため、通常、このフラグは明示的に設定する必要はありません。[mnemonic=]remote_strategy[,remote_strategy,...] を使用します。
タグ:execution
、host_machine_resource_optimizations
--experimental_docker_image=<a string>
のデフォルト: "-
Docker 戦略の使用時にサンドボックス化されたアクションを実行するときに使用する Docker イメージ名(ubuntu:latest など)を指定します。アクション自体は、プラットフォームの記述の remote_execution_properties に container-image 属性がありません。このフラグの値は「docker run」にそのまま渡されるため、Docker 自体と同じ構文とメカニズムがサポートされます。
タグ:execution
--[no]experimental_docker_use_customized_images
のデフォルト: "true"-
有効にすると、使用する前に現在のユーザーの UID と gid を Docker イメージに挿入します。これは、ビルドやテストで、コンテナ内に名前とホーム ディレクトリがあるユーザーに依存する場合に必要となります。この機能はデフォルトで有効になっていますが、ケースで自動画像のカスタマイズ機能が使用できない場合や、この機能を必要としない場合は、無効にできます。
タグ:execution
--[no]experimental_dynamic_exclude_tools
のデフォルト: "true"-
設定した場合、「ツール」用にビルドされたターゲットは動的実行の対象になりません。このようなターゲットが段階的に構築されることは極めて低く、ローカル サイクルに費やす価値もありません。
タグ:execution
、host_machine_resource_optimizations
--experimental_dynamic_local_load_factor=<a double>
のデフォルト: "0"-
動的実行からローカルマシンに投入する負荷を制御します。このフラグは、動的実行で同時にスケジュールするアクションの数を調整します。これは、Blaze で使用可能な CPU の数に基づいています。これは、--local_cpu_resources フラグで制御できます。このフラグが 0 の場合、すべてのアクションは即時にローカルにスケジュールされます。0 より大きい場合、ローカルにスケジュールされるアクションの量は使用可能な CPU の数によって制限されます。1 未満の場合、負荷係数を使用して、スケジュールを待機しているアクション数が多い場合にローカルでスケジュールされるアクションの数を削減します。これにより、ローカルマシンが大きな負荷をかけないクリーンなビルドケースでのローカルマシンの負荷が軽減されます。
タグ:execution
、host_machine_resource_optimizations
--experimental_dynamic_slow_remote_time=<An immutable length of time.>
のデフォルト: "0"-
0 より大きい場合、リモート実行がタイムアウトするのを避けるため、動的に実行されるアクションのローカル実行を優先する前に、リモートのみを実行する必要があります。これにより、リモート実行システムでいくつかの問題が隠れる可能性があります。リモート実行の問題をモニタリングすることなく、このオプションをオンにしないでください。
タグ:execution
、host_machine_resource_optimizations
--[no]experimental_enable_docker_sandbox
: 「false」-
Docker ベースのサンドボックス化を有効にします。Docker がインストールされていない場合、このオプションは無視されます。
タグ:execution
--experimental_oom_more_eagerly_threshold=<an integer in 0-100 range>
: 「100」-
このフラグが 100 より小さい値に設定されている場合、2 つの完全な GC の後も(この古い世代の)ヒープの占有率がこの割合を超えると、Bazel は OOM を行います。
タグ:host_machine_resource_optimizations
--experimental_sandbox_async_tree_delete_idle_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
のデフォルト: "0"-
0 の場合、アクションが完了するとすぐにサンドボックス ツリーが削除されます(アクションの完了が遅延するため)。ゼロより大きい場合、ビルドの実行時にサイズ 1 の非同期スレッドプールで上記の 3 つを削除し、サーバーがアイドル状態のときにこのフラグで指定されたサイズに増加します。
タグ:host_machine_resource_optimizations
、execution
--experimental_sandbox_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
のデフォルト: "0"-
0 より大きい場合、各 Linux サンドボックスは、指定されたメモリ量(MB)に制限されます。cgroups v1 または v2 と、cgroups ディレクトリへのユーザーの権限が必要です。
タグ:execution
--experimental_sandboxfs_path=<a string>
のデフォルト: "sandboxfs"-
--experimental_use_sandboxfs が true の場合に使用する sandboxfs バイナリのパス。ベアメタル名の場合は、PATH でその名前の最初のバイナリを使用します。
タグ:host_machine_resource_optimizations
、execution
--[no]experimental_shrink_worker_pool
: 「false」-
有効にすると、ワーカーのメモリ負荷が高い場合にワーカープールが縮小される可能性があります。このフラグは、experimental_total_worker_memory_limit_mb フラグが有効な場合のみ機能します。
タグ:execution
、host_machine_resource_optimizations
--[no]experimental_split_xml_generation
のデフォルト: "true"-
このフラグが設定されていて、テスト アクションが test.xml ファイルを生成しない場合、Bazel は別のアクションを使用して、テストログを含むダミーの test.xml ファイルを生成します。それ以外の場合、Bazel はテスト アクションの一部として test.xml を生成します。
タグ:execution
--experimental_total_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
のデフォルト: "0"-
この上限が 0 より大きい場合、すべてのワーカーの合計メモリ使用量が上限を超えると、アイドル状態のワーカーが強制終了される可能性があります。
タグ:execution
、host_machine_resource_optimizations
--[no]experimental_use_hermetic_linux_sandbox
: 「false」-
true に設定する場合は、root をマウントせず、sandbox_add_mount_pair で指定されたもののみをマウントします。入力ファイルは、サンドボックスからシンボリック リンクではなく、サンドボックスにハードリンクされます。アクション入力ファイルがサンドボックスとは異なるファイル システムにある場合、入力ファイルはコピーされます。
タグ:execution
--[no]experimental_use_sandboxfs
: 「false」-
シンボリック ツリーを構築する代わりに、sandboxfs を使用してアクションの execroot ディレクトリを作成します。「はい」の場合、--experimental_sandboxfs_path によって提供されるバイナリは、サポートされている sandboxfs のバージョンに対応している必要があります。「auto」の場合、バイナリが存在しないか、互換性がありません。
タグ:host_machine_resource_optimizations
、execution
--[no]experimental_use_semaphore_for_jobs
: 「false」-
true に設定すると、セマフォを使用して同時実行ジョブの数も制限できます。
タグ:host_machine_resource_optimizations
、execution
--[no]experimental_use_windows_sandbox
: 「false」- Windows サンドボックスを使用してアクションを実行します。「はい」の場合、--experimental_windows_sandbox_path によって提供されるバイナリが有効で、サポートされている sandboxfs のバージョンに対応している必要があります。「auto」の場合、バイナリが存在しないか、互換性がありません。
--experimental_windows_sandbox_path=<a string>
のデフォルト: BazelSandbox.exe- --experimental_use_windows_sandbox が true の場合に使用する Windows サンドボックス バイナリのパス。ベアメタル名の場合は、PATH でその名前の最初のバイナリを使用します。
--experimental_worker_allowlist=<comma-separated set of options>
: 説明を表示-
空でない場合、特定のワーカーキーのニーモニックを備えた永続ワーカーのみを使用できます。
タグ:execution
、host_machine_resource_optimizations
--[no]experimental_worker_as_resource
のデフォルト: "true"-
No-op はまもなく削除されます。
タグ:no_op
--[no]experimental_worker_cancellation
: 「false」-
有効になっている場合、Bazel はキャンセル リクエストを、それをサポートするワーカーに送信します。
タグ:execution
--experimental_worker_memory_limit_mb=<an integer number of MBs, or "HOST_RAM", optionally followed by [-|*]<float>.>
のデフォルト: "0"-
この上限が 0 より大きい場合、ワーカーのメモリ使用量が上限を超えると、ワーカーが強制終了される可能性があります。動的実行や「--experimental_dynamic_ignore_local_signals=9」と併用しないと、ビルドがクラッシュする可能性があります。
タグ:execution
、host_machine_resource_optimizations
--experimental_worker_metrics_poll_interval=<An immutable length of time.>
のデフォルト: 「5s」-
ワーカー指標の収集とエビクションの試行の間の間隔。パフォーマンス上の理由から、事実上 1 秒未満にすることはできません。
タグ:execution
、host_machine_resource_optimizations
--[no]experimental_worker_multiplex_sandboxing
: 「false」-
有効にすると、作業リクエストごとに個別のサンドボックス ディレクトリを使用して、Multiplex ワーカーがサンドボックス化されます。サンドボックスは、「supports-multiplex-sandboxing」実行要件を持つワーカーのみをサンドボックス化します。
タグ:execution
--[no]experimental_worker_strict_flagfiles
: 「false」-
有効にすると、ワーカーの仕様に準拠していないワーカーのアクション引数がエラーになります。ワーカーの引数には、@listfile 引数を引数リストの最後の 1 つのみにする必要があります。
タグ:execution
--genrule_strategy=<comma-separated list of options>
のデフォルト: "-
genrule の実行方法を指定します。このフラグは段階的に廃止されます。代わりに、--spawn_strategy={value> を使用してすべてのアクションを制御します。または、--strategy=Genrule=<value> を使用して genrule のみを制御します。
タグ:execution
- 複数の
--high_priority_workers=<a string>
が累計されます -
No-op はまもなく削除されます。
タグ:execution
--[no]incompatible_remote_dangling_symlinks
のデフォルト: "true"-
true に設定すると、--compatibility_remote_symlinks も true に設定すると、アクション出力のシンボリック リンクがぶら下がります。
タグ:execution
、incompatible_change
--[no]incompatible_remote_symlinks
のデフォルト: "true"-
true に設定すると、Bazel はリモート キャッシュ/実行プロトコルのアクション出力でシンボリック リンクを表します。それ以外の場合は、シンボリック リンクがフォローされ、ファイルまたはディレクトリとして表されます。詳しくは #6631 をご覧ください。
タグ:execution
、incompatible_change
--[no]incompatible_sandbox_hermetic_tmp
: 「false」-
true に設定すると、各 Linux サンドボックスには、ホスト ファイル システムとの間で /tmp を共有するのではなく、/tmp としてマウントされた専用の専用ディレクトリが作成されます。すべてのサンドボックスでホストの/tmp を確認するには、--sandbox_add_mount_pair=/tmp を使用します。
タグ:execution
--[no]internal_spawn_scheduler
: 「false」-
スポーン スケジューラが有効かどうかを Blaze で指定するためのプレースホルダ オプション。
タグ:execution
、host_machine_resource_optimizations
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] デフォルト: "auto"-
実行する同時実行ジョブの数。整数またはキーワード("auto"、"HOST_CPUS"、"HOST_RAM")を取り、その後に演算子(-|*]<float>)を続けて使用します。例:"auto"、"HOST_CPUS*.5"。値は 1 ~ 5000 にする必要があります。2,500 を超える値は、メモリの問題を引き起こす可能性があります。「auto」は、ホストリソースに基づいて妥当なデフォルトを計算します。
タグ:host_machine_resource_optimizations
、execution
--[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"、"HOST_CPUS"、"HOST_RAM")を取ることができ、必要に応じてオペレーション(-[*]<float>)が続きます。"auto"、"HOST_CPUS*.5"。「auto」は、ホストリソースに基づいて適切なデフォルトを設定します。1 以上の値にする必要があります。
タグ:bazel_internal_configuration
--[no]reuse_sandbox_directories
: 「false」-
true に設定すると、ワーカー以外のサンドボックス実行で使用されるディレクトリが再利用され、不要なセットアップ コストを回避できます。
タグ:host_machine_resource_optimizations
、execution
--sandbox_base=<a string>
のデフォルト: "-
このパスの下にサンドボックス ディレクトリを作成します。tmpfs にパスを指定すると(/run/shm など)、ビルド / テストに多くの入力ファイルがある場合にパフォーマンスが大幅に向上する可能性があります。注: アクションの実行によって生成された出力ファイルと中間ファイルを保持するのに十分な RAM と空き容量が必要です。
タグ:host_machine_resource_optimizations
、execution
--[no]sandbox_explicit_pseudoterminal
: 「false」-
サンドボックス化されたアクションの疑似端末の作成を明示的に有効にします。一部の Linux ディストリビューションでは、疑似デバイスが機能するために、プロセスのグループ ID をサンドボックス内で「tty」に設定する必要があります。これが問題の原因となっている場合、このフラグを無効にして、他のグループを使用できるようにすることができます。
タグ:execution
- 複数の
--sandbox_tmpfs_path=<an absolute path>
が累計されます - サンドボックス化されたアクションの場合は、この絶対パスに空の書き込み可能なディレクトリをマウントします(サンドボックス実装でサポートされている場合は、無視されます)。
タグ:host_machine_resource_optimizations
、execution
--[no]skip_incompatible_explicit_targets
: 「false」-
コマンドラインに明示的に記載されている互換性のないターゲットはスキップします。デフォルトでは、このようなターゲットをビルドするとエラーが発生しますが、このオプションが有効になっていると、ターゲットが通知なくスキップされます。参照: https://bazel.build/extending/platforms#skipping-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>
が累計されます -
生成された他のアクションのコンパイル方法を指定します。戦略の優先順位を最も高いものから順に指定します。Bazel は、アクションごとに、そのアクションを実行できる優先度が最も高い戦略を選択します。デフォルト値は "remote,worker,sandboxed,local" です。このフラグは、--spawn_strategy で設定された値をオーバーライドします(ニーモニック Genrule とともに使用する場合は --genrule_strategy)。詳しくは https://blog.bazel.build/2019/06/19/list-strategy.html をご覧ください。
タグ:execution
- 複数の
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
が累計されます -
特定の 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」戦略で「コンパイル //foo/bar/baz」を実行しますが、順序を逆にすると、「sandboxed」で実行します。
タグ:execution
- 複数の
--worker_extra_flag=<a 'name=value' assignment>
が累計されます -
ニーモニック(--worker_extra_flag=Javac=--debug)をキーに、--persistent_workers に加えてワーカー プロセスに渡される追加のコマンドフラグ。
タグ:execution
、host_machine_resource_optimizations
- 複数の
--worker_max_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
が累計されます -
「ワーカー」戦略を使用する場合、各永続ワーカーのインスタンスの数が起動されます。名前ごとに異なる値を指定するために [name=value] として指定できます。上限は、ニーモニックで区別されるワーカーキーに基づいているだけでなく、起動フラグと環境にも基づいています。そのため、場合によっては、このフラグよりも多くのワーカーがワーカーを 1 つ覚えている可能性があります。整数またはキーワード("auto"、"HOST_CPUS"、"HOST_RAM")を取り、その後に演算子(-|*]<float>)を続けて使用します。例:"auto"、"HOST_CPUS*.5"。「auto」は、マシンの容量に基づいて妥当なデフォルトを計算します。「=value」は、指定されていないニーモニックのデフォルトを設定します。
タグ:execution
、host_machine_resource_optimizations
- 複数の
--worker_max_multiplex_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
が累計されます -
--experimental_worker_multiplex で「worker」戦略を使用すると、Multiplex ワーカー プロセスが同時に受信できる WorkRequest の数。名前ごとに異なる値を指定するために [name=value] として指定できます。上限は、ニーモニックで区別されるワーカーキーに基づいているだけでなく、起動フラグと環境にも基づいています。そのため、場合によっては、このフラグよりも多くのワーカーがワーカーを 1 つ覚えている可能性があります。整数またはキーワード("auto"、"HOST_CPUS"、"HOST_RAM")を取り、その後に演算子(-|*]<float>)を続けて使用します。例:"auto"、"HOST_CPUS*.5"。「auto」は、マシンの容量に基づいて妥当なデフォルトを計算します。「=value」は、指定されていないニーモニックのデフォルトを設定します。
タグ:execution
、host_machine_resource_optimizations
--[no]worker_multiplex
のデフォルト: "true"-
有効にすると、ワーカーが多重化をサポートしている場合、それが使用されます。
タグ:execution
、host_machine_resource_optimizations
--[no]worker_quit_after_build
: 「false」-
有効にすると、ビルドの完了後にすべてのワーカーが終了します。
タグ:execution
、host_machine_resource_optimizations
--[no]worker_sandboxing
: 「false」-
有効にすると、ワーカーはサンドボックス環境で実行されます。
タグ:execution
--[no]worker_verbose
: 「false」- 有効にすると、ワーカーの開始時、シャットダウン時、詳細メッセージを出力します。
--[no]incompatible_disable_runtimes_filegroups
: 「false」-
no-op のサポートが終了しました。
タグ:action_command_lines
、loading_and_analysis
、deprecated
、incompatible_change
--[no]incompatible_dont_emit_static_libgcc
のデフォルト: "true"-
no-op のサポートが終了しました。
タグ:action_command_lines
、loading_and_analysis
、deprecated
、incompatible_change
--[no]incompatible_linkopts_in_user_link_flags
のデフォルト: "true"-
no-op のサポートが終了しました。
タグ:action_command_lines
、loading_and_analysis
、deprecated
、incompatible_change
--target_platform_fallback=<a string>
のデフォルト: "-
このオプションは非推奨であり、効果はありません。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
--[no]build
のデフォルト: "true"-
ビルドを実行します。これは通常の動作です。--nobuild を指定すると、ビルド アクションを実行する前にビルドが停止し、パッケージの読み込みフェーズと分析フェーズが正常に完了した場合にゼロが返されます。このモードは、これらのフェーズをテストするのに便利です。
タグ:execution
、affects_outputs
--[no]experimental_run_validations
のデフォルト: "true"-
代わりに --run_validations を使用してください。
タグ:execution
、affects_outputs
--[no]experimental_use_validation_aspect
: 「false」- アスペクトを使用して検証アクションを実行するかどうか(テストとの並列処理の場合)。
タグ:execution
、affects_outputs
- 複数の
--output_groups=<comma-separated list of options>
が累計されます -
出力グループ名のカンマ区切りのリスト。各接頭辞に + または - を付けることもできます。また、+ で始まるグループはデフォルトの出力グループセットに追加され、「-」で始まるグループはデフォルト セットから削除されます。接頭辞を持たないグループが 1 つ以上ある場合、デフォルトの出力グループセットは省略されます。たとえば、--output_groups=+foo,+bar と指定すると、デフォルトのセット、foo、bar を結合し、--output_groups=foo,bar は、デフォルトのセットが foo と bar だけで構成されるようにオーバーライドします。
タグ:execution
、affects_outputs
--[no]run_validations
のデフォルト: "true"-
ビルドの一環として検証アクションを実行するかどうかを指定します。https://bazel.build/extending/rules#validation_actions をご覧ください
タグ:execution
、affects_outputs
- 複数の
--aspects=<comma-separated list of options>
が累計されます - トップレベル ターゲットに適用するアスペクトのリスト(カンマ区切り)。リスト内で、なんらかの some_aspect が required_aspect_providers を介して必要なアスペクト プロバイダを指定している場合、some_aspect は、アドバタイズされるプロバイダが some_aspect の必要なアスペクト プロバイダを満たすアスペクトのリストで前述されているすべてのアスペクトの後に実行されます。さらに、some_aspect は、requires 属性で指定されたすべての必須要素の後に実行されます。some_aspect は、それらの側面のプロバイダの値にアクセスできます。<bzl-file-label>%<aspect_name>。例: '//tools:my_def.bzl%my_aspect'。ここで、'my_aspect' は file tools/my_def.bzl の最上位値です。
--bep_maximum_open_remote_upload_files=<an integer>
のデフォルト: "-1"-
BEP アーティファクトのアップロード中に許可される最大オープン ファイル数。
タグ:affects_outputs
--[no]experimental_convenience_symlinks
のデフォルト: "normal"-
このフラグは、コンビニエンス シンボリック リンク(ビルド後にワークスペースに表示されるシンボリック リンク)を管理する方法を管理します。有効な値: normal(デフォルト): ビルドの判断に基づいて、個々の種類のコンビニエンス シンボリック リンクが作成または削除されます。
clean: すべてのシンボリック リンクが無条件に削除されます。
無視: シンボリック リンクは残されます。log_only: 「normal」が渡されたかのようにログメッセージを生成しますが、ファイルシステム オペレーションは実際に実行しません(ツールに役立ちます)。
影響を受けるのは、現在の値 --symlink_prefix で名前が生成されるシンボリック リンクのみです。プレフィックスが変更されても既存のシンボリック リンクはそのまま残ります。
タグ:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
: 「false」- このフラグは、ビルド イベント ConenienceSymlinksIdentified を BuildEventProtocol に送信するかどうかを制御します。値が true の場合、BuildEventProtocol にコンビニエンス SymlinksIdentified のエントリが含まれ、ワークスペースで作成されたすべてのコンビニエンス シンボリック リンクがリストされます。false の場合、BuildEventProtocol のコンビニエンス SymlinksIdentified エントリが空になります。
タグ:affects_outputs
- 複数の
--experimental_multi_cpu=<comma-separated list of options>
が累計されます -
非推奨。No-op。
タグ:affects_outputs
、experimental
--[no]incompatible_use_platforms_repo_for_constraints
のデフォルト: "true"-
no-op のサポートが終了しました。
タグ:affects_outputs
、incompatible_change
--remote_download_minimal
-
リモートビルドの出力をローカルマシンにダウンロードしません。このフラグは、フラグ --action_cache_store_output_metadata、--experimental_inmemory_jdeps_files、--experimental_inmemory_dotd_files、--remote_download_outputs=minimal のショートカットです。
以下に展開:
--nobuild_runfile_links
--action_cache_store_output_metadata
--remote_download_outputs=minimal
タグ:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
: 「すべて」-
「minimal」に設定した場合、ローカルビルドに必要なリモートビルド出力がローカルマシンにダウンロードされません。「toplevel」に設定すると、トップレベル ターゲットの出力もローカルマシンにダウンロードされる点を除いて「minimal」と同じように動作します。どちらの方法でも、ネットワーク帯域幅がボトルネックになるとビルド時間が大幅に短縮されます。
タグ:affects_outputs
--remote_download_symlink_template=<a string>
のデフォルト: "-
リモートビルドの出力をローカルマシンにダウンロードするのではなく、シンボリック リンクを作成します。シンボリック リンクのターゲットは、テンプレート文字列の形式で指定できます。このテンプレート文字列には {hash} と {size_bytes} が含まれ、それぞれオブジェクトのハッシュとサイズ(バイト単位)に展開されます。たとえば、これらのシンボリック リンクは、オンデマンドで CAS からオブジェクトを読み込む FUSE ファイル システムを指す場合があります。
タグ:affects_outputs
--remote_download_toplevel
-
最上位ターゲットのリモート出力のみをローカルマシンにダウンロードします。このフラグは、--action_cache_store_output_metadata、--experimental_inmemory_jdeps_files、--experimental_inmemory_dotd_files、--remote_download_outputs=toplevel フラグのショートカットです。
以下に展開:
--action_cache_store_output_metadata
--remote_download_outputs=toplevel
タグ:affects_outputs
--symlink_prefix=<a string>
: 説明を表示-
ビルド後に作成されたコンビニエンス シンボリック リンクの先頭に付加される接頭辞。省略した場合のデフォルト値は、ハイフンとその後のビルドツール名です。「/」を渡してもシンボリック リンクは作成されず、警告は出力されません。警告: 「/」の特殊機能はまもなく非推奨となります。代わりに --experimental_convenience_symlinks=ignore を使用してください。
タグ:affects_outputs
--[no]experimental_docker_privileged
: 「false」-
有効になっている場合、Bazel はアクションの実行時に --privileged フラグを「docker run」に渡します。これはビルドで必要になることがありますが、密閉性が低下する可能性もあります。
タグ:execution
--experimental_repository_hash_file=<a string>
のデフォルト: "-
空でない場合、リポジトリ ディレクトリのハッシュを検証する必要がある値を含むファイルを指定します。
タグ:affects_outputs
、experimental
--[no]experimental_sandboxfs_map_symlink_targets
: 「false」-
true の場合、アクション入力として指定されたシンボリック リンクのターゲットをサンドボックスにマッピングします。この機能は、純粋にバグの再発を防ぐためのバグルールを回避するためのものであり、すべてのルールを修正したうえで削除する必要があります。
タグ:host_machine_resource_optimizations
、execution
- 複数の
--experimental_verify_repository_rules=<a string>
が累計されます -
出力ディレクトリのハッシュを検証する必要があるリポジトリ ルールのリストの場合、ファイルは --experimental_repository_hash_file で指定します。
タグ:affects_outputs
、experimental
--[no]incompatible_legacy_local_fallback
: 「false」-
true に設定すると、サンドボックス戦略からローカル戦略への従来の暗黙的なフォールバックが有効になります。このフラグは、最終的にはデフォルトで false になり、その後 no-op になります。代わりに、--strategy、--spawn_strategy、または --dynamic_local_strategy を使用してフォールバックを構成します。
タグ:execution
、incompatible_change
- 複数の
--sandbox_add_mount_pair=<a single path or a 'source:target' pair>
が累計されます -
サンドボックスにマウントするパスペアを追加する。
タグ:execution
- 複数の
--sandbox_block_path=<a string>
が累計されます - サンドボックス化されたアクションの場合、このパスへのアクセスを禁止します。
タグ:execution
--[no]sandbox_default_allow_network
のデフォルト: "true"- アクションに対して、デフォルトでネットワーク アクセスを許可します。ただし、これはすべてのサンドボックス実装で利用できるわけではありません。
--[no]sandbox_fake_hostname
: 「false」-
サンドボックス化されたアクションについては、現在のホスト名を localhost に変更します。
タグ:execution
--[no]sandbox_fake_username
: 「false」-
サンドボックス化されたアクションの現在のユーザー名を「nobody」に変更します。
タグ:execution
- 複数の
--sandbox_writable_path=<a string>
が累計されます -
サンドボックス化されたアクションについては、既存のディレクトリをサンドボックス内で書き込み可能にします(サンドボックス実装でサポートされている場合、それ以外の場合は無視されます)。
タグ:execution
--[no]experimental_allow_top_level_aspects_parameters
のデフォルト: "true"-
No-op
タグ:no_op
、deprecated
、experimental
--[no]incompatible_config_setting_private_default_visibility
: 「false」-
compatible_enforce_config_setting_visibility=false の場合、これは noop です。このフラグを false に設定すると、明示的な可視性属性のない config_setting は //visibility:public になります。このフラグが true の場合、config_setting は他のすべてのルールと同じ可視性ロジックに従います。https://github.com/bazelbuild/bazel/issues/12933 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_enforce_config_setting_visibility
のデフォルト: "true"-
true の場合、config_setting 公開制限を適用します。false の場合、すべての config_setting がすべてのターゲットに表示されます。https://github.com/bazelbuild/bazel/issues/12932 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]check_tests_up_to_date
: 「false」-
テストは実行せず、最新かどうかだけを確認する。すべてのテスト結果が最新の状態であれば、テストは正常に完了しています。テストをビルドまたは実行する必要がある場合、エラーが報告され、テストは失敗します。このオプションは、--check_up_to_date の動作を意味します。
タグ:execution
- 複数の
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
が累計されます -
各テストは、テストが失敗した場合に、指定した回数まで再試行されます。複数回合格しなければならないテストは、テストの概要で「FLAKY」とマークされます。通常、指定する値は整数または文字列「default」のみです。整数の場合、すべてのテストは最大 N 回実行されます。「default」の場合、通常のテストでは 1 回のテストのみが行われ、ルールによって(flaky=1 属性によって)明示的にマークされたテストは 3 回行われます。別の構文: regex_filter@flaky_test_attemptsflaky_test_attempts は上記のとおりで、regex_filter は正規表現の包含と除外のリストを表します(--runs_per_test もご覧ください)。例: --flaky_test_attempts=//foo/.*、-//foo/bar/.*@3 は、foo/bar の下にあるテストを除くすべてのテストを //foo/に 3 回デフレークします。このオプションは複数回渡すことができます。最も最近渡された、一致する引数が優先されます。一致するものがない場合、その動作は上記の「デフォルト」のようになります。
タグ: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"、"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」で使用する基本一時ディレクトリを指定します。
- 複数の
--allow_yanked_versions=<a string>
が累計されます -
モジュール バージョンは、発生元であるレジストリで(NonRegistryOverride のもの以外から)yanked が宣言されている場合でも、解決された依存関係グラフで許可する「<module1>@<version1>,<module2>@<version2>」の形式で指定します。そうしないと、ジャンクされたバージョンが原因で解決に失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可される yanked バージョンを定義することもできます。このチェックを無効にするには、キーワード「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 の場合、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」は無視されます。このフラグの値に関係なく、MODULE.bazel がルート モジュールでない場合、これらの dev 依存関係は常に無視されます。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: "off"-
ロックファイルを使用するかどうかを指定します。有効な値は、lockfile を使用して更新する場合は「update」、変更がある場合は「lock」、最新ではない場合はエラーをスローし、lockfile からの読み取りと書き込みを行わない場合は「off」です。
タグ:loading_and_analysis
- 複数の
--override_module=<an equals-separated mapping of module name to path>
が累計されます - <module name>=<path> の形式のローカルパスでモジュールをオーバーライドします。指定されたパスが絶対パスである場合、そのパスが使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリへの相対パスになります。パスが %workspace% で始まる場合は、ワークスペースのルート(「bazel info workspace」の出力)への相対パスになります。
- 複数の
--registry=<a string>
が累計されます -
Bazel モジュールの依存関係を見つけるために使用するレジストリを指定します。順序は重要です。つまり、最初に古いレジストリでモジュールが検索され、以前のレジストリに欠落している場合にのみ、後続のレジストリにフォールバックします。
タグ:changes_inputs
--experimental_gc_thrashing_limits=<comma separated pairs of <period>:<count>>
のデフォルト: "-
到達した場合、GcThrashingDetector が OOM で Bazel をクラッシュさせる制限。それぞれの上限は <period>:<count> と指定します。period は期間、count は正の整数です。<period> 内に <count> 個の連続した GC が続くと、在室スペース(古い世代のヒープ)の --experimental_oom_more_eagerly_threshold パーセントを超えると、OOM がトリガーされます。複数の上限をカンマ区切りで指定できます。
タグ:host_machine_resource_optimizations
--[no]gc_thrashing_limits_retained_heap_limiter_mutually_exclusive
のデフォルト: "true"-
true の場合、空でない --experimental_gc_thrashing_limits を指定すると、RetainedHeapLimiter が非アクティブになり、GcThrashingDetector と相互に排他的になります。false に設定すると、同じコマンドで両方ともアクティブになります。
タグ: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 で設定されたしきい値を超えたことを検出した場合、呼び出しごとに最大回数の不完全な一時的な 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 状態を削除します。これを微調整することで、(i)GC スラッシングが(i)この一時的な状態のメモリ使用に起因し、(ii)必要になったときに状態を再構築するよりもコストが高くなる場合に、GC スラッシングのウォールタイムの影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
--[no]announce
: 「false」-
非推奨。No-Ops。
タグ:affects_outputs
--[no]debug_spawn_scheduler
: 「false」--[no]experimental_bep_target_summary
: 「false」- TargetSummary イベントを公開するかどうかを指定します。
--[no]experimental_build_event_expand_filesets
: 「false」-
true の場合、出力ファイルを表示するときに BEP のファイルセットを展開します。
タグ:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: 「false」-
true の場合、出力ファイルを表示する際に、BEP 内の相対ファイルセット シンボリック リンクを完全に解決します。--experimental_build_event_expand_filesets が必要です。
タグ:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
: 「4」-
Bazel がビルドイベントのアップロードを再試行する最大回数。
タグ:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
のデフォルト: 「1s」-
BEP のアップロードが失敗した場合の指数バックオフの再試行の最小遅延。(指数: 1.6)
タグ:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
: 説明を表示- ビルドイベント プロトコルで参照されるアーティファクトをアップロードする方法を選択します。
タグ:affects_outputs
--[no]experimental_collect_local_sandbox_action_metrics
のデフォルト: "true"-
有効にすると、サンドボックスを使用するローカル実行アクションの実行統計情報(ユーザーやシステム時刻など)が記録されます。
タグ:execution
--[no]experimental_command_profile
: 「false」- Java Flight Recorder の CPU プロファイルを出力ベース ディレクトリの profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプまたは出力形式をサポートするように将来変更される場合があります。自己責任で使用してください。
--[no]experimental_docker_verbose
: 「false」-
有効にすると、Bazel は Docker サンドボックス戦略に関する詳細なメッセージを出力します。
タグ:execution
--[no]experimental_materialize_param_files_directly
: 「false」-
パラメータ ファイルを実体化する場合は、ディスクへの直接書き込みを行います。
タグ:execution
--[no]experimental_record_metrics_for_all_mnemonics
: 「false」- デフォルトでは、アクション タイプの数は、実行されているアクションの数が最も多い 20 ニーモニックに制限されます。このオプションを設定すると、すべての覚え書きの統計情報が書き込まれます。
--experimental_repository_resolved_file=<a string>
のデフォルト: "-
空でない場合は、実行されたすべての Starlark リポジトリ ルールの解決された情報を含む Starlark 値を記述します。
タグ:affects_outputs
--[no]experimental_stream_log_file_uploads
: 「false」-
ログファイルがディスクに書き込まれるのではなく、リモート ストレージに直接アップロードされます。
タグ:affects_outputs
--explain=<a path>
: 説明を表示- : ビルドシステムが、ビルドの実行された各ステップを説明します。説明は指定したログファイルに書き込まれます。
タグ:affects_outputs
--[no]legacy_important_outputs
のデフォルト: "true"-
このパラメータを使用して、TargetComplete イベントで従来の有効期間が長い有効期間フィールドの抑制を図ります。Bazel と ResultStore の統合には、required_outputs が必要です。
タグ:affects_outputs
--[no]materialize_param_files
: 「false」-
リモート アクション実行を使用している場合でも、中間パラメータ ファイルを出力ツリーに書き込みます。アクションをデバッグする場合に便利です。これは --subcommands と --verbose_failures によって暗黙的に指定されます。
タグ:execution
--max_config_changes_to_show=<an integer>
: 「3」-
ビルド オプションの変更により分析キャッシュを破棄すると、変更されたオプション名が最大数まで表示されます。数字が -1 の場合は、変更されたオプションがすべて表示されます。
タグ:terminal_output
--max_test_output_bytes=<an integer>
のデフォルト: "-1"-
--test_output が「errors」または「all」のときに出力できるテストログごとの最大サイズを指定します。過度にノイズの多いテスト出力で、出力の過負荷を回避するために役立ちます。テストヘッダーはログサイズに含まれます。負の値は制限がないことを意味します。出力はオール オア ナッシングです。
タグ:test_runner
、terminal_output
、execution
--output_filter=<a valid Java regular expression>
: 説明を表示-
指定した正規表現に一致する名前を持つルールの警告のみを表示します。
タグ:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
のデフォルト: "0"-
実行中のジョブに関する報告の間隔(秒)。デフォルト値 0 を指定すると、最初のレポートは 10 秒後に出力され、30 秒後に進捗状況が 1 分に 1 回レポートされます。--curses を有効にすると、1 秒ごとに進捗状況が報告されます。
タグ:affects_outputs
--remote_print_execution_messages=<failure, success or all>
のデフォルト: 「失敗」-
リモート実行メッセージを出力するタイミングを選択します。有効な値は「failure」、失敗時にのみ出力する場合は「success」、成功時にのみ出力する場合は「success」、常に出力する場合は「all」です。
タグ:terminal_output
--[no]sandbox_debug
: 「false」-
サンドボックス機能のデバッグ機能を有効にします。これには、次の 2 つが含まれます。まず、ビルド後にサンドボックスのルート コンテンツが変更されず、(sandboxfs が使用されている場合はファイル システムがマウントされたままになります)次に、実行時に追加のデバッグ情報が出力されます。これは、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」、--test_strategy 値に関係なく、テストをローカルで一度に 1 つずつ実行する「ストリーミング」です。
タグ:test_runner
、terminal_output
、execution
--test_summary=<short, terse, detailed, none or testcase>
のデフォルト: "short"-
テストの概要の形式を指定します。有効な値は、実行したテストに関する情報のみを表示する「short」、失敗したテストに関する情報のみを表示する「details」、失敗したテストケースに関する詳細情報を表示する「detail」、テストケースの解決で詳細情報を出力する「testcase」、概要を省略する「none」です。
タグ:terminal_output
--[no]verbose_explanations
: 「false」-
--explain が有効になっている場合に発行される説明の詳細度を高くします。--explain が有効になっていない場合、効果はありません。
タグ:affects_outputs
--[no]verbose_failures
: 「false」-
コマンドが失敗した場合は、コマンドライン全体を出力します。
タグ:terminal_output
- 複数の
--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>
のデフォルト: "-
空でない場合、WORKFILE ファイルの代わりに指定された解決済みファイルを読み取る。
タグ: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 つのパターン(一致するもの、代替 URL として使用するもの)が続きます。$1 で始まるバック参照、つまり、複数の URL の REC ディレクティブによって試行できます。
--[no]experimental_guard_against_concurrent_changes
: 「false」- この設定をオフにすると、リモート キャッシュにアップロードする前に、アクションの入力ファイルの確認を無効にすることができます。Linux カーネルがファイルの書き込みを遅延させ、誤検出を引き起こす場合があります。
--[no]experimental_remote_cache_async
: 「false」- true の場合、リモート キャッシュ I/O は、スポーンの一部として行われるのではなく、バックグラウンドで行われます。
--experimental_remote_cache_eviction_retries=<an integer>
のデフォルト: "0"-
ビルドでリモート キャッシュのエビクション エラーが発生した場合の再試行の最大回数。値が 0 でない場合は、暗黙的に --compatible_remote_use_new_exit_code_for_lost_inputs が true に設定されます。
タグ:execution
--experimental_remote_cache_ttl=<An immutable length of time.>
のデフォルト: 「3h」-
ActionResult や FindMissingBlob などによって、ダイジェストが最近参照された後のリモート キャッシュ内の blob の最小限の TTL が保証されます。Bazel は、blob の TTL に基づいて、複数の最適化を行います。たとえば、増分ビルドで GetActionResult を繰り返し呼び出すことはありません。この値は、サーバーがダイジェストを返す時点と Bazel がダイジェストを受け取る時点の間に時間差があるため、実際の TTL よりわずかに小さい値に設定する必要があります。
タグ:execution
--experimental_remote_capture_corrupted_outputs=<a path>
: 説明を表示- 破損した出力をキャプチャするディレクトリのパス。
--[no]experimental_remote_discard_merkle_trees
: 「false」- true に設定すると、GetActionResult() および Execute() の呼び出し中に、入力ルートのマークルツリーと関連する入力マッピングのメモリ内コピーが破棄されます。これにより、メモリ使用量が大幅に削減されますが、リモート キャッシュのミスまたは再試行時に Bazel が再計算する必要があります。
--experimental_remote_downloader=<a string>
: 説明を表示- リモート ダウンロード プロキシとして使用する Remote Asset API エンドポイント URI。サポートされているスキーマは、grpc、grpcs(TLS が有効な grpc)、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_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: "off"- リポジトリの取得に使用するスレッドモード。「off」に設定した場合、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、プラットフォーム スレッド(OS スレッドなど)を「platform」に設定するか、仮想スレッドを「virtual」に設定します。
--[no]incompatible_remote_build_event_upload_respect_no_cache
: 「false」- 非推奨。機能しません。代わりに --remote_build_event_upload=minimal を使用してください。
--[no]incompatible_remote_disallow_symlink_in_tree_artifact
のデフォルト: "true"-
true に設定すると、リモートから実行されたアクションは、相対シンボリック リンクを含むツリー アーティファクトを生成できません。このフラグに関係なく、絶対シンボリック リンクは使用できません。
タグ:execution
、incompatible_change
--[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"-
true に設定すると、--noremote_upload_local_results と --noremote_accept_cached は、ディスク キャッシュに適用されません。--disk_cache と --remote_cache の両方が設定されている場合(複合キャッシュ):
--noremote_upload_local_results により、結果はディスク キャッシュに書き込まれますが、リモート キャッシュにはアップロードされません。
--noremote_accept_cached は、Bazel によるディスク キャッシュの結果の確認は行いますが、リモート キャッシュの結果は確認しません。
no-remote-exec アクションがディスク キャッシュにヒットする可能性があります。詳しくは #8216 をご覧ください。
タグ:incompatible_change
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
のデフォルト: "true"-
true に設定すると、ビルド時にリモート キャッシュが blob を削除する場合、Bazel は新しい終了コード 39 を使用します。
タグ:incompatible_change
--[no]remote_accept_cached
のデフォルト: "true"- リモートでキャッシュに保存されたアクションの結果を受け入れるかどうか。
--remote_build_event_upload=<all or minimal>
のデフォルト: "minimal"- 「all」に設定すると、BEP によって参照されるすべてのローカル出力がリモート キャッシュにアップロードされます。 「minimal」に設定すると、BEP によって参照されるローカル出力はリモート キャッシュにアップロードされません。ただし、BEP を使用する重要なファイル(テストログ、タイミング プロファイルなど)は除きます。リモート キャッシュにファイルがない場合でも、bytestream:// スキームは常にファイルの URI に使用されます。デフォルトは「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 が有効な grpc)と UNIX(ローカルの UNIX ソケット)です。スキーマが指定されていない場合、Bazel はデフォルトで grpcs になります。TLS を無効にするには、grpc://、http://、または unix: スキーマを指定します。https://bazel.build/remote/caching を参照してください。
--[no]remote_cache_compression
: 「false」- 有効にすると、zstd を使用してキャッシュ blob を圧縮/解凍します。
- 複数の
--remote_cache_header=<a 'name=value' assignment>
が累計されます - キャッシュ リクエストに含めるヘッダーを指定します(--remote_cache_header=Name=Value)。フラグを複数回指定することで、複数のヘッダーを渡すことができます。同じ名前を持つ複数の値は、カンマ区切りのリストに変換されます。
- 複数の
--remote_default_exec_properties=<a 'name=value' assignment>
が累計されます - 実行プラットフォームで exec_properties が設定されていない場合は、リモート実行プラットフォームとして使用するデフォルトの exec プロパティを設定します。
タグ:affects_outputs
--remote_default_platform_properties=<a string>
のデフォルト: "- 実行プラットフォームに remote_execution_properties が設定されていない場合、リモート実行 API のデフォルトのプラットフォーム プロパティを設定します。この値は、ホスト実行プラットフォームがリモート実行の実行プラットフォームとして選択された場合にも使用されます。
- 複数の
--remote_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 が有効な grpc)、UNIX(ローカルの UNIX ソケット)です。スキーマが指定されていない場合、Bazel はデフォルトで grpcs になります。TLS を無効にするには、grpc:// または unix: スキーマを指定します。
--remote_grpc_log=<a path>
: 説明を表示- 指定した場合、gRPC 呼び出しに関連する詳細情報をログに記録するファイルのパス。このログは、シリアル化された com.google.devtools.build.lib.remote.logging.RemoteExecutionLog.LogEntry protobuf のシーケンスで構成されており、各メッセージには、次のシリアル化された protobuf メッセージのサイズを示す varint が接頭辞として付加されています(メソッド LogLog.writeDelimitedTo(OutputStream) によって実行されます)。
- 複数の
--remote_header=<a 'name=value' assignment>
が累計されます - リクエストに含めるヘッダーを指定します(--remote_header=Name=Value)。フラグを複数回指定することで、複数のヘッダーを渡すことができます。同じ名前を持つ複数の値は、カンマ区切りのリストに変換されます。
--remote_instance_name=<a string>
のデフォルト: "- リモート実行 API で instance_name として渡す値。
--[no]remote_local_fallback
: 「false」- リモート実行が失敗した場合にスタンドアロンのローカル実行戦略にフォールバックするかどうか。
--remote_local_fallback_strategy=<a string>
のデフォルト: "local"- NoOps は非推奨です。詳しくは、https://github.com/bazelbuild/bazel/issues/7480 をご覧ください。
--remote_max_connections=<an integer>
: 「100」-
リモート キャッシュ/エグゼキュータへの同時接続の最大数を制限します。デフォルト値は 100 です。0 に設定すると、制限はありません。
HTTP リモート キャッシュの場合、1 つの TCP 接続で一度に 1 つのリクエストを処理できるため、Bazel は最大 ---remote_max_connections の同時リクエストを行うことができます。gRPC リモート キャッシュ/エグゼキュータの場合、1 つの gRPC チャネルで 100 を超える同時リクエストを処理できるため、Bazel は約 ----remote_max_connections × 100 の同時リクエストを処理できます。
タグ:host_machine_resource_optimizations
--remote_proxy=<a string>
: 説明を表示- プロキシを介してリモート キャッシュに接続します。現在、このフラグは Unix ドメイン ソケット(unix:/path/to/socket)の構成にのみ使用できます。
--remote_result_cache_priority=<an integer>
のデフォルト: "0"- リモート キャッシュに格納されるリモート アクションの相対的な優先度。特定の優先度値のセマンティクスはサーバーによって異なります。
--remote_retries=<an integer>
: 「5」- 一時的なエラーを再試行する最大回数。0 に設定すると、再試行は無効になります。
--remote_retry_max_delay=<An immutable length of time.>
のデフォルト: 「5s」- リモート再試行間の最大バックオフ遅延。使用できる単位は、日(d)、時間(h)、分(m)、秒(s)、ミリ秒(ms)です。単位を省略すると、値は秒とみなされます。
--remote_timeout=<An immutable length of time.>
のデフォルト: 「60s」- リモート実行とキャッシュ呼び出しを待機する最大時間。REST キャッシュの場合、これは接続タイムアウトと読み取りタイムアウトの両方です。使用できる単位は、日(d)、時間(h)、分(m)、秒(s)、ミリ秒(ms)です。単位を省略すると、値は秒とみなされます。
--[no]remote_upload_local_results
のデフォルト: "true"- リモートで実行され、ユーザーが権限が付与されている場合に、ローカルで実行されたアクションの結果をリモート キャッシュにアップロードするかどうかを指定します。
--[no]remote_verify_downloads
のデフォルト: "true"- true に設定すると、Bazel はすべてのリモート ダウンロードのハッシュの合計を計算し、リモートにキャッシュされた値が想定値と一致しない場合は破棄します。
--auto_output_filter=<none, all, packages or subpackages>
のデフォルト: "none"- --output_filter が指定されていない場合、このオプションの値を使用してフィルタが自動的に作成されます。指定できる値は「none」(フィルタなし / すべて表示)、すべて(「すべて」 / 表示なし)、「packages」(Blaze コマンドラインで言及されているパッケージ内のルールからの出力を含む)、および「subpackages」(パッケージなど。サブパッケージも含まれます)です。「packages」と「subpackages」の値の場合、//java/foo と //javatests/foo は 1 つのパッケージとして扱われます)。
--[no]build_manual_tests
: 「false」- 「手動」とタグ付けされたテスト ターゲットを強制的にビルドします。「手動」テストは処理から除外されます。このオプションにより、強制的にビルドされます(実行はされません)。
--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" が引き続き使用されている場合、ビルドシステムからその苦情が寄せられることがあります。この問題は、--delete_packages x/y と指定すると回避されます。
--[no]discard_analysis_cache
: 「false」- 分析フェーズが完了したらすぐに分析キャッシュを破棄します。メモリ使用量が最大 10% 減少しますが、増分ビルドはさらに遅くなります。
--disk_cache=<a path>
: 説明を表示- Bazel がアクションとアクション出力の読み取りと書き込みを行えるディレクトリのパス。ディレクトリが存在しない場合は、作成されます。
--embed_label=<a one-line string>
のデフォルト: "- ソース管理のリビジョンまたはリリースラベルをバイナリに埋め込む
--execution_log_binary_file=<a path>
: 説明を表示- src/main/protobuf/spawn.proto に従って、実行された生成をこのファイルに区切りの Spawn proto として記録します。ログは、順序付けされていない状態で最初に書き込まれ、呼び出しの最後には安定した順序で並べられます(CPU とメモリを大量に消費する可能性があります)。関連フラグ: --execution_log_json_file(順序付きテキスト JSON 形式)、--experimental_execution_log_file(順序なしバイナリ protobuf 形式)、--subcommands(ターミナル出力にサブコマンドを表示するためのもの)。
--execution_log_json_file=<a path>
: 説明を表示- 実行されたスポーンを、src/main/protobuf/spawn.proto に従って区切りの Spawn proto の json 表現としてこのファイルに含めます。ログは、順序付けされていない状態で最初に書き込まれ、呼び出しの最後には安定した順序で並べられます(CPU とメモリを大量に消費する可能性があります)。関連するフラグ: --execution_log_binary_file(順序付きバイナリ protobuf 形式)、--experimental_execution_log_file(順序なしバイナリ protobuf 形式)、--subcommands(ターミナル出力にサブコマンドを表示)
--[no]execution_log_sort
のデフォルト: "true"- 実行ログを並べ替えるかどうか。メモリのパフォーマンスを高めるために false に設定すると、ログが非決定的な順序で生成されます。
--[no]expand_test_suites
のデフォルト: "true"-
分析を行う前に、test_suite ターゲットを構成テストに拡張します。このフラグがオンの場合(デフォルト)、ネガティブ ターゲット パターンはテストスイートに属するテストに適用されます。それ以外の場合、適用されません。最上位レベルをコマンドラインで適用し、test_suite ターゲットを分析できる場合は、このフラグをオフにすると便利です。
タグ:loading_and_analysis
--experimental_dynamic_ignore_local_signals=<a comma-separated list of signal numbers>
: 説明を表示- OS シグナル番号のリストを取得します。動的実行のローカル ブランチがこれらのシグナルのいずれかによって強制終了された場合、リモート ブランチは代わりに終了できるようになります。永続ワーカーの場合、これはワーカー プロセスを強制終了するシグナルにのみ影響します。
タグ:execution
--experimental_execution_log_file=<a path>
: 説明を表示- src/main/protobuf/spawn.proto に従って、実行された生成をこのファイルに区切りの Spawn proto として記録します。このファイルは、Spawns の実行順に書き込まれます。関連フラグ: --execution_log_binary_file(順序付きバイナリ protobuf 形式)、--execution_log_json_file(順序付きテキスト json 形式)、--subcommands(ターミナル出力にサブコマンドを表示するためのもの)。
--[no]experimental_execution_log_spawn_metrics
: 「false」- 実行されたスポーンログにスポーン指標を含めます。
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
のデフォルト: "- いくつかの側面を重視して非推奨になりました。additional_actions をスケジュールするターゲットのセットをフィルタします。
--[no]experimental_extra_action_top_level_only
: 「false」- いくつかの側面を重視して非推奨になりました。トップレベル ターゲットに対してのみ、extra_actions をスケジュールします。
--[no]experimental_prioritize_local_actions
のデフォルト: "true"-
設定されている場合、ローカルでのみ実行できるアクションが、リソースの取得で最初に機会を与えられ、動的に実行されるワーカーが 2 回目の機会を得て、動的に実行されるスタンドアロン アクションが最後に来ます。
タグ:execution
--experimental_spawn_scheduler
-
ローカルとリモートで並行してアクションを実行することで、動的実行を有効にする。Bazel は各アクションをローカルとリモートで生成し、最初に完了したアクションを選択します。アクションがワーカーをサポートする場合、ローカル アクションは永続ワーカーモードで実行されます。個々のアクションのニーモニックで動的実行を有効にするには、代わりに「--internal_spawn_scheduler」フラグと「--strategy=<mnemonic>=dynamic」フラグを使用します。
以下に展開:
--internal_spawn_scheduler
--spawn_strategy=dynamic
--[no]experimental_worker_sandbox_hardening
: 「false」-
有効にすると、実装で許可されている場合、ワーカーは強化されたサンドボックスで実行されます。
タグ:execution
--[no]ignore_unsupported_sandboxing
: 「false」- サンドボックス化された実行がこのシステムでサポートされていない場合、警告を出力しません。
--[no]incompatible_dont_use_javasourceinfoprovider
: 「false」-
No-op
タグ:incompatible_change
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
のデフォルト: HOST_CPUS- Bazel がローカルで実行されるビルド アクションに使用できるローカル CPU コアの総数を明示的に設定します。整数または「HOST_CPUS」を取り、その後に続けて [-|*]<float>(例:HOST_CPUS*.5 を使用して、使用可能な CPU コアの半分を使用できます)。デフォルトでは、Bazel はシステム構成をクエリして使用可能な CPU コア数を推定します。
- 複数の
--local_extra_resources=<a named float, 'name=value'>
が累計されます - Bazel で利用可能な追加リソースの数を設定します。文字列と浮動小数点のペアを受け入れます。複数回使用できるため、複数の種類の追加リソースを指定できます。Bazel は、利用可能な追加のリソースと必要な追加リソースに基づいて、同時に実行されるアクションを制限します。テストでは、「resources:<resoucename>:<amount>」形式のタグを使用して、必要な追加リソースの量を宣言できます。このフラグを使用して、使用可能な CPU、RAM、リソースを設定することはできません。
--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 など)。デフォルトで "HOST_RAM*.67"(Bazel)は、システム構成を照会して使用可能な RAM の量を推定し、その 67% を使用します。
--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
--[no]experimental_inprocess_symlink_creation
: 「false」- シンボリック ツリーを作成するためにファイル システムを直接呼び出すかどうか。
タグ:loading_and_analysis
、execution
、experimental
--[no]experimental_remotable_source_manifests
: 「false」-
ソース マニフェストのアクションをリモート可能にするかどうか
タグ:loading_and_analysis
、execution
、experimental
--[no]experimental_split_coverage_postprocessing
: 「false」-
true の場合、Bazel は新しいスポーンでテストのためにカバレッジ後処理を実行します。
タグ:execution
--[no]experimental_split_xml_generation
のデフォルト: "true"-
このフラグが設定されていて、テスト アクションが test.xml ファイルを生成しない場合、Bazel は別のアクションを使用して、テストログを含むダミーの test.xml ファイルを生成します。それ以外の場合、Bazel はテスト アクションの一部として test.xml を生成します。
タグ:execution
--[no]experimental_strict_fileset_output
: 「false」-
このオプションを有効にすると、ファイルセットはすべての出力アーティファクトを通常のファイルとして扱います。ディレクトリを走査したり、シンボリック リンクに敏感だったりすることはありません。
タグ:execution
--[no]experimental_use_semaphore_for_jobs
: 「false」-
true に設定すると、セマフォを使用して同時実行ジョブの数も制限できます。
タグ:host_machine_resource_optimizations
、execution
--genrule_strategy=<comma-separated list of options>
のデフォルト: "-
genrule の実行方法を指定します。このフラグは段階的に廃止されます。代わりに、--spawn_strategy={value> を使用してすべてのアクションを制御します。または、--strategy=Genrule=<value> を使用して genrule のみを制御します。
タグ:execution
--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 ~ 5000 にする必要があります。2,500 を超える値は、メモリの問題を引き起こす可能性があります。「auto」は、ホストリソースに基づいて妥当なデフォルトを計算します。
タグ:host_machine_resource_optimizations
、execution
--[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"、"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「Genrule=+requires-x」は、すべての Genrule アクションの実行情報に「requires-x」を追加します。
'??Genrule).*=-requires-x' により、すべての Genrule 以外のアクションの実行情報から「requires-x」が削除されます。
タグ:execution
、affects_outputs
、loading_and_analysis
--persistent_android_dex_desugar
-
ワーカーを使用して永続的な Android dex と desugar のアクションを有効にします。
以下に展開:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
タグ:host_machine_resource_optimizations
、execution
--persistent_android_resource_processor
- ワーカーを使用して、永続的な Android リソース プロセッサを有効にします。
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--internal_persistent_busybox_tools
2{1/1}--strategy=Aapt2Optimize=worker
1{1/1}--strategy=AARGenerator=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_desugar
- ワーカーを使用して、永続的な多重化 Android dex と desugar アクションを有効にします。
以下に展開:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
タグ:host_machine_resource_optimizations
、execution
--persistent_multiplex_android_resource_processor
-
ワーカーを使用して、永続的な多重化 Android リソース プロセッサを有効にします。
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--persistent_android_resource_processor
2{1/1}--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
1{1/1}--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
- 永続的で多重化した Android ツール(dex 変換、脱糖、リソース処理)を有効にします。
以下に展開:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
タグ:host_machine_resource_optimizations
、execution
--[no]skip_incompatible_explicit_targets
: 「false」-
コマンドラインに明示的に記載されている互換性のないターゲットはスキップします。デフォルトでは、このようなターゲットをビルドするとエラーが発生しますが、このオプションが有効になっていると、ターゲットが通知なくスキップされます。参照: https://bazel.build/extending/platforms#skipping-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>
が累計されます -
生成された他のアクションのコンパイル方法を指定します。戦略の優先順位を最も高いものから順に指定します。Bazel は、アクションごとに、そのアクションを実行できる優先度が最も高い戦略を選択します。デフォルト値は "remote,worker,sandboxed,local" です。このフラグは、--spawn_strategy で設定された値をオーバーライドします(ニーモニック Genrule とともに使用する場合は --genrule_strategy)。詳しくは https://blog.bazel.build/2019/06/19/list-strategy.html をご覧ください。
タグ:execution
- 複数の
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
が累計されます -
特定の 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」戦略で「コンパイル //foo/bar/baz」を実行しますが、順序を逆にすると、「sandboxed」で実行します。
タグ:execution
--[no]use_target_platform_for_tests
: 「false」-
true の場合、Bazel はテスト実行グループではなく、ターゲット プラットフォームを使用してテストを実行します。
タグ:execution
--android_compiler=<a string>
: 説明を表示-
Android ターゲット コンパイラ。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--android_crosstool_top=<a build target label>
のデフォルト: "//external:android/crosstool"-
Android ビルドに使用される C++ コンパイラの場所。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
、loses_incremental_state
--android_grte_top=<a label>
: 説明を表示-
Android ターゲット grte_top。
タグ:changes_inputs
、loading_and_analysis
、loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
のデフォルト: "android"-
android_binary ルールに使用するマニフェスト マージツールを選択します。レガシーのマージツールから Android マニフェストのマージツールへの移行に役立つフラグ。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--android_platforms=<a build target label>
のデフォルト: "-
android_binary ターゲットが使用するプラットフォームを設定します。複数のプラットフォームが指定されている場合、バイナリはファット APK であり、指定された各ターゲット プラットフォームのネイティブ バイナリが含まれています。
タグ:changes_inputs
、loading_and_analysis
、loses_incremental_state
--android_sdk=<a build target label>
のデフォルト: "@bazel_tools//tools/android:sdk"- Android アプリのビルドに使用する Android SDK/プラットフォームを指定します。
タグ:changes_inputs
、loading_and_analysis
、loses_incremental_state
--apple_compiler=<a string>
: 説明を表示-
Apple ターゲット コンパイラ。ツールチェーンのバリアント(xcode-beta など)を選択する場合に役立ちます。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--apple_crosstool_top=<a build target label>
のデフォルト: "@bazel_tools//tools/cpp:ツールチェーン"-
Apple ルールと Objc ルール、およびその依存関係で使用される crosstool パッケージのラベル。
タグ:loses_incremental_state
、changes_inputs
--apple_grte_top=<a build target label>
: 説明を表示-
Apple ターゲット grte_top。
タグ:changes_inputs
、loading_and_analysis
、loses_incremental_state
--cc_output_directory_tag=<a string>
のデフォルト: "- 構成ディレクトリに追加するサフィックスを指定します。
タグ:affects_outputs
、explicit_in_output_path
--compiler=<a string>
: 説明を表示-
ターゲットのコンパイルに使用する C++ コンパイラ。
タグ:loading_and_analysis
、execution
--coverage_output_generator=<a build target label>
のデフォルト: "@bazel_tools//tools/test:lcov_merger"- 未加工のカバレッジ レポートの後処理に使用されるバイナリの場所。現在は、単一のファイル(バイナリ)を含むファイル グループである必要があります。デフォルトは「//tools/test:lcov_merger」です。
タグ:changes_inputs
、affects_outputs
、loading_and_analysis
--coverage_report_generator=<a build target label>
のデフォルト: "@bazel_tools//tools/test:coverage_report_generator"-
カバレッジ レポートの生成に使用されるバイナリの場所。現在は、単一のファイル(バイナリ)を含むファイル グループである必要があります。デフォルトは「//tools/test:coverage_report_generator」です。
タグ:changes_inputs
、affects_outputs
、loading_and_analysis
--coverage_support=<a build target label>
のデフォルト: "@bazel_tools//tools/test:coverage_support"-
コード カバレッジを収集するすべてのテスト アクションの入力に必要なサポート ファイルの場所。デフォルトは「//tools/test:coverage_support」です。
タグ:changes_inputs
、affects_outputs
、loading_and_analysis
--crosstool_top=<a build target label>
のデフォルト: "@bazel_tools//tools/cpp:ツールチェーン"-
C++ コードのコンパイルに使用する crosstool パッケージのラベル。
タグ:loading_and_analysis
、changes_inputs
、affects_outputs
--custom_malloc=<a build target label>
: 説明を表示-
malloc のカスタム実装を指定します。この設定により、ビルドルールの malloc 属性がオーバーライドされます。
タグ:changes_inputs
、affects_outputs
- 複数の
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
が累計されます -
カンマ区切りの正規表現のリスト。先頭に -(負の式)を付加し、制約値のターゲットのカンマ区切りのリストに代入します。ターゲットが負の式に一致せず、少なくとも 1 つの正の式に一致する場合、ツールチェーンの解決は、制約の値を実行の制約として宣言した場合と同様に実行されます。例: //demo,-test=@platforms//cpus:x86_64 は、名前に 'test' が含まれているものを除き、//demo の下にあるすべてのターゲットに 'x86_64' を追加します。
タグ:loading_and_analysis
--[no]experimental_enable_objc_cc_deps
のデフォルト: "true"-
ob_c_* ルールを cc_library に依存させ、--ios_multi_cpu の値に対して --cpu を "ios_<--ios_cpu" に設定してすべての objc 依存関係をビルドできます。
タグ:loading_and_analysis
、incompatible_change
--[no]experimental_include_xcode_execution_requirements
: 「false」-
設定した場合、Xcode のすべてのアクションに「requires-xcode:{version}」の実行要件を追加します。xcode バージョンにハイフンが使用されている場合は、requires-xcode-label:{version_label} の実行要件も追加します。
タグ:loses_incremental_state
、loading_and_analysis
、execution
--[no]experimental_prefer_mutual_xcode
のデフォルト: "true"-
true の場合、ローカルとリモートの両方で利用可能な最新の Xcode を使用します。false であるか、相互利用可能なバージョンがない場合は、xcode-select を介して選択されたローカル Xcode バージョンを使用します。
タグ:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
のデフォルト: "-
アクションの実行プラットフォームとして使用可能なプラットフォーム。プラットフォームは、正確なターゲットによって、またはターゲット パターンとして指定できます。これらのプラットフォームは、register_execution_platforms() によって WORKSPACE ファイルで宣言されたものよりも先に考慮されます。このオプションは 1 回だけ設定できます。後のインスタンスは以前のフラグ設定をオーバーライドします。
タグ:execution
- 複数の
--extra_toolchains=<comma-separated list of options>
が累計されます -
ツールチェーンの解決で考慮されるツールチェーン ルール。ツールチェーンは、正確なターゲットまたはターゲット パターンとして指定できます。これらのツールチェーンは、register_artifacts() によって WORKSPACE ファイルで宣言される前に適用されます。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
--grte_top=<a label>
: 説明を表示-
チェックインされた libc ライブラリに対するラベル。デフォルト値は crosstool ツールチェーンによって選択されるため、オーバーライドする必要はありません。
タグ:action_command_lines
、affects_outputs
--host_compiler=<a string>
: 説明を表示-
ホスト コンパイルに使用する C++ コンパイラ。--host_crosstool_top が設定されていない場合は無視されます。
タグ:loading_and_analysis
、execution
--host_crosstool_top=<a build target label>
: 説明を表示-
デフォルトでは、exec 構成に --crosstool_top オプションと --compiler オプションも使用されます。このフラグを指定すると、Bazel は指定された crosstool_top にデフォルトの libc とコンパイラを使用します。
タグ:loading_and_analysis
、changes_inputs
、affects_outputs
--host_grte_top=<a label>
: 説明を表示-
指定すると、exec 構成用の libc 最上位ディレクトリ(--grte_top)がオーバーライドされます。
タグ:action_command_lines
、affects_outputs
--host_platform=<a build target label>
のデフォルト: "@local_config_platform//:host"-
ホストシステムを説明するプラットフォーム ルールのラベル。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set
のデフォルト: "true"-
true の場合、Bazel は flag_sets に expand_if_all_available を指定します(移行手順については https://github.com/bazelbuild/bazel/issues/7008 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
のデフォルト: "true"-
true の場合、Bazel は c++ ツールチェーンで「host」機能と「nonhost」機能を有効にしません(詳細については https://github.com/bazelbuild/bazel/issues/7407 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
: 「false」-
ツールチェーンの解決を使用して Android SDK for Android ルールを選択する(Starlark とネイティブ)
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
: 「false」-
ツールチェーンの解決を使用して、Apple SDK 用の Apple SDK(Starlark とネイティブ)を選択します。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
のデフォルト: "true"-
true の場合、Bazel は lto インデックス登録コマンドラインで C++ リンク アクション コマンドラインを再利用しません(詳細については https://github.com/bazelbuild/bazel/issues/6791 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_objc_linking_info_migration
のデフォルト: "true"-
true の場合、ObjC 組み込みルールは、ObjcProvider ではなく CcInfo からリンク情報を取得します。詳細と移行情報については、https://github.com/bazelbuild/bazel/issues/16939 をご覧ください。
タグ:loading_and_analysis
、changes_inputs
、incompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
のデフォルト: "true"-
true の場合、cc_ツールチェーン.cpu 属性と cc_ツールチェーン.compiler 属性が設定されている場合、Bazel はエラーになります(移行手順については https://github.com/bazelbuild/bazel/issues/7075 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_remove_legacy_whole_archive
のデフォルト: "true"-
true の場合、Bazel はデフォルトではライブラリの依存関係全体をアーカイブにリンクしません(移行手順については https://github.com/bazelbuild/bazel/issues/7362 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_require_ctx_in_configure_features
のデフォルト: "true"-
true の場合、Bazel では cc_common.configure_features に 'ctx' パラメータを指定する必要があります(詳細については https://github.com/bazelbuild/bazel/issues/7793 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
-
ツールチェーンでサポートされている場合は、インターフェース共有オブジェクトを使用します。現在は、すべての ELF ツールチェーンでこの設定がサポートされています。
タグ:loading_and_analysis
、affects_outputs
、affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
iOS アプリのビルドに使用する iOS SDK のバージョンを指定します。指定しない場合は、「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_analysis
、affects_outputs
--platform_mappings=<a relative path>
のデフォルト: "-
プラットフォーム ファイルが未設定の場合に使用するプラットフォーム、またはプラットフォームがすでに存在するときに設定するフラグを記述するマッピング ファイルの場所。メインのワークスペースのルートからの相対パスを指定する必要があります。デフォルトは「platform_mappings」です(ワークスペース ルートの直下にあるファイル)。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
--platforms=<a build target label>
のデフォルト: "-
現在のコマンドのターゲット プラットフォームを示すプラットフォーム ルールのラベル。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
--python2_path=<a string>
: 説明を表示-
非推奨。no-op。「--compatible_use_python_ツールチェーン」により無効になっています。
タグ:no_op
、deprecated
--python3_path=<a string>
: 説明を表示-
非推奨。no-op。「--compatible_use_python_ツールチェーン」により無効になっています。
タグ:no_op
、deprecated
--python_path=<a string>
: 説明を表示-
ターゲット プラットフォームで Python ターゲットを実行するために呼び出される Python インタープリタの絶対パス。非推奨。--compatible_use_python_ツールチェーン s により無効にされました。
タグ:loading_and_analysis
、affects_outputs
--python_top=<a build target label>
: 説明を表示-
ターゲット プラットフォームで Python ターゲットを実行するために呼び出された Python インタープリタを表す py_runtime のラベル。非推奨。--compatible_use_python_ツールチェーン s により無効にされました。
タグ:loading_and_analysis
、affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
tvOS アプリのビルドに使用する tvOS SDK のバージョンを指定します。指定しない場合は、「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_state
、loading_and_analysis
--[no]apple_enable_auto_dsym_dbg
: 「false」-
dbg ビルドのデバッグ シンボル(.dSYM)ファイルの生成を強制的に有効にするかどうかを指定します。
タグ:affects_outputs
、action_command_lines
--[no]apple_generate_dsym
: 「false」- デバッグ シンボル(.dSYM)ファイルを生成するかどうか。
タグ:affects_outputs
、action_command_lines
--[no]build
のデフォルト: "true"-
ビルドを実行します。これは通常の動作です。--nobuild を指定すると、ビルド アクションを実行する前にビルドが停止し、パッケージの読み込みフェーズと分析フェーズが正常に完了した場合にゼロが返されます。このモードは、これらのフェーズをテストするのに便利です。
タグ:execution
、affects_outputs
--[no]build_runfile_links
のデフォルト: "true"-
true の場合、すべてのターゲットのランファイル シンボリック フォレストがビルドされます。false の場合、可能であればマニフェストのみを書き込みます。
タグ:affects_outputs
--[no]build_runfile_manifests
のデフォルト: "true"-
true の場合、すべてのターゲットの runfiles マニフェストを書き込みます。false の場合は省略します。false の場合、ローカルテストの実行は失敗します。
タグ:affects_outputs
--[no]build_test_dwp
: 「false」-
有効にすると、C++ テストを静的にビルドし、分割すると、テストバイナリの .dwp ファイルも自動的にビルドされます。
タグ:loading_and_analysis
、affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
のデフォルト: ".pb.h"-
cc_proto_library が作成するヘッダー ファイルの接頭辞を設定します。
タグ:affects_outputs
、loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
: 「.pb.cc」-
cc_proto_library が作成するソースファイルの接頭辞を設定します。
タグ:affects_outputs
、loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
: 「false」- proto_library で、代替 Java API バージョンの追加アクションを実行します。
タグ:affects_outputs
、loading_and_analysis
、experimental
--[no]experimental_proto_extra_actions
: 「false」- proto_library で、代替 Java API バージョンの追加アクションを実行します。
タグ:affects_outputs
、loading_and_analysis
、experimental
--[no]experimental_run_validations
のデフォルト: "true"-
代わりに --run_validations を使用してください。
タグ:execution
、affects_outputs
--[no]experimental_save_feature_state
: 「false」-
コンパイル済みの状態とリクエストされた機能をコンパイルの出力として保存します。
タグ:affects_outputs
、experimental
--[no]experimental_use_validation_aspect
: 「false」- アスペクトを使用して検証アクションを実行するかどうか(テストとの並列処理の場合)。
タグ:execution
、affects_outputs
--fission=<a set of compilation modes>
のデフォルト: "no"-
C++ のコンパイルとリンクに分割を使用するコンパイル モードを指定します。'fastbuild'、'dbg'、'opt'}、またはすべてのモードを有効にする場合は「yes」、すべてのモードを無効にする場合は「no」の任意の組み合わせを指定できます。
タグ:loading_and_analysis
、action_command_lines
、affects_outputs
--[no]incompatible_always_include_files_in_data
のデフォルト: "true"-
true の場合、ネイティブ ルールはデータ依存関係の <code>DefaultInfo.files</code> を Runfile に追加します。これは Starlark ルールの推奨動作(https://bazel.build/extending/rules#runfiles_features_to_avoid)と一致します。
タグ:affects_outputs
、incompatible_change
--[no]legacy_external_runfiles
のデフォルト: "true"-
true の場合、.runfiles/repo に加えて、.runfiles/wsname/external/repo の下にある外部リポジトリ用の runfiles symlink フォレストを作成します。
タグ:affects_outputs
--[no]objc_generate_linkmap
: 「false」-
リンクマップ ファイルを生成するかどうかを指定します。
タグ:affects_outputs
- 複数の
--output_groups=<comma-separated list of options>
が累計されます -
出力グループ名のカンマ区切りのリスト。各接頭辞に + または - を付けることもできます。また、+ で始まるグループはデフォルトの出力グループセットに追加され、「-」で始まるグループはデフォルト セットから削除されます。接頭辞を持たないグループが 1 つ以上ある場合、デフォルトの出力グループセットは省略されます。たとえば、--output_groups=+foo,+bar と指定すると、デフォルトのセット、foo、bar を結合し、--output_groups=foo,bar は、デフォルトのセットが foo と bar だけで構成されるようにオーバーライドします。
タグ:execution
、affects_outputs
--[no]run_validations
のデフォルト: "true"-
ビルドの一環として検証アクションを実行するかどうかを指定します。https://bazel.build/extending/rules#validation_actions をご覧ください
タグ:execution
、affects_outputs
--[no]save_temps
: 「false」-
設定すると、gcc からの一時的な出力が保存されます。これには、.s ファイル(アセンブラ コード)、.i ファイル(前処理済み C)、.ii ファイル(前処理済み C++)が含まれます。
タグ:affects_outputs
- 複数の
--action_env=<a 'name=value' assignment with an optional value part>
が累計されます -
ターゲット構成のアクションで使用可能な環境変数のセットを指定します。変数は、名前で指定できます。名前の場合、値は呼び出し環境から取得されるか、name=value ペアによって呼び出し環境とは別に値が設定されます。このオプションは複数回使用できます。同じ変数に指定されたオプションの場合、最新の変数が優先され、異なる変数のオプションが累積されます。
タグ:action_command_lines
--android_cpu=<a string>
のデフォルト: "armeabi-v7a"-
Android ターゲット CPU。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--[no]android_databinding_use_androidx
: 「false」-
AndroidX 互換のデータ バインディング ファイルを生成します。これは、databinding v2 でのみ使用されます。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--[no]android_databinding_use_v3_4_args
: 「false」-
3.4.0 引数で android databinding v2 を使用する
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--android_dynamic_mode=<off, default or fully>
のデフォルト: "off"-
cc_binary が共有ライブラリを明示的に作成していない場合に、Android ルールの C++ 依存関係を動的にリンクするかどうかを指定します。「default」は、bazel が動的にリンクするかどうかを選択することを意味します。「fully」は、すべてのライブラリが動的にリンクされることを意味します。「オフ」は、すべてのライブラリがほぼ静的モードでリンクされることを意味します。
タグ:affects_outputs
、loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
のデフォルト: "alphabetical"-
Android バイナリのマニフェスト マージツールに渡されるマニフェストの順序を設定します。ALPHABETICAL は、マニフェストが execroot への相対パスで並べ替えられることを意味します。ALPHABETICAL_BY_CONFIGURATION は、出力ディレクトリ内の構成ディレクトリを基準とする相対パスとしてマニフェストが並べ替えられていることを意味します。DEPENDENCY は、各ライブラリのマニフェストがその依存関係のマニフェストよりも前に来る順序で並べられることを意味します。
タグ:action_command_lines
、execution
--[no]android_resource_shrinking
: 「false」- ProGuard を使用する android_binary APK のリソース圧縮を有効にします。
タグ:affects_outputs
、loading_and_analysis
- 複数の
--aspects=<comma-separated list of options>
が累計されます - トップレベル ターゲットに適用するアスペクトのリスト(カンマ区切り)。リスト内で、なんらかの some_aspect が required_aspect_providers を介して必要なアスペクト プロバイダを指定している場合、some_aspect は、アドバタイズされるプロバイダが some_aspect の必要なアスペクト プロバイダを満たすアスペクトのリストで前述されているすべてのアスペクトの後に実行されます。さらに、some_aspect は、requires 属性で指定されたすべての必須要素の後に実行されます。some_aspect は、それらの側面のプロバイダの値にアクセスできます。<bzl-file-label>%<aspect_name>。例: '//tools:my_def.bzl%my_aspect'。ここで、'my_aspect' は file tools/my_def.bzl の最上位値です。
--[no]build_python_zip
: 「自動」-
Python 実行可能 zip をビルドします。Windows の場合、他のプラットフォームは除きます。
タグ:affects_outputs
- 複数の
--catalyst_cpus=<comma-separated list of options>
が累計されます - Apple Catalyst バイナリをビルドするアーキテクチャのカンマ区切りのリスト。
タグ:loses_incremental_state
、loading_and_analysis
--[no]collect_code_coverage
: 「false」-
指定すると、Bazel はコードをインストルメント化し(可能な場合、オフラインのインストルメンテーションを使用)、テスト中にカバレッジ情報を収集します。--instrumentation_filter に一致するターゲットのみが影響を受けます。通常、このオプションは直接指定せず、代わりに「bazelCoverage」コマンドを使用してください。
タグ:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] デフォルト: "fastbuild"-
バイナリが組み込まれるモードを指定します。値: fast'、'dbg'、'opt'。
タグ:affects_outputs
、action_command_lines
、explicit_in_output_path
- 複数の
--conlyopt=<a string>
が累計されます -
C ソースファイルをコンパイルするときに gcc に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
- 複数の
--copt=<a string>
が累計されます -
gcc に渡す追加オプション。
タグ:action_command_lines
、affects_outputs
--cpu=<a string>
のデフォルト: "-
ターゲット CPU。
タグ:changes_inputs
、affects_outputs
、explicit_in_output_path
--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_lines
、affects_outputs
- 複数の
--define=<a 'name=value' assignment>
が累計されます - 各 --define オプションは、ビルド変数の割り当てを指定します。
タグ:changes_inputs
、affects_outputs
--dynamic_mode=<off, default or fully>
デフォルト: "default"-
C++ バイナリを動的にリンクするかどうかを指定します。「default」は、Bazel が動的にリンクするかどうかを選択することを意味します。「fully」は、すべてのライブラリが動的にリンクされることを意味します。「オフ」は、すべてのライブラリがほぼ静的モードでリンクされることを意味します。
タグ:loading_and_analysis
、affects_outputs
--[no]enable_fdo_profile_absolute_path
のデフォルト: "true"-
設定した場合、fdo_absolute_profile_path を使用するとエラーが発生します。
タグ:affects_outputs
--[no]enable_runfiles
: 「自動」-
runfiles シンボリック リンク ツリーを有効にします。デフォルトでは、Windows、その他のプラットフォームでは無効になっています。
タグ:affects_outputs
- 複数の
--experimental_action_listener=<a build target label>
が累計されます -
いくつかの側面を重視して非推奨になりました。action_listener を使用して、エクストラアクションを既存のビルド アクションに接続します。
タグ:execution
、experimental
--[no]experimental_android_compress_java_resources
: 「false」-
APK で Java リソースを圧縮する
タグ:affects_outputs
、loading_and_analysis
、experimental
--[no]experimental_android_databinding_v2
: 「false」-
android databinding v2 を使用する
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--[no]experimental_android_resource_shrinking
: 「false」- ProGuard を使用する android_binary APK のリソース圧縮を有効にします。
タグ:affects_outputs
、loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
: 「false」-
rex ツールを使用して dex ファイルを書き換えます。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--[no]experimental_convenience_symlinks
のデフォルト: "normal"-
このフラグは、コンビニエンス シンボリック リンク(ビルド後にワークスペースに表示されるシンボリック リンク)を管理する方法を管理します。有効な値: normal(デフォルト): ビルドの判断に基づいて、個々の種類のコンビニエンス シンボリック リンクが作成または削除されます。
clean: すべてのシンボリック リンクが無条件に削除されます。
無視: シンボリック リンクは残されます。log_only: 「normal」が渡されたかのようにログメッセージを生成しますが、ファイルシステム オペレーションは実際に実行しません(ツールに役立ちます)。
影響を受けるのは、現在の値 --symlink_prefix で名前が生成されるシンボリック リンクのみです。プレフィックスが変更されても既存のシンボリック リンクはそのまま残ります。
タグ:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
: 「false」- このフラグは、ビルド イベント ConenienceSymlinksIdentified を BuildEventProtocol に送信するかどうかを制御します。値が true の場合、BuildEventProtocol にコンビニエンス SymlinksIdentified のエントリが含まれ、ワークスペースで作成されたすべてのコンビニエンス シンボリック リンクがリストされます。false の場合、BuildEventProtocol のコンビニエンス SymlinksIdentified エントリが空になります。
タグ:affects_outputs
- 複数の
--experimental_multi_cpu=<comma-separated list of options>
が累計されます -
非推奨。No-op。
タグ:affects_outputs
、experimental
--experimental_objc_fastbuild_options=<comma-separated list of options>
のデフォルト: "-O0,-DDEBUG=1"-
これらの文字列を objc fastbuild コンパイラ オプションとして使用します。
タグ:action_command_lines
--[no]experimental_omitfp
: 「false」-
true の場合、スタックのアンワインドに libunwind を使用し、-fomit-frame-pointer と -fasync-unwind-tables を使用してコンパイルします。
タグ:action_command_lines
、affects_outputs
、experimental
--[no]experimental_platform_in_output_dir
: 「false」-
true の場合、ターゲット プラットフォームは CPU ではなく出力ディレクトリ名で使用されます。
タグ:affects_outputs
、experimental
--[no]experimental_use_llvm_covmap
: 「false」-
指定すると、Bazel は collect_code_coverage を有効にしたときに gcov ではなく llvm-cov カバレッジ マップ情報を生成します。
タグ:changes_inputs
、affects_outputs
、loading_and_analysis
、experimental
--fat_apk_cpu=<comma-separated set of options>
のデフォルト: "armeabi-v7a"-
このオプションを設定すると、太った APK が有効になります。これには、指定したすべてのターゲット アーキテクチャ(--fat_apk_cpu=x86,armeabi-v7a、このフラグを指定すると、android_binary ルールの依存関係で --android_cpu は無視されます。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--[no]fat_apk_hwasan
: 「false」-
HWASAN 分割を作成するかどうかを指定します。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--fdo_instrument=<a string>
: 説明を表示-
FDO インストルメンテーションでバイナリを生成する。Clang/LLVM コンパイラでは、生のプロファイル ファイルが実行時にダンプされるディレクトリ名も受け入れます。
タグ:affects_outputs
--fdo_optimize=<a string>
: 説明を表示-
FDO プロファイル情報を使用してコンパイルを最適化します。.gcda ファイルツリーを含む zip ファイルの名前、自動プロファイルを含む afdo ファイル、または LLVM プロファイル ファイルの名前を指定します。このフラグには、ラベルとして指定されたファイル(例: `//foo/bar:file.afdo` - 対応するパッケージに `exports_files` ディレクティブを追加する)と `fdo_profile` ターゲットを指すラベルを受け付けます。このフラグは fdo_profile ルールに置き換えられます。
タグ:affects_outputs
--fdo_prefetch_hints=<a build target label>
: 説明を表示-
キャッシュ プリフェッチのヒントを使用します。
タグ:affects_outputs
--fdo_profile=<a build target label>
: 説明を表示- 最適化に使用するプロファイルを表す fdo_profile。
タグ:affects_outputs
- 複数の
--features=<a string>
が累計されます -
指定された機能は、ターゲット構成で構築されたターゲットに対してデフォルトで有効または無効にされます。「-feature>」を指定すると、その特徴が無効になります。ネガティブな特徴は常にポジティブな特徴をオーバーライドします。--host_features もご覧ください。
タグ:changes_inputs
、affects_outputs
--[no]force_pic
: 「false」-
有効にすると、すべての C++ コンパイルが位置に依存しないコード(「-fPIC」)を生成し、リンクが非 PIC ライブラリよりも PIC ビルド済みライブラリを優先して、リンクが位置に依存しない実行可能ファイル(「-pie」)を生成するようになります。
タグ:loading_and_analysis
、affects_outputs
- 複数の
--host_action_env=<a 'name=value' assignment with an optional value part>
が累計されます - 実行構成を含むアクションで使用できる環境変数のセットを指定します。変数は、名前で指定できます。名前の場合、値は呼び出し環境から取得されるか、name=value ペアによって呼び出し環境とは別に値が設定されます。このオプションは複数回使用できます。同じ変数に指定されたオプションの場合、最新の変数が優先され、異なる変数のオプションが累積されます。
タグ:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
: 「opt」-
ビルド中に使用するツールが組み込まれるモードを指定します。値: fast'、'dbg'、'opt'。
タグ:affects_outputs
、action_command_lines
- 複数の
--host_conlyopt=<a string>
が累計されます -
実行構成で C(ただし C++ ではない)ソースファイルをコンパイルするときに、C コンパイラに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
- 複数の
--host_copt=<a string>
が累計されます -
exec 構成に組み込まれたツールについて、C コンパイラに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--host_cpu=<a string>
のデフォルト: "- ホスト CPU。
タグ:changes_inputs
、affects_outputs
- 複数の
--host_cxxopt=<a string>
が累計されます -
exec 構成に組み込まれたツール用に C++ コンパイラに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
- 複数の
--host_features=<a string>
が累計されます -
特定の機能はデフォルトで、exec 構成に組み込まれたターゲットで有効または無効にします。「-feature>」を指定すると、その特徴が無効になります。ネガティブな特徴は常にポジティブな特徴をオーバーライドします。
タグ:changes_inputs
、affects_outputs
--host_force_python=<PY2 or PY3>
: 説明を表示-
exec 構成の Python バージョンをオーバーライドします。「PY2」または「PY3」を指定できます。
タグ:loading_and_analysis
、affects_outputs
- 複数の
--host_linkopt=<a string>
が累計されます -
exec 構成のツールをリンクする際にリンカーに渡す追加オプション。
タグ:action_command_lines
、affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
ホスト ターゲットの最小互換 macOS バージョン。指定しない場合は、「macos_sdk_version」を使用します。
タグ:loses_incremental_state
- 複数の
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
が累計されます -
exec 構成内の特定のファイルをコンパイルする際に、C/C++ コンパイラに選択的に渡す追加オプション。このオプションは複数回渡すことができます。構文: regex_filter@option_1、option_2,...、option_n。regex_filter は、正規表現の包含リストと除外リストを表します(--instrumentation_filter も参照)。option_1 から option_n は任意のコマンドライン オプションを表します。オプションにカンマを含める場合は、バックスラッシュで囲む必要があります。オプションには @ を含めることができます。最初の @ のみが文字列の分割に使用されます。例: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 では、-O0 コマンドライン オプションを、bar.cc 以外の //foo/ にあるすべての cc ファイルの gcc コマンドラインに追加します。
タグ:action_command_lines
、affects_outputs
- 複数の
--host_swiftcopt=<a string>
が累計されます -
exec ツールに swiftc に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--[no]incompatible_auto_exec_groups
: 「false」-
有効にすると、ルールで使用されるツールチェーンごとに exec グループが自動的に作成されます。そのためには、ルールのアクションで「ツールチェーン」パラメータを指定する必要があります。詳細については、https://github.com/bazelbuild/bazel/issues/17134 をご覧ください。
タグ:affects_outputs
、incompatible_change
--[no]incompatible_avoid_conflict_dlls
のデフォルト: "true"-
有効にすると、Windows の cc_library によって生成されたすべての C++ ダイナミック リンク ライブラリ(DLL)の名前が name_hash.dll に変わり、リポジトリ名および DLL のパッケージパスに基づいてハッシュが計算されます。このオプションは、同じ名前の複数の cc_library に依存する 1 つのパッケージ(例: //foo/bar1:utils と //foo/bar2:utils)がある場合に役立ちます。
タグ:loading_and_analysis
、affects_outputs
、incompatible_change
--[no]incompatible_merge_genfiles_directory
のデフォルト: "true"-
true の場合、genfiles ディレクトリは bin ディレクトリに折りたたまれています。
タグ:affects_outputs
、incompatible_change
--[no]incompatible_use_host_features
: 「false」-
true の場合、ターゲット構成にのみ --features を使用し、exec 構成には --host_features を使用します。
タグ:changes_inputs
、affects_outputs
、incompatible_change
--[no]instrument_test_targets
: 「false」-
カバレッジが有効な場合、テストルールのインストルメンテーションを考慮するかどうかを指定します。設定すると、--instrumentation_filter に含まれるテストルールは計測可能になります。それ以外の場合、テストルールは常にカバレッジ計測から除外されます。
タグ:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-/javatests[/:],-/test/java[/:]"-
一致が有効になっている場合、指定した正規表現ベースのフィルタを含む名前のルールのみが計測対象となります。「-」で始まるルールは除外されます。--instrument_test_targets が有効になっていない限り、テスト以外のルールのみがインストルメント化されることに注意してください。
タグ:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
ターゲット設定のシミュレータとデバイスに対応する iOS の最小バージョン。指定しない場合は「ios_sdk_version」を使用します。
タグ:loses_incremental_state
- 複数の
--ios_multi_cpus=<comma-separated list of options>
が累計されます -
ios_application をビルドするアーキテクチャのカンマ区切りのリスト。その結果、指定したすべてのアーキテクチャを含むユニバーサル バイナリが生成されます。
タグ:loses_incremental_state
、loading_and_analysis
--[no]legacy_whole_archive
のデフォルト: "true"-
非推奨。--compatible_remove_legacy_whole_archive に置き換えられました(詳細は https://github.com/bazelbuild/bazel/issues/7362 を参照)。オンの場合、linkshared=True で、linkopt で linkstatic=True または「-static」を持つ cc_binary ルールに --whole-archive を使用します。これは下位互換性のためにのみ使用されます。必要に応じて、alwayslink=1 を使用することをおすすめします。
タグ:action_command_lines
、affects_outputs
、deprecated
- 複数の
--linkopt=<a string>
が累計されます -
リンク時に gcc に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
- 複数の
--ltobackendopt=<a string>
が累計されます -
LTO バックエンド ステップに渡す追加オプション(--features=thin_lto の下)。
タグ:action_command_lines
、affects_outputs
- 複数の
--ltoindexopt=<a string>
が累計されます -
LTO インデックス登録ステップに渡すオプション(--features=thin_lto の下)です。
タグ:action_command_lines
、affects_outputs
- 複数の
--macos_cpus=<comma-separated list of options>
が累計されます - Apple macOS バイナリをビルドするアーキテクチャのカンマ区切りのリスト。
タグ:loses_incremental_state
、loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
移行先の macOS の最小バージョン。指定しない場合は、「macos_sdk_version」を使用します。
タグ:loses_incremental_state
--[no]objc_debug_with_GLIBCXX
: 「false」-
設定済みで、コンパイル モードを「dbg」に設定した場合は、GLIBCXX_DEBUG、GLIBCXX_DEBUG_PEDANTIC、GLIBCPP_CONCEPT_CHECKS を定義します。
タグ:action_command_lines
--[no]objc_enable_binary_stripping
: 「false」-
リンクされたバイナリに対してシンボルとデッドコードのストリッピングを実行するかどうか。このフラグと --compilation_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 0 コマンドライン オプションを、bar/cc 以外の //foo/ にあるすべての cc ファイルの gcc コマンドラインに追加します。
タグ:action_command_lines
、affects_outputs
- 複数の
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
が累計されます -
特定のバックエンド オブジェクトをコンパイルするときに、LTO バックエンドを選択的に渡すオプションを追加しました(--features=thin_lto の下)。このオプションは複数回渡すことができます。構文: regex_filter@option_1、option_2,...、option_n。regex_filter は、正規表現の包含と除外のリストを表します。option_1 から option_n は任意のコマンドライン オプションを表します。オプションにカンマを含める場合は、バックスラッシュで囲む必要があります。オプションには @ を含めることができます。最初の @ のみが文字列の分割に使用されます。例: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 は、bar/o を除くすべての o ファイルの LTO バックエンド コマンドラインに -O0 コマンドライン オプションを追加します。
タグ:
action_command_lines
、affects_outputs
--platform_suffix=<a string>
: 説明を表示- 構成ディレクトリに追加するサフィックスを指定します。
タグ:loses_incremental_state
、affects_outputs
、loading_and_analysis
--propeller_optimize=<a build target label>
: 説明を表示-
プロペラ プロファイルの情報を使用して、ビルド ターゲットを最適化します。プロペラ プロファイルは、cc プロファイルと ld プロファイルのうち少なくとも 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_lines
、affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
: 説明を表示- プロペラ最適化ビルドの cc_profile ファイルの絶対パス名。
タグ:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
: 説明を表示- プロペラ最適化ビルドの ld_profile ファイルの絶対パス名。
タグ:affects_outputs
--run_under=<a prefix in front of command>
: 説明を表示-
「test」および「run」コマンドの実行可能ファイルの前に挿入する接頭辞。値が「foo -bar」で、実行コマンドラインが「test_binary -baz」の場合、最終的なコマンドラインは「foo -bar test_binary -baz」です。これは、実行可能ターゲットのラベルにすることもできます。例: 'valgrind'、'strace'、'strace -c'、'valgrind --quiet --num-callers=20'、'//package:target'、'//package:target --options'
タグ:action_command_lines
-
true の場合、同じ機能を含むネイティブ ライブラリが複数のターゲット間で共有されます。
タグ:loading_and_analysis
、affects_outputs
--[no]stamp
: 「false」-
日付、ユーザー名、ホスト名、ワークスペース情報などを含むバイナリをスタンプします。
タグ:affects_outputs
--strip=<always, sometimes or never>
のデフォルト: 「時には」-
バイナリと共有共有ライブラリを削除するかどうかを指定します(「-Wl,--strip-debug」を使用)。デフォルト値「sometimes」は、trip iff --compilation_mode=fastbuild を意味します。
タグ:affects_outputs
- 複数の
--stripopt=<a string>
が累計されます -
「<name>.stripped」バイナリを生成するときにストリップに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
- 複数の
--swiftcopt=<a string>
が累計されます - Swift コンパイルに渡す追加オプション。
タグ:action_command_lines
--symlink_prefix=<a string>
: 説明を表示-
ビルド後に作成されたコンビニエンス シンボリック リンクの先頭に付加される接頭辞。省略した場合のデフォルト値は、ハイフンとその後のビルドツール名です。「/」を渡してもシンボリック リンクは作成されず、警告は出力されません。警告: 「/」の特殊機能はまもなく非推奨となります。代わりに --experimental_convenience_symlinks=ignore を使用してください。
タグ:affects_outputs
- 複数の
--tvos_cpus=<comma-separated list of options>
が累計されます - Apple tvOS バイナリをビルドするアーキテクチャのカンマ区切りのリスト。
タグ:loses_incremental_state
、loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
ターゲット シミュレータとデバイスに対応する最小の tvOS バージョン。指定しない場合は、「tvos_sdk_version」を使用します。
タグ:loses_incremental_state
- 複数の
--watchos_cpus=<comma-separated list of options>
が累計されます - Apple WatchOS バイナリをビルドするアーキテクチャのカンマ区切りのリスト。
タグ:loses_incremental_state
、loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
ターゲット シミュレータとデバイスに対応する WatchOS の最小バージョン。指定しない場合、「watchos_sdk_version」が使用されます。
タグ:loses_incremental_state
--xbinary_fdo=<a build target label>
: 説明を表示-
XbinaryFDO プロファイル情報を使用してコンパイルを最適化します。デフォルトのクロスバイナリ プロファイルの名前を指定します。オプションを --fdo_instrument/--fdo_optimize/--fdo_profile と併用すると、xbinary_fdo が指定されていないかのように、このオプションが常に優先されます。
タグ:affects_outputs
--auto_cpu_environment_group=<a build target label>
のデフォルト: "-
CPU 値を target_environment 値に自動的にマッピングするために使用する environment_group を宣言します。
タグ:changes_inputs
、loading_and_analysis
、experimental
--[no]check_licenses
: 「false」-
依存パッケージによって課されるライセンスの制約が、ビルドされるターゲットの配布モードと競合しないことを確認します。デフォルトでは、ライセンスはチェックされません。
タグ:build_file_semantics
--[no]check_visibility
のデフォルト: "true"-
無効にした場合、ターゲット依存関係の可視性エラーは警告に降格されます。
タグ:build_file_semantics
--[no]desugar_for_android
のデフォルト: "true"- dex 変換の前に Java 8 バイトコードを脱糖するかどうか。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--[no]desugar_java8_libs
: 「false」-
レガシー デバイスのアプリでサポートされる Java 8 ライブラリを含めるかどうか。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--[no]enforce_constraints
のデフォルト: "true"-
各ターゲットが互換性のある環境を確認し、同じ環境をサポートしない依存関係が含まれている場合はエラーを報告します。
タグ:build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs
: 「false」-
srcs-less android_library ルールを deps 付きで許可しないように遷移するフラグです。デフォルトでは、このリポジトリを展開してクリーンアップする必要があります。
タグ:eagerness_to_exit
、loading_and_analysis
--[no]experimental_check_desugar_deps
のデフォルト: "true"- Android バイナリレベルで正しい脱糖を再確認するかどうか。
タグ:eagerness_to_exit
、loading_and_analysis
、experimental
--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_semantics
、eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
: 「false」-
有効にすると、生成ルールのテスト専用を検索することで、出力ファイルである前提条件のターゲットが testonly にチェックされます。これは公開設定の確認と一致します。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_check_visibility_for_toolchains
: 「false」-
有効にすると、ツールチェーン実装にも可視性チェックが適用されます。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_disable_native_android_rules
: 「false」-
有効にすると、ネイティブ Android ルールの直接使用が無効になります。https://github.com/bazelbuild/rules_android の Starlark Android ルールを使用してください。
タグ:eagerness_to_exit
、incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
: 「false」-
いいえ。下位互換性のために、ここに残しておきます。
タグ:eagerness_to_exit
、incompatible_change
--[no]incompatible_force_strict_header_check_from_starlark
のデフォルト: "true"-
有効にすると、Starlark API で厳密なヘッダーのチェックを設定します。
タグ:loading_and_analysis
、changes_inputs
、incompatible_change
--[no]incompatible_python_disable_py2
のデフォルト: "true"-
true の場合、Python 2 の設定を使用するとエラーが発生します。これには、python_version=PY2、srcs_version=PY2、srcs_version=PY2ONLY が含まれます。詳しくは、https://github.com/bazelbuild/bazel/issues/15684 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
のデフォルト: "true"-
true の場合、Bazel は最上位のディレクトリ ヘッダーも検証します(詳細については https://github.com/bazelbuild/bazel/issues/10047 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--python_native_rules_allowlist=<a build target label>
: 説明を表示-
--compatible_python_disallow_native_rules を適用するときに使用する許可リスト(package_group ターゲット)。
タグ:loading_and_analysis
--[no]strict_filesets
: 「false」-
このオプションを有効にすると、パッケージの境界を超えるファイルセットがエラーとして報告されます。check_fileset_ dependencies_recursative が無効になっている場合、これは機能しません。
タグ:build_file_semantics
、eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
のデフォルト: "error"-
オフの場合を除いて、proto_library ターゲットは、直接使用されているすべてのターゲットを依存関係として明示的に宣言していることを確認します。
タグ:build_file_semantics
、eagerness_to_exit
、incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
のデフォルト: "off"-
オフの場合以外は、proto_library ターゲットが「import public」で使用されるすべてのターゲットを明示的にエクスポート済みとして宣言していることを確認します。
タグ:build_file_semantics
、eagerness_to_exit
、incompatible_change
--[no]strict_system_includes
: 「false」-
true の場合、system include パス(-isystem)にあるヘッダーも宣言する必要があります。
タグ:loading_and_analysis
、eagerness_to_exit
- 複数の
--target_environment=<a build target label>
が累計されます - このビルドのターゲット環境を宣言します。「環境」ルールを参照するラベルを指定する必要があります。指定する場合、トップレベル ターゲットはすべてこの環境に対応している必要があります。
タグ:changes_inputs
--apk_signing_method=<v1, v2, v1_v2 or v4>
のデフォルト: "v1_v2"-
APK の署名に使用する実装
タグ:action_command_lines
、affects_outputs
、loading_and_analysis
--[no]device_debug_entitlements
のデフォルト: "true"-
設定されていて、コンパイル モードが「opt」でない場合、署名時に objc アプリにデバッグ資格が含まれます。
タグ:changes_inputs
--ios_signing_cert_name=<a string>
: 説明を表示-
iOS 署名に使用する証明書名。設定しない場合、プロビジョニング プロファイルにフォールバックします。コード署名のマニュアル ページ(ID IDITITIES)に基づき、証明書のキーチェーン ID 設定または証明書の共通名(部分文字列)を指定できます。
タグ:action_command_lines
--[no]incompatible_config_setting_private_default_visibility
: 「false」-
compatible_enforce_config_setting_visibility=false の場合、これは noop です。このフラグを false に設定すると、明示的な可視性属性のない config_setting は //visibility:public になります。このフラグが true の場合、config_setting は他のすべてのルールと同じ可視性ロジックに従います。https://github.com/bazelbuild/bazel/issues/12933 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_disallow_legacy_py_provider
のデフォルト: "true"-
No-op はまもなく削除されます。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
: 「false」-
true の場合、objc_library および objc_import で sdk_frameworks 属性と weak_sdk_frameworks 属性を禁止します。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_enforce_config_setting_visibility
のデフォルト: "true"-
true の場合、config_setting 公開制限を適用します。false の場合、すべての config_setting がすべてのターゲットに表示されます。https://github.com/bazelbuild/bazel/issues/12932 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_objc_alwayslink_by_default
: 「false」-
true の場合、objc_library および objc_import の alwayslink 属性のデフォルト値を true にします。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_python_disallow_native_rules
: 「false」-
true の場合、組み込みの py_* ルールを使用するとエラーが発生します。代わりに、rule_python ルールを使用してください。詳細と移行手順については、https://github.com/bazelbuild/bazel/issues/17773 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]allow_analysis_failures
: 「false」-
true の場合、ルール ターゲットの分析に失敗すると、ビルドエラーになるのではなく、エラーの説明を含む AnalysisFailureInfo のインスタンスがターゲットに伝播されます。
タグ:loading_and_analysis
、experimental
--analysis_testing_deps_limit=<an integer>
: 「2000」-
for_analysis_testing 構成遷移でルール属性を介して推移的依存関係の最大数を設定します。この上限を超えると、ルールエラーが発生します。
タグ:loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure
: 「false」-
正しい dex2oat アクションが失敗すると、テスト ランタイム中に dex2oat が実行されるのではなく、ビルドが破損します。
タグ:loading_and_analysis
、experimental
--[no]check_tests_up_to_date
: 「false」-
テストは実行せず、最新かどうかだけを確認する。すべてのテスト結果が最新の状態であれば、テストは正常に完了しています。テストをビルドまたは実行する必要がある場合、エラーが報告され、テストは失敗します。このオプションは、--check_up_to_date の動作を意味します。
タグ:execution
--[no]experimental_android_use_parallel_dex2oat
: 「false」-
dex_oat を並行して使用すると、android_test が高速化される可能性があります。
タグ:loading_and_analysis
、host_machine_resource_optimizations
、experimental
- 複数の
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
が累計されます -
各テストは、テストが失敗した場合に、指定した回数まで再試行されます。複数回合格しなければならないテストは、テストの概要で「FLAKY」とマークされます。通常、指定する値は整数または文字列「default」のみです。整数の場合、すべてのテストは最大 N 回実行されます。「default」の場合、通常のテストでは 1 回のテストのみが行われ、ルールによって(flaky=1 属性によって)明示的にマークされたテストは 3 回行われます。別の構文: regex_filter@flaky_test_attemptsflaky_test_attempts は上記のとおりで、regex_filter は正規表現の包含と除外のリストを表します(--runs_per_test もご覧ください)。例: --flaky_test_attempts=//foo/.*、-//foo/bar/.*@3 は、foo/bar の下にあるテストを除くすべてのテストを //foo/に 3 回デフレークします。このオプションは複数回渡すことができます。最も最近渡された、一致する引数が優先されます。一致するものがない場合、その動作は上記の「デフォルト」のようになります。
タグ: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"、"HOST_CPUS"、"HOST_RAM")を取り、その後に演算子(-|*]<float>)を続けて使用します。例:"auto"、"HOST_CPUS*.5"。0 は、ローカル リソースが同時に実行されるローカルテスト ジョブの数を制限することを意味します。この値を --jobs の値よりも大きく設定しても効果はありません。
タグ:execution
- 複数の
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
が累計されます - 各テストを実行する回数を指定します。いずれかの理由でなんらかの試行が失敗した場合は、テスト全体が不合格とみなされます。通常、指定する値は単なる整数です。例: --runs_per_test=3 はすべてのテストを 3 回実行します。代替構文: regex_filter@runs_per_testrun_per_test は整数値を表し、regex_filter は正規表現パターンの追加と除外のリストを表します(--instrumentation_filter も参照)。例: --runs_per_test=//foo/.*、-//foo/bar/.*@3 は、foo/bar 下にあるテストを除くすべてのテストを //foo/で 3 回実行します。このオプションは複数回渡すことができます。最も最近渡された、一致する引数が優先されます。一致するものがない場合、テストは 1 回だけ実行されます。
- 複数の
--test_env=<a 'name=value' assignment with an optional value part>
が累計されます - テストランナー環境に挿入する追加の環境変数を指定します。変数は、名前により指定できます。名前を指定すると、Bazel クライアント環境または名前 / 値のペアから値が読み取られます。このオプションは、複数の変数を指定するために複数回使用できます。「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、medium、long、eternal のタイムアウトがこの順序でオーバーライドされます。どちらの形式でも -1 の値は、そのカテゴリのデフォルトのタイムアウトを使用するように Blaze に指示します。
--test_tmpdir=<a path>
: 説明を表示- 「bazel test」で使用する基本一時ディレクトリを指定します。
--tvos_simulator_device=<a string>
: 説明を表示-
シミュレータで tvOS アプリを実行する際にシミュレートするデバイス(「Apple TV 1080p」など)。デバイスのリストを取得するには、シミュレータを実行するマシンで「xcrun simctl list devicetypes」を実行します。
タグ:test_runner
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
実行中またはテスト時にシミュレータで実行する tvOS のバージョン。
タグ:test_runner
--watchos_simulator_device=<a string>
: 説明を表示-
シミュレータでスマートウォッチ OS アプリケーションを実行したときにシミュレートするデバイス(「Apple Watch - 38mm」など)。デバイスのリストを取得するには、シミュレータを実行するマシンで「xcrun simctl list devicetypes」を実行します。
タグ:test_runner
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
実行中またはテスト時にシミュレータで実行する watchOS のバージョン。
タグ:test_runner
--[no]zip_undeclared_test_outputs
のデフォルト: "true"-
true の場合、宣言されていないテスト出力が zip ファイルにアーカイブされます。
タグ:test_runner
--[no]collapse_duplicate_defines
のデフォルト: "true"-
有効にすると、冗長な --define がビルドの早期から削除されます。これにより、特定の種類の同等のビルドで分析キャッシュが不必要に失われるのを防ぐことができます。
タグ:loading_and_analysis
、loses_incremental_state
--[no]experimental_filter_library_jar_with_program_jar
: 「false」-
ProGuardJJar をフィルタして、LibraryJar 内にもあるクラスをすべて削除します。
タグ:action_command_lines
--[no]experimental_inmemory_dotd_files
のデフォルト: "true"-
有効にすると、C++ .d ファイルはディスクに書き込まれるのではなく、リモートビルドノードから直接メモリ内で渡されます。
タグ:loading_and_analysis
、execution
、affects_outputs
、experimental
--[no]experimental_inmemory_jdeps_files
のデフォルト: "true"-
有効にすると、Java コンパイルから生成された依存関係(.jdeps)ファイルがディスクに書き込まれるのではなく、リモートビルドノードから直接メモリ内で渡されます。
タグ:loading_and_analysis
、execution
、affects_outputs
、experimental
--[no]experimental_objc_include_scanning
: 「false」-
対象 C/C++ のインクルード スキャンを行うかどうかを指定します。
タグ:loading_and_analysis
、execution
、changes_inputs
--[no]experimental_retain_test_configuration_across_testonly
: 「false」-
有効にすると、--trim_test_configuration は testonly=1 とマークされたルールのテスト構成をカットしません。これは、テスト以外のルールが cc_test ルールに依存している場合に、アクションの競合の問題を減らすことを目的としています。--trim_test_configuration が false の場合、効果はありません。
タグ:loading_and_analysis
、loses_incremental_state
--[no]experimental_starlark_cc_import
: 「false」-
有効にすると、Starlark バージョンの cc_import を使用できます。
タグ:loading_and_analysis
、experimental
--[no]experimental_unsupported_and_brittle_include_scanning
: 「false」-
入力ファイルの #include 行を解析し、C/C++ コンパイルへの入力を絞り込むかどうかを指定します。これにより、コンパイル入力ツリーのサイズを小さくすることでパフォーマンスとインクリメンタリティを改善できます。ただし、インクルード スキャナは C プリプロセッサのセマンティクスを完全には実装していないため、ビルドが壊れる可能性もあります。特に、動的な #include ディレクティブは理解されず、プリプロセッサの条件付きロジックは無視されます。自己責任で使用してください。提出したこのフラグに関連する問題はすべてクローズされます。
タグ:loading_and_analysis
、execution
、changes_inputs
--[no]incremental_dexing
のデフォルト: "true"- ほとんどの Jar ファイルごとに dex 変換を行うためのほとんどの作業を行います。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--[no]objc_use_dotd_pruning
のデフォルト: "true"-
設定した場合、clang が出力する .d ファイルを使用して、objc コンパイルに渡される入力セットがプルーニングされます。
タグ:changes_inputs
、loading_and_analysis
--[no]process_headers_in_dependencies
: 「false」-
ターゲット //a:a をビルドする際、//a:a が依存するすべてのターゲット内のヘッダーを処理します(ツールチェーンでヘッダー処理が有効になっている場合)。
タグ:execution
--[no]trim_test_configuration
のデフォルト: "true"-
有効にすると、テスト関連のオプションはビルドの最上位の下にクリアされます。このフラグが有効な場合、テストをテスト以外のルールの依存関係としてテストすることはできません。ただし、テスト関連オプションを変更しても、テスト以外のルールが再分析されることはありません。
タグ:loading_and_analysis
、loses_incremental_state
--[no]use_singlejar_apkbuilder
のデフォルト: "true"-
このオプションは非推奨となりました。これは NoOps であり、まもなく削除されます。
タグ:loading_and_analysis
--[no]announce
: 「false」-
非推奨。No-Ops。
タグ:affects_outputs
--[no]experimental_bep_target_summary
: 「false」- TargetSummary イベントを公開するかどうかを指定します。
--[no]experimental_build_event_expand_filesets
: 「false」-
true の場合、出力ファイルを表示するときに BEP のファイルセットを展開します。
タグ:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: 「false」-
true の場合、出力ファイルを表示する際に、BEP 内の相対ファイルセット シンボリック リンクを完全に解決します。--experimental_build_event_expand_filesets が必要です。
タグ:affects_outputs
--experimental_build_event_upload_max_retries=<an integer>
: 「4」-
Bazel がビルドイベントのアップロードを再試行する最大回数。
タグ:bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
のデフォルト: 「1s」-
BEP のアップロードが失敗した場合の指数バックオフの再試行の最小遅延。(指数: 1.6)
タグ:bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string>
: 説明を表示- ビルドイベント プロトコルで参照されるアーティファクトをアップロードする方法を選択します。
タグ:affects_outputs
--[no]experimental_materialize_param_files_directly
: 「false」-
パラメータ ファイルを実体化する場合は、ディスクへの直接書き込みを行います。
タグ:execution
--[no]experimental_stream_log_file_uploads
: 「false」-
ログファイルがディスクに書き込まれるのではなく、リモート ストレージに直接アップロードされます。
タグ:affects_outputs
--explain=<a path>
: 説明を表示- : ビルドシステムが、ビルドの実行された各ステップを説明します。説明は指定したログファイルに書き込まれます。
タグ:affects_outputs
--[no]legacy_important_outputs
のデフォルト: "true"-
このパラメータを使用して、TargetComplete イベントで従来の有効期間が長い有効期間フィールドの抑制を図ります。Bazel と ResultStore の統合には、required_outputs が必要です。
タグ:affects_outputs
--[no]materialize_param_files
: 「false」-
リモート アクション実行を使用している場合でも、中間パラメータ ファイルを出力ツリーに書き込みます。アクションをデバッグする場合に便利です。これは --subcommands と --verbose_failures によって暗黙的に指定されます。
タグ:execution
--max_config_changes_to_show=<an integer>
: 「3」-
ビルド オプションの変更により分析キャッシュを破棄すると、変更されたオプション名が最大数まで表示されます。数字が -1 の場合は、変更されたオプションがすべて表示されます。
タグ:terminal_output
--max_test_output_bytes=<an integer>
のデフォルト: "-1"-
--test_output が「errors」または「all」のときに出力できるテストログごとの最大サイズを指定します。過度にノイズの多いテスト出力で、出力の過負荷を回避するために役立ちます。テストヘッダーはログサイズに含まれます。負の値は制限がないことを意味します。出力はオール オア ナッシングです。
タグ:test_runner
、terminal_output
、execution
--output_filter=<a valid Java regular expression>
: 説明を表示-
指定した正規表現に一致する名前を持つルールの警告のみを表示します。
タグ:affects_outputs
--progress_report_interval=<an integer in 0-3600 range>
のデフォルト: "0"-
実行中のジョブに関する報告の間隔(秒)。デフォルト値 0 を指定すると、最初のレポートは 10 秒後に出力され、30 秒後に進捗状況が 1 分に 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」、--test_strategy 値に関係なく、テストをローカルで一度に 1 つずつ実行する「ストリーミング」です。
タグ:test_runner
、terminal_output
、execution
--test_summary=<short, terse, detailed, none or testcase>
のデフォルト: "short"-
テストの概要の形式を指定します。有効な値は、実行したテストに関する情報のみを表示する「short」、失敗したテストに関する情報のみを表示する「details」、失敗したテストケースに関する詳細情報を表示する「detail」、テストケースの解決で詳細情報を出力する「testcase」、概要を省略する「none」です。
タグ:terminal_output
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*"-
ツールチェーンの解決中にデバッグ情報を出力します。このフラグは正規表現を受け取り、ツールチェーン タイプと特定のターゲットに対してチェックして、デバッグ対象を確認します。複数の正規表現がある場合はカンマで区切ります。各正規表現を個別にチェックします。注: このフラグの出力は非常に複雑であり、ツールチェーンの解決の専門家にのみ役立つ可能性があります。
タグ:terminal_output
--[no]verbose_explanations
: 「false」-
--explain が有効になっている場合に発行される説明の詳細度を高くします。--explain が有効になっていない場合、効果はありません。
タグ:affects_outputs
--[no]verbose_failures
: 「false」-
コマンドが失敗した場合は、コマンドライン全体を出力します。
タグ:terminal_output
- 複数の
--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>」という形式の単一の Key-Value ペアを引数として受け取ります。
タグ:changes_inputs
--[no]incompatible_default_to_explicit_init_py
: 「false」-
このフラグはデフォルトの動作を変更して、Python ターゲットのランファイル内で __init__.py ファイルが自動的に作成されないようにします。正確には、py_binary または py_test ターゲットで legacy_create_init が「auto」(デフォルト)に設定されている場合、このフラグが設定されている場合にのみ false として扱われます。https://github.com/bazelbuild/bazel/issues/10076 をご覧ください。
タグ:affects_outputs
、incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
のデフォルト: "true"-
true の場合、Python 2 構成でビルドされたターゲットは、接尾辞「-py2」を含む出力ルートの下に表示され、Python 3 用に作成されたターゲットは、Python 関連の接尾辞のないルートに表示されます。つまり、bazel-bin という便利なシンボリック シンボリック リンクは、Python 2 ではなく Python 3 のターゲットを指します。このオプションを有効にする場合は、「--compatibility_py3_is_default」も有効にすることをおすすめします。
タグ:affects_outputs
、incompatible_change
--[no]incompatible_py3_is_default
のデフォルト: "true"-
true の場合、`python_version`(または `default_python_version`)属性を設定していない `py_binary` と `py_test` ターゲットは、デフォルトで PY2 ではなく PY3 になります。このフラグを設定する場合は、----compatible_py2_outputs_are_suffixed` も設定することをおすすめします。
タグ:loading_and_analysis
、affects_outputs
、incompatible_change
--[no]incompatible_use_python_toolchains
のデフォルト: "true"-
true に設定すると、実行可能なネイティブ Python ルールでは、--python_top などのレガシーフラグで指定されたランタイムではなく、Python ツールチェーンで指定された Python ランタイムが使用されます。
タグ:loading_and_analysis
、incompatible_change
--python_version=<PY2 or PY3>
: 説明を表示-
Python のメジャー バージョン モード。「PY2」または「PY3」。「py_binary」ターゲットと「py_test」ターゲットでオーバーライドされます。バージョンを明示的に指定していない場合でも、このフラグを指定する理由は通常あまりありません。
タグ:loading_and_analysis
、affects_outputs
、explicit_in_output_path
--target_pattern_file=<a string>
のデフォルト: "-
設定した場合、ビルドはコマンドラインではなく、ここで指定したファイルからパターンを読み取ります。ここでは、ファイルとコマンドライン パターンを指定するとエラーが発生します。
タグ:changes_inputs
--experimental_remote_cache_eviction_retries=<an integer>
のデフォルト: "0"-
ビルドでリモート キャッシュのエビクション エラーが発生した場合の再試行の最大回数。値が 0 でない場合は、暗黙的に --compatible_remote_use_new_exit_code_for_lost_inputs が true に設定されます。
タグ:execution
--[no]incompatible_remote_use_new_exit_code_for_lost_inputs
のデフォルト: "true"-
true に設定すると、ビルド時にリモート キャッシュが blob を削除する場合、Bazel は新しい終了コード 39 を使用します。
タグ:incompatible_change
--[no]build_manual_tests
: 「false」- 「手動」とタグ付けされたテスト ターゲットを強制的にビルドします。「手動」テストは処理から除外されます。このオプションにより、強制的にビルドされます(実行はされません)。
--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 に設定すると、Bazel は(1)Bazel がテストまたはその依存関係の変更を検出した場合、(2)テストが外部としてマークされている場合、(3)以前に複数のテスト実行が --runs_per_test でリクエストされたか、(4)テストに失敗した場合にのみ、テストを再実行します。「yes」に設定すると、外部としてマークされたテストを除くすべてのテスト結果が Bazel によってキャッシュに保存されます。「no」に設定すると、Bazel はテスト結果をキャッシュに保存しません。
--[no]compile_one_dependency
: 「false」- 引数ファイルの単一依存関係をコンパイルします。これは、IDE のソースファイルを構文チェックする場合に有用です。たとえば、ソースファイルに依存している単一のターゲットを再構築して、編集、ビルド、テストサイクルのできるだけ早い段階でエラーを検出します。この引数は、すべての非フラグ引数の解釈方法に影響を与え、ビルド対象ではなくソースファイル名になります。ソースファイル名ごとに、それに依存する任意のターゲットがビルドされます。
- 複数の
--deleted_packages=<comma-separated list of package names>
が累計されます - パッケージ パスのどこかに表示されている場合でも、ビルドシステムが存在しないとみなすパッケージ名のカンマ区切りのリスト。 既存のパッケージ「x」のサブパッケージ「x/y」を削除する場合は、このオプションを使用します。たとえば、クライアントで x/y/BUILD を削除した後、別の package_path エントリによって "/x:y/z" が引き続き使用されている場合、ビルドシステムからその苦情が寄せられることがあります。この問題は、--delete_packages x/y と指定すると回避されます。
--[no]discard_analysis_cache
: 「false」- 分析フェーズが完了したらすぐに分析キャッシュを破棄します。メモリ使用量が最大 10% 減少しますが、増分ビルドはさらに遅くなります。
--execution_log_binary_file=<a path>
: 説明を表示- src/main/protobuf/spawn.proto に従って、実行された生成をこのファイルに区切りの Spawn proto として記録します。ログは、順序付けされていない状態で最初に書き込まれ、呼び出しの最後には安定した順序で並べられます(CPU とメモリを大量に消費する可能性があります)。関連フラグ: --execution_log_json_file(順序付きテキスト JSON 形式)、--experimental_execution_log_file(順序なしバイナリ protobuf 形式)、--subcommands(ターミナル出力にサブコマンドを表示するためのもの)。
--execution_log_json_file=<a path>
: 説明を表示- 実行されたスポーンを、src/main/protobuf/spawn.proto に従って区切りの Spawn proto の json 表現としてこのファイルに含めます。ログは、順序付けされていない状態で最初に書き込まれ、呼び出しの最後には安定した順序で並べられます(CPU とメモリを大量に消費する可能性があります)。関連するフラグ: --execution_log_binary_file(順序付きバイナリ protobuf 形式)、--experimental_execution_log_file(順序なしバイナリ protobuf 形式)、--subcommands(ターミナル出力にサブコマンドを表示)
--[no]execution_log_sort
のデフォルト: "true"- 実行ログを並べ替えるかどうか。メモリのパフォーマンスを高めるために false に設定すると、ログが非決定的な順序で生成されます。
--[no]expand_test_suites
のデフォルト: "true"-
分析を行う前に、test_suite ターゲットを構成テストに拡張します。このフラグがオンの場合(デフォルト)、ネガティブ ターゲット パターンはテストスイートに属するテストに適用されます。それ以外の場合、適用されません。最上位レベルをコマンドラインで適用し、test_suite ターゲットを分析できる場合は、このフラグをオフにすると便利です。
タグ:loading_and_analysis
--[no]experimental_cancel_concurrent_tests
: 「false」-
true の場合、Blaze は初回実行に成功したときに同時実行中のテストをキャンセルします。これは --runs_per_test_detects_flakes と組み合わせた場合にのみ有効です。
タグ:affects_outputs
、loading_and_analysis
--experimental_execution_log_file=<a path>
: 説明を表示- src/main/protobuf/spawn.proto に従って、実行された生成をこのファイルに区切りの Spawn proto として記録します。このファイルは、Spawns の実行順に書き込まれます。関連フラグ: --execution_log_binary_file(順序付きバイナリ protobuf 形式)、--execution_log_json_file(順序付きテキスト json 形式)、--subcommands(ターミナル出力にサブコマンドを表示するためのもの)。
--[no]experimental_execution_log_spawn_metrics
: 「false」- 実行されたスポーンログにスポーン指標を含めます。
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
のデフォルト: "- いくつかの側面を重視して非推奨になりました。additional_actions をスケジュールするターゲットのセットをフィルタします。
--[no]experimental_extra_action_top_level_only
: 「false」- いくつかの側面を重視して非推奨になりました。トップレベル ターゲットに対してのみ、extra_actions をスケジュールします。
--[no]experimental_fetch_all_coverage_outputs
: 「false」-
true の場合、Bazel はカバレッジ実行中に、テストごとにカバレッジ データ ディレクトリ全体を取得します。
タグ:affects_outputs
、loading_and_analysis
--[no]experimental_generate_llvm_lcov
: 「false」-
true の場合、clang が LCOV カバレッジの対象となります。
タグ:affects_outputs
、loading_and_analysis
--[no]experimental_j2objc_header_map
のデフォルト: "true"- J2ObjC のトランスパイルと並行して J2ObjC ヘッダー マップを生成するかどうか。
--[no]experimental_j2objc_shorter_header_path
: 「false」-
ヘッダーパスを短くして生成するかどうか(「_j2objc」ではなく「_ios」)。
タグ:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
のデフォルト: "javabuilder"- Java コンパイルのクラスパスを削減できます。
--[no]experimental_limit_android_lint_to_android_constrained_java
: 「false」-
--experimental_run_android_lint_on_java_rules を Android 互換ライブラリに制限します。
タグ:affects_outputs
--[no]experimental_prioritize_local_actions
のデフォルト: "true"-
設定されている場合、ローカルでのみ実行できるアクションが、リソースの取得で最初に機会を与えられ、動的に実行されるワーカーが 2 回目の機会を得て、動的に実行されるスタンドアロン アクションが最後に来ます。
タグ:execution
--[no]experimental_run_android_lint_on_java_rules
: 「false」-
java_* のソースを検証するかどうかを指定します。
タグ:affects_outputs
--[no]explicit_java_test_deps
: 「false」- TestRunner の依存関係から誤って取得するのではなく、java_test で JUnit または Hamcrest への依存関係を明示的に指定します。現在のところ、bazel の場合のみ機能します。
--host_java_launcher=<a build target label>
: 説明を表示- ビルド時に実行されるツールで使用される Java ランチャー。
- 複数の
--host_javacopt=<a string>
が累計されます - ビルド時に実行されるツールをビルドするときに javac に渡す追加のオプション。
- 複数の
--host_jvmopt=<a string>
が累計されます - ビルド時に実行されるツールをビルドするときに Java VM に渡す追加のオプション。これらのオプションは、各 java_binary ターゲットの VM 起動オプションに追加されます。
--[no]incompatible_check_sharding_support
のデフォルト: "true"-
true の場合、TEST_SHARD_STATUS_FILE のパスにあるファイルをタップしてシャーディングをサポートしていることをテストランナーが示していない場合、Bazel はシャーディングされたテストに失敗します。false の場合、シャーディングをサポートしていないテストランナーは、各シャードで実行されるすべてのテストを実行します。
タグ:incompatible_change
--[no]incompatible_exclusive_test_sandboxed
のデフォルト: "true"-
true の場合、サンドボックス化された戦略で排他的テストが実行されます。「local」タグを追加して、ローカルで排他的テストを強制的に実行します。
タグ:incompatible_change
--[no]incompatible_strict_action_env
: 「false」-
true の場合、Bazel は PATH に静的な値が設定された環境を使用し、LD_LIBRARY_PATH を継承しません。クライアントから特定の環境変数を継承する場合は --action_env=ENV_VARIABLE を使用しますが、継承すると、共有キャッシュを使用している場合にユーザー間のキャッシュが防止される可能性があります。
タグ:loading_and_analysis
、incompatible_change
- 複数の
--j2objc_translation_flags=<comma-separated list of options>
が累計されます - J2ObjC ツールに渡す追加のオプション。
--java_debug
-
Java テストの Java 仮想マシンで、JDWP 準拠のデバッガ(jdb など)からの接続を待機してからテストを開始します。暗黙的に -test_output=streamed となります。
以下に展開:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
のデフォルト: "true"- Java ターゲットごとに依存関係情報(現時点ではコンパイル時クラスパス)を生成します。
--[no]java_header_compilation
のデフォルト: "true"- ソースから ijar を直接コンパイルします。
--java_language_version=<a string>
のデフォルト: "- Java 言語バージョン
--java_launcher=<a build target label>
: 説明を表示- Java バイナリをビルドするときに使用する Java ランチャー。このフラグを空の文字列に設定すると、JDK ランチャーが使用されます。このフラグは「ランチャー」属性によってオーバーライドされます。
--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_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
のデフォルト: HOST_CPUS- Bazel がローカルで実行されるビルド アクションに使用できるローカル CPU コアの総数を明示的に設定します。整数または「HOST_CPUS」を取り、その後に続けて [-|*]<float>(例:HOST_CPUS*.5 を使用して、使用可能な CPU コアの半分を使用できます)。デフォルトでは、Bazel はシステム構成をクエリして使用可能な CPU コア数を推定します。
- 複数の
--local_extra_resources=<a named float, 'name=value'>
が累計されます - Bazel で利用可能な追加リソースの数を設定します。文字列と浮動小数点のペアを受け入れます。複数回使用できるため、複数の種類の追加リソースを指定できます。Bazel は、利用可能な追加のリソースと必要な追加リソースに基づいて、同時に実行されるアクションを制限します。テストでは、「resources:<resoucename>:<amount>」形式のタグを使用して、必要な追加リソースの量を宣言できます。このフラグを使用して、使用可能な CPU、RAM、リソースを設定することはできません。
--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 など)。デフォルトで "HOST_RAM*.67"(Bazel)は、システム構成を照会して使用可能な RAM の量を推定し、その 67% を使用します。
--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"-
proto-compiler のラベル。
タグ:affects_outputs
、loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
のデフォルト: "@bazel_tools//tools/proto:cc_ツールチェーン"-
C++ proto のコンパイル方法を示す proto_lang_ツールチェーン() のラベル
タグ:affects_outputs
、loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
のデフォルト: "@bazel_tools//tools/j2objc:j2objc_proto_ツールチェーン"-
j2objc proto のコンパイル方法を示す proto_lang_ツールチェーン() のラベル
タグ:affects_outputs
、loading_and_analysis
--proto_toolchain_for_java=<a build target label>
のデフォルト: "@bazel_tools//tools/proto:java_ツールチェーン"- Java proto のコンパイル方法を示す proto_lang_ツールチェーン() のラベル
タグ:affects_outputs
、loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
のデフォルト: "@bazel_tools//tools/proto:javalite_ツールチェーン"- JavaLite proto のコンパイル方法を示す proto_lang_ツールチェーン() のラベル
タグ:affects_outputs
、loading_and_analysis
- 複数の
--protocopt=<a string>
が累計されます -
protobuf コンパイラに渡す追加オプション。
タグ:affects_outputs
--[no]runs_per_test_detects_flakes
: 「false」- true の場合、1 つ以上の実行/試行が成功し、1 つ以上の実行/試行が失敗したシャードは、FLAKY ステータスになります。
--shell_executable=<a path>
: 説明を表示-
Bazel が使用するシェル実行可能ファイルの絶対パス。これが設定されていない場合、BAZEL_SH 環境変数が Bazel の最初の呼び出し(Bazel サーバーを起動する)で設定されている場合、Bazel はそれを使用します。どちらも設定されていない場合、Bazel はオペレーティング システムに応じてハードコードされたデフォルト パスを使用します(Windows: c:/tools/msys64/usr/bin/bash.exe、FreeBSD: /usr/local/bin/bash、その他: /bin/bash)。bash と互換性のないシェルを使用すると、生成されたバイナリのビルドエラーやランタイム エラーが発生する可能性があります。
タグ:loading_and_analysis
--[no]show_loading_progress
のデフォルト: "true"- 有効にすると、Bazel は「Loading package:」のメッセージを出力します。
- 複数の
--test_arg=<a string>
が累計されます - テストの実行可能ファイルに渡す追加のオプションと引数を指定します。複数の引数を指定するには、複数回使用できます。複数のテストが実行される場合、各テストは同一の引数を受け取ります。「bazel test」コマンドでのみ使用されます。
--test_filter=<a string>
: 説明を表示- テスト フレームワークに転送するフィルタを指定します。テストの実行を制限するために使用します。なお、これはビルドされるターゲットには影響しません。
--test_lang_filters=<comma-separated list of options>
のデフォルト: "- テスト言語のカンマ区切りリストを指定します。必要に応じて、各言語の前に「-」を付けて、除外する言語を指定できます。指定されたターゲットでテストターゲットのみが検索されます。各言語に使用する名前は、*_test ルールの言語接頭辞と同じにする必要があります(例: 「cc」、「java」、「py」など)。このオプションは、--build_tests_only の動作とテストコマンドに影響します。
--test_result_expiration=<an integer>
のデフォルト: "-1"- このオプションは非推奨であり、効果はありません。
--[no]test_runner_fail_fast
: 「false」- フォワード ファスト オプションをテストランナーに転送します。テストランナーは、最初の失敗時に実行を停止する必要があります。
--test_sharding_strategy=<explicit, disabled or forced=k where k is the number of shards to enforce>
: 「露骨な表現」- テストのシャーディング戦略を指定: 「explicit」: 「shard_count」の BUILD 属性が存在する場合のみ、シャーディングを使用します。テスト シャーディングを使用しないようにするには、「無効」にします。'shard_count' BUILD 属性に関係なく、「forced=k」を指定するとテストに「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 が使用されます。これにより、増分コンパイルは速くなりますが、エラー メッセージが異なることがあります。
- 複数の
--distdir=<a path>
が累計されます -
ネットワークにアクセスする前にアーカイブを検索できる追加の場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュはコピーではなくファイルをハードリンクします。これはディスク容量を節約することを目的としています。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
: 「false」-
true の場合、指定されていない場合は、リポジトリのダウンロードの URL から派生した文字列を canonical_id として使用します。これにより、キャッシュにハッシュが同じであっても、URL が変更されると再ダウンロードが発生します。これを使用して、URL の変更によって破損したリポジトリがキャッシュによってマスクされないことを確認できます。
タグ:loading_and_analysis
、experimental
--experimental_repository_downloader_retries=<an integer>
のデフォルト: "0"-
ダウンロード エラーを再試行する最大回数。0 に設定すると、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: "1.0"-
この要因により、Starlark リポジトリ ルールのすべてのタイムアウトをスケーリングします。このように、ソースコードを変更しなくても、ルールの作成者が想定したよりも遅いマシンで外部リポジトリを作成できます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: "0s"-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にすると、タイムアウトは定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: "1.0"-
特定の要因による HTTP ダウンロードに関連するすべてのタイムアウトをスケーリングします。
タグ:bazel_internal_configuration
--repository_cache=<a path>
: 説明を表示-
外部リポジトリの取得時に取得した、ダウンロードした値のキャッシュの場所を指定します。引数に空の文字列がある場合は、キャッシュの無効化をリクエストします。そうでなければ、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
: 「false」-
設定した場合、ctx.download{,_and_extract} を使用したダウンロードはリポジトリの取得時に許可されません。なお、ネットワーク アクセスが完全に無効というわけではなく、ctx.execute はインターネットにアクセスする任意の実行可能ファイルを実行します。
タグ:bazel_internal_configuration
--experimental_oom_more_eagerly_threshold=<an integer in 0-100 range>
: 「100」-
このフラグが 100 より小さい値に設定されている場合、2 つの完全な GC の後も(この古い世代の)ヒープの占有率がこの割合を超えると、Bazel は OOM を行います。
タグ:host_machine_resource_optimizations
--[no]canonicalize_policy
: 「false」-
展開とフィルタリングを行った後、正規のポリシーを出力します。出力をクリーンに保つため、このオプションを true に設定した場合、正規化されたコマンド引数は表示されません。--for_command で指定されたコマンドはフィルタ済みのポリシーに影響します。指定しない場合、デフォルトのコマンドは「build」になります。
タグ:affects_outputs
、terminal_output
--[no]show_warnings
: 「false」-
標準エラーにパーサー警告を出力します(競合するフラグ オプションなど)。
タグ:affects_outputs
、terminal_output
--experimental_repository_hash_file=<a string>
のデフォルト: "-
空でない場合、リポジトリ ディレクトリのハッシュを検証する必要がある値を含むファイルを指定します。
タグ:affects_outputs
、experimental
- 複数の
--experimental_verify_repository_rules=<a string>
が累計されます -
出力ディレクトリのハッシュを検証する必要があるリポジトリ ルールのリストの場合、ファイルは --experimental_repository_hash_file で指定します。
タグ:affects_outputs
、experimental
--[no]experimental_allow_top_level_aspects_parameters
のデフォルト: "true"-
No-op
タグ:no_op
、deprecated
、experimental
--[no]incompatible_config_setting_private_default_visibility
: 「false」-
compatible_enforce_config_setting_visibility=false の場合、これは noop です。このフラグを false に設定すると、明示的な可視性属性のない config_setting は //visibility:public になります。このフラグが true の場合、config_setting は他のすべてのルールと同じ可視性ロジックに従います。https://github.com/bazelbuild/bazel/issues/12933 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_enforce_config_setting_visibility
のデフォルト: "true"-
true の場合、config_setting 公開制限を適用します。false の場合、すべての config_setting がすべてのターゲットに表示されます。https://github.com/bazelbuild/bazel/issues/12932 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
- 複数の
--allow_yanked_versions=<a string>
が累計されます -
モジュール バージョンは、発生元であるレジストリで(NonRegistryOverride のもの以外から)yanked が宣言されている場合でも、解決された依存関係グラフで許可する「<module1>@<version1>,<module2>@<version2>」の形式で指定します。そうしないと、ジャンクされたバージョンが原因で解決に失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可される yanked バージョンを定義することもできます。このチェックを無効にするには、キーワード「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 の場合、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」は無視されます。このフラグの値に関係なく、MODULE.bazel がルート モジュールでない場合、これらの dev 依存関係は常に無視されます。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: "off"-
ロックファイルを使用するかどうかを指定します。有効な値は、lockfile を使用して更新する場合は「update」、変更がある場合は「lock」、最新ではない場合はエラーをスローし、lockfile からの読み取りと書き込みを行わない場合は「off」です。
タグ:loading_and_analysis
- 複数の
--override_module=<an equals-separated mapping of module name to path>
が累計されます - <module name>=<path> の形式のローカルパスでモジュールをオーバーライドします。指定されたパスが絶対パスである場合、そのパスが使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリへの相対パスになります。パスが %workspace% で始まる場合は、ワークスペースのルート(「bazel info workspace」の出力)への相対パスになります。
- 複数の
--registry=<a string>
が累計されます -
Bazel モジュールの依存関係を見つけるために使用するレジストリを指定します。順序は重要です。つまり、最初に古いレジストリでモジュールが検索され、以前のレジストリに欠落している場合にのみ、後続のレジストリにフォールバックします。
タグ:changes_inputs
--experimental_gc_thrashing_limits=<comma separated pairs of <period>:<count>>
のデフォルト: "-
到達した場合、GcThrashingDetector が OOM で Bazel をクラッシュさせる制限。それぞれの上限は <period>:<count> と指定します。period は期間、count は正の整数です。<period> 内に <count> 個の連続した GC が続くと、在室スペース(古い世代のヒープ)の --experimental_oom_more_eagerly_threshold パーセントを超えると、OOM がトリガーされます。複数の上限をカンマ区切りで指定できます。
タグ:host_machine_resource_optimizations
--[no]gc_thrashing_limits_retained_heap_limiter_mutually_exclusive
のデフォルト: "true"-
true の場合、空でない --experimental_gc_thrashing_limits を指定すると、RetainedHeapLimiter が非アクティブになり、GcThrashingDetector と相互に排他的になります。false に設定すると、同じコマンドで両方ともアクティブになります。
タグ: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 で設定されたしきい値を超えたことを検出した場合、呼び出しごとに最大回数の不完全な一時的な 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 状態を削除します。これを微調整することで、(i)GC スラッシングが(i)この一時的な状態のメモリ使用に起因し、(ii)必要になったときに状態を再構築するよりもコストが高くなる場合に、GC スラッシングのウォールタイムの影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
--[no]experimental_command_profile
: 「false」- Java Flight Recorder の CPU プロファイルを出力ベース ディレクトリの profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプまたは出力形式をサポートするように将来変更される場合があります。自己責任で使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
: 「false」- デフォルトでは、アクション タイプの数は、実行されているアクションの数が最も多い 20 ニーモニックに制限されます。このオプションを設定すると、すべての覚え書きの統計情報が書き込まれます。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: "-
空でない場合、WORKFILE ファイルの代わりに指定された解決済みファイルを読み取る。
タグ:changes_inputs
--for_command=<a string>
のデフォルト: "build"-
オプションを正規化するためのコマンド。
タグ:affects_outputs
、terminal_output
--invocation_policy=<a string>
のデフォルト: "-
正規化するオプションに呼び出しポリシーを適用します。
タグ:affects_outputs
、terminal_output
--experimental_downloader_config=<a string>
: 説明を表示- リモート ダウンローダを構成するファイルを指定します。このファイルは、各行がディレクティブ(allow、block、rewrite)で始まり、その後にホスト名(allow と block)または 2 つのパターン(一致するもの、代替 URL として使用するもの)が続きます。$1 で始まるバック参照、つまり、複数の URL の REC ディレクティブによって試行できます。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: "off"- リポジトリの取得に使用するスレッドモード。「off」に設定した場合、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、プラットフォーム スレッド(OS スレッドなど)を「platform」に設定するか、仮想スレッドを「virtual」に設定します。
- 複数の
--deleted_packages=<comma-separated list of package names>
が累計されます - パッケージ パスのどこかに表示されている場合でも、ビルドシステムが存在しないとみなすパッケージ名のカンマ区切りのリスト。 既存のパッケージ「x」のサブパッケージ「x/y」を削除する場合は、このオプションを使用します。たとえば、クライアントで x/y/BUILD を削除した後、別の package_path エントリによって "/x:y/z" が引き続き使用されている場合、ビルドシステムからその苦情が寄せられることがあります。この問題は、--delete_packages x/y と指定すると回避されます。
- 複数の
--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
--[no]experimental_repository_cache_hardlinks
: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュはコピーではなくファイルをハードリンクします。これはディスク容量を節約することを目的としています。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
: 「false」-
true の場合、指定されていない場合は、リポジトリのダウンロードの URL から派生した文字列を canonical_id として使用します。これにより、キャッシュにハッシュが同じであっても、URL が変更されると再ダウンロードが発生します。これを使用して、URL の変更によって破損したリポジトリがキャッシュによってマスクされないことを確認できます。
タグ:loading_and_analysis
、experimental
--experimental_repository_downloader_retries=<an integer>
のデフォルト: "0"-
ダウンロード エラーを再試行する最大回数。0 に設定すると、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: "1.0"-
この要因により、Starlark リポジトリ ルールのすべてのタイムアウトをスケーリングします。このように、ソースコードを変更しなくても、ルールの作成者が想定したよりも遅いマシンで外部リポジトリを作成できます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: "0s"-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にすると、タイムアウトは定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: "1.0"-
特定の要因による HTTP ダウンロードに関連するすべてのタイムアウトをスケーリングします。
タグ:bazel_internal_configuration
--repository_cache=<a path>
: 説明を表示-
外部リポジトリの取得時に取得した、ダウンロードした値のキャッシュの場所を指定します。引数に空の文字列がある場合は、キャッシュの無効化をリクエストします。そうでなければ、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
: 「false」-
設定した場合、ctx.download{,_and_extract} を使用したダウンロードはリポジトリの取得時に許可されません。なお、ネットワーク アクセスが完全に無効というわけではなく、ctx.execute はインターネットにアクセスする任意の実行可能ファイルを実行します。
タグ:bazel_internal_configuration
--experimental_oom_more_eagerly_threshold=<an integer in 0-100 range>
: 「100」-
このフラグが 100 より小さい値に設定されている場合、2 つの完全な GC の後も(この古い世代の)ヒープの占有率がこの割合を超えると、Bazel は OOM を行います。
タグ: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
-
クリーンに指定すると、bazel インスタンスの作業ツリー全体が非同期で削除されます。これには、bazel が作成したすべての一時ファイルとビルド出力ファイルが含まれ、実行中の bazel サーバーが停止します。このコマンドは、削除がバックグラウンドで続行されても、同じクライアントで新しいコマンドを実行しても安全です。
以下に展開:
--expunge
--async
タグ:host_machine_resource_optimizations
--[no]remove_all_convenience_symlinks
: 「false」-
true の場合、接頭辞 symlink_prefix が付いたワークスペースのすべてのシンボリック リンクが削除されます。このフラグがない場合、事前定義のサフィックスを持つシンボリック リンクのみがクリーニングされます。
タグ:affects_outputs
--experimental_repository_hash_file=<a string>
のデフォルト: "-
空でない場合、リポジトリ ディレクトリのハッシュを検証する必要がある値を含むファイルを指定します。
タグ:affects_outputs
、experimental
- 複数の
--experimental_verify_repository_rules=<a string>
が累計されます -
出力ディレクトリのハッシュを検証する必要があるリポジトリ ルールのリストの場合、ファイルは --experimental_repository_hash_file で指定します。
タグ:affects_outputs
、experimental
--[no]experimental_allow_top_level_aspects_parameters
のデフォルト: "true"-
No-op
タグ:no_op
、deprecated
、experimental
- 複数の
--allow_yanked_versions=<a string>
が累計されます -
モジュール バージョンは、発生元であるレジストリで(NonRegistryOverride のもの以外から)yanked が宣言されている場合でも、解決された依存関係グラフで許可する「<module1>@<version1>,<module2>@<version2>」の形式で指定します。そうしないと、ジャンクされたバージョンが原因で解決に失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可される yanked バージョンを定義することもできます。このチェックを無効にするには、キーワード「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 の場合、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」は無視されます。このフラグの値に関係なく、MODULE.bazel がルート モジュールでない場合、これらの dev 依存関係は常に無視されます。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: "off"-
ロックファイルを使用するかどうかを指定します。有効な値は、lockfile を使用して更新する場合は「update」、変更がある場合は「lock」、最新ではない場合はエラーをスローし、lockfile からの読み取りと書き込みを行わない場合は「off」です。
タグ:loading_and_analysis
- 複数の
--override_module=<an equals-separated mapping of module name to path>
が累計されます - <module name>=<path> の形式のローカルパスでモジュールをオーバーライドします。指定されたパスが絶対パスである場合、そのパスが使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリへの相対パスになります。パスが %workspace% で始まる場合は、ワークスペースのルート(「bazel info workspace」の出力)への相対パスになります。
- 複数の
--registry=<a string>
が累計されます -
Bazel モジュールの依存関係を見つけるために使用するレジストリを指定します。順序は重要です。つまり、最初に古いレジストリでモジュールが検索され、以前のレジストリに欠落している場合にのみ、後続のレジストリにフォールバックします。
タグ:changes_inputs
--experimental_gc_thrashing_limits=<comma separated pairs of <period>:<count>>
のデフォルト: "-
到達した場合、GcThrashingDetector が OOM で Bazel をクラッシュさせる制限。それぞれの上限は <period>:<count> と指定します。period は期間、count は正の整数です。<period> 内に <count> 個の連続した GC が続くと、在室スペース(古い世代のヒープ)の --experimental_oom_more_eagerly_threshold パーセントを超えると、OOM がトリガーされます。複数の上限をカンマ区切りで指定できます。
タグ:host_machine_resource_optimizations
--[no]gc_thrashing_limits_retained_heap_limiter_mutually_exclusive
のデフォルト: "true"-
true の場合、空でない --experimental_gc_thrashing_limits を指定すると、RetainedHeapLimiter が非アクティブになり、GcThrashingDetector と相互に排他的になります。false に設定すると、同じコマンドで両方ともアクティブになります。
タグ: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 で設定されたしきい値を超えたことを検出した場合、呼び出しごとに最大回数の不完全な一時的な 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 状態を削除します。これを微調整することで、(i)GC スラッシングが(i)この一時的な状態のメモリ使用に起因し、(ii)必要になったときに状態を再構築するよりもコストが高くなる場合に、GC スラッシングのウォールタイムの影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
--[no]experimental_command_profile
: 「false」- Java Flight Recorder の CPU プロファイルを出力ベース ディレクトリの profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプまたは出力形式をサポートするように将来変更される場合があります。自己責任で使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
: 「false」- デフォルトでは、アクション タイプの数は、実行されているアクションの数が最も多い 20 ニーモニックに制限されます。このオプションを設定すると、すべての覚え書きの統計情報が書き込まれます。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: "-
空白でない場合は、WORKSPACE ファイルではなく指定された解決済みファイルを読み込みます。
タグ:changes_inputs
--experimental_downloader_config=<a string>
: 説明を表示- リモート ダウンローダを構成するファイルを指定します。このファイルは、各行がディレクティブ(allow、block、rewrite)で始まり、その後にホスト名(allow と block)または 2 つのパターン(一致するもの、代替 URL として使用するもの)が続きます。$1 で始まるバック参照、つまり、複数の URL の REC ディレクティブによって試行できます。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: "off"- リポジトリの取得に使用するスレッドモード。「off」に設定した場合、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、プラットフォーム スレッド(OS スレッドなど)を「platform」に設定するか、仮想スレッドを「virtual」に設定します。
- 複数の
--override_repository=<an equals-separated mapping of repository name to path>
が累計されます - リポジトリを <リポジトリ名>=<パス> の形式でローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスが使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリへの相対パスになります。指定したパスが %workspace% で始まる場合は、ワークスペースのルート(`bazel info workspace`の出力)に対する相対パスになります。
- 複数の
--distdir=<a path>
が累計されます -
ネットワークにアクセスする前にアーカイブを検索できる追加の場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュはコピーではなくファイルをハードリンクします。これはディスク容量を節約することを目的としています。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
: 「false」-
true の場合、指定されていない場合は、リポジトリのダウンロードの URL から派生した文字列を canonical_id として使用します。これにより、キャッシュにハッシュが同じであっても、URL が変更されると再ダウンロードが発生します。これを使用して、URL の変更によって破損したリポジトリがキャッシュによってマスクされないことを確認できます。
タグ:loading_and_analysis
、experimental
--experimental_repository_downloader_retries=<an integer>
のデフォルト: "0"-
ダウンロード エラーを再試行する最大回数。0 に設定すると、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: "1.0"-
この要因により、Starlark リポジトリ ルールのすべてのタイムアウトをスケーリングします。このように、ソースコードを変更しなくても、ルールの作成者が想定したよりも遅いマシンで外部リポジトリを作成できます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: "0s"-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にすると、タイムアウトは定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: "1.0"-
特定の要因による HTTP ダウンロードに関連するすべてのタイムアウトをスケーリングします。
タグ:bazel_internal_configuration
--repository_cache=<a path>
: 説明を表示-
外部リポジトリの取得時に取得した、ダウンロードした値のキャッシュの場所を指定します。引数に空の文字列がある場合は、キャッシュの無効化をリクエストします。そうでなければ、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
: 「false」-
設定した場合、ctx.download{,_and_extract} を使用したダウンロードはリポジトリの取得時に許可されません。なお、ネットワーク アクセスが完全に無効というわけではなく、ctx.execute はインターネットにアクセスする任意の実行可能ファイルを実行します。
タグ:bazel_internal_configuration
--experimental_oom_more_eagerly_threshold=<an integer in 0-100 range>
: 「100」-
このフラグが 100 より小さい値に設定されている場合、2 つの完全な GC の後も(この古い世代の)ヒープの占有率がこの割合を超えると、Bazel は OOM を行います。タグ:
host_machine_resource_optimizations
--experimental_repository_hash_file=<a string>
のデフォルト: "-
空でない場合、リポジトリ ディレクトリのハッシュを検証する必要がある値を含むファイルを指定します。
タグ:affects_outputs
、experimental
- 複数の
--experimental_verify_repository_rules=<a string>
が累計されます -
出力ディレクトリのハッシュを検証する必要があるリポジトリ ルールのリストの場合、ファイルは --experimental_repository_hash_file で指定します。
タグ:affects_outputs
、experimental
--[no]experimental_allow_top_level_aspects_parameters
のデフォルト: "true"-
No-op
タグ:no_op
、deprecated
、experimental
- 複数の
--allow_yanked_versions=<a string>
が累計されます -
モジュール バージョンは、発生元であるレジストリで(NonRegistryOverride のもの以外から)yanked が宣言されている場合でも、解決された依存関係グラフで許可する「<module1>@<version1>,<module2>@<version2>」の形式で指定します。そうしないと、ジャンクされたバージョンが原因で解決に失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可される yanked バージョンを定義することもできます。このチェックを無効にするには、キーワード「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 の場合、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」は無視されます。このフラグの値に関係なく、MODULE.bazel がルート モジュールでない場合、これらの dev 依存関係は常に無視されます。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: "off"-
ロックファイルを使用するかどうかを指定します。有効な値は、lockfile を使用して更新する場合は「update」、変更がある場合は「lock」、最新ではない場合はエラーをスローし、lockfile からの読み取りと書き込みを行わない場合は「off」です。
タグ:loading_and_analysis
- 複数の
--override_module=<an equals-separated mapping of module name to path>
が累計されます - <module name>=<path> の形式のローカルパスでモジュールをオーバーライドします。指定されたパスが絶対パスである場合、そのパスが使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリへの相対パスになります。パスが %workspace% で始まる場合は、ワークスペースのルート(「bazel info workspace」の出力)への相対パスになります。
- 複数の
--registry=<a string>
が累計されます -
Bazel モジュールの依存関係を見つけるために使用するレジストリを指定します。順序は重要です。つまり、最初に古いレジストリでモジュールが検索され、以前のレジストリに欠落している場合にのみ、後続のレジストリにフォールバックします。
タグ:changes_inputs
--experimental_gc_thrashing_limits=<comma separated pairs of <period>:<count>>
のデフォルト: "-
到達した場合、GcThrashingDetector が OOM で Bazel をクラッシュさせる制限。それぞれの上限は <period>:<count> と指定します。period は期間、count は正の整数です。<period> 内に <count> 個の連続した GC が続くと、在室スペース(古い世代のヒープ)の --experimental_oom_more_eagerly_threshold パーセントを超えると、OOM がトリガーされます。複数の上限をカンマ区切りで指定できます。
タグ:host_machine_resource_optimizations
--[no]gc_thrashing_limits_retained_heap_limiter_mutually_exclusive
のデフォルト: "true"-
true の場合、空でない --experimental_gc_thrashing_limits を指定すると、RetainedHeapLimiter が非アクティブになり、GcThrashingDetector と相互に排他的になります。false に設定すると、同じコマンドで両方ともアクティブになります。
タグ: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 で設定されたしきい値を超えたことを検出した場合、呼び出しごとに最大回数の不完全な一時的な 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 状態を削除します。これを微調整することで、(i)GC スラッシングが(i)この一時的な状態のメモリ使用に起因し、(ii)必要になったときに状態を再構築するよりもコストが高くなる場合に、GC スラッシングのウォールタイムの影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
--[no]experimental_command_profile
: 「false」- Java Flight Recorder の CPU プロファイルを出力ベース ディレクトリの profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプまたは出力形式をサポートするように将来変更される場合があります。自己責任で使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
: 「false」- デフォルトでは、アクション タイプの数は、実行されているアクションの数が最も多い 20 ニーモニックに制限されます。このオプションを設定すると、すべての覚え書きの統計情報が書き込まれます。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: "-
空白でない場合は、WORKSPACE ファイルではなく指定された解決済みファイルを読み込みます。
タグ:changes_inputs
--experimental_downloader_config=<a string>
: 説明を表示- リモート ダウンローダを構成するファイルを指定します。このファイルは、各行がディレクティブ(allow、block、rewrite)で始まり、その後にホスト名(allow と block)または 2 つのパターン(一致するもの、代替 URL として使用するもの)が続きます。$1 で始まるバック参照、つまり、複数の URL の REC ディレクティブによって試行できます。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: "off"- リポジトリの取得に使用するスレッドモード。「off」に設定した場合、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、プラットフォーム スレッド(OS スレッドなど)を「platform」に設定するか、仮想スレッドを「virtual」に設定します。
- 複数の
--override_repository=<an equals-separated mapping of repository name to path>
が累計されます - リポジトリを <リポジトリ名>=<パス> の形式でローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスが使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリへの相対パスになります。指定したパスが %workspace% で始まる場合は、ワークスペースのルート(`bazel info workspace`の出力)に対する相対パスになります。
- 複数の
--distdir=<a path>
が累計されます -
ネットワークにアクセスする前にアーカイブを検索できる追加の場所です。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
: 「false」-
設定すると、キャッシュ ヒットが発生した場合に、リポジトリ キャッシュはコピーではなくファイルをハードリンクします。これはディスク容量を節約することを目的としています。
タグ:bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id
: 「false」-
true の場合、指定されていない場合は、リポジトリのダウンロードの URL から派生した文字列を canonical_id として使用します。これにより、キャッシュにハッシュが同じであっても、URL が変更されると再ダウンロードが発生します。これを使用して、URL の変更によって破損したリポジトリがキャッシュによってマスクされないことを確認できます。
タグ:loading_and_analysis
、experimental
--experimental_repository_downloader_retries=<an integer>
のデフォルト: "0"-
ダウンロード エラーを再試行する最大回数。0 に設定すると、再試行は無効になります。
タグ:experimental
--experimental_scale_timeouts=<a double>
のデフォルト: "1.0"-
この要因により、Starlark リポジトリ ルールのすべてのタイムアウトをスケーリングします。このように、ソースコードを変更しなくても、ルールの作成者が想定したよりも遅いマシンで外部リポジトリを作成できます。
タグ:bazel_internal_configuration
、experimental
--http_connector_attempts=<an integer>
: 「8」-
HTTP ダウンロードの最大試行回数。
タグ:bazel_internal_configuration
--http_connector_retry_max_timeout=<An immutable length of time.>
のデフォルト: "0s"-
HTTP ダウンロードの再試行の最大タイムアウト。値を 0 にすると、タイムアウトは定義されません。
タグ:bazel_internal_configuration
--http_timeout_scaling=<a double>
のデフォルト: "1.0"-
特定の要因による HTTP ダウンロードに関連するすべてのタイムアウトをスケーリングします。
タグ:bazel_internal_configuration
--repository_cache=<a path>
: 説明を表示-
外部リポジトリの取得時に取得した、ダウンロードした値のキャッシュの場所を指定します。引数に空の文字列がある場合は、キャッシュの無効化をリクエストします。そうでなければ、デフォルトの「<output_user_root>/cache/repos/v1」が使用されます。
タグ:bazel_internal_configuration
--[no]repository_disable_download
: 「false」-
設定した場合、ctx.download{,_and_extract} を使用したダウンロードはリポジトリの取得時に許可されません。なお、ネットワーク アクセスが完全に無効というわけではなく、ctx.execute はインターネットにアクセスする任意の実行可能ファイルを実行します。
タグ:bazel_internal_configuration
--experimental_oom_more_eagerly_threshold=<an integer in 0-100 range>
: 「100」-
このフラグが 100 より小さい値に設定されている場合、2 つの完全な GC の後も(この古い世代の)ヒープの占有率がこの割合を超えると、Bazel は OOM を行います。タグ:
host_machine_resource_optimizations
--experimental_repository_hash_file=<a string>
のデフォルト: "-
空でない場合、リポジトリ ディレクトリのハッシュを検証する必要がある値を含むファイルを指定します。
タグ:affects_outputs
、experimental
- 複数の
--experimental_verify_repository_rules=<a string>
が累計されます -
出力ディレクトリのハッシュを検証する必要があるリポジトリ ルールのリストの場合、ファイルは --experimental_repository_hash_file で指定します。
タグ:affects_outputs
、experimental
--[no]experimental_allow_top_level_aspects_parameters
のデフォルト: "true"-
No-op
タグ:no_op
、deprecated
、experimental
--aspect_deps=<off, conservative or precise>
デフォルト: 「慎重」-
出力形式が {xml,proto,record} の場合にアスペクトの依存関係を解決する方法。「off」は、アスペクトの依存関係が解決されないことを意味します。「aservative」(デフォルト)は、直接的な依存関係のルールクラスが与えられているかどうかに関係なく、宣言されたすべてのアスペクトの依存関係が追加されることを意味します。「recise」は、直接的な依存関係のルールクラスに対してアクティブである可能性があるそれらのアスペクトのみが追加されることを意味します。正確なモードでは、1 つのターゲットを評価するには他のパッケージを読み込む必要があるため、他のモードよりも遅くなります。また、正確なモードでなくても、完全に正確というわけではありません。アスペクトを計算するかどうかは、分析フェーズで決まります。分析フェーズは、「bazel query」の実行時には実行されません。
タグ:build_file_semantics
--[no]graph:factored
のデフォルト: "true"-
true の場合、グラフは「因数分解」されます。つまり、トポロジ的に同等のノードは結合され、そのラベルが連結されます。このオプションは、--output=graph にのみ適用されます。
タグ:terminal_output
--graph:node_limit=<an integer>
のデフォルト: "512"-
出力内のグラフノードのラベル文字列の最大長。長いラベルは切り捨てられます。-1 を指定すると、切り捨てられません。このオプションは、--output=graph にのみ適用されます。
タグ:terminal_output
--[no]implicit_deps
のデフォルト: "true"-
有効にすると、クエリが動作する依存関係グラフに暗黙的な依存関係が含まれます。暗黙的な依存関係とは、BUILD ファイルで明示的に指定されておらず、bazel によって追加されている依存関係です。cquery の場合、このオプションは解決済みのツールチェーンのフィルタリングを制御します。
タグ:build_file_semantics
--[no]include_aspects
のデフォルト: "true"- aquery, cquery: アスペクトで生成されたアクションを出力に含めるかどうか。query: no-op(アスペクトは必ず従います)。
タグ:terminal_output
--[no]incompatible_display_source_file_location
のデフォルト: "true"-
デフォルトでは true であり、ソースファイルのターゲットが表示されます。true の場合、場所の出力にソースファイルの 1 行目の場所を表示します。このフラグは移行の目的でのみ存在します。
タグ:terminal_output
、incompatible_change
--[no]incompatible_package_group_includes_double_slash
のデフォルト: "true"-
有効にすると、package_group の 'packages' 属性の出力時に、先頭の `//` が省略されません。
タグ:terminal_output
、incompatible_change
--[no]infer_universe_scope
: 「false」-
設定されていて --universe_scope が設定されていない場合、クエリ式の一意のターゲット パターンのリストとして --universe_scope の値が推定されます。ユニバース スコープ関数(allrdeps など)を使用するクエリ式に対して推測された --universe_scope 値は、望ましくない場合があります。そのため、このオプションは使用する処理がわかっている場合にのみ使用してください。詳細と例については、https://bazel.build/reference/query#sky-query をご覧ください。--universe_scope が設定されている場合、このオプションの値は無視されます。注: このオプションは「query」にのみ適用されます(つまり「cquery」には適用されません)。
タグ:loading_and_analysis
--[no]line_terminator_null
: 「false」- 各形式が改行ではなく \0 で終結しているかどうか。
タグ:terminal_output
--[no]nodep_deps
のデフォルト: "true"-
有効にすると、「nodep」属性の依存関係は、クエリが動作する依存関係グラフに含まれます。「nodep」属性の一般的な例は「visibility」です。「info build-language」の出力を実行して解析し、ビルド言語のすべての「nodep」属性を確認します。
タグ:build_file_semantics
--output=<a string>
のデフォルト: "label"-
クエリの結果を出力する形式。cquery に使用できる値は、label、label_kind、textproto、transitions、proto、jsonproto です。「transitions」を選択した場合は、--transitions=(lite|full) オプションも指定する必要があります。
タグ:terminal_output
--[no]proto:default_values
のデフォルト: "true"-
true の場合、値が BUILD ファイルで明示的に指定されていない属性は無視されます。このオプションは、--output=proto に適用できます。
タグ:terminal_output
--[no]proto:definition_stack
: 「false」-
define_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>
: 「すべて」-
出力に含める属性のカンマ区切りのリスト。デフォルトはすべての属性です。属性を出力しない場合は、空の文字列に設定します。このオプションは --output=proto に適用できます。
タグ:terminal_output
--[no]proto:rule_inputs_and_outputs
のデフォルト: "true"-
rule_input フィールドと rule_output フィールドに値を設定するかどうかを指定します。
タグ:terminal_output
--query_file=<a string>
のデフォルト: "-
設定すると、クエリはコマンドラインではなくここで指定したファイルから読み込まれます。ここでは、ファイルとコマンドライン クエリを指定するとエラーが発生します。
タグ:changes_inputs
--[no]relative_locations
: 「false」-
true の場合、xml と proto の出力に含まれる BUILD ファイルの場所は相対パスになります。デフォルトでは、ロケーション出力は絶対パスで、マシン間で一貫していません。このオプションを true に設定すると、マシン間で一貫した結果を得ることができます。
タグ:terminal_output
--show_config_fragments=<off, direct or transitive>
のデフォルト: "off"-
ルールに必要な構成フラグメントと、その推移的な依存関係を示します。これは、構成したターゲット グラフをどの程度トリミングできるかを評価する際に役立ちます。
タグ:affects_outputs
--starlark:expr=<a string>
のデフォルト: "-
cquery の --output=starlark モードで構成された各ターゲットをフォーマットする Starlark 式。構成されたターゲットは「target」にバインドされます。--starlark:setIamPolicy と --starlark:file のどちらも指定されていない場合、このオプションはデフォルトで 'str(target.label)' になります。--starlark:setIamPolicy と --starlark:file の両方を指定するとエラーが発生します。
タグ:terminal_output
--starlark:file=<a string>
のデフォルト: "-
1 つの引数に「format」という Starlark 関数を定義するファイルの名前。構成された各ターゲットに適用され、文字列としてフォーマットされます。--starlark:setIamPolicy と --starlark:file の両方を指定するとエラーが発生します。詳細については、--output=starlark のヘルプをご覧ください。
タグ:terminal_output
--[no]tool_deps
のデフォルト: "true"-
クエリ: 無効の場合、「exec 構成」への依存関係はクエリが動作する依存関係グラフには含まれません。「exec 構成」の依存関係のエッジ(プロトコル コンパイラの「proto_library」ルールなど)は、通常、同じ「ターゲット」プログラムの一部ではなく、ビルド中に実行されるツールを参照します。
Cquery: 無効に設定した場合、この構成ターゲットを検出した最上位ターゲットから、実行遷移を超えるすべての構成ターゲットが除外されます。つまり、トップレベルのターゲットがターゲット構成にある場合、ターゲット構成でも構成済みのターゲットのみが返されます。トップレベル ターゲットが exec 構成に含まれている場合は、exec 構成ターゲットのみが返されます。このオプションでは、解決済みのツールチェーンは除外されません。
タグ:build_file_semantics
--transitions=<full, lite or none>
のデフォルト: "none"-
cquery が遷移情報を出力する形式。
タグ:affects_outputs
--universe_scope=<comma-separated list of options>
のデフォルト: "-
対象のパターン(追加と減算)のカンマ区切りのセット。クエリは、指定したターゲットの推移的な閉鎖によって定義されるユニバースで実行できます。このオプションは、クエリコマンドと cquery コマンドで使用されます。cquery の場合、このオプションへの入力はすべての回答の基となるターゲットであるため、このオプションは構成と遷移に影響を与える可能性があります。このオプションが指定されていない場合、トップレベル ターゲットはクエリ式から解析されたターゲットとみなされます。注: cquery でこのオプションを指定しないと、クエリ式から解析されたターゲットがトップレベル オプションでビルドできない場合、ビルドが破損する可能性があります。
タグ:loading_and_analysis
- 複数の
--allow_yanked_versions=<a string>
が累計されます -
モジュール バージョンは、発生元であるレジストリで(NonRegistryOverride のもの以外から)yanked が宣言されている場合でも、解決された依存関係グラフで許可する「<module1>@<version1>,<module2>@<version2>」の形式で指定します。そうしないと、ジャンクされたバージョンが原因で解決に失敗します。「BZLMOD_ALLOW_YANKED_VERSIONS」環境変数を使用して、許可される yanked バージョンを定義することもできます。このチェックを無効にするには、キーワード「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 の場合、ルート モジュールの MODULE.bazel で「dev_dependency」として宣言されている「bazel_dep」と「use_extension」は無視されます。このフラグの値に関係なく、MODULE.bazel がルート モジュールでない場合、これらの dev 依存関係は常に無視されます。
タグ:loading_and_analysis
--lockfile_mode=<off, update or error>
のデフォルト: "off"-
ロックファイルを使用するかどうかを指定します。有効な値は、lockfile を使用して更新する場合は「update」、変更がある場合は「lock」、最新ではない場合はエラーをスローし、lockfile からの読み取りと書き込みを行わない場合は「off」です。
タグ:loading_and_analysis
- 複数の
--override_module=<an equals-separated mapping of module name to path>
が累計されます - <module name>=<path> の形式のローカルパスでモジュールをオーバーライドします。指定されたパスが絶対パスである場合、そのパスが使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリへの相対パスになります。パスが %workspace% で始まる場合は、ワークスペースのルート(「bazel info workspace」の出力)への相対パスになります。
- 複数の
--registry=<a string>
が累計されます -
Bazel モジュールの依存関係を見つけるために使用するレジストリを指定します。順序は重要です。つまり、最初に古いレジストリでモジュールが検索され、以前のレジストリに欠落している場合にのみ、後続のレジストリにフォールバックします。
タグ:changes_inputs
--experimental_gc_thrashing_limits=<comma separated pairs of <period>:<count>>
のデフォルト: "-
到達した場合、GcThrashingDetector が OOM で Bazel をクラッシュさせる制限。それぞれの上限は <period>:<count> と指定します。period は期間、count は正の整数です。<period> 内に <count> 個の連続した GC が続くと、在室スペース(古い世代のヒープ)の --experimental_oom_more_eagerly_threshold パーセントを超えると、OOM がトリガーされます。複数の上限をカンマ区切りで指定できます。
タグ:host_machine_resource_optimizations
--[no]gc_thrashing_limits_retained_heap_limiter_mutually_exclusive
のデフォルト: "true"-
true の場合、空でない --experimental_gc_thrashing_limits を指定すると、RetainedHeapLimiter が非アクティブになり、GcThrashingDetector と相互に排他的になります。false に設定すると、同じコマンドで両方ともアクティブになります。
タグ: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 で設定されたしきい値を超えたことを検出した場合、呼び出しごとに最大回数の不完全な一時的な 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 状態を削除します。これを微調整することで、(i)GC スラッシングが(i)この一時的な状態のメモリ使用に起因し、(ii)必要になったときに状態を再構築するよりもコストが高くなる場合に、GC スラッシングのウォールタイムの影響を軽減できる可能性があります。
タグ:host_machine_resource_optimizations
--[no]experimental_command_profile
: 「false」- Java Flight Recorder の CPU プロファイルを出力ベース ディレクトリの profile.jfr ファイルに記録します。このフラグの構文とセマンティクスは、異なるプロファイル タイプまたは出力形式をサポートするように将来変更される場合があります。自己責任で使用してください。
--[no]experimental_record_metrics_for_all_mnemonics
: 「false」- デフォルトでは、アクション タイプの数は、実行されているアクションの数が最も多い 20 ニーモニックに制限されます。このオプションを設定すると、すべての覚え書きの統計情報が書き込まれます。
--experimental_resolved_file_instead_of_workspace=<a string>
のデフォルト: "-
空白でない場合は、WORKSPACE ファイルではなく指定された解決済みファイルを読み込みます。
タグ:changes_inputs
--experimental_downloader_config=<a string>
: 説明を表示- リモート ダウンローダを構成するファイルを指定します。このファイルは、各行がディレクティブ(allow、block、rewrite)で始まり、その後にホスト名(allow と block)または 2 つのパターン(一致するもの、代替 URL として使用するもの)が続きます。$1 で始まるバック参照、つまり、複数の URL の REC ディレクティブによって試行できます。
--experimental_worker_for_repo_fetching=<off, platform or virtual>
のデフォルト: "off"- リポジトリの取得に使用するスレッドモード。「off」に設定した場合、ワーカー スレッドは使用されず、リポジトリの取得が再起動の対象となります。それ以外の場合、プラットフォーム スレッド(OS スレッドなど)を「platform」に設定するか、仮想スレッドを「virtual」に設定します。
- 複数の
--override_repository=<an equals-separated mapping of repository name to path>
が累計されます - リポジトリを <リポジトリ名>=<パス> の形式でローカルパスでオーバーライドします。指定されたパスが絶対パスの場合は、そのパスが使用されます。指定されたパスが相対パスの場合は、現在の作業ディレクトリへの相対パスになります。パスが %workspace% で始まる場合は、ワークスペースのルート(bazel info workspace)の出力に対する相対パスになります。
--[no]experimental_inprocess_symlink_creation
: 「false」- シンボリック ツリーを作成するためにファイル システムを直接呼び出すかどうか。
タグ:loading_and_analysis
、execution
、experimental
--[no]experimental_remotable_source_manifests
: 「false」-
ソース マニフェストのアクションをリモート可能にするかどうか
タグ:loading_and_analysis
、execution
、experimental
--[no]experimental_split_coverage_postprocessing
: 「false」-
true の場合、Bazel は新しいスポーンでテストのためにカバレッジ後処理を実行します。
タグ:execution
--[no]experimental_strict_fileset_output
: 「false」-
このオプションを有効にすると、ファイルセットはすべての出力アーティファクトを通常のファイルとして扱います。ディレクトリを走査したり、シンボリック リンクに敏感だったりすることはありません。
タグ:execution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
のデフォルト: "-
アクションの覚え方に基づいて、アクションの実行情報に対してキーを追加または削除します。実行情報をサポートするアクションにのみ適用されます。一般的なアクションの多くには、実行情報がサポートされています(Genrule、CppCompile、Javac、StarlarkAction、TestRunner など)。複数の正規表現を指定する場合は、同じ正規表現に多くの正規表現が適用される可能性があるため、順序が重要です。構文: "regex=[+-]key,regex=[+-]key,..."例:
.*=+x,.*=-y,.*=+z「Genrule=+requires-x」は、すべての Genrule アクションの実行情報に「requires-x」を追加します。
'??Genrule).*=-requires-x' により、すべての Genrule 以外のアクションの実行情報から「requires-x」が削除されます。
タグ:execution
、affects_outputs
、loading_and_analysis
--persistent_android_dex_desugar
-
ワーカーを使用して永続的な Android dex と desugar のアクションを有効にします。
以下に展開:
--internal_persistent_android_dex_desugar
--strategy=Desugar=worker
--strategy=DexBuilder=worker
タグ:host_machine_resource_optimizations
、execution
--persistent_android_resource_processor
- ワーカーを使用して、永続的な Android リソース プロセッサを有効にします。
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--internal_persistent_busybox_tools
2{1/1}--strategy=Aapt2Optimize=worker
1{1/1}--strategy=AARGenerator=worker
host_machine_resource_optimizations
execution
--persistent_multiplex_android_dex_desugar
- ワーカーを使用して、永続的な多重化 Android dex と desugar アクションを有効にします。
以下に展開:
--persistent_android_dex_desugar
--internal_persistent_multiplex_android_dex_desugar
タグ:host_machine_resource_optimizations
、execution
--persistent_multiplex_android_resource_processor
-
ワーカーを使用して、永続的な多重化 Android リソース プロセッサを有効にします。
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--persistent_android_resource_processor
2{1/1}--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
1{1/1}--modify_execution_info=AARGenerator=+supports-multiplex-workers
host_machine_resource_optimizations
execution
--persistent_multiplex_android_tools
- 永続的で多重化した Android ツール(dex 変換、脱糖、リソース処理)を有効にします。
以下に展開:
--internal_persistent_multiplex_busybox_tools
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
タグ:host_machine_resource_optimizations
、execution
--[no]use_target_platform_for_tests
: 「false」-
true の場合、Bazel はテスト実行グループではなく、ターゲット プラットフォームを使用してテストを実行します。
タグ:execution
--android_compiler=<a string>
: 説明を表示-
Android ターゲット コンパイラ。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--android_crosstool_top=<a build target label>
のデフォルト: "//external:android/crosstool"-
Android ビルドに使用される C++ コンパイラの場所。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
、loses_incremental_state
--android_grte_top=<a label>
: 説明を表示-
Android ターゲット grte_top。
タグ:changes_inputs
、loading_and_analysis
、loses_incremental_state
--android_manifest_merger=<legacy, android or force_android>
のデフォルト: "android"-
android_binary ルールに使用するマニフェスト マージツールを選択します。レガシーのマージツールから Android マニフェストのマージツールへの移行に役立つフラグ。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--android_platforms=<a build target label>
のデフォルト: "-
android_binary ターゲットが使用するプラットフォームを設定します。複数のプラットフォームが指定されている場合、バイナリはファット APK であり、指定された各ターゲット プラットフォームのネイティブ バイナリが含まれています。
タグ:changes_inputs
、loading_and_analysis
、loses_incremental_state
--android_sdk=<a build target label>
のデフォルト: "@bazel_tools//tools/android:sdk"- Android アプリのビルドに使用する Android SDK/プラットフォームを指定します。
タグ:changes_inputs
、loading_and_analysis
、loses_incremental_state
--apple_compiler=<a string>
: 説明を表示-
Apple ターゲット コンパイラ。ツールチェーンのバリアント(xcode-beta など)を選択する場合に役立ちます。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--apple_crosstool_top=<a build target label>
のデフォルト: "@bazel_tools//tools/cpp:ツールチェーン"-
Apple ルールと Objc ルール、およびその依存関係で使用される crosstool パッケージのラベル。
タグ:loses_incremental_state
、changes_inputs
--apple_grte_top=<a build target label>
: 説明を表示-
Apple ターゲット grte_top。
タグ:changes_inputs
、loading_and_analysis
、loses_incremental_state
--cc_output_directory_tag=<a string>
のデフォルト: "- 構成ディレクトリに追加するサフィックスを指定します。
タグ:affects_outputs
、explicit_in_output_path
--compiler=<a string>
: 説明を表示-
ターゲットのコンパイルに使用する C++ コンパイラ。
タグ:loading_and_analysis
、execution
--coverage_output_generator=<a build target label>
のデフォルト: "@bazel_tools//tools/test:lcov_merger"- 未加工のカバレッジ レポートの後処理に使用されるバイナリの場所。現在は、単一のファイル(バイナリ)を含むファイル グループである必要があります。デフォルトは「//tools/test:lcov_merger」です。
タグ:changes_inputs
、affects_outputs
、loading_and_analysis
--coverage_report_generator=<a build target label>
のデフォルト: "@bazel_tools//tools/test:coverage_report_generator"-
カバレッジ レポートの生成に使用されるバイナリの場所。現在は、単一のファイル(バイナリ)を含むファイル グループである必要があります。デフォルトは「//tools/test:coverage_report_generator」です。
タグ:changes_inputs
、affects_outputs
、loading_and_analysis
--coverage_support=<a build target label>
のデフォルト: "@bazel_tools//tools/test:coverage_support"-
コード カバレッジを収集するすべてのテスト アクションの入力に必要なサポート ファイルの場所。デフォルトは「//tools/test:coverage_support」です。
タグ:changes_inputs
、affects_outputs
、loading_and_analysis
--crosstool_top=<a build target label>
のデフォルト: "@bazel_tools//tools/cpp:ツールチェーン"-
C++ コードのコンパイルに使用する crosstool パッケージのラベル。
タグ:loading_and_analysis
、changes_inputs
、affects_outputs
--custom_malloc=<a build target label>
: 説明を表示-
malloc のカスタム実装を指定します。この設定により、ビルドルールの malloc 属性がオーバーライドされます。
タグ:changes_inputs
、affects_outputs
- 複数の
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
が累計されます -
カンマ区切りの正規表現のリスト。先頭に -(負の式)を付加し、制約値のターゲットのカンマ区切りのリストに代入します。ターゲットが負の式に一致せず、少なくとも 1 つの正の式に一致する場合、ツールチェーンの解決は、制約の値を実行の制約として宣言した場合と同様に実行されます。例: //demo,-test=@platforms//cpus:x86_64 は、名前に 'test' が含まれているものを除き、//demo の下にあるすべてのターゲットに 'x86_64' を追加します。
タグ:loading_and_analysis
--[no]experimental_enable_objc_cc_deps
のデフォルト: "true"-
ob_c_* ルールを cc_library に依存させ、--ios_multi_cpu の値に対して --cpu を "ios_<--ios_cpu" に設定してすべての objc 依存関係をビルドできます。
タグ:loading_and_analysis
、incompatible_change
--[no]experimental_include_xcode_execution_requirements
: 「false」-
設定した場合、Xcode のすべてのアクションに「requires-xcode:{version}」の実行要件を追加します。xcode バージョンにハイフンが使用されている場合は、requires-xcode-label:{version_label} の実行要件も追加します。
タグ:loses_incremental_state
、loading_and_analysis
、execution
--[no]experimental_prefer_mutual_xcode
のデフォルト: "true"-
true の場合、ローカルとリモートの両方で利用可能な最新の Xcode を使用します。false であるか、相互利用可能なバージョンがない場合は、xcode-select を介して選択されたローカル Xcode バージョンを使用します。
タグ:loses_incremental_state
--extra_execution_platforms=<comma-separated list of options>
のデフォルト: "-
アクションの実行プラットフォームとして使用可能なプラットフォーム。プラットフォームは、正確なターゲットによって、またはターゲット パターンとして指定できます。これらのプラットフォームは、register_execution_platforms() によって WORKSPACE ファイルで宣言されたものよりも先に考慮されます。このオプションは 1 回だけ設定できます。後のインスタンスは以前のフラグ設定をオーバーライドします。
タグ:execution
- 複数の
--extra_toolchains=<comma-separated list of options>
が累計されます -
ツールチェーンの解決で考慮されるツールチェーン ルール。ツールチェーンは、正確なターゲットまたはターゲット パターンとして指定できます。これらのツールチェーンは、register_artifacts() によって WORKSPACE ファイルで宣言される前に適用されます。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
--grte_top=<a label>
: 説明を表示-
チェックインされた libc ライブラリに対するラベル。デフォルト値は crosstool ツールチェーンによって選択されるため、オーバーライドする必要はありません。
タグ:action_command_lines
、affects_outputs
--host_compiler=<a string>
: 説明を表示-
ホスト コンパイルに使用する C++ コンパイラ。--host_crosstool_top が設定されていない場合は無視されます。
タグ:loading_and_analysis
、execution
--host_crosstool_top=<a build target label>
: 説明を表示-
デフォルトでは、exec 構成に --crosstool_top オプションと --compiler オプションも使用されます。このフラグを指定すると、Bazel は指定された crosstool_top にデフォルトの libc とコンパイラを使用します。
タグ:loading_and_analysis
、changes_inputs
、affects_outputs
--host_grte_top=<a label>
: 説明を表示-
指定すると、exec 構成用の libc 最上位ディレクトリ(--grte_top)がオーバーライドされます。
タグ:action_command_lines
、affects_outputs
--host_platform=<a build target label>
のデフォルト: "@local_config_platform//:host"-
ホストシステムを説明するプラットフォーム ルールのラベル。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set
のデフォルト: "true"-
true の場合、Bazel は flag_sets に expand_if_all_available を指定します(移行手順については https://github.com/bazelbuild/bazel/issues/7008 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
のデフォルト: "true"-
true の場合、Bazel は c++ ツールチェーンで「host」機能と「nonhost」機能を有効にしません(詳細については https://github.com/bazelbuild/bazel/issues/7407 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
: 「false」-
ツールチェーンの解決を使用して Android SDK for Android ルールを選択する(Starlark とネイティブ)
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
: 「false」-
ツールチェーンの解決を使用して、Apple SDK 用の Apple SDK(Starlark とネイティブ)を選択します。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
のデフォルト: "true"-
true の場合、Bazel は lto インデックス登録コマンドラインで C++ リンク アクション コマンドラインを再利用しません(詳細については https://github.com/bazelbuild/bazel/issues/6791 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_objc_linking_info_migration
のデフォルト: "true"-
true の場合、ObjC 組み込みルールは、ObjcProvider ではなく CcInfo からリンク情報を取得します。詳細と移行情報については、https://github.com/bazelbuild/bazel/issues/16939 をご覧ください。
タグ:loading_and_analysis
、changes_inputs
、incompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
のデフォルト: "true"-
true の場合、cc_ツールチェーン.cpu 属性と cc_ツールチェーン.compiler 属性が設定されている場合、Bazel はエラーになります(移行手順については https://github.com/bazelbuild/bazel/issues/7075 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_remove_legacy_whole_archive
のデフォルト: "true"-
true の場合、Bazel はデフォルトではライブラリの依存関係全体をアーカイブにリンクしません(移行手順については https://github.com/bazelbuild/bazel/issues/7362 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_require_ctx_in_configure_features
のデフォルト: "true"-
true の場合、Bazel では cc_common.configure_features に 'ctx' パラメータを指定する必要があります(詳細については https://github.com/bazelbuild/bazel/issues/7793 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
-
ツールチェーンでサポートされている場合は、インターフェース共有オブジェクトを使用します。現在は、すべての ELF ツールチェーンでこの設定がサポートされています。
タグ:loading_and_analysis
、affects_outputs
、affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
iOS アプリのビルドに使用する iOS SDK のバージョンを指定します。指定しない場合は、「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_analysis
、affects_outputs
--platform_mappings=<a relative path>
のデフォルト: "-
プラットフォーム ファイルが未設定の場合に使用するプラットフォーム、またはプラットフォームがすでに存在するときに設定するフラグを記述するマッピング ファイルの場所。メインのワークスペースのルートからの相対パスを指定する必要があります。デフォルトは「platform_mappings」です(ワークスペース ルートの直下にあるファイル)。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
--platforms=<a build target label>
のデフォルト: "-
現在のコマンドのターゲット プラットフォームを示すプラットフォーム ルールのラベル。
タグ:affects_outputs
、changes_inputs
、loading_and_analysis
--python2_path=<a string>
: 説明を表示-
非推奨。no-op。「--compatible_use_python_ツールチェーン」により無効になっています。
タグ:no_op
、deprecated
--python3_path=<a string>
: 説明を表示-
非推奨。no-op。「--compatible_use_python_ツールチェーン」により無効になっています。
タグ:no_op
、deprecated
--python_path=<a string>
: 説明を表示-
ターゲット プラットフォームで Python ターゲットを実行するために呼び出される Python インタープリタの絶対パス。非推奨。--compatible_use_python_ツールチェーン s により無効にされました。
タグ:loading_and_analysis
、affects_outputs
--python_top=<a build target label>
: 説明を表示-
ターゲット プラットフォームで Python ターゲットを実行するために呼び出された Python インタープリタを表す py_runtime のラベル。非推奨。--compatible_use_python_ツールチェーン s により無効にされました。
タグ:loading_and_analysis
、affects_outputs
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
tvOS アプリのビルドに使用する tvOS SDK のバージョンを指定します。指定しない場合は、「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_state
、loading_and_analysis
--[no]apple_enable_auto_dsym_dbg
: 「false」-
dbg ビルドのデバッグ シンボル(.dSYM)ファイルの生成を強制的に有効にするかどうかを指定します。
タグ:affects_outputs
、action_command_lines
--[no]apple_generate_dsym
: 「false」- デバッグ シンボル(.dSYM)ファイルを生成するかどうか。
タグ:affects_outputs
、action_command_lines
--[no]build_runfile_links
のデフォルト: "true"-
true の場合、すべてのターゲットのランファイル シンボリック フォレストがビルドされます。false の場合、可能であればマニフェストのみを書き込みます。
タグ:affects_outputs
--[no]build_runfile_manifests
のデフォルト: "true"-
true の場合、すべてのターゲットの runfiles マニフェストを書き込みます。false の場合は省略します。false の場合、ローカルテストの実行は失敗します。
タグ:affects_outputs
--[no]build_test_dwp
: 「false」-
有効にすると、C++ テストを静的にビルドし、分割すると、テストバイナリの .dwp ファイルも自動的にビルドされます。
タグ:loading_and_analysis
、affects_outputs
--cc_proto_library_header_suffixes=<comma-separated set of options>
のデフォルト: ".pb.h"-
cc_proto_library が作成するヘッダー ファイルの接頭辞を設定します。
タグ:affects_outputs
、loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated set of options>
: 「.pb.cc」-
cc_proto_library が作成するソースファイルの接頭辞を設定します。
タグ:affects_outputs
、loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info
: 「false」- proto_library で、代替 Java API バージョンの追加アクションを実行します。
タグ:affects_outputs
、loading_and_analysis
、experimental
--[no]experimental_proto_extra_actions
: 「false」- proto_library で、代替 Java API バージョンの追加アクションを実行します。
タグ:affects_outputs
、loading_and_analysis
、experimental
--[no]experimental_save_feature_state
: 「false」-
コンパイル済みの状態とリクエストされた機能をコンパイルの出力として保存します。
タグ:affects_outputs
、experimental
--fission=<a set of compilation modes>
のデフォルト: "no"-
C++ のコンパイルとリンクに分割を使用するコンパイル モードを指定します。'fastbuild'、'dbg'、'opt'}、またはすべてのモードを有効にする場合は「yes」、すべてのモードを無効にする場合は「no」の任意の組み合わせを指定できます。
タグ:loading_and_analysis
、action_command_lines
、affects_outputs
--[no]incompatible_always_include_files_in_data
のデフォルト: "true"-
true の場合、ネイティブ ルールはデータ依存関係の <code>DefaultInfo.files</code> を Runfile に追加します。これは Starlark ルールの推奨動作(https://bazel.build/extending/rules#runfiles_features_to_avoid)と一致します。
タグ:affects_outputs
、incompatible_change
--[no]legacy_external_runfiles
のデフォルト: "true"-
true の場合、.runfiles/repo に加えて、.runfiles/wsname/external/repo の下にある外部リポジトリ用の runfiles symlink フォレストを作成します。
タグ: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>
が累計されます -
ターゲット構成のアクションで使用可能な環境変数のセットを指定します。変数は、名前で指定できます。名前の場合、値は呼び出し環境から取得されるか、name=value ペアによって呼び出し環境とは別に値が設定されます。このオプションは複数回使用できます。同じ変数に指定されたオプションの場合、最新の変数が優先され、異なる変数のオプションが累積されます。
タグ:action_command_lines
--android_cpu=<a string>
のデフォルト: "armeabi-v7a"-
Android ターゲット CPU。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--[no]android_databinding_use_androidx
: 「false」-
AndroidX 互換のデータ バインディング ファイルを生成します。これは、databinding v2 でのみ使用されます。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--[no]android_databinding_use_v3_4_args
: 「false」-
3.4.0 引数で android databinding v2 を使用する
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--android_dynamic_mode=<off, default or fully>
のデフォルト: "off"-
cc_binary が共有ライブラリを明示的に作成していない場合に、Android ルールの C++ 依存関係を動的にリンクするかどうかを指定します。「default」は、bazel が動的にリンクするかどうかを選択することを意味します。「fully」は、すべてのライブラリが動的にリンクされることを意味します。「オフ」は、すべてのライブラリがほぼ静的モードでリンクされることを意味します。
タグ:affects_outputs
、loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
のデフォルト: "alphabetical"-
Android バイナリのマニフェスト マージツールに渡されるマニフェストの順序を設定します。ALPHABETICAL は、マニフェストが execroot への相対パスで並べ替えられることを意味します。ALPHABETICAL_BY_CONFIGURATION は、出力ディレクトリ内の構成ディレクトリを基準とする相対パスとしてマニフェストが並べ替えられていることを意味します。DEPENDENCY は、各ライブラリのマニフェストがその依存関係のマニフェストよりも前に来る順序で並べられることを意味します。
タグ:action_command_lines
、execution
--[no]android_resource_shrinking
: 「false」- ProGuard を使用する android_binary APK のリソース圧縮を有効にします。
タグ:affects_outputs
、loading_and_analysis
--[no]build_python_zip
: 「自動」-
Python 実行可能 zip をビルドします。Windows の場合、他のプラットフォームは除きます。
タグ:affects_outputs
- 複数の
--catalyst_cpus=<comma-separated list of options>
が累計されます - Apple Catalyst バイナリをビルドするアーキテクチャのカンマ区切りのリスト。
タグ:loses_incremental_state
、loading_and_analysis
--[no]collect_code_coverage
: 「false」-
指定すると、Bazel はコードをインストルメント化し(可能な場合、オフラインのインストルメンテーションを使用)、テスト中にカバレッジ情報を収集します。--instrumentation_filter に一致するターゲットのみが影響を受けます。通常、このオプションは直接指定せず、代わりに「bazelCoverage」コマンドを使用してください。
タグ:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] デフォルト: "fastbuild"-
バイナリが組み込まれるモードを指定します。値: fast'、'dbg'、'opt'。
タグ:affects_outputs
、action_command_lines
、explicit_in_output_path
- 複数の
--conlyopt=<a string>
が累計されます -
C ソースファイルをコンパイルするときに gcc に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
- 複数の
--copt=<a string>
が累計されます -
gcc に渡す追加オプション。
タグ:action_command_lines
、affects_outputs
--cpu=<a string>
のデフォルト: "-
ターゲット CPU。
タグ:changes_inputs
、affects_outputs
、explicit_in_output_path
--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_lines
、affects_outputs
- 複数の
--define=<a 'name=value' assignment>
が累計されます - 各 --define オプションは、ビルド変数の割り当てを指定します。
タグ:changes_inputs
、affects_outputs
--dynamic_mode=<off, default or fully>
デフォルト: "default"-
C++ バイナリを動的にリンクするかどうかを指定します。「default」は、Bazel が動的にリンクするかどうかを選択することを意味します。「fully」は、すべてのライブラリが動的にリンクされることを意味します。「オフ」は、すべてのライブラリがほぼ静的モードでリンクされることを意味します。
タグ:loading_and_analysis
、affects_outputs
--[no]enable_fdo_profile_absolute_path
のデフォルト: "true"-
設定した場合、fdo_absolute_profile_path を使用するとエラーが発生します。
タグ:affects_outputs
--[no]enable_runfiles
: 「自動」-
runfiles シンボリック リンク ツリーを有効にします。デフォルトでは、Windows、その他のプラットフォームでは無効になっています。
タグ:affects_outputs
- 複数の
--experimental_action_listener=<a build target label>
が累計されます -
いくつかの側面を重視して非推奨になりました。action_listener を使用して、エクストラアクションを既存のビルド アクションに接続します。
タグ:execution
、experimental
--[no]experimental_android_compress_java_resources
: 「false」-
APK で Java リソースを圧縮する
タグ:affects_outputs
、loading_and_analysis
、experimental
--[no]experimental_android_databinding_v2
: 「false」-
android databinding v2 を使用する
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--[no]experimental_android_resource_shrinking
: 「false」- ProGuard を使用する android_binary APK のリソース圧縮を有効にします。
タグ:affects_outputs
、loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex
: 「false」-
rex ツールを使用して dex ファイルを書き換えます。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--experimental_objc_fastbuild_options=<comma-separated list of options>
のデフォルト: "-O0,-DDEBUG=1"-
これらの文字列を objc fastbuild コンパイラ オプションとして使用します。
タグ:action_command_lines
--[no]experimental_omitfp
: 「false」-
true の場合、スタックのアンワインドに libunwind を使用し、-fomit-frame-pointer と -fasync-unwind-tables を使用してコンパイルします。
タグ:action_command_lines
、affects_outputs
、experimental
--[no]experimental_platform_in_output_dir
: 「false」-
true の場合、ターゲット プラットフォームは CPU ではなく出力ディレクトリ名で使用されます。
タグ:affects_outputs
、experimental
--[no]experimental_use_llvm_covmap
: 「false」-
指定すると、Bazel は collect_code_coverage を有効にしたときに gcov ではなく llvm-cov カバレッジ マップ情報を生成します。
タグ:changes_inputs
、affects_outputs
、loading_and_analysis
、experimental
--fat_apk_cpu=<comma-separated set of options>
のデフォルト: "armeabi-v7a"-
このオプションを設定すると、太った APK が有効になります。これには、指定したすべてのターゲット アーキテクチャ(--fat_apk_cpu=x86,armeabi-v7a、このフラグを指定すると、android_binary ルールの依存関係で --android_cpu は無視されます。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--[no]fat_apk_hwasan
: 「false」-
HWASAN 分割を作成するかどうかを指定します。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--fdo_instrument=<a string>
: 説明を表示-
FDO インストルメンテーションでバイナリを生成する。Clang/LLVM コンパイラでは、生のプロファイル ファイルが実行時にダンプされるディレクトリ名も受け入れます。
タグ:affects_outputs
--fdo_optimize=<a string>
: 説明を表示-
FDO プロファイル情報を使用してコンパイルを最適化します。.gcda ファイルツリーを含む zip ファイルの名前、自動プロファイルを含む afdo ファイル、または LLVM プロファイル ファイルの名前を指定します。このフラグには、ラベルとして指定されたファイル(例: `//foo/bar:file.afdo` - 対応するパッケージに `exports_files` ディレクティブを追加する)と `fdo_profile` ターゲットを指すラベルを受け付けます。このフラグは fdo_profile ルールに置き換えられます。
タグ:affects_outputs
--fdo_prefetch_hints=<a build target label>
: 説明を表示-
キャッシュ プリフェッチのヒントを使用します。
タグ:affects_outputs
--fdo_profile=<a build target label>
: 説明を表示- 最適化に使用するプロファイルを表す fdo_profile。
タグ:affects_outputs
- 複数の
--features=<a string>
が累計されます -
指定された機能は、ターゲット構成で構築されたターゲットに対してデフォルトで有効または無効にされます。「-feature>」を指定すると、その特徴が無効になります。ネガティブな特徴は常にポジティブな特徴をオーバーライドします。--host_features もご覧ください。
タグ:changes_inputs
、affects_outputs
--[no]force_pic
: 「false」-
有効にすると、すべての C++ コンパイルが位置に依存しないコード(「-fPIC」)を生成し、リンクが非 PIC ライブラリよりも PIC ビルド済みライブラリを優先して、リンクが位置に依存しない実行可能ファイル(「-pie」)を生成するようになります。
タグ:loading_and_analysis
、affects_outputs
- 複数の
--host_action_env=<a 'name=value' assignment with an optional value part>
が累計されます - 実行構成を含むアクションで使用できる環境変数のセットを指定します。変数は、名前で指定できます。名前の場合、値は呼び出し環境から取得されるか、name=value ペアによって呼び出し環境とは別に値が設定されます。このオプションは複数回使用できます。同じ変数に指定されたオプションの場合、最新の変数が優先され、異なる変数のオプションが累積されます。
タグ:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
: 「opt」-
ビルド中に使用するツールが組み込まれるモードを指定します。値: fast'、'dbg'、'opt'。
タグ:affects_outputs
、action_command_lines
- 複数の
--host_conlyopt=<a string>
が累計されます -
実行構成で C(ただし C++ ではない)ソースファイルをコンパイルするときに、C コンパイラに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
- 複数の
--host_copt=<a string>
が累計されます -
exec 構成に組み込まれたツールについて、C コンパイラに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--host_cpu=<a string>
のデフォルト: "- ホスト CPU。
タグ:changes_inputs
、affects_outputs
- 複数の
--host_cxxopt=<a string>
が累計されます -
exec 構成に組み込まれたツール用に C++ コンパイラに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
- 複数の
--host_features=<a string>
が累計されます -
特定の機能はデフォルトで、exec 構成に組み込まれたターゲットで有効または無効にします。「-feature>」を指定すると、その特徴が無効になります。ネガティブな特徴は常にポジティブな特徴をオーバーライドします。
タグ:changes_inputs
、affects_outputs
--host_force_python=<PY2 or PY3>
: 説明を表示-
exec 構成の Python バージョンをオーバーライドします。「PY2」または「PY3」を指定できます。
タグ:loading_and_analysis
、affects_outputs
- 複数の
--host_linkopt=<a string>
が累計されます -
exec 構成のツールをリンクする際にリンカーに渡す追加オプション。
タグ:action_command_lines
、affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
ホスト ターゲットの最小互換 macOS バージョン。指定しない場合は、「macos_sdk_version」を使用します。
タグ:loses_incremental_state
- 複数の
--host_per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
が累計されます -
exec 構成内の特定のファイルをコンパイルする際に、C/C++ コンパイラに選択的に渡す追加オプション。このオプションは複数回渡すことができます。構文: regex_filter@option_1、option_2,...、option_n。regex_filter は、正規表現の包含リストと除外リストを表します(--instrumentation_filter も参照)。option_1 から option_n は任意のコマンドライン オプションを表します。オプションにカンマを含める場合は、バックスラッシュで囲む必要があります。オプションには @ を含めることができます。最初の @ のみが文字列の分割に使用されます。例: --host_per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 では、-O0 コマンドライン オプションを、bar.cc 以外の //foo/ にあるすべての cc ファイルの gcc コマンドラインに追加します。
タグ:action_command_lines
、affects_outputs
- 複数の
--host_swiftcopt=<a string>
が累計されます -
exec ツールに swiftc に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
--[no]incompatible_auto_exec_groups
: 「false」-
有効にすると、ルールで使用されるツールチェーンごとに exec グループが自動的に作成されます。そのためには、ルールのアクションで「ツールチェーン」パラメータを指定する必要があります。詳細については、https://github.com/bazelbuild/bazel/issues/17134 をご覧ください。
タグ:affects_outputs
、incompatible_change
--[no]incompatible_avoid_conflict_dlls
のデフォルト: "true"-
有効にすると、Windows の cc_library によって生成されたすべての C++ ダイナミック リンク ライブラリ(DLL)の名前が name_hash.dll に変わり、リポジトリ名および DLL のパッケージパスに基づいてハッシュが計算されます。このオプションは、同じ名前の複数の cc_library に依存する 1 つのパッケージ(例: //foo/bar1:utils と //foo/bar2:utils)がある場合に役立ちます。
タグ:loading_and_analysis
、affects_outputs
、incompatible_change
--[no]incompatible_merge_genfiles_directory
のデフォルト: "true"-
true の場合、genfiles ディレクトリは bin ディレクトリに折りたたまれています。
タグ:affects_outputs
、incompatible_change
--[no]incompatible_use_host_features
: 「false」-
true の場合、ターゲット構成にのみ --features を使用し、exec 構成には --host_features を使用します。
タグ:changes_inputs
、affects_outputs
、incompatible_change
--[no]instrument_test_targets
: 「false」-
カバレッジが有効な場合、テストルールのインストルメンテーションを考慮するかどうかを指定します。設定すると、--instrumentation_filter に含まれるテストルールは計測可能になります。それ以外の場合、テストルールは常にカバレッジ計測から除外されます。
タグ:affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-/javatests[/:],-/test/java[/:]"-
一致が有効になっている場合、指定した正規表現ベースのフィルタを含む名前のルールのみが計測対象となります。「-」で始まるルールは除外されます。--instrument_test_targets が有効になっていない限り、テスト以外のルールのみがインストルメント化されることに注意してください。
タグ:affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
ターゲット設定のシミュレータとデバイスに対応する iOS の最小バージョン。指定しない場合は「ios_sdk_version」を使用します。
タグ:loses_incremental_state
- 複数の
--ios_multi_cpus=<comma-separated list of options>
が累計されます -
ios_application をビルドするアーキテクチャのカンマ区切りのリスト。その結果、指定したすべてのアーキテクチャを含むユニバーサル バイナリが生成されます。
タグ:loses_incremental_state
、loading_and_analysis
--[no]legacy_whole_archive
のデフォルト: "true"-
非推奨。--compatible_remove_legacy_whole_archive に置き換えられました(詳細は https://github.com/bazelbuild/bazel/issues/7362 を参照)。オンの場合、linkshared=True で、linkopt で linkstatic=True または「-static」を持つ cc_binary ルールに --whole-archive を使用します。これは下位互換性のためにのみ使用されます。必要に応じて、alwayslink=1 を使用することをおすすめします。
タグ:action_command_lines
、affects_outputs
、deprecated
- 複数の
--linkopt=<a string>
が累計されます -
リンク時に gcc に渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
- 複数の
--ltobackendopt=<a string>
が累計されます -
LTO バックエンド ステップに渡す追加オプション(--features=thin_lto の下)。
タグ:action_command_lines
、affects_outputs
- 複数の
--ltoindexopt=<a string>
が累計されます -
LTO インデックス登録ステップに渡すオプション(--features=thin_lto の下)です。
タグ:action_command_lines
、affects_outputs
- 複数の
--macos_cpus=<comma-separated list of options>
が累計されます - Apple macOS バイナリをビルドするアーキテクチャのカンマ区切りのリスト。
タグ:loses_incremental_state
、loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
移行先の macOS の最小バージョン。指定しない場合は、「macos_sdk_version」を使用します。
タグ:loses_incremental_state
--[no]objc_debug_with_GLIBCXX
: 「false」-
設定済みで、コンパイル モードを「dbg」に設定した場合は、GLIBCXX_DEBUG、GLIBCXX_DEBUG_PEDANTIC、GLIBCPP_CONCEPT_CHECKS を定義します。
タグ:action_command_lines
--[no]objc_enable_binary_stripping
: 「false」-
リンクされたバイナリに対してシンボルとデッドコードのストリッピングを実行するかどうか。このフラグと --compilation_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 0 コマンドライン オプションを、bar/cc 以外の //foo/ にあるすべての cc ファイルの gcc コマンドラインに追加します。
タグ:action_command_lines
、affects_outputs
- 複数の
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
が累計されます -
特定のバックエンド オブジェクトをコンパイルするときに、LTO バックエンドを選択的に渡すオプションを追加しました(--features=thin_lto の下)。このオプションは複数回渡すことができます。構文: regex_filter@option_1、option_2,...、option_n。regex_filter は、正規表現の包含と除外のリストを表します。option_1 から option_n は任意のコマンドライン オプションを表します。オプションにカンマを含める場合は、バックスラッシュで囲む必要があります。オプションには @ を含めることができます。最初の @ のみが文字列の分割に使用されます。例: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 は、bar/o を除くすべての o ファイルの LTO バックエンド コマンドラインに -O0 コマンドライン オプションを追加します。
タグ:
action_command_lines
、affects_outputs
--platform_suffix=<a string>
: 説明を表示- 構成ディレクトリに追加するサフィックスを指定します。
タグ:loses_incremental_state
、affects_outputs
、loading_and_analysis
--propeller_optimize=<a build target label>
: 説明を表示-
プロペラ プロファイルの情報を使用して、ビルド ターゲットを最適化します。プロペラ プロファイルは、cc プロファイルと ld プロファイルのうち少なくとも 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_lines
、affects_outputs
--propeller_optimize_absolute_cc_profile=<a string>
: 説明を表示- プロペラ最適化ビルドの cc_profile ファイルの絶対パス名。
タグ:affects_outputs
--propeller_optimize_absolute_ld_profile=<a string>
: 説明を表示- プロペラ最適化ビルドの ld_profile ファイルの絶対パス名。
タグ:affects_outputs
--run_under=<a prefix in front of command>
: 説明を表示-
「test」および「run」コマンドの実行可能ファイルの前に挿入する接頭辞。値が「foo -bar」で、実行コマンドラインが「test_binary -baz」の場合、最終的なコマンドラインは「foo -bar test_binary -baz」です。これは、実行可能ターゲットのラベルにすることもできます。例: 'valgrind'、'strace'、'strace -c'、'valgrind --quiet --num-callers=20'、'//package:target'、'//package:target --options'
タグ:action_command_lines
-
true の場合、同じ機能を含むネイティブ ライブラリが複数のターゲット間で共有されます。
タグ:loading_and_analysis
、affects_outputs
--[no]stamp
: 「false」-
日付、ユーザー名、ホスト名、ワークスペース情報などを含むバイナリをスタンプします。
タグ:affects_outputs
--strip=<always, sometimes or never>
のデフォルト: 「時には」-
バイナリと共有共有ライブラリを削除するかどうかを指定します(「-Wl,--strip-debug」を使用)。デフォルト値「sometimes」は、trip iff --compilation_mode=fastbuild を意味します。
タグ:affects_outputs
- 複数の
--stripopt=<a string>
が累計されます -
「<name>.stripped」バイナリを生成するときにストリップに渡す追加のオプション。
タグ:action_command_lines
、affects_outputs
- 複数の
--swiftcopt=<a string>
が累計されます - Swift コンパイルに渡す追加オプション。
タグ:action_command_lines
- 複数の
--tvos_cpus=<comma-separated list of options>
が累計されます - Apple tvOS バイナリをビルドするアーキテクチャのカンマ区切りのリスト。
タグ:loses_incremental_state
、loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
ターゲット シミュレータとデバイスに対応する最小の tvOS バージョン。指定しない場合は、「tvos_sdk_version」を使用します。
タグ:loses_incremental_state
- 複数の
--watchos_cpus=<comma-separated list of options>
が累計されます - Apple WatchOS バイナリをビルドするアーキテクチャのカンマ区切りのリスト。
タグ:loses_incremental_state
、loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: 説明を表示-
ターゲット シミュレータとデバイスに対応する WatchOS の最小バージョン。指定しない場合、「watchos_sdk_version」が使用されます。
タグ:loses_incremental_state
--xbinary_fdo=<a build target label>
: 説明を表示-
XbinaryFDO プロファイル情報を使用してコンパイルを最適化します。デフォルトのクロスバイナリ プロファイルの名前を指定します。オプションを --fdo_instrument/--fdo_optimize/--fdo_profile と併用すると、xbinary_fdo が指定されていないかのように、このオプションが常に優先されます。
タグ:affects_outputs
--auto_cpu_environment_group=<a build target label>
のデフォルト: "-
CPU 値を target_environment 値に自動的にマッピングするために使用する environment_group を宣言します。
タグ:changes_inputs
、loading_and_analysis
、experimental
--[no]check_licenses
: 「false」-
依存パッケージによって課されるライセンスの制約が、ビルドされるターゲットの配布モードと競合しないことを確認します。デフォルトでは、ライセンスはチェックされません。
タグ:build_file_semantics
--[no]check_visibility
のデフォルト: "true"-
無効にした場合、ターゲット依存関係の可視性エラーは警告に降格されます。
タグ:build_file_semantics
--[no]desugar_for_android
のデフォルト: "true"- dex 変換の前に Java 8 バイトコードを脱糖するかどうか。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
--[no]desugar_java8_libs
: 「false」-
レガシー デバイスのアプリでサポートされる Java 8 ライブラリを含めるかどうか。
タグ:affects_outputs
、loading_and_analysis
、loses_incremental_state
、experimental
--[no]enforce_constraints
のデフォルト: "true"-
各ターゲットが互換性のある環境を確認し、同じ環境をサポートしない依存関係が含まれている場合はエラーを報告します。
タグ:build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs
: 「false」-
srcs-less android_library ルールを deps 付きで許可しないように遷移するフラグです。デフォルトでは、このリポジトリを展開してクリーンアップする必要があります。
タグ:eagerness_to_exit
、loading_and_analysis
--[no]experimental_check_desugar_deps
のデフォルト: "true"- Android バイナリレベルで正しい脱糖を再確認するかどうか。
タグ:eagerness_to_exit
、loading_and_analysis
、experimental
--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_semantics
、eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files
: 「false」-
有効にすると、生成ルールのテスト専用を検索することで、出力ファイルである前提条件のターゲットが testonly にチェックされます。これは公開設定の確認と一致します。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_check_visibility_for_toolchains
: 「false」-
有効にすると、ツールチェーン実装にも可視性チェックが適用されます。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_disable_native_android_rules
: 「false」-
有効にすると、ネイティブ Android ルールの直接使用が無効になります。https://github.com/bazelbuild/rules_android の Starlark Android ルールを使用してください。
タグ:eagerness_to_exit
、incompatible_change
--[no]incompatible_disable_native_apple_binary_rule
: 「false」-
いいえ。下位互換性のために、ここに残しておきます。
タグ:eagerness_to_exit
、incompatible_change
--[no]incompatible_force_strict_header_check_from_starlark
のデフォルト: "true"-
有効にすると、Starlark API で厳密なヘッダーのチェックを設定します。
タグ:loading_and_analysis
、changes_inputs
、incompatible_change
--[no]incompatible_python_disable_py2
のデフォルト: "true"-
true の場合、Python 2 の設定を使用するとエラーが発生します。これには、python_version=PY2、srcs_version=PY2、srcs_version=PY2ONLY が含まれます。詳しくは、https://github.com/bazelbuild/bazel/issues/15684 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_validate_top_level_header_inclusions
のデフォルト: "true"-
true の場合、Bazel は最上位のディレクトリ ヘッダーも検証します(詳細については https://github.com/bazelbuild/bazel/issues/10047 をご覧ください)。
タグ:loading_and_analysis
、incompatible_change
--python_native_rules_allowlist=<a build target label>
: 説明を表示-
--compatible_python_disallow_native_rules を適用するときに使用する許可リスト(package_group ターゲット)。
タグ:loading_and_analysis
--[no]strict_filesets
: 「false」-
このオプションを有効にすると、パッケージの境界を超えるファイルセットがエラーとして報告されます。check_fileset_ dependencies_recursative が無効になっている場合、これは機能しません。
タグ:build_file_semantics
、eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default>
のデフォルト: "error"-
オフの場合を除いて、proto_library ターゲットは、直接使用されているすべてのターゲットを依存関係として明示的に宣言していることを確認します。
タグ:build_file_semantics
、eagerness_to_exit
、incompatible_change
--strict_public_imports=<off, warn, error, strict or default>
のデフォルト: "off"-
オフの場合以外は、proto_library ターゲットが「import public」で使用されるすべてのターゲットを明示的にエクスポート済みとして宣言していることを確認します。
タグ:build_file_semantics
、eagerness_to_exit
、incompatible_change
--[no]strict_system_includes
: 「false」-
true の場合、system include パス(-isystem)にあるヘッダーも宣言する必要があります。
タグ:loading_and_analysis
、eagerness_to_exit
- 複数の
--target_environment=<a build target label>
が累計されます - このビルドのターゲット環境を宣言します。「環境」ルールを参照するラベルを指定する必要があります。指定する場合、トップレベル ターゲットはすべてこの環境に対応している必要があります。
タグ:changes_inputs
--apk_signing_method=<v1, v2, v1_v2 or v4>
のデフォルト: "v1_v2"-
APK の署名に使用する実装
タグ:action_command_lines
、affects_outputs
、loading_and_analysis
--[no]device_debug_entitlements
のデフォルト: "true"-
設定されていて、コンパイル モードが「opt」でない場合、署名時に objc アプリにデバッグ資格が含まれます。
タグ:changes_inputs
--ios_signing_cert_name=<a string>
: 説明を表示-
iOS 署名に使用する証明書名。設定しない場合、プロビジョニング プロファイルにフォールバックします。コード署名のマニュアル ページ(ID IDITITIES)に基づき、証明書のキーチェーン ID 設定または証明書の共通名(部分文字列)を指定できます。
タグ:action_command_lines
--[no]incompatible_disallow_legacy_py_provider
のデフォルト: "true"-
No-op はまもなく削除されます。
タグ:loading_and_analysis
、incompatible_change
--[no]incompatible_disallow_sdk_frameworks_attributes
: 「false」-
true の場合、objc_library および objc_import で sdk_frameworks 属性と weak_sdk_frameworks 属性を禁止します。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_objc_alwayslink_by_default
: 「false」-
true の場合、objc_library および objc_import の alwayslink 属性のデフォルト値を true にします。
タグ:build_file_semantics
、incompatible_change
--[no]incompatible_python_disallow_native_rules
: 「false」-
true の場合、組み込みの py_* ルールを使用するとエラーが発生します。代わりに、rule_python ルールを使用してください。詳細と移行手順については、https://github.com/bazelbuild/bazel/issues/17773 をご覧ください。
タグ:loading_and_analysis
、incompatible_change
- このオプションは、Starlark 言語または Build API の、BUILD ファイル、.bzl ファイル、WORKSPACE ファイルで使用可能なセマンティクスに影響します。
- Bzlmod の出力とセマンティクスに関連するオプション:
- ビルド時間の最適化をトリガーするオプション:
- ロギングの詳細度、形式、場所に影響するオプション:
- 他のカテゴリに分類されない Bazel コマンドへの汎用入力を指定または変更するオプション:
- リモート キャッシュと実行オプション:
- その他のオプション: 特に分類しない場合。
Aquery のオプション
build からすべてのオプションを継承します。
- コマンドの前に表示され、クライアントによって解析されるオプション:
- ビルド実行を制御するオプション:
- Bazel による有効なビルド入力の厳格化に影響するオプション(ルール定義、フラグの組み合わせなど)
- このオプションは、Starlark 言語または Build API の、BUILD ファイル、.bzl ファイル、WORKSPACE ファイルで使用可能なセマンティクスに影響します。
- クエリ出力とセマンティクスに関連するオプション:
- ビルド時間の最適化をトリガーするオプション:
- ロギングの詳細度、形式、場所に影響するオプション:
- 他のカテゴリに分類されない Bazel コマンドへの汎用入力を指定または変更するオプション:
- リモート キャッシュと実行オプション:
- その他のオプション: 特に分類しない場合。
- ビルド実行を制御するオプション:
- アクション実行に使用するツールチェーンを構成するオプション:
- コマンドの出力を制御するオプション:
- ユーザーが意図する出力を構成し、その値ではなく値が影響を受けるようにします。
- Bazel による有効なビルド入力の厳格さに影響するオプション(ルール定義、フラグの組み合わせなど)
- ビルドの署名出力に影響するオプション:
- このオプションは、Starlark の言語またはセマンティクスに影響を与えます。
- テスト環境またはテストランナーの動作を管理するオプション:
- クエリ出力とセマンティクスに関連するオプション:
- ロギングの詳細度、形式、場所に影響するオプション:
- 他のカテゴリに分類されない Bazel コマンドの汎用入力を指定または変更するオプション:
- 上記以外のカテゴリ:
ビルド オプション
- コマンドの前に表示され、クライアントによって解析されるオプション:
- ビルド実行を制御するオプション:
- アクション実行に使用するツールチェーンを構成するオプション:
- コマンドの出力を制御するオプション:
- ユーザーが意図する出力を構成し、その値ではなく値が影響を受けるようにします。
- Bazel による有効なビルド入力の厳格さに影響するオプション(ルール定義、フラグの組み合わせなど)
- テスト環境またはテストランナーの動作を管理するオプション:
- Bzlmod の出力とセマンティクスに関連するオプション:
- ビルド時間の最適化をトリガーするオプション:
- ロギングの詳細度、形式、場所に影響するオプション:
- 他のカテゴリに分類されない Bazel コマンドの汎用入力を指定または変更するオプション:
- リモートキャッシュと実行オプション:
- その他のオプション: 特に分類しない場合。
- ビルド実行を制御するオプション:
- アクション実行に使用するツールチェーンを構成するオプション:
- コマンドの出力を制御するオプション:
- ユーザーが意図する出力を構成し、その値ではなく値が影響を受けるようにします。
- Bazel による有効なビルド入力の厳格さに影響するオプション(ルール定義、フラグの組み合わせなど)
- ビルドの署名出力に影響するオプション:
- このオプションは、Starlark の言語またはセマンティクスに影響を与えます。
- テスト環境またはテストランナーの動作を管理するオプション:
- ビルド時間の最適化をトリガーするオプション:
- ロギングの詳細度、形式、場所に影響するオプション:
- 他のカテゴリに分類されない Bazel コマンドの汎用入力を指定または変更するオプション:
- リモートキャッシュと実行オプション:
- 他のカテゴリに分類されていないその他のオプション:
正規フラグ オプション
build からすべてのオプションを継承します。
- コマンドの前に表示され、クライアントによって解析されるオプション:
- ビルド実行を制御するオプション:
- 出力を制御するオプション
- Bazel による有効なビルド入力の厳密な適用に影響するオプション(ルール定義、フラグの組み合わせなど)
- このオプションは、Starlark 言語または Build API の、BUILD ファイル、.bzl ファイル、WORKSPACE ファイルで使用可能なセマンティクスに影響します。
- Bzlmod の出力とセマンティクスに関連するオプション:
- ビルド時間の最適化をトリガーするオプション:
- ロギングの詳細度、形式、場所に影響するオプション:
- 他のカテゴリに分類されない Bazel コマンドへの汎用入力を指定または変更するオプション:
- リモートのキャッシュと実行のオプション:
- その他のオプション: 特に分類しない場合。
クリーン オプション
build からすべてのオプションを継承します。
- コマンドの前に表示され、クライアントによって解析されるオプション:
- ビルド実行を制御するオプション:
- 出力を制御するオプション
- クラスターに適用されるルール
- このオプションは、Starlark 言語または Build API の、BUILD ファイル、.bzl ファイル、WORKSPACE ファイルで使用可能なセマンティクスに影響します。
- Bzlmod の出力とセマンティクスに関連するオプション:
- ビルド時間の最適化をトリガーするオプション:
- ロギングの詳細度、形式、場所に影響するオプション:
- 他のカテゴリに分類されない Bazel コマンドへの汎用入力を指定または変更するオプション:
- リモート キャッシュと実行オプション:
- その他のオプション: 特に分類しない場合。
構成オプション
通信可能範囲のオプション
test からすべてのオプションを継承します。
- コマンドの前に表示され、クライアントによって解析されるオプション:
- ビルド実行を制御するオプション:
- Bazel による有効なビルド入力の厳格化に影響するオプション(ルール定義、フラグの組み合わせなど)
- このオプションは、Starlark 言語または Build API の、BUILD ファイル、.bzl ファイル、WORKSPACE ファイルで使用可能なセマンティクスに影響します。
- Bzlmod の出力とセマンティクスに関連するオプション:
- ビルド時間の最適化をトリガーするオプション:
- ロギングの詳細度、形式、場所に影響するオプション:
- 他のカテゴリに分類されない Bazel コマンドへの汎用入力を指定または変更するオプション:
- リモート キャッシュと実行オプション:
- その他のオプション: 特に分類しない場合。
Cquery のオプション
test からすべてのオプションを継承します。
- コマンドの前に表示され、クライアントによって解析されるオプション:
- ビルド実行を制御するオプション:
- Bazel による有効なビルド入力の厳格化に影響するオプション(ルール定義、フラグの組み合わせなど)
- このオプションは、Starlark 言語または Build API の、BUILD ファイル、.bzl ファイル、WORKSPACE ファイルで使用可能なセマンティクスに影響します。
- クエリ出力とセマンティクスに関連するオプション:
- ビルド時間の最適化をトリガーするオプション:
- ロギングの詳細度、形式、場所に影響するオプション:
- 他のカテゴリに分類されない Bazel コマンドへの汎用入力を指定または変更するオプション:
- リモート キャッシュと実行オプション:
- その他のオプション: 特に分類しない場合。
- ビルド実行を制御するオプション:
- アクション実行に使用するツールチェーンを構成するオプション:
- コマンドの出力を制御するオプション:
- ユーザーが意図する出力を構成し、その値ではなく値が影響を受けるようにします。
- Bazel による有効なビルド入力の厳格さに影響するオプション(ルール定義、フラグの組み合わせなど)
- ビルドの署名出力に影響するオプション:
- このオプションは、Starlark の言語またはセマンティクスに影響を与えます。
- テスト環境またはテストランナーの動作を管理するオプション: