Bug 1859811 - The appdata guidance is out of date
Summary: The appdata guidance is out of date
Keywords:
Status: CLOSED EOL
Alias: None
Product: Fedora Documentation
Classification: Retired
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: 2024-05-21 09:23 UTC (History)
1 user (show)

Fixed In Version:
Clone Of:
Environment:
Last Closed: 2024-05-21 09:23:37 UTC
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

Comment 3 Petr Bokoc 2024-05-21 09:23:37 UTC
This guide has been retired, therefore I'm closing this bug. 

If you would like to report Fedora docs bugs in the future, please use the "bug" icon on the top right of the affected page, it will take you directly to the appropriate issue tracker.


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