Java ルール

問題を報告 ソースを表示

ルール

• java_binary
• java_import
• java_library
• java_lite_proto_library
• java_proto_library
• java_test
• java_package_configuration
• java_plugin
• java_runtime
• java_ツールチェーン

java_binary

ルールのソースを表示

java_binary(name, deps, srcs, data, resources, args, classpath_resources, compatible_with, create_executable, deploy_env, deploy_manifest_lines, deprecation, distribs, env, exec_compatible_with, exec_properties, features, javacopts, jvm_flags, launcher, licenses, main_class, output_licenses, plugins, resource_jars, resource_strip_prefix, restricted_to, runtime_deps, stamp, tags, target_compatible_with, testonly, toolchains, use_launcher, use_testrunner, visibility)

Java アーカイブ（「jar ファイル」）と、ルールと同じ名前のラッパー シェル スクリプトをビルドします。 ラッパー シェル スクリプトは、バイナリが依存する各ライブラリの jar ファイルなどを含むクラスパスを使用します。ラッパー シェル スクリプトを実行する場合、空でない JAVABIN 環境変数は、Bazel の --java_runtime_version フラグで指定されたバージョンよりも優先されます。

ラッパー スクリプトには、いくつかの一意のフラグを指定できます。ラッパーで使用できる構成可能なフラグと環境変数のリストについては、//src/main/java/com/google/devtools/build/lib/bazel/rules/java/java_stub_template.txt をご覧ください。

暗黙的な出力ターゲット

• name.jar: Java アーカイブ。バイナリの直接依存関係に対応するクラスファイルとその他のリソースが含まれます。
• name-src.jar: ソースを含むアーカイブ（「ソース jar」）。
• name_deploy.jar: デプロイに適した Java アーカイブ（明示的にリクエストされた場合にのみビルドされます）。

  ルールの <name>_deploy.jar ターゲットをビルドすると、java -jar コマンドまたはラッパー スクリプトの --singlejar オプションで実行できるようにするマニフェストとともに自己完結型の jar ファイルが作成されます。JVM フラグとネイティブ ライブラリを読み込むためのオプションも渡すため、java -jar よりもラッパー スクリプトを使用することをおすすめします。

  deploy jar には、バイナリのラッパー スクリプトからクラスパスを最初から最後まで検索するクラスローダーによって検出されるすべてのクラスが含まれています。また、依存関係に必要なネイティブ ライブラリも含まれています。これらは実行時に JVM に自動的に読み込まれます。

  ターゲットが launcher 属性を指定している場合、通常の JAR ファイルではなく、_deploy.jar はネイティブ バイナリになります。これには、ランチャーと、ルールのネイティブ（C++）依存関係が含まれます。これらはすべて静的バイナリにリンクされます。実際の jar ファイルのバイトがそのネイティブ バイナリに追加され、実行可能ファイルと Java コードの両方を含む単一のバイナリ blob が作成されます。生成された jar ファイルは、ネイティブ バイナリを実行するように直接実行できます。

• name_deploy-src.jar: ターゲットの推移的クロージャから収集されたソースを含むアーカイブ。これらは、jar に一致するソース JAR がない場合を除き、deploy.jar 内のクラスと一致します。

java_binary ルールで deps 属性は srcs を指定しないと、使用できません。このようなルールを使用するには、runtime_deps によって提供される main_class が必要です。

よくある間違いを次のコード スニペットに示します。

java_binary(
    name = "DontDoThis",
    srcs = [
        ...,
        "GeneratedJavaFile.java",  # a generated .java file
    ],
    deps = [":generating_rule",],  # rule that generates that file
)

代わりに次のようにします。

java_binary(
    name = "DoThisInstead",
    srcs = [
        ...,
        ":generating_rule",
    ],
)

引数

