UI Automator Becomes Friendly with Espresso

Roppongi.aar #2 の発表資料です。
UI Automatorのバージョン2より、Espressoと同一テストメソッド内で混ぜて使えるようになりました。
このスライドでは、混ぜて使うことで便利になった点を、実例を挙げて説明しています。

サンプルコードのURL: https://github.com/sumio/UiAutomatorEspressoSample

Transcript

1. UI  Automator   Becomes  Friendly  with   Espresso
   2015.11.17   @sumio_tym  (TOYAMA  Sumio)
   Roppongi.aar  #2
   Portions  of  this  presentation  are  reproduced  from  work  created  and  shared  by  the  Android  Open  Source  Project[1]   and  used  according  to  terms  described  in  the  Creative  Commons  2.5  Attribution  License[2].   [1]  http://code.google.com/policies.html   [2]  http://creativecommons.org/licenses/by/2.5/
   
2. About  Me
   •  TOYAMA  Sumio  (֎ࢁ
   ७ੜ)   @sumio_tym  (twitter),  @sumio  (github)   •  NTT  Software  Corporation   – Provide  technical  assistance  to  Android  Projects   •  Private  activities   – STAR  (Software  Test  Automation  Research  Group  Jp)   – Some  articles  in  @IT  related  to  uiautomator/Appium:   ʮεϚϗ޲͚ແྉγεςϜςετࣗಈԽπʔϧʯ   http://www.atmarkit.co.jp/ait/kw/smapho_testtool.html   2  
3. Overview
   •  Architecture  of  UI  Automator  is  changed  into   Instrumentation  Test  as  of  ver.  2.x.   •  The  change  makes  you   write  a  test  method  in  mixture  of  Espresso  and  UI   Automator.   •  We  show  a  concrete  example  in  this  talk.   3  
4. Review  of   Android  Testing  Frameworks
   4   •  Instrumentation  Test   •  Espresso   •  UI  Automator
   
5. Instrumentation  Test  (Android)
   5   •  Both  application   under  test  (AUT)  and   test  package:     – run  on  the  same   process.   – must  be  signed  by  the   same  certificate.   •  The  test  package  can   examine  the  AUT   deeply.     (e.g.  fields  of  Activity)   Quoted  from  http://developer.android.com/intl/ja/tools/testing/testing_android.html
   
6. Espresso
   6   •  Testing  framework  for  writing  UI  tests   – Single  app  testing   – White-­‐box  style  testing   (Can  access  the  interior  of  the  AUT)   •  Architecture:    Instrumentation  test   •  Supported  API  level:  ≥8   •  Easier  to  write   Quoted  from  http://developer.android.com/intl/ja/training/testing/ui-­‐testing/espresso-­‐testing.html
   
7. UI  Automator
   7   •  Testing  framework  for  writing  UI  tests   – Cross-­‐app  testing   – Black-­‐box  style  testing   (Can  not  access  the  interior  of    the  AUT)   •  Architecture:   – Specialized  architecture  for  UI  Automator  (as  of  1.x)   – Instrumentation  test  (as  of  2.x)   •  Supported  API  level:   – ≥16  (as  of  1.x)   – ≥18  (as  of  2.x)   •  More  complicated  to  write  
8. UI  Automator  (cont.)
   8   •  See  also   "Notable  Changes  in  UI  Automator  2.0"   (ABC  2015  Summer)   https://speakerdeck.com/sumio/notable-­‐changes-­‐in-­‐ui-­‐automator-­‐2-­‐dot-­‐0   Quoted  from  http://developer.android.com/intl/ja/training/testing/ui-­‐testing/uiautomator-­‐testing.html
   
9. •  Now,  both  Espresso  and  UI  Automator  are     based  on  Instrumentation  Test.   •  So,  you  can  write  a  test  method  in  a  mixture  of   them.   •  That  widen  a  testable  area:   – Use  Espresso  for  AUT  (main  purpose)   – Use  UI  Automator  for  other  apps  (e.g.  launched  by   the  AUT)   9   UI  Automator  Becomes  Friendly   with  Espresso
   
10. How  to  Setup
    10   Available  from  https://github.com/sumio/UiAutomatorEspressoSample
    
11. build.gradle
    11   dependencies { androidTestCompile 'com.android.support.test:runner:0.4.1' androidTestCompile 'com.android.support.test:rules:0.4.1' androidTestCompile \ 'com.android.support.test.espresso:espresso-core:2.2.1' androidTestCompile \ 'com.android.support.test.uiautomator:uiautomator-v18:2.1.2' } for  Instrumentation  Test
    for  UI  Automator
    for  Espresso
    
12. Test  Class
    12   @RunWith(AndroidJUnit4.class) public class MainActivityTest { @Rule public ActivityTestRule<MainActivity> activityRule = new ActivityTestRule<>(MainActivity.class); private UiDevice uiDevice; @Before public void setUp() { uiDevice = UiDevice. getInstance(InstrumentationRegistry.getInstrumentation()); } // YOUR TEST METHOD HERE } for  Instrumentation  Test
    for  UI  Automator
    
13. Test  Example
    13   Available  from  https://github.com/sumio/UiAutomatorEspressoSample
    
14. Application  Under  Test
    14   Simple  text  box
    Launch  Settings  App
    
15. Scenario
    15   1.  (In  AUT)   Tap  "ઃఆΞϓϦΛදࣔ͢Δ"   2.  (In  Settings  App)   Tap  "೔෇ͱ࣌ࠁ"   3.  Turn  on/off  "24࣌ؒදࣔ"   4.  Press  the  back  key  twice   5.  (In  AUT)   Enter  "Hello  World!"  into  the   text  box   by  using  UI  Automator
    
16. Test  Method  Implementation
    16   @Test public void espresso_uiautomator() throws Exception { // Tap "ઃఆΞϓϦΛදࣔ͢Δ" onView(withId(R.id.button_setting)).perform(click()); // Tap "೔෇ͱ࣌ࠁ" UiScrollable settingList = new UiScrollable(new UiSelector(). resourceId(SETTINGS_CONTAINER_ID)); settingList.setAsVerticalList(); UiObject dateTimeItem = settingList.getChildByText(new UiSelector(). className(FrameLayout.class), "೔෇ͱ࣌ࠁ"); dateTimeItem.clickAndWaitForNewWindow(); // (continued on next slide) UI  Automator
    Espresso
    
17. Test  Method  Implementation  (cont.)
    17   // Turn on/off "24࣌ؒදࣔ" UiCollection dateTimeList = new UiCollection(new UiSelector(). className(ListView.class)); UiObject use24HourItem = dateTimeList.getChildByText(new UiSelector(). className(LinearLayout.class), "24࣌ؒදࣔ"); use24HourItem.clickAndWaitForNewWindow(); // go back to AUT. uiDevice.pressBack(); uiDevice.waitForIdle(); uiDevice.pressBack(); uiDevice.waitForWindowUpdate(AUT_PACKAGE_NAME, 1500L); // Enter "Hello World!" into the text box onView(withId(R.id.editText)). perform(typeText("Hello World!")); }  UI  Automator
    Espresso
    
18. Wrap  Up
    18   •  UI  Automator  becomes  friendly  with  Espresso   – You  can  write  a  test  method  in  a  mixture  of  them.   •  Enables  you  to  write  a  cross-­‐app  test  more  easily     by  using  mainly  Espresso.   •  A  concrete  example  is  available  from   https://github.com/sumio/UiAutomatorEspressoSample   Thank  you  !