andriod instrumention sendKeys和sendRepeatedKeys函数

《Android应用测试与调试实战》第3章Android界面自动化白盒测试,本章讲解在对待测应用源码有一定了解的基础上进行Android UI自动化白盒测试的方法。本节为大家介绍sendKeys和sendRepeatedKeys函数。

AD:WOT2015 互联网运维与开发者大会 热销抢票

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. 1. private BookEditor _activity;  
  2. 2. public void test编辑书籍信息() throws Throwable {  
  3. 3.       // 在标题文本框里输入Moonlight!  
  4. 4.       // 找到“标题”文本框  
  5. 5.       final EditText txtTitle = (EditText) _activity.findViewById(  
  6. 6.             R.id.title);  
  7. 7.       this.runTestOnUiThread(new Runnable() {  
  8. 8.              public void run() {  
  9. 9.               // 通过AndroidAPI调用将“标题”文本框  
  10. 10.              // 的文本清空  
  11. 11.              txtTitle.setText("");  
  12. 12.              // 设置“标题”文本框具有输入焦点  
  13. 13.              txtTitle.requestFocus();  
  14. 14.            }  
  15. 15.      });  
  16. 16.  
  17. 17.      // 依次输入“Moonlight!”的各个按键  
  18. 18.      // 输入一个大写的"M"  
  19. 19.      sendKeys(KeyEvent.KEYCODE_SHIFT_LEFT);  
  20. 20.      sendKeys(KeyEvent.KEYCODE_M);  
  21. 21.      // 再输入其他小写的字符  
  22. 22.      sendKeys(KeyEvent.KEYCODE_O);  
  23. 23.      sendKeys(KeyEvent.KEYCODE_O);  
  24. 24.      sendKeys(KeyEvent.KEYCODE_N);  
  25. 25.      sendKeys(KeyEvent.KEYCODE_L);  
  26. 26.      sendKeys(KeyEvent.KEYCODE_I);  
  27. 27.      sendKeys(KeyEvent.KEYCODE_G);  
  28. 28.      sendKeys(KeyEvent.KEYCODE_H);  
  29. 29.      sendKeys(KeyEvent.KEYCODE_T);  
  30. 30.      // “!”需要使用虚拟键盘上类似shift的按键转义  
  31. 31.      sendKeys(KeyEvent.KEYCODE_ALT_LEFT);  
  32. 32.      sendKeys(KeyEvent.KEYCODE_1);  
  33. 33.      // 关闭虚拟键盘  
  34. 34.      sendKeys(KeyEvent.KEYCODE_DPAD_DOWN);  
  35. 35.  
  36. 36.      // 验证"标题"文本框里的内容是期望值  
  37. 37.      String expected = "Moonlight!";  
  38. 38.      // 因为只是获取控件上的信息,而不是修改,可以直接  
  39. 39.      // 从测试用例线程访问,无需放到UI线程中执行  
  40. 40.      String actual = txtTitle.getText().toString();  
  41. 41.      assertEquals(expected, actual);  
  42. 42.  
  43. 43.      // 找到“作者”文本框  
  44. 44.      final EditText txtAuthor = (EditText) _activity.findViewById(  
  45. 45.                  R.id.author);  
  46. 46.      // 设置"作者"文本框具有输入焦点  
  47. 47.      this.runTestOnUiThread(new Runnable() {  
  48. 48.            public void run() {  
  49. 49.                   txtAuthor.requestFocus();  
  50. 50.            }  
  51. 51.      });  
  52. 52.      // 向当前具有输入焦点的控件-“作者”文本框  
  53. 53.      // 发送20个backspace按键消息,以便清除  
  54. 54.      // "作者"文本框原有的文本  
  55. 55.      sendRepeatedKeys(20, KeyEvent.KEYCODE_DEL);  
  56. 56.      // 用sendKeys字符串重载函数输入“Moonlight!”  
  57. 57.      sendKeys("SHIFT_LEFT M 2*O N L I G H T ALT_LEFT 1 DPAD_DOWN");  
  58. 58.      assertEquals(expected, txtAuthor.getText().toString());  
  59. 59.  
  60. 60.      // 再演示使用sendRepeatedKeys将“作者”文本框  
  61. 61.      // 清空,并输入“Moonlight!”  
  62. 62.      sendRepeatedKeys(20, KeyEvent.KEYCODE_DEL,  
  63. 63.              1, KeyEvent.KEYCODE_SHIFT_LEFT,  
  64. 64.              1, KeyEvent.KEYCODE_M,  
  65. 65.              2, KeyEvent.KEYCODE_O,  
  66. 66.              1, KeyEvent.KEYCODE_N,  
  67. 67.              1, KeyEvent.KEYCODE_L,  
  68. 68.              1, KeyEvent.KEYCODE_I,  
  69. 69.              1, KeyEvent.KEYCODE_G,  
  70. 70.              1, KeyEvent.KEYCODE_H,  
  71. 71.              1, KeyEvent.KEYCODE_T,  
  72. 72.              1, KeyEvent.KEYCODE_ALT_LEFT,  
  73. 73.              1, KeyEvent.KEYCODE_1,  
  74. 74.              1, KeyEvent.KEYCODE_DPAD_DOWN);  
  75. 75.      assertEquals(expected, txtAuthor.getText().toString());  
  76. 76.  
  77. 77.      // 下面这段代码是不需要的,只是为了暂停  
  78. 78.      // 用例以便观察自动化测试效果所用  
  79. 79.      Thread.sleep(5000);  
  80. 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执行仪表盘测试用例,如果不带参数调用,则会执行除性能测试以外的所有测试用例。
 

   
   
  1. $ adb shell am instrument –w <测试用例信息> 

<测试用例信息>的格式一般是“测试用例包名/android.test.InstrumentationTestRunner”,例如要执行本章的示例来测试用例,首先需要将其和待测应用安装到设备或模拟器上,在虚拟机的命令行中输入下面的命令即可执行所有的测试用例:
 

   
   
  1. $ adb shell am instrument -w  
  2. cn.hzbook.android.test.chapter3.test/android.test.InstrumentationTestRunner 

测试用例的执行结果直接输出在终端里,如上面命令执行完毕后测试用例的输出结果如下:
 

   
   
  1.    # 测试应用中的第一个测试类型  
  2.    cn.hzbook.android.test.chapter3.test.InstrumentationLimitSampleTest:  
  3.    # 有一个测试用例执行失败,同时输出其堆栈信息  
  4.    Error in test添加书籍:  
  5.    java.lang.NullPointerException  
  6.      at  
  7. cn.hzbook.android.test.chapter3.test.InstrumentationLimitSampleTest$2.run(InstrumentationLimitSampleTest.java:49)  
  8.      at  
  9. android.test.InstrumentationTestCase$1.run(InstrumentationTestCase.java:138)  
  10.       at android.app.Instrumentation$SyncRunnable.run(Instrumentation.java:1465)  
  11.      at android.os.Handler.handleCallback(Handler.java:587)  
  12.      at android.os.Handler.dispatchMessage(Handler.java:92)  
  13.      at android.os.Looper.loop(Looper.java:123)  
  14.      at android.app.ActivityThread.main(ActivityThread.java:4627)  
  15.      at java.lang.reflect.Method.invokeNative(Native Method)  
  16.      at  
  17. com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:868)  
  18.      at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:626)  
  19.      at dalvik.system.NativeStart.main(Native Method)  
  20.  
  21.    # 测试应用中的第二个测试类型  
  22.    cn.hzbook.android.test.chapter3.test.InstrumentationSampleTest:.  
  23.    # 所有的测试用例都正常运行,没有结果就是好结果  
  24.    Test results for InstrumentationTestRunner=.E.  
  25.    Time: 11.564  
  26.  
  27.    # 总结测试结果,总共运行了两个用例,失败了一个  
  28.    FAILURES!!!  
  29.    Tests run: 2,  Failures: 0,  Errors: 1 

