智能终端脚本编写指导手册V1.1

1 智能终端脚本编写指导手册智能终端脚本编写指导手册 产品名 智能终端脚本编写指 导手册 文档密级 保密 产品版本 V1 1 编写人 章铁明 罗胜 朱彬 陈吉强 归属部门 杭州友声科技有限公 司工程项目部 编写日期 2011 年 5 月 17 杭州友声科技有限公司杭州友声科技有限公司 20112011 年年 5 5 月月 2 目录 前言 3 一 脚本介绍 3 1 1 脚本定义 3 1 2 脚本的命名规范 3 二 脚本的结构 4 2 1 导入模板引擎简介 5 2 2 业务流程函数定义简介 5 2 3 主函数定义简介 6 2 4 调度调用简介 6 三 脚本编写 7 3 1 TestMobile 的使用 7 3 2 智能终端模板说明 11 3 3 脚本代码区编写 15 3 4 脚本编写注意事项 17 3 前言前言 脚本培训手册 内部技术材料 严禁外泄 脚本培训手册 内部技术材料 严禁外泄 一 脚本介绍一 脚本介绍 1 11 1 脚本定义脚本定义 脚本是使用一种特定的描述性语言 依据一定的格式所编写的可执行文件 自动拨测 脚本采用 Lua 语言进行编写 每个脚本将实现相应的指标自动测试 1 开发语言简介 Lua 不仅是一种易于扩展的语言 也是一种易整合语言 glue language Lua 支持 基于组件的 可以将一些已经存在的高级组件整合在一起实现一个应用软件 Lua 使用者分为三大类 使用 Lua 嵌入到其他应用中 独立使用 Lua 将 Lua 和 C 混 合使用 自动拨测脚本独立使用 LUA 编写 2 Lua 安装 双击安装文件 按照提示信息安装在默认路径即可 1 21 2 脚本的命名规范脚本的命名规范 按照拨测系统的规范 上传的脚本命名格式为 公司名公司名 终端品牌终端品牌 型号型号 业务编号业务编号 指标编号指标编号 省份省份 脚本最后修改时间 脚本最后修改时间 公司名 杭州友声公司名 杭州友声 品牌 终端产商品牌 终端产商 4 型号 终端型号型号 终端型号 业务 指标编号 移动增值业务 指标编号业务 指标编号 移动增值业务 指标编号 省份 北京 浙江 省份 北京 浙江 例如例如 杭州友声杭州友声 Dopod Dopod T8388 705 002 T8388 705 002 北京北京 20110429120000 20110429120000 二 脚本的结构二 脚本的结构 一个脚本主要由四部分组成 分别为 导入模板引擎部分 业务流程函数定义部分 一个脚本主要由四部分组成 分别为 导入模板引擎部分 业务流程函数定义部分 主函数定义部分 调度调用部分 主函数定义部分 调度调用部分 require ServTemplate 导入模板 引擎 function uusense 业务流程函数定义 end function uusenseMain ParmId ParmSysParms ParmUsrParms 主函数定义 end LUACreateDKSuitService 调度调用部分 Id 100 SysParms CODE 860186000589172 ADDR 99 MOUD ANDROID PATH d uusense images UsrParms uusenseMain Id SysParms UsrParms 5 图图 2 12 1 2 12 1 导入模板引擎简介导入模板引擎简介 导入模板引擎部分只有一行代码 但千万不能没有这行代码但千万不能没有这行代码 require ServTemplate 2 22 2 业务流程函数定义简介业务流程函数定义简介 业务流程函数定义部分包括终端初始化 业务流程代码 终端清理 1 终端初始化 完成测试设备名获取 测试计时开始 进程清理 控制对象创建等工作 DeviceName getDeviceNameConfig SysParms if DeviceName then return 0 end 6 devcount oDev Device DeviceInit Id DeviceName SysParms UsrParms if devcount 0 then return 1 end oMobile oDev 1 2 业务流程代码 业务流程定义 业务流程函数调用 A 业务流程定义 是脚本编写的主体 如图是脚本编写的主体 如图 2 12 1 内的标注内的标注1 1处处 DeviceCommandList B 业务流程函数调用 ret Serv ALL OneAction Id oMobile SysParms DeviceName DeviceCommandList 注 注 将定义好的业务流程将定义好的业务流程 DeviceCommandListDeviceCommandList 传入函数的第传入函数的第 5 5 个参数内 如图个参数内 如图 2 12 1 内的标注内的标注2 2 处 处 C 目前可供调用的智能终端业务流程函数有两个 Serv ALL OneAction 和 Serv WAP WAPOrderAndCancel 具体请参考 WAP 客户端 短彩单流程统一模板 lua 3 终端清理 完成测试计时结束 控制对象释放等工作 Device DeviceUnInit Id DeviceName SysParms UsrParms 2 3 主函数定义简介主函数定义简介 主函数定义部分 除了指标名需作修改外 如图如图 2 12 1 内的标注内的标注3 3处处 其他地方无需改 动 注 若该脚本需出多个指标 需相应增加 ExecuteScriptResultLog Id SysParms UsrParms 指标名 1 err 代码段个数 如 注意 此处指标名后面必须带上注意 此处指标名后面必须带上 1 1 2 42 4 调度调用简介调度调用简介 1 调度调用部分 是脚本编写人员直接用 LUA 调试运行脚本必不可少的部分 7 当需要调试运行时 我们可将调度调用部分注释代码去除 以 开头 结尾的 多行注释代码 其中需要修改的部分是配置信息 CODE 862030981531332 ADDR 99 MOUD ANDROID PATH D uusense images 如图如图 2 12 1 内的标注内的标注4 4处处 2 配置项 CODE IMEI 号 ADDR 端口号或蓝牙串号 Android 终端端口号无效 可配为 99 WindowsMobile 终端需配 蓝牙串号 MOUD 终端操作系统 PATH 图片保存路径 注 注 PATHPATH 必须是脚本图片存放的路径必须是脚本图片存放的路径 PATHPATH 路径配置目录间需用路径配置目录间需用 分隔分隔 参数配置项最后必须以参数配置项最后必须以 结束结束 3 3 注意注释注意注释 当脚本编写人员完成对脚本的调试后 必须将脚本的调度调用部分进行注释 以当脚本编写人员完成对脚本的调试后 必须将脚本的调度调用部分进行注释 以 开头开头 结尾进行多行代码注释 结尾进行多行代码注释 以免 以免 TestAgentTestAgent 调度脚本运行时 重复运行脚调度脚本运行时 重复运行脚 本 本 三 脚本编写三 脚本编写 首先 对需要编写脚本的测试指标 最好先进行一次人工测试 参照操作手册 这 对熟悉业务流程有很大帮助 同时也能避免走一些脚本编写的弯路 3 13 1 TestMobileTestMobile 的使用的使用 1 1 TestMobileTestMobile 配置配置 TestMobile 文件夹内包含有 config ini TestList txt 配置文件 TestMobile exe 可执行程序以及一些动态库文件 A config ini 配置文件 与 TestMobile 使用相关的配置是 imgs d uusense images 为 TestMobile 截图后存放图片的路径 8 图 3 1 B TestList txt 配置文件 TestList txt 为 TestMobile 需进行连接的终端配置信息 如下图 3 2 图 3 2 一条终端连接配置信息 包括 序号 终端型号 终端操作系统 IMEI 号 端口 号 注 配置信息间以注 配置信息间以 TABTAB 键分隔 非空格符 键分隔 非空格符 终端型号 终端操作系统名必须按规 终端型号 终端操作系统名必须按规 定填写 新增配置记录时建议复制一条相似的配置记录后再进行修改 以免出现定填写 新增配置记录时建议复制一条相似的配置记录后再进行修改 以免出现 TestMobileTestMobile 打开不了打开不了 FLASHFLASH 界面或连接不了终端的情况 界面或连接不了终端的情况 C TestMobile exe 程序 双击 TestMobile exe 打开应用程序 选择 菜单 测试列表 界面将 TestList txt 配置的记录显示在列 如下图 3 3 图 3 3 9 2 2 TestMobileTestMobile 进行终端连接进行终端连接 A 在图 3 3 的界面中 双击需要进行连接的终端配置记录 如 双击第 1 条记录 弹出 MT710 的 FLASH 界面 如图 3 4 图 3 4 B 在出现的 FLASH 框体内 右键鼠标 选择连接设备 如图 3 5 图 3 5 C 若连接成功 FLASH 内将展现手机终端上的实时图象 如图 3 6 图 3 6 3 3 TestMobileTestMobile 截图截图 A 在 FLASH 内右键 流程录制 弹出 流程录制 窗体 如图 3 7 10 图 3 7 B 在 FLASH 内 鼠标左击终端屏幕或按键 流程录制 窗体内将显示你所点击 的屏幕坐标或按键键值 如图 3 8 TOUCH 就是你所点的终端屏幕坐标 62 343 KEY 则是你所点的按键 M 图 3 8 C 在确保当前选中窗体是 FLASH 窗体的情况下 按一下空格键 鼠标左键拖选 需要截图的区域 红色框体 如图 3 9 区域即为需截图区 按组合键 CTRL S 待 红色框体消失 即完成截图 截图后的图片信息显示在流程录制框体内 而图片 则保存在所配文件路径下 图 3 9 D 流程录制窗体内 我们只需要获取带 的图片信息即可 如图 3 10 内的 62 215 187 278 Motorola MT710 20110514172607640 png 我们对最后的时 间戳信息加以合理地修改 改名为如 62 215 187 278 Motorola MT710 待机 界面 png 11 图 3 10 E 再将修改后的图片名复制 将图片保存目录下对应的 png 图片名替换之 即 完成了 TestMobile 截图工作 如图 3 11 图 3 11 3 23 2 智能终端模板说明智能终端模板说明 1 模板方法 在模板文件 WAP 客户端 短彩单流程统一模板 lua 有说明 A KEY 按键 TOUCH 触摸 MOVE 滑屏 三个动作 在模板方法内虽是分开写的 实际在用时 3 个方法是一样的 12 可合并在一起写 比如 M 58 410 10 66 247 10 63 247 10 63 250 多个动作间以多个动作间以 分隔 分隔 KEY 键值 动作完成后等待秒数 动作重复次数 TOUCH x 坐标 y 坐标 动作完成后等待秒数 动作重复次数 MOVE xa ya xb yb 滑屏动作时长 动作完成后等待秒数 动作重复 次数 除 SLEEP TITLE 动作外 其余动作的第 4 项 是比对图片参数 图片比对 可多张轮流比对 以适应各种测试需求 如 结果 1 png 结果 2 png 60 多张图片以多张图片以 分隔分隔 图片总比对超时时间以 分隔 若不设置超时时 间 则默认 60 秒 以下其余动作相同 将不作赘述 以下其余动作相同 将不作赘述 也可单张比对而走不同流程 如 结果 png 则图片比对通过走第一个流 程 比对失败则走第 2 个流程 如 结果 png 则图片比对失败走第一个 流程 比对通过则走第 2 个流程 第 5 项为动作名 当需要出指标时 此处填指标名称 指标名称必须以 指标名称必须以 ResultTitle txt ResultTitle txt 内为准 内为准 如果在此动作需出多个指标 则指标名间以 如果在此动作需出多个指标 则指标名间以 分隔 如仅是测试的一个中间动作 请不要填与任何指标名称完全一分隔 如仅是测试的一个中间动作 请不要填与任何指标名称完全一 致的名称作为动作名 致的名称作为动作名 B DBTOUCH 双击 与 TOUCH 类似 x 坐标 y 坐标 动作完成后等待秒数 动作重复次数 只是所填坐标位置将进行双击动作 C SLEEP 延迟 第 3 项参数为需要延迟的时间秒数 第 4 项为空 D INPUT 输入 必须确保终端已运行到输入位置 终端输入键盘已展开 的情况下开始必须确保终端已运行到输入位置 终端输入键盘已展开 的情况下开始 INPUTINPUT 动动 作 作 第 3 项参数为输入的内容 如输入内容带有 MNUM 字符串 则 INPUT 动作自动 将其替换成 config ini 内配置的对应测试终端 MNUM 配置手机号码 E PSTVPIC 正向比对图片 也响应触屏动作 x y 动作重复次数 但不支持按键和滑屏 以下三个动作以下三个动作 类似 类似 图片正向比对 比对成功则完成该动作 F PSTVBUF 正向缓冲 超时时间内图片比对成功次数 连续成功计 1 次 超时时间到则完成该动作 G RVRSPIC 反向比对图片 图片反向比对 比对失败则完成该动作 H RVRSBUF 反向缓冲 超时时间内图片比对失败次数 连续成功计 1 次 超时时间到则完成该动作 13 在可以以正向比对或缓冲完成测试的情况下 不建议采用反向动作 在可以以正向比对或缓冲完成测试的情况下 不建议采用反向动作 I RATE 速率 从第 3 项的首个动作开始计时 以第 6 项 文件大小 单位 KB 除以耗时为速率 若图片比对超时则认为速率指标失败 指标名可多个 如成功率和速率 J TITLE 出指标 出指标 第 3 项参数为 Y 则出成功指标 为 N 则出失败指标 第 5 项必须是指 标名 K 0 附属流程 第 1 项为 0 代表此动作为上一动作的附属流程动作 附属流程动作只记录成功 于否 并将其主流程结果进行替换 L URL WAP 地址输入访问 WAP 专用方法 访问 URL 地址 并比对图片 M HASBEEN WAP 已订购或退订凭证 WAP 专用方法 已订购或退订的关键图片凭证 N CLEARSMS 清空收件箱 短信专用方法 清理收件箱信息 第 3 4 项填空 O SENDSMS 发短信 短信专用方法 发送短信息 必须从收件箱位置开始 必须从收件箱位置开始 第 4 项填空 P RECVSMS 收短信 短信专用方法 接收短彩信 第 3 个参数带 nosms 时 为不接收短信 图片后带标志 1 的不 删除该短信 第 3 个参数带 t8388push 时 为 T8388 接收 Push 短信 另两款终 端短信和 PUSH 短信接收可通用 必须从收件箱位置开始 必须从收件箱位置开始 Q REPLYSMS 回复短信 短信专用方法 回复短信 第 3 项为需回复的指令 必须从需回复的信息详细内容查看位置开始 必须从需回复的信息详细内容查看位置开始 2 WAP 订购退订模板附属说明 WAP 订购退订模板需定义订购 退订 2 个流程表 并调用 Serv WAP WAPOrderAndCancel Id oMobile SysParms DeviceName WAP ORDE R ACTION WAP CANCLE ACTION 模板函数 如果第一个订购流程走到第 N 步为已订购 第 2 个退订流程则从订购流程的 第 N 步开始走 以节省测试时间 如果第 2 个流程必须从头开始 则在第 2 个流程第一个动作名前加 如 URL 3 脚本流程说明 14 脚本主流程定是以 1 为第一项参数 若有分支 则在分支处主流程判断 N 张分 支图片 以分别走 11 12 流程 以下是流程示意图 写成脚本流程 则如下 1 1 11 111 111 12 121 0 0 确定主流是否通过 1 1 1 1112 121122 11 122 122 111 111 1 0 0 15 122 122 122 1 1 3 33 3 脚本代码区编写脚本代码区编写 1 脚本代码区示例 2 脚本代码说明 A 脚本动作表变量命名 只是一个变量名称 尽量取与实际流程相符合的名称 如 WAP ACTION SMS ACTION CLIENT ACTION 等 B 第 1 个动作定义 点击屏幕坐标 85 179 后比对 2 张图片 图片 1 飞信登录成功的情况下 比对图片 21 60 67 78 Motorola MT710 登录成功 png 图片 2 尚未注册飞信 登陆时提示需进行注册的情况 比对图片 83 186 111 208 Motorola MT710 未登录飞信 png C 第 2 个动作定义 动作 1 的第 1 个分支流程动作 1 动作 1 的图片 1 比对成功 则表 明登陆成功 故直接出指标 D 第 3 个动作定义 动作 1 的