TestCarContext

Added in 1.1.0

Kotlin |Java

public class TestCarContext extends CarContext

java.lang.Object
↳	android.content.Context
	↳	android.content.ContextWrapper
		↳	androidx.car.app.CarContext
			↳	androidx.car.app.testing.TestCarContext

The CarContext that is used for testing.

This class will return the test version of car services for tracking calls during testing.

It also allows retrieving the car services already cast to the testing class by calling getCarService with the class name of the test services:

testCarContext.getCarService(TestAppManager.class)

testCarContext.getCarService(TestNavigationManager.class)

testCarContext.getCarService(TestScreenManager.class)

Allows retrieving all Intents sent via startCarApp.

Summary

Nested types
`public class TestCarContext.PermissionRequestInfo` A representation of a permission request including the permissions that were requested as well as the callback provided.

Public methods
`static @NonNull TestCarContext`	`createCarContext(@NonNull Context testContext)` Creates a `TestCarContext` to use for testing.
`void`	`finishCarApp()` Requests to finish the car app.
`@NonNull Object`	`getCarService(@NonNull String name)` Provides a car service by name.
`@NonNull T`	`<T> getCarService(@NonNull Class<T> serviceClass)` Returns a car service by class.
`@NonNull FakeHost`	`getFakeHost()` Retrieve the `FakeHost` being used.
`@Nullable TestCarContext.PermissionRequestInfo`	`getLastPermissionRequestInfo()` Returns a `PermissionRequestInfo` including the information with the last call made to requestPermissions, or `null` if no call was made.
`@NonNull List<Intent>`	`getStartCarAppIntents()` Returns all `Intent`s sent via `startCarApp`.
`boolean`	`hasCalledFinishCarApp()` Verifies if `finishCarApp` has been called.
`void`	`requestPermissions( @NonNull List<String> permissions, @NonNull Executor executor, @NonNull OnRequestPermissionsListener listener )` Requests the provided `permissions` from the user.
`void`	`reset()` Resets the values tracked by this `TestCarContext`.
`void`	`startCarApp(@NonNull Intent intent)` Starts a car app on the car screen.

Inherited Constants

From androidx.car.app.CarContext

`static final String`	`ACTION_NAVIGATE = "androidx.car.app.action.NAVIGATE"` Standard action for navigating to a location.
`static final String`	`APP_SERVICE = "app"` Manages all app events such as invalidating the UI, showing a toast, etc.
`static final String`	`CAR_SERVICE = "car"` Internal usage only.
`static final String`	`@RequiresCarApi(value = 2) CONSTRAINT_SERVICE = "constraints"` Manages constraints for the app as enforced by the connected host.
`static final String`	`EXTRA_START_CAR_APP_BINDER_KEY = "androidx.car.app.extra.START_CAR_APP_BINDER_KEY"` Key for including a IStartCarApp in the notification `Intent`, for starting the app if it has not been opened yet.
`static final String`	`@RequiresCarApi(value = 3) HARDWARE_SERVICE = "hardware"` Manages access to androidx.car.app.hardware properties, sensors and actions.
`static final String`	`@ExperimentalCarApi MEDIA_PLAYBACK_SERVICE = "media_playback"` Manages the media requests from 3p apps such as providing a media session token,
`static final String`	`NAVIGATION_SERVICE = "navigation"` Manages all navigation events such as starting navigation when focus is granted, abandoning navigation when focus is lost, etc.
`static final String`	`SCREEN_SERVICE = "screen"` Manages the screens of the app, including the screen stack.
`static final String`	`SUGGESTION_SERVICE = "suggestion"` Manages posting suggestion events

From android.content.Context

