SuperAPI AI 工具集

argent-ios-device-interact

通用与其它

查看项目

更新于 10-16 09:30

技能介绍

用途:该技能用于通过 argent 驱动一台实体 iPhone。仅当列表中出现的 iOS 条目类型为 device(真机)时使用,模拟器场景不适用;除真机特有的限制外,其余规则仍遵循 argent-device-interact。

主要能力:真机仅支持以下工具:list-devices、launch-app、restart-app、reinstall-app、open-url、describe、screenshot、screenshot-diff、gesture-tap、gesture-swipe、gesture-custom、button(home、volumeUp、volumeDown,以及部分机型的 actionButton)、keyboard、await-ui-element、await-screen-idle、run-sequence、flow 系列工具,以及会话结束时使用的 stop-simulator-server 和 stop-all-simulator-servers。其他设备工具在真机上会报 not supported on ios device。不支持双指手势、旋转、摇一摇、粘贴、设置权限、录屏、调试与性能分析类工具(debugger-、react-profiler-、native-profiler-、native-、boot-device)。

使用要点:观察类操作不改变屏幕,变更类操作可能改变屏幕。describe 与 await-ui-element 在目标被切到后台时会失败而不会重新前置;await-screen-idle 返回 settled: false 且无原因。按下 home 后一秒内的首次 describe 可能仍返回旧树,需再次 describe。手势和键盘操作会将目标重新前置并返回 reactivated: true,下一步前应重新 describe。launch-app、open-url、restart-app 会设置被自动化应用,reinstall-app 会清除该设置,工具服务器重启后同样会遗忘,需要重新 launch。gesture-swipe 的 durationMs 控制拖动速度而非时长;momentum:false 仅在结束时停顿 300 毫秒,不做阻尼。open-url 使用 https 会进入 Safari,而不会进入拥有该链接的应用,需传入 bundleId。每个工具自身描述会说明其硬件限制(命名按键、gesture-custom 形状、按钮、边缘滑动、点击次数等),受门控的工具只报 not supported on ios device,解决办法在上述清单中,而非错误信息里。

适用场景:需要在上层以自动化方式操作真实 iPhone 应用的流程、测试或脚本。

限制:功能范围受上述真机工具集约束;缺失的能力(如双指手势、旋转、权限修改、录屏、真机调试与性能分析)需改用模拟器或手动在手机设置中完成。资料未提供价格、平台与安装命令等信息。