iOS / Android / 移动开发

AASA 验证看清首先命中的规则

粘贴关联文件和多条测试 URL,可选择 App ID;报告显示每条 URL 的决定规则,不会请求域名。

AASA 验证

输入

报告

修改示例后再验证。

验证只在当前浏览器标签页运行,不会请求粘贴的域名或 URL。

选项

留空可查看文件声明的全部 App ID;填写时须完全一致。

修改示例后再验证。

准备发布关联文件,或同域名只有部分链接能唤起 App 时,AASA 验证能在上线前指出是哪个有序规则命中了 URL。单纯检查 JSON 语法无法解释排除规则为何失效。 AASA 文件检查会保留具体路径,便于上线前复核。

这份 AASA 验证结果来自你粘贴的文本。它展示 App ID 和具体规则,同时把服务器响应、Apple CDN 缓存与真机点按留在部署清单中,避免把本地模拟当作设备结论。

为什么先做 AASA 验证

在部署前区分三种结果

AASA 验证把多条 URL 送进同一组规则,分别标出允许、排除和未命中;无需先上传文件,就能发现路径范围写错。

本地规则文件分流出允许、排除和未命中的 URL,旁边的云端保持断开。

找出被通配规则遮住的排除项

若靠前的通配规则先命中,后面的排除项不会执行。AASA 验证会显示决定性的规则序号,并提示明显不可达的后续规则。

上方的宽泛规则先接住路径,下方的排除规则因顺序靠后而无法生效。

按规则轨迹读报告,不把它当真机测试

01

保留完整关联对象

粘贴含 applinks.details 的完整 JSON。示例使用现代 appIDs 与 components;旧式 appID 与 paths 也支持。语法出错时查看行列位置。

  • 用示例比较普通路径、排除路径和带查询参数的规则。
02

选定 URL 与 App ID

每行输入一条 HTTPS URL 或以斜杠开头的路径。App ID 留空会显示全部已声明应用;任何输入变化都会让旧报告过期。 路径匹配测试不会发出网络请求。

  • 按 Ctrl/Cmd + Enter 手动运行;输入的 URL 不会被访问。
03

核对首条决定规则

查看每条结果的 details 与规则序号,再导出报告。绿色命中只表示粘贴规则选中了某个 App,部署清单仍全部标记未检测。

  • 只有最新报告可复制或下载,输入变动后需要重新验证。

逐条解释 URL 与 App 的匹配结果

同时检查新旧规则

现代 components 会比较路径、查询和片段;旧式 paths 按顺序处理 NOT 排除。Universal Links 验证不会把两套语法混成同一种。

按 App ID 分开判断

可对文件中的所有应用运行同一批 URL,也可精确选择一个 App ID。未声明的标识与已声明但未命中的路径会分开报告。

保留可复核的证据

AASA 验证报告包含结构问题、输入行号、命中的规则序号和部署清单,便于和发布记录一起复查。

本地结论能覆盖到哪里

规则命中不等于线上通过
AASA 验证不会抓取域名,因此不能证明 TLS、跳转、Content-Type、公开访问或 Apple CDN 缓存正常;这些项目始终标为未检测。
未知语法不给假阴性
若使用 substitutionVariables、混合新旧格式或未支持的组件键,报告会标记无法判定,而不会跳过后说未命中。
文件不能证明 App 签名
JSON 中的 Team ID 和 Bundle ID 形状可以检查,但 AASA 验证看不到安装包的签名 entitlement、用户偏好和 Safari 导航状态。
其他服务不在检查范围
webcredentials、appclips 和 Android assetlinks.json 不参与本页校验;即使 applinks 没问题,也不能据此宣布整个文件都合格。

关于 AASA 验证的常见排错问题

AASA 文件格式正确,为什么链接仍在 Safari 打开?

本地 AASA 验证只能说明粘贴规则是否包含 URL。线上文件、CDN、Associated Domains、安装状态和点按入口都会影响 iOS;请继续完成部署清单并在真机测试。

不构建 App,怎么测试 Universal Link 路径?

粘贴关联 JSON 和多条 HTTPS URL,即可查看首先命中的 components 或 paths 规则与排除结果。这是规则模拟,不是 App 启动测试。

AASA 的 paths 和 components 可以都用吗?

旧式条目用 appID 与 paths,现代条目可用 appIDs 与 components。工具分别支持两种条目;同一条目混用时会提示结构问题,结果无法判定。

排除规则写了为什么仍被前面的规则命中?

数组按顺序处理,靠前的宽泛允许规则可能先获胜。把排除项移到通配项之前,再用相同 URL 复测。

AASA 验证能检查 Apple CDN 缓存吗?

不能。本页不发网络请求,只对粘贴内容作本地判断。部署后需单独检查 CDN 副本和设备,清单不会伪称已通过。

规则仍有疑问?

发布前先做 AASA 验证

把真实 URL 和目标 App ID 一起测试,再将未检测的部署项交给发布验收。