forked from flatpak/flatpak.github.io
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathdeveloper.html
More file actions
933 lines (780 loc) · 75.7 KB
/
developer.html
File metadata and controls
933 lines (780 loc) · 75.7 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
<!DOCTYPE html>
<html>
<head>
<title>Flatpak</title>
<meta content='text/html; charset=UTF8' http-equiv='content-type'>
<meta content='fixme' name='description'>
<meta content='fixme' name='keywords'>
<meta content='width=device-width,initial-scale=1' name='viewport'>
<link href='img/favicon-1713a929.png' rel='icon' type='image/png'>
<link href='favicon.ico' rel='shortcut icon' type='image/x-icon'>
<link href='img/favicon57-0c07caa1.png' rel='apple-touch-icon' sizes='57x57'>
<link href='img/favicon152-b877307a.png' rel='apple-touch-icon' sizes='152x152'>
<link href="stylesheets/fonts-6c582ae6.css" rel="stylesheet" />
<link href="stylesheets/site-9d62429e.css" rel="stylesheet" />
<link href="stylesheets/animate-0a10c6dd.css" rel="stylesheet" />
<!-- = stylesheet_link_tag "http://overpass-30e2.kxcdn.com/overpass.css" -->
</head>
<body id='page-top'>
<nav class='navbar navbar-default navbar-fixed-top' id='mainNav'>
<div class='container-fluid'>
<!-- Brand and toggle get grouped for better mobile display -->
<div class='navbar-header'>
<button class='navbar-toggle collapsed' data-target='#bs-example-navbar-collapse-1' data-toggle='collapse' type='button'>
<span class='sr-only'>Toggle navigation</span>
<span class='icon-bar'></span>
<span class='icon-bar'></span>
<span class='icon-bar'></span>
</button>
<a class="navbar-brand page-scroll" href="./">Flatpak</a>
</div>
<div class='collapse navbar-collapse' id='bs-example-navbar-collapse-1'>
<ul class='nav navbar-nav navbar-right'>
<li>
<a href='index.html#about'>About</a>
</li>
<li>
<a class="page-scroll" href="getting.html">Getting Flatpak</a>
</li>
<li>
<a href='index.html#users'>Run</a>
</li>
<li>
<a href='index.html#developers'>Build</a>
</li>
<li>
<a href='index.html#get-involved'>Get Involved</a>
</li>
<li>
<a class="page-scroll" href="faq.html">FAQ</a>
</li>
</ul>
<!-- /.navbar-collapse -->
</div>
</div>
<!-- /.container-fluid -->
</nav>
</body>
<section class="bg-dark"><div class="container"><div class="row"><div class="col-lg-10 col-lg-offset-1">
<h1>Getting Started with Flatpak</h1>
<p>This guide contains everything you need to know to build and distribute applications using Flatpak. It includes an introduction to the basic concepts and a simple app building tutorial, before moving on to cover automated building and repository hosting.</p>
<p>Example tutorials are used throughout this guide. To complete them, it is necessary to have flatpak and flatpak-builder installed on your system. See <a href="getting.html">getting Flatpak</a> for more details on this.</p>
<h3>Table of Contents</h3>
<ul data-toc data-toc-headings="h2"></ul>
<h2>Key Concepts</h2>
<p>Flatpak is best understood through its key concepts: runtimes, bundled libraries, SDKs and sandboxes. These help to explain how Flatpak differs from traditional application distribution on Linux, as well as the framework's capabilities.</p>
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<svg
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:cc="http://creativecommons.org/ns#"
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:svg="http://www.w3.org/2000/svg"
xmlns="http://www.w3.org/2000/svg"
xmlns:xlink="http://www.w3.org/1999/xlink"
id="svg2"
version="1.1"
height="100%"
width="100%"
viewbox="0 0 800 600">
<defs
id="defs4" />
<metadata
id="metadata7">
<rdf:RDF>
<cc:Work
rdf:about="">
<dc:format>image/svg+xml</dc:format>
<dc:type
rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
<dc:title></dc:title>
</cc:Work>
</rdf:RDF>
</metadata>
<rect
ry="19"
rx="19"
style="color:#000000;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:#4a90d9;stroke-width:5;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;paint-order:normal;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate"
id="rect7719"
width="214.63611"
height="372.63611"
x="342.18195"
y="45.98188" />
<a
transform="translate(50,-198.56231)"
class="page-scroll"
href="#bundledlibraries"
xlink:title="Dependencies shipped with the app itself."
xlink:href="#bundledlibraries"
id="a7817">
<g
id="g7793"
transform="translate(0,-78)">
<rect
y="476.36218"
x="308"
height="56"
width="56"
id="rect7725"
style="color:#000000;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;fill:#4a90d9;fill-opacity:1;fill-rule:nonzero;stroke:#4a90d9;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;paint-order:normal;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate"
rx="6"
ry="6" />
<text
id="text7456-8"
y="509.33124"
x="336.2616"
style="color:#000000;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:10px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Normal';text-indent:0;text-align:center;text-decoration:none;text-decoration-line:none;letter-spacing:0px;word-spacing:0px;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr;baseline-shift:baseline;text-anchor:middle;display:inline;overflow:visible;visibility:visible;fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;enable-background:accumulate;"
xml:space="preserve"><tspan
y="509.33124"
x="336.2616"
id="tspan7458-5"
style="fill:#ffffff;-inkscape-font-specification:'Overpass, Normal';font-family:Overpass;font-weight:normal;font-style:normal;font-stretch:normal;font-variant:normal;font-size:10px;text-anchor:middle;text-align:center;writing-mode:lr;line-height:125%;">LIBRARY</tspan></text>
<rect
ry="6"
rx="6"
style="color:#000000;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;fill:#4a90d9;fill-opacity:1;fill-rule:nonzero;stroke:#4a90d9;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;paint-order:normal;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate"
id="rect7552"
width="56"
height="56"
x="371"
y="476.36218" />
<text
xml:space="preserve"
style="color:#000000;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:10px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Normal';text-indent:0;text-align:center;text-decoration:none;text-decoration-line:none;letter-spacing:0px;word-spacing:0px;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr;baseline-shift:baseline;text-anchor:middle;display:inline;overflow:visible;visibility:visible;fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;enable-background:accumulate;"
x="399.2616"
y="509.33124"
id="text7554"><tspan
style="fill:#ffffff;-inkscape-font-specification:'Overpass, Normal';font-family:Overpass;font-weight:normal;font-style:normal;font-stretch:normal;font-variant:normal;font-size:10px;text-anchor:middle;text-align:center;writing-mode:lr;line-height:125%;"
id="tspan7556"
x="399.2616"
y="509.33124">LIBRARY</tspan></text>
<rect
y="476.36218"
x="434"
height="56"
width="56"
id="rect7558"
style="color:#000000;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;fill:#4a90d9;fill-opacity:1;fill-rule:nonzero;stroke:#4a90d9;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;paint-order:normal;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate"
rx="6"
ry="6" />
<text
id="text7560"
y="509.33124"
x="462.2616"
style="color:#000000;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:10px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Normal';text-indent:0;text-align:center;text-decoration:none;text-decoration-line:none;letter-spacing:0px;word-spacing:0px;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr;baseline-shift:baseline;text-anchor:middle;display:inline;overflow:visible;visibility:visible;fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;enable-background:accumulate;"
xml:space="preserve"><tspan
y="509.33124"
x="462.2616"
id="tspan7562"
style="fill:#ffffff;-inkscape-font-specification:'Overpass, Normal';font-family:Overpass;font-weight:normal;font-style:normal;font-stretch:normal;font-variant:normal;font-size:10px;text-anchor:middle;text-align:center;writing-mode:lr;line-height:125%;">LIBRARY</tspan></text>
</g>
<g
transform="matrix(2,0,0,2,-1288.0004,983.3622)"
id="g6936"
style="display:inline;fill:#4a90d9;fill-opacity:1;enable-background:new" />
<g
style="display:inline;fill:#4a90d9;fill-opacity:1;enable-background:new"
id="g10628"
transform="matrix(2,0,0,2,-1224.0004,983.3622)" />
<g
transform="matrix(2,0,0,2,-1163.0004,983.3622)"
id="g10632"
style="display:inline;fill:#4a90d9;fill-opacity:1;enable-background:new" />
</a>
<path
style="color:#000000;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;fill:none;fill-opacity:0.54509804;fill-rule:nonzero;stroke:#4a90d9;stroke-width:3;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:3, 3;stroke-dashoffset:3;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;paint-order:normal;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate"
d="m 556.53553,189.39992 51.46447,0 c 10,0 21,9.4667 21,21 l 0,227.75736 c 0,14 -10.47966,24.64257 -24.28902,24.64257 l -54.4134,0"
id="path7749"
class="moving" />
<a
transform="translate(-165.39056,-476.56231)"
class="page-scroll"
href="#sandboxes"
xlink:title="Sandbox provides an isolated environment for the app to run."
xlink:href="#sandboxes"
id="a7991">
<rect
ry="4"
rx="4"
y="492.56232"
x="567"
height="31.505127"
width="95.781128"
id="rect10794"
style="color:#000000;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;fill:#4a90d9;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:6;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:6, 6;stroke-dashoffset:6;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;paint-order:normal;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate" />
<text
id="text7456-89"
y="512.83972"
x="614.22186"
style="color:#000000;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:12.22637558px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Normal';text-indent:0;text-align:center;text-decoration:none;text-decoration-line:none;letter-spacing:0px;word-spacing:0px;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;baseline-shift:baseline;text-anchor:middle;display:inline;overflow:visible;visibility:visible;fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;enable-background:accumulate"
xml:space="preserve"><tspan
y="512.83972"
x="614.22186"
id="tspan7458-9">SANDBOX</tspan></text>
</a>
<g
style="display:inline;fill:#ffffff"
id="g10657"
transform="matrix(2,0,0,2,-739,-632.20008)" />
<g
transform="matrix(2,0,0,2,-739,-733.20004)"
id="g10661"
style="display:inline;fill:#ffffff" />
<path
id="path7454"
d="m 550.29758,468.75843 56.67842,-10e-6 c 17.19015,0 28.88908,-15.06457 28.88908,-28.6014 l -1e-5,-229.21499 c 0,-14.87868 -13.79151,-29.14099 -26.66611,-29.14099 l -52.66343,0"
style="color:#000000;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;fill:none;fill-opacity:0.54509804;fill-rule:nonzero;stroke:#4a90d9;stroke-width:3;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:3,3;stroke-dashoffset:1.8;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;paint-order:normal;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate"
class="moving" />
<g
transform="matrix(1.0964467,0,0,1,-256.46701,650.63783)"
id="g7437">
<path
style="color:#000000;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;fill:#4a90d9;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;paint-order:normal;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate"
d="M 355 433.80078 C 346.69 433.80078 340 440.49078 340 448.80078 L 340 562.80078 C 340 571.11078 346.69 577.80078 355 577.80078 L 541 577.80078 C 549.31 577.80078 556 571.11078 556 562.80078 L 556 558.92383 A 15.5 15.5 0 0 1 542 543.5 A 15.5 15.5 0 0 1 556 528.08789 L 556 519.92383 A 15.5 15.5 0 0 1 542 504.5 A 15.5 15.5 0 0 1 556 489.08789 L 556 480.92383 A 15.5 15.5 0 0 1 542 465.5 A 15.5 15.5 0 0 1 556 450.08789 L 556 448.80078 C 556 440.49078 549.31 433.80078 541 433.80078 L 355 433.80078 z "
transform="matrix(0.91203704,0,0,1,233.90741,-650.63783)"
id="rect10708" />
</g>
<text
id="text7456"
y="469.67981"
x="487.33923"
style="color:#000000;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:12.22637558px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Normal';text-indent:0;text-align:start;text-decoration:none;text-decoration-line:none;letter-spacing:0px;word-spacing:0px;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;baseline-shift:baseline;text-anchor:start;display:inline;overflow:visible;visibility:visible;fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;enable-background:accumulate"
xml:space="preserve"><tspan
y="469.67981"
x="487.33923"
id="tspan7458"
style="fill:#ffffff">PORTAL</tspan></text>
<text
id="text7825-0"
y="520.59766"
x="307.75781"
style="color:#000000;font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:16px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Bold';text-indent:0;text-align:end;text-decoration:none;text-decoration-line:none;letter-spacing:0px;word-spacing:0px;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;baseline-shift:baseline;text-anchor:end;display:inline;overflow:visible;visibility:visible;fill:#4a90d9;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;enable-background:accumulate"
xml:space="preserve"><tspan
y="520.59766"
x="307.75781"
id="tspan7827-5"
style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:16px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Bold';text-align:end;writing-mode:lr-tb;text-anchor:end">OPERATING SYSTEM</tspan></text>
<rect
style="color:#000000;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;paint-order:normal;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate"
id="rect7359"
width="21.453516"
height="21.453516"
x="639.93188"
y="53.699928"
rx="3.0151393"
ry="3.0151393"
transform="matrix(0.70710678,0.70710678,-0.70710678,0.70710678,0,0)" />
<g
id="g7381"
transform="translate(421.5,513.625)">
<path
id="cog"
d="m -0.0336736,-14.055059 c -0.4413,0 -0.88162,0.0226 -1.3125,0.0624 l -0.8125,4.1875 c -0.66892,0.1466 -1.3261,0.35178 -1.9375,0.625 l -3.0625,-2.9375 c -0.77726,0.46022 -1.4539,1.02816 -2.1250004,1.625 l 1.8125004,3.8125004 c -0.44484,0.49798 -0.8485,1.045 -1.1875,1.625 l -4.1875004,-0.5625 c -0.35544,0.81754 -0.61744,1.67274 -0.8125,2.5625 l 3.6875,2.0000001 c -0.0342,0.33618 -0.0624,0.6548 -0.0624,1 0,0.3452 0.0284,0.6638199 0.0624,0.9999999 l -3.6875,2 c 0.195,0.88976 0.45706,1.74496 0.8125,2.5625 l 4.1875004,-0.5625 c 0.339,0.58 0.74266,1.12702 1.1875,1.625 L -9.283674,10.382341 c 0.6711004,0.59684 1.3477404,1.16478 2.1250004,1.625 l 3.0625,-2.9375 c 0.6114,0.27322 1.26858,0.47832 1.9375,0.625 l 0.8125,4.1875 c 0.43088,0.04 0.8712,0.0624 1.3125,0.0624 0.4413,0 0.88162,-0.0226 1.3125,-0.0624 l 0.8125,-4.1875 c 0.66892,-0.1466 1.3261,-0.35178 1.9375,-0.625 l 3.0625,2.9375 c 0.8193807,-0.451715 1.5684089,-0.960417 2.1249996,-1.625 L 7.4038264,6.5698414 c 0.44484,-0.49798 0.8485,-1.045 1.1875,-1.625 l 4.1874996,0.5625 c 0.35544,-0.81754 0.61744,-1.67274 0.8125,-2.5625 l -3.6875,-2 c 0.0342,-0.33618 0.0624,-0.6547999 0.0624,-0.9999999 0,-0.3452 -0.0284,-0.66382 -0.0624,-1 l 3.6875,-2.0000001 c -0.195,-0.88976 -0.45706,-1.74496 -0.8125,-2.5625 l -4.1874996,0.5625 c -0.339,-0.58 -0.74266,-1.12702 -1.1875,-1.625 L 9.216326,-10.492659 c -0.6710996,-0.59684 -1.3477396,-1.16478 -2.1249996,-1.625 l -3.0625,2.9375 c -0.6114,-0.27322 -1.26858,-0.47832 -1.9375,-0.625 l -0.8125,-4.1875 c -0.43088,-0.04 -0.8712,-0.0624 -1.3125,-0.0624 z m 0,8.0000004 c 3.3137,0 6,2.6863 6,6.0000001 0,3.3136999 -2.6863,5.9999999 -6,5.9999999 -3.3137,0 -6,-2.6863 -6,-5.9999999 0,-3.3137001 2.6863,-6.0000001 6,-6.0000001 z"
style="color:#000000;display:inline;overflow:visible;visibility:visible;fill:#4a90d9;fill-opacity:1;fill-rule:nonzero;stroke:none;marker:none;enable-background:accumulate" />
</g>
<rect
style="color:#000000;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;fill:none;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;paint-order:normal;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate"
id="rect7550"
width="800"
height="600"
x="0.5"
y="0.5" />
<rect
ry="6.0000005"
rx="6"
style="color:#000000;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;fill:#4a90d9;fill-opacity:1;fill-rule:nonzero;stroke:#4a90d9;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;paint-order:normal;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate"
id="rect7564"
width="183"
height="56.31522"
x="358"
y="62.642273" />
<text
xml:space="preserve"
style="color:#000000;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:12.22637558px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Normal';text-indent:0;text-align:center;text-decoration:none;text-decoration-line:none;letter-spacing:0px;word-spacing:0px;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;baseline-shift:baseline;text-anchor:middle;display:inline;overflow:visible;visibility:visible;fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;enable-background:accumulate"
x="448.01904"
y="97.277473"
id="text7566"><tspan
id="tspan7568"
x="448.01904"
y="97.277473"
style="fill:#ffffff">DATA</tspan></text>
<rect
y="130.64227"
x="358"
height="56.31522"
width="183"
id="rect7570"
style="color:#000000;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;fill:#4a90d9;fill-opacity:1;fill-rule:nonzero;stroke:#4a90d9;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;paint-order:normal;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate"
rx="6"
ry="6.0000005" />
<text
id="text7572"
y="164.27747"
x="448.01904"
style="color:#000000;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:12.22637558px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Normal';text-indent:0;text-align:center;text-decoration:none;text-decoration-line:none;letter-spacing:0px;word-spacing:0px;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;baseline-shift:baseline;text-anchor:middle;display:inline;overflow:visible;visibility:visible;fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;enable-background:accumulate"
xml:space="preserve"><tspan
style="fill:#ffffff"
y="164.27747"
x="448.01904"
id="tspan7574">CODE</tspan></text>
<path
style="color:#000000;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:#4a90d9;stroke-width:3;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:3, 6;stroke-dashoffset:0;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;paint-order:normal;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate"
d="m 342.11612,268.46967 212,0"
id="path7576" />
<text
id="text7638"
y="173.59766"
x="307.75781"
style="color:#000000;font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:16px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Bold';text-indent:0;text-align:end;text-decoration:none;text-decoration-line:none;letter-spacing:0px;word-spacing:0px;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;baseline-shift:baseline;text-anchor:end;display:inline;overflow:visible;visibility:visible;fill:#4a90d9;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;enable-background:accumulate"
xml:space="preserve"><tspan
y="173.59766"
x="307.75781"
id="tspan7640"
style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:16px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Bold';text-align:end;writing-mode:lr-tb;text-anchor:end">APPLICATION</tspan></text>
<text
xml:space="preserve"
style="color:#000000;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:12.22637558px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Normal';text-indent:0;text-align:start;text-decoration:none;text-decoration-line:none;letter-spacing:0px;word-spacing:0px;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;baseline-shift:baseline;text-anchor:start;display:inline;overflow:visible;visibility:visible;fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;enable-background:accumulate"
x="487.33923"
y="509.67981"
id="text7642"><tspan
style="fill:#ffffff"
id="tspan7644"
x="487.33923"
y="509.67981">PORTAL</tspan></text>
<text
id="text7646"
y="549.67981"
x="487.33923"
style="color:#000000;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:12.22637558px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Normal';text-indent:0;text-align:start;text-decoration:none;text-decoration-line:none;letter-spacing:0px;word-spacing:0px;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;baseline-shift:baseline;text-anchor:start;display:inline;overflow:visible;visibility:visible;fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;enable-background:accumulate"
xml:space="preserve"><tspan
y="549.67981"
x="487.33923"
id="tspan7648"
style="fill:#ffffff">PORTAL</tspan></text>
<path
class="moving"
style="color:#000000;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;fill:none;fill-opacity:0.54509804;fill-rule:nonzero;stroke:#4a90d9;stroke-width:3;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:3, 3;stroke-dashoffset:2.70000005;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;paint-order:normal;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate"
d="m 550.29758,503.75843 56.67842,-10e-6 c 17.19015,0 28.88908,-15.06457 28.88908,-28.6014 l -1e-5,-36.21499"
id="path7720" />
<path
id="path7722"
d="m 550.29758,543.75843 56.67842,-10e-6 c 17.19015,0 28.88908,-15.06457 28.88908,-28.6014 l -1e-5,-37.21499"
style="color:#000000;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;fill:none;fill-opacity:0.54509804;fill-rule:nonzero;stroke:#4a90d9;stroke-width:3;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:3, 3;stroke-dashoffset:4.5;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;paint-order:normal;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate"
class="moving" />
<a
class="page-scroll"
href="#runtimes"
xlink:title="Runtimes"
xlink:href="#runtimes"
id="a7403">
<g
id="g7380"
class="page-scroll">
<rect
ry="6"
rx="6"
style="color:#000000;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:#4a90d9;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;paint-order:normal;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate"
id="rect7582"
width="56"
height="56"
x="358"
y="279.79987" />
<text
xml:space="preserve"
style="color:#000000;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:10px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Normal';text-indent:0;text-align:center;text-decoration:none;text-decoration-line:none;letter-spacing:0px;word-spacing:0px;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;baseline-shift:baseline;text-anchor:middle;display:inline;overflow:visible;visibility:visible;fill:#4a90d9;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;enable-background:accumulate"
x="386.2616"
y="312.76892"
id="text7584"><tspan
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:10px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Normal';text-align:center;writing-mode:lr-tb;text-anchor:middle;fill:#4a90d9;fill-opacity:1"
id="tspan7586"
x="386.2616"
y="312.76892">LIBRARY</tspan></text>
<rect
y="279.79987"
x="421"
height="56"
width="56"
id="rect7588"
style="color:#000000;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:#4a90d9;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;paint-order:normal;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate"
rx="6"
ry="6" />
<text
id="text7590"
y="312.76892"
x="449.2616"
style="color:#000000;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:10px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Normal';text-indent:0;text-align:center;text-decoration:none;text-decoration-line:none;letter-spacing:0px;word-spacing:0px;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;baseline-shift:baseline;text-anchor:middle;display:inline;overflow:visible;visibility:visible;fill:#4a90d9;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;enable-background:accumulate"
xml:space="preserve"><tspan
y="312.76892"
x="449.2616"
id="tspan7592"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:10px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Normal';text-align:center;writing-mode:lr-tb;text-anchor:middle;fill:#4a90d9;fill-opacity:1">LIBRARY</tspan></text>
<rect
ry="6"
rx="6"
style="color:#000000;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:#4a90d9;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;paint-order:normal;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate"
id="rect7594"
width="56"
height="56"
x="484"
y="279.79987" />
<text
xml:space="preserve"
style="color:#000000;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:10px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Normal';text-indent:0;text-align:center;text-decoration:none;text-decoration-line:none;letter-spacing:0px;word-spacing:0px;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;baseline-shift:baseline;text-anchor:middle;display:inline;overflow:visible;visibility:visible;fill:#4a90d9;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;enable-background:accumulate"
x="512.2616"
y="312.76892"
id="text7596"><tspan
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:10px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Normal';text-align:center;writing-mode:lr-tb;text-anchor:middle;fill:#4a90d9;fill-opacity:1"
id="tspan7598"
x="512.2616"
y="312.76892">LIBRARY</tspan></text>
<rect
y="345.79987"
x="358"
height="56"
width="56"
id="rect7610"
style="color:#000000;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:#4a90d9;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;paint-order:normal;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate"
rx="6"
ry="6" />
<text
id="text7612"
y="378.76892"
x="386.2616"
style="color:#000000;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:10px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Normal';text-indent:0;text-align:center;text-decoration:none;text-decoration-line:none;letter-spacing:0px;word-spacing:0px;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;baseline-shift:baseline;text-anchor:middle;display:inline;overflow:visible;visibility:visible;fill:#4a90d9;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;enable-background:accumulate"
xml:space="preserve"><tspan
y="378.76892"
x="386.2616"
id="tspan7614"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:10px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Normal';text-align:center;writing-mode:lr-tb;text-anchor:middle;fill:#4a90d9;fill-opacity:1">LIBRARY</tspan></text>
<rect
ry="6"
rx="6"
style="color:#000000;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:#4a90d9;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;paint-order:normal;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate"
id="rect7616"
width="56"
height="56"
x="421"
y="345.79987" />
<text
xml:space="preserve"
style="color:#000000;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:10px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Normal';text-indent:0;text-align:center;text-decoration:none;text-decoration-line:none;letter-spacing:0px;word-spacing:0px;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;baseline-shift:baseline;text-anchor:middle;display:inline;overflow:visible;visibility:visible;fill:#4a90d9;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;enable-background:accumulate"
x="449.2616"
y="378.76892"
id="text7618"><tspan
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:10px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Normal';text-align:center;writing-mode:lr-tb;text-anchor:middle;fill:#4a90d9;fill-opacity:1"
id="tspan7620"
x="449.2616"
y="378.76892">LIBRARY</tspan></text>
<rect
y="345.79987"
x="484"
height="56"
width="56"
id="rect7622"
style="color:#000000;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;fill:#ffffff;fill-opacity:1;fill-rule:nonzero;stroke:#4a90d9;stroke-width:2;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;paint-order:normal;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate"
rx="6"
ry="6" />
<text
id="text7624"
y="378.76892"
x="512.2616"
style="color:#000000;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:10px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Normal';text-indent:0;text-align:center;text-decoration:none;text-decoration-line:none;letter-spacing:0px;word-spacing:0px;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;baseline-shift:baseline;text-anchor:middle;display:inline;overflow:visible;visibility:visible;fill:#4a90d9;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;enable-background:accumulate"
xml:space="preserve"><tspan
y="378.76892"
x="512.2616"
id="tspan7626"
style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:10px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Normal';text-align:center;writing-mode:lr-tb;text-anchor:middle;fill:#4a90d9;fill-opacity:1">LIBRARY</tspan></text>
<text
xml:space="preserve"
style="color:#000000;font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:16px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Bold';text-indent:0;text-align:end;text-decoration:none;text-decoration-line:none;letter-spacing:0px;word-spacing:0px;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;baseline-shift:baseline;text-anchor:end;display:inline;overflow:visible;visibility:visible;fill:#4a90d9;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:1;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;enable-background:accumulate"
x="307.75781"
y="353.59766"
id="text7634"><tspan
style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:16px;line-height:125%;font-family:Overpass;-inkscape-font-specification:'Overpass, Bold';text-align:end;writing-mode:lr-tb;text-anchor:end"
id="tspan7636"
x="307.75781"
y="353.59766">RUNTIME</tspan></text>
<rect
ry="0"
rx="0"
y="275"
x="215"
height="135"
width="333"
id="rect7378"
style="color:#000000;clip-rule:nonzero;display:inline;overflow:visible;visibility:visible;opacity:1;isolation:auto;mix-blend-mode:normal;color-interpolation:sRGB;color-interpolation-filters:linearRGB;solid-color:#000000;solid-opacity:1;fill:none;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:3;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-dasharray:3, 3;stroke-dashoffset:1.79999995;stroke-opacity:1;marker:none;marker-start:none;marker-mid:none;marker-end:none;paint-order:normal;color-rendering:auto;image-rendering:auto;shape-rendering:auto;text-rendering:auto;enable-background:accumulate" />
</g>
</a>
</svg>
<style>
@keyframes linespulse {
0% { stroke-dashoffset: 12; }
100% { stroke-dashoffset: 0; }
}
@keyframes spin {
0% { transform: rotateZ(0deg); }
100% { transform: rotateZ(359deg); }
}
path.moving {
animation-name: linespulse;
animation-duration: 1s;
animation-iteration-count:infinite;
animation-direction: normal;
animation-timing-function: linear;
animation-fill-mode: forwards;
}
a tspan { transition: font-size 200ms ease-in-out; }
a tspan:hover { font-size: 120%; }
#gnome { transform: matrix(1.999999,0,0,1.999999,170.75063,-2129.837); transition: transform 200ms ease-in-out; }
#gnome:hover { transform: matrix(1.999999,0,0,1.999999,170.75063,-2134.837); }
#cog {
animation: spin 6s infinite normal linear forwards;
}
</style>
<h3>Runtimes<a id="runtimes"></a></h3>
<p>Runtimes provide the environment that each application runs in, including the basic dependencies they might require. Each runtime can be thought of as a <code>/usr</code> filesystem (indeed, when an app is run, its runtime is mounted at <code>/usr</code>). Various runtimes are available, from more minimal (but more stable) Freedesktop runtimes, to larger runtimes produced by desktops like GNOME or KDE. (The <a href="runtimes.html">runtimes page</a> provides an overview of the runtimes that are currently available.)</p>
<p>Each application must be built against a runtime, and this runtime must be installed on a host system in order for the application to run. Users can install multiple different runtimes at the same time, including different versions of the same runtime.</p>
<p>Flatpak identifies runtimes (as well as SDKs and applications) by a triple of name/arch/branch. The name is expected to be in inverse-dns notation, which needs to match the D-Bus name used for the application. For example: '<code>org.gnome.Sdk/x86_64/3.14</code>' or '<code>org.gnome.Builder/i386/master</code>'.</p>
<h3>Bundled Libraries<a id="bundledlibraries"></a></h3>
<p>If an application requires any dependencies that aren't in its runtime, they can be bundled along with the application itself. This allows apps to use dependencies that aren't available in a distribution, or to use a different version of a dependency from the one that's installed on the host.</p>
<p>Both runtimes and app bundles can be installed per-user and system-wide.</p>
<h3>SDKs (Software Developer Kits)<a id="sdks"></a></h3>
<p>An SDK is a runtime that includes the 'devel' parts which are not needed at runtime, such as build and packaging tools, header files, compilers and debuggers. Each application is built against an SDK, which is typically paired with a runtime (this is the runtime that will be used by the application at runtime).</p>
<h3>Sandboxes<a id="sandboxes"></a></h3>
<p>With Flatpak, each app is built and run in an isolated environment. By default, the application can only 'see' itself and its runtime. Access to user files, network, graphics sockets, subsystems on the bus and devices have to be explicitly granted. (As will be described later, Flatpak provides several ways to do this.) Access to other things, such as other processes, is (deliberately) not possible.</p>
<h2>Technologies</h2>
<p>Flatpak tries to avoid reinventing the wheel. We build on existing technologies where it makes sense. Many of the important ingredients for Flatpak are inherited from Linux containers and related initiatives:</p>
<ul>
<li>The <a href="https://github.com/projectatomic/bubblewrap">bubblewrap</a> utility from <a href="http://www.projectatomic.io/">Project Atomic</a>, which lets unprivileged users set up and run containers, using kernel features such as
<ul>
<li>Namespaces</li>
<li>Bind mounts</li>
<li>Seccomp rules</li>
</ul></li>
<li><a href="https://www.freedesktop.org/wiki/Software/dbus/">D-Bus</a>, a well-established way to provide high-level APIs to application</li>
<li>The OCI format from the <a href="https://www.opencontainers.org/">Open Container Initiative</a>, as a convenient transport format for single-file bundles</li>
<li>The <a href="https://ostree.readthedocs.io/en/latest/">OSTree</a> system for versioning and distributing filesystem trees</li>
<li><a href="https://www.freedesktop.org/software/appstream/docs/">Appstream</a> metadata that makes Flatpak apps show up nicely in software-center applications</li>
</ul>
<h2>The flatpak Command</h2>
<p><code>flatpak</code> is the tool that is used to install, remove and update runtimes and applications. It can also be used to view what is currently installed, and has commands for building and distributing application bundles. <code>flatpak --help</code> provides a full list of available commands.</p>
<p>Most <code>flatpak</code> commands are performed system-wide by default. To perform a command for the current user only, use the <code>--user</code> option.</p>
<h2>Anatomy of a Flatpak App</h2>
<p>Each Flatpak app has the following basic structure:</p>
<pre><code>metadata # A keyfile which provides information about the application,
 # including information that is necessary for setting up the sandbox
 # for running the application
