如何创建包含所有依赖框架的iOS闭源XCFramework SDK？

当然可行！我之前帮团队处理过一模一样的嵌套XCFramework打包需求，踩过不少坑，下面给你一步步拆解解决方案，帮你搞定那些「no such module」和Objective-C编译报错问题。

一、先明确正确的嵌套结构 #

你现在把FeatureA/B/C放在MySDK.xcframework的frameworks文件夹里的思路是对的，但核心问题是MySDK本身的模块配置没有正确关联这些嵌套框架，导致Xcode编译时找不到它们。

二、打包MySDK时的关键配置步骤 #

1. 确保依赖框架的嵌入方式正确 #

在MySDK的Xcode项目中：

• 进入Build Phases -> Embed Frameworks，把FeatureA/B/C.xcframework都加进来，并且设置它们的Embed选项为Embed & Sign（绝对不能选Do Not Embed，否则打包后不会被包含进MySDK.xcframework）。
• 同时检查Link Binary With Libraries里也包含了这些框架，确保编译时能链接上。

2. 修正MySDK的Module Map配置 #

如果你的MySDK是手动管理模块（不是用Swift Package Manager自动生成），需要修改module.modulemap文件，明确声明对嵌套框架的依赖：

module MySDK {
    header "MySDK.h" // 你的SDK主头文件
    export *
    // 声明依赖的嵌套模块，模块名必须和Feature框架的module名完全一致
    depends_on FeatureA;
    depends_on FeatureB;
    depends_on FeatureC;
}

如果是纯Swift的SDK，Xcode会自动生成modulemap，但你需要确保在Build Settings里开启Defines Module为YES，Enable Modules (C and Objective-C)也设为YES。

3. 配置正确的框架搜索路径 #

在MySDK的Build Settings中：

• 找到Framework Search Paths，添加嵌套框架所在的路径（比如你存放FeatureA/B/C的目录），并且勾选recursive（递归搜索），确保Xcode能找到嵌套的框架文件。
• 路径可以用相对路径，比如$(PROJECT_DIR)/ThirdPartyFrameworks，根据你实际的文件结构调整。

三、解决编译报错的针对性方案 #

1. 「no such module "FeatureA"」错误 #

• 检查MySDK.xcframework的内部结构：右键点击MySDK.xcframework → 「Show Package Contents」，查看每个平台目录（比如ios-arm64）下的MySDK.framework/Frameworks里是否真的存在FeatureA.xcframework，如果没有，说明打包时没嵌入成功，回到第一步检查Embed Frameworks的配置。
• 确认FeatureA的模块名和你import的完全一致：比如FeatureA.xcframework里的module.modulemap里的模块名必须是FeatureA，不能有拼写错误。

2. 「Could not build "FeatureA" to Objc」错误 #

• 如果你的测试项目是Objective-C，而FeatureA是纯Swift框架，需要确保FeatureA的Build Settings里Install Objective-C Compatibility Header设为YES，并且生成了对应的FeatureA-Swift.h头文件。
• 同时，MySDK的Build Settings里Objective-C Generated Interface Header Name要正确设置，并且在MySDK的主头文件中导入这个兼容头（如果需要暴露给Objective-C使用者的话）。
• 确保所有框架的Swift版本一致，避免因版本不兼容导致的编译问题。

四、打包XCFramework的正确命令 #

如果用xcodebuild命令手动打包，要确保包含所有需要的架构，并且打包的MySDK.framework已经包含了嵌套框架：

# 先分别编译真机和模拟器版本
xcodebuild -scheme MySDK -configuration Release -sdk iphoneos clean build
xcodebuild -scheme MySDK -configuration Release -sdk iphonesimulator clean build

# 生成XCFramework
xcodebuild -create-xcframework \
    -framework ./build/Release-iphoneos/MySDK.framework \
    -framework ./build/Release-iphonesimulator/MySDK.framework \
    -output MySDK.xcframework

打包完成后，再次检查MySDK.xcframework内部的Frameworks文件夹是否包含所有Feature框架。

五、测试验证 #

创建一个全新的测试项目，只做以下操作：

1. 把MySDK.xcframework拖进项目，设置Embed & Sign。
2. 在代码中import MySDK，然后尝试调用FeatureA里的类或方法。
3. 分别编译真机和模拟器版本，确认没有报错。

这样就能实现使用者只导入MySDK.xcframework就能直接使用所有Feature功能的效果了！

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