Proyecto de Xcode

Sigue esta ruta si quieres mantener tu .xcodeproj o .xcworkspace exactamente como está e integrar las capacidades de Tuist sin adoptar la generación de proyectos. Cada sección a continuación comienza explicando qué falta hoy y luego te guía por la funcionalidad que cubre esa carencia.

Requisitos previos#

• macOS con Xcode 26 o posterior (la caché de compilación y los análisis modernos dependen de ello).
• La interfaz de línea de comandos de Tuist.

Conectar el proyecto#

Ejecuta tuist init en la raíz del repositorio. Elige Integrar <YourApp> cuando Tuist detecte tu espacio de trabajo, luego autentícate en el navegador y selecciona la cuenta que debe ser propietaria del proyecto. Tuist escribe un Tuist.swift en la raíz que fija el identificador del proyecto para que tus compañeros y la CI compartan la misma conexión. Confírmalo.

Si lo ejecutas desde un agente de programación o un script, ejecuta primero tuist auth login (el flujo del navegador espera a que pulses Intro) y luego usa el modo no interactivo:

Todo lo siguiente es opcional e independiente.

Caché de compilación de Xcode#

Xcode 26 incluye una caché de compilación por archivo, pero su almacén reside dentro del DerivedData de cada máquina. Una compilación limpia la rellena localmente; tus compañeros y los runners de CI vuelven a compilar desde cero porque no ven ese almacén.

tuist setup cache apunta la caché de compilación de Xcode a la red de caché compartida de Tuist. Un acierto en cualquier máquina de desarrollo o ejecución de CI beneficia entonces a todas las demás máquinas que compilan la misma revisión.

El comando imprime la configuración de compilación que Xcode necesita para usar la caché compartida. No edita tu proyecto, así que añádela a la configuración de compilación de tu proyecto o a un archivo .xcconfig, como se describe en Configurar la configuración de compilación de Xcode.

Compila en Xcode y luego compila la misma revisión en una segunda máquina o en un runner de CI. La segunda compilación termina en una fracción del tiempo y el informe de compilación de Xcode muestra los aciertos de la caché de compilación.

Análisis de compilaciones#

Xcode registra las duraciones de compilación por destino en el registro y en el informe de compilación. Ninguno de ellos agrega datos entre ejecuciones o entre máquinas. Una regresión en el tiempo de compilación que llega en una PR suele manifestarse solo como una CI más lenta en general, sin una señal clara sobre qué destino la causó ni cuándo.

Análisis de compilaciones registra la duración y los tiempos de cada fase de cada compilación para que la tendencia sea visible en el panel. Es una única línea como acción posterior en tu esquema:

1. En Xcode: Producto → Esquema → Editar esquema…

2. Despliega Compilar → Acciones posteriores, haz clic en + y elige Nueva acción de script de ejecución.

3. En Proporcionar configuración de compilación desde, selecciona el destino de tu app.

4. Pega la línea que corresponda a cómo instalaste Tuist: ::: code-group

   bash

   $HOME/.local/bin/mise x -C $SRCROOT -- tuist inspect build
   bash

   tuist inspect build

   :::

   Los scripts de esquema de Xcode no heredan el PATH de tu shell, por lo que el shim de mise no se encuentra por sí solo. La línea de Mise anterior llama a mise por su ruta absoluta y le pide que cargue la configuración desde $SRCROOT para que use la versión fijada en tu proyecto.

5. Compila una vez. La compilación aparece en la pestaña Compilaciones del panel en cuestión de segundos.

Análisis de tests#

El registro de tests de Xcode enumera los resultados por test una ejecución a la vez. No agrega la señal entre ejecuciones que realmente necesitas: con qué frecuencia falla un test, cuánto se ralentizó la semana pasada o si falla solo en ciertos simuladores. Un test que pasa de fiable a intermitente a lo largo de diez ejecuciones de CI parece igual que una única ejecución desafortunada.

Análisis de tests registra el resultado y la duración de cada test y correlaciona los resultados entre ejecuciones. Los tests lentos, los fallos y los tests intermitentes aparecen en la pestaña Tests del panel.

1. Producto → Esquema → Editar esquema…
2. Test → Acciones posteriores → + → Nueva acción de script de ejecución.
3. Proporcionar configuración de compilación desde el destino de tu app.
4. Pega: ::: code-group
   bash

   $HOME/.local/bin/mise x -C $SRCROOT -- tuist inspect test
   bash

   tuist inspect test
   :::
5. Ejecuta la acción de test una vez. Los resultados aparecen en la pestaña Tests del panel.

Análisis de paquetes#

El tamaño de instalación y descarga de un IPA cambia con cada recurso añadido y cada símbolo enlazado. Xcode informa de los tamaños bajo demanda en Producto → Mostrar archivo, no como una serie. Una PR que añade un recurso grande es indistinguible de cualquier otra PR en la cola de fusión.

Análisis de paquetes registra los tamaños de instalación y descarga de cada compilación analizada y puede hacer fallar una comprobación de PR cuando se supera un umbral por rama. Añade esto a tu CI justo después del paso de compilación:

Abre Análisis de paquetes en el panel para ver la tendencia y configurar umbrales.

Previews#

TestFlight añade un ciclo de compilación y revisión en cada compartir. Enviar un .ipa firmado directamente requiere el UDID del destinatario en el perfil de aprovisionamiento. Ninguna opción es cómoda para un diseñador o QA que solo quiere probar la rama actual.

Previews convierte una compilación en un enlace compartible que se ejecuta en un simulador o dispositivo con un solo comando:

Envía el enlace. Los destinatarios lo ejecutan con tuist run <url> o con la app de Tuist para macOS.

Involucra a todo el equipo#

La caché y los análisis mejoran cuantas más personas estén conectadas al proyecto. Invita a tus compañeros a la organización desde la configuración de cuenta en el panel y configura Single Sign-On (Google, Okta, Microsoft) para que la incorporación sea un clic en lugar de un tuist auth login por persona.

Próximos pasos#

Si te quedas corto con este enfoque, el siguiente gran paso son los proyectos generados por Tuist. Es un cambio real (los destinos se describen en manifiestos de Swift en lugar de en un .xcodeproj), pero es lo que desbloquea la caché de módulos y los tests selectivos. Todo está cubierto en la guía Generated Xcode project.