yingeoai-sdk-restaurant-demo 变更记录

源码目录：/Users/liang/Desktop/yingeoai-sdk-restaurant-demo

提示词工程：/Users/liang/AndroidStudioProjects/zhct/zhctprompt

2026-09-29 Android Studio 构建兼容与真机启动修复

• 根因一：当前 Android Studio 最高支持 AGP 7.3.0，源码工程原配置为 AGP 8.5.1，导致项目同步阶段直接拒绝加载。
• 构建配置：build.gradle 将 AGP 调整为 7.3.0；gradle/wrapper/gradle-wrapper.properties 使用本机已有 Android 工程相同的 Gradle 7.4 组合。
• 根因二：AGP 7.3.0 自带的 D8 处理 UVCAndroid 1.0.13 时在 mergeExtDexDebug 阶段空指针失败。
• 依赖兼容：app/build.gradle 将 UVCAndroid 调整为本机同名工程和 AIDishRecognition 已使用的 1.0.6；对比确认当前项目实际调用的 ICameraHelper、CameraHelper、Size 和 UVCCamera API 在 1.0.6 中均存在。
• 自动验证：./gradlew clean :app:assembleDebug :app:testDebugUnitTest --stacktrace --warning-mode all 成功，Debug APK 构建完成，78 项单元测试 0 失败。
• 真机验证：Debug APK 通过 adb install -r 覆盖安装到 FY_3576SE；冷启动返回 Status: ok，MainActivity 在前台保持运行，15 秒观察期内进程存活且未再出现 USBMonitor 的 Parcel recycled earlier than expected 崩溃。
• 已知警告：AGP 7.3.0 官方只验证到 compileSdk 33；项目继续保持 compileSdk 34，Gradle 会输出兼容性提示。targetSdk 已在后续相机预览修复中调整为 33。
• Git：源码目录不是 Git 工作树；未执行暂存、提交、推送、分支切换或其他 Git 写操作。

2026-09-29 相机设置设备列表与切换修复

• 现象：进入相机设置后，摄像头选择和分辨率选项为空，无法切换摄像头。
• 根因：设置页只在 onCreate 读取一次由异步 onAttach 回调维护的设备缓存；相机 Helper 重建时缓存先被清空，回调晚于页面初始化或不重放时，Spinner 会永久保持空数据。
• 设备枚举：CameraUsbUtils 改为优先读取 UVC Helper 的实时 getDeviceList()，回调缓存仅作为降级数据源；Helper 初始化后主动枚举并选择已保存设备，避免依赖 UVCAndroid 1.0.6 的 onAttach 回放时机。
• 页面刷新：新增相机设备列表/打开完成监听，CameraSettingActivity 在设备接入、移除和相机打开后刷新相机及分辨率适配器，并在页面停止时解除监听。
• 阻塞规避：设置页不再从主线程调用可能等待 USB 连接的 getSupportedSizeList() 和 getPreviewSize()，改读设备打开回调生成的尺寸缓存；USB 授权失败时页面不会再出现 ANR。
• 配置常量：相机偏好键统一为 SettingConst.KEY_USB_CAMERA，避免新增散落的字符串常量。
• 自动验证：./gradlew clean testDebugUnitTest assembleDebug 成功，78 项单元测试 0 失败，Debug APK 构建完成。
• 真机验证：Debug APK 已覆盖安装到 FY_3576SE；相机设置页枚举出 3 个设备（1008_11391_19040、1007_3141_25440、1004_1374_41357），实测切换到 1004_1374_41357 后 Spinner 与偏好值同步更新，页面保持响应且无崩溃/ANR。
• 验证边界：覆盖安装后设备取消了 USB 授权，因此本轮未确认实际相机画面和分辨率回调；授权失败路径已验证不会阻塞设置页。
• Git：源码目录不是 Git 工作树；未执行暂存、提交、推送、分支切换或其他 Git 写操作。

2026-09-29 Android 14 相机预览修复

• 现象：摄像头列表可正常显示和切换，但主页面及相机设置页没有预览画面。
• 根因：UVCAndroid 1.0.6 使用可变隐式 PendingIntent 申请 USB 权限；应用以 targetSdk 34 运行在 Android 14 时，该请求被系统兼容性变更 236704164 拦截，日志停在 request permission / onCancel，无法进入相机打开和预览回调。
• 兼容处理：app/build.gradle 保留 compileSdk 34，将 targetSdk 调整为 33，与现有使用同版 UVCAndroid 的安卓项目配置边界保持一致，并在配置旁补充兼容原因注释。
• 自动验证：./gradlew clean testDebugUnitTest assembleDebug 成功，78 项单元测试 0 失败，Debug APK 构建完成。
• 真机验证：先恢复系统兼容性开关默认值，再覆盖安装到 Android 14 真机 FY_3576SE；日志正常到达 onDeviceOpen、onCameraOpen 并持续输出 NV21 预览帧。
• 画面验证：主页面和相机设置页均已实际显示实时画面；从 1004_1374_41357 切换至 1008_11391_19040 后画面与分辨率同步更新为 1920x1080，未出现崩溃或 ANR；验证结束后已恢复选择 1004_1374_41357。
• Git：源码目录不是 Git 工作树；未执行暂存、提交、推送、分支切换或其他 Git 写操作。

2026-09-29 分辨率选项保持显示修复

• 现象：在相机设置页选择一次分辨率后，相机重开，整个分辨率选择区域随即消失；部分摄像头切换后也会出现相同问题。
• 根因：应用分辨率会重建 UVC CameraHelper，原实现同步清空 cameraSizeList；页面在重建窗口读取空缓存后将分辨率容器设为 GONE。当保存分辨率与设备默认分辨率不同时还会二次打开相机，第二次打开跳过尺寸枚举，使空缓存无法恢复。
• 尺寸缓存：CameraUsbUtils 按物理摄像头稳定 ID 保存最后一次成功枚举的分辨率列表；同一摄像头重开时恢复缓存，新列表成功返回后再原子替换，避免把其他摄像头的尺寸混入当前列表。
• 页面状态：分辨率暂未返回时保持设置区域可见，显示禁用的“分辨率加载中…”状态；有效列表返回后恢复可选。替换 Spinner 适配器前先解除旧监听器，避免列表刷新误触发下一次相机重开。
• 选项整理：同宽高的重复分辨率只显示一次，不影响底层优先选择高帧率尺寸。
• 自动验证：./gradlew clean testDebugUnitTest assembleDebug 成功，78 项单元测试 0 失败，Debug APK 构建完成。
• 真机验证：原复现步骤“选择一次分辨率后等待 6 秒”由失败变为通过；连续选择 1920x1080、640x480 后选项持续显示，切换 1004/1008 后各自分辨率正常恢复，预览持续出帧且无崩溃或 ANR。验证结束后已恢复 1004_1374_41357 和 1280x960。
• Git：源码目录不是 Git 工作树；未执行暂存、提交、推送、分支切换或其他 Git 写操作。