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

智能终端脚本编写指导手册 产品名： 智能终端脚本编写指导手册 文档密级： 必威体育官网网址 产品版本： V1.1 编写人: 章铁明、罗胜、朱彬、陈吉强 归属部门 杭州友声科技有限公司工程项目部 编写日期： 2011年5月17 杭州友声科技有限公司 2011年月前言 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 前言 脚本培训手册，内部技术材料，严禁外泄。 一、脚本介绍 1.1 脚本定义 脚本是使用一种特定的描述性语言，依据一定的格式编写的可执行文件安装文件，按照提示信息安装在默认路径即可。 1.2 脚本的命名规范 按照拨测系统的规范，上传的脚本命名格式为： 公司名_终端品牌 型号_业务_省份_脚本最后修改时间。 公司名：杭州友声 品牌型号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) 图2.1 2.1 导入模板引擎简介 导入模板引擎部分只有一行代码(但千万不能没有这行代码)： require ServTemplate 2.2 业务流程函数定义简介 业务流程函数定义部分包括终端初始化、业务流程代码、终端清理。 终端初始化(完成测试设备名获取、测试计时开始、进程清理、控制对象创建等工作) DeviceName = getDeviceNameConfig(SysParms); if DeviceName == then return 0; end; devcount,oDev = Device_DeviceInit(Id,DeviceName,SysParms,UsrParms); if devcount == 0 then return -1 end; oMobile = oDev[1]; 业务流程代码(业务流程定义、业务流程函数调用) A、业务流程定义(是脚本编写的主体，如图2.1内的标注1处)： DeviceCommandList ={ …………….. } B、业务流程函数调用：ret=Serv_ALL_OneAction(Id,oMobile,SysParms,DeviceName,DeviceCommandList)；注：将定义好的业务流程DeviceCommandList传入函数的第5个参数内，如图2.1内的标注2处。 C、目前可供调用的智能终端业务流程函数有两个，Serv_ALL_OneAction和Serv_WAP_WAPOrderAndCancel（具体请参考“WAP-客户端-短彩单流程统一模板.lua”） 终端清理(完成测试计时结束、控制对象释放等工作) Device_DeviceUnInit(Id,DeviceName,SysParms,UsrParms) 2.3主函数定义简介 主函数定义部分，除了指标名需作修改外(如图2.1内的标注3处)，其他地方无需改动。 注：若该脚本需出多个指标，需相应增加“ExecuteScriptResultLog(Id,SysParms,UsrParms,指标名,-1,err);”代码段个数，如： 注意：此处指标名后面必须带上“,-1”。 2.4 调度调用简介 调度调用部分，是脚本编写人员直接用LUA调试运行脚本必不可少的部分。 当需要调试运行时，我们可将调度调用部分注释代码去除（以‘—[[’开头‘]]’结尾的多行注释代码）。其中需要修改的部分是配置信息CODE=862030981531332,ADDR=99,MOUD=ANDROID,PATH=D:\\uusense\\images|(如图2.1内的标注4处)。 配置项。 CODE：IMEI号 ADDR：端口号或蓝牙串号(Android终端端口号无效，可配为99；WindowsMobile终端需配蓝牙串号) MOUD：