首页
/ Element iOS项目Xcode 15.4打包问题分析与解决方案

Element iOS项目Xcode 15.4打包问题分析与解决方案

2025-07-08 21:52:21作者:冯梦姬Eddie

问题背景

在使用Xcode 15.4为Element iOS项目(版本1.11.6)生成归档文件并准备上传至App Store时,开发者遇到了验证失败的问题。该问题主要与嵌入式框架WysiwygComposerFFI.framework的Info.plist文件配置有关。

错误详情

苹果的验证系统报告了以下关键错误:

  1. 缺少MinimumOSVersion值:框架必须指定8.0或更高的部署目标
  2. Info.plist缺少必需键值:CFBundleShortVersionString和CFBundleVersion
  3. 框架不支持Info.plist中指定的最小OS版本

根本原因

此问题源于Xcode 15.4对嵌入式框架的验证变得更加严格。特别是对于使用Rust或其他非Swift语言编写的框架,自动生成的Info.plist文件可能不包含苹果应用商店所需的所有元数据字段。

解决方案

临时解决方案

对于需要立即发布的情况,开发者可以手动修改生成的归档文件:

  1. 在Xcode Organizer中找到生成的归档文件
  2. 右键点击并选择"显示包内容"
  3. 导航至:Products > Applications > App Bundle > Frameworks
  4. 找到WysiwygComposerFFI.framework并编辑其Info.plist文件
  5. 添加以下必需字段:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>CFBundleExecutable</key>
    <string>WysiwygComposerFFI</string>
    <key>CFBundleIdentifier</key>
    <string>org.matrix.WysiwygComposerFFI</string>
    <key>CFBundleInfoDictionaryVersion</key>
    <string>6.0</string>
    <key>CFBundlePackageType</key>
    <string>FMWK</string>
    <key>CFBundleShortVersionString</key>
    <string>1.0.0</string>
    <key>CFBundleVersion</key>
    <string>1</string>
    <key>MinimumOSVersion</key>
    <string>15.0</string>
</dict>
</plist>

长期解决方案

Element iOS团队已在1.11.27版本中修复了此问题。建议开发者:

  1. 升级到Element iOS 1.11.27或更高版本
  2. 确保使用项目指定的Xcode版本(参考Fastfile中的配置)

注意事项

  1. MinimumOSVersion值应与主应用的部署目标一致
  2. 修改归档文件后,必须通过Xcode Organizer重新上传
  3. 此问题仅影响Xcode 15.4,早期版本如15.2不受影响

结论

Xcode工具链的更新有时会引入新的验证规则,特别是对于嵌入式框架的元数据要求。Element iOS团队已及时响应并修复了此问题。开发者应根据项目需求选择合适的解决方案,确保应用顺利通过App Store验证流程。

登录后查看全文
热门项目推荐
相关项目推荐