雜湊

快取或選擇性測試執行等功能，需要一種方法來判斷目標是否已變更。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 版本相符。

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