Bug#1077363: kinect-audio-setup: Add Appstream metainfo announcing HW support

[Petter Reinholdtsen]

Package: kinect-audio-setup
Version: 0.5-1
Tags: patch
User: ***@hungry.com
Usertags: appstream-modalias

Here is a patch to add Appstream metainfo XML announcing the hardware
handled by this package.

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
hardware is discovered.

The appstream metadata file can be checked using this command after
package build:

appstreamcli validate-tree --no-net --explain debian/gpsbabel-gui

diff --git a/debian/install b/debian/install
index de33cc8..fd31b16 100644
--- a/debian/install
+++ b/debian/install
@@ -1 +1,2 @@
kinect_fetch_fw /usr/sbin
+it.ao2.git.kinect_audio_setup.metainfo.xml usr/share/metainfo
diff --git a/debian/patches/1000-appstream-metainfo.patch b/debian/patches/1000-appstream-metainfo.patch
new file mode 100644
index 0000000..e76868f
--- /dev/null
+++ b/debian/patches/1000-appstream-metainfo.patch
@@ -0,0 +1,38 @@
+Description: Added AppStream metainfo XML with hardware provide info.
+ This allow isenkram to propose this package when the hardware is
+ present.
+Author: Petter Reinholdtsen
+Forwarded: no
+Last-Update: 2024-07-28
+---
+Index: kinect-audio-setup-0.5/it.ao2.git.kinect_audio_setup.metainfo.xml
+===================================================================
+--- /dev/null 1970-01-01 00:00:00.000000000 +0000
++++ kinect-audio-setup-0.5/it.ao2.git.kinect_audio_setup.metainfo.xml 2024-07-28 19:58:14.991507873 +0200
+@@ -0,0 +1,26 @@
++<?xml version="1.0" encoding="UTF-8"?>
++<component>
++ <id>it.ao2.git.kinect_audio_setup</id>
++ <metadata_license>MIT</metadata_license>
++ <name>kinect-audio-setup</name>
++ <summary>Microsoft Kinect sensor audio setup helpers</summary>
++ <description>
++ <p>When the Kinect sensor is first plugged in, its audio input
++ device shows up as a generic USB device; after the appropriate
++ firmware is loaded, the device is reset and it becomes available
++ as a USB Audio Class (UAC) device.</p>
++ <p>Since the firmware is not redistributable, kinect-audio-setup
++ provides tools to download it from the Internet at installation
++ time, and sets up udev rules to call the firmware loader when the
++ device is plugged in to finally get the UAC device.</p>
++ <p>The UAC firmware is downloaded from the Microsoft Kinect
++ Software Development Kit at
++ http://www.microsoft.com/en-us/kinectforwindows/, the license of
++ which can be found at
++ http://research.microsoft.com/en-us/um/legal/kinectsdk-tou_noncommercial.htm</p>
++ </description>
++ <url type="homepage">http://git.ao2.it/kinect-audio-setup.git/</url>
++ <provides>
++ <modalias>usb:v045Ep02ADd*</modalias>
++ </provides>
++</component>
diff --git a/debian/patches/series b/debian/patches/series
new file mode 100644
index 0000000..42e8b1a
--- /dev/null
+++ b/debian/patches/series
@@ -0,0 +1 @@
+1000-appstream-metainfo.patch

[Petter Reinholdtsen]

Dear Antonio,

Is there anything I can do to help get this AppStream fix into unstable?

[Petter Reinholdtsen]

Are you OK with me doing an NMU of this package to get the AppStream
information into unstable?