主应用构建失败：找不到自定义框架storage依赖的RealmSwift模块

问题背景 #

主应用authenticator-ios依赖自定义共享框架storage，该框架基于RealmSwift实现CRUD操作，同时被主应用和内嵌扩展调用。单独构建storage框架正常，但构建主应用时出现No such module 'RealmSwift'错误，报错行来自storage内部继承RealmSwift.Object的类，且主应用并未直接引用这些类。

解决方案 #

1. 修正Podfile依赖配置

确保storage框架的target正确引入RealmSwift，同时通过依赖传递让主应用能识别到该模块。示例Podfile结构：

workspace 'authenticator-ios.xcworkspace'
platform :ios, '15.0'

target 'authenticator-ios' do
  use_frameworks!
  
  # 主应用自身依赖
  pod 'YourMainAppDependency'

  # 嵌套storage框架target，继承搜索路径
  target 'storage' do
    inherit! :search_paths
    pod 'RealmSwift'
  end
end

# 内嵌扩展的target配置
target 'YourExtensionTarget' do
  use_frameworks!
  pod 'RealmSwift'
  # 依赖storage框架
end

核心是给storage target添加inherit! :search_paths，保证主应用能间接获取到RealmSwift的依赖搜索路径，避免重复引入导致的冲突。

2. 检查storage框架的Build Settings

• 打开storage target的构建设置，确认Framework Search Paths和Header Search Paths包含$(inherited)，确保Pod自动配置的RealmSwift路径生效。
• 确认Build Options下的Enable Modules (C and Objective-C)设置为Yes，保证模块能被正确识别。

3. 调整主应用对storage框架的嵌入方式

• 进入主应用target的「Frameworks, Libraries, and Embedded Content」：
  • 若storage是动态框架，设置Embed选项为Embed & Sign；
  • 若storage是静态框架，设置为Do Not Embed，同时需确保主应用Podfile中也引入RealmSwift（或在storage构建设置中将RealmSwift打包进静态库）。

4. 清理缓存重新构建

• 执行命令清理Pod配置：

  pod deintegrate && pod install
  

• 清理Xcode构建缓存：选择Product > Clean Build Folder，重启Xcode后重新构建主应用。

5. 控制storage框架的接口访问级别

检查storage内部继承RealmSwift.Object的类，确保其访问级别为默认的internal（不要标记为public）。只有对外暴露的接口才设置为public，且这些接口不能直接依赖RealmSwift类型，避免主应用编译时需要解析RealmSwift模块。

内容的提问来源于stack exchange，提问作者Bawenang Rukmoko Pardian Putra