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 que los desarrolladores de herramientas inserten extra_action en el sistema de compilación, ya que proporciona una asignación de acción a extra_action .

Los argumentos de esta regla asignan mnemónicos de acción a las reglas 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

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

name

Name; required

Un nombre único para este objetivo.

extra_actions

List of labels; required

Es una lista de destinos extra_action que esta action_listener debe agregar al gráfico de compilación. P.ej., [ "//my/tools:analyzer" ].

mnemonics

List of strings; required

Es una lista de mnemotecnias de acciones que este action_listener debe detectar, p.ej., [ "Javac" ].

Los mnemónicos no son una interfaz pública. No hay garantía de que las mnemotecnias 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 que los desarrolladores de herramientas inserten acciones adicionales en el gráfico de compilación que oculten las acciones existentes.

Consulta action_listener para obtener detalles sobre cómo habilitar 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 a la que hace sombra. 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 encuentran en la zona de pruebas y deben diseñarse para controlar eso.

Argumentos

Atributos
`name`	`Name; required` Un nombre único para este objetivo. Puedes consultar esta regla con `label` en el argumento `extra_actions` de las reglas `action_listener`.
`cmd`	`String; required` Es el comando que se ejecutará. Es similar al atributo cmd de genrule con las siguientes diferencias: No hay expansión de etiquetas heurísticas. Solo se expanden las etiquetas que usan $(location …). Se aplica un pase adicional a la cadena para reemplazar todas las ocurrencias 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 que se indica con `label`. Por ejemplo, out_template `$(ACTION_ID).analysis` puede coincidir con `$(output $(ACTION_ID).analysis)`. En efecto, esta es la misma sustitución que `$(location)`, pero con un alcance diferente.
`out_templates`	`List of strings; optional` Es una lista de plantillas para los 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 este `extra_action` requiere que el resultado de la acción original esté presente como entrada para este `extra_action`. Cuando es verdadero (predeterminado como falso), 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` Es una lista de dependencias de `tool` para esta regla. Consulta la definición de dependencias para obtener más información. El sistema de compilación se asegura de 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 un objetivo `//x:y` individual de `tools` se puede obtener con `$(location //x:y)`. Todas las herramientas y sus dependencias de datos se consolidan en un solo árbol dentro del cual el comando puede usar rutas de acceso relativas. El directorio de trabajo será la raíz de ese árbol unificado.