Caché de Xcode

Tuist es compatible con la caché de compilación de Xcode, lo que permite a los equipos compartir artefactos de compilación aprovechando las capacidades de almacenamiento en caché del sistema de compilación.

Configurar#

Requisitos

A Cuenta tuista y proyecto
Xcode 26.0 o posterior

Si aún no tienes una cuenta y un proyecto Tuist, puedes crearlos ejecutando:

bash

tuist init

Una vez que tenga un archivo Tuist.swift que haga referencia a su fullHandle, puede configurar el almacenamiento en caché para su proyecto ejecutando:

bash

tuist setup cache

Este comando crea un LaunchAgent para ejecutar un servicio de caché local al inicio que el sistema de compilación Swift utiliza para compartir artefactos de compilación. Este comando necesita ser ejecutado una vez en ambos entornos, local y CI.

Para configurar la caché en el CI, asegúrese de estar autenticado.

Configurar los ajustes de compilación de Xcode#

Añade los siguientes ajustes de compilación a tu proyecto Xcode:

bash

COMPILATION_CACHE_ENABLE_CACHING = YES
COMPILATION_CACHE_REMOTE_SERVICE_PATH = $HOME/.local/state/tuist/your_org_your_project.sock
COMPILATION_CACHE_ENABLE_PLUGIN = YES
COMPILATION_CACHE_ENABLE_DIAGNOSTIC_REMARKS = YES

Tenga en cuenta que COMPILATION_CACHE_REMOTE_SERVICE_PATH y COMPILATION_CACHE_ENABLE_PLUGIN deben añadirse como ajustes de compilación definidos por el usuario, ya que no están expuestos directamente en la interfaz de usuario de ajustes de compilación de Xcode:

Socket Path

La ruta del socket se mostrará cuando ejecute tuist setup cache. Se basa en el nombre completo de tu proyecto con barras reemplazadas por guiones bajos.

También puede especificar esta configuración al ejecutar xcodebuild añadiendo las siguientes banderas, como:

bash

xcodebuild build -project YourProject.xcodeproj -scheme YourScheme \
    COMPILATION_CACHE_ENABLE_CACHING=YES \
    COMPILATION_CACHE_REMOTE_SERVICE_PATH=$HOME/.local/state/tuist/your_org_your_project.sock \
    COMPILATION_CACHE_ENABLE_PLUGIN=YES \
    COMPILATION_CACHE_ENABLE_DIAGNOSTIC_REMARKS=YES

Generated Projects

No es necesario configurar los ajustes manualmente si tu proyecto está generado por Tuist.

En ese caso, todo lo que necesitas es añadir enableCaching: true a tu archivo Tuist.swift:

swift

import ProjectDescription

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

Integración continua (CI)#

Para habilitar el almacenamiento en caché en su entorno CI, debe ejecutar el mismo comando que en los entornos locales: tuist setup cache.

Además, debe asegurarse de que la variable de entorno TUIST_TOKEN está configurada. Puede crear una siguiendo la documentación aquí. La variable de entorno TUIST_TOKEN _ debe_ estar presente para su paso de compilación, pero recomendamos establecerla para todo el flujo de trabajo de CI.

Un ejemplo de flujo de trabajo para GitHub Actions podría ser el siguiente:

yaml

name: Build

env:
  TUIST_TOKEN: ${{ secrets.TUIST_TOKEN }}

jobs:
  build:
    steps:
      - # Your set up steps...
      - name: Set up Tuist Cache
        run: tuist setup cache
      - # Your build steps