======
1. GBS Builds
- 1.1. COMMON Profile
- 1.2. MOBILE Profile
- 1.3. WEARABLE Profile
2. Building for Ubuntu desktop
2.1. Minimum Requirements
2.2. Building the Repository
- 3. Troubleshooting
- 3.1. JPEG Library Linking Errors
-
+ 2.3. Build target options
+ 2.4. Building and executing test cases
+ 3. Building for Emscripten
+ 3.1. Setup dali-env & build dali-core
+ 3.2. Build the minimal dali-adaptor
+ 3.3. Using the Javascript Build
1. GBS Builds
=============
-1.1. COMMON Profile
--------------------
-
gbs build -A [TARGET_ARCH]
-1.2. MOBILE Profile
--------------------
-
- gbs build -A [TARGET_ARCH] --spec dali-adaptor-mobile.spec
-
-1.3. WEARABLE Profile
----------------------
-
- gbs build -A [TARGET_ARCH] --spec dali-adaptor-wearable.spec
-
-
2. Building for Ubuntu desktop
==============================
make install -j8
+2.3. 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.4. Building and executing test cases
+--------------------------------------
+
+See the README.md in dali-adaptor/automated-tests.
+
+
+3. Building for Emscripten
+--------------------------
+
+Currently the build for emscripten uses a minimal adaptor which does not support dali-toolkit.
+
+
+3.1. Setup dali-env & build dali-core
+-------------------------------------
+
+ The build requires the Emscripten SDK, this is installed automatically by running dali_env with the correct parameters.
+ dali_env is part of the dali-core repository.
+ Please see the README within dali-core to setup dali_env and build dali-core.
+
+
+3.2. Build the minimal dali-adaptor
+-----------------------------------
+
+ Use the build.sh script build adaptor.
+ This uses emscriptens emcc to compile byte code to javascript (full OpenGL ES support with stb-image loading library and cpp bindings).
+ Note: Please view the build.sh script for debug build options.
+
+ # cd ./build/emscripten
+ # ./build.sh
+
+
+3.3. Using the Javascript Build
+-------------------------------
-3. Troubleshooting
-==================
+ The build will create 1 main Javascript artifact, and its html counterpart; dali-emscripten.js
-3.1. JPEG Library Linking Errors
---------------------------------
+ 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.
-If you have linking problems with libjpeg, then you may have to create a symbolic link to the library:
+ After the build, the necessary artifacts (which include dali-wrapper.js) will be placed in the dali-env directory under opt/share/emscripten:
- - Navigate to where the library is (for example /usr/lib/x86_64-linux-gnu).
- - Create a symbolic link:
- sudo ln -s libjpeg.so.8 libjpeg.so
- sudo chmod 777 libjpeg.so
- (Change the version number of your libjpeg library accordingly)
+ dali-env/opt/share/emscripten
+ If dali-demo is built, any JS examples will also be placed in this directory, so they are ready to run.