App Store / Google Play · 清单验收 · 不承诺过审Telegram @hagee66

上架通

GOEE LISTING LEDGER

№ ZHgoee.cc
账号归你 · 邀请协作


2026-04-11

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 字段以官方当前页面为准。

常见误区

  1. staging 域与生产域混在一个 entitlement。
  2. AASA 缓存未刷新就提审(Apple CDN 有延迟)。
  3. 短链跳转丢失 Universal Link 上下文。
  4. 在 WebView 里点自己的域却不走关联。
  5. 备注给 HTTP 非 HTTPS 链。
  6. 欺骗审核用仅内网可解析的域名。

提交前核对(上架执行)

把深度链接当作与登录并列的「可演示契约」:备注里写的 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 未含邮件里的短域。

自助排错顺序

  1. 浏览器直连 HTTPS 看 200 与 JSON。
  2. Apple 官方验证工具 / Google 语句助手(名称以官方为准)。
  3. 真机未装 App 走浏览器、已装走 App。
  4. 查重定向链。
  5. 查备注 URL 是否 typo。

下一步

深链行写入 预检评分表。Telegram @hagee66。不承诺过审;按清单验收链接与备注可复现。

返回 指南库 · 苹果上架 · 谷歌上架