Xcode 快取

Tuist 支援 Xcode 編譯快取，讓團隊可以運用建置系統的快取功能，共享編譯產物。

Xcode 快取於 Xcode 26 引入。你也可能看到它被稱為 Xcode 建置快取；它會根據輸入內容作為鍵來重複使用編譯產物，而 Tuist 的遠端快取讓這些產物可以在不同機器之間共享。

與模組快取搭配使用

Xcode 快取與模組快取在不同粒度層級運作，並互相補充。模組快取在建置執行前，以預先建置好的.xcframework取代整個模組；而 Xcode 快取則在建置期間重複使用編譯輸出。

在開發者機器上清理時，保留CompilationCache.noindex

預設情況下，編譯快取儲存區位於DerivedData內，因此刪除DerivedData會連同建置產物一起移除。在開發者機器上，建議只刪除建置產物：重新建置時會從磁碟上的儲存區重放，無需抓取任何內容。

設定#

如果你還沒有 Tuist 帳號和專案，可以執行以下指令來建立：

bash

tuist init

當你擁有參考你fullHandle的Tuist.swift檔案後，可以執行以下指令為你的專案設定快取：

bash

tuist setup cache

此指令會建立一個LaunchAgent，在啟動時執行本機快取服務，供 Swift 建置系統用來共享編譯產物。請先在開發者機器上執行，並作為每個 CI 工作設定的一部分。

若要在 CI 上設定快取，請確保你已通過驗證。

快取代理程式使用穩定的啟動器，而非綁定到上次執行設定的 Tuist 安裝路徑。安裝後，tuist setup cache與啟用快取的tuist generate會將可用的目標推進至較新的 Tuist 版本。因此，綁定到較舊 Tuist 的專案不會降級共享的代理程式。生成只會更新現有的啟動器目標：它不會安裝服務、進行驗證、取代外掛程式，或重新啟動代理程式。自訂的外掛程式、代理程式、通訊端或註冊表覆寫會略過自動推進。

執行中的代理程式只會在至少 30 秒沒有快取請求、沒有任何請求或背景工作進行中，且其發布佇列已排空的情況下，才會採用新目標。隨後它會退出，launchd 會啟動所選的 CLI，並保留服務的參數與憑證環境。只有實際採用目標的代理程式會原子性地從其套件刷新磁碟上的外掛程式；在舊代理程式仍在排空時，設定不會安裝較新的外掛程式。如果已安裝的外掛程式遺失，明確的空閒設定會重新啟動所選代理程式以重試刷新。仍然只有一個代理程式擁有註冊表與佇列。目標不可用或上傳未排空會延遲切換，而不是中斷進行中的請求。憑證刷新會跟隨所選的 CLI，甚至在切換之前，因此移除較舊的 CLI 安裝不會導致等待排空的上傳被擱置。

在穩定啟動器之前建立的現有安裝需要一次明確的遷移。在沒有建置執行時執行以下指令：

bash

tuist setup cache

完成該遷移後，更新 Tuist 並執行你慣用的tuist generate就足以推進代理程式與已安裝的外掛程式；你不需要為每個 CLI 版本重新執行設定。若要選擇不同的 Xcode（包括在同一路徑更新的 Xcode），仍需要明確設定。當共用服務的設定變更時，設定可以取代該服務，因此請先等待機器上的所有建置完成。代理程式同時支援先前與目前的外掛程式協定，因此已在 Xcode 中載入的相容外掛程式在代理程式升級後仍可繼續運作。完全退出並重新開啟 Xcode 以載入最新的外掛程式，但已載入的相容外掛程式不需要立即重新啟動。當版本變更了生成的建置設定時，請重新生成專案。

