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