iOS默认浏览器无法直接打开Deep Link，该如何解决？

1. 是否存在遗漏的配置？ #

常见的配置遗漏点包括：

• iOS原生配置：
  • 未在Info.plist中正确配置CFBundleURLTypes（自定义Scheme）或com.apple.developer.associated-domains（Universal Links）
  • 未在Apple Developer后台开启Associated Domains权限
  • 服务器未部署正确的apple-app-site-association文件，或文件格式、访问权限、存放路径不符合要求
• Flutter端配置：
  • 未集成uni_links/url_launcher等Deep Link监听插件，或未正确初始化监听逻辑
  • 测试时使用开发签名证书，而非正式签名（Universal Links在开发环境下可能无法正常触发）

2. 能否阻止该行为？ #

可以通过正确配置Universal Links实现直接唤起应用，无需弹出选择窗口。自定义Scheme受iOS系统限制，必然会弹出应用选择框；而Universal Links配置正确后，iOS会直接识别链接归属，自动唤起对应应用（除非用户手动设置过强制用Safari打开该链接）。

3. 可行的解决方案 #

方案一：完善Universal Links配置（推荐） #

• 开发者后台配置：在Apple Developer后台的应用标识符中开启Associated Domains权限，更新Provisioning Profile
• iOS项目配置：在Info.plist中添加com.apple.developer.associated-domains数组，添加条目applinks:你的域名.com（不要加http/https前缀）
• 服务器部署：在域名根目录或.well-known目录放置apple-app-site-association文件，示例格式：

  {
    "applinks": {
      "apps": [],
      "details": [
        {
          "appID": "你的TeamID.你的BundleID",
          "paths": ["/reset-password/*", "/其他Deep Link路径/*"]
        }
      ]
    }
  }
  

  确保文件可通过HTTPS访问，且返回Content-Type: application/json
• Flutter端监听：使用uni_links插件监听Universal Links，示例代码：

  import 'package:uni_links/uni_links.dart';
  
  Future<void> initDeepLinkListener() async {
    // 处理应用启动时的初始链接
    final initialLink = await getInitialLink();
    if (initialLink != null) {
      handleDeepLink(initialLink);
    }
    // 监听应用运行时的链接
    linkStream.listen((String? link) {
      if (link != null) {
        handleDeepLink(link);
      }
    });
  }
  
  void handleDeepLink(String link) {
    // 解析链接并处理业务逻辑（如重置密码）
  }
  

方案二：优化自定义Scheme的唤起体验 #

若暂时无法使用Universal Links，可通过网页端JS优化唤起流程：

• 在重置密码的网页中添加以下JS代码，尝试自动唤起应用，若几秒内未成功则提示用户手动操作：

  function triggerAppOpen() {
    const schemeUrl = '你的自定义Scheme://reset-password?token=xxx';
    const startTime = Date.now();
    window.location.href = schemeUrl;
    // 检测是否唤起成功，未成功则提示
    setTimeout(() => {
      if (Date.now() - startTime < 2000) {
        alert('请选择打开应用，或前往App Store下载');
      }
    }, 1500);
  }
  

方案三：添加用户引导 #

在重置密码的邮件或网页中，明确告知用户操作步骤：如弹出应用选择框时，选择你的应用而非Safari打开链接。

方案四：验证配置正确性 #

使用Apple官方的App Search验证工具，检查apple-app-site-association文件是否符合要求，确保Universal Links配置生效。

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