apple-app-site-association 部署说明

配合 docs/superpowers/specs/2026-06-11-share-modal-redesign-design.md § 4.2 使用创建日期：2026-06-25

必填原因

iOS 13+ 微信 / 微博 SDK 强制要求 Universal Links 验证。若 https://h5.topfans.com/uni-universallinks/apple-app-site-association 文件不存在或内容错误，uni.share 唤起微信会被 SDK 静默拒绝（errMsg 报 "bad params"）。

部署位置

URL：https://h5.topfans.com/uni-universallinks/apple-app-site-association

无后缀（不是 .json）
HTTPS（强制）
Content-Type: application/json
文件需可直接 GET，无鉴权

文件内容模板

{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appIDs": ["<TeamID>.com.topfans.app"],
        "components": [
          { "/": "/uni-universallinks/*", "comment": "match" }
        ]
      }
    ]
  }
}

<TeamID> 替换为苹果开发者账号的 Team ID（10 位字母数字）。

部署后验证

访问 https://h5.topfans.com/uni-universallinks/apple-app-site-association 应返回上述 JSON
iOS 设备 Safari 访问 https://h5.topfans.com/uni-universallinks/ 应弹"在 TopFans 中打开"提示
后端/运维确认后，前端方可启用真实微信/微博分享测试

阻塞状态

当前 <REPLACE_WITH_WEIXIN_APPID> 等占位符未替换，真机分享测试暂不可用。前端 dev 环境用 share-mock.js 绕过。

1.4 KiB Raw Blame History Unescape Escape