`static final String`	`ACCESSIBILITY_SERVICE = "accessibility"`
`static final String`	`ACCOUNT_SERVICE = "account"`
`static final String`	`ACTIVITY_SERVICE = "activity"`
`static final String`	`ADVANCED_PROTECTION_SERVICE = "advanced_protection"`
`static final String`	`ALARM_SERVICE = "alarm"`
`static final String`	`APPWIDGET_SERVICE = "appwidget"`
`static final String`	`APP_FUNCTION_SERVICE = "app_function"`
`static final String`	`APP_OPS_SERVICE = "appops"`
`static final String`	`APP_SEARCH_SERVICE = "app_search"`
`static final String`	`AUDIO_SERVICE = "audio"`
`static final String`	`BATTERY_SERVICE = "batterymanager"`
`static final int`	`BIND_ABOVE_CLIENT = 8`
`static final int`	`BIND_ADJUST_WITH_ACTIVITY = 128`
`static final int`	`BIND_ALLOW_ACTIVITY_STARTS = 512`
`static final int`	`BIND_ALLOW_OOM_MANAGEMENT = 16`
`static final int`	`BIND_AUTO_CREATE = 1`
`static final int`	`BIND_DEBUG_UNBIND = 2`
`static final int`	`BIND_EXTERNAL_SERVICE = -2147483648`
`static final long`	`BIND_EXTERNAL_SERVICE_LONG = 4611686018427387904`
`static final int`	`BIND_IMPORTANT = 64`
`static final int`	`BIND_INCLUDE_CAPABILITIES = 4096`
`static final int`	`BIND_NOT_FOREGROUND = 4`
`static final int`	`BIND_NOT_PERCEPTIBLE = 256`
`static final int`	`BIND_PACKAGE_ISOLATED_PROCESS = 16384`
`static final int`	`BIND_SHARED_ISOLATED_PROCESS = 8192`
`static final int`	`BIND_WAIVE_PRIORITY = 32`
`static final String`	`BIOMETRIC_SERVICE = "biometric"`
`static final String`	`BLOB_STORE_SERVICE = "blob_store"`
`static final String`	`BLUETOOTH_SERVICE = "bluetooth"`
`static final String`	`BUGREPORT_SERVICE = "bugreport"`
`static final String`	`CAMERA_SERVICE = "camera"`
`static final String`	`CAPTIONING_SERVICE = "captioning"`
`static final String`	`CARRIER_CONFIG_SERVICE = "carrier_config"`
`static final String`	`CLIPBOARD_SERVICE = "clipboard"`
`static final String`	`COMPANION_DEVICE_SERVICE = "companiondevice"`
`static final String`	`CONNECTIVITY_DIAGNOSTICS_SERVICE = "connectivity_diagnostics"`
`static final String`	`CONNECTIVITY_SERVICE = "connectivity"`
`static final String`	`CONSUMER_IR_SERVICE = "consumer_ir"`
`static final String`	`CONTACT_KEYS_SERVICE = "contact_keys"`
`static final int`	`CONTEXT_IGNORE_SECURITY = 2`
`static final int`	`CONTEXT_INCLUDE_CODE = 1`
`static final int`	`CONTEXT_RESTRICTED = 4`
`static final String`	`CREDENTIAL_SERVICE = "credential"`
`static final String`	`CROSS_PROFILE_APPS_SERVICE = "crossprofileapps"`
`static final int`	`DEVICE_ID_DEFAULT = 0`
`static final int`	`DEVICE_ID_INVALID = -1`
`static final String`	`DEVICE_LOCK_SERVICE = "device_lock"`
`static final String`	`DEVICE_POLICY_SERVICE = "device_policy"`
`static final String`	`DISPLAY_HASH_SERVICE = "display_hash"`
`static final String`	`DISPLAY_SERVICE = "display"`
`static final String`	`DOMAIN_VERIFICATION_SERVICE = "domain_verification"`
`static final String`	`DOWNLOAD_SERVICE = "download"`
`static final String`	`DROPBOX_SERVICE = "dropbox"`
`static final String`	`EUICC_SERVICE = "euicc"`
`static final String`	`FILE_INTEGRITY_SERVICE = "file_integrity"`
`static final String`	`FINGERPRINT_SERVICE = "fingerprint"`
`static final String`	`GAME_SERVICE = "game"`
`static final String`	`GRAMMATICAL_INFLECTION_SERVICE = "grammatical_inflection"`
`static final String`	`HARDWARE_PROPERTIES_SERVICE = "hardware_properties"`
`static final String`	`HEALTHCONNECT_SERVICE = "healthconnect"`
`static final String`	`INPUT_METHOD_SERVICE = "input_method"`
`static final String`	`INPUT_SERVICE = "input"`
`static final String`	`IPSEC_SERVICE = "ipsec"`
`static final String`	`JOB_SCHEDULER_SERVICE = "jobscheduler"`
`static final String`	`KEYGUARD_SERVICE = "keyguard"`
`static final String`	`KEYSTORE_SERVICE = "keystore"`
`static final String`	`LAUNCHER_APPS_SERVICE = "launcherapps"`
`static final String`	`LAYOUT_INFLATER_SERVICE = "layout_inflater"`
`static final String`	`LOCALE_SERVICE = "locale"`
`static final String`	`LOCATION_SERVICE = "location"`
`static final String`	`MEDIA_COMMUNICATION_SERVICE = "media_communication"`
`static final String`	`MEDIA_METRICS_SERVICE = "media_metrics"`
`static final String`	`MEDIA_PROJECTION_SERVICE = "media_projection"`
`static final String`	`MEDIA_QUALITY_SERVICE = "media_quality"`
`static final String`	`MEDIA_ROUTER_SERVICE = "media_router"`
`static final String`	`MEDIA_SESSION_SERVICE = "media_session"`
`static final String`	`MIDI_SERVICE = "midi"`
`static final int`	`MODE_APPEND = 32768`
`static final int`	`MODE_ENABLE_WRITE_AHEAD_LOGGING = 8`
`static final int`	`MODE_MULTI_PROCESS = 4` This field is deprecated.
`static final int`	`MODE_NO_LOCALIZED_COLLATORS = 16`
`static final int`	`MODE_PRIVATE = 0`
`static final int`	`MODE_WORLD_READABLE = 1` This field is deprecated.
`static final int`	`MODE_WORLD_WRITEABLE = 2` This field is deprecated.
`static final String`	`NETWORK_STATS_SERVICE = "netstats"`
`static final String`	`NFC_SERVICE = "nfc"`
`static final String`	`NOTIFICATION_SERVICE = "notification"`
`static final String`	`NSD_SERVICE = "servicediscovery"`
`static final String`	`OVERLAY_SERVICE = "overlay"`
`static final String`	`PEOPLE_SERVICE = "people"`
`static final String`	`PERFORMANCE_HINT_SERVICE = "performance_hint"`
`static final String`	`PERSISTENT_DATA_BLOCK_SERVICE = "persistent_data_block"`
`static final String`	`POWER_SERVICE = "power"`
`static final String`	`PRINT_SERVICE = "print"`
`static final String`	`PROFILING_SERVICE = "profiling"`
`static final int`	`RECEIVER_EXPORTED = 2`
`static final int`	`RECEIVER_NOT_EXPORTED = 4`
`static final int`	`RECEIVER_VISIBLE_TO_INSTANT_APPS = 1`
`static final String`	`RESTRICTIONS_SERVICE = "restrictions"`
`static final String`	`ROLE_SERVICE = "role"`
`static final String`	`SATELLITE_SERVICE = "satellite"`
`static final String`	`SEARCH_SERVICE = "search"`
`static final String`	`SECURITY_STATE_SERVICE = "security_state"`
`static final String`	`SENSOR_SERVICE = "sensor"`
`static final String`	`SHORTCUT_SERVICE = "shortcut"`
`static final String`	`STATUS_BAR_SERVICE = "statusbar"`
`static final String`	`STORAGE_SERVICE = "storage"`
`static final String`	`STORAGE_STATS_SERVICE = "storagestats"`
`static final String`	`SYSTEM_HEALTH_SERVICE = "systemhealth"`
`static final String`	`TELECOM_SERVICE = "telecom"`
`static final String`	`TELEPHONY_IMS_SERVICE = "telephony_ims"`
`static final String`	`TELEPHONY_SERVICE = "phone"`
`static final String`	`TELEPHONY_SUBSCRIPTION_SERVICE = "telephony_subscription_service"`
`static final String`	`TETHERING_SERVICE = "tethering"`
`static final String`	`TEXT_CLASSIFICATION_SERVICE = "textclassification"`
`static final String`	`TEXT_SERVICES_MANAGER_SERVICE = "textservices"`
`static final String`	`TV_AD_SERVICE = "tv_ad"`
`static final String`	`TV_INPUT_SERVICE = "tv_input"`
`static final String`	`TV_INTERACTIVE_APP_SERVICE = "tv_interactive_app"`
`static final String`	`UI_MODE_SERVICE = "uimode"`
`static final String`	`USAGE_STATS_SERVICE = "usagestats"`
`static final String`	`USB_SERVICE = "usb"`
`static final String`	`USER_SERVICE = "user"`
`static final String`	`VIBRATOR_MANAGER_SERVICE = "vibrator_manager"`
`static final String`	`VIBRATOR_SERVICE = "vibrator"` This field is deprecated.
`static final String`	`VIRTUAL_DEVICE_SERVICE = "virtualdevice"`
`static final String`	`VPN_MANAGEMENT_SERVICE = "vpn_management"`
`static final String`	`WALLPAPER_SERVICE = "wallpaper"`
`static final String`	`WIFI_AWARE_SERVICE = "wifiaware"`
`static final String`	`WIFI_P2P_SERVICE = "wifip2p"`
`static final String`	`WIFI_RTT_RANGING_SERVICE = "wifirtt"`
`static final String`	`WIFI_SERVICE = "wifi"`
`static final String`	`WINDOW_SERVICE = "window"`

