Zoho Appticsを使用したシンボリケーション

Zoho Appticsを使用したシンボリケーション

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

概要

クラッシュレポートを人が読める形式に変換することは、開発者がクラッシュの原因を迅速に把握するために不可欠です。

dSYMファイルとは？

dSYMファイルは、Apple XcodeがAppleアプリを作成するたびに、実行可能バイナリと一緒に生成するデバッグ用シンボルファイルです。dSYMファイルには、クラッシュレポートをシンボリケートするために必要なすべてのデバッグ情報が含まれています。

AppticsはdSYMファイルを自動的に処理し、人が読めるクラッシュレポートを提供します。

dSYMのアップロードがプロジェクト固有の設定やアプリ内のbitcodeにより失敗した場合は、AppticsコンソールでdSYMファイルを手動でアップロードできます。

XcodeがdSYMファイルを生成しているか確認する

  1. Xcodeでプロジェクトを開き、Xcodeナビゲーターでプロジェクトファイルを選択します。
  2. 選択したプロジェクトまたはターゲットのドロップダウンから、メインのビルドターゲットを選択します。
  3. ターゲットのビルド設定タブを開きます。
  4. タブ上部付近の「すべて」をクリックします。
  5. 「debug information format」で検索します。
  6. Debug information formatを「DWARF with dSYM file」に設定します。
  7. アプリを再度ビルドし、AppticsコンソールでdSYMがアップロードされているか確認してください。

クラッシュログがシンボリケートされない場合の対応手順

  1. クラッシュ時にログがシンボリケートされない場合は、下記のいずれかの方法を選択して、クラッシュのシンボリケーションに必要なシンボルを提供してください。

方法1: Mac上で.dSYMを探す

  1. Finderでアプリケーションの.xcarchiveファイルを探します。
  2. Finderで.xcarchiveファイルを右クリックし、「パッケージの内容を表示」を選択します。
  3. dSYMsという名前のフォルダが表示され、その中にdSYMセットが含まれています。
  4. このディレクトリをZIP圧縮し、AppticsサーバーのdSYM管理ページにアップロードします。

方法2: Xcode Organizerを使ってdSYMをダウンロード

  1. 以下の手順に従って、Xcode OrganizerからdSYMファイルをダウンロードしてください。


  1. XcodeメニューからOrganizerウィンドウを開きます。
  2. Organizerウィンドウ内の「商品」セクションで「Archives（アーカイブ）」を選択します。
  3. 右側の詳細タブで「デバッグシンボルをダウンロード」をクリックします。
  4. このディレクトリをZIP圧縮し、AppticsコンソールのdSYM管理ページにアップロードしてください。

方法3: bitcode有効アプリ用のシンボルをiTunes Connectからダウンロード

  1. アーカイブ作成およびアプリをiTunes Connectにアップロードした後、Appleによる処理が行われます。App StoreからアプリdSYMの正しいバージョンを取得するには、Xcode Archives Organizerを使用するか、iTunes Connectにログインしてください。
  1. bitcode有効バージョンのdSYMファイルをiTunes Connectポータルからダウンロードするには、以下の手順に従ってください。
    1. Apple iTunes Connectにログインします。
    2. 「My Apps」＞（対象アプリ）＞「活動」を選択します。
    3. アプリケーションのビルド一覧から、dSYMが必要なビルド番号を選択します。
    4. 「dSYMをダウンロード」をクリックします。
    5. このディレクトリをZIP圧縮し、AppticsサーバーのdSYM管理ページにアップロードします。

AppticsでdSYMファイルを手動アップロードする

  1. Developer > Symbols & Mappingへ移動します。アップロードしたいdSYMファイルとアプリケーションIDをドロップダウンメニューから選択します。
  2. アップロードするをクリックすると、ポップアップが表示されます。
  3. 該当するアプリのバージョンと作成バージョンをドロップダウンから選択します。
  4. ファイルを選択をクリックし、.zipファイルを選びます。
  5. アップロードするをクリックすると、dSYMファイルがコンソールに表示されます。

Info
メモ: 同じバージョンの複数ビルドをApp Storeにアップロードした場合、複数のdSYMファイルがappticsサーバーにアップロードされます。その場合、開発者はどのdSYMをリリース済みバージョンから届いたクラッシュのシンボリケーションに使用するか選択できます（初期設定では最新のdSYMファイルが選択されます）。

シンボリケートされていないクラッシュレポートのトラブルシューティング

クラッシュが正しいシンボルをアップロードした後もシンボリケートされていない場合、アップロードされたdSYMファイルがクラッシュレポートのアプリバージョンと一致していない可能性があります。

dwarfdumpコマンドを使用して、dSYMファイルのUUIDがクラッシュレポートのUUIDと一致しているか確認できます。
  1. dSYMファイル内のUUIDを確認するには:
Notes
dwarfdump -u YourApplication.app.dSYM
  1. ターミナルに以下のような表示がされます:
Notes
UUID: 331EB9D3-5C70-3143-80BF-8D5B5FC394BC (armv7)。YourApplication.app.dSYM/Contents/Resources/DWARF/YourApplication UUID: 7071835B-8205-3DDC-ACC5-67E60740F27A (arm64)。YourApplication.app.dSYM/Contents/Resources/DWARF/YourApplication
  1. ターミナルに表示されたUUIDが、クラッシュレポートの「Binary画像」セクションに記載されているアプリケーションバイナリのUUIDと一致しているか確認してください。
Notes
バイナリ画像：
0x100a04000 - 0x10193bfff +YourApplication arm64 <7071835b82053ddcacc567e60740f27a> /非公開/var/containers/セット販売/Application/FCEBD58B-724E-477E-890A-D27E438A1D20/YourApplication。app/YourApplication