ハッシュ計算

キャッシュや選択的テスト実行などの機能では、ターゲットが変更されたかどうかを判断する方法が必要です。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バージョンが一致していることを確認してください。

ハッシュが依然として非決定論的な場合は、お知らせください。デバッグをサポートいたします。