Swift 5.8.1中ObjC框架前向声明Swift类跨语言访问报错求助

我正在创建一个混合Objective-C与Swift代码的Objective-C框架UtilitiesFramework，具体代码结构如下：

1. Swift代码中的StringUtilities类：

@objc 
public class StringUtilities: NSObject { }

2. Objective-C类Utilities访问Swift类：

• Utilities.h中对StringUtilities做前向声明，并定义返回该类的方法：

@class StringUtilities; // Forward Declaration

@interface Utilities: NSObject
- (StringUtilities *)stringUtilities;
@end

• Utilities.m中导入生成的Swift头文件实现方法：

#import <UtilitiesFramework/UtilitiesFramework-Swift.h> // 提供StringUtilities的具体实现

@implementation Utilities
- (StringUtilities *)stringUtilities {
   return [StringUtilities new];
}
@end

3. 通过module.modulemap将Utilities.h暴露给Swift：

module PrivateObjC {
header "Utilities.h"
}

4. 已正确设置Build Settings中的导入路径为$(SRCROOT)/$(PRODUCT_NAME)

编译现象 #

仅访问Utilities类时编译正常：

import PrivateObjC

class SomeOperations {
func doSomething() {
  _ = Utilities() // 编译正常
}

但调用其返回StringUtilities的方法时出现编译错误：

import PrivateObjC

class SomeOperations {
func doSomething() {
  _ = Utilities().stringUtilities() // 编译报错
}

错误信息 #

value of type Utilities has no member stringUtilities: _ = Utilities().stringUtilities()
note: method stringUtilities not imported
- (StringUtilities *)stringUtilities
^
note: return type not imported
- (StringUtilities *)stringUtilities
^
note: interface StringUtilities is incomplete
- (StringUtilities *)stringUtilities
^
note: interface StringUtilites forward declared here
@class StringUtilities

已知Swift 5.9的SE-0384提案可解决该场景，但当前使用Swift 5.8.1，求旧版Swift下的解决方法。

解决方法（Swift 5.8.1及更早版本） #

方法1：在PrivateObjC模块中导入Swift生成的头文件

修改module.modulemap，让模块同时包含Utilities.h和Swift生成的头文件，让Swift识别StringUtilities的完整定义：

module PrivateObjC {
    header "Utilities.h"
    header "../UtilitiesFramework/UtilitiesFramework-Swift.h"
    export *
}

注意：路径需根据框架目录结构调整，也可使用<UtilitiesFramework/UtilitiesFramework-Swift.h>的形式导入（框架内部模块适用）。

方法2：在Utilities.h中直接导入Swift头文件

放弃前向声明，直接在Utilities.h中导入Swift生成的头文件，让StringUtilities的完整定义暴露给PrivateObjC模块：

#import <UtilitiesFramework/UtilitiesFramework-Swift.h>

@interface Utilities: NSObject
- (StringUtilities *)stringUtilities;
@end

缺点：会增加Utilities.h与Swift生成头文件的编译耦合度，但能直接解决类型识别问题。

方法3：用id作为返回类型兼容

修改Utilities.h中的方法返回类型为id，Swift调用时再手动做类型转换：

@interface Utilities: NSObject
- (id)stringUtilities;
@end

Swift调用代码：

import PrivateObjC

class SomeOperations {
func doSomething() {
  let util = Utilities().stringUtilities() as! StringUtilities
}

优点：无需修改模块结构；缺点：需要强制类型转换，存在运行时类型不匹配风险。

方法4：单独暴露StringUtilities的声明头文件

如果不想暴露整个Swift生成的头文件，可手动创建声明文件并导入模块：

1. 创建StringUtilities-ObjC.h文件：

#import <Foundation/Foundation.h>

@interface StringUtilities : NSObject
// 声明需要暴露给Objective-C的方法
@end

2. 修改module.modulemap：

module PrivateObjC {
    header "Utilities.h"
    header "StringUtilities-ObjC.h"
    export *
}

3. 将StringUtilities-ObjC.h添加到框架的Public或Private头文件列表中。

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