集成Advanced App Clip Experience后测试时卡片不显示求助

1. 优先修复Associated Domains橙色诊断状态 #

• 确认App Clip目标的appclips:域名配置完全匹配App Store Connect中Advanced Experience填写的域名，包括前缀（如是否带www）、路径后缀（若有），保持格式统一。
• 校验apple-app-site-association文件：
  • 确保文件部署在域名的.well-known目录下，HTTPS访问返回200状态码，无重定向。
  • 文件appclips字段的apps数组必须包含App Clip的Team ID+Bundle ID，格式为TEAMID.BUNDLEID。示例结构：

    {
      "appclips": {
        "apps": ["ABCDE12345.com.yourcompany.AppClip"]
      },
      "applinks": {
        "details": [
          {
            "appID": "ABCDE12345.com.yourcompany.MainApp",
            "paths": ["*"]
          },
          {
            "appID": "ABCDE12345.com.yourcompany.AppClip",
            "paths": ["*"]
          }
        ]
      }
    }
    

• 刷新域名关联缓存：用Safari访问你的关联域名，重启设备；模拟器测试可执行命令xcrun simctl openurl booted https://your-domain.com强制刷新。

2. 处理“App Clip Published on App Store”警告 #

• 确认App Store Connect中Advanced App Clip Experience的配置：选择的App Clip目标正确，且关联的构建版本为你上传的Testflight测试版。
• 若警告持续，可尝试将App Clip构建版本提交至App Store审核（无需发布，进入Pending状态即可），部分场景下Advanced Experience需要构建版本处于审核流程中才能正常触发。

3. 其他关键排查点 #

• 链接路径校验：测试链接必须严格匹配Advanced Experience配置的路径规则，额外参数或路径偏差会导致卡片不触发。
• 设备设置检查：确保设置->Safari浏览器->隐私与安全性中，“阻止跨网站跟踪”关闭，“允许App Clip”开启。
• 重置App Clip缓存：进入设置->通用->iPhone存储空间，找到所有App Clip并删除，重新测试链接。
• Testflight安装验证：确认设备已通过Testflight安装主应用和App Clip的对应测试版本，且登录的Apple ID为测试用ID。

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