更新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
相关产品推荐
相关产品推荐

