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.
282930323334x86ARMGoogle Play StoreCompatibility modeAudio while drivingAndroid Studio stableAndroid Studio previewClear 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 images. Follow the steps on OEM developer sites, in alphabetical order:

1. [Ampere (Renault, Alpine)](https://developer.ampere.cars)
2. [General Motors (Chevrolet, Cadillac, GMC, Buick)](https://developer.gm.com/in-vehicle-apps)
3. [Honda](https://global.honda/cars-apps/index.html)
4. [Polestar](https://www.polestar.com/global/developer#emulator)
5. [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)