Swift调用Objective-C类返回的Swift类出现类型不匹配问题求助

问题背景 #

我维护的CocoaPods库包含遗留Objective-C服务，已部分重构为Swift，Swift类会被Objective-C服务使用并返回。该库同时支持Objective-C和Swift项目，但在Swift项目中调用Objective-C服务时，返回的类类型被识别为带__ObjC.前缀的类型，无法正常访问属性或进行类型声明。

代码示例 #

CocoaPods库代码 #

Swift类

@objc public class PlayableItem: NSObject{
    @objc public var id: Int {
        get {
            return 0;
        }
    }
    @objc public var title: String {
        get {
            return "";
        }
    }
}

@objc public class ApiTrack : PlayableItem {
    private var _id: Int
    @objc override public var id: Int {
        get {
            return self._id
        }
        set{
            self._id = newValue
        }
    }
    private var _title: String
    @objc override public var title: String {
        get {
            return self._title
        }
        set{
            self._title = newValue
        }
    }
}

@objc public class ApiMessage: ApiTrack {
    // 额外属性等
}

@objc public class ApiSong: ApiTrack {
    // 额外属性等
}

Objective-C遗留服务

TestProxy.h

#import <Foundation/Foundation.h>
#import <TunifyApi/TunifyApi-Swift.h>

@interface TestProxy : NSObject

+ (TestProxy *) sharedProxy;

@property (nonatomic, readonly) PlayableItem *firstPlayableItem;

@end

TestProxy.m

#import "TestProxy.h"

static TestProxy *shared = nil;

@implementation TestProxy

+ (TestProxy *) sharedProxy{
    @synchronized(shared){
        if (!shared || shared == nil){
            shared = [[TestProxy alloc] init];
        }
    }
    return shared;
}

- (PlayableItem *) firstPlayableItem{
    // 返回ApiMessage或ApiSong类型的PlayableItem实例
}

@end

通用头文件 TunifyApi.h

#import "TestProxy.h"

项目代码 #

桥接头文件

#import "TunifyApi/TunifyApi.h"

Swift调用代码

private func testFirstTrack(){
    // 可以编译，但无法访问属性
    var firstPlayableItem1 = TestProxy.shared().firstPlayableItem

    // 编译报错
    var firstPlayableItem2 : PlayableItem? = TestProxy.shared().firstPlayableItem
}

错误信息 #

Cannot convert value of type '__ObjC.PlayableItem?' to specified type 'TunifyApi.PlayableItem?'

解决方案 #

1. 调整项目桥接导入方式 #

将项目桥接头文件中的导入语句改为模块导入：

@import TunifyApi;

替代原来的#import "TunifyApi/TunifyApi.h"，确保Swift和Objective-C代码共享同一个模块命名空间，避免类型前缀冲突。

2. 检查CocoaPods库的Podspec配置 #

确保库的podspec中正确设置模块相关配置：

Pod::Spec.new do |s|
  s.name         = "TunifyApi"
  s.module_name  = "TunifyApi" # 确保模块名与库名一致
  s.swift_version = "5.0" # 根据实际Swift版本调整
  s.public_header_files = "TunifyApi/*.h" # 包含所有需要暴露的头文件
  s.source_files = "TunifyApi/**/*.{h,m,swift}"
  # 其他配置...
end

3. 显式类型转换（临时 workaround） #

如果上述配置调整暂时无法生效，可以在Swift代码中显式转换类型：

private func testFirstTrack(){
    let objcItem = TestProxy.shared().firstPlayableItem
    let swiftItem = objcItem as? TunifyApi.PlayableItem
    // 现在可以正常访问swiftItem的属性
    print(swiftItem?.id)
}

4. 确保Swift类的暴露正确性 #

确认所有需要被Objective-C访问的Swift类、属性都添加了@objc和public修饰符，且继承自NSObject，保证类型能被Objective-C正确识别并映射。

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