platform_tools_api_testing_multidisplay/com.tomtom.ivi.platform.tools.api.testing.multidisplay

Package com.tomtom.ivi.platform.tools.api.testing.multidisplay

Types

ActiveDisplayScope

class ActiveDisplayScope(displayId: DisplayId)

Scope which provides necessary data and useful routines for writing multi-display tests. It provides:

DisplayId

data class DisplayId(val id: Int)

Represents a display ID.

OnDisplayContext

class OnDisplayContext( val primaryActivityScenarioStateProvider: () -> Lifecycle.State, val moveFocusToDisplay: (DisplayId) -> Unit, val displayIdProvider: () -> DisplayId)

The context for onDisplay invocation.

Functions

createPrimaryOnDisplayContext

fun IviActivityTestCase.createPrimaryOnDisplayContext(): OnDisplayContext

Creates an OnDisplayContext for the primary display.

createSecondaryOnDisplayContext

fun IviActivityTestCase.createSecondaryOnDisplayContext(displayIdProvider: () -> DisplayId): OnDisplayContext

Creates an OnDisplayContext for a secondary display. The display ID of the secondary display is provided by displayIdProvider.

finishPassengerActivity

fun finishPassengerActivity()

Force to finish passenger activity. Passenger activity will be destroyed before any other activities lifecycle status changes.

launchDebugMenuActivityOnSecondaryDisplay

fun IviServiceAwareTestCase.launchDebugMenuActivityOnSecondaryDisplay()

Launches debug menu activity on secondary display using debug menu on primary screen.

launchPassengerActivityOnSecondaryDisplay

fun IviServiceAwareTestCase.launchPassengerActivityOnSecondaryDisplay()

Launches passenger's activity on secondary display using debug menu.

moveFocusToPrimaryDisplayIviActivity

fun moveFocusToPrimaryDisplayIviActivity()

Move focus to ivi activity on primary display.

moveFocusToSecondaryDisplayIviActivity

fun moveFocusToSecondaryDisplayIviActivity(displayId: DisplayId)

Move focus to ivi activity on secondary display.

obtainSecondaryDisplayIds

fun obtainSecondaryDisplayIds(): List<DisplayId>

Obtains the list of all available secondary displays. Throws IllegalStateException if there are no secondary displays available.

onDisplay

~~fun~~ ActiveDisplayScope.~~onDisplay~~(action: ActiveDisplayScope.() -> Unit)

Prevents contraptions like:

fun onDisplay(context: OnDisplayContext, action: ActiveDisplayScope.() -> Unit)

Activates Activity on the display specified in context and introduces a scope for actions and assertions. Lambda action is supplied with ActiveDisplayScope as a receiver. In this lambda it is important to always use ActiveDisplayScope.rootMatcher when obtaining a ViewInteraction.

thatDoesNotMatchesPrimaryDisplay

fun thatDoesNotMatchesPrimaryDisplay(): TypeSafeMatcher<Root>

Returns a TypeSafeMatcher for Root which matches the root which belongs to any non primary display. Convenient to use if you have primary and one secondary display only.

thatMatchesPrimaryDisplay

fun thatMatchesPrimaryDisplay(): TypeSafeMatcher<Root>

Returns a TypeSafeMatcher for Root which matches the root which belongs to primary display.

thatMatchesSpecificDisplay

fun thatMatchesSpecificDisplay(displayId: DisplayId): TypeSafeMatcher<Root>

Returns a TypeSafeMatcher for Root which matches the root which belongs to display with the given displayId.