doc: more documentation
[src/app-framework-main.git] / doc / widgets.md
1
2 The widgets
3 ===========
4
5     version: 1
6     Date:    15 March 2016
7     Author:  José Bollo
8
9 The widgets
10 -----------
11
12 The widgets are described by the technical recommendations
13 [widgets] and [widgets-digsig].
14
15 ### signature of the 
16
17 The application framework 
18
19 This is the original part of our work here
20
21 ### directory where are stored applications
22
23 Applications can be installed in few places: on the system itself or on an extension device.
24 For my phone, for example, it is the sd card.
25
26 This translates to:
27
28  - /usr/applications: for system wide applications
29  - /opt/applications: for removable applications
30
31 In the remaining of the document, these places are writen "APPDIR".
32
33
34 Organisation of directory of applications
35 =========================================
36
37 The main path for applivcations are: APPDIR/PKGID/VER.
38
39 Where:
40
41  - APPDIR is as defined above
42  - PKGID is a directory whose name is the package identifier
43  - VER is the version of the package MAJOR.MINOR
44
45 This organisation has the advantage to allow several versions to leave together.
46 This is needed for some good reasons (rolling back) and also for less good reasons (user habits).
47
48 Identity of installed files
49 ---------------------------
50
51 All the files are installed as the user "userapp" and group "userapp".
52 All files have rw(x) for user and r-(x) for group and others.
53
54 This allows any user to read the files.
55
56
57 Labelling the directories of applications
58 -----------------------------------------
59
60
61 Organisation of data
62 ====================
63
64 The data of a user are in its directory and are labelled using the labels of the application
65
66
67
68
69 [meta-intel]:       https://github.com/01org/meta-intel-iot-security                "A collection of layers providing security technologies"
70 [widgets]:          http://www.w3.org/TR/widgets                                    "Packaged Web Apps"
71 [widgets-digsig]:   http://www.w3.org/TR/widgets-digsig                             "XML Digital Signatures for Widgets"
72 [libxml2]:          http://xmlsoft.org/html/index.html                              "libxml2"
73 [openssl]:          https://www.openssl.org                                         "OpenSSL"
74 [xmlsec]:           https://www.aleksey.com/xmlsec                                  "XMLSec"
75 [json-c]:           https://github.com/json-c/json-c                                "JSON-c"
76 [d-bus]:            http://www.freedesktop.org/wiki/Software/dbus                   "D-Bus"
77 [libzip]:           http://www.nih.at/libzip                                        "libzip"
78 [cmake]:            https://cmake.org                                               "CMake"
79 [security-manager]: https://wiki.tizen.org/wiki/Security/Tizen_3.X_Security_Manager "Security-Manager"
80 [app-manifest]:     http://www.w3.org/TR/appmanifest                                "Web App Manifest"
81 [tizen-security]:   https://wiki.tizen.org/wiki/Security                            "Tizen security home page"
82 [tizen-secu-3]:     https://wiki.tizen.org/wiki/Security/Tizen_3.X_Overview         "Tizen 3 security overview"
83
84
85
86