雜湊

快取或選擇性測試執行等功能，需要一種方法來判斷目標是否已變更。Tuist 會為依賴圖中的每個目標計算雜湊值，以判斷目標是否已變更。雜湊值是根據以下屬性計算：

• 目標的屬性（例如名稱、平台、產品等）
• 目標的檔案
• 目標依賴項的雜湊值

快取屬性#

此外，在計算 快取的雜湊值時，我們亦會對以下屬性進行雜湊。

Swift 版本#

我們會對執行命令 /usr/bin/xcrun swift --version 所得的 Swift 版本進行雜湊，以防止因目標與二進位檔之間的 Swift 版本不相符而導致編譯錯誤。

組態#

在計算快取雜湊值時，Tuist 會將每個專案和目標的設定範圍限定於已解析的建置組態。即由 --configuration 指定的組態；若未指定，則為專案的 defaultConfiguration；若仍無，則為第一個除錯組態。Tuist 會將該組態的名稱、變體、建置設定及組態檔案內容，連同適用於它的共用基礎設定一併進行雜湊。新增、移除或更改其他組態不會影響已解析組態的快取雜湊值。由於只有已解析的組態至關重要，因此透過明確指定 --configuration 所填充的快取，可被解析至相同組態但未傳遞該旗標的命令讀取。

除錯#

如果你發現在不同環境或呼叫中使用快取時出現非確定性行為，這可能與環境差異或雜湊邏輯中的錯誤有關。我們建議依照以下步驟來除錯此問題：

1. 執行 tuist hash cache 或 tuist hash selective-testing（分別為 二進位快取 或 選擇性測試 的雜湊值），複製雜湊值，重新命名專案目錄，然後再次執行命令。雜湊值應該相符。
2. 如果雜湊值不相符，很可能是因為產生的專案依賴環境。在這兩種情況下執行 tuist graph --format json 並比較圖表。或者，產生專案並使用如 Diffchecker 的差異比較工具來比較它們的 project.pbxproj 檔案。
3. 如果雜湊值相同但在不同環境（例如 CI 和本機）之間有差異，請確保各處都使用相同的 組態 和 Swift 版本。Swift 版本與 Xcode 版本綁定，因此請確認 Xcode 版本相符。

如果雜湊值仍然非確定性，請告訴我們，我們可以協助除錯。