持續整合 (CI){#continuous-integration-ci}

若要在 CI 上使用註冊表，您需要在工作流程中執行tuist registry login ，以確保已登入註冊表。

[!NOTE] Only Xcode Integration

只有當您使用 Xcode 整合套件時，才需要建立新的預先解鎖鑰匙鏈。

由於註冊表憑證儲存在鑰匙鏈中，因此您需要確保在 CI 環境中可以存取鑰匙鏈。請注意，有些 CI 提供者或自動化工具（例如 Fastlane）已經建立臨時的 keychain，或提供內建的方式來建立 keychain。不過，您也可以使用下列程式碼建立自訂步驟，以建立臨時keychain：

bash

TMP_DIRECTORY=$(mktemp -d)
KEYCHAIN_PATH=$TMP_DIRECTORY/keychain.keychain
KEYCHAIN_PASSWORD=$(uuidgen)
security create-keychain -p $KEYCHAIN_PASSWORD $KEYCHAIN_PATH
security set-keychain-settings -lut 21600 $KEYCHAIN_PATH
security default-keychain -s $KEYCHAIN_PATH
security unlock-keychain -p $KEYCHAIN_PASSWORD $KEYCHAIN_PATH

tuist 註冊登入 會將憑證儲存於預設的 keychain 中。在執行_ tuist 註冊登入 之前，請確保已建立預設的 keychain 並解除鎖定_。

此外，您需要確保TUIST_TOKEN 環境變數已設定。您可以按照說明文件 <LocalizedLink href="/guides/server/authentication#as-a-project"> 這裡 </LocalizedLink> 建立一個。

GitHub Actions 的示例工作流程如下：

yaml

name: Build

jobs:
  build:
    steps:
      - # Your set up steps...
      - name: Create keychain
        run: |
        TMP_DIRECTORY=$(mktemp -d)
        KEYCHAIN_PATH=$TMP_DIRECTORY/keychain.keychain
        KEYCHAIN_PASSWORD=$(uuidgen)
        security create-keychain -p $KEYCHAIN_PASSWORD $KEYCHAIN_PATH
        security set-keychain-settings -lut 21600 $KEYCHAIN_PATH
        security default-keychain -s $KEYCHAIN_PATH
        security unlock-keychain -p $KEYCHAIN_PASSWORD $KEYCHAIN_PATH
      - name: Log in to the Tuist Registry
        env:
          TUIST_TOKEN: ${{ secrets.TUIST_TOKEN }}
        run: tuist registry login
      - # Your build steps

跨環境的遞增解析度{#incremental-resolution-across-environments}

使用我們的註冊表進行清潔/冷卻解析會稍微快一點，如果您在 CI 建置中持續使用已解析的相依性，您可以體驗到更大的改進。請注意，由於註冊表的存在，您需要儲存與還原的目錄大小比沒有使用註冊表時小得多，所花費的時間也顯著減少。使用預設的 Xcode 套件整合時，若要快取相依性，最好的方法是在透過xcodebuild 解析相依性時，指定自訂的clonedSourcePackagesDirPath 。這可以透過在您的Config.swift 檔案中加入下列內容來完成：

swift

import ProjectDescription

let config = Config(
    generationOptions: .options(
        additionalPackageResolutionArguments: ["-clonedSourcePackagesDirPath", ".build"]
    )
)

此外，您還需要找到Package.resolved 的路徑。您可以執行ls **/Package.resolved 來取得路徑。路徑應該看起來像App.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved 。

對於 Swift 套件和基於 XcodeProj 的整合，我們可以使用位於專案根目錄或Tuist 目錄中的預設.build 目錄。設定管道時，請確定路徑正確。

以下是使用預設 Xcode 套件整合時，GitHub Actions 解析和快取相依性的工作流程範例：

yaml

- name: Restore cache
  id: cache-restore
  uses: actions/cache/restore@v4
  with:
    path: .build
    key: ${{ runner.os }}-${{ hashFiles('App.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved') }}
- name: Resolve dependencies
  if: steps.cache-restore.outputs.cache-hit != 'true'
  run: xcodebuild -resolvePackageDependencies -clonedSourcePackagesDirPath .build
- name: Save cache
  id: cache-save
  uses: actions/cache/save@v4
  with:
    path: .build
    key: ${{ steps.cache-restore.outputs.cache-primary-key }}