# app-web

**Repository Path**: nachao/app-web

## Basic Information

- **Project Name**: app-web
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-05
- **Last Updated**: 2026-02-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 模拟器查看器

基于 ADB 的模拟器查看和控制工具，可以通过 Web 界面实时查看和操作 Android 模拟器。

## 功能特性

- 📱 实时查看模拟器屏幕
- 🖱️ 点击屏幕进行交互
- 🔄 自动刷新屏幕画面
- 📋 设备列表管理
- 🎨 现代化 Web 界面
- ⚡ **纯 ADB 模式**：无需 Appium Server，开箱即用
- 🔄 **可选 Appium 模式**：支持高级自动化功能

## 环境要求

- Python 3.7+
- Android 模拟器（已启动）
- ADB 工具（路径：`D:\leidian\LDPlayer9\adb.exe`）
- (可选) Appium Server - 仅在需要使用 Appium 模式时

## 安装步骤

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

如果遇到 SSL 连接问题，可以使用国内镜像源：
```bash
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
```

2. 启动模拟器并确保 ADB 可以检测到设备：
```bash
D:\leidian\LDPlayer9\adb.exe devices
```

3. 运行应用：
```bash
python appium_viewer.py
```

4. 打开浏览器访问：
```
http://localhost:5000
```

## 使用模式

### ADB 模式（默认，推荐）

- ✅ **无需额外安装**：不需要 Appium Server
- ✅ **快速启动**：直接使用 ADB 命令
- ✅ **轻量级**：依赖少，运行稳定

### Appium 模式（可选）

如果需要使用 Appium 的高级功能（如元素定位、复杂手势等），可以：

1. 安装 Appium Server：
```bash
npm install -g appium
```

2. 启动 Appium Server：
```bash
appium
```

3. 在 Web 界面连接时选择 Appium 模式

## 使用说明

1. **连接设备**：
   - 点击"刷新设备列表"查看可用设备
   - 从下拉菜单中选择要连接的设备
   - 点击"连接设备"建立连接

2. **查看屏幕**：
   - 连接成功后，点击"获取截图"查看当前屏幕
   - 或点击"自动刷新"开启每秒自动刷新

3. **交互操作**：
   - 在屏幕图像上点击即可发送点击事件到模拟器
   - 点击坐标会显示在底部信息栏

## 配置说明

如需修改 ADB 路径或 Appium 服务器地址，请编辑 `appium_viewer.py` 中的以下变量：

```python
ADB_PATH = r"D:\leidian\LDPlayer9\adb.exe"
APPIUM_SERVER = "http://localhost:4723"
```

## 注意事项

- **默认使用 ADB 模式**，无需启动 Appium Server
- 确保模拟器已启动并可以被 ADB 检测到
- 确保指定的 ADB 路径正确
- 如果连接失败，请检查 ADB 是否能正常访问设备
- 如需使用 Appium 模式，请确保 Appium Server 正在运行

## 故障排除

1. **无法检测到设备**：
   - 检查 ADB 路径是否正确（默认：`D:\leidian\LDPlayer9\adb.exe`）
   - 运行 `D:\leidian\LDPlayer9\adb.exe devices` 确认设备已连接
   - 确保模拟器已完全启动

2. **截图失败**：
   - 确认设备已成功连接
   - 检查设备是否正常运行
   - 尝试重新连接设备
   - 检查 ADB 权限（某些设备可能需要授权）

3. **点击无效**：
   - 确认设备已连接
   - 检查坐标是否正确
   - 某些应用可能需要特殊权限

4. **Appium 模式连接失败**（如果使用）：
   - 确认 Appium Server 正在运行
   - 检查端口 4723 是否被占用
   - 查看 Appium Server 日志获取详细错误信息
   - 建议使用 ADB 模式（默认模式）