해싱

캐싱이나 선택적 테스팅 실행과 같은 기능은 대상이 변경되었는지 확인하는 방법이 필요합니다. Tuist는 종속성 그래프의 각 대상에 대해 해시를 계산하여 대상이 변경되었는지 판단합니다. 해시는 다음 속성을 기반으로 계산됩니다:

• 대상 속성(예: 이름, 플랫폼, 제품 등)
• 대상 파일
• 대상 종속성의 해시

캐시 속성#

또한 캐싱을 위한 해시를 계산할 때 다음 속성도 함께 해시화합니다.

Swift 버전#

대상과 바이너리 간 Swift 버전 불일치로 인한 컴파일 오류를 방지하기 위해 /usr/bin/xcrun swift --version 명령어를 실행하여 얻은 Swift 버전을 해시화합니다.

구성#

캐시 해시를 계산할 때 Tuist는 각 프로젝트와 대상의 설정을 해결된 빌드 구성으로 범위를 지정합니다. 이는 --configuration로 명명된 구성이며, 그렇지 않으면 프로젝트의 defaultConfiguration, 아니면 첫 번째 디버그 구성입니다. Tuist는 해당 구성의 이름, 변형, 빌드 설정 및 구성 파일 내용을 적용되는 공유 기본 설정과 함께 해시화합니다. 다른 구성을 추가, 제거 또는 변경해도 해결된 구성의 캐시 해시에는 영향을 미치지 않습니다. 해결된 구성만 중요하므로 명시적 --configuration으로 채워진 캐시는 플래그 없이 동일한 구성으로 해결되는 명령어로 읽을 수 있습니다.

디버깅#

환경이나 호출 간에 캐싱을 사용할 때 비결정적 동작이 관찰되면 환경 간 차이이거나 해싱 로직의 버그일 수 있습니다. 문제를 디버깅하기 위해 다음 단계를 따르는 것을 권장합니다:

1. tuist hash cache 또는 tuist hash selective-testing(바이너리 캐싱 또는 선택적 테스팅용 해시)를 실행하고, 해시를 복사한 후 프로젝트 디렉터리 이름을 변경하고 명령어를 다시 실행합니다. 해시가 일치해야 합니다.
2. 해시가 일치하지 않으면 생성된 프로젝트가 환경에 의존할 가능성이 높습니다. 두 경우 모두 tuist graph --format json를 실행하고 그래프를 비교하세요. 또는 프로젝트를 생성하고 Diffchecker와 같은 diff 도구로 project.pbxproj 파일을 비교하세요.
3. 해시는 같지만 환경(예: CI와 로컬) 간에 차이가 있다면 모든 곳에서 동일한 구성과 Swift 버전을 사용하고 있는지 확인하세요. Swift 버전은 Xcode 버전과 연결되어 있으므로 Xcode 버전이 일치하는지 확인하세요.

해시가 여전히 비결정적이면 알려주시면 디버깅을 도와드리겠습니다.