de.nenick.espressomacchiato.elements

Class EspDevice

java.lang.Object

de.nenick.espressomacchiato.elements.EspDevice

public class EspDevice
extends java.lang.Object

Actions and assertions more related to a device.

Since:

Espresso Macchiato 0.2

Field Summary

Fields

Modifier and Type	Field and Description
static int	DELAY_TO_CHANGE_KEYBOARD_STATE Delay to wait before keyboard state is checked.

Constructor Summary

Constructors

Constructor and Description
EspDevice()

Method Summary

Modifier and Type	Method and Description
void	assertOrientationIsLandscape() Check that activity orientation is landscape.
void	assertOrientationIsPortrait() Check that activity orientation is portrait.
void	assertSoftKeyboardIsClosed() Check that the soft keyboard is closed.
void	assertSoftKeyboardIsOpen() Check that the soft keyboard is open.
void	clickBackButton() Click androids back button.
void	closeSoftKeyboard() Close the soft keyboard.
boolean	isScreenSizeAtLeast(int screenSize) Compares the current device screen size to the size given as parameter.
boolean	isScreenSizeAtMost(int screenSize) Compares the current device screen size to the size given as parameter.
boolean	isScreenSizeEqualTo(int screenSize) Compares the current device screen size to the size given as parameter.
static EspDevice	root() Create new element instance.
void	rotateToLandscape() Rotate screen to landscape.
void	rotateToPortrait() Rotate screen to portrait.

Methods inherited from class java.lang.Object

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

Field Detail

DELAY_TO_CHANGE_KEYBOARD_STATE

public static int DELAY_TO_CHANGE_KEYBOARD_STATE

Delay to wait before keyboard state is checked.

Waiting less than 4000ms was not enough for emulator instance on circle ci

Constructor Detail

EspDevice

public EspDevice()

Method Detail

root

public static EspDevice root()

Create new element instance.

Returns:

New Instance for actions and assertions.

Since:

Espresso Macchiato 0.2

clickBackButton

public void clickBackButton()

Click androids back button.

Perform back button click so that the onBackPressed() method is called for the current activity. This is not the up button from an ActionBar.

Warning: When you back press on your root activity then your application becomes closed. Closing the application let current and all following tests fail. You can avoid closing your application with the Dummy Launcher concept.

Since:

Espresso Macchiato 0.2

rotateToPortrait

public void rotateToPortrait()

Rotate screen to portrait.

Rotate the device to portrait mode. Waits until device has expected state to avoid flaky tests. Orientation is only changed if activity does not specify android:screenOrientation.

Since:

Espresso Macchiato 0.2

rotateToLandscape

public void rotateToLandscape()

Rotate screen to landscape.

Rotate the device to landscape mode. Waits until device has expected state to avoid flaky tests. Orientation is only changed if activity does not specify android:screenOrientation.

Since:

Espresso Macchiato 0.2

assertOrientationIsPortrait

public void assertOrientationIsPortrait()

Check that activity orientation is portrait.

Since:

Espresso Macchiato 0.2

assertOrientationIsLandscape

public void assertOrientationIsLandscape()

Check that activity orientation is landscape.

Since:

Espresso Macchiato 0.2

isScreenSizeEqualTo

public boolean isScreenSizeEqualTo(int screenSize)

Compares the current device screen size to the size given as parameter. The method will only return true if and only if the screen size is an exact match. For example a large tablet is XLARGE but not LARGE.

Parameters:

screenSize - SCREENLAYOUT_SIZE constant from android.content.res.Configuration for example Configuration.SCREENLAYOUT_SIZE_XLARGE

Returns:

true, if actual screen size matches given size

Since:

Espresso Macchiato 0.6

isScreenSizeAtLeast

public boolean isScreenSizeAtLeast(int screenSize)

Compares the current device screen size to the size given as parameter. The method will return true if the actual screen size is equal to or greater than the given screen size.

Parameters:

screenSize - SCREENLAYOUT_SIZE constant from android.content.res.Configuration for example Configuration.SCREENLAYOUT_SIZE_XLARGE

Returns:

true, if actual screen size is equal to or greater than given size

Since:

Espresso Macchiato 0.6

isScreenSizeAtMost

public boolean isScreenSizeAtMost(int screenSize)

Compares the current device screen size to the size given as parameter. The method will return true if the actual screen size is equal to or smaller than the given screen size.

Parameters:

screenSize - SCREENLAYOUT_SIZE constant from android.content.res.Configuration for example Configuration.SCREENLAYOUT_SIZE_XLARGE

Returns:

true, if actual screen size is equal to or smaller than given size

Since:

Espresso Macchiato 0.6

closeSoftKeyboard

public void closeSoftKeyboard()

Close the soft keyboard.

Its recommend to close the soft keyboard after tests run which could open it. Opened keyboards are sometimes not closed between tests and may result in flaky tests.

Warning: Close and open soft keyboard may take some time and Espresso don’t wait for finish it. Remember this if you have flaky tests with not displayed elements

Since:

Espresso Macchiato 0.2

assertSoftKeyboardIsOpen

public void assertSoftKeyboardIsOpen()

Check that the soft keyboard is open.

For emulator disable the hardware keyboard support (hw.keyboard=no) or soft keyboard will never be shown.

Warning: Espresso don’t wait for keyboard open/close actions so this method have a fixed delay to avoid flaky tests. You can adjust the delay by changing EspDevice.DELAY_TO_CHANGE_KEYBOARD_STATE

Since:

Espresso Macchiato 0.2

assertSoftKeyboardIsClosed

public void assertSoftKeyboardIsClosed()

Check that the soft keyboard is closed.

Warning: Espresso don’t wait for keyboard open/close actions so this method have a fixed delay to avoid flaky tests. You can adjust the delay by changing EspDevice.DELAY_TO_CHANGE_KEYBOARD_STATE

Since:

Espresso Macchiato 0.2