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 ファイルを含むクラスパスを使用します。

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

暗黙的な出力ターゲット

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

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

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

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

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

srcs を指定しないと、java_binary ルールで deps 属性は使用できません。このようなルールには、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

Name; required

このターゲットの一意の名前。


アプリのメイン エントリ ポイントであるソースファイルの名前（拡張子を除く）を使用することをおすすめします。たとえば、エントリ ポイントの名前が Main.java の場合、名前は Main になります。
deps

List of labels; optional

ターゲットにリンクする他のライブラリのリスト。ほとんどのビルドルールによって定義される一般的な属性で、deps に関する一般的なコメントをご覧ください。
srcs

List of labels; optional

ターゲットを作成するために処理されたソースファイルのリスト。この属性はほとんどの場合必須です。下記の例外をご覧ください。

.java タイプのソースファイルはコンパイルされます。.java ファイルが生成される場合、一般的に、ファイルの名前ではなく、生成ルールの名前をここに入力することをおすすめします。これにより、可読性が向上するだけでなく、将来の変更に対するルールの復元力も向上します。つまり、生成ルールで今後異なるファイルが生成された場合でも、生成ルールの outs を修正すれば済みます。これは何もしないため、deps に生成ルールを含めないでください。

.srcjar タイプのソースファイルは、解凍されてコンパイルされます。（これは、genrule を使用して一連の .java ファイルを生成する必要がある場合に便利です）。

ルール: ルール（通常は genrule または filegroup）によって上記のファイルのいずれかが生成される場合、そのルールはソースファイルの場合と同じ方法で使用されます。

この引数は、main_class 属性がランタイム クラスパス上のクラスを指定する場合、または runtime_deps 引数を指定する場合を除き、ほとんどの場合必要です。
resources

List of labels; optional

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

List of labels; optional

他に方法がない場合を除き、このオプションは使用しないでください）

Java ツリーのルートに配置する必要があるリソースのリスト。この属性の唯一の目的は、リソースがクラスパス上で "myconfig.xml" のとおりに見つかる必要があるサードパーティ ライブラリをサポートすることです。これは名前空間の競合のリスクがあるため、バイナリでのみ許可され、ライブラリでは許可されません。
create_executable

Boolean; optional; nonconfigurable; default is True

バイナリが実行可能かどうか。非実行バイナリは、推移的なランタイム Java 依存関係を deploy jar に収集しますが、直接実行することはできません。この属性が設定されている場合、ラッパー スクリプトは作成されません。launcher 属性または main_class 属性が設定されている場合、この値を 0 に設定するとエラーになります。
deploy_env

List of labels; optional

このバイナリのデプロイ環境を表す他の java_binary ターゲットのリスト。別の java_binary によって読み込まれるプラグインをビルドする場合は、この属性を設定します。
この属性を設定すると、このバイナリと deploy_env で指定されたターゲットの間で共有される、このバイナリのランタイム クラスパス（および deploy jar）から、すべての依存関係が除外されます。
deploy_manifest_lines

List of strings; optional

*_deploy.jar ターゲット用に生成された META-INF/manifest.mf ファイルに追加する行のリスト。この属性の内容は「Make variable」置換の対象になりません。
javacopts

List of strings; optional

このライブラリの追加のコンパイラ オプション。 "Make variable" 置換と Bourne シェルトークン化が適用されます。

これらのコンパイラ オプションは、グローバル コンパイラ オプションの後で javac に渡されます。
jvm_flags

List of strings; optional

このバイナリを実行するために生成されたラッパー スクリプトに埋め込むフラグのリスト。 $(location) と "Make variable" の置換、Bourne シェルのトークン化が適用されます。

Java バイナリのラッパー スクリプトには、CLASSPATH 定義が含まれており（依存する jar をすべて検索するため）、適切な Java インタープリタを呼び出します。ラッパー スクリプトによって生成されたコマンドラインでは、メインクラスの名前の後に "$@" が続くため、クラス名の後に他の引数を渡すことができます。ただし、JVM で解析する引数は、コマンドラインでクラス名の前に指定する必要があります。jvm_flags の内容は、クラス名がリストされる前にラッパー スクリプトに追加されます。

この属性は *_deploy.jar の出力には影響しません。
launcher