/files # The files that make up the application
/files/bin # Application binaries
/export # Files which the host environment needs access to, such as the
 # application's desktop file, icon and D-Bus service file
</code></pre>
<p>A typical metadata file looks like this:</p>
<pre><code>[Application]
name=org.gnome.gedit
runtime=org.gnome.Platform/x86_64/3.20
sdk=org.gnome.Sdk/x86_64/3.20
command=gedit

[Context]
shared=ipc;network;
sockets=x11;wayland;pulseaudio;
devices=dri;
filesystems=host;

[Environment]
GEDIT_FOO=bar

[Session Bus Policy]
org.extra.name=talk
org.other.name=own
</code></pre>
<p>This specifies the name of the application, the runtime it requires, the SDK that it is built against and the command used to run it. It also specifies file and device access, sets certain environment variables (inside the sandbox, of course), and how to connect to the session bus.</p>
<p>All the files in the export directory must have the application id as a prefix. This guarantees that applications cannot cause conflicts, and that they can’t override any system installed applications.</p>
<h3>AppData</h3>
<p>Many Linux distributions provide an app store or app center for browsing and installing applications. <a href="https://www.freedesktop.org/software/appstream/docs/chap-Quickstart.html#sect-Quickstart-DesktopApps">AppData</a> is a standard format for providing application information that can be used by app stores, such as an application description and screenshots. Flatpak makes use of the AppData standard, and application authors are recommended to use it to include information about their applications.</p>
<h2>Building Simple Apps</h2>
<p>The <code>flatpak</code> utility provides a simple set of commands for building and distributing applications. These allow creating new Flatpaks, into which new or existing applications can be built. This section describes how to build a simple application which doesn't require any additional dependencies outside of the runtime it is built against.</p>
<h3>Installing an SDK</h3>
<p>As described above, an SDK is a special type of runtime that is used to build applcations. Typically, an SDK is paired with a runtime that will be used by the app at runtime. For example the GNOME 3.20 SDK is used to build applications that use the GNOME 3.20 runtime. The rest of this guide uses this SDK and runtime for its examples. To do this, download the repository GPG key and then add the repository that contains the runtime and SDK:</p>
<pre>
<span class="unselectable">$ </span>wget https://sdk.gnome.org/keys/gnome-sdk.gpg
<span class="unselectable">$ </span>flatpak remote-add --gpg-import=gnome-sdk.gpg gnome https://sdk.gnome.org/repo/</pre>
<p>You can now download and install the runtime and SDK. (If you have already completed the tutorial on the Flatpak homepage, you will already have the runtime installed)</p>
<pre>
<span class="unselectable">$ </span>flatpak install gnome org.gnome.Platform 3.20
<span class="unselectable">$ </span>flatpak install gnome org.gnome.Sdk 3.20</pre>
<p>This might be a good time to try installing an application and having a look 'under the hood'. To do this, you need to add a repository that contains applications. In this case we are going to use the gnome-apps repository and install gedit:</p>
<pre>
<span class="unselectable">$ </span>flatpak remote-add --gpg-import=gnome-sdk.gpg gnome-apps https://sdk.gnome.org/repo-apps/
<span class="unselectable">$ </span>flatpak install gnome-apps org.gnome.gedit stable</pre>
<p>You can now use the following command to get a shell in the 'devel sandbox':</p>
<pre>
<span class="unselectable">$ </span>flatpak run --devel --command=bash org.gnome.gedit</pre>
<p>This gives you an environment which has the application bundle mounted in <code>/app</code>, and the SDK it was built against mounted in <code>/usr</code>. You can explore these two directories to see what a typical flatpak looks like, as well as what is included in the SDK.</p>
<h3>Creating an app</h3>
<p>To create an application, the first step is to use the build-init command. This creates a directory into which an applcation can be built, which contains the correct directory structure and a metadata file which contains information about the app. The format for build-init is:</p>
<pre>
<span class="unselectable">$ </span>flatpak build-init DIRECTORY APPNAME SDK RUNTIME [BRANCH]</pre>
<ul>
<li><code>DIRECTORY</code> is the name of the directory that will be created to contain the application</li>
<li><code>APPNAME</code> is the D-Bus name of the application</li>
<li><code>SDK</code> is the name of the SDK that will be used to build the application</li>
<li><code>RUNTIME</code> is the name of the runtime that will be required by the application</li>
<li><code>BRANCH</code> is typically the version of the SDK and runtime that will be used</li>
</ul>
<p>For example, to build the GNOME Dictionary application using the GNOME 3.20 SDK, the command would look like:</p>
<pre>
<span class="unselectable">$ </span>flatpak build-init dictionary org.gnome.Dictionary org.gnome.Sdk org.gnome.Platform 3.20</pre>
<p>You can try this command now. In the next step we will build an application inside the resulting dictionary directory.</p>
<h3>Building</h3>
<p><code>flatpak build</code> is used to build an application using an SDK. This command is used to provide access to a sandbox. For example, the following will create a file inside the appdir sandbox (in the files directory):</p>
<pre>
<span class="unselectable">$ </span>flatpak build dictionary touch /app/some_file</pre>
<p>(It is best to remove this file before continuing.)</p>
<p>The build command allows existing applications that have been made using the traditional configure, make, make install routine to be built inside a flatpak. You can try this using GNOME Dictionary. First, download the source files, extract them and switch to the resulting directory:</p>
<pre>
<span class="unselectable">$ </span>wget https://download.gnome.org/sources/gnome-dictionary/3.20/gnome-dictionary-3.20.0.tar.xz
<span class="unselectable">$ </span>tar xvf gnome-dictionary-3.20.0.tar.xz
<span class="unselectable">$ </span>cd gnome-dictionary-3.20.0/</pre>
<p>Then you can use the build command to build and install the source inside the dictionary directory that was previously made:</p>
<pre>
<span class="unselectable">$ </span>flatpak build ../dictionary ./configure --prefix=/app
<span class="unselectable">$ </span>flatpak build ../dictionary make
<span class="unselectable">$ </span>flatpak build ../dictionary make install
<span class="unselectable">$ </span>cd ..</pre>
<p>Since these are run in a sandbox, the compiler and other tools from the SDK are used to build and install, rather than those on the host system.</p>
<h3>Completing the build</h3>
<p>Once an application has been built, the build-finish command needs to be used to specify access to different parts of the host, such as networking and graphics sockets. This command is also used to specify the command that is used to run the app (done by modifying the metadata file), and to create the application's exports directory. For example:</p>
<pre>
<span class="unselectable">$ </span>flatpak build-finish dictionary --socket=x11 --share=network --command=gnome-dictionary</pre>
<p>At this point you have successfully built a flatpak and prepared it to be run. To test the app, you need to export the Dictionary to a repository, add that repository and then install and run the app:</p>
<pre>
<span class="unselectable">$ </span>flatpak build-export repo dictionary
<span class="unselectable">$ </span>flatpak --user remote-add --no-gpg-verify --if-not-exists tutorial-repo repo
<span class="unselectable">$ </span>flatpak --user install tutorial-repo org.gnome.Dictionary
<span class="unselectable">$ </span>flatpak run org.gnome.Dictionary</pre>
<p>This exports the app, creates a repository called tutorial-repo, installs the Dictionary application in the per-user installation area and runs it.</p>
<h2>Building More Complex Apps With flatpak-builder</h2>
<p>If an application requires additional dependencies that aren't provided by its runtime, Flatpak allows them to be bundled as modules as part of the app itself. This requires building each module inside the application, which can be a lot of work. The <code>flatpak-builder</code> tool can automate this multi-step build process.</p>
<p>flatpak-builder takes care of the routine commands used to build an app and any bundled libraries, thus allowing application building to be automated. To do this, it expects modules to be built in a standard manner by following what is called the <a href="https://github.com/cgwalters/build-api">Build API</a>. If any modules don't conform to this API, they will need to be modified.</p>
<h3>Manifests</h3>
<p>The input to flatpak-builder is a json file that describes the parameters for building an app, as well as each of the modules to be bundled. This file is called the manifest. Module sources can be of several types, including .tar or .zip archives, Git or Bzr repositories, patch files or shell commands that are run.</p>
<p>The GNOME Dictionary manifest is short, because the only module is the application itself:</p>
<pre><code>{
 "app-id": "org.gnome.Dictionary",
 "runtime": "org.gnome.Platform",
 "runtime-version": "3.20",
 "sdk": "org.gnome.Sdk",
 "command": "gnome-dictionary",
 "finish-args": [ 
 "--socket=x11", 
 "--share=network" 
 ],
 "modules": [
 {
 "name": "gnome-dictionary",
 "sources": [
 {
 "type": "archive",
 "url": "https://download.gnome.org/sources/gnome-dictionary/3.20/gnome-dictionary-3.20.0.tar.xz",
 "sha256": "efb36377d46eff9291d3b8fec37baab2355f9dc8bc7edb791b6a625574716121"
 }
 ]
 }
 ]
}
</code></pre>
<h3>Cleanup</h3>
<p>flatpak-builder performs a cleanup phase after the build, which can be used to remove headers and development docs, among other things. Two properties in the manifest file can be used for this. First, a list of filename patterns can be included:</p>
<pre><code>"cleanup": [ "/include", "/bin/foo-*", "*.a" ]
</code></pre>
<p>The second cleanup property is a list of commands that are run during the cleanup phase:</p>
<pre><code>"cleanup-commands": [ "sed s/foo/bar/ /bin/app.sh" ]
</code></pre>
<p>Cleanup properties can be set on a per-module basis, and will then only match filenames that were created by that particular module.</p>
<h3>File renaming</h3>
<p>Files that are exported by a flatpak must be named using the application ID. However, application's source files will typically not follow this convention. To get around this, flatpak-builder allows renaming application icons, desktop files and AppData files as a part of the build process, using the rename-icon, rename-desktop-file and rename-appdata properties.</p>
<h3>Example</h3>
<p>You can try flatpak-builder for yourself, using the repository that was created in the previous section. To do this, place the manifest json from above into a file called <code>org.gnome.Dictionary.json</code> and run the following command:</p>
<pre>
<span class="unselectable">$ </span>flatpak-builder --repo=repo dictionary2 org.gnome.Dictionary.json</pre>
<p>This will:</p>
<ul>
<li>Create a new directory (called dictionary2)</li>
<li>Download and verify the Dictionary source code</li>
<li>Build and install the source code, using the SDK rather than the host system</li>
<li>Finish the build, by setting permissions (in this case giving access to X and the network)</li>
<li>Export the resulting build to the tutorial repository, which contains the Dictionary app that was previously installed</li>
</ul>
<p>flatpak-builder will also do some other useful things, like creating a separately installable debug runtime (called <code>org.gnome.Dictionary.Debug</code> in this case) and separately installable translations runtimes (called <code>org.gnome.Dictionary.Locale.$lang</code>).</p>
<p>It is now possible to update the installed version of the Dictionary application with the new version that was built and exported by flatpak-builder:</p>
<pre>
<span class="unselectable">$ </span>flatpak --user update org.gnome.Dictionary</pre>
<p>To check that the application has been successfully updated, you can compare the sha256 commit of the installed app with the commit ID that was printed by flatpak-builder:</p>
<pre>
<span class="unselectable">$ </span>flatpak info org.gnome.Dictionary</pre>
<p>And finally, you can run the new version of the Dictionary app:</p>
<pre>
<span class="unselectable">$ </span>flatpak run org.gnome.Dictionary</pre>
<h3>Example manifests</h3>
<p>A complete manifest for <a href="https://git.gnome.org/browse/gnome-apps-nightly/tree/org.gnome.Dictionary.json">GNOME Dictionary built from Git is available</a>
, in addition to manifests for <a href="https://git.gnome.org/browse/gnome-apps-nightly/tree/">a range of other GNOME applications</a>.</p>
<h2>Working with the Sandbox</h2>
<p>By default, a flatpak has extremely limited access to the host environment. This includes:</p>
<ul>
<li>No access to any host files except the runtime, the app and <code>~/.var/app/$APPID</code>. Only the last of these is writable.</li>
<li>No access to the network.</li>
<li>No access to any device nodes (apart from <code>/dev/null</code>, etc).</li>
<li>No access to processes outside the sandbox.</li>
<li>Limited syscalls. For instance, apps can't use nonstandard network socket types or ptrace other processes.</li>
<li>Limited access to the session D-Bus instance - an app can only own its own name on the bus.</li>
<li>No access to host services like X, system D-Bus, or PulseAudio.</li>
</ul>
<p>Most applications will need access to some of these resources in order to be useful, and flatpak provides a number of ways to give an application access to them. The build-finish command is the simplest of these. As was seen in a previous example, this can be used to add access to graphics sockets and network resources:</p>
<pre>
<span class="unselectable">$ </span>flatpak build-finish dictionary2 --socket=x11 --share=network --command=gnome-dictionary</pre>
<p>These arguments translate into several properties in the application metadata file:</p>
<pre><code>[Application]
name=org.gnome.Dictionary
runtime=org.gnome.Platform/x86_64/3.20
sdk=org.gnome.Sdk/x86_64/3.20
command=gnome-dictionary

