文件
rtos-watch-debug-bridge/docs/ARCHITECTURE.md
T

4.4 KiB

电脑通过手机调试 S2 真机

入口工程:phone-debug-bridge。它是安装到 Android 手机的调试 APK,包名 com.sydxky.rtos.bridge;RTOS 手表应用仍使用 Glyphix bundle.pkg。

2026-11-14 更新

后续“尝试打通”补测:保留配对数据重启健康并等待重连后,取得 OWW265 / runtime 0.8.0-5 / nucleus 0.8.0-229 / 手表 MAS 2006005。0.2.0 APK 的安装/检查/启动请求恢复成功。探针 1.0.3 只请求 setKeepScreenOn,静置实测失败;1.0.4 增加 wakeScreenOn 前台 15 秒续期后,静置至少 159 秒仍显示探针,用户确认实体屏幕仍亮。手动点击后的官方截图显示计数 0→1。远程 launch 后仍可能停在表盘,前台调起、READY/TAP 日志、通用远程输入与真机 Inspector 尚未通过;常亮只证明本次短时前台调试。详情见补测记录。电脑新增 wait-link,避免把 Binder 刚绑定误作手表已经连上。

后续实测使用已授权网络 ADB YOUR_PHONE_SERIAL(已核验为同一 P30PRO),可替换示例 USB 序列号;先用 adb devices -l 确认当前目标,地址可能变化。退出探针释放调试常亮。源码、圆/方构建、5 项常亮生命周期回归、模拟器 UI、实体手动触摸和实体短时亮屏分别记录。

工程已升级为 0.2.0 / 3,提供 APK 图片预览与圆屏安全区检查,以及电脑 ui.py 的截图、控件检查、点击、滑动和步骤报告。目标必须显式选择 phone、watch-health、watch-import 或 inspector;具体支持范围见工程 README。圆/方原生模拟器已验证 Inspector 截图、文字断言、按钮点击和步骤报告;S2 通用操控与 Inspector 隧道尚未确认。

0.2.0 / 3 已实际安装到 P30PRO,回读 APK SHA-256 与交付包一致;手机新界面的 SAF 导入、预览、安全区辅助线和电脑 PNG 导出通过。电脑已能自动导航官方健康界面并导出 S2 的 480×464 JPEG 表盘截图。该分辨率与 JPEG 格式来自实际公开文件,脚本支持健康添加的同名编号。

此前 0.1.1 已通过电脑认证回环接口绑定 com.heytap.health,检测到 Wear Engine 2006006 / 263,手表连接查询为 true;厂商设备信息、日志开关、探针安装和启动返回成功。设备信息内容为空,探针 READY 日志、探针页面和点击仍需各自证据。最终范围见 本轮记录。

修复安装目的路径为 remote://mass/...pkg,解决此前只传文件名导致的 4008 rename remote file failed;263 的信息、检查、启动和连接订阅使用手机包名,安装使用 appId。P30PRO 遇到 bind_rejected 时先打开已配对的运动健康,再重新连接;不修改 authentication_state 或配对数据。

后续从 phone-debug-bridge 运行 bridge.py --serial YOUR_PHONE_SERIAL setup、connect、link;安装/启动、日志命令和 verify.py 详见工程 README。手机 APK 是 Android Debug 签名的本地开发工具,未作为上架包发布。

2026-11-13 历史检查

用户于 2026-11-13 表示:P30PRO 已在运动健康配对 S2。电脑 ADB 当前确认手机为 YOUR_PHONE_SERIAL / VOG-AL00 / Android API 29。发现 com.heytap.health 中的 com.glyphix.mas.service.WearEngineService,Action com.xfaith.glyphix.WEAR_ENGINE_ACTION,exported=true、无绑定权限要求。开始检查时健康版本为 6.9.37(6093700);结束前再次查询已为 6.10.15_9e2a81e_261107(6101500),后续测试须以手机当时实际版本为准。

电脑调用 Python CLI → USB ADB 端口转发 → 手机回环认证 API → bindService / Binder → 运动健康负责传输 → S2。无需给 RTOS 手表打开 Android ADB。

手机工程提供服务发现、262 / 263 协议选择、设备信息、应用检查 / 安装 / 启动、消息 / 文件、RPC 日志和异步作业查询。另有独立 deviceprobe 用于验证链路。最短复现命令、构建工具、接口边界和后续验收都在手机工程 README;实际通过与未通过项见 验收记录。

注意区分:用户已配对、电脑已识别手机、手机 Binder 已绑定、手表在线、包安装成功、页面运行、人工触摸与显示,以及平台上架,分别需要各自证据。参考仓库针对 Watch S / OWW262 的成功记录不替代 S2 结果。