保持所選的 Tuist 安裝可用：啟動器會用它來啟動、設定與刷新憑證。一旦啟動器已推進，就可以移除較舊的安裝。如果所選的可執行檔已被刪除或不再可執行，tuist setup cache可以使用可用的安裝（即使是較舊的版本）修復目標，而無需先拆除快取。穩定的可執行檔別名會在套件管理器升級時保留；只有在比較安裝身分時才會解析符號連結。啟動時，代理程式會記錄實際啟動的版本，包括就地更新或刻意回滾，同時保留最高使用過的版本，以防止不相關的舊簽出切換可用的安裝。

沒有發行版本的原始碼建置 CLI，以及明確的TUIST_CAS_PLUGIN_PATH或TUIST_CAS_PROXY_PATH設定，會使用明確的啟動設定，而非自動版本選擇。重建這些元件後，請重新執行設定。設定會檢查它們的新鮮度，並在其替換準備好後才停用受管理的目標推進。

tuist teardown cache會在移除啟動器目標之前停止服務，同時為現有專案保留穩定的外掛程式。如果停止服務失敗，其啟動器仍可供重新啟動與再次嘗試拆除。成功拆除後，生成無法重新建立服務。

設定 Xcode 建置設定#

對於現有的 Xcode 專案，將tuist setup cache輸出的建置設定複製到專案的「Build Settings」或現有的.xcconfig檔案中。該指令會輸出你帳號的設定；它不會產生設定檔或編輯你的 Xcode 專案。在擴充OTHER_SWIFT_FLAGS時保留$(inherited)，以確保其他編譯器選項得以保留。

設定包括：

bash

COMPILATION_CACHE_ENABLE_CACHING = YES
COMPILATION_CACHE_ENABLE_PLUGIN = YES
COMPILATION_CACHE_PLUGIN_PATH = $HOME/.local/state/tuist/libtuist_cas_plugin.dylib
COMPILATION_CACHE_REMOTE_SERVICE_PATH = $HOME/.local/state/tuist/cas-proxy.sock
COMPILATION_CACHE_ENABLE_DETACHED_KEY_QUERIES = YES
COMPILATION_CACHE_ENABLE_DIAGNOSTIC_REMARKS = YES
OTHER_SWIFT_FLAGS = $(inherited) -cas-plugin-option tuist-instance=your-org/your-project

請注意，COMPILATION_CACHE_ENABLE_PLUGIN、COMPILATION_CACHE_PLUGIN_PATH、COMPILATION_CACHE_REMOTE_SERVICE_PATH與COMPILATION_CACHE_ENABLE_DETACHED_KEY_QUERIES需要作為使用者定義的建置設定新增，因為它們並未直接在 Xcode 的建置設定 UI 中公開。

外掛程式路徑

libtuist_cas_plugin.dylib是隨 Tuist 附帶的編譯快取外掛程式，位於tuist可執行檔旁邊。tuist setup cache會將其複製到$HOME/.local/state/tuist/libtuist_cas_plugin.dylib，而COMPILATION_CACHE_PLUGIN_PATH指向該副本。該路徑在每台機器上都相同，且在更新 Tuist 時不會改變，因此你可以將此設定與專案一起提交。設定與新啟動的代理程式會從所選的 Tuist 套件刷新副本；從較舊的簽出執行設定不會降級較新的外掛程式。

每個專案共用一個 Socket

tuist setup cache會在每台機器上安裝單一快取代理程式，因此每個專案都使用相同的COMPILATION_CACHE_REMOTE_SERVICE_PATH。tuist-instance外掛程式選項是用來識別專案的。

COMPILATION_CACHE_REMOTE_SERVICE_PATH負責共用 C 與 Objective-C

很容易將此設定解讀為「快取服務所在位置」而視為可選。它同時也是決定是否共用 C、Objective-C、預編譯模組與預編譯標頭檔的開關：只有在設定遠端快取服務時，建置系統才會為這些項目執行快取。若不加入此設定，Swift 編譯仍會共用，但在任何尚未建置過該專案的機器上，每個 C/Objective-C 檔案與每個模組都會重新編譯。

並行快取查詢

