T.O.C.
======

 1.   GBS Builds
 1.1. NON-SMACK Targets
 1.2. SMACK enabled Targets
 1.3. DEBUG Builds
 2.   Building for Ubuntu desktop
 2.1. Minimum Requirements
 2.2. Creating a DALi Environment
 2.3. Building the Repository
 2.4. Build target options
 2.5. Building and executing test cases
 3.   Building DALi as Javascript using Emscripten
 3.1. Creating a DALi Environment for Emscripten Javascript builds
 3.2. Building the repository as Javascript using Emscripten

1. GBS Builds
=============

1.1. NON-SMACK Targets
----------------------

 gbs build -A [TARGET_ARCH]

1.2. SMACK enabled Targets
--------------------------

 gbs build -A [TARGET_ARCH] --define "%enable_dali_smack_rules 1"

1.3. DEBUG Builds
-----------------

 gbs build -A [TARGET_ARCH] --define "%enable_debug 1"


2. Building for Ubuntu desktop
==============================

2.1. Minimum Requirements
------------------------

 - Ubuntu 14.04

2.2. Creating a DALi Environment
-------------------------------

To build for desktop first ensure ALL sources are selected:
 - Go to Ubuntu Settings and then to "Software & Updates"
 - In the "Ubuntu Software" tab, ensure ALL software sources are ticked
   (This is required because we install some community-maintained free & open-source software)

Then you can create a dali-env folder in your home folder with:

 dali-core/build/scripts/dali_env -c

This will also download any dependencies that the dali repositories require.

You can save the environment variables to a file:

 dali-env/opt/bin/dali_env -s > setenv

This process only needs to be done once.

Next source these variables:

 . setenv

You will have to source these variables every time you open up a new terminal (or you can add to .bashrc if you prefer).


2.3. Building the Repository
----------------------------

To build the repository enter the 'build/tizen' folder:

 cd dali-core/build/tizen

Then run the following commands:

 autoreconf --install
 ./configure --prefix=$DESKTOP_PREFIX
 make install -j8


2.4. Build target options
-------------------------

OpenGL ES context:

When building, the OpenGL ES version of the target should be specified.

Valid version options are 20, 30, 31

With configure:
Add: --enable-gles=X

With gbs:
Add to the gbs build line: --define "%target_gles_version X"


2.5. Building and executing test cases
--------------------------------------

See the README.md in dali-core/automated-tests.


3. Building DALi as Javascript using Emscripten
-----------------------------------------------


3.1. Environment for Emscripten Javascript builds
--------------------------------------------------

To build the Javascript version of DALi, the Emscripten SDK is required.
Installation of this is built in to the main dali_env script.

First create a directory for the environment:

# mkdir -p ~/dali-env-emscripten

Now run the dali_env script. This will download and build the Emscripten SDK, which may take several minutes.
The script may ask for your password as it will need to install any package prerequisites.
Note the "-e" option for Emscripten.

# cd ~/dali-env-emscripten
# PATH-TO-DALI-CORE/build/scripts/dali_env -c -e

Create the setenv script. A new section for Emscripten will be created at the top.

# ./dali-env/opt/bin/dali_env -s > setenv

Run the setenv script to setup environment variables.

# . ./setenv

Warning: As of 19/01/2015 with a userID > 6 digits there was a bug in llvm that caused
the build to fail. So I've used the incoming branches of the emscripten sdk and not latest.


3.2. Building the repository as Javascript using Emscripten
-----------------------------------------------------------

Clean the build first:

# cd ./dali-core/build/tizen
# git clean -dxf
# autoreconf --install

Use llvm's drop in replacements for configure & make:

# emconfigure ./configure --verbose --prefix=$DESKTOP_PREFIX --enable-emscripten=yes --enable-debug=yes --enable-profile=UBUNTU --enable-gles=20
# emmake make install -j8