Inherited methods

From androidx.car.app.CarContext

`@Nullable ComponentName`	`@RequiresCarApi(value = 2) getCallingComponent()` Return the component (service or activity) that invoked this car app.
`int`	`getCarAppApiLevel()` Retrieves the API level negotiated with the host.
`@NonNull String`	`getCarServiceName(@NonNull Class<Object> serviceClass)` Gets the name of the car service that is represented by the specified class.
`@Nullable HostInfo`	`getHostInfo()` Returns information about the host attached to this service.
`@NonNull OnBackPressedDispatcher`	`getOnBackPressedDispatcher()` Returns the `OnBackPressedDispatcher` that will be triggered when the user clicks a back button.
`boolean`	`isDarkMode()` Returns `true` if the car is set to dark mode.
`void`	`requestPermissions( @NonNull List<String> permissions, @NonNull OnRequestPermissionsListener listener )` Requests the provided `permissions` from the user, calling the provided `listener` in the main thread.
`void`	`@RequiresCarApi(value = 2) setCarAppResult(int resultCode, @Nullable Intent data)` Sets the result of this car app.
`static void`	`startCarApp(@NonNull Intent notificationIntent, @NonNull Intent appIntent)` This method is deprecated. use `getCarApp` to create the pending intent for the notification action.

