macOS Swift桌面应用处理Deeplink时urls数组为空排查求助

问题原因 #

你的代码存在两个核心问题：

1. Info.plist格式错误：CFBundleURLName字段使用了带逗号的格式my.org,com.myhandler，这个字段要求是反向DNS格式的唯一标识符（比如com.myorg.mylinkhandler），非法格式会导致系统无法正确关联URL Scheme。
2. 未处理应用运行时的DeepLink回调：当应用已经处于运行状态时，触发DeepLink不会调用application(_:open:)方法，而是通过NSUserActivity传递，你没有实现对应的处理逻辑。

解决方案 #

1. 修正Info.plist的URL配置 #

将CFBundleURLName改为合法的反向DNS格式，修正后的Info.plist相关部分：

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleTypeRole</key>
        <string>Viewer</string>
        <key>CFBundleURLName</key>
        <string>com.myorg.mylinkhandler</string> <!-- 修正为合法标识符 -->
        <key>CFBundleURLSchemes</key>
        <array>
            <string>mylink</string>
        </array>
    </dict>
</array>

2. 完善AppDelegate的回调逻辑 #

同时实现应用未启动和已运行时的DeepLink处理方法，统一URL处理逻辑：

import Cocoa

class AppDelegate: NSObject, NSApplicationDelegate {
    // 应用未启动时，通过DeepLink打开触发此方法
    func application(_ application: NSApplication, open urls: [URL]) {
        handleURLs(urls)
    }
    
    // 应用已运行时，通过DeepLink打开触发此方法
    func application(_ application: NSApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([NSUserActivityRestoring]) -> Void) -> Bool {
        guard userActivity.activityType == NSUserActivityTypeBrowsingWeb, 
              let url = userActivity.webpageURL else {
            return false
        }
        handleURLs([url])
        return true
    }
    
    // 统一处理URL的逻辑
    private func handleURLs(_ urls: [URL]) {
        for url in urls {
            print("Handle url: ", url)
            // 在这里添加你的URL解析、业务处理逻辑
        }
    }
}

3. 确保应用正确签名 #

macOS要求应用必须签名才能注册URL Scheme，在Xcode中：

• 打开项目设置，选择"Signing & Capabilities"标签
• 勾选"Automatically manage signing"，并选择你的开发团队账号

Swift新手开发建议 #

• 测试DeepLink的正确方式：使用open -a 你的应用名称 mylink://path/to/file命令，明确指定目标应用，避免系统匹配到其他注册了相同Scheme的应用；也可以在Xcode的Scheme设置中，在"Arguments Passed On Launch"添加mylink://test，启动应用时直接触发DeepLink调试。
• 日志输出技巧：优先使用NSLog代替print，因为macOS GUI应用的print输出不会显示在终端，而NSLog内容会出现在Xcode调试控制台和系统日志中。
• 无UI的极简应用：如果不需要窗口，可以把WindowGroup替换为EmptyScene，让应用后台运行：

@main
struct SMBUrlHelperSecondApproachApp: App {
    @NSApplicationDelegateAdaptor(AppDelegate.self) var delegate
    var body: some Scene {
        EmptyScene() // 不显示任何窗口
    }
}

• 生命周期理解：SwiftUI的App生命周期简化了常规流程，但系统级事件（如DeepLink、通知）仍需借助AppDelegate/SceneDelegate处理，建议熟悉AppKit的核心回调方法。

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