Bug 1859811 - The appdata guidance is out of date
Summary: The appdata guidance is out of date
Keywords:
Status: NEW
Alias: None
Product: Fedora Documentation
Classification: Fedora
Component: packager-guide
Version: devel
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
Assignee: Petr Bokoc
QA Contact: Fedora Docs QA
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2020-07-23 05:14 UTC by Todd Warner
Modified: 2020-07-23 18:23 UTC (History)
1 user (show)

Fixed In Version:
Doc Type: ---
Doc Text:
Clone Of:
Environment:
Last Closed:
Embargoed:


Attachments (Terms of Use)

Description Todd Warner 2020-07-23 05:14:53 UTC
Description of problem:
If you go looking for guidance for how to package RPMs, there is really no better guide than what Fedora produces. It is therefore that much more important that Fedora keeps up with Freedesktop.org standards.

The problem is that the "Packaging Guidelines for AppData Files" is out of date and wrong.

Version-Release number of selected component (if applicable):
https://docs.fedoraproject.org/en-US/packaging-guidelines/AppData/
As of July 23, 2020

Actual results: Let's just tick off a few of the problems (it needs a revamp)
- .metainfo.xml files are now preferred and .appdata.xml is deprecated
- example .xml file has wrong component type and id
- the launchable tag in the desktop application example is missing
"""
<component type="desktop">
  <id>comical.desktop</id>
"""
...that should be...
"""
<component type="desktop-application">
  <id>com.example.Comical</id>
"""

It's also missing the launchable tag
"""
<launchable type="desktop-id">com.example.Comical.desktop</lauchable>
"""

Expected results:

See above.

Additional info:
https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html

Comment 1 Todd Warner 2020-07-23 17:10:43 UTC
Apparently, gnome-software requires a .desktop in the <id> field. This is a gnome-software ... bug? I think?

Comment 2 Todd Warner 2020-07-23 18:23:44 UTC
(In reply to Todd Warner from comment #1)
> Apparently, gnome-software requires a .desktop in the <id> field. This is a
> gnome-software ... bug? I think?

https://bugzilla.redhat.com/show_bug.cgi?id=1860130


Note You need to log in before you can comment on or make changes to this bug.