ルール
- java_binary
- java_import
- java_library
- java_lite_proto_library
- java_proto_library
- java_test
- java_package_configuration
- java_plugin
- java_runtime
- java_toolchain
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 コードの両方を含む単一のバイナリ ブロブが作成されます。生成された jar ファイルは、ネイティブ バイナリを実行するように直接実行できます。
name_deploy-src.jar
: ターゲットの推移的クロージャから収集されたソースを含むアーカイブ。これらのクラスは、jar に一致するソース jar がない限り、deploy.jar
のクラスと一致します。
deps
属性は、srcs
のない java_binary
ルールでは使用できません。このようなルールには、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
|
ラベルのリスト。デフォルトは
ルール: ルール(通常は
この引数は、 |
resources
|
ラベルのリスト。デフォルトは
リソースが指定されている場合、コンパイルで生成される通常の リソースは、ソースファイルまたは生成ファイルのいずれかです。 |
classpath_resources
|
ラベルのリスト。デフォルトは
Java ツリーのルートに配置する必要があるリソースのリスト。この属性の唯一の目的は、リソースがクラスパスで |
create_executable
|
ブール値。構成不可。デフォルトは java_single_jar を使用してください。
|
deploy_env
|
ラベルのリスト。デフォルトは java_binary ターゲットのリスト。別の java_binary によって読み込まれるプラグインをビルドするときに、この属性を設定します。この属性を設定すると、このバイナリと deploy_env で指定されたターゲット間で共有される、このバイナリのランタイム クラスパス(およびデプロイ jar)からすべての依存関係が除外されます。 |
deploy_manifest_lines
|
文字列のリスト。デフォルトは *_deploy.jar ターゲット用に生成された META-INF/manifest.mf ファイルに追加する行のリスト。この属性の内容は、「変数を作成」の置換の対象になりません。 |
javacopts
|
文字列のリスト。デフォルトは これらのコンパイラ オプションは、グローバル コンパイラ オプションの後に javac に渡されます。 |
jvm_flags
|
文字列のリスト。デフォルトは Java バイナリのラッパー スクリプトには、CLASSPATH 定義(依存するすべての jar を見つけるため)が含まれており、適切な Java インタープリタを呼び出します。ラッパー スクリプトによって生成されたコマンドラインには、メインクラスの名前とその後に この属性は |
launcher
|
ラベル(デフォルトは bin/java プログラムの代わりに、Java プログラムの実行に使用するバイナリを指定します。ターゲットは cc_binary にする必要があります。Java Invocation API を実装する任意の cc_binary を、この属性の値として指定できます。デフォルトでは、Bazel は通常の JDK ランチャー(bin/java または java.exe)を使用します。 関連する ネイティブ(C++、SWIG、JNI)依存関係のビルドは、JDK ランチャーと別のランチャーのどちらを使用するかによって異なることに注意してください。
デフォルトの JDK ランチャー以外のランチャーを使用すると、 |
main_class
|
文字列。デフォルトは main() メソッドを含むクラスの名前。ルールでこのオプションを使用する場合、srcs=[...] リストは必要ありません。したがって、この属性を使用すると、すでに 1 つ以上の main() メソッドが含まれている Java ライブラリから実行ファイルを作成できます。
この属性の値は、ソースファイルではなくクラス名です。クラスは実行時に使用可能である必要があります。このルールによってコンパイルされる( |
plugins
|
ラベルのリスト。デフォルトは java_plugin は、このルールがビルドされるたびに実行されます。ライブラリは、exported_plugins を使用する依存関係からプラグインを継承することもできます。プラグインによって生成されたリソースは、このルールの結果として生成される jar に含まれます。 |
resource_jars
|
ラベルのリスト。デフォルトは |
resource_strip_prefix
|
文字列。デフォルトは
指定すると、このパス接頭辞は |
runtime_deps
|
ラベルのリスト。デフォルトは deps と同様に、これらはランタイム クラスパスに表示されますが、コンパイル時クラスパスには表示されません。実行時にのみ必要な依存関係をここに記載します。依存関係分析ツールは、runtime_deps と deps の両方に存在するターゲットを無視する必要があります。 |
stamp
|
整数。デフォルトは
スタンプされたバイナリは、依存関係が変更されない限り再ビルドされません。 |
use_launcher
|
ブール値。デフォルトは この属性を false に設定した場合、このターゲットでは launcher 属性と関連する |
use_testrunner
|
ブール値。デフォルトは 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
|
ラベルのリスト。デフォルトは |
constraints
|
文字列のリスト。構成不可。デフォルトは |
exports
|
ラベルのリスト。デフォルトは |
jars
|
ラベルのリスト(必須) このターゲットに依存する Java ターゲットに提供される JAR ファイルのリスト。 |
neverlink
|
ブール値。デフォルトは tools.jar などがあります。 |
proguard_specs
|
ラベルのリスト。デフォルトは android_binary ターゲットに追加されます。ここに含めるファイルには、べき等ルール(-dontnote、-dontwarn、confirmnosideeffects、-keep で始まるルール)のみを含める必要があります。他のオプションは、非自動的マージを保証するために、android_binary の proguard_specs でのみ指定できます。
|
runtime_deps
|
ラベルのリスト。デフォルトは |
srcjar
|
ラベル(デフォルトは |
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 に関する一般的なコメントについては、ほとんどのビルドルールで定義される一般的な属性をご覧ください。
一方、 |
srcs
|
ラベルのリスト。デフォルトは
ルール: ルール(通常は
この引数は、 |
data
|
ラベルのリスト。デフォルトは data に関する一般的なコメントについては、ほとんどのビルドルールで定義されている一般的な属性をご覧ください。
|
resources
|
ラベルのリスト。デフォルトは
リソースが指定されている場合、それらは、コンパイルによって生成された通常の リソースには、ソースファイルまたは生成されたファイルを指定できます。 |
exported_plugins
|
ラベルのリスト。デフォルトは java_plugin (アノテーション プロセッサなど)のリスト。
指定された |
exports
|
ラベルのリスト。デフォルトは
ここにルールを一覧表示すると、親ルールがこれらのルールに明示的に依存しているかのように、親ルールで使用できるようになります。これは、通常の(エクスポートされていない)
概要: ルール X 間に
A は B に依存し、B は C に依存しているとします。この場合、C は A の推移的依存関係であるため、C のソースを変更して A を再ビルドすると、すべてが正しく再ビルドされます。ただし、A は C のクラスを使用できません。これを許可するには、A が エクスポートされたライブラリのクローズは、すべての直接親ルールで使用できます。少し異なる例を見てみましょう。A は B に依存し、B は C と D に依存し、さらに C はエクスポートしますが D はエクスポートしません。これで、A は C にアクセスできますが、D にはアクセスできません。C と D がそれぞれ C' と D' というライブラリをエクスポートした場合、A は C' にのみアクセスでき、D' にはアクセスできません。
重要: エクスポートされたルールは通常の依存関係ではありません。前の例で言うと、B が C をエクスポートし、C も使用する場合は、その B も独自の |
javacopts
|
文字列のリスト。デフォルトは これらのコンパイラ オプションは、グローバル コンパイラ オプションの後に javac に渡されます。 |
neverlink
|
ブール値。デフォルトは tools.jar があります。
ランタイム ライブラリがコンパイル ライブラリと異なる場合は、JLS でコンパイラのインライン化が禁止されている箇所のみが異なるようにする必要があります(また、JLS の今後のすべてのバージョンで保持する必要があります)。 |
plugins
|
ラベルのリスト。デフォルトは java_plugin が実行されます。ライブラリは、exported_plugins を使用する依存関係からプラグインを継承することもできます。プラグインによって生成されたリソースは、このルールで生成される jar に含まれます。 |
proguard_specs
|
ラベルのリスト。デフォルトは android_binary ターゲットに追加されます。ここに含めるファイルには、べき等ルール(-dontnote、-dontwarn、confirmnosideeffects、-keep で始まるルール)のみを含める必要があります。他のオプションは、非自動的マージを保証するために、android_binary の proguard_specs でのみ指定できます。
|
resource_jars
|
ラベルのリスト。デフォルトは |
resource_strip_prefix
|
文字列。デフォルトは
指定すると、このパス接頭辞は |
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
|
ラベルのリスト。デフォルトは 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
|
ラベルのリスト。デフォルトは 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
|
ラベルのリスト。デフォルトは
ルール: ルール(通常は
|
resources
|
ラベルのリスト。デフォルトは
リソースが指定されている場合、それらは、コンパイルによって生成された通常の リソースには、ソースファイルまたは生成されたファイルを指定できます。 |
classpath_resources
|
ラベルのリスト。デフォルトは
Java ツリーのルートに配置する必要があるリソースのリスト。この属性の唯一の目的は、リソースを |
create_executable
|
ブール値、設定不可、デフォルトは java_single_jar を使用してください。
|
deploy_manifest_lines
|
文字列のリスト。デフォルトは *_deploy.jar ターゲット用に生成された META-INF/manifest.mf ファイルに追加する行のリスト。この属性の内容は、「変数を作成」の置換の対象外です。 |
javacopts
|
文字列のリスト。デフォルトは これらのコンパイラ オプションは、グローバル コンパイラ オプションの後に javac に渡されます。 |
jvm_flags
|
文字列のリスト。デフォルトは Java バイナリのラッパー スクリプトには、CLASSPATH 定義(依存するすべての jar を見つけるため)が含まれており、適切な Java インタープリタを呼び出します。ラッパー スクリプトによって生成されたコマンドラインでは、メインクラスの名前の後に この属性は |
launcher
|
ラベル: デフォルトは bin/java プログラムの代わりに、Java プログラムの実行に使用するバイナリを指定します。ターゲットは cc_binary にする必要があります。Java Invocation API を実装する任意の cc_binary を、この属性の値として指定できます。デフォルトでは、Bazel は通常の JDK ランチャー(bin/java または java.exe)を使用します。 関連する ネイティブ(C++、SWIG、JNI)依存関係のビルドは、JDK ランチャーを使用しているか別のランチャーを使用しているかによって異なります。
デフォルトの JDK ランチャー以外のランチャーを使用する場合、 |
main_class
|
文字列。デフォルトは main() メソッドを含むクラスの名前。ルールでこのオプションを使用する場合、srcs=[...] リストは必要ありません。したがって、この属性を使用すると、すでに 1 つ以上の main() メソッドが含まれている Java ライブラリから実行ファイルを作成できます。
この属性の値は、ソースファイルではなくクラス名です。このクラスは実行時に使用可能でなければなりません。このルールによって( |
plugins
|
ラベルのリスト。デフォルトは java_plugin が実行されます。ライブラリは、exported_plugins を使用する依存関係からプラグインを継承することもできます。プラグインによって生成されたリソースは、このルールの結果として生成される jar に含まれます。 |
resource_jars
|
ラベルのリスト。デフォルトは |
resource_strip_prefix
|
文字列。デフォルトは
指定すると、このパス接頭辞は |
runtime_deps
|
ラベルのリスト。デフォルトは deps と同様に、これらはランタイム クラスパスに表示されますが、コンパイル時クラスパスには表示されません。実行時にのみ必要な依存関係をここに記載します。依存関係分析ツールは、runtime_deps と deps の両方に表示されるターゲットを無視する必要があります。
|
stamp
|
整数。デフォルトは
スタンプされたバイナリは、依存関係が変更されない限り再ビルドされません。 |
test_class
|
文字列。デフォルトは
デフォルトでは、この引数が定義されていない場合は以前のモードが使用され、代わりにテスト引数が使用されます。
この属性は、このテストで実行する Java クラスの名前を指定します。この設定が必要になることはほとんどありません。この引数を省略すると、ターゲットの
JUnit3 の場合、テストクラスは
この属性を使用すると、複数の |
use_launcher
|
ブール値。デフォルトは この属性が false に設定されている場合、このターゲットでは launcher 属性と関連する |
use_testrunner
|
ブール値。デフォルトは com.google.testing.junit.runner.BazelTestRunner )クラスを使用し、テストクラスを bazel.test_suite システム プロパティの値としてテストランナーに提供します。これを使用して、デフォルトの動作をオーバーライドできます。デフォルトの動作では、java_test ルールにはテストランナーを使用し、java_binary ルールには使用しません。通常は、この方法はおすすめしません。たとえば、テストの実行前にデータベースを設定するために、別のルールによって呼び出される 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
|
文字列のリスト。デフォルトは |
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 に関する一般的なコメントについては、ほとんどのビルドルールで定義されている一般的な属性をご覧ください。
これに対して、 |
srcs
|
ラベルのリスト。デフォルトは
ルール: ルール(通常は
|
data
|
ラベルのリスト。デフォルトは data に関する一般的なコメントについては、ほとんどのビルドルールで定義されている一般的な属性をご覧ください。
|
resources
|
ラベルのリスト。デフォルトは
リソースが指定されている場合、コンパイルで生成される通常の リソースには、ソースファイルまたは生成されたファイルを指定できます。 |
generates_api
|
ブール値。デフォルトは ルールが API 生成アノテーション プロセッサを使用する場合、それに依存する他のルールは、コンパイル アクションが生成ルールの後にスケジュールされている場合にのみ、生成されたコードを参照できます。この属性は、--java_header_compile が有効になっている場合にスケジューリング制約を導入するよう Bazel に指示します。 警告: この属性はビルドのパフォーマンスに影響します。必要に応じてのみ使用してください。 |
javacopts
|
文字列のリスト。デフォルトは これらのコンパイラ オプションは、グローバル コンパイラ オプションの後に javac に渡されます。 |
neverlink
|
ブール値。デフォルトは tools.jar があります。
ランタイム ライブラリがコンパイル ライブラリと異なる場合は、JLS がコンパイラのインラインでのインライン実行を禁止している箇所のみが異なるようにする必要があります(また、JLS の今後のすべてのバージョンで保持する必要があります)。 |
output_licenses
|
ライセンスの種類。デフォルトは common attributes
をご覧ください。 |
plugins
|
ラベルのリスト。デフォルトは java_plugin が実行されます。ライブラリは、exported_plugins を使用する依存関係からプラグインを継承することもできます。プラグインによって生成されたリソースは、このルールの結果として生成される jar に含まれます。 |
processor_class
|
文字列。デフォルトは |
proguard_specs
|
ラベルのリスト。デフォルトは android_binary ターゲットに追加されます。ここに含めるファイルには、べき等ルール(-dontnote、-dontwarn、confirmnosideeffects、-keep で始まるルール)のみを含める必要があります。他のオプションは、非自動的マージを保証するために、android_binary の proguard_specs でのみ指定できます。
|
resource_jars
|
ラベルのリスト。デフォルトは |
resource_strip_prefix
|
文字列。デフォルトは
指定すると、このパス接頭辞は |
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
|
ラベル: デフォルトは java_runtime のデフォルトの CDS アーカイブ。java_binary ターゲットでハーメティックが有効になっていて、ターゲットが classlist 属性を指定して独自の CDS アーカイブを提供していない場合、java_runtime のデフォルト CDS がハーメティック デプロイ JAR にパッケージ化されます。 |
hermetic_srcs
|
ラベルのリスト。デフォルトは |
java
|
ラベル: デフォルトは |
java_home
|
文字列。デフォルトは srcs 属性と java 属性を空にする必要があります。
|
lib_ct_sym
|
ラベル: デフォルトは --release でのコンパイルに必要な lib/ct.sym ファイル。指定せず、パスが /lib/ct.sym で終わるファイルが srcs 内に 1 つだけの場合は、そのファイルが使用されます。 |
lib_modules
|
ラベル(デフォルトは |
version
|
整数。デフォルトは 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_worker_multiplex_sandboxing, 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_opts
|
文字列のリスト。デフォルトは |
android_lint_package_configuration
|
ラベルのリスト。デフォルトは |
android_lint_runner
|
ラベル: デフォルトは |
bootclasspath
|
ラベルのリスト。デフォルトは |
deps_checker
|
ラベルのリスト。デフォルトは |
forcibly_disable_header_compilation
|
ブール値。デフォルトは |
genclass
|
ラベルのリスト(必須) GenClass deploy JAR のラベル。 |
header_compiler
|
ラベルのリスト。デフォルトは |
header_compiler_direct
|
ラベルのリスト。デフォルトは このツールはアノテーション処理をサポートしていません。 |
ijar
|
ラベルのリスト(必須) ijar 実行可能ファイルのラベル。 |
jacocorunner
|
ラベル: デフォルトは |
java_runtime
|
ラベル: 必須 このツールチェーンで使用する java_runtime。実行構成のデフォルトは java_runtime です。 |
javabuilder
|
ラベルのリスト(必須) JavaBuilder デプロイ JAR のラベル。 |
javabuilder_data
|
ラベルのリスト。デフォルトは |
javabuilder_jvm_opts
|
文字列のリスト。デフォルトは |
javac_supports_multiplex_workers
|
ブール値。デフォルトは |
javac_supports_worker_multiplex_sandboxing
|
ブール値。デフォルトは |
javac_supports_workers
|
ブール値。デフォルトは |
javacopts
|
文字列のリスト。デフォルトは |
jvm_opts
|
文字列のリスト。デフォルトは |
oneversion
|
ラベル: デフォルトは |
oneversion_allowlist_for_tests
|
ラベル: デフォルトは |
oneversion_whitelist
|
ラベル(デフォルトは |
package_configuration
|
ラベルのリスト。デフォルトは |
proguard_allowlister
|
ラベル(デフォルトは |
resourcejar
|
ラベルのリスト。デフォルトは |
singlejar
|
ラベルのリスト(必須) SingleJar デプロイ jar のラベル。 |
source_version
|
文字列。デフォルトは |
target_version
|
文字列。デフォルトは |
timezone_data
|
ラベル: デフォルトは |
tools
|
ラベルのリスト。デフォルトは |
turbine_data
|
ラベルのリスト。デフォルトは |
turbine_jvm_opts
|
文字列のリスト。デフォルトは |
xlint
|
文字列のリスト。デフォルトは |