Summary: Constants | Inherited Constants | Ctors | Methods | Inherited Methods

CarAppService

Kotlin |Java

public abstract class CarAppService
extends Service

java.lang.Object
↳	android.content.Context
	↳	android.content.ContextWrapper
		↳	android.app.Service
			↳	androidx.car.app.CarAppService

The base class for implementing a car app that runs in the car.

Service Declaration

The app must extend the CarAppService to be bound by the car host. The service must also respond to Intent actions coming from the host, by adding an intent-filter to the service in the AndroidManifest.xml that handles the SERVICE_INTERFACE action. The app must also declare what category of application it is (e.g. CATEGORY_NAVIGATION_APP). For example:

<service
   android:name=".YourAppService"
   android:exported="true">
   <intent-filter>
     <action android:name="androidx.car.app.CarAppService" />
     <category android:name="androidx.car.app.category.NAVIGATION"/>
   </intent-filter>
 </service>

Accessing Location

When the app is running in the car display, the system will not consider it as being in the foreground, and hence it will be considered in the background for the purpose of retrieving location as described here.

To reliably get location for your car app, we recommended that you use a foreground service. Also note that accessing location may become unreliable when the phone is in the battery saver mode.

Summary

Constants
`String`	`CATEGORY_CHARGING_APP` Used to declare that this app is a charging app in the manifest.
`String`	`CATEGORY_NAVIGATION_APP` Used to declare that this app is a navigation app in the manifest.
`String`	`CATEGORY_PARKING_APP` Used to declare that this app is a parking app in the manifest.
`String`	`SERVICE_INTERFACE` The `Intent` that must be declared as handled by the service.

Inherited constants

From class android.app.Service

`int`	`START_CONTINUATION_MASK`
`int`	`START_FLAG_REDELIVERY`
`int`	`START_FLAG_RETRY`
`int`	`START_NOT_STICKY`
`int`	`START_REDELIVER_INTENT`
`int`	`START_STICKY`
`int`	`START_STICKY_COMPATIBILITY`
`int`	`STOP_FOREGROUND_DETACH`
`int`	`STOP_FOREGROUND_REMOVE`

From class android.content.Context