属性
name	名前（必須） このターゲットの一意の名前。 アプリケーションのメインのエントリ ポイントとなるソースファイルの名前（拡張子を除く）を使用することをおすすめします。たとえば、エントリ ポイントが Main.java の場合、名前は Main のようになります。
deps	ラベルのリスト。デフォルトは [] です。 ターゲットにリンクする他のライブラリのリスト。deps に関する一般的なコメントについては、ほとんどのビルドルールで定義されている一般的な属性をご覧ください。
srcs	ラベルのリスト。デフォルトは [] です。 ターゲットを作成するために処理されるソースファイルのリスト。この属性はほとんどの場合必須です。下記の例外をご覧ください。 .java 型のソースファイルはコンパイルされます。生成された .java ファイルの場合、ファイル自体の名前ではなく、生成ルールの名前をここに入力することをおすすめします。これにより、読みやすさが向上するだけでなく、将来の変更に対するルールの復元力も高まります。生成ルールで今後異なるファイルが生成される場合でも、修正する必要があるのは生成ルールの outs のみです。生成ルールは NoOps であるため、deps にリストしないでください。 .srcjar 型のソースファイルは、展開されてコンパイルされます。（これは、genrule を含む .java ファイルのセットを生成する必要がある場合に便利です）。 ルール: ルール（通常は genrule または filegroup）が上記のファイルのいずれかを生成する場合、それらのファイルはソースファイルの場合と同じ方法で使用されます。 main_class 属性でランタイム クラスパスのクラスを指定する場合、または runtime_deps 引数を指定する場合を除き、この引数はほとんど常に必要です。
resources	ラベルのリスト。デフォルトは [] です。 Java jar に含めるデータファイルのリスト。 リソースが指定されている場合、コンパイルで生成される通常の .class ファイルとともに jar にバンドルされます。jar ファイル内のリソースの場所は、プロジェクト構造によって決まります。Bazel は最初に Maven の標準ディレクトリ レイアウトを探します（「src」ディレクトリの後に「resources」ディレクトリの孫が続きます）。見つからない場合、Bazel は「java」または「javatests」という名前の最上位のディレクトリを探します（たとえば、リソースが <workspace root>/x/java/y/java/z にある場合、リソースのパスは y/java/z になります）。このヒューリスティックはオーバーライドできませんが、resource_strip_prefix 属性を使用して、リソース ファイルに特定の代替ディレクトリを指定できます。 リソースには、ソースファイルまたは生成されたファイルを指定できます。
classpath_resources	ラベルのリスト。デフォルトは [] です。 他に方法がない場合以外は、このオプションを使用しないでください） Java ツリーのルートに配置する必要があるリソースのリスト。この属性の唯一の目的は、リソースを "myconfig.xml" としてクラスパス上で検出する必要があるサードパーティ ライブラリをサポートすることです。名前空間が競合する危険性があるため、バイナリでのみ許可され、ライブラリでは許可されません。
create_executable	ブール値、設定不可、デフォルトは True 非推奨です。代わりに java_single_jar を使用してください。
deploy_env	ラベルのリスト。デフォルトは [] です。 このバイナリのデプロイ環境を表す他の java_binary ターゲットのリスト。別の java_binary によって読み込まれるプラグインをビルドするときに、この属性を設定します。 この属性を設定すると、このバイナリと deploy_env で指定されたターゲットの間で共有される、このバイナリのランタイム クラスパス（および deploy jar）から、すべての依存関係が除外されます。
deploy_manifest_lines	文字列のリスト。デフォルトは [] です。 *_deploy.jar ターゲット用に生成された META-INF/manifest.mf ファイルに追加する行のリスト。この属性の内容は、「変数を作成」置換の対象になりません。
javacopts	文字列のリスト。デフォルトは [] です。 このライブラリの追加のコンパイラ オプション。 「変数を作成」の置換と Bourne シェルのトークン化が適用されます。 これらのコンパイラ オプションは、グローバル コンパイラ オプションの後に javac に渡されます。
jvm_flags	文字列のリスト。デフォルトは [] です。 このバイナリを実行するために生成されたラッパー スクリプトに埋め込むフラグのリスト。$(location) と「変数を作成」の置換、Bourne シェルのトークン化が適用されます。 Java バイナリのラッパー スクリプトには、CLASSPATH 定義（依存するすべての jar を見つけるため）が含まれており、適切な Java インタープリタを呼び出します。ラッパー スクリプトによって生成されたコマンドラインでは、メインクラスの名前の後に "$@" が続くため、クラス名の後に他の引数を渡すことができます。ただし、JVM による解析を意図した引数は、コマンドラインのクラス名の前に指定する必要があります。jvm_flags の内容は、クラス名がリストされる前にラッパー スクリプトに追加されます。 この属性は *_deploy.jar の出力には作用しないことに注意してください。
launcher	ラベル: デフォルトは None JDK に含まれる通常の bin/java プログラムの代わりに、Java プログラムの実行に使用するバイナリを指定します。ターゲットは cc_binary にする必要があります。 Java Invocation API を実装するすべての cc_binary を、この属性の値として指定できます。 デフォルトでは、Bazel は通常の JDK ランチャー（bin/java または java.exe）を使用します。 関連する --java_launcher Bazel フラグは、launcher 属性を指定していない java_binary ターゲットと java_test ターゲットにのみ影響します。 ネイティブ（C++、SWIG、JNI）依存関係のビルドは、JDK ランチャーを使用しているか別のランチャーを使用しているかによって異なります。 通常の JDK ランチャー（デフォルト）を使用している場合、ネイティブ依存関係は {name}_nativedeps.so という名前の共有ライブラリとしてビルドされます。ここで、{name} はこの java_binary ルールの name 属性です。未使用のコードは、この構成のリンカーによって削除されません。 他のランチャーを使用している場合、ネイティブ（C++）依存関係は {name}_nativedeps という名前のバイナリに静的にリンクされます。ここで、{name} はこの java_binary ルールの name 属性です。この場合、リンカーは使用されていないと判断したコードを結果のバイナリから削除します。つまり、cc_library ターゲットで alwayslink = 1 を指定していない限り、JNI 経由でのみアクセスされる C++ コードはリンクできません。 デフォルトの JDK ランチャー以外のランチャーを使用する場合、*_deploy.jar 出力の形式が変更されます。詳細については、java_binary のメイン ドキュメントをご覧ください。
main_class	文字列。デフォルトは "" エントリ ポイントとして使用する main() メソッドを含むクラスの名前。ルールでこのオプションを使用する場合、srcs=[...] リストは必要ありません。したがって、この属性を使用すると、すでに 1 つ以上の main() メソッドが含まれている Java ライブラリから実行ファイルを作成できます。 この属性の値は、ソースファイルではなくクラス名です。このクラスは実行時に使用可能でなければなりません。このルールによって（srcs から）コンパイルすることも、直接的または推移的依存関係（runtime_deps または deps を使用）によって提供することもできます。クラスを使用できない場合、バイナリは実行時に失敗します。ビルド時のチェックは行われません。
plugins	ラベルのリスト。デフォルトは [] です。 コンパイル時に実行する Java コンパイラ プラグイン。このルールがビルドされるたびに、この属性で指定されたすべての java_plugin が実行されます。ライブラリは、exported_plugins を使用する依存関係からプラグインを継承することもできます。プラグインによって生成されたリソースは、このルールで生成される jar に含まれます。
resource_jars	ラベルのリスト。デフォルトは [] です。 非推奨: 代わりに java_import と deps または runtime_deps を使用してください。
resource_strip_prefix	文字列。デフォルトは "" Java リソースから削除するパス接頭辞。 指定すると、このパス接頭辞は resources 属性内のすべてのファイルから削除されます。リソース ファイルがこのディレクトリにない場合はエラーになります。指定しない場合（デフォルト）、リソース ファイルのパスはソースファイルの Java パッケージと同じロジックに従って決定されます。たとえば、stuff/java/foo/bar/a.txt のソースファイルは foo/bar/a.txt にあります。
runtime_deps	ラベルのリスト。デフォルトは [] です。 最終バイナリまたは実行時にのみテストで使用できるようにするライブラリ。通常の deps と同様に、これらはランタイム クラスパスに表示されますが、コンパイル時のクラスパスとは異なります。実行時にのみ必要な依存関係をここにリストします。依存関係分析ツールは、runtime_deps と deps の両方に存在するターゲットを無視する必要があります。
stamp	整数。デフォルトは -1 ビルド情報をバイナリにエンコードするかどうか。可能な値: stamp = 1: --nostamp ビルドであっても、常にビルド情報をバイナリにスタンプします。この設定はおすすめしません。バイナリとそれに依存するダウンストリーム アクションのリモート キャッシュが強制終了される可能性があるためです。 stamp = 0: ビルド情報を常に定数値に置き換えます。これにより、ビルド結果を適切にキャッシュに保存できます。 stamp = -1: ビルド情報の埋め込みは --[no]stamp フラグで制御されます。 スタンプされたバイナリは、依存関係が変更されない限り再ビルドされません。
use_launcher	ブール値。デフォルトは True です。 バイナリがカスタム ランチャーを使用するかどうか。 この属性を false に設定した場合、このターゲットでは launcher 属性と関連する --java_launcher フラグは無視されます。
use_testrunner	ブール値。デフォルトは False です。 テストランナー（デフォルトでは com.google.testing.junit.runner.BazelTestRunner）クラスを Java プログラムのメインのエントリ ポイントとして使用し、テストクラスをテストランナーに bazel.test_suite システム プロパティの値として提供します。 これにより、デフォルトの動作（java_test ルールにはテストランナーを使用し、java_binary ルールには使用しない）をオーバーライドできます。このような操作を行うことはほとんどありません。1 つの用途として、別のルールによって呼び出される AllTest ルールがあります（テストの実行前にデータベースを設定する場合など）。AllTest ルールは java_binary として宣言する必要がありますが、メインのエントリ ポイントとしてテストランナーを使用する必要があります。テストランナー クラスの名前は、main_class 属性でオーバーライドできます。

java_import

ルールのソースを表示

