目前,唯一支持的插件类型是注解处理器。
成员
JavaPluginInfo
JavaPluginInfo JavaPluginInfo(runtime_deps, *, processor_class, data=[], generates_api=False)
JavaPluginInfo
构造函数。
参数
参数 | 说明 |
---|---|
runtime_deps
|
sequence of JavaInfos ;必需包含注解处理器的库。 |
processor_class
|
string; or None ;必需Java 编译器用作注解处理器的入口点的完全限定类名。 |
data
|
sequence of Files; or depset of Files ;
default = []此注解处理器在执行期间所需的文件。 |
generates_api
|
default = False 当此注解处理器生成 API 代码时设置为 true。 此类注解处理器会先应用于 Java 目标,然后再生成其标头 jar(包含方法签名)。当不存在 API 插件时,系统会从源代码生成标头 jar,从而减少关键路径。 警告:此参数会影响构建性能,请仅在必要时使用。 |
api_generating_plugins
JavaPluginData JavaPluginInfo.api_generating_plugins返回有关如何通过 API 生成由此目标定义或导出的插件的数据。
在生成 Java 目标的标头 jar(包含方法签名)之前,这些注解处理器会先应用于 Java 目标。如果不存在 API 插件,则从源代码生成标头 jar,从而减少关键路径。
api_generating_plugins
是 plugins
的子集。
java_outputs
list JavaPluginInfo.java_outputs返回有关此 Java/Java 目标的输出的信息。
插件
JavaPluginData JavaPluginInfo.plugins返回有关使用方目标应应用的所有插件的数据。
通常是 java_plugin
本身或用于导出一个或多个插件的 java_library
。
java_library
会运行注解处理,此字段中的所有插件都会显示在 deps
和 plugins
属性中。
to_json
string JavaPluginInfo.to_json()已弃用。此 API 已弃用,很快就会被移除。请不要依赖它。已使用
---incompatible_struct_has_no_methods
停用。使用此标记验证您的代码是否符合即将移除的代码。使用结构体参数创建 JSON 字符串。仅当所有结构体元素(以递归方式)都是字符串、整数、布尔值、其他结构体、这些类型的列表或包含这些类型的字符串键和值的字典时,此方法才有效。字符串中的引号和换行符会进行转义。示例:
struct(key=123).to_json() # {"key":123} struct(key=True).to_json() # {"key":true} struct(key=[1, 2, 3]).to_json() # {"key":[1,2,3]} struct(key='text').to_json() # {"key":"text"} struct(key=struct(inner_key='text')).to_json() # {"key":{"inner_key":"text"}} struct(key=[struct(inner_key=1), struct(inner_key=2)]).to_json() # {"key":[{"inner_key":1},{"inner_key":2}]} struct(key=struct(inner_key=struct(inner_inner_key='text'))).to_json() # {"key":{"inner_key":{"inner_inner_key":"text"}}}。
已弃用:请改用 json.encode(x) 或 json.encode_unsubscribe(x),它们适用于结构体以外的值,并且不会污染结构体字段命名空间。
to_proto
string JavaPluginInfo.to_proto()已弃用。此 API 已弃用,很快就会被移除。请不要依赖它。已使用
---incompatible_struct_has_no_methods
停用。使用此标记验证您的代码是否符合即将移除的代码。使用 struct 参数创建一条文本消息。仅当所有结构体元素(以递归方式)都是字符串、整数、布尔值、其他结构体、字典或这些类型的列表时,此方法才有效。字符串中的引号和换行符会进行转义。结构体键按排序顺序进行迭代。示例:
struct(key=123).to_proto() # key: 123 struct(key=True).to_proto() # key: true struct(key=[1, 2, 3]).to_proto() # key: 1 # key: 2 # key: 3 struct(key='text').to_proto() # key: "text" struct(key=struct(inner_key='text')).to_proto() # key { # inner_key: "text" # } struct(key=[struct(inner_key=1), struct(inner_key=2)]).to_proto() # key { # inner_key: 1 # } # key { # inner_key: 2 # } struct(key=struct(inner_key=struct(inner_inner_key='text'))).to_proto() # key { # inner_key { # inner_inner_key: "text" # } # } struct(foo={4: 3, 2: 1}).to_proto() # foo: { # key: 4 # value: 3 # } # foo: { # key: 2 # value: 1 # }
已废弃:请改用 proto.encode_text(x)。