# Hashing {#hashing}

Características como
<LocalizedLink href="/guides/features/cache">caching</LocalizedLink> o la
ejecución selectiva de pruebas requieren una forma de determinar si un objetivo
ha cambiado. Tuist calcula un hash para cada objetivo en el grafo de dependencia
para determinar si un objetivo ha cambiado. El hash se calcula basándose en los
siguientes atributos:

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

### Atributos de caché {#cache-attributes}

Además, al calcular el hash para
<LocalizedLink href="/guides/features/cache">caching</LocalizedLink>, también
hacemos hash de los siguientes atributos.

#### Versión de Swift {#swift-version}

Hacemos hash de la versión de Swift obtenida al ejecutar el comando
`/usr/bin/xcrun swift --version` para evitar errores de compilación debidos a
desajustes de versión de Swift entre los objetivos y los binarios.

> [!NOTE]
> **Estabilidad Del Módulo**
>
> Las versiones anteriores del almacenamiento en caché de binarios se basaban en
> el ajuste de compilación` ` BUILD_LIBRARY_FOR_DISTRIBUTION para habilitar
> [module
> stability](https://www.swift.org/blog/library-evolution#enabling-library-evolution-support)
> y permitir el uso de binarios con cualquier versión del compilador. Sin embargo,
> causaba problemas de compilación en proyectos con objetivos que no soportan la
> estabilidad de módulos. Los binarios generados están vinculados a la versión de
> Swift utilizada para compilarlos, y la versión de Swift debe coincidir con la
> utilizada para compilar el proyecto.


#### Configuración {#configuration}

La idea detrás de la bandera `-configuration` era asegurar que los binarios de
depuración no se utilizaran en las compilaciones de lanzamiento y viceversa. Sin
embargo, todavía nos falta un mecanismo para eliminar las otras configuraciones
de los proyectos para evitar que se utilicen.

## Depuración {#debugging}

Si observas comportamientos no deterministas al utilizar la caché en distintos
entornos o invocaciones, puede estar relacionado con diferencias entre los
entornos o con un error en la lógica de hash. Te recomendamos que sigas estos
pasos para depurar el problema:

1. Ejecute `tuist hash cache` o `tuist hash selective-testing` (hashes para
   <LocalizedLink href="/guides/features/cache">binary caching</LocalizedLink> o
   <LocalizedLink href="/guides/features/selective-testing">selective testing</LocalizedLink>), copie los hashes, cambie el nombre del directorio
   del proyecto y vuelva a ejecutar el comando. Los hashes deben coincidir.
2. Si los hashes no coinciden, es probable que el proyecto generado dependa del
   entorno. Ejecute `tuist graph --format json` en ambos casos y compare los
   gráficos. Alternativamente, genere los proyectos y compare sus archivos
   `project.pbxproj` con una herramienta de diferencias como
   [Diffchecker](https://www.diffchecker.com).
3. Si los hashes son los mismos pero difieren entre entornos (por ejemplo, CI y
   local), asegúrese de que se utiliza la misma [configuración](#configuration)
   y [versión Swift](#swift-version) en todas partes. La versión de Swift está
   vinculada a la versión de Xcode, así que confirme que las versiones de Xcode
   coinciden.

Si los hashes siguen siendo no deterministas, háznoslo saber y podremos ayudarte
con la depuración.


> [!NOTE]
> **Planificada Una Mejor Experiencia De Debugging**
>
> Mejorar la experiencia de depuración está en nuestra hoja de ruta. El comando
> print-hashes, que carece de contexto para entender las diferencias, será
> sustituido por un comando más fácil de usar que utilice una estructura en forma
> de árbol para mostrar las diferencias entre los hashes.