[Context]
shared=network;
sockets=x11;
</code></pre>
<p>Note that in this example access to the filesystem wasn't granted. This can be tested by installing the resulting application and running:</p>
<pre>
<span class="unselectable">$ </span>flatpak run --command=ls org.gnome.Dictionary ~/</pre>
<p>build-finish allows a whole range of resources to be added to an application. Run <code>flatpak build-finish --help</code> to view the full list.</p>
<p>There are several ways to override the permissions that are set in an application's metadata file. One of these is to override them using flatpak run, which accepts the same parameters as build-finish. For example, this will let the Dictionary application see your home directory:</p>
<pre>
<span class="unselectable">$ </span>flatpak run --filesystem=home --command=ls org.gnome.Dictionary ~/</pre>
<p>flatpak run can also be used to permanently override an application's permissions:</p>
<pre>
<span class="unselectable">$ </span>flatpak --user override --filesystem=home org.gnome.Dictionary
<span class="unselectable">$ </span>flatpak run --command=ls org.gnome.Dictionary ~/</pre>
<p>It is also possible to remove permissions using the same method. You can use the following command to see what happens when access to the filesystem is removed, for example:</p>
<pre><code> $ flatpak run --nofilesystem=home --command=ls org.gnome.Dictionary ~/
</code></pre>
<h3>Useful sandbox permissions</h3>
<p>flatpak provides an array of options for controlling sandbox permissions. The following are some of the most useful.</p>
<p>Grant access to files:</p>
<pre><code>--filesystem=host # All files
--filesystem=home # Home directory
--filesystem=home:ro # Home directory, read-only
--filesystem=/some/dir --filesystem=~/other/dir # Paths
--filesystem=xdg-download # The XDG download directory
--nofilesystem=... # Undo some of the above
</code></pre>
<p>Allow the application to show windows using X11:</p>
<pre><code>--socket=x11 --share=ipc
</code></pre>
<p>Note: –share=ipc means that the sandbox shares IPC namespace with the host. This is not necessarily required, but without it the X shared memory extension will not work, which is very bad for X performance.</p>
<p>Allow OpenGL rendering:</p>
<pre><code>--device=dri
</code></pre>
<p>Allow the application to show windows using Wayland:</p>
<pre><code>--socket=wayland
</code></pre>
<p>Allow the application to play sounds using PulseAudio:</p>
<pre><code>--socket=pulseaudio
</code></pre>
<p>Allow the application to access the network:</p>
<pre><code>--share=network
</code></pre>
<p>Note: giving network access also grants access to all host services listening on abstract Unix sockets (due to how network namespaces work), and these have no permission checks. This unfortunately affects e.g. the X server and the session bus which listens to abstract sockets by default. A secure distribution should disable these and just use regular sockets.</p>
<p>Allow the application talk to a named service on the session bus:</p>
<pre><code>--talk-name=org.freedesktop.secrets
</code></pre>
<p>Allow the application talk to a named service on the system bus:</p>
<pre><code>--system-talk-name=org.freedesktop.GeoClue2
</code></pre>
<p>Allow the application unlimited access to all of D-Bus:</p>
<pre><code>--socket=system-bus --socket=session-bus
</code></pre>
<h2>Distributing Applications</h2>
<p>As has already been seen, flatpak installs runtimes and apps from repositories. To do this, it uses <a href="https://ostree.readthedocs.io/en/latest/">OSTree</a>. This is similar to Git, but has been designed to handle trees of large binaries. Like Git, it has the concept of repositories and commits. Applications are stored as branches.</p>
<p>To distribute an application, it must be exported to a repository. This is done using the build-export command:</p>
<pre>
<span class="unselectable">$ </span>flatpak build-export [OPTION…] LOCATION DIRECTORY [BRANCH]</pre>
<p>The resulting repository is in an archive-z2 format. To allow users to use a repository, all you have to do is copy it to a web server and give them the URL.</p>
<h3>Managing repositories</h3>
<p>The flatpak build-update-repo command provides most of the tools for managing repositories. For example, to set a user readable name for a repository:</p>
<pre>
<span class="unselectable">$ </span>flatpak build-update-repo --title="Nice name" repo</pre>
<p>build-update also lets you prune (<code>--prune</code>) unused objects and deltas from the repository, and even remove older revisions (using <code>--prune-depth</code>) which is useful for things like automatic nightly build repositories.</p>
<h3>AppData</h3>
<p>As already described, flatpak uses the AppData standard to store user visible information about applications. This information needs to be accessible to clients in order to be displayed in app stores. To do this, build-update-repo scans all the branches in the repository for AppData data, which is collected and committed into a repository-wide AppStream branch. flatpak then keeps a local copy of this branch for each remote, which can be manually updated using the update command. For example:</p>
<pre>
<span class="unselectable">$ </span>flatpak update --appstream gnome</pre>
<h3>Hosting a repository</h3>
<p>While it is relatively simple to host a flatpak repository, there are some important details to be aware of.</p>
<p>archive-z2 repositories contain a single file for each file in the application. This means that pull operations will do a lot of HTTP requests. Since new requests are slow, it is important to enable HTTP keep-alive on the web server.</p>
<p>OSTree supports something called static deltas. These are single files in the repo that contains all the data needed to go between two revisions (or from nothing to a revision). Creating such deltas will take up more space on the server, but will make downloads much faster. This can be done with the build-update-repo --generate-static-deltas.</p>
<h3>GPG signatures</h3>
<p>By default OSTree refuses to pull from a remote repository that is not signed. To disable GPG verification, the <code>--no-gpg-verify</code> option needs to be used when a remote is added. Alternatively, it can be disabled on an existing remote using flatpak remote-modify.
Note that gpg signatures are required for the user to be able to install trusted remotes that can be updated from without needing to be root.</p>
<p>OSTree requires signatures for every commit and on repository summary files. These objects are created by the build-update-repo and build-export commands, as well as indirectly by flatpak-builder. A GPG key should therefore be passed to each of these commands, and optionally the gpg home directory to use. For example:</p>
<pre>
<span class="unselectable">$ </span>flatpak build-export --gpg-sign=KEYID --gpg-homedir=/some/dir appdir repo</pre>
</div></div></div></section>
<section class='bg-black' id='footer'>
<div class='container'>
<div class='row'>
<div class='col-lg-3 col-lg-offset-1'>
<a class='navbar-brand page-scroll' href='#page-top'>
<img title="Flatpak" class="full" src="img/logo-95a728ac.svg" />
</a>
</div>
<ul class='col-lg-7'>
<li class='toplevel'>
<a href="./">Home</a>
</li>
<li class='toplevel'>
<!-- id links on index page -->
<a class='page-scroll' href='index.html#about'>About</a>
</li>
<li class='toplevel'>
<!-- id links on index page -->
<a class="page-scroll" href="getting.html">Getting Flatpak</a>
</li>
<li class='toplevel'>
<!-- id links on index page -->
<a class='page-scroll' href='index.html#users'>Run</a>
<ul>
<li>
<a class="page-scroll" href="apps.html">Apps</a>
</li>
</ul>
</li>
<li class='toplevel'>
<!-- id links on index page -->
<a class='page-scroll' href='index.html#developers'>Build</a>
<ul>
<li>
<a class="page-scroll" href="developer.html">Getting Started with Flatpack</a>
</li>
<li>
<a class="page-scroll" href="bundling-a-java-app.html">Bundling a Java Application with Flatpak</a>
</li>
</ul>
</li>
<li class='toplevel'>
<!-- id links on index page -->
<a class='page-scroll' href='index.html#get-involved'>Get Involved</a>
</li>
<li class='toplevel'>
<!-- id links on index page -->
<a class="page-scroll" href="faq.html">FAQ</a>
</li>
</ul>
</div>
</div>
</section>
<script src="javascripts/jquery-1797d73e.js"></script>
<script src="javascripts/jquery.easing.min-603599b4.js"></script>
<script src="javascripts/all-77a3ee16.js"></script>
<script src="javascripts/bootstrap-8cf4186c.js"></script>
<script src="javascripts/jquery.toc.min-265bae56.js"></script>
<script type="text/javascript">
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-68811788-1', 'auto');
ga('send', 'pageview');
</script>
</html>