# adbUI

**Repository Path**: mtoooo/adbUI

## Basic Information

- **Project Name**: adbUI
- **Description**: No description available
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-28
- **Last Updated**: 2026-05-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ADB UI Tool

一个现代化的 ADB 图形界面工具，使用 PyQt6 开发，界面设计参考苹果风格。

## ✨ 功能特性

### 📱 设备管理
- 自动检测并列出所有连接的 Android 设备
- 显示设备详细信息（型号、Android 版本、电池状态、IP 地址等）
- 支持 USB 和无线 ADB 连接
- 实时设备状态监控
- 设备信息面板展示硬件、系统、网络和电池信息

### 📦 应用管理
- 安装/卸载应用
- 列出所有已安装应用
- 查看应用包名和详细信息
- 支持系统应用和用户应用查看

### 📁 文件管理
- 推送文件到设备
- 从设备拉取文件
- 设备文件系统浏览器
- 支持文件/文件夹的创建、删除、重命名操作
- 右键菜单快捷操作

### 📸 屏幕操作
- 截屏功能（PNG格式）
- 录屏功能（可设置时长，MP4格式）
- 自动保存到本地指定路径

### 💻 Shell 命令
- 执行任意 Shell 命令
- 实时命令输出显示
- 输出内容支持复制
- Logcat 日志查看和清除

### ⚙️ 系统操作
- 重启设备（正常重启/Bootloader/Recovery）
- 系统属性查询
- 进程管理和监控

### 📊 性能监控（新功能）
- **独立的性能监控窗口**
- 实时图表展示：
  - FPS（帧率）
  - CPU 使用率
  - 内存使用量
  - GPU 使用率
- 监控控制：
  - 开始/暂停/停止监控
  - 打 Tag 标记重要时刻
  - 自定义 Tag 名称或自动编号
- 数据展示：
  - 120个数据点缓存，显示最近60秒
  - 数据点标记（不同图表不同形状）
  - Tag 标记在所有图表同步显示
  - 垂直滚动查看所有图表
- 主题适配：
  - 图表完美适配深色/浅色主题
  - 自动跟随主窗口主题切换

### 🎨 界面特性
- 苹果风格的现代化 UI
- 支持浅色/深色主题切换
- 响应式布局设计
- 流畅的动画效果
- 图标和按钮的视觉反馈

## 📂 项目结构

```
adb-ui/
├── main.py                      # 主程序入口
├── requirements.txt             # 依赖列表
├── README.md                    # 项目说明
├── config/                      # 配置模块
│   ├── __init__.py
│   └── settings.py              # 配置管理（JSON持久化）
├── core/                        # 核心 ADB 功能模块
│   ├── __init__.py
│   ├── adb_manager.py           # ADB 管理器（25+ ADB命令封装）
│   └── device_manager.py        # 设备管理
├── ui/                          # UI 模块
│   ├── __init__.py
│   ├── main_window.py           # 主窗口
│   ├── styles.py                # 苹果风格样式（深色/浅色主题）
│   └── widgets/                 # 自定义组件
│       ├── __init__.py
│       ├── device_list.py       # 设备列表组件
│       ├── command_panel.py     # 命令操作面板
│       ├── settings_panel.py    # 设置面板
│       ├── device_info_panel.py # 设备信息展示面板
│       ├── file_browser.py      # 文件浏览器组件
│       └── performance_monitor.py # 性能监控窗口
├── utils/                       # 工具模块
│   ├── __init__.py
│   └── helpers.py               # 辅助函数
└── resources/                   # 资源文件
    ├── __init__.py
    └── icons/                   # 图标资源
```

## 🚀 快速开始

### 安装依赖

```bash
pip install -r requirements.txt
```

主要依赖：
- PyQt6 >= 6.6.0
- matplotlib >= 3.7.0（用于性能监控图表）

### 运行程序

```bash
python main.py
```

## 💻 系统要求

- Python 3.8+
- PyQt6 6.6.0+
- matplotlib 3.7.0+
- ADB (Android Debug Bridge)

## 配置 ADB

### Windows
1. 下载 Android SDK Platform Tools
2. 将 ADB 所在目录添加到系统环境变量 PATH
3. 或在程序设置中指定 ADB 可执行文件路径

### macOS
```bash
brew install android-platform-tools
```

### Linux
```bash
sudo apt-get install android-tools-adb
```

## 📖 使用说明

### 1. 连接设备

#### USB 连接
1. 在 Android 设备上启用"开发者选项"和"USB 调试"
2. 使用 USB 线连接设备到电脑
3. 在设备上授权调试连接
4. 程序会自动检测设备

#### 无线连接
1. 确保设备和电脑在同一网络
2. 使用 USB 先连接一次设备
3. 在命令行执行: `adb tcpip 5555`
4. 断开 USB，在程序中连接设备 IP

### 2. 设备信息查看
1. 在设备列表中选择设备
2. 切换到"设备信息"标签
3. 查看硬件信息、系统信息、网络信息和电池状态

### 3. 应用管理
1. 选择设备
2. 切换到"操作"标签的"应用管理"
3. **安装应用**: 点击"浏览"选择 APK 文件，点击"安装"
4. **卸载应用**: 输入包名，点击"卸载"
5. **列出应用**: 点击"列出应用"查看所有已安装应用

### 4. 文件操作

#### 文件传输
- **推送文件**: 选择本地文件，指定设备路径，点击"推送"
- **拉取文件**: 输入设备文件路径，选择本地保存位置，点击"拉取"