From android.content.Context

`final int`	`getColor(int id)`
`final ColorStateList`	`getColorStateList(int id)`
`final Drawable`	`getDrawable(int id)`
`final String`	`getString(int resId)`
`final T`	`<T> getSystemService(Class<T> serviceClass)`
`final CharSequence`	`getText(int resId)`
`final TypedArray`	`obtainStyledAttributes(AttributeSet set, int[] attrs)`
`void`	`revokeSelfPermissionOnKill(String permName)`
`void`	`sendBroadcastWithMultiplePermissions( Intent intent, String[] receiverPermissions )`

From android.content.ContextWrapper

`void`	`attachBaseContext(Context base)`
`boolean`	`bindIsolatedService( Intent service, int flags, String instanceName, Executor executor, ServiceConnection conn )`
`boolean`	`bindService( Intent service, Context.BindServiceFlags flags, Executor executor, ServiceConnection conn )`
`boolean`	`bindServiceAsUser( Intent service, ServiceConnection conn, Context.BindServiceFlags flags, UserHandle user )`
`int`	`checkCallingOrSelfPermission(String permission)`
`int`	`checkCallingOrSelfUriPermission(Uri uri, int modeFlags)`
`int[]`	`checkCallingOrSelfUriPermissions(List<Uri> uris, int modeFlags)`
`int`	`checkCallingPermission(String permission)`
`int`	`checkCallingUriPermission(Uri uri, int modeFlags)`
`int[]`	`checkCallingUriPermissions(List<Uri> uris, int modeFlags)`
`int`	`checkContentUriPermissionFull(Uri uri, int pid, int uid, int modeFlags)`
`int`	`checkPermission(String permission, int pid, int uid)`
`int`	`checkSelfPermission(String permission)`
`int`	`checkUriPermission(Uri uri, int pid, int uid, int modeFlags)`
`int[]`	`checkUriPermissions(List<Uri> uris, int pid, int uid, int modeFlags)`
`void`	`clearWallpaper()` This method is deprecated.
`Context`	`createAttributionContext(String attributionTag)`
`Context`	`createConfigurationContext(Configuration overrideConfiguration)`
`Context`	`createContext(ContextParams contextParams)`
`Context`	`createContextForSplit(String splitName)`
`Context`	`createDeviceContext(int deviceId)`
`Context`	`createDeviceProtectedStorageContext()`
`Context`	`createDisplayContext(Display display)`
`Context`	`createPackageContext(String packageName, int flags)`
`Context`	`createWindowContext(Display display, int type, Bundle options)`
`String[]`	`databaseList()`
`boolean`	`deleteDatabase(String name)`
`boolean`	`deleteFile(String name)`
`boolean`	`deleteSharedPreferences(String name)`
`void`	`enforceCallingOrSelfPermission(String permission, String message)`
`void`	`enforceCallingOrSelfUriPermission( Uri uri, int modeFlags, String message )`
`void`	`enforceCallingPermission(String permission, String message)`
`void`	`enforceCallingUriPermission(Uri uri, int modeFlags, String message)`
`void`	`enforcePermission(String permission, int pid, int uid, String message)`
`void`	`enforceUriPermission( Uri uri, int pid, int uid, int modeFlags, String message )`
`String[]`	`fileList()`
`Context`	`getApplicationContext()`
`ApplicationInfo`	`getApplicationInfo()`
`AssetManager`	`getAssets()`
`AttributionSource`	`getAttributionSource()`
`String`	`getAttributionTag()`
`Context`	`getBaseContext()`
`File`	`getCacheDir()`
`ClassLoader`	`getClassLoader()`
`File`	`getCodeCacheDir()`
`ContentResolver`	`getContentResolver()`
`File`	`getDataDir()`
`File`	`getDatabasePath(String name)`
`int`	`getDeviceId()`
`File`	`getDir(String name, int mode)`
`Display`	`getDisplay()`
`File`	`getExternalCacheDir()`
`File[]`	`getExternalCacheDirs()`
`File`	`getExternalFilesDir(String type)`
`File[]`	`getExternalFilesDirs(String type)`
`File[]`	`getExternalMediaDirs()` This method is deprecated.
`File`	`getFileStreamPath(String name)`
`File`	`getFilesDir()`
`Executor`	`getMainExecutor()`
`Looper`	`getMainLooper()`
`File`	`getNoBackupFilesDir()`
`File`	`getObbDir()`
`File[]`	`getObbDirs()`
`String`	`getOpPackageName()`
`String`	`getPackageCodePath()`
`PackageManager`	`getPackageManager()`
`String`	`getPackageName()`
`String`	`getPackageResourcePath()`
`ContextParams`	`getParams()`
`Resources`	`getResources()`
`SharedPreferences`	`getSharedPreferences(String name, int mode)`
`Object`	`getSystemService(String name)`
`String`	`getSystemServiceName(Class<Object> serviceClass)`
`Resources.Theme`	`getTheme()`
`Drawable`	`getWallpaper()` This method is deprecated.
`int`	`getWallpaperDesiredMinimumHeight()` This method is deprecated.
`int`	`getWallpaperDesiredMinimumWidth()` This method is deprecated.
`void`	`grantUriPermission(String toPackage, Uri uri, int modeFlags)`
`boolean`	`isDeviceProtectedStorage()`
`boolean`	`isRestricted()`
`boolean`	`isUiContext()`
`boolean`	`moveDatabaseFrom(Context sourceContext, String name)`
`boolean`	`moveSharedPreferencesFrom(Context sourceContext, String name)`
`FileInputStream`	`openFileInput(String name)`
`FileOutputStream`	`openFileOutput(String name, int mode)`
`SQLiteDatabase`	`openOrCreateDatabase( String name, int mode, SQLiteDatabase.CursorFactory factory )`
`Drawable`	`peekWallpaper()` This method is deprecated.
`void`	`registerComponentCallbacks(ComponentCallbacks callback)`
`void`	`registerDeviceIdChangeListener(Executor executor, IntConsumer listener)`
`Intent`	`registerReceiver(BroadcastReceiver receiver, IntentFilter filter)`
`void`	`removeStickyBroadcast(Intent intent)` This method is deprecated.
`void`	`removeStickyBroadcastAsUser(Intent intent, UserHandle user)` This method is deprecated.
`void`	`revokeSelfPermissionsOnKill(Collection<String> permissions)`
`void`	`revokeUriPermission(Uri uri, int modeFlags)`
`void`	`sendBroadcast(Intent intent)`
`void`	`sendBroadcastAsUser(Intent intent, UserHandle user)`
`void`	`sendOrderedBroadcast( Intent intent, int initialCode, String receiverPermission, String receiverAppOp, BroadcastReceiver resultReceiver, Handler scheduler, String initialData, Bundle initialExtras, Bundle options )`
`void`	`sendOrderedBroadcastAsUser( Intent intent, UserHandle user, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras )`
`void`	`sendStickyBroadcast(Intent intent)` This method is deprecated.
`void`	`sendStickyBroadcastAsUser(Intent intent, UserHandle user)` This method is deprecated.
`void`	`sendStickyOrderedBroadcast( Intent intent, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras )` This method is deprecated.
`void`	`sendStickyOrderedBroadcastAsUser( Intent intent, UserHandle user, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras )` This method is deprecated.
`void`	`setTheme(int resid)`
`void`	`setWallpaper(Bitmap bitmap)` This method is deprecated.
`void`	`startActivities(Intent[] intents)`
`void`	`startActivity(Intent intent)`
`ComponentName`	`startForegroundService(Intent service)`
`boolean`	`startInstrumentation( ComponentName className, String profileFile, Bundle arguments )`
`void`	`startIntentSender( IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags )`
`ComponentName`	`startService(Intent service)`
`boolean`	`stopService(Intent name)`
`void`	`unbindService(ServiceConnection conn)`
`void`	`unregisterComponentCallbacks(ComponentCallbacks callback)`
`void`	`unregisterDeviceIdChangeListener(IntConsumer listener)`
`void`	`unregisterReceiver(BroadcastReceiver receiver)`
`void`	`updateServiceGroup(ServiceConnection conn, int group, int importance)`

