iOS端Universal Links在浏览器中点击无法唤起Flutter应用求助

先明确：Universal Links完全支持从Safari/Chrome浏览器唤起应用，你的问题出在浏览器的行为特性和配置细节上。

核心原因 #

• Safari的Smart App Banner机制：用户首次在浏览器打开你的Universal Link时，顶部会显示App Banner，必须手动点击「打开」按钮才能唤起应用；如果用户忽略或关闭过Banner，后续点击链接会默认在浏览器打开。
• Chrome的处理逻辑：iOS端Chrome遵循Universal Links规则，但需要用户主动操作（比如长按链接选择「在[你的应用]中打开」），或是之前通过Banner唤起过应用。
• 可能存在aasa文件的匹配规则不够精准的问题。

针对性解决步骤 #

1. 前端适配：自动尝试唤起应用 #

在你的网页https://my-domain.com/auth/create-password中添加JS逻辑，检测iOS环境并尝试唤起应用，失败则留在网页：

// 检测iOS设备
function isIOS() {
  return /iPad|iPhone|iPod/.test(navigator.userAgent) && !window.MSStream;
}

// 尝试唤起应用，失败则 fallback 到网页
function openApp() {
  if (!isIOS()) return;
  
  const token = new URLSearchParams(window.location.search).get('token');
  const appSchemeUrl = "myapp://auth/create-password?token=" + token; // 替换为你的自定义URL Scheme
  
  const startTime = Date.now();
  window.location.href = appSchemeUrl;
  
  // 1.5秒内未唤起，说明应用未安装，回到原链接
  setTimeout(() => {
    if (Date.now() - startTime < 2000) {
      window.location.href = window.location.href;
    }
  }, 1500);
}

// 页面加载时自动触发
window.addEventListener('load', openApp);

配套操作：在Xcode的Info.plist中添加自定义URL Scheme作为 fallback：

<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>myapp</string> <!-- 替换为你的Scheme名称，比如应用英文名 -->
    </array>
  </dict>
</array>

2. 优化aasa文件的匹配规则 #

调整components规则，精准匹配带token参数的链接，避免模糊匹配导致的识别问题：

{
    "applinks": {
        "details": [
            {
                "appIDs": [
                    "my_team_id.com.mydomain.app.name"
                ],
                "components": [
                    {
                        "/": "/auth/create-password",
                        "?": { "token": "*" },
                        "comment": "Password creation with token"
                    }
                ]
            }
        ]
    }
}

验证方法：在Xcode中选中测试设备，右键选择「Download Container」，查看容器内的日志文件，确认aasa文件已正确加载。

3. 引导用户手动唤起 #

在网页中添加明显的提示文案：

若未自动唤起应用，请长按链接选择「在[你的应用名称]中打开」，或点击下方按钮唤起。

同时添加绑定了openApp()函数的唤起按钮，降低用户操作门槛。

关键注意事项 #

• 用户首次访问链接时，必须通过Banner或手动操作授权唤起，之后浏览器才会默认触发唤起行为。
• 确保应用已通过App Store或Ad Hoc分发，模拟器和测试环境的行为可能与正式环境有差异。
• 测试前可清除浏览器缓存（iOS设置 > Safari > 清除历史记录与网站数据），或卸载重装应用重置关联数据。

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