规则
action_listener
查看规则来源action_listener(name, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, extra_actions, features, licenses, mnemonics, restricted_to, tags, target_compatible_with, testonly, visibility)
警告:其他操作已弃用。请改用方面。
action_listener
规则本身不会产生任何输出。
相反,它允许工具开发者通过提供从操作到 extra_action
的映射,将 extra_action
插入到构建系统中。
此规则的参数会将操作助记符映射到 extra_action
规则。
通过指定选项 --experimental_action_listener=<label>
,build 将使用指定的 action_listener
将 extra_action
插入 build 图。
示例
action_listener( name = "index_all_languages", mnemonics = [ "Javac", "CppCompile", "Python", ], extra_actions = [":indexer"], ) action_listener( name = "index_java", mnemonics = ["Javac"], extra_actions = [":indexer"], ) extra_action( name = "indexer", tools = ["//my/tools:indexer"], cmd = "$(location //my/tools:indexer)" + "--extra_action_file=$(EXTRA_ACTION_FILE)", )
参数
属性 | |
---|---|
name |
此目标的唯一名称。 |
extra_actions
|
action_listener 应添加到构建图的 extra_action 目标的列表。
例如 [ "//my/tools:analyzer" ] 。
|
mnemonics
|
action_listener 应该监听的操作助记符列表,例如 [ "Javac" ] 。
助记符不是公共接口。 无法保证助记法及其操作方式不会改变。 |
extra_action
查看规则来源extra_action(name, data, cmd, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, licenses, out_templates, requires_action_output, restricted_to, tags, target_compatible_with, testonly, toolchains, tools, visibility)
警告:其他操作已弃用。请改用方面。
将 extra_action
规则指定为常规构建目标时,不会生成任何有意义的输出。相反,它允许工具开发者在构建图中插入覆盖现有操作的其他操作。
如需详细了解如何启用 extra_action
,请参阅 action_listener
。
extra_action
作为命令行运行。命令行工具可以访问包含协议缓冲区的文件(格式为 $(EXTRA_ACTION_FILE)),该文件包含有关其被覆盖的原始操作的详细信息。
它还可以访问原始操作有权访问的所有输入文件。
如需详细了解协议缓冲区内存储的数据,请参阅 extra_actions_base.proto。每个 proto 文件都包含 ExtraActionInfo 消息。
与所有其他操作一样,额外的操作也进行了沙盒化处理,因此应该能够处理这种情况。
参数
属性 | |
---|---|
name |
此目标的唯一名称。 您可以在 action_listener 规则的 extra_actions 参数中通过 label 引用此规则。
|
cmd
|
与 genrule cmd 属性类似,但存在以下差异:
|
out_templates
|
extra_action 命令生成的文件的模板列表。模板可以使用以下变量:
|
requires_action_output
|
extra_action 要求原始操作的输出作为此 extra_action 的输入显示。
如果为 true(默认值为 false),extra_action 可能会假设原始操作输出是其输入的一部分。 |
tools
|
tool 依赖项列表。
如需了解详情,请参阅依赖项的定义。
构建系统可确保这些前提条件是在运行 所有工具及其数据依赖关系都整合到了一个树中,该命令可以使用相对路径。工作目录将成为该统一树的根目录。 |