如何在iOS设备上运行Expo EAS自定义开发构建包

1. 先确认构建配置是否正确 #

打开项目根目录的eas.json，检查development构建配置，必须包含以下关键设置：

{
  "build": {
    "development": {
      "ios": {
        "developmentClient": true,
        "distribution": "internal",
        "provisioningProfile": "你的真机开发描述文件名称",
        "certificate": "你的Apple开发证书名称"
      }
    }
  }
}

• developmentClient必须设为true，这是生成支持真机的开发客户端的核心开关
• distribution选internal才能让构建包支持真机安装
• 必须配置有效的开发证书和真机开发描述文件，且描述文件里要包含你测试设备的UDID（提前在Apple开发者后台添加设备）

2. 远程构建后的真机安装步骤 #

执行eas build --profile development --platform ios远程构建完成后：

• 登录Expo Dashboard，进入对应项目的「Builds」标签页
• 找到刚完成的iOS构建任务，点击「Install」按钮，会生成适配真机的安装链接或二维码
• 用iOS设备的Safari打开链接，按提示完成安装（设备必须在描述文件的测试列表内）

3. 本地构建后的真机安装方法 #

本地构建生成的tar.gz解压后会得到.ipa文件，有两种安装路径：

• Xcode直接安装
  1. 解压tar.gz文件，取出里面的.ipa
  2. 用数据线把iOS真机连到电脑，打开Xcode
  3. 点击顶部菜单「Window → Devices and Simulators」，选中你的设备
  4. 点击窗口左下角的「+」按钮，选择解压好的.ipa，等待安装完成
• AltStore辅助安装
  1. 解压得到.ipa文件，通过AirDrop或文件APP传到iOS设备
  2. 设备上安装AltStore，电脑端安装AltServer并保持和设备的连接
  3. 在AltStore里导入该.ipa文件，按照提示完成安装

4. 常见问题排查 #

• 安装后提示「未受信任的开发者」：进入iOS设置→通用→VPN与设备管理，找到对应的开发证书，点击「信任」
• 远程构建后看不到安装选项：检查eas.json里的distribution是否设为internal，签名配置是否匹配Apple开发者后台的证书和描述文件
• 本地构建的ipa无法安装：确认描述文件已添加当前测试设备的UDID，且开发证书未过期

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