Zoho Apptics を使用したシンボル化

Zoho Apptics を使用したシンボル化

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

概要

クラッシュの原因を開発者がすばやく把握するには、クラッシュレポートを人が読める形式にシンボル化することが不可欠です。

dSYMファイルとは

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

Appticsでは、dSYMファイルが自動的に処理され、人が読める形式のクラッシュレポートが生成されます。

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

XcodeでdSYMファイルが生成されているかの確認

  1. Xcodeでプロジェクトを開き、Xcodeナビゲーターでプロジェクトファイルを選択します。
  2. ［プロジェクトまたはターゲットを選択］ドロップダウンから、メインのビルドターゲットを選択します。
  3. ターゲットの［ビルド設定］タブを開きます。
  4. タブ上部付近の［すべて］をクリックします。
  5. ［デバッグ情報の形式］を検索します。
  6. ［デバッグ情報の形式］を［dSYMファイルを含むDWARF］に設定します。
  7. アプリを再度ビルドし、AppticsコンソールでdSYMがアップロードされているか確認します。

クラッシュログがシンボル化されていない場合の対処手順

  1. クラッシュのログがシンボル化されていない場合は、以下のいずれかの方法で、クラッシュのシンボル化に必要なシンボルを提供します。

方法1：Mac上の.dSYMファイルの検索

  1. Finderでアプリの.xcarchiveファイルを見つけます。
  2. Finderで.xcarchiveファイルを右クリックし、［パッケージの内容を表示］を選択します。
  3. dSYMバンドルを含む「dSYMs」という名前のフォルダーが表示されます。
  4. このディレクトリーをzip形式で圧縮し、［dSYMの管理］ページからAppticsサーバーにアップロードします。

方法2：Xcode Organizerを使用したdSYMのダウンロード

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


  1. XcodeメニューからOrganizerウィンドウを開きます。
  2. Organizerウィンドウの［製品］セクションで［アーカイブ］を選択します。
  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. ［マイApp］→［選択済みのアプリ］→［アクティビティ］の順に選択します。
    3. アプリのビルドのリストから、dSYMが必要なビルド番号を選択します。
    4. ［dSYMをダウンロード］をクリックします。
    5. このディレクトリーをzip形式で圧縮し、［dSYMの管理］ページからAppticsサーバーにアップロードします。

AppticsでのdSYMファイルの手動アップロード

  1. ［開発者］→［シンボルとマッピング（関連付け）］に移動します。ドロップダウンメニューから、アップロードする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 Images」セクションに記載されているアプリのバイナリのUUIDと一致するか確認します。
Notes
Binary Images:
0x100a04000 - 0x10193bfff +YourApplication arm64 <7071835b82053ddcacc567e60740f27a> /private/var/containers/Bundle/Application/FCEBD58B-724E-477E-890A-D27E438A1D20/YourApplication.app/YourApplication