# 持续集成 (CI) {#continuous-integration-ci}

注册表在 CI 环境中开箱即用，无需额外的身份验证配置。默认情况下，每个 IP 地址的未认证请求速率限制为**每分钟 1,000 次请求**。

如果你需要更高的速率限制（**每分钟 20,000 次请求**），可以通过运行 `tuist registry login` 进行身份验证。这需要设置 `TUIST_TOKEN` 环境变量。你可以按照<.localized_link href="/guides/server/authentication#account-tokens">身份验证指南</.localized_link>创建账户令牌。

> [!NOTE]
> 仅当你使用 `tuist registry login` 获取更高速率限制时，才需要以下钥匙串设置。在大多数情况下，默认的未认证速率限制已足够，你可以完全跳过此步骤。
>
> 此外，仅在使用包的 Xcode 集成时，才需要创建一个新的预解锁钥匙串。


由于 `tuist registry login` 将凭据存储在钥匙串中，你需要确保在 CI 环境中可以访问该钥匙串。请注意，某些 CI 提供商或自动化工具（如 [Fastlane](https://fastlane.tools/)）已经会创建临时钥匙串，或提供内置的创建方式。不过，你也可以通过以下步骤创建自定义钥匙串：
```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 registry login` _之前_ 创建并解锁你的默认钥匙串。

## 跨环境的增量解析 {#incremental-resolution-across-environments}

使用我们的注册表时，干净/冷启动的解析速度会稍快一些；如果你在 CI 构建之间持久化已解析的依赖项，还能获得更大的性能提升。得益于注册表，你需要存储和恢复的目录大小远小于不使用注册表的情况，从而显著节省时间。在使用默认 Xcode 包集成时缓存依赖项的最佳方法是通过 `xcodebuild` 解析依赖项时指定自定义的 `clonedSourcePackagesDirPath`。你可以在 `Tuist.swift` 文件中添加以下内容来实现：

```swift
import ProjectDescription

let tuist = Tuist(
    project: .tuist(
        generationOptions: .options(
            additionalPackageResolutionArguments: ["-clonedSourcePackagesDirPath", ".build"]
        )
    )
)
```

此外，你还需要找到 `Package.resolved` 的路径。可以通过运行 `ls **/Package.resolved` 来获取路径。路径通常类似于 `App.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved`。

对于 Swift 包和基于 XcodeProj 的集成，我们可以使用默认的 `.build` 目录，该目录位于项目根目录或 `Tuist` 目录中。在设置流水线时，请确保路径正确。

以下是使用默认 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 }}
```
