如何为iOS应用打包Python C扩展库以提交至App Store？

问题背景 #

使用Kivy+Python开发iOS应用，集成了带C扩展的pymongo和bson库，编译后生成bson/_cbson.cpython-310-darwin.so和pymongo/_cmessage.cpython-310-darwin.so动态库。提交App Store时收到如下错误：

Asset validation failed
Invalid bundle structure. The binary file is not permitted. Your app cannot contain standalone executables or libraries, other than a valid CFBundleExecutable of supported bundles.

这是因为App Store禁止包内包含独立动态库，以下是可行的解决方案，按优先级排序：

1. 静态链接C扩展（最优方案） #

将pymongo和bson的C扩展编译为静态库，再链接到主应用的可执行文件中，避免生成独立的.so文件，完全符合App Store的包结构要求。

具体操作：

• 下载pymongo和bson的源码，修改编译配置，将C扩展部分编译为静态库（.a格式）。
• 若使用kivy-ios工具链，需修改对应库的构建脚本（recipes），调整编译参数，将动态链接替换为静态链接。
• 打包时将静态库与Python解释器、Kivy框架及应用代码合并为单一可执行文件。

2. 嵌入动态库至Frameworks并配置路径（次优方案） #

若静态链接存在编译难度，可将.so文件放入应用包的Frameworks目录，调整Python模块搜索路径并修正动态库的加载配置：

• 将两个.so文件移动到应用包的Frameworks目录下。
• 应用启动时修改sys.path，添加Frameworks目录路径，确保Python能找到扩展模块。
• 使用install_name_tool修改动态库的安装路径为相对路径，避免运行时加载失败：

  install_name_tool -id "@rpath/_cbson.cpython-310-darwin.so" bson/_cbson.cpython-310-darwin.so
  install_name_tool -id "@rpath/_cmessage.cpython-310-darwin.so" pymongo/_cmessage.cpython-310-darwin.so
  

• 在Xcode项目中，将这些动态库添加到「Embedded Frameworks」，并设置@rpath包含@executable_path/../Frameworks。

3. 替换为纯Python MongoDB客户端（备选方案） #

若前两种方案无法实现，可尝试使用纯Python编写的MongoDB客户端库，比如pymongo的纯Python分支（若存在）或motor纯Python版本。但此方案可能牺牲性能，且功能完整性可能不如带C扩展的版本。

其他可选方案 #

• 使用MongoDB Atlas REST API：直接通过HTTP请求与MongoDB交互，完全无需客户端库，彻底规避C扩展问题。适合对性能要求不极端的场景，还能减小应用包体积。

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