Label; optional

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 属性です。この場合、リンカーは使用されていないと思われるコードを結果のバイナリから削除します。つまり、JNI 経由でのみアクセスされる C++ コードは、cc_library ターゲットで alwayslink = 1 を指定しない限り、リンクされません。

デフォルトの JDK ランチャー以外のランチャーを使用すると、*_deploy.jar 出力の形式が変わります。詳細については、java_binary のメインのドキュメントをご覧ください。
main_class

String; optional

エントリ ポイントとして使用する main() メソッドを持つクラスの名前。このオプションを使用するルールの場合、srcs=[...] リストは必要ありません。したがって、この属性を使用すると、すでに 1 つ以上の main() メソッドが含まれている Java ライブラリから実行ファイルを作成できます。

この属性の値は、ソースファイルではなくクラス名です。このクラスは実行時に使用可能である必要があります。このルールによって（srcs から）コンパイルされるか、直接または推移的な依存関係（runtime_deps または deps を介して）によって提供されます。クラスを使用できない場合、バイナリは実行時に失敗します。ビルド時のチェックは行われません。

plugins

List of labels; optional

コンパイル時に実行する Java コンパイラ プラグイン。 このルールがビルドされるたびに、この属性で指定されたすべての java_plugin が実行されます。ライブラリは、exported_plugins を使用する依存関係からプラグインを継承することもできます。プラグインによって生成されたリソースは、このルールで生成される JAR に含まれます。
resource_jars

List of labels; optional

非推奨: 代わりに java_import と deps または runtime_deps を使用してください。
resource_strip_prefix

String; optional

Java リソースから削除するパス プレフィックス。

指定すると、このパス接頭辞は resources 属性内のすべてのファイルから削除されます。リソース ファイルがこのディレクトリにないとエラーになります。指定しない場合（デフォルト）、リソース ファイルのパスは、ソースファイルの Java パッケージと同じロジックに従って決定されます。たとえば、stuff/java/foo/bar/a.txt のソースファイルは foo/bar/a.txt に配置されます。
runtime_deps

List of labels; optional

最終バイナリまたは実行時にのみテストで使用できるようにするライブラリ。 通常の deps と同様に、実行時クラスパスに現れますが、コンパイル時クラスパスには含まれません。実行時にのみ必要な依存関係をここにリストしてください。依存関係分析ツールは、runtime_deps と deps の両方に存在するターゲットを無視する必要があります。
stamp

Integer; optional; default is -1

ビルド情報をバイナリにエンコードするかどうか。取得される値は次のとおりです。
  • stamp = 1: --nostamp ビルドの場合でも、常にビルド情報をバイナリにスタンプします。この設定は、バイナリとそれに依存するダウンストリーム アクションのリモート キャッシュを強制終了する可能性があるため、使用しないでください。
  • stamp = 0: ビルド情報を常に定数値に置き換えます。これにより、良好なビルド結果のキャッシュ保存ができます。
  • stamp = -1: ビルド情報の埋め込みは --[no]stamp フラグで制御されます。

依存関係が変更されない限り、スタンプされたバイナリは再ビルドされません。
use_launcher

Boolean; optional; default is True

バイナリがカスタム ランチャーを使用するかどうかを指定します。

この属性を false に設定した場合、launcher 属性と関連する --java_launcher フラグがこのターゲットで無視されます。

use_testrunner

Boolean; optional; default is 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

Name; required

このターゲットの一意の名前。
deps

List of labels; optional

ターゲットにリンクする他のライブラリのリスト。java_library.deps をご覧ください。
constraints

List of strings; optional; nonconfigurable

Java ライブラリとしてこのルールに適用される追加の制約。
exports

List of labels; optional

このルールのユーザーが利用できるようにするターゲット。 java_library.exports をご覧ください。
jars

List of labels; required

このターゲットに依存する Java ターゲットに提供される JAR ファイルのリスト。

Boolean; optional; default is False

このライブラリはコンパイルにのみ使用し、実行時は使用しません。 実行中にランタイム環境からライブラリが提供される場合に便利です。このようなライブラリの例としては、IDE プラグイン用の IDE API や、標準 JDK で実行されるもの用の tools.jar などがあります。
proguard_specs

List of labels; optional