COMPILATION_CACHE_ENABLE_DETACHED_KEY_QUERIES會讓建置系統為每次編譯執行的遠端快取查詢與其餘建置工作並行執行，而非在建置的執行通道上一次只處理少數幾個。當從遠端快取錯過或還原大量編譯時，建置會更快完成。

你也可以在執行xcodebuild時透過加入以下旗標來指定這些設定，例如：

bash

xcodebuild build -project YourProject.xcodeproj -scheme YourScheme \
    COMPILATION_CACHE_ENABLE_CACHING=YES \
    COMPILATION_CACHE_ENABLE_PLUGIN=YES \
    COMPILATION_CACHE_PLUGIN_PATH=$HOME/.local/state/tuist/libtuist_cas_plugin.dylib \
    COMPILATION_CACHE_REMOTE_SERVICE_PATH=$HOME/.local/state/tuist/cas-proxy.sock \
    COMPILATION_CACHE_ENABLE_DETACHED_KEY_QUERIES=YES \
    COMPILATION_CACHE_ENABLE_DIAGNOSTIC_REMARKS=YES \
    'OTHER_SWIFT_FLAGS=$(inherited) -cas-plugin-option tuist-instance=your-org/your-project'

Xcode 27 及之後版本的前綴對應

在 Xcode 27 及之後版本中，tuist setup cache還會輸出SWIFT_ENABLE_PREFIX_MAPPING、SWIFT_ENABLE_PROJECT_PREFIX_MAPPING、CLANG_ENABLE_PREFIX_MAPPING與CLANG_ENABLE_PROJECT_PREFIX_MAPPING。它們讓編譯快取金鑰獨立於專案與DerivedData所在的路徑。將它們新增為使用者定義的建置設定。啟用它們會改變每個快取金鑰，因此下一次建置會再次填充快取。當enableCaching開啟時，tuist generate會為你設定這些值。

編譯器也會將對應後的路徑寫入程式碼涵蓋率資料，而 Xcode 無法解析它們，因此涵蓋率報告會排除所有使用前綴對應編譯的原始碼。輸出的設定連同TUIST_PREFIX_MAPPING_FOR_COVERAGE_*的設定，會在收集程式碼涵蓋率的建置中關閉前綴對應。tuist generate也會執行相同操作。這些建置仍會使用編譯快取，但它們的快取金鑰取決於專案與DerivedData路徑。

當你在命令列將這些設定傳遞給xcodebuild時，請用單引號包住包含$(...)的值，如同上方的OTHER_SWIFT_FLAGS。否則殼層會將它們展開為空字串，導致前綴對應被關閉：

bash

xcodebuild build -project YourProject.xcodeproj -scheme YourScheme \
    'SWIFT_ENABLE_PREFIX_MAPPING=$(TUIST_PREFIX_MAPPING_FOR_COVERAGE_$(CLANG_COVERAGE_MAPPING))' \
    SWIFT_ENABLE_PROJECT_PREFIX_MAPPING=YES \
    'CLANG_ENABLE_PREFIX_MAPPING=$(TUIST_PREFIX_MAPPING_FOR_COVERAGE_$(CLANG_COVERAGE_MAPPING))' \
    CLANG_ENABLE_PROJECT_PREFIX_MAPPING=YES \
    TUIST_PREFIX_MAPPING_FOR_COVERAGE_=YES \
    TUIST_PREFIX_MAPPING_FOR_COVERAGE_NO=YES \
    TUIST_PREFIX_MAPPING_FOR_COVERAGE_YES=NO

生成的專案

如果你的專案由 Tuist 生成，則無需手動設定這些設定。

在這種情況下，你只需在Tuist.swift檔案中加入enableCaching: true：

swift

import ProjectDescription

let tuist = Tuist(
    fullHandle: "your-org/your-project",
    project: .tuist(
        generationOptions: .options(
            enableCaching: true
        )
    )
)

使用前綴對應的涵蓋率#

