如何在CocoaPods环境下实现Pod间弱链接以支持可选功能依赖

问题1：偶发MainSDK/MainSDK-Swift.h file not found错误 #

这个错误的核心原因是MainSDK-Swift.h是Swift代码编译过程中动态生成的头文件，编译ObjC头文件时该文件可能还未生成，且头文件搜索路径未同步更新。
解决步骤：

• 移除AdditionalSDKInterop.h中对#import <MainSDK/MainSDK-Swift.h>的引用，替换为协议前向声明：

// AdditionalSDKInterop.h
#import <Foundation/Foundation.h>
@protocol MainSDKInteropDelegate; // 前向声明替代导入

@interface AdditionalSDKInterop : NSObject
@property (weak, nonatomic) id<MainSDKInteropDelegate> delegate;
+ (BOOL)isModuleAvailable;
@end

• 将MainSDK-Swift.h的导入移到AdditionalSDKInterop.m文件头部，实现文件在编译时Swift代码已经完成编译，头文件已经生成，不会再出现找不到的问题。

问题2：不引入AdditionalSDK时提示Module AdditionalSDK not found #

这个错误是因为你在代码中硬编码了@import AdditionalSDK，属于编译期依赖，只要编译环境中没有对应的模块就会直接报错，和运行时是否存在无关。
解决步骤：

第一步：配置MainSDK的可选依赖 #

在MainSDK.podspec中添加AdditionalSDK为可选依赖，不要设置为强制依赖：

s.dependency 'AdditionalSDK', :optional => true
s.weak_framework = 'AdditionalSDK'

第二步：移除编译期硬依赖，改用运行时判断 #

修改AdditionalSDKInterop.m代码，删除@import AdditionalSDK语句，完全通过运行时API判断模块是否存在，不需要编译期导入模块：

// AdditionalSDKInterop.m
#import "AdditionalSDKInterop.h"
#import <MainSDK/MainSDK-Swift.h> // 放到实现文件导入

@implementation AdditionalSDKInterop
+ (BOOL)isModuleAvailable {
    // 运行时判断类是否存在，不需要编译期导入
    return NSClassFromString(@"AdditionalSDK") != nil;
}
@end

第三步：可选功能调用适配 #

所有对AdditionalSDK的方法调用都需要用运行时API实现，不要直接调用类/实例方法，避免编译期依赖：

• 调用类方法可以用performSelector或者NSInvocation
• Swift侧调用可以用NSClassFromString获取类之后，转成对应协议实现调用
  如果要在Swift代码中直接调用，可以将isModuleAvailable暴露给Swift，判断返回值为YES之后再通过运行时调用对应接口即可。

额外说明：canImport(AdditionalSDK)失效的原因 #

canImport是编译期判断语句，只会在编译MainSDK本身的时候判断是否存在对应模块。你发布MainSDKPod的时候编译环境里没有引入AdditionalSDK，所以canImport的分支永远不会被编译进二进制，发布后就算宿主项目引入了AdditionalSDK也不会生效，这个特性只适合源码直接集成的场景，不适合Pod发布的场景。

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