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