自定义CocoaPods主框架无法条件导入已安装子框架问题咨询

你遇到的问题本质是CocoaPods的隔离机制导致的——哪怕用户同时装了Main和Child，Main的编译环境默认不会自动包含Child的头文件路径，所以canImport检测不到。下面是具体的解决步骤：

1. 修改Main的Podspec配置 #

在Main的.podspec里加上weak_frameworks字段，把Child框架加进去：

Pod::Spec.new do |s|
  # 其他原有配置不变
  s.weak_frameworks = 'Child'
end

这个字段的作用是告诉CocoaPods：如果用户安装了Child，就把它的头文件路径加入Main的编译环境；没装的话也不会触发编译错误。

2. 核对代码里的框架名称 #

canImport的参数必须和Child框架的正式名称完全匹配，大小写也不能错。比如你的框架是Child.framework，代码里就得这么写：

#if canImport(Child)
import Child
// 这里写依赖Child的逻辑
#endif

要是框架实际叫ChildSDK，就不能写成Child，必须严格对应。

3. 确认用户的Podfile配置 #

用户需要在自己的Podfile里同时声明两个框架：

pod 'Main'
pod 'Child'

然后执行pod install，确保两个框架都正确集成到项目里。

4. 清理缓存重新编译 #

缓存经常会导致这类检测失效，按下面的步骤操作：

• 删除项目的DerivedData文件夹
• 执行pod deintegrate && pod install
• 重启Xcode后重新编译

额外提醒 #

• 如果Child是静态库，weak_frameworks可能不生效，这时候可以在Main的Podspec里用spec.dependency 'Child', '~> 你的版本号'，同时标记这个依赖为可选：spec.optional_dependency = true
• 绝对不能在canImport条件块外直接导入Child，否则用户没装Child时会直接编译报错。

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