# ocr-json-app

**Repository Path**: nachao/ocr-json-app

## Basic Information

- **Project Name**: ocr-json-app
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-12
- **Last Updated**: 2026-04-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 截图助手 Android App

一个简单的Android应用，提供悬浮窗截图功能。

## 功能特性

- ✅ 主页面显示"开始"按钮
- ✅ 点击开始后应用最小化
- ✅ 显示悬浮窗按钮（可拖拽）
- ✅ 点击悬浮窗按钮进行截图
- ✅ 截图后自动在主页面显示

## 开发环境要求

1. **Android Studio** - 最新版本
2. **JDK** - 17 或 11 (LTS版本)
3. **Android SDK** - API 24+ (Android 7.0+)
4. **Gradle** - 8.1.0+

## 安装步骤

### 1. 使用 Android Studio 打开项目

```bash
# 在 Android Studio 中
File -> Open -> 选择 android-app 目录
```

### 2. 同步 Gradle

Android Studio 会自动同步，或手动点击 "Sync Now"

### 3. 连接设备或启动模拟器

- 连接 Android 设备（开启USB调试）
- 或启动 Android 模拟器

### 4. 运行应用

点击 "Run" 按钮或按 `Shift+F10`

## 权限说明

应用需要以下权限：

1. **悬浮窗权限** (`SYSTEM_ALERT_WINDOW`)
   - 首次使用时系统会提示授权
   - 需要在系统设置中手动开启

2. **存储权限** (`WRITE_EXTERNAL_STORAGE`)
   - Android 13+ 不需要此权限
   - 较低版本需要授权

3. **屏幕捕获权限**
   - 每次截图时会弹出系统授权对话框
   - 需要用户确认

## 使用说明

1. 打开应用，点击"开始"按钮
2. 首次使用需要授权悬浮窗权限
3. 应用最小化后，会出现悬浮窗按钮
4. 点击悬浮窗按钮进行截图
5. 截图会保存到应用私有目录
6. 重新打开应用可查看最新截图

## 项目结构

```
android-app/
├── app/
│   ├── src/
│   │   └── main/
│   │       ├── java/com/example/screenshotapp/
│   │       │   ├── MainActivity.kt          # 主Activity
│   │       │   ├── FloatingWindowService.kt # 悬浮窗服务
│   │       │   └── ScreenshotActivity.kt    # 截图权限Activity
│   │       ├── res/
│   │       │   ├── layout/                  # 布局文件
│   │       │   └── values/                   # 资源文件
│   │       └── AndroidManifest.xml          # 应用配置
│   └── build.gradle                         # 应用构建配置
├── build.gradle                             # 项目构建配置
├── settings.gradle                          # 项目设置
└── README.md                                # 说明文档
```

## 技术栈

- **语言**: Kotlin
- **最低SDK**: 24 (Android 7.0)
- **目标SDK**: 34 (Android 14)
- **架构**: Service + Activity
- **截图方式**: MediaProjection API

## 注意事项

1. 悬浮窗功能需要系统级权限，某些设备可能有限制
2. 截图功能需要用户每次授权（Android安全机制）
3. 截图保存在应用私有目录，卸载应用会删除
4. 建议在真机上测试，模拟器可能不支持所有功能

## 常见问题

### Q: 悬浮窗不显示？
A: 检查是否已授权悬浮窗权限，在系统设置中开启。

### Q: 截图失败？
A: 确保已授权屏幕捕获权限，某些设备需要额外设置。

### Q: 截图不清晰？
A: 检查设备屏幕密度设置，截图分辨率与设备分辨率一致。

## 开发说明

- 使用 Kotlin 编写
- 遵循 Material Design 设计规范
- 支持 Android 7.0 及以上版本

## 许可证

本项目仅供学习和参考使用。