Important
dep11-validate
tool from the AppStream DEP-11 utils.
xmls
subdirectory in /usr/share/app-info
(or /var/cache/app-info
), the YAML data is stored in the yaml
subdirectory. All other rules affecting the XML apply the DEP-11 YAML as well, including the recommendation to compress the files with gzip.
DEP-11
.
Field info: value-type:str, required:yes
Field info: value-type:str, required:yes
<suite>-<component>
combination, e.g. jessie-main
.
Field info: value-type:str, required:yes
Field info: value-type:str, required:no
Field info: value-type:str, required:no
Field info: value-type:int, required:no
C
, with the untranslated string as value
Name
field:
Name: C: I am the untranslated string. be@latin: Redaktar naładaŭ bg: Настройки на програмите pl: Edytor konfiguracji
ID
field is a short unique and usually lower-cases identifier for the component. Depending on the component's type, different naming conventions apply.
Field info: value-type:str, required:yes
Priority
field sets the priority this component's metadata should have over other meadata in the pool. Data with a higher priority replaces data with a lower priority.
Field info: value-type:int, required:no
generic
for Section 2.1, “Generic Component”
desktop-application
for Section 2.2, “Desktop Applications”
console-application
for Section 2.3, “Console Applications”
addon
for Section 2.6, “Addons”
codec
for Section 2.8, “Codecs”
inputmethod
for Section 2.9, “Input Methods”
firmware
for Section 2.10, “Firmware”
Field info: value-type:str, required:yes
Merge
field describes the merge strategy that should be applied when merging data of this component into its base. It may assume the values append
or replace
.
Field info: value-type:str, required:no
Field info: value-type:str, required:yes
Field info: value-type:str
Field info: value-type:localized, required:yes
Field info: value-type:localized, required:yes
Field info: value-type:str
Field info: value-type:localized
Url
field contains the different url types as keys in its dict. Valid url types are defined in the main AppStream XML specification. All URL types must be lowercased.
Url: homepage: http://example.org faq: http://example.org/faq bugtracker: http://bugs.example.org/report-issue
Field info: value-type:dict
Field info: value-type:str
Icon
field has the different icon types as keys for its dict.
Field info: value-type:str
width
and height
of type int specifying the dimensions of the icon, as well as the key name
of type str specifying the name of the icon in the cache.
Field info: value-type:list ➟ dict
width
and height
of type int specifying the dimensions of the icon, as well as the key name
of type str specifying the absolute filename pointing to the right icon.
Field info: value-type:list ➟ dict
width
and height
of type int specifying the dimensions of the icon, as well as the key url
of type str which contains a HTTP(S) or FTP URL to the icon.
Field info: value-type:list ➟ dict
Field info: value-type:dict
Categories: - Network - Telephony
Field info: value-type:list
C
key must be present.
Keywords: C: - IDE - development - programming de: - IDE - entwicklung - programmierung
Field info: value-type:translated(list)
Screenshots
field contains a list of screenshots. A screenshot is of type dict and contains the following keys:
default
is true
, the screenshot is selected as default screenshot. There has to be at least one screenshot which is marked as default.
Field info: value-type:bool
height
width
url
MediaBaseUrl
, if defined (value-type:str).
lang
Field info: value-type:dict, required:yes
source-image
.
Field info: value-type:list, required:no
Field info: value-type:localized
Screenshots
field containing one screenshot:
Screenshots: - default: true caption: C: Foobar showing kitchen-sink functionality si: Foobar shoeewing kischän-sünk funzionality source-image: height: 800 url: http://www.example.org/en_US/main.png width: 600 thumbnails: - height: 423 width: 752 url: http://www.example.org/en_US/main-large.png - height: 63 width: 112 url: http://www.example.org/en_US/main-small.png
Field info: value-type:list
Field info: value-type:str
Provides
field is of type dict and can have the following keys set with the described allowed values:
Field info: value-type:list(str)
PATH
.
Field info: value-type:list(str)
Field info: value-type:list(str)
type
key, which has either runtime
or flashed
as value. Firmware of type flashed
has a guid
key, containing the GUID of the device the firmware is flashed on, while firmware of type runtime
has a file
key, containing the firmware filename which the kernel is looking for.
Field info: value-type:list(dict)
type
key, which has either system
or user
as value. user
means the DBus service name is for a user/session service, while system
means it describes a system service. The service
key contains the name of the DBus service file. All dict values are of type str.
Field info: value-type:list(dict)
Field info: value-type:dict
Field info: value-type:localized
Launch: desktop-id: - org.gnome.Sysprof2.desktop
Field info: value-type:dict(list)
Releases
contains a list of releases, where each list items contains the following fields/keys:
Field info: value-type:str, required:yes
unix-timestamp
or date
fields must be present.
Field info: value-type:int, required:maybe
unix-timestamp
or date
fields must be present.
Field info: value-type:str, required:maybe
Field info: value-type:localized
Releases: - version: '1.8' unix-timestamp: 1424116753 description: C: | <p>This stable release fixes the following bug:</p> <ul> <li>CPU no longer overheats when you hold down spacebar</li> </ul> - version: '1.2' unix-timestamp: 1397253600 - version: '1.0' unix-timestamp: 1345932000
Field info: value-type:list(dict)
percentage
key, indicating the completion of translation for this language, and a locale
key, with the locale string as value.
Languages: - locale: gu percentage: 96 - locale: ca@valencia percentage: 94 - locale: de percentage: 91 - locale: eo percentage: 93
Field info: value-type:list(dict)
Bundles
contains a list of dictionaries with the keys type
, having the ID for a specific bundling system (e.g. flatpak
or limba
) as value, and id
for the associated bundle-id. See the XML tag description for information on all valid bundling systems.
Bundles: - type: limba id: foobar-1.0.2
Field info: value-type:list
addon
.
Field info: value-type:list(str)
type
key with the string value upstream
or heuristic
depending on where the suggestion originates from. The also must have a ids
key containing a list of component-ids of the suggested software.
Suggests: - type: upstream ids: - org.example.Awesome - type: heuristic ids: - org.example.Test1 - org.example.Test2
Field info: value-type:list(dict)
ContentRating: oars-1.0: drugs-alcohol: moderate language-humor: mild
Field info: value-type:dict(dict)
version
field with contains a version comparison string. The first two characters denote the version comparison operation, and are followed by the version number to be compared with. The comparison operation may be one of:
==
- Equal to
!=
- Not equal to
<<
- Lesser than
>>
- Greater than
<=
- Lesser than or equal to
>=
- Greater than or equal to
Recommends: - memory: '2500' - modalias: usb:v1130p0202d* Requires: - kernel: Linux version: '>= 4.15' - id: org.example.TestDependency version: == 1.2
Field info: value-type:list(dict)
sections
key containing a list of sections. All dict values are the same as the respective XML tag values / properties.
Agreements: - type: eula version_id: 1.2.3a sections: - type: intro name: C: Intro\n" description: C: >- <p>If it breaks, you get to keep both pieces.</p>
Field info: value-type:list(dict)
--- File: DEP-11 Version: '0.8' Origin: chromodoris-main MediaBaseUrl: http://metadata.tanglu.org/appstream/media/ --- Type: desktop-application ID: gconf-editor.desktop Icon: cached: gconf-editor_gconf-editor.png Name: C: Configuration Editor be@latin: Redaktar naładaŭ bg: Настройки на програмите pl: Edytor konfiguracji Package: gconf-editor Summary: C: Directly edit your entire configuration database ar: حرّر مباشرة كامل قاعدة بيانات الإعدادات. de: Direkten Zugriff auf Ihre gesamte Konfigurationsdatenbank erlangen Categories: - GNOME - GTK - System --- Type: desktop-application ID: kmplayer.desktop Icon: cached: kmplayer_kmplayer.png Name: C: KMPlayer hi: केएम-प्लेयर hne: केएम-प्लेयर ku: KMLêdar pa: KM-ਪਲੇਅਰ sr: КМ‑плејер sr@ijekavian: КМ‑плејер sv: Kmplayer Package: kmplayer Summary: C: KDE interface for MPlayer Categories: - Qt - KDE - AudioVideo - Player Provides: mimetypes: - application/ogg - application/smil - application/vnd.ms-asf - application/vnd.rn-realmedia - application/x-kmplayer - video/webm - video/x-avi --- ID: texstudio.desktop Type: desktop-application Package: texstudio Name: C: TeXstudio Summary: C: LaTeX development environment fr: Environnement de développement LaTeX Description: C: <p>TeXstudio is an integrated writing environment for creating LaTeX documents. It integrates editing, building and viewing into a single frontend.</p><p>Our goal is to make writing LaTeX as easy and comfortable as possible. This is achieved through a rich feature set including:</p> Icon: cached: texstudio_texstudio.png Keywords: C: - editor - latex - pdflatex - xelatex - lualatex - context - bibtex ProjectLicense: GPL-2.0 Url: homepage: http://texstudio.sourceforge.net/ Categories: - Office - Publishing Provides: mimetypes: - text/x-tex Screenshots: - default: true source-image: height: 756 url: texstudio_2.8.4+debian-3_amd64/screenshots/source/screenshot-1.png width: 1344 thumbnails: - height: 423 url: texstudio_2.8.4+debian-3_amd64/screenshots/752x423/screenshot-1.png width: 752 - height: 351 url: texstudio_2.8.4+debian-3_amd64/screenshots/624x351/screenshot-1.png width: 624 - height: 63 url: texstudio_2.8.4+debian-3_amd64/screenshots/112x63/screenshot-1.png width: 112