java_import(name, deps, data, compatible_with, constraints, deprecation, distribs, exec_compatible_with, exec_properties, exports, features, jars, licenses, neverlink, proguard_specs, restricted_to, runtime_deps, srcjar, tags, target_compatible_with, testonly, visibility)

このルールでは、プリコンパイルされた .jar ファイルを java_library ルールと java_binary ルールのライブラリとして使用できます。

例

    java_import(
        name = "maven_model",
        jars = [
            "maven_model/maven-aether-provider-3.2.3.jar",
            "maven_model/maven-model-3.2.3.jar",
            "maven_model/maven-model-builder-3.2.3.jar",
        ],
    )

引数

属性
name	名前（必須） このターゲットの一意の名前。
deps	ラベルのリスト。デフォルトは [] です。 ターゲットにリンクする他のライブラリのリスト。java_library.deps をご覧ください。
constraints	文字列のリスト。設定不可。デフォルトは [] です。 Java ライブラリとしてこのルールに適用される追加の制約。
exports	ラベルのリスト。デフォルトは [] です。 このルールのユーザーが使用できるようにするターゲット。 java_library.exports をご覧ください。
jars	ラベルのリスト。必須 このターゲットに依存する Java ターゲットに提供される JAR ファイルのリスト。
neverlink	ブール値。デフォルトは False です。 このライブラリは、実行時ではなくコンパイル時のみに使用してください。実行時にランタイム環境によってライブラリが提供される場合に便利です。このようなライブラリの例としては、IDE プラグイン用の IDE API や、標準 JDK 上で実行されるもの用の tools.jar があります。
proguard_specs	ラベルのリスト。デフォルトは [] です。 ProGuard 仕様として使用されるファイル。ここでは、Proguard で使用される一連の仕様について説明します。指定すると、このライブラリに応じて任意の android_binary ターゲットに追加されます。 ここに含めるファイルには、べき等ルール（-dontnote、-dontwarn、confirmnosideeffects、-keep で始まるルール）のみを含める必要があります。他のオプションは、非自動的マージを保証するために、android_binary の proguard_specs でのみ指定できます。
runtime_deps	ラベルのリスト。デフォルトは [] です。 最終バイナリまたは実行時にのみテストで使用できるようにするライブラリ。java_library.runtime_deps をご覧ください。
srcjar	ラベル: デフォルトは None コンパイルされた JAR ファイルのソースコードを含む JAR ファイル。

java_library

ルールのソースを表示

java_library(name, deps, srcs, data, resources, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, exported_plugins, exports, features, javacopts, licenses, neverlink, plugins, proguard_specs, resource_jars, resource_strip_prefix, restricted_to, runtime_deps, tags, target_compatible_with, testonly, visibility)

このルールは、ソースを .jar ファイルにコンパイルしてリンクします。

暗黙的な出力ターゲット

• libname.jar: クラスファイルを含む Java アーカイブ。
• libname-src.jar: ソースを含むアーカイブ（「ソース jar」）。

引数

属性
name	名前（必須） このターゲットの一意の名前。
deps	ラベルのリスト。デフォルトは [] です。 このライブラリにリンクするライブラリのリスト。 deps に関する一般的なコメントについては、ほとんどのビルドルールで定義されている一般的な属性をご覧ください。 deps にリストされている java_library ルールによってビルドされた JAR は、このルールのコンパイル時クラスパスになります。さらに、deps、runtime_deps、exports の推移的クロージャは、ランタイム クラスパスで行われます。 これに対して、data 属性内のターゲットは実行ファイルに含まれますが、コンパイル時クラスパスにもランタイム クラスパスにも組み込まれます。
srcs	ラベルのリスト。デフォルトは [] です。 ターゲットを作成するために処理されるソースファイルのリスト。この属性はほとんどの場合必須です。下記の例外をご覧ください。 .java 型のソースファイルはコンパイルされます。生成された .java ファイルの場合、ファイル自体の名前ではなく、生成ルールの名前をここに入力することをおすすめします。これにより、読みやすさが向上するだけでなく、将来の変更に対するルールの復元力も高まります。生成ルールで今後異なるファイルが生成される場合でも、修正する必要があるのは生成ルールの outs のみです。生成ルールは NoOps であるため、deps にリストしないでください。 .srcjar 型のソースファイルは、展開されてコンパイルされます。（これは、genrule を含む .java ファイルのセットを生成する必要がある場合に便利です）。 ルール: ルール（通常は genrule または filegroup）が上記のファイルのいずれかを生成する場合、それらのファイルはソースファイルの場合と同じ方法で使用されます。 main_class 属性でランタイム クラスパスのクラスを指定する場合、または runtime_deps 引数を指定する場合を除き、この引数はほとんど常に必要です。
data	ラベルのリスト。デフォルトは [] です。 実行時にこのライブラリが必要とするファイルのリスト。data に関する一般的なコメントについては、ほとんどのビルドルールで定義されている一般的な属性をご覧ください。 java_library をビルドする際、Bazel はこれらのファイルをどこにも配置しません。data ファイルが生成されると、Bazel によって生成されます。この java_library に依存するテストをビルドする場合、Bazel は data ファイルを runfile 領域にコピーまたはリンクします。
resources	ラベルのリスト。デフォルトは [] です。 Java jar に含めるデータファイルのリスト。 リソースが指定されている場合、コンパイルで生成される通常の .class ファイルとともに jar にバンドルされます。jar ファイル内のリソースの場所は、プロジェクト構造によって決まります。Bazel は最初に Maven の標準ディレクトリ レイアウトを探します（「src」ディレクトリの後に「resources」ディレクトリの孫が続きます）。見つからない場合、Bazel は「java」または「javatests」という名前の最上位のディレクトリを探します（たとえば、リソースが <workspace root>/x/java/y/java/z にある場合、リソースのパスは y/java/z になります）。このヒューリスティックはオーバーライドできませんが、resource_strip_prefix 属性を使用して、リソース ファイルに特定の代替ディレクトリを指定できます。 リソースには、ソースファイルまたは生成されたファイルを指定できます。
exported_plugins	ラベルのリスト。デフォルトは [] です。 このライブラリに直接依存するライブラリにエクスポートする java_plugin（アノテーション プロセッサなど）のリスト。 指定された java_plugin のリストは、このライブラリに直接依存するライブラリに適用されます。これは、ライブラリが plugins でこれらのラベルを明示的に宣言している場合と同様です。
exports	ラベルのリスト。デフォルトは [] です。 エクスポートされたライブラリ。 ここにルールを一覧表示すると、親ルールがこれらのルールに明示的に依存しているかのように、親ルールで使用できるようになります。これは、通常の（エクスポートされていない）deps には当てはまりません。 概要: ルール X 間に deps エッジで始まり、その後に 0 個以上の exports エッジが続く依存関係パスが存在する場合、ルール XX は YX のコードにアクセスできます。それを示す例をいくつか見てみましょう。 A は B に依存し、B は C に依存しているとします。この場合、C は A の推移的依存関係であるため、C のソースを変更して A を再構築すると、すべてが正しく再構築されます。ただし、A は C のクラスを使用できません。そのためには、A は deps で C を宣言する必要があります。または、B の exports 属性で C を宣言することで、A（および A に依存するすべてのもの）を簡単に宣言できるようになります。 エクスポートされたライブラリのクローズは、すべての直接の親ルールで使用できます。少し異なる例を見てみましょう。A は B に依存し、B は C と D に依存し、さらに C はエクスポートしますが D はエクスポートしません。これで、A は C にはアクセスできますが、D にはアクセスできません。これで、C と D が一部のライブラリ（C' と D'）をエクスポートした場合、A は C' にのみアクセスでき、D' にはアクセスできません。 重要: エクスポートされたルールは、通常の依存関係ではありません。前の例で言うと、B が C をエクスポートし、C も使用する場合は、その B も独自の deps にリストする必要があります。
javacopts	文字列のリスト。デフォルトは [] です。 このライブラリの追加のコンパイラ オプション。 「変数を作成」の置換と Bourne シェルのトークン化が適用されます。 これらのコンパイラ オプションは、グローバル コンパイラ オプションの後に javac に渡されます。
neverlink	ブール値。デフォルトは False です。 このライブラリをコンパイルにのみ使用し、実行時は使用しないかどうか。 実行時にランタイム環境によってライブラリが提供される場合に便利です。そのようなライブラリの例としては、IDE プラグイン用の IDE API や、標準 JDK 上で実行されるもの用の tools.jar があります。 neverlink = 1 を指定しても、Java 言語仕様（String またはプリミティブ型の static final 定数など）。したがって、推奨されるユースケースは、ランタイム ライブラリがコンパイル ライブラリと同一である場合です。 ランタイム ライブラリがコンパイル ライブラリと異なる場合は、JLS でコンパイラのインライン化が禁止されている箇所のみが異なるようにする必要があります（また、JLS の今後のすべてのバージョンで保持する必要があります）。
plugins	ラベルのリスト。デフォルトは [] です。 コンパイル時に実行する Java コンパイラ プラグイン。このルールがビルドされるたびに、この属性で指定されたすべての java_plugin が実行されます。ライブラリは、exported_plugins を使用する依存関係からプラグインを継承することもできます。プラグインによって生成されたリソースは、このルールで生成される jar に含まれます。
proguard_specs	ラベルのリスト。デフォルトは [] です。 ProGuard 仕様として使用されるファイル。ここでは、Proguard で使用される一連の仕様について説明します。指定すると、このライブラリに応じて任意の android_binary ターゲットに追加されます。 ここに含めるファイルには、べき等ルール（-dontnote、-dontwarn、confirmnosideeffects、-keep で始まるルール）のみを含める必要があります。他のオプションは、非自動的マージを保証するために、android_binary の proguard_specs でのみ指定できます。
resource_jars	ラベルのリスト。デフォルトは [] です。 非推奨: 代わりに java_import と deps または runtime_deps を使用してください。
resource_strip_prefix	文字列。デフォルトは "" Java リソースから削除するパス接頭辞。 指定すると、このパス接頭辞は resources 属性内のすべてのファイルから削除されます。リソース ファイルがこのディレクトリにない場合はエラーになります。指定しない場合（デフォルト）、リソース ファイルのパスはソースファイルの Java パッケージと同じロジックに従って決定されます。たとえば、stuff/java/foo/bar/a.txt のソースファイルは foo/bar/a.txt にあります。
runtime_deps	ラベルのリスト。デフォルトは [] です。 最終バイナリまたは実行時にのみテストで使用できるようにするライブラリ。通常の deps と同様に、これらはランタイム クラスパスに表示されますが、コンパイル時のクラスパスとは異なります。実行時にのみ必要な依存関係をここにリストします。依存関係分析ツールは、runtime_deps と deps の両方に存在するターゲットを無視する必要があります。

