Cordova iOS端Deep Link/Universal Link无法唤起APP问题求助

1. 必须绑定用户主动交互触发跳转 #

iOS 9+ 对非用户主动触发的URL Scheme/Universal Link跳转有严格限制，直接在页面加载或定时器中触发会被浏览器拦截，导致无法唤起APP。

• 修复：将跳转逻辑绑定到按钮的click或touchstart事件上，确保是用户主动操作触发：

  document.getElementById('open-app-btn').addEventListener('click', function() {
    // 跳转逻辑放在这里
  });
  

2. 优先使用Universal Link而非URL Scheme #

你已部署AASA文件，但当前代码仍使用URL Scheme，未利用Universal Link的优势：

• Universal Link是HTTPS开头的域名链接（如https://mydomain.com/app/dashboard），iOS系统可直接判断APP是否安装，无需依赖定时器回退。
• 检查AASA文件的paths配置，确保包含跳转路径，示例：

  {
    "applinks": {
      "apps": [],
      "details": [
        {
          "appID": "你的TeamID.com.jfmech.myapp1",
          "paths": [ "/app/dashboard", "/*" ]
        }
      ]
    }
  }
  

• 代码中替换为Universal Link：

  window.location.href = "https://mydomain.com/app/dashboard";
  

3. 修复定时器回退逻辑的缺陷 #

iOS中即使成功唤起APP，浏览器页面不会立即销毁，定时器仍会执行导致跳转到应用商店：

• 添加页面可见性监听，当页面隐藏时清除定时器：

  let deepLinkTimer;
  function openApp() {
    window.location.href = "https://mydomain.com/app/dashboard";
    deepLinkTimer = setTimeout(() => {
      window.location.href = GetStoreLinkByOS();
    }, 2000);
  }
  // 监听页面隐藏，清除定时器
  document.addEventListener('visibilitychange', () => {
    if (document.hidden) {
      clearTimeout(deepLinkTimer);
    }
  });
  

4. 检查Info.plist配置细节 #

• 确认com.apple.developer.associated-domains中的域名与AASA部署域名完全一致，格式为applinks:mydomain.com（无需加https://）。
• 确认AASA文件中的appID格式为TeamID.BundleID，TeamID可在Apple Developer后台查看，与APP签名使用的TeamID一致。
• 检查CFBundleURLSchemes的字符串与代码中使用的URL Scheme完全匹配，无拼写错误。

5. 第三方浏览器适配 #

微信、QQ等第三方浏览器对Universal Link支持有限，需单独处理：

• 针对这些浏览器，可尝试使用URL Scheme，但需注意部分浏览器会拦截非白名单APP的跳转，可能需要引导用户复制链接到Safari打开。

内容的提问来源于stack exchange，提问作者JF-Mechs