崩溃和错误

下载开发人员说明（TXT）：crashes-developer-zh.txt

如何配置收集

AppMetrica SDK 中提供了崩溃收集。请检查您平台的集成和传输设置。对于自定义错误消息，开发人员会添加对相应 SDK 方法的调用。

例如，如果应用处理了失败的操作并向用户显示了消息，开发人员可以传输错误以供后续分析。发送哪些情况由应用团队决定。

Android、iOS、Flutter、React Native 和 Unity 方法的链接见错误发送说明。

用于解码 Android 和 iOS 故障的文件

请使用与发生故障的应用构建版本匹配的文件。各平台的要求和上传方法如下。

Android：mapping 文件和调试符号

AppMetrica 允许您收集有关原生和 Java 崩溃的信息。您可以在崩溃和错误报告中分析它们。另请参阅在不同平台上发送错误部分。

为了减小应用大小，代码会在发布构建期间被优化。

如果在构建 Android 应用时压缩并混淆了代码，则崩溃信息会以混淆形式传输。为了从此类崩溃日志中提取数据进行分析，AppMetrica 会在服务器端执行反混淆。

为此，请将 mapping 文件或 SO 文件的调试符号上传到 AppMetrica：在应用构建时自动上传，或通过网页界面手动上传。

要发送文件，请连接 AppMetrica Gradle Plugin。

了解更多

• 崩溃和错误报告
• Android 文档

iOS：dSYM 文件

iOS 上的崩溃信息以符号化形式发送。从此类崩溃日志中很难提取数据进行分析。为了使崩溃日志可分析，请将 dSYM 文件上传到 AppMetrica。

要将 dSYM 文件上传到 AppMetrica SDK，内置了命令行工具 helper。对于使用 fastlane 的构建，支持上传插件。借助它们，您可以配置在应用构建时自动上传 dSYM 文件。

请仅为您想要发布的应用发送 dSYM 文件。

构建时自动上传

使用 fastlane 构建应用：

1. 安装 appmetrica fastlane 插件：

   fastlane add_plugin appmetrica
   

   有关添加插件的更多信息，请参阅 fastlane 文档。

2. 在 fastlane/Fastfile 文件中添加以下内容：

   lane :release do
   # Your actions before.
   gym(
   workspace: "MyApp.xcworkspace",
   configuration: "Release",
   scheme: "MyApp",
   export_method: "app-store"        # Pass the correct export_method.
   )
   upload_symbols_to_appmetrica(post_api_key: "Post API key")
   # Your actions after.
   end
   

   Post API key 可以在 AppMetrica 的设置部分获取。它用于标识您的应用。

   重要

   构建应用时使用带导出的 gym action。如果您使用 Xcode 构建应用，应用在上传到 App Store Connect 后会被重新编译。那么构建时生成的 dSYM 文件将无法使用。

3. 在 Xcode 中使用 helper 工具添加 dSYM 文件上传步骤。helper 工具从 3.8.0 版本开始包含在 AppMetrica SDK 中。它位于 SDK 归档中。helper 工具参考。

   1. 在 Xcode 中打开项目。

   2. 在项目导航器中选择项目文件。

   3. 在 Targets 块中选择您的应用。

   4. 打开 Build Phases 选项卡。

   5. 点击 + 按钮 → New Run Script Phase。

   6. 在 Type a script 文本字段中添加：

      if [ -d "${PODS_ROOT}/AppMetricaCrashes" ]; then
      HELPER_PATH=`find "${PODS_ROOT}/AppMetricaCrashes" -name "helper"`
      if [ -x  "${HELPER_PATH}" ]; then
      "${HELPER_PATH}" auto --post-api-key="Post API key"&
      else
      echo "AppMetricaСrash helper was not found"
      fi
      fi
      

   备注

   auto 模式使用 CONFIGURATION 环境变量。如果构建使用 Debug 配置，则不会上传 dSYM 文件。

上传缺失的 dSYM 文件

如果在应用构建时未上传 dSYM 文件，崩溃报告中将显示未符号化崩溃的警告。

要符号化它们，请上传缺失的 dSYM 文件。缺失文件列表可以在 AppMetrica 中您应用的设置 → 崩溃页面查看。

缺失的 dSYM 文件可以通过以下方式上传：

• 使用 fastlane
• 通过网页界面
• 使用 helper

helper -k <post-api-key> <file_path>

helper 工具参考

Helper 是一个命令行工具，允许您将 dSYM 文件上传到 AppMetrica。

$ helper [auto] [-o | --package-output-path=<path>] [-v | --verbose]
         [--version] -k <post-api-key> | --post-api-key=<key> [file ...]

参数

& 允许您并行运行 helper，而不会阻塞整个项目的构建。示例命令：

helper auto --post-api-key="Post API key"&

了解更多

• 崩溃和错误报告
• Apple 文档

Post API key 可以在 AppMetrica 的设置部分获取。它用于标识您的应用。

如何检查结果

1. 在测试环境中复现受控的错误或故障。
2. 打开崩溃和错误报告，找到测试版应用的数据。
3. 检查消息、设备和调用堆栈 — 与故障相关的函数序列。
4. 如果堆栈不可读，请检查是否存在专门针对此构建的调试文件。

崩溃按调用堆栈分组；错误分组取决于发送方法。详情见崩溃和错误文档。

在不同平台上发送错误

• Android
• iOS
• Flutter
• React Native
• Unity