用途:在 EAS 云基础设施上运行远程 iOS 模拟器或 Android 模拟器,并从本机通过 CLI、AI 智能体(agent-device)或浏览器预览进行控制。适合无法本地运行模拟器的环境(如 Linux 主机、Cursor Cloud 等云端/后台智能体),也便于让智能体在真实设备上验证改动。不适用于本地模拟器(expo run:ios、Xcode、Android Studio)、商店构建/签名(EAS Build)或物理设备。
主要能力:simulator:availability 检查账户是否可用(只读,不创建会话);simulator:start 启动会话并写入 .env.eas-simulator;simulator:exec 加载会话环境后运行控制器命令;simulator:get 查看状态与连接信息;simulator:list 列出并分页项目会话;simulator:events 查看活动事件;simulator:stop 停止会话(幂等)。设备操作动词(open/tap/screenshot 等)由控制器提供,本技能使用 agent-device(开源 MIT,通过 npx agent-device@latest 按需运行),Appium 和 argent 为替代自动化接口,web-preview-only 无自动化接口。
使用方式:所有 eas 命令建议通过 npx --yes eas-cli@latest 运行,需已认证(交互式用 login,无头环境设置 EXPO_TOKEN,用 whoami 验证),并在 Expo 项目目录中运行。核心流程为 start → 安装应用 → 驱动 → stop。启动时始终传 --name "<描述>",名称 3–6 词、约 40 字符、句首大写、不含 id/平台/日期。安装应用需按目标选择模式:A 本地 Release 构建、B EAS 构建(仅显式要求时)、C 本地 dev 构建加隧道(默认,支持实时编辑)。
限制:EAS Simulator 为限量开放功能,并非所有账户可用,不可用时不要调用 simulator:start,应回退到本地路径。simulator:* 命令为实验性且隐藏,需 eas-cli ≥ 20.3.0,标志与动词可能变化,以子命令 --help 为准。会话按账户定价与限额计费,达到最大时长自动停止;--max-duration-minutes 上限 Free 40 分钟、付费 115 分钟;--max-idle-time-minutes 省略则无空闲超时,控制器活动会重置空闲计时,浏览器预览活动不会。.env.eas-simulator 含令牌,需加入 gitignore。命令块假设 POSIX shell,Windows 需在 WSL 或 Git Bash 中运行。webPreviewUrl 仅供用户浏览器打开,不可在模拟器上打开。Android 支持仍在开发中,部分 iOS 功能可能不可用。具体价格与条款见 https://expo.dev/pricing。