summaryrefslogtreecommitdiff
path: root/SDL_Core/doc/install.txt
blob: 73587d43221d4716fe94d86313eecdbcb3e2c55a (plain)
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
* Introduction
  ================
  smartDeviceLinkCore is an application which manages the transport, connection and communication between a head unit and mobile device.

* OS and Hardware
  =========
  Ubuntu 12.04.01 LTS 32-bit OS on the PC with USB-dongle
  Application has been tested using 2 types of USB-dongle:
  D-Link DBT-122
  STLab B-121mini

* External components
  ===================
  For build application we need:
  libbluetooth3, the BlueZ library
  libbluetooth-dev, the development files to link to the BluetZ library.
  Install libraries:
  sudo apt-get install libbluetooth3
  sudo apt-get install libbluetooth-dev
  We are using cmake to create build configurations.
  Install cmake:
  sudo apt-get install cmake
  Also, make sure the g++ compiler is installed:
  sudo apt-get install g++
  To start web-based HMI we need web-browser with web-socket RFC6455 support.
  For example Google Chromium. Install it using:
  sudo apt-get install chromium-browser
  Install openssl and development libraries:
  sudo apt-get install openssl libssl-dev

* Build application
  =================
  We support "out of sources" concept for build from R3.0.0
  It means all generated by build tools files will be stored in separate folder.
  
  1. Create directory outside of SmartDeviceLink project directory.
  For example "build" folder in the same folder with SmartDeviceLink git repo folder which has a name "git_repo":
  mkdir build
  You will have folders structure like this:
  /home/projects/smart_device_link
  |--build
  |--git_repo
     |--doc
     |--src
     |--test
     |--DoxyFile
     \--CMakeLists.txt
  Enter this folder:
  cd build
  
  2. Create build configuration using cmake:
  2.1 For Debug configuration
  cmake ../git_repo
  2.2 For Release configuration, run:
  cmake -DCMAKE_BUILD_TYPE=Release ../git_repo
  2.3 For Debug configuration with tests, run:
  cmake -DBUILD_TESTS=On ../git_repo
  
  3. Make project:
  make
  
  Ready to use release application will be in build/src/appMain/smartDeviceLinkCore

  4. If You built configuration with tests (see 2.3 above), then You can run all project tests and see overall result with:
  make test