Public methods

createCarContext

Added in 1.1.0

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

Creates a TestCarContext to use for testing.

Throws
`java.lang.NullPointerException`	if `testContext` is null

finishCarApp

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.

getCarService

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.

Parameters
`@NonNull String name`	The name of the car service requested. This should be one of `APP_SERVICE`, `NAVIGATION_SERVICE` or `SCREEN_SERVICE`

Returns
`@NonNull Object`	The car service instance

Throws
`java.lang.IllegalArgumentException`	if `name` does not refer to a valid car service
`java.lang.IllegalStateException`	if the service referred by `name` can not be instantiated (e.g. missing library dependency)
`java.lang.NullPointerException`	if `name` is `null`

getCarService

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.

Parameters
`@NonNull Class<T> serviceClass`	the class of the requested service

Throws
`java.lang.IllegalArgumentException`	if `serviceClass` is not the class of a supported car service
`java.lang.IllegalStateException`	if `serviceClass` can not be instantiated (e.g. missing library dependency)
`java.lang.NullPointerException`	if `serviceClass` is `null`

getFakeHost

Added in 1.1.0

public @NonNull FakeHost getFakeHost()

Retrieve the FakeHost being used.

getLastPermissionRequestInfo

Added in 1.1.0

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.

getStartCarAppIntents

