Signaler des bogues

Les bogues arrivent. C'est un fait. Mais ils peuvent être corrigés. Et plus un rapport de bogue est détaillé, plus il est facile pour l'équipe de développement de le reproduire, de l'investiguer et éventuellement de le corriger.

Tous les rapports de bogues doivent être enregistrés dans le gestionnaire officiel de bogues. De plus, les demandes de fonctionnalités y sont également suivies à l'aide de la *liste de souhaits pour les élément **de gravité **. Mais avant de le faire, veuillez procéder comme suit :

Étape 1 : mise à niveau vers la dernière version

Veuillez vous mettre à niveau vers les dernières versions publiées de Kdenlive. Nous ne pouvons pas répondre aux rapports de bogues pour des anciennes versions de Kdenlive (Sauf s'ils sont encore reproductibles dans la dernière version).

Étape 2 : rechercher dans la documentation officielle de Kdenlive

RTFM - « Read The Fine Manual » est une expression souvent utilisée pour se moquer des utilisateurs posant des questions auxquelles on pourrait répondre en lisant la documentation. À l'époque du tutoriel YouTube, cela peut ne plus être aussi important ou pertinent. Mais, nous vous encourageons à consulter la documentation officielle de Kdenlive. Elle est permet des recherches et contient une véritable mine d'informations excellentes et précieuses.

Étape 3 : rechercher dans les forums

Kdenlive possède une grande communauté active dans les forums et les forums de discussion. Veuillez vérifier sur le forum officiel si d'autres personnes utilisatrices ont rencontré le même problème. Peut-être qu'il existe un correctif ou une solution de contournement. Les autres canaux à vérifier sont :

Étape 4 : interroger les problèmes ouverts

Rechercher dans le suivi des bogues. Peut-être que le problème que vous rencontrez a déjà été signalé ou est même en cours de traitement. L'état du bogue est un bon indicateur de ce qui se passe actuellement :

  • L'état « REPORTED » signifie qu'un bug a été signalé mais que rien ne s'est passé jusqu'à maintenant. Il peut y avoir une discussion à son sujet. Ainsi, il vaut donc la peine de vérifier si cela peut s'appliquer à votre problème.
  • L'état « NEEDSINFO » correspond à un bogue signalé, nécessitant plus de commentaires. Cela signifie qu'un membre de l'équipe de développement l'a examiné mais a besoin de plus de détails
  • L'état « CONFIRMED » signifie que le bogue peut être reproduit (Soit par d'autres personnes utilisatrices, soit par l'équipe de développement)
  • L'état « ASSIGNED » signifie qu'un membre de l'équipe de développement gère le bogue
  • L'état « RESOLVED » signifie que le bogue a été corrigé dans la version de développement

Étape 5 : signaler le bogue

Si vous avez un plantage au démarrage de Kdenlive ou lorsque vous tentez de lire un fichier vidéo, veuillez suivre ces étapes :

  1. Si vous avez compilé vous-même Kdenlive et / ou MLT, veuillez vous assurer de suivre toutes les étapes décrites dans nos instructions.
  2. Vérifiez que vous n'avez pas de multiples installations de versions de MLT installées
  3. Veuillez tenter de lire votre fichier vidéo avec le lecteur de FFMpeg. Depuis un terminal : saisir la commande « ffplay myvideo.mpg »
  4. Veuillez essayer de lire votre fichier vidéo avec le lecteur MLT. Depuis un terminal : saisir la commande « melt myvideo.mpg »

Inclure les résultats dans votre rapport de bogue en tant que pièces jointes.

Pour un bon rapport de bogue, veuillez inclure les informations suivantes :

  • Votre version de Kdenlive et MLT. Vous pouvez copier ces informations dans le menu de Kdenlive /Aide / À propos.
  • Votre système d'exploitation (OS), comme Windows, Linux ou macOS, y compris leur version respective
  • La méthode d'installation pour Kdenlive, comme le programme d'installation de Windows ou autonome ou Linux Flatpak / Snap / ppa ou AppImage
  • Étapes détaillées pour reproduire le bogue. Les copies d'écran et les enregistrements d'écran sont très utiles pour reproduire le problème.
  • Tous les messages d'erreur ou les fichiers journaux que vous pouvez fournir. Veuillez ** ne pas ** copier / coller le contenu du journal dans le rapport de bogue, mais l'ajouter en pièce jointe.
  • Si le bogue conduit au plantage de Kdenlive, veuillez fournir une pile d'appels.

Comment obtenir des informations utiles sur les plantages (Pile d'appels)

Une pile de trace contient des informations précieuses pour l'équipe de développement. Elle a besoin d'un peu d'informations sur la configuration spécifique du système d'exploitation et de magie de la ligne de commandes, ce qui peut ne pas être confortable pour tout le monde.

AppImage Linux

Veuillez installer les paquets suivants : « gdb », « kdenlive-dbg », « libmlt-dbg » (Les noms des paquets peuvent être légèrement différents selon votre distribution)

Lors d'un plantage de Kdenlive, si la boîte de dialogue du gestionnaire de plantage de KDE apparaît, vous pouvez copier les données qu'elle fournit. Sinon, veuillez démarrer Kdenlive à partir d'un terminal comme celui-ci :

  1. Saisir la commande « gdb kdenlive »
  2. Une fois les symboles de débogage lus par gdb, veuillez saisir la commande « run »

Linux Flatpak

Tout d'abord, veuillez vous assurer que les symboles de débogage pour Flatpak sont bien installés en saisissant la commande « flatpak install org.kde.kdenlive.Debug » sur une ligne de commandes.

Vous pouvez maintenant démarrer un élément « Flatpak » à partir d'une ligne de commandes comme celle-ci :

  1. Veuillez lancer un shell à l'intérieur du bac à sable dans le Flatpak de Kdenlive : « flatpak run--command =sh --devel org.kde.kdenlive »
  2. Saisir « gdb /app/bin/kdenlive »
  3. Une fois les symboles de débogage lus par gdb, veuillez saisir la commande « run »

Pour plus de détails sur le débogage avec Flatpak, veuillez consulter la page : https://docs.flatpak.org/en/latest/debugging.html

Windows

  1. Compiler localement Kdenlive avec KDECraft comme décrit ici.
  2. Saisir sur la ligne de commandes « cd C :/CraftRoot/mingw64/bin »
  3. Démarrer gdb par la commande « gdb »
  4. Démarrer Kdenlive / Obtenir le numéro « PID »
  5. « attach 3288 » (Remplacer « 3288 » par le numéro « PID »)
  6. Attendre l'invite (gdb)
  7. Saisir « c »

Une fois que vous avez suivi les instructions spécifiques à la plate-forme ci-dessus pour démarrer Kdenlive, vous pouvez déclencher le bogue. Lors d'un plantage de Kdenlive, veuillez ouvrir la fenêtre de votre terminal et saisissez :

« thread apply all bt full »

Appuyez ensuite sur la touche « Entrée » jusqu'à ce que vous voyiez la totalité des données. Veuillez copier le journal dans un fichier et le joindre au rapport de bogue.