Detalles de la implementación de la resolución de la cadena de herramientas

Nocturno · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

Nota: Esta sección está destinada a los desarrolladores de Bazel y no es necesaria para los autores de reglas.

Varias clases de SkyFunction implementan el proceso de resolución de la cadena de herramientas:

  1. RegisteredToolchainsFunction y RegisteredExecutionPlatformsFunction encuentran las cadenas de herramientas y las plataformas de ejecución disponibles según la configuración actual y el archivo WORKSPACE.

  2. SingleToolchainResolutionFunction resuelve un solo tipo de cadena de herramientas para cada plataforma de ejecución. Es decir, para cada plataforma de ejecución, encuentra la mejor cadena de herramientas registrada para usar según los siguientes criterios:

    1. Verifica que la cadena de herramientas y la plataforma de destino sean compatibles. Para ello, consulta el atributo target_compatible_with.
    2. Comprueba el atributo exec_compatible_with para asegurarte de que la cadena de herramientas y la plataforma de ejecución sean compatibles.
    3. Si quedan varias cadenas de herramientas, elige la de mayor prioridad (la que se registró primero).

  3. ToolchainResolutionFunction llama a SingleToolchainResolutionFunction para cada tipo de cadena de herramientas solicitado y, luego, determina la mejor plataforma de ejecución para usar.

    1. Primero, quita cualquier plataforma de ejecución que no tenga una cadena de herramientas válida para cada tipo de cadena de herramientas solicitada.
    2. Si quedan varias plataformas de ejecución, elige la de mayor prioridad (la que se registró primero).
      1. Si la plataforma de ejecución ya está establecida por la transición de la cadena de herramientas, se seleccionará primero como se describe a continuación.

Como se explicó en Cadenas de herramientas y configuraciones, la dependencia de un destino a una cadena de herramientas usa una configuración especial que obliga a que la plataforma de ejecución sea la misma para ambos. A pesar del nombre "transición de la cadena de herramientas", esto no se implementa como una transición de configuración, sino como una subclase especial de ConfiguredTargetKey, llamada ToolchainDependencyConfiguredTargetKey. Además de los otros datos en ConfiguredTargetKey, esta subclase también contiene la etiqueta de la plataforma de ejecución. Cuando ToolchainResolutionFunction considera qué plataforma de ejecución usar, si la plataforma de ejecución forzada de ToolchainDependencyConfiguredTargetKey es válida, se usará incluso si no es la de mayor prioridad.

Nota: Si la plataforma de ejecución forzada no es válida (porque no hay cadenas de herramientas válidas o debido a restricciones de ejecución de la regla o el destino), se usará la plataforma de ejecución válida con la prioridad más alta.