动作

报告问题 查看源代码 每夜 build · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

在规则分析期间创建的操作。

此对象可供测试之用，并且可以从 Actions 提供程序获取。通常，在规则的实现函数中访问 Action 对象或其字段是没有必要的。您可以改为参阅“规则”页面，了解在定义自定义规则时如何使用操作；也可以参阅API 参考文档，了解如何创建操作。

此对象的某些字段仅适用于某些类型的操作。不适用的字段会设置为 None。

成员

args

sequence Action.args

冻结的 Args 对象列表，其中包含与操作实参相关的信息。这些对象包含准确的参数信息，包括涉及展开的操作输出目录的参数。不过，在分析阶段无法读取 Args 对象。如需了解分析阶段可用的参数的较不精确说明，请参阅 argv。

请注意，某些类型的操作尚不支持公开此字段。对于此类操作类型，此值为 None。 可以返回 None。

argv

sequence Action.argv

对于通过 ctx.actions.run() 或 ctx.actions.run_shell() 创建的操作，要执行的命令行的参数不可变列表。请注意，对于 shell 操作，前两个参数将是 shell 路径和 "-c"。 可能会返回 None。

内容

string Action.content

对于由 ctx.actions.write() 或 ctx.actions.expand_template() 创建的操作，如果这些内容可以在分析阶段计算，则为要写入的文件的内容。如果在执行阶段之前无法确定内容（例如，需要展开 Args 对象中的目录），则值为 None。 可以返回 None。

env

dict Action.env

此操作的“固定”环境变量。这仅包括由操作定义明确设置的环境设置，因此会忽略仅在执行环境中预先设置的设置。

输入

depset Action.inputs

此操作的一组输入文件。

助记符

string Action.mnemonic

此操作的助记符。

输出

depset Action.outputs

此操作的一组输出文件。

substitutions

dict Action.substitutions

对于由 ctx.actions.expand_template()（用于保存替换映射的不可变字典）创建的操作。 可以返回 None。