java_lite_proto_library

ルールのソースを表示

java_lite_proto_library(name, deps, data, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, licenses, restricted_to, tags, target_compatible_with, testonly, visibility)

java_lite_proto_library は、.proto ファイルから Java コードを生成します。

deps は proto_library ルールを指す必要があります。

例:

java_library(
    name = "lib",
    deps = [":foo"],
)

java_lite_proto_library(
    name = "foo",
    deps = [":bar"],
)

proto_library(
    name = "bar",
)

引数

属性
name	名前（必須） このターゲットの一意の名前。
deps	ラベルのリスト。デフォルトは [] です。 Java コードの生成対象となる proto_library ルールのリスト。

java_proto_library

ルールのソースを表示

java_proto_library(name, deps, data, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, licenses, restricted_to, tags, target_compatible_with, testonly, visibility)

java_proto_library は、.proto ファイルから Java コードを生成します。

deps は proto_library ルールを指す必要があります。

例:

java_library(
    name = "lib",
    deps = [":foo_java_proto"],
)

java_proto_library(
    name = "foo_java_proto",
    deps = [":foo_proto"],
)

proto_library(
    name = "foo_proto",
)

引数

属性
name	名前（必須） このターゲットの一意の名前。
deps	ラベルのリスト。デフォルトは [] です。 Java コードの生成対象となる proto_library ルールのリスト。

java_test

ルールのソースを表示

java_test(name, deps, srcs, data, resources, args, classpath_resources, compatible_with, create_executable, deploy_manifest_lines, deprecation, distribs, env, env_inherit, exec_compatible_with, exec_properties, features, flaky, javacopts, jvm_flags, launcher, licenses, local, main_class, plugins, resource_jars, resource_strip_prefix, restricted_to, runtime_deps, shard_count, size, stamp, tags, target_compatible_with, test_class, testonly, timeout, toolchains, use_launcher, use_testrunner, visibility)

java_test() ルールは Java テストをコンパイルします。テストは、テストコードのバイナリラッパーです。テストランナーのメインメソッドが、コンパイルされるメインクラスの代わりに呼び出されます。

暗黙的な出力ターゲット

• name.jar: Java アーカイブ。
• name_deploy.jar: デプロイに適した Java アーカイブ。（明示的にリクエストされた場合にのみビルドされます）。詳細については、java_binary からの name_deploy.jar 出力の説明をご覧ください。

java_binary() 引数のセクションをご覧ください。このルールは、すべてのテストルールに共通する属性（*_test）もすべてサポートします。

例

java_library(
    name = "tests",
    srcs = glob(["*.java"]),
    deps = [
        "//java/com/foo/base:testResources",
        "//java/com/foo/testing/util",
    ],
)

java_test(
    name = "AllTests",
    size = "small",
    runtime_deps = [
        ":tests",
        "//util/mysql",
    ],
)

引数

