本文主要是介绍鸿蒙南向开发:测试框架xdevice核心组件,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
简介
xdevice是OpenHarmony中为测试框架的核心组件,提供用例执行所依赖的相关服务。
xdevice主要包括以下几个主要模块:
- command,用户与测试平台命令行交互模块,提供用户输入命令解析,命令处理。
- config,测试框架配置模块,提供测试平台串口连接方式和USB连接方式的不同配置选项。
- driver,测试用例执行器,提供测试用例分发,执行,结果收集等主要测试步骤定义。
- report,测试报告模块,提供测试结果解析和测试报告生成。
- scheduler,测试框架调度模块,提供不同类型的测试执行器调度的调度功能。
- environment,测试框架的环境配置模块,提供设备发现,设备管理的功能。
- testkit,测试框架工具模块,提供json解析,网络文件挂载等操作。
- resource,测试框架资源模块,提供设备连接配置文件和报告模板定义。
目录
xdevice
├── config # xdevice组件配置
│ ├── user_config.xml # xdevice环境配置
├── resource # xdevice组件资源
│ ├── tools # 版本烧录工具
├── src # 组件源码目录
│ ├── xdevice
├── extension # xdevice扩展模块
│ ├── src # 扩展模块源码
│ └── setup.py # xdevice扩展模块安装脚本
约束
运行环境要求:
- python版本>=3.7.5
- pyserial>=3.3
- paramiko>=2.7.1
- rsa>=4.0
使用
-
安装xdevice
-
打开xdevice安装目录。
-
打开控制台,执行如下命令:
python setup.py install
-
-
安装extension
-
打开extension安装目录。
-
打开控制台,执行如下命令:
python setup.py install
-
-
修改user_config.xml
user_config.xml是框架提供的用户配置文件,用户可以根据自身环境信息配置相关内容,具体介绍如下:
1、environment环境相关配置:
-
设备类型一
说明: ip/port: 表示远程设备地址,默认情况为空,表示使用本地设备,ip地址为127.0.0.1,port为本机hdc启动端口号;sn: 过滤执行测试设备,若设置为SN1,则表示只有设备SN1能够支持后续run命令执行,其他设备分配状态设置为Ignored,不参与命令执行,可通过list devices命令中Allocation字段来查看sn设置,可配置多个sn,中间以;隔开;
-
设备类型二
说明: type: 设备连接方式,com表示连接方式是串口 label: 表示设备种类,如wifiiot serial: 表示一个串口定义 serial/com 表示本地连接的串口,如COM20 serial/type 表示串口类型,cmd是命令串口,deploy是刷机串口,社区版本cmd和deploy使用同一个串口,com值相同 serial/baud_rate、data_bits、stop_bits、timeout: 为串口波特率等串口参数 ,一般采用默认值即可。
2、测试用例目录设置
dir: 指定测试用例目录。
3、nfs挂载
说明: server: nfs挂载配置,label取值为NfsServer。 server/ip: 挂载环境IP地址。 server/port: 挂载环境端口。 server/username: 登录用户名。 server/password: 登录用户密码。 server/dir: 对应挂载的外部路径。 server/remote: nfs服务器与xDevice执行机不在同一台机器时,remote配置为true,否则为false。
-
-
选定任务类型
-
启动框架
-
执行指令
框架指令可以分为三组:help、list、run。在指令序列中,以run为最常用的执行指令。
1、help
输入help指令可以查询框架指令帮助信息。
help:use help to get information. usage:run: Display a list of supported run command.list: Display a list of supported device and task record. Examples:help runhelp list
说明: help run:展示run指令相关说明 help list:展示 list指令相关说明
2、list
list指令用来展示设备和相关的任务信息
list:This command is used to display device list and task record. usage:listlist historylist <id> Introduction:list: display device listlist history: display history record of a serial of taskslist <id>: display history record about task what contains specific id Examples:listlist historylist 6e****90
说明: list: 展示设备信息 list history: 展示任务历史信息 list <id>: 展示特定id的任务其历史信息
3、run
run指令主要用于执行测试任务
run:This command is used to execute the selected testcases.It includes a series of processes such as use case compilation, execution, and result collection. usage: run [-l TESTLIST [TESTLIST ...] | -tf TESTFILE[TESTFILE ...]] [-tc TESTCASE] [-c CONFIG] [-sn DEVICE_SN][-rp REPORT_PATH [REPORT_PATH ...]][-respath RESOURCE_PATH [RESOURCE_PATH ...]][-tcpath TESTCASES_PATH [TESTCASES_PATH ...]][-ta TESTARGS [TESTARGS ...]] [-pt][-env TEST_ENVIRONMENT [TEST_ENVIRONMENT ...]][-e EXECTYPE] [-t [TESTTYPE [TESTTYPE ...]]][-td TESTDRIVER] [-tl TESTLEVEL] [-bv BUILD_VARIANT][-cov COVERAGE] [--retry RETRY] [--session SESSION][--dryrun] [--reboot-per-module] [--check-device][--repeat REPEAT]action task Specify tests to run.positional arguments:action Specify actiontask Specify task name,such as "ssts", "acts", "hits"
说明: 一个基本的run指令结构如下:
run [task name] -l module1;moudle2
task name:任务类型。一般为ssts、acts、hits。非必选项 -l :指定执行测试用例,多个测试用例,中间用;隔开 module:被测试的模块。一般在testcases目录下存在对应的\.json文件 此外,其他参数可以作为约束条件,附加到这个基本指令之上使用。常用的如: -sn: 过滤执行测试设备,若设置为SN1,则表示只有设备SN1执行用例 -c: 重新指定user_config.xml。 -rp: 报告生成路径。默认为xxx/xdevice/reports目录。指定目录后,优先级:指定目录>xxx/xdevice/reports目录。 -tcpath:环境目录,默认为xxx/xdevice/testcases目录。指定目录后,优先级:指定目录>xxx/xdevice/testcases目录 -respath:测试套目录,默认为xxx/xdevice/resource目录。指定目录后,优先级:指定目录>xxx/xdevice/resource目录 --reboot-per-module: 执行前先重启设备
-
查看执行结果
框架执行run指令,控制台会输出对应的log打印,还会生成对应的执行结果报告。如果使用了-rp参数指定报告路径,那么报告就会生成在指定的路径下。否则报告会存放在默认目录。
当前报告目录(默认目录/指定目录)├── result(模块执行结果存放目录)│ ├── <模块名>.xml│ ├── ... ... │ ├── log (设备和任务运行log存放目录)│ ├── <设备1>.log│ ├── ... ...│ ├── <任务>.log├── summary_report.html(测试任务可视化报告)├── summary_report.html(测试任务数据化报告)└── ... ...
最后
小编在之前的鸿蒙系统扫盲中,有很多朋友给我留言,不同的角度的问了一些问题,我明显感觉到一点,那就是许多人参与鸿蒙开发,但是又不知道从哪里下手,因为资料太多,太杂,教授的人也多,无从选择。有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以有一份实用的鸿蒙(HarmonyOS NEXT)资料用来跟着学习是非常有必要的。
为了确保高效学习,建议规划清晰的学习路线,涵盖以下关键阶段:
希望这一份鸿蒙学习资料能够给大家带来帮助~
鸿蒙(HarmonyOS NEXT)最新学习路线
该路线图包含基础技能、就业必备技能、多媒体技术、六大电商APP、进阶高级技能、实战就业级设备开发,不仅补充了华为官网未涉及的解决方案
路线图适合人群:
IT开发人员:想要拓展职业边界
零基础小白:鸿蒙爱好者,希望从0到1学习,增加一项技能。
技术提升/进阶跳槽:发展瓶颈期,提升职场竞争力,快速掌握鸿蒙技术
2.视频学习资料+学习PDF文档
(鸿蒙语法ArkTS、TypeScript、ArkUI教程……)
纯血版鸿蒙全套学习资料(面试、文档、全套视频等)
鸿蒙APP开发必备
总结
参与鸿蒙开发,你要先认清适合你的方向,如果是想从事鸿蒙应用开发方向的话,可以参考本文的学习路径,简单来说就是:为了确保高效学习,建议规划清晰的学习路线
这篇关于鸿蒙南向开发:测试框架xdevice核心组件的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!