android+docs: debug 日志默认关闭;操作手册升级为插图版

debug 日志:DebugLog 增加总开关 enabled(默认 false),log() 直接返回、
init() 不装崩溃钩子、startFile() 不建文件。要在设备上排查时改成 true 重新构建
即可,其它代码不动。关闭后崩溃仍按安卓常规方式可见(logcat AndroidRuntime +
系统弹窗),只是不再有落在相册目录旁的 debug_*.log。

真机烟雾测试(小米 22041211AC,相机插着):出流正常、拍照成功(相册 19→20,
新增 MAG160C_20260912_153522.jpg)、崩溃 0、App 自身日志行数 0、无新日志文件。

插图版手册 docs/android_app/app_manual.md + manual_images/:
- 02_markers:标记结构解剖(准星/读数/引线/描边字),真机照片放大 3 倍并标注
- 03/04:横屏 960x720 与竖屏 720x960 的真实照片
- 05/06/07:设置、分析(含底部测量面板)、相册 真机截图
- 01_live_schematic:实时界面改为**自绘示意图**,因为实时 OSD 文字按握持角度预旋转
  (用户要求的可读性设计),手册拍摄时手机横放,截图里文字全是侧躺的无法阅读;
  其余界面文字本就水平,直接用截图。

图由 manual_images/MakeFigures.java 生成(裁剪缩放/放大标注/示意图绘制),
界面改动后重跑即可;原始截图存为 JPEG(PNG→JPEG 省约 8MB)作为可再生输入。
.class 已加入 .gitignore。

README 阅读顺序加入操作手册、结构表更新、里程碑补记根因级修复。105 项测试全绿。
This commit is contained in:
ZXCLI
2026-09-12 15:36:34 +08:00
parent 6ba90f2bb6
commit ee6859877a
20 changed files with 459 additions and 70 deletions
+48
View File
@@ -489,6 +489,54 @@
"未连接"分支显示,正常出图时用户看不到任何反馈)。
- [x] 单测 66 → **76 项全绿**debug + release(R8) 双构建通过;APK 已更新。
## 用户反馈修复 第二十五轮(2026-09-12,关闭 debug 日志 + 带图操作手册)
用户三点要求:把 App 的 debug 日志关掉;做一个带图的手册;push 上去。
### 1) debug 日志默认关闭
`DebugLog` 增加总开关 `enabled`**默认 false**`log()` 直接返回(不写 logcat 也不写文件),
`init()` 不安装崩溃钩子,`startFile()` 不建文件。要在设备上排查时把该常量改成 true 重新
构建即可,其它代码一行不用动。
- 关掉后崩溃仍按安卓常规方式可见(logcat `AndroidRuntime` + 系统"应用停止运行"弹窗),
只是不再有那份落在相册目录旁的 `debug_*.log`
- 真机烟雾测试(小米 22041211AC):出流正常、拍照成功(相册 19 → 20 张,
新增 `MAG160C_20260912_153522.jpg`)、崩溃数 0、**App 自身日志行数 0**、
`Download/MAG160C` 无新日志文件
- 注意:`adb logcat | grep MAG160C` 会匹配到系统 MediaProvider 打印的**文件路径**
不是本 App 的日志。判断 App 是否还在打日志要按 tag 过滤:
`grep -E "MAG160C/(vm|usb|session|stream|render|rec|analyze)"`
### 2) 带图操作手册
`docs/android_app/app_manual.md` 升级为插图版,图在 `manual_images/`
| 图 | 内容 | 来源 |
|---|---|---|
| `01_live_schematic.png` | 实时界面布局与 ①~⑥ 控件编号 | **绘制**(见下) |
| `02_markers.png` | 标记结构解剖:准星/读数/引线/描边字 | 真机照片放大 3 倍 |
| `03/04_photo_*.png` | 横屏 960×720 与竖屏 720×960 的真实照片 | 真机拍摄 |
| `05_settings.png` | 设置页 | 真机截图 |
| `06_analysis.png` | 分析页(含底部测量面板) | 真机截图 |
| `07_gallery.png` | 相册 | 真机截图 |
**为什么实时界面用绘制图而不是截图**:实时界面的 OSD 文字会按握持角度预旋转
(这是用户要的可读性设计),手册拍摄时手机是横放的,截图里全部文字都是侧躺的、
顶部/底部栏也一样,放进手册无法阅读。因此实时页改为自绘示意图(控件位置与真实
布局一致),其余界面文字本来就是水平的,直接用真机截图。
图由 `manual_images/MakeFigures.java` 生成(截图裁剪缩放、标记解剖放大与标注、
示意图绘制),界面改动后重跑即可,避免手册里的图与实物不一致。原始截图存为
JPEG`*_raw.jpg`PNG 转 JPEG 省下约 8MB)作为可再生的输入。
### 3) README 同步
阅读顺序加入操作手册,仓库结构表更新,里程碑补记 2026-09-11~12 的三个根因级修复
launchMode / SET_CONFIGURATION / 软件画布卡顿 6.5→15.1fps)与同期完成项。
105 项测试全绿;本轮提交后 push 到 origin(用户明确要求)。
## 用户反馈修复 第二十四轮(2026-09-12,横屏拍摄方向:文件跟随握持角度)
用户反馈:"切到横屏拍照片和视频方向又不对了"。