iOS模拟器自动化

技能简介

ATL-Mobile 通过 HTTP 接口为 iOS 模拟器提供自动化能力，覆盖移动 Safari 浏览器和原生应用两种场景。基于 ATL（Agent Touch Layer）框架，支持页面导航、元素点击、截图捕获等操作。

业务背景

iOS模拟器自动化让测试团队无需真机即可验证移动端体验。业务人员可自动操控Safari浏览器完成网页流程测试，也能直接打开设置、日历等原生应用进行功能验证。通过截图比对和元素定位，快速发现UI异常，降低人工测试成本，加速App上线前的质量把关。

落地案例：某电商团队需验证促销页在iPhone上的兼容性。测试人员启动ATL-Mobile服务后，向9222端口发送指令：先goto打开活动页面，再clickMark点击领券按钮，最后捕获截图核对弹窗样式。同一脚本还能调用9223端口打开系统设置，检查深色模式下的显示效果，全程无需准备多台实体设备。

能做什么

• 在 iPhone/iPad 模拟器中自动浏览网页并执行 DOM 操作
• 打开、关闭任意 iOS 原生应用（设置、通讯录、日历等）
• 基于无障碍树定位元素并执行点击、滑动手势
• 获取屏幕截图用于验证或调试
• 同时运行浏览器和原生两套独立服务，互不干扰

使用说明

前置依赖：macOS 系统，已安装 Xcode 命令行工具（xcrun、xcodebuild）。

安装步骤：

1. 克隆 ATL 仓库：git clone https://github.com/JordanCoin/Atl ~/Atl
2. 执行安装脚本：~/.openclaw/skills/atl-browser/scripts/setup.sh

启动服务：

• 浏览器服务（端口 9222）：xcrun simctl launch booted com.atl.browser
• 原生服务（端口 9223）：需进入 ~/Atl/core/AtlBrowser 目录执行 xcodebuild UI Test 命令启动

验证连接：curl http://localhost:9222/ping 或 curl http://localhost:9223/ping

输入与输出

见下方输入与输出表格。

风险提示

• 仅支持 iOS 模拟器，无法操作真机设备
• 原生服务需以 UI Test 模式运行，占用额外系统资源
• 模拟器 UDID 随实例变化，脚本中需动态获取
• 无障碍树结构因 iOS 版本不同可能存在差异
• 同时启动双服务时注意端口冲突问题

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/jordancoin/atl-mobile/SKILL.md
来源类型：GitHub 仓库