You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

更新apple-app-site-association后新iOS App仍无法通过URL唤起

iOS App链接唤起故障排查(新增App无法通过URL唤起)

我已有一款可通过点击或访问URL唤起的iOS App,现在新增了另一款具备相同唤起功能的App。已在apple-app-site-association文件中注册该新App,且确认服务器上文件渲染正常,但访问对应URL时无法唤起新App。已尝试清除缓存、重建服务器,问题仍未解决。

以下是我的apple-app-site-association文件:

{  
  "applinks": {      
    "details": [           
      {             
        "appIDs": [               
          "XB5XPLRPRC.com.devfest.bookings", // 可正常唤起
          "XB5XPLRPRC.com.devfest.subscription" // 无法唤起App
        ],             
        "paths": ["/*"]           
      }       
    ]   
  },   
  "webcredentials": {      
    "apps": [               
      "XB5XPLRPRC.com.devfest.bookings",               
      "XB5XPLRPRC.com.devfest.subscription"      
    ]   
  },   
  "activitycontinuation": {    
    "apps": [              
      "XB5XPLRPRC.com.devfest.bookings",               
      "XB5XPLRPRC.com.devfest.subscription"    
    ]  
  }
}

排查步骤

  • 核对新App的Bundle ID:确保与配置文件中的XB5XPLRPRC.com.devfest.subscription完全一致,Bundle ID区分大小写,标点符号也不能出错。
  • 检查开发者后台配置:在Apple开发者后台,确认新App已开启Associated Domains功能,并添加了对应域名(格式为applinks:你的域名.com)。
  • 验证Xcode签名配置:打开Xcode中App的Signing & Capabilities面板,确认Associated Domains已正确添加域名,且所用的Provisioning Profile包含该权限。
  • 强制刷新系统缓存:除了清除Safari缓存,还可以重启设备,或通过Xcode的Developer > Clear Website Data功能(需连接真机)清理App链接缓存。
  • 检查HTTPS有效性:苹果要求apple-app-site-association文件必须通过HTTPS访问,且证书无过期、无链问题。可通过curl -v https://你的域名.com/apple-app-site-association验证返回内容是否正确。
  • 拆分applinks配置:将两个AppID分开配置,避免解析冲突,修改后的示例如下:
{  
  "applinks": {      
    "details": [           
      {             
        "appIDs": ["XB5XPLRPRC.com.devfest.bookings"],             
        "paths": ["/*"]           
      },
      {             
        "appIDs": ["XB5XPLRPRC.com.devfest.subscription"],             
        "paths": ["/*"]           
      }       
    ]   
  },   
  "webcredentials": {      
    "apps": [               
      "XB5XPLRPRC.com.devfest.bookings",               
      "XB5XPLRPRC.com.devfest.subscription"      
    ]   
  },   
  "activitycontinuation": {    
    "apps": [              
      "XB5XPLRPRC.com.devfest.bookings",               
      "XB5XPLRPRC.com.devfest.subscription"    
    ]  
  }
}
  • 真机测试唤起场景:避免用模拟器测试,改用真机在Safari或支持App链接的应用中打开目标URL,确保路径为域名下的有效地址。

内容的提问来源于stack exchange,提问作者sadiq shareef

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.15 02:50:01