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:
@@ -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,横屏拍摄方向:文件跟随握持角度)
|
||||
|
||||
用户反馈:"切到横屏拍照片和视频方向又不对了"。
|
||||
|
||||
Reference in New Issue
Block a user