Universal Links 与 App Links:上架相关配置与验收
苹果 Universal Links 与安卓 App Links 的域名校验、关联文件、审核路径里如何演示。适合带分享回流的产品。Telegram @hagee66。
官网传送门(可直接点击跳转)
打开本文 · 指南库 · 苹果上架 · 谷歌上架 · 双端上架
Telegram 询价 @hagee66 · 官网 goee.cc
分享回流、邮件验证、活动落地页——许多产品依赖 HTTPS 链接触发 App 而非网页套壳。配置错误时:链总在 Safari 打开、验证邮件点不开、审核员无法复现「从消息进入 App」。上架通(goee.cc)把深度链接列入提审可演示项,与登录备注并列。材料见 App Store 材料 与 Google Play 材料,演示账号见 审核测试账号,预检见 预检评分表。域名验证格式以官方当前页面为准。
这篇要解决的问题
- apple-app-site-association 未 HTTPS 或无 Content-Type。
- App Links intent-filter 写错 host/path,与网站文件不一致。
- 自定义 scheme 冒充 Universal Link 主路径。
- 关联域名在 entitlements 漏填或多环境域名未分开。
- 登录态深链未处理 token 过期崩溃。
- 备注未给可点击测试 URL。
谁应该读
| 角色 | 交付 |
|---|---|
| iOS | Associated Domains、路由 |
| Android | assetlinks.json、autoVerify |
| 后端 | AASA / assetlinks 托管 |
| Web | 落地页与 fallback |
| 上架 | 备注中 2–3 条测试链 |
有分享卡片、邀请返利、邮件重置密码即应配置并验收。
核心做法
Universal Links(iOS)
| 步骤 | 检查 |
|---|---|
| 域名 HTTPS | 有效证书,无拦截登录墙挡审核 |
| AASA | 根域或 well-known 路径可访问 |
| Entitlements | applinks:your.domain |
| App 路由 | 冷启动/暖启动均解析 |
| 用户体验 | 无效链有网页 fallback |
App Links(Android)
| 步骤 | 检查 |
|---|---|
| assetlinks.json | package+签名 SHA256 匹配 |
| Manifest | intent-filter autoVerify=true |
| 签名 | 上传 Play 用同一签名指纹 |
| 验证 | adb / 真机「打开方式」默认 App |
| Fallback | 未装 App 开网页商店 |
审核演示
准备 不需登录 与 需登录 各一条链;备注写预期:点链→开 App 哪屏。弱网、未装 App、已装旧版各测一次。
可复制模板
配置验收表
域名:
AASA URL:
HTTP 状态 200:是/否
Entitlements / assetlinks SHA:
路径 /invite/* → App 路由 InviteScreen
路径 /reset/* → ResetPassword
测试机 iOS [ver]:OK/FAIL
测试机 Android [API]:OK/FAIL
备注已附 URL:是/否
Review Notes
Universal Link test (app installed):
https://[domain]/invite/demo2026 — opens Invite screen.
App Link test:
https://[domain]/product/42 — opens SKU detail.
Without login: https://[domain]/help/faq — in-app WebView fallback.
Custom scheme myapp:// is secondary; HTTPS links preferred.
assetlinks 片段逻辑(示意)
package_name = applicationId
sha256_cert_fingerprints = [release upload key from Play App Signing]
relation = delegate_permission/common.handle_all_urls
具体 JSON 字段以官方当前页面为准。
常见误区
- staging 域与生产域混在一个 entitlement。
- AASA 缓存未刷新就提审(Apple CDN 有延迟)。
- 短链跳转丢失 Universal Link 上下文。
- 在 WebView 里点自己的域却不走关联。
- 备注给 HTTP 非 HTTPS 链。
- 欺骗审核用仅内网可解析的域名。
提交前核对(上架执行)
把深度链接当作与登录并列的「可演示契约」:备注里写的 URL,必须在提审构建、提审日期的生产域名上可复现。提交前由未参与开发的同事仅用备注文档操作一遍,记录停在哪一步。以下逐项打勾后再点提交:
- AASA 与 assetlinks 在无登录浏览器可 200 访问
- 关联域名列表与线上文件中的 applinks / package 一致
- 发布签名指纹已写入 assetlinks(含 Play App Signing 场景)
- 冷启动点链、热启动点链、从短信/备忘录点链各测一次
- 未安装 App 时行为与商店描述一致(进网页或进商店)
- 登录前与登录后各准备至少一条演示 URL
- token 过期或参数缺失时有可读错误,不是白屏崩溃
- 商店截图未承诺未实现的「一键回流」能力
- 审核备注附 2–3 条完整 HTTPS 链接(非截图)
- 与 拒审整改 归档一致:若上一版在此失败,本版改动已写入说明
上架通协助验收时只看上述清单勾选与录屏,不把「曾经在别的包上通过」当作保证。以官方当前页面为准。
问与答
问:一定要 Universal Link 吗?
答:非强制;但若宣传「点链进 App」,审核会按宣传测。
问:Firebase Dynamic Links 下架后怎么迁?
答:按谷歌迁移指引换自管域或替代;以官方为准。
问:微信内打开被拦?
答:与商店审核不同生态;产品侧提供复制链或引导浏览器。
问:多 flavor 包名不同?
答:assetlinks 要多条或分文件。
问:上架通代验域?
答:可提供清单式验收;不承诺过审。
问:双端只有一端配好,描述能写「全平台直达」吗?
答:不能;分端写清行为差异。
问:短链域名与落地域名不同怎么验?
答:备注写最终跳转 HTTPS 链;短链服务配置以厂商文档为准。
提交前核对(上架执行)
- AASA / assetlinks 匿名可访问且与签名一致
- 提审备注 URL 在新装真机可复现
- 登录前后各 1 条链已测
- 描述与截图无未实现的一键回流承诺
- 关联域名环境不分 staging 混入生产 entitlement
- 弱网错误页非白屏
- 与 预检评分表 深链行挂钩
- 上版若因路径拒审,本版改动已对回拒信
CDN、重定向与多地解析
营销短链常 302 到最终 URL。若 302 目标无 AASA,Universal Link 会失效。尽量让分享按钮直接出目标 HTTPS 链,或在短链服务上配置允许关联。国内与海外双域时,entitlements 列全,备注写审核员应点哪条域。
安全:token in URL
重置密码、登录 magic link 不要把长期 session token 放查询参数;一次性 code 短期有效,用后作废。日志与崩溃上报勿打印完整 URL 查询串。审核备注里用专用测试码,提审后轮换。
与登录态和未安装用户的商店转化
未安装 App 点链应落网页,网页上「在商店中打开」按钮合规即可,不要强行 scheme 绑架浏览器。已安装未登录时,深链先进登录再跳目标页,备注写明。与 审核测试账号 配合给一条登录后深链。
与排期、协作的关系
深度链接失败常在「提审前一晚改域名」时发生:研发换了证书,运营不知情;上架备注仍贴旧链。把 AASA / assetlinks 变更纳入 iOS 版本号 与 Android versionCode 的发布说明,要求合并分支后 24 小时内完成域名侧验收。代上架协作时,工程交付物应含「可点击 URL 列表」而非仅配置截图;上架通核对时按清单逐项打勾,不代替你们做 DNS 变更。不承诺过审。等待审核期间的域名证书过期,同样会导致审核员复现失败,见 审核周期预期。
执行节奏与排期
域名校验在 DNS 切生产前两周完成 AASA/assetlinks 预演;留 CDN 缓存刷新时间。与营销活动排期对齐:活动域若与主域不同,提前配置 entitlements。版本发布说明可写「改进链接打开体验」,但须真测过。与 App Store 材料 中 URL 字段交叉检查,避免 associated domain 未含邮件里的短域。
自助排错顺序
- 浏览器直连 HTTPS 看 200 与 JSON。
- Apple 官方验证工具 / Google 语句助手(名称以官方为准)。
- 真机未装 App 走浏览器、已装走 App。
- 查重定向链。
- 查备注 URL 是否 typo。