`String`	`ACCESSIBILITY_SERVICE`
`String`	`ACCOUNT_SERVICE`
`String`	`ACTIVITY_SERVICE`
`String`	`ALARM_SERVICE`
`String`	`APPWIDGET_SERVICE`
`String`	`APP_OPS_SERVICE`
`String`	`AUDIO_SERVICE`
`String`	`BATTERY_SERVICE`
`int`	`BIND_ABOVE_CLIENT`
`int`	`BIND_ADJUST_WITH_ACTIVITY`
`int`	`BIND_ALLOW_OOM_MANAGEMENT`
`int`	`BIND_AUTO_CREATE`
`int`	`BIND_DEBUG_UNBIND`
`int`	`BIND_EXTERNAL_SERVICE`
`int`	`BIND_IMPORTANT`
`int`	`BIND_INCLUDE_CAPABILITIES`
`int`	`BIND_NOT_FOREGROUND`
`int`	`BIND_NOT_PERCEPTIBLE`
`int`	`BIND_WAIVE_PRIORITY`
`String`	`BIOMETRIC_SERVICE`
`String`	`BLOB_STORE_SERVICE`
`String`	`BLUETOOTH_SERVICE`
`String`	`CAMERA_SERVICE`
`String`	`CAPTIONING_SERVICE`
`String`	`CARRIER_CONFIG_SERVICE`
`String`	`CLIPBOARD_SERVICE`
`String`	`COMPANION_DEVICE_SERVICE`
`String`	`CONNECTIVITY_DIAGNOSTICS_SERVICE`
`String`	`CONNECTIVITY_SERVICE`
`String`	`CONSUMER_IR_SERVICE`
`int`	`CONTEXT_IGNORE_SECURITY`
`int`	`CONTEXT_INCLUDE_CODE`
`int`	`CONTEXT_RESTRICTED`
`String`	`CROSS_PROFILE_APPS_SERVICE`
`String`	`DEVICE_POLICY_SERVICE`
`String`	`DISPLAY_SERVICE`
`String`	`DOWNLOAD_SERVICE`
`String`	`DROPBOX_SERVICE`
`String`	`EUICC_SERVICE`
`String`	`FILE_INTEGRITY_SERVICE`
`String`	`FINGERPRINT_SERVICE`
`String`	`HARDWARE_PROPERTIES_SERVICE`
`String`	`INPUT_METHOD_SERVICE`
`String`	`INPUT_SERVICE`
`String`	`IPSEC_SERVICE`
`String`	`JOB_SCHEDULER_SERVICE`
`String`	`KEYGUARD_SERVICE`
`String`	`LAUNCHER_APPS_SERVICE`
`String`	`LAYOUT_INFLATER_SERVICE`
`String`	`LOCATION_SERVICE`
`String`	`MEDIA_PROJECTION_SERVICE`
`String`	`MEDIA_ROUTER_SERVICE`
`String`	`MEDIA_SESSION_SERVICE`
`String`	`MIDI_SERVICE`
`int`	`MODE_APPEND`
`int`	`MODE_ENABLE_WRITE_AHEAD_LOGGING`
`int`	`MODE_MULTI_PROCESS`
`int`	`MODE_NO_LOCALIZED_COLLATORS`
`int`	`MODE_PRIVATE`
`int`	`MODE_WORLD_READABLE`
`int`	`MODE_WORLD_WRITEABLE`
`String`	`NETWORK_STATS_SERVICE`
`String`	`NFC_SERVICE`
`String`	`NOTIFICATION_SERVICE`
`String`	`NSD_SERVICE`
`String`	`POWER_SERVICE`
`String`	`PRINT_SERVICE`
`int`	`RECEIVER_VISIBLE_TO_INSTANT_APPS`
`String`	`RESTRICTIONS_SERVICE`
`String`	`ROLE_SERVICE`
`String`	`SEARCH_SERVICE`
`String`	`SENSOR_SERVICE`
`String`	`SHORTCUT_SERVICE`
`String`	`STORAGE_SERVICE`
`String`	`STORAGE_STATS_SERVICE`
`String`	`SYSTEM_HEALTH_SERVICE`
`String`	`TELECOM_SERVICE`
`String`	`TELEPHONY_IMS_SERVICE`
`String`	`TELEPHONY_SERVICE`
`String`	`TELEPHONY_SUBSCRIPTION_SERVICE`
`String`	`TEXT_CLASSIFICATION_SERVICE`
`String`	`TEXT_SERVICES_MANAGER_SERVICE`
`String`	`TV_INPUT_SERVICE`
`String`	`UI_MODE_SERVICE`
`String`	`USAGE_STATS_SERVICE`
`String`	`USB_SERVICE`
`String`	`USER_SERVICE`
`String`	`VIBRATOR_SERVICE`
`String`	`VPN_MANAGEMENT_SERVICE`
`String`	`WALLPAPER_SERVICE`
`String`	`WIFI_AWARE_SERVICE`
`String`	`WIFI_P2P_SERVICE`
`String`	`WIFI_RTT_RANGING_SERVICE`
`String`	`WIFI_SERVICE`
`String`	`WINDOW_SERVICE`

From interface android.content.ComponentCallbacks2

`int`	`TRIM_MEMORY_BACKGROUND`
`int`	`TRIM_MEMORY_COMPLETE`
`int`	`TRIM_MEMORY_MODERATE`
`int`	`TRIM_MEMORY_RUNNING_CRITICAL`
`int`	`TRIM_MEMORY_RUNNING_LOW`
`int`	`TRIM_MEMORY_RUNNING_MODERATE`
`int`	`TRIM_MEMORY_UI_HIDDEN`

Public constructors
`CarAppService()`

Public methods
`abstract HostValidator`	`createHostValidator()` Returns the `HostValidator` this service will use to accept or reject host connections.
`final void`	`dump(FileDescriptor fd, PrintWriter writer, String[] args)`
`final Session`	`getCurrentSession()` Returns the current `Session` for this service.
`final HostInfo`	`getHostInfo()` Returns information about the host attached to this service.
`final IBinder`	`onBind(Intent intent)` Handles the host binding to this car app.
`abstract Session`	`onCreateSession()` Creates a new `Session` for the application.
`final boolean`	`onUnbind(Intent intent)` Handles the host unbinding from this car app.

