构建、包体与兼容性

本文整理了 SDK 构建和兼容性相关的常见问题。

App Store 提交：裁剪模拟器架构

SDK 的 .framework 可能包含模拟器架构（x86_64），在提交 App Store 前需要裁剪。SDK 包中提供了脚本 prepare-framework-to-publish-to-appstore.sh，可自动完成该操作：

bash libs/prepare-framework-to-publish-to-appstore.sh

提示

如果使用 .xcframework，则无需进行架构裁剪，.xcframework 已分离了不同平台的架构切片。

Bitcode 支持

自 Xcode 14 起，Apple 已移除 Bitcode 支持。如使用较旧的 Xcode 版本且遇到 Bitcode 相关链接错误，请在 Build Settings 中将 Enable Bitcode 设置为 No。

Mac Catalyst 支持

若要将 iPad 应用构建为 Mac 应用（Mac Catalyst），请：

1. 使用 .xcframework 版本的库文件。
2. 在 Target → General → Deployment Info 中勾选 Mac (Designed for iPad)。
3. 要求 macOS 10.15+、Xcode 11+。

最小部署目标

SDK 版本	最低 iOS 版本
9.x	iOS 11.0
7.5.1+	iOS 11.0（仅 64-bit）

包体大小优化

• 如不需要 UI Extensions 的全部功能，可通过 UIExtensionsConfig 按需加载模块。
• 如不需要扫描功能，不要链接 FoxitPDFScanUI.framework。
• 使用 .xcframework + App Thinning 可以有效减小最终安装包大小。