MySDK集成报错：‘...不是类的成员类型’问题求助

问题场景 #

• 同项目内测试MySDK运行正常，但通过CocoaPods集成到外部测试App时，出现报错：Failed to build module 'MySDK' for importation due to the errors above; the textual interface may be broken by project issues or a compiler bug，深层错误为... is not a member type of class ...
• 移除带观察者参数的初始化方法后，SDK可正常集成使用

一、解决观察者协议对外不可见问题 #

问题根源 #

Swift SDK通过CocoaPods分发时，必须确保所有公开类型（协议、类、方法等）被正确导出到模块的公共接口中。你的MyResultObserver协议虽标记为public，但存在以下问题：

• 协议的NSCopying扩展未标记public，导致模块接口生成时无法被外部识别
• CocoaPods配置可能未正确包含协议所在的源文件，或模块的swiftinterface生成异常

修复步骤 #

1. 修正协议扩展的访问权限
   将MyResultObserver的NSCopying扩展标记为public，确保外部模块可访问：

   import Foundation
   
   public extension MyResultObserver: NSCopying {
       public func copy(with zone: NSZone? = nil) -> Any {
           return self
       }
   }
   

2. 检查CocoaPods Podspec配置
   确保Podspec的sources包含所有公开类型的源文件，示例：

   s.source_files = "MySDK/**/*.{swift}"
   

   同时显式指定Swift版本，避免版本兼容问题：

   s.swift_version = "5.7"
   

3. 清理重建环境

   • 删除外部测试App的Pods目录和DerivedData文件夹
   • 重新执行pod install，然后Clean Build Folder后再编译项目

二、解决更新后的内部类型访问错误 #

问题根源 #

你将PaymenResultObserver（注意拼写错误：Payment少了字母t）和callback定义为模块级公开类型，但在MySDK类中错误地使用MySDK.PaymenResultObserver、MySDK.callback访问，编译器会误认为这些是MySDK类的内部嵌套类型，而非模块级全局类型，从而抛出错误。

修复步骤 #

1. 修正类型访问方式
   去掉类定义和初始化方法中的MySDK.前缀，直接使用模块级类型：

   // 错误写法
   // open class MySDK : MySDK.PaymenResultObserver {
   //  public init(eventObserver: @escaping MySDK.callback)
   
   // 正确写法
   open class MySDK : PaymenResultObserver {
       public init(eventObserver: @escaping callback) {
           // 初始化逻辑
       }
   
       // 必须实现协议要求的方法
       public func success(successMessage: String) {
           // 你的实现代码
       }
   
       public func error(errorMessage: String) {
           // 你的实现代码
       }
   }
   

2. 修正协议拼写错误
   将PaymenResultObserver改为正确拼写PaymentResultObserver，统一命名避免后续混淆。

3. 嵌套类型优化（可选）
   如果希望把观察者协议和回调类型作为MySDK的内部嵌套类型，可在类内部定义：

   open class MySDK {
       // 嵌套观察者协议
       public protocol PaymentResultObserver : AnyObject {
           func success(successMessage: String)
           func error(errorMessage: String)
       }
   
       // 嵌套回调类型别名
       public typealias Callback = (String) -> Void
   
       // 带观察者的初始化方法
       public init(eventObserver: PaymentResultObserver) {
           EventObserver.shared.attach(eventObserver)
       }
   
       // 带回调的初始化方法
       public init(eventObserver: @escaping Callback) {
           // 回调逻辑实现
       }
   }
   

   此时外部使用时需通过MySDK.PaymentResultObserver、MySDK.Callback访问，符合模块化设计。

验证步骤 #

修改完成后：

1. 重新打包SDK，更新Podspec的版本号
2. 在外部测试App中执行pod update
3. 导入MySDK并按原有方式使用观察者模式，确认编译运行正常

内容的提问来源于stack exchange，提问作者Lukáš Šálek