Pyra Wiki:DBP file format: Difference between revisions
Jump to navigation
Jump to search
(Created page with "== DBP file format ==") |
No edit summary |
||
| (5 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
== DBP file | Please note: we're not going to describe something as painful as the pxml file here :P | ||
== file structure == | |||
a .dbp files is composed of 2 concatenated files : | |||
# a squashfs file | |||
# an *uncompressed* zip | |||
The squashfs part contain your application(s) and everything it might need to run. | |||
The zip part contain the meta-data related to the DBP. | |||
=== Sample session to build a dbp === | |||
Say you have a your application in a "rootfs" directory and a meta" directory containing the metadata. | |||
<pre> | |||
$ ls | |||
icons meta rootfs | |||
$ mksquashfs rootfs target.squash -all-root -force-gid 0 | |||
Creating 4.0 filesystem on target.squash, block size 131072. | |||
.... | |||
$ zip -r target.zip meta icons | |||
adding: meta/ (stored 0%) | |||
... | |||
$ cat target.squash target.zip > target.dbp | |||
</pre> | |||
== meta-data structure == | |||
== the desktop file(s) == | |||
=== Desktop Entry === | |||
{| class="wikitable" style="text-align: left;" | |||
|- | |||
! style="width:20%;" |LABEL | |||
! style="width:5%;" |dbpd | |||
! style="width:5%;" |Repo | |||
! style="width:40%;" |Description | |||
! style="width:30%;" |Example | |||
|- | |||
|Name | |||
|R | |||
|R | |||
|Name of the app | |||
|Name=dosbox | |||
|- | |||
|Comment | |||
|N | |||
|O | |||
|Description of the app | |||
|Comment=A DOS emulator | |||
|- | |||
|Version | |||
|N | |||
|O | |||
|Version of the app | |||
|Version=0.74+svn20200103 | |||
|- | |||
|Type | |||
|N | |||
|O | |||
|Type of app | |||
|Type=Application | |||
|- | |||
|Categories | |||
|N | |||
|O | |||
|Categories | |||
|Categories=Game;Emulator | |||
|- | |||
|Exec | |||
|R | |||
|N | |||
|The binary in the squashfs part to start | |||
|Exec=dosbox | |||
|- | |||
|Icon | |||
|O | |||
|O | |||
|The icon in the "icons" directory (expect .png) | |||
|Icon=dosbox.png | |||
|- | |||
|Terminal | |||
|N | |||
|N | |||
|Is this a terminal apps ? | |||
|Terminal=false | |||
|- | |||
|} | |||
=== Package Entry === | |||
{| class="wikitable" style="text-align: left;" | |||
|- | |||
! style="width:20%;" |LABEL | |||
! style="width:5%;" |dbpd | |||
! style="width:5%;" |Repo | |||
! style="width:40%;" |Description | |||
! style="width:30%;" |Example | |||
|- | |||
|Id | |||
|R | |||
|R | |||
|Uniq identifier for the dbp file. | |||
|Id=dosbox | |||
|- | |||
|Name | |||
|R | |||
|R | |||
|Name of the package | |||
|Name=DOSbox | |||
|- | |||
|Icon | |||
|N | |||
|O | |||
|Icon of the package (found in the "icons" directory) | |||
|Icon=dosbox.png | |||
|- | |||
|Version | |||
|N | |||
|O | |||
|Version of the package | |||
|Version=0.74+svn20200103 | |||
|- | |||
|Arch | |||
|O | |||
|O | |||
|Binary architecture of that package | |||
|Arch=armhf | |||
|- | |||
|Exec | |||
|R | |||
|N | |||
|TODO | |||
|Exec=bin/dosbox;dosbox.launch | |||
|- | |||
|} | |||
=== legend === | |||
{| class="wikitable" style="text-align: left;" | |||
|- | |||
! style="width:70%;" |letter | |||
! style="width:30%;" |meaning | |||
|- | |||
|R | |||
|Required | |||
|- | |||
|O | |||
|Optionnal | |||
|- | |||
|N | |||
|Not used | |||
|- | |||
|} | |||
Latest revision as of 23:09, 13 March 2021
Please note: we're not going to describe something as painful as the pxml file here :P
file structure
a .dbp files is composed of 2 concatenated files :
- a squashfs file
- an *uncompressed* zip
The squashfs part contain your application(s) and everything it might need to run.
The zip part contain the meta-data related to the DBP.
Sample session to build a dbp
Say you have a your application in a "rootfs" directory and a meta" directory containing the metadata.
$ ls icons meta rootfs $ mksquashfs rootfs target.squash -all-root -force-gid 0 Creating 4.0 filesystem on target.squash, block size 131072. .... $ zip -r target.zip meta icons adding: meta/ (stored 0%) ... $ cat target.squash target.zip > target.dbp
meta-data structure
the desktop file(s)
Desktop Entry
| LABEL | dbpd | Repo | Description | Example |
|---|---|---|---|---|
| Name | R | R | Name of the app | Name=dosbox |
| Comment | N | O | Description of the app | Comment=A DOS emulator |
| Version | N | O | Version of the app | Version=0.74+svn20200103 |
| Type | N | O | Type of app | Type=Application |
| Categories | N | O | Categories | Categories=Game;Emulator |
| Exec | R | N | The binary in the squashfs part to start | Exec=dosbox |
| Icon | O | O | The icon in the "icons" directory (expect .png) | Icon=dosbox.png |
| Terminal | N | N | Is this a terminal apps ? | Terminal=false |
Package Entry
| LABEL | dbpd | Repo | Description | Example |
|---|---|---|---|---|
| Id | R | R | Uniq identifier for the dbp file. | Id=dosbox |
| Name | R | R | Name of the package | Name=DOSbox |
| Icon | N | O | Icon of the package (found in the "icons" directory) | Icon=dosbox.png |
| Version | N | O | Version of the package | Version=0.74+svn20200103 |
| Arch | O | O | Binary architecture of that package | Arch=armhf |
| Exec | R | N | TODO | Exec=bin/dosbox;dosbox.launch |
legend
| letter | meaning |
|---|---|
| R | Required |
| O | Optionnal |
| N | Not used |