WebF项目iOS应用上传App Store时的二进制结构问题解析

问题背景

在使用WebF框架(版本0.14.3)开发Flutter应用(Flutter 3.7.12)并尝试上传至App Store时，开发者遇到了ITMS-90171错误。这个错误表明应用的二进制结构不符合苹果的要求，具体表现为包含了不被允许的独立可执行文件或库文件。

错误详情

苹果的App Store审核系统返回的错误信息明确指出："Invalid Bundle Structure - The binary file '' is not permitted. Your app can't contain standalone executables or libraries, other than a valid CFBundleExecutable of supported bundles." 这表示应用的包结构中包含了不符合规范的独立二进制文件。

问题根源分析

经过技术分析，发现这个问题主要由两个框架文件引起：

1. quickjs.framework中的quickjs二进制文件
2. webf_bridge.framework中的webf_bridge二进制文件

这些文件被苹果视为"standalone executables or libraries"(独立的可执行文件或库)，而根据苹果的Bundle编程规范，iOS应用包中只能包含特定类型的可执行文件，主要是主应用的CFBundleExecutable和受支持的其他Bundle中的可执行文件。

解决方案

针对这个问题，开发者需要手动移除以下两个文件：

1. quickjs.framework/quickjs
2. webf_bridge.framework/webf_bridge

这种手动移除操作可以确保应用的二进制结构符合苹果的规范要求，从而避免上传时被拒绝。

技术背景延伸

iOS应用的Bundle结构有严格的规定，主要基于安全考虑。苹果要求所有可执行代码必须包含在特定的Bundle结构中，并且有明确的签名机制。独立存在的二进制文件可能绕过苹果的安全检查机制，因此被严格禁止。

WebF框架作为桥接Web技术和原生应用的解决方案，在某些构建配置下可能会生成这些额外的二进制文件。开发者在使用这类框架时需要特别注意最终的产物是否符合苹果的审核要求。

预防措施

为了避免类似问题，建议开发者在以下阶段进行检查：

1. 构建完成后检查.app包内容
2. 使用命令行工具检查包结构
3. 在本地验证阶段使用Application Loader进行预检查
4. 定期更新WebF框架版本，关注框架的发布说明中关于iOS构建的改进

通过以上措施，可以有效减少因二进制结构问题导致的应用上传失败情况。