CrashReporter モジュール
アプリのクラッシュを自動的に追跡します。モジュールが有効化され、対応するフレームワークがインストールされると、アプリでクラッシュが発生するとクラッシュイベントがトリガーされます。
使用法
CrashReporter モジュールは、アプリのクラッシュを自動的に追跡します。モジュールが有効化され、対応するフレームワークがインストールされると、アプリでクラッシュが発生するとクラッシュイベントがトリガーされます。
このフレームワークの使用は、アプリのクラッシュに関する重要な情報を得るために推奨されます。
以下のプラットフォームがサポートされています:
- iOS
要件
TealiumCrashReporteriOS
インストール
CocoaPods、Carthage、または手動で CrashReporter モジュールをインストールします。
CocoaPods
CocoaPodsでCrashReporterモジュールをインストールするには:
-
Podfileに以下のpodを追加します:
pod 'tealium-swift/Crash'
-
外部の
TealiumCrashReporteriOS
依存関係とTealiumAppData
、TealiumDeviceData
、Core
モジュールを自動的にインストールするには、以下のコマンドを実行します:pod install
フレームワークは自動的にインスタンス化されます。pods TealiumCore
と TealiumCrashReporteriOS
に依存しています。iOSのCocoaPodsインストールについてはこちらを参照してください。
Carthage
以下のビデオは、Carthageを使用してCrashReporterモジュールをセットアップする方法を示しています:
フレームワークは自動的にインスタンス化されます。ただし、アプリにコンパイルされている必要があります(“Embedded Binaries"に含まれている)。TealiumCore
と TealiumCrashReporteriOS
(外部依存関係)に依存します。
-
Swift Carthage インストールの手順に従います。
-
コマンド
carthage update --platform iOS
を実行し、結果として得られたフレームワークをアプリに含めます:TealiumCore.framework
+ すべての標準的な Tealium フレームワークTealiumCrash.framework
TealiumCrashReporteriOS.framework
-
Carthage Getting Started ガイドの指示に従って、App Storeにアプリを提出するための関連するBuild Phasesスクリプトを追加します。
手動
- Swift 手動インストールの手順に従います。
TealiumCrashReporteriOS.framework
をダウンロードします。Tealium
とTealiumCrash
スキームをビルドします。- 以下をXcodeのEmbedded Binariesセクションにドラッグアンドドロップします:
TealiumCore.framework
TealiumCrash.framework
TealiumAppData.framework
TealiumDeviceData.framework
TealiumCrashReporteriOS.framework
データレイヤー
モジュールが有効化されている間、以下の変数が各トラッキングコールと共に送信されます:
変数 | 説明 | 例 |
---|---|---|
crash_uuid |
この特定のクラッシュの一意の識別子 | "CC2DA0E9-E544-429A-AC5E-A268FC62F02A" |
device_memory_usage* |
クラッシュ時のデバイス上のアプリの現在のメモリ使用量 | "143.57MB" |
app_memory_usage |
クラッシュ時のデバイス上のアプリの現在のメモリ使用量 | "143.57MB" |
device_memory_available* |
クラッシュ時のデバイスの空きメモリ | "1068.88MB" |
memory_free |
クラッシュ時のデバイスの空きメモリ | "1068.88MB" |
device_os_build |
現在のOSビルド番号 | "15E217" |
crash_process_id |
クラッシュ時のアプリのPID | "84351" |
crash_process_path |
アプリが実行されていたパス | "/DemoApp.app/DemoApp" |
crash_parent_process |
アプリを起動した親プロセス | "launchd_sim" |
crash_parent_process_id |
親プロセスのPID | "83183" |
crash_name |
利用可能な場合のクラッシュのフレンドリーな名前 | "Crash Name" |
crash_cause |
クラッシュの原因 | "Crash Reason" |
crash_signal_code |
クラッシュを引き起こしたシグナルコード | "#0" |
crash_signal_name |
クラッシュを引き起こしたシグナル名 | "SIGABRT" |
crash_signal_address |
クラッシュのシグナルアドレス | "4572945982" |
crash_libraries |
クラッシュ時にロードされていたライブラリのリスト | [{"baseAddress": "0xa3e0000", "codeType": { "arch": 64, "typeEncoding": "Mach"}, "imageName": "/Applications/Xcode9.3.app/Contents/ Developer/Platforms/iPhoneOS.platform/ Developer/Library/CoreSimulator/Profiles /Runtimes/iOS.simruntime/Contents/ Resources/RuntimeRoot/usr/lib/dyld_sim", "imageSize": 212992, "imageUuid": "4015e9b70bde"}] |
crash_threads |
クラッシュ時のすべてのアクティブスレッド | {"crashed": 1,"registers": {"cs": "0x07"},"stack": {"instructionPointer": 4572945982,"symbolInfo": {"symbolName": "","symbolStartAddr": 0},"threadId": ""}} |
- これらの変数は、以前のリリースとの後方互換性のために複製されています
クラッシュの呼び出し
TealiumCrashReporteriOS.framework
がプロジェクトに追加されると、追加の初期化手順は必要ありません。クラッシュモジュールが有効化され、Tealium SDKが初期化されている限り、アプリでクラッシュが発生すると、クラッシュデータは自動的にトラッキングコールの一部となります。
API リファレンス
invokeCrash()
CrashReporter モジュールのクラッシュを呼び出します。
TealiumCrashReporter.invokeCrash(name, reason)
パラメータ | タイプ | 説明 | 例 |
---|---|---|---|
name |
String |
クラッシュの名前 | "TEST_CRASH_NAME" |
reason |
String |
クラッシュの理由 | "TEST_CRASH_REASON" |
最終更新日 :: 2024年November月6日