dSYM の取得とアップロード

Bitcode は、Apple が提供している特定のユーザーのハードウェア用に iOS、tvOS アプリを再コンパイルできる機能です。Bitcode の利点は、エンドユーザーのダウンロードサイズが小さくなることです。この処理の詳細については、Apple の Bitcode と App Thinning のドキュメントを参照してください。

Apple がアプリをコンパイルすると、dSYM ファイルもコンパイルされます。New Relic が Bitcode 対応アプリのクラッシュをシンボル化するには、これらのdSYM ファイルを Apple からダウンロードして New Relic にアップロードする必要があります。

このドキュメントでは、以下の方法について説明します。

  1. New Relic のどのアプリバージョンに dSYM がないかを特定します。
  2. そのアプリを Xcode オーガナイザで検索します。
  3. Apple が作成した dSYM をダウンロードします。
  4. New Relic にアップロードする dSYM を準備します。

不明な dSYM の特定

Bitcode 対応のアプリを App Store のレビューやアドホック配信として、アップルにアップロードするときは、モバイルのクラッシュレポートを適切にシンボル化できるように、dSYM を Apple から手動でダウンロードして New Relic にアップロードする必要があります。アプリをアップロードしてから数分以内に Xcode のアーカイブオーガナイザーからこれらの dSYM をダウンロードできます。この状況になっていれば、次はアーカイブの検索と dSYM のダウンロードに進んでください。

アプリに dSYM ファイルがない場合、New Relic UI には2つの指標があります。

  • バナー通知: Crash report ページにバナー警告が表示されます。警告は次のようなものです: We were unable to locate your dsym (dsym を見つけることができませんでした)
  • マシンコード: Crash report ページのクラッシュのスタックトレースには、人間が判読可能なエラーメッセージではなくマシンコードが表示されます。

不明な dSYM のアプリバージョンの特定

dSYM ファイルがない場合は、アプリのバージョン番号とビルド番号が必要になります。これらの番号を見つける手順は以下の通りです。

  1. Crash report ページにアクセスします。
  2. このページ下部の Details の右側に、App version とアプリのバージョン番号があります。
  3. アプリのビルド番号は、アプリのバージョン番号の直後のカッコ内の値です。

Xcode でアプリのアーカイブを見つけ、dSYM のダウンロード

アプリのバージョンとビルド番号を使って、Xcode オーガナイザで該当するアプリのアーカイブを特定し、dSYM をダウンロードします。

  1. Xcode Organizer を開き、Xcode のメニューから、Window > Organizer ヘアクセスします。
  2. Archives タブを選択します。
  3. 左のリストからアプリを選択します。
  4. Version 列から、(最初に表示されている)アプリのバージョンと(アプリのバージョン後の括弧内にある)ビルド番号に一致するアーカイブを選択します。
  5. Download dSYMs… ボタンを押します。
Download dSYMs for mobile app version/build
Xcode を使って、dSYM をダウンロード: Archives タブから、アプリのバージョン、ビルドを選択しDownload dSYMs ボタンを押します。

dSYM は、Apple からダウンロードできるようになっています。

アップロード用の dSYMs の準備

dSYM を Xcode オーガナイザーと一緒にダウンロードしたら、それらを個別に ZIP 圧縮して、New Relic にアップロードする準備をします。ダウンロードした dSYM は、以下のような UUID を使用して名前が付けられています。

アップロード用に dSYM を準備するには、選択したアプリのアーカイブを右クリックし、Show in Finder を選択してファイルシステム上の dSYM にアクセスします。

  1. Finder ウィンドウで、該当するアーカイブ(この例では A) を右クリックし、Show package contents [パッケージの内容を表示]を選択します。
  2. dSYMs という名前のフォルダを開き(例では B)、UUID を使って、ダウンロードした dSYM を探します。
  3. 各 UUID dSYM (上記の例では C)のこの後の対応については、dSYM の手動アップロードの指示に従ってください。
Prepare dSYMs: Zip by GUID
アップロード用に個々の dSYM の準備::Finder ウィンドウから、アーカイブを右クリックし (A)、DSYMS フォルダにある dSYM を探し (B)、各 dSYM を個別に ZIP 圧縮します (C)。

dSYM のアップロード

dSYM を見つけたら、指示に従い、ZIP された dSYM 毎に、dSYM を手動でアップロードします。

関連情報

関連情報は以下のとおりです。