Skip to main content

Installing and Running Pleos Connect Emulator

Development Environment Requirements​

The software development environment required to use the Pleos Connect SDK is as follows.

SpecificationVersion
Minimum Android SDKAndroid API level 28 or higher
Gradle version8.0 or higher
Development languageJava, Kotlin
Pleos Connect EmulatorVersion 2.1.0
Pleos Connect Virtual ConsoleMinimum Pleos Connect Emulator version that supports Pleos Connect Virtual Console: 2.1.0
caution

The minSDK version must be Android API 28 or higher. This is required to meet vehicle cybersecurity requirements, including signing key rotation and lineage support.

Pleos Connect Emulator​

Pleos Connect Emulator is a virtual environment for developing and validating Pleos Connect apps using Android development tools such as Android Studio. It allows you to test Android APIs and Pleos Connect APIs together and verify app behavior by emulating vehicle control functions and vehicle context data.

Installing the Pleos Connect Emulator​

Prerequisite​

  1. Install the latest version of Android Studio.
  2. You can download Android Studio here.
  3. Check that your system meets the system requirements for running the Android Emulator.

Adding the Emulator to Android Studio​

info

If a previous version of Pleos Connect Emulator is installed, remove the existing version before proceeding with the installation steps below.

  1. In Android Studio, select Menu > Tools > SDK Manager.
  2. Click the SDK Update Sites tab.
  3. Click the + button at the top left of the list.

  1. Enter the following information to add the Pleos Connect SDK site.

    • Name: Pleos Connect System Image
    • URL for Mac: https://nexus-playground.pleos.ai/repository/raw-releases/connect-avd/2.x/crp-arm64-sys-img.xml
    • URL for Windows/Linux: https://nexus-playground.pleos.ai/repository/raw-releases/connect-avd/2.x/crp-sys-img.xml

  1. Click the OK button.

  2. Click the SDK Platforms tab.

  3. Select the Pleos Connect system image for Android API level 34.

  4. Enable the Show Package Details checkbox at the bottom.

  5. Click the OK button to proceed with the Pleos Connect Emulator image installation as shown below.

  6. Once the installation is complete, press the Finish button and restart Android Studio.

Setting up the emulator​

  1. Start Android Studio. If you did not restart it in the previous step, restart it first.

  2. Create an Android Virtual Device (AVD) using the Pleos Connect Emulator.

  3. In Android Studio, select Menu > Tools > Device Manager. In earlier versions of Android Studio, select Menu > Tools > AVD Manager.

  4. Click Create device. In earlier versions of Android Studio, click Create Virtual Device.

  5. Select Automotive under Form Factor on the left.

  6. Select Pleos Connect v2.1.0 and click the Next button.

  7. In the Configure virtual device window, select the Advanced Settings tab. In earlier versions of Android Studio, click the Show Advanced Settings button.

  8. Under Startup > Default boot, select Cold. In earlier versions of Android Studio, set Graphics to Hardware under Emulated Performance, and select Cold boot under Boot option.

  9. Under Emulated Performance, set RAM size to 4 GB.

  10. Return to the Device tab. Under Select system image > API, select API 34, select Pleos Connect v2.1.0 APIs from the table at the bottom, and click Finish.

Running on the emulator​

  • In Android Studio, run the AVD you created from Menu > Tools > Device Manager.
note

For emulator runtime environment settings, refer to Configuring Pleos Connect Emulator.

Troubleshooting​

The Android Emulator has several known issues. Refer to the link below for troubleshooting: Troubleshooting Known Issues with Android Emulator

Android Studio and the Gradle plugin also have several known issues. Refer to the link below for details: Known Issues in Android Studio and Android Gradle Plugin