README: add README to how to build up and execute Weston and examples upstream/0.0.1
authorNobuhiko Tanibata <NOBUHIKO_TANIBATA@denso.co.jp>
Wed, 27 Nov 2013 11:44:32 +0000 (20:44 +0900)
committerTimo Lotterbach <timo.lotterbach@bmw-carit.de>
Wed, 27 Nov 2013 19:59:36 +0000 (20:59 +0100)
Signed-off-by: Nobuhiko Tanibata <NOBUHIKO_TANIBATA@denso.co.jp>
README [new file with mode: 0644]

diff --git a/README b/README
new file mode 100644 (file)
index 0000000..0f4b495
--- /dev/null
+++ b/README
@@ -0,0 +1,54 @@
+Sections in this file describe:
+- How to build 
+- Example applications
+
+How to build on different platforms
+====================================
+
+Pre-requisite: 
+- Weston works with any shell downloaded from the following URL
+  http://cgit.freedesktop.org/wayland/weston/
+- CMake required (version 2.6 or higher)
+
+Build up
+1. Pull the current codebase form the git repo
+   E.g. git clone http://git.projects.genivi.org/wayland-ivi-extension.git
+
+2. Create a build directory
+   E.g mkdir build_ivi_extension
+
+3. In <build-dir> Generate build system for your platform using CMake.
+   E.g. cd <build-dir>
+        cmake -DCMAKE_TOOLCHAIN_FILE=<your setting *.cmake> ../
+
+   Example of *.cmake
+
+add_definitions ("-g -O3")
+set (CMAKE_FIND_ROOT_PATH <your root path>)
+set (CMAKE_INSTALL_PREFIX <your installation path>)
+set (FFI_INCLUDE_DIR /usr/lib/libffi-3.0.10/include)
+set (XKB_INCLUDE_DIR <your installation path>/include/xkbcommon)
+set (CAIRO_INCLUDE_DIR <your installation path>/include/cairo)
+
+4. Start the build and install
+   
+   E.g. sudo make install
+
+Example applications
+====================================
+  
+Pre-requisite:
+- Modify weston.ini to use ivi-shell.so
+  Example:
+    shell=ivi-shell.so
+- Set Environmental values
+  Example:
+    export XDG_RUNTIME_DIR=/var/run/<your user name>/1000
+    export LD_LIBRARY_PATH=<your installation path>/lib 
+
+Start-up Weston:
+   Example: <your installation path>/bin/weston
+
+EGLWLMockNavigation:
+   Example: <your installation path>/bin/EGLWLMockNavigation
+