散列
缓存或选择性测试执行等功能需要一种方法来确定目标是否已发生变化。Tuist会为依赖关系图中的每个目标计算哈希值，以确定目标是否已发生变化。哈希值的计算基于以下属性：
- 目标的属性（如名称、平台、产品等）
- 目标文件
- 目标依赖项的哈希值
缓存属性
此外，在计算 caching 的哈希值时，我们还会对以下属性进行哈希处理。
Swift 版本
我们散列了通过运行命令/usr/bin/xcrun swift --version 获得的 Swift 版本，以防止由于目标和二进制文件之间的 Swift 版本不匹配而导致编译错误。
模块稳定性信息
以前版本的二进制缓存依赖BUILD_LIBRARY_FOR_DISTRIBUTION 构建设置来启用模块稳定性，并在任何版本的编译器中使用二进制文件。然而，在使用不支持模块稳定性的目标的项目中，这会导致编译问题。生成的二进制文件与用于编译它们的 Swift 版本绑定，而 Swift 版本必须与用于编译项目的版本一致。
:::
配置
使用-configuration 标志的目的是确保调试二进制文件不被用于发布版本的构建，反之亦然。然而，我们仍然缺少一种机制来从项目中移除其他配置，以防止它们被使用。
调试
如果在跨环境或调用中使用缓存时发现非确定性行为，这可能与环境差异或散列逻辑中的错误有关。我们建议按照以下步骤调试问题：
- 运行
tuist hash cache或tuist hash selective-testing（哈希值用于二进制缓存或选择性测试），复制哈希值，重命名项目目录，然后再次运行命令。哈希值应该匹配。 - 如果哈希值不匹配，很可能是生成的项目依赖于环境。在两种情况下运行
tuist graph --format json并比较图形。或者，生成项目并使用 Diffchecker 等差分工具比较它们的project.pbxproj文件。 - 如果哈希值相同，但在不同环境（例如 CI 和本地环境）中有所不同，请确保在所有环境中使用相同的 configuration 和 Swift version。Swift 版本与 Xcode 版本绑定，因此请确认 Xcode 版本是否匹配。
如果哈希值仍然是非确定的，请告诉我们，我们可以帮助调试。
信息 更好的调试体验计划
改善调试体验已列入我们的路线图。print-hashes 命令缺乏理解差异的上下文，将被一个更友好的命令所取代，该命令使用树状结构来显示哈希值之间的差异。
:::