Правила дополнительных действий

Правила

• action_listener
• extra_action

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>, сборка будет использовать указанный action_listener для вставки extra_action в граф сборки.

Пример

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)",
)

Аргументы

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. Каждый прото-файл содержит сообщение ExtraActionInfo.

Как и все остальные действия, дополнительные действия находятся в защищенной среде и должны быть разработаны с учетом этого.

Аргументы