# 电脑通过手机调试 S2 真机

入口工程：[phone-debug-bridge](../phone-debug-bridge/README.md)。它是安装到 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 尚未通过；常亮只证明本次短时前台调试。详情见[补测记录](../docs/VALIDATION.md)。电脑新增 `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 日志、探针页面和点击仍需各自证据。最终范围见 [本轮记录](VALIDATION.md)。

修复安装目的路径为 `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](../com.sydxky.rtos.deviceprobe/README.md) 用于验证链路。最短复现命令、构建工具、接口边界和后续验收都在手机工程 README；实际通过与未通过项见 [验收记录](VALIDATION.md)。

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