Test Android apps for cars

Stay organized with collections Save and categorize content based on your preferences.

While developing your app, there are tools available to run Android Auto and Android Automotive OS on your development computer. See Test your app using the Desktop Head Unit for details on how to install and use the Desktop Head Unit to run Android Auto apps. See Test your app using the Android Automotive OS emulator for details on how to install and run Android Automotive OS images.

Test in real vehicles

To test your app in real vehicles, it must be installed from a trusted source such as the Play Store, with one exception detailed in Allow unknown sources. You can use Internal App Sharing or an Internal Test Track to distribute your app to devices without going through the Play Store review process.

Allow unknown sources

On Android Auto, there is also a developer option to enable running apps not installed from a trusted source. This setting only applies to media and messaging apps and doesn't apply to apps built using the Android for Cars App Library.

Enable Android Auto developer mode

In addition to the Android developer options (usable on both Android Auto and Android Automotive OS), Android Auto has its own developer mode that can be used to improve the development experience. To enable it, follow these steps:

1. Open the Android Auto settings.

   • Android 10 or higher: on the device, tap Settings > Apps & notifications > See all apps > Android Auto > Advanced > Additional settings in the app.
   • Android 9 or lower: in the Android Auto app, tap the menu, then tap Settings.

2. Scroll to the About section near the bottom and tap Version to display the version and permission information.

3. Tap the Version and permission info section 10 times.

   The Allow development settings? dialog appears.

4. Tap OK.

   Developer mode is now enabled, and you can access developer options in the overflow menu. You only need to enable developer mode once. To quit developer mode, use the option from the drop-down menu in the app bar.

Additional testing requirements for media apps

If you are testing a media app, test for the scenarios that are covered in this section in addition to testing your app on Android Auto, Android Automotive OS, or both.

Test MediaBrowserService startup scenarios

To help keep drivers and passengers safe, users have additional restrictions on how they can interact with apps while driving. For this reason, Android Auto and Android Automotive OS have some MediaBrowserService startup scenarios that your app must be able to handle so that users can continue to enjoy your content while they're on the road.

Test your app to make sure it can handle each of the following scenarios:

• The MediaBrowserService is run before any Activity is opened.
• The MediaBrowserService is run when no Activity can be shown.
• The MediaBrowserService is run when the user is not signed in.

While testing for these scenarios, be sure to try the following methods:

• Force stop the media app, then launch Android Auto or Android Automotive OS.
• Clear the media app data, then launch Android Auto or Android Automotive OS.

Also make sure to set an appropriate error message when necessary.

Use the Media Controller Test app

The Media Controller Test app lets you test the intricacies of media playback on Android and helps verify your media session implementation. To get started with this tool, see Using the media controller test app.