Merge "Upgraded test harness" into devel/master
[platform/core/uifw/dali-core.git] / README
1 T.O.C.
2 ======
3
4  1.   GBS Builds
5  1.1. NON-SMACK Targets
6  1.2. SMACK enabled Targets
7  2.   Building for Ubuntu desktop
8  2.1. Minimum Requirements
9  2.2. Creating a DALi Environment
10  2.3. Building the Repository
11  2.4. Build target options
12  2.5. Building and executing test cases
13
14
15
16 1. GBS Builds
17 =============
18
19 1.1. NON-SMACK Targets
20 ----------------------
21
22  gbs build -A [TARGET_ARCH]
23
24 1.2. SMACK enabled Targets
25 --------------------------
26
27  gbs build -A [TARGET_ARCH] --define "%enable_dali_smack_rules 1"
28
29
30
31 2. Building for Ubuntu desktop
32 ==============================
33
34 2.1. Minimum Requirements
35 ------------------------
36
37  - Ubuntu 14.04
38
39 2.2. Creating a DALi Environment
40 -------------------------------
41
42 To build for desktop first ensure ALL sources are selected:
43  - Go to Ubuntu Settings and then to "Software & Updates"
44  - In the "Ubuntu Software" tab, ensure ALL software sources are ticked
45    (This is required because we install some community-maintained free & open-source software)
46
47 Then you can create a dali-env folder in your home folder with:
48
49  dali-core/build/scripts/dali_env -c
50
51 This will also download any dependencies that the dali repositories require.
52
53 You can save the environment variables to a file:
54
55  dali-env/opt/bin/dali_env -s > setenv
56
57 This process only needs to be done once.
58
59 Next source these variables:
60
61  . setenv
62
63 You will have to source these variables every time you open up a new terminal (or you can add to .bashrc if you prefer).
64
65 2.3. Building the Repository
66 ----------------------------
67
68 To build the repository enter the 'build/tizen' folder:
69
70  cd dali-core/build/tizen
71
72 Then run the following commands:
73
74  autoreconf --install
75  ./configure --prefix=$DESKTOP_PREFIX
76  make install -j8
77
78 2.4. Build target options
79 -------------------------
80
81 OpenGL ES context:
82
83 When building, the OpenGL ES version of the target should be specified.
84
85 Valid version options are 20, 30, 31
86
87 With configure:
88 Add: --enable-gles=X
89
90 With gbs:
91 Add to the gbs build line: --define "%target_gles_version X"
92
93
94 2.5. Building and executing test cases
95 --------------------------------------
96
97 See the README.md in dali-core/automated-tests.
98