預設情況下，生成的專案會為涵蓋率建置停用前綴對應，以確保 Xcode 的涵蓋率報告與xccov正常運作。你可以啟用它，讓涵蓋率編譯在不同簽出之間可共用：

swift

let tuist = Tuist(
    project: .tuist(
        generationOptions: .options(
            enableCaching: true,
            coverage: .coverage(prefixMapping: true)
        )
    )
)

TUIST_COVERAGE_PREFIX_MAPPING環境變數（1或0）優先於prefixMapping。此選項適用於 Xcode 27 及之後版本，且需要enableCaching。涵蓋率tuist test上傳支援此功能：Tuist 使用llvm-cov測量執行，它會讀取具有對應路徑的原始碼，並將它們連結回你儲存庫中的檔案。Xcode 自身的涵蓋率報告與xccov仍可能排除這些原始碼，而如果llvm-cov匯出失敗，上傳退回至結果套件的xccov報告時也可能排除它們。對應後的#filePath值也可能影響相對於原始碼檔案定位測試固定裝置的測試；請改為透過明確的執行期簽出路徑來解析固定裝置。如果你自行處理涵蓋率，請將每個檢測過的二進位檔與其目標的$(TARGET_TEMP_DIR)/compilation-prefix-map.json配對，該檔案會將虛擬前綴對應回本機目錄。當啟用每專案對應時，請勿為每個二進位檔重複使用同一個目標的對應表。

涵蓋率前綴設定會參與二進位快取與選擇性測試的雜湊計算，因為它們控制寫入涵蓋率產物的路徑。變更此選項，或以不同方式設定TUIST_COVERAGE_PREFIX_MAPPING，即使對於一般建置也會使這些雜湊失效。如果開發者與 CI 工作應共用二進位快取與選擇性測試結果，請保持該值一致。

偵錯生成的專案#

還原的原生模組需要連結的除錯資訊以及存取編譯快取。Tuist 會使用 dSYM 與每切片原始碼身分中繼資料來暖身 Debug 與 Release 模組，然後在替換目標之前，根據消費者宣告的原始碼驗證中繼資料。缺少或不兼容的中繼資料會保留該目標的原始碼。腳本生成的.generated(...)原始碼具有宣告指紋，而非可驗證的內容檢查碼，因此這些目標會保持從原始碼建置，且不會發布到原生模組快取。具有實際內容檢查碼的生成資源存取器仍符合資格。不支援的除錯資訊會跳過受影響目標的發布，而不會阻擋不相關的產品；原始碼變更與取消仍會導致暖身失敗。快取格式已變更，因此由較舊版本暖身的產物需要重新暖身。

對於已驗證的替換，Tuist 會在消費者擁有的 dSYM UUID plist 中準備原始碼重定位，並為靜態快取程式碼連結僅供除錯使用的伴隨檔案。它不會重寫快取的二進位檔，也不會在 LLDB 的持久全域原始碼對應表中安裝生產者原始碼路徑。明確的偵錯器初始化器與模組載入器設定仍具權威性。除錯符號與原始碼重定位不會修復相對於原始碼的執行期檔案存取或原生 Xcode 涵蓋率報告；涵蓋率變體選擇與 LLVM 匯出仍是獨立功能。

啟用enableCaching: true後，Tuist 會為 Run 與 Test 動作設定 LLDB 原始碼對應表。當某個動作擁有自訂 LLDB 初始化器時，Tuist 會先寫入已解析的原始碼對應表，然後載入該自訂初始化器，使其能夠擴充或覆寫對應表。否則，它會在替換原始碼對應表之前，若檔案存在則載入~/.lldbinit-Xcode，否則回退至~/.lldbinit。它只會載入一個主目錄檔案，從而恢復每位使用者的偵錯器設定，避免重複載入。此替換會移除先前執行留下的過時對應，並優先於主目錄檔案中的原始碼對應；請將需要保留的原始碼對應條目放入動作的自訂初始化器中。其他主目錄設定則會保留。Tuist 專用於快取的模組搜尋路徑、載入器設定與 Clang 旗標會在之後套用，並優先於使用者對這些設定的值。主目錄檔案的錯誤仍會顯示，但不會阻止後續命令載入，且命令不會被回顯。即使未啟用enableCaching或在較舊的 Xcode 版本上，當 Tuist 為從模組快取還原的二進位檔設定偵錯時，此初始化器保留機制同樣適用。

