# FruitSortingLDV

**Repository Path**: chuwujian/fruit-sorting-ldv

## Basic Information

- **Project Name**: FruitSortingLDV
- **Description**: 围绕“基于激光多普勒效应的水果分拣APP程序开发”展开，旨在开发一款适配工业场景的水果无损分拣移动端应用，解决水果内部缺陷（如柑橘粒化病）难以通过外观区分的分拣难题。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-12
- **Last Updated**: 2026-01-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 水果分选LDV

一个基于Android平台的水果分选应用程序，使用激光多普勒振动(LDV)技术进行水果品质检测与分选。

## 项目简介

本项目是一个工业级水果分选解决方案的移动端应用，通过激光多普勒测振技术实现对水果内部品质的快速、无损检测。应用程序提供了完整的用户交互界面，支持传感器配置、参数阈值设置、数据管理和日志追踪等功能。

## 主要功能

### 1. 用户认证
- 登录系统，确保操作人员身份验证
- 安全的会话管理机制

### 2. 传感器配置
- 传感器参数实时配置
- 设备连接状态监控
- 传感器校准功能

### 3. 阈值设置
- 分选参数阈值自定义设置
- 多种分选模式配置
- 灵敏度调节选项

### 4. 数据管理
- 分选数据记录与存储
- 数据统计分析
- 数据导出功能

### 5. 日志追踪
- 操作日志完整记录
- 异常情况追踪
- 报警信息管理

### 6. 紧急报警
- 异常情况即时报警
- 报警历史记录
- 紧急停机功能

## 技术栈

- **编程语言**: Kotlin
- **UI框架**: Android XML布局 + Material Design
- **架构模式**: 基于Activity + Fragment的组件化设计
- **构建工具**: Gradle
- **最低SDK版本**: API 21 (Android 5.0)
- **目标SDK版本**: 最新稳定版

## 项目结构

```
app/src/main/
├── java/com/example/fruitsortingldv/
│   └── MainActivity.kt          # 主入口Activity
├── res/
│   ├── layout/                   # 布局文件
│   │   ├── activity_login.xml    # 登录界面
│   │   ├── activity_main.xml     # 主界面
│   │   ├── dialog_emergency_alarm.xml  # 紧急报警对话框
│   │   ├── fragment_data_management.xml  # 数据管理
│   │   ├── fragment_log_tracking.xml     # 日志追踪
│   │   ├── fragment_sensor_config.xml    # 传感器配置
│   │   ├── fragment_threshold_setting.xml # 阈值设置
│   │   └── item_log.xml          # 日志项布局
│   ├── drawable/                 # 图形资源
│   │   ├── ic_launcher_background.xml
│   │   ├── ic_launcher_foreground.xml
│   │   └── ic_ldv_logo.png
│   └── values/                   # 资源值定义
│       ├── colors.xml
│       ├── strings.xml
│       └── themes.xml
└── AndroidManifest.xml
```

## 环境要求

- Android Studio Hedgehog (2023.1.1) 或更高版本
- JDK 17 或更高版本
- Gradle 8.x
- Android SDK Platform

## 快速开始

### 1. 克隆项目

```bash
git clone https://gitee.com/chuwujian/fruit-sorting-ldv.git
cd fruit-sorting-ldv
```

### 2. 使用Android Studio打开

1. 启动Android Studio
2. 选择"Open"或"Import Project"
3. 导航到项目根目录并选择
4. 等待Gradle同步完成

### 3. 构建项目

```bash
./gradlew assembleDebug
```

生成的APK文件位于 `app/build/outputs/apk/debug/` 目录。

### 4. 安装运行

将生成的APK文件安装到Android设备上，或通过USB调试直接运行。

## 使用说明

### 登录系统
首次打开应用需要使用有效账户登录。默认管理员账户请联系系统管理员获取。

### 主界面导航
主界面提供以下功能入口：
- **数据管理**: 查看和管理分选数据记录
- **日志追踪**: 监控系统运行日志
- **传感器配置**: 调整传感器参数
- **阈值设置**: 配置分选判定标准

### 紧急报警
当系统检测到异常情况时，会自动弹出紧急报警对话框。用户可查看报警详情并采取相应措施。

## 测试

项目包含单元测试和仪器测试，确保核心功能稳定性。

### 运行单元测试
```bash
./gradlew test
```

### 运行仪器测试
```bash
./gradlew connectedAndroidTest
```

## 注意事项

1. 确保设备已开启USB调试模式
2. 应用需要相机权限用于扫码等功能
3. 建议在工业环境下使用防护等级达标的设备

## 技术支持

如在使用过程中遇到问题，请通过Gitee平台提交Issue或联系开发团队。

## 许可证

本项目采用 MIT License 开源许可证，详情请参阅 LICENSE 文件。

## 贡献者

感谢所有为该项目做出贡献的开发者！