Inherited methods

From class


        
          android.app.Service

`void`	`attachBaseContext(Context arg0)`
`void`	`dump(FileDescriptor arg0, PrintWriter arg1, String[] arg2)`
`final Application`	`getApplication()`
`final int`	`getForegroundServiceType()`
`abstract IBinder`	`onBind(Intent arg0)`
`void`	`onConfigurationChanged(Configuration arg0)`
`void`	`onCreate()`
`void`	`onDestroy()`
`void`	`onLowMemory()`
`void`	`onRebind(Intent arg0)`
`void`	`onStart(Intent arg0, int arg1)`
`int`	`onStartCommand(Intent arg0, int arg1, int arg2)`
`void`	`onTaskRemoved(Intent arg0)`
`void`	`onTrimMemory(int arg0)`
`boolean`	`onUnbind(Intent arg0)`
`final void`	`startForeground(int arg0, Notification arg1)`
`final void`	`startForeground(int arg0, Notification arg1, int arg2)`
`final void`	`stopForeground(int arg0)`
`final void`	`stopForeground(boolean arg0)`
`final void`	`stopSelf()`
`final void`	`stopSelf(int arg0)`
`final boolean`	`stopSelfResult(int arg0)`

From class


        
          android.content.ContextWrapper

`void`	`attachBaseContext(Context arg0)`
`boolean`	`bindIsolatedService(Intent arg0, int arg1, String arg2, Executor arg3, ServiceConnection arg4)`
`boolean`	`bindService(Intent arg0, int arg1, Executor arg2, ServiceConnection arg3)`
`boolean`	`bindService(Intent arg0, ServiceConnection arg1, int arg2)`
`boolean`	`bindServiceAsUser(Intent arg0, ServiceConnection arg1, int arg2, UserHandle arg3)`
`int`	`checkCallingOrSelfPermission(String arg0)`
`int`	`checkCallingOrSelfUriPermission(Uri arg0, int arg1)`
`int`	`checkCallingPermission(String arg0)`
`int`	`checkCallingUriPermission(Uri arg0, int arg1)`
`int`	`checkPermission(String arg0, int arg1, int arg2)`
`int`	`checkSelfPermission(String arg0)`
`int`	`checkUriPermission(Uri arg0, String arg1, String arg2, int arg3, int arg4, int arg5)`
`int`	`checkUriPermission(Uri arg0, int arg1, int arg2, int arg3)`
`void`	`clearWallpaper()`
`Context`	`createAttributionContext(String arg0)`
`Context`	`createConfigurationContext(Configuration arg0)`
`Context`	`createContextForSplit(String arg0)`
`Context`	`createDeviceProtectedStorageContext()`
`Context`	`createDisplayContext(Display arg0)`
`Context`	`createPackageContext(String arg0, int arg1)`
`Context`	`createWindowContext(int arg0, Bundle arg1)`
`String[]`	`databaseList()`
`boolean`	`deleteDatabase(String arg0)`
`boolean`	`deleteFile(String arg0)`
`boolean`	`deleteSharedPreferences(String arg0)`
`void`	`enforceCallingOrSelfPermission(String arg0, String arg1)`
`void`	`enforceCallingOrSelfUriPermission(Uri arg0, int arg1, String arg2)`
`void`	`enforceCallingPermission(String arg0, String arg1)`
`void`	`enforceCallingUriPermission(Uri arg0, int arg1, String arg2)`
`void`	`enforcePermission(String arg0, int arg1, int arg2, String arg3)`
`void`	`enforceUriPermission(Uri arg0, String arg1, String arg2, int arg3, int arg4, int arg5, String arg6)`
`void`	`enforceUriPermission(Uri arg0, int arg1, int arg2, int arg3, String arg4)`
`String[]`	`fileList()`
`Context`	`getApplicationContext()`
`ApplicationInfo`	`getApplicationInfo()`
`AssetManager`	`getAssets()`
`String`	`getAttributionTag()`
`Context`	`getBaseContext()`
`File`	`getCacheDir()`
`ClassLoader`	`getClassLoader()`
`File`	`getCodeCacheDir()`
`ContentResolver`	`getContentResolver()`
`File`	`getDataDir()`
`File`	`getDatabasePath(String arg0)`
`File`	`getDir(String arg0, int arg1)`
`Display`	`getDisplay()`
`File`	`getExternalCacheDir()`
`File[]`	`getExternalCacheDirs()`
`File`	`getExternalFilesDir(String arg0)`
`File[]`	`getExternalFilesDirs(String arg0)`
`File[]`	`getExternalMediaDirs()`
`File`	`getFileStreamPath(String arg0)`
`File`	`getFilesDir()`
`Executor`	`getMainExecutor()`
`Looper`	`getMainLooper()`
`File`	`getNoBackupFilesDir()`
`File`	`getObbDir()`
`File[]`	`getObbDirs()`
`String`	`getOpPackageName()`
`String`	`getPackageCodePath()`
`PackageManager`	`getPackageManager()`
`String`	`getPackageName()`
`String`	`getPackageResourcePath()`
`Resources`	`getResources()`
`SharedPreferences`	`getSharedPreferences(String arg0, int arg1)`
`Object`	`getSystemService(String arg0)`
`String`	`getSystemServiceName(Class<?> arg0)`
`Resources.Theme`	`getTheme()`
`Drawable`	`getWallpaper()`
`int`	`getWallpaperDesiredMinimumHeight()`
`int`	`getWallpaperDesiredMinimumWidth()`
`void`	`grantUriPermission(String arg0, Uri arg1, int arg2)`
`boolean`	`isDeviceProtectedStorage()`
`boolean`	`isRestricted()`
`boolean`	`moveDatabaseFrom(Context arg0, String arg1)`
`boolean`	`moveSharedPreferencesFrom(Context arg0, String arg1)`
`FileInputStream`	`openFileInput(String arg0)`
`FileOutputStream`	`openFileOutput(String arg0, int arg1)`
`SQLiteDatabase`	`openOrCreateDatabase(String arg0, int arg1, SQLiteDatabase.CursorFactory arg2, DatabaseErrorHandler arg3)`
`SQLiteDatabase`	`openOrCreateDatabase(String arg0, int arg1, SQLiteDatabase.CursorFactory arg2)`
`Drawable`	`peekWallpaper()`
`Intent`	`registerReceiver(BroadcastReceiver arg0, IntentFilter arg1)`
`Intent`	`registerReceiver(BroadcastReceiver arg0, IntentFilter arg1, int arg2)`
`Intent`	`registerReceiver(BroadcastReceiver arg0, IntentFilter arg1, String arg2, Handler arg3, int arg4)`
`Intent`	`registerReceiver(BroadcastReceiver arg0, IntentFilter arg1, String arg2, Handler arg3)`
`void`	`removeStickyBroadcast(Intent arg0)`
`void`	`removeStickyBroadcastAsUser(Intent arg0, UserHandle arg1)`
`void`	`revokeUriPermission(Uri arg0, int arg1)`
`void`	`revokeUriPermission(String arg0, Uri arg1, int arg2)`
`void`	`sendBroadcast(Intent arg0, String arg1)`
`void`	`sendBroadcast(Intent arg0)`
`void`	`sendBroadcastAsUser(Intent arg0, UserHandle arg1)`
`void`	`sendBroadcastAsUser(Intent arg0, UserHandle arg1, String arg2)`
`void`	`sendOrderedBroadcast(Intent arg0, String arg1, String arg2, BroadcastReceiver arg3, Handler arg4, int arg5, String arg6, Bundle arg7)`
`void`	`sendOrderedBroadcast(Intent arg0, int arg1, String arg2, String arg3, BroadcastReceiver arg4, Handler arg5, String arg6, Bundle arg7, Bundle arg8)`
`void`	`sendOrderedBroadcast(Intent arg0, String arg1, BroadcastReceiver arg2, Handler arg3, int arg4, String arg5, Bundle arg6)`
`void`	`sendOrderedBroadcast(Intent arg0, String arg1)`
`void`	`sendOrderedBroadcastAsUser(Intent arg0, UserHandle arg1, String arg2, BroadcastReceiver arg3, Handler arg4, int arg5, String arg6, Bundle arg7)`
`void`	`sendStickyBroadcast(Intent arg0)`
`void`	`sendStickyBroadcastAsUser(Intent arg0, UserHandle arg1)`
`void`	`sendStickyOrderedBroadcast(Intent arg0, BroadcastReceiver arg1, Handler arg2, int arg3, String arg4, Bundle arg5)`
`void`	`sendStickyOrderedBroadcastAsUser(Intent arg0, UserHandle arg1, BroadcastReceiver arg2, Handler arg3, int arg4, String arg5, Bundle arg6)`
`void`	`setTheme(int arg0)`
`void`	`setWallpaper(Bitmap arg0)`
`void`	`setWallpaper(InputStream arg0)`
`void`	`startActivities(Intent[] arg0, Bundle arg1)`
`void`	`startActivities(Intent[] arg0)`
`void`	`startActivity(Intent arg0)`
`void`	`startActivity(Intent arg0, Bundle arg1)`
`ComponentName`	`startForegroundService(Intent arg0)`
`boolean`	`startInstrumentation(ComponentName arg0, String arg1, Bundle arg2)`
`void`	`startIntentSender(IntentSender arg0, Intent arg1, int arg2, int arg3, int arg4)`
`void`	`startIntentSender(IntentSender arg0, Intent arg1, int arg2, int arg3, int arg4, Bundle arg5)`
`ComponentName`	`startService(Intent arg0)`
`boolean`	`stopService(Intent arg0)`
`void`	`unbindService(ServiceConnection arg0)`
`void`	`unregisterReceiver(BroadcastReceiver arg0)`
`void`	`updateServiceGroup(ServiceConnection arg0, int arg1, int arg2)`