属性
name	名前（必須） このターゲットの一意の名前。
deps	ラベルのリスト。デフォルトは [] です。 ターゲットにリンクする他のライブラリのリスト。deps に関する一般的なコメントについては、ほとんどのビルドルールで定義されている一般的な属性をご覧ください。
srcs	ラベルのリスト。デフォルトは [] です。 ターゲットを作成するために処理されるソースファイルのリスト。この属性はほとんどの場合必須です。下記の例外をご覧ください。 .java 型のソースファイルはコンパイルされます。生成された .java ファイルの場合、ファイル自体の名前ではなく、生成ルールの名前をここに入力することをおすすめします。これにより、読みやすさが向上するだけでなく、将来の変更に対するルールの復元力も高まります。生成ルールで今後異なるファイルが生成される場合でも、修正する必要があるのは生成ルールの outs のみです。生成ルールは NoOps であるため、deps にリストしないでください。 .srcjar 型のソースファイルは、展開されてコンパイルされます。（これは、genrule を含む .java ファイルのセットを生成する必要がある場合に便利です）。 ルール: ルール（通常は genrule または filegroup）が上記のファイルのいずれかを生成する場合、それらのファイルはソースファイルの場合と同じ方法で使用されます。 main_class 属性でランタイム クラスパスのクラスを指定する場合、または runtime_deps 引数を指定する場合を除き、この引数はほとんど常に必要です。
resources	ラベルのリスト。デフォルトは [] です。 Java jar に含めるデータファイルのリスト。 リソースが指定されている場合、コンパイルで生成される通常の .class ファイルとともに jar にバンドルされます。jar ファイル内のリソースの場所は、プロジェクト構造によって決まります。Bazel は最初に Maven の標準ディレクトリ レイアウトを探します（「src」ディレクトリの後に「resources」ディレクトリの孫が続きます）。見つからない場合、Bazel は「java」または「javatests」という名前の最上位のディレクトリを探します（たとえば、リソースが <workspace root>/x/java/y/java/z にある場合、リソースのパスは y/java/z になります）。このヒューリスティックはオーバーライドできませんが、resource_strip_prefix 属性を使用して、リソース ファイルに特定の代替ディレクトリを指定できます。 リソースには、ソースファイルまたは生成されたファイルを指定できます。
classpath_resources	ラベルのリスト。デフォルトは [] です。 他に方法がない場合以外は、このオプションを使用しないでください） Java ツリーのルートに配置する必要があるリソースのリスト。この属性の唯一の目的は、リソースを "myconfig.xml" としてクラスパス上で検出する必要があるサードパーティ ライブラリをサポートすることです。名前空間が競合する危険性があるため、バイナリでのみ許可され、ライブラリでは許可されません。
create_executable	ブール値、設定不可、デフォルトは True 非推奨です。代わりに java_single_jar を使用してください。
deploy_manifest_lines	文字列のリスト。デフォルトは [] です。 *_deploy.jar ターゲット用に生成された META-INF/manifest.mf ファイルに追加する行のリスト。この属性の内容は、「変数を作成」置換の対象になりません。
javacopts	文字列のリスト。デフォルトは [] です。 このライブラリの追加のコンパイラ オプション。 「変数を作成」の置換と Bourne シェルのトークン化が適用されます。 これらのコンパイラ オプションは、グローバル コンパイラ オプションの後に javac に渡されます。
jvm_flags	文字列のリスト。デフォルトは [] です。 このバイナリを実行するために生成されたラッパー スクリプトに埋め込むフラグのリスト。$(location) と「変数を作成」の置換、Bourne シェルのトークン化が適用されます。 Java バイナリのラッパー スクリプトには、CLASSPATH 定義（依存するすべての jar を見つけるため）が含まれており、適切な Java インタープリタを呼び出します。ラッパー スクリプトによって生成されたコマンドラインでは、メインクラスの名前の後に "$@" が続くため、クラス名の後に他の引数を渡すことができます。ただし、JVM による解析を意図した引数は、コマンドラインのクラス名の前に指定する必要があります。jvm_flags の内容は、クラス名がリストされる前にラッパー スクリプトに追加されます。 この属性は *_deploy.jar の出力には作用しないことに注意してください。
launcher	ラベル: デフォルトは None JDK に含まれる通常の bin/java プログラムの代わりに、Java プログラムの実行に使用するバイナリを指定します。ターゲットは cc_binary にする必要があります。 Java Invocation API を実装するすべての cc_binary を、この属性の値として指定できます。 デフォルトでは、Bazel は通常の JDK ランチャー（bin/java または java.exe）を使用します。 関連する --java_launcher Bazel フラグは、launcher 属性を指定していない java_binary ターゲットと java_test ターゲットにのみ影響します。 ネイティブ（C++、SWIG、JNI）依存関係のビルドは、JDK ランチャーを使用しているか別のランチャーを使用しているかによって異なります。 通常の JDK ランチャー（デフォルト）を使用している場合、ネイティブ依存関係は {name}_nativedeps.so という名前の共有ライブラリとしてビルドされます。ここで、{name} はこの java_binary ルールの name 属性です。未使用のコードは、この構成のリンカーによって削除されません。 他のランチャーを使用している場合、ネイティブ（C++）依存関係は {name}_nativedeps という名前のバイナリに静的にリンクされます。ここで、{name} はこの java_binary ルールの name 属性です。この場合、リンカーは使用されていないと判断したコードを結果のバイナリから削除します。つまり、cc_library ターゲットで alwayslink = 1 を指定していない限り、JNI 経由でのみアクセスされる C++ コードはリンクできません。 デフォルトの JDK ランチャー以外のランチャーを使用する場合、*_deploy.jar 出力の形式が変更されます。詳細については、java_binary のメイン ドキュメントをご覧ください。
main_class	文字列。デフォルトは "" エントリ ポイントとして使用する main() メソッドを含むクラスの名前。ルールでこのオプションを使用する場合、srcs=[...] リストは必要ありません。したがって、この属性を使用すると、すでに 1 つ以上の main() メソッドが含まれている Java ライブラリから実行ファイルを作成できます。 この属性の値は、ソースファイルではなくクラス名です。このクラスは実行時に使用可能でなければなりません。このルールによって（srcs から）コンパイルすることも、直接的または推移的依存関係（runtime_deps または deps を使用）によって提供することもできます。クラスを使用できない場合、バイナリは実行時に失敗します。ビルド時のチェックは行われません。
plugins	ラベルのリスト。デフォルトは [] です。 コンパイル時に実行する Java コンパイラ プラグイン。このルールがビルドされるたびに、この属性で指定されたすべての java_plugin が実行されます。ライブラリは、exported_plugins を使用する依存関係からプラグインを継承することもできます。プラグインによって生成されたリソースは、このルールで生成される jar に含まれます。
resource_jars	ラベルのリスト。デフォルトは [] です。 非推奨: 代わりに java_import と deps または runtime_deps を使用してください。
resource_strip_prefix	文字列。デフォルトは "" Java リソースから削除するパス接頭辞。 指定すると、このパス接頭辞は resources 属性内のすべてのファイルから削除されます。リソース ファイルがこのディレクトリにない場合はエラーになります。指定しない場合（デフォルト）、リソース ファイルのパスはソースファイルの Java パッケージと同じロジックに従って決定されます。たとえば、stuff/java/foo/bar/a.txt のソースファイルは foo/bar/a.txt にあります。
runtime_deps	ラベルのリスト。デフォルトは [] です。 最終バイナリまたは実行時にのみテストで使用できるようにするライブラリ。通常の deps と同様に、これらはランタイム クラスパスに表示されますが、コンパイル時のクラスパスとは異なります。実行時にのみ必要な依存関係をここにリストします。依存関係分析ツールは、runtime_deps と deps の両方に存在するターゲットを無視する必要があります。
stamp	整数。デフォルトは 0 ビルド情報をバイナリにエンコードするかどうか。可能な値: stamp = 1: --nostamp ビルドであっても、常にビルド情報をバイナリにスタンプします。この設定はおすすめしません。バイナリとそれに依存するダウンストリーム アクションのリモート キャッシュが強制終了される可能性があるためです。 stamp = 0: ビルド情報を常に定数値に置き換えます。これにより、ビルド結果を適切にキャッシュに保存できます。 stamp = -1: ビルド情報の埋め込みは --[no]stamp フラグで制御されます。 スタンプされたバイナリは、依存関係が変更されない限り再ビルドされません。
test_class	文字列。デフォルトは "" テストランナーによって読み込まれる Java クラス。 デフォルトでは、この引数が定義されていない場合は以前のモードが使用され、代わりにテスト引数が使用されます。--nolegacy_bazel_java_test フラグを最初の引数でフォールバックされないように設定します。 この属性は、このテストで実行する Java クラスの名前を指定します。この設定が必要になることはほとんどありません。この引数を省略すると、ターゲットの name とそのソースルート相対パスを使用して推測されます。テストが既知のソースルートの外部にある場合、test_class が設定されていない場合、Bazel はエラーを報告します。 JUnit3 の場合、テストクラスは junit.framework.TestCase のサブクラスであるか、junit.framework.Test を返す静的 suite() メソッド（または Test のサブクラス）が必要です。JUnit4 の場合、クラスには org.junit.runner.RunWith アノテーションを付ける必要があります。 この属性を使用すると、複数の java_test ルールで同じ Test（TestCase、TestSuite など）を共有できます。通常、追加情報が（jvm_flags=['-Dkey=value'] などを介して）渡されるため、テストの異なるサブセットを実行するなど、その動作はケースごとに異なります。この属性により、javatests ツリーの外部で Java テストを使用することもできます。
use_launcher	ブール値。デフォルトは True です。 バイナリがカスタム ランチャーを使用するかどうか。 この属性を false に設定した場合、このターゲットでは launcher 属性と関連する --java_launcher フラグは無視されます。
use_testrunner	ブール値。デフォルトは True です。 テストランナー（デフォルトでは com.google.testing.junit.runner.BazelTestRunner）クラスを Java プログラムのメインのエントリ ポイントとして使用し、テストクラスをテストランナーに bazel.test_suite システム プロパティの値として提供します。 これにより、デフォルトの動作（java_test ルールにはテストランナーを使用し、java_binary ルールには使用しない）をオーバーライドできます。このような操作を行うことはほとんどありません。1 つの用途として、別のルールによって呼び出される AllTest ルールがあります（テストの実行前にデータベースを設定する場合など）。AllTest ルールは java_binary として宣言する必要がありますが、メインのエントリ ポイントとしてテストランナーを使用する必要があります。テストランナー クラスの名前は、main_class 属性でオーバーライドできます。

