Files

xiaji 8fb3af5518 Update README.md to follow standard format

- Rewrite README with clear sections: Features, Installation, Usage, Structure
- Add FAQ and contact information
- Keep project information concise and actionable

2026-03-15 23:32:46 +08:00

4.4 KiB

Raw Blame History

CheckShot - Android 图片检查与拼图工具

CheckShot 是一个面向 Android 的图片处理与检查工具，包含水印处理、拼图合成、以及丰富的设置能力，配合 AirTest 自动化测试用例，帮助实现端到端的图像工作流。

功能特点

相机模块：使用 CameraX 库实现拍照、自动/手动对焦、曝光调节，拍摄后自动叠加水印（时间+地点）
水印处理：支持时间水印（格式固定为 "yyyy年-MM月-dd日 HH:mm:ss"）和地点水印（优先联网解析，失败时显示经纬度），提供三种预设样式
多图拼图（合成）模块：支持 2x2 和 3x3 网格布局，图片自动缩放裁剪，支持图片替换、删除、添加和质量控制
文字编辑模块：在合成图片的顶部（标题）和底部（内容）添加带矩形背景的文字说明，支持智能换行
图片管理：本地存储、分类管理、预览、导出/分享，遵循分区存储规则通过 MediaStore 保存至系统相册
设置与通用配置：水印设置、合成设置、通用设置、关于等配置项均可通过设置界面调整
测试与自动化：集成 AirTest 测试用例，覆盖水印、相册、拼图、设置等场景，便于回归验证

安装步骤

克隆项目：

git clone http://124.223.26.33:3000/xiaji/anroid-CheckShot.git
cd anroid-CheckShot

构建调试 APK：
```
./gradlew assembleDebug
```

安装到设备：

adb install -r app/build/outputs/apk/debug/app-debug.apk

安装 AirTest 依赖（用于测试）：
```
pip install airtest pocoui
```

使用示例

基本使用

启动应用：在 Android 设备/模拟器上安装并打开 CheckShot
拍照：点击相机按钮拍照，自动添加水印
拼图：选择多张图片进行拼图合成
查看相册：浏览和管理拍摄的照片

构建发布 APK

# 构建签名 APK（需配置好 keystore）
./gradlew assembleRelease

# 构建产物位置
app/build/outputs/apk/release/app-release.apk

运行测试

# 确保设备已连接
adb devices

# 运行 AirTest 拼图测试
airtest run test/airtest/test_puzzle_merge.py --device Android:///

# 运行手动测试脚本
python test_android.py      # 基础功能测试
python test_camera.py       # 相机功能测试
python test_gallery.py      # 相册功能测试

目录结构

anroid-CheckShot/
├── app/                          # App 模块
│   ├── src/main/                 # 主代码
│   │   ├── java/                 # Kotlin/Java 代码
│   │   └── res/                  # 资源文件
│   ├── build.gradle.kts          # App 级构建配置
│   └── my-release.jks            # 签名密钥（本地）
├── test/                         # 测试代码
│   └── airtest/                  # AirTest UI 测试
├── gradle.properties             # Gradle 属性（含签名配置）
├── build.gradle.kts              # 项目级构建配置
├── settings.gradle.kts           # 项目设置
└── README.md                     # 项目说明

贡献指南

Fork 项目仓库
创建特性分支 (git checkout -b feature/AmazingFeature)
提交更改 (git commit -m 'Add some AmazingFeature')
推送到分支 (git push origin feature/AmazingFeature)
提交 Pull Request

常见问题 (FAQ)

Q: 如何配置签名？ A: 项目已配置自动签名，签名密钥文件 my-release.jks 在 app/ 目录下，密码在 gradle.properties 中配置。

Q: 如何修改水印样式？ A: 在设置界面中选择水印样式（默认/简约/醒目），可实时预览效果。

Q: AirTest 测试失败怎么办？ A: 确保设备已连接且已安装 AirTest 依赖，检查设备是否开启开发者选项和 USB 调试。

Q: 拼图功能支持哪些布局？ A: 支持 2x2 和 3x3 网格布局，图片会自动缩放裁剪以适配网格。

联系方式/反馈渠道

项目仓库：http://124.223.26.33:3000/xiaji/anroid-CheckShot.git
问题反馈：请在仓库中提交 Issue
代码贡献：欢迎提交 Pull Request

注意：请妥善保管签名密钥文件 (my-release.jks) 和密码，这些文件已添加到 .gitignore 中，不会被提交到版本控制。

4.4 KiB Raw Blame History Unescape Escape