說明:瀏覽器受 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`。
如需測試尚未部署的內容,可使用「手動貼上」模式進行規則驗證。