如何实现iOS SDK按需动态加载xcframework依赖而非启动时加载？

我们公司以xcframework形式分发闭源iOS SDK，其中部分功能依赖体积较大的外部xcframework。之前靠编译宏EXTERNAL_DEPENDENCY控制是否包含这些依赖相关功能，客户要用到该功能就得开启宏重新编译SDK。Xcode里这些依赖设置为“Do Not Embed”，按需单独分发给客户。

现在想移除这个编译宏，直接编译包含相关功能的SDK，同时要满足三个要求：

• 客户未调用thisMethodUsesTheExternalDependencies方法时，无论有没有引入外部依赖，App都能正常运行；
• 客户调用该方法且已引入外部依赖时，App正常工作；
• 客户调用该方法但未引入外部依赖时，App在调用方法时崩溃，而不是启动时就崩溃。

但移除宏后，没引入依赖的客户App启动就崩溃，报错如下：

dyld[48209]: Library not loaded: @rpath/ExternalDependency.framework/ExternalDependency
Referenced from: <9F14FB92-BA4C-31E7-A4C9-7C04941377AA> /private/var/containers/Bundle/Application/D81D65F6-81C5-4696-B1BD-854B39473EB2/ClientApp.app/Frameworks/MyProprietarySDK.framework/MyProprietarySDK

因为外部依赖是动态链接的，理论上应该可以在首次调用方法时再链接，而不是启动时就链接。想问有没有对应的Xcode构建设置可以实现？

核心是把外部依赖从必需链接改为可选链接，让dyld延迟加载依赖框架，具体操作和补充说明如下：

1. 修改Xcode构建设置 #

在SDK的Xcode项目中，找到目标的Build Settings，可以通过两种方式设置：

• 搜索Other Linker Flags，添加-weak-lExternalDependency（注意把ExternalDependency替换为实际外部框架的名称）；
• 或者找到Linked Frameworks and Libraries，选中对应的外部xcframework，将其Status从Required改为Optional。

设置后，dyld会把该框架标记为可选依赖，App启动时不会强制加载它，只有当代码真正用到该框架的符号时才会尝试链接。

2. 代码层面优化（可选但建议） #

为了让崩溃时机更精准、报错信息更友好，可以在thisMethodUsesTheExternalDependencies方法开头主动触发依赖加载：

// Objective-C示例
#import <ExternalDependency/ExternalDependency.h>

- (void)thisMethodUsesTheExternalDependencies {
    // 主动验证依赖是否存在，确保崩溃点落在方法调用时
    Class dependencyClass = NSClassFromString(@"ExternalDependencyClass");
    if (!dependencyClass) {
        NSAssert(NO, "请先引入ExternalDependency框架以使用该功能");
    }
    
    // 原方法业务逻辑...
}

// Swift示例
func thisMethodUsesTheExternalDependencies() {
    guard let _ = NSClassFromString("ExternalDependencyClass") else {
        fatalError("请先引入ExternalDependency框架以使用该功能")
    }
    
    // 原方法业务逻辑...
}

3. 效果验证 #

• 未引入外部依赖且未调用方法：App正常启动运行；
• 引入外部依赖并调用方法：功能正常工作；
• 未引入外部依赖但调用方法：在方法开头（或首次使用依赖符号时）崩溃，完全符合需求。

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