java_package_configuration

ルールのソースを表示

java_package_configuration(name, data, compatible_with, deprecation, distribs, features, javacopts, licenses, packages, restricted_to, tags, target_compatible_with, testonly, visibility)

一連のパッケージに適用する構成。構成は java_toolchain.javacopts に追加できます。

例:

java_package_configuration(
    name = "my_configuration",
    packages = [":my_packages"],
    javacopts = ["-Werror"],
)

package_group(
    name = "my_packages",
    packages = [
        "//com/my/project/...",
        "-//com/my/project/testing/...",
    ],
)

java_toolchain(
    ...,
    package_configuration = [
        ":my_configuration",
    ]
)

引数

属性
name	名前（必須） このターゲットの一意の名前。
data	ラベルのリスト。デフォルトは [] です。 実行時にこの構成で必要なファイルのリスト。
javacopts	文字列のリスト。デフォルトは [] です。 Java コンパイラ フラグ。
packages	ラベルのリスト。デフォルトは [] です。 構成を適用する必要がある package_group のセットです。

java_plugin

ルールのソースを表示

java_plugin(name, deps, srcs, data, resources, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, generates_api, javacopts, licenses, neverlink, output_licenses, plugins, processor_class, proguard_specs, resource_jars, resource_strip_prefix, restricted_to, tags, target_compatible_with, testonly, visibility)

java_plugin は、Bazel で実行される Java コンパイラのプラグインを定義します。現時点でサポートされているプラグインは、アノテーション プロセッサのみです。java_library ルールまたは java_binary ルールは、plugins 属性を介してプラグインに依存することで、プラグインを実行できます。java_library では、exported_plugins を使用して、プラグインを直接依存するライブラリに自動的にエクスポートすることもできます。

暗黙的な出力ターゲット

• libname.jar: Java アーカイブ。

processor_class 引数が追加されたことを除き、引数は java_library と同じです。

引数

