SuperAPI AI 工具集

mobile-app-flows

测试与质量

查看项目

更新于 10-15 20:05

技能介绍

用途:该技能帮助理解 Omi Flutter 移动应用的导航结构、屏幕架构与 widget 模式,用于开发功能、定位缺陷屏幕或验证改动在真实应用中的效果。

主要能力:通过 agent-flutter CLI 与运行中的应用交互,可点击 widget、读取 widget 树并截图,底层使用 Flutter 的 Marionette 调试协议。支持 snapshot、press、find、fill、scroll、back、screenshot 等命令,并给出底部导航栏、设置齿轮、设置行、开关、底部弹层选择器等 widget 的识别模式。

使用方式:需先启动模拟器(adb devices 应显示 emulator-5554),将系统语言设为英文(非英文输入法会破坏 fill 命令),以 debug 模式运行应用并捕获 flutter run 输出,再执行 AGENT_FLUTTER_LOG=/tmp/omi-flutter.log agent-flutter connect 连接。常用命令包括 agent-flutter snapshot -i --json、press @ref、find type X press、fill @ref "text"、scroll down、back、screenshot PATH。

适用场景:开发新功能时了解应用工作方式、修复缺陷时导航到受影响屏幕、验证代码在实时应用中的表现。

限制:需要 AVD omi-dev、KVM 访问、应用包 com.friend.ios.dev(dev flavor)、系统语言为英文、应用已认证并连接正确后端,且 pubspec.yaml 中已集成 marionette_flutter: ^0.3.0。refs 易失效,每次交互前应重新 snapshot;find type X 比硬编码 @ref 更稳定;AGENT_FLUTTER_LOG 必须指向 flutter run 输出而非 logcat;热重启后需 disconnect、等待 3 秒再 connect。部分前置条件(如 BLE、真实手机号验证)需要物理设备,模拟器不支持。