Gradle 快取

Tuist 提供一個 Gradle 外掛程式，可與 Gradle 內建的建構快取整合，以遠端分享建構產物。當任務的輸出已存在於快取中時，Gradle 會略過執行並從 Tuist 的遠端快取提取結果，為你的團隊和 CI 環境節省建構時間。

安裝 Tuist Gradle 外掛程式後，你還需要在 gradle.properties 檔案中啟用 Gradle 的建構快取：

plaintext

org.gradle.caching=true

如果沒有此設定，Gradle 不會啟動其建構快取子系統——即使已設定遠端快取——所有任務都會執行，而不會命中或填充快取。啟用後，Gradle 會將 Tuist 用作遠端建構快取，在快取命中時下載已快取的任務輸出，並在任務執行後上傳它們。

快取上傳政策#

預設情況下，外掛程式會同時下載和上傳產物到遠端快取。你可以使用 buildCache 區塊中的 push 選項來控制上傳：

kotlin

tuist {
    buildCache {
        push = false // read-only mode
    }
}

常見的做法是僅從 CI 推送產物，因為那裡的建構是可重現的，同時保持本機環境為唯讀：

kotlin

tuist {
    buildCache {
        push = System.getenv("CI") != null
    }
}

透過此設定，本機構建可以受益於已快取的產物而無需上傳，而 CI 構建則會為團隊其他成員填充快取。

對於 CI 環境，請使用驗證指南中的一種方法進行驗證。請參閱持續整合指南以獲取特定供應商的 CI 範例。

Gradle 同時維護本機和遠端建構快取。本機建構快取將任務輸出儲存在磁碟上的 ~/.gradle/caches/build-cache-1 目錄下。

當 Tuist 設定為遠端建構快取時，建議在 CI 上停用本機建構快取。這可以避免在 CI 執行器上儲存冗餘產物，並確保建構始終為團隊其他成員以新條目填充遠端快取。

在你的 settings.gradle.kts 中停用 CI 上的 Gradle 本機建構快取：

kotlin

buildCache {
    local {
        isEnabled = System.getenv("CI") == null
    }
}

這使得本機建構快取可用於本機開發，同時在 CI 上停用它，由 Tuist 的遠端快取處理產物分享。

buildCache 區塊支援：