Calculon - A Java DSL for Android functional testing

Transcript

1. Calculon
   A Java DSL for Android functional testing
   © 2010 Matthias Käppler
   www.qype.com
   

   View Slide

2. My fortune cookie says...
   Every half-way complex app should be
   backed by an automated test suite!
   

   View Slide

3. Tests should be...
   Easy to write.
   

   View Slide

4. Tests should be...
   Easy to read!
   

   View Slide

5. Sorry, I don't speak binary
   public void whatInHeavensNameDoesThisEvenTest() {
   final Button b = (Button) getActivity().findViewById(R.id.b);
   ActivityMonitor monitor = getInstrumentation().addMonitor(
   BarActivity.class.getCanonicalName(), null, false);
   getInstrumentation().runOnMainSync(new Runnable() {
   public void run() {
   b.performClick();
   }
   });
   getInstrumentation().waitForIdleSync();
   assertTrue(getInstrumentation().checkMonitorHit(monitor, 1));
   }
   

   View Slide

6. What a mess!
   

   View Slide

7. Calculon to the rescue!
   

   View Slide

8. Calculon to the rescue!
   assertThat(R.id.button).click().starts(BarActivity.class);
   

   View Slide

9. Calculon is...
   … a testing library for Android.
   

   View Slide

10. Calculon is...
    … deployed as a JAR.
    

    View Slide

11. Calculon is...
    … a DSL*.
    *as far as that's possible in Java.
    

    View Slide

12. Calculon is...
    … open source!
    

    View Slide

13. Testing with Calculon
    Tests with Calculon are written as
    functional Activity tests.
    ActivityInstrumentationTestCase2
    

    View Slide

14. Testing with Calculon
    public class FooTest extends FunctionalTest {
    public FooTest() {
    super("com.example", FooActivity.class);
    }
    public void testStuff() {
    ...
    }
    }
    

    View Slide

15. Assertions
    public void testStuff() {
    // testing against activities
    assertThat()...
    assertThat(getActivity())...
    assertThat(someOtherActivity)...
    // testing against views
    assertThat(R.id.some_button)...
    assertThat(someButton)...
    // of course all Junit assertions work as well
    assertEquals(...)
    assertNotNull(...)
    ...
    }
    

    View Slide

16. Activity Assertions
    public void testStuff() {
    // testing for an orientation
    assertThat().inPortraitMode();
    // testing for views
    assertThat().viewExists(R.id.some_button);
    // testing for input actions
    assertThat().keyDown(KeyEvent.KEYCODE_BACK)...
    // testing for custom predicates
    assertThat().satisfies(new Predicate() {
    public boolean check(Activity target) {
    return target.isTaskRoot();
    }
    });
    }
    

    View Slide

17. View Assertions
    public void testStuff() {
    // testing for view state
    assertThat(R.id.button).isVisible();
    assertThat(R.id.button).isGone();
    // testing for input actions
    assertThat(R.id.button).keyDown(KeyEvent.KEYCODE_BACK)...
    assertThat(R.id.button).click()...
    assertThat(R.id.button).longClick()...
    // testing for custom predicates
    assertThat(R.id.button).satisfies(new Predicate() {
    public boolean check(View target) {
    return target.getVisibility() == View.VISIBLE;
    }
    });
    }
    

    View Slide

18. Action Assertions
    public void testStuff() {
    // testing for actions that launch a new activity
    assertThat(R.id.b1).click().starts(BarActivity.class);
    // testing for actions that finish an activity
    assertThat(R.id.b2).keyDown(KeyEvent.KEYCODE_Q).finishesActivity();
    // testing for actions that change something
    assertThat(R.id.b3).click().implies(R.id.b2).isGone();
    assertThat(R.id.b4).click().implies(getActivity()).inLandscapeMode();
    assertThat(R.id.b5).click().implies(new Predicate() {
    public boolean check(Model target) {
    return target.someAttribute() == 5;
    }
    });
    }
    

    View Slide

19. Thanks!
    git://github.com/kaeppler/calculon.git
    $ git clone
    

    View Slide