appstreamcli-compose - Composer le catalogue de métadonnées AppStream à partir d'arborescences de répertoires
appstreamcli compose [COMMAND]
Cette page de manuel documente brièvement la commande appstreamcli compose.
L'outil appstreamcli compose est utilisé pour construire des catalogues de métadonnées AppStream à partir d'arborescences de répertoires. L'outil effectuera également de nombreuses actions de génération de métadonnées connexes, telles que le redimensionnement des icônes et des captures d'écran et la fusion des données à partir de fichiers d'entrée de bureau référencés ainsi que des informations sur l'état de la traduction. Par conséquent, l'outil fournit un moyen rapide de tester à quoi peuvent ressembler les métadonnées traitées finales pour une application qui est livrée aux utilisateurs. Il fournit également un moyen de générer facilement des données AppStream pour les projets qui n'ont pas besoin d'un générateur de données plus complexe comme appstream-generator.
Pour que la commande appstreamcli compose soit disponible, vous devrez peut-être d'abord installer le module de composition facultatif pour appstreamcli.
Pour plus d'informations sur le projet AppStream et les autres composants qui en font partie, consultez les pages AppStream sur Freedesktop.org[1].
RÉPERTOIRES SOURCES
Une liste de répertoires à traiter doit être fournie en tant que paramètres positionnels. Les données de tous les répertoires seront combinées dans un espace de noms de sortie.
Définissez l'identifiant d'origine des données AppStream. Cela peut être une valeur comme « debian-unstable-main » ou « flathub ».
Définit le répertoire dans lequel toutes les sorties générées déployées sur la machine d'un utilisateur sont exportées. Si ce paramètre n'est pas défini et que nous n'avons qu'un seul répertoire à traiter, nous utilisons ce répertoire comme chemin de sortie par défaut.
Si --data-dir et --icons-dir sont définis, --result-root n'est pas nécessaire et aucune donnée ne sera écrit dans ce répertoire.
Remplacez le répertoire dans lequel le catalogue de métadonnées AppStream généré sera écrit. Les données seront écrites directement dans ce répertoire et aucun sous-répertoire ne sera créé (contrairement à l'utilisation de --result-root pour définir un emplacement de sortie).
Remplacez le répertoire dans lequel les icônes mises en cache sont exportées.
Définissez un répertoire dans lequel les conseils générés lors du traitement des métadonnées sont enregistrés. Si ce paramètre n'est pas défini, aucun rapport d'indice HTML/YAML ne sera enregistré.
S'il est défini, crée un répertoire avec du contenu multimédia (icônes, captures d'écran, ...) pouvant être diffusé via un serveur Web. Les métadonnées seront étendues pour inclure des informations sur ces médias distants.
L'URL sous laquelle le contenu d'un répertoire défini via --media-dir sera servi. Cette valeur doit être définie si un répertoire multimédia est créé.
Définissez le préfixe par défaut utilisé dans les répertoires traités. Si aucun n'est défini explicitement, /usr est supposé.
Imprimez le rapport d'indices de problème (qui est exporté en tant que document HTML et YAML lorsque --hints-dir a été défini) sur la console sous forme de texte.
Différents modes d'impression sont pris en charge : en cas d'erreur n'imprime qu'un rapport court si l'exécution a échoué (par défaut), court génère un rapport abrégé qui est toujours imprimé et complet donne lieu à un rapport détaillé à imprimer.
Définissez une liste séparée par des virgules des ID de composants AppStream qui doivent être pris en compte pour les métadonnées générées. Tous les composants qui existent dans les données d'entrée mais qui ne sont pas mentionnés dans cette liste seront ignorés pour la sortie générée.
N'imprimez pas de sortie en couleur.
Afficher des informations de débogage supplémentaires
Afficher le numéro de version de appstreamcli compose
appstreamcli(1), appstream-generator(1).
Cette page de manuel a été écrite par Matthias Klumpp matthias@tenstral.net.
Copyright © 2020-2022 Matthias Klumpp
1. Freedesktop.org : https://www.freedesktop.org/wiki/Distributions/AppStream/