X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=README;h=c3459d90f83c9c0dceb7b573b2cf844d294a0411;hb=62bcc3d2209b56af10895850cc3fb669de7cfa0d;hp=ff0f98943a201bebad3d424081aef7fd27695c52;hpb=0e48ec1361b14cd627a1ef2602c465bb06389c29;p=platform%2Fcore%2Fuifw%2Fdali-core.git diff --git a/README b/README index ff0f989..c3459d9 100644 --- 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 @@ -44,7 +52,7 @@ To build for desktop first ensure ALL sources are selected: Then you can create a dali-env folder in your home folder with: - dali-core/build/dali_env -c + dali-core/build/scripts/dali_env -c This will also download any dependencies that the dali repositories require. @@ -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 + +