# hypium-python-ui-test-skill

**Repository Path**: qpcat/hypium-python-ui-test-skill

## Basic Information

- **Project Name**: hypium-python-ui-test-skill
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-21
- **Last Updated**: 2026-04-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Hypium Python UI 测试技能模板

Hypium Python UI 自动化测试模板工程，专为 HarmonyOS 应用测试场景设计。

## 概述

本项目提供了一套完整的 Hypium Python UI 自动化测试框架模板，用于 HarmonyOS 应用的 UI 自动化测试用例开发。Hypium 是华为鸿蒙系统应用测试的核心框架，支持应用操作、控件定位与操作、滑动操作、截屏、图像识别等功能。

## 目录结构

```
├── config/
│   └── user_config.xml          # 用户配置文件
├── doc/
│   └── hypium_api_6.0.7.210.md # API 详细文档
├── testcases/
│   └── ...                     # 测试用例目录
├── src/
│   └── ...                     # 源代码目录
├── SKILL.md                    # 技能文档
└── main.py                     # 主程序入口
```

## 快速开始

### 1. 环境准备

- Python 3.x
- HarmonyOS 设备或模拟器
- Hypium 测试框架

### 2. 连接设备

```python
from hypium import UiDriver

driver = UiDriver.connect()
```

### 3. 创建测试用例

```python
#!/usr/bin/env python
# coding: utf-8

import hypium
from hypium import UiDriver
from hypium.action import app
from hypium.action import device

def test_example(self, driver: UiDriver):
    """示例测试用例"""
    # 启动应用
    driver.start_app("com.example.app")
    
    # 执行测试操作
    driver.click(text="确定")
    
    # 停止应用
    driver.stop_app("com.example.app")
```

## 常用 API

### 应用操作

```python
driver.start_app("com.example.app")  # 启动应用
driver.stop_app("com.example.app")  # 停止应用
driver.clear_app_data("com.example.app")  # 清除应用数据
driver.install_app("test.hap")     # 安装应用
driver.uninstall_app("com.example.app")  # 卸载应用
```

### 控件操作

```python
driver.click(text="确定")           # 点击文本控件
driver.click(id="confirm_button")    # 点击ID控件
driver.double_click(text="确认")     # 双击
driver.long_click(text="按钮", 5)   # 长按5秒
driver.input_text(id="input", "hello")  # 输入文本
driver.clear_text(id="input")      # 清除文本
```

### 滑动操作

```python
driver.swipe_up()                  # 上滑
driver.swipe_down()                # 下滑
driver.swipe_left()                # 左滑
driver.swipe_right()               # 右滑
driver.drag((100, 200), (300, 400))  # 拖拽
```

### 等待操作

```python
driver.wait(5)                     # 等待5秒
driver.wait_for_component(id="button")  # 等待控件出现
driver.wait_for_idle()            # 等待界面空闲
```

### 设备控制

```python
driver.press_key("power")         # 按下电源键
driver.press_home()               # 按下Home键
driver.go_home()                  # 返回桌面
driver.wake_up_display()          # 唤醒屏幕
```

### 截屏与截图

```python
driver.capture_screen("screen.png")  # 截屏
driver.take_screenshot()          # 模拟截屏
```

### 窗口操作

```python
driver.find_window(bundle_name="com.example.app")
driver.get_current_window()
driver.check_window(bundle_name="com.example.app")
```

## 测试配置文件

测试用例目录需包含配置文件，可以参考 `config/user_config.xml` 进行配置。

## 运行方式

### 命令行运行

```bash
python main.py
```

## 注意事项

1. 测试用例脚本需以 `.py` 结尾
2. 确保设备已正确连接
3. 使用等待 API 避免因操作过快导致失败
4. 定期清理测试数据确保测试环境干净

## 开发流程

1. **语法检查** - 确保代码语法正确
2. **运行测试验证** - 在设备上运行测试
3. **检查结果** - 查看测试日志确认执行情况

## API 文档

完整的 API 文档请参考 `doc/hypium_api_6.0.7.210.md` 文件。

## 许可证

本项目仅供学习交流使用。