1 ;---------------------------------------------------------------------------------
8 ; Configure how installation of widget produces unit files for systemd
10 ; Processing and format:
14 ; Lines beginning with ; are firstly removed
16 ; 2. File instantiation
18 ; Mustache (extended) substitutions are applied using JSON
19 ; data deduced from config.xml file of the widget.
21 ; 3. Extraction of units
23 ; Extract produced units, pack it (remove empty lines and directives)
27 ; Any directive occupy one whole line starting with %
31 ; produce an empty line at the end
33 ; - %begin systemd-unit
36 ; delimit the produced unit
38 ; - %systemd-unit user
39 ; - %systemd-unit system
41 ; tells the kind of unit (user/system)
43 ; - %systemd-unit service NAME
44 ; - %systemd-unit socket NAME
46 ; gives the name and type of the unit
48 ; - %systemd-unit wanted-by NAME
50 ; tells to install a link to unit in the wants of NAME
54 ; AFM uses the feature of systemd that completely ignores options prefixed
57 ; Consequently, options starting with X-AFM- are recorded as public data
58 ; about the application and options starting starting with X-AFM-- are
59 ; recorded as private data.
63 ; X-AFM-description={{description}}
65 ; Records the description of the unit in the field "description"
66 ; of both the public and private object describing the unit.
68 ; X-AFM--wgtdir={{:#metadata.install-dir}}
70 ; Records the installation directory path in the field "wgtdir"
71 ; of the private object only.
73 ;---------------------------------------------------------------------------------
76 ;---------------------------------------------------------------------------------
77 ;---- P R O V I D E D U N I T S ----
78 ;---------------------------------------------------------------------------------
81 # auto generated by wgtpkg-unit for {{:id}} version {{:version}} target {{:#target}} of {{:idaver}}
85 Description={{description}}
86 X-AFM-description={{description}}
87 X-AFM-name={{name.content}}
88 X-AFM-shortname={{name.short}}
90 # use X-AFM-id={{:id}}--{{:ver}}--{{:#target}}
92 X-AFM-id={{idaver}}{{^#target=main}}@{{:#target}}{{/#target=main}}
93 # when home screen will use real ids
95 X-AFM-version={{:version}}
96 X-AFM-author={{author.content}}
97 X-AFM-author-email={{author.email}}
99 X-AFM-height={{height}}
101 X-AFM-icon={{:#metadata.install-dir}}/{{:src}}
104 X-AFM--target-name={{:#target}}
105 X-AFM--content={{content.src}}
106 X-AFM--type={{content.type}}
107 X-AFM--wgtdir={{:#metadata.install-dir}}
108 X-AFM--workdir={{&#metadata.app-data-dir}}/{{:id}}
113 # Adds check to smack
114 ConditionSecurity=smack
117 # Automatic bound to required api
120 BindsTo=afm-api-ws-{{name}}@%i.socket
121 After=afm-api-ws-{{name}}@%i.socket
127 EnvironmentFile=-@afm_confdir@/unit.env.d/*
128 SmackProcessLabel=User::App::{{:id}}
129 SuccessExitStatus=0 SIGKILL
135 CapabilityBoundingSet=
138 {{#required-permission}}
139 {{#urn:AGL:permission::platform:no-oom}} OOMScoreAdjust=-500 {{/urn:AGL:permission::platform:no-oom}}
140 {{#urn:AGL:permission::partner:real-time}} IOSchedulingClass=realtime {{/urn:AGL:permission::partner:real-time}}
141 # {{^urn:AGL:permission::partner:real-time}} RestrictRealtime=on {{/urn:AGL:permission::partner:real-time}}
142 {{#urn:AGL:permission::public:display}} SupplementaryGroups=display {{/urn:AGL:permission::public:display}}
143 {{^urn:AGL:permission::public:syscall:clock}} SystemCallFilter=~@clock {{/urn:AGL:permission::public:syscall:clock}}
144 {{/required-permission}}
147 WorkingDirectory=-{{&#metadata.app-data-dir}}/{{:id}}
148 ExecStartPre=/bin/mkdir -p {{&#metadata.app-data-dir}}/{{:id}}
149 Environment=AFM_APP_INSTALL_DIR={{:#metadata.install-dir}}
150 Environment=PATH=/usr/sbin:/usr/bin:/sbin:/bin:{{:#metadata.install-dir}}
151 Environment=XDG_RUNTIME_DIR=/run/user/%i
152 Environment=DBUS_SESSION_BUS_ADDRESS=unix:path=/run/user/%i/bus
154 ; Needed to enable debug
155 Environment=AFM_ID={{idaver}}{{^#target=main}}@{{:#target}}{{/#target=main}}
156 EnvironmentFile=-/var/run/afm-debug/{{idaver}}{{^#target=main}}@{{:#target}}{{/#target=main}}.env
159 {{#required-permission.urn:AGL:permission::public:hidden}}\
160 %systemd-unit service afm-service-{{:id}}--{{:ver}}--{{:#target}}@
161 {{/required-permission.urn:AGL:permission::public:hidden}}\
162 {{^required-permission.urn:AGL:permission::public:hidden}}\
163 %systemd-unit service afm-appli-{{:id}}--{{:ver}}--{{:#target}}@
164 {{/required-permission.urn:AGL:permission::public:hidden}}\
166 Environment=LD_LIBRARY_PATH=$ORIGIN/lib
168 SyslogIdentifier=afbd-{{idaver}}{{^#target=main}}@{{:#target}}{{/#target=main}}
170 StandardOutput=journal
171 StandardError=journal
173 ;---------------------------------------------------------------------------------
174 ;---- text/html application/vnd.agl.native application/vnd.agl.service ----
175 ;---------------------------------------------------------------------------------
176 {{#content.type=text/html|application/vnd.agl.native|application/vnd.agl.service}}
178 X-AFM--http-port={{:#metadata.http-port}}
180 ExecStart=/usr/bin/afb-daemon \
181 --name afbd-{{idaver}}{{^#target=main}}@{{:#target}}{{/#target=main}} \
182 --rootdir={{:#metadata.install-dir}} \
183 --workdir={{&#metadata.app-data-dir}}/{{id}} \
184 --port={{:#metadata.http-port}} \
188 {{^content.type=application/vnd.agl.service}} \
189 {{#required-permission.urn:AGL:permission::public:no-htdocs}}\
191 {{/required-permission.urn:AGL:permission::public:no-htdocs}}\
192 {{^required-permission.urn:AGL:permission::public:no-htdocs}}\
194 {{/required-permission.urn:AGL:permission::public:no-htdocs}}\
195 {{/content.type=application/vnd.agl.service}} \
196 {{#content.type=application/vnd.agl.service}} \
198 {{/content.type=application/vnd.agl.service}} \
199 {{#required-permission.urn:AGL:permission::public:applications:read}}\
200 --alias=/icons:{{:#metadata.icons-dir}} \
201 {{/required-permission.urn:AGL:permission::public:applications:read}}\
204 --ws-client=unix:%t/apis/ws/{{name}} \
207 --ws-client=unix:%t/apis/ws/{{name}} \
210 --dbus-client={{name}} \
213 --binding=%t/apis/lib/{{name}} \
216 --cloud-client={{name}} \
219 --binding={{:#metadata.install-dir}}/{{name}} \
224 {{^required-permission.urn:AGL:permission::partner:service:no-ws}}\
225 --ws-server=sd:{{name}} \
226 {{/required-permission.urn:AGL:permission::partner:service:no-ws}}\
227 {{^required-permission.urn:AGL:permission::partner:service:no-dbus}}\
228 --dbus-server={{name}} \
229 {{/required-permission.urn:AGL:permission::partner:service:no-dbus}}\
232 --ws-server=sd:{{name}} \
235 --dbus-server={{name}} \
238 {{#content.type=text/html}}\
239 --exec /usr/bin/web-runtime http://localhost:@p/{{content.src}}?token=@t
240 {{/content.type=text/html}}\
241 {{#content.type=application/vnd.agl.native}}\
242 --exec {{:#metadata.install-dir}}/{{content.src}} @p @t
243 {{/content.type=application/vnd.agl.native}}
245 {{/content.type=text/html|application/vnd.agl.native|application/vnd.agl.service}}
248 ;---------------------------------------------------------------------------------
249 ;---- application/x-executable ----
250 ;---------------------------------------------------------------------------------
251 {{#content.type=application/x-executable}}
253 ExecStart={{:#metadata.install-dir}}/{{content.src}}
255 {{/content.type=application/x-executable}}
257 ;---------------------------------------------------------------------------------
259 ;---------------------------------------------------------------------------------
260 {{#required-permission.urn:AGL:permission::system:run-by-default}}
263 WantedBy=default.target
264 %systemd-unit wanted-by default.target
265 {{/required-permission.urn:AGL:permission::system:run-by-default}}
270 ;---------------------------------------------------------------------------------
271 ;---- P R O V I D E D A P I S ----
272 ;---------------------------------------------------------------------------------
279 # auto generated by wgtpkg-unit for {{:id}} version {{:version}} target {{:#target}} of {{:idaver}}
282 %systemd-unit socket afm-api-ws-{{name}}@
286 ListenStream=%t/apis/ws/{{name}}
287 FileDescriptorName={{name}}
289 {{#required-permission.urn:AGL:permission::public:hidden}}\
290 Service=afm-service-{{:id}}--{{:ver}}--{{:#target}}@%i.service
291 {{/required-permission.urn:AGL:permission::public:hidden}}\
292 {{^required-permission.urn:AGL:permission::public:hidden}}\
293 Service=afm-appli-{{:id}}--{{:ver}}--{{:#target}}@%i.service
294 {{/required-permission.urn:AGL:permission::public:hidden}}\
296 ;---------------------------------------------------------------------------------
299 WantedBy=sockets.target
300 %systemd-unit wanted-by sockets.target
301 ;---------------------------------------------------------------------------------