在 Xcode 27 及更高版本中，除非專案明確設定，否則生成的專案會關閉 Xcode 的每個專案前綴對應（SWIFT_ENABLE_PROJECT_PREFIX_MAPPING與CLANG_ENABLE_PROJECT_PREFIX_MAPPING）。它們的前綴（例如/^src）在每個專案中指代不同的目錄，而 LLDB 僅針對被偵錯目標所屬的專案來解析它們。相反，原始碼會記錄在工作區範圍的前綴之下：/^root代表 Tuist 根目錄，/^spm代表 Swift 套件暫存目錄，而/^intermediates與/^products則代表建置產物。由於每個前綴在所有專案中都指向同一個目錄，因此斷點可以解析工作區中任何專案的原始碼。

Tuist 根目錄之外的路徑不會被對應。位於根目錄之外的專案，其快取金鑰取決於其檢出位置，因此其他檢出副本與機器將無法命中該快取。若要使其金鑰獨立於檢出位置，請在該專案的 manifest 中開啟每個專案的對應：

swift

let checkoutIndependentSettings = Settings.settings(base: [
    "SWIFT_ENABLE_PROJECT_PREFIX_MAPPING": "YES",
    "CLANG_ENABLE_PROJECT_PREFIX_MAPPING": "YES",
])

將這些設定傳遞給該Project。當你偵錯來自另一個專案的目標時，LLDB 將無法找到該專案的原始碼。Manifest 中的專案基礎設定優先於專案層級的 xcconfig 值，因此請直接在 manifest 中設定它們。

變更這些設定會改變編譯快取金鑰、二進位快取雜湊與選擇性測試雜湊，因此這些快取需要重新暖身。請在團隊中保持此選擇的一致性。

快取上傳策略#

預設情況下，快取服務會同時下載並上傳產物至遠端快取。你可以透過Tuist.swift檔案中的xcodeCache選項來控制此行為，以啟用唯讀模式，在此模式下產物會被下載但絕不上傳：

swift

import ProjectDescription

let tuist = Tuist(
    fullHandle: "your-org/your-project",
    xcodeCache: .xcodeCache(
        upload: false
    ),
    project: .tuist(
        generationOptions: .options(
            enableCaching: true
        )
    )
)

常見的做法是僅從 CI 推送產物，因為那裡的建置是可重現的，同時保持本地環境為唯讀。你可以使用Environment.isCI來實現這一點，它會檢查大多數 CI 供應商設定的CI環境變數：

swift

import ProjectDescription

let tuist = Tuist(
    fullHandle: "your-org/your-project",
    xcodeCache: .xcodeCache(
        upload: Environment.isCI
    ),
    project: .tuist(
        generationOptions: .options(
            enableCaching: true
        )
    )
)

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

上傳策略會記錄在執行tuist setup cache的機器上，並按專案區分。若要變更它，請更新upload並再次執行tuist setup cache，如果 Tuist 會生成你的專案，也請執行tuist generate。之後的上傳將遵循新策略，無須在該機器上重新啟動快取。在同一台機器上同時執行的相同專案工作會共用其策略，因此最近的tuist setup cache會為所有工作決定該策略。

儲存大小限制#

編譯快取儲存區會隨著每次建置而成長。若要限制專案的儲存區大小，請在你的Tuist.swift檔案中設定storeSizeLimit：

swift

import ProjectDescription

