跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt

Use this file to discover all available pages before exploring further.

捕获调试日志是排除移动 SDK 和推送通知问题最有效的方法。本指南将帮助您为 iOS 和 Android 应用生成调试日志,并在需要时与我们的支持团队共享日志。

要求

要捕获调试日志,请确保您具有:
  • 可以重现问题的设备
  • 访问应用开发工具的权限
  • OneSignal 移动 SDK 版本 5.0.0 或更高版本

分步说明

1. 启用详细日志记录

在初始化 OneSignal SDK 之前,在您的应用中添加 VERBOSE 日志级别调用。这确保为每个 OneSignal 操作捕获详细的诊断信息。
// LogLevel: NONE | FATAL | ERROR | WARN | INFO | DEBUG | VERBOSE
OneSignal.getDebug().setLogLevel(OneSignal.LOG_LEVEL.VERBOSE);
Set the log level before calling OneSignal.init to ensure all SDK activity is logged.

2. Reproduce the issue

启用详细日志记录后,在连接到 Android Studio 或 Xcode 的物理设备或模拟器上重现问题。

3. Capture and Share the Logs

一旦重现了问题,请查看日志以了解是否有助于诊断问题。 如果您需要帮助,请复制粘贴从开始到结束的整个日志,并以 .txt 文件形式发送给 OneSignal 支持。 包括所有相关的重现步骤、截图和其他详情。

特定平台说明

Android Studio

  1. 在底部面板中打开运行选项卡。(如果不可见,请转到 视图 > 工具窗口 > 运行
  2. 在连接的设备或模拟器上运行应用。
  3. 重现问题。
  4. 选择所有日志输出(Ctrl + ACmd + A)并复制。
  5. 将其粘贴到 .txt 文件中。
  6. 将文件与重现步骤一起发送给 OneSignal 支持。
📎 示例日志(Google Drive)