MobileRunner技术白皮书.doc

MobileRunner移动设备自动化测试软件技术白皮书泽众软件目录1产品理念- 3 -1.1系统定位- 3 -1.2适用范围- 3 -2系统构架- 3 -3对外编程接口API- 4 -3.1API定义- 4 -4系统基本功能- 7 -4.1 测试案例创建- 7 -4.2 测试案例录制- 7 -4.2 测试案例执行- 12 -4.3 测试报告分析- 13 -1产品理念1.1系统定位MobileRunner1.2.2.4（下文简称“MR”）是上海泽众软件科技有限公司开发的，拥有自主产权的移动设备自动化测试工具，缩写MR。MR是伴随着移动设备测试自动化的理念孕育而生的自动化测试软件产品，它专注于移动设备的系统及应用软件的自动化功能测试、兼容性测试、性能测试等领域，通过将自动化方法和黑盒测试方法相结合，快速发现和定位问题，并向使用用户提供问题跟踪和解决建议，有效地从源头解决各种软件质量问题。1.2适用范围MR支持Android2.3系统以上的移动设备，可以根据测试用例完成对系统软件及手机应用：录制测试脚本，并回放测试脚本，生成测试报告。开发工程师可以通过查看报告总结分析问题，使代码合理化、规范化，从而提高程序质量。2系统构架MR的工作原理和流程如下图：功能测试兼容性测试性能测试APP测试报告MR的软件测试分为功能测试、兼容性测试、性能测试三个层面。用户将APP软件提交后，通过MR功能、兼容性、性能的三个层面的测试，生成测试报告，通过测试报告分析及解决问题。3对外编程接口API3.1API定义1) JAR 文件API 库MobileRunner.jar用于录制，回放脚本，生成测试报告。依赖库bsh-2.0b4.jar用于执行脚本dom4j-l.6.l.jar用于脚本组件xml解析jxl.jar用于创建参数表文件log4j.jar用于打印脚本回放信息日志parser.jar解析类文件的核心JAR 包javacv.jar图像识别核心JAR包动态库opencv_core245.dllopencv 解析核心动态库opencv_imgproc245.dllopencv 解析核心动态库JavaAccessBridge.dlljava解析核心动态库JAWTAccessBridge.dlljava 解析核心动态库MobileRunner.dllMobileRunner核心动态库注：该JAR 文件使用JAVA6 编译，使用时需将所有的JAR 文件全部放在CLASSPATH 当中2) Class1 AndroidAR包：com.spasvo.android类：public Android注： 此类在JAR 文件MobileRunner.jar 中，此类是一个工具类，提供得到单例的getInstance()方法得到实例。获取操作对象实例static AndroidAR getInstance();param：returns：AndroidAR: 操作对象实例初始化方法public void init() Param:return:No returns设置设备标号public boolean setChimpDevice(int index)param:index:设备标号;return:Boolean:设置成功或失败得到所有连接设备public List getDevices() prama:No params;return:List: 获取所有设备检查图片对象正确性public boolean checkPoint(String element,int x,int y,int width,int height) param:String element :组件idint x:横坐标 int y：纵坐标int width：宽度int height：高度returns：成功或失败3) Class2 MobileRunnerScript包：com.spasvo.android类：public MobileRunnerScript注：此类在JAR 文件MobileRunner.jar 中，用于脚本回放。属性String fileStorePath;/测试用例的根路径String srcFilePath:被解析的类文件的路径；ParameterData parameterData;/脚本参数化；CvRect openCVFindRect;/使用OpenCV找到的元素的范围；private int findTime = 10000;/查找组件的超时时间；List listFlag = new ArrayList():脚本回放结果集合；int findSleepTime = 1000;/查找组件的间隔时间构造方法public MobileRunnerScript(AdbChimpDevice device,String fileStorePath);param:device:回放设备fileStorePath:文件的绝对路径returns：方法提供所有属性的Getter 和Setter 方法4) Class3 ImageUtil包：com.spasvo.android类：public ImageUtil注：此类在JAR 文件MobileRunner.jar 中，用于转化图片格式检查图片对象正确性public static String bufferedImageToBase64Str(BufferedImage image) param:BufferedImage image：图片对象。return:String：BASE64字符串构造方法默认构造方法 4系统基本功能4.1 测试案例创建4.1.1 创建测试案例用户能够创建一个测试案例，在项目浏览器中使用右键菜单或者系统的菜单来创建测试案例。4.2 测试案例录制4.2.1录制脚本当用户从菜单或者工具条启动“录制”命令，系统开始记录你对手机的所有操作，包括触摸、长按、滑屏等操作，并在记录过程中把生成的脚本文件显示在编辑器上面，使用户彻底摆脱了文字式的测试用例，测试用例不再需要手工书写，用例编写效率至少提升 200%。下表列出MR支持的脚本命令：命令名称命令参数命令举例startActivityAPP包名及主类名称mr.startActivity(com.android.camera/.Camera);touch七个参数，分别代表点击获取的图片名称，图片X坐标，图片Y坐标，图片宽度，图片高度，点击的X坐标，点击的Y坐标mr.touch(po151015.jpg,596,210,67,67,619,217);touchKey输入点击的物理按键的名称mr.touchKey(BACK);longTouch七个参数，分别代表点击获取图片名称，图片X坐标，图片Y坐标，图片宽度，图片高度mr.touch(test11100625.jpg,549,851,101,101,600,900);touchMove五个参数，要求输入滑屏时的起始坐标、结束坐标和用时mr.touchMove(100,110,500,300,2000);enterContext输入文本内容mr.enterContext(hello，spasvo);checkPoint五个参数，要求输入保存检查图的文件名，图片坐标及大小mr.checkPoint(d1171940.png,59,583,587,92);installPackage输入adndroid应用文件路径mr.installPackage(C:/Users/lyndan/Desktop/3601.3.2.apk);removePackage输入android应用的包名mr.removePackage(com.test.myapp);callScript输入脚本文件全路径mr.callScript(c:/test.bsh);录制的结果是得到了一个可以被执行的测试脚本文件。4.2.2测试案例编辑MobileRunner 提供了强大的测试案例编辑功能, 第一，提供了java 脚本的关键字识别技术，能够识别系统的关键字，避免语法错误；第二，提供了实时代码提示的功能。4.2.3 检查点支持图片检查点。测试的目的是看执行一个过程，结果是否和预期结果一样。验证的方法就是查看结果是否一致，这个点我们称作“检查点”。 检查成功则继续执行，检查不成功也需要继续执行，并且把结果写入测试报告。增加检查点用户可以在录制时来增加检查点，点击设置检查点按钮，系统会自动弹出当前设备的界面图，用户通过鼠标选择需要检查的内容。4.2.4参数化系统自带资源库，录制的过程中系统会自动往资源库里边添加资源，我们可以根据资源的不同，进行参数化，从而实现相同的步骤的测试用例，只是资源不同的参数化。资源库支持编辑资源，删除资源。点击循环参数列表在脚本中加入参数列表, for(ParameterData pd : mr.getParameterDataList(ttt.xls)/*.subList(0, 1)*/)/mr.parameterData = pd;/mr.parameterData可用于脚本之间传递参数pd.getFrom(“aa”);4.3 测试案例执行4.3.1 案例执行当测试案例只有能够被执行才有意义，测试脚本首先被编译，然后执行。用户通过菜单上的“执行”项，可以执行这个测试案例，目前移动设备种类众多，屏幕分辨率也较多，同一用例可以在不同分辨率下执行该项功能有着重大的实际意义，用户在一款设备分辨率下录制的测试用例，可以在不同分辨率的设备上执行。4.3.2 查看设备信息用户选中设备列表中显示的一个设备，点击查看按钮，可以看到连接设备的有关信息,设备的状态包括online,offline4.4 测试报告4.4.1 存放测试报告当用户执行已创建的测试计划时，系统会提示用户选择保存测试报告的位置。4.4.2 测试报告格式及内容当用户创建的测试计划执行完成，会自动生成相对应的测试报告，格式为Html文件，在报告里详细记录了测试设备的相关硬件参数、测试脚本的每一条内容及执行的成功或失败的记录等相关信息，从而更好的帮助用户完成对测试内容的分析。