Proguard 仕様として使用するファイル。ここには、ProGuard が使用する仕様のセットを記述します。指定すると、このライブラリに応じて、任意の android_binary ターゲットに追加されます。 ここに記述するファイルには、べき等のルール（-dontnote、-dontwarn、前提条件なし、-keep で始まるルール）のみが含まれている必要があります。他のオプションは、非相互論理的結合を確実にするために、android_binary の proguard_specs にのみ指定できます。
runtime_deps

List of labels; optional

最終バイナリまたは実行時にのみテストで使用できるようにするライブラリ。 java_library.runtime_deps をご覧ください。
srcjar

Label; optional

コンパイルされた 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: ソースを含むアーカイブ（「source jar」）。

引数

属性
name

Name; required

このターゲットの一意の名前。
deps

List of labels; optional

このライブラリにリンクするライブラリのリスト。 ほとんどのビルドルールによって定義される一般的な属性の deps に関する一般的なコメントをご覧ください。

deps にリストされている java_library ルールによってビルドされた JAR は、このルールのコンパイル時クラスパスに配置されます。さらに、deps、runtime_deps、exports の推移的クロージャがランタイム クラスパス上にあります。

一方、data 属性のターゲットは実行ファイルに含まれますが、コンパイル時クラスパスにもランタイム クラスパスにも含まれません。

srcs

List of labels; optional

ターゲットを作成するために処理されたソースファイルのリスト。この属性はほとんどの場合必須です。下記の例外をご覧ください。

.java タイプのソースファイルはコンパイルされます。.java ファイルが生成される場合、一般的に、ファイルの名前ではなく、生成ルールの名前をここに入力することをおすすめします。これにより、可読性が向上するだけでなく、将来の変更に対するルールの復元力も向上します。つまり、生成ルールで今後異なるファイルが生成された場合でも、生成ルールの outs を修正すれば済みます。これは何もしないため、deps に生成ルールを含めないでください。

.srcjar タイプのソースファイルは、解凍されてコンパイルされます。（これは、genrule を使用して一連の .java ファイルを生成する必要がある場合に便利です）。

ルール: ルール（通常は genrule または filegroup）によって上記のファイルのいずれかが生成される場合、そのルールはソースファイルの場合と同じ方法で使用されます。

この引数は、main_class 属性がランタイム クラスパス上のクラスを指定する場合、または runtime_deps 引数を指定する場合を除き、ほとんどの場合必要です。
data

List of labels; optional

このライブラリが実行時に必要とするファイルのリスト。 ほとんどのビルドルールによって定義される一般的な属性の data に関する一般的なコメントをご覧ください。

java_library をビルドする場合、Bazel はこれらのファイルをどこにも配置しません。data ファイルが生成されると、Bazel がそのファイルを生成します。この java_library Bazel に依存するテストをビルドする場合、runfile 領域に data ファイルをコピーまたはリンクします。

resources

List of labels; optional

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

List of labels; optional

このライブラリに直接依存するライブラリにエクスポートする java_plugin（アノテーション プロセッサなど）のリスト。

指定された java_plugin のリストは、ライブラリが plugins でこれらのラベルを明示的に宣言した場合と同様に、このライブラリに直接依存するすべてのライブラリに適用されます。

exports

List of labels; optional

エクスポートされたライブラリ

ここでルールをリストすることで、親がルールに明示的に依存しているかのように、親ルールでそれらのルールを使用できるようになります。これは、通常の（エクスポートされていない）deps には当てはまりません。

要約: ルール X は、エッジの間に deps エッジで始まり、その後に 0 個以上のエッジが続くexports Y の依存関係パスが存在する場合、そのコードにアクセスできます。例をいくつか見てみましょう。

A が B に依存し、B が C に依存しているとします。この場合、C は A の推移的な依存関係であるため、C のソースを変更して A を再構築すると、すべてが正しく再構築されます。ただし、A は C のクラスを使用できません。これを可能にするには、A が deps で C を宣言する必要があります。または、B の exports 属性で C を宣言することで、B が A（および A に依存するすべてのもの）を簡単に行えるようにします。

