feat(rtos): 安装前补传PNG图标并等待成功回调

README.md

@@ -4,12 +4,22 @@
 
 **源码公开 · PolyForm Noncommercial 1.0.0 · 仅限许可允许的非商业用途。** 商业用途须另获许可。完整条款见 [LICENSE](LICENSE)，版权及第三方条款见 [NOTICE.md](NOTICE.md)。
 
-当前工具包发布：**0.2.1（机型范围与文档修订）**；手机桥仍为 **0.2.0 / versionCode 3**，配套探针 **1.0.4 / 10004**。这是开发测试版，APK 安装到手机；手表安装 `bundle.pkg`。已测组合为 P30PRO + OPPO Watch S2 / OWW265，**Watch S / OWW262 的兼容性依据参考项目，尚未由本项目真机验收**；S2 为本次已实测目标。OPPO 其他手表、Android/Wear OS 和 HarmonyOS 手表不在本项目的兼容声明内。
+当前工具包发布：**0.3.0（安装前补传 PNG 图标）**；手机桥为 **0.3.0 / versionCode 4**，配套探针 **1.0.4 / 10004**。这是开发测试版，APK 安装到手机；手表安装 `bundle.pkg`。已测组合为 P30PRO + OPPO Watch S2 / OWW265，**Watch S / OWW262 的兼容性依据参考项目，尚未由本项目真机验收**；S2 为本次已实测目标。OPPO 其他手表、Android/Wear OS 和 HarmonyOS 手表不在本项目的兼容声明内。
 
 ![S2 实体手动点击后的官方截图](docs/images/S2-1.0.4-manual-tap.jpg)
 
 上图是 S2 官方截屏导出，用户手动触摸后计数变为 1；画面中的“待实测”是每次运行的请求状态文案。本次另外完成了实体观察：无触摸静置至少 159 秒后仍亮屏。两者均不能替代通用远程输入验证。
 
+## 0.3.0 安装图标流程
+
+读取包名与图标 → 生成标准 PNG → 传入 `/user/jsapps/<包名>.png` → 等待终态成功且数字 `code=200` → 发送并安装 `.pkg`。包内 PGF 使用同一次构建的 `dist/icon.png`，或 `install <包> --icon <对应PNG>`；手机选包时会提示选择对应 PNG。失败、授权不足、超时或断开时停止安装，重复回调不会重复安装。
+
+[图标补传说明](phone-debug-bridge/ICON_INSTALL.md) · [0.3.0 验证与复现](phone-debug-bridge/ICON_VALIDATION_2026-11-14.md)
+
+API27 原生 Android 模拟器13项、PC工具22项通过。图标顺序测试使用模拟手表端点；**本版 S2 图标实际送达及桌面呈现仍待真机确认**，不将旧版 S2 应用安装或官方截图证据当作新图标通道验收。263 文件通道需要目标应用匹配的 appId/license，默认演示值不保证授权。调试桥不修改手机认证状态或自动重启手表。
+
+Git2 的项目入口先显示项目导航，再后台读取并进入完整源码页；读取失败可重试。克隆、源码历史、发行版与 Issue 仍使用原生 Git/Gitea。
+
 ## 下载和反馈
 
 - [发布页：APK、探针包、源码与完整工具包](https://git2.sydxky.cn/sydxky/rtos-watch-debug-bridge/releases)
@@ -68,7 +78,7 @@ RTOS 手表不需要 Android ADB。手机必须先在受支持的官方配套应
 
 ```powershell
 $phone = 'YOUR_PHONE_SERIAL'
-adb -s $phone install -r '..\downloads\RTOS-Phone-Bridge-0.2.0-debug.apk'
+adb -s $phone install -r '..\downloads\RTOS-Phone-Bridge-0.3.0-debug.apk'
 python bridge.py --serial $phone connect
 python bridge.py --serial $phone wait-link --seconds 45
 python bridge.py --serial $phone info
@@ -117,7 +127,7 @@ cd phone-debug-bridge
 python -m unittest discover -s tests -v
 ```
 
-APK 输出 `phone-debug-bridge/artifacts/RTOS-Phone-Bridge-0.2.0-debug.apk`。这是 Android Debug 签名工具，不是商店上架包；自行构建会使用自己的 debug 证书，与作者发布版可能不同。
+APK 输出 `phone-debug-bridge/artifacts/RTOS-Phone-Bridge-0.3.0-debug.apk`。这是 Android Debug 签名工具，不是商店上架包；自行构建会使用自己的 debug 证书，与作者发布版可能不同。
 
 ### Glyphix 探针
 
@@ -143,7 +153,7 @@ python phone-debug-bridge/tests/native_ui.py --seed 'C:\path\to\initialized-imag
 
 | 文件 | 内容 |
 | --- | --- |
-| `RTOS-Phone-Bridge-0.2.0-debug.apk` | 手机 APK，安装到 P30PRO 等 Android 手机 |
+| `RTOS-Phone-Bridge-0.3.0-debug.apk` | 手机 APK，安装到 P30PRO 等 Android 手机 |
 | `S2-DeviceProbe-1.0.4-dist.zip` | 圆/方各三文件，安装 bundle.pkg 到手表 |
 | `OPPO-Watch-S-S2-Bridge-0.2.1-source.zip` | 独立源码、构建脚本、完整许可和文档 |
 | `OPPO-Watch-S-S2-DebugKit-0.2.1.zip` | APK、探针、源码、文档及脱敏证据 |