tvOS SDK 故障排除

重要

Visual Studio App Center 于 2025 年 3 月 31 日停用,但分析和诊断功能除外,这些功能将继续受支持,直到 2026 年 6 月 30 日。 了解详细信息

安装过程中的问题

  1. 在控制台中,查找包含消息“App Center SDK 已成功配置”的 Assert 日志。 这会验证是否已成功配置 SDK。
  2. 如果使用 Cocoapods 在 tvOS 应用中集成 App Center,并遇到错误消息 - CocoaPods - Unable to find a specification for AppCenter请运行 pod repo update 以更新本地 Cocoapods 存储库,然后再次运行 pod install
  3. 如果要手动集成 SDK 二进制文件,请确保为项目启用模块。

分析数据不会显示在门户中。

  1. 请确保已正确集成 SDK 模块。

  2. 请确保在 start:withServices: 方法调用中包含正确的应用机密。 可以通过在门户中打开应用并导航到start:withServices:”页来复制确切的代码。

  3. 若要查看发送到后端的日志,请在应用程序中将日志级别更改为 详细,SDK 将在 控制台中打印日志。 在 SDK 启动之前,插入以下调用:

    [MSACAppCenter setLogLevel:MSACLogLevelVerbose]
    
    AppCenter.logLevel = .verbose
    

    请确保日志中会显示“已成功配置的 App Center SDK”(在 INFO 日志级别),然后检查是否看到 HTTPS 请求日志。

  4. 确保设备处于联机状态,并且应用具有 Internet 访问权限。

  5. 有时,日志可能需要几分钟才能显示在门户中。 如果情况如此,请等待一段时间。

  6. 若要检查 App Center 后端是否已收到数据,请转到 Analytics 服务中的“日志流”部分。 你的事件在发送后应显示。

系统崩溃不会显示在门户中。

  1. 请确保已正确集成 SDK 模块。

  2. 请确保在 start:withServices: 方法调用中包含正确的应用程序密钥。 可以通过在门户中打开应用并导航到start:withServices:”页来复制确切的代码。

  3. 崩溃后重启应用。 应用重启后,App Center 崩溃才会转发崩溃日志。 此外,如果附加到调试器,SDK 不会转发任何故障日志。 请确保在应用崩溃时没有附加调试器。

  4. 若要查看发送到后端的日志,请在应用程序中将日志级别更改为 详细,SDK 将在 控制台中打印日志。 在 SDK 启动之前插入以下调用:

    [MSACAppCenter setLogLevel:MSACLogLevelVerbose]
    
    AppCenter.logLevel = .verbose
    

    请确保日志中会显示“已成功配置的 App Center SDK”(在 INFO 日志级别),然后检查是否看到 HTTPS 请求日志。

  5. 请勿使用提供崩溃报告功能的任何其他库。 只能在应用中集成一个崩溃报告 SDK。

  6. 确保设备处于联机状态,并且应用具有 Internet 访问权限。

  7. 有时,日志可能需要几分钟才能显示在门户中。 如果情况如此,请等待一段时间。

  8. 如果要检查 SDK 是否在下一个应用启动时检测到崩溃,可以调用 API 来检查应用是否在上一个会话中崩溃并显示警报。 或者,可以扩展故障 didSucceedSendingErrorReport 回调,以查看它是否已成功发送到服务器。

  9. 若要检查 App Center 后端是否收到崩溃,请转到 Analytics 服务中的“日志流”部分。 你的崩溃报告发送后应该会在那里显示。

保护 App Center 机密值

这是 app_secret 应用的标识符,需要知道流量应用于哪些应用,并且不能用于检索或编辑现有数据。 如果暴露了 app_secret 数据,最大的风险是向应用发送不良数据,但它不会对数据的安全性产生影响。

若要检索任何敏感数据,需要提供在客户端生成的应用/用户 令牌。 无法使客户端上的数据完全安全。

可以通过使用环境变量将应用机密注入代码来提高应用的安全性。 这样,密码在代码中不可见。