# udp-debugger

**Repository Path**: ishyj/udp-debugger

## Basic Information

- **Project Name**: udp-debugger
- **Description**: UDP网络调试助手
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-23
- **Last Updated**: 2026-03-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# UDP调试助手

一款基于Android平台的UDP网络调试工具，支持UDP数据的发送和接收，提供实时数据显示和统计功能，方便开发者进行网络通信测试和调试。

## 功能特点

### 核心功能
- **UDP数据发送**：支持ASCII和HEX两种格式发送数据
- **UDP数据接收**：实时显示接收到的数据，支持ASCII和HEX两种格式查看
- **网络配置**：可配置本地地址、本地端口、目标地址和目标端口
- **PING测试**：测试目标地址的网络连通性
- **实时统计**：显示接收字节数、发送字节数和通讯时长
- **配置持久化**：自动保存配置参数，下次启动时恢复

### 界面特色
- **现代UI设计**：采用Material3设计风格，界面简洁美观
- **响应式布局**：适配不同屏幕尺寸的设备
- **侧边栏配置**：通过侧边栏快速访问配置参数
- **实时状态显示**：清晰显示当前监听状态和连接信息
- **数据自动滚动**：接收和发送的数据区域自动滚动到最新消息
- **双击填充**：双击发送历史记录可自动填充到发送框

## 技术栈

- **开发语言**：Kotlin
- **UI框架**：Jetpack Compose
- **网络编程**：UDP Socket
- **数据存储**：SharedPreferences
- **并发处理**：Coroutines

## 开发环境

### 必要工具
- Android Studio Giraffe (2022.3.1) 或更高版本
- JDK 17
- Android SDK API 33 或更高
- Kotlin 1.8.0 或更高

### 依赖项
- Jetpack Compose
- Material3
- Kotlin Coroutines

## 适配系统

- **最低支持版本**：Android 8.0 (API 26)
- **推荐版本**：Android 10.0 (API 29) 或更高
- **屏幕适配**：支持所有常见屏幕尺寸和方向

## 安装方法

### 从源码构建
1. 克隆仓库：`git clone https://github.com/yourusername/udp-debugger.git`
2. 在Android Studio中打开项目
3. 构建并运行应用

### 直接安装
1. 下载最新的APK文件
2. 在Android设备上安装APK
3. 授予应用网络权限

## 使用说明

### 基本操作
1. **配置网络参数**：
   - 点击左上角的菜单按钮打开侧边栏
   - 选择本地地址（从列表中选择或手动输入）
   - 设置本地端口和目标端口
   - 输入目标IP地址
   - 点击空白处保存配置并返回

2. **启动/停止监听**：
   - 点击主界面的「开始监听」按钮启动UDP监听
   - 点击「停止监听」按钮停止UDP监听

3. **发送数据**：
   - 在「数据发送内容」输入框中输入要发送的数据
   - 选择发送格式（ASCII或HEX）
   - 点击「发送」按钮发送数据

4. **查看接收数据**：
   - 接收的数据会显示在「接收数据区」
   - 可切换ASCII或HEX格式查看
   - 点击「清除」按钮清空接收数据

5. **PING测试**：
   - 在侧边栏中点击「PING测试」按钮
   - 等待测试结果显示

### 高级功能
- **数据格式切换**：点击相应按钮在ASCII和HEX格式之间切换
- **历史记录**：发送的数据会保存在「数据发送区」，双击可将其填充到发送框
- **统计信息**：底部显示实时统计数据，包括接收字节数、发送字节数和通讯时长

## 注意事项

1. **权限要求**：应用需要网络权限才能进行UDP通信
2. **端口占用**：如果遇到「端口已被占用」的错误，请尝试使用不同的端口
3. **网络环境**：确保设备处于正确的网络环境中，能够访问目标地址
4. **防火墙**：如果无法接收数据，请检查设备的防火墙设置

## 故障排除

- **无法接收数据**：
  - 检查本地端口是否正确
  - 确认目标设备是否在同一网络
  - 检查防火墙设置

- **无法发送数据**：
  - 检查目标地址和端口是否正确
  - 确认设备是否已连接到网络
  - 检查目标设备是否在监听指定端口

- **配置不保存**：
  - 确保应用有存储权限
  - 尝试重新启动应用

## 贡献

欢迎提交Issue和Pull Request来改进这个项目！

## 许可证

本项目采用MIT许可证。详见 [LICENSE](LICENSE) 文件。

## 作者

- **作者**：ishyj
- **邮箱**：ishyj@qq.com