1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
|
[](https://travis-ci.org/smartdevicelink/sdl_android)
[](https://codecov.io/gh/smartdevicelink/sdl_android)
[](http://slack.smartdevicelink.com)
[  ](https://bintray.com/smartdevicelink/sdl_android/sdl_android/_latestVersion)
# SmartDeviceLink (SDL)
SmartDeviceLink (SDL) is a standard set of protocols and messages that connect applications on a smartphone to a vehicle head unit. This messaging enables a consumer to interact with their application using common in-vehicle interfaces such as a touch screen display, embedded voice recognition, steering wheel controls and various vehicle knobs and buttons. There are three main components that make up the SDL ecosystem.
* The [Core](https://github.com/smartdevicelink/sdl_core) component is the software which Vehicle Manufacturers (OEMs) implement in their vehicle head units. Integrating this component into their head unit and HMI based on a set of guidelines and templates enables access to various smartphone applications.
* The optional [SDL Server](https://github.com/smartdevicelink/sdl_server) can be used by Vehicle OEMs to update application policies and gather usage information for connected applications.
* The [iOS](https://github.com/smartdevicelink/sdl_ios) and [Android](https://github.com/smartdevicelink/sdl_android) libraries are implemented by app developers into their applications to enable command and control via the connected head unit.
* The [Embedded]() and [Cloud]() libraries, written in Java, are implemented by app developers into their applications to enable command and control of a connected head unit.
Pull Requests Welcome!
To understand if a contribution should be entered as an Android Pull Request (or issue), or an SDL Evolution Proposal, please reference [this document](https://github.com/smartdevicelink/sdl_evolution/blob/master/proposals_versus_issues.md).
<a href="http://www.youtube.com/watch?feature=player_embedded&v=AzdQdSCS24M" target="_blank"><img src="http://i.imgur.com/nm8UujD.png?1" alt="SmartDeviceLink" border="10" /></a>
## Mobile Proxy
The mobile library component of SDL is meant to run on the end user’s smart-device from within SDL enabled apps. The library allows the apps to connect to SDL enabled head-units and hardware through bluetooth, USB, and TCP. Once the library establishes a connection between the smart device and head-unit through the preferred method of transport, the two components are able to communicate using the SDL defined protocol. The app integrating this library project is then able to expose its functionality to the head-unit through text, media, and other interactive elements.
## SmartDeviceLink Android
We're still working on creating documentation for each of these individual repositories, but in the meantime, you can find more information about SmartDeviceLink [here](https://smartdevicelink.com)
You can also find some branches that have yet to be merged into this GitHub project on the GENIVI page [here](http://git.projects.genivi.org/?p=smartdevicelink_android.git;a=summary).
### Installation
#### Dependency Managers
To compile with the latest release of SDL Android, include the following in your app's `build.gradle` file,
```sh
repositories {
jcenter()
}
dependencies {
implementation 'com.smartdevicelink:sdl_android:4.+'
}
```
For Maven or Ivy snippets please look at [Bintray](https://bintray.com/smartdevicelink/sdl_android/sdl_android)
#### Manually
If you prefer not to use any of the aforementioned dependency managers, you can integrate SDL Android into your project manually.
### Proguard Rules
Developers using Proguard to shrink and obfuscate their code should be sure to include the following lines in their proguard-rules.pro file:
```sh
-keep class com.smartdevicelink.** { *; }
-keep class com.livio.** { *; }
# Video streaming apps must add the following line
-keep class ** extends com.smartdevicelink.streaming.video.SdlRemoteDisplay { *; }
```
## SmartDeviceLink Java
### JavaSE
The JavaSE project is meant to allow SDL compatibility for embedded applications.
#### Dependency Managers
To compile with the latest release of SDL JavaSE, include the following in your app's `build.gradle` file,
```sh
repositories {
jcenter()
}
dependencies {
implementation 'com.smartdevicelink:sdl_java_se:4.+'
}
```
### JavaEE
The JavaEE project is meant to allow SDL compatibility for web applications.
#### Dependency Managers
To compile with the latest release of SDL JavaEE, include the following in your app's `build.gradle` file,
```sh
repositories {
jcenter()
}
dependencies {
implementation 'com.smartdevicelink:sdl_java_ee:4.+'
}
```
#### Manually building a JAR
If you prefer making a JAR, simply call:
```sh
gradle build
```
from within the project (JavaSE or JavaEE) and a JAR should be generated in the `build/libs` folder
|