let tuist = Tuist(
    fullHandle: "your-org/your-project",
    xcodeCache: .xcodeCache(
        storeSizeLimit: .gigabytes(20)
    ),
    project: .tuist(
        generationOptions: .options(
            enableCaching: true
        )
    )
)

當沒有建置正在運行時，Tuist 每 10 分鐘檢查一次專案的每個儲存區。一旦較新的建置寫入了約一半的限制容量，它就會刪除儲存區中最舊的快取產物，使儲存區穩定在限制大小附近。在建置運行期間，儲存區可能會超過限制；若在設定限制時儲存區已經較大，則當新建置寫入足夠資料後，儲存區會縮小。當多個專案共用同一個儲存區（如預設位置所示），則適用其中最小的限制。此限制適用於你執行tuist setup cache的每台機器，因此在變更限制後請再次執行它。

模組快取雜湊#

編譯快取設定不屬於模組快取雜湊。Tuist 會將每個COMPILATION_CACHE_*建置設定，以及每個帶有值的-cas-plugin-option旗標，排除在雜湊計算之外。開啟或關閉enableCaching，或變更上傳政策，不會改變你目標的雜湊，因此你已暖身的模組快取二進位檔仍然有效。你可以針對同一個模組快取，比較有與沒有 Xcode 快取的建置結果。

前綴對應設定會被雜湊化

在 Xcode 27 及更高版本中，enableCaching: true也會設定SWIFT_ENABLE_PREFIX_MAPPING、SWIFT_ENABLE_PROJECT_PREFIX_MAPPING、CLANG_ENABLE_PREFIX_MAPPING、CLANG_ENABLE_PROJECT_PREFIX_MAPPING以及TUIST_PREFIX_MAPPING_FOR_COVERAGE_*設定。這些設定屬於模組快取雜湊的一部分，因此在 Xcode 27 及更高版本中，開啟或關閉enableCaching會改變你目標的雜湊值。

重用大型產物的部分內容#

Xcode 快取可以透過內容定義分塊來減少傳輸量。它不會將每個大型產物視為與早期版本無關，而是根據其內容在邊界處分割壓縮後的產物。編輯後，即使偏移量已改變，匹配的區塊仍可被重用。

上傳僅發送伺服器缺少的區塊。下載時會先獲取精確的快取動作與產物的區塊配方，然後重用儲存在本地機器上的已驗證區塊，並獲取缺失的部分。完整的重建產物在還原至編譯器快取之前會經過驗證。

傳輸區塊快取與DerivedData分開，因此其區塊可以在清理編譯快取或重新啟動本地快取服務後依然存在。它是可棄用的，區塊負載上限為 1 GiB，另有一個最多 2 MiB 的臨時暫存檔案。被驅逐或損壞的區塊會在需要時重新下載。保留編譯快取本身仍然比重建其內容更快。

用戶端僅在伺服器宣告支援相容功能時，才會使用分塊傳輸。較舊的用戶端仍可讀取完整的產物，而連線至較舊或不支援伺服器的用戶端則維持一般傳輸。小型產物仍沿用現有的完整產物路徑。

這會減少傳輸位元組數，但不會改變編譯器失效行為。變更原始碼檔案可能仍需重新編譯；分塊有助於發布或還原產生的產物。節省量取決於產物與編輯內容，若機器為冷啟動且沒有匹配的區塊，則必須下載整個產物。

持續整合#

若要在 CI 環境中啟用快取，你需要執行與本地環境相同的指令：tuist setup cache。

進行驗證時，你可以使用OIDC 驗證（建議用於支援的 CI 供應商），或透過TUIST_TOKEN環境變數使用帳戶權杖。

以下是使用 OIDC 驗證的 GitHub Actions 工作流程範例：

yaml

name: Build

permissions:
  id-token: write
  contents: read

jobs:
  build:
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v4
      - uses: jdx/mise-action@v2
      - run: tuist auth login
      - run: tuist setup cache
      - # Your build steps

