WidgetKit小组件深度链接跳转macOS应用openURLs未触发问题咨询

核心原因 #

绝大多数旧项目无法触发该回调，都是因为项目中实现了macOS更早版本的URL事件处理接口，系统会优先调用老接口，不会再触发新的openURLs:方法。

最常见场景：实现了AppleEvent的URL处理方法 #

旧版本macOS处理自定义URL scheme依赖AppleEvent，很多老项目会实现如下方法：

- (void)handleGetURLEvent:(NSAppleEventDescriptor *)event withReplyEvent:(NSAppleEventDescriptor *)replyEvent

或者手动注册了kAEGetURL事件的自定义处理器：

[[NSAppleEventManager sharedAppleEventManager] setEventHandler:self 
                                                   andSelector:@selector(handleGetURLEvent:withReplyEvent:)
                                                 forEventClass:kInternetEventClass
                                                    andEventID:kAEGetURL];

只要存在上述任意一种实现，系统就不会调用NSApplicationDelegate的application:openURLs:方法。 #

其他排查点 #

• 检查NSApplicationDelegate是否实现了废弃的文件打开相关方法，比如application:openFile:、application:openFiles:，部分老项目会将URL跳转逻辑合并到这些方法中处理，也会阻断新回调的触发。
• 确认自定义URL scheme配置在主应用的Info.plist中，而不是扩展、测试等其他Target下，CFBundleURLTypes下的CFBundleURLSchemes字段没有拼写错误。
• 若项目开启了App Sandbox，确认没有配置不当的权限规则阻断URL事件的传递。
• 排查是否有第三方SDK拦截了URL跳转事件，部分统计、路由类SDK会优先接管URL处理逻辑。

解决方案 #

1. 优先迁移逻辑到新接口：删除项目中老的handleGetURLEvent相关实现，移除自定义AppleEvent注册代码，系统就会自动触发application:openURLs:回调。
2. 若需要保留老接口兼容更低系统版本，可以直接在老的handleGetURLEvent方法中处理Widget跳转的URL：

- (void)handleGetURLEvent:(NSAppleEventDescriptor *)event withReplyEvent:(NSAppleEventDescriptor *)replyEvent {
    NSString *urlString = [[event paramDescriptorForKeyword:keyDirectObject] stringValue];
    NSURL *targetURL = [NSURL URLWithString:urlString];
    // 在这里处理Widget跳转的业务逻辑即可
}

3. 若存在缓存问题，可删除~/Library/Preferences/[你的应用Bundle ID].plist文件后重启设备再测试，排除系统缓存旧配置的影响。

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