如何使用Expo EAS生成iOS IPA文件并安装到实体iPhone测试

一、前置准备 #

• 完成EAS初始化：执行eas login登录Expo账号，eas build:configure初始化项目的EAS配置
• 拥有Apple开发者账号：需加入Apple Developer Program，且将测试用iPhone的UDID添加到开发者账号的设备列表中
• 实体iPhone设备：确保设备处于可用状态，且已在Apple开发者后台注册

二、生成IPA文件 #

1. 调整EAS配置（详见下文修改说明）
2. 执行对应构建命令：
   • 开发测试（带热重载的开发客户端）：eas build --platform ios --profile development
   • 预发布测试：eas build --platform ios --profile preview
3. 构建完成后，可在Expo控制台下载生成的IPA文件

三、安装IPA到实体iPhone #

• 方式1：通过Expo分发链接安装
  构建完成后，Expo会生成专属安装链接，用iPhone的Safari打开链接，按照页面提示即可完成安装（需确保设备已在开发者账号中注册）
• 方式2：通过Xcode安装
  下载IPA文件后，打开Xcode，进入Window > Devices and Simulators，连接iPhone设备，点击界面中的+按钮，选择下载的IPA文件，等待安装完成

四、EAS配置文件修改说明 #

你的当前配置如下：

{
  "cli": {
    "version": ">= 10.1.1"
  },
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal"
    },
    "preview": {
      "distribution": "internal"
    },
    "production": {}
  },
  "submit": {
    "production": {}
  }
}

需要调整的配置项： #

• development配置（开发测试用）：
  现有配置已支持生成开发版IPA，若需明确指定实体设备构建，可添加iOS专属配置：

  "development": {
    "developmentClient": true,
    "distribution": "internal",
    "ios": {
      "simulator": false, // 强制构建实体设备版本，避免生成模拟器包
      // 可选：若需自定义描述文件，可添加provisioningProfile字段，值为描述文件名称或UUID
    }
  }
  

• preview配置（预发布测试用）：
  添加iOS配置确保生成实体设备可用的IPA：

  "preview": {
    "distribution": "internal",
    "ios": {
      "simulator": false,
      "buildConfiguration": "Release" // 明确构建Release版本，适配预发布测试场景
    }
  }
  

• production配置（生产环境）：
  根据分发需求设置distribution类型，同时指定实体设备构建：

  "production": {
    "ios": {
      "distribution": "store", // 若提交App Store用此值；内部生产测试用"ad-hoc"
      "simulator": false
    }
  }
  

关键注意点： #

• simulator: false是核心配置，必须设置，否则生成的包无法安装到实体iPhone
• distribution字段决定分发方式：internal对应Expo内部分发，ad-hoc对应Apple Ad Hoc分发，store对应App Store提交
• 确保Expo控制台已关联你的Apple开发者账号，EAS会自动处理签名和描述文件，无需手动操作（特殊需求除外）

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