动态XCFramework无需依赖可运行，静态版却报未定义符号？

背景 #

作为iOS链接/框架领域的新手，我拥有静态的DependencySDK.xcframework和依赖它的MySDK.xcframework，遇到以下两种场景的差异：

• 场景1（MySDK为动态库）：将MySDK设置为Mach-O Type = Dynamic Library并打包成XCFramework，仅添加到App中即可成功构建运行。
• 场景2（MySDK为静态库）：将MySDK设置为Mach-O Type = Static Library并打包成XCFramework，仅添加到App中时会抛出Undefined symbols错误，涉及DependencySDK的符号。

原本预期静态库会包含依赖项、动态库需单独添加依赖，但实际结果相反，因此有以下疑问：

1. 为何动态版无需添加DependencySDK即可运行？ #

动态库（Dynamic Library）在构建阶段会完成完整的链接操作：当MySDK被构建为动态库时，链接器会将依赖的静态库DependencySDK的代码直接合并嵌入到MySDK的动态二进制文件中。

动态库需要成为一个可独立加载的二进制单元，因此构建时会把所有非系统的静态依赖代码打包进去，最终生成的MySDK.xcframework已经包含了DependencySDK的全部实现，App仅需引入MySDK就能获取所有必要符号，无需额外添加依赖。

2. Xcode 是否会将 DependencySDK 嵌入动态框架中？ #

是的。因为DependencySDK是静态库，Xcode在构建动态版MySDK时，链接器会把DependencySDK的目标文件（.o）合并到MySDK的动态二进制内。最终的MySDK.xcframework已经内嵌了DependencySDK的所有代码，相当于把静态依赖“打包”进了动态框架中。

3. 为何静态版会出现未定义符号错误？ #

静态库（Static Library）本质是一组目标文件（.o）的归档文件（.a），它本身不会执行链接操作，也不会自动合并依赖的静态库。

当静态版MySDK被添加到App时，App的链接器需要解析所有用到的符号，但MySDK中仅包含对DependencySDK符号的引用，没有实际的代码实现；而你未将DependencySDK添加到App中，链接器找不到这些符号的定义，因此抛出Undefined symbols错误。

简单来说：静态库只会传递依赖，不会打包依赖代码，所有静态依赖需要由最终的宿主（App）统一链接。

4. 若仅想分发一个XCFramework，推荐方案是什么？ #

有两种主流方案可选：

• 方案一：构建动态XCFramework（推荐）
  如场景1所示，动态框架会自动内嵌静态依赖的代码，分发时仅需提供MySDK.xcframework即可，集成方无需处理额外依赖，操作简单。同时动态框架的更新更灵活，后续迭代时只需替换MySDK即可。
• 方案二：合并静态库为单一XCFramework
  若必须使用静态库，可通过工具将MySDK和DependencySDK的静态库合并为一个归档文件，再打包成XCFramework：
  1. 分别提取两个静态XCFramework中对应架构的.a文件
  2. 使用命令libtool -static -o merged.a MySDK.a DependencySDK.a合并静态库
  3. 基于合并后的.a文件重新打包成XCFramework

内容的提问来源于stack exchange，提问作者Özgür Utku