Depuración

Ser abierto es una ventaja práctica: el código está disponible, puedes ejecutarlo localmente y puedes usar agentes de programación para responder preguntas más rápido y depurar posibles errores en la base de código.

Si encuentras documentación faltante o incompleta mientras depuras, actualiza la documentación en inglés en docs/ y abre un PR.

Capturar volcados de hilos en CI#

Cuando la CLI se cuelga intermitentemente, puedes capturar un volcado de hilos sin detener el proceso. Habilita el manejador de señales y envía SIGUSR1 al proceso tuist en ejecución.

bash

export TUIST_THREAD_DUMP_SIGNAL=1
export TUIST_THREAD_DUMP_SAMPLE=1 # macOS only, captures all threads via /usr/bin/sample
tuist generate &
TUIST_PID=$!
sleep 600
kill -USR1 "$TUIST_PID"
wait "$TUIST_PID"

Si TUIST_THREAD_DUMP_SAMPLE no está configurado, el manejador imprime la pila del hilo actual. La salida se escribe en stderr, por lo que aparece en los registros de CI.

Usar agentes de programación#

Los agentes de programación son útiles para:

Escanear la base de código para encontrar dónde se implementa un comportamiento.
Reproducir problemas localmente e iterar rápidamente.
Rastrear cómo fluyen las entradas a través de Tuist para encontrar la causa raíz.

Comparte la reproducción más pequeña que puedas y dirige al agente al componente específico (CLI, servidor, caché, documentación o manual). Cuanto más enfocado sea el alcance, más rápido y preciso será el proceso de depuración.

Indicaciones frecuentemente necesarias (FNP)#

Generación de proyecto inesperada#

La generación del proyecto me está dando algo que no espero. Ejecuta la CLI de Tuist contra mi proyecto en /path/to/project para entender por qué está ocurriendo esto. Rastrea la tubería del generador e indica las rutas de código responsables del resultado.

Error reproducible en proyectos generados#

Esto parece un error en los proyectos generados. Crea un proyecto reproducible en examples/, usando ejemplos existentes como referencia. Añade una prueba de aceptación que falle, ejecútala mediante xcodebuild seleccionando solo esa prueba, corrige el problema, vuelve a ejecutar la prueba para confirmar que pasa y abre un PR.