iOS通用深度链接适配：从Instagram故事实现按安装状态跳转APP/网页

一、先确认Universal Links基础配置的合规性 #

Instagram对Universal Links的校验比Safari更严格，先排查以下核心点：

• 域名必须为HTTPS协议，apple-app-site-association文件需放在域名根目录或.well-known子目录下，且内容无语法错误
• 文件中paths字段避免过度使用通配符（比如/*），建议配置具体路径规则，Instagram可能拦截过于宽泛的匹配
• APP的associated domains权限已正确添加，格式为applinks:yourdomain.com，且已打包到正式签名的APP中
• 先在Safari中测试链接：长按链接查看是否有「打开[你的APP名]」选项，若没有，先修复基础配置问题

二、通过中间页绕过Instagram的WebView拦截 #

Instagram内置WebView会直接拦截Universal Links跳转至网页，需通过中间跳转页实现动态逻辑：

1. 配置一个中间跳转页面（比如https://yourdomain.com/ig-redirect）
2. 在页面中加入以下JS逻辑，实现「唤起APP失败则跳转网页」的逻辑：

function handleRedirect() {
  const universalLink = "https://yourdomain.com/target-path"; // 你的目标Universal Links
  const webFallbackUrl = "https://yourdomain.com/web-fallback"; // 网页版地址
  const startTime = Date.now();

  // 尝试通过Universal Links唤起APP
  window.location.href = universalLink;

  // 超时检测：2秒内未唤起则跳转网页
  setTimeout(() => {
    if (Date.now() - startTime < 2500) {
      window.location.href = webFallbackUrl;
    }
  }, 2000);
}

window.addEventListener("load", handleRedirect);

三、实现「打开应用」的授权提示 #

系统默认的Universal Links唤起不会弹出授权提示，需结合自定义URL Scheme触发系统提示：

1. 在APP的Info.plist中配置自定义URL Scheme：
   • 添加LSApplicationQueriesSchemes数组，加入你的scheme（比如yourapp）
   • 添加CFBundleURLSchemes数组，配置对应的scheme值
2. 修改中间页的JS逻辑，先尝试用scheme唤起（触发系统提示），失败后降级到Universal Links或网页：

function handleRedirectWithPrompt() {
  const schemeUrl = "yourapp://target-path"; // 自定义Scheme地址
  const universalLink = "https://yourdomain.com/target-path";
  const webFallbackUrl = "https://yourdomain.com/web-fallback";
  const startTime = Date.now();

  // 先尝试自定义Scheme唤起，触发系统授权提示
  window.location.href = schemeUrl;

  // 第一次超时检测：2秒未唤起则尝试Universal Links
  setTimeout(() => {
    if (Date.now() - startTime < 2500) {
      window.location.href = universalLink;
      // 第二次超时检测：再等2秒未唤起则跳转网页
      setTimeout(() => {
        if (Date.now() - startTime < 5000) {
          window.location.href = webFallbackUrl;
        }
      }, 2000);
    }
  }, 2000);
}

window.addEventListener("load", handleRedirectWithPrompt);

四、关键注意事项 #

• 测试需用真实设备+正式发布的Instagram账号，模拟器或测试账号的行为可能不一致
• 若用户之前拒绝过授权，系统不会再弹出提示，需引导用户手动打开APP或在设置中授权
• apple-app-site-association文件更新后，需等待CDN缓存失效，或让用户重启APP刷新配置
• 确保链接内容符合Instagram社区规范，避免被平台拦截

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