anroid-CheckShot/DEVELOPMENT_PLAN.md

巡检相机增量开发计划

开发原则

• 增量开发：每次只添加一个功能，测试通过后再添加下一个
• DRY原则：避免重复代码，保持代码简洁
• 测试驱动：每个功能都要在真机上测试验证

功能列表（按优先级排序）

✅ 阶段1：基础功能（已完成）

1. 相机预览
2. 拍照保存
3. 权限处理

🔄 阶段2：水印功能（当前阶段）

1. 时间戳水印
2. 水印样式可配置（位置、颜色、大小）
3. 水印预览

📋 阶段3：多图管理

1. 拍摄多张照片
2. 照片预览网格
3. 照片选择/删除

🎨 阶段4：图片合成

1. 2x2网格合成
2. 合成图片添加标题
3. 合成图片质量优化

⚙️ 阶段5：设置功能

1. 水印设置
2. 图片质量设置
3. 存储路径设置

📱 阶段6：高级功能

1. 图片编辑（裁剪、旋转）
2. 批量处理
3. 分享功能

当前状态

已修复问题

1. ✅ 极简相机基础功能正常
2. ✅ 修复错误提示问题（"拍照失败：processing failed"）

当前测试版本

• WatermarkCameraActivity：带时间戳水印的相机
• 测试重点：水印添加是否正常，性能是否稳定

测试步骤

水印相机测试

1. 下载最新APK安装
2. 启动应用，授予相机权限
3. 拍照测试
4. 检查：
   • 照片是否保存成功
   • 水印是否正确添加（左下角时间戳）
   • 水印是否清晰可见
   • 应用是否稳定无闪退

问题反馈

如果发现问题，请提供：

1. 手机型号和Android版本
2. 问题描述（闪退时机、错误提示）
3. 如果有ADB日志，提供logcat输出

代码结构

app/src/main/java/com/example/app/
├── MainActivity.kt                    # 启动入口
├── SimpleCameraActivity.kt           # 极简相机（基础功能）
├── WatermarkCameraActivity.kt        # 带水印相机（当前测试）
├── CameraActivity.kt                 # 完整功能相机（待重构）
└── ImageCompositor.kt                # 图片合成工具

app/src/main/res/layout/
├── activity_main.xml                 # 主布局
├── activity_simple_camera.xml        # 极简相机布局
└── (后续添加更多布局)

后续计划

根据水印相机的测试结果：

1. 如果正常：添加多图管理功能
2. 如果有问题：修复水印功能，优化性能

构建命令

# 调试版构建
./gradlew assembleDebug

# 发布版构建（需要配置签名）
./gradlew assembleRelease

版本控制

每个功能阶段都会创建独立的Activity，便于测试和回滚。最终会将所有功能整合到主CameraActivity中。