エクスポートされたライブラリのクローズは、直接の親のルールすべてで使用できます。少し異なる例を考えてみましょう。A は B に依存し、B は C と D に依存し、C もエクスポートしますが D はエクスポートしません。これで、A は C にアクセスできますが、D にはアクセスできません。C と D がそれぞれ C' と D' のいくつかのライブラリをエクスポートした場合、A は C' にのみアクセスでき、D' にはアクセスできません。

重要: エクスポートされたルールは通常の依存関係ではありません。前の例で言うと、B が C をエクスポートし、B も C を使用する場合は、その B も自身の deps 内でリストする必要があります。
javacopts

List of strings; optional

このライブラリの追加のコンパイラ オプション。 "Make variable" 置換と Bourne シェルトークン化が適用されます。

これらのコンパイラ オプションは、グローバル コンパイラ オプションの後で javac に渡されます。

Boolean; optional; default is False

このライブラリを実行時にではなくコンパイルにのみ使用するかどうかを指定します。実行中にランタイム環境からライブラリが提供される場合に便利です。このようなライブラリの例としては、IDE プラグイン用の IDE API や、標準 JDK で実行されるもの用の tools.jar などがあります。

なお、neverlink = 1 を指定しても、Java 言語仕様（String またはプリミティブ型の static final 定数）。したがって、推奨のユースケースは、ランタイム ライブラリがコンパイル ライブラリと同一である場合です。

ランタイム ライブラリがコンパイル ライブラリと異なる場合は、JLS がコンパイラによるインラインの禁止を行う場所（かつ、JLS の今後のすべてのバージョンで保持する必要がある場所）のみが異なることを確認する必要があります。
plugins

List of labels; optional

コンパイル時に実行する Java コンパイラ プラグイン。 このルールがビルドされるたびに、この属性で指定されたすべての java_plugin が実行されます。ライブラリは、exported_plugins を使用する依存関係からプラグインを継承することもできます。プラグインによって生成されたリソースは、このルールで生成される JAR に含まれます。
proguard_specs

List of labels; optional

Proguard 仕様として使用するファイル。ここには、ProGuard が使用する仕様のセットを記述します。指定すると、このライブラリに応じて、任意の android_binary ターゲットに追加されます。 ここに記述するファイルには、べき等のルール（-dontnote、-dontwarn、前提条件なし、-keep で始まるルール）のみが含まれている必要があります。他のオプションは、非相互論理的結合を確実にするために、android_binary の proguard_specs にのみ指定できます。
resource_jars

List of labels; optional

非推奨: 代わりに java_import と deps または runtime_deps を使用してください。
resource_strip_prefix

String; optional

Java リソースから削除するパス プレフィックス。

指定すると、このパス接頭辞は resources 属性内のすべてのファイルから削除されます。リソース ファイルがこのディレクトリにないとエラーになります。指定しない場合（デフォルト）、リソース ファイルのパスは、ソースファイルの Java パッケージと同じロジックに従って決定されます。たとえば、stuff/java/foo/bar/a.txt のソースファイルは foo/bar/a.txt に配置されます。
runtime_deps

List of labels; optional

最終バイナリまたは実行時にのみテストで使用できるようにするライブラリ。 通常の 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

Name; required

このターゲットの一意の名前。
deps

List of labels; optional

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

Name; required

このターゲットの一意の名前。
deps

List of labels; optional

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

Name; required

このターゲットの一意の名前。
deps

List of labels; optional

ターゲットにリンクする他のライブラリのリスト。ほとんどのビルドルールによって定義される一般的な属性で、deps に関する一般的なコメントをご覧ください。
srcs

List of labels; optional

ターゲットを作成するために処理されたソースファイルのリスト。この属性はほとんどの場合必須です。下記の例外をご覧ください。

.java タイプのソースファイルはコンパイルされます。.java ファイルが生成される場合、一般的に、ファイルの名前ではなく、生成ルールの名前をここに入力することをおすすめします。これにより、可読性が向上するだけでなく、将来の変更に対するルールの復元力も向上します。つまり、生成ルールで今後異なるファイルが生成された場合でも、生成ルールの outs を修正すれば済みます。これは何もしないため、deps に生成ルールを含めないでください。

.srcjar タイプのソースファイルは、解凍されてコンパイルされます。（これは、genrule を使用して一連の .java ファイルを生成する必要がある場合に便利です）。