Added in 1.1.0

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.

hasCalledFinishCarApp

Added in 1.1.0

public boolean hasCalledFinishCarApp()

Verifies if finishCarApp has been called.

requestPermissions

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.

Platform Considerations Using this method allows the app to work across all platforms supported by the library with the same API (e.g. Android Auto on mobile devices and Android Automotive OS on native car heads unit). On a mobile platform, this method will start an activity that will display the platform's permissions UI over it. You can choose to not use this method and instead implement your own activity and code to request the permissions in that platform. On Automotive OS however, distraction-optimized activities other than CarAppActivity are not allowed and may be rejected during app submission. See CarAppActivity for more details.

Parameters
`@NonNull List<String> permissions`	the runtime permissions to request from the user
`@NonNull Executor executor`	the executor that will be used for calling the `callback` provided
`@NonNull OnRequestPermissionsListener listener`	listener that will be notified when the user takes action on the permission request

Throws
`java.lang.NullPointerException`	if any of `executor`, `permissions` or `callback` are `null`

reset

Added in 1.1.0

public void reset()

Resets the values tracked by this TestCarContext.

startCarApp

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.

Parameters
`@NonNull Intent intent`	the `Intent` to send to the target application

Throws
`java.lang.SecurityException`	if the app attempts to start a different app explicitly or does not have permissions for the requested action
`androidx.car.app.HostException`	if the remote call fails. For example, if the intent cannot be handled by the car host.
`java.lang.NullPointerException`	if `intent` is `null`

TestCarContext

Summary

Nested types

Public methods

Inherited Constants

Inherited methods

Public methods

createCarContext

finishCarApp

getCarService

getCarService

getFakeHost

getLastPermissionRequestInfo

getStartCarAppIntents

hasCalledFinishCarApp

requestPermissions

reset

startCarApp