io.appium.droiddriver.helpers

Class BaseDroidDriverTest<T extends android.app.Activity>

java.lang.Object

junit.framework.Assert

junit.framework.TestCase

android.test.InstrumentationTestCase

android.test.ActivityTestCase

android.test.ActivityInstrumentationTestCase2<T>

io.appium.droiddriver.helpers.D2ActivityInstrumentationTestCase2<T>

io.appium.droiddriver.helpers.BaseDroidDriverTest<T>

All Implemented Interfaces:

junit.framework.Test

public abstract class BaseDroidDriverTest<T extends android.app.Activity>
extends D2ActivityInstrumentationTestCase2<T>

Base class for tests using DroidDriver that reports uncaught exceptions, for * example OOME, instead of crash. Also supports other features, including taking screenshot on failure. It is NOT required, but provides handy features.

Field Summary

Fields

Modifier and Type	Field and Description
protected DroidDriver	driver

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	BaseDroidDriverTest(java.lang.Class<T> activityClass)

Method Summary

Modifier and Type	Method and Description
protected void	classSetUp() Initializes test fixture once for all tests extending this class.
protected void	dumpHprof()
protected java.lang.String	getBaseFileName() Gets the base filename for troubleshooting files.
protected android.content.Context	getTargetContext()
protected void	onFailure(java.lang.Throwable failure) Hook for handling failure, for example, taking a screenshot.
protected boolean	reportSkippedAsFailed()
void	runBare() Fixes JUnit3: always call tearDown even when setUp throws.
protected void	runTest() Overrides to fail fast when the test is annotated as FlakyTest and we should skip remaining tests (the failure is fatal).
protected void	setUp()
protected boolean	shouldSkipRemainingTests(java.lang.Throwable e)
protected void	skip()
protected void	tearDown()

Methods inherited from class io.appium.droiddriver.helpers.D2ActivityInstrumentationTestCase2

scrubClass

Methods inherited from class android.test.ActivityInstrumentationTestCase2

getActivity, setActivityInitialTouchMode, setActivityIntent

Methods inherited from class android.test.ActivityTestCase

setActivity

Methods inherited from class android.test.InstrumentationTestCase

getInstrumentation, injectInsrumentation, injectInstrumentation, launchActivity, launchActivityWithIntent, runTestOnUiThread, sendKeys, sendKeys, sendRepeatedKeys

Methods inherited from class junit.framework.TestCase

countTestCases, createResult, getName, run, run, setName, toString

Methods inherited from class junit.framework.Assert

assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertFalse, assertFalse, assertNotNull, assertNotNull, assertNotSame, assertNotSame, assertNull, assertNull, assertSame, assertSame, assertTrue, assertTrue, fail, fail, failNotEquals, failNotSame, failSame, format

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

driver

protected DroidDriver driver

Constructor Detail

BaseDroidDriverTest

protected BaseDroidDriverTest(java.lang.Class<T> activityClass)

Method Detail

setUp

protected void setUp()
              throws java.lang.Exception

Overrides:

setUp in class android.test.ActivityInstrumentationTestCase2<T extends android.app.Activity>

Throws:

java.lang.Exception

tearDown

protected void tearDown()
                 throws java.lang.Exception

Overrides:

tearDown in class android.test.ActivityInstrumentationTestCase2<T extends android.app.Activity>

Throws:

java.lang.Exception

getTargetContext

protected android.content.Context getTargetContext()

classSetUp

protected void classSetUp()

Initializes test fixture once for all tests extending this class. This may have unexpected behavior - if multiple subclasses override this method, only the first override is executed. Other overrides are silently ignored. You can either use SingleRun in setUp(), or override this method, which is a simpler alternative with the aforementioned catch.

If an InstrumentationDriver is used, this is a good place to call ViewElement.overrideClassName(java.lang.String, java.lang.String)

reportSkippedAsFailed

protected boolean reportSkippedAsFailed()

skip

protected void skip()

onFailure

protected void onFailure(java.lang.Throwable failure)
                  throws java.lang.Throwable

Hook for handling failure, for example, taking a screenshot.

Throws:

java.lang.Throwable

shouldSkipRemainingTests

protected boolean shouldSkipRemainingTests(java.lang.Throwable e)

getBaseFileName

protected java.lang.String getBaseFileName()

Gets the base filename for troubleshooting files. For example, a screenshot is saved in the file "basename".png.

dumpHprof

protected void dumpHprof()
                  throws java.io.IOException

Throws:

java.io.IOException

runBare

public void runBare()
             throws java.lang.Throwable

Fixes JUnit3: always call tearDown even when setUp throws. Also adds the onFailure(java.lang.Throwable) hook.

Overrides:

runBare in class junit.framework.TestCase

Throws:

java.lang.Throwable

runTest

protected void runTest()
                throws java.lang.Throwable

Overrides to fail fast when the test is annotated as FlakyTest and we should skip remaining tests (the failure is fatal). Most lines are copied from super classes.

When a flaky test is re-run, tearDown() and setUp() are called first in order to reset state.

Overrides:

runTest in class android.test.ActivityInstrumentationTestCase2<T extends android.app.Activity>

Throws:

java.lang.Throwable