ルール: ルール（通常は genrule または filegroup）によって上記のファイルのいずれかが生成される場合、そのルールはソースファイルの場合と同じ方法で使用されます。

この引数は、main_class 属性がランタイム クラスパス上のクラスを指定する場合、または runtime_deps 引数を指定する場合を除き、ほとんどの場合必要です。
resources

List of labels; optional

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

List of labels; optional

他に方法がない場合を除き、このオプションは使用しないでください）

Java ツリーのルートに配置する必要があるリソースのリスト。この属性の唯一の目的は、リソースがクラスパス上で "myconfig.xml" のとおりに見つかる必要があるサードパーティ ライブラリをサポートすることです。これは名前空間の競合のリスクがあるため、バイナリでのみ許可され、ライブラリでは許可されません。
create_executable

Boolean; optional; nonconfigurable; default is True

バイナリが実行可能かどうか。非実行バイナリは、推移的なランタイム Java 依存関係を deploy jar に収集しますが、直接実行することはできません。この属性が設定されている場合、ラッパー スクリプトは作成されません。launcher 属性または main_class 属性が設定されている場合、この値を 0 に設定するとエラーになります。
deploy_manifest_lines

List of strings; optional

*_deploy.jar ターゲット用に生成された META-INF/manifest.mf ファイルに追加する行のリスト。この属性の内容は「Make variable」置換の対象になりません。
javacopts

List of strings; optional

このライブラリの追加のコンパイラ オプション。 "Make variable" 置換と Bourne シェルトークン化が適用されます。

これらのコンパイラ オプションは、グローバル コンパイラ オプションの後で javac に渡されます。
jvm_flags

List of strings; optional

このバイナリを実行するために生成されたラッパー スクリプトに埋め込むフラグのリスト。 $(location) と "Make variable" の置換、Bourne シェルのトークン化が適用されます。

Java バイナリのラッパー スクリプトには、CLASSPATH 定義が含まれており（依存する jar をすべて検索するため）、適切な Java インタープリタを呼び出します。ラッパー スクリプトによって生成されたコマンドラインでは、メインクラスの名前の後に "$@" が続くため、クラス名の後に他の引数を渡すことができます。ただし、JVM で解析する引数は、コマンドラインでクラス名の前に指定する必要があります。jvm_flags の内容は、クラス名がリストされる前にラッパー スクリプトに追加されます。

この属性は *_deploy.jar の出力には影響しません。
launcher

Label; optional

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 属性です。この場合、リンカーは使用されていないと思われるコードを結果のバイナリから削除します。つまり、JNI 経由でのみアクセスされる C++ コードは、cc_library ターゲットで alwayslink = 1 を指定しない限り、リンクされません。

デフォルトの JDK ランチャー以外のランチャーを使用すると、*_deploy.jar 出力の形式が変わります。詳細については、java_binary のメインのドキュメントをご覧ください。
main_class

String; optional

エントリ ポイントとして使用する main() メソッドを持つクラスの名前。このオプションを使用するルールの場合、srcs=[...] リストは必要ありません。したがって、この属性を使用すると、すでに 1 つ以上の main() メソッドが含まれている Java ライブラリから実行ファイルを作成できます。

この属性の値は、ソースファイルではなくクラス名です。このクラスは実行時に使用可能である必要があります。このルールによって（srcs から）コンパイルされるか、直接または推移的な依存関係（runtime_deps または deps を介して）によって提供されます。クラスを使用できない場合、バイナリは実行時に失敗します。ビルド時のチェックは行われません。

plugins

List of labels; optional

コンパイル時に実行する Java コンパイラ プラグイン。 このルールがビルドされるたびに、この属性で指定されたすべての java_plugin が実行されます。ライブラリは、exported_plugins を使用する依存関係からプラグインを継承することもできます。プラグインによって生成されたリソースは、このルールで生成される JAR に含まれます。
resource_jars

List of labels; optional

非推奨: 代わりに java_import と deps または runtime_deps を使用してください。
resource_strip_prefix

String; optional

Java リソースから削除するパス プレフィックス。

