Developer

Run the Application on an Emulator

Last edit: 2023.09.25

The TomTom Digital Cockpit SDK is not available for general use.
Please contact us for more information.

If you are using Nexus, please see the Artifactory migration instructions.

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

Download the template application APK

If you have not been granted access yet, please follow these instructions.

Download the template app APK depending on your CPU architecture (use your company's email address and password):

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 site

If you haven't created an Artifactory identity token yet, please follow these instructions.

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:

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 12L (Sv2).
x86_64 CPU architecture
  • Check the box next to the TomTom Digital Cockpit System Image: TomTom Digital Cockpit Intel x86 Atom_64 System Image.
  • Apply your changes. The emulator image will now be downloaded.
ARM64 CPU architecture
  • Check the box next to the TomTom Digital Cockpit System Image: TomTom Digital Cockpit ARM 64 v8a 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:

Creating a new emulator

  • Navigate to Tools > Device Manager.
  • Navigate to the Virtual tab.
  • Click Create device.

Selecting the system image

  • Navigate to the Automotive category.
  • Select TomTom_Digital_Cockpit_Test_Device.
  • Click Next.
  • Navigate to the Recommended tab and select the Sv2 System Image you downloaded earlier.
  • Click Next.

Configuring the emulator

  • 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

  • Drag the APK file you downloaded earlier 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 Install a Map for installing a map and enabling navigation in the template application.

Have a look at the tutorials to explore what the Digital Cockpit SDK example code has to offer.