SuperAPI AI 工具集

universal-links

测试与质量

查看项目

更新于 10-15 21:39

技能介绍

用途:在 iOS 上配置并测试 Universal Links(通用链接/深度链接),核心工具为 setup-safari。

主要能力:自动完成 Apple 开发者门户认证、为 bundle ID 启用 Associated Domains,并输出 AASA 文件内容与 meta 标签。

使用方式:自动化设置运行 EXPO_APPLE_ID="your-apple-id@email.com" bunx setup-safari;交互模式运行 bunx setup-safari。之后需手动创建 public/.well-known/apple-app-site-association(无扩展名),创建 src/app/+html.tsx 加入 Smart App Banner,在 app.json 的 ios.associatedDomains 添加 applinks 等条目,再部署并重建:npx expo export -p web && npx eas-cli deploy,npx expo run:ios 或 npx testflight。

测试:npx setup-safari,或在 Safari 打开应唤起应用的 URL。无服务器时可用隧道:export EXPO_TUNNEL_SUBDOMAIN=my-app-name,associatedDomains 配 applinks:my-app-name.ngrok.io,npx expo run:ios,npx expo start --tunnel。

调试:curl "https://app-site-association.cdn-apple.com/a/v1/yourdomain.com" 检查缓存;curl https://yourdomain.com/.well-known/apple-app-site-association | jq 校验格式。

限制:自定义域名的 Universal Links 需要自定义原生构建,无法在 Expo Go 中使用;Expo Go 仅支持 exp:// 与 Expo 托管 URL。AASA 须以 Content-Type: application/json 提供、必须 HTTPS,且 Apple 会缓存 AASA,变更传播可能延迟。Expo Router 可自动处理传入链接。