README

   1 T.O.C.
   2 ======
   3
   4  1.   GBS Builds
   5  2.   Building for Ubuntu desktop
   6  2.1. Minimum Requirements
   7  2.2. Building the Repository
   8  2.3. Build target options
   9  2.4. Building and executing test cases
  10  3.   Building for Emscripten
  11  3.1. Setup dali-env & build dali-core
  12  3.2. Build the minimal dali-adaptor
  13  3.3. Using the Javascript Build
  14
  15
  16 1. GBS Builds
  17 =============
  18
  19  gbs build -A [TARGET_ARCH]
  20
  21
  22 2. Building for Ubuntu desktop
  23 ==============================
  24
  25 2.1. Minimum Requirements
  26 ------------------------
  27
  28  - Ubuntu 14.04
  29  - Environment created using dali_env script in dali-core repository
  30
  31 2.2. Building the Repository
  32 ----------------------------
  33
  34 To build the repository enter the 'build/tizen' folder:
  35
  36  cd dali-adaptor/build/tizen
  37
  38 Then run the following commands:
  39
  40  autoreconf --install
  41  ./configure --prefix=$DESKTOP_PREFIX --enable-profile=UBUNTU --enable-gles=20
  42  make install -j8
  43
  44
  45 2.3. Build target options
  46 -------------------------
  47
  48 OpenGL ES context:
  49
  50 When building, the OpenGL ES version of the target should be specified.
  51
  52 Valid version options are 20, 30, 31
  53
  54 With configure:
  55 Add: --enable-gles=X
  56
  57 With gbs:
  58 Add to the gbs build line: --define "%target_gles_version X"
  59
  60 2.4. Building and executing test cases
  61 --------------------------------------
  62
  63 See the README.md in dali-adaptor/automated-tests.
  64
  65
  66 3. Building for Emscripten
  67 --------------------------
  68
  69 Currently the build for emscripten uses a minimal adaptor which does not support dali-toolkit.
  70
  71
  72 3.1. Setup dali-env & build dali-core
  73 -------------------------------------
  74
  75  The build requires the Emscripten SDK, this is installed automatically by running dali_env with the correct parameters.
  76  dali_env is part of the dali-core repository.
  77  Please see the README within dali-core to setup dali_env and build dali-core.
  78
  79
  80 3.2. Build the minimal dali-adaptor
  81 -----------------------------------
  82
  83   Use the build.sh script build adaptor.
  84   This uses emscriptens emcc to compile byte code to javascript (full OpenGL ES support with stb-image loading library and cpp bindings).
  85   Note: Please view the build.sh script for debug build options.
  86
  87   # cd ./build/emscripten
  88   # ./build.sh
  89
  90
  91 3.3. Using the Javascript Build
  92 -------------------------------
  93
  94  The build will create 1 main Javascript artifact, and its html counterpart; dali-emscripten.js
  95
  96  This is required by any dali JS app, and must be located in the same directory as the app JS in order for the browser to find it.
  97
  98  After the build, the necessary artifacts (which include dali-wrapper.js) will be placed in the dali-env directory under opt/share/emscripten:
  99
 100  dali-env/opt/share/emscripten
 101
 102  If dali-demo is built, any JS examples will also be placed in this directory, so they are ready to run.