ビットコードアプリのdSYMを取得する

ビットコードは、Apple が特定のユーザーのハードウェア用に iOS および tvOS アプリケーションを再コンパイルできるようにする機能です。これにより、エンド ユーザーのダウンロード サイズが小さくなります。このプロセスの詳細については、Apple のビットコードとアプリの細線化に関するドキュメント を参照してください。Apple がアプリをコンパイルすると、dSYM ファイルもコンパイルされます。New Relic が Bitcode 対応アプリのクラッシュを象徴できるようにするには、これらの dSYM ファイルを Apple からダウンロードしてから New Relic にアップロードする必要があります。

欠落しているdSYMを特定する

Bitcode対応アプリをAppStoreのレビューまたはアドホック配布のためにAppleにアップロードする場合、モバイルクラッシュレポートを適切にシンボル化できるように、dSYMをAppleから手動でダウンロードしてNewRelicにアップロードする必要があります。これらのdSYMは、アプリをアップロードしてから数分以内にXcodeのアーカイブオーガナイザーからダウンロードできます。この状況では、手順に従ってアーカイブを検索し、dSYMをダウンロードします。

アプリにdSYMファイルがない場合は、モバイルモニタリングUIに次の3つのインジケーターが表示されます。

• Banner notification: Crash reportページにバナー警告が表示されます。 警告には次のように書かれています。

  We were unable to locate your dsym.

  コピー

• Upload prompt: Crash type summaryページでは、dSYM ファイルが見つからない場合はアップロードするように自動的に求められます。

• Machine code: Crash reportページのクラッシュ スタック トレースには、人間が判読できるエラー メッセージではなく、マシン コードが表示されます。

iTunes ConnectによるdSYMファイルのダウンロード

アプリに必要なdSYMファイルをダウンロードします。

1. Apple AppStoreConnectにログインします。

2. Apps > (select an app) > TestFlight

   を選択します。

3. アプリケーション用のビルドのリストから、dSYMに必要なビルド番号を選択します。

4. Build Metadata

   タブから

   Download dSYM

   を選択します。

そして、出来上がったZIPファイルをNew Relicに直接アップロードします。

1. 手動でdSYM をアップロードする場合は、手順1を飛ばしてください。
2. このZIPファイルに含まれるdSYMを1つ解凍して、アップロード可能なビルドUUIDを取得してください。(手動アップロード手順の最後のステップに従ってください。)

New Relic が zip ファイルを受け取ると、その zip ファイルに含まれる他のすべての dSYM のビルド UUID が特定されます。

Xcodeのapp archiveを使ってdSYMファイルをダウンロードします。

アプリのバージョンとビルド番号を使用して、Xcode Organizer内の該当するアプリ アーカイブを識別し、dSYM をダウンロードします。

1. Xcode

   Organizer

   を開きます:

   Xcode

   メニューから

   Window > Organizer > Archives > (select a mobile app)

   を選択します。

2. Version

   から、アプリのバージョン (最初にリストされている) とビルド番号 (括弧内のアプリのバージョンの後) に一致するアーカイブを選択します。

3. Download dSYMs

   を選択します。

dSYMは、ファイル名にアルファベットと数字が含まれていれば、Appleからダウンロードされます。dSYMのファイル名がプロジェクトの依存関係を表すものであれば、ダウンロードは成功しません。

dSYMのアップロード

dSYMの場所がわかったら、指示に従って、zip圧縮されたdSYMごとにdSYM をアップロードしてください。