在xcframework中嵌入SPM包后模块无法识别及链接异常求助

问题根源 #

你遇到的情况本质是：默认打包流程下，Xcode不会把SPM依赖的代码嵌入到主Framework中——生成的xcframework只包含你的项目代码，不包含依赖，所以导入后找不到对应模块；而手动重复导入SPM依赖时，主xcframework和项目各自持有同一依赖的实现，就会触发符号重复冲突。

分步解决 #

1. 把SPM依赖改成静态链接 #

打开你的Proj项目的Xcode界面：

• 进入Package Dependencies列表，选中每个SPM依赖，将Linking选项改为Static Library
• 确认主项目的Build Settings里，BUILD_LIBRARY_FOR_DISTRIBUTION保持YES，Mach-O Type根据需求设置（动态库选Dynamic Library，静态库选Static Library）

2. 修改打包命令强制嵌入依赖 #

更新你的xcodebuild命令，添加参数确保SPM依赖被合并到主Framework中：

# 打包真机版本
xcodebuild -project Proj.xcodeproj archive -scheme Proj -sdk iphoneos -configuration Release clean build -derivedDataPath archives/device BUILD_LIBRARY_FOR_DISTRIBUTION=YES SKIP_INSTALL=NO ONLY_ACTIVE_ARCH=NO OTHER_LDFLAGS="-ObjC -all_load"

# 打包模拟器版本
xcodebuild -project Proj.xcodeproj archive -scheme Proj -sdk iphonesimulator -configuration Release clean build -derivedDataPath archives/simulator BUILD_LIBRARY_FOR_DISTRIBUTION=YES SKIP_INSTALL=NO ONLY_ACTIVE_ARCH=NO OTHER_LDFLAGS="-ObjC -all_load"

# 生成通用xcframework
xcodebuild -create-xcframework -framework archives/device/Build/Products/Release-iphoneos/Proj.framework -framework archives/simulator/Build/Products/Release-iphonesimulator/Proj.framework -output universal/Proj.xcframework

注：如果主项目是静态库（Mach-O Type为Static Library），可以省略OTHER_LDFLAGS参数，静态库会自动合并所有静态依赖。

3. 验证产物是否正确 #

生成xcframework后，你可以做两个验证：

• 用lipo -info universal/Proj.xcframework/ios-arm64/Proj.framework/Proj检查架构是否完整
• 用nm -U universal/Proj.xcframework/ios-arm64/Proj.framework/Proj | grep "axyz"，如果能找到对应的类符号，说明依赖已经被成功嵌入

关键注意点 #

• 绝对不要把SPM依赖设置为Dynamic Library，否则无法嵌入到主xcframework中，仍会出现模块找不到的问题
• 确保打包前执行clean，避免缓存导致的依赖未嵌入问题

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