# Xcodeキャッシュ {#xcode-cache} TuistはXcodeコンパイルキャッシュをサポートしており、ビルドシステムのキャッシング機能を活用してチーム間でコンパイル成果物を共有できます。 XcodeキャッシュはXcode 26で導入されました。Xcodeビルドキャッシュと呼ばれることもあります。これは入力に基づいてキー付けされたコンパイル成果物を再利用し、Tuistのリモートキャッシュにより、それらの成果物をマシン間で共有できるようになります。 > [!TIP] > **モジュールキャッシュと組み合わせる** > > Xcodeキャッシュと<.localized_link href="/guides/features/cache/module-cache">モジュールキャッシュは異なる粒度で動作し、相互に補完します。モジュールキャッシュはビルド実行前にモジュール全体を事前ビルドされた`.xcframework`に置き換えますが、Xcodeキャッシュはビルド中にコンパイル出力を再利用します。 > [!TIP] > **開発者マシンでは、クリーン時に`CompilationCache.noindex`を保持する** > > デフォルトでは、コンパイルキャッシュストアは`DerivedData`内に存在するため、`DerivedData`を削除するとビルド成果物とともにキャッシュも削除されます。開発者マシンでは、ビルド成果物のみを削除することをお勧めします。これにより、再ビルド時にディスク上のストアから再生され、何もフェッチする必要がありません。 ## セットアップ {#setup} Tuistアカウントとプロジェクトをまだお持ちでない場合は、以下を実行して作成できます。 ```bash tuist init ``` `Tuist.swift`ファイルがあり、それがあなたの`fullHandle`を参照している場合、以下を実行してプロジェクトのキャッシングを設定できます。 ```bash tuist setup cache ``` このコマンドは、Swiftの[ビルドシステム](https://github.com/swiftlang/swift-build)がコンパイル成果物を共有するために使用するローカルキャッシュサービスを起動時に実行するための[LaunchAgent](https://developer.apple.com/library/archive/documentation/MacOSX/Conceptual/BPSystemStartup/Chapters/CreatingLaunchdJobs.html)を作成します。最初は開発者マシンで実行し、各CIジョブのセットアップの一部として実行してください。 CIでキャッシュを設定するには、<.localized_link href="/guides/integrations/continuous-integration#authentication">認証済みであることを確認してください。 ### キャッシュコンポーネントの更新 {#updating-the-cache-components} キャッシュプロキシは、最後にセットアップを実行したTuistインストールに固定されたパスではなく、安定したランチャーを使用します。一度インストールされると、`tuist setup cache`およびキャッシュ有効化された`tuist generate`は、利用可能なターゲットを新しいTuistリリースに進めます。したがって、古いTuistに固定されているプロジェクトでも、共有プロキシのダウングレードは発生しません。生成は既存のランチャーターゲットを更新するだけであり、サービスのインストール、認証、プラグインの置換、またはプロキシの再起動は行いません。カスタムプラグイン、プロキシ、ソケット、またはレジストリのオーバーライドがある場合、自動的な進捗はスキップされます。 実行中のプロキシは、キャッシュリクエストが少なくとも30秒間なく、進行中のリクエストやバックグラウンド作業がなく、公開スプールが排出された後にのみ、新しいターゲットを採用します。その後終了し、launchdが選択されたCLIを起動し、サービスの引数と認証情報環境を保持します。実際にターゲットを採用したプロキシのみが、バンドルからディスク上のプラグインをアトミックに更新します。古いプロキシがまだ排出中である間は、セットアップは新しいプラグインをインストールしません。インストールされたプラグインが見つからない場合、明示的なアイドル状態のセットアップが選択されたプロキシを再起動して更新を再試行します。レジストリとスプールを所有するプロキシは依然として1つだけです。利用できないターゲットまたは未排出のアップロードがある場合、アクティブなリクエストを中断するのではなく、切り替えを延期します。認証情報の更新は切り替えの前でも選択されたCLIに従うため、古いCLIインストールを削除しても、排出待ちのアップロードが行き場を失うことはありません。 安定したランチャー以前に作成された既存のインストールには、明示的な移行が1回必要です。ビルドが実行されていないときに以下を実行してください。 ```bash tuist setup cache ``` その移行後、Tuistを更新して通常の`tuist generate`を実行するだけで、プロキシとインストールされたプラグインを進めることができます。各CLIリリースごとにセットアップを再実行する必要はありません。異なるXcodeを選択するには、明示的なセットアップが必要です。これには、同じパスで更新されたXcodeも含まれます。設定が変更された場合、セットアップは共有サービスを置き換えることができるため、まずマシン上のすべてのビルドが完了するのを待ってください。プロキシは以前のプラグインプロトコルと現在のプロトコルの両方をサポートしているため、Xcodeにすでに読み込まれている互換性のあるプラグインは、プロキシのアップグレード後も動作し続けます。最新のプラグインを読み込むためにXcodeを完全に終了して再度開きますが、互換性のある読み込み済みプラグインの場合は即時の再起動は不要です。リリースによって生成されるビルド設定が変更された場合は、プロジェクトを再生成してください。 選択されたTuistインストールを利用可能な状態に保ってください。ランチャーはそれを起動、構成、および認証情報の更新に使用します。ランチャーが進んだら、古いインストールを削除できます。選択された実行可能ファイルが削除されたか、実行可能ではなくなった場合、`tuist setup cache`はキャッシュを最初に破棄することなく、利用可能なインストール（古いリリースでも可）を使用してターゲットを修復できます。安定した実行可能ファイルのエイリアスはパッケージマネージャーのアップグレードを通じて保持され、シンボリックリンクはインストールIDを比較するときのみ解決されます。起動時、プロキシは実際に起動されたバージョン（インプレースアップデートや意図的なロールバックを含む）を記録し、関連のない古いチェックアウトが利用可能なインストールに切り替えるのを防ぐために、使用された最高バージョンを保持します。 リリースバージョンのないソースビルドされたCLI、および明示的な`TUIST_CAS_PLUGIN_PATH`または`TUIST_CAS_PROXY_PATH`セットアップは、自動バージョン選択ではなく明示的な起動構成を使用します。それらのコンポーネントを再ビルドした後、セットアップを再実行してください。セットアップはそれらの新鮮さを確認し、置換準備ができてから管理対象ターゲットの進捗を無効にします。 `tuist teardown cache`はランチャーターゲットを削除する前にサービスを停止し、既存のプロジェクトのために安定したプラグインを保持します。サービスの停止に失敗した場合、そのランチャーは再起動および別のティアダウン試行のために利用可能なままになります。成功したティアダウン後、生成はサービスを再作成できません。 ### Xcodeビルド設定の構成 {#configure-xcode-build-settings} 既存のXcodeプロジェクトの場合、`tuist setup cache`によって出力されるビルド設定をプロジェクトのビルド設定または既存の`.xcconfig`ファイルにコピーしてください。このコマンドはあなたのアカウントの構成を出力しますが、構成ファイルを生成したりXcodeプロジェクトを編集したりはしません。`OTHER_SWIFT_FLAGS`を拡張する際は`$(inherited)`を保持し、他のコンパイラオプションが保存されるようにしてください。 設定には以下が含まれます。 ``` COMPILATION_CACHE_ENABLE_CACHING = YES COMPILATION_CACHE_ENABLE_PLUGIN = YES COMPILATION_CACHE_PLUGIN_PATH = $HOME/.local/state/tuist/libtuist_cas_plugin.dylib COMPILATION_CACHE_REMOTE_SERVICE_PATH = $HOME/.local/state/tuist/cas-proxy.sock COMPILATION_CACHE_ENABLE_DETACHED_KEY_QUERIES = YES COMPILATION_CACHE_ENABLE_DIAGNOSTIC_REMARKS = YES OTHER_SWIFT_FLAGS = $(inherited) -cas-plugin-option tuist-instance=your-org/your-project ``` `COMPILATION_CACHE_ENABLE_PLUGIN`、`COMPILATION_CACHE_PLUGIN_PATH`、`COMPILATION_CACHE_REMOTE_SERVICE_PATH`、および`COMPILATION_CACHE_ENABLE_DETACHED_KEY_QUERIES`はXcodeのビルド設定UIで直接公開されていないため、**ユーザー定義ビルド設定**として追加する必要があることに注意してください。 > [!NOTE] > **プラグインパス** > > `libtuist_cas_plugin.dylib`はTuistに同梱されるコンパイルキャッシュプラグインで、`tuist`実行ファイルの隣にあります。`tuist setup cache`はこのファイルを`$HOME/.local/state/tuist/libtuist_cas_plugin.dylib`にコピーし、`COMPILATION_CACHE_PLUGIN_PATH`はそのコピーを指します。このパスはすべてのマシンで同じであり、Tuistを更新しても変更されないため、プロジェクトと一緒に設定をコミットできます。セットアップと新たに起動されたプロキシは、選択されたTuistバンドルからコピーを更新します。古いチェックアウトからセットアップを実行しても、新しいプラグインがダウングレードされることはありません。 > [!NOTE] > **プロジェクトごとに1つのソケット** > > `tuist setup cache`はマシンごとに単一のキャッシュプロキシをインストールするため、すべてのプロジェクトで同じ`COMPILATION_CACHE_REMOTE_SERVICE_PATH`を使用します。プロジェクトを識別するのは`tuist-instance`プラグインオプションです。 > [!IMPORTANT] > **`COMPILATION_CACHE_REMOTE_SERVICE_PATH`がCおよびObjective-Cを共有する仕組み** > > この設定を「キャッシュサービスの場所」と読み取り、任意であると扱ってしまいがちです。しかし、C、Objective-C、事前コンパイル済みモジュール、事前コンパイル済みヘッダーを共有するかどうかを決めるスイッチでもあります。ビルドシステムは、リモートキャッシュサービスが構成されている場合にのみ、それらのキャッシングを実行します。これを省略してもSwiftのコンパイルは共有されますが、以前にそのプロジェクトをビルドしていないマシンでは、すべてのC/Objective-Cファイルとすべてのモジュールが再コンパイルされます。 > [!NOTE] > **並行キャッシュルックアップ** > > `COMPILATION_CACHE_ENABLE_DETACHED_KEY_QUERIES`は、ビルドの実行レーンで一度に数回行うのではなく、残りのビルド alongside に、ビルドシステムが各コンパイルに対して行うリモートキャッシュルックアップを実行します。遠隔のキャッシュから多くのコンパイルをミスしたり復元したりするビルドは、より早く完了します。 `xcodebuild`を実行する際に、以下のようなフラグを追加してこれらの設定を指定することもできます。 ``` xcodebuild build -project YourProject.xcodeproj -scheme YourScheme \ COMPILATION_CACHE_ENABLE_CACHING=YES \ COMPILATION_CACHE_ENABLE_PLUGIN=YES \ COMPILATION_CACHE_PLUGIN_PATH=$HOME/.local/state/tuist/libtuist_cas_plugin.dylib \ COMPILATION_CACHE_REMOTE_SERVICE_PATH=$HOME/.local/state/tuist/cas-proxy.sock \ COMPILATION_CACHE_ENABLE_DETACHED_KEY_QUERIES=YES \ COMPILATION_CACHE_ENABLE_DIAGNOSTIC_REMARKS=YES \ 'OTHER_SWIFT_FLAGS=$(inherited) -cas-plugin-option tuist-instance=your-org/your-project' ``` > [!NOTE] > **Xcode 27以降でのプレフィックスマッピング** > > Xcode 27以降では、`tuist setup cache`は`SWIFT_ENABLE_PREFIX_MAPPING`、`SWIFT_ENABLE_PROJECT_PREFIX_MAPPING`、`CLANG_ENABLE_PREFIX_MAPPING`、および`CLANG_ENABLE_PROJECT_PREFIX_MAPPING`も出力します。これらは、プロジェクトと`DerivedData`の場所に関係なくコンパレーションキャッシュキーを独立させます。ユーザー定義ビルド設定として追加してください。有効にするとすべてのキャッシュキーが変更されるため、次のビルドでキャッシュが再び構築されます。`enableCaching`がオンの場合、`tuist generate`がこれらを自動的に設定します。 > > コンパイラはマップされたパスをコードカバレッジデータにも書き込みますが、Xcodeはそれらを解決できないため、カバレッジレポートにはプレフィックスマッピング付きでコンパイルされたすべてのソースが含まれなくなります。出力される設定と`TUIST_PREFIX_MAPPING_FOR_COVERAGE_*`の設定により、コードカバレッジを収集するビルドではプレフィックスマッピングが無効になります。`tuist generate`も同様に行います。これらのビルドでもコンパレーションキャッシュは使用されますが、キャッシュキーはプロジェクトと`DerivedData`のパスに依存します。 > > コマンドラインでこれらの設定を`xcodebuild`に渡す場合は、上記の`OTHER_SWIFT_FLAGS`と同様に、`$(...)`を含む値を一重引用符で囲んでください。そうしないと、シェルがそれらを空文字列に展開し、プレフィックスマッピングが無効になります。 > > ``` > xcodebuild build -project YourProject.xcodeproj -scheme YourScheme \ > 'SWIFT_ENABLE_PREFIX_MAPPING=$(TUIST_PREFIX_MAPPING_FOR_COVERAGE_$(CLANG_COVERAGE_MAPPING))' \ > SWIFT_ENABLE_PROJECT_PREFIX_MAPPING=YES \ > 'CLANG_ENABLE_PREFIX_MAPPING=$(TUIST_PREFIX_MAPPING_FOR_COVERAGE_$(CLANG_COVERAGE_MAPPING))' \ > CLANG_ENABLE_PROJECT_PREFIX_MAPPING=YES \ > TUIST_PREFIX_MAPPING_FOR_COVERAGE_=YES \ > TUIST_PREFIX_MAPPING_FOR_COVERAGE_NO=YES \ > TUIST_PREFIX_MAPPING_FOR_COVERAGE_YES=NO > ``` > [!NOTE] > **生成されたプロジェクト** > > プロジェクトがTuistによって生成されている場合、設定を手動で行う必要はありません。 > > その場合、`Tuist.swift`ファイルに`enableCaching: true`を追加するだけで済みます。 > ```swift > import ProjectDescription > > let tuist = Tuist( > fullHandle: "your-org/your-project", > project: .tuist( > generationOptions: .options( > enableCaching: true > ) > ) > ) > ``` ### プレフィックスマッピングを使用したカバレッジ {#coverage-with-prefix-mapping} デフォルトでは、生成されたプロジェクトはXcodeのカバレッジレポートと`xccov`が機能するように、カバレッジビルド用のプレフィックスマッピングを無効にしています。チェックアウト間でカバレッジコンパレーションを共有可能にするために、これを有効にすることができます。 ```swift let tuist = Tuist( project: .tuist( generationOptions: .options( enableCaching: true, coverage: .coverage(prefixMapping: true) ) ) ) ``` `TUIST_COVERAGE_PREFIX_MAPPING`環境変数（`1`または`0`）は`prefixMapping`よりも優先されます。このオプションはXcode 27以降に適用され、`enableCaching`が必要です。カバレッジの`tuist test`アップロードはこれをサポートします。Tuistは`llvm-cov`を使用して実行を測定し、マップされたパスでソースを読み取り、それをリポジトリのファイルに関連付けます。Xcode自体のカバレッジレポートと`xccov`は依然としてそれらのソースを除外することがあり、`llvm-cov`のエクスポートに失敗したために結果バンドルの`xccov`レポートにフォールバックするアップロードでも同様です。マップされた`#filePath`値は、ソースファイル相対でフィクスチャを探すテストにも影響を与える可能性があります。代わりに明示的なランタイムチェックアウトパスを通じてフィクスチャを解決してください。カバレッジを自分で処理する場合、計測済みバイナリをそれぞれのターゲットの`$(TARGET_TEMP_DIR)/compilation-prefix-map.json`とペアにしてください。これは仮想プレフィックスをローカルディレクトリにマップします。プロジェクトごとのマッピングが有効な場合、あるターゲットのマップをすべてのバイナリで再利用しないでください。 カバレッジプレフィックス設定は、カバレッジアーティファクトに書き込まれるパスを制御するため、バイナリキャッシュと選択的テストのハッシュに参加します。このオプションを変更するか、`TUIST_COVERAGE_PREFIX_MAPPING`を異なる値に設定すると、通常のビルドであってもそれらのハッシュは無効になります。開発者とCIジョブ間でバイナリキャッシュと選択的テストの結果を共有する必要がある場合は、値を一貫させてください。 ### 生成されたプロジェクトのデバッグ {#debugging-generated-projects} 復元されたネイティブモジュールには、リンクされたデバッグ情報だけでなく、コンパレーションキャッシュへのアクセスも必要です。TuistはDebugおよびReleaseモジュールをdSYMとスライスごとのソースIDメタデータでウォームアップし、ターゲットを置き換える前にコンシューマーが宣言したソースに対してメタデータを検証します。メタデータが欠落しているか互換性がない場合、そのターゲットのソースは保持されます。スクリプトで生成された`.generated(...)`ソースには、検証可能なコンテンツチェックサムではなく宣言フィンガープリントがあるため、それらのターゲットはソースビルドのままとなり、ネイティブモジュールキャッシュには公開されません。実際のコンテンツチェックサムを持つ生成されたリソースアクセサは対象となります。サポートされていないデバッグ情報は、関連のない製品をブロックすることなく、影響を受けたターゲットの公開をスキップします。ソースの変更とキャンセルは依然としてウォームアップを失敗させます。キャッシュ形式が変更されるため、古いバージョンでウォームアップされたアーティファクトは再ウォームアップが必要です。 検証済みの置き換えの場合、Tuistはコンシューマー所有のdSYM UUID plist内でソースの再配置を準備し、静的キャッシュコード用のデバッグ専用コンパニオンをリンクします。キャッシュされたバイナリを書き換えたり、LLDBの永続的なグローバルソースマップにプロデューサーソースパスをインストールしたりすることはしません。明示的なデバッガ初期化子とモジュールローダー設定が優先されます。デバッグシンボルとソースの再配置は、ソース相対のランタイムファイルアクセスやネイティブなXcodeカバレッジレポートを修復しません。カバレッジバリアントの選択とLLVMエクスポートは別個の機能です。 `enableCaching: true`を使用すると、TuistはRunアクションとTestアクション用にLLDBソースマップを構成します。アクションにカスタムLLDB初期化子がある場合、Tuistはまず解決済みのソースマップを書き込み、その後カスタム初期化子をソースとして読み込み、マップの拡張や上書きを可能にします。それ以外の場合、ソースマップを置き換える前に、ファイルが存在すれば`~/.lldbinit-Xcode`を読み込み、存在しなければ`~/.lldbinit`にフォールバックします。ホームファイルは1つだけ読み込まれ、二重読み込みを防ぎながらユーザーごとのデバッガー設定を復元します。置き換えにより以前のランからの古いマッピングが削除され、ホームファイルのソースマップよりも優先されます。維持すべきソースマップエントリは、アクションのカスタム初期化子に記述してください。他のホーム設定は保持されます。Tuist固有のモジュール検索パス、ローダー設定、Clangフラグは後から適用され、これらの設定に対するユーザー値よりも優先されます。ホームファイルのエラーは表示されたままですが、後続のコマンドの読み込みを停止することはなく、コマンドはエコーされません。この初期化子の保持は、モジュールキャッシュから復元されたバイナリのデバッグをTuistが構成する場合にも適用され、`enableCaching`がない場合や以前のXcodeバージョンでも同様です。 Xcode 27以降では、生成されたプロジェクトはプロジェクトが明示的に設定しない限り、Xcodeのプロジェクトごとのプレフィックスマッピング（`SWIFT_ENABLE_PROJECT_PREFIX_MAPPING`および`CLANG_ENABLE_PROJECT_PREFIX_MAPPING`）を無効にします。`/^src`などのプレフィックスはプロジェクトごとに異なるディレクトリを指し、LLDBはデバッグ対象ターゲットのプロジェクトに対してのみそれらを解決します。代わりに、ソースはワークスペース全体のプレフィックスの下に記録されます。Tuistルートディレクトリには`/^root`、Swiftパッケージのスクラッチディレクトリには`/^spm`、ビルド出力には`/^intermediates`および`/^products`が使用されます。これらはすべてのプロジェクトで同じディレクトリを指すため、ワークスペース内の任意のプロジェクトのソースでブレークポイントが解決されます。 Tuistルート外のパスはマップされません。ルート外のプロジェクトのキャッシュキーはチェックアウト場所に依存するため、他のチェックアウトやマシンではそのキャッシュが見つかりません。キーをチェックアウト場所に依存させないようにするには、そのプロジェクトのマニフェストでプロジェクトごとのマッピングを有効にします。 ```swift let checkoutIndependentSettings = Settings.settings(base: [ "SWIFT_ENABLE_PROJECT_PREFIX_MAPPING": "YES", "CLANG_ENABLE_PROJECT_PREFIX_MAPPING": "YES", ]) ``` これらの設定をその`Project`に渡します。別のプロジェクトのターゲットをデバッグする場合、LLDBはそのプロジェクトのソースを見つけられなくなります。マニフェストのプロジェクトベース設定はプロジェクトレベルのxcconfig値よりも優先されるため、マニフェスト自体で設定してください。 これらの設定を変更すると、コンパレーションキャッシュキー、バイナリキャッシュハッシュ、選択的テストハッシュが変化するため、それらのキャッシュを再度ウォームアップする必要があります。チーム全体で一貫した選択を維持してください。 ### キャッシュアップロードポリシー {#cache-upload-policy} デフォルトでは、キャッシュサービスはリモートキャッシュへのアーティファクトのダウンロードとアップロードの両方を行います。`Tuist.swift`ファイルの`xcodeCache`オプションを使用して読み取り専用モードを有効にすることで、これを制御できます。読み取り専用モードでは、アーティファクトはダウンロードされますがアップロードは行われません。 ```swift import ProjectDescription let tuist = Tuist( fullHandle: "your-org/your-project", xcodeCache: .xcodeCache( upload: false ), project: .tuist( generationOptions: .options( enableCaching: true ) ) ) ``` 一般的なパターンは、ビルドが再現可能なCI環境からのみアーティファクトをプッシュし、ローカル環境を読み取り専用に保つことです。これは、ほとんどのCIプロバイダーによって設定される`CI`環境変数を確認する`Environment.isCI`を使用して実現できます。 ```swift import ProjectDescription let tuist = Tuist( fullHandle: "your-org/your-project", xcodeCache: .xcodeCache( upload: Environment.isCI ), project: .tuist( generationOptions: .options( enableCaching: true ) ) ) ``` この設定により、ローカルビルドはアップロードなしでキャッシュされたアーティファクトの恩恵を受け、CIビルドはチームの他のメンバーのためにキャッシュを.populateします。 アップロードポリシーは、`tuist setup cache`を実行するマシン上でプロジェクトごとに記録されます。変更するには、`upload`を更新して`tuist setup cache`を再実行し、Tuistがプロジェクトを生成している場合は`tuist generate`も再実行してください。その後、そのマシン上のキャッシュを再起動することなく、アップロードは新しいポリシーに従います。同じマシンで同時に実行される同じプロジェクトのジョブはポリシーを共有するため、最新の`tuist setup cache`がすべてに適用されます。 ### ストアサイズ制限 {#store-size-limit} コンパレーションキャッシュストアはビルドごとに増大します。プロジェクトのストアを制限するには、`Tuist.swift`ファイルで`storeSizeLimit`を設定してください。 ```swift import ProjectDescription let tuist = Tuist( fullHandle: "your-org/your-project", xcodeCache: .xcodeCache( storeSizeLimit: .gigabytes(20) ), project: .tuist( generationOptions: .options( enableCaching: true ) ) ) ``` ビルドが実行されていない間、Tuistは10分ごとにプロジェクトの各ストアをチェックします。新しいビルドが制限の約半分を書き込むと、ストアの最も古いキャッシュ出力が削除されるため、ストアは制限付近で安定します。ビルド実行中はストアが制限を超えることがあり、制限設定時にすでに大きかったストアは、新しいビルドがその量を書き込むと縮小します。複数のプロジェクトが同じストア（デフォルトの場所など）を使用する場合、最も小さい制限が適用されます。制限は`tuist setup cache`を実行するすべてのマシンに適用されるため、制限を変更した後は再度実行してください。 ### モジュールキャッシュハッシュ {#module-cache-hashes} コンパレーションキャッシュの設定は<.localized_link href="/guides/features/projects/hashing">モジュールキャッシュハッシュの一部ではありません。Tuistはすべての`COMPILATION_CACHE_*`ビルド設定と、その値を持つすべての`-cas-plugin-option`フラグをハッシュから除外します。`enableCaching`の有効化または無効化、あるいはアップロードポリシーの変更は、ターゲットのハッシュを維持するため、すでにウォームアップ済みの<.localized_link href="/guides/features/cache/module-cache">モジュールキャッシュバイナリは有効なままです。Xcodeキャッシュありとなしのビルドを、同じモジュールキャッシュに対して比較できます。 > [!NOTE] > **プレフィックスマッピング設定はハッシュ化されます** > > Xcode 27以降では、`enableCaching: true`は`SWIFT_ENABLE_PREFIX_MAPPING`、`SWIFT_ENABLE_PROJECT_PREFIX_MAPPING`、`CLANG_ENABLE_PREFIX_MAPPING`、`CLANG_ENABLE_PROJECT_PREFIX_MAPPING`、および`TUIST_PREFIX_MAPPING_FOR_COVERAGE_*`設定も設定します。これらの設定はモジュールキャッシュハッシュの一部であるため、Xcode 27以降では`enableCaching`の有効化または無効化によりターゲットのハッシュが変化します。 ### 大きな出力の一部の再利用 {#reusing-parts-of-large-outputs} Xcodeキャッシュは、コンテンツ定義チャンキングにより転送量を削減できます。各大きな出力を以前のバージョンとは無関係なものとして扱うのではなく、コンテンツによって決定される境界で圧縮出力を分割します。編集後、オフセットが変更されていても、一致するチャンクを再利用できます。 アップロードでは、サーバーに欠けているチャンクのみを送信します。ダウンロードでは、まず正確なキャッシュされたアクションと出力のチャンクレシピを取得し、次にローカルマシンに保存されている検証済みチャンクを再利用して不足部分をフェッチします。完全に再構築された出力は、コンパイラキャッシュに復元される前に検証されます。 転送チャンクキャッシュは`DerivedData`とは別個であるため、コンパレーションキャッシュのクリーンアップやローカルキャッシュサービスの再起動後もチャンクは保持されます。これは使い捨て可能で、チャンクペイロードは最大1ギビバイト、追加の一時ステージングファイルは最大2メビバイトに制限されます。追放されたチャンクや損傷したチャンクは、必要に応じて再度ダウンロードされます。コンパレーションキャッシュ自体を保持する方が、その内容を再構築するよりも高速です。 クライアントは、サーバーが互換性のあるサポートを広告している場合にのみチャンク転送を使用します。古いクライアントでも完全な出力を読み取ることができ、古いかサポートされていないサーバーに接続されたクライアントは通常の転送を維持します。小さな出力は既存の全出力パスのままです。 これは転送バイト数を削減しますが、コンパイラの無効化には影響しません。ソースファイルの変更は依然としてコンパイルを必要とする場合があります。チャンキングは結果の出力の公開または復元を支援します。節約量は出力と編集内容に依存し、一致するチャンクがないコールドマシンでは出力全体をダウンロードする必要があります。 ### 継続的インテグレーション {#continuous-integration} CI環境でキャッシングを有効にするには、ローカル環境と同じコマンドを実行する必要があります。`tuist setup cache`。 認証には、<.localized_link href="/guides/server/authentication#oidc-tokens">OIDC認証（サポートされているCIプロバイダーに推奨）または`TUIST_TOKEN`環境変数を使用した<.localized_link href="/guides/server/authentication#account-tokens">アカウントトークンのいずれかを使用できます。 OIDC認証を使用するGitHub Actionsのワークフロー例： ```yaml name: Build permissions: id-token: write contents: read jobs: build: runs-on: macos-latest steps: - uses: actions/checkout@v4 - uses: jdx/mise-action@v2 - run: tuist auth login - run: tuist setup cache - # Your build steps ``` 詳細な例については、<.localized_link href="/guides/integrations/continuous-integration">継続的インテグレーションガイドをご覧ください。トークンベースの認証や、Xcode Cloud、CircleCI、Bitrise、Codemagicなどの他のCIプラットフォームに関する情報も含まれています。 ### CI上のコンパレーションキャッシュストア {#compilation-cache-store-on-ci} コンパレーションキャッシュストアは、Xcodeがコンパイル出力を保持するローカルディレクトリです。`COMPILATION_CACHE_CAS_PATH`ビルド設定はその場所を設定し、デフォルトでは`DerivedData`内の`CompilationCache.noindex`になります。 #### ステートフルストア {#stateful-store} ビルド間でストアを保持するには、`COMPILATION_CACHE_CAS_PATH`（および`tuist cache`用の`TUIST_COMPILATION_CACHE_CAS_PATH`）を1つの永続的なパスに向け、[ストアサイズ制限](#store-size-limit)でそのサイズを制限します。 ## トラブルシューティング {#troubleshooting} ### ビルドがXcodeキャッシュプロキシの失敗を警告する {#cas-proxy-failed} ビルドに以下のような警告が表示される場合、Xcodeは最初に失敗したコンパイルに応じて`CAS error:`または`CAS operation failed:`をプレフィックスとして付加します： ``` warning: CAS error: The Tuist Xcode cache proxy at /Users/you/.local/state/tuist/cas-proxy.sock failed (proxy connect: No such file or directory (os error 2)). Compilations that needed it used the local cache only, without remote cache hits. Their uploads are kept on disk and sent once the proxy is reachable again. Run `tuist setup cache` if the proxy is not running. ``` この場合、コンパレーションキャッシュは`tuist setup cache`がインストールするローカルキャッシュプロキシに到達できませんでした。ビルド自体は成功しますが、影響を受けたコンパイルはリモートキャッシュヒットを得られないため、空のキャッシュでのビルドと同様に実行されます。それらのアップロードはディスク上に保持され、プロキシが再びリクエストを処理できるようになった時点で送信されます。同じビルド中にプロキシが復帰すればその時点で行われ、そうでなければ同じマシンでの次のビルド時に行われます。ジョブ後に廃棄されるCIマシンでは、これらのデータは失われます。警告はビルドごとに1回、XcodeのIssueナビゲーターおよび`xcodebuild`出力に表示されます。 プロキシが実行中かどうかを確認するには、警告に記載されているソケットでリッスンしているプロセスを探します： ```bash lsof ~/.local/state/tuist/cas-proxy.sock ``` コマンドが何も出力しない場合は、`tuist setup cache`を実行してプロキシを再度起動してください。CIでは、各ジョブのあらゆる`xcodebuild`呼び出しの前に`tuist setup cache`を実行してください。 ### ビルドが極端に遅く、`CAS error: deadlineExceeded`警告を出力する {#cas-deadline-exceeded} ビルドが予想よりもはるかに長くかかり、Xcodeビルドログに以下のような警告があふれている場合： ``` Warning: CAS error: deadlineExceeded(connectionError: Optional(connect(descriptor:addr:size:): No such file or directory (errno: 2))) note: cache key query failed ``` または： ``` Warning: CAS error: deadlineExceeded(connectionError: Optional(connect(descriptor:addr:size:): Connection refused (errno: 61))) ``` この場合、`COMPILATION_CACHE_REMOTE_SERVICE_PATH`は誰もリッスンしていないソケットを指しています。通常は、Tuistの以前のバージョンが構成したプロジェクトごとのソケット（`~/.local/state/tuist/_.sock`）です。Tuistはそのソケットをもう提供していません。Xcodeは高速に失敗するのではなく、すべてのコンパレーションキャッシュリクエストで接続を再試行するため、ビルドに1時間以上かかることがあり、Tuistはこの動作を変更できません。 修正方法： - **生成されたプロジェクト**：`tuist generate`を再度実行します。 - **その他のプロジェクト**：`COMPILATION_CACHE_*`ビルド設定を、`tuist setup cache`が出力する設定に置き換えます。詳細は[Xcodeビルド設定の構成](#configure-xcode-build-settings)をご覧ください。 Xcodeキャッシュを使用していない場合は、代わりに`COMPILATION_CACHE_*`ビルド設定を削除し、`tuist teardown cache`を実行してください。 ### アップロードが無効でもローカルで`uploaded CAS output`が表示される {#uploaded-cas-output-with-upload-disabled} `xcodeCache: .xcodeCache(upload: false)`（または非CIマシンでの`upload: Environment.isCI`）が設定されている場合、ビルドログに依然として`note: uploaded CAS output ...`が表示されることがあります。`xcodebuild`にはこれらの呼び出しをスキップする方法がないため、Tuistはそれらを受け取りますが、Tuistサーバーには何も公開しません。ダッシュボードのメトリクスはこの点を考慮しているため、不正なアップロードトラフィックは報告されません。