Swift iOS应用Firebase动态链接未触发AppDelegate方法求助

1. 基础配置校验 #

• 检查Info.plist中FirebaseAppDelegateProxyEnabled是否设为YES（旧版Firebase SDK必填，新版可忽略，但该开关直接影响代理方法触发逻辑）。
• 确认关联域名格式：必须为applinks:你的动态链接域名.page.link，Xcode的Associated domains需勾选并准确填写，无多余空格或符号。

2. SceneDelegate正确实现（iOS 13+） #

若APP基于SceneDelegate架构，需实现以下核心方法并处理动态链接：

func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let url = URLContexts.first?.url else { return }
    print("SceneDelegate 捕获URL: \(url)")
    processDynamicLink(url: url)
}

func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
    if let incomingURL = userActivity.webpageURL {
        print("SceneDelegate 捕获用户活动URL: \(incomingURL)")
        processDynamicLink(url: incomingURL)
    }
}

// 动态链接解析逻辑
private func processDynamicLink(url: URL) {
    DynamicLinks.dynamicLinks().handleUniversalLink(url) { dynamicLink, error in
        guard error == nil, let dynamicLink = dynamicLink, let targetURL = dynamicLink.url else {
            print("解析失败: \(error?.localizedDescription ?? "未知错误")")
            return
        }
        print("解析到参数: \(targetURL.query ?? "无参数")")
        // 此处添加页面跳转逻辑，例如根据query参数跳转至指定页面
    }
}

同时确保Info.plist的Application Scene Manifest已正确指定SceneDelegate类。

3. AppDelegate兼容处理（iOS 12及以下） #

如需兼容旧系统，在AppDelegate中实现以下方法：

func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
    print("AppDelegate 捕获URL: \(url)")
    return processDynamicLink(url: url)
}

func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
    if let incomingURL = userActivity.webpageURL {
        print("AppDelegate 捕获用户活动URL: \(incomingURL)")
        return processDynamicLink(url: incomingURL)
    }
    return false
}

private func processDynamicLink(url: URL) -> Bool {
    var isHandled = false
    DynamicLinks.dynamicLinks().handleUniversalLink(url) { dynamicLink, error in
        guard error == nil, let dynamicLink = dynamicLink, let targetURL = dynamicLink.url else {
            print("解析失败: \(error?.localizedDescription ?? "未知错误")")
            return
        }
        isHandled = true
        print("解析到参数: \(targetURL.query ?? "无参数")")
        // 页面跳转逻辑
    }
    return isHandled
}

4. 测试注意事项 #

• 不要在Xcode调试状态下测试：先安装APP到设备，退出Xcode调试，再点击动态链接，通过设备控制台（Console.app）查看日志，或在APP内添加弹窗展示参数，避免调试状态下代理方法被Firebase拦截。
• 使用完整动态链接测试：优先用Firebase控制台生成的完整链接，避免直接测试短链接（短链接需跳转解析，可能影响触发逻辑）。
• 关闭设备隐私限制：进入设置 -> Safari浏览器 -> 隐私与安全性，关闭阻止跨网站跟踪，该选项可能干扰深度链接触发。

5. 其他排查点 #

• 更新Firebase SDK：执行pod update Firebase/DynamicLinks，旧版本可能存在SceneDelegate兼容问题。
• 校验Firebase控制台配置：确保动态链接的深度链接URL正确，且已添加至允许的域名列表。
• 验证关联域名有效性：检查你的域名是否返回正确的apple-app-site-association配置文件，确保APP能正确识别关联域名。

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