Change keyboard focus setting on visible/invisible events
[staging/xdg-launcher.git] / README.txt
1 How to build with SDK
2
3 1. make build directory
4    $ mkdir build
5
6 2. do cmake
7    $ cd build
8    $ cmake ..
9
10    You could find binary executable "runxdg" is built.
11    "runxdg" should be installed into the directory
12    on the target. (e.g. /usr/bin or /usr/local/bin)
13
14 3. Prepare configuration for RunXDG, 'runxdg.toml'
15    See 'package/{runxdg|navi|hvac}/runxdg.toml for detail.
16
17    'role', 'method', 'path' is mondatory.
18
19    Only "POSIX" as 'method' works, others not tested so far.
20
21    'role' should be the same which defined in layers.json of WindowManager.
22
23    e.g. followings are predefined role by default
24    "role": "MediaPlayer|Radio|Phone|Navigation|HVAC|Settings|Dashboard|POI|Mixer"
25
26    In order to pass port number and token which are given from
27    AGL application framework binder to XDG application,
28    you can use special string '@port@' and '@token@'.
29
30    For 'params', you can use special string '@port@' and '@token@"
31    to pass them to target XDG application
32    which are from AGL application framework binder.
33
34    e.g. params = [ --port=@port@ --secret=@token@ ]
35
36 3. Prepare config.xml for widget
37
38    <content> should be follow.
39      <content src="bin/runxdg" type="application/vnd.agl.native"/>
40
41    following <feature> is mandatory.
42      <feature name="urn:AGL:widget:required-api">
43        <param name="homescreen" value="ws" />
44        <param name="windowmanager" value="ws" />
45      </feature>
46
47 4. Make widgets
48    $ make widget
49
50    The following wgt would be made.
51    - runxdg.wgt     XDG Launcher
52    - navi.wgt       for test, XDG Launcher installed as Navigation
53    - hvac.wgt       for test, XDG Lanncher installed as HVAC
54