You can use the [Android Emulator](https://developer.android.com/studio/run/emulator) to test how your
app runs on Android Automotive OS.

## Add system images

Before you can create Android Automotive OS virtual devices, you need to add
system images through the Android Studio [SDK Manager](https://developer.android.com/studio/intro/update#sdk-manager).

### Add generic system images

Android Studio includes generic system images for Android Automotive OS that you
can use to test your app and which you should use when [taking screenshots for
Google Play](https://developer.android.com/training/cars/distribute#opt_in). All of these images include:

- [Google Play services](https://developer.android.com/training/cars/platforms/automotive-os/google-play/google-services)
- The [Google Automotive App Host](https://play.google.com/store/apps/details?id=com.google.android.apps.automotive.templates.host) *except the API 28 image, as the host is only available on devices running API
  29 or higher*

| **Important:** For system images without the Google Play Store, the version of Google Play services and the Google Automotive App Host available on an image is fixed. To update these apps, check for new versions of the image.
| **Caution:** Some images are only available for download when using an [Android
| Studio preview](https://developer.android.com/studio/preview) release, as noted in the *Availability* column. Once downloaded, they can be used from Android Studio stable release.
28 29 30 32 33 34 x86 ARM Google Play Store Compatibility mode Audio while driving Android Studio stable Android Studio preview Clear all  

|                                Name                                | API Level | Architecture |                                                                                                                               Features                                                                                                                               |                                                                                    Availability                                                                                     |
|--------------------------------------------------------------------|-----------|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Automotive Intel x86 Atom System Image                             | 28        | x86          | Google Play Store                                                                                                                                                                                                                                                    | ![Android Studio preview icon](https://developer.android.com/static/studio/images/android-studio-canary.svg) [Android Studio preview](https://developer.android.com/studio/preview) |
| Automotive with Play Store Intel x86 Atom System Image             | 29        | x86          | Google Play Store                                                                                                                                                                                                                                                    | ![Android Studio preview icon](https://developer.android.com/static/studio/images/android-studio-canary.svg) [Android Studio preview](https://developer.android.com/studio/preview) |
| Automotive with Play Store Intel x86_64 Atom System Image          | 30        | x86          | Google Play Store                                                                                                                                                                                                                                                    | ![Android Studio preview icon](https://developer.android.com/static/studio/images/android-studio-canary.svg) [Android Studio preview](https://developer.android.com/studio/preview) |
| Automotive with Play Store ARM 64 v8a System Image                 | 32        | ARM          | Google Play Store                                                                                                                                                                                                                                                    | ![Android Studio preview icon](https://developer.android.com/static/studio/images/android-studio-canary.svg) [Android Studio preview](https://developer.android.com/studio/preview) |
| Automotive with Play Store Intel x86_64 Atom System Image          | 32        | x86          | Google Play Store                                                                                                                                                                                                                                                    | ![Android Studio preview icon](https://developer.android.com/static/studio/images/android-studio-canary.svg) [Android Studio preview](https://developer.android.com/studio/preview) |
| Automotive Distant Display with Google APIs arm64-v8a System Image | 32        | ARM          |                                                                                                                                                                                                                                                                      | ![Android Studio preview icon](https://developer.android.com/static/studio/images/android-studio-canary.svg) [Android Studio preview](https://developer.android.com/studio/preview) |
| Automotive Distant Display with Google APIs x86_64 System Image    | 32        | x86          |                                                                                                                                                                                                                                                                      | ![Android Studio preview icon](https://developer.android.com/static/studio/images/android-studio-canary.svg) [Android Studio preview](https://developer.android.com/studio/preview) |
| Automotive Distant Display with Google Play arm64-v8a System Image | 32        | ARM          | Google Play Store                                                                                                                                                                                                                                                    | ![Android Studio preview icon](https://developer.android.com/static/studio/images/android-studio-canary.svg) [Android Studio preview](https://developer.android.com/studio/preview) |
| Automotive Distant Display with Google Play x86_64 System Image    | 32        | x86          | Google Play Store                                                                                                                                                                                                                                                    | ![Android Studio preview icon](https://developer.android.com/static/studio/images/android-studio-canary.svg) [Android Studio preview](https://developer.android.com/studio/preview) |
| Android Automotive with Google APIs ARM 64 v8a System Image        | 33        | ARM          |                                                                                                                                                                                                                                                                      | ![Android Studio stable icon](https://developer.android.com/static/studio/images/android-studio-stable.svg) [Android Studio stable](https://developer.android.com/studio)           |
| Android Automotive with Google APIs Intel x86_64 Atom System Image | 33        | x86          |                                                                                                                                                                                                                                                                      | ![Android Studio stable icon](https://developer.android.com/static/studio/images/android-studio-stable.svg) [Android Studio stable](https://developer.android.com/studio)           |
| Automotive Distant Display with Google Play arm64-v8a System Image | 33        | ARM          | Google Play Store                                                                                                                                                                                                                                                    | ![Android Studio stable icon](https://developer.android.com/static/studio/images/android-studio-stable.svg) [Android Studio stable](https://developer.android.com/studio)           |
| Automotive Distant Display with Google Play x86_64 System Image    | 33        | x86          | Google Play Store                                                                                                                                                                                                                                                    | ![Android Studio stable icon](https://developer.android.com/static/studio/images/android-studio-stable.svg) [Android Studio stable](https://developer.android.com/studio)           |
| Android Automotive with Google APIs arm64-v8a System Image         | 34-ext9   | ARM          | - [Compatibility mode](https://developer.android.com/training/cars/platforms/automotive-os/compatibility-mode) (revision 3+) - [Audio while driving](https://developer.android.com/training/cars/parked/video#audio-while-driving) (revision 5+)                     | ![Android Studio stable icon](https://developer.android.com/static/studio/images/android-studio-stable.svg) [Android Studio stable](https://developer.android.com/studio)           |
| Android Automotive with Google APIs x86_64 System Image            | 34-ext9   | x86          | - [Compatibility mode](https://developer.android.com/training/cars/platforms/automotive-os/compatibility-mode) (revision 3+) - [Audio while driving](https://developer.android.com/training/cars/parked/video#audio-while-driving) (revision 5+)                     | ![Android Studio stable icon](https://developer.android.com/static/studio/images/android-studio-stable.svg) [Android Studio stable](https://developer.android.com/studio)           |
| Android Automotive with Google Play arm64-v8a System Image         | 34-ext9   | ARM          | - Google Play Store - [Compatibility mode](https://developer.android.com/training/cars/platforms/automotive-os/compatibility-mode) (revision 2+) - [Audio while driving](https://developer.android.com/training/cars/parked/video#audio-while-driving) (revision 4+) | ![Android Studio stable icon](https://developer.android.com/static/studio/images/android-studio-stable.svg) [Android Studio stable](https://developer.android.com/studio)           |
| Android Automotive with Google Play x86_64 System Image            | 34-ext9   | x86          | - Google Play Store - [Compatibility mode](https://developer.android.com/training/cars/platforms/automotive-os/compatibility-mode) (revision 2+) - [Audio while driving](https://developer.android.com/training/cars/parked/video#audio-while-driving) (revision 4+) | ![Android Studio stable icon](https://developer.android.com/static/studio/images/android-studio-stable.svg) [Android Studio stable](https://developer.android.com/studio)           |

Follow these steps to install generic system images:

1. In Android Studio, select **Tools \> SDK Manager**.
2. Click the **SDK Platforms** tab.
3. Click **Show Package Details**.
4. Select which image(s) to download. See the preceding table for details.
5. Click **Apply** , then click **OK**.

   ![List of SDK Platform components a generic system image
   selected.](https://developer.android.com/static/images/training/cars/sdk-manager-automotive.png)

### Add system images from OEMs

You can also add OEM-specific system image for the GM, Honda, Polestar, Volvo,
and others. Please follow the steps on the OEM developer sites:

In alphabetic order:

1. [GM](https://developer.gm.com/in-vehicle-apps)
2. [Honda](https://global.honda/cars-apps/index.html)
3. [Polestar](https://www.polestar.com/global/developer#emulator)
4. [Volvo](https://developer.volvocars.com/in-car-apps/android-emulator-xc40/)

## Create a car AVD and run the emulator

Follow these steps to create an Android Virtual Device (AVD) that represents an
Android Automotive OS vehicle and then use that AVD to run the emulator:

1. In Android Studio, select **Tools \> AVD Manager**.
2. Click **Create Virtual Device**.
3. From the **Select Hardware** dialog, select **Automotive** , and then select a hardware profile. Click **Next**.
4. Select a system image that targets Automotive, such as **Android 12L
   (Automotive with Play Store)** , and click **Next**.
5. Name your AVD and select any other options that you want to customize, then click **Finish**.
6. From the tool window bar, select your Android Automotive OS AVD as your deployment target.
7. Click **Run** ![Run icon](https://developer.android.com/static/studio/images/buttons/toolbar-run.png).

### Use bundled hardware profiles

When creating an AVD, you can use the following [hardware
profiles](https://developer.android.com/studio/run/managing-avds#hardware-profile) that are bundled with
Android Studio:

|                                            Name                                            | Resolution | [Configurable](https://developer.android.com/training/cars/testing/emulator/configurable) |                                                                                                                    Compatibility                                                                                                                     |                                                                               Availability                                                                                |
|--------------------------------------------------------------------------------------------|------------|-------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Automotive (1024p landscape)                                                               | 1024x768   |                                                                                           | ![Google Play Store icon](https://developer.android.com/static/images/distribute/play-store-icon.svg) API 28-32 [system images](https://developer.android.com/training/cars/testing/emulator#system-images) with the Google Play Store               | ![Android Studio stable icon](https://developer.android.com/static/studio/images/android-studio-stable.svg) [Android Studio stable](https://developer.android.com/studio) |
| Automotive (1080p landscape)                                                               | 1080x600   | ✔                                                                                         | API 33+ [system images](https://developer.android.com/training/cars/testing/emulator#system-images) without the Google Play Store                                                                                                                    | ![Android Studio stable icon](https://developer.android.com/static/studio/images/android-studio-stable.svg) [Android Studio stable](https://developer.android.com/studio) |
| Automotive (1408p landscape) *Recommended for use with the API 34 images*                  | 1408x792   |                                                                                           | API 33+ [system images](https://developer.android.com/training/cars/testing/emulator#system-images) without the Google Play Store                                                                                                                    | ![Android Studio stable icon](https://developer.android.com/static/studio/images/android-studio-stable.svg) [Android Studio stable](https://developer.android.com/studio) |
| Automotive (1408p landscape) with Google Play *Recommended for use with the API 34 images* | 1408x792   |                                                                                           | ![Google Play Store icon](https://developer.android.com/static/images/distribute/play-store-icon.svg) API 33+ [system images](https://developer.android.com/training/cars/testing/emulator#system-images) with the Google Play Store                 | ![Android Studio stable icon](https://developer.android.com/static/studio/images/android-studio-stable.svg) [Android Studio stable](https://developer.android.com/studio) |
| Automotive Portrait                                                                        | 800x1280   |                                                                                           | API 33+ [system images](https://developer.android.com/training/cars/testing/emulator#system-images) without the Google Play Store                                                                                                                    | ![Android Studio stable icon](https://developer.android.com/static/studio/images/android-studio-stable.svg) [Android Studio stable](https://developer.android.com/studio) |
| Automotive Large Portrait                                                                  | 1280x1606  | ✔                                                                                         | API 33+ [system images](https://developer.android.com/training/cars/testing/emulator#system-images) without the Google Play Store                                                                                                                    | ![Android Studio stable icon](https://developer.android.com/static/studio/images/android-studio-stable.svg) [Android Studio stable](https://developer.android.com/studio) |
| Automotive Ultrawide                                                                       | 3904x1320  | ✔                                                                                         | API 33+ [system images](https://developer.android.com/training/cars/testing/emulator#system-images) without the Google Play Store                                                                                                                    | ![Android Studio stable icon](https://developer.android.com/static/studio/images/android-studio-stable.svg) [Android Studio stable](https://developer.android.com/studio) |
| Automotive Distant Display                                                                 | 1080x600   |                                                                                           | API 32+ Distant display [system images](https://developer.android.com/training/cars/testing/emulator#system-images) without the Google Play Store                                                                                                    | ![Android Studio stable icon](https://developer.android.com/static/studio/images/android-studio-stable.svg) [Android Studio stable](https://developer.android.com/studio) |
| Automotive Distant Display with Google Play                                                | 1080x600   |                                                                                           | ![Google Play Store icon](https://developer.android.com/static/images/distribute/play-store-icon.svg) API 32+ Distant display [system images](https://developer.android.com/training/cars/testing/emulator#system-images) with the Google Play Store | ![Android Studio stable icon](https://developer.android.com/static/studio/images/android-studio-stable.svg) [Android Studio stable](https://developer.android.com/studio) |

| **Note:** When you download [OEM images](https://developer.android.com/training/cars/testing/emulator#oem-images), additional OEM hardware profiles may come bundled with those images.

### Create a hardware profile

If you'd like to test hardware configurations other than those covered by the
bundled hardware profiles, you can also [create a hardware
profile](https://developer.android.com/studio/run/managing-avds#createhp) for use with the Android
Automotive OS emulator. Do this by selecting **Android Automotive** as the
device type in the creation flow. Custom hardware profiles are only compatible
with [system images](https://developer.android.com/training/cars/testing/emulator#system-images) that don't include the Google Play Store.

## Use the emulator's extended controls

In addition to many of the standard [extended
controls](https://developer.android.com/studio/run/emulator-extended-controls) available in other Android
emulators, there are some extended controls made specifically for the Android
Automotive OS emulator.

### Emulate hardware state

![The](https://developer.android.com/static/images/training/cars/extended-controls-vhal-properties.png)

Beyond sensors such as accelerometers and gyroscopes that can be read using
the [standard Android APIs](https://developer.android.com/guide/topics/sensors/sensors_overview) when
available, additional hardware properties unique to vehicles are communicated
over the [Vehicle Hardware Abstraction Layer (VHAL)](https://source.android.com/docs/automotive/vhal).
These properties are modeled by the [`VehiclePropertyIds`](https://developer.android.com/reference/android/car/VehiclePropertyIds)
class.

While the emulator is running, you can modify the values of these properties
from the **Car data** feature of the extended controls. For example, to set the
current speed of the vehicle, you can find the property for speed
([`VehiclePropertyIds.PERF_VEHICLE_SPEED`](https://developer.android.com/reference/android/car/VehiclePropertyIds#PERF_VEHICLE_SPEED))
and change its value.
| **Tip:** If your app is built using the Car App Library, it is recommend that you use the [`CarHardwareManager` API](https://developer.android.com/training/cars/apps#car-hardware) to read these values as it provides a uniform interface across Android Auto and Android Automotive OS.

#### Simulate driving

![The](https://developer.android.com/static/images/training/cars/extended-controls-car-sensor-data.png)

To simulate driving, you should set the *Car speed* to a non-zero value and
*Gear* to something other than **P (Park)** . To simulate a parked state, all
that is necessary is to set the *Gear* to **P (Park)** . This can be done either
by using the sliders and selectors under the **Car sensor data** tab or by
modifying the VHAL properties as described in the prior section.
| **Caution:** On system images with the Google Play Store, activities that mark themselves as distraction optimized (such as a [`CarAppActivity`](https://developer.android.com/training/cars/apps/automotive-os#car-app-activity)) are only shown while user experience restrictions are active if the app to which they belong is installed from the Google Play Store. To test distraction optimized activities while developing your app, it is recommended that you use a [system image](https://developer.android.com/training/cars/testing/emulator#generic-images) without the Google Play Store.

### Test rotary input

![The](https://developer.android.com/static/images/training/cars/extended-controls-rotary.png)

In addition to a touchscreen, some Android Automotive OS vehicles come equipped
with a [rotary controller](https://source.android.com/docs/automotive/hmi/rotary_controller),
which relies on the same focus APIs as [keyboard
navigation](https://developer.android.com/develop/ui/views/touch-and-input/keyboard-input/navigation) to let
users navigate your app without touching the screen. You can use the **Car
rotary** tool within the extended controls to test your app's support for rotary
input.

## Edit your run configurations for media apps

Media apps on Automotive OS apps are different than other Android apps. Android
Automotive OS interacts with your media app using explicit intents and by
sending calls to your
[media browser service](https://developer.android.com/training/cars/media#tc-media-browser-service).

To test your app, verify that your app [has no launch
activity](https://developer.android.com/training/cars/media/automotive-os#intent-filters)
in its manifest, and then prevent your automotive module from launching with an
activity by completing the following steps:

1. In Android Studio, select **Run \> Edit Configurations**.

   ![The Run/Debug Configurations dialog box.](https://developer.android.com/static/images/training/cars/run-configurations.png)
2. Select your automotive module from the list of modules in your app.

3. Under **Launch Options \> Launch** , select **Nothing**.

4. Click **Apply** , and then click **OK**.

## Report an Android Automotive OS emulator issue

If you run into an issue or have a feature request while using Android
Automotive OS emulator, you can report it using the Google Issue Tracker. Be
sure to fill out all the requested information in the issue template. Before
filing a new issue, check whether it is already reported in the [issues
list](https://issuetracker.google.com/issues?q=componentid:1635829).
You can subscribe and vote for issues by clicking the star for an issue in the
tracker. For more information, see [Subscribing to an
Issue](https://developers.google.com/issue-tracker/guides/subscribe#starring_an_issue).

[View existing issues](https://issuetracker.google.com/issues?q=componentid:1635829)
[Create a new issue](https://issuetracker.google.com/issues/new?component=1635829)