規則
- 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
目標時,會建立自包含 JAR 檔案,並附帶資訊清單,讓您可以使用java -jar
指令或包裝函式指令碼的--singlejar
選項執行該檔案。建議使用包裝函式指令碼 (java -jar
),因為這個指令碼也會傳遞 JVM 標記和載入原生資料庫的選項。部署 JAR 檔案包含所有類別,這些類別會由類別載入器找到,而該類別載入器會從頭到尾搜尋二進位檔的包裝函式指令碼中的 classpath。也包含依附元件所需的原生資料庫。這些類別會在執行階段自動載入至 JVM。
如果您的目標指定「launcher」屬性,則 _deploy.jar 會是原生二進位檔,而不是一般 JAR 檔案。這個檔案包含啟動器,以及規則的所有原生 (C++) 依附元件,全部連結至靜態二進位檔。實際 jar 檔案的位元組會附加至該原生二進位檔,建立同時包含執行檔和 Java 程式碼的單一二進位 blob。您可以按照執行任何原生二進位檔的方式,直接執行產生的 jar 檔案。
name_deploy-src.jar
:這個封存檔包含從目標遞移用途收集的來源。這些類別會與deploy.jar
中的類別相符,除非 jar 沒有相符的來源 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 |
名稱 (必填) 這個目標的專屬名稱。 建議您使用來源檔案的名稱,也就是應用程式的主要進入點 (減去副檔名)。舉例來說,如果進入點名稱為 Main.java ,則名稱可以是 Main 。
|
deps
|
標籤清單;預設為 deps 的一般註解,請參閱「大部分建構規則定義的常見屬性」。 |
srcs
|
標籤清單;預設值為
系統會解壓縮並編譯
規則:如果規則 (通常為
此引數幾乎一律是必要引數,除非 |
resources
|
標籤清單;預設值為
如果有指定資源,系統會將這些資源與編譯產生的一般 資源可以是來源檔案或產生的檔案。 |
classpath_resources
|
標籤清單;預設為
必須位於 Java 樹狀結構根目錄的資源清單。這項屬性的唯一用途是支援第三方程式庫,這類程式庫的資源必須在類別路徑 (即 |
create_executable
|
布林值;nonconfigurable;預設值為 java_single_jar 。
|
deploy_env
|
標籤清單;預設為 java_binary 目標清單,代表此二進位檔的部署環境。建構會由另一個 java_binary 載入的外掛程式時,請設定這項屬性。設定這個屬性後,這個二進位檔與 deploy_env 中指定的目標會共用這個二進位檔的類別路徑 (以及部署 jar 檔案) 中的所有依附元件。 |
deploy_manifest_lines
|
字串清單;預設為 *_deploy.jar 目標產生的 META-INF/manifest.mf 檔案,要加入的一系列程式碼。此屬性內容不會受到「Make 變數」替換作業的影響。 |
javacopts
|
字串清單;預設值為 這些編譯器選項會在全域編譯器選項之後傳遞至 javac。 |
jvm_flags
|
字串清單;預設為 Java 二進位檔的包裝函式指令碼包含 CLASSPATH 定義 (用於找出所有相依的 jar 檔案),並叫用正確的 Java 解譯器。包裝函式指令碼產生的指令列包含主要類別的名稱,後面加上 請注意,此屬性對 |
launcher
|
標籤;預設值為 bin/java 程式。目標必須是 cc_binary 。凡是實作
Java Invocation API 的 cc_binary ,都能指定為這項屬性的值。根據預設,Bazel 會使用一般 JDK 啟動器 (bin/java 或 java.exe)。 相關的 請注意,原生 (C++、SWIG、JNI) 依附元件會根據您使用 JDK 啟動器或其他啟動器而有所不同:
使用預設 JDK 啟動器以外的任何啟動器時, |
main_class
|
字串;預設為 main() 方法的類別名稱,用於做為進入點。如果規則使用這個選項,就不需要 srcs=[...] 清單。因此,如果有這個屬性,即可透過已包含一或多個 main() 方法的 Java 程式庫執行執行檔。
此屬性的值是類別名稱,而不是來源檔案。類別必須在執行階段可用:可以透過此規則 (來自 |
plugins
|
標籤清單;預設為 java_plugin 。程式庫也可能從使用 exported_plugins 的依附元件繼承外掛程式。外掛程式產生的資源會納入這項規則產生的 jar 檔案。 |
resource_jars
|
標籤清單;預設值為 |
resource_strip_prefix
|
字串;預設值為
如果指定,系統會從 |
runtime_deps
|
標籤清單;預設為 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 規則。您不太可能會這麼做。其中一個用途是用於由其他規則叫用的 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
|
字串清單;nonconfigurable;預設值為 |
exports
|
標籤清單;預設為 |
jars
|
標籤清單 (必填) 提供給 Java 目標 (取決於這個目標) 的 JAR 檔案清單。 |
neverlink
|
布林值;預設值為 tools.jar 。 |
proguard_specs
|
標籤清單;預設為 android_binary 目標。此處所包含的檔案只能包含同質性規則,也就是 -dontnote、-dontwarn、assumenosideeffects,以及開頭為 -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
|
標籤清單;預設為
這裡列出的規則可讓父項規則使用,就像父項規則明確依附這些規則一樣。這不適用於一般 (未匯出)
摘要:如果兩個規則之間存在以
假設 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,則必須在自己的 |
javacopts
|
字串清單;預設為 在全域編譯器選項之後,這些編譯器選項會傳遞至 javac。 |
neverlink
|
布林值;預設值為 tools.jar 。
請注意, 如果執行階段程式庫與編譯程式庫不同,您必須確保該程式庫的差別只在於 JLS 禁止編譯器以內嵌方式嵌入,且必須保留所有日後的 JLS 版本。 |
plugins
|
標籤清單;預設值為 java_plugin 。程式庫也可能會從使用 exported_plugins 的依附元件繼承外掛程式。外掛程式產生的資源會納入這項規則的產生 JAR 檔案。 |
proguard_specs
|
標籤清單;預設值為 android_binary 目標。此處所包含的檔案只能包含同質性規則,也就是 -dontnote、-dontwarn、assumenosideeffects,以及開頭為 -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
|
布林值;nonconfigurable;預設值為 java_single_jar 。
|
deploy_manifest_lines
|
字串清單;預設為 *_deploy.jar 目標產生的 META-INF/manifest.mf 檔案的程式碼行清單。這項屬性的內容不取決於「Make 變數」替換作業。
|
javacopts
|
字串清單;預設值為 這些編譯器選項會在全域編譯器選項之後傳遞至 javac。 |
jvm_flags
|
字串清單;預設為 Java 二進位檔的包裝函式指令碼包含 CLASSPATH 定義 (用於尋找所有依附的 JAR),並叫用正確的 Java 轉譯器。包裝函式指令碼產生的指令列包含主要類別名稱,後面接著 請注意,此屬性對 |
launcher
|
標籤;預設值為 bin/java 程式。目標必須是 cc_binary 。凡是實作
Java Invocation API 的 cc_binary ,都能指定為這項屬性的值。根據預設,Bazel 會使用一般 JDK 啟動器 (bin/java 或 java.exe)。 相關的 請注意,視您使用 JDK 啟動器或其他啟動器而定,原生 (C++、SWIG、JNI) 依附元件的建構方式會有所不同:
使用預設 JDK 啟動器以外的任何啟動器時, |
main_class
|
字串;預設為 main() 方法的類別名稱,用於做為進入點。如果規則使用這個選項,就不需要 srcs=[...] 清單。因此,如果有這個屬性,即可透過已包含一或多個 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 ) 類別做為 Java 程式的主要進入點,並將測試類別提供給測試執行器,做為 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 封存檔。
引數與 java_library
相同,但新增了 processor_class
引數。
引數
屬性 | |
---|---|
name |
名稱;必填 此目標的專屬名稱。 |
deps
|
標籤清單;預設值為 deps 的一般註解。
由
相反地, |
srcs
|
標籤清單;預設值為
系統會解壓縮並編譯
規則:如果規則 (通常為
此引數幾乎一律是必要引數,除非 |
data
|
標籤清單;預設為 data 的一般註解,請參閱「大多數建構規則定義的常見屬性」。
建構 |
resources
|
標籤清單;預設值為
如果有指定資源,系統會將這些資源與編譯產生的一般 資源可以是來源檔案或產生的檔案。 |
generates_api
|
布林值;預設值為 如果規則使用 API 產生註解處理器,則只有在產生規則後排程編譯動作時,依附於該規則的其他規則才能參照產生的程式碼。這項屬性會指示 Bazel 在啟用 --java_header_compilation 時引入排程限制。 警告:這個屬性會影響建構效能,請僅在必要時使用。 |
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、假設,以及開頭為 -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 檔案。如果未指定,且 srcs 中只有一個路徑結尾為 /lib/ct.sym 的檔案,系統會使用該檔案。 |
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_toolchain 引數變更。通常除非需要調整 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 部署 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
|
字串清單;預設為 |