tvOS SDK 故障排除

重要

Visual Studio App Center 计划于 2025 年 3 月 31 日停用。 虽然可以继续使用 Visual Studio App Center，直到它完全停用，但你可以考虑迁移到几个建议的替代方法。

详细了解支持时间线和替代方案。

• Android
• iOS
• macOS
• tvOS
• React Native
• Cordova
• Unity
• Windows
• MAUI/Xamarin

安装过程中的问题

1. 在控制台中，查找包含消息“已成功配置 App Center SDK”的断言日志。 这会验证 SDK 是否已成功配置。
2. 如果使用 Cocoapods 将 App Center 集成到 tvOS 应用中，并遇到错误消息 - 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 将在 控制台中打印日志。 C 在 SDK 启动之前插入以下调用：

   [MSACAppCenter setLogLevel:MSACLogLevelVerbose]
   

   AppCenter.logLevel = .verbose
   

   确保“成功配置 App Center SDK”显示在日志 (信息日志级别) ，如果看到 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”显示在日志 (信息日志级别) ，如果看到 HTTPS 请求日志，则检查。

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

6. 确保设备处于联机状态，并且应用可以访问 Internet。

7. 有时，日志可能需要几分钟才能显示在门户中。 如果是这样，请等待一段时间。

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

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

保护 App Center 机密值

app_secret是应用的标识符，需要知道流量应用于哪个应用，并且不能用于检索或编辑现有数据。 app_secret如果暴露，最大的风险是向应用发送错误数据，但不会影响数据的安全性。

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

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