Sideloading your application

Minimum version

Make sure you use the Evam SDK version 2.2.0 or above to use this feature.

Android platform tools

The Android platform tools need to be installed on your computer.


Choose the right Development setup!

Sideloading should be done when your application has been developed and is fully working in the development environment.

Sideloading an app in the Evam platform offers little debugging access or error messages, which is beneficial when an app still undergoes development.

If your app is still being actively developed, consider using the in-browser development environment to ensure a smooth developer experience.

See Development environment for more information about the available development environments.

Once developed, you may wish to run your application in an Evam device to showcase it running within the Evam platform.

To achieve this, you will need access to an Evam device. Get in touch with your Evam representative for this.

Step 1 - Review your Evam manifest

Under public/evam.json, make sure to setup your Evam manifest with all required fields. This is required for the platform to load the application correctly.

See Using the Evam SDK for the Evam manifest format.

Step 2 - Build a release version of your application

You should build your application:

npm run build

This will create a build/ directory with the release application files.

Step 3 - Connect your Evam device to your computer

Start by physically connecting your Evam device to your computer, your OS should notify you upon successful connection.

Then, make sure developer options and USB debugging are enabled in the Evam device. Refer to the Android Developer documentation to achieve this. Make sure you also grant access to your computer by accepting the popup in the Evam device.

Step 4 - Install your app by sideloading

You can now sideload your application:

npm exec evam-sideload

This command will install all required files to run your application within the Evam platform. Pay attention to its output to know if there is any issue.

A successful install should output something similar to this:

Installing to <SERIAL>...
Created directory
Created directory
Started installation
Pushing /asset-manifest.json
Pushing /evam.json
Pushing /favicon.ico
Pushing /index.html
Pushing /logo.png
Pushing /manifest.json
Pushing /robots.txt
Pushing /static
Pushing /static/css
Pushing /static/css/main.87781695.css
Pushing /static/css/
Pushing /static/js
Pushing /static/js/787.cfcfd7eb.chunk.js
Pushing /static/js/
Pushing /static/js/main.1431c619.js
Pushing /static/js/main.1431c619.js.LICENSE.txt
Pushing /static/js/

Step 5 - Run the application

You may now start Vehicle Services on your Evam device.

Your application will show in the GUI shell with your logo and name. Clicking its icon will open it.

The application will remain installed, so you do not need to install it again.

If you need to update the installed application, you should re-run this flow from step 3. Keep in mind you will need to restart Vehicle Services for the changes to apply.

At the moment, only one application can be sideloaded at a time, so sideloading a new application replaces the previous one.

Step 6 - Debugging

There is no proper debugging support when an app is sideloaded at the moment, but you can still access the logs your application is outputting during its runtime.

If your application is using console.log to print debug information, you may see them by accessing the Evam device’s logcat:

console.log("Hello world!")

results in:

$ adb logcat
02-27 17:38:13.597 27534 27534 D [LOG] Hello world! -- From line 417 at /assets/index-CrvJ8TfU.js