如果给InstrumentRunner指定“-e func true”这些参数,则会运行所有的功能测试用例,功能测试用例都是从基类InstrumentationTestCase继承而来的。
 

   
   
  1. $ adb shell am instrument –w –e func true<测试用例信息> 

如果为InstrumentRunner指定“-e unit true”这些参数,则会运行所有的单元测试用例,所有不是从InstrumentationTestCase继承的非性能测试用例都是单元测试用例。
 

   
   
  1. $ adb shell am instrument –w –e unit true<测试用例信息> 

如果为InstrumentRunner指定“-e class <类名>”这些参数,则会运行指定测试类型里的所有测试用例。如下面的代码就会运行所有的测试用例:
 

   
   
  1. $ adb shell am instrument-w  
  2. com.android.foo/android.test.InstrumentationTestRunner 

执行所有的小型测试,小型测试用例是指那些在测试函数上标有SmallTest标签(annotation)的测试用例:
 

   
   
  1. $ adb shell am instrument -w -e size small  
  2. com.android.foo/android.test.InstrumentationTestRunner 

执行所有的中型测试,中型测试用例是那些标有MediumTest标签的测试用例:
 

   
   
  1. $ adb shell am instrument -w -e size medium  
  2. com.android.foo/android.test.InstrumentationTestRunner 

执行所有的大型测试,大型测试用例是那些标有LargeTest标签的测试用例:
 

   
   
  1. $ adb shell am instrument -w -e size large  
  2. com.android.foo/android.test.InstrumentationTestRunner 

也可只执行具有指定属性的测试用例,下面是只执行标识有“com.android.foo.MyAnnotation”的测试用例:
 

   
   
  1. $adb shell am instrument-w-e annotation  
  2. com.android.foo.MyAnnotation  
  3. com.android.foo/android.test.InstrumentationTestRunner 

指定“-e notAnnotation”参数来执行所有没有标识有“com.android.foo.MyAnnotation”的测试用例:
 

   
   
  1. $adb shell am instrument -w -e notAnnotation  
  2. com.android.foo.MyAnnotation  
  3. com.android.foo/android.test.InstrumentationTestRunner 

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值