指定すると、このパス接頭辞は resources 属性内のすべてのファイルから削除されます。リソース ファイルがこのディレクトリにないとエラーになります。指定しない場合（デフォルト）、リソース ファイルのパスは、ソースファイルの Java パッケージと同じロジックに従って決定されます。たとえば、stuff/java/foo/bar/a.txt のソースファイルは foo/bar/a.txt に配置されます。
runtime_deps

List of labels; optional

最終バイナリまたは実行時にのみテストで使用できるようにするライブラリ。 通常の deps と同様に、実行時クラスパスに現れますが、コンパイル時クラスパスには含まれません。実行時にのみ必要な依存関係をここにリストしてください。依存関係分析ツールは、runtime_deps と deps の両方に存在するターゲットを無視する必要があります。
stamp

Integer; optional; default is 0

ビルド情報をバイナリにエンコードするかどうか。取得される値は次のとおりです。
  • stamp = 1: --nostamp ビルドの場合でも、常にビルド情報をバイナリにスタンプします。この設定は、バイナリとそれに依存するダウンストリーム アクションのリモート キャッシュを強制終了する可能性があるため、使用しないでください。
  • stamp = 0: ビルド情報を常に定数値に置き換えます。これにより、良好なビルド結果のキャッシュ保存ができます。
  • stamp = -1: ビルド情報の埋め込みは --[no]stamp フラグで制御されます。

依存関係が変更されない限り、スタンプされたバイナリは再ビルドされません。
test_class

String; optional

テストランナーによって読み込まれる 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

Boolean; optional; default is True

バイナリがカスタム ランチャーを使用するかどうかを指定します。

この属性を false に設定した場合、launcher 属性と関連する --java_launcher フラグがこのターゲットで無視されます。

use_testrunner

Boolean; optional; default is 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

Name; required

このターゲットの一意の名前。
data

List of labels; optional

この構成が実行時に必要となるファイルのリスト。
javacopts

List of strings; optional

Java コンパイラ フラグ。
packages

List of labels; optional

構成を適用する 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

Name; required

このターゲットの一意の名前。
deps

List of labels; optional

このライブラリにリンクするライブラリのリスト。 ほとんどのビルドルールによって定義される一般的な属性の deps に関する一般的なコメントをご覧ください。

deps にリストされている java_library ルールによってビルドされた JAR は、このルールのコンパイル時クラスパスに配置されます。さらに、deps、runtime_deps、exports の推移的クロージャがランタイム クラスパス上にあります。

一方、data 属性のターゲットは実行ファイルに含まれますが、コンパイル時クラスパスにもランタイム クラスパスにも含まれません。

srcs

List of labels; optional

ターゲットを作成するために処理されたソースファイルのリスト。この属性はほとんどの場合必須です。下記の例外をご覧ください。

.java タイプのソースファイルはコンパイルされます。.java ファイルが生成される場合、一般的に、ファイルの名前ではなく、生成ルールの名前をここに入力することをおすすめします。これにより、可読性が向上するだけでなく、将来の変更に対するルールの復元力も向上します。つまり、生成ルールで今後異なるファイルが生成された場合でも、生成ルールの outs を修正すれば済みます。これは何もしないため、deps に生成ルールを含めないでください。

.srcjar タイプのソースファイルは、解凍されてコンパイルされます。（これは、genrule を使用して一連の .java ファイルを生成する必要がある場合に便利です）。

ルール: ルール（通常は genrule または filegroup）によって上記のファイルのいずれかが生成される場合、そのルールはソースファイルの場合と同じ方法で使用されます。

この引数は、main_class 属性がランタイム クラスパス上のクラスを指定する場合、または runtime_deps 引数を指定する場合を除き、ほとんどの場合必要です。
data

List of labels; optional

このライブラリが実行時に必要とするファイルのリスト。 ほとんどのビルドルールによって定義される一般的な属性の data に関する一般的なコメントをご覧ください。

java_library をビルドする場合、Bazel はこれらのファイルをどこにも配置しません。data ファイルが生成されると、Bazel がそのファイルを生成します。この java_library Bazel に依存するテストをビルドする場合、runfile 領域に data ファイルをコピーまたはリンクします。

resources

List of labels; optional

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

Boolean; optional; default is False

この属性は、API コードを生成するアノテーション プロセッサをマークします。

