# 核心概念

# 项目

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

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

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

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

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

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

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

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

用例是执行的最小单位，主要包括：

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

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

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

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

目前支持的步骤如下：

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

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

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