属性
name	名前（必須） このターゲットの一意の名前。
deps	ラベルのリスト。デフォルトは [] です。 このライブラリにリンクするライブラリのリスト。 deps に関する一般的なコメントについては、ほとんどのビルドルールで定義されている一般的な属性をご覧ください。 deps にリストされている java_library ルールによってビルドされた JAR は、このルールのコンパイル時クラスパスになります。さらに、deps、runtime_deps、exports の推移的クロージャは、ランタイム クラスパスで行われます。 これに対して、data 属性内のターゲットは実行ファイルに含まれますが、コンパイル時クラスパスにもランタイム クラスパスにも組み込まれます。
srcs	ラベルのリスト。デフォルトは [] です。 ターゲットを作成するために処理されるソースファイルのリスト。この属性はほとんどの場合必須です。下記の例外をご覧ください。 .java 型のソースファイルはコンパイルされます。生成された .java ファイルの場合、ファイル自体の名前ではなく、生成ルールの名前をここに入力することをおすすめします。これにより、読みやすさが向上するだけでなく、将来の変更に対するルールの復元力も高まります。生成ルールで今後異なるファイルが生成される場合でも、修正する必要があるのは生成ルールの outs のみです。生成ルールは NoOps であるため、deps にリストしないでください。 .srcjar 型のソースファイルは、展開されてコンパイルされます。（これは、genrule を含む .java ファイルのセットを生成する必要がある場合に便利です）。 ルール: ルール（通常は genrule または filegroup）が上記のファイルのいずれかを生成する場合、それらのファイルはソースファイルの場合と同じ方法で使用されます。 main_class 属性でランタイム クラスパスのクラスを指定する場合、または runtime_deps 引数を指定する場合を除き、この引数はほとんど常に必要です。
data	ラベルのリスト。デフォルトは [] です。 実行時にこのライブラリが必要とするファイルのリスト。data に関する一般的なコメントについては、ほとんどのビルドルールで定義されている一般的な属性をご覧ください。 java_library をビルドする際、Bazel はこれらのファイルをどこにも配置しません。data ファイルが生成されると、Bazel によって生成されます。この java_library に依存するテストをビルドする場合、Bazel は data ファイルを runfile 領域にコピーまたはリンクします。
resources	ラベルのリスト。デフォルトは [] です。 Java jar に含めるデータファイルのリスト。 リソースが指定されている場合、コンパイルで生成される通常の .class ファイルとともに jar にバンドルされます。jar ファイル内のリソースの場所は、プロジェクト構造によって決まります。Bazel は最初に Maven の標準ディレクトリ レイアウトを探します（「src」ディレクトリの後に「resources」ディレクトリの孫が続きます）。見つからない場合、Bazel は「java」または「javatests」という名前の最上位のディレクトリを探します（たとえば、リソースが <workspace root>/x/java/y/java/z にある場合、リソースのパスは y/java/z になります）。このヒューリスティックはオーバーライドできませんが、resource_strip_prefix 属性を使用して、リソース ファイルに特定の代替ディレクトリを指定できます。 リソースには、ソースファイルまたは生成されたファイルを指定できます。
generates_api	ブール値。デフォルトは False です。 この属性は、API コードを生成するアノテーション プロセッサをマークします。 ルールで API 生成のアノテーション プロセッサを使用している場合、そのルールに依存する他のルールは、生成ルールの後にコンパイル アクションがスケジュールされている場合にのみ、生成されたコードを参照できます。この属性は、--java_header_coding が有効になっている場合にスケジュール制約を導入するよう Bazel に指示します。 警告: この属性はビルドのパフォーマンスに影響します。必要な場合にのみ使用してください。
javacopts	文字列のリスト。デフォルトは [] です。 このライブラリの追加のコンパイラ オプション。 「変数を作成」の置換と Bourne シェルのトークン化が適用されます。 これらのコンパイラ オプションは、グローバル コンパイラ オプションの後に javac に渡されます。
neverlink	ブール値。デフォルトは False です。 このライブラリをコンパイルにのみ使用し、実行時は使用しないかどうか。 実行時にランタイム環境によってライブラリが提供される場合に便利です。そのようなライブラリの例としては、IDE プラグイン用の IDE API や、標準 JDK 上で実行されるもの用の tools.jar があります。 neverlink = 1 を指定しても、Java 言語仕様（String またはプリミティブ型の static final 定数など）。したがって、推奨されるユースケースは、ランタイム ライブラリがコンパイル ライブラリと同一である場合です。 ランタイム ライブラリがコンパイル ライブラリと異なる場合は、JLS でコンパイラのインライン化が禁止されている箇所のみが異なるようにする必要があります（また、JLS の今後のすべてのバージョンで保持する必要があります）。
output_licenses	ライセンスの種類（デフォルトは ["none"]） common attributes をご覧ください。
plugins	ラベルのリスト。デフォルトは [] です。 コンパイル時に実行する Java コンパイラ プラグイン。このルールがビルドされるたびに、この属性で指定されたすべての java_plugin が実行されます。ライブラリは、exported_plugins を使用する依存関係からプラグインを継承することもできます。プラグインによって生成されたリソースは、このルールで生成される jar に含まれます。
processor_class	文字列。デフォルトは "" プロセッサ クラスは、Java コンパイラがアノテーション プロセッサのエントリ ポイントとして使用する必要があるクラスの完全修飾型です。指定しない場合、このルールはアノテーション プロセッサを Java コンパイラのアノテーション処理に提供しませんが、ランタイム クラスパスはコンパイラのアノテーション プロセッサ パスに含まれます。（これは主に、 java.util.ServiceLoader を使用してアノテーション プロセッサのパスから読み込まれる Error Prone プラグインによる使用を想定しています）。
proguard_specs	ラベルのリスト。デフォルトは [] です。 ProGuard 仕様として使用されるファイル。ここでは、Proguard で使用される一連の仕様について説明します。指定すると、このライブラリに応じて任意の android_binary ターゲットに追加されます。 ここに含めるファイルには、べき等ルール（-dontnote、-dontwarn、confirmnosideeffects、-keep で始まるルール）のみを含める必要があります。他のオプションは、非自動的マージを保証するために、android_binary の proguard_specs でのみ指定できます。
resource_jars	ラベルのリスト。デフォルトは [] です。 非推奨: 代わりに java_import と deps または runtime_deps を使用してください。
resource_strip_prefix	文字列。デフォルトは "" Java リソースから削除するパス接頭辞。 指定すると、このパス接頭辞は resources 属性内のすべてのファイルから削除されます。リソース ファイルがこのディレクトリにない場合はエラーになります。指定しない場合（デフォルト）、リソース ファイルのパスはソースファイルの Java パッケージと同じロジックに従って決定されます。たとえば、stuff/java/foo/bar/a.txt のソースファイルは foo/bar/a.txt にあります。

java_runtime

ルールのソースを表示

java_runtime(name, srcs, compatible_with, default_cds, deprecation, distribs, features, hermetic_srcs, java, java_home, lib_ct_sym, lib_modules, licenses, restricted_to, tags, target_compatible_with, testonly, version, visibility)

Java ランタイムの構成を指定します。

例:

java_runtime(
    name = "jdk-9-ea+153",
    srcs = glob(["jdk9-ea+153/**"]),
    java_home = "jdk9-ea+153",
)

引数

属性
name	名前（必須） このターゲットの一意の名前。
srcs	ラベルのリスト。デフォルトは [] です。 ランタイム内のすべてのファイル。
default_cds	ラベル: デフォルトは None 密閉型の java_runtime のデフォルトの CDS アーカイブ。java_binary ターゲットで密閉型が有効になっていて、classlist 属性を指定してターゲットが独自の CDS アーカイブを提供しない場合、java_runtime のデフォルト CDS は密閉型デプロイ JAR にパッケージ化されます。
hermetic_srcs	ラベルのリスト。デフォルトは [] です。 密閉型のデプロイに必要なランタイム内のファイル。
java	ラベル: デフォルトは None Java 実行可能ファイルのパス。
java_home	文字列。デフォルトは "" ランタイムのルートのパス。「Make」変数の置換が適用されます。このパスが絶対パスの場合、ルールは、既知のパスを持つ非密閉型の Java ランタイムを示します。その場合、srcs 属性と java 属性を空にする必要があります。
lib_ct_sym	ラベル: デフォルトは None --release でのコンパイルに必要な lib/ct.sym ファイル。指定せず、パスが /lib/ct.sym で終わるファイルが srcs 内に 1 つだけの場合は、そのファイルが使用されます。
lib_modules	ラベル: デフォルトは None 密閉型のデプロイに必要な lib/modules ファイル。
version	整数。デフォルトは 0 Java ランタイムの機能バージョン。つまり、Runtime.version().feature() によって返される整数です。

