如何在Expo中使用universal links并在本地开发阶段高效测试

前置已验证配置：服务器/.well-known/apple-app-site-association路径返回内容正确，生产环境app.json中associatedDomains字段配置可正常支撑线上Universal Link跳转逻辑，无需调整。

具体操作步骤 #

• 第一步：在eas.json开发构建配置中注入关联域环境变量，强制开发客户端读取关联域配置
  若还未创建eas.json可先执行eas init初始化，找到build.development配置项，新增如下内容：

  "env": {
    "EXPO_ASSOCIATED_DOMAIN": "applinks:你的业务域名.com"
  }
  

• 第二步：修改app.json的关联域配置，适配环境变量读取
  将原本写死的associatedDomains字段修改为：

  "associatedDomains": [process.env.EXPO_ASSOCIATED_DOMAIN]
  

• 第三步：本地编译一次带关联域配置的Expo开发客户端
  执行命令 eas build --profile development --platform ios --local，本地编译完成后将构建产物安装到iOS测试真机/模拟器即可，该客户端完整保留热重载能力，仅修改关联域配置时才需要重新编译
• 第四步：本地测试Universal Link
  • iOS模拟器测试：直接在终端执行命令 xcrun simctl openurl booted 你的测试链接（比如https://你的业务域名.com/login?xxx） 即可直接触发跳转
  • 真机测试：将测试链接发送到备忘录/自带邮件应用中点击，即可跳转到开发客户端内
• 后续开发过程中，直接正常调试链接跳转后的登录逻辑即可，热重载完全生效，不需要重复打包。

内容的提问来源于stack exchange，提问作者Ethan McCue