纯血鸿蒙系统 HarmonyOS NEXT自动化测试实践

1、测试框架选择

hdc：类似 android 系统的 adb 命令，提供设备信息查询，包管理，调试相关的命令
@ohos.UiTest：鸿蒙 sdk 的一部分，类似 android sdk 里的uiautomator，基于 Accessibility 服务，提供模拟 UI 操作的能力。但是需要用arkTS语言来写自动化 case，并且用例需要打包到被测 app 里面
hypium：鸿蒙官方的自动化框架，功能比较完善，可以基于 python 编写自动化 case
hmdriver2 一个鸿蒙自动化测试py库，安装方便，语法简洁

鸿蒙自动化测试的文档中心

文档中心hmdriver2 文档：https://github.com/codematrixer/hmdriver2

查看了文档后，发现hypium是官方的自动化框架，但是安装环境比较复杂，并且他是一整套的测试框架，包括了用例套件的管理与执行等，算是比较重量级的。

hmdriver2是一个轻量级的库，流程等都不复杂，先体验一下这个

2、环境配置

配置鸿蒙HDC环境（等价于 android 端的 adb）
1. 下载 Command Line Tools 并解压
2. hdc文件在command-line-tools/sdk/HarmonyOS-NEXT-DB2/openharmony/toolchains目录下
3. 配置环境变量，macOS 为例，在~/.bash_profile 或者 ~/.zshrc 文件中添加

export HM_SDK_HOME="/Users/develop/command-line-tools/sdk/HarmonyOS-NEXT-DB2"  //请以sdk实际安装目录为准
export PATH=$PATH:$HM_SDK_HOME/hms/toolchains:$HM_SDK_HOME/openharmony/toolchains
export HDC_SERVER_PORT=7035

电脑插上手机，开启 USB 调试，确保执行hdc list targets 可以看到设备序列号

hdc常用命令文档中心

2、安装hmdirver2 基础库

pip3 install -U hmdriver2

如果需要使用屏幕录屏功能，则需要安装额外依赖opencv-python

pip3 install -U "hmdriver2[opencv-python]"
// 由于`opencv-python`比较大，因此没有写入到主依赖中，按需安装

3、代码编写

导入包后就可以连接设备，启动app,当前以安居客发布为例

from hmdriver2.driver import Driver

d = Driver("FMR0223C13000076")
d.start_app("com.anjuke.home", "EntryAbility")

然后就可以进行元素定位和操作

元素定位支持

控件查找（联合查找，模糊查找，相对查找）
控件信息获取
控件点击，长按，拖拽，缩放
文本输入，清除
获取控件树

控件查找支持这些by属性

id
key
text
type
description
clickable
longClickable
scrollable
enabled
focused
selected
checked
checkable
isBefore
isAfter

定位方式包括普通定位，模糊定位，相当定位

d(text="tab_recrod")

d(id="drag")

# 定位所有`type`为Button的元素，选中第0个
d(type="Button", index=0)

# 定位`type`为Button且`text`为tab_recrod的元素
d(type="Button", text="tab_recrod")

# 定位`text`为showToast的元素的前面一个元素
d(text="showToast", isAfter=True) 

# 定位`id`为drag的元素的后面一个元素
d(id="drag", isBefore=True)

元素操作与信息获取

d(text="tab_recrod").info

# output:
{
    "id": "",
    "key": "",
    "type": "Button",
    "text": "tab_recrod",
    "description": "",
    "isSelected": False,
    "isChecked": False,
    "isEnabled": True,
    "isFocused": False,
    "isCheckable": False,
    "isClickable": True,
    "isLongClickable": False,
    "isScrollable": False,
    "bounds": {
        "left": 539,
        "top": 1282,
        "right": 832,
        "bottom": 1412
    },
    "boundsCenter": {
        "x": 685,
        "y": 1347
    }
}

d(text="tab_recrod").click()
d(type="Button", text="tab_recrod").click()

d(text="tab_recrod").click_if_exists()

d(text="tab_recrod").double_click()
d(text="tab_recrod").long_click()

# 控件拖拽
componentB: ComponentData = d(type="ListItem", index=1).find_component()
d(type="ListItem").drag_to(componentB)  # 将元素拖动到元素B上

# 控件缩放
d(text="tab_recrod").pinch_in(scale=0.5)
d(text="tab_recrod").pinch_out(scale=2)

更多操作请看详细文档https://github.com/codematrixer/hmdriver2或hmdriver2 发布：开启鸿蒙 NEXT 自动化新时代 · 测试之家

另外元素查找可使用 uiviewer工具

安装 pip3 install -U uiviewer

启动 python3 -m uiviewer

打开页面，选择设备，点击connect，连接设备

可查看ui树，定位元素，复制xpath或者rect（元素在屏幕位置）

点击dump hierarchy刷新页面

小demo

from hmdriver2.driver import Driver

d = Driver("FMR0223C13000076")
d.start_app("com.anjuke.home", "EntryAbility")
d(text="租房", index=0).click()
for i in range(5):
    d.swipe(0.5, 0.7, 0.5, 0.5, speed=2000)
d.go_home()

实际可以结合pytest等框架进行用例管理，报告输出等

鸿蒙自动化视频