# windows_adb_tool

**Repository Path**: amlinsan/windows_adb_tool

## Basic Information

- **Project Name**: windows_adb_tool
- **Description**: windows adb 上位机，方便测试组的小姐姐。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-10
- **Last Updated**: 2025-09-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: ADB, Android, Python

## README

# windows_adb_tool 测试工具

一款专为Android设备测试开发的Windows上位机工具，通过ADB命令实现对设备的便捷控制和日志管理。本工具主要面向测试团队，简化日常测试工作流程。

## 🚀 快速开始

### 方式一：直接运行（推荐）
```bash
# 直接运行Python脚本
python main.py
```

### 方式二：使用可执行文件
```bash
# 生成exe文件
build.bat

# 或使用Python脚本构建
python build.py
```

## ✨ 主要功能

### 📱 设备连接管理
- **自动检测**：自动识别并列出所有连接的Android设备
- **多设备支持**：通过下拉菜单轻松切换不同设备
- **快捷操作**：一键执行root、remount、重启等常用命令
- **状态显示**：实时显示当前连接设备信息

### 📝 日志管理功能

#### MTKLog管理
- **导出功能**：一键导出debuglogger、aee_exp、anr等系统日志
- **清除功能**：快速清理设备上的日志文件，释放存储空间
- **路径配置**：自定义日志保存路径

#### GOCLog管理
- **专项日志**：导出和管理GOC相关日志
- **批量操作**：支持批量导出和清除

#### 调试模式
- **DB开启**：配置aee-config开启系统调试模式
- **高级选项**：提供更多调试相关配置

### 🎬 媒体功能

#### 截屏功能
- **快速截图**：使用screencap命令快速截取屏幕
- **自动保存**：截图自动保存到指定目录
- **命名规范**：按时间戳自动命名，方便管理

#### 录屏功能
- **灵活控制**：支持开始/停止录制
- **时长设置**：可设置录制时长（最长180秒）
- **格式支持**：保存为标准MP4格式

### 🛠️ 平台工具

#### 内存管理
- **内存填充**：使用dd命令填充指定大小的内存
- **性能测试**：用于内存压力测试场景

### 🎯 自定义命令执行

#### 基础功能
- **命令输入**：支持任意ADB命令输入
- **历史记录**：保存最近执行的命令，方便重复使用
- **智能补全**：自动添加设备ID参数

#### 循环执行（v1.3.2新增）
- **定时执行**：设置执行周期，自动循环执行命令
- **执行计数**：实时显示执行次数
- **安全控制**：执行过程中自动锁定相关控件

### 🚗 项目专区

#### 房车项目
- **静默重启**：配置MCU重启时间和等待参数
- **专项测试**：针对房车项目的特定测试功能

## 📋 版本更新记录

### v1.3.7 (最新版本)
- 添加同步执行log的快捷按钮
- 优化用户界面交互体验

### v1.3.5
- 修复调试菜单勾选状态同步问题
- 使用tk.BooleanVar统一管理菜单状态

### v1.3.4
- **性能优化**：Logcat输出性能大幅提升
- 移除高亮处理，批量处理50行
- UI更新频率优化至100ms

### v1.3.3
- **体验优化**：执行后保留命令输入
- 界面布局调整，提升易用性

### v1.3.2
- **新增功能**：循环执行命令功能
- 支持设置执行周期和次数

### v1.3.1
- **智能优化**：自动添加设备ID参数
- 使用shlex模块处理带引号的参数

### v1.3.0
- **持久化**：命令历史保存到配置文件
- **调试日志**：支持开启/关闭调试模式
- **配置管理**：支持导入/导出配置

## 💻 系统要求

- **操作系统**：Windows 7及以上版本
- **Python版本**：3.6或更高版本
- **依赖工具**：ADB工具（Android Debug Bridge）
- **Python库**：tkinter（GUI界面库）

## 📦 安装说明

### 1. 安装Python依赖
```bash
pip install -r requirements.txt
```

### 2. 配置ADB环境
- 下载[Android SDK Platform Tools](https://developer.android.com/studio/releases/platform-tools)
- 将adb.exe所在目录添加到系统PATH环境变量
- 或将adb.exe复制到工具目录下

### 3. 设备准备
- 开启Android设备的开发者选项
- 启用USB调试模式
- 使用USB线连接设备到电脑

## 📖 使用说明

### 首次使用
1. 运行程序后，顶部会自动检测并显示连接的设备
2. 如有多个设备，从下拉菜单选择目标设备
3. 设置工作目录（默认为D:\tx205_log）

### 日志导出操作
1. 选择"日志管理"标签页
2. 点击对应的导出按钮（MTKLog/GOCLog等）
3. 日志将自动保存到工作目录下的对应文件夹

### 截屏录屏操作
1. 选择"媒体功能"标签页
2. 点击"截屏"按钮立即截图
3. 点击"开始录屏"开始录制，点击"停止录屏"结束

### 自定义命令
1. 选择"自定义命令"标签页
2. 在输入框输入ADB命令（无需输入"adb"前缀）
3. 点击"执行"或按回车键执行命令
4. 查看下方输出区域的执行结果

## ❓ 常见问题

### Q1: 提示找不到ADB命令？
**A:** 请确保ADB工具已正确安装并添加到系统PATH环境变量中。可以在命令行输入`adb version`测试。

### Q2: 设备连接不上？
**A:** 
1. 检查USB线是否正常连接
2. 确认设备已开启USB调试模式
3. 尝试执行`adb kill-server`后重新连接
4. 检查设备是否弹出授权提示并点击允许

### Q3: 日志导出失败？
**A:** 
1. 确认设备已获得root权限（部分日志需要）
2. 检查设备存储空间是否充足
3. 确认工作目录有写入权限

### Q4: 录屏文件在哪里？
**A:** 所有媒体文件（截图、录屏）都保存在工作目录下的`media`子目录中，按日期时间命名。

### Q5: 如何查看调试日志？
**A:** 通过菜单栏"调试"->"开启调试日志"，调试信息将保存到用户目录下的`tx205_debug.log`文件。

## 📁 目录结构

```
TX205_TestTools/
├── main.py              # 主程序入口
├── build.bat            # Windows构建脚本
├── build.py             # Python构建脚本
├── requirements.txt     # Python依赖包列表
├── README.md           # 项目说明文档
├── CLAUDE.md           # AI助手配置文件
└── dist/               # 构建输出目录（执行build后生成）
    └── TX205_TestTool.exe
```

## 🔧 配置文件

配置文件自动保存在用户目录下：
- **路径**：`~/.tx205_config.json`
- **内容**：包含工作目录、命令历史、调试设置等

## 🤝 贡献指南

欢迎提交问题反馈和功能建议！

### 报告问题
1. 在Gitee仓库创建Issue
2. 详细描述问题现象
3. 提供设备型号和系统版本
4. 附上相关错误截图或日志

### 功能建议
1. 说明使用场景
2. 描述期望的功能
3. 提供参考实现（如有）

## 📄 开源协议

本项目采用 MIT 协议开源，详见 [LICENSE](LICENSE) 文件。

## 👥 联系我们

- **项目地址**：[Gitee仓库地址](https://gitee.com/amlinsan/windows_adb_tool)
- **问题反馈**：[Issues](https://gitee.com/amlinsan/windows_adb_tool/issues)
- **开发团队**：amlinsan

---

*Android adb 测试工具 - 让Android测试更简单高效！*

**特别鸣谢**：感谢测试组小姐姐们的持续反馈和建议，让这个工具越来越好用！ 💝