example_navigation_app_android

This example application is a reference for developers who want to build a SmartDeviceLink navigation app

App Setup

Setting Permissions

If you are using this app with production or test hardware it is very likely that this app will not work due to OEMs restricting permissions for video streaming apps. If this is the case, you will need to set an OEM approved SDL app name and SDL app ID with the correct permissions. Additionally, you will need set a MapBox access token in order to use the map.

To set the MapBox access token, app name, and app ID of this project, please follow the steps below.

Setting App Keys

1. To set your SDL app name, set app_name in app/src/main/res/values/strings.xml

2. To set your SDL app ID, set APP_IDin app/src/main/java/com.livio.mobilenav/AppConstants.kt

3. To set your MapBox access token, set mapbox_access_token in app/src/main/res/values/strings.xml and MAPBOX_DOWNLOADS_TOKEN in gradle.properties

Note that, at minimum, the MapBox access token must be set in order to use the app without SDL.

Setting Connection Type

By default, the app will attempt to connect via a multiplex connection after launch. A multiplex connection allows you to connect to production or test hardware using a USB cord or Bluetooth. If you would like to test with an emulator you will need to configure a TCP (i.e. WiFi) connection. To set connection type, select the matching active build variant in Android Studio.

When using a TCP connection, you will need to set IP_ADDRESS and PORT in app/src/main/java/com.livio.mobilenav/AppConstants.kt

For more information about connection types, please refer to our guide.