《Android应用测试与调试实战》第3章Android界面自动化白盒测试,本章讲解在对待测应用源码有一定了解的基础上进行Android UI自动化白盒测试的方法。本节为大家介绍sendKeys和sendRepeatedKeys函数。
3.2.2 sendKeys和sendRepeatedKeys函数
在Android UI自动化测试当中,经常需要向界面发送键盘消息模拟用户输入文本,高亮选择控件之类的交互操作,因此Android在InstrumentationTestCase类里提供了两个辅助函数(包括重载)sendKeys和sendRepeatedKeys来发送键盘消息。在发送消息之前,一般需要保证接收键盘消息的控件具有输入焦点,这可以在获取控件的引用之后,调用requestFocus函数实现,如代码清单3-6的第93行。
sendKeys的一个重载函数接受整型的按键值作为参数,这些按键值的整数定义在KeyEvent类里定义,在测试用例里可以用它向具有输入焦点的控件输入单个按键消息,它的用法可参考代码清单3-6里的第100和105行。
但sendKeys也有一个接受字符串参数的重载函数,它只需要一行代码就可以输入完整的字符串,字符串里的每个字符以空格分隔,每一个按键都对应KeyEvent中的定义,只不过需要去掉前缀。代码清单3-7就演示了两个函数的区别:
代码清单3-7 sendKeys和sendRepeatedKeys的用法
- 1. private BookEditor _activity;
- 2. public void test编辑书籍信息() throws Throwable {
- 3. // 在标题文本框里输入Moonlight!
- 4. // 找到“标题”文本框
- 5. final EditText txtTitle = (EditText) _activity.findViewById(
- 6. R.id.title);
- 7. this.runTestOnUiThread(new Runnable() {
- 8. public void run() {
- 9. // 通过AndroidAPI调用将“标题”文本框
- 10. // 的文本清空
- 11. txtTitle.setText("");
- 12. // 设置“标题”文本框具有输入焦点
- 13. txtTitle.requestFocus();
- 14. }
- 15. });
- 16.
- 17. // 依次输入“Moonlight!”的各个按键
- 18. // 输入一个大写的"M"
- 19. sendKeys(KeyEvent.KEYCODE_SHIFT_LEFT);
- 20. sendKeys(KeyEvent.KEYCODE_M);
- 21. // 再输入其他小写的字符
- 22. sendKeys(KeyEvent.KEYCODE_O);
- 23. sendKeys(KeyEvent.KEYCODE_O);
- 24. sendKeys(KeyEvent.KEYCODE_N);
- 25. sendKeys(KeyEvent.KEYCODE_L);
- 26. sendKeys(KeyEvent.KEYCODE_I);
- 27. sendKeys(KeyEvent.KEYCODE_G);
- 28. sendKeys(KeyEvent.KEYCODE_H);
- 29. sendKeys(KeyEvent.KEYCODE_T);
- 30. // “!”需要使用虚拟键盘上类似shift的按键转义
- 31. sendKeys(KeyEvent.KEYCODE_ALT_LEFT);
- 32. sendKeys(KeyEvent.KEYCODE_1);
- 33. // 关闭虚拟键盘
- 34. sendKeys(KeyEvent.KEYCODE_DPAD_DOWN);
- 35.
- 36. // 验证"标题"文本框里的内容是期望值
- 37. String expected = "Moonlight!";
- 38. // 因为只是获取控件上的信息,而不是修改,可以直接
- 39. // 从测试用例线程访问,无需放到UI线程中执行
- 40. String actual = txtTitle.getText().toString();
- 41. assertEquals(expected, actual);
- 42.
- 43. // 找到“作者”文本框
- 44. final EditText txtAuthor = (EditText) _activity.findViewById(
- 45. R.id.author);
- 46. // 设置"作者"文本框具有输入焦点
- 47. this.runTestOnUiThread(new Runnable() {
- 48. public void run() {
- 49. txtAuthor.requestFocus();
- 50. }
- 51. });
- 52. // 向当前具有输入焦点的控件-“作者”文本框
- 53. // 发送20个backspace按键消息,以便清除
- 54. // "作者"文本框原有的文本
- 55. sendRepeatedKeys(20, KeyEvent.KEYCODE_DEL);
- 56. // 用sendKeys字符串重载函数输入“Moonlight!”
- 57. sendKeys("SHIFT_LEFT M 2*O N L I G H T ALT_LEFT 1 DPAD_DOWN");
- 58. assertEquals(expected, txtAuthor.getText().toString());
- 59.
- 60. // 再演示使用sendRepeatedKeys将“作者”文本框
- 61. // 清空,并输入“Moonlight!”
- 62. sendRepeatedKeys(20, KeyEvent.KEYCODE_DEL,
- 63. 1, KeyEvent.KEYCODE_SHIFT_LEFT,
- 64. 1, KeyEvent.KEYCODE_M,
- 65. 2, KeyEvent.KEYCODE_O,
- 66. 1, KeyEvent.KEYCODE_N,
- 67. 1, KeyEvent.KEYCODE_L,
- 68. 1, KeyEvent.KEYCODE_I,
- 69. 1, KeyEvent.KEYCODE_G,
- 70. 1, KeyEvent.KEYCODE_H,
- 71. 1, KeyEvent.KEYCODE_T,
- 72. 1, KeyEvent.KEYCODE_ALT_LEFT,
- 73. 1, KeyEvent.KEYCODE_1,
- 74. 1, KeyEvent.KEYCODE_DPAD_DOWN);
- 75. assertEquals(expected, txtAuthor.getText().toString());
- 76.
- 77. // 下面这段代码是不需要的,只是为了暂停
- 78. // 用例以便观察自动化测试效果所用
- 79. Thread.sleep(5000);
- 80. }
同样是输入一个“Moonlight!”这个字符串,使用字符串参数的重载版本代码(第57行)要比sendKeys整型参数的函数版本(第19~34行)简洁很多。第57行演示了sendKeys的一个技巧,如果要输入重复的字母,只需要在输入的字母前加上要重复的次数即可。第55行和第62行演示了sendKeys兄弟函数sendRepeatedKeys的用法,sendRepeatedKeys接受一个不定长度的参数列表,其参数两两配对,每对参数的第一个指明字母重复的次数,第二个就是要输入的字母。第55行代码通过发送20个回退字符清空文本框,如果文本框里的字符串长度大于20个字符,那么就很有可能导致测试失败,因此在第11行笔者又演示了另一种方法清空文本框——直接通过Android API显式设置文本框里的文本。
3.2.3 执行仪表盘测试用例(1)
除了通过Eclipse,还可以在命令行用Android系统自带工具am执行仪表盘测试用例,如果不带参数调用,则会执行除性能测试以外的所有测试用例。
- $ adb shell am instrument –w <测试用例信息>
<测试用例信息>的格式一般是“测试用例包名/android.test.InstrumentationTestRunner”,例如要执行本章的示例来测试用例,首先需要将其和待测应用安装到设备或模拟器上,在虚拟机的命令行中输入下面的命令即可执行所有的测试用例:
- $ adb shell am instrument -w
- cn.hzbook.android.test.chapter3.test/android.test.InstrumentationTestRunner
测试用例的执行结果直接输出在终端里,如上面命令执行完毕后测试用例的输出结果如下:
- # 测试应用中的第一个测试类型
- cn.hzbook.android.test.chapter3.test.InstrumentationLimitSampleTest:
- # 有一个测试用例执行失败,同时输出其堆栈信息
- Error in test添加书籍:
- java.lang.NullPointerException
- at
- cn.hzbook.android.test.chapter3.test.InstrumentationLimitSampleTest$2.run(InstrumentationLimitSampleTest.java:49)
- at
- android.test.InstrumentationTestCase$1.run(InstrumentationTestCase.java:138)
- at android.app.Instrumentation$SyncRunnable.run(Instrumentation.java:1465)
- at android.os.Handler.handleCallback(Handler.java:587)
- at android.os.Handler.dispatchMessage(Handler.java:92)
- at android.os.Looper.loop(Looper.java:123)
- at android.app.ActivityThread.main(ActivityThread.java:4627)
- at java.lang.reflect.Method.invokeNative(Native Method)
- at
- com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:868)
- at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:626)
- at dalvik.system.NativeStart.main(Native Method)
- # 测试应用中的第二个测试类型
- cn.hzbook.android.test.chapter3.test.InstrumentationSampleTest:.
- # 所有的测试用例都正常运行,没有结果就是好结果
- Test results for InstrumentationTestRunner=.E.
- Time: 11.564
- # 总结测试结果,总共运行了两个用例,失败了一个
- FAILURES!!!
- Tests run: 2, Failures: 0, Errors: 1
如果给InstrumentRunner指定“-e func true”这些参数,则会运行所有的功能测试用例,功能测试用例都是从基类InstrumentationTestCase继承而来的。
- $ adb shell am instrument –w –e func true<测试用例信息>
如果为InstrumentRunner指定“-e unit true”这些参数,则会运行所有的单元测试用例,所有不是从InstrumentationTestCase继承的非性能测试用例都是单元测试用例。
- $ adb shell am instrument –w –e unit true<测试用例信息>
如果为InstrumentRunner指定“-e class <类名>”这些参数,则会运行指定测试类型里的所有测试用例。如下面的代码就会运行所有的测试用例:
- $ adb shell am instrument-w
- com.android.foo/android.test.InstrumentationTestRunner
执行所有的小型测试,小型测试用例是指那些在测试函数上标有SmallTest标签(annotation)的测试用例:
- $ adb shell am instrument -w -e size small
- com.android.foo/android.test.InstrumentationTestRunner
执行所有的中型测试,中型测试用例是那些标有MediumTest标签的测试用例:
- $ adb shell am instrument -w -e size medium
- com.android.foo/android.test.InstrumentationTestRunner
执行所有的大型测试,大型测试用例是那些标有LargeTest标签的测试用例:
- $ adb shell am instrument -w -e size large
- com.android.foo/android.test.InstrumentationTestRunner
也可只执行具有指定属性的测试用例,下面是只执行标识有“com.android.foo.MyAnnotation”的测试用例:
- $adb shell am instrument-w-e annotation
- com.android.foo.MyAnnotation
- com.android.foo/android.test.InstrumentationTestRunner
指定“-e notAnnotation”参数来执行所有没有标识有“com.android.foo.MyAnnotation”的测试用例:
- $adb shell am instrument -w -e notAnnotation
- com.android.foo.MyAnnotation
- com.android.foo/android.test.InstrumentationTestRunner