Run the Application on an Emulator

Last edit: 2023.02.23

The Digital Cockpit emulator is only available on x86 architectures.
Support for ARM architectures (like for example Apple M-type processors) will be added soon.

Follow the instructions on this page to run the template Digital Cockpit application on the Digital Cockpit emulator.


Install Android Studio

The minimum required version of Android Studio is Electric Eel | 2022.1.1.

Download Android Studio and follow the installation instructions.


Configure the emulator image

The Digital Cockpit emulator image needs to be made available, configured, and downloaded in Android Studio.

Configure devices.xml

This step makes the emulator device configuration available in Android Studio.

Linux and Mac

Download the devices.xml file and move it to ~/.android/devices.xml.
(Right-click on the link and select Save link as...)

Restart Android Studio for the changes to take effect.

Windows

Download the devices.xml file and move it to %USERPROFILE%.android\devices.xml.
(Right-click on the link and select Save link as...)

Restart Android Studio for the changes to take effect.

Configure the SDK update sites

This step configures the sources for the Digital Cockpit emulator in Android Studio.

  • Navigate to Tools > SDK Manager.
  • Navigate to the SDK Update Sites tab.

Add the emulator image update site:

Add the artifact repository update site:

  • Add a new update site (press the "+" icon).
  • Enter Name: TomTom Digital Cockpit - Artifact Repository
  • Enter URL: https://repo.tomtom.com/
  • Check the box next to Use Authentication.
  • Add the credentials you have received.
  • Click OK.

Click Apply to activate these update sites.

Unfortunately, the TomTom Digital Cockpit - Artifact Repository entry will always show an error, but you can ignore this.

Download the emulator image

The emulator image is downloaded using the SDK Manager in Android Studio:

  • Navigate to Tools > SDK Manager.
  • Navigate to the SDK Platforms tab.
  • Check the box next to Show Package Details.
  • Find Android 11.0 (R).
  • Check the box next to TomTom Digital Cockpit System Image.
  • Apply your changes.

The emulator image will now be downloaded.


Create the emulator device

You will now create an Android Virtual Device (AVD) with the emulator image that you have downloaded in Android Studio:

  • Navigate to Tools > Device Manager.
  • Navigate to the Virtual tab.
  • Click Create device.
  • Navigate to the Automotive category.
  • Select TomTom_Digital_Cockpit_Test_Device.
  • Click Next.
  • Navigate to the x86 Images tab.
  • Select the TomTom Digital Cockpit System Image you downloaded earlier.
  • Click Next.
  • Click Show Advanced Settings.
  • Scroll to the Memory and Storage section.
  • Enter RAM: 4096 MB.
  • Enter VM heap: 256 MB.
  • Enter Internal Storage: 5120 MB.
  • Click Finish.

You can now find the Digital Cockpit emulator device in the Device Manager.


Run the emulator device

You will now configure the emulator device while it is running.

Launch the emulator in a window

  • Navigate to Tools > Device Manager.
  • Find the TomTom_Digital_Cockpit_Test_Device.
  • Click the icon under Actions.
  • In the Emulator window, click Show Options Menu (the gear icon).
  • Click View Mode > Window.

Enable Wi-Fi on the emulator

  • Click the Home button (a solid grey circle) in the top bar of the emulator screen.
  • Click the Applications icon (nine dots in a grid) on the bottom of the screen.
  • Scroll down and click Settings.
  • Select Network & internet.
  • Enable Wi-Fi by clicking the toggle button so it turns blue.

You now have a working Digital Cockpit emulator.


Run the application on the emulator

  • Download the template application with the credentials you have received.
  • Once the APK file is available, drag the APK file into the emulator window.

The application now installs on the emulator device. Click the IVI Template App icon to launch the application.

When the IVI Template App starts, you must allow some permissions and select it as the default phone app. You now see the TomTom Digital Cockpit home screen.

A map is not included in the template application. See Advanced SDK Features for enabling navigation functionality in the template application.