当前位置：首页 > news >正文

鸿蒙UI自动化测试框架Hypium的使用指南

news 2025/7/18 18:57:57

1.环境准备

1.1 安装HDC

HDC是通过DevEco Studio安装的

DevEco Studio下载路径：下载中心 | 华为开发者联盟-HarmonyOS开发者官网，共建鸿蒙生态

安装DevEco Studio后，配置HDC环境变量：

# Harmony

HARMONY_SDK_HOME=/Applications/DevEcoStudio.app/Contents/sdk/default/openharmony

export HARMONY_SDK_HOME

export HARMONY_NDK_HOME=$HARMONY_SDK_HOME/native

export PATH=$PATH:$HARMONY_SDK_HOME/toolchains

PS：路径一般是默认的，路径确认方法：应用程序—>DevEco Studio—>显示包内容

1.2 安装hypium库

下载路径：下载hypium

下载文件如下：

解压后看到hypium-5.1.5.200.zip

再次解压hypium-5.1.5.200.zip，可以看到4个.tar.gz文件

进入hypium-5.1.5.200文件夹，执行：

pip3 install xdevice-5.1.5.200.tar.gz

pip3 install xdevice-devicetest-5.1.5.200.tar.gz

pip3 install xdevice-ohos-5.1.5.200.tar.gz

pip3 install hypium-5.1.5.200.tar.gz

1.3 安装调试工具Hypium插件

在Pycharm上安装DevEco Testing Hypium插件后，方便调试，找鸿蒙demo的元素

刚才下载下来的包中第一次解压后有一个文件：DevEco Testing Hypium件离线安装包

安装方法：打开pycharm，点击File -> Settings -> Plugin -> 齿轮图标 -> Install Plugin from Disk -> 选中“DevecoTesting-Hypium-5.1.5.200.zip”

配置hdc路径：

安装完成后，在pycharm 的右边会有插件图标：

插上设备

选择设备，点击【确定】后，就可以操作设备了

2. demo元素的查找

点击“放大镜搜索”按钮，在操作元素，会在右边出现元素信息

3.录制脚本

点击“摄像机”按钮，进入录制状态，操作demo控件，会在右边的文件中自动生成脚本

4.自动化脚本编写

创建driver

from hypium import *driver=UiDriver.connect(device_sn="23E0223C13000090")

device_sn的获取：hdc list targets

在工程中的封装：

HDC_PATH="/Applications/DevEcoStudio.app/Contents/sdk/default/openharmony/toolchains/hdc"
@staticmethoddef get_ohos_devices() -> list:result = []ohos_lines = os.popen(HDC_PATH + " list targets")for l in ohos_lines:if len(l)>8:result.append(l[:-1])print("get_ohos_devices：主机上的ohos设备：{}".format(result))return result

PS：当没有设备的时候，鸿蒙的hdc会返回一个[Empty]，会导致当设备为空时，传“[Empty]”给调用函数，所以用长度来控制

其他操作场景举例：

driver = UiDriver.connect(device_sn=device_sn)
#关闭app
driver.stop_app("com.netease.rtcdemo")
#卸载app
driver.uninstall_app("com.netease.rtcdemo")
#等待
driver.wait(5)
#安装app
driver.install_app(app_path)
#启动app
driver.start_app("com.netease.rtcdemo")
#授权
driver.touch(BY.key('permission_dialog_allow_button'))
#查找到第一个输入框，并输入内容
channel_name=driver.find_all_components(BY.type("TextInput"),0)
driver.input_text(channel_name,"2025070701")
#点击
driver.touch(BY.text('Join'))
#按下返回键
driver.press_back()

还有其他一些比如滑动、拖拽等操作，直接进入到uidriver.py中查看