Expand Minimize Picture-in-picture Power Device Status Voice Recognition Skip Back Skip Forward Minus Plus Play Search
Documentation
Sidebar

SDK Configuration

1. Get an App Id

An app id is required for production level apps. The app id gives your app special permissions to access vehicle data. If your app does not need to access vehicle data, a dummy app id (i.e. creating a fake id like "1234") is sufficient during the development stage. However, you must get an app id before releasing the app to the public.

To obtain an app id, sign up at smartdevicelink.com.

2. Add Required System Permissions

Some permissions are required to be granted to the sdl app in order for it to work properly. In the AndroidManifest file, we need to ensure we have the following system permissions:

  • Internet - Used by the mobile library to communicate with a SDL Server
  • Bluetooth - Primary transport for SDL communication between the device and the vehicle's head-unit
  • Access Network State - Required to check if WiFi is enabled on the device
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.company.mySdlApplication">

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.BLUETOOTH"/>
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

</manifest>
Note

If the app is targeting Android P (API Level 28) or higher, the Android Manifest file should also have the following permission to allow the app to start a foreground service:

<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
View on GitHub.com
Previous Section Next Section