Xcode 27.2 RCでdSYMが見つからない場合は、まずクラッシュが起きたビルドのXcode Archiveを探し、クラッシュレポートのバイナリUUIDと対応するdSYMのUUIDを照合してください。一致しないなら、別ビルドや再ビルドのdSYMで代用しないでください。
App StoreまたはTestFlightに配布したAppのクラッシュログを読めない独立開発者向けです。小規模チームのリリース担当者や、リモートMac・CIの成果物を管理する担当者も、Archiveとシンボルファイルの対応を確認できます。
最終更新:2026年11月1日。Xcode 27.2 RCの公開状況はApple Developerのリリース一覧、ArchiveとdSYMの扱いはAppleのXcode関連文書で確認しています。
01 最初に症状を切り分ける
「dSYMがない」と「クラッシュを符号化できない」は、同じ状態とは限りません。ログにアドレスだけが表示される、呼び出し履歴の一部だけが読めない、Xcodeが不足ファイルを通知する、といった症状を、最初からXcode 27.2 RCの一般的な不具合と決めつけないでください。
まず、クラッシュレポートに記載されたAppのビルド情報と、問題のフレームが属するバイナリを確認します。AppleのクラッシュレポートJSON形式の説明では、レポート内のバイナリ情報を確認できます。症状と次の確認先を分けると、無関係なシンボルファイルを試す手戻りを避けられます。
| 見えている症状 | まず確認する証拠 | 次の判断 |
|---|---|---|
| スタックにアドレスが残る | 該当バイナリの名前とUUID | 対応するArchive内のdSYMを探します |
| 自作コードの一部だけ読めない | App本体・拡張のUUIDとdSYM | 未読フレームが属するTargetごとに照合します |
| 第三者フレームだけ読めない | 依存フレームワークのバイナリ名とUUID | その依存元が提供するdSYMを確認します |
| Xcodeがシンボル不足を示す | ビルド識別情報と不足対象 | ファイル名ではなくUUIDで一致を判定します |
02 Archiveの有無と保存先
Xcode 27.2 RCで生成したdSYMはどこにありますか?
まず、XcodeのOrganizerにあるArchivesから、クラッシュが起きた配布ビルドのXcode Archiveを探します。Archiveが見つかったら内容を確認し、App本体だけでなく、拡張や埋め込みフレームワークのdSYMも調べてください。Appleはビルドにデバッグ情報を含める方法と、不足しているデバッグシンボルファイルの特定方法を案内しています。
Archiveが見当たらない場合は、配布担当者の保存先や、ビルドを実行したMac・CIの成果物保管先を調べます。探す対象は「同じアプリ名のファイル」ではなく、クラッシュしたビルドに対応するArchiveです。別のビルドを後から作り直しても、元のバイナリと同じUUIDを持つdSYMが自動的に得られるとは限りません。
| 入手できたもの | 確認できること | 限界・次の対応 |
|---|---|---|
| 配布時のArchive | App本体や含まれるdSYMの確認 | 各バイナリのUUIDを照合します |
| dSYMだけ | UUIDと対象バイナリの照合 | 対応するクラッシュレポートが必要です |
| App Store Connect上のビルド情報 | 配布ビルドの識別情報の確認 | 手元にArchiveが残っている証拠にはなりません |
| 再ビルドしたArchive | 再ビルド成果物の確認 | 問題の旧ビルドのシンボルを代替できるとは限りません |
対応するArchiveがない場合、古いAppのクラッシュを符号化できますか?
対応するdSYMが別の保管先に残っていれば、そこから復旧できる可能性があります。まず開発用Mac、ビルド用Mac、CIの成果物保存先、チームの引き継ぎフォルダを確認してください。それらにも該当ビルドのArchiveや一致するdSYMがなければ、旧ビルドを完全に符号化できない場合があります。
同じソースコードから作った再ビルドは、元の配布物と同一のビルド成果物とは限りません。Appleのデバッグシンボル不足に関する案内に沿って不足対象を確認し、同じUUIDのシンボルが見つからない時点で、別ビルドのdSYMを使う試行は止めてください。
03 UUID照合による正誤判定
dSYMのUUIDとクラッシュレポートのUUIDが違う場合は?
名前が似ていても、UUIDが一致しないdSYMは対象ビルドのシンボルファイルではありません。クラッシュレポートから該当バイナリのUUIDを読み取り、候補となるdSYMのUUIDと照合します。UUIDが違う場合は、そのファイルを使った符号化を中止し、正しいArchiveか別の保管先を探してください。
照合では、未読フレームが属するバイナリを取り違えないことも重要です。App本体、拡張、フレームワークでは、それぞれ別のシンボルファイルが必要になることがあります。Appleのクラッシュレポートへの識別可能なシンボル名の追加方法を参照し、対象のバイナリ単位で判定します。
実作業では、次の順で確認します。
- [ ] クラッシュレポートと対象Appのビルド情報を確認します。
- [ ] 読めないフレームが属するバイナリ名を特定します。
- [ ] そのバイナリに対応するArchive内のdSYMを探します。
- [ ] クラッシュレポートのUUIDとdSYMのUUIDを照合します。
- [ ] UUIDが一致した場合に限り、符号化を再試行します。
- [ ] 不一致なら別のArchiveを探し、再ビルド品で置き換えません。
04 一部だけ読めない場合の確認先
すべてのフレームが読めないとは限りません。自作コード、システムフレームワーク、第三者フレームワークを分けて調べてください。
自作Appや拡張のフレームなら、該当する配布ArchiveとdSYMの組み合わせを確認します。システムフレームワークなら、対象となるOSや端末に対応したデバイスシンボルを確認します。第三者フレームワークなら、依存元が提供するシンボルファイルが対象バイナリと一致するかを調べてください。自作コードのシンボルが見つからないことだけを根拠に、ビルド全体のdSYMが壊れていると判断する必要はありません。
UUIDが一致しないファイルは、名前や保存場所が正しそうに見えても代用できません。照合結果と調査した保存先を記録してから、別の成果物を探してください。
05 App Store Connectで確認できる範囲
配布ビルドのシンボルが正しくアップロードされたか確認できますか?
App Store Connectに該当ビルドが表示されることは、配布ビルドの情報を確認する手掛かりです。ただし、ビルドが見えることと、チームの手元に完全なArchiveや対応するdSYMが保存されていることは別です。Appleのビルドとメタデータを表示する手順で、対象ビルドの情報を確認してください。
次に、Xcode側で配布時のシンボル処理や不足の表示を調べ、対象バイナリのUUIDが合っているかを確認します。プラットフォーム上のビルド情報だけから、ローカルArchiveの保存状態や、あらゆるフレームの符号化可否まで推定しないでください。App Store Connectの確認は、ArchiveやUUID照合の代わりではありません。
06 次回リリースに残す成果物
旧ビルドのシンボルを見つけられなかった場合は、次回から配布単位で成果物を残せるよう手順を見直します。リモートMacやCIを使う場合も、保存したという記録だけで済ませず、引き継ぎ後に実際に取得して開けることを確かめてください。
- [ ] 配布ビルドごとに、Archiveと含まれるdSYMを保存します。
- [ ] ビルド識別情報と成果物の保存先を記録します。
- [ ] App本体、拡張、埋め込みフレームワークを対象ごとに確認します。
- [ ] 引き継ぎ先からArchiveとdSYMを取得できるか確かめます。
- [ ] テスト用クラッシュレポートで、対応するUUIDを照合します。
- [ ] 保存期間や削除権限をチームの運用手順に明記します。
リモートMacでビルドする運用を検討するなら、まずリモートMacの利用案内で利用形態を確認し、成果物をどこへ保存し、誰が再取得できるのかを自分の手順に合わせて決めてください。利用条件を比較する場合は料金とプランも確認できます。
ローカルMacだけに保存すると、整理や故障の際に成果物を失うおそれがあります。CIの一時領域だけに置く方法も、保存期限やアクセス権の確認が欠かせません。再ビルドは旧UUIDの代用品にならないため、ArchiveとdSYMの対応関係を保てる運用が必要です。専用Macを購入するほどではなく、リリース時のビルド環境を分けたい場合は、CALMVPSのリモートMacも候補になります。契約前にArchiveやdSYMを自分で保存・再取得できる方法を確認し、符号ファイルの自動保管や固定期間の保持があるとは前提にせず、必要な成果物の管理方法を決めてください。