#### 文件浏览器
1. 切换到"文件浏览"标签
2. 双击文件夹进入子目录
3. 右键菜单操作：
   - 创建文件/文件夹
   - 删除选中项
   - 重命名
   - 刷新列表

### 5. 屏幕操作
- **截屏**: 点击"截取屏幕"，选择保存位置（PNG格式）
- **录屏**: 设置时长（秒），点击"开始录屏"，选择保存位置（MP4格式）

### 6. Shell 命令
1. 切换到"操作"标签的"Shell"
2. 在输入框中输入命令
3. 点击"执行"或按回车
4. 查看输出区域的执行结果
5. 点击"复制输出"保存结果

### 7. 性能监控 ⭐ 新功能
1. 选择要监控的设备
2. 点击工具栏的"📊 性能模式"按钮
3. 在独立窗口中：
   - 点击"▶ 开始"启动监控
   - 实时查看 FPS、CPU、内存、GPU 数据
   - 点击"🏷️ 打Tag"标记重要时刻
   - 输入 Tag 名称或留空自动编号
   - Tag 会在所有图表上同步显示
   - 点击"⏸ 暂停"暂停数据采集
   - 点击"⏹ 停止"结束监控
4. 向下滚动查看所有性能图表
5. 切换主题会自动同步到性能窗口

### 8. 主题切换
- 点击工具栏的"🌙 深色模式"或"☀️ 浅色模式"按钮
- 主题会应用到主窗口和所有子窗口
- 性能监控图表也会自动适配新主题

### 9. 设置配置
在"设置"标签中可以配置:
- **ADB 路径**: 自定义 ADB 可执行文件路径
- **超时时间**: 设置命令执行超时（默认30秒）
- **界面主题**: 选择浅色或深色模式
- **自动刷新**: 开启设备列表自动刷新
- **刷新间隔**: 设置自动刷新时间间隔（毫秒）
- **语言**: 选择界面语言（目前支持中文）

## ❓ 常见问题

### 设备未被识别
1. 确认已启用 USB 调试
2. 尝试更换 USB 线或接口
3. 检查是否安装了正确的驱动程序
4. 运行菜单栏"ADB → 启动ADB服务"

### 设备显示为"未授权"
1. 检查设备上的授权提示
2. 勾选"始终允许这台计算机进行调试"
3. 点击"确定"
4. 如果仍未解决，尝试撤销授权后重新连接

### 命令执行失败
1. 检查 ADB 路径设置是否正确
2. 尝试重启 ADB 服务（菜单栏 → ADB → 停止/启动服务）
3. 查看输出区域的错误信息
4. 确认设备状态为"device"而非"offline"

### 性能监控数据异常
1. 确保设备已正确连接且授权
2. 部分性能数据需要 root 权限
3. 不同设备的性能数据获取方式可能不同
4. 可能使用模拟数据进行展示（开发/测试用）

### 文件浏览器无法访问某些目录
1. 部分系统目录需要 root 权限
2. Android 10+ 有存储访问限制
3. 尝试使用 Shell 命令直接访问

### 主题切换后图表显示异常
1. 关闭性能监控窗口后重新打开
2. 重启应用程序

## 🗺️ 开发计划

### 已完成 ✅
- [x] 设备管理和信息展示
- [x] 应用安装/卸载/列表
- [x] 文件传输（推送/拉取）
- [x] 文件浏览器（创建/删除/重命名）
- [x] 屏幕截图和录屏
- [x] Shell 命令执行
- [x] 系统操作（重启等）
- [x] 浅色/深色主题切换
- [x] 性能监控系统（FPS/CPU/内存/GPU）
- [x] Tag 标记功能
- [x] 响应式布局

### 计划中 🚧
- [ ] 应用备份/恢复功能
- [ ] 批量安装应用
- [ ] 文件拖拽传输
- [ ] 设备屏幕镜像
- [ ] 性能数据导出（CSV/Excel）
- [ ] 多语言支持（英文、日文等）
- [ ] 插件系统架构
- [ ] 命令历史记录
- [ ] 快捷键支持
- [ ] 设备分组管理

## 🛠️ 技术栈

- **UI 框架**: PyQt6 6.6.0+
- **图表绘制**: Matplotlib 3.7.0+
- **设计风格**: Apple Human Interface Guidelines
- **核心功能**: Android Debug Bridge (ADB)
- **配置管理**: JSON
- **架构模式**: MVC (Model-View-Controller)

## 🎯 特色功能

### 性能监控系统
- 独立窗口设计，不干扰主界面操作
- 实时数据采集（500ms 间隔）
- 120个数据点缓存，显示60秒滚动窗口
- 4种性能指标同时监控
- Tag 标记系统支持重要时刻记录
- 完美的深色/浅色主题适配
- 使用 Matplotlib 绘制专业图表

### 文件浏览器
- 类似资源管理器的操作体验
- 右键菜单快捷操作
- 支持文件和文件夹的完整生命周期管理
- 路径导航和刷新功能

### 主题系统
- 567行完整的 QSS 样式定义
- 覆盖所有 Qt 组件
- Apple 风格的颜色方案
- 实时主题切换无需重启

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

### 开发环境搭建
```bash
# 克隆仓库
git clone <repository-url>
cd adb-ui

# 安装依赖
pip install -r requirements.txt

# 运行程序
python main.py
```

### 代码风格
- 遵循 PEP 8 规范
- 使用类型注解
- 添加适当的注释和文档字符串

## 📄 许可证

MIT License

## 👨‍💻 作者

ADB UI Tool Team

## 🙏 致谢

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

---

**如果这个项目对你有帮助，欢迎 Star ⭐ 支持！**

- Android Debug Bridge
- PyQt6
- Apple Design Resources