From class


        
          android.content.Context

`boolean`	`bindIsolatedService(Intent arg0, int arg1, String arg2, Executor arg3, ServiceConnection arg4)`
`boolean`	`bindService(Intent arg0, int arg1, Executor arg2, ServiceConnection arg3)`
`abstract boolean`	`bindService(Intent arg0, ServiceConnection arg1, int arg2)`
`boolean`	`bindServiceAsUser(Intent arg0, ServiceConnection arg1, int arg2, UserHandle arg3)`
`abstract int`	`checkCallingOrSelfPermission(String arg0)`
`abstract int`	`checkCallingOrSelfUriPermission(Uri arg0, int arg1)`
`abstract int`	`checkCallingPermission(String arg0)`
`abstract int`	`checkCallingUriPermission(Uri arg0, int arg1)`
`abstract int`	`checkPermission(String arg0, int arg1, int arg2)`
`abstract int`	`checkSelfPermission(String arg0)`
`abstract int`	`checkUriPermission(Uri arg0, String arg1, String arg2, int arg3, int arg4, int arg5)`
`abstract int`	`checkUriPermission(Uri arg0, int arg1, int arg2, int arg3)`
`abstract void`	`clearWallpaper()`
`Context`	`createAttributionContext(String arg0)`
`abstract Context`	`createConfigurationContext(Configuration arg0)`
`abstract Context`	`createContextForSplit(String arg0)`
`abstract Context`	`createDeviceProtectedStorageContext()`
`abstract Context`	`createDisplayContext(Display arg0)`
`abstract Context`	`createPackageContext(String arg0, int arg1)`
`Context`	`createWindowContext(int arg0, Bundle arg1)`
`abstract String[]`	`databaseList()`
`abstract boolean`	`deleteDatabase(String arg0)`
`abstract boolean`	`deleteFile(String arg0)`
`abstract boolean`	`deleteSharedPreferences(String arg0)`
`abstract void`	`enforceCallingOrSelfPermission(String arg0, String arg1)`
`abstract void`	`enforceCallingOrSelfUriPermission(Uri arg0, int arg1, String arg2)`
`abstract void`	`enforceCallingPermission(String arg0, String arg1)`
`abstract void`	`enforceCallingUriPermission(Uri arg0, int arg1, String arg2)`
`abstract void`	`enforcePermission(String arg0, int arg1, int arg2, String arg3)`
`abstract void`	`enforceUriPermission(Uri arg0, String arg1, String arg2, int arg3, int arg4, int arg5, String arg6)`
`abstract void`	`enforceUriPermission(Uri arg0, int arg1, int arg2, int arg3, String arg4)`
`abstract String[]`	`fileList()`
`abstract Context`	`getApplicationContext()`
`abstract ApplicationInfo`	`getApplicationInfo()`
`abstract AssetManager`	`getAssets()`
`String`	`getAttributionTag()`
`abstract File`	`getCacheDir()`
`abstract ClassLoader`	`getClassLoader()`
`abstract File`	`getCodeCacheDir()`
`final int`	`getColor(int arg0)`
`final ColorStateList`	`getColorStateList(int arg0)`
`abstract ContentResolver`	`getContentResolver()`
`abstract File`	`getDataDir()`
`abstract File`	`getDatabasePath(String arg0)`
`abstract File`	`getDir(String arg0, int arg1)`
`Display`	`getDisplay()`
`final Drawable`	`getDrawable(int arg0)`
`abstract File`	`getExternalCacheDir()`
`abstract File[]`	`getExternalCacheDirs()`
`abstract File`	`getExternalFilesDir(String arg0)`
`abstract File[]`	`getExternalFilesDirs(String arg0)`
`abstract File[]`	`getExternalMediaDirs()`
`abstract File`	`getFileStreamPath(String arg0)`
`abstract File`	`getFilesDir()`
`Executor`	`getMainExecutor()`
`abstract Looper`	`getMainLooper()`
`abstract File`	`getNoBackupFilesDir()`
`abstract File`	`getObbDir()`
`abstract File[]`	`getObbDirs()`
`String`	`getOpPackageName()`
`abstract String`	`getPackageCodePath()`
`abstract PackageManager`	`getPackageManager()`
`abstract String`	`getPackageName()`
`abstract String`	`getPackageResourcePath()`
`abstract Resources`	`getResources()`
`abstract SharedPreferences`	`getSharedPreferences(String arg0, int arg1)`
`final String`	`getString(int arg0, Object... arg1)`
`final String`	`getString(int arg0)`
`final <T> T`	`getSystemService(Class<T> arg0)`
`abstract Object`	`getSystemService(String arg0)`
`abstract String`	`getSystemServiceName(Class<?> arg0)`
`final CharSequence`	`getText(int arg0)`
`abstract Resources.Theme`	`getTheme()`
`abstract Drawable`	`getWallpaper()`
`abstract int`	`getWallpaperDesiredMinimumHeight()`
`abstract int`	`getWallpaperDesiredMinimumWidth()`
`abstract void`	`grantUriPermission(String arg0, Uri arg1, int arg2)`
`abstract boolean`	`isDeviceProtectedStorage()`
`boolean`	`isRestricted()`
`abstract boolean`	`moveDatabaseFrom(Context arg0, String arg1)`
`abstract boolean`	`moveSharedPreferencesFrom(Context arg0, String arg1)`
`final TypedArray`	`obtainStyledAttributes(AttributeSet arg0, int[] arg1)`
`final TypedArray`	`obtainStyledAttributes(AttributeSet arg0, int[] arg1, int arg2, int arg3)`
`final TypedArray`	`obtainStyledAttributes(int arg0, int[] arg1)`
`final TypedArray`	`obtainStyledAttributes(int[] arg0)`
`abstract FileInputStream`	`openFileInput(String arg0)`
`abstract FileOutputStream`	`openFileOutput(String arg0, int arg1)`
`abstract SQLiteDatabase`	`openOrCreateDatabase(String arg0, int arg1, SQLiteDatabase.CursorFactory arg2, DatabaseErrorHandler arg3)`
`abstract SQLiteDatabase`	`openOrCreateDatabase(String arg0, int arg1, SQLiteDatabase.CursorFactory arg2)`
`abstract Drawable`	`peekWallpaper()`
`void`	`registerComponentCallbacks(ComponentCallbacks arg0)`
`abstract Intent`	`registerReceiver(BroadcastReceiver arg0, IntentFilter arg1)`
`abstract Intent`	`registerReceiver(BroadcastReceiver arg0, IntentFilter arg1, int arg2)`
`abstract Intent`	`registerReceiver(BroadcastReceiver arg0, IntentFilter arg1, String arg2, Handler arg3, int arg4)`
`abstract Intent`	`registerReceiver(BroadcastReceiver arg0, IntentFilter arg1, String arg2, Handler arg3)`
`abstract void`	`removeStickyBroadcast(Intent arg0)`
`abstract void`	`removeStickyBroadcastAsUser(Intent arg0, UserHandle arg1)`
`abstract void`	`revokeUriPermission(Uri arg0, int arg1)`
`abstract void`	`revokeUriPermission(String arg0, Uri arg1, int arg2)`
`abstract void`	`sendBroadcast(Intent arg0, String arg1)`
`abstract void`	`sendBroadcast(Intent arg0)`
`abstract void`	`sendBroadcastAsUser(Intent arg0, UserHandle arg1)`
`abstract void`	`sendBroadcastAsUser(Intent arg0, UserHandle arg1, String arg2)`
`void`	`sendBroadcastWithMultiplePermissions(Intent arg0, String[] arg1)`
`void`	`sendOrderedBroadcast(Intent arg0, String arg1, String arg2, BroadcastReceiver arg3, Handler arg4, int arg5, String arg6, Bundle arg7)`
`abstract void`	`sendOrderedBroadcast(Intent arg0, String arg1, BroadcastReceiver arg2, Handler arg3, int arg4, String arg5, Bundle arg6)`
`abstract void`	`sendOrderedBroadcast(Intent arg0, String arg1)`
`abstract void`	`sendOrderedBroadcastAsUser(Intent arg0, UserHandle arg1, String arg2, BroadcastReceiver arg3, Handler arg4, int arg5, String arg6, Bundle arg7)`
`abstract void`	`sendStickyBroadcast(Intent arg0)`
`abstract void`	`sendStickyBroadcastAsUser(Intent arg0, UserHandle arg1)`
`abstract void`	`sendStickyOrderedBroadcast(Intent arg0, BroadcastReceiver arg1, Handler arg2, int arg3, String arg4, Bundle arg5)`
`abstract void`	`sendStickyOrderedBroadcastAsUser(Intent arg0, UserHandle arg1, BroadcastReceiver arg2, Handler arg3, int arg4, String arg5, Bundle arg6)`
`abstract void`	`setTheme(int arg0)`
`abstract void`	`setWallpaper(Bitmap arg0)`
`abstract void`	`setWallpaper(InputStream arg0)`
`abstract void`	`startActivities(Intent[] arg0, Bundle arg1)`
`abstract void`	`startActivities(Intent[] arg0)`
`abstract void`	`startActivity(Intent arg0)`
`abstract void`	`startActivity(Intent arg0, Bundle arg1)`
`abstract ComponentName`	`startForegroundService(Intent arg0)`
`abstract boolean`	`startInstrumentation(ComponentName arg0, String arg1, Bundle arg2)`
`abstract void`	`startIntentSender(IntentSender arg0, Intent arg1, int arg2, int arg3, int arg4)`
`abstract void`	`startIntentSender(IntentSender arg0, Intent arg1, int arg2, int arg3, int arg4, Bundle arg5)`
`abstract ComponentName`	`startService(Intent arg0)`
`abstract boolean`	`stopService(Intent arg0)`
`abstract void`	`unbindService(ServiceConnection arg0)`
`void`	`unregisterComponentCallbacks(ComponentCallbacks arg0)`
`abstract void`	`unregisterReceiver(BroadcastReceiver arg0)`
`void`	`updateServiceGroup(ServiceConnection arg0, int arg1, int arg2)`

