# 核心概念

# 项目

一个项目通常代表一个应用,如果一个业务方有多个应用,那么可以创建多个项目。

# 模块

模块主要的用途是来帮助整理、记忆、筛选用例数据的。

# 控件

轻舟中通过多个关键信息来定位一个控件,主要是ID、文本、Class、XPath、默认选择第几个。

字段 含义 默认值
名称 自己拟定,根据实际情况取名称
页面 原控件本身不存在页面,这只是为了方便记忆和归类而抽象出来的,
你可以将实际应用的一个或多个页面当做一个页面,并取一个名称
控件ID 来自UIAutomatorViewer中resource-id,只包含:id/后的部分
控件文本 来自UIAutomatorViewer中的text
控件Class 来自UIAutomatorViewer中的class
控件XPath 来自UIAutomatorViewer中控件的结构,此值在轻舟中暂时无法使用
默认选择 表示当找到多个控件后,默认选择第几个作为结果,通常用于查找列表中的某项 不选择
模块 标记此控件属于哪个模块,方便记忆

默认选择第几个有如下枚举:

  1. 不选择
  2. 全部(暂时无效)
  3. 随机
  4. 中间
  5. 第一个
  6. 第二个
  7. 第三个
  8. 第四个
  9. 第五个
  10. 第六个
  11. 第七个
  12. 第八个
  13. 第九个
  14. 第十个
  15. 倒数第一个
  16. 倒数第二个
  17. 倒数第三个

默认值是不选择,那么在找到多个相同条件的控件时,会认为没找到控件。

ID、文本、Class、XPath中,只要设置了值,那么查找控件就要满足这个条件,如果不设置,则自动忽略此条件。

在【单步调试】中,查找控件只发生一次,不管有没有查找到控件都结束查找。而在其他执行查找的场景,如【调试所有步骤】和执行场景,查找控件的结束条件则是找到控件或超时,超时时间是15秒

# 用例

用例是执行的最小单位,主要包括:

字段 含义 默认值
名称 用例名称,可跟其他用例重复,但不建议重复
编号 用例编号,可跟其他用例重复,但不建议重复,仅用来方便记忆
描述 建议清晰描述用例的执行要求和所做的事情
配置 用例配置,用来控制用例的执行方式
步骤列表 用例关联的一系列步骤
模块

# 用例配置

用于控制一个用例的执行方式,主要包括:

字段 含义 默认值
配置名称 自己拟定
包名 被测应用的包名
版本 被测应用的版本,不要求是真实版本
加载方式 目前仅支持”直接启动“,需要预先在手机上安装被测应用 直接启动
是否重新安装 是:表示会卸载手机里同包名的应用,然后重新安装APP,
加载方式不能为”直接启动“,不过目前不支持。
是否执行完后卸载 是:表示关联的用例执行完后自动卸载被测应用
是否清除缓存 是:表示会清理应用缓存,清理后应用恢复到首次安装的状态
是否录制视频 是:表示会录制用例的执行过程,并生成执行视频
是否关闭应用 是:表示在用例执行开始或者结束,是否关闭自己
是否开启性能监控 是:监控在用例执行过程中,被测应用的CPU、内存使用情况
(暂时无效)

# 步骤

步骤是用例的组成部分,多个步骤组成一条用例,描述的是用例的执行流程。

目前支持的步骤如下:

步骤名称 含义
点击控件 找到一个控件,然后点击之
控件赋值 找到一个控件,然后获取它的文本,赋值给指定变量
长按控件 找到一个控件,然后长按之,可设定长按时间
控件输入 找到一个控件,然后输入一个文本或变量
检查控件 找到一个控件,判断它存在或不存在,如果判断失败,则用例执行失败
检查变量 检查一个变量是否满足指定的要求,如果判断失败,则用例执行失败
屏幕滑动 以整个手机屏幕为标准,按指定方向滑动n次
控件内滑动 找到指定控件,在控件区域访问内,按指定方向滑动n次
控件内滚动查找(并点击) 找到指定控件,在控件区域内查找指定文本或变量,如果一个方向滚动查找不到,则按反方向滚动查找,超时时间为30秒
如果(控件) 判断一个控件是否存在或不存在,如果满足条件,则执行【如果】->【结束】之间的步骤
循环 执行【循环】->【结束】之间的步骤n次
结束 如果和循环步骤的结束标记,如果他们没有结束标记,则用例根本不会执行,会提示用例结构错误!

# 场景

场景描述的是一段测试流程,通过一个或多个用例组成。

# 设备

在轻舟【我的设备】页面中,包含设备的管理,设备管理实时监控本机电脑上插入的设备。

image-20200901193257684