java_common

Starlark 中支持 Java 编译的实用程序。

成员

• BootClassPathInfo
• 编译
• JavaPluginInfo
• JavaRuntimeInfo
• JavaToolchainInfo
• make_non_strict
• 合并
• pack_sources
• provider
• run_ijar
• stamp_jar
• to_java_binary_info

BootClassPathInfo

Provider java_common.BootClassPathInfo

用于提供 bootclasspath 信息的提供程序

compile

JavaInfo java_common.compile(ctx, *, source_jars=[], source_files=[], output, output_source_jar=None, javac_opts=[], deps=[], runtime_deps=[], exports=[], plugins=[], exported_plugins=[], native_libraries=[], annotation_processor_additional_inputs=[], annotation_processor_additional_outputs=[], strict_deps='ERROR', java_toolchain, host_javabase=None, sourcepath=[], resources=[], resource_jars=[], classpath_resources=[], neverlink=False, enable_annotation_processing=True, enable_compile_jar_action=True, add_exports=[], add_opens=[])

编译实现 Starlark 规则的 Java 源文件/jar，并返回表示编译结果的提供程序，可添加到此规则发出的提供程序集中。

参数

参数	说明
ctx	必需 规则上下文。
source_jars	sequence of Files； 默认值 = [] 要编译的 jar 的列表。应至少指定 source_jars 和 source_files 中的一个。
source_files	sequence of Files； 默认值 = [] 要编译的 Java 源文件列表。应至少指定 source_jars 和 source_files 中的一个。
output	必需
output_source_jar	File; or None； 默认值 = 无 输出源 jar。可选。如果未设置，则默认为“{output_jar}-src.jar”。
javac_opts	sequence of strings； 默认值 = [] 所需 javac 选项的列表。选填。
deps	sequence of JavaInfos； 默认值 = [] 依赖项列表。选填。
runtime_deps	sequence of JavaInfos； 默认值 = [] 运行时依赖项列表。选填。
exports	sequence of JavaInfos； 默认值 = [] 导出内容列表。选填。
plugins	sequence of JavaPluginInfos; or sequence of JavaInfos； 默认值 = [] 插件列表。选填。
exported_plugins	sequence of JavaPluginInfos; or sequence of JavaInfos； 默认值 = [] 导出的插件列表。选填。
native_libraries	sequence of CcInfos； 默认值 = [] 此库所需的 CC 原生库依赖项。
annotation_processor_additional_inputs	sequence of Files； 默认值 = [] 除了用于注解处理的 Java 源之外，Java 编译操作还将采取的输入列表。
annotation_processor_additional_outputs	sequence of Files； 默认值 = [] 除了注解处理中的类 jar 之外，Java 编译操作还将输出的一系列输出。
strict_deps	默认值 = 'ERROR' 指定如何处理严格依赖项的字符串。可能的值：“OFF”、“ERROR”、“WARN”和“DEFAULT”。有关详情，请参阅 /docs/user-manual#flag--strict_java_deps。默认为“ERROR”。
java_toolchain	必需 要用于此编译的 JavaToolchainInfo。必填。
host_javabase	默认值 = 无 已弃用。此参数已被弃用，很快就会被移除。请勿依赖它。此选项已通过 --+incompatible_java_common_parameters 停用。使用此标记验证您的代码与其即将移除的兼容性兼容。 已废弃：您可以删除此参数（host_javabase 随 java_toolchain 一起提供）
sourcepath	sequence of Files； 默认值 = []
resources	sequence of Files； 默认值 = []
resource_jars	sequence of Files； 默认值 = []
classpath_resources	sequence of Files； 默认值 = []
neverlink	默认值 = False
enable_annotation_processing	默认值 = True 在此编译中停用注解处理，导致插件或依赖项的 export_plugins 中提供的任何注解处理器都被忽略。
enable_compile_jar_action	默认值 = True 启用头文件编译或创建 ijar。如果设为 False，则会在任何依赖项的编译类路径中强制使用整个类 jar。这样做旨在供非库目标（例如没有依赖项的二进制文件）使用。
add_exports	sequence of strings； 默认值 = [] 允许此库访问指定的 /。选填。
add_opens	sequence of strings； 默认值 = [] 允许此库反射访问指定的 /。选填。

JavaPluginInfo

Provider java_common.JavaPluginInfo

