TestCarContext

public static @NonNull TestCarContext createCarContext(@NonNull Context testContext)

Creates a TestCarContext to use for testing.

public void finishCarApp()

Requests to finish the car app.

Call this when your app is done and should be closed. The Session corresponding to this CarContext will become State.DESTROYED.

At some point after this call, the OS will destroy your CarAppService.

This method should not be called until the Lifecycle.State of the context's Session is at least CREATED.

public @NonNull Object getCarService(@NonNull String name)

Provides a car service by name.

The class of the returned object varies by the requested name.

Currently supported car services, and their respective classes, are:

APP_SERVICE

An AppManager for communication between the app and the host.

NAVIGATION_SERVICE

A NavigationManager for management of navigation updates.

SCREEN_SERVICE

A ScreenManager for management of Screens.

CONSTRAINT_SERVICE

A ConstraintManager for management of content limits.

HARDWARE_SERVICE

A CarHardwareManager for interacting with car hardware (e.g. sensors) data.

SUGGESTION_SERVICE

A SuggestionManager for posting androidx.car.app.suggestion.model.Suggestions.

This method should not be called until the Lifecycle.State of the context's Session is at least CREATED.

public @NonNull T <T> getCarService(@NonNull Class<T> serviceClass)

Returns a car service by class.

See getCarService for a list of the supported car services.

This method should not be called until the Lifecycle.State of the context's Session is at least CREATED.

public @NonNull FakeHost getFakeHost()

Retrieve the FakeHost being used.

public @Nullable TestCarContext.PermissionRequestInfo getLastPermissionRequestInfo()

Returns a PermissionRequestInfo including the information with the last call made to requestPermissions, or null if no call was made.

public @NonNull List<Intent> getStartCarAppIntents()

Returns all Intents sent via startCarApp.

The Intents are stored in the order of when they were sent, where the first intent in the list, is the first intent sent.

The results will be stored until reset is called.

public boolean hasCalledFinishCarApp()

Verifies if finishCarApp has been called.

public void requestPermissions(
    @NonNull List<String> permissions,
    @NonNull Executor executor,
    @NonNull OnRequestPermissionsListener listener
)

Requests the provided permissions from the user.

When the result is available, the listener provided will be called using the Executor provided.

This method should be called using a androidx.car.app.model.ParkedOnlyOnClickListener.

If this method is called while the host deems it is unsafe (for example, when the user is driving), the permission(s) will not be requested from the user.

If the Session is destroyed before the user accepts or rejects the permissions, the callback will not be executed.

public void reset()

Resets the values tracked by this TestCarContext.

public void startCarApp(@NonNull Intent intent)

Starts a car app on the car screen.

The target application will get the Intent via onCreateScreen or onNewIntent.

Supported Intents:

An Intent to navigate.

The action must be ACTION_NAVIGATE.

The data URI scheme must be either a latitude,longitude pair, or a + separated string query as follows:

1) "geo:12.345,14.8767" for a latitude, longitude pair.

2) "geo:0,0?q=123+Main+St,+Seattle,+WA+98101" for an address.

3) "geo:0,0?q=a+place+name" for a place to search for.

An Intent to make a phone call.

The Intent must be created as defined here.

An Intent to start this app in the car.

The component name of the intent must be the one for the CarAppService that contains this CarContext. If the component name is for a different component, the method will throw a SecurityException.

This method should not be called until the Lifecycle.State of the context's Session is at least CREATED.