Dépannage général

Obtenir de l’aide

Si vous rencontrez des problèmes lors de l’utilisation de Picard, veuillez d’abord consulter les ressources suivantes :

Signaler un bogue

Problèmes liés aux plugins

Si vous pensez avoir trouvé un bug dans un plugin, vous devriez d’abord vérifier si vous utilisez bien la dernière version de celui-ci. Pour ce faire, rendez-vous sur la page « Options ‣ Plugins » et cliquez sur le bouton Actualiser tout. Si une mise à jour est disponible pour l’un de vos plugins, vous pouvez la télécharger depuis la page des options des plugins. Si aucune mise à jour n’est disponible ou si vous avez mis à jour le plugin et que le problème persiste, vous devez signaler le problème à l’auteur du plugin.

Si l’auteur du plugin a fourni un lien pour signaler des problèmes, un clic droit sur le plugin fera apparaître une option « Signaler un bug ». Si cette option n’est pas disponible, vous pouvez trouver les coordonnées de l’auteur du plugin en cliquant avec le bouton droit sur le plugin dans la liste et en sélectionnant Informations dans le menu contextuel. Cela vous affichera un lien vers la page d’accueil du plugin. Lorsque vous signalez le problème à l’auteur du plugin, veuillez fournir les informations suivantes :

  • Quelle version de Picard utilisez-vous ?

  • Quelle version du plugin utilisez-vous ?

  • Quel système d’exploitation utilisez-vous ?

  • Qu’avez-vous fait lorsque le bogue est survenu ?

  • Que s’est-il réellement passé, et à quoi vous attendiez-vous ?

  • Le journal de niveau « Debug «  de la session Picard démontrant le problème.

Problèmes liés à Picard

Si vous pensez avoir trouvé un bug dans Picard, veuillez vérifier si vous utilisez bien la dernière version du logiciel et si ce bug a déjà été signalé dans le suivi des bogues. Si vous n’êtes pas sûr ou si vous ne souhaitez pas parcourir les tickets existants, posez d’abord votre question sur les forums de la communauté.

Si vous êtes toujours convaincu d’avoir trouvé un nouveau bogue, ouvrez un nouveau ticket fournissant les informations suivantes :

  • Quelle version de Picard utilisez-vous ? (« Affecte la version » dans le formulaire)

  • Quel système d’exploitation utilisez-vous ? (« Environnement » dans le formulaire)

  • Qu’avez-vous fait lorsque le bogue est survenu ?

  • Que s’est-il réellement passé, et à quoi vous attendiez-vous ?

  • Si vous utilisez des plugins, quels plugins avez-vous activés ?

  • Le journal de niveau « Debug «  de la session Picard démontrant le problème.

Avertissement

N’oubliez pas de supprimer d’abord toutes les informations personnelles et confidentielles telles que l’identifiant d’utilisateur, les mots de passe ou les jetons d’autorisation avant de publier ou de soumettre une sortie de journal.

Obtention d’un journal de débogage

Pour de nombreux bugs, il est utile pour les développeurs de disposer d’un journal de débogage généré par Picard. Vous pouvez consulter ce journal en sélectionnant Aide ‣ Afficher le journal d’erreurs/de débogage. Vous pouvez également obtenir un journal de débogage complet, ce qui est préférable car il contient des informations plus détaillées. Coller ce journal dans votre message sur le forum ou dans votre ticket de bug peut aider les développeurs et les autres utilisateurs à résoudre votre problème plus rapidement. Pour récupérer le journal de débogage complet :

  1. Commencez Picard.

  2. Ouvrez la fenêtre d’affichage des journaux en sélectionnant Aide ‣ Afficher le journal d’erreurs/de débogage.

  3. Réglez le niveau de journalisation sur Débogage à l’aide du menu déroulant situé en bas de la fenêtre de visualisation des journaux. Cela permettra de consigner toutes les entrées dans le journal, y compris les informations de débogage détaillées qui ne sont pas incluses aux niveaux de journalisation supérieurs.

  4. Répétez l’action qui a causé le problème signalé.

  5. Dans la fenêtre d’affichage des journaux, copiez le contenu du journal pour le coller dans votre message sur le forum ou dans votre ticket de bug. Vous pouvez également enregistrer le journal dans un fichier à joindre à votre rapport de bug en utilisant le bouton Enregistrer sous….

  6. Fermez le visualisateur de journaux et fermez Picard.

Pour plus d’informations sur la visionneuse de journaux et son utilisation, veuillez consulter Annexe D : Visualiseur de journaux.

Importer les logs en cas de crash

Dans certains cas, ce problème peut entraîner le plantage de Picard et vous empêcher d’accéder au journal généré via la visionneuse de journaux. Vous pouvez néanmoins générer un fichier journal à joindre à votre rapport en lançant Picard avec l’option de ligne de commande --debug depuis une fenêtre de commande ou un terminal (ou en définissant la variable d’environnement PICARD_DEBUG), puis en copiant les informations du fichier journal depuis le terminal. Voici les étapes à suivre pour chacune des plateformes prises en charge :

Systèmes Windows

Ouvrez d’abord une fenêtre de commande en cliquant sur l’icône de recherche dans la barre des tâches de Windows et entrez « cmd ». Démarrez ensuite Picard en saisissant la commande suivante dans la fenêtre de commande :

"C:\Program Files\MusicBrainz Picard\picard.exe" --debug

Cela affichera toutes les entrées du journal dans la fenêtre de commande et vous permettra de copier les informations dans le presse-papiers pour les coller dans votre rapport.

Note

Cette méthode ne fonctionne qu’avec la version installée de Picard. Elle ne fonctionnera pas avec les versions portables ou Windows Store.

Systèmes macOS

Ouvrez d’abord une fenêtre de terminal en effectuant l’une des opérations suivantes :

  • Cliquez sur l’icône Launchpad dans le Dock, tapez « Terminal » dans le champ de recherche, puis cliquez sur Terminal.

  • Dans le Finder, ouvrez le dossier « /Applications/Utilities », puis double-cliquez sur « Terminal ».

Si Picard a été placé dans le dossier Applications du système lors de l’installation, il peut être démarré en entrant la commande suivante dans la fenêtre du terminal :

"/Applications/MusicBrainz Picard.app/Contents/MacOS/picard-run" --debug

Cela affichera toutes les entrées du journal dans la fenêtre du terminal et vous permettra de copier les informations dans le presse-papiers pour les coller dans votre rapport.

Systèmes Linux

Ouvrez d’abord une fenêtre de terminal dans votre environnement de bureau, soit à partir du menu Applications, soit en appuyant sur Ctrl+Alt+T sur la plupart des systèmes. Ensuite, démarrez Picard en entrant ce qui suit dans la fenêtre du terminal :

picard --debug

Cela affichera toutes les entrées du journal dans la fenêtre du terminal et vous permettra de copier les informations dans le presse-papiers pour les coller dans votre rapport.