From class


        
          java.lang.Object

`Object`	`clone()`
`boolean`	`equals(Object arg0)`
`void`	`finalize()`
`final Class<?>`	`getClass()`
`int`	`hashCode()`
`final void`	`notify()`
`final void`	`notifyAll()`
`String`	`toString()`
`final void`	`wait(long arg0, int arg1)`
`final void`	`wait(long arg0)`
`final void`	`wait()`

From interface


        
          android.content.ComponentCallbacks2

abstract void onTrimMemory(int arg0)

From interface


        
          android.content.ComponentCallbacks

`abstract void`	`onConfigurationChanged(Configuration arg0)`
`abstract void`	`onLowMemory()`

Constants

CATEGORY_CHARGING_APP

public static final String CATEGORY_CHARGING_APP

Used to declare that this app is a charging app in the manifest.

Constant Value: "androidx.car.app.category.CHARGING"

CATEGORY_NAVIGATION_APP

public static final String CATEGORY_NAVIGATION_APP

Used to declare that this app is a navigation app in the manifest.

Constant Value: "androidx.car.app.category.NAVIGATION"

CATEGORY_PARKING_APP

public static final String CATEGORY_PARKING_APP

Used to declare that this app is a parking app in the manifest.

Constant Value: "androidx.car.app.category.PARKING"

