WIP: documenting
[src/app-framework-main.git] / docs / 2-widgets.md
1 # The widgets
2
3 Applications are packaged and delivered in a digitally signed container
4 named *widget*. A widget contains:
5
6 - the application and its data
7 - a configuration file *config.xml*
8 - signature files
9
10 The format of widgets is described by W3C (World Wide Web Consortium)
11 technical recommendations:
12
13 - [Packaged Web Apps (Widgets)](http://www.w3.org/TR/widgets)
14   (note: now deprecated)
15
16 - [XML Digital Signatures for Widgets](http://www.w3.org/TR/widgets-digsig)
17
18 Note that the technical recommendation
19 [Packaged Web Apps (Widgets)](http://www.w3.org/TR/widgets)
20 is now obsolete (since 11 october 2018).
21 It implies that a new format of widgets can be proposed in replacement.
22
23
24 The format is enough flexible to include the description of permissions
25 and dependencies required or provided by the application.
26
27 Signature make possible to allow or deny permissions required by the
28 application based on certificates of signers.
29
30 A chain of trust in the creation of certificates allows a hierarchical
31 structuring of permissions.
32
33 It also adds the description of dependency to other service because AGL
34 programming model emphasis micro-services architecture design.
35