リリース成果物を失わずに Xcode を整理する

開発者公開日 更新日 約4分で読めます

Xcode のストレージは、ビルド出力、インデックス、Archives、DeviceSupport、シミュレータ デバイス、ダウンロード可能なプラットフォーム runtime に広がります。再現できるものもあれば、 リリース用 Archive やその dSYM の唯一のコピーであるものもあります。安全なやり方は、種類ごとに 計測し、可能なら Xcode 経由で削除し、出荷済みビルドに紐づく成果物は残すことです。

Xcode が容量を使っている場所

まず、ユーザー領域の主要な 2 つのルートから始めます。

du -sh ~/Library/Developer/Xcode/* ~/Library/Developer/CoreSimulator 2>/dev/null | sort -h

よく重いのは次のものです。

  • DerivedData: ビルド成果物、インデックス、モジュールキャッシュで、通常はプロジェクトごとに 1 フォルダです。作り直せますが、全部消すと以降のインデックスとビルドが高くつきます。まず 古いプロジェクトを狙ってください。
  • DeviceSupport: 実機と OS ビルド向けに取得したシンボルとサポート成果物です。古いエントリでも クラッシュのシンボル化にまだ使えることがあります。
  • Archives: アプリをエクスポートまたは出荷するたびに保存されたビルドです。Apple は、配布した すべてのビルドについて Archive を保持するよう求めています。バイナリと対応する dSYM が、あとから クラッシュ報告を診断するときに必要になることがあるためです。Mac から一度も出なかったビルドの Archive のほうが、掃除候補としては安全です。
  • シミュレータデバイスとプラットフォーム runtime: デバイスは CoreSimulator 配下にあり、 ダウンロード可能な runtime は Xcode のコンポーネントとして管理されます。ひとつのキャッシュでは ありません。

種類ごとに安全に片付ける

DerivedData はプロジェクト単位で扱うのがいちばんです。Xcode を終了し、Xcode › Settings > Locations から Derived Data を開き、古いプロジェクトのフォルダを特定して、そのフォルダだけを ゴミ箱へ移します。全体クリアは、グローバルなインデックスやビルド問題が再ビルドのコストに見合うときだけに してください。

利用できないシミュレータデバイスには専用コマンドがあります。残したいテストデータがないことを確認し、 シミュレータと関連テストを停止してから使ってください。デバイスとそのデータはゴミ箱を経由せず削除されます。

xcrun simctl delete unavailable

これは runtime が利用できないデバイス記録を削除します。runtime イメージ自体はアンインストールしません。 インストール済みプラットフォームとシミュレータ runtime、回収可能なサイズは Xcode › Settings > Components で確認し、再ダウンロードできる runtime を外してください。Apple の Xcode コンポーネントのガイド でも、同じ管理された削除経路が説明されています。デバイス記録は Window › Devices and Simulators を使います。

Archives は Window › Organizer で見直します。配布済みビルドの Archive と dSYM は、まだ使われている 古い本番バージョンも含めて残してください。Apple の デバッグ情報のガイド では、バイナリと dSYM はビルド UUID が一致するときだけ一緒に使えるとされています。 DeviceSupport も一括消去ではなく、選別して見直す価値があります。

DerivedData を移す前に Xcode を終了し、コマンドラインのビルドやテストも停止して、書き込み中のファイルを 削除しないようにします。次回の起動とビルドでは、再インデックス、依存関係の解決、出力の再生成が走るので、 所要時間はプロジェクトと手元に残っているもの次第です。

作り直せる出力と、残しておきたいデータ

DerivedData は再現可能なビルドとインデックスの出力です。プロジェクトごとに、パスのハッシュから名前が付いた フォルダができ、コンパイル済みオブジェクト、モジュールキャッシュ、インデックス、ソース・設定・ ツールチェーン・依存関係から導かれたビルド成果物が入ります。消しても、手元に残っている入力から Xcode が 作り直します。時間とネットワークが要ることがあります。DeviceSupport は種類が違います。実機をデバッグすると、 その OS ビルド向けのサポートとシンボルデータが取り込まれます。シミュレータデバイスと runtime イメージも、 普通のキャッシュフォルダではなく、それぞれ別の管理対象です。選別して残す価値があるのは Archives で、 App Store ビルドのクラッシュ報告をシンボル化するのに必要な dSYM がそこにあります。作り直せるキャッシュと 取得済み成果物の区別が、安全に消してよいものと残すべきものとの境界そのものです。

Xcode の開発者フォルダは再構築可能なキャッシュである DerivedData と module cache、および採取済みアーティファクトである DeviceSupport、Archives、シミュレータに分かれます
Xcode のフットプリントは、再現可能な出力と取得済み成果物に分かれます。Archives と dSYM は、ビルド出荷後も運用上重要であり続けることがあります。

ディスクマップが役立つ場面

Mole の「分析」画面では、容量を使っているのが DerivedData、CoreSimulator、 Archives のどれかを確認できます。

Mole は条件を満たす 60 日間未使用のシミュレータランタイム、DeviceSupport データ、デバイスの App コピー、Instruments の一時記録も一覧に表示します。公開済みの版に必要な Archives や dSYM とは分けて確認してください。ランタイムの削除には Apple の simctl を使います。手動で管理する場合は Xcode の Components、Devices、Organizer を使えます。

安全な作業順

進行中のビルドを止め、Xcode と CoreSimulator を別々に測り、古いプロジェクト単位の DerivedData を消し、 利用できないシミュレータデバイスを削除し、Components から未使用の runtime を外します。Archives は、 出荷済みバージョンとシンボル化の必要性を照らしてから削除してください。ゴミ箱を空にする前に、重要な プロジェクトを 1 つ開き直し、ビルドを通してください。