This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

通过 CLI、REST API、AI agent 或浏览器，在 EAS 基础设施上运行和控制远程 iOS Simulators 和 Android Emulators。

重要 EAS Simulator 是一项访问受限的预览功能。 它不包含在付费或免费套餐中，目前仅向部分合作伙伴开放。如果你有兴趣试用，请加入候补名单。

EAS Simulator 可在 EAS 基础设施上运行远程 iOS Simulator 或 Android Emulator。你可以安装应用、检查其用户界面并与之交互。你还可以收集屏幕截图和录屏，或分享 iOS 浏览器预览，而无需在本地运行设备。

EAS Simulator 专为代理式开发而构建。它为编码代理提供真实的设备运行时，用于验证代理编写的代码。代理可以修复其发现的问题，并从正在运行的应用中返回证据。

以下情况尤其适合使用 EAS Simulator：

• 后台或云端编码代理需要访问其沙盒中不可用的设备
• AI 代理需要在运行中的应用中验证更改，而不只是检查源代码
• 你希望获得一个临时且可共享的 iOS 浏览器预览
• 你需要卸载模拟器计算任务，或在远程平台上进行测试

注意 对于需要访问 iOS Simulator 的 Linux 或 Windows 开发者，或者本地资源受限、希望将设备运行时卸载到 EAS 以简化设置的情况，EAS Simulator 同样非常有用。

如果你已经具备所需的本地设备运行时，EAS Simulator 不会取代本地 Xcode 或 Android Studio 工作流。请在需要远程或可共享访问时使用它。

使用 EAS 模拟器与编码代理

对于代理式开发，请从官方 EAS Simulator 技能开始。让你的编码代理使用该技能，而不是向它提供单独的 EAS CLI 和控制器命令。该技能涵盖访问权限检查、构建准备、会话命名和限制、远程会话、控制器工作流、证据收集和清理。

然后，代理即可完成运行时循环：

1. 实现或修复代码。
2. 检查 EAS 模拟器访问权限，并准备兼容的应用构建。
3. 启动远程设备，并通过 agent-device 或 Argent 驱动应用。
4. 检查结果，如有需要则进行迭代。
5. 返回屏幕截图、录制内容、日志或其他证据，并停止会话。

典型设置：Cursor 云代理

一种常见设置是使用 Cursor 云代理 或其他在云项目检出目录中运行的后台编码代理。该环境可以编辑和构建项目，但无法启动本地 iOS 模拟器。借助 EAS 模拟器技能，代理可以在 EAS 上启动远程设备，并通过 agent-device 或 Argent 对其进行控制。随后，它会将结果返回到任务或拉取请求中，而您的计算机无需承载模拟器。

工作原理

EAS 模拟器工作流分为四个阶段：

1. 使用 EAS CLI、REST API 或经过身份验证的创建会话链接启动会话。 为会话指定一个描述性名称，选择远程设备和会话类型，还可以设置自动时长或闲置时限。
2. 安装应用。 在启动命令中传入 EAS Build、应用归档 URL 或 Expo Go；也可以在会话启动后通过控制器安装本地构建。不提供应用来源的会话将以空白设备启动。
3. 驱动设备。 使用 agent-device、Argent 或 Appium 进行程序化控制。受支持的 iOS 会话还包括网页预览。
4. 停止会话。 完成后显式停止会话。无人值守的非交互式会话会继续消耗用量，直到停止或达到配置的限制。

EAS CLI 管理会话生命周期和连接配置。使用 REST API 可通过你自己的 HTTP 客户端管理会话。控制器提供设备操作，例如打开应用、按下按钮、输入文本、检查无障碍树以及截取屏幕截图。

可用平台

使用 EAS Build 创建可安装的构建，并使用本地设备工具处理物理设备。

后续步骤