用于检索包含 Java 插件相关信息的提供程序的键。可以通过 JavaPluginInfo 访问相同的值。
更喜欢在新代码中使用 JavaPluginInfo。

JavaRuntimeInfo

Provider java_common.JavaRuntimeInfo

用于检索提供程序（包含正在使用的 Java 运行时的相关信息）的键。

JavaToolchainInfo

Provider java_common.JavaToolchainInfo

用于检索提供程序（包含所用 Java 工具链相关信息）的密钥。

make_non_strict

JavaInfo java_common.make_non_strict(java_info)

返回一个新的 Java 提供程序，其直接 jar 部分是给定 Java 提供程序的直接和间接 jar 的并集。

参数

参数	说明
java_info	必需 Java 信息。

合并

JavaInfo java_common.merge(providers, *, merge_java_outputs=True, merge_source_jars=True)

将给定的提供程序合并到单个 JavaInfo 中。

参数

参数	说明
providers	sequence of JavaInfos； 必需 要合并的提供商列表。
merge_java_outputs	默认值 = True
merge_source_jars	默认值 = True

pack_sources

File java_common.pack_sources(actions, *, output_jar=None, output_source_jar=None, sources=[], source_jars=[], java_toolchain, host_javabase=None)

将源文件和源 jar 打包到单个源 jar 文件中。返回值通常会传递到

JavaInfo#source_jar

. 至少需要 output_jar 或 output_source_jar 参数中的一个。

参数

参数	说明
actions	必需 ctx.actions
output_jar	File; or None； 默认值 = 无 已弃用。此参数已被弃用，很快就会被移除。请勿依赖它。此选项已通过 --+incompatible_java_common_parameters 停用。使用此标记验证您的代码与其即将移除的兼容性兼容。 已弃用：规则的输出 jar。用于命名生成的源 jar。该参数会将 output_source_jar 参数设置为“{output_jar}-src.jar”。请改为直接使用 output_source_jar 参数。
output_source_jar	File; or None； 默认值 = 无 输出源 jar。
sources	sequence of Files； 默认值 = [] 要打包到源 jar 中的 Java 源文件列表。
source_jars	sequence of Files； 默认值 = [] 要打包到源 jar 中的源 JAR 的列表。
java_toolchain	必需 用于查找 ijar 工具的 JavaToolchainInfo。
host_javabase	默认值 = 无 已弃用。此参数已被弃用，很快就会被移除。请勿依赖它。此选项已通过 --+incompatible_java_common_parameters 停用。使用此标记验证您的代码与其即将移除的兼容性兼容。 已废弃：您可以删除此参数（host_javabase 随 java_toolchain 一起提供）

可能会返回 None。

provider

Provider java_common.provider

返回 Java 声明的提供程序。
可以像 JavaInfo 一样访问相同的值。
更喜欢在新代码中使用 JavaInfo。

run_ijar

File java_common.run_ijar(actions, *, jar, target_label=None, java_toolchain)

对 jar 运行 ijar，将 jar 剥离其方法正文。这有助于减少在任何重新编译（仅包含对方法实现的简单更改）期间重新编译依赖 JAR 的情况。返回值通常会传递给 JavaInfo#compile_jar。

参数

参数	说明
actions	必需 ctx.actions
jar	必需 要运行 ijar 的 jar。
target_label	Label; or None； 默认值 = 无 用于印章的目标标签。用于提供 add_dep 支持。通常，您会传递 ctx.label 来为 jar 添加当前规则的标签。
java_toolchain	必需 用于查找 ijar 工具的 JavaToolchainInfo。

stamp_jar

File java_common.stamp_jar(actions, *, jar, target_label, java_toolchain)

在罐子上标记目标标签以实现 add_dep 支持。返回值通常会传递给 JavaInfo#compile_jar。请尽可能使用 run_ijar。

参数

参数	说明
actions	必需 ctx.actions
jar	必需 要运行 timestamp_jar 的 jar。
target_label	必需 用于印章的目标标签。用于提供 add_dep 支持。通常，您会传递 ctx.label 来为 jar 添加当前规则的标签。
java_toolchain	必需 用于查找 timestamp_jar 工具的 JavaToolchainInfo。

to_java_binary_info

JavaInfo java_common.to_java_binary_info(java_info)

返回给定 JavaInfo 的副本，其中包含 java_binary 返回的基本信息

参数

参数	说明
java_info	必需 要增强的 JavaInfo。