SERVICE_INTERFACE

public static final String SERVICE_INTERFACE

The Intent that must be declared as handled by the service.

Constant Value: "androidx.car.app.CarAppService"

Public constructors

CarAppService

public CarAppService ()

Public methods

createHostValidator

public abstract HostValidator createHostValidator ()

Returns the HostValidator this service will use to accept or reject host connections.

By default, the provided HostValidator.Builder would produce a validator that only accepts connections from hosts holding HostValidator.TEMPLATE_RENDERER_PERMISSION permission.

Application developers are expected to also allow connections from known hosts which don't hold the aforementioned permission (for example, Android Auto and Android Automotive OS hosts below API level 31), by allow-listing the signatures of those hosts.

Please refer to R.array.hosts_allowlist_sample to obtain a list of package names and signatures that should be allow-listed by default.

It is also advised to allow connections from unknown hosts in debug builds to facilitate debugging and testing.

Below is an example of this method implementation:

 @Override
 @NonNull
 public HostValidator createHostValidator() {
     if ((getApplicationInfo().flags & ApplicationInfo.FLAG_DEBUGGABLE) != 0) {
         return HostValidator.ALLOW_ALL_HOSTS_VALIDATOR;
     } else {
         return new HostValidator.Builder()
             .addAllowedHosts(androidx.car.app.R.array.hosts_allowlist_sample)
             .build();
     }
 }

