用途:在 macOS 上构建、测试和自动化 iOS 应用,用无障碍树的结构化数据替代像素坐标进行导航,提升可靠性与 token 效率。
主要能力:共 21 个脚本,分为四类。构建与开发:build_and_test.py 构建 Xcode 项目并解析 xcresult 结果,log_monitor.py 实时过滤日志。导航与交互:screen_mapper.py 列出可交互元素,navigator.py 按文本/类型/无障碍 ID 查找并点击或输入,gesture.py 执行滑动、滚动、捏合、长按、下拉刷新,keyboard.py 输入文本与硬件按键,app_launcher.py 管理应用生命周期与深链。测试与分析:accessibility_audit.py 检查 WCAG 合规,visual_diff.py 截图对比,test_recorder.py 记录测试步骤,app_state_capture.py 生成调试快照,sim_health_check.sh 检查环境。高级测试与权限:clipboard.py、status_bar.py、push_notification.py、privacy_manager.py。设备生命周期:simctl_boot/shutdown/create/delete/erase 五个脚本。
使用方式:先运行 bash scripts/sim_health_check.sh 检查环境,再用 python scripts/app_launcher.py --launch com.example.app 启动应用,随后用 screen_mapper.py 映射屏幕、navigator.py 交互。所有脚本支持 --help 与 --json。多数脚本在未提供 --udid 时自动检测已启动模拟器,支持设备名解析与批量操作。
适用场景:iOS 应用自动化测试、无障碍审计、CI/CD 集成、UI 变更验证与调试。
限制:需 macOS 12+、Xcode 命令行工具与 Python 3,IDB 为可选依赖。截图消耗 token 较多,建议优先使用无障碍树。具体收费与价格暂未提供。