DALi Version 1.2.0

[platform/core/uifw/dali-core.git] / README

diff --git a/README b/README
index 2062d71..c3459d9 100644 (file)
--- a/README
+++ b/README
@@ -4,12 +4,16 @@ 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
 =============
@@ -24,6 +28,10 @@ T.O.C.
 
  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
@@ -50,7 +58,7 @@ This will also download any dependencies that the dali repositories require.
 
 You can save the environment variables to a file:
 
- dali-env/opt/bin/scripts/dali_env -s > setenv
+ dali-env/opt/bin/dali_env -s > setenv
 
 This process only needs to be done once.
 
@@ -60,6 +68,7 @@ Next source these variables:
 
 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
 ----------------------------
 
@@ -73,3 +82,74 @@ Then run the following commands:
  ./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
+
+