Returns
`HostValidator`

dump

public final void dump (FileDescriptor fd, 
                PrintWriter writer, 
                String[] args)

Parameters
`fd`	`FileDescriptor`
`writer`	`PrintWriter`
`args`	`String`

getCurrentSession

public final Session getCurrentSession ()

Returns the current Session for this service.

Returns
`Session`

getHostInfo

public final HostInfo getHostInfo ()

Returns information about the host attached to this service.

Returns
`HostInfo`

See also:

HostInfo

onBind

public final IBinder onBind (Intent intent)

Handles the host binding to this car app.

This method is final to ensure this car app's lifecycle is handled properly.

Use onCreateSession() and Session.onNewIntent(Intent) instead to handle incoming Intents.

Parameters
`intent`	`Intent`

Returns
`IBinder`

onCreateSession

public abstract Session onCreateSession ()

Creates a new Session for the application.

This method is invoked the first time the app is started, or if the previous Session instance has been destroyed and the system has not yet destroyed this service.

Once the method returns, Session.onCreateScreen(Intent) will be called on the Session returned.

Called by the system, do not call this method directly.

Returns
`Session`

See also:

CarContext.startCarApp(Intent)

onUnbind

public final boolean onUnbind (Intent intent)

Handles the host unbinding from this car app.

This method is final to ensure this car app's lifecycle is handled properly.

Parameters
`intent`	`Intent`

Returns
`boolean`