跨Target的Objective-C Category未被识别的问题及解决咨询

我有一个iOS SwiftUI项目，模块层级如下：

Module hierarchy:

AppTarget -> 依赖 Experience
Experience -> 依赖 Lifecycle
Lifecycle

各模块内容：

• Lifecycle：包含符合App协议的struct（应用入口）、AppDelegate、SceneDelegate等
• Experience：包含URLHandler及其他处理启动参数的支持类（如处理关联文件点击、快捷动作启动等，并更新UI）

在Lifecycle库的App协议struct中，我用SwiftUI的onOpenURL(perform:)方法处理所有基于URL的启动场景（包括组件、文件、深度链接、通用链接等），代码如下：

// Lifecycle 库中
WindowGroup {
    ContentView()
        .onOpenURL(perform: { (url: URL) in
            // 处理启动应用的URL
        })
}

我需要在这个方法里调用Experience库中的URL处理逻辑，但模块层级是Lifecycle被Experience依赖，Lifecycle不能直接引用Experience的代码。

我尝试通过Objective-C Category实现：在Lifecycle中定义基础类，在Experience中用Category扩展方法，预期运行时Category的方法会归属于原类，跨模块也能生效。

Lifecycle库中的基础类实现 #

// 头文件
@interface URLHandler : NSObject
// 无方法定义，由Experience通过Category扩展
@end

// .mm 文件
@implementation URLHandler
// 空实现
@end

Experience库中的Category扩展 #

// 头文件，扩展Lifecycle中的URLHandler类
@interface URLHandler (Experience)
+ (void)handleURL:(NSURL *)url;
@end

// .mm 文件
@implementation URLHandler (Experience)
+ (void)handleURL:(NSURL *)url {
    Log([NSString stringWithFormat:@"(ObjC++) url = %@", [url absoluteString]]);
    // 解析URL后更新UI
}
@end

调用代码 #

在Lifecycle的onOpenURL(perform:)中调用扩展方法：

WindowGroup {
    ContentView()
        .onOpenURL(perform: { (url: URL) in
            URLHandler.handleURL(url)
        })
}

但编译时出现错误：

Type 'URLHandler' has no member 'handleURL'

Category是运行时特性，按道理运行时handleURL:应该属于URLHandler类，如何解决这个编译错误？如果Objective-C的方式行不通，还有其他方案吗？

补充说明：我使用了WWDC2023推出的Swift-C互操作性，通过模块映射向Swift暴露C和Objective-C类型，配置应该没问题——因为错误不是找不到URLHandler类，而是类中缺少handleURL方法。

一、修复Objective-C Category的编译错误 #

问题本质是编译期可见性缺失：虽然Category是运行时特性，但Swift代码编译时需要明确知道handleURL方法的声明，否则会报“无此成员”的错误。

修复步骤 #

1. 暴露Category的头文件给Lifecycle模块

   • 在Experience库的模块映射（modulemap）中，将Category的头文件标记为公共（public）
   • 在Lifecycle库的依赖配置中，显式引入Experience的公共头文件（或通过模块依赖让Lifecycle编译期能读取到Category的方法声明）
   • 注：此操作不会打破原有模块依赖层级——仅让Lifecycle编译期看到方法声明，运行时仍由Experience提供实现，而Experience本身依赖Lifecycle，链接顺序是合法的。

2. 用运行时消息发送绕过编译检查（临时验证用，不推荐）
   如果不想调整模块可见性，可在Swift中用Objective-C运行时的消息发送调用方法，编译期不会检查方法是否存在：

   URLHandler.perform(NSSelectorFromString("handleURL:"), with: url)
   

   此方案可读性差且无类型安全，仅适合临时验证，不建议作为正式方案。

二、更优雅的替代方案（推荐） #

针对Lifecycle <- Experience <- AppTarget的模块层级，推荐用依赖注入或闭包回调解决反向依赖问题，完全基于Swift类型系统实现，更符合SwiftUI设计理念。

方案1：依赖注入（最优） #

在Lifecycle库中定义URL处理协议：

// Lifecycle 库中
public protocol URLHandling {
    func handleURL(_ url: URL)
}

// 修改App入口struct，添加注入的handler参数
public struct LifecycleApp: App {
    private let urlHandler: URLHandling
    
    public init(urlHandler: URLHandling) {
        self.urlHandler = urlHandler
    }
    
    public var body: some Scene {
        WindowGroup {
            ContentView()
                .onOpenURL(perform: urlHandler.handleURL)
        }
    }
}

在Experience库中实现该协议：

// Experience 库中
public class ExperienceURLHandler: URLHandling {
    public func handleURL(_ url: URL) {
        // 原URL处理逻辑，包括Swift-C++互操作代码
        print("处理URL: \(url.absoluteString)")
        // 更新UI的逻辑
    }
}

在AppTarget中组装依赖：

@main
struct MyApp: App {
    public var body: some Scene {
        LifecycleApp(urlHandler: ExperienceURLHandler())
    }
}

方案2：闭包回调 #

在Lifecycle库中给App入口添加闭包参数：

// Lifecycle 库中
public struct LifecycleApp: App {
    private let onOpenURL: (URL) -> Void
    
    public init(onOpenURL: @escaping (URL) -> Void) {
        self.onOpenURL = onOpenURL
    }
    
    public var body: some Scene {
        WindowGroup {
            ContentView()
                .onOpenURL(perform: onOpenURL)
        }
    }
}

在AppTarget中传入Experience的处理逻辑：

@main
struct MyApp: App {
    public var body: some Scene {
        LifecycleApp { url in
            ExperienceURLHandler.handleURL(url)
            // 或直接编写处理逻辑
        }
    }
}

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