Reglas de acciones adicionales

Reglas

• 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)

ADVERTENCIA: Las acciones adicionales dejaron de estar disponibles. En su lugar, usa aspectos.

Una regla action_listener no produce ningún resultado. En cambio, permite a los desarrolladores de herramientas insertar extra_actions en el sistema de compilación proporcionando una asignación de acción a extra_action .

Los argumentos de esta regla asignan mnemónicos de acción a reglas de extra_action.

Si especificas la opción --experimental_action_listener=<label>, la compilación usará el action_listener especificado para insertar extra_action en el gráfico de compilación.

Ejemplo

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

Argumentos

Atributos
name	Name; required Un nombre único para este destino.
extra_actions	List of labels; required Una lista de extra_action objetivos que este action_listener debe agregar al gráfico de compilación P.ej., [ "//my/tools:analyzer" ].
mnemonics	List of strings; required Una lista de mnemónicos de acción que debe escuchar este action_listener, p. ej., [ "Javac" ] Los mnemónicos no son una interfaz pública. No hay garantía de que los mnemónicos y sus acciones no cambien.

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)

ADVERTENCIA: Las acciones adicionales dejaron de estar disponibles. En su lugar, usa aspectos.

Una regla extra_action no produce ningún resultado significativo cuando se especifica como un objetivo de compilación normal. En cambio, permite a los desarrolladores de herramientas insertar acciones adicionales en el gráfico de compilación que sustituyen las acciones existentes.

Consulta action_listener para obtener detalles sobre cómo habilitar los extra_action.

Los extra_action se ejecutan como una línea de comandos. La herramienta de línea de comandos obtiene acceso a un archivo que contiene un búfer de protocolo como $(EXTRA_ACTION_FILE) con información detallada sobre la acción original que reemplaza. También tiene acceso a todos los archivos de entrada a los que tiene acceso la acción original. Consulta extra_actions_base.proto para obtener detalles sobre los datos almacenados dentro del búfer de protocolo. Cada archivo proto contiene un mensaje ExtraActionInfo.

Al igual que todas las demás acciones, las acciones adicionales se guardan en una zona de pruebas y deben diseñarse para controlarlas.

Argumentos

Atributos
name	Name; required Un nombre único para este destino. Puedes hacer referencia a esta regla con label en el argumento extra_actions de las reglas action_listener.
cmd	String; required El comando que se ejecutará. Es similar al atributo genrule cmd con las siguientes diferencias: Sin expansión de etiquetas heurística. Solo se expanden las etiquetas que utilizan $(location ...). Se aplica un pase adicional a la string para reemplazar todos los casos de los resultados creados a partir del atributo out_templates. Todos los casos de $(output out_template) se reemplazan por la ruta de acceso al archivo indicado por label. P.ej., $(ACTION_ID).analysis out_template se puede hacer coincidir con $(output $(ACTION_ID).analysis). En efecto, es la misma sustitución que $(location), pero con un alcance diferente.
out_templates	List of strings; optional Una lista de plantillas para archivos que genera el comando extra_action. La plantilla puede usar las siguientes variables: $(ACTION_ID), un ID que identifica de forma exclusiva este extra_action. Se usa para generar un archivo de salida único.
requires_action_output	Boolean; optional; default is False Indica que extra_action requiere que la salida de la acción original esté presente como entrada en este extra_action. Cuando es verdadero (predeterminado en falso), la extra_action puede suponer que los resultados de la acción original están disponibles como parte de sus entradas.
tools	List of labels; optional Una lista de tool dependencias para esta regla. Consulta la definición de dependencias para obtener más información. El sistema de compilación garantiza que estos requisitos previos se compilen antes de ejecutar el comando extra_action. Se compilan con la configuración host, ya que deben ejecutarse como una herramienta durante la compilación. La ruta de acceso de un //x:y de destino tools individual se puede obtener mediante $(location //x:y). Todas las herramientas y sus dependencias de datos se consolidan en un solo árbol en el que el comando puede usar rutas de acceso relativas. El directorio de trabajo será la raíz de ese árbol unificado.