说明:浏览器受 CORS 限制,本工具通过公共代理拉取 AASA 文件进行检查。请勿输入敏感内部地址;AASA 本身应为公开可访问文件。
- 将文件部署到 `https://<domain>/.well-known/apple-app-site-association`(推荐)或 `https://<domain>/apple-app-site-association`。
- 文件必须无扩展名(不要 `.json`),并确保 HTTPS 可访问且返回 200。
- 建议 `Content-Type: application/json`(签名文件可能为 `application/pkcs7-mime`)。
- 典型结构:`applinks.apps` 为 `[]`,`applinks.details` 中配置 `appID` 与 `paths`/`components`。
- 在 Xcode 的 Associated Domains 中添加:`applinks:your-domain.com`(按需包含子域)。
- 确保 `appID` 正确:`<TeamID>.<BundleID>`,且与打包签名一致。
- 安装 App 后,用 Safari/备忘录/短信等入口点击链接测试。
- 路径/文件名错误(少了 `.well-known` 或多了 `.json`)。
- 跳转/鉴权/WAF 导致拿到 HTML。
- AASA JSON 结构不合法:缺少 `applinks.details[].appID` 或缺少 `paths/components`。
- iOS 有缓存:更新后生效可能延迟。
- Apple 官方 CDN 可能存在缓存延迟:`app-site-association.cdn-apple.com` 返回的内容不一定实时。
如何使用
- 在“域名 / 站点地址”输入框中填写您的 App 关联域名(例如 example.com)。
- 选择 AASA 文件来源(默认 .well-known 路径),点击“获取并校验”按钮。
- 查看“检查结果”区域,确认 HTTP 状态、Content-Type 及 JSON 格式是否正确。
- 在“Universal Links 匹配测试”区域输入具体 URL,测试是否命中 AASA 规则。
小贴士
本工具通过公共代理获取文件,以绕过浏览器 CORS 限制。
AASA 文件必须通过 HTTPS 访问,且不应有 .json 后缀。
iOS 验证 Universal Links 时会优先请求 /.well-known/apple-app-site-association。
如需测试未部署的内容,可选择“手动粘贴”模式进行规则校验。