工具链解析实现详情

报告问题 查看源代码 每夜 build · 8.0 · 7.4 · 7.3 · 7.2 · 7.1 · 7.0 · 6.5

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

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

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

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

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

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

   1. 首先，移除不针对每个请求的工具链类型提供有效工具链的任何执行平台。
   2. 如果剩余多个执行平台，请选择优先级最高的平台（即最先注册的平台）。
      1. 如果执行平台已由工具链转换设置，则系统会先选择该平台，如下所述。

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

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