Xamarin Forms中Microsoft.AppCenter.Analytics SSL报错无法上报数据

通用排查项 #

• 确认AppCenter依赖包版本：你安装的Microsoft.AppCenter.Analytics和Microsoft.AppCenter.Crashes包是否为最新稳定版，老旧版本可能存在TLS版本不兼容问题，AppCenter服务端已经停止支持TLS1.0/1.1，仅支持TLS1.2及以上版本
• 确认真机网络环境：是否使用了公司内网代理、VPN、或者防火墙限制了对AppCenter服务端域名的访问，部分企业网络会拦截海外服务请求，可切换手机到4G/5G公众网络测试
• 共享项目初始化代码检查：确认App启动时调用AppCenter.Start的代码参数正确，秘钥没有写错，iOS和Android的秘钥要和对应平台的AppCenter应用对应

Android端专属修复 #

• 配置项目默认TLS版本：右键Android项目 -> 属性 -> Android选项 -> 高级，将「SSL/TLS实现」设置为「Native TLS 1.2+」，最低Android版本要设置为5.0及以上
• 针对Android 7.0以下系统的兼容：如果你的App兼容Android 6.0及更低版本，需要在项目中安装Microsoft.AppCenter.Android.Bindings最新版，或者手动注入支持TLS1.2的安全提供程序，代码示例：

// 在Android的MainActivity OnCreate方法中，AppCenter初始化之前添加
Java.Security.Security.InsertProviderAt(Java.Security.Security.GetProvider("GmsCore_OpenSSL") ?? Java.Security.Security.GetProvider("Conscrypt"), 1);

• 清除应用缓存后重新运行测试

iOS端专属修复 #

• 配置ATS（应用传输安全）规则：在Info.plist文件中添加如下配置，确保允许AppCenter域名的TLS请求：

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <false/>
    <key>NSExceptionDomains</key>
    <dict>
        <key>in.appcenter.ms</key>
        <dict>
            <key>NSIncludesSubdomains</key>
            <true/>
            <key>NSTemporaryExceptionMinimumTLSVersion</key>
            <string>TLSv1.2</string>
        </dict>
    </dict>
</dict>

• 确认iOS项目的链接器配置：不要将AppCenter相关的程序集设置为链接时剔除，可在iOS项目属性 -> iOS生成 -> 链接器选项中，添加忽略链接的程序集：Microsoft.AppCenter, Microsoft.AppCenter.Analytics, Microsoft.AppCenter.Crashes

模拟器崩溃数据不上报修复 #

AppCenter的崩溃上报逻辑要求崩溃发生后，应用必须重启一次才会将上一次的崩溃日志上报到服务端，模拟器测试时崩溃后不要直接停止调试，要手动重新启动应用，即可触发上报。

内容的提问来源于stack exchange，提问作者Chris Kooken