ルールで API 生成のアノテーション プロセッサが使用されている場合、そのルールに依存している他のルールは、生成されたルールの後にコンパイル アクションがスケジュールされている場合にのみ、生成されたコードを参照できます。この属性は、--java_header_compile が有効になっている場合に、Bazel にスケジュールの制約を導入するよう指示します。

警告: この属性はビルドのパフォーマンスに影響するため、必要な場合にのみ使用してください。
javacopts

List of strings; optional

このライブラリの追加のコンパイラ オプション。 "Make variable" 置換と Bourne シェルトークン化が適用されます。

これらのコンパイラ オプションは、グローバル コンパイラ オプションの後で javac に渡されます。

Boolean; optional; default is False

このライブラリを実行時にではなくコンパイルにのみ使用するかどうかを指定します。実行中にランタイム環境からライブラリが提供される場合に便利です。このようなライブラリの例としては、IDE プラグイン用の IDE API や、標準 JDK で実行されるもの用の tools.jar などがあります。

なお、neverlink = 1 を指定しても、Java 言語仕様（String またはプリミティブ型の static final 定数）。したがって、推奨のユースケースは、ランタイム ライブラリがコンパイル ライブラリと同一である場合です。

ランタイム ライブラリがコンパイル ライブラリと異なる場合は、JLS がコンパイラによるインラインの禁止を行う場所（かつ、JLS の今後のすべてのバージョンで保持する必要がある場所）のみが異なることを確認する必要があります。
output_licenses

Licence type; optional

common attributes をご覧ください。
plugins

List of labels; optional

コンパイル時に実行する Java コンパイラ プラグイン。 このルールがビルドされるたびに、この属性で指定されたすべての java_plugin が実行されます。ライブラリは、exported_plugins を使用する依存関係からプラグインを継承することもできます。プラグインによって生成されたリソースは、このルールで生成される JAR に含まれます。
processor_class

String; optional

プロセッサ クラスは、Java コンパイラがアノテーション プロセッサへのエントリ ポイントとして使用するクラスの完全修飾型です。指定しない場合、このルールは Java コンパイラのアノテーション処理でアノテーション プロセッサに貢献しませんが、そのランタイム クラスパスは、コンパイラのアノテーション プロセッサのパスに引き続き含まれます。（これは主に、 java.util.ServiceLoader を使用してアノテーション プロセッサのパスから読み込まれる Error Prone プラグインによる使用が意図されています）。
proguard_specs

List of labels; optional

Proguard 仕様として使用するファイル。ここには、ProGuard が使用する仕様のセットを記述します。指定すると、このライブラリに応じて、任意の android_binary ターゲットに追加されます。 ここに記述するファイルには、べき等のルール（-dontnote、-dontwarn、前提条件なし、-keep で始まるルール）のみが含まれている必要があります。他のオプションは、非相互論理的結合を確実にするために、android_binary の proguard_specs にのみ指定できます。
resource_jars

List of labels; optional

非推奨: 代わりに java_import と deps または runtime_deps を使用してください。
resource_strip_prefix

String; optional

Java リソースから削除するパス プレフィックス。

指定すると、このパス接頭辞は resources 属性内のすべてのファイルから削除されます。リソース ファイルがこのディレクトリにないとエラーになります。指定しない場合（デフォルト）、リソース ファイルのパスは、ソースファイルの Java パッケージと同じロジックに従って決定されます。たとえば、stuff/java/foo/bar/a.txt のソースファイルは foo/bar/a.txt に配置されます。

java_runtime 

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

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

例:

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

引数

属性
name

Name; required

このターゲットの一意の名前。
srcs

List of labels; optional

ランタイム内のすべてのファイル。
hermetic_srcs

List of labels; optional

密閉型のデプロイに必要なランタイム内のファイル。
java

Label; optional

Java 実行可能ファイルのパス。
java_home

String; optional

ランタイムのルートへのパス。「Make」変数の置換が可能です。このパスが絶対パスの場合、ルールは既知のパスを持つ非密閉型の Java ランタイムを示します。この場合、srcs 属性と java 属性は空にする必要があります。
lib_modules

Label; optional

密閉型のデプロイに必要な lib/modules ファイル。

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_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

Name; required

このターゲットの一意の名前。
android_lint_data

List of labels; optional

