first commit

README.md

@@ -0,0 +1,40 @@
+# 日志抓取工具（屏幕触摸失效时使用）
+
+给测试人员用：当车机屏幕不能点击时，通过 bat 脚本打开应用日志并抓取。
+
+## 前提
+
+1. PC 已安装 adb（脚本直接调用 `adb`，没配环境变量的把 `adb.exe` 和 `AdbWinApi.dll` 放到本目录）
+2. 车机 USB 口处于 **OTG/调试模式**（调试页面第 3 项"USB功能选择开关"= OFF/OTG）
+   - ⚠️ 脚本**永远不会**碰这个开关，因为切到存储模式会把 adb 断掉
+3. USB 线插好，`adb devices` 能看到设备
+
+## 使用顺序
+
+| 步骤 | 脚本 | 作用 |
+|---|---|---|
+| 1 | `1_EnableLogs.bat` | 发 YXLog 广播 + 拉起调试页面并用按键切换"主控打印/通信打印"开关 |
+| 2 | `2_CaptureLogs.bat` | 开始抓 logcat（Ctrl+C 停止），保存为 `yx_log_日期时间.txt` |
+| 3 | （复现问题） | 操作车机复现，或跑 `3_RestartLauncher.bat` 重启主界面抓启动日志 |
+| 4 | `4_PullFlashLog.bat` | （可选）拉取通信模块落盘日志 `/sdcard/Log/test.txt` |
+
+## 重要说明
+
+- **广播是"切换"不是"置开"**：车机重启后日志默认是关的，`1_EnableLogs.bat` 发 1 次广播 = 打开。
+  **一台车开机后只跑一次 Step1**；如果不确定状态，看 Step2 抓到的日志里有没有该模块 TAG 输出，没有就再跑一次 Step1。
+- Step1 打开调试页面后会按方向键自动切换前两项，**此时需要人看一眼车机屏幕**：
+  "主控打印开关"和"通信打印开关"两项应显示 ON 图标；脚本窗口里按任意键会再补按一次确认键修正。
+- Music / Video / TV 三个模块的日志开关在代码里被注释掉了（广播发了也不生效），它们的日志需要改代码重新编译才能打开。
+- 广播只对 通信(CommunicatePro)、蓝牙(BlueTooth)、语音切换(VoiceSwitcher)、主控(MainInterface) 生效。
+- 抓不到日志的另一个常见原因：之前有人跑过两次 Step1，把开关又切回关了。判断方法见上。
+
+## 常见问题
+
+**Q: 提示 no adb device？**
+USB 口可能被切到了存储模式（调试页面第 3 项），需要在屏幕正常时切回 OTG；或者换数据线/接口。
+
+**Q: Step1 提示 am start 失败 / skipped the 2 UI switches？**
+车机不支持 `adb root`，只能靠广播开关（通信/蓝牙/语音切换模块够用了）。
+
+**Q: logcat 里完全没有任何 yaxon 相关输出？**
+开关又被切回关了，重跑一次 `1_EnableLogs.bat`。