Bitcodeは、AppleがiOSおよびtvOSアプリケーションを特定のユーザーのハードウェア向けに再コンパイルする機能です。これにより、エンドユーザーのダウンロードサイズが小さくなります。このプロセスの詳細については、Appleの Bitcode and app thinning documentation を参照してください。
Apple がアプリをコンパイルする際に、dSYM ファイルもコンパイルされます。New RelicがBitcode対応アプリのクラッシュをシンボライズするためには、これらのdSYMファイルをAppleからダウンロードして、New Relicにアップロードする必要があります。
欠落しているdSYMを特定する
Bitcode対応アプリをAppStoreのレビューまたはアドホック配布のためにAppleにアップロードする場合、モバイルクラッシュレポートを適切にシンボル化できるように、dSYMをAppleから手動でダウンロードしてNewRelicにアップロードする必要があります。これらのdSYMは、アプリをアップロードしてから数分以内にXcodeのアーカイブオーガナイザーからダウンロードできます。この状況では、手順に従ってアーカイブを検索し、dSYMをダウンロードします。
アプリにdSYMファイルがない場合は、モバイルモニタリングUIに次の3つのインジケーターが表示されます。
バナー通知： クラッシュレポートページにバナー警告が表示されます。警告は次のとおりです。
We were unable to locate your dsym.Upload prompt: Crash type summary のページから、 dSYMファイル がない場合、アップロードするように自動的に促されます。
マシンコード：クラッシュレポートページのクラッシュスタックトレースには、人間が読める形式のエラーメッセージではなく、マシンコードが表示されます。
iTunes ConnectによるdSYMファイルのダウンロード
アプリに必要なdSYMファイルをダウンロードします。
- Apple AppStoreConnectにログインします。
- [アプリ]>（選択したアプリ）>[TestFlight]を選択します。
- アプリケーション用のビルドのリストから、dSYMに必要なビルド番号を選択します。
- [メタデータのビルド]タブから、[ dSYMのダウンロード]を選択します。
そして、出来上がったZIPファイルをNew Relicに直接アップロードします。
- 手動でdSYM をアップロードする場合は、手順1を飛ばしてください。
- このZIPファイルに含まれるdSYMを1つ解凍して、アップロード可能なビルドUUIDを取得してください。(手動アップロード手順の最後のステップに従ってください。)
New Relic が zip ファイルを受け取ると、その zip ファイルに含まれる他のすべての dSYM のビルド UUID が特定されます。
Xcodeのapp archiveを使ってdSYMファイルをダウンロードします。
アプリのバージョンとビルド番号 を使って、Xcode Organizer で該当するアプリのアーカイブを特定し、dSYMをダウンロードします。
Xcodeを使ってdSYMをダウンロードする： Archives タブから、アプリとバージョン/ビルドを選択して、 Download dSYMs.
- Xcodeを開く オーガナイザー: Xcode メニューから、 Window> オーガナイザー> Archives> （モバイルアプリを選択）.
- バージョン から、アプリのバージョン（最初に表示されている）とビルド番号（アプリのバージョンの後にカッコで表示されている）に一致するアーカイブを選択します。
- Select Download dSYMs.
dSYMは、ファイル名にアルファベットと数字が含まれていれば、Appleからダウンロードされます。dSYMのファイル名がプロジェクトの依存関係を表すものであれば、ダウンロードは成功しません。
dSYMのアップロード
dSYMの場所がわかったら、指示に従って、zip圧縮されたdSYMごとにdSYM をアップロードしてください。