デバッグログのキャプチャは、モバイルSDKおよびプッシュ通知の問題をトラブルシューティングする最も効果的な方法です。このガイドは、iOSおよびAndroidアプリのデバッグログを生成し、必要に応じてサポートチームとログを共有するのに役立ちます。
デバッグログをキャプチャするには、次のものが必要です:
- 問題を再現できるデバイス
- アプリの開発者ツールへのアクセス
- OneSignal Mobile SDKバージョン5.0.0以上
ステップバイステップの手順
1. 詳細ログを有効にする
OneSignal SDKを初期化する前に、VERBOSEログレベル呼び出しをアプリに追加します。これにより、すべてのOneSignal操作の詳細な診断情報がキャプチャされます。
// LogLevel: NONE | FATAL | ERROR | WARN | INFO | DEBUG | VERBOSE
OneSignal.getDebug().setLogLevel(OneSignal.LOG_LEVEL.VERBOSE);
// LogLevel: .None | .Fatal | .Error | .Warn | .Info | .Debug | .Verbose
OneSignal.Debug.logLevel = LogLevel.Verbose
// LogLevel: ONE_S_LL_NONE | ONE_S_LL_FATAL | ONE_S_LL_ERROR | ONE_S_LL_WARN | ONE_S_LL_INFO | ONE_S_LL_DEBUG | ONE_S_LL_VERBOSE
[OneSignal.Debug setLogLevel:ONE_S_LL_VERBOSE];
OneSignal.Debug.setLogLevel(.LL_VERBOSE)
// LogLevel: None | Fatal | Error | Warn | Info | Debug | Verbose
OneSignal.Debug.LogLevel = LogLevel.Verbose;
OneSignal.Debug.setLogLevel(6);
OneSignal.Debug.setLogLevel(OSLogLevel.verbose);
// 0 = None, 1 = Fatal, 2 = Errors, 3 = Warnings, 4 = Info, 5 = Debug, 6 = Verbose
window.plugins.OneSignal.Debug.setLogLevel(6);
すべてのSDKアクティビティがログに記録されるように、OneSignal.initを呼び出す_前に_ログレベルを設定してください。
2. 問題を再現する
詳細ログを有効にした状態で、Android StudioまたはXcodeに接続された物理デバイスまたはエミュレーターで問題を再現します。
3. ログをキャプチャして共有する
問題が再現されたら、ログを確認して問題の診断に役立つかどうかを確認します。
サポートが必要な場合は、ログ全体を最初から最後までコピー&ペーストし、.txtファイルとしてOneSignalサポートに送信してください。
関連するすべての再現手順、スクリーンショット、およびその他の詳細を含めてください。
プラットフォーム固有の手順
Android Studio
- 下部パネルのRunタブを開きます。(表示されない場合は、View > Tool Windows > Runに移動します)
- 接続されたデバイスまたはエミュレーターでアプリを実行します。
- 問題を再現します。
- すべてのログ出力を選択(
Ctrl + AまたはCmd + A)してコピーします。
.txtファイルに貼り付けます。
- 再現手順とともにファイルをOneSignalサポートに送信します。
📎 サンプルログ(Google Drive)Xcode
重要: クラッシュは、デバイスがMacに接続されていないときに発生する必要があります。クラッシュを再現した後に接続してください。
- XcodeでWindow > Devices and Simulatorsを開きます。
- デバイスを選択し、Open Consoleをクリックします。
- ドロップダウンでAll Messagesでフィルタリングします。
- 問題を再現します。
- すべての出力を選択(
Cmd + A)してコピー(Cmd + C)します。
.txtファイルに貼り付けます。
- 再現手順とともにファイルをOneSignalサポートに送信します。