立项背景:移动 App 的回归测试和日常巡检需要在多台 Android 真机上反复执行安装、启动、点击、输入和断言。手机端群控方案通常要在每台设备安装 App 甚至获取 Root 权限,存在隐私与合规风险;云真机平台按设备计费,内网机型覆盖也有限。本项目做一款运行在 Windows 的本地控制台,只通过 ADB 与 Appium 控制已授权真机,不安装手机端程序、不依赖云端,目标是让测试人员在一台电脑上完成多设备管理、批量操作、实时控制和自动化用例录制回放。
核心功能:1)设备管理:自动发现在线、离线、未授权设备,展示型号、Android 版本、分辨率和电量;2)无线调试:USB 已授权设备一键切换无线调试,Android 11+ 通过 mDNS 发现配对服务,只需输入手机显示的 6 位配对码,已验证端点按退避策略自动重连;3)批量控制:按全部设备或分组安装、启动、停止应用,发送 Home/Back 等系统按键,以及点击、滑动、长按、ASCII 输入、截图和日志采集;4)实时控制:左侧主控画面加右侧自适应观察网格,观察设备可逐台设为跟随主控或只读,跟随设备的操作与主控同批并发下发,并按各机方向和系统栏做安全区坐标映射,条件不满足时整批拦截;5)自动化测试:用例支持启动应用、Home/Back、点击、滑动、等待控件、控件输入和存在/文本断言,可在实时窗口录制电脑端操作,自动转成 Resource ID、Accessibility ID、精确文本或序号 XPath 定位;6)执行与产物:跨设备并发、单设备严格顺序,单台失败不影响其他设备,失败自动保存截图、日志和逐台步骤结果,支持仅重试失败设备。
功能路径:检查依赖状态 → 连接并授权设备 → 勾选设备或分组 → 批量操作、实时控制或自动化工作台 → 录制/编辑用例 → 选择设备运行 → 查看逐台结果与产物 → 重试失败设备。
整体架构:核心层与桌面层分离。MobileAutoControl.Core(.NET 10)不依赖 UI,封装设备发现、ADB 执行与解析、文本输入、Appium 会话、坐标映射、预览抓帧、命令调度、用例执行和 SQLite 持久化,以接口形式对外暴露;MobileAutoControl.App(WPF,.NET 10)基于 CommunityToolkit.Mvvm 和依赖注入,包含主控制台、无线调试、实时控制、自动化测试四个窗口及危险操作二次确认。测试基于 xUnit,覆盖解析、映射、调度、录制与执行逻辑。
各模块技术栈:设备层用 ADB Server 管理和 mDNS 发现,做版本校验与序列号规范化;控件自动化用 Appium.WebDriver + UiAutomator2,按设备维护会话并自动重建;实时预览用 ADB screencap、缓冲池和 latest-wins 队列,主控约 500ms 刷新、最多 3 路并发抓帧,观察设备按数量降频;调度层做跨设备并发、单设备串行、取消与超时;持久化用 Microsoft.Data.Sqlite,命令先落库再按单调状态推进,异常退出后启动时把遗留记录标记为中断取消;发布为 Windows x64 自包含单文件包,脚本安装并校验固定版本 JDK、Platform-Tools、Appium 与 UiAutomator2,构建启用锁文件和确定性输出。
我负责整体架构、核心层与 WPF 桌面端、测试与发布脚本。结果:源码约 1.5 万行 C#/XAML、117 个源文件,配套 48 个测试文件、261 个单元/集成测试方法;面向 20 台级设备并发场景设计,主控预览约 500ms 刷新、抓帧并发 3 路,启动恢复最近 200 条操作记录;发布包目标机无需安装 .NET。
主要难点与解决:1)ADB input text 会改写空格和特殊字符,改为空格单独发按键、ASCII 原文透传,非 ASCII 提前拦截并引导用 Appium 控件输入;2)不同设备分辨率、横竖屏和系统栏不一致,按各机内容区做坐标映射,任一跟随设备系统栏读不到或画面未就绪即整批拦截;3)多机同时截图拖垮 ADB、USB 与界面,用 latest-wins 队列、并发上限、观察端降频和缓冲复用;4)异常退出留下永久排队记录,改为先落库、状态单调推进、启动修复中断记录,并加超时上限;5)控件重复导致定位歧义,优先唯一属性,重复时退化为序号 XPath 并提示补断言,无法解析才存坐标并标记回退;6)工具链版本漂移导致启动失败,锁定版本、SHA-256 校验和只读验证,并核验 5037 端口实际运行的 ADB Server。