Skip to content

Add AppStream metadata#246

Merged
apritzel merged 1 commit into
linux-sunxi:masterfrom
ijc:appstream-metainfo
Jun 4, 2026
Merged

Add AppStream metadata#246
apritzel merged 1 commit into
linux-sunxi:masterfrom
ijc:appstream-metainfo

Conversation

@ijc

@ijc ijc commented May 31, 2026

Copy link
Copy Markdown
Contributor

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

This was provided by Petter Reinholdtsen in https://bugs.debian.org/1076627 and has been included in the Debian packages for a couple of years. In that bug the usefulness is described as:

Including this information in the package will ensure programs mapping
hardware to packages using Appstream information, like the isenkram
package, will know that this package is useful on machines where the USB
IDs are discovered.


Unsure why I didn't forward this at the time...

@jameshilliard

Copy link
Copy Markdown
Contributor

Is this something that only makes sense to install on Linux based systems? Should it be disabled on non-Linux?

@paulkocialkowski

Copy link
Copy Markdown
Member

I don't have strong opinions about this. I honestly doubt that potential sunxi-tools users will need something like this to find out they can use it based on hardware detection. At the same time it is a FDO spec and it looks like we won't really need to update it unless we add a new binary so it probably doesn't hurt to include it.

@ijc

ijc commented Jun 1, 2026

Copy link
Copy Markdown
Contributor Author

Disclaimer: I know next to nothing about this AppStream stuff, I'm (belatedly) forwarding a patch which was supplied to me as the Debian package maintainer.

Is this something that only makes sense to install on Linux based systems? Should it be disabled on non-Linux?

AIUI FDO specs are generally cross platform, at least cross-Unix platform. I don't know if anything on e.g. the *BSD's exists which consumes this but I guess it's at least theoretically possible.

I don't have strong opinions about this. I honestly doubt that potential sunxi-tools users will need something like this to find out they can use it based on hardware detection.

FWIW the patch was supplied by one of the authors of Isenkram "Suggest packages to install when inserting new hardware (GUI popup)". I think possibly things like the GNOME and KDE software centers might also support it?

But in general I share your doubt, but also:

At the same time it is a FDO spec and it looks like we won't really need to update it unless we add a new binary so it probably doesn't hurt to include it.

Seems about right to me.

I'm not really sure that the list of the binaries is the most important bit, once there is a match on the USB device (the <modalias>) the whole package would generally be installed. So if the list gets a bit out of date 🤷 ...

@jameshilliard

Copy link
Copy Markdown
Contributor

AIUI FDO specs are generally cross platform, at least cross-Unix platform. I don't know if anything on e.g. the *BSD's exists which consumes this but I guess it's at least theoretically possible.

I guess probably no harm adding it since it's a separate install target.

@apritzel

apritzel commented Jun 1, 2026

Copy link
Copy Markdown
Contributor

I don't mind having that, if it helps some people, then why not, doesn't seem to hurt. Just would be good to have someone with experience to have a look at the XML file. If no one shows up within a few days, I would just merge it anyway - since it seems to make @ijc's life easier ;-)

@paulkocialkowski

Copy link
Copy Markdown
Member

I don't mind having that, if it helps some people, then why not, doesn't seem to hurt. Just would be good to have someone with experience to have a look at the XML file. If no one shows up within a few days, I would just merge it anyway - since it seems to make @ijc's life easier ;-)

Sounds like a plan!

@apritzel apritzel left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have no real clue about AppStream, but found those issues when skimming over the XML file.

Comment thread Makefile Outdated
Comment thread Makefile Outdated
Comment thread org.linux_sunxi.sunxi-tools.metainfo.xml Outdated
Comment thread org.linux_sunxi.sunxi-tools.metainfo.xml
https://www.freedesktop.org/software/appstream/docs/chap-Metadata.html

This was provided by Petter Reinholdtsen in https://bugs.debian.org/1076627 and
has been included in the Debian packages for a couple of years. In that bug the
usefulness is described as:

> Including this information in the package will ensure programs mapping
> hardware to packages using Appstream information, like the isenkram
> package, will know that this package is useful on machines where the USB
> IDs are discovered.

Signed-off-by: Ian Campbell <ijc@debian.org>
@ijc ijc force-pushed the appstream-metainfo branch from d2a9709 to e3cc057 Compare June 3, 2026 05:39

@apritzel apritzel left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Many thanks @ijc for the changes, looks good now.
Verified with appstreamcli validate to pass the test.

Comment thread org.linux_sunxi.sunxi-tools.metainfo.xml
@apritzel apritzel merged commit 1e057a0 into linux-sunxi:master Jun 4, 2026
1 check passed
@ijc ijc deleted the appstream-metainfo branch June 9, 2026 15:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants