48 lines
1.4 KiB
Markdown
48 lines
1.4 KiB
Markdown
# 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，无鉴权
|
||
|
||
## 文件内容模板
|
||
|
||
```json
|
||
{
|
||
"applinks": {
|
||
"apps": [],
|
||
"details": [
|
||
{
|
||
"appIDs": ["<TeamID>.com.topfans.app"],
|
||
"components": [
|
||
{ "/": "/uni-universallinks/*", "comment": "match" }
|
||
]
|
||
}
|
||
]
|
||
}
|
||
}
|
||
```
|
||
|
||
`<TeamID>` 替换为苹果开发者账号的 Team ID（10 位字母数字）。
|
||
|
||
## 部署后验证
|
||
|
||
1. 访问 `https://h5.topfans.com/uni-universallinks/apple-app-site-association` 应返回上述 JSON
|
||
2. iOS 设备 Safari 访问 `https://h5.topfans.com/uni-universallinks/` 应弹"在 TopFans 中打开"提示
|
||
3. 后端/运维确认后，前端方可启用真实微信/微博分享测试
|
||
|
||
## 阻塞状态
|
||
|
||
当前 `<REPLACE_WITH_WEIXIN_APPID>` 等占位符未替换，真机分享测试暂不可用。
|
||
前端 dev 环境用 `share-mock.js` 绕过。
|