Sherpa-onnx iOS框架最低系统版本兼容性问题解决方案

在Flutter开发过程中，当使用sherpa-onnx框架构建iOS应用并尝试上传至App Store时，开发者可能会遇到一个常见错误："Invalid Bundle. The bundle Runner.app/Frameworks/sherpa_onnx.framework does not support the minimum OS Version specified in the Info.plist"。这个问题通常是由于框架的最低支持系统版本与应用配置不匹配导致的。

问题分析

该错误表明sherpa-onnx框架的兼容性设置与应用的Info.plist文件中指定的最低iOS版本要求存在冲突。具体来说，框架可能没有明确声明其支持的最低iOS版本，或者声明的版本高于应用配置的版本。

解决方案

要解决这个问题，开发者需要进行以下两处关键修改：

1. 修改Info.plist文件： 在应用的Info.plist文件中添加以下配置项：

   <key>SupportedArchitectures</key>
   <array>
       <string>arm64</string>
   </array>
   <key>SupportedPlatform</key>
   <string>ios</string>
   <key>MinimumOSVersion</key>
   <string>13.0</string>
   

2. 修改sherpa_onnx_ios.podspec文件： 在框架的podspec配置文件中明确指定平台要求：

   s.platform = :ios, "13.0"
   

技术背景

iOS应用的框架兼容性检查是App Store审核流程的重要部分。苹果要求所有嵌入的框架必须明确声明其支持的最低系统版本，并且这个版本不能高于应用本身声明的最低支持版本。如果框架没有正确配置这些信息，就会导致上传失败。

arm64架构的指定是为了确保框架在苹果设备上的兼容性，因为这是现代iOS设备使用的标准架构。iOS 13.0作为最低版本要求是一个相对平衡的选择，既能覆盖大多数用户设备，又能利用较新的系统功能。

最佳实践

1. 在开发过程中尽早测试框架的兼容性配置
2. 保持框架版本与应用配置同步更新
3. 定期检查框架的发布说明，了解兼容性要求的变化
4. 在团队协作环境中，确保所有开发者使用相同的配置

后续维护

sherpa-onnx项目团队已经在新版本(v1.10.32)中修复了这个问题。开发者可以更新到最新版本以避免手动修改配置。对于必须使用特定版本的情况，上述手动修改方案仍然有效。

通过正确配置这些参数，开发者可以确保应用顺利通过App Store的审核流程，同时为用户提供最佳的兼容性体验。