java_toolchain

ルールのソースを表示

java_toolchain(name, android_lint_data, android_lint_jvm_opts, android_lint_opts, android_lint_package_configuration, android_lint_runner, bootclasspath, compatible_with, deprecation, deps_checker, distribs, features, forcibly_disable_header_compilation, genclass, header_compiler, header_compiler_direct, ijar, jacocorunner, java_runtime, javabuilder, javabuilder_data, javabuilder_jvm_opts, javac_supports_multiplex_workers, javac_supports_workers, javacopts, jvm_opts, licenses, oneversion, oneversion_allowlist_for_tests, oneversion_whitelist, package_configuration, proguard_allowlister, resourcejar, restricted_to, singlejar, source_version, tags, target_compatible_with, target_version, testonly, timezone_data, tools, turbine_data, turbine_jvm_opts, visibility, xlint)

Java コンパイラの設定を指定します。使用するツールチェーンは、--java_ツールチェーン 引数で変更できます。通常、Java コンパイラを調整する場合を除き、このようなルールを作成しないでください。

例

簡単な例を次に示します。

java_toolchain(
    name = "toolchain",
    source_version = "7",
    target_version = "7",
    bootclasspath = ["//tools/jdk:bootclasspath"],
    xlint = [ "classfile", "divzero", "empty", "options", "path" ],
    javacopts = [ "-g" ],
    javabuilder = ":JavaBuilder_deploy.jar",
)

引数

属性
name	名前（必須） このターゲットの一意の名前。
android_lint_data	ラベルのリスト。デフォルトは [] です。 android_lint_jvm_opts でのラベル拡張に使用できるツールのラベル。
android_lint_jvm_opts	文字列のリスト。デフォルトは [] です。 Android Lint を呼び出すときの JVM の引数のリスト。
android_lint_opts	文字列のリスト。デフォルトは [] です。 Android Lint 引数のリスト。
android_lint_package_configuration	ラベルのリスト。デフォルトは [] です。 指定したパッケージ グループに適用する必要がある Android Lint 設定。
android_lint_runner	ラベル: デフォルトは None Android Lint ランナーのラベル（ある場合）。
bootclasspath	ラベルのリスト。デフォルトは [] です。 Java ターゲットの bootclasspath エントリ。javac の -bootclasspath フラグに対応します。
deps_checker	ラベルのリスト。デフォルトは [] です。 ImportDepsChecker デプロイ JAR のラベル。
forcibly_disable_header_compilation	ブール値。デフォルトは False です。 --java_header_coding をオーバーライドして、JDK 7 Bazel などをサポートしていないプラットフォーム（JDK 7 Bazel など）でヘッダーのコンパイルを無効にします。
genclass	ラベルのリスト。必須 GenClass deploy JAR のラベル。
header_compiler	ラベルのリスト。デフォルトは [] です。 ヘッダー コンパイラのラベル。--java_header_compile が有効な場合は必須です。
header_compiler_direct	ラベルのリスト。デフォルトは [] です。 API 生成のアノテーション プロセッサを含まないダイレクト クラスパス アクションに使用するヘッダー コンパイラのオプションのラベル。 このツールはアノテーション処理をサポートしていません。
ijar	ラベルのリスト。必須 ijar 実行可能ファイルのラベル。
jacocorunner	ラベル: デフォルトは None JacocoCoverageRunner デプロイ jar のラベル。
java_runtime	ラベル（必須） このツールチェーンで使用する java_runtime。実行構成のデフォルトは java_runtime です。
javabuilder	ラベルのリスト。必須 JavaBuilder デプロイ JAR のラベル。
javabuilder_data	ラベルのリスト。デフォルトは [] です。 javabuilder_jvm_opts のラベル拡張に使用できるデータのラベル。
javabuilder_jvm_opts	文字列のリスト。デフォルトは [] です。 JavaBuilder を呼び出すときの JVM の引数のリスト。
javac_supports_multiplex_workers	ブール値。デフォルトは True です。 JavaBuilder が多重化永続ワーカーとしての実行をサポートしている場合は true、サポートしていない場合は false。
javac_supports_workers	ブール値。デフォルトは True です。 JavaBuilder が永続ワーカーとしての実行をサポートしている場合は true、サポートしていない場合は false。
javacopts	文字列のリスト。デフォルトは [] です。 Java コンパイラの追加引数のリスト。Java コンパイラ フラグの詳細なリストについては、Java コンパイラのドキュメントをご覧ください。
jvm_opts	文字列のリスト。デフォルトは [] です。 Java コンパイラを呼び出すときの JVM の引数のリスト。このオプションで指定できるフラグの詳細なリストについては、Java 仮想マシンのドキュメントをご覧ください。
oneversion	ラベル: デフォルトは None 1 バージョンの適用バイナリのラベル。
oneversion_allowlist_for_tests	ラベル: デフォルトは None テスト用の 1 つのバージョンの許可リストのラベル。
oneversion_whitelist	ラベル: デフォルトは None 1 つのバージョンのホワイトリストのラベル。
package_configuration	ラベルのリスト。デフォルトは [] です。 指定したパッケージ グループに適用する必要がある構成。
proguard_allowlister	ラベル: デフォルトは "@bazel_tools//tools/jdk:proguard_whitelister" ProGuard 許可リスト者のラベル。
resourcejar	ラベルのリスト。デフォルトは [] です。 リソース JAR ビルダー実行可能ファイルのラベル。
singlejar	ラベルのリスト。必須 SingleJar デプロイ JAR のラベル。
source_version	文字列。デフォルトは "" Java ソース バージョン（「6」や「7」）。Java ソースコードで使用できるコード構造のセットを指定します。
target_version	文字列。デフォルトは "" Java のターゲット バージョン（「6」や「7」）。クラスをビルドする Java ランタイムを指定します。
timezone_data	ラベル: デフォルトは None タイムゾーン データを含むリソース JAR のラベル。設定すると、タイムゾーン データはすべての java_binary ルールのランタイム依存関係として暗黙的に追加されます。
tools	ラベルのリスト。デフォルトは [] です。 jvm_opts でのラベル拡張に使用できるツールのラベル。
turbine_data	ラベルのリスト。デフォルトは [] です。 turbine_jvm_opts でのラベル拡張に使用できるデータのラベル。
turbine_jvm_opts	文字列のリスト。デフォルトは [] です。 タービン呼び出し時の JVM の引数のリスト。
xlint	文字列のリスト。デフォルトは [] です。 デフォルトのリストに対して追加または削除する警告のリスト。削除するには、その前にダッシュを付けます。詳細については、-Xlint オプションに関する Javac のドキュメントをご覧ください。