# pyop

**Repository Path**: zghmvp/pyop

## Basic Information

- **Project Name**: pyop
- **Description**: python op插件增强
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-11
- **Last Updated**: 2025-07-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# pyop

## 项目介绍
整合 `op` 与 `uiautomator2`，在op插件的基础上添加了Android设备的支持。

## 软件架构

### 主要模块
- **op**: 底层操作模块，提供屏幕捕获、图像识别等核心功能
- **uiautomator2**: Android UI自动化核心模块，提供设备控制、元素定位和用户交互功能

## 安装教程

### 前置条件
- Python 3.12
- 雷电模拟器, 开启ADB

### 安装步骤

1. 克隆项目仓库
```bash
git clone https://gitee.com/zghmvp/pyop.git
cd pyop
```

2. 安装依赖包
```bash
pip install -r requirement.txt
```

3. 连接Android设备
确保设备已通过USB连接并启用调试模式：
```bash
adb devices
```

## 使用说明

### 快速入门

```python
from pyop import U2Op

# 初始化设备连接
u2op = U2Op("emulator-5574")  # 设备序列号或ADB设备对象

# 获取屏幕截图
screenshot = u2op.screenshot(format="opencv")

# 滑动
with u2op.env():
    # 滑动
    u2op.swipe_fixed(70, 760, 649, 760, 2)
    # 找色
    ret = u2op.find_color(10, 10)
```

```python
# 获取设备信息
device_info = u2op.device_info
print(device_info)

# 获取屏幕尺寸
width, height = u2op.window_size()

# 截图并保存
u2op.screenshot("screenshot.png")
```

```python
# 查找元素并点击
u2op(text="登录").click()

# 输入文本
u2op(resourceId="com.example:id/username").set_text("testuser")

# 等待元素出现
u2op(text="欢迎").wait(timeout=10)
```

```python
# 模板匹配
with u2op.env():
    x, y, ret = u2op.find_pic(0, 0, 720, 1280, "template.png", "050505", 0.9)
    if ret == 1:
        u2op.touch(x, y)

```