請參閱持續整合指南以查看更多範例，包括基於權杖的驗證以及其他 CI 平台，如 Xcode Cloud、CircleCI、Bitrise 和 Codemagic。

CI 上的編譯快取儲存庫#

編譯快取儲存庫是 Xcode 存放編譯產物的本地目錄。COMPILATION_CACHE_CAS_PATH建置設定會設定其位置，預設為DerivedData內的CompilationCache.noindex。

有狀態儲存庫#

若要在建置之間保留儲存庫，請將COMPILATION_CACHE_CAS_PATH（以及用於tuist cache的TUIST_COMPILATION_CACHE_CAS_PATH）指向一個持久路徑，並透過儲存庫大小限制限定其大小。

疑難排解#

建置警告指出 Xcode 快取代理伺服器失敗#

如果建置顯示如下警告，Xcode 會根據哪個編譯首先遇到失敗，在前方加上CAS error:或CAS operation failed:：

yaml

warning: CAS error: The Tuist Xcode cache proxy at /Users/you/.local/state/tuist/cas-proxy.sock failed (proxy connect: No such file or directory (os error 2)). Compilations that needed it used the local cache only, without remote cache hits. Their uploads are kept on disk and sent once the proxy is reachable again. Run `tuist setup cache` if the proxy is not running.

這表示編譯快取無法連接到由tuist setup cache安裝的本地快取代理伺服器。建置仍然成功，但受影響的編譯無法命中遠端快取，因此運作方式如同空快取的建置。它們的上傳內容會保留在磁碟上，並在代理伺服器再次處理請求時發送：如果在同一個建置期間恢復連線，則會在該建置稍後發送；否則會在同一台機器的下一次建置期間發送。作業結束後被丟棄的 CI 機器會遺失這些資料。警告會在每次建置中出現一次，顯示在 Xcode 的問題導覽器及xcodebuild輸出中。

若要檢查代理伺服器是否正在執行，請尋找監聽警告中所述 Socket 的處理程序：

bash

lsof ~/.local/state/tuist/cas-proxy.sock

如果指令沒有輸出任何內容，請執行tuist setup cache以重新啟動代理伺服器。在 CI 上，請在每個作業中的任何xcodebuild呼叫之前執行tuist setup cache。

建置極度緩慢並發出`CAS error: deadlineExceeded`警告#

如果你的建置時間遠長於預期，且 Xcode 建置日誌充滿了如下警告：

bash

Warning: CAS error: deadlineExceeded(connectionError: Optional(connect(descriptor:addr:size:): No such file or directory (errno: 2)))
note: cache key query failed

或：

bash

Warning: CAS error: deadlineExceeded(connectionError: Optional(connect(descriptor:addr:size:): Connection refused (errno: 61)))

這表示COMPILATION_CACHE_REMOTE_SERVICE_PATH指向一個無人監聽的 Socket，通常是早期版本的 Tuist 設定的每個專案 Socket（~/.local/state/tuist/<org>_<project>.sock）。Tuist 不再提供該 Socket。Xcode 會在每次編譯快取請求時重試連線，而不是快速失敗，這可能導致建置耗時一小時或更久，而 Tuist 無法改變此行為。

修正方法：

產生的專案：再次執行tuist generate。
其他專案：將COMPILATION_CACHE_*建置設定替換為tuist setup cache輸出的設定，詳情請參閱設定 Xcode 建置設定。

如果你未使用 Xcode 快取，請改為移除COMPILATION_CACHE_*建置設定並執行tuist teardown cache。

即使已停用上傳，本地仍出現`uploaded CAS output`#

當設定xcodeCache: .xcodeCache(upload: false)（或在非 CI 機器上設定upload: Environment.isCI）時，你仍可能在建置日誌中看到note: uploaded CAS output ...。xcodebuild無法跳過這些呼叫，因此 Tuist 仍會接收它們，但不會向 Tuist 伺服器發布任何內容。儀表板指標已考慮此情況，因此不會報告虛假的上傳流量。