添加Amazon Fling SDK .xcframework至Swift项目后无法导入的问题

云原生阿岚

2026-6-17

解决Amazon Fling SDK .xcframework导入失败的排查步骤

检查框架的Embed设置
进入项目Target的Build Phases，查看Embed Frameworks阶段，确认该.xcframework是否已添加。如果没有，点击+按钮添加，并将其Embed选项设置为Embed & Sign（针对iOS应用）。
验证架构兼容性
确保下载的.xcframework包含当前Xcode构建目标的架构（如arm64真机、x86_64模拟器）。可通过终端执行以下命令查看框架支持的架构：
```
xcrun lipo -info path/to/AmazonFling.xcframework/ios-arm64/AmazonFling.framework/AmazonFling
```
若缺少目标架构，需下载对应版本的SDK，或调整项目Build Settings里的Excluded Architectures排除不支持的架构。
配置Framework搜索路径
进入项目Target的Build Settings，搜索Framework Search Paths，确认框架所在目录已被添加。建议设置为相对路径（如$(PROJECT_DIR)/Frameworks），并勾选recursive选项。
清理缓存并重新构建
执行Cmd+Shift+K清理项目，再用Cmd+B重新构建。缓存残留可能导致模块识别失败，清理后重新构建往往能解决问题。
确认模块名称准确性
导入时的模块名称不一定与框架文件名完全一致，检查框架内部的module.modulemap或Info.plist里的CFBundleName，确保导入语句的模块名称与之一致。例如模块名为AmazonFling时，导入语句应为：
```
import AmazonFling
```
核对Deployment Target版本
确认项目的Deployment Target不低于该.xcframework要求的最低系统版本。可查看框架Info.plist里的MinimumOSVersion，再调整项目Target的Deployment Info版本号。