使用python编写一个 HarmonyOS 自动化测试脚本模板

<think>我们正在为HarmonyOS编写一个自动化测试脚本模板。根据引用[1]的信息，我们知道DevEco Testing Hypium是HarmonyOS平台上的UI自动化测试框架，使用Python编写测试脚本。因此，我们将使用这个框架来编写模板。 模板需要包含以下基本要素： 1. 导入必要的模块（如hypium） 2. 定义一个测试类，该类继承自hypium的测试基类（例如Hypium） 3. 编写测试方法，方法名应以test_开头 4. 在测试方法中，我们可以使用框架提供的定位方式（如原生控件、图像、比例坐标）来定位元素，并进行操作（如点击、输入等） 5. 可以配置多设备测试（如果有需要） 6. 生成测试报告（框架会自动生成，但我们需要确保正确配置） 由于引用中提到了辅助插件（如控件查看和投屏操作），我们在编写脚本时可以利用这些工具来获取控件信息。 下面是一个基本的模板结构： ```python # 导入hypium模块 from hypium import Hypium, UiDriver class MyTestTemplate(Hypium): # 测试用例执行前的初始化操作 @classmethod def setUpClass(cls): super().setUpClass() # 测试用例执行后的清理操作 @classmethod def tearDownClass(cls): super().tearDownClass() # 每个测试方法执行前的操作 def setUp(self): super().setUp() # 获取UiDriver实例，用于后续的UI操作 self.driver = UiDriver() # 每个测试方法执行后的操作 def tearDown(self): super().tearDown() # 示例测试方法：测试应用启动 def test_start_app(self): # 使用driver进行UI操作，例如启动应用 # 假设我们要启动设置应用，我们可以通过包名和启动ability名来启动 # 注意：具体的包名和ability名需要根据实际情况填写 self.driver.start_app("com.example.settings", "com.example.settings.MainAbility") # 我们可以使用控件定位方式，例如通过id定位一个元素并点击 # 假设有一个按钮，其资源id为'button_id' button = self.driver.find_element_by_id('button_id') button.click() # 或者使用文本定位 # element = self.driver.find_element_by_text('文本内容') # 也可以使用图像定位（需要提前准备图片）或比例坐标定位（如点击屏幕中心） # self.driver.click(0.5, 0.5) # 点击屏幕中心 # 断言：例如检查某个元素是否存在 self.assertTrue(button.exists) # 另一个测试方法示例：输入文本 def test_input_text(self): # 定位到输入框 edit_text = self.driver.find_element_by_id('edit_text_id') # 输入文本 edit_text.send_keys("Hello HarmonyOS") # 检查文本是否输入成功 self.assertEqual(edit_text.get_text(), "Hello HarmonyOS") # 注意：实际使用时，需要根据具体的测试应用和场景来编写具体的定位和操作。 ``` 注意事项： - 在实际编写脚本时，需要知道被测试应用的界面元素信息（如id、文本等），可以通过DevEco Studio的控件查看工具获取。 - 多设备测试：如果需要多设备并行测试，需要在配置文件中进行设备配置，并在测试类中适当处理多设备逻辑（例如，通过self.devices获取设备列表，然后分别操作）。 - 测试报告：框架会自动生成测试报告，包括日志和截图。我们可以在测试方法中添加必要的截图点，例如在关键步骤后调用self.driver.take_screenshot()。 另外，引用[1]提到框架支持模拟输入（触摸屏、鼠标、键盘），我们在模板中已经展示了点击和输入文本的操作。 由于这是一个模板，我们只提供了基本的结构和示例。实际测试脚本需要根据具体的测试需求来填充。 相关问题： 1. 如何获取HarmonyOS应用的控件信息（如id、文本）？ 2. 如何在HarmonyOS自动化测试中使用图像定位？ 3. 如何配置多设备并行测试？ 4. 如何查看生成的测试报告？ 5. 如何处理测试中的异常情况（如元素未找到）？ 我们可以针对这些问题进一步展开讨论。</think>### HarmonyOS自动化测试脚本模板编写指南 根据DevEco Testing Hypium框架特性，以下是Python编写的HarmonyOS自动化测试脚本模板： ```python # 导入Hypium测试框架 from hypium import Hypium, UiDriver class HarmonyOSTestTemplate(Hypium): """HarmonyOS自动化测试模板类""" @classmethod def setUpClass(cls): """测试类初始化配置""" super().setUpClass() # 设备连接配置（多设备时需扩展） cls.driver = UiDriver() def setUp(self): """单个测试用例前置操作""" super().setUp() # 启动被测应用（示例为系统设置） self.driver.start_app("com.ohos.settings", "com.ohos.settings.MainAbility") def test_ui_element_operation(self): """UI元素操作示例""" # 通过控件ID定位 wifi_switch = self.driver.find_element_by_id("wifi_switch") # 验证元素状态 self.assertTrue(wifi_switch.exists, "WiFi开关未找到") # 元素操作（点击/输入等） wifi_switch.click() # 添加检查点 self.assertEqual(wifi_switch.get_text(), "已开启", "WiFi状态异常") # 截图记录关键步骤 self.driver.take_screenshot("wifi_enabled") def test_image_based_testing(self): """基于图像识别的测试示例""" # 通过图像匹配定位元素 bluetooth_icon = self.driver.find_element_by_image("bluetooth_icon.png") # 比例坐标点击（屏幕中心） self.driver.click(0.5, 0.5) # 键盘操作示例 self.driver.press_key("BACK") def tearDown(self): """测试用例后置清理""" # 返回主界面 self.driver.press_key("HOME") super().tearDown() # 多设备并行测试配置（需在hypium.json中定义） # "devices": [ # {"deviceName": "Device1", "udid": "123456"}, # {"deviceName": "Device2", "udid": "789012"} # ] ``` ### 关键功能说明： 1. **控件定位方式**： - `find_element_by_id()`：通过资源ID定位原生控件 - `find_element_by_text()`：通过文本内容定位 - `find_element_by_image()`：图像匹配定位[^1] 2. **操作模拟**： - `click()`：模拟触摸点击 - `send_keys()`：文本输入 - `press_key()`：物理按键模拟 - `swipe()`：滑动操作 3. **测试增强功能**： - `take_screenshot()`：自动截图并附加到测试报告 - 多设备并行执行（需配置文件支持） - 自动日志收集（框架内置） ### 使用流程： 1. **环境配置**： ```bash pip install hypium # 安装测试框架 hypium init # 初始化项目结构 ``` 2. **控件识别**： 使用DevEco Studio的[控件查看插件](^1)获取元素属性 3. **执行测试**： ```bash hypium run test_template.py ``` 4. **报告查看**： 测试完成后在`./reports/`目录查看含截图的HTML报告 > 提示：复杂场景可结合`Page Object`模式封装页面操作，提高脚本可维护性[^1]。