工具链解析实现详情

每夜版 · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

注意：本部分面向 Bazel 开发者，规则作者无需了解。

多个 SkyFunction 类实现了工具链解析流程：

  1. RegisteredToolchainsFunction 和 RegisteredExecutionPlatformsFunction 根据当前配置和 WORKSPACE 文件查找可用的工具链和执行平台。

  2. SingleToolchainResolutionFunction 为每个执行平台解析单个工具链类型。也就是说，对于每个执行平台，它都会根据以下条件找到要使用的最佳注册工具链：

    1. 通过检查 target_compatible_with 属性，确保工具链和目标平台兼容。
    2. 通过检查 exec_compatible_with 属性，确保工具链和执行平台兼容。
    3. 如果还剩下多个工具链，请选择优先级最高的工具链（最先注册的工具链）。

  3. ToolchainResolutionFunction 会针对每种请求的工具链类型调用 SingleToolchainResolutionFunction，然后确定要使用的最佳执行平台。

    1. 首先，移除没有适用于每种所请求工具链类型的有效工具链的任何执行平台。
    2. 如果还剩下多个执行平台，请选择优先级最高的平台（最先注册的平台）。
      1. 如果执行平台已通过工具链过渡设置，则会先选择该平台，如下所述。

如工具链和配置中所述，从目标到工具链的依赖项使用一种特殊配置，该配置会强制使两者的执行平台相同。尽管名称为“toolchain transition”，但它不是作为配置转换来实现的，而是作为 ConfiguredTargetKey 的一个特殊子类来实现的，称为 ToolchainDependencyConfiguredTargetKey。除了 ConfiguredTargetKey 中的其他数据之外，此子类还包含执行平台的标签。当 ToolchainResolutionFunction 考虑使用哪个执行平台时，如果 ToolchainDependencyConfiguredTargetKey 中的强制执行平台有效，即使它不是最高优先级的，也会被使用。

注意：如果强制执行平台无效（因为没有有效的工具链，或者因为规则或目标的执行限制），则会改用优先级最高的有效执行平台。