Hashing

Funcionalidades como caché o la ejecución de tests selectivos requieren una forma de determinar si un target ha cambiado. Tuist calcula un hash para cada target en el grafo de dependencias para saber si ha cambiado. El hash se calcula a partir de los siguientes atributos:

• Los atributos del target (por ejemplo, nombre, plataforma, producto, etc.)
• Los archivos del target
• El hash de las dependencias del target

Atributos de caché#

Además, al calcular el hash para caché, también incluimos los siguientes atributos.

Versión de Swift#

Calculamos el hash de la versión de Swift obtenida al ejecutar el comando /usr/bin/xcrun swift --version para evitar errores de compilación por incompatibilidades de versión de Swift entre los targets y los binarios.

Configuración#

Al calcular los hashes de caché, Tuist limita la configuración de cada proyecto y target a la configuración de compilación resuelta. Es la que se indica con --configuration, de lo contrario la defaultConfiguration del proyecto, o bien la primera configuración de debug. Tuist incluye en el hash el nombre de esa configuración, su variante, sus opciones de compilación y el contenido de su archivo de configuración, junto con las opciones base compartidas que le corresponden. Añadir, eliminar o modificar otra configuración no afecta a los hashes de caché de la configuración resuelta. Dado que solo importa la configuración resuelta, una caché poblada con un --configuration explícito es legible por un comando que resuelva a la misma configuración sin pasar la bandera.

Depuración#

Si observas comportamientos no deterministas al usar la caché entre entornos o invocaciones, puede deberse a diferencias entre los entornos o a un error en la lógica de hashing. Te recomendamos seguir estos pasos para depurar el problema:

1. Ejecuta tuist hash cache o tuist hash selective-testing (hashes para caché de binarios o tests selectivos), copia los hashes, cambia el nombre del directorio del proyecto y vuelve a ejecutar el comando. Los hashes deberían coincidir.
2. Si los hashes no coinciden, es probable que el proyecto generado dependa del entorno. Ejecuta tuist graph --format json en ambos casos y compara los grafos. Como alternativa, genera los proyectos y compara sus archivos project.pbxproj con una herramienta de diff como Diffchecker.
3. Si los hashes son iguales pero difieren entre entornos (por ejemplo, CI y local), asegúrate de que se usa la misma configuración y la misma versión de Swift en todos lados. La versión de Swift está ligada a la versión de Xcode, así que confirma que las versiones de Xcode coincidan.

Si los hashes siguen siendo no deterministas, avísanos y te ayudaremos con la depuración.