[Android Auto] Functionality checklist

[kmadsen]

There is a set of requirements from Google's quality-guidelines. This issue is to provide visibility for how to handle each issue. It also shows which issues do not yet have a public example.

https://developer.android.com/docs/quality-guidelines/car-app-quality#functionality

Code	Description
NF-1	The app must provide turn-by-turn navigation directions.
NF-2	The app draws only map content on the surface of the navigation templates. Text-based turn-by-turn directions, lane guidance, and estimated arrival time must be displayed on the relevant components of the Navigation template. Additional information relevant to the drive (e.g., speed limit, road obstructions) can be drawn on the right side of the map.
NF-3	When the app provides text-based turn-by-turn directions, then it must also trigger navigation notifications. (Learn How)
NF-4	When the navigation app provides text-based turn-by-turn directions, it must send next-turn information to the vehicle’s cluster display. (Learn How)
NF-5	The app must not provide turn-by-turn notifications, voice guidance, or cluster information when another navigation app is providing turn-by-turn instructions. (Learn How)
NF-6	The app must handle navigation requests from other Android Auto apps. (Learn How)
NF-7	The app must provide a “test drive” mode that simulates driving. (Learn How)
NF-8	The app must draw a light-themed or dark-themed map when instructed to do so. (Learn How)

Status page for this examples repository

• [x] NF-1: See the ActiveGuidanceScreen. See the audioguidance module for voice guidance.
• [x] NF-2: See the MapboxCarMap for map rendering. And ActiveGuidanceScreen for text based navigation info. SpeedLimitWidget to show speed limit on map. CarLanesImageRenderer to show lange guidance images.
• [x] NF-3: See the TripNotificationInterceptor
• [x] NF-4: See the MapboxCarNavigationManager
• [x] NF-5: See the MapboxCarNavigationManager
• [x] NF-6: See the GeoDeeplinkNavigateAction
• [x] NF-7: See the MapboxCarNavigationManager
• [x] NF-8: See the MapboxCarMap

🔉 extension-androidauto-v0.1.0: The apis related to MapboxCarMap are have been moved to a permanent solution.

🔉 androidauto-v0.1.0: The apis related to Mapbox Navigation have been moved to a permanent solution.

cc: @mapbox/navigation-android @pengdev @yunikkk

[Guardiola31337]

This is great! Thanks for cutting this ticket @kmadsen 🙇‍♂️

For documentation's sake we should probably start collecting all these in a separate FAQ that we can add to the public docs at some point later.

cc @truburt

[linsd75]

This is great!

[kmadsen]

NF-4 and NF-5 vehicle’s cluster display can be tested with a custom configuration

$ cat instrumentcluster.ini
[general]
touch = true
touchpad = false
controller = false
instrumentcluster = true
resolution = 800x480
dpi = 160
framerate = 30

[sensors]
location = true
night_mode = true
driving_status = true

& ./desktop-head-unit -c instrumentcluster.ini

[kmadsen]

We're considering the functionality checklist complete. All and any issues related to Mapbox Android Auto have been moved to artifacts. Any further issues will be tracked in the maps or navigation repositories

https://github.com/mapbox/mapbox-navigation-android/issues?q=is%3Aopen+is%3Aissue+label%3A%22Android+Auto%22 https://github.com/mapbox/mapbox-maps-android/issues?q=is%3Aopen+is%3Aissue+label%3Aandroid-auto https://github.com/mapbox/mapbox-maps-android-internal/issues?q=is%3Aopen+is%3Aissue+label%3Aandroid-auto

[Mr-Ramzan]

Hi! I know this is closed, I have an Update rejected due to Android Auto Being used in My App. @kmadsen can you please guide me to remove Android-Auto-related code I do not want my app to support Android Auto. Can you Guide which component to exclude or any flags to disable Android Auto Support?

[kmadsen]

Hi! I know this is closed, I have an Update rejected due to Android Auto Being used in My App. @kmadsen can you please guide me to remove Android-Auto-related code I do not want my app to support Android Auto. Can you Guide which component to exclude or any flags to disable Android Auto Support?

@Mr-Ramzan Are you using Mapbox for Android Auto? If you are using a solution from the guide https://docs.mapbox.com/android/navigation/guides/androidauto/, will you please create an issue https://github.com/mapbox/mapbox-navigation-android/issues/new with details about your app rejection?