此模块分单测试用例和多测试用例，顾名思义，我们把该目录下的一个py文件当成一个测试用例，单测试用例就只有一个符合执行要求的py文件，而多测试用例就有多个符合执行要求的py文件

1.单测试用例

需要一个py文件和一个配套的json文件，json文件配置如下

{

"description": "Config for OpenHarmony app test suites",

//environment字段主要描述测试用例需要的环境信息，如需要多少个设备

"environment": [

{

"type": "device", //device表示OpenHarmony设备

"label": "phone" //设备类型，phone为手机，tablet为平板，默认不填写则对设备无要求

}，

{

"type": "device", //多个设备时填写

"label": "phone"

}

],

// driver字段主要描述测试用例的测试驱动是什么，以及具体要执行的py脚本文件在哪（填写与当前json文件的相对路径即可）

// 不填写则在当前json文件下寻找同名py文件

// 注意：“py_file”字段当前只能填写一个py文件

"driver": {

"type": "DeviceTest",

"py_file": ["Test.py"]

}

}

单测试用例下py_file只能填写一个文件，其中文件名应改成当前目录下需要执行的py文件名，比如此处为Example.py，下面看Example.py文件内容

# !/usr/bin/env python

# coding: utf-8

"""

#!!================================================================

#版权 (C) 2023, Huawei Technologies Co.

#==================================================================

#文 件 名： Example.py

#文件说明： Example TestScript

#作 者： author

#生成日期： 2023-07-13

#!!================================================================

"""

from devicetest.core.test_case import TestCase, Step

from devicetest.utils.file_util import get_resource_path

from hypium import *

from aw import Utils

class Example(TestCase):

def __init__(self, controllers):

self.TAG = self.__class__.__name__

TestCase.__init__(self, self.TAG, controllers)

self.driver = UiDriver(self.device1)

def setup(self):

Step('1.回到桌面')

self.driver.swipe_to_home()

def process(self):

Step('2.检查短信应用版本')

mms_version = Utils.get_app_version_code(self.driver, 'com.ohos.mms')

host.check_greater(mms_version, 0)

Step('3.点击桌面上的短信')

self.driver.touch(BY.text("信息"))

def teardown(self):

Step("4. 停止短信应用")

self.driver.stop_app("com.ohos.mms")

以官方案例讲解，只有继承TestCase类的py对象才是符合测试用例执行要求的，所以当我们想自定义测试用例的时候只需要新建一个py文件创建一个继承该类的对象，并在json文件中更改用例文件即可。

继承该文件后，需要重写上面几个方法，init里面可以用来初始化一些参数。setup、process、teardown被称为测试用例生命周期函数，顾名思义，会依次执行这三个函数。

setup：测试用例的前置步骤，主要用于执行测试用例的预置动作

process：测试用例的实际操作步骤

teardown：测试用例的清除步骤，主要用来执行测试用例的环境清理等操作

其实这三个函数都能写各种逻辑，但是尽量还是按照人家赋予的含义去执行相应的逻辑，在准备好项目后可以在当前工程根目录下打开cmd命令行，执行

python -m hypium run -l Example

即可开始运行，当然，前提是你得确保鸿蒙手机连接，hdc和python均可正常执行，都没问题后就会依次执行这三个函数的步骤。

def __init__(self, controllers):

self.TAG = self.__class__.__name__

TestCase.__init__(self, self.TAG, controllers)

self.driver = UiDriver(self.device1)

self.hapBundleName = ""

self.hapFileName = ""

def setup(self):

with open('apkConfig.json', 'r') as file:

data = json.load(file)

if data is not None:

self.hapBundleName = data['hapBundleName']

self.hapFileName = data['hapFileName']

self.handleHAP(self.hapBundleName, self.hapFileName)

time.sleep(2)

self.driver.start_app(self.hapBundleName)

else:

sys.exit("未传入正确hap配置信息")

def process(self):

while True:

self.checkCurrentPage(self.hapBundleName)

try:

nodeList = self.driver.find_all_components(BY.clickable())

node = random.choice(nodeList)

if not self.checkCurrentPage(self.hapBundleName):

continue

self.driver.touch(node)

except Exception as e:

print(e)

finally:

continue

def teardown(self):

self.process()

def checkCurrentPage(self,hapBundleName) -> bool:

result = self.driver.check_window(WindowFilter().focused(True), bundle_name=hapBundleName)

if not result:

self.driver.start_app(hapBundleName)

return result

def handleHAP(self,hapBundleName,hapFileName):

self.driver.uninstall_app(hapBundleName)

self.driver.shell("mkdir data/local/tmp/8bceae19e89344d9af43ac35fcb64988")

self.driver.hdc("file send "+hapFileName+" \"data/local/tmp/8bceae19e89344d9af43ac35fcb64988\"")

self.driver.shell("bm install -p data/local/tmp/8bceae19e89344d9af43ac35fcb64988")

self.driver.shell("rm -rf data/local/tmp/8bceae19e89344d9af43ac35fcb64988")

以上是我写的demo，作用是执行当前测试用例读取当前目录下的配置文件指定的需要自动执行的应用bundlename和apk名，完成自动安装的功能，并且自动打开该应用死循环执行模拟点击按钮并在跳出指定应用后会再次回到该应用继续执行。

2.多测试用例

其实多测试用例区别不大，只需要在新建文件的时候选择Hypium TestSuite就可以自动帮我们生成多测试用例可执行的文件，以我为例

基本结构和单测试用例差不多，只不过在testcases模块变化较大，但实际上这里的json文件配置更简单

默认可以什么都不配置，但是Ts_001.py要和json名称一样，进入Ts_001.py文件

可以看到两个熟悉的函数，没错，就是整个测试过程中的周期函数，开始和结束都会执行，具体的测试用例文件则是TC_001这些，因为我们在json文件中没做任何配置，所以我们的测试用例必须要以TC_开头，这样在框架执行的时候，才会自动去寻找这些文件并依次执行，如果不按照这个命名规则则找不到文件，执行指令依然是python -m hypium run -l Ts_001

当然，如果不按照这个命名规则也是可以的，但是要严格配置json文件