未安装应用时Smart App Banner不显示问题排查求助

核心问题定位 #

你的apple-itunes-app meta标签中app-id字段为空，这是导致应用未安装时横幅不显示的直接原因。Smart App Banner需要有效的App Store应用ID来关联对应应用，才能在未安装时展示下载按钮。

修复步骤 #

1. 补全meta标签的app-id
   找到你的应用在App Store的唯一ID（可从App Store Connect应用详情页获取，或App Store网页版URL末尾的数字串），将其填入app-id字段。正确的标签格式如下：

   <meta name="apple-itunes-app" content="app-id=你的应用ID, app-argument=myapp.com">
   

   示例：app-id=123456789

2. 验证apple-app-site-association文件
   该文件主要用于Universal Links，但需确保格式无误：

   • 检查JSON语法，确保无多余逗号、引号匹配正确
   • 确认appID格式为TeamID.BundleID，你当前的HGU83XXXXX.com.myapp.app格式正确，但需保证TeamID和BundleID与App Store Connect中应用信息完全一致

3. 其他必要检查

   • 仅在iOS设备的Safari浏览器中测试（Smart App Banner不支持其他浏览器）
   • 清除Safari的缓存和网站数据，避免旧配置干扰
   • 确保应用已在App Store正式上架（未上架的测试应用无法触发下载提示）

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