# AndroidUIExplorer

**Repository Path**: xaek/android-uiexplorer

## Basic Information

- **Project Name**: AndroidUIExplorer
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-21
- **Last Updated**: 2025-06-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 安卓UI预览工具 (Android UI Explorer)

一个强大的Android UI界面分析工具，通过ADB获取安卓设备界面截图并展示当前XML标记、单个元素的全部信息，方便编写AutoJS脚本代码。

## 🌟 功能特性

- **实时截图**: 通过ADB获取Android设备实时界面截图
- **XML解析**: 自动解析并展示界面元素层级结构
- **元素定位**: 点击截图或选择元素树来定位具体UI元素
- **详细信息**: 显示选中元素的完整属性信息
- **AutoJS代码生成**: 自动生成对应的AutoJS脚本代码
- **多设备支持**: 支持同时连接多个Android设备
- **界面高亮**: 在截图上高亮显示选中的元素
- **导出功能**: 支持截图和XML的导出保存

## 📋 系统要求

- **操作系统**: Windows 10/11, macOS, Linux
- **Python**: 3.7 或更高版本
- **Android设备**: Android 4.4 或更高版本
- **ADB工具**: 已包含在项目中

## 🚀 快速开始

### 1. 克隆项目

```bash
git clone https://github.com/yourusername/android-uiexplorer.git
cd android-uiexplorer
```

### 2. 安装依赖

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

### 3. 连接Android设备

确保您的Android设备已启用开发者选项和USB调试，并通过USB连接到电脑。

### 4. 运行应用

```bash
python main.py
```

或者使用提供的启动脚本：

**Windows:**
```bash
start.bat
```

**Linux/macOS:**
```bash
./start.sh
```

## 📖 使用说明

### 基本操作

1. **连接设备**: 启动应用后，系统会自动检测连接的Android设备
2. **获取截图**: 点击"截图"按钮获取当前设备界面截图
3. **解析XML**: 点击"获取XML"按钮解析界面元素结构
4. **选择元素**: 
   - 在截图上直接点击元素
   - 或在元素树中选择目标元素
5. **查看详情**: 右侧面板会显示选中元素的详细信息
6. **生成代码**: 自动生成对应的AutoJS脚本代码

### 界面布局

- **左侧**: 界面截图显示区域，支持点击选择元素
- **中间**: 界面元素树，显示层级结构
- **右侧**: 元素详情和AutoJS代码生成区域

### 快捷键

- `F5`: 刷新界面
- `Ctrl+S`: 获取截图
- `Ctrl+E`: 导出XML
- `Ctrl+C`: 复制AutoJS代码
- `Ctrl+F`: 查找元素

## 🔧 配置说明

应用支持自定义配置，配置文件为 `config.json`：

```json
{
  "window_width": 1400,
  "window_height": 900,
  "adb_path": "adb",
  "screenshot_path": "screenshot.png",
  "xml_path": "ui.xml",
  "show_element_bounds": true,
  "highlight_clickable": true,
  "autojs_code_style": "modern"
}
```

## 📁 项目结构

```
android-uiexplorer/
├── main.py              # 主程序入口
├── adb_helper.py        # ADB工具封装
├── config.py            # 配置管理
├── xml_parser.py        # XML解析工具
├── requirements.txt     # Python依赖
├── README.md           # 项目说明
├── LICENSE             # 许可证
├── .gitignore          # Git忽略文件
├── adb/                # ADB工具目录
├── exports/            # 导出文件目录
├── logs/               # 日志文件目录
├── screenshots/        # 截图保存目录
├── start.bat          # Windows启动脚本
└── start.sh           # Linux/macOS启动脚本
```

## 🛠️ 开发说明

### 依赖库

- `tkinter`: GUI界面框架
- `Pillow`: 图像处理
- `requests`: HTTP请求
- `xmltodict`: XML解析
- `lxml`: XML处理
- `pyautogui`: 自动化操作
- `opencv-python`: 计算机视觉
- `numpy`: 数值计算

### 代码结构

- `AndroidUIExplorer`: 主应用类，负责UI界面和业务逻辑
- `ADBHelper`: ADB工具封装类，处理设备连接和命令执行
- `Config`: 配置管理类，处理应用设置
- `XMLParser`: XML解析工具类

## 🤝 贡献指南

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

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 🙏 致谢

- [AutoJS](https://github.com/hyb1996/Auto.js) - 提供自动化脚本框架
- [ADB](https://developer.android.com/studio/command-line/adb) - Android调试桥
- [Pillow](https://python-pillow.org/) - Python图像处理库

## 📞 联系方式

- 项目主页: [https://github.com/yourusername/android-uiexplorer](https://github.com/yourusername/android-uiexplorer)
- 问题反馈: [Issues](https://github.com/yourusername/android-uiexplorer/issues)

---

⭐ 如果这个项目对您有帮助，请给它一个星标！