android_lint_jvm_opts でラベル拡張に使用できるツールのラベル。
android_lint_jvm_opts

List of strings; optional

Android Lint を呼び出す際の JVM の引数のリスト。
android_lint_opts

List of strings; optional

Android Lint の引数のリスト。
android_lint_package_configuration

List of labels; optional

指定したパッケージ グループに適用する必要がある Android lint の設定。
android_lint_runner

Label; optional

Android lint ランナーのラベル（存在する場合）。
bootclasspath

List of labels; optional

Java ターゲットの bootclasspath エントリ。javac の -bootclasspath フラグに対応します。
deps_checker

List of labels; optional

ImportDepsChecker デプロイ jar のラベル。
forcibly_disable_header_compilation

Boolean; optional; default is False

--java_header_compile をオーバーライドして、サポートしていないプラットフォーム（JDK 7 Bazel など）では、ヘッダー コンパイルを無効にします。
genclass

List of labels; required

GenClass デプロイ JAR のラベル。
header_compiler

List of labels; optional

ヘッダー コンパイラのラベル。--java_header_compile が有効になっている場合は必須。
header_compiler_direct

List of labels; optional

API 生成アノテーション プロセッサを含まない直接のクラスパス アクションに使用するヘッダー コンパイラのオプションのラベル。

このツールは、アノテーション処理をサポートしていません。
ijar

List of labels; required

ijar 実行可能ファイルのラベル。
jacocorunner

Label; optional

JacocoCoverageRunner deploy jar のラベル。
java_runtime

Label; required

このツールチェーンで使用する java_runtime。実行構成でのデフォルトは java_runtime です。
javabuilder

List of labels; required

JavaBuilder deploy jar のラベル。
javabuilder_data

List of labels; optional

javabuilder_jvm_opts でラベル拡張に使用できるデータのラベル。
javabuilder_jvm_opts

List of strings; optional

JavaBuilder を呼び出す際の JVM の引数のリスト。
javac_supports_multiplex_workers

Boolean; optional; default is True

JavaBuilder が Multiplex 永続ワーカーとしての実行をサポートしている場合は true、サポートしていない場合は false です。
javac_supports_workers

Boolean; optional; default is True

JavaBuilder が永続ワーカーとしての実行をサポートしている場合は true、サポートしていない場合は false です。
javacopts

List of strings; optional

Java コンパイラの追加引数のリスト。使用可能な Java コンパイラ フラグの詳細なリストについては、Java コンパイラのドキュメントを参照してください。
jvm_opts

List of strings; optional

Java コンパイラを呼び出すときの JVM の引数のリスト。このオプションで選択可能なフラグの詳細なリストについては、Java 仮想マシンのドキュメントをご覧ください。
oneversion

Label; optional

1 つのバージョン適用バイナリのラベル。
oneversion_whitelist

Label; optional

単一バージョンの許可リストのラベル。
package_configuration

List of labels; optional

指定したパッケージ グループに適用する構成。
proguard_allowlister

Label; optional; default is @bazel_tools//tools/jdk:proguard_whitelister

Proguard 許可リストのラベル。
resourcejar

List of labels; optional

リソース JAR ビルダー実行ファイルのラベル。
singlejar

List of labels; required

SingleJar デプロイ JAR のラベル。
source_version

String; optional

Java ソース バージョン（例:「6」または「7」）。Java ソースコードで使用できるコード構造のセットを指定します。
target_version

String; optional

Java ターゲット バージョン（例:「6」または「7」）。クラスをビルドする Java ランタイムを指定します。
timezone_data

Label; optional

タイムゾーン データを含むリソース JAR のラベル。設定すると、タイムゾーン データがすべての java_binary ルールのランタイム依存関係として暗黙的に追加されます。
tools

List of labels; optional

jvm_opts でラベル拡張に使用できるツールのラベル。
turbine_data

List of labels; optional

turbine_jvm_opts でラベル拡張に使用できるデータのラベル。
turbine_jvm_opts

List of strings; optional

タービン呼び出し時の JVM の引数のリスト。
xlint

List of strings; optional

デフォルトのリストに追加または削除する警告のリスト。削除する場合は、先頭にダッシュを付けます。詳しくは、-Xlint オプションに関する Javac のドキュメントをご覧ください。