You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Expo iOS应用通用链接的配置与测试咨询

Expo iOS应用通用链接的配置与测试咨询

嘿,我来帮你梳理下Expo iOS通用链接的配置细节和后续测试、排查要点,确保你能顺利搞定~

首先,先确认你app.config.js里的通用链接相关配置是不是补全了,你刚才贴的内容里还缺了关键的associatedDomains字段,完整的配置应该是这样的:

ios: {
  supportsTablet: true,
  bundleIdentifier: "com.jarnerolf.motomeet",
  associatedDomains: ["applinks:motomeet.app"], // 格式必须是applinks:你的域名,注意不要加www前缀或者http/https
  infoPlist: {
    NSLocationWhenInUseUsageDescription: "This app needs..." // 你的位置权限描述可以继续补全
  }
}

然后是你已经上传的AASA文件,得确保它的格式和内容完全符合苹果的要求,这里给你一个标准的参考结构:

{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "你的团队ID.com.jarnerolf.motomeet", // 这里要注意,是苹果开发者后台的团队ID加上你的bundle id,很多人容易漏了团队ID
        "paths": ["*"] // 这里可以配置具体的路径规则,比如["/events/*", "/profile"],*表示匹配所有路径
      }
    ]
  }
}

另外,AASA文件的服务器配置也有几个关键点要注意:

  • 必须放在/.well-known/目录下,文件名就是apple-app-site-association,不能加.json后缀
  • 服务器必须支持HTTPS,而且证书是苹果信任的正规证书,不能用自签名的
  • 访问这个文件时,服务器返回的MIME类型必须是application/json,苹果会验证这一点

接下来是Expo项目的操作步骤:

  • 配置完app.config.js后,必须重新构建自定义开发客户端(如果你用的是开发环境测试),或者构建生产包(TestFlight/Ad Hoc),因为associatedDomains是原生配置,Expo Go是不支持通用链接测试的,只能用自定义客户端或正式包。

然后是测试和排查方法:

  • 先验证AASA文件的有效性:可以用苹果开发者后台的官方验证工具来检查文件是否符合格式要求
  • 设备端测试:把你的域名链接(比如motomeet.app/test)复制到iOS的备忘录里,点击链接看是否直接打开你的App;也可以通过短信发送链接测试,不要在Safari里直接输入,因为Safari会优先打开网页,需要从其他应用跳转触发
  • 如果测试没生效,可以从这些点排查:
    • 确认设备上已经安装了你的App,通用链接只有App已安装时才会触发
    • 检查AASA文件里的appID是否正确,团队ID要和苹果开发者后台里的一致
    • 查看Xcode的设备日志:连接设备到Xcode,打开控制台,搜索“swcd”关键词,能看到苹果获取AASA文件的过程和可能的错误信息,比如文件下载失败、格式错误等
    • 重启设备试试,有时候苹果缓存了旧的配置,重启后会重新获